@sqlrooms/mosaic 0.29.0-rc.8 → 0.29.0-rc.9

package/dist/ai/dashboard/createDashboardChartTools.js

@@ -0,0 +1,55 @@
+import { createChartTools } from '../../charts/chart-types';
+import { createMosaicDashboardChartPanelConfig } from '../../dashboard/MosaicDashboardSlice';
+import { DEFAULT_CHART_MAX_DATA_POINTS } from '../../chart-runtime';
+import { resolveChartTypes } from '../../charts/chart-types/resolveChartTypes';
+import { DASHBOARD_CHART_TOOL_PREFIX } from './constants';
+import { MOSAIC_DASHBOARD_CHART_PANEL_TYPE } from '../../dashboard/dashboard-types';
+import { getMosaicTableIdentity } from '../../mosaicTableReference';
+/**
+ * Creates AI tools for generating chart panels in dashboards.
+ *
+ * @param params - Configuration parameters for chart tool creation
+ * @param params.databaseAdapter - Adapter for database operations
+ * @param params.dashboardAdapter - Adapter for dashboard panel management
+ * @param params.chartToolsOptions - Optional chart configuration options
+ * @returns Record of chart tool names to Tool instances, prefixed with dashboard-specific identifiers
+ */
+export function createDashboardChartTools({ databaseAdapter, dashboardAdapter, chartToolsOptions, }) {
+    const resolvedChartTypes = resolveChartTypes(chartToolsOptions?.chartTypes);
+    const chartToolParams = {
+        maxDataPoints: chartToolsOptions?.chartMaxDataPoints ?? DEFAULT_CHART_MAX_DATA_POINTS,
+        databaseAdapter,
+        addChart: async ({ config, tableName, title, panelId }) => {
+            let panelTitle;
+            if (panelId) {
+                const panel = dashboardAdapter.getPanel(panelId);
+                if (!panel) {
+                    throw new Error(`Panel "${panelId}" not found.`);
+                }
+                if (panel.type !== MOSAIC_DASHBOARD_CHART_PANEL_TYPE) {
+                    throw new Error(`Panel "${panelId}" is not a chart panel. Cannot update it with a chart tool.`);
+                }
+                panelTitle = panel.title;
+            }
+            const resolvedTable = tableName
+                ? databaseAdapter.findTable(tableName)
+                : undefined;
+            const selectedTableIdentity = resolvedTable?.table
+                ? getMosaicTableIdentity(resolvedTable.table)
+                : undefined;
+            if (selectedTableIdentity) {
+                await dashboardAdapter.setSelectedTable(selectedTableIdentity);
+            }
+            if (panelId) {
+                await dashboardAdapter.updatePanel(panelId, {
+                    title: title ?? panelTitle,
+                    config,
+                });
+                return panelId;
+            }
+            return await dashboardAdapter.addPanel(createMosaicDashboardChartPanelConfig(title ?? 'Chart', config));
+        },
+    };
+    return createChartTools(resolvedChartTypes, chartToolParams, DASHBOARD_CHART_TOOL_PREFIX);
+}
+//# sourceMappingURL=createDashboardChartTools.js.map

package/dist/ai/dashboard/createDashboardChartTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDashboardChartTools.js","sourceRoot":"","sources":["../../../src/ai/dashboard/createDashboardChartTools.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,gBAAgB,EAAkB,MAAM,0BAA0B,CAAC;AAE3E,OAAO,EAAC,qCAAqC,EAAC,MAAM,sCAAsC,CAAC;AAI3F,OAAO,EAAC,6BAA6B,EAAC,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAC,iBAAiB,EAAC,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EAAC,2BAA2B,EAAC,MAAM,aAAa,CAAC;AACxD,OAAO,EAAC,iCAAiC,EAAC,MAAM,iCAAiC,CAAC;AAClF,OAAO,EAAC,sBAAsB,EAAC,MAAM,4BAA4B,CAAC;AAelE;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,EACxC,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GACe;IAChC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;IAE5E,MAAM,eAAe,GAAoB;QACvC,aAAa,EACX,iBAAiB,EAAE,kBAAkB,IAAI,6BAA6B;QACxE,eAAe;QACf,QAAQ,EAAE,KAAK,EAAE,EAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAC,EAAE,EAAE;YACtD,IAAI,UAA8B,CAAC;YACnC,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACjD,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,cAAc,CAAC,CAAC;gBACnD,CAAC;gBACD,IAAI,KAAK,CAAC,IAAI,KAAK,iCAAiC,EAAE,CAAC;oBACrD,MAAM,IAAI,KAAK,CACb,UAAU,OAAO,6DAA6D,CAC/E,CAAC;gBACJ,CAAC;gBACD,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;YAC3B,CAAC;YAED,MAAM,aAAa,GAAG,SAAS;gBAC7B,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC,SAAS,CAAC;gBACtC,CAAC,CAAC,SAAS,CAAC;YACd,MAAM,qBAAqB,GAAG,aAAa,EAAE,KAAK;gBAChD,CAAC,CAAC,sBAAsB,CAAC,aAAa,CAAC,KAAK,CAAC;gBAC7C,CAAC,CAAC,SAAS,CAAC;YAEd,IAAI,qBAAqB,EAAE,CAAC;gBAC1B,MAAM,gBAAgB,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;YACjE,CAAC;YAED,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,gBAAgB,CAAC,WAAW,CAAC,OAAO,EAAE;oBAC1C,KAAK,EAAE,KAAK,IAAI,UAAU;oBAC1B,MAAM;iBACP,CAAC,CAAC;gBACH,OAAO,OAAO,CAAC;YACjB,CAAC;YAED,OAAO,MAAM,gBAAgB,CAAC,QAAQ,CACpC,qCAAqC,CAAC,KAAK,IAAI,OAAO,EAAE,MAAM,CAAC,CAChE,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,OAAO,gBAAgB,CACrB,kBAAkB,EAClB,eAAe,EACf,2BAA2B,CAC5B,CAAC;AACJ,CAAC","sourcesContent":["import type {Tool} from 'ai';\nimport {createChartTools, ChartToolParams} from '../../charts/chart-types';\n\nimport {createMosaicDashboardChartPanelConfig} from '../../dashboard/MosaicDashboardSlice';\nimport {DatabaseAiAdapter} from '../database-types';\nimport {DashboardAiAdapter} from './dashboard-types';\nimport {ChartToolsOptions} from '../types';\nimport {DEFAULT_CHART_MAX_DATA_POINTS} from '../../chart-runtime';\nimport {resolveChartTypes} from '../../charts/chart-types/resolveChartTypes';\nimport {DASHBOARD_CHART_TOOL_PREFIX} from './constants';\nimport {MOSAIC_DASHBOARD_CHART_PANEL_TYPE} from '../../dashboard/dashboard-types';\nimport {getMosaicTableIdentity} from '../../mosaicTableReference';\n\n/**\n * Parameters for creating dashboard chart tools.\n *\n * @property databaseAdapter - Adapter for database operations and table queries\n * @property dashboardAdapter - Adapter for adding panels to the dashboard\n * @property chartToolsOptions - Optional configuration for chart types and data point limits\n */\nexport type CreateDashboardChartToolsParams = {\n  databaseAdapter: DatabaseAiAdapter;\n  dashboardAdapter: DashboardAiAdapter;\n  chartToolsOptions?: ChartToolsOptions;\n};\n\n/**\n * Creates AI tools for generating chart panels in dashboards.\n *\n * @param params - Configuration parameters for chart tool creation\n * @param params.databaseAdapter - Adapter for database operations\n * @param params.dashboardAdapter - Adapter for dashboard panel management\n * @param params.chartToolsOptions - Optional chart configuration options\n * @returns Record of chart tool names to Tool instances, prefixed with dashboard-specific identifiers\n */\nexport function createDashboardChartTools({\n  databaseAdapter,\n  dashboardAdapter,\n  chartToolsOptions,\n}: CreateDashboardChartToolsParams): Record<string, Tool> {\n  const resolvedChartTypes = resolveChartTypes(chartToolsOptions?.chartTypes);\n\n  const chartToolParams: ChartToolParams = {\n    maxDataPoints:\n      chartToolsOptions?.chartMaxDataPoints ?? DEFAULT_CHART_MAX_DATA_POINTS,\n    databaseAdapter,\n    addChart: async ({config, tableName, title, panelId}) => {\n      let panelTitle: string | undefined;\n      if (panelId) {\n        const panel = dashboardAdapter.getPanel(panelId);\n        if (!panel) {\n          throw new Error(`Panel \"${panelId}\" not found.`);\n        }\n        if (panel.type !== MOSAIC_DASHBOARD_CHART_PANEL_TYPE) {\n          throw new Error(\n            `Panel \"${panelId}\" is not a chart panel. Cannot update it with a chart tool.`,\n          );\n        }\n        panelTitle = panel.title;\n      }\n\n      const resolvedTable = tableName\n        ? databaseAdapter.findTable(tableName)\n        : undefined;\n      const selectedTableIdentity = resolvedTable?.table\n        ? getMosaicTableIdentity(resolvedTable.table)\n        : undefined;\n\n      if (selectedTableIdentity) {\n        await dashboardAdapter.setSelectedTable(selectedTableIdentity);\n      }\n\n      if (panelId) {\n        await dashboardAdapter.updatePanel(panelId, {\n          title: title ?? panelTitle,\n          config,\n        });\n        return panelId;\n      }\n\n      return await dashboardAdapter.addPanel(\n        createMosaicDashboardChartPanelConfig(title ?? 'Chart', config),\n      );\n    },\n  };\n\n  return createChartTools(\n    resolvedChartTypes,\n    chartToolParams,\n    DASHBOARD_CHART_TOOL_PREFIX,\n  );\n}\n"]}

package/dist/ai/dashboard/createDashboardDataTableExplorerTool.d.ts

@@ -0,0 +1,23 @@
+import type { Tool } from 'ai';
+import { DatabaseAiAdapter } from '../database-types';
+import { DashboardAiAdapter } from './dashboard-types';
+/**
+ * Parameters for creating a dashboard data table explorer tool.
+ *
+ * @property databaseAdapter - Adapter for database operations and table queries
+ * @property dashboardAdapter - Adapter for adding panels to the dashboard
+ */
+export type CreateDashboardDataTableExplorerToolParams = {
+    databaseAdapter: DatabaseAiAdapter;
+    dashboardAdapter: DashboardAiAdapter;
+};
+/**
+ * Creates an AI tool for generating Data Table Explorer panels in dashboards.
+ *
+ * @param params - Configuration parameters
+ * @param params.databaseAdapter - Adapter for database operations
+ * @param params.dashboardAdapter - Adapter for dashboard panel management
+ * @returns Tool instance for creating data table explorer panels with schema and statistics
+ */
+export declare function createDashboardDataTableExplorerTool({ dashboardAdapter, databaseAdapter, }: CreateDashboardDataTableExplorerToolParams): Tool;
+//# sourceMappingURL=createDashboardDataTableExplorerTool.d.ts.map

package/dist/ai/dashboard/createDashboardDataTableExplorerTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDashboardDataTableExplorerTool.d.ts","sourceRoot":"","sources":["../../../src/ai/dashboard/createDashboardDataTableExplorerTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AAI7B,OAAO,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAC,kBAAkB,EAAC,MAAM,mBAAmB,CAAC;AAIrD;;;;;GAKG;AACH,MAAM,MAAM,0CAA0C,GAAG;IACvD,eAAe,EAAE,iBAAiB,CAAC;IACnC,gBAAgB,EAAE,kBAAkB,CAAC;CACtC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,oCAAoC,CAAC,EACnD,gBAAgB,EAChB,eAAe,GAChB,EAAE,0CAA0C,GAAG,IAAI,CAoBnD"}

package/dist/ai/dashboard/createDashboardDataTableExplorerTool.js

@@ -0,0 +1,29 @@
+import { createDataTableExplorerTool } from '../createDataTableExplorerTool';
+import { createMosaicDashboardDataTableExplorerPanelConfig } from '../../dashboard/MosaicDashboardSlice';
+import { getMosaicTableIdentity } from '../../mosaicTableReference';
+import { ensureTable } from '../tool-helpers';
+/**
+ * Creates an AI tool for generating Data Table Explorer panels in dashboards.
+ *
+ * @param params - Configuration parameters
+ * @param params.databaseAdapter - Adapter for database operations
+ * @param params.dashboardAdapter - Adapter for dashboard panel management
+ * @returns Tool instance for creating data table explorer panels with schema and statistics
+ */
+export function createDashboardDataTableExplorerTool({ dashboardAdapter, databaseAdapter, }) {
+    return createDataTableExplorerTool({
+        databaseAdapter,
+        addDataTable: async ({ tableName, title }) => {
+            const resolvedTable = tableName
+                ? ensureTable(databaseAdapter, tableName)
+                : undefined;
+            if (resolvedTable?.table) {
+                await dashboardAdapter.setSelectedTable(getMosaicTableIdentity(resolvedTable.table));
+            }
+            return dashboardAdapter.addPanel(createMosaicDashboardDataTableExplorerPanelConfig({
+                title,
+            }));
+        },
+    });
+}
+//# sourceMappingURL=createDashboardDataTableExplorerTool.js.map

package/dist/ai/dashboard/createDashboardDataTableExplorerTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDashboardDataTableExplorerTool.js","sourceRoot":"","sources":["../../../src/ai/dashboard/createDashboardDataTableExplorerTool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,2BAA2B,EAAC,MAAM,gCAAgC,CAAC;AAE3E,OAAO,EAAC,iDAAiD,EAAC,MAAM,sCAAsC,CAAC;AAGvG,OAAO,EAAC,sBAAsB,EAAC,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAC,WAAW,EAAC,MAAM,iBAAiB,CAAC;AAa5C;;;;;;;GAOG;AACH,MAAM,UAAU,oCAAoC,CAAC,EACnD,gBAAgB,EAChB,eAAe,GAC4B;IAC3C,OAAO,2BAA2B,CAAC;QACjC,eAAe;QACf,YAAY,EAAE,KAAK,EAAE,EAAC,SAAS,EAAE,KAAK,EAAC,EAAE,EAAE;YACzC,MAAM,aAAa,GAAG,SAAS;gBAC7B,CAAC,CAAC,WAAW,CAAC,eAAe,EAAE,SAAS,CAAC;gBACzC,CAAC,CAAC,SAAS,CAAC;YACd,IAAI,aAAa,EAAE,KAAK,EAAE,CAAC;gBACzB,MAAM,gBAAgB,CAAC,gBAAgB,CACrC,sBAAsB,CAAC,aAAa,CAAC,KAAK,CAAC,CAC5C,CAAC;YACJ,CAAC;YAED,OAAO,gBAAgB,CAAC,QAAQ,CAC9B,iDAAiD,CAAC;gBAChD,KAAK;aACN,CAAC,CACH,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type {Tool} from 'ai';\nimport {createDataTableExplorerTool} from '../createDataTableExplorerTool';\n\nimport {createMosaicDashboardDataTableExplorerPanelConfig} from '../../dashboard/MosaicDashboardSlice';\nimport {DatabaseAiAdapter} from '../database-types';\nimport {DashboardAiAdapter} from './dashboard-types';\nimport {getMosaicTableIdentity} from '../../mosaicTableReference';\nimport {ensureTable} from '../tool-helpers';\n\n/**\n * Parameters for creating a dashboard data table explorer tool.\n *\n * @property databaseAdapter - Adapter for database operations and table queries\n * @property dashboardAdapter - Adapter for adding panels to the dashboard\n */\nexport type CreateDashboardDataTableExplorerToolParams = {\n  databaseAdapter: DatabaseAiAdapter;\n  dashboardAdapter: DashboardAiAdapter;\n};\n\n/**\n * Creates an AI tool for generating Data Table Explorer panels in dashboards.\n *\n * @param params - Configuration parameters\n * @param params.databaseAdapter - Adapter for database operations\n * @param params.dashboardAdapter - Adapter for dashboard panel management\n * @returns Tool instance for creating data table explorer panels with schema and statistics\n */\nexport function createDashboardDataTableExplorerTool({\n  dashboardAdapter,\n  databaseAdapter,\n}: CreateDashboardDataTableExplorerToolParams): Tool {\n  return createDataTableExplorerTool({\n    databaseAdapter,\n    addDataTable: async ({tableName, title}) => {\n      const resolvedTable = tableName\n        ? ensureTable(databaseAdapter, tableName)\n        : undefined;\n      if (resolvedTable?.table) {\n        await dashboardAdapter.setSelectedTable(\n          getMosaicTableIdentity(resolvedTable.table),\n        );\n      }\n\n      return dashboardAdapter.addPanel(\n        createMosaicDashboardDataTableExplorerPanelConfig({\n          title,\n        }),\n      );\n    },\n  });\n}\n"]}

package/dist/ai/dashboard/createListDashboardPanelsTool.d.ts

@@ -0,0 +1,28 @@
+import type { MosaicDashboardPanelConfig } from '../../dashboard/dashboard-types';
+import type { ChartRuntimeIssue } from '../../chart-runtime';
+import type { ToolOutput } from '../tool-types';
+import type { DashboardAiAdapter } from './dashboard-types';
+type DashboardPanelSummary = {
+    id: string;
+    type: string;
+    title: string;
+    config: MosaicDashboardPanelConfig['config'];
+    issue?: ChartRuntimeIssue;
+};
+type ListDashboardPanelsToolOutput = ToolOutput<{
+    selectedTable?: string;
+    panels?: DashboardPanelSummary[];
+}>;
+export type CreateListDashboardPanelsToolOptions = {
+    /** Adapter for dashboard operations */
+    dashboardAdapter: DashboardAiAdapter;
+};
+/**
+ * Creates a tool for inspecting the current dashboard's selected table,
+ * panels, and panel runtime issues.
+ */
+export declare function createListDashboardPanelsTool({ dashboardAdapter, }: CreateListDashboardPanelsToolOptions): import("ai").Tool<{
+    reasoning?: string | undefined;
+}, ListDashboardPanelsToolOutput>;
+export {};
+//# sourceMappingURL=createListDashboardPanelsTool.d.ts.map

package/dist/ai/dashboard/createListDashboardPanelsTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createListDashboardPanelsTool.d.ts","sourceRoot":"","sources":["../../../src/ai/dashboard/createListDashboardPanelsTool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,0BAA0B,EAAC,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,mBAAmB,CAAC;AAa1D,KAAK,qBAAqB,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAC7C,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B,CAAC;AAEF,KAAK,6BAA6B,GAAG,UAAU,CAAC;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAClC,CAAC,CAAC;AAEH,MAAM,MAAM,oCAAoC,GAAG;IACjD,uCAAuC;IACvC,gBAAgB,EAAE,kBAAkB,CAAC;CACtC,CAAC;AAiBF;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,EAC5C,gBAAgB,GACjB,EAAE,oCAAoC;;kCAkCtC"}

package/dist/ai/dashboard/createListDashboardPanelsTool.js

@@ -0,0 +1,54 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+const ListDashboardPanelsToolInput = z.object({
+    reasoning: z
+        .string()
+        .optional()
+        .describe('Brief rationale for inspecting dashboard panels.'),
+});
+function summarizePanel(panel, getPanelIssue) {
+    const issue = getPanelIssue?.(panel.id);
+    return {
+        id: panel.id,
+        type: panel.type,
+        title: panel.title,
+        config: panel.config,
+        ...(issue !== undefined ? { issue } : {}),
+    };
+}
+/**
+ * Creates a tool for inspecting the current dashboard's selected table,
+ * panels, and panel runtime issues.
+ */
+export function createListDashboardPanelsTool({ dashboardAdapter, }) {
+    return tool({
+        description: `List panels in the current dashboard, including the selected table and any panel runtime issues.
+
+Use this before updating existing dashboard panels, when deciding which table the dashboard currently targets, and after creating map panels to check for render issues.`,
+        inputSchema: ListDashboardPanelsToolInput,
+        execute: async () => {
+            try {
+                const panels = dashboardAdapter.getPanels?.();
+                if (!panels) {
+                    return {
+                        success: false,
+                        errorMessage: 'Dashboard adapter does not support listing panels.',
+                    };
+                }
+                const selectedTable = dashboardAdapter.getSelectedTable?.();
+                return {
+                    success: true,
+                    ...(selectedTable !== undefined ? { selectedTable } : {}),
+                    panels: panels.map((panel) => summarizePanel(panel, dashboardAdapter.getPanelIssue)),
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    errorMessage: error instanceof Error ? error.message : String(error),
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=createListDashboardPanelsTool.js.map

package/dist/ai/dashboard/createListDashboardPanelsTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createListDashboardPanelsTool.js","sourceRoot":"","sources":["../../../src/ai/dashboard/createListDashboardPanelsTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AACxB,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAMtB,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;CAChE,CAAC,CAAC;AAwBH,SAAS,cAAc,CACrB,KAAiC,EACjC,aAAmD;IAEnD,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAExC,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAC,KAAK,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,EAC5C,gBAAgB,GACqB;IACrC,OAAO,IAAI,CAA8D;QACvE,WAAW,EAAE;;yKAEwJ;QACrK,WAAW,EAAE,4BAA4B;QACzC,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,EAAE,EAAE,CAAC;gBAE9C,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,YAAY,EAAE,oDAAoD;qBACnE,CAAC;gBACJ,CAAC;gBAED,MAAM,aAAa,GAAG,gBAAgB,CAAC,gBAAgB,EAAE,EAAE,CAAC;gBAE5D,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAC,aAAa,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvD,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC3B,cAAc,CAAC,KAAK,EAAE,gBAAgB,CAAC,aAAa,CAAC,CACtD;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,YAAY,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBACrE,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {tool} from 'ai';\nimport {z} from 'zod';\nimport type {MosaicDashboardPanelConfig} from '../../dashboard/dashboard-types';\nimport type {ChartRuntimeIssue} from '../../chart-runtime';\nimport type {ToolOutput} from '../tool-types';\nimport type {DashboardAiAdapter} from './dashboard-types';\n\nconst ListDashboardPanelsToolInput = z.object({\n  reasoning: z\n    .string()\n    .optional()\n    .describe('Brief rationale for inspecting dashboard panels.'),\n});\n\ntype ListDashboardPanelsToolInput = z.infer<\n  typeof ListDashboardPanelsToolInput\n>;\n\ntype DashboardPanelSummary = {\n  id: string;\n  type: string;\n  title: string;\n  config: MosaicDashboardPanelConfig['config'];\n  issue?: ChartRuntimeIssue;\n};\n\ntype ListDashboardPanelsToolOutput = ToolOutput<{\n  selectedTable?: string;\n  panels?: DashboardPanelSummary[];\n}>;\n\nexport type CreateListDashboardPanelsToolOptions = {\n  /** Adapter for dashboard operations */\n  dashboardAdapter: DashboardAiAdapter;\n};\n\nfunction summarizePanel(\n  panel: MosaicDashboardPanelConfig,\n  getPanelIssue?: DashboardAiAdapter['getPanelIssue'],\n): DashboardPanelSummary {\n  const issue = getPanelIssue?.(panel.id);\n\n  return {\n    id: panel.id,\n    type: panel.type,\n    title: panel.title,\n    config: panel.config,\n    ...(issue !== undefined ? {issue} : {}),\n  };\n}\n\n/**\n * Creates a tool for inspecting the current dashboard's selected table,\n * panels, and panel runtime issues.\n */\nexport function createListDashboardPanelsTool({\n  dashboardAdapter,\n}: CreateListDashboardPanelsToolOptions) {\n  return tool<ListDashboardPanelsToolInput, ListDashboardPanelsToolOutput>({\n    description: `List panels in the current dashboard, including the selected table and any panel runtime issues.\n\nUse this before updating existing dashboard panels, when deciding which table the dashboard currently targets, and after creating map panels to check for render issues.`,\n    inputSchema: ListDashboardPanelsToolInput,\n    execute: async () => {\n      try {\n        const panels = dashboardAdapter.getPanels?.();\n\n        if (!panels) {\n          return {\n            success: false,\n            errorMessage: 'Dashboard adapter does not support listing panels.',\n          };\n        }\n\n        const selectedTable = dashboardAdapter.getSelectedTable?.();\n\n        return {\n          success: true,\n          ...(selectedTable !== undefined ? {selectedTable} : {}),\n          panels: panels.map((panel) =>\n            summarizePanel(panel, dashboardAdapter.getPanelIssue),\n          ),\n        };\n      } catch (error) {\n        return {\n          success: false,\n          errorMessage: error instanceof Error ? error.message : String(error),\n        };\n      }\n    },\n  });\n}\n"]}

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

@@ -0,0 +1,59 @@
+import type { PanelPatch } from '../../charts/chart-types/base-types';
+import type { MosaicDashboardPanelConfig } from '../../dashboard/dashboard-types';
+import type { ChartRuntimeIssue } from '../../chart-runtime';
+import type { BaseAgentToolOptions } from '../types';
+import { DatabaseAiAdapter } from '../database-types';
+import { Tool } from 'ai';
+import { AgentResultMetadata } from '../tool-types';
+/**
+ * Dashboard adapter with full dashboard panel management capabilities.
+ * Extends BaseAiAdapter with dashboard-specific operations.
+ */
+export type DashboardAiAdapter = {
+    getPanelIssue?: (panelId: string) => ChartRuntimeIssue | undefined;
+    getSelectedTable?: () => string | undefined;
+    getPanels?: () => MosaicDashboardPanelConfig[];
+    setSelectedTable: (tableName: string) => void | Promise<void>;
+    getPanel(panelId: string): MosaicDashboardPanelConfig | undefined;
+    updatePanel(panelId: string, patch: Partial<PanelPatch>): void | Promise<void>;
+    removePanel(panelId: string): void | Promise<void>;
+    addPanel(panel: MosaicDashboardPanelConfig): string | Promise<string>;
+};
+/**
+ * Result returned by the dashboard agent after completing a task.
+ * Contains execution status, final output, and optional metadata about the run.
+ */
+export type DashboardAgentResult = {
+    success: boolean;
+    finalOutput: string;
+    dashboardId: string;
+    error?: string;
+    metadata?: AgentResultMetadata;
+};
+/**
+ * Parameters passed to extra dashboard AI tools factory.
+ * Provides adapters for dashboard and database operations.
+ */
+export type ExtraDashboardAiToolsParams = {
+    dashboardAdapter: DashboardAiAdapter;
+    databaseAdapter: DatabaseAiAdapter;
+};
+/**
+ * Factory function for creating additional dashboard AI tools.
+ * Allows hosts to register custom tools that extend the dashboard agent's capabilities.
+ */
+export type ExtraDashboardAiToolsFactory = (params: ExtraDashboardAiToolsParams) => Record<string, Tool>;
+/**
+ * Options for creating a dashboard agent tool.
+ * Extends base agent options with dashboard-specific database adapter and optional extra tools.
+ */
+export type CreateDashboardAgentToolOptions<TState> = BaseAgentToolOptions<TState> & {
+    databaseAdapter: DatabaseAiAdapter;
+    /**
+     * 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?: ExtraDashboardAiToolsFactory;
+};
+//# sourceMappingURL=dashboard-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-types.d.ts","sourceRoot":"","sources":["../../../src/ai/dashboard/dashboard-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,EAAC,0BAA0B,EAAC,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,UAAU,CAAC;AACnD,OAAO,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AACxB,OAAO,EAAC,mBAAmB,EAAC,MAAM,eAAe,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAC;IACnE,gBAAgB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,0BAA0B,EAAE,CAAC;IAC/C,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS,CAAC;IAClE,WAAW,CACT,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GACzB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvE,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,gBAAgB,EAAE,kBAAkB,CAAC;IACrC,eAAe,EAAE,iBAAiB,CAAC;CACpC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG,CACzC,MAAM,EAAE,2BAA2B,KAChC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAE1B;;;GAGG;AACH,MAAM,MAAM,+BAA+B,CAAC,MAAM,IAChD,oBAAoB,CAAC,MAAM,CAAC,GAAG;IAC7B,eAAe,EAAE,iBAAiB,CAAC;IACnC;;;;OAIG;IACH,UAAU,CAAC,EAAE,4BAA4B,CAAC;CAC3C,CAAC"}

package/dist/ai/dashboard/dashboard-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dashboard-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-types.js","sourceRoot":"","sources":["../../../src/ai/dashboard/dashboard-types.ts"],"names":[],"mappings":"","sourcesContent":["import type {PanelPatch} from '../../charts/chart-types/base-types';\nimport type {MosaicDashboardPanelConfig} from '../../dashboard/dashboard-types';\nimport type {ChartRuntimeIssue} from '../../chart-runtime';\nimport type {BaseAgentToolOptions} from '../types';\nimport {DatabaseAiAdapter} from '../database-types';\nimport {Tool} from 'ai';\nimport {AgentResultMetadata} from '../tool-types';\n\n/**\n * Dashboard adapter with full dashboard panel management capabilities.\n * Extends BaseAiAdapter with dashboard-specific operations.\n */\nexport type DashboardAiAdapter = {\n  getPanelIssue?: (panelId: string) => ChartRuntimeIssue | undefined;\n  getSelectedTable?: () => string | undefined;\n  getPanels?: () => MosaicDashboardPanelConfig[];\n  setSelectedTable: (tableName: string) => void | Promise<void>;\n  getPanel(panelId: string): MosaicDashboardPanelConfig | undefined;\n  updatePanel(\n    panelId: string,\n    patch: Partial<PanelPatch>,\n  ): void | Promise<void>;\n  removePanel(panelId: string): void | Promise<void>;\n  addPanel(panel: MosaicDashboardPanelConfig): string | Promise<string>;\n};\n\n/**\n * Result returned by the dashboard agent after completing a task.\n * Contains execution status, final output, and optional metadata about the run.\n */\nexport type DashboardAgentResult = {\n  success: boolean;\n  finalOutput: string;\n  dashboardId: string;\n  error?: string;\n  metadata?: AgentResultMetadata;\n};\n\n/**\n * Parameters passed to extra dashboard AI tools factory.\n * Provides adapters for dashboard and database operations.\n */\nexport type ExtraDashboardAiToolsParams = {\n  dashboardAdapter: DashboardAiAdapter;\n  databaseAdapter: DatabaseAiAdapter;\n};\n\n/**\n * Factory function for creating additional dashboard AI tools.\n * Allows hosts to register custom tools that extend the dashboard agent's capabilities.\n */\nexport type ExtraDashboardAiToolsFactory = (\n  params: ExtraDashboardAiToolsParams,\n) => Record<string, Tool>;\n\n/**\n * Options for creating a dashboard agent tool.\n * Extends base agent options with dashboard-specific database adapter and optional extra tools.\n */\nexport type CreateDashboardAgentToolOptions<TState> =\n  BaseAgentToolOptions<TState> & {\n    databaseAdapter: DatabaseAiAdapter;\n    /**\n     * Host-provided dashboard tools keyed by their registered tool name.\n     * Register geospatial map tools under MAP_TOOL_KEY so prompts and tools\n     * stay in sync.\n     */\n    extraTools?: ExtraDashboardAiToolsFactory;\n  };\n"]}

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

@@ -0,0 +1,12 @@
+import type { DataTable, QualifiedTableName } from '@sqlrooms/db';
+/**
+ * Database-specific AI adapter interface.
+ * Provides access to tables and database queries for AI tools.
+ */
+export type DatabaseAiAdapter = {
+    /** Get all available tables */
+    getTables: () => DataTable[];
+    /** Find table by name, returns undefined if not found */
+    findTable(tableName: string | QualifiedTableName): DataTable | undefined;
+};
+//# sourceMappingURL=database-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database-types.d.ts","sourceRoot":"","sources":["../../src/ai/database-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAE,kBAAkB,EAAC,MAAM,cAAc,CAAC;AAEhE;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,+BAA+B;IAC/B,SAAS,EAAE,MAAM,SAAS,EAAE,CAAC;IAE7B,yDAAyD;IACzD,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,GAAG,SAAS,CAAC;CAC1E,CAAC"}

package/dist/ai/database-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=database-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database-types.js","sourceRoot":"","sources":["../../src/ai/database-types.ts"],"names":[],"mappings":"","sourcesContent":["import type {DataTable, QualifiedTableName} from '@sqlrooms/db';\n\n/**\n * Database-specific AI adapter interface.\n * Provides access to tables and database queries for AI tools.\n */\nexport type DatabaseAiAdapter = {\n  /** Get all available tables */\n  getTables: () => DataTable[];\n\n  /** Find table by name, returns undefined if not found */\n  findTable(tableName: string | QualifiedTableName): DataTable | undefined;\n};\n"]}

package/dist/ai/errors.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Error thrown by AI agents when validation or execution fails.
+ * Used for reporting issues like missing tables, invalid columns, or constraint violations.
+ */
+export declare class AiAgentError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/ai/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/ai/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B"}

package/dist/ai/errors.js

@@ -0,0 +1,11 @@
+/**
+ * Error thrown by AI agents when validation or execution fails.
+ * Used for reporting issues like missing tables, invalid columns, or constraint violations.
+ */
+export class AiAgentError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AiAgentError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/ai/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/ai/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF","sourcesContent":["/**\n * Error thrown by AI agents when validation or execution fails.\n * Used for reporting issues like missing tables, invalid columns, or constraint violations.\n */\nexport class AiAgentError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'AiAgentError';\n  }\n}\n"]}

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

@@ -1,34 +1,33 @@
-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;
-}
+import { MosaicDashboardPanelConfig } from '../dashboard/dashboard-types';
+import { DashboardAiAdapter } from './dashboard/dashboard-types';
+import { DataTable } from '@sqlrooms/duckdb';
+import { Tool } from 'ai';
+import { DatabaseAiAdapter } from './database-types';
+import { AgentResultMetadata } from './tool-types';
+import { AgentToolCall } from './types';
 /**
- * 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.
+ * Validates that a table exists. Throws if not found.
  */
-export declare function createOrUpdateChartPanel(deps: DashboardToolDeps, params: CreateOrUpdateChartPanelParams): PanelResult;
+export declare function ensureTable(adapter: DatabaseAiAdapter, tableName: string): DataTable;
 /**
- * Universal helper to create or update a dataTableExplorer panel.
+ * Validates that a panel exists in a dashboard. Throws if not found.
  */
-export declare function createOrUpdateDataTableExplorerPanel(deps: DashboardToolDeps, params: CreateOrUpdateDataTableExplorerPanelParams): PanelResult;
+export declare function ensurePanel(adapter: DashboardAiAdapter, panelId: string, type?: string): MosaicDashboardPanelConfig;
+/**
+ * Validates that extra tools do not override built-in tools.
+ * Prevents accidental shadowing of core functionality by custom tools.
+ *
+ * @param builtInTools - Record of built-in tool names to tools
+ * @param extraTools - Record of extra tool names to tools being registered
+ * @throws {AiAgentError} When a key from extraTools exists in builtInTools
+ */
+export declare function ensureNoOverride(builtInTools: Record<string, Tool>, extraTools: Record<string, Tool>): void;
+/**
+ * Calculate metadata about agent execution results.
+ *
+ * @param tableName - Optional table name associated with the agent execution
+ * @param agentToolCalls - Array of tool calls made during agent execution
+ * @returns Metadata including steps executed and queries run
+ */
+export declare function calculateAgentResultMetadata(tableName: string | undefined, agentToolCalls?: AgentToolCall[]): AgentResultMetadata;
 //# sourceMappingURL=tool-helpers.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"tool-helpers.d.ts","sourceRoot":"","sources":["../../src/ai/tool-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,0BAA0B,EAAC,MAAM,8BAA8B,CAAC;AAExE,OAAO,EAAC,kBAAkB,EAAC,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAC,SAAS,EAAC,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AACxB,OAAO,EAAC,iBAAiB,EAAC,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAC,mBAAmB,EAAC,MAAM,cAAc,CAAC;AACjD,OAAO,EAAC,aAAa,EAAC,MAAM,SAAS,CAAC;AAEtC;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE,MAAM,GAChB,SAAS,CAQX;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,GACZ,0BAA0B,CAc5B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,QASjC;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,cAAc,GAAE,aAAa,EAAO,GACnC,mBAAmB,CAOrB"}

package/dist/ai/tool-helpers.js

@@ -1,93 +1,55 @@
-import { createMosaicDashboardChartPanelConfig, createMosaicDashboardDataTableExplorerPanelConfig, } from '../dashboard/MosaicDashboardSlice';
+import { AiAgentError } from './errors';
 /**
- * Validates that a dashboard exists. Throws if not found.
+ * Validates that a table 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.`);
+export function ensureTable(adapter, tableName) {
+    const table = adapter.findTable(tableName);
+    if (!table) {
+        throw new AiAgentError(`Table "${tableName}" not found.`);
     }
-    return dashboard;
+    return table;
 }
 /**
  * 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.`);
+export function ensurePanel(adapter, panelId, type) {
+    const panel = adapter.getPanel(panelId);
+    if (!panel) {
+        throw new AiAgentError(`Panel not found.`);
     }
+    if (type !== undefined && panel.type !== type) {
+        throw new AiAgentError(`Panel is of type "${panel.type}", expected type "${type}".`);
+    }
+    return panel;
 }
 /**
- * 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.
+ * Validates that extra tools do not override built-in tools.
+ * Prevents accidental shadowing of core functionality by custom tools.
+ *
+ * @param builtInTools - Record of built-in tool names to tools
+ * @param extraTools - Record of extra tool names to tools being registered
+ * @throws {AiAgentError} When a key from extraTools exists in builtInTools
  */
-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,
-        };
+export function ensureNoOverride(builtInTools, extraTools) {
+    for (const key of Object.keys(extraTools)) {
+        if (key in builtInTools) {
+            throw new AiAgentError(`Dashboard extraTools cannot override built-in tool "${key}". Register the host tool under a unique key.`);
+        }
     }
 }
 /**
- * Universal helper to create or update a dataTableExplorer panel.
+ * Calculate metadata about agent execution results.
+ *
+ * @param tableName - Optional table name associated with the agent execution
+ * @param agentToolCalls - Array of tool calls made during agent execution
+ * @returns Metadata including steps executed and queries run
  */
-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,
-        };
-    }
+export function calculateAgentResultMetadata(tableName, agentToolCalls = []) {
+    return {
+        tableName,
+        stepsExecuted: agentToolCalls.length,
+        queriesRun: agentToolCalls.filter((call) => call.toolName === 'query')
+            .length,
+    };
 }
 //# sourceMappingURL=tool-helpers.js.map