@mcp-z/mcp-sheets 1.0.7 → 1.1.0

package/dist/esm/mcp/tools/dimensions-move.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/tools/dimensions-move.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  dimension: z.enum(['ROWS', 'COLUMNS']).describe('Whether to move rows or columns'),\n  startIndex: z.number().int().nonnegative().describe('Starting index of the range to move (0-based)'),\n  endIndex: z.number().int().positive().describe('Ending index of the range to move (0-based, exclusive)'),\n  destinationIndex: z.number().int().nonnegative().describe('Index where the rows/columns will be moved to (0-based)'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  spreadsheetTitle: z.string().describe('Title of the spreadsheet'),\n  spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n  sheetTitle: z.string().describe('Title of the sheet'),\n  sheetUrl: z.string().describe('URL of the sheet'),\n  dimension: z.enum(['ROWS', 'COLUMNS']).describe('Dimension that was moved'),\n  sourceRange: z.object({\n    startIndex: z.number().describe('Starting index of the moved range'),\n    endIndex: z.number().describe('Ending index of the moved range'),\n  }),\n  destinationIndex: z.number().describe('Index where the range was moved to'),\n  movedCount: z.number().describe('Number of rows/columns moved'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Move rows or columns within a sheet to a new position. Use 0-based indices. The destinationIndex is where the rows/columns will be moved TO.',\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, dimension, startIndex, endIndex, destinationIndex }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.dimensions.move called', { id, gid, dimension, startIndex, endIndex, destinationIndex });\n\n  // Validate indices\n  if (startIndex >= endIndex) {\n    throw new McpError(ErrorCode.InvalidParams, `startIndex (${startIndex}) must be less than endIndex (${endIndex})`);\n  }\n\n  // Check if destination is within source range (invalid move)\n  if (destinationIndex > startIndex && destinationIndex < endIndex) {\n    throw new McpError(ErrorCode.InvalidParams, `destinationIndex (${destinationIndex}) cannot be within the source range (${startIndex}-${endIndex})`);\n  }\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const spreadsheetData = spreadsheetResponse.data;\n    const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n    const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n    // Find sheet by gid\n    const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for move', { id, gid, dimension });\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    const sheetGid = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n    logger.info('sheets.dimensions.move executing', { spreadsheetId: id, sheetTitle, dimension, startIndex, endIndex, destinationIndex });\n\n    // Execute the move dimension request\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [\n          {\n            moveDimension: {\n              source: {\n                sheetId: sheetGid,\n                dimension,\n                startIndex,\n                endIndex,\n              },\n              destinationIndex,\n            },\n          },\n        ],\n      },\n    });\n\n    const movedCount = endIndex - startIndex;\n\n    logger.info('sheets.dimensions.move completed successfully', {\n      spreadsheetId: id,\n      sheetTitle,\n      dimension,\n      movedCount,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetGid),\n      spreadsheetTitle: spreadsheetTitle || '',\n      spreadsheetUrl: spreadsheetUrl || '',\n      sheetTitle,\n      sheetUrl,\n      dimension,\n      sourceRange: {\n        startIndex,\n        endIndex,\n      },\n      destinationIndex,\n      movedCount,\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('Move operation failed', { id, gid, dimension, startIndex, endIndex, destinationIndex, error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error moving ${dimension.toLowerCase()}: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'dimensions-move',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","inputSchema","object","id","gid","dimension","enum","describe","startIndex","number","int","nonnegative","endIndex","positive","destinationIndex","successBranchSchema","type","literal","spreadsheetTitle","string","spreadsheetUrl","sheetTitle","sheetUrl","sourceRange","movedCount","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","InvalidParams","spreadsheetData","sheet","sheets","version","auth","authContext","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","properties","title","find","s","String","sheetId","sheetGid","batchUpdate","requestBody","requests","moveDimension","source","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","toLowerCase","stack","undefined","createTool","name"],"mappings":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAIrC,SAASE,SAAS,EAAEC,QAAQ,QAAQ,qCAAqC;AACzE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,cAAc,EAAEC,cAAc,EAAEC,mBAAmB,EAAEC,mBAAmB,QAAQ,yBAAyB;AAElH,MAAMC,cAAcL,EAAEM,MAAM,CAAC;IAC3BC,IAAIH;IACJI,KAAKN;IACLO,WAAWT,EAAEU,IAAI,CAAC;QAAC;QAAQ;KAAU,EAAEC,QAAQ,CAAC;IAChDC,YAAYZ,EAAEa,MAAM,GAAGC,GAAG,GAAGC,WAAW,GAAGJ,QAAQ,CAAC;IACpDK,UAAUhB,EAAEa,MAAM,GAAGC,GAAG,GAAGG,QAAQ,GAAGN,QAAQ,CAAC;IAC/CO,kBAAkBlB,EAAEa,MAAM,GAAGC,GAAG,GAAGC,WAAW,GAAGJ,QAAQ,CAAC;AAC5D;AAEA,MAAMQ,sBAAsBnB,EAAEM,MAAM,CAAC;IACnCc,MAAMpB,EAAEqB,OAAO,CAAC;IAChBd,IAAIJ;IACJK,KAAKP;IACLqB,kBAAkBtB,EAAEuB,MAAM,GAAGZ,QAAQ,CAAC;IACtCa,gBAAgBxB,EAAEuB,MAAM,GAAGZ,QAAQ,CAAC;IACpCc,YAAYzB,EAAEuB,MAAM,GAAGZ,QAAQ,CAAC;IAChCe,UAAU1B,EAAEuB,MAAM,GAAGZ,QAAQ,CAAC;IAC9BF,WAAWT,EAAEU,IAAI,CAAC;QAAC;QAAQ;KAAU,EAAEC,QAAQ,CAAC;IAChDgB,aAAa3B,EAAEM,MAAM,CAAC;QACpBM,YAAYZ,EAAEa,MAAM,GAAGF,QAAQ,CAAC;QAChCK,UAAUhB,EAAEa,MAAM,GAAGF,QAAQ,CAAC;IAChC;IACAO,kBAAkBlB,EAAEa,MAAM,GAAGF,QAAQ,CAAC;IACtCiB,YAAY5B,EAAEa,MAAM,GAAGF,QAAQ,CAAC;AAClC;AAEA,MAAMkB,eAAe7B,EAAE8B,kBAAkB,CAAC,QAAQ;IAACX;IAAqBvB;CAAyB;AAEjG,MAAMmC,SAAS;IACbC,aAAa;IACb3B;IACAwB,cAAc7B,EAAEM,MAAM,CAAC;QACrB2B,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAE3B,EAAE,EAAEC,GAAG,EAAEC,SAAS,EAAEG,UAAU,EAAEI,QAAQ,EAAEE,gBAAgB,EAAS,EAAEiB,KAAoB;IAChH,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,iCAAiC;QAAE9B;QAAIC;QAAKC;QAAWG;QAAYI;QAAUE;IAAiB;IAE1G,mBAAmB;IACnB,IAAIN,cAAcI,UAAU;QAC1B,MAAM,IAAIlB,SAASD,UAAUyC,aAAa,EAAE,CAAC,YAAY,EAAE1B,WAAW,8BAA8B,EAAEI,SAAS,CAAC,CAAC;IACnH;IAEA,6DAA6D;IAC7D,IAAIE,mBAAmBN,cAAcM,mBAAmBF,UAAU;QAChE,MAAM,IAAIlB,SAASD,UAAUyC,aAAa,EAAE,CAAC,kBAAkB,EAAEpB,iBAAiB,qCAAqC,EAAEN,WAAW,CAAC,EAAEI,SAAS,CAAC,CAAC;IACpJ;IAEA,IAAI;kBAWqBuB,iCASJC,yBACFA;YAXQD,6BAIXA;QAbd,MAAME,SAAS1C,OAAO0C,MAAM,CAAC;YAAEC,SAAS;YAAMC,MAAMR,MAAMS,WAAW,CAACD,IAAI;QAAC;QAE3E,oDAAoD;QACpD,MAAME,sBAAsB,MAAMJ,OAAOK,YAAY,CAACC,GAAG,CAAC;YACxDC,eAAezC;YACf0C,QAAQ;QACV;QAEA,MAAMV,kBAAkBM,oBAAoBK,IAAI;QAChD,MAAM5B,4BAAmBiB,8BAAAA,gBAAgBY,UAAU,cAA1BZ,kDAAAA,4BAA4Ba,KAAK,uCAAI;QAC9D,MAAM5B,kBAAiBe,kCAAAA,gBAAgBf,cAAc,cAA9Be,6CAAAA,kCAAkC;QAEzD,oBAAoB;QACpB,MAAMC,SAAQD,0BAAAA,gBAAgBE,MAAM,cAAtBF,8CAAAA,wBAAwBc,IAAI,CAAC,CAACC;gBAAaA;mBAAPC,QAAOD,gBAAAA,EAAEH,UAAU,cAAZG,oCAAAA,cAAcE,OAAO,MAAMhD;;QACpF,IAAI,EAACgC,kBAAAA,4BAAAA,MAAOW,UAAU,GAAE;YACtBf,OAAOC,IAAI,CAAC,4BAA4B;gBAAE9B;gBAAIC;gBAAKC;YAAU;YAC7D,MAAM,IAAIX,SAASD,UAAUyC,aAAa,EAAE,CAAC,iBAAiB,EAAE9B,KAAK;QACvE;QAEA,MAAMiB,cAAae,0BAAAA,MAAMW,UAAU,CAACC,KAAK,cAAtBZ,qCAAAA,0BAA0BhC;QAC7C,MAAMiD,YAAWjB,4BAAAA,MAAMW,UAAU,CAACK,OAAO,cAAxBhB,uCAAAA,4BAA4B;QAC7C,MAAMd,WAAW,CAAC,uCAAuC,EAAEnB,GAAG,UAAU,EAAEkD,UAAU;QAEpFrB,OAAOC,IAAI,CAAC,oCAAoC;YAAEW,eAAezC;YAAIkB;YAAYhB;YAAWG;YAAYI;YAAUE;QAAiB;QAEnI,qCAAqC;QACrC,MAAMuB,OAAOK,YAAY,CAACY,WAAW,CAAC;YACpCV,eAAezC;YACfoD,aAAa;gBACXC,UAAU;oBACR;wBACEC,eAAe;4BACbC,QAAQ;gCACNN,SAASC;gCACThD;gCACAG;gCACAI;4BACF;4BACAE;wBACF;oBACF;iBACD;YACH;QACF;QAEA,MAAMU,aAAaZ,WAAWJ;QAE9BwB,OAAOC,IAAI,CAAC,iDAAiD;YAC3DW,eAAezC;YACfkB;YACAhB;YACAmB;QACF;QAEA,MAAMK,SAAiB;YACrBb,MAAM;YACNb;YACAC,KAAK+C,OAAOE;YACZnC,kBAAkBA,oBAAoB;YACtCE,gBAAgBA,kBAAkB;YAClCC;YACAC;YACAjB;YACAkB,aAAa;gBACXf;gBACAI;YACF;YACAE;YACAU;QACF;QAEA,OAAO;YACLmC,SAAS;gBAAC;oBAAE3C,MAAM;oBAAiB4C,MAAMC,KAAKC,SAAS,CAACjC;gBAAQ;aAAE;YAClEkC,mBAAmB;gBAAElC;YAAO;QAC9B;IACF,EAAE,OAAOmC,OAAO;QACd,IAAIA,iBAAiBtE,UAAU;YAC7B,MAAMsE;QACR;QACA,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGd,OAAOa;QAChEhC,OAAOgC,KAAK,CAAC,yBAAyB;YAAE7D;YAAIC;YAAKC;YAAWG;YAAYI;YAAUE;YAAkBkD,OAAOC;QAAQ;QAEnH,MAAM,IAAIvE,SAASD,UAAU0E,aAAa,EAAE,CAAC,aAAa,EAAE9D,UAAU+D,WAAW,GAAG,EAAE,EAAEH,SAAS,EAAE;YACjGI,OAAOL,iBAAiBE,QAAQF,MAAMK,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACN7C;QACAG;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/dimensions-move.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  dimension: z.enum(['ROWS', 'COLUMNS']).describe('Whether to move rows or columns'),\n  startIndex: z.number().int().nonnegative().describe('Starting index of the range to move (0-based)'),\n  endIndex: z.number().int().positive().describe('Ending index of the range to move (0-based, exclusive)'),\n  destinationIndex: z.number().int().nonnegative().describe('Index where the rows/columns will be moved to (0-based)'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  spreadsheetTitle: z.string().describe('Title of the spreadsheet'),\n  spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n  sheetTitle: z.string().describe('Title of the sheet'),\n  sheetUrl: z.string().describe('URL of the sheet'),\n  dimension: z.enum(['ROWS', 'COLUMNS']).describe('Dimension that was moved'),\n  sourceRange: z.object({\n    startIndex: z.number().describe('Starting index of the moved range'),\n    endIndex: z.number().describe('Ending index of the moved range'),\n  }),\n  destinationIndex: z.number().describe('Index where the range was moved to'),\n  movedCount: z.number().describe('Number of rows/columns moved'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Move rows or columns within a sheet to a new position. Use 0-based indices. The destinationIndex is where the rows/columns will be moved TO.',\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, dimension, startIndex, endIndex, destinationIndex }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.dimensions.move called', { id, gid, dimension, startIndex, endIndex, destinationIndex });\n\n  // Validate indices\n  if (startIndex >= endIndex) {\n    throw new McpError(ErrorCode.InvalidParams, `startIndex (${startIndex}) must be less than endIndex (${endIndex})`);\n  }\n\n  // Check if destination is within source range (invalid move)\n  if (destinationIndex > startIndex && destinationIndex < endIndex) {\n    throw new McpError(ErrorCode.InvalidParams, `destinationIndex (${destinationIndex}) cannot be within the source range (${startIndex}-${endIndex})`);\n  }\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const spreadsheetData = spreadsheetResponse.data;\n    const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n    const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n    // Find sheet by gid\n    const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for move', { id, gid, dimension });\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    const sheetGid = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n    logger.info('sheets.dimensions.move executing', { spreadsheetId: id, sheetTitle, dimension, startIndex, endIndex, destinationIndex });\n\n    // Execute the move dimension request\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [\n          {\n            moveDimension: {\n              source: {\n                sheetId: sheetGid,\n                dimension,\n                startIndex,\n                endIndex,\n              },\n              destinationIndex,\n            },\n          },\n        ],\n      },\n    });\n\n    const movedCount = endIndex - startIndex;\n\n    logger.info('sheets.dimensions.move completed successfully', {\n      spreadsheetId: id,\n      sheetTitle,\n      dimension,\n      movedCount,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetGid),\n      spreadsheetTitle: spreadsheetTitle || '',\n      spreadsheetUrl: spreadsheetUrl || '',\n      sheetTitle,\n      sheetUrl,\n      dimension,\n      sourceRange: {\n        startIndex,\n        endIndex,\n      },\n      destinationIndex,\n      movedCount,\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('Move operation failed', { id, gid, dimension, startIndex, endIndex, destinationIndex, error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error moving ${dimension.toLowerCase()}: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'dimensions-move',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","inputSchema","object","id","gid","dimension","enum","describe","startIndex","number","int","nonnegative","endIndex","positive","destinationIndex","successBranchSchema","type","literal","spreadsheetTitle","string","spreadsheetUrl","sheetTitle","sheetUrl","sourceRange","movedCount","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","InvalidParams","spreadsheetData","sheet","sheets","version","auth","authContext","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","properties","title","find","s","String","sheetId","sheetGid","batchUpdate","requestBody","requests","moveDimension","source","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","toLowerCase","stack","undefined","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/index.d.ts

@@ -22,5 +22,6 @@ export { default as validationSet } from './validation-set.js';
 export { default as valuesBatchUpdate } from './values-batch-update.js';
 export { default as valuesClear } from './values-clear.js';
 export { default as valuesCsvUpdate } from './values-csv-update.js';
+export { default as valuesMarkdownUpdate } from './values-markdown-update.js';
 export { default as valuesReplace } from './values-replace.js';
 export { default as valuesSearch } from './values-search.js';

package/dist/esm/mcp/tools/index.js

@@ -22,5 +22,6 @@ export { default as validationSet } from './validation-set.js';
 export { default as valuesBatchUpdate } from './values-batch-update.js';
 export { default as valuesClear } from './values-clear.js';
 export { default as valuesCsvUpdate } from './values-csv-update.js';
+export { default as valuesMarkdownUpdate } from './values-markdown-update.js';
 export { default as valuesReplace } from './values-replace.js';
 export { default as valuesSearch } from './values-search.js';

package/dist/esm/mcp/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/tools/index.ts"],"sourcesContent":["export { default as cellsFormat } from './cells-format.ts';\nexport { default as chartCreate } from './chart-create.ts';\nexport { default as columnsGet } from './columns-get.ts';\nexport { default as columnsUpdate } from './columns-update.ts';\nexport { default as csvGetColumns } from './csv-get-columns.ts';\nexport { default as dimensionsBatchUpdate } from './dimensions-batch-update.ts';\nexport { default as dimensionsMove } from './dimensions-move.ts';\nexport { default as rowsAppend } from './rows-append.ts';\nexport { default as rowsCsvAppend } from './rows-csv-append.ts';\nexport { default as rowsGet } from './rows-get.ts';\nexport { default as sheetCopy } from './sheet-copy.ts';\nexport { default as sheetCopyTo } from './sheet-copy-to.ts';\nexport { default as sheetCreate } from './sheet-create.ts';\nexport { default as sheetDelete } from './sheet-delete.ts';\nexport { default as sheetFind } from './sheet-find.ts';\nexport { default as sheetRename } from './sheet-rename.ts';\nexport { default as spreadsheetCopy } from './spreadsheet-copy.ts';\nexport { default as spreadsheetCreate } from './spreadsheet-create.ts';\nexport { default as spreadsheetFind } from './spreadsheet-find.ts';\nexport { default as spreadsheetRename } from './spreadsheet-rename.ts';\nexport { default as validationSet } from './validation-set.ts';\nexport { default as valuesBatchUpdate } from './values-batch-update.ts';\nexport { default as valuesClear } from './values-clear.ts';\nexport { default as valuesCsvUpdate } from './values-csv-update.ts';\nexport { default as valuesReplace } from './values-replace.ts';\nexport { default as valuesSearch } from './values-search.ts';\n"],"names":["default","cellsFormat","chartCreate","columnsGet","columnsUpdate","csvGetColumns","dimensionsBatchUpdate","dimensionsMove","rowsAppend","rowsCsvAppend","rowsGet","sheetCopy","sheetCopyTo","sheetCreate","sheetDelete","sheetFind","sheetRename","spreadsheetCopy","spreadsheetCreate","spreadsheetFind","spreadsheetRename","validationSet","valuesBatchUpdate","valuesClear","valuesCsvUpdate","valuesReplace","valuesSearch"],"mappings":"AAAA,SAASA,WAAWC,WAAW,QAAQ,oBAAoB;AAC3D,SAASD,WAAWE,WAAW,QAAQ,oBAAoB;AAC3D,SAASF,WAAWG,UAAU,QAAQ,mBAAmB;AACzD,SAASH,WAAWI,aAAa,QAAQ,sBAAsB;AAC/D,SAASJ,WAAWK,aAAa,QAAQ,uBAAuB;AAChE,SAASL,WAAWM,qBAAqB,QAAQ,+BAA+B;AAChF,SAASN,WAAWO,cAAc,QAAQ,uBAAuB;AACjE,SAASP,WAAWQ,UAAU,QAAQ,mBAAmB;AACzD,SAASR,WAAWS,aAAa,QAAQ,uBAAuB;AAChE,SAAST,WAAWU,OAAO,QAAQ,gBAAgB;AACnD,SAASV,WAAWW,SAAS,QAAQ,kBAAkB;AACvD,SAASX,WAAWY,WAAW,QAAQ,qBAAqB;AAC5D,SAASZ,WAAWa,WAAW,QAAQ,oBAAoB;AAC3D,SAASb,WAAWc,WAAW,QAAQ,oBAAoB;AAC3D,SAASd,WAAWe,SAAS,QAAQ,kBAAkB;AACvD,SAASf,WAAWgB,WAAW,QAAQ,oBAAoB;AAC3D,SAAShB,WAAWiB,eAAe,QAAQ,wBAAwB;AACnE,SAASjB,WAAWkB,iBAAiB,QAAQ,0BAA0B;AACvE,SAASlB,WAAWmB,eAAe,QAAQ,wBAAwB;AACnE,SAASnB,WAAWoB,iBAAiB,QAAQ,0BAA0B;AACvE,SAASpB,WAAWqB,aAAa,QAAQ,sBAAsB;AAC/D,SAASrB,WAAWsB,iBAAiB,QAAQ,2BAA2B;AACxE,SAAStB,WAAWuB,WAAW,QAAQ,oBAAoB;AAC3D,SAASvB,WAAWwB,eAAe,QAAQ,yBAAyB;AACpE,SAASxB,WAAWyB,aAAa,QAAQ,sBAAsB;AAC/D,SAASzB,WAAW0B,YAAY,QAAQ,qBAAqB"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/index.ts"],"sourcesContent":["export { default as cellsFormat } from './cells-format.ts';\nexport { default as chartCreate } from './chart-create.ts';\nexport { default as columnsGet } from './columns-get.ts';\nexport { default as columnsUpdate } from './columns-update.ts';\nexport { default as csvGetColumns } from './csv-get-columns.ts';\nexport { default as dimensionsBatchUpdate } from './dimensions-batch-update.ts';\nexport { default as dimensionsMove } from './dimensions-move.ts';\nexport { default as rowsAppend } from './rows-append.ts';\nexport { default as rowsCsvAppend } from './rows-csv-append.ts';\nexport { default as rowsGet } from './rows-get.ts';\nexport { default as sheetCopy } from './sheet-copy.ts';\nexport { default as sheetCopyTo } from './sheet-copy-to.ts';\nexport { default as sheetCreate } from './sheet-create.ts';\nexport { default as sheetDelete } from './sheet-delete.ts';\nexport { default as sheetFind } from './sheet-find.ts';\nexport { default as sheetRename } from './sheet-rename.ts';\nexport { default as spreadsheetCopy } from './spreadsheet-copy.ts';\nexport { default as spreadsheetCreate } from './spreadsheet-create.ts';\nexport { default as spreadsheetFind } from './spreadsheet-find.ts';\nexport { default as spreadsheetRename } from './spreadsheet-rename.ts';\nexport { default as validationSet } from './validation-set.ts';\nexport { default as valuesBatchUpdate } from './values-batch-update.ts';\nexport { default as valuesClear } from './values-clear.ts';\nexport { default as valuesCsvUpdate } from './values-csv-update.ts';\nexport { default as valuesMarkdownUpdate } from './values-markdown-update.ts';\nexport { default as valuesReplace } from './values-replace.ts';\nexport { default as valuesSearch } from './values-search.ts';\n"],"names":["default","cellsFormat","chartCreate","columnsGet","columnsUpdate","csvGetColumns","dimensionsBatchUpdate","dimensionsMove","rowsAppend","rowsCsvAppend","rowsGet","sheetCopy","sheetCopyTo","sheetCreate","sheetDelete","sheetFind","sheetRename","spreadsheetCopy","spreadsheetCreate","spreadsheetFind","spreadsheetRename","validationSet","valuesBatchUpdate","valuesClear","valuesCsvUpdate","valuesMarkdownUpdate","valuesReplace","valuesSearch"],"mappings":"AAAA,SAASA,WAAWC,WAAW,QAAQ,oBAAoB;AAC3D,SAASD,WAAWE,WAAW,QAAQ,oBAAoB;AAC3D,SAASF,WAAWG,UAAU,QAAQ,mBAAmB;AACzD,SAASH,WAAWI,aAAa,QAAQ,sBAAsB;AAC/D,SAASJ,WAAWK,aAAa,QAAQ,uBAAuB;AAChE,SAASL,WAAWM,qBAAqB,QAAQ,+BAA+B;AAChF,SAASN,WAAWO,cAAc,QAAQ,uBAAuB;AACjE,SAASP,WAAWQ,UAAU,QAAQ,mBAAmB;AACzD,SAASR,WAAWS,aAAa,QAAQ,uBAAuB;AAChE,SAAST,WAAWU,OAAO,QAAQ,gBAAgB;AACnD,SAASV,WAAWW,SAAS,QAAQ,kBAAkB;AACvD,SAASX,WAAWY,WAAW,QAAQ,qBAAqB;AAC5D,SAASZ,WAAWa,WAAW,QAAQ,oBAAoB;AAC3D,SAASb,WAAWc,WAAW,QAAQ,oBAAoB;AAC3D,SAASd,WAAWe,SAAS,QAAQ,kBAAkB;AACvD,SAASf,WAAWgB,WAAW,QAAQ,oBAAoB;AAC3D,SAAShB,WAAWiB,eAAe,QAAQ,wBAAwB;AACnE,SAASjB,WAAWkB,iBAAiB,QAAQ,0BAA0B;AACvE,SAASlB,WAAWmB,eAAe,QAAQ,wBAAwB;AACnE,SAASnB,WAAWoB,iBAAiB,QAAQ,0BAA0B;AACvE,SAASpB,WAAWqB,aAAa,QAAQ,sBAAsB;AAC/D,SAASrB,WAAWsB,iBAAiB,QAAQ,2BAA2B;AACxE,SAAStB,WAAWuB,WAAW,QAAQ,oBAAoB;AAC3D,SAASvB,WAAWwB,eAAe,QAAQ,yBAAyB;AACpE,SAASxB,WAAWyB,oBAAoB,QAAQ,8BAA8B;AAC9E,SAASzB,WAAW0B,aAAa,QAAQ,sBAAsB;AAC/D,SAAS1B,WAAW2B,YAAY,QAAQ,qBAAqB"}

package/dist/esm/mcp/tools/lib/dimension-operations.d.ts

@@ -16,7 +16,7 @@ export declare function sortOperations(requests: DimensionRequest[]): DimensionR
 export declare function buildDimensionRequest(operation: DimensionRequest, sheetId: number): {
     insertDimension: {
         range: {
-            endIndex: number;
+            endIndex?: number | undefined;
             sheetId: number;
             dimension: DimensionType;
             startIndex: number;
@@ -28,7 +28,7 @@ export declare function buildDimensionRequest(operation: DimensionRequest, sheet
 } | {
     deleteDimension: {
         range: {
-            endIndex: number;
+            endIndex?: number | undefined;
             sheetId: number;
             dimension: DimensionType;
             startIndex: number;

package/dist/esm/mcp/tools/lib/dimension-operations.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/tools/lib/dimension-operations.ts"],"sourcesContent":["// Google Sheets dimension constants\nexport const DEFAULT_APPEND_COUNT = 1; // Default number of rows/columns to append\nexport const DEFAULT_ROW_COUNT = 1000; // Google Sheets default for new sheets\nexport const DEFAULT_COLUMN_COUNT = 26; // Google Sheets default for new sheets (A-Z)\nexport const MAX_ROW_COUNT = 10000000; // Google Sheets maximum\nexport const MAX_COLUMN_COUNT = 18278; // Google Sheets maximum (ZZZ in base-26)\n\n// Type definitions for dimension operations\nexport type DimensionOperation = 'insertDimension' | 'deleteDimension' | 'appendDimension';\nexport type DimensionType = 'ROWS' | 'COLUMNS';\n\nexport interface DimensionRequest {\n  operation: DimensionOperation;\n  dimension: DimensionType;\n  startIndex: number;\n  endIndex?: number;\n  inheritFromBefore?: boolean;\n}\n\n// Helper function to sort operations for optimal execution order\nexport function sortOperations(requests: DimensionRequest[]): DimensionRequest[] {\n  // Sort by: 1) operation type (delete -> insert -> append), 2) proper index ordering to prevent conflicts\n  return [...requests].sort((a, b) => {\n    // Operation type priority: deleteDimension (0), insertDimension (1), appendDimension (2)\n    const operationPriority = {\n      deleteDimension: 0,\n      insertDimension: 1,\n      appendDimension: 2,\n    };\n\n    const aPriority = operationPriority[a.operation];\n    const bPriority = operationPriority[b.operation];\n\n    if (aPriority !== bPriority) {\n      return aPriority - bPriority;\n    }\n\n    // Within same operation type, sort by appropriate index\n    if (a.operation === 'deleteDimension') {\n      // For deletes, process higher START indices first to avoid index shifting issues\n      // This ensures we delete from the end towards the beginning\n      const aStart = a.startIndex;\n      const bStart = b.startIndex;\n      if (aStart !== bStart) {\n        return bStart - aStart; // Higher start index first\n      }\n      // If start indices are equal, process higher end index first for consistency\n      const aEnd = a.endIndex ?? a.startIndex + 1;\n      const bEnd = b.endIndex ?? b.startIndex + 1;\n      return bEnd - aEnd;\n    }\n    // For inserts and appends, process lower indices first\n    // This ensures we modify from the beginning towards the end\n    return a.startIndex - b.startIndex;\n  });\n}\n\n// Helper function to build Google Sheets API dimension request\nexport function buildDimensionRequest(operation: DimensionRequest, sheetId: number) {\n  const { operation: operationType, dimension, startIndex, endIndex, inheritFromBefore } = operation;\n\n  const dimensionRange = {\n    sheetId,\n    dimension,\n    startIndex,\n    ...(endIndex !== undefined && { endIndex }),\n  };\n\n  switch (operationType) {\n    case 'insertDimension':\n      return {\n        insertDimension: {\n          range: dimensionRange,\n          inheritFromBefore: inheritFromBefore ?? false,\n        },\n      };\n    case 'deleteDimension':\n      return {\n        deleteDimension: {\n          range: dimensionRange,\n        },\n      };\n    case 'appendDimension':\n      return {\n        appendDimension: {\n          sheetId,\n          dimension,\n          length: DEFAULT_APPEND_COUNT,\n        },\n      };\n    default:\n      throw new Error(`Unsupported operation type: ${operationType}`);\n  }\n}\n\n// Helper function to calculate affected count for each operation\nexport function calculateAffectedCount(operation: DimensionRequest): number {\n  const { operation: operationType, startIndex, endIndex } = operation;\n\n  switch (operationType) {\n    case 'insertDimension':\n    case 'deleteDimension':\n      return endIndex !== undefined ? endIndex - startIndex : 1;\n    case 'appendDimension':\n      return DEFAULT_APPEND_COUNT;\n    default:\n      return 0;\n  }\n}\n"],"names":["DEFAULT_APPEND_COUNT","DEFAULT_ROW_COUNT","DEFAULT_COLUMN_COUNT","MAX_ROW_COUNT","MAX_COLUMN_COUNT","sortOperations","requests","sort","a","b","operationPriority","deleteDimension","insertDimension","appendDimension","aPriority","operation","bPriority","aStart","startIndex","bStart","aEnd","endIndex","bEnd","buildDimensionRequest","sheetId","operationType","dimension","inheritFromBefore","dimensionRange","undefined","range","length","Error","calculateAffectedCount"],"mappings":"AAAA,oCAAoC;AACpC,OAAO,MAAMA,uBAAuB,EAAE,CAAC,2CAA2C;AAClF,OAAO,MAAMC,oBAAoB,KAAK,CAAC,uCAAuC;AAC9E,OAAO,MAAMC,uBAAuB,GAAG,CAAC,6CAA6C;AACrF,OAAO,MAAMC,gBAAgB,SAAS,CAAC,wBAAwB;AAC/D,OAAO,MAAMC,mBAAmB,MAAM,CAAC,yCAAyC;AAchF,iEAAiE;AACjE,OAAO,SAASC,eAAeC,QAA4B;IACzD,yGAAyG;IACzG,OAAO;WAAIA;KAAS,CAACC,IAAI,CAAC,CAACC,GAAGC;QAC5B,yFAAyF;QACzF,MAAMC,oBAAoB;YACxBC,iBAAiB;YACjBC,iBAAiB;YACjBC,iBAAiB;QACnB;QAEA,MAAMC,YAAYJ,iBAAiB,CAACF,EAAEO,SAAS,CAAC;QAChD,MAAMC,YAAYN,iBAAiB,CAACD,EAAEM,SAAS,CAAC;QAEhD,IAAID,cAAcE,WAAW;YAC3B,OAAOF,YAAYE;QACrB;QAEA,wDAAwD;QACxD,IAAIR,EAAEO,SAAS,KAAK,mBAAmB;gBASxBP,aACAC;YATb,iFAAiF;YACjF,4DAA4D;YAC5D,MAAMQ,SAAST,EAAEU,UAAU;YAC3B,MAAMC,SAASV,EAAES,UAAU;YAC3B,IAAID,WAAWE,QAAQ;gBACrB,OAAOA,SAASF,QAAQ,2BAA2B;YACrD;YACA,6EAA6E;YAC7E,MAAMG,QAAOZ,cAAAA,EAAEa,QAAQ,cAAVb,yBAAAA,cAAcA,EAAEU,UAAU,GAAG;YAC1C,MAAMI,QAAOb,cAAAA,EAAEY,QAAQ,cAAVZ,yBAAAA,cAAcA,EAAES,UAAU,GAAG;YAC1C,OAAOI,OAAOF;QAChB;QACA,uDAAuD;QACvD,4DAA4D;QAC5D,OAAOZ,EAAEU,UAAU,GAAGT,EAAES,UAAU;IACpC;AACF;AAEA,+DAA+D;AAC/D,OAAO,SAASK,sBAAsBR,SAA2B,EAAES,OAAe;IAChF,MAAM,EAAET,WAAWU,aAAa,EAAEC,SAAS,EAAER,UAAU,EAAEG,QAAQ,EAAEM,iBAAiB,EAAE,GAAGZ;IAEzF,MAAMa,iBAAiB;QACrBJ;QACAE;QACAR;QACA,GAAIG,aAAaQ,aAAa;YAAER;QAAS,CAAC;IAC5C;IAEA,OAAQI;QACN,KAAK;YACH,OAAO;gBACLb,iBAAiB;oBACfkB,OAAOF;oBACPD,iBAAiB,EAAEA,8BAAAA,+BAAAA,oBAAqB;gBAC1C;YACF;QACF,KAAK;YACH,OAAO;gBACLhB,iBAAiB;oBACfmB,OAAOF;gBACT;YACF;QACF,KAAK;YACH,OAAO;gBACLf,iBAAiB;oBACfW;oBACAE;oBACAK,QAAQ/B;gBACV;YACF;QACF;YACE,MAAM,IAAIgC,MAAM,CAAC,4BAA4B,EAAEP,eAAe;IAClE;AACF;AAEA,iEAAiE;AACjE,OAAO,SAASQ,uBAAuBlB,SAA2B;IAChE,MAAM,EAAEA,WAAWU,aAAa,EAAEP,UAAU,EAAEG,QAAQ,EAAE,GAAGN;IAE3D,OAAQU;QACN,KAAK;QACL,KAAK;YACH,OAAOJ,aAAaQ,YAAYR,WAAWH,aAAa;QAC1D,KAAK;YACH,OAAOlB;QACT;YACE,OAAO;IACX;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/lib/dimension-operations.ts"],"sourcesContent":["// Google Sheets dimension constants\nexport const DEFAULT_APPEND_COUNT = 1; // Default number of rows/columns to append\nexport const DEFAULT_ROW_COUNT = 1000; // Google Sheets default for new sheets\nexport const DEFAULT_COLUMN_COUNT = 26; // Google Sheets default for new sheets (A-Z)\nexport const MAX_ROW_COUNT = 10000000; // Google Sheets maximum\nexport const MAX_COLUMN_COUNT = 18278; // Google Sheets maximum (ZZZ in base-26)\n\n// Type definitions for dimension operations\nexport type DimensionOperation = 'insertDimension' | 'deleteDimension' | 'appendDimension';\nexport type DimensionType = 'ROWS' | 'COLUMNS';\n\nexport interface DimensionRequest {\n  operation: DimensionOperation;\n  dimension: DimensionType;\n  startIndex: number;\n  endIndex?: number;\n  inheritFromBefore?: boolean;\n}\n\n// Helper function to sort operations for optimal execution order\nexport function sortOperations(requests: DimensionRequest[]): DimensionRequest[] {\n  // Sort by: 1) operation type (delete -> insert -> append), 2) proper index ordering to prevent conflicts\n  return [...requests].sort((a, b) => {\n    // Operation type priority: deleteDimension (0), insertDimension (1), appendDimension (2)\n    const operationPriority = {\n      deleteDimension: 0,\n      insertDimension: 1,\n      appendDimension: 2,\n    };\n\n    const aPriority = operationPriority[a.operation];\n    const bPriority = operationPriority[b.operation];\n\n    if (aPriority !== bPriority) {\n      return aPriority - bPriority;\n    }\n\n    // Within same operation type, sort by appropriate index\n    if (a.operation === 'deleteDimension') {\n      // For deletes, process higher START indices first to avoid index shifting issues\n      // This ensures we delete from the end towards the beginning\n      const aStart = a.startIndex;\n      const bStart = b.startIndex;\n      if (aStart !== bStart) {\n        return bStart - aStart; // Higher start index first\n      }\n      // If start indices are equal, process higher end index first for consistency\n      const aEnd = a.endIndex ?? a.startIndex + 1;\n      const bEnd = b.endIndex ?? b.startIndex + 1;\n      return bEnd - aEnd;\n    }\n    // For inserts and appends, process lower indices first\n    // This ensures we modify from the beginning towards the end\n    return a.startIndex - b.startIndex;\n  });\n}\n\n// Helper function to build Google Sheets API dimension request\nexport function buildDimensionRequest(operation: DimensionRequest, sheetId: number) {\n  const { operation: operationType, dimension, startIndex, endIndex, inheritFromBefore } = operation;\n\n  const dimensionRange = {\n    sheetId,\n    dimension,\n    startIndex,\n    ...(endIndex !== undefined && { endIndex }),\n  };\n\n  switch (operationType) {\n    case 'insertDimension':\n      return {\n        insertDimension: {\n          range: dimensionRange,\n          inheritFromBefore: inheritFromBefore ?? false,\n        },\n      };\n    case 'deleteDimension':\n      return {\n        deleteDimension: {\n          range: dimensionRange,\n        },\n      };\n    case 'appendDimension':\n      return {\n        appendDimension: {\n          sheetId,\n          dimension,\n          length: DEFAULT_APPEND_COUNT,\n        },\n      };\n    default:\n      throw new Error(`Unsupported operation type: ${operationType}`);\n  }\n}\n\n// Helper function to calculate affected count for each operation\nexport function calculateAffectedCount(operation: DimensionRequest): number {\n  const { operation: operationType, startIndex, endIndex } = operation;\n\n  switch (operationType) {\n    case 'insertDimension':\n    case 'deleteDimension':\n      return endIndex !== undefined ? endIndex - startIndex : 1;\n    case 'appendDimension':\n      return DEFAULT_APPEND_COUNT;\n    default:\n      return 0;\n  }\n}\n"],"names":["DEFAULT_APPEND_COUNT","DEFAULT_ROW_COUNT","DEFAULT_COLUMN_COUNT","MAX_ROW_COUNT","MAX_COLUMN_COUNT","sortOperations","requests","sort","a","b","operationPriority","deleteDimension","insertDimension","appendDimension","aPriority","operation","bPriority","aStart","startIndex","bStart","aEnd","endIndex","bEnd","buildDimensionRequest","sheetId","operationType","dimension","inheritFromBefore","dimensionRange","undefined","range","length","Error","calculateAffectedCount"],"mappings":"AAAA,oCAAoC;AACpC,OAAO,MAAMA,uBAAuB,EAAE,CAAC,2CAA2C;AAClF,OAAO,MAAMC,oBAAoB,KAAK,CAAC,uCAAuC;AAC9E,OAAO,MAAMC,uBAAuB,GAAG,CAAC,6CAA6C;AACrF,OAAO,MAAMC,gBAAgB,SAAS,CAAC,wBAAwB;AAC/D,OAAO,MAAMC,mBAAmB,MAAM,CAAC,yCAAyC;AAchF,iEAAiE;AACjE,OAAO,SAASC,eAAeC,QAA4B;IACzD,yGAAyG;IACzG,OAAO;WAAIA;KAAS,CAACC,IAAI,CAAC,CAACC,GAAGC;QAC5B,yFAAyF;QACzF,MAAMC,oBAAoB;YACxBC,iBAAiB;YACjBC,iBAAiB;YACjBC,iBAAiB;QACnB;QAEA,MAAMC,YAAYJ,iBAAiB,CAACF,EAAEO,SAAS,CAAC;QAChD,MAAMC,YAAYN,iBAAiB,CAACD,EAAEM,SAAS,CAAC;QAEhD,IAAID,cAAcE,WAAW;YAC3B,OAAOF,YAAYE;QACrB;QAEA,wDAAwD;QACxD,IAAIR,EAAEO,SAAS,KAAK,mBAAmB;gBASxBP,aACAC;YATb,iFAAiF;YACjF,4DAA4D;YAC5D,MAAMQ,SAAST,EAAEU,UAAU;YAC3B,MAAMC,SAASV,EAAES,UAAU;YAC3B,IAAID,WAAWE,QAAQ;gBACrB,OAAOA,SAASF,QAAQ,2BAA2B;YACrD;YACA,6EAA6E;YAC7E,MAAMG,QAAOZ,cAAAA,EAAEa,QAAQ,cAAVb,yBAAAA,cAAcA,EAAEU,UAAU,GAAG;YAC1C,MAAMI,QAAOb,cAAAA,EAAEY,QAAQ,cAAVZ,yBAAAA,cAAcA,EAAES,UAAU,GAAG;YAC1C,OAAOI,OAAOF;QAChB;QACA,uDAAuD;QACvD,4DAA4D;QAC5D,OAAOZ,EAAEU,UAAU,GAAGT,EAAES,UAAU;IACpC;AACF;AAEA,+DAA+D;AAC/D,OAAO,SAASK,sBAAsBR,SAA2B,EAAES,OAAe;IAChF,MAAM,EAAET,WAAWU,aAAa,EAAEC,SAAS,EAAER,UAAU,EAAEG,QAAQ,EAAEM,iBAAiB,EAAE,GAAGZ;IAEzF,MAAMa,iBAAiB;QACrBJ;QACAE;QACAR;QACA,GAAIG,aAAaQ,aAAa;YAAER;QAAS,CAAC;IAC5C;IAEA,OAAQI;QACN,KAAK;YACH,OAAO;gBACLb,iBAAiB;oBACfkB,OAAOF;oBACPD,iBAAiB,EAAEA,8BAAAA,+BAAAA,oBAAqB;gBAC1C;YACF;QACF,KAAK;YACH,OAAO;gBACLhB,iBAAiB;oBACfmB,OAAOF;gBACT;YACF;QACF,KAAK;YACH,OAAO;gBACLf,iBAAiB;oBACfW;oBACAE;oBACAK,QAAQ/B;gBACV;YACF;QACF;YACE,MAAM,IAAIgC,MAAM,CAAC,4BAA4B,EAAEP,eAAe;IAClE;AACF;AAEA,iEAAiE;AACjE,OAAO,SAASQ,uBAAuBlB,SAA2B;IAChE,MAAM,EAAEA,WAAWU,aAAa,EAAEP,UAAU,EAAEG,QAAQ,EAAE,GAAGN;IAE3D,OAAQU;QACN,KAAK;QACL,KAAK;YACH,OAAOJ,aAAaQ,YAAYR,WAAWH,aAAa;QAC1D,KAAK;YACH,OAAOlB;QACT;YACE,OAAO;IACX;AACF"}

package/dist/esm/mcp/tools/rows-append.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/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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"}
+{"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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"}

package/dist/esm/mcp/tools/rows-csv-append.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/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":"AAAA,sFAAsF,GAGtF,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAIrC,SAASE,SAAS,EAAEC,QAAQ,QAAQ,qCAAqC;AACzE,SAASC,KAAK,QAAQ,YAAY;AAClC,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,cAAc,EAAEC,cAAc,EAAEC,mBAAmB,EAAEC,mBAAmB,QAAQ,yBAAyB;AAClH,SAASC,gBAAgB,QAAQ,qCAAqC;AACtE,SAASC,qBAAqB,QAAQ,2CAA2C;AACjF,SAASC,mBAAmB,QAAQ,wCAAwC;AAE5E,sFAAsF;AACtF,MAAMC,sBAAsBR,EAAES,MAAM,CAAC;IACnCC,QAAQV,EAAEW,KAAK,CAAC;QAACX,EAAEY,MAAM;QAAIZ,EAAEa,MAAM,GAAGC,GAAG,GAAGC,GAAG,CAAC;KAAG,EAAEC,QAAQ,CAAC;IAChEC,QAAQjB,EAAEW,KAAK,CAAC;QAACX,EAAEY,MAAM;QAAIZ,EAAEa,MAAM,GAAGC,GAAG,GAAGC,GAAG,CAAC;KAAG,EAAEC,QAAQ,CAAC;AAClE;AAEA,MAAME,cAAclB,EAAES,MAAM,CAAC;IAC3BU,IAAIf;IACJgB,KAAKlB;IACLmB,WAAWrB,EAAEY,MAAM,GAAGU,IAAI,GAAGP,GAAG,CAAC,GAAGC,QAAQ,CAAC;IAC7CO,kBAAkBvB,EAAEwB,OAAO,GAAGC,OAAO,CAAC,MAAMT,QAAQ,CAAC;IACrDU,WAAW1B,EAAE2B,KAAK,CAACnB,qBAAqBQ,QAAQ,CAAC;IACjDY,eAAe5B,EACZ2B,KAAK,CAAC3B,EAAEW,KAAK,CAAC;QAACX,EAAEY,MAAM;QAAIZ,EAAEa,MAAM,GAAGC,GAAG,GAAGC,GAAG,CAAC;KAAG,GACnDc,QAAQ,GACRb,QAAQ,CAAC;AACd;AAEA,MAAMc,sBAAsB9B,EAAES,MAAM,CAAC;IACnCsB,MAAM/B,EAAEgC,OAAO,CAAC;IAChBb,IAAIhB;IACJiB,KAAKnB;IACLgC,YAAYjC,EAAEY,MAAM,GAAGI,QAAQ,CAAC;IAChCkB,aAAalC,EAAEa,MAAM,GAAGG,QAAQ,CAAC;IACjCmB,aAAanC,EAAEa,MAAM,GAAGgB,QAAQ,GAAGb,QAAQ,CAAC;IAC5CoB,UAAUpC,EAAEY,MAAM,GAAGiB,QAAQ,GAAGb,QAAQ,CAAC;AAC3C;AAEA,MAAMqB,eAAerC,EAAEsC,kBAAkB,CAAC,QAAQ;IAACR;IAAqBnC;CAAyB;AAEjG,MAAM4C,SAAS;IACbC,aAAa;IACbtB;IACAmB,cAAcrC,EAAES,MAAM,CAAC;QACrBgC,QAAQJ;IACV;AACF;AAKA,4FAA4F,GAC5F,MAAMK,aAAa;AAEnB;;;;;;CAMC,GACD,SAASC,uBAAuBC,GAAoB,EAAEC,OAAwB,EAAEtB,gBAAyB,EAAEuB,OAAe;IACxH,2CAA2C;IAC3C,IAAI,OAAOF,QAAQ,UAAU;QAC3B,IAAIA,MAAM,GAAG;YACX,MAAM,IAAIG,MAAM,GAAGD,QAAQ,iCAAiC,EAAEF,KAAK;QACrE;QACA,OAAOA;IACT;IAEA,iCAAiC;IACjC,IAAI,CAACrB,oBAAoB,CAACsB,SAAS;QACjC,MAAM,IAAIE,MAAM,GAAGD,QAAQ,2BAA2B,EAAEF,IAAI,gFAAgF,CAAC;IAC/I;IAEA,MAAMI,QAAQH,QAAQI,OAAO,CAACL;IAC9B,IAAII,UAAU,CAAC,GAAG;QAChB,MAAM,IAAID,MAAM,GAAGD,QAAQ,UAAU,EAAEF,IAAI,gBAAgB,EAAEC,QAAQK,IAAI,CAAC,MAAM,CAAC,CAAC;IACpF;IAEA,OAAOF;AACT;AAEA,eAAeG,QAAQ,EAAEhC,EAAE,EAAEC,GAAG,EAAEC,SAAS,EAAEE,gBAAgB,EAAEG,SAAS,EAAEE,aAAa,EAAS,EAAEwB,KAAoB;IACpH,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,iCAAiC;QAAEnC;QAAIC;QAAKC;QAAWE;QAAkBG;QAAWE;IAAc;IAE9G,IAAI;;YAgCY2B,kCAMKC;QArCnB,IAAI9B,UAAU+B,MAAM,KAAK,GAAG;YAC1B,MAAM,IAAI5D,SAASD,UAAU8D,aAAa,EAAE;QAC9C;QAEA,sEAAsE;QACtE,IAAI,CAACnC,kBAAkB;YACrB,KAAK,MAAM,EAAEb,MAAM,EAAEO,MAAM,EAAE,IAAIS,UAAW;gBAC1C,IAAI,OAAOhB,WAAW,UAAU;oBAC9B,MAAM,IAAIb,SAASD,UAAU8D,aAAa,EAAE,CAAC,qEAAqE,EAAEhD,OAAO,CAAC,CAAC;gBAC/H;gBACA,IAAI,OAAOO,WAAW,UAAU;oBAC9B,MAAM,IAAIpB,SAASD,UAAU8D,aAAa,EAAE,CAAC,qEAAqE,EAAEzC,OAAO,CAAC,CAAC;gBAC/H;YACF;YACA,IAAIW,eAAe;gBACjB,KAAK,MAAM+B,UAAU/B,cAAe;oBAClC,IAAI,OAAO+B,WAAW,UAAU;wBAC9B,MAAM,IAAI9D,SAASD,UAAU8D,aAAa,EAAE,CAAC,+EAA+E,EAAEC,OAAO,CAAC,CAAC;oBACzI;gBACF;YACF;QACF;QAEA,MAAMC,SAAS7D,OAAO6D,MAAM,CAAC;YAAEC,SAAS;YAAMC,MAAMV,MAAMW,WAAW,CAACD,IAAI;QAAC;QAE3E,kCAAkC;QAClC,MAAMP,sBAAsB,MAAMK,OAAOI,YAAY,CAACC,GAAG,CAAC;YACxDC,eAAe/C;YACfgD,QAAQ;QACV;QAEA,MAAMX,SAAQD,mCAAAA,oBAAoBa,IAAI,CAACR,MAAM,cAA/BL,uDAAAA,iCAAiCc,IAAI,CAAC,CAACC;gBAAaA;mBAAPC,QAAOD,gBAAAA,EAAEE,UAAU,cAAZF,oCAAAA,cAAcG,OAAO,MAAMrD;;QAE7F,IAAI,CAACoC,OAAO;YACV,MAAM,IAAI3D,SAASD,UAAU8D,aAAa,EAAE;QAC9C;QAEA,MAAMzB,qBAAauB,kBAAAA,6BAAAA,oBAAAA,MAAOgB,UAAU,cAAjBhB,wCAAAA,kBAAmBkB,KAAK,uCAAI;QAE/C,oGAAoG;QACpG,IAAIC,eAAgC;QACpC,IAAIC,iBAA8B,IAAIC;QACtC,MAAMC,aAAkClD,iBAAiB,EAAE;QAE3D,IAAIL,kBAAkB;YACpB,6CAA6C;YAC7C,MAAMwD,oBAAoBrD,UAAUsD,GAAG,CAAC,CAAC,EAAE/D,MAAM,EAAE,GAAKA,QAAQgE,MAAM,CAAC,CAACC,IAAM,OAAOA,MAAM;YAE3F,mEAAmE;YACnE,MAAMC,eAAe,MAAM5E,oBAAoBqD,QAAQ;gBACrDM,eAAe/C;gBACfc;gBACAmD,gBAAgBL,kBAAkBtB,MAAM,GAAG,IAAIsB,oBAAoB;gBACnED,YAAYA,WAAWG,MAAM,CAAC,CAACI,IAAM,OAAOA,MAAM;gBAClDhC;YACF;YAEAsB,eAAeQ,aAAaG,MAAM;YAClCV,iBAAiBO,aAAaI,MAAM;QACtC,OAAO;YACL,2EAA2E;YAC3E,IAAI3D,iBAAiBA,cAAc6B,MAAM,GAAG,GAAG;gBAC7C,8DAA8D;gBAC9D,MAAM+B,aAAa;gBACnB,IAAIC,WAAW;gBACf,IAAIC,UAAU;gBAEd,MAAOA,QAAS;oBACd,MAAMC,SAASF,WAAWD,aAAa;oBACvC,MAAMI,aAAa,GAAG3D,WAAW,EAAE,EAAEwD,SAAS,IAAI,EAAEE,QAAQ;oBAE5D,MAAME,WAAW,MAAMjC,OAAOI,YAAY,CAAC8B,MAAM,CAAC7B,GAAG,CAAC;wBACpDC,eAAe/C;wBACf4E,OAAOH;oBACT;oBAEA,MAAMI,OAAOH,SAASzB,IAAI,CAAC0B,MAAM,IAAI,EAAE;oBAEvC,KAAK,MAAMG,OAAOD,KAAM;wBACtB,MAAME,MAAM5F,sBAAsB2F,KAAKnB,YAAY,MAAM;wBACzD,IAAIoB,IAAIC,OAAO,CAAC,OAAO,QAAQ,IAAI;4BACjCvB,eAAewB,GAAG,CAACF;wBACrB;oBACF;oBAEA,uCAAuC;oBACvC,IAAIF,KAAKvC,MAAM,GAAG+B,YAAY;wBAC5BE,UAAU;oBACZ,OAAO;wBACLD,YAAYD;oBACd;gBACF;gBAEAnC,OAAOC,IAAI,CAAC,+CAA+C;oBAAE+C,UAAUzB,eAAe0B,IAAI;gBAAC;YAC7F;QACF;QAEA,iCAAiC;QACjC,IAAIC,gBAAiC;QACrC,IAAIC,QAAgD,EAAE;QACtD,IAAIC,YAAY;QAChB,IAAItE,cAAc;QAElB,oDAAoD;QACpD,MAAMuE,aAAa,MAAMrG,iBAAiBgB;QAE1C,oBAAoB;QACpB,MAAMsF,SAASD,WAAWE,IAAI,CAC5B9G,MAAM;YACJ+G,SAAS,CAAC,CAACtF;YACXuF,kBAAkB;YAClBxF,MAAM;YACNyF,MAAM;YACNC,oBAAoB;QACtB;QAGF,mCAAmC;QACnC,MAAMC,cAAc,OAAOjB;YACzB,IAAIA,KAAKvC,MAAM,KAAK,GAAG;YAEvB,MAAMG,OAAOI,YAAY,CAAC8B,MAAM,CAACoB,MAAM,CAAC;gBACtChD,eAAe/C;gBACf4E,OAAO,GAAG9D,WAAW,IAAI,CAAC;gBAC1BkF,kBAAkB;gBAClBC,aAAa;oBAAEtB,QAAQE;oBAAMqB,gBAAgB;gBAAO;YACtD;YAEAhE,OAAOC,IAAI,CAAC,yCAAyC;gBAAEgE,WAAWtB,KAAKvC,MAAM;gBAAEgD;YAAU;QAC3F;QAEA,8EAA8E;QAC9E,IAAIc,cAA+D,EAAE;QAErE,6BAA6B;QAC7B,WAAW,MAAMC,UAAUb,OAAQ;YACjC,IAAIpF,kBAAkB;gBACpB,2CAA2C;gBAC3C,IAAIgF,kBAAkB,MAAM;oBAC1BA,gBAAgBkB,OAAOC,IAAI,CAACF;oBAC5BnE,OAAOC,IAAI,CAAC,yCAAyC;wBAAEiD;oBAAc;oBAErE,mEAAmE;oBACnEgB,cAAc7F,UAAUsD,GAAG,CAAC,CAAC,EAAEtE,MAAM,EAAEO,MAAM,EAAE,GAAM,CAAA;4BACnD0G,WAAWhF,uBAAuBjC,QAAQ6F,eAAehF,kBAAkB;4BAC3EqG,WAAWjF,uBAAuB1B,QAAQ0D,cAAcpD,kBAAkB;wBAC5E,CAAA;gBACF;gBAEA,iCAAiC;gBACjC,MAAMsG,YAAYtB,0BAAAA,oCAAAA,cAAevB,GAAG,CAAC,CAAC8C;wBAAM;4BAAA,YAAA,AAACN,MAAkC,CAACM,EAAE,cAAtC,uBAAA,YAA0C;;gBACtF,MAAMC,eAAeC,KAAKC,GAAG,IAAIV,YAAYvC,GAAG,CAAC,CAACkD,IAAMA,EAAEN,SAAS;gBACnE,MAAMO,WAAW,IAAIC,MAAML,eAAe,GAAGM,IAAI,CAAC;gBAElD,KAAK,MAAM,EAAEV,SAAS,EAAEC,SAAS,EAAE,IAAIL,YAAa;oBAClD,IAAIM,WAAW;4BACSA;wBAAtBM,QAAQ,CAACP,UAAU,IAAGC,uBAAAA,SAAS,CAACF,UAAU,cAApBE,kCAAAA,uBAAwB;oBAChD;gBACF;gBAEA,sBAAsB;gBACtB,IAAIjG,iBAAiBA,cAAc6B,MAAM,GAAG,GAAG;oBAC7C,MAAMyC,MAAM5F,sBAAsB6H,UAAUrD,YAAYH,cAAcpD;oBACtE,IAAIqD,eAAe0D,GAAG,CAACpC,MAAM;wBAC3B/D;wBACA,UAAU,iBAAiB;oBAC7B;oBACAyC,eAAewB,GAAG,CAACF,MAAM,sCAAsC;gBACjE;gBAEA,eAAe;gBACfM,MAAM+B,IAAI,CAACJ;gBACX1B;YACF,OAAO;gBACL,6DAA6D;gBAC7D,2BAA2B;gBAC3B,IAAIc,YAAY9D,MAAM,KAAK,GAAG;oBAC5B8D,cAAc7F,UAAUsD,GAAG,CAAC,CAAC,EAAEtE,MAAM,EAAEO,MAAM,EAAE,GAAM,CAAA;4BACnD0G,WAAWhF,uBAAuBjC,QAAQ,MAAMa,kBAAkB;4BAClEqG,WAAWjF,uBAAuB1B,QAAQ,MAAMM,kBAAkB;wBACpE,CAAA;gBACF;gBAEA,MAAMsG,YAAYL;gBAClB,MAAMO,eAAeC,KAAKC,GAAG,IAAIV,YAAYvC,GAAG,CAAC,CAACkD,IAAMA,EAAEN,SAAS;gBACnE,MAAMO,WAAW,IAAIC,MAAML,eAAe,GAAGM,IAAI,CAAC;gBAElD,KAAK,MAAM,EAAEV,SAAS,EAAEC,SAAS,EAAE,IAAIL,YAAa;oBAClD,IAAII,YAAYE,UAAUpE,MAAM,EAAE;4BACVoE;wBAAtBM,QAAQ,CAACP,UAAU,IAAGC,wBAAAA,SAAS,CAACF,UAAU,cAApBE,mCAAAA,wBAAwB;oBAChD;gBACF;gBAEA,sBAAsB;gBACtB,IAAIjG,iBAAiBA,cAAc6B,MAAM,GAAG,GAAG;oBAC7C,MAAMyC,MAAM5F,sBAAsB6H,UAAUrD,YAAY,MAAMvD;oBAC9D,IAAIqD,eAAe0D,GAAG,CAACpC,MAAM;wBAC3B/D;wBACA,UAAU,iBAAiB;oBAC7B;oBACAyC,eAAewB,GAAG,CAACF;gBACrB;gBAEA,eAAe;gBACfM,MAAM+B,IAAI,CAACJ;gBACX1B;YACF;YAEA,yBAAyB;YACzB,IAAID,MAAM/C,MAAM,IAAIf,YAAY;gBAC9B,MAAMuE,YAAYT;gBAClBA,QAAQ,EAAE,EAAE,cAAc;YAC5B;QACF;QAEA,uBAAuB;QACvB,IAAIA,MAAM/C,MAAM,GAAG,GAAG;YACpB,MAAMwD,YAAYT;QACpB;QAEAnD,OAAOC,IAAI,CAAC,6CAA6C;YAAEmD;YAAWtE;QAAY;QAElF,MAAMD,cAAcuE;QAEpBpD,OAAOC,IAAI,CAAC,oCAAoC;YAAEnC;YAAIC;YAAKc;YAAaC;YAAad;QAAU;QAE/F,MAAMoB,SAAiB;YACrBV,MAAM;YACNZ;YACAC;YACAa;YACAC;YACAC;YACAC,UAAU,CAAC,uCAAuC,EAAEjB,GAAG,UAAU,EAAEC,KAAK;QAC1E;QAEA,OAAO;YACLoH,SAAS;gBAAC;oBAAEzG,MAAM;oBAAiB0G,MAAMC,KAAKC,SAAS,CAAClG;gBAAQ;aAAE;YAClEmG,mBAAmB;gBAAEnG;YAAO;QAC9B;IACF,EAAE,OAAOoG,OAAO;QACd,MAAMC,UAAUD,iBAAiB9F,QAAQ8F,MAAMC,OAAO,GAAGvE,OAAOsE;QAChExF,OAAOwF,KAAK,CAAC,gCAAgC;YAAEA,OAAOC;QAAQ;QAE9D,MAAM,IAAIjJ,SAASD,UAAUmJ,aAAa,EAAE,CAAC,0BAA0B,EAAED,SAAS,EAAE;YAClFE,OAAOH,iBAAiB9F,QAAQ8F,MAAMG,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACN5G;QACAY;IACF;AACF"}
+{"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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"}

package/dist/esm/mcp/tools/rows-get.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/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":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAIrC,SAASE,SAAS,EAAEC,QAAQ,QAAQ,qCAAqC;AACzE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,eAAe,EAAEC,cAAc,EAAEC,mBAAmB,QAAQ,yBAAyB;AAE9F,MAAMC,cAAcJ,EAAEK,MAAM,CAAC;IAC3BC,IAAIH;IACJI,KAAKL;IACLM,OAAOR,EAAES,MAAM,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;IAClCC,QAAQZ,EAAEa,IAAI,CAAC;QAAC;QAAmB;QAAqB;KAAU,EAAEC,QAAQ,GAAGH,QAAQ,CAAC;AAC1F;AAEA,8EAA8E;AAC9E,MAAMI,sBAAsBf,EAAEK,MAAM,CAAC;IACnCW,MAAMhB,EAAEiB,OAAO,CAAC;IAChBT,OAAOR,EAAES,MAAM,GAAGE,QAAQ,CAAC;IAC3BO,MAAMlB,EAAEmB,KAAK,CAACnB,EAAEmB,KAAK,CAAClB,kBAAkBU,QAAQ,CAAC;AACnD;AAEA,2CAA2C;AAC3C,MAAMS,eAAepB,EAAEqB,kBAAkB,CAAC,QAAQ;IAACN;IAAqBnB;CAAyB;AAEjG,MAAM0B,SAAS;IACbC,aAAa;IACbnB;IACAgB,cAAcpB,EAAEK,MAAM,CAAC;QACrBmB,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAEnB,EAAE,EAAEC,GAAG,EAAEC,KAAK,EAAEI,MAAM,EAAS,EAAEc,KAAoB;IAC5E,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,0BAA0B;QAAEtB;QAAIC;QAAKC;QAAOI;IAAO;IAE/D,IAAI;;YASYiB,kCAOKC;QAfnB,MAAMC,SAAShC,OAAOgC,MAAM,CAAC;YAAEC,SAAS;YAAMC,MAAMP,MAAMQ,WAAW,CAACD,IAAI;QAAC;QAE3E,qDAAqD;QACrD,MAAMJ,sBAAsB,MAAME,OAAOI,YAAY,CAACC,GAAG,CAAC;YACxDC,eAAe/B;YACfgC,QAAQ;QACV;QAEA,MAAMR,SAAQD,mCAAAA,oBAAoBU,IAAI,CAACR,MAAM,cAA/BF,uDAAAA,iCAAiCW,IAAI,CAAC,CAACC;gBAAaA;mBAAPC,QAAOD,gBAAAA,EAAEE,UAAU,cAAZF,oCAAAA,cAAcG,OAAO,MAAMrC;;QAE7F,IAAI,CAACuB,OAAO;YACVH,OAAOC,IAAI,CAAC,mCAAmC;gBAAEtB;gBAAIC;gBAAKC;YAAM;YAChE,MAAM,IAAIV,SAASD,UAAUgD,aAAa,EAAE,CAAC,iBAAiB,EAAEtC,KAAK;QACvE;QAEA,MAAMuC,sBAAahB,oBAAAA,MAAMa,UAAU,cAAhBb,wCAAAA,kBAAkBiB,KAAK,uCAAI;QAE9C,wCAAwC;QACxC,MAAMC,YAAY,GAAGF,WAAW,CAAC,EAAEtC,OAAO;QAE1C,MAAMyC,WAAW,MAAMlB,OAAOI,YAAY,CAACe,MAAM,CAACd,GAAG,CAAC;YACpDC,eAAe/B;YACfE,OAAOwC;YACPG,mBAAmBvC,UAAU;QAC/B;QAEA,MAAMwC,MAAMH,SAASV,IAAI;QACzB,MAAMrB,OAAOmC,MAAMC,OAAO,CAACF,IAAIF,MAAM,IAAKE,IAAIF,MAAM,GAA8C,EAAE;QAEpGvB,OAAOC,IAAI,CAAC,2BAA2B;YAAEtB;YAAIC;YAAKC;YAAO+C,UAAUrC,KAAKsC,MAAM;QAAC;QAE/E,MAAMhC,SAAiB;YACrBR,MAAM;YACNR,OAAO4C,IAAI5C,KAAK,IAAIwC;YACpB9B;QACF;QAEA,OAAO;YACLuC,SAAS;gBAAC;oBAAEzC,MAAM;oBAAiB0C,MAAMC,KAAKC,SAAS,CAACpC;gBAAQ;aAAE;YAClEqC,mBAAmB;gBAAErC;YAAO;QAC9B;IACF,EAAE,OAAOsC,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGrB,OAAOoB;QAChEnC,OAAOmC,KAAK,CAAC,yBAAyB;YAAEA,OAAOC;QAAQ;QAEvD,+CAA+C;QAC/C,MAAM,IAAIjE,SAASD,UAAUoE,aAAa,EAAE,CAAC,oBAAoB,EAAEF,SAAS,EAAE;YAC5EG,OAAOJ,iBAAiBE,QAAQF,MAAMI,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACN/C;QACAG;IACF;AACF"}
+{"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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"}

package/dist/esm/mcp/tools/sheet-copy-to.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/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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"}
+{"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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"}

package/dist/esm/mcp/tools/sheet-copy.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/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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"}
+{"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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"}

package/dist/esm/mcp/tools/sheet-create.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/tools/sheet-create.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  sheetTitle: z.coerce.string().trim().min(1).describe('Name for the new sheet tab'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Summary of the sheet creation operation'),\n  itemsProcessed: z.number().describe('Total items attempted (always 1 for single sheet)'),\n  itemsChanged: z.number().describe('Successfully created sheets (always 1 on success)'),\n  completedAt: z.string().describe('ISO datetime when operation completed'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetUrl: z.string().describe('URL of the created sheet'),\n  sheetTitle: z.string().describe('Title of the created sheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Create a new sheet/tab in the spreadsheet/workbook',\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, sheetTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.create called', { id, sheetTitle });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n    const response = await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [{ addSheet: { properties: { title: sheetTitle } } }],\n      },\n    });\n    const batchResult = response.data;\n    const sheetId = batchResult.replies?.[0]?.addSheet?.properties?.sheetId;\n    if (!sheetId) {\n      throw new Error('Failed to retrieve sheetId from Google Sheets API response');\n    }\n    logger.info('sheets.sheet.create success', { id, sheetTitle, sheetId });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: `Created sheet \"${sheetTitle}\"`,\n      itemsProcessed: 1,\n      itemsChanged: 1,\n      completedAt: new Date().toISOString(),\n      id,\n      gid: String(sheetId),\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`,\n      sheetTitle,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.sheet.create error', { error: message });\n\n    // Throw McpError for proper MCP error handling\n    throw new McpError(ErrorCode.InternalError, `Error creating sheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-create',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SpreadsheetIdOutput","SpreadsheetIdSchema","inputSchema","object","id","sheetTitle","coerce","string","trim","min","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","gid","sheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","batchResult","sheets","version","auth","authContext","response","spreadsheets","batchUpdate","spreadsheetId","requestBody","requests","addSheet","properties","title","data","sheetId","replies","Error","Date","toISOString","String","content","text","JSON","stringify","structuredContent","error","message","InternalError","stack","undefined","createTool","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/sheet-create.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  sheetTitle: z.coerce.string().trim().min(1).describe('Name for the new sheet tab'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Summary of the sheet creation operation'),\n  itemsProcessed: z.number().describe('Total items attempted (always 1 for single sheet)'),\n  itemsChanged: z.number().describe('Successfully created sheets (always 1 on success)'),\n  completedAt: z.string().describe('ISO datetime when operation completed'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetUrl: z.string().describe('URL of the created sheet'),\n  sheetTitle: z.string().describe('Title of the created sheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Create a new sheet/tab in the spreadsheet/workbook',\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, sheetTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.create called', { id, sheetTitle });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n    const response = await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [{ addSheet: { properties: { title: sheetTitle } } }],\n      },\n    });\n    const batchResult = response.data;\n    const sheetId = batchResult.replies?.[0]?.addSheet?.properties?.sheetId;\n    if (!sheetId) {\n      throw new Error('Failed to retrieve sheetId from Google Sheets API response');\n    }\n    logger.info('sheets.sheet.create success', { id, sheetTitle, sheetId });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: `Created sheet \"${sheetTitle}\"`,\n      itemsProcessed: 1,\n      itemsChanged: 1,\n      completedAt: new Date().toISOString(),\n      id,\n      gid: String(sheetId),\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`,\n      sheetTitle,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.sheet.create error', { error: message });\n\n    // Throw McpError for proper MCP error handling\n    throw new McpError(ErrorCode.InternalError, `Error creating sheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-create',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SpreadsheetIdOutput","SpreadsheetIdSchema","inputSchema","object","id","sheetTitle","coerce","string","trim","min","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","gid","sheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","batchResult","sheets","version","auth","authContext","response","spreadsheets","batchUpdate","spreadsheetId","requestBody","requests","addSheet","properties","title","data","sheetId","replies","Error","Date","toISOString","String","content","text","JSON","stringify","structuredContent","error","message","InternalError","stack","undefined","createTool","name"],"mappings":"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"}