chore: import upstream snapshot with attribution

apps/sim/tools/box/update_file.ts

@@ -0,0 +1,124 @@
+import type { ToolConfig } from '@/tools/types'
+import type { BoxFileInfoResponse, BoxUpdateFileParams } from './types'
+import { FILE_OUTPUT_PROPERTIES } from './types'
+
+export const boxUpdateFileTool: ToolConfig<BoxUpdateFileParams, BoxFileInfoResponse> = {
+  id: 'box_update_file',
+  name: 'Box Update File',
+  description: 'Update file info in Box (rename, move, change description, add tags)',
+  version: '1.0.0',
+
+  oauth: {
+    required: true,
+    provider: 'box',
+  },
+
+  params: {
+    accessToken: {
+      type: 'string',
+      required: true,
+      visibility: 'hidden',
+      description: 'OAuth access token for Box API',
+    },
+    fileId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The ID of the file to update',
+    },
+    name: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'New name for the file',
+    },
+    description: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'New description for the file (max 256 characters)',
+    },
+    parentFolderId: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Move the file to a different folder by specifying the folder ID',
+    },
+    tags: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Comma-separated tags to set on the file',
+    },
+  },
+
+  request: {
+    url: (params) => `https://api.box.com/2.0/files/${params.fileId.trim()}`,
+    method: 'PUT',
+    headers: (params) => ({
+      Authorization: `Bearer ${params.accessToken}`,
+      'Content-Type': 'application/json',
+    }),
+    body: (params) => {
+      const body: Record<string, unknown> = {}
+      if (params.name) body.name = params.name
+      if (params.description !== undefined) body.description = params.description
+      if (params.parentFolderId) body.parent = { id: params.parentFolderId.trim() }
+      if (params.tags)
+        body.tags = params.tags
+          .split(',')
+          .map((t: string) => t.trim())
+          .filter(Boolean)
+      return body
+    },
+  },
+
+  transformResponse: async (response) => {
+    const data = await response.json()
+
+    if (!response.ok) {
+      throw new Error(data.message || `Box API error: ${response.status}`)
+    }
+
+    return {
+      success: true,
+      output: {
+        id: data.id ?? '',
+        name: data.name ?? '',
+        description: data.description ?? null,
+        size: data.size ?? 0,
+        sha1: data.sha1 ?? null,
+        createdAt: data.created_at ?? null,
+        modifiedAt: data.modified_at ?? null,
+        createdBy: data.created_by
+          ? {
+              id: data.created_by.id,
+              name: data.created_by.name,
+              login: data.created_by.login,
+            }
+          : null,
+        modifiedBy: data.modified_by
+          ? {
+              id: data.modified_by.id,
+              name: data.modified_by.name,
+              login: data.modified_by.login,
+            }
+          : null,
+        ownedBy: data.owned_by
+          ? {
+              id: data.owned_by.id,
+              name: data.owned_by.name,
+              login: data.owned_by.login,
+            }
+          : null,
+        parentId: data.parent?.id ?? null,
+        parentName: data.parent?.name ?? null,
+        sharedLink: data.shared_link ?? null,
+        tags: data.tags ?? [],
+        commentCount: data.comment_count ?? null,
+      },
+    }
+  },
+
+  outputs: FILE_OUTPUT_PROPERTIES,
+}