@mcp-z/mcp-sheets 1.2.4 → 1.3.0

package/dist/esm/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":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","parse","google","z","A1NotationSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","getCsvReadStream","BATCH_SIZE","inputSchema","object","id","gid","sourceUri","string","trim","min","describe","startRange","default","valueInputOption","enum","sourceHasHeaders","boolean","successBranchSchema","type","literal","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRange","updatedRows","number","updatedColumns","updatedCells","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","sheet","spreadsheetData","batchUpdateResponse","sheets","version","auth","authContext","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","sourceHeaders","allRows","totalCols","readStream","parser","pipe","columns","skip_empty_lines","cast","relax_column_count","record","length","Object","keys","row","map","header","push","dataToWrite","batchRequests","currentRow","match","currentRowNum","Number","parseInt","i","batchData","slice","batchRange","range","values","totalBatches","batchSize","batchUpdate","requestBody","totalUpdatedCells","totalUpdatedRows","totalUpdatedColumns","firstUpdatedRange","responses","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","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 { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { parse } from 'csv-parse';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\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 = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: '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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","parse","z","googleAuth","A1NotationSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","getCsvReadStream","BATCH_SIZE","inputSchema","object","id","gid","sourceUri","string","trim","min","describe","startRange","default","valueInputOption","enum","sourceHasHeaders","boolean","successBranchSchema","type","literal","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRange","updatedRows","number","updatedColumns","updatedCells","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","sheet","spreadsheetData","batchUpdateResponse","version","auth","authContext","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","sourceHeaders","allRows","totalCols","readStream","parser","pipe","columns","skip_empty_lines","cast","relax_column_count","record","length","Object","keys","row","map","header","push","dataToWrite","batchRequests","currentRow","match","currentRowNum","Number","parseInt","i","batchData","slice","batchRange","range","values","totalBatches","batchSize","batchUpdate","requestBody","totalUpdatedCells","totalUpdatedRows","totalUpdatedColumns","firstUpdatedRange","responses","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

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

@@ -1,8 +1,9 @@
+import { sheets as sheetsApi } from '@googleapis/sheets';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { google } from 'googleapis';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { z } from 'zod';
+import { googleAuth } from '../../lib/google-auth.js';
 import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
 import { buildTextFormatRuns, parseInlineMarkdown } from '../../spreadsheet/markdown-runs.js';
 import { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.js';
@@ -54,9 +55,9 @@ async function handler({ id, gid, requests }, extra) {
     try {
         var _sheet_properties_title, _sheet_properties_sheetId;
         var _spreadsheetResponse_data_sheets;
-        const sheets = google.sheets({
+        const sheets = sheetsApi({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         // Get spreadsheet and sheet info in single API call
         const spreadsheetResponse = await sheets.spreadsheets.get({
@@ -74,7 +75,7 @@ async function handler({ id, gid, requests }, extra) {
                 gid,
                 requestCount: requests.length
             });
-            throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);
         }
         const sheetTitle = (_sheet_properties_title = sheet.properties.title) !== null && _sheet_properties_title !== void 0 ? _sheet_properties_title : gid;
         // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).
@@ -191,8 +192,8 @@ async function handler({ id, gid, requests }, extra) {
             }
         };
     } catch (error) {
-        // Re-throw McpError as-is
-        if (error instanceof McpError) {
+        // Re-throw ProtocolError as-is
+        if (error instanceof ProtocolError) {
             throw error;
         }
         const message = error instanceof Error ? error.message : String(error);
@@ -202,7 +203,7 @@ async function handler({ id, gid, requests }, extra) {
             requestCount: requests.length,
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error writing markdown to cells: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error writing markdown to cells: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

package/dist/esm/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":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","buildTextFormatRuns","parseInlineMarkdown","parseA1Notation","rangeReferenceToGridRange","MarkdownCellRequestSchema","object","cell","string","min","describe","text","inputSchema","id","gid","requests","array","max","successBranchSchema","type","literal","sheetTitle","sheetUrl","successCount","number","int","nonnegative","cells","linkCount","failedCells","error","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","requestCount","length","sheet","spreadsheetResponse","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","batchRequests","request","rangeRef","Error","gridRange","parsed","runs","push","updateCells","range","rows","values","userEnteredValue","stringValue","textFormatRuns","message","undefined","content","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","createTool","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-markdown-update.ts"],"sourcesContent":["import { type sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { 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 = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for 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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","buildTextFormatRuns","parseInlineMarkdown","parseA1Notation","rangeReferenceToGridRange","MarkdownCellRequestSchema","object","cell","string","min","describe","text","inputSchema","id","gid","requests","array","max","successBranchSchema","type","literal","sheetTitle","sheetUrl","successCount","number","int","nonnegative","cells","linkCount","failedCells","error","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","requestCount","length","sheet","spreadsheetResponse","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","batchRequests","request","rangeRef","Error","gridRange","parsed","runs","push","updateCells","range","rows","values","userEnteredValue","stringValue","textFormatRuns","message","undefined","content","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","createTool","name"],"mappings":"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"}

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

@@ -1,8 +1,9 @@
+import { sheets as sheetsApi } from '@googleapis/sheets';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { google } from 'googleapis';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { z } from 'zod';
+import { googleAuth } from '../../lib/google-auth.js';
 import { A1NotationSchema, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
 import { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.js';
 const inputSchema = z.object({
@@ -53,9 +54,9 @@ async function handler({ id, find, replacement, gid, range, matchCase, matchEnti
     try {
         var _ref, _ref1, _ref2, _ref3, _ref4, _ref5, _ref6;
         var _response_data_replies_, _response_data_replies;
-        const sheets = google.sheets({
+        const sheets = sheetsApi({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         // Build FindReplaceRequest - only include defined options
         const findReplaceRequest = {
@@ -90,12 +91,12 @@ async function handler({ id, find, replacement, gid, range, matchCase, matchEnti
                 return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === gid;
             });
             if (!sheet) {
-                throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);
+                throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);
             }
             // Note: sheetId can be 0 which is falsy, so check explicitly for undefined/null
             const sheetId = (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.sheetId;
             if (sheetId === undefined || sheetId === null) {
-                throw new McpError(ErrorCode.InternalError, 'Sheet properties not available');
+                throw new ProtocolError(ProtocolErrorCode.InternalError, 'Sheet properties not available');
             }
             if (!range) {
                 // gid but no range = search specific sheet
@@ -145,7 +146,7 @@ async function handler({ id, find, replacement, gid, range, matchCase, matchEnti
             }
         };
     } catch (error) {
-        if (error instanceof McpError) {
+        if (error instanceof ProtocolError) {
             throw error;
         }
         const message = error instanceof Error ? error.message : String(error);
@@ -157,7 +158,7 @@ async function handler({ id, find, replacement, gid, range, matchCase, matchEnti
             range,
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error replacing values: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error replacing values: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

package/dist/esm/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":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","A1NotationSchema","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","inputSchema","object","id","find","string","min","describe","replacement","gid","optional","range","matchCase","boolean","matchEntireCell","searchByRegex","includeFormulas","refine","data","message","successBranchSchema","type","literal","spreadsheetUrl","occurrencesChanged","number","int","nonnegative","valuesChanged","formulasChanged","rowsChanged","sheetsChanged","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","response","sheets","version","auth","authContext","findReplaceRequest","undefined","allSheets","spreadsheetResponse","sheet","spreadsheets","get","spreadsheetId","fields","s","String","properties","sheetId","InvalidParams","InternalError","rangeRef","batchUpdate","requestBody","requests","findReplace","findReplaceResponse","replies","content","text","JSON","stringify","structuredContent","error","Error","stack","createTool","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 sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { 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 = sheetsApi({ version: 'v4', auth: googleAuth(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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","A1NotationSchema","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","inputSchema","object","id","find","string","min","describe","replacement","gid","optional","range","matchCase","boolean","matchEntireCell","searchByRegex","includeFormulas","refine","data","message","successBranchSchema","type","literal","spreadsheetUrl","occurrencesChanged","number","int","nonnegative","valuesChanged","formulasChanged","rowsChanged","sheetsChanged","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","response","version","auth","authContext","findReplaceRequest","undefined","allSheets","spreadsheetResponse","sheet","spreadsheets","get","spreadsheetId","fields","s","String","properties","sheetId","InvalidParams","InternalError","rangeRef","batchUpdate","requestBody","requests","findReplace","findReplaceResponse","replies","content","text","JSON","stringify","structuredContent","error","Error","stack","createTool","name"],"mappings":"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"}

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

@@ -1,8 +1,9 @@
+import { sheets as sheetsApi } from '@googleapis/sheets';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { google } from 'googleapis';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { z } from 'zod';
+import { googleAuth } from '../../lib/google-auth.js';
 import { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.js';
 // Helper to convert column index to letter (0 = A, 1 = B, etc.)
 function columnIndexToLetter(index) {
@@ -68,9 +69,9 @@ async function handler({ id, gid, query, select, values = false, a1s = false, re
     try {
         var _ref, _ref1, _ref2;
         var _spreadsheetResponse_data_sheets, _sheet_properties, _sheet_properties_gridProperties, _sheet_properties1, _sheet_properties_gridProperties1, _sheet_properties2, _logger_debug;
-        const sheets = google.sheets({
+        const sheets = sheetsApi({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         // Get sheet details including grid dimensions
         const spreadsheetResponse = await sheets.spreadsheets.get({
@@ -87,7 +88,7 @@ async function handler({ id, gid, query, select, values = false, a1s = false, re
                 gid,
                 query
             });
-            throw new McpError(ErrorCode.InvalidParams, 'Sheet not found');
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');
         }
         const 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
@@ -215,7 +216,7 @@ async function handler({ id, gid, query, select, values = false, a1s = false, re
         logger.error('sheets.values-search error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error searching spreadsheet: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error searching spreadsheet: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

package/dist/esm/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":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetCellSchema","SheetGidSchema","SpreadsheetIdSchema","columnIndexToLetter","index","letter","num","remainder","String","fromCharCode","Math","floor","inputSchema","object","id","gid","query","coerce","string","trim","optional","describe","select","enum","values","boolean","a1s","render","matchCase","successBranchSchema","type","literal","count","number","int","nonnegative","array","union","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","spreadsheetResponse","sheet","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","properties","sheetId","InvalidParams","sheetTitle","title","rowCount","gridProperties","columnCount","endColumn","fullRange","debug","response","range","valueRenderOption","res","allRows","Array","isArray","searchQuery","toLowerCase","a1Array","valuesArray","cellMatches","cell","cellValue","includes","rowIdx","length","row","colIdx","colLetter","rowNum","push","matchingRows","matches","some","colEnd","max","headerRow","matchingCols","header","columnValues","map","undefined","hasA1s","hasValues","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","createTool","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 { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { 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 = sheetsApi({ version: 'v4', auth: googleAuth(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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetCellSchema","SheetGidSchema","SpreadsheetIdSchema","columnIndexToLetter","index","letter","num","remainder","String","fromCharCode","Math","floor","inputSchema","object","id","gid","query","coerce","string","trim","optional","describe","select","enum","values","boolean","a1s","render","matchCase","successBranchSchema","type","literal","count","number","int","nonnegative","array","union","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","spreadsheetResponse","sheet","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","properties","sheetId","InvalidParams","sheetTitle","title","rowCount","gridProperties","columnCount","endColumn","fullRange","debug","response","range","valueRenderOption","res","allRows","Array","isArray","searchQuery","toLowerCase","a1Array","valuesArray","cellMatches","cell","cellValue","includes","rowIdx","length","row","colIdx","colLetter","rowNum","push","matchingRows","matches","some","colEnd","max","headerRow","matchingCols","header","columnValues","map","undefined","hasA1s","hasValues","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","createTool","name"],"mappings":"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"}

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

@@ -1,8 +1,6 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 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>;
-    mcpServer: McpServer;
     logger: import("@mcp-z/server").Logger;
     close: () => Promise<void>;
 }>;

package/dist/esm/setup/http.js

@@ -1,5 +1,4 @@
-import { composeMiddleware, connectHttp, registerPrompts, registerResources, registerTools } from '@mcp-z/server';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { composeMiddleware, connectHttp, defaultCacheHints, McpServer, registerPrompts, registerResources, registerTools } from '@mcp-z/server';
 import cors from 'cors';
 import express from 'express';
 import { createDefaultRuntime } from './runtime.js';
@@ -19,13 +18,22 @@ export async function createHTTPServer(config, overrides) {
         ...composed.prompts,
         ...runtime.deps.oauthAdapters.accountPrompts
     ];
-    const mcpServer = new McpServer({
-        name: config.name,
-        version: config.version
-    });
-    registerTools(mcpServer, tools);
-    registerResources(mcpServer, composed.resources);
-    registerPrompts(mcpServer, prompts);
+    // Built per request (HTTP) and per connection (stdio), not shared. The SDK caches the
+    // negotiated protocol revision on the McpServer instance - its own docs say a negotiated
+    // session never re-routes a method onto the other era - so one shared instance pins itself
+    // to whichever revision reaches it first and answers the other with -32601.
+    const buildServer = ()=>{
+        const mcpServer = new McpServer({
+            name: config.name,
+            version: config.version
+        }, {
+            cacheHints: defaultCacheHints
+        });
+        registerTools(mcpServer, tools);
+        registerResources(mcpServer, composed.resources);
+        registerPrompts(mcpServer, prompts);
+        return mcpServer;
+    };
     const app = express();
     app.use(express.json({
         limit: '10mb'
@@ -34,7 +42,7 @@ export async function createHTTPServer(config, overrides) {
     // preflight first; pass baseUrl's origin/host below or a public deployment 403s itself.
     const publicUrl = config.baseUrl ? new URL(config.baseUrl) : undefined;
     logger.info(`Starting ${config.name} MCP server (http)`);
-    const { close, httpServer } = await connectHttp(mcpServer, {
+    const { close, httpServer } = await connectHttp(buildServer, {
         logger,
         app,
         port,
@@ -59,7 +67,6 @@ export async function createHTTPServer(config, overrides) {
     logger.info('http transport ready');
     return {
         httpServer,
-        mcpServer,
         logger,
         close: async ()=>{
             await close();

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/setup/http.ts"],"sourcesContent":["import { composeMiddleware, connectHttp, registerPrompts, registerResources, registerTools } from '@mcp-z/server';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport cors from 'cors';\nimport express from 'express';\nimport type { RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createDefaultRuntime } from './runtime.ts';\n\nexport async function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides) {\n  const runtime = await createDefaultRuntime(config, overrides);\n  const modules = runtime.createDomainModules();\n  const layers = runtime.middlewareFactories.map((factory) => factory(runtime.deps));\n  const composed = composeMiddleware(modules, layers);\n  const logger = runtime.deps.logger;\n  const port = config.transport.port;\n  if (!port) throw new Error('Port is required for HTTP transport');\n\n  const tools = [...composed.tools, ...runtime.deps.oauthAdapters.accountTools];\n  const prompts = [...composed.prompts, ...runtime.deps.oauthAdapters.accountPrompts];\n\n  const mcpServer = new McpServer({ name: config.name, version: config.version });\n  registerTools(mcpServer, tools);\n  registerResources(mcpServer, composed.resources);\n  registerPrompts(mcpServer, prompts);\n\n  const app = express();\n  app.use(express.json({ limit: '10mb' }));\n\n  // Must mount '/mcp' before any permissive app-level cors(), or that layer answers its\n  // preflight first; pass baseUrl's origin/host below or a public deployment 403s itself.\n  const publicUrl = config.baseUrl ? new URL(config.baseUrl) : undefined;\n  logger.info(`Starting ${config.name} MCP server (http)`);\n  const { close, httpServer } = await connectHttp(mcpServer, {\n    logger,\n    app,\n    port,\n    allowedOrigins: publicUrl ? [publicUrl.origin] : undefined,\n    allowedHosts: publicUrl ? [publicUrl.host] : undefined,\n  });\n\n  // The loopback OAuth callback and the DCR discovery/registration endpoints are\n  // meant to be reached from a browser on another origin. Keep cors() for them,\n  // scoped to their own routes - never in front of '/mcp'.\n  if (runtime.deps.oauthAdapters.loopbackRouter) {\n    app.use('/', cors(), runtime.deps.oauthAdapters.loopbackRouter);\n    logger.info('Mounted loopback OAuth callback router');\n  }\n\n  if (runtime.deps.oauthAdapters.dcrRouter) {\n    app.use('/', cors(), runtime.deps.oauthAdapters.dcrRouter);\n    logger.info('Mounted DCR router with OAuth endpoints');\n  }\n\n  logger.info('http transport ready');\n\n  return {\n    httpServer,\n    mcpServer,\n    logger,\n    close: async () => {\n      await close();\n      await runtime.close();\n    },\n  };\n}\n"],"names":["composeMiddleware","connectHttp","registerPrompts","registerResources","registerTools","McpServer","cors","express","createDefaultRuntime","createHTTPServer","config","overrides","runtime","modules","createDomainModules","layers","middlewareFactories","map","factory","deps","composed","logger","port","transport","Error","tools","oauthAdapters","accountTools","prompts","accountPrompts","mcpServer","name","version","resources","app","use","json","limit","publicUrl","baseUrl","URL","undefined","info","close","httpServer","allowedOrigins","origin","allowedHosts","host","loopbackRouter","dcrRouter"],"mappings":"AAAA,SAASA,iBAAiB,EAAEC,WAAW,EAAEC,eAAe,EAAEC,iBAAiB,EAAEC,aAAa,QAAQ,gBAAgB;AAClH,SAASC,SAAS,QAAQ,0CAA0C;AACpE,OAAOC,UAAU,OAAO;AACxB,OAAOC,aAAa,UAAU;AAE9B,SAASC,oBAAoB,QAAQ,eAAe;AAEpD,OAAO,eAAeC,iBAAiBC,MAAoB,EAAEC,SAA4B;IACvF,MAAMC,UAAU,MAAMJ,qBAAqBE,QAAQC;IACnD,MAAME,UAAUD,QAAQE,mBAAmB;IAC3C,MAAMC,SAASH,QAAQI,mBAAmB,CAACC,GAAG,CAAC,CAACC,UAAYA,QAAQN,QAAQO,IAAI;IAChF,MAAMC,WAAWpB,kBAAkBa,SAASE;IAC5C,MAAMM,SAAST,QAAQO,IAAI,CAACE,MAAM;IAClC,MAAMC,OAAOZ,OAAOa,SAAS,CAACD,IAAI;IAClC,IAAI,CAACA,MAAM,MAAM,IAAIE,MAAM;IAE3B,MAAMC,QAAQ;WAAIL,SAASK,KAAK;WAAKb,QAAQO,IAAI,CAACO,aAAa,CAACC,YAAY;KAAC;IAC7E,MAAMC,UAAU;WAAIR,SAASQ,OAAO;WAAKhB,QAAQO,IAAI,CAACO,aAAa,CAACG,cAAc;KAAC;IAEnF,MAAMC,YAAY,IAAIzB,UAAU;QAAE0B,MAAMrB,OAAOqB,IAAI;QAAEC,SAAStB,OAAOsB,OAAO;IAAC;IAC7E5B,cAAc0B,WAAWL;IACzBtB,kBAAkB2B,WAAWV,SAASa,SAAS;IAC/C/B,gBAAgB4B,WAAWF;IAE3B,MAAMM,MAAM3B;IACZ2B,IAAIC,GAAG,CAAC5B,QAAQ6B,IAAI,CAAC;QAAEC,OAAO;IAAO;IAErC,sFAAsF;IACtF,wFAAwF;IACxF,MAAMC,YAAY5B,OAAO6B,OAAO,GAAG,IAAIC,IAAI9B,OAAO6B,OAAO,IAAIE;IAC7DpB,OAAOqB,IAAI,CAAC,CAAC,SAAS,EAAEhC,OAAOqB,IAAI,CAAC,kBAAkB,CAAC;IACvD,MAAM,EAAEY,KAAK,EAAEC,UAAU,EAAE,GAAG,MAAM3C,YAAY6B,WAAW;QACzDT;QACAa;QACAZ;QACAuB,gBAAgBP,YAAY;YAACA,UAAUQ,MAAM;SAAC,GAAGL;QACjDM,cAAcT,YAAY;YAACA,UAAUU,IAAI;SAAC,GAAGP;IAC/C;IAEA,+EAA+E;IAC/E,8EAA8E;IAC9E,yDAAyD;IACzD,IAAI7B,QAAQO,IAAI,CAACO,aAAa,CAACuB,cAAc,EAAE;QAC7Cf,IAAIC,GAAG,CAAC,KAAK7B,QAAQM,QAAQO,IAAI,CAACO,aAAa,CAACuB,cAAc;QAC9D5B,OAAOqB,IAAI,CAAC;IACd;IAEA,IAAI9B,QAAQO,IAAI,CAACO,aAAa,CAACwB,SAAS,EAAE;QACxChB,IAAIC,GAAG,CAAC,KAAK7B,QAAQM,QAAQO,IAAI,CAACO,aAAa,CAACwB,SAAS;QACzD7B,OAAOqB,IAAI,CAAC;IACd;IAEArB,OAAOqB,IAAI,CAAC;IAEZ,OAAO;QACLE;QACAd;QACAT;QACAsB,OAAO;YACL,MAAMA;YACN,MAAM/B,QAAQ+B,KAAK;QACrB;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/setup/http.ts"],"sourcesContent":["import { composeMiddleware, connectHttp, defaultCacheHints, McpServer, registerPrompts, registerResources, registerTools } from '@mcp-z/server';\nimport cors from 'cors';\nimport express from 'express';\nimport type { RuntimeOverrides, ServerConfig } from '../types.ts';\nimport { createDefaultRuntime } from './runtime.ts';\n\nexport async function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides) {\n  const runtime = await createDefaultRuntime(config, overrides);\n  const modules = runtime.createDomainModules();\n  const layers = runtime.middlewareFactories.map((factory) => factory(runtime.deps));\n  const composed = composeMiddleware(modules, layers);\n  const logger = runtime.deps.logger;\n  const port = config.transport.port;\n  if (!port) throw new Error('Port is required for HTTP transport');\n\n  const tools = [...composed.tools, ...runtime.deps.oauthAdapters.accountTools];\n  const prompts = [...composed.prompts, ...runtime.deps.oauthAdapters.accountPrompts];\n\n  // Built per request (HTTP) and per connection (stdio), not shared. The SDK caches the\n  // negotiated protocol revision on the McpServer instance - its own docs say a negotiated\n  // session never re-routes a method onto the other era - so one shared instance pins itself\n  // to whichever revision reaches it first and answers the other with -32601.\n  const buildServer = () => {\n    const mcpServer = new McpServer({ name: config.name, version: config.version }, { cacheHints: defaultCacheHints });\n    registerTools(mcpServer, tools);\n    registerResources(mcpServer, composed.resources);\n    registerPrompts(mcpServer, prompts);\n    return mcpServer;\n  };\n\n  const app = express();\n  app.use(express.json({ limit: '10mb' }));\n\n  // Must mount '/mcp' before any permissive app-level cors(), or that layer answers its\n  // preflight first; pass baseUrl's origin/host below or a public deployment 403s itself.\n  const publicUrl = config.baseUrl ? new URL(config.baseUrl) : undefined;\n  logger.info(`Starting ${config.name} MCP server (http)`);\n  const { close, httpServer } = await connectHttp(buildServer, {\n    logger,\n    app,\n    port,\n    allowedOrigins: publicUrl ? [publicUrl.origin] : undefined,\n    allowedHosts: publicUrl ? [publicUrl.host] : undefined,\n  });\n\n  // The loopback OAuth callback and the DCR discovery/registration endpoints are\n  // meant to be reached from a browser on another origin. Keep cors() for them,\n  // scoped to their own routes - never in front of '/mcp'.\n  if (runtime.deps.oauthAdapters.loopbackRouter) {\n    app.use('/', cors(), runtime.deps.oauthAdapters.loopbackRouter);\n    logger.info('Mounted loopback OAuth callback router');\n  }\n\n  if (runtime.deps.oauthAdapters.dcrRouter) {\n    app.use('/', cors(), runtime.deps.oauthAdapters.dcrRouter);\n    logger.info('Mounted DCR router with OAuth endpoints');\n  }\n\n  logger.info('http transport ready');\n\n  return {\n    httpServer,\n    logger,\n    close: async () => {\n      await close();\n      await runtime.close();\n    },\n  };\n}\n"],"names":["composeMiddleware","connectHttp","defaultCacheHints","McpServer","registerPrompts","registerResources","registerTools","cors","express","createDefaultRuntime","createHTTPServer","config","overrides","runtime","modules","createDomainModules","layers","middlewareFactories","map","factory","deps","composed","logger","port","transport","Error","tools","oauthAdapters","accountTools","prompts","accountPrompts","buildServer","mcpServer","name","version","cacheHints","resources","app","use","json","limit","publicUrl","baseUrl","URL","undefined","info","close","httpServer","allowedOrigins","origin","allowedHosts","host","loopbackRouter","dcrRouter"],"mappings":"AAAA,SAASA,iBAAiB,EAAEC,WAAW,EAAEC,iBAAiB,EAAEC,SAAS,EAAEC,eAAe,EAAEC,iBAAiB,EAAEC,aAAa,QAAQ,gBAAgB;AAChJ,OAAOC,UAAU,OAAO;AACxB,OAAOC,aAAa,UAAU;AAE9B,SAASC,oBAAoB,QAAQ,eAAe;AAEpD,OAAO,eAAeC,iBAAiBC,MAAoB,EAAEC,SAA4B;IACvF,MAAMC,UAAU,MAAMJ,qBAAqBE,QAAQC;IACnD,MAAME,UAAUD,QAAQE,mBAAmB;IAC3C,MAAMC,SAASH,QAAQI,mBAAmB,CAACC,GAAG,CAAC,CAACC,UAAYA,QAAQN,QAAQO,IAAI;IAChF,MAAMC,WAAWrB,kBAAkBc,SAASE;IAC5C,MAAMM,SAAST,QAAQO,IAAI,CAACE,MAAM;IAClC,MAAMC,OAAOZ,OAAOa,SAAS,CAACD,IAAI;IAClC,IAAI,CAACA,MAAM,MAAM,IAAIE,MAAM;IAE3B,MAAMC,QAAQ;WAAIL,SAASK,KAAK;WAAKb,QAAQO,IAAI,CAACO,aAAa,CAACC,YAAY;KAAC;IAC7E,MAAMC,UAAU;WAAIR,SAASQ,OAAO;WAAKhB,QAAQO,IAAI,CAACO,aAAa,CAACG,cAAc;KAAC;IAEnF,sFAAsF;IACtF,yFAAyF;IACzF,2FAA2F;IAC3F,4EAA4E;IAC5E,MAAMC,cAAc;QAClB,MAAMC,YAAY,IAAI7B,UAAU;YAAE8B,MAAMtB,OAAOsB,IAAI;YAAEC,SAASvB,OAAOuB,OAAO;QAAC,GAAG;YAAEC,YAAYjC;QAAkB;QAChHI,cAAc0B,WAAWN;QACzBrB,kBAAkB2B,WAAWX,SAASe,SAAS;QAC/ChC,gBAAgB4B,WAAWH;QAC3B,OAAOG;IACT;IAEA,MAAMK,MAAM7B;IACZ6B,IAAIC,GAAG,CAAC9B,QAAQ+B,IAAI,CAAC;QAAEC,OAAO;IAAO;IAErC,sFAAsF;IACtF,wFAAwF;IACxF,MAAMC,YAAY9B,OAAO+B,OAAO,GAAG,IAAIC,IAAIhC,OAAO+B,OAAO,IAAIE;IAC7DtB,OAAOuB,IAAI,CAAC,CAAC,SAAS,EAAElC,OAAOsB,IAAI,CAAC,kBAAkB,CAAC;IACvD,MAAM,EAAEa,KAAK,EAAEC,UAAU,EAAE,GAAG,MAAM9C,YAAY8B,aAAa;QAC3DT;QACAe;QACAd;QACAyB,gBAAgBP,YAAY;YAACA,UAAUQ,MAAM;SAAC,GAAGL;QACjDM,cAAcT,YAAY;YAACA,UAAUU,IAAI;SAAC,GAAGP;IAC/C;IAEA,+EAA+E;IAC/E,8EAA8E;IAC9E,yDAAyD;IACzD,IAAI/B,QAAQO,IAAI,CAACO,aAAa,CAACyB,cAAc,EAAE;QAC7Cf,IAAIC,GAAG,CAAC,KAAK/B,QAAQM,QAAQO,IAAI,CAACO,aAAa,CAACyB,cAAc;QAC9D9B,OAAOuB,IAAI,CAAC;IACd;IAEA,IAAIhC,QAAQO,IAAI,CAACO,aAAa,CAAC0B,SAAS,EAAE;QACxChB,IAAIC,GAAG,CAAC,KAAK/B,QAAQM,QAAQO,IAAI,CAACO,aAAa,CAAC0B,SAAS;QACzD/B,OAAOuB,IAAI,CAAC;IACd;IAEAvB,OAAOuB,IAAI,CAAC;IAEZ,OAAO;QACLE;QACAzB;QACAwB,OAAO;YACL,MAAMA;YACN,MAAMjC,QAAQiC,KAAK;QACrB;IACF;AACF"}

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

@@ -1,7 +1,5 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { RuntimeOverrides, ServerConfig } from '../types.js';
 export declare function createStdioServer(config: ServerConfig, overrides?: RuntimeOverrides): Promise<{
-    mcpServer: McpServer;
     logger: import("@mcp-z/server").Logger;
     close: () => Promise<void>;
 }>;