@mcp-z/mcp-sheets 1.2.2 → 2.0.0

package/dist/cjs/mcp/tools/values-csv-update.js

@@ -9,7 +9,7 @@ Object.defineProperty(exports, "default", {
     }
 });
 var _oauthgoogle = require("@mcp-z/oauth-google");
-var _types = require("@modelcontextprotocol/sdk/types.js");
+var _server = require("@mcp-z/server");
 var _csvparse = require("csv-parse");
 var _googleapis = require("googleapis");
 var _zod = require("zod");
@@ -268,7 +268,7 @@ function handler(_0, _1) {
                         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 _types.McpError(_types.ErrorCode.InvalidParams, "Sheet not found: ".concat(gid));
+                        throw new _server.ProtocolError(_server.ProtocolErrorCode.InvalidParams, "Sheet not found: ".concat(gid));
                     }
                     sheetTitle = (_sheet_properties_title = sheet.properties.title) !== null && _sheet_properties_title !== void 0 ? _sheet_properties_title : '';
                     // Streaming CSV processing state
@@ -396,7 +396,7 @@ function handler(_0, _1) {
                     ];
                 case 15:
                     if (allRows.length === 0) {
-                        throw new _types.McpError(_types.ErrorCode.InvalidParams, 'CSV file is empty');
+                        throw new _server.ProtocolError(_server.ProtocolErrorCode.InvalidParams, 'CSV file is empty');
                     }
                     // Prepare data for update (all rows)
                     dataToWrite = allRows;
@@ -475,7 +475,7 @@ function handler(_0, _1) {
                     logger.error('sheets.values.csv-update error', {
                         error: message
                     });
-                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error updating values from CSV: ".concat(message), {
+                    throw new _server.ProtocolError(_server.ProtocolErrorCode.InternalError, "Error updating values from CSV: ".concat(message), {
                         stack: _instanceof(error, Error) ? error.stack : undefined
                     });
                 case 18:

package/dist/cjs/mcp/tools/values-csv-update.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-csv-update.ts"],"sourcesContent":["/** Import CSV data to Google Sheets with range-based update (no deduplication) */\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 { parse } from 'csv-parse';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { A1NotationSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { getCsvReadStream } from '../../spreadsheet/csv-streaming.ts';\n\n/** Batch size for Sheets API calls (1000 rows × avg 10 cols = 10K cells, well under 40K limit) */\nconst BATCH_SIZE = 1000;\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  sourceUri: z.string().trim().min(1).describe('CSV file URI (file://, http://, https://)'),\n  startRange: A1NotationSchema.default('A1').describe('Top-left cell where CSV data starts (default: A1)'),\n  valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How to interpret values (RAW = exact, USER_ENTERED = parse formulas/dates)'),\n  sourceHasHeaders: z.boolean().default(true).describe('First row is headers (metadata) - exclude from data range. Set to false to include first row as data.'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  spreadsheetTitle: z.string().describe('Spreadsheet title'),\n  spreadsheetUrl: z.string().describe('Spreadsheet URL'),\n  sheetTitle: z.string().describe('Sheet title'),\n  sheetUrl: z.string().describe('Sheet URL'),\n  updatedRange: z.string().describe('A1 notation range that was updated'),\n  updatedRows: z.number().describe('Number of rows updated'),\n  updatedColumns: z.number().describe('Number of columns updated'),\n  updatedCells: z.number().describe('Number of cells updated'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Import CSV to sheet range. Overwrites existing data at startRange. Use rows-csv-append for database-style appends with deduplication.',\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, sourceUri, startRange, valueInputOption = 'USER_ENTERED', sourceHasHeaders }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values.csv-update called', { id, gid, sourceUri, startRange, valueInputOption, sourceHasHeaders });\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: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const spreadsheetData = spreadsheetResponse.data;\n\n    // Find the sheet by gid\n    const sheet = spreadsheetData.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    // Streaming CSV processing state\n    let sourceHeaders: string[] = [];\n    const allRows: (string | number | boolean | null)[][] = [];\n    let totalCols = 0;\n\n    // Get readable stream from CSV URI (no temp files!)\n    const readStream = await getCsvReadStream(sourceUri);\n\n    // Create CSV parser with native streaming\n    const parser = readStream.pipe(\n      parse({\n        columns: !!sourceHasHeaders, // Parse first row as column names if source has headers\n        skip_empty_lines: true,\n        trim: true,\n        cast: true, // Auto-convert numbers/booleans\n        relax_column_count: true,\n      })\n    );\n\n    // Stream and collect all rows (with batching for very large files)\n    for await (const record of parser) {\n      if (sourceHasHeaders) {\n        // Extract source headers from first record\n        if (sourceHeaders.length === 0) {\n          sourceHeaders = Object.keys(record as Record<string, unknown>);\n          totalCols = sourceHeaders.length;\n          logger.info('sheets.values.csv-update source headers', { sourceHeaders, totalCols });\n        }\n\n        // Convert record to row array (exclude source headers from data range)\n        // CSV values are strings/numbers/booleans/nulls from the parser\n        const row = sourceHeaders.map((header) => (record as Record<string, string | number | boolean | null>)[header] ?? null);\n        allRows.push(row);\n      } else {\n        // sourceHasHeaders=false: record is an array, include all rows (including first row)\n        const row = record as (string | number | boolean | null)[];\n        allRows.push(row);\n\n        if (totalCols === 0) {\n          totalCols = row.length;\n        }\n      }\n    }\n\n    if (allRows.length === 0) {\n      throw new McpError(ErrorCode.InvalidParams, 'CSV file is empty');\n    }\n\n    // Prepare data for update (all rows)\n    const dataToWrite: (string | number | boolean | null)[][] = allRows;\n\n    // For large datasets, use batchUpdate to write in chunks\n    // This respects the 40K cell limit per request\n    const batchRequests = [];\n    const currentRow = startRange.match(/[A-Z]+(\\d+)/)?.[1] || '1';\n    let currentRowNum = Number.parseInt(currentRow, 10);\n\n    for (let i = 0; i < dataToWrite.length; i += BATCH_SIZE) {\n      const batchData = dataToWrite.slice(i, i + BATCH_SIZE);\n      const batchRange = `${sheetTitle}!${startRange.match(/[A-Z]+/)?.[0]}${currentRowNum}`;\n\n      batchRequests.push({\n        range: batchRange,\n        values: batchData,\n      });\n\n      currentRowNum += batchData.length;\n    }\n\n    logger.info('sheets.values.csv-update batching', { totalBatches: batchRequests.length, batchSize: BATCH_SIZE });\n\n    // Execute batch update\n    const batchUpdateResponse = await sheets.spreadsheets.values.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        valueInputOption,\n        data: batchRequests,\n      },\n    });\n\n    const totalUpdatedCells = batchUpdateResponse.data.totalUpdatedCells || 0;\n    const totalUpdatedRows = batchUpdateResponse.data.totalUpdatedRows || 0;\n    const totalUpdatedColumns = batchUpdateResponse.data.totalUpdatedColumns || 0;\n    const firstUpdatedRange = batchUpdateResponse.data.responses?.[0]?.updatedRange || `${sheetTitle}!${startRange}`;\n\n    logger.info('sheets.values.csv-update completed', { id, gid: sheet.properties.sheetId, updatedRange: firstUpdatedRange, updatedRows: totalUpdatedRows, sourceUri });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheet.properties.sheetId ?? ''),\n      spreadsheetTitle: spreadsheetData.properties?.title ?? '',\n      spreadsheetUrl: spreadsheetData.spreadsheetUrl ?? `https://docs.google.com/spreadsheets/d/${id}`,\n      sheetTitle,\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheet.properties.sheetId}`,\n      updatedRange: firstUpdatedRange,\n      updatedRows: totalUpdatedRows,\n      updatedColumns: totalUpdatedColumns,\n      updatedCells: totalUpdatedCells,\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('sheets.values.csv-update error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error updating values from CSV: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-csv-update',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","BATCH_SIZE","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","sourceUri","string","trim","min","describe","startRange","A1NotationSchema","default","valueInputOption","enum","sourceHasHeaders","boolean","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRange","updatedRows","number","updatedColumns","updatedCells","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","sheet","spreadsheetData","batchUpdateResponse","sheets","spreadsheetResponse","sourceHeaders","allRows","totalCols","readStream","parser","dataToWrite","batchRequests","currentRow","currentRowNum","i","batchData","batchRange","totalUpdatedCells","totalUpdatedRows","totalUpdatedColumns","firstUpdatedRange","error","message","info","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","McpError","ErrorCode","InvalidParams","title","getCsvReadStream","pipe","parse","columns","skip_empty_lines","cast","relax_column_count","record","length","Object","keys","row","map","header","push","match","Number","parseInt","slice","range","values","totalBatches","batchSize","batchUpdate","requestBody","responses","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","undefined","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-csv-update.ts"],"sourcesContent":["/** Import CSV data to Google Sheets with range-based update (no deduplication) */\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 { parse } from 'csv-parse';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { A1NotationSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { getCsvReadStream } from '../../spreadsheet/csv-streaming.ts';\n\n/** Batch size for Sheets API calls (1000 rows × avg 10 cols = 10K cells, well under 40K limit) */\nconst BATCH_SIZE = 1000;\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  sourceUri: z.string().trim().min(1).describe('CSV file URI (file://, http://, https://)'),\n  startRange: A1NotationSchema.default('A1').describe('Top-left cell where CSV data starts (default: A1)'),\n  valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How to interpret values (RAW = exact, USER_ENTERED = parse formulas/dates)'),\n  sourceHasHeaders: z.boolean().default(true).describe('First row is headers (metadata) - exclude from data range. Set to false to include first row as data.'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  spreadsheetTitle: z.string().describe('Spreadsheet title'),\n  spreadsheetUrl: z.string().describe('Spreadsheet URL'),\n  sheetTitle: z.string().describe('Sheet title'),\n  sheetUrl: z.string().describe('Sheet URL'),\n  updatedRange: z.string().describe('A1 notation range that was updated'),\n  updatedRows: z.number().describe('Number of rows updated'),\n  updatedColumns: z.number().describe('Number of columns updated'),\n  updatedCells: z.number().describe('Number of cells updated'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Import CSV to sheet range. Overwrites existing data at startRange. Use rows-csv-append for database-style appends with deduplication.',\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, sourceUri, startRange, valueInputOption = 'USER_ENTERED', sourceHasHeaders }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values.csv-update called', { id, gid, sourceUri, startRange, valueInputOption, sourceHasHeaders });\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: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const spreadsheetData = spreadsheetResponse.data;\n\n    // Find the sheet by gid\n    const sheet = spreadsheetData.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    // Streaming CSV processing state\n    let sourceHeaders: string[] = [];\n    const allRows: (string | number | boolean | null)[][] = [];\n    let totalCols = 0;\n\n    // Get readable stream from CSV URI (no temp files!)\n    const readStream = await getCsvReadStream(sourceUri);\n\n    // Create CSV parser with native streaming\n    const parser = readStream.pipe(\n      parse({\n        columns: !!sourceHasHeaders, // Parse first row as column names if source has headers\n        skip_empty_lines: true,\n        trim: true,\n        cast: true, // Auto-convert numbers/booleans\n        relax_column_count: true,\n      })\n    );\n\n    // Stream and collect all rows (with batching for very large files)\n    for await (const record of parser) {\n      if (sourceHasHeaders) {\n        // Extract source headers from first record\n        if (sourceHeaders.length === 0) {\n          sourceHeaders = Object.keys(record as Record<string, unknown>);\n          totalCols = sourceHeaders.length;\n          logger.info('sheets.values.csv-update source headers', { sourceHeaders, totalCols });\n        }\n\n        // Convert record to row array (exclude source headers from data range)\n        // CSV values are strings/numbers/booleans/nulls from the parser\n        const row = sourceHeaders.map((header) => (record as Record<string, string | number | boolean | null>)[header] ?? null);\n        allRows.push(row);\n      } else {\n        // sourceHasHeaders=false: record is an array, include all rows (including first row)\n        const row = record as (string | number | boolean | null)[];\n        allRows.push(row);\n\n        if (totalCols === 0) {\n          totalCols = row.length;\n        }\n      }\n    }\n\n    if (allRows.length === 0) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'CSV file is empty');\n    }\n\n    // Prepare data for update (all rows)\n    const dataToWrite: (string | number | boolean | null)[][] = allRows;\n\n    // For large datasets, use batchUpdate to write in chunks\n    // This respects the 40K cell limit per request\n    const batchRequests = [];\n    const currentRow = startRange.match(/[A-Z]+(\\d+)/)?.[1] || '1';\n    let currentRowNum = Number.parseInt(currentRow, 10);\n\n    for (let i = 0; i < dataToWrite.length; i += BATCH_SIZE) {\n      const batchData = dataToWrite.slice(i, i + BATCH_SIZE);\n      const batchRange = `${sheetTitle}!${startRange.match(/[A-Z]+/)?.[0]}${currentRowNum}`;\n\n      batchRequests.push({\n        range: batchRange,\n        values: batchData,\n      });\n\n      currentRowNum += batchData.length;\n    }\n\n    logger.info('sheets.values.csv-update batching', { totalBatches: batchRequests.length, batchSize: BATCH_SIZE });\n\n    // Execute batch update\n    const batchUpdateResponse = await sheets.spreadsheets.values.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        valueInputOption,\n        data: batchRequests,\n      },\n    });\n\n    const totalUpdatedCells = batchUpdateResponse.data.totalUpdatedCells || 0;\n    const totalUpdatedRows = batchUpdateResponse.data.totalUpdatedRows || 0;\n    const totalUpdatedColumns = batchUpdateResponse.data.totalUpdatedColumns || 0;\n    const firstUpdatedRange = batchUpdateResponse.data.responses?.[0]?.updatedRange || `${sheetTitle}!${startRange}`;\n\n    logger.info('sheets.values.csv-update completed', { id, gid: sheet.properties.sheetId, updatedRange: firstUpdatedRange, updatedRows: totalUpdatedRows, sourceUri });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheet.properties.sheetId ?? ''),\n      spreadsheetTitle: spreadsheetData.properties?.title ?? '',\n      spreadsheetUrl: spreadsheetData.spreadsheetUrl ?? `https://docs.google.com/spreadsheets/d/${id}`,\n      sheetTitle,\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheet.properties.sheetId}`,\n      updatedRange: firstUpdatedRange,\n      updatedRows: totalUpdatedRows,\n      updatedColumns: totalUpdatedColumns,\n      updatedCells: totalUpdatedCells,\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('sheets.values.csv-update error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error updating values from CSV: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-csv-update',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","BATCH_SIZE","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","sourceUri","string","trim","min","describe","startRange","A1NotationSchema","default","valueInputOption","enum","sourceHasHeaders","boolean","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRange","updatedRows","number","updatedColumns","updatedCells","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","sheet","spreadsheetData","batchUpdateResponse","sheets","spreadsheetResponse","sourceHeaders","allRows","totalCols","readStream","parser","dataToWrite","batchRequests","currentRow","currentRowNum","i","batchData","batchRange","totalUpdatedCells","totalUpdatedRows","totalUpdatedColumns","firstUpdatedRange","error","message","info","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","ProtocolError","ProtocolErrorCode","InvalidParams","title","getCsvReadStream","pipe","parse","columns","skip_empty_lines","cast","relax_column_count","record","length","Object","keys","row","map","header","push","match","Number","parseInt","slice","range","values","totalBatches","batchSize","batchUpdate","requestBody","responses","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","undefined","name"],"mappings":"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"}

package/dist/cjs/mcp/tools/values-markdown-update.d.cts

@@ -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/cjs/mcp/tools/values-markdown-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/cjs/mcp/tools/values-markdown-update.js

@@ -9,7 +9,7 @@ Object.defineProperty(exports, "default", {
     }
 });
 var _oauthgoogle = require("@mcp-z/oauth-google");
-var _types = require("@modelcontextprotocol/sdk/types.js");
+var _server = require("@mcp-z/server");
 var _googleapis = require("googleapis");
 var _zod = require("zod");
 var _indexts = require("../../schemas/index.js");
@@ -230,7 +230,7 @@ function handler(_0, _1) {
                             gid: gid,
                             requestCount: requests.length
                         });
-                        throw new _types.McpError(_types.ErrorCode.InvalidParams, "Sheet not found: ".concat(gid));
+                        throw new _server.ProtocolError(_server.ProtocolErrorCode.InvalidParams, "Sheet not found: ".concat(gid));
                     }
                     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).
@@ -376,8 +376,8 @@ function handler(_0, _1) {
                     ];
                 case 4:
                     error = _state.sent();
-                    // Re-throw McpError as-is
-                    if (_instanceof(error, _types.McpError)) {
+                    // Re-throw ProtocolError as-is
+                    if (_instanceof(error, _server.ProtocolError)) {
                         throw error;
                     }
                     message1 = _instanceof(error, Error) ? error.message : String(error);
@@ -387,7 +387,7 @@ function handler(_0, _1) {
                         requestCount: requests.length,
                         error: message1
                     });
-                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error writing markdown to cells: ".concat(message1), {
+                    throw new _server.ProtocolError(_server.ProtocolErrorCode.InternalError, "Error writing markdown to cells: ".concat(message1), {
                         stack: _instanceof(error, Error) ? error.stack : undefined
                     });
                 case 5:

package/dist/cjs/mcp/tools/values-markdown-update.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-markdown-update.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 { buildTextFormatRuns, parseInlineMarkdown } from '../../spreadsheet/markdown-runs.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// Input schema for a single markdown-cell request\nconst MarkdownCellRequestSchema = z.object({\n  cell: z.string().min(1).describe('Single-cell A1 reference (e.g., \"I2\"). Multi-cell ranges (e.g., \"A1:B2\") are rejected as a per-request failure.'),\n  text: z.string().describe('Cell content as inline markdown: [label](url) links, bare URLs, **bold**, *italic*, ~~strikethrough~~. Block syntax and other unsupported markdown is written as literal text.'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  requests: z.array(MarkdownCellRequestSchema).min(1).max(50).describe('Array of cell markdown requests. Batch multiple cells 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 updated sheet'),\n  sheetUrl: z.string().describe('URL of the updated sheet'),\n  successCount: z.number().int().nonnegative().describe('Number of cells successfully written'),\n  cells: z\n    .array(\n      z.object({\n        cell: z.string().describe('A1 reference of the cell that was written'),\n        text: z.string().describe('Resolved plain text written to the cell (markdown syntax stripped/literalized)'),\n        linkCount: z.number().int().nonnegative().describe('Number of clickable links written into the cell'),\n      })\n    )\n    .describe('Cells successfully written'),\n  failedCells: z\n    .array(\n      z.object({\n        cell: z.string().describe('A1 reference that failed'),\n        error: z.string().describe('Why the cell failed (e.g., not a single-cell reference)'),\n      })\n    )\n    .optional()\n    .describe('Only populated if some cells failed'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description:\n    'Replace cell content with text parsed from inline markdown. Supports [label](url) links, bare URLs, **bold**, *italic*, ~~strikethrough~~ — the only way to put MULTIPLE clickable links in one cell. Block syntax (headers, lists, tables) and other unsupported markdown is written as literal text. Writes text cells only — no formula or number coercion. For whole-cell formatting (colors, borders, number formats) use cells-format.',\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.values.markdownUpdate 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 markdown update', { 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 one updateCells request per cell\n    const batchRequests: sheets_v4.Schema$Request[] = [];\n    const cells: Array<{ cell: string; text: string; linkCount: number }> = [];\n    const failedCells: Array<{ cell: string; error: string }> = [];\n\n    for (const request of requests) {\n      try {\n        // Parse A1 notation and reject anything that isn't a single cell\n        const rangeRef = parseA1Notation(request.cell);\n        if (rangeRef.type !== 'cell') {\n          throw new Error(`Not a single-cell reference: \"${request.cell}\"`);\n        }\n\n        const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n        const parsed = parseInlineMarkdown(request.text);\n        const runs = buildTextFormatRuns(parsed);\n\n        batchRequests.push({\n          updateCells: {\n            range: gridRange,\n            rows: [\n              {\n                values: [\n                  {\n                    userEnteredValue: { stringValue: parsed.text },\n                    textFormatRuns: runs,\n                  },\n                ],\n              },\n            ],\n            fields: 'userEnteredValue,textFormatRuns',\n          },\n        });\n        cells.push({ cell: request.cell, text: parsed.text, linkCount: parsed.linkCount });\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        logger.info('Failed to parse cell for markdown update', {\n          cell: request.cell,\n          error: message,\n        });\n        failedCells.push({\n          cell: request.cell,\n          error: `Failed to parse cell: ${message}`,\n        });\n      }\n    }\n\n    // Early return if all cells 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        cells: [],\n        failedCells: failedCells.length > 0 ? failedCells : 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.values.markdownUpdate 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.values.markdownUpdate completed successfully', {\n      successCount: cells.length,\n      failedCount: failedCells.length,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      sheetTitle,\n      sheetUrl,\n      successCount: cells.length,\n      cells,\n      failedCells: failedCells.length > 0 ? failedCells : undefined,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    // Re-throw McpError as-is\n    if (error instanceof McpError) {\n      throw error;\n    }\n\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Markdown update operation failed', {\n      id,\n      gid,\n      requestCount: requests.length,\n      error: message,\n    });\n\n    throw new McpError(ErrorCode.InternalError, `Error writing markdown to cells: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-markdown-update',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","MarkdownCellRequestSchema","z","object","cell","string","min","describe","text","inputSchema","id","SpreadsheetIdSchema","gid","SheetGidSchema","requests","array","max","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","sheetTitle","sheetUrl","successCount","number","int","nonnegative","cells","linkCount","failedCells","error","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","sheet","spreadsheetResponse","sheets","sheetId","batchRequests","request","rangeRef","gridRange","parsed","runs","message","info","requestCount","length","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","McpError","ErrorCode","InvalidParams","title","parseA1Notation","Error","rangeReferenceToGridRange","parseInlineMarkdown","buildTextFormatRuns","push","updateCells","range","rows","values","userEnteredValue","stringValue","textFormatRuns","undefined","content","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-markdown-update.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { buildTextFormatRuns, parseInlineMarkdown } from '../../spreadsheet/markdown-runs.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// Input schema for a single markdown-cell request\nconst MarkdownCellRequestSchema = z.object({\n  cell: z.string().min(1).describe('Single-cell A1 reference (e.g., \"I2\"). Multi-cell ranges (e.g., \"A1:B2\") are rejected as a per-request failure.'),\n  text: z.string().describe('Cell content as inline markdown: [label](url) links, bare URLs, **bold**, *italic*, ~~strikethrough~~. Block syntax and other unsupported markdown is written as literal text.'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  requests: z.array(MarkdownCellRequestSchema).min(1).max(50).describe('Array of cell markdown requests. Batch multiple cells 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 updated sheet'),\n  sheetUrl: z.string().describe('URL of the updated sheet'),\n  successCount: z.number().int().nonnegative().describe('Number of cells successfully written'),\n  cells: z\n    .array(\n      z.object({\n        cell: z.string().describe('A1 reference of the cell that was written'),\n        text: z.string().describe('Resolved plain text written to the cell (markdown syntax stripped/literalized)'),\n        linkCount: z.number().int().nonnegative().describe('Number of clickable links written into the cell'),\n      })\n    )\n    .describe('Cells successfully written'),\n  failedCells: z\n    .array(\n      z.object({\n        cell: z.string().describe('A1 reference that failed'),\n        error: z.string().describe('Why the cell failed (e.g., not a single-cell reference)'),\n      })\n    )\n    .optional()\n    .describe('Only populated if some cells failed'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description:\n    'Replace cell content with text parsed from inline markdown. Supports [label](url) links, bare URLs, **bold**, *italic*, ~~strikethrough~~ — the only way to put MULTIPLE clickable links in one cell. Block syntax (headers, lists, tables) and other unsupported markdown is written as literal text. Writes text cells only — no formula or number coercion. For whole-cell formatting (colors, borders, number formats) use cells-format.',\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.values.markdownUpdate 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 markdown update', { 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 one updateCells request per cell\n    const batchRequests: sheets_v4.Schema$Request[] = [];\n    const cells: Array<{ cell: string; text: string; linkCount: number }> = [];\n    const failedCells: Array<{ cell: string; error: string }> = [];\n\n    for (const request of requests) {\n      try {\n        // Parse A1 notation and reject anything that isn't a single cell\n        const rangeRef = parseA1Notation(request.cell);\n        if (rangeRef.type !== 'cell') {\n          throw new Error(`Not a single-cell reference: \"${request.cell}\"`);\n        }\n\n        const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n        const parsed = parseInlineMarkdown(request.text);\n        const runs = buildTextFormatRuns(parsed);\n\n        batchRequests.push({\n          updateCells: {\n            range: gridRange,\n            rows: [\n              {\n                values: [\n                  {\n                    userEnteredValue: { stringValue: parsed.text },\n                    textFormatRuns: runs,\n                  },\n                ],\n              },\n            ],\n            fields: 'userEnteredValue,textFormatRuns',\n          },\n        });\n        cells.push({ cell: request.cell, text: parsed.text, linkCount: parsed.linkCount });\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        logger.info('Failed to parse cell for markdown update', {\n          cell: request.cell,\n          error: message,\n        });\n        failedCells.push({\n          cell: request.cell,\n          error: `Failed to parse cell: ${message}`,\n        });\n      }\n    }\n\n    // Early return if all cells 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        cells: [],\n        failedCells: failedCells.length > 0 ? failedCells : 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.values.markdownUpdate 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.values.markdownUpdate completed successfully', {\n      successCount: cells.length,\n      failedCount: failedCells.length,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      sheetTitle,\n      sheetUrl,\n      successCount: cells.length,\n      cells,\n      failedCells: failedCells.length > 0 ? failedCells : undefined,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    // Re-throw ProtocolError as-is\n    if (error instanceof ProtocolError) {\n      throw error;\n    }\n\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Markdown update operation failed', {\n      id,\n      gid,\n      requestCount: requests.length,\n      error: message,\n    });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error writing markdown to cells: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-markdown-update',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","MarkdownCellRequestSchema","z","object","cell","string","min","describe","text","inputSchema","id","SpreadsheetIdSchema","gid","SheetGidSchema","requests","array","max","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","sheetTitle","sheetUrl","successCount","number","int","nonnegative","cells","linkCount","failedCells","error","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","sheet","spreadsheetResponse","sheets","sheetId","batchRequests","request","rangeRef","gridRange","parsed","runs","message","info","requestCount","length","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","ProtocolError","ProtocolErrorCode","InvalidParams","title","parseA1Notation","Error","rangeReferenceToGridRange","parseInlineMarkdown","buildTextFormatRuns","push","updateCells","range","rows","values","userEnteredValue","stringValue","textFormatRuns","undefined","content","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","name"],"mappings":";;;;+BAuNA;;;eAAwBA;;;2BAtNA;sBAKyB;0BACV;mBACrB;uBACuE;8BAChC;iCACE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAR3D,IAAM,AAAEC,2BAA6BC,oBAAO,CAApCD;AAUR,kDAAkD;AAClD,IAAME,4BAA4BC,MAAC,CAACC,MAAM,CAAC;IACzCC,MAAMF,MAAC,CAACG,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;IACjCC,MAAMN,MAAC,CAACG,MAAM,GAAGE,QAAQ,CAAC;AAC5B;AAEA,IAAME,cAAcP,MAAC,CAACC,MAAM,CAAC;IAC3BO,IAAIC,4BAAmB;IACvBC,KAAKC,uBAAc;IACnBC,UAAUZ,MAAC,CAACa,KAAK,CAACd,2BAA2BK,GAAG,CAAC,GAAGU,GAAG,CAAC,IAAIT,QAAQ,CAAC;AACvE;AAEA,IAAMU,sBAAsBf,MAAC,CAACC,MAAM,CAAC;IACnCe,MAAMhB,MAAC,CAACiB,OAAO,CAAC;IAChBT,IAAIU,4BAAmB;IACvBR,KAAKS,uBAAc;IACnBC,YAAYpB,MAAC,CAACG,MAAM,GAAGE,QAAQ,CAAC;IAChCgB,UAAUrB,MAAC,CAACG,MAAM,GAAGE,QAAQ,CAAC;IAC9BiB,cAActB,MAAC,CAACuB,MAAM,GAAGC,GAAG,GAAGC,WAAW,GAAGpB,QAAQ,CAAC;IACtDqB,OAAO1B,MAAC,CACLa,KAAK,CACJb,MAAC,CAACC,MAAM,CAAC;QACPC,MAAMF,MAAC,CAACG,MAAM,GAAGE,QAAQ,CAAC;QAC1BC,MAAMN,MAAC,CAACG,MAAM,GAAGE,QAAQ,CAAC;QAC1BsB,WAAW3B,MAAC,CAACuB,MAAM,GAAGC,GAAG,GAAGC,WAAW,GAAGpB,QAAQ,CAAC;IACrD,IAEDA,QAAQ,CAAC;IACZuB,aAAa5B,MAAC,CACXa,KAAK,CACJb,MAAC,CAACC,MAAM,CAAC;QACPC,MAAMF,MAAC,CAACG,MAAM,GAAGE,QAAQ,CAAC;QAC1BwB,OAAO7B,MAAC,CAACG,MAAM,GAAGE,QAAQ,CAAC;IAC7B,IAEDyB,QAAQ,GACRzB,QAAQ,CAAC;AACd;AAEA,IAAM0B,eAAe/B,MAAC,CAACgC,kBAAkB,CAAC,QAAQ;IAACjB;IAAqBlB;CAAyB;AAEjG,IAAMoC,SAAS;IACbC,aACE;IACF3B,aAAAA;IACAwB,cAAc/B,MAAC,CAACC,MAAM,CAAC;QACrBkC,QAAQJ;IACV;AACF;AAKA,SAAeK;wCAAQ,KAA4B,EAAEC,KAAoB;YAAhD7B,IAAIE,KAAKE,UAC1B0B,QAuBeC,yBAEHA,2BARFC,kCATRC,QAGAD,qBAMAD,OAMAnB,YAEAsB,SACArB,UAGAsB,eACAjB,OACAE,aAED,2BAAA,mBAAA,gBAAA,WAAA,OAAMgB,SAGDC,UAKAC,WACAC,QACAC,MAoBAC,SAcFd,QAoCFA,SAeCN,OAMDoB;;;;oBAvIezC,KAAF,MAAEA,IAAIE,MAAN,MAAMA,KAAKE,WAAX,MAAWA;oBAC1B0B,SAASD,MAAMC,MAAM;oBAC3BA,OAAOY,IAAI,CAAC,uCAAuC;wBACjD1C,IAAAA;wBACAE,KAAAA;wBACAyC,cAAcvC,SAASwC,MAAM;oBAC/B;;;;;;;;;oBAGQX,SAASY,kBAAM,CAACZ,MAAM,CAAC;wBAAEa,SAAS;wBAAMC,MAAMlB,MAAMmB,WAAW,CAACD,IAAI;oBAAC;oBAG/C;;wBAAMd,OAAOgB,YAAY,CAACC,GAAG,CAAC;4BACxDC,eAAenD;4BACfoD,QAAQ;wBACV;;;oBAHMpB,sBAAsB;oBAK5B,oBAAoB;oBACdD,SAAQC,mCAAAA,oBAAoBqB,IAAI,CAACpB,MAAM,cAA/BD,uDAAAA,iCAAiCsB,IAAI,CAAC,SAACC;4BAAaA;+BAAPC,QAAOD,gBAAAA,EAAEE,UAAU,cAAZF,oCAAAA,cAAcrB,OAAO,MAAMhC;;oBAC7F,IAAI,EAAC6B,kBAAAA,4BAAAA,MAAO0B,UAAU,GAAE;wBACtB3B,OAAOY,IAAI,CAAC,uCAAuC;4BAAE1C,IAAAA;4BAAIE,KAAAA;4BAAKyC,cAAcvC,SAASwC,MAAM;wBAAC;wBAC5F,MAAM,IAAIc,qBAAa,CAACC,yBAAiB,CAACC,aAAa,EAAE,AAAC,oBAAuB,OAAJ1D;oBAC/E;oBAEMU,cAAamB,0BAAAA,MAAM0B,UAAU,CAACI,KAAK,cAAtB9B,qCAAAA,0BAA0B7B;oBAC7C,2JAA2J;oBACrJgC,WAAUH,4BAAAA,MAAM0B,UAAU,CAACvB,OAAO,cAAxBH,uCAAAA,4BAA4B;oBACtClB,WAAW,AAAC,0CAAwDqB,OAAflC,IAAG,cAAoB,OAARkC;oBAE1E,yCAAyC;oBACnCC;oBACAjB;oBACAE;oBAED,kCAAA,2BAAA;;wBAAL,IAAK,YAAiBhB,+BAAjB,6BAAA,QAAA,yBAAA,iCAA2B;4BAArBgC,UAAN;4BACH,IAAI;gCACF,iEAAiE;gCAC3DC,WAAWyB,IAAAA,kCAAe,EAAC1B,QAAQ1C,IAAI;gCAC7C,IAAI2C,SAAS7B,IAAI,KAAK,QAAQ;oCAC5B,MAAM,IAAIuD,MAAM,AAAC,iCAA6C,OAAb3B,QAAQ1C,IAAI,EAAC;gCAChE;gCAEM4C,YAAY0B,IAAAA,4CAAyB,EAAC3B,UAAUH;gCAChDK,SAAS0B,IAAAA,mCAAmB,EAAC7B,QAAQtC,IAAI;gCACzC0C,OAAO0B,IAAAA,mCAAmB,EAAC3B;gCAEjCJ,cAAcgC,IAAI,CAAC;oCACjBC,aAAa;wCACXC,OAAO/B;wCACPgC,IAAI;4CACF;gDACEC,MAAM;oDACJ;wDACEC,kBAAkB;4DAAEC,aAAalC,OAAOzC,IAAI;wDAAC;wDAC7C4E,gBAAgBlC;oDAClB;;4CAEJ;;wCAEFY,QAAQ;oCACV;gCACF;gCACAlC,MAAMiD,IAAI,CAAC;oCAAEzE,MAAM0C,QAAQ1C,IAAI;oCAAEI,MAAMyC,OAAOzC,IAAI;oCAAEqB,WAAWoB,OAAOpB,SAAS;gCAAC;4BAClF,EAAE,OAAOE,OAAO;gCACRoB,UAAUpB,AAAK,YAALA,OAAiB0C,SAAQ1C,MAAMoB,OAAO,GAAGe,OAAOnC;gCAChES,OAAOY,IAAI,CAAC,4CAA4C;oCACtDhD,MAAM0C,QAAQ1C,IAAI;oCAClB2B,OAAOoB;gCACT;gCACArB,YAAY+C,IAAI,CAAC;oCACfzE,MAAM0C,QAAQ1C,IAAI;oCAClB2B,OAAO,AAAC,yBAAgC,OAARoB;gCAClC;4BACF;wBACF;;wBAxCK;wBAAA;;;iCAAA,6BAAA;gCAAA;;;gCAAA;sCAAA;;;;oBA0CL,mCAAmC;oBACnC,IAAIN,cAAcS,MAAM,KAAK,GAAG;wBACxBjB,SAAiB;4BACrBnB,MAAM;4BACNR,IAAAA;4BACAE,KAAKsD,OAAOtB;4BACZtB,YAAAA;4BACAC,UAAAA;4BACAC,cAAc;4BACdI,KAAK;4BACLE,aAAaA,YAAYwB,MAAM,GAAG,IAAIxB,cAAcuD;wBACtD;wBAEA;;4BAAO;gCACLC,OAAO;oCAAG;wCAAEpE,MAAM;wCAAiBV,MAAM+E,KAAKC,SAAS,CAACnD;oCAAQ;;gCAChEoD,mBAAmB;oCAAEpD,QAAAA;gCAAO;4BAC9B;;oBACF;oBAEAG,OAAOY,IAAI,CAAC,wDAAwD;wBAClES,eAAenD;wBACfY,YAAAA;wBACAoE,oBAAoB7C,cAAcS,MAAM;oBAC1C;oBAEA,2BAA2B;oBAC3B;;wBAAMX,OAAOgB,YAAY,CAACgC,WAAW,CAAC;4BACpC9B,eAAenD;4BACfkF,aAAa;gCACX9E,UAAU+B;4BACZ;wBACF;;;oBALA;oBAOAL,OAAOY,IAAI,CAAC,uDAAuD;wBACjE5B,cAAcI,MAAM0B,MAAM;wBAC1BuC,aAAa/D,YAAYwB,MAAM;oBACjC;oBAEMjB,UAAiB;wBACrBnB,MAAM;wBACNR,IAAAA;wBACAE,KAAKsD,OAAOtB;wBACZtB,YAAAA;wBACAC,UAAAA;wBACAC,cAAcI,MAAM0B,MAAM;wBAC1B1B,OAAAA;wBACAE,aAAaA,YAAYwB,MAAM,GAAG,IAAIxB,cAAcuD;oBACtD;oBAEA;;wBAAO;4BACLC,OAAO;gCAAG;oCAAEpE,MAAM;oCAAiBV,MAAM+E,KAAKC,SAAS,CAACnD;gCAAQ;;4BAChEoD,mBAAmB;gCAAEpD,QAAAA;4BAAO;wBAC9B;;;oBACON;oBACP,+BAA+B;oBAC/B,IAAIA,AAAK,YAALA,OAAiBqC,qBAAa,GAAE;wBAClC,MAAMrC;oBACR;oBAEMoB,WAAUpB,AAAK,YAALA,OAAiB0C,SAAQ1C,MAAMoB,OAAO,GAAGe,OAAOnC;oBAChES,OAAOT,KAAK,CAAC,oCAAoC;wBAC/CrB,IAAAA;wBACAE,KAAAA;wBACAyC,cAAcvC,SAASwC,MAAM;wBAC7BvB,OAAOoB;oBACT;oBAEA,MAAM,IAAIiB,qBAAa,CAACC,yBAAiB,CAACyB,aAAa,EAAE,AAAC,oCAA2C,OAAR3C,WAAW;wBACtG4C,OAAOhE,AAAK,YAALA,OAAiB0C,SAAQ1C,MAAMgE,KAAK,GAAGV;oBAChD;;;;;;;IAEJ;;AAEe,SAASvF;IACtB,OAAO;QACLkG,MAAM;QACN7D,QAAAA;QACAG,SAAAA;IACF;AACF"}

package/dist/cjs/mcp/tools/values-replace.d.cts

@@ -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/cjs/mcp/tools/values-replace.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/cjs/mcp/tools/values-replace.js

@@ -9,7 +9,7 @@ Object.defineProperty(exports, "default", {
     }
 });
 var _oauthgoogle = require("@mcp-z/oauth-google");
-var _types = require("@modelcontextprotocol/sdk/types.js");
+var _server = require("@mcp-z/server");
 var _googleapis = require("googleapis");
 var _zod = require("zod");
 var _indexts = require("../../schemas/index.js");
@@ -275,12 +275,12 @@ function handler(_0, _1) {
                         return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === gid;
                     });
                     if (!sheet) {
-                        throw new _types.McpError(_types.ErrorCode.InvalidParams, "Sheet not found: ".concat(gid));
+                        throw new _server.ProtocolError(_server.ProtocolErrorCode.InvalidParams, "Sheet not found: ".concat(gid));
                     }
                     // Note: sheetId can be 0 which is falsy, so check explicitly for undefined/null
                     sheetId = (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.sheetId;
                     if (sheetId === undefined || sheetId === null) {
-                        throw new _types.McpError(_types.ErrorCode.InternalError, 'Sheet properties not available');
+                        throw new _server.ProtocolError(_server.ProtocolErrorCode.InternalError, 'Sheet properties not available');
                     }
                     if (!range) {
                         // gid but no range = search specific sheet
@@ -339,7 +339,7 @@ function handler(_0, _1) {
                     ];
                 case 6:
                     error = _state.sent();
-                    if (_instanceof(error, _types.McpError)) {
+                    if (_instanceof(error, _server.ProtocolError)) {
                         throw error;
                     }
                     message = _instanceof(error, Error) ? error.message : String(error);
@@ -351,7 +351,7 @@ function handler(_0, _1) {
                         range: range,
                         error: message
                     });
-                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error replacing values: ".concat(message), {
+                    throw new _server.ProtocolError(_server.ProtocolErrorCode.InternalError, "Error replacing values: ".concat(message), {
                         stack: _instanceof(error, Error) ? error.stack : undefined
                     });
                 case 7:

package/dist/cjs/mcp/tools/values-replace.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-replace.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 { A1NotationSchema, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\nconst inputSchema = z\n  .object({\n    id: SpreadsheetIdSchema,\n    find: z.string().min(1).describe('Text or regex pattern to find'),\n    replacement: z.string().describe('Replacement text. Use $1, $2 for regex capture groups. Empty string deletes matches.'),\n\n    // Scope - defaults to all sheets if neither specified\n    gid: SheetGidSchema.optional().describe('Limit to specific sheet. If omitted, searches all sheets.'),\n    range: A1NotationSchema.optional().describe('Limit to specific A1 range within the sheet (requires gid)'),\n\n    // Match options\n    matchCase: z.boolean().optional().describe('Case-sensitive matching'),\n    matchEntireCell: z.boolean().optional().describe('Only match entire cell content'),\n    searchByRegex: z.boolean().optional().describe('Treat find as RE2 regex'),\n    includeFormulas: z.boolean().optional().describe('Search within formula text'),\n  })\n  .refine((data) => !(data.range && !data.gid), { message: 'range requires gid' });\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n  occurrencesChanged: z.number().int().nonnegative().describe('Total replacements made'),\n  valuesChanged: z.number().int().nonnegative().describe('Number of non-formula cells changed'),\n  formulasChanged: z.number().int().nonnegative().describe('Number of formula cells changed'),\n  rowsChanged: z.number().int().nonnegative().describe('Number of rows with replacements'),\n  sheetsChanged: z.number().int().nonnegative().describe('Number of sheets with replacements'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Find and replace text across a spreadsheet. Searches all sheets by default, or limit with gid/range. Supports regex with capture groups ($1, $2).',\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, find, replacement, gid, range, matchCase, matchEntireCell, searchByRegex, includeFormulas }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values-replace called', { id, find, replacement, gid, range });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Build FindReplaceRequest - only include defined options\n    const findReplaceRequest: sheets_v4.Schema$FindReplaceRequest = {\n      find,\n      replacement,\n      ...(matchCase !== undefined && { matchCase }),\n      ...(matchEntireCell !== undefined && { matchEntireCell }),\n      ...(searchByRegex !== undefined && { searchByRegex }),\n      ...(includeFormulas !== undefined && { includeFormulas }),\n    };\n\n    // Set scope based on gid/range\n    if (!gid) {\n      // No gid = search all sheets\n      findReplaceRequest.allSheets = true;\n    } else {\n      // Need to resolve sheet to get numeric sheetId\n      const spreadsheetResponse = await sheets.spreadsheets.get({\n        spreadsheetId: id,\n        fields: 'sheets.properties.sheetId,sheets.properties.title',\n      });\n\n      const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n      if (!sheet) {\n        throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n      }\n\n      // Note: sheetId can be 0 which is falsy, so check explicitly for undefined/null\n      const sheetId = sheet.properties?.sheetId;\n      if (sheetId === undefined || sheetId === null) {\n        throw new McpError(ErrorCode.InternalError, 'Sheet properties not available');\n      }\n\n      if (!range) {\n        // gid but no range = search specific sheet\n        findReplaceRequest.sheetId = sheetId;\n      } else {\n        // gid + range = search specific range\n        const rangeRef = parseA1Notation(range);\n        findReplaceRequest.range = rangeReferenceToGridRange(rangeRef, sheetId);\n      }\n    }\n\n    // Execute batchUpdate\n    const response = await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [{ findReplace: findReplaceRequest }],\n      },\n    });\n\n    const findReplaceResponse = response.data.replies?.[0]?.findReplace;\n    const spreadsheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit`;\n\n    logger.info('sheets.values-replace completed', {\n      occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n      sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      spreadsheetUrl,\n      occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n      valuesChanged: findReplaceResponse?.valuesChanged ?? 0,\n      formulasChanged: findReplaceResponse?.formulasChanged ?? 0,\n      rowsChanged: findReplaceResponse?.rowsChanged ?? 0,\n      sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    if (error instanceof McpError) {\n      throw error;\n    }\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Replace operation failed', {\n      id,\n      find,\n      replacement,\n      gid,\n      range,\n      error: message,\n    });\n\n    throw new McpError(ErrorCode.InternalError, `Error replacing values: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-replace',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","find","string","min","describe","replacement","gid","SheetGidSchema","optional","range","A1NotationSchema","matchCase","boolean","matchEntireCell","searchByRegex","includeFormulas","refine","data","message","successBranchSchema","type","literal","SpreadsheetIdOutput","spreadsheetUrl","occurrencesChanged","number","int","nonnegative","valuesChanged","formulasChanged","rowsChanged","sheetsChanged","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","response","sheets","findReplaceRequest","spreadsheetResponse","sheet","sheetId","rangeRef","findReplaceResponse","error","info","google","version","auth","authContext","undefined","allSheets","spreadsheets","get","spreadsheetId","fields","s","String","properties","McpError","ErrorCode","InvalidParams","InternalError","parseA1Notation","rangeReferenceToGridRange","batchUpdate","requestBody","requests","findReplace","replies","content","text","JSON","stringify","structuredContent","Error","stack","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-replace.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 { A1NotationSchema, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\nconst inputSchema = z\n  .object({\n    id: SpreadsheetIdSchema,\n    find: z.string().min(1).describe('Text or regex pattern to find'),\n    replacement: z.string().describe('Replacement text. Use $1, $2 for regex capture groups. Empty string deletes matches.'),\n\n    // Scope - defaults to all sheets if neither specified\n    gid: SheetGidSchema.optional().describe('Limit to specific sheet. If omitted, searches all sheets.'),\n    range: A1NotationSchema.optional().describe('Limit to specific A1 range within the sheet (requires gid)'),\n\n    // Match options\n    matchCase: z.boolean().optional().describe('Case-sensitive matching'),\n    matchEntireCell: z.boolean().optional().describe('Only match entire cell content'),\n    searchByRegex: z.boolean().optional().describe('Treat find as RE2 regex'),\n    includeFormulas: z.boolean().optional().describe('Search within formula text'),\n  })\n  .refine((data) => !(data.range && !data.gid), { message: 'range requires gid' });\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n  occurrencesChanged: z.number().int().nonnegative().describe('Total replacements made'),\n  valuesChanged: z.number().int().nonnegative().describe('Number of non-formula cells changed'),\n  formulasChanged: z.number().int().nonnegative().describe('Number of formula cells changed'),\n  rowsChanged: z.number().int().nonnegative().describe('Number of rows with replacements'),\n  sheetsChanged: z.number().int().nonnegative().describe('Number of sheets with replacements'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Find and replace text across a spreadsheet. Searches all sheets by default, or limit with gid/range. Supports regex with capture groups ($1, $2).',\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, find, replacement, gid, range, matchCase, matchEntireCell, searchByRegex, includeFormulas }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values-replace called', { id, find, replacement, gid, range });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Build FindReplaceRequest - only include defined options\n    const findReplaceRequest: sheets_v4.Schema$FindReplaceRequest = {\n      find,\n      replacement,\n      ...(matchCase !== undefined && { matchCase }),\n      ...(matchEntireCell !== undefined && { matchEntireCell }),\n      ...(searchByRegex !== undefined && { searchByRegex }),\n      ...(includeFormulas !== undefined && { includeFormulas }),\n    };\n\n    // Set scope based on gid/range\n    if (!gid) {\n      // No gid = search all sheets\n      findReplaceRequest.allSheets = true;\n    } else {\n      // Need to resolve sheet to get numeric sheetId\n      const spreadsheetResponse = await sheets.spreadsheets.get({\n        spreadsheetId: id,\n        fields: 'sheets.properties.sheetId,sheets.properties.title',\n      });\n\n      const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n      if (!sheet) {\n        throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n      }\n\n      // Note: sheetId can be 0 which is falsy, so check explicitly for undefined/null\n      const sheetId = sheet.properties?.sheetId;\n      if (sheetId === undefined || sheetId === null) {\n        throw new ProtocolError(ProtocolErrorCode.InternalError, 'Sheet properties not available');\n      }\n\n      if (!range) {\n        // gid but no range = search specific sheet\n        findReplaceRequest.sheetId = sheetId;\n      } else {\n        // gid + range = search specific range\n        const rangeRef = parseA1Notation(range);\n        findReplaceRequest.range = rangeReferenceToGridRange(rangeRef, sheetId);\n      }\n    }\n\n    // Execute batchUpdate\n    const response = await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [{ findReplace: findReplaceRequest }],\n      },\n    });\n\n    const findReplaceResponse = response.data.replies?.[0]?.findReplace;\n    const spreadsheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit`;\n\n    logger.info('sheets.values-replace completed', {\n      occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n      sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      spreadsheetUrl,\n      occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n      valuesChanged: findReplaceResponse?.valuesChanged ?? 0,\n      formulasChanged: findReplaceResponse?.formulasChanged ?? 0,\n      rowsChanged: findReplaceResponse?.rowsChanged ?? 0,\n      sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    if (error instanceof ProtocolError) {\n      throw error;\n    }\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Replace operation failed', {\n      id,\n      find,\n      replacement,\n      gid,\n      range,\n      error: message,\n    });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error replacing values: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-replace',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","find","string","min","describe","replacement","gid","SheetGidSchema","optional","range","A1NotationSchema","matchCase","boolean","matchEntireCell","searchByRegex","includeFormulas","refine","data","message","successBranchSchema","type","literal","SpreadsheetIdOutput","spreadsheetUrl","occurrencesChanged","number","int","nonnegative","valuesChanged","formulasChanged","rowsChanged","sheetsChanged","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","response","sheets","findReplaceRequest","spreadsheetResponse","sheet","sheetId","rangeRef","findReplaceResponse","error","info","google","version","auth","authContext","undefined","allSheets","spreadsheets","get","spreadsheetId","fields","s","String","properties","ProtocolError","ProtocolErrorCode","InvalidParams","InternalError","parseA1Notation","rangeReferenceToGridRange","batchUpdate","requestBody","requests","findReplace","replies","content","text","JSON","stringify","structuredContent","Error","stack","name"],"mappings":"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"}

package/dist/cjs/mcp/tools/values-search.d.cts

@@ -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/cjs/mcp/tools/values-search.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/cjs/mcp/tools/values-search.js

@@ -9,7 +9,7 @@ Object.defineProperty(exports, "default", {
     }
 });
 var _oauthgoogle = require("@mcp-z/oauth-google");
-var _types = require("@modelcontextprotocol/sdk/types.js");
+var _server = require("@mcp-z/server");
 var _googleapis = require("googleapis");
 var _zod = require("zod");
 var _indexts = require("../../schemas/index.js");
@@ -269,7 +269,7 @@ function handler(_0, _1) {
                             gid: gid,
                             query: query
                         });
-                        throw new _types.McpError(_types.ErrorCode.InvalidParams, 'Sheet not found');
+                        throw new _server.ProtocolError(_server.ProtocolErrorCode.InvalidParams, 'Sheet not found');
                     }
                     sheetTitle = (_ref = (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) !== null && _ref !== void 0 ? _ref : '';
                     // Use actual sheet dimensions from gridProperties, with sensible defaults
@@ -443,7 +443,7 @@ function handler(_0, _1) {
                     logger.error('sheets.values-search error', {
                         error: message
                     });
-                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error searching spreadsheet: ".concat(message), {
+                    throw new _server.ProtocolError(_server.ProtocolErrorCode.InternalError, "Error searching spreadsheet: ".concat(message), {
                         stack: _instanceof(error, Error) ? error.stack : undefined
                     });
                 case 5:

package/dist/cjs/mcp/tools/values-search.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-search.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 } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\n// Helper to convert column index to letter (0 = A, 1 = B, etc.)\nfunction columnIndexToLetter(index: number): string {\n  let letter = '';\n  let num = index + 1;\n  while (num > 0) {\n    const remainder = (num - 1) % 26;\n    letter = String.fromCharCode(65 + remainder) + letter;\n    num = Math.floor((num - 1) / 26);\n  }\n  return letter;\n}\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  query: z.coerce.string().trim().optional().describe('Text to search for in sheet cells. If empty, returns all data at specified granularity.'),\n  select: z.enum(['cells', 'rows', 'columns']).describe('Granularity: cells (individual matches), rows (full matching rows), columns (columns with matching headers)'),\n  values: z.boolean().optional().describe('Include cell values in response'),\n  a1s: z.boolean().optional().describe('Include A1 notation references in response'),\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  matchCase: z.boolean().optional().describe('Case-sensitive matching. Default is false (case-insensitive).'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  count: z.number().int().nonnegative().describe('Number of matches found'),\n  a1s: z.array(z.string()).optional().describe('A1 notation references for matches (e.g., \"B5\", \"A5:D5\", \"B:B\")'),\n  values: z\n    .array(z.union([z.array(SheetCellSchema), SheetCellSchema]))\n    .optional()\n    .describe('Cell values for matches (arrays for rows/columns, single values for cells)'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Search spreadsheet and return matches at cell, row, or column granularity. Use a1-notation prompt for range syntax.',\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, query, select, values = false, a1s = false, render, matchCase = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values-search called', { id, gid, query, select, values, a1s, render, matchCase });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get sheet details including grid dimensions\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title,sheets.properties.gridProperties',\n    });\n\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n\n    if (!sheet) {\n      logger.info('sheets.values-search sheet not found', { id, gid, query });\n      throw new McpError(ErrorCode.InvalidParams, 'Sheet not found');\n    }\n\n    const sheetTitle = sheet.properties?.title ?? '';\n\n    // Use actual sheet dimensions from gridProperties, with sensible defaults\n    // Google Sheets default for new sheets is 1000 rows x 26 columns\n    const rowCount = sheet.properties?.gridProperties?.rowCount ?? 1000;\n    const columnCount = sheet.properties?.gridProperties?.columnCount ?? 26;\n    const endColumn = columnIndexToLetter(columnCount - 1);\n    const fullRange = `${sheetTitle}!A1:${endColumn}${rowCount}`;\n\n    logger.debug?.('sheets.values-search fetching range', { fullRange, rowCount, columnCount });\n\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range: fullRange,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n    const res = response.data;\n    const allRows = Array.isArray(res.values) ? (res.values as (string | number | boolean | null)[][]) : [];\n\n    // Prepare query for matching (case-insensitive by default)\n    const searchQuery = query ? (matchCase ? query : query.toLowerCase()) : null;\n\n    let count = 0;\n    const a1Array: string[] = [];\n    const valuesArray: (string | number | boolean | null | (string | number | boolean | null)[])[] = [];\n\n    // Helper to check if a cell matches the query\n    const cellMatches = (cell: string | number | boolean | null): boolean => {\n      if (!searchQuery) return true; // If no query, match all\n      if (typeof cell !== 'string') return false;\n      const cellValue = matchCase ? cell : cell.toLowerCase();\n      return cellValue.includes(searchQuery);\n    };\n\n    if (select === 'cells') {\n      for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n        const row = allRows[rowIdx];\n        if (!row) continue;\n\n        for (let colIdx = 0; colIdx < row.length; colIdx++) {\n          const cell = row[colIdx];\n          if (cellMatches(cell)) {\n            count++;\n            if (a1s) {\n              const colLetter = columnIndexToLetter(colIdx);\n              const rowNum = rowIdx + 1;\n              a1Array.push(`${colLetter}${rowNum}`);\n            }\n            if (values) {\n              valuesArray.push(cell ?? null);\n            }\n          }\n        }\n      }\n    } else if (select === 'rows') {\n      const matchingRows: number[] = [];\n      for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n        const row = allRows[rowIdx];\n        if (!row) continue;\n\n        const matches = row.some((cell) => cellMatches(cell));\n        if (matches) {\n          matchingRows.push(rowIdx);\n        }\n      }\n\n      count = matchingRows.length;\n      for (const rowIdx of matchingRows) {\n        const row = allRows[rowIdx];\n        if (!row) continue; // Skip if row is undefined\n        const rowNum = rowIdx + 1;\n\n        if (a1s) {\n          const colEnd = columnIndexToLetter(Math.max(0, row.length - 1));\n          a1Array.push(`A${rowNum}:${colEnd}${rowNum}`);\n        }\n        if (values) {\n          valuesArray.push(row);\n        }\n      }\n    } else if (select === 'columns') {\n      const headerRow = allRows[0] || [];\n      const matchingCols: number[] = [];\n\n      for (let colIdx = 0; colIdx < headerRow.length; colIdx++) {\n        const header = headerRow[colIdx];\n        if (cellMatches(header)) {\n          matchingCols.push(colIdx);\n        }\n      }\n\n      count = matchingCols.length;\n      for (const colIdx of matchingCols) {\n        const colLetter = columnIndexToLetter(colIdx);\n\n        if (a1s) {\n          a1Array.push(`${colLetter}:${colLetter}`);\n        }\n        if (values) {\n          const columnValues = allRows.map((row) => (row && row[colIdx] !== undefined ? row[colIdx] : null));\n          valuesArray.push(columnValues);\n        }\n      }\n    }\n\n    logger.info('sheets.values-search results', { count, select, hasA1s: a1s, hasValues: values });\n\n    const result: Output = {\n      type: 'success' as const,\n      count,\n      ...(a1s && a1Array.length > 0 && { a1s: a1Array }),\n      ...(values && valuesArray.length > 0 && { values: valuesArray }),\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('sheets.values-search error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error searching spreadsheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-search',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","columnIndexToLetter","index","letter","num","remainder","String","fromCharCode","Math","floor","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","query","coerce","string","trim","optional","describe","select","enum","values","boolean","a1s","render","matchCase","successBranchSchema","type","literal","count","number","int","nonnegative","array","union","SheetCellSchema","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetResponse","sheet","sheets","sheetTitle","rowCount","columnCount","endColumn","fullRange","response","res","allRows","searchQuery","a1Array","valuesArray","cellMatches","rowIdx","row","colIdx","cell","colLetter","rowNum","matchingRows","matches","colEnd","headerRow","matchingCols","header","error","message","info","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","properties","sheetId","McpError","ErrorCode","InvalidParams","title","gridProperties","debug","range","valueRenderOption","Array","isArray","toLowerCase","cellValue","includes","length","push","some","max","columnValues","map","undefined","hasA1s","hasValues","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-search.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 } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\n// Helper to convert column index to letter (0 = A, 1 = B, etc.)\nfunction columnIndexToLetter(index: number): string {\n  let letter = '';\n  let num = index + 1;\n  while (num > 0) {\n    const remainder = (num - 1) % 26;\n    letter = String.fromCharCode(65 + remainder) + letter;\n    num = Math.floor((num - 1) / 26);\n  }\n  return letter;\n}\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  query: z.coerce.string().trim().optional().describe('Text to search for in sheet cells. If empty, returns all data at specified granularity.'),\n  select: z.enum(['cells', 'rows', 'columns']).describe('Granularity: cells (individual matches), rows (full matching rows), columns (columns with matching headers)'),\n  values: z.boolean().optional().describe('Include cell values in response'),\n  a1s: z.boolean().optional().describe('Include A1 notation references in response'),\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  matchCase: z.boolean().optional().describe('Case-sensitive matching. Default is false (case-insensitive).'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  count: z.number().int().nonnegative().describe('Number of matches found'),\n  a1s: z.array(z.string()).optional().describe('A1 notation references for matches (e.g., \"B5\", \"A5:D5\", \"B:B\")'),\n  values: z\n    .array(z.union([z.array(SheetCellSchema), SheetCellSchema]))\n    .optional()\n    .describe('Cell values for matches (arrays for rows/columns, single values for cells)'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Search spreadsheet and return matches at cell, row, or column granularity. Use a1-notation prompt for range syntax.',\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, query, select, values = false, a1s = false, render, matchCase = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values-search called', { id, gid, query, select, values, a1s, render, matchCase });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get sheet details including grid dimensions\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title,sheets.properties.gridProperties',\n    });\n\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n\n    if (!sheet) {\n      logger.info('sheets.values-search sheet not found', { id, gid, query });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');\n    }\n\n    const sheetTitle = sheet.properties?.title ?? '';\n\n    // Use actual sheet dimensions from gridProperties, with sensible defaults\n    // Google Sheets default for new sheets is 1000 rows x 26 columns\n    const rowCount = sheet.properties?.gridProperties?.rowCount ?? 1000;\n    const columnCount = sheet.properties?.gridProperties?.columnCount ?? 26;\n    const endColumn = columnIndexToLetter(columnCount - 1);\n    const fullRange = `${sheetTitle}!A1:${endColumn}${rowCount}`;\n\n    logger.debug?.('sheets.values-search fetching range', { fullRange, rowCount, columnCount });\n\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range: fullRange,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n    const res = response.data;\n    const allRows = Array.isArray(res.values) ? (res.values as (string | number | boolean | null)[][]) : [];\n\n    // Prepare query for matching (case-insensitive by default)\n    const searchQuery = query ? (matchCase ? query : query.toLowerCase()) : null;\n\n    let count = 0;\n    const a1Array: string[] = [];\n    const valuesArray: (string | number | boolean | null | (string | number | boolean | null)[])[] = [];\n\n    // Helper to check if a cell matches the query\n    const cellMatches = (cell: string | number | boolean | null): boolean => {\n      if (!searchQuery) return true; // If no query, match all\n      if (typeof cell !== 'string') return false;\n      const cellValue = matchCase ? cell : cell.toLowerCase();\n      return cellValue.includes(searchQuery);\n    };\n\n    if (select === 'cells') {\n      for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n        const row = allRows[rowIdx];\n        if (!row) continue;\n\n        for (let colIdx = 0; colIdx < row.length; colIdx++) {\n          const cell = row[colIdx];\n          if (cellMatches(cell)) {\n            count++;\n            if (a1s) {\n              const colLetter = columnIndexToLetter(colIdx);\n              const rowNum = rowIdx + 1;\n              a1Array.push(`${colLetter}${rowNum}`);\n            }\n            if (values) {\n              valuesArray.push(cell ?? null);\n            }\n          }\n        }\n      }\n    } else if (select === 'rows') {\n      const matchingRows: number[] = [];\n      for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n        const row = allRows[rowIdx];\n        if (!row) continue;\n\n        const matches = row.some((cell) => cellMatches(cell));\n        if (matches) {\n          matchingRows.push(rowIdx);\n        }\n      }\n\n      count = matchingRows.length;\n      for (const rowIdx of matchingRows) {\n        const row = allRows[rowIdx];\n        if (!row) continue; // Skip if row is undefined\n        const rowNum = rowIdx + 1;\n\n        if (a1s) {\n          const colEnd = columnIndexToLetter(Math.max(0, row.length - 1));\n          a1Array.push(`A${rowNum}:${colEnd}${rowNum}`);\n        }\n        if (values) {\n          valuesArray.push(row);\n        }\n      }\n    } else if (select === 'columns') {\n      const headerRow = allRows[0] || [];\n      const matchingCols: number[] = [];\n\n      for (let colIdx = 0; colIdx < headerRow.length; colIdx++) {\n        const header = headerRow[colIdx];\n        if (cellMatches(header)) {\n          matchingCols.push(colIdx);\n        }\n      }\n\n      count = matchingCols.length;\n      for (const colIdx of matchingCols) {\n        const colLetter = columnIndexToLetter(colIdx);\n\n        if (a1s) {\n          a1Array.push(`${colLetter}:${colLetter}`);\n        }\n        if (values) {\n          const columnValues = allRows.map((row) => (row && row[colIdx] !== undefined ? row[colIdx] : null));\n          valuesArray.push(columnValues);\n        }\n      }\n    }\n\n    logger.info('sheets.values-search results', { count, select, hasA1s: a1s, hasValues: values });\n\n    const result: Output = {\n      type: 'success' as const,\n      count,\n      ...(a1s && a1Array.length > 0 && { a1s: a1Array }),\n      ...(values && valuesArray.length > 0 && { values: valuesArray }),\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('sheets.values-search error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error searching spreadsheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-search',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","columnIndexToLetter","index","letter","num","remainder","String","fromCharCode","Math","floor","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","query","coerce","string","trim","optional","describe","select","enum","values","boolean","a1s","render","matchCase","successBranchSchema","type","literal","count","number","int","nonnegative","array","union","SheetCellSchema","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetResponse","sheet","sheets","sheetTitle","rowCount","columnCount","endColumn","fullRange","response","res","allRows","searchQuery","a1Array","valuesArray","cellMatches","rowIdx","row","colIdx","cell","colLetter","rowNum","matchingRows","matches","colEnd","headerRow","matchingCols","header","error","message","info","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","properties","sheetId","ProtocolError","ProtocolErrorCode","InvalidParams","title","gridProperties","debug","range","valueRenderOption","Array","isArray","toLowerCase","cellValue","includes","length","push","some","max","columnValues","map","undefined","hasA1s","hasValues","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","name"],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { McpServer } from '@mcp-z/server';
 import type { RuntimeOverrides, ServerConfig } from '../types.js';
 export declare function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides): Promise<{
     httpServer: import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>;

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

@@ -1,4 +1,4 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { McpServer } from '@mcp-z/server';
 import type { RuntimeOverrides, ServerConfig } from '../types.js';
 export declare function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides): Promise<{
     httpServer: import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>;

package/dist/cjs/setup/http.js

@@ -9,7 +9,6 @@ Object.defineProperty(exports, "createHTTPServer", {
     }
 });
 var _server = require("@mcp-z/server");
-var _mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var _cors = /*#__PURE__*/ _interop_require_default(require("cors"));
 var _express = /*#__PURE__*/ _interop_require_default(require("express"));
 var _runtimets = require("./runtime.js");
@@ -172,7 +171,7 @@ function _unsupported_iterable_to_array(o, minLen) {
 }
 function createHTTPServer(config, overrides) {
     return _async_to_generator(function() {
-        var runtime, modules, layers, composed, logger, port, tools, prompts, mcpServer, app, _ref, close, httpServer;
+        var runtime, modules, layers, composed, logger, port, tools, prompts, mcpServer, app, publicUrl, _ref, close, httpServer;
         return _ts_generator(this, function(_state) {
             switch(_state.label){
                 case 0:
@@ -192,7 +191,7 @@ function createHTTPServer(config, overrides) {
                     if (!port) throw new Error('Port is required for HTTP transport');
                     tools = _to_consumable_array(composed.tools).concat(_to_consumable_array(runtime.deps.oauthAdapters.accountTools));
                     prompts = _to_consumable_array(composed.prompts).concat(_to_consumable_array(runtime.deps.oauthAdapters.accountPrompts));
-                    mcpServer = new _mcp.McpServer({
+                    mcpServer = new _server.McpServer({
                         name: config.name,
                         version: config.version
                     });
@@ -200,29 +199,40 @@ function createHTTPServer(config, overrides) {
                     (0, _server.registerResources)(mcpServer, composed.resources);
                     (0, _server.registerPrompts)(mcpServer, prompts);
                     app = (0, _express.default)();
-                    app.use((0, _cors.default)());
                     app.use(_express.default.json({
                         limit: '10mb'
                     }));
-                    if (runtime.deps.oauthAdapters.loopbackRouter) {
-                        app.use('/', runtime.deps.oauthAdapters.loopbackRouter);
-                        logger.info('Mounted loopback OAuth callback router');
-                    }
-                    if (runtime.deps.oauthAdapters.dcrRouter) {
-                        app.use('/', runtime.deps.oauthAdapters.dcrRouter);
-                        logger.info('Mounted DCR router with OAuth endpoints');
-                    }
+                    // Must mount '/mcp' before any permissive app-level cors(), or that layer answers its
+                    // preflight first; pass baseUrl's origin/host below or a public deployment 403s itself.
+                    publicUrl = config.baseUrl ? new URL(config.baseUrl) : undefined;
                     logger.info("Starting ".concat(config.name, " MCP server (http)"));
                     return [
                         4,
                         (0, _server.connectHttp)(mcpServer, {
                             logger: logger,
                             app: app,
-                            port: port
+                            port: port,
+                            allowedOrigins: publicUrl ? [
+                                publicUrl.origin
+                            ] : undefined,
+                            allowedHosts: publicUrl ? [
+                                publicUrl.host
+                            ] : undefined
                         })
                     ];
                 case 2:
                     _ref = _state.sent(), close = _ref.close, httpServer = _ref.httpServer;
+                    // The loopback OAuth callback and the DCR discovery/registration endpoints are
+                    // meant to be reached from a browser on another origin. Keep cors() for them,
+                    // scoped to their own routes - never in front of '/mcp'.
+                    if (runtime.deps.oauthAdapters.loopbackRouter) {
+                        app.use('/', (0, _cors.default)(), runtime.deps.oauthAdapters.loopbackRouter);
+                        logger.info('Mounted loopback OAuth callback router');
+                    }
+                    if (runtime.deps.oauthAdapters.dcrRouter) {
+                        app.use('/', (0, _cors.default)(), runtime.deps.oauthAdapters.dcrRouter);
+                        logger.info('Mounted DCR router with OAuth endpoints');
+                    }
                     logger.info('http transport ready');
                     return [
                         2,