@sqlrooms/deck 0.29.0-rc.5 → 0.29.0-rc.7

package/dist/ai.d.ts

@@ -0,0 +1,168 @@
+import { type Tool } from 'ai';
+import { z } from 'zod';
+import { type CreateDashboardAgentToolOptions, type CreateDashboardAiToolsOptions, type DashboardToolDeps } from '@sqlrooms/mosaic';
+export declare const DECK_MAP_AI_INSTRUCTIONS = "\nDeck map tools:\n- create_deck_map_config validates and returns a reusable native Deck JSON map config without requiring a dashboard artifact.\n- create_dashboard_map creates or updates an interactive map panel inside a dashboard from a native Deck JSON map config.\n- Use map tools when the user asks for a map, geospatial/spatial visualization, locations, longitude/latitude data, or geometry columns.\n- Author maps with config.spec.layers using Deck JSON layer classes in @@type, such as GeoArrowScatterplotLayer, GeoArrowHeatmapLayer, GeoArrowPolygonLayer, GeoArrowPathLayer, or GeoArrowArcLayer.\n- Bind layers to datasets with _sqlroomsBinding.dataset and put tableName or sqlQuery sources in config.datasets.\n- For data-driven color, use native Deck JSON accessors with {\"@@function\":\"colorScale\", \"field\":\"...\", \"type\":\"sequential\"|\"diverging\"|\"quantize\"|\"quantile\"|\"categorical\", \"scheme\":\"Viridis\", \"domain\":\"auto\"} on color properties such as getFillColor, getLineColor, getColor, getSourceColor, or getTargetColor.\n- Map panels default to a 100000-row runtime data limit; use config.dataPolicy.maxRows only when the map genuinely needs a panel-specific limit.\n- After calling create_dashboard_map, call list_dashboard_panels before your final response and check the map panel issue. If it has a render-error, repair the map config in place instead of saying the map is complete.\n";
+export declare function getDashboardWithDeckMapAiInstructions(): string;
+export declare function createDashboardWithDeckMapAiTools<TState>(options: CreateDashboardAiToolsOptions<TState>): Record<string, Tool>;
+export declare function createDashboardAgentToolWithDeckMaps<TState>(options: CreateDashboardAgentToolOptions<TState>): Tool;
+export declare const DeckMapDashboardConfigParameter: z.ZodObject<{
+    spec: z.ZodObject<{
+        initialViewState: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        viewState: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        controller: z.ZodOptional<z.ZodUnknown>;
+        layers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            '@@type': z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+            _sqlroomsBinding: z.ZodOptional<z.ZodObject<{
+                dataset: z.ZodOptional<z.ZodString>;
+                geometryColumn: z.ZodOptional<z.ZodString>;
+                geometryEncodingHint: z.ZodOptional<z.ZodEnum<{
+                    geoarrow: "geoarrow";
+                    wkb: "wkb";
+                    wkt: "wkt";
+                }>>;
+                sourceGeometryColumn: z.ZodOptional<z.ZodString>;
+                targetGeometryColumn: z.ZodOptional<z.ZodString>;
+                timestampColumn: z.ZodOptional<z.ZodString>;
+                hexagonColumn: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>;
+    datasets: z.ZodRecord<z.ZodString, z.ZodObject<{
+        source: z.ZodOptional<z.ZodObject<{
+            tableName: z.ZodOptional<z.ZodString>;
+            sqlQuery: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        geometryColumn: z.ZodOptional<z.ZodString>;
+        geometryEncodingHint: z.ZodOptional<z.ZodEnum<{
+            geoarrow: "geoarrow";
+            wkb: "wkb";
+            wkt: "wkt";
+        }>>;
+    }, z.core.$loose>>;
+    mapStyle: z.ZodOptional<z.ZodString>;
+    mapProps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    showLegends: z.ZodOptional<z.ZodBoolean>;
+    interaction: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    fitToData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    dataPolicy: z.ZodOptional<z.ZodObject<{
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        maxRows: z.ZodOptional<z.ZodNumber>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    settingsOpen: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+export type DeckMapDashboardConfigToolConfig = z.infer<typeof DeckMapDashboardConfigParameter>;
+export declare const DeckMapConfigToolParameters: z.ZodObject<{
+    title: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    config: z.ZodObject<{
+        spec: z.ZodObject<{
+            initialViewState: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            viewState: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            controller: z.ZodOptional<z.ZodUnknown>;
+            layers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                '@@type': z.ZodOptional<z.ZodString>;
+                id: z.ZodOptional<z.ZodString>;
+                _sqlroomsBinding: z.ZodOptional<z.ZodObject<{
+                    dataset: z.ZodOptional<z.ZodString>;
+                    geometryColumn: z.ZodOptional<z.ZodString>;
+                    geometryEncodingHint: z.ZodOptional<z.ZodEnum<{
+                        geoarrow: "geoarrow";
+                        wkb: "wkb";
+                        wkt: "wkt";
+                    }>>;
+                    sourceGeometryColumn: z.ZodOptional<z.ZodString>;
+                    targetGeometryColumn: z.ZodOptional<z.ZodString>;
+                    timestampColumn: z.ZodOptional<z.ZodString>;
+                    hexagonColumn: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>;
+        datasets: z.ZodRecord<z.ZodString, z.ZodObject<{
+            source: z.ZodOptional<z.ZodObject<{
+                tableName: z.ZodOptional<z.ZodString>;
+                sqlQuery: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            geometryColumn: z.ZodOptional<z.ZodString>;
+            geometryEncodingHint: z.ZodOptional<z.ZodEnum<{
+                geoarrow: "geoarrow";
+                wkb: "wkb";
+                wkt: "wkt";
+            }>>;
+        }, z.core.$loose>>;
+        mapStyle: z.ZodOptional<z.ZodString>;
+        mapProps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        showLegends: z.ZodOptional<z.ZodBoolean>;
+        interaction: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        fitToData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        dataPolicy: z.ZodOptional<z.ZodObject<{
+            disabled: z.ZodOptional<z.ZodBoolean>;
+            maxRows: z.ZodOptional<z.ZodNumber>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export type DeckMapConfigToolParams = z.infer<typeof DeckMapConfigToolParameters>;
+export declare const DeckMapDashboardToolParameters: z.ZodObject<{
+    title: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    config: z.ZodObject<{
+        spec: z.ZodObject<{
+            initialViewState: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            viewState: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            controller: z.ZodOptional<z.ZodUnknown>;
+            layers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                '@@type': z.ZodOptional<z.ZodString>;
+                id: z.ZodOptional<z.ZodString>;
+                _sqlroomsBinding: z.ZodOptional<z.ZodObject<{
+                    dataset: z.ZodOptional<z.ZodString>;
+                    geometryColumn: z.ZodOptional<z.ZodString>;
+                    geometryEncodingHint: z.ZodOptional<z.ZodEnum<{
+                        geoarrow: "geoarrow";
+                        wkb: "wkb";
+                        wkt: "wkt";
+                    }>>;
+                    sourceGeometryColumn: z.ZodOptional<z.ZodString>;
+                    targetGeometryColumn: z.ZodOptional<z.ZodString>;
+                    timestampColumn: z.ZodOptional<z.ZodString>;
+                    hexagonColumn: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>;
+        datasets: z.ZodRecord<z.ZodString, z.ZodObject<{
+            source: z.ZodOptional<z.ZodObject<{
+                tableName: z.ZodOptional<z.ZodString>;
+                sqlQuery: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            geometryColumn: z.ZodOptional<z.ZodString>;
+            geometryEncodingHint: z.ZodOptional<z.ZodEnum<{
+                geoarrow: "geoarrow";
+                wkb: "wkb";
+                wkt: "wkt";
+            }>>;
+        }, z.core.$loose>>;
+        mapStyle: z.ZodOptional<z.ZodString>;
+        mapProps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        showLegends: z.ZodOptional<z.ZodBoolean>;
+        interaction: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        fitToData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        dataPolicy: z.ZodOptional<z.ZodObject<{
+            disabled: z.ZodOptional<z.ZodBoolean>;
+            maxRows: z.ZodOptional<z.ZodNumber>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>;
+    artifactId: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    createArtifactIfMissing: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    panelId: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export type DeckMapDashboardToolParams = z.infer<typeof DeckMapDashboardToolParameters>;
+export declare function createDeckMapConfigTool(): Tool;
+export declare function createDeckMapAiTools(): Record<string, Tool>;
+export declare function createDeckMapDashboardTool(deps: DashboardToolDeps): Tool;
+export declare function createDeckMapDashboardAiTools(deps: DashboardToolDeps): Record<string, Tool>;
+//# sourceMappingURL=ai.d.ts.map

package/dist/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,IAAI,EAAC,MAAM,IAAI,CAAC;AACnC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EAKL,KAAK,+BAA+B,EACpC,KAAK,6BAA6B,EAClC,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAO1B,eAAO,MAAM,wBAAwB,u5CAUpC,CAAC;AAWF,wBAAgB,qCAAqC,WAEpD;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EACtD,OAAO,EAAE,6BAA6B,CAAC,MAAM,CAAC,GAC7C,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAKtB;AAED,wBAAgB,oCAAoC,CAAC,MAAM,EACzD,OAAO,EAAE,+BAA+B,CAAC,MAAM,CAAC,GAC/C,IAAI,CAKN;AA0CD,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkB1C,CAAC;AAEH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CACpD,OAAO,+BAA+B,CACvC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQtC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,2BAA2B,CACnC,CAAC;AAEF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4BvC,CAAC;AAEL,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,8BAA8B,CACtC,CAAC;AAiBF,wBAAgB,uBAAuB,IAAI,IAAI,CAgC9C;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAI3D;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAgFxE;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,iBAAiB,GACtB,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAItB"}

package/dist/ai.js

@@ -0,0 +1,232 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+import { DASHBOARD_AI_INSTRUCTIONS, MAP_TOOL_KEY, createDashboardAgentTool, createDashboardAiTools as createMosaicDashboardAiTools, } from '@sqlrooms/mosaic';
+import { createDeckMapDashboardPanelConfig, DECK_MAP_DASHBOARD_PANEL_TYPE, } from './dashboardConfig';
+export const DECK_MAP_AI_INSTRUCTIONS = `
+Deck map tools:
+- create_deck_map_config validates and returns a reusable native Deck JSON map config without requiring a dashboard artifact.
+- create_dashboard_map creates or updates an interactive map panel inside a dashboard from a native Deck JSON map config.
+- Use map tools when the user asks for a map, geospatial/spatial visualization, locations, longitude/latitude data, or geometry columns.
+- Author maps with config.spec.layers using Deck JSON layer classes in @@type, such as GeoArrowScatterplotLayer, GeoArrowHeatmapLayer, GeoArrowPolygonLayer, GeoArrowPathLayer, or GeoArrowArcLayer.
+- Bind layers to datasets with _sqlroomsBinding.dataset and put tableName or sqlQuery sources in config.datasets.
+- For data-driven color, use native Deck JSON accessors with {"@@function":"colorScale", "field":"...", "type":"sequential"|"diverging"|"quantize"|"quantile"|"categorical", "scheme":"Viridis", "domain":"auto"} on color properties such as getFillColor, getLineColor, getColor, getSourceColor, or getTargetColor.
+- Map panels default to a 100000-row runtime data limit; use config.dataPolicy.maxRows only when the map genuinely needs a panel-specific limit.
+- After calling create_dashboard_map, call list_dashboard_panels before your final response and check the map panel issue. If it has a render-error, repair the map config in place instead of saying the map is complete.
+`;
+function createDeckMapDashboardExtraTools(extraTools) {
+    return (deps) => ({
+        ...createDeckMapDashboardAiTools(deps),
+        ...(extraTools?.(deps) ?? {}),
+    });
+}
+export function getDashboardWithDeckMapAiInstructions() {
+    return `${DASHBOARD_AI_INSTRUCTIONS.trim()}\n\n${DECK_MAP_AI_INSTRUCTIONS.trim()}`;
+}
+export function createDashboardWithDeckMapAiTools(options) {
+    return createMosaicDashboardAiTools({
+        ...options,
+        extraTools: createDeckMapDashboardExtraTools(options.extraTools),
+    });
+}
+export function createDashboardAgentToolWithDeckMaps(options) {
+    return createDashboardAgentTool({
+        ...options,
+        extraTools: createDeckMapDashboardExtraTools(options.extraTools),
+    });
+}
+const DeckMapLayerBindingConfig = z.looseObject({
+    dataset: z.string().optional(),
+    geometryColumn: z.string().optional(),
+    geometryEncodingHint: z.enum(['geoarrow', 'wkb', 'wkt']).optional(),
+    sourceGeometryColumn: z.string().optional(),
+    targetGeometryColumn: z.string().optional(),
+    timestampColumn: z.string().optional(),
+    hexagonColumn: z.string().optional(),
+});
+const DeckMapLayerSpec = z.looseObject({
+    '@@type': z.string().optional(),
+    id: z.string().optional(),
+    _sqlroomsBinding: DeckMapLayerBindingConfig.optional(),
+});
+const DeckMapSpec = z.looseObject({
+    initialViewState: z.record(z.string(), z.unknown()).optional(),
+    viewState: z.record(z.string(), z.unknown()).optional(),
+    controller: z.unknown().optional(),
+    layers: z.array(DeckMapLayerSpec).optional(),
+});
+const DeckMapDatasetSource = z.looseObject({
+    tableName: z.string().optional(),
+    sqlQuery: z.string().optional(),
+});
+const DeckMapDatasetConfig = z.looseObject({
+    source: DeckMapDatasetSource.optional(),
+    geometryColumn: z.string().optional(),
+    geometryEncodingHint: z.enum(['geoarrow', 'wkb', 'wkt']).optional(),
+});
+const DeckMapDataPolicyConfig = z.looseObject({
+    disabled: z.boolean().optional(),
+    maxRows: z.number().int().min(1).optional(),
+    reason: z.string().optional(),
+});
+export const DeckMapDashboardConfigParameter = z.looseObject({
+    spec: DeckMapSpec.describe('Deck JSON map spec as an object. Use spec.layers[].@@type for layer classes such as GeoArrowScatterplotLayer, GeoArrowHeatmapLayer, GeoArrowPolygonLayer, GeoArrowPathLayer, or GeoArrowArcLayer.'),
+    datasets: z
+        .record(z.string(), DeckMapDatasetConfig)
+        .describe('Datasets keyed by dataset id. Layers bind to these ids through _sqlroomsBinding.dataset. Each dataset source may use tableName or sqlQuery.'),
+    mapStyle: z.string().optional(),
+    mapProps: z.record(z.string(), z.unknown()).optional(),
+    showLegends: z.boolean().optional(),
+    interaction: z.record(z.string(), z.unknown()).optional(),
+    fitToData: z.record(z.string(), z.unknown()).optional(),
+    dataPolicy: DeckMapDataPolicyConfig.optional().describe('Optional per-map runtime data policy. Maps default to 100000 rows; set maxRows for a panel-specific override or disabled=true to bypass row-count validation.'),
+    settingsOpen: z.boolean().optional(),
+});
+export const DeckMapConfigToolParameters = z.object({
+    title: z.string().optional().default('Map').describe('Map title.'),
+    config: DeckMapDashboardConfigParameter.describe('Native Deck JSON dashboard map config. This is the canonical map representation.'),
+    reasoning: z
+        .string()
+        .describe('Brief rationale for creating the map config.'),
+});
+export const DeckMapDashboardToolParameters = DeckMapConfigToolParameters.extend({
+    artifactId: z
+        .string()
+        .optional()
+        .describe('Optional dashboard artifact ID. Defaults to current dashboard.'),
+    tableName: z
+        .string()
+        .optional()
+        .describe('Optional table name used only to select/resolve the target dashboard table. Data sources still come from config.datasets.'),
+    createArtifactIfMissing: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('If true, create dashboard artifact if missing.'),
+    panelId: z
+        .string()
+        .optional()
+        .describe('Optional panel ID. If provided, updates the existing map panel instead of creating a new one.'),
+    reasoning: z
+        .string()
+        .describe('Brief rationale for creating the map panel.'),
+});
+function cloneConfig(config) {
+    return JSON.parse(JSON.stringify(config));
+}
+function createDeckMapPanelFromNativeConfig(params) {
+    return createDeckMapDashboardPanelConfig({
+        title: params.title || 'Map',
+        ...cloneConfig(params.config),
+    });
+}
+export function createDeckMapConfigTool() {
+    return tool({
+        description: `Deck map config: validates and returns a reusable native Deck JSON map configuration without requiring a dashboard artifact.
+
+Use when: a chat, agent, or artifact outside a dashboard needs a geospatial map config. Author the map using native Deck JSON: put layer classes in spec.layers[].@@type, bind layers to datasets through _sqlroomsBinding.dataset, and put tableName or sqlQuery sources in config.datasets. For data-driven colors, use color accessors such as getFillColor, getLineColor, getColor, getSourceColor, or getTargetColor with {"@@function":"colorScale", "field":"...", "type":"sequential"|"diverging"|"quantize"|"quantile"|"categorical", "scheme":"Viridis", "domain":"auto"}.`,
+        inputSchema: DeckMapConfigToolParameters,
+        execute: async (params) => {
+            try {
+                const panel = createDeckMapPanelFromNativeConfig(params);
+                return {
+                    llmResult: {
+                        success: true,
+                        details: `Created deck map config "${panel.title}".`,
+                        data: {
+                            kind: 'deck-map-config',
+                            title: panel.title,
+                            type: DECK_MAP_DASHBOARD_PANEL_TYPE,
+                            config: panel.config,
+                        },
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    llmResult: {
+                        success: false,
+                        errorMessage: error instanceof Error ? error.message : String(error),
+                    },
+                };
+            }
+        },
+    });
+}
+export function createDeckMapAiTools() {
+    return {
+        create_deck_map_config: createDeckMapConfigTool(),
+    };
+}
+export function createDeckMapDashboardTool(deps) {
+    return tool({
+        description: `Deck map panel: creates or updates an interactive geospatial map panel in a Mosaic dashboard from a native Deck JSON config.
+
+Use when: the user asks for a map in a dashboard. Author the map using native Deck JSON: choose layer classes with spec.layers[].@@type, bind layers to datasets through _sqlroomsBinding.dataset, and put tableName or sqlQuery sources in config.datasets. For data-driven colors, use color accessors such as getFillColor, getLineColor, getColor, getSourceColor, or getTargetColor with {"@@function":"colorScale", "field":"...", "type":"sequential"|"diverging"|"quantize"|"quantile"|"categorical", "scheme":"Viridis", "domain":"auto"}.`,
+        inputSchema: DeckMapDashboardToolParameters,
+        execute: async (params, context) => {
+            try {
+                const artifactId = deps.resolveArtifact(params.artifactId, params.createArtifactIfMissing, context);
+                if (params.tableName) {
+                    deps.resolveTable(artifactId, params.tableName);
+                }
+                const panel = createDeckMapPanelFromNativeConfig(params);
+                if (params.panelId) {
+                    const dashboard = deps.getDashboard(artifactId);
+                    const existingPanel = dashboard?.panels.find((candidate) => candidate.id === params.panelId);
+                    if (!existingPanel) {
+                        throw new Error(`Panel "${params.panelId}" not found in dashboard "${artifactId}". Cannot update.`);
+                    }
+                    if (existingPanel.type !== DECK_MAP_DASHBOARD_PANEL_TYPE) {
+                        throw new Error(`Panel "${params.panelId}" is not a map panel. Cannot update it with ${MAP_TOOL_KEY}.`);
+                    }
+                    deps.updatePanel(artifactId, params.panelId, {
+                        title: panel.title,
+                        config: panel.config,
+                    });
+                    return {
+                        llmResult: {
+                            success: true,
+                            details: `Updated map panel "${panel.title}".`,
+                            data: {
+                                panelId: params.panelId,
+                                artifactId,
+                                title: panel.title,
+                                type: DECK_MAP_DASHBOARD_PANEL_TYPE,
+                                config: panel.config,
+                            },
+                        },
+                    };
+                }
+                const panelId = deps.addPanel(artifactId, panel);
+                deps.setCurrentArtifact(artifactId);
+                return {
+                    llmResult: {
+                        success: true,
+                        details: `Created map panel "${panel.title}".`,
+                        data: {
+                            panelId,
+                            artifactId,
+                            title: panel.title,
+                            type: DECK_MAP_DASHBOARD_PANEL_TYPE,
+                            config: panel.config,
+                        },
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    llmResult: {
+                        success: false,
+                        errorMessage: error instanceof Error ? error.message : String(error),
+                    },
+                };
+            }
+        },
+    });
+}
+export function createDeckMapDashboardAiTools(deps) {
+    return {
+        [MAP_TOOL_KEY]: createDeckMapDashboardTool(deps),
+    };
+}
+//# sourceMappingURL=ai.js.map

package/dist/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"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","sourcesContent":["import {tool, type Tool} from 'ai';\nimport {z} from 'zod';\nimport {\n  DASHBOARD_AI_INSTRUCTIONS,\n  MAP_TOOL_KEY,\n  createDashboardAgentTool,\n  createDashboardAiTools as createMosaicDashboardAiTools,\n  type CreateDashboardAgentToolOptions,\n  type CreateDashboardAiToolsOptions,\n  type DashboardToolDeps,\n} from '@sqlrooms/mosaic';\nimport {\n  createDeckMapDashboardPanelConfig,\n  DECK_MAP_DASHBOARD_PANEL_TYPE,\n  type DeckMapDashboardPanelConfig,\n} from './dashboardConfig';\n\nexport const DECK_MAP_AI_INSTRUCTIONS = `\nDeck map tools:\n- create_deck_map_config validates and returns a reusable native Deck JSON map config without requiring a dashboard artifact.\n- create_dashboard_map creates or updates an interactive map panel inside a dashboard from a native Deck JSON map config.\n- Use map tools when the user asks for a map, geospatial/spatial visualization, locations, longitude/latitude data, or geometry columns.\n- Author maps with config.spec.layers using Deck JSON layer classes in @@type, such as GeoArrowScatterplotLayer, GeoArrowHeatmapLayer, GeoArrowPolygonLayer, GeoArrowPathLayer, or GeoArrowArcLayer.\n- Bind layers to datasets with _sqlroomsBinding.dataset and put tableName or sqlQuery sources in config.datasets.\n- For data-driven color, use native Deck JSON accessors with {\"@@function\":\"colorScale\", \"field\":\"...\", \"type\":\"sequential\"|\"diverging\"|\"quantize\"|\"quantile\"|\"categorical\", \"scheme\":\"Viridis\", \"domain\":\"auto\"} on color properties such as getFillColor, getLineColor, getColor, getSourceColor, or getTargetColor.\n- Map panels default to a 100000-row runtime data limit; use config.dataPolicy.maxRows only when the map genuinely needs a panel-specific limit.\n- After calling create_dashboard_map, call list_dashboard_panels before your final response and check the map panel issue. If it has a render-error, repair the map config in place instead of saying the map is complete.\n`;\n\nfunction createDeckMapDashboardExtraTools(\n  extraTools?: (deps: DashboardToolDeps) => Record<string, Tool>,\n) {\n  return (deps: DashboardToolDeps) => ({\n    ...createDeckMapDashboardAiTools(deps),\n    ...(extraTools?.(deps) ?? {}),\n  });\n}\n\nexport function getDashboardWithDeckMapAiInstructions() {\n  return `${DASHBOARD_AI_INSTRUCTIONS.trim()}\\n\\n${DECK_MAP_AI_INSTRUCTIONS.trim()}`;\n}\n\nexport function createDashboardWithDeckMapAiTools<TState>(\n  options: CreateDashboardAiToolsOptions<TState>,\n): Record<string, Tool> {\n  return createMosaicDashboardAiTools({\n    ...options,\n    extraTools: createDeckMapDashboardExtraTools(options.extraTools),\n  });\n}\n\nexport function createDashboardAgentToolWithDeckMaps<TState>(\n  options: CreateDashboardAgentToolOptions<TState>,\n): Tool {\n  return createDashboardAgentTool({\n    ...options,\n    extraTools: createDeckMapDashboardExtraTools(options.extraTools),\n  }) as Tool;\n}\n\nconst DeckMapLayerBindingConfig = z.looseObject({\n  dataset: z.string().optional(),\n  geometryColumn: z.string().optional(),\n  geometryEncodingHint: z.enum(['geoarrow', 'wkb', 'wkt']).optional(),\n  sourceGeometryColumn: z.string().optional(),\n  targetGeometryColumn: z.string().optional(),\n  timestampColumn: z.string().optional(),\n  hexagonColumn: z.string().optional(),\n});\n\nconst DeckMapLayerSpec = z.looseObject({\n  '@@type': z.string().optional(),\n  id: z.string().optional(),\n  _sqlroomsBinding: DeckMapLayerBindingConfig.optional(),\n});\n\nconst DeckMapSpec = z.looseObject({\n  initialViewState: z.record(z.string(), z.unknown()).optional(),\n  viewState: z.record(z.string(), z.unknown()).optional(),\n  controller: z.unknown().optional(),\n  layers: z.array(DeckMapLayerSpec).optional(),\n});\n\nconst DeckMapDatasetSource = z.looseObject({\n  tableName: z.string().optional(),\n  sqlQuery: z.string().optional(),\n});\n\nconst DeckMapDatasetConfig = z.looseObject({\n  source: DeckMapDatasetSource.optional(),\n  geometryColumn: z.string().optional(),\n  geometryEncodingHint: z.enum(['geoarrow', 'wkb', 'wkt']).optional(),\n});\n\nconst DeckMapDataPolicyConfig = z.looseObject({\n  disabled: z.boolean().optional(),\n  maxRows: z.number().int().min(1).optional(),\n  reason: z.string().optional(),\n});\n\nexport const DeckMapDashboardConfigParameter = z.looseObject({\n  spec: DeckMapSpec.describe(\n    'Deck JSON map spec as an object. Use spec.layers[].@@type for layer classes such as GeoArrowScatterplotLayer, GeoArrowHeatmapLayer, GeoArrowPolygonLayer, GeoArrowPathLayer, or GeoArrowArcLayer.',\n  ),\n  datasets: z\n    .record(z.string(), DeckMapDatasetConfig)\n    .describe(\n      'Datasets keyed by dataset id. Layers bind to these ids through _sqlroomsBinding.dataset. Each dataset source may use tableName or sqlQuery.',\n    ),\n  mapStyle: z.string().optional(),\n  mapProps: z.record(z.string(), z.unknown()).optional(),\n  showLegends: z.boolean().optional(),\n  interaction: z.record(z.string(), z.unknown()).optional(),\n  fitToData: z.record(z.string(), z.unknown()).optional(),\n  dataPolicy: DeckMapDataPolicyConfig.optional().describe(\n    'Optional per-map runtime data policy. Maps default to 100000 rows; set maxRows for a panel-specific override or disabled=true to bypass row-count validation.',\n  ),\n  settingsOpen: z.boolean().optional(),\n});\n\nexport type DeckMapDashboardConfigToolConfig = z.infer<\n  typeof DeckMapDashboardConfigParameter\n>;\n\nexport const DeckMapConfigToolParameters = z.object({\n  title: z.string().optional().default('Map').describe('Map title.'),\n  config: DeckMapDashboardConfigParameter.describe(\n    'Native Deck JSON dashboard map config. This is the canonical map representation.',\n  ),\n  reasoning: z\n    .string()\n    .describe('Brief rationale for creating the map config.'),\n});\n\nexport type DeckMapConfigToolParams = z.infer<\n  typeof DeckMapConfigToolParameters\n>;\n\nexport const DeckMapDashboardToolParameters =\n  DeckMapConfigToolParameters.extend({\n    artifactId: z\n      .string()\n      .optional()\n      .describe(\n        'Optional dashboard artifact ID. Defaults to current dashboard.',\n      ),\n    tableName: z\n      .string()\n      .optional()\n      .describe(\n        'Optional table name used only to select/resolve the target dashboard table. Data sources still come from config.datasets.',\n      ),\n    createArtifactIfMissing: z\n      .boolean()\n      .optional()\n      .default(true)\n      .describe('If true, create dashboard artifact if missing.'),\n    panelId: z\n      .string()\n      .optional()\n      .describe(\n        'Optional panel ID. If provided, updates the existing map panel instead of creating a new one.',\n      ),\n    reasoning: z\n      .string()\n      .describe('Brief rationale for creating the map panel.'),\n  });\n\nexport type DeckMapDashboardToolParams = z.infer<\n  typeof DeckMapDashboardToolParameters\n>;\n\nfunction cloneConfig(\n  config: DeckMapDashboardConfigToolConfig,\n): DeckMapDashboardPanelConfig {\n  return JSON.parse(JSON.stringify(config)) as DeckMapDashboardPanelConfig;\n}\n\nfunction createDeckMapPanelFromNativeConfig(\n  params: Pick<DeckMapConfigToolParams, 'title' | 'config'>,\n) {\n  return createDeckMapDashboardPanelConfig({\n    title: params.title || 'Map',\n    ...cloneConfig(params.config),\n  });\n}\n\nexport function createDeckMapConfigTool(): Tool {\n  return tool({\n    description: `Deck map config: validates and returns a reusable native Deck JSON map configuration without requiring a dashboard artifact.\n\nUse when: a chat, agent, or artifact outside a dashboard needs a geospatial map config. Author the map using native Deck JSON: put layer classes in spec.layers[].@@type, bind layers to datasets through _sqlroomsBinding.dataset, and put tableName or sqlQuery sources in config.datasets. For data-driven colors, use color accessors such as getFillColor, getLineColor, getColor, getSourceColor, or getTargetColor with {\"@@function\":\"colorScale\", \"field\":\"...\", \"type\":\"sequential\"|\"diverging\"|\"quantize\"|\"quantile\"|\"categorical\", \"scheme\":\"Viridis\", \"domain\":\"auto\"}.`,\n    inputSchema: DeckMapConfigToolParameters,\n    execute: async (params) => {\n      try {\n        const panel = createDeckMapPanelFromNativeConfig(params);\n        return {\n          llmResult: {\n            success: true,\n            details: `Created deck map config \"${panel.title}\".`,\n            data: {\n              kind: 'deck-map-config',\n              title: panel.title,\n              type: DECK_MAP_DASHBOARD_PANEL_TYPE,\n              config: panel.config,\n            },\n          },\n        };\n      } catch (error) {\n        return {\n          llmResult: {\n            success: false,\n            errorMessage:\n              error instanceof Error ? error.message : String(error),\n          },\n        };\n      }\n    },\n  });\n}\n\nexport function createDeckMapAiTools(): Record<string, Tool> {\n  return {\n    create_deck_map_config: createDeckMapConfigTool(),\n  };\n}\n\nexport function createDeckMapDashboardTool(deps: DashboardToolDeps): Tool {\n  return tool({\n    description: `Deck map panel: creates or updates an interactive geospatial map panel in a Mosaic dashboard from a native Deck JSON config.\n\nUse when: the user asks for a map in a dashboard. Author the map using native Deck JSON: choose layer classes with spec.layers[].@@type, bind layers to datasets through _sqlroomsBinding.dataset, and put tableName or sqlQuery sources in config.datasets. For data-driven colors, use color accessors such as getFillColor, getLineColor, getColor, getSourceColor, or getTargetColor with {\"@@function\":\"colorScale\", \"field\":\"...\", \"type\":\"sequential\"|\"diverging\"|\"quantize\"|\"quantile\"|\"categorical\", \"scheme\":\"Viridis\", \"domain\":\"auto\"}.`,\n    inputSchema: DeckMapDashboardToolParameters,\n    execute: async (params, context) => {\n      try {\n        const artifactId = deps.resolveArtifact(\n          params.artifactId,\n          params.createArtifactIfMissing,\n          context,\n        );\n        if (params.tableName) {\n          deps.resolveTable(artifactId, params.tableName);\n        }\n        const panel = createDeckMapPanelFromNativeConfig(params);\n\n        if (params.panelId) {\n          const dashboard = deps.getDashboard(artifactId);\n          const existingPanel = dashboard?.panels.find(\n            (candidate) => candidate.id === params.panelId,\n          );\n          if (!existingPanel) {\n            throw new Error(\n              `Panel \"${params.panelId}\" not found in dashboard \"${artifactId}\". Cannot update.`,\n            );\n          }\n          if (existingPanel.type !== DECK_MAP_DASHBOARD_PANEL_TYPE) {\n            throw new Error(\n              `Panel \"${params.panelId}\" is not a map panel. Cannot update it with ${MAP_TOOL_KEY}.`,\n            );\n          }\n          deps.updatePanel(artifactId, params.panelId, {\n            title: panel.title,\n            config: panel.config,\n          } as never);\n\n          return {\n            llmResult: {\n              success: true,\n              details: `Updated map panel \"${panel.title}\".`,\n              data: {\n                panelId: params.panelId,\n                artifactId,\n                title: panel.title,\n                type: DECK_MAP_DASHBOARD_PANEL_TYPE,\n                config: panel.config,\n              },\n            },\n          };\n        }\n\n        const panelId = deps.addPanel(artifactId, panel);\n        deps.setCurrentArtifact(artifactId);\n\n        return {\n          llmResult: {\n            success: true,\n            details: `Created map panel \"${panel.title}\".`,\n            data: {\n              panelId,\n              artifactId,\n              title: panel.title,\n              type: DECK_MAP_DASHBOARD_PANEL_TYPE,\n              config: panel.config,\n            },\n          },\n        };\n      } catch (error) {\n        return {\n          llmResult: {\n            success: false,\n            errorMessage:\n              error instanceof Error ? error.message : String(error),\n          },\n        };\n      }\n    },\n  });\n}\n\nexport function createDeckMapDashboardAiTools(\n  deps: DashboardToolDeps,\n): Record<string, Tool> {\n  return {\n    [MAP_TOOL_KEY]: createDeckMapDashboardTool(deps),\n  };\n}\n"]}

package/dist/dashboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../src/dashboard.tsx"],"names":[],"mappings":"AAWA,OAAO,EAIL,KAAK,4BAA4B,EAKlC,MAAM,kBAAkB,CAAC;AAuoB1B,eAAO,MAAM,6BAA6B,EAAE,4BAI3C,CAAC;AAqFF,eAAO,MAAM,8BAA8B,EAAE,OAAO,kBAAkB,EAAE,6BASrE,CAAC"}
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../src/dashboard.tsx"],"names":[],"mappings":"AAUA,OAAO,EAIL,KAAK,4BAA4B,EASlC,MAAM,kBAAkB,CAAC;AAwvB1B,eAAO,MAAM,6BAA6B,EAAE,4BAI3C,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,OAAO,kBAAkB,EAAE,6BAmBrE,CAAC"}