@mcp-z/mcp-sheets 1.2.3 → 2.0.0

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/sheet-delete.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst MAX_BATCH_SIZE = 1000;\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gids: z.array(SheetGidSchema).min(1).max(MAX_BATCH_SIZE).describe('Sheet grid IDs to permanently delete'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Human-readable summary of the operation'),\n  itemsProcessed: z.number().describe('Total sheets attempted to delete'),\n  itemsChanged: z.number().describe('Number of sheets successfully deleted'),\n  completedAt: z.string().describe('ISO timestamp when operation completed'),\n  recoverable: z.literal(false).describe('Whether deletion can be undone (always false)'),\n  id: SpreadsheetIdOutput,\n  spreadsheetUrl: z.string().optional().describe('URL to view the spreadsheet'),\n  failures: z\n    .array(\n      z.object({\n        gid: z.string().describe('Grid ID of sheet that failed to delete'),\n        error: z.string().describe('Error message explaining the failure'),\n      })\n    )\n    .optional()\n    .describe('Details of any sheets that failed to delete'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Permanently delete sheets from a spreadsheet. Cannot delete the last remaining sheet.',\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, gids }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.delete called', { id, count: gids.length });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    const results = await Promise.allSettled(\n      gids.map(async (gid) => {\n        await sheets.spreadsheets.batchUpdate({\n          spreadsheetId: id,\n          requestBody: {\n            requests: [{ deleteSheet: { sheetId: Number(gid) } }],\n          },\n        });\n        return gid;\n      })\n    );\n\n    // Separate successes and failures\n    const failures: Array<{ gid: string; error: string }> = [];\n\n    results.forEach((result, index) => {\n      const gid = gids[index];\n      if (!gid) return;\n\n      if (result.status === 'rejected') {\n        const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);\n        failures.push({ gid, error: errorMessage });\n      }\n    });\n\n    const successCount = gids.length - failures.length;\n    const failureCount = failures.length;\n    const totalCount = gids.length;\n\n    const summary = failureCount === 0 ? `Permanently deleted ${successCount} sheet${successCount === 1 ? '' : 's'}` : `Deleted ${successCount} of ${totalCount} sheet${totalCount === 1 ? '' : 's'} (${failureCount} failed)`;\n\n    logger.info('sheets.sheet.delete completed', {\n      totalCount,\n      successCount,\n      failureCount,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: summary,\n      itemsProcessed: totalCount,\n      itemsChanged: successCount,\n      completedAt: new Date().toISOString(),\n      recoverable: false as const,\n      id,\n      spreadsheetUrl: `https://docs.google.com/spreadsheets/d/${id}`,\n      ...(failures.length > 0 && { failures }),\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.sheet.delete error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error deleting sheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-delete',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","MAX_BATCH_SIZE","inputSchema","object","id","gids","array","min","max","describe","successBranchSchema","type","literal","operationSummary","string","itemsProcessed","number","itemsChanged","completedAt","recoverable","spreadsheetUrl","optional","failures","gid","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","count","length","sheets","version","auth","authContext","results","Promise","allSettled","map","spreadsheets","batchUpdate","spreadsheetId","requestBody","requests","deleteSheet","sheetId","Number","forEach","index","status","errorMessage","reason","Error","message","String","push","successCount","failureCount","totalCount","summary","Date","toISOString","content","text","JSON","stringify","structuredContent","InternalError","stack","undefined","createTool","name"],"mappings":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAIrC,SAASE,SAAS,EAAEC,QAAQ,QAAQ,qCAAqC;AACzE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,cAAc,EAAEC,mBAAmB,EAAEC,mBAAmB,QAAQ,yBAAyB;AAElG,MAAMC,iBAAiB;AAEvB,MAAMC,cAAcL,EAAEM,MAAM,CAAC;IAC3BC,IAAIJ;IACJK,MAAMR,EAAES,KAAK,CAACR,gBAAgBS,GAAG,CAAC,GAAGC,GAAG,CAACP,gBAAgBQ,QAAQ,CAAC;AACpE;AAEA,MAAMC,sBAAsBb,EAAEM,MAAM,CAAC;IACnCQ,MAAMd,EAAEe,OAAO,CAAC;IAChBC,kBAAkBhB,EAAEiB,MAAM,GAAGL,QAAQ,CAAC;IACtCM,gBAAgBlB,EAAEmB,MAAM,GAAGP,QAAQ,CAAC;IACpCQ,cAAcpB,EAAEmB,MAAM,GAAGP,QAAQ,CAAC;IAClCS,aAAarB,EAAEiB,MAAM,GAAGL,QAAQ,CAAC;IACjCU,aAAatB,EAAEe,OAAO,CAAC,OAAOH,QAAQ,CAAC;IACvCL,IAAIL;IACJqB,gBAAgBvB,EAAEiB,MAAM,GAAGO,QAAQ,GAAGZ,QAAQ,CAAC;IAC/Ca,UAAUzB,EACPS,KAAK,CACJT,EAAEM,MAAM,CAAC;QACPoB,KAAK1B,EAAEiB,MAAM,GAAGL,QAAQ,CAAC;QACzBe,OAAO3B,EAAEiB,MAAM,GAAGL,QAAQ,CAAC;IAC7B,IAEDY,QAAQ,GACRZ,QAAQ,CAAC;AACd;AAEA,MAAMgB,eAAe5B,EAAE6B,kBAAkB,CAAC,QAAQ;IAAChB;IAAqBjB;CAAyB;AAEjG,MAAMkC,SAAS;IACbC,aAAa;IACb1B;IACAuB,cAAc5B,EAAEM,MAAM,CAAC;QACrB0B,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAE1B,EAAE,EAAEC,IAAI,EAAS,EAAE0B,KAAoB;IAC9D,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,8BAA8B;QAAE7B;QAAI8B,OAAO7B,KAAK8B,MAAM;IAAC;IAEnE,IAAI;QACF,MAAMC,SAASxC,OAAOwC,MAAM,CAAC;YAAEC,SAAS;YAAMC,MAAMP,MAAMQ,WAAW,CAACD,IAAI;QAAC;QAE3E,MAAME,UAAU,MAAMC,QAAQC,UAAU,CACtCrC,KAAKsC,GAAG,CAAC,OAAOpB;YACd,MAAMa,OAAOQ,YAAY,CAACC,WAAW,CAAC;gBACpCC,eAAe1C;gBACf2C,aAAa;oBACXC,UAAU;wBAAC;4BAAEC,aAAa;gCAAEC,SAASC,OAAO5B;4BAAK;wBAAE;qBAAE;gBACvD;YACF;YACA,OAAOA;QACT;QAGF,kCAAkC;QAClC,MAAMD,WAAkD,EAAE;QAE1DkB,QAAQY,OAAO,CAAC,CAACvB,QAAQwB;YACvB,MAAM9B,MAAMlB,IAAI,CAACgD,MAAM;YACvB,IAAI,CAAC9B,KAAK;YAEV,IAAIM,OAAOyB,MAAM,KAAK,YAAY;gBAChC,MAAMC,eAAe1B,OAAO2B,MAAM,YAAYC,QAAQ5B,OAAO2B,MAAM,CAACE,OAAO,GAAGC,OAAO9B,OAAO2B,MAAM;gBAClGlC,SAASsC,IAAI,CAAC;oBAAErC;oBAAKC,OAAO+B;gBAAa;YAC3C;QACF;QAEA,MAAMM,eAAexD,KAAK8B,MAAM,GAAGb,SAASa,MAAM;QAClD,MAAM2B,eAAexC,SAASa,MAAM;QACpC,MAAM4B,aAAa1D,KAAK8B,MAAM;QAE9B,MAAM6B,UAAUF,iBAAiB,IAAI,CAAC,oBAAoB,EAAED,aAAa,MAAM,EAAEA,iBAAiB,IAAI,KAAK,KAAK,GAAG,CAAC,QAAQ,EAAEA,aAAa,IAAI,EAAEE,WAAW,MAAM,EAAEA,eAAe,IAAI,KAAK,IAAI,EAAE,EAAED,aAAa,QAAQ,CAAC;QAE1N9B,OAAOC,IAAI,CAAC,iCAAiC;YAC3C8B;YACAF;YACAC;QACF;QAEA,MAAMjC,SAAiB;YACrBlB,MAAM;YACNE,kBAAkBmD;YAClBjD,gBAAgBgD;YAChB9C,cAAc4C;YACd3C,aAAa,IAAI+C,OAAOC,WAAW;YACnC/C,aAAa;YACbf;YACAgB,gBAAgB,CAAC,uCAAuC,EAAEhB,IAAI;YAC9D,GAAIkB,SAASa,MAAM,GAAG,KAAK;gBAAEb;YAAS,CAAC;QACzC;QAEA,OAAO;YACL6C,SAAS;gBAAC;oBAAExD,MAAM;oBAAiByD,MAAMC,KAAKC,SAAS,CAACzC;gBAAQ;aAAE;YAClE0C,mBAAmB;gBAAE1C;YAAO;QAC9B;IACF,EAAE,OAAOL,OAAO;QACd,MAAMkC,UAAUlC,iBAAiBiC,QAAQjC,MAAMkC,OAAO,GAAGC,OAAOnC;QAChEQ,OAAOR,KAAK,CAAC,6BAA6B;YAAEA,OAAOkC;QAAQ;QAE3D,MAAM,IAAI/D,SAASD,UAAU8E,aAAa,EAAE,CAAC,sBAAsB,EAAEd,SAAS,EAAE;YAC9Ee,OAAOjD,iBAAiBiC,QAAQjC,MAAMiD,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACNjD;QACAG;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/sheet-delete.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst MAX_BATCH_SIZE = 1000;\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gids: z.array(SheetGidSchema).min(1).max(MAX_BATCH_SIZE).describe('Sheet grid IDs to permanently delete'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Human-readable summary of the operation'),\n  itemsProcessed: z.number().describe('Total sheets attempted to delete'),\n  itemsChanged: z.number().describe('Number of sheets successfully deleted'),\n  completedAt: z.string().describe('ISO timestamp when operation completed'),\n  recoverable: z.literal(false).describe('Whether deletion can be undone (always false)'),\n  id: SpreadsheetIdOutput,\n  spreadsheetUrl: z.string().optional().describe('URL to view the spreadsheet'),\n  failures: z\n    .array(\n      z.object({\n        gid: z.string().describe('Grid ID of sheet that failed to delete'),\n        error: z.string().describe('Error message explaining the failure'),\n      })\n    )\n    .optional()\n    .describe('Details of any sheets that failed to delete'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Permanently delete sheets from a spreadsheet. Cannot delete the last remaining sheet.',\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, gids }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.delete called', { id, count: gids.length });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    const results = await Promise.allSettled(\n      gids.map(async (gid) => {\n        await sheets.spreadsheets.batchUpdate({\n          spreadsheetId: id,\n          requestBody: {\n            requests: [{ deleteSheet: { sheetId: Number(gid) } }],\n          },\n        });\n        return gid;\n      })\n    );\n\n    // Separate successes and failures\n    const failures: Array<{ gid: string; error: string }> = [];\n\n    results.forEach((result, index) => {\n      const gid = gids[index];\n      if (!gid) return;\n\n      if (result.status === 'rejected') {\n        const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);\n        failures.push({ gid, error: errorMessage });\n      }\n    });\n\n    const successCount = gids.length - failures.length;\n    const failureCount = failures.length;\n    const totalCount = gids.length;\n\n    const summary = failureCount === 0 ? `Permanently deleted ${successCount} sheet${successCount === 1 ? '' : 's'}` : `Deleted ${successCount} of ${totalCount} sheet${totalCount === 1 ? '' : 's'} (${failureCount} failed)`;\n\n    logger.info('sheets.sheet.delete completed', {\n      totalCount,\n      successCount,\n      failureCount,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: summary,\n      itemsProcessed: totalCount,\n      itemsChanged: successCount,\n      completedAt: new Date().toISOString(),\n      recoverable: false as const,\n      id,\n      spreadsheetUrl: `https://docs.google.com/spreadsheets/d/${id}`,\n      ...(failures.length > 0 && { failures }),\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.sheet.delete error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error deleting sheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-delete',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","MAX_BATCH_SIZE","inputSchema","object","id","gids","array","min","max","describe","successBranchSchema","type","literal","operationSummary","string","itemsProcessed","number","itemsChanged","completedAt","recoverable","spreadsheetUrl","optional","failures","gid","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","count","length","sheets","version","auth","authContext","results","Promise","allSettled","map","spreadsheets","batchUpdate","spreadsheetId","requestBody","requests","deleteSheet","sheetId","Number","forEach","index","status","errorMessage","reason","Error","message","String","push","successCount","failureCount","totalCount","summary","Date","toISOString","content","text","JSON","stringify","structuredContent","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

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

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

package/dist/esm/mcp/tools/sheet-find.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, SheetRefSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
@@ -43,7 +43,7 @@ async function handler({ id, sheetRef }, extra) {
         // Find sheet within the known spreadsheet
         const sheet = await findSheetByRef(sheets, id, sheetRef, logger);
         if (!sheet) {
-            throw new McpError(ErrorCode.InvalidParams, 'Sheet not found');
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');
         }
         const title = (_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 : String(sheetRef);
         const gid = (sheet === null || sheet === void 0 ? void 0 : (_sheet_properties1 = sheet.properties) === null || _sheet_properties1 === void 0 ? void 0 : _sheet_properties1.sheetId) != null ? String(sheet.properties.sheetId) : '';
@@ -76,7 +76,7 @@ async function handler({ id, sheetRef }, extra) {
         logger.error('sheets.sheet.find error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error finding sheet: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error finding sheet: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/sheet-find.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, SheetRefSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { findSheetByRef } from '../../spreadsheet/sheet-operations.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  sheetRef: SheetRefSchema,\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  title: z.string().describe('Sheet tab name'),\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: 'Find an existing sheet/tab within a known spreadsheet by title or GUID',\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, sheetRef }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.find called', { id, sheetRef });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Find sheet within the known spreadsheet\n    const sheet = await findSheetByRef(sheets, id, sheetRef, logger);\n    if (!sheet) {\n      throw new McpError(ErrorCode.InvalidParams, 'Sheet not found');\n    }\n\n    const title = sheet?.properties?.title ?? String(sheetRef);\n    const gid = sheet?.properties?.sheetId != null ? String(sheet.properties.sheetId) : '';\n    const sheetUrl = gid ? `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}` : `https://docs.google.com/spreadsheets/d/${id}`;\n\n    logger.info('sheets.sheet.find success', { id, gid, title });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid,\n      title,\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.sheet.find error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error finding sheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-find',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetRefSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","findSheetByRef","inputSchema","object","id","sheetRef","successBranchSchema","type","literal","gid","title","string","describe","sheetUrl","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","sheet","sheets","version","auth","authContext","InvalidParams","properties","String","sheetId","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAIrC,SAASE,SAAS,EAAEC,QAAQ,QAAQ,qCAAqC;AACzE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,cAAc,EAAEC,cAAc,EAAEC,mBAAmB,EAAEC,mBAAmB,QAAQ,yBAAyB;AAClH,SAASC,cAAc,QAAQ,wCAAwC;AAEvE,MAAMC,cAAcN,EAAEO,MAAM,CAAC;IAC3BC,IAAIJ;IACJK,UAAUP;AACZ;AAEA,MAAMQ,sBAAsBV,EAAEO,MAAM,CAAC;IACnCI,MAAMX,EAAEY,OAAO,CAAC;IAChBJ,IAAIL;IACJU,KAAKZ;IACLa,OAAOd,EAAEe,MAAM,GAAGC,QAAQ,CAAC;IAC3BC,UAAUjB,EAAEe,MAAM,GAAGG,QAAQ,GAAGF,QAAQ,CAAC;AAC3C;AAEA,MAAMG,eAAenB,EAAEoB,kBAAkB,CAAC,QAAQ;IAACV;IAAqBd;CAAyB;AAEjG,MAAMyB,SAAS;IACbC,aAAa;IACbhB;IACAa,cAAcnB,EAAEO,MAAM,CAAC;QACrBgB,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAEhB,EAAE,EAAEC,QAAQ,EAAS,EAAEgB,KAAoB;IAClE,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,4BAA4B;QAAEnB;QAAIC;IAAS;IAEvD,IAAI;;YASYmB,mBACFA;QATZ,MAAMC,SAAS9B,OAAO8B,MAAM,CAAC;YAAEC,SAAS;YAAMC,MAAMN,MAAMO,WAAW,CAACD,IAAI;QAAC;QAE3E,0CAA0C;QAC1C,MAAMH,QAAQ,MAAMvB,eAAewB,QAAQrB,IAAIC,UAAUiB;QACzD,IAAI,CAACE,OAAO;YACV,MAAM,IAAI9B,SAASD,UAAUoC,aAAa,EAAE;QAC9C;QAEA,MAAMnB,gBAAQc,kBAAAA,6BAAAA,oBAAAA,MAAOM,UAAU,cAAjBN,wCAAAA,kBAAmBd,KAAK,uCAAIqB,OAAO1B;QACjD,MAAMI,MAAMe,CAAAA,kBAAAA,6BAAAA,qBAAAA,MAAOM,UAAU,cAAjBN,yCAAAA,mBAAmBQ,OAAO,KAAI,OAAOD,OAAOP,MAAMM,UAAU,CAACE,OAAO,IAAI;QACpF,MAAMnB,WAAWJ,MAAM,CAAC,uCAAuC,EAAEL,GAAG,UAAU,EAAEK,KAAK,GAAG,CAAC,uCAAuC,EAAEL,IAAI;QAEtIkB,OAAOC,IAAI,CAAC,6BAA6B;YAAEnB;YAAIK;YAAKC;QAAM;QAE1D,MAAMS,SAAiB;YACrBZ,MAAM;YACNH;YACAK;YACAC;YACAG;QACF;QAEA,OAAO;YACLoB,SAAS;gBAAC;oBAAE1B,MAAM;oBAAiB2B,MAAMC,KAAKC,SAAS,CAACjB;gBAAQ;aAAE;YAClEkB,mBAAmB;gBAAElB;YAAO;QAC9B;IACF,EAAE,OAAOmB,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGR,OAAOO;QAChEhB,OAAOgB,KAAK,CAAC,2BAA2B;YAAEA,OAAOC;QAAQ;QAEzD,MAAM,IAAI7C,SAASD,UAAUgD,aAAa,EAAE,CAAC,qBAAqB,EAAEF,SAAS,EAAE;YAC7EG,OAAOJ,iBAAiBE,QAAQF,MAAMI,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACN5B;QACAG;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/sheet-find.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, SheetRefSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { findSheetByRef } from '../../spreadsheet/sheet-operations.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  sheetRef: SheetRefSchema,\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  title: z.string().describe('Sheet tab name'),\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: 'Find an existing sheet/tab within a known spreadsheet by title or GUID',\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, sheetRef }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.find called', { id, sheetRef });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Find sheet within the known spreadsheet\n    const sheet = await findSheetByRef(sheets, id, sheetRef, logger);\n    if (!sheet) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');\n    }\n\n    const title = sheet?.properties?.title ?? String(sheetRef);\n    const gid = sheet?.properties?.sheetId != null ? String(sheet.properties.sheetId) : '';\n    const sheetUrl = gid ? `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}` : `https://docs.google.com/spreadsheets/d/${id}`;\n\n    logger.info('sheets.sheet.find success', { id, gid, title });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid,\n      title,\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.sheet.find error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error finding sheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-find',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SheetGidOutput","SheetRefSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","findSheetByRef","inputSchema","object","id","sheetRef","successBranchSchema","type","literal","gid","title","string","describe","sheetUrl","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","sheet","sheets","version","auth","authContext","InvalidParams","properties","String","sheetId","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAGrC,SAASE,aAAa,EAAEC,iBAAiB,QAAQ,gBAAgB;AACjE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,cAAc,EAAEC,cAAc,EAAEC,mBAAmB,EAAEC,mBAAmB,QAAQ,yBAAyB;AAClH,SAASC,cAAc,QAAQ,wCAAwC;AAEvE,MAAMC,cAAcN,EAAEO,MAAM,CAAC;IAC3BC,IAAIJ;IACJK,UAAUP;AACZ;AAEA,MAAMQ,sBAAsBV,EAAEO,MAAM,CAAC;IACnCI,MAAMX,EAAEY,OAAO,CAAC;IAChBJ,IAAIL;IACJU,KAAKZ;IACLa,OAAOd,EAAEe,MAAM,GAAGC,QAAQ,CAAC;IAC3BC,UAAUjB,EAAEe,MAAM,GAAGG,QAAQ,GAAGF,QAAQ,CAAC;AAC3C;AAEA,MAAMG,eAAenB,EAAEoB,kBAAkB,CAAC,QAAQ;IAACV;IAAqBd;CAAyB;AAEjG,MAAMyB,SAAS;IACbC,aAAa;IACbhB;IACAa,cAAcnB,EAAEO,MAAM,CAAC;QACrBgB,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAEhB,EAAE,EAAEC,QAAQ,EAAS,EAAEgB,KAAoB;IAClE,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,4BAA4B;QAAEnB;QAAIC;IAAS;IAEvD,IAAI;;YASYmB,mBACFA;QATZ,MAAMC,SAAS9B,OAAO8B,MAAM,CAAC;YAAEC,SAAS;YAAMC,MAAMN,MAAMO,WAAW,CAACD,IAAI;QAAC;QAE3E,0CAA0C;QAC1C,MAAMH,QAAQ,MAAMvB,eAAewB,QAAQrB,IAAIC,UAAUiB;QACzD,IAAI,CAACE,OAAO;YACV,MAAM,IAAI/B,cAAcC,kBAAkBmC,aAAa,EAAE;QAC3D;QAEA,MAAMnB,gBAAQc,kBAAAA,6BAAAA,oBAAAA,MAAOM,UAAU,cAAjBN,wCAAAA,kBAAmBd,KAAK,uCAAIqB,OAAO1B;QACjD,MAAMI,MAAMe,CAAAA,kBAAAA,6BAAAA,qBAAAA,MAAOM,UAAU,cAAjBN,yCAAAA,mBAAmBQ,OAAO,KAAI,OAAOD,OAAOP,MAAMM,UAAU,CAACE,OAAO,IAAI;QACpF,MAAMnB,WAAWJ,MAAM,CAAC,uCAAuC,EAAEL,GAAG,UAAU,EAAEK,KAAK,GAAG,CAAC,uCAAuC,EAAEL,IAAI;QAEtIkB,OAAOC,IAAI,CAAC,6BAA6B;YAAEnB;YAAIK;YAAKC;QAAM;QAE1D,MAAMS,SAAiB;YACrBZ,MAAM;YACNH;YACAK;YACAC;YACAG;QACF;QAEA,OAAO;YACLoB,SAAS;gBAAC;oBAAE1B,MAAM;oBAAiB2B,MAAMC,KAAKC,SAAS,CAACjB;gBAAQ;aAAE;YAClEkB,mBAAmB;gBAAElB;YAAO;QAC9B;IACF,EAAE,OAAOmB,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGR,OAAOO;QAChEhB,OAAOgB,KAAK,CAAC,2BAA2B;YAAEA,OAAOC;QAAQ;QAEzD,MAAM,IAAI9C,cAAcC,kBAAkB+C,aAAa,EAAE,CAAC,qBAAqB,EAAEF,SAAS,EAAE;YAC1FG,OAAOJ,iBAAiBE,QAAQF,MAAMI,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACN5B;QACAG;IACF;AACF"}

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

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

package/dist/esm/mcp/tools/sheet-rename.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,7 +57,7 @@ async function handler({ id, gid, newTitle }, extra) {
             return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === gid;
         });
         if (!(sheetInfo === null || sheetInfo === void 0 ? void 0 : sheetInfo.properties)) {
-            throw new McpError(ErrorCode.InvalidParams, `Sheet with gid "${gid}" not found in spreadsheet`);
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet with gid "${gid}" not found in spreadsheet`);
         }
         const oldTitle = sheetInfo.properties.title || '';
         // Rename the sheet
@@ -107,14 +107,14 @@ async function handler({ id, gid, newTitle }, extra) {
             }
         };
     } catch (error) {
-        if (error instanceof McpError) {
+        if (error instanceof ProtocolError) {
             throw error;
         }
         const message = error instanceof Error ? error.message : String(error);
         logger.error('sheets.sheet.rename error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error renaming sheet: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error renaming sheet: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/sheet-rename.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  newTitle: z.coerce.string().trim().min(1).describe('New name for the sheet tab'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Summary of the rename operation'),\n  itemsProcessed: z.number().describe('Total items attempted (always 1 for single sheet)'),\n  itemsChanged: z.number().describe('Successfully renamed sheets (always 1 on success)'),\n  completedAt: z.string().describe('ISO datetime when operation completed'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetUrl: z.string().describe('URL of the renamed sheet'),\n  oldTitle: z.string().describe('Previous title of the sheet'),\n  newTitle: z.string().describe('New title of the sheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Rename a sheet within a spreadsheet.',\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, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.rename called', { id, gid, newTitle });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // First, get the current sheet title\n    const spreadsheetInfo = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const sheetInfo = spreadsheetInfo.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheetInfo?.properties) {\n      throw new McpError(ErrorCode.InvalidParams, `Sheet with gid \"${gid}\" not found in spreadsheet`);\n    }\n\n    const oldTitle = sheetInfo.properties.title || '';\n\n    // Rename the sheet\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [\n          {\n            updateSheetProperties: {\n              properties: { sheetId: Number(gid), title: newTitle },\n              fields: 'title',\n            },\n          },\n        ],\n      },\n    });\n\n    logger.info('sheets.sheet.rename success', { id, gid, oldTitle, newTitle });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: `Renamed sheet \"${oldTitle}\" to \"${newTitle}\"`,\n      itemsProcessed: 1,\n      itemsChanged: 1,\n      completedAt: new Date().toISOString(),\n      id,\n      gid,\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}`,\n      oldTitle,\n      newTitle,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    if (error instanceof McpError) {\n      throw error;\n    }\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.sheet.rename error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error renaming sheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-rename',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","inputSchema","object","id","gid","newTitle","coerce","string","trim","min","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","sheetUrl","oldTitle","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","spreadsheetInfo","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","sheetInfo","data","find","s","String","properties","sheetId","InvalidParams","title","batchUpdate","requestBody","requests","updateSheetProperties","Number","Date","toISOString","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/sheet-rename.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  newTitle: z.coerce.string().trim().min(1).describe('New name for the sheet tab'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Summary of the rename operation'),\n  itemsProcessed: z.number().describe('Total items attempted (always 1 for single sheet)'),\n  itemsChanged: z.number().describe('Successfully renamed sheets (always 1 on success)'),\n  completedAt: z.string().describe('ISO datetime when operation completed'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetUrl: z.string().describe('URL of the renamed sheet'),\n  oldTitle: z.string().describe('Previous title of the sheet'),\n  newTitle: z.string().describe('New title of the sheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Rename a sheet within a spreadsheet.',\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, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.rename called', { id, gid, newTitle });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // First, get the current sheet title\n    const spreadsheetInfo = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const sheetInfo = spreadsheetInfo.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheetInfo?.properties) {\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet with gid \"${gid}\" not found in spreadsheet`);\n    }\n\n    const oldTitle = sheetInfo.properties.title || '';\n\n    // Rename the sheet\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [\n          {\n            updateSheetProperties: {\n              properties: { sheetId: Number(gid), title: newTitle },\n              fields: 'title',\n            },\n          },\n        ],\n      },\n    });\n\n    logger.info('sheets.sheet.rename success', { id, gid, oldTitle, newTitle });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: `Renamed sheet \"${oldTitle}\" to \"${newTitle}\"`,\n      itemsProcessed: 1,\n      itemsChanged: 1,\n      completedAt: new Date().toISOString(),\n      id,\n      gid,\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}`,\n      oldTitle,\n      newTitle,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    if (error instanceof ProtocolError) {\n      throw error;\n    }\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.sheet.rename error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error renaming sheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-rename',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","inputSchema","object","id","gid","newTitle","coerce","string","trim","min","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","sheetUrl","oldTitle","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","spreadsheetInfo","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","sheetInfo","data","find","s","String","properties","sheetId","InvalidParams","title","batchUpdate","requestBody","requests","updateSheetProperties","Number","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/spreadsheet-copy.d.ts

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

package/dist/esm/mcp/tools/spreadsheet-copy.js

@@ -1,6 +1,6 @@
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { google } from 'googleapis';
 import { z } from 'zod';
 import { SpreadsheetIdSchema } from '../../schemas/index.js';
@@ -103,7 +103,7 @@ async function handler({ id, newTitle }, extra) {
         logger.error('sheets.spreadsheet.copy error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error copying spreadsheet: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error copying spreadsheet: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

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

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/spreadsheet-copy.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SpreadsheetIdSchema } from '../../schemas/index.ts';\n\n// Note: Using contextual descriptions for sourceId/newId since they describe different spreadsheets\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  newTitle: z.coerce.string().trim().min(1).optional().describe('Name for the copy (optional, defaults to \"Copy of [original]\")'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Summary of the copy operation'),\n  itemsProcessed: z.number().describe('Total items attempted (always 1)'),\n  itemsChanged: z.number().describe('Successfully copied (always 1 on success)'),\n  completedAt: z.string().describe('ISO datetime when operation completed'),\n  sourceId: z.string().describe('Source spreadsheet ID'),\n  sourceTitle: z.string().describe('Source spreadsheet title'),\n  newId: z.string().describe('Copied spreadsheet ID'),\n  newTitle: z.string().describe('Title of the copied spreadsheet'),\n  spreadsheetUrl: z.string().describe('URL of the copied spreadsheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Copy an entire spreadsheet/workbook (all sheets, formatting, charts, named ranges, etc.). Creates in the same folder as the original. Uses Google Drive API.',\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, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.spreadsheet.copy called', { id, newTitle });\n\n  try {\n    const drive = google.drive({ version: 'v3', auth: extra.authContext.auth });\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get the original spreadsheet title\n    const sourceInfo = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title',\n    });\n\n    const sourceTitle = sourceInfo.data.properties?.title || '';\n\n    // Copy the spreadsheet using Drive API\n    const copyResponse = await drive.files.copy({\n      fileId: id,\n      requestBody: {\n        ...(newTitle && { name: newTitle }),\n      },\n    });\n\n    const newId = copyResponse.data.id;\n    const resultTitle = copyResponse.data.name || '';\n\n    if (!newId) {\n      throw new Error('Failed to retrieve new spreadsheet ID from API response');\n    }\n\n    logger.info('sheets.spreadsheet.copy success', { sourceId: id, newId, newTitle: resultTitle });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: `Copied spreadsheet \"${sourceTitle}\" to \"${resultTitle}\"`,\n      itemsProcessed: 1,\n      itemsChanged: 1,\n      completedAt: new Date().toISOString(),\n      sourceId: id,\n      sourceTitle,\n      newId,\n      newTitle: resultTitle,\n      spreadsheetUrl: `https://docs.google.com/spreadsheets/d/${newId}`,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.spreadsheet.copy error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error copying spreadsheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'spreadsheet-copy',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SpreadsheetIdSchema","inputSchema","object","id","newTitle","coerce","string","trim","min","optional","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","sourceId","sourceTitle","newId","spreadsheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","sourceInfo","drive","version","auth","authContext","sheets","spreadsheets","get","spreadsheetId","fields","data","properties","title","copyResponse","files","copy","fileId","requestBody","name","resultTitle","Error","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","String","InternalError","stack","undefined","createTool"],"mappings":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAIrC,SAASE,SAAS,EAAEC,QAAQ,QAAQ,qCAAqC;AACzE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,mBAAmB,QAAQ,yBAAyB;AAE7D,oGAAoG;AAEpG,MAAMC,cAAcF,EAAEG,MAAM,CAAC;IAC3BC,IAAIH;IACJI,UAAUL,EAAEM,MAAM,CAACC,MAAM,GAAGC,IAAI,GAAGC,GAAG,CAAC,GAAGC,QAAQ,GAAGC,QAAQ,CAAC;AAChE;AAEA,wBAAwB;AACxB,MAAMC,sBAAsBZ,EAAEG,MAAM,CAAC;IACnCU,MAAMb,EAAEc,OAAO,CAAC;IAChBC,kBAAkBf,EAAEO,MAAM,GAAGI,QAAQ,CAAC;IACtCK,gBAAgBhB,EAAEiB,MAAM,GAAGN,QAAQ,CAAC;IACpCO,cAAclB,EAAEiB,MAAM,GAAGN,QAAQ,CAAC;IAClCQ,aAAanB,EAAEO,MAAM,GAAGI,QAAQ,CAAC;IACjCS,UAAUpB,EAAEO,MAAM,GAAGI,QAAQ,CAAC;IAC9BU,aAAarB,EAAEO,MAAM,GAAGI,QAAQ,CAAC;IACjCW,OAAOtB,EAAEO,MAAM,GAAGI,QAAQ,CAAC;IAC3BN,UAAUL,EAAEO,MAAM,GAAGI,QAAQ,CAAC;IAC9BY,gBAAgBvB,EAAEO,MAAM,GAAGI,QAAQ,CAAC;AACtC;AAEA,2CAA2C;AAC3C,MAAMa,eAAexB,EAAEyB,kBAAkB,CAAC,QAAQ;IAACb;IAAqBhB;CAAyB;AAEjG,MAAM8B,SAAS;IACbC,aAAa;IACbzB;IACAsB,cAAcxB,EAAEG,MAAM,CAAC;QACrByB,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAEzB,EAAE,EAAEC,QAAQ,EAAS,EAAEyB,KAAoB;IAClE,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,kCAAkC;QAAE5B;QAAIC;IAAS;IAE7D,IAAI;YAUkB4B;QATpB,MAAMC,QAAQnC,OAAOmC,KAAK,CAAC;YAAEC,SAAS;YAAMC,MAAMN,MAAMO,WAAW,CAACD,IAAI;QAAC;QACzE,MAAME,SAASvC,OAAOuC,MAAM,CAAC;YAAEH,SAAS;YAAMC,MAAMN,MAAMO,WAAW,CAACD,IAAI;QAAC;QAE3E,qCAAqC;QACrC,MAAMH,aAAa,MAAMK,OAAOC,YAAY,CAACC,GAAG,CAAC;YAC/CC,eAAerC;YACfsC,QAAQ;QACV;QAEA,MAAMrB,cAAcY,EAAAA,8BAAAA,WAAWU,IAAI,CAACC,UAAU,cAA1BX,kDAAAA,4BAA4BY,KAAK,KAAI;QAEzD,uCAAuC;QACvC,MAAMC,eAAe,MAAMZ,MAAMa,KAAK,CAACC,IAAI,CAAC;YAC1CC,QAAQ7C;YACR8C,aAAa;gBACX,GAAI7C,YAAY;oBAAE8C,MAAM9C;gBAAS,CAAC;YACpC;QACF;QAEA,MAAMiB,QAAQwB,aAAaH,IAAI,CAACvC,EAAE;QAClC,MAAMgD,cAAcN,aAAaH,IAAI,CAACQ,IAAI,IAAI;QAE9C,IAAI,CAAC7B,OAAO;YACV,MAAM,IAAI+B,MAAM;QAClB;QAEAtB,OAAOC,IAAI,CAAC,mCAAmC;YAAEZ,UAAUhB;YAAIkB;YAAOjB,UAAU+C;QAAY;QAE5F,MAAMxB,SAAiB;YACrBf,MAAM;YACNE,kBAAkB,CAAC,oBAAoB,EAAEM,YAAY,MAAM,EAAE+B,YAAY,CAAC,CAAC;YAC3EpC,gBAAgB;YAChBE,cAAc;YACdC,aAAa,IAAImC,OAAOC,WAAW;YACnCnC,UAAUhB;YACViB;YACAC;YACAjB,UAAU+C;YACV7B,gBAAgB,CAAC,uCAAuC,EAAED,OAAO;QACnE;QAEA,OAAO;YACLkC,SAAS;gBACP;oBACE3C,MAAM;oBACN4C,MAAMC,KAAKC,SAAS,CAAC/B;gBACvB;aACD;YACDgC,mBAAmB;gBAAEhC;YAAO;QAC9B;IACF,EAAE,OAAOiC,OAAO;QACd,MAAMC,UAAUD,iBAAiBR,QAAQQ,MAAMC,OAAO,GAAGC,OAAOF;QAChE9B,OAAO8B,KAAK,CAAC,iCAAiC;YAAEA,OAAOC;QAAQ;QAE/D,MAAM,IAAIhE,SAASD,UAAUmE,aAAa,EAAE,CAAC,2BAA2B,EAAEF,SAAS,EAAE;YACnFG,OAAOJ,iBAAiBR,QAAQQ,MAAMI,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLhB,MAAM;QACNzB;QACAG;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/spreadsheet-copy.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SpreadsheetIdSchema } from '../../schemas/index.ts';\n\n// Note: Using contextual descriptions for sourceId/newId since they describe different spreadsheets\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  newTitle: z.coerce.string().trim().min(1).optional().describe('Name for the copy (optional, defaults to \"Copy of [original]\")'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Summary of the copy operation'),\n  itemsProcessed: z.number().describe('Total items attempted (always 1)'),\n  itemsChanged: z.number().describe('Successfully copied (always 1 on success)'),\n  completedAt: z.string().describe('ISO datetime when operation completed'),\n  sourceId: z.string().describe('Source spreadsheet ID'),\n  sourceTitle: z.string().describe('Source spreadsheet title'),\n  newId: z.string().describe('Copied spreadsheet ID'),\n  newTitle: z.string().describe('Title of the copied spreadsheet'),\n  spreadsheetUrl: z.string().describe('URL of the copied spreadsheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Copy an entire spreadsheet/workbook (all sheets, formatting, charts, named ranges, etc.). Creates in the same folder as the original. Uses Google Drive API.',\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, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.spreadsheet.copy called', { id, newTitle });\n\n  try {\n    const drive = google.drive({ version: 'v3', auth: extra.authContext.auth });\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get the original spreadsheet title\n    const sourceInfo = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title',\n    });\n\n    const sourceTitle = sourceInfo.data.properties?.title || '';\n\n    // Copy the spreadsheet using Drive API\n    const copyResponse = await drive.files.copy({\n      fileId: id,\n      requestBody: {\n        ...(newTitle && { name: newTitle }),\n      },\n    });\n\n    const newId = copyResponse.data.id;\n    const resultTitle = copyResponse.data.name || '';\n\n    if (!newId) {\n      throw new Error('Failed to retrieve new spreadsheet ID from API response');\n    }\n\n    logger.info('sheets.spreadsheet.copy success', { sourceId: id, newId, newTitle: resultTitle });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: `Copied spreadsheet \"${sourceTitle}\" to \"${resultTitle}\"`,\n      itemsProcessed: 1,\n      itemsChanged: 1,\n      completedAt: new Date().toISOString(),\n      sourceId: id,\n      sourceTitle,\n      newId,\n      newTitle: resultTitle,\n      spreadsheetUrl: `https://docs.google.com/spreadsheets/d/${newId}`,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.spreadsheet.copy error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error copying spreadsheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'spreadsheet-copy',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SpreadsheetIdSchema","inputSchema","object","id","newTitle","coerce","string","trim","min","optional","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","sourceId","sourceTitle","newId","spreadsheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","sourceInfo","drive","version","auth","authContext","sheets","spreadsheets","get","spreadsheetId","fields","data","properties","title","copyResponse","files","copy","fileId","requestBody","name","resultTitle","Error","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","String","InternalError","stack","undefined","createTool"],"mappings":"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"}

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

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

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

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

package/dist/esm/mcp/tools/spreadsheet-create.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/spreadsheet-create.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 { SpreadsheetIdOutput } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  title: z.coerce.string().trim().min(1).describe('Title for the new spreadsheet'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Summary of the spreadsheet creation operation'),\n  itemsProcessed: z.number().describe('Total items attempted (always 1 for single spreadsheet)'),\n  itemsChanged: z.number().describe('Successfully created spreadsheets (always 1 on success)'),\n  completedAt: z.string().describe('ISO datetime when operation completed'),\n  id: SpreadsheetIdOutput,\n  spreadsheetUrl: z.string().describe('URL of the created spreadsheet'),\n  title: z.string().describe('Title of the created spreadsheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Create a new spreadsheet',\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({ title }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.spreadsheet.create called', { title });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n    const response = await sheets.spreadsheets.create({\n      requestBody: {\n        properties: {\n          title: title,\n        },\n      },\n    });\n    const res = response.data;\n    const id = res.spreadsheetId ?? '';\n    const url = res.spreadsheetUrl ?? '';\n\n    logger.info('sheets.spreadsheet.create success', { id, title, url });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: `Created spreadsheet \"${title}\"`,\n      itemsProcessed: 1,\n      itemsChanged: 1,\n      completedAt: new Date().toISOString(),\n      id,\n      spreadsheetUrl: url,\n      title,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.spreadsheet.create error', { error: message });\n\n    // Throw McpError for proper MCP error handling\n    throw new McpError(ErrorCode.InternalError, `Error creating spreadsheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'spreadsheet-create',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SpreadsheetIdOutput","inputSchema","object","title","coerce","string","trim","min","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","id","spreadsheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","res","sheets","version","auth","authContext","response","spreadsheets","create","requestBody","properties","data","spreadsheetId","url","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool","name"],"mappings":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAIrC,SAASE,SAAS,EAAEC,QAAQ,QAAQ,qCAAqC;AACzE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,mBAAmB,QAAQ,yBAAyB;AAE7D,MAAMC,cAAcF,EAAEG,MAAM,CAAC;IAC3BC,OAAOJ,EAAEK,MAAM,CAACC,MAAM,GAAGC,IAAI,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAClD;AAEA,wBAAwB;AACxB,MAAMC,sBAAsBV,EAAEG,MAAM,CAAC;IACnCQ,MAAMX,EAAEY,OAAO,CAAC;IAChBC,kBAAkBb,EAAEM,MAAM,GAAGG,QAAQ,CAAC;IACtCK,gBAAgBd,EAAEe,MAAM,GAAGN,QAAQ,CAAC;IACpCO,cAAchB,EAAEe,MAAM,GAAGN,QAAQ,CAAC;IAClCQ,aAAajB,EAAEM,MAAM,GAAGG,QAAQ,CAAC;IACjCS,IAAIjB;IACJkB,gBAAgBnB,EAAEM,MAAM,GAAGG,QAAQ,CAAC;IACpCL,OAAOJ,EAAEM,MAAM,GAAGG,QAAQ,CAAC;AAC7B;AAEA,2CAA2C;AAC3C,MAAMW,eAAepB,EAAEqB,kBAAkB,CAAC,QAAQ;IAACX;IAAqBd;CAAyB;AAEjG,MAAM0B,SAAS;IACbC,aAAa;IACbrB;IACAkB,cAAcpB,EAAEG,MAAM,CAAC;QACrBqB,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAErB,KAAK,EAAS,EAAEsB,KAAoB;IAC3D,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,oCAAoC;QAAExB;IAAM;IAExD,IAAI;YAUSyB,oBACCA;QAVZ,MAAMC,SAAS/B,OAAO+B,MAAM,CAAC;YAAEC,SAAS;YAAMC,MAAMN,MAAMO,WAAW,CAACD,IAAI;QAAC;QAC3E,MAAME,WAAW,MAAMJ,OAAOK,YAAY,CAACC,MAAM,CAAC;YAChDC,aAAa;gBACXC,YAAY;oBACVlC,OAAOA;gBACT;YACF;QACF;QACA,MAAMyB,MAAMK,SAASK,IAAI;QACzB,MAAMrB,MAAKW,qBAAAA,IAAIW,aAAa,cAAjBX,gCAAAA,qBAAqB;QAChC,MAAMY,OAAMZ,sBAAAA,IAAIV,cAAc,cAAlBU,iCAAAA,sBAAsB;QAElCF,OAAOC,IAAI,CAAC,qCAAqC;YAAEV;YAAId;YAAOqC;QAAI;QAElE,MAAMjB,SAAiB;YACrBb,MAAM;YACNE,kBAAkB,CAAC,qBAAqB,EAAET,MAAM,CAAC,CAAC;YAClDU,gBAAgB;YAChBE,cAAc;YACdC,aAAa,IAAIyB,OAAOC,WAAW;YACnCzB;YACAC,gBAAgBsB;YAChBrC;QACF;QAEA,OAAO;YACLwC,SAAS;gBACP;oBACEjC,MAAM;oBACNkC,MAAMC,KAAKC,SAAS,CAACvB;gBACvB;aACD;YACDwB,mBAAmB;gBAAExB;YAAO;QAC9B;IACF,EAAE,OAAOyB,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGE,OAAOH;QAChEtB,OAAOsB,KAAK,CAAC,mCAAmC;YAAEA,OAAOC;QAAQ;QAEjE,+CAA+C;QAC/C,MAAM,IAAIpD,SAASD,UAAUwD,aAAa,EAAE,CAAC,4BAA4B,EAAEH,SAAS,EAAE;YACpFI,OAAOL,iBAAiBE,QAAQF,MAAMK,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACNnC;QACAG;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/spreadsheet-create.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 { SpreadsheetIdOutput } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  title: z.coerce.string().trim().min(1).describe('Title for the new spreadsheet'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Summary of the spreadsheet creation operation'),\n  itemsProcessed: z.number().describe('Total items attempted (always 1 for single spreadsheet)'),\n  itemsChanged: z.number().describe('Successfully created spreadsheets (always 1 on success)'),\n  completedAt: z.string().describe('ISO datetime when operation completed'),\n  id: SpreadsheetIdOutput,\n  spreadsheetUrl: z.string().describe('URL of the created spreadsheet'),\n  title: z.string().describe('Title of the created spreadsheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Create a new spreadsheet',\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({ title }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.spreadsheet.create called', { title });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n    const response = await sheets.spreadsheets.create({\n      requestBody: {\n        properties: {\n          title: title,\n        },\n      },\n    });\n    const res = response.data;\n    const id = res.spreadsheetId ?? '';\n    const url = res.spreadsheetUrl ?? '';\n\n    logger.info('sheets.spreadsheet.create success', { id, title, url });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: `Created spreadsheet \"${title}\"`,\n      itemsProcessed: 1,\n      itemsChanged: 1,\n      completedAt: new Date().toISOString(),\n      id,\n      spreadsheetUrl: url,\n      title,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.spreadsheet.create error', { error: message });\n\n    // Throw ProtocolError for proper MCP error handling\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error creating spreadsheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'spreadsheet-create',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SpreadsheetIdOutput","inputSchema","object","title","coerce","string","trim","min","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","id","spreadsheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","res","sheets","version","auth","authContext","response","spreadsheets","create","requestBody","properties","data","spreadsheetId","url","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool","name"],"mappings":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAGrC,SAASE,aAAa,EAAEC,iBAAiB,QAAQ,gBAAgB;AACjE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,mBAAmB,QAAQ,yBAAyB;AAE7D,MAAMC,cAAcF,EAAEG,MAAM,CAAC;IAC3BC,OAAOJ,EAAEK,MAAM,CAACC,MAAM,GAAGC,IAAI,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;AAClD;AAEA,wBAAwB;AACxB,MAAMC,sBAAsBV,EAAEG,MAAM,CAAC;IACnCQ,MAAMX,EAAEY,OAAO,CAAC;IAChBC,kBAAkBb,EAAEM,MAAM,GAAGG,QAAQ,CAAC;IACtCK,gBAAgBd,EAAEe,MAAM,GAAGN,QAAQ,CAAC;IACpCO,cAAchB,EAAEe,MAAM,GAAGN,QAAQ,CAAC;IAClCQ,aAAajB,EAAEM,MAAM,GAAGG,QAAQ,CAAC;IACjCS,IAAIjB;IACJkB,gBAAgBnB,EAAEM,MAAM,GAAGG,QAAQ,CAAC;IACpCL,OAAOJ,EAAEM,MAAM,GAAGG,QAAQ,CAAC;AAC7B;AAEA,2CAA2C;AAC3C,MAAMW,eAAepB,EAAEqB,kBAAkB,CAAC,QAAQ;IAACX;IAAqBd;CAAyB;AAEjG,MAAM0B,SAAS;IACbC,aAAa;IACbrB;IACAkB,cAAcpB,EAAEG,MAAM,CAAC;QACrBqB,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAErB,KAAK,EAAS,EAAEsB,KAAoB;IAC3D,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,oCAAoC;QAAExB;IAAM;IAExD,IAAI;YAUSyB,oBACCA;QAVZ,MAAMC,SAAS/B,OAAO+B,MAAM,CAAC;YAAEC,SAAS;YAAMC,MAAMN,MAAMO,WAAW,CAACD,IAAI;QAAC;QAC3E,MAAME,WAAW,MAAMJ,OAAOK,YAAY,CAACC,MAAM,CAAC;YAChDC,aAAa;gBACXC,YAAY;oBACVlC,OAAOA;gBACT;YACF;QACF;QACA,MAAMyB,MAAMK,SAASK,IAAI;QACzB,MAAMrB,MAAKW,qBAAAA,IAAIW,aAAa,cAAjBX,gCAAAA,qBAAqB;QAChC,MAAMY,OAAMZ,sBAAAA,IAAIV,cAAc,cAAlBU,iCAAAA,sBAAsB;QAElCF,OAAOC,IAAI,CAAC,qCAAqC;YAAEV;YAAId;YAAOqC;QAAI;QAElE,MAAMjB,SAAiB;YACrBb,MAAM;YACNE,kBAAkB,CAAC,qBAAqB,EAAET,MAAM,CAAC,CAAC;YAClDU,gBAAgB;YAChBE,cAAc;YACdC,aAAa,IAAIyB,OAAOC,WAAW;YACnCzB;YACAC,gBAAgBsB;YAChBrC;QACF;QAEA,OAAO;YACLwC,SAAS;gBACP;oBACEjC,MAAM;oBACNkC,MAAMC,KAAKC,SAAS,CAACvB;gBACvB;aACD;YACDwB,mBAAmB;gBAAExB;YAAO;QAC9B;IACF,EAAE,OAAOyB,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGE,OAAOH;QAChEtB,OAAOsB,KAAK,CAAC,mCAAmC;YAAEA,OAAOC;QAAQ;QAEjE,oDAAoD;QACpD,MAAM,IAAIrD,cAAcC,kBAAkBuD,aAAa,EAAE,CAAC,4BAA4B,EAAEH,SAAS,EAAE;YACjGI,OAAOL,iBAAiBE,QAAQF,MAAMK,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACNnC;QACAG;IACF;AACF"}

package/dist/esm/mcp/tools/spreadsheet-find.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<{
     spreadsheetRef: z.ZodString;

package/dist/esm/mcp/tools/spreadsheet-find.js

@@ -1,6 +1,6 @@
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { google } from 'googleapis';
 import { z } from 'zod';
 import { SheetGidOutput, SpreadsheetIdOutput, SpreadsheetRefSchema } from '../../schemas/index.js';
@@ -99,7 +99,7 @@ async function handler({ spreadsheetRef }, extra) {
         logger.error('sheets.spreadsheet.find error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error finding spreadsheet: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error finding spreadsheet: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

package/dist/esm/mcp/tools/spreadsheet-find.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/spreadsheet-find.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, SpreadsheetIdOutput, SpreadsheetRefSchema } from '../../schemas/index.ts';\nimport { findSpreadsheetsByRef } from '../../spreadsheet/spreadsheet-management.ts';\n\n/** Spreadsheet match result from findSpreadsheetsByRef */\ninterface SpreadsheetMatch {\n  id: string;\n  spreadsheetTitle: string | undefined;\n  url: string | undefined;\n  modifiedTime: string | null | undefined;\n}\n\nconst inputSchema = z.object({\n  spreadsheetRef: SpreadsheetRefSchema,\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  items: z\n    .array(\n      z.object({\n        id: SpreadsheetIdOutput,\n        spreadsheetTitle: z.string().describe('Name of the spreadsheet'),\n        spreadsheetUrl: z.string().optional().describe('URL to view the spreadsheet'),\n        modifiedTime: z.string().optional().describe('Last modified timestamp (ISO format)'),\n        sheets: z\n          .array(\n            z.object({\n              gid: SheetGidOutput,\n              sheetTitle: z.string().describe('Sheet tab name'),\n            })\n          )\n          .describe('All sheets/tabs in this spreadsheet'),\n      })\n    )\n    .describe('Matching spreadsheets sorted by modification time'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Find spreadsheet by ID, URL, or name. Returns all sheets/tabs in response.',\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({ spreadsheetRef }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.spreadsheet.find called', { spreadsheetRef });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n    const drive = google.drive({ version: 'v3', auth: extra.authContext.auth });\n\n    const matches = (await findSpreadsheetsByRef(sheets, drive, spreadsheetRef)) as SpreadsheetMatch[];\n\n    const sorted = (matches || []).slice().sort((a: SpreadsheetMatch, b: SpreadsheetMatch) => (b.modifiedTime ? new Date(b.modifiedTime).getTime() : 0) - (a.modifiedTime ? new Date(a.modifiedTime).getTime() : 0));\n\n    const items = await Promise.all(\n      sorted.map(async (m: SpreadsheetMatch) => {\n        // Fetch sheet metadata for each spreadsheet\n        const spreadsheetResponse = await sheets.spreadsheets.get({\n          spreadsheetId: m.id,\n          fields: 'sheets.properties.sheetId,sheets.properties.title',\n        });\n\n        const sheetsData = (spreadsheetResponse.data.sheets || []).map((sheet) => {\n          const gid = String(sheet.properties?.sheetId ?? '');\n          return {\n            gid,\n            sheetTitle: sheet.properties?.title ?? '',\n          };\n        });\n\n        return {\n          id: m.id,\n          spreadsheetTitle: m.spreadsheetTitle ?? '',\n          sheets: sheetsData,\n          ...(m.url && { spreadsheetUrl: m.url }),\n          ...(m.modifiedTime && { modifiedTime: m.modifiedTime }),\n        };\n      })\n    );\n\n    logger.info('sheets.spreadsheet.find success', { count: items.length });\n\n    const result: Output = {\n      type: 'success' as const,\n      items,\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.spreadsheet.find error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error finding spreadsheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'spreadsheet-find',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SpreadsheetIdOutput","SpreadsheetRefSchema","findSpreadsheetsByRef","inputSchema","object","spreadsheetRef","successBranchSchema","type","literal","items","array","id","spreadsheetTitle","string","describe","spreadsheetUrl","optional","modifiedTime","sheets","gid","sheetTitle","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","version","auth","authContext","drive","matches","sorted","slice","sort","a","b","Date","getTime","Promise","all","map","m","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","sheetsData","data","sheet","String","properties","sheetId","title","url","count","length","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/spreadsheet-find.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, SpreadsheetIdOutput, SpreadsheetRefSchema } from '../../schemas/index.ts';\nimport { findSpreadsheetsByRef } from '../../spreadsheet/spreadsheet-management.ts';\n\n/** Spreadsheet match result from findSpreadsheetsByRef */\ninterface SpreadsheetMatch {\n  id: string;\n  spreadsheetTitle: string | undefined;\n  url: string | undefined;\n  modifiedTime: string | null | undefined;\n}\n\nconst inputSchema = z.object({\n  spreadsheetRef: SpreadsheetRefSchema,\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  items: z\n    .array(\n      z.object({\n        id: SpreadsheetIdOutput,\n        spreadsheetTitle: z.string().describe('Name of the spreadsheet'),\n        spreadsheetUrl: z.string().optional().describe('URL to view the spreadsheet'),\n        modifiedTime: z.string().optional().describe('Last modified timestamp (ISO format)'),\n        sheets: z\n          .array(\n            z.object({\n              gid: SheetGidOutput,\n              sheetTitle: z.string().describe('Sheet tab name'),\n            })\n          )\n          .describe('All sheets/tabs in this spreadsheet'),\n      })\n    )\n    .describe('Matching spreadsheets sorted by modification time'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Find spreadsheet by ID, URL, or name. Returns all sheets/tabs in response.',\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({ spreadsheetRef }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.spreadsheet.find called', { spreadsheetRef });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n    const drive = google.drive({ version: 'v3', auth: extra.authContext.auth });\n\n    const matches = (await findSpreadsheetsByRef(sheets, drive, spreadsheetRef)) as SpreadsheetMatch[];\n\n    const sorted = (matches || []).slice().sort((a: SpreadsheetMatch, b: SpreadsheetMatch) => (b.modifiedTime ? new Date(b.modifiedTime).getTime() : 0) - (a.modifiedTime ? new Date(a.modifiedTime).getTime() : 0));\n\n    const items = await Promise.all(\n      sorted.map(async (m: SpreadsheetMatch) => {\n        // Fetch sheet metadata for each spreadsheet\n        const spreadsheetResponse = await sheets.spreadsheets.get({\n          spreadsheetId: m.id,\n          fields: 'sheets.properties.sheetId,sheets.properties.title',\n        });\n\n        const sheetsData = (spreadsheetResponse.data.sheets || []).map((sheet) => {\n          const gid = String(sheet.properties?.sheetId ?? '');\n          return {\n            gid,\n            sheetTitle: sheet.properties?.title ?? '',\n          };\n        });\n\n        return {\n          id: m.id,\n          spreadsheetTitle: m.spreadsheetTitle ?? '',\n          sheets: sheetsData,\n          ...(m.url && { spreadsheetUrl: m.url }),\n          ...(m.modifiedTime && { modifiedTime: m.modifiedTime }),\n        };\n      })\n    );\n\n    logger.info('sheets.spreadsheet.find success', { count: items.length });\n\n    const result: Output = {\n      type: 'success' as const,\n      items,\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.spreadsheet.find error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error finding spreadsheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'spreadsheet-find',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SheetGidOutput","SpreadsheetIdOutput","SpreadsheetRefSchema","findSpreadsheetsByRef","inputSchema","object","spreadsheetRef","successBranchSchema","type","literal","items","array","id","spreadsheetTitle","string","describe","spreadsheetUrl","optional","modifiedTime","sheets","gid","sheetTitle","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","version","auth","authContext","drive","matches","sorted","slice","sort","a","b","Date","getTime","Promise","all","map","m","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","sheetsData","data","sheet","String","properties","sheetId","title","url","count","length","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/spreadsheet-rename.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/spreadsheet-rename.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 { SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
@@ -98,7 +98,7 @@ async function handler({ id, newTitle }, extra) {
         logger.error('sheets.spreadsheet.rename error', {
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error renaming spreadsheet: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error renaming spreadsheet: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

package/dist/esm/mcp/tools/spreadsheet-rename.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/spreadsheet-rename.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 { SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  newTitle: z.coerce.string().trim().min(1).describe('New name for the spreadsheet'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Summary of the rename operation'),\n  itemsProcessed: z.number().describe('Total items attempted (always 1)'),\n  itemsChanged: z.number().describe('Successfully renamed (always 1 on success)'),\n  completedAt: z.string().describe('ISO datetime when operation completed'),\n  id: SpreadsheetIdOutput,\n  spreadsheetUrl: z.string().describe('URL of the renamed spreadsheet'),\n  oldTitle: z.string().describe('Previous title of the spreadsheet'),\n  newTitle: z.string().describe('New title of the spreadsheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Rename a spreadsheet/workbook (the entire document, not individual sheets/tabs)',\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, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.spreadsheet.rename called', { id, newTitle });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // First, get the current spreadsheet title\n    const spreadsheetInfo = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title',\n    });\n\n    const oldTitle = spreadsheetInfo.data.properties?.title || '';\n\n    // Rename the spreadsheet\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [\n          {\n            updateSpreadsheetProperties: {\n              properties: { title: newTitle },\n              fields: 'title',\n            },\n          },\n        ],\n      },\n    });\n\n    logger.info('sheets.spreadsheet.rename success', { id, oldTitle, newTitle });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: `Renamed spreadsheet \"${oldTitle}\" to \"${newTitle}\"`,\n      itemsProcessed: 1,\n      itemsChanged: 1,\n      completedAt: new Date().toISOString(),\n      id,\n      spreadsheetUrl: `https://docs.google.com/spreadsheets/d/${id}`,\n      oldTitle,\n      newTitle,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.spreadsheet.rename error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error renaming spreadsheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'spreadsheet-rename',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SpreadsheetIdOutput","SpreadsheetIdSchema","inputSchema","object","id","newTitle","coerce","string","trim","min","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","spreadsheetUrl","oldTitle","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","spreadsheetInfo","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","properties","title","batchUpdate","requestBody","requests","updateSpreadsheetProperties","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","Error","String","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/spreadsheet-rename.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 { SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  newTitle: z.coerce.string().trim().min(1).describe('New name for the spreadsheet'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Summary of the rename operation'),\n  itemsProcessed: z.number().describe('Total items attempted (always 1)'),\n  itemsChanged: z.number().describe('Successfully renamed (always 1 on success)'),\n  completedAt: z.string().describe('ISO datetime when operation completed'),\n  id: SpreadsheetIdOutput,\n  spreadsheetUrl: z.string().describe('URL of the renamed spreadsheet'),\n  oldTitle: z.string().describe('Previous title of the spreadsheet'),\n  newTitle: z.string().describe('New title of the spreadsheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Rename a spreadsheet/workbook (the entire document, not individual sheets/tabs)',\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, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.spreadsheet.rename called', { id, newTitle });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // First, get the current spreadsheet title\n    const spreadsheetInfo = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title',\n    });\n\n    const oldTitle = spreadsheetInfo.data.properties?.title || '';\n\n    // Rename the spreadsheet\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [\n          {\n            updateSpreadsheetProperties: {\n              properties: { title: newTitle },\n              fields: 'title',\n            },\n          },\n        ],\n      },\n    });\n\n    logger.info('sheets.spreadsheet.rename success', { id, oldTitle, newTitle });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: `Renamed spreadsheet \"${oldTitle}\" to \"${newTitle}\"`,\n      itemsProcessed: 1,\n      itemsChanged: 1,\n      completedAt: new Date().toISOString(),\n      id,\n      spreadsheetUrl: `https://docs.google.com/spreadsheets/d/${id}`,\n      oldTitle,\n      newTitle,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.spreadsheet.rename error', { error: message });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error renaming spreadsheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'spreadsheet-rename',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SpreadsheetIdOutput","SpreadsheetIdSchema","inputSchema","object","id","newTitle","coerce","string","trim","min","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","spreadsheetUrl","oldTitle","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","spreadsheetInfo","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","properties","title","batchUpdate","requestBody","requests","updateSpreadsheetProperties","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/validation-set.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/validation-set.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';
@@ -234,7 +234,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;
@@ -246,7 +246,7 @@ async function handler({ id, gid, requests }, extra) {
                 gid,
                 sheetTitle
             });
-            throw new McpError(ErrorCode.InternalError, `Sheet ID not available for ${gid}. Cannot perform validation operations without valid sheet ID.`);
+            throw new ProtocolError(ProtocolErrorCode.InternalError, `Sheet ID not available for ${gid}. Cannot perform validation operations without valid sheet ID.`);
         }
         // Build batch update requests
         const batchRequests = [];
@@ -352,7 +352,7 @@ async function handler({ id, gid, requests }, extra) {
             requestCount: requests.length,
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error setting validation: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error setting validation: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }