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

package/README.md

@@ -172,6 +172,20 @@ renderer for `@sqlrooms/documents` block documents. Register it with a
 host-provided stateful block type such as `data-table` when a document or
 worksheet surface should embed an interactive Data Table Explorer directly.
 
+Use `DataTableSelector` or `DataTableSelectorEmptyState` when another host
+surface needs the same searchable table picker used by dashboards and data
+table blocks.
+
+### Block Document AI Integrations
+
+`createBlockDocumentChartTools`, `createAddMosaicDashboardBlockTool`, and
+`createBlockDocumentDataTableExplorerTool` expose Mosaic-owned capabilities for
+block-document hosts. The host provides a `BlockDocumentAiAdapter` from
+`@sqlrooms/documents` plus callbacks for creating host-specific stateful block
+state, then composes these tools with app-specific agent policy. The adapter may
+append blocks through direct slice methods or by awaiting a command-backed
+mutation supplied by the host.
+
 ### Mosaic Dashboard Panels
 
 `MosaicDashboard` is a compound dashboard surface backed by generic dashboard
@@ -353,55 +367,90 @@ dashboard slice.
 ### Dashboard AI Tools
 
 `@sqlrooms/mosaic` provides reusable assistant tools for dashboard authoring,
-including chart tools, Data Table Explorer/text panel tools, panel management tools, and an
-optional exploratory `dashboard_agent`. Client apps supply a small adapter that
-maps Mosaic's generic dashboard operations to their store, artifact model, table
-metadata, and AI run context. When an AI run context is present, implicit
-dashboard targeting should resolve only a primary dashboard context item;
-reference-only dashboard artifacts should require an explicit `artifactId`.
+including chart tools, a Data Table Explorer panel tool, and an optional
+exploratory `dashboard_agent`. Client apps supply small adapters that map
+Mosaic's generic dashboard operations to their store and table metadata.
+Agent tools use `intent` for the natural-language objective they should satisfy.
+Mutation callbacks may return promises, so hosts can route dashboard table and
+panel writes through room commands such as `dashboard.set-selected-table`,
+`dashboard.add-panel`, `dashboard.update-panel`, and `dashboard.remove-panel`
+while preserving the reusable Mosaic AI surface.
 
 ```ts
 import {
   createDashboardAiTools,
   MAP_TOOL_KEY,
   type DashboardAiAdapter,
+  type DatabaseAiAdapter,
 } from '@sqlrooms/mosaic';
 
-const adapter: DashboardAiAdapter<AppState> = {
-  getTables: (state) => state.db.tables,
-  hasRunContext: (state, context) => hasAiRunContext(context),
-  resolveContextDashboardArtifactId: (state, context) =>
-    getPrimaryDashboardArtifactIdFromRunContext(context, state),
-  makeDashboardPrimaryForRun: (state, artifactId, context) =>
-    makeArtifactPrimaryForAiRun(artifactId, context),
-  getCurrentDashboardArtifactId: (state) =>
-    state.dashboard.getCurrentDashboardArtifactId(),
-  createDashboardArtifact: (state, title, layoutType) =>
-    state.dashboard.createDashboardArtifact(title, layoutType),
-  isDashboardArtifact: (state, artifactId) =>
-    state.artifacts.getArtifact(artifactId)?.type === 'dashboard',
-  setCurrentArtifact: (state, artifactId) =>
-    state.artifacts.setCurrentArtifact(artifactId),
-  ensureDashboard: (state, dashboardId) =>
-    state.dashboard.ensureDashboardArtifact(dashboardId),
-  getDashboard: (state, dashboardId) =>
-    state.mosaicDashboard.getDashboard(dashboardId),
-  setSelectedTable: (state, dashboardId, tableName) =>
-    state.mosaicDashboard.setSelectedTable(dashboardId, tableName),
-  addPanel: (state, dashboardId, panel) =>
-    state.mosaicDashboard.addPanel(dashboardId, panel),
-  updatePanel: (state, dashboardId, panelId, patch) =>
-    state.mosaicDashboard.updatePanel(dashboardId, panelId, patch),
-  removePanel: (state, dashboardId, panelId) =>
-    state.mosaicDashboard.removePanel(dashboardId, panelId),
+const dashboardId = 'dashboard-1';
+
+const databaseAdapter: DatabaseAiAdapter = {
+  getTables: () => store.getState().db.tables,
+  findTable: (tableName) =>
+    store.getState().db.tables.find((table) => table.tableName === tableName),
+};
+
+const dashboardAdapter: DashboardAiAdapter = {
+  getSelectedTable: () =>
+    store.getState().mosaicDashboard.getDashboard(dashboardId)?.selectedTable,
+  getPanels: () =>
+    store.getState().mosaicDashboard.getDashboard(dashboardId)?.panels ?? [],
+  setSelectedTable: async (tableName) =>
+    store.getState().commands.invokeCommand('dashboard.set-selected-table', {
+      dashboardId,
+      tableName,
+    }),
+  addPanel: async (panel) =>
+    store.getState().commands.invokeCommand('dashboard.add-panel', {
+      dashboardId,
+      panel,
+    }),
+  updatePanel: async (panelId, patch) =>
+    store.getState().commands.invokeCommand('dashboard.update-panel', {
+      dashboardId,
+      panelId,
+      patch,
+    }),
+  removePanel: async (panelId) =>
+    store.getState().commands.invokeCommand('dashboard.remove-panel', {
+      dashboardId,
+      panelId,
+    }),
+  getPanel: (panelId) =>
+    store
+      .getState()
+      .mosaicDashboard.getDashboard(dashboardId)
+      ?.panels.find((panel) => panel.id === panelId),
+  getPanelIssue: (panelId) =>
+    store.getState().mosaicDashboard.getPanelIssue(dashboardId, panelId),
 };
 
-const dashboardTools = createDashboardAiTools({store, adapter});
+const dashboardTools = createDashboardAiTools({
+  databaseAdapter,
+  dashboardAdapter,
+});
 ```
 
+Dashboard chart tools create new chart panels by default. When the user asks to
+edit an existing chart, pass that panel's `panelId` to the same chart tool; the
+tool validates that the target is a chart panel and updates its config in place.
+If the tool call omits `title`, updates preserve the panel's existing title
+instead of renaming it to the default chart title.
+
 Host tools can be added with `extraTools`; they must not reuse built-in
 dashboard tool keys. Register geospatial map tools under `MAP_TOOL_KEY` so the
-dashboard prompts and tool registration stay aligned.
+dashboard prompts and tool registration stay aligned. When host tools need
+specialized agent guidance, pass `additionalInstructions` to append that
+guidance after the built-in agent workflow without replacing it.
+
+Worksheet agents also accept host tools through `extraTools`. Worksheet extra
+tool factories receive the active `worksheetId` alongside the worksheet and
+database adapters, so host apps can add worksheet-scoped tools such as embedded
+stateful blocks without guessing which worksheet the sub-agent is editing.
+Worksheet block-container tools propagate optional `intent` onto the created
+block when the host adapter persists block document state.
 
 ### Box Plot Chart Type
 
@@ -474,45 +523,6 @@ Available compound components:
 
 For simpler use cases, the legacy `ChartBuilderDialog` component is still available but deprecated.
 
-### Combobox Component
-
-The package provides a reusable compound `Combobox` component for building searchable select dropdowns. This component is used internally by chart settings fields like `AggregationSelector`, `FieldSelectorInput`, and `TemporalGranularitySelector`.
-
-```tsx
-import {Combobox} from '@sqlrooms/mosaic';
-
-function MySelector() {
-  const [value, setValue] = useState('');
-
-  return (
-    <Combobox value={value} onChange={setValue}>
-      <Combobox.Trigger placeholder="Select option..." />
-      <Combobox.Content>
-        <Combobox.Search placeholder="Search..." />
-        <Combobox.Empty>No results found.</Combobox.Empty>
-        <Combobox.List>
-          <Combobox.Item value="option1">Option 1</Combobox.Item>
-          <Combobox.Item value="option2">Option 2</Combobox.Item>
-          <Combobox.Item value="option3">Option 3</Combobox.Item>
-        </Combobox.List>
-      </Combobox.Content>
-    </Combobox>
-  );
-}
-```
-
-Available compound components:
-
-- `Combobox` (root) - Manages state and provides context
-- `Combobox.Trigger` - Button to open the dropdown
-- `Combobox.Content` - Popover content wrapper
-- `Combobox.Search` - Search input field
-- `Combobox.Empty` - Empty state message
-- `Combobox.List` - Items container
-- `Combobox.Item` - Individual selectable item
-
-For advanced use cases, the underlying `useCombobox` hook is also exported.
-
 ### Working with Selections
 
 Selections enable cross-filtering between multiple visualizations. You can get or create a named selection from the store:

package/dist/ai/agentIntent.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export declare const AgentIntentSchemaFields: {
+    intent: z.ZodString;
+};
+//# sourceMappingURL=agentIntent.d.ts.map

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

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

package/dist/ai/agentIntent.js

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export const AgentIntentSchemaFields = {
+    intent: z
+        .string()
+        .min(1, 'intent cannot be empty')
+        .describe('The natural-language objective for the agent to satisfy.'),
+};
+//# sourceMappingURL=agentIntent.js.map

package/dist/ai/agentIntent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentIntent.js","sourceRoot":"","sources":["../../src/ai/agentIntent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;SAChC,QAAQ,CAAC,0DAA0D,CAAC;CACxE,CAAC","sourcesContent":["import {z} from 'zod';\n\nexport const AgentIntentSchemaFields = {\n  intent: z\n    .string()\n    .min(1, 'intent cannot be empty')\n    .describe('The natural-language objective for the agent to satisfy.'),\n};\n"]}

package/dist/ai/block-document/constants.d.ts

@@ -0,0 +1,9 @@
+export declare const BLOCK_DOCUMENT_CHART_TOOL_PREFIX = "create_block_document_chart_";
+/**
+ * Known Mosaic block-document AI tool names.
+ */
+export declare const KnownMosaicBlockDocumentTools: {
+    readonly add_dashboard_block: "add_mosaic_dashboard_block";
+    readonly add_data_table_explorer: "add_data_table_explorer_block";
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/ai/block-document/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/ai/block-document/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gCAAgC,iCAAiC,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;CAGhC,CAAC"}

package/dist/ai/block-document/constants.js

@@ -0,0 +1,9 @@
+export const BLOCK_DOCUMENT_CHART_TOOL_PREFIX = 'create_block_document_chart_';
+/**
+ * Known Mosaic block-document AI tool names.
+ */
+export const KnownMosaicBlockDocumentTools = {
+    add_dashboard_block: 'add_mosaic_dashboard_block',
+    add_data_table_explorer: 'add_data_table_explorer_block',
+};
+//# sourceMappingURL=constants.js.map

package/dist/ai/block-document/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/ai/block-document/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gCAAgC,GAAG,8BAA8B,CAAC;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,mBAAmB,EAAE,4BAA4B;IACjD,uBAAuB,EAAE,+BAA+B;CAChD,CAAC","sourcesContent":["export const BLOCK_DOCUMENT_CHART_TOOL_PREFIX = 'create_block_document_chart_';\n\n/**\n * Known Mosaic block-document AI tool names.\n */\nexport const KnownMosaicBlockDocumentTools = {\n  add_dashboard_block: 'add_mosaic_dashboard_block',\n  add_data_table_explorer: 'add_data_table_explorer_block',\n} as const;\n"]}

package/dist/ai/block-document/createAddMosaicDashboardBlockTool.d.ts

@@ -0,0 +1,48 @@
+import type { BlockDocumentAiAdapter, BlockDocumentStatefulBlockBlock } from '@sqlrooms/documents';
+import type { ToolOutput } from '../tool-types';
+type AddMosaicDashboardBlockToolOutput = ToolOutput<{
+    dashboardId?: string;
+    blockId?: string;
+    message?: string;
+}>;
+/**
+ * Options for creating a Mosaic dashboard block-document tool.
+ */
+export type CreateAddMosaicDashboardBlockToolOptions = {
+    /** Adapter for block document operations. */
+    blockDocumentAdapter: BlockDocumentAiAdapter;
+    /** ID of the block document where dashboard blocks will be added. */
+    blockDocumentId: string;
+    /** Host callback that performs the full durable block creation. */
+    addDashboardBlock?: (params: {
+        title: string;
+        tableName: string;
+        intent?: string;
+    }) => Promise<{
+        dashboardId: string;
+        blockId: string;
+    }>;
+    /** Host callback that creates Mosaic dashboard state and its document block. */
+    createDashboardBlock: (params: {
+        title: string;
+        tableName: string;
+        intent?: string;
+    }) => {
+        dashboardId: string;
+        block: BlockDocumentStatefulBlockBlock;
+    } | Promise<{
+        dashboardId: string;
+        block: BlockDocumentStatefulBlockBlock;
+    }>;
+};
+/**
+ * Creates a tool for adding an empty Mosaic dashboard block to a block document.
+ */
+export declare function createAddMosaicDashboardBlockTool({ blockDocumentAdapter, blockDocumentId, addDashboardBlock, createDashboardBlock, }: CreateAddMosaicDashboardBlockToolOptions): import("ai").Tool<{
+    reasoning: string;
+    dashboardTitle: string;
+    tableName: string;
+    intent?: string | undefined;
+}, AddMosaicDashboardBlockToolOutput>;
+export {};
+//# sourceMappingURL=createAddMosaicDashboardBlockTool.d.ts.map

package/dist/ai/block-document/createAddMosaicDashboardBlockTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAddMosaicDashboardBlockTool.d.ts","sourceRoot":"","sources":["../../../src/ai/block-document/createAddMosaicDashboardBlockTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,+BAA+B,EAChC,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAgB9C,KAAK,iCAAiC,GAAG,UAAU,CAAC;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,6CAA6C;IAC7C,oBAAoB,EAAE,sBAAsB,CAAC;IAC7C,qEAAqE;IACrE,eAAe,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE;QAC3B,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAK,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IACtD,gFAAgF;IAChF,oBAAoB,EAAE,CAAC,MAAM,EAAE;QAC7B,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KACG;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,+BAA+B,CAAA;KAAC,GAC7D,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,+BAA+B,CAAA;KAAC,CAAC,CAAC;CAC5E,CAAC;AAEF;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,EAChD,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,EAAE,wCAAwC;;;;;sCAkD1C"}

package/dist/ai/block-document/createAddMosaicDashboardBlockTool.js

@@ -0,0 +1,59 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+const AddMosaicDashboardBlockToolInput = z.object({
+    reasoning: z.string().describe('Brief rationale for dashboard block choice.'),
+    dashboardTitle: z.string().describe('The title of the dashboard.'),
+    tableName: z.string().describe('The name of the table/dataset to analyze.'),
+    intent: z
+        .string()
+        .optional()
+        .describe('Optional natural-language objective for this dashboard block.'),
+});
+/**
+ * Creates a tool for adding an empty Mosaic dashboard block to a block document.
+ */
+export function createAddMosaicDashboardBlockTool({ blockDocumentAdapter, blockDocumentId, addDashboardBlock, createDashboardBlock, }) {
+    return tool({
+        description: `Create an EMPTY Mosaic dashboard block container in the block document.
+
+This tool ONLY creates the container structure. To populate it with charts and panels, use other tools afterward.`,
+        inputSchema: AddMosaicDashboardBlockToolInput,
+        execute: async ({ dashboardTitle, tableName, intent }) => {
+            try {
+                if (addDashboardBlock) {
+                    const result = await addDashboardBlock({
+                        title: dashboardTitle,
+                        tableName,
+                        intent,
+                    });
+                    return {
+                        success: true,
+                        dashboardId: result.dashboardId,
+                        blockId: result.blockId,
+                        message: 'Added Mosaic dashboard block to block document',
+                    };
+                }
+                blockDocumentAdapter.ensureBlockDocument(blockDocumentId);
+                const { dashboardId, block } = await createDashboardBlock({
+                    title: dashboardTitle,
+                    tableName,
+                    intent,
+                });
+                const blockId = await blockDocumentAdapter.addBlock(blockDocumentId, block);
+                return {
+                    success: true,
+                    dashboardId,
+                    blockId,
+                    message: 'Added Mosaic dashboard block to block document',
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    errorMessage: error instanceof Error ? error.message : String(error),
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=createAddMosaicDashboardBlockTool.js.map

package/dist/ai/block-document/createAddMosaicDashboardBlockTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAddMosaicDashboardBlockTool.js","sourceRoot":"","sources":["../../../src/ai/block-document/createAddMosaicDashboardBlockTool.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AACxB,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAC7E,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAClE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAC3E,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;CAC7E,CAAC,CAAC;AAoCH;;GAEG;AACH,MAAM,UAAU,iCAAiC,CAAC,EAChD,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACqB;IACzC,OAAO,IAAI,CAGT;QACA,WAAW,EAAE;;kHAEiG;QAC9G,WAAW,EAAE,gCAAgC;QAC7C,OAAO,EAAE,KAAK,EAAE,EAAC,cAAc,EAAE,SAAS,EAAE,MAAM,EAAC,EAAE,EAAE;YACrD,IAAI,CAAC;gBACH,IAAI,iBAAiB,EAAE,CAAC;oBACtB,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;wBACrC,KAAK,EAAE,cAAc;wBACrB,SAAS;wBACT,MAAM;qBACP,CAAC,CAAC;oBACH,OAAO;wBACL,OAAO,EAAE,IAAI;wBACb,WAAW,EAAE,MAAM,CAAC,WAAW;wBAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,OAAO,EAAE,gDAAgD;qBAC1D,CAAC;gBACJ,CAAC;gBAED,oBAAoB,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC;gBAC1D,MAAM,EAAC,WAAW,EAAE,KAAK,EAAC,GAAG,MAAM,oBAAoB,CAAC;oBACtD,KAAK,EAAE,cAAc;oBACrB,SAAS;oBACT,MAAM;iBACP,CAAC,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,QAAQ,CACjD,eAAe,EACf,KAAK,CACN,CAAC;gBAEF,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,WAAW;oBACX,OAAO;oBACP,OAAO,EAAE,gDAAgD;iBAC1D,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 type {\n  BlockDocumentAiAdapter,\n  BlockDocumentStatefulBlockBlock,\n} from '@sqlrooms/documents';\nimport {tool} from 'ai';\nimport {z} from 'zod';\nimport type {ToolOutput} from '../tool-types';\n\nconst AddMosaicDashboardBlockToolInput = z.object({\n  reasoning: z.string().describe('Brief rationale for dashboard block choice.'),\n  dashboardTitle: z.string().describe('The title of the dashboard.'),\n  tableName: z.string().describe('The name of the table/dataset to analyze.'),\n  intent: z\n    .string()\n    .optional()\n    .describe('Optional natural-language objective for this dashboard block.'),\n});\n\ntype AddMosaicDashboardBlockToolInput = z.infer<\n  typeof AddMosaicDashboardBlockToolInput\n>;\n\ntype AddMosaicDashboardBlockToolOutput = ToolOutput<{\n  dashboardId?: string;\n  blockId?: string;\n  message?: string;\n}>;\n\n/**\n * Options for creating a Mosaic dashboard block-document tool.\n */\nexport type CreateAddMosaicDashboardBlockToolOptions = {\n  /** Adapter for block document operations. */\n  blockDocumentAdapter: BlockDocumentAiAdapter;\n  /** ID of the block document where dashboard blocks will be added. */\n  blockDocumentId: string;\n  /** Host callback that performs the full durable block creation. */\n  addDashboardBlock?: (params: {\n    title: string;\n    tableName: string;\n    intent?: string;\n  }) => Promise<{dashboardId: string; blockId: string}>;\n  /** Host callback that creates Mosaic dashboard state and its document block. */\n  createDashboardBlock: (params: {\n    title: string;\n    tableName: string;\n    intent?: string;\n  }) =>\n    | {dashboardId: string; block: BlockDocumentStatefulBlockBlock}\n    | Promise<{dashboardId: string; block: BlockDocumentStatefulBlockBlock}>;\n};\n\n/**\n * Creates a tool for adding an empty Mosaic dashboard block to a block document.\n */\nexport function createAddMosaicDashboardBlockTool({\n  blockDocumentAdapter,\n  blockDocumentId,\n  addDashboardBlock,\n  createDashboardBlock,\n}: CreateAddMosaicDashboardBlockToolOptions) {\n  return tool<\n    AddMosaicDashboardBlockToolInput,\n    AddMosaicDashboardBlockToolOutput\n  >({\n    description: `Create an EMPTY Mosaic dashboard block container in the block document.\n\nThis tool ONLY creates the container structure. To populate it with charts and panels, use other tools afterward.`,\n    inputSchema: AddMosaicDashboardBlockToolInput,\n    execute: async ({dashboardTitle, tableName, intent}) => {\n      try {\n        if (addDashboardBlock) {\n          const result = await addDashboardBlock({\n            title: dashboardTitle,\n            tableName,\n            intent,\n          });\n          return {\n            success: true,\n            dashboardId: result.dashboardId,\n            blockId: result.blockId,\n            message: 'Added Mosaic dashboard block to block document',\n          };\n        }\n\n        blockDocumentAdapter.ensureBlockDocument(blockDocumentId);\n        const {dashboardId, block} = await createDashboardBlock({\n          title: dashboardTitle,\n          tableName,\n          intent,\n        });\n        const blockId = await blockDocumentAdapter.addBlock(\n          blockDocumentId,\n          block,\n        );\n\n        return {\n          success: true,\n          dashboardId,\n          blockId,\n          message: 'Added Mosaic dashboard block to block document',\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/block-document/createBlockDocumentChartTools.d.ts

@@ -0,0 +1,19 @@
+import type { Tool } from 'ai';
+import { type BlockDocumentAiAdapter } from '@sqlrooms/documents';
+import type { DatabaseAiAdapter } from '../database-types';
+import type { ChartToolsOptions } from '../types';
+/**
+ * Parameters for creating Mosaic chart tools that append chart blocks to a
+ * block document.
+ */
+export type CreateBlockDocumentChartToolsParams = {
+    databaseAdapter: DatabaseAiAdapter;
+    blockDocumentAdapter: BlockDocumentAiAdapter;
+    blockDocumentId: string;
+    chartToolsOptions?: ChartToolsOptions;
+};
+/**
+ * Creates AI tools for generating Mosaic chart blocks in a block document.
+ */
+export declare function createBlockDocumentChartTools({ databaseAdapter, blockDocumentAdapter, blockDocumentId, chartToolsOptions, }: CreateBlockDocumentChartToolsParams): Record<string, Tool>;
+//# sourceMappingURL=createBlockDocumentChartTools.d.ts.map

package/dist/ai/block-document/createBlockDocumentChartTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createBlockDocumentChartTools.d.ts","sourceRoot":"","sources":["../../../src/ai/block-document/createBlockDocumentChartTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AAC7B,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,UAAU,CAAC;AAMhD;;;GAGG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,eAAe,EAAE,iBAAiB,CAAC;IACnC,oBAAoB,EAAE,sBAAsB,CAAC;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,EAC5C,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,iBAAiB,GAClB,EAAE,mCAAmC,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAwC5D"}

package/dist/ai/block-document/createBlockDocumentChartTools.js

@@ -0,0 +1,37 @@
+import { createDefaultBlockDocumentBlockId, } from '@sqlrooms/documents';
+import { createChartTools } from '../../charts/chart-types/createChartTools';
+import { DEFAULT_CHART_MAX_DATA_POINTS } from '../constants';
+import { resolveChartTypes } from '../../charts/chart-types/resolveChartTypes';
+import { BLOCK_DOCUMENT_CHART_TOOL_PREFIX } from './constants';
+import { getMosaicTableIdentity } from '../../mosaicTableReference';
+/**
+ * Creates AI tools for generating Mosaic chart blocks in a block document.
+ */
+export function createBlockDocumentChartTools({ databaseAdapter, blockDocumentAdapter, blockDocumentId, chartToolsOptions, }) {
+    const resolvedChartTypes = resolveChartTypes(chartToolsOptions?.chartTypes);
+    const chartToolParams = {
+        maxDataPoints: chartToolsOptions?.chartMaxDataPoints ?? DEFAULT_CHART_MAX_DATA_POINTS,
+        databaseAdapter,
+        addChart: ({ config, tableName, title }) => {
+            if (!tableName) {
+                throw new Error('tableName is required for block document chart blocks but was empty or undefined');
+            }
+            const resolvedTable = databaseAdapter.findTable(tableName);
+            const tableIdentity = resolvedTable?.table
+                ? getMosaicTableIdentity(resolvedTable.table)
+                : getMosaicTableIdentity(tableName);
+            if (!tableIdentity) {
+                throw new Error('tableName is required for block document chart blocks but was empty or undefined');
+            }
+            return blockDocumentAdapter.addBlock(blockDocumentId, {
+                type: 'chart',
+                id: createDefaultBlockDocumentBlockId(),
+                config,
+                tableName: tableIdentity,
+                caption: title ?? 'Chart',
+            });
+        },
+    };
+    return createChartTools(resolvedChartTypes, chartToolParams, BLOCK_DOCUMENT_CHART_TOOL_PREFIX);
+}
+//# sourceMappingURL=createBlockDocumentChartTools.js.map

package/dist/ai/block-document/createBlockDocumentChartTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createBlockDocumentChartTools.js","sourceRoot":"","sources":["../../../src/ai/block-document/createBlockDocumentChartTools.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iCAAiC,GAElC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAC,gBAAgB,EAAC,MAAM,2CAA2C,CAAC;AAI3E,OAAO,EAAC,6BAA6B,EAAC,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAC,iBAAiB,EAAC,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EAAC,gCAAgC,EAAC,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAC,sBAAsB,EAAC,MAAM,4BAA4B,CAAC;AAalE;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAAC,EAC5C,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,iBAAiB,GACmB;IACpC,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,CAAC,EAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAC,EAAE,EAAE;YACvC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;YACJ,CAAC;YAED,MAAM,aAAa,GAAG,eAAe,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAC3D,MAAM,aAAa,GAAG,aAAa,EAAE,KAAK;gBACxC,CAAC,CAAC,sBAAsB,CAAC,aAAa,CAAC,KAAK,CAAC;gBAC7C,CAAC,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;YAEtC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;YACJ,CAAC;YAED,OAAO,oBAAoB,CAAC,QAAQ,CAAC,eAAe,EAAE;gBACpD,IAAI,EAAE,OAAO;gBACb,EAAE,EAAE,iCAAiC,EAAE;gBACvC,MAAM;gBACN,SAAS,EAAE,aAAa;gBACxB,OAAO,EAAE,KAAK,IAAI,OAAO;aAC1B,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IAEF,OAAO,gBAAgB,CACrB,kBAAkB,EAClB,eAAe,EACf,gCAAgC,CACjC,CAAC;AACJ,CAAC","sourcesContent":["import type {Tool} from 'ai';\nimport {\n  createDefaultBlockDocumentBlockId,\n  type BlockDocumentAiAdapter,\n} from '@sqlrooms/documents';\nimport {createChartTools} from '../../charts/chart-types/createChartTools';\nimport type {ChartToolParams} from '../../charts/chart-types/tool-types';\nimport type {DatabaseAiAdapter} from '../database-types';\nimport type {ChartToolsOptions} from '../types';\nimport {DEFAULT_CHART_MAX_DATA_POINTS} from '../constants';\nimport {resolveChartTypes} from '../../charts/chart-types/resolveChartTypes';\nimport {BLOCK_DOCUMENT_CHART_TOOL_PREFIX} from './constants';\nimport {getMosaicTableIdentity} from '../../mosaicTableReference';\n\n/**\n * Parameters for creating Mosaic chart tools that append chart blocks to a\n * block document.\n */\nexport type CreateBlockDocumentChartToolsParams = {\n  databaseAdapter: DatabaseAiAdapter;\n  blockDocumentAdapter: BlockDocumentAiAdapter;\n  blockDocumentId: string;\n  chartToolsOptions?: ChartToolsOptions;\n};\n\n/**\n * Creates AI tools for generating Mosaic chart blocks in a block document.\n */\nexport function createBlockDocumentChartTools({\n  databaseAdapter,\n  blockDocumentAdapter,\n  blockDocumentId,\n  chartToolsOptions,\n}: CreateBlockDocumentChartToolsParams): 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: ({config, tableName, title}) => {\n      if (!tableName) {\n        throw new Error(\n          'tableName is required for block document chart blocks but was empty or undefined',\n        );\n      }\n\n      const resolvedTable = databaseAdapter.findTable(tableName);\n      const tableIdentity = resolvedTable?.table\n        ? getMosaicTableIdentity(resolvedTable.table)\n        : getMosaicTableIdentity(tableName);\n\n      if (!tableIdentity) {\n        throw new Error(\n          'tableName is required for block document chart blocks but was empty or undefined',\n        );\n      }\n\n      return blockDocumentAdapter.addBlock(blockDocumentId, {\n        type: 'chart',\n        id: createDefaultBlockDocumentBlockId(),\n        config,\n        tableName: tableIdentity,\n        caption: title ?? 'Chart',\n      });\n    },\n  };\n\n  return createChartTools(\n    resolvedChartTypes,\n    chartToolParams,\n    BLOCK_DOCUMENT_CHART_TOOL_PREFIX,\n  );\n}\n"]}

package/dist/ai/block-document/createBlockDocumentDataTableExplorerTool.d.ts

@@ -0,0 +1,32 @@
+import type { Tool } from 'ai';
+import type { BlockDocumentAiAdapter, BlockDocumentStatefulBlockBlock } from '@sqlrooms/documents';
+import type { DatabaseAiAdapter } from '../database-types';
+/**
+ * Parameters for creating a Mosaic data-table explorer block-document tool.
+ */
+export type CreateBlockDocumentDataTableExplorerToolParams = {
+    /** Database adapter for table validation and column information. */
+    databaseAdapter: DatabaseAiAdapter;
+    /** Adapter for block document operations. */
+    blockDocumentAdapter: BlockDocumentAiAdapter;
+    /** ID of the block document where data-table explorer blocks will be added. */
+    blockDocumentId: string;
+    /** Host callback that performs the full durable block creation. */
+    addDataTableExplorerBlock?: (params: {
+        title: string;
+        tableName: string;
+        intent?: string;
+    }) => Promise<unknown>;
+    /** Host callback that creates the data-table explorer stateful block. */
+    createDataTableExplorerBlock: (params: {
+        title: string;
+        tableName: string;
+        intent?: string;
+    }) => BlockDocumentStatefulBlockBlock | Promise<BlockDocumentStatefulBlockBlock>;
+};
+/**
+ * Creates an AI tool for adding Mosaic data-table explorer blocks to a block
+ * document.
+ */
+export declare function createBlockDocumentDataTableExplorerTool({ blockDocumentAdapter, databaseAdapter, blockDocumentId, addDataTableExplorerBlock, createDataTableExplorerBlock, }: CreateBlockDocumentDataTableExplorerToolParams): Tool;
+//# sourceMappingURL=createBlockDocumentDataTableExplorerTool.d.ts.map

package/dist/ai/block-document/createBlockDocumentDataTableExplorerTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createBlockDocumentDataTableExplorerTool.d.ts","sourceRoot":"","sources":["../../../src/ai/block-document/createBlockDocumentDataTableExplorerTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AAC7B,OAAO,KAAK,EACV,sBAAsB,EACtB,+BAA+B,EAChC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAGzD;;GAEG;AACH,MAAM,MAAM,8CAA8C,GAAG;IAC3D,oEAAoE;IACpE,eAAe,EAAE,iBAAiB,CAAC;IACnC,6CAA6C;IAC7C,oBAAoB,EAAE,sBAAsB,CAAC;IAC7C,+EAA+E;IAC/E,eAAe,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,yBAAyB,CAAC,EAAE,CAAC,MAAM,EAAE;QACnC,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvB,yEAAyE;IACzE,4BAA4B,EAAE,CAAC,MAAM,EAAE;QACrC,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,KACG,+BAA+B,GAC/B,OAAO,CAAC,+BAA+B,CAAC,CAAC;CAC9C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,wCAAwC,CAAC,EACvD,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,4BAA4B,GAC7B,EAAE,8CAA8C,GAAG,IAAI,CAwCvD"}

package/dist/ai/block-document/createBlockDocumentDataTableExplorerTool.js

@@ -0,0 +1,37 @@
+import { createDataTableExplorerTool } from '../createDataTableExplorerTool';
+import { getMosaicTableIdentity } from '../../mosaicTableReference';
+/**
+ * Creates an AI tool for adding Mosaic data-table explorer blocks to a block
+ * document.
+ */
+export function createBlockDocumentDataTableExplorerTool({ blockDocumentAdapter, databaseAdapter, blockDocumentId, addDataTableExplorerBlock, createDataTableExplorerBlock, }) {
+    return createDataTableExplorerTool({
+        databaseAdapter,
+        addDataTable: async ({ title, tableName, intent }) => {
+            if (!tableName) {
+                throw new Error('Table name is required to add a data table explorer block');
+            }
+            blockDocumentAdapter.ensureBlockDocument(blockDocumentId);
+            const resolvedTable = databaseAdapter.findTable(tableName);
+            const tableIdentity = resolvedTable?.table
+                ? getMosaicTableIdentity(resolvedTable.table)
+                : getMosaicTableIdentity(tableName);
+            if (!tableIdentity) {
+                throw new Error('Table name is required to add a data table explorer block');
+            }
+            if (addDataTableExplorerBlock) {
+                return await addDataTableExplorerBlock({
+                    title: title ?? 'Data Table Explorer',
+                    tableName: tableIdentity,
+                    intent,
+                });
+            }
+            await blockDocumentAdapter.addBlock(blockDocumentId, await createDataTableExplorerBlock({
+                title: title ?? 'Data Table Explorer',
+                tableName: tableIdentity,
+                intent,
+            }));
+        },
+    });
+}
+//# sourceMappingURL=createBlockDocumentDataTableExplorerTool.js.map

package/dist/ai/block-document/createBlockDocumentDataTableExplorerTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createBlockDocumentDataTableExplorerTool.js","sourceRoot":"","sources":["../../../src/ai/block-document/createBlockDocumentDataTableExplorerTool.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,2BAA2B,EAAC,MAAM,gCAAgC,CAAC;AAE3E,OAAO,EAAC,sBAAsB,EAAC,MAAM,4BAA4B,CAAC;AA4BlE;;;GAGG;AACH,MAAM,UAAU,wCAAwC,CAAC,EACvD,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,4BAA4B,GACmB;IAC/C,OAAO,2BAA2B,CAAC;QACjC,eAAe;QACf,YAAY,EAAE,KAAK,EAAE,EAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAC,EAAE,EAAE;YACjD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;YACJ,CAAC;YAED,oBAAoB,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC;YAC1D,MAAM,aAAa,GAAG,eAAe,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAC3D,MAAM,aAAa,GAAG,aAAa,EAAE,KAAK;gBACxC,CAAC,CAAC,sBAAsB,CAAC,aAAa,CAAC,KAAK,CAAC;gBAC7C,CAAC,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;YAEtC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;YACJ,CAAC;YAED,IAAI,yBAAyB,EAAE,CAAC;gBAC9B,OAAO,MAAM,yBAAyB,CAAC;oBACrC,KAAK,EAAE,KAAK,IAAI,qBAAqB;oBACrC,SAAS,EAAE,aAAa;oBACxB,MAAM;iBACP,CAAC,CAAC;YACL,CAAC;YAED,MAAM,oBAAoB,CAAC,QAAQ,CACjC,eAAe,EACf,MAAM,4BAA4B,CAAC;gBACjC,KAAK,EAAE,KAAK,IAAI,qBAAqB;gBACrC,SAAS,EAAE,aAAa;gBACxB,MAAM;aACP,CAAC,CACH,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type {Tool} from 'ai';\nimport type {\n  BlockDocumentAiAdapter,\n  BlockDocumentStatefulBlockBlock,\n} from '@sqlrooms/documents';\nimport {createDataTableExplorerTool} from '../createDataTableExplorerTool';\nimport type {DatabaseAiAdapter} from '../database-types';\nimport {getMosaicTableIdentity} from '../../mosaicTableReference';\n\n/**\n * Parameters for creating a Mosaic data-table explorer block-document tool.\n */\nexport type CreateBlockDocumentDataTableExplorerToolParams = {\n  /** Database adapter for table validation and column information. */\n  databaseAdapter: DatabaseAiAdapter;\n  /** Adapter for block document operations. */\n  blockDocumentAdapter: BlockDocumentAiAdapter;\n  /** ID of the block document where data-table explorer blocks will be added. */\n  blockDocumentId: string;\n  /** Host callback that performs the full durable block creation. */\n  addDataTableExplorerBlock?: (params: {\n    title: string;\n    tableName: string;\n    intent?: string;\n  }) => Promise<unknown>;\n  /** Host callback that creates the data-table explorer stateful block. */\n  createDataTableExplorerBlock: (params: {\n    title: string;\n    tableName: string;\n    intent?: string;\n  }) =>\n    | BlockDocumentStatefulBlockBlock\n    | Promise<BlockDocumentStatefulBlockBlock>;\n};\n\n/**\n * Creates an AI tool for adding Mosaic data-table explorer blocks to a block\n * document.\n */\nexport function createBlockDocumentDataTableExplorerTool({\n  blockDocumentAdapter,\n  databaseAdapter,\n  blockDocumentId,\n  addDataTableExplorerBlock,\n  createDataTableExplorerBlock,\n}: CreateBlockDocumentDataTableExplorerToolParams): Tool {\n  return createDataTableExplorerTool({\n    databaseAdapter,\n    addDataTable: async ({title, tableName, intent}) => {\n      if (!tableName) {\n        throw new Error(\n          'Table name is required to add a data table explorer block',\n        );\n      }\n\n      blockDocumentAdapter.ensureBlockDocument(blockDocumentId);\n      const resolvedTable = databaseAdapter.findTable(tableName);\n      const tableIdentity = resolvedTable?.table\n        ? getMosaicTableIdentity(resolvedTable.table)\n        : getMosaicTableIdentity(tableName);\n\n      if (!tableIdentity) {\n        throw new Error(\n          'Table name is required to add a data table explorer block',\n        );\n      }\n\n      if (addDataTableExplorerBlock) {\n        return await addDataTableExplorerBlock({\n          title: title ?? 'Data Table Explorer',\n          tableName: tableIdentity,\n          intent,\n        });\n      }\n\n      await blockDocumentAdapter.addBlock(\n        blockDocumentId,\n        await createDataTableExplorerBlock({\n          title: title ?? 'Data Table Explorer',\n          tableName: tableIdentity,\n          intent,\n        }),\n      );\n    },\n  });\n}\n"]}

package/dist/ai/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const MAP_TOOL_KEY = "create_dashboard_map";
+export declare const DEFAULT_CHART_MAX_DATA_POINTS = 10000;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/ai/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,yBAAyB,CAAC;AAEnD,eAAO,MAAM,6BAA6B,QAAQ,CAAC"}

package/dist/ai/constants.js

@@ -0,0 +1,3 @@
+export const MAP_TOOL_KEY = 'create_dashboard_map';
+export const DEFAULT_CHART_MAX_DATA_POINTS = 10000;
+//# sourceMappingURL=constants.js.map

package/dist/ai/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/ai/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,sBAAsB,CAAC;AAEnD,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,CAAC","sourcesContent":["export const MAP_TOOL_KEY = 'create_dashboard_map';\n\nexport const DEFAULT_CHART_MAX_DATA_POINTS = 10000;\n"]}

package/dist/ai/createDataTableExplorerTool.d.ts

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+import { DatabaseAiAdapter } from './database-types';
+/**
+ * Parameters for creating a Data Table Explorer panel.
+ */
+export declare const DataTableExplorerParameters: z.ZodObject<{
+    tableName: z.ZodOptional<z.ZodString>;
+    title: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    intent: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Inferred type for Data Table Explorer parameters.
+ */
+export type DataTableExplorerParameters = z.infer<typeof DataTableExplorerParameters>;
+/**
+ * Tool input schema including reasoning and explorer parameters.
+ */
+export declare const DataTableExplorerToolInput: z.ZodObject<{
+    tableName: z.ZodOptional<z.ZodString>;
+    title: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    intent: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Inferred type for Data Table Explorer tool input.
+ */
+export type DataTableExplorerToolInput = z.infer<typeof DataTableExplorerToolInput>;
+/**
+ * Options for creating the Data Table Explorer tool.
+ */
+export type CreateDataTableExplorerToolOptions = {
+    databaseAdapter: DatabaseAiAdapter;
+    addDataTable(params: DataTableExplorerParameters): unknown | Promise<unknown>;
+};
+/**
+ * Creates an AI tool for generating Data Table Explorer panels with schema and column statistics.
+ */
+export declare function createDataTableExplorerTool({ databaseAdapter, addDataTable, }: CreateDataTableExplorerToolOptions): import("ai").Tool<{
+    title: string;
+    reasoning: string;
+    tableName?: string | undefined;
+    intent?: string | undefined;
+}, {
+    llmResult: {
+        success: boolean;
+        details: string;
+        data: {
+            title: string;
+            reasoning: string;
+            tableName?: string | undefined;
+            intent?: string | undefined;
+        } | {
+            dataTable: {};
+            title: string;
+            reasoning: string;
+            tableName?: string | undefined;
+            intent?: string | undefined;
+        };
+        errorMessage?: undefined;
+    };
+} | {
+    llmResult: {
+        success: boolean;
+        errorMessage: string;
+        details?: undefined;
+        data?: undefined;
+    };
+}>;
+//# sourceMappingURL=createDataTableExplorerTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createDataTableExplorerTool.d.ts","sourceRoot":"","sources":["../../src/ai/createDataTableExplorerTool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,OAAO,EAAC,iBAAiB,EAAC,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;iBAiBtC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,2BAA2B,CACnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;iBAKrC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,0BAA0B,CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,eAAe,EAAE,iBAAiB,CAAC;IACnC,YAAY,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/E,CAAC;AAEF;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,eAAe,EACf,YAAY,GACb,EAAE,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCpC"}