@mcp-z/mcp-sheets 1.2.3 → 1.3.0

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

@@ -1,8 +1,9 @@
+import { sheets as sheetsApi } from '@googleapis/sheets';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { google } from 'googleapis';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { z } from 'zod';
+import { googleAuth } from '../../lib/google-auth.js';
 import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
 import { buildDimensionRequest, calculateAffectedCount, DEFAULT_COLUMN_COUNT, DEFAULT_ROW_COUNT, MAX_COLUMN_COUNT, MAX_ROW_COUNT, sortOperations } from './lib/dimension-operations.js';
 // Input schema for dimension batch update requests
@@ -82,9 +83,9 @@ async function handler({ id, gid, requests }, extra) {
     try {
         var _ref, _spreadsheetData_spreadsheetUrl, _sheet_properties_title, _ref1, _ref2;
         var _spreadsheetData_properties, _spreadsheetData_sheets, _sheet_properties_gridProperties, _sheet_properties_gridProperties1, _logger_debug1, _logger_debug2;
-        const sheets = google.sheets({
+        const sheets = sheetsApi({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         // Get spreadsheet and sheet info in single API call
         const spreadsheetResponse = await sheets.spreadsheets.get({
@@ -106,7 +107,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 +118,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 +168,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 +186,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 +201,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 +214,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 +308,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 { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { 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 = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title,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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","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","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,8 +1,9 @@
+import { sheets as sheetsApi } from '@googleapis/sheets';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { google } from 'googleapis';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { z } from 'zod';
+import { googleAuth } from '../../lib/google-auth.js';
 import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
 const inputSchema = z.object({
     id: SpreadsheetIdSchema,
@@ -57,18 +58,18 @@ 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;
         var _spreadsheetData_properties, _spreadsheetData_sheets;
-        const sheets = google.sheets({
+        const sheets = sheetsApi({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         // Get spreadsheet and sheet info in single API call
         const spreadsheetResponse = await sheets.spreadsheets.get({
@@ -89,7 +90,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 +157,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 +170,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 { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\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 = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const spreadsheetData = spreadsheetResponse.data;\n    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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","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","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;

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

@@ -1,8 +1,9 @@
+import { sheets as sheetsApi } from '@googleapis/sheets';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { google } from 'googleapis';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { z } from 'zod';
+import { googleAuth } from '../../lib/google-auth.js';
 import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
 import { appendRows, mapRowsToHeader } from '../../spreadsheet/data-operations.js';
 import { ensureTabAndHeaders } from '../../spreadsheet/sheet-operations.js';
@@ -50,9 +51,9 @@ async function handler({ id, gid, rows, headers, deduplicateBy }, extra) {
     try {
         var _ref;
         var _spreadsheetResponse_data_sheets, _sheet_properties;
-        const sheets = google.sheets({
+        const sheets = sheetsApi({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         // Get sheet details using the gid
         const spreadsheetResponse = await sheets.spreadsheets.get({
@@ -64,7 +65,7 @@ async function handler({ id, gid, rows, headers, deduplicateBy }, extra) {
             return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === gid;
         });
         if (!sheet) {
-            throw new McpError(ErrorCode.InvalidParams, 'Sheet not found');
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');
         }
         const sheetTitle = (_ref = sheet === null || sheet === void 0 ? void 0 : (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) !== null && _ref !== void 0 ? _ref : '';
         // Smart header handling and data processing
@@ -137,7 +138,7 @@ async function handler({ id, gid, rows, headers, deduplicateBy }, extra) {
         logger.error('sheets.rows.append error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error appending rows: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error appending rows: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

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

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

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

@@ -1,6 +1,6 @@
 /** Import CSV data to Google Sheets with database-style row append and deduplication */
 import type { EnrichedExtra } from '@mcp-z/oauth-google';
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CallToolResult } from '@mcp-z/server';
 import { z } from 'zod';
 declare const inputSchema: z.ZodObject<{
     id: z.ZodString;

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

@@ -1,9 +1,10 @@
-/** Import CSV data to Google Sheets with database-style row append and deduplication */ import { schemas } from '@mcp-z/oauth-google';
+/** Import CSV data to Google Sheets with database-style row append and deduplication */ import { sheets as sheetsApi } from '@googleapis/sheets';
+import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { parse } from 'csv-parse';
-import { google } from 'googleapis';
 import { z } from 'zod';
+import { googleAuth } from '../../lib/google-auth.js';
 import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
 import { getCsvReadStream } from '../../spreadsheet/csv-streaming.js';
 import { buildDeduplicationKey } from '../../spreadsheet/deduplication-utils.js';
@@ -89,29 +90,29 @@ async function handler({ id, gid, sourceUri, sourceHasHeaders, headerMap, dedupl
         var _ref;
         var _spreadsheetResponse_data_sheets, _sheet_properties;
         if (headerMap.length === 0) {
-            throw new McpError(ErrorCode.InvalidParams, 'headerMap cannot be empty');
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'headerMap cannot be empty');
         }
         // Validate: if sourceHasHeaders=false, all references must be numeric
         if (!sourceHasHeaders) {
             for (const { source, target } of headerMap){
                 if (typeof source === 'string') {
-                    throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string source: "${source}"`);
+                    throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string source: "${source}"`);
                 }
                 if (typeof target === 'string') {
-                    throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string target: "${target}"`);
+                    throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string target: "${target}"`);
                 }
             }
             if (deduplicateBy) {
                 for (const colRef of deduplicateBy){
                     if (typeof colRef === 'string') {
-                        throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices in deduplicateBy. Got string: "${colRef}"`);
+                        throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices in deduplicateBy. Got string: "${colRef}"`);
                     }
                 }
             }
         }
-        const sheets = google.sheets({
+        const sheets = sheetsApi({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         // Get sheet details using the gid
         const spreadsheetResponse = await sheets.spreadsheets.get({
@@ -123,7 +124,7 @@ async function handler({ id, gid, sourceUri, sourceHasHeaders, headerMap, dedupl
             return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === gid;
         });
         if (!sheet) {
-            throw new McpError(ErrorCode.InvalidParams, 'Sheet not found');
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');
         }
         const sheetTitle = (_ref = sheet === null || sheet === void 0 ? void 0 : (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) !== null && _ref !== void 0 ? _ref : '';
         // Determine target headers (for sourceHasHeaders=true) or column count (for sourceHasHeaders=false)
@@ -328,7 +329,7 @@ async function handler({ id, gid, sourceUri, sourceHasHeaders, headerMap, dedupl
         logger.error('sheets.rows.csv-append error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error appending CSV rows: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error appending CSV rows: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }