@commandable/integration-data 0.4.0 → 0.5.0

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

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["spreadsheetId", "range", "values"],
+  "properties": {
+    "spreadsheetId": { "type": "string" },
+    "range": { "type": "string" },
+    "values": { "type": "array", "items": { "type": "array", "items": {} } },
+    "valueInputOption": { "type": "string", "enum": ["RAW", "USER_ENTERED"] },
+    "insertDataOption": { "type": "string", "enum": ["OVERWRITE", "INSERT_ROWS"] },
+    "includeValuesInResponse": { "type": "boolean" },
+    "responseValueRenderOption": { "type": "string", "enum": ["FORMATTED_VALUE", "UNFORMATTED_VALUE", "FORMULA"] },
+    "responseDateTimeRenderOption": { "type": "string", "enum": ["SERIAL_NUMBER", "FORMATTED_STRING"] }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["spreadsheetId", "ranges"],
+  "properties": {
+    "spreadsheetId": { "type": "string" },
+    "ranges": { "type": "array", "items": { "type": "string" } }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["spreadsheetId", "requests"],
+  "properties": {
+    "spreadsheetId": { "type": "string" },
+    "requests": { "type": "array", "items": { "type": "object" } },
+    "includeSpreadsheetInResponse": { "type": "boolean" },
+    "responseRanges": { "type": "array", "items": { "type": "string" } },
+    "responseIncludeGridData": { "type": "boolean" }
+  },
+  "additionalProperties": true
+}

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

@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["spreadsheetId", "data"],
+  "properties": {
+    "spreadsheetId": { "type": "string" },
+    "data": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["range", "values"],
+        "properties": {
+          "range": { "type": "string" },
+          "values": { "type": "array", "items": { "type": "array", "items": {} } },
+          "majorDimension": { "type": "string", "enum": ["ROWS", "COLUMNS"] }
+        }
+      }
+    },
+    "valueInputOption": { "type": "string", "enum": ["RAW", "USER_ENTERED"] },
+    "includeValuesInResponse": { "type": "boolean" },
+    "responseValueRenderOption": { "type": "string", "enum": ["FORMATTED_VALUE", "UNFORMATTED_VALUE", "FORMULA"] },
+    "responseDateTimeRenderOption": { "type": "string", "enum": ["SERIAL_NUMBER", "FORMATTED_STRING"] }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["spreadsheetId", "range"],
+  "properties": {
+    "spreadsheetId": { "type": "string" },
+    "range": { "type": "string" }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,11 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["spreadsheetId", "sheetId", "destinationSpreadsheetId"],
+  "properties": {
+    "spreadsheetId": { "type": "string", "description": "Source spreadsheet ID" },
+    "sheetId": { "type": "integer", "description": "Source sheet numeric ID" },
+    "destinationSpreadsheetId": { "type": "string", "description": "Destination spreadsheet ID" }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,11 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "properties": { "type": "object", "description": "Spreadsheet properties" },
+    "sheets": { "type": "array", "items": { "type": "object" } },
+    "namedRanges": { "type": "array", "items": { "type": "object" } },
+    "dataSources": { "type": "array", "items": { "type": "object" } }
+  },
+  "additionalProperties": true
+}

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

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["spreadsheetId"],
+  "properties": {
+    "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 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-sheet/schemas/update_values.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["spreadsheetId", "range", "values"],
+  "properties": {
+    "spreadsheetId": { "type": "string" },
+    "range": { "type": "string" },
+    "values": { "type": "array", "items": { "type": "array", "items": {} } },
+    "valueInputOption": { "type": "string", "enum": ["RAW", "USER_ENTERED"] },
+    "includeValuesInResponse": { "type": "boolean" },
+    "responseValueRenderOption": { "type": "string", "enum": ["FORMATTED_VALUE", "UNFORMATTED_VALUE", "FORMULA"] },
+    "responseDateTimeRenderOption": { "type": "string", "enum": ["SERIAL_NUMBER", "FORMATTED_STRING"] }
+  },
+  "additionalProperties": false
+}

package/integrations/google-slides/README.md

@@ -0,0 +1,28 @@
+# Google Slides
+
+**11 tools**
+
+![Google Slides tests](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/theomccabe/771bd329f303087690c522afa1baa6f3/raw/test-google-slides.json)
+
+## Credential variants
+
+| Variant | Label |
+|---|---|
+| `service_account` | Service Account (recommended) _(default)_ |
+| `oauth_token` | OAuth Access Token (short-lived) |
+
+## Tools
+
+| Tool | Scope | Description |
+|---|---|---|
+| `read_presentation` | read | Read a Google Slides presentation and return a human-readable summary including the title… |
+| `get_page_thumbnail` | read | Generate a thumbnail image URL for a specific slide (page) in a presentation. Requires th… |
+| `create_presentation` | write | Create a new empty Google Slides presentation with an optional title. Returns the created… |
+| `batch_update` | write | Send a presentations.batchUpdate request for low-level slide modifications. Accepts an ar… |
+| `append_text_to_title_of_slide_index` | write | Append text to the title shape of a specific slide by its 0-based index (slideIndex=0 is … |
+| `replace_text_first_match` | write | Replace the first occurrence of text anywhere in the presentation with new text. Note: th… |
+| `style_text_first_match` | write | Find the first occurrence of text in the presentation and apply a text style to it (bold,… |
+| `insert_shape_after_first_match` | write | Find the first slide containing a text match and insert a rectangle shape on that slide a… |
+| `insert_image_after_first_match` | write | Find the first slide containing a text match and insert an image on that slide from a URL… |
+| `create_slide_after_first_match` | write | Find the first slide containing a text match and create a new blank slide immediately aft… |
+| `set_background_color_for_slide_index` | write | Set the background color for a specific slide by its 0-based index (slideIndex=0 is the f… |

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

@@ -0,0 +1,74 @@
+import { afterAll, beforeAll, describe, expect, it } from 'vitest'
+import { createCredentialStore, createIntegrationNode, createProxy, createToolbox, hasEnv, safeCleanup } from '../../__tests__/liveHarness.js'
+
+// LIVE Google Slides read tests using credentials
+// Required env vars:
+// - Either GOOGLE_TOKEN, OR GOOGLE_SERVICE_ACCOUNT_JSON
+
+const suite = (hasEnv('GOOGLE_TOKEN') || hasEnv('GOOGLE_SERVICE_ACCOUNT_JSON'))
+  ? describe
+  : describe.skip
+
+suite('google-slides read handlers (live)', () => {
+  let slides: ReturnType<typeof createToolbox>
+  let drive: ReturnType<typeof createToolbox>
+  let folderId: string | undefined
+  let presentationId: string | undefined
+
+  beforeAll(async () => {
+    const env = process.env as Record<string, string | undefined>
+    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' }))
+    drive = createToolbox('google-drive', proxy, createIntegrationNode('google-drive', { label: 'Google Drive', credentialId: 'google-drive-creds' }))
+
+    // Create dedicated folder + presentation for this run
+    const folder = await drive.write('create_folder')({ name: `CmdTest Slides ${Date.now()}` })
+    folderId = folder?.id
+    expect(folderId).toBeTruthy()
+
+    const created = await drive.write('create_file')({
+      name: `CmdTest Slides ${Date.now()}`,
+      mimeType: 'application/vnd.google-apps.presentation',
+      parentId: folderId,
+    })
+    presentationId = created?.id
+    expect(presentationId).toBeTruthy()
+  }, 60000)
+
+  afterAll(async () => {
+    if (!folderId)
+      return
+    await safeCleanup(async () => presentationId ? drive.write('delete_file')({ fileId: presentationId }) : Promise.resolve())
+    await safeCleanup(async () => drive.write('delete_file')({ fileId: folderId }))
+  }, 60000)
+
+  it('read_presentation returns human-readable content', async () => {
+    if (!presentationId)
+      return expect(true).toBe(true)
+    const handler = slides.read('read_presentation')
+    const result = await handler({ presentationId })
+    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)
+    // 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': firstSlideObjectId, 'thumbnailProperties.thumbnailSize': 'MEDIUM', 'thumbnailProperties.mimeType': 'PNG' })
+    expect(typeof result?.contentUrl === 'string' || typeof result?.thumbnailUrl === 'string').toBe(true)
+  }, 30000)
+})

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

@@ -0,0 +1,9 @@
+import { describe, expect, it } from 'vitest'
+import { getMissingToolUsages } from '../../__tests__/usageParity.js'
+
+describe('google-slides static usage parity', () => {
+  it('every manifest tool is referenced in tests', () => {
+    const missing = getMissingToolUsages({ integrationName: 'google-slides', importMetaUrl: import.meta.url })
+    expect(missing, `Missing handler usages in tests: ${missing.join(', ')}`).toEqual([])
+  })
+})

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

@@ -0,0 +1,131 @@
+import { afterAll, beforeAll, describe, expect, it } from 'vitest'
+import { createCredentialStore, createIntegrationNode, createProxy, createToolbox, hasEnv, safeCleanup } from '../../__tests__/liveHarness.js'
+
+// LIVE Google Slides write tests using credentials
+// Required env vars:
+// - Either GOOGLE_TOKEN, OR GOOGLE_SERVICE_ACCOUNT_JSON
+
+interface Ctx { presentationId?: string, folderId?: string, anchorText?: string }
+
+const suite = (hasEnv('GOOGLE_TOKEN') || hasEnv('GOOGLE_SERVICE_ACCOUNT_JSON'))
+  ? describe
+  : describe.skip
+
+suite('google-slides write handlers (live)', () => {
+  const ctx: Ctx = {}
+  let slides: ReturnType<typeof createToolbox>
+  let drive: ReturnType<typeof createToolbox>
+
+  beforeAll(async () => {
+    const env = process.env as Record<string, string | undefined>
+    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' }))
+    drive = createToolbox('google-drive', proxy, createIntegrationNode('google-drive', { label: 'Google Drive', credentialId: 'google-drive-creds' }))
+
+    const folder = await drive.write('create_folder')({ name: `CmdTest Slides Write ${Date.now()}` })
+    ctx.folderId = folder?.id
+    expect(ctx.folderId).toBeTruthy()
+
+    const created = await drive.write('create_file')({
+      name: `CmdTest Slides ${Date.now()}`,
+      mimeType: 'application/vnd.google-apps.presentation',
+      parentId: ctx.folderId,
+    })
+    ctx.presentationId = created?.id
+    expect(ctx.presentationId).toBeTruthy()
+
+    ctx.anchorText = `CMD_ANCHOR_${Date.now()}`
+    const appendTitle = slides.write('append_text_to_title_of_slide_index')
+    await appendTitle({ presentationId: ctx.presentationId, slideIndex: 0, text: ` ${ctx.anchorText} ` })
+  }, 60000)
+
+  afterAll(async () => {
+    await safeCleanup(async () => ctx.presentationId ? drive.write('delete_file')({ fileId: ctx.presentationId }) : Promise.resolve())
+    await safeCleanup(async () => ctx.folderId ? drive.write('delete_file')({ fileId: ctx.folderId }) : Promise.resolve())
+  }, 60_000)
+
+  it('batch_update performs a trivial update (no-op replace)', async () => {
+    if (!ctx.presentationId)
+      return expect(true).toBe(true)
+    const handler = slides.write('batch_update')
+    const res = await handler({ presentationId: ctx.presentationId, requests: [
+      { replaceAllText: { containsText: { text: '___unlikely___', matchCase: true }, replaceText: '___unlikely___' } },
+    ] })
+    expect(res?.presentationId || Array.isArray(res?.replies) || res?.writeControl).toBeTruthy()
+  }, 60000)
+
+  it('append_text_to_title_of_slide_index appends to title', async () => {
+    if (!ctx.presentationId)
+      return expect(true).toBe(true)
+    const handler = slides.write('append_text_to_title_of_slide_index')
+    const res = await handler({ presentationId: ctx.presentationId, slideIndex: 0, text: ` CmdTest ${Date.now()}` })
+    expect(res?.presentationId || Array.isArray(res?.replies)).toBeTruthy()
+  }, 60000)
+
+  it('replace_text_first_match replaces text (no-op ok)', async () => {
+    if (!ctx.presentationId)
+      return expect(true).toBe(true)
+    const handler = slides.write('replace_text_first_match')
+    const res = await handler({ presentationId: ctx.presentationId, findText: '___unlikely___', replaceText: '___unlikely___' })
+    expect(res?.presentationId || Array.isArray(res?.replies)).toBeTruthy()
+  }, 60000)
+
+  it('style_text_first_match applies style', async () => {
+    if (!ctx.presentationId)
+      return expect(true).toBe(true)
+    if (!ctx.anchorText)
+      return expect(true).toBe(true)
+    const handler = slides.write('style_text_first_match')
+    const res = await handler({ presentationId: ctx.presentationId, findText: ctx.anchorText, textStyle: { bold: true } })
+    expect(res?.presentationId || Array.isArray(res?.replies)).toBeTruthy()
+  }, 60000)
+
+  it('insert_shape_after_first_match inserts a shape', async () => {
+    if (!ctx.presentationId)
+      return expect(true).toBe(true)
+    if (!ctx.anchorText)
+      return expect(true).toBe(true)
+    const handler = slides.write('insert_shape_after_first_match')
+    const res = await handler({ presentationId: ctx.presentationId, findText: ctx.anchorText, shapeType: 'RECTANGLE' })
+    expect(res?.presentationId || Array.isArray(res?.replies)).toBeTruthy()
+  }, 60000)
+
+  it('insert_image_after_first_match inserts an image when allowed', async () => {
+    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: imageUri })
+    expect(res?.presentationId || Array.isArray(res?.replies)).toBeTruthy()
+  }, 60000)
+
+  it('create_slide_after_first_match creates a slide near anchor', async () => {
+    if (!ctx.presentationId)
+      return expect(true).toBe(true)
+    if (!ctx.anchorText)
+      return expect(true).toBe(true)
+    const handler = slides.write('create_slide_after_first_match')
+    const res = await handler({ presentationId: ctx.presentationId, findText: ctx.anchorText, layout: 'BLANK' })
+    expect(res?.presentationId || Array.isArray(res?.replies)).toBeTruthy()
+  }, 60000)
+
+  it('set_background_color_for_slide_index sets color', async () => {
+    if (!ctx.presentationId)
+      return expect(true).toBe(true)
+    const handler = slides.write('set_background_color_for_slide_index')
+    const res = await handler({ presentationId: ctx.presentationId, slideIndex: 0, rgbColor: { red: 0.9, green: 0.9, blue: 0.9 } })
+    expect(res?.presentationId || Array.isArray(res?.replies)).toBeTruthy()
+  }, 60000)
+
+  it('create_presentation creates a presentation (self-cleaning)', async () => {
+    const created = await slides.write('create_presentation')({ title: `CmdTest Slides Tool ${Date.now()}` })
+    const id = created?.presentationId
+    expect(typeof id).toBe('string')
+    await safeCleanup(async () => id ? drive.write('delete_file')({ fileId: id }) : Promise.resolve())
+  }, 60000)
+})

package/integrations/google-slides/credentials.json

@@ -0,0 +1,59 @@
+{
+  "variants": {
+    "service_account": {
+      "label": "Service Account (recommended)",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "serviceAccountJson": {
+            "type": "string",
+            "title": "Service Account JSON",
+            "description": "Full service account key JSON (contents of the downloaded JSON file from Google Cloud)."
+          },
+          "subject": {
+            "type": "string",
+            "title": "Subject / impersonated user (optional)",
+            "description": "Optional user email to impersonate when using Google Workspace domain-wide delegation."
+          },
+          "scopes": {
+            "type": "array",
+            "title": "OAuth scopes (optional)",
+            "description": "Optional override for OAuth scopes. Defaults to presentations + drive.",
+            "items": { "type": "string" }
+          }
+        },
+        "required": ["serviceAccountJson"],
+        "additionalProperties": false
+      },
+      "injection": {
+        "headers": {
+          "Authorization": "Bearer {{token}}"
+        }
+      },
+      "preprocess": "google_service_account",
+      "healthCheck": { "notViable": true }
+    },
+    "oauth_token": {
+      "label": "OAuth Access Token (short-lived)",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "token": {
+            "type": "string",
+            "title": "OAuth Access Token",
+            "description": "Short-lived Google OAuth access token with presentations and drive scopes."
+          }
+        },
+        "required": ["token"],
+        "additionalProperties": false
+      },
+      "injection": {
+        "headers": {
+          "Authorization": "Bearer {{token}}"
+        }
+      },
+      "healthCheck": { "notViable": true }
+    }
+  },
+  "default": "service_account"
+}

package/integrations/google-slides/credentials_hint.md

@@ -0,0 +1,9 @@
+Recommended: use a Google service account.
+
+- Create a service account in Google Cloud
+- Download a JSON key
+- Paste the JSON into `serviceAccountJson`
+- Share your test presentation with the service account `client_email`
+
+You can also paste a short-lived OAuth access token into `token`, but it will expire.
+

package/integrations/google-slides/credentials_hint_oauth_token.md

@@ -0,0 +1,8 @@
+Obtain a short-lived Google OAuth access token:
+
+1. Use the Google OAuth 2.0 Playground (`https://developers.google.com/oauthplayground/`) or your own OAuth flow
+2. Select the scopes: `https://www.googleapis.com/auth/presentations` and `https://www.googleapis.com/auth/drive`
+3. Exchange the authorization code for an access token
+4. Paste the access token here
+
+Note: OAuth access tokens are short-lived (typically 1 hour). For long-running use, prefer the Service Account variant.

package/integrations/google-slides/credentials_hint_service_account.md

@@ -0,0 +1,10 @@
+Set up a Google Cloud Service Account:
+
+1. Open the [Google Cloud Console](https://console.cloud.google.com/)
+2. Enable the **Google Slides API** and **Google Drive API** for your project
+3. Go to **IAM & Admin → Service Accounts** and create a new service account
+4. Under **Keys**, click **Add Key → Create new key → JSON** and download the file
+5. Paste the full contents of the JSON file here
+6. Share your target presentations with the service account's `client_email`
+
+For Google Workspace users: optionally configure domain-wide delegation and set `subject` to the user's email.

package/integrations/google-slides/handlers/append_text_to_title_of_first_slide.js

@@ -0,0 +1,17 @@
+async (input) => {
+  const { presentationId, text, slideIndex = 0 } = input
+  const presRes = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}`)
+  const pres = await presRes.json()
+  const slide = (pres?.slides || [])[slideIndex]
+  if (!slide)
+    return { presentationId, applied: false, replies: [] }
+  const titleShape = (slide.pageElements || []).find(el => el.shape?.placeholder?.type === 'TITLE')
+  if (!titleShape?.objectId)
+    return { presentationId, applied: false, replies: [] }
+  const res = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}:batchUpdate`, {
+    method: 'POST',
+    body: { requests: [{ insertText: { objectId: titleShape.objectId, insertionIndex: -1, text } }] },
+  })
+  const out = await res.json()
+  return out?.presentationId ? { ...out, applied: true } : { presentationId, applied: true, replies: out?.replies || [] }
+}

package/integrations/google-slides/handlers/batch_update.js

@@ -0,0 +1,15 @@
+async (input) => {
+  const { presentationId, requests, includePresentationInResponse, responsePageObjectIds, writeControl } = input
+  const params = new URLSearchParams()
+  if (includePresentationInResponse !== undefined)
+    params.set('includePresentationInResponse', String(includePresentationInResponse))
+  if (Array.isArray(responsePageObjectIds))
+    responsePageObjectIds.forEach(id => params.append('responsePageObjectIds', String(id)))
+  const qs = params.toString()
+  const path = `/presentations/${encodeURIComponent(presentationId)}:batchUpdate${qs ? `?${qs}` : ''}`
+  const body = { requests }
+  if (writeControl)
+    body.writeControl = writeControl
+  const res = await integration.fetch(path, { method: 'POST', body })
+  return await res.json()
+}

package/integrations/google-slides/handlers/create_presentation.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const body = {}
+  if (input && typeof input.title === 'string') {
+    body.title = input.title
+  }
+  const res = await integration.fetch('/presentations', { method: 'POST', body })
+  return await res.json()
+}

package/integrations/google-slides/handlers/create_slide_after_first_match.js

@@ -0,0 +1,20 @@
+async (input) => {
+  const { presentationId, findText, layout = 'BLANK' } = input
+  const presRes = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}`)
+  const pres = await presRes.json()
+  let targetSlideId = null
+  for (const slide of (pres?.slides || [])) {
+    const text = JSON.stringify(slide)
+    if (text && text.includes(findText)) { targetSlideId = slide.objectId; break }
+  }
+  if (!targetSlideId)
+    return { presentationId, applied: false, replies: [] }
+  const newSlideId = `slide_${Date.now()}`
+  const currentIndex = (pres?.slides || []).findIndex(s => s.objectId === targetSlideId)
+  const requests = [
+    { createSlide: { objectId: newSlideId, insertionIndex: currentIndex >= 0 ? currentIndex + 1 : (pres?.slides?.length || 0), slideLayoutReference: { predefinedLayout: layout } } },
+  ]
+  const res = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}:batchUpdate`, { method: 'POST', body: { requests } })
+  const out = await res.json()
+  return out?.presentationId ? { ...out, applied: true } : { presentationId, applied: true, replies: out?.replies || [] }
+}

package/integrations/google-slides/handlers/get_page_thumbnail.js

@@ -0,0 +1,12 @@
+async (input) => {
+  const { presentationId, pageObjectId } = input
+  const params = new URLSearchParams()
+  if (input['thumbnailProperties.thumbnailSize'])
+    params.set('thumbnailProperties.thumbnailSize', String(input['thumbnailProperties.thumbnailSize']))
+  if (input['thumbnailProperties.mimeType'])
+    params.set('thumbnailProperties.mimeType', String(input['thumbnailProperties.mimeType']))
+  const qs = params.toString()
+  const path = `/presentations/${encodeURIComponent(presentationId)}/pages/${encodeURIComponent(pageObjectId)}/thumbnail${qs ? `?${qs}` : ''}`
+  const res = await integration.fetch(path)
+  return await res.json()
+}

package/integrations/google-slides/handlers/insert_image_after_first_match.js

@@ -0,0 +1,19 @@
+async (input) => {
+  const { presentationId, findText, uri, width = 2000000, height = 2000000 } = input
+  const presRes = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}`)
+  const pres = await presRes.json()
+  let targetSlideId = null
+  for (const slide of (pres?.slides || [])) {
+    const text = JSON.stringify(slide)
+    if (text && text.includes(findText)) { targetSlideId = slide.objectId; break }
+  }
+  if (!targetSlideId)
+    return { presentationId, applied: false, replies: [] }
+  const elementId = `image_${Date.now()}`
+  const requests = [
+    { createImage: { objectId: elementId, url: uri, elementProperties: { pageObjectId: targetSlideId, size: { width: { magnitude: width, unit: 'EMU' }, height: { magnitude: height, unit: 'EMU' } }, transform: { scaleX: 1, scaleY: 1, translateX: 1000000, translateY: 1000000, unit: 'EMU' } } } },
+  ]
+  const res = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}:batchUpdate`, { method: 'POST', body: { requests } })
+  const out = await res.json()
+  return out?.presentationId ? { ...out, applied: true } : { presentationId, applied: true, replies: out?.replies || [] }
+}

package/integrations/google-slides/handlers/insert_shape_after_first_match.js

@@ -0,0 +1,21 @@
+async (input) => {
+  const { presentationId, findText, shapeType = 'RECTANGLE', width = 2000000, height = 1000000 } = input
+  const presRes = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}`)
+  const pres = await presRes.json()
+  // Find slide with first text match
+  let targetSlideId = null
+  for (const slide of (pres?.slides || [])) {
+    const text = JSON.stringify(slide)
+    if (text && text.includes(findText)) { targetSlideId = slide.objectId; break }
+  }
+  if (!targetSlideId)
+    return { presentationId, applied: false, replies: [] }
+  // Insert a shape at a default position near center
+  const elementId = `shape_${Date.now()}`
+  const requests = [
+    { createShape: { objectId: elementId, shapeType, elementProperties: { pageObjectId: targetSlideId, size: { width: { magnitude: width, unit: 'EMU' }, height: { magnitude: height, unit: 'EMU' } }, transform: { scaleX: 1, scaleY: 1, translateX: 1000000, translateY: 1000000, unit: 'EMU' } } } },
+  ]
+  const res = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}:batchUpdate`, { method: 'POST', body: { requests } })
+  const out = await res.json()
+  return out?.presentationId ? { ...out, applied: true } : { presentationId, applied: true, replies: out?.replies || [] }
+}