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

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

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

@@ -1 +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"]}
+{"version":3,"file":"tool-helpers.js","sourceRoot":"","sources":["../../src/ai/tool-helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAQtC;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,OAA0B,EAC1B,SAAiB;IAEjB,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAE3C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,YAAY,CAAC,UAAU,SAAS,cAAc,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,OAA2B,EAC3B,OAAe,EACf,IAAa;IAEb,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAExC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,YAAY,CAAC,kBAAkB,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,MAAM,IAAI,YAAY,CACpB,qBAAqB,KAAK,CAAC,IAAI,qBAAqB,IAAI,IAAI,CAC7D,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,YAAkC,EAClC,UAAgC;IAEhC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,IAAI,GAAG,IAAI,YAAY,EAAE,CAAC;YACxB,MAAM,IAAI,YAAY,CACpB,uDAAuD,GAAG,+CAA+C,CAC1G,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAC1C,SAA6B,EAC7B,iBAAkC,EAAE;IAEpC,OAAO;QACL,SAAS;QACT,aAAa,EAAE,cAAc,CAAC,MAAM;QACpC,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC;aACnE,MAAM;KACV,CAAC;AACJ,CAAC","sourcesContent":["import {MosaicDashboardPanelConfig} from '../dashboard/dashboard-types';\nimport {AiAgentError} from './errors';\nimport {DashboardAiAdapter} from './dashboard/dashboard-types';\nimport {DataTable} from '@sqlrooms/duckdb';\nimport {Tool} from 'ai';\nimport {DatabaseAiAdapter} from './database-types';\nimport {AgentResultMetadata} from './tool-types';\nimport {AgentToolCall} from './types';\n\n/**\n * Validates that a table exists. Throws if not found.\n */\nexport function ensureTable(\n  adapter: DatabaseAiAdapter,\n  tableName: string,\n): DataTable {\n  const table = adapter.findTable(tableName);\n\n  if (!table) {\n    throw new AiAgentError(`Table \"${tableName}\" not found.`);\n  }\n\n  return table;\n}\n\n/**\n * Validates that a panel exists in a dashboard. Throws if not found.\n */\nexport function ensurePanel(\n  adapter: DashboardAiAdapter,\n  panelId: string,\n  type?: string,\n): MosaicDashboardPanelConfig {\n  const panel = adapter.getPanel(panelId);\n\n  if (!panel) {\n    throw new AiAgentError(`Panel not found.`);\n  }\n\n  if (type !== undefined && panel.type !== type) {\n    throw new AiAgentError(\n      `Panel is of type \"${panel.type}\", expected type \"${type}\".`,\n    );\n  }\n\n  return panel;\n}\n\n/**\n * Validates that extra tools do not override built-in tools.\n * Prevents accidental shadowing of core functionality by custom tools.\n *\n * @param builtInTools - Record of built-in tool names to tools\n * @param extraTools - Record of extra tool names to tools being registered\n * @throws {AiAgentError} When a key from extraTools exists in builtInTools\n */\nexport function ensureNoOverride(\n  builtInTools: Record<string, Tool>,\n  extraTools: Record<string, Tool>,\n) {\n  for (const key of Object.keys(extraTools)) {\n    if (key in builtInTools) {\n      throw new AiAgentError(\n        `Dashboard extraTools cannot override built-in tool \"${key}\". Register the host tool under a unique key.`,\n      );\n    }\n  }\n}\n\n/**\n * Calculate metadata about agent execution results.\n *\n * @param tableName - Optional table name associated with the agent execution\n * @param agentToolCalls - Array of tool calls made during agent execution\n * @returns Metadata including steps executed and queries run\n */\nexport function calculateAgentResultMetadata(\n  tableName: string | undefined,\n  agentToolCalls: AgentToolCall[] = [],\n): AgentResultMetadata {\n  return {\n    tableName,\n    stepsExecuted: agentToolCalls.length,\n    queriesRun: agentToolCalls.filter((call) => call.toolName === 'query')\n      .length,\n  };\n}\n"]}

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

@@ -1,8 +1,13 @@
 import { z } from 'zod';
-export declare const BaseChartToolParameters: z.ZodObject<{
-    artifactId: z.ZodOptional<z.ZodString>;
-    tableName: z.ZodOptional<z.ZodString>;
-    createArtifactIfMissing: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+/**
+ * Base input schema shared by chart AI tools.
+ *
+ * Includes the source table, optional chart title, optional dashboard panel to
+ * update, and the model's rationale for the chart choice.
+ */
+export declare const BaseChartToolInput: z.ZodObject<{
+    tableName: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
     panelId: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodString;
 }, z.core.$strip>;

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

@@ -1 +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"}
+{"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;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;iBAe7B,CAAC"}

package/dist/ai/tool-schemas.js

@@ -1,22 +1,22 @@
 import { z } from 'zod';
-export const BaseChartToolParameters = z.object({
-    artifactId: z
-        .string()
-        .optional()
-        .describe('Optional dashboard artifact ID. Prefer passing this explicitly; if omitted, the host may use an unambiguous primary dashboard context.'),
+/**
+ * Base input schema shared by chart AI tools.
+ *
+ * Includes the source table, optional chart title, optional dashboard panel to
+ * update, and the model's rationale for the chart choice.
+ */
+export const BaseChartToolInput = z.object({
     tableName: z
+        .string()
+        .describe('REQUIRED table name to create the chart from.'),
+    title: z
         .string()
         .optional()
-        .describe('Optional table name. Use when no table is selected yet.'),
-    createArtifactIfMissing: z
-        .boolean()
-        .optional()
-        .default(true)
-        .describe('If true, create dashboard artifact if missing.'),
+        .describe('Optional title for the chart artifact'),
     panelId: z
         .string()
         .optional()
-        .describe('Optional panel ID. If provided, updates the existing panel instead of creating new one.'),
+        .describe('Optional existing dashboard panel ID to update instead of creating a new panel.'),
     reasoning: z.string().describe('Brief rationale for the chart choice.'),
 });
 //# sourceMappingURL=tool-schemas.js.map

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

@@ -1 +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"]}
+{"version":3,"file":"tool-schemas.js","sourceRoot":"","sources":["../../src/ai/tool-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,+CAA+C,CAAC;IAC5D,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;IACpD,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iFAAiF,CAClF;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CACxE,CAAC,CAAC","sourcesContent":["import {z} from 'zod';\n\n/**\n * Base input schema shared by chart AI tools.\n *\n * Includes the source table, optional chart title, optional dashboard panel to\n * update, and the model's rationale for the chart choice.\n */\nexport const BaseChartToolInput = z.object({\n  tableName: z\n    .string()\n    .describe('REQUIRED table name to create the chart from.'),\n  title: z\n    .string()\n    .optional()\n    .describe('Optional title for the chart artifact'),\n  panelId: z\n    .string()\n    .optional()\n    .describe(\n      'Optional existing dashboard panel ID to update instead of creating a new panel.',\n    ),\n  reasoning: z.string().describe('Brief rationale for the chart choice.'),\n});\n"]}

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

@@ -1,5 +1,5 @@
 import { ChartConfig } from '../charts/chart-types/chart-config';
-import type { ChartBuilderColumn } from '../charts/chart-types/base-types';
+import type { ChartBuilderColumn } from '../charts/chart-types/column-types';
 export interface ResolvedChartResourcesParams {
     artifactId?: string;
     tableName?: string;
@@ -23,4 +23,22 @@ export interface CreateChartResult {
     title: string;
     config: ChartConfig;
 }
+type ToolOutputDefaultError = {
+    errorMessage?: string;
+};
+export type ToolOutput<TSuccess, TError extends ToolOutputDefaultError = ToolOutputDefaultError> = ({
+    success: true;
+} & TSuccess) | ({
+    success: false;
+} & TError);
+/**
+ * Metadata about agent execution.
+ * Tracks statistics like steps executed and queries run during agent operation.
+ */
+export type AgentResultMetadata = {
+    tableName?: string;
+    stepsExecuted: number;
+    queriesRun: number;
+};
+export {};
 //# sourceMappingURL=tool-types.d.ts.map

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

@@ -1 +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"}
+{"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,oCAAoC,CAAC;AAE3E,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;AAED,KAAK,sBAAsB,GAAG;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAC,CAAC;AAEtD,MAAM,MAAM,UAAU,CACpB,QAAQ,EACR,MAAM,SAAS,sBAAsB,GAAG,sBAAsB,IAE5D,CAAC;IACC,OAAO,EAAE,IAAI,CAAC;CACf,GAAG,QAAQ,CAAC,GACb,CAAC;IACC,OAAO,EAAE,KAAK,CAAC;CAChB,GAAG,MAAM,CAAC,CAAC;AAEhB;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC"}

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

@@ -1 +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"]}
+{"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/column-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\ntype ToolOutputDefaultError = {errorMessage?: string};\n\nexport type ToolOutput<\n  TSuccess,\n  TError extends ToolOutputDefaultError = ToolOutputDefaultError,\n> =\n  | ({\n      success: true;\n    } & TSuccess)\n  | ({\n      success: false;\n    } & TError);\n\n/**\n * Metadata about agent execution.\n * Tracks statistics like steps executed and queries run during agent operation.\n */\nexport type AgentResultMetadata = {\n  tableName?: string;\n  stepsExecuted: number;\n  queriesRun: number;\n};\n"]}