@mcp-z/mcp-sheets 2.3.1 → 2.4.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 (142) hide show
  1. package/README.md +32 -27
  2. package/dist/cjs/constants.js.map +1 -1
  3. package/dist/cjs/index.js.map +1 -1
  4. package/dist/cjs/lib/create-store.js.map +1 -1
  5. package/dist/cjs/lib/google-auth.js.map +1 -1
  6. package/dist/cjs/mcp/index.js.map +1 -1
  7. package/dist/cjs/mcp/prompts/a1-notation.js.map +1 -1
  8. package/dist/cjs/mcp/prompts/index.js.map +1 -1
  9. package/dist/cjs/mcp/resources/index.js.map +1 -1
  10. package/dist/cjs/mcp/resources/spreadsheet.js.map +1 -1
  11. package/dist/cjs/mcp/tools/cells-format.js.map +1 -1
  12. package/dist/cjs/mcp/tools/cells-metadata-get.d.cts +95 -0
  13. package/dist/cjs/mcp/tools/cells-metadata-get.d.ts +95 -0
  14. package/dist/cjs/mcp/tools/cells-metadata-get.js +331 -0
  15. package/dist/cjs/mcp/tools/cells-metadata-get.js.map +1 -0
  16. package/dist/cjs/mcp/tools/chart-create.js.map +1 -1
  17. package/dist/cjs/mcp/tools/columns-get.js.map +1 -1
  18. package/dist/cjs/mcp/tools/columns-update.js.map +1 -1
  19. package/dist/cjs/mcp/tools/csv-get-columns.js.map +1 -1
  20. package/dist/cjs/mcp/tools/dimensions-batch-update.js.map +1 -1
  21. package/dist/cjs/mcp/tools/dimensions-move.js.map +1 -1
  22. package/dist/cjs/mcp/tools/index.d.cts +2 -0
  23. package/dist/cjs/mcp/tools/index.d.ts +2 -0
  24. package/dist/cjs/mcp/tools/index.js +8 -0
  25. package/dist/cjs/mcp/tools/index.js.map +1 -1
  26. package/dist/cjs/mcp/tools/lib/dimension-operations.js.map +1 -1
  27. package/dist/cjs/mcp/tools/rows-append.js.map +1 -1
  28. package/dist/cjs/mcp/tools/rows-csv-append.js.map +1 -1
  29. package/dist/cjs/mcp/tools/rows-get.js.map +1 -1
  30. package/dist/cjs/mcp/tools/sheet-copy-to.js.map +1 -1
  31. package/dist/cjs/mcp/tools/sheet-copy.js.map +1 -1
  32. package/dist/cjs/mcp/tools/sheet-create.js.map +1 -1
  33. package/dist/cjs/mcp/tools/sheet-delete.js.map +1 -1
  34. package/dist/cjs/mcp/tools/sheet-find.js.map +1 -1
  35. package/dist/cjs/mcp/tools/sheet-rename.js.map +1 -1
  36. package/dist/cjs/mcp/tools/spreadsheet-copy.js.map +1 -1
  37. package/dist/cjs/mcp/tools/spreadsheet-create.js.map +1 -1
  38. package/dist/cjs/mcp/tools/spreadsheet-find.js.map +1 -1
  39. package/dist/cjs/mcp/tools/spreadsheet-metadata-get.d.cts +59 -0
  40. package/dist/cjs/mcp/tools/spreadsheet-metadata-get.d.ts +59 -0
  41. package/dist/cjs/mcp/tools/spreadsheet-metadata-get.js +259 -0
  42. package/dist/cjs/mcp/tools/spreadsheet-metadata-get.js.map +1 -0
  43. package/dist/cjs/mcp/tools/spreadsheet-rename.js.map +1 -1
  44. package/dist/cjs/mcp/tools/validation-set.js.map +1 -1
  45. package/dist/cjs/mcp/tools/values-batch-update.js.map +1 -1
  46. package/dist/cjs/mcp/tools/values-clear.js.map +1 -1
  47. package/dist/cjs/mcp/tools/values-csv-update.js.map +1 -1
  48. package/dist/cjs/mcp/tools/values-markdown-update.js.map +1 -1
  49. package/dist/cjs/mcp/tools/values-replace.js.map +1 -1
  50. package/dist/cjs/mcp/tools/values-search.js.map +1 -1
  51. package/dist/cjs/schemas/index.js.map +1 -1
  52. package/dist/cjs/setup/config.js +5 -4
  53. package/dist/cjs/setup/config.js.map +1 -1
  54. package/dist/cjs/setup/http.d.cts +1 -1
  55. package/dist/cjs/setup/http.d.ts +1 -1
  56. package/dist/cjs/setup/http.js.map +1 -1
  57. package/dist/cjs/setup/index.js.map +1 -1
  58. package/dist/cjs/setup/oauth-google.js.map +1 -1
  59. package/dist/cjs/setup/runtime.js +3 -2
  60. package/dist/cjs/setup/runtime.js.map +1 -1
  61. package/dist/cjs/setup/stdio.js.map +1 -1
  62. package/dist/cjs/setup/version-help.js.map +1 -1
  63. package/dist/cjs/spreadsheet/column-utilities.js.map +1 -1
  64. package/dist/cjs/spreadsheet/csv-streaming.js.map +1 -1
  65. package/dist/cjs/spreadsheet/data-operations.js.map +1 -1
  66. package/dist/cjs/spreadsheet/deduplication-utils.js.map +1 -1
  67. package/dist/cjs/spreadsheet/markdown-runs.js.map +1 -1
  68. package/dist/cjs/spreadsheet/range-operations.d.cts +2 -1
  69. package/dist/cjs/spreadsheet/range-operations.d.ts +2 -1
  70. package/dist/cjs/spreadsheet/range-operations.js +12 -0
  71. package/dist/cjs/spreadsheet/range-operations.js.map +1 -1
  72. package/dist/cjs/spreadsheet/sheet-operations.js.map +1 -1
  73. package/dist/cjs/spreadsheet/spreadsheet-management.js.map +1 -1
  74. package/dist/esm/constants.js.map +1 -1
  75. package/dist/esm/index.js.map +1 -1
  76. package/dist/esm/lib/create-store.js.map +1 -1
  77. package/dist/esm/lib/google-auth.js.map +1 -1
  78. package/dist/esm/mcp/index.js.map +1 -1
  79. package/dist/esm/mcp/prompts/a1-notation.js.map +1 -1
  80. package/dist/esm/mcp/prompts/index.js.map +1 -1
  81. package/dist/esm/mcp/resources/index.js.map +1 -1
  82. package/dist/esm/mcp/resources/spreadsheet.js.map +1 -1
  83. package/dist/esm/mcp/tools/cells-format.js.map +1 -1
  84. package/dist/esm/mcp/tools/cells-metadata-get.d.ts +95 -0
  85. package/dist/esm/mcp/tools/cells-metadata-get.js +155 -0
  86. package/dist/esm/mcp/tools/cells-metadata-get.js.map +1 -0
  87. package/dist/esm/mcp/tools/chart-create.js.map +1 -1
  88. package/dist/esm/mcp/tools/columns-get.js.map +1 -1
  89. package/dist/esm/mcp/tools/columns-update.js.map +1 -1
  90. package/dist/esm/mcp/tools/csv-get-columns.js.map +1 -1
  91. package/dist/esm/mcp/tools/dimensions-batch-update.js.map +1 -1
  92. package/dist/esm/mcp/tools/dimensions-move.js.map +1 -1
  93. package/dist/esm/mcp/tools/index.d.ts +2 -0
  94. package/dist/esm/mcp/tools/index.js +2 -0
  95. package/dist/esm/mcp/tools/index.js.map +1 -1
  96. package/dist/esm/mcp/tools/lib/dimension-operations.js.map +1 -1
  97. package/dist/esm/mcp/tools/rows-append.js.map +1 -1
  98. package/dist/esm/mcp/tools/rows-csv-append.js.map +1 -1
  99. package/dist/esm/mcp/tools/rows-get.js.map +1 -1
  100. package/dist/esm/mcp/tools/sheet-copy-to.js.map +1 -1
  101. package/dist/esm/mcp/tools/sheet-copy.js.map +1 -1
  102. package/dist/esm/mcp/tools/sheet-create.js.map +1 -1
  103. package/dist/esm/mcp/tools/sheet-delete.js.map +1 -1
  104. package/dist/esm/mcp/tools/sheet-find.js.map +1 -1
  105. package/dist/esm/mcp/tools/sheet-rename.js.map +1 -1
  106. package/dist/esm/mcp/tools/spreadsheet-copy.js.map +1 -1
  107. package/dist/esm/mcp/tools/spreadsheet-create.js.map +1 -1
  108. package/dist/esm/mcp/tools/spreadsheet-find.js.map +1 -1
  109. package/dist/esm/mcp/tools/spreadsheet-metadata-get.d.ts +59 -0
  110. package/dist/esm/mcp/tools/spreadsheet-metadata-get.js +89 -0
  111. package/dist/esm/mcp/tools/spreadsheet-metadata-get.js.map +1 -0
  112. package/dist/esm/mcp/tools/spreadsheet-rename.js.map +1 -1
  113. package/dist/esm/mcp/tools/validation-set.js.map +1 -1
  114. package/dist/esm/mcp/tools/values-batch-update.js.map +1 -1
  115. package/dist/esm/mcp/tools/values-clear.js.map +1 -1
  116. package/dist/esm/mcp/tools/values-csv-update.js.map +1 -1
  117. package/dist/esm/mcp/tools/values-markdown-update.js.map +1 -1
  118. package/dist/esm/mcp/tools/values-replace.js.map +1 -1
  119. package/dist/esm/mcp/tools/values-search.js.map +1 -1
  120. package/dist/esm/schemas/index.js.map +1 -1
  121. package/dist/esm/setup/config.js +4 -3
  122. package/dist/esm/setup/config.js.map +1 -1
  123. package/dist/esm/setup/http.d.ts +1 -1
  124. package/dist/esm/setup/http.js.map +1 -1
  125. package/dist/esm/setup/index.js.map +1 -1
  126. package/dist/esm/setup/oauth-google.js.map +1 -1
  127. package/dist/esm/setup/runtime.js +3 -2
  128. package/dist/esm/setup/runtime.js.map +1 -1
  129. package/dist/esm/setup/stdio.js.map +1 -1
  130. package/dist/esm/setup/version-help.js.map +1 -1
  131. package/dist/esm/spreadsheet/column-utilities.js.map +1 -1
  132. package/dist/esm/spreadsheet/csv-streaming.js.map +1 -1
  133. package/dist/esm/spreadsheet/data-operations.js.map +1 -1
  134. package/dist/esm/spreadsheet/deduplication-utils.js.map +1 -1
  135. package/dist/esm/spreadsheet/markdown-runs.js.map +1 -1
  136. package/dist/esm/spreadsheet/range-operations.d.ts +2 -1
  137. package/dist/esm/spreadsheet/range-operations.js +11 -2
  138. package/dist/esm/spreadsheet/range-operations.js.map +1 -1
  139. package/dist/esm/spreadsheet/sheet-operations.js.map +1 -1
  140. package/dist/esm/spreadsheet/spreadsheet-management.js.map +1 -1
  141. package/dist/esm/types.js.map +1 -1
  142. package/package.json +11 -6
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/spreadsheet-find.ts"],"sourcesContent":["import { drive as driveApi } from '@googleapis/drive';\nimport { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SpreadsheetIdOutput, SpreadsheetRefSchema } from '../../schemas/index.ts';\nimport { findSpreadsheetsByRef } from '../../spreadsheet/spreadsheet-management.ts';\n\n/** Spreadsheet match result from findSpreadsheetsByRef */\ninterface SpreadsheetMatch {\n id: string;\n spreadsheetTitle: string | undefined;\n url: string | undefined;\n modifiedTime: string | null | undefined;\n}\n\nconst inputSchema = z.object({\n spreadsheetRef: SpreadsheetRefSchema,\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n items: z\n .array(\n z.object({\n id: SpreadsheetIdOutput,\n spreadsheetTitle: z.string().describe('Name of the spreadsheet'),\n spreadsheetUrl: z.string().optional().describe('URL to view the spreadsheet'),\n modifiedTime: z.string().optional().describe('Last modified timestamp (ISO format)'),\n sheets: z\n .array(\n z.object({\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Sheet tab name'),\n })\n )\n .describe('All sheets/tabs in this spreadsheet'),\n })\n )\n .describe('Matching spreadsheets sorted by modification time'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Find spreadsheet by ID, URL, or name. Returns all sheets/tabs in response.',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ spreadsheetRef }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.spreadsheet.find called', { spreadsheetRef });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n const drive = driveApi({ version: 'v3', auth: googleAuth(extra.authContext.auth) });\n\n const matches = (await findSpreadsheetsByRef(sheets, drive, spreadsheetRef)) as SpreadsheetMatch[];\n\n const sorted = (matches || []).slice().sort((a: SpreadsheetMatch, b: SpreadsheetMatch) => (b.modifiedTime ? new Date(b.modifiedTime).getTime() : 0) - (a.modifiedTime ? new Date(a.modifiedTime).getTime() : 0));\n\n const items = await Promise.all(\n sorted.map(async (m: SpreadsheetMatch) => {\n // Fetch sheet metadata for each spreadsheet\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: m.id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n const sheetsData = (spreadsheetResponse.data.sheets || []).map((sheet) => {\n const gid = String(sheet.properties?.sheetId ?? '');\n return {\n gid,\n sheetTitle: sheet.properties?.title ?? '',\n };\n });\n\n return {\n id: m.id,\n spreadsheetTitle: m.spreadsheetTitle ?? '',\n sheets: sheetsData,\n ...(m.url && { spreadsheetUrl: m.url }),\n ...(m.modifiedTime && { modifiedTime: m.modifiedTime }),\n };\n })\n );\n\n logger.info('sheets.spreadsheet.find success', { count: items.length });\n\n const result: Output = {\n type: 'success' as const,\n items,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.spreadsheet.find error', { error: message });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error finding spreadsheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'spreadsheet-find',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","spreadsheetRef","SpreadsheetRefSchema","successBranchSchema","type","literal","items","array","id","SpreadsheetIdOutput","spreadsheetTitle","string","describe","spreadsheetUrl","optional","modifiedTime","sheets","gid","SheetGidOutput","sheetTitle","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","drive","matches","sorted","error","message","info","sheetsApi","version","auth","googleAuth","authContext","driveApi","findSpreadsheetsByRef","slice","sort","a","b","Date","getTime","Promise","all","map","m","spreadsheetResponse","sheetsData","spreadsheets","get","spreadsheetId","fields","data","sheet","String","properties","sheetId","title","url","count","length","content","text","JSON","stringify","structuredContent","Error","ProtocolError","ProtocolErrorCode","InternalError","stack","undefined","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/spreadsheet-find.ts"],"sourcesContent":["import { drive as driveApi } from '@googleapis/drive';\nimport { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SpreadsheetIdOutput, SpreadsheetRefSchema } from '../../schemas/index.ts';\nimport { findSpreadsheetsByRef } from '../../spreadsheet/spreadsheet-management.ts';\n\n/** Spreadsheet match result from findSpreadsheetsByRef */\ninterface SpreadsheetMatch {\n id: string;\n spreadsheetTitle: string | undefined;\n url: string | undefined;\n modifiedTime: string | null | undefined;\n}\n\nconst inputSchema = z.object({\n spreadsheetRef: SpreadsheetRefSchema,\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n items: z\n .array(\n z.object({\n id: SpreadsheetIdOutput,\n spreadsheetTitle: z.string().describe('Name of the spreadsheet'),\n spreadsheetUrl: z.string().optional().describe('URL to view the spreadsheet'),\n modifiedTime: z.string().optional().describe('Last modified timestamp (ISO format)'),\n sheets: z\n .array(\n z.object({\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Sheet tab name'),\n })\n )\n .describe('All sheets/tabs in this spreadsheet'),\n })\n )\n .describe('Matching spreadsheets sorted by modification time'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Find spreadsheet by ID, URL, or name. Returns all sheets/tabs in response.',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ spreadsheetRef }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.spreadsheet.find called', { spreadsheetRef });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n const drive = driveApi({ version: 'v3', auth: googleAuth(extra.authContext.auth) });\n\n const matches = (await findSpreadsheetsByRef(sheets, drive, spreadsheetRef)) as SpreadsheetMatch[];\n\n const sorted = (matches || []).slice().sort((a: SpreadsheetMatch, b: SpreadsheetMatch) => (b.modifiedTime ? new Date(b.modifiedTime).getTime() : 0) - (a.modifiedTime ? new Date(a.modifiedTime).getTime() : 0));\n\n const items = await Promise.all(\n sorted.map(async (m: SpreadsheetMatch) => {\n // Fetch sheet metadata for each spreadsheet\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: m.id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n const sheetsData = (spreadsheetResponse.data.sheets || []).map((sheet) => {\n const gid = String(sheet.properties?.sheetId ?? '');\n return {\n gid,\n sheetTitle: sheet.properties?.title ?? '',\n };\n });\n\n return {\n id: m.id,\n spreadsheetTitle: m.spreadsheetTitle ?? '',\n sheets: sheetsData,\n ...(m.url && { spreadsheetUrl: m.url }),\n ...(m.modifiedTime && { modifiedTime: m.modifiedTime }),\n };\n })\n );\n\n logger.info('sheets.spreadsheet.find success', { count: items.length });\n\n const result: Output = {\n type: 'success' as const,\n items,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.spreadsheet.find error', { error: message });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error finding spreadsheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'spreadsheet-find',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","spreadsheetRef","SpreadsheetRefSchema","successBranchSchema","type","literal","items","array","id","SpreadsheetIdOutput","spreadsheetTitle","string","describe","spreadsheetUrl","optional","modifiedTime","sheets","gid","SheetGidOutput","sheetTitle","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","drive","matches","sorted","error","message","info","sheetsApi","version","auth","googleAuth","authContext","driveApi","findSpreadsheetsByRef","slice","sort","a","b","Date","getTime","Promise","all","map","m","spreadsheetResponse","sheetsData","spreadsheets","get","spreadsheetId","fields","data","sheet","String","properties","sheetId","title","url","count","length","content","text","JSON","stringify","structuredContent","Error","ProtocolError","ProtocolErrorCode","InternalError","stack","undefined","name"],"mappings":"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"}
@@ -0,0 +1,59 @@
1
+ import type { EnrichedExtra } from '@mcp-z/oauth-google';
2
+ import type { CallToolResult } from '@mcp-z/server';
3
+ import { z } from 'zod';
4
+ declare const inputSchema: z.ZodObject<{
5
+ id: z.ZodString;
6
+ }, z.core.$strict>;
7
+ declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
8
+ type: z.ZodLiteral<"success">;
9
+ id: z.ZodString;
10
+ metadata: z.ZodObject<{
11
+ spreadsheetId: z.ZodString;
12
+ properties: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
13
+ sheets: z.ZodOptional<z.ZodArray<z.ZodObject<{
14
+ properties: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
15
+ }, z.core.$loose>>>;
16
+ }, z.core.$loose>;
17
+ fieldMask: z.ZodString;
18
+ }, z.core.$strip>, z.ZodObject<{
19
+ type: z.ZodLiteral<"auth_required">;
20
+ provider: z.ZodString;
21
+ message: z.ZodString;
22
+ url: z.ZodOptional<z.ZodString>;
23
+ }, z.core.$strip>], "type">;
24
+ export type Input = z.infer<typeof inputSchema>;
25
+ export type Output = z.infer<typeof outputSchema>;
26
+ declare function handler({ id }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
27
+ export default function createTool(): {
28
+ name: string;
29
+ config: {
30
+ readonly description: "Read full workbook and sheet properties plus charts, named ranges, protections, conditional formats, tables, filters, banded ranges, merges, slicers, developer metadata, data sources and schedules. Returns all sheets without grid data, values or direct cell formatting.";
31
+ readonly annotations: {
32
+ readonly readOnlyHint: true;
33
+ };
34
+ readonly inputSchema: z.ZodObject<{
35
+ id: z.ZodString;
36
+ }, z.core.$strict>;
37
+ readonly outputSchema: z.ZodObject<{
38
+ result: z.ZodDiscriminatedUnion<[z.ZodObject<{
39
+ type: z.ZodLiteral<"success">;
40
+ id: z.ZodString;
41
+ metadata: z.ZodObject<{
42
+ spreadsheetId: z.ZodString;
43
+ properties: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
44
+ sheets: z.ZodOptional<z.ZodArray<z.ZodObject<{
45
+ properties: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
46
+ }, z.core.$loose>>>;
47
+ }, z.core.$loose>;
48
+ fieldMask: z.ZodString;
49
+ }, z.core.$strip>, z.ZodObject<{
50
+ type: z.ZodLiteral<"auth_required">;
51
+ provider: z.ZodString;
52
+ message: z.ZodString;
53
+ url: z.ZodOptional<z.ZodString>;
54
+ }, z.core.$strip>], "type">;
55
+ }, z.core.$strip>;
56
+ };
57
+ handler: typeof handler;
58
+ };
59
+ export {};
@@ -0,0 +1,59 @@
1
+ import type { EnrichedExtra } from '@mcp-z/oauth-google';
2
+ import type { CallToolResult } from '@mcp-z/server';
3
+ import { z } from 'zod';
4
+ declare const inputSchema: z.ZodObject<{
5
+ id: z.ZodString;
6
+ }, z.core.$strict>;
7
+ declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
8
+ type: z.ZodLiteral<"success">;
9
+ id: z.ZodString;
10
+ metadata: z.ZodObject<{
11
+ spreadsheetId: z.ZodString;
12
+ properties: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
13
+ sheets: z.ZodOptional<z.ZodArray<z.ZodObject<{
14
+ properties: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
15
+ }, z.core.$loose>>>;
16
+ }, z.core.$loose>;
17
+ fieldMask: z.ZodString;
18
+ }, z.core.$strip>, z.ZodObject<{
19
+ type: z.ZodLiteral<"auth_required">;
20
+ provider: z.ZodString;
21
+ message: z.ZodString;
22
+ url: z.ZodOptional<z.ZodString>;
23
+ }, z.core.$strip>], "type">;
24
+ export type Input = z.infer<typeof inputSchema>;
25
+ export type Output = z.infer<typeof outputSchema>;
26
+ declare function handler({ id }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
27
+ export default function createTool(): {
28
+ name: string;
29
+ config: {
30
+ readonly description: "Read full workbook and sheet properties plus charts, named ranges, protections, conditional formats, tables, filters, banded ranges, merges, slicers, developer metadata, data sources and schedules. Returns all sheets without grid data, values or direct cell formatting.";
31
+ readonly annotations: {
32
+ readonly readOnlyHint: true;
33
+ };
34
+ readonly inputSchema: z.ZodObject<{
35
+ id: z.ZodString;
36
+ }, z.core.$strict>;
37
+ readonly outputSchema: z.ZodObject<{
38
+ result: z.ZodDiscriminatedUnion<[z.ZodObject<{
39
+ type: z.ZodLiteral<"success">;
40
+ id: z.ZodString;
41
+ metadata: z.ZodObject<{
42
+ spreadsheetId: z.ZodString;
43
+ properties: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
44
+ sheets: z.ZodOptional<z.ZodArray<z.ZodObject<{
45
+ properties: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
46
+ }, z.core.$loose>>>;
47
+ }, z.core.$loose>;
48
+ fieldMask: z.ZodString;
49
+ }, z.core.$strip>, z.ZodObject<{
50
+ type: z.ZodLiteral<"auth_required">;
51
+ provider: z.ZodString;
52
+ message: z.ZodString;
53
+ url: z.ZodOptional<z.ZodString>;
54
+ }, z.core.$strip>], "type">;
55
+ }, z.core.$strip>;
56
+ };
57
+ handler: typeof handler;
58
+ };
59
+ export {};
@@ -0,0 +1,259 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", {
3
+ value: true
4
+ });
5
+ Object.defineProperty(exports, "default", {
6
+ enumerable: true,
7
+ get: function() {
8
+ return createTool;
9
+ }
10
+ });
11
+ var _sheets = require("@googleapis/sheets");
12
+ var _oauthgoogle = require("@mcp-z/oauth-google");
13
+ var _server = require("@mcp-z/server");
14
+ var _zod = require("zod");
15
+ var _googleauthts = require("../../lib/google-auth.js");
16
+ var _indexts = require("../../schemas/index.js");
17
+ function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
18
+ try {
19
+ var info = gen[key](arg);
20
+ var value = info.value;
21
+ } catch (error) {
22
+ reject(error);
23
+ return;
24
+ }
25
+ if (info.done) resolve(value);
26
+ else Promise.resolve(value).then(_next, _throw);
27
+ }
28
+ function _async_to_generator(fn) {
29
+ return function() {
30
+ var self = this, args = arguments;
31
+ return new Promise(function(resolve, reject) {
32
+ var gen = fn.apply(self, args);
33
+ function _next(value) {
34
+ asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
35
+ }
36
+ function _throw(err) {
37
+ asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
38
+ }
39
+ _next(undefined);
40
+ });
41
+ };
42
+ }
43
+ function _instanceof(left, right) {
44
+ "@swc/helpers - instanceof";
45
+ if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
46
+ return !!right[Symbol.hasInstance](left);
47
+ } else return left instanceof right;
48
+ }
49
+ function _ts_generator(thisArg, body) {
50
+ var f, y, t, _ = {
51
+ label: 0,
52
+ sent: function() {
53
+ if (t[0] & 1) throw t[1];
54
+ return t[1];
55
+ },
56
+ trys: [],
57
+ ops: []
58
+ }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
59
+ return d(g, "next", {
60
+ value: verb(0)
61
+ }), d(g, "throw", {
62
+ value: verb(1)
63
+ }), d(g, "return", {
64
+ value: verb(2)
65
+ }), typeof Symbol === "function" && d(g, Symbol.iterator, {
66
+ value: function() {
67
+ return this;
68
+ }
69
+ }), g;
70
+ function verb(n) {
71
+ return function(v) {
72
+ return step([
73
+ n,
74
+ v
75
+ ]);
76
+ };
77
+ }
78
+ function step(op) {
79
+ if (f) throw new TypeError("Generator is already executing.");
80
+ while(g && (g = 0, op[0] && (_ = 0)), _)try {
81
+ if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
82
+ if (y = 0, t) op = [
83
+ op[0] & 2,
84
+ t.value
85
+ ];
86
+ switch(op[0]){
87
+ case 0:
88
+ case 1:
89
+ t = op;
90
+ break;
91
+ case 4:
92
+ _.label++;
93
+ return {
94
+ value: op[1],
95
+ done: false
96
+ };
97
+ case 5:
98
+ _.label++;
99
+ y = op[1];
100
+ op = [
101
+ 0
102
+ ];
103
+ continue;
104
+ case 7:
105
+ op = _.ops.pop();
106
+ _.trys.pop();
107
+ continue;
108
+ default:
109
+ if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
110
+ _ = 0;
111
+ continue;
112
+ }
113
+ if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
114
+ _.label = op[1];
115
+ break;
116
+ }
117
+ if (op[0] === 6 && _.label < t[1]) {
118
+ _.label = t[1];
119
+ t = op;
120
+ break;
121
+ }
122
+ if (t && _.label < t[2]) {
123
+ _.label = t[2];
124
+ _.ops.push(op);
125
+ break;
126
+ }
127
+ if (t[2]) _.ops.pop();
128
+ _.trys.pop();
129
+ continue;
130
+ }
131
+ op = body.call(thisArg, _);
132
+ } catch (e) {
133
+ op = [
134
+ 6,
135
+ e
136
+ ];
137
+ y = 0;
138
+ } finally{
139
+ f = t = 0;
140
+ }
141
+ if (op[0] & 5) throw op[1];
142
+ return {
143
+ value: op[0] ? op[1] : void 0,
144
+ done: true
145
+ };
146
+ }
147
+ }
148
+ var AuthRequiredBranchSchema = _oauthgoogle.schemas.AuthRequiredBranchSchema;
149
+ var FIELD_MASK = 'spreadsheetId,properties,namedRanges,developerMetadata,dataSources,dataSourceSchedules,sheets(properties,charts,conditionalFormats,protectedRanges,tables,basicFilter,filterViews,bandedRanges,merges,slicers,developerMetadata)';
150
+ var inputSchema = _zod.z.object({
151
+ id: _indexts.SpreadsheetIdSchema
152
+ }).strict();
153
+ var metadataSchema = _zod.z.object({
154
+ spreadsheetId: _zod.z.string(),
155
+ properties: _zod.z.object({}).passthrough().optional(),
156
+ sheets: _zod.z.array(_zod.z.object({
157
+ properties: _zod.z.object({}).passthrough().optional()
158
+ }).passthrough()).optional()
159
+ }).passthrough();
160
+ var outputSchema = _zod.z.discriminatedUnion('type', [
161
+ _zod.z.object({
162
+ type: _zod.z.literal('success'),
163
+ id: _indexts.SpreadsheetIdOutput,
164
+ metadata: metadataSchema.describe('Google spreadsheet envelope with full workbook and sheet properties and selected structural collections. No grid data, values, or direct cell formatting.'),
165
+ fieldMask: _zod.z.string()
166
+ }),
167
+ AuthRequiredBranchSchema
168
+ ]);
169
+ var config = {
170
+ description: 'Read full workbook and sheet properties plus charts, named ranges, protections, conditional formats, tables, filters, banded ranges, merges, slicers, developer metadata, data sources and schedules. Returns all sheets without grid data, values or direct cell formatting.',
171
+ annotations: {
172
+ readOnlyHint: true
173
+ },
174
+ inputSchema: inputSchema,
175
+ outputSchema: _zod.z.object({
176
+ result: outputSchema
177
+ })
178
+ };
179
+ function handler(_0, _1) {
180
+ return _async_to_generator(function(param, extra) {
181
+ var id, logger, sheets, response, result, error, message;
182
+ return _ts_generator(this, function(_state) {
183
+ switch(_state.label){
184
+ case 0:
185
+ id = param.id;
186
+ logger = extra.logger;
187
+ logger.info('sheets.spreadsheet.metadata.get called', {
188
+ id: id
189
+ });
190
+ _state.label = 1;
191
+ case 1:
192
+ _state.trys.push([
193
+ 1,
194
+ 3,
195
+ ,
196
+ 4
197
+ ]);
198
+ sheets = (0, _sheets.sheets)({
199
+ version: 'v4',
200
+ auth: (0, _googleauthts.googleAuth)(extra.authContext.auth)
201
+ });
202
+ return [
203
+ 4,
204
+ sheets.spreadsheets.get({
205
+ spreadsheetId: id,
206
+ fields: FIELD_MASK
207
+ })
208
+ ];
209
+ case 2:
210
+ response = _state.sent();
211
+ result = outputSchema.parse({
212
+ type: 'success',
213
+ id: id,
214
+ metadata: response.data,
215
+ fieldMask: FIELD_MASK
216
+ });
217
+ logger.info('sheets.spreadsheet.metadata.get success', {
218
+ id: id
219
+ });
220
+ return [
221
+ 2,
222
+ {
223
+ content: [
224
+ {
225
+ type: 'text',
226
+ text: JSON.stringify(result)
227
+ }
228
+ ],
229
+ structuredContent: {
230
+ result: result
231
+ }
232
+ }
233
+ ];
234
+ case 3:
235
+ error = _state.sent();
236
+ message = _instanceof(error, Error) ? error.message : String(error);
237
+ logger.error('sheets.spreadsheet.metadata.get error', {
238
+ id: id,
239
+ error: message
240
+ });
241
+ throw new _server.ProtocolError(_server.ProtocolErrorCode.InternalError, "Error getting spreadsheet metadata: ".concat(message), {
242
+ stack: _instanceof(error, Error) ? error.stack : undefined
243
+ });
244
+ case 4:
245
+ return [
246
+ 2
247
+ ];
248
+ }
249
+ });
250
+ }).apply(this, arguments);
251
+ }
252
+ function createTool() {
253
+ return {
254
+ name: 'spreadsheet-metadata-get',
255
+ config: config,
256
+ handler: handler
257
+ };
258
+ }
259
+ /* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/spreadsheet-metadata-get.ts"],"sourcesContent":["import { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst { AuthRequiredBranchSchema } = schemas;\nconst FIELD_MASK = 'spreadsheetId,properties,namedRanges,developerMetadata,dataSources,dataSourceSchedules,sheets(properties,charts,conditionalFormats,protectedRanges,tables,basicFilter,filterViews,bandedRanges,merges,slicers,developerMetadata)';\n\nconst inputSchema = z.object({ id: SpreadsheetIdSchema }).strict();\nconst metadataSchema = z\n .object({\n spreadsheetId: z.string(),\n properties: z.object({}).passthrough().optional(),\n sheets: z.array(z.object({ properties: z.object({}).passthrough().optional() }).passthrough()).optional(),\n })\n .passthrough();\nconst outputSchema = z.discriminatedUnion('type', [\n z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n metadata: metadataSchema.describe('Google spreadsheet envelope with full workbook and sheet properties and selected structural collections. No grid data, values, or direct cell formatting.'),\n fieldMask: z.string(),\n }),\n AuthRequiredBranchSchema,\n]);\nconst config = {\n description: 'Read full workbook and sheet properties plus charts, named ranges, protections, conditional formats, tables, filters, banded ranges, merges, slicers, developer metadata, data sources and schedules. Returns all sheets without grid data, values or direct cell formatting.',\n annotations: { readOnlyHint: true },\n inputSchema,\n outputSchema: z.object({ result: outputSchema }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.spreadsheet.metadata.get called', { id });\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n const response = await sheets.spreadsheets.get({ spreadsheetId: id, fields: FIELD_MASK });\n const result: Output = outputSchema.parse({ type: 'success', id, metadata: response.data, fieldMask: FIELD_MASK });\n logger.info('sheets.spreadsheet.metadata.get success', { id });\n return {\n content: [{ type: 'text', text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.spreadsheet.metadata.get error', { id, error: message });\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting spreadsheet metadata: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return { name: 'spreadsheet-metadata-get', config, handler } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","FIELD_MASK","inputSchema","z","object","id","SpreadsheetIdSchema","strict","metadataSchema","spreadsheetId","string","properties","passthrough","optional","sheets","array","outputSchema","discriminatedUnion","type","literal","SpreadsheetIdOutput","metadata","describe","fieldMask","config","description","annotations","readOnlyHint","result","handler","extra","logger","response","error","message","info","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","fields","parse","data","content","text","JSON","stringify","structuredContent","Error","String","ProtocolError","ProtocolErrorCode","InternalError","stack","undefined","name"],"mappings":";;;;+BA4DA;;;eAAwBA;;;sBA5DY;2BAEZ;sBAEyB;mBAC/B;4BACS;uBAC8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEzD,IAAM,AAAEC,2BAA6BC,oBAAO,CAApCD;AACR,IAAME,aAAa;AAEnB,IAAMC,cAAcC,MAAC,CAACC,MAAM,CAAC;IAAEC,IAAIC,4BAAmB;AAAC,GAAGC,MAAM;AAChE,IAAMC,iBAAiBL,MAAC,CACrBC,MAAM,CAAC;IACNK,eAAeN,MAAC,CAACO,MAAM;IACvBC,YAAYR,MAAC,CAACC,MAAM,CAAC,CAAC,GAAGQ,WAAW,GAAGC,QAAQ;IAC/CC,QAAQX,MAAC,CAACY,KAAK,CAACZ,MAAC,CAACC,MAAM,CAAC;QAAEO,YAAYR,MAAC,CAACC,MAAM,CAAC,CAAC,GAAGQ,WAAW,GAAGC,QAAQ;IAAG,GAAGD,WAAW,IAAIC,QAAQ;AACzG,GACCD,WAAW;AACd,IAAMI,eAAeb,MAAC,CAACc,kBAAkB,CAAC,QAAQ;IAChDd,MAAC,CAACC,MAAM,CAAC;QACPc,MAAMf,MAAC,CAACgB,OAAO,CAAC;QAChBd,IAAIe,4BAAmB;QACvBC,UAAUb,eAAec,QAAQ,CAAC;QAClCC,WAAWpB,MAAC,CAACO,MAAM;IACrB;IACAX;CACD;AACD,IAAMyB,SAAS;IACbC,aAAa;IACbC,aAAa;QAAEC,cAAc;IAAK;IAClCzB,aAAAA;IACAc,cAAcb,MAAC,CAACC,MAAM,CAAC;QAAEwB,QAAQZ;IAAa;AAChD;AAKA,SAAea;wCAAQ,KAAa,EAAEC,KAAoB;YAAjCzB,IACjB0B,QAGEjB,QACAkB,UACAJ,QAMCK,OACDC;;;;oBAbe7B,KAAF,MAAEA;oBACjB0B,SAASD,MAAMC,MAAM;oBAC3BA,OAAOI,IAAI,CAAC,0CAA0C;wBAAE9B,IAAAA;oBAAG;;;;;;;;;oBAEnDS,SAASsB,IAAAA,cAAS,EAAC;wBAAEC,SAAS;wBAAMC,MAAMC,IAAAA,wBAAU,EAACT,MAAMU,WAAW,CAACF,IAAI;oBAAE;oBAClE;;wBAAMxB,OAAO2B,YAAY,CAACC,GAAG,CAAC;4BAAEjC,eAAeJ;4BAAIsC,QAAQ1C;wBAAW;;;oBAAjF+B,WAAW;oBACXJ,SAAiBZ,aAAa4B,KAAK,CAAC;wBAAE1B,MAAM;wBAAWb,IAAAA;wBAAIgB,UAAUW,SAASa,IAAI;wBAAEtB,WAAWtB;oBAAW;oBAChH8B,OAAOI,IAAI,CAAC,2CAA2C;wBAAE9B,IAAAA;oBAAG;oBAC5D;;wBAAO;4BACLyC,OAAO;gCAAG;oCAAE5B,MAAM;oCAAQ6B,MAAMC,KAAKC,SAAS,CAACrB;gCAAQ;;4BACvDsB,mBAAmB;gCAAEtB,QAAAA;4BAAO;wBAC9B;;;oBACOK;oBACDC,UAAUD,AAAK,YAALA,OAAiBkB,SAAQlB,MAAMC,OAAO,GAAGkB,OAAOnB;oBAChEF,OAAOE,KAAK,CAAC,yCAAyC;wBAAE5B,IAAAA;wBAAI4B,OAAOC;oBAAQ;oBAC3E,MAAM,IAAImB,qBAAa,CAACC,yBAAiB,CAACC,aAAa,EAAE,AAAC,uCAA8C,OAARrB,UAAW;wBACzGsB,OAAOvB,AAAK,YAALA,OAAiBkB,SAAQlB,MAAMuB,KAAK,GAAGC;oBAChD;;;;;;;IAEJ;;AAEe,SAAS3D;IACtB,OAAO;QAAE4D,MAAM;QAA4BlC,QAAAA;QAAQK,SAAAA;IAAQ;AAC7D"}
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/spreadsheet-rename.ts"],"sourcesContent":["import { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n newTitle: z.coerce.string().trim().min(1).describe('New name for the spreadsheet'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n operationSummary: z.string().describe('Summary of the rename operation'),\n itemsProcessed: z.number().describe('Total items attempted (always 1)'),\n itemsChanged: z.number().describe('Successfully renamed (always 1 on success)'),\n completedAt: z.string().describe('ISO datetime when operation completed'),\n id: SpreadsheetIdOutput,\n spreadsheetUrl: z.string().describe('URL of the renamed spreadsheet'),\n oldTitle: z.string().describe('Previous title of the spreadsheet'),\n newTitle: z.string().describe('New title of the spreadsheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Rename a spreadsheet/workbook (the entire document, not individual sheets/tabs)',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.spreadsheet.rename called', { id, newTitle });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // First, get the current spreadsheet title\n const spreadsheetInfo = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'properties.title',\n });\n\n const oldTitle = spreadsheetInfo.data.properties?.title || '';\n\n // Rename the spreadsheet\n await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: [\n {\n updateSpreadsheetProperties: {\n properties: { title: newTitle },\n fields: 'title',\n },\n },\n ],\n },\n });\n\n logger.info('sheets.spreadsheet.rename success', { id, oldTitle, newTitle });\n\n const result: Output = {\n type: 'success' as const,\n operationSummary: `Renamed spreadsheet \"${oldTitle}\" to \"${newTitle}\"`,\n itemsProcessed: 1,\n itemsChanged: 1,\n completedAt: new Date().toISOString(),\n id,\n spreadsheetUrl: `https://docs.google.com/spreadsheets/d/${id}`,\n oldTitle,\n newTitle,\n };\n\n return {\n content: [\n {\n type: 'text' as const,\n text: JSON.stringify(result),\n },\n ],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.spreadsheet.rename error', { error: message });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error renaming spreadsheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'spreadsheet-rename',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","newTitle","coerce","string","trim","min","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","SpreadsheetIdOutput","spreadsheetUrl","oldTitle","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetInfo","sheets","error","message","info","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","fields","data","properties","title","batchUpdate","requestBody","requests","updateSpreadsheetProperties","Date","toISOString","content","text","JSON","stringify","structuredContent","Error","String","ProtocolError","ProtocolErrorCode","InternalError","stack","undefined","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/spreadsheet-rename.ts"],"sourcesContent":["import { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n newTitle: z.coerce.string().trim().min(1).describe('New name for the spreadsheet'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n operationSummary: z.string().describe('Summary of the rename operation'),\n itemsProcessed: z.number().describe('Total items attempted (always 1)'),\n itemsChanged: z.number().describe('Successfully renamed (always 1 on success)'),\n completedAt: z.string().describe('ISO datetime when operation completed'),\n id: SpreadsheetIdOutput,\n spreadsheetUrl: z.string().describe('URL of the renamed spreadsheet'),\n oldTitle: z.string().describe('Previous title of the spreadsheet'),\n newTitle: z.string().describe('New title of the spreadsheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Rename a spreadsheet/workbook (the entire document, not individual sheets/tabs)',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.spreadsheet.rename called', { id, newTitle });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // First, get the current spreadsheet title\n const spreadsheetInfo = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'properties.title',\n });\n\n const oldTitle = spreadsheetInfo.data.properties?.title || '';\n\n // Rename the spreadsheet\n await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: [\n {\n updateSpreadsheetProperties: {\n properties: { title: newTitle },\n fields: 'title',\n },\n },\n ],\n },\n });\n\n logger.info('sheets.spreadsheet.rename success', { id, oldTitle, newTitle });\n\n const result: Output = {\n type: 'success' as const,\n operationSummary: `Renamed spreadsheet \"${oldTitle}\" to \"${newTitle}\"`,\n itemsProcessed: 1,\n itemsChanged: 1,\n completedAt: new Date().toISOString(),\n id,\n spreadsheetUrl: `https://docs.google.com/spreadsheets/d/${id}`,\n oldTitle,\n newTitle,\n };\n\n return {\n content: [\n {\n type: 'text' as const,\n text: JSON.stringify(result),\n },\n ],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.spreadsheet.rename error', { error: message });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error renaming spreadsheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'spreadsheet-rename',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","inputSchema","z","object","id","SpreadsheetIdSchema","newTitle","coerce","string","trim","min","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","SpreadsheetIdOutput","spreadsheetUrl","oldTitle","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","spreadsheetInfo","sheets","error","message","info","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","fields","data","properties","title","batchUpdate","requestBody","requests","updateSpreadsheetProperties","Date","toISOString","content","text","JSON","stringify","structuredContent","Error","String","ProtocolError","ProtocolErrorCode","InternalError","stack","undefined","name"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/validation-set.ts"],"sourcesContent":["import { type sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// Discriminated union for validation rule types\nconst ValidationRuleSchema = z.discriminatedUnion('conditionType', [\n // Dropdown with hardcoded list\n z.object({\n conditionType: z.literal('ONE_OF_LIST'),\n values: z.array(z.string()).min(1).describe('Hardcoded dropdown options'),\n showDropdown: z.boolean().default(true).describe('Show dropdown UI in cells'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Dropdown from range\n z.object({\n conditionType: z.literal('ONE_OF_RANGE'),\n sourceRange: z.string().min(1).describe('A1 notation range containing dropdown options (e.g., \"Options!A1:A10\")'),\n showDropdown: z.boolean().default(true).describe('Show dropdown UI in cells'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Numeric constraints\n z.object({\n conditionType: z.enum(['NUMBER_GREATER', 'NUMBER_LESS', 'NUMBER_BETWEEN']),\n values: z.array(z.number()).min(1).max(2).describe('1 value for GREATER/LESS, 2 values for BETWEEN'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Text constraints\n z.object({\n conditionType: z.enum(['TEXT_CONTAINS', 'TEXT_IS_EMAIL', 'TEXT_IS_URL']),\n values: z.array(z.string()).optional().describe('Text to match (for TEXT_CONTAINS only)'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Date constraints\n z.object({\n conditionType: z.enum(['DATE_AFTER', 'DATE_BEFORE', 'DATE_BETWEEN']),\n values: z.array(z.string()).min(1).max(2).describe('ISO date strings (YYYY-MM-DD)'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Custom formula\n z.object({\n conditionType: z.literal('CUSTOM_FORMULA'),\n formula: z.string().min(1).describe('Custom validation formula (e.g., \"=A1>0\")'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n]);\n\n// Input schema for validation requests\nconst ValidationRequestSchema = z.object({\n range: z.string().min(1).describe('A1 notation range for validation (e.g., \"B2:B100\")'),\n rule: ValidationRuleSchema,\n inputMessage: z.string().optional().describe('Help text shown when cell is selected'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n requests: z.array(ValidationRequestSchema).min(1).max(50).describe('Array of validation rules. 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 sheet with validation'),\n sheetUrl: z.string().describe('URL of the sheet with validation'),\n successCount: z.number().int().nonnegative().describe('Number of validation rules successfully applied'),\n failedRanges: z\n .array(\n z.object({\n range: z.string().describe('A1 notation of range that failed validation setup'),\n error: z.string().describe('Why validation failed for this range'),\n })\n )\n .optional()\n .describe('Only populated if some validation rules failed'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Add data validation rules including dropdowns, numeric constraints, text patterns, date ranges, custom formulas. Supports batch operations for efficiency. Use discriminated conditionType to specify rule type. Best for enforcing data integrity and providing user-friendly input controls.',\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// Map condition types to Google Sheets API format\nfunction buildCondition(rule: z.infer<typeof ValidationRuleSchema>) {\n switch (rule.conditionType) {\n case 'ONE_OF_LIST':\n return {\n type: 'ONE_OF_LIST',\n values: rule.values.map((value) => ({ userEnteredValue: value })),\n };\n case 'ONE_OF_RANGE':\n return {\n type: 'ONE_OF_RANGE',\n values: [{ userEnteredValue: `=${rule.sourceRange}` }],\n };\n case 'NUMBER_GREATER':\n return {\n type: 'NUMBER_GREATER',\n values: [{ userEnteredValue: String(rule.values[0]) }],\n };\n case 'NUMBER_LESS':\n return {\n type: 'NUMBER_LESS',\n values: [{ userEnteredValue: String(rule.values[0]) }],\n };\n case 'NUMBER_BETWEEN':\n return {\n type: 'NUMBER_BETWEEN',\n values: [{ userEnteredValue: String(rule.values[0]) }, { userEnteredValue: String(rule.values[1]) }],\n };\n case 'TEXT_CONTAINS':\n return {\n type: 'TEXT_CONTAINS',\n values: rule.values ? [{ userEnteredValue: rule.values[0] }] : [],\n };\n case 'TEXT_IS_EMAIL':\n return {\n type: 'TEXT_IS_EMAIL',\n values: [],\n };\n case 'TEXT_IS_URL':\n return {\n type: 'TEXT_IS_URL',\n values: [],\n };\n case 'DATE_AFTER':\n return {\n type: 'DATE_AFTER',\n values: [{ userEnteredValue: rule.values[0] }],\n };\n case 'DATE_BEFORE':\n return {\n type: 'DATE_BEFORE',\n values: [{ userEnteredValue: rule.values[0] }],\n };\n case 'DATE_BETWEEN':\n return {\n type: 'DATE_BETWEEN',\n values: [{ userEnteredValue: rule.values[0] }, { userEnteredValue: rule.values[1] }],\n };\n case 'CUSTOM_FORMULA':\n return {\n type: 'CUSTOM_FORMULA',\n values: [{ userEnteredValue: rule.formula.startsWith('=') ? rule.formula : `=${rule.formula}` }],\n };\n default:\n // Exhaustive check - all valid conditionType values should be handled above\n throw new Error(`Unknown condition type: ${(rule as { conditionType: string }).conditionType}`);\n }\n}\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.validation.set called', {\n id,\n gid,\n requestCount: requests.length,\n });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: '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 validation set', { id, gid, requestCount: requests.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n const sheetId = sheet.properties.sheetId;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n // Validate sheetId exists\n if (sheetId === undefined || sheetId === null) {\n logger.error('Sheet ID not available for validation set', { id, gid, sheetTitle });\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Sheet ID not available for ${gid}. Cannot perform validation operations without valid sheet ID.`);\n }\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 validation rule\n const condition = buildCondition(request.rule);\n\n // Build data validation rule - structure matches Schema$DataValidationRule\n const dataValidationRule = {\n condition,\n strict: request.rule.strict,\n showCustomUi: 'showDropdown' in request.rule ? request.rule.showDropdown : undefined,\n inputMessage: request.inputMessage,\n } as sheets_v4.Schema$DataValidationRule;\n\n // Add setDataValidation request\n batchRequests.push({\n setDataValidation: {\n range: gridRange,\n rule: dataValidationRule,\n },\n });\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to build validation rule', {\n range: request.range,\n error: message,\n });\n failedRanges.push({\n range: request.range,\n error: `Failed to build validation rule: ${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.validation.set 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.validation.set 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('Validation set operation failed', {\n id,\n gid,\n requestCount: requests.length,\n error: message,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error setting validation: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'validation-set',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","ValidationRuleSchema","z","discriminatedUnion","object","conditionType","literal","values","array","string","min","describe","showDropdown","boolean","default","strict","sourceRange","enum","number","max","optional","formula","ValidationRequestSchema","range","rule","inputMessage","inputSchema","id","SpreadsheetIdSchema","gid","SheetGidSchema","requests","successBranchSchema","type","SpreadsheetIdOutput","SheetGidOutput","sheetTitle","sheetUrl","successCount","int","nonnegative","failedRanges","error","outputSchema","config","description","result","buildCondition","map","value","userEnteredValue","String","startsWith","Error","handler","extra","logger","sheet","spreadsheetResponse","sheets","sheetId","batchRequests","request","rangeRef","gridRange","condition","dataValidationRule","message","info","requestCount","length","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","properties","ProtocolError","ProtocolErrorCode","InvalidParams","title","undefined","InternalError","parseA1Notation","rangeReferenceToGridRange","showCustomUi","push","setDataValidation","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","stack","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/validation-set.ts"],"sourcesContent":["import { type sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// Discriminated union for validation rule types\nconst ValidationRuleSchema = z.discriminatedUnion('conditionType', [\n // Dropdown with hardcoded list\n z.object({\n conditionType: z.literal('ONE_OF_LIST'),\n values: z.array(z.string()).min(1).describe('Hardcoded dropdown options'),\n showDropdown: z.boolean().default(true).describe('Show dropdown UI in cells'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Dropdown from range\n z.object({\n conditionType: z.literal('ONE_OF_RANGE'),\n sourceRange: z.string().min(1).describe('A1 notation range containing dropdown options (e.g., \"Options!A1:A10\")'),\n showDropdown: z.boolean().default(true).describe('Show dropdown UI in cells'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Numeric constraints\n z.object({\n conditionType: z.enum(['NUMBER_GREATER', 'NUMBER_LESS', 'NUMBER_BETWEEN']),\n values: z.array(z.number()).min(1).max(2).describe('1 value for GREATER/LESS, 2 values for BETWEEN'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Text constraints\n z.object({\n conditionType: z.enum(['TEXT_CONTAINS', 'TEXT_IS_EMAIL', 'TEXT_IS_URL']),\n values: z.array(z.string()).optional().describe('Text to match (for TEXT_CONTAINS only)'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Date constraints\n z.object({\n conditionType: z.enum(['DATE_AFTER', 'DATE_BEFORE', 'DATE_BETWEEN']),\n values: z.array(z.string()).min(1).max(2).describe('ISO date strings (YYYY-MM-DD)'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n // Custom formula\n z.object({\n conditionType: z.literal('CUSTOM_FORMULA'),\n formula: z.string().min(1).describe('Custom validation formula (e.g., \"=A1>0\")'),\n strict: z.boolean().default(true).describe('Reject invalid entries'),\n }),\n]);\n\n// Input schema for validation requests\nconst ValidationRequestSchema = z.object({\n range: z.string().min(1).describe('A1 notation range for validation (e.g., \"B2:B100\")'),\n rule: ValidationRuleSchema,\n inputMessage: z.string().optional().describe('Help text shown when cell is selected'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n requests: z.array(ValidationRequestSchema).min(1).max(50).describe('Array of validation rules. 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 sheet with validation'),\n sheetUrl: z.string().describe('URL of the sheet with validation'),\n successCount: z.number().int().nonnegative().describe('Number of validation rules successfully applied'),\n failedRanges: z\n .array(\n z.object({\n range: z.string().describe('A1 notation of range that failed validation setup'),\n error: z.string().describe('Why validation failed for this range'),\n })\n )\n .optional()\n .describe('Only populated if some validation rules failed'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Add data validation rules including dropdowns, numeric constraints, text patterns, date ranges, custom formulas. Supports batch operations for efficiency. Use discriminated conditionType to specify rule type. Best for enforcing data integrity and providing user-friendly input controls.',\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// Map condition types to Google Sheets API format\nfunction buildCondition(rule: z.infer<typeof ValidationRuleSchema>) {\n switch (rule.conditionType) {\n case 'ONE_OF_LIST':\n return {\n type: 'ONE_OF_LIST',\n values: rule.values.map((value) => ({ userEnteredValue: value })),\n };\n case 'ONE_OF_RANGE':\n return {\n type: 'ONE_OF_RANGE',\n values: [{ userEnteredValue: `=${rule.sourceRange}` }],\n };\n case 'NUMBER_GREATER':\n return {\n type: 'NUMBER_GREATER',\n values: [{ userEnteredValue: String(rule.values[0]) }],\n };\n case 'NUMBER_LESS':\n return {\n type: 'NUMBER_LESS',\n values: [{ userEnteredValue: String(rule.values[0]) }],\n };\n case 'NUMBER_BETWEEN':\n return {\n type: 'NUMBER_BETWEEN',\n values: [{ userEnteredValue: String(rule.values[0]) }, { userEnteredValue: String(rule.values[1]) }],\n };\n case 'TEXT_CONTAINS':\n return {\n type: 'TEXT_CONTAINS',\n values: rule.values ? [{ userEnteredValue: rule.values[0] }] : [],\n };\n case 'TEXT_IS_EMAIL':\n return {\n type: 'TEXT_IS_EMAIL',\n values: [],\n };\n case 'TEXT_IS_URL':\n return {\n type: 'TEXT_IS_URL',\n values: [],\n };\n case 'DATE_AFTER':\n return {\n type: 'DATE_AFTER',\n values: [{ userEnteredValue: rule.values[0] }],\n };\n case 'DATE_BEFORE':\n return {\n type: 'DATE_BEFORE',\n values: [{ userEnteredValue: rule.values[0] }],\n };\n case 'DATE_BETWEEN':\n return {\n type: 'DATE_BETWEEN',\n values: [{ userEnteredValue: rule.values[0] }, { userEnteredValue: rule.values[1] }],\n };\n case 'CUSTOM_FORMULA':\n return {\n type: 'CUSTOM_FORMULA',\n values: [{ userEnteredValue: rule.formula.startsWith('=') ? rule.formula : `=${rule.formula}` }],\n };\n default:\n // Exhaustive check - all valid conditionType values should be handled above\n throw new Error(`Unknown condition type: ${(rule as { conditionType: string }).conditionType}`);\n }\n}\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.validation.set called', {\n id,\n gid,\n requestCount: requests.length,\n });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: '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 validation set', { id, gid, requestCount: requests.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n const sheetId = sheet.properties.sheetId;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n // Validate sheetId exists\n if (sheetId === undefined || sheetId === null) {\n logger.error('Sheet ID not available for validation set', { id, gid, sheetTitle });\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Sheet ID not available for ${gid}. Cannot perform validation operations without valid sheet ID.`);\n }\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 validation rule\n const condition = buildCondition(request.rule);\n\n // Build data validation rule - structure matches Schema$DataValidationRule\n const dataValidationRule = {\n condition,\n strict: request.rule.strict,\n showCustomUi: 'showDropdown' in request.rule ? request.rule.showDropdown : undefined,\n inputMessage: request.inputMessage,\n } as sheets_v4.Schema$DataValidationRule;\n\n // Add setDataValidation request\n batchRequests.push({\n setDataValidation: {\n range: gridRange,\n rule: dataValidationRule,\n },\n });\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.info('Failed to build validation rule', {\n range: request.range,\n error: message,\n });\n failedRanges.push({\n range: request.range,\n error: `Failed to build validation rule: ${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.validation.set 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.validation.set 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('Validation set operation failed', {\n id,\n gid,\n requestCount: requests.length,\n error: message,\n });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error setting validation: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'validation-set',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","ValidationRuleSchema","z","discriminatedUnion","object","conditionType","literal","values","array","string","min","describe","showDropdown","boolean","default","strict","sourceRange","enum","number","max","optional","formula","ValidationRequestSchema","range","rule","inputMessage","inputSchema","id","SpreadsheetIdSchema","gid","SheetGidSchema","requests","successBranchSchema","type","SpreadsheetIdOutput","SheetGidOutput","sheetTitle","sheetUrl","successCount","int","nonnegative","failedRanges","error","outputSchema","config","description","result","buildCondition","map","value","userEnteredValue","String","startsWith","Error","handler","extra","logger","sheet","spreadsheetResponse","sheets","sheetId","batchRequests","request","rangeRef","gridRange","condition","dataValidationRule","message","info","requestCount","length","sheetsApi","version","auth","googleAuth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","properties","ProtocolError","ProtocolErrorCode","InvalidParams","title","undefined","InternalError","parseA1Notation","rangeReferenceToGridRange","showCustomUi","push","setDataValidation","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","stack","name"],"mappings":"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"}