@outsidedata/dolex 0.1.0

package/dist/src/mcp/tools/visualize-from-source.d.ts

@@ -0,0 +1,518 @@
+/**
+ * MCP Tool: visualize_from_source
+ * Takes a data source + DSL query + intent and returns visualization
+ * recommendations from the handcrafted pattern library.
+ *
+ * For inline data, use the `visualize` tool instead.
+ */
+import { z } from 'zod';
+import type { VisualizeInput, VisualizeOutput } from '../../types.js';
+export declare const visualizeFromSourceInputSchema: z.ZodObject<{
+    sourceId: z.ZodString;
+    table: z.ZodString;
+    query: z.ZodEffects<z.ZodObject<{
+        join: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            table: z.ZodString;
+            on: z.ZodObject<{
+                left: z.ZodString;
+                right: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                left: string;
+                right: string;
+            }, {
+                left: string;
+                right: string;
+            }>;
+            type: z.ZodOptional<z.ZodEnum<["inner", "left"]>>;
+        }, "strip", z.ZodTypeAny, {
+            table: string;
+            on: {
+                left: string;
+                right: string;
+            };
+            type?: "inner" | "left" | undefined;
+        }, {
+            table: string;
+            on: {
+                left: string;
+                right: string;
+            };
+            type?: "inner" | "left" | undefined;
+        }>, "many">>;
+        select: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            field: z.ZodString;
+            aggregate: z.ZodEnum<["sum", "avg", "min", "max", "count", "count_distinct", "median", "p25", "p75", "stddev", "percentile"]>;
+            as: z.ZodString;
+            percentile: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            aggregate: "sum" | "avg" | "min" | "max" | "count" | "count_distinct" | "median" | "p25" | "p75" | "stddev" | "percentile";
+            field: string;
+            as: string;
+            percentile?: number | undefined;
+        }, {
+            aggregate: "sum" | "avg" | "min" | "max" | "count" | "count_distinct" | "median" | "p25" | "p75" | "stddev" | "percentile";
+            field: string;
+            as: string;
+            percentile?: number | undefined;
+        }>, z.ZodObject<{
+            window: z.ZodEnum<["lag", "lead", "rank", "dense_rank", "row_number", "running_sum", "running_avg", "pct_of_total"]>;
+            field: z.ZodOptional<z.ZodString>;
+            as: z.ZodString;
+            partitionBy: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                field: z.ZodString;
+                direction: z.ZodEnum<["asc", "desc"]>;
+            }, "strip", z.ZodTypeAny, {
+                field: string;
+                direction: "asc" | "desc";
+            }, {
+                field: string;
+                direction: "asc" | "desc";
+            }>, "many">>;
+            offset: z.ZodOptional<z.ZodNumber>;
+            default: z.ZodOptional<z.ZodAny>;
+        }, "strip", z.ZodTypeAny, {
+            window: "lag" | "lead" | "rank" | "dense_rank" | "row_number" | "running_sum" | "running_avg" | "pct_of_total";
+            as: string;
+            field?: string | undefined;
+            offset?: number | undefined;
+            default?: any;
+            orderBy?: {
+                field: string;
+                direction: "asc" | "desc";
+            }[] | undefined;
+            partitionBy?: string[] | undefined;
+        }, {
+            window: "lag" | "lead" | "rank" | "dense_rank" | "row_number" | "running_sum" | "running_avg" | "pct_of_total";
+            as: string;
+            field?: string | undefined;
+            offset?: number | undefined;
+            default?: any;
+            orderBy?: {
+                field: string;
+                direction: "asc" | "desc";
+            }[] | undefined;
+            partitionBy?: string[] | undefined;
+        }>]>, "many">;
+        groupBy: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            field: z.ZodString;
+            bucket: z.ZodEnum<["day", "week", "month", "quarter", "year"]>;
+        }, "strip", z.ZodTypeAny, {
+            field: string;
+            bucket: "day" | "week" | "month" | "quarter" | "year";
+        }, {
+            field: string;
+            bucket: "day" | "week" | "month" | "quarter" | "year";
+        }>]>, "many">>;
+        filter: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<["=", "!=", ">", ">=", "<", "<=", "in", "not_in", "between", "is_null", "is_not_null"]>;
+            value: z.ZodOptional<z.ZodAny>;
+        }, "strip", z.ZodTypeAny, {
+            field: string;
+            op: "=" | "!=" | ">" | ">=" | "<" | "<=" | "in" | "not_in" | "between" | "is_null" | "is_not_null";
+            value?: any;
+        }, {
+            field: string;
+            op: "=" | "!=" | ">" | ">=" | "<" | "<=" | "in" | "not_in" | "between" | "is_null" | "is_not_null";
+            value?: any;
+        }>, "many">>;
+        having: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodEnum<["=", "!=", ">", ">=", "<", "<=", "in", "not_in", "between", "is_null", "is_not_null"]>;
+            value: z.ZodOptional<z.ZodAny>;
+        }, "strip", z.ZodTypeAny, {
+            field: string;
+            op: "=" | "!=" | ">" | ">=" | "<" | "<=" | "in" | "not_in" | "between" | "is_null" | "is_not_null";
+            value?: any;
+        }, {
+            field: string;
+            op: "=" | "!=" | ">" | ">=" | "<" | "<=" | "in" | "not_in" | "between" | "is_null" | "is_not_null";
+            value?: any;
+        }>, "many">>;
+        orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            direction: z.ZodEnum<["asc", "desc"]>;
+        }, "strip", z.ZodTypeAny, {
+            field: string;
+            direction: "asc" | "desc";
+        }, {
+            field: string;
+            direction: "asc" | "desc";
+        }>, "many">>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        select: (string | {
+            aggregate: "sum" | "avg" | "min" | "max" | "count" | "count_distinct" | "median" | "p25" | "p75" | "stddev" | "percentile";
+            field: string;
+            as: string;
+            percentile?: number | undefined;
+        } | {
+            window: "lag" | "lead" | "rank" | "dense_rank" | "row_number" | "running_sum" | "running_avg" | "pct_of_total";
+            as: string;
+            field?: string | undefined;
+            offset?: number | undefined;
+            default?: any;
+            orderBy?: {
+                field: string;
+                direction: "asc" | "desc";
+            }[] | undefined;
+            partitionBy?: string[] | undefined;
+        })[];
+        join?: {
+            table: string;
+            on: {
+                left: string;
+                right: string;
+            };
+            type?: "inner" | "left" | undefined;
+        }[] | undefined;
+        filter?: {
+            field: string;
+            op: "=" | "!=" | ">" | ">=" | "<" | "<=" | "in" | "not_in" | "between" | "is_null" | "is_not_null";
+            value?: any;
+        }[] | undefined;
+        groupBy?: (string | {
+            field: string;
+            bucket: "day" | "week" | "month" | "quarter" | "year";
+        })[] | undefined;
+        having?: {
+            field: string;
+            op: "=" | "!=" | ">" | ">=" | "<" | "<=" | "in" | "not_in" | "between" | "is_null" | "is_not_null";
+            value?: any;
+        }[] | undefined;
+        orderBy?: {
+            field: string;
+            direction: "asc" | "desc";
+        }[] | undefined;
+        limit?: number | undefined;
+    }, {
+        select: (string | {
+            aggregate: "sum" | "avg" | "min" | "max" | "count" | "count_distinct" | "median" | "p25" | "p75" | "stddev" | "percentile";
+            field: string;
+            as: string;
+            percentile?: number | undefined;
+        } | {
+            window: "lag" | "lead" | "rank" | "dense_rank" | "row_number" | "running_sum" | "running_avg" | "pct_of_total";
+            as: string;
+            field?: string | undefined;
+            offset?: number | undefined;
+            default?: any;
+            orderBy?: {
+                field: string;
+                direction: "asc" | "desc";
+            }[] | undefined;
+            partitionBy?: string[] | undefined;
+        })[];
+        join?: {
+            table: string;
+            on: {
+                left: string;
+                right: string;
+            };
+            type?: "inner" | "left" | undefined;
+        }[] | undefined;
+        filter?: {
+            field: string;
+            op: "=" | "!=" | ">" | ">=" | "<" | "<=" | "in" | "not_in" | "between" | "is_null" | "is_not_null";
+            value?: any;
+        }[] | undefined;
+        groupBy?: (string | {
+            field: string;
+            bucket: "day" | "week" | "month" | "quarter" | "year";
+        })[] | undefined;
+        having?: {
+            field: string;
+            op: "=" | "!=" | ">" | ">=" | "<" | "<=" | "in" | "not_in" | "between" | "is_null" | "is_not_null";
+            value?: any;
+        }[] | undefined;
+        orderBy?: {
+            field: string;
+            direction: "asc" | "desc";
+        }[] | undefined;
+        limit?: number | undefined;
+    }>, {
+        select: (string | {
+            aggregate: "sum" | "avg" | "min" | "max" | "count" | "count_distinct" | "median" | "p25" | "p75" | "stddev" | "percentile";
+            field: string;
+            as: string;
+            percentile?: number | undefined;
+        } | {
+            window: "lag" | "lead" | "rank" | "dense_rank" | "row_number" | "running_sum" | "running_avg" | "pct_of_total";
+            as: string;
+            field?: string | undefined;
+            offset?: number | undefined;
+            default?: any;
+            orderBy?: {
+                field: string;
+                direction: "asc" | "desc";
+            }[] | undefined;
+            partitionBy?: string[] | undefined;
+        })[];
+        join?: {
+            table: string;
+            on: {
+                left: string;
+                right: string;
+            };
+            type?: "inner" | "left" | undefined;
+        }[] | undefined;
+        filter?: {
+            field: string;
+            op: "=" | "!=" | ">" | ">=" | "<" | "<=" | "in" | "not_in" | "between" | "is_null" | "is_not_null";
+            value?: any;
+        }[] | undefined;
+        groupBy?: (string | {
+            field: string;
+            bucket: "day" | "week" | "month" | "quarter" | "year";
+        })[] | undefined;
+        having?: {
+            field: string;
+            op: "=" | "!=" | ">" | ">=" | "<" | "<=" | "in" | "not_in" | "between" | "is_null" | "is_not_null";
+            value?: any;
+        }[] | undefined;
+        orderBy?: {
+            field: string;
+            direction: "asc" | "desc";
+        }[] | undefined;
+        limit?: number | undefined;
+    }, unknown>;
+    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, {
+    table: string;
+    intent: string;
+    query: {
+        select: (string | {
+            aggregate: "sum" | "avg" | "min" | "max" | "count" | "count_distinct" | "median" | "p25" | "p75" | "stddev" | "percentile";
+            field: string;
+            as: string;
+            percentile?: number | undefined;
+        } | {
+            window: "lag" | "lead" | "rank" | "dense_rank" | "row_number" | "running_sum" | "running_avg" | "pct_of_total";
+            as: string;
+            field?: string | undefined;
+            offset?: number | undefined;
+            default?: any;
+            orderBy?: {
+                field: string;
+                direction: "asc" | "desc";
+            }[] | undefined;
+            partitionBy?: string[] | undefined;
+        })[];
+        join?: {
+            table: string;
+            on: {
+                left: string;
+                right: string;
+            };
+            type?: "inner" | "left" | undefined;
+        }[] | undefined;
+        filter?: {
+            field: string;
+            op: "=" | "!=" | ">" | ">=" | "<" | "<=" | "in" | "not_in" | "between" | "is_null" | "is_not_null";
+            value?: any;
+        }[] | undefined;
+        groupBy?: (string | {
+            field: string;
+            bucket: "day" | "week" | "month" | "quarter" | "year";
+        })[] | undefined;
+        having?: {
+            field: string;
+            op: "=" | "!=" | ">" | ">=" | "<" | "<=" | "in" | "not_in" | "between" | "is_null" | "is_not_null";
+            value?: any;
+        }[] | undefined;
+        orderBy?: {
+            field: string;
+            direction: "asc" | "desc";
+        }[] | undefined;
+        limit?: number | undefined;
+    };
+    sourceId: string;
+    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;
+    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;
+}, {
+    table: string;
+    intent: string;
+    sourceId: string;
+    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;
+    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;
+    query?: unknown;
+}>;
+export declare function handleVisualizeFromSource(selectPatterns: (input: VisualizeInput) => VisualizeOutput, deps: {
+    sourceManager: any;
+}): (args: z.infer<typeof visualizeFromSourceInputSchema>) => Promise<{
+    structuredContent?: {
+        html: string;
+    } | undefined;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=visualize-from-source.d.ts.map

package/dist/src/mcp/tools/visualize-from-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualize-from-source.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/visualize-from-source.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAWtE,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBzC,CAAC;AAEH,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,eAAe,EAC1D,IAAI,EAAE;IAAE,aAAa,EAAE,GAAG,CAAA;CAAE,IAId,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC;;;;;;;;GA+BnE"}

package/dist/src/mcp/tools/visualize-from-source.js

@@ -0,0 +1,61 @@
+/**
+ * MCP Tool: visualize_from_source
+ * Takes a data source + DSL query + intent and returns visualization
+ * recommendations from the handcrafted pattern library.
+ *
+ * For inline data, use the `visualize` tool instead.
+ */
+import { z } from 'zod';
+import { dslQuerySchema } from './dsl-schemas.js';
+import { colorPreferencesSchema, columnsSchema, dataShapeHintsSchema, handleVisualizeCore, } from './visualize.js';
+import { errorResponse } from './shared.js';
+import { logOperation, extractDslStructure } from './operation-log.js';
+export const visualizeFromSourceInputSchema = z.object({
+    sourceId: z.string().describe('Source ID from add_source'),
+    table: z.string().describe('Base table within the source'),
+    query: dslQuerySchema.describe('Declarative query to slice/aggregate the data before visualizing'),
+    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.'),
+});
+export function handleVisualizeFromSource(selectPatterns, deps) {
+    const core = handleVisualizeCore(selectPatterns, 'visualize_from_source');
+    return async (args) => {
+        const start = Date.now();
+        if (!deps.sourceManager) {
+            return errorResponse('Source manager not available.');
+        }
+        const source = deps.sourceManager.get?.(args.sourceId);
+        const sourceType = source?.type;
+        const result = await deps.sourceManager.queryDsl(args.sourceId, args.table, args.query);
+        if (!result.ok) {
+            logOperation({
+                toolName: 'visualize_from_source',
+                timestamp: start,
+                durationMs: Date.now() - start,
+                success: false,
+                meta: {
+                    dslStructure: extractDslStructure(args.query),
+                    sourceType,
+                    error: result.error,
+                },
+            });
+            return errorResponse(result.error);
+        }
+        return core(result.rows, args, { truncated: result.truncated, totalSourceRows: result.totalRows }, {
+            dslStructure: extractDslStructure(args.query),
+            sourceType,
+        });
+    };
+}
+//# sourceMappingURL=visualize-from-source.js.map

package/dist/src/mcp/tools/visualize-from-source.js.map

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