@mcp-z/mcp-sheets 2.3.2 → 2.4.0

package/README.md

@@ -7,6 +7,7 @@ Requires Node.js >=20. The examples use `npx`, included with npm, to run this se
 ## Common uses
 
 - Find spreadsheets and sheets
+- Inspect workbook structure and metadata in selected cells
 - Append and update data
 - Apply formatting, validation, and charts
 
@@ -53,7 +54,7 @@ it sends no `initialize` handshake and carries no session id.
 
 1. Go to [Google Cloud Console](https://console.cloud.google.com/).
 2. Create or select a project.
-3. Enable the Google Sheets API.
+3. Enable the Google Sheets API and Google Drive API.
 4. Create OAuth 2.0 credentials (Desktop app).
 5. Copy the Client ID and Client Secret.
 6. Select the credential type that matches your transport:
@@ -176,32 +177,36 @@ npx -y @mcp-z/cli call-tool sheets spreadsheet-find '{"spreadsheetRef":"Quarterl
 ## Tools
 
 1. cells-format
-2. chart-create
-3. columns-get
-4. columns-update
-5. csv-get-columns
-6. dimensions-batch-update
-7. dimensions-move
-8. rows-append
-9. rows-csv-append
-10. rows-get
-11. sheet-copy
-12. sheet-copy-to
-13. sheet-create
-14. sheet-delete
-15. sheet-find
-16. sheet-rename
-17. spreadsheet-copy
-18. spreadsheet-create
-19. spreadsheet-find
-20. spreadsheet-rename
-21. validation-set
-22. values-batch-update
-23. values-clear
-24. values-csv-update
-25. values-markdown-update
-26. values-replace
-27. values-search
+2. cells-metadata-get
+3. chart-create
+4. columns-get
+5. columns-update
+6. csv-get-columns
+7. dimensions-batch-update
+8. dimensions-move
+9. rows-append
+10. rows-csv-append
+11. rows-get
+12. sheet-copy
+13. sheet-copy-to
+14. sheet-create
+15. sheet-delete
+16. sheet-find
+17. sheet-rename
+18. spreadsheet-copy
+19. spreadsheet-create
+20. spreadsheet-find
+21. spreadsheet-metadata-get
+22. spreadsheet-rename
+23. validation-set
+24. values-batch-update
+25. values-clear
+26. values-csv-update
+27. values-markdown-update
+28. values-replace
+29. values-search
+
+See [metadata usage](https://github.com/mcp-z/mcp-sheets/blob/master/usage/metadata.md) for workbook inspection and bounded cell reads.
 
 ## Resources
 

package/dist/cjs/constants.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/constants.ts"],"sourcesContent":["/**\n * Sheets MCP Server Constants\n *\n * These scopes are required for Google Sheets and Drive functionality and are hardcoded\n * rather than externally configured since this server knows its own requirements.\n */\n\n// Google OAuth scopes required for Sheets and Drive operations\nexport const GOOGLE_SCOPE = 'openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive';\n"],"names":["GOOGLE_SCOPE"],"mappings":"AAAA;;;;;CAKC,GAED,+DAA+D;;;;;+BAClDA;;;eAAAA;;;AAAN,IAAMA,eAAe"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/constants.ts"],"sourcesContent":["/**\n * Sheets MCP Server Constants\n *\n * These scopes are required for Google Sheets and Drive functionality and are hardcoded\n * rather than externally configured since this server knows its own requirements.\n */\n\n// Google OAuth scopes required for Sheets and Drive operations\nexport const GOOGLE_SCOPE = 'openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive';\n"],"names":["GOOGLE_SCOPE"],"mappings":"AAAA;;;;;CAKC,GAED,+DAA+D;;;;;+BAClDA;;;eAAAA;;;AAAN,IAAMA,eAAe"}

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/index.ts"],"sourcesContent":["import { handleVersionHelp } from './setup/version-help.ts';\nimport type { ServerConfig } from './types.ts';\n\nexport { GOOGLE_SCOPE } from './constants.ts';\nexport * as mcp from './mcp/index.ts';\nexport * as schemas from './schemas/index.ts';\nexport * as setup from './setup/index.ts';\nexport * from './types.ts';\n\nexport async function startServer(config: ServerConfig): Promise<void> {\n  // createHTTPServer/createStdioServer pull in @mcp-z/server and every mcp/tools/*.ts\n  // (googleapis included); deferred so a --version/--help run never reaches them.\n  const { createHTTPServer } = await import('./setup/http.ts');\n  const { createStdioServer } = await import('./setup/stdio.ts');\n  const { logger, close } = config.transport.type === 'stdio' ? await createStdioServer(config) : await createHTTPServer(config);\n\n  process.on('SIGINT', async () => {\n    await close();\n    process.exit(0);\n  });\n\n  logger.info(`Server started with ${config.transport.type} transport`);\n  await new Promise(() => {});\n}\n\nexport default async function main(): Promise<void> {\n  // Check for help/version flags FIRST, before config parsing\n  const versionHelpResult = handleVersionHelp(process.argv);\n  if (versionHelpResult.handled) {\n    console.log(versionHelpResult.output);\n    process.exit(0);\n  }\n\n  // Only parse config if no help/version flags. config.ts's own heavy imports (@mcp-z/oauth-google,\n  // @mcp-z/server) are deferred internally, so this static-looking call stays cheap until here.\n  const { createConfig } = await import('./setup/config.ts');\n  const config = createConfig();\n  await startServer(config);\n}\n\nif (process.argv[1] === new URL(import.meta.url).pathname) {\n  main();\n}\n"],"names":["GOOGLE_SCOPE","main","mcp","schemas","setup","startServer","config","createHTTPServer","createStdioServer","logger","close","transport","type","process","on","exit","info","Promise","versionHelpResult","createConfig","handleVersionHelp","argv","handled","console","log","output","URL","pathname"],"mappings":";;;;;;;;;;;QAGSA;eAAAA,yBAAY;;QAsBrB;eAA8BC;;QArBlBC;;;QACAC;;;QACAC;;;QAGUC;eAAAA;;;6BATY;2BAGL;+DACR;gEACI;gEACF;qBACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEP,SAAeA,YAAYC,MAAoB;;YAG5CC,kBACAC,mBACkBF,MAAlBG,QAAQC;;;;oBAFa;;wBAAM;2EAAA,QAAO;;;;oBAAlCH,mBAAqB,cAArBA;oBACsB;;wBAAM;2EAAA,QAAO;;;;oBAAnCC,oBAAsB,cAAtBA;yBACkBF,CAAAA,OAAOK,SAAS,CAACC,IAAI,KAAK,OAAM,GAAhCN;;;;oBAAoC;;wBAAME,kBAAkBF;;;2BAAxB;;;;;;oBAAkC;;wBAAMC,iBAAiBD;;;2BAAvB;;;oBAAtEA,aAAlBG,SAAkBH,KAAlBG,QAAQC,QAAUJ,KAAVI;oBAEhBG,QAAQC,EAAE,CAAC,UAAU;;;;;wCACnB;;4CAAMJ;;;wCAAN;wCACAG,QAAQE,IAAI,CAAC;;;;;;wBACf;;oBAEAN,OAAOO,IAAI,CAAC,AAAC,uBAA4C,OAAtBV,OAAOK,SAAS,CAACC,IAAI,EAAC;oBACzD;;wBAAM,IAAIK,QAAQ,YAAO;;;oBAAzB;;;;;;IACF;;AAEe,SAAehB;;YAEtBiB,mBAQEC,cACFb;;;;oBAVN,4DAA4D;oBACtDY,oBAAoBE,IAAAA,gCAAiB,EAACP,QAAQQ,IAAI;oBACxD,IAAIH,kBAAkBI,OAAO,EAAE;wBAC7BC,QAAQC,GAAG,CAACN,kBAAkBO,MAAM;wBACpCZ,QAAQE,IAAI,CAAC;oBACf;oBAIyB;;wBAAM;2EAAA,QAAO;;;;oBAA9BI,eAAiB,cAAjBA;oBACFb,SAASa;oBACf;;wBAAMd,YAAYC;;;oBAAlB;;;;;;IACF;;AAEA,IAAIO,QAAQQ,IAAI,CAAC,EAAE,KAAK,IAAIK,IAAI,qDAAiBC,QAAQ,EAAE;IACzD1B;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/index.ts"],"sourcesContent":["import { handleVersionHelp } from './setup/version-help.ts';\nimport type { ServerConfig } from './types.ts';\n\nexport { GOOGLE_SCOPE } from './constants.ts';\nexport * as mcp from './mcp/index.ts';\nexport * as schemas from './schemas/index.ts';\nexport * as setup from './setup/index.ts';\nexport * from './types.ts';\n\nexport async function startServer(config: ServerConfig): Promise<void> {\n  // createHTTPServer/createStdioServer pull in @mcp-z/server and every mcp/tools/*.ts\n  // (googleapis included); deferred so a --version/--help run never reaches them.\n  const { createHTTPServer } = await import('./setup/http.ts');\n  const { createStdioServer } = await import('./setup/stdio.ts');\n  const { logger, close } = config.transport.type === 'stdio' ? await createStdioServer(config) : await createHTTPServer(config);\n\n  process.on('SIGINT', async () => {\n    await close();\n    process.exit(0);\n  });\n\n  logger.info(`Server started with ${config.transport.type} transport`);\n  await new Promise(() => {});\n}\n\nexport default async function main(): Promise<void> {\n  // Check for help/version flags FIRST, before config parsing\n  const versionHelpResult = handleVersionHelp(process.argv);\n  if (versionHelpResult.handled) {\n    console.log(versionHelpResult.output);\n    process.exit(0);\n  }\n\n  // Only parse config if no help/version flags. config.ts's own heavy imports (@mcp-z/oauth-google,\n  // @mcp-z/server) are deferred internally, so this static-looking call stays cheap until here.\n  const { createConfig } = await import('./setup/config.ts');\n  const config = createConfig();\n  await startServer(config);\n}\n\nif (process.argv[1] === new URL(import.meta.url).pathname) {\n  main();\n}\n"],"names":["GOOGLE_SCOPE","main","mcp","schemas","setup","startServer","config","createHTTPServer","createStdioServer","logger","close","transport","type","process","on","exit","info","Promise","versionHelpResult","createConfig","handleVersionHelp","argv","handled","console","log","output","URL","pathname"],"mappings":";;;;;;;;;;;QAGSA;eAAAA,yBAAY;;QAsBrB;eAA8BC;;QArBlBC;;;QACAC;;;QACAC;;;QAGUC;eAAAA;;;6BATY;2BAGL;+DACR;gEACI;gEACF;qBACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEP,SAAeA,YAAYC,MAAoB;;YAG5CC,kBACAC,mBACkBF,MAAlBG,QAAQC;;;;oBAFa;;wBAAM;2EAAA,QAAO;;;;oBAAlCH,mBAAqB,cAArBA;oBACsB;;wBAAM;2EAAA,QAAO;;;;oBAAnCC,oBAAsB,cAAtBA;yBACkBF,CAAAA,OAAOK,SAAS,CAACC,IAAI,KAAK,OAAM,GAAhCN;;;;oBAAoC;;wBAAME,kBAAkBF;;;2BAAxB;;;;;;oBAAkC;;wBAAMC,iBAAiBD;;;2BAAvB;;;oBAAtEA,aAAlBG,SAAkBH,KAAlBG,QAAQC,QAAUJ,KAAVI;oBAEhBG,QAAQC,EAAE,CAAC,UAAU;;;;;wCACnB;;4CAAMJ;;;wCAAN;wCACAG,QAAQE,IAAI,CAAC;;;;;;wBACf;;oBAEAN,OAAOO,IAAI,CAAC,AAAC,uBAA4C,OAAtBV,OAAOK,SAAS,CAACC,IAAI,EAAC;oBACzD;;wBAAM,IAAIK,QAAQ,YAAO;;;oBAAzB;;;;;;IACF;;AAEe,SAAehB;;YAEtBiB,mBAQEC,cACFb;;;;oBAVN,4DAA4D;oBACtDY,oBAAoBE,IAAAA,gCAAiB,EAACP,QAAQQ,IAAI;oBACxD,IAAIH,kBAAkBI,OAAO,EAAE;wBAC7BC,QAAQC,GAAG,CAACN,kBAAkBO,MAAM;wBACpCZ,QAAQE,IAAI,CAAC;oBACf;oBAIyB;;wBAAM;2EAAA,QAAO;;;;oBAA9BI,eAAiB,cAAjBA;oBACFb,SAASa;oBACf;;wBAAMd,YAAYC;;;oBAAlB;;;;;;IACF;;AAEA,IAAIO,QAAQQ,IAAI,CAAC,EAAE,KAAK,IAAIK,IAAI,qDAAiBC,QAAQ,EAAE;IACzD1B;AACF"}

package/dist/cjs/lib/create-store.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/lib/create-store.ts"],"sourcesContent":["import type Keyv from 'keyv';\nimport keyvRegistry from 'keyv-registry';\n\n// keyv-file is a direct dependency so the default file:// URIs resolve; keyv-registry\n// loads adapters with require() rather than depending on any of them itself.\n\nexport default async function createStore<T>(uri: string): Promise<Keyv<T>> {\n  const store = await keyvRegistry<T>(uri);\n  if (!store) throw new Error(`Failed to create store for URI: ${uri}`);\n  return store;\n}\n"],"names":["createStore","uri","store","keyvRegistry","Error"],"mappings":";;;;+BAGA,sFAAsF;AACtF,6EAA6E;AAE7E;;;eAA8BA;;;mEALL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKV,SAAeA,YAAeC,GAAW;;YAChDC;;;;oBAAQ;;wBAAMC,IAAAA,qBAAY,EAAIF;;;oBAA9BC,QAAQ;oBACd,IAAI,CAACA,OAAO,MAAM,IAAIE,MAAM,AAAC,mCAAsC,OAAJH;oBAC/D;;wBAAOC;;;;IACT"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/lib/create-store.ts"],"sourcesContent":["import type Keyv from 'keyv';\nimport keyvRegistry from 'keyv-registry';\n\n// keyv-file is a direct dependency so the default file:// URIs resolve; keyv-registry\n// loads adapters with require() rather than depending on any of them itself.\n\nexport default async function createStore<T>(uri: string): Promise<Keyv<T>> {\n  const store = await keyvRegistry<T>(uri);\n  if (!store) throw new Error(`Failed to create store for URI: ${uri}`);\n  return store;\n}\n"],"names":["createStore","uri","store","keyvRegistry","Error"],"mappings":";;;;+BAGA,sFAAsF;AACtF,6EAA6E;AAE7E;;;eAA8BA;;;mEALL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKV,SAAeA,YAAeC,GAAW;;YAChDC;;;;oBAAQ;;wBAAMC,IAAAA,qBAAY,EAAIF;;;oBAA9BC,QAAQ;oBACd,IAAI,CAACA,OAAO,MAAM,IAAIE,MAAM,AAAC,mCAAsC,OAAJH;oBAC/D;;wBAAOC;;;;IACT"}

package/dist/cjs/lib/google-auth.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/lib/google-auth.ts"],"sourcesContent":["import { auth as googleAuthPlus } from '@googleapis/sheets';\nimport { attachTokenProvider, type GoogleAuthProvider } from '@mcp-z/oauth-google';\n\n/**\n * A Google API client bound to this request's token provider.\n *\n * `@mcp-z/oauth-google` mints tokens and depends on no Google SDK, so the client\n * is built here, from this package's own `googleapis`. That keeps one copy of\n * `google-auth-library` in the tree by construction rather than by matching pins.\n */\nexport function googleAuth(auth: GoogleAuthProvider) {\n  return attachTokenProvider(new googleAuthPlus.OAuth2(), auth);\n}\n"],"names":["googleAuth","auth","attachTokenProvider","googleAuthPlus","OAuth2"],"mappings":";;;;+BAUgBA;;;eAAAA;;;sBAVuB;2BACsB;AAStD,SAASA,WAAWC,IAAwB;IACjD,OAAOC,IAAAA,gCAAmB,EAAC,IAAIC,YAAc,CAACC,MAAM,IAAIH;AAC1D"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/lib/google-auth.ts"],"sourcesContent":["import { auth as googleAuthPlus } from '@googleapis/sheets';\nimport { attachTokenProvider, type GoogleAuthProvider } from '@mcp-z/oauth-google';\n\n/**\n * A Google API client bound to this request's token provider.\n *\n * `@mcp-z/oauth-google` mints tokens and depends on no Google SDK, so the client\n * is built here, from this package's own `googleapis`. That keeps one copy of\n * `google-auth-library` in the tree by construction rather than by matching pins.\n */\nexport function googleAuth(auth: GoogleAuthProvider) {\n  return attachTokenProvider(new googleAuthPlus.OAuth2(), auth);\n}\n"],"names":["googleAuth","auth","attachTokenProvider","googleAuthPlus","OAuth2"],"mappings":";;;;+BAUgBA;;;eAAAA;;;sBAVuB;2BACsB;AAStD,SAASA,WAAWC,IAAwB;IACjD,OAAOC,IAAAA,gCAAmB,EAAC,IAAIC,YAAc,CAACC,MAAM,IAAIH;AAC1D"}

package/dist/cjs/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/index.ts"],"sourcesContent":["export * as promptFactories from './prompts/index.ts';\nexport * as resourceFactories from './resources/index.ts';\nexport * as toolFactories from './tools/index.ts';\n"],"names":["promptFactories","resourceFactories","toolFactories"],"mappings":";;;;;;;;;;;QAAYA;;;QACAC;;;QACAC;;;;+DAFqB;gEACE;gEACJ"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/index.ts"],"sourcesContent":["export * as promptFactories from './prompts/index.ts';\nexport * as resourceFactories from './resources/index.ts';\nexport * as toolFactories from './tools/index.ts';\n"],"names":["promptFactories","resourceFactories","toolFactories"],"mappings":";;;;;;;;;;;QAAYA;;;QACAC;;;QACAC;;;;+DAFqB;gEACE;gEACJ"}

package/dist/cjs/mcp/prompts/a1-notation.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/prompts/a1-notation.ts"],"sourcesContent":["import type { PromptModule, ServerContext } from '@mcp-z/server';\n\nexport default function createPrompt() {\n  const config = {\n    description: 'Reference guide for Google Sheets A1 notation syntax',\n  };\n\n  const handler = async (_args: { [x: string]: unknown }, _extra: ServerContext) => {\n    return {\n      messages: [\n        {\n          role: 'user' as const,\n          content: {\n            type: 'text' as const,\n            text: `# Google Sheets A1 Notation Reference\n\nA1 notation identifies cells and ranges in Google Sheets.\n\n## Cell References\n- \\`B5\\` - Single cell at column B, row 5\n- \\`A1\\` - Top-left cell\n\n## Range References\n- \\`A1:D10\\` - Rectangle from A1 to D10\n- \\`A5:D5\\` - Single row (columns A-D of row 5)\n- \\`B1:B10\\` - Single column segment (rows 1-10 of column B)\n\n## Full Row/Column References\n- \\`5:5\\` - Entire row 5\n- \\`B:B\\` - Entire column B\n- \\`A:D\\` - Columns A through D (all rows)\n- \\`1:10\\` - Rows 1 through 10 (all columns)\n\n## Common Patterns\n| Goal | Notation |\n|------|----------|\n| Get one cell | \\`B5\\` |\n| Get a row | \\`A5:Z5\\` or \\`5:5\\` |\n| Get a column | \\`B:B\\` or \\`B1:B1000\\` |\n| Get a data table | \\`A1:F100\\` |\n| Get headers | \\`1:1\\` or \\`A1:Z1\\` |`,\n          },\n        },\n      ],\n    };\n  };\n\n  return {\n    name: 'a1-notation',\n    config,\n    handler,\n  } satisfies PromptModule;\n}\n"],"names":["createPrompt","config","description","handler","_args","_extra","messages","role","content","type","text","name"],"mappings":";;;;+BAEA;;;eAAwBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAT,SAASA;IACtB,IAAMC,SAAS;QACbC,aAAa;IACf;IAEA,IAAMC,UAAU,iBAAOC,OAAiCC;;;gBACtD;;oBAAO;wBACLC,QAAQ;4BACN;gCACEC,MAAM;gCACNC,SAAS;oCACPC,MAAM;oCACNC,MAAM;gCA2BR;4BACF;;oBAEJ;;;QACF;;IAEA,OAAO;QACLC,MAAM;QACNV,QAAAA;QACAE,SAAAA;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/prompts/a1-notation.ts"],"sourcesContent":["import type { PromptModule, ServerContext } from '@mcp-z/server';\n\nexport default function createPrompt() {\n  const config = {\n    description: 'Reference guide for Google Sheets A1 notation syntax',\n  };\n\n  const handler = async (_args: { [x: string]: unknown }, _extra: ServerContext) => {\n    return {\n      messages: [\n        {\n          role: 'user' as const,\n          content: {\n            type: 'text' as const,\n            text: `# Google Sheets A1 Notation Reference\n\nA1 notation identifies cells and ranges in Google Sheets.\n\n## Cell References\n- \\`B5\\` - Single cell at column B, row 5\n- \\`A1\\` - Top-left cell\n\n## Range References\n- \\`A1:D10\\` - Rectangle from A1 to D10\n- \\`A5:D5\\` - Single row (columns A-D of row 5)\n- \\`B1:B10\\` - Single column segment (rows 1-10 of column B)\n\n## Full Row/Column References\n- \\`5:5\\` - Entire row 5\n- \\`B:B\\` - Entire column B\n- \\`A:D\\` - Columns A through D (all rows)\n- \\`1:10\\` - Rows 1 through 10 (all columns)\n\n## Common Patterns\n| Goal | Notation |\n|------|----------|\n| Get one cell | \\`B5\\` |\n| Get a row | \\`A5:Z5\\` or \\`5:5\\` |\n| Get a column | \\`B:B\\` or \\`B1:B1000\\` |\n| Get a data table | \\`A1:F100\\` |\n| Get headers | \\`1:1\\` or \\`A1:Z1\\` |`,\n          },\n        },\n      ],\n    };\n  };\n\n  return {\n    name: 'a1-notation',\n    config,\n    handler,\n  } satisfies PromptModule;\n}\n"],"names":["createPrompt","config","description","handler","_args","_extra","messages","role","content","type","text","name"],"mappings":";;;;+BAEA;;;eAAwBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAT,SAASA;IACtB,IAAMC,SAAS;QACbC,aAAa;IACf;IAEA,IAAMC,UAAU,iBAAOC,OAAiCC;;;gBACtD;;oBAAO;wBACLC,QAAQ;4BACN;gCACEC,MAAM;gCACNC,SAAS;oCACPC,MAAM;oCACNC,MAAM;gCA2BR;4BACF;;oBAEJ;;;QACF;;IAEA,OAAO;QACLC,MAAM;QACNV,QAAAA;QACAE,SAAAA;IACF;AACF"}

package/dist/cjs/mcp/prompts/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/prompts/index.ts"],"sourcesContent":["export { default as a1Notation } from './a1-notation.ts';\n"],"names":["a1Notation"],"mappings":";;;;+BAAoBA;;;eAAAA,qBAAU;;;mEAAQ"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/prompts/index.ts"],"sourcesContent":["export { default as a1Notation } from './a1-notation.ts';\n"],"names":["a1Notation"],"mappings":";;;;+BAAoBA;;;eAAAA,qBAAU;;;mEAAQ"}

package/dist/cjs/mcp/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/resources/index.ts"],"sourcesContent":["export { default as spreadsheet } from './spreadsheet.ts';\n"],"names":["spreadsheet"],"mappings":";;;;+BAAoBA;;;eAAAA,sBAAW;;;oEAAQ"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/resources/index.ts"],"sourcesContent":["export { default as spreadsheet } from './spreadsheet.ts';\n"],"names":["spreadsheet"],"mappings":";;;;+BAAoBA;;;eAAAA,sBAAW;;;oEAAQ"}

package/dist/cjs/mcp/resources/spreadsheet.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/resources/spreadsheet.ts"],"sourcesContent":["import { type sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport type { ReadResourceResult, ResourceConfig, ResourceModule, ServerContext } from '@mcp-z/server';\nimport { ResourceTemplate } from '@mcp-z/server';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport type { GoogleApiError } from '../../types.ts';\n\nexport default function createResource(): ResourceModule {\n  const template = new ResourceTemplate('sheets://spreadsheets/{spreadsheetId}', { list: undefined });\n  const config: ResourceConfig = {\n    description: 'Sheets spreadsheet resource',\n    mimeType: 'application/json',\n  };\n\n  const handler = async (uri: URL, variables: Record<string, string | string[]>, extra: ServerContext): Promise<ReadResourceResult> => {\n    const spreadsheetId = Array.isArray(variables.spreadsheetId) ? variables.spreadsheetId[0] : variables.spreadsheetId;\n\n    if (!spreadsheetId) {\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({ error: 'spreadsheetId is required' }),\n          },\n        ],\n      };\n    }\n\n    try {\n      // Safe type guard to access middleware-enriched extra\n      const { logger, authContext } = extra as unknown as EnrichedExtra;\n      const sheets = sheetsApi({ version: 'v4', auth: googleAuth(authContext.auth) });\n      const resp = await sheets.spreadsheets.get({\n        spreadsheetId,\n        fields: 'spreadsheetId,properties.title,sheets.properties',\n      });\n      const data = resp.data as sheets_v4.Schema$Spreadsheet;\n      logger.info('sheets-spreadsheet resource fetch success', {\n        spreadsheetId: data.spreadsheetId,\n        title: data?.properties?.title,\n        sheetCount: (data?.sheets || []).length,\n      });\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              id: data?.spreadsheetId,\n              title: data?.properties?.title,\n              sheets: (data?.sheets || []).map((s) => ({\n                id: s?.properties?.sheetId,\n                title: s?.properties?.title,\n                rowCount: s?.properties?.gridProperties?.rowCount,\n                columnCount: s?.properties?.gridProperties?.columnCount,\n              })),\n            }),\n          },\n        ],\n      };\n    } catch (error) {\n      const { logger } = extra as unknown as EnrichedExtra;\n      logger.info('sheets-spreadsheet resource fetch failed', error as Record<string, unknown>);\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              error: String((error as GoogleApiError)?.message ?? error),\n            }),\n          },\n        ],\n      };\n    }\n  };\n\n  return {\n    name: 'spreadsheet',\n    template,\n    config,\n    handler,\n  };\n}\n"],"names":["createResource","template","ResourceTemplate","list","undefined","config","description","mimeType","handler","uri","variables","extra","spreadsheetId","data","logger","authContext","sheets","resp","error","Array","isArray","contents","href","text","JSON","stringify","sheetsApi","version","auth","googleAuth","spreadsheets","get","fields","info","title","properties","sheetCount","length","id","map","s","sheetId","rowCount","gridProperties","columnCount","String","message","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/resources/spreadsheet.ts"],"sourcesContent":["import { type sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport type { ReadResourceResult, ResourceConfig, ResourceModule, ServerContext } from '@mcp-z/server';\nimport { ResourceTemplate } from '@mcp-z/server';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport type { GoogleApiError } from '../../types.ts';\n\nexport default function createResource(): ResourceModule {\n  const template = new ResourceTemplate('sheets://spreadsheets/{spreadsheetId}', { list: undefined });\n  const config: ResourceConfig = {\n    description: 'Sheets spreadsheet resource',\n    mimeType: 'application/json',\n  };\n\n  const handler = async (uri: URL, variables: Record<string, string | string[]>, extra: ServerContext): Promise<ReadResourceResult> => {\n    const spreadsheetId = Array.isArray(variables.spreadsheetId) ? variables.spreadsheetId[0] : variables.spreadsheetId;\n\n    if (!spreadsheetId) {\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({ error: 'spreadsheetId is required' }),\n          },\n        ],\n      };\n    }\n\n    try {\n      // Safe type guard to access middleware-enriched extra\n      const { logger, authContext } = extra as unknown as EnrichedExtra;\n      const sheets = sheetsApi({ version: 'v4', auth: googleAuth(authContext.auth) });\n      const resp = await sheets.spreadsheets.get({\n        spreadsheetId,\n        fields: 'spreadsheetId,properties.title,sheets.properties',\n      });\n      const data = resp.data as sheets_v4.Schema$Spreadsheet;\n      logger.info('sheets-spreadsheet resource fetch success', {\n        spreadsheetId: data.spreadsheetId,\n        title: data?.properties?.title,\n        sheetCount: (data?.sheets || []).length,\n      });\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              id: data?.spreadsheetId,\n              title: data?.properties?.title,\n              sheets: (data?.sheets || []).map((s) => ({\n                id: s?.properties?.sheetId,\n                title: s?.properties?.title,\n                rowCount: s?.properties?.gridProperties?.rowCount,\n                columnCount: s?.properties?.gridProperties?.columnCount,\n              })),\n            }),\n          },\n        ],\n      };\n    } catch (error) {\n      const { logger } = extra as unknown as EnrichedExtra;\n      logger.info('sheets-spreadsheet resource fetch failed', error as Record<string, unknown>);\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              error: String((error as GoogleApiError)?.message ?? error),\n            }),\n          },\n        ],\n      };\n    }\n  };\n\n  return {\n    name: 'spreadsheet',\n    template,\n    config,\n    handler,\n  };\n}\n"],"names":["createResource","template","ResourceTemplate","list","undefined","config","description","mimeType","handler","uri","variables","extra","spreadsheetId","data","logger","authContext","sheets","resp","error","Array","isArray","contents","href","text","JSON","stringify","sheetsApi","version","auth","googleAuth","spreadsheets","get","fields","info","title","properties","sheetCount","length","id","map","s","sheetId","rowCount","gridProperties","columnCount","String","message","name"],"mappings":";;;;+BAOA;;;eAAwBA;;;sBAP4B;sBAGnB;4BACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGZ,SAASA;IACtB,IAAMC,WAAW,IAAIC,wBAAgB,CAAC,yCAAyC;QAAEC,MAAMC;IAAU;IACjG,IAAMC,SAAyB;QAC7BC,aAAa;QACbC,UAAU;IACZ;IAEA,IAAMC,UAAU,iBAAOC,KAAUC,WAA8CC;;gBACvEC,eAyBKC,kBAUMA,mBAnBPC,QAAQC,aACVC,QACAC,MAIAJ,MAwBCK,aACCJ;;;;wBA/CJF,gBAAgBO,MAAMC,OAAO,CAACV,UAAUE,aAAa,IAAIF,UAAUE,aAAa,CAAC,EAAE,GAAGF,UAAUE,aAAa;wBAEnH,IAAI,CAACA,eAAe;4BAClB;;gCAAO;oCACLS,QAAQ;wCACN;4CACEZ,KAAKA,IAAIa,IAAI;4CACbf,UAAU;4CACVgB,MAAMC,KAAKC,SAAS,CAAC;gDAAEP,OAAO;4CAA4B;wCAC5D;;gCAEJ;;wBACF;;;;;;;;;wBAGE,sDAAsD;wBAC9CJ,SAAwBH,MAAxBG,QAAQC,cAAgBJ,MAAhBI;wBACVC,SAASU,IAAAA,cAAS,EAAC;4BAAEC,SAAS;4BAAMC,MAAMC,IAAAA,wBAAU,EAACd,YAAYa,IAAI;wBAAE;wBAChE;;4BAAMZ,OAAOc,YAAY,CAACC,GAAG,CAAC;gCACzCnB,eAAAA;gCACAoB,QAAQ;4BACV;;;wBAHMf,OAAO;wBAIPJ,OAAOI,KAAKJ,IAAI;wBACtBC,OAAOmB,IAAI,CAAC,6CAA6C;4BACvDrB,eAAeC,KAAKD,aAAa;4BACjCsB,KAAK,EAAErB,iBAAAA,4BAAAA,mBAAAA,KAAMsB,UAAU,cAAhBtB,uCAAAA,iBAAkBqB,KAAK;4BAC9BE,YAAY,AAACvB,CAAAA,CAAAA,iBAAAA,2BAAAA,KAAMG,MAAM,OAAK,EAAGqB,MAAM;wBACzC;wBACA;;4BAAO;gCACLhB,QAAQ;oCACN;wCACEZ,KAAKA,IAAIa,IAAI;wCACbf,UAAU;wCACVgB,MAAMC,KAAKC,SAAS,CAAC;4CACnBa,EAAE,EAAEzB,iBAAAA,2BAAAA,KAAMD,aAAa;4CACvBsB,KAAK,EAAErB,iBAAAA,4BAAAA,oBAAAA,KAAMsB,UAAU,cAAhBtB,wCAAAA,kBAAkBqB,KAAK;4CAC9BlB,QAAQ,AAACH,CAAAA,CAAAA,iBAAAA,2BAAAA,KAAMG,MAAM,OAAK,EAAGuB,GAAG,CAAC,SAACC;oDAC5BA,eACGA,gBACGA,8BAAAA,gBACGA,+BAAAA;uDAJ0B;oDACvCF,EAAE,EAAEE,cAAAA,yBAAAA,gBAAAA,EAAGL,UAAU,cAAbK,oCAAAA,cAAeC,OAAO;oDAC1BP,KAAK,EAAEM,cAAAA,yBAAAA,iBAAAA,EAAGL,UAAU,cAAbK,qCAAAA,eAAeN,KAAK;oDAC3BQ,QAAQ,EAAEF,cAAAA,yBAAAA,iBAAAA,EAAGL,UAAU,cAAbK,sCAAAA,+BAAAA,eAAeG,cAAc,cAA7BH,mDAAAA,6BAA+BE,QAAQ;oDACjDE,WAAW,EAAEJ,cAAAA,yBAAAA,iBAAAA,EAAGL,UAAU,cAAbK,sCAAAA,gCAAAA,eAAeG,cAAc,cAA7BH,oDAAAA,8BAA+BI,WAAW;gDACzD;;wCACF;oCACF;;4BAEJ;;;wBACO1B;wBACCJ,UAAWH,MAAXG;wBACRA,QAAOmB,IAAI,CAAC,4CAA4Cf;wBACxD;;4BAAO;gCACLG,QAAQ;oCACN;wCACEZ,KAAKA,IAAIa,IAAI;wCACbf,UAAU;wCACVgB,MAAMC,KAAKC,SAAS,CAAC;4CACnBP,OAAO2B,eAAQ3B,kBAAAA,4BAAD,AAACA,MAA0B4B,OAAO,uCAAI5B;wCACtD;oCACF;;4BAEJ;;;;;;;;QAEJ;;IAEA,OAAO;QACL6B,MAAM;QACN9C,UAAAA;QACAI,QAAAA;QACAG,SAAAA;IACF;AACF"}

package/dist/cjs/mcp/tools/cells-format.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-format.ts"],"sourcesContent":["import { type sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// RGB color schema (0-1 range for Google Sheets API)\nconst ColorSchema = z.object({\n  red: z.number().min(0).max(1).describe('Red component (0-1)'),\n  green: z.number().min(0).max(1).describe('Green component (0-1)'),\n  blue: z.number().min(0).max(1).describe('Blue component (0-1)'),\n});\n\n// Number format schema\nconst NumberFormatSchema = z.object({\n  type: z.enum(['TEXT', 'NUMBER', 'PERCENT', 'CURRENCY', 'DATE', 'TIME']).describe('Number format type'),\n  pattern: z.string().optional().describe('Custom format pattern (e.g., \"$#,##0.00\" for currency)'),\n});\n\n// Border schema\nconst BorderSchema = z.object({\n  style: z.enum(['SOLID', 'DASHED', 'DOTTED']).describe('Border line style'),\n  color: ColorSchema.describe('Border color'),\n});\n\n// Input schema for format requests\nconst FormatRequestSchema = z.object({\n  range: z.string().min(1).describe('A1 notation range to format (e.g., \"A1:D10\", \"B:B\", \"5:5\")'),\n  backgroundColor: ColorSchema.optional().describe('Cell background color'),\n  textColor: ColorSchema.optional().describe('Text color'),\n  bold: z.boolean().optional().describe('Bold text'),\n  fontSize: z.number().int().min(6).max(36).optional().describe('Font size in points'),\n  horizontalAlignment: z.enum(['LEFT', 'CENTER', 'RIGHT']).optional().describe('Horizontal text alignment'),\n  numberFormat: NumberFormatSchema.optional().describe('Number format pattern'),\n  borders: BorderSchema.optional().describe('Cell borders'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  requests: z.array(FormatRequestSchema).min(1).max(50).describe('Array of formatting requests. Batch multiple ranges for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Title of the formatted sheet'),\n  sheetUrl: z.string().describe('URL of the formatted sheet'),\n  successCount: z.number().int().nonnegative().describe('Number of format requests successfully applied'),\n  failedRanges: z\n    .array(\n      z.object({\n        range: z.string().describe('A1 notation of range that failed'),\n        error: z.string().describe('Why formatting failed for this range'),\n      })\n    )\n    .optional()\n    .describe('Only populated if some ranges failed to format'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.cells.format called', {\n    id,\n    gid,\n    requestCount: requests.length,\n  });\n\n  try {\n    const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for format cells', { id, gid, requestCount: requests.length });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n    const sheetId = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n    // Build batch update requests\n    const batchRequests: sheets_v4.Schema$Request[] = [];\n    const failedRanges: Array<{ range: string; error: string }> = [];\n\n    for (const request of requests) {\n      try {\n        // Parse A1 notation to range reference\n        const rangeRef = parseA1Notation(request.range);\n\n        // Build grid range from range reference using helper function\n        const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n        // Build cell format object\n        const cellFormat: {\n          backgroundColor?: sheets_v4.Schema$Color;\n          textFormat?: sheets_v4.Schema$TextFormat;\n          horizontalAlignment?: string;\n          numberFormat?: sheets_v4.Schema$NumberFormat;\n        } = {};\n        const fields: string[] = [];\n\n        // Background color\n        if (request.backgroundColor) {\n          cellFormat.backgroundColor = request.backgroundColor;\n          fields.push('backgroundColor');\n        }\n\n        // Text format\n        if (request.textColor || request.bold !== undefined || request.fontSize !== undefined) {\n          cellFormat.textFormat = {};\n          if (request.textColor) {\n            cellFormat.textFormat.foregroundColor = request.textColor;\n            fields.push('textFormat.foregroundColor');\n          }\n          if (request.bold !== undefined) {\n            cellFormat.textFormat.bold = request.bold;\n            fields.push('textFormat.bold');\n          }\n          if (request.fontSize !== undefined) {\n            cellFormat.textFormat.fontSize = request.fontSize;\n            fields.push('textFormat.fontSize');\n          }\n        }\n\n        // Horizontal alignment\n        if (request.horizontalAlignment) {\n          cellFormat.horizontalAlignment = request.horizontalAlignment;\n          fields.push('horizontalAlignment');\n        }\n\n        // Number format\n        if (request.numberFormat) {\n          const numberFormat: sheets_v4.Schema$NumberFormat = {\n            type: request.numberFormat.type,\n          };\n          if (request.numberFormat.pattern !== undefined) {\n            numberFormat.pattern = request.numberFormat.pattern;\n          }\n          cellFormat.numberFormat = numberFormat;\n          fields.push('numberFormat');\n        }\n\n        // Add repeatCell request for this range\n        if (fields.length > 0) {\n          batchRequests.push({\n            repeatCell: {\n              range: gridRange,\n              cell: {\n                userEnteredFormat: cellFormat,\n              },\n              fields: `userEnteredFormat(${fields.join(',')})`,\n            },\n          });\n        }\n\n        // Add border formatting if specified\n        if (request.borders) {\n          batchRequests.push({\n            updateBorders: {\n              range: gridRange,\n              top: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              bottom: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              left: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              right: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n            },\n          });\n        }\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        logger.info('Failed to parse range for formatting', {\n          range: request.range,\n          error: message,\n        });\n        failedRanges.push({\n          range: request.range,\n          error: `Failed to parse range: ${message}`,\n        });\n      }\n    }\n\n    // Early return if all ranges failed\n    if (batchRequests.length === 0) {\n      const result: Output = {\n        type: 'success' as const,\n        id,\n        gid: String(sheetId),\n        sheetTitle,\n        sheetUrl,\n        successCount: 0,\n        failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n      };\n\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n        structuredContent: { result },\n      };\n    }\n\n    logger.info('sheets.cells.format executing batch request', {\n      spreadsheetId: id,\n      sheetTitle,\n      batchRequestsCount: batchRequests.length,\n    });\n\n    // Execute the batch update\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: batchRequests,\n      },\n    });\n\n    logger.info('sheets.cells.format completed successfully', {\n      successCount: requests.length - failedRanges.length,\n      failedCount: failedRanges.length,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      sheetTitle,\n      sheetUrl,\n      successCount: requests.length - failedRanges.length,\n      failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Format cells operation failed', {\n      id,\n      gid,\n      requestCount: requests.length,\n      error: message,\n    });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error formatting cells: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'cells-format',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","ColorSchema","z","object","red","number","min","max","describe","green","blue","NumberFormatSchema","type","enum","pattern","string","optional","BorderSchema","style","color","FormatRequestSchema","range","backgroundColor","textColor","bold","boolean","fontSize","int","horizontalAlignment","numberFormat","borders","inputSchema","id","SpreadsheetIdSchema","gid","SheetGidSchema","requests","array","successBranchSchema","literal","SpreadsheetIdOutput","SheetGidOutput","sheetTitle","sheetUrl","successCount","nonnegative","failedRanges","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","sheet","spreadsheetResponse","sheets","sheetId","batchRequests","request","rangeRef","gridRange","cellFormat","fields","message","info","requestCount","length","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","data","find","s","String","properties","ProtocolError","ProtocolErrorCode","InvalidParams","title","parseA1Notation","rangeReferenceToGridRange","push","undefined","textFormat","foregroundColor","repeatCell","cell","userEnteredFormat","join","updateBorders","top","bottom","left","right","Error","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-format.ts"],"sourcesContent":["import { type sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// RGB color schema (0-1 range for Google Sheets API)\nconst ColorSchema = z.object({\n  red: z.number().min(0).max(1).describe('Red component (0-1)'),\n  green: z.number().min(0).max(1).describe('Green component (0-1)'),\n  blue: z.number().min(0).max(1).describe('Blue component (0-1)'),\n});\n\n// Number format schema\nconst NumberFormatSchema = z.object({\n  type: z.enum(['TEXT', 'NUMBER', 'PERCENT', 'CURRENCY', 'DATE', 'TIME']).describe('Number format type'),\n  pattern: z.string().optional().describe('Custom format pattern (e.g., \"$#,##0.00\" for currency)'),\n});\n\n// Border schema\nconst BorderSchema = z.object({\n  style: z.enum(['SOLID', 'DASHED', 'DOTTED']).describe('Border line style'),\n  color: ColorSchema.describe('Border color'),\n});\n\n// Input schema for format requests\nconst FormatRequestSchema = z.object({\n  range: z.string().min(1).describe('A1 notation range to format (e.g., \"A1:D10\", \"B:B\", \"5:5\")'),\n  backgroundColor: ColorSchema.optional().describe('Cell background color'),\n  textColor: ColorSchema.optional().describe('Text color'),\n  bold: z.boolean().optional().describe('Bold text'),\n  fontSize: z.number().int().min(6).max(36).optional().describe('Font size in points'),\n  horizontalAlignment: z.enum(['LEFT', 'CENTER', 'RIGHT']).optional().describe('Horizontal text alignment'),\n  numberFormat: NumberFormatSchema.optional().describe('Number format pattern'),\n  borders: BorderSchema.optional().describe('Cell borders'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  requests: z.array(FormatRequestSchema).min(1).max(50).describe('Array of formatting requests. Batch multiple ranges for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Title of the formatted sheet'),\n  sheetUrl: z.string().describe('URL of the formatted sheet'),\n  successCount: z.number().int().nonnegative().describe('Number of format requests successfully applied'),\n  failedRanges: z\n    .array(\n      z.object({\n        range: z.string().describe('A1 notation of range that failed'),\n        error: z.string().describe('Why formatting failed for this range'),\n      })\n    )\n    .optional()\n    .describe('Only populated if some ranges failed to format'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.cells.format called', {\n    id,\n    gid,\n    requestCount: requests.length,\n  });\n\n  try {\n    const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for format cells', { id, gid, requestCount: requests.length });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n    const sheetId = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n    // Build batch update requests\n    const batchRequests: sheets_v4.Schema$Request[] = [];\n    const failedRanges: Array<{ range: string; error: string }> = [];\n\n    for (const request of requests) {\n      try {\n        // Parse A1 notation to range reference\n        const rangeRef = parseA1Notation(request.range);\n\n        // Build grid range from range reference using helper function\n        const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n        // Build cell format object\n        const cellFormat: {\n          backgroundColor?: sheets_v4.Schema$Color;\n          textFormat?: sheets_v4.Schema$TextFormat;\n          horizontalAlignment?: string;\n          numberFormat?: sheets_v4.Schema$NumberFormat;\n        } = {};\n        const fields: string[] = [];\n\n        // Background color\n        if (request.backgroundColor) {\n          cellFormat.backgroundColor = request.backgroundColor;\n          fields.push('backgroundColor');\n        }\n\n        // Text format\n        if (request.textColor || request.bold !== undefined || request.fontSize !== undefined) {\n          cellFormat.textFormat = {};\n          if (request.textColor) {\n            cellFormat.textFormat.foregroundColor = request.textColor;\n            fields.push('textFormat.foregroundColor');\n          }\n          if (request.bold !== undefined) {\n            cellFormat.textFormat.bold = request.bold;\n            fields.push('textFormat.bold');\n          }\n          if (request.fontSize !== undefined) {\n            cellFormat.textFormat.fontSize = request.fontSize;\n            fields.push('textFormat.fontSize');\n          }\n        }\n\n        // Horizontal alignment\n        if (request.horizontalAlignment) {\n          cellFormat.horizontalAlignment = request.horizontalAlignment;\n          fields.push('horizontalAlignment');\n        }\n\n        // Number format\n        if (request.numberFormat) {\n          const numberFormat: sheets_v4.Schema$NumberFormat = {\n            type: request.numberFormat.type,\n          };\n          if (request.numberFormat.pattern !== undefined) {\n            numberFormat.pattern = request.numberFormat.pattern;\n          }\n          cellFormat.numberFormat = numberFormat;\n          fields.push('numberFormat');\n        }\n\n        // Add repeatCell request for this range\n        if (fields.length > 0) {\n          batchRequests.push({\n            repeatCell: {\n              range: gridRange,\n              cell: {\n                userEnteredFormat: cellFormat,\n              },\n              fields: `userEnteredFormat(${fields.join(',')})`,\n            },\n          });\n        }\n\n        // Add border formatting if specified\n        if (request.borders) {\n          batchRequests.push({\n            updateBorders: {\n              range: gridRange,\n              top: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              bottom: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              left: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              right: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n            },\n          });\n        }\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        logger.info('Failed to parse range for formatting', {\n          range: request.range,\n          error: message,\n        });\n        failedRanges.push({\n          range: request.range,\n          error: `Failed to parse range: ${message}`,\n        });\n      }\n    }\n\n    // Early return if all ranges failed\n    if (batchRequests.length === 0) {\n      const result: Output = {\n        type: 'success' as const,\n        id,\n        gid: String(sheetId),\n        sheetTitle,\n        sheetUrl,\n        successCount: 0,\n        failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n      };\n\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n        structuredContent: { result },\n      };\n    }\n\n    logger.info('sheets.cells.format executing batch request', {\n      spreadsheetId: id,\n      sheetTitle,\n      batchRequestsCount: batchRequests.length,\n    });\n\n    // Execute the batch update\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: batchRequests,\n      },\n    });\n\n    logger.info('sheets.cells.format completed successfully', {\n      successCount: requests.length - failedRanges.length,\n      failedCount: failedRanges.length,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      sheetTitle,\n      sheetUrl,\n      successCount: requests.length - failedRanges.length,\n      failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Format cells operation failed', {\n      id,\n      gid,\n      requestCount: requests.length,\n      error: message,\n    });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error formatting cells: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'cells-format',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","ColorSchema","z","object","red","number","min","max","describe","green","blue","NumberFormatSchema","type","enum","pattern","string","optional","BorderSchema","style","color","FormatRequestSchema","range","backgroundColor","textColor","bold","boolean","fontSize","int","horizontalAlignment","numberFormat","borders","inputSchema","id","SpreadsheetIdSchema","gid","SheetGidSchema","requests","array","successBranchSchema","literal","SpreadsheetIdOutput","SheetGidOutput","sheetTitle","sheetUrl","successCount","nonnegative","failedRanges","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","sheet","spreadsheetResponse","sheets","sheetId","batchRequests","request","rangeRef","gridRange","cellFormat","fields","message","info","requestCount","length","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","data","find","s","String","properties","ProtocolError","ProtocolErrorCode","InvalidParams","title","parseA1Notation","rangeReferenceToGridRange","push","undefined","textFormat","foregroundColor","repeatCell","cell","userEnteredFormat","join","updateBorders","top","bottom","left","right","Error","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","name"],"mappings":"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"}

package/dist/cjs/mcp/tools/cells-metadata-get.d.cts

@@ -0,0 +1,95 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import type { CallToolResult } from '@mcp-z/server';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    id: z.ZodString;
+    gid: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    ranges: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    id: z.ZodString;
+    gid: z.ZodString;
+    metadata: z.ZodObject<{
+        spreadsheetId: z.ZodString;
+        sheets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            properties: z.ZodOptional<z.ZodObject<{
+                sheetId: z.ZodOptional<z.ZodNumber>;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            data: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                startRow: z.ZodOptional<z.ZodNumber>;
+                startColumn: z.ZodOptional<z.ZodNumber>;
+                rowData: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    values: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        note: z.ZodOptional<z.ZodString>;
+                        dataValidation: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+                        pivotTable: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+                        dataSourceTable: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+                    }, z.core.$loose>>>;
+                }, z.core.$loose>>>;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>;
+    fieldMask: z.ZodString;
+    requestedRanges: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler(input: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Read notes, data validation rules, pivot table and data-source table definitions in required finite ranges on one sheet. Preserves sparse row/column offsets. Excludes cell values, formulas and direct formatting. DATA_SOURCE and OBJECT sheets are unsupported.";
+        readonly annotations: {
+            readonly readOnlyHint: true;
+        };
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            gid: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+            ranges: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                id: z.ZodString;
+                gid: z.ZodString;
+                metadata: z.ZodObject<{
+                    spreadsheetId: z.ZodString;
+                    sheets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        properties: z.ZodOptional<z.ZodObject<{
+                            sheetId: z.ZodOptional<z.ZodNumber>;
+                            title: z.ZodOptional<z.ZodString>;
+                        }, z.core.$loose>>;
+                        data: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            startRow: z.ZodOptional<z.ZodNumber>;
+                            startColumn: z.ZodOptional<z.ZodNumber>;
+                            rowData: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                values: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                    note: z.ZodOptional<z.ZodString>;
+                                    dataValidation: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+                                    pivotTable: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+                                    dataSourceTable: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+                                }, z.core.$loose>>>;
+                            }, z.core.$loose>>>;
+                        }, z.core.$loose>>>;
+                    }, z.core.$loose>>>;
+                }, z.core.$loose>;
+                fieldMask: z.ZodString;
+                requestedRanges: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};

package/dist/cjs/mcp/tools/cells-metadata-get.d.ts

@@ -0,0 +1,95 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import type { CallToolResult } from '@mcp-z/server';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    id: z.ZodString;
+    gid: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    ranges: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    id: z.ZodString;
+    gid: z.ZodString;
+    metadata: z.ZodObject<{
+        spreadsheetId: z.ZodString;
+        sheets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            properties: z.ZodOptional<z.ZodObject<{
+                sheetId: z.ZodOptional<z.ZodNumber>;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            data: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                startRow: z.ZodOptional<z.ZodNumber>;
+                startColumn: z.ZodOptional<z.ZodNumber>;
+                rowData: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    values: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        note: z.ZodOptional<z.ZodString>;
+                        dataValidation: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+                        pivotTable: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+                        dataSourceTable: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+                    }, z.core.$loose>>>;
+                }, z.core.$loose>>>;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>;
+    fieldMask: z.ZodString;
+    requestedRanges: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler(input: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Read notes, data validation rules, pivot table and data-source table definitions in required finite ranges on one sheet. Preserves sparse row/column offsets. Excludes cell values, formulas and direct formatting. DATA_SOURCE and OBJECT sheets are unsupported.";
+        readonly annotations: {
+            readonly readOnlyHint: true;
+        };
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            gid: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+            ranges: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                id: z.ZodString;
+                gid: z.ZodString;
+                metadata: z.ZodObject<{
+                    spreadsheetId: z.ZodString;
+                    sheets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        properties: z.ZodOptional<z.ZodObject<{
+                            sheetId: z.ZodOptional<z.ZodNumber>;
+                            title: z.ZodOptional<z.ZodString>;
+                        }, z.core.$loose>>;
+                        data: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                            startRow: z.ZodOptional<z.ZodNumber>;
+                            startColumn: z.ZodOptional<z.ZodNumber>;
+                            rowData: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                values: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                    note: z.ZodOptional<z.ZodString>;
+                                    dataValidation: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+                                    pivotTable: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+                                    dataSourceTable: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+                                }, z.core.$loose>>>;
+                            }, z.core.$loose>>>;
+                        }, z.core.$loose>>>;
+                    }, z.core.$loose>>>;
+                }, z.core.$loose>;
+                fieldMask: z.ZodString;
+                requestedRanges: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};