@outsidedata/dolex 0.1.0

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

@@ -0,0 +1,325 @@
+/**
+ * MCP Tool: visualize
+ * Takes inline data + intent and returns visualization recommendations
+ * from the handcrafted pattern library.
+ *
+ * For source-based data (sourceId + table + query), use visualize_from_source.
+ *
+ * Returns compact text content (specId + metadata, no data) while
+ * structuredContent still gets the full pre-rendered chart HTML.
+ */
+import { z } from 'zod';
+import type { VisualizeInput, VisualizeOutput } from '../../types.js';
+import type { OperationMeta } from './operation-log.js';
+export declare const colorPreferencesSchema: z.ZodOptional<z.ZodObject<{
+    palette: z.ZodOptional<z.ZodEnum<["categorical", "blue", "green", "purple", "warm", "blueRed", "greenPurple", "tealOrange", "redGreen", "traffic-light", "profit-loss", "temperature"]>>;
+    highlight: z.ZodOptional<z.ZodObject<{
+        values: z.ZodArray<z.ZodAny, "many">;
+        color: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        mutedColor: z.ZodOptional<z.ZodString>;
+        mutedOpacity: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        values: any[];
+        color?: string | string[] | undefined;
+        mutedColor?: string | undefined;
+        mutedOpacity?: number | undefined;
+    }, {
+        values: any[];
+        color?: string | string[] | undefined;
+        mutedColor?: string | undefined;
+        mutedOpacity?: number | undefined;
+    }>>;
+    colorField: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    highlight?: {
+        values: any[];
+        color?: string | string[] | undefined;
+        mutedColor?: string | undefined;
+        mutedOpacity?: number | undefined;
+    } | undefined;
+    colorField?: string | undefined;
+    palette?: "categorical" | "blue" | "green" | "purple" | "warm" | "blueRed" | "greenPurple" | "tealOrange" | "redGreen" | "traffic-light" | "profit-loss" | "temperature" | undefined;
+}, {
+    highlight?: {
+        values: any[];
+        color?: string | string[] | undefined;
+        mutedColor?: string | undefined;
+        mutedOpacity?: number | undefined;
+    } | undefined;
+    colorField?: string | undefined;
+    palette?: "categorical" | "blue" | "green" | "purple" | "warm" | "blueRed" | "greenPurple" | "tealOrange" | "redGreen" | "traffic-light" | "profit-loss" | "temperature" | undefined;
+}>>;
+export declare const columnsSchema: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<["numeric", "categorical", "date", "id", "text"]>;
+    sampleValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    uniqueCount: z.ZodOptional<z.ZodNumber>;
+    nullCount: z.ZodOptional<z.ZodNumber>;
+    totalCount: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "numeric" | "categorical" | "date" | "id" | "text";
+    name: string;
+    sampleValues?: string[] | undefined;
+    uniqueCount?: number | undefined;
+    nullCount?: number | undefined;
+    totalCount?: number | undefined;
+}, {
+    type: "numeric" | "categorical" | "date" | "id" | "text";
+    name: string;
+    sampleValues?: string[] | undefined;
+    uniqueCount?: number | undefined;
+    nullCount?: number | undefined;
+    totalCount?: number | undefined;
+}>, "many">>;
+export declare const dataShapeHintsSchema: z.ZodOptional<z.ZodObject<{
+    rowCount: z.ZodOptional<z.ZodNumber>;
+    categoryCount: z.ZodOptional<z.ZodNumber>;
+    seriesCount: z.ZodOptional<z.ZodNumber>;
+    numericColumnCount: z.ZodOptional<z.ZodNumber>;
+    categoricalColumnCount: z.ZodOptional<z.ZodNumber>;
+    dateColumnCount: z.ZodOptional<z.ZodNumber>;
+    hasTimeSeries: z.ZodOptional<z.ZodBoolean>;
+    hasHierarchy: z.ZodOptional<z.ZodBoolean>;
+    hasNegativeValues: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    dateColumnCount?: number | undefined;
+    categoricalColumnCount?: number | undefined;
+    rowCount?: number | undefined;
+    categoryCount?: number | undefined;
+    seriesCount?: number | undefined;
+    numericColumnCount?: number | undefined;
+    hasTimeSeries?: boolean | undefined;
+    hasHierarchy?: boolean | undefined;
+    hasNegativeValues?: boolean | undefined;
+}, {
+    dateColumnCount?: number | undefined;
+    categoricalColumnCount?: number | undefined;
+    rowCount?: number | undefined;
+    categoryCount?: number | undefined;
+    seriesCount?: number | undefined;
+    numericColumnCount?: number | undefined;
+    hasTimeSeries?: boolean | undefined;
+    hasHierarchy?: boolean | undefined;
+    hasNegativeValues?: boolean | undefined;
+}>>;
+export declare const visualizeInputSchema: z.ZodObject<{
+    data: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>, "many">>;
+    resultId: z.ZodOptional<z.ZodString>;
+    intent: z.ZodString;
+    columns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<["numeric", "categorical", "date", "id", "text"]>;
+        sampleValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        uniqueCount: z.ZodOptional<z.ZodNumber>;
+        nullCount: z.ZodOptional<z.ZodNumber>;
+        totalCount: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "numeric" | "categorical" | "date" | "id" | "text";
+        name: string;
+        sampleValues?: string[] | undefined;
+        uniqueCount?: number | undefined;
+        nullCount?: number | undefined;
+        totalCount?: number | undefined;
+    }, {
+        type: "numeric" | "categorical" | "date" | "id" | "text";
+        name: string;
+        sampleValues?: string[] | undefined;
+        uniqueCount?: number | undefined;
+        nullCount?: number | undefined;
+        totalCount?: number | undefined;
+    }>, "many">>;
+    dataShapeHints: z.ZodOptional<z.ZodObject<{
+        rowCount: z.ZodOptional<z.ZodNumber>;
+        categoryCount: z.ZodOptional<z.ZodNumber>;
+        seriesCount: z.ZodOptional<z.ZodNumber>;
+        numericColumnCount: z.ZodOptional<z.ZodNumber>;
+        categoricalColumnCount: z.ZodOptional<z.ZodNumber>;
+        dateColumnCount: z.ZodOptional<z.ZodNumber>;
+        hasTimeSeries: z.ZodOptional<z.ZodBoolean>;
+        hasHierarchy: z.ZodOptional<z.ZodBoolean>;
+        hasNegativeValues: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        dateColumnCount?: number | undefined;
+        categoricalColumnCount?: number | undefined;
+        rowCount?: number | undefined;
+        categoryCount?: number | undefined;
+        seriesCount?: number | undefined;
+        numericColumnCount?: number | undefined;
+        hasTimeSeries?: boolean | undefined;
+        hasHierarchy?: boolean | undefined;
+        hasNegativeValues?: boolean | undefined;
+    }, {
+        dateColumnCount?: number | undefined;
+        categoricalColumnCount?: number | undefined;
+        rowCount?: number | undefined;
+        categoryCount?: number | undefined;
+        seriesCount?: number | undefined;
+        numericColumnCount?: number | undefined;
+        hasTimeSeries?: boolean | undefined;
+        hasHierarchy?: boolean | undefined;
+        hasNegativeValues?: boolean | undefined;
+    }>>;
+    pattern: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    includeDataTable: z.ZodOptional<z.ZodBoolean>;
+    colorPreferences: z.ZodOptional<z.ZodObject<{
+        palette: z.ZodOptional<z.ZodEnum<["categorical", "blue", "green", "purple", "warm", "blueRed", "greenPurple", "tealOrange", "redGreen", "traffic-light", "profit-loss", "temperature"]>>;
+        highlight: z.ZodOptional<z.ZodObject<{
+            values: z.ZodArray<z.ZodAny, "many">;
+            color: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+            mutedColor: z.ZodOptional<z.ZodString>;
+            mutedOpacity: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            values: any[];
+            color?: string | string[] | undefined;
+            mutedColor?: string | undefined;
+            mutedOpacity?: number | undefined;
+        }, {
+            values: any[];
+            color?: string | string[] | undefined;
+            mutedColor?: string | undefined;
+            mutedOpacity?: number | undefined;
+        }>>;
+        colorField: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        highlight?: {
+            values: any[];
+            color?: string | string[] | undefined;
+            mutedColor?: string | undefined;
+            mutedOpacity?: number | undefined;
+        } | undefined;
+        colorField?: string | undefined;
+        palette?: "categorical" | "blue" | "green" | "purple" | "warm" | "blueRed" | "greenPurple" | "tealOrange" | "redGreen" | "traffic-light" | "profit-loss" | "temperature" | undefined;
+    }, {
+        highlight?: {
+            values: any[];
+            color?: string | string[] | undefined;
+            mutedColor?: string | undefined;
+            mutedOpacity?: number | undefined;
+        } | undefined;
+        colorField?: string | undefined;
+        palette?: "categorical" | "blue" | "green" | "purple" | "warm" | "blueRed" | "greenPurple" | "tealOrange" | "redGreen" | "traffic-light" | "profit-loss" | "temperature" | undefined;
+    }>>;
+    maxAlternativeChartTypes: z.ZodOptional<z.ZodNumber>;
+    geoLevel: z.ZodOptional<z.ZodEnum<["country", "subdivision"]>>;
+    geoRegion: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    intent: string;
+    data?: Record<string, any>[] | undefined;
+    pattern?: string | undefined;
+    title?: string | undefined;
+    columns?: {
+        type: "numeric" | "categorical" | "date" | "id" | "text";
+        name: string;
+        sampleValues?: string[] | undefined;
+        uniqueCount?: number | undefined;
+        nullCount?: number | undefined;
+        totalCount?: number | undefined;
+    }[] | undefined;
+    geoRegion?: string | undefined;
+    colorPreferences?: {
+        highlight?: {
+            values: any[];
+            color?: string | string[] | undefined;
+            mutedColor?: string | undefined;
+            mutedOpacity?: number | undefined;
+        } | undefined;
+        colorField?: string | undefined;
+        palette?: "categorical" | "blue" | "green" | "purple" | "warm" | "blueRed" | "greenPurple" | "tealOrange" | "redGreen" | "traffic-light" | "profit-loss" | "temperature" | undefined;
+    } | undefined;
+    resultId?: string | undefined;
+    dataShapeHints?: {
+        dateColumnCount?: number | undefined;
+        categoricalColumnCount?: number | undefined;
+        rowCount?: number | undefined;
+        categoryCount?: number | undefined;
+        seriesCount?: number | undefined;
+        numericColumnCount?: number | undefined;
+        hasTimeSeries?: boolean | undefined;
+        hasHierarchy?: boolean | undefined;
+        hasNegativeValues?: boolean | undefined;
+    } | undefined;
+    subtitle?: string | undefined;
+    includeDataTable?: boolean | undefined;
+    maxAlternativeChartTypes?: number | undefined;
+    geoLevel?: "country" | "subdivision" | undefined;
+}, {
+    intent: string;
+    data?: Record<string, any>[] | undefined;
+    pattern?: string | undefined;
+    title?: string | undefined;
+    columns?: {
+        type: "numeric" | "categorical" | "date" | "id" | "text";
+        name: string;
+        sampleValues?: string[] | undefined;
+        uniqueCount?: number | undefined;
+        nullCount?: number | undefined;
+        totalCount?: number | undefined;
+    }[] | undefined;
+    geoRegion?: string | undefined;
+    colorPreferences?: {
+        highlight?: {
+            values: any[];
+            color?: string | string[] | undefined;
+            mutedColor?: string | undefined;
+            mutedOpacity?: number | undefined;
+        } | undefined;
+        colorField?: string | undefined;
+        palette?: "categorical" | "blue" | "green" | "purple" | "warm" | "blueRed" | "greenPurple" | "tealOrange" | "redGreen" | "traffic-light" | "profit-loss" | "temperature" | undefined;
+    } | undefined;
+    resultId?: string | undefined;
+    dataShapeHints?: {
+        dateColumnCount?: number | undefined;
+        categoricalColumnCount?: number | undefined;
+        rowCount?: number | undefined;
+        categoryCount?: number | undefined;
+        seriesCount?: number | undefined;
+        numericColumnCount?: number | undefined;
+        hasTimeSeries?: boolean | undefined;
+        hasHierarchy?: boolean | undefined;
+        hasNegativeValues?: boolean | undefined;
+    } | undefined;
+    subtitle?: string | undefined;
+    includeDataTable?: boolean | undefined;
+    maxAlternativeChartTypes?: number | undefined;
+    geoLevel?: "country" | "subdivision" | undefined;
+}>;
+/**
+ * Shared core logic for both visualize and visualize_from_source.
+ * Takes resolved data + args and returns the MCP response.
+ */
+export declare function handleVisualizeCore(selectPatterns: (input: VisualizeInput) => VisualizeOutput, toolName?: string): (data: Record<string, any>[], args: {
+    intent: string;
+    columns?: z.infer<typeof columnsSchema>;
+    dataShapeHints?: z.infer<typeof dataShapeHintsSchema>;
+    pattern?: string;
+    title?: string;
+    subtitle?: string;
+    includeDataTable?: boolean;
+    colorPreferences?: z.infer<typeof colorPreferencesSchema>;
+    maxAlternativeChartTypes?: number;
+    geoLevel?: "country" | "subdivision";
+    geoRegion?: string;
+}, queryMeta?: {
+    truncated?: boolean;
+    totalSourceRows?: number;
+}, extraMeta?: Partial<OperationMeta>) => {
+    structuredContent?: {
+        html: string;
+    } | undefined;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function handleVisualize(selectPatterns: (input: VisualizeInput) => VisualizeOutput): (args: z.infer<typeof visualizeInputSchema>) => Promise<{
+    structuredContent?: {
+        html: string;
+    } | undefined;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=visualize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"visualize.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/visualize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAiC,MAAM,gBAAgB,CAAC;AASrG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GASqC,CAAC;AAEzE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;YAO8D,CAAC;AAEzF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAU6C,CAAC;AAE/E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgB/B,CAAC;AAEH;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,eAAe,EAC1D,QAAQ,GAAE,MAAoB,IAEtB,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;IACxC,cAAc,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;IAC1D,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,EAAE,YAAY;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,YAAY,OAAO,CAAC,aAAa,CAAC;;;;;;;;EAyGrG;AAED,wBAAgB,eAAe,CAC7B,cAAc,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,eAAe,IAI5C,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC;;;;;;;;GAiBzD"}

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

@@ -0,0 +1,190 @@
+/**
+ * MCP Tool: visualize
+ * Takes inline data + intent and returns visualization recommendations
+ * from the handcrafted pattern library.
+ *
+ * For source-based data (sourceId + table + query), use visualize_from_source.
+ *
+ * Returns compact text content (specId + metadata, no data) while
+ * structuredContent still gets the full pre-rendered chart HTML.
+ */
+import { z } from 'zod';
+import { isCompoundSpec } from '../../types.js';
+import { buildChartHtml, isHtmlPatternSupported } from '../../renderers/html/index.js';
+import { shouldCompound, buildCompoundSpec } from '../../renderers/html/compound.js';
+import { buildCompoundHtml } from '../../renderers/html/builders/compound.js';
+import { specStore } from '../spec-store.js';
+import { getResult } from './result-cache.js';
+import { errorResponse, inferColumns, applyColorPreferences } from './shared.js';
+import { logOperation } from './operation-log.js';
+const ALL_PALETTE_NAMES = [
+    'categorical', 'blue', 'green', 'purple', 'warm',
+    'blueRed', 'greenPurple', 'tealOrange', 'redGreen',
+    'traffic-light', 'profit-loss', 'temperature',
+];
+export const colorPreferencesSchema = z.object({
+    palette: z.enum(ALL_PALETTE_NAMES).optional().describe('Named palette: categorical, blue, green, purple, warm, blueRed, greenPurple, tealOrange, redGreen, traffic-light, profit-loss, temperature'),
+    highlight: z.object({
+        values: z.array(z.any()).describe('Values to emphasize — all others become muted gray'),
+        color: z.union([z.string(), z.array(z.string())]).optional().describe('Color(s) for highlighted values. Single CSS color or array matching values length.'),
+        mutedColor: z.string().optional().describe('Color for non-highlighted items (default: #6b7280)'),
+        mutedOpacity: z.number().optional().describe('Opacity for muted items (default: 1.0, lower for stronger de-emphasis)'),
+    }).optional(),
+    colorField: z.string().optional().describe('Which data field to base colors on'),
+}).optional().describe('Color preferences applied to the visualization');
+export const columnsSchema = z.array(z.object({
+    name: z.string(),
+    type: z.enum(['numeric', 'categorical', 'date', 'id', 'text']),
+    sampleValues: z.array(z.string()).optional(),
+    uniqueCount: z.number().optional(),
+    nullCount: z.number().optional(),
+    totalCount: z.number().optional(),
+})).optional().describe('Column metadata — if not provided, will be inferred from data');
+export const dataShapeHintsSchema = z.object({
+    rowCount: z.number().optional(),
+    categoryCount: z.number().optional(),
+    seriesCount: z.number().optional(),
+    numericColumnCount: z.number().optional(),
+    categoricalColumnCount: z.number().optional(),
+    dateColumnCount: z.number().optional(),
+    hasTimeSeries: z.boolean().optional(),
+    hasHierarchy: z.boolean().optional(),
+    hasNegativeValues: z.boolean().optional(),
+}).optional().describe('Hints about the data shape to help pattern selection');
+export const visualizeInputSchema = z.object({
+    data: z.array(z.record(z.any())).optional().describe('Array of data rows to visualize. Optional if resultId is provided.'),
+    resultId: z.string().optional().describe('Result ID from a previous query_source call — reuses cached data without re-sending it'),
+    intent: z.string().describe('What the user wants to see — e.g., "compare sales by region", "show distribution of ages", "how do rankings change over time"'),
+    columns: columnsSchema,
+    dataShapeHints: dataShapeHintsSchema,
+    pattern: z.string().optional().describe('Force a specific chart pattern by ID (e.g. "bar", "beeswarm", "stream-graph"). Use list_patterns to discover IDs. Bypasses scoring; alternatives still returned.'),
+    title: z.string().optional().describe('Chart title — set upfront to avoid a refine round-trip'),
+    subtitle: z.string().optional().describe('Chart subtitle — set upfront to avoid a refine round-trip'),
+    includeDataTable: z.boolean().optional().describe('Whether to add a companion sortable data table with linked highlighting below the chart. Default: true'),
+    colorPreferences: colorPreferencesSchema,
+    maxAlternativeChartTypes: z.number().optional().describe('Max alternative chart type recommendations to return (default: 2, set 0 for none)'),
+    geoLevel: z.enum(['country', 'subdivision']).optional()
+        .describe('Geographic level: "country" (each row = a nation) or "subdivision" (each row = a state/province). Auto-detected if omitted.'),
+    geoRegion: z.string().optional()
+        .describe('Geographic region code: "world", ISO country code (US, CN, AU, etc.), or continent (EU, AF, AS, SA, NA, OC). Auto-detected if omitted.'),
+});
+/**
+ * Shared core logic for both visualize and visualize_from_source.
+ * Takes resolved data + args and returns the MCP response.
+ */
+export function handleVisualizeCore(selectPatterns, toolName = 'visualize') {
+    return (data, args, queryMeta, extraMeta) => {
+        const start = Date.now();
+        const columns = args.columns || inferColumns(data);
+        const maxAlternativeChartTypes = args.maxAlternativeChartTypes ?? 2;
+        const input = {
+            data,
+            intent: args.intent,
+            columns,
+            dataShapeHints: args.dataShapeHints,
+            forcePattern: args.pattern,
+            geoLevel: args.geoLevel,
+            geoRegion: args.geoRegion,
+        };
+        const result = selectPatterns(input);
+        const alternatives = result.alternatives.slice(0, maxAlternativeChartTypes);
+        if (args.colorPreferences) {
+            applyColorPreferences(result.recommended.spec, args.colorPreferences);
+        }
+        const spec = result.recommended.spec;
+        if (args.title)
+            spec.title = args.title;
+        if (args.subtitle)
+            spec.config = { ...spec.config, subtitle: args.subtitle };
+        const hasHtmlBuilder = spec && isHtmlPatternSupported(spec.pattern);
+        let outputHtml;
+        let finalSpec = spec;
+        if (hasHtmlBuilder && shouldCompound(spec, { compound: args.includeDataTable })) {
+            const compoundSpec = buildCompoundSpec(spec, columns);
+            outputHtml = buildCompoundHtml(compoundSpec);
+            finalSpec = compoundSpec;
+        }
+        else if (hasHtmlBuilder) {
+            outputHtml = buildChartHtml(spec);
+        }
+        const alternativesMap = new Map();
+        for (const alt of alternatives) {
+            alternativesMap.set(alt.pattern, alt.spec);
+        }
+        const specId = specStore.save(finalSpec, columns, alternativesMap);
+        const compactResponse = {
+            specId,
+            recommended: {
+                pattern: result.recommended.pattern,
+                title: spec.title,
+                reasoning: result.recommended.reasoning,
+            },
+            alternatives: alternatives.map(a => ({
+                pattern: a.pattern,
+                reasoning: a.reasoning,
+            })),
+            dataShape: {
+                rowCount: data.length,
+                columnCount: columns.length,
+                columns: columns.map(c => ({ name: c.name, type: c.type })),
+                ...(queryMeta?.truncated ? { truncated: true, totalSourceRows: queryMeta.totalSourceRows } : {}),
+            },
+        };
+        if (isCompoundSpec(finalSpec)) {
+            compactResponse.compound = true;
+        }
+        if (['choropleth', 'proportional-symbol'].includes(spec.pattern) && spec.config) {
+            compactResponse.geo = {
+                ...(spec.config.mapType ? { region: spec.config.mapType } : {}),
+                ...(spec.config.projection ? { projection: spec.config.projection } : {}),
+                ...(spec.config.objectName ? { mapFile: spec.config.objectName } : {}),
+            };
+        }
+        logOperation({
+            toolName,
+            timestamp: start,
+            durationMs: Date.now() - start,
+            success: true,
+            meta: {
+                pattern: result.recommended.pattern,
+                specId,
+                alternativesCount: alternatives.length,
+                dataShape: {
+                    rowCount: data.length,
+                    columnCount: columns.length,
+                    columns: columns.map(c => ({ name: c.name, type: c.type })),
+                },
+                ...extraMeta,
+            },
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(compactResponse, null, 2),
+                }],
+            ...(outputHtml ? {
+                structuredContent: {
+                    html: outputHtml,
+                },
+            } : {}),
+        };
+    };
+}
+export function handleVisualize(selectPatterns) {
+    const core = handleVisualizeCore(selectPatterns);
+    return async (args) => {
+        let data = args.data;
+        if (args.resultId) {
+            const cached = getResult(args.resultId);
+            if (!cached) {
+                return errorResponse(`Result "${args.resultId}" not found or expired. Re-run query_source to get a new resultId.`);
+            }
+            data = cached.rows;
+        }
+        if (!data || data.length === 0) {
+            return errorResponse('No data provided. Pass either `data` array or `resultId` from query_source.');
+        }
+        return core(data, args);
+    };
+}
+//# sourceMappingURL=visualize.js.map

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

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

package/dist/src/patterns/definitions/comparison/bar.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Standard Bar Chart — the baseline comparison pattern.
+ *
+ * This is the "default" that every other comparison pattern
+ * must beat. It works well for most categorical comparisons
+ * but is rarely the BEST choice.
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const barPattern: VisualizationPattern;
+//# sourceMappingURL=bar.d.ts.map

package/dist/src/patterns/definitions/comparison/bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bar.d.ts","sourceRoot":"","sources":["../../../../../src/patterns/definitions/comparison/bar.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAiC,MAAM,mBAAmB,CAAC;AAE7F,eAAO,MAAM,UAAU,EAAE,oBAmGxB,CAAC"}

package/dist/src/patterns/definitions/comparison/bar.js

@@ -0,0 +1,99 @@
+/**
+ * Standard Bar Chart — the baseline comparison pattern.
+ *
+ * This is the "default" that every other comparison pattern
+ * must beat. It works well for most categorical comparisons
+ * but is rarely the BEST choice.
+ */
+export const barPattern = {
+    id: 'bar',
+    name: 'Bar Chart',
+    category: 'comparison',
+    description: 'Standard vertical bar chart for comparing values across categories. The reliable default for categorical comparison.',
+    bestFor: 'Simple categorical comparison with 3-15 categories and one value metric.',
+    notFor: 'Time series (use line), part-to-whole (use waffle/stacked), distribution (use histogram/beeswarm), rank changes (use bump chart).',
+    dataRequirements: {
+        minRows: 2,
+        maxRows: 50,
+        requiredColumns: [
+            { type: 'categorical', count: 1, description: 'Category axis' },
+            { type: 'numeric', count: 1, description: 'Value to compare' },
+        ],
+        minCategories: 2,
+        maxCategories: 25,
+    },
+    selectionRules: [
+        {
+            condition: 'Default comparison: categories with one numeric value',
+            weight: 40,
+            matches: (ctx) => {
+                return (ctx.dataShape.categoricalColumnCount >= 1 &&
+                    ctx.dataShape.numericColumnCount >= 1 &&
+                    !ctx.dataShape.hasTimeSeries);
+            },
+        },
+        {
+            condition: 'Moderate category count (3-15)',
+            weight: 15,
+            matches: (ctx) => {
+                return ctx.dataShape.categoryCount >= 3 && ctx.dataShape.categoryCount <= 15;
+            },
+        },
+        {
+            condition: 'Intent includes comparison keywords',
+            weight: 10,
+            matches: (ctx) => {
+                return /\b(compar|rank|top|bottom|highest|lowest|most|least|largest|smallest)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Penalize when better alternatives exist: two-point comparison',
+            weight: -20,
+            matches: (ctx) => {
+                return ctx.dataShape.numericColumnCount === 2 && ctx.dataShape.categoryCount >= 3;
+            },
+        },
+        {
+            condition: 'Penalize for time series data',
+            weight: -30,
+            matches: (ctx) => {
+                return ctx.dataShape.hasTimeSeries;
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const xCol = columns[0];
+        const yCol = columns.length > 1 ? columns[1] : columns[0];
+        const spec = {
+            pattern: 'bar',
+            title: options?.title ?? `${yCol} by ${xCol}`,
+            data,
+            encoding: {
+                x: {
+                    field: xCol,
+                    type: 'nominal',
+                    title: xCol,
+                    sort: 'descending',
+                },
+                y: {
+                    field: yCol,
+                    type: 'quantitative',
+                    title: yCol,
+                },
+                color: {
+                    field: xCol,
+                    type: 'nominal',
+                    scale: {},
+                },
+            },
+            config: {
+                orientation: options?.horizontal ? 'horizontal' : 'vertical',
+                sortBy: options?.sortBy ?? 'value',
+                sortOrder: options?.sortOrder ?? 'descending',
+                showLabels: options?.showLabels ?? (data.length <= 12),
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=bar.js.map

package/dist/src/patterns/definitions/comparison/bar.js.map

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