@mcp-z/mcp-sheets 1.2.3 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (223) hide show
  1. package/dist/cjs/index.js.map +1 -1
  2. package/dist/cjs/lib/google-auth.d.cts +9 -0
  3. package/dist/cjs/lib/google-auth.d.ts +9 -0
  4. package/dist/cjs/lib/google-auth.js +16 -0
  5. package/dist/cjs/lib/google-auth.js.map +1 -0
  6. package/dist/cjs/mcp/prompts/a1-notation.d.cts +2 -3
  7. package/dist/cjs/mcp/prompts/a1-notation.d.ts +2 -3
  8. package/dist/cjs/mcp/prompts/a1-notation.js.map +1 -1
  9. package/dist/cjs/mcp/resources/spreadsheet.js +4 -3
  10. package/dist/cjs/mcp/resources/spreadsheet.js.map +1 -1
  11. package/dist/cjs/mcp/tools/cells-format.d.cts +1 -1
  12. package/dist/cjs/mcp/tools/cells-format.d.ts +1 -1
  13. package/dist/cjs/mcp/tools/cells-format.js +5 -4
  14. package/dist/cjs/mcp/tools/cells-format.js.map +1 -1
  15. package/dist/cjs/mcp/tools/chart-create.d.cts +1 -1
  16. package/dist/cjs/mcp/tools/chart-create.d.ts +1 -1
  17. package/dist/cjs/mcp/tools/chart-create.js +9 -8
  18. package/dist/cjs/mcp/tools/chart-create.js.map +1 -1
  19. package/dist/cjs/mcp/tools/columns-get.d.cts +1 -1
  20. package/dist/cjs/mcp/tools/columns-get.d.ts +1 -1
  21. package/dist/cjs/mcp/tools/columns-get.js +5 -4
  22. package/dist/cjs/mcp/tools/columns-get.js.map +1 -1
  23. package/dist/cjs/mcp/tools/columns-update.d.cts +1 -1
  24. package/dist/cjs/mcp/tools/columns-update.d.ts +1 -1
  25. package/dist/cjs/mcp/tools/columns-update.js +6 -5
  26. package/dist/cjs/mcp/tools/columns-update.js.map +1 -1
  27. package/dist/cjs/mcp/tools/csv-get-columns.d.cts +1 -1
  28. package/dist/cjs/mcp/tools/csv-get-columns.d.ts +1 -1
  29. package/dist/cjs/mcp/tools/csv-get-columns.js +2 -2
  30. package/dist/cjs/mcp/tools/csv-get-columns.js.map +1 -1
  31. package/dist/cjs/mcp/tools/dimensions-batch-update.d.cts +1 -1
  32. package/dist/cjs/mcp/tools/dimensions-batch-update.d.ts +1 -1
  33. package/dist/cjs/mcp/tools/dimensions-batch-update.js +10 -9
  34. package/dist/cjs/mcp/tools/dimensions-batch-update.js.map +1 -1
  35. package/dist/cjs/mcp/tools/dimensions-move.d.cts +1 -1
  36. package/dist/cjs/mcp/tools/dimensions-move.d.ts +1 -1
  37. package/dist/cjs/mcp/tools/dimensions-move.js +8 -7
  38. package/dist/cjs/mcp/tools/dimensions-move.js.map +1 -1
  39. package/dist/cjs/mcp/tools/rows-append.d.cts +1 -1
  40. package/dist/cjs/mcp/tools/rows-append.d.ts +1 -1
  41. package/dist/cjs/mcp/tools/rows-append.js +5 -4
  42. package/dist/cjs/mcp/tools/rows-append.js.map +1 -1
  43. package/dist/cjs/mcp/tools/rows-csv-append.d.cts +1 -1
  44. package/dist/cjs/mcp/tools/rows-csv-append.d.ts +1 -1
  45. package/dist/cjs/mcp/tools/rows-csv-append.js +9 -8
  46. package/dist/cjs/mcp/tools/rows-csv-append.js.map +1 -1
  47. package/dist/cjs/mcp/tools/rows-get.d.cts +1 -1
  48. package/dist/cjs/mcp/tools/rows-get.d.ts +1 -1
  49. package/dist/cjs/mcp/tools/rows-get.js +6 -5
  50. package/dist/cjs/mcp/tools/rows-get.js.map +1 -1
  51. package/dist/cjs/mcp/tools/sheet-copy-to.d.cts +1 -1
  52. package/dist/cjs/mcp/tools/sheet-copy-to.d.ts +1 -1
  53. package/dist/cjs/mcp/tools/sheet-copy-to.js +6 -5
  54. package/dist/cjs/mcp/tools/sheet-copy-to.js.map +1 -1
  55. package/dist/cjs/mcp/tools/sheet-copy.d.cts +1 -1
  56. package/dist/cjs/mcp/tools/sheet-copy.d.ts +1 -1
  57. package/dist/cjs/mcp/tools/sheet-copy.js +6 -5
  58. package/dist/cjs/mcp/tools/sheet-copy.js.map +1 -1
  59. package/dist/cjs/mcp/tools/sheet-create.d.cts +1 -1
  60. package/dist/cjs/mcp/tools/sheet-create.d.ts +1 -1
  61. package/dist/cjs/mcp/tools/sheet-create.js +5 -4
  62. package/dist/cjs/mcp/tools/sheet-create.js.map +1 -1
  63. package/dist/cjs/mcp/tools/sheet-delete.d.cts +1 -1
  64. package/dist/cjs/mcp/tools/sheet-delete.d.ts +1 -1
  65. package/dist/cjs/mcp/tools/sheet-delete.js +4 -3
  66. package/dist/cjs/mcp/tools/sheet-delete.js.map +1 -1
  67. package/dist/cjs/mcp/tools/sheet-find.d.cts +1 -1
  68. package/dist/cjs/mcp/tools/sheet-find.d.ts +1 -1
  69. package/dist/cjs/mcp/tools/sheet-find.js +5 -4
  70. package/dist/cjs/mcp/tools/sheet-find.js.map +1 -1
  71. package/dist/cjs/mcp/tools/sheet-rename.d.cts +1 -1
  72. package/dist/cjs/mcp/tools/sheet-rename.d.ts +1 -1
  73. package/dist/cjs/mcp/tools/sheet-rename.js +6 -5
  74. package/dist/cjs/mcp/tools/sheet-rename.js.map +1 -1
  75. package/dist/cjs/mcp/tools/spreadsheet-copy.d.cts +1 -1
  76. package/dist/cjs/mcp/tools/spreadsheet-copy.d.ts +1 -1
  77. package/dist/cjs/mcp/tools/spreadsheet-copy.js +5 -4
  78. package/dist/cjs/mcp/tools/spreadsheet-copy.js.map +1 -1
  79. package/dist/cjs/mcp/tools/spreadsheet-create.d.cts +1 -1
  80. package/dist/cjs/mcp/tools/spreadsheet-create.d.ts +1 -1
  81. package/dist/cjs/mcp/tools/spreadsheet-create.js +5 -4
  82. package/dist/cjs/mcp/tools/spreadsheet-create.js.map +1 -1
  83. package/dist/cjs/mcp/tools/spreadsheet-find.d.cts +1 -1
  84. package/dist/cjs/mcp/tools/spreadsheet-find.d.ts +1 -1
  85. package/dist/cjs/mcp/tools/spreadsheet-find.js +5 -4
  86. package/dist/cjs/mcp/tools/spreadsheet-find.js.map +1 -1
  87. package/dist/cjs/mcp/tools/spreadsheet-rename.d.cts +1 -1
  88. package/dist/cjs/mcp/tools/spreadsheet-rename.d.ts +1 -1
  89. package/dist/cjs/mcp/tools/spreadsheet-rename.js +4 -3
  90. package/dist/cjs/mcp/tools/spreadsheet-rename.js.map +1 -1
  91. package/dist/cjs/mcp/tools/validation-set.d.cts +1 -1
  92. package/dist/cjs/mcp/tools/validation-set.d.ts +1 -1
  93. package/dist/cjs/mcp/tools/validation-set.js +6 -5
  94. package/dist/cjs/mcp/tools/validation-set.js.map +1 -1
  95. package/dist/cjs/mcp/tools/values-batch-update.d.cts +1 -1
  96. package/dist/cjs/mcp/tools/values-batch-update.d.ts +1 -1
  97. package/dist/cjs/mcp/tools/values-batch-update.js +7 -6
  98. package/dist/cjs/mcp/tools/values-batch-update.js.map +1 -1
  99. package/dist/cjs/mcp/tools/values-clear.d.cts +1 -1
  100. package/dist/cjs/mcp/tools/values-clear.d.ts +1 -1
  101. package/dist/cjs/mcp/tools/values-clear.js +5 -4
  102. package/dist/cjs/mcp/tools/values-clear.js.map +1 -1
  103. package/dist/cjs/mcp/tools/values-csv-update.d.cts +1 -1
  104. package/dist/cjs/mcp/tools/values-csv-update.d.ts +1 -1
  105. package/dist/cjs/mcp/tools/values-csv-update.js +6 -5
  106. package/dist/cjs/mcp/tools/values-csv-update.js.map +1 -1
  107. package/dist/cjs/mcp/tools/values-markdown-update.d.cts +1 -1
  108. package/dist/cjs/mcp/tools/values-markdown-update.d.ts +1 -1
  109. package/dist/cjs/mcp/tools/values-markdown-update.js +7 -6
  110. package/dist/cjs/mcp/tools/values-markdown-update.js.map +1 -1
  111. package/dist/cjs/mcp/tools/values-replace.d.cts +1 -1
  112. package/dist/cjs/mcp/tools/values-replace.d.ts +1 -1
  113. package/dist/cjs/mcp/tools/values-replace.js +7 -6
  114. package/dist/cjs/mcp/tools/values-replace.js.map +1 -1
  115. package/dist/cjs/mcp/tools/values-search.d.cts +1 -1
  116. package/dist/cjs/mcp/tools/values-search.d.ts +1 -1
  117. package/dist/cjs/mcp/tools/values-search.js +5 -4
  118. package/dist/cjs/mcp/tools/values-search.js.map +1 -1
  119. package/dist/cjs/setup/http.d.cts +1 -1
  120. package/dist/cjs/setup/http.d.ts +1 -1
  121. package/dist/cjs/setup/http.js +1 -2
  122. package/dist/cjs/setup/http.js.map +1 -1
  123. package/dist/cjs/setup/stdio.d.cts +1 -1
  124. package/dist/cjs/setup/stdio.d.ts +1 -1
  125. package/dist/cjs/setup/stdio.js +1 -2
  126. package/dist/cjs/setup/stdio.js.map +1 -1
  127. package/dist/esm/index.js +1 -1
  128. package/dist/esm/index.js.map +1 -1
  129. package/dist/esm/lib/google-auth.d.ts +9 -0
  130. package/dist/esm/lib/google-auth.js +11 -0
  131. package/dist/esm/lib/google-auth.js.map +1 -0
  132. package/dist/esm/mcp/prompts/a1-notation.d.ts +2 -3
  133. package/dist/esm/mcp/prompts/a1-notation.js.map +1 -1
  134. package/dist/esm/mcp/resources/spreadsheet.js +3 -2
  135. package/dist/esm/mcp/resources/spreadsheet.js.map +1 -1
  136. package/dist/esm/mcp/tools/cells-format.d.ts +1 -1
  137. package/dist/esm/mcp/tools/cells-format.js +5 -4
  138. package/dist/esm/mcp/tools/cells-format.js.map +1 -1
  139. package/dist/esm/mcp/tools/chart-create.d.ts +1 -1
  140. package/dist/esm/mcp/tools/chart-create.js +9 -8
  141. package/dist/esm/mcp/tools/chart-create.js.map +1 -1
  142. package/dist/esm/mcp/tools/columns-get.d.ts +1 -1
  143. package/dist/esm/mcp/tools/columns-get.js +5 -4
  144. package/dist/esm/mcp/tools/columns-get.js.map +1 -1
  145. package/dist/esm/mcp/tools/columns-update.d.ts +1 -1
  146. package/dist/esm/mcp/tools/columns-update.js +6 -5
  147. package/dist/esm/mcp/tools/columns-update.js.map +1 -1
  148. package/dist/esm/mcp/tools/csv-get-columns.d.ts +1 -1
  149. package/dist/esm/mcp/tools/csv-get-columns.js +2 -2
  150. package/dist/esm/mcp/tools/csv-get-columns.js.map +1 -1
  151. package/dist/esm/mcp/tools/dimensions-batch-update.d.ts +1 -1
  152. package/dist/esm/mcp/tools/dimensions-batch-update.js +10 -9
  153. package/dist/esm/mcp/tools/dimensions-batch-update.js.map +1 -1
  154. package/dist/esm/mcp/tools/dimensions-move.d.ts +1 -1
  155. package/dist/esm/mcp/tools/dimensions-move.js +8 -7
  156. package/dist/esm/mcp/tools/dimensions-move.js.map +1 -1
  157. package/dist/esm/mcp/tools/rows-append.d.ts +1 -1
  158. package/dist/esm/mcp/tools/rows-append.js +5 -4
  159. package/dist/esm/mcp/tools/rows-append.js.map +1 -1
  160. package/dist/esm/mcp/tools/rows-csv-append.d.ts +1 -1
  161. package/dist/esm/mcp/tools/rows-csv-append.js +9 -8
  162. package/dist/esm/mcp/tools/rows-csv-append.js.map +1 -1
  163. package/dist/esm/mcp/tools/rows-get.d.ts +1 -1
  164. package/dist/esm/mcp/tools/rows-get.js +6 -5
  165. package/dist/esm/mcp/tools/rows-get.js.map +1 -1
  166. package/dist/esm/mcp/tools/sheet-copy-to.d.ts +1 -1
  167. package/dist/esm/mcp/tools/sheet-copy-to.js +6 -5
  168. package/dist/esm/mcp/tools/sheet-copy-to.js.map +1 -1
  169. package/dist/esm/mcp/tools/sheet-copy.d.ts +1 -1
  170. package/dist/esm/mcp/tools/sheet-copy.js +6 -5
  171. package/dist/esm/mcp/tools/sheet-copy.js.map +1 -1
  172. package/dist/esm/mcp/tools/sheet-create.d.ts +1 -1
  173. package/dist/esm/mcp/tools/sheet-create.js +5 -4
  174. package/dist/esm/mcp/tools/sheet-create.js.map +1 -1
  175. package/dist/esm/mcp/tools/sheet-delete.d.ts +1 -1
  176. package/dist/esm/mcp/tools/sheet-delete.js +4 -3
  177. package/dist/esm/mcp/tools/sheet-delete.js.map +1 -1
  178. package/dist/esm/mcp/tools/sheet-find.d.ts +1 -1
  179. package/dist/esm/mcp/tools/sheet-find.js +5 -4
  180. package/dist/esm/mcp/tools/sheet-find.js.map +1 -1
  181. package/dist/esm/mcp/tools/sheet-rename.d.ts +1 -1
  182. package/dist/esm/mcp/tools/sheet-rename.js +6 -5
  183. package/dist/esm/mcp/tools/sheet-rename.js.map +1 -1
  184. package/dist/esm/mcp/tools/spreadsheet-copy.d.ts +1 -1
  185. package/dist/esm/mcp/tools/spreadsheet-copy.js +5 -4
  186. package/dist/esm/mcp/tools/spreadsheet-copy.js.map +1 -1
  187. package/dist/esm/mcp/tools/spreadsheet-create.d.ts +1 -1
  188. package/dist/esm/mcp/tools/spreadsheet-create.js +5 -4
  189. package/dist/esm/mcp/tools/spreadsheet-create.js.map +1 -1
  190. package/dist/esm/mcp/tools/spreadsheet-find.d.ts +1 -1
  191. package/dist/esm/mcp/tools/spreadsheet-find.js +5 -4
  192. package/dist/esm/mcp/tools/spreadsheet-find.js.map +1 -1
  193. package/dist/esm/mcp/tools/spreadsheet-rename.d.ts +1 -1
  194. package/dist/esm/mcp/tools/spreadsheet-rename.js +4 -3
  195. package/dist/esm/mcp/tools/spreadsheet-rename.js.map +1 -1
  196. package/dist/esm/mcp/tools/validation-set.d.ts +1 -1
  197. package/dist/esm/mcp/tools/validation-set.js +6 -5
  198. package/dist/esm/mcp/tools/validation-set.js.map +1 -1
  199. package/dist/esm/mcp/tools/values-batch-update.d.ts +1 -1
  200. package/dist/esm/mcp/tools/values-batch-update.js +7 -6
  201. package/dist/esm/mcp/tools/values-batch-update.js.map +1 -1
  202. package/dist/esm/mcp/tools/values-clear.d.ts +1 -1
  203. package/dist/esm/mcp/tools/values-clear.js +5 -4
  204. package/dist/esm/mcp/tools/values-clear.js.map +1 -1
  205. package/dist/esm/mcp/tools/values-csv-update.d.ts +1 -1
  206. package/dist/esm/mcp/tools/values-csv-update.js +6 -5
  207. package/dist/esm/mcp/tools/values-csv-update.js.map +1 -1
  208. package/dist/esm/mcp/tools/values-markdown-update.d.ts +1 -1
  209. package/dist/esm/mcp/tools/values-markdown-update.js +7 -6
  210. package/dist/esm/mcp/tools/values-markdown-update.js.map +1 -1
  211. package/dist/esm/mcp/tools/values-replace.d.ts +1 -1
  212. package/dist/esm/mcp/tools/values-replace.js +7 -6
  213. package/dist/esm/mcp/tools/values-replace.js.map +1 -1
  214. package/dist/esm/mcp/tools/values-search.d.ts +1 -1
  215. package/dist/esm/mcp/tools/values-search.js +5 -4
  216. package/dist/esm/mcp/tools/values-search.js.map +1 -1
  217. package/dist/esm/setup/http.d.ts +1 -1
  218. package/dist/esm/setup/http.js +1 -2
  219. package/dist/esm/setup/http.js.map +1 -1
  220. package/dist/esm/setup/stdio.d.ts +1 -1
  221. package/dist/esm/setup/stdio.js +1 -2
  222. package/dist/esm/setup/stdio.js.map +1 -1
  223. package/package.json +8 -9
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/rows-append.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\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 = google.sheets({ version: 'v4', auth: 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 McpError(ErrorCode.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 McpError(ErrorCode.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":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","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","sheets","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/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/rows-append.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { 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 = google.sheets({ 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":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","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","sheets","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,6 +1,6 @@
1
1
  /** Import CSV data to Google Sheets with database-style row append and deduplication */
2
2
  import type { EnrichedExtra } from '@mcp-z/oauth-google';
3
- import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
3
+ import type { CallToolResult } from '@mcp-z/server';
4
4
  import { z } from 'zod';
5
5
  declare const inputSchema: z.ZodObject<{
6
6
  id: z.ZodString;
@@ -1,9 +1,10 @@
1
1
  /** Import CSV data to Google Sheets with database-style row append and deduplication */ import { schemas } from '@mcp-z/oauth-google';
2
2
  const { AuthRequiredBranchSchema } = schemas;
3
- import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
3
+ import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
4
4
  import { parse } from 'csv-parse';
5
5
  import { google } from 'googleapis';
6
6
  import { z } from 'zod';
7
+ import { googleAuth } from '../../lib/google-auth.js';
7
8
  import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
8
9
  import { getCsvReadStream } from '../../spreadsheet/csv-streaming.js';
9
10
  import { buildDeduplicationKey } from '../../spreadsheet/deduplication-utils.js';
@@ -89,29 +90,29 @@ async function handler({ id, gid, sourceUri, sourceHasHeaders, headerMap, dedupl
89
90
  var _ref;
90
91
  var _spreadsheetResponse_data_sheets, _sheet_properties;
91
92
  if (headerMap.length === 0) {
92
- throw new McpError(ErrorCode.InvalidParams, 'headerMap cannot be empty');
93
+ throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'headerMap cannot be empty');
93
94
  }
94
95
  // Validate: if sourceHasHeaders=false, all references must be numeric
95
96
  if (!sourceHasHeaders) {
96
97
  for (const { source, target } of headerMap){
97
98
  if (typeof source === 'string') {
98
- throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string source: "${source}"`);
99
+ throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string source: "${source}"`);
99
100
  }
100
101
  if (typeof target === 'string') {
101
- throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string target: "${target}"`);
102
+ throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string target: "${target}"`);
102
103
  }
103
104
  }
104
105
  if (deduplicateBy) {
105
106
  for (const colRef of deduplicateBy){
106
107
  if (typeof colRef === 'string') {
107
- throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices in deduplicateBy. Got string: "${colRef}"`);
108
+ throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices in deduplicateBy. Got string: "${colRef}"`);
108
109
  }
109
110
  }
110
111
  }
111
112
  }
112
113
  const sheets = google.sheets({
113
114
  version: 'v4',
114
- auth: extra.authContext.auth
115
+ auth: googleAuth(extra.authContext.auth)
115
116
  });
116
117
  // Get sheet details using the gid
117
118
  const spreadsheetResponse = await sheets.spreadsheets.get({
@@ -123,7 +124,7 @@ async function handler({ id, gid, sourceUri, sourceHasHeaders, headerMap, dedupl
123
124
  return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === gid;
124
125
  });
125
126
  if (!sheet) {
126
- throw new McpError(ErrorCode.InvalidParams, 'Sheet not found');
127
+ throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'Sheet not found');
127
128
  }
128
129
  const sheetTitle = (_ref = sheet === null || sheet === void 0 ? void 0 : (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) !== null && _ref !== void 0 ? _ref : '';
129
130
  // Determine target headers (for sourceHasHeaders=true) or column count (for sourceHasHeaders=false)
@@ -328,7 +329,7 @@ async function handler({ id, gid, sourceUri, sourceHasHeaders, headerMap, dedupl
328
329
  logger.error('sheets.rows.csv-append error', {
329
330
  error: message
330
331
  });
331
- throw new McpError(ErrorCode.InternalError, `Error appending CSV rows: ${message}`, {
332
+ throw new ProtocolError(ProtocolErrorCode.InternalError, `Error appending CSV rows: ${message}`, {
332
333
  stack: error instanceof Error ? error.stack : undefined
333
334
  });
334
335
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/rows-csv-append.ts"],"sourcesContent":["/** Import CSV data to Google Sheets with database-style row append and deduplication */\n\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { parse } from 'csv-parse';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { getCsvReadStream } from '../../spreadsheet/csv-streaming.ts';\nimport { buildDeduplicationKey } from '../../spreadsheet/deduplication-utils.ts';\nimport { ensureTabAndHeaders } from '../../spreadsheet/sheet-operations.ts';\n\n// Header mapping schema: source/target can be string (name) or number (0-based index)\nconst HeaderMapItemSchema = z.object({\n source: z.union([z.string(), z.number().int().min(0)]).describe('CSV column: header name (string) or 0-based index (number)'),\n target: z.union([z.string(), z.number().int().min(0)]).describe('Sheet column: header name (string) or 0-based index (number)'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n sourceUri: z.string().trim().min(1).describe('CSV file URI (file://, http://, https://)'),\n sourceHasHeaders: z.boolean().default(true).describe('Source has header row for column name mapping. Set to false for data-only sources (numeric indices required).'),\n headerMap: z.array(HeaderMapItemSchema).describe('Column mappings from CSV to sheet'),\n deduplicateBy: z\n .array(z.union([z.string(), z.number().int().min(0)]))\n .optional()\n .describe('Sheet columns for deduplication (names or indices)'),\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: 'Import CSV to Google Sheets with column mapping and optional deduplication. Streams data for large files.',\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/** Batch size for Sheets API calls (1000 rows × 12 cols = 12K cells, well under 40K limit) */\nconst BATCH_SIZE = 1000;\n\n/**\n * Resolve column reference to numeric index\n * @param ref Column reference (string name or number index)\n * @param headers Header row (null when sourceHasHeaders=false)\n * @param sourceHasHeaders Whether headers are present\n * @returns 0-based column index\n */\nfunction resolveColumnReference(ref: string | number, headers: string[] | null, sourceHasHeaders: boolean, context: string): number {\n // If number, use directly as 0-based index\n if (typeof ref === 'number') {\n if (ref < 0) {\n throw new Error(`${context}: Column index must be >= 0, got ${ref}`);\n }\n return ref;\n }\n\n // If string, must be header name\n if (!sourceHasHeaders || !headers) {\n throw new Error(`${context}: String column reference \"${ref}\" requires sourceHasHeaders=true. Use numeric index when sourceHasHeaders=false.`);\n }\n\n const index = headers.indexOf(ref);\n if (index === -1) {\n throw new Error(`${context}: Header \"${ref}\" not found in [${headers.join(', ')}]`);\n }\n\n return index;\n}\n\nasync function handler({ id, gid, sourceUri, sourceHasHeaders, headerMap, deduplicateBy }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.rows.csv-append called', { id, gid, sourceUri, sourceHasHeaders, headerMap, deduplicateBy });\n\n try {\n if (headerMap.length === 0) {\n throw new McpError(ErrorCode.InvalidParams, 'headerMap cannot be empty');\n }\n\n // Validate: if sourceHasHeaders=false, all references must be numeric\n if (!sourceHasHeaders) {\n for (const { source, target } of headerMap) {\n if (typeof source === 'string') {\n throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string source: \"${source}\"`);\n }\n if (typeof target === 'string') {\n throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string target: \"${target}\"`);\n }\n }\n if (deduplicateBy) {\n for (const colRef of deduplicateBy) {\n if (typeof colRef === 'string') {\n throw new McpError(ErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices in deduplicateBy. Got string: \"${colRef}\"`);\n }\n }\n }\n }\n\n const sheets = google.sheets({ version: 'v4', auth: 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 McpError(ErrorCode.InvalidParams, 'Sheet not found');\n }\n\n const sheetTitle = sheet?.properties?.title ?? '';\n\n // Determine target headers (for sourceHasHeaders=true) or column count (for sourceHasHeaders=false)\n let sheetHeaders: string[] | null = null;\n let existingKeySet: Set<string> = new Set();\n const keyColumns: (string | number)[] = deduplicateBy || [];\n\n if (sourceHasHeaders) {\n // Extract target header names from headerMap\n const targetHeaderNames = headerMap.map(({ target }) => target).filter((t) => typeof t === 'string') as string[];\n\n // Use ensureTabAndHeaders to setup headers and fetch existing keys\n const headerResult = await ensureTabAndHeaders(sheets, {\n spreadsheetId: id,\n sheetTitle,\n requiredHeader: targetHeaderNames.length > 0 ? targetHeaderNames : null,\n keyColumns: keyColumns.filter((k) => typeof k === 'string') as string[],\n logger,\n });\n\n sheetHeaders = headerResult.header;\n existingKeySet = headerResult.keySet;\n } else {\n // sourceHasHeaders=false: Read existing data for deduplication (if needed)\n if (deduplicateBy && deduplicateBy.length > 0) {\n // Read data in chunks for memory efficiency with large sheets\n const CHUNK_SIZE = 1000;\n let startRow = 1;\n let hasMore = true;\n\n while (hasMore) {\n const endRow = startRow + CHUNK_SIZE - 1;\n const chunkRange = `${sheetTitle}!A${startRow}:ZZZ${endRow}`;\n\n const response = await sheets.spreadsheets.values.get({\n spreadsheetId: id,\n range: chunkRange,\n });\n\n const rows = response.data.values || [];\n\n for (const row of rows) {\n const key = buildDeduplicationKey(row, keyColumns, null, false);\n if (key.replace(/::/g, '') !== '') {\n existingKeySet.add(key);\n }\n }\n\n // Check if there are more rows to read\n if (rows.length < CHUNK_SIZE) {\n hasMore = false;\n } else {\n startRow += CHUNK_SIZE;\n }\n }\n\n logger.info('sheets.rows.csv-append existing keys loaded', { keyCount: existingKeySet.size });\n }\n }\n\n // Streaming CSV processing state\n let sourceHeaders: string[] | null = null;\n let batch: (string | number | boolean | null)[][] = [];\n let totalRows = 0;\n let rowsSkipped = 0;\n\n // Get readable stream from CSV URI (no temp files!)\n const readStream = await getCsvReadStream(sourceUri);\n\n // Create CSV parser\n const parser = readStream.pipe(\n parse({\n columns: !!sourceHasHeaders, // Parse first row as column names if source has headers\n skip_empty_lines: true,\n trim: true,\n cast: true, // Auto-convert numbers/booleans\n relax_column_count: true,\n })\n );\n\n // Helper to append batch to Sheets\n const appendBatch = async (rows: (string | number | boolean | null)[][]): Promise<void> => {\n if (rows.length === 0) return;\n\n await sheets.spreadsheets.values.append({\n spreadsheetId: id,\n range: `${sheetTitle}!A:A`,\n valueInputOption: 'USER_ENTERED',\n requestBody: { values: rows, majorDimension: 'ROWS' },\n });\n\n logger.info('sheets.rows.csv-append batch appended', { batchSize: rows.length, totalRows });\n };\n\n // Resolve headerMap to numeric indices (do this after extracting CSV headers)\n let resolvedMap: Array<{ sourceIdx: number; targetIdx: number }> = [];\n\n // Stream and process records\n for await (const record of parser) {\n if (sourceHasHeaders) {\n // Extract source headers from first record\n if (sourceHeaders === null) {\n sourceHeaders = Object.keys(record as Record<string, unknown>);\n logger.info('sheets.rows.csv-append source headers', { sourceHeaders });\n\n // Resolve headerMap now that we have both source and sheet headers\n resolvedMap = headerMap.map(({ source, target }) => ({\n sourceIdx: resolveColumnReference(source, sourceHeaders, sourceHasHeaders, 'headerMap.source'),\n targetIdx: resolveColumnReference(target, sheetHeaders, sourceHasHeaders, 'headerMap.target'),\n }));\n }\n\n // Map source record to sheet row\n const sourceRow = sourceHeaders?.map((h) => (record as Record<string, unknown>)[h] ?? null);\n const maxTargetIdx = Math.max(...resolvedMap.map((m) => m.targetIdx));\n const sheetRow = new Array(maxTargetIdx + 1).fill(null);\n\n for (const { sourceIdx, targetIdx } of resolvedMap) {\n if (sourceRow) {\n sheetRow[targetIdx] = sourceRow[sourceIdx] ?? null;\n }\n }\n\n // Check deduplication\n if (deduplicateBy && deduplicateBy.length > 0) {\n const key = buildDeduplicationKey(sheetRow, keyColumns, sheetHeaders, sourceHasHeaders);\n if (existingKeySet.has(key)) {\n rowsSkipped++;\n continue; // Skip duplicate\n }\n existingKeySet.add(key); // Add to set for future deduplication\n }\n\n // Add to batch\n batch.push(sheetRow);\n totalRows++;\n } else {\n // sourceHasHeaders=false: record is an array (not an object)\n // Resolve map on first row\n if (resolvedMap.length === 0) {\n resolvedMap = headerMap.map(({ source, target }) => ({\n sourceIdx: resolveColumnReference(source, null, sourceHasHeaders, 'headerMap.source'),\n targetIdx: resolveColumnReference(target, null, sourceHasHeaders, 'headerMap.target'),\n }));\n }\n\n const sourceRow = record as unknown[];\n const maxTargetIdx = Math.max(...resolvedMap.map((m) => m.targetIdx));\n const sheetRow = new Array(maxTargetIdx + 1).fill(null);\n\n for (const { sourceIdx, targetIdx } of resolvedMap) {\n if (sourceIdx < sourceRow.length) {\n sheetRow[targetIdx] = sourceRow[sourceIdx] ?? null;\n }\n }\n\n // Check deduplication\n if (deduplicateBy && deduplicateBy.length > 0) {\n const key = buildDeduplicationKey(sheetRow, keyColumns, null, sourceHasHeaders);\n if (existingKeySet.has(key)) {\n rowsSkipped++;\n continue; // Skip duplicate\n }\n existingKeySet.add(key);\n }\n\n // Add to batch\n batch.push(sheetRow);\n totalRows++;\n }\n\n // Append batch when full\n if (batch.length >= BATCH_SIZE) {\n await appendBatch(batch);\n batch = []; // Clear batch\n }\n }\n\n // Flush remaining rows\n if (batch.length > 0) {\n await appendBatch(batch);\n }\n\n logger.info('sheets.rows.csv-append streaming complete', { totalRows, rowsSkipped });\n\n const updatedRows = totalRows;\n\n logger.info('sheets.rows.csv-append completed', { id, gid, updatedRows, rowsSkipped, sourceUri });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid,\n sheetTitle,\n updatedRows,\n rowsSkipped,\n sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}`,\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.csv-append error', { error: message });\n\n throw new McpError(ErrorCode.InternalError, `Error appending CSV rows: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'rows-csv-append',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","parse","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","getCsvReadStream","buildDeduplicationKey","ensureTabAndHeaders","HeaderMapItemSchema","object","source","union","string","number","int","min","describe","target","inputSchema","id","gid","sourceUri","trim","sourceHasHeaders","boolean","default","headerMap","array","deduplicateBy","optional","successBranchSchema","type","literal","sheetTitle","updatedRows","rowsSkipped","sheetUrl","outputSchema","discriminatedUnion","config","description","result","BATCH_SIZE","resolveColumnReference","ref","headers","context","Error","index","indexOf","join","handler","extra","logger","info","spreadsheetResponse","sheet","length","InvalidParams","colRef","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","title","sheetHeaders","existingKeySet","Set","keyColumns","targetHeaderNames","map","filter","t","headerResult","requiredHeader","k","header","keySet","CHUNK_SIZE","startRow","hasMore","endRow","chunkRange","response","values","range","rows","row","key","replace","add","keyCount","size","sourceHeaders","batch","totalRows","readStream","parser","pipe","columns","skip_empty_lines","cast","relax_column_count","appendBatch","append","valueInputOption","requestBody","majorDimension","batchSize","resolvedMap","record","Object","keys","sourceIdx","targetIdx","sourceRow","h","maxTargetIdx","Math","max","m","sheetRow","Array","fill","has","push","content","text","JSON","stringify","structuredContent","error","message","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/rows-csv-append.ts"],"sourcesContent":["/** Import CSV data to Google Sheets with database-style row append and deduplication */\n\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { parse } from 'csv-parse';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { getCsvReadStream } from '../../spreadsheet/csv-streaming.ts';\nimport { buildDeduplicationKey } from '../../spreadsheet/deduplication-utils.ts';\nimport { ensureTabAndHeaders } from '../../spreadsheet/sheet-operations.ts';\n\n// Header mapping schema: source/target can be string (name) or number (0-based index)\nconst HeaderMapItemSchema = z.object({\n source: z.union([z.string(), z.number().int().min(0)]).describe('CSV column: header name (string) or 0-based index (number)'),\n target: z.union([z.string(), z.number().int().min(0)]).describe('Sheet column: header name (string) or 0-based index (number)'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n sourceUri: z.string().trim().min(1).describe('CSV file URI (file://, http://, https://)'),\n sourceHasHeaders: z.boolean().default(true).describe('Source has header row for column name mapping. Set to false for data-only sources (numeric indices required).'),\n headerMap: z.array(HeaderMapItemSchema).describe('Column mappings from CSV to sheet'),\n deduplicateBy: z\n .array(z.union([z.string(), z.number().int().min(0)]))\n .optional()\n .describe('Sheet columns for deduplication (names or indices)'),\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: 'Import CSV to Google Sheets with column mapping and optional deduplication. Streams data for large files.',\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/** Batch size for Sheets API calls (1000 rows × 12 cols = 12K cells, well under 40K limit) */\nconst BATCH_SIZE = 1000;\n\n/**\n * Resolve column reference to numeric index\n * @param ref Column reference (string name or number index)\n * @param headers Header row (null when sourceHasHeaders=false)\n * @param sourceHasHeaders Whether headers are present\n * @returns 0-based column index\n */\nfunction resolveColumnReference(ref: string | number, headers: string[] | null, sourceHasHeaders: boolean, context: string): number {\n // If number, use directly as 0-based index\n if (typeof ref === 'number') {\n if (ref < 0) {\n throw new Error(`${context}: Column index must be >= 0, got ${ref}`);\n }\n return ref;\n }\n\n // If string, must be header name\n if (!sourceHasHeaders || !headers) {\n throw new Error(`${context}: String column reference \"${ref}\" requires sourceHasHeaders=true. Use numeric index when sourceHasHeaders=false.`);\n }\n\n const index = headers.indexOf(ref);\n if (index === -1) {\n throw new Error(`${context}: Header \"${ref}\" not found in [${headers.join(', ')}]`);\n }\n\n return index;\n}\n\nasync function handler({ id, gid, sourceUri, sourceHasHeaders, headerMap, deduplicateBy }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.rows.csv-append called', { id, gid, sourceUri, sourceHasHeaders, headerMap, deduplicateBy });\n\n try {\n if (headerMap.length === 0) {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'headerMap cannot be empty');\n }\n\n // Validate: if sourceHasHeaders=false, all references must be numeric\n if (!sourceHasHeaders) {\n for (const { source, target } of headerMap) {\n if (typeof source === 'string') {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string source: \"${source}\"`);\n }\n if (typeof target === 'string') {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices. Got string target: \"${target}\"`);\n }\n }\n if (deduplicateBy) {\n for (const colRef of deduplicateBy) {\n if (typeof colRef === 'string') {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `sourceHasHeaders=false requires numeric indices in deduplicateBy. Got string: \"${colRef}\"`);\n }\n }\n }\n }\n\n const sheets = google.sheets({ 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 // Determine target headers (for sourceHasHeaders=true) or column count (for sourceHasHeaders=false)\n let sheetHeaders: string[] | null = null;\n let existingKeySet: Set<string> = new Set();\n const keyColumns: (string | number)[] = deduplicateBy || [];\n\n if (sourceHasHeaders) {\n // Extract target header names from headerMap\n const targetHeaderNames = headerMap.map(({ target }) => target).filter((t) => typeof t === 'string') as string[];\n\n // Use ensureTabAndHeaders to setup headers and fetch existing keys\n const headerResult = await ensureTabAndHeaders(sheets, {\n spreadsheetId: id,\n sheetTitle,\n requiredHeader: targetHeaderNames.length > 0 ? targetHeaderNames : null,\n keyColumns: keyColumns.filter((k) => typeof k === 'string') as string[],\n logger,\n });\n\n sheetHeaders = headerResult.header;\n existingKeySet = headerResult.keySet;\n } else {\n // sourceHasHeaders=false: Read existing data for deduplication (if needed)\n if (deduplicateBy && deduplicateBy.length > 0) {\n // Read data in chunks for memory efficiency with large sheets\n const CHUNK_SIZE = 1000;\n let startRow = 1;\n let hasMore = true;\n\n while (hasMore) {\n const endRow = startRow + CHUNK_SIZE - 1;\n const chunkRange = `${sheetTitle}!A${startRow}:ZZZ${endRow}`;\n\n const response = await sheets.spreadsheets.values.get({\n spreadsheetId: id,\n range: chunkRange,\n });\n\n const rows = response.data.values || [];\n\n for (const row of rows) {\n const key = buildDeduplicationKey(row, keyColumns, null, false);\n if (key.replace(/::/g, '') !== '') {\n existingKeySet.add(key);\n }\n }\n\n // Check if there are more rows to read\n if (rows.length < CHUNK_SIZE) {\n hasMore = false;\n } else {\n startRow += CHUNK_SIZE;\n }\n }\n\n logger.info('sheets.rows.csv-append existing keys loaded', { keyCount: existingKeySet.size });\n }\n }\n\n // Streaming CSV processing state\n let sourceHeaders: string[] | null = null;\n let batch: (string | number | boolean | null)[][] = [];\n let totalRows = 0;\n let rowsSkipped = 0;\n\n // Get readable stream from CSV URI (no temp files!)\n const readStream = await getCsvReadStream(sourceUri);\n\n // Create CSV parser\n const parser = readStream.pipe(\n parse({\n columns: !!sourceHasHeaders, // Parse first row as column names if source has headers\n skip_empty_lines: true,\n trim: true,\n cast: true, // Auto-convert numbers/booleans\n relax_column_count: true,\n })\n );\n\n // Helper to append batch to Sheets\n const appendBatch = async (rows: (string | number | boolean | null)[][]): Promise<void> => {\n if (rows.length === 0) return;\n\n await sheets.spreadsheets.values.append({\n spreadsheetId: id,\n range: `${sheetTitle}!A:A`,\n valueInputOption: 'USER_ENTERED',\n requestBody: { values: rows, majorDimension: 'ROWS' },\n });\n\n logger.info('sheets.rows.csv-append batch appended', { batchSize: rows.length, totalRows });\n };\n\n // Resolve headerMap to numeric indices (do this after extracting CSV headers)\n let resolvedMap: Array<{ sourceIdx: number; targetIdx: number }> = [];\n\n // Stream and process records\n for await (const record of parser) {\n if (sourceHasHeaders) {\n // Extract source headers from first record\n if (sourceHeaders === null) {\n sourceHeaders = Object.keys(record as Record<string, unknown>);\n logger.info('sheets.rows.csv-append source headers', { sourceHeaders });\n\n // Resolve headerMap now that we have both source and sheet headers\n resolvedMap = headerMap.map(({ source, target }) => ({\n sourceIdx: resolveColumnReference(source, sourceHeaders, sourceHasHeaders, 'headerMap.source'),\n targetIdx: resolveColumnReference(target, sheetHeaders, sourceHasHeaders, 'headerMap.target'),\n }));\n }\n\n // Map source record to sheet row\n const sourceRow = sourceHeaders?.map((h) => (record as Record<string, unknown>)[h] ?? null);\n const maxTargetIdx = Math.max(...resolvedMap.map((m) => m.targetIdx));\n const sheetRow = new Array(maxTargetIdx + 1).fill(null);\n\n for (const { sourceIdx, targetIdx } of resolvedMap) {\n if (sourceRow) {\n sheetRow[targetIdx] = sourceRow[sourceIdx] ?? null;\n }\n }\n\n // Check deduplication\n if (deduplicateBy && deduplicateBy.length > 0) {\n const key = buildDeduplicationKey(sheetRow, keyColumns, sheetHeaders, sourceHasHeaders);\n if (existingKeySet.has(key)) {\n rowsSkipped++;\n continue; // Skip duplicate\n }\n existingKeySet.add(key); // Add to set for future deduplication\n }\n\n // Add to batch\n batch.push(sheetRow);\n totalRows++;\n } else {\n // sourceHasHeaders=false: record is an array (not an object)\n // Resolve map on first row\n if (resolvedMap.length === 0) {\n resolvedMap = headerMap.map(({ source, target }) => ({\n sourceIdx: resolveColumnReference(source, null, sourceHasHeaders, 'headerMap.source'),\n targetIdx: resolveColumnReference(target, null, sourceHasHeaders, 'headerMap.target'),\n }));\n }\n\n const sourceRow = record as unknown[];\n const maxTargetIdx = Math.max(...resolvedMap.map((m) => m.targetIdx));\n const sheetRow = new Array(maxTargetIdx + 1).fill(null);\n\n for (const { sourceIdx, targetIdx } of resolvedMap) {\n if (sourceIdx < sourceRow.length) {\n sheetRow[targetIdx] = sourceRow[sourceIdx] ?? null;\n }\n }\n\n // Check deduplication\n if (deduplicateBy && deduplicateBy.length > 0) {\n const key = buildDeduplicationKey(sheetRow, keyColumns, null, sourceHasHeaders);\n if (existingKeySet.has(key)) {\n rowsSkipped++;\n continue; // Skip duplicate\n }\n existingKeySet.add(key);\n }\n\n // Add to batch\n batch.push(sheetRow);\n totalRows++;\n }\n\n // Append batch when full\n if (batch.length >= BATCH_SIZE) {\n await appendBatch(batch);\n batch = []; // Clear batch\n }\n }\n\n // Flush remaining rows\n if (batch.length > 0) {\n await appendBatch(batch);\n }\n\n logger.info('sheets.rows.csv-append streaming complete', { totalRows, rowsSkipped });\n\n const updatedRows = totalRows;\n\n logger.info('sheets.rows.csv-append completed', { id, gid, updatedRows, rowsSkipped, sourceUri });\n\n const result: Output = {\n type: 'success' as const,\n id,\n gid,\n sheetTitle,\n updatedRows,\n rowsSkipped,\n sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}`,\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.csv-append error', { error: message });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error appending CSV rows: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'rows-csv-append',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","parse","google","z","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","getCsvReadStream","buildDeduplicationKey","ensureTabAndHeaders","HeaderMapItemSchema","object","source","union","string","number","int","min","describe","target","inputSchema","id","gid","sourceUri","trim","sourceHasHeaders","boolean","default","headerMap","array","deduplicateBy","optional","successBranchSchema","type","literal","sheetTitle","updatedRows","rowsSkipped","sheetUrl","outputSchema","discriminatedUnion","config","description","result","BATCH_SIZE","resolveColumnReference","ref","headers","context","Error","index","indexOf","join","handler","extra","logger","info","spreadsheetResponse","sheet","length","InvalidParams","colRef","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","title","sheetHeaders","existingKeySet","Set","keyColumns","targetHeaderNames","map","filter","t","headerResult","requiredHeader","k","header","keySet","CHUNK_SIZE","startRow","hasMore","endRow","chunkRange","response","values","range","rows","row","key","replace","add","keyCount","size","sourceHeaders","batch","totalRows","readStream","parser","pipe","columns","skip_empty_lines","cast","relax_column_count","appendBatch","append","valueInputOption","requestBody","majorDimension","batchSize","resolvedMap","record","Object","keys","sourceIdx","targetIdx","sourceRow","h","maxTargetIdx","Math","max","m","sheetRow","Array","fill","has","push","content","text","JSON","stringify","structuredContent","error","message","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
@@ -1,5 +1,5 @@
1
1
  import type { EnrichedExtra } from '@mcp-z/oauth-google';
2
- import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
2
+ import type { CallToolResult } from '@mcp-z/server';
3
3
  import { z } from 'zod';
4
4
  declare const inputSchema: z.ZodObject<{
5
5
  id: z.ZodString;
@@ -1,8 +1,9 @@
1
1
  import { schemas } from '@mcp-z/oauth-google';
2
2
  const { AuthRequiredBranchSchema } = schemas;
3
- import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
3
+ import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
4
4
  import { google } from 'googleapis';
5
5
  import { z } from 'zod';
6
+ import { googleAuth } from '../../lib/google-auth.js';
6
7
  import { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.js';
7
8
  const inputSchema = z.object({
8
9
  id: SpreadsheetIdSchema,
@@ -45,7 +46,7 @@ async function handler({ id, gid, range, render }, extra) {
45
46
  var _spreadsheetResponse_data_sheets, _sheet_properties;
46
47
  const sheets = google.sheets({
47
48
  version: 'v4',
48
- auth: extra.authContext.auth
49
+ auth: googleAuth(extra.authContext.auth)
49
50
  });
50
51
  // Get sheet details using the gid to get sheet title
51
52
  const spreadsheetResponse = await sheets.spreadsheets.get({
@@ -62,7 +63,7 @@ async function handler({ id, gid, range, render }, extra) {
62
63
  gid,
63
64
  range
64
65
  });
65
- throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);
66
+ throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);
66
67
  }
67
68
  const sheetTitle = (_ref = (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) !== null && _ref !== void 0 ? _ref : '';
68
69
  // Construct full range with sheet title
@@ -101,8 +102,8 @@ async function handler({ id, gid, range, render }, extra) {
101
102
  logger.error('sheets.rows.get error', {
102
103
  error: message
103
104
  });
104
- // Throw McpError for proper MCP error handling
105
- throw new McpError(ErrorCode.InternalError, `Error getting rows: ${message}`, {
105
+ // Throw ProtocolError for proper MCP error handling
106
+ throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting rows: ${message}`, {
106
107
  stack: error instanceof Error ? error.stack : undefined
107
108
  });
108
109
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/rows-get.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n range: z.string().min(1).describe('A1 notation range to fetch (e.g., \"B5\", \"A5:D5\", \"B:B\", \"5:5\")'),\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 rows: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n range: z.string().describe('The A1 notation range that was retrieved'),\n rows: z.array(z.array(SheetCellSchema)).describe('2D array of row data (each inner array is a row)'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Fetch row data from a specific range in A1 notation. Best used after values-search to get surrounding context. Use a1-notation prompt for syntax reference.',\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, range, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.rows.get called', { id, gid, range, render });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n // Get sheet details using the gid to get sheet title\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 logger.info('sheets.rows.get sheet not found', { id, gid, range });\n throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties?.title ?? '';\n\n // Construct full range with sheet title\n const fullRange = `${sheetTitle}!${range}`;\n\n const response = await sheets.spreadsheets.values.get({\n spreadsheetId: id,\n range: fullRange,\n valueRenderOption: render || 'FORMATTED_VALUE',\n });\n\n const res = response.data;\n const rows = Array.isArray(res.values) ? (res.values as (string | number | boolean | null)[][]) : [];\n\n logger.info('sheets.rows.get success', { id, gid, range, rowCount: rows.length });\n\n const result: Output = {\n type: 'success' as const,\n range: res.range || fullRange,\n rows,\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.get error', { error: message });\n\n // Throw McpError for proper MCP error handling\n throw new McpError(ErrorCode.InternalError, `Error getting rows: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'rows-get',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetCellSchema","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","id","gid","range","string","min","describe","render","enum","optional","successBranchSchema","type","literal","rows","array","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","spreadsheetResponse","sheet","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","sheetTitle","title","fullRange","response","values","valueRenderOption","res","Array","isArray","rowCount","length","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/rows-get.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n range: z.string().min(1).describe('A1 notation range to fetch (e.g., \"B5\", \"A5:D5\", \"B:B\", \"5:5\")'),\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 rows: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n range: z.string().describe('The A1 notation range that was retrieved'),\n rows: z.array(z.array(SheetCellSchema)).describe('2D array of row data (each inner array is a row)'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Fetch row data from a specific range in A1 notation. Best used after values-search to get surrounding context. Use a1-notation prompt for syntax reference.',\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, range, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.rows.get called', { id, gid, range, render });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get sheet details using the gid to get sheet title\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 logger.info('sheets.rows.get sheet not found', { id, gid, range });\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n }\n\n const sheetTitle = sheet.properties?.title ?? '';\n\n // Construct full range with sheet title\n const fullRange = `${sheetTitle}!${range}`;\n\n const response = await sheets.spreadsheets.values.get({\n spreadsheetId: id,\n range: fullRange,\n valueRenderOption: render || 'FORMATTED_VALUE',\n });\n\n const res = response.data;\n const rows = Array.isArray(res.values) ? (res.values as (string | number | boolean | null)[][]) : [];\n\n logger.info('sheets.rows.get success', { id, gid, range, rowCount: rows.length });\n\n const result: Output = {\n type: 'success' as const,\n range: res.range || fullRange,\n rows,\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.get error', { error: message });\n\n // Throw ProtocolError for proper MCP error handling\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error getting rows: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'rows-get',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","googleAuth","SheetCellSchema","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","id","gid","range","string","min","describe","render","enum","optional","successBranchSchema","type","literal","rows","array","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","spreadsheetResponse","sheet","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","sheetTitle","title","fullRange","response","values","valueRenderOption","res","Array","isArray","rowCount","length","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
@@ -1,5 +1,5 @@
1
1
  import type { EnrichedExtra } from '@mcp-z/oauth-google';
2
- import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
2
+ import type { CallToolResult } from '@mcp-z/server';
3
3
  import { z } from 'zod';
4
4
  declare const inputSchema: z.ZodObject<{
5
5
  sourceId: z.ZodString;
@@ -1,8 +1,9 @@
1
1
  import { schemas } from '@mcp-z/oauth-google';
2
2
  const { AuthRequiredBranchSchema } = schemas;
3
- import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
3
+ import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
4
4
  import { google } from 'googleapis';
5
5
  import { z } from 'zod';
6
+ import { googleAuth } from '../../lib/google-auth.js';
6
7
  import { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.js';
7
8
  // Note: Using contextual descriptions for source/destination IDs since they describe different spreadsheets/sheets
8
9
  const inputSchema = z.object({
@@ -51,7 +52,7 @@ async function handler({ sourceId, sourceGid, destinationId, newTitle }, extra)
51
52
  var _sourceInfo_data_sheets;
52
53
  const sheets = google.sheets({
53
54
  version: 'v4',
54
- auth: extra.authContext.auth
55
+ auth: googleAuth(extra.authContext.auth)
55
56
  });
56
57
  // Get source sheet info
57
58
  const sourceInfo = await sheets.spreadsheets.get({
@@ -63,7 +64,7 @@ async function handler({ sourceId, sourceGid, destinationId, newTitle }, extra)
63
64
  return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === sourceGid;
64
65
  });
65
66
  if (!(sourceSheet === null || sourceSheet === void 0 ? void 0 : sourceSheet.properties)) {
66
- throw new McpError(ErrorCode.InvalidParams, `Source sheet with gid "${sourceGid}" not found in spreadsheet`);
67
+ throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Source sheet with gid "${sourceGid}" not found in spreadsheet`);
67
68
  }
68
69
  const sourceTitle = sourceSheet.properties.title || '';
69
70
  // Copy the sheet to the destination spreadsheet
@@ -135,14 +136,14 @@ async function handler({ sourceId, sourceGid, destinationId, newTitle }, extra)
135
136
  }
136
137
  };
137
138
  } catch (error) {
138
- if (error instanceof McpError) {
139
+ if (error instanceof ProtocolError) {
139
140
  throw error;
140
141
  }
141
142
  const message = error instanceof Error ? error.message : String(error);
142
143
  logger.error('sheets.sheet.copyTo error', {
143
144
  error: message
144
145
  });
145
- throw new McpError(ErrorCode.InternalError, `Error copying sheet to another spreadsheet: ${message}`, {
146
+ throw new ProtocolError(ProtocolErrorCode.InternalError, `Error copying sheet to another spreadsheet: ${message}`, {
146
147
  stack: error instanceof Error ? error.stack : undefined
147
148
  });
148
149
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/sheet-copy-to.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\n// Note: Using contextual descriptions for source/destination IDs since they describe different spreadsheets/sheets\n\nconst inputSchema = z.object({\n sourceId: SpreadsheetIdSchema.describe('Source spreadsheet ID'),\n sourceGid: SheetGidSchema.describe('Source sheet grid ID to copy'),\n destinationId: SpreadsheetIdSchema.describe('Destination spreadsheet ID'),\n newTitle: z.coerce.string().trim().min(1).optional().describe('New name for the copied sheet (optional, will use auto-generated name if not provided)'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n operationSummary: z.string().describe('Summary of the copy operation'),\n itemsProcessed: z.number().describe('Total items attempted (always 1)'),\n itemsChanged: z.number().describe('Successfully copied (always 1 on success)'),\n completedAt: z.string().describe('ISO datetime when operation completed'),\n sourceId: z.string().describe('Source spreadsheet ID'),\n sourceGid: z.string().describe('Source sheet ID'),\n sourceTitle: z.string().describe('Source sheet title'),\n destinationId: z.string().describe('Destination spreadsheet ID'),\n destinationGid: z.string().describe('Copied sheet ID in destination'),\n destinationTitle: z.string().describe('Title of the copied sheet in destination'),\n sheetUrl: z.string().describe('URL of the copied sheet'),\n renamed: z.boolean().describe('Whether the sheet was renamed after copying'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Copy a sheet to another spreadsheet. Copies all data, formatting, and charts.',\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({ sourceId, sourceGid, destinationId, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.sheet.copyTo called', { sourceId, sourceGid, destinationId, newTitle });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n // Get source sheet info\n const sourceInfo = await sheets.spreadsheets.get({\n spreadsheetId: sourceId,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n const sourceSheet = sourceInfo.data.sheets?.find((s) => String(s.properties?.sheetId) === sourceGid);\n if (!sourceSheet?.properties) {\n throw new McpError(ErrorCode.InvalidParams, `Source sheet with gid \"${sourceGid}\" not found in spreadsheet`);\n }\n\n const sourceTitle = sourceSheet.properties.title || '';\n\n // Copy the sheet to the destination spreadsheet\n const copyResponse = await sheets.spreadsheets.sheets.copyTo({\n spreadsheetId: sourceId,\n sheetId: Number(sourceGid),\n requestBody: {\n destinationSpreadsheetId: destinationId,\n },\n });\n\n const newSheetId = copyResponse.data.sheetId;\n let destinationTitle = copyResponse.data.title || '';\n\n if (!newSheetId) {\n throw new Error('Failed to retrieve new sheet ID from API response');\n }\n\n // If newTitle is provided, rename the sheet in the destination\n let renamed = false;\n if (newTitle && newTitle !== destinationTitle) {\n await sheets.spreadsheets.batchUpdate({\n spreadsheetId: destinationId,\n requestBody: {\n requests: [\n {\n updateSheetProperties: {\n properties: { sheetId: newSheetId, title: newTitle },\n fields: 'title',\n },\n },\n ],\n },\n });\n destinationTitle = newTitle;\n renamed = true;\n }\n\n logger.info('sheets.sheet.copyTo success', {\n sourceId,\n sourceGid,\n destinationId,\n destinationGid: String(newSheetId),\n renamed,\n });\n\n const result: Output = {\n type: 'success' as const,\n operationSummary: `Copied sheet \"${sourceTitle}\" to destination${renamed ? ` as \"${destinationTitle}\"` : ''}`,\n itemsProcessed: 1,\n itemsChanged: 1,\n completedAt: new Date().toISOString(),\n sourceId,\n sourceGid,\n sourceTitle,\n destinationId,\n destinationGid: String(newSheetId),\n destinationTitle,\n sheetUrl: `https://docs.google.com/spreadsheets/d/${destinationId}/edit#gid=${newSheetId}`,\n renamed,\n };\n\n return {\n content: [\n {\n type: 'text' as const,\n text: JSON.stringify(result),\n },\n ],\n structuredContent: { result },\n };\n } catch (error) {\n if (error instanceof McpError) {\n throw error;\n }\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.sheet.copyTo error', { error: message });\n\n throw new McpError(ErrorCode.InternalError, `Error copying sheet to another spreadsheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'sheet-copy-to',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","sourceId","describe","sourceGid","destinationId","newTitle","coerce","string","trim","min","optional","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","sourceTitle","destinationGid","destinationTitle","sheetUrl","renamed","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","sourceInfo","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","sourceSheet","data","find","s","String","properties","sheetId","InvalidParams","title","copyResponse","copyTo","Number","requestBody","destinationSpreadsheetId","newSheetId","Error","batchUpdate","requests","updateSheetProperties","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/sheet-copy-to.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\n// Note: Using contextual descriptions for source/destination IDs since they describe different spreadsheets/sheets\n\nconst inputSchema = z.object({\n sourceId: SpreadsheetIdSchema.describe('Source spreadsheet ID'),\n sourceGid: SheetGidSchema.describe('Source sheet grid ID to copy'),\n destinationId: SpreadsheetIdSchema.describe('Destination spreadsheet ID'),\n newTitle: z.coerce.string().trim().min(1).optional().describe('New name for the copied sheet (optional, will use auto-generated name if not provided)'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n operationSummary: z.string().describe('Summary of the copy operation'),\n itemsProcessed: z.number().describe('Total items attempted (always 1)'),\n itemsChanged: z.number().describe('Successfully copied (always 1 on success)'),\n completedAt: z.string().describe('ISO datetime when operation completed'),\n sourceId: z.string().describe('Source spreadsheet ID'),\n sourceGid: z.string().describe('Source sheet ID'),\n sourceTitle: z.string().describe('Source sheet title'),\n destinationId: z.string().describe('Destination spreadsheet ID'),\n destinationGid: z.string().describe('Copied sheet ID in destination'),\n destinationTitle: z.string().describe('Title of the copied sheet in destination'),\n sheetUrl: z.string().describe('URL of the copied sheet'),\n renamed: z.boolean().describe('Whether the sheet was renamed after copying'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Copy a sheet to another spreadsheet. Copies all data, formatting, and charts.',\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({ sourceId, sourceGid, destinationId, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.sheet.copyTo called', { sourceId, sourceGid, destinationId, newTitle });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // Get source sheet info\n const sourceInfo = await sheets.spreadsheets.get({\n spreadsheetId: sourceId,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n const sourceSheet = sourceInfo.data.sheets?.find((s) => String(s.properties?.sheetId) === sourceGid);\n if (!sourceSheet?.properties) {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Source sheet with gid \"${sourceGid}\" not found in spreadsheet`);\n }\n\n const sourceTitle = sourceSheet.properties.title || '';\n\n // Copy the sheet to the destination spreadsheet\n const copyResponse = await sheets.spreadsheets.sheets.copyTo({\n spreadsheetId: sourceId,\n sheetId: Number(sourceGid),\n requestBody: {\n destinationSpreadsheetId: destinationId,\n },\n });\n\n const newSheetId = copyResponse.data.sheetId;\n let destinationTitle = copyResponse.data.title || '';\n\n if (!newSheetId) {\n throw new Error('Failed to retrieve new sheet ID from API response');\n }\n\n // If newTitle is provided, rename the sheet in the destination\n let renamed = false;\n if (newTitle && newTitle !== destinationTitle) {\n await sheets.spreadsheets.batchUpdate({\n spreadsheetId: destinationId,\n requestBody: {\n requests: [\n {\n updateSheetProperties: {\n properties: { sheetId: newSheetId, title: newTitle },\n fields: 'title',\n },\n },\n ],\n },\n });\n destinationTitle = newTitle;\n renamed = true;\n }\n\n logger.info('sheets.sheet.copyTo success', {\n sourceId,\n sourceGid,\n destinationId,\n destinationGid: String(newSheetId),\n renamed,\n });\n\n const result: Output = {\n type: 'success' as const,\n operationSummary: `Copied sheet \"${sourceTitle}\" to destination${renamed ? ` as \"${destinationTitle}\"` : ''}`,\n itemsProcessed: 1,\n itemsChanged: 1,\n completedAt: new Date().toISOString(),\n sourceId,\n sourceGid,\n sourceTitle,\n destinationId,\n destinationGid: String(newSheetId),\n destinationTitle,\n sheetUrl: `https://docs.google.com/spreadsheets/d/${destinationId}/edit#gid=${newSheetId}`,\n renamed,\n };\n\n return {\n content: [\n {\n type: 'text' as const,\n text: JSON.stringify(result),\n },\n ],\n structuredContent: { result },\n };\n } catch (error) {\n if (error instanceof ProtocolError) {\n throw error;\n }\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.sheet.copyTo error', { error: message });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error copying sheet to another spreadsheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'sheet-copy-to',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","googleAuth","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","sourceId","describe","sourceGid","destinationId","newTitle","coerce","string","trim","min","optional","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","sourceTitle","destinationGid","destinationTitle","sheetUrl","renamed","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","sourceInfo","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","sourceSheet","data","find","s","String","properties","sheetId","InvalidParams","title","copyResponse","copyTo","Number","requestBody","destinationSpreadsheetId","newSheetId","Error","batchUpdate","requests","updateSheetProperties","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
@@ -1,5 +1,5 @@
1
1
  import type { EnrichedExtra } from '@mcp-z/oauth-google';
2
- import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
2
+ import type { CallToolResult } from '@mcp-z/server';
3
3
  import { z } from 'zod';
4
4
  declare const inputSchema: z.ZodObject<{
5
5
  id: z.ZodString;
@@ -1,8 +1,9 @@
1
1
  import { schemas } from '@mcp-z/oauth-google';
2
2
  const { AuthRequiredBranchSchema } = schemas;
3
- import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
3
+ import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
4
4
  import { google } from 'googleapis';
5
5
  import { z } from 'zod';
6
+ import { googleAuth } from '../../lib/google-auth.js';
6
7
  import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
7
8
  const MAX_BATCH_SIZE = 100;
8
9
  const copyItemSchema = z.object({
@@ -59,7 +60,7 @@ async function handler({ id, gid, copies }, extra) {
59
60
  var _spreadsheetInfo_data_sheets;
60
61
  const sheets = google.sheets({
61
62
  version: 'v4',
62
- auth: extra.authContext.auth
63
+ auth: googleAuth(extra.authContext.auth)
63
64
  });
64
65
  // First, get the source sheet info
65
66
  const spreadsheetInfo = await sheets.spreadsheets.get({
@@ -71,7 +72,7 @@ async function handler({ id, gid, copies }, extra) {
71
72
  return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === gid;
72
73
  });
73
74
  if (!(sourceSheet === null || sourceSheet === void 0 ? void 0 : sourceSheet.properties)) {
74
- throw new McpError(ErrorCode.InvalidParams, `Source sheet with gid "${gid}" not found in spreadsheet`);
75
+ throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Source sheet with gid "${gid}" not found in spreadsheet`);
75
76
  }
76
77
  const sourceTitle = sourceSheet.properties.title || '';
77
78
  const sourceSheetId = Number(gid);
@@ -156,14 +157,14 @@ async function handler({ id, gid, copies }, extra) {
156
157
  }
157
158
  };
158
159
  } catch (error) {
159
- if (error instanceof McpError) {
160
+ if (error instanceof ProtocolError) {
160
161
  throw error;
161
162
  }
162
163
  const message = error instanceof Error ? error.message : String(error);
163
164
  logger.error('sheets.sheet.copy error', {
164
165
  error: message
165
166
  });
166
- throw new McpError(ErrorCode.InternalError, `Error copying sheet: ${message}`, {
167
+ throw new ProtocolError(ProtocolErrorCode.InternalError, `Error copying sheet: ${message}`, {
167
168
  stack: error instanceof Error ? error.stack : undefined
168
169
  });
169
170
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/sheet-copy.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst MAX_BATCH_SIZE = 100;\n\nconst copyItemSchema = z.object({\n newTitle: z.coerce.string().trim().min(1).describe('Name for the copied sheet'),\n insertIndex: z.number().int().min(0).optional().describe('Position to insert the new sheet (0-indexed)'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n copies: z.array(copyItemSchema).min(1).max(MAX_BATCH_SIZE).describe('Array of copies to create from the source sheet'),\n});\n\n// Created sheet info\nconst createdSheetSchema = z.object({\n gid: SheetGidOutput,\n title: z.string().describe('Title of the created sheet'),\n sheetUrl: z.string().describe('URL of the created sheet'),\n});\n\n// Success branch schema - uses items: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n operationSummary: z.string().describe('Summary of the copy operation'),\n itemsProcessed: z.number().describe('Total copies attempted'),\n itemsChanged: z.number().describe('Successfully created copies'),\n completedAt: z.string().describe('ISO datetime when operation completed'),\n id: SpreadsheetIdOutput,\n sourceGid: z.string().describe('Source sheet ID'),\n sourceTitle: z.string().describe('Source sheet title'),\n items: z.array(createdSheetSchema).describe('Information about created sheets'),\n failures: z\n .array(\n z.object({\n title: z.string(),\n error: z.string(),\n })\n )\n .optional()\n .describe('Failed copies with error messages'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Copy a sheet/tab within the same spreadsheet. Supports batch copying: create multiple copies from a single source sheet (e.g., create 12 monthly sheets from a template). Copies all data, formatting, charts, and conditional formatting verbatim.',\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, copies }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.sheet.copy called', { id, gid, copyCount: copies.length });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n // First, get the source sheet info\n const spreadsheetInfo = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n const sourceSheet = spreadsheetInfo.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sourceSheet?.properties) {\n throw new McpError(ErrorCode.InvalidParams, `Source sheet with gid \"${gid}\" not found in spreadsheet`);\n }\n\n const sourceTitle = sourceSheet.properties.title || '';\n const sourceSheetId = Number(gid);\n\n // Execute copies using Promise.allSettled for partial failure handling\n const results = await Promise.allSettled(\n copies.map(async (copy) => {\n const response = await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: [\n {\n duplicateSheet: {\n sourceSheetId,\n newSheetName: copy.newTitle,\n ...(copy.insertIndex !== undefined && { insertSheetIndex: copy.insertIndex }),\n },\n },\n ],\n },\n });\n\n const newSheetId = response.data.replies?.[0]?.duplicateSheet?.properties?.sheetId;\n const newTitle = response.data.replies?.[0]?.duplicateSheet?.properties?.title;\n\n if (!newSheetId || !newTitle) {\n throw new Error('Failed to retrieve new sheet info from API response');\n }\n\n return {\n gid: String(newSheetId),\n title: newTitle,\n sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${newSheetId}`,\n };\n })\n );\n\n // Separate successes and failures\n const items: Array<{ gid: string; title: string; sheetUrl: string }> = [];\n const failures: Array<{ title: string; error: string }> = [];\n\n results.forEach((result, index) => {\n const copy = copies[index];\n if (!copy) return;\n\n if (result.status === 'fulfilled') {\n items.push(result.value);\n } else {\n const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);\n failures.push({ title: copy.newTitle, error: errorMessage });\n }\n });\n\n const successCount = items.length;\n const failureCount = failures.length;\n const totalCount = copies.length;\n\n const summary = failureCount === 0 ? `Created ${successCount} cop${successCount === 1 ? 'y' : 'ies'} of \"${sourceTitle}\"` : `Created ${successCount} of ${totalCount} cop${totalCount === 1 ? 'y' : 'ies'} (${failureCount} failed)`;\n\n logger.info('sheets.sheet.copy completed', { totalCount, successCount, failureCount });\n\n const result: Output = {\n type: 'success' as const,\n operationSummary: summary,\n itemsProcessed: totalCount,\n itemsChanged: successCount,\n completedAt: new Date().toISOString(),\n id,\n sourceGid: gid,\n sourceTitle,\n items,\n ...(failures.length > 0 && { failures }),\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n if (error instanceof McpError) {\n throw error;\n }\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.sheet.copy error', { error: message });\n\n throw new McpError(ErrorCode.InternalError, `Error copying sheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'sheet-copy',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","MAX_BATCH_SIZE","copyItemSchema","object","newTitle","coerce","string","trim","min","describe","insertIndex","number","int","optional","inputSchema","id","gid","copies","array","max","createdSheetSchema","title","sheetUrl","successBranchSchema","type","literal","operationSummary","itemsProcessed","itemsChanged","completedAt","sourceGid","sourceTitle","items","failures","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","copyCount","length","spreadsheetInfo","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","sourceSheet","data","find","s","String","properties","sheetId","InvalidParams","sourceSheetId","Number","results","Promise","allSettled","map","copy","response","batchUpdate","requestBody","requests","duplicateSheet","newSheetName","undefined","insertSheetIndex","newSheetId","replies","Error","forEach","index","status","push","value","errorMessage","reason","message","successCount","failureCount","totalCount","summary","Date","toISOString","content","text","JSON","stringify","structuredContent","InternalError","stack","createTool","name"],"mappings":"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"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/sheet-copy.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst MAX_BATCH_SIZE = 100;\n\nconst copyItemSchema = z.object({\n newTitle: z.coerce.string().trim().min(1).describe('Name for the copied sheet'),\n insertIndex: z.number().int().min(0).optional().describe('Position to insert the new sheet (0-indexed)'),\n});\n\nconst inputSchema = z.object({\n id: SpreadsheetIdSchema,\n gid: SheetGidSchema,\n copies: z.array(copyItemSchema).min(1).max(MAX_BATCH_SIZE).describe('Array of copies to create from the source sheet'),\n});\n\n// Created sheet info\nconst createdSheetSchema = z.object({\n gid: SheetGidOutput,\n title: z.string().describe('Title of the created sheet'),\n sheetUrl: z.string().describe('URL of the created sheet'),\n});\n\n// Success branch schema - uses items: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n operationSummary: z.string().describe('Summary of the copy operation'),\n itemsProcessed: z.number().describe('Total copies attempted'),\n itemsChanged: z.number().describe('Successfully created copies'),\n completedAt: z.string().describe('ISO datetime when operation completed'),\n id: SpreadsheetIdOutput,\n sourceGid: z.string().describe('Source sheet ID'),\n sourceTitle: z.string().describe('Source sheet title'),\n items: z.array(createdSheetSchema).describe('Information about created sheets'),\n failures: z\n .array(\n z.object({\n title: z.string(),\n error: z.string(),\n })\n )\n .optional()\n .describe('Failed copies with error messages'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Copy a sheet/tab within the same spreadsheet. Supports batch copying: create multiple copies from a single source sheet (e.g., create 12 monthly sheets from a template). Copies all data, formatting, charts, and conditional formatting verbatim.',\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, copies }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n const logger = extra.logger;\n logger.info('sheets.sheet.copy called', { id, gid, copyCount: copies.length });\n\n try {\n const sheets = google.sheets({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n // First, get the source sheet info\n const spreadsheetInfo = await sheets.spreadsheets.get({\n spreadsheetId: id,\n fields: 'sheets.properties.sheetId,sheets.properties.title',\n });\n\n const sourceSheet = spreadsheetInfo.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n if (!sourceSheet?.properties) {\n throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Source sheet with gid \"${gid}\" not found in spreadsheet`);\n }\n\n const sourceTitle = sourceSheet.properties.title || '';\n const sourceSheetId = Number(gid);\n\n // Execute copies using Promise.allSettled for partial failure handling\n const results = await Promise.allSettled(\n copies.map(async (copy) => {\n const response = await sheets.spreadsheets.batchUpdate({\n spreadsheetId: id,\n requestBody: {\n requests: [\n {\n duplicateSheet: {\n sourceSheetId,\n newSheetName: copy.newTitle,\n ...(copy.insertIndex !== undefined && { insertSheetIndex: copy.insertIndex }),\n },\n },\n ],\n },\n });\n\n const newSheetId = response.data.replies?.[0]?.duplicateSheet?.properties?.sheetId;\n const newTitle = response.data.replies?.[0]?.duplicateSheet?.properties?.title;\n\n if (!newSheetId || !newTitle) {\n throw new Error('Failed to retrieve new sheet info from API response');\n }\n\n return {\n gid: String(newSheetId),\n title: newTitle,\n sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${newSheetId}`,\n };\n })\n );\n\n // Separate successes and failures\n const items: Array<{ gid: string; title: string; sheetUrl: string }> = [];\n const failures: Array<{ title: string; error: string }> = [];\n\n results.forEach((result, index) => {\n const copy = copies[index];\n if (!copy) return;\n\n if (result.status === 'fulfilled') {\n items.push(result.value);\n } else {\n const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);\n failures.push({ title: copy.newTitle, error: errorMessage });\n }\n });\n\n const successCount = items.length;\n const failureCount = failures.length;\n const totalCount = copies.length;\n\n const summary = failureCount === 0 ? `Created ${successCount} cop${successCount === 1 ? 'y' : 'ies'} of \"${sourceTitle}\"` : `Created ${successCount} of ${totalCount} cop${totalCount === 1 ? 'y' : 'ies'} (${failureCount} failed)`;\n\n logger.info('sheets.sheet.copy completed', { totalCount, successCount, failureCount });\n\n const result: Output = {\n type: 'success' as const,\n operationSummary: summary,\n itemsProcessed: totalCount,\n itemsChanged: successCount,\n completedAt: new Date().toISOString(),\n id,\n sourceGid: gid,\n sourceTitle,\n items,\n ...(failures.length > 0 && { failures }),\n };\n\n return {\n content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n structuredContent: { result },\n };\n } catch (error) {\n if (error instanceof ProtocolError) {\n throw error;\n }\n const message = error instanceof Error ? error.message : String(error);\n logger.error('sheets.sheet.copy error', { error: message });\n\n throw new ProtocolError(ProtocolErrorCode.InternalError, `Error copying sheet: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'sheet-copy',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","google","z","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","MAX_BATCH_SIZE","copyItemSchema","object","newTitle","coerce","string","trim","min","describe","insertIndex","number","int","optional","inputSchema","id","gid","copies","array","max","createdSheetSchema","title","sheetUrl","successBranchSchema","type","literal","operationSummary","itemsProcessed","itemsChanged","completedAt","sourceGid","sourceTitle","items","failures","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","copyCount","length","spreadsheetInfo","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","sourceSheet","data","find","s","String","properties","sheetId","InvalidParams","sourceSheetId","Number","results","Promise","allSettled","map","copy","response","batchUpdate","requestBody","requests","duplicateSheet","newSheetName","undefined","insertSheetIndex","newSheetId","replies","Error","forEach","index","status","push","value","errorMessage","reason","message","successCount","failureCount","totalCount","summary","Date","toISOString","content","text","JSON","stringify","structuredContent","InternalError","stack","createTool","name"],"mappings":"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"}
@@ -1,5 +1,5 @@
1
1
  import type { EnrichedExtra } from '@mcp-z/oauth-google';
2
- import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
2
+ import type { CallToolResult } from '@mcp-z/server';
3
3
  import { z } from 'zod';
4
4
  declare const inputSchema: z.ZodObject<{
5
5
  id: z.ZodString;