feat(sheets): added sheet selector for microsoft excel and google sheets tools

Author: waleedlatif1

apps/docs/components/ui/icon-mapping.ts

@@ -163,7 +163,7 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
   google_forms: GoogleFormsIcon,
   google_groups: GoogleGroupsIcon,
   google_search: GoogleIcon,
-  google_sheets: GoogleSheetsIcon,
+  google_sheets_v2: GoogleSheetsIcon,
   google_slides: GoogleSlidesIcon,
   google_vault: GoogleVaultIcon,
   grafana: GrafanaIcon,
@@ -190,7 +190,7 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
   mailgun: MailgunIcon,
   mem0: Mem0Icon,
   memory: BrainIcon,
-  microsoft_excel: MicrosoftExcelIcon,
+  microsoft_excel_v2: MicrosoftExcelIcon,
   microsoft_planner: MicrosoftPlannerIcon,
   microsoft_teams: MicrosoftTeamsIcon,
   mistral_parse: MistralIcon,

apps/docs/content/docs/en/tools/google_sheets.mdx

@@ -1,83 +1,18 @@
 ---
 title: Google Sheets
-description: Read, write, and update data
+description: Read, write, and update data with sheet selection
 ---
 
 import { BlockInfoCard } from "@/components/ui/block-info-card"
 
 <BlockInfoCard 
-  type="google_sheets"
+  type="google_sheets_v2"
   color="#E0E0E0"
 />
 
-{/* MANUAL-CONTENT-START:intro */}
-[Google Sheets](https://sheets.google.com) is a powerful cloud-based spreadsheet application that allows users to create, edit, and collaborate on spreadsheets in real-time. As part of Google's productivity suite, Google Sheets offers a versatile platform for data organization, analysis, and visualization with robust formatting, formula, and sharing capabilities.
-
-Learn how to integrate the Google Sheets "Read" tool in Sim to effortlessly fetch data from your spreadsheets to integrate into your workflows. This tutorial walks you through connecting Google Sheets, setting up data reads, and using that information to automate processes in real-time. Perfect for syncing live data with your agents.
-
-<iframe
-  width="100%"
-  height="400"
-  src="https://www.youtube.com/embed/xxP7MZRuq_0"
-  title="Use the Google Sheets Read tool in Sim"
-  frameBorder="0"
-  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
-  allowFullScreen
-></iframe>
-
-Discover how to use the Google Sheets "Write" tool in Sim to automatically send data from your workflows to your Google Sheets. This tutorial covers setting up the integration, configuring write operations, and updating your sheets seamlessly as workflows execute. Perfect for maintaining real-time records without manual input.
-
-<iframe
-  width="100%"
-  height="400"
-  src="https://www.youtube.com/embed/cO86qTj7qeY"
-  title="Use the Google Sheets Write tool in Sim"
-  frameBorder="0"
-  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
-  allowFullScreen
-></iframe>
-
-Explore how to leverage the Google Sheets "Update" tool in Sim to modify existing entries in your spreadsheets based on workflow execution. This tutorial demonstrates setting up the update logic, mapping data fields, and synchronizing changes instantly. Perfect for keeping your data current and consistent.
-
-<iframe
-  width="100%"
-  height="400"
-  src="https://www.youtube.com/embed/95by2fL9yn4"
-  title="Use the Google Sheets Update tool in Sim"
-  frameBorder="0"
-  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
-  allowFullScreen
-></iframe>
-
-Learn how to use the Google Sheets "Append" tool in Sim to effortlessly add new rows of data to your spreadsheets during workflow execution. This tutorial walks you through setting up the integration, configuring append actions, and ensuring smooth data growth. Perfect for expanding records without manual effort!
-
-<iframe
-  width="100%"
-  height="400"
-  src="https://www.youtube.com/embed/8DgNvLBCsAo"
-  title="Use the Google Sheets Append tool in Sim"
-  frameBorder="0"
-  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
-  allowFullScreen
-></iframe>
-
-With Google Sheets, you can:
-
-- **Create and edit spreadsheets**: Develop data-driven documents with comprehensive formatting and calculation options
-- **Collaborate in real-time**: Work simultaneously with multiple users on the same spreadsheet
-- **Analyze data**: Use formulas, functions, and pivot tables to process and understand your data
-- **Visualize information**: Create charts, graphs, and conditional formatting to represent data visually
-- **Access anywhere**: Use Google Sheets across devices with automatic cloud synchronization
-- **Work offline**: Continue working without internet connection with changes syncing when back online
-- **Integrate with other services**: Connect with Google Drive, Forms, and third-party applications
-
-In Sim, the Google Sheets integration enables your agents to interact directly with spreadsheet data programmatically. This allows for powerful automation scenarios such as data extraction, analysis, reporting, and management. Your agents can read existing spreadsheets to extract information, write to spreadsheets to update data, and create new spreadsheets from scratch. This integration bridges the gap between your AI workflows and data management, enabling seamless interaction with structured data. By connecting Sim with Google Sheets, you can automate data workflows, generate reports, extract insights from data, and maintain up-to-date information - all through your intelligent agents. The integration supports various data formats and range specifications, making it flexible enough to handle diverse data management needs while maintaining the collaborative and accessible nature of Google Sheets.
-{/* MANUAL-CONTENT-END */}
-
-
 ## Usage Instructions
 
-Integrate Google Sheets into the workflow. Can read, write, append, and update data.
+Integrate Google Sheets into the workflow with explicit sheet selection. Can read, write, append, and update data in specific sheets.
 
 
 

apps/docs/content/docs/en/tools/microsoft_excel.mdx

@@ -1,33 +1,18 @@
 ---
 title: Microsoft Excel
-description: Read, write, and update data
+description: Read and write data with sheet selection
 ---
 
 import { BlockInfoCard } from "@/components/ui/block-info-card"
 
 <BlockInfoCard 
-  type="microsoft_excel"
+  type="microsoft_excel_v2"
   color="#E0E0E0"
 />
 
-{/* MANUAL-CONTENT-START:intro */}
-[Microsoft Teams](https://www.microsoft.com/en-us/microsoft-365/excel) is a powerful spreadsheet application that enables data management, analysis, and visualization. Through the Microsoft Excel integration in Sim, you can programmatically read, write, and manipulate spreadsheet data to support your workflow automation needs.
-
-With Microsoft Excel integration, you can:
-
-- **Read Spreadsheet Data**: Access data from specific ranges, sheets, and cells
-- **Write and Update Data**: Add new data or modify existing spreadsheet content
-- **Manage Tables**: Create and manipulate tabular data structures
-- **Handle Multiple Sheets**: Work with multiple worksheets in a workbook
-- **Process Data**: Import, export, and transform spreadsheet data
-
-In Sim, the Microsoft Excel integration provides seamless access to spreadsheet functionality through OAuth authentication. You can read data from specific ranges, write new information, update existing cells, and handle various data formats. The integration supports both reading and writing operations with flexible input and output options. This enables you to build workflows that can effectively manage spreadsheet data, whether you're extracting information for analysis, updating records automatically, or maintaining data consistency across your applications.
-{/* MANUAL-CONTENT-END */}
-
-
 ## Usage Instructions
 
-Integrate Microsoft Excel into the workflow. Can read, write, update, add to table, and create new worksheets.
+Integrate Microsoft Excel into the workflow with explicit sheet selection. Can read and write data in specific sheets.
 
 
 
@@ -81,50 +66,4 @@ Write data to a Microsoft Excel spreadsheet
 | ↳ `spreadsheetId` | string | The ID of the spreadsheet |
 | ↳ `spreadsheetUrl` | string | URL to access the spreadsheet |
 
-### `microsoft_excel_table_add`
-
-Add new rows to a Microsoft Excel table
-
-#### Input
-
-| Parameter | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `spreadsheetId` | string | Yes | The ID of the spreadsheet containing the table |
-| `tableName` | string | Yes | The name of the table to add rows to |
-| `values` | array | Yes | The data to add to the table \(array of arrays or array of objects\) |
-
-#### Output
-
-| Parameter | Type | Description |
-| --------- | ---- | ----------- |
-| `index` | number | Index of the first row that was added |
-| `values` | array | Array of rows that were added to the table |
-| `metadata` | object | Spreadsheet metadata |
-| ↳ `spreadsheetId` | string | The ID of the spreadsheet |
-| ↳ `spreadsheetUrl` | string | URL to access the spreadsheet |
-
-### `microsoft_excel_worksheet_add`
-
-Create a new worksheet (sheet) in a Microsoft Excel workbook
-
-#### Input
-
-| Parameter | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `spreadsheetId` | string | Yes | The ID of the Excel workbook to add the worksheet to |
-| `worksheetName` | string | Yes | The name of the new worksheet. Must be unique within the workbook and cannot exceed 31 characters |
-
-#### Output
-
-| Parameter | Type | Description |
-| --------- | ---- | ----------- |
-| `worksheet` | object | Details of the newly created worksheet |
-| ↳ `id` | string | The unique ID of the worksheet |
-| ↳ `name` | string | The name of the worksheet |
-| ↳ `position` | number | The zero-based position of the worksheet |
-| ↳ `visibility` | string | The visibility state of the worksheet \(Visible/Hidden/VeryHidden\) |
-| `metadata` | object | Spreadsheet metadata |
-| ↳ `spreadsheetId` | string | The ID of the spreadsheet |
-| ↳ `spreadsheetUrl` | string | URL to access the spreadsheet |
-
 

apps/sim/app/api/tools/google_sheets/sheets/route.ts

@@ -0,0 +1,114 @@
+import { createLogger } from '@sim/logger'
+import { type NextRequest, NextResponse } from 'next/server'
+import { authorizeCredentialUse } from '@/lib/auth/credential-access'
+import { generateRequestId } from '@/lib/core/utils/request'
+import { refreshAccessTokenIfNeeded } from '@/app/api/auth/oauth/utils'
+
+export const dynamic = 'force-dynamic'
+
+const logger = createLogger('GoogleSheetsAPI')
+
+interface SheetProperties {
+  sheetId: number
+  title: string
+  index: number
+}
+
+interface Sheet {
+  properties: SheetProperties
+}
+
+interface SpreadsheetResponse {
+  sheets: Sheet[]
+}
+
+/**
+ * Get sheets (tabs) from a Google Spreadsheet
+ */
+export async function GET(request: NextRequest) {
+  const requestId = generateRequestId()
+  logger.info(`[${requestId}] Google Sheets sheets request received`)
+
+  try {
+    const { searchParams } = new URL(request.url)
+    const credentialId = searchParams.get('credentialId')
+    const spreadsheetId = searchParams.get('spreadsheetId')
+    const workflowId = searchParams.get('workflowId') || undefined
+
+    if (!credentialId) {
+      logger.warn(`[${requestId}] Missing credentialId parameter`)
+      return NextResponse.json({ error: 'Credential ID is required' }, { status: 400 })
+    }
+
+    if (!spreadsheetId) {
+      logger.warn(`[${requestId}] Missing spreadsheetId parameter`)
+      return NextResponse.json({ error: 'Spreadsheet ID is required' }, { status: 400 })
+    }
+
+    const authz = await authorizeCredentialUse(request, { credentialId, workflowId })
+    if (!authz.ok || !authz.credentialOwnerUserId) {
+      return NextResponse.json({ error: authz.error || 'Unauthorized' }, { status: 403 })
+    }
+
+    const accessToken = await refreshAccessTokenIfNeeded(
+      credentialId,
+      authz.credentialOwnerUserId,
+      requestId
+    )
+
+    if (!accessToken) {
+      return NextResponse.json({ error: 'Failed to obtain valid access token' }, { status: 401 })
+    }
+
+    logger.info(
+      `[${requestId}] Fetching sheets from Google Sheets API for spreadsheet ${spreadsheetId}`
+    )
+
+    // Fetch spreadsheet metadata to get sheet names
+    const sheetsResponse = await fetch(
+      `https://sheets.googleapis.com/v4/spreadsheets/${spreadsheetId}?fields=sheets.properties`,
+      {
+        method: 'GET',
+        headers: {
+          Authorization: `Bearer ${accessToken}`,
+          'Content-Type': 'application/json',
+        },
+      }
+    )
+
+    if (!sheetsResponse.ok) {
+      const errorData = await sheetsResponse
+        .text()
+        .then((text) => JSON.parse(text))
+        .catch(() => ({ error: { message: 'Unknown error' } }))
+      logger.error(`[${requestId}] Google Sheets API error`, {
+        status: sheetsResponse.status,
+        error: errorData.error?.message || 'Failed to fetch sheets',
+      })
+      return NextResponse.json(
+        { error: errorData.error?.message || 'Failed to fetch sheets' },
+        { status: sheetsResponse.status }
+      )
+    }
+
+    const data: SpreadsheetResponse = await sheetsResponse.json()
+    const sheets = data.sheets || []
+
+    // Sort sheets by index
+    sheets.sort((a, b) => a.properties.index - b.properties.index)
+
+    logger.info(`[${requestId}] Successfully fetched ${sheets.length} sheets`)
+
+    return NextResponse.json({
+      sheets: sheets.map((sheet) => ({
+        id: sheet.properties.title, // Use title as ID since that's what the API uses
+        name: sheet.properties.title,
+        sheetId: sheet.properties.sheetId,
+        index: sheet.properties.index,
+      })),
+    })
+  } catch (error) {
+    logger.error(`[${requestId}] Error fetching Google Sheets sheets`, error)
+    return NextResponse.json({ error: 'Internal server error' }, { status: 500 })
+  }
+}