@mcp-z/mcp-sheets 1.2.2 → 2.0.0

package/dist/cjs/setup/http.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/setup/http.ts"],"sourcesContent":["import { composeMiddleware, connectHttp, registerPrompts, registerResources, registerTools } from '@mcp-z/server';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport cors from 'cors';\nimport express from 'express';\nimport type { RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createDefaultRuntime } from './runtime.ts';\n\nexport async function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides) {\n  const runtime = await createDefaultRuntime(config, overrides);\n  const modules = runtime.createDomainModules();\n  const layers = runtime.middlewareFactories.map((factory) => factory(runtime.deps));\n  const composed = composeMiddleware(modules, layers);\n  const logger = runtime.deps.logger;\n  const port = config.transport.port;\n  if (!port) throw new Error('Port is required for HTTP transport');\n\n  const tools = [...composed.tools, ...runtime.deps.oauthAdapters.accountTools];\n  const prompts = [...composed.prompts, ...runtime.deps.oauthAdapters.accountPrompts];\n\n  const mcpServer = new McpServer({ name: config.name, version: config.version });\n  registerTools(mcpServer, tools);\n  registerResources(mcpServer, composed.resources);\n  registerPrompts(mcpServer, prompts);\n\n  const app = express();\n  app.use(cors());\n  app.use(express.json({ limit: '10mb' }));\n\n  if (runtime.deps.oauthAdapters.loopbackRouter) {\n    app.use('/', runtime.deps.oauthAdapters.loopbackRouter);\n    logger.info('Mounted loopback OAuth callback router');\n  }\n\n  if (runtime.deps.oauthAdapters.dcrRouter) {\n    app.use('/', runtime.deps.oauthAdapters.dcrRouter);\n    logger.info('Mounted DCR router with OAuth endpoints');\n  }\n\n  logger.info(`Starting ${config.name} MCP server (http)`);\n  const { close, httpServer } = await connectHttp(mcpServer, { logger, app, port });\n  logger.info('http transport ready');\n\n  return {\n    httpServer,\n    mcpServer,\n    logger,\n    close: async () => {\n      await close();\n      await runtime.close();\n    },\n  };\n}\n"],"names":["createHTTPServer","config","overrides","runtime","modules","layers","composed","logger","port","tools","prompts","mcpServer","app","close","httpServer","createDefaultRuntime","createDomainModules","middlewareFactories","map","factory","deps","composeMiddleware","transport","Error","oauthAdapters","accountTools","accountPrompts","McpServer","name","version","registerTools","registerResources","resources","registerPrompts","express","use","cors","json","limit","loopbackRouter","info","dcrRouter","connectHttp"],"mappings":";;;;+BAOsBA;;;eAAAA;;;sBAP4E;mBACxE;2DACT;8DACG;yBAEiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE9B,SAAeA,iBAAiBC,MAAoB,EAAEC,SAA4B;;YACjFC,SACAC,SACAC,QACAC,UACAC,QACAC,MAGAC,OACAC,SAEAC,WAKAC,KAewB,MAAtBC,OAAOC;;;;oBA/BC;;wBAAMC,IAAAA,+BAAoB,EAACd,QAAQC;;;oBAA7CC,UAAU;oBACVC,UAAUD,QAAQa,mBAAmB;oBACrCX,SAASF,QAAQc,mBAAmB,CAACC,GAAG,CAAC,SAACC;+BAAYA,QAAQhB,QAAQiB,IAAI;;oBAC1Ed,WAAWe,IAAAA,yBAAiB,EAACjB,SAASC;oBACtCE,SAASJ,QAAQiB,IAAI,CAACb,MAAM;oBAC5BC,OAAOP,OAAOqB,SAAS,CAACd,IAAI;oBAClC,IAAI,CAACA,MAAM,MAAM,IAAIe,MAAM;oBAErBd,QAAQ,AAAC,qBAAGH,SAASG,KAAK,SAAE,qBAAGN,QAAQiB,IAAI,CAACI,aAAa,CAACC,YAAY;oBACtEf,UAAU,AAAC,qBAAGJ,SAASI,OAAO,SAAE,qBAAGP,QAAQiB,IAAI,CAACI,aAAa,CAACE,cAAc;oBAE5Ef,YAAY,IAAIgB,cAAS,CAAC;wBAAEC,MAAM3B,OAAO2B,IAAI;wBAAEC,SAAS5B,OAAO4B,OAAO;oBAAC;oBAC7EC,IAAAA,qBAAa,EAACnB,WAAWF;oBACzBsB,IAAAA,yBAAiB,EAACpB,WAAWL,SAAS0B,SAAS;oBAC/CC,IAAAA,uBAAe,EAACtB,WAAWD;oBAErBE,MAAMsB,IAAAA,gBAAO;oBACnBtB,IAAIuB,GAAG,CAACC,IAAAA,aAAI;oBACZxB,IAAIuB,GAAG,CAACD,gBAAO,CAACG,IAAI,CAAC;wBAAEC,OAAO;oBAAO;oBAErC,IAAInC,QAAQiB,IAAI,CAACI,aAAa,CAACe,cAAc,EAAE;wBAC7C3B,IAAIuB,GAAG,CAAC,KAAKhC,QAAQiB,IAAI,CAACI,aAAa,CAACe,cAAc;wBACtDhC,OAAOiC,IAAI,CAAC;oBACd;oBAEA,IAAIrC,QAAQiB,IAAI,CAACI,aAAa,CAACiB,SAAS,EAAE;wBACxC7B,IAAIuB,GAAG,CAAC,KAAKhC,QAAQiB,IAAI,CAACI,aAAa,CAACiB,SAAS;wBACjDlC,OAAOiC,IAAI,CAAC;oBACd;oBAEAjC,OAAOiC,IAAI,CAAC,AAAC,YAAuB,OAAZvC,OAAO2B,IAAI,EAAC;oBACN;;wBAAMc,IAAAA,mBAAW,EAAC/B,WAAW;4BAAEJ,QAAAA;4BAAQK,KAAAA;4BAAKJ,MAAAA;wBAAK;;;oBAAjD,OAAA,eAAtBK,QAAsB,KAAtBA,OAAOC,aAAe,KAAfA;oBACfP,OAAOiC,IAAI,CAAC;oBAEZ;;wBAAO;4BACL1B,YAAAA;4BACAH,WAAAA;4BACAJ,QAAAA;4BACAM,OAAO,SAAPA;;;;;gDACE;;oDAAMA;;;gDAAN;gDACA;;oDAAMV,QAAQU,KAAK;;;gDAAnB;;;;;;gCACF;;wBACF;;;;IACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/setup/http.ts"],"sourcesContent":["import { composeMiddleware, connectHttp, McpServer, registerPrompts, registerResources, registerTools } from '@mcp-z/server';\nimport cors from 'cors';\nimport express from 'express';\nimport type { RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createDefaultRuntime } from './runtime.ts';\n\nexport async function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides) {\n  const runtime = await createDefaultRuntime(config, overrides);\n  const modules = runtime.createDomainModules();\n  const layers = runtime.middlewareFactories.map((factory) => factory(runtime.deps));\n  const composed = composeMiddleware(modules, layers);\n  const logger = runtime.deps.logger;\n  const port = config.transport.port;\n  if (!port) throw new Error('Port is required for HTTP transport');\n\n  const tools = [...composed.tools, ...runtime.deps.oauthAdapters.accountTools];\n  const prompts = [...composed.prompts, ...runtime.deps.oauthAdapters.accountPrompts];\n\n  const mcpServer = new McpServer({ name: config.name, version: config.version });\n  registerTools(mcpServer, tools);\n  registerResources(mcpServer, composed.resources);\n  registerPrompts(mcpServer, prompts);\n\n  const app = express();\n  app.use(express.json({ limit: '10mb' }));\n\n  // Must mount '/mcp' before any permissive app-level cors(), or that layer answers its\n  // preflight first; pass baseUrl's origin/host below or a public deployment 403s itself.\n  const publicUrl = config.baseUrl ? new URL(config.baseUrl) : undefined;\n  logger.info(`Starting ${config.name} MCP server (http)`);\n  const { close, httpServer } = await connectHttp(mcpServer, {\n    logger,\n    app,\n    port,\n    allowedOrigins: publicUrl ? [publicUrl.origin] : undefined,\n    allowedHosts: publicUrl ? [publicUrl.host] : undefined,\n  });\n\n  // The loopback OAuth callback and the DCR discovery/registration endpoints are\n  // meant to be reached from a browser on another origin. Keep cors() for them,\n  // scoped to their own routes - never in front of '/mcp'.\n  if (runtime.deps.oauthAdapters.loopbackRouter) {\n    app.use('/', cors(), runtime.deps.oauthAdapters.loopbackRouter);\n    logger.info('Mounted loopback OAuth callback router');\n  }\n\n  if (runtime.deps.oauthAdapters.dcrRouter) {\n    app.use('/', cors(), runtime.deps.oauthAdapters.dcrRouter);\n    logger.info('Mounted DCR router with OAuth endpoints');\n  }\n\n  logger.info('http transport ready');\n\n  return {\n    httpServer,\n    mcpServer,\n    logger,\n    close: async () => {\n      await close();\n      await runtime.close();\n    },\n  };\n}\n"],"names":["createHTTPServer","config","overrides","runtime","modules","layers","composed","logger","port","tools","prompts","mcpServer","app","publicUrl","close","httpServer","createDefaultRuntime","createDomainModules","middlewareFactories","map","factory","deps","composeMiddleware","transport","Error","oauthAdapters","accountTools","accountPrompts","McpServer","name","version","registerTools","registerResources","resources","registerPrompts","express","use","json","limit","baseUrl","URL","undefined","info","connectHttp","allowedOrigins","origin","allowedHosts","host","loopbackRouter","cors","dcrRouter"],"mappings":"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"}

package/dist/cjs/setup/stdio.d.cts

@@ -1,4 +1,4 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { McpServer } from '@mcp-z/server';
 import type { RuntimeOverrides, ServerConfig } from '../types.js';
 export declare function createStdioServer(config: ServerConfig, overrides?: RuntimeOverrides): Promise<{
     mcpServer: McpServer;

package/dist/cjs/setup/stdio.d.ts

@@ -1,4 +1,4 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { McpServer } from '@mcp-z/server';
 import type { RuntimeOverrides, ServerConfig } from '../types.js';
 export declare function createStdioServer(config: ServerConfig, overrides?: RuntimeOverrides): Promise<{
     mcpServer: McpServer;

package/dist/cjs/setup/stdio.js

@@ -9,7 +9,6 @@ Object.defineProperty(exports, "createStdioServer", {
     }
 });
 var _server = require("@mcp-z/server");
-var _mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var _runtimets = require("./runtime.js");
 function _array_like_to_array(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
@@ -183,7 +182,7 @@ function createStdioServer(config, overrides) {
                     logger = runtime.deps.logger;
                     tools = _to_consumable_array(composed.tools).concat(_to_consumable_array(runtime.deps.oauthAdapters.accountTools));
                     prompts = _to_consumable_array(composed.prompts).concat(_to_consumable_array(runtime.deps.oauthAdapters.accountPrompts));
-                    mcpServer = new _mcp.McpServer({
+                    mcpServer = new _server.McpServer({
                         name: config.name,
                         version: config.version
                     });

package/dist/cjs/setup/stdio.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/setup/stdio.ts"],"sourcesContent":["import { composeMiddleware, connectStdio, registerPrompts, registerResources, registerTools } from '@mcp-z/server';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createDefaultRuntime } from './runtime.ts';\n\nexport async function createStdioServer(config: ServerConfig, overrides?: RuntimeOverrides) {\n  const runtime = await createDefaultRuntime(config, overrides);\n  const modules = runtime.createDomainModules();\n  const layers = runtime.middlewareFactories.map((factory) => factory(runtime.deps));\n  const composed = composeMiddleware(modules, layers);\n  const logger = runtime.deps.logger;\n\n  const tools = [...composed.tools, ...runtime.deps.oauthAdapters.accountTools];\n  const prompts = [...composed.prompts, ...runtime.deps.oauthAdapters.accountPrompts];\n\n  const mcpServer = new McpServer({ name: config.name, version: config.version });\n  registerTools(mcpServer, tools);\n  registerResources(mcpServer, composed.resources);\n  registerPrompts(mcpServer, prompts);\n\n  logger.info(`Starting ${config.name} MCP server (stdio)`);\n  const { close } = await connectStdio(mcpServer, { logger });\n  logger.info('stdio transport ready');\n\n  return {\n    mcpServer,\n    logger,\n    close: async () => {\n      await close();\n      await runtime.close();\n    },\n  };\n}\n"],"names":["createStdioServer","config","overrides","runtime","modules","layers","composed","logger","tools","prompts","mcpServer","close","createDefaultRuntime","createDomainModules","middlewareFactories","map","factory","deps","composeMiddleware","oauthAdapters","accountTools","accountPrompts","McpServer","name","version","registerTools","registerResources","resources","registerPrompts","info","connectStdio"],"mappings":";;;;+BAKsBA;;;eAAAA;;;sBAL6E;mBACzE;yBAEW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE9B,SAAeA,kBAAkBC,MAAoB,EAAEC,SAA4B;;YAClFC,SACAC,SACAC,QACAC,UACAC,QAEAC,OACAC,SAEAC,WAMEC;;;;oBAfQ;;wBAAMC,IAAAA,+BAAoB,EAACX,QAAQC;;;oBAA7CC,UAAU;oBACVC,UAAUD,QAAQU,mBAAmB;oBACrCR,SAASF,QAAQW,mBAAmB,CAACC,GAAG,CAAC,SAACC;+BAAYA,QAAQb,QAAQc,IAAI;;oBAC1EX,WAAWY,IAAAA,yBAAiB,EAACd,SAASC;oBACtCE,SAASJ,QAAQc,IAAI,CAACV,MAAM;oBAE5BC,QAAQ,AAAC,qBAAGF,SAASE,KAAK,SAAE,qBAAGL,QAAQc,IAAI,CAACE,aAAa,CAACC,YAAY;oBACtEX,UAAU,AAAC,qBAAGH,SAASG,OAAO,SAAE,qBAAGN,QAAQc,IAAI,CAACE,aAAa,CAACE,cAAc;oBAE5EX,YAAY,IAAIY,cAAS,CAAC;wBAAEC,MAAMtB,OAAOsB,IAAI;wBAAEC,SAASvB,OAAOuB,OAAO;oBAAC;oBAC7EC,IAAAA,qBAAa,EAACf,WAAWF;oBACzBkB,IAAAA,yBAAiB,EAAChB,WAAWJ,SAASqB,SAAS;oBAC/CC,IAAAA,uBAAe,EAAClB,WAAWD;oBAE3BF,OAAOsB,IAAI,CAAC,AAAC,YAAuB,OAAZ5B,OAAOsB,IAAI,EAAC;oBAClB;;wBAAMO,IAAAA,oBAAY,EAACpB,WAAW;4BAAEH,QAAAA;wBAAO;;;oBAAjDI,QAAU,cAAVA;oBACRJ,OAAOsB,IAAI,CAAC;oBAEZ;;wBAAO;4BACLnB,WAAAA;4BACAH,QAAAA;4BACAI,OAAO,SAAPA;;;;;gDACE;;oDAAMA;;;gDAAN;gDACA;;oDAAMR,QAAQQ,KAAK;;;gDAAnB;;;;;;gCACF;;wBACF;;;;IACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/setup/stdio.ts"],"sourcesContent":["import { composeMiddleware, connectStdio, McpServer, registerPrompts, registerResources, registerTools } from '@mcp-z/server';\nimport type { RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createDefaultRuntime } from './runtime.ts';\n\nexport async function createStdioServer(config: ServerConfig, overrides?: RuntimeOverrides) {\n  const runtime = await createDefaultRuntime(config, overrides);\n  const modules = runtime.createDomainModules();\n  const layers = runtime.middlewareFactories.map((factory) => factory(runtime.deps));\n  const composed = composeMiddleware(modules, layers);\n  const logger = runtime.deps.logger;\n\n  const tools = [...composed.tools, ...runtime.deps.oauthAdapters.accountTools];\n  const prompts = [...composed.prompts, ...runtime.deps.oauthAdapters.accountPrompts];\n\n  const mcpServer = new McpServer({ name: config.name, version: config.version });\n  registerTools(mcpServer, tools);\n  registerResources(mcpServer, composed.resources);\n  registerPrompts(mcpServer, prompts);\n\n  logger.info(`Starting ${config.name} MCP server (stdio)`);\n  const { close } = await connectStdio(mcpServer, { logger });\n  logger.info('stdio transport ready');\n\n  return {\n    mcpServer,\n    logger,\n    close: async () => {\n      await close();\n      await runtime.close();\n    },\n  };\n}\n"],"names":["createStdioServer","config","overrides","runtime","modules","layers","composed","logger","tools","prompts","mcpServer","close","createDefaultRuntime","createDomainModules","middlewareFactories","map","factory","deps","composeMiddleware","oauthAdapters","accountTools","accountPrompts","McpServer","name","version","registerTools","registerResources","resources","registerPrompts","info","connectStdio"],"mappings":";;;;+BAIsBA;;;eAAAA;;;sBAJwF;yBAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE9B,SAAeA,kBAAkBC,MAAoB,EAAEC,SAA4B;;YAClFC,SACAC,SACAC,QACAC,UACAC,QAEAC,OACAC,SAEAC,WAMEC;;;;oBAfQ;;wBAAMC,IAAAA,+BAAoB,EAACX,QAAQC;;;oBAA7CC,UAAU;oBACVC,UAAUD,QAAQU,mBAAmB;oBACrCR,SAASF,QAAQW,mBAAmB,CAACC,GAAG,CAAC,SAACC;+BAAYA,QAAQb,QAAQc,IAAI;;oBAC1EX,WAAWY,IAAAA,yBAAiB,EAACd,SAASC;oBACtCE,SAASJ,QAAQc,IAAI,CAACV,MAAM;oBAE5BC,QAAQ,AAAC,qBAAGF,SAASE,KAAK,SAAE,qBAAGL,QAAQc,IAAI,CAACE,aAAa,CAACC,YAAY;oBACtEX,UAAU,AAAC,qBAAGH,SAASG,OAAO,SAAE,qBAAGN,QAAQc,IAAI,CAACE,aAAa,CAACE,cAAc;oBAE5EX,YAAY,IAAIY,iBAAS,CAAC;wBAAEC,MAAMtB,OAAOsB,IAAI;wBAAEC,SAASvB,OAAOuB,OAAO;oBAAC;oBAC7EC,IAAAA,qBAAa,EAACf,WAAWF;oBACzBkB,IAAAA,yBAAiB,EAAChB,WAAWJ,SAASqB,SAAS;oBAC/CC,IAAAA,uBAAe,EAAClB,WAAWD;oBAE3BF,OAAOsB,IAAI,CAAC,AAAC,YAAuB,OAAZ5B,OAAOsB,IAAI,EAAC;oBAClB;;wBAAMO,IAAAA,oBAAY,EAACpB,WAAW;4BAAEH,QAAAA;wBAAO;;;oBAAjDI,QAAU,cAAVA;oBACRJ,OAAOsB,IAAI,CAAC;oBAEZ;;wBAAO;4BACLnB,WAAAA;4BACAH,QAAAA;4BACAI,OAAO,SAAPA;;;;;gDACE;;oDAAMA;;;gDAAN;gDACA;;oDAAMR,QAAQQ,KAAK;;;gDAAnB;;;;;;gCACF;;wBACF;;;;IACF"}

package/dist/esm/index.js

@@ -8,7 +8,7 @@ import * as _setup from './setup/index.js';
 export { _setup as setup };
 export * from './types.js';
 export async function startServer(config) {
-    // createHTTPServer/createStdioServer pull in @modelcontextprotocol/sdk and every mcp/tools/*.ts
+    // createHTTPServer/createStdioServer pull in @mcp-z/server and every mcp/tools/*.ts
     // (googleapis included); deferred so a --version/--help run never reaches them.
     const { createHTTPServer } = await import('./setup/http.js');
     const { createStdioServer } = await import('./setup/stdio.js');

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/index.ts"],"sourcesContent":["import { handleVersionHelp } from './setup/version-help.ts';\nimport type { ServerConfig } from './types.ts';\n\nexport { GOOGLE_SCOPE } from './constants.ts';\nexport * as mcp from './mcp/index.ts';\nexport * as schemas from './schemas/index.ts';\nexport * as setup from './setup/index.ts';\nexport * from './types.ts';\n\nexport async function startServer(config: ServerConfig): Promise<void> {\n  // createHTTPServer/createStdioServer pull in @modelcontextprotocol/sdk and every mcp/tools/*.ts\n  // (googleapis included); deferred so a --version/--help run never reaches them.\n  const { createHTTPServer } = await import('./setup/http.ts');\n  const { createStdioServer } = await import('./setup/stdio.ts');\n  const { logger, close } = config.transport.type === 'stdio' ? await createStdioServer(config) : await createHTTPServer(config);\n\n  process.on('SIGINT', async () => {\n    await close();\n    process.exit(0);\n  });\n\n  logger.info(`Server started with ${config.transport.type} transport`);\n  await new Promise(() => {});\n}\n\nexport default async function main(): Promise<void> {\n  // Check for help/version flags FIRST, before config parsing\n  const versionHelpResult = handleVersionHelp(process.argv);\n  if (versionHelpResult.handled) {\n    console.log(versionHelpResult.output);\n    process.exit(0);\n  }\n\n  // Only parse config if no help/version flags. config.ts's own heavy imports (@mcp-z/oauth-google,\n  // @mcp-z/server) are deferred internally, so this static-looking call stays cheap until here.\n  const { createConfig } = await import('./setup/config.ts');\n  const config = createConfig();\n  await startServer(config);\n}\n\nif (process.argv[1] === new URL(import.meta.url).pathname) {\n  main();\n}\n"],"names":["handleVersionHelp","GOOGLE_SCOPE","mcp","schemas","setup","startServer","config","createHTTPServer","createStdioServer","logger","close","transport","type","process","on","exit","info","Promise","main","versionHelpResult","argv","handled","console","log","output","createConfig","URL","url","pathname"],"mappings":"AAAA,SAASA,iBAAiB,QAAQ,0BAA0B;AAG5D,SAASC,YAAY,QAAQ,iBAAiB;AAC9C,sBAAqB,iBAAiB;AAAtC,SAAO,QAAKC,GAAG,GAAuB;AACtC,0BAAyB,qBAAqB;AAA9C,SAAO,YAAKC,OAAO,GAA2B;AAC9C,wBAAuB,mBAAmB;AAA1C,SAAO,UAAKC,KAAK,GAAyB;AAC1C,cAAc,aAAa;AAE3B,OAAO,eAAeC,YAAYC,MAAoB;IACpD,gGAAgG;IAChG,gFAAgF;IAChF,MAAM,EAAEC,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC;IAC1C,MAAM,EAAEC,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC;IAC3C,MAAM,EAAEC,MAAM,EAAEC,KAAK,EAAE,GAAGJ,OAAOK,SAAS,CAACC,IAAI,KAAK,UAAU,MAAMJ,kBAAkBF,UAAU,MAAMC,iBAAiBD;IAEvHO,QAAQC,EAAE,CAAC,UAAU;QACnB,MAAMJ;QACNG,QAAQE,IAAI,CAAC;IACf;IAEAN,OAAOO,IAAI,CAAC,CAAC,oBAAoB,EAAEV,OAAOK,SAAS,CAACC,IAAI,CAAC,UAAU,CAAC;IACpE,MAAM,IAAIK,QAAQ,KAAO;AAC3B;AAEA,eAAe,eAAeC;IAC5B,4DAA4D;IAC5D,MAAMC,oBAAoBnB,kBAAkBa,QAAQO,IAAI;IACxD,IAAID,kBAAkBE,OAAO,EAAE;QAC7BC,QAAQC,GAAG,CAACJ,kBAAkBK,MAAM;QACpCX,QAAQE,IAAI,CAAC;IACf;IAEA,kGAAkG;IAClG,8FAA8F;IAC9F,MAAM,EAAEU,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC;IACtC,MAAMnB,SAASmB;IACf,MAAMpB,YAAYC;AACpB;AAEA,IAAIO,QAAQO,IAAI,CAAC,EAAE,KAAK,IAAIM,IAAI,YAAYC,GAAG,EAAEC,QAAQ,EAAE;IACzDV;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/index.ts"],"sourcesContent":["import { handleVersionHelp } from './setup/version-help.ts';\nimport type { ServerConfig } from './types.ts';\n\nexport { GOOGLE_SCOPE } from './constants.ts';\nexport * as mcp from './mcp/index.ts';\nexport * as schemas from './schemas/index.ts';\nexport * as setup from './setup/index.ts';\nexport * from './types.ts';\n\nexport async function startServer(config: ServerConfig): Promise<void> {\n  // createHTTPServer/createStdioServer pull in @mcp-z/server and every mcp/tools/*.ts\n  // (googleapis included); deferred so a --version/--help run never reaches them.\n  const { createHTTPServer } = await import('./setup/http.ts');\n  const { createStdioServer } = await import('./setup/stdio.ts');\n  const { logger, close } = config.transport.type === 'stdio' ? await createStdioServer(config) : await createHTTPServer(config);\n\n  process.on('SIGINT', async () => {\n    await close();\n    process.exit(0);\n  });\n\n  logger.info(`Server started with ${config.transport.type} transport`);\n  await new Promise(() => {});\n}\n\nexport default async function main(): Promise<void> {\n  // Check for help/version flags FIRST, before config parsing\n  const versionHelpResult = handleVersionHelp(process.argv);\n  if (versionHelpResult.handled) {\n    console.log(versionHelpResult.output);\n    process.exit(0);\n  }\n\n  // Only parse config if no help/version flags. config.ts's own heavy imports (@mcp-z/oauth-google,\n  // @mcp-z/server) are deferred internally, so this static-looking call stays cheap until here.\n  const { createConfig } = await import('./setup/config.ts');\n  const config = createConfig();\n  await startServer(config);\n}\n\nif (process.argv[1] === new URL(import.meta.url).pathname) {\n  main();\n}\n"],"names":["handleVersionHelp","GOOGLE_SCOPE","mcp","schemas","setup","startServer","config","createHTTPServer","createStdioServer","logger","close","transport","type","process","on","exit","info","Promise","main","versionHelpResult","argv","handled","console","log","output","createConfig","URL","url","pathname"],"mappings":"AAAA,SAASA,iBAAiB,QAAQ,0BAA0B;AAG5D,SAASC,YAAY,QAAQ,iBAAiB;AAC9C,sBAAqB,iBAAiB;AAAtC,SAAO,QAAKC,GAAG,GAAuB;AACtC,0BAAyB,qBAAqB;AAA9C,SAAO,YAAKC,OAAO,GAA2B;AAC9C,wBAAuB,mBAAmB;AAA1C,SAAO,UAAKC,KAAK,GAAyB;AAC1C,cAAc,aAAa;AAE3B,OAAO,eAAeC,YAAYC,MAAoB;IACpD,oFAAoF;IACpF,gFAAgF;IAChF,MAAM,EAAEC,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC;IAC1C,MAAM,EAAEC,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC;IAC3C,MAAM,EAAEC,MAAM,EAAEC,KAAK,EAAE,GAAGJ,OAAOK,SAAS,CAACC,IAAI,KAAK,UAAU,MAAMJ,kBAAkBF,UAAU,MAAMC,iBAAiBD;IAEvHO,QAAQC,EAAE,CAAC,UAAU;QACnB,MAAMJ;QACNG,QAAQE,IAAI,CAAC;IACf;IAEAN,OAAOO,IAAI,CAAC,CAAC,oBAAoB,EAAEV,OAAOK,SAAS,CAACC,IAAI,CAAC,UAAU,CAAC;IACpE,MAAM,IAAIK,QAAQ,KAAO;AAC3B;AAEA,eAAe,eAAeC;IAC5B,4DAA4D;IAC5D,MAAMC,oBAAoBnB,kBAAkBa,QAAQO,IAAI;IACxD,IAAID,kBAAkBE,OAAO,EAAE;QAC7BC,QAAQC,GAAG,CAACJ,kBAAkBK,MAAM;QACpCX,QAAQE,IAAI,CAAC;IACf;IAEA,kGAAkG;IAClG,8FAA8F;IAC9F,MAAM,EAAEU,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC;IACtC,MAAMnB,SAASmB;IACf,MAAMpB,YAAYC;AACpB;AAEA,IAAIO,QAAQO,IAAI,CAAC,EAAE,KAAK,IAAIM,IAAI,YAAYC,GAAG,EAAEC,QAAQ,EAAE;IACzDV;AACF"}

package/dist/esm/mcp/prompts/a1-notation.d.ts

@@ -1,5 +1,4 @@
-import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
-import type { ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';
+import type { ServerContext } from '@mcp-z/server';
 export default function createPrompt(): {
     name: string;
     config: {
@@ -7,7 +6,7 @@ export default function createPrompt(): {
     };
     handler: (_args: {
         [x: string]: unknown;
-    }, _extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => Promise<{
+    }, _extra: ServerContext) => Promise<{
         messages: {
             role: "user";
             content: {

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/prompts/a1-notation.ts"],"sourcesContent":["import type { PromptModule } 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":"AAIA,eAAe,SAASA;IACtB,MAAMC,SAAS;QACbC,aAAa;IACf;IAEA,MAAMC,UAAU,OAAOC,OAAiCC;QACtD,OAAO;YACLC,UAAU;gBACR;oBACEC,MAAM;oBACNC,SAAS;wBACPC,MAAM;wBACNC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;sCA0BmB,CAAC;oBAC7B;gBACF;aACD;QACH;IACF;IAEA,OAAO;QACLC,MAAM;QACNV;QACAE;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/prompts/a1-notation.ts"],"sourcesContent":["import type { PromptModule, ServerContext } from '@mcp-z/server';\n\nexport default function createPrompt() {\n  const config = {\n    description: 'Reference guide for Google Sheets A1 notation syntax',\n  };\n\n  const handler = async (_args: { [x: string]: unknown }, _extra: ServerContext) => {\n    return {\n      messages: [\n        {\n          role: 'user' as const,\n          content: {\n            type: 'text' as const,\n            text: `# Google Sheets A1 Notation Reference\n\nA1 notation identifies cells and ranges in Google Sheets.\n\n## Cell References\n- \\`B5\\` - Single cell at column B, row 5\n- \\`A1\\` - Top-left cell\n\n## Range References\n- \\`A1:D10\\` - Rectangle from A1 to D10\n- \\`A5:D5\\` - Single row (columns A-D of row 5)\n- \\`B1:B10\\` - Single column segment (rows 1-10 of column B)\n\n## Full Row/Column References\n- \\`5:5\\` - Entire row 5\n- \\`B:B\\` - Entire column B\n- \\`A:D\\` - Columns A through D (all rows)\n- \\`1:10\\` - Rows 1 through 10 (all columns)\n\n## Common Patterns\n| Goal | Notation |\n|------|----------|\n| Get one cell | \\`B5\\` |\n| Get a row | \\`A5:Z5\\` or \\`5:5\\` |\n| Get a column | \\`B:B\\` or \\`B1:B1000\\` |\n| Get a data table | \\`A1:F100\\` |\n| Get headers | \\`1:1\\` or \\`A1:Z1\\` |`,\n          },\n        },\n      ],\n    };\n  };\n\n  return {\n    name: 'a1-notation',\n    config,\n    handler,\n  } satisfies PromptModule;\n}\n"],"names":["createPrompt","config","description","handler","_args","_extra","messages","role","content","type","text","name"],"mappings":"AAEA,eAAe,SAASA;IACtB,MAAMC,SAAS;QACbC,aAAa;IACf;IAEA,MAAMC,UAAU,OAAOC,OAAiCC;QACtD,OAAO;YACLC,UAAU;gBACR;oBACEC,MAAM;oBACNC,SAAS;wBACPC,MAAM;wBACNC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;sCA0BmB,CAAC;oBAC7B;gBACF;aACD;QACH;IACF;IAEA,OAAO;QACLC,MAAM;QACNV;QACAE;IACF;AACF"}

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

@@ -1,4 +1,4 @@
-import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ResourceTemplate } from '@mcp-z/server';
 import { google } from 'googleapis';
 export default function createResource() {
     const template = new ResourceTemplate('sheets://spreadsheets/{spreadsheetId}', {

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/resources/spreadsheet.ts"],"sourcesContent":["import type { 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":["ResourceTemplate","google","createResource","template","list","undefined","config","description","mimeType","handler","uri","variables","extra","spreadsheetId","Array","isArray","contents","href","text","JSON","stringify","error","data","logger","authContext","sheets","version","auth","resp","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 { ReadResourceResult, ResourceConfig, ResourceModule, ServerContext } from '@mcp-z/server';\nimport { ResourceTemplate } from '@mcp-z/server';\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: ServerContext): Promise<ReadResourceResult> => {\n    const spreadsheetId = Array.isArray(variables.spreadsheetId) ? variables.spreadsheetId[0] : variables.spreadsheetId;\n\n    if (!spreadsheetId) {\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({ error: 'spreadsheetId is required' }),\n          },\n        ],\n      };\n    }\n\n    try {\n      // Safe type guard to access middleware-enriched extra\n      const { logger, authContext } = extra as unknown as EnrichedExtra;\n      const sheets = 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":["ResourceTemplate","google","createResource","template","list","undefined","config","description","mimeType","handler","uri","variables","extra","spreadsheetId","Array","isArray","contents","href","text","JSON","stringify","error","data","logger","authContext","sheets","version","auth","resp","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/esm/mcp/tools/cells-format.d.ts

@@ -1,5 +1,5 @@
 import type { EnrichedExtra } from '@mcp-z/oauth-google';
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CallToolResult } from '@mcp-z/server';
 import { z } from 'zod';
 declare const inputSchema: z.ZodObject<{
     id: z.ZodString;

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

@@ -1,6 +1,6 @@
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { google } from 'googleapis';
 import { z } from 'zod';
 import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
@@ -105,7 +105,7 @@ async function handler({ id, gid, requests }, extra) {
                 gid,
                 requestCount: requests.length
             });
-            throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);
         }
         const sheetTitle = (_sheet_properties_title = sheet.properties.title) !== null && _sheet_properties_title !== void 0 ? _sheet_properties_title : gid;
         // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).
@@ -275,7 +275,7 @@ async function handler({ id, gid, requests }, extra) {
             requestCount: requests.length,
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error formatting cells: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error formatting cells: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-format.ts"],"sourcesContent":["import type { 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":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ColorSchema","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","gid","requests","array","successBranchSchema","literal","sheetTitle","sheetUrl","successCount","nonnegative","failedRanges","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","requestCount","length","sheet","spreadsheetResponse","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","batchRequests","request","rangeRef","gridRange","cellFormat","push","undefined","textFormat","foregroundColor","repeatCell","cell","userEnteredFormat","join","updateBorders","top","bottom","left","right","message","Error","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","createTool","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 { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\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 ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n    const sheetId = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n    // Build batch update requests\n    const batchRequests: sheets_v4.Schema$Request[] = [];\n    const failedRanges: Array<{ range: string; error: string }> = [];\n\n    for (const request of requests) {\n      try {\n        // Parse A1 notation to range reference\n        const rangeRef = parseA1Notation(request.range);\n\n        // Build grid range from range reference using helper function\n        const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n        // Build cell format object\n        const cellFormat: {\n          backgroundColor?: sheets_v4.Schema$Color;\n          textFormat?: sheets_v4.Schema$TextFormat;\n          horizontalAlignment?: string;\n          numberFormat?: sheets_v4.Schema$NumberFormat;\n        } = {};\n        const fields: string[] = [];\n\n        // Background color\n        if (request.backgroundColor) {\n          cellFormat.backgroundColor = request.backgroundColor;\n          fields.push('backgroundColor');\n        }\n\n        // Text format\n        if (request.textColor || request.bold !== undefined || request.fontSize !== undefined) {\n          cellFormat.textFormat = {};\n          if (request.textColor) {\n            cellFormat.textFormat.foregroundColor = request.textColor;\n            fields.push('textFormat.foregroundColor');\n          }\n          if (request.bold !== undefined) {\n            cellFormat.textFormat.bold = request.bold;\n            fields.push('textFormat.bold');\n          }\n          if (request.fontSize !== undefined) {\n            cellFormat.textFormat.fontSize = request.fontSize;\n            fields.push('textFormat.fontSize');\n          }\n        }\n\n        // Horizontal alignment\n        if (request.horizontalAlignment) {\n          cellFormat.horizontalAlignment = request.horizontalAlignment;\n          fields.push('horizontalAlignment');\n        }\n\n        // Number format\n        if (request.numberFormat) {\n          const numberFormat: sheets_v4.Schema$NumberFormat = {\n            type: request.numberFormat.type,\n          };\n          if (request.numberFormat.pattern !== undefined) {\n            numberFormat.pattern = request.numberFormat.pattern;\n          }\n          cellFormat.numberFormat = numberFormat;\n          fields.push('numberFormat');\n        }\n\n        // Add repeatCell request for this range\n        if (fields.length > 0) {\n          batchRequests.push({\n            repeatCell: {\n              range: gridRange,\n              cell: {\n                userEnteredFormat: cellFormat,\n              },\n              fields: `userEnteredFormat(${fields.join(',')})`,\n            },\n          });\n        }\n\n        // Add border formatting if specified\n        if (request.borders) {\n          batchRequests.push({\n            updateBorders: {\n              range: gridRange,\n              top: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              bottom: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              left: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              right: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n            },\n          });\n        }\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        logger.info('Failed to parse range for formatting', {\n          range: request.range,\n          error: message,\n        });\n        failedRanges.push({\n          range: request.range,\n          error: `Failed to parse range: ${message}`,\n        });\n      }\n    }\n\n    // Early return if all ranges failed\n    if (batchRequests.length === 0) {\n      const result: Output = {\n        type: 'success' as const,\n        id,\n        gid: String(sheetId),\n        sheetTitle,\n        sheetUrl,\n        successCount: 0,\n        failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n      };\n\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n        structuredContent: { result },\n      };\n    }\n\n    logger.info('sheets.cells.format executing batch request', {\n      spreadsheetId: id,\n      sheetTitle,\n      batchRequestsCount: batchRequests.length,\n    });\n\n    // Execute the batch update\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: batchRequests,\n      },\n    });\n\n    logger.info('sheets.cells.format completed successfully', {\n      successCount: requests.length - failedRanges.length,\n      failedCount: failedRanges.length,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      sheetTitle,\n      sheetUrl,\n      successCount: requests.length - failedRanges.length,\n      failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Format cells operation failed', {\n      id,\n      gid,\n      requestCount: requests.length,\n      error: message,\n    });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error formatting cells: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'cells-format',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ColorSchema","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","gid","requests","array","successBranchSchema","literal","sheetTitle","sheetUrl","successCount","nonnegative","failedRanges","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","requestCount","length","sheet","spreadsheetResponse","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","batchRequests","request","rangeRef","gridRange","cellFormat","push","undefined","textFormat","foregroundColor","repeatCell","cell","userEnteredFormat","join","updateBorders","top","bottom","left","right","message","Error","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/chart-create.d.ts

@@ -1,5 +1,5 @@
 import type { EnrichedExtra } from '@mcp-z/oauth-google';
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CallToolResult } from '@mcp-z/server';
 import { z } from 'zod';
 declare const inputSchema: z.ZodObject<{
     id: z.ZodString;

package/dist/esm/mcp/tools/chart-create.js

@@ -1,6 +1,6 @@
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { google } from 'googleapis';
 import { z } from 'zod';
 import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
@@ -111,7 +111,7 @@ async function handler({ id, gid, chartType, dataRange, title, position, legend
                 gid,
                 chartType
             });
-            throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);
         }
         const sheetTitle = (_sheet_properties_title = sheet.properties.title) !== null && _sheet_properties_title !== void 0 ? _sheet_properties_title : gid;
         // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).
@@ -124,7 +124,7 @@ async function handler({ id, gid, chartType, dataRange, title, position, legend
                 chartType,
                 is3D
             });
-            throw new McpError(ErrorCode.InvalidParams, `3D mode is only supported for PIE charts, not ${chartType}`);
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, `3D mode is only supported for PIE charts, not ${chartType}`);
         }
         // Parse anchor cell to row/column indices
         let anchorRowIndex;
@@ -139,7 +139,7 @@ async function handler({ id, gid, chartType, dataRange, title, position, legend
                 anchorCell: position.anchorCell,
                 error: message
             });
-            throw new McpError(ErrorCode.InvalidParams, `Failed to parse anchor cell: ${message}`);
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Failed to parse anchor cell: ${message}`);
         }
         // Parse data range to grid range
         let dataGridRange;
@@ -165,7 +165,7 @@ async function handler({ id, gid, chartType, dataRange, title, position, legend
                 dataRange,
                 error: message
             });
-            throw new McpError(ErrorCode.InvalidParams, `Failed to parse data range: ${message}`);
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Failed to parse data range: ${message}`);
         }
         // Extract validated properties with defined types
         const dataStartRowIndex = dataGridRange.startRowIndex;
@@ -354,7 +354,7 @@ async function handler({ id, gid, chartType, dataRange, title, position, legend
                 sheetTitle,
                 chartType
             });
-            throw new McpError(ErrorCode.InternalError, 'Chart creation failed: no chart ID returned from Google Sheets API');
+            throw new ProtocolError(ProtocolErrorCode.InternalError, 'Chart creation failed: no chart ID returned from Google Sheets API');
         }
         const chartId = replies[0].addChart.chart.chartId;
         logger.info('sheets.chart.create completed successfully', {
@@ -395,7 +395,7 @@ async function handler({ id, gid, chartType, dataRange, title, position, legend
             response: (_error_response = error.response) === null || _error_response === void 0 ? void 0 : _error_response.data,
             status: (_error_response1 = error.response) === null || _error_response1 === void 0 ? void 0 : _error_response1.status
         });
-        throw new McpError(ErrorCode.InternalError, `Error creating chart: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error creating chart: ${message}`, {
             stack: e instanceof Error ? e.stack : undefined
         });
     }

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

@@ -1 +1 @@
-{"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":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ChartPositionSchema","object","anchorCell","string","min","describe","offsetX","number","int","default","offsetY","inputSchema","id","gid","chartType","enum","dataRange","title","optional","position","legend","is3D","boolean","successBranchSchema","type","literal","sheetTitle","sheetUrl","chartId","outputSchema","discriminatedUnion","config","description","result","parseAnchorCell","match","Error","colLetters","rowNumber","columnIndex","i","length","charCodeAt","rowIndex","Number","parseInt","handler","extra","logger","info","sheet","dataGridRange","spreadsheetResponse","replies","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","anchorRowIndex","anchorColumnIndex","anchorIndices","error","message","rangeRef","startColumnIndex","undefined","endColumnIndex","startRowIndex","endRowIndex","dataStartRowIndex","dataEndRowIndex","dataStartColumnIndex","dataEndColumnIndex","dataSheetId","chartSpec","legendPositionMap","BOTTOM","RIGHT","TOP","LEFT","NONE","apiLegendPosition","baseSheetId","domainRange","seriesRange","pieChart","legendPosition","domain","sourceRange","sources","series","threeDimensional","numDataColumns","push","basicChart","headerCount","domains","embeddedObjectPosition","overlayPosition","offsetXPixels","offsetYPixels","requestBody","requests","addChart","chart","spec","JSON","stringify","response","batchUpdate","InternalError","content","text","structuredContent","e","status","stack","createTool","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 { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\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 ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n    const sheetId = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n    // 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 ProtocolError(ProtocolErrorCode.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 ProtocolError(ProtocolErrorCode.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 ProtocolError(ProtocolErrorCode.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 ProtocolError(ProtocolErrorCode.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 ProtocolError(ProtocolErrorCode.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":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ChartPositionSchema","object","anchorCell","string","min","describe","offsetX","number","int","default","offsetY","inputSchema","id","gid","chartType","enum","dataRange","title","optional","position","legend","is3D","boolean","successBranchSchema","type","literal","sheetTitle","sheetUrl","chartId","outputSchema","discriminatedUnion","config","description","result","parseAnchorCell","match","Error","colLetters","rowNumber","columnIndex","i","length","charCodeAt","rowIndex","Number","parseInt","handler","extra","logger","info","sheet","dataGridRange","spreadsheetResponse","replies","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","anchorRowIndex","anchorColumnIndex","anchorIndices","error","message","rangeRef","startColumnIndex","undefined","endColumnIndex","startRowIndex","endRowIndex","dataStartRowIndex","dataEndRowIndex","dataStartColumnIndex","dataEndColumnIndex","dataSheetId","chartSpec","legendPositionMap","BOTTOM","RIGHT","TOP","LEFT","NONE","apiLegendPosition","baseSheetId","domainRange","seriesRange","pieChart","legendPosition","domain","sourceRange","sources","series","threeDimensional","numDataColumns","push","basicChart","headerCount","domains","embeddedObjectPosition","overlayPosition","offsetXPixels","offsetYPixels","requestBody","requests","addChart","chart","spec","JSON","stringify","response","batchUpdate","InternalError","content","text","structuredContent","e","status","stack","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/columns-get.d.ts

@@ -1,6 +1,6 @@
 /** Get column names from Google Sheet (peek at first row only) */
 import type { EnrichedExtra } from '@mcp-z/oauth-google';
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CallToolResult } from '@mcp-z/server';
 import { z } from 'zod';
 declare const inputSchema: z.ZodObject<{
     id: z.ZodString;

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

@@ -1,6 +1,6 @@
 /** Get column names from Google Sheet (peek at first row only) */ import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { google } from 'googleapis';
 import { z } from 'zod';
 import { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.js';
@@ -56,7 +56,7 @@ async function handler({ id, gid, render }, extra) {
             return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === gid;
         });
         if (!(sheet === null || sheet === void 0 ? void 0 : sheet.properties)) {
-            throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);
         }
         const sheetTitle = (_sheet_properties_title = sheet.properties.title) !== null && _sheet_properties_title !== void 0 ? _sheet_properties_title : '';
         // Read first row only (A1:ZZZ1 should cover most reasonable sheets)
@@ -99,7 +99,7 @@ async function handler({ id, gid, render }, extra) {
         (_logger_error = logger.error) === null || _logger_error === void 0 ? void 0 : _logger_error.call(logger, 'sheets.columns.get error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error getting sheet columns: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting sheet columns: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }