@mcp-z/mcp-sheets 1.2.3 → 2.1.0

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,5 +1,6 @@
-import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ResourceTemplate } from '@mcp-z/server';
 import { google } from 'googleapis';
+import { googleAuth } from '../../lib/google-auth.js';
 export default function createResource() {
     const template = new ResourceTemplate('sheets://spreadsheets/{spreadsheetId}', {
         list: undefined
@@ -29,7 +30,7 @@ export default function createResource() {
             const { logger, authContext } = extra;
             const sheets = google.sheets({
                 version: 'v4',
-                auth: authContext.auth
+                auth: googleAuth(authContext.auth)
             });
             const resp = await sheets.spreadsheets.get({
                 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 { googleAuth } from '../../lib/google-auth.ts';\nimport type { GoogleApiError } from '../../types.ts';\n\nexport default function createResource(): ResourceModule {\n  const template = new ResourceTemplate('sheets://spreadsheets/{spreadsheetId}', { list: undefined });\n  const config: ResourceConfig = {\n    description: 'Sheets spreadsheet resource',\n    mimeType: 'application/json',\n  };\n\n  const handler = async (uri: URL, variables: Record<string, string | string[]>, extra: ServerContext): Promise<ReadResourceResult> => {\n    const spreadsheetId = Array.isArray(variables.spreadsheetId) ? variables.spreadsheetId[0] : variables.spreadsheetId;\n\n    if (!spreadsheetId) {\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({ error: 'spreadsheetId is required' }),\n          },\n        ],\n      };\n    }\n\n    try {\n      // Safe type guard to access middleware-enriched extra\n      const { logger, authContext } = extra as unknown as EnrichedExtra;\n      const sheets = google.sheets({ version: 'v4', auth: googleAuth(authContext.auth) });\n      const resp = await sheets.spreadsheets.get({\n        spreadsheetId,\n        fields: 'spreadsheetId,properties.title,sheets.properties',\n      });\n      const data = resp.data as sheets_v4.Schema$Spreadsheet;\n      logger.info('sheets-spreadsheet resource fetch success', {\n        spreadsheetId: data.spreadsheetId,\n        title: data?.properties?.title,\n        sheetCount: (data?.sheets || []).length,\n      });\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              id: data?.spreadsheetId,\n              title: data?.properties?.title,\n              sheets: (data?.sheets || []).map((s) => ({\n                id: s?.properties?.sheetId,\n                title: s?.properties?.title,\n                rowCount: s?.properties?.gridProperties?.rowCount,\n                columnCount: s?.properties?.gridProperties?.columnCount,\n              })),\n            }),\n          },\n        ],\n      };\n    } catch (error) {\n      const { logger } = extra as unknown as EnrichedExtra;\n      logger.info('sheets-spreadsheet resource fetch failed', error as Record<string, unknown>);\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              error: String((error as GoogleApiError)?.message ?? error),\n            }),\n          },\n        ],\n      };\n    }\n  };\n\n  return {\n    name: 'spreadsheet',\n    template,\n    config,\n    handler,\n  };\n}\n"],"names":["ResourceTemplate","google","googleAuth","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,8 +1,9 @@
 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 { googleAuth } from '../../lib/google-auth.js';
 import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
 import { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.js';
 // RGB color schema (0-1 range for Google Sheets API)
@@ -87,7 +88,7 @@ async function handler({ id, gid, requests }, extra) {
         var _spreadsheetResponse_data_sheets;
         const sheets = google.sheets({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         // Get spreadsheet and sheet info in single API call
         const spreadsheetResponse = await sheets.spreadsheets.get({
@@ -105,7 +106,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 +276,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 { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// RGB color schema (0-1 range for Google Sheets API)\nconst ColorSchema = z.object({\n  red: z.number().min(0).max(1).describe('Red component (0-1)'),\n  green: z.number().min(0).max(1).describe('Green component (0-1)'),\n  blue: z.number().min(0).max(1).describe('Blue component (0-1)'),\n});\n\n// Number format schema\nconst NumberFormatSchema = z.object({\n  type: z.enum(['TEXT', 'NUMBER', 'PERCENT', 'CURRENCY', 'DATE', 'TIME']).describe('Number format type'),\n  pattern: z.string().optional().describe('Custom format pattern (e.g., \"$#,##0.00\" for currency)'),\n});\n\n// Border schema\nconst BorderSchema = z.object({\n  style: z.enum(['SOLID', 'DASHED', 'DOTTED']).describe('Border line style'),\n  color: ColorSchema.describe('Border color'),\n});\n\n// Input schema for format requests\nconst FormatRequestSchema = z.object({\n  range: z.string().min(1).describe('A1 notation range to format (e.g., \"A1:D10\", \"B:B\", \"5:5\")'),\n  backgroundColor: ColorSchema.optional().describe('Cell background color'),\n  textColor: ColorSchema.optional().describe('Text color'),\n  bold: z.boolean().optional().describe('Bold text'),\n  fontSize: z.number().int().min(6).max(36).optional().describe('Font size in points'),\n  horizontalAlignment: z.enum(['LEFT', 'CENTER', 'RIGHT']).optional().describe('Horizontal text alignment'),\n  numberFormat: NumberFormatSchema.optional().describe('Number format pattern'),\n  borders: BorderSchema.optional().describe('Cell borders'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  requests: z.array(FormatRequestSchema).min(1).max(50).describe('Array of formatting requests. Batch multiple ranges for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Title of the formatted sheet'),\n  sheetUrl: z.string().describe('URL of the formatted sheet'),\n  successCount: z.number().int().nonnegative().describe('Number of format requests successfully applied'),\n  failedRanges: z\n    .array(\n      z.object({\n        range: z.string().describe('A1 notation of range that failed'),\n        error: z.string().describe('Why formatting failed for this range'),\n      })\n    )\n    .optional()\n    .describe('Only populated if some ranges failed to format'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.cells.format called', {\n    id,\n    gid,\n    requestCount: requests.length,\n  });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for format cells', { id, gid, requestCount: requests.length });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n    const sheetId = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n    // Build batch update requests\n    const batchRequests: sheets_v4.Schema$Request[] = [];\n    const failedRanges: Array<{ range: string; error: string }> = [];\n\n    for (const request of requests) {\n      try {\n        // Parse A1 notation to range reference\n        const rangeRef = parseA1Notation(request.range);\n\n        // Build grid range from range reference using helper function\n        const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n        // Build cell format object\n        const cellFormat: {\n          backgroundColor?: sheets_v4.Schema$Color;\n          textFormat?: sheets_v4.Schema$TextFormat;\n          horizontalAlignment?: string;\n          numberFormat?: sheets_v4.Schema$NumberFormat;\n        } = {};\n        const fields: string[] = [];\n\n        // Background color\n        if (request.backgroundColor) {\n          cellFormat.backgroundColor = request.backgroundColor;\n          fields.push('backgroundColor');\n        }\n\n        // Text format\n        if (request.textColor || request.bold !== undefined || request.fontSize !== undefined) {\n          cellFormat.textFormat = {};\n          if (request.textColor) {\n            cellFormat.textFormat.foregroundColor = request.textColor;\n            fields.push('textFormat.foregroundColor');\n          }\n          if (request.bold !== undefined) {\n            cellFormat.textFormat.bold = request.bold;\n            fields.push('textFormat.bold');\n          }\n          if (request.fontSize !== undefined) {\n            cellFormat.textFormat.fontSize = request.fontSize;\n            fields.push('textFormat.fontSize');\n          }\n        }\n\n        // Horizontal alignment\n        if (request.horizontalAlignment) {\n          cellFormat.horizontalAlignment = request.horizontalAlignment;\n          fields.push('horizontalAlignment');\n        }\n\n        // Number format\n        if (request.numberFormat) {\n          const numberFormat: sheets_v4.Schema$NumberFormat = {\n            type: request.numberFormat.type,\n          };\n          if (request.numberFormat.pattern !== undefined) {\n            numberFormat.pattern = request.numberFormat.pattern;\n          }\n          cellFormat.numberFormat = numberFormat;\n          fields.push('numberFormat');\n        }\n\n        // Add repeatCell request for this range\n        if (fields.length > 0) {\n          batchRequests.push({\n            repeatCell: {\n              range: gridRange,\n              cell: {\n                userEnteredFormat: cellFormat,\n              },\n              fields: `userEnteredFormat(${fields.join(',')})`,\n            },\n          });\n        }\n\n        // Add border formatting if specified\n        if (request.borders) {\n          batchRequests.push({\n            updateBorders: {\n              range: gridRange,\n              top: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              bottom: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              left: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              right: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n            },\n          });\n        }\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        logger.info('Failed to parse range for formatting', {\n          range: request.range,\n          error: message,\n        });\n        failedRanges.push({\n          range: request.range,\n          error: `Failed to parse range: ${message}`,\n        });\n      }\n    }\n\n    // Early return if all ranges failed\n    if (batchRequests.length === 0) {\n      const result: Output = {\n        type: 'success' as const,\n        id,\n        gid: String(sheetId),\n        sheetTitle,\n        sheetUrl,\n        successCount: 0,\n        failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n      };\n\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n        structuredContent: { result },\n      };\n    }\n\n    logger.info('sheets.cells.format executing batch request', {\n      spreadsheetId: id,\n      sheetTitle,\n      batchRequestsCount: batchRequests.length,\n    });\n\n    // Execute the batch update\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: batchRequests,\n      },\n    });\n\n    logger.info('sheets.cells.format completed successfully', {\n      successCount: requests.length - failedRanges.length,\n      failedCount: failedRanges.length,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      sheetTitle,\n      sheetUrl,\n      successCount: requests.length - failedRanges.length,\n      failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Format cells operation failed', {\n      id,\n      gid,\n      requestCount: requests.length,\n      error: message,\n    });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error formatting cells: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'cells-format',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","googleAuth","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,8 +1,9 @@
 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 { googleAuth } from '../../lib/google-auth.js';
 import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
 import { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.js';
 // Input schema for chart position
@@ -93,7 +94,7 @@ async function handler({ id, gid, chartType, dataRange, title, position, legend
         var _spreadsheetResponse_data_sheets, _replies__addChart_chart, _replies__addChart, _replies_;
         const sheets = google.sheets({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         // Get spreadsheet and sheet info in single API call
         const spreadsheetResponse = await sheets.spreadsheets.get({
@@ -111,7 +112,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 +125,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 +140,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 +166,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 +355,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 +396,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 { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// 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: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for 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","googleAuth","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,8 +1,9 @@
 /** 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 { googleAuth } from '../../lib/google-auth.js';
 import { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.js';
 const inputSchema = z.object({
     id: SpreadsheetIdSchema,
@@ -43,7 +44,7 @@ async function handler({ id, gid, render }, extra) {
         var _spreadsheetResponse_data_sheets, _logger_info;
         const sheets = google.sheets({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         // Get spreadsheet and sheet info in single API call
         const spreadsheetResponse = await sheets.spreadsheets.get({
@@ -56,7 +57,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 +100,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
         });
     }

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-get.ts"],"sourcesContent":["/** Get column names from Google Sheet (peek at first row only) */\n\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n});\n\n// Success branch schema - uses columns: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  columns: z.array(z.string()).describe('First row values (column names) or empty if no rows'),\n  isEmpty: z.boolean().describe('True if sheet has zero rows'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Get first row from Google Sheet. Returns columns array and isEmpty flag.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.debug?.('sheets.columns.get called', { id, gid, render });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? '';\n\n    // Read first row only (A1:ZZZ1 should cover most reasonable sheets)\n    const range = `'${sheetTitle}'!A1:ZZZ1`;\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n\n    const rows = response.data.values || [];\n    const isEmpty = rows.length === 0;\n\n    // Extract first row and convert to strings (column names)\n    const firstRow = rows[0] || [];\n    const columns = firstRow.map((value) => String(value ?? ''));\n\n    const result: Output = {\n      type: 'success' as const,\n      columns,\n      isEmpty,\n    };\n\n    logger.info?.('sheets.columns.get completed', { id, gid, columnCount: columns.length, isEmpty });\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error?.('sheets.columns.get error', { error: message });\n    throw new McpError(ErrorCode.InternalError, `Error getting sheet columns: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'columns-get',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","id","gid","render","enum","optional","describe","successBranchSchema","type","literal","columns","array","string","isEmpty","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","debug","sheet","spreadsheetResponse","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","sheetTitle","title","range","response","values","valueRenderOption","rows","length","firstRow","map","value","info","columnCount","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"AAAA,gEAAgE,GAGhE,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAIrC,SAASE,SAAS,EAAEC,QAAQ,QAAQ,qCAAqC;AACzE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,cAAc,EAAEC,mBAAmB,QAAQ,yBAAyB;AAE7E,MAAMC,cAAcH,EAAEI,MAAM,CAAC;IAC3BC,IAAIH;IACJI,KAAKL;IACLM,QAAQP,EAAEQ,IAAI,CAAC;QAAC;QAAmB;QAAqB;KAAU,EAAEC,QAAQ,GAAGC,QAAQ,CAAC;AAC1F;AAEA,iFAAiF;AACjF,MAAMC,sBAAsBX,EAAEI,MAAM,CAAC;IACnCQ,MAAMZ,EAAEa,OAAO,CAAC;IAChBC,SAASd,EAAEe,KAAK,CAACf,EAAEgB,MAAM,IAAIN,QAAQ,CAAC;IACtCO,SAASjB,EAAEkB,OAAO,GAAGR,QAAQ,CAAC;AAChC;AAEA,MAAMS,eAAenB,EAAEoB,kBAAkB,CAAC,QAAQ;IAACT;IAAqBf;CAAyB;AAEjG,MAAMyB,SAAS;IACbC,aAAa;IACbnB;IACAgB,cAAcnB,EAAEI,MAAM,CAAC;QACrBmB,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAEnB,EAAE,EAAEC,GAAG,EAAEC,MAAM,EAAS,EAAEkB,KAAoB;QAErEC;IADA,MAAMA,SAASD,MAAMC,MAAM;KAC3BA,gBAAAA,OAAOC,KAAK,cAAZD,oCAAAA,mBAAAA,QAAe,6BAA6B;QAAErB;QAAIC;QAAKC;IAAO;IAE9D,IAAI;YAeiBqB;YALLC,kCA4BdH;QArCA,MAAMI,SAAS/B,OAAO+B,MAAM,CAAC;YAAEC,SAAS;YAAMC,MAAMP,MAAMQ,WAAW,CAACD,IAAI;QAAC;QAE3E,oDAAoD;QACpD,MAAMH,sBAAsB,MAAMC,OAAOI,YAAY,CAACC,GAAG,CAAC;YACxDC,eAAe/B;YACfgC,QAAQ;QACV;QAEA,oBAAoB;QACpB,MAAMT,SAAQC,mCAAAA,oBAAoBS,IAAI,CAACR,MAAM,cAA/BD,uDAAAA,iCAAiCU,IAAI,CAAC,CAACC;gBAAaA;mBAAPC,QAAOD,gBAAAA,EAAEE,UAAU,cAAZF,oCAAAA,cAAcG,OAAO,MAAMrC;;QAC7F,IAAI,EAACsB,kBAAAA,4BAAAA,MAAOc,UAAU,GAAE;YACtB,MAAM,IAAI5C,SAASD,UAAU+C,aAAa,EAAE,CAAC,iBAAiB,EAAEtC,KAAK;QACvE;QAEA,MAAMuC,cAAajB,0BAAAA,MAAMc,UAAU,CAACI,KAAK,cAAtBlB,qCAAAA,0BAA0B;QAE7C,oEAAoE;QACpE,MAAMmB,QAAQ,CAAC,CAAC,EAAEF,WAAW,SAAS,CAAC;QACvC,MAAMG,WAAW,MAAMlB,OAAOI,YAAY,CAACe,MAAM,CAACd,GAAG,CAAC;YACpDC,eAAe/B;YACf0C;YACAG,mBAAmB3C,UAAU;QAC/B;QAEA,MAAM4C,OAAOH,SAASV,IAAI,CAACW,MAAM,IAAI,EAAE;QACvC,MAAMhC,UAAUkC,KAAKC,MAAM,KAAK;QAEhC,0DAA0D;QAC1D,MAAMC,WAAWF,IAAI,CAAC,EAAE,IAAI,EAAE;QAC9B,MAAMrC,UAAUuC,SAASC,GAAG,CAAC,CAACC,QAAUd,OAAOc,kBAAAA,mBAAAA,QAAS;QAExD,MAAMhC,SAAiB;YACrBX,MAAM;YACNE;YACAG;QACF;SAEAS,eAAAA,OAAO8B,IAAI,cAAX9B,mCAAAA,kBAAAA,QAAc,gCAAgC;YAAErB;YAAIC;YAAKmD,aAAa3C,QAAQsC,MAAM;YAAEnC;QAAQ;QAC9F,OAAO;YACLyC,SAAS;gBAAC;oBAAE9C,MAAM;oBAAiB+C,MAAMC,KAAKC,SAAS,CAACtC;gBAAQ;aAAE;YAClEuC,mBAAmB;gBAAEvC;YAAO;QAC9B;IACF,EAAE,OAAOwC,OAAO;YAEdrC;QADA,MAAMsC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGvB,OAAOsB;SAChErC,gBAAAA,OAAOqC,KAAK,cAAZrC,oCAAAA,mBAAAA,QAAe,4BAA4B;YAAEqC,OAAOC;QAAQ;QAC5D,MAAM,IAAIlE,SAASD,UAAUqE,aAAa,EAAE,CAAC,6BAA6B,EAAEF,SAAS,EAAE;YACrFG,OAAOJ,iBAAiBE,QAAQF,MAAMI,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACNjD;QACAG;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-get.ts"],"sourcesContent":["/** Get column names from Google Sheet (peek at first row only) */\n\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n});\n\n// Success branch schema - uses columns: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  columns: z.array(z.string()).describe('First row values (column names) or empty if no rows'),\n  isEmpty: z.boolean().describe('True if sheet has zero rows'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Get first row from Google Sheet. Returns columns array and isEmpty flag.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.debug?.('sheets.columns.get called', { id, gid, render });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? '';\n\n    // Read first row only (A1:ZZZ1 should cover most reasonable sheets)\n    const range = `'${sheetTitle}'!A1:ZZZ1`;\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n\n    const rows = response.data.values || [];\n    const isEmpty = rows.length === 0;\n\n    // Extract first row and convert to strings (column names)\n    const firstRow = rows[0] || [];\n    const columns = firstRow.map((value) => String(value ?? ''));\n\n    const result: Output = {\n      type: 'success' as const,\n      columns,\n      isEmpty,\n    };\n\n    logger.info?.('sheets.columns.get completed', { id, gid, columnCount: columns.length, isEmpty });\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error?.('sheets.columns.get error', { error: message });\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting sheet columns: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'columns-get',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","googleAuth","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","id","gid","render","enum","optional","describe","successBranchSchema","type","literal","columns","array","string","isEmpty","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","debug","sheet","spreadsheetResponse","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","sheetTitle","title","range","response","values","valueRenderOption","rows","length","firstRow","map","value","info","columnCount","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/columns-update.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/columns-update.js

@@ -1,8 +1,9 @@
 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 { googleAuth } from '../../lib/google-auth.js';
 import { SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
 import { generateRowKey, snapshotHeaderKeysAndPositions, upsertByKey } from '../../spreadsheet/data-operations.js';
 // Input schema for columns update requests with enhanced validation
@@ -96,7 +97,7 @@ async function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-up
         var _spreadsheetData_properties, _spreadsheetData_sheets, _logger_debug1, _upsertResult_errors, _logger_debug2;
         const sheets = google.sheets({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         // Note: Basic input validation is now handled by the enhanced Zod schema
         // EARLY VALIDATION: Validate that updateBy columns have non-empty values for all rows
@@ -118,7 +119,7 @@ async function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-up
             (_logger_error = logger.error) === null || _logger_error === void 0 ? void 0 : _logger_error.call(logger, 'sheets.columns.update error', {
                 error: message
             });
-            throw new McpError(ErrorCode.InvalidParams, message);
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, message);
         }
         // Get spreadsheet and sheet info in single API call
         const spreadsheetResponse = await sheets.spreadsheets.get({
@@ -140,7 +141,7 @@ async function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-up
                 gid,
                 rowCount: rows.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;
         const sheetGid = (_sheet_properties_sheetId = sheet.properties.sheetId) !== null && _sheet_properties_sheetId !== void 0 ? _sheet_properties_sheetId : 0;
@@ -282,7 +283,7 @@ async function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-up
         (_logger_error1 = logger.error) === null || _logger_error1 === void 0 ? void 0 : _logger_error1.call(logger, 'sheets.columns.update error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error updating columns: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error updating columns: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }