@commandable/integration-data 0.0.1 → 0.0.5

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

@@ -1,69 +1,62 @@
-import { beforeAll, describe, expect, it } from 'vitest'
-import { IntegrationProxy } from '../../../src/integrations/proxy.js'
-import { loadIntegrationTools } from '../../../src/integrations/dataLoader.js'
+import { afterAll, beforeAll, describe, expect, it } from 'vitest'
+import { createCredentialStore, createIntegrationNode, createProxy, createToolbox, hasEnv, safeCleanup } from '../../__tests__/liveHarness.js'
 
-// LIVE Google Sheets write tests using managed OAuth
+// LIVE Google Sheets write tests using credentials
 // Required env vars:
-// - COMMANDABLE_MANAGED_OAUTH_BASE_URL
-// - COMMANDABLE_MANAGED_OAUTH_SECRET_KEY
-// - GSHEETS_TEST_CONNECTION_ID (managed OAuth connection for provider 'google-sheet')
-// - GSHEETS_TEST_SPREADSHEET_ID (target spreadsheet ID with write access)
+// - Either GOOGLE_TOKEN, OR GOOGLE_SERVICE_ACCOUNT_JSON
+// - GOOGLE_SHEETS_TEST_SPREADSHEET_ID (target spreadsheet ID with write access)
 
 interface Ctx {
   spreadsheetId?: string
+  folderId?: string
+  destSpreadsheetId?: 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',
-  'GSHEETS_TEST_CONNECTION_ID',
-  'GSHEETS_TEST_SPREADSHEET_ID',
-)
+const suite = (hasEnv('GOOGLE_TOKEN') || hasEnv('GOOGLE_SERVICE_ACCOUNT_JSON'))
   ? describe
   : describe.skip
 
 suite('google-sheet write handlers (live)', () => {
   const ctx: Ctx = {}
-  let buildWriteHandler: (name: string) => ((input: any) => Promise<any>)
+  let sheets: ReturnType<typeof createToolbox>
+  let drive: ReturnType<typeof createToolbox>
   let sheetTitle: string | undefined
 
   beforeAll(async () => {
-    const { COMMANDABLE_MANAGED_OAUTH_BASE_URL, COMMANDABLE_MANAGED_OAUTH_SECRET_KEY, GSHEETS_TEST_CONNECTION_ID, GSHEETS_TEST_SPREADSHEET_ID } = env
-
-    const proxy = new IntegrationProxy({
-      managedOAuthBaseUrl: COMMANDABLE_MANAGED_OAUTH_BASE_URL,
-      managedOAuthSecretKey: COMMANDABLE_MANAGED_OAUTH_SECRET_KEY,
+    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)
+    sheets = createToolbox('google-sheet', proxy, createIntegrationNode('google-sheet', { label: 'Google Sheets', credentialId: 'google-sheet-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 Sheets Write ${Date.now()}` })
+    ctx.folderId = folder?.id
+    expect(ctx.folderId).toBeTruthy()
+
+    const created = await drive.write('create_file')({
+      name: `CmdTest Sheet ${Date.now()}`,
+      mimeType: 'application/vnd.google-apps.spreadsheet',
+      parentId: ctx.folderId,
     })
-    const integrationNode = { id: 'node-gsheets', type: 'google-sheet', label: 'Google Sheets', connectionId: GSHEETS_TEST_CONNECTION_ID } as any
-
-    const tools = loadIntegrationTools('google-sheet')
-    expect(tools).toBeTruthy()
+    ctx.spreadsheetId = created?.id
+    expect(ctx.spreadsheetId).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.spreadsheetId = GSHEETS_TEST_SPREADSHEET_ID
+    const createdDest = await drive.write('create_file')({
+      name: `CmdTest Sheet Dest ${Date.now()}`,
+      mimeType: 'application/vnd.google-apps.spreadsheet',
+      parentId: ctx.folderId,
+    })
+    ctx.destSpreadsheetId = createdDest?.id
+    expect(ctx.destSpreadsheetId).toBeTruthy()
 
     // Try to detect a default sheet title
     if (ctx.spreadsheetId) {
-      const proxy2 = new IntegrationProxy({
-        managedOAuthBaseUrl: COMMANDABLE_MANAGED_OAUTH_BASE_URL,
-        managedOAuthSecretKey: COMMANDABLE_MANAGED_OAUTH_SECRET_KEY,
-      })
-      const node2 = { id: 'node-gsheets', type: 'google-sheet', label: 'Google Sheets', connectionId: GSHEETS_TEST_CONNECTION_ID } as any
-      const tools2 = loadIntegrationTools('google-sheet')!
-      const tool = tools2.read.find(t => t.name === 'get_spreadsheet')!
-      const build = new Function('integration', `return (${tool.handlerCode});`)
-      const integration = { fetch: (path: string, init?: RequestInit) => proxy2.call(node2, path, init) }
       try {
-        const get_spreadsheet = build(integration) as (input: any) => Promise<any>
+        const get_spreadsheet = sheets.read('get_spreadsheet')
         const meta = await get_spreadsheet({ spreadsheetId: ctx.spreadsheetId })
         sheetTitle = meta?.sheets?.[0]?.properties?.title
       }
@@ -71,16 +64,27 @@ suite('google-sheet write handlers (live)', () => {
     }
   }, 60000)
 
+  afterAll(async () => {
+    await safeCleanup(async () => {
+      const delete_file = drive.write('delete_file')
+      if (ctx.spreadsheetId)
+        await delete_file({ fileId: ctx.spreadsheetId })
+      if (ctx.destSpreadsheetId)
+        await delete_file({ fileId: ctx.destSpreadsheetId })
+    })
+    await safeCleanup(async () => ctx.folderId ? drive.write('delete_file')({ fileId: ctx.folderId }) : Promise.resolve())
+  }, 60_000)
+
   it('append_values appends then clear_values clears', async () => {
     if (!ctx.spreadsheetId)
       return expect(true).toBe(true)
 
-    const append_values = buildWriteHandler('append_values')
+    const append_values = sheets.write('append_values')
     const aTitle = sheetTitle || 'Sheet1'
     const appendRes = await append_values({ spreadsheetId: ctx.spreadsheetId, range: `${aTitle}!A1`, values: [[`CmdTest ${Date.now()}`]], valueInputOption: 'USER_ENTERED' })
     expect(appendRes?.updates || appendRes?.tableRange || appendRes?.spreadsheetId).toBeTruthy()
 
-    const clear_values = buildWriteHandler('clear_values')
+    const clear_values = sheets.write('clear_values')
     const clearRes = await clear_values({ spreadsheetId: ctx.spreadsheetId, range: `${aTitle}!A1:A10` })
     expect(clearRes?.clearedRange || clearRes?.spreadsheetId).toBeTruthy()
   }, 60000)
@@ -89,7 +93,7 @@ suite('google-sheet write handlers (live)', () => {
     if (!ctx.spreadsheetId)
       return expect(true).toBe(true)
     const aTitle = sheetTitle || 'Sheet1'
-    const update_values = buildWriteHandler('update_values')
+    const update_values = sheets.write('update_values')
     const res = await update_values({ spreadsheetId: ctx.spreadsheetId, range: `${aTitle}!B1:B1`, values: [[`CmdTestU ${Date.now()}`]], valueInputOption: 'USER_ENTERED' })
     expect(res?.updatedRange || res?.spreadsheetId).toBeTruthy()
   }, 60000)
@@ -98,7 +102,7 @@ suite('google-sheet write handlers (live)', () => {
     if (!ctx.spreadsheetId)
       return expect(true).toBe(true)
     const aTitle = sheetTitle || 'Sheet1'
-    const batch_update_values = buildWriteHandler('batch_update_values')
+    const batch_update_values = sheets.write('batch_update_values')
     const res = await batch_update_values({ spreadsheetId: ctx.spreadsheetId, data: [
       { range: `${aTitle}!C1:C1`, values: [[`CmdTestB1 ${Date.now()}`]] },
       { range: `${aTitle}!C2:C2`, values: [[`CmdTestB2 ${Date.now()}`]] },
@@ -110,7 +114,7 @@ suite('google-sheet write handlers (live)', () => {
     if (!ctx.spreadsheetId)
       return expect(true).toBe(true)
     const aTitle = sheetTitle || 'Sheet1'
-    const batch_update_values_by_data_filter = buildWriteHandler('batch_update_values_by_data_filter')
+    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' })
@@ -121,7 +125,7 @@ suite('google-sheet write handlers (live)', () => {
     if (!ctx.spreadsheetId)
       return expect(true).toBe(true)
     const aTitle = sheetTitle || 'Sheet1'
-    const batch_clear_values = buildWriteHandler('batch_clear_values')
+    const batch_clear_values = sheets.write('batch_clear_values')
     const res = await batch_clear_values({ spreadsheetId: ctx.spreadsheetId, ranges: [`${aTitle}!A1:A2`, `${aTitle}!B1:B2`] })
     expect(Boolean(res?.spreadsheetId) || Array.isArray(res?.clearedRanges)).toBe(true)
   }, 60000)
@@ -130,7 +134,7 @@ suite('google-sheet write handlers (live)', () => {
     if (!ctx.spreadsheetId)
       return expect(true).toBe(true)
     const aTitle = sheetTitle || 'Sheet1'
-    const batch_clear_values_by_data_filter = buildWriteHandler('batch_clear_values_by_data_filter')
+    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)
@@ -139,7 +143,7 @@ suite('google-sheet write handlers (live)', () => {
     if (!ctx.spreadsheetId)
       return expect(true).toBe(true)
     const aTitle = sheetTitle || 'Sheet1'
-    const batch_update = buildWriteHandler('batch_update')
+    const batch_update = sheets.write('batch_update')
     const res = await batch_update({ spreadsheetId: ctx.spreadsheetId, requests: [
       { findReplace: { find: '___unlikely___', replacement: '___unlikely___', matchCase: true, searchByRegex: false, includeFormulas: false, range: { sheetId: 0 } } },
     ], includeSpreadsheetInResponse: false })
@@ -147,12 +151,12 @@ suite('google-sheet write handlers (live)', () => {
   }, 60000)
 
   it('copy_to_spreadsheet copies a sheet when destination provided', async () => {
-    if (!ctx.spreadsheetId || !env.GSHEETS_TEST_DEST_SPREADSHEET_ID)
+    if (!ctx.spreadsheetId || !ctx.destSpreadsheetId)
       return expect(true).toBe(true)
-    const copy_to_spreadsheet = buildWriteHandler('copy_to_spreadsheet')
+    const copy_to_spreadsheet = sheets.write('copy_to_spreadsheet')
     // Attempt to copy sheet with id 0 (typical for first sheet). If it fails, skip.
     try {
-      const res = await copy_to_spreadsheet({ spreadsheetId: ctx.spreadsheetId, sheetId: 0, destinationSpreadsheetId: env.GSHEETS_TEST_DEST_SPREADSHEET_ID })
+      const res = await copy_to_spreadsheet({ spreadsheetId: ctx.spreadsheetId, sheetId: 0, destinationSpreadsheetId: ctx.destSpreadsheetId })
       expect(res?.sheetId !== undefined || res?.spreadsheetId).toBeTruthy()
     }
     catch {
@@ -160,12 +164,10 @@ suite('google-sheet write handlers (live)', () => {
     }
   }, 60000)
 
-  it('create_spreadsheet creates a spreadsheet when allowed', async () => {
-    if (!env.GSHEETS_ALLOW_CREATE)
-      return expect(true).toBe(true)
-    const create_spreadsheet = buildWriteHandler('create_spreadsheet')
-    const res = await create_spreadsheet({ properties: { title: `CmdTest ${Date.now()}` } })
-    expect(res?.spreadsheetId).toBeTruthy()
-    // Note: No delete here to avoid Drive scope; test leaves an artifact when enabled.
+  it('create_spreadsheet creates a spreadsheet (self-cleaning)', async () => {
+    const created = await sheets.write('create_spreadsheet')({ properties: { title: `CmdTest Sheet Tool ${Date.now()}` } })
+    const id = created?.spreadsheetId
+    expect(typeof id).toBe('string')
+    await safeCleanup(async () => id ? drive.write('delete_file')({ fileId: id }) : Promise.resolve())
   }, 60000)
 })

package/integrations/google-sheet/credentials.json

@@ -1,36 +1,57 @@
 {
-  "schema": {
-    "type": "object",
-    "properties": {
-      "token": {
-        "type": "string",
-        "title": "OAuth Access Token (optional)",
-        "description": "Google OAuth access token to use as a Bearer token (typically short-lived)."
+  "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 spreadsheets.",
+            "items": { "type": "string" }
+          }
+        },
+        "required": ["serviceAccountJson"],
+        "additionalProperties": false
       },
-      "serviceAccountJson": {
-        "type": "string",
-        "title": "Service Account JSON (recommended)",
-        "description": "Full service account key JSON (contents of the downloaded JSON file)."
+      "injection": {
+        "headers": {
+          "Authorization": "Bearer {{token}}"
+        }
       },
-      "subject": {
-        "type": "string",
-        "title": "Subject / impersonated user (optional)",
-        "description": "Optional user email to impersonate when using Google Workspace domain-wide delegation."
+      "preprocess": "google_service_account"
+    },
+    "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 spreadsheets scope."
+          }
+        },
+        "required": ["token"],
+        "additionalProperties": false
       },
-      "scopes": {
-        "type": "array",
-        "title": "OAuth scopes (optional)",
-        "description": "Optional override for OAuth scopes.",
-        "items": { "type": "string" }
+      "injection": {
+        "headers": {
+          "Authorization": "Bearer {{token}}"
+        }
       }
-    },
-    "required": [],
-    "additionalProperties": false
-  },
-  "injection": {
-    "headers": {
-      "Authorization": "Bearer {{token}}"
     }
-  }
+  },
+  "default": "service_account"
 }
-

package/integrations/google-sheet/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 scope: `https://www.googleapis.com/auth/spreadsheets`
+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-sheet/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 Sheets 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 spreadsheets 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/__tests__/get_handlers.test.ts

@@ -1,68 +1,70 @@
-import { beforeAll, describe, expect, it } from 'vitest'
-import { IntegrationProxy } from '../../../src/integrations/proxy.js'
-import { loadIntegrationTools } from '../../../src/integrations/dataLoader.js'
+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 managed OAuth
+// LIVE Google Slides read tests using credentials
 // 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)
+// - Either GOOGLE_TOKEN, OR GOOGLE_SERVICE_ACCOUNT_JSON
 
-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',
-)
+const suite = (hasEnv('GOOGLE_TOKEN') || hasEnv('GOOGLE_SERVICE_ACCOUNT_JSON'))
   ? describe
   : describe.skip
 
 suite('google-slides read handlers (live)', () => {
-  let buildReadHandler: (name: string) => ((input: any) => Promise<any>)
+  let slides: ReturnType<typeof createToolbox>
+  let drive: ReturnType<typeof createToolbox>
+  let folderId: string | undefined
+  let presentationId: string | undefined
 
   beforeAll(async () => {
-    const { COMMANDABLE_MANAGED_OAUTH_BASE_URL, COMMANDABLE_MANAGED_OAUTH_SECRET_KEY, GSLIDES_TEST_CONNECTION_ID } = env
+    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 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
+    // 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 tools = loadIntegrationTools('google-slides')
-    expect(tools).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)
 
-    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>
-    }
+  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('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 handler = slides.read('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 getPresentation = slides.read('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 handler = slides.read('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

@@ -1,34 +1,9 @@
-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, '\\$&')
-}
+import { getMissingToolUsages } from '../../__tests__/usageParity.js'
 
 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)
-    }
-
+  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([])
   })
 })