graphein-mcp 0.9.1 → 0.11.0

package/dist/{chunk-LBB3C2XH.js → chunk-PHH2HU3O.js}

@@ -2,6 +2,7 @@
 import {
   validateSpec,
   repairSpec,
+  recommendChart,
   summarize
 } from "graphein";
 import { renderChart } from "@graphein/node";
@@ -14,6 +15,9 @@ function json(value) {
 function specType(spec) {
   return typeof spec === "object" && spec !== null && "type" in spec ? String(spec.type) : "(missing)";
 }
+function isRecommendIntent(value) {
+  return value === void 0 || value === "trend" || value === "comparison" || value === "distribution" || value === "relationship" || value === "composition";
+}
 function tidyError(e) {
   const out = { path: e.path, message: e.message };
   if (e.rule) out.rule = e.rule;
@@ -109,6 +113,28 @@ function validateChartHandler(args) {
     ]
   };
 }
+function recommendChartHandler(args) {
+  if (!isRecommendIntent(args.intent)) {
+    return {
+      isError: true,
+      content: [
+        json({
+          ok: false,
+          message: "Unsupported intent. Expected trend, comparison, distribution, relationship, or composition."
+        })
+      ]
+    };
+  }
+  return {
+    isError: false,
+    content: [
+      json({
+        ok: true,
+        recommendations: recommendChart(args.data, { intent: args.intent, maxResults: args.maxResults })
+      })
+    ]
+  };
+}
 function repairChartHandler(args) {
   const { spec, applied, remaining } = repairSpec(args.spec);
   return {
@@ -232,6 +258,19 @@ function createServer() {
     },
     async (args) => validateChartHandler(args)
   );
+  server.registerTool(
+    "recommend_chart",
+    {
+      title: "Recommend Graphein chart specs",
+      description: "Profile tidy rows and return ranked, ready-to-render ChartSpecs with rationale. Use this before guessing a chart type or encoding.",
+      inputSchema: {
+        data: z.array(z.record(z.string(), z.any())),
+        intent: z.string().optional(),
+        maxResults: z.number().int().positive().optional()
+      }
+    },
+    async (args) => recommendChartHandler(args)
+  );
   server.registerTool(
     "repair_chart",
     {
@@ -308,4 +347,4 @@ export {
   VERSION,
   createServer
 };
-//# sourceMappingURL=chunk-LBB3C2XH.js.map
+//# sourceMappingURL=chunk-PHH2HU3O.js.map

package/dist/chunk-PHH2HU3O.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/handlers.ts","../src/resources.ts","../src/create-server.ts"],"sourcesContent":["/**\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  repairSpec,\n  recommendChart,\n  summarize,\n  type ChartSpec,\n  type RecommendOptions,\n  type ValidationError,\n} from 'graphein';\nimport { renderChart } from '@graphein/node';\nimport type { JsonPatchOp } from './types.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  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}\n\nexport interface RecommendChartArgs {\n  data: Record<string, unknown>[];\n  intent?: string;\n  maxResults?: number;\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\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  return out;\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  const { spec, width, height, dpr, repair = true } = args;\n\n  let working: unknown = spec;\n  let validation = validateSpec(working);\n  let repairs: JsonPatchOp[] = [];\n\n  if (!validation.valid && repair) {\n    const repaired = repairSpec(working);\n    if (repaired.applied.length > 0) {\n      working = repaired.spec;\n      repairs = repaired.applied;\n      validation = validateSpec(working);\n    }\n  }\n\n  if (!validation.valid) {\n    return {\n      isError: true,\n      content: [\n        json({\n          ok: false,\n          rendered: false,\n          stage: 'validate',\n          type: specType(working),\n          errors: validation.errors.map(tidyError),\n          lint: validation.warnings.map(tidyError),\n          repairsApplied: repairs,\n          hint: 'Apply each error.fix JSON Patch (or the repair_chart tool), then call render_chart again. See the graphein://agent-guide and graphein://schema resources.',\n        }),\n      ],\n    };\n  }\n\n  const type = specType(working);\n\n  try {\n    const { png, report, width: pxW, height: pxH } = renderChart(working as ChartSpec, {\n      width,\n      height,\n      dpr,\n    });\n    return {\n      isError: false,\n      content: [\n        { type: 'image', data: png.toString('base64'), mimeType: 'image/png' },\n        json({\n          ok: report.ok,\n          rendered: true,\n          type,\n          pixelSize: { width: pxW, height: pxH },\n          summary: report.summary,\n          marks: report.markCount,\n          series: report.seriesCount,\n          colors: report.colorCount,\n          diagnostics: report.diagnostics,\n          lint: validation.warnings.map(tidyError),\n          repairsApplied: repairs,\n        }),\n      ],\n    };\n  } catch (e) {\n    return {\n      isError: true,\n      content: [\n        json({\n          ok: false,\n          rendered: false,\n          stage: 'render',\n          type,\n          message: e instanceof Error ? e.message : String(e),\n          summary: summarize(working as ChartSpec) || undefined,\n          repairsApplied: repairs,\n        }),\n      ],\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  const result = validateSpec(args.spec);\n  return {\n    isError: false,\n    content: [\n      json({\n        valid: result.valid,\n        type: specType(args.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  return {\n    isError: false,\n    content: [\n      json({\n        ok: true,\n        recommendations: recommendChart(args.data, { intent: args.intent, maxResults: args.maxResults }),\n      }),\n    ],\n  };\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: { spec: unknown }): ToolResult {\n  const { spec, applied, remaining } = repairSpec(args.spec);\n  return {\n    isError: false,\n    content: [\n      json({\n        valid: remaining.length === 0,\n        applied,\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  const result = validateSpec(args.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 summary = summarize(args.spec as ChartSpec);\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>();\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  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 { z } from 'zod';\nimport {\n  renderChartHandler,\n  validateChartHandler,\n  repairChartHandler,\n  recommendChartHandler,\n  summarizeChartHandler,\n} from './handlers.js';\nimport { RESOURCES, readResourceFile } from './resources.js';\n\n/** Package version, surfaced as the MCP server version. */\nexport const VERSION = '0.3.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. Read the graphein://agent-guide resource (and graphein://schema for exact fields) if you are unsure of the API.\n2. Shape your data as a tidy array — one row per observation, one column per variable.\n3. Emit a ChartSpec and call render_chart: it validates, auto-repairs safe mistakes, renders a PNG, and returns a vision-free critique (the render report + lint warnings). Read the critique to verify the chart looks right.\n4. If a spec is invalid, render_chart (and validate_chart) return structured errors each with a JSON-Patch 'fix' — apply it (or call repair_chart) and retry instead of regenerating.\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\": {...} }. See the graphein://schema and graphein://agent-guide resources.',\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\n  // --- Tools: the runtime loop -------------------------------------------------\n\n  server.registerTool(\n    'render_chart',\n    {\n      title: 'Render a Graphein chart',\n      description:\n        '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      inputSchema: {\n        spec: specSchema,\n        width: z.number().int().positive().optional().describe('Logical width in CSS px (default 800).'),\n        height: z.number().int().positive().optional().describe('Logical height in CSS px (default 500).'),\n        dpr: z.number().positive().optional().describe('Device pixel ratio for crisp output (default 2).'),\n        repair: z\n          .boolean()\n          .optional()\n          .describe('Auto-apply safe repairs before rendering when the spec is invalid (default true).'),\n      },\n    },\n    async (args) => renderChartHandler(args),\n  );\n\n  server.registerTool(\n    'validate_chart',\n    {\n      title: 'Validate a Graphein chart spec',\n      description:\n        '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      inputSchema: { spec: specSchema },\n    },\n    async (args) => validateChartHandler(args),\n  );\n\n  server.registerTool(\n    'recommend_chart',\n    {\n      title: 'Recommend Graphein chart specs',\n      description:\n        'Profile tidy rows and return ranked, ready-to-render ChartSpecs with rationale. Use this before guessing a chart type or encoding.',\n      inputSchema: {\n        data: z.array(z.record(z.string(), z.any())),\n        intent: z.string().optional(),\n        maxResults: z.number().int().positive().optional(),\n      },\n    },\n    async (args) => recommendChartHandler(args),\n  );\n\n  server.registerTool(\n    'repair_chart',\n    {\n      title: 'Repair a Graphein chart spec',\n      description:\n        'Apply every safe, unambiguous fix Graphein proposes (misspelled chart type or enum, a temporal field typed as a category, …) and return the corrected spec, the JSON Patch ops applied, and whether it is now valid. Turns a near-miss into a one-step correction.',\n      inputSchema: { spec: specSchema },\n    },\n    async (args) => repairChartHandler(args),\n  );\n\n  server.registerTool(\n    'summarize_chart',\n    {\n      title: 'Summarize a Graphein chart',\n      description:\n        '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      inputSchema: { spec: specSchema },\n    },\n    async (args) => summarizeChartHandler(args),\n  );\n\n  // --- Resources: deliver the API knowledge at runtime -------------------------\n\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  // --- Prompt: teach the workflow ---------------------------------------------\n\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. If unsure of the API, read the graphein://agent-guide resource (and graphein://schema for exact fields).\\n2. Shape the data as a tidy array — one row per observation, one column per variable.\\n3. Choose a chart type and write a single ChartSpec ({ type, data, encoding, title }).\\n4. Call render_chart with the spec. Read the returned critique (render report + lint) to confirm it looks right.\\n5. If it reports errors, apply each error.fix patch (or call repair_chart) and render again — do not regenerate from scratch.`,\n          },\n        },\n      ],\n    }),\n  );\n\n  return server;\n}\n"],"mappings":"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","names":["text"]}

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   resourceByUri,
   summarizeChartHandler,
   validateChartHandler
-} from "./chunk-LBB3C2XH.js";
+} from "./chunk-PHH2HU3O.js";
 export {
   RESOURCES,
   VERSION,

package/dist/server.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphein-mcp",
-  "version": "0.9.1",
+  "version": "0.11.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",
@@ -61,9 +61,9 @@
     "prepack": "tsup"
   },
   "dependencies": {
-    "@graphein/node": "^0.9.1",
+    "@graphein/node": "^0.11.0",
     "@modelcontextprotocol/sdk": "^1.20.0",
-    "graphein": "^0.9.1",
+    "graphein": "^0.11.0",
     "zod": "^3.23.0"
   }
 }

package/resources/agent-guide.md

@@ -119,9 +119,11 @@ reference: [spec-reference → Transforms](./spec-reference.md#transforms).
 
 Rules of thumb: prefer `bar` over `pie` beyond ~6 slices; use `stack` for
 part‑to‑whole and grouped bars for direct comparison; reserve `pie` for a small
-number of shares. For a donut with several small slices, set `labels` to a
-`PieLabels` object — `placement:'auto'` keeps tight labels readable by moving
-them outside onto leader lines.
+number of shares. For long category names or ranked lists, set `orientation:'horizontal'`
+on a `bar` to lay categories down the left and grow bars rightward (works with
+`stack`/`group`, `insights`, and annotations). For a donut with several small slices,
+set `labels` to a `PieLabels` object — `placement:'auto'` keeps tight labels readable
+by moving them outside onto leader lines.
 
 ## Recipes
 
@@ -475,6 +477,8 @@ specs still round‑trip through `JSON.stringify`. Three optional fields on any
 - `filter` clauses are a `{ param }` (cross‑filter) or a literal predicate:
   `{ field, equals }`, `{ field, oneOf }`, `{ field, range:[min,max] }`,
   `{ field, contains }`. An empty/absent selection matches everything (`empty:'all'`).
+- Set `legend:{ "interactive": true }` on multi-series cartesian charts to let swatch
+  clicks publish the **visible** series as a set selection (shift/alt-click isolates).
 
 **Slicers** are first‑class visuals that publish a selection from a control:
 
@@ -586,6 +590,8 @@ unless `layout.navigators:'inline'`. Theme cascades to every view.
 
 The default look is **flat and modern** (solid fills, minimal shadows). The built‑in
 palette is accessible on both light and dark backgrounds.
+Use top-level `"palette": "colorblind"` for Okabe–Ito categorical colors, or
+`"bright"`, `"muted"`, or a custom string array when a chart needs different series colors.
 
 ## Hand-drawn ("sketch") mode
 

package/resources/chart-spec.schema.json

@@ -326,6 +326,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -604,6 +618,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -770,7 +798,8 @@
           "enum": [
             "vertical",
             "horizontal"
-          ]
+          ],
+          "description": "Bar direction. `'vertical'` (default) draws columns growing up from the x-axis; `'horizontal'` draws bars growing rightward from the y-axis, with the `x` categories listed down the left — ideal when category names are long. The `encoding` is unchanged either way (`x` = category, `y` = value)."
         },
         "stack": {
           "type": "boolean",
@@ -885,6 +914,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -1094,6 +1137,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -1272,6 +1329,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -1555,6 +1626,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -1832,6 +1917,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -2423,6 +2522,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -2604,6 +2717,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -2762,6 +2889,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -3340,6 +3481,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -3542,6 +3697,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -3846,6 +4015,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -4082,6 +4265,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -4361,6 +4558,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -4514,6 +4725,14 @@
         },
         "title": {
           "type": "string"
+        },
+        "interactive": {
+          "type": "boolean",
+          "description": "Allow clicking legend items to toggle/isolate series; publishes a selection."
+        },
+        "param": {
+          "type": "string",
+          "description": "Selection param to publish legend visibility to; defaults to the series field name."
         }
       },
       "additionalProperties": false
@@ -4548,6 +4767,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -4781,6 +5014,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -5024,6 +5271,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -5306,6 +5567,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -5573,6 +5848,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -5739,6 +6028,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -6004,6 +6307,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -6215,6 +6532,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -6518,6 +6849,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -6794,6 +7139,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -7045,8 +7404,7 @@
         "positive",
         "negative"
       ],
-      "additionalProperties": false,
-      "description": "Graphein design tokens. Flat, modern aesthetic: solid fills, minimal shadows, restrained radii, and a teal accent. Two built-in themes (light/dark). Token values are literals so this module stays dependency-free; charts combine these with the color module for derived ramps and contrast."
+      "additionalProperties": false
     },
     "ThemeFont": {
       "type": "object",
@@ -7314,6 +7672,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },
@@ -7624,6 +7996,20 @@
           "$ref": "#/$defs/ThemeInput",
           "description": "Theme name ('light' | 'dark') or a partial override object."
         },
+        "palette": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Named categorical palette ('graphein'|'colorblind'|'bright'|'muted') or an explicit array of series colors."
+        },
         "dimensions": {
           "$ref": "#/$defs/Dimensions"
         },

package/resources/spec-reference.md

@@ -67,10 +67,11 @@ Shared by **all** chart types.
 | `data` | `Datum[]` | — | Row‑oriented records. Required for every chart/table. |
 | `transform` | `Transform[]` | — | Declarative pipeline that reshapes `data` **before** charting (aggregate, bin, filter, fold, timeUnit). See [Transforms](#transforms). |
 | `theme` | `'light' \| 'dark' \| ThemeOverride` | `'light'` | Theme name or a partial override (see [Themes](#themes)). |
+| `palette` | `'graphein' \| 'colorblind' \| 'bright' \| 'muted' \| string[]` | theme palette | Categorical series palette selector, or explicit colors cycled across series. |
 | `dimensions` | `{ width?, height?, autoResize? }` | responsive | Omit `width`/`height` to fill the container and track resizes. |
 | `title` | `string \| TitleConfig` | — | `string`, or `{ text, subtitle?, align? }`. |
 | `description` | `string` | auto | Accessible alt text. Used verbatim as the chart's `aria-label`; auto‑synthesized from type/title/data when omitted (see [Accessibility](#accessibility)). |
-| `legend` | `LegendConfig \| boolean` | auto | `false` hides it; `{ show?, position?, title? }`. `position`: `top \| right \| bottom \| left`. |
+| `legend` | `LegendConfig \| boolean` | auto | `false` hides it; `{ show?, position?, title?, interactive?, param? }`. `interactive:true` lets legend swatch clicks publish visible series as `{ kind:'set', field:<series field>, values:[...] }` (shift/alt-click isolates); `param` defaults to the series field. `position`: `top \| right \| bottom \| left`. |
 | `tooltip` | `TooltipConfig \| boolean` | `true` | `false` (or `{ show: false }`) disables hover tooltips. |
 | `axes` | `{ x?: AxisConfig, y?: AxisConfig }` | auto | Per‑axis overrides (cartesian charts). |
 | `animation` | `AnimationConfig \| boolean` | on | Brief entrance on first render. `false` disables; `{ enabled?, duration?, easing? }`. Honors `prefers-reduced-motion` (see [Animation](#animation)). |
@@ -480,13 +481,13 @@ Columns/bars with grouped or stacked series and rounded corners.
 | Field | Type | Notes |
 | --- | --- | --- |
 | `encoding` | requires `x`, `y`; optional `series` | — |
-| `orientation` | `'vertical' \| 'horizontal'` | Default `vertical`. |
+| `orientation` | `'vertical' \| 'horizontal'` | Default `vertical`. `'horizontal'` lists categories down the left gutter and grows value bars rightward from a left baseline (value axis along the bottom) — ideal for long category names or ranked lists. Works with `stack`/`group`, `cornerRadius`, `insights`, and annotations. |
 | `stack` | `boolean` | Stack series. |
 | `group` | `boolean` | Side‑by‑side groups. Default when `series` is present and not stacked. |
 | `cornerRadius` | `number` | Bar corner radius in px. |
 | `facet` | `FacetConfig` | Split into a [trellis grid of small multiples](#faceting-small-multiples). |
 
-→ [`examples/bar-grouped.json`](./examples/bar-grouped.json)
+→ [`examples/bar-grouped.json`](./examples/bar-grouped.json) · [`examples/bar-horizontal.json`](./examples/bar-horizontal.json)
 
 ### scatter
 
@@ -1120,7 +1121,9 @@ with an optional `base`:
 Overridable token groups: `color` (`background`, `surface`, `text`, `textMuted`,
 `axis`, `grid`, `border`, `accent`, `palette[]`, `positive`, `negative`),
 `font`, `spacing`, `radius`, `stroke`. The default categorical `palette` is a
-vibrant, accessibility‑tuned 10‑color set that reads well on light and dark.
+vibrant, accessibility‑tuned 10‑color set that reads well on light and dark. For
+one chart, prefer top-level `palette: 'colorblind'` (or `'bright'`, `'muted'`, or
+an explicit `string[]`) instead of overriding theme tokens.
 
 ---
 

package/dist/chunk-LBB3C2XH.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/handlers.ts","../src/resources.ts","../src/create-server.ts"],"sourcesContent":["/**\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  repairSpec,\n  summarize,\n  type ChartSpec,\n  type ValidationError,\n} from 'graphein';\nimport { renderChart } from '@graphein/node';\nimport type { JsonPatchOp } from './types.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  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}\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\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  return out;\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  const { spec, width, height, dpr, repair = true } = args;\n\n  let working: unknown = spec;\n  let validation = validateSpec(working);\n  let repairs: JsonPatchOp[] = [];\n\n  if (!validation.valid && repair) {\n    const repaired = repairSpec(working);\n    if (repaired.applied.length > 0) {\n      working = repaired.spec;\n      repairs = repaired.applied;\n      validation = validateSpec(working);\n    }\n  }\n\n  if (!validation.valid) {\n    return {\n      isError: true,\n      content: [\n        json({\n          ok: false,\n          rendered: false,\n          stage: 'validate',\n          type: specType(working),\n          errors: validation.errors.map(tidyError),\n          lint: validation.warnings.map(tidyError),\n          repairsApplied: repairs,\n          hint: 'Apply each error.fix JSON Patch (or the repair_chart tool), then call render_chart again. See the graphein://agent-guide and graphein://schema resources.',\n        }),\n      ],\n    };\n  }\n\n  const type = specType(working);\n\n  try {\n    const { png, report, width: pxW, height: pxH } = renderChart(working as ChartSpec, {\n      width,\n      height,\n      dpr,\n    });\n    return {\n      isError: false,\n      content: [\n        { type: 'image', data: png.toString('base64'), mimeType: 'image/png' },\n        json({\n          ok: report.ok,\n          rendered: true,\n          type,\n          pixelSize: { width: pxW, height: pxH },\n          summary: report.summary,\n          marks: report.markCount,\n          series: report.seriesCount,\n          colors: report.colorCount,\n          diagnostics: report.diagnostics,\n          lint: validation.warnings.map(tidyError),\n          repairsApplied: repairs,\n        }),\n      ],\n    };\n  } catch (e) {\n    return {\n      isError: true,\n      content: [\n        json({\n          ok: false,\n          rendered: false,\n          stage: 'render',\n          type,\n          message: e instanceof Error ? e.message : String(e),\n          summary: summarize(working as ChartSpec) || undefined,\n          repairsApplied: repairs,\n        }),\n      ],\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  const result = validateSpec(args.spec);\n  return {\n    isError: false,\n    content: [\n      json({\n        valid: result.valid,\n        type: specType(args.spec),\n        errors: result.errors.map(tidyError),\n        warnings: result.warnings.map(tidyError),\n      }),\n    ],\n  };\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: { spec: unknown }): ToolResult {\n  const { spec, applied, remaining } = repairSpec(args.spec);\n  return {\n    isError: false,\n    content: [\n      json({\n        valid: remaining.length === 0,\n        applied,\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  const result = validateSpec(args.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 summary = summarize(args.spec as ChartSpec);\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>();\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  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 { z } from 'zod';\nimport {\n  renderChartHandler,\n  validateChartHandler,\n  repairChartHandler,\n  summarizeChartHandler,\n} from './handlers.js';\nimport { RESOURCES, readResourceFile } from './resources.js';\n\n/** Package version, surfaced as the MCP server version. */\nexport const VERSION = '0.3.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. Read the graphein://agent-guide resource (and graphein://schema for exact fields) if you are unsure of the API.\n2. Shape your data as a tidy array — one row per observation, one column per variable.\n3. Emit a ChartSpec and call render_chart: it validates, auto-repairs safe mistakes, renders a PNG, and returns a vision-free critique (the render report + lint warnings). Read the critique to verify the chart looks right.\n4. If a spec is invalid, render_chart (and validate_chart) return structured errors each with a JSON-Patch 'fix' — apply it (or call repair_chart) and retry instead of regenerating.\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\": {...} }. See the graphein://schema and graphein://agent-guide resources.',\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\n  // --- Tools: the runtime loop -------------------------------------------------\n\n  server.registerTool(\n    'render_chart',\n    {\n      title: 'Render a Graphein chart',\n      description:\n        '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      inputSchema: {\n        spec: specSchema,\n        width: z.number().int().positive().optional().describe('Logical width in CSS px (default 800).'),\n        height: z.number().int().positive().optional().describe('Logical height in CSS px (default 500).'),\n        dpr: z.number().positive().optional().describe('Device pixel ratio for crisp output (default 2).'),\n        repair: z\n          .boolean()\n          .optional()\n          .describe('Auto-apply safe repairs before rendering when the spec is invalid (default true).'),\n      },\n    },\n    async (args) => renderChartHandler(args),\n  );\n\n  server.registerTool(\n    'validate_chart',\n    {\n      title: 'Validate a Graphein chart spec',\n      description:\n        '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      inputSchema: { spec: specSchema },\n    },\n    async (args) => validateChartHandler(args),\n  );\n\n  server.registerTool(\n    'repair_chart',\n    {\n      title: 'Repair a Graphein chart spec',\n      description:\n        'Apply every safe, unambiguous fix Graphein proposes (misspelled chart type or enum, a temporal field typed as a category, …) and return the corrected spec, the JSON Patch ops applied, and whether it is now valid. Turns a near-miss into a one-step correction.',\n      inputSchema: { spec: specSchema },\n    },\n    async (args) => repairChartHandler(args),\n  );\n\n  server.registerTool(\n    'summarize_chart',\n    {\n      title: 'Summarize a Graphein chart',\n      description:\n        '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      inputSchema: { spec: specSchema },\n    },\n    async (args) => summarizeChartHandler(args),\n  );\n\n  // --- Resources: deliver the API knowledge at runtime -------------------------\n\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  // --- Prompt: teach the workflow ---------------------------------------------\n\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. If unsure of the API, read the graphein://agent-guide resource (and graphein://schema for exact fields).\\n2. Shape the data as a tidy array — one row per observation, one column per variable.\\n3. Choose a chart type and write a single ChartSpec ({ type, data, encoding, title }).\\n4. Call render_chart with the spec. Read the returned critique (render report + lint) to confirm it looks right.\\n5. If it reports errors, apply each error.fix patch (or call repair_chart) and render again — do not regenerate from scratch.`,\n          },\n        },\n      ],\n    }),\n  );\n\n  return server;\n}\n"],"mappings":"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","names":["text"]}