graphein-mcp 0.19.0 → 0.21.0

package/README.md

@@ -47,6 +47,12 @@ npm install -g graphein-mcp   # then: graphein-mcp
 `dpr`, `repair` (default `true`), `repairLevel` (`'safe'` default; `'data'` explicitly
 permits data-aware authoring inference), and `quality`. Every type rasterizes — kpi, table, matrix, slicers and dashboard render
 a static canvas snapshot, so the whole catalog returns an image + report.
+`width`/`height` are limited to 1–8192 CSS pixels, `dpr` to 0.25–4, and the
+rasterized canvas to 67,108,864 pixels; invalid sizes return a structured tool
+error instead of allocating an unsafe canvas.
+CSV/TSV parsing keeps a column as strings unless every value converts losslessly,
+so leading-zero identifiers stay identifiers. Bundled resources are served only
+from the package's committed resource set.
 
 ### Opt-in presentation improvement
 

package/dist/{chunk-CODCFNDV.js → chunk-DNKOUF77.js}

@@ -28,14 +28,26 @@ function detectDelimiter(text2) {
   }
   return tab > comma ? "	" : ",";
 }
-function coerce(value) {
+function coerceLosslessNumber(value) {
   const trimmed = value.trim();
-  if (/^[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?$/.test(trimmed)) {
+  if (/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/.test(trimmed)) {
     const n = Number(trimmed);
     if (Number.isFinite(n)) return n;
   }
   return value;
 }
+function coerceColumns(records, headers) {
+  const columnsAsNumbers = headers.map(
+    (_, i) => records.every((record) => typeof coerceLosslessNumber(record[i].value) === "number")
+  );
+  return records.map((record) => {
+    const row = {};
+    for (let i = 0; i < headers.length; i++) {
+      row[headers[i]] = columnsAsNumbers[i] ? coerceLosslessNumber(record[i].value) : record[i].value;
+    }
+    return row;
+  });
+}
 function parseRecords(text2, delimiter) {
   const records = [];
   let record = [];
@@ -102,16 +114,15 @@ function parseTabularText(text2) {
   if (new Set(headers).size !== headers.length) {
     throw new TabularParseError("CSV/TSV header row must not contain duplicate column names.");
   }
-  return records.slice(1).map((record, rowIndex) => {
+  const dataRecords = records.slice(1);
+  for (const [rowIndex, record] of dataRecords.entries()) {
     if (record.length !== headers.length) {
       throw new TabularParseError(
         `Row ${rowIndex + 2} has ${record.length} cells, expected ${headers.length}.`
       );
     }
-    const row = {};
-    for (let i = 0; i < headers.length; i++) row[headers[i]] = coerce(record[i].value);
-    return row;
-  });
+  }
+  return coerceColumns(dataRecords, headers);
 }
 function parseInlineData(value) {
   if (Array.isArray(value)) return value.map(parseInlineData);
@@ -133,7 +144,7 @@ import {
   listChartTypes,
   summarize
 } from "graphein";
-import { NodeRenderError, renderChart } from "@graphein/node";
+import { NodeRenderError, renderChart, validateRenderImageOptions } from "@graphein/node";
 function text(value) {
   return { type: "text", text: value };
 }
@@ -162,6 +173,22 @@ function parseErrorResult(e, quality) {
     structuredContent: payload
   };
 }
+function optionErrorResult(e, quality) {
+  const payload = {
+    ok: false,
+    rendered: false,
+    stage: "options",
+    message: e instanceof Error ? e.message : String(e),
+    ...quality ? {
+      quality: draft(void 0, { repair: false, quality }).quality
+    } : {}
+  };
+  return {
+    isError: true,
+    content: [json(payload)],
+    structuredContent: payload
+  };
+}
 function specWithParsedData(spec) {
   return parseInlineData(spec);
 }
@@ -202,6 +229,11 @@ function critiqueChartHandler(args) {
 }
 function renderOrCritique(args, includeImage) {
   const { spec, width, height, dpr, repair = true, repairLevel, quality } = args;
+  try {
+    validateRenderImageOptions({ width, height, dpr });
+  } catch (e) {
+    return optionErrorResult(e, quality);
+  }
   let working;
   try {
     working = specWithParsedData(spec);
@@ -418,7 +450,11 @@ var RESOURCES = [
   }
 ];
 var cache = /* @__PURE__ */ new Map();
+var allowedResourceFiles = new Set(RESOURCES.map((r) => r.file));
 function readResourceFile(file) {
+  if (!allowedResourceFiles.has(file)) {
+    throw new Error(`Unknown Graphein MCP resource "${file}".`);
+  }
   const hit = cache.get(file);
   if (hit !== void 0) return hit;
   const url = new URL(`../resources/${file}`, import.meta.url);
@@ -432,8 +468,55 @@ function resourceByUri(uri) {
 
 // src/create-server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { RENDER_LIMITS } from "@graphein/node";
 import { z } from "zod";
-var VERSION = "0.3.0";
+
+// src/toolMetadata.ts
+var MCP_TOOL_METADATA = Object.freeze([
+  {
+    name: "render_chart",
+    title: "Render a Graphein chart",
+    description: "The one-call loop: validate a ChartSpec, auto-repair safe mistakes, render it to a PNG, and return the image plus a vision-free critique (render report, lint warnings, repairs applied). If the spec cannot be made valid, returns structured errors with JSON-Patch fixes instead of an image. Every type rasterizes headlessly \u2014 kpi, table, matrix, slicers and dashboard render static canvas snapshots."
+  },
+  {
+    name: "critique_chart",
+    title: "Critique a Graphein chart without an image",
+    description: "Validate a ChartSpec, auto-repair safe mistakes, render it headlessly, and return only the RenderReport, deterministic summary, lint warnings, and repairs applied \u2014 no base64 PNG. Use this when you need diagnostics but not an image."
+  },
+  {
+    name: "validate_chart",
+    title: "Validate a Graphein chart spec",
+    description: "Validate a ChartSpec without rendering. Returns structural errors (each with a JSON-Patch fix when unambiguous, plus did-you-mean suggestions) and best-practice lint warnings. Fast feedback before rendering."
+  },
+  {
+    name: "recommend_chart",
+    title: "Recommend Graphein chart specs",
+    description: "Profile tidy rows and return ranked ChartSpecs with rationale, profile evidence, alternatives, and explicit needs-decision/no-candidate findings. Use this before guessing a chart type or encoding; no supplied data is changed."
+  },
+  {
+    name: "repair_chart",
+    title: "Repair a Graphein chart spec",
+    description: `Apply Graphein repairs and return the corrected spec, JSON Patch ops, per-patch rationales, and whether it is now valid. The default safe level applies validator-provided fixes; level "data" may infer missing encodings and field-name typo fixes from the spec's own data.`
+  },
+  {
+    name: "list_chart_types",
+    title: "List Graphein chart types",
+    description: "Return every supported chart type with purpose, required channels/properties, field roles, aggregation semantics, cardinality guidance, supported features, and a minimal runnable starter. Use this before reading the full schema."
+  },
+  {
+    name: "summarize_chart",
+    title: "Summarize a Graphein chart",
+    description: `Return a deterministic, plain-English description of what the chart's data shows (e.g. "Users grew 46% over six months, peaking in June"). Doubles as alt-text; needs no LLM.`
+  }
+]);
+function mcpToolMetadata(name) {
+  const tool = MCP_TOOL_METADATA.find((item) => item.name === name);
+  if (!tool) throw new Error(`Unknown Graphein MCP tool: ${name}`);
+  return tool;
+}
+
+// src/create-server.ts
+var VERSION = "0.21.0";
 var SERVER_INSTRUCTIONS = `Graphein is an agent-first data-visualization library: you describe a chart as one JSON ChartSpec ({ type, data, encoding, ... }) and it renders. This server lets you build correct charts without prior knowledge of the API.
 
 Workflow:
@@ -462,21 +545,37 @@ var qualitySchema = z.union([
   "Opt in to bounded presentation-default improvement. Default false: one render. Never alters data, encodings, explicit palettes/domains, or other caller settings. Returns effectiveSpec and quality history. Mutable targets reserve a rollback pass."
 );
 var repairLevelSchema = z.enum(["safe", "data"]).optional().describe("Independent repair policy: safe (default), or explicitly opt in to data-aware field/encoding inference.");
+var widthSchema = z.number().min(RENDER_LIMITS.minWidth).max(RENDER_LIMITS.maxWidth).optional().describe(`Logical width in CSS px (default 800; ${RENDER_LIMITS.minWidth}-${RENDER_LIMITS.maxWidth}).`);
+var heightSchema = z.number().min(RENDER_LIMITS.minHeight).max(RENDER_LIMITS.maxHeight).optional().describe(`Logical height in CSS px (default 500; ${RENDER_LIMITS.minHeight}-${RENDER_LIMITS.maxHeight}).`);
+var dprSchema = z.number().min(RENDER_LIMITS.minDpr).max(RENDER_LIMITS.maxDpr).optional().describe(`Device pixel ratio for crisp output (default 2; ${RENDER_LIMITS.minDpr}-${RENDER_LIMITS.maxDpr}; total raster pixels capped at ${RENDER_LIMITS.maxPixels.toLocaleString("en-US")}).`);
+var toolOptions = (name) => {
+  const { title, description } = mcpToolMetadata(name);
+  return { title, description };
+};
 function createServer() {
   const server = new McpServer(
     { name: "graphein-mcp", version: VERSION },
     { instructions: SERVER_INSTRUCTIONS }
   );
+  registerTools(server);
+  registerResources(server);
+  registerCreateChartPrompt(server);
+  return server;
+}
+function registerTools(server) {
+  registerRenderTools(server);
+  registerSpecTools(server);
+}
+function registerRenderTools(server) {
   server.registerTool(
     "render_chart",
     {
-      title: "Render a Graphein chart",
-      description: "The one-call loop: validate a ChartSpec, auto-repair safe mistakes, render it to a PNG, and return the image plus a vision-free critique (render report, lint warnings, repairs applied). If the spec cannot be made valid, returns structured errors with JSON-Patch fixes instead of an image. Every type rasterizes headlessly \u2014 kpi, table, matrix, slicers and dashboard render static canvas snapshots.",
+      ...toolOptions("render_chart"),
       inputSchema: {
         spec: specSchema,
-        width: z.number().int().positive().optional().describe("Logical width in CSS px (default 800)."),
-        height: z.number().int().positive().optional().describe("Logical height in CSS px (default 500)."),
-        dpr: z.number().positive().optional().describe("Device pixel ratio for crisp output (default 2)."),
+        width: widthSchema,
+        height: heightSchema,
+        dpr: dprSchema,
         repair: z.boolean().optional().describe("Auto-apply safe repairs before rendering when the spec is invalid (default true)."),
         repairLevel: repairLevelSchema,
         quality: qualitySchema
@@ -487,13 +586,12 @@ function createServer() {
   server.registerTool(
     "critique_chart",
     {
-      title: "Critique a Graphein chart without an image",
-      description: "Validate a ChartSpec, auto-repair safe mistakes, render it headlessly, and return only the RenderReport, deterministic summary, lint warnings, and repairs applied \u2014 no base64 PNG. Use this when you need diagnostics but not an image.",
+      ...toolOptions("critique_chart"),
       inputSchema: {
         spec: specSchema,
-        width: z.number().int().positive().optional().describe("Logical width in CSS px (default 800)."),
-        height: z.number().int().positive().optional().describe("Logical height in CSS px (default 500)."),
-        dpr: z.number().positive().optional().describe("Device pixel ratio for layout parity (default 2)."),
+        width: widthSchema,
+        height: heightSchema,
+        dpr: dprSchema,
         repair: z.boolean().optional().describe("Auto-apply safe repairs before rendering when the spec is invalid (default true)."),
         repairLevel: repairLevelSchema,
         quality: qualitySchema
@@ -501,11 +599,12 @@ function createServer() {
     },
     async (args) => critiqueChartHandler(args)
   );
+}
+function registerSpecTools(server) {
   server.registerTool(
     "validate_chart",
     {
-      title: "Validate a Graphein chart spec",
-      description: 'Validate a ChartSpec without rendering. Returns structural errors (each with a JSON-Patch `fix` when unambiguous, plus "did you mean" suggestions) and best-practice lint warnings. Fast feedback before rendering.',
+      ...toolOptions("validate_chart"),
       inputSchema: { spec: specSchema }
     },
     async (args) => validateChartHandler(args)
@@ -513,8 +612,7 @@ function createServer() {
   server.registerTool(
     "recommend_chart",
     {
-      title: "Recommend Graphein chart specs",
-      description: "Profile tidy rows and return ranked ChartSpecs with rationale, profile evidence, alternatives, and explicit needs-decision/no-candidate findings. Use this before guessing a chart type or encoding; no supplied data is changed.",
+      ...toolOptions("recommend_chart"),
       inputSchema: {
         data: dataRowsSchema,
         intent: intentSchema,
@@ -530,8 +628,7 @@ function createServer() {
   server.registerTool(
     "repair_chart",
     {
-      title: "Repair a Graphein chart spec",
-      description: `Apply Graphein repairs and return the corrected spec, JSON Patch ops, per-patch rationales, and whether it is now valid. The default safe level applies validator-provided fixes; level "data" may infer missing encodings and field-name typo fixes from the spec's own data.`,
+      ...toolOptions("repair_chart"),
       inputSchema: {
         spec: specSchema,
         level: z.enum(["safe", "data"]).optional().describe('Repair aggressiveness. "safe" is default; "data" also infers from the spec data.')
@@ -542,8 +639,7 @@ function createServer() {
   server.registerTool(
     "list_chart_types",
     {
-      title: "List Graphein chart types",
-      description: "Return every supported chart type with purpose, required channels/properties, field roles, aggregation semantics, cardinality guidance, supported features, and a minimal runnable starter. Use this before reading the full schema.",
+      ...toolOptions("list_chart_types"),
       inputSchema: {}
     },
     async () => listChartTypesHandler()
@@ -551,12 +647,13 @@ function createServer() {
   server.registerTool(
     "summarize_chart",
     {
-      title: "Summarize a Graphein chart",
-      description: `Return a deterministic, plain-English description of what the chart's data shows (e.g. "Users grew 46% over six months, peaking in June"). Doubles as alt-text; needs no LLM.`,
+      ...toolOptions("summarize_chart"),
       inputSchema: { spec: specSchema }
     },
     async (args) => summarizeChartHandler(args)
   );
+}
+function registerResources(server) {
   for (const r of RESOURCES) {
     server.registerResource(
       r.name,
@@ -567,6 +664,8 @@ function createServer() {
       })
     );
   }
+}
+function registerCreateChartPrompt(server) {
   server.registerPrompt(
     "create_chart",
     {
@@ -601,7 +700,6 @@ Steps:
       ]
     })
   );
-  return server;
 }
 
 export {
@@ -621,4 +719,4 @@ export {
   VERSION,
   createServer
 };
-//# sourceMappingURL=chunk-CODCFNDV.js.map
+//# sourceMappingURL=chunk-DNKOUF77.js.map

package/dist/chunk-DNKOUF77.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tabular.ts","../src/handlers.ts","../src/resources.ts","../src/create-server.ts","../src/toolMetadata.ts"],"sourcesContent":["/** A tidy row parsed from CSV/TSV text. */\nexport type TabularRow = Record<string, number | string>;\n\n/** Error thrown when CSV/TSV text is malformed. */\nexport class TabularParseError extends Error {\n  /** Create a parse error with a human-readable message. */\n  constructor(message: string) {\n    super(message);\n    this.name = 'TabularParseError';\n  }\n}\n\ninterface Cell {\n  value: string;\n}\n\nfunction detectDelimiter(text: string): ',' | '\\t' {\n  let comma = 0;\n  let tab = 0;\n  let quoted = false;\n\n  for (let i = 0; i < text.length; i++) {\n    const ch = text[i];\n    if (ch === '\"') {\n      if (quoted && text[i + 1] === '\"') {\n        i++;\n      } else {\n        quoted = !quoted;\n      }\n    } else if (!quoted && (ch === '\\n' || ch === '\\r')) {\n      break;\n    } else if (!quoted && ch === ',') {\n      comma++;\n    } else if (!quoted && ch === '\\t') {\n      tab++;\n    }\n  }\n\n  return tab > comma ? '\\t' : ',';\n}\n\nfunction coerceLosslessNumber(value: string): number | string {\n  const trimmed = value.trim();\n  if (/^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$/.test(trimmed)) {\n    const n = Number(trimmed);\n    if (Number.isFinite(n)) return n;\n  }\n  return value;\n}\n\nfunction coerceColumns(records: Cell[][], headers: string[]): TabularRow[] {\n  const columnsAsNumbers = headers.map((_, i) =>\n    records.every((record) => typeof coerceLosslessNumber(record[i].value) === 'number'),\n  );\n  return records.map((record) => {\n    const row: TabularRow = {};\n    for (let i = 0; i < headers.length; i++) {\n      row[headers[i]] = columnsAsNumbers[i] ? coerceLosslessNumber(record[i].value) : record[i].value;\n    }\n    return row;\n  });\n}\n\nfunction parseRecords(text: string, delimiter: ',' | '\\t'): Cell[][] {\n  const records: Cell[][] = [];\n  let record: Cell[] = [];\n  let value = '';\n  let quoted = false;\n  let afterQuote = false;\n\n  const pushCell = () => {\n    record.push({ value });\n    value = '';\n    afterQuote = false;\n  };\n  const pushRecord = () => {\n    pushCell();\n    records.push(record);\n    record = [];\n  };\n\n  for (let i = 0; i < text.length; i++) {\n    const ch = text[i];\n\n    if (quoted) {\n      if (ch === '\"') {\n        if (text[i + 1] === '\"') {\n          value += '\"';\n          i++;\n        } else {\n          quoted = false;\n          afterQuote = true;\n        }\n      } else {\n        value += ch;\n      }\n      continue;\n    }\n\n    if (afterQuote && ch !== delimiter && ch !== '\\n' && ch !== '\\r') {\n      if (/\\s/.test(ch)) continue;\n      throw new TabularParseError(`Unexpected character '${ch}' after closing quote.`);\n    }\n\n    if (ch === '\"') {\n      if (value.length > 0) throw new TabularParseError('Unexpected quote in an unquoted field.');\n      quoted = true;\n    } else if (ch === delimiter) {\n      pushCell();\n    } else if (ch === '\\n') {\n      pushRecord();\n    } else if (ch === '\\r') {\n      pushRecord();\n      if (text[i + 1] === '\\n') i++;\n    } else {\n      value += ch;\n    }\n  }\n\n  if (quoted) throw new TabularParseError('Unclosed quoted field.');\n  if (value.length > 0 || record.length > 0 || text.endsWith(String(delimiter))) pushRecord();\n  return records.filter((r) => r.some((cell) => cell.value.length > 0));\n}\n\n/**\n * Parse CSV or TSV text with a header row into tidy data rows. Handles quoted\n * fields, escaped quotes, embedded delimiters, and embedded newlines.\n */\nexport function parseTabularText(text: string): TabularRow[] {\n  const trimmed = text.replace(/^\\uFEFF/, '');\n  const delimiter = detectDelimiter(trimmed);\n  const records = parseRecords(trimmed, delimiter);\n  if (records.length === 0) return [];\n\n  const headers = records[0].map((cell) => cell.value.trim());\n  if (headers.some((h) => h.length === 0)) {\n    throw new TabularParseError('CSV/TSV header row must not contain empty column names.');\n  }\n  if (new Set(headers).size !== headers.length) {\n    throw new TabularParseError('CSV/TSV header row must not contain duplicate column names.');\n  }\n\n  const dataRecords = records.slice(1);\n  for (const [rowIndex, record] of dataRecords.entries()) {\n    if (record.length !== headers.length) {\n      throw new TabularParseError(\n        `Row ${rowIndex + 2} has ${record.length} cells, expected ${headers.length}.`,\n      );\n    }\n  }\n  return coerceColumns(dataRecords, headers);\n}\n\n/**\n * Return a copy of a spec-like value with any `data: \"csv/tsv...\"` properties\n * parsed into tidy rows. Non-spec values are returned unchanged.\n */\nexport function parseInlineData(value: unknown): unknown {\n  if (Array.isArray(value)) return value.map(parseInlineData);\n  if (typeof value !== 'object' || value === null) return value;\n\n  const out: Record<string, unknown> = {};\n  for (const [key, child] of Object.entries(value)) {\n    out[key] = key === 'data' && typeof child === 'string' ? parseTabularText(child) : parseInlineData(child);\n  }\n  return out;\n}\n","/**\n * Pure tool handlers — the generate → validate → repair → render → critique loop\n * exposed as plain functions so they can be unit-tested without a transport. Each\n * returns MCP-shaped content (`text` and/or `image` blocks). `createServer` wires\n * these into the `McpServer`.\n *\n * The handlers wrap `graphein`'s self-validating / self-repairing / self-explaining\n * core (`validateSpec`, `repairSpec`, `summarize`) and `@graphein/node`'s headless\n * `renderChart`, so an agent gets the chart **plus** a vision-free critique in one\n * call — and a one-step repair when its spec is slightly wrong.\n */\nimport {\n  validateSpec,\n  draft,\n  repairSpec,\n  recommendChart,\n  profileData,\n  listChartTypes,\n  summarize,\n  type AnySpec,\n  type QualityOptions,\n  type RecommendOptions,\n  type RepairOptions,\n  type ValidationError,\n} from 'graphein';\nimport { NodeRenderError, renderChart, validateRenderImageOptions } from '@graphein/node';\nimport { parseInlineData, parseTabularText } from './tabular.js';\n\n/** A subset of MCP content blocks the handlers emit. */\nexport type McpContent =\n  | { type: 'text'; text: string }\n  | { type: 'image'; data: string; mimeType: string };\n\n/**\n * The shape every handler returns — assignable to the SDK's `CallToolResult`\n * (which is an open/passthrough type, hence the index signature).\n */\nexport interface ToolResult {\n  content: McpContent[];\n  structuredContent?: Record<string, unknown>;\n  isError?: boolean;\n  [key: string]: unknown;\n}\n\n/** Options accepted by {@link renderChartHandler}. */\nexport interface RenderArgs {\n  spec: unknown;\n  width?: number;\n  height?: number;\n  dpr?: number;\n  /** Auto-apply safe repairs before rendering when the spec is invalid. Default true. */\n  repair?: boolean;\n  /** Independent structural/data repair policy; defaults to safe. */\n  repairLevel?: RepairOptions['level'];\n  /** Opt-in presentation-default improvement, capped at three whole-visual renders. */\n  quality?: boolean | QualityOptions;\n}\n\n/** Options accepted by {@link critiqueChartHandler}. */\nexport type CritiqueArgs = RenderArgs;\n\nexport interface RecommendChartArgs {\n  data: Record<string, unknown>[] | string;\n  intent?: string;\n  maxResults?: number;\n  /** Layout guidance only; never filters/groups the supplied rows to fit. */\n  targetSize?: RecommendOptions['targetSize'];\n}\n\n/** Options accepted by {@link repairChartHandler}. */\nexport interface RepairChartArgs {\n  spec: unknown;\n  /** Repair level: safe fixes by default, or data-aware inference from inline rows. */\n  level?: RepairOptions['level'];\n}\n\nfunction text(value: string): McpContent {\n  return { type: 'text', text: value };\n}\n\nfunction json(value: unknown): McpContent {\n  return text(JSON.stringify(value, null, 2));\n}\n\nfunction specType(spec: unknown): string {\n  return typeof spec === 'object' && spec !== null && 'type' in spec\n    ? String((spec as { type: unknown }).type)\n    : '(missing)';\n}\n\nfunction isRecommendIntent(value: string | undefined): value is RecommendOptions['intent'] {\n  return (\n    value === undefined ||\n    value === 'trend' ||\n    value === 'comparison' ||\n    value === 'distribution' ||\n    value === 'relationship' ||\n    value === 'composition'\n  );\n}\n\nfunction parseErrorResult(e: unknown, quality?: RenderArgs['quality']): ToolResult {\n  const payload = {\n    ok: false,\n    stage: 'parse-data',\n    message: e instanceof Error ? e.message : String(e),\n    ...(quality ? {\n      rendered: false,\n      quality: draft(undefined, { repair: false, quality }).quality,\n    } : {}),\n  };\n  return {\n    isError: true, content: [json(payload)], structuredContent: payload,\n  };\n}\n\nfunction optionErrorResult(e: unknown, quality?: RenderArgs['quality']): ToolResult {\n  const payload = {\n    ok: false,\n    rendered: false,\n    stage: 'options',\n    message: e instanceof Error ? e.message : String(e),\n    ...(quality ? {\n      quality: draft(undefined, { repair: false, quality }).quality,\n    } : {}),\n  };\n  return {\n    isError: true, content: [json(payload)], structuredContent: payload,\n  };\n}\n\nfunction specWithParsedData(spec: unknown): unknown {\n  return parseInlineData(spec);\n}\n\nfunction rowsWithParsedData(data: RecommendChartArgs['data']): Record<string, unknown>[] {\n  return (typeof data === 'string' ? parseTabularText(data) : data) as Record<string, unknown>[];\n}\n\n/** Slim a validation error for an agent payload (drops nothing useful). */\nfunction tidyError(e: ValidationError) {\n  const out: Record<string, unknown> = { path: e.path, message: e.message };\n  if (e.rule) out.rule = e.rule;\n  if (e.severity) out.severity = e.severity;\n  if (e.fix) out.fix = e.fix;\n  if (e.suggestion) out.suggestion = e.suggestion;\n  if (e.evidence) out.evidence = e.evidence;\n  if (e.requiresDecision !== undefined) out.requiresDecision = e.requiresDecision;\n  return out;\n}\n\nfunction authoringMetadata(spec: AnySpec) {\n  const types = listChartTypes();\n  const capabilities = (type: AnySpec['type']) => types.find((t) => t.type === type)?.capabilities;\n  if (spec.type !== 'dashboard') {\n    return { profile: profileData(spec.data ?? []), capabilities: capabilities(spec.type) };\n  }\n  return {\n    ...(spec.data ? { profile: profileData(spec.data) } : {}),\n    capabilities: capabilities(spec.type),\n    views: spec.views.map((view) => ({\n      id: view.id,\n      capabilities: capabilities(view.spec.type),\n      ...(view.spec.data\n        ? { profile: profileData(view.spec.data) }\n        : { inheritsSharedData: true }),\n    })),\n  };\n}\n\n/**\n * **The flagship.** Validate a spec, auto-repair it if it's safely fixable, render\n * it to a PNG headless, and return the image alongside a machine-readable critique\n * (the render report + lint warnings + any repairs applied). When the spec can't be\n * made valid, returns the structured errors and JSON-Patch fixes instead of an image\n * so the agent corrects in one step rather than regenerating.\n */\nexport function renderChartHandler(args: RenderArgs): ToolResult {\n  return renderOrCritique(args, true);\n}\n\n/**\n * Validate, optionally repair, render, and return only the machine-readable\n * render report + summary. This avoids sending a base64 PNG when an agent only\n * needs diagnostics.\n */\nexport function critiqueChartHandler(args: CritiqueArgs): ToolResult {\n  return renderOrCritique(args, false);\n}\n\nfunction renderOrCritique(args: RenderArgs, includeImage: boolean): ToolResult {\n  const { spec, width, height, dpr, repair = true, repairLevel, quality } = args;\n  try {\n    validateRenderImageOptions({ width, height, dpr });\n  } catch (e) {\n    return optionErrorResult(e, quality);\n  }\n  let working: unknown;\n  try {\n    working = specWithParsedData(spec);\n  } catch (e) {\n    return parseErrorResult(e, quality);\n  }\n  const prepared = draft(working, { repair, repairLevel, quality });\n  const type = specType(prepared.spec);\n  if (!prepared.valid) {\n    const payload = {\n      ok: false, rendered: false, stage: 'validate', type,\n      errors: prepared.errors.map(tidyError),\n      lint: prepared.warnings.map(tidyError),\n      repairsApplied: prepared.patches,\n      repairDetails: prepared.repairs,\n      ...(quality ? { effectiveSpec: prepared.spec, quality: prepared.quality } : {}),\n      hint: `Apply each error.fix JSON Patch (or the repair_chart tool), then call ${includeImage ? 'render_chart' : 'critique_chart'} again. See the graphein://agent-guide and graphein://schema resources.`,\n    };\n    return {\n      isError: true, content: [json(payload)], structuredContent: payload,\n    };\n  }\n\n  try {\n    const rendered = renderChart(prepared.spec as AnySpec, { width, height, dpr, quality });\n    const { report } = rendered;\n    const payload = {\n      ok: report.ok, rendered: true, type,\n      pixelSize: { width: rendered.width, height: rendered.height },\n      summary: report.summary,\n      ...(includeImage ? {\n        marks: report.markCount, series: report.seriesCount, colors: report.colorCount,\n        diagnostics: report.diagnostics,\n      } : {}),\n      report,\n      lint: validateSpec(rendered.spec).warnings.map(tidyError),\n      repairsApplied: prepared.patches,\n      repairDetails: prepared.repairs,\n      ...(quality ? {\n        effectiveSpec: rendered.spec, quality: rendered.quality,\n        authoring: authoringMetadata(rendered.spec),\n      } : {}),\n    };\n    return {\n      isError: false,\n      content: [\n        ...(includeImage ? [{ type: 'image' as const, data: rendered.png.toString('base64'), mimeType: 'image/png' }] : []),\n        json(payload),\n      ],\n      structuredContent: payload,\n    };\n  } catch (e) {\n    const failed = e instanceof NodeRenderError ? e.result : undefined;\n    const payload = {\n      ok: false, rendered: false, stage: 'render', type,\n      message: e instanceof Error ? e.message : String(e),\n      summary: prepared.summary,\n      repairsApplied: prepared.patches,\n      repairDetails: prepared.repairs,\n      ...(quality ? {\n        effectiveSpec: failed?.spec ?? prepared.spec,\n        quality: failed?.quality ?? { ...prepared.quality, stopReason: 'render-failed' },\n      } : {}),\n    };\n    return {\n      isError: true, content: [json(payload)], structuredContent: payload,\n    };\n  }\n}\n\n/**\n * Validate a spec without rendering — fast structural + best-practice feedback.\n * Returns errors (each with a JSON-Patch `fix` when unambiguous and \"did you mean\"\n * suggestions) and lint `warnings`.\n */\nexport function validateChartHandler(args: { spec: unknown }): ToolResult {\n  let spec: unknown;\n  try {\n    spec = specWithParsedData(args.spec);\n  } catch (e) {\n    return parseErrorResult(e);\n  }\n  const result = validateSpec(spec);\n  return {\n    isError: false,\n    content: [\n      json({\n        valid: result.valid,\n        type: specType(spec),\n        errors: result.errors.map(tidyError),\n        warnings: result.warnings.map(tidyError),\n      }),\n    ],\n  };\n}\n\n/** Recommend ready-to-render ChartSpecs from tidy rows and an optional intent. */\nexport function recommendChartHandler(args: RecommendChartArgs): ToolResult {\n  if (!isRecommendIntent(args.intent)) {\n    return {\n      isError: true,\n      content: [\n        json({\n          ok: false,\n          message: 'Unsupported intent. Expected trend, comparison, distribution, relationship, or composition.',\n        }),\n      ],\n    };\n  }\n  let data: Record<string, unknown>[];\n  try {\n    data = rowsWithParsedData(args.data);\n  } catch (e) {\n    return parseErrorResult(e);\n  }\n  const recommendations = recommendChart(data, {\n    intent: args.intent, maxResults: args.maxResults, targetSize: args.targetSize, detailed: true,\n  });\n  const payload = { ok: true, ...recommendations };\n  return { isError: false, content: [json(payload)], structuredContent: payload };\n}\n\n/**\n * List every supported chart family with its purpose, required channels, and a\n * minimal runnable starter spec.\n */\nexport function listChartTypesHandler(): ToolResult {\n  const payload = { ok: true, chartTypes: listChartTypes() };\n  return { isError: false, content: [json(payload)], structuredContent: payload };\n}\n\n/**\n * Apply every safe, unambiguous repair Graphein proposes and return the corrected\n * spec, the JSON Patch operations applied, and whether it is now valid.\n */\nexport function repairChartHandler(args: RepairChartArgs): ToolResult {\n  let input: unknown;\n  try {\n    input = specWithParsedData(args.spec);\n  } catch (e) {\n    return parseErrorResult(e);\n  }\n  const { spec, applied, appliedDetails, remaining } = repairSpec(input, { level: args.level ?? 'safe' });\n  return {\n    isError: false,\n    content: [\n      json({\n        valid: remaining.length === 0,\n        level: args.level ?? 'safe',\n        applied,\n        appliedDetails,\n        remaining: remaining.map(tidyError),\n        spec,\n      }),\n    ],\n  };\n}\n\n/**\n * Return a deterministic, plain-English summary of what the chart's data shows —\n * doubles as alt-text, needs no LLM.\n */\nexport function summarizeChartHandler(args: { spec: unknown }): ToolResult {\n  let spec: unknown;\n  try {\n    spec = specWithParsedData(args.spec);\n  } catch (e) {\n    return parseErrorResult(e);\n  }\n  const result = validateSpec(spec);\n  if (!result.valid) {\n    return {\n      isError: true,\n      content: [\n        json({\n          summary: null,\n          reason: 'Spec is invalid; fix it first (validate_chart / repair_chart).',\n          errors: result.errors.map(tidyError),\n        }),\n      ],\n    };\n  }\n  const validSpec = spec as AnySpec;\n  const summary = validSpec.type === 'dashboard' ? undefined : summarize(validSpec);\n  return {\n    isError: false,\n    content: [\n      text(summary || `(No narrative summary is available for a '${specType(args.spec)}' chart.)`),\n    ],\n  };\n}\n","/**\n * The agent-facing knowledge Graphein serves as MCP **resources** — the schema\n * and the prose guides — so a model that has never seen Graphein's API can read\n * the contract at runtime instead of relying on training data. This is the core\n * of the MCP server's \"neutralize the training-data gap\" purpose.\n *\n * The files live in `../resources/` (committed copies of the repo's `docs/`, kept\n * in sync by `scripts/sync-resources.mjs`). They are read lazily and cached so the\n * server pays nothing until an agent actually asks for one.\n */\nimport { readFileSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\n\n/** Metadata describing one served resource. */\nexport interface GrapheinResource {\n  /** Short registration name. */\n  name: string;\n  /** Stable `graphein://…` URI an agent reads. */\n  uri: string;\n  /** Human title. */\n  title: string;\n  /** What the resource is and when to read it. */\n  description: string;\n  /** IANA media type. */\n  mimeType: string;\n  /** File under `resources/`. */\n  file: string;\n}\n\n/** Every resource the server exposes, in the order they should be advertised. */\nexport const RESOURCES: GrapheinResource[] = [\n  {\n    name: 'schema',\n    uri: 'graphein://schema',\n    title: 'Graphein ChartSpec JSON Schema',\n    description:\n      'The machine-readable JSON Schema for every Graphein ChartSpec and DashboardSpec field — chart types, channels, transforms, annotations, and required properties. Generate or check a spec against this.',\n    mimeType: 'application/json',\n    file: 'chart-spec.schema.json',\n  },\n  {\n    name: 'agent-guide',\n    uri: 'graphein://agent-guide',\n    title: 'Graphein Agent Guide',\n    description:\n      'A task-oriented guide for producing correct Graphein charts: the one-rule workflow, choosing a chart type, encodings, transforms, the validate → repair → render → critique loop, and worked recipes. Read this first.',\n    mimeType: 'text/markdown',\n    file: 'agent-guide.md',\n  },\n  {\n    name: 'spec-reference',\n    uri: 'graphein://spec-reference',\n    title: 'Graphein Spec Reference',\n    description:\n      'The exhaustive field-by-field reference for every chart type, channel, transform, annotation, and modifier. Consult this for the precise shape of a specific field.',\n    mimeType: 'text/markdown',\n    file: 'spec-reference.md',\n  },\n];\n\nconst cache = new Map<string, string>();\nconst allowedResourceFiles = new Set(RESOURCES.map((r) => r.file));\n\n/**\n * Read a bundled resource file's text, cached. Resolved relative to this module\n * so it works both from `dist/` (published) and `src/` (tests) — the committed\n * `resources/` dir always sits one level up from either.\n */\nexport function readResourceFile(file: string): string {\n  if (!allowedResourceFiles.has(file)) {\n    throw new Error(`Unknown Graphein MCP resource \"${file}\".`);\n  }\n  const hit = cache.get(file);\n  if (hit !== undefined) return hit;\n  const url = new URL(`../resources/${file}`, import.meta.url);\n  const text = readFileSync(fileURLToPath(url), 'utf8');\n  cache.set(file, text);\n  return text;\n}\n\n/** Look up a resource by its `graphein://…` URI. */\nexport function resourceByUri(uri: string): GrapheinResource | undefined {\n  return RESOURCES.find((r) => r.uri === uri);\n}\n","/**\n * `createServer()` — builds the Graphein MCP server: the generate → validate →\n * repair → render → critique loop as four tools, the schema + guides as resources,\n * and a `create_chart` prompt that teaches the workflow. Split from the stdio\n * entry point (`server.ts`) so it can be driven over any transport — including the\n * in-memory transport in tests.\n */\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { RENDER_LIMITS } from '@graphein/node';\nimport { z } from 'zod';\nimport {\n  critiqueChartHandler,\n  listChartTypesHandler,\n  renderChartHandler,\n  validateChartHandler,\n  repairChartHandler,\n  recommendChartHandler,\n  summarizeChartHandler,\n} from './handlers.js';\nimport { RESOURCES, readResourceFile } from './resources.js';\nimport { mcpToolMetadata } from './toolMetadata.js';\n\n/** Package version, surfaced as the MCP server version. */\nexport const VERSION = '0.21.0';\n\nconst SERVER_INSTRUCTIONS = `Graphein is an agent-first data-visualization library: you describe a chart as one JSON ChartSpec ({ type, data, encoding, ... }) and it renders. This server lets you build correct charts without prior knowledge of the API.\n\nWorkflow:\n1. Call list_chart_types to see every supported chart type with required channels, field roles, aggregation behavior, cardinality caveats, and starter specs; read graphein://agent-guide (and graphein://schema for exact fields) only when you need deeper detail.\n2. Shape data as tidy rows — one row per observation, one column per variable. Tools that accept rows also accept CSV/TSV text with a header row.\n3. Use recommend_chart when you want ranked specs from data, or start from a list_chart_types starter. Inspect profile, findings, and status: needs-decision/no-candidate are not permission to guess aggregation, date roles, missing values, or geometry.\n4. Emit a ChartSpec and call critique_chart for report-only diagnostics, or render_chart when you need the PNG plus critique. Both validate, auto-repair safe mistakes, render headlessly once by default, and return lint/report feedback. Opt in with quality:true for presentation-default improvements within three TOTAL whole-visual renders, including restoration. Read effectiveSpec, quality history and unresolved diagnostics; the loop never changes data or explicit settings.\n5. If a spec is invalid, validate_chart, critique_chart, and render_chart return structured errors with JSON-Patch fixes. Apply them or call repair_chart; use repair_chart level \"data\" to infer missing encodings or close field-name typos from the spec's own data.\nUse summarize_chart for deterministic alt-text. Every type rasterizes headlessly, including kpi, table, matrix, slicers and dashboard (static canvas snapshots).`;\n\n/** A permissive object schema for a Graphein spec — validateSpec does the real checking. */\nconst specSchema = z\n  .record(z.string(), z.unknown())\n  .describe(\n    'A Graphein ChartSpec or DashboardSpec object, e.g. { \"type\": \"line\", \"data\": [...], \"encoding\": {...} }. Any data property may be tidy rows or CSV/TSV text with a header row. See the graphein://schema and graphein://agent-guide resources.',\n  );\n\nconst dataRowsSchema = z.union([\n  z.array(z.record(z.string(), z.any())),\n  z.string().describe('CSV or TSV text with a header row; quoted delimiters, quotes, and newlines are supported.'),\n]);\n\nconst intentSchema = z\n  .enum(['trend', 'comparison', 'distribution', 'relationship', 'composition'])\n  .optional()\n  .describe(\n    'Optional analytical intent used to rank recommendations: trend, comparison, distribution, relationship, or composition.',\n  );\n\nconst qualitySchema = z.union([\n  z.boolean(),\n  z.object({\n    maxPasses: z.union([z.literal(1), z.literal(2), z.literal(3)]).optional()\n      .describe('Total whole-visual render ceiling including initial and rollback passes (default 3).'),\n  }).strict(),\n]).optional().describe(\n  'Opt in to bounded presentation-default improvement. Default false: one render. Never alters data, encodings, explicit palettes/domains, or other caller settings. Returns effectiveSpec and quality history. Mutable targets reserve a rollback pass.',\n);\n\nconst repairLevelSchema = z.enum(['safe', 'data']).optional()\n  .describe('Independent repair policy: safe (default), or explicitly opt in to data-aware field/encoding inference.');\nconst widthSchema = z.number().min(RENDER_LIMITS.minWidth).max(RENDER_LIMITS.maxWidth).optional()\n  .describe(`Logical width in CSS px (default 800; ${RENDER_LIMITS.minWidth}-${RENDER_LIMITS.maxWidth}).`);\nconst heightSchema = z.number().min(RENDER_LIMITS.minHeight).max(RENDER_LIMITS.maxHeight).optional()\n  .describe(`Logical height in CSS px (default 500; ${RENDER_LIMITS.minHeight}-${RENDER_LIMITS.maxHeight}).`);\nconst dprSchema = z.number().min(RENDER_LIMITS.minDpr).max(RENDER_LIMITS.maxDpr).optional()\n  .describe(`Device pixel ratio for crisp output (default 2; ${RENDER_LIMITS.minDpr}-${RENDER_LIMITS.maxDpr}; total raster pixels capped at ${RENDER_LIMITS.maxPixels.toLocaleString('en-US')}).`);\n\nconst toolOptions = (name: string): { title: string; description: string } => {\n  const { title, description } = mcpToolMetadata(name);\n  return { title, description };\n};\n\n/**\n * Build a fully-configured Graphein MCP server. The caller connects it to a\n * transport (`server.connect(transport)`).\n */\nexport function createServer(): McpServer {\n  const server = new McpServer(\n    { name: 'graphein-mcp', version: VERSION },\n    { instructions: SERVER_INSTRUCTIONS },\n  );\n  registerTools(server);\n  registerResources(server);\n  registerCreateChartPrompt(server);\n  return server;\n}\n\nfunction registerTools(server: McpServer): void {\n  // --- Tools: the runtime loop -------------------------------------------------\n  registerRenderTools(server);\n  registerSpecTools(server);\n}\n\nfunction registerRenderTools(server: McpServer): void {\n  server.registerTool(\n    'render_chart',\n    {\n      ...toolOptions('render_chart'),\n      inputSchema: {\n        spec: specSchema,\n        width: widthSchema,\n        height: heightSchema,\n        dpr: dprSchema,\n        repair: z\n          .boolean()\n          .optional()\n          .describe('Auto-apply safe repairs before rendering when the spec is invalid (default true).'),\n        repairLevel: repairLevelSchema,\n        quality: qualitySchema,\n      },\n    },\n    async (args) => renderChartHandler(args),\n  );\n\n  server.registerTool(\n    'critique_chart',\n    {\n      ...toolOptions('critique_chart'),\n      inputSchema: {\n        spec: specSchema,\n        width: widthSchema,\n        height: heightSchema,\n        dpr: dprSchema,\n        repair: z\n          .boolean()\n          .optional()\n          .describe('Auto-apply safe repairs before rendering when the spec is invalid (default true).'),\n        repairLevel: repairLevelSchema,\n        quality: qualitySchema,\n      },\n    },\n    async (args) => critiqueChartHandler(args),\n  );\n}\n\nfunction registerSpecTools(server: McpServer): void {\n  server.registerTool(\n    'validate_chart',\n    {\n      ...toolOptions('validate_chart'),\n      inputSchema: { spec: specSchema },\n    },\n    async (args) => validateChartHandler(args),\n  );\n\n  server.registerTool(\n    'recommend_chart',\n    {\n      ...toolOptions('recommend_chart'),\n      inputSchema: {\n        data: dataRowsSchema,\n        intent: intentSchema,\n        maxResults: z.number().int().positive().optional(),\n        targetSize: z.object({\n          width: z.number().positive(),\n          height: z.number().positive(),\n        }).optional().describe('Optional target CSS-pixel size for layout guidance only; does not filter or group data.'),\n      },\n    },\n    async (args) => recommendChartHandler(args),\n  );\n\n  server.registerTool(\n    'repair_chart',\n    {\n      ...toolOptions('repair_chart'),\n      inputSchema: {\n        spec: specSchema,\n        level: z\n          .enum(['safe', 'data'])\n          .optional()\n          .describe('Repair aggressiveness. \"safe\" is default; \"data\" also infers from the spec data.'),\n      },\n    },\n    async (args) => repairChartHandler(args),\n  );\n\n  server.registerTool(\n    'list_chart_types',\n    {\n      ...toolOptions('list_chart_types'),\n      inputSchema: {},\n    },\n    async () => listChartTypesHandler(),\n  );\n\n  server.registerTool(\n    'summarize_chart',\n    {\n      ...toolOptions('summarize_chart'),\n      inputSchema: { spec: specSchema },\n    },\n    async (args) => summarizeChartHandler(args),\n  );\n}\n\nfunction registerResources(server: McpServer): void {\n\n  // --- Resources: deliver the API knowledge at runtime -------------------------\n  for (const r of RESOURCES) {\n    server.registerResource(\n      r.name,\n      r.uri,\n      { title: r.title, description: r.description, mimeType: r.mimeType },\n      async (uri) => ({\n        contents: [{ uri: uri.href, mimeType: r.mimeType, text: readResourceFile(r.file) }],\n      }),\n    );\n  }\n}\n\nfunction registerCreateChartPrompt(server: McpServer): void {\n\n  // --- Prompt: teach the workflow ---------------------------------------------\n  server.registerPrompt(\n    'create_chart',\n    {\n      title: 'Create a Graphein chart',\n      description:\n        'Scaffold the workflow for building a validated Graphein chart from a goal (and optional data).',\n      argsSchema: {\n        goal: z.string().describe('What the chart should show, e.g. \"monthly active users over the last year\".'),\n        data: z\n          .string()\n          .optional()\n          .describe('Optional: the data as a JSON array, or a description of the columns available.'),\n      },\n    },\n    ({ goal, data }) => ({\n      messages: [\n        {\n          role: 'user',\n          content: {\n            type: 'text',\n            text: `Build a Graphein chart for this goal:\\n\\n${goal}\\n${\n              data ? `\\nData:\\n${data}\\n` : ''\n            }\\nSteps:\\n1. Call list_chart_types for available chart families and starter specs; read graphein://agent-guide or graphein://schema only for deeper details.\\n2. Shape the data as tidy rows — one row per observation, one column per variable. CSV/TSV text with a header row is accepted anywhere data rows are accepted.\\n3. Choose a chart type (or call recommend_chart) and write a single ChartSpec ({ type, data, encoding, title }).\\n4. Call critique_chart for report-only feedback or render_chart when you need the PNG too. Read the returned render report + lint to confirm it looks right.\\n5. If it reports errors, apply each error.fix patch (or call repair_chart, using level \"data\" when field/encoding inference from data is useful) and render again — do not regenerate from scratch.`,\n          },\n        },\n      ],\n    }),\n  );\n}\n","export interface McpToolMetadata {\n  readonly name: string;\n  readonly title: string;\n  readonly description: string;\n}\n\nexport const MCP_TOOL_METADATA = Object.freeze([\n  {\n    name: 'render_chart',\n    title: 'Render a Graphein chart',\n    description: 'The one-call loop: validate a ChartSpec, auto-repair safe mistakes, render it to a PNG, and return the image plus a vision-free critique (render report, lint warnings, repairs applied). If the spec cannot be made valid, returns structured errors with JSON-Patch fixes instead of an image. Every type rasterizes headlessly — kpi, table, matrix, slicers and dashboard render static canvas snapshots.',\n  },\n  {\n    name: 'critique_chart',\n    title: 'Critique a Graphein chart without an image',\n    description: 'Validate a ChartSpec, auto-repair safe mistakes, render it headlessly, and return only the RenderReport, deterministic summary, lint warnings, and repairs applied — no base64 PNG. Use this when you need diagnostics but not an image.',\n  },\n  {\n    name: 'validate_chart',\n    title: 'Validate a Graphein chart spec',\n    description: 'Validate a ChartSpec without rendering. Returns structural errors (each with a JSON-Patch fix when unambiguous, plus did-you-mean suggestions) and best-practice lint warnings. Fast feedback before rendering.',\n  },\n  {\n    name: 'recommend_chart',\n    title: 'Recommend Graphein chart specs',\n    description: 'Profile tidy rows and return ranked ChartSpecs with rationale, profile evidence, alternatives, and explicit needs-decision/no-candidate findings. Use this before guessing a chart type or encoding; no supplied data is changed.',\n  },\n  {\n    name: 'repair_chart',\n    title: 'Repair a Graphein chart spec',\n    description: 'Apply Graphein repairs and return the corrected spec, JSON Patch ops, per-patch rationales, and whether it is now valid. The default safe level applies validator-provided fixes; level \"data\" may infer missing encodings and field-name typo fixes from the spec\\'s own data.',\n  },\n  {\n    name: 'list_chart_types',\n    title: 'List Graphein chart types',\n    description: 'Return every supported chart type with purpose, required channels/properties, field roles, aggregation semantics, cardinality guidance, supported features, and a minimal runnable starter. Use this before reading the full schema.',\n  },\n  {\n    name: 'summarize_chart',\n    title: 'Summarize a Graphein chart',\n    description: 'Return a deterministic, plain-English description of what the chart\\'s data shows (e.g. \"Users grew 46% over six months, peaking in June\"). Doubles as alt-text; needs no LLM.',\n  },\n] satisfies readonly McpToolMetadata[]);\n\nexport function mcpToolMetadata(name: string): McpToolMetadata {\n  const tool = MCP_TOOL_METADATA.find((item) => item.name === name);\n  if (!tool) throw new Error(`Unknown Graphein MCP tool: ${name}`);\n  return tool;\n}\n"],"mappings":"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","names":["text","text"]}

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export { AnyRenderReport, AnySpec, ChartCapabilities, ChartSpec, DashboardRender
  */
 
 /** Package version, surfaced as the MCP server version. */
-declare const VERSION = "0.3.0";
+declare const VERSION = "0.21.0";
 /**
  * Build a fully-configured Graphein MCP server. The caller connects it to a
  * transport (`server.connect(transport)`).

package/dist/index.js

@@ -14,7 +14,7 @@ import {
   resourceByUri,
   summarizeChartHandler,
   validateChartHandler
-} from "./chunk-CODCFNDV.js";
+} from "./chunk-DNKOUF77.js";
 export {
   RESOURCES,
   TabularParseError,

package/dist/server.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   createServer
-} from "./chunk-CODCFNDV.js";
+} from "./chunk-DNKOUF77.js";
 
 // src/server.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphein-mcp",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "type": "module",
   "description": "Model Context Protocol server for Graphein — wraps generate → validate → repair → render → critique into one tool call, and serves Graphein's schema + agent guide as resources so a model that never saw the API can still build correct charts.",
   "license": "MIT",
@@ -52,18 +52,19 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup",
+    "sync:version": "node ../core/scripts/sync-version.mjs .",
+    "build": "npm run sync:version && tsup",
     "dev": "tsup --watch",
     "start": "node dist/server.js",
     "sync:resources": "node scripts/sync-resources.mjs",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
-    "prepack": "tsup"
+    "prepack": "npm run sync:version && tsup"
   },
   "dependencies": {
-    "@graphein/node": "^0.19.0",
+    "@graphein/node": "^0.21.0",
     "@modelcontextprotocol/sdk": "^1.20.0",
-    "graphein": "^0.19.0",
+    "graphein": "^0.21.0",
     "zod": "^3.23.0"
   }
 }

package/resources/agent-guide.md

@@ -88,6 +88,28 @@ mark** (cartesian charts plot rows as‑is); reach for `fold` instead of pre‑p
 filter in the spec so the same raw `data` can feed several views. Full field‑by‑field
 reference: [spec-reference → Transforms](./spec-reference.md#transforms).
 
+### Current semantics agents should rely on
+
+- Validation is total for JSON inputs: `validateSpec` / `validateDashboard` return errors
+  instead of throwing, shape-check nested encodings/scales/ValueRefs, flag unknown nested
+  properties with suggestions, and validate `calculate` length/depth/functions/arity,
+  filter leaves, bin params, and KPI/gauge/bullet aggregates before rendering. Repair
+  skips unsafe or unresolvable JSON Patch ops and rejects prototype paths.
+- One data classifier is shared by render, validate, lint, repair, profile, recommend and
+  insights. Numeric strings are numbers first (`"2019"` is quantitative), quantitative or
+  temporal inference needs at least 80% usable sampled values, calendar dates are strict,
+  and dot-path fields work in accessors and aggregate transforms.
+- Bare temporal strings use local time; `YYYY`, `YYYY-MM`, and date-only range bounds use
+  local calendar periods. A max bound like `"2024-01-31"` includes that whole day, and
+  dateRange slicers step by local calendar days across DST.
+- Selections compare temporal values by instant and publish raw row values. Heatmap and
+  calendarHeatmap picks keep `Date` objects; histogram picks publish interval/range
+  selections; multi-series cartesian dashboard picks publish `[x, series]` tuples.
+- Chart instances are lifecycle-safe: after `destroy()` mutations are no-ops and
+  `report()` returns the last report; `update()` re-runs transforms even after in-place
+  data mutation; DPR changes redraw; selection redraws are coalesced and flushed by
+  `report()` / `getSelection()`. `SelectionStore.batch(fn)` coalesces notifications.
+
 ## Picking a chart type
 
 | Goal | Use | Key channels |
@@ -111,6 +133,12 @@ reference: [spec-reference → Transforms](./spec-reference.md#transforms).
 | Running total / bridge | `waterfall` | `stage`, `value` (signed deltas) |
 | Before / after by series | `slope` | `x`, `y`, `series` |
 | Gap between two groups | `dumbbell` | `category`, `value`, `group` |
+| Profile across several measures | `radar` | `category` (spokes), `value`, optional `series` (+ `max?`) |
+| Schedule / timeline of tasks | `gantt` | `task`, `start`, `end` (+ `group?`, `progress?`) |
+| Nested part‑to‑whole in rings | `sunburst` | `value` (+ top‑level `levels`) |
+| Price action (open/high/low/close) | `candlestick` | `x`, `open`, `high`, `low`, `close` |
+| Sized points by coordinates | `bubbleMap` | `longitude`, `latitude` (+ `size?`, `color?`, `geo?`) |
+| Progress rings / polar area | `radialBar` | `category`, `value` (+ `max?`, `layout?`) |
 | Single number / headline metric | `kpi` | `value` (+ `label`, `delta`, `sparkline`, `comparisons`) |
 | Raw/detail records | `table` | `columns` (+ optional totals, groups, bars/icons/rules) |
 | Aggregated cross‑tab | `matrix` | `rows`, `columns`, `values` (+ `showAs` percentages) |
@@ -652,7 +680,11 @@ export gets a plain-text fallback, and `chart.report()` still reflects the real
 - **`encoding` is required** for `line`/`area`/`bar`/`scatter`/`box` (`x`+`y`), `pie`
   (`theta`+`color`), `heatmap` (`x`+`y`+`color`), `sankey` (`source`+`target`+`value`),
   and `choropleth` (`key`+`color`, plus a `geo` FeatureCollection). `kpi`/`table`/`matrix`
-  use their own field lists instead of `encoding`.
+  use their own field lists instead of `encoding`. `sunburst` needs a top‑level `levels`
+  array (innermost ring first) plus `encoding.value`; `bubbleMap` takes degrees in
+  `longitude`/`latitude` (never names — nothing is geocoded) with an optional `geo` basemap
+  and `projection` (`'albers'` for the United States); `gantt` annotations use `axis: 'x'`
+  for dates and `axis: 'y'` for task lanes.
 - **Field names must exist** in every `data` row (dotted paths like `a.b` read nested
   values).
 - **Don't pre‑pivot** for charts — pass tidy rows and split with `series`. Use `matrix`
@@ -868,7 +900,8 @@ await fs.writeFile('chart.png', png);
 ```
 
 It supports the entire catalog (line, area, bar, scatter, box, pie, heatmap, sankey,
-choropleth, combo, histogram, funnel, treemap, gauge, bullet, calendarHeatmap) **plus** the
+choropleth, combo, histogram, funnel, treemap, gauge, bullet, calendarHeatmap, waterfall,
+slope, dumbbell, radar, gantt, sunburst, candlestick, bubbleMap, radialBar) **plus** the
 formerly DOM-only kpi, table, matrix, slicers and dashboard — they paint a static canvas
 snapshot, so every type validates and rasterizes server-side. Core's dependency-free
 `renderToContext(target, spec)` paints onto any 2D context if you bring your own canvas