@outsidedata/dolex 0.1.0

package/dist/src/mcp/index.js

@@ -0,0 +1,262 @@
+#!/usr/bin/env node
+/**
+ * Dolex — Visualization MCP Server
+ *
+ * An MCP server that provides visualization intelligence from a handcrafted
+ * pattern library that goes far beyond bar/line/pie.
+ *
+ * 17 tools:
+ *   visualize              — Inline data + intent → ranked visualization recommendations
+ *   visualize_from_source  — Source data (DSL query) + intent → ranked visualization recommendations
+ *   list_patterns          — Browse all available visualization patterns
+ *   refine_visualization   — Tweak a visualization spec
+ *   create_dashboard       — Multi-view dashboard from a data source
+ *   refine_dashboard       — Iterate on a dashboard (add/remove views, layout, filters, theme)
+ *   add_source             — Connect a data source (CSV, SQLite, Postgres, MySQL)
+ *   list_sources           — List connected data sources
+ *   remove_source          — Disconnect a data source
+ *   describe_source        — Re-examine column profiles and sample rows for a source
+ *   analyze_source         — Generate a structured analysis plan with DSL queries
+ *   query_source           — Run a declarative DSL query and see tabular results
+ *   server_status          — Inspect cached data in server memory
+ *   clear_cache            — Clear cached specs, results, and sessions
+ *   export_html            — Get the full rendered HTML for a visualization by specId
+ *   screenshot             — Render a visualization to PNG via headless Chromium
+ *   report_bug             — Generate a sanitized bug report for GitHub issues
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerAppTool, registerAppResource, RESOURCE_MIME_TYPE, } from '@modelcontextprotocol/ext-apps/server';
+import { visualizeInputSchema, handleVisualize } from './tools/visualize.js';
+import { visualizeFromSourceInputSchema, handleVisualizeFromSource } from './tools/visualize-from-source.js';
+import { handleListPatterns } from './tools/list-patterns.js';
+import { refineInputSchema, handleRefine } from './tools/refine.js';
+import { addSourceInputSchema, removeSourceInputSchema, describeSourceInputSchema, handleListSources, handleAddSource, handleRemoveSource, handleDescribeSource, } from './tools/sources.js';
+import { analyzeSourceInputSchema, handleAnalyzeSource } from './tools/analyze.js';
+import { querySourceInputSchema, handleQuerySource } from './tools/query-source.js';
+import { createDashboardInputSchema, handleCreateDashboard } from './tools/dashboard.js';
+import { refineDashboardInputSchema, handleRefineDashboard } from './tools/dashboard-refine.js';
+import { clearCacheInputSchema, handleServerStatus, handleClearCache, } from './tools/server-privacy.js';
+import { bugReportInputSchema, handleReportBug } from './tools/bug-report.js';
+import { exportHtmlInputSchema, handleExportHtml } from './tools/export-html.js';
+import { screenshotInputSchema, handleScreenshot, closeBrowser } from './tools/screenshot.js';
+import { specStore } from './spec-store.js';
+import { registerPrompts } from './prompts.js';
+import { mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+// Pattern library imports
+import { registry } from '../patterns/registry.js';
+import { selectPattern } from '../patterns/selector.js';
+// Connector imports
+import { SourceManager } from '../connectors/manager.js';
+// MCP Apps shell
+import { getAppShellHtml, CHART_RESOURCE_URI } from './app-shell.js';
+// ─── INITIALIZE ─────────────────────────────────────────────────────────────
+const dolexDir = join(homedir(), '.dolex');
+mkdirSync(dolexDir, { recursive: true });
+const sourceManager = new SourceManager(join(dolexDir, 'sources.json'));
+const serverStartTime = Date.now();
+// ─── CREATE SERVER ──────────────────────────────────────────────────────────
+const server = new McpServer({
+    name: 'dolex',
+    version: '0.1.0',
+});
+// ─── Shared pattern selector callback ────────────────────────────────────────
+function selectPatternCallback(input) {
+    const columns = input.columns ?? [];
+    const specOptions = {};
+    if (input.geoLevel)
+        specOptions.geoLevel = input.geoLevel;
+    if (input.geoRegion)
+        specOptions.geoRegion = input.geoRegion;
+    const result = selectPattern(input.data, columns, input.intent, { forcePattern: input.forcePattern, specOptions });
+    return {
+        recommended: {
+            pattern: result.recommended.pattern.id,
+            spec: result.recommended.spec,
+            reasoning: result.recommended.reasoning,
+        },
+        alternatives: result.alternatives.map(a => ({
+            pattern: a.pattern.id,
+            spec: a.spec,
+            reasoning: a.reasoning,
+        })),
+    };
+}
+// ─── REGISTER TOOLS ─────────────────────────────────────────────────────────
+// Inline data visualization tool
+registerAppTool(server, 'visualize', {
+    title: 'Visualize Data',
+    description: 'Takes inline data + intent and returns visualization recommendations from a handcrafted pattern library of 41 chart types (bump chart, beeswarm, waffle, slope chart, etc.). Use `pattern` to force a specific chart type by ID (use list_patterns to discover IDs).\n\nPass data as an array of row objects, OR pass `resultId` from a previous `query_source` call to reuse cached data (saves tokens). For source-based data (CSV, SQLite, Postgres), use `visualize_from_source` instead.\n\nSet `title` and `subtitle` upfront to avoid a refine round-trip.\n\n**Response**: Returns compact JSON with `specId` (for refine calls), recommended pattern + title + reasoning, alternative chart types, and data shape summary. Chart HTML is delivered via structuredContent.\n\nColor system: Request a palette or highlight specific values via colorPreferences. Palettes: categorical, blue, green, purple, warm, blueRed, greenPurple, tealOrange, redGreen, traffic-light, profit-loss, temperature. Highlight mode: specify values to emphasize — all others become muted gray.\n\nGeographic maps: For choropleth/proportional-symbol patterns, set `geoRegion` to a region code (US, CN, JP, AU, EU, world, etc.) and/or `geoLevel` ("country" or "subdivision"). If omitted, Dolex auto-detects the region from data values — US states, Chinese provinces, Japanese prefectures, European countries, and 18 other regions are recognized automatically.',
+    inputSchema: visualizeInputSchema.shape,
+    _meta: {
+        ui: {
+            resourceUri: CHART_RESOURCE_URI,
+            csp: {
+                resourceDomains: ['https://d3js.org', 'https://cdn.jsdelivr.net'],
+            },
+        },
+    },
+}, handleVisualize(selectPatternCallback));
+// Source-based visualization tool
+registerAppTool(server, 'visualize_from_source', {
+    title: 'Visualize from Data Source',
+    description: 'Takes a data source + DSL query + intent and returns visualization recommendations from a handcrafted pattern library of 41 chart types. Use this when data lives in a connected source (CSV, SQLite, Postgres, MySQL) — Dolex queries the data server-side.\n\nRequires a source from `add_source`. Pass `sourceId`, `table`, and a `query` (declarative DSL with select, groupBy, filter, join, orderBy, limit). Set `title` and `subtitle` upfront to avoid a refine round-trip.\n\n**DSL query example**:\n```json\n{\n  "select": ["region", { "field": "revenue", "aggregate": "sum", "as": "total" }],\n  "groupBy": ["region"],\n  "filter": { "field": "year", "equals": 2024 },\n  "orderBy": { "field": "total", "direction": "desc" },\n  "limit": 10\n}\n```\n\n**Filter shorthand**: `{ "field": "x", "equals": "y" }` — also `gt`, `gte`, `lt`, `lte`, `not_equals`. Single filters can be bare objects (no array needed). Canonical form: `{ "field", "op": "=", "value": "y" }`.\n\n**Joins**: Use `join` to combine tables within the same source (inner/left). Use `table.field` dot notation for joined fields. Multi-hop: `{ "table": "orders", "on": { "left": "order_id", "right": "id" } }, { "table": "customers", "on": { "left": "orders.customer_id", "right": "id" } }`.\n\n**Response**: Same as `visualize` — compact JSON with specId, recommended pattern, alternatives, data shape. Chart HTML via structuredContent.\n\nGeographic maps: For choropleth/proportional-symbol patterns, set `geoRegion` to a region code (US, CN, JP, AU, EU, world, etc.) and/or `geoLevel` ("country" or "subdivision"). If omitted, Dolex auto-detects the region from data values.',
+    inputSchema: visualizeFromSourceInputSchema.shape,
+    _meta: {
+        ui: {
+            resourceUri: CHART_RESOURCE_URI,
+            csp: {
+                resourceDomains: ['https://d3js.org', 'https://cdn.jsdelivr.net'],
+            },
+        },
+    },
+}, handleVisualizeFromSource(selectPatternCallback, { sourceManager }));
+server.registerTool('list_patterns', {
+    title: 'List Visualization Patterns',
+    description: 'Browse all available visualization patterns with their descriptions, best-for hints, data requirements, and per-pattern capabilities (color encoding, config options). Also returns full color system documentation (palettes, highlight mode, usage).',
+}, handleListPatterns(() => registry.getAll()));
+registerAppTool(server, 'refine_visualization', {
+    title: 'Refine Visualization',
+    description: 'Tweak a visualization — sort, limit, flip axes, change colors, highlight values, update title. Pass `specId` from a previous visualize or refine call (no data round-trip needed).\n\nUse `selectAlternative` with a pattern ID to switch to an alternative from the original visualize call (e.g., "line", "area"). Returns a new `specId` for further refinements.\n\nColor refinements: "use warm palette", "highlight North and South", "highlight Q1 in #ff6b6b", "mute to 30% opacity", "color by target" (alluvial). Palettes: categorical, blue, green, purple, warm, blueRed, greenPurple, tealOrange, redGreen, traffic-light, profit-loss, temperature.',
+    inputSchema: refineInputSchema.shape,
+    _meta: {
+        ui: {
+            resourceUri: CHART_RESOURCE_URI,
+            csp: {
+                resourceDomains: ['https://d3js.org', 'https://cdn.jsdelivr.net'],
+            },
+        },
+    },
+}, handleRefine());
+// Data source management tools
+server.registerTool('add_source', {
+    title: 'Add Data Source',
+    description: 'Connect a data source: CSV file/directory, SQLite database, PostgreSQL, or MySQL connection.\n\nIMPORTANT — LOCAL FILESYSTEM ONLY (HARD REQUIREMENT):\nThis MCP server runs on the user\'s local machine and processes files directly from the local filesystem. File paths must be local paths (e.g. /Users/name/Downloads/data.csv), NOT paths from a cloud sandbox like /mnt/user-data/uploads/ or /home/claude/.\n\nWhen a user uploads a file via drag-and-drop, you do NOT have access to it through this tool. This is a deliberate design constraint. Do NOT work around this limitation by reading the file contents and passing them through other endpoints (e.g. inline data via visualize, query_source, or any other method). Workarounds are specifically unsupported and will produce incorrect or incomplete results. The only correct action is to ask the user to provide the full local path to the file on their machine.\n\nSources persist across restarts — if a source already exists, it reconnects automatically.\n\nSet `detail: "compact"` to get just column names/types + row counts (saves tokens). Default `"full"` includes stats, top values, and sample rows.',
+    inputSchema: addSourceInputSchema,
+}, handleAddSource({ sourceManager }));
+server.registerTool('list_sources', {
+    title: 'List Data Sources',
+    description: 'List all connected data sources with their IDs, types, and table counts.',
+}, handleListSources({ sourceManager }));
+server.registerTool('remove_source', {
+    title: 'Remove Data Source',
+    description: 'Disconnect and remove a data source by its ID.',
+    inputSchema: removeSourceInputSchema,
+}, handleRemoveSource({ sourceManager }));
+server.registerTool('describe_source', {
+    title: 'Describe Data Source',
+    description: 'Returns column profiles for a previously-added data source. Use this to re-examine a source mid-conversation.\n\nSet `detail: "compact"` to get just column names/types + row counts (saves tokens). Default `"full"` includes stats, top values, and sample rows.',
+    inputSchema: describeSourceInputSchema,
+}, handleDescribeSource({ sourceManager }));
+server.registerTool('analyze_source', {
+    title: 'Analyze Data Source',
+    description: 'Examines a connected data source and generates a structured analysis plan with ready-to-execute DSL queries. Returns 4-6 analysis steps covering trends, comparisons, distributions, and relationships — each with a title, question, query, and suggested chart patterns.\n\nUse this after add_source to get an automatic analysis plan. Then execute each step with visualize_from_source.',
+    inputSchema: analyzeSourceInputSchema.shape,
+}, handleAnalyzeSource({ sourceManager }));
+server.registerTool('query_source', {
+    title: 'Query Data Source',
+    description: 'Run a declarative DSL query against a data source and see tabular results. Useful for exploration, validation, or answering data questions without visualizing.\n\nReturns a `resultId` — pass it to `visualize` with `resultId` to chart the same data without re-sending rows (saves tokens).\n\n**DSL query example**:\n```json\n{\n  "select": ["category", { "field": "amount", "aggregate": "sum", "as": "total" }],\n  "groupBy": ["category"],\n  "filter": { "field": "status", "op": "=", "value": "completed" },\n  "orderBy": { "field": "total", "direction": "desc" },\n  "limit": 20\n}\n```\n\n**Filter shorthand**: `{ "field": "status", "equals": "active" }` — also `gt`, `gte`, `lt`, `lte`, `not_equals`. Single filters can be bare objects (no array wrapping needed).\n\n**Joins**: Use `join` to combine tables. Use `table.field` dot notation for joined fields in select/groupBy/filter.\n```json\n{\n  "join": [\n    { "table": "orders", "on": { "left": "order_id", "right": "id" } },\n    { "table": "customers", "on": { "left": "orders.customer_id", "right": "id" } }\n  ],\n  "select": ["customers.name", { "field": "price", "aggregate": "sum", "as": "total" }],\n  "groupBy": ["customers.name"]\n}\n```\nMulti-hop: chain joins and use `table.field` in later join ON clauses to reference columns from earlier joins.',
+    inputSchema: querySourceInputSchema,
+}, handleQuerySource({ sourceManager }));
+// Dashboard tools
+registerAppTool(server, 'create_dashboard', {
+    title: 'Create Dashboard',
+    description: 'Create a multi-view dashboard from a data source. Each view has its own DSL query and intent for pattern selection. Supports global filters (select, multi-select, range) and cross-view interactions (crossfilter, highlight).\n\nRequires an existing data source (from add_source). Each view specifies an intent and query — Dolex selects the best chart pattern for each.\n\nLayout: auto-calculated grid columns, or specify columns (1-4) and per-view colSpan/rowSpan.\n\nReturns the full DashboardSpec (pass to refine_dashboard for iterations).',
+    inputSchema: createDashboardInputSchema.shape,
+    _meta: {
+        ui: {
+            resourceUri: CHART_RESOURCE_URI,
+            csp: {
+                resourceDomains: ['https://d3js.org', 'https://cdn.jsdelivr.net'],
+            },
+        },
+    },
+}, handleCreateDashboard({ sourceManager }));
+registerAppTool(server, 'refine_dashboard', {
+    title: 'Refine Dashboard',
+    description: 'Iterate on a dashboard — add/remove/modify views, change layout, add filters, switch themes, swap view positions, or override chart patterns.\n\nPass the currentSpec from a previous create_dashboard or refine_dashboard call, plus a natural language refinement.\n\nExamples:\n- "add a chart showing revenue by month"\n- "remove the bar chart"\n- "make it 3 columns"\n- "add a region filter"\n- "dark mode"\n- "swap view-1 and view-2"\n- "show the trend as a line chart"',
+    inputSchema: refineDashboardInputSchema.shape,
+    _meta: {
+        ui: {
+            resourceUri: CHART_RESOURCE_URI,
+            csp: {
+                resourceDomains: ['https://d3js.org', 'https://cdn.jsdelivr.net'],
+            },
+        },
+    },
+}, handleRefineDashboard({ sourceManager }));
+// Privacy / cache management tools
+const privacyDeps = { sourceManager, serverStartTime };
+server.registerTool('server_status', {
+    title: 'Server Status',
+    description: 'Shows what data Dolex currently holds in memory: cached visualization specs (with data row counts), query result cache, connected data sources, and server uptime. Use this to audit data retention before clearing.',
+}, handleServerStatus(privacyDeps));
+server.registerTool('clear_cache', {
+    title: 'Clear Cache',
+    description: 'Clears cached data from server memory. Scope options: "all" (specs + results), "specs" (visualization specs and their embedded data), "results" (query result cache). Use after working with sensitive data.',
+    inputSchema: clearCacheInputSchema,
+}, handleClearCache(privacyDeps));
+server.registerTool('report_bug', {
+    title: 'Report Bug',
+    description: 'Generate a sanitized bug report for a GitHub issue. Includes environment info, recent operation history, and visualization context — but never includes data values, connection strings, or file paths. Field names are anonymized by default; set includeFieldNames to show real names. Copy the markdown output and paste into a GitHub issue.',
+    inputSchema: bugReportInputSchema.shape,
+}, handleReportBug({ sourceManager, serverStartTime }));
+server.registerTool('export_html', {
+    title: 'Export Chart HTML',
+    description: 'Returns the full, self-contained HTML for a previously-created visualization. Pass a specId from visualize, visualize_from_source, or refine_visualization. The returned HTML is a complete document with embedded D3 and data — suitable for saving to a file, opening in a browser, or screenshotting programmatically.',
+    inputSchema: exportHtmlInputSchema.shape,
+}, handleExportHtml());
+server.registerTool('screenshot', {
+    title: 'Screenshot Visualization',
+    description: 'Render a visualization to a PNG image via headless Chromium. Returns a base64-encoded PNG that Claude can see directly. Pass a specId from visualize, visualize_from_source, or refine_visualization.\n\nRequires Playwright: npm install playwright && npx playwright install chromium',
+    inputSchema: screenshotInputSchema.shape,
+}, handleScreenshot());
+// ─── MCP APPS RESOURCE ─────────────────────────────────────────────────────
+registerAppResource(server, 'Dolex Chart Viewer', CHART_RESOURCE_URI, {
+    description: 'Interactive chart viewer for Dolex visualizations',
+    _meta: {
+        ui: {
+            csp: {
+                resourceDomains: ['https://d3js.org'],
+            },
+        },
+    },
+}, async () => ({
+    contents: [{
+            uri: CHART_RESOURCE_URI,
+            mimeType: RESOURCE_MIME_TYPE,
+            text: getAppShellHtml(),
+            _meta: {
+                ui: {
+                    csp: {
+                        resourceDomains: ['https://d3js.org', 'https://cdn.jsdelivr.net'],
+                    },
+                },
+            },
+        }],
+}));
+// ─── REGISTER PROMPTS ──────────────────────────────────────────────────────
+registerPrompts(server);
+// ─── START ──────────────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Background cleanup: purge expired specs every 5 minutes
+    setInterval(() => {
+        specStore.purgeExpired();
+    }, 5 * 60 * 1000);
+    console.error('Dolex MCP server running on stdio');
+    const shutdown = async () => {
+        await closeBrowser();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/src/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/index.ts"],"names":[],"mappings":"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"}

package/dist/src/mcp/prompts.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerPrompts(server: McpServer): void;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/src/mcp/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/mcp/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,QA+BhD"}

package/dist/src/mcp/prompts.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+export function registerPrompts(server) {
+    server.registerPrompt('explore-data', {
+        title: 'Explore a Dataset',
+        description: 'Drop a data file and get automatic analysis — like having a data analyst at your desk',
+        argsSchema: {
+            path: z.string().describe('File path (CSV, SQLite) or connection string (Postgres, MySQL)'),
+        },
+    }, async ({ path }) => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: [
+                        `I want to explore a dataset. The file path is: ${path}`,
+                        '',
+                        'Please:',
+                        '1. Connect it as a data source using add_source',
+                        '2. Call analyze_source to get an automatic analysis plan',
+                        '3. For each step in the plan, call visualize_from_source with the provided query and use one of the suggested patterns',
+                        '4. After each chart, write a 2-3 sentence finding explaining what the data reveals — be specific about numbers, trends, and outliers',
+                        '5. End with a "Key Takeaways" summary',
+                        '',
+                        'Use the full Dolex pattern library — the analysis plan suggests patterns like violin plots, sparkline grids, treemaps, and beeswarms. Use them instead of defaulting to bar charts.',
+                    ].join('\n'),
+                },
+            }],
+    }));
+}
+//# sourceMappingURL=prompts.js.map

package/dist/src/mcp/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/mcp/prompts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,cAAc,CACnB,cAAc,EACd;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,uFAAuF;QACpG,UAAU,EAAE;YACV,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;SAC5F;KACF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACnB,QAAQ,EAAE,CAAC;gBACT,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;wBACJ,kDAAkD,IAAI,EAAE;wBACxD,EAAE;wBACF,SAAS;wBACT,iDAAiD;wBACjD,0DAA0D;wBAC1D,wHAAwH;wBACxH,sIAAsI;wBACtI,uCAAuC;wBACvC,EAAE;wBACF,qLAAqL;qBACtL,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF,CAAC;KACH,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/src/mcp/spec-store.d.ts

@@ -0,0 +1,37 @@
+/**
+ * SpecStore — Server-side cache for visualization specs.
+ *
+ * Stores full specs + data by ID so the MCP text response can be compact
+ * (just specId + metadata) while structuredContent still gets the full
+ * pre-rendered chart. The MCP server is long-lived per conversation,
+ * so this persists naturally across tool calls.
+ */
+import type { VisualizationSpec, CompoundVisualizationSpec, DataColumn } from '../types.js';
+export interface StoredSpec {
+    spec: VisualizationSpec | CompoundVisualizationSpec;
+    columns: DataColumn[];
+    alternatives: Map<string, VisualizationSpec>;
+    createdAt: number;
+}
+export interface SpecStoreStats {
+    entries: number;
+    maxEntries: number;
+    ttlMs: number;
+    totalDataRows: number;
+    oldestEntryAge: number | null;
+}
+export declare class SpecStore {
+    private store;
+    private generateId;
+    private isExpired;
+    save(spec: VisualizationSpec | CompoundVisualizationSpec, columns: DataColumn[], alternatives?: Map<string, VisualizationSpec>): string;
+    get(specId: string): StoredSpec | null;
+    updateSpec(specId: string, newSpec: VisualizationSpec | CompoundVisualizationSpec): string;
+    getAlternative(specId: string, patternId: string): VisualizationSpec | null;
+    get size(): number;
+    purgeExpired(): number;
+    clear(): void;
+    stats(): SpecStoreStats;
+}
+export declare const specStore: SpecStore;
+//# sourceMappingURL=spec-store.d.ts.map

package/dist/src/mcp/spec-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-store.d.ts","sourceRoot":"","sources":["../../../src/mcp/spec-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,yBAAyB,EACzB,UAAU,EACX,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,iBAAiB,GAAG,yBAAyB,CAAC;IACpD,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAKD,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAiC;IAE9C,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,SAAS;IAIjB,IAAI,CACF,IAAI,EAAE,iBAAiB,GAAG,yBAAyB,EACnD,OAAO,EAAE,UAAU,EAAE,EACrB,YAAY,GAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAa,GACvD,MAAM;IAkBT,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAUtC,UAAU,CACR,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GAAG,yBAAyB,GACrD,MAAM;IAOT,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAM3E,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,YAAY,IAAI,MAAM;IAYtB,KAAK,IAAI,IAAI;IAIb,KAAK,IAAI,cAAc;CAyBxB;AAED,eAAO,MAAM,SAAS,WAAkB,CAAC"}

package/dist/src/mcp/spec-store.js

@@ -0,0 +1,99 @@
+/**
+ * SpecStore — Server-side cache for visualization specs.
+ *
+ * Stores full specs + data by ID so the MCP text response can be compact
+ * (just specId + metadata) while structuredContent still gets the full
+ * pre-rendered chart. The MCP server is long-lived per conversation,
+ * so this persists naturally across tool calls.
+ */
+import { randomUUID } from 'node:crypto';
+const MAX_ENTRIES = 100;
+const TTL_MS = 60 * 60 * 1000; // 1 hour
+export class SpecStore {
+    store = new Map();
+    generateId() {
+        return `spec-${randomUUID().slice(0, 8)}`;
+    }
+    isExpired(entry) {
+        return Date.now() - entry.createdAt > TTL_MS;
+    }
+    save(spec, columns, alternatives = new Map()) {
+        this.purgeExpired();
+        if (this.store.size >= MAX_ENTRIES) {
+            const oldestKey = this.store.keys().next().value;
+            this.store.delete(oldestKey);
+        }
+        const id = this.generateId();
+        this.store.set(id, {
+            spec,
+            columns,
+            alternatives,
+            createdAt: Date.now(),
+        });
+        return id;
+    }
+    get(specId) {
+        const entry = this.store.get(specId);
+        if (!entry)
+            return null;
+        if (this.isExpired(entry)) {
+            this.store.delete(specId);
+            return null;
+        }
+        return entry;
+    }
+    updateSpec(specId, newSpec) {
+        const existing = this.store.get(specId);
+        const columns = existing?.columns ?? [];
+        const alternatives = existing?.alternatives ?? new Map();
+        return this.save(newSpec, columns, alternatives);
+    }
+    getAlternative(specId, patternId) {
+        const stored = this.get(specId);
+        if (!stored)
+            return null;
+        return stored.alternatives.get(patternId) ?? null;
+    }
+    get size() {
+        return this.store.size;
+    }
+    purgeExpired() {
+        const now = Date.now();
+        let purged = 0;
+        for (const [key, entry] of this.store) {
+            if (now - entry.createdAt > TTL_MS) {
+                this.store.delete(key);
+                purged++;
+            }
+        }
+        return purged;
+    }
+    clear() {
+        this.store.clear();
+    }
+    stats() {
+        this.purgeExpired();
+        const now = Date.now();
+        let totalDataRows = 0;
+        let oldestAge = null;
+        for (const entry of this.store.values()) {
+            const spec = entry.spec;
+            if (spec.data && Array.isArray(spec.data)) {
+                totalDataRows += spec.data.length;
+            }
+            const age = now - entry.createdAt;
+            if (oldestAge === null || age > oldestAge) {
+                oldestAge = age;
+            }
+        }
+        return {
+            entries: this.store.size,
+            maxEntries: MAX_ENTRIES,
+            ttlMs: TTL_MS,
+            totalDataRows,
+            oldestEntryAge: oldestAge,
+        };
+    }
+}
+export const specStore = new SpecStore();
+//# sourceMappingURL=spec-store.js.map

package/dist/src/mcp/spec-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-store.js","sourceRoot":"","sources":["../../../src/mcp/spec-store.ts"],"names":[],"mappings":"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"}

package/dist/src/mcp/tools/analyze.d.ts

@@ -0,0 +1,22 @@
+/**
+ * MCP Tool: analyze_source
+ * Examines a data source and generates a structured analysis plan with DSL queries.
+ */
+import { z } from 'zod';
+export declare const analyzeSourceInputSchema: z.ZodObject<{
+    sourceId: z.ZodString;
+    table: z.ZodOptional<z.ZodString>;
+    maxSteps: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    sourceId: string;
+    table?: string | undefined;
+    maxSteps?: number | undefined;
+}, {
+    sourceId: string;
+    table?: string | undefined;
+    maxSteps?: number | undefined;
+}>;
+export declare function handleAnalyzeSource(deps: {
+    sourceManager: any;
+}): (args: z.infer<typeof analyzeSourceInputSchema>) => Promise<import("./shared.js").McpResponse>;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/src/mcp/tools/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/analyze.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IAAE,aAAa,EAAE,GAAG,CAAA;CAAE,IAChD,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,gDA4B7D"}

package/dist/src/mcp/tools/analyze.js

@@ -0,0 +1,34 @@
+/**
+ * MCP Tool: analyze_source
+ * Examines a data source and generates a structured analysis plan with DSL queries.
+ */
+import { z } from 'zod';
+import { buildAnalysisPlan } from '../../analysis/planner.js';
+import { errorResponse, jsonResponse } from './shared.js';
+export const analyzeSourceInputSchema = z.object({
+    sourceId: z.string().describe('Source ID from add_source'),
+    table: z.string().optional().describe('Table to analyze (defaults to first table)'),
+    maxSteps: z.number().min(1).max(10).optional().describe('Maximum analysis steps (default: 6)'),
+});
+export function handleAnalyzeSource(deps) {
+    return async (args) => {
+        const schemaResult = await deps.sourceManager.getSchema(args.sourceId);
+        if (!schemaResult.ok || !schemaResult.schema) {
+            return errorResponse(schemaResult.error ?? `Source not found: ${args.sourceId}`);
+        }
+        const tables = schemaResult.schema.tables;
+        const targetTable = args.table
+            ? tables.find((t) => t.name === args.table)
+            : tables[0];
+        if (!targetTable) {
+            const available = tables.map((t) => t.name).join(', ');
+            const message = args.table
+                ? `Table "${args.table}" not found. Available: ${available}`
+                : 'No tables found in source';
+            return errorResponse(message);
+        }
+        const plan = buildAnalysisPlan(targetTable.columns, targetTable.name, schemaResult.schema.source?.name ?? args.sourceId, args.maxSteps ?? 6);
+        return jsonResponse(plan);
+    };
+}
+//# sourceMappingURL=analyze.js.map

package/dist/src/mcp/tools/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../../../src/mcp/tools/analyze.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC1D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACnF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CAC/F,CAAC,CAAC;AAEH,MAAM,UAAU,mBAAmB,CAAC,IAA4B;IAC9D,OAAO,KAAK,EAAE,IAA8C,EAAE,EAAE;QAC9D,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvE,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;YAC7C,OAAO,aAAa,CAAC,YAAY,CAAC,KAAK,IAAI,qBAAqB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnF,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC;QAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK;YAC5B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC;YAChD,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAEd,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK;gBACxB,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,2BAA2B,SAAS,EAAE;gBAC5D,CAAC,CAAC,2BAA2B,CAAC;YAChC,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QAED,MAAM,IAAI,GAAG,iBAAiB,CAC5B,WAAW,CAAC,OAAO,EACnB,WAAW,CAAC,IAAI,EAChB,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC,QAAQ,EACjD,IAAI,CAAC,QAAQ,IAAI,CAAC,CACnB,CAAC;QAEF,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/mcp/tools/bug-report.d.ts

@@ -0,0 +1,42 @@
+/**
+ * MCP Tool: report_bug
+ * Generates a sanitized bug report for GitHub issues.
+ * No data values, connection strings, or file paths leave the machine.
+ * Field names anonymized by default (opt-in to include real names).
+ */
+import { z } from 'zod';
+import type { SourceManager } from '../../connectors/manager.js';
+export declare const bugReportInputSchema: z.ZodObject<{
+    description: z.ZodString;
+    specId: z.ZodOptional<z.ZodString>;
+    includeFieldNames: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    specId?: string | undefined;
+    includeFieldNames?: boolean | undefined;
+}, {
+    description: string;
+    specId?: string | undefined;
+    includeFieldNames?: boolean | undefined;
+}>;
+export declare function anonymizeColumns(columns: {
+    name: string;
+    type: string;
+}[], include: boolean): {
+    name: string;
+    type: string;
+}[];
+export declare function sanitizeSpecConfig(config: Record<string, unknown>): Record<string, string>;
+export declare function sanitizeError(error: string): string;
+interface ReportDeps {
+    sourceManager: SourceManager;
+    serverStartTime: number;
+}
+export declare function handleReportBug(deps: ReportDeps): (args: z.infer<typeof bugReportInputSchema>) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+export {};
+//# sourceMappingURL=bug-report.d.ts.map

package/dist/src/mcp/tools/bug-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bug-report.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/bug-report.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAKjE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,EACzC,OAAO,EAAE,OAAO,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAKlC;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAa1F;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKnD;AA0BD,UAAU,UAAU;IAClB,aAAa,EAAE,aAAa,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,IAChC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC;;;;;GA8FzD"}