@mcp-z/mcp-sheets 1.0.6 → 1.1.0

package/README.md

@@ -194,8 +194,9 @@ mcp-z call sheets spreadsheet-find '{"spreadsheetRef":"Quarterly Report"}'
 22. values-batch-update
 23. values-clear
 24. values-csv-update
-25. values-replace
-26. values-search
+25. values-markdown-update
+26. values-replace
+27. values-search
 
 ## Resources
 

package/dist/cjs/constants.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/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/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"}

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/index.ts"],"sourcesContent":["import { createConfig, handleVersionHelp } from './setup/config.ts';\nimport { createHTTPServer } from './setup/http.ts';\nimport { createStdioServer } from './setup/stdio.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  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\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","logger","close","transport","type","createStdioServer","createHTTPServer","process","on","exit","info","Promise","versionHelpResult","handleVersionHelp","argv","handled","console","log","output","createConfig","URL","pathname"],"mappings":";;;;;;;;;;;QAKSA;eAAAA,yBAAY;;QAkBrB;eAA8BC;;QAjBlBC;;;QACAC;;;QACAC;;;QAGUC;eAAAA;;;wBAX0B;sBACf;uBACC;2BAGL;+DACR;gEACI;gEACF;qBACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEP,SAAeA,YAAYC,MAAoB;;YAC1BA,MAAlBC,QAAQC;;;;yBAAUF,CAAAA,OAAOG,SAAS,CAACC,IAAI,KAAK,OAAM,GAAhCJ;;;;oBAAoC;;wBAAMK,IAAAA,0BAAiB,EAACL;;;2BAAxB;;;;;;oBAAkC;;wBAAMM,IAAAA,wBAAgB,EAACN;;;2BAAvB;;;oBAAtEA,aAAlBC,SAAkBD,KAAlBC,QAAQC,QAAUF,KAAVE;oBAEhBK,QAAQC,EAAE,CAAC,UAAU;;;;;wCACnB;;4CAAMN;;;wCAAN;wCACAK,QAAQE,IAAI,CAAC;;;;;;wBACf;;oBAEAR,OAAOS,IAAI,CAAC,AAAC,uBAA4C,OAAtBV,OAAOG,SAAS,CAACC,IAAI,EAAC;oBACzD;;wBAAM,IAAIO,QAAQ,YAAO;;;oBAAzB;;;;;;IACF;;AAEe,SAAehB;;YAEtBiB,mBAOAZ;;;;oBARN,4DAA4D;oBACtDY,oBAAoBC,IAAAA,2BAAiB,EAACN,QAAQO,IAAI;oBACxD,IAAIF,kBAAkBG,OAAO,EAAE;wBAC7BC,QAAQC,GAAG,CAACL,kBAAkBM,MAAM;wBACpCX,QAAQE,IAAI,CAAC;oBACf;oBAEA,6CAA6C;oBACvCT,SAASmB,IAAAA,sBAAY;oBAC3B;;wBAAMpB,YAAYC;;;oBAAlB;;;;;;IACF;;AAEA,IAAIO,QAAQO,IAAI,CAAC,EAAE,KAAK,IAAIM,IAAI,qDAAiBC,QAAQ,EAAE;IACzD1B;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/index.ts"],"sourcesContent":["import { createConfig, handleVersionHelp } from './setup/config.ts';\nimport { createHTTPServer } from './setup/http.ts';\nimport { createStdioServer } from './setup/stdio.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  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\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","logger","close","transport","type","createStdioServer","createHTTPServer","process","on","exit","info","Promise","versionHelpResult","handleVersionHelp","argv","handled","console","log","output","createConfig","URL","pathname"],"mappings":";;;;;;;;;;;QAKSA;eAAAA,yBAAY;;QAkBrB;eAA8BC;;QAjBlBC;;;QACAC;;;QACAC;;;QAGUC;eAAAA;;;wBAX0B;sBACf;uBACC;2BAGL;+DACR;gEACI;gEACF;qBACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEP,SAAeA,YAAYC,MAAoB;;YAC1BA,MAAlBC,QAAQC;;;;yBAAUF,CAAAA,OAAOG,SAAS,CAACC,IAAI,KAAK,OAAM,GAAhCJ;;;;oBAAoC;;wBAAMK,IAAAA,0BAAiB,EAACL;;;2BAAxB;;;;;;oBAAkC;;wBAAMM,IAAAA,wBAAgB,EAACN;;;2BAAvB;;;oBAAtEA,aAAlBC,SAAkBD,KAAlBC,QAAQC,QAAUF,KAAVE;oBAEhBK,QAAQC,EAAE,CAAC,UAAU;;;;;wCACnB;;4CAAMN;;;wCAAN;wCACAK,QAAQE,IAAI,CAAC;;;;;;wBACf;;oBAEAR,OAAOS,IAAI,CAAC,AAAC,uBAA4C,OAAtBV,OAAOG,SAAS,CAACC,IAAI,EAAC;oBACzD;;wBAAM,IAAIO,QAAQ,YAAO;;;oBAAzB;;;;;;IACF;;AAEe,SAAehB;;YAEtBiB,mBAOAZ;;;;oBARN,4DAA4D;oBACtDY,oBAAoBC,IAAAA,2BAAiB,EAACN,QAAQO,IAAI;oBACxD,IAAIF,kBAAkBG,OAAO,EAAE;wBAC7BC,QAAQC,GAAG,CAACL,kBAAkBM,MAAM;wBACpCX,QAAQE,IAAI,CAAC;oBACf;oBAEA,6CAA6C;oBACvCT,SAASmB,IAAAA,sBAAY;oBAC3B;;wBAAMpB,YAAYC;;;oBAAlB;;;;;;IACF;;AAEA,IAAIO,QAAQO,IAAI,CAAC,EAAE,KAAK,IAAIM,IAAI,qDAAiBC,QAAQ,EAAE;IACzD1B;AACF"}

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

@@ -142,46 +142,19 @@ function _ts_generator(thisArg, body) {
         };
     }
 }
-function parseDefaultTtl(uri) {
-    try {
-        var url = new URL(uri);
-        var ttlParam = url.searchParams.get('ttl');
-        var ttlSecondsParam = url.searchParams.get('ttlSeconds');
-        var ttlMs = ttlSecondsParam ? Number(ttlSecondsParam) * 1000 : ttlParam ? Number(ttlParam) : undefined;
-        url.searchParams.delete('ttl');
-        url.searchParams.delete('ttlSeconds');
-        return Number.isFinite(ttlMs) && ttlMs > 0 ? {
-            uri: url.toString(),
-            ttl: ttlMs
-        } : {
-            uri: url.toString()
-        };
-    } catch (unused) {
-        return {
-            uri: uri
-        };
-    }
-}
 function createStore(uri) {
     return _async_to_generator(function() {
-        var _parseDefaultTtl, parsedUri, defaultTtl, store, originalSet;
+        var store;
         return _ts_generator(this, function(_state) {
             switch(_state.label){
                 case 0:
-                    _parseDefaultTtl = parseDefaultTtl(uri), parsedUri = _parseDefaultTtl.uri, defaultTtl = _parseDefaultTtl.ttl;
                     return [
                         4,
-                        (0, _keyvregistry.default)(parsedUri)
+                        (0, _keyvregistry.default)(uri)
                     ];
                 case 1:
                     store = _state.sent();
                     if (!store) throw new Error("Failed to create store for URI: ".concat(uri));
-                    if (defaultTtl !== undefined) {
-                        originalSet = store.set.bind(store);
-                        store.set = function(key, value, ttl) {
-                            return originalSet(key, value, ttl !== null && ttl !== void 0 ? ttl : defaultTtl);
-                        };
-                    }
                     return [
                         2,
                         store

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/lib/create-store.ts"],"sourcesContent":["import type Keyv from 'keyv';\nimport keyvRegistry from 'keyv-registry';\n\nfunction parseDefaultTtl(uri: string): { uri: string; ttl?: number } {\n  try {\n    const url = new URL(uri);\n    const ttlParam = url.searchParams.get('ttl');\n    const ttlSecondsParam = url.searchParams.get('ttlSeconds');\n    const ttlMs = ttlSecondsParam ? Number(ttlSecondsParam) * 1000 : ttlParam ? Number(ttlParam) : undefined;\n    url.searchParams.delete('ttl');\n    url.searchParams.delete('ttlSeconds');\n    return Number.isFinite(ttlMs) && (ttlMs as number) > 0 ? { uri: url.toString(), ttl: ttlMs } : { uri: url.toString() };\n  } catch {\n    return { uri };\n  }\n}\n\nexport default async function createStore<T>(uri: string): Promise<Keyv<T>> {\n  const { uri: parsedUri, ttl: defaultTtl } = parseDefaultTtl(uri);\n  const store = await keyvRegistry<T>(parsedUri);\n  if (!store) throw new Error(`Failed to create store for URI: ${uri}`);\n  if (defaultTtl !== undefined) {\n    const originalSet = store.set.bind(store);\n    store.set = ((key, value, ttl) => originalSet(key, value, ttl ?? defaultTtl)) as typeof store.set;\n  }\n  return store;\n}\n"],"names":["createStore","parseDefaultTtl","uri","url","URL","ttlParam","searchParams","get","ttlSecondsParam","ttlMs","Number","undefined","delete","isFinite","toString","ttl","parsedUri","defaultTtl","store","originalSet","keyvRegistry","Error","set","bind","key","value"],"mappings":";;;;+BAiBA;;;eAA8BA;;;mEAhBL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEzB,SAASC,gBAAgBC,GAAW;IAClC,IAAI;QACF,IAAMC,MAAM,IAAIC,IAAIF;QACpB,IAAMG,WAAWF,IAAIG,YAAY,CAACC,GAAG,CAAC;QACtC,IAAMC,kBAAkBL,IAAIG,YAAY,CAACC,GAAG,CAAC;QAC7C,IAAME,QAAQD,kBAAkBE,OAAOF,mBAAmB,OAAOH,WAAWK,OAAOL,YAAYM;QAC/FR,IAAIG,YAAY,CAACM,MAAM,CAAC;QACxBT,IAAIG,YAAY,CAACM,MAAM,CAAC;QACxB,OAAOF,OAAOG,QAAQ,CAACJ,UAAU,AAACA,QAAmB,IAAI;YAAEP,KAAKC,IAAIW,QAAQ;YAAIC,KAAKN;QAAM,IAAI;YAAEP,KAAKC,IAAIW,QAAQ;QAAG;IACvH,EAAE,eAAM;QACN,OAAO;YAAEZ,KAAAA;QAAI;IACf;AACF;AAEe,SAAeF,YAAeE,GAAW;;YACVD,kBAA/Be,WAAgBC,YACvBC,OAGEC;;;;oBAJoClB,mBAAAA,gBAAgBC,MAA/Cc,YAA+Bf,iBAApCC,KAAqBe,aAAehB,iBAApBc;oBACV;;wBAAMK,IAAAA,qBAAY,EAAIJ;;;oBAA9BE,QAAQ;oBACd,IAAI,CAACA,OAAO,MAAM,IAAIG,MAAM,AAAC,mCAAsC,OAAJnB;oBAC/D,IAAIe,eAAeN,WAAW;wBACtBQ,cAAcD,MAAMI,GAAG,CAACC,IAAI,CAACL;wBACnCA,MAAMI,GAAG,GAAI,SAACE,KAAKC,OAAOV;mCAAQI,YAAYK,KAAKC,OAAOV,gBAAAA,iBAAAA,MAAOE;;oBACnE;oBACA;;wBAAOC;;;;IACT"}
+{"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\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;;;eAA8BA;;;mEAFL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEV,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/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/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/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"}

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

@@ -140,7 +140,7 @@ function createPrompt() {
     var config = {
         description: 'Reference guide for Google Sheets A1 notation syntax'
     };
-    var handler = function(_args, _extra) {
+    var handler = function handler(_args, _extra) {
         return _async_to_generator(function() {
             return _ts_generator(this, function(_state) {
                 return [

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/prompts/a1-notation.ts"],"sourcesContent":["import type { PromptModule } from '@mcp-z/server';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport type { ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';\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: RequestHandlerExtra<ServerRequest, ServerNotification>) => {\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":";;;;+BAIA;;;eAAwBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAT,SAASA;IACtB,IAAMC,SAAS;QACbC,aAAa;IACf;IAEA,IAAMC,UAAU,SAAOC,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/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/prompts/a1-notation.ts"],"sourcesContent":["import type { PromptModule } from '@mcp-z/server';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport type { ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';\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: RequestHandlerExtra<ServerRequest, ServerNotification>) => {\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":";;;;+BAIA;;;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/Projects/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/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"}

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/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/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"}

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

@@ -146,7 +146,7 @@ function createResource() {
         description: 'Sheets spreadsheet resource',
         mimeType: 'application/json'
     };
-    var handler = function(uri, variables, extra) {
+    var handler = function handler(uri, variables, extra) {
         return _async_to_generator(function() {
             var spreadsheetId, _data_properties, _data_properties1, logger, authContext, sheets, resp, data, error, _ref, logger1;
             return _ts_generator(this, function(_state) {

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/resources/spreadsheet.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport type { ResourceConfig, ResourceModule } from '@mcp-z/server';\nimport { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport type { ReadResourceResult, ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';\nimport { google, type sheets_v4 } from 'googleapis';\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: RequestHandlerExtra<ServerRequest, ServerNotification>): 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 = google.sheets({ version: 'v4', auth: 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","google","version","auth","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/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/resources/spreadsheet.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport type { ResourceConfig, ResourceModule } from '@mcp-z/server';\nimport { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport type { ReadResourceResult, ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';\nimport { google, type sheets_v4 } from 'googleapis';\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: RequestHandlerExtra<ServerRequest, ServerNotification>): 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 = google.sheets({ version: 'v4', auth: 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","google","version","auth","spreadsheets","get","fields","info","title","properties","sheetCount","length","id","map","s","sheetId","rowCount","gridProperties","columnCount","String","message","name"],"mappings":"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"}

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

@@ -44,6 +44,7 @@ function _async_to_generator(fn) {
     };
 }
 function _instanceof(left, right) {
+    "@swc/helpers - instanceof";
     if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
         return !!right[Symbol.hasInstance](left);
     } else {
@@ -222,7 +223,7 @@ var config = {
 };
 function handler(_0, _1) {
     return _async_to_generator(function(param, extra) {
-        var id, gid, requests, logger, _sheet_properties_title, _spreadsheetResponse_data_sheets, sheets, spreadsheetResponse, sheet, sheetTitle, sheetId, sheetUrl, batchRequests, failedRanges, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, request, rangeRef, gridRange, cellFormat, fields, numberFormat, message, result, result1, error, message1;
+        var id, gid, requests, logger, _sheet_properties_title, _sheet_properties_sheetId, _spreadsheetResponse_data_sheets, sheets, spreadsheetResponse, sheet, sheetTitle, sheetId, sheetUrl, batchRequests, failedRanges, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, request, rangeRef, gridRange, cellFormat, fields, numberFormat, message, result, result1, error, message1;
         return _ts_generator(this, function(_state) {
             switch(_state.label){
                 case 0:
@@ -268,7 +269,8 @@ function handler(_0, _1) {
                         throw new _types.McpError(_types.ErrorCode.InvalidParams, "Sheet not found: ".concat(gid));
                     }
                     sheetTitle = (_sheet_properties_title = sheet.properties.title) !== null && _sheet_properties_title !== void 0 ? _sheet_properties_title : gid;
-                    sheetId = sheet.properties.sheetId;
+                    // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).
+                    sheetId = (_sheet_properties_sheetId = sheet.properties.sheetId) !== null && _sheet_properties_sheetId !== void 0 ? _sheet_properties_sheetId : 0;
                     sheetUrl = "https://docs.google.com/spreadsheets/d/".concat(id, "/edit#gid=").concat(sheetId);
                     // Build batch update requests
                     batchRequests = [];

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/tools/cells-format.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\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 = google.sheets({ version: 'v4', auth: 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 McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    const sheetId = sheet.properties.sheetId;\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 McpError(ErrorCode.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","google","version","auth","authContext","spreadsheets","get","spreadsheetId","data","find","s","String","properties","McpError","ErrorCode","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/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-format.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\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 = google.sheets({ version: 'v4', auth: 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 McpError(ErrorCode.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 McpError(ErrorCode.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","google","version","auth","authContext","spreadsheets","get","spreadsheetId","data","find","s","String","properties","McpError","ErrorCode","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/chart-create.js

@@ -44,6 +44,7 @@ function _async_to_generator(fn) {
     };
 }
 function _instanceof(left, right) {
+    "@swc/helpers - instanceof";
     if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
         return !!right[Symbol.hasInstance](left);
     } else {
@@ -223,7 +224,7 @@ function parseAnchorCell(anchorCell) {
 }
 function handler(_0, _1) {
     return _async_to_generator(function(param, extra) {
-        var id, gid, chartType, dataRange, title, position, _param_legend, legend, _param_is3D, is3D, logger, _sheet_properties_title, _dataGridRange_sheetId, _spreadsheetResponse_data_sheets, _replies__addChart_chart, _replies__addChart, _replies_, sheets, spreadsheetResponse, sheet, sheetTitle, sheetId, sheetUrl, anchorRowIndex, anchorColumnIndex, anchorIndices, message, dataGridRange, rangeRef, message1, dataStartRowIndex, dataEndRowIndex, dataStartColumnIndex, dataEndColumnIndex, dataSheetId, chartSpec, legendPositionMap, apiLegendPosition, baseSheetId, domainRange, seriesRange, baseSheetId1, domainRange1, numDataColumns, series, i, seriesRange1, basicChart, embeddedObjectPosition, requestBody, response, replies, chartId, result, e, _error_response, _error_response1, _$error, message2;
+        var id, gid, chartType, dataRange, title, position, _param_legend, legend, _param_is3D, is3D, logger, _sheet_properties_title, _sheet_properties_sheetId, _dataGridRange_sheetId, _spreadsheetResponse_data_sheets, _replies__addChart_chart, _replies__addChart, _replies_, sheets, spreadsheetResponse, sheet, sheetTitle, sheetId, sheetUrl, anchorRowIndex, anchorColumnIndex, anchorIndices, message, dataGridRange, rangeRef, message1, dataStartRowIndex, dataEndRowIndex, dataStartColumnIndex, dataEndColumnIndex, dataSheetId, chartSpec, legendPositionMap, apiLegendPosition, baseSheetId, domainRange, seriesRange, baseSheetId1, domainRange1, numDataColumns, series, i, seriesRange1, basicChart, embeddedObjectPosition, requestBody, response, replies, chartId, result, e, _error_response, _error_response1, _$error, message2;
         return _ts_generator(this, function(_state) {
             switch(_state.label){
                 case 0:
@@ -274,7 +275,8 @@ function handler(_0, _1) {
                         throw new _types.McpError(_types.ErrorCode.InvalidParams, "Sheet not found: ".concat(gid));
                     }
                     sheetTitle = (_sheet_properties_title = sheet.properties.title) !== null && _sheet_properties_title !== void 0 ? _sheet_properties_title : gid;
-                    sheetId = sheet.properties.sheetId;
+                    // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).
+                    sheetId = (_sheet_properties_sheetId = sheet.properties.sheetId) !== null && _sheet_properties_sheetId !== void 0 ? _sheet_properties_sheetId : 0;
                     sheetUrl = "https://docs.google.com/spreadsheets/d/".concat(id, "/edit#gid=").concat(sheetId);
                     // Validate 3D only for PIE charts
                     // Note: Google Sheets API only supports 3D for PIE charts, not COLUMN/BAR/LINE

package/dist/cjs/mcp/tools/chart-create.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/tools/chart-create.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// Input schema for chart position\nconst ChartPositionSchema = z.object({\n  anchorCell: z.string().min(1).describe('A1 notation cell where chart top-left anchors (e.g., \"F2\")'),\n  offsetX: z.number().int().default(0).describe('Horizontal pixel offset from anchor'),\n  offsetY: z.number().int().default(0).describe('Vertical pixel offset from anchor'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  chartType: z.enum(['PIE', 'BAR', 'COLUMN', 'LINE']).describe('Type of chart to create'),\n  dataRange: z.string().min(1).describe('A1 notation range containing chart data including headers (e.g., \"A1:C10\")'),\n  title: z.string().optional().describe('Chart title displayed at top'),\n  position: ChartPositionSchema,\n  legend: z.enum(['BOTTOM', 'RIGHT', 'TOP', 'LEFT', 'NONE']).default('BOTTOM').describe('Legend position'),\n  is3D: z.boolean().default(false).describe('Render as 3D chart (PIE only)'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Title of the sheet containing the chart'),\n  sheetUrl: z.string().describe('URL of the sheet containing the chart'),\n  chartId: z.number().int().describe('Unique chart ID for future updates/deletion'),\n  anchorCell: z.string().describe('Where chart was anchored'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Create charts (pie, bar, column, line) from spreadsheet data ranges. Charts anchor to specific cells with optional pixel offsets. Data range should include headers. PIE charts use 2 columns (labels, values). BAR/COLUMN/LINE charts use first row as headers. Best for visualizing spreadsheet data.',\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\n// Parse A1 notation anchor cell to row/column indices\nfunction parseAnchorCell(anchorCell: string): { rowIndex: number; columnIndex: number } {\n  // Simple A1 notation parser for single cells\n  const match = anchorCell.match(/^([A-Z]+)(\\d+)$/);\n  if (!match || !match[1] || !match[2]) {\n    throw new Error(`Invalid anchor cell format: ${anchorCell}`);\n  }\n\n  const colLetters = match[1];\n  const rowNumber = match[2];\n\n  // Convert column letters to index (A=0, B=1, ..., Z=25, AA=26, etc.)\n  let columnIndex = 0;\n  for (let i = 0; i < colLetters.length; i++) {\n    columnIndex = columnIndex * 26 + (colLetters.charCodeAt(i) - 65 + 1);\n  }\n  columnIndex--; // Convert to 0-based\n\n  // Convert row number to index (1-based to 0-based)\n  const rowIndex = Number.parseInt(rowNumber, 10) - 1;\n\n  return { rowIndex, columnIndex };\n}\n\nasync function handler({ id, gid, chartType, dataRange, title, position, legend = 'BOTTOM', is3D = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.chart.create called', {\n    id,\n    gid,\n    chartType,\n    dataRange,\n    title,\n    position,\n    legend,\n    is3D,\n  });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: 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 chart create', { id, gid, chartType });\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    const sheetId = sheet.properties.sheetId;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n    // Validate 3D only for PIE charts\n    // Note: Google Sheets API only supports 3D for PIE charts, not COLUMN/BAR/LINE\n    if (is3D && chartType !== 'PIE') {\n      logger.info('3D mode not supported for this chart type', {\n        chartType,\n        is3D,\n      });\n      throw new McpError(ErrorCode.InvalidParams, `3D mode is only supported for PIE charts, not ${chartType}`);\n    }\n\n    // Parse anchor cell to row/column indices\n    let anchorRowIndex: number;\n    let anchorColumnIndex: number;\n    try {\n      const anchorIndices = parseAnchorCell(position.anchorCell);\n      anchorRowIndex = anchorIndices.rowIndex;\n      anchorColumnIndex = anchorIndices.columnIndex;\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      logger.info('Failed to parse anchor cell', {\n        anchorCell: position.anchorCell,\n        error: message,\n      });\n      throw new McpError(ErrorCode.InvalidParams, `Failed to parse anchor cell: ${message}`);\n    }\n\n    // Parse data range to grid range\n    let dataGridRange: sheets_v4.Schema$GridRange;\n    try {\n      const rangeRef = parseA1Notation(dataRange);\n      dataGridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n      // Validate that required properties are defined for chart creation\n      if (dataGridRange.startColumnIndex === undefined || dataGridRange.startColumnIndex === null) {\n        throw new Error('Data range must include column information');\n      }\n      if (dataGridRange.endColumnIndex === undefined || dataGridRange.endColumnIndex === null) {\n        throw new Error('Data range must include column information');\n      }\n      if (dataGridRange.startRowIndex === undefined || dataGridRange.startRowIndex === null) {\n        throw new Error('Data range must include row information');\n      }\n      if (dataGridRange.endRowIndex === undefined || dataGridRange.endRowIndex === null) {\n        throw new Error('Data range must include row information');\n      }\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      logger.info('Failed to parse data range', {\n        dataRange,\n        error: message,\n      });\n      throw new McpError(ErrorCode.InvalidParams, `Failed to parse data range: ${message}`);\n    }\n\n    // Extract validated properties with defined types\n    const dataStartRowIndex = dataGridRange.startRowIndex as number;\n    const dataEndRowIndex = dataGridRange.endRowIndex as number;\n    const dataStartColumnIndex = dataGridRange.startColumnIndex as number;\n    const dataEndColumnIndex = dataGridRange.endColumnIndex as number;\n    const dataSheetId = dataGridRange.sheetId ?? sheetId;\n\n    // Build chart spec with properly split domain and series ranges\n    let chartSpec: sheets_v4.Schema$ChartSpec;\n\n    logger.info('Building chart spec', {\n      chartType,\n      dataGridRange,\n      sheetId,\n    });\n\n    // Map legend position to API format (add _LEGEND suffix)\n    const legendPositionMap: Record<string, string> = {\n      BOTTOM: 'BOTTOM_LEGEND',\n      RIGHT: 'RIGHT_LEGEND',\n      TOP: 'TOP_LEGEND',\n      LEFT: 'LEFT_LEGEND',\n      NONE: 'NO_LEGEND',\n    };\n    const apiLegendPosition = legendPositionMap[legend] || 'BOTTOM_LEGEND';\n\n    if (chartType === 'PIE') {\n      // PIE charts use a separate pieChart property, not basicChart\n      const baseSheetId = dataSheetId;\n\n      const domainRange = {\n        sheetId: baseSheetId,\n        startRowIndex: dataStartRowIndex,\n        endRowIndex: dataEndRowIndex,\n        startColumnIndex: dataStartColumnIndex,\n        endColumnIndex: dataStartColumnIndex + 1, // First column only (labels)\n      };\n\n      const seriesRange = {\n        sheetId: baseSheetId,\n        startRowIndex: dataStartRowIndex,\n        endRowIndex: dataEndRowIndex,\n        startColumnIndex: dataStartColumnIndex + 1, // Second column (values)\n        endColumnIndex: dataStartColumnIndex + 2,\n      };\n\n      logger.info('PIE chart ranges', {\n        dataGridRange,\n        domainRange,\n        seriesRange,\n        apiLegendPosition,\n      });\n\n      chartSpec = {\n        pieChart: {\n          // Use pieChart for PIE charts\n          legendPosition: legend === 'NONE' ? 'NO_LEGEND' : apiLegendPosition,\n          domain: {\n            // Note: domain/series are direct objects, not arrays\n            sourceRange: {\n              sources: [domainRange],\n            },\n          },\n          series: {\n            sourceRange: {\n              sources: [seriesRange],\n            },\n          },\n          threeDimensional: is3D, // 3D is directly on pieChart\n        },\n      };\n      if (title) {\n        chartSpec.title = title;\n      }\n    } else {\n      // For BAR, COLUMN, LINE charts: domain is first column, each subsequent column is a series\n      const baseSheetId = dataSheetId;\n\n      const domainRange = {\n        sheetId: baseSheetId,\n        startRowIndex: dataStartRowIndex,\n        endRowIndex: dataEndRowIndex,\n        startColumnIndex: dataStartColumnIndex,\n        endColumnIndex: dataStartColumnIndex + 1, // First column only\n      };\n\n      // Calculate number of data columns (excluding the first domain column)\n      const numDataColumns = dataEndColumnIndex - dataStartColumnIndex - 1;\n      const series = [];\n\n      // Create a series for each data column\n      for (let i = 0; i < numDataColumns; i++) {\n        const seriesRange = {\n          sheetId: baseSheetId,\n          startRowIndex: dataStartRowIndex,\n          endRowIndex: dataEndRowIndex,\n          startColumnIndex: dataStartColumnIndex + 1 + i,\n          endColumnIndex: dataStartColumnIndex + 2 + i,\n        };\n\n        series.push({\n          series: {\n            sourceRange: {\n              sources: [seriesRange],\n            },\n          },\n        });\n      }\n\n      // If no data columns were found, default to using the entire range as a fallback\n      if (series.length === 0) {\n        series.push({\n          series: {\n            sourceRange: {\n              sources: [dataGridRange],\n            },\n          },\n        });\n      }\n\n      const basicChart: sheets_v4.Schema$BasicChartSpec = {\n        chartType, // BAR, COLUMN, LINE are valid for basicChart\n        headerCount: 1, // First row is headers\n        // Note: Google Sheets API does not support threeDimensional for basicChart (BAR/COLUMN/LINE)\n        // threeDimensional is only supported for pieChart\n        domains: [\n          {\n            domain: {\n              sourceRange: {\n                sources: [domainRange],\n              },\n            },\n          },\n        ],\n        series,\n      };\n      if (legend !== 'NONE') {\n        basicChart.legendPosition = apiLegendPosition;\n      }\n\n      chartSpec = { basicChart };\n      if (title) {\n        chartSpec.title = title;\n      }\n    }\n\n    // Build embedded object position\n    const embeddedObjectPosition = {\n      overlayPosition: {\n        anchorCell: {\n          sheetId,\n          rowIndex: anchorRowIndex,\n          columnIndex: anchorColumnIndex,\n        },\n        offsetXPixels: position.offsetX,\n        offsetYPixels: position.offsetY,\n      },\n    };\n\n    const requestBody = {\n      requests: [\n        {\n          addChart: {\n            chart: {\n              spec: chartSpec,\n              position: embeddedObjectPosition,\n            },\n          },\n        },\n      ],\n    };\n\n    logger.info('sheets.chart.create executing addChart request', {\n      spreadsheetId: id,\n      sheetTitle,\n      chartType,\n      dataRange,\n      anchorCell: position.anchorCell,\n      requestBody: JSON.stringify(requestBody),\n    });\n\n    // Execute the addChart request\n    const response = await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody,\n    });\n\n    // Extract chart ID from response\n    const replies = response.data.replies || [];\n    if (replies.length === 0 || !replies[0]?.addChart?.chart?.chartId) {\n      logger.error('Chart creation failed - no chart ID returned', {\n        spreadsheetId: id,\n        sheetTitle,\n        chartType,\n      });\n      throw new McpError(ErrorCode.InternalError, 'Chart creation failed: no chart ID returned from Google Sheets API');\n    }\n\n    const chartId = replies[0].addChart.chart.chartId;\n\n    logger.info('sheets.chart.create completed successfully', {\n      chartId,\n      chartType,\n      anchorCell: position.anchorCell,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      sheetTitle,\n      sheetUrl,\n      chartId,\n      anchorCell: position.anchorCell,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (e) {\n    const error = e as Error & { response?: { data?: unknown; status?: number } };\n    const message = error.message || String(e);\n    logger.error('Chart create operation failed', {\n      id,\n      gid,\n      chartType,\n      dataRange,\n      error: message,\n      response: error.response?.data,\n      status: error.response?.status,\n    });\n\n    throw new McpError(ErrorCode.InternalError, `Error creating chart: ${message}`, {\n      stack: e instanceof Error ? e.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'chart-create',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","ChartPositionSchema","z","object","anchorCell","string","min","describe","offsetX","number","int","default","offsetY","inputSchema","id","SpreadsheetIdSchema","gid","SheetGidSchema","chartType","enum","dataRange","title","optional","position","legend","is3D","boolean","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","sheetTitle","sheetUrl","chartId","outputSchema","discriminatedUnion","config","description","result","parseAnchorCell","match","Error","colLetters","rowNumber","columnIndex","i","length","charCodeAt","rowIndex","Number","parseInt","handler","extra","logger","sheet","dataGridRange","spreadsheetResponse","replies","sheets","sheetId","anchorRowIndex","anchorColumnIndex","anchorIndices","message","rangeRef","dataStartRowIndex","dataEndRowIndex","dataStartColumnIndex","dataEndColumnIndex","dataSheetId","chartSpec","legendPositionMap","apiLegendPosition","baseSheetId","domainRange","seriesRange","numDataColumns","series","basicChart","embeddedObjectPosition","requestBody","response","e","error","info","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","McpError","ErrorCode","InvalidParams","parseA1Notation","rangeReferenceToGridRange","startColumnIndex","undefined","endColumnIndex","startRowIndex","endRowIndex","BOTTOM","RIGHT","TOP","LEFT","NONE","pieChart","legendPosition","domain","sourceRange","sources","threeDimensional","push","headerCount","domains","overlayPosition","offsetXPixels","offsetYPixels","requests","addChart","chart","spec","JSON","stringify","batchUpdate","InternalError","content","text","structuredContent","status","stack","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/chart-create.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// Input schema for chart position\nconst ChartPositionSchema = z.object({\n  anchorCell: z.string().min(1).describe('A1 notation cell where chart top-left anchors (e.g., \"F2\")'),\n  offsetX: z.number().int().default(0).describe('Horizontal pixel offset from anchor'),\n  offsetY: z.number().int().default(0).describe('Vertical pixel offset from anchor'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  chartType: z.enum(['PIE', 'BAR', 'COLUMN', 'LINE']).describe('Type of chart to create'),\n  dataRange: z.string().min(1).describe('A1 notation range containing chart data including headers (e.g., \"A1:C10\")'),\n  title: z.string().optional().describe('Chart title displayed at top'),\n  position: ChartPositionSchema,\n  legend: z.enum(['BOTTOM', 'RIGHT', 'TOP', 'LEFT', 'NONE']).default('BOTTOM').describe('Legend position'),\n  is3D: z.boolean().default(false).describe('Render as 3D chart (PIE only)'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Title of the sheet containing the chart'),\n  sheetUrl: z.string().describe('URL of the sheet containing the chart'),\n  chartId: z.number().int().describe('Unique chart ID for future updates/deletion'),\n  anchorCell: z.string().describe('Where chart was anchored'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Create charts (pie, bar, column, line) from spreadsheet data ranges. Charts anchor to specific cells with optional pixel offsets. Data range should include headers. PIE charts use 2 columns (labels, values). BAR/COLUMN/LINE charts use first row as headers. Best for visualizing spreadsheet data.',\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\n// Parse A1 notation anchor cell to row/column indices\nfunction parseAnchorCell(anchorCell: string): { rowIndex: number; columnIndex: number } {\n  // Simple A1 notation parser for single cells\n  const match = anchorCell.match(/^([A-Z]+)(\\d+)$/);\n  if (!match || !match[1] || !match[2]) {\n    throw new Error(`Invalid anchor cell format: ${anchorCell}`);\n  }\n\n  const colLetters = match[1];\n  const rowNumber = match[2];\n\n  // Convert column letters to index (A=0, B=1, ..., Z=25, AA=26, etc.)\n  let columnIndex = 0;\n  for (let i = 0; i < colLetters.length; i++) {\n    columnIndex = columnIndex * 26 + (colLetters.charCodeAt(i) - 65 + 1);\n  }\n  columnIndex--; // Convert to 0-based\n\n  // Convert row number to index (1-based to 0-based)\n  const rowIndex = Number.parseInt(rowNumber, 10) - 1;\n\n  return { rowIndex, columnIndex };\n}\n\nasync function handler({ id, gid, chartType, dataRange, title, position, legend = 'BOTTOM', is3D = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.chart.create called', {\n    id,\n    gid,\n    chartType,\n    dataRange,\n    title,\n    position,\n    legend,\n    is3D,\n  });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: 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 chart create', { id, gid, chartType });\n      throw new McpError(ErrorCode.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    // Validate 3D only for PIE charts\n    // Note: Google Sheets API only supports 3D for PIE charts, not COLUMN/BAR/LINE\n    if (is3D && chartType !== 'PIE') {\n      logger.info('3D mode not supported for this chart type', {\n        chartType,\n        is3D,\n      });\n      throw new McpError(ErrorCode.InvalidParams, `3D mode is only supported for PIE charts, not ${chartType}`);\n    }\n\n    // Parse anchor cell to row/column indices\n    let anchorRowIndex: number;\n    let anchorColumnIndex: number;\n    try {\n      const anchorIndices = parseAnchorCell(position.anchorCell);\n      anchorRowIndex = anchorIndices.rowIndex;\n      anchorColumnIndex = anchorIndices.columnIndex;\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      logger.info('Failed to parse anchor cell', {\n        anchorCell: position.anchorCell,\n        error: message,\n      });\n      throw new McpError(ErrorCode.InvalidParams, `Failed to parse anchor cell: ${message}`);\n    }\n\n    // Parse data range to grid range\n    let dataGridRange: sheets_v4.Schema$GridRange;\n    try {\n      const rangeRef = parseA1Notation(dataRange);\n      dataGridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n      // Validate that required properties are defined for chart creation\n      if (dataGridRange.startColumnIndex === undefined || dataGridRange.startColumnIndex === null) {\n        throw new Error('Data range must include column information');\n      }\n      if (dataGridRange.endColumnIndex === undefined || dataGridRange.endColumnIndex === null) {\n        throw new Error('Data range must include column information');\n      }\n      if (dataGridRange.startRowIndex === undefined || dataGridRange.startRowIndex === null) {\n        throw new Error('Data range must include row information');\n      }\n      if (dataGridRange.endRowIndex === undefined || dataGridRange.endRowIndex === null) {\n        throw new Error('Data range must include row information');\n      }\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      logger.info('Failed to parse data range', {\n        dataRange,\n        error: message,\n      });\n      throw new McpError(ErrorCode.InvalidParams, `Failed to parse data range: ${message}`);\n    }\n\n    // Extract validated properties with defined types\n    const dataStartRowIndex = dataGridRange.startRowIndex as number;\n    const dataEndRowIndex = dataGridRange.endRowIndex as number;\n    const dataStartColumnIndex = dataGridRange.startColumnIndex as number;\n    const dataEndColumnIndex = dataGridRange.endColumnIndex as number;\n    const dataSheetId = dataGridRange.sheetId ?? sheetId;\n\n    // Build chart spec with properly split domain and series ranges\n    let chartSpec: sheets_v4.Schema$ChartSpec;\n\n    logger.info('Building chart spec', {\n      chartType,\n      dataGridRange,\n      sheetId,\n    });\n\n    // Map legend position to API format (add _LEGEND suffix)\n    const legendPositionMap: Record<string, string> = {\n      BOTTOM: 'BOTTOM_LEGEND',\n      RIGHT: 'RIGHT_LEGEND',\n      TOP: 'TOP_LEGEND',\n      LEFT: 'LEFT_LEGEND',\n      NONE: 'NO_LEGEND',\n    };\n    const apiLegendPosition = legendPositionMap[legend] || 'BOTTOM_LEGEND';\n\n    if (chartType === 'PIE') {\n      // PIE charts use a separate pieChart property, not basicChart\n      const baseSheetId = dataSheetId;\n\n      const domainRange = {\n        sheetId: baseSheetId,\n        startRowIndex: dataStartRowIndex,\n        endRowIndex: dataEndRowIndex,\n        startColumnIndex: dataStartColumnIndex,\n        endColumnIndex: dataStartColumnIndex + 1, // First column only (labels)\n      };\n\n      const seriesRange = {\n        sheetId: baseSheetId,\n        startRowIndex: dataStartRowIndex,\n        endRowIndex: dataEndRowIndex,\n        startColumnIndex: dataStartColumnIndex + 1, // Second column (values)\n        endColumnIndex: dataStartColumnIndex + 2,\n      };\n\n      logger.info('PIE chart ranges', {\n        dataGridRange,\n        domainRange,\n        seriesRange,\n        apiLegendPosition,\n      });\n\n      chartSpec = {\n        pieChart: {\n          // Use pieChart for PIE charts\n          legendPosition: legend === 'NONE' ? 'NO_LEGEND' : apiLegendPosition,\n          domain: {\n            // Note: domain/series are direct objects, not arrays\n            sourceRange: {\n              sources: [domainRange],\n            },\n          },\n          series: {\n            sourceRange: {\n              sources: [seriesRange],\n            },\n          },\n          threeDimensional: is3D, // 3D is directly on pieChart\n        },\n      };\n      if (title) {\n        chartSpec.title = title;\n      }\n    } else {\n      // For BAR, COLUMN, LINE charts: domain is first column, each subsequent column is a series\n      const baseSheetId = dataSheetId;\n\n      const domainRange = {\n        sheetId: baseSheetId,\n        startRowIndex: dataStartRowIndex,\n        endRowIndex: dataEndRowIndex,\n        startColumnIndex: dataStartColumnIndex,\n        endColumnIndex: dataStartColumnIndex + 1, // First column only\n      };\n\n      // Calculate number of data columns (excluding the first domain column)\n      const numDataColumns = dataEndColumnIndex - dataStartColumnIndex - 1;\n      const series = [];\n\n      // Create a series for each data column\n      for (let i = 0; i < numDataColumns; i++) {\n        const seriesRange = {\n          sheetId: baseSheetId,\n          startRowIndex: dataStartRowIndex,\n          endRowIndex: dataEndRowIndex,\n          startColumnIndex: dataStartColumnIndex + 1 + i,\n          endColumnIndex: dataStartColumnIndex + 2 + i,\n        };\n\n        series.push({\n          series: {\n            sourceRange: {\n              sources: [seriesRange],\n            },\n          },\n        });\n      }\n\n      // If no data columns were found, default to using the entire range as a fallback\n      if (series.length === 0) {\n        series.push({\n          series: {\n            sourceRange: {\n              sources: [dataGridRange],\n            },\n          },\n        });\n      }\n\n      const basicChart: sheets_v4.Schema$BasicChartSpec = {\n        chartType, // BAR, COLUMN, LINE are valid for basicChart\n        headerCount: 1, // First row is headers\n        // Note: Google Sheets API does not support threeDimensional for basicChart (BAR/COLUMN/LINE)\n        // threeDimensional is only supported for pieChart\n        domains: [\n          {\n            domain: {\n              sourceRange: {\n                sources: [domainRange],\n              },\n            },\n          },\n        ],\n        series,\n      };\n      if (legend !== 'NONE') {\n        basicChart.legendPosition = apiLegendPosition;\n      }\n\n      chartSpec = { basicChart };\n      if (title) {\n        chartSpec.title = title;\n      }\n    }\n\n    // Build embedded object position\n    const embeddedObjectPosition = {\n      overlayPosition: {\n        anchorCell: {\n          sheetId,\n          rowIndex: anchorRowIndex,\n          columnIndex: anchorColumnIndex,\n        },\n        offsetXPixels: position.offsetX,\n        offsetYPixels: position.offsetY,\n      },\n    };\n\n    const requestBody = {\n      requests: [\n        {\n          addChart: {\n            chart: {\n              spec: chartSpec,\n              position: embeddedObjectPosition,\n            },\n          },\n        },\n      ],\n    };\n\n    logger.info('sheets.chart.create executing addChart request', {\n      spreadsheetId: id,\n      sheetTitle,\n      chartType,\n      dataRange,\n      anchorCell: position.anchorCell,\n      requestBody: JSON.stringify(requestBody),\n    });\n\n    // Execute the addChart request\n    const response = await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody,\n    });\n\n    // Extract chart ID from response\n    const replies = response.data.replies || [];\n    if (replies.length === 0 || !replies[0]?.addChart?.chart?.chartId) {\n      logger.error('Chart creation failed - no chart ID returned', {\n        spreadsheetId: id,\n        sheetTitle,\n        chartType,\n      });\n      throw new McpError(ErrorCode.InternalError, 'Chart creation failed: no chart ID returned from Google Sheets API');\n    }\n\n    const chartId = replies[0].addChart.chart.chartId;\n\n    logger.info('sheets.chart.create completed successfully', {\n      chartId,\n      chartType,\n      anchorCell: position.anchorCell,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      sheetTitle,\n      sheetUrl,\n      chartId,\n      anchorCell: position.anchorCell,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (e) {\n    const error = e as Error & { response?: { data?: unknown; status?: number } };\n    const message = error.message || String(e);\n    logger.error('Chart create operation failed', {\n      id,\n      gid,\n      chartType,\n      dataRange,\n      error: message,\n      response: error.response?.data,\n      status: error.response?.status,\n    });\n\n    throw new McpError(ErrorCode.InternalError, `Error creating chart: ${message}`, {\n      stack: e instanceof Error ? e.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'chart-create',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","ChartPositionSchema","z","object","anchorCell","string","min","describe","offsetX","number","int","default","offsetY","inputSchema","id","SpreadsheetIdSchema","gid","SheetGidSchema","chartType","enum","dataRange","title","optional","position","legend","is3D","boolean","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","sheetTitle","sheetUrl","chartId","outputSchema","discriminatedUnion","config","description","result","parseAnchorCell","match","Error","colLetters","rowNumber","columnIndex","i","length","charCodeAt","rowIndex","Number","parseInt","handler","extra","logger","sheet","dataGridRange","spreadsheetResponse","replies","sheets","sheetId","anchorRowIndex","anchorColumnIndex","anchorIndices","message","rangeRef","dataStartRowIndex","dataEndRowIndex","dataStartColumnIndex","dataEndColumnIndex","dataSheetId","chartSpec","legendPositionMap","apiLegendPosition","baseSheetId","domainRange","seriesRange","numDataColumns","series","basicChart","embeddedObjectPosition","requestBody","response","e","error","info","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","McpError","ErrorCode","InvalidParams","parseA1Notation","rangeReferenceToGridRange","startColumnIndex","undefined","endColumnIndex","startRowIndex","endRowIndex","BOTTOM","RIGHT","TOP","LEFT","NONE","pieChart","legendPosition","domain","sourceRange","sources","threeDimensional","push","headerCount","domains","overlayPosition","offsetXPixels","offsetYPixels","requests","addChart","chart","spec","JSON","stringify","batchUpdate","InternalError","content","text","structuredContent","status","stack","name"],"mappings":"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"}

package/dist/cjs/mcp/tools/columns-get.js

@@ -43,6 +43,7 @@ function _async_to_generator(fn) {
     };
 }
 function _instanceof(left, right) {
+    "@swc/helpers - instanceof";
     if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
         return !!right[Symbol.hasInstance](left);
     } else {

package/dist/cjs/mcp/tools/columns-get.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/tools/columns-get.ts"],"sourcesContent":["/** Get column names from Google Sheet (peek at first row only) */\n\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n});\n\n// Success branch schema - uses columns: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  columns: z.array(z.string()).describe('First row values (column names) or empty if no rows'),\n  isEmpty: z.boolean().describe('True if sheet has zero rows'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Get first row from Google Sheet. Returns columns array and isEmpty flag.',\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, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.debug?.('sheets.columns.get called', { id, gid, render });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: 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      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? '';\n\n    // Read first row only (A1:ZZZ1 should cover most reasonable sheets)\n    const range = `'${sheetTitle}'!A1:ZZZ1`;\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n\n    const rows = response.data.values || [];\n    const isEmpty = rows.length === 0;\n\n    // Extract first row and convert to strings (column names)\n    const firstRow = rows[0] || [];\n    const columns = firstRow.map((value) => String(value ?? ''));\n\n    const result: Output = {\n      type: 'success' as const,\n      columns,\n      isEmpty,\n    };\n\n    logger.info?.('sheets.columns.get completed', { id, gid, columnCount: columns.length, isEmpty });\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?.('sheets.columns.get error', { error: message });\n    throw new McpError(ErrorCode.InternalError, `Error getting sheet columns: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'columns-get',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","render","enum","optional","describe","successBranchSchema","type","literal","columns","array","string","isEmpty","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","sheet","spreadsheetResponse","sheets","sheetTitle","range","response","rows","firstRow","error","message","debug","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","McpError","ErrorCode","InvalidParams","title","values","valueRenderOption","length","map","value","info","columnCount","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","undefined","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-get.ts"],"sourcesContent":["/** Get column names from Google Sheet (peek at first row only) */\n\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n});\n\n// Success branch schema - uses columns: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  columns: z.array(z.string()).describe('First row values (column names) or empty if no rows'),\n  isEmpty: z.boolean().describe('True if sheet has zero rows'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Get first row from Google Sheet. Returns columns array and isEmpty flag.',\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, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.debug?.('sheets.columns.get called', { id, gid, render });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: 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      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? '';\n\n    // Read first row only (A1:ZZZ1 should cover most reasonable sheets)\n    const range = `'${sheetTitle}'!A1:ZZZ1`;\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n\n    const rows = response.data.values || [];\n    const isEmpty = rows.length === 0;\n\n    // Extract first row and convert to strings (column names)\n    const firstRow = rows[0] || [];\n    const columns = firstRow.map((value) => String(value ?? ''));\n\n    const result: Output = {\n      type: 'success' as const,\n      columns,\n      isEmpty,\n    };\n\n    logger.info?.('sheets.columns.get completed', { id, gid, columnCount: columns.length, isEmpty });\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?.('sheets.columns.get error', { error: message });\n    throw new McpError(ErrorCode.InternalError, `Error getting sheet columns: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'columns-get',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","render","enum","optional","describe","successBranchSchema","type","literal","columns","array","string","isEmpty","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","sheet","spreadsheetResponse","sheets","sheetTitle","range","response","rows","firstRow","error","message","debug","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","McpError","ErrorCode","InvalidParams","title","values","valueRenderOption","length","map","value","info","columnCount","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","undefined","name"],"mappings":"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"}

package/dist/cjs/mcp/tools/columns-update.js

@@ -44,6 +44,7 @@ function _async_to_generator(fn) {
     };
 }
 function _instanceof(left, right) {
+    "@swc/helpers - instanceof";
     if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
         return !!right[Symbol.hasInstance](left);
     } else {