@mcp-z/mcp-sheets 1.2.3 → 1.3.0

package/dist/cjs/spreadsheet/markdown-runs.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/spreadsheet/markdown-runs.ts"],"sourcesContent":["/**\n * Inline Markdown → Google Sheets textFormatRuns\n *\n * The Sheets values API can only write plain text or formulas — it cannot set\n * `textFormatRuns`, so plain-text URLs are never linkified and `=HYPERLINK()`\n * only ever produces one link per cell. Multiple distinct clickable links (or\n * any other rich text) inside a single cell require `textFormatRuns`, which is\n * only settable via `spreadsheets.batchUpdate` → `updateCells`. This module\n * parses a small, deliberately restricted subset of inline markdown into plain\n * text plus the `textFormatRuns` needed to render it.\n *\n * Supported inline constructs:\n *   - `[label](url)` and bare `http(s)://` URLs -> `format.link.uri`\n *   - `**bold**` / `__bold__`                    -> `format.bold`\n *   - `*italic*` / `_italic_`                     -> `format.italic`\n *   - `~~strikethrough~~`                         -> `format.strikethrough`\n *   - `\\X` escapes any of the delimiter characters above to a literal `X`\n *\n * Everything else (headers, lists, tables, backticks, unmatched delimiters,\n * ...) is passed through as literal text. This module never throws on\n * malformed markdown — graceful degradation to literal text is the contract.\n *\n * A note on indices: Google Sheets `textFormatRuns[].startIndex` is defined in\n * UTF-16 code units. JavaScript string indexing (`str[i]`, `str.length`,\n * `str.slice()`) already operates on UTF-16 code units, so plain indexing is\n * exactly correct here. Do NOT iterate with `[...str]` or any other code-point\n * aware iteration — that would silently misalign indices for any text\n * containing astral characters (e.g. emoji), which are represented as\n * surrogate pairs (2 code units).\n */\n\nimport type { sheets_v4 } from 'googleapis';\n\n// Default styling applied to link runs so they read as clickable links (Sheets'\n// own link color), matching what Sheets applies automatically for =HYPERLINK().\nconst LINK_BLUE: sheets_v4.Schema$Color = { red: 0.06666667, green: 0.33333334, blue: 0.8 };\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/** A formatting span over `text`, in UTF-16 code unit coordinates (half-open: [start, end)). */\nexport interface MarkdownSpan {\n  start: number;\n  end: number;\n  format: sheets_v4.Schema$TextFormat;\n}\n\nexport interface ParsedMarkdown {\n  /** Plain text with all markdown syntax stripped (or literalized). */\n  text: string;\n  /** Formatting spans over `text`. May overlap/nest (e.g. a bold span wrapping a link span). */\n  spans: MarkdownSpan[];\n  /** Number of link spans found (spans whose format has `link` set). */\n  linkCount: number;\n}\n\n// ---------------------------------------------------------------------------\n// Tokenizer\n// ---------------------------------------------------------------------------\n\ntype EmphasisKind = 'bold' | 'italic' | 'strikethrough';\n\ntype Token = { type: 'text'; value: string } | { type: 'link'; label: string; uri: string } | { type: 'delim'; kind: EmphasisKind; raw: string; canOpen: boolean; canClose: boolean };\n\n// Matched against a suffix of the input (anchored with ^), so `.exec` always tests position 0.\nconst MD_LINK = /^\\[([^\\]]*?)\\]\\(\\s*(<[^>]+>|[^)\\s]+)(?:\\s+\"[^\"]*\")?\\s*\\)/;\nconst BARE_URL = /^https?:\\/\\/[^\\s<>\"'()[\\]]+/;\n\n// Characters that may be backslash-escaped to a literal (the delimiter chars this\n// parser recognizes as syntax, plus the backslash itself).\nconst ESCAPABLE = new Set(['\\\\', '*', '_', '~', '[', ']', '(', ')']);\n\n/** Trailing punctuation that is almost certainly prose, not part of a bare URL. */\nfunction trimTrailingPunctuation(url: string): string {\n  return url.replace(/[.,;:!?]+$/, '');\n}\n\nconst isWhitespaceOrEdge = (ch: string | undefined): boolean => ch === undefined || /\\s/.test(ch);\nconst isWordChar = (ch: string | undefined): boolean => ch !== undefined && /[A-Za-z0-9]/.test(ch);\n\n/**\n * Simplified CommonMark flanking rules — without these, whitespace-flanked\n * delimiters pair up (\"3 * 4 * 5\" would italicize \" 4 \") and intraword\n * underscores become emphasis (\"user_id and account_id\" would italicize\n * \"id and account\" and delete the underscores). Both are silent data\n * corruption for ordinary spreadsheet content, so:\n *   - a delimiter can OPEN emphasis only if not followed by whitespace/end\n *   - a delimiter can CLOSE emphasis only if not preceded by whitespace/start\n *   - `_`/`__` additionally can never open after, or close before, a word\n *     character (intraword underscores are literal, per CommonMark)\n * Intraword `*` is intentionally still allowed (`a*b*c` emphasizes `b`),\n * matching CommonMark.\n */\nfunction delimiterFlanking(_kind: EmphasisKind, raw: string, prev: string | undefined, next: string | undefined): { canOpen: boolean; canClose: boolean } {\n  const underscore = raw.startsWith('_');\n  const canOpen = !isWhitespaceOrEdge(next) && !(underscore && isWordChar(prev));\n  const canClose = !isWhitespaceOrEdge(prev) && !(underscore && isWordChar(next));\n  return { canOpen, canClose };\n}\n\n/**\n * Scans the raw markdown left-to-right into a flat token stream: literal text\n * runs, resolved links (markdown-link or bare-URL), and emphasis delimiters.\n * Emphasis delimiters are emitted as opaque tokens here — whether a given\n * delimiter is an opener, a closer, or unmatched (and thus literal) is decided\n * in a second pass, since that requires seeing the whole stream.\n */\nfunction tokenize(markdown: string): Token[] {\n  const tokens: Token[] = [];\n  let buffer = '';\n  const flush = () => {\n    if (buffer) {\n      tokens.push({ type: 'text', value: buffer });\n      buffer = '';\n    }\n  };\n\n  let i = 0;\n  while (i < markdown.length) {\n    const ch = markdown[i] as string;\n    const next = markdown[i + 1];\n\n    // Backslash escapes: \\* \\_ \\~ \\[ \\] \\( \\) \\\\  -> literal char, never treated as syntax.\n    if (ch === '\\\\' && next !== undefined && ESCAPABLE.has(next)) {\n      buffer += next;\n      i += 2;\n      continue;\n    }\n\n    // Markdown links: [label](url) — checked before bare URLs so the label wins.\n    const linkMatch = MD_LINK.exec(markdown.slice(i));\n    if (linkMatch) {\n      flush();\n      const rawLabel = (linkMatch[1] ?? '').trim();\n      const uri = (linkMatch[2] ?? '').replace(/^<|>$/g, '');\n      tokens.push({ type: 'link', label: rawLabel.length > 0 ? rawLabel : uri, uri });\n      i += linkMatch[0].length;\n      continue;\n    }\n\n    // Bare http(s) URLs — the URL itself becomes the label.\n    if (ch === 'h') {\n      const bareMatch = BARE_URL.exec(markdown.slice(i));\n      if (bareMatch) {\n        flush();\n        const raw = bareMatch[0];\n        const uri = trimTrailingPunctuation(raw);\n        tokens.push({ type: 'link', label: uri, uri });\n        // Trailing punctuation trimmed off the URL is not part of the link — keep it as literal text.\n        if (uri.length < raw.length) buffer += raw.slice(uri.length);\n        i += raw.length;\n        continue;\n      }\n    }\n\n    // Emphasis delimiters — longest first: ** and __ (bold) and ~~ (strikethrough) before * and _ (italic).\n    // The delimiter's width is fixed BEFORE the flanking check: a ** that fails\n    // flanking is two literal asterisks, never reinterpreted as two * delimiters.\n    const two = markdown.slice(i, i + 2);\n    const kind: EmphasisKind | undefined = two === '**' || two === '__' ? 'bold' : two === '~~' ? 'strikethrough' : ch === '*' || ch === '_' ? 'italic' : undefined;\n    if (kind !== undefined) {\n      const raw = kind === 'italic' ? ch : two;\n      const { canOpen, canClose } = delimiterFlanking(kind, raw, markdown[i - 1], markdown[i + raw.length]);\n      if (canOpen || canClose) {\n        flush();\n        tokens.push({ type: 'delim', kind, raw, canOpen, canClose });\n      } else {\n        // Fails flanking on both sides — literal text (e.g. \" * \" or intraword \"_\").\n        buffer += raw;\n      }\n      i += raw.length;\n      continue;\n    }\n\n    buffer += ch;\n    i += 1;\n  }\n  flush();\n  return tokens;\n}\n\n// ---------------------------------------------------------------------------\n// Delimiter matching (unmatched delimiters degrade to literal text)\n// ---------------------------------------------------------------------------\n\n/** Matches emphasis delimiter tokens by kind using a simple open/close stack (assumes well-nested markdown). */\nfunction matchDelimiters(tokens: Token[]): Map<number, number> {\n  const stack: { kind: EmphasisKind; tokenIndex: number }[] = [];\n  const openerToCloser = new Map<number, number>();\n\n  tokens.forEach((token, index) => {\n    if (token.type !== 'delim') return;\n    const top = stack[stack.length - 1];\n    if (token.canClose && top && top.kind === token.kind) {\n      stack.pop();\n      openerToCloser.set(top.tokenIndex, index);\n    } else if (token.canOpen) {\n      stack.push({ kind: token.kind, tokenIndex: index });\n    }\n    // Can neither close the current context nor open — stays unmatched (literal).\n  });\n\n  // Anything left on the stack never closed — leave unmatched (rendered literally by the caller).\n  return openerToCloser;\n}\n\nconst FORMAT_FOR_KIND: Record<EmphasisKind, sheets_v4.Schema$TextFormat> = {\n  bold: { bold: true },\n  italic: { italic: true },\n  strikethrough: { strikethrough: true },\n};\n\n/** Walks the token stream, resolving matched delimiter pairs into spans and unmatched ones into literal text. */\nfunction buildTextAndSpans(tokens: Token[]): { text: string; spans: MarkdownSpan[] } {\n  const openerToCloser = matchDelimiters(tokens);\n  const closerToOpener = new Map<number, number>();\n  for (const [opener, closer] of openerToCloser) closerToOpener.set(closer, opener);\n\n  let text = '';\n  const spans: MarkdownSpan[] = [];\n  const openerStart = new Map<number, number>(); // opener token index -> plain-text start offset\n\n  tokens.forEach((token, index) => {\n    if (token.type === 'text') {\n      text += token.value;\n      return;\n    }\n\n    if (token.type === 'link') {\n      const start = text.length;\n      text += token.label;\n      spans.push({ start, end: text.length, format: { link: { uri: token.uri } } });\n      return;\n    }\n\n    // Emphasis delimiter token.\n    if (openerToCloser.has(index)) {\n      // Matched opener — record where its span begins; the delimiter itself is consumed (not emitted).\n      openerStart.set(index, text.length);\n      return;\n    }\n    const openerIndex = closerToOpener.get(index);\n    if (openerIndex !== undefined) {\n      // Matched closer — emit the span from the recorded opener position to here.\n      const start = openerStart.get(openerIndex);\n      if (start === undefined) {\n        throw new Error('markdown-runs: internal error — emphasis opener position was not recorded');\n      }\n      spans.push({ start, end: text.length, format: FORMAT_FOR_KIND[token.kind] });\n      return;\n    }\n    // Unmatched delimiter — no syntactic partner, so it degrades to its literal characters.\n    text += token.raw;\n  });\n\n  return { text, spans };\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/** Parses inline markdown into plain text plus formatting spans (see module docs for the supported subset). */\nexport function parseInlineMarkdown(markdown: string): ParsedMarkdown {\n  const tokens = tokenize(markdown);\n  const { text, spans } = buildTextAndSpans(tokens);\n  const linkCount = spans.filter((span) => span.format.link !== undefined).length;\n  return { text, spans, linkCount };\n}\n\n/**\n * Builds `textFormatRuns` from parsed markdown spans.\n *\n * Three Sheets API rules drive this, and are easy to get wrong:\n *   1. A run's format persists to the end of the string unless a later run\n *      resets it with an empty `format: {}` — runs are NOT scoped to a range.\n *   2. A run must never be emitted at `startIndex === text.length`: a span\n *      that reaches the end of the string needs no \"turn it off\" run, because\n *      there's no text left for stray formatting to leak into.\n *   3. Runs must be listed in strictly increasing `startIndex` order, with no\n *      two runs sharing an index.\n *\n * The approach: collect every index where the set of \"active\" spans changes\n * (every span start, and every span end that isn't end-of-string), merge the\n * formats of all spans active at each such index into one run, then ensure\n * there is a run at index 0 — either a span already starts there, or an\n * explicit empty-format baseline is prepended so the cell doesn't inherit any\n * pre-existing rich text formatting.\n */\nexport function buildTextFormatRuns(parsed: ParsedMarkdown, styleLinks = true): sheets_v4.Schema$TextFormatRun[] {\n  const { text, spans } = parsed;\n  if (text.length === 0) return [];\n\n  const boundaries = new Set<number>();\n  for (const span of spans) {\n    boundaries.add(span.start);\n    if (span.end < text.length) boundaries.add(span.end);\n  }\n  const sortedBoundaries = [...boundaries].sort((a, b) => a - b);\n\n  const runs: sheets_v4.Schema$TextFormatRun[] = sortedBoundaries.map((startIndex) => {\n    const format: sheets_v4.Schema$TextFormat = {};\n    for (const span of spans) {\n      if (span.start <= startIndex && startIndex < span.end) {\n        Object.assign(format, span.format);\n      }\n    }\n    if (styleLinks && format.link) {\n      format.underline = true;\n      format.foregroundColorStyle = { rgbColor: LINK_BLUE };\n    }\n    return { startIndex, format };\n  });\n\n  if (runs.length === 0 || runs[0]?.startIndex !== 0) {\n    runs.unshift({ startIndex: 0, format: {} });\n  }\n\n  return runs;\n}\n"],"names":["buildTextFormatRuns","parseInlineMarkdown","LINK_BLUE","red","green","blue","MD_LINK","BARE_URL","ESCAPABLE","Set","trimTrailingPunctuation","url","replace","isWhitespaceOrEdge","ch","undefined","test","isWordChar","delimiterFlanking","_kind","raw","prev","next","underscore","startsWith","canOpen","canClose","tokenize","markdown","tokens","buffer","flush","push","type","value","i","length","has","linkMatch","exec","slice","rawLabel","trim","uri","label","bareMatch","two","kind","matchDelimiters","stack","openerToCloser","Map","forEach","token","index","top","pop","set","tokenIndex","FORMAT_FOR_KIND","bold","italic","strikethrough","buildTextAndSpans","closerToOpener","opener","closer","text","spans","openerStart","start","end","format","link","openerIndex","get","Error","linkCount","filter","span","parsed","styleLinks","runs","boundaries","add","sortedBoundaries","sort","a","b","map","startIndex","Object","assign","underline","foregroundColorStyle","rgbColor","unshift"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/spreadsheet/markdown-runs.ts"],"sourcesContent":["import type { sheets_v4 } from '@googleapis/sheets';\n\n/**\n * Inline Markdown → Google Sheets textFormatRuns\n *\n * The Sheets values API can only write plain text or formulas — it cannot set\n * `textFormatRuns`, so plain-text URLs are never linkified and `=HYPERLINK()`\n * only ever produces one link per cell. Multiple distinct clickable links (or\n * any other rich text) inside a single cell require `textFormatRuns`, which is\n * only settable via `spreadsheets.batchUpdate` → `updateCells`. This module\n * parses a small, deliberately restricted subset of inline markdown into plain\n * text plus the `textFormatRuns` needed to render it.\n *\n * Supported inline constructs:\n *   - `[label](url)` and bare `http(s)://` URLs -> `format.link.uri`\n *   - `**bold**` / `__bold__`                    -> `format.bold`\n *   - `*italic*` / `_italic_`                     -> `format.italic`\n *   - `~~strikethrough~~`                         -> `format.strikethrough`\n *   - `\\X` escapes any of the delimiter characters above to a literal `X`\n *\n * Everything else (headers, lists, tables, backticks, unmatched delimiters,\n * ...) is passed through as literal text. This module never throws on\n * malformed markdown — graceful degradation to literal text is the contract.\n *\n * A note on indices: Google Sheets `textFormatRuns[].startIndex` is defined in\n * UTF-16 code units. JavaScript string indexing (`str[i]`, `str.length`,\n * `str.slice()`) already operates on UTF-16 code units, so plain indexing is\n * exactly correct here. Do NOT iterate with `[...str]` or any other code-point\n * aware iteration — that would silently misalign indices for any text\n * containing astral characters (e.g. emoji), which are represented as\n * surrogate pairs (2 code units).\n */\n\n// Default styling applied to link runs so they read as clickable links (Sheets'\n// own link color), matching what Sheets applies automatically for =HYPERLINK().\nconst LINK_BLUE: sheets_v4.Schema$Color = { red: 0.06666667, green: 0.33333334, blue: 0.8 };\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/** A formatting span over `text`, in UTF-16 code unit coordinates (half-open: [start, end)). */\nexport interface MarkdownSpan {\n  start: number;\n  end: number;\n  format: sheets_v4.Schema$TextFormat;\n}\n\nexport interface ParsedMarkdown {\n  /** Plain text with all markdown syntax stripped (or literalized). */\n  text: string;\n  /** Formatting spans over `text`. May overlap/nest (e.g. a bold span wrapping a link span). */\n  spans: MarkdownSpan[];\n  /** Number of link spans found (spans whose format has `link` set). */\n  linkCount: number;\n}\n\n// ---------------------------------------------------------------------------\n// Tokenizer\n// ---------------------------------------------------------------------------\n\ntype EmphasisKind = 'bold' | 'italic' | 'strikethrough';\n\ntype Token = { type: 'text'; value: string } | { type: 'link'; label: string; uri: string } | { type: 'delim'; kind: EmphasisKind; raw: string; canOpen: boolean; canClose: boolean };\n\n// Matched against a suffix of the input (anchored with ^), so `.exec` always tests position 0.\nconst MD_LINK = /^\\[([^\\]]*?)\\]\\(\\s*(<[^>]+>|[^)\\s]+)(?:\\s+\"[^\"]*\")?\\s*\\)/;\nconst BARE_URL = /^https?:\\/\\/[^\\s<>\"'()[\\]]+/;\n\n// Characters that may be backslash-escaped to a literal (the delimiter chars this\n// parser recognizes as syntax, plus the backslash itself).\nconst ESCAPABLE = new Set(['\\\\', '*', '_', '~', '[', ']', '(', ')']);\n\n/** Trailing punctuation that is almost certainly prose, not part of a bare URL. */\nfunction trimTrailingPunctuation(url: string): string {\n  return url.replace(/[.,;:!?]+$/, '');\n}\n\nconst isWhitespaceOrEdge = (ch: string | undefined): boolean => ch === undefined || /\\s/.test(ch);\nconst isWordChar = (ch: string | undefined): boolean => ch !== undefined && /[A-Za-z0-9]/.test(ch);\n\n/**\n * Simplified CommonMark flanking rules — without these, whitespace-flanked\n * delimiters pair up (\"3 * 4 * 5\" would italicize \" 4 \") and intraword\n * underscores become emphasis (\"user_id and account_id\" would italicize\n * \"id and account\" and delete the underscores). Both are silent data\n * corruption for ordinary spreadsheet content, so:\n *   - a delimiter can OPEN emphasis only if not followed by whitespace/end\n *   - a delimiter can CLOSE emphasis only if not preceded by whitespace/start\n *   - `_`/`__` additionally can never open after, or close before, a word\n *     character (intraword underscores are literal, per CommonMark)\n * Intraword `*` is intentionally still allowed (`a*b*c` emphasizes `b`),\n * matching CommonMark.\n */\nfunction delimiterFlanking(_kind: EmphasisKind, raw: string, prev: string | undefined, next: string | undefined): { canOpen: boolean; canClose: boolean } {\n  const underscore = raw.startsWith('_');\n  const canOpen = !isWhitespaceOrEdge(next) && !(underscore && isWordChar(prev));\n  const canClose = !isWhitespaceOrEdge(prev) && !(underscore && isWordChar(next));\n  return { canOpen, canClose };\n}\n\n/**\n * Scans the raw markdown left-to-right into a flat token stream: literal text\n * runs, resolved links (markdown-link or bare-URL), and emphasis delimiters.\n * Emphasis delimiters are emitted as opaque tokens here — whether a given\n * delimiter is an opener, a closer, or unmatched (and thus literal) is decided\n * in a second pass, since that requires seeing the whole stream.\n */\nfunction tokenize(markdown: string): Token[] {\n  const tokens: Token[] = [];\n  let buffer = '';\n  const flush = () => {\n    if (buffer) {\n      tokens.push({ type: 'text', value: buffer });\n      buffer = '';\n    }\n  };\n\n  let i = 0;\n  while (i < markdown.length) {\n    const ch = markdown[i] as string;\n    const next = markdown[i + 1];\n\n    // Backslash escapes: \\* \\_ \\~ \\[ \\] \\( \\) \\\\  -> literal char, never treated as syntax.\n    if (ch === '\\\\' && next !== undefined && ESCAPABLE.has(next)) {\n      buffer += next;\n      i += 2;\n      continue;\n    }\n\n    // Markdown links: [label](url) — checked before bare URLs so the label wins.\n    const linkMatch = MD_LINK.exec(markdown.slice(i));\n    if (linkMatch) {\n      flush();\n      const rawLabel = (linkMatch[1] ?? '').trim();\n      const uri = (linkMatch[2] ?? '').replace(/^<|>$/g, '');\n      tokens.push({ type: 'link', label: rawLabel.length > 0 ? rawLabel : uri, uri });\n      i += linkMatch[0].length;\n      continue;\n    }\n\n    // Bare http(s) URLs — the URL itself becomes the label.\n    if (ch === 'h') {\n      const bareMatch = BARE_URL.exec(markdown.slice(i));\n      if (bareMatch) {\n        flush();\n        const raw = bareMatch[0];\n        const uri = trimTrailingPunctuation(raw);\n        tokens.push({ type: 'link', label: uri, uri });\n        // Trailing punctuation trimmed off the URL is not part of the link — keep it as literal text.\n        if (uri.length < raw.length) buffer += raw.slice(uri.length);\n        i += raw.length;\n        continue;\n      }\n    }\n\n    // Emphasis delimiters — longest first: ** and __ (bold) and ~~ (strikethrough) before * and _ (italic).\n    // The delimiter's width is fixed BEFORE the flanking check: a ** that fails\n    // flanking is two literal asterisks, never reinterpreted as two * delimiters.\n    const two = markdown.slice(i, i + 2);\n    const kind: EmphasisKind | undefined = two === '**' || two === '__' ? 'bold' : two === '~~' ? 'strikethrough' : ch === '*' || ch === '_' ? 'italic' : undefined;\n    if (kind !== undefined) {\n      const raw = kind === 'italic' ? ch : two;\n      const { canOpen, canClose } = delimiterFlanking(kind, raw, markdown[i - 1], markdown[i + raw.length]);\n      if (canOpen || canClose) {\n        flush();\n        tokens.push({ type: 'delim', kind, raw, canOpen, canClose });\n      } else {\n        // Fails flanking on both sides — literal text (e.g. \" * \" or intraword \"_\").\n        buffer += raw;\n      }\n      i += raw.length;\n      continue;\n    }\n\n    buffer += ch;\n    i += 1;\n  }\n  flush();\n  return tokens;\n}\n\n// ---------------------------------------------------------------------------\n// Delimiter matching (unmatched delimiters degrade to literal text)\n// ---------------------------------------------------------------------------\n\n/** Matches emphasis delimiter tokens by kind using a simple open/close stack (assumes well-nested markdown). */\nfunction matchDelimiters(tokens: Token[]): Map<number, number> {\n  const stack: { kind: EmphasisKind; tokenIndex: number }[] = [];\n  const openerToCloser = new Map<number, number>();\n\n  tokens.forEach((token, index) => {\n    if (token.type !== 'delim') return;\n    const top = stack[stack.length - 1];\n    if (token.canClose && top && top.kind === token.kind) {\n      stack.pop();\n      openerToCloser.set(top.tokenIndex, index);\n    } else if (token.canOpen) {\n      stack.push({ kind: token.kind, tokenIndex: index });\n    }\n    // Can neither close the current context nor open — stays unmatched (literal).\n  });\n\n  // Anything left on the stack never closed — leave unmatched (rendered literally by the caller).\n  return openerToCloser;\n}\n\nconst FORMAT_FOR_KIND: Record<EmphasisKind, sheets_v4.Schema$TextFormat> = {\n  bold: { bold: true },\n  italic: { italic: true },\n  strikethrough: { strikethrough: true },\n};\n\n/** Walks the token stream, resolving matched delimiter pairs into spans and unmatched ones into literal text. */\nfunction buildTextAndSpans(tokens: Token[]): { text: string; spans: MarkdownSpan[] } {\n  const openerToCloser = matchDelimiters(tokens);\n  const closerToOpener = new Map<number, number>();\n  for (const [opener, closer] of openerToCloser) closerToOpener.set(closer, opener);\n\n  let text = '';\n  const spans: MarkdownSpan[] = [];\n  const openerStart = new Map<number, number>(); // opener token index -> plain-text start offset\n\n  tokens.forEach((token, index) => {\n    if (token.type === 'text') {\n      text += token.value;\n      return;\n    }\n\n    if (token.type === 'link') {\n      const start = text.length;\n      text += token.label;\n      spans.push({ start, end: text.length, format: { link: { uri: token.uri } } });\n      return;\n    }\n\n    // Emphasis delimiter token.\n    if (openerToCloser.has(index)) {\n      // Matched opener — record where its span begins; the delimiter itself is consumed (not emitted).\n      openerStart.set(index, text.length);\n      return;\n    }\n    const openerIndex = closerToOpener.get(index);\n    if (openerIndex !== undefined) {\n      // Matched closer — emit the span from the recorded opener position to here.\n      const start = openerStart.get(openerIndex);\n      if (start === undefined) {\n        throw new Error('markdown-runs: internal error — emphasis opener position was not recorded');\n      }\n      spans.push({ start, end: text.length, format: FORMAT_FOR_KIND[token.kind] });\n      return;\n    }\n    // Unmatched delimiter — no syntactic partner, so it degrades to its literal characters.\n    text += token.raw;\n  });\n\n  return { text, spans };\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/** Parses inline markdown into plain text plus formatting spans (see module docs for the supported subset). */\nexport function parseInlineMarkdown(markdown: string): ParsedMarkdown {\n  const tokens = tokenize(markdown);\n  const { text, spans } = buildTextAndSpans(tokens);\n  const linkCount = spans.filter((span) => span.format.link !== undefined).length;\n  return { text, spans, linkCount };\n}\n\n/**\n * Builds `textFormatRuns` from parsed markdown spans.\n *\n * Three Sheets API rules drive this, and are easy to get wrong:\n *   1. A run's format persists to the end of the string unless a later run\n *      resets it with an empty `format: {}` — runs are NOT scoped to a range.\n *   2. A run must never be emitted at `startIndex === text.length`: a span\n *      that reaches the end of the string needs no \"turn it off\" run, because\n *      there's no text left for stray formatting to leak into.\n *   3. Runs must be listed in strictly increasing `startIndex` order, with no\n *      two runs sharing an index.\n *\n * The approach: collect every index where the set of \"active\" spans changes\n * (every span start, and every span end that isn't end-of-string), merge the\n * formats of all spans active at each such index into one run, then ensure\n * there is a run at index 0 — either a span already starts there, or an\n * explicit empty-format baseline is prepended so the cell doesn't inherit any\n * pre-existing rich text formatting.\n */\nexport function buildTextFormatRuns(parsed: ParsedMarkdown, styleLinks = true): sheets_v4.Schema$TextFormatRun[] {\n  const { text, spans } = parsed;\n  if (text.length === 0) return [];\n\n  const boundaries = new Set<number>();\n  for (const span of spans) {\n    boundaries.add(span.start);\n    if (span.end < text.length) boundaries.add(span.end);\n  }\n  const sortedBoundaries = [...boundaries].sort((a, b) => a - b);\n\n  const runs: sheets_v4.Schema$TextFormatRun[] = sortedBoundaries.map((startIndex) => {\n    const format: sheets_v4.Schema$TextFormat = {};\n    for (const span of spans) {\n      if (span.start <= startIndex && startIndex < span.end) {\n        Object.assign(format, span.format);\n      }\n    }\n    if (styleLinks && format.link) {\n      format.underline = true;\n      format.foregroundColorStyle = { rgbColor: LINK_BLUE };\n    }\n    return { startIndex, format };\n  });\n\n  if (runs.length === 0 || runs[0]?.startIndex !== 0) {\n    runs.unshift({ startIndex: 0, format: {} });\n  }\n\n  return runs;\n}\n"],"names":["buildTextFormatRuns","parseInlineMarkdown","LINK_BLUE","red","green","blue","MD_LINK","BARE_URL","ESCAPABLE","Set","trimTrailingPunctuation","url","replace","isWhitespaceOrEdge","ch","undefined","test","isWordChar","delimiterFlanking","_kind","raw","prev","next","underscore","startsWith","canOpen","canClose","tokenize","markdown","tokens","buffer","flush","push","type","value","i","length","has","linkMatch","exec","slice","rawLabel","trim","uri","label","bareMatch","two","kind","matchDelimiters","stack","openerToCloser","Map","forEach","token","index","top","pop","set","tokenIndex","FORMAT_FOR_KIND","bold","italic","strikethrough","buildTextAndSpans","closerToOpener","opener","closer","text","spans","openerStart","start","end","format","link","openerIndex","get","Error","linkCount","filter","span","parsed","styleLinks","runs","boundaries","add","sortedBoundaries","sort","a","b","map","startIndex","Object","assign","underline","foregroundColorStyle","rgbColor","unshift"],"mappings":"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"}

package/dist/cjs/spreadsheet/sheet-operations.d.cts

@@ -1,4 +1,4 @@
-import type { sheets_v4 } from 'googleapis';
+import type { sheets_v4 } from '@googleapis/sheets';
 import type { Logger } from '../types.js';
 export declare function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string, sheetTitle: string, ensureSheet: boolean, headers: string[] | undefined, logger: Logger): Promise<{
     sheetCreated: boolean;

package/dist/cjs/spreadsheet/sheet-operations.d.ts

@@ -1,4 +1,4 @@
-import type { sheets_v4 } from 'googleapis';
+import type { sheets_v4 } from '@googleapis/sheets';
 import type { Logger } from '../types.js';
 export declare function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string, sheetTitle: string, ensureSheet: boolean, headers: string[] | undefined, logger: Logger): Promise<{
     sheetCreated: boolean;

package/dist/cjs/spreadsheet/sheet-operations.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/spreadsheet/sheet-operations.ts"],"sourcesContent":["import type { sheets_v4 } from 'googleapis';\nimport type { Logger } from '../types.ts';\nimport { a1Col } from './column-utilities.ts';\n\ntype ValueRange = sheets_v4.Schema$ValueRange;\n\nexport async function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string, sheetTitle: string, ensureSheet: boolean, headers: string[] | undefined, logger: Logger) {\n  if (!sheetTitle) return { sheetCreated: false };\n  const ssResp = await sheets.spreadsheets.get({ spreadsheetId: id });\n  const ss = ssResp.data;\n  const has = Array.isArray(ss?.sheets) && ss.sheets.some((s) => s?.properties?.title === sheetTitle);\n  if (has) {\n    const sid = ss.sheets?.find((s) => s?.properties?.title === sheetTitle)?.properties?.sheetId;\n    const result: { sheetCreated: boolean; sheetGUID?: string; headersEnsured?: boolean } = { sheetCreated: false };\n    if (sid != null) result.sheetGUID = String(sid);\n    if (headers) {\n      try {\n        const { header: merged } = await ensureTabAndHeaders(sheets, { spreadsheetId: id, sheetTitle, requiredHeader: headers, logger });\n        if (merged) result.headersEnsured = true;\n      } catch (e) {\n        logger.warn?.('ensureTabAndHeaders after sheet creation failed', e as Record<string, unknown>);\n      }\n    }\n    return result;\n  }\n  if (!ensureSheet) return { sheetCreated: false };\n\n  const res = await sheets.spreadsheets.batchUpdate({ spreadsheetId: id, requestBody: { requests: [{ addSheet: { properties: { title: sheetTitle } } }] } });\n  const createdId = res.data?.replies?.[0]?.addSheet?.properties?.sheetId;\n  const result: { sheetCreated: boolean; sheetGUID?: string; headersEnsured?: boolean } = { sheetCreated: !!createdId };\n  if (createdId != null) result.sheetGUID = String(createdId);\n  if (createdId && headers) {\n    try {\n      const { header: merged } = await ensureTabAndHeaders(sheets, { spreadsheetId: id, sheetTitle, requiredHeader: headers, logger });\n      if (merged) result.headersEnsured = true;\n    } catch (e) {\n      logger.warn?.('ensureTabAndHeaders after sheet creation failed', e as Record<string, unknown>);\n    }\n  }\n  return result;\n}\n\nexport async function findSheetByRef(client: sheets_v4.Sheets, spreadsheetId: string, sheetRef: string, logger: Logger) {\n  const ssResp = await client.spreadsheets.get({ spreadsheetId });\n  const sheets = ssResp.data?.sheets || [];\n  const trimmedRef = sheetRef?.trim();\n\n  logger.debug?.('findSheetByRef called', {\n    spreadsheetId,\n    sheetRef,\n    trimmedRef,\n    availableSheets: sheets.map((s) => ({\n      title: s?.properties?.title,\n      id: s?.properties?.sheetId,\n    })),\n  });\n\n  if (!trimmedRef) {\n    logger.warn?.('findSheetByRef empty sheetRef');\n    return null;\n  }\n\n  // Strategy 1: Try exact title match first (most common case)\n  const exactTitleMatch = sheets.find((s) => s?.properties?.title === trimmedRef);\n  if (exactTitleMatch) {\n    logger.debug?.('findSheetByRef exact title match found');\n    return exactTitleMatch;\n  }\n\n  // Strategy 2: Try exact GUID match (for when user passes actual sheet ID)\n  const exactGuidMatch = sheets.find((s) => String(s?.properties?.sheetId) === trimmedRef);\n  if (exactGuidMatch) {\n    logger.debug?.('findSheetByRef exact GUID match found');\n    return exactGuidMatch;\n  }\n\n  // Strategy 3: Case-insensitive title match\n  const caseInsensitiveMatch = sheets.find((s) => s?.properties?.title?.toLowerCase() === trimmedRef.toLowerCase());\n  if (caseInsensitiveMatch) {\n    logger.debug?.('findSheetByRef case-insensitive title match found');\n    return caseInsensitiveMatch;\n  }\n\n  // Strategy 4: Trimmed title match (handles extra whitespace in sheet names)\n  const trimmedTitleMatch = sheets.find((s) => s?.properties?.title?.trim() === trimmedRef);\n  if (trimmedTitleMatch) {\n    logger.debug?.('findSheetByRef trimmed title match found');\n    return trimmedTitleMatch;\n  }\n\n  // Strategy 5: Case-insensitive + trimmed title match\n  const caseInsensitiveTrimmedMatch = sheets.find((s) => s?.properties?.title?.trim().toLowerCase() === trimmedRef.toLowerCase());\n  if (caseInsensitiveTrimmedMatch) {\n    logger.debug?.('findSheetByRef case-insensitive trimmed title match found');\n    return caseInsensitiveTrimmedMatch;\n  }\n\n  // Strategy 6: Partial title match (last resort)\n  const partialMatch = sheets.find((s) => s?.properties?.title?.toLowerCase().includes(trimmedRef.toLowerCase()));\n  if (partialMatch) {\n    logger.debug?.('findSheetByRef partial title match found');\n    return partialMatch;\n  }\n\n  logger.warn?.('findSheetByRef no match found', {\n    searchRef: trimmedRef,\n    availableTitles: sheets.map((s) => s?.properties?.title),\n    availableIds: sheets.map((s) => s?.properties?.sheetId),\n  });\n  return null;\n}\n\n// Overloaded function signatures\nexport async function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetTitle: string; requiredHeader?: string[] | null; keyColumns?: string[]; logger: Logger }): Promise<{ header: string[]; keySet: Set<string>; keyColumnsIdx?: number[] }>;\n\nexport async function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetRef: string; requiredHeader?: string[] | null; keyColumns?: string[]; logger: Logger }): Promise<{ header: string[]; keySet: Set<string>; keyColumnsIdx?: number[] }>;\n\nexport async function ensureTabAndHeaders(\n  sheets: sheets_v4.Sheets,\n  {\n    spreadsheetId,\n    sheetTitle,\n    sheetRef,\n    requiredHeader = null as string[] | null,\n    keyColumns = ['id'] as string[],\n    logger,\n  }: {\n    spreadsheetId: string;\n    sheetTitle?: string;\n    sheetRef?: string;\n    requiredHeader?: string[] | null;\n    keyColumns?: string[];\n    logger: Logger;\n  }\n) {\n  if (!sheets) throw new Error('ensureTabAndHeaders: sheets is required');\n  if (!spreadsheetId) throw new Error('ensureTabAndHeaders: spreadsheetId is required');\n  if (!sheetTitle && !sheetRef) throw new Error('ensureTabAndHeaders: either sheetTitle or sheetRef is required');\n\n  // Resolve the actual sheet title from sheetRef if provided\n  let resolvedSheetTitle = sheetTitle;\n  if (sheetRef) {\n    const sheet = await findSheetByRef(sheets, spreadsheetId, sheetRef, logger);\n    if (sheet) {\n      resolvedSheetTitle = sheet.properties?.title || sheetRef;\n    } else {\n      // Sheet doesn't exist, use the sheetRef as the title for creation\n      resolvedSheetTitle = sheetRef;\n    }\n  }\n\n  if (!resolvedSheetTitle) throw new Error('ensureTabAndHeaders: could not resolve sheet title');\n\n  const defaultHeader = ['id', 'provider', 'threadId', 'to', 'from', 'cc', 'bcc', 'date', 'subject', 'labels', 'snippet', 'body'];\n  const header = Array.isArray(requiredHeader) && requiredHeader.length ? requiredHeader : defaultHeader;\n\n  let existingHeader: string[] | null = null;\n  try {\n    const resp = await sheets.spreadsheets.values.get({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, majorDimension: 'ROWS' });\n    const vr = resp.data as ValueRange;\n    const values = ((vr?.values || [])[0] || []) as string[];\n    existingHeader = values.length ? values : null;\n  } catch (_err: unknown) {\n    try {\n      await sheets.spreadsheets.batchUpdate({ spreadsheetId, requestBody: { requests: [{ addSheet: { properties: { title: resolvedSheetTitle } } }] } });\n    } catch {}\n    await sheets.spreadsheets.values.append({ spreadsheetId, range: `${resolvedSheetTitle}!A1`, valueInputOption: 'RAW', insertDataOption: 'INSERT_ROWS', requestBody: { values: [header] } });\n    return { header, keySet: new Set<string>() };\n  }\n\n  if (!existingHeader) {\n    await sheets.spreadsheets.values.append({ spreadsheetId, range: `${resolvedSheetTitle}!A1`, valueInputOption: 'RAW', insertDataOption: 'INSERT_ROWS', requestBody: { values: [header] } });\n    return { header, keySet: new Set<string>() };\n  }\n\n  const mergedHeader = existingHeader.slice();\n  for (const col of header) if (!mergedHeader.includes(col)) mergedHeader.push(col);\n\n  if (Array.isArray(keyColumns)) {\n    for (const name of keyColumns) {\n      if (typeof name !== 'string' || name.length === 0) throw new Error('ensureTabAndHeaders: keyColumns must be an array of non-empty strings');\n      if (!mergedHeader.includes(name)) mergedHeader.push(name);\n    }\n  }\n\n  if (mergedHeader.length !== existingHeader.length) {\n    await sheets.spreadsheets.values.update({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, valueInputOption: 'RAW', requestBody: { values: [mergedHeader] } });\n  }\n\n  const keySet = new Set<string>();\n  const chunkSize = 1000;\n  let startRow = 2;\n\n  const normalizeKeyColumnsByName = (kc: string[], hdr: string[]) => {\n    if (!Array.isArray(kc) || kc.length === 0) return [] as number[];\n    return kc.map((name) => {\n      if (typeof name !== 'string' || name.length === 0) return -1;\n      const idx = hdr.indexOf(name);\n      return Number.isInteger(idx) && idx >= 0 ? idx : -1;\n    });\n  };\n\n  const keyColsIdx = normalizeKeyColumnsByName(keyColumns, mergedHeader);\n  const validKeyIdxs = keyColsIdx.filter((i) => i >= 0);\n  if (validKeyIdxs.length === 0) return { header: mergedHeader, keySet: new Set<string>(), keyColumnsIdx: keyColsIdx };\n\n  const minIdx = Math.min(...validKeyIdxs);\n  const maxIdx = Math.max(...validKeyIdxs);\n  const startCol = a1Col(minIdx + 1);\n  const endCol = a1Col(maxIdx + 1);\n\n  while (true) {\n    const endRow = startRow + chunkSize - 1;\n    const range = `${resolvedSheetTitle}!${startCol}${startRow}:${endCol}${endRow}`;\n    const respChunk = await sheets.spreadsheets.values.get({ spreadsheetId, range, majorDimension: 'ROWS' });\n    const vrChunk = respChunk.data as ValueRange;\n    const chunkRows = (vrChunk?.values || []) as string[][];\n    if (!chunkRows || chunkRows.length === 0) break;\n    for (const r of chunkRows) {\n      const row = Array.isArray(r) ? r : [];\n\n      // Use the same key generation logic as appendRows for consistency\n      const lower = mergedHeader.map((h) => String(h ?? '').toLowerCase());\n      const provHeaderIdx = lower.indexOf('provider');\n      let idHeaderIdx = lower.indexOf('messageid');\n      if (idHeaderIdx === -1) idHeaderIdx = lower.indexOf('id');\n\n      let compositeKey: string;\n\n      if (provHeaderIdx >= 0 && idHeaderIdx >= 0) {\n        // Special case: if both provider and id columns exist, use them\n        const providerOffset = provHeaderIdx - minIdx;\n        const idOffset = idHeaderIdx - minIdx;\n        const providerVal = providerOffset >= 0 ? String(row[providerOffset] ?? '').trim() : '';\n        const messageVal = idOffset >= 0 ? String(row[idOffset] ?? '').trim() : '';\n        compositeKey = [providerVal, messageVal].join('\\\\');\n      } else {\n        // General case: use the specified key columns\n        const comps = keyColsIdx.map((i) => (i < 0 ? '' : String(row[i - minIdx] ?? '').trim()));\n        compositeKey = comps.join('\\\\');\n      }\n\n      if (compositeKey.replace(/\\\\+/g, '') !== '') keySet.add(compositeKey);\n    }\n    startRow += chunkRows.length;\n  }\n  return { header: mergedHeader, keySet, keyColumnsIdx: keyColsIdx };\n}\n"],"names":["ensureSheetIfNeeded","ensureTabAndHeaders","findSheetByRef","sheets","id","sheetTitle","ensureSheet","headers","logger","res","ssResp","ss","has","sid","result","merged","e","createdId","sheetCreated","spreadsheets","get","spreadsheetId","data","Array","isArray","some","s","properties","title","find","sheetId","sheetGUID","String","requiredHeader","header","headersEnsured","warn","batchUpdate","requestBody","requests","addSheet","replies","client","sheetRef","trimmedRef","exactTitleMatch","exactGuidMatch","caseInsensitiveMatch","trimmedTitleMatch","caseInsensitiveTrimmedMatch","partialMatch","trim","debug","availableSheets","map","toLowerCase","includes","searchRef","availableTitles","availableIds","keyColumns","Math","resolvedSheetTitle","sheet","defaultHeader","existingHeader","resp","vr","values","_err","mergedHeader","col","name","keySet","chunkSize","startRow","normalizeKeyColumnsByName","keyColsIdx","validKeyIdxs","minIdx","maxIdx","startCol","endCol","endRow","range","respChunk","vrChunk","chunkRows","Error","length","majorDimension","append","valueInputOption","insertDataOption","Set","slice","push","update","kc","hdr","idx","indexOf","Number","isInteger","filter","i","keyColumnsIdx","min","max","a1Col","r","row","lower","h","provHeaderIdx","idHeaderIdx","compositeKey","providerOffset","idOffset","providerVal","messageVal","join","comps","replace","add"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/spreadsheet/sheet-operations.ts"],"sourcesContent":["import type { sheets_v4 } from '@googleapis/sheets';\nimport type { Logger } from '../types.ts';\nimport { a1Col } from './column-utilities.ts';\n\ntype ValueRange = sheets_v4.Schema$ValueRange;\n\nexport async function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string, sheetTitle: string, ensureSheet: boolean, headers: string[] | undefined, logger: Logger) {\n  if (!sheetTitle) return { sheetCreated: false };\n  const ssResp = await sheets.spreadsheets.get({ spreadsheetId: id });\n  const ss = ssResp.data;\n  const has = Array.isArray(ss?.sheets) && ss.sheets.some((s) => s?.properties?.title === sheetTitle);\n  if (has) {\n    const sid = ss.sheets?.find((s) => s?.properties?.title === sheetTitle)?.properties?.sheetId;\n    const result: { sheetCreated: boolean; sheetGUID?: string; headersEnsured?: boolean } = { sheetCreated: false };\n    if (sid != null) result.sheetGUID = String(sid);\n    if (headers) {\n      try {\n        const { header: merged } = await ensureTabAndHeaders(sheets, { spreadsheetId: id, sheetTitle, requiredHeader: headers, logger });\n        if (merged) result.headersEnsured = true;\n      } catch (e) {\n        logger.warn?.('ensureTabAndHeaders after sheet creation failed', e as Record<string, unknown>);\n      }\n    }\n    return result;\n  }\n  if (!ensureSheet) return { sheetCreated: false };\n\n  const res = await sheets.spreadsheets.batchUpdate({ spreadsheetId: id, requestBody: { requests: [{ addSheet: { properties: { title: sheetTitle } } }] } });\n  const createdId = res.data?.replies?.[0]?.addSheet?.properties?.sheetId;\n  const result: { sheetCreated: boolean; sheetGUID?: string; headersEnsured?: boolean } = { sheetCreated: !!createdId };\n  if (createdId != null) result.sheetGUID = String(createdId);\n  if (createdId && headers) {\n    try {\n      const { header: merged } = await ensureTabAndHeaders(sheets, { spreadsheetId: id, sheetTitle, requiredHeader: headers, logger });\n      if (merged) result.headersEnsured = true;\n    } catch (e) {\n      logger.warn?.('ensureTabAndHeaders after sheet creation failed', e as Record<string, unknown>);\n    }\n  }\n  return result;\n}\n\nexport async function findSheetByRef(client: sheets_v4.Sheets, spreadsheetId: string, sheetRef: string, logger: Logger) {\n  const ssResp = await client.spreadsheets.get({ spreadsheetId });\n  const sheets = ssResp.data?.sheets || [];\n  const trimmedRef = sheetRef?.trim();\n\n  logger.debug?.('findSheetByRef called', {\n    spreadsheetId,\n    sheetRef,\n    trimmedRef,\n    availableSheets: sheets.map((s) => ({\n      title: s?.properties?.title,\n      id: s?.properties?.sheetId,\n    })),\n  });\n\n  if (!trimmedRef) {\n    logger.warn?.('findSheetByRef empty sheetRef');\n    return null;\n  }\n\n  // Strategy 1: Try exact title match first (most common case)\n  const exactTitleMatch = sheets.find((s) => s?.properties?.title === trimmedRef);\n  if (exactTitleMatch) {\n    logger.debug?.('findSheetByRef exact title match found');\n    return exactTitleMatch;\n  }\n\n  // Strategy 2: Try exact GUID match (for when user passes actual sheet ID)\n  const exactGuidMatch = sheets.find((s) => String(s?.properties?.sheetId) === trimmedRef);\n  if (exactGuidMatch) {\n    logger.debug?.('findSheetByRef exact GUID match found');\n    return exactGuidMatch;\n  }\n\n  // Strategy 3: Case-insensitive title match\n  const caseInsensitiveMatch = sheets.find((s) => s?.properties?.title?.toLowerCase() === trimmedRef.toLowerCase());\n  if (caseInsensitiveMatch) {\n    logger.debug?.('findSheetByRef case-insensitive title match found');\n    return caseInsensitiveMatch;\n  }\n\n  // Strategy 4: Trimmed title match (handles extra whitespace in sheet names)\n  const trimmedTitleMatch = sheets.find((s) => s?.properties?.title?.trim() === trimmedRef);\n  if (trimmedTitleMatch) {\n    logger.debug?.('findSheetByRef trimmed title match found');\n    return trimmedTitleMatch;\n  }\n\n  // Strategy 5: Case-insensitive + trimmed title match\n  const caseInsensitiveTrimmedMatch = sheets.find((s) => s?.properties?.title?.trim().toLowerCase() === trimmedRef.toLowerCase());\n  if (caseInsensitiveTrimmedMatch) {\n    logger.debug?.('findSheetByRef case-insensitive trimmed title match found');\n    return caseInsensitiveTrimmedMatch;\n  }\n\n  // Strategy 6: Partial title match (last resort)\n  const partialMatch = sheets.find((s) => s?.properties?.title?.toLowerCase().includes(trimmedRef.toLowerCase()));\n  if (partialMatch) {\n    logger.debug?.('findSheetByRef partial title match found');\n    return partialMatch;\n  }\n\n  logger.warn?.('findSheetByRef no match found', {\n    searchRef: trimmedRef,\n    availableTitles: sheets.map((s) => s?.properties?.title),\n    availableIds: sheets.map((s) => s?.properties?.sheetId),\n  });\n  return null;\n}\n\n// Overloaded function signatures\nexport async function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetTitle: string; requiredHeader?: string[] | null; keyColumns?: string[]; logger: Logger }): Promise<{ header: string[]; keySet: Set<string>; keyColumnsIdx?: number[] }>;\n\nexport async function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: { spreadsheetId: string; sheetRef: string; requiredHeader?: string[] | null; keyColumns?: string[]; logger: Logger }): Promise<{ header: string[]; keySet: Set<string>; keyColumnsIdx?: number[] }>;\n\nexport async function ensureTabAndHeaders(\n  sheets: sheets_v4.Sheets,\n  {\n    spreadsheetId,\n    sheetTitle,\n    sheetRef,\n    requiredHeader = null as string[] | null,\n    keyColumns = ['id'] as string[],\n    logger,\n  }: {\n    spreadsheetId: string;\n    sheetTitle?: string;\n    sheetRef?: string;\n    requiredHeader?: string[] | null;\n    keyColumns?: string[];\n    logger: Logger;\n  }\n) {\n  if (!sheets) throw new Error('ensureTabAndHeaders: sheets is required');\n  if (!spreadsheetId) throw new Error('ensureTabAndHeaders: spreadsheetId is required');\n  if (!sheetTitle && !sheetRef) throw new Error('ensureTabAndHeaders: either sheetTitle or sheetRef is required');\n\n  // Resolve the actual sheet title from sheetRef if provided\n  let resolvedSheetTitle = sheetTitle;\n  if (sheetRef) {\n    const sheet = await findSheetByRef(sheets, spreadsheetId, sheetRef, logger);\n    if (sheet) {\n      resolvedSheetTitle = sheet.properties?.title || sheetRef;\n    } else {\n      // Sheet doesn't exist, use the sheetRef as the title for creation\n      resolvedSheetTitle = sheetRef;\n    }\n  }\n\n  if (!resolvedSheetTitle) throw new Error('ensureTabAndHeaders: could not resolve sheet title');\n\n  const defaultHeader = ['id', 'provider', 'threadId', 'to', 'from', 'cc', 'bcc', 'date', 'subject', 'labels', 'snippet', 'body'];\n  const header = Array.isArray(requiredHeader) && requiredHeader.length ? requiredHeader : defaultHeader;\n\n  let existingHeader: string[] | null = null;\n  try {\n    const resp = await sheets.spreadsheets.values.get({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, majorDimension: 'ROWS' });\n    const vr = resp.data as ValueRange;\n    const values = ((vr?.values || [])[0] || []) as string[];\n    existingHeader = values.length ? values : null;\n  } catch (_err: unknown) {\n    try {\n      await sheets.spreadsheets.batchUpdate({ spreadsheetId, requestBody: { requests: [{ addSheet: { properties: { title: resolvedSheetTitle } } }] } });\n    } catch {}\n    await sheets.spreadsheets.values.append({ spreadsheetId, range: `${resolvedSheetTitle}!A1`, valueInputOption: 'RAW', insertDataOption: 'INSERT_ROWS', requestBody: { values: [header] } });\n    return { header, keySet: new Set<string>() };\n  }\n\n  if (!existingHeader) {\n    await sheets.spreadsheets.values.append({ spreadsheetId, range: `${resolvedSheetTitle}!A1`, valueInputOption: 'RAW', insertDataOption: 'INSERT_ROWS', requestBody: { values: [header] } });\n    return { header, keySet: new Set<string>() };\n  }\n\n  const mergedHeader = existingHeader.slice();\n  for (const col of header) if (!mergedHeader.includes(col)) mergedHeader.push(col);\n\n  if (Array.isArray(keyColumns)) {\n    for (const name of keyColumns) {\n      if (typeof name !== 'string' || name.length === 0) throw new Error('ensureTabAndHeaders: keyColumns must be an array of non-empty strings');\n      if (!mergedHeader.includes(name)) mergedHeader.push(name);\n    }\n  }\n\n  if (mergedHeader.length !== existingHeader.length) {\n    await sheets.spreadsheets.values.update({ spreadsheetId, range: `${resolvedSheetTitle}!1:1`, valueInputOption: 'RAW', requestBody: { values: [mergedHeader] } });\n  }\n\n  const keySet = new Set<string>();\n  const chunkSize = 1000;\n  let startRow = 2;\n\n  const normalizeKeyColumnsByName = (kc: string[], hdr: string[]) => {\n    if (!Array.isArray(kc) || kc.length === 0) return [] as number[];\n    return kc.map((name) => {\n      if (typeof name !== 'string' || name.length === 0) return -1;\n      const idx = hdr.indexOf(name);\n      return Number.isInteger(idx) && idx >= 0 ? idx : -1;\n    });\n  };\n\n  const keyColsIdx = normalizeKeyColumnsByName(keyColumns, mergedHeader);\n  const validKeyIdxs = keyColsIdx.filter((i) => i >= 0);\n  if (validKeyIdxs.length === 0) return { header: mergedHeader, keySet: new Set<string>(), keyColumnsIdx: keyColsIdx };\n\n  const minIdx = Math.min(...validKeyIdxs);\n  const maxIdx = Math.max(...validKeyIdxs);\n  const startCol = a1Col(minIdx + 1);\n  const endCol = a1Col(maxIdx + 1);\n\n  while (true) {\n    const endRow = startRow + chunkSize - 1;\n    const range = `${resolvedSheetTitle}!${startCol}${startRow}:${endCol}${endRow}`;\n    const respChunk = await sheets.spreadsheets.values.get({ spreadsheetId, range, majorDimension: 'ROWS' });\n    const vrChunk = respChunk.data as ValueRange;\n    const chunkRows = (vrChunk?.values || []) as string[][];\n    if (!chunkRows || chunkRows.length === 0) break;\n    for (const r of chunkRows) {\n      const row = Array.isArray(r) ? r : [];\n\n      // Use the same key generation logic as appendRows for consistency\n      const lower = mergedHeader.map((h) => String(h ?? '').toLowerCase());\n      const provHeaderIdx = lower.indexOf('provider');\n      let idHeaderIdx = lower.indexOf('messageid');\n      if (idHeaderIdx === -1) idHeaderIdx = lower.indexOf('id');\n\n      let compositeKey: string;\n\n      if (provHeaderIdx >= 0 && idHeaderIdx >= 0) {\n        // Special case: if both provider and id columns exist, use them\n        const providerOffset = provHeaderIdx - minIdx;\n        const idOffset = idHeaderIdx - minIdx;\n        const providerVal = providerOffset >= 0 ? String(row[providerOffset] ?? '').trim() : '';\n        const messageVal = idOffset >= 0 ? String(row[idOffset] ?? '').trim() : '';\n        compositeKey = [providerVal, messageVal].join('\\\\');\n      } else {\n        // General case: use the specified key columns\n        const comps = keyColsIdx.map((i) => (i < 0 ? '' : String(row[i - minIdx] ?? '').trim()));\n        compositeKey = comps.join('\\\\');\n      }\n\n      if (compositeKey.replace(/\\\\+/g, '') !== '') keySet.add(compositeKey);\n    }\n    startRow += chunkRows.length;\n  }\n  return { header: mergedHeader, keySet, keyColumnsIdx: keyColsIdx };\n}\n"],"names":["ensureSheetIfNeeded","ensureTabAndHeaders","findSheetByRef","sheets","id","sheetTitle","ensureSheet","headers","logger","res","ssResp","ss","has","sid","result","merged","e","createdId","sheetCreated","spreadsheets","get","spreadsheetId","data","Array","isArray","some","s","properties","title","find","sheetId","sheetGUID","String","requiredHeader","header","headersEnsured","warn","batchUpdate","requestBody","requests","addSheet","replies","client","sheetRef","trimmedRef","exactTitleMatch","exactGuidMatch","caseInsensitiveMatch","trimmedTitleMatch","caseInsensitiveTrimmedMatch","partialMatch","trim","debug","availableSheets","map","toLowerCase","includes","searchRef","availableTitles","availableIds","keyColumns","Math","resolvedSheetTitle","sheet","defaultHeader","existingHeader","resp","vr","values","_err","mergedHeader","col","name","keySet","chunkSize","startRow","normalizeKeyColumnsByName","keyColsIdx","validKeyIdxs","minIdx","maxIdx","startCol","endCol","endRow","range","respChunk","vrChunk","chunkRows","Error","length","majorDimension","append","valueInputOption","insertDataOption","Set","slice","push","update","kc","hdr","idx","indexOf","Number","isInteger","filter","i","keyColumnsIdx","min","max","a1Col","r","row","lower","h","provHeaderIdx","idHeaderIdx","compositeKey","providerOffset","idOffset","providerVal","messageVal","join","comps","replace","add"],"mappings":"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"}

package/dist/cjs/spreadsheet/spreadsheet-management.d.cts

@@ -1,4 +1,5 @@
-import type { drive_v3, sheets_v4 } from 'googleapis';
+import type { drive_v3 } from '@googleapis/drive';
+import type { sheets_v4 } from '@googleapis/sheets';
 export declare const SPREADSHEET_URL_RE: RegExp;
 export declare const SPREADSHEET_ID_RE: RegExp;
 export declare function findById(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, id: string): Promise<{

package/dist/cjs/spreadsheet/spreadsheet-management.d.ts

@@ -1,4 +1,5 @@
-import type { drive_v3, sheets_v4 } from 'googleapis';
+import type { drive_v3 } from '@googleapis/drive';
+import type { sheets_v4 } from '@googleapis/sheets';
 export declare const SPREADSHEET_URL_RE: RegExp;
 export declare const SPREADSHEET_ID_RE: RegExp;
 export declare function findById(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, id: string): Promise<{

package/dist/cjs/spreadsheet/spreadsheet-management.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/spreadsheet/spreadsheet-management.ts"],"sourcesContent":["import type { drive_v3, sheets_v4 } from 'googleapis';\nimport type { GoogleApiError } from '../types.ts';\n\nexport const SPREADSHEET_URL_RE = /https:\\/\\/docs.google.com\\/spreadsheets\\/d\\/([a-zA-Z0-9-_]{10,})/;\nexport const SPREADSHEET_ID_RE = /^[a-zA-Z0-9-_]{30,}$/;\n\nexport async function findById(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, id: string) {\n  const ssResp = await sheets.spreadsheets.get({ spreadsheetId: id }).catch((e: unknown) => {\n    const error = e as GoogleApiError;\n    const status = error?.response?.status || error?.status || error?.code;\n    if (Number(status) === 404) return null;\n    throw e;\n  });\n  const dmResp = await drive.files.get({ fileId: id, fields: 'modifiedTime,webViewLink,name' }).catch((e: unknown) => {\n    const error = e as GoogleApiError;\n    const status = error?.response?.status || error?.status || error?.code;\n    if (Number(status) === 404) return null;\n    throw e;\n  });\n  const dm = dmResp?.data;\n  if (!ssResp) return null;\n  const ss = ssResp.data;\n  return {\n    id: id,\n    spreadsheetTitle: ss?.properties?.title ?? dm?.name,\n    url: ss?.spreadsheetUrl ?? dm?.webViewLink,\n    modifiedTime: dm?.modifiedTime,\n  };\n}\n\nexport async function findByName(drive: drive_v3.Drive, name: string) {\n  const escaped = String(name).replace(/['\"\\\\]/g, (m) => `\\\\${m}`);\n  const q = `mimeType='application/vnd.google-apps.spreadsheet' and name contains '${escaped}' and trashed = false`;\n  const resp = await drive.files.list({ q, pageSize: 50, fields: 'files(id,name,webViewLink,modifiedTime)' });\n  const files = resp.data?.files || [];\n  return files.map((f) => ({ id: String(f.id), spreadsheetTitle: String(f.name), url: String(f.webViewLink), modifiedTime: f.modifiedTime }));\n}\n\nexport async function findSpreadsheetsByRef(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, ref: string) {\n  const trimmedRef = ref?.trim();\n  if (!trimmedRef) return [];\n\n  // Strategy 1: Try URL extraction (most specific)\n  const urlMatch = trimmedRef.match(SPREADSHEET_URL_RE);\n  if (urlMatch && typeof urlMatch[1] === 'string' && urlMatch[1].length > 0) {\n    const id = urlMatch[1];\n    const r = await findById(sheets, drive, id);\n    return r ? [r] : [];\n  }\n\n  // Strategy 2: Try direct ID match (if it looks like a spreadsheet ID)\n  if (SPREADSHEET_ID_RE.test(trimmedRef)) {\n    const r = await findById(sheets, drive, trimmedRef);\n    return r ? [r] : [];\n  }\n\n  // Strategy 3: Search by name\n  return await findByName(drive, trimmedRef);\n}\n"],"names":["SPREADSHEET_ID_RE","SPREADSHEET_URL_RE","findById","findByName","findSpreadsheetsByRef","sheets","drive","id","ss","ssResp","dmResp","dm","spreadsheets","get","spreadsheetId","catch","e","error","status","response","code","Number","files","fileId","fields","data","spreadsheetTitle","properties","title","name","url","spreadsheetUrl","webViewLink","modifiedTime","resp","escaped","q","String","replace","m","list","pageSize","map","f","ref","trimmedRef","urlMatch","r","trim","match","length","test"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/spreadsheet/spreadsheet-management.ts"],"sourcesContent":["import type { drive_v3 } from '@googleapis/drive';\nimport type { sheets_v4 } from '@googleapis/sheets';\nimport type { GoogleApiError } from '../types.ts';\n\nexport const SPREADSHEET_URL_RE = /https:\\/\\/docs.google.com\\/spreadsheets\\/d\\/([a-zA-Z0-9-_]{10,})/;\nexport const SPREADSHEET_ID_RE = /^[a-zA-Z0-9-_]{30,}$/;\n\nexport async function findById(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, id: string) {\n  const ssResp = await sheets.spreadsheets.get({ spreadsheetId: id }).catch((e: unknown) => {\n    const error = e as GoogleApiError;\n    const status = error?.response?.status || error?.status || error?.code;\n    if (Number(status) === 404) return null;\n    throw e;\n  });\n  const dmResp = await drive.files.get({ fileId: id, fields: 'modifiedTime,webViewLink,name' }).catch((e: unknown) => {\n    const error = e as GoogleApiError;\n    const status = error?.response?.status || error?.status || error?.code;\n    if (Number(status) === 404) return null;\n    throw e;\n  });\n  const dm = dmResp?.data;\n  if (!ssResp) return null;\n  const ss = ssResp.data;\n  return {\n    id: id,\n    spreadsheetTitle: ss?.properties?.title ?? dm?.name,\n    url: ss?.spreadsheetUrl ?? dm?.webViewLink,\n    modifiedTime: dm?.modifiedTime,\n  };\n}\n\nexport async function findByName(drive: drive_v3.Drive, name: string) {\n  const escaped = String(name).replace(/['\"\\\\]/g, (m) => `\\\\${m}`);\n  const q = `mimeType='application/vnd.google-apps.spreadsheet' and name contains '${escaped}' and trashed = false`;\n  const resp = await drive.files.list({ q, pageSize: 50, fields: 'files(id,name,webViewLink,modifiedTime)' });\n  const files = resp.data?.files || [];\n  return files.map((f) => ({ id: String(f.id), spreadsheetTitle: String(f.name), url: String(f.webViewLink), modifiedTime: f.modifiedTime }));\n}\n\nexport async function findSpreadsheetsByRef(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, ref: string) {\n  const trimmedRef = ref?.trim();\n  if (!trimmedRef) return [];\n\n  // Strategy 1: Try URL extraction (most specific)\n  const urlMatch = trimmedRef.match(SPREADSHEET_URL_RE);\n  if (urlMatch && typeof urlMatch[1] === 'string' && urlMatch[1].length > 0) {\n    const id = urlMatch[1];\n    const r = await findById(sheets, drive, id);\n    return r ? [r] : [];\n  }\n\n  // Strategy 2: Try direct ID match (if it looks like a spreadsheet ID)\n  if (SPREADSHEET_ID_RE.test(trimmedRef)) {\n    const r = await findById(sheets, drive, trimmedRef);\n    return r ? [r] : [];\n  }\n\n  // Strategy 3: Search by name\n  return await findByName(drive, trimmedRef);\n}\n"],"names":["SPREADSHEET_ID_RE","SPREADSHEET_URL_RE","findById","findByName","findSpreadsheetsByRef","sheets","drive","id","ss","ssResp","dmResp","dm","spreadsheets","get","spreadsheetId","catch","e","error","status","response","code","Number","files","fileId","fields","data","spreadsheetTitle","properties","title","name","url","spreadsheetUrl","webViewLink","modifiedTime","resp","escaped","q","String","replace","m","list","pageSize","map","f","ref","trimmedRef","urlMatch","r","trim","match","length","test"],"mappings":"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"}

package/dist/esm/index.js

@@ -8,7 +8,7 @@ import * as _setup from './setup/index.js';
 export { _setup as setup };
 export * from './types.js';
 export async function startServer(config) {
-    // createHTTPServer/createStdioServer pull in @modelcontextprotocol/sdk and every mcp/tools/*.ts
+    // createHTTPServer/createStdioServer pull in @mcp-z/server and every mcp/tools/*.ts
     // (googleapis included); deferred so a --version/--help run never reaches them.
     const { createHTTPServer } = await import('./setup/http.js');
     const { createStdioServer } = await import('./setup/stdio.js');

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/index.ts"],"sourcesContent":["import { handleVersionHelp } from './setup/version-help.ts';\nimport type { ServerConfig } from './types.ts';\n\nexport { GOOGLE_SCOPE } from './constants.ts';\nexport * as mcp from './mcp/index.ts';\nexport * as schemas from './schemas/index.ts';\nexport * as setup from './setup/index.ts';\nexport * from './types.ts';\n\nexport async function startServer(config: ServerConfig): Promise<void> {\n  // createHTTPServer/createStdioServer pull in @modelcontextprotocol/sdk and every mcp/tools/*.ts\n  // (googleapis included); deferred so a --version/--help run never reaches them.\n  const { createHTTPServer } = await import('./setup/http.ts');\n  const { createStdioServer } = await import('./setup/stdio.ts');\n  const { logger, close } = config.transport.type === 'stdio' ? await createStdioServer(config) : await createHTTPServer(config);\n\n  process.on('SIGINT', async () => {\n    await close();\n    process.exit(0);\n  });\n\n  logger.info(`Server started with ${config.transport.type} transport`);\n  await new Promise(() => {});\n}\n\nexport default async function main(): Promise<void> {\n  // Check for help/version flags FIRST, before config parsing\n  const versionHelpResult = handleVersionHelp(process.argv);\n  if (versionHelpResult.handled) {\n    console.log(versionHelpResult.output);\n    process.exit(0);\n  }\n\n  // Only parse config if no help/version flags. config.ts's own heavy imports (@mcp-z/oauth-google,\n  // @mcp-z/server) are deferred internally, so this static-looking call stays cheap until here.\n  const { createConfig } = await import('./setup/config.ts');\n  const config = createConfig();\n  await startServer(config);\n}\n\nif (process.argv[1] === new URL(import.meta.url).pathname) {\n  main();\n}\n"],"names":["handleVersionHelp","GOOGLE_SCOPE","mcp","schemas","setup","startServer","config","createHTTPServer","createStdioServer","logger","close","transport","type","process","on","exit","info","Promise","main","versionHelpResult","argv","handled","console","log","output","createConfig","URL","url","pathname"],"mappings":"AAAA,SAASA,iBAAiB,QAAQ,0BAA0B;AAG5D,SAASC,YAAY,QAAQ,iBAAiB;AAC9C,sBAAqB,iBAAiB;AAAtC,SAAO,QAAKC,GAAG,GAAuB;AACtC,0BAAyB,qBAAqB;AAA9C,SAAO,YAAKC,OAAO,GAA2B;AAC9C,wBAAuB,mBAAmB;AAA1C,SAAO,UAAKC,KAAK,GAAyB;AAC1C,cAAc,aAAa;AAE3B,OAAO,eAAeC,YAAYC,MAAoB;IACpD,gGAAgG;IAChG,gFAAgF;IAChF,MAAM,EAAEC,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC;IAC1C,MAAM,EAAEC,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC;IAC3C,MAAM,EAAEC,MAAM,EAAEC,KAAK,EAAE,GAAGJ,OAAOK,SAAS,CAACC,IAAI,KAAK,UAAU,MAAMJ,kBAAkBF,UAAU,MAAMC,iBAAiBD;IAEvHO,QAAQC,EAAE,CAAC,UAAU;QACnB,MAAMJ;QACNG,QAAQE,IAAI,CAAC;IACf;IAEAN,OAAOO,IAAI,CAAC,CAAC,oBAAoB,EAAEV,OAAOK,SAAS,CAACC,IAAI,CAAC,UAAU,CAAC;IACpE,MAAM,IAAIK,QAAQ,KAAO;AAC3B;AAEA,eAAe,eAAeC;IAC5B,4DAA4D;IAC5D,MAAMC,oBAAoBnB,kBAAkBa,QAAQO,IAAI;IACxD,IAAID,kBAAkBE,OAAO,EAAE;QAC7BC,QAAQC,GAAG,CAACJ,kBAAkBK,MAAM;QACpCX,QAAQE,IAAI,CAAC;IACf;IAEA,kGAAkG;IAClG,8FAA8F;IAC9F,MAAM,EAAEU,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC;IACtC,MAAMnB,SAASmB;IACf,MAAMpB,YAAYC;AACpB;AAEA,IAAIO,QAAQO,IAAI,CAAC,EAAE,KAAK,IAAIM,IAAI,YAAYC,GAAG,EAAEC,QAAQ,EAAE;IACzDV;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/index.ts"],"sourcesContent":["import { handleVersionHelp } from './setup/version-help.ts';\nimport type { ServerConfig } from './types.ts';\n\nexport { GOOGLE_SCOPE } from './constants.ts';\nexport * as mcp from './mcp/index.ts';\nexport * as schemas from './schemas/index.ts';\nexport * as setup from './setup/index.ts';\nexport * from './types.ts';\n\nexport async function startServer(config: ServerConfig): Promise<void> {\n  // createHTTPServer/createStdioServer pull in @mcp-z/server and every mcp/tools/*.ts\n  // (googleapis included); deferred so a --version/--help run never reaches them.\n  const { createHTTPServer } = await import('./setup/http.ts');\n  const { createStdioServer } = await import('./setup/stdio.ts');\n  const { logger, close } = config.transport.type === 'stdio' ? await createStdioServer(config) : await createHTTPServer(config);\n\n  process.on('SIGINT', async () => {\n    await close();\n    process.exit(0);\n  });\n\n  logger.info(`Server started with ${config.transport.type} transport`);\n  await new Promise(() => {});\n}\n\nexport default async function main(): Promise<void> {\n  // Check for help/version flags FIRST, before config parsing\n  const versionHelpResult = handleVersionHelp(process.argv);\n  if (versionHelpResult.handled) {\n    console.log(versionHelpResult.output);\n    process.exit(0);\n  }\n\n  // Only parse config if no help/version flags. config.ts's own heavy imports (@mcp-z/oauth-google,\n  // @mcp-z/server) are deferred internally, so this static-looking call stays cheap until here.\n  const { createConfig } = await import('./setup/config.ts');\n  const config = createConfig();\n  await startServer(config);\n}\n\nif (process.argv[1] === new URL(import.meta.url).pathname) {\n  main();\n}\n"],"names":["handleVersionHelp","GOOGLE_SCOPE","mcp","schemas","setup","startServer","config","createHTTPServer","createStdioServer","logger","close","transport","type","process","on","exit","info","Promise","main","versionHelpResult","argv","handled","console","log","output","createConfig","URL","url","pathname"],"mappings":"AAAA,SAASA,iBAAiB,QAAQ,0BAA0B;AAG5D,SAASC,YAAY,QAAQ,iBAAiB;AAC9C,sBAAqB,iBAAiB;AAAtC,SAAO,QAAKC,GAAG,GAAuB;AACtC,0BAAyB,qBAAqB;AAA9C,SAAO,YAAKC,OAAO,GAA2B;AAC9C,wBAAuB,mBAAmB;AAA1C,SAAO,UAAKC,KAAK,GAAyB;AAC1C,cAAc,aAAa;AAE3B,OAAO,eAAeC,YAAYC,MAAoB;IACpD,oFAAoF;IACpF,gFAAgF;IAChF,MAAM,EAAEC,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC;IAC1C,MAAM,EAAEC,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC;IAC3C,MAAM,EAAEC,MAAM,EAAEC,KAAK,EAAE,GAAGJ,OAAOK,SAAS,CAACC,IAAI,KAAK,UAAU,MAAMJ,kBAAkBF,UAAU,MAAMC,iBAAiBD;IAEvHO,QAAQC,EAAE,CAAC,UAAU;QACnB,MAAMJ;QACNG,QAAQE,IAAI,CAAC;IACf;IAEAN,OAAOO,IAAI,CAAC,CAAC,oBAAoB,EAAEV,OAAOK,SAAS,CAACC,IAAI,CAAC,UAAU,CAAC;IACpE,MAAM,IAAIK,QAAQ,KAAO;AAC3B;AAEA,eAAe,eAAeC;IAC5B,4DAA4D;IAC5D,MAAMC,oBAAoBnB,kBAAkBa,QAAQO,IAAI;IACxD,IAAID,kBAAkBE,OAAO,EAAE;QAC7BC,QAAQC,GAAG,CAACJ,kBAAkBK,MAAM;QACpCX,QAAQE,IAAI,CAAC;IACf;IAEA,kGAAkG;IAClG,8FAA8F;IAC9F,MAAM,EAAEU,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC;IACtC,MAAMnB,SAASmB;IACf,MAAMpB,YAAYC;AACpB;AAEA,IAAIO,QAAQO,IAAI,CAAC,EAAE,KAAK,IAAIM,IAAI,YAAYC,GAAG,EAAEC,QAAQ,EAAE;IACzDV;AACF"}

package/dist/esm/lib/google-auth.d.ts

@@ -0,0 +1,9 @@
+import { type GoogleAuthProvider } from '@mcp-z/oauth-google';
+/**
+ * A Google API client bound to this request's token provider.
+ *
+ * `@mcp-z/oauth-google` mints tokens and depends on no Google SDK, so the client
+ * is built here, from this package's own `googleapis`. That keeps one copy of
+ * `google-auth-library` in the tree by construction rather than by matching pins.
+ */
+export declare function googleAuth(auth: GoogleAuthProvider): import("google-auth-library").OAuth2Client;

package/dist/esm/lib/google-auth.js

@@ -0,0 +1,11 @@
+import { auth as googleAuthPlus } from '@googleapis/sheets';
+import { attachTokenProvider } from '@mcp-z/oauth-google';
+/**
+ * A Google API client bound to this request's token provider.
+ *
+ * `@mcp-z/oauth-google` mints tokens and depends on no Google SDK, so the client
+ * is built here, from this package's own `googleapis`. That keeps one copy of
+ * `google-auth-library` in the tree by construction rather than by matching pins.
+ */ export function googleAuth(auth) {
+    return attachTokenProvider(new googleAuthPlus.OAuth2(), auth);
+}

package/dist/esm/lib/google-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/lib/google-auth.ts"],"sourcesContent":["import { auth as googleAuthPlus } from '@googleapis/sheets';\nimport { attachTokenProvider, type GoogleAuthProvider } from '@mcp-z/oauth-google';\n\n/**\n * A Google API client bound to this request's token provider.\n *\n * `@mcp-z/oauth-google` mints tokens and depends on no Google SDK, so the client\n * is built here, from this package's own `googleapis`. That keeps one copy of\n * `google-auth-library` in the tree by construction rather than by matching pins.\n */\nexport function googleAuth(auth: GoogleAuthProvider) {\n  return attachTokenProvider(new googleAuthPlus.OAuth2(), auth);\n}\n"],"names":["auth","googleAuthPlus","attachTokenProvider","googleAuth","OAuth2"],"mappings":"AAAA,SAASA,QAAQC,cAAc,QAAQ,qBAAqB;AAC5D,SAASC,mBAAmB,QAAiC,sBAAsB;AAEnF;;;;;;CAMC,GACD,OAAO,SAASC,WAAWH,IAAwB;IACjD,OAAOE,oBAAoB,IAAID,eAAeG,MAAM,IAAIJ;AAC1D"}

package/dist/esm/mcp/prompts/a1-notation.d.ts

@@ -1,5 +1,4 @@
-import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
-import type { ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';
+import type { ServerContext } from '@mcp-z/server';
 export default function createPrompt(): {
     name: string;
     config: {
@@ -7,7 +6,7 @@ export default function createPrompt(): {
     };
     handler: (_args: {
         [x: string]: unknown;
-    }, _extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => Promise<{
+    }, _extra: ServerContext) => Promise<{
         messages: {
             role: "user";
             content: {

package/dist/esm/mcp/prompts/a1-notation.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/prompts/a1-notation.ts"],"sourcesContent":["import type { PromptModule } from '@mcp-z/server';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport type { ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';\n\nexport default function createPrompt() {\n  const config = {\n    description: 'Reference guide for Google Sheets A1 notation syntax',\n  };\n\n  const handler = async (_args: { [x: string]: unknown }, _extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => {\n    return {\n      messages: [\n        {\n          role: 'user' as const,\n          content: {\n            type: 'text' as const,\n            text: `# Google Sheets A1 Notation Reference\n\nA1 notation identifies cells and ranges in Google Sheets.\n\n## Cell References\n- \\`B5\\` - Single cell at column B, row 5\n- \\`A1\\` - Top-left cell\n\n## Range References\n- \\`A1:D10\\` - Rectangle from A1 to D10\n- \\`A5:D5\\` - Single row (columns A-D of row 5)\n- \\`B1:B10\\` - Single column segment (rows 1-10 of column B)\n\n## Full Row/Column References\n- \\`5:5\\` - Entire row 5\n- \\`B:B\\` - Entire column B\n- \\`A:D\\` - Columns A through D (all rows)\n- \\`1:10\\` - Rows 1 through 10 (all columns)\n\n## Common Patterns\n| Goal | Notation |\n|------|----------|\n| Get one cell | \\`B5\\` |\n| Get a row | \\`A5:Z5\\` or \\`5:5\\` |\n| Get a column | \\`B:B\\` or \\`B1:B1000\\` |\n| Get a data table | \\`A1:F100\\` |\n| Get headers | \\`1:1\\` or \\`A1:Z1\\` |`,\n          },\n        },\n      ],\n    };\n  };\n\n  return {\n    name: 'a1-notation',\n    config,\n    handler,\n  } satisfies PromptModule;\n}\n"],"names":["createPrompt","config","description","handler","_args","_extra","messages","role","content","type","text","name"],"mappings":"AAIA,eAAe,SAASA;IACtB,MAAMC,SAAS;QACbC,aAAa;IACf;IAEA,MAAMC,UAAU,OAAOC,OAAiCC;QACtD,OAAO;YACLC,UAAU;gBACR;oBACEC,MAAM;oBACNC,SAAS;wBACPC,MAAM;wBACNC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;sCA0BmB,CAAC;oBAC7B;gBACF;aACD;QACH;IACF;IAEA,OAAO;QACLC,MAAM;QACNV;QACAE;IACF;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/prompts/a1-notation.ts"],"sourcesContent":["import type { PromptModule, ServerContext } from '@mcp-z/server';\n\nexport default function createPrompt() {\n  const config = {\n    description: 'Reference guide for Google Sheets A1 notation syntax',\n  };\n\n  const handler = async (_args: { [x: string]: unknown }, _extra: ServerContext) => {\n    return {\n      messages: [\n        {\n          role: 'user' as const,\n          content: {\n            type: 'text' as const,\n            text: `# Google Sheets A1 Notation Reference\n\nA1 notation identifies cells and ranges in Google Sheets.\n\n## Cell References\n- \\`B5\\` - Single cell at column B, row 5\n- \\`A1\\` - Top-left cell\n\n## Range References\n- \\`A1:D10\\` - Rectangle from A1 to D10\n- \\`A5:D5\\` - Single row (columns A-D of row 5)\n- \\`B1:B10\\` - Single column segment (rows 1-10 of column B)\n\n## Full Row/Column References\n- \\`5:5\\` - Entire row 5\n- \\`B:B\\` - Entire column B\n- \\`A:D\\` - Columns A through D (all rows)\n- \\`1:10\\` - Rows 1 through 10 (all columns)\n\n## Common Patterns\n| Goal | Notation |\n|------|----------|\n| Get one cell | \\`B5\\` |\n| Get a row | \\`A5:Z5\\` or \\`5:5\\` |\n| Get a column | \\`B:B\\` or \\`B1:B1000\\` |\n| Get a data table | \\`A1:F100\\` |\n| Get headers | \\`1:1\\` or \\`A1:Z1\\` |`,\n          },\n        },\n      ],\n    };\n  };\n\n  return {\n    name: 'a1-notation',\n    config,\n    handler,\n  } satisfies PromptModule;\n}\n"],"names":["createPrompt","config","description","handler","_args","_extra","messages","role","content","type","text","name"],"mappings":"AAEA,eAAe,SAASA;IACtB,MAAMC,SAAS;QACbC,aAAa;IACf;IAEA,MAAMC,UAAU,OAAOC,OAAiCC;QACtD,OAAO;YACLC,UAAU;gBACR;oBACEC,MAAM;oBACNC,SAAS;wBACPC,MAAM;wBACNC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;sCA0BmB,CAAC;oBAC7B;gBACF;aACD;QACH;IACF;IAEA,OAAO;QACLC,MAAM;QACNV;QACAE;IACF;AACF"}

package/dist/esm/mcp/resources/spreadsheet.js

@@ -1,5 +1,6 @@
-import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { google } from 'googleapis';
+import { sheets as sheetsApi } from '@googleapis/sheets';
+import { ResourceTemplate } from '@mcp-z/server';
+import { googleAuth } from '../../lib/google-auth.js';
 export default function createResource() {
     const template = new ResourceTemplate('sheets://spreadsheets/{spreadsheetId}', {
         list: undefined
@@ -27,9 +28,9 @@ export default function createResource() {
             var _data_properties, _data_properties1;
             // Safe type guard to access middleware-enriched extra
             const { logger, authContext } = extra;
-            const sheets = google.sheets({
+            const sheets = sheetsApi({
                 version: 'v4',
-                auth: authContext.auth
+                auth: googleAuth(authContext.auth)
             });
             const resp = await sheets.spreadsheets.get({
                 spreadsheetId,

package/dist/esm/mcp/resources/spreadsheet.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/resources/spreadsheet.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport type { ResourceConfig, ResourceModule } from '@mcp-z/server';\nimport { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport type { ReadResourceResult, ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';\nimport { google, type sheets_v4 } from 'googleapis';\nimport type { GoogleApiError } from '../../types.ts';\n\nexport default function createResource(): ResourceModule {\n  const template = new ResourceTemplate('sheets://spreadsheets/{spreadsheetId}', { list: undefined });\n  const config: ResourceConfig = {\n    description: 'Sheets spreadsheet resource',\n    mimeType: 'application/json',\n  };\n\n  const handler = async (uri: URL, variables: Record<string, string | string[]>, extra: RequestHandlerExtra<ServerRequest, ServerNotification>): Promise<ReadResourceResult> => {\n    const spreadsheetId = Array.isArray(variables.spreadsheetId) ? variables.spreadsheetId[0] : variables.spreadsheetId;\n\n    if (!spreadsheetId) {\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({ error: 'spreadsheetId is required' }),\n          },\n        ],\n      };\n    }\n\n    try {\n      // Safe type guard to access middleware-enriched extra\n      const { logger, authContext } = extra as unknown as EnrichedExtra;\n      const sheets = google.sheets({ version: 'v4', auth: authContext.auth });\n      const resp = await sheets.spreadsheets.get({\n        spreadsheetId,\n        fields: 'spreadsheetId,properties.title,sheets.properties',\n      });\n      const data = resp.data as sheets_v4.Schema$Spreadsheet;\n      logger.info('sheets-spreadsheet resource fetch success', {\n        spreadsheetId: data.spreadsheetId,\n        title: data?.properties?.title,\n        sheetCount: (data?.sheets || []).length,\n      });\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              id: data?.spreadsheetId,\n              title: data?.properties?.title,\n              sheets: (data?.sheets || []).map((s) => ({\n                id: s?.properties?.sheetId,\n                title: s?.properties?.title,\n                rowCount: s?.properties?.gridProperties?.rowCount,\n                columnCount: s?.properties?.gridProperties?.columnCount,\n              })),\n            }),\n          },\n        ],\n      };\n    } catch (error) {\n      const { logger } = extra as unknown as EnrichedExtra;\n      logger.info('sheets-spreadsheet resource fetch failed', error as Record<string, unknown>);\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              error: String((error as GoogleApiError)?.message ?? error),\n            }),\n          },\n        ],\n      };\n    }\n  };\n\n  return {\n    name: 'spreadsheet',\n    template,\n    config,\n    handler,\n  };\n}\n"],"names":["ResourceTemplate","google","createResource","template","list","undefined","config","description","mimeType","handler","uri","variables","extra","spreadsheetId","Array","isArray","contents","href","text","JSON","stringify","error","data","logger","authContext","sheets","version","auth","resp","spreadsheets","get","fields","info","title","properties","sheetCount","length","id","map","s","sheetId","rowCount","gridProperties","columnCount","String","message","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/resources/spreadsheet.ts"],"sourcesContent":["import { type sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport type { ReadResourceResult, ResourceConfig, ResourceModule, ServerContext } from '@mcp-z/server';\nimport { ResourceTemplate } from '@mcp-z/server';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport type { GoogleApiError } from '../../types.ts';\n\nexport default function createResource(): ResourceModule {\n  const template = new ResourceTemplate('sheets://spreadsheets/{spreadsheetId}', { list: undefined });\n  const config: ResourceConfig = {\n    description: 'Sheets spreadsheet resource',\n    mimeType: 'application/json',\n  };\n\n  const handler = async (uri: URL, variables: Record<string, string | string[]>, extra: ServerContext): Promise<ReadResourceResult> => {\n    const spreadsheetId = Array.isArray(variables.spreadsheetId) ? variables.spreadsheetId[0] : variables.spreadsheetId;\n\n    if (!spreadsheetId) {\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({ error: 'spreadsheetId is required' }),\n          },\n        ],\n      };\n    }\n\n    try {\n      // Safe type guard to access middleware-enriched extra\n      const { logger, authContext } = extra as unknown as EnrichedExtra;\n      const sheets = sheetsApi({ version: 'v4', auth: googleAuth(authContext.auth) });\n      const resp = await sheets.spreadsheets.get({\n        spreadsheetId,\n        fields: 'spreadsheetId,properties.title,sheets.properties',\n      });\n      const data = resp.data as sheets_v4.Schema$Spreadsheet;\n      logger.info('sheets-spreadsheet resource fetch success', {\n        spreadsheetId: data.spreadsheetId,\n        title: data?.properties?.title,\n        sheetCount: (data?.sheets || []).length,\n      });\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              id: data?.spreadsheetId,\n              title: data?.properties?.title,\n              sheets: (data?.sheets || []).map((s) => ({\n                id: s?.properties?.sheetId,\n                title: s?.properties?.title,\n                rowCount: s?.properties?.gridProperties?.rowCount,\n                columnCount: s?.properties?.gridProperties?.columnCount,\n              })),\n            }),\n          },\n        ],\n      };\n    } catch (error) {\n      const { logger } = extra as unknown as EnrichedExtra;\n      logger.info('sheets-spreadsheet resource fetch failed', error as Record<string, unknown>);\n      return {\n        contents: [\n          {\n            uri: uri.href,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              error: String((error as GoogleApiError)?.message ?? error),\n            }),\n          },\n        ],\n      };\n    }\n  };\n\n  return {\n    name: 'spreadsheet',\n    template,\n    config,\n    handler,\n  };\n}\n"],"names":["sheets","sheetsApi","ResourceTemplate","googleAuth","createResource","template","list","undefined","config","description","mimeType","handler","uri","variables","extra","spreadsheetId","Array","isArray","contents","href","text","JSON","stringify","error","data","logger","authContext","version","auth","resp","spreadsheets","get","fields","info","title","properties","sheetCount","length","id","map","s","sheetId","rowCount","gridProperties","columnCount","String","message","name"],"mappings":"AAAA,SAAyBA,UAAUC,SAAS,QAAQ,qBAAqB;AAGzE,SAASC,gBAAgB,QAAQ,gBAAgB;AACjD,SAASC,UAAU,QAAQ,2BAA2B;AAGtD,eAAe,SAASC;IACtB,MAAMC,WAAW,IAAIH,iBAAiB,yCAAyC;QAAEI,MAAMC;IAAU;IACjG,MAAMC,SAAyB;QAC7BC,aAAa;QACbC,UAAU;IACZ;IAEA,MAAMC,UAAU,OAAOC,KAAUC,WAA8CC;QAC7E,MAAMC,gBAAgBC,MAAMC,OAAO,CAACJ,UAAUE,aAAa,IAAIF,UAAUE,aAAa,CAAC,EAAE,GAAGF,UAAUE,aAAa;QAEnH,IAAI,CAACA,eAAe;YAClB,OAAO;gBACLG,UAAU;oBACR;wBACEN,KAAKA,IAAIO,IAAI;wBACbT,UAAU;wBACVU,MAAMC,KAAKC,SAAS,CAAC;4BAAEC,OAAO;wBAA4B;oBAC5D;iBACD;YACH;QACF;QAEA,IAAI;gBAWOC,kBAUMA;YApBf,sDAAsD;YACtD,MAAM,EAAEC,MAAM,EAAEC,WAAW,EAAE,GAAGZ;YAChC,MAAMd,SAASC,UAAU;gBAAE0B,SAAS;gBAAMC,MAAMzB,WAAWuB,YAAYE,IAAI;YAAE;YAC7E,MAAMC,OAAO,MAAM7B,OAAO8B,YAAY,CAACC,GAAG,CAAC;gBACzChB;gBACAiB,QAAQ;YACV;YACA,MAAMR,OAAOK,KAAKL,IAAI;YACtBC,OAAOQ,IAAI,CAAC,6CAA6C;gBACvDlB,eAAeS,KAAKT,aAAa;gBACjCmB,KAAK,EAAEV,iBAAAA,4BAAAA,mBAAAA,KAAMW,UAAU,cAAhBX,uCAAAA,iBAAkBU,KAAK;gBAC9BE,YAAY,AAACZ,CAAAA,CAAAA,iBAAAA,2BAAAA,KAAMxB,MAAM,KAAI,EAAE,AAAD,EAAGqC,MAAM;YACzC;YACA,OAAO;gBACLnB,UAAU;oBACR;wBACEN,KAAKA,IAAIO,IAAI;wBACbT,UAAU;wBACVU,MAAMC,KAAKC,SAAS,CAAC;4BACnBgB,EAAE,EAAEd,iBAAAA,2BAAAA,KAAMT,aAAa;4BACvBmB,KAAK,EAAEV,iBAAAA,4BAAAA,oBAAAA,KAAMW,UAAU,cAAhBX,wCAAAA,kBAAkBU,KAAK;4BAC9BlC,QAAQ,AAACwB,CAAAA,CAAAA,iBAAAA,2BAAAA,KAAMxB,MAAM,KAAI,EAAE,AAAD,EAAGuC,GAAG,CAAC,CAACC;oCAC5BA,eACGA,gBACGA,8BAAAA,gBACGA,+BAAAA;uCAJ0B;oCACvCF,EAAE,EAAEE,cAAAA,yBAAAA,gBAAAA,EAAGL,UAAU,cAAbK,oCAAAA,cAAeC,OAAO;oCAC1BP,KAAK,EAAEM,cAAAA,yBAAAA,iBAAAA,EAAGL,UAAU,cAAbK,qCAAAA,eAAeN,KAAK;oCAC3BQ,QAAQ,EAAEF,cAAAA,yBAAAA,iBAAAA,EAAGL,UAAU,cAAbK,sCAAAA,+BAAAA,eAAeG,cAAc,cAA7BH,mDAAAA,6BAA+BE,QAAQ;oCACjDE,WAAW,EAAEJ,cAAAA,yBAAAA,iBAAAA,EAAGL,UAAU,cAAbK,sCAAAA,gCAAAA,eAAeG,cAAc,cAA7BH,oDAAAA,8BAA+BI,WAAW;gCACzD;;wBACF;oBACF;iBACD;YACH;QACF,EAAE,OAAOrB,OAAO;;YACd,MAAM,EAAEE,MAAM,EAAE,GAAGX;YACnBW,OAAOQ,IAAI,CAAC,4CAA4CV;YACxD,OAAO;gBACLL,UAAU;oBACR;wBACEN,KAAKA,IAAIO,IAAI;wBACbT,UAAU;wBACVU,MAAMC,KAAKC,SAAS,CAAC;4BACnBC,OAAOsB,eAAQtB,kBAAAA,4BAAD,AAACA,MAA0BuB,OAAO,uCAAIvB;wBACtD;oBACF;iBACD;YACH;QACF;IACF;IAEA,OAAO;QACLwB,MAAM;QACN1C;QACAG;QACAG;IACF;AACF"}

package/dist/esm/mcp/tools/cells-format.d.ts

@@ -1,5 +1,5 @@
 import type { EnrichedExtra } from '@mcp-z/oauth-google';
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { CallToolResult } from '@mcp-z/server';
 import { z } from 'zod';
 declare const inputSchema: z.ZodObject<{
     id: z.ZodString;

package/dist/esm/mcp/tools/cells-format.js

@@ -1,8 +1,9 @@
+import { sheets as sheetsApi } from '@googleapis/sheets';
 import { schemas } from '@mcp-z/oauth-google';
 const { AuthRequiredBranchSchema } = schemas;
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { google } from 'googleapis';
+import { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';
 import { z } from 'zod';
+import { googleAuth } from '../../lib/google-auth.js';
 import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
 import { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.js';
 // RGB color schema (0-1 range for Google Sheets API)
@@ -85,9 +86,9 @@ async function handler({ id, gid, requests }, extra) {
     try {
         var _sheet_properties_title, _sheet_properties_sheetId;
         var _spreadsheetResponse_data_sheets;
-        const sheets = google.sheets({
+        const sheets = sheetsApi({
             version: 'v4',
-            auth: extra.authContext.auth
+            auth: googleAuth(extra.authContext.auth)
         });
         // Get spreadsheet and sheet info in single API call
         const spreadsheetResponse = await sheets.spreadsheets.get({
@@ -105,7 +106,7 @@ async function handler({ id, gid, requests }, extra) {
                 gid,
                 requestCount: requests.length
             });
-            throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);
+            throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);
         }
         const 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).
@@ -275,7 +276,7 @@ async function handler({ id, gid, requests }, extra) {
             requestCount: requests.length,
             error: message
         });
-        throw new McpError(ErrorCode.InternalError, `Error formatting cells: ${message}`, {
+        throw new ProtocolError(ProtocolErrorCode.InternalError, `Error formatting cells: ${message}`, {
             stack: error instanceof Error ? error.stack : undefined
         });
     }

package/dist/esm/mcp/tools/cells-format.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-format.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, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// RGB color schema (0-1 range for Google Sheets API)\nconst ColorSchema = z.object({\n  red: z.number().min(0).max(1).describe('Red component (0-1)'),\n  green: z.number().min(0).max(1).describe('Green component (0-1)'),\n  blue: z.number().min(0).max(1).describe('Blue component (0-1)'),\n});\n\n// Number format schema\nconst NumberFormatSchema = z.object({\n  type: z.enum(['TEXT', 'NUMBER', 'PERCENT', 'CURRENCY', 'DATE', 'TIME']).describe('Number format type'),\n  pattern: z.string().optional().describe('Custom format pattern (e.g., \"$#,##0.00\" for currency)'),\n});\n\n// Border schema\nconst BorderSchema = z.object({\n  style: z.enum(['SOLID', 'DASHED', 'DOTTED']).describe('Border line style'),\n  color: ColorSchema.describe('Border color'),\n});\n\n// Input schema for format requests\nconst FormatRequestSchema = z.object({\n  range: z.string().min(1).describe('A1 notation range to format (e.g., \"A1:D10\", \"B:B\", \"5:5\")'),\n  backgroundColor: ColorSchema.optional().describe('Cell background color'),\n  textColor: ColorSchema.optional().describe('Text color'),\n  bold: z.boolean().optional().describe('Bold text'),\n  fontSize: z.number().int().min(6).max(36).optional().describe('Font size in points'),\n  horizontalAlignment: z.enum(['LEFT', 'CENTER', 'RIGHT']).optional().describe('Horizontal text alignment'),\n  numberFormat: NumberFormatSchema.optional().describe('Number format pattern'),\n  borders: BorderSchema.optional().describe('Cell borders'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  requests: z.array(FormatRequestSchema).min(1).max(50).describe('Array of formatting requests. Batch multiple ranges for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Title of the formatted sheet'),\n  sheetUrl: z.string().describe('URL of the formatted sheet'),\n  successCount: z.number().int().nonnegative().describe('Number of format requests successfully applied'),\n  failedRanges: z\n    .array(\n      z.object({\n        range: z.string().describe('A1 notation of range that failed'),\n        error: z.string().describe('Why formatting failed for this range'),\n      })\n    )\n    .optional()\n    .describe('Only populated if some ranges failed to format'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.cells.format called', {\n    id,\n    gid,\n    requestCount: requests.length,\n  });\n\n  try {\n    const sheets = 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: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for format cells', { id, gid, requestCount: requests.length });\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n    const sheetId = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n    // Build batch update requests\n    const batchRequests: sheets_v4.Schema$Request[] = [];\n    const failedRanges: Array<{ range: string; error: string }> = [];\n\n    for (const request of requests) {\n      try {\n        // Parse A1 notation to range reference\n        const rangeRef = parseA1Notation(request.range);\n\n        // Build grid range from range reference using helper function\n        const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n        // Build cell format object\n        const cellFormat: {\n          backgroundColor?: sheets_v4.Schema$Color;\n          textFormat?: sheets_v4.Schema$TextFormat;\n          horizontalAlignment?: string;\n          numberFormat?: sheets_v4.Schema$NumberFormat;\n        } = {};\n        const fields: string[] = [];\n\n        // Background color\n        if (request.backgroundColor) {\n          cellFormat.backgroundColor = request.backgroundColor;\n          fields.push('backgroundColor');\n        }\n\n        // Text format\n        if (request.textColor || request.bold !== undefined || request.fontSize !== undefined) {\n          cellFormat.textFormat = {};\n          if (request.textColor) {\n            cellFormat.textFormat.foregroundColor = request.textColor;\n            fields.push('textFormat.foregroundColor');\n          }\n          if (request.bold !== undefined) {\n            cellFormat.textFormat.bold = request.bold;\n            fields.push('textFormat.bold');\n          }\n          if (request.fontSize !== undefined) {\n            cellFormat.textFormat.fontSize = request.fontSize;\n            fields.push('textFormat.fontSize');\n          }\n        }\n\n        // Horizontal alignment\n        if (request.horizontalAlignment) {\n          cellFormat.horizontalAlignment = request.horizontalAlignment;\n          fields.push('horizontalAlignment');\n        }\n\n        // Number format\n        if (request.numberFormat) {\n          const numberFormat: sheets_v4.Schema$NumberFormat = {\n            type: request.numberFormat.type,\n          };\n          if (request.numberFormat.pattern !== undefined) {\n            numberFormat.pattern = request.numberFormat.pattern;\n          }\n          cellFormat.numberFormat = numberFormat;\n          fields.push('numberFormat');\n        }\n\n        // Add repeatCell request for this range\n        if (fields.length > 0) {\n          batchRequests.push({\n            repeatCell: {\n              range: gridRange,\n              cell: {\n                userEnteredFormat: cellFormat,\n              },\n              fields: `userEnteredFormat(${fields.join(',')})`,\n            },\n          });\n        }\n\n        // Add border formatting if specified\n        if (request.borders) {\n          batchRequests.push({\n            updateBorders: {\n              range: gridRange,\n              top: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              bottom: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              left: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              right: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n            },\n          });\n        }\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        logger.info('Failed to parse range for formatting', {\n          range: request.range,\n          error: message,\n        });\n        failedRanges.push({\n          range: request.range,\n          error: `Failed to parse range: ${message}`,\n        });\n      }\n    }\n\n    // Early return if all ranges failed\n    if (batchRequests.length === 0) {\n      const result: Output = {\n        type: 'success' as const,\n        id,\n        gid: String(sheetId),\n        sheetTitle,\n        sheetUrl,\n        successCount: 0,\n        failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n      };\n\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n        structuredContent: { result },\n      };\n    }\n\n    logger.info('sheets.cells.format executing batch request', {\n      spreadsheetId: id,\n      sheetTitle,\n      batchRequestsCount: batchRequests.length,\n    });\n\n    // Execute the batch update\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: batchRequests,\n      },\n    });\n\n    logger.info('sheets.cells.format completed successfully', {\n      successCount: requests.length - failedRanges.length,\n      failedCount: failedRanges.length,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      sheetTitle,\n      sheetUrl,\n      successCount: requests.length - failedRanges.length,\n      failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Format cells operation failed', {\n      id,\n      gid,\n      requestCount: requests.length,\n      error: message,\n    });\n\n    throw new McpError(ErrorCode.InternalError, `Error formatting cells: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'cells-format',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ColorSchema","object","red","number","min","max","describe","green","blue","NumberFormatSchema","type","enum","pattern","string","optional","BorderSchema","style","color","FormatRequestSchema","range","backgroundColor","textColor","bold","boolean","fontSize","int","horizontalAlignment","numberFormat","borders","inputSchema","id","gid","requests","array","successBranchSchema","literal","sheetTitle","sheetUrl","successCount","nonnegative","failedRanges","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","requestCount","length","sheet","spreadsheetResponse","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","batchRequests","request","rangeRef","gridRange","cellFormat","push","undefined","textFormat","foregroundColor","repeatCell","cell","userEnteredFormat","join","updateBorders","top","bottom","left","right","message","Error","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","createTool","name"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/mcp/tools/cells-format.ts"],"sourcesContent":["import { type sheets_v4, sheets as sheetsApi } from '@googleapis/sheets';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { CallToolResult, ToolModule } from '@mcp-z/server';\nimport { ProtocolError, ProtocolErrorCode } from '@mcp-z/server';\nimport { z } from 'zod';\nimport { googleAuth } from '../../lib/google-auth.ts';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.ts';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.ts';\n\n// RGB color schema (0-1 range for Google Sheets API)\nconst ColorSchema = z.object({\n  red: z.number().min(0).max(1).describe('Red component (0-1)'),\n  green: z.number().min(0).max(1).describe('Green component (0-1)'),\n  blue: z.number().min(0).max(1).describe('Blue component (0-1)'),\n});\n\n// Number format schema\nconst NumberFormatSchema = z.object({\n  type: z.enum(['TEXT', 'NUMBER', 'PERCENT', 'CURRENCY', 'DATE', 'TIME']).describe('Number format type'),\n  pattern: z.string().optional().describe('Custom format pattern (e.g., \"$#,##0.00\" for currency)'),\n});\n\n// Border schema\nconst BorderSchema = z.object({\n  style: z.enum(['SOLID', 'DASHED', 'DOTTED']).describe('Border line style'),\n  color: ColorSchema.describe('Border color'),\n});\n\n// Input schema for format requests\nconst FormatRequestSchema = z.object({\n  range: z.string().min(1).describe('A1 notation range to format (e.g., \"A1:D10\", \"B:B\", \"5:5\")'),\n  backgroundColor: ColorSchema.optional().describe('Cell background color'),\n  textColor: ColorSchema.optional().describe('Text color'),\n  bold: z.boolean().optional().describe('Bold text'),\n  fontSize: z.number().int().min(6).max(36).optional().describe('Font size in points'),\n  horizontalAlignment: z.enum(['LEFT', 'CENTER', 'RIGHT']).optional().describe('Horizontal text alignment'),\n  numberFormat: NumberFormatSchema.optional().describe('Number format pattern'),\n  borders: BorderSchema.optional().describe('Cell borders'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  requests: z.array(FormatRequestSchema).min(1).max(50).describe('Array of formatting requests. Batch multiple ranges for efficiency.'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetTitle: z.string().describe('Title of the formatted sheet'),\n  sheetUrl: z.string().describe('URL of the formatted sheet'),\n  successCount: z.number().int().nonnegative().describe('Number of format requests successfully applied'),\n  failedRanges: z\n    .array(\n      z.object({\n        range: z.string().describe('A1 notation of range that failed'),\n        error: z.string().describe('Why formatting failed for this range'),\n      })\n    )\n    .optional()\n    .describe('Only populated if some ranges failed to format'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Apply formatting (colors, borders, fonts, alignment, number formats) to cell ranges without modifying data. Supports batch operations for efficiency. Colors use 0-1 RGB format. Best for creating professional, visually organized spreadsheets.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, requests }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.cells.format called', {\n    id,\n    gid,\n    requestCount: requests.length,\n  });\n\n  try {\n    const sheets = sheetsApi({ version: 'v4', auth: googleAuth(extra.authContext.auth) });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    // Find sheet by gid\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for format cells', { id, gid, requestCount: requests.length });\n      throw new ProtocolError(ProtocolErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    // googleapis types sheetId as `number | null | undefined`; coerce for rangeReferenceToGridRange below (same pattern as values-batch-update.ts's sheetGid).\n    const sheetId = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`;\n\n    // Build batch update requests\n    const batchRequests: sheets_v4.Schema$Request[] = [];\n    const failedRanges: Array<{ range: string; error: string }> = [];\n\n    for (const request of requests) {\n      try {\n        // Parse A1 notation to range reference\n        const rangeRef = parseA1Notation(request.range);\n\n        // Build grid range from range reference using helper function\n        const gridRange = rangeReferenceToGridRange(rangeRef, sheetId);\n\n        // Build cell format object\n        const cellFormat: {\n          backgroundColor?: sheets_v4.Schema$Color;\n          textFormat?: sheets_v4.Schema$TextFormat;\n          horizontalAlignment?: string;\n          numberFormat?: sheets_v4.Schema$NumberFormat;\n        } = {};\n        const fields: string[] = [];\n\n        // Background color\n        if (request.backgroundColor) {\n          cellFormat.backgroundColor = request.backgroundColor;\n          fields.push('backgroundColor');\n        }\n\n        // Text format\n        if (request.textColor || request.bold !== undefined || request.fontSize !== undefined) {\n          cellFormat.textFormat = {};\n          if (request.textColor) {\n            cellFormat.textFormat.foregroundColor = request.textColor;\n            fields.push('textFormat.foregroundColor');\n          }\n          if (request.bold !== undefined) {\n            cellFormat.textFormat.bold = request.bold;\n            fields.push('textFormat.bold');\n          }\n          if (request.fontSize !== undefined) {\n            cellFormat.textFormat.fontSize = request.fontSize;\n            fields.push('textFormat.fontSize');\n          }\n        }\n\n        // Horizontal alignment\n        if (request.horizontalAlignment) {\n          cellFormat.horizontalAlignment = request.horizontalAlignment;\n          fields.push('horizontalAlignment');\n        }\n\n        // Number format\n        if (request.numberFormat) {\n          const numberFormat: sheets_v4.Schema$NumberFormat = {\n            type: request.numberFormat.type,\n          };\n          if (request.numberFormat.pattern !== undefined) {\n            numberFormat.pattern = request.numberFormat.pattern;\n          }\n          cellFormat.numberFormat = numberFormat;\n          fields.push('numberFormat');\n        }\n\n        // Add repeatCell request for this range\n        if (fields.length > 0) {\n          batchRequests.push({\n            repeatCell: {\n              range: gridRange,\n              cell: {\n                userEnteredFormat: cellFormat,\n              },\n              fields: `userEnteredFormat(${fields.join(',')})`,\n            },\n          });\n        }\n\n        // Add border formatting if specified\n        if (request.borders) {\n          batchRequests.push({\n            updateBorders: {\n              range: gridRange,\n              top: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              bottom: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              left: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n              right: {\n                style: request.borders.style,\n                color: request.borders.color,\n              },\n            },\n          });\n        }\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        logger.info('Failed to parse range for formatting', {\n          range: request.range,\n          error: message,\n        });\n        failedRanges.push({\n          range: request.range,\n          error: `Failed to parse range: ${message}`,\n        });\n      }\n    }\n\n    // Early return if all ranges failed\n    if (batchRequests.length === 0) {\n      const result: Output = {\n        type: 'success' as const,\n        id,\n        gid: String(sheetId),\n        sheetTitle,\n        sheetUrl,\n        successCount: 0,\n        failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n      };\n\n      return {\n        content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n        structuredContent: { result },\n      };\n    }\n\n    logger.info('sheets.cells.format executing batch request', {\n      spreadsheetId: id,\n      sheetTitle,\n      batchRequestsCount: batchRequests.length,\n    });\n\n    // Execute the batch update\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: batchRequests,\n      },\n    });\n\n    logger.info('sheets.cells.format completed successfully', {\n      successCount: requests.length - failedRanges.length,\n      failedCount: failedRanges.length,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetId),\n      sheetTitle,\n      sheetUrl,\n      successCount: requests.length - failedRanges.length,\n      failedRanges: failedRanges.length > 0 ? failedRanges : undefined,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('Format cells operation failed', {\n      id,\n      gid,\n      requestCount: requests.length,\n      error: message,\n    });\n\n    throw new ProtocolError(ProtocolErrorCode.InternalError, `Error formatting cells: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'cells-format',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["sheets","sheetsApi","schemas","AuthRequiredBranchSchema","ProtocolError","ProtocolErrorCode","z","googleAuth","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","ColorSchema","object","red","number","min","max","describe","green","blue","NumberFormatSchema","type","enum","pattern","string","optional","BorderSchema","style","color","FormatRequestSchema","range","backgroundColor","textColor","bold","boolean","fontSize","int","horizontalAlignment","numberFormat","borders","inputSchema","id","gid","requests","array","successBranchSchema","literal","sheetTitle","sheetUrl","successCount","nonnegative","failedRanges","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","requestCount","length","sheet","spreadsheetResponse","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","batchRequests","request","rangeRef","gridRange","cellFormat","push","undefined","textFormat","foregroundColor","repeatCell","cell","userEnteredFormat","join","updateBorders","top","bottom","left","right","message","Error","content","text","JSON","stringify","structuredContent","batchRequestsCount","batchUpdate","requestBody","failedCount","InternalError","stack","createTool","name"],"mappings":"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"}