chore: import upstream snapshot with attribution

apps/sim/tools/microsoft_dataverse/download_file.ts

@@ -0,0 +1,119 @@
+import { createLogger } from '@sim/logger'
+import type {
+  DataverseDownloadFileParams,
+  DataverseDownloadFileResponse,
+} from '@/tools/microsoft_dataverse/types'
+import { getDataverseBaseUrl } from '@/tools/microsoft_dataverse/utils'
+import type { ToolConfig } from '@/tools/types'
+
+const logger = createLogger('DataverseDownloadFile')
+
+export const dataverseDownloadFileTool: ToolConfig<
+  DataverseDownloadFileParams,
+  DataverseDownloadFileResponse
+> = {
+  id: 'microsoft_dataverse_download_file',
+  name: 'Download File from Microsoft Dataverse',
+  description:
+    'Download a file from a file or image column on a Dataverse record. Stores the file in execution storage and returns a file reference, plus the base64 content and metadata directly.',
+  version: '1.0.0',
+
+  oauth: { required: true, provider: 'microsoft-dataverse' },
+  errorExtractor: 'nested-error-object',
+
+  params: {
+    accessToken: {
+      type: 'string',
+      required: true,
+      visibility: 'hidden',
+      description: 'OAuth access token for Microsoft Dataverse API',
+    },
+    environmentUrl: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Dataverse environment URL (e.g., https://myorg.crm.dynamics.com)',
+    },
+    entitySetName: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Entity set name (plural table name, e.g., accounts, contacts)',
+    },
+    recordId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Record GUID to download the file from',
+    },
+    fileColumn: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'File or image column logical name (e.g., entityimage, cr_document)',
+    },
+  },
+
+  request: {
+    url: (params) => {
+      const baseUrl = getDataverseBaseUrl(params.environmentUrl)
+      return `${baseUrl}/api/data/v9.2/${params.entitySetName.trim()}(${params.recordId.trim()})/${params.fileColumn.trim()}/$value`
+    },
+    method: 'GET',
+    headers: (params) => ({
+      Authorization: `Bearer ${params.accessToken}`,
+      'OData-MaxVersion': '4.0',
+      'OData-Version': '4.0',
+    }),
+  },
+
+  transformResponse: async (response: Response, params?: DataverseDownloadFileParams) => {
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({}))
+      const errorMessage =
+        errorData?.error?.message ??
+        `Dataverse API error: ${response.status} ${response.statusText}`
+      logger.error('Dataverse download file failed', { errorData, status: response.status })
+      throw new Error(errorMessage)
+    }
+
+    const fileName = response.headers.get('x-ms-file-name') || 'download'
+    const fileSize = response.headers.get('x-ms-file-size') ?? ''
+    const mimeType =
+      response.headers.get('mimetype') ??
+      response.headers.get('content-type') ??
+      'application/octet-stream'
+
+    const buffer = await response.arrayBuffer()
+    const base64Content = Buffer.from(buffer).toString('base64')
+    const resolvedSize = fileSize ? Number.parseInt(fileSize, 10) : buffer.byteLength
+
+    return {
+      success: true,
+      output: {
+        file: {
+          name: fileName,
+          mimeType,
+          data: base64Content,
+          size: resolvedSize,
+        },
+        fileContent: base64Content,
+        fileName,
+        fileSize: resolvedSize,
+        mimeType,
+        fileColumn: params?.fileColumn ?? '',
+        success: true,
+      },
+    }
+  },
+
+  outputs: {
+    file: { type: 'file', description: 'Downloaded file stored in execution files' },
+    fileContent: { type: 'string', description: 'Base64-encoded file content' },
+    fileName: { type: 'string', description: 'Name of the downloaded file', optional: true },
+    fileSize: { type: 'number', description: 'File size in bytes' },
+    mimeType: { type: 'string', description: 'MIME type of the file', optional: true },
+    fileColumn: { type: 'string', description: 'File column the file was downloaded from' },
+    success: { type: 'boolean', description: 'Whether the file was downloaded successfully' },
+  },
+}