@mcp-z/mcp-sheets 1.2.2 → 2.0.0

package/dist/esm/mcp/tools/rows-append.js

@@ -1,6 +1,6 @@
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { google } from 'googleapis';
 import { z } from 'zod';
 import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
@@ -64,7 +64,7 @@ async function handler({ id, gid, rows, headers, deduplicateBy }, extra) {
             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');
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');
         }
         const sheetTitle = (_ref = sheet === null || sheet === void 0 ? void 0 : (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) !== null && _ref !== void 0 ? _ref : '';
         // Smart header handling and data processing
@@ -137,7 +137,7 @@ async function handler({ id, gid, rows, headers, deduplicateBy }, extra) {
         logger.error('sheets.rows.append error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error appending rows: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error appending rows: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

package/dist/esm/mcp/tools/rows-append.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/rows-append.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 { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { appendRows, mapRowsToHeader } from '../../spreadsheet/data-operations.ts';\nimport { ensureTabAndHeaders } from '../../spreadsheet/sheet-operations.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  rows: z\n    .array(z.array(z.union([z.string(), z.number(), z.boolean(), z.null()])).min(1))\n    .min(1)\n    .describe('Array of rows, where each row is an array of cell values. Use null to skip a cell (preserve existing value), empty string \"\" to clear it.'),\n  headers: z.array(z.string()).optional().describe('Column order/names - used for blank sheets or column mapping'),\n  deduplicateBy: z.array(z.string()).optional().describe('Column names to use as composite key for deduplication'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Sheet tab name'),\n  updatedRows: z.number().describe('Number of rows appended'),\n  rowsSkipped: z.number().optional().describe('Number of duplicate rows skipped'),\n  sheetUrl: z.string().optional().describe('URL to view the sheet'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Add new rows to the bottom of an existing sheet with smart header handling and optional deduplication. BEST FOR: Structured database operations where spreadsheet has headers defining schema and rows represent records.',\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, rows, headers, deduplicateBy }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.rows.append called', { id, gid, rowCount: rows.length, headers, deduplicateBy });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get sheet details using the gid\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\n    if (!sheet) {\n      throw new McpError(ErrorCode.InvalidParams, 'Sheet not found');\n    }\n\n    const sheetTitle = sheet?.properties?.title ?? '';\n\n    // Smart header handling and data processing\n    let processedRows = rows;\n    let currentHeaders: string[] = [];\n    let rowsSkipped = 0;\n    let existingKeySet: Set<string> = new Set();\n\n    if (headers && headers.length > 0) {\n      // Use ensureTabAndHeaders to handle header logic\n      const headerResult = await ensureTabAndHeaders(sheets, {\n        spreadsheetId: id,\n        sheetTitle,\n        requiredHeader: headers,\n        keyColumns: deduplicateBy || [],\n        logger,\n      });\n\n      currentHeaders = headerResult.header;\n      existingKeySet = headerResult.keySet;\n\n      // Map data rows to match current header order\n      processedRows = mapRowsToHeader({ rows, header: currentHeaders, canonical: headers }) as (string | number | boolean | null)[][];\n    }\n\n    // Append rows with optional deduplication\n    // If headers are empty but deduplication is requested, skip deduplication for empty spreadsheets\n    const effectiveKeyColumns = currentHeaders.length === 0 && deduplicateBy && deduplicateBy.length > 0 ? [] : deduplicateBy || [];\n\n    const appendResult = await appendRows(sheets, {\n      spreadsheetId: id,\n      sheetTitle,\n      rows: processedRows,\n      keySet: existingKeySet,\n      keyColumns: effectiveKeyColumns,\n      header: currentHeaders,\n      logger,\n    });\n\n    rowsSkipped = appendResult.rowsSkipped || 0;\n    // Only count data rows, not headers - headers are metadata, not items\n    const updatedRows = appendResult.updatedRows || 0;\n\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}`;\n\n    logger.info('sheets.rows.append completed', { id, gid, updatedRows, rowsSkipped });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid,\n      sheetTitle,\n      updatedRows,\n      rowsSkipped, // Always include rowsSkipped, even when 0\n      sheetUrl,\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.rows.append error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error appending rows: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'rows-append',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","appendRows","mapRowsToHeader","ensureTabAndHeaders","inputSchema","object","id","gid","rows","array","union","string","number","boolean","null","min","describe","headers","optional","deduplicateBy","successBranchSchema","type","literal","sheetTitle","updatedRows","rowsSkipped","sheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","rowCount","length","spreadsheetResponse","sheet","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","processedRows","currentHeaders","existingKeySet","Set","headerResult","requiredHeader","keyColumns","header","keySet","canonical","effectiveKeyColumns","appendResult","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/rows-append.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { appendRows, mapRowsToHeader } from '../../spreadsheet/data-operations.ts';\nimport { ensureTabAndHeaders } from '../../spreadsheet/sheet-operations.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  rows: z\n    .array(z.array(z.union([z.string(), z.number(), z.boolean(), z.null()])).min(1))\n    .min(1)\n    .describe('Array of rows, where each row is an array of cell values. Use null to skip a cell (preserve existing value), empty string \"\" to clear it.'),\n  headers: z.array(z.string()).optional().describe('Column order/names - used for blank sheets or column mapping'),\n  deduplicateBy: z.array(z.string()).optional().describe('Column names to use as composite key for deduplication'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Sheet tab name'),\n  updatedRows: z.number().describe('Number of rows appended'),\n  rowsSkipped: z.number().optional().describe('Number of duplicate rows skipped'),\n  sheetUrl: z.string().optional().describe('URL to view the sheet'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Add new rows to the bottom of an existing sheet with smart header handling and optional deduplication. BEST FOR: Structured database operations where spreadsheet has headers defining schema and rows represent records.',\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, rows, headers, deduplicateBy }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.rows.append called', { id, gid, rowCount: rows.length, headers, deduplicateBy });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get sheet details using the gid\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\n    if (!sheet) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');\n    }\n\n    const sheetTitle = sheet?.properties?.title ?? '';\n\n    // Smart header handling and data processing\n    let processedRows = rows;\n    let currentHeaders: string[] = [];\n    let rowsSkipped = 0;\n    let existingKeySet: Set<string> = new Set();\n\n    if (headers && headers.length > 0) {\n      // Use ensureTabAndHeaders to handle header logic\n      const headerResult = await ensureTabAndHeaders(sheets, {\n        spreadsheetId: id,\n        sheetTitle,\n        requiredHeader: headers,\n        keyColumns: deduplicateBy || [],\n        logger,\n      });\n\n      currentHeaders = headerResult.header;\n      existingKeySet = headerResult.keySet;\n\n      // Map data rows to match current header order\n      processedRows = mapRowsToHeader({ rows, header: currentHeaders, canonical: headers }) as (string | number | boolean | null)[][];\n    }\n\n    // Append rows with optional deduplication\n    // If headers are empty but deduplication is requested, skip deduplication for empty spreadsheets\n    const effectiveKeyColumns = currentHeaders.length === 0 && deduplicateBy && deduplicateBy.length > 0 ? [] : deduplicateBy || [];\n\n    const appendResult = await appendRows(sheets, {\n      spreadsheetId: id,\n      sheetTitle,\n      rows: processedRows,\n      keySet: existingKeySet,\n      keyColumns: effectiveKeyColumns,\n      header: currentHeaders,\n      logger,\n    });\n\n    rowsSkipped = appendResult.rowsSkipped || 0;\n    // Only count data rows, not headers - headers are metadata, not items\n    const updatedRows = appendResult.updatedRows || 0;\n\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}`;\n\n    logger.info('sheets.rows.append completed', { id, gid, updatedRows, rowsSkipped });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid,\n      sheetTitle,\n      updatedRows,\n      rowsSkipped, // Always include rowsSkipped, even when 0\n      sheetUrl,\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.rows.append error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error appending rows: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'rows-append',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","appendRows","mapRowsToHeader","ensureTabAndHeaders","inputSchema","object","id","gid","rows","array","union","string","number","boolean","null","min","describe","headers","optional","deduplicateBy","successBranchSchema","type","literal","sheetTitle","updatedRows","rowsSkipped","sheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","rowCount","length","spreadsheetResponse","sheet","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","processedRows","currentHeaders","existingKeySet","Set","headerResult","requiredHeader","keyColumns","header","keySet","canonical","effectiveKeyColumns","appendResult","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/rows-csv-append.d.ts

@@ -1,6 +1,6 @@
 /** Import CSV data to Google Sheets with database-style row append and deduplication */
 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/rows-csv-append.js

@@ -1,6 +1,6 @@
 /** Import CSV data to Google Sheets with database-style row append and deduplication */ import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { parse } from 'csv-parse';
 import { google } from 'googleapis';
 import { z } from 'zod';
@@ -89,22 +89,22 @@ async function handler({ id, gid, sourceUri, sourceHasHeaders, headerMap, dedupl
         var _ref;
         var _spreadsheetResponse_data_sheets, _sheet_properties;
         if (headerMap.length === 0) {
-            throw new McpError(ErrorCode.InvalidParams, 'headerMap cannot be empty');
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'headerMap cannot be empty');
         }
         // Validate: if sourceHasHeaders=false, all references must be numeric
         if (!sourceHasHeaders) {
             for (const { source, target } of headerMap){
                 if (typeof source === 'string') {
-                    throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string source: "${source}"`);
+                    throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string source: "${source}"`);
                 }
                 if (typeof target === 'string') {
-                    throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string target: "${target}"`);
+                    throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string target: "${target}"`);
                 }
             }
             if (deduplicateBy) {
                 for (const colRef of deduplicateBy){
                     if (typeof colRef === 'string') {
-                        throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices in deduplicateBy. Got string: "${colRef}"`);
+                        throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices in deduplicateBy. Got string: "${colRef}"`);
                     }
                 }
             }
@@ -123,7 +123,7 @@ async function handler({ id, gid, sourceUri, sourceHasHeaders, headerMap, dedupl
             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');
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');
         }
         const sheetTitle = (_ref = sheet === null || sheet === void 0 ? void 0 : (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) !== null && _ref !== void 0 ? _ref : '';
         // Determine target headers (for sourceHasHeaders=true) or column count (for sourceHasHeaders=false)
@@ -328,7 +328,7 @@ async function handler({ id, gid, sourceUri, sourceHasHeaders, headerMap, dedupl
         logger.error('sheets.rows.csv-append error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error appending CSV rows: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error appending CSV rows: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

package/dist/esm/mcp/tools/rows-csv-append.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/rows-csv-append.ts"],"sourcesContent":["/** Import CSV data to Google Sheets with database-style row append and 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 { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { getCsvReadStream } from '../../spreadsheet/csv-streaming.ts';\nimport { buildDeduplicationKey } from '../../spreadsheet/deduplication-utils.ts';\nimport { ensureTabAndHeaders } from '../../spreadsheet/sheet-operations.ts';\n\n// Header mapping schema: source/target can be string (name) or number (0-based index)\nconst HeaderMapItemSchema = z.object({\n  source: z.union([z.string(), z.number().int().min(0)]).describe('CSV column: header name (string) or 0-based index (number)'),\n  target: z.union([z.string(), z.number().int().min(0)]).describe('Sheet column: header name (string) or 0-based index (number)'),\n});\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  sourceHasHeaders: z.boolean().default(true).describe('Source has header row for column name mapping. Set to false for data-only sources (numeric indices required).'),\n  headerMap: z.array(HeaderMapItemSchema).describe('Column mappings from CSV to sheet'),\n  deduplicateBy: z\n    .array(z.union([z.string(), z.number().int().min(0)]))\n    .optional()\n    .describe('Sheet columns for deduplication (names or indices)'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Sheet tab name'),\n  updatedRows: z.number().describe('Number of rows appended'),\n  rowsSkipped: z.number().optional().describe('Number of duplicate rows skipped'),\n  sheetUrl: z.string().optional().describe('URL to view the sheet'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Import CSV to Google Sheets with column mapping and optional deduplication. Streams data for large files.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n/** Batch size for Sheets API calls (1000 rows × 12 cols = 12K cells, well under 40K limit) */\nconst BATCH_SIZE = 1000;\n\n/**\n * Resolve column reference to numeric index\n * @param ref Column reference (string name or number index)\n * @param headers Header row (null when sourceHasHeaders=false)\n * @param sourceHasHeaders Whether headers are present\n * @returns 0-based column index\n */\nfunction resolveColumnReference(ref: string | number, headers: string[] | null, sourceHasHeaders: boolean, context: string): number {\n  // If number, use directly as 0-based index\n  if (typeof ref === 'number') {\n    if (ref < 0) {\n      throw new Error(`${context}: Column index must be >= 0, got ${ref}`);\n    }\n    return ref;\n  }\n\n  // If string, must be header name\n  if (!sourceHasHeaders || !headers) {\n    throw new Error(`${context}: String column reference \"${ref}\" requires sourceHasHeaders=true. Use numeric index when sourceHasHeaders=false.`);\n  }\n\n  const index = headers.indexOf(ref);\n  if (index === -1) {\n    throw new Error(`${context}: Header \"${ref}\" not found in [${headers.join(', ')}]`);\n  }\n\n  return index;\n}\n\nasync function handler({ id, gid, sourceUri, sourceHasHeaders, headerMap, deduplicateBy }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.rows.csv-append called', { id, gid, sourceUri, sourceHasHeaders, headerMap, deduplicateBy });\n\n  try {\n    if (headerMap.length === 0) {\n      throw new McpError(ErrorCode.InvalidParams, 'headerMap cannot be empty');\n    }\n\n    // Validate: if sourceHasHeaders=false, all references must be numeric\n    if (!sourceHasHeaders) {\n      for (const { source, target } of headerMap) {\n        if (typeof source === 'string') {\n          throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string source: \"${source}\"`);\n        }\n        if (typeof target === 'string') {\n          throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string target: \"${target}\"`);\n        }\n      }\n      if (deduplicateBy) {\n        for (const colRef of deduplicateBy) {\n          if (typeof colRef === 'string') {\n            throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices in deduplicateBy. Got string: \"${colRef}\"`);\n          }\n        }\n      }\n    }\n\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get sheet details using the gid\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\n    if (!sheet) {\n      throw new McpError(ErrorCode.InvalidParams, 'Sheet not found');\n    }\n\n    const sheetTitle = sheet?.properties?.title ?? '';\n\n    // Determine target headers (for sourceHasHeaders=true) or column count (for sourceHasHeaders=false)\n    let sheetHeaders: string[] | null = null;\n    let existingKeySet: Set<string> = new Set();\n    const keyColumns: (string | number)[] = deduplicateBy || [];\n\n    if (sourceHasHeaders) {\n      // Extract target header names from headerMap\n      const targetHeaderNames = headerMap.map(({ target }) => target).filter((t) => typeof t === 'string') as string[];\n\n      // Use ensureTabAndHeaders to setup headers and fetch existing keys\n      const headerResult = await ensureTabAndHeaders(sheets, {\n        spreadsheetId: id,\n        sheetTitle,\n        requiredHeader: targetHeaderNames.length > 0 ? targetHeaderNames : null,\n        keyColumns: keyColumns.filter((k) => typeof k === 'string') as string[],\n        logger,\n      });\n\n      sheetHeaders = headerResult.header;\n      existingKeySet = headerResult.keySet;\n    } else {\n      // sourceHasHeaders=false: Read existing data for deduplication (if needed)\n      if (deduplicateBy && deduplicateBy.length > 0) {\n        // Read data in chunks for memory efficiency with large sheets\n        const CHUNK_SIZE = 1000;\n        let startRow = 1;\n        let hasMore = true;\n\n        while (hasMore) {\n          const endRow = startRow + CHUNK_SIZE - 1;\n          const chunkRange = `${sheetTitle}!A${startRow}:ZZZ${endRow}`;\n\n          const response = await sheets.spreadsheets.values.get({\n            spreadsheetId: id,\n            range: chunkRange,\n          });\n\n          const rows = response.data.values || [];\n\n          for (const row of rows) {\n            const key = buildDeduplicationKey(row, keyColumns, null, false);\n            if (key.replace(/::/g, '') !== '') {\n              existingKeySet.add(key);\n            }\n          }\n\n          // Check if there are more rows to read\n          if (rows.length < CHUNK_SIZE) {\n            hasMore = false;\n          } else {\n            startRow += CHUNK_SIZE;\n          }\n        }\n\n        logger.info('sheets.rows.csv-append existing keys loaded', { keyCount: existingKeySet.size });\n      }\n    }\n\n    // Streaming CSV processing state\n    let sourceHeaders: string[] | null = null;\n    let batch: (string | number | boolean | null)[][] = [];\n    let totalRows = 0;\n    let rowsSkipped = 0;\n\n    // Get readable stream from CSV URI (no temp files!)\n    const readStream = await getCsvReadStream(sourceUri);\n\n    // Create CSV parser\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    // Helper to append batch to Sheets\n    const appendBatch = async (rows: (string | number | boolean | null)[][]): Promise<void> => {\n      if (rows.length === 0) return;\n\n      await sheets.spreadsheets.values.append({\n        spreadsheetId: id,\n        range: `${sheetTitle}!A:A`,\n        valueInputOption: 'USER_ENTERED',\n        requestBody: { values: rows, majorDimension: 'ROWS' },\n      });\n\n      logger.info('sheets.rows.csv-append batch appended', { batchSize: rows.length, totalRows });\n    };\n\n    // Resolve headerMap to numeric indices (do this after extracting CSV headers)\n    let resolvedMap: Array<{ sourceIdx: number; targetIdx: number }> = [];\n\n    // Stream and process records\n    for await (const record of parser) {\n      if (sourceHasHeaders) {\n        // Extract source headers from first record\n        if (sourceHeaders === null) {\n          sourceHeaders = Object.keys(record as Record<string, unknown>);\n          logger.info('sheets.rows.csv-append source headers', { sourceHeaders });\n\n          // Resolve headerMap now that we have both source and sheet headers\n          resolvedMap = headerMap.map(({ source, target }) => ({\n            sourceIdx: resolveColumnReference(source, sourceHeaders, sourceHasHeaders, 'headerMap.source'),\n            targetIdx: resolveColumnReference(target, sheetHeaders, sourceHasHeaders, 'headerMap.target'),\n          }));\n        }\n\n        // Map source record to sheet row\n        const sourceRow = sourceHeaders?.map((h) => (record as Record<string, unknown>)[h] ?? null);\n        const maxTargetIdx = Math.max(...resolvedMap.map((m) => m.targetIdx));\n        const sheetRow = new Array(maxTargetIdx + 1).fill(null);\n\n        for (const { sourceIdx, targetIdx } of resolvedMap) {\n          if (sourceRow) {\n            sheetRow[targetIdx] = sourceRow[sourceIdx] ?? null;\n          }\n        }\n\n        // Check deduplication\n        if (deduplicateBy && deduplicateBy.length > 0) {\n          const key = buildDeduplicationKey(sheetRow, keyColumns, sheetHeaders, sourceHasHeaders);\n          if (existingKeySet.has(key)) {\n            rowsSkipped++;\n            continue; // Skip duplicate\n          }\n          existingKeySet.add(key); // Add to set for future deduplication\n        }\n\n        // Add to batch\n        batch.push(sheetRow);\n        totalRows++;\n      } else {\n        // sourceHasHeaders=false: record is an array (not an object)\n        // Resolve map on first row\n        if (resolvedMap.length === 0) {\n          resolvedMap = headerMap.map(({ source, target }) => ({\n            sourceIdx: resolveColumnReference(source, null, sourceHasHeaders, 'headerMap.source'),\n            targetIdx: resolveColumnReference(target, null, sourceHasHeaders, 'headerMap.target'),\n          }));\n        }\n\n        const sourceRow = record as unknown[];\n        const maxTargetIdx = Math.max(...resolvedMap.map((m) => m.targetIdx));\n        const sheetRow = new Array(maxTargetIdx + 1).fill(null);\n\n        for (const { sourceIdx, targetIdx } of resolvedMap) {\n          if (sourceIdx < sourceRow.length) {\n            sheetRow[targetIdx] = sourceRow[sourceIdx] ?? null;\n          }\n        }\n\n        // Check deduplication\n        if (deduplicateBy && deduplicateBy.length > 0) {\n          const key = buildDeduplicationKey(sheetRow, keyColumns, null, sourceHasHeaders);\n          if (existingKeySet.has(key)) {\n            rowsSkipped++;\n            continue; // Skip duplicate\n          }\n          existingKeySet.add(key);\n        }\n\n        // Add to batch\n        batch.push(sheetRow);\n        totalRows++;\n      }\n\n      // Append batch when full\n      if (batch.length >= BATCH_SIZE) {\n        await appendBatch(batch);\n        batch = []; // Clear batch\n      }\n    }\n\n    // Flush remaining rows\n    if (batch.length > 0) {\n      await appendBatch(batch);\n    }\n\n    logger.info('sheets.rows.csv-append streaming complete', { totalRows, rowsSkipped });\n\n    const updatedRows = totalRows;\n\n    logger.info('sheets.rows.csv-append completed', { id, gid, updatedRows, rowsSkipped, sourceUri });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid,\n      sheetTitle,\n      updatedRows,\n      rowsSkipped,\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}`,\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.rows.csv-append error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error appending CSV rows: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'rows-csv-append',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","parse","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","getCsvReadStream","buildDeduplicationKey","ensureTabAndHeaders","HeaderMapItemSchema","object","source","union","string","number","int","min","describe","target","inputSchema","id","gid","sourceUri","trim","sourceHasHeaders","boolean","default","headerMap","array","deduplicateBy","optional","successBranchSchema","type","literal","sheetTitle","updatedRows","rowsSkipped","sheetUrl","outputSchema","discriminatedUnion","config","description","result","BATCH_SIZE","resolveColumnReference","ref","headers","context","Error","index","indexOf","join","handler","extra","logger","info","spreadsheetResponse","sheet","length","InvalidParams","colRef","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","title","sheetHeaders","existingKeySet","Set","keyColumns","targetHeaderNames","map","filter","t","headerResult","requiredHeader","k","header","keySet","CHUNK_SIZE","startRow","hasMore","endRow","chunkRange","response","values","range","rows","row","key","replace","add","keyCount","size","sourceHeaders","batch","totalRows","readStream","parser","pipe","columns","skip_empty_lines","cast","relax_column_count","appendBatch","append","valueInputOption","requestBody","majorDimension","batchSize","resolvedMap","record","Object","keys","sourceIdx","targetIdx","sourceRow","h","maxTargetIdx","Math","max","m","sheetRow","Array","fill","has","push","content","text","JSON","stringify","structuredContent","error","message","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/rows-csv-append.ts"],"sourcesContent":["/** Import CSV data to Google Sheets with database-style row append and deduplication */\n\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { parse } from 'csv-parse';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { getCsvReadStream } from '../../spreadsheet/csv-streaming.ts';\nimport { buildDeduplicationKey } from '../../spreadsheet/deduplication-utils.ts';\nimport { ensureTabAndHeaders } from '../../spreadsheet/sheet-operations.ts';\n\n// Header mapping schema: source/target can be string (name) or number (0-based index)\nconst HeaderMapItemSchema = z.object({\n  source: z.union([z.string(), z.number().int().min(0)]).describe('CSV column: header name (string) or 0-based index (number)'),\n  target: z.union([z.string(), z.number().int().min(0)]).describe('Sheet column: header name (string) or 0-based index (number)'),\n});\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  sourceHasHeaders: z.boolean().default(true).describe('Source has header row for column name mapping. Set to false for data-only sources (numeric indices required).'),\n  headerMap: z.array(HeaderMapItemSchema).describe('Column mappings from CSV to sheet'),\n  deduplicateBy: z\n    .array(z.union([z.string(), z.number().int().min(0)]))\n    .optional()\n    .describe('Sheet columns for deduplication (names or indices)'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Sheet tab name'),\n  updatedRows: z.number().describe('Number of rows appended'),\n  rowsSkipped: z.number().optional().describe('Number of duplicate rows skipped'),\n  sheetUrl: z.string().optional().describe('URL to view the sheet'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Import CSV to Google Sheets with column mapping and optional deduplication. Streams data for large files.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n/** Batch size for Sheets API calls (1000 rows × 12 cols = 12K cells, well under 40K limit) */\nconst BATCH_SIZE = 1000;\n\n/**\n * Resolve column reference to numeric index\n * @param ref Column reference (string name or number index)\n * @param headers Header row (null when sourceHasHeaders=false)\n * @param sourceHasHeaders Whether headers are present\n * @returns 0-based column index\n */\nfunction resolveColumnReference(ref: string | number, headers: string[] | null, sourceHasHeaders: boolean, context: string): number {\n  // If number, use directly as 0-based index\n  if (typeof ref === 'number') {\n    if (ref < 0) {\n      throw new Error(`${context}: Column index must be >= 0, got ${ref}`);\n    }\n    return ref;\n  }\n\n  // If string, must be header name\n  if (!sourceHasHeaders || !headers) {\n    throw new Error(`${context}: String column reference \"${ref}\" requires sourceHasHeaders=true. Use numeric index when sourceHasHeaders=false.`);\n  }\n\n  const index = headers.indexOf(ref);\n  if (index === -1) {\n    throw new Error(`${context}: Header \"${ref}\" not found in [${headers.join(', ')}]`);\n  }\n\n  return index;\n}\n\nasync function handler({ id, gid, sourceUri, sourceHasHeaders, headerMap, deduplicateBy }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.rows.csv-append called', { id, gid, sourceUri, sourceHasHeaders, headerMap, deduplicateBy });\n\n  try {\n    if (headerMap.length === 0) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'headerMap cannot be empty');\n    }\n\n    // Validate: if sourceHasHeaders=false, all references must be numeric\n    if (!sourceHasHeaders) {\n      for (const { source, target } of headerMap) {\n        if (typeof source === 'string') {\n          throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string source: \"${source}\"`);\n        }\n        if (typeof target === 'string') {\n          throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string target: \"${target}\"`);\n        }\n      }\n      if (deduplicateBy) {\n        for (const colRef of deduplicateBy) {\n          if (typeof colRef === 'string') {\n            throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices in deduplicateBy. Got string: \"${colRef}\"`);\n          }\n        }\n      }\n    }\n\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get sheet details using the gid\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\n    if (!sheet) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');\n    }\n\n    const sheetTitle = sheet?.properties?.title ?? '';\n\n    // Determine target headers (for sourceHasHeaders=true) or column count (for sourceHasHeaders=false)\n    let sheetHeaders: string[] | null = null;\n    let existingKeySet: Set<string> = new Set();\n    const keyColumns: (string | number)[] = deduplicateBy || [];\n\n    if (sourceHasHeaders) {\n      // Extract target header names from headerMap\n      const targetHeaderNames = headerMap.map(({ target }) => target).filter((t) => typeof t === 'string') as string[];\n\n      // Use ensureTabAndHeaders to setup headers and fetch existing keys\n      const headerResult = await ensureTabAndHeaders(sheets, {\n        spreadsheetId: id,\n        sheetTitle,\n        requiredHeader: targetHeaderNames.length > 0 ? targetHeaderNames : null,\n        keyColumns: keyColumns.filter((k) => typeof k === 'string') as string[],\n        logger,\n      });\n\n      sheetHeaders = headerResult.header;\n      existingKeySet = headerResult.keySet;\n    } else {\n      // sourceHasHeaders=false: Read existing data for deduplication (if needed)\n      if (deduplicateBy && deduplicateBy.length > 0) {\n        // Read data in chunks for memory efficiency with large sheets\n        const CHUNK_SIZE = 1000;\n        let startRow = 1;\n        let hasMore = true;\n\n        while (hasMore) {\n          const endRow = startRow + CHUNK_SIZE - 1;\n          const chunkRange = `${sheetTitle}!A${startRow}:ZZZ${endRow}`;\n\n          const response = await sheets.spreadsheets.values.get({\n            spreadsheetId: id,\n            range: chunkRange,\n          });\n\n          const rows = response.data.values || [];\n\n          for (const row of rows) {\n            const key = buildDeduplicationKey(row, keyColumns, null, false);\n            if (key.replace(/::/g, '') !== '') {\n              existingKeySet.add(key);\n            }\n          }\n\n          // Check if there are more rows to read\n          if (rows.length < CHUNK_SIZE) {\n            hasMore = false;\n          } else {\n            startRow += CHUNK_SIZE;\n          }\n        }\n\n        logger.info('sheets.rows.csv-append existing keys loaded', { keyCount: existingKeySet.size });\n      }\n    }\n\n    // Streaming CSV processing state\n    let sourceHeaders: string[] | null = null;\n    let batch: (string | number | boolean | null)[][] = [];\n    let totalRows = 0;\n    let rowsSkipped = 0;\n\n    // Get readable stream from CSV URI (no temp files!)\n    const readStream = await getCsvReadStream(sourceUri);\n\n    // Create CSV parser\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    // Helper to append batch to Sheets\n    const appendBatch = async (rows: (string | number | boolean | null)[][]): Promise<void> => {\n      if (rows.length === 0) return;\n\n      await sheets.spreadsheets.values.append({\n        spreadsheetId: id,\n        range: `${sheetTitle}!A:A`,\n        valueInputOption: 'USER_ENTERED',\n        requestBody: { values: rows, majorDimension: 'ROWS' },\n      });\n\n      logger.info('sheets.rows.csv-append batch appended', { batchSize: rows.length, totalRows });\n    };\n\n    // Resolve headerMap to numeric indices (do this after extracting CSV headers)\n    let resolvedMap: Array<{ sourceIdx: number; targetIdx: number }> = [];\n\n    // Stream and process records\n    for await (const record of parser) {\n      if (sourceHasHeaders) {\n        // Extract source headers from first record\n        if (sourceHeaders === null) {\n          sourceHeaders = Object.keys(record as Record<string, unknown>);\n          logger.info('sheets.rows.csv-append source headers', { sourceHeaders });\n\n          // Resolve headerMap now that we have both source and sheet headers\n          resolvedMap = headerMap.map(({ source, target }) => ({\n            sourceIdx: resolveColumnReference(source, sourceHeaders, sourceHasHeaders, 'headerMap.source'),\n            targetIdx: resolveColumnReference(target, sheetHeaders, sourceHasHeaders, 'headerMap.target'),\n          }));\n        }\n\n        // Map source record to sheet row\n        const sourceRow = sourceHeaders?.map((h) => (record as Record<string, unknown>)[h] ?? null);\n        const maxTargetIdx = Math.max(...resolvedMap.map((m) => m.targetIdx));\n        const sheetRow = new Array(maxTargetIdx + 1).fill(null);\n\n        for (const { sourceIdx, targetIdx } of resolvedMap) {\n          if (sourceRow) {\n            sheetRow[targetIdx] = sourceRow[sourceIdx] ?? null;\n          }\n        }\n\n        // Check deduplication\n        if (deduplicateBy && deduplicateBy.length > 0) {\n          const key = buildDeduplicationKey(sheetRow, keyColumns, sheetHeaders, sourceHasHeaders);\n          if (existingKeySet.has(key)) {\n            rowsSkipped++;\n            continue; // Skip duplicate\n          }\n          existingKeySet.add(key); // Add to set for future deduplication\n        }\n\n        // Add to batch\n        batch.push(sheetRow);\n        totalRows++;\n      } else {\n        // sourceHasHeaders=false: record is an array (not an object)\n        // Resolve map on first row\n        if (resolvedMap.length === 0) {\n          resolvedMap = headerMap.map(({ source, target }) => ({\n            sourceIdx: resolveColumnReference(source, null, sourceHasHeaders, 'headerMap.source'),\n            targetIdx: resolveColumnReference(target, null, sourceHasHeaders, 'headerMap.target'),\n          }));\n        }\n\n        const sourceRow = record as unknown[];\n        const maxTargetIdx = Math.max(...resolvedMap.map((m) => m.targetIdx));\n        const sheetRow = new Array(maxTargetIdx + 1).fill(null);\n\n        for (const { sourceIdx, targetIdx } of resolvedMap) {\n          if (sourceIdx < sourceRow.length) {\n            sheetRow[targetIdx] = sourceRow[sourceIdx] ?? null;\n          }\n        }\n\n        // Check deduplication\n        if (deduplicateBy && deduplicateBy.length > 0) {\n          const key = buildDeduplicationKey(sheetRow, keyColumns, null, sourceHasHeaders);\n          if (existingKeySet.has(key)) {\n            rowsSkipped++;\n            continue; // Skip duplicate\n          }\n          existingKeySet.add(key);\n        }\n\n        // Add to batch\n        batch.push(sheetRow);\n        totalRows++;\n      }\n\n      // Append batch when full\n      if (batch.length >= BATCH_SIZE) {\n        await appendBatch(batch);\n        batch = []; // Clear batch\n      }\n    }\n\n    // Flush remaining rows\n    if (batch.length > 0) {\n      await appendBatch(batch);\n    }\n\n    logger.info('sheets.rows.csv-append streaming complete', { totalRows, rowsSkipped });\n\n    const updatedRows = totalRows;\n\n    logger.info('sheets.rows.csv-append completed', { id, gid, updatedRows, rowsSkipped, sourceUri });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid,\n      sheetTitle,\n      updatedRows,\n      rowsSkipped,\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}`,\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.rows.csv-append error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error appending CSV rows: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'rows-csv-append',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","parse","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","getCsvReadStream","buildDeduplicationKey","ensureTabAndHeaders","HeaderMapItemSchema","object","source","union","string","number","int","min","describe","target","inputSchema","id","gid","sourceUri","trim","sourceHasHeaders","boolean","default","headerMap","array","deduplicateBy","optional","successBranchSchema","type","literal","sheetTitle","updatedRows","rowsSkipped","sheetUrl","outputSchema","discriminatedUnion","config","description","result","BATCH_SIZE","resolveColumnReference","ref","headers","context","Error","index","indexOf","join","handler","extra","logger","info","spreadsheetResponse","sheet","length","InvalidParams","colRef","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","title","sheetHeaders","existingKeySet","Set","keyColumns","targetHeaderNames","map","filter","t","headerResult","requiredHeader","k","header","keySet","CHUNK_SIZE","startRow","hasMore","endRow","chunkRange","response","values","range","rows","row","key","replace","add","keyCount","size","sourceHeaders","batch","totalRows","readStream","parser","pipe","columns","skip_empty_lines","cast","relax_column_count","appendBatch","append","valueInputOption","requestBody","majorDimension","batchSize","resolvedMap","record","Object","keys","sourceIdx","targetIdx","sourceRow","h","maxTargetIdx","Math","max","m","sheetRow","Array","fill","has","push","content","text","JSON","stringify","structuredContent","error","message","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

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

@@ -1,6 +1,6 @@
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { google } from 'googleapis';
 import { z } from 'zod';
 import { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.js';
@@ -62,7 +62,7 @@ async function handler({ id, gid, range, render }, extra) {
                 gid,
                 range
             });
-            throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);
         }
         const sheetTitle = (_ref = (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) !== null && _ref !== void 0 ? _ref : '';
         // Construct full range with sheet title
@@ -101,8 +101,8 @@ async function handler({ id, gid, range, render }, extra) {
         logger.error('sheets.rows.get error', {
             error: message
         });
-        // Throw McpError for proper MCP error handling
-        throw new McpError(ErrorCode.InternalError, `Error getting rows: ${message}`, {
+        // Throw ProtocolError for proper MCP error handling
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting rows: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/rows-get.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\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  range: z.string().min(1).describe('A1 notation range to fetch (e.g., \"B5\", \"A5:D5\", \"B:B\", \"5:5\")'),\n  render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n});\n\n// Success branch schema - uses rows: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  range: z.string().describe('The A1 notation range that was retrieved'),\n  rows: z.array(z.array(SheetCellSchema)).describe('2D array of row data (each inner array is a row)'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Fetch row data from a specific range in A1 notation. Best used after values-search to get surrounding context. Use a1-notation prompt for syntax reference.',\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, range, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.rows.get called', { id, gid, range, render });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get sheet details using the gid to get sheet title\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\n    if (!sheet) {\n      logger.info('sheets.rows.get sheet not found', { id, gid, range });\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties?.title ?? '';\n\n    // Construct full range with sheet title\n    const fullRange = `${sheetTitle}!${range}`;\n\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range: fullRange,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n\n    const res = response.data;\n    const rows = Array.isArray(res.values) ? (res.values as (string | number | boolean | null)[][]) : [];\n\n    logger.info('sheets.rows.get success', { id, gid, range, rowCount: rows.length });\n\n    const result: Output = {\n      type: 'success' as const,\n      range: res.range || fullRange,\n      rows,\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.rows.get error', { error: message });\n\n    // Throw McpError for proper MCP error handling\n    throw new McpError(ErrorCode.InternalError, `Error getting rows: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'rows-get',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetCellSchema","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","id","gid","range","string","min","describe","render","enum","optional","successBranchSchema","type","literal","rows","array","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","spreadsheetResponse","sheet","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","sheetTitle","title","fullRange","response","values","valueRenderOption","res","Array","isArray","rowCount","length","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/rows-get.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  range: z.string().min(1).describe('A1 notation range to fetch (e.g., \"B5\", \"A5:D5\", \"B:B\", \"5:5\")'),\n  render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n});\n\n// Success branch schema - uses rows: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  range: z.string().describe('The A1 notation range that was retrieved'),\n  rows: z.array(z.array(SheetCellSchema)).describe('2D array of row data (each inner array is a row)'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Fetch row data from a specific range in A1 notation. Best used after values-search to get surrounding context. Use a1-notation prompt for syntax reference.',\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, range, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.rows.get called', { id, gid, range, render });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get sheet details using the gid to get sheet title\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\n    if (!sheet) {\n      logger.info('sheets.rows.get sheet not found', { id, gid, range });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties?.title ?? '';\n\n    // Construct full range with sheet title\n    const fullRange = `${sheetTitle}!${range}`;\n\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range: fullRange,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n\n    const res = response.data;\n    const rows = Array.isArray(res.values) ? (res.values as (string | number | boolean | null)[][]) : [];\n\n    logger.info('sheets.rows.get success', { id, gid, range, rowCount: rows.length });\n\n    const result: Output = {\n      type: 'success' as const,\n      range: res.range || fullRange,\n      rows,\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.rows.get error', { error: message });\n\n    // Throw ProtocolError for proper MCP error handling\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting rows: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'rows-get',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SheetCellSchema","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","id","gid","range","string","min","describe","render","enum","optional","successBranchSchema","type","literal","rows","array","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","spreadsheetResponse","sheet","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","sheetTitle","title","fullRange","response","values","valueRenderOption","res","Array","isArray","rowCount","length","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAGrC,SAASE,aAAa,EAAEC,iBAAiB,QAAQ,gBAAgB;AACjE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,eAAe,EAAEC,cAAc,EAAEC,mBAAmB,QAAQ,yBAAyB;AAE9F,MAAMC,cAAcJ,EAAEK,MAAM,CAAC;IAC3BC,IAAIH;IACJI,KAAKL;IACLM,OAAOR,EAAES,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;IAClCC,QAAQZ,EAAEa,IAAI,CAAC;QAAC;QAAmB;QAAqB;KAAU,EAAEC,QAAQ,GAAGH,QAAQ,CAAC;AAC1F;AAEA,8EAA8E;AAC9E,MAAMI,sBAAsBf,EAAEK,MAAM,CAAC;IACnCW,MAAMhB,EAAEiB,OAAO,CAAC;IAChBT,OAAOR,EAAES,MAAM,GAAGE,QAAQ,CAAC;IAC3BO,MAAMlB,EAAEmB,KAAK,CAACnB,EAAEmB,KAAK,CAAClB,kBAAkBU,QAAQ,CAAC;AACnD;AAEA,2CAA2C;AAC3C,MAAMS,eAAepB,EAAEqB,kBAAkB,CAAC,QAAQ;IAACN;IAAqBnB;CAAyB;AAEjG,MAAM0B,SAAS;IACbC,aAAa;IACbnB;IACAgB,cAAcpB,EAAEK,MAAM,CAAC;QACrBmB,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAEnB,EAAE,EAAEC,GAAG,EAAEC,KAAK,EAAEI,MAAM,EAAS,EAAEc,KAAoB;IAC5E,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,0BAA0B;QAAEtB;QAAIC;QAAKC;QAAOI;IAAO;IAE/D,IAAI;;YASYiB,kCAOKC;QAfnB,MAAMC,SAAShC,OAAOgC,MAAM,CAAC;YAAEC,SAAS;YAAMC,MAAMP,MAAMQ,WAAW,CAACD,IAAI;QAAC;QAE3E,qDAAqD;QACrD,MAAMJ,sBAAsB,MAAME,OAAOI,YAAY,CAACC,GAAG,CAAC;YACxDC,eAAe/B;YACfgC,QAAQ;QACV;QAEA,MAAMR,SAAQD,mCAAAA,oBAAoBU,IAAI,CAACR,MAAM,cAA/BF,uDAAAA,iCAAiCW,IAAI,CAAC,CAACC;gBAAaA;mBAAPC,QAAOD,gBAAAA,EAAEE,UAAU,cAAZF,oCAAAA,cAAcG,OAAO,MAAMrC;;QAE7F,IAAI,CAACuB,OAAO;YACVH,OAAOC,IAAI,CAAC,mCAAmC;gBAAEtB;gBAAIC;gBAAKC;YAAM;YAChE,MAAM,IAAIX,cAAcC,kBAAkB+C,aAAa,EAAE,CAAC,iBAAiB,EAAEtC,KAAK;QACpF;QAEA,MAAMuC,sBAAahB,oBAAAA,MAAMa,UAAU,cAAhBb,wCAAAA,kBAAkBiB,KAAK,uCAAI;QAE9C,wCAAwC;QACxC,MAAMC,YAAY,GAAGF,WAAW,CAAC,EAAEtC,OAAO;QAE1C,MAAMyC,WAAW,MAAMlB,OAAOI,YAAY,CAACe,MAAM,CAACd,GAAG,CAAC;YACpDC,eAAe/B;YACfE,OAAOwC;YACPG,mBAAmBvC,UAAU;QAC/B;QAEA,MAAMwC,MAAMH,SAASV,IAAI;QACzB,MAAMrB,OAAOmC,MAAMC,OAAO,CAACF,IAAIF,MAAM,IAAKE,IAAIF,MAAM,GAA8C,EAAE;QAEpGvB,OAAOC,IAAI,CAAC,2BAA2B;YAAEtB;YAAIC;YAAKC;YAAO+C,UAAUrC,KAAKsC,MAAM;QAAC;QAE/E,MAAMhC,SAAiB;YACrBR,MAAM;YACNR,OAAO4C,IAAI5C,KAAK,IAAIwC;YACpB9B;QACF;QAEA,OAAO;YACLuC,SAAS;gBAAC;oBAAEzC,MAAM;oBAAiB0C,MAAMC,KAAKC,SAAS,CAACpC;gBAAQ;aAAE;YAClEqC,mBAAmB;gBAAErC;YAAO;QAC9B;IACF,EAAE,OAAOsC,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGrB,OAAOoB;QAChEnC,OAAOmC,KAAK,CAAC,yBAAyB;YAAEA,OAAOC;QAAQ;QAEvD,oDAAoD;QACpD,MAAM,IAAIlE,cAAcC,kBAAkBmE,aAAa,EAAE,CAAC,oBAAoB,EAAEF,SAAS,EAAE;YACzFG,OAAOJ,iBAAiBE,QAAQF,MAAMI,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACN/C;QACAG;IACF;AACF"}

package/dist/esm/mcp/tools/sheet-copy-to.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<{
     sourceId: z.ZodString;

package/dist/esm/mcp/tools/sheet-copy-to.js

@@ -1,6 +1,6 @@
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { google } from 'googleapis';
 import { z } from 'zod';
 import { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.js';
@@ -63,7 +63,7 @@ async function handler({ sourceId, sourceGid, destinationId, newTitle }, extra)
             return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === sourceGid;
         });
         if (!(sourceSheet === null || sourceSheet === void 0 ? void 0 : sourceSheet.properties)) {
-            throw new McpError(ErrorCode.InvalidParams, `Source sheet with gid "${sourceGid}" not found in spreadsheet`);
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Source sheet with gid "${sourceGid}" not found in spreadsheet`);
         }
         const sourceTitle = sourceSheet.properties.title || '';
         // Copy the sheet to the destination spreadsheet
@@ -135,14 +135,14 @@ async function handler({ sourceId, sourceGid, destinationId, newTitle }, extra)
             }
         };
     } catch (error) {
-        if (error instanceof McpError) {
+        if (error instanceof ProtocolError) {
             throw error;
         }
         const message = error instanceof Error ? error.message : String(error);
         logger.error('sheets.sheet.copyTo error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error copying sheet to another spreadsheet: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error copying sheet to another spreadsheet: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

package/dist/esm/mcp/tools/sheet-copy-to.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/sheet-copy-to.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 { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\n// Note: Using contextual descriptions for source/destination IDs since they describe different spreadsheets/sheets\n\nconst inputSchema = z.object({\n  sourceId: SpreadsheetIdSchema.describe('Source spreadsheet ID'),\n  sourceGid: SheetGidSchema.describe('Source sheet grid ID to copy'),\n  destinationId: SpreadsheetIdSchema.describe('Destination spreadsheet ID'),\n  newTitle: z.coerce.string().trim().min(1).optional().describe('New name for the copied sheet (optional, will use auto-generated name if not provided)'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Summary of the copy operation'),\n  itemsProcessed: z.number().describe('Total items attempted (always 1)'),\n  itemsChanged: z.number().describe('Successfully copied (always 1 on success)'),\n  completedAt: z.string().describe('ISO datetime when operation completed'),\n  sourceId: z.string().describe('Source spreadsheet ID'),\n  sourceGid: z.string().describe('Source sheet ID'),\n  sourceTitle: z.string().describe('Source sheet title'),\n  destinationId: z.string().describe('Destination spreadsheet ID'),\n  destinationGid: z.string().describe('Copied sheet ID in destination'),\n  destinationTitle: z.string().describe('Title of the copied sheet in destination'),\n  sheetUrl: z.string().describe('URL of the copied sheet'),\n  renamed: z.boolean().describe('Whether the sheet was renamed after copying'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Copy a sheet to another spreadsheet. Copies all data, formatting, and charts.',\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({ sourceId, sourceGid, destinationId, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.copyTo called', { sourceId, sourceGid, destinationId, newTitle });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get source sheet info\n    const sourceInfo = await sheets.spreadsheets.get({\n      spreadsheetId: sourceId,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const sourceSheet = sourceInfo.data.sheets?.find((s) => String(s.properties?.sheetId) === sourceGid);\n    if (!sourceSheet?.properties) {\n      throw new McpError(ErrorCode.InvalidParams, `Source sheet with gid \"${sourceGid}\" not found in spreadsheet`);\n    }\n\n    const sourceTitle = sourceSheet.properties.title || '';\n\n    // Copy the sheet to the destination spreadsheet\n    const copyResponse = await sheets.spreadsheets.sheets.copyTo({\n      spreadsheetId: sourceId,\n      sheetId: Number(sourceGid),\n      requestBody: {\n        destinationSpreadsheetId: destinationId,\n      },\n    });\n\n    const newSheetId = copyResponse.data.sheetId;\n    let destinationTitle = copyResponse.data.title || '';\n\n    if (!newSheetId) {\n      throw new Error('Failed to retrieve new sheet ID from API response');\n    }\n\n    // If newTitle is provided, rename the sheet in the destination\n    let renamed = false;\n    if (newTitle && newTitle !== destinationTitle) {\n      await sheets.spreadsheets.batchUpdate({\n        spreadsheetId: destinationId,\n        requestBody: {\n          requests: [\n            {\n              updateSheetProperties: {\n                properties: { sheetId: newSheetId, title: newTitle },\n                fields: 'title',\n              },\n            },\n          ],\n        },\n      });\n      destinationTitle = newTitle;\n      renamed = true;\n    }\n\n    logger.info('sheets.sheet.copyTo success', {\n      sourceId,\n      sourceGid,\n      destinationId,\n      destinationGid: String(newSheetId),\n      renamed,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: `Copied sheet \"${sourceTitle}\" to destination${renamed ? ` as \"${destinationTitle}\"` : ''}`,\n      itemsProcessed: 1,\n      itemsChanged: 1,\n      completedAt: new Date().toISOString(),\n      sourceId,\n      sourceGid,\n      sourceTitle,\n      destinationId,\n      destinationGid: String(newSheetId),\n      destinationTitle,\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${destinationId}/edit#gid=${newSheetId}`,\n      renamed,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\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('sheets.sheet.copyTo error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error copying sheet to another spreadsheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-copy-to',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","sourceId","describe","sourceGid","destinationId","newTitle","coerce","string","trim","min","optional","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","sourceTitle","destinationGid","destinationTitle","sheetUrl","renamed","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","sourceInfo","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","sourceSheet","data","find","s","String","properties","sheetId","InvalidParams","title","copyResponse","copyTo","Number","requestBody","destinationSpreadsheetId","newSheetId","Error","batchUpdate","requests","updateSheetProperties","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","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/sheet-copy-to.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\n// Note: Using contextual descriptions for source/destination IDs since they describe different spreadsheets/sheets\n\nconst inputSchema = z.object({\n  sourceId: SpreadsheetIdSchema.describe('Source spreadsheet ID'),\n  sourceGid: SheetGidSchema.describe('Source sheet grid ID to copy'),\n  destinationId: SpreadsheetIdSchema.describe('Destination spreadsheet ID'),\n  newTitle: z.coerce.string().trim().min(1).optional().describe('New name for the copied sheet (optional, will use auto-generated name if not provided)'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Summary of the copy operation'),\n  itemsProcessed: z.number().describe('Total items attempted (always 1)'),\n  itemsChanged: z.number().describe('Successfully copied (always 1 on success)'),\n  completedAt: z.string().describe('ISO datetime when operation completed'),\n  sourceId: z.string().describe('Source spreadsheet ID'),\n  sourceGid: z.string().describe('Source sheet ID'),\n  sourceTitle: z.string().describe('Source sheet title'),\n  destinationId: z.string().describe('Destination spreadsheet ID'),\n  destinationGid: z.string().describe('Copied sheet ID in destination'),\n  destinationTitle: z.string().describe('Title of the copied sheet in destination'),\n  sheetUrl: z.string().describe('URL of the copied sheet'),\n  renamed: z.boolean().describe('Whether the sheet was renamed after copying'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Copy a sheet to another spreadsheet. Copies all data, formatting, and charts.',\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({ sourceId, sourceGid, destinationId, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.copyTo called', { sourceId, sourceGid, destinationId, newTitle });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get source sheet info\n    const sourceInfo = await sheets.spreadsheets.get({\n      spreadsheetId: sourceId,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const sourceSheet = sourceInfo.data.sheets?.find((s) => String(s.properties?.sheetId) === sourceGid);\n    if (!sourceSheet?.properties) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Source sheet with gid \"${sourceGid}\" not found in spreadsheet`);\n    }\n\n    const sourceTitle = sourceSheet.properties.title || '';\n\n    // Copy the sheet to the destination spreadsheet\n    const copyResponse = await sheets.spreadsheets.sheets.copyTo({\n      spreadsheetId: sourceId,\n      sheetId: Number(sourceGid),\n      requestBody: {\n        destinationSpreadsheetId: destinationId,\n      },\n    });\n\n    const newSheetId = copyResponse.data.sheetId;\n    let destinationTitle = copyResponse.data.title || '';\n\n    if (!newSheetId) {\n      throw new Error('Failed to retrieve new sheet ID from API response');\n    }\n\n    // If newTitle is provided, rename the sheet in the destination\n    let renamed = false;\n    if (newTitle && newTitle !== destinationTitle) {\n      await sheets.spreadsheets.batchUpdate({\n        spreadsheetId: destinationId,\n        requestBody: {\n          requests: [\n            {\n              updateSheetProperties: {\n                properties: { sheetId: newSheetId, title: newTitle },\n                fields: 'title',\n              },\n            },\n          ],\n        },\n      });\n      destinationTitle = newTitle;\n      renamed = true;\n    }\n\n    logger.info('sheets.sheet.copyTo success', {\n      sourceId,\n      sourceGid,\n      destinationId,\n      destinationGid: String(newSheetId),\n      renamed,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: `Copied sheet \"${sourceTitle}\" to destination${renamed ? ` as \"${destinationTitle}\"` : ''}`,\n      itemsProcessed: 1,\n      itemsChanged: 1,\n      completedAt: new Date().toISOString(),\n      sourceId,\n      sourceGid,\n      sourceTitle,\n      destinationId,\n      destinationGid: String(newSheetId),\n      destinationTitle,\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${destinationId}/edit#gid=${newSheetId}`,\n      renamed,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\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('sheets.sheet.copyTo error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error copying sheet to another spreadsheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-copy-to',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","sourceId","describe","sourceGid","destinationId","newTitle","coerce","string","trim","min","optional","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","sourceTitle","destinationGid","destinationTitle","sheetUrl","renamed","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","sourceInfo","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","sourceSheet","data","find","s","String","properties","sheetId","InvalidParams","title","copyResponse","copyTo","Number","requestBody","destinationSpreadsheetId","newSheetId","Error","batchUpdate","requests","updateSheetProperties","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

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

@@ -1,6 +1,6 @@
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { google } from 'googleapis';
 import { z } from 'zod';
 import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
@@ -71,7 +71,7 @@ async function handler({ id, gid, copies }, extra) {
             return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === gid;
         });
         if (!(sourceSheet === null || sourceSheet === void 0 ? void 0 : sourceSheet.properties)) {
-            throw new McpError(ErrorCode.InvalidParams, `Source sheet with gid "${gid}" not found in spreadsheet`);
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Source sheet with gid "${gid}" not found in spreadsheet`);
         }
         const sourceTitle = sourceSheet.properties.title || '';
         const sourceSheetId = Number(gid);
@@ -156,14 +156,14 @@ async function handler({ id, gid, copies }, extra) {
             }
         };
     } catch (error) {
-        if (error instanceof McpError) {
+        if (error instanceof ProtocolError) {
             throw error;
         }
         const message = error instanceof Error ? error.message : String(error);
         logger.error('sheets.sheet.copy error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error copying sheet: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error copying sheet: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

package/dist/esm/mcp/tools/sheet-copy.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/sheet-copy.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 { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst MAX_BATCH_SIZE = 100;\n\nconst copyItemSchema = z.object({\n  newTitle: z.coerce.string().trim().min(1).describe('Name for the copied sheet'),\n  insertIndex: z.number().int().min(0).optional().describe('Position to insert the new sheet (0-indexed)'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  copies: z.array(copyItemSchema).min(1).max(MAX_BATCH_SIZE).describe('Array of copies to create from the source sheet'),\n});\n\n// Created sheet info\nconst createdSheetSchema = z.object({\n  gid: SheetGidOutput,\n  title: z.string().describe('Title of the created sheet'),\n  sheetUrl: z.string().describe('URL of the created sheet'),\n});\n\n// Success branch schema - uses items: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Summary of the copy operation'),\n  itemsProcessed: z.number().describe('Total copies attempted'),\n  itemsChanged: z.number().describe('Successfully created copies'),\n  completedAt: z.string().describe('ISO datetime when operation completed'),\n  id: SpreadsheetIdOutput,\n  sourceGid: z.string().describe('Source sheet ID'),\n  sourceTitle: z.string().describe('Source sheet title'),\n  items: z.array(createdSheetSchema).describe('Information about created sheets'),\n  failures: z\n    .array(\n      z.object({\n        title: z.string(),\n        error: z.string(),\n      })\n    )\n    .optional()\n    .describe('Failed copies with error messages'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Copy a sheet/tab within the same spreadsheet. Supports batch copying: create multiple copies from a single source sheet (e.g., create 12 monthly sheets from a template). Copies all data, formatting, charts, and conditional formatting verbatim.',\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, copies }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.copy called', { id, gid, copyCount: copies.length });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // First, get the source sheet info\n    const spreadsheetInfo = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const sourceSheet = spreadsheetInfo.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sourceSheet?.properties) {\n      throw new McpError(ErrorCode.InvalidParams, `Source sheet with gid \"${gid}\" not found in spreadsheet`);\n    }\n\n    const sourceTitle = sourceSheet.properties.title || '';\n    const sourceSheetId = Number(gid);\n\n    // Execute copies using Promise.allSettled for partial failure handling\n    const results = await Promise.allSettled(\n      copies.map(async (copy) => {\n        const response = await sheets.spreadsheets.batchUpdate({\n          spreadsheetId: id,\n          requestBody: {\n            requests: [\n              {\n                duplicateSheet: {\n                  sourceSheetId,\n                  newSheetName: copy.newTitle,\n                  ...(copy.insertIndex !== undefined && { insertSheetIndex: copy.insertIndex }),\n                },\n              },\n            ],\n          },\n        });\n\n        const newSheetId = response.data.replies?.[0]?.duplicateSheet?.properties?.sheetId;\n        const newTitle = response.data.replies?.[0]?.duplicateSheet?.properties?.title;\n\n        if (!newSheetId || !newTitle) {\n          throw new Error('Failed to retrieve new sheet info from API response');\n        }\n\n        return {\n          gid: String(newSheetId),\n          title: newTitle,\n          sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${newSheetId}`,\n        };\n      })\n    );\n\n    // Separate successes and failures\n    const items: Array<{ gid: string; title: string; sheetUrl: string }> = [];\n    const failures: Array<{ title: string; error: string }> = [];\n\n    results.forEach((result, index) => {\n      const copy = copies[index];\n      if (!copy) return;\n\n      if (result.status === 'fulfilled') {\n        items.push(result.value);\n      } else {\n        const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);\n        failures.push({ title: copy.newTitle, error: errorMessage });\n      }\n    });\n\n    const successCount = items.length;\n    const failureCount = failures.length;\n    const totalCount = copies.length;\n\n    const summary = failureCount === 0 ? `Created ${successCount} cop${successCount === 1 ? 'y' : 'ies'} of \"${sourceTitle}\"` : `Created ${successCount} of ${totalCount} cop${totalCount === 1 ? 'y' : 'ies'} (${failureCount} failed)`;\n\n    logger.info('sheets.sheet.copy completed', { totalCount, successCount, failureCount });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: summary,\n      itemsProcessed: totalCount,\n      itemsChanged: successCount,\n      completedAt: new Date().toISOString(),\n      id,\n      sourceGid: gid,\n      sourceTitle,\n      items,\n      ...(failures.length > 0 && { failures }),\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('sheets.sheet.copy error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error copying sheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-copy',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","MAX_BATCH_SIZE","copyItemSchema","object","newTitle","coerce","string","trim","min","describe","insertIndex","number","int","optional","inputSchema","id","gid","copies","array","max","createdSheetSchema","title","sheetUrl","successBranchSchema","type","literal","operationSummary","itemsProcessed","itemsChanged","completedAt","sourceGid","sourceTitle","items","failures","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","copyCount","length","spreadsheetInfo","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","sourceSheet","data","find","s","String","properties","sheetId","InvalidParams","sourceSheetId","Number","results","Promise","allSettled","map","copy","response","batchUpdate","requestBody","requests","duplicateSheet","newSheetName","undefined","insertSheetIndex","newSheetId","replies","Error","forEach","index","status","push","value","errorMessage","reason","message","successCount","failureCount","totalCount","summary","Date","toISOString","content","text","JSON","stringify","structuredContent","InternalError","stack","createTool","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/sheet-copy.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst MAX_BATCH_SIZE = 100;\n\nconst copyItemSchema = z.object({\n  newTitle: z.coerce.string().trim().min(1).describe('Name for the copied sheet'),\n  insertIndex: z.number().int().min(0).optional().describe('Position to insert the new sheet (0-indexed)'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  copies: z.array(copyItemSchema).min(1).max(MAX_BATCH_SIZE).describe('Array of copies to create from the source sheet'),\n});\n\n// Created sheet info\nconst createdSheetSchema = z.object({\n  gid: SheetGidOutput,\n  title: z.string().describe('Title of the created sheet'),\n  sheetUrl: z.string().describe('URL of the created sheet'),\n});\n\n// Success branch schema - uses items: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Summary of the copy operation'),\n  itemsProcessed: z.number().describe('Total copies attempted'),\n  itemsChanged: z.number().describe('Successfully created copies'),\n  completedAt: z.string().describe('ISO datetime when operation completed'),\n  id: SpreadsheetIdOutput,\n  sourceGid: z.string().describe('Source sheet ID'),\n  sourceTitle: z.string().describe('Source sheet title'),\n  items: z.array(createdSheetSchema).describe('Information about created sheets'),\n  failures: z\n    .array(\n      z.object({\n        title: z.string(),\n        error: z.string(),\n      })\n    )\n    .optional()\n    .describe('Failed copies with error messages'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Copy a sheet/tab within the same spreadsheet. Supports batch copying: create multiple copies from a single source sheet (e.g., create 12 monthly sheets from a template). Copies all data, formatting, charts, and conditional formatting verbatim.',\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, copies }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.copy called', { id, gid, copyCount: copies.length });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // First, get the source sheet info\n    const spreadsheetInfo = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const sourceSheet = spreadsheetInfo.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sourceSheet?.properties) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Source sheet with gid \"${gid}\" not found in spreadsheet`);\n    }\n\n    const sourceTitle = sourceSheet.properties.title || '';\n    const sourceSheetId = Number(gid);\n\n    // Execute copies using Promise.allSettled for partial failure handling\n    const results = await Promise.allSettled(\n      copies.map(async (copy) => {\n        const response = await sheets.spreadsheets.batchUpdate({\n          spreadsheetId: id,\n          requestBody: {\n            requests: [\n              {\n                duplicateSheet: {\n                  sourceSheetId,\n                  newSheetName: copy.newTitle,\n                  ...(copy.insertIndex !== undefined && { insertSheetIndex: copy.insertIndex }),\n                },\n              },\n            ],\n          },\n        });\n\n        const newSheetId = response.data.replies?.[0]?.duplicateSheet?.properties?.sheetId;\n        const newTitle = response.data.replies?.[0]?.duplicateSheet?.properties?.title;\n\n        if (!newSheetId || !newTitle) {\n          throw new Error('Failed to retrieve new sheet info from API response');\n        }\n\n        return {\n          gid: String(newSheetId),\n          title: newTitle,\n          sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${newSheetId}`,\n        };\n      })\n    );\n\n    // Separate successes and failures\n    const items: Array<{ gid: string; title: string; sheetUrl: string }> = [];\n    const failures: Array<{ title: string; error: string }> = [];\n\n    results.forEach((result, index) => {\n      const copy = copies[index];\n      if (!copy) return;\n\n      if (result.status === 'fulfilled') {\n        items.push(result.value);\n      } else {\n        const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);\n        failures.push({ title: copy.newTitle, error: errorMessage });\n      }\n    });\n\n    const successCount = items.length;\n    const failureCount = failures.length;\n    const totalCount = copies.length;\n\n    const summary = failureCount === 0 ? `Created ${successCount} cop${successCount === 1 ? 'y' : 'ies'} of \"${sourceTitle}\"` : `Created ${successCount} of ${totalCount} cop${totalCount === 1 ? 'y' : 'ies'} (${failureCount} failed)`;\n\n    logger.info('sheets.sheet.copy completed', { totalCount, successCount, failureCount });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: summary,\n      itemsProcessed: totalCount,\n      itemsChanged: successCount,\n      completedAt: new Date().toISOString(),\n      id,\n      sourceGid: gid,\n      sourceTitle,\n      items,\n      ...(failures.length > 0 && { failures }),\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('sheets.sheet.copy error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error copying sheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-copy',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","MAX_BATCH_SIZE","copyItemSchema","object","newTitle","coerce","string","trim","min","describe","insertIndex","number","int","optional","inputSchema","id","gid","copies","array","max","createdSheetSchema","title","sheetUrl","successBranchSchema","type","literal","operationSummary","itemsProcessed","itemsChanged","completedAt","sourceGid","sourceTitle","items","failures","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","copyCount","length","spreadsheetInfo","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","sourceSheet","data","find","s","String","properties","sheetId","InvalidParams","sourceSheetId","Number","results","Promise","allSettled","map","copy","response","batchUpdate","requestBody","requests","duplicateSheet","newSheetName","undefined","insertSheetIndex","newSheetId","replies","Error","forEach","index","status","push","value","errorMessage","reason","message","successCount","failureCount","totalCount","summary","Date","toISOString","content","text","JSON","stringify","structuredContent","InternalError","stack","createTool","name"],"mappings":"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"}

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

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

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

@@ -1,6 +1,6 @@
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { google } from 'googleapis';
 import { z } from 'zod';
 import { SheetGidOutput, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
@@ -95,8 +95,8 @@ async function handler({ id, sheetTitle }, extra) {
         logger.error('sheets.sheet.create error', {
             error: message
         });
-        // Throw McpError for proper MCP error handling
-        throw new McpError(ErrorCode.InternalError, `Error creating sheet: ${message}`, {
+        // Throw ProtocolError for proper MCP error handling
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error creating sheet: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }