@commandable/integration-data 0.0.1

package/integrations/google-sheet/manifest.json

@@ -0,0 +1,125 @@
+{
+  "name": "google-sheet",
+  "version": "0.1.0",
+  "tools": [
+    {
+      "name": "get_spreadsheet",
+      "description": "Retrieve spreadsheet metadata and optionally grid data.",
+      "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",
+      "scope": "read"
+    },
+    {
+      "name": "create_spreadsheet",
+      "description": "Create a new spreadsheet.",
+      "inputSchema": "schemas/create_spreadsheet.json",
+      "handler": "handlers/create_spreadsheet.js",
+      "scope": "write"
+    },
+    {
+      "name": "update_values",
+      "description": "Update values in a range (PUT).",
+      "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.",
+      "inputSchema": "schemas/append_values.json",
+      "handler": "handlers/append_values.js",
+      "scope": "write"
+    },
+    {
+      "name": "batch_update_values",
+      "description": "Batch update values across multiple ranges.",
+      "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.",
+      "inputSchema": "schemas/clear_values.json",
+      "handler": "handlers/clear_values.js",
+      "scope": "write"
+    },
+    {
+      "name": "batch_clear_values",
+      "description": "Batch clear values across multiple ranges.",
+      "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).",
+      "inputSchema": "schemas/batch_update.json",
+      "handler": "handlers/batch_update.js",
+      "scope": "write"
+    },
+    {
+      "name": "copy_to_spreadsheet",
+      "description": "Copy a sheet to another spreadsheet.",
+      "inputSchema": "schemas/copy_to_spreadsheet.json",
+      "handler": "handlers/copy_to_spreadsheet.js",
+      "scope": "write"
+    }
+  ]
+}

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_clear_values_by_data_filter.json

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

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

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["spreadsheetId", "ranges"],
+  "properties": {
+    "spreadsheetId": { "type": "string" },
+    "ranges": { "type": "array", "items": { "type": "string" } },
+    "majorDimension": { "type": "string", "enum": ["ROWS", "COLUMNS"] },
+    "valueRenderOption": { "type": "string", "enum": ["FORMATTED_VALUE", "UNFORMATTED_VALUE", "FORMULA"] },
+    "dateTimeRenderOption": { "type": "string", "enum": ["SERIAL_NUMBER", "FORMATTED_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/batch_update_values_by_data_filter.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": ["dataFilter", "values"],
+        "properties": {
+          "dataFilter": { "type": "object" },
+          "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_developer_metadata.json

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

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

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["spreadsheetId"],
+  "properties": {
+    "spreadsheetId": { "type": "string", "description": "ID of the spreadsheet" },
+    "includeGridData": { "type": "boolean", "description": "Whether to include grid data" },
+    "ranges": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Optional A1 ranges to include"
+    }
+  },
+  "additionalProperties": false
+}

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

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

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

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["spreadsheetId", "range"],
+  "properties": {
+    "spreadsheetId": { "type": "string" },
+    "range": { "type": "string", "description": "A1 notation range" },
+    "majorDimension": { "type": "string", "enum": ["ROWS", "COLUMNS"], "description": "Return values by rows or columns" },
+    "valueRenderOption": { "type": "string", "enum": ["FORMATTED_VALUE", "UNFORMATTED_VALUE", "FORMULA"] },
+    "dateTimeRenderOption": { "type": "string", "enum": ["SERIAL_NUMBER", "FORMATTED_STRING"] }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["spreadsheetId", "dataFilters"],
+  "properties": {
+    "spreadsheetId": { "type": "string" },
+    "dataFilters": {
+      "type": "array",
+      "items": { "type": "object" },
+      "description": "Array of DataFilter objects per Sheets API"
+    },
+    "majorDimension": { "type": "string", "enum": ["ROWS", "COLUMNS"] },
+    "valueRenderOption": { "type": "string", "enum": ["FORMATTED_VALUE", "UNFORMATTED_VALUE", "FORMULA"] },
+    "dateTimeRenderOption": { "type": "string", "enum": ["SERIAL_NUMBER", "FORMATTED_STRING"] }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["spreadsheetId", "dataFilters"],
+  "properties": {
+    "spreadsheetId": { "type": "string" },
+    "dataFilters": {
+      "type": "array",
+      "items": { "type": "object" },
+      "description": "DeveloperMetadataLookup wrapped in DataFilter objects"
+    }
+  },
+  "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/__tests__/get_handlers.test.ts

@@ -0,0 +1,69 @@
+import { beforeAll, describe, expect, it } from 'vitest'
+import { IntegrationProxy } from '../../../src/integrations/proxy.js'
+import { loadIntegrationTools } from '../../../src/integrations/dataLoader.js'
+
+// LIVE Google Slides read tests using managed OAuth
+// Required env vars:
+// - COMMANDABLE_MANAGED_OAUTH_BASE_URL
+// - COMMANDABLE_MANAGED_OAUTH_SECRET_KEY
+// - GSLIDES_TEST_CONNECTION_ID (managed OAuth connection for provider 'google-slides')
+// - GSLIDES_TEST_PRESENTATION_ID (an accessible presentation ID)
+
+const env = process.env as Record<string, string>
+const hasEnv = (...keys: string[]) => keys.every(k => !!env[k] && env[k].trim().length > 0)
+const suite = hasEnv(
+  'COMMANDABLE_MANAGED_OAUTH_BASE_URL',
+  'COMMANDABLE_MANAGED_OAUTH_SECRET_KEY',
+  'GSLIDES_TEST_CONNECTION_ID',
+)
+  ? describe
+  : describe.skip
+
+suite('google-slides read handlers (live)', () => {
+  let buildReadHandler: (name: string) => ((input: any) => Promise<any>)
+
+  beforeAll(async () => {
+    const { COMMANDABLE_MANAGED_OAUTH_BASE_URL, COMMANDABLE_MANAGED_OAUTH_SECRET_KEY, GSLIDES_TEST_CONNECTION_ID } = env
+
+    const proxy = new IntegrationProxy({
+      managedOAuthBaseUrl: COMMANDABLE_MANAGED_OAUTH_BASE_URL,
+      managedOAuthSecretKey: COMMANDABLE_MANAGED_OAUTH_SECRET_KEY,
+    })
+    const integrationNode = { id: 'node-gslides', type: 'google-slides', label: 'Google Slides', connectionId: GSLIDES_TEST_CONNECTION_ID } as any
+
+    const tools = loadIntegrationTools('google-slides')
+    expect(tools).toBeTruthy()
+
+    buildReadHandler = (name: string) => {
+      const tool = tools!.read.find(t => t.name === name)
+      expect(tool, `read tool ${name} exists`).toBeTruthy()
+      const integration = { fetch: (path: string, init?: RequestInit) => proxy.call(integrationNode, path, init) }
+      const build = new Function('integration', `return (${tool!.handlerCode});`)
+      return build(integration) as (input: any) => Promise<any>
+    }
+  }, 60000)
+
+  it('get_presentation returns metadata', async () => {
+    const presentationId = env.GSLIDES_TEST_PRESENTATION_ID
+    if (!presentationId)
+      return expect(true).toBe(true)
+    const handler = buildReadHandler('get_presentation')
+    const result = await handler({ presentationId })
+    expect(result?.presentationId || Array.isArray(result?.slides)).toBeTruthy()
+  }, 30000)
+
+  it('get_page_thumbnail returns URL data', async () => {
+    const presentationId = env.GSLIDES_TEST_PRESENTATION_ID
+    if (!presentationId)
+      return expect(true).toBe(true)
+    // First query the presentation to discover a page id
+    const getPresentation = buildReadHandler('get_presentation')
+    const meta = await getPresentation({ presentationId })
+    const firstSlide = meta?.slides?.[0]
+    if (!firstSlide?.objectId)
+      return expect(true).toBe(true)
+    const handler = buildReadHandler('get_page_thumbnail')
+    const result = await handler({ presentationId, 'pageObjectId': firstSlide.objectId, '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,34 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { describe, expect, it } from 'vitest'
+import { loadIntegrationManifest } from '../../../src/integrations/dataLoader.js'
+
+function escapeRegExp(str: string): string {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+}
+
+describe('google-slides static usage parity', () => {
+  it('every manifest tool is referenced in tests via build*(name)', () => {
+    const manifest = loadIntegrationManifest('google-slides')!
+    const toolNames = (manifest.tools as any[]).map(t => t.name)
+
+    const testsDir = fileURLToPath(new URL('.', import.meta.url))
+    expect(existsSync(testsDir)).toBe(true)
+    const testFiles = readdirSync(testsDir)
+      .filter(f => /\.test\.(t|j)s$/.test(f) && !f.includes('usage_parity.test'))
+      .map(f => resolve(testsDir, f))
+
+    const fileContents = testFiles.map(f => readFileSync(f, 'utf8'))
+
+    const missing: string[] = []
+    for (const name of toolNames) {
+      const nameRe = new RegExp(`build(?:Read|Write|Admin)?(?:Handler)?\\(\\s*['\"\`]${escapeRegExp(name)}['\"\`]\\s*\\)`, 'm')
+      const found = fileContents.some(src => nameRe.test(src))
+      if (!found)
+        missing.push(name)
+    }
+
+    expect(missing, `Missing handler usages in tests: ${missing.join(', ')}`).toEqual([])
+  })
+})

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

@@ -0,0 +1,125 @@
+import { beforeAll, describe, expect, it } from 'vitest'
+import { IntegrationProxy } from '../../../src/integrations/proxy.js'
+import { loadIntegrationTools } from '../../../src/integrations/dataLoader.js'
+
+// LIVE Google Slides write tests using managed OAuth
+// Required env vars:
+// - COMMANDABLE_MANAGED_OAUTH_BASE_URL
+// - COMMANDABLE_MANAGED_OAUTH_SECRET_KEY
+// - GSLIDES_TEST_CONNECTION_ID (managed OAuth connection for provider 'google-slides')
+// - GSLIDES_TEST_PRESENTATION_ID (a presentation ID with write access)
+
+interface Ctx { presentationId?: string }
+
+const env = process.env as Record<string, string>
+const hasEnv = (...keys: string[]) => keys.every(k => !!env[k] && env[k].trim().length > 0)
+const suite = hasEnv(
+  'COMMANDABLE_MANAGED_OAUTH_BASE_URL',
+  'COMMANDABLE_MANAGED_OAUTH_SECRET_KEY',
+  'GSLIDES_TEST_CONNECTION_ID',
+  'GSLIDES_TEST_PRESENTATION_ID',
+)
+  ? describe
+  : describe.skip
+
+suite('google-slides write handlers (live)', () => {
+  const ctx: Ctx = {}
+  let buildWriteHandler: (name: string) => ((input: any) => Promise<any>)
+
+  beforeAll(async () => {
+    const { COMMANDABLE_MANAGED_OAUTH_BASE_URL, COMMANDABLE_MANAGED_OAUTH_SECRET_KEY, GSLIDES_TEST_CONNECTION_ID, GSLIDES_TEST_PRESENTATION_ID } = env
+
+    const proxy = new IntegrationProxy({
+      managedOAuthBaseUrl: COMMANDABLE_MANAGED_OAUTH_BASE_URL,
+      managedOAuthSecretKey: COMMANDABLE_MANAGED_OAUTH_SECRET_KEY,
+    })
+    const integrationNode = { id: 'node-gslides', type: 'google-slides', label: 'Google Slides', connectionId: GSLIDES_TEST_CONNECTION_ID } as any
+
+    const tools = loadIntegrationTools('google-slides')
+    expect(tools).toBeTruthy()
+
+    buildWriteHandler = (name: string) => {
+      const tool = tools!.write.find(t => t.name === name)
+      expect(tool, `write tool ${name} exists`).toBeTruthy()
+      const integration = { fetch: (path: string, init?: RequestInit) => proxy.call(integrationNode, path, init) }
+      const build = new Function('integration', `return (${tool!.handlerCode});`)
+      return build(integration) as (input: any) => Promise<any>
+    }
+
+    ctx.presentationId = GSLIDES_TEST_PRESENTATION_ID
+  }, 60000)
+
+  it('batch_update performs a trivial update (no-op replace)', async () => {
+    if (!ctx.presentationId)
+      return expect(true).toBe(true)
+    const handler = buildWriteHandler('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('create_presentation creates a presentation when allowed', async () => {
+    if (!env.GSLIDES_ALLOW_CREATE)
+      return expect(true).toBe(true)
+    const handler = buildWriteHandler('create_presentation')
+    const res = await handler({ title: `Cmd Slides ${Date.now()}` })
+    expect(typeof res?.presentationId === 'string').toBe(true)
+  }, 60000)
+
+  it('append_text_to_title_of_slide_index appends to title', async () => {
+    if (!ctx.presentationId)
+      return expect(true).toBe(true)
+    const handler = buildWriteHandler('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 = buildWriteHandler('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)
+    const handler = buildWriteHandler('style_text_first_match')
+    const res = await handler({ presentationId: ctx.presentationId, findText: 'the', 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)
+    const handler = buildWriteHandler('insert_shape_after_first_match')
+    const res = await handler({ presentationId: ctx.presentationId, findText: 'the', 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 || !env.GSLIDES_TEST_IMAGE_URI)
+      return expect(true).toBe(true)
+    const handler = buildWriteHandler('insert_image_after_first_match')
+    const res = await handler({ presentationId: ctx.presentationId, findText: 'the', uri: env.GSLIDES_TEST_IMAGE_URI })
+    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)
+    const handler = buildWriteHandler('create_slide_after_first_match')
+    const res = await handler({ presentationId: ctx.presentationId, findText: 'the', 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 = buildWriteHandler('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)
+})