@sqlrooms/mosaic 0.29.0-rc.6 → 0.29.0-rc.7

package/dist/ai/list-panels-tool.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import type { DashboardToolDeps } from '../charts/chart-types/base-types';
+export declare const ListPanelsToolParameters: z.ZodObject<{
+    artifactId: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export type ListPanelsToolParams = z.infer<typeof ListPanelsToolParameters>;
+export declare function createListPanelsTool(deps: DashboardToolDeps): import("ai").Tool<{
+    reasoning: string;
+    artifactId?: string | undefined;
+}, {
+    llmResult: {
+        success: boolean;
+        errorMessage: string;
+        details?: undefined;
+        data?: undefined;
+    };
+} | {
+    llmResult: {
+        success: boolean;
+        details: string;
+        data: {
+            artifactId: string;
+            panels: {
+                issue?: import("..").ChartRuntimeIssue | undefined;
+                id: any;
+                type: any;
+                title: any;
+                config: any;
+            }[];
+        };
+        errorMessage?: undefined;
+    };
+}>;
+//# sourceMappingURL=list-panels-tool.d.ts.map

package/dist/ai/list-panels-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-panels-tool.d.ts","sourceRoot":"","sources":["../../src/ai/list-panels-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,kCAAkC,CAAC;AAExE,eAAO,MAAM,wBAAwB;;;iBAQnC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE5E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;GAwD3D"}

package/dist/ai/list-panels-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-panels-tool.js","sourceRoot":"","sources":["../../src/ai/list-panels-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AACxB,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gEAAgE,CAAC;IAC7E,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,+CAA+C,CAAC;CAC7D,CAAC,CAAC;AAIH,MAAM,UAAU,oBAAoB,CAAC,IAAuB;IAC1D,OAAO,IAAI,CAAC;QACV,WAAW,EAAE;;;;;;oEAMmD;QAChE,WAAW,EAAE,wBAAwB;QACrC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACxB,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAE3D,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;gBAChD,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,OAAO;wBACL,SAAS,EAAE;4BACT,OAAO,EAAE,KAAK;4BACd,YAAY,EAAE,cAAc,UAAU,cAAc;yBACrD;qBACF,CAAC;gBACJ,CAAC;gBAED,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAU,EAAE,EAAE;oBACjD,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;oBACzD,OAAO;wBACL,EAAE,EAAE,KAAK,CAAC,EAAE;wBACZ,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;wBAClB,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAC,KAAK,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;qBAC1B,CAAC;gBACJ,CAAC,CAAC,CAAC;gBAEH,OAAO;oBACL,SAAS,EAAE;wBACT,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,SAAS,MAAM,CAAC,MAAM,yBAAyB;wBACxD,IAAI,EAAE;4BACJ,UAAU;4BACV,MAAM;yBACP;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,SAAS,EAAE;wBACT,OAAO,EAAE,KAAK;wBACd,YAAY,EACV,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBACzD;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {tool} from 'ai';\nimport {z} from 'zod';\nimport type {DashboardToolDeps} from '../charts/chart-types/base-types';\n\nexport const ListPanelsToolParameters = z.object({\n  artifactId: z\n    .string()\n    .optional()\n    .describe('Optional dashboard artifact ID. Defaults to current dashboard.'),\n  reasoning: z\n    .string()\n    .describe('Brief rationale for listing dashboard panels.'),\n});\n\nexport type ListPanelsToolParams = z.infer<typeof ListPanelsToolParameters>;\n\nexport function createListPanelsTool(deps: DashboardToolDeps) {\n  return tool({\n    description: `List dashboard panels: returns all panels in the current dashboard with their IDs, types, titles, configurations, and any current runtime issue.\n\nUse when: you need to discover panel IDs before updating or removing panels, or when user asks \"what's on this dashboard\".\n\nRuntime issues are transient chart diagnostics such as too-much-data or sql-error. If a panel has an issue, use the panel ID to update it in place with a safer chart configuration.\n\nReturns array of: {id, type, title, config, issue?} for each panel.`,\n    inputSchema: ListPanelsToolParameters,\n    execute: async (params) => {\n      try {\n        const artifactId = deps.resolveArtifact(params.artifactId);\n\n        const dashboard = deps.getDashboard(artifactId);\n        if (!dashboard) {\n          return {\n            llmResult: {\n              success: false,\n              errorMessage: `Dashboard \"${artifactId}\" not found.`,\n            },\n          };\n        }\n\n        const panels = dashboard.panels.map((panel: any) => {\n          const issue = deps.getPanelIssue?.(artifactId, panel.id);\n          return {\n            id: panel.id,\n            type: panel.type,\n            title: panel.title,\n            config: panel.config,\n            ...(issue ? {issue} : {}),\n          };\n        });\n\n        return {\n          llmResult: {\n            success: true,\n            details: `Found ${panels.length} panel(s) in dashboard.`,\n            data: {\n              artifactId,\n              panels,\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"]}

package/dist/ai/remove-panel-tool.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import type { DashboardToolDeps } from '../charts/chart-types/base-types';
+export declare const RemovePanelToolParameters: z.ZodObject<{
+    artifactId: z.ZodOptional<z.ZodString>;
+    panelId: z.ZodString;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export type RemovePanelToolParams = z.infer<typeof RemovePanelToolParameters>;
+export declare function createRemovePanelTool(deps: DashboardToolDeps): import("ai").Tool<{
+    panelId: string;
+    reasoning: string;
+    artifactId?: string | undefined;
+}, {
+    llmResult: {
+        success: boolean;
+        details: string;
+        data: {
+            artifactId: string;
+            panelId: string;
+        };
+        errorMessage?: undefined;
+    };
+} | {
+    llmResult: {
+        success: boolean;
+        errorMessage: string;
+        details?: undefined;
+        data?: undefined;
+    };
+}>;
+//# sourceMappingURL=remove-panel-tool.d.ts.map

package/dist/ai/remove-panel-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-panel-tool.d.ts","sourceRoot":"","sources":["../../src/ai/remove-panel-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,kCAAkC,CAAC;AAExE,eAAO,MAAM,yBAAyB;;;;iBAWpC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE9E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;GA+C5D"}

package/dist/ai/remove-panel-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-panel-tool.js","sourceRoot":"","sources":["../../src/ai/remove-panel-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AACxB,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gEAAgE,CAAC;IAC7E,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CACP,6EAA6E,CAC9E;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;CAC3E,CAAC,CAAC;AAIH,MAAM,UAAU,qBAAqB,CAAC,IAAuB;IAC3D,OAAO,IAAI,CAAC;QACV,WAAW,EAAE;;;;uDAIsC;QACnD,WAAW,EAAE,yBAAyB;QACtC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACxB,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;gBAChD,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,MAAM,IAAI,KAAK,CAAC,cAAc,UAAU,cAAc,CAAC,CAAC;gBAC1D,CAAC;gBACD,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CACvC,CAAC,KAAmB,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,OAAO,CACrD,CAAC;gBACF,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CACb,UAAU,MAAM,CAAC,OAAO,6BAA6B,UAAU,mBAAmB,CACnF,CAAC;gBACJ,CAAC;gBAED,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;gBAE7C,OAAO;oBACL,SAAS,EAAE;wBACT,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,kBAAkB,MAAM,CAAC,OAAO,mBAAmB;wBAC5D,IAAI,EAAE;4BACJ,UAAU;4BACV,OAAO,EAAE,MAAM,CAAC,OAAO;yBACxB;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,SAAS,EAAE;wBACT,OAAO,EAAE,KAAK;wBACd,YAAY,EACV,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBACzD;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {tool} from 'ai';\nimport {z} from 'zod';\nimport type {DashboardToolDeps} from '../charts/chart-types/base-types';\n\nexport const RemovePanelToolParameters = z.object({\n  artifactId: z\n    .string()\n    .optional()\n    .describe('Optional dashboard artifact ID. Defaults to current dashboard.'),\n  panelId: z\n    .string()\n    .describe(\n      'ID of the panel to remove. Use list_dashboard_panels to discover panel IDs.',\n    ),\n  reasoning: z.string().describe('Brief rationale for removing this panel.'),\n});\n\nexport type RemovePanelToolParams = z.infer<typeof RemovePanelToolParameters>;\n\nexport function createRemovePanelTool(deps: DashboardToolDeps) {\n  return tool({\n    description: `Remove dashboard panel: deletes a panel from the dashboard by its ID.\n\nUse when: user asks to \"remove\", \"delete\", \"get rid of\" a specific panel.\n\nUse list_dashboard_panels first to discover panel IDs.`,\n    inputSchema: RemovePanelToolParameters,\n    execute: async (params) => {\n      try {\n        const artifactId = deps.resolveArtifact(params.artifactId);\n        const dashboard = deps.getDashboard(artifactId);\n        if (!dashboard) {\n          throw new Error(`Dashboard \"${artifactId}\" not found.`);\n        }\n        const panelExists = dashboard.panels.some(\n          (panel: {id: string}) => panel.id === params.panelId,\n        );\n        if (!panelExists) {\n          throw new Error(\n            `Panel \"${params.panelId}\" not found in dashboard \"${artifactId}\". Cannot remove.`,\n          );\n        }\n\n        deps.removePanel(artifactId, params.panelId);\n\n        return {\n          llmResult: {\n            success: true,\n            details: `Removed panel \"${params.panelId}\" from dashboard.`,\n            data: {\n              artifactId,\n              panelId: params.panelId,\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"]}

package/dist/ai/tool-helpers.d.ts

@@ -0,0 +1,34 @@
+import type { DashboardToolDeps } from '../charts/chart-types/base-types';
+import type { DataTableExplorerPanelConfig } from '../dashboard/core-types';
+import type { ChartConfig } from '../charts/chart-types/chart-config';
+export interface PanelResult {
+    panelId: string;
+    artifactId: string;
+    title: string;
+    config: ChartConfig | DataTableExplorerPanelConfig;
+}
+export interface CreateOrUpdateChartPanelParams {
+    panelId?: string;
+    dashboardId: string;
+    tableName: string;
+    title: string;
+    config: ChartConfig;
+}
+export interface CreateOrUpdateDataTableExplorerPanelParams {
+    panelId?: string;
+    dashboardId: string;
+    tableName: string;
+    title: string;
+    config: DataTableExplorerPanelConfig;
+}
+/**
+ * Universal helper to create or update a chart panel.
+ * Handles everything: panel config creation, add/update logic, artifact switching.
+ * When updating, both source and config are updated to allow changing the data source.
+ */
+export declare function createOrUpdateChartPanel(deps: DashboardToolDeps, params: CreateOrUpdateChartPanelParams): PanelResult;
+/**
+ * Universal helper to create or update a dataTableExplorer panel.
+ */
+export declare function createOrUpdateDataTableExplorerPanel(deps: DashboardToolDeps, params: CreateOrUpdateDataTableExplorerPanelParams): PanelResult;
+//# sourceMappingURL=tool-helpers.d.ts.map

package/dist/ai/tool-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-helpers.d.ts","sourceRoot":"","sources":["../../src/ai/tool-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,kCAAkC,CAAC;AAMxE,OAAO,KAAK,EAAC,4BAA4B,EAAC,MAAM,yBAAyB,CAAC;AAC1E,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,oCAAoC,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,4BAA4B,CAAC;CACpD;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,0CAA0C;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,4BAA4B,CAAC;CACtC;AAkCD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,8BAA8B,GACrC,WAAW,CAoCb;AAED;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,0CAA0C,GACjD,WAAW,CAmCb"}

package/dist/ai/tool-helpers.js

@@ -0,0 +1,93 @@
+import { createMosaicDashboardChartPanelConfig, createMosaicDashboardDataTableExplorerPanelConfig, } from '../dashboard/MosaicDashboardSlice';
+/**
+ * Validates that a dashboard exists. Throws if not found.
+ */
+function ensureDashboard(deps, dashboardId) {
+    const dashboard = deps.getDashboard(dashboardId);
+    if (!dashboard) {
+        throw new Error(`Dashboard "${dashboardId}" not found. Cannot update panel.`);
+    }
+    return dashboard;
+}
+/**
+ * Validates that a panel exists in a dashboard. Throws if not found.
+ */
+function ensurePanel(dashboard, dashboardId, panelId) {
+    const panelExists = dashboard.panels.some((p) => p.id === panelId);
+    if (!panelExists) {
+        throw new Error(`Panel "${panelId}" not found in dashboard "${dashboardId}". Cannot update.`);
+    }
+}
+/**
+ * Universal helper to create or update a chart panel.
+ * Handles everything: panel config creation, add/update logic, artifact switching.
+ * When updating, both source and config are updated to allow changing the data source.
+ */
+export function createOrUpdateChartPanel(deps, params) {
+    if (params.panelId) {
+        // Validate panel exists before attempting update
+        const dashboard = ensureDashboard(deps, params.dashboardId);
+        ensurePanel(dashboard, params.dashboardId, params.panelId);
+        // Update existing panel - update both source and config
+        deps.updatePanel(params.dashboardId, params.panelId, {
+            title: params.title,
+            source: { tableName: params.tableName },
+            config: params.config,
+        });
+        return {
+            panelId: params.panelId,
+            artifactId: params.dashboardId,
+            title: params.title,
+            config: params.config,
+        };
+    }
+    else {
+        // Create new panel - create config and add to dashboard
+        const panel = createMosaicDashboardChartPanelConfig(params.title, params.config);
+        const panelId = deps.addPanel(params.dashboardId, panel);
+        deps.setCurrentArtifact(params.dashboardId);
+        return {
+            panelId,
+            artifactId: params.dashboardId,
+            title: params.title,
+            config: params.config,
+        };
+    }
+}
+/**
+ * Universal helper to create or update a dataTableExplorer panel.
+ */
+export function createOrUpdateDataTableExplorerPanel(deps, params) {
+    if (params.panelId) {
+        // Validate panel exists before attempting update
+        const dashboard = ensureDashboard(deps, params.dashboardId);
+        ensurePanel(dashboard, params.dashboardId, params.panelId);
+        deps.updatePanel(params.dashboardId, params.panelId, {
+            config: params.config,
+            source: { tableName: params.tableName },
+            title: params.title,
+        });
+        return {
+            panelId: params.panelId,
+            artifactId: params.dashboardId,
+            title: params.title,
+            config: params.config,
+        };
+    }
+    else {
+        // Create new panel - create full panel config
+        const panel = createMosaicDashboardDataTableExplorerPanelConfig({
+            title: params.title,
+            config: params.config,
+        });
+        const panelId = deps.addPanel(params.dashboardId, panel);
+        deps.setCurrentArtifact(params.dashboardId);
+        return {
+            panelId,
+            artifactId: params.dashboardId,
+            title: panel.title,
+            config: panel.config,
+        };
+    }
+}
+//# sourceMappingURL=tool-helpers.js.map

package/dist/ai/tool-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-helpers.js","sourceRoot":"","sources":["../../src/ai/tool-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import type {DashboardToolDeps} from '../charts/chart-types/base-types';\nimport {\n  createMosaicDashboardChartPanelConfig,\n  createMosaicDashboardDataTableExplorerPanelConfig,\n} from '../dashboard/MosaicDashboardSlice';\nimport {MosaicDashboardEntry} from '../dashboard/dashboard-types';\nimport type {DataTableExplorerPanelConfig} from '../dashboard/core-types';\nimport type {ChartConfig} from '../charts/chart-types/chart-config';\n\nexport interface PanelResult {\n  panelId: string;\n  artifactId: string;\n  title: string;\n  config: ChartConfig | DataTableExplorerPanelConfig;\n}\n\nexport interface CreateOrUpdateChartPanelParams {\n  panelId?: string;\n  dashboardId: string;\n  tableName: string;\n  title: string;\n  config: ChartConfig;\n}\n\nexport interface CreateOrUpdateDataTableExplorerPanelParams {\n  panelId?: string;\n  dashboardId: string;\n  tableName: string;\n  title: string;\n  config: DataTableExplorerPanelConfig;\n}\n\n/**\n * Validates that a dashboard exists. Throws if not found.\n */\nfunction ensureDashboard(\n  deps: DashboardToolDeps,\n  dashboardId: string,\n): NonNullable<ReturnType<DashboardToolDeps['getDashboard']>> {\n  const dashboard = deps.getDashboard(dashboardId);\n  if (!dashboard) {\n    throw new Error(\n      `Dashboard \"${dashboardId}\" not found. Cannot update panel.`,\n    );\n  }\n  return dashboard;\n}\n\n/**\n * Validates that a panel exists in a dashboard. Throws if not found.\n */\nfunction ensurePanel(\n  dashboard: MosaicDashboardEntry,\n  dashboardId: string,\n  panelId: string,\n): void {\n  const panelExists = dashboard.panels.some((p) => p.id === panelId);\n  if (!panelExists) {\n    throw new Error(\n      `Panel \"${panelId}\" not found in dashboard \"${dashboardId}\". Cannot update.`,\n    );\n  }\n}\n\n/**\n * Universal helper to create or update a chart panel.\n * Handles everything: panel config creation, add/update logic, artifact switching.\n * When updating, both source and config are updated to allow changing the data source.\n */\nexport function createOrUpdateChartPanel(\n  deps: DashboardToolDeps,\n  params: CreateOrUpdateChartPanelParams,\n): PanelResult {\n  if (params.panelId) {\n    // Validate panel exists before attempting update\n    const dashboard = ensureDashboard(deps, params.dashboardId);\n    ensurePanel(dashboard, params.dashboardId, params.panelId);\n\n    // Update existing panel - update both source and config\n    deps.updatePanel(params.dashboardId, params.panelId, {\n      title: params.title,\n      source: {tableName: params.tableName},\n      config: params.config,\n    });\n\n    return {\n      panelId: params.panelId,\n      artifactId: params.dashboardId,\n      title: params.title,\n      config: params.config,\n    };\n  } else {\n    // Create new panel - create config and add to dashboard\n    const panel = createMosaicDashboardChartPanelConfig(\n      params.title,\n      params.config,\n    );\n\n    const panelId = deps.addPanel(params.dashboardId, panel);\n    deps.setCurrentArtifact(params.dashboardId);\n\n    return {\n      panelId,\n      artifactId: params.dashboardId,\n      title: params.title,\n      config: params.config,\n    };\n  }\n}\n\n/**\n * Universal helper to create or update a dataTableExplorer panel.\n */\nexport function createOrUpdateDataTableExplorerPanel(\n  deps: DashboardToolDeps,\n  params: CreateOrUpdateDataTableExplorerPanelParams,\n): PanelResult {\n  if (params.panelId) {\n    // Validate panel exists before attempting update\n    const dashboard = ensureDashboard(deps, params.dashboardId);\n    ensurePanel(dashboard, params.dashboardId, params.panelId);\n\n    deps.updatePanel(params.dashboardId, params.panelId, {\n      config: params.config,\n      source: {tableName: params.tableName},\n      title: params.title,\n    });\n\n    return {\n      panelId: params.panelId,\n      artifactId: params.dashboardId,\n      title: params.title,\n      config: params.config,\n    };\n  } else {\n    // Create new panel - create full panel config\n    const panel = createMosaicDashboardDataTableExplorerPanelConfig({\n      title: params.title,\n      config: params.config,\n    });\n\n    const panelId = deps.addPanel(params.dashboardId, panel);\n    deps.setCurrentArtifact(params.dashboardId);\n\n    return {\n      panelId,\n      artifactId: params.dashboardId,\n      title: panel.title,\n      config: panel.config,\n    };\n  }\n}\n"]}

package/dist/ai/tool-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schemas.d.ts","sourceRoot":"","sources":["../../src/ai/tool-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,eAAO,MAAM,uBAAuB;;;;;;iBAuBlC,CAAC"}

package/dist/ai/tool-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schemas.js","sourceRoot":"","sources":["../../src/ai/tool-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,wIAAwI,CACzI;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;IACtE,uBAAuB,EAAE,CAAC;SACvB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,gDAAgD,CAAC;IAC7D,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yFAAyF,CAC1F;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CACxE,CAAC,CAAC","sourcesContent":["import {z} from 'zod';\n\nexport const BaseChartToolParameters = z.object({\n  artifactId: z\n    .string()\n    .optional()\n    .describe(\n      'Optional dashboard artifact ID. Prefer passing this explicitly; if omitted, the host may use an unambiguous primary dashboard context.',\n    ),\n  tableName: z\n    .string()\n    .optional()\n    .describe('Optional table name. Use when no table is selected yet.'),\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 panel instead of creating new one.',\n    ),\n  reasoning: z.string().describe('Brief rationale for the chart choice.'),\n});\n"]}

package/dist/ai/tool-types.d.ts

@@ -0,0 +1,26 @@
+import { ChartConfig } from '../charts/chart-types/chart-config';
+import type { ChartBuilderColumn } from '../charts/chart-types/base-types';
+export interface ResolvedChartResourcesParams {
+    artifactId?: string;
+    tableName?: string;
+    createArtifactIfMissing?: boolean;
+}
+export interface ResolvedChartResources {
+    artifactId: string;
+    tableName: string;
+    columns: ChartBuilderColumn[];
+}
+export interface CreateChartParams {
+    artifactId: string;
+    tableName: string;
+    title: string;
+    config: ChartConfig;
+}
+export interface CreateChartResult {
+    panelId: string;
+    artifactId: string;
+    tableName: string;
+    title: string;
+    config: ChartConfig;
+}
+//# sourceMappingURL=tool-types.d.ts.map

package/dist/ai/tool-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-types.d.ts","sourceRoot":"","sources":["../../src/ai/tool-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,kCAAkC,CAAC;AAEzE,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;CACrB"}

package/dist/ai/tool-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-types.js","sourceRoot":"","sources":["../../src/ai/tool-types.ts"],"names":[],"mappings":"","sourcesContent":["import {ChartConfig} from '../charts/chart-types/chart-config';\nimport type {ChartBuilderColumn} from '../charts/chart-types/base-types';\n\nexport interface ResolvedChartResourcesParams {\n  artifactId?: string;\n  tableName?: string;\n  createArtifactIfMissing?: boolean;\n}\n\nexport interface ResolvedChartResources {\n  artifactId: string;\n  tableName: string;\n  columns: ChartBuilderColumn[];\n}\n\nexport interface CreateChartParams {\n  artifactId: string;\n  tableName: string;\n  title: string;\n  config: ChartConfig;\n}\n\nexport interface CreateChartResult {\n  panelId: string;\n  artifactId: string;\n  tableName: string;\n  title: string;\n  config: ChartConfig;\n}\n"]}

package/dist/ai/tool-validation.d.ts

@@ -0,0 +1,3 @@
+import type { ChartBuilderColumn } from '../charts/chart-types/base-types';
+export declare function validateColumnExists(columnName: string, expectedTypes: string[] | undefined, columns: ChartBuilderColumn[], fieldKey: string): void;
+//# sourceMappingURL=tool-validation.d.ts.map

package/dist/ai/tool-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-validation.d.ts","sourceRoot":"","sources":["../../src/ai/tool-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,kCAAkC,CAAC;AAEzE,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EAAE,GAAG,SAAS,EACnC,OAAO,EAAE,kBAAkB,EAAE,EAC7B,QAAQ,EAAE,MAAM,GACf,IAAI,CAkBN"}

package/dist/ai/tool-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-validation.js","sourceRoot":"","sources":["../../src/ai/tool-validation.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAClC,UAAkB,EAClB,aAAmC,EACnC,OAA6B,EAC7B,QAAgB;IAEhB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IAC1E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,mBAAmB,UAAU,gBAAgB,QAAQ,yBAAyB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,GAAG,CACnI,CAAC;IACJ,CAAC;IAED,IACE,aAAa,EAAE,MAAM;QACrB,CAAC,aAAa,CAAC,IAAI,CACjB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAC3D,EACD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,WAAW,UAAU,cAAc,MAAM,CAAC,IAAI,eAAe,QAAQ,aAAa,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9G,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import type {ChartBuilderColumn} from '../charts/chart-types/base-types';\n\nexport function validateColumnExists(\n  columnName: string,\n  expectedTypes: string[] | undefined,\n  columns: ChartBuilderColumn[],\n  fieldKey: string,\n): void {\n  const column = columns.find((candidate) => candidate.name === columnName);\n  if (!column) {\n    throw new Error(\n      `Unknown column \"${columnName}\" for field \"${fieldKey}\". Available columns: ${columns.map((c) => c.name).join(', ') || '(none)'}.`,\n    );\n  }\n\n  if (\n    expectedTypes?.length &&\n    !expectedTypes.some(\n      (type) => type.toUpperCase() === column.type.toUpperCase(),\n    )\n  ) {\n    throw new Error(\n      `Column \"${columnName}\" has type ${column.type} but field \"${fieldKey}\" expects ${expectedTypes.join(', ')}.`,\n    );\n  }\n}\n"]}

package/dist/ai.d.ts

@@ -1,103 +1,6 @@
 /**
- * Reusable AI helpers for Mosaic dashboards.
- *
- * Host apps provide a narrow adapter for their store/artifact model; Mosaic owns
- * the dashboard tool behavior and prompts.
- *
+ * AI tools and utilities for Mosaic dashboards
  * @packageDocumentation
  */
-import { type LanguageModel, type Tool, ToolLoopAgent } from 'ai';
-import { type ChartBuilderColumn, type ChartToolExecutionContext, type DashboardToolDeps, type PanelPatch, type ChartTypeDefinition } from './chart-types';
-import type { MosaicDashboardEntry, MosaicDashboardPanelConfig } from './dashboard/dashboard-types';
-import type { MosaicDashboardLayoutType } from './dashboard/core-types';
-import { type ChartRuntimeIssue } from './chart-runtime';
-export type { ChartToolExecutionContext } from './chart-types';
-export type DashboardAiStore<TState> = {
-    getState: () => TState;
-};
-export type DashboardAiTable = {
-    tableName: string;
-    columns?: ChartBuilderColumn[];
-    rowCount?: number;
-};
-export type DashboardAiAdapter<TState> = {
-    getTables: (state: TState) => DashboardAiTable[];
-    hasRunContext?: (state: TState, context?: ChartToolExecutionContext) => boolean;
-    resolveContextDashboardArtifactId?: (state: TState, context?: ChartToolExecutionContext) => string | undefined;
-    makeDashboardPrimaryForRun?: (state: TState, dashboardId: string, context?: ChartToolExecutionContext) => void;
-    getCurrentDashboardArtifactId: (state: TState) => string | undefined;
-    createDashboardArtifact: (state: TState, title?: string, layoutType?: MosaicDashboardLayoutType) => string;
-    isDashboardArtifact: (state: TState, artifactId: string) => boolean;
-    setCurrentArtifact: (state: TState, artifactId: string) => void;
-    ensureDashboard: (state: TState, dashboardId: string, title?: string, layoutType?: MosaicDashboardLayoutType) => void;
-    getDashboard: (state: TState, dashboardId: string) => MosaicDashboardEntry | undefined;
-    getPanelIssue?: (state: TState, dashboardId: string, panelId: string) => ChartRuntimeIssue | undefined;
-    setSelectedTable: (state: TState, dashboardId: string, tableName: string) => void;
-    addPanel: (state: TState, dashboardId: string, panel: MosaicDashboardPanelConfig) => string;
-    updatePanel: (state: TState, dashboardId: string, panelId: string, patch: Partial<PanelPatch>) => void;
-    removePanel: (state: TState, dashboardId: string, panelId: string) => void;
-};
-export type CreateDashboardToolDepsOptions<TState> = {
-    store: DashboardAiStore<TState>;
-    adapter: DashboardAiAdapter<TState>;
-};
-export type CreateDashboardAiToolsOptions<TState> = CreateDashboardToolDepsOptions<TState> & {
-    chartTypes?: ChartTypeDefinition<any>[];
-    /**
-     * Host-provided dashboard tools keyed by their registered tool name.
-     * Register geospatial map tools under MAP_TOOL_KEY so prompts and tools
-     * stay in sync.
-     */
-    extraTools?: (deps: DashboardToolDeps) => Record<string, Tool>;
-};
-export type DashboardAgentToolCall = {
-    toolName: string;
-};
-export type DashboardAgentRunResult = {
-    finalOutput?: string;
-    agentToolCalls?: DashboardAgentToolCall[];
-};
-export type DashboardAgentResult = {
-    success: boolean;
-    finalOutput: string;
-    dashboardId: string;
-    error?: string;
-    metadata?: {
-        tableName: string;
-        panelsCreated: number;
-        stepsExecuted: number;
-        queriesRun: number;
-    };
-};
-export type CreateDashboardAgentToolOptions<TState> = CreateDashboardToolDepsOptions<TState> & {
-    getModel: (args: {
-        state: TState;
-    }) => LanguageModel;
-    createQueryTools?: (args: {
-        store: DashboardAiStore<TState>;
-    }) => {
-        query: Tool;
-    };
-    runSubAgent: (args: {
-        agent: ToolLoopAgent<any, any, any>;
-        prompt: string;
-        store: DashboardAiStore<TState>;
-        parentToolCallId: string;
-        abortSignal?: AbortSignal;
-    }) => Promise<DashboardAgentRunResult>;
-    instructions?: string;
-    chartTypes?: ChartTypeDefinition<any>[];
-    /**
-     * Host-provided dashboard tools keyed by their registered tool name.
-     * Register geospatial map tools under MAP_TOOL_KEY so prompts and tools
-     * stay in sync.
-     */
-    extraTools?: (deps: DashboardToolDeps) => Record<string, Tool>;
-};
-export declare const MAP_TOOL_KEY = "create_dashboard_map";
-export declare const DASHBOARD_AI_INSTRUCTIONS = "\nDashboard authoring:\n\n**When to use dashboard_agent vs individual tools:**\n- Use `dashboard_agent` for exploratory requests that require data analysis and discovery:\n  - \"analyze the earthquakes dataset\"\n  - \"create insights dashboard for sales data\"\n  - \"find interesting patterns in customer behavior\"\n  - Any request asking to \"discover\", \"explore\", \"find insights\", or \"analyze\"\n- Use individual chart tools for direct, specific requests:\n  - \"create histogram of magnitude with 20 bins\"\n  - \"add a line chart showing sales over time\"\n  - \"update the histogram to use 30 bins\"\n\n**Individual dashboard chart tools:**\n- create_dashboard_histogram, create_dashboard_line_chart, create_dashboard_box_plot, create_dashboard_bubble_chart, create_dashboard_count_plot, create_dashboard_heatmap\n- Each chart type has its own tool with specific parameters.\n- For line charts with aggregation, use yFields array with {field: string, aggregate: \"sum\"|\"avg\"|\"min\"|\"max\"}.\n- Set xInterval for temporal binning (year, month, day, hour, etc.).\n- If the host app provides `create_dashboard_map`, use it for map/geospatial/location requests and tables with longitude/latitude or geometry columns. Author its config as native Deck JSON with layer classes in `spec.layers[].@@type`, dataset bindings in `_sqlroomsBinding.dataset`, and table/query sources in `config.datasets`. For data-driven map 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- Use `set_dashboard_vgplot` with complete JSON only when no chart tool fits your needs.\n- When calling `create_dashboard_artifact`, `layoutType` may be `grid` or `dock`; omitted values default to `grid`.\n- Ensure specs are valid JSON objects compatible with https://idl.uw.edu/mosaic/schema/latest.json.\n- `list_dashboard_panels` includes runtime issues when a chart failed. Use those issues to repair panels in place: convert too-large bubble charts to heatmaps, add `xInterval` to too-large line charts, and inspect columns/settings for SQL errors.\n";
-export declare const DASHBOARD_AGENT_INSTRUCTIONS = "You are a dashboard builder agent that creates and modifies interactive data dashboards.\n\n## Your Role\n\nYou analyze data and create insightful dashboards with multiple visualizations (charts, profilers, text annotations). You can handle both direct requests (\"create histogram of magnitude\") and exploratory requests (\"find interesting insights in earthquakes dataset\").\n\n## Available Tools\n\n**Chart Tools:**\n- create_dashboard_histogram - distribution of numeric values (always safe, aggregates automatically)\n- create_dashboard_line_chart - trends over time or ordered variable (use with aggregations for >10k rows)\n- create_dashboard_box_plot - compare distributions across categories\n- create_dashboard_bubble_chart - relationship between two numeric columns (avoid for >10k rows, use heatmap instead)\n- create_dashboard_count_plot - frequency of categorical values (always safe, aggregates automatically)\n- create_dashboard_heatmap - density/patterns across two dimensions (preferred for large datasets)\n\n**Panel Tools:**\n- create_dashboard_profiler - table statistics and column summaries\n- create_dashboard_text_panel - markdown annotations and insights\n- create_dashboard_map - native Deck JSON geospatial map panel (if provided by the host app)\n\n**Data Tools:**\n- query - execute SQL queries for data exploration\n\n**Management Tools:**\n- list_dashboard_panels - discover panel IDs and what's on the dashboard\n- remove_dashboard_panel - delete a panel by ID\n\n## Workflows\n\n### Direct Requests\nWhen user provides specific instructions:\n1. Parse intent -> identify chart type\n2. Call appropriate tool with settings\n3. Done\n\nExample: \"create histogram of magnitude with 20 bins\"\n-> create_dashboard_histogram(settings: {field: \"magnitude\", bins: 20})\n\n### Exploratory Requests\nWhen user asks to discover insights:\n1. Use query tool to explore data:\n   - Start with simple stats: COUNT, MIN, MAX, AVG, DISTINCT (check total row count!)\n   - Check distributions: GROUP BY with COUNT\n   - Find correlations: CORR(col1, col2)\n   - Identify outliers and patterns\n2. Create targeted charts based on discoveries:\n   - If dataset has >10k rows: avoid bubble charts and unaggregated line charts\n   - Use histogram, count plot, heatmap, or aggregated visualizations instead\n3. **ALWAYS create ONE text panel** with a concise summary of ALL key findings\n4. Stop when dashboard tells coherent story\n\n**CRITICAL:**\n- Create exactly ONE text panel with insights summary (can be first, last, or in between)\n- Insights should be concise but USEFUL - each bullet should provide actionable or interesting information\n- Include specific numbers, percentages, and comparisons that tell the story\n- Use query tool to discover actual patterns, don't make vague statements\n- Focus on 3-5 most important findings that answer \"what's interesting about this data?\"\n- Do NOT create additional text panels unless absolutely necessary\n\n**Good insight examples:**\n- \"Peak activity between 4-5 magnitude (62% of events)\" - specific, actionable\n- \"Strong correlation (0.73) between depth and magnitude suggests tectonic pattern\" - specific with interpretation\n- \"California accounts for 3,234/5,234 events (62%), followed by Japan (18%)\" - specific comparison\n\n**Bad insight examples:**\n- \"Dataset has data\" - useless\n- \"Various magnitudes observed\" - vague\n- \"Interesting patterns found\" - not specific\n\n### Update Requests\nTo update existing panels:\n1. Call list_dashboard_panels() to discover panel IDs\n2. Call appropriate create tool with panelId parameter\n3. Panel is updated in-place\n\n## Query Guidelines\n\n**Keep queries simple:**\n- Start with aggregations: COUNT, MIN, MAX, AVG, SUM\n- Use GROUP BY for breakdowns and distributions\n- Use LIMIT to control result size (especially with GROUP BY)\n- Avoid expensive operations: large JOINs, full table scans\n\n**Exploration strategy:**\n- Limit exploration to 5-10 queries per request\n- Start broad (overall stats), then narrow (specific patterns)\n- Stop when you have enough insights for a coherent dashboard\n\n## Best Practices\n\n- **ONE text panel for exploratory requests:** Always create exactly ONE text panel with insights summary when exploring data. It can be created at any point in the workflow.\n- **Make insights useful, not just concise:** Each bullet should include specific numbers, percentages, or patterns discovered through queries. Avoid vague statements.\n- **Use queries to find real insights:** Run queries to discover actual patterns (correlations, distributions, outliers, top values). Don't make assumptions.\n- **No additional text panels:** Do NOT create multiple text panels. All insights go in the single summary panel.\n- **Avoid unaggregated charts for large datasets:** For datasets >10k rows, DO NOT use bubble charts or line charts without aggregations. Use aggregated alternatives instead:\n  - For scatter/bubble plots: use heatmap or binned aggregations\n  - For line charts: use GROUP BY with time buckets or aggregations\n  - Histograms and count plots are always safe (they aggregate automatically)\n- **Check before update:** Always call list_dashboard_panels before updating/removing panels\n- **Repair broken charts:** list_dashboard_panels may return an `issue` per panel. For `too-much-data`, switch to an aggregated chart or add aggregation. For `sql-error`, inspect available columns/types and update the broken panel in place.\n- **Validate columns:** Query tools will validate column existence and types\n- **Handle errors gracefully:** If a query or chart creation fails, try alternative approach\n- **Use markdown formatting:** Use headings (##), bullet lists (-), and **bold** in text panels for readability";
-export declare function createDashboardToolDeps<TState>({ store, adapter, }: CreateDashboardToolDepsOptions<TState>): DashboardToolDeps;
-export declare function createDashboardAiTools<TState>({ store, adapter, chartTypes, extraTools, }: CreateDashboardAiToolsOptions<TState>): Record<string, Tool>;
-export declare function createDashboardAgentTool<TState>(options: CreateDashboardAgentToolOptions<TState>): Tool;
+export * from './ai/ai';
 //# sourceMappingURL=ai.d.ts.map

package/dist/ai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,SAAS,CAAC"}