@mcp-z/mcp-sheets 1.2.2 → 2.0.0

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-get.ts"],"sourcesContent":["/** Get column names from Google Sheet (peek at first row only) */\n\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n});\n\n// Success branch schema - uses columns: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  columns: z.array(z.string()).describe('First row values (column names) or empty if no rows'),\n  isEmpty: z.boolean().describe('True if sheet has zero rows'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Get first row from Google Sheet. Returns columns array and isEmpty flag.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.debug?.('sheets.columns.get called', { id, gid, render });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? '';\n\n    // Read first row only (A1:ZZZ1 should cover most reasonable sheets)\n    const range = `'${sheetTitle}'!A1:ZZZ1`;\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n\n    const rows = response.data.values || [];\n    const isEmpty = rows.length === 0;\n\n    // Extract first row and convert to strings (column names)\n    const firstRow = rows[0] || [];\n    const columns = firstRow.map((value) => String(value ?? ''));\n\n    const result: Output = {\n      type: 'success' as const,\n      columns,\n      isEmpty,\n    };\n\n    logger.info?.('sheets.columns.get completed', { id, gid, columnCount: columns.length, isEmpty });\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error?.('sheets.columns.get error', { error: message });\n    throw new McpError(ErrorCode.InternalError, `Error getting sheet columns: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'columns-get',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","id","gid","render","enum","optional","describe","successBranchSchema","type","literal","columns","array","string","isEmpty","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","debug","sheet","spreadsheetResponse","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","sheetTitle","title","range","response","values","valueRenderOption","rows","length","firstRow","map","value","info","columnCount","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-get.ts"],"sourcesContent":["/** Get column names from Google Sheet (peek at first row only) */\n\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n});\n\n// Success branch schema - uses columns: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  columns: z.array(z.string()).describe('First row values (column names) or empty if no rows'),\n  isEmpty: z.boolean().describe('True if sheet has zero rows'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Get first row from Google Sheet. Returns columns array and isEmpty flag.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.debug?.('sheets.columns.get called', { id, gid, render });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? '';\n\n    // Read first row only (A1:ZZZ1 should cover most reasonable sheets)\n    const range = `'${sheetTitle}'!A1:ZZZ1`;\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n\n    const rows = response.data.values || [];\n    const isEmpty = rows.length === 0;\n\n    // Extract first row and convert to strings (column names)\n    const firstRow = rows[0] || [];\n    const columns = firstRow.map((value) => String(value ?? ''));\n\n    const result: Output = {\n      type: 'success' as const,\n      columns,\n      isEmpty,\n    };\n\n    logger.info?.('sheets.columns.get completed', { id, gid, columnCount: columns.length, isEmpty });\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error?.('sheets.columns.get error', { error: message });\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting sheet columns: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'columns-get',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","id","gid","render","enum","optional","describe","successBranchSchema","type","literal","columns","array","string","isEmpty","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","debug","sheet","spreadsheetResponse","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","sheetTitle","title","range","response","values","valueRenderOption","rows","length","firstRow","map","value","info","columnCount","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

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

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

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

@@ -1,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, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
@@ -118,7 +118,7 @@ async function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-up
             (_logger_error = logger.error) === null || _logger_error === void 0 ? void 0 : _logger_error.call(logger, 'sheets.columns.update error', {
                 error: message
             });
-            throw new McpError(ErrorCode.InvalidParams, message);
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, message);
         }
         // Get spreadsheet and sheet info in single API call
         const spreadsheetResponse = await sheets.spreadsheets.get({
@@ -140,7 +140,7 @@ async function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-up
                 gid,
                 rowCount: rows.length
             });
-            throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);
         }
         const sheetTitle = (_sheet_properties_title = sheet.properties.title) !== null && _sheet_properties_title !== void 0 ? _sheet_properties_title : gid;
         const sheetGid = (_sheet_properties_sheetId = sheet.properties.sheetId) !== null && _sheet_properties_sheetId !== void 0 ? _sheet_properties_sheetId : 0;
@@ -282,7 +282,7 @@ async function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-up
         (_logger_error1 = logger.error) === null || _logger_error1 === void 0 ? void 0 : _logger_error1.call(logger, 'sheets.columns.update error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error updating columns: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error updating columns: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-update.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { generateRowKey, type KeyGenerationStrategy, type Row, snapshotHeaderKeysAndPositions, type UpsertOptions, upsertByKey } from '../../spreadsheet/data-operations.ts';\n\n// Input schema for columns update requests with enhanced validation\nconst inputSchema = z\n  .object({\n    id: SpreadsheetIdSchema,\n    gid: SheetGidSchema,\n    rows: z.array(z.array(SheetCellSchema)).min(1).max(1000).describe('Array of rows to upsert (max 1000 rows per request). Each row is an array of cell values matching the headers array'),\n    headers: z.array(z.string().min(1).max(100)).min(1).max(50).describe('Array of column names/headers (max 50 columns). Must match the length of each row in the rows array'),\n    updateBy: z.array(z.string().min(1).max(100)).min(1).max(10).describe('Array of column names to use as unique keys for matching existing rows (max 10 key columns). These columns must exist in the headers array'),\n    behavior: z\n      .enum(['add-or-update', 'update-only', 'add-only'])\n      .default('add-or-update')\n      .describe('Update behavior: add-or-update (default) adds new rows and updates existing, update-only skips new rows, add-only skips existing rows. BEST FOR: Bulk upsert operations with key matching in structured database or table contexts.'),\n    valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How input data should be interpreted (RAW = exact values, USER_ENTERED = parsed like user input with formulas, dates, etc.)'),\n  })\n  .refine(\n    (data) => {\n      // Validate that all updateBy columns exist in headers\n      const missingColumns = data.updateBy.filter((col) => !data.headers.includes(col));\n      return missingColumns.length === 0;\n    },\n    {\n      message: 'All updateBy columns must exist in the headers array',\n      path: ['updateBy'],\n    }\n  )\n  .refine(\n    (data) => {\n      // Validate that all rows have the same length as headers\n      const invalidRows = data.rows.findIndex((row) => row.length !== data.headers.length);\n      return invalidRows === -1;\n    },\n    {\n      message: 'All rows must have the same length as the headers array',\n      path: ['rows'],\n    }\n  )\n  .refine(\n    (data) => {\n      // Validate that updateBy columns are unique\n      const uniqueColumns = new Set(data.updateBy);\n      return uniqueColumns.size === data.updateBy.length;\n    },\n    {\n      message: 'updateBy columns must be unique',\n      path: ['updateBy'],\n    }\n  );\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  spreadsheetTitle: z.string().describe('Title of the updated spreadsheet'),\n  spreadsheetUrl: z.string().describe('URL of the updated spreadsheet'),\n  sheetTitle: z.string().describe('Title of the updated sheet'),\n  sheetUrl: z.string().describe('URL of the updated sheet'),\n  updatedRows: z.number().int().nonnegative().describe('Number of rows that were successfully updated or inserted'),\n  insertedKeys: z.array(z.string()).describe('Keys of rows that were successfully inserted (new rows)'),\n  rowsSkipped: z.number().int().nonnegative().describe('Number of rows that were skipped based on the update behavior and existing data'),\n  headersAdded: z.array(z.string()).describe('Column headers that were added to the sheet (if any were missing)'),\n  errors: z.array(z.string()).optional().describe('Any non-fatal errors encountered during the operation'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows.',\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// Helper function to ensure consistent key generation\nfunction generateConsistentRowKey(row: Row, headers: string[], strategy: KeyGenerationStrategy): string {\n  return generateRowKey(row, headers, strategy);\n}\n\nasync function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-update', valueInputOption = 'USER_ENTERED' }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.debug?.('sheets.columns.update called', {\n    id,\n    gid,\n    rowCount: rows.length,\n    headerCount: headers.length,\n    updateByColumns: updateBy,\n    behavior,\n    valueInputOption,\n  });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Note: Basic input validation is now handled by the enhanced Zod schema\n\n    // EARLY VALIDATION: Validate that updateBy columns have non-empty values for all rows\n    // This validation happens before finding spreadsheet/sheet to fail fast\n    const emptyKeyErrors: string[] = [];\n    rows.forEach((row, rowIndex) => {\n      const keyValues = updateBy.map((keyCol) => {\n        const colIndex = headers.indexOf(keyCol);\n        return colIndex >= 0 ? String(row[colIndex] ?? '').trim() : '';\n      });\n\n      if (keyValues.some((val) => val === '')) {\n        emptyKeyErrors.push(`Row ${rowIndex + 1} has empty key values for columns: ${updateBy.join(', ')}`);\n      }\n    });\n\n    if (emptyKeyErrors.length > 0) {\n      const message = `Silent data loss prevented - empty key columns detected:\\n${emptyKeyErrors.join('\\n')}`;\n      logger.error?.('sheets.columns.update error', { error: message });\n      throw new McpError(ErrorCode.InvalidParams, message);\n    }\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const spreadsheetData = spreadsheetResponse.data;\n    const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n    const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n    // Find sheet by gid\n    const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.warn?.('Sheet not found for columns update', { id, gid, rowCount: rows.length });\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    const sheetGid = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n    // Configure upsert options based on behavior\n    const upsertOptions: UpsertOptions = {\n      keyStrategy: {\n        keyColumns: updateBy,\n        useProviderIdLogic: false, // Use standard key generation for column-based updates\n        separator: '\\\\',\n      },\n      allowUpdates: behavior === 'add-or-update' || behavior === 'update-only',\n      batchSize: 50,\n      valueInputOption: valueInputOption,\n    };\n\n    // Get existing keys to implement behavior filtering\n    const { keySet: existingKeys } = await snapshotHeaderKeysAndPositions(sheets, id, sheetTitle, updateBy, upsertOptions.keyStrategy);\n\n    // Filter rows based on behavior using consistent key generation\n    let processedRows = rows;\n    if (behavior === 'add-only') {\n      // Only include rows that don't exist yet\n      processedRows = rows.filter((row) => {\n        // Use the same key generation strategy as the upsert function\n        const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n        return key !== '' && !existingKeys.has(key);\n      });\n      logger.debug?.('Filtered rows for add-only behavior', {\n        originalCount: rows.length,\n        filteredCount: processedRows.length,\n      });\n    } else if (behavior === 'update-only') {\n      // Only include rows that already exist\n      processedRows = rows.filter((row) => {\n        // Use the same key generation strategy as the upsert function\n        const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n        return key !== '' && existingKeys.has(key);\n      });\n      logger.debug?.('Filtered rows for update-only behavior', {\n        originalCount: rows.length,\n        filteredCount: processedRows.length,\n      });\n    }\n\n    // Early return if no rows to process after behavior filtering\n    if (processedRows.length === 0) {\n      logger.info?.('No rows to process after behavior filtering', { behavior, originalCount: rows.length });\n      const result: Output = {\n        type: 'success' as const,\n        id,\n        gid: String(sheetGid),\n        spreadsheetTitle: spreadsheetTitle || '',\n        spreadsheetUrl: spreadsheetUrl || '',\n        sheetTitle,\n        sheetUrl,\n        updatedRows: 0,\n        insertedKeys: [],\n        rowsSkipped: rows.length,\n        headersAdded: [],\n        errors: [`No rows matched behavior '${behavior}' - all ${rows.length} rows were skipped`],\n      };\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n        structuredContent: { result },\n      };\n    }\n\n    logger.debug?.('sheets.columns.update executing upsert operation', {\n      spreadsheetId: id,\n      sheetTitle,\n      canonicalHeaders: headers,\n      keyColumns: updateBy,\n      behavior,\n      processedRowsCount: processedRows.length,\n    });\n\n    // Execute the upsert operation using the shared function\n    const upsertResult = await upsertByKey(sheets, {\n      spreadsheetId: id,\n      sheetTitle,\n      rows: processedRows,\n      canonicalHeaders: headers,\n      options: upsertOptions,\n      logger,\n    });\n\n    // Track headers that were added (if any)\n    // This would require additional logic in upsertByKey to return added headers\n    const headersAdded: string[] = [];\n\n    // Calculate total rows skipped: behavior filter + upsert duplicates\n    const rowsFilteredByBehavior = rows.length - processedRows.length;\n    const totalRowsSkipped = upsertResult.rowsSkipped + rowsFilteredByBehavior;\n\n    logger.debug?.('sheets.columns.update completed successfully', {\n      updatedRows: upsertResult.updatedRows,\n      insertedCount: upsertResult.inserted.length,\n      rowsSkipped: totalRowsSkipped,\n      rowsFilteredByBehavior,\n      rowsSkippedByUpsert: upsertResult.rowsSkipped,\n      errorsCount: upsertResult.errors?.length || 0,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetGid),\n      spreadsheetTitle: spreadsheetTitle || '',\n      spreadsheetUrl: spreadsheetUrl || '',\n      sheetTitle,\n      sheetUrl,\n      updatedRows: upsertResult.updatedRows,\n      insertedKeys: upsertResult.inserted,\n      rowsSkipped: totalRowsSkipped,\n      headersAdded,\n      errors: upsertResult.errors,\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.columns.update error', { error: message });\n    throw new McpError(ErrorCode.InternalError, `Error updating columns: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'columns-update',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetCellSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","generateRowKey","snapshotHeaderKeysAndPositions","upsertByKey","inputSchema","object","id","gid","rows","array","min","max","describe","headers","string","updateBy","behavior","enum","default","valueInputOption","refine","data","missingColumns","filter","col","includes","length","message","path","invalidRows","findIndex","row","uniqueColumns","Set","size","successBranchSchema","type","literal","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRows","number","int","nonnegative","insertedKeys","rowsSkipped","headersAdded","errors","optional","outputSchema","discriminatedUnion","config","description","result","generateConsistentRowKey","strategy","handler","extra","logger","debug","rowCount","headerCount","updateByColumns","spreadsheetData","sheet","upsertResult","sheets","version","auth","authContext","emptyKeyErrors","forEach","rowIndex","keyValues","map","keyCol","colIndex","indexOf","String","trim","some","val","push","join","error","InvalidParams","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","properties","title","find","s","sheetId","warn","sheetGid","upsertOptions","keyStrategy","keyColumns","useProviderIdLogic","separator","allowUpdates","batchSize","keySet","existingKeys","processedRows","key","has","originalCount","filteredCount","info","content","text","JSON","stringify","structuredContent","canonicalHeaders","processedRowsCount","options","rowsFilteredByBehavior","totalRowsSkipped","insertedCount","inserted","rowsSkippedByUpsert","errorsCount","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/columns-update.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { generateRowKey, type KeyGenerationStrategy, type Row, snapshotHeaderKeysAndPositions, type UpsertOptions, upsertByKey } from '../../spreadsheet/data-operations.ts';\n\n// Input schema for columns update requests with enhanced validation\nconst inputSchema = z\n  .object({\n    id: SpreadsheetIdSchema,\n    gid: SheetGidSchema,\n    rows: z.array(z.array(SheetCellSchema)).min(1).max(1000).describe('Array of rows to upsert (max 1000 rows per request). Each row is an array of cell values matching the headers array'),\n    headers: z.array(z.string().min(1).max(100)).min(1).max(50).describe('Array of column names/headers (max 50 columns). Must match the length of each row in the rows array'),\n    updateBy: z.array(z.string().min(1).max(100)).min(1).max(10).describe('Array of column names to use as unique keys for matching existing rows (max 10 key columns). These columns must exist in the headers array'),\n    behavior: z\n      .enum(['add-or-update', 'update-only', 'add-only'])\n      .default('add-or-update')\n      .describe('Update behavior: add-or-update (default) adds new rows and updates existing, update-only skips new rows, add-only skips existing rows. BEST FOR: Bulk upsert operations with key matching in structured database or table contexts.'),\n    valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How input data should be interpreted (RAW = exact values, USER_ENTERED = parsed like user input with formulas, dates, etc.)'),\n  })\n  .refine(\n    (data) => {\n      // Validate that all updateBy columns exist in headers\n      const missingColumns = data.updateBy.filter((col) => !data.headers.includes(col));\n      return missingColumns.length === 0;\n    },\n    {\n      message: 'All updateBy columns must exist in the headers array',\n      path: ['updateBy'],\n    }\n  )\n  .refine(\n    (data) => {\n      // Validate that all rows have the same length as headers\n      const invalidRows = data.rows.findIndex((row) => row.length !== data.headers.length);\n      return invalidRows === -1;\n    },\n    {\n      message: 'All rows must have the same length as the headers array',\n      path: ['rows'],\n    }\n  )\n  .refine(\n    (data) => {\n      // Validate that updateBy columns are unique\n      const uniqueColumns = new Set(data.updateBy);\n      return uniqueColumns.size === data.updateBy.length;\n    },\n    {\n      message: 'updateBy columns must be unique',\n      path: ['updateBy'],\n    }\n  );\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  spreadsheetTitle: z.string().describe('Title of the updated spreadsheet'),\n  spreadsheetUrl: z.string().describe('URL of the updated spreadsheet'),\n  sheetTitle: z.string().describe('Title of the updated sheet'),\n  sheetUrl: z.string().describe('URL of the updated sheet'),\n  updatedRows: z.number().int().nonnegative().describe('Number of rows that were successfully updated or inserted'),\n  insertedKeys: z.array(z.string()).describe('Keys of rows that were successfully inserted (new rows)'),\n  rowsSkipped: z.number().int().nonnegative().describe('Number of rows that were skipped based on the update behavior and existing data'),\n  headersAdded: z.array(z.string()).describe('Column headers that were added to the sheet (if any were missing)'),\n  errors: z.array(z.string()).optional().describe('Any non-fatal errors encountered during the operation'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows.',\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// Helper function to ensure consistent key generation\nfunction generateConsistentRowKey(row: Row, headers: string[], strategy: KeyGenerationStrategy): string {\n  return generateRowKey(row, headers, strategy);\n}\n\nasync function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-update', valueInputOption = 'USER_ENTERED' }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.debug?.('sheets.columns.update called', {\n    id,\n    gid,\n    rowCount: rows.length,\n    headerCount: headers.length,\n    updateByColumns: updateBy,\n    behavior,\n    valueInputOption,\n  });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Note: Basic input validation is now handled by the enhanced Zod schema\n\n    // EARLY VALIDATION: Validate that updateBy columns have non-empty values for all rows\n    // This validation happens before finding spreadsheet/sheet to fail fast\n    const emptyKeyErrors: string[] = [];\n    rows.forEach((row, rowIndex) => {\n      const keyValues = updateBy.map((keyCol) => {\n        const colIndex = headers.indexOf(keyCol);\n        return colIndex >= 0 ? String(row[colIndex] ?? '').trim() : '';\n      });\n\n      if (keyValues.some((val) => val === '')) {\n        emptyKeyErrors.push(`Row ${rowIndex + 1} has empty key values for columns: ${updateBy.join(', ')}`);\n      }\n    });\n\n    if (emptyKeyErrors.length > 0) {\n      const message = `Silent data loss prevented - empty key columns detected:\\n${emptyKeyErrors.join('\\n')}`;\n      logger.error?.('sheets.columns.update error', { error: message });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, message);\n    }\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const spreadsheetData = spreadsheetResponse.data;\n    const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n    const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n    // Find sheet by gid\n    const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.warn?.('Sheet not found for columns update', { id, gid, rowCount: rows.length });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    const sheetGid = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n    // Configure upsert options based on behavior\n    const upsertOptions: UpsertOptions = {\n      keyStrategy: {\n        keyColumns: updateBy,\n        useProviderIdLogic: false, // Use standard key generation for column-based updates\n        separator: '\\\\',\n      },\n      allowUpdates: behavior === 'add-or-update' || behavior === 'update-only',\n      batchSize: 50,\n      valueInputOption: valueInputOption,\n    };\n\n    // Get existing keys to implement behavior filtering\n    const { keySet: existingKeys } = await snapshotHeaderKeysAndPositions(sheets, id, sheetTitle, updateBy, upsertOptions.keyStrategy);\n\n    // Filter rows based on behavior using consistent key generation\n    let processedRows = rows;\n    if (behavior === 'add-only') {\n      // Only include rows that don't exist yet\n      processedRows = rows.filter((row) => {\n        // Use the same key generation strategy as the upsert function\n        const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n        return key !== '' && !existingKeys.has(key);\n      });\n      logger.debug?.('Filtered rows for add-only behavior', {\n        originalCount: rows.length,\n        filteredCount: processedRows.length,\n      });\n    } else if (behavior === 'update-only') {\n      // Only include rows that already exist\n      processedRows = rows.filter((row) => {\n        // Use the same key generation strategy as the upsert function\n        const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n        return key !== '' && existingKeys.has(key);\n      });\n      logger.debug?.('Filtered rows for update-only behavior', {\n        originalCount: rows.length,\n        filteredCount: processedRows.length,\n      });\n    }\n\n    // Early return if no rows to process after behavior filtering\n    if (processedRows.length === 0) {\n      logger.info?.('No rows to process after behavior filtering', { behavior, originalCount: rows.length });\n      const result: Output = {\n        type: 'success' as const,\n        id,\n        gid: String(sheetGid),\n        spreadsheetTitle: spreadsheetTitle || '',\n        spreadsheetUrl: spreadsheetUrl || '',\n        sheetTitle,\n        sheetUrl,\n        updatedRows: 0,\n        insertedKeys: [],\n        rowsSkipped: rows.length,\n        headersAdded: [],\n        errors: [`No rows matched behavior '${behavior}' - all ${rows.length} rows were skipped`],\n      };\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n        structuredContent: { result },\n      };\n    }\n\n    logger.debug?.('sheets.columns.update executing upsert operation', {\n      spreadsheetId: id,\n      sheetTitle,\n      canonicalHeaders: headers,\n      keyColumns: updateBy,\n      behavior,\n      processedRowsCount: processedRows.length,\n    });\n\n    // Execute the upsert operation using the shared function\n    const upsertResult = await upsertByKey(sheets, {\n      spreadsheetId: id,\n      sheetTitle,\n      rows: processedRows,\n      canonicalHeaders: headers,\n      options: upsertOptions,\n      logger,\n    });\n\n    // Track headers that were added (if any)\n    // This would require additional logic in upsertByKey to return added headers\n    const headersAdded: string[] = [];\n\n    // Calculate total rows skipped: behavior filter + upsert duplicates\n    const rowsFilteredByBehavior = rows.length - processedRows.length;\n    const totalRowsSkipped = upsertResult.rowsSkipped + rowsFilteredByBehavior;\n\n    logger.debug?.('sheets.columns.update completed successfully', {\n      updatedRows: upsertResult.updatedRows,\n      insertedCount: upsertResult.inserted.length,\n      rowsSkipped: totalRowsSkipped,\n      rowsFilteredByBehavior,\n      rowsSkippedByUpsert: upsertResult.rowsSkipped,\n      errorsCount: upsertResult.errors?.length || 0,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetGid),\n      spreadsheetTitle: spreadsheetTitle || '',\n      spreadsheetUrl: spreadsheetUrl || '',\n      sheetTitle,\n      sheetUrl,\n      updatedRows: upsertResult.updatedRows,\n      insertedKeys: upsertResult.inserted,\n      rowsSkipped: totalRowsSkipped,\n      headersAdded,\n      errors: upsertResult.errors,\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.columns.update error', { error: message });\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error updating columns: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'columns-update',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SheetCellSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","generateRowKey","snapshotHeaderKeysAndPositions","upsertByKey","inputSchema","object","id","gid","rows","array","min","max","describe","headers","string","updateBy","behavior","enum","default","valueInputOption","refine","data","missingColumns","filter","col","includes","length","message","path","invalidRows","findIndex","row","uniqueColumns","Set","size","successBranchSchema","type","literal","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRows","number","int","nonnegative","insertedKeys","rowsSkipped","headersAdded","errors","optional","outputSchema","discriminatedUnion","config","description","result","generateConsistentRowKey","strategy","handler","extra","logger","debug","rowCount","headerCount","updateByColumns","spreadsheetData","sheet","upsertResult","sheets","version","auth","authContext","emptyKeyErrors","forEach","rowIndex","keyValues","map","keyCol","colIndex","indexOf","String","trim","some","val","push","join","error","InvalidParams","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","properties","title","find","s","sheetId","warn","sheetGid","upsertOptions","keyStrategy","keyColumns","useProviderIdLogic","separator","allowUpdates","batchSize","keySet","existingKeys","processedRows","key","has","originalCount","filteredCount","info","content","text","JSON","stringify","structuredContent","canonicalHeaders","processedRowsCount","options","rowsFilteredByBehavior","totalRowsSkipped","insertedCount","inserted","rowsSkippedByUpsert","errorsCount","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

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

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

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

@@ -1,6 +1,6 @@
 /** Get column names from CSV file (peek at first row only) */ import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { parse } from 'csv-parse';
 import { z } from 'zod';
 import { getCsvReadStream } from '../../spreadsheet/csv-streaming.js';
@@ -81,7 +81,7 @@ async function handler({ sourceUri }, extra) {
         (_logger_error = logger.error) === null || _logger_error === void 0 ? void 0 : _logger_error.call(logger, 'sheets.csv.get-columns error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error getting CSV columns: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting CSV columns: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/csv-get-columns.ts"],"sourcesContent":["/** Get column names from CSV file (peek at first row only) */\n\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { parse } from 'csv-parse';\nimport { z } from 'zod';\nimport { getCsvReadStream } from '../../spreadsheet/csv-streaming.ts';\n\nconst inputSchema = z.object({\n  sourceUri: z.string().trim().min(1).describe('CSV file URI (file://, http://, https://)'),\n});\n\n// Success branch schema - uses columns: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  columns: z.array(z.string()).describe('First row values (column names) or empty if no rows'),\n  isEmpty: z.boolean().describe('True if CSV has zero rows'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Get first row from CSV file (streaming, no memory overhead). Returns columns array and isEmpty flag.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ sourceUri }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.debug?.('sheets.csv.get-columns called', { sourceUri });\n\n  try {\n    // Get readable stream from CSV URI (no temp files!)\n    const readStream = await getCsvReadStream(sourceUri);\n\n    // Create CSV parser without treating first row as column names\n    // We just want to read the raw first row\n    const parser = readStream.pipe(\n      parse({\n        columns: false, // Don't treat first row as 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    // Read only the first row\n    let firstRow: unknown[] = [];\n    let rowCount = 0;\n\n    for await (const row of parser) {\n      firstRow = row;\n      rowCount++;\n      break; // Only read first row\n    }\n\n    // Convert first row to strings (column names)\n    const columns = firstRow.map((value) => String(value ?? ''));\n    const isEmpty = rowCount === 0;\n\n    const result: Output = {\n      type: 'success' as const,\n      columns,\n      isEmpty,\n    };\n\n    logger.info?.('sheets.csv.get-columns completed', { sourceUri, columnCount: columns.length, isEmpty });\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error?.('sheets.csv.get-columns error', { error: message });\n    throw new McpError(ErrorCode.InternalError, `Error getting CSV columns: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'csv-get-columns',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","parse","z","getCsvReadStream","inputSchema","object","sourceUri","string","trim","min","describe","successBranchSchema","type","literal","columns","array","isEmpty","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","debug","readStream","parser","pipe","skip_empty_lines","cast","relax_column_count","firstRow","rowCount","row","map","value","String","info","columnCount","length","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"AAAA,4DAA4D,GAG5D,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAIrC,SAASE,SAAS,EAAEC,QAAQ,QAAQ,qCAAqC;AACzE,SAASC,KAAK,QAAQ,YAAY;AAClC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,gBAAgB,QAAQ,qCAAqC;AAEtE,MAAMC,cAAcF,EAAEG,MAAM,CAAC;IAC3BC,WAAWJ,EAAEK,MAAM,GAAGC,IAAI,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAC/C;AAEA,iFAAiF;AACjF,MAAMC,sBAAsBT,EAAEG,MAAM,CAAC;IACnCO,MAAMV,EAAEW,OAAO,CAAC;IAChBC,SAASZ,EAAEa,KAAK,CAACb,EAAEK,MAAM,IAAIG,QAAQ,CAAC;IACtCM,SAASd,EAAEe,OAAO,GAAGP,QAAQ,CAAC;AAChC;AAEA,MAAMQ,eAAehB,EAAEiB,kBAAkB,CAAC,QAAQ;IAACR;IAAqBb;CAAyB;AAEjG,MAAMsB,SAAS;IACbC,aAAa;IACbjB;IACAc,cAAchB,EAAEG,MAAM,CAAC;QACrBiB,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAEjB,SAAS,EAAS,EAAEkB,KAAoB;QAE/DC;IADA,MAAMA,SAASD,MAAMC,MAAM;KAC3BA,gBAAAA,OAAOC,KAAK,cAAZD,oCAAAA,mBAAAA,QAAe,iCAAiC;QAAEnB;IAAU;IAE5D,IAAI;YAoCFmB;QAnCA,oDAAoD;QACpD,MAAME,aAAa,MAAMxB,iBAAiBG;QAE1C,+DAA+D;QAC/D,yCAAyC;QACzC,MAAMsB,SAASD,WAAWE,IAAI,CAC5B5B,MAAM;YACJa,SAAS;YACTgB,kBAAkB;YAClBtB,MAAM;YACNuB,MAAM;YACNC,oBAAoB;QACtB;QAGF,0BAA0B;QAC1B,IAAIC,WAAsB,EAAE;QAC5B,IAAIC,WAAW;QAEf,WAAW,MAAMC,OAAOP,OAAQ;YAC9BK,WAAWE;YACXD;YACA,OAAO,sBAAsB;QAC/B;QAEA,8CAA8C;QAC9C,MAAMpB,UAAUmB,SAASG,GAAG,CAAC,CAACC,QAAUC,OAAOD,kBAAAA,mBAAAA,QAAS;QACxD,MAAMrB,UAAUkB,aAAa;QAE7B,MAAMZ,SAAiB;YACrBV,MAAM;YACNE;YACAE;QACF;SAEAS,eAAAA,OAAOc,IAAI,cAAXd,mCAAAA,kBAAAA,QAAc,oCAAoC;YAAEnB;YAAWkC,aAAa1B,QAAQ2B,MAAM;YAAEzB;QAAQ;QACpG,OAAO;YACL0B,SAAS;gBAAC;oBAAE9B,MAAM;oBAAiB+B,MAAMC,KAAKC,SAAS,CAACvB;gBAAQ;aAAE;YAClEwB,mBAAmB;gBAAExB;YAAO;QAC9B;IACF,EAAE,OAAOyB,OAAO;YAEdtB;QADA,MAAMuB,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGV,OAAOS;SAChEtB,gBAAAA,OAAOsB,KAAK,cAAZtB,oCAAAA,mBAAAA,QAAe,gCAAgC;YAAEsB,OAAOC;QAAQ;QAChE,MAAM,IAAIhD,SAASD,UAAUmD,aAAa,EAAE,CAAC,2BAA2B,EAAEF,SAAS,EAAE;YACnFG,OAAOJ,iBAAiBE,QAAQF,MAAMI,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACNlC;QACAG;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/csv-get-columns.ts"],"sourcesContent":["/** Get column names from CSV file (peek at first row only) */\n\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { parse } from 'csv-parse';\nimport { z } from 'zod';\nimport { getCsvReadStream } from '../../spreadsheet/csv-streaming.ts';\n\nconst inputSchema = z.object({\n  sourceUri: z.string().trim().min(1).describe('CSV file URI (file://, http://, https://)'),\n});\n\n// Success branch schema - uses columns: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  columns: z.array(z.string()).describe('First row values (column names) or empty if no rows'),\n  isEmpty: z.boolean().describe('True if CSV has zero rows'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Get first row from CSV file (streaming, no memory overhead). Returns columns array and isEmpty flag.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ sourceUri }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.debug?.('sheets.csv.get-columns called', { sourceUri });\n\n  try {\n    // Get readable stream from CSV URI (no temp files!)\n    const readStream = await getCsvReadStream(sourceUri);\n\n    // Create CSV parser without treating first row as column names\n    // We just want to read the raw first row\n    const parser = readStream.pipe(\n      parse({\n        columns: false, // Don't treat first row as 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    // Read only the first row\n    let firstRow: unknown[] = [];\n    let rowCount = 0;\n\n    for await (const row of parser) {\n      firstRow = row;\n      rowCount++;\n      break; // Only read first row\n    }\n\n    // Convert first row to strings (column names)\n    const columns = firstRow.map((value) => String(value ?? ''));\n    const isEmpty = rowCount === 0;\n\n    const result: Output = {\n      type: 'success' as const,\n      columns,\n      isEmpty,\n    };\n\n    logger.info?.('sheets.csv.get-columns completed', { sourceUri, columnCount: columns.length, isEmpty });\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error?.('sheets.csv.get-columns error', { error: message });\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting CSV columns: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'csv-get-columns',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","parse","z","getCsvReadStream","inputSchema","object","sourceUri","string","trim","min","describe","successBranchSchema","type","literal","columns","array","isEmpty","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","debug","readStream","parser","pipe","skip_empty_lines","cast","relax_column_count","firstRow","rowCount","row","map","value","String","info","columnCount","length","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"AAAA,4DAA4D,GAG5D,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAGrC,SAASE,aAAa,EAAEC,iBAAiB,QAAQ,gBAAgB;AACjE,SAASC,KAAK,QAAQ,YAAY;AAClC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,gBAAgB,QAAQ,qCAAqC;AAEtE,MAAMC,cAAcF,EAAEG,MAAM,CAAC;IAC3BC,WAAWJ,EAAEK,MAAM,GAAGC,IAAI,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAC/C;AAEA,iFAAiF;AACjF,MAAMC,sBAAsBT,EAAEG,MAAM,CAAC;IACnCO,MAAMV,EAAEW,OAAO,CAAC;IAChBC,SAASZ,EAAEa,KAAK,CAACb,EAAEK,MAAM,IAAIG,QAAQ,CAAC;IACtCM,SAASd,EAAEe,OAAO,GAAGP,QAAQ,CAAC;AAChC;AAEA,MAAMQ,eAAehB,EAAEiB,kBAAkB,CAAC,QAAQ;IAACR;IAAqBb;CAAyB;AAEjG,MAAMsB,SAAS;IACbC,aAAa;IACbjB;IACAc,cAAchB,EAAEG,MAAM,CAAC;QACrBiB,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAEjB,SAAS,EAAS,EAAEkB,KAAoB;QAE/DC;IADA,MAAMA,SAASD,MAAMC,MAAM;KAC3BA,gBAAAA,OAAOC,KAAK,cAAZD,oCAAAA,mBAAAA,QAAe,iCAAiC;QAAEnB;IAAU;IAE5D,IAAI;YAoCFmB;QAnCA,oDAAoD;QACpD,MAAME,aAAa,MAAMxB,iBAAiBG;QAE1C,+DAA+D;QAC/D,yCAAyC;QACzC,MAAMsB,SAASD,WAAWE,IAAI,CAC5B5B,MAAM;YACJa,SAAS;YACTgB,kBAAkB;YAClBtB,MAAM;YACNuB,MAAM;YACNC,oBAAoB;QACtB;QAGF,0BAA0B;QAC1B,IAAIC,WAAsB,EAAE;QAC5B,IAAIC,WAAW;QAEf,WAAW,MAAMC,OAAOP,OAAQ;YAC9BK,WAAWE;YACXD;YACA,OAAO,sBAAsB;QAC/B;QAEA,8CAA8C;QAC9C,MAAMpB,UAAUmB,SAASG,GAAG,CAAC,CAACC,QAAUC,OAAOD,kBAAAA,mBAAAA,QAAS;QACxD,MAAMrB,UAAUkB,aAAa;QAE7B,MAAMZ,SAAiB;YACrBV,MAAM;YACNE;YACAE;QACF;SAEAS,eAAAA,OAAOc,IAAI,cAAXd,mCAAAA,kBAAAA,QAAc,oCAAoC;YAAEnB;YAAWkC,aAAa1B,QAAQ2B,MAAM;YAAEzB;QAAQ;QACpG,OAAO;YACL0B,SAAS;gBAAC;oBAAE9B,MAAM;oBAAiB+B,MAAMC,KAAKC,SAAS,CAACvB;gBAAQ;aAAE;YAClEwB,mBAAmB;gBAAExB;YAAO;QAC9B;IACF,EAAE,OAAOyB,OAAO;YAEdtB;QADA,MAAMuB,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGV,OAAOS;SAChEtB,gBAAAA,OAAOsB,KAAK,cAAZtB,oCAAAA,mBAAAA,QAAe,gCAAgC;YAAEsB,OAAOC;QAAQ;QAChE,MAAM,IAAIjD,cAAcC,kBAAkBkD,aAAa,EAAE,CAAC,2BAA2B,EAAEF,SAAS,EAAE;YAChGG,OAAOJ,iBAAiBE,QAAQF,MAAMI,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACNlC;QACAG;IACF;AACF"}

package/dist/esm/mcp/tools/dimensions-batch-update.d.ts

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

package/dist/esm/mcp/tools/dimensions-batch-update.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';
@@ -106,7 +106,7 @@ async function handler({ id, gid, requests }, extra) {
                 gid,
                 requestCount: requests.length
             });
-            throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);
         }
         const sheetTitle = (_sheet_properties_title = sheet.properties.title) !== null && _sheet_properties_title !== void 0 ? _sheet_properties_title : gid;
         const sheetId = sheet.properties.sheetId;
@@ -117,7 +117,7 @@ async function handler({ id, gid, requests }, extra) {
                 gid,
                 sheetTitle
             });
-            throw new McpError(ErrorCode.InternalError, `Sheet ID not available for ${gid}. Cannot perform dimension operations without valid sheet ID.`);
+            throw new ProtocolError(ProtocolErrorCode.InternalError, `Sheet ID not available for ${gid}. Cannot perform dimension operations without valid sheet ID.`);
         }
         const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;
         // Get current sheet dimensions for response calculation
@@ -167,7 +167,7 @@ async function handler({ id, gid, requests }, extra) {
                 sheetTitle,
                 requestCount: requests.length
             });
-            throw new McpError(ErrorCode.InternalError, 'Batch update failed: no response data received from Google Sheets API');
+            throw new ProtocolError(ProtocolErrorCode.InternalError, 'Batch update failed: no response data received from Google Sheets API');
         }
         const replies = updateResult.replies || [];
         const expectedCount = requests.length;
@@ -185,7 +185,7 @@ async function handler({ id, gid, requests }, extra) {
                         replyType: Object.keys(reply || {})[0] || 'empty'
                     }))
             });
-            throw new McpError(ErrorCode.InternalError, `Batch operation failed: expected ${expectedCount} operations, received ${actualCount} replies. This may indicate a partial failure or Google API issue.`);
+            throw new ProtocolError(ProtocolErrorCode.InternalError, `Batch operation failed: expected ${expectedCount} operations, received ${actualCount} replies. This may indicate a partial failure or Google API issue.`);
         }
         // Validate each reply exists - Google Sheets API may return empty objects for successful operations
         for(let i = 0; i < replies.length; i++){
@@ -200,7 +200,7 @@ async function handler({ id, gid, requests }, extra) {
                     spreadsheetId: id,
                     sheetTitle
                 });
-                throw new McpError(ErrorCode.InternalError, `Operation ${i} failed: missing request data`);
+                throw new ProtocolError(ProtocolErrorCode.InternalError, `Operation ${i} failed: missing request data`);
             }
             // Note: Google Sheets API often returns empty objects {} for successful dimension operations
             // This is normal behavior and indicates success, not failure
@@ -213,7 +213,7 @@ async function handler({ id, gid, requests }, extra) {
                     spreadsheetId: id,
                     sheetTitle
                 });
-                throw new McpError(ErrorCode.InternalError, `Operation ${i} (${request.operation}) failed: null reply from Google Sheets API`);
+                throw new ProtocolError(ProtocolErrorCode.InternalError, `Operation ${i} (${request.operation}) failed: null reply from Google Sheets API`);
             }
         }
         // Calculate final dimensions and operation results
@@ -307,7 +307,7 @@ async function handler({ id, gid, requests }, extra) {
         (_logger_error5 = logger.error) === null || _logger_error5 === void 0 ? void 0 : _logger_error5.call(logger, 'sheets.dimensions.batchUpdate error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error batch updating dimensions: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error batch updating dimensions: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

package/dist/esm/mcp/tools/dimensions-batch-update.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/dimensions-batch-update.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { buildDimensionRequest, calculateAffectedCount, DEFAULT_COLUMN_COUNT, DEFAULT_ROW_COUNT, type DimensionRequest, MAX_COLUMN_COUNT, MAX_ROW_COUNT, sortOperations } from './lib/dimension-operations.ts';\n\n// Input schema for dimension batch update requests\nconst DimensionRequestSchema = z.object({\n  operation: z.enum(['insertDimension', 'deleteDimension', 'appendDimension']).describe('Type of dimension operation to perform'),\n  dimension: z.enum(['ROWS', 'COLUMNS']).describe('Whether to operate on rows or columns'),\n  startIndex: z.number().int().nonnegative().describe('Starting index for the operation (0-based)'),\n  endIndex: z.number().int().nonnegative().optional().describe('Ending index for the operation (0-based, exclusive). Optional - if omitted, the range is unbounded (extends to the end of the sheet)'),\n  inheritFromBefore: z.boolean().optional().describe('For insertDimension: whether new rows/columns inherit properties from the row/column before the insertion point'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  requests: z.array(DimensionRequestSchema).min(1).describe('Array of dimension update requests'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  spreadsheetTitle: z.string().describe('Title of the updated spreadsheet'),\n  spreadsheetUrl: z.string().describe('URL of the updated spreadsheet'),\n  sheetTitle: z.string().describe('Title of the updated sheet'),\n  sheetUrl: z.string().describe('URL of the updated sheet'),\n  totalOperations: z.number().int().nonnegative().describe('Total number of dimension operations performed'),\n  operationResults: z\n    .array(\n      z.object({\n        operation: z.enum(['insertDimension', 'deleteDimension', 'appendDimension']).describe('Type of operation that was performed'),\n        dimension: z.enum(['ROWS', 'COLUMNS']).describe('Dimension that was operated on'),\n        startIndex: z.number().int().nonnegative().describe('Starting index of the operation'),\n        endIndex: z.number().int().nonnegative().optional().describe('Ending index of the operation (for insert/delete)'),\n        affectedCount: z.number().int().nonnegative().describe('Number of rows/columns affected by this operation'),\n      })\n    )\n    .describe('Detailed results for each dimension operation'),\n  updatedDimensions: z\n    .object({\n      rows: z.number().int().nonnegative().describe('Total number of rows in the sheet after all operations'),\n      columns: z.number().int().nonnegative().describe('Total number of columns in the sheet after all operations'),\n    })\n    .describe('Final dimensions of the sheet after all operations'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Batch update sheet dimensions by inserting, deleting, or appending rows/columns. Operations are atomic (all succeed or all fail) and execute in optimal order automatically.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.debug?.('sheets.dimensions.batchUpdate called', {\n    id,\n    gid,\n    requestCount: requests.length,\n    operations: requests.map((r) => ({ operation: r.operation, dimension: r.dimension, startIndex: r.startIndex, endIndex: r.endIndex })),\n  });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title,sheets.properties.gridProperties',\n    });\n\n    const spreadsheetData = spreadsheetResponse.data;\n    const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n    const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n    // Find sheet by gid\n    const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.warn?.('Sheet not found for dimensions batch update', { id, gid, requestCount: requests.length });\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    const sheetId = sheet.properties.sheetId;\n\n    if (sheetId === undefined || sheetId === null) {\n      logger.error?.('Sheet ID not available for dimensions batch update', { id, gid, sheetTitle });\n      throw new McpError(ErrorCode.InternalError, `Sheet ID not available for ${gid}. Cannot perform dimension operations without valid sheet ID.`);\n    }\n\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n    // Get current sheet dimensions for response calculation\n    // Note: Google Sheets API may not always provide gridProperties for older sheets\n    // Fall back to Google's documented defaults for new sheets\n    const currentRowCount = sheet.properties.gridProperties?.rowCount ?? DEFAULT_ROW_COUNT;\n    const currentColumnCount = sheet.properties.gridProperties?.columnCount ?? DEFAULT_COLUMN_COUNT;\n\n    // Sort operations for optimal execution order to prevent index conflicts\n    // Delete operations are processed first (high to low index) to avoid shifting issues\n    // Insert/append operations are processed after (low to high index)\n    const sortedRequests = sortOperations(requests as DimensionRequest[]);\n\n    // Build Google Sheets API batch update requests\n    const batchRequests = sortedRequests.map((operation) => buildDimensionRequest(operation, sheetId));\n\n    logger.debug?.('sheets.dimensions.batchUpdate executing batch request', {\n      spreadsheetId: id,\n      sheetTitle,\n      sheetId,\n      totalOperations: batchRequests.length,\n      operationTypes: sortedRequests.map((r) => r.operation),\n      operationDetails: sortedRequests.map((r, i) => ({\n        index: i,\n        operation: r.operation,\n        dimension: r.dimension,\n        startIndex: r.startIndex,\n        endIndex: r.endIndex,\n        affectedCount: calculateAffectedCount(r),\n      })),\n      currentDimensions: { rows: currentRowCount, columns: currentColumnCount },\n    });\n\n    // Execute the atomic batch update\n    const batchUpdateResponse = await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: batchRequests,\n        includeSpreadsheetInResponse: false, // We don't need the full spreadsheet data back\n      },\n    });\n\n    const updateResult = batchUpdateResponse.data;\n\n    // Comprehensive validation of batch update results\n    if (!updateResult) {\n      logger.error?.('Dimensions batch update failed - no response data', {\n        spreadsheetId: id,\n        sheetTitle,\n        requestCount: requests.length,\n      });\n      throw new McpError(ErrorCode.InternalError, 'Batch update failed: no response data received from Google Sheets API');\n    }\n\n    const replies = updateResult.replies || [];\n    const expectedCount = requests.length;\n    const actualCount = replies.length;\n\n    // Validate operation count matches expectations\n    if (actualCount !== expectedCount) {\n      logger.error?.('Dimensions batch update failed - operation count mismatch', {\n        expectedOperations: expectedCount,\n        actualReplies: actualCount,\n        spreadsheetId: id,\n        sheetTitle,\n        receivedReplies: replies.map((reply, index) => ({\n          index,\n          replyType: Object.keys(reply || {})[0] || 'empty',\n        })),\n      });\n\n      throw new McpError(ErrorCode.InternalError, `Batch operation failed: expected ${expectedCount} operations, received ${actualCount} replies. This may indicate a partial failure or Google API issue.`);\n    }\n\n    // Validate each reply exists - Google Sheets API may return empty objects for successful operations\n    for (let i = 0; i < replies.length; i++) {\n      const reply = replies[i];\n      const request = sortedRequests[i];\n\n      if (!request) {\n        logger.error?.('Dimensions batch update failed - missing request', {\n          replyIndex: i,\n          hasReply: !!reply,\n          hasRequest: !!request,\n          spreadsheetId: id,\n          sheetTitle,\n        });\n        throw new McpError(ErrorCode.InternalError, `Operation ${i} failed: missing request data`);\n      }\n\n      // Note: Google Sheets API often returns empty objects {} for successful dimension operations\n      // This is normal behavior and indicates success, not failure\n      // We validate that the reply exists (even if empty) rather than checking specific keys\n      if (reply === null || reply === undefined) {\n        logger.error?.('Dimensions batch update failed - null reply', {\n          operationIndex: i,\n          expectedOperation: request.operation,\n          spreadsheetId: id,\n          sheetTitle,\n        });\n        throw new McpError(ErrorCode.InternalError, `Operation ${i} (${request.operation}) failed: null reply from Google Sheets API`);\n      }\n    }\n\n    // Calculate final dimensions and operation results\n    // Note: We calculate based on the operations we performed, but actual dimensions\n    // may vary slightly due to Google Sheets internal behavior (e.g., minimum dimensions)\n    let finalRowCount = currentRowCount;\n    let finalColumnCount = currentColumnCount;\n\n    const operationResults = sortedRequests.map((operation, _index) => {\n      const affectedCount = calculateAffectedCount(operation);\n\n      // Update dimension counts based on operation\n      // Operations are applied in sorted order, so this should match actual result\n      if (operation.dimension === 'ROWS') {\n        if (operation.operation === 'insertDimension') {\n          finalRowCount += affectedCount;\n        } else if (operation.operation === 'appendDimension') {\n          finalRowCount += affectedCount;\n        } else if (operation.operation === 'deleteDimension') {\n          finalRowCount = Math.max(1, finalRowCount - affectedCount); // Google Sheets minimum 1 row\n        }\n      } else if (operation.dimension === 'COLUMNS') {\n        if (operation.operation === 'insertDimension') {\n          finalColumnCount += affectedCount;\n        } else if (operation.operation === 'appendDimension') {\n          finalColumnCount += affectedCount;\n        } else if (operation.operation === 'deleteDimension') {\n          finalColumnCount = Math.max(1, finalColumnCount - affectedCount); // Google Sheets minimum 1 column\n        }\n      }\n\n      return {\n        operation: operation.operation,\n        dimension: operation.dimension,\n        startIndex: operation.startIndex,\n        endIndex: operation.endIndex,\n        affectedCount,\n      };\n    });\n\n    // Validate final dimensions are within Google Sheets limits\n    if (finalRowCount > MAX_ROW_COUNT) {\n      logger.warn?.('Final row count exceeds Google Sheets maximum', {\n        finalRowCount,\n        maxRowCount: MAX_ROW_COUNT,\n        spreadsheetId: id,\n        sheetTitle,\n      });\n    }\n    if (finalColumnCount > MAX_COLUMN_COUNT) {\n      logger.warn?.('Final column count exceeds Google Sheets maximum', {\n        finalColumnCount,\n        maxColumnCount: MAX_COLUMN_COUNT,\n        spreadsheetId: id,\n        sheetTitle,\n      });\n    }\n\n    logger.debug?.('sheets.dimensions.batchUpdate completed successfully', {\n      totalOperations: requests.length,\n      finalRowCount,\n      finalColumnCount,\n      operationResults: operationResults.length,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      spreadsheetTitle: spreadsheetTitle || '',\n      spreadsheetUrl: spreadsheetUrl || '',\n      sheetTitle,\n      sheetUrl,\n      totalOperations: requests.length,\n      operationResults,\n      updatedDimensions: {\n        rows: finalRowCount,\n        columns: finalColumnCount,\n      },\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.dimensions.batchUpdate error', { error: message });\n    throw new McpError(ErrorCode.InternalError, `Error batch updating dimensions: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'dimensions-batch-update',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","buildDimensionRequest","calculateAffectedCount","DEFAULT_COLUMN_COUNT","DEFAULT_ROW_COUNT","MAX_COLUMN_COUNT","MAX_ROW_COUNT","sortOperations","DimensionRequestSchema","object","operation","enum","describe","dimension","startIndex","number","int","nonnegative","endIndex","optional","inheritFromBefore","boolean","inputSchema","id","gid","requests","array","min","successBranchSchema","type","literal","spreadsheetTitle","string","spreadsheetUrl","sheetTitle","sheetUrl","totalOperations","operationResults","affectedCount","updatedDimensions","rows","columns","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","debug","requestCount","length","operations","map","r","spreadsheetData","sheet","sheets","version","auth","authContext","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","properties","title","find","s","String","sheetId","warn","InvalidParams","undefined","error","InternalError","currentRowCount","gridProperties","rowCount","currentColumnCount","columnCount","sortedRequests","batchRequests","operationTypes","operationDetails","i","index","currentDimensions","batchUpdateResponse","batchUpdate","requestBody","includeSpreadsheetInResponse","updateResult","replies","expectedCount","actualCount","expectedOperations","actualReplies","receivedReplies","reply","replyType","Object","keys","request","replyIndex","hasReply","hasRequest","operationIndex","expectedOperation","finalRowCount","finalColumnCount","_index","Math","max","maxRowCount","maxColumnCount","content","text","JSON","stringify","structuredContent","message","Error","stack","createTool","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/dimensions-batch-update.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { buildDimensionRequest, calculateAffectedCount, DEFAULT_COLUMN_COUNT, DEFAULT_ROW_COUNT, type DimensionRequest, MAX_COLUMN_COUNT, MAX_ROW_COUNT, sortOperations } from './lib/dimension-operations.ts';\n\n// Input schema for dimension batch update requests\nconst DimensionRequestSchema = z.object({\n  operation: z.enum(['insertDimension', 'deleteDimension', 'appendDimension']).describe('Type of dimension operation to perform'),\n  dimension: z.enum(['ROWS', 'COLUMNS']).describe('Whether to operate on rows or columns'),\n  startIndex: z.number().int().nonnegative().describe('Starting index for the operation (0-based)'),\n  endIndex: z.number().int().nonnegative().optional().describe('Ending index for the operation (0-based, exclusive). Optional - if omitted, the range is unbounded (extends to the end of the sheet)'),\n  inheritFromBefore: z.boolean().optional().describe('For insertDimension: whether new rows/columns inherit properties from the row/column before the insertion point'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  requests: z.array(DimensionRequestSchema).min(1).describe('Array of dimension update requests'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  spreadsheetTitle: z.string().describe('Title of the updated spreadsheet'),\n  spreadsheetUrl: z.string().describe('URL of the updated spreadsheet'),\n  sheetTitle: z.string().describe('Title of the updated sheet'),\n  sheetUrl: z.string().describe('URL of the updated sheet'),\n  totalOperations: z.number().int().nonnegative().describe('Total number of dimension operations performed'),\n  operationResults: z\n    .array(\n      z.object({\n        operation: z.enum(['insertDimension', 'deleteDimension', 'appendDimension']).describe('Type of operation that was performed'),\n        dimension: z.enum(['ROWS', 'COLUMNS']).describe('Dimension that was operated on'),\n        startIndex: z.number().int().nonnegative().describe('Starting index of the operation'),\n        endIndex: z.number().int().nonnegative().optional().describe('Ending index of the operation (for insert/delete)'),\n        affectedCount: z.number().int().nonnegative().describe('Number of rows/columns affected by this operation'),\n      })\n    )\n    .describe('Detailed results for each dimension operation'),\n  updatedDimensions: z\n    .object({\n      rows: z.number().int().nonnegative().describe('Total number of rows in the sheet after all operations'),\n      columns: z.number().int().nonnegative().describe('Total number of columns in the sheet after all operations'),\n    })\n    .describe('Final dimensions of the sheet after all operations'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Batch update sheet dimensions by inserting, deleting, or appending rows/columns. Operations are atomic (all succeed or all fail) and execute in optimal order automatically.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.debug?.('sheets.dimensions.batchUpdate called', {\n    id,\n    gid,\n    requestCount: requests.length,\n    operations: requests.map((r) => ({ operation: r.operation, dimension: r.dimension, startIndex: r.startIndex, endIndex: r.endIndex })),\n  });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title,sheets.properties.gridProperties',\n    });\n\n    const spreadsheetData = spreadsheetResponse.data;\n    const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n    const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n    // Find sheet by gid\n    const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.warn?.('Sheet not found for dimensions batch update', { id, gid, requestCount: requests.length });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    const sheetId = sheet.properties.sheetId;\n\n    if (sheetId === undefined || sheetId === null) {\n      logger.error?.('Sheet ID not available for dimensions batch update', { id, gid, sheetTitle });\n      throw new ProtocolError(ProtocolErrorCode.InternalError, `Sheet ID not available for ${gid}. Cannot perform dimension operations without valid sheet ID.`);\n    }\n\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n    // Get current sheet dimensions for response calculation\n    // Note: Google Sheets API may not always provide gridProperties for older sheets\n    // Fall back to Google's documented defaults for new sheets\n    const currentRowCount = sheet.properties.gridProperties?.rowCount ?? DEFAULT_ROW_COUNT;\n    const currentColumnCount = sheet.properties.gridProperties?.columnCount ?? DEFAULT_COLUMN_COUNT;\n\n    // Sort operations for optimal execution order to prevent index conflicts\n    // Delete operations are processed first (high to low index) to avoid shifting issues\n    // Insert/append operations are processed after (low to high index)\n    const sortedRequests = sortOperations(requests as DimensionRequest[]);\n\n    // Build Google Sheets API batch update requests\n    const batchRequests = sortedRequests.map((operation) => buildDimensionRequest(operation, sheetId));\n\n    logger.debug?.('sheets.dimensions.batchUpdate executing batch request', {\n      spreadsheetId: id,\n      sheetTitle,\n      sheetId,\n      totalOperations: batchRequests.length,\n      operationTypes: sortedRequests.map((r) => r.operation),\n      operationDetails: sortedRequests.map((r, i) => ({\n        index: i,\n        operation: r.operation,\n        dimension: r.dimension,\n        startIndex: r.startIndex,\n        endIndex: r.endIndex,\n        affectedCount: calculateAffectedCount(r),\n      })),\n      currentDimensions: { rows: currentRowCount, columns: currentColumnCount },\n    });\n\n    // Execute the atomic batch update\n    const batchUpdateResponse = await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: batchRequests,\n        includeSpreadsheetInResponse: false, // We don't need the full spreadsheet data back\n      },\n    });\n\n    const updateResult = batchUpdateResponse.data;\n\n    // Comprehensive validation of batch update results\n    if (!updateResult) {\n      logger.error?.('Dimensions batch update failed - no response data', {\n        spreadsheetId: id,\n        sheetTitle,\n        requestCount: requests.length,\n      });\n      throw new ProtocolError(ProtocolErrorCode.InternalError, 'Batch update failed: no response data received from Google Sheets API');\n    }\n\n    const replies = updateResult.replies || [];\n    const expectedCount = requests.length;\n    const actualCount = replies.length;\n\n    // Validate operation count matches expectations\n    if (actualCount !== expectedCount) {\n      logger.error?.('Dimensions batch update failed - operation count mismatch', {\n        expectedOperations: expectedCount,\n        actualReplies: actualCount,\n        spreadsheetId: id,\n        sheetTitle,\n        receivedReplies: replies.map((reply, index) => ({\n          index,\n          replyType: Object.keys(reply || {})[0] || 'empty',\n        })),\n      });\n\n      throw new ProtocolError(ProtocolErrorCode.InternalError, `Batch operation failed: expected ${expectedCount} operations, received ${actualCount} replies. This may indicate a partial failure or Google API issue.`);\n    }\n\n    // Validate each reply exists - Google Sheets API may return empty objects for successful operations\n    for (let i = 0; i < replies.length; i++) {\n      const reply = replies[i];\n      const request = sortedRequests[i];\n\n      if (!request) {\n        logger.error?.('Dimensions batch update failed - missing request', {\n          replyIndex: i,\n          hasReply: !!reply,\n          hasRequest: !!request,\n          spreadsheetId: id,\n          sheetTitle,\n        });\n        throw new ProtocolError(ProtocolErrorCode.InternalError, `Operation ${i} failed: missing request data`);\n      }\n\n      // Note: Google Sheets API often returns empty objects {} for successful dimension operations\n      // This is normal behavior and indicates success, not failure\n      // We validate that the reply exists (even if empty) rather than checking specific keys\n      if (reply === null || reply === undefined) {\n        logger.error?.('Dimensions batch update failed - null reply', {\n          operationIndex: i,\n          expectedOperation: request.operation,\n          spreadsheetId: id,\n          sheetTitle,\n        });\n        throw new ProtocolError(ProtocolErrorCode.InternalError, `Operation ${i} (${request.operation}) failed: null reply from Google Sheets API`);\n      }\n    }\n\n    // Calculate final dimensions and operation results\n    // Note: We calculate based on the operations we performed, but actual dimensions\n    // may vary slightly due to Google Sheets internal behavior (e.g., minimum dimensions)\n    let finalRowCount = currentRowCount;\n    let finalColumnCount = currentColumnCount;\n\n    const operationResults = sortedRequests.map((operation, _index) => {\n      const affectedCount = calculateAffectedCount(operation);\n\n      // Update dimension counts based on operation\n      // Operations are applied in sorted order, so this should match actual result\n      if (operation.dimension === 'ROWS') {\n        if (operation.operation === 'insertDimension') {\n          finalRowCount += affectedCount;\n        } else if (operation.operation === 'appendDimension') {\n          finalRowCount += affectedCount;\n        } else if (operation.operation === 'deleteDimension') {\n          finalRowCount = Math.max(1, finalRowCount - affectedCount); // Google Sheets minimum 1 row\n        }\n      } else if (operation.dimension === 'COLUMNS') {\n        if (operation.operation === 'insertDimension') {\n          finalColumnCount += affectedCount;\n        } else if (operation.operation === 'appendDimension') {\n          finalColumnCount += affectedCount;\n        } else if (operation.operation === 'deleteDimension') {\n          finalColumnCount = Math.max(1, finalColumnCount - affectedCount); // Google Sheets minimum 1 column\n        }\n      }\n\n      return {\n        operation: operation.operation,\n        dimension: operation.dimension,\n        startIndex: operation.startIndex,\n        endIndex: operation.endIndex,\n        affectedCount,\n      };\n    });\n\n    // Validate final dimensions are within Google Sheets limits\n    if (finalRowCount > MAX_ROW_COUNT) {\n      logger.warn?.('Final row count exceeds Google Sheets maximum', {\n        finalRowCount,\n        maxRowCount: MAX_ROW_COUNT,\n        spreadsheetId: id,\n        sheetTitle,\n      });\n    }\n    if (finalColumnCount > MAX_COLUMN_COUNT) {\n      logger.warn?.('Final column count exceeds Google Sheets maximum', {\n        finalColumnCount,\n        maxColumnCount: MAX_COLUMN_COUNT,\n        spreadsheetId: id,\n        sheetTitle,\n      });\n    }\n\n    logger.debug?.('sheets.dimensions.batchUpdate completed successfully', {\n      totalOperations: requests.length,\n      finalRowCount,\n      finalColumnCount,\n      operationResults: operationResults.length,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      spreadsheetTitle: spreadsheetTitle || '',\n      spreadsheetUrl: spreadsheetUrl || '',\n      sheetTitle,\n      sheetUrl,\n      totalOperations: requests.length,\n      operationResults,\n      updatedDimensions: {\n        rows: finalRowCount,\n        columns: finalColumnCount,\n      },\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.dimensions.batchUpdate error', { error: message });\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error batch updating dimensions: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'dimensions-batch-update',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","buildDimensionRequest","calculateAffectedCount","DEFAULT_COLUMN_COUNT","DEFAULT_ROW_COUNT","MAX_COLUMN_COUNT","MAX_ROW_COUNT","sortOperations","DimensionRequestSchema","object","operation","enum","describe","dimension","startIndex","number","int","nonnegative","endIndex","optional","inheritFromBefore","boolean","inputSchema","id","gid","requests","array","min","successBranchSchema","type","literal","spreadsheetTitle","string","spreadsheetUrl","sheetTitle","sheetUrl","totalOperations","operationResults","affectedCount","updatedDimensions","rows","columns","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","debug","requestCount","length","operations","map","r","spreadsheetData","sheet","sheets","version","auth","authContext","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","properties","title","find","s","String","sheetId","warn","InvalidParams","undefined","error","InternalError","currentRowCount","gridProperties","rowCount","currentColumnCount","columnCount","sortedRequests","batchRequests","operationTypes","operationDetails","i","index","currentDimensions","batchUpdateResponse","batchUpdate","requestBody","includeSpreadsheetInResponse","updateResult","replies","expectedCount","actualCount","expectedOperations","actualReplies","receivedReplies","reply","replyType","Object","keys","request","replyIndex","hasReply","hasRequest","operationIndex","expectedOperation","finalRowCount","finalColumnCount","_index","Math","max","maxRowCount","maxColumnCount","content","text","JSON","stringify","structuredContent","message","Error","stack","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/dimensions-move.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/dimensions-move.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';
@@ -57,11 +57,11 @@ async function handler({ id, gid, dimension, startIndex, endIndex, destinationIn
     });
     // Validate indices
     if (startIndex >= endIndex) {
-        throw new McpError(ErrorCode.InvalidParams, `startIndex (${startIndex}) must be less than endIndex (${endIndex})`);
+        throw new ProtocolError(ProtocolErrorCode.InvalidParams, `startIndex (${startIndex}) must be less than endIndex (${endIndex})`);
     }
     // Check if destination is within source range (invalid move)
     if (destinationIndex > startIndex && destinationIndex < endIndex) {
-        throw new McpError(ErrorCode.InvalidParams, `destinationIndex (${destinationIndex}) cannot be within the source range (${startIndex}-${endIndex})`);
+        throw new ProtocolError(ProtocolErrorCode.InvalidParams, `destinationIndex (${destinationIndex}) cannot be within the source range (${startIndex}-${endIndex})`);
     }
     try {
         var _ref, _spreadsheetData_spreadsheetUrl, _sheet_properties_title, _sheet_properties_sheetId;
@@ -89,7 +89,7 @@ async function handler({ id, gid, dimension, startIndex, endIndex, destinationIn
                 gid,
                 dimension
             });
-            throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);
         }
         const sheetTitle = (_sheet_properties_title = sheet.properties.title) !== null && _sheet_properties_title !== void 0 ? _sheet_properties_title : gid;
         const sheetGid = (_sheet_properties_sheetId = sheet.properties.sheetId) !== null && _sheet_properties_sheetId !== void 0 ? _sheet_properties_sheetId : 0;
@@ -156,7 +156,7 @@ async function handler({ id, gid, dimension, startIndex, endIndex, destinationIn
             }
         };
     } catch (error) {
-        if (error instanceof McpError) {
+        if (error instanceof ProtocolError) {
             throw error;
         }
         const message = error instanceof Error ? error.message : String(error);
@@ -169,7 +169,7 @@ async function handler({ id, gid, dimension, startIndex, endIndex, destinationIn
             destinationIndex,
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error moving ${dimension.toLowerCase()}: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error moving ${dimension.toLowerCase()}: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

package/dist/esm/mcp/tools/dimensions-move.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/dimensions-move.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 inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  dimension: z.enum(['ROWS', 'COLUMNS']).describe('Whether to move rows or columns'),\n  startIndex: z.number().int().nonnegative().describe('Starting index of the range to move (0-based)'),\n  endIndex: z.number().int().positive().describe('Ending index of the range to move (0-based, exclusive)'),\n  destinationIndex: z.number().int().nonnegative().describe('Index where the rows/columns will be moved to (0-based)'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  spreadsheetTitle: z.string().describe('Title of the spreadsheet'),\n  spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n  sheetTitle: z.string().describe('Title of the sheet'),\n  sheetUrl: z.string().describe('URL of the sheet'),\n  dimension: z.enum(['ROWS', 'COLUMNS']).describe('Dimension that was moved'),\n  sourceRange: z.object({\n    startIndex: z.number().describe('Starting index of the moved range'),\n    endIndex: z.number().describe('Ending index of the moved range'),\n  }),\n  destinationIndex: z.number().describe('Index where the range was moved to'),\n  movedCount: z.number().describe('Number of rows/columns moved'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Move rows or columns within a sheet to a new position. Use 0-based indices. The destinationIndex is where the rows/columns will be moved TO.',\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, dimension, startIndex, endIndex, destinationIndex }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.dimensions.move called', { id, gid, dimension, startIndex, endIndex, destinationIndex });\n\n  // Validate indices\n  if (startIndex >= endIndex) {\n    throw new McpError(ErrorCode.InvalidParams, `startIndex (${startIndex}) must be less than endIndex (${endIndex})`);\n  }\n\n  // Check if destination is within source range (invalid move)\n  if (destinationIndex > startIndex && destinationIndex < endIndex) {\n    throw new McpError(ErrorCode.InvalidParams, `destinationIndex (${destinationIndex}) cannot be within the source range (${startIndex}-${endIndex})`);\n  }\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const spreadsheetData = spreadsheetResponse.data;\n    const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n    const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n    // Find sheet by gid\n    const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for move', { id, gid, dimension });\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    const sheetGid = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n    logger.info('sheets.dimensions.move executing', { spreadsheetId: id, sheetTitle, dimension, startIndex, endIndex, destinationIndex });\n\n    // Execute the move dimension request\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [\n          {\n            moveDimension: {\n              source: {\n                sheetId: sheetGid,\n                dimension,\n                startIndex,\n                endIndex,\n              },\n              destinationIndex,\n            },\n          },\n        ],\n      },\n    });\n\n    const movedCount = endIndex - startIndex;\n\n    logger.info('sheets.dimensions.move completed successfully', {\n      spreadsheetId: id,\n      sheetTitle,\n      dimension,\n      movedCount,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetGid),\n      spreadsheetTitle: spreadsheetTitle || '',\n      spreadsheetUrl: spreadsheetUrl || '',\n      sheetTitle,\n      sheetUrl,\n      dimension,\n      sourceRange: {\n        startIndex,\n        endIndex,\n      },\n      destinationIndex,\n      movedCount,\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('Move operation failed', { id, gid, dimension, startIndex, endIndex, destinationIndex, error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error moving ${dimension.toLowerCase()}: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'dimensions-move',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","inputSchema","object","id","gid","dimension","enum","describe","startIndex","number","int","nonnegative","endIndex","positive","destinationIndex","successBranchSchema","type","literal","spreadsheetTitle","string","spreadsheetUrl","sheetTitle","sheetUrl","sourceRange","movedCount","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","InvalidParams","spreadsheetData","sheet","sheets","version","auth","authContext","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","properties","title","find","s","String","sheetId","sheetGid","batchUpdate","requestBody","requests","moveDimension","source","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","toLowerCase","stack","undefined","createTool","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/dimensions-move.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 inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  dimension: z.enum(['ROWS', 'COLUMNS']).describe('Whether to move rows or columns'),\n  startIndex: z.number().int().nonnegative().describe('Starting index of the range to move (0-based)'),\n  endIndex: z.number().int().positive().describe('Ending index of the range to move (0-based, exclusive)'),\n  destinationIndex: z.number().int().nonnegative().describe('Index where the rows/columns will be moved to (0-based)'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  spreadsheetTitle: z.string().describe('Title of the spreadsheet'),\n  spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n  sheetTitle: z.string().describe('Title of the sheet'),\n  sheetUrl: z.string().describe('URL of the sheet'),\n  dimension: z.enum(['ROWS', 'COLUMNS']).describe('Dimension that was moved'),\n  sourceRange: z.object({\n    startIndex: z.number().describe('Starting index of the moved range'),\n    endIndex: z.number().describe('Ending index of the moved range'),\n  }),\n  destinationIndex: z.number().describe('Index where the range was moved to'),\n  movedCount: z.number().describe('Number of rows/columns moved'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Move rows or columns within a sheet to a new position. Use 0-based indices. The destinationIndex is where the rows/columns will be moved TO.',\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, dimension, startIndex, endIndex, destinationIndex }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.dimensions.move called', { id, gid, dimension, startIndex, endIndex, destinationIndex });\n\n  // Validate indices\n  if (startIndex >= endIndex) {\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, `startIndex (${startIndex}) must be less than endIndex (${endIndex})`);\n  }\n\n  // Check if destination is within source range (invalid move)\n  if (destinationIndex > startIndex && destinationIndex < endIndex) {\n    throw new ProtocolError(ProtocolErrorCode.InvalidParams, `destinationIndex (${destinationIndex}) cannot be within the source range (${startIndex}-${endIndex})`);\n  }\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const spreadsheetData = spreadsheetResponse.data;\n    const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n    const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n    // Find sheet by gid\n    const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for move', { id, gid, dimension });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    const sheetGid = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n    logger.info('sheets.dimensions.move executing', { spreadsheetId: id, sheetTitle, dimension, startIndex, endIndex, destinationIndex });\n\n    // Execute the move dimension request\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [\n          {\n            moveDimension: {\n              source: {\n                sheetId: sheetGid,\n                dimension,\n                startIndex,\n                endIndex,\n              },\n              destinationIndex,\n            },\n          },\n        ],\n      },\n    });\n\n    const movedCount = endIndex - startIndex;\n\n    logger.info('sheets.dimensions.move completed successfully', {\n      spreadsheetId: id,\n      sheetTitle,\n      dimension,\n      movedCount,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetGid),\n      spreadsheetTitle: spreadsheetTitle || '',\n      spreadsheetUrl: spreadsheetUrl || '',\n      sheetTitle,\n      sheetUrl,\n      dimension,\n      sourceRange: {\n        startIndex,\n        endIndex,\n      },\n      destinationIndex,\n      movedCount,\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('Move operation failed', { id, gid, dimension, startIndex, endIndex, destinationIndex, error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error moving ${dimension.toLowerCase()}: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'dimensions-move',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","inputSchema","object","id","gid","dimension","enum","describe","startIndex","number","int","nonnegative","endIndex","positive","destinationIndex","successBranchSchema","type","literal","spreadsheetTitle","string","spreadsheetUrl","sheetTitle","sheetUrl","sourceRange","movedCount","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","InvalidParams","spreadsheetData","sheet","sheets","version","auth","authContext","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","properties","title","find","s","String","sheetId","sheetGid","batchUpdate","requestBody","requests","moveDimension","source","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","toLowerCase","stack","undefined","createTool","name"],"mappings":"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"}

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