@mcp-z/mcp-sheets 1.2.4 → 1.3.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":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/sheet-delete.ts"],"sourcesContent":["import { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { 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 = sheetsApi({ version: 'v4', auth: googleAuth(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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","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","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,8 +1,9 @@
+import { sheets as sheetsApi } from '@googleapis/sheets';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { google } from 'googleapis';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { z } from 'zod';
+import { googleAuth } from '../../lib/google-auth.js';
 import { SheetGidOutput, SheetRefSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
 import { findSheetByRef } from '../../spreadsheet/sheet-operations.js';
 const inputSchema = z.object({
@@ -36,14 +37,14 @@ async function handler({ id, sheetRef }, extra) {
     try {
         var _ref;
         var _sheet_properties, _sheet_properties1;
-        const sheets = google.sheets({
+        const sheets = sheetsApi({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         // 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 +77,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 { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, 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 = sheetsApi({ version: 'v4', auth: googleAuth(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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","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","version","auth","authContext","InvalidParams","properties","String","sheetId","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"AAAA,SAASA,UAAUC,SAAS,QAAQ,qBAAqB;AAEzD,SAASC,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAGrC,SAASE,aAAa,EAAEC,iBAAiB,QAAQ,gBAAgB;AACjE,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,UAAU,QAAQ,2BAA2B;AACtD,SAASC,cAAc,EAAEC,cAAc,EAAEC,mBAAmB,EAAEC,mBAAmB,QAAQ,yBAAyB;AAClH,SAASC,cAAc,QAAQ,wCAAwC;AAEvE,MAAMC,cAAcP,EAAEQ,MAAM,CAAC;IAC3BC,IAAIJ;IACJK,UAAUP;AACZ;AAEA,MAAMQ,sBAAsBX,EAAEQ,MAAM,CAAC;IACnCI,MAAMZ,EAAEa,OAAO,CAAC;IAChBJ,IAAIL;IACJU,KAAKZ;IACLa,OAAOf,EAAEgB,MAAM,GAAGC,QAAQ,CAAC;IAC3BC,UAAUlB,EAAEgB,MAAM,GAAGG,QAAQ,GAAGF,QAAQ,CAAC;AAC3C;AAEA,MAAMG,eAAepB,EAAEqB,kBAAkB,CAAC,QAAQ;IAACV;IAAqBd;CAAyB;AAEjG,MAAMyB,SAAS;IACbC,aAAa;IACbhB;IACAa,cAAcpB,EAAEQ,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,MAAMnC,SAASC,UAAU;YAAEmC,SAAS;YAAMC,MAAM9B,WAAWyB,MAAMM,WAAW,CAACD,IAAI;QAAE;QAEnF,0CAA0C;QAC1C,MAAMF,QAAQ,MAAMvB,eAAeZ,QAAQe,IAAIC,UAAUiB;QACzD,IAAI,CAACE,OAAO;YACV,MAAM,IAAI/B,cAAcC,kBAAkBkC,aAAa,EAAE;QAC3D;QAEA,MAAMlB,gBAAQc,kBAAAA,6BAAAA,oBAAAA,MAAOK,UAAU,cAAjBL,wCAAAA,kBAAmBd,KAAK,uCAAIoB,OAAOzB;QACjD,MAAMI,MAAMe,CAAAA,kBAAAA,6BAAAA,qBAAAA,MAAOK,UAAU,cAAjBL,yCAAAA,mBAAmBO,OAAO,KAAI,OAAOD,OAAON,MAAMK,UAAU,CAACE,OAAO,IAAI;QACpF,MAAMlB,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;YACLmB,SAAS;gBAAC;oBAAEzB,MAAM;oBAAiB0B,MAAMC,KAAKC,SAAS,CAAChB;gBAAQ;aAAE;YAClEiB,mBAAmB;gBAAEjB;YAAO;QAC9B;IACF,EAAE,OAAOkB,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGR,OAAOO;QAChEf,OAAOe,KAAK,CAAC,2BAA2B;YAAEA,OAAOC;QAAQ;QAEzD,MAAM,IAAI7C,cAAcC,kBAAkB8C,aAAa,EAAE,CAAC,qBAAqB,EAAEF,SAAS,EAAE;YAC1FG,OAAOJ,iBAAiBE,QAAQF,MAAMI,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACN3B;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,8 +1,9 @@
+import { sheets as sheetsApi } from '@googleapis/sheets';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { google } from 'googleapis';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { z } from 'zod';
+import { googleAuth } from '../../lib/google-auth.js';
 import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
 const inputSchema = z.object({
     id: SpreadsheetIdSchema,
@@ -43,9 +44,9 @@ async function handler({ id, gid, newTitle }, extra) {
     });
     try {
         var _spreadsheetInfo_data_sheets;
-        const sheets = google.sheets({
+        const sheets = sheetsApi({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         // First, get the current sheet title
         const spreadsheetInfo = await sheets.spreadsheets.get({
@@ -57,7 +58,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 +108,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 { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  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 = sheetsApi({ version: 'v4', auth: googleAuth(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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","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","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,8 +1,10 @@
+import { drive as driveApi } from '@googleapis/drive';
+import { sheets as sheetsApi } from '@googleapis/sheets';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { google } from 'googleapis';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { z } from 'zod';
+import { googleAuth } from '../../lib/google-auth.js';
 import { SpreadsheetIdSchema } from '../../schemas/index.js';
 // Note: Using contextual descriptions for sourceId/newId since they describe different spreadsheets
 const inputSchema = z.object({
@@ -42,13 +44,13 @@ async function handler({ id, newTitle }, extra) {
     });
     try {
         var _sourceInfo_data_properties;
-        const drive = google.drive({
+        const drive = driveApi({
             version: 'v3',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
-        const sheets = google.sheets({
+        const sheets = sheetsApi({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         // Get the original spreadsheet title
         const sourceInfo = await sheets.spreadsheets.get({
@@ -103,7 +105,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":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/spreadsheet-copy.ts"],"sourcesContent":["import { drive as driveApi } from '@googleapis/drive';\nimport { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\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 = driveApi({ version: 'v3', auth: googleAuth(extra.authContext.auth) });\n    const sheets = sheetsApi({ version: 'v4', auth: googleAuth(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":["drive","driveApi","sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","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","version","auth","authContext","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,8 +1,9 @@
+import { sheets as sheetsApi } from '@googleapis/sheets';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { google } from 'googleapis';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { z } from 'zod';
+import { googleAuth } from '../../lib/google-auth.js';
 import { SpreadsheetIdOutput } from '../../schemas/index.js';
 const inputSchema = z.object({
     title: z.coerce.string().trim().min(1).describe('Title for the new spreadsheet')
@@ -37,9 +38,9 @@ async function handler({ title }, extra) {
     });
     try {
         var _res_spreadsheetId, _res_spreadsheetUrl;
-        const sheets = google.sheets({
+        const sheets = sheetsApi({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         const response = await sheets.spreadsheets.create({
             requestBody: {
@@ -82,8 +83,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 { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { 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 = sheetsApi({ version: 'v4', auth: googleAuth(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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","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","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":"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"}

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,8 +1,10 @@
+import { drive as driveApi } from '@googleapis/drive';
+import { sheets as sheetsApi } from '@googleapis/sheets';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { google } from 'googleapis';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { z } from 'zod';
+import { googleAuth } from '../../lib/google-auth.js';
 import { SheetGidOutput, SpreadsheetIdOutput, SpreadsheetRefSchema } from '../../schemas/index.js';
 import { findSpreadsheetsByRef } from '../../spreadsheet/spreadsheet-management.js';
 const inputSchema = z.object({
@@ -38,13 +40,13 @@ async function handler({ spreadsheetRef }, extra) {
         spreadsheetRef
     });
     try {
-        const sheets = google.sheets({
+        const sheets = sheetsApi({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
-        const drive = google.drive({
+        const drive = driveApi({
             version: 'v3',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         const matches = await findSpreadsheetsByRef(sheets, drive, spreadsheetRef);
         const sorted = (matches || []).slice().sort((a, b)=>(b.modifiedTime ? new Date(b.modifiedTime).getTime() : 0) - (a.modifiedTime ? new Date(a.modifiedTime).getTime() : 0));
@@ -99,7 +101,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 { drive as driveApi } from '@googleapis/drive';\nimport { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\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 = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n    const drive = driveApi({ version: 'v3', auth: googleAuth(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":["drive","driveApi","sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetGidOutput","SpreadsheetIdOutput","SpreadsheetRefSchema","findSpreadsheetsByRef","inputSchema","object","spreadsheetRef","successBranchSchema","type","literal","items","array","id","spreadsheetTitle","string","describe","spreadsheetUrl","optional","modifiedTime","gid","sheetTitle","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","version","auth","authContext","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,8 +1,9 @@
+import { sheets as sheetsApi } from '@googleapis/sheets';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { google } from 'googleapis';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { z } from 'zod';
+import { googleAuth } from '../../lib/google-auth.js';
 import { SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
 const inputSchema = z.object({
     id: SpreadsheetIdSchema,
@@ -40,9 +41,9 @@ async function handler({ id, newTitle }, extra) {
     });
     try {
         var _spreadsheetInfo_data_properties;
-        const sheets = google.sheets({
+        const sheets = sheetsApi({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         // First, get the current spreadsheet title
         const spreadsheetInfo = await sheets.spreadsheets.get({
@@ -98,7 +99,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
         });
     }