chore: import upstream snapshot with attribution

apps/sim/tools/jira/get_attachments.ts

@@ -0,0 +1,163 @@
+import type { JiraGetAttachmentsParams, JiraGetAttachmentsResponse } from '@/tools/jira/types'
+import { ATTACHMENT_ITEM_PROPERTIES, TIMESTAMP_OUTPUT } from '@/tools/jira/types'
+import { downloadJiraAttachments, getJiraCloudId, transformUser } from '@/tools/jira/utils'
+import type { ToolConfig } from '@/tools/types'
+
+/**
+ * Transforms a raw Jira attachment object into typed output.
+ */
+function transformAttachment(att: any) {
+  return {
+    id: att.id ?? '',
+    filename: att.filename ?? '',
+    mimeType: att.mimeType ?? '',
+    size: att.size ?? 0,
+    content: att.content ?? '',
+    thumbnail: att.thumbnail ?? null,
+    author: transformUser(att.author),
+    authorName: att.author?.displayName ?? att.author?.accountId ?? 'Unknown',
+    created:
+      typeof att.created === 'number' ? new Date(att.created).toISOString() : (att.created ?? ''),
+  }
+}
+
+export const jiraGetAttachmentsTool: ToolConfig<
+  JiraGetAttachmentsParams,
+  JiraGetAttachmentsResponse
+> = {
+  id: 'jira_get_attachments',
+  name: 'Jira Get Attachments',
+  description: 'Get all attachments from a Jira issue',
+  version: '1.0.0',
+
+  oauth: {
+    required: true,
+    provider: 'jira',
+  },
+
+  params: {
+    accessToken: {
+      type: 'string',
+      required: true,
+      visibility: 'hidden',
+      description: 'OAuth access token for Jira',
+    },
+    domain: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Your Jira domain (e.g., yourcompany.atlassian.net)',
+    },
+    issueKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Jira issue key to get attachments from (e.g., PROJ-123)',
+    },
+    includeAttachments: {
+      type: 'boolean',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Download attachment file contents and include them as files in the output',
+    },
+    cloudId: {
+      type: 'string',
+      required: false,
+      visibility: 'hidden',
+      description:
+        'Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.',
+    },
+  },
+
+  request: {
+    url: (params: JiraGetAttachmentsParams) => {
+      if (params.cloudId) {
+        return `https://api.atlassian.com/ex/jira/${params.cloudId}/rest/api/3/issue/${params.issueKey?.trim() ?? ''}?fields=attachment`
+      }
+      return 'https://api.atlassian.com/oauth/token/accessible-resources'
+    },
+    method: 'GET',
+    headers: (params: JiraGetAttachmentsParams) => {
+      return {
+        Accept: 'application/json',
+        Authorization: `Bearer ${params.accessToken}`,
+      }
+    },
+  },
+
+  transformResponse: async (response: Response, params?: JiraGetAttachmentsParams) => {
+    const fetchAttachments = async (cloudId: string) => {
+      const attachmentsUrl = `https://api.atlassian.com/ex/jira/${cloudId}/rest/api/3/issue/${params!.issueKey?.trim() ?? ''}?fields=attachment`
+      const attachmentsResponse = await fetch(attachmentsUrl, {
+        method: 'GET',
+        headers: {
+          Accept: 'application/json',
+          Authorization: `Bearer ${params!.accessToken}`,
+        },
+      })
+
+      if (!attachmentsResponse.ok) {
+        let message = `Failed to get attachments from Jira issue (${attachmentsResponse.status})`
+        try {
+          const err = await attachmentsResponse.json()
+          message = err?.errorMessages?.join(', ') || err?.message || message
+        } catch (_e) {}
+        throw new Error(message)
+      }
+
+      return attachmentsResponse.json()
+    }
+
+    let data: any
+
+    if (!params?.cloudId) {
+      const cloudId = await getJiraCloudId(params!.domain, params!.accessToken)
+      data = await fetchAttachments(cloudId)
+    } else {
+      if (!response.ok) {
+        let message = `Failed to get attachments from Jira issue (${response.status})`
+        try {
+          const err = await response.json()
+          message = err?.errorMessages?.join(', ') || err?.message || message
+        } catch (_e) {}
+        throw new Error(message)
+      }
+      data = await response.json()
+    }
+
+    const attachments = (data?.fields?.attachment ?? []).map(transformAttachment)
+
+    let files: Array<{ name: string; mimeType: string; data: string; size: number }> | undefined
+    if (params?.includeAttachments && attachments.length > 0) {
+      files = await downloadJiraAttachments(attachments, params.accessToken)
+    }
+
+    return {
+      success: true,
+      output: {
+        ts: new Date().toISOString(),
+        issueKey: params?.issueKey ?? 'unknown',
+        attachments,
+        ...(files && files.length > 0 ? { files } : {}),
+      },
+    }
+  },
+
+  outputs: {
+    ts: TIMESTAMP_OUTPUT,
+    issueKey: { type: 'string', description: 'Issue key' },
+    attachments: {
+      type: 'array',
+      description: 'Array of attachments',
+      items: {
+        type: 'object',
+        properties: ATTACHMENT_ITEM_PROPERTIES,
+      },
+    },
+    files: {
+      type: 'file[]',
+      description: 'Downloaded attachment files (only when includeAttachments is true)',
+      optional: true,
+    },
+  },
+}