@mcp-z/mcp-sheets 1.0.7 → 1.1.0

package/dist/cjs/mcp/tools/values-csv-update.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/mcp/tools/values-csv-update.ts"],"sourcesContent":["/** Import CSV data to Google Sheets with range-based update (no 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 { A1NotationSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { getCsvReadStream } from '../../spreadsheet/csv-streaming.ts';\n\n/** Batch size for Sheets API calls (1000 rows × avg 10 cols = 10K cells, well under 40K limit) */\nconst BATCH_SIZE = 1000;\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  startRange: A1NotationSchema.default('A1').describe('Top-left cell where CSV data starts (default: A1)'),\n  valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How to interpret values (RAW = exact, USER_ENTERED = parse formulas/dates)'),\n  sourceHasHeaders: z.boolean().default(true).describe('First row is headers (metadata) - exclude from data range. Set to false to include first row as data.'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  spreadsheetTitle: z.string().describe('Spreadsheet title'),\n  spreadsheetUrl: z.string().describe('Spreadsheet URL'),\n  sheetTitle: z.string().describe('Sheet title'),\n  sheetUrl: z.string().describe('Sheet URL'),\n  updatedRange: z.string().describe('A1 notation range that was updated'),\n  updatedRows: z.number().describe('Number of rows updated'),\n  updatedColumns: z.number().describe('Number of columns updated'),\n  updatedCells: z.number().describe('Number of cells updated'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Import CSV to sheet range. Overwrites existing data at startRange. Use rows-csv-append for database-style appends with deduplication.',\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, sourceUri, startRange, valueInputOption = 'USER_ENTERED', sourceHasHeaders }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values.csv-update called', { id, gid, sourceUri, startRange, valueInputOption, sourceHasHeaders });\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\n    // Find the sheet by gid\n    const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? '';\n\n    // Streaming CSV processing state\n    let sourceHeaders: string[] = [];\n    const allRows: (string | number | boolean | null)[][] = [];\n    let totalCols = 0;\n\n    // Get readable stream from CSV URI (no temp files!)\n    const readStream = await getCsvReadStream(sourceUri);\n\n    // Create CSV parser with native streaming\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    // Stream and collect all rows (with batching for very large files)\n    for await (const record of parser) {\n      if (sourceHasHeaders) {\n        // Extract source headers from first record\n        if (sourceHeaders.length === 0) {\n          sourceHeaders = Object.keys(record as Record<string, unknown>);\n          totalCols = sourceHeaders.length;\n          logger.info('sheets.values.csv-update source headers', { sourceHeaders, totalCols });\n        }\n\n        // Convert record to row array (exclude source headers from data range)\n        // CSV values are strings/numbers/booleans/nulls from the parser\n        const row = sourceHeaders.map((header) => (record as Record<string, string | number | boolean | null>)[header] ?? null);\n        allRows.push(row);\n      } else {\n        // sourceHasHeaders=false: record is an array, include all rows (including first row)\n        const row = record as (string | number | boolean | null)[];\n        allRows.push(row);\n\n        if (totalCols === 0) {\n          totalCols = row.length;\n        }\n      }\n    }\n\n    if (allRows.length === 0) {\n      throw new McpError(ErrorCode.InvalidParams, 'CSV file is empty');\n    }\n\n    // Prepare data for update (all rows)\n    const dataToWrite: (string | number | boolean | null)[][] = allRows;\n\n    // For large datasets, use batchUpdate to write in chunks\n    // This respects the 40K cell limit per request\n    const batchRequests = [];\n    const currentRow = startRange.match(/[A-Z]+(\\d+)/)?.[1] || '1';\n    let currentRowNum = Number.parseInt(currentRow, 10);\n\n    for (let i = 0; i < dataToWrite.length; i += BATCH_SIZE) {\n      const batchData = dataToWrite.slice(i, i + BATCH_SIZE);\n      const batchRange = `${sheetTitle}!${startRange.match(/[A-Z]+/)?.[0]}${currentRowNum}`;\n\n      batchRequests.push({\n        range: batchRange,\n        values: batchData,\n      });\n\n      currentRowNum += batchData.length;\n    }\n\n    logger.info('sheets.values.csv-update batching', { totalBatches: batchRequests.length, batchSize: BATCH_SIZE });\n\n    // Execute batch update\n    const batchUpdateResponse = await sheets.spreadsheets.values.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        valueInputOption,\n        data: batchRequests,\n      },\n    });\n\n    const totalUpdatedCells = batchUpdateResponse.data.totalUpdatedCells || 0;\n    const totalUpdatedRows = batchUpdateResponse.data.totalUpdatedRows || 0;\n    const totalUpdatedColumns = batchUpdateResponse.data.totalUpdatedColumns || 0;\n    const firstUpdatedRange = batchUpdateResponse.data.responses?.[0]?.updatedRange || `${sheetTitle}!${startRange}`;\n\n    logger.info('sheets.values.csv-update completed', { id, gid: sheet.properties.sheetId, updatedRange: firstUpdatedRange, updatedRows: totalUpdatedRows, sourceUri });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheet.properties.sheetId ?? ''),\n      spreadsheetTitle: spreadsheetData.properties?.title ?? '',\n      spreadsheetUrl: spreadsheetData.spreadsheetUrl ?? `https://docs.google.com/spreadsheets/d/${id}`,\n      sheetTitle,\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheet.properties.sheetId}`,\n      updatedRange: firstUpdatedRange,\n      updatedRows: totalUpdatedRows,\n      updatedColumns: totalUpdatedColumns,\n      updatedCells: totalUpdatedCells,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.values.csv-update error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error updating values from CSV: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-csv-update',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","BATCH_SIZE","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","sourceUri","string","trim","min","describe","startRange","A1NotationSchema","default","valueInputOption","enum","sourceHasHeaders","boolean","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRange","updatedRows","number","updatedColumns","updatedCells","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","sheet","spreadsheetData","batchUpdateResponse","sheets","spreadsheetResponse","sourceHeaders","allRows","totalCols","readStream","parser","dataToWrite","batchRequests","currentRow","currentRowNum","i","batchData","batchRange","totalUpdatedCells","totalUpdatedRows","totalUpdatedColumns","firstUpdatedRange","error","message","info","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","McpError","ErrorCode","InvalidParams","title","getCsvReadStream","pipe","parse","columns","skip_empty_lines","cast","relax_column_count","record","length","Object","keys","row","map","header","push","match","Number","parseInt","slice","range","values","totalBatches","batchSize","batchUpdate","requestBody","responses","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","undefined","name"],"mappings":"AAAA,gFAAgF;;;;+BAiMhF;;;eAAwBA;;;2BA9LA;qBAMY;wBACd;0BACC;mBACL;uBACyF;8BAC1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AATjC,IAAM,AAAEC,2BAA6BC,oBAAO,CAApCD;AAWR,gGAAgG,GAChG,IAAME,aAAa;AAEnB,IAAMC,cAAcC,MAAC,CAACC,MAAM,CAAC;IAC3BC,IAAIC,4BAAmB;IACvBC,KAAKC,uBAAc;IACnBC,WAAWN,MAAC,CAACO,MAAM,GAAGC,IAAI,GAAGC,GAAG,CAAC,GAAGC,QAAQ,CAAC;IAC7CC,YAAYC,yBAAgB,CAACC,OAAO,CAAC,MAAMH,QAAQ,CAAC;IACpDI,kBAAkBd,MAAC,CAACe,IAAI,CAAC;QAAC;QAAO;KAAe,EAAEF,OAAO,CAAC,gBAAgBH,QAAQ,CAAC;IACnFM,kBAAkBhB,MAAC,CAACiB,OAAO,GAAGJ,OAAO,CAAC,MAAMH,QAAQ,CAAC;AACvD;AAEA,IAAMQ,sBAAsBlB,MAAC,CAACC,MAAM,CAAC;IACnCkB,MAAMnB,MAAC,CAACoB,OAAO,CAAC;IAChBlB,IAAImB,4BAAmB;IACvBjB,KAAKkB,uBAAc;IACnBC,kBAAkBvB,MAAC,CAACO,MAAM,GAAGG,QAAQ,CAAC;IACtCc,gBAAgBxB,MAAC,CAACO,MAAM,GAAGG,QAAQ,CAAC;IACpCe,YAAYzB,MAAC,CAACO,MAAM,GAAGG,QAAQ,CAAC;IAChCgB,UAAU1B,MAAC,CAACO,MAAM,GAAGG,QAAQ,CAAC;IAC9BiB,cAAc3B,MAAC,CAACO,MAAM,GAAGG,QAAQ,CAAC;IAClCkB,aAAa5B,MAAC,CAAC6B,MAAM,GAAGnB,QAAQ,CAAC;IACjCoB,gBAAgB9B,MAAC,CAAC6B,MAAM,GAAGnB,QAAQ,CAAC;IACpCqB,cAAc/B,MAAC,CAAC6B,MAAM,GAAGnB,QAAQ,CAAC;AACpC;AAEA,IAAMsB,eAAehC,MAAC,CAACiC,kBAAkB,CAAC,QAAQ;IAACf;IAAqBtB;CAAyB;AAEjG,IAAMsC,SAAS;IACbC,aAAa;IACbpC,aAAAA;IACAiC,cAAchC,MAAC,CAACC,MAAM,CAAC;QACrBmC,QAAQJ;IACV;AACF;AAKA,SAAeK;wCAAQ,KAA8F,EAAEC,KAAoB;YAAlHpC,IAAIE,KAAKE,WAAWK,qCAAYG,kBAAmCE,kBACpFuB,QAoBeC,yBA4FLA,iCAEIC,iCAnGJA,yBA6DK9B,mBA6BO+B,sCAAAA,qCAQND,6BA7GdE,QAGAC,qBAKAH,iBAGAD,OAKAf,YAGFoB,eACEC,SACFC,WAGEC,YAGAC,oGAwCAC,aAIAC,eACAC,YACFC,eAEKC,GAE6B3C,oBAD9B4C,WACAC,YAaFd,qBAQAe,mBACAC,kBACAC,qBACAC,mBAIAxB,QAkBCyB,OACDC;;;;oBAjIe5D,KAAF,MAAEA,IAAIE,MAAN,MAAMA,KAAKE,YAAX,MAAWA,WAAWK,aAAtB,MAAsBA,sCAAtB,MAAkCG,kBAAAA,wDAAmB,0CAAgBE,mBAArE,MAAqEA;oBACpFuB,SAASD,MAAMC,MAAM;oBAC3BA,OAAOwB,IAAI,CAAC,mCAAmC;wBAAE7D,IAAAA;wBAAIE,KAAAA;wBAAKE,WAAAA;wBAAWK,YAAAA;wBAAYG,kBAAAA;wBAAkBE,kBAAAA;oBAAiB;;;;;;;;;oBAG5G2B,SAASqB,kBAAM,CAACrB,MAAM,CAAC;wBAAEsB,SAAS;wBAAMC,MAAM5B,MAAM6B,WAAW,CAACD,IAAI;oBAAC;oBAG/C;;wBAAMvB,OAAOyB,YAAY,CAACC,GAAG,CAAC;4BACxDC,eAAepE;4BACfqE,QAAQ;wBACV;;;oBAHM3B,sBAAsB;oBAKtBH,kBAAkBG,oBAAoB4B,IAAI;oBAEhD,wBAAwB;oBAClBhC,SAAQC,0BAAAA,gBAAgBE,MAAM,cAAtBF,8CAAAA,wBAAwBgC,IAAI,CAAC,SAACC;4BAAaA;+BAAPC,QAAOD,gBAAAA,EAAEE,UAAU,cAAZF,oCAAAA,cAAcG,OAAO,MAAMzE;;oBACpF,IAAI,EAACoC,kBAAAA,4BAAAA,MAAOoC,UAAU,GAAE;wBACtB,MAAM,IAAIE,eAAQ,CAACC,gBAAS,CAACC,aAAa,EAAE,AAAC,oBAAuB,OAAJ5E;oBAClE;oBAEMqB,cAAae,0BAAAA,MAAMoC,UAAU,CAACK,KAAK,cAAtBzC,qCAAAA,0BAA0B;oBAE7C,iCAAiC;oBAC7BK;oBACEC;oBACFC,YAAY;oBAGG;;wBAAMmC,IAAAA,gCAAgB,EAAC5E;;;oBAApC0C,aAAa;oBAEnB,0CAA0C;oBACpCC,SAASD,WAAWmC,IAAI,CAC5BC,IAAAA,eAAK,EAAC;wBACJC,SAAS,CAAC,CAACrE;wBACXsE,kBAAkB;wBAClB9E,MAAM;wBACN+E,MAAM;wBACNC,oBAAoB;oBACtB;;;;;;;;;;;;4BAIeC;wBACf,IAAIzE,kBAAkB;4BACpB,2CAA2C;4BAC3C,IAAI6B,cAAc6C,MAAM,KAAK,GAAG;gCAC9B7C,gBAAgB8C,OAAOC,IAAI,CAACH;gCAC5B1C,YAAYF,cAAc6C,MAAM;gCAChCnD,OAAOwB,IAAI,CAAC,2CAA2C;oCAAElB,eAAAA;oCAAeE,WAAAA;gCAAU;4BACpF;4BAEA,uEAAuE;4BACvE,gEAAgE;4BAChE,IAAM8C,MAAMhD,cAAciD,GAAG,CAAC,SAACC;oCAAW;wCAAA,iBAAA,AAACN,MAA2D,CAACM,OAAO,cAApE,4BAAA,iBAAwE;;4BAClHjD,QAAQkD,IAAI,CAACH;wBACf,OAAO;4BACL,qFAAqF;4BACrF,IAAMA,OAAMJ;4BACZ3C,QAAQkD,IAAI,CAACH;4BAEb,IAAI9C,cAAc,GAAG;gCACnBA,YAAY8C,KAAIH,MAAM;4BACxB;wBACF;oBACF;gDAtB2BzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAwB3B,IAAIH,QAAQ4C,MAAM,KAAK,GAAG;wBACxB,MAAM,IAAIZ,eAAQ,CAACC,gBAAS,CAACC,aAAa,EAAE;oBAC9C;oBAEA,qCAAqC;oBAC/B9B,cAAsDJ;oBAE5D,yDAAyD;oBACzD,+CAA+C;oBACzCK;oBACAC,aAAazC,EAAAA,oBAAAA,WAAWsF,KAAK,CAAC,4BAAjBtF,wCAAAA,iBAAiC,CAAC,EAAE,KAAI;oBACvD0C,gBAAgB6C,OAAOC,QAAQ,CAAC/C,YAAY;oBAEhD,IAASE,IAAI,GAAGA,IAAIJ,YAAYwC,MAAM,EAAEpC,KAAKxD,WAAY;;wBACjDyD,YAAYL,YAAYkD,KAAK,CAAC9C,GAAGA,IAAIxD;wBACrC0D,aAAa,AAzIzB,AAyI0B,UAAE/B,YAAW,KAAqC4B,QAAlC1C,qBAAAA,WAAWsF,KAAK,CAAC,uBAAjBtF,yCAAAA,kBAA4B,CAAC,EAAE,EAAiB,OAAd0C;wBAEtEF,cAAc6C,IAAI,CAAC;4BACjBK,OAAO7C;4BACP8C,QAAQ/C;wBACV;wBAEAF,iBAAiBE,UAAUmC,MAAM;oBACnC;oBAEAnD,OAAOwB,IAAI,CAAC,qCAAqC;wBAAEwC,cAAcpD,cAAcuC,MAAM;wBAAEc,WAAW1G;oBAAW;oBAGjF;;wBAAM6C,OAAOyB,YAAY,CAACkC,MAAM,CAACG,WAAW,CAAC;4BACvEnC,eAAepE;4BACfwG,aAAa;gCACX5F,kBAAAA;gCACA0D,MAAMrB;4BACR;wBACF;;;oBANMT,sBAAsB;oBAQtBe,oBAAoBf,oBAAoB8B,IAAI,CAACf,iBAAiB,IAAI;oBAClEC,mBAAmBhB,oBAAoB8B,IAAI,CAACd,gBAAgB,IAAI;oBAChEC,sBAAsBjB,oBAAoB8B,IAAI,CAACb,mBAAmB,IAAI;oBACtEC,oBAAoBlB,EAAAA,sCAAAA,oBAAoB8B,IAAI,CAACmC,SAAS,cAAlCjE,2DAAAA,uCAAAA,mCAAoC,CAAC,EAAE,cAAvCA,2DAAAA,qCAAyCf,YAAY,KAAI,AAAC,GAAgBhB,OAAdc,YAAW,KAAc,OAAXd;oBAEpG4B,OAAOwB,IAAI,CAAC,sCAAsC;wBAAE7D,IAAAA;wBAAIE,KAAKoC,MAAMoC,UAAU,CAACC,OAAO;wBAAElD,cAAciC;wBAAmBhC,aAAa8B;wBAAkBpD,WAAAA;oBAAU;oBAE3J8B,SAAiB;wBACrBjB,MAAM;wBACNjB,IAAAA;wBACAE,KAAKuE,QAAOnC,4BAAAA,MAAMoC,UAAU,CAACC,OAAO,cAAxBrC,uCAAAA,4BAA4B;wBACxCjB,gBAAgB,WAAEkB,8BAAAA,gBAAgBmC,UAAU,cAA1BnC,kDAAAA,4BAA4BwC,KAAK,uCAAI;wBACvDzD,cAAc,GAAEiB,kCAAAA,gBAAgBjB,cAAc,cAA9BiB,6CAAAA,kCAAkC,AAAC,0CAA4C,OAAHvC;wBAC5FuB,YAAAA;wBACAC,UAAU,AAAC,0CAAwDc,OAAftC,IAAG,cAAqC,OAAzBsC,MAAMoC,UAAU,CAACC,OAAO;wBAC3FlD,cAAciC;wBACdhC,aAAa8B;wBACb5B,gBAAgB6B;wBAChB5B,cAAc0B;oBAChB;oBAEA;;wBAAO;4BACLmD,OAAO;gCAAG;oCAAEzF,MAAM;oCAAiB0F,MAAMC,KAAKC,SAAS,CAAC3E;gCAAQ;;4BAChE4E,mBAAmB;gCAAE5E,QAAAA;4BAAO;wBAC9B;;;oBACOyB;oBACDC,UAAUD,AAAK,YAALA,OAAiBoD,SAAQpD,MAAMC,OAAO,GAAGa,OAAOd;oBAChEtB,OAAOsB,KAAK,CAAC,kCAAkC;wBAAEA,OAAOC;oBAAQ;oBAEhE,MAAM,IAAIgB,eAAQ,CAACC,gBAAS,CAACmC,aAAa,EAAE,AAAC,mCAA0C,OAARpD,UAAW;wBACxFqD,OAAOtD,AAAK,YAALA,OAAiBoD,SAAQpD,MAAMsD,KAAK,GAAGC;oBAChD;;;;;;;IAEJ;;AAEe,SAASzH;IACtB,OAAO;QACL0H,MAAM;QACNnF,QAAAA;QACAG,SAAAA;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/values-csv-update.ts"],"sourcesContent":["/** Import CSV data to Google Sheets with range-based update (no 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 { A1NotationSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { getCsvReadStream } from '../../spreadsheet/csv-streaming.ts';\n\n/** Batch size for Sheets API calls (1000 rows × avg 10 cols = 10K cells, well under 40K limit) */\nconst BATCH_SIZE = 1000;\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  startRange: A1NotationSchema.default('A1').describe('Top-left cell where CSV data starts (default: A1)'),\n  valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How to interpret values (RAW = exact, USER_ENTERED = parse formulas/dates)'),\n  sourceHasHeaders: z.boolean().default(true).describe('First row is headers (metadata) - exclude from data range. Set to false to include first row as data.'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  spreadsheetTitle: z.string().describe('Spreadsheet title'),\n  spreadsheetUrl: z.string().describe('Spreadsheet URL'),\n  sheetTitle: z.string().describe('Sheet title'),\n  sheetUrl: z.string().describe('Sheet URL'),\n  updatedRange: z.string().describe('A1 notation range that was updated'),\n  updatedRows: z.number().describe('Number of rows updated'),\n  updatedColumns: z.number().describe('Number of columns updated'),\n  updatedCells: z.number().describe('Number of cells updated'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Import CSV to sheet range. Overwrites existing data at startRange. Use rows-csv-append for database-style appends with deduplication.',\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, sourceUri, startRange, valueInputOption = 'USER_ENTERED', sourceHasHeaders }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values.csv-update called', { id, gid, sourceUri, startRange, valueInputOption, sourceHasHeaders });\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\n    // Find the sheet by gid\n    const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? '';\n\n    // Streaming CSV processing state\n    let sourceHeaders: string[] = [];\n    const allRows: (string | number | boolean | null)[][] = [];\n    let totalCols = 0;\n\n    // Get readable stream from CSV URI (no temp files!)\n    const readStream = await getCsvReadStream(sourceUri);\n\n    // Create CSV parser with native streaming\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    // Stream and collect all rows (with batching for very large files)\n    for await (const record of parser) {\n      if (sourceHasHeaders) {\n        // Extract source headers from first record\n        if (sourceHeaders.length === 0) {\n          sourceHeaders = Object.keys(record as Record<string, unknown>);\n          totalCols = sourceHeaders.length;\n          logger.info('sheets.values.csv-update source headers', { sourceHeaders, totalCols });\n        }\n\n        // Convert record to row array (exclude source headers from data range)\n        // CSV values are strings/numbers/booleans/nulls from the parser\n        const row = sourceHeaders.map((header) => (record as Record<string, string | number | boolean | null>)[header] ?? null);\n        allRows.push(row);\n      } else {\n        // sourceHasHeaders=false: record is an array, include all rows (including first row)\n        const row = record as (string | number | boolean | null)[];\n        allRows.push(row);\n\n        if (totalCols === 0) {\n          totalCols = row.length;\n        }\n      }\n    }\n\n    if (allRows.length === 0) {\n      throw new McpError(ErrorCode.InvalidParams, 'CSV file is empty');\n    }\n\n    // Prepare data for update (all rows)\n    const dataToWrite: (string | number | boolean | null)[][] = allRows;\n\n    // For large datasets, use batchUpdate to write in chunks\n    // This respects the 40K cell limit per request\n    const batchRequests = [];\n    const currentRow = startRange.match(/[A-Z]+(\\d+)/)?.[1] || '1';\n    let currentRowNum = Number.parseInt(currentRow, 10);\n\n    for (let i = 0; i < dataToWrite.length; i += BATCH_SIZE) {\n      const batchData = dataToWrite.slice(i, i + BATCH_SIZE);\n      const batchRange = `${sheetTitle}!${startRange.match(/[A-Z]+/)?.[0]}${currentRowNum}`;\n\n      batchRequests.push({\n        range: batchRange,\n        values: batchData,\n      });\n\n      currentRowNum += batchData.length;\n    }\n\n    logger.info('sheets.values.csv-update batching', { totalBatches: batchRequests.length, batchSize: BATCH_SIZE });\n\n    // Execute batch update\n    const batchUpdateResponse = await sheets.spreadsheets.values.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        valueInputOption,\n        data: batchRequests,\n      },\n    });\n\n    const totalUpdatedCells = batchUpdateResponse.data.totalUpdatedCells || 0;\n    const totalUpdatedRows = batchUpdateResponse.data.totalUpdatedRows || 0;\n    const totalUpdatedColumns = batchUpdateResponse.data.totalUpdatedColumns || 0;\n    const firstUpdatedRange = batchUpdateResponse.data.responses?.[0]?.updatedRange || `${sheetTitle}!${startRange}`;\n\n    logger.info('sheets.values.csv-update completed', { id, gid: sheet.properties.sheetId, updatedRange: firstUpdatedRange, updatedRows: totalUpdatedRows, sourceUri });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheet.properties.sheetId ?? ''),\n      spreadsheetTitle: spreadsheetData.properties?.title ?? '',\n      spreadsheetUrl: spreadsheetData.spreadsheetUrl ?? `https://docs.google.com/spreadsheets/d/${id}`,\n      sheetTitle,\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheet.properties.sheetId}`,\n      updatedRange: firstUpdatedRange,\n      updatedRows: totalUpdatedRows,\n      updatedColumns: totalUpdatedColumns,\n      updatedCells: totalUpdatedCells,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.values.csv-update error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error updating values from CSV: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-csv-update',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["createTool","AuthRequiredBranchSchema","schemas","BATCH_SIZE","inputSchema","z","object","id","SpreadsheetIdSchema","gid","SheetGidSchema","sourceUri","string","trim","min","describe","startRange","A1NotationSchema","default","valueInputOption","enum","sourceHasHeaders","boolean","successBranchSchema","type","literal","SpreadsheetIdOutput","SheetGidOutput","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRange","updatedRows","number","updatedColumns","updatedCells","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","sheet","spreadsheetData","batchUpdateResponse","sheets","spreadsheetResponse","sourceHeaders","allRows","totalCols","readStream","parser","dataToWrite","batchRequests","currentRow","currentRowNum","i","batchData","batchRange","totalUpdatedCells","totalUpdatedRows","totalUpdatedColumns","firstUpdatedRange","error","message","info","google","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","McpError","ErrorCode","InvalidParams","title","getCsvReadStream","pipe","parse","columns","skip_empty_lines","cast","relax_column_count","record","length","Object","keys","row","map","header","push","match","Number","parseInt","slice","range","values","totalBatches","batchSize","batchUpdate","requestBody","responses","content","text","JSON","stringify","structuredContent","Error","InternalError","stack","undefined","name"],"mappings":"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"}

package/dist/cjs/mcp/tools/values-markdown-update.d.cts

@@ -0,0 +1,76 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    id: z.ZodString;
+    gid: z.ZodCoercedString<unknown>;
+    requests: z.ZodArray<z.ZodObject<{
+        cell: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    id: z.ZodString;
+    gid: z.ZodString;
+    sheetTitle: z.ZodString;
+    sheetUrl: z.ZodString;
+    successCount: z.ZodNumber;
+    cells: z.ZodArray<z.ZodObject<{
+        cell: z.ZodString;
+        text: z.ZodString;
+        linkCount: z.ZodNumber;
+    }, z.core.$strip>>;
+    failedCells: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        cell: z.ZodString;
+        error: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Replace cell content with text parsed from inline markdown. Supports [label](url) links, bare URLs, **bold**, *italic*, ~~strikethrough~~ — the only way to put MULTIPLE clickable links in one cell. Block syntax (headers, lists, tables) and other unsupported markdown is written as literal text. Writes text cells only — no formula or number coercion. For whole-cell formatting (colors, borders, number formats) use cells-format.";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            gid: z.ZodCoercedString<unknown>;
+            requests: z.ZodArray<z.ZodObject<{
+                cell: z.ZodString;
+                text: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                id: z.ZodString;
+                gid: z.ZodString;
+                sheetTitle: z.ZodString;
+                sheetUrl: z.ZodString;
+                successCount: z.ZodNumber;
+                cells: z.ZodArray<z.ZodObject<{
+                    cell: z.ZodString;
+                    text: z.ZodString;
+                    linkCount: z.ZodNumber;
+                }, z.core.$strip>>;
+                failedCells: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    cell: z.ZodString;
+                    error: z.ZodString;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};

package/dist/cjs/mcp/tools/values-markdown-update.d.ts

@@ -0,0 +1,76 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    id: z.ZodString;
+    gid: z.ZodCoercedString<unknown>;
+    requests: z.ZodArray<z.ZodObject<{
+        cell: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    id: z.ZodString;
+    gid: z.ZodString;
+    sheetTitle: z.ZodString;
+    sheetUrl: z.ZodString;
+    successCount: z.ZodNumber;
+    cells: z.ZodArray<z.ZodObject<{
+        cell: z.ZodString;
+        text: z.ZodString;
+        linkCount: z.ZodNumber;
+    }, z.core.$strip>>;
+    failedCells: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        cell: z.ZodString;
+        error: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Replace cell content with text parsed from inline markdown. Supports [label](url) links, bare URLs, **bold**, *italic*, ~~strikethrough~~ — the only way to put MULTIPLE clickable links in one cell. Block syntax (headers, lists, tables) and other unsupported markdown is written as literal text. Writes text cells only — no formula or number coercion. For whole-cell formatting (colors, borders, number formats) use cells-format.";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            gid: z.ZodCoercedString<unknown>;
+            requests: z.ZodArray<z.ZodObject<{
+                cell: z.ZodString;
+                text: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                id: z.ZodString;
+                gid: z.ZodString;
+                sheetTitle: z.ZodString;
+                sheetUrl: z.ZodString;
+                successCount: z.ZodNumber;
+                cells: z.ZodArray<z.ZodObject<{
+                    cell: z.ZodString;
+                    text: z.ZodString;
+                    linkCount: z.ZodNumber;
+                }, z.core.$strip>>;
+                failedCells: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    cell: z.ZodString;
+                    error: z.ZodString;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};

package/dist/cjs/mcp/tools/values-markdown-update.js

@@ -0,0 +1,413 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return createTool;
+    }
+});
+var _oauthgoogle = require("@mcp-z/oauth-google");
+var _types = require("@modelcontextprotocol/sdk/types.js");
+var _googleapis = require("googleapis");
+var _zod = require("zod");
+var _indexts = require("../../schemas/index.js");
+var _markdownrunsts = require("../../spreadsheet/markdown-runs.js");
+var _rangeoperationsts = require("../../spreadsheet/range-operations.js");
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _instanceof(left, right) {
+    "@swc/helpers - instanceof";
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+var AuthRequiredBranchSchema = _oauthgoogle.schemas.AuthRequiredBranchSchema;
+// Input schema for a single markdown-cell request
+var MarkdownCellRequestSchema = _zod.z.object({
+    cell: _zod.z.string().min(1).describe('Single-cell A1 reference (e.g., "I2"). Multi-cell ranges (e.g., "A1:B2") are rejected as a per-request failure.'),
+    text: _zod.z.string().describe('Cell content as inline markdown: [label](url) links, bare URLs, **bold**, *italic*, ~~strikethrough~~. Block syntax and other unsupported markdown is written as literal text.')
+});
+var inputSchema = _zod.z.object({
+    id: _indexts.SpreadsheetIdSchema,
+    gid: _indexts.SheetGidSchema,
+    requests: _zod.z.array(MarkdownCellRequestSchema).min(1).max(50).describe('Array of cell markdown requests. Batch multiple cells for efficiency.')
+});
+var successBranchSchema = _zod.z.object({
+    type: _zod.z.literal('success'),
+    id: _indexts.SpreadsheetIdOutput,
+    gid: _indexts.SheetGidOutput,
+    sheetTitle: _zod.z.string().describe('Title of the updated sheet'),
+    sheetUrl: _zod.z.string().describe('URL of the updated sheet'),
+    successCount: _zod.z.number().int().nonnegative().describe('Number of cells successfully written'),
+    cells: _zod.z.array(_zod.z.object({
+        cell: _zod.z.string().describe('A1 reference of the cell that was written'),
+        text: _zod.z.string().describe('Resolved plain text written to the cell (markdown syntax stripped/literalized)'),
+        linkCount: _zod.z.number().int().nonnegative().describe('Number of clickable links written into the cell')
+    })).describe('Cells successfully written'),
+    failedCells: _zod.z.array(_zod.z.object({
+        cell: _zod.z.string().describe('A1 reference that failed'),
+        error: _zod.z.string().describe('Why the cell failed (e.g., not a single-cell reference)')
+    })).optional().describe('Only populated if some cells failed')
+});
+var outputSchema = _zod.z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+var config = {
+    description: 'Replace cell content with text parsed from inline markdown. Supports [label](url) links, bare URLs, **bold**, *italic*, ~~strikethrough~~ — the only way to put MULTIPLE clickable links in one cell. Block syntax (headers, lists, tables) and other unsupported markdown is written as literal text. Writes text cells only — no formula or number coercion. For whole-cell formatting (colors, borders, number formats) use cells-format.',
+    inputSchema: inputSchema,
+    outputSchema: _zod.z.object({
+        result: outputSchema
+    })
+};
+function handler(_0, _1) {
+    return _async_to_generator(function(param, extra) {
+        var id, gid, requests, logger, _sheet_properties_title, _sheet_properties_sheetId, _spreadsheetResponse_data_sheets, sheets, spreadsheetResponse, sheet, sheetTitle, sheetId, sheetUrl, batchRequests, cells, failedCells, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, request, rangeRef, gridRange, parsed, runs, message, result, result1, error, message1;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    id = param.id, gid = param.gid, requests = param.requests;
+                    logger = extra.logger;
+                    logger.info('sheets.values.markdownUpdate called', {
+                        id: id,
+                        gid: gid,
+                        requestCount: requests.length
+                    });
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        4,
+                        ,
+                        5
+                    ]);
+                    sheets = _googleapis.google.sheets({
+                        version: 'v4',
+                        auth: extra.authContext.auth
+                    });
+                    return [
+                        4,
+                        sheets.spreadsheets.get({
+                            spreadsheetId: id,
+                            fields: 'sheets.properties.sheetId,sheets.properties.title'
+                        })
+                    ];
+                case 2:
+                    spreadsheetResponse = _state.sent();
+                    // Find sheet by gid
+                    sheet = (_spreadsheetResponse_data_sheets = spreadsheetResponse.data.sheets) === null || _spreadsheetResponse_data_sheets === void 0 ? void 0 : _spreadsheetResponse_data_sheets.find(function(s) {
+                        var _s_properties;
+                        return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === gid;
+                    });
+                    if (!(sheet === null || sheet === void 0 ? void 0 : sheet.properties)) {
+                        logger.info('Sheet not found for markdown update', {
+                            id: id,
+                            gid: gid,
+                            requestCount: requests.length
+                        });
+                        throw new _types.McpError(_types.ErrorCode.InvalidParams, "Sheet not found: ".concat(gid));
+                    }
+                    sheetTitle = (_sheet_properties_title = sheet.properties.title) !== null && _sheet_properties_title !== void 0 ? _sheet_properties_title : gid;
+                    // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).
+                    sheetId = (_sheet_properties_sheetId = sheet.properties.sheetId) !== null && _sheet_properties_sheetId !== void 0 ? _sheet_properties_sheetId : 0;
+                    sheetUrl = "https://docs.google.com/spreadsheets/d/".concat(id, "/edit#gid=").concat(sheetId);
+                    // Build one updateCells request per cell
+                    batchRequests = [];
+                    cells = [];
+                    failedCells = [];
+                    _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                    try {
+                        for(_iterator = requests[Symbol.iterator](); !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                            request = _step.value;
+                            try {
+                                // Parse A1 notation and reject anything that isn't a single cell
+                                rangeRef = (0, _rangeoperationsts.parseA1Notation)(request.cell);
+                                if (rangeRef.type !== 'cell') {
+                                    throw new Error('Not a single-cell reference: "'.concat(request.cell, '"'));
+                                }
+                                gridRange = (0, _rangeoperationsts.rangeReferenceToGridRange)(rangeRef, sheetId);
+                                parsed = (0, _markdownrunsts.parseInlineMarkdown)(request.text);
+                                runs = (0, _markdownrunsts.buildTextFormatRuns)(parsed);
+                                batchRequests.push({
+                                    updateCells: {
+                                        range: gridRange,
+                                        rows: [
+                                            {
+                                                values: [
+                                                    {
+                                                        userEnteredValue: {
+                                                            stringValue: parsed.text
+                                                        },
+                                                        textFormatRuns: runs
+                                                    }
+                                                ]
+                                            }
+                                        ],
+                                        fields: 'userEnteredValue,textFormatRuns'
+                                    }
+                                });
+                                cells.push({
+                                    cell: request.cell,
+                                    text: parsed.text,
+                                    linkCount: parsed.linkCount
+                                });
+                            } catch (error) {
+                                message = _instanceof(error, Error) ? error.message : String(error);
+                                logger.info('Failed to parse cell for markdown update', {
+                                    cell: request.cell,
+                                    error: message
+                                });
+                                failedCells.push({
+                                    cell: request.cell,
+                                    error: "Failed to parse cell: ".concat(message)
+                                });
+                            }
+                        }
+                    } catch (err) {
+                        _didIteratorError = true;
+                        _iteratorError = err;
+                    } finally{
+                        try {
+                            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                _iterator.return();
+                            }
+                        } finally{
+                            if (_didIteratorError) {
+                                throw _iteratorError;
+                            }
+                        }
+                    }
+                    // Early return if all cells failed
+                    if (batchRequests.length === 0) {
+                        result = {
+                            type: 'success',
+                            id: id,
+                            gid: String(sheetId),
+                            sheetTitle: sheetTitle,
+                            sheetUrl: sheetUrl,
+                            successCount: 0,
+                            cells: [],
+                            failedCells: failedCells.length > 0 ? failedCells : undefined
+                        };
+                        return [
+                            2,
+                            {
+                                content: [
+                                    {
+                                        type: 'text',
+                                        text: JSON.stringify(result)
+                                    }
+                                ],
+                                structuredContent: {
+                                    result: result
+                                }
+                            }
+                        ];
+                    }
+                    logger.info('sheets.values.markdownUpdate executing batch request', {
+                        spreadsheetId: id,
+                        sheetTitle: sheetTitle,
+                        batchRequestsCount: batchRequests.length
+                    });
+                    // Execute the batch update
+                    return [
+                        4,
+                        sheets.spreadsheets.batchUpdate({
+                            spreadsheetId: id,
+                            requestBody: {
+                                requests: batchRequests
+                            }
+                        })
+                    ];
+                case 3:
+                    _state.sent();
+                    logger.info('sheets.values.markdownUpdate completed successfully', {
+                        successCount: cells.length,
+                        failedCount: failedCells.length
+                    });
+                    result1 = {
+                        type: 'success',
+                        id: id,
+                        gid: String(sheetId),
+                        sheetTitle: sheetTitle,
+                        sheetUrl: sheetUrl,
+                        successCount: cells.length,
+                        cells: cells,
+                        failedCells: failedCells.length > 0 ? failedCells : undefined
+                    };
+                    return [
+                        2,
+                        {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: JSON.stringify(result1)
+                                }
+                            ],
+                            structuredContent: {
+                                result: result1
+                            }
+                        }
+                    ];
+                case 4:
+                    error = _state.sent();
+                    // Re-throw McpError as-is
+                    if (_instanceof(error, _types.McpError)) {
+                        throw error;
+                    }
+                    message1 = _instanceof(error, Error) ? error.message : String(error);
+                    logger.error('Markdown update operation failed', {
+                        id: id,
+                        gid: gid,
+                        requestCount: requests.length,
+                        error: message1
+                    });
+                    throw new _types.McpError(_types.ErrorCode.InternalError, "Error writing markdown to cells: ".concat(message1), {
+                        stack: _instanceof(error, Error) ? error.stack : undefined
+                    });
+                case 5:
+                    return [
+                        2
+                    ];
+            }
+        });
+    }).apply(this, arguments);
+}
+function createTool() {
+    return {
+        name: 'values-markdown-update',
+        config: config,
+        handler: handler
+    };
+}
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }