@mcp-z/mcp-sheets 2.4.2 → 2.5.1

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 (119) hide show
  1. package/README.md +45 -29
  2. package/dist/cjs/constants.d.cts +26 -0
  3. package/dist/cjs/constants.d.ts +26 -0
  4. package/dist/cjs/constants.js +83 -3
  5. package/dist/cjs/constants.js.map +1 -1
  6. package/dist/cjs/mcp/tools/cells-copy.d.cts +165 -0
  7. package/dist/cjs/mcp/tools/cells-copy.d.ts +165 -0
  8. package/dist/cjs/mcp/tools/cells-copy.js +388 -0
  9. package/dist/cjs/mcp/tools/cells-copy.js.map +1 -0
  10. package/dist/cjs/mcp/tools/cells-format.d.cts +3 -3
  11. package/dist/cjs/mcp/tools/cells-format.d.ts +3 -3
  12. package/dist/cjs/mcp/tools/cells-format.js +3 -2
  13. package/dist/cjs/mcp/tools/cells-format.js.map +1 -1
  14. package/dist/cjs/mcp/tools/columns-get.d.cts +2 -2
  15. package/dist/cjs/mcp/tools/columns-get.d.ts +2 -2
  16. package/dist/cjs/mcp/tools/columns-get.js +2 -1
  17. package/dist/cjs/mcp/tools/columns-get.js.map +1 -1
  18. package/dist/cjs/mcp/tools/columns-update.d.cts +1 -1
  19. package/dist/cjs/mcp/tools/columns-update.d.ts +1 -1
  20. package/dist/cjs/mcp/tools/columns-update.js +3 -2
  21. package/dist/cjs/mcp/tools/columns-update.js.map +1 -1
  22. package/dist/cjs/mcp/tools/index.d.cts +1 -0
  23. package/dist/cjs/mcp/tools/index.d.ts +1 -0
  24. package/dist/cjs/mcp/tools/index.js +4 -0
  25. package/dist/cjs/mcp/tools/index.js.map +1 -1
  26. package/dist/cjs/mcp/tools/rows-append.d.cts +1 -1
  27. package/dist/cjs/mcp/tools/rows-append.d.ts +1 -1
  28. package/dist/cjs/mcp/tools/rows-append.js +2 -1
  29. package/dist/cjs/mcp/tools/rows-append.js.map +1 -1
  30. package/dist/cjs/mcp/tools/rows-csv-append.d.cts +1 -1
  31. package/dist/cjs/mcp/tools/rows-csv-append.d.ts +1 -1
  32. package/dist/cjs/mcp/tools/rows-csv-append.js +2 -1
  33. package/dist/cjs/mcp/tools/rows-csv-append.js.map +1 -1
  34. package/dist/cjs/mcp/tools/rows-get.d.cts +2 -2
  35. package/dist/cjs/mcp/tools/rows-get.d.ts +2 -2
  36. package/dist/cjs/mcp/tools/rows-get.js +2 -1
  37. package/dist/cjs/mcp/tools/rows-get.js.map +1 -1
  38. package/dist/cjs/mcp/tools/values-batch-update.d.cts +1 -1
  39. package/dist/cjs/mcp/tools/values-batch-update.d.ts +1 -1
  40. package/dist/cjs/mcp/tools/values-batch-update.js +3 -2
  41. package/dist/cjs/mcp/tools/values-batch-update.js.map +1 -1
  42. package/dist/cjs/mcp/tools/values-csv-update.d.cts +1 -1
  43. package/dist/cjs/mcp/tools/values-csv-update.d.ts +1 -1
  44. package/dist/cjs/mcp/tools/values-csv-update.js +3 -2
  45. package/dist/cjs/mcp/tools/values-csv-update.js.map +1 -1
  46. package/dist/cjs/mcp/tools/values-search.d.cts +2 -2
  47. package/dist/cjs/mcp/tools/values-search.d.ts +2 -2
  48. package/dist/cjs/mcp/tools/values-search.js +2 -1
  49. package/dist/cjs/mcp/tools/values-search.js.map +1 -1
  50. package/dist/cjs/schemas/index.d.cts +1 -0
  51. package/dist/cjs/schemas/index.d.ts +1 -0
  52. package/dist/cjs/schemas/index.js +16 -0
  53. package/dist/cjs/schemas/index.js.map +1 -1
  54. package/dist/cjs/setup/config.js +26 -14
  55. package/dist/cjs/setup/config.js.map +1 -1
  56. package/dist/cjs/setup/version-help.js +1 -1
  57. package/dist/cjs/setup/version-help.js.map +1 -1
  58. package/dist/cjs/spreadsheet/data-operations.js +60 -181
  59. package/dist/cjs/spreadsheet/data-operations.js.map +1 -1
  60. package/dist/cjs/spreadsheet/range-operations.d.cts +27 -5
  61. package/dist/cjs/spreadsheet/range-operations.d.ts +27 -5
  62. package/dist/cjs/spreadsheet/range-operations.js +48 -28
  63. package/dist/cjs/spreadsheet/range-operations.js.map +1 -1
  64. package/dist/cjs/spreadsheet/sheet-operations.d.cts +6 -0
  65. package/dist/cjs/spreadsheet/sheet-operations.d.ts +6 -0
  66. package/dist/cjs/spreadsheet/sheet-operations.js +114 -124
  67. package/dist/cjs/spreadsheet/sheet-operations.js.map +1 -1
  68. package/dist/esm/constants.d.ts +26 -0
  69. package/dist/esm/constants.js +55 -0
  70. package/dist/esm/constants.js.map +1 -1
  71. package/dist/esm/mcp/tools/cells-copy.d.ts +165 -0
  72. package/dist/esm/mcp/tools/cells-copy.js +190 -0
  73. package/dist/esm/mcp/tools/cells-copy.js.map +1 -0
  74. package/dist/esm/mcp/tools/cells-format.d.ts +3 -3
  75. package/dist/esm/mcp/tools/cells-format.js +3 -2
  76. package/dist/esm/mcp/tools/cells-format.js.map +1 -1
  77. package/dist/esm/mcp/tools/columns-get.d.ts +2 -2
  78. package/dist/esm/mcp/tools/columns-get.js +2 -1
  79. package/dist/esm/mcp/tools/columns-get.js.map +1 -1
  80. package/dist/esm/mcp/tools/columns-update.d.ts +1 -1
  81. package/dist/esm/mcp/tools/columns-update.js +3 -2
  82. package/dist/esm/mcp/tools/columns-update.js.map +1 -1
  83. package/dist/esm/mcp/tools/index.d.ts +1 -0
  84. package/dist/esm/mcp/tools/index.js +1 -0
  85. package/dist/esm/mcp/tools/index.js.map +1 -1
  86. package/dist/esm/mcp/tools/rows-append.d.ts +1 -1
  87. package/dist/esm/mcp/tools/rows-append.js +2 -1
  88. package/dist/esm/mcp/tools/rows-append.js.map +1 -1
  89. package/dist/esm/mcp/tools/rows-csv-append.d.ts +1 -1
  90. package/dist/esm/mcp/tools/rows-csv-append.js +2 -1
  91. package/dist/esm/mcp/tools/rows-csv-append.js.map +1 -1
  92. package/dist/esm/mcp/tools/rows-get.d.ts +2 -2
  93. package/dist/esm/mcp/tools/rows-get.js +2 -1
  94. package/dist/esm/mcp/tools/rows-get.js.map +1 -1
  95. package/dist/esm/mcp/tools/values-batch-update.d.ts +1 -1
  96. package/dist/esm/mcp/tools/values-batch-update.js +3 -2
  97. package/dist/esm/mcp/tools/values-batch-update.js.map +1 -1
  98. package/dist/esm/mcp/tools/values-csv-update.d.ts +1 -1
  99. package/dist/esm/mcp/tools/values-csv-update.js +3 -2
  100. package/dist/esm/mcp/tools/values-csv-update.js.map +1 -1
  101. package/dist/esm/mcp/tools/values-search.d.ts +2 -2
  102. package/dist/esm/mcp/tools/values-search.js +2 -1
  103. package/dist/esm/mcp/tools/values-search.js.map +1 -1
  104. package/dist/esm/schemas/index.d.ts +1 -0
  105. package/dist/esm/schemas/index.js +9 -0
  106. package/dist/esm/schemas/index.js.map +1 -1
  107. package/dist/esm/setup/config.js +26 -14
  108. package/dist/esm/setup/config.js.map +1 -1
  109. package/dist/esm/setup/version-help.js +7 -0
  110. package/dist/esm/setup/version-help.js.map +1 -1
  111. package/dist/esm/spreadsheet/data-operations.js +47 -95
  112. package/dist/esm/spreadsheet/data-operations.js.map +1 -1
  113. package/dist/esm/spreadsheet/range-operations.d.ts +27 -5
  114. package/dist/esm/spreadsheet/range-operations.js +50 -27
  115. package/dist/esm/spreadsheet/range-operations.js.map +1 -1
  116. package/dist/esm/spreadsheet/sheet-operations.d.ts +6 -0
  117. package/dist/esm/spreadsheet/sheet-operations.js +88 -79
  118. package/dist/esm/spreadsheet/sheet-operations.js.map +1 -1
  119. package/package.json +3 -3
@@ -25,11 +25,11 @@ declare const inputSchema: z.ZodObject<{
25
25
  }>>;
26
26
  numberFormat: z.ZodOptional<z.ZodObject<{
27
27
  type: z.ZodEnum<{
28
+ DATE: "DATE";
28
29
  TEXT: "TEXT";
29
30
  NUMBER: "NUMBER";
30
31
  PERCENT: "PERCENT";
31
32
  CURRENCY: "CURRENCY";
32
- DATE: "DATE";
33
33
  TIME: "TIME";
34
34
  }>;
35
35
  pattern: z.ZodOptional<z.ZodString>;
@@ -71,7 +71,7 @@ declare function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Pr
71
71
  export default function createTool(): {
72
72
  name: string;
73
73
  config: {
74
- readonly 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.";
74
+ readonly 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. Date/time cells: numberFormat {type:\"DATE\", pattern:\"yyyy-mm-dd hh:mm\"} only displays a numeric serial as a date; it does not convert text. Dates: a date-looking string is not necessarily a native date. See values-batch-update for the native-date write, format and read-back steps.";
75
75
  readonly inputSchema: z.ZodObject<{
76
76
  id: z.ZodString;
77
77
  gid: z.ZodCoercedString<unknown>;
@@ -96,11 +96,11 @@ export default function createTool(): {
96
96
  }>>;
97
97
  numberFormat: z.ZodOptional<z.ZodObject<{
98
98
  type: z.ZodEnum<{
99
+ DATE: "DATE";
99
100
  TEXT: "TEXT";
100
101
  NUMBER: "NUMBER";
101
102
  PERCENT: "PERCENT";
102
103
  CURRENCY: "CURRENCY";
103
- DATE: "DATE";
104
104
  TIME: "TIME";
105
105
  }>;
106
106
  pattern: z.ZodOptional<z.ZodString>;
@@ -3,6 +3,7 @@ import { schemas } from '@mcp-z/oauth-google';
3
3
  const { AuthRequiredBranchSchema } = schemas;
4
4
  import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
5
5
  import { z } from 'zod';
6
+ import { NATIVE_DATE_POINTER } from '../../constants.js';
6
7
  import { googleAuth } from '../../lib/google-auth.js';
7
8
  import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
8
9
  import { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.js';
@@ -22,7 +23,7 @@ const NumberFormatSchema = z.object({
22
23
  'DATE',
23
24
  'TIME'
24
25
  ]).describe('Number format type'),
25
- pattern: z.string().optional().describe('Custom format pattern (e.g., "$#,##0.00" for currency)')
26
+ pattern: z.string().optional().describe('Custom format pattern (e.g., "$#,##0.00" for currency, "yyyy-mm-dd hh:mm" for a date/time serial)')
26
27
  });
27
28
  // Border schema
28
29
  const BorderSchema = z.object({
@@ -70,7 +71,7 @@ const outputSchema = z.discriminatedUnion('type', [
70
71
  AuthRequiredBranchSchema
71
72
  ]);
72
73
  const config = {
73
- 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.',
74
+ 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. Date/time cells: numberFormat {type:"DATE", pattern:"yyyy-mm-dd hh:mm"} only displays a numeric serial as a date; it does not convert text. ${NATIVE_DATE_POINTER}`,
74
75
  inputSchema,
75
76
  outputSchema: z.object({
76
77
  result: outputSchema
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-format.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// 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 = 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 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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","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","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/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-format.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 { NATIVE_DATE_POINTER } from '../../constants.ts';\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, \"yyyy-mm-dd hh:mm\" for a date/time serial)'),\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. Date/time cells: numberFormat {type:\"DATE\", pattern:\"yyyy-mm-dd hh:mm\"} only displays a numeric serial as a date; it does not convert text. ${NATIVE_DATE_POINTER}`,\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 = 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 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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","NATIVE_DATE_POINTER","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","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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"}
@@ -6,8 +6,8 @@ declare const inputSchema: z.ZodObject<{
6
6
  id: z.ZodString;
7
7
  gid: z.ZodCoercedString<unknown>;
8
8
  render: z.ZodOptional<z.ZodEnum<{
9
- FORMATTED_VALUE: "FORMATTED_VALUE";
10
9
  UNFORMATTED_VALUE: "UNFORMATTED_VALUE";
10
+ FORMATTED_VALUE: "FORMATTED_VALUE";
11
11
  FORMULA: "FORMULA";
12
12
  }>>;
13
13
  }, z.core.$strip>;
@@ -32,8 +32,8 @@ export default function createTool(): {
32
32
  id: z.ZodString;
33
33
  gid: z.ZodCoercedString<unknown>;
34
34
  render: z.ZodOptional<z.ZodEnum<{
35
- FORMATTED_VALUE: "FORMATTED_VALUE";
36
35
  UNFORMATTED_VALUE: "UNFORMATTED_VALUE";
36
+ FORMATTED_VALUE: "FORMATTED_VALUE";
37
37
  FORMULA: "FORMULA";
38
38
  }>>;
39
39
  }, z.core.$strip>;
@@ -3,6 +3,7 @@ import { schemas } from '@mcp-z/oauth-google';
3
3
  const { AuthRequiredBranchSchema } = schemas;
4
4
  import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
5
5
  import { z } from 'zod';
6
+ import { RENDER_DESCRIPTION } from '../../constants.js';
6
7
  import { googleAuth } from '../../lib/google-auth.js';
7
8
  import { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.js';
8
9
  const inputSchema = z.object({
@@ -12,7 +13,7 @@ const inputSchema = z.object({
12
13
  'FORMATTED_VALUE',
13
14
  'UNFORMATTED_VALUE',
14
15
  'FORMULA'
15
- ]).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.')
16
+ ]).optional().describe(RENDER_DESCRIPTION)
16
17
  });
17
18
  // Success branch schema - uses columns: for consistency with standard vocabulary
18
19
  const successBranchSchema = z.object({
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/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 { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidSchema, 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 = 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 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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","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","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/open-source/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 { 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 { RENDER_DESCRIPTION } from '../../constants.ts';\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(RENDER_DESCRIPTION),\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 = 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 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":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","RENDER_DESCRIPTION","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","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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"}
@@ -42,7 +42,7 @@ declare function handler({ id, gid, rows, headers, updateBy, behavior, valueInpu
42
42
  export default function createTool(): {
43
43
  name: string;
44
44
  config: {
45
- readonly description: "Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows.";
45
+ readonly description: "Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows. Dates: a date-looking string is not necessarily a native date. See values-batch-update for the native-date write, format and read-back steps.";
46
46
  readonly inputSchema: z.ZodObject<{
47
47
  id: z.ZodString;
48
48
  gid: z.ZodCoercedString<unknown>;
@@ -3,6 +3,7 @@ import { schemas } from '@mcp-z/oauth-google';
3
3
  const { AuthRequiredBranchSchema } = schemas;
4
4
  import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
5
5
  import { z } from 'zod';
6
+ import { NATIVE_DATE_POINTER } from '../../constants.js';
6
7
  import { googleAuth } from '../../lib/google-auth.js';
7
8
  import { SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
8
9
  import { generateRowKey, snapshotHeaderKeysAndPositions, upsertByKey } from '../../spreadsheet/data-operations.js';
@@ -21,7 +22,7 @@ const inputSchema = z.object({
21
22
  valueInputOption: z.enum([
22
23
  'RAW',
23
24
  'USER_ENTERED'
24
- ]).default('USER_ENTERED').describe('How input data should be interpreted (RAW = exact values, USER_ENTERED = parsed like user input with formulas, dates, etc.)')
25
+ ]).default('USER_ENTERED').describe('How input data should be interpreted (default USER_ENTERED = parsed like user input with formulas, dates per the workbook locale, etc.; RAW = exact values, date strings stay text, numeric serials stay numbers)')
25
26
  }).refine((data)=>{
26
27
  // Validate that all updateBy columns exist in headers
27
28
  const missingColumns = data.updateBy.filter((col)=>!data.headers.includes(col));
@@ -70,7 +71,7 @@ const outputSchema = z.discriminatedUnion('type', [
70
71
  AuthRequiredBranchSchema
71
72
  ]);
72
73
  const config = {
73
- description: 'Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows.',
74
+ description: `Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows. ${NATIVE_DATE_POINTER}`,
74
75
  inputSchema,
75
76
  outputSchema: z.object({
76
77
  result: outputSchema
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-update.ts"],"sourcesContent":["import { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { generateRowKey, type KeyGenerationStrategy, type Row, snapshotHeaderKeysAndPositions, type UpsertOptions, upsertByKey } from '../../spreadsheet/data-operations.ts';\n\n// Input schema for columns update requests with enhanced validation\nconst inputSchema = z\n .object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n rows: z.array(z.array(SheetCellSchema)).min(1).max(1000).describe('Array of rows to upsert (max 1000 rows per request). Each row is an array of cell values matching the headers array'),\n headers: z.array(z.string().min(1).max(100)).min(1).max(50).describe('Array of column names/headers (max 50 columns). Must match the length of each row in the rows array'),\n updateBy: z.array(z.string().min(1).max(100)).min(1).max(10).describe('Array of column names to use as unique keys for matching existing rows (max 10 key columns). These columns must exist in the headers array'),\n behavior: z\n .enum(['add-or-update', 'update-only', 'add-only'])\n .default('add-or-update')\n .describe('Update behavior: add-or-update (default) adds new rows and updates existing, update-only skips new rows, add-only skips existing rows. BEST FOR: Bulk upsert operations with key matching in structured database or table contexts.'),\n valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How input data should be interpreted (RAW = exact values, USER_ENTERED = parsed like user input with formulas, dates, etc.)'),\n })\n .refine(\n (data) => {\n // Validate that all updateBy columns exist in headers\n const missingColumns = data.updateBy.filter((col) => !data.headers.includes(col));\n return missingColumns.length === 0;\n },\n {\n message: 'All updateBy columns must exist in the headers array',\n path: ['updateBy'],\n }\n )\n .refine(\n (data) => {\n // Validate that all rows have the same length as headers\n const invalidRows = data.rows.findIndex((row) => row.length !== data.headers.length);\n return invalidRows === -1;\n },\n {\n message: 'All rows must have the same length as the headers array',\n path: ['rows'],\n }\n )\n .refine(\n (data) => {\n // Validate that updateBy columns are unique\n const uniqueColumns = new Set(data.updateBy);\n return uniqueColumns.size === data.updateBy.length;\n },\n {\n message: 'updateBy columns must be unique',\n path: ['updateBy'],\n }\n );\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n spreadsheetTitle: z.string().describe('Title of the updated spreadsheet'),\n spreadsheetUrl: z.string().describe('URL of the updated spreadsheet'),\n sheetTitle: z.string().describe('Title of the updated sheet'),\n sheetUrl: z.string().describe('URL of the updated sheet'),\n updatedRows: z.number().int().nonnegative().describe('Number of rows that were successfully updated or inserted'),\n insertedKeys: z.array(z.string()).describe('Keys of rows that were successfully inserted (new rows)'),\n rowsSkipped: z.number().int().nonnegative().describe('Number of rows that were skipped based on the update behavior and existing data'),\n headersAdded: z.array(z.string()).describe('Column headers that were added to the sheet (if any were missing)'),\n errors: z.array(z.string()).optional().describe('Any non-fatal errors encountered during the operation'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows.',\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// Helper function to ensure consistent key generation\nfunction generateConsistentRowKey(row: Row, headers: string[], strategy: KeyGenerationStrategy): string {\n return generateRowKey(row, headers, strategy);\n}\n\nasync function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-update', valueInputOption = 'USER_ENTERED' }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.debug?.('sheets.columns.update called', {\n id,\n gid,\n rowCount: rows.length,\n headerCount: headers.length,\n updateByColumns: updateBy,\n behavior,\n valueInputOption,\n });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Note: Basic input validation is now handled by the enhanced Zod schema\n\n // EARLY VALIDATION: Validate that updateBy columns have non-empty values for all rows\n // This validation happens before finding spreadsheet/sheet to fail fast\n const emptyKeyErrors: string[] = [];\n rows.forEach((row, rowIndex) => {\n const keyValues = updateBy.map((keyCol) => {\n const colIndex = headers.indexOf(keyCol);\n return colIndex >= 0 ? String(row[colIndex] ?? '').trim() : '';\n });\n\n if (keyValues.some((val) => val === '')) {\n emptyKeyErrors.push(`Row ${rowIndex + 1} has empty key values for columns: ${updateBy.join(', ')}`);\n }\n });\n\n if (emptyKeyErrors.length > 0) {\n const message = `Silent data loss prevented - empty key columns detected:\\n${emptyKeyErrors.join('\\n')}`;\n logger.error?.('sheets.columns.update error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, message);\n }\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n });\n\n const spreadsheetData = spreadsheetResponse.data;\n const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n // Find sheet by gid\n const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.warn?.('Sheet not found for columns update', { id, gid, rowCount: rows.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n const sheetGid = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n // Configure upsert options based on behavior\n const upsertOptions: UpsertOptions = {\n keyStrategy: {\n keyColumns: updateBy,\n useProviderIdLogic: false, // Use standard key generation for column-based updates\n separator: '\\\\',\n },\n allowUpdates: behavior === 'add-or-update' || behavior === 'update-only',\n batchSize: 50,\n valueInputOption: valueInputOption,\n };\n\n // Get existing keys to implement behavior filtering\n const { keySet: existingKeys } = await snapshotHeaderKeysAndPositions(sheets, id, sheetTitle, updateBy, upsertOptions.keyStrategy);\n\n // Filter rows based on behavior using consistent key generation\n let processedRows = rows;\n if (behavior === 'add-only') {\n // Only include rows that don't exist yet\n processedRows = rows.filter((row) => {\n // Use the same key generation strategy as the upsert function\n const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n return key !== '' && !existingKeys.has(key);\n });\n logger.debug?.('Filtered rows for add-only behavior', {\n originalCount: rows.length,\n filteredCount: processedRows.length,\n });\n } else if (behavior === 'update-only') {\n // Only include rows that already exist\n processedRows = rows.filter((row) => {\n // Use the same key generation strategy as the upsert function\n const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n return key !== '' && existingKeys.has(key);\n });\n logger.debug?.('Filtered rows for update-only behavior', {\n originalCount: rows.length,\n filteredCount: processedRows.length,\n });\n }\n\n // Early return if no rows to process after behavior filtering\n if (processedRows.length === 0) {\n logger.info?.('No rows to process after behavior filtering', { behavior, originalCount: rows.length });\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetGid),\n spreadsheetTitle: spreadsheetTitle || '',\n spreadsheetUrl: spreadsheetUrl || '',\n sheetTitle,\n sheetUrl,\n updatedRows: 0,\n insertedKeys: [],\n rowsSkipped: rows.length,\n headersAdded: [],\n errors: [`No rows matched behavior '${behavior}' - all ${rows.length} rows were skipped`],\n };\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.debug?.('sheets.columns.update executing upsert operation', {\n spreadsheetId: id,\n sheetTitle,\n canonicalHeaders: headers,\n keyColumns: updateBy,\n behavior,\n processedRowsCount: processedRows.length,\n });\n\n // Execute the upsert operation using the shared function\n const upsertResult = await upsertByKey(sheets, {\n spreadsheetId: id,\n sheetTitle,\n rows: processedRows,\n canonicalHeaders: headers,\n options: upsertOptions,\n logger,\n });\n\n // Track headers that were added (if any)\n // This would require additional logic in upsertByKey to return added headers\n const headersAdded: string[] = [];\n\n // Calculate total rows skipped: behavior filter + upsert duplicates\n const rowsFilteredByBehavior = rows.length - processedRows.length;\n const totalRowsSkipped = upsertResult.rowsSkipped + rowsFilteredByBehavior;\n\n logger.debug?.('sheets.columns.update completed successfully', {\n updatedRows: upsertResult.updatedRows,\n insertedCount: upsertResult.inserted.length,\n rowsSkipped: totalRowsSkipped,\n rowsFilteredByBehavior,\n rowsSkippedByUpsert: upsertResult.rowsSkipped,\n errorsCount: upsertResult.errors?.length || 0,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetGid),\n spreadsheetTitle: spreadsheetTitle || '',\n spreadsheetUrl: spreadsheetUrl || '',\n sheetTitle,\n sheetUrl,\n updatedRows: upsertResult.updatedRows,\n insertedKeys: upsertResult.inserted,\n rowsSkipped: totalRowsSkipped,\n headersAdded,\n errors: upsertResult.errors,\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.columns.update error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error updating columns: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'columns-update',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetCellSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","generateRowKey","snapshotHeaderKeysAndPositions","upsertByKey","inputSchema","object","id","gid","rows","array","min","max","describe","headers","string","updateBy","behavior","enum","default","valueInputOption","refine","data","missingColumns","filter","col","includes","length","message","path","invalidRows","findIndex","row","uniqueColumns","Set","size","successBranchSchema","type","literal","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRows","number","int","nonnegative","insertedKeys","rowsSkipped","headersAdded","errors","optional","outputSchema","discriminatedUnion","config","description","result","generateConsistentRowKey","strategy","handler","extra","logger","debug","rowCount","headerCount","updateByColumns","spreadsheetData","sheet","upsertResult","version","auth","authContext","emptyKeyErrors","forEach","rowIndex","keyValues","map","keyCol","colIndex","indexOf","String","trim","some","val","push","join","error","InvalidParams","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","properties","title","find","s","sheetId","warn","sheetGid","upsertOptions","keyStrategy","keyColumns","useProviderIdLogic","separator","allowUpdates","batchSize","keySet","existingKeys","processedRows","key","has","originalCount","filteredCount","info","content","text","JSON","stringify","structuredContent","canonicalHeaders","processedRowsCount","options","rowsFilteredByBehavior","totalRowsSkipped","insertedCount","inserted","rowsSkippedByUpsert","errorsCount","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/columns-update.ts"],"sourcesContent":["import { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { NATIVE_DATE_POINTER } from '../../constants.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { generateRowKey, type KeyGenerationStrategy, type Row, snapshotHeaderKeysAndPositions, type UpsertOptions, upsertByKey } from '../../spreadsheet/data-operations.ts';\n\n// Input schema for columns update requests with enhanced validation\nconst inputSchema = z\n .object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n rows: z.array(z.array(SheetCellSchema)).min(1).max(1000).describe('Array of rows to upsert (max 1000 rows per request). Each row is an array of cell values matching the headers array'),\n headers: z.array(z.string().min(1).max(100)).min(1).max(50).describe('Array of column names/headers (max 50 columns). Must match the length of each row in the rows array'),\n updateBy: z.array(z.string().min(1).max(100)).min(1).max(10).describe('Array of column names to use as unique keys for matching existing rows (max 10 key columns). These columns must exist in the headers array'),\n behavior: z\n .enum(['add-or-update', 'update-only', 'add-only'])\n .default('add-or-update')\n .describe('Update behavior: add-or-update (default) adds new rows and updates existing, update-only skips new rows, add-only skips existing rows. BEST FOR: Bulk upsert operations with key matching in structured database or table contexts.'),\n valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How input data should be interpreted (default USER_ENTERED = parsed like user input with formulas, dates per the workbook locale, etc.; RAW = exact values, date strings stay text, numeric serials stay numbers)'),\n })\n .refine(\n (data) => {\n // Validate that all updateBy columns exist in headers\n const missingColumns = data.updateBy.filter((col) => !data.headers.includes(col));\n return missingColumns.length === 0;\n },\n {\n message: 'All updateBy columns must exist in the headers array',\n path: ['updateBy'],\n }\n )\n .refine(\n (data) => {\n // Validate that all rows have the same length as headers\n const invalidRows = data.rows.findIndex((row) => row.length !== data.headers.length);\n return invalidRows === -1;\n },\n {\n message: 'All rows must have the same length as the headers array',\n path: ['rows'],\n }\n )\n .refine(\n (data) => {\n // Validate that updateBy columns are unique\n const uniqueColumns = new Set(data.updateBy);\n return uniqueColumns.size === data.updateBy.length;\n },\n {\n message: 'updateBy columns must be unique',\n path: ['updateBy'],\n }\n );\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n spreadsheetTitle: z.string().describe('Title of the updated spreadsheet'),\n spreadsheetUrl: z.string().describe('URL of the updated spreadsheet'),\n sheetTitle: z.string().describe('Title of the updated sheet'),\n sheetUrl: z.string().describe('URL of the updated sheet'),\n updatedRows: z.number().int().nonnegative().describe('Number of rows that were successfully updated or inserted'),\n insertedKeys: z.array(z.string()).describe('Keys of rows that were successfully inserted (new rows)'),\n rowsSkipped: z.number().int().nonnegative().describe('Number of rows that were skipped based on the update behavior and existing data'),\n headersAdded: z.array(z.string()).describe('Column headers that were added to the sheet (if any were missing)'),\n errors: z.array(z.string()).optional().describe('Any non-fatal errors encountered during the operation'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: `Update spreadsheet data by column headers with intelligent upsert logic. Supports adding missing columns, flexible update behaviors, and robust error handling. Uses column names as keys for matching existing rows, enabling context-aware data synchronization workflows. ${NATIVE_DATE_POINTER}`,\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// Helper function to ensure consistent key generation\nfunction generateConsistentRowKey(row: Row, headers: string[], strategy: KeyGenerationStrategy): string {\n return generateRowKey(row, headers, strategy);\n}\n\nasync function handler({ id, gid, rows, headers, updateBy, behavior = 'add-or-update', valueInputOption = 'USER_ENTERED' }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.debug?.('sheets.columns.update called', {\n id,\n gid,\n rowCount: rows.length,\n headerCount: headers.length,\n updateByColumns: updateBy,\n behavior,\n valueInputOption,\n });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Note: Basic input validation is now handled by the enhanced Zod schema\n\n // EARLY VALIDATION: Validate that updateBy columns have non-empty values for all rows\n // This validation happens before finding spreadsheet/sheet to fail fast\n const emptyKeyErrors: string[] = [];\n rows.forEach((row, rowIndex) => {\n const keyValues = updateBy.map((keyCol) => {\n const colIndex = headers.indexOf(keyCol);\n return colIndex >= 0 ? String(row[colIndex] ?? '').trim() : '';\n });\n\n if (keyValues.some((val) => val === '')) {\n emptyKeyErrors.push(`Row ${rowIndex + 1} has empty key values for columns: ${updateBy.join(', ')}`);\n }\n });\n\n if (emptyKeyErrors.length > 0) {\n const message = `Silent data loss prevented - empty key columns detected:\\n${emptyKeyErrors.join('\\n')}`;\n logger.error?.('sheets.columns.update error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, message);\n }\n\n // Get spreadsheet and sheet info in single API call\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n });\n\n const spreadsheetData = spreadsheetResponse.data;\n const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n // Find sheet by gid\n const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sheet?.properties) {\n logger.warn?.('Sheet not found for columns update', { id, gid, rowCount: rows.length });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties.title ?? gid;\n const sheetGid = sheet.properties.sheetId ?? 0;\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n // Configure upsert options based on behavior\n const upsertOptions: UpsertOptions = {\n keyStrategy: {\n keyColumns: updateBy,\n useProviderIdLogic: false, // Use standard key generation for column-based updates\n separator: '\\\\',\n },\n allowUpdates: behavior === 'add-or-update' || behavior === 'update-only',\n batchSize: 50,\n valueInputOption: valueInputOption,\n };\n\n // Get existing keys to implement behavior filtering\n const { keySet: existingKeys } = await snapshotHeaderKeysAndPositions(sheets, id, sheetTitle, updateBy, upsertOptions.keyStrategy);\n\n // Filter rows based on behavior using consistent key generation\n let processedRows = rows;\n if (behavior === 'add-only') {\n // Only include rows that don't exist yet\n processedRows = rows.filter((row) => {\n // Use the same key generation strategy as the upsert function\n const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n return key !== '' && !existingKeys.has(key);\n });\n logger.debug?.('Filtered rows for add-only behavior', {\n originalCount: rows.length,\n filteredCount: processedRows.length,\n });\n } else if (behavior === 'update-only') {\n // Only include rows that already exist\n processedRows = rows.filter((row) => {\n // Use the same key generation strategy as the upsert function\n const key = generateConsistentRowKey(row, headers, upsertOptions.keyStrategy);\n return key !== '' && existingKeys.has(key);\n });\n logger.debug?.('Filtered rows for update-only behavior', {\n originalCount: rows.length,\n filteredCount: processedRows.length,\n });\n }\n\n // Early return if no rows to process after behavior filtering\n if (processedRows.length === 0) {\n logger.info?.('No rows to process after behavior filtering', { behavior, originalCount: rows.length });\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetGid),\n spreadsheetTitle: spreadsheetTitle || '',\n spreadsheetUrl: spreadsheetUrl || '',\n sheetTitle,\n sheetUrl,\n updatedRows: 0,\n insertedKeys: [],\n rowsSkipped: rows.length,\n headersAdded: [],\n errors: [`No rows matched behavior '${behavior}' - all ${rows.length} rows were skipped`],\n };\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n }\n\n logger.debug?.('sheets.columns.update executing upsert operation', {\n spreadsheetId: id,\n sheetTitle,\n canonicalHeaders: headers,\n keyColumns: updateBy,\n behavior,\n processedRowsCount: processedRows.length,\n });\n\n // Execute the upsert operation using the shared function\n const upsertResult = await upsertByKey(sheets, {\n spreadsheetId: id,\n sheetTitle,\n rows: processedRows,\n canonicalHeaders: headers,\n options: upsertOptions,\n logger,\n });\n\n // Track headers that were added (if any)\n // This would require additional logic in upsertByKey to return added headers\n const headersAdded: string[] = [];\n\n // Calculate total rows skipped: behavior filter + upsert duplicates\n const rowsFilteredByBehavior = rows.length - processedRows.length;\n const totalRowsSkipped = upsertResult.rowsSkipped + rowsFilteredByBehavior;\n\n logger.debug?.('sheets.columns.update completed successfully', {\n updatedRows: upsertResult.updatedRows,\n insertedCount: upsertResult.inserted.length,\n rowsSkipped: totalRowsSkipped,\n rowsFilteredByBehavior,\n rowsSkippedByUpsert: upsertResult.rowsSkipped,\n errorsCount: upsertResult.errors?.length || 0,\n });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid: String(sheetGid),\n spreadsheetTitle: spreadsheetTitle || '',\n spreadsheetUrl: spreadsheetUrl || '',\n sheetTitle,\n sheetUrl,\n updatedRows: upsertResult.updatedRows,\n insertedKeys: upsertResult.inserted,\n rowsSkipped: totalRowsSkipped,\n headersAdded,\n errors: upsertResult.errors,\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.columns.update error', { error: message });\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error updating columns: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'columns-update',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","NATIVE_DATE_POINTER","googleAuth","SheetCellSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","generateRowKey","snapshotHeaderKeysAndPositions","upsertByKey","inputSchema","object","id","gid","rows","array","min","max","describe","headers","string","updateBy","behavior","enum","default","valueInputOption","refine","data","missingColumns","filter","col","includes","length","message","path","invalidRows","findIndex","row","uniqueColumns","Set","size","successBranchSchema","type","literal","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRows","number","int","nonnegative","insertedKeys","rowsSkipped","headersAdded","errors","optional","outputSchema","discriminatedUnion","config","description","result","generateConsistentRowKey","strategy","handler","extra","logger","debug","rowCount","headerCount","updateByColumns","spreadsheetData","sheet","upsertResult","version","auth","authContext","emptyKeyErrors","forEach","rowIndex","keyValues","map","keyCol","colIndex","indexOf","String","trim","some","val","push","join","error","InvalidParams","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","properties","title","find","s","sheetId","warn","sheetGid","upsertOptions","keyStrategy","keyColumns","useProviderIdLogic","separator","allowUpdates","batchSize","keySet","existingKeys","processedRows","key","has","originalCount","filteredCount","info","content","text","JSON","stringify","structuredContent","canonicalHeaders","processedRowsCount","options","rowsFilteredByBehavior","totalRowsSkipped","insertedCount","inserted","rowsSkippedByUpsert","errorsCount","Error","InternalError","stack","undefined","createTool","name"],"mappings":"AAAA,SAASA,UAAUC,SAAS,QAAQ,qBAAqB;AAEzD,SAASC,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAGrC,SAASE,aAAa,EAAEC,iBAAiB,QAAQ,gBAAgB;AACjE,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,mBAAmB,QAAQ,qBAAqB;AACzD,SAASC,UAAU,QAAQ,2BAA2B;AACtD,SAASC,eAAe,EAAEC,cAAc,EAAEC,cAAc,EAAEC,mBAAmB,EAAEC,mBAAmB,QAAQ,yBAAyB;AACnI,SAASC,cAAc,EAAwCC,8BAA8B,EAAsBC,WAAW,QAAQ,uCAAuC;AAE7K,oEAAoE;AACpE,MAAMC,cAAcX,EACjBY,MAAM,CAAC;IACNC,IAAIN;IACJO,KAAKT;IACLU,MAAMf,EAAEgB,KAAK,CAAChB,EAAEgB,KAAK,CAACb,kBAAkBc,GAAG,CAAC,GAAGC,GAAG,CAAC,MAAMC,QAAQ,CAAC;IAClEC,SAASpB,EAAEgB,KAAK,CAAChB,EAAEqB,MAAM,GAAGJ,GAAG,CAAC,GAAGC,GAAG,CAAC,MAAMD,GAAG,CAAC,GAAGC,GAAG,CAAC,IAAIC,QAAQ,CAAC;IACrEG,UAAUtB,EAAEgB,KAAK,CAAChB,EAAEqB,MAAM,GAAGJ,GAAG,CAAC,GAAGC,GAAG,CAAC,MAAMD,GAAG,CAAC,GAAGC,GAAG,CAAC,IAAIC,QAAQ,CAAC;IACtEI,UAAUvB,EACPwB,IAAI,CAAC;QAAC;QAAiB;QAAe;KAAW,EACjDC,OAAO,CAAC,iBACRN,QAAQ,CAAC;IACZO,kBAAkB1B,EAAEwB,IAAI,CAAC;QAAC;QAAO;KAAe,EAAEC,OAAO,CAAC,gBAAgBN,QAAQ,CAAC;AACrF,GACCQ,MAAM,CACL,CAACC;IACC,sDAAsD;IACtD,MAAMC,iBAAiBD,KAAKN,QAAQ,CAACQ,MAAM,CAAC,CAACC,MAAQ,CAACH,KAAKR,OAAO,CAACY,QAAQ,CAACD;IAC5E,OAAOF,eAAeI,MAAM,KAAK;AACnC,GACA;IACEC,SAAS;IACTC,MAAM;QAAC;KAAW;AACpB,GAEDR,MAAM,CACL,CAACC;IACC,yDAAyD;IACzD,MAAMQ,cAAcR,KAAKb,IAAI,CAACsB,SAAS,CAAC,CAACC,MAAQA,IAAIL,MAAM,KAAKL,KAAKR,OAAO,CAACa,MAAM;IACnF,OAAOG,gBAAgB,CAAC;AAC1B,GACA;IACEF,SAAS;IACTC,MAAM;QAAC;KAAO;AAChB,GAEDR,MAAM,CACL,CAACC;IACC,4CAA4C;IAC5C,MAAMW,gBAAgB,IAAIC,IAAIZ,KAAKN,QAAQ;IAC3C,OAAOiB,cAAcE,IAAI,KAAKb,KAAKN,QAAQ,CAACW,MAAM;AACpD,GACA;IACEC,SAAS;IACTC,MAAM;QAAC;KAAW;AACpB;AAGJ,wBAAwB;AACxB,MAAMO,sBAAsB1C,EAAEY,MAAM,CAAC;IACnC+B,MAAM3C,EAAE4C,OAAO,CAAC;IAChB/B,IAAIP;IACJQ,KAAKV;IACLyC,kBAAkB7C,EAAEqB,MAAM,GAAGF,QAAQ,CAAC;IACtC2B,gBAAgB9C,EAAEqB,MAAM,GAAGF,QAAQ,CAAC;IACpC4B,YAAY/C,EAAEqB,MAAM,GAAGF,QAAQ,CAAC;IAChC6B,UAAUhD,EAAEqB,MAAM,GAAGF,QAAQ,CAAC;IAC9B8B,aAAajD,EAAEkD,MAAM,GAAGC,GAAG,GAAGC,WAAW,GAAGjC,QAAQ,CAAC;IACrDkC,cAAcrD,EAAEgB,KAAK,CAAChB,EAAEqB,MAAM,IAAIF,QAAQ,CAAC;IAC3CmC,aAAatD,EAAEkD,MAAM,GAAGC,GAAG,GAAGC,WAAW,GAAGjC,QAAQ,CAAC;IACrDoC,cAAcvD,EAAEgB,KAAK,CAAChB,EAAEqB,MAAM,IAAIF,QAAQ,CAAC;IAC3CqC,QAAQxD,EAAEgB,KAAK,CAAChB,EAAEqB,MAAM,IAAIoC,QAAQ,GAAGtC,QAAQ,CAAC;AAClD;AAEA,MAAMuC,eAAe1D,EAAE2D,kBAAkB,CAAC,QAAQ;IAACjB;IAAqB7C;CAAyB;AAEjG,MAAM+D,SAAS;IACbC,aAAa,CAAC,6QAA6Q,EAAE5D,qBAAqB;IAClTU;IACA+C,cAAc1D,EAAEY,MAAM,CAAC;QACrBkD,QAAQJ;IACV;AACF;AAKA,sDAAsD;AACtD,SAASK,yBAAyBzB,GAAQ,EAAElB,OAAiB,EAAE4C,QAA+B;IAC5F,OAAOxD,eAAe8B,KAAKlB,SAAS4C;AACtC;AAEA,eAAeC,QAAQ,EAAEpD,EAAE,EAAEC,GAAG,EAAEC,IAAI,EAAEK,OAAO,EAAEE,QAAQ,EAAEC,WAAW,eAAe,EAAEG,mBAAmB,cAAc,EAAS,EAAEwC,KAAoB;QAErJC;IADA,MAAMA,SAASD,MAAMC,MAAM;KAC3BA,gBAAAA,OAAOC,KAAK,cAAZD,oCAAAA,mBAAAA,QAAe,gCAAgC;QAC7CtD;QACAC;QACAuD,UAAUtD,KAAKkB,MAAM;QACrBqC,aAAalD,QAAQa,MAAM;QAC3BsC,iBAAiBjD;QACjBC;QACAG;IACF;IAEA,IAAI;kBAiCqB8C,iCASJC,yBACFA;YAXQD,6BAIXA,yBA0EdL,gBAiCeO,sBANfP;QAxIA,MAAMzE,SAASC,UAAU;YAAEgF,SAAS;YAAMC,MAAM1E,WAAWgE,MAAMW,WAAW,CAACD,IAAI;QAAE;QAEnF,yEAAyE;QAEzE,sFAAsF;QACtF,wEAAwE;QACxE,MAAME,iBAA2B,EAAE;QACnC/D,KAAKgE,OAAO,CAAC,CAACzC,KAAK0C;YACjB,MAAMC,YAAY3D,SAAS4D,GAAG,CAAC,CAACC;oBAEA7C;gBAD9B,MAAM8C,WAAWhE,QAAQiE,OAAO,CAACF;gBACjC,OAAOC,YAAY,IAAIE,QAAOhD,gBAAAA,GAAG,CAAC8C,SAAS,cAAb9C,2BAAAA,gBAAiB,IAAIiD,IAAI,KAAK;YAC9D;YAEA,IAAIN,UAAUO,IAAI,CAAC,CAACC,MAAQA,QAAQ,KAAK;gBACvCX,eAAeY,IAAI,CAAC,CAAC,IAAI,EAAEV,WAAW,EAAE,mCAAmC,EAAE1D,SAASqE,IAAI,CAAC,OAAO;YACpG;QACF;QAEA,IAAIb,eAAe7C,MAAM,GAAG,GAAG;gBAE7BkC;YADA,MAAMjC,UAAU,CAAC,0DAA0D,EAAE4C,eAAea,IAAI,CAAC,OAAO;aACxGxB,gBAAAA,OAAOyB,KAAK,cAAZzB,oCAAAA,mBAAAA,QAAe,+BAA+B;gBAAEyB,OAAO1D;YAAQ;YAC/D,MAAM,IAAIpC,cAAcC,kBAAkB8F,aAAa,EAAE3D;QAC3D;QAEA,oDAAoD;QACpD,MAAM4D,sBAAsB,MAAMpG,OAAOqG,YAAY,CAACC,GAAG,CAAC;YACxDC,eAAepF;YACfqF,QAAQ;QACV;QAEA,MAAM1B,kBAAkBsB,oBAAoBlE,IAAI;QAChD,MAAMiB,4BAAmB2B,8BAAAA,gBAAgB2B,UAAU,cAA1B3B,kDAAAA,4BAA4B4B,KAAK,uCAAI;QAC9D,MAAMtD,kBAAiB0B,kCAAAA,gBAAgB1B,cAAc,cAA9B0B,6CAAAA,kCAAkC;QAEzD,oBAAoB;QACpB,MAAMC,SAAQD,0BAAAA,gBAAgB9E,MAAM,cAAtB8E,8CAAAA,wBAAwB6B,IAAI,CAAC,CAACC;gBAAaA;mBAAPhB,QAAOgB,gBAAAA,EAAEH,UAAU,cAAZG,oCAAAA,cAAcC,OAAO,MAAMzF;;QACpF,IAAI,EAAC2D,kBAAAA,4BAAAA,MAAO0B,UAAU,GAAE;gBACtBhC;aAAAA,eAAAA,OAAOqC,IAAI,cAAXrC,mCAAAA,kBAAAA,QAAc,sCAAsC;gBAAEtD;gBAAIC;gBAAKuD,UAAUtD,KAAKkB,MAAM;YAAC;YACrF,MAAM,IAAInC,cAAcC,kBAAkB8F,aAAa,EAAE,CAAC,iBAAiB,EAAE/E,KAAK;QACpF;QAEA,MAAMiC,cAAa0B,0BAAAA,MAAM0B,UAAU,CAACC,KAAK,cAAtB3B,qCAAAA,0BAA0B3D;QAC7C,MAAM2F,YAAWhC,4BAAAA,MAAM0B,UAAU,CAACI,OAAO,cAAxB9B,uCAAAA,4BAA4B;QAC7C,MAAMzB,WAAW,CAAC,uCAAuC,EAAEnC,GAAG,UAAU,EAAE4F,UAAU;QAEpF,6CAA6C;QAC7C,MAAMC,gBAA+B;YACnCC,aAAa;gBACXC,YAAYtF;gBACZuF,oBAAoB;gBACpBC,WAAW;YACb;YACAC,cAAcxF,aAAa,mBAAmBA,aAAa;YAC3DyF,WAAW;YACXtF,kBAAkBA;QACpB;QAEA,oDAAoD;QACpD,MAAM,EAAEuF,QAAQC,YAAY,EAAE,GAAG,MAAMzG,+BAA+Bf,QAAQmB,IAAIkC,YAAYzB,UAAUoF,cAAcC,WAAW;QAEjI,gEAAgE;QAChE,IAAIQ,gBAAgBpG;QACpB,IAAIQ,aAAa,YAAY;gBAO3B4C;YANA,yCAAyC;YACzCgD,gBAAgBpG,KAAKe,MAAM,CAAC,CAACQ;gBAC3B,8DAA8D;gBAC9D,MAAM8E,MAAMrD,yBAAyBzB,KAAKlB,SAASsF,cAAcC,WAAW;gBAC5E,OAAOS,QAAQ,MAAM,CAACF,aAAaG,GAAG,CAACD;YACzC;aACAjD,iBAAAA,OAAOC,KAAK,cAAZD,qCAAAA,oBAAAA,QAAe,uCAAuC;gBACpDmD,eAAevG,KAAKkB,MAAM;gBAC1BsF,eAAeJ,cAAclF,MAAM;YACrC;QACF,OAAO,IAAIV,aAAa,eAAe;gBAOrC4C;YANA,uCAAuC;YACvCgD,gBAAgBpG,KAAKe,MAAM,CAAC,CAACQ;gBAC3B,8DAA8D;gBAC9D,MAAM8E,MAAMrD,yBAAyBzB,KAAKlB,SAASsF,cAAcC,WAAW;gBAC5E,OAAOS,QAAQ,MAAMF,aAAaG,GAAG,CAACD;YACxC;aACAjD,iBAAAA,OAAOC,KAAK,cAAZD,qCAAAA,oBAAAA,QAAe,0CAA0C;gBACvDmD,eAAevG,KAAKkB,MAAM;gBAC1BsF,eAAeJ,cAAclF,MAAM;YACrC;QACF;QAEA,8DAA8D;QAC9D,IAAIkF,cAAclF,MAAM,KAAK,GAAG;gBAC9BkC;aAAAA,eAAAA,OAAOqD,IAAI,cAAXrD,mCAAAA,kBAAAA,QAAc,+CAA+C;gBAAE5C;gBAAU+F,eAAevG,KAAKkB,MAAM;YAAC;YACpG,MAAM6B,SAAiB;gBACrBnB,MAAM;gBACN9B;gBACAC,KAAKwE,OAAOmB;gBACZ5D,kBAAkBA,oBAAoB;gBACtCC,gBAAgBA,kBAAkB;gBAClCC;gBACAC;gBACAC,aAAa;gBACbI,cAAc,EAAE;gBAChBC,aAAavC,KAAKkB,MAAM;gBACxBsB,cAAc,EAAE;gBAChBC,QAAQ;oBAAC,CAAC,0BAA0B,EAAEjC,SAAS,QAAQ,EAAER,KAAKkB,MAAM,CAAC,kBAAkB,CAAC;iBAAC;YAC3F;YACA,OAAO;gBACLwF,SAAS;oBAAC;wBAAE9E,MAAM;wBAAiB+E,MAAMC,KAAKC,SAAS,CAAC9D;oBAAQ;iBAAE;gBAClE+D,mBAAmB;oBAAE/D;gBAAO;YAC9B;QACF;SAEAK,iBAAAA,OAAOC,KAAK,cAAZD,qCAAAA,oBAAAA,QAAe,oDAAoD;YACjE8B,eAAepF;YACfkC;YACA+E,kBAAkB1G;YAClBwF,YAAYtF;YACZC;YACAwG,oBAAoBZ,cAAclF,MAAM;QAC1C;QAEA,yDAAyD;QACzD,MAAMyC,eAAe,MAAMhE,YAAYhB,QAAQ;YAC7CuG,eAAepF;YACfkC;YACAhC,MAAMoG;YACNW,kBAAkB1G;YAClB4G,SAAStB;YACTvC;QACF;QAEA,yCAAyC;QACzC,6EAA6E;QAC7E,MAAMZ,eAAyB,EAAE;QAEjC,oEAAoE;QACpE,MAAM0E,yBAAyBlH,KAAKkB,MAAM,GAAGkF,cAAclF,MAAM;QACjE,MAAMiG,mBAAmBxD,aAAapB,WAAW,GAAG2E;SAEpD9D,iBAAAA,OAAOC,KAAK,cAAZD,qCAAAA,oBAAAA,QAAe,gDAAgD;YAC7DlB,aAAayB,aAAazB,WAAW;YACrCkF,eAAezD,aAAa0D,QAAQ,CAACnG,MAAM;YAC3CqB,aAAa4E;YACbD;YACAI,qBAAqB3D,aAAapB,WAAW;YAC7CgF,aAAa5D,EAAAA,uBAAAA,aAAalB,MAAM,cAAnBkB,2CAAAA,qBAAqBzC,MAAM,KAAI;QAC9C;QAEA,MAAM6B,SAAiB;YACrBnB,MAAM;YACN9B;YACAC,KAAKwE,OAAOmB;YACZ5D,kBAAkBA,oBAAoB;YACtCC,gBAAgBA,kBAAkB;YAClCC;YACAC;YACAC,aAAayB,aAAazB,WAAW;YACrCI,cAAcqB,aAAa0D,QAAQ;YACnC9E,aAAa4E;YACb3E;YACAC,QAAQkB,aAAalB,MAAM;QAC7B;QAEA,OAAO;YACLiE,SAAS;gBAAC;oBAAE9E,MAAM;oBAAiB+E,MAAMC,KAAKC,SAAS,CAAC9D;gBAAQ;aAAE;YAClE+D,mBAAmB;gBAAE/D;YAAO;QAC9B;IACF,EAAE,OAAO8B,OAAO;YAEdzB;QADA,MAAMjC,UAAU0D,iBAAiB2C,QAAQ3C,MAAM1D,OAAO,GAAGoD,OAAOM;SAChEzB,iBAAAA,OAAOyB,KAAK,cAAZzB,qCAAAA,oBAAAA,QAAe,+BAA+B;YAAEyB,OAAO1D;QAAQ;QAC/D,MAAM,IAAIpC,cAAcC,kBAAkByI,aAAa,EAAE,CAAC,wBAAwB,EAAEtG,SAAS,EAAE;YAC7FuG,OAAO7C,iBAAiB2C,QAAQ3C,MAAM6C,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACNhF;QACAK;IACF;AACF"}
@@ -1,3 +1,4 @@
1
+ export { default as cellsCopy } from './cells-copy.js';
1
2
  export { default as cellsFormat } from './cells-format.js';
2
3
  export { default as cellsMetadataGet } from './cells-metadata-get.js';
3
4
  export { default as chartCreate } from './chart-create.js';
@@ -1,3 +1,4 @@
1
+ export { default as cellsCopy } from './cells-copy.js';
1
2
  export { default as cellsFormat } from './cells-format.js';
2
3
  export { default as cellsMetadataGet } from './cells-metadata-get.js';
3
4
  export { default as chartCreate } from './chart-create.js';
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/index.ts"],"sourcesContent":["export { default as cellsFormat } from './cells-format.ts';\nexport { default as cellsMetadataGet } from './cells-metadata-get.ts';\nexport { default as chartCreate } from './chart-create.ts';\nexport { default as columnsGet } from './columns-get.ts';\nexport { default as columnsUpdate } from './columns-update.ts';\nexport { default as csvGetColumns } from './csv-get-columns.ts';\nexport { default as dimensionsBatchUpdate } from './dimensions-batch-update.ts';\nexport { default as dimensionsMove } from './dimensions-move.ts';\nexport { default as rowsAppend } from './rows-append.ts';\nexport { default as rowsCsvAppend } from './rows-csv-append.ts';\nexport { default as rowsGet } from './rows-get.ts';\nexport { default as sheetCopy } from './sheet-copy.ts';\nexport { default as sheetCopyTo } from './sheet-copy-to.ts';\nexport { default as sheetCreate } from './sheet-create.ts';\nexport { default as sheetDelete } from './sheet-delete.ts';\nexport { default as sheetFind } from './sheet-find.ts';\nexport { default as sheetRename } from './sheet-rename.ts';\nexport { default as spreadsheetCopy } from './spreadsheet-copy.ts';\nexport { default as spreadsheetCreate } from './spreadsheet-create.ts';\nexport { default as spreadsheetFind } from './spreadsheet-find.ts';\nexport { default as spreadsheetMetadataGet } from './spreadsheet-metadata-get.ts';\nexport { default as spreadsheetRename } from './spreadsheet-rename.ts';\nexport { default as validationSet } from './validation-set.ts';\nexport { default as valuesBatchUpdate } from './values-batch-update.ts';\nexport { default as valuesClear } from './values-clear.ts';\nexport { default as valuesCsvUpdate } from './values-csv-update.ts';\nexport { default as valuesMarkdownUpdate } from './values-markdown-update.ts';\nexport { default as valuesReplace } from './values-replace.ts';\nexport { default as valuesSearch } from './values-search.ts';\n"],"names":["default","cellsFormat","cellsMetadataGet","chartCreate","columnsGet","columnsUpdate","csvGetColumns","dimensionsBatchUpdate","dimensionsMove","rowsAppend","rowsCsvAppend","rowsGet","sheetCopy","sheetCopyTo","sheetCreate","sheetDelete","sheetFind","sheetRename","spreadsheetCopy","spreadsheetCreate","spreadsheetFind","spreadsheetMetadataGet","spreadsheetRename","validationSet","valuesBatchUpdate","valuesClear","valuesCsvUpdate","valuesMarkdownUpdate","valuesReplace","valuesSearch"],"mappings":"AAAA,SAASA,WAAWC,WAAW,QAAQ,oBAAoB;AAC3D,SAASD,WAAWE,gBAAgB,QAAQ,0BAA0B;AACtE,SAASF,WAAWG,WAAW,QAAQ,oBAAoB;AAC3D,SAASH,WAAWI,UAAU,QAAQ,mBAAmB;AACzD,SAASJ,WAAWK,aAAa,QAAQ,sBAAsB;AAC/D,SAASL,WAAWM,aAAa,QAAQ,uBAAuB;AAChE,SAASN,WAAWO,qBAAqB,QAAQ,+BAA+B;AAChF,SAASP,WAAWQ,cAAc,QAAQ,uBAAuB;AACjE,SAASR,WAAWS,UAAU,QAAQ,mBAAmB;AACzD,SAAST,WAAWU,aAAa,QAAQ,uBAAuB;AAChE,SAASV,WAAWW,OAAO,QAAQ,gBAAgB;AACnD,SAASX,WAAWY,SAAS,QAAQ,kBAAkB;AACvD,SAASZ,WAAWa,WAAW,QAAQ,qBAAqB;AAC5D,SAASb,WAAWc,WAAW,QAAQ,oBAAoB;AAC3D,SAASd,WAAWe,WAAW,QAAQ,oBAAoB;AAC3D,SAASf,WAAWgB,SAAS,QAAQ,kBAAkB;AACvD,SAAShB,WAAWiB,WAAW,QAAQ,oBAAoB;AAC3D,SAASjB,WAAWkB,eAAe,QAAQ,wBAAwB;AACnE,SAASlB,WAAWmB,iBAAiB,QAAQ,0BAA0B;AACvE,SAASnB,WAAWoB,eAAe,QAAQ,wBAAwB;AACnE,SAASpB,WAAWqB,sBAAsB,QAAQ,gCAAgC;AAClF,SAASrB,WAAWsB,iBAAiB,QAAQ,0BAA0B;AACvE,SAAStB,WAAWuB,aAAa,QAAQ,sBAAsB;AAC/D,SAASvB,WAAWwB,iBAAiB,QAAQ,2BAA2B;AACxE,SAASxB,WAAWyB,WAAW,QAAQ,oBAAoB;AAC3D,SAASzB,WAAW0B,eAAe,QAAQ,yBAAyB;AACpE,SAAS1B,WAAW2B,oBAAoB,QAAQ,8BAA8B;AAC9E,SAAS3B,WAAW4B,aAAa,QAAQ,sBAAsB;AAC/D,SAAS5B,WAAW6B,YAAY,QAAQ,qBAAqB"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/index.ts"],"sourcesContent":["export { default as cellsCopy } from './cells-copy.ts';\nexport { default as cellsFormat } from './cells-format.ts';\nexport { default as cellsMetadataGet } from './cells-metadata-get.ts';\nexport { default as chartCreate } from './chart-create.ts';\nexport { default as columnsGet } from './columns-get.ts';\nexport { default as columnsUpdate } from './columns-update.ts';\nexport { default as csvGetColumns } from './csv-get-columns.ts';\nexport { default as dimensionsBatchUpdate } from './dimensions-batch-update.ts';\nexport { default as dimensionsMove } from './dimensions-move.ts';\nexport { default as rowsAppend } from './rows-append.ts';\nexport { default as rowsCsvAppend } from './rows-csv-append.ts';\nexport { default as rowsGet } from './rows-get.ts';\nexport { default as sheetCopy } from './sheet-copy.ts';\nexport { default as sheetCopyTo } from './sheet-copy-to.ts';\nexport { default as sheetCreate } from './sheet-create.ts';\nexport { default as sheetDelete } from './sheet-delete.ts';\nexport { default as sheetFind } from './sheet-find.ts';\nexport { default as sheetRename } from './sheet-rename.ts';\nexport { default as spreadsheetCopy } from './spreadsheet-copy.ts';\nexport { default as spreadsheetCreate } from './spreadsheet-create.ts';\nexport { default as spreadsheetFind } from './spreadsheet-find.ts';\nexport { default as spreadsheetMetadataGet } from './spreadsheet-metadata-get.ts';\nexport { default as spreadsheetRename } from './spreadsheet-rename.ts';\nexport { default as validationSet } from './validation-set.ts';\nexport { default as valuesBatchUpdate } from './values-batch-update.ts';\nexport { default as valuesClear } from './values-clear.ts';\nexport { default as valuesCsvUpdate } from './values-csv-update.ts';\nexport { default as valuesMarkdownUpdate } from './values-markdown-update.ts';\nexport { default as valuesReplace } from './values-replace.ts';\nexport { default as valuesSearch } from './values-search.ts';\n"],"names":["default","cellsCopy","cellsFormat","cellsMetadataGet","chartCreate","columnsGet","columnsUpdate","csvGetColumns","dimensionsBatchUpdate","dimensionsMove","rowsAppend","rowsCsvAppend","rowsGet","sheetCopy","sheetCopyTo","sheetCreate","sheetDelete","sheetFind","sheetRename","spreadsheetCopy","spreadsheetCreate","spreadsheetFind","spreadsheetMetadataGet","spreadsheetRename","validationSet","valuesBatchUpdate","valuesClear","valuesCsvUpdate","valuesMarkdownUpdate","valuesReplace","valuesSearch"],"mappings":"AAAA,SAASA,WAAWC,SAAS,QAAQ,kBAAkB;AACvD,SAASD,WAAWE,WAAW,QAAQ,oBAAoB;AAC3D,SAASF,WAAWG,gBAAgB,QAAQ,0BAA0B;AACtE,SAASH,WAAWI,WAAW,QAAQ,oBAAoB;AAC3D,SAASJ,WAAWK,UAAU,QAAQ,mBAAmB;AACzD,SAASL,WAAWM,aAAa,QAAQ,sBAAsB;AAC/D,SAASN,WAAWO,aAAa,QAAQ,uBAAuB;AAChE,SAASP,WAAWQ,qBAAqB,QAAQ,+BAA+B;AAChF,SAASR,WAAWS,cAAc,QAAQ,uBAAuB;AACjE,SAAST,WAAWU,UAAU,QAAQ,mBAAmB;AACzD,SAASV,WAAWW,aAAa,QAAQ,uBAAuB;AAChE,SAASX,WAAWY,OAAO,QAAQ,gBAAgB;AACnD,SAASZ,WAAWa,SAAS,QAAQ,kBAAkB;AACvD,SAASb,WAAWc,WAAW,QAAQ,qBAAqB;AAC5D,SAASd,WAAWe,WAAW,QAAQ,oBAAoB;AAC3D,SAASf,WAAWgB,WAAW,QAAQ,oBAAoB;AAC3D,SAAShB,WAAWiB,SAAS,QAAQ,kBAAkB;AACvD,SAASjB,WAAWkB,WAAW,QAAQ,oBAAoB;AAC3D,SAASlB,WAAWmB,eAAe,QAAQ,wBAAwB;AACnE,SAASnB,WAAWoB,iBAAiB,QAAQ,0BAA0B;AACvE,SAASpB,WAAWqB,eAAe,QAAQ,wBAAwB;AACnE,SAASrB,WAAWsB,sBAAsB,QAAQ,gCAAgC;AAClF,SAAStB,WAAWuB,iBAAiB,QAAQ,0BAA0B;AACvE,SAASvB,WAAWwB,aAAa,QAAQ,sBAAsB;AAC/D,SAASxB,WAAWyB,iBAAiB,QAAQ,2BAA2B;AACxE,SAASzB,WAAW0B,WAAW,QAAQ,oBAAoB;AAC3D,SAAS1B,WAAW2B,eAAe,QAAQ,yBAAyB;AACpE,SAAS3B,WAAW4B,oBAAoB,QAAQ,8BAA8B;AAC9E,SAAS5B,WAAW6B,aAAa,QAAQ,sBAAsB;AAC/D,SAAS7B,WAAW8B,YAAY,QAAQ,qBAAqB"}
@@ -28,7 +28,7 @@ declare function handler({ id, gid, rows, headers, deduplicateBy }: Input, extra
28
28
  export default function createTool(): {
29
29
  name: string;
30
30
  config: {
31
- readonly description: "Add new rows to the bottom of an existing sheet with smart header handling and optional deduplication. BEST FOR: Structured database operations where spreadsheet has headers defining schema and rows represent records.";
31
+ readonly description: "Add new rows to the bottom of an existing sheet with smart header handling and optional deduplication. BEST FOR: Structured database operations where spreadsheet has headers defining schema and rows represent records. Values are always written RAW (no parsing), so a date string stays text; write numeric serials and then apply a date format with cells-format. Dates: a date-looking string is not necessarily a native date. See values-batch-update for the native-date write, format and read-back steps.";
32
32
  readonly inputSchema: z.ZodObject<{
33
33
  id: z.ZodString;
34
34
  gid: z.ZodCoercedString<unknown>;
@@ -3,6 +3,7 @@ import { schemas } from '@mcp-z/oauth-google';
3
3
  const { AuthRequiredBranchSchema } = schemas;
4
4
  import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
5
5
  import { z } from 'zod';
6
+ import { NATIVE_DATE_POINTER } from '../../constants.js';
6
7
  import { googleAuth } from '../../lib/google-auth.js';
7
8
  import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
8
9
  import { appendRows, mapRowsToHeader } from '../../spreadsheet/data-operations.js';
@@ -33,7 +34,7 @@ const outputSchema = z.discriminatedUnion('type', [
33
34
  AuthRequiredBranchSchema
34
35
  ]);
35
36
  const config = {
36
- description: 'Add new rows to the bottom of an existing sheet with smart header handling and optional deduplication. BEST FOR: Structured database operations where spreadsheet has headers defining schema and rows represent records.',
37
+ description: `Add new rows to the bottom of an existing sheet with smart header handling and optional deduplication. BEST FOR: Structured database operations where spreadsheet has headers defining schema and rows represent records. Values are always written RAW (no parsing), so a date string stays text; write numeric serials and then apply a date format with cells-format. ${NATIVE_DATE_POINTER}`,
37
38
  inputSchema,
38
39
  outputSchema: z.object({
39
40
  result: outputSchema
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/rows-append.ts"],"sourcesContent":["import { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { appendRows, mapRowsToHeader } from '../../spreadsheet/data-operations.ts';\nimport { ensureTabAndHeaders } from '../../spreadsheet/sheet-operations.ts';\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n rows: z\n .array(z.array(z.union([z.string(), z.number(), z.boolean(), z.null()])).min(1))\n .min(1)\n .describe('Array of rows, where each row is an array of cell values. Use null to skip a cell (preserve existing value), empty string \"\" to clear it.'),\n headers: z.array(z.string()).optional().describe('Column order/names - used for blank sheets or column mapping'),\n deduplicateBy: z.array(z.string()).optional().describe('Column names to use as composite key for deduplication'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Sheet tab name'),\n updatedRows: z.number().describe('Number of rows appended'),\n rowsSkipped: z.number().optional().describe('Number of duplicate rows skipped'),\n sheetUrl: z.string().optional().describe('URL to view the sheet'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Add new rows to the bottom of an existing sheet with smart header handling and optional deduplication. BEST FOR: Structured database operations where spreadsheet has headers defining schema and rows represent records.',\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, rows, headers, deduplicateBy }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.rows.append called', { id, gid, rowCount: rows.length, headers, deduplicateBy });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get sheet details using the gid\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n\n if (!sheet) {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');\n }\n\n const sheetTitle = sheet?.properties?.title ?? '';\n\n // Smart header handling and data processing\n let processedRows = rows;\n let currentHeaders: string[] = [];\n let rowsSkipped = 0;\n let existingKeySet: Set<string> = new Set();\n\n if (headers && headers.length > 0) {\n // Use ensureTabAndHeaders to handle header logic\n const headerResult = await ensureTabAndHeaders(sheets, {\n spreadsheetId: id,\n sheetTitle,\n requiredHeader: headers,\n keyColumns: deduplicateBy || [],\n logger,\n });\n\n currentHeaders = headerResult.header;\n existingKeySet = headerResult.keySet;\n\n // Map data rows to match current header order\n processedRows = mapRowsToHeader({ rows, header: currentHeaders, canonical: headers }) as (string | number | boolean | null)[][];\n }\n\n // Append rows with optional deduplication\n // If headers are empty but deduplication is requested, skip deduplication for empty spreadsheets\n const effectiveKeyColumns = currentHeaders.length === 0 && deduplicateBy && deduplicateBy.length > 0 ? [] : deduplicateBy || [];\n\n const appendResult = await appendRows(sheets, {\n spreadsheetId: id,\n sheetTitle,\n rows: processedRows,\n keySet: existingKeySet,\n keyColumns: effectiveKeyColumns,\n header: currentHeaders,\n logger,\n });\n\n rowsSkipped = appendResult.rowsSkipped || 0;\n // Only count data rows, not headers - headers are metadata, not items\n const updatedRows = appendResult.updatedRows || 0;\n\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}`;\n\n logger.info('sheets.rows.append completed', { id, gid, updatedRows, rowsSkipped });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid,\n sheetTitle,\n updatedRows,\n rowsSkipped, // Always include rowsSkipped, even when 0\n sheetUrl,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.rows.append error', { error: message });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error appending rows: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'rows-append',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","appendRows","mapRowsToHeader","ensureTabAndHeaders","inputSchema","object","id","gid","rows","array","union","string","number","boolean","null","min","describe","headers","optional","deduplicateBy","successBranchSchema","type","literal","sheetTitle","updatedRows","rowsSkipped","sheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","rowCount","length","spreadsheetResponse","sheet","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","processedRows","currentHeaders","existingKeySet","Set","headerResult","requiredHeader","keyColumns","header","keySet","canonical","effectiveKeyColumns","appendResult","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/ai/mcp-z/mcp-sheets/src/mcp/tools/rows-append.ts"],"sourcesContent":["import { sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { NATIVE_DATE_POINTER } from '../../constants.ts';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { appendRows, mapRowsToHeader } from '../../spreadsheet/data-operations.ts';\nimport { ensureTabAndHeaders } from '../../spreadsheet/sheet-operations.ts';\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n rows: z\n .array(z.array(z.union([z.string(), z.number(), z.boolean(), z.null()])).min(1))\n .min(1)\n .describe('Array of rows, where each row is an array of cell values. Use null to skip a cell (preserve existing value), empty string \"\" to clear it.'),\n headers: z.array(z.string()).optional().describe('Column order/names - used for blank sheets or column mapping'),\n deduplicateBy: z.array(z.string()).optional().describe('Column names to use as composite key for deduplication'),\n});\n\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n id: SpreadsheetIdOutput,\n gid: SheetGidOutput,\n sheetTitle: z.string().describe('Sheet tab name'),\n updatedRows: z.number().describe('Number of rows appended'),\n rowsSkipped: z.number().optional().describe('Number of duplicate rows skipped'),\n sheetUrl: z.string().optional().describe('URL to view the sheet'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: `Add new rows to the bottom of an existing sheet with smart header handling and optional deduplication. BEST FOR: Structured database operations where spreadsheet has headers defining schema and rows represent records. Values are always written RAW (no parsing), so a date string stays text; write numeric serials and then apply a date format with cells-format. ${NATIVE_DATE_POINTER}`,\n inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, rows, headers, deduplicateBy }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.rows.append called', { id, gid, rowCount: rows.length, headers, deduplicateBy });\n\n try {\n const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get sheet details using the gid\n const spreadsheetResponse = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n\n if (!sheet) {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');\n }\n\n const sheetTitle = sheet?.properties?.title ?? '';\n\n // Smart header handling and data processing\n let processedRows = rows;\n let currentHeaders: string[] = [];\n let rowsSkipped = 0;\n let existingKeySet: Set<string> = new Set();\n\n if (headers && headers.length > 0) {\n // Use ensureTabAndHeaders to handle header logic\n const headerResult = await ensureTabAndHeaders(sheets, {\n spreadsheetId: id,\n sheetTitle,\n requiredHeader: headers,\n keyColumns: deduplicateBy || [],\n logger,\n });\n\n currentHeaders = headerResult.header;\n existingKeySet = headerResult.keySet;\n\n // Map data rows to match current header order\n processedRows = mapRowsToHeader({ rows, header: currentHeaders, canonical: headers }) as (string | number | boolean | null)[][];\n }\n\n // Append rows with optional deduplication\n // If headers are empty but deduplication is requested, skip deduplication for empty spreadsheets\n const effectiveKeyColumns = currentHeaders.length === 0 && deduplicateBy && deduplicateBy.length > 0 ? [] : deduplicateBy || [];\n\n const appendResult = await appendRows(sheets, {\n spreadsheetId: id,\n sheetTitle,\n rows: processedRows,\n keySet: existingKeySet,\n keyColumns: effectiveKeyColumns,\n header: currentHeaders,\n logger,\n });\n\n rowsSkipped = appendResult.rowsSkipped || 0;\n // Only count data rows, not headers - headers are metadata, not items\n const updatedRows = appendResult.updatedRows || 0;\n\n const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}`;\n\n logger.info('sheets.rows.append completed', { id, gid, updatedRows, rowsSkipped });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid,\n sheetTitle,\n updatedRows,\n rowsSkipped, // Always include rowsSkipped, even when 0\n sheetUrl,\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.rows.append error', { error: message });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error appending rows: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'rows-append',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","NATIVE_DATE_POINTER","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","appendRows","mapRowsToHeader","ensureTabAndHeaders","inputSchema","object","id","gid","rows","array","union","string","number","boolean","null","min","describe","headers","optional","deduplicateBy","successBranchSchema","type","literal","sheetTitle","updatedRows","rowsSkipped","sheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","rowCount","length","spreadsheetResponse","sheet","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","processedRows","currentHeaders","existingKeySet","Set","headerResult","requiredHeader","keyColumns","header","keySet","canonical","effectiveKeyColumns","appendResult","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
@@ -33,7 +33,7 @@ declare function handler({ id, gid, sourceUri, sourceHasHeaders, headerMap, dedu
33
33
  export default function createTool(): {
34
34
  name: string;
35
35
  config: {
36
- readonly description: "Import CSV to Google Sheets with column mapping and optional deduplication. Streams data for large files.";
36
+ readonly description: "Import CSV to Google Sheets with column mapping and optional deduplication. Streams data for large files. Rows are always appended USER_ENTERED, so date-looking CSV text may be parsed as native dates per the workbook locale; read back with UNFORMATTED_VALUE to confirm. Dates: a date-looking string is not necessarily a native date. See values-batch-update for the native-date write, format and read-back steps.";
37
37
  readonly inputSchema: z.ZodObject<{
38
38
  id: z.ZodString;
39
39
  gid: z.ZodCoercedString<unknown>;
@@ -4,6 +4,7 @@ const { AuthRequiredBranchSchema } = schemas;
4
4
  import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
5
5
  import { parse } from 'csv-parse';
6
6
  import { z } from 'zod';
7
+ import { NATIVE_DATE_POINTER } from '../../constants.js';
7
8
  import { googleAuth } from '../../lib/google-auth.js';
8
9
  import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
9
10
  import { getCsvReadStream } from '../../spreadsheet/csv-streaming.js';
@@ -45,7 +46,7 @@ const outputSchema = z.discriminatedUnion('type', [
45
46
  AuthRequiredBranchSchema
46
47
  ]);
47
48
  const config = {
48
- description: 'Import CSV to Google Sheets with column mapping and optional deduplication. Streams data for large files.',
49
+ description: `Import CSV to Google Sheets with column mapping and optional deduplication. Streams data for large files. Rows are always appended USER_ENTERED, so date-looking CSV text may be parsed as native dates per the workbook locale; read back with UNFORMATTED_VALUE to confirm. ${NATIVE_DATE_POINTER}`,
49
50
  inputSchema,
50
51
  outputSchema: z.object({
51
52
  result: outputSchema