chore: import upstream snapshot with attribution

apps/sim/tools/onedrive/get_item.ts

@@ -0,0 +1,84 @@
+import type {
+  MicrosoftGraphDriveItem,
+  OneDriveGetItemResponse,
+  OneDriveToolParams,
+} from '@/tools/onedrive/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const getItemTool: ToolConfig<OneDriveToolParams, OneDriveGetItemResponse> = {
+  id: 'onedrive_get_item',
+  name: 'Get OneDrive Item Metadata',
+  description: 'Get metadata for a specific OneDrive file or folder by ID, or the drive root',
+  version: '1.0',
+
+  oauth: {
+    required: true,
+    provider: 'onedrive',
+  },
+
+  params: {
+    accessToken: {
+      type: 'string',
+      required: true,
+      visibility: 'hidden',
+      description: 'The access token for the OneDrive API',
+    },
+    fileId: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'The ID of the file or folder to retrieve (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M"). Leave empty to get the drive root folder',
+    },
+  },
+
+  request: {
+    url: (params) => {
+      const fileId = params.fileId?.trim()
+      const baseUrl = fileId
+        ? `https://graph.microsoft.com/v1.0/me/drive/items/${encodeURIComponent(fileId)}`
+        : 'https://graph.microsoft.com/v1.0/me/drive/root'
+
+      const url = new URL(baseUrl)
+      url.searchParams.append(
+        '$select',
+        'id,name,file,folder,webUrl,size,createdDateTime,lastModifiedDateTime,parentReference,@microsoft.graph.downloadUrl'
+      )
+      return url.toString()
+    },
+    method: 'GET',
+    headers: (params) => ({
+      Authorization: `Bearer ${params.accessToken}`,
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    const data: MicrosoftGraphDriveItem = await response.json()
+
+    return {
+      success: true,
+      output: {
+        file: {
+          id: data.id,
+          name: data.name,
+          mimeType: data.file?.mimeType || (data.folder ? 'application/folder' : 'unknown'),
+          webViewLink: data.webUrl,
+          webContentLink: data['@microsoft.graph.downloadUrl'],
+          size: data.size?.toString() || '0',
+          createdTime: data.createdDateTime,
+          modifiedTime: data.lastModifiedDateTime,
+          parents: data.parentReference ? [data.parentReference.id] : [],
+        },
+      },
+    }
+  },
+
+  outputs: {
+    success: { type: 'boolean', description: 'Whether the item metadata was retrieved' },
+    file: {
+      type: 'object',
+      description:
+        'The file or folder metadata, including id, name, webViewLink, size, and timestamps',
+    },
+  },
+}