feat(excel): expand workbook operations and align Graph contracts

Author: waleedlatif1

apps/docs/content/docs/integrations/microsoft_excel.mdx

@@ -434,7 +434,15 @@ export const OAUTH_PROVIDERS: Record<string, OAuthProviderConfig> = {
         providerId: 'microsoft-excel',
         icon: MicrosoftExcelIcon,
         baseProviderIcon: MicrosoftIcon,
-        scopes: ['openid', 'profile', 'email', 'Files.Read', 'Files.ReadWrite', 'offline_access'],
+        scopes: [
+          'openid',
+          'profile',
+          'email',
+          'Files.Read',
+          'Files.ReadWrite',
+          'Sites.Read.All',
+          'offline_access',
+        ],
       },
       'microsoft-intune': {
         name: 'Microsoft Intune',

apps/sim/blocks/blocks/microsoft_excel.ts

@@ -112,6 +112,8 @@ function isFieldProjection(value: unknown): boolean {
  * secret onto a live subblock.
  */
 export const SUBBLOCK_ID_MIGRATIONS: Record<string, readonly SubblockIdMigration[]> = {
+  microsoft_excel: [{ from: 'valueInputOption', to: '_removed_valueInputOption' }],
+  microsoft_excel_v2: [{ from: 'valueInputOption', to: '_removed_valueInputOption' }],
   /** MCP normalization selects the active replacement before this rename pass. */
   mcp: [
     { from: 'server', to: 'serverSelector' },

apps/sim/lib/oauth/oauth.ts

@@ -0,0 +1,44 @@
+import { ErrorExtractorId } from '@/tools/error-extractors'
+import {
+  assertExcelSuccess,
+  EXCEL_WORKBOOK_PARAMS,
+  excelHeaders,
+  excelWorkbookUrl,
+} from '@/tools/microsoft_excel/shared'
+import type { ExcelCalculateParams, ExcelCalculateResponse } from '@/tools/microsoft_excel/types'
+import type { ToolConfig } from '@/tools/types'
+export const calculateTool: ToolConfig<ExcelCalculateParams, ExcelCalculateResponse> = {
+  id: 'microsoft_excel_calculate',
+  name: 'Microsoft Excel Calculate',
+  description: 'Calculate in a Microsoft Excel workbook.',
+  version: '1.0.0',
+  oauth: { required: true, provider: 'microsoft-excel' },
+  errorExtractor: ErrorExtractorId.MICROSOFT_GRAPH_ERRORS,
+  params: {
+    ...EXCEL_WORKBOOK_PARAMS,
+    calculationType: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description:
+        'Recalculate recalculates dirty cells; Full recalculates all cells; FullRebuild rebuilds dependencies and recalculates all cells.',
+    },
+  },
+  request: {
+    url: (params) => `${excelWorkbookUrl(params)}/application/calculate`,
+    method: 'POST',
+    headers: excelHeaders,
+    body: (params) => {
+      if (!['Recalculate', 'Full', 'FullRebuild'].includes(params.calculationType))
+        throw new Error('Invalid calculation type')
+      return { calculationType: params.calculationType }
+    },
+  },
+  transformResponse: async (response) => {
+    await assertExcelSuccess(response)
+    return { success: true, output: { calculated: true } }
+  },
+  outputs: {
+    calculated: { type: 'boolean', description: 'Whether workbook calculation completed.' },
+  },
+}

apps/sim/lib/workflows/migrations/subblock-migrations.ts

@@ -1,4 +1,9 @@
 import { ErrorExtractorId } from '@/tools/error-extractors'
+import {
+  assertExcelSuccess,
+  EXCEL_WORKBOOK_PARAMS,
+  excelHeaders,
+} from '@/tools/microsoft_excel/shared'
 import type {
   MicrosoftExcelClearRangeParams,
   MicrosoftExcelClearRangeResponse,
@@ -8,7 +13,7 @@ import {
   getItemBasePath,
   getSpreadsheetWebUrl,
 } from '@/tools/microsoft_excel/utils'
-import type { ToolConfig } from '@/tools/types'
+import type { ToolConfig, ToolResponseContext } from '@/tools/types'
 
 /**
  * Clears the contents and/or formatting of a worksheet range.
@@ -30,6 +35,7 @@ export const clearRangeTool: ToolConfig<
   },
 
   params: {
+    sessionId: EXCEL_WORKBOOK_PARAMS.sessionId,
     accessToken: {
       type: 'string',
       required: true,
@@ -47,7 +53,7 @@ export const clearRangeTool: ToolConfig<
       required: false,
       visibility: 'user-or-llm',
       description:
-        'The ID of the drive containing the spreadsheet. Required for SharePoint files. If omitted, uses personal OneDrive.',
+        'The ID of the drive containing the spreadsheet. Required for SharePoint files. If omitted, uses the signed-in user’s OneDrive for Business.',
     },
     sheetName: {
       type: 'string',
@@ -80,29 +86,26 @@ export const clearRangeTool: ToolConfig<
       return `${buildWorksheetRangeUrl(basePath, params.range, params.sheetName)}/clear`
     },
     method: 'POST',
-    headers: (params) => {
-      if (!params.accessToken) {
-        throw new Error('Access token is required')
-      }
-      return {
-        Authorization: `Bearer ${params.accessToken}`,
-        'Content-Type': 'application/json',
-      }
-    },
+    headers: excelHeaders,
     body: (params) => ({
       applyTo: params.applyTo || 'All',
     }),
   },
 
-  transformResponse: async (_response: Response, params?: MicrosoftExcelClearRangeParams) => {
+  transformResponse: async (
+    response: Response,
+    params?: MicrosoftExcelClearRangeParams,
+    context?: ToolResponseContext
+  ) => {
+    await assertExcelSuccess(response)
     const spreadsheetId = params?.spreadsheetId?.trim() || ''
     const driveId = params?.driveId
 
     const accessToken = params?.accessToken
     if (!accessToken) {
       throw new Error('Access token is required')
     }
-    const webUrl = await getSpreadsheetWebUrl(spreadsheetId, accessToken, driveId)
+    const webUrl = await getSpreadsheetWebUrl(spreadsheetId, accessToken, driveId, context?.signal)
 
     return {
       success: true,

apps/sim/tools/generated/tool-ids.ts

@@ -0,0 +1,34 @@
+import { ErrorExtractorId } from '@/tools/error-extractors'
+import {
+  assertExcelSuccess,
+  EXCEL_WORKBOOK_PARAMS,
+  excelHeaders,
+  excelWorkbookUrl,
+} from '@/tools/microsoft_excel/shared'
+import type { ExcelCloseSessionResponse, ExcelSessionParams } from '@/tools/microsoft_excel/types'
+import type { ToolConfig } from '@/tools/types'
+export const closeSessionTool: ToolConfig<ExcelSessionParams, ExcelCloseSessionResponse> = {
+  id: 'microsoft_excel_close_session',
+  name: 'Microsoft Excel Close Session',
+  description: 'Close Session in a Microsoft Excel workbook.',
+  version: '1.0.0',
+  oauth: { required: true, provider: 'microsoft-excel' },
+  errorExtractor: ErrorExtractorId.MICROSOFT_GRAPH_ERRORS,
+  params: {
+    ...EXCEL_WORKBOOK_PARAMS,
+    sessionId: { ...EXCEL_WORKBOOK_PARAMS.sessionId, required: true },
+  },
+  request: {
+    url: (params) => {
+      if (!params.sessionId?.trim()) throw new Error('Session ID is required')
+      return `${excelWorkbookUrl(params)}/closeSession`
+    },
+    method: 'POST',
+    headers: excelHeaders,
+  },
+  transformResponse: async (response) => {
+    await assertExcelSuccess(response)
+    return { success: true, output: { closed: true } }
+  },
+  outputs: { closed: { type: 'boolean', description: 'Whether the workbook session was closed.' } },
+}