@mcp-z/mcp-sheets 2.0.0 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. package/dist/cjs/lib/google-auth.d.cts +9 -0
  2. package/dist/cjs/lib/google-auth.d.ts +9 -0
  3. package/dist/cjs/lib/google-auth.js +16 -0
  4. package/dist/cjs/lib/google-auth.js.map +1 -0
  5. package/dist/cjs/mcp/resources/spreadsheet.js +2 -1
  6. package/dist/cjs/mcp/resources/spreadsheet.js.map +1 -1
  7. package/dist/cjs/mcp/tools/cells-format.js +2 -1
  8. package/dist/cjs/mcp/tools/cells-format.js.map +1 -1
  9. package/dist/cjs/mcp/tools/chart-create.js +2 -1
  10. package/dist/cjs/mcp/tools/chart-create.js.map +1 -1
  11. package/dist/cjs/mcp/tools/columns-get.js +2 -1
  12. package/dist/cjs/mcp/tools/columns-get.js.map +1 -1
  13. package/dist/cjs/mcp/tools/columns-update.js +2 -1
  14. package/dist/cjs/mcp/tools/columns-update.js.map +1 -1
  15. package/dist/cjs/mcp/tools/dimensions-batch-update.js +2 -1
  16. package/dist/cjs/mcp/tools/dimensions-batch-update.js.map +1 -1
  17. package/dist/cjs/mcp/tools/dimensions-move.js +2 -1
  18. package/dist/cjs/mcp/tools/dimensions-move.js.map +1 -1
  19. package/dist/cjs/mcp/tools/rows-append.js +2 -1
  20. package/dist/cjs/mcp/tools/rows-append.js.map +1 -1
  21. package/dist/cjs/mcp/tools/rows-csv-append.js +2 -1
  22. package/dist/cjs/mcp/tools/rows-csv-append.js.map +1 -1
  23. package/dist/cjs/mcp/tools/rows-get.js +2 -1
  24. package/dist/cjs/mcp/tools/rows-get.js.map +1 -1
  25. package/dist/cjs/mcp/tools/sheet-copy-to.js +2 -1
  26. package/dist/cjs/mcp/tools/sheet-copy-to.js.map +1 -1
  27. package/dist/cjs/mcp/tools/sheet-copy.js +2 -1
  28. package/dist/cjs/mcp/tools/sheet-copy.js.map +1 -1
  29. package/dist/cjs/mcp/tools/sheet-create.js +2 -1
  30. package/dist/cjs/mcp/tools/sheet-create.js.map +1 -1
  31. package/dist/cjs/mcp/tools/sheet-delete.js +2 -1
  32. package/dist/cjs/mcp/tools/sheet-delete.js.map +1 -1
  33. package/dist/cjs/mcp/tools/sheet-find.js +2 -1
  34. package/dist/cjs/mcp/tools/sheet-find.js.map +1 -1
  35. package/dist/cjs/mcp/tools/sheet-rename.js +2 -1
  36. package/dist/cjs/mcp/tools/sheet-rename.js.map +1 -1
  37. package/dist/cjs/mcp/tools/spreadsheet-copy.js +3 -2
  38. package/dist/cjs/mcp/tools/spreadsheet-copy.js.map +1 -1
  39. package/dist/cjs/mcp/tools/spreadsheet-create.js +2 -1
  40. package/dist/cjs/mcp/tools/spreadsheet-create.js.map +1 -1
  41. package/dist/cjs/mcp/tools/spreadsheet-find.js +3 -2
  42. package/dist/cjs/mcp/tools/spreadsheet-find.js.map +1 -1
  43. package/dist/cjs/mcp/tools/spreadsheet-rename.js +2 -1
  44. package/dist/cjs/mcp/tools/spreadsheet-rename.js.map +1 -1
  45. package/dist/cjs/mcp/tools/validation-set.js +2 -1
  46. package/dist/cjs/mcp/tools/validation-set.js.map +1 -1
  47. package/dist/cjs/mcp/tools/values-batch-update.js +2 -1
  48. package/dist/cjs/mcp/tools/values-batch-update.js.map +1 -1
  49. package/dist/cjs/mcp/tools/values-clear.js +2 -1
  50. package/dist/cjs/mcp/tools/values-clear.js.map +1 -1
  51. package/dist/cjs/mcp/tools/values-csv-update.js +2 -1
  52. package/dist/cjs/mcp/tools/values-csv-update.js.map +1 -1
  53. package/dist/cjs/mcp/tools/values-markdown-update.js +2 -1
  54. package/dist/cjs/mcp/tools/values-markdown-update.js.map +1 -1
  55. package/dist/cjs/mcp/tools/values-replace.js +2 -1
  56. package/dist/cjs/mcp/tools/values-replace.js.map +1 -1
  57. package/dist/cjs/mcp/tools/values-search.js +2 -1
  58. package/dist/cjs/mcp/tools/values-search.js.map +1 -1
  59. package/dist/esm/lib/google-auth.d.ts +9 -0
  60. package/dist/esm/lib/google-auth.js +11 -0
  61. package/dist/esm/lib/google-auth.js.map +1 -0
  62. package/dist/esm/mcp/resources/spreadsheet.js +2 -1
  63. package/dist/esm/mcp/resources/spreadsheet.js.map +1 -1
  64. package/dist/esm/mcp/tools/cells-format.js +2 -1
  65. package/dist/esm/mcp/tools/cells-format.js.map +1 -1
  66. package/dist/esm/mcp/tools/chart-create.js +2 -1
  67. package/dist/esm/mcp/tools/chart-create.js.map +1 -1
  68. package/dist/esm/mcp/tools/columns-get.js +2 -1
  69. package/dist/esm/mcp/tools/columns-get.js.map +1 -1
  70. package/dist/esm/mcp/tools/columns-update.js +2 -1
  71. package/dist/esm/mcp/tools/columns-update.js.map +1 -1
  72. package/dist/esm/mcp/tools/dimensions-batch-update.js +2 -1
  73. package/dist/esm/mcp/tools/dimensions-batch-update.js.map +1 -1
  74. package/dist/esm/mcp/tools/dimensions-move.js +2 -1
  75. package/dist/esm/mcp/tools/dimensions-move.js.map +1 -1
  76. package/dist/esm/mcp/tools/rows-append.js +2 -1
  77. package/dist/esm/mcp/tools/rows-append.js.map +1 -1
  78. package/dist/esm/mcp/tools/rows-csv-append.js +2 -1
  79. package/dist/esm/mcp/tools/rows-csv-append.js.map +1 -1
  80. package/dist/esm/mcp/tools/rows-get.js +2 -1
  81. package/dist/esm/mcp/tools/rows-get.js.map +1 -1
  82. package/dist/esm/mcp/tools/sheet-copy-to.js +2 -1
  83. package/dist/esm/mcp/tools/sheet-copy-to.js.map +1 -1
  84. package/dist/esm/mcp/tools/sheet-copy.js +2 -1
  85. package/dist/esm/mcp/tools/sheet-copy.js.map +1 -1
  86. package/dist/esm/mcp/tools/sheet-create.js +2 -1
  87. package/dist/esm/mcp/tools/sheet-create.js.map +1 -1
  88. package/dist/esm/mcp/tools/sheet-delete.js +2 -1
  89. package/dist/esm/mcp/tools/sheet-delete.js.map +1 -1
  90. package/dist/esm/mcp/tools/sheet-find.js +2 -1
  91. package/dist/esm/mcp/tools/sheet-find.js.map +1 -1
  92. package/dist/esm/mcp/tools/sheet-rename.js +2 -1
  93. package/dist/esm/mcp/tools/sheet-rename.js.map +1 -1
  94. package/dist/esm/mcp/tools/spreadsheet-copy.js +3 -2
  95. package/dist/esm/mcp/tools/spreadsheet-copy.js.map +1 -1
  96. package/dist/esm/mcp/tools/spreadsheet-create.js +2 -1
  97. package/dist/esm/mcp/tools/spreadsheet-create.js.map +1 -1
  98. package/dist/esm/mcp/tools/spreadsheet-find.js +3 -2
  99. package/dist/esm/mcp/tools/spreadsheet-find.js.map +1 -1
  100. package/dist/esm/mcp/tools/spreadsheet-rename.js +2 -1
  101. package/dist/esm/mcp/tools/spreadsheet-rename.js.map +1 -1
  102. package/dist/esm/mcp/tools/validation-set.js +2 -1
  103. package/dist/esm/mcp/tools/validation-set.js.map +1 -1
  104. package/dist/esm/mcp/tools/values-batch-update.js +2 -1
  105. package/dist/esm/mcp/tools/values-batch-update.js.map +1 -1
  106. package/dist/esm/mcp/tools/values-clear.js +2 -1
  107. package/dist/esm/mcp/tools/values-clear.js.map +1 -1
  108. package/dist/esm/mcp/tools/values-csv-update.js +2 -1
  109. package/dist/esm/mcp/tools/values-csv-update.js.map +1 -1
  110. package/dist/esm/mcp/tools/values-markdown-update.js +2 -1
  111. package/dist/esm/mcp/tools/values-markdown-update.js.map +1 -1
  112. package/dist/esm/mcp/tools/values-replace.js +2 -1
  113. package/dist/esm/mcp/tools/values-replace.js.map +1 -1
  114. package/dist/esm/mcp/tools/values-search.js +2 -1
  115. package/dist/esm/mcp/tools/values-search.js.map +1 -1
  116. package/package.json +3 -4
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-replace.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, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { A1NotationSchema, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\nconst inputSchema = z\n .object({\n id: SpreadsheetIdSchema,\n find: z.string().min(1).describe('Text or regex pattern to find'),\n replacement: z.string().describe('Replacement text. Use $1, $2 for regex capture groups. Empty string deletes matches.'),\n\n // Scope - defaults to all sheets if neither specified\n gid: SheetGidSchema.optional().describe('Limit to specific sheet. If omitted, searches all sheets.'),\n range: A1NotationSchema.optional().describe('Limit to specific A1 range within the sheet (requires gid)'),\n\n // Match options\n matchCase: z.boolean().optional().describe('Case-sensitive matching'),\n matchEntireCell: z.boolean().optional().describe('Only match entire cell content'),\n searchByRegex: z.boolean().optional().describe('Treat find as RE2 regex'),\n includeFormulas: z.boolean().optional().describe('Search within formula text'),\n })\n .refine((data) => !(data.range && !data.gid), { message: 'range requires gid' });\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n occurrencesChanged: z.number().int().nonnegative().describe('Total replacements made'),\n valuesChanged: z.number().int().nonnegative().describe('Number of non-formula cells changed'),\n formulasChanged: z.number().int().nonnegative().describe('Number of formula cells changed'),\n rowsChanged: z.number().int().nonnegative().describe('Number of rows with replacements'),\n sheetsChanged: z.number().int().nonnegative().describe('Number of sheets with replacements'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Find and replace text across a spreadsheet. Searches all sheets by default, or limit with gid/range. Supports regex with capture groups ($1, $2).',\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, find, replacement, gid, range, matchCase, matchEntireCell, searchByRegex, includeFormulas }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.values-replace called', { id, find, replacement, gid, range });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n // Build FindReplaceRequest - only include defined options\n const findReplaceRequest: sheets_v4.Schema$FindReplaceRequest = {\n find,\n replacement,\n ...(matchCase !== undefined && { matchCase }),\n ...(matchEntireCell !== undefined && { matchEntireCell }),\n ...(searchByRegex !== undefined && { searchByRegex }),\n ...(includeFormulas !== undefined && { includeFormulas }),\n };\n\n // Set scope based on gid/range\n if (!gid) {\n // No gid = search all sheets\n findReplaceRequest.allSheets = true;\n } else {\n // Need to resolve sheet to get numeric sheetId\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet) {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n // Note: sheetId can be 0 which is falsy, so check explicitly for undefined/null\n const sheetId = sheet.properties?.sheetId;\n if (sheetId === undefined || sheetId === null) {\n throw new ProtocolError(ProtocolErrorCode.InternalError, 'Sheet properties not available');\n }\n\n if (!range) {\n // gid but no range = search specific sheet\n findReplaceRequest.sheetId = sheetId;\n } else {\n // gid + range = search specific range\n const rangeRef = parseA1Notation(range);\n findReplaceRequest.range = rangeReferenceToGridRange(rangeRef, sheetId);\n }\n }\n\n // Execute batchUpdate\n const response = await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: [{ findReplace: findReplaceRequest }],\n },\n });\n\n const findReplaceResponse = response.data.replies?.[0]?.findReplace;\n const spreadsheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit`;\n\n logger.info('sheets.values-replace completed', {\n occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n spreadsheetUrl,\n occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n valuesChanged: findReplaceResponse?.valuesChanged ?? 0,\n formulasChanged: findReplaceResponse?.formulasChanged ?? 0,\n rowsChanged: findReplaceResponse?.rowsChanged ?? 0,\n sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n if (error instanceof ProtocolError) {\n throw error;\n }\n const message = error instanceof Error ? error.message : String(error);\n logger.error('Replace operation failed', {\n id,\n find,\n replacement,\n gid,\n range,\n error: message,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error replacing values: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'values-replace',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","find","string","min","describe","replacement","gid","SheetGidSchema","optional","range","A1NotationSchema","matchCase","boolean","matchEntireCell","searchByRegex","includeFormulas","refine","data","message","successBranchSchema","type","literal","SpreadsheetIdOutput","spreadsheetUrl","occurrencesChanged","number","int","nonnegative","valuesChanged","formulasChanged","rowsChanged","sheetsChanged","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","response","sheets","findReplaceRequest","spreadsheetResponse","sheet","sheetId","rangeRef","findReplaceResponse","error","info","google","version","auth","authContext","undefined","allSheets","spreadsheets","get","spreadsheetId","fields","s","String","properties","ProtocolError","ProtocolErrorCode","InvalidParams","InternalError","parseA1Notation","rangeReferenceToGridRange","batchUpdate","requestBody","requests","findReplace","replies","content","text","JSON","stringify","structuredContent","Error","stack","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-replace.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, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { A1NotationSchema, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\nconst inputSchema = z\n .object({\n id: SpreadsheetIdSchema,\n find: z.string().min(1).describe('Text or regex pattern to find'),\n replacement: z.string().describe('Replacement text. Use $1, $2 for regex capture groups. Empty string deletes matches.'),\n\n // Scope - defaults to all sheets if neither specified\n gid: SheetGidSchema.optional().describe('Limit to specific sheet. If omitted, searches all sheets.'),\n range: A1NotationSchema.optional().describe('Limit to specific A1 range within the sheet (requires gid)'),\n\n // Match options\n matchCase: z.boolean().optional().describe('Case-sensitive matching'),\n matchEntireCell: z.boolean().optional().describe('Only match entire cell content'),\n searchByRegex: z.boolean().optional().describe('Treat find as RE2 regex'),\n includeFormulas: z.boolean().optional().describe('Search within formula text'),\n })\n .refine((data) => !(data.range && !data.gid), { message: 'range requires gid' });\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n occurrencesChanged: z.number().int().nonnegative().describe('Total replacements made'),\n valuesChanged: z.number().int().nonnegative().describe('Number of non-formula cells changed'),\n formulasChanged: z.number().int().nonnegative().describe('Number of formula cells changed'),\n rowsChanged: z.number().int().nonnegative().describe('Number of rows with replacements'),\n sheetsChanged: z.number().int().nonnegative().describe('Number of sheets with replacements'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Find and replace text across a spreadsheet. Searches all sheets by default, or limit with gid/range. Supports regex with capture groups ($1, $2).',\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, find, replacement, gid, range, matchCase, matchEntireCell, searchByRegex, includeFormulas }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.values-replace called', { id, find, replacement, gid, range });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Build FindReplaceRequest - only include defined options\n const findReplaceRequest: sheets_v4.Schema$FindReplaceRequest = {\n find,\n replacement,\n ...(matchCase !== undefined && { matchCase }),\n ...(matchEntireCell !== undefined && { matchEntireCell }),\n ...(searchByRegex !== undefined && { searchByRegex }),\n ...(includeFormulas !== undefined && { includeFormulas }),\n };\n\n // Set scope based on gid/range\n if (!gid) {\n // No gid = search all sheets\n findReplaceRequest.allSheets = true;\n } else {\n // Need to resolve sheet to get numeric sheetId\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet) {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n // Note: sheetId can be 0 which is falsy, so check explicitly for undefined/null\n const sheetId = sheet.properties?.sheetId;\n if (sheetId === undefined || sheetId === null) {\n throw new ProtocolError(ProtocolErrorCode.InternalError, 'Sheet properties not available');\n }\n\n if (!range) {\n // gid but no range = search specific sheet\n findReplaceRequest.sheetId = sheetId;\n } else {\n // gid + range = search specific range\n const rangeRef = parseA1Notation(range);\n findReplaceRequest.range = rangeReferenceToGridRange(rangeRef, sheetId);\n }\n }\n\n // Execute batchUpdate\n const response = await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: [{ findReplace: findReplaceRequest }],\n },\n });\n\n const findReplaceResponse = response.data.replies?.[0]?.findReplace;\n const spreadsheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit`;\n\n logger.info('sheets.values-replace completed', {\n occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n spreadsheetUrl,\n occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n valuesChanged: findReplaceResponse?.valuesChanged ?? 0,\n formulasChanged: findReplaceResponse?.formulasChanged ?? 0,\n rowsChanged: findReplaceResponse?.rowsChanged ?? 0,\n sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n if (error instanceof ProtocolError) {\n throw error;\n }\n const message = error instanceof Error ? error.message : String(error);\n logger.error('Replace operation failed', {\n id,\n find,\n replacement,\n gid,\n range,\n error: message,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error replacing values: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'values-replace',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","find","string","min","describe","replacement","gid","SheetGidSchema","optional","range","A1NotationSchema","matchCase","boolean","matchEntireCell","searchByRegex","includeFormulas","refine","data","message","successBranchSchema","type","literal","SpreadsheetIdOutput","spreadsheetUrl","occurrencesChanged","number","int","nonnegative","valuesChanged","formulasChanged","rowsChanged","sheetsChanged","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","response","sheets","findReplaceRequest","spreadsheetResponse","sheet","sheetId","rangeRef","findReplaceResponse","error","info","google","version","auth","googleAuth","authContext","undefined","allSheets","spreadsheets","get","spreadsheetId","fields","s","String","properties","ProtocolError","ProtocolErrorCode","InvalidParams","InternalError","parseA1Notation","rangeReferenceToGridRange","batchUpdate","requestBody","requests","findReplace","replies","content","text","JSON","stringify","structuredContent","Error","stack","name"],"mappings":"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"}
@@ -12,6 +12,7 @@ var _oauthgoogle = require("@mcp-z/oauth-google");
12
12
  var _server = require("@mcp-z/server");
13
13
  var _googleapis = require("googleapis");
14
14
  var _zod = require("zod");
15
+ var _googleauthts = require("../../lib/google-auth.js");
15
16
  var _indexts = require("../../schemas/index.js");
16
17
  function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
17
18
  try {
@@ -248,7 +249,7 @@ function handler(_0, _1) {
248
249
  ]);
249
250
  sheets = _googleapis.google.sheets({
250
251
  version: 'v4',
251
- auth: extra.authContext.auth
252
+ auth: (0, _googleauthts.googleAuth)(extra.authContext.auth)
252
253
  });
253
254
  return [
254
255
  4,
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-search.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\n// Helper to convert column index to letter (0 = A, 1 = B, etc.)\nfunction columnIndexToLetter(index: number): string {\n let letter = '';\n let num = index + 1;\n while (num > 0) {\n const remainder = (num - 1) % 26;\n letter = String.fromCharCode(65 + remainder) + letter;\n num = Math.floor((num - 1) / 26);\n }\n return letter;\n}\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n query: z.coerce.string().trim().optional().describe('Text to search for in sheet cells. If empty, returns all data at specified granularity.'),\n select: z.enum(['cells', 'rows', 'columns']).describe('Granularity: cells (individual matches), rows (full matching rows), columns (columns with matching headers)'),\n values: z.boolean().optional().describe('Include cell values in response'),\n a1s: z.boolean().optional().describe('Include A1 notation references in response'),\n render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n matchCase: z.boolean().optional().describe('Case-sensitive matching. Default is false (case-insensitive).'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n count: z.number().int().nonnegative().describe('Number of matches found'),\n a1s: z.array(z.string()).optional().describe('A1 notation references for matches (e.g., \"B5\", \"A5:D5\", \"B:B\")'),\n values: z\n .array(z.union([z.array(SheetCellSchema), SheetCellSchema]))\n .optional()\n .describe('Cell values for matches (arrays for rows/columns, single values for cells)'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Search spreadsheet and return matches at cell, row, or column granularity. Use a1-notation prompt for range syntax.',\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, query, select, values = false, a1s = false, render, matchCase = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.values-search called', { id, gid, query, select, values, a1s, render, matchCase });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n // Get sheet details including grid dimensions\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title,sheets.properties.gridProperties',\n });\n\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n\n if (!sheet) {\n logger.info('sheets.values-search sheet not found', { id, gid, query });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');\n }\n\n const sheetTitle = sheet.properties?.title ?? '';\n\n // Use actual sheet dimensions from gridProperties, with sensible defaults\n // Google Sheets default for new sheets is 1000 rows x 26 columns\n const rowCount = sheet.properties?.gridProperties?.rowCount ?? 1000;\n const columnCount = sheet.properties?.gridProperties?.columnCount ?? 26;\n const endColumn = columnIndexToLetter(columnCount - 1);\n const fullRange = `${sheetTitle}!A1:${endColumn}${rowCount}`;\n\n logger.debug?.('sheets.values-search fetching range', { fullRange, rowCount, columnCount });\n\n const response = await sheets.spreadsheets.values.get({\n spreadsheetId: id,\n range: fullRange,\n valueRenderOption: render || 'FORMATTED_VALUE',\n });\n const res = response.data;\n const allRows = Array.isArray(res.values) ? (res.values as (string | number | boolean | null)[][]) : [];\n\n // Prepare query for matching (case-insensitive by default)\n const searchQuery = query ? (matchCase ? query : query.toLowerCase()) : null;\n\n let count = 0;\n const a1Array: string[] = [];\n const valuesArray: (string | number | boolean | null | (string | number | boolean | null)[])[] = [];\n\n // Helper to check if a cell matches the query\n const cellMatches = (cell: string | number | boolean | null): boolean => {\n if (!searchQuery) return true; // If no query, match all\n if (typeof cell !== 'string') return false;\n const cellValue = matchCase ? cell : cell.toLowerCase();\n return cellValue.includes(searchQuery);\n };\n\n if (select === 'cells') {\n for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n const row = allRows[rowIdx];\n if (!row) continue;\n\n for (let colIdx = 0; colIdx < row.length; colIdx++) {\n const cell = row[colIdx];\n if (cellMatches(cell)) {\n count++;\n if (a1s) {\n const colLetter = columnIndexToLetter(colIdx);\n const rowNum = rowIdx + 1;\n a1Array.push(`${colLetter}${rowNum}`);\n }\n if (values) {\n valuesArray.push(cell ?? null);\n }\n }\n }\n }\n } else if (select === 'rows') {\n const matchingRows: number[] = [];\n for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n const row = allRows[rowIdx];\n if (!row) continue;\n\n const matches = row.some((cell) => cellMatches(cell));\n if (matches) {\n matchingRows.push(rowIdx);\n }\n }\n\n count = matchingRows.length;\n for (const rowIdx of matchingRows) {\n const row = allRows[rowIdx];\n if (!row) continue; // Skip if row is undefined\n const rowNum = rowIdx + 1;\n\n if (a1s) {\n const colEnd = columnIndexToLetter(Math.max(0, row.length - 1));\n a1Array.push(`A${rowNum}:${colEnd}${rowNum}`);\n }\n if (values) {\n valuesArray.push(row);\n }\n }\n } else if (select === 'columns') {\n const headerRow = allRows[0] || [];\n const matchingCols: number[] = [];\n\n for (let colIdx = 0; colIdx < headerRow.length; colIdx++) {\n const header = headerRow[colIdx];\n if (cellMatches(header)) {\n matchingCols.push(colIdx);\n }\n }\n\n count = matchingCols.length;\n for (const colIdx of matchingCols) {\n const colLetter = columnIndexToLetter(colIdx);\n\n if (a1s) {\n a1Array.push(`${colLetter}:${colLetter}`);\n }\n if (values) {\n const columnValues = allRows.map((row) => (row && row[colIdx] !== undefined ? row[colIdx] : null));\n valuesArray.push(columnValues);\n }\n }\n }\n\n logger.info('sheets.values-search results', { count, select, hasA1s: a1s, hasValues: values });\n\n const result: Output = {\n type: 'success' as const,\n count,\n ...(a1s && a1Array.length > 0 && { a1s: a1Array }),\n ...(values && valuesArray.length > 0 && { values: valuesArray }),\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.values-search error', { error: message });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error searching spreadsheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'values-search',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","columnIndexToLetter","index","letter","num","remainder","String","fromCharCode","Math","floor","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","query","coerce","string","trim","optional","describe","select","enum","values","boolean","a1s","render","matchCase","successBranchSchema","type","literal","count","number","int","nonnegative","array","union","SheetCellSchema","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetResponse","sheet","sheets","sheetTitle","rowCount","columnCount","endColumn","fullRange","response","res","allRows","searchQuery","a1Array","valuesArray","cellMatches","rowIdx","row","colIdx","cell","colLetter","rowNum","matchingRows","matches","colEnd","headerRow","matchingCols","header","error","message","info","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","properties","sheetId","ProtocolError","ProtocolErrorCode","InvalidParams","title","gridProperties","debug","range","valueRenderOption","Array","isArray","toLowerCase","cellValue","includes","length","push","some","max","columnValues","map","undefined","hasA1s","hasValues","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-search.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 { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\n// Helper to convert column index to letter (0 = A, 1 = B, etc.)\nfunction columnIndexToLetter(index: number): string {\n let letter = '';\n let num = index + 1;\n while (num > 0) {\n const remainder = (num - 1) % 26;\n letter = String.fromCharCode(65 + remainder) + letter;\n num = Math.floor((num - 1) / 26);\n }\n return letter;\n}\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n query: z.coerce.string().trim().optional().describe('Text to search for in sheet cells. If empty, returns all data at specified granularity.'),\n select: z.enum(['cells', 'rows', 'columns']).describe('Granularity: cells (individual matches), rows (full matching rows), columns (columns with matching headers)'),\n values: z.boolean().optional().describe('Include cell values in response'),\n a1s: z.boolean().optional().describe('Include A1 notation references in response'),\n render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n matchCase: z.boolean().optional().describe('Case-sensitive matching. Default is false (case-insensitive).'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n count: z.number().int().nonnegative().describe('Number of matches found'),\n a1s: z.array(z.string()).optional().describe('A1 notation references for matches (e.g., \"B5\", \"A5:D5\", \"B:B\")'),\n values: z\n .array(z.union([z.array(SheetCellSchema), SheetCellSchema]))\n .optional()\n .describe('Cell values for matches (arrays for rows/columns, single values for cells)'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Search spreadsheet and return matches at cell, row, or column granularity. Use a1-notation prompt for range syntax.',\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, query, select, values = false, a1s = false, render, matchCase = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.values-search called', { id, gid, query, select, values, a1s, render, matchCase });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get sheet details including grid dimensions\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title,sheets.properties.gridProperties',\n });\n\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n\n if (!sheet) {\n logger.info('sheets.values-search sheet not found', { id, gid, query });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');\n }\n\n const sheetTitle = sheet.properties?.title ?? '';\n\n // Use actual sheet dimensions from gridProperties, with sensible defaults\n // Google Sheets default for new sheets is 1000 rows x 26 columns\n const rowCount = sheet.properties?.gridProperties?.rowCount ?? 1000;\n const columnCount = sheet.properties?.gridProperties?.columnCount ?? 26;\n const endColumn = columnIndexToLetter(columnCount - 1);\n const fullRange = `${sheetTitle}!A1:${endColumn}${rowCount}`;\n\n logger.debug?.('sheets.values-search fetching range', { fullRange, rowCount, columnCount });\n\n const response = await sheets.spreadsheets.values.get({\n spreadsheetId: id,\n range: fullRange,\n valueRenderOption: render || 'FORMATTED_VALUE',\n });\n const res = response.data;\n const allRows = Array.isArray(res.values) ? (res.values as (string | number | boolean | null)[][]) : [];\n\n // Prepare query for matching (case-insensitive by default)\n const searchQuery = query ? (matchCase ? query : query.toLowerCase()) : null;\n\n let count = 0;\n const a1Array: string[] = [];\n const valuesArray: (string | number | boolean | null | (string | number | boolean | null)[])[] = [];\n\n // Helper to check if a cell matches the query\n const cellMatches = (cell: string | number | boolean | null): boolean => {\n if (!searchQuery) return true; // If no query, match all\n if (typeof cell !== 'string') return false;\n const cellValue = matchCase ? cell : cell.toLowerCase();\n return cellValue.includes(searchQuery);\n };\n\n if (select === 'cells') {\n for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n const row = allRows[rowIdx];\n if (!row) continue;\n\n for (let colIdx = 0; colIdx < row.length; colIdx++) {\n const cell = row[colIdx];\n if (cellMatches(cell)) {\n count++;\n if (a1s) {\n const colLetter = columnIndexToLetter(colIdx);\n const rowNum = rowIdx + 1;\n a1Array.push(`${colLetter}${rowNum}`);\n }\n if (values) {\n valuesArray.push(cell ?? null);\n }\n }\n }\n }\n } else if (select === 'rows') {\n const matchingRows: number[] = [];\n for (let rowIdx = 0; rowIdx < allRows.length; rowIdx++) {\n const row = allRows[rowIdx];\n if (!row) continue;\n\n const matches = row.some((cell) => cellMatches(cell));\n if (matches) {\n matchingRows.push(rowIdx);\n }\n }\n\n count = matchingRows.length;\n for (const rowIdx of matchingRows) {\n const row = allRows[rowIdx];\n if (!row) continue; // Skip if row is undefined\n const rowNum = rowIdx + 1;\n\n if (a1s) {\n const colEnd = columnIndexToLetter(Math.max(0, row.length - 1));\n a1Array.push(`A${rowNum}:${colEnd}${rowNum}`);\n }\n if (values) {\n valuesArray.push(row);\n }\n }\n } else if (select === 'columns') {\n const headerRow = allRows[0] || [];\n const matchingCols: number[] = [];\n\n for (let colIdx = 0; colIdx < headerRow.length; colIdx++) {\n const header = headerRow[colIdx];\n if (cellMatches(header)) {\n matchingCols.push(colIdx);\n }\n }\n\n count = matchingCols.length;\n for (const colIdx of matchingCols) {\n const colLetter = columnIndexToLetter(colIdx);\n\n if (a1s) {\n a1Array.push(`${colLetter}:${colLetter}`);\n }\n if (values) {\n const columnValues = allRows.map((row) => (row && row[colIdx] !== undefined ? row[colIdx] : null));\n valuesArray.push(columnValues);\n }\n }\n }\n\n logger.info('sheets.values-search results', { count, select, hasA1s: a1s, hasValues: values });\n\n const result: Output = {\n type: 'success' as const,\n count,\n ...(a1s && a1Array.length > 0 && { a1s: a1Array }),\n ...(values && valuesArray.length > 0 && { values: valuesArray }),\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.values-search error', { error: message });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error searching spreadsheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'values-search',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","columnIndexToLetter","index","letter","num","remainder","String","fromCharCode","Math","floor","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","query","coerce","string","trim","optional","describe","select","enum","values","boolean","a1s","render","matchCase","successBranchSchema","type","literal","count","number","int","nonnegative","array","union","SheetCellSchema","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetResponse","sheet","sheets","sheetTitle","rowCount","columnCount","endColumn","fullRange","response","res","allRows","searchQuery","a1Array","valuesArray","cellMatches","rowIdx","row","colIdx","cell","colLetter","rowNum","matchingRows","matches","colEnd","headerRow","matchingCols","header","error","message","info","google","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","properties","sheetId","ProtocolError","ProtocolErrorCode","InvalidParams","title","gridProperties","debug","range","valueRenderOption","Array","isArray","toLowerCase","cellValue","includes","length","push","some","max","columnValues","map","undefined","hasA1s","hasValues","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","name"],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ import { type GoogleAuthProvider } from '@mcp-z/oauth-google';
2
+ /**
3
+ * A Google API client bound to this request's token provider.
4
+ *
5
+ * `@mcp-z/oauth-google` mints tokens and depends on no Google SDK, so the client
6
+ * is built here, from this package's own `googleapis`. That keeps one copy of
7
+ * `google-auth-library` in the tree by construction rather than by matching pins.
8
+ */
9
+ export declare function googleAuth(auth: GoogleAuthProvider): import("google-auth-library").OAuth2Client;
@@ -0,0 +1,11 @@
1
+ import { attachTokenProvider } from '@mcp-z/oauth-google';
2
+ import { google } from 'googleapis';
3
+ /**
4
+ * A Google API client bound to this request's token provider.
5
+ *
6
+ * `@mcp-z/oauth-google` mints tokens and depends on no Google SDK, so the client
7
+ * is built here, from this package's own `googleapis`. That keeps one copy of
8
+ * `google-auth-library` in the tree by construction rather than by matching pins.
9
+ */ export function googleAuth(auth) {
10
+ return attachTokenProvider(new google.auth.OAuth2(), auth);
11
+ }
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/lib/google-auth.ts"],"sourcesContent":["import { attachTokenProvider, type GoogleAuthProvider } from '@mcp-z/oauth-google';\nimport { google } from 'googleapis';\n\n/**\n * A Google API client bound to this request's token provider.\n *\n * `@mcp-z/oauth-google` mints tokens and depends on no Google SDK, so the client\n * is built here, from this package's own `googleapis`. That keeps one copy of\n * `google-auth-library` in the tree by construction rather than by matching pins.\n */\nexport function googleAuth(auth: GoogleAuthProvider) {\n return attachTokenProvider(new google.auth.OAuth2(), auth);\n}\n"],"names":["attachTokenProvider","google","googleAuth","auth","OAuth2"],"mappings":"AAAA,SAASA,mBAAmB,QAAiC,sBAAsB;AACnF,SAASC,MAAM,QAAQ,aAAa;AAEpC;;;;;;CAMC,GACD,OAAO,SAASC,WAAWC,IAAwB;IACjD,OAAOH,oBAAoB,IAAIC,OAAOE,IAAI,CAACC,MAAM,IAAID;AACvD"}
@@ -1,5 +1,6 @@
1
1
  import { ResourceTemplate } from '@mcp-z/server';
2
2
  import { google } from 'googleapis';
3
+ import { googleAuth } from '../../lib/google-auth.js';
3
4
  export default function createResource() {
4
5
  const template = new ResourceTemplate('sheets://spreadsheets/{spreadsheetId}', {
5
6
  list: undefined
@@ -29,7 +30,7 @@ export default function createResource() {
29
30
  const { logger, authContext } = extra;
30
31
  const sheets = google.sheets({
31
32
  version: 'v4',
32
- auth: authContext.auth
33
+ auth: googleAuth(authContext.auth)
33
34
  });
34
35
  const resp = await sheets.spreadsheets.get({
35
36
  spreadsheetId,
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/resources/spreadsheet.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport type { ReadResourceResult, ResourceConfig, ResourceModule, ServerContext } from '@mcp-z/server';\nimport { ResourceTemplate } from '@mcp-z/server';\nimport { google, type sheets_v4 } from 'googleapis';\nimport type { GoogleApiError } from '../../types.ts';\n\nexport default function createResource(): ResourceModule {\n const template = new ResourceTemplate('sheets://spreadsheets/{spreadsheetId}', { list: undefined });\n const config: ResourceConfig = {\n description: 'Sheets spreadsheet resource',\n mimeType: 'application/json',\n };\n\n const handler = async (uri: URL, variables: Record<string, string | string[]>, extra: ServerContext): Promise<ReadResourceResult> => {\n const spreadsheetId = Array.isArray(variables.spreadsheetId) ? variables.spreadsheetId[0] : variables.spreadsheetId;\n\n if (!spreadsheetId) {\n return {\n contents: [\n {\n uri: uri.href,\n mimeType: 'application/json',\n text: JSON.stringify({ error: 'spreadsheetId is required' }),\n },\n ],\n };\n }\n\n try {\n // Safe type guard to access middleware-enriched extra\n const { logger, authContext } = extra as unknown as EnrichedExtra;\n const sheets = google.sheets({ version: 'v4', auth: authContext.auth });\n const resp = await sheets.spreadsheets.get({\n spreadsheetId,\n fields: 'spreadsheetId,properties.title,sheets.properties',\n });\n const data = resp.data as sheets_v4.Schema$Spreadsheet;\n logger.info('sheets-spreadsheet resource fetch success', {\n spreadsheetId: data.spreadsheetId,\n title: data?.properties?.title,\n sheetCount: (data?.sheets || []).length,\n });\n return {\n contents: [\n {\n uri: uri.href,\n mimeType: 'application/json',\n text: JSON.stringify({\n id: data?.spreadsheetId,\n title: data?.properties?.title,\n sheets: (data?.sheets || []).map((s) => ({\n id: s?.properties?.sheetId,\n title: s?.properties?.title,\n rowCount: s?.properties?.gridProperties?.rowCount,\n columnCount: s?.properties?.gridProperties?.columnCount,\n })),\n }),\n },\n ],\n };\n } catch (error) {\n const { logger } = extra as unknown as EnrichedExtra;\n logger.info('sheets-spreadsheet resource fetch failed', error as Record<string, unknown>);\n return {\n contents: [\n {\n uri: uri.href,\n mimeType: 'application/json',\n text: JSON.stringify({\n error: String((error as GoogleApiError)?.message ?? error),\n }),\n },\n ],\n };\n }\n };\n\n return {\n name: 'spreadsheet',\n template,\n config,\n handler,\n };\n}\n"],"names":["ResourceTemplate","google","createResource","template","list","undefined","config","description","mimeType","handler","uri","variables","extra","spreadsheetId","Array","isArray","contents","href","text","JSON","stringify","error","data","logger","authContext","sheets","version","auth","resp","spreadsheets","get","fields","info","title","properties","sheetCount","length","id","map","s","sheetId","rowCount","gridProperties","columnCount","String","message","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/resources/spreadsheet.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport type { ReadResourceResult, ResourceConfig, ResourceModule, ServerContext } from '@mcp-z/server';\nimport { ResourceTemplate } from '@mcp-z/server';\nimport { google, type sheets_v4 } from 'googleapis';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport type { GoogleApiError } from '../../types.ts';\n\nexport default function createResource(): ResourceModule {\n const template = new ResourceTemplate('sheets://spreadsheets/{spreadsheetId}', { list: undefined });\n const config: ResourceConfig = {\n description: 'Sheets spreadsheet resource',\n mimeType: 'application/json',\n };\n\n const handler = async (uri: URL, variables: Record<string, string | string[]>, extra: ServerContext): Promise<ReadResourceResult> => {\n const spreadsheetId = Array.isArray(variables.spreadsheetId) ? variables.spreadsheetId[0] : variables.spreadsheetId;\n\n if (!spreadsheetId) {\n return {\n contents: [\n {\n uri: uri.href,\n mimeType: 'application/json',\n text: JSON.stringify({ error: 'spreadsheetId is required' }),\n },\n ],\n };\n }\n\n try {\n // Safe type guard to access middleware-enriched extra\n const { logger, authContext } = extra as unknown as EnrichedExtra;\n const sheets = google.sheets({ version: 'v4', auth: googleAuth(authContext.auth) });\n const resp = await sheets.spreadsheets.get({\n spreadsheetId,\n fields: 'spreadsheetId,properties.title,sheets.properties',\n });\n const data = resp.data as sheets_v4.Schema$Spreadsheet;\n logger.info('sheets-spreadsheet resource fetch success', {\n spreadsheetId: data.spreadsheetId,\n title: data?.properties?.title,\n sheetCount: (data?.sheets || []).length,\n });\n return {\n contents: [\n {\n uri: uri.href,\n mimeType: 'application/json',\n text: JSON.stringify({\n id: data?.spreadsheetId,\n title: data?.properties?.title,\n sheets: (data?.sheets || []).map((s) => ({\n id: s?.properties?.sheetId,\n title: s?.properties?.title,\n rowCount: s?.properties?.gridProperties?.rowCount,\n columnCount: s?.properties?.gridProperties?.columnCount,\n })),\n }),\n },\n ],\n };\n } catch (error) {\n const { logger } = extra as unknown as EnrichedExtra;\n logger.info('sheets-spreadsheet resource fetch failed', error as Record<string, unknown>);\n return {\n contents: [\n {\n uri: uri.href,\n mimeType: 'application/json',\n text: JSON.stringify({\n error: String((error as GoogleApiError)?.message ?? error),\n }),\n },\n ],\n };\n }\n };\n\n return {\n name: 'spreadsheet',\n template,\n config,\n handler,\n };\n}\n"],"names":["ResourceTemplate","google","googleAuth","createResource","template","list","undefined","config","description","mimeType","handler","uri","variables","extra","spreadsheetId","Array","isArray","contents","href","text","JSON","stringify","error","data","logger","authContext","sheets","version","auth","resp","spreadsheets","get","fields","info","title","properties","sheetCount","length","id","map","s","sheetId","rowCount","gridProperties","columnCount","String","message","name"],"mappings":"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"}
@@ -3,6 +3,7 @@ const { AuthRequiredBranchSchema } = schemas;
3
3
  import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
4
4
  import { google } from 'googleapis';
5
5
  import { z } from 'zod';
6
+ import { googleAuth } from '../../lib/google-auth.js';
6
7
  import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
7
8
  import { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.js';
8
9
  // RGB color schema (0-1 range for Google Sheets API)
@@ -87,7 +88,7 @@ async function handler({ id, gid, requests }, extra) {
87
88
  var _spreadsheetResponse_data_sheets;
88
89
  const sheets = google.sheets({
89
90
  version: 'v4',
90
- auth: extra.authContext.auth
91
+ auth: googleAuth(extra.authContext.auth)
91
92
  });
92
93
  // Get spreadsheet and sheet info in single API call
93
94
  const spreadsheetResponse = await sheets.spreadsheets.get({
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-format.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, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// RGB color schema (0-1 range for Google Sheets API)\nconst ColorSchema = z.object({\n red: z.number().min(0).max(1).describe('Red component (0-1)'),\n green: z.number().min(0).max(1).describe('Green component (0-1)'),\n blue: z.number().min(0).max(1).describe('Blue component (0-1)'),\n});\n\n// Number format schema\nconst NumberFormatSchema = z.object({\n type: z.enum(['TEXT', 'NUMBER', 'PERCENT', 'CURRENCY', 'DATE', 'TIME']).describe('Number format type'),\n pattern: z.string().optional().describe('Custom format pattern (e.g., \"$#,##0.00\" for currency)'),\n});\n\n// Border schema\nconst BorderSchema = z.object({\n style: z.enum(['SOLID', 'DASHED', 'DOTTED']).describe('Border line style'),\n color: ColorSchema.describe('Border color'),\n});\n\n// Input schema for format requests\nconst FormatRequestSchema = z.object({\n range: z.string().min(1).describe('A1 notation range to format (e.g., \"A1:D10\", \"B:B\", \"5:5\")'),\n backgroundColor: ColorSchema.optional().describe('Cell background color'),\n textColor: ColorSchema.optional().describe('Text color'),\n bold: z.boolean().optional().describe('Bold text'),\n fontSize: z.number().int().min(6).max(36).optional().describe('Font size in points'),\n horizontalAlignment: z.enum(['LEFT', 'CENTER', 'RIGHT']).optional().describe('Horizontal text alignment'),\n numberFormat: NumberFormatSchema.optional().describe('Number format pattern'),\n borders: BorderSchema.optional().describe('Cell borders'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n requests: z.array(FormatRequestSchema).min(1).max(50).describe('Array of formatting requests. Batch multiple ranges for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Title of the formatted sheet'),\n sheetUrl: z.string().describe('URL of the formatted sheet'),\n successCount: z.number().int().nonnegative().describe('Number of format requests successfully applied'),\n failedRanges: z\n .array(\n z.object({\n range: z.string().describe('A1 notation of range that failed'),\n error: z.string().describe('Why formatting failed for this range'),\n })\n )\n .optional()\n .describe('Only populated if some ranges failed to format'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets.',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.cells.format called', {\n id,\n gid,\n requestCount: requests.length,\n });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n // Find sheet by gid\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.info('Sheet not found for format cells', { id, gid, requestCount: requests.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n const sheetId = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n // Build batch update requests\n const batchRequests: sheets_v4.Schema$Request[] = [];\n const failedRanges: Array<{ range: string; error: string }> = [];\n\n for (const request of requests) {\n try {\n // Parse A1 notation to range reference\n const rangeRef = parseA1Notation(request.range);\n\n // Build grid range from range reference using helper function\n const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n // Build cell format object\n const cellFormat: {\n backgroundColor?: sheets_v4.Schema$Color;\n textFormat?: sheets_v4.Schema$TextFormat;\n horizontalAlignment?: string;\n numberFormat?: sheets_v4.Schema$NumberFormat;\n } = {};\n const fields: string[] = [];\n\n // Background color\n if (request.backgroundColor) {\n cellFormat.backgroundColor = request.backgroundColor;\n fields.push('backgroundColor');\n }\n\n // Text format\n if (request.textColor || request.bold !== undefined || request.fontSize !== undefined) {\n cellFormat.textFormat = {};\n if (request.textColor) {\n cellFormat.textFormat.foregroundColor = request.textColor;\n fields.push('textFormat.foregroundColor');\n }\n if (request.bold !== undefined) {\n cellFormat.textFormat.bold = request.bold;\n fields.push('textFormat.bold');\n }\n if (request.fontSize !== undefined) {\n cellFormat.textFormat.fontSize = request.fontSize;\n fields.push('textFormat.fontSize');\n }\n }\n\n // Horizontal alignment\n if (request.horizontalAlignment) {\n cellFormat.horizontalAlignment = request.horizontalAlignment;\n fields.push('horizontalAlignment');\n }\n\n // Number format\n if (request.numberFormat) {\n const numberFormat: sheets_v4.Schema$NumberFormat = {\n type: request.numberFormat.type,\n };\n if (request.numberFormat.pattern !== undefined) {\n numberFormat.pattern = request.numberFormat.pattern;\n }\n cellFormat.numberFormat = numberFormat;\n fields.push('numberFormat');\n }\n\n // Add repeatCell request for this range\n if (fields.length > 0) {\n batchRequests.push({\n repeatCell: {\n range: gridRange,\n cell: {\n userEnteredFormat: cellFormat,\n },\n fields: `userEnteredFormat(${fields.join(',')})`,\n },\n });\n }\n\n // Add border formatting if specified\n if (request.borders) {\n batchRequests.push({\n updateBorders: {\n range: gridRange,\n top: {\n style: request.borders.style,\n color: request.borders.color,\n },\n bottom: {\n style: request.borders.style,\n color: request.borders.color,\n },\n left: {\n style: request.borders.style,\n color: request.borders.color,\n },\n right: {\n style: request.borders.style,\n color: request.borders.color,\n },\n },\n });\n }\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to parse range for formatting', {\n range: request.range,\n error: message,\n });\n failedRanges.push({\n range: request.range,\n error: `Failed to parse range: ${message}`,\n });\n }\n }\n\n // Early return if all ranges failed\n if (batchRequests.length === 0) {\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: 0,\n failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.info('sheets.cells.format executing batch request', {\n spreadsheetId: id,\n sheetTitle,\n batchRequestsCount: batchRequests.length,\n });\n\n // Execute the batch update\n await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: batchRequests,\n },\n });\n\n logger.info('sheets.cells.format completed successfully', {\n successCount: requests.length - failedRanges.length,\n failedCount: failedRanges.length,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: requests.length - failedRanges.length,\n failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\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('Format cells operation failed', {\n id,\n gid,\n requestCount: requests.length,\n error: message,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error formatting cells: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'cells-format',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ColorSchema","object","red","number","min","max","describe","green","blue","NumberFormatSchema","type","enum","pattern","string","optional","BorderSchema","style","color","FormatRequestSchema","range","backgroundColor","textColor","bold","boolean","fontSize","int","horizontalAlignment","numberFormat","borders","inputSchema","id","gid","requests","array","successBranchSchema","literal","sheetTitle","sheetUrl","successCount","nonnegative","failedRanges","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","requestCount","length","sheet","spreadsheetResponse","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","batchRequests","request","rangeRef","gridRange","cellFormat","push","undefined","textFormat","foregroundColor","repeatCell","cell","userEnteredFormat","join","updateBorders","top","bottom","left","right","message","Error","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-format.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, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// RGB color schema (0-1 range for Google Sheets API)\nconst ColorSchema = z.object({\n red: z.number().min(0).max(1).describe('Red component (0-1)'),\n green: z.number().min(0).max(1).describe('Green component (0-1)'),\n blue: z.number().min(0).max(1).describe('Blue component (0-1)'),\n});\n\n// Number format schema\nconst NumberFormatSchema = z.object({\n type: z.enum(['TEXT', 'NUMBER', 'PERCENT', 'CURRENCY', 'DATE', 'TIME']).describe('Number format type'),\n pattern: z.string().optional().describe('Custom format pattern (e.g., \"$#,##0.00\" for currency)'),\n});\n\n// Border schema\nconst BorderSchema = z.object({\n style: z.enum(['SOLID', 'DASHED', 'DOTTED']).describe('Border line style'),\n color: ColorSchema.describe('Border color'),\n});\n\n// Input schema for format requests\nconst FormatRequestSchema = z.object({\n range: z.string().min(1).describe('A1 notation range to format (e.g., \"A1:D10\", \"B:B\", \"5:5\")'),\n backgroundColor: ColorSchema.optional().describe('Cell background color'),\n textColor: ColorSchema.optional().describe('Text color'),\n bold: z.boolean().optional().describe('Bold text'),\n fontSize: z.number().int().min(6).max(36).optional().describe('Font size in points'),\n horizontalAlignment: z.enum(['LEFT', 'CENTER', 'RIGHT']).optional().describe('Horizontal text alignment'),\n numberFormat: NumberFormatSchema.optional().describe('Number format pattern'),\n borders: BorderSchema.optional().describe('Cell borders'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n requests: z.array(FormatRequestSchema).min(1).max(50).describe('Array of formatting requests. Batch multiple ranges for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Title of the formatted sheet'),\n sheetUrl: z.string().describe('URL of the formatted sheet'),\n successCount: z.number().int().nonnegative().describe('Number of format requests successfully applied'),\n failedRanges: z\n .array(\n z.object({\n range: z.string().describe('A1 notation of range that failed'),\n error: z.string().describe('Why formatting failed for this range'),\n })\n )\n .optional()\n .describe('Only populated if some ranges failed to format'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets.',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.cells.format called', {\n id,\n gid,\n requestCount: requests.length,\n });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n // Find sheet by gid\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.info('Sheet not found for format cells', { id, gid, requestCount: requests.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n const sheetId = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n // Build batch update requests\n const batchRequests: sheets_v4.Schema$Request[] = [];\n const failedRanges: Array<{ range: string; error: string }> = [];\n\n for (const request of requests) {\n try {\n // Parse A1 notation to range reference\n const rangeRef = parseA1Notation(request.range);\n\n // Build grid range from range reference using helper function\n const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n // Build cell format object\n const cellFormat: {\n backgroundColor?: sheets_v4.Schema$Color;\n textFormat?: sheets_v4.Schema$TextFormat;\n horizontalAlignment?: string;\n numberFormat?: sheets_v4.Schema$NumberFormat;\n } = {};\n const fields: string[] = [];\n\n // Background color\n if (request.backgroundColor) {\n cellFormat.backgroundColor = request.backgroundColor;\n fields.push('backgroundColor');\n }\n\n // Text format\n if (request.textColor || request.bold !== undefined || request.fontSize !== undefined) {\n cellFormat.textFormat = {};\n if (request.textColor) {\n cellFormat.textFormat.foregroundColor = request.textColor;\n fields.push('textFormat.foregroundColor');\n }\n if (request.bold !== undefined) {\n cellFormat.textFormat.bold = request.bold;\n fields.push('textFormat.bold');\n }\n if (request.fontSize !== undefined) {\n cellFormat.textFormat.fontSize = request.fontSize;\n fields.push('textFormat.fontSize');\n }\n }\n\n // Horizontal alignment\n if (request.horizontalAlignment) {\n cellFormat.horizontalAlignment = request.horizontalAlignment;\n fields.push('horizontalAlignment');\n }\n\n // Number format\n if (request.numberFormat) {\n const numberFormat: sheets_v4.Schema$NumberFormat = {\n type: request.numberFormat.type,\n };\n if (request.numberFormat.pattern !== undefined) {\n numberFormat.pattern = request.numberFormat.pattern;\n }\n cellFormat.numberFormat = numberFormat;\n fields.push('numberFormat');\n }\n\n // Add repeatCell request for this range\n if (fields.length > 0) {\n batchRequests.push({\n repeatCell: {\n range: gridRange,\n cell: {\n userEnteredFormat: cellFormat,\n },\n fields: `userEnteredFormat(${fields.join(',')})`,\n },\n });\n }\n\n // Add border formatting if specified\n if (request.borders) {\n batchRequests.push({\n updateBorders: {\n range: gridRange,\n top: {\n style: request.borders.style,\n color: request.borders.color,\n },\n bottom: {\n style: request.borders.style,\n color: request.borders.color,\n },\n left: {\n style: request.borders.style,\n color: request.borders.color,\n },\n right: {\n style: request.borders.style,\n color: request.borders.color,\n },\n },\n });\n }\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to parse range for formatting', {\n range: request.range,\n error: message,\n });\n failedRanges.push({\n range: request.range,\n error: `Failed to parse range: ${message}`,\n });\n }\n }\n\n // Early return if all ranges failed\n if (batchRequests.length === 0) {\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: 0,\n failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.info('sheets.cells.format executing batch request', {\n spreadsheetId: id,\n sheetTitle,\n batchRequestsCount: batchRequests.length,\n });\n\n // Execute the batch update\n await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: batchRequests,\n },\n });\n\n logger.info('sheets.cells.format completed successfully', {\n successCount: requests.length - failedRanges.length,\n failedCount: failedRanges.length,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n successCount: requests.length - failedRanges.length,\n failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\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('Format cells operation failed', {\n id,\n gid,\n requestCount: requests.length,\n error: message,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error formatting cells: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'cells-format',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ColorSchema","object","red","number","min","max","describe","green","blue","NumberFormatSchema","type","enum","pattern","string","optional","BorderSchema","style","color","FormatRequestSchema","range","backgroundColor","textColor","bold","boolean","fontSize","int","horizontalAlignment","numberFormat","borders","inputSchema","id","gid","requests","array","successBranchSchema","literal","sheetTitle","sheetUrl","successCount","nonnegative","failedRanges","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","requestCount","length","sheet","spreadsheetResponse","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","batchRequests","request","rangeRef","gridRange","cellFormat","push","undefined","textFormat","foregroundColor","repeatCell","cell","userEnteredFormat","join","updateBorders","top","bottom","left","right","message","Error","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","createTool","name"],"mappings":"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"}
@@ -3,6 +3,7 @@ const { AuthRequiredBranchSchema } = schemas;
3
3
  import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
4
4
  import { google } from 'googleapis';
5
5
  import { z } from 'zod';
6
+ import { googleAuth } from '../../lib/google-auth.js';
6
7
  import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
7
8
  import { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.js';
8
9
  // Input schema for chart position
@@ -93,7 +94,7 @@ async function handler({ id, gid, chartType, dataRange, title, position, legend
93
94
  var _spreadsheetResponse_data_sheets, _replies__addChart_chart, _replies__addChart, _replies_;
94
95
  const sheets = google.sheets({
95
96
  version: 'v4',
96
- auth: extra.authContext.auth
97
+ auth: googleAuth(extra.authContext.auth)
97
98
  });
98
99
  // Get spreadsheet and sheet info in single API call
99
100
  const spreadsheetResponse = await sheets.spreadsheets.get({
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/chart-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, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// Input schema for chart position\nconst ChartPositionSchema = z.object({\n anchorCell: z.string().min(1).describe('A1 notation cell where chart top-left anchors (e.g., \"F2\")'),\n offsetX: z.number().int().default(0).describe('Horizontal pixel offset from anchor'),\n offsetY: z.number().int().default(0).describe('Vertical pixel offset from anchor'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n chartType: z.enum(['PIE', 'BAR', 'COLUMN', 'LINE']).describe('Type of chart to create'),\n dataRange: z.string().min(1).describe('A1 notation range containing chart data including headers (e.g., \"A1:C10\")'),\n title: z.string().optional().describe('Chart title displayed at top'),\n position: ChartPositionSchema,\n legend: z.enum(['BOTTOM', 'RIGHT', 'TOP', 'LEFT', 'NONE']).default('BOTTOM').describe('Legend position'),\n is3D: z.boolean().default(false).describe('Render as 3D chart (PIE only)'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Title of the sheet containing the chart'),\n sheetUrl: z.string().describe('URL of the sheet containing the chart'),\n chartId: z.number().int().describe('Unique chart ID for future updates/deletion'),\n anchorCell: z.string().describe('Where chart was anchored'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Create charts (pie, bar, column, line) from spreadsheet data ranges. Charts anchor to specific cells with optional pixel offsets. Data range should include headers. PIE charts use 2 columns (labels, values). BAR/COLUMN/LINE charts use first row as headers. Best for visualizing spreadsheet data.',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n// Parse A1 notation anchor cell to row/column indices\nfunction parseAnchorCell(anchorCell: string): { rowIndex: number; columnIndex: number } {\n // Simple A1 notation parser for single cells\n const match = anchorCell.match(/^([A-Z]+)(\\d+)$/);\n if (!match || !match[1] || !match[2]) {\n throw new Error(`Invalid anchor cell format: ${anchorCell}`);\n }\n\n const colLetters = match[1];\n const rowNumber = match[2];\n\n // Convert column letters to index (A=0, B=1, ..., Z=25, AA=26, etc.)\n let columnIndex = 0;\n for (let i = 0; i < colLetters.length; i++) {\n columnIndex = columnIndex * 26 + (colLetters.charCodeAt(i) - 65 + 1);\n }\n columnIndex--; // Convert to 0-based\n\n // Convert row number to index (1-based to 0-based)\n const rowIndex = Number.parseInt(rowNumber, 10) - 1;\n\n return { rowIndex, columnIndex };\n}\n\nasync function handler({ id, gid, chartType, dataRange, title, position, legend = 'BOTTOM', is3D = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.chart.create called', {\n id,\n gid,\n chartType,\n dataRange,\n title,\n position,\n legend,\n is3D,\n });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n // Find sheet by gid\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.info('Sheet not found for chart create', { id, gid, chartType });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n const sheetId = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n // Validate 3D only for PIE charts\n // Note: Google Sheets API only supports 3D for PIE charts, not COLUMN/BAR/LINE\n if (is3D && chartType !== 'PIE') {\n logger.info('3D mode not supported for this chart type', {\n chartType,\n is3D,\n });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `3D mode is only supported for PIE charts, not ${chartType}`);\n }\n\n // Parse anchor cell to row/column indices\n let anchorRowIndex: number;\n let anchorColumnIndex: number;\n try {\n const anchorIndices = parseAnchorCell(position.anchorCell);\n anchorRowIndex = anchorIndices.rowIndex;\n anchorColumnIndex = anchorIndices.columnIndex;\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to parse anchor cell', {\n anchorCell: position.anchorCell,\n error: message,\n });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Failed to parse anchor cell: ${message}`);\n }\n\n // Parse data range to grid range\n let dataGridRange: sheets_v4.Schema$GridRange;\n try {\n const rangeRef = parseA1Notation(dataRange);\n dataGridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n // Validate that required properties are defined for chart creation\n if (dataGridRange.startColumnIndex === undefined || dataGridRange.startColumnIndex === null) {\n throw new Error('Data range must include column information');\n }\n if (dataGridRange.endColumnIndex === undefined || dataGridRange.endColumnIndex === null) {\n throw new Error('Data range must include column information');\n }\n if (dataGridRange.startRowIndex === undefined || dataGridRange.startRowIndex === null) {\n throw new Error('Data range must include row information');\n }\n if (dataGridRange.endRowIndex === undefined || dataGridRange.endRowIndex === null) {\n throw new Error('Data range must include row information');\n }\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to parse data range', {\n dataRange,\n error: message,\n });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Failed to parse data range: ${message}`);\n }\n\n // Extract validated properties with defined types\n const dataStartRowIndex = dataGridRange.startRowIndex as number;\n const dataEndRowIndex = dataGridRange.endRowIndex as number;\n const dataStartColumnIndex = dataGridRange.startColumnIndex as number;\n const dataEndColumnIndex = dataGridRange.endColumnIndex as number;\n const dataSheetId = dataGridRange.sheetId ?? sheetId;\n\n // Build chart spec with properly split domain and series ranges\n let chartSpec: sheets_v4.Schema$ChartSpec;\n\n logger.info('Building chart spec', {\n chartType,\n dataGridRange,\n sheetId,\n });\n\n // Map legend position to API format (add _LEGEND suffix)\n const legendPositionMap: Record<string, string> = {\n BOTTOM: 'BOTTOM_LEGEND',\n RIGHT: 'RIGHT_LEGEND',\n TOP: 'TOP_LEGEND',\n LEFT: 'LEFT_LEGEND',\n NONE: 'NO_LEGEND',\n };\n const apiLegendPosition = legendPositionMap[legend] || 'BOTTOM_LEGEND';\n\n if (chartType === 'PIE') {\n // PIE charts use a separate pieChart property, not basicChart\n const baseSheetId = dataSheetId;\n\n const domainRange = {\n sheetId: baseSheetId,\n startRowIndex: dataStartRowIndex,\n endRowIndex: dataEndRowIndex,\n startColumnIndex: dataStartColumnIndex,\n endColumnIndex: dataStartColumnIndex + 1, // First column only (labels)\n };\n\n const seriesRange = {\n sheetId: baseSheetId,\n startRowIndex: dataStartRowIndex,\n endRowIndex: dataEndRowIndex,\n startColumnIndex: dataStartColumnIndex + 1, // Second column (values)\n endColumnIndex: dataStartColumnIndex + 2,\n };\n\n logger.info('PIE chart ranges', {\n dataGridRange,\n domainRange,\n seriesRange,\n apiLegendPosition,\n });\n\n chartSpec = {\n pieChart: {\n // Use pieChart for PIE charts\n legendPosition: legend === 'NONE' ? 'NO_LEGEND' : apiLegendPosition,\n domain: {\n // Note: domain/series are direct objects, not arrays\n sourceRange: {\n sources: [domainRange],\n },\n },\n series: {\n sourceRange: {\n sources: [seriesRange],\n },\n },\n threeDimensional: is3D, // 3D is directly on pieChart\n },\n };\n if (title) {\n chartSpec.title = title;\n }\n } else {\n // For BAR, COLUMN, LINE charts: domain is first column, each subsequent column is a series\n const baseSheetId = dataSheetId;\n\n const domainRange = {\n sheetId: baseSheetId,\n startRowIndex: dataStartRowIndex,\n endRowIndex: dataEndRowIndex,\n startColumnIndex: dataStartColumnIndex,\n endColumnIndex: dataStartColumnIndex + 1, // First column only\n };\n\n // Calculate number of data columns (excluding the first domain column)\n const numDataColumns = dataEndColumnIndex - dataStartColumnIndex - 1;\n const series = [];\n\n // Create a series for each data column\n for (let i = 0; i < numDataColumns; i++) {\n const seriesRange = {\n sheetId: baseSheetId,\n startRowIndex: dataStartRowIndex,\n endRowIndex: dataEndRowIndex,\n startColumnIndex: dataStartColumnIndex + 1 + i,\n endColumnIndex: dataStartColumnIndex + 2 + i,\n };\n\n series.push({\n series: {\n sourceRange: {\n sources: [seriesRange],\n },\n },\n });\n }\n\n // If no data columns were found, default to using the entire range as a fallback\n if (series.length === 0) {\n series.push({\n series: {\n sourceRange: {\n sources: [dataGridRange],\n },\n },\n });\n }\n\n const basicChart: sheets_v4.Schema$BasicChartSpec = {\n chartType, // BAR, COLUMN, LINE are valid for basicChart\n headerCount: 1, // First row is headers\n // Note: Google Sheets API does not support threeDimensional for basicChart (BAR/COLUMN/LINE)\n // threeDimensional is only supported for pieChart\n domains: [\n {\n domain: {\n sourceRange: {\n sources: [domainRange],\n },\n },\n },\n ],\n series,\n };\n if (legend !== 'NONE') {\n basicChart.legendPosition = apiLegendPosition;\n }\n\n chartSpec = { basicChart };\n if (title) {\n chartSpec.title = title;\n }\n }\n\n // Build embedded object position\n const embeddedObjectPosition = {\n overlayPosition: {\n anchorCell: {\n sheetId,\n rowIndex: anchorRowIndex,\n columnIndex: anchorColumnIndex,\n },\n offsetXPixels: position.offsetX,\n offsetYPixels: position.offsetY,\n },\n };\n\n const requestBody = {\n requests: [\n {\n addChart: {\n chart: {\n spec: chartSpec,\n position: embeddedObjectPosition,\n },\n },\n },\n ],\n };\n\n logger.info('sheets.chart.create executing addChart request', {\n spreadsheetId: id,\n sheetTitle,\n chartType,\n dataRange,\n anchorCell: position.anchorCell,\n requestBody: JSON.stringify(requestBody),\n });\n\n // Execute the addChart request\n const response = await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody,\n });\n\n // Extract chart ID from response\n const replies = response.data.replies || [];\n if (replies.length === 0 || !replies[0]?.addChart?.chart?.chartId) {\n logger.error('Chart creation failed - no chart ID returned', {\n spreadsheetId: id,\n sheetTitle,\n chartType,\n });\n throw new ProtocolError(ProtocolErrorCode.InternalError, 'Chart creation failed: no chart ID returned from Google Sheets API');\n }\n\n const chartId = replies[0].addChart.chart.chartId;\n\n logger.info('sheets.chart.create completed successfully', {\n chartId,\n chartType,\n anchorCell: position.anchorCell,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n chartId,\n anchorCell: position.anchorCell,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (e) {\n const error = e as Error & { response?: { data?: unknown; status?: number } };\n const message = error.message || String(e);\n logger.error('Chart create operation failed', {\n id,\n gid,\n chartType,\n dataRange,\n error: message,\n response: error.response?.data,\n status: error.response?.status,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error creating chart: ${message}`, {\n stack: e instanceof Error ? e.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'chart-create',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ChartPositionSchema","object","anchorCell","string","min","describe","offsetX","number","int","default","offsetY","inputSchema","id","gid","chartType","enum","dataRange","title","optional","position","legend","is3D","boolean","successBranchSchema","type","literal","sheetTitle","sheetUrl","chartId","outputSchema","discriminatedUnion","config","description","result","parseAnchorCell","match","Error","colLetters","rowNumber","columnIndex","i","length","charCodeAt","rowIndex","Number","parseInt","handler","extra","logger","info","sheet","dataGridRange","spreadsheetResponse","replies","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","anchorRowIndex","anchorColumnIndex","anchorIndices","error","message","rangeRef","startColumnIndex","undefined","endColumnIndex","startRowIndex","endRowIndex","dataStartRowIndex","dataEndRowIndex","dataStartColumnIndex","dataEndColumnIndex","dataSheetId","chartSpec","legendPositionMap","BOTTOM","RIGHT","TOP","LEFT","NONE","apiLegendPosition","baseSheetId","domainRange","seriesRange","pieChart","legendPosition","domain","sourceRange","sources","series","threeDimensional","numDataColumns","push","basicChart","headerCount","domains","embeddedObjectPosition","overlayPosition","offsetXPixels","offsetYPixels","requestBody","requests","addChart","chart","spec","JSON","stringify","response","batchUpdate","InternalError","content","text","structuredContent","e","status","stack","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/chart-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, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// Input schema for chart position\nconst ChartPositionSchema = z.object({\n anchorCell: z.string().min(1).describe('A1 notation cell where chart top-left anchors (e.g., \"F2\")'),\n offsetX: z.number().int().default(0).describe('Horizontal pixel offset from anchor'),\n offsetY: z.number().int().default(0).describe('Vertical pixel offset from anchor'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n chartType: z.enum(['PIE', 'BAR', 'COLUMN', 'LINE']).describe('Type of chart to create'),\n dataRange: z.string().min(1).describe('A1 notation range containing chart data including headers (e.g., \"A1:C10\")'),\n title: z.string().optional().describe('Chart title displayed at top'),\n position: ChartPositionSchema,\n legend: z.enum(['BOTTOM', 'RIGHT', 'TOP', 'LEFT', 'NONE']).default('BOTTOM').describe('Legend position'),\n is3D: z.boolean().default(false).describe('Render as 3D chart (PIE only)'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Title of the sheet containing the chart'),\n sheetUrl: z.string().describe('URL of the sheet containing the chart'),\n chartId: z.number().int().describe('Unique chart ID for future updates/deletion'),\n anchorCell: z.string().describe('Where chart was anchored'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Create charts (pie, bar, column, line) from spreadsheet data ranges. Charts anchor to specific cells with optional pixel offsets. Data range should include headers. PIE charts use 2 columns (labels, values). BAR/COLUMN/LINE charts use first row as headers. Best for visualizing spreadsheet data.',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\n// Parse A1 notation anchor cell to row/column indices\nfunction parseAnchorCell(anchorCell: string): { rowIndex: number; columnIndex: number } {\n // Simple A1 notation parser for single cells\n const match = anchorCell.match(/^([A-Z]+)(\\d+)$/);\n if (!match || !match[1] || !match[2]) {\n throw new Error(`Invalid anchor cell format: ${anchorCell}`);\n }\n\n const colLetters = match[1];\n const rowNumber = match[2];\n\n // Convert column letters to index (A=0, B=1, ..., Z=25, AA=26, etc.)\n let columnIndex = 0;\n for (let i = 0; i < colLetters.length; i++) {\n columnIndex = columnIndex * 26 + (colLetters.charCodeAt(i) - 65 + 1);\n }\n columnIndex--; // Convert to 0-based\n\n // Convert row number to index (1-based to 0-based)\n const rowIndex = Number.parseInt(rowNumber, 10) - 1;\n\n return { rowIndex, columnIndex };\n}\n\nasync function handler({ id, gid, chartType, dataRange, title, position, legend = 'BOTTOM', is3D = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.chart.create called', {\n id,\n gid,\n chartType,\n dataRange,\n title,\n position,\n legend,\n is3D,\n });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n // Find sheet by gid\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.info('Sheet not found for chart create', { id, gid, chartType });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n const sheetId = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n // Validate 3D only for PIE charts\n // Note: Google Sheets API only supports 3D for PIE charts, not COLUMN/BAR/LINE\n if (is3D && chartType !== 'PIE') {\n logger.info('3D mode not supported for this chart type', {\n chartType,\n is3D,\n });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `3D mode is only supported for PIE charts, not ${chartType}`);\n }\n\n // Parse anchor cell to row/column indices\n let anchorRowIndex: number;\n let anchorColumnIndex: number;\n try {\n const anchorIndices = parseAnchorCell(position.anchorCell);\n anchorRowIndex = anchorIndices.rowIndex;\n anchorColumnIndex = anchorIndices.columnIndex;\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to parse anchor cell', {\n anchorCell: position.anchorCell,\n error: message,\n });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Failed to parse anchor cell: ${message}`);\n }\n\n // Parse data range to grid range\n let dataGridRange: sheets_v4.Schema$GridRange;\n try {\n const rangeRef = parseA1Notation(dataRange);\n dataGridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n // Validate that required properties are defined for chart creation\n if (dataGridRange.startColumnIndex === undefined || dataGridRange.startColumnIndex === null) {\n throw new Error('Data range must include column information');\n }\n if (dataGridRange.endColumnIndex === undefined || dataGridRange.endColumnIndex === null) {\n throw new Error('Data range must include column information');\n }\n if (dataGridRange.startRowIndex === undefined || dataGridRange.startRowIndex === null) {\n throw new Error('Data range must include row information');\n }\n if (dataGridRange.endRowIndex === undefined || dataGridRange.endRowIndex === null) {\n throw new Error('Data range must include row information');\n }\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to parse data range', {\n dataRange,\n error: message,\n });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Failed to parse data range: ${message}`);\n }\n\n // Extract validated properties with defined types\n const dataStartRowIndex = dataGridRange.startRowIndex as number;\n const dataEndRowIndex = dataGridRange.endRowIndex as number;\n const dataStartColumnIndex = dataGridRange.startColumnIndex as number;\n const dataEndColumnIndex = dataGridRange.endColumnIndex as number;\n const dataSheetId = dataGridRange.sheetId ?? sheetId;\n\n // Build chart spec with properly split domain and series ranges\n let chartSpec: sheets_v4.Schema$ChartSpec;\n\n logger.info('Building chart spec', {\n chartType,\n dataGridRange,\n sheetId,\n });\n\n // Map legend position to API format (add _LEGEND suffix)\n const legendPositionMap: Record<string, string> = {\n BOTTOM: 'BOTTOM_LEGEND',\n RIGHT: 'RIGHT_LEGEND',\n TOP: 'TOP_LEGEND',\n LEFT: 'LEFT_LEGEND',\n NONE: 'NO_LEGEND',\n };\n const apiLegendPosition = legendPositionMap[legend] || 'BOTTOM_LEGEND';\n\n if (chartType === 'PIE') {\n // PIE charts use a separate pieChart property, not basicChart\n const baseSheetId = dataSheetId;\n\n const domainRange = {\n sheetId: baseSheetId,\n startRowIndex: dataStartRowIndex,\n endRowIndex: dataEndRowIndex,\n startColumnIndex: dataStartColumnIndex,\n endColumnIndex: dataStartColumnIndex + 1, // First column only (labels)\n };\n\n const seriesRange = {\n sheetId: baseSheetId,\n startRowIndex: dataStartRowIndex,\n endRowIndex: dataEndRowIndex,\n startColumnIndex: dataStartColumnIndex + 1, // Second column (values)\n endColumnIndex: dataStartColumnIndex + 2,\n };\n\n logger.info('PIE chart ranges', {\n dataGridRange,\n domainRange,\n seriesRange,\n apiLegendPosition,\n });\n\n chartSpec = {\n pieChart: {\n // Use pieChart for PIE charts\n legendPosition: legend === 'NONE' ? 'NO_LEGEND' : apiLegendPosition,\n domain: {\n // Note: domain/series are direct objects, not arrays\n sourceRange: {\n sources: [domainRange],\n },\n },\n series: {\n sourceRange: {\n sources: [seriesRange],\n },\n },\n threeDimensional: is3D, // 3D is directly on pieChart\n },\n };\n if (title) {\n chartSpec.title = title;\n }\n } else {\n // For BAR, COLUMN, LINE charts: domain is first column, each subsequent column is a series\n const baseSheetId = dataSheetId;\n\n const domainRange = {\n sheetId: baseSheetId,\n startRowIndex: dataStartRowIndex,\n endRowIndex: dataEndRowIndex,\n startColumnIndex: dataStartColumnIndex,\n endColumnIndex: dataStartColumnIndex + 1, // First column only\n };\n\n // Calculate number of data columns (excluding the first domain column)\n const numDataColumns = dataEndColumnIndex - dataStartColumnIndex - 1;\n const series = [];\n\n // Create a series for each data column\n for (let i = 0; i < numDataColumns; i++) {\n const seriesRange = {\n sheetId: baseSheetId,\n startRowIndex: dataStartRowIndex,\n endRowIndex: dataEndRowIndex,\n startColumnIndex: dataStartColumnIndex + 1 + i,\n endColumnIndex: dataStartColumnIndex + 2 + i,\n };\n\n series.push({\n series: {\n sourceRange: {\n sources: [seriesRange],\n },\n },\n });\n }\n\n // If no data columns were found, default to using the entire range as a fallback\n if (series.length === 0) {\n series.push({\n series: {\n sourceRange: {\n sources: [dataGridRange],\n },\n },\n });\n }\n\n const basicChart: sheets_v4.Schema$BasicChartSpec = {\n chartType, // BAR, COLUMN, LINE are valid for basicChart\n headerCount: 1, // First row is headers\n // Note: Google Sheets API does not support threeDimensional for basicChart (BAR/COLUMN/LINE)\n // threeDimensional is only supported for pieChart\n domains: [\n {\n domain: {\n sourceRange: {\n sources: [domainRange],\n },\n },\n },\n ],\n series,\n };\n if (legend !== 'NONE') {\n basicChart.legendPosition = apiLegendPosition;\n }\n\n chartSpec = { basicChart };\n if (title) {\n chartSpec.title = title;\n }\n }\n\n // Build embedded object position\n const embeddedObjectPosition = {\n overlayPosition: {\n anchorCell: {\n sheetId,\n rowIndex: anchorRowIndex,\n columnIndex: anchorColumnIndex,\n },\n offsetXPixels: position.offsetX,\n offsetYPixels: position.offsetY,\n },\n };\n\n const requestBody = {\n requests: [\n {\n addChart: {\n chart: {\n spec: chartSpec,\n position: embeddedObjectPosition,\n },\n },\n },\n ],\n };\n\n logger.info('sheets.chart.create executing addChart request', {\n spreadsheetId: id,\n sheetTitle,\n chartType,\n dataRange,\n anchorCell: position.anchorCell,\n requestBody: JSON.stringify(requestBody),\n });\n\n // Execute the addChart request\n const response = await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody,\n });\n\n // Extract chart ID from response\n const replies = response.data.replies || [];\n if (replies.length === 0 || !replies[0]?.addChart?.chart?.chartId) {\n logger.error('Chart creation failed - no chart ID returned', {\n spreadsheetId: id,\n sheetTitle,\n chartType,\n });\n throw new ProtocolError(ProtocolErrorCode.InternalError, 'Chart creation failed: no chart ID returned from Google Sheets API');\n }\n\n const chartId = replies[0].addChart.chart.chartId;\n\n logger.info('sheets.chart.create completed successfully', {\n chartId,\n chartType,\n anchorCell: position.anchorCell,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetId),\n sheetTitle,\n sheetUrl,\n chartId,\n anchorCell: position.anchorCell,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (e) {\n const error = e as Error & { response?: { data?: unknown; status?: number } };\n const message = error.message || String(e);\n logger.error('Chart create operation failed', {\n id,\n gid,\n chartType,\n dataRange,\n error: message,\n response: error.response?.data,\n status: error.response?.status,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error creating chart: ${message}`, {\n stack: e instanceof Error ? e.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'chart-create',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ChartPositionSchema","object","anchorCell","string","min","describe","offsetX","number","int","default","offsetY","inputSchema","id","gid","chartType","enum","dataRange","title","optional","position","legend","is3D","boolean","successBranchSchema","type","literal","sheetTitle","sheetUrl","chartId","outputSchema","discriminatedUnion","config","description","result","parseAnchorCell","match","Error","colLetters","rowNumber","columnIndex","i","length","charCodeAt","rowIndex","Number","parseInt","handler","extra","logger","info","sheet","dataGridRange","spreadsheetResponse","replies","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","anchorRowIndex","anchorColumnIndex","anchorIndices","error","message","rangeRef","startColumnIndex","undefined","endColumnIndex","startRowIndex","endRowIndex","dataStartRowIndex","dataEndRowIndex","dataStartColumnIndex","dataEndColumnIndex","dataSheetId","chartSpec","legendPositionMap","BOTTOM","RIGHT","TOP","LEFT","NONE","apiLegendPosition","baseSheetId","domainRange","seriesRange","pieChart","legendPosition","domain","sourceRange","sources","series","threeDimensional","numDataColumns","push","basicChart","headerCount","domains","embeddedObjectPosition","overlayPosition","offsetXPixels","offsetYPixels","requestBody","requests","addChart","chart","spec","JSON","stringify","response","batchUpdate","InternalError","content","text","structuredContent","e","status","stack","createTool","name"],"mappings":"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"}
@@ -3,6 +3,7 @@ const { AuthRequiredBranchSchema } = schemas;
3
3
  import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
4
4
  import { google } from 'googleapis';
5
5
  import { z } from 'zod';
6
+ import { googleAuth } from '../../lib/google-auth.js';
6
7
  import { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.js';
7
8
  const inputSchema = z.object({
8
9
  id: SpreadsheetIdSchema,
@@ -43,7 +44,7 @@ async function handler({ id, gid, render }, extra) {
43
44
  var _spreadsheetResponse_data_sheets, _logger_info;
44
45
  const sheets = google.sheets({
45
46
  version: 'v4',
46
- auth: extra.authContext.auth
47
+ auth: googleAuth(extra.authContext.auth)
47
48
  });
48
49
  // Get spreadsheet and sheet info in single API call
49
50
  const spreadsheetResponse = await sheets.spreadsheets.get({
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-get.ts"],"sourcesContent":["/** Get column names from Google Sheet (peek at first row only) */\n\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n});\n\n// Success branch schema - uses columns: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n columns: z.array(z.string()).describe('First row values (column names) or empty if no rows'),\n isEmpty: z.boolean().describe('True if sheet has zero rows'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Get first row from Google Sheet. Returns columns array and isEmpty flag.',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.debug?.('sheets.columns.get called', { id, gid, render });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n // Find sheet by gid\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? '';\n\n // Read first row only (A1:ZZZ1 should cover most reasonable sheets)\n const range = `'${sheetTitle}'!A1:ZZZ1`;\n const response = await sheets.spreadsheets.values.get({\n spreadsheetId: id,\n range,\n valueRenderOption: render || 'FORMATTED_VALUE',\n });\n\n const rows = response.data.values || [];\n const isEmpty = rows.length === 0;\n\n // Extract first row and convert to strings (column names)\n const firstRow = rows[0] || [];\n const columns = firstRow.map((value) => String(value ?? ''));\n\n const result: Output = {\n type: 'success' as const,\n columns,\n isEmpty,\n };\n\n logger.info?.('sheets.columns.get completed', { id, gid, columnCount: columns.length, isEmpty });\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error?.('sheets.columns.get error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting sheet columns: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'columns-get',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","id","gid","render","enum","optional","describe","successBranchSchema","type","literal","columns","array","string","isEmpty","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","debug","sheet","spreadsheetResponse","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","sheetTitle","title","range","response","values","valueRenderOption","rows","length","firstRow","map","value","info","columnCount","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-get.ts"],"sourcesContent":["/** Get column names from Google Sheet (peek at first row only) */\n\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n});\n\n// Success branch schema - uses columns: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n columns: z.array(z.string()).describe('First row values (column names) or empty if no rows'),\n isEmpty: z.boolean().describe('True if sheet has zero rows'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Get first row from Google Sheet. Returns columns array and isEmpty flag.',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.debug?.('sheets.columns.get called', { id, gid, render });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n // Find sheet by gid\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? '';\n\n // Read first row only (A1:ZZZ1 should cover most reasonable sheets)\n const range = `'${sheetTitle}'!A1:ZZZ1`;\n const response = await sheets.spreadsheets.values.get({\n spreadsheetId: id,\n range,\n valueRenderOption: render || 'FORMATTED_VALUE',\n });\n\n const rows = response.data.values || [];\n const isEmpty = rows.length === 0;\n\n // Extract first row and convert to strings (column names)\n const firstRow = rows[0] || [];\n const columns = firstRow.map((value) => String(value ?? ''));\n\n const result: Output = {\n type: 'success' as const,\n columns,\n isEmpty,\n };\n\n logger.info?.('sheets.columns.get completed', { id, gid, columnCount: columns.length, isEmpty });\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error?.('sheets.columns.get error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting sheet columns: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'columns-get',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","googleAuth","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","id","gid","render","enum","optional","describe","successBranchSchema","type","literal","columns","array","string","isEmpty","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","debug","sheet","spreadsheetResponse","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","sheetTitle","title","range","response","values","valueRenderOption","rows","length","firstRow","map","value","info","columnCount","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
@@ -3,6 +3,7 @@ const { AuthRequiredBranchSchema } = schemas;
3
3
  import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
4
4
  import { google } from 'googleapis';
5
5
  import { z } from 'zod';
6
+ import { googleAuth } from '../../lib/google-auth.js';
6
7
  import { SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
7
8
  import { generateRowKey, snapshotHeaderKeysAndPositions, upsertByKey } from '../../spreadsheet/data-operations.js';
8
9
  // Input schema for columns update requests with enhanced validation
@@ -96,7 +97,7 @@ async function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-up
96
97
  var _spreadsheetData_properties, _spreadsheetData_sheets, _logger_debug1, _upsertResult_errors, _logger_debug2;
97
98
  const sheets = google.sheets({
98
99
  version: 'v4',
99
- auth: extra.authContext.auth
100
+ auth: googleAuth(extra.authContext.auth)
100
101
  });
101
102
  // Note: Basic input validation is now handled by the enhanced Zod schema
102
103
  // EARLY VALIDATION: Validate that updateBy columns have non-empty values for all rows