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

package/dist/VgPlotChart.js

@@ -1,10 +1,11 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { memo, useCallback, useEffect, useMemo, useRef, useState, } from 'react';
+import { memo, useCallback, useLayoutEffect, useMemo, useRef, useState, } from 'react';
 import { ResponsivePlot } from './ResponsivePlot';
 import { useVgPlotChartError } from './useVgPlotChartError';
 import { useVgPlotChartRetention, } from './useVgPlotChartRetention';
 import { useVgPlotChartRender } from './useVgPlotChartRender';
 import { VgPlotChartError } from './VgPlotChartError';
+import { cn } from '@sqlrooms/ui';
 export function isSpecProps(props) {
     return 'spec' in props;
 }
@@ -55,12 +56,15 @@ export const VgPlotChart = memo((props) => {
     }, [setCachedChart]);
     const cachedChart = useMemo(() => getCachedChart(), [getCachedChart]);
     // Handle PlotProps: directly render the provided plot element
-    useEffect(() => {
+    useLayoutEffect(() => {
         const container = containerRef.current;
         if (!container || !isPlotProps(props)) {
             return;
         }
-        container.replaceChildren(props.plot);
+        if (container.childNodes.length !== 1 ||
+            container.firstChild !== props.plot) {
+            container.replaceChildren(props.plot);
+        }
     }, [props]);
     // Handle SpecProps: render from spec using hooks
     const renderParams = useMemo(() => {
@@ -101,11 +105,16 @@ export const VgPlotChart = memo((props) => {
         handleError,
     ]);
     useVgPlotChartRender(renderParams);
-    // Show error message if present
-    if (error) {
+    // Show error message only if no runtime issue reporter exists
+    // (when runtime issue reporter exists, errors are shown by MosaicChartRuntimeIssuePanel)
+    const hasRuntimeIssueReporter = isSpecProps(props) && props.runtimeIssueReporter;
+    if (error && !hasRuntimeIssueReporter) {
         return _jsx(VgPlotChartError, { error: error });
     }
-    return (_jsx(ResponsivePlot, { ref: containerRef, onResize: handleResize, className: "h-full w-full" }));
+    return (_jsx(ResponsivePlot, { ref: containerRef, onResize: handleResize, className: cn('h-full w-full', // container classes
+        '[&>div]:h-full [&>div]:w-full [&>div]:!items-center', // child div classes
+        '[&_.plot]:h-full [&_.plot]:!min-h-0 [&_.plot]:w-full [&_.plot]:!flex-1', // plot classes
+        '[&_.legend]:!flex [&_.legend]:!flex-none [&_.legend]:!justify-center [&_.legend>*]:!mx-auto') }));
 }, (prevProps, nextProps) => {
     if (isPlotProps(prevProps) && isPlotProps(nextProps)) {
         return prevProps.plot === nextProps.plot;

package/dist/VgPlotChart.js.map

@@ -1 +1 @@
-{"version":3,"file":"VgPlotChart.js","sourceRoot":"","sources":["../src/VgPlotChart.tsx"],"names":[],"mappings":"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","sourcesContent":["import {Param, Selection} from '@uwdata/mosaic-core';\nimport {Spec} from '@uwdata/mosaic-spec';\nimport {\n  FC,\n  memo,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport {PlotSize, ResponsivePlot} from './ResponsivePlot';\nimport {useVgPlotChartError} from './useVgPlotChartError';\nimport {\n  RetainedVgPlotChart,\n  useVgPlotChartRetention,\n  VgPlotChartRetention,\n} from './useVgPlotChartRetention';\nimport {useVgPlotChartRender} from './useVgPlotChartRender';\nimport {VgPlotChartError} from './VgPlotChartError';\nimport type {\n  ChartDataPolicy,\n  ChartRuntimeIssueContext,\n  ChartRuntimeIssueReporter,\n} from './chart-runtime';\n\ntype SpecProps = {\n  spec: Spec;\n  /**\n   * Pre-defined params/selections to inject when rendering the spec.\n   * Keys are param names (without $), values are Param or Selection instances.\n   * This allows multiple independently-rendered specs to share the same\n   * Selection objects for cross-filtering.\n   */\n  params?: Map<string, Param<any> | Selection>;\n  /**\n   * Optional retention adapter for preserving the underlying vgplot\n   * instance across temporary unmount/remount cycles, such as dashboard tab\n   * switches.\n   */\n  retention?: VgPlotChartRetention;\n  dataPolicy?: ChartDataPolicy | null;\n  runtimeIssueContext?: ChartRuntimeIssueContext;\n  runtimeIssueReporter?: ChartRuntimeIssueReporter;\n};\ntype PlotProps = {plot: HTMLElement | SVGSVGElement};\ntype VgPlotChartProps = SpecProps | PlotProps;\n\nexport function isSpecProps(props: VgPlotChartProps): props is SpecProps {\n  return 'spec' in props;\n}\n\nexport function isPlotProps(props: VgPlotChartProps): props is PlotProps {\n  return 'plot' in props;\n}\n\n// Re-export types for external use\nexport type {VgPlotChartRetention} from './useVgPlotChartRetention';\nexport {destroyRetainedVgPlotChart} from './useVgPlotChartRetention';\nexport type {RetainedVgPlotChart} from './useVgPlotChartRetention';\n\nfunction areEquivalentParams(\n  left?: Map<string, Param<any> | Selection>,\n  right?: Map<string, Param<any> | Selection>,\n) {\n  if (left === right) {\n    return true;\n  }\n  if (!left || !right || left.size !== right.size) {\n    return false;\n  }\n  for (const [key, value] of left) {\n    if (right.get(key) !== value) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/**\n * Renders a Vega-Lite chart using the Mosaic library.\n *\n * @param {VgPlotChartProps} props - The component props.\n * @param {Spec} props.spec - The Vega-Lite specification for the chart.\n * @returns {React.ReactElement} The rendered chart component.\n */\nexport const VgPlotChart: FC<VgPlotChartProps> = memo(\n  (props) => {\n    const [containerSize, setContainerSize] = useState<PlotSize | null>(null);\n    const containerRef = useRef<HTMLDivElement>(null);\n\n    const specKey = useMemo(\n      () => (isSpecProps(props) ? JSON.stringify(props.spec) : null),\n      [props],\n    );\n\n    const {error, setError} = useVgPlotChartError(specKey);\n    const {getCachedChart, setCachedChart} = useVgPlotChartRetention(\n      specKey,\n      isSpecProps(props) ? props.params : undefined,\n      isSpecProps(props) ? props.retention : undefined,\n    );\n\n    const handleResize = useCallback((size: PlotSize) => {\n      setContainerSize((prev) => {\n        if (prev && prev.width === size.width && prev.height === size.height) {\n          return prev;\n        }\n        return size;\n      });\n    }, []);\n\n    const handleError = useCallback(\n      (error: Error) => {\n        setError(error);\n      },\n      [setError],\n    );\n\n    const handleChartCreated = useCallback(\n      (chart: RetainedVgPlotChart) => {\n        setCachedChart(chart);\n      },\n      [setCachedChart],\n    );\n\n    const cachedChart = useMemo(() => getCachedChart(), [getCachedChart]);\n\n    // Handle PlotProps: directly render the provided plot element\n    useEffect(() => {\n      const container = containerRef.current;\n      if (!container || !isPlotProps(props)) {\n        return;\n      }\n\n      container.replaceChildren(props.plot);\n    }, [props]);\n\n    // Handle SpecProps: render from spec using hooks\n    const renderParams = useMemo(() => {\n      if (!isSpecProps(props)) {\n        return {\n          containerRef,\n          spec: {} as Spec,\n          specKey: null,\n          params: undefined,\n          containerSize: null,\n          cachedChart: null,\n          onChartCreated: handleChartCreated,\n          onError: handleError,\n          dataPolicy: undefined,\n          runtimeIssueContext: undefined,\n          runtimeIssueReporter: undefined,\n        };\n      }\n\n      return {\n        containerRef,\n        spec: props.spec,\n        specKey,\n        params: props.params,\n        containerSize,\n        cachedChart,\n        onChartCreated: handleChartCreated,\n        onError: handleError,\n        dataPolicy: props.dataPolicy,\n        runtimeIssueContext: props.runtimeIssueContext,\n        runtimeIssueReporter: props.runtimeIssueReporter,\n      };\n    }, [\n      props,\n      specKey,\n      containerSize,\n      cachedChart,\n      handleChartCreated,\n      handleError,\n    ]);\n\n    useVgPlotChartRender(renderParams);\n\n    // Show error message if present\n    if (error) {\n      return <VgPlotChartError error={error} />;\n    }\n\n    return (\n      <ResponsivePlot\n        ref={containerRef}\n        onResize={handleResize}\n        className=\"h-full w-full\"\n      />\n    );\n  },\n  (prevProps, nextProps) => {\n    if (isPlotProps(prevProps) && isPlotProps(nextProps)) {\n      return prevProps.plot === nextProps.plot;\n    }\n    if (isSpecProps(prevProps) && isSpecProps(nextProps)) {\n      const specEqual =\n        JSON.stringify(prevProps.spec) === JSON.stringify(nextProps.spec);\n      const paramsEqual = areEquivalentParams(\n        prevProps.params,\n        nextProps.params,\n      );\n      const retentionEqual = prevProps.retention === nextProps.retention;\n      const policyEqual = prevProps.dataPolicy === nextProps.dataPolicy;\n      const issueReporterEqual =\n        prevProps.runtimeIssueReporter === nextProps.runtimeIssueReporter;\n      const issueContextEqual =\n        prevProps.runtimeIssueContext === nextProps.runtimeIssueContext;\n      return (\n        specEqual &&\n        paramsEqual &&\n        retentionEqual &&\n        policyEqual &&\n        issueContextEqual &&\n        issueReporterEqual\n      );\n    }\n    return false;\n  },\n);\n\nVgPlotChart.displayName = 'VgPlotChart';\n"]}
+{"version":3,"file":"VgPlotChart.js","sourceRoot":"","sources":["../src/VgPlotChart.tsx"],"names":[],"mappings":"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","sourcesContent":["import {Param, Selection} from '@uwdata/mosaic-core';\nimport {Spec} from '@uwdata/mosaic-spec';\nimport {\n  FC,\n  memo,\n  useCallback,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport {PlotSize, ResponsivePlot} from './ResponsivePlot';\nimport {useVgPlotChartError} from './useVgPlotChartError';\nimport {\n  RetainedVgPlotChart,\n  useVgPlotChartRetention,\n  VgPlotChartRetention,\n} from './useVgPlotChartRetention';\nimport {useVgPlotChartRender} from './useVgPlotChartRender';\nimport {VgPlotChartError} from './VgPlotChartError';\nimport type {\n  ChartDataPolicy,\n  ChartRuntimeIssueContext,\n  ChartRuntimeIssueReporter,\n} from './chart-runtime';\nimport {cn} from '@sqlrooms/ui';\n\ntype SpecProps = {\n  spec: Spec;\n  /**\n   * Pre-defined params/selections to inject when rendering the spec.\n   * Keys are param names (without $), values are Param or Selection instances.\n   * This allows multiple independently-rendered specs to share the same\n   * Selection objects for cross-filtering.\n   */\n  params?: Map<string, Param<any> | Selection>;\n  /**\n   * Optional retention adapter for preserving the underlying vgplot\n   * instance across temporary unmount/remount cycles, such as dashboard tab\n   * switches.\n   */\n  retention?: VgPlotChartRetention;\n  dataPolicy?: ChartDataPolicy | null;\n  runtimeIssueContext?: ChartRuntimeIssueContext;\n  runtimeIssueReporter?: ChartRuntimeIssueReporter;\n};\ntype PlotProps = {plot: HTMLElement | SVGSVGElement};\ntype VgPlotChartProps = SpecProps | PlotProps;\n\nexport function isSpecProps(props: VgPlotChartProps): props is SpecProps {\n  return 'spec' in props;\n}\n\nexport function isPlotProps(props: VgPlotChartProps): props is PlotProps {\n  return 'plot' in props;\n}\n\n// Re-export types for external use\nexport type {VgPlotChartRetention} from './useVgPlotChartRetention';\nexport {destroyRetainedVgPlotChart} from './useVgPlotChartRetention';\nexport type {RetainedVgPlotChart} from './useVgPlotChartRetention';\n\nfunction areEquivalentParams(\n  left?: Map<string, Param<any> | Selection>,\n  right?: Map<string, Param<any> | Selection>,\n) {\n  if (left === right) {\n    return true;\n  }\n  if (!left || !right || left.size !== right.size) {\n    return false;\n  }\n  for (const [key, value] of left) {\n    if (right.get(key) !== value) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/**\n * Renders a Vega-Lite chart using the Mosaic library.\n *\n * @param {VgPlotChartProps} props - The component props.\n * @param {Spec} props.spec - The Vega-Lite specification for the chart.\n * @returns {React.ReactElement} The rendered chart component.\n */\nexport const VgPlotChart: FC<VgPlotChartProps> = memo(\n  (props) => {\n    const [containerSize, setContainerSize] = useState<PlotSize | null>(null);\n    const containerRef = useRef<HTMLDivElement>(null);\n\n    const specKey = useMemo(\n      () => (isSpecProps(props) ? JSON.stringify(props.spec) : null),\n      [props],\n    );\n\n    const {error, setError} = useVgPlotChartError(specKey);\n    const {getCachedChart, setCachedChart} = useVgPlotChartRetention(\n      specKey,\n      isSpecProps(props) ? props.params : undefined,\n      isSpecProps(props) ? props.retention : undefined,\n    );\n\n    const handleResize = useCallback((size: PlotSize) => {\n      setContainerSize((prev) => {\n        if (prev && prev.width === size.width && prev.height === size.height) {\n          return prev;\n        }\n        return size;\n      });\n    }, []);\n\n    const handleError = useCallback(\n      (error: Error) => {\n        setError(error);\n      },\n      [setError],\n    );\n\n    const handleChartCreated = useCallback(\n      (chart: RetainedVgPlotChart) => {\n        setCachedChart(chart);\n      },\n      [setCachedChart],\n    );\n\n    const cachedChart = useMemo(() => getCachedChart(), [getCachedChart]);\n\n    // Handle PlotProps: directly render the provided plot element\n    useLayoutEffect(() => {\n      const container = containerRef.current;\n      if (!container || !isPlotProps(props)) {\n        return;\n      }\n\n      if (\n        container.childNodes.length !== 1 ||\n        container.firstChild !== props.plot\n      ) {\n        container.replaceChildren(props.plot);\n      }\n    }, [props]);\n\n    // Handle SpecProps: render from spec using hooks\n    const renderParams = useMemo(() => {\n      if (!isSpecProps(props)) {\n        return {\n          containerRef,\n          spec: {} as Spec,\n          specKey: null,\n          params: undefined,\n          containerSize: null,\n          cachedChart: null,\n          onChartCreated: handleChartCreated,\n          onError: handleError,\n          dataPolicy: undefined,\n          runtimeIssueContext: undefined,\n          runtimeIssueReporter: undefined,\n        };\n      }\n\n      return {\n        containerRef,\n        spec: props.spec,\n        specKey,\n        params: props.params,\n        containerSize,\n        cachedChart,\n        onChartCreated: handleChartCreated,\n        onError: handleError,\n        dataPolicy: props.dataPolicy,\n        runtimeIssueContext: props.runtimeIssueContext,\n        runtimeIssueReporter: props.runtimeIssueReporter,\n      };\n    }, [\n      props,\n      specKey,\n      containerSize,\n      cachedChart,\n      handleChartCreated,\n      handleError,\n    ]);\n\n    useVgPlotChartRender(renderParams);\n\n    // Show error message only if no runtime issue reporter exists\n    // (when runtime issue reporter exists, errors are shown by MosaicChartRuntimeIssuePanel)\n    const hasRuntimeIssueReporter =\n      isSpecProps(props) && props.runtimeIssueReporter;\n    if (error && !hasRuntimeIssueReporter) {\n      return <VgPlotChartError error={error} />;\n    }\n\n    return (\n      <ResponsivePlot\n        ref={containerRef}\n        onResize={handleResize}\n        className={cn(\n          'h-full w-full', // container classes\n          '[&>div]:h-full [&>div]:w-full [&>div]:!items-center', // child div classes\n          '[&_.plot]:h-full [&_.plot]:!min-h-0 [&_.plot]:w-full [&_.plot]:!flex-1', // plot classes\n          '[&_.legend]:!flex [&_.legend]:!flex-none [&_.legend]:!justify-center [&_.legend>*]:!mx-auto', // legend classes\n        )}\n      />\n    );\n  },\n  (prevProps, nextProps) => {\n    if (isPlotProps(prevProps) && isPlotProps(nextProps)) {\n      return prevProps.plot === nextProps.plot;\n    }\n    if (isSpecProps(prevProps) && isSpecProps(nextProps)) {\n      const specEqual =\n        JSON.stringify(prevProps.spec) === JSON.stringify(nextProps.spec);\n      const paramsEqual = areEquivalentParams(\n        prevProps.params,\n        nextProps.params,\n      );\n      const retentionEqual = prevProps.retention === nextProps.retention;\n      const policyEqual = prevProps.dataPolicy === nextProps.dataPolicy;\n      const issueReporterEqual =\n        prevProps.runtimeIssueReporter === nextProps.runtimeIssueReporter;\n      const issueContextEqual =\n        prevProps.runtimeIssueContext === nextProps.runtimeIssueContext;\n\n      return (\n        specEqual &&\n        paramsEqual &&\n        retentionEqual &&\n        policyEqual &&\n        issueContextEqual &&\n        issueReporterEqual\n      );\n    }\n    return false;\n  },\n);\n\nVgPlotChart.displayName = 'VgPlotChart';\n"]}

package/dist/ai/ai.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Reusable AI helpers for Mosaic dashboards.
+ *
+ * Host apps provide a narrow adapter for their store/artifact model; Mosaic owns
+ * the dashboard tool behavior and prompts.
+ *
+ * @packageDocumentation
+ */
+import { type QualifiedTableName } from '@sqlrooms/duckdb';
+import { type LanguageModel, type Tool, ToolLoopAgent } from 'ai';
+import { type ChartBuilderColumn, type ChartToolExecutionContext, type DashboardToolDeps, type PanelPatch, type ChartTypeDefinition } from '../charts/chart-types';
+import type { MosaicDashboardEntry, MosaicDashboardPanelConfig } from '../dashboard/dashboard-types';
+import type { MosaicDashboardLayoutType } from '../dashboard/core-types';
+import { type ChartRuntimeIssue } from '../chart-runtime';
+export type { ChartToolExecutionContext } from '../charts/chart-types';
+export type DashboardAiStore<TState> = {
+    getState: () => TState;
+};
+export type DashboardAiTable = {
+    /**
+     * Canonical table identity used for routing after natural-language table
+     * selection resolves to a concrete table.
+     */
+    qualifiedName: QualifiedTableName;
+    columns?: ChartBuilderColumn[];
+    rowCount?: number;
+};
+export type DashboardAiAdapter<TState> = {
+    getTables: (state: TState) => DashboardAiTable[];
+    hasRunContext?: (state: TState, context?: ChartToolExecutionContext) => boolean;
+    resolveContextDashboardArtifactId?: (state: TState, context?: ChartToolExecutionContext) => string | undefined;
+    makeDashboardPrimaryForRun?: (state: TState, dashboardId: string, context?: ChartToolExecutionContext) => void;
+    getCurrentDashboardArtifactId: (state: TState) => string | undefined;
+    createDashboardArtifact: (state: TState, title?: string, layoutType?: MosaicDashboardLayoutType) => string;
+    isDashboardArtifact: (state: TState, artifactId: string) => boolean;
+    setCurrentArtifact: (state: TState, artifactId: string) => void;
+    ensureDashboard: (state: TState, dashboardId: string, title?: string, layoutType?: MosaicDashboardLayoutType) => void;
+    getDashboard: (state: TState, dashboardId: string) => MosaicDashboardEntry | undefined;
+    getPanelIssue?: (state: TState, dashboardId: string, panelId: string) => ChartRuntimeIssue | undefined;
+    setSelectedTable: (state: TState, dashboardId: string, tableName: string) => void;
+    addPanel: (state: TState, dashboardId: string, panel: MosaicDashboardPanelConfig) => string;
+    updatePanel: (state: TState, dashboardId: string, panelId: string, patch: Partial<PanelPatch>) => void;
+    removePanel: (state: TState, dashboardId: string, panelId: string) => void;
+};
+export type CreateDashboardToolDepsOptions<TState> = {
+    store: DashboardAiStore<TState>;
+    adapter: DashboardAiAdapter<TState>;
+};
+export type CreateDashboardAiToolsOptions<TState> = CreateDashboardToolDepsOptions<TState> & {
+    chartTypes?: ChartTypeDefinition<any>[];
+    /**
+     * Host-provided dashboard tools keyed by their registered tool name.
+     * Register geospatial map tools under MAP_TOOL_KEY so prompts and tools
+     * stay in sync.
+     */
+    extraTools?: (deps: DashboardToolDeps) => Record<string, Tool>;
+};
+export type DashboardAgentToolCall = {
+    toolName: string;
+};
+export type DashboardAgentRunResult = {
+    finalOutput?: string;
+    agentToolCalls?: DashboardAgentToolCall[];
+};
+export type DashboardAgentResult = {
+    success: boolean;
+    finalOutput: string;
+    dashboardId: string;
+    error?: string;
+    metadata?: {
+        tableName: string;
+        panelsCreated: number;
+        stepsExecuted: number;
+        queriesRun: number;
+    };
+};
+export type CreateDashboardAgentToolOptions<TState> = CreateDashboardToolDepsOptions<TState> & {
+    getModel: (args: {
+        state: TState;
+    }) => LanguageModel;
+    createQueryTools?: (args: {
+        store: DashboardAiStore<TState>;
+    }) => {
+        query: Tool;
+    } & Record<string, Tool>;
+    runSubAgent: (args: {
+        agent: ToolLoopAgent<any, any, any>;
+        prompt: string;
+        store: DashboardAiStore<TState>;
+        parentToolCallId: string;
+        abortSignal?: AbortSignal;
+    }) => Promise<DashboardAgentRunResult>;
+    instructions?: string;
+    chartTypes?: ChartTypeDefinition<any>[];
+    /**
+     * Host-provided dashboard tools keyed by their registered tool name.
+     * Register geospatial map tools under MAP_TOOL_KEY so prompts and tools
+     * stay in sync.
+     */
+    extraTools?: (deps: DashboardToolDeps) => Record<string, Tool>;
+};
+export declare const MAP_TOOL_KEY = "create_dashboard_map";
+export declare const DASHBOARD_AI_INSTRUCTIONS = "\nDashboard authoring:\n\n**When to use dashboard_agent vs individual tools:**\n- Use `dashboard_agent` for exploratory requests that require data analysis and discovery:\n  - \"analyze the earthquakes dataset\"\n  - \"create insights dashboard for sales data\"\n  - \"find interesting patterns in customer behavior\"\n  - Any request asking to \"discover\", \"explore\", \"find insights\", or \"analyze\"\n- Use individual chart tools for direct, specific requests:\n  - \"create histogram of magnitude with 20 bins\"\n  - \"add a line chart showing sales over time\"\n  - \"update the histogram to use 30 bins\"\n\n**Individual dashboard chart tools:**\n- create_dashboard_histogram, create_dashboard_line_chart, create_dashboard_box_plot, create_dashboard_scatter_plot, create_dashboard_count_plot, create_dashboard_heatmap\n- Each chart type has its own tool with specific parameters.\n- For line charts with aggregation, use yFields array with {field: string, aggregate: \"sum\"|\"avg\"|\"min\"|\"max\"}.\n- Set xInterval for temporal binning (year, month, day, hour, etc.).\n- If the host app provides `create_dashboard_map`, use it for map/geospatial/location requests and tables with longitude/latitude or geometry columns. Author its config as native Deck JSON with layer classes in `spec.layers[].@@type`, dataset bindings in `_sqlroomsBinding.dataset`, and table/query sources in `config.datasets`. For data-driven map colors, use color accessors such as `getFillColor`, `getLineColor`, `getColor`, `getSourceColor`, or `getTargetColor` with `{\"@@function\":\"colorScale\", \"field\":\"...\", \"type\":\"sequential\"|\"diverging\"|\"quantize\"|\"quantile\"|\"categorical\", \"scheme\":\"Viridis\", \"domain\":\"auto\"}`.\n- Use `set_dashboard_vgplot` with complete JSON only when no chart tool fits your needs.\n- When calling `create_dashboard_artifact`, `layoutType` may be `grid` or `dock`; omitted values default to `grid`.\n- Ensure specs are valid JSON objects compatible with https://idl.uw.edu/mosaic/schema/latest.json.\n- `list_dashboard_panels` includes runtime issues when a chart failed. Use those issues to repair panels in place: convert too-large scatter charts to heatmaps, add `xInterval` to too-large line charts, and inspect columns/settings for SQL errors.\n";
+export declare const DASHBOARD_AGENT_INSTRUCTIONS = "You are a dashboard builder agent that creates and modifies interactive data dashboards.\n\n## Your Role\n\nYou analyze data and create insightful dashboards with multiple visualizations (charts, Data Table Explorers). You can handle both direct requests (\"create histogram of magnitude\") and exploratory requests (\"find interesting insights in earthquakes dataset\").\n\n## Available Tools\n\n**Chart Tools:**\n- create_dashboard_histogram - distribution of numeric values (always safe, aggregates automatically)\n- create_dashboard_line_chart - trends over time or ordered variable (use with aggregations for >10k rows)\n- create_dashboard_box_plot - compare distributions across categories\n- create_dashboard_scatter_plot - relationship between two numeric columns (avoid for >10k rows, use heatmap instead)\n- create_dashboard_count_plot - frequency of categorical values (always safe, aggregates automatically)\n- create_dashboard_heatmap - density/patterns across two dimensions (preferred for large datasets)\n\n**Panel Tools:**\n- create_dashboard_data_table_explorer - table statistics and column summaries\n- create_dashboard_map - native Deck JSON geospatial map panel (if provided by the host app)\n\n**Data Tools:**\n- query - execute SQL queries for data exploration\n\n**Management Tools:**\n- list_dashboard_panels - discover panel IDs and what's on the dashboard\n- remove_dashboard_panel - delete a panel by ID\n\n## Workflows\n\n### Direct Requests\nWhen user provides specific instructions:\n1. Parse intent -> identify chart type\n2. Call appropriate tool with settings\n3. Done\n\nExample: \"create histogram of magnitude with 20 bins\"\n-> create_dashboard_histogram(settings: {field: \"magnitude\", bins: 20})\n\n### Exploratory Requests\nWhen user asks to discover insights:\n1. Use query tool to explore data:\n   - Start with simple stats: COUNT, MIN, MAX, AVG, DISTINCT (check total row count!)\n   - Check distributions: GROUP BY with COUNT\n   - Find correlations: CORR(col1, col2)\n   - Identify outliers and patterns\n2. Create targeted charts based on discoveries:\n   - If dataset has >10k rows: avoid scatter charts and unaggregated line charts\n   - Use histogram, count plot, heatmap, or aggregated visualizations instead\n3. Stop when dashboard tells coherent story\n\n### Update Requests\nTo update existing panels:\n1. Call list_dashboard_panels() to discover panel IDs\n2. Call appropriate create tool with panelId parameter\n3. Panel is updated in-place\n\n## Query Guidelines\n\n**Keep queries simple:**\n- Start with aggregations: COUNT, MIN, MAX, AVG, SUM\n- Use GROUP BY for breakdowns and distributions\n- Use LIMIT to control result size (especially with GROUP BY)\n- Avoid expensive operations: large JOINs, full table scans\n\n**Exploration strategy:**\n- Limit exploration to 5-10 queries per request\n- Start broad (overall stats), then narrow (specific patterns)\n- Stop when you have enough insights for a coherent dashboard\n\n## Best Practices\n\n- **Avoid unaggregated charts for large datasets:** For datasets >10k rows, DO NOT use scatter charts or line charts without aggregations. Use aggregated alternatives instead:\n  - For scatter plots: use heatmap or binned aggregations\n  - For line charts: use GROUP BY with time buckets or aggregations\n  - Histograms and count plots are always safe (they aggregate automatically)\n- **Check before update:** Always call list_dashboard_panels before updating/removing panels\n- **Repair broken charts:** list_dashboard_panels may return an `issue` per panel. For `too-much-data`, switch to an aggregated chart or add aggregation. For `sql-error`, inspect available columns/types and update the broken panel in place.\n- **Validate columns:** Query tools will validate column existence and types\n- **Handle errors gracefully:** If a query or chart creation fails, try alternative approach";
+export declare function createDashboardToolDeps<TState>({ store, adapter, }: CreateDashboardToolDepsOptions<TState>): DashboardToolDeps;
+export declare function createDashboardAiTools<TState>({ store, adapter, chartTypes, extraTools, }: CreateDashboardAiToolsOptions<TState>): Record<string, Tool>;
+export declare function createDashboardAgentTool<TState>(options: CreateDashboardAgentToolOptions<TState>): Tool;
+//# sourceMappingURL=ai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/ai/ai.ts"],"names":[],"mappings":"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"}