@commandable/integration-data 0.0.4 → 0.0.6

package/integrations/google-gmail/schemas/modify_thread.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["threadId"],
+  "properties": {
+    "userId": { "type": "string", "description": "User email address or 'me'. Defaults to 'me'." },
+    "threadId": { "type": "string", "description": "Gmail thread ID." },
+    "addLabelIds": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Label IDs to add."
+    },
+    "removeLabelIds": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Label IDs to remove."
+    }
+  },
+  "anyOf": [
+    { "required": ["addLabelIds"] },
+    { "required": ["removeLabelIds"] }
+  ],
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/read_email.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["messageId"],
+  "properties": {
+    "userId": { "type": "string", "description": "User email or 'me'. Defaults to 'me'." },
+    "messageId": { "type": "string", "description": "Gmail message ID. Obtain from list_messages or search results." }
+  },
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/send_draft.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "userId": { "type": "string", "description": "User email address or 'me'. Defaults to 'me'." },
+    "draftId": {
+      "type": "string",
+      "description": "Draft ID to send."
+    },
+    "raw": {
+      "type": "string",
+      "description": "Optional base64url encoded RFC822 message string for one-off send."
+    },
+    "threadId": {
+      "type": "string",
+      "description": "Optional existing thread ID when sending a one-off draft payload."
+    },
+    "labelIds": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Optional label IDs when sending a one-off draft payload."
+    }
+  },
+  "anyOf": [
+    { "required": ["draftId"] },
+    { "required": ["raw"] }
+  ],
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/send_email.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["to", "subject", "body"],
+  "properties": {
+    "userId": { "type": "string", "description": "User email or 'me'. Defaults to 'me'." },
+    "to": { "type": "string", "description": "Recipient email address. Use comma-separated values for multiple recipients (e.g. 'alice@example.com, bob@example.com')." },
+    "cc": { "type": "string", "description": "CC recipients, comma-separated." },
+    "bcc": { "type": "string", "description": "BCC recipients, comma-separated." },
+    "subject": { "type": "string", "description": "Email subject line." },
+    "body": { "type": "string", "description": "Plain text email body. Required unless htmlBody is provided." },
+    "htmlBody": { "type": "string", "description": "HTML email body. If provided, takes precedence over body and the email is sent as text/html." },
+    "replyToMessageId": { "type": "string", "description": "Message ID of the email being replied to. Sets the In-Reply-To header for proper threading. Use with threadId." },
+    "threadId": { "type": "string", "description": "Thread ID to add this message to. Required when replying so the reply appears in the same conversation." }
+  },
+  "additionalProperties": false
+}

package/integrations/google-gmail/schemas/update_label.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["labelId"],
+  "properties": {
+    "userId": { "type": "string", "description": "User email address or 'me'. Defaults to 'me'." },
+    "labelId": { "type": "string", "description": "Gmail label ID." },
+    "name": { "type": "string", "description": "Label display name." },
+    "messageListVisibility": {
+      "type": "string",
+      "enum": ["show", "hide"]
+    },
+    "labelListVisibility": {
+      "type": "string",
+      "enum": ["labelShow", "labelShowIfUnread", "labelHide"]
+    },
+    "color": {
+      "type": "object",
+      "properties": {
+        "textColor": { "type": "string", "description": "Hex color, e.g. #000000" },
+        "backgroundColor": { "type": "string", "description": "Hex color, e.g. #ffffff" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "anyOf": [
+    { "required": ["name"] },
+    { "required": ["messageListVisibility"] },
+    { "required": ["labelListVisibility"] },
+    { "required": ["color"] }
+  ],
+  "additionalProperties": false
+}

package/integrations/google-sheet/__tests__/get_handlers.test.ts

@@ -21,6 +21,7 @@ suite('google-sheet read handlers (live)', () => {
     const credentialStore = createCredentialStore(async () => ({
       token: env.GOOGLE_TOKEN || '',
       serviceAccountJson: env.GOOGLE_SERVICE_ACCOUNT_JSON || '',
+      subject: env.GOOGLE_IMPERSONATE_SUBJECT || '',
     }))
     const proxy = createProxy(credentialStore)
     sheets = createToolbox('google-sheet', proxy, createIntegrationNode('google-sheet', { label: 'Google Sheets', credentialId: 'google-sheet-creds' }))
@@ -62,60 +63,14 @@ suite('google-sheet read handlers (live)', () => {
     expect(result?.spreadsheetId || result?.sheets).toBeTruthy()
   }, 30000)
 
-  it('get_values returns a value range', async () => {
+  it('read_sheet returns markdown with A1 coordinates', async () => {
     if (!spreadsheetId)
       return expect(true).toBe(true)
-    const handler = sheets.read('get_values')
+    const handler = sheets.read('read_sheet')
     const range = sheetTitle ? `${sheetTitle}!A1:B5` : 'A1:B5'
-    const result = await handler({ spreadsheetId, range })
-    expect(result?.range || result?.values).toBeTruthy()
-  }, 30000)
-
-  it('batch_get_values returns multiple ranges', async () => {
-    if (!spreadsheetId)
-      return expect(true).toBe(true)
-    const handler = sheets.read('batch_get_values')
-    const aTitle = sheetTitle || 'Sheet1'
-    const result = await handler({ spreadsheetId, ranges: [`${aTitle}!A1:A3`, `${aTitle}!B1:B3`] })
-    expect(Array.isArray(result?.valueRanges)).toBe(true)
-  }, 30000)
-
-  it('get_spreadsheet_by_data_filter returns metadata', async () => {
-    if (!spreadsheetId)
-      return expect(true).toBe(true)
-    const handler = sheets.read('get_spreadsheet_by_data_filter')
-    const aTitle = sheetTitle || 'Sheet1'
-    const result = await handler({ spreadsheetId, dataFilters: [{ a1Range: `${aTitle}!A1:A1` }] })
-    expect(result?.spreadsheetId || result?.sheets).toBeTruthy()
-  }, 30000)
-
-  it('get_values_by_data_filter returns values', async () => {
-    if (!spreadsheetId)
-      return expect(true).toBe(true)
-    const handler = sheets.read('get_values_by_data_filter')
-    const aTitle = sheetTitle || 'Sheet1'
-    const result = await handler({ spreadsheetId, dataFilters: [{ a1Range: `${aTitle}!A1:B2` }] })
-    expect(Array.isArray(result?.valueRanges)).toBe(true)
-  }, 30000)
-
-  it('search_developer_metadata returns results or empty', async () => {
-    if (!spreadsheetId)
-      return expect(true).toBe(true)
-    const handler = sheets.read('search_developer_metadata')
-    const result = await handler({ spreadsheetId, dataFilters: [{ developerMetadataLookup: { visibility: 'DOCUMENT' } }] })
-    expect(result !== undefined).toBe(true)
-  }, 30000)
-
-  it('get_developer_metadata retrieves by id when available', async () => {
-    if (!spreadsheetId)
-      return expect(true).toBe(true)
-    const search = sheets.read('search_developer_metadata')
-    const list = await search({ spreadsheetId, dataFilters: [{ developerMetadataLookup: { visibility: 'DOCUMENT' } }] })
-    const first = list?.matchedDeveloperMetadata?.[0]?.developerMetadata || list?.developerMetadata?.[0]
-    if (!first?.metadataId)
-      return expect(true).toBe(true)
-    const getdm = sheets.read('get_developer_metadata')
-    const got = await getdm({ spreadsheetId, metadataId: first.metadataId })
-    expect(got?.metadataId).toBe(first.metadataId)
+    const result = await handler({ spreadsheetId, range, valueRenderOption: 'FORMATTED_VALUE' })
+    expect(result?.range).toBeTruthy()
+    expect(typeof result?.markdown).toBe('string')
+    expect(result?.columnCount >= 1).toBe(true)
   }, 30000)
 })

package/integrations/google-sheet/__tests__/write_handlers.test.ts

@@ -27,6 +27,7 @@ suite('google-sheet write handlers (live)', () => {
     const credentialStore = createCredentialStore(async () => ({
       token: env.GOOGLE_TOKEN || '',
       serviceAccountJson: env.GOOGLE_SERVICE_ACCOUNT_JSON || '',
+      subject: env.GOOGLE_IMPERSONATE_SUBJECT || '',
     }))
     const proxy = createProxy(credentialStore)
     sheets = createToolbox('google-sheet', proxy, createIntegrationNode('google-sheet', { label: 'Google Sheets', credentialId: 'google-sheet-creds' }))
@@ -109,17 +110,6 @@ suite('google-sheet write handlers (live)', () => {
     expect(res?.totalUpdatedCells >= 0 || res?.spreadsheetId).toBeTruthy()
   }, 60000)
 
-  it('batch_update_values_by_data_filter updates via filters', async () => {
-    if (!ctx.spreadsheetId)
-      return expect(true).toBe(true)
-    const aTitle = sheetTitle || 'Sheet1'
-    const batch_update_values_by_data_filter = sheets.write('batch_update_values_by_data_filter')
-    const res = await batch_update_values_by_data_filter({ spreadsheetId: ctx.spreadsheetId, data: [
-      { dataFilter: { a1Range: `${aTitle}!D1:D1` }, values: [[`CmdTestDF ${Date.now()}`]] },
-    ], valueInputOption: 'USER_ENTERED' })
-    expect(res?.totalUpdatedCells >= 0 || res?.spreadsheetId).toBeTruthy()
-  }, 60000)
-
   it('batch_clear_values clears multiple ranges', async () => {
     if (!ctx.spreadsheetId)
       return expect(true).toBe(true)
@@ -129,15 +119,6 @@ suite('google-sheet write handlers (live)', () => {
     expect(Boolean(res?.spreadsheetId) || Array.isArray(res?.clearedRanges)).toBe(true)
   }, 60000)
 
-  it('batch_clear_values_by_data_filter clears via filters', async () => {
-    if (!ctx.spreadsheetId)
-      return expect(true).toBe(true)
-    const aTitle = sheetTitle || 'Sheet1'
-    const batch_clear_values_by_data_filter = sheets.write('batch_clear_values_by_data_filter')
-    const res = await batch_clear_values_by_data_filter({ spreadsheetId: ctx.spreadsheetId, dataFilters: [{ a1Range: `${aTitle}!E1:E2` }] })
-    expect(Boolean(res?.spreadsheetId) || Array.isArray(res?.clearedRanges)).toBe(true)
-  }, 60000)
-
   it('batch_update handles a trivial request (no-op findReplace)', async () => {
     if (!ctx.spreadsheetId)
       return expect(true).toBe(true)

package/integrations/google-sheet/handlers/get_spreadsheet.js

@@ -5,6 +5,8 @@ async (input) => {
     params.set('includeGridData', String(includeGridData))
   if (Array.isArray(ranges))
     ranges.forEach(r => params.append('ranges', String(r)))
+  if (input.fields)
+    params.set('fields', input.fields)
   const qs = params.toString()
   const path = `/spreadsheets/${encodeURIComponent(spreadsheetId)}${qs ? `?${qs}` : ''}`
   const res = await integration.fetch(path)

package/integrations/google-sheet/handlers/read_sheet.js

@@ -0,0 +1,75 @@
+async (input) => {
+  const toColumnName = (index) => {
+    let n = index + 1
+    let out = ''
+    while (n > 0) {
+      const rem = (n - 1) % 26
+      out = String.fromCharCode(65 + rem) + out
+      n = Math.floor((n - 1) / 26)
+    }
+    return out
+  }
+
+  const columnNameToIndex = (name) => {
+    let value = 0
+    for (const ch of name.toUpperCase()) {
+      const code = ch.charCodeAt(0)
+      if (code < 65 || code > 90) continue
+      value = value * 26 + (code - 64)
+    }
+    return Math.max(0, value - 1)
+  }
+
+  const parseResolvedRange = (resolvedRange) => {
+    // Examples: "Sheet1!A1:D5", "Sheet1!B:B", "Sheet1!2:9"
+    const a1 = String(resolvedRange || '').split('!')[1] || ''
+    const [start = 'A1'] = a1.split(':')
+    const letters = (start.match(/[A-Za-z]+/) || ['A'])[0]
+    const rowDigits = (start.match(/\d+/) || ['1'])[0]
+    return {
+      startColumn: columnNameToIndex(letters),
+      startRow: Math.max(1, parseInt(rowDigits, 10) || 1),
+    }
+  }
+
+  const escapeCell = (value) =>
+    String(value ?? '')
+      .replace(/\|/g, '\\|')
+      .replace(/\r?\n/g, '<br>')
+
+  const spreadsheetId = input.spreadsheetId
+  const range = input.range || 'A1:Z1000'
+  const params = new URLSearchParams()
+  if (input.valueRenderOption) params.set('valueRenderOption', input.valueRenderOption)
+
+  const qs = params.toString()
+  const path = `/spreadsheets/${encodeURIComponent(spreadsheetId)}/values/${encodeURIComponent(range)}${qs ? `?${qs}` : ''}`
+  const res = await integration.fetch(path)
+  const payload = await res.json()
+
+  const values = Array.isArray(payload?.values) ? payload.values : []
+  const resolvedRange = payload?.range || range
+  const { startColumn, startRow } = parseResolvedRange(resolvedRange)
+
+  const width = Math.max(1, ...values.map((row) => (Array.isArray(row) ? row.length : 0)))
+  const headerCells = Array.from({ length: width }, (_, i) => toColumnName(startColumn + i))
+  const lines = [
+    `|   | ${headerCells.join(' | ')} |`,
+    `|---|${Array(width).fill('---').join('|')}|`,
+  ]
+
+  for (let i = 0; i < values.length; i += 1) {
+    const row = Array.isArray(values[i]) ? values[i] : []
+    const padded = [...row, ...Array(width - row.length).fill('')]
+    const escaped = padded.map((cell) => escapeCell(cell))
+    lines.push(`| ${startRow + i} | ${escaped.join(' | ')} |`)
+  }
+
+  return {
+    spreadsheetId,
+    range: resolvedRange,
+    rowCount: values.length,
+    columnCount: width,
+    markdown: lines.join('\n'),
+  }
+}

package/integrations/google-sheet/manifest.json

@@ -4,119 +4,70 @@
   "tools": [
     {
       "name": "get_spreadsheet",
-      "description": "Retrieve spreadsheet metadata and optionally grid data.",
+      "description": "Retrieve spreadsheet metadata including all sheet names, IDs, and properties. Set includeGridData=false (the default) to get only metadata without cell values. Use read_sheet for cell content. Use the 'fields' parameter to limit the response (e.g. fields='sheets.properties' to get only sheet names and IDs). The spreadsheetId appears in the URL: https://docs.google.com/spreadsheets/d/{spreadsheetId}/.",
       "inputSchema": "schemas/get_spreadsheet.json",
       "handler": "handlers/get_spreadsheet.js",
       "scope": "read"
     },
     {
-      "name": "get_spreadsheet_by_data_filter",
-      "description": "Retrieve spreadsheet metadata using DataFilters.",
-      "inputSchema": "schemas/get_spreadsheet_by_data_filter.json",
-      "handler": "handlers/get_spreadsheet_by_data_filter.js",
-      "scope": "read"
-    },
-    {
-      "name": "get_values",
-      "description": "Get values from a single A1 range.",
-      "inputSchema": "schemas/get_values.json",
-      "handler": "handlers/get_values.js",
-      "scope": "read"
-    },
-    {
-      "name": "batch_get_values",
-      "description": "Batch get values for multiple A1 ranges.",
-      "inputSchema": "schemas/batch_get_values.json",
-      "handler": "handlers/batch_get_values.js",
-      "scope": "read"
-    },
-    {
-      "name": "get_values_by_data_filter",
-      "description": "Batch get values using DataFilters.",
-      "inputSchema": "schemas/get_values_by_data_filter.json",
-      "handler": "handlers/get_values_by_data_filter.js",
-      "scope": "read"
-    },
-    {
-      "name": "search_developer_metadata",
-      "description": "Search developer metadata in a spreadsheet.",
-      "inputSchema": "schemas/search_developer_metadata.json",
-      "handler": "handlers/search_developer_metadata.js",
-      "scope": "read"
-    },
-    {
-      "name": "get_developer_metadata",
-      "description": "Get a developer metadata entry by ID.",
-      "inputSchema": "schemas/get_developer_metadata.json",
-      "handler": "handlers/get_developer_metadata.js",
+      "name": "read_sheet",
+      "description": "Read cell values from a sheet range and return as a Markdown table with A1 column headers and row numbers. Use this to read and understand spreadsheet data -- the coordinates in the output can be used directly with update_values and append_values for writes. Supports optional valueRenderOption for formulas or raw numbers. Use get_spreadsheet first to discover sheet names.",
+      "inputSchema": "schemas/read_sheet.json",
+      "handler": "handlers/read_sheet.js",
       "scope": "read"
     },
     {
       "name": "create_spreadsheet",
-      "description": "Create a new spreadsheet.",
+      "description": "Create a new Google Spreadsheet. Accepts a full spreadsheet resource body, allowing you to specify the title, initial sheets, and cell data. Minimum: provide {title: 'My Spreadsheet'}. Returns the created spreadsheet including its spreadsheetId.",
       "inputSchema": "schemas/create_spreadsheet.json",
       "handler": "handlers/create_spreadsheet.js",
       "scope": "write"
     },
     {
       "name": "update_values",
-      "description": "Update values in a range (PUT).",
+      "description": "Write values to a specific A1 range, replacing existing content. Use valueInputOption='USER_ENTERED' to parse values as the user would type them (supports formulas, dates, currency). Use 'RAW' to store values as literal strings. Provide values as a 2D array (rows of columns).",
       "inputSchema": "schemas/update_values.json",
       "handler": "handlers/update_values.js",
       "scope": "write"
     },
     {
       "name": "append_values",
-      "description": "Append values after the last row of a range.",
+      "description": "Append rows of values after the last row of existing data in a range. Useful for adding new rows to a table without knowing the exact next row number. Uses USER_ENTERED valueInputOption by default. The range determines which sheet to append to.",
       "inputSchema": "schemas/append_values.json",
       "handler": "handlers/append_values.js",
       "scope": "write"
     },
     {
       "name": "batch_update_values",
-      "description": "Batch update values across multiple ranges.",
+      "description": "Write values to multiple A1 ranges in a single API call. More efficient than calling update_values multiple times. Provide a data array where each item has range and values. Use valueInputOption='USER_ENTERED' for formulas and dates.",
       "inputSchema": "schemas/batch_update_values.json",
       "handler": "handlers/batch_update_values.js",
       "scope": "write"
     },
-    {
-      "name": "batch_update_values_by_data_filter",
-      "description": "Batch update values using DataFilters.",
-      "inputSchema": "schemas/batch_update_values_by_data_filter.json",
-      "handler": "handlers/batch_update_values_by_data_filter.js",
-      "scope": "write"
-    },
     {
       "name": "clear_values",
-      "description": "Clear values in the specified range.",
+      "description": "Clear all values (but not formatting) in the specified A1 range. The cells remain but their content is removed. To clear formatting as well, use batch_update with a repeatCell request.",
       "inputSchema": "schemas/clear_values.json",
       "handler": "handlers/clear_values.js",
       "scope": "write"
     },
     {
       "name": "batch_clear_values",
-      "description": "Batch clear values across multiple ranges.",
+      "description": "Clear values from multiple A1 ranges in a single API call. More efficient than calling clear_values multiple times.",
       "inputSchema": "schemas/batch_clear_values.json",
       "handler": "handlers/batch_clear_values.js",
       "scope": "write"
     },
-    {
-      "name": "batch_clear_values_by_data_filter",
-      "description": "Batch clear values using DataFilters.",
-      "inputSchema": "schemas/batch_clear_values_by_data_filter.json",
-      "handler": "handlers/batch_clear_values_by_data_filter.js",
-      "scope": "write"
-    },
     {
       "name": "batch_update",
-      "description": "Send a batchUpdate request (addSheet, deleteSheet, etc).",
+      "description": "Send a spreadsheets.batchUpdate request for structural changes such as addSheet, deleteSheet, duplicateSheet, insertDimension, deleteDimension, mergeCells, sortRange, addConditionalFormatRule, and more. Accepts a requests array. Use update_values or batch_update_values for writing cell data.",
       "inputSchema": "schemas/batch_update.json",
       "handler": "handlers/batch_update.js",
       "scope": "write"
     },
     {
       "name": "copy_to_spreadsheet",
-      "description": "Copy a sheet to another spreadsheet.",
+      "description": "Copy a specific sheet (tab) from one spreadsheet to another. Provide the source spreadsheetId, the sheetId (integer, from get_spreadsheet), and the destination spreadsheetId. Returns the copied sheet's properties in the destination spreadsheet.",
       "inputSchema": "schemas/copy_to_spreadsheet.json",
       "handler": "handlers/copy_to_spreadsheet.js",
       "scope": "write"

package/integrations/google-sheet/prompt.md

@@ -0,0 +1,49 @@
+## A1 notation
+
+Ranges use A1 notation: `SheetName!StartCell:EndCell`
+
+Examples:
+- `Sheet1!A1:D10` — cells A1 to D10 on Sheet1
+- `Sheet1!A:A` — entire column A
+- `Sheet1!1:5` — rows 1 through 5
+- `Sheet1` — entire sheet (all data)
+- `A1:D10` — if the spreadsheet has only one sheet, sheet name can be omitted
+- `'My Sheet'!A1:B5` — sheet names with spaces must be quoted with single quotes
+
+Use `get_spreadsheet` with `fields='sheets.properties'` first to discover all sheet names and their IDs.
+
+## valueInputOption
+
+Controls how input values are interpreted in `update_values`, `append_values`, and `batch_update_values`:
+
+- `USER_ENTERED` *(recommended)* — values are parsed as if a user typed them. Supports formulas (`=SUM(A1:A10)`), dates (`1/15/2024`), currency (`$1,234.56`), and percentages (`50%`)
+- `RAW` — values are stored as literal strings, no parsing. Use when you want exact string storage
+
+## valueRenderOption
+
+Controls how values are returned in `read_sheet`:
+
+- `FORMATTED_VALUE` *(default)* — returns values as displayed in the UI (e.g. `"$1,234.56"`, `"50%"`)
+- `UNFORMATTED_VALUE` — returns raw numbers (e.g. `1234.56`, `0.5`)
+- `FORMULA` — returns formulas as strings (e.g. `"=SUM(A1:A10)"`)
+
+## Recommended workflow
+
+1. Call `get_spreadsheet` with `fields='sheets.properties'` to get sheet names and sheetIds
+2. Use `read_sheet` with an A1 range to read data as markdown plus explicit row/column coordinates
+3. Use the coordinates from `read_sheet` output (e.g. `B3`) with `update_values` or `append_values` for writes
+
+## Structural changes
+
+For adding/removing sheets, inserting/deleting rows or columns, or formatting cells, use `batch_update` with the appropriate request types:
+- `addSheet` — add a new tab
+- `deleteSheet` — remove a tab (requires sheetId, not name)
+- `insertDimension` — insert rows or columns
+- `deleteDimension` — delete rows or columns
+- `repeatCell` — apply formatting to a range
+
+## Large spreadsheets
+
+Avoid calling `get_spreadsheet` with `includeGridData=true` on large spreadsheets -- it can return megabytes of data. Instead:
+- Use `read_sheet` with specific ranges
+- Use `get_spreadsheet` with `fields='sheets.properties'` to get sheet metadata only

package/integrations/google-sheet/schemas/get_spreadsheet.json

@@ -3,13 +3,14 @@
   "type": "object",
   "required": ["spreadsheetId"],
   "properties": {
-    "spreadsheetId": { "type": "string", "description": "ID of the spreadsheet" },
-    "includeGridData": { "type": "boolean", "description": "Whether to include grid data" },
+    "spreadsheetId": { "type": "string", "description": "Spreadsheet ID. Found in the spreadsheet URL: https://docs.google.com/spreadsheets/d/{spreadsheetId}/." },
+    "includeGridData": { "type": "boolean", "description": "Whether to include cell grid data. Defaults to false. Set to true only when you need cell values -- use get_values or batch_get_values for targeted range reads instead." },
     "ranges": {
       "type": "array",
       "items": { "type": "string" },
-      "description": "Optional A1 ranges to include"
-    }
+      "description": "Optional A1 notation ranges to include when includeGridData is true. Example: ['Sheet1!A1:D10', 'Sheet2!A:A']."
+    },
+    "fields": { "type": "string", "description": "Partial response fields selector to reduce response size. Example: 'sheets.properties' to get only sheet names and IDs without cell data. See Sheets API fields reference." }
   },
   "additionalProperties": false
 }

package/integrations/google-sheet/schemas/read_sheet.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["spreadsheetId"],
+  "properties": {
+    "spreadsheetId": {
+      "type": "string",
+      "description": "Spreadsheet ID from URL: https://docs.google.com/spreadsheets/d/{spreadsheetId}/edit"
+    },
+    "range": {
+      "type": "string",
+      "description": "A1 notation range to read, e.g. 'Sheet1!A1:D20'. Defaults to 'A1:Z1000'."
+    },
+    "valueRenderOption": {
+      "type": "string",
+      "enum": ["FORMATTED_VALUE", "UNFORMATTED_VALUE", "FORMULA"],
+      "description": "How values should be represented in the output."
+    }
+  },
+  "additionalProperties": false
+}

package/integrations/google-slides/__tests__/get_handlers.test.ts

@@ -20,6 +20,7 @@ suite('google-slides read handlers (live)', () => {
     const credentialStore = createCredentialStore(async () => ({
       token: env.GOOGLE_TOKEN || '',
       serviceAccountJson: env.GOOGLE_SERVICE_ACCOUNT_JSON || '',
+      subject: env.GOOGLE_IMPERSONATE_SUBJECT || '',
     }))
     const proxy = createProxy(credentialStore)
     slides = createToolbox('google-slides', proxy, createIntegrationNode('google-slides', { label: 'Google Slides', credentialId: 'google-slides-creds' }))
@@ -46,25 +47,28 @@ suite('google-slides read handlers (live)', () => {
     await safeCleanup(async () => drive.write('delete_file')({ fileId: folderId }))
   }, 60000)
 
-  it('get_presentation returns metadata', async () => {
+  it('read_presentation returns human-readable content', async () => {
     if (!presentationId)
       return expect(true).toBe(true)
-    const handler = slides.read('get_presentation')
+    const handler = slides.read('read_presentation')
     const result = await handler({ presentationId })
-    expect(result?.presentationId || Array.isArray(result?.slides)).toBeTruthy()
+    expect(typeof result).toBe('string')
+    expect(String(result)).toContain('Presentation:')
   }, 30000)
 
   it('get_page_thumbnail returns URL data', async () => {
     if (!presentationId)
       return expect(true).toBe(true)
-    // First query the presentation to discover a page id
-    const getPresentation = slides.read('get_presentation')
-    const meta = await getPresentation({ presentationId })
-    const firstSlide = meta?.slides?.[0]
-    if (!firstSlide?.objectId)
+    // Query the readable summary and parse "Slide 1: ID <objectId>, ..."
+    const readPresentation = slides.read('read_presentation')
+    const summary = await readPresentation({ presentationId })
+    const text = String(summary || '')
+    const match = text.match(/Slide 1: ID ([^,\n]+)/)
+    const firstSlideObjectId = match?.[1]
+    if (!firstSlideObjectId)
       return expect(true).toBe(true)
     const handler = slides.read('get_page_thumbnail')
-    const result = await handler({ presentationId, 'pageObjectId': firstSlide.objectId, 'thumbnailProperties.thumbnailSize': 'MEDIUM', 'thumbnailProperties.mimeType': 'PNG' })
+    const result = await handler({ presentationId, 'pageObjectId': firstSlideObjectId, 'thumbnailProperties.thumbnailSize': 'MEDIUM', 'thumbnailProperties.mimeType': 'PNG' })
     expect(typeof result?.contentUrl === 'string' || typeof result?.thumbnailUrl === 'string').toBe(true)
   }, 30000)
 })

package/integrations/google-slides/__tests__/write_handlers.test.ts

@@ -21,6 +21,7 @@ suite('google-slides write handlers (live)', () => {
     const credentialStore = createCredentialStore(async () => ({
       token: env.GOOGLE_TOKEN || '',
       serviceAccountJson: env.GOOGLE_SERVICE_ACCOUNT_JSON || '',
+      subject: env.GOOGLE_IMPERSONATE_SUBJECT || '',
     }))
     const proxy = createProxy(credentialStore)
     slides = createToolbox('google-slides', proxy, createIntegrationNode('google-slides', { label: 'Google Slides', credentialId: 'google-slides-creds' }))
@@ -95,13 +96,11 @@ suite('google-slides write handlers (live)', () => {
   }, 60000)
 
   it('insert_image_after_first_match inserts an image when allowed', async () => {
-    const env = process.env as Record<string, string | undefined>
-    if (!ctx.presentationId || !env.GSLIDES_TEST_IMAGE_URI)
-      return expect(true).toBe(true)
-    if (!ctx.anchorText)
+    if (!ctx.presentationId || !ctx.anchorText)
       return expect(true).toBe(true)
+    const imageUri = 'https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png'
     const handler = slides.write('insert_image_after_first_match')
-    const res = await handler({ presentationId: ctx.presentationId, findText: ctx.anchorText, uri: env.GSLIDES_TEST_IMAGE_URI })
+    const res = await handler({ presentationId: ctx.presentationId, findText: ctx.anchorText, uri: imageUri })
     expect(res?.presentationId || Array.isArray(res?.replies)).toBeTruthy()
   }, 60000)