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

package/dist/charts/chart-types/box-plot/renderer/useBoxPlotClient.js

@@ -1,8 +1,18 @@
 import { Selection } from '@uwdata/mosaic-core';
 import { useEffect, useMemo, useRef, useState } from 'react';
 import { BoxPlotClient } from './BoxPlotClient';
+/**
+ * Creates and connects the Mosaic client used by the box plot renderer.
+ *
+ * @param args - Hook inputs including chart settings, Mosaic coordinator,
+ *   optional dashboard services, and the resolved source table.
+ * @param args.table - Canonical `QualifiedTableName` for the source table. The
+ *   hook passes this structured identity through to {@link BoxPlotClient}, where
+ *   it is converted to a Mosaic SQL table reference at query-build time.
+ * @returns The active client ref and normalized renderer state.
+ */
 export function useBoxPlotClient(args) {
-    const { config, coordinator, dataPolicy, params, runtimeIssueContext, runtimeIssueReporter, tableName, } = args;
+    const { config, coordinator, dataPolicy, params, runtimeIssueContext, runtimeIssueReporter, table, } = args;
     const [state, setState] = useState({
         isLoading: true,
         outliers: [],
@@ -30,7 +40,7 @@ export function useBoxPlotClient(args) {
             runtimeIssueContext,
             runtimeIssueReporter,
             selection,
-            tableName,
+            table,
             x: config.x,
             y: config.y,
         });
@@ -49,7 +59,7 @@ export function useBoxPlotClient(args) {
         runtimeIssueContext,
         runtimeIssueReporter,
         selection,
-        tableName,
+        table,
     ]);
     const effectiveState = !config || !config.x || !config.y
         ? {

package/dist/charts/chart-types/box-plot/renderer/useBoxPlotClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"useBoxPlotClient.js","sourceRoot":"","sources":["../../../../../src/charts/chart-types/box-plot/renderer/useBoxPlotClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,SAAS,EAAC,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAC,aAAa,EAAoB,MAAM,iBAAiB,CAAC;AASjE,MAAM,UAAU,gBAAgB,CAAC,IAQhC;IACC,MAAM,EACJ,MAAM,EACN,WAAW,EACX,UAAU,EACV,MAAM,EACN,mBAAmB,EACnB,oBAAoB,EACpB,SAAS,GACV,GAAG,IAAI,CAAC;IACT,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe;QAC/C,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,EAAE;KACd,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,CAAuB,IAAI,CAAC,CAAC;IAErD,0CAA0C;IAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE;QAC7B,8FAA8F;QAC9F,MAAM,cAAc,GAAG,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,cAAc,CAAC;QACxB,CAAC;QACD,uFAAuF;QACvF,OAAO,SAAS,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACtC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;YACzB,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC;YAC/B,UAAU;YACV,aAAa,EAAE,QAAQ;YACvB,mBAAmB;YACnB,oBAAoB;YACpB,SAAS;YACT,SAAS;YACT,CAAC,EAAE,MAAM,CAAC,CAAC;YACX,CAAC,EAAE,MAAM,CAAC,CAAC;SACZ,CAAC,CAAC;QACH,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;QAC3B,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE5B,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,SAAS,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;gBACjC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE;QACD,MAAM;QACN,WAAW;QACX,UAAU;QACV,mBAAmB;QACnB,oBAAoB;QACpB,SAAS;QACT,SAAS;KACV,CAAC,CAAC;IAEH,MAAM,cAAc,GAClB,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC,CAAC;YACE,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,EAAE;YACZ,SAAS,EAAE,EAAE;SACd;QACH,CAAC,CAAC,KAAK,CAAC;IAEZ,OAAO,EAAC,SAAS,EAAE,KAAK,EAAE,cAAc,EAAC,CAAC;AAC5C,CAAC","sourcesContent":["import {Coordinator, Selection} from '@uwdata/mosaic-core';\nimport {useEffect, useMemo, useRef, useState} from 'react';\nimport {BoxPlotClient, type BoxPlotState} from './BoxPlotClient';\nimport type {BrushSelectionParams} from '../../base-types';\nimport type {\n  ChartDataPolicy,\n  ChartRuntimeIssueContext,\n  ChartRuntimeIssueReporter,\n} from '../../../../chart-runtime';\nimport {BoxPlotChartSettings} from '../schema';\n\nexport function useBoxPlotClient(args: {\n  config: BoxPlotChartSettings | null;\n  coordinator: Coordinator;\n  dataPolicy?: ChartDataPolicy | null;\n  params?: BrushSelectionParams;\n  runtimeIssueContext?: ChartRuntimeIssueContext;\n  runtimeIssueReporter?: ChartRuntimeIssueReporter;\n  tableName: string;\n}) {\n  const {\n    config,\n    coordinator,\n    dataPolicy,\n    params,\n    runtimeIssueContext,\n    runtimeIssueReporter,\n    tableName,\n  } = args;\n  const [state, setState] = useState<BoxPlotState>({\n    isLoading: true,\n    outliers: [],\n    summaries: [],\n  });\n  const clientRef = useRef<BoxPlotClient | null>(null);\n\n  // Get or create the crossfilter selection\n  const selection = useMemo(() => {\n    // First try to get the brush selection from params (which should be connected to crossfilter)\n    const brushSelection = params?.get('brush');\n    if (brushSelection) {\n      return brushSelection;\n    }\n    // Fallback: create a new crossfilter selection (shouldn't happen in dashboard context)\n    return Selection.crossfilter();\n  }, [params]);\n\n  useEffect(() => {\n    if (!config || !config.x || !config.y) {\n      clientRef.current = null;\n      return;\n    }\n\n    const client = new BoxPlotClient({\n      dataPolicy,\n      onStateChange: setState,\n      runtimeIssueContext,\n      runtimeIssueReporter,\n      selection,\n      tableName,\n      x: config.x,\n      y: config.y,\n    });\n    clientRef.current = client;\n    coordinator.connect(client);\n\n    return () => {\n      client.destroy();\n      if (clientRef.current === client) {\n        clientRef.current = null;\n      }\n    };\n  }, [\n    config,\n    coordinator,\n    dataPolicy,\n    runtimeIssueContext,\n    runtimeIssueReporter,\n    selection,\n    tableName,\n  ]);\n\n  const effectiveState =\n    !config || !config.x || !config.y\n      ? {\n          isLoading: false,\n          outliers: [],\n          summaries: [],\n        }\n      : state;\n\n  return {clientRef, state: effectiveState};\n}\n"]}
+{"version":3,"file":"useBoxPlotClient.js","sourceRoot":"","sources":["../../../../../src/charts/chart-types/box-plot/renderer/useBoxPlotClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,SAAS,EAAC,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAC,aAAa,EAAoB,MAAM,iBAAiB,CAAC;AAUjE;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAQhC;IACC,MAAM,EACJ,MAAM,EACN,WAAW,EACX,UAAU,EACV,MAAM,EACN,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,GACN,GAAG,IAAI,CAAC;IACT,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe;QAC/C,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,EAAE;KACd,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,CAAuB,IAAI,CAAC,CAAC;IAErD,0CAA0C;IAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE;QAC7B,8FAA8F;QAC9F,MAAM,cAAc,GAAG,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,cAAc,CAAC;QACxB,CAAC;QACD,uFAAuF;QACvF,OAAO,SAAS,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACtC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;YACzB,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC;YAC/B,UAAU;YACV,aAAa,EAAE,QAAQ;YACvB,mBAAmB;YACnB,oBAAoB;YACpB,SAAS;YACT,KAAK;YACL,CAAC,EAAE,MAAM,CAAC,CAAC;YACX,CAAC,EAAE,MAAM,CAAC,CAAC;SACZ,CAAC,CAAC;QACH,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;QAC3B,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE5B,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,SAAS,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;gBACjC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE;QACD,MAAM;QACN,WAAW;QACX,UAAU;QACV,mBAAmB;QACnB,oBAAoB;QACpB,SAAS;QACT,KAAK;KACN,CAAC,CAAC;IAEH,MAAM,cAAc,GAClB,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC,CAAC;YACE,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,EAAE;YACZ,SAAS,EAAE,EAAE;SACd;QACH,CAAC,CAAC,KAAK,CAAC;IAEZ,OAAO,EAAC,SAAS,EAAE,KAAK,EAAE,cAAc,EAAC,CAAC;AAC5C,CAAC","sourcesContent":["import {Coordinator, Selection} from '@uwdata/mosaic-core';\nimport {useEffect, useMemo, useRef, useState} from 'react';\nimport {BoxPlotClient, type BoxPlotState} from './BoxPlotClient';\nimport type {BrushSelectionParams} from '../../base-types';\nimport type {QualifiedTableName} from '@sqlrooms/duckdb';\nimport type {\n  ChartDataPolicy,\n  ChartRuntimeIssueContext,\n  ChartRuntimeIssueReporter,\n} from '../../../../chart-runtime';\nimport {BoxPlotChartSettings} from '../schema';\n\n/**\n * Creates and connects the Mosaic client used by the box plot renderer.\n *\n * @param args - Hook inputs including chart settings, Mosaic coordinator,\n *   optional dashboard services, and the resolved source table.\n * @param args.table - Canonical `QualifiedTableName` for the source table. The\n *   hook passes this structured identity through to {@link BoxPlotClient}, where\n *   it is converted to a Mosaic SQL table reference at query-build time.\n * @returns The active client ref and normalized renderer state.\n */\nexport function useBoxPlotClient(args: {\n  config: BoxPlotChartSettings | null;\n  coordinator: Coordinator;\n  dataPolicy?: ChartDataPolicy | null;\n  params?: BrushSelectionParams;\n  runtimeIssueContext?: ChartRuntimeIssueContext;\n  runtimeIssueReporter?: ChartRuntimeIssueReporter;\n  table: QualifiedTableName;\n}) {\n  const {\n    config,\n    coordinator,\n    dataPolicy,\n    params,\n    runtimeIssueContext,\n    runtimeIssueReporter,\n    table,\n  } = args;\n  const [state, setState] = useState<BoxPlotState>({\n    isLoading: true,\n    outliers: [],\n    summaries: [],\n  });\n  const clientRef = useRef<BoxPlotClient | null>(null);\n\n  // Get or create the crossfilter selection\n  const selection = useMemo(() => {\n    // First try to get the brush selection from params (which should be connected to crossfilter)\n    const brushSelection = params?.get('brush');\n    if (brushSelection) {\n      return brushSelection;\n    }\n    // Fallback: create a new crossfilter selection (shouldn't happen in dashboard context)\n    return Selection.crossfilter();\n  }, [params]);\n\n  useEffect(() => {\n    if (!config || !config.x || !config.y) {\n      clientRef.current = null;\n      return;\n    }\n\n    const client = new BoxPlotClient({\n      dataPolicy,\n      onStateChange: setState,\n      runtimeIssueContext,\n      runtimeIssueReporter,\n      selection,\n      table,\n      x: config.x,\n      y: config.y,\n    });\n    clientRef.current = client;\n    coordinator.connect(client);\n\n    return () => {\n      client.destroy();\n      if (clientRef.current === client) {\n        clientRef.current = null;\n      }\n    };\n  }, [\n    config,\n    coordinator,\n    dataPolicy,\n    runtimeIssueContext,\n    runtimeIssueReporter,\n    selection,\n    table,\n  ]);\n\n  const effectiveState =\n    !config || !config.x || !config.y\n      ? {\n          isLoading: false,\n          outliers: [],\n          summaries: [],\n        }\n      : state;\n\n  return {clientRef, state: effectiveState};\n}\n"]}

package/dist/charts/chart-types/box-plot/tool.d.ts

@@ -1,9 +1,8 @@
 import { z } from 'zod';
-import { type DashboardToolDeps } from '../base-types';
-export declare const BoxPlotToolParameters: z.ZodObject<{
-    artifactId: z.ZodOptional<z.ZodString>;
-    tableName: z.ZodOptional<z.ZodString>;
-    createArtifactIfMissing: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+import { ChartToolParams, ChartToolOutput } from '../tool-types';
+export declare const BoxPlotToolInput: z.ZodObject<{
+    tableName: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
     panelId: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodString;
     settings: z.ZodObject<{
@@ -11,30 +10,27 @@ export declare const BoxPlotToolParameters: z.ZodObject<{
         y: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
-export type BoxPlotToolParams = z.infer<typeof BoxPlotToolParameters>;
-export declare function createBoxPlotAiTool(deps: DashboardToolDeps): import("ai").Tool<{
-    createArtifactIfMissing: boolean;
+export type BoxPlotToolInput = z.infer<typeof BoxPlotToolInput>;
+export declare function createBoxPlotAiTool({ databaseAdapter, addChart, }: ChartToolParams): import("ai").Tool<{
+    tableName: string;
     reasoning: string;
     settings: {
         x: string;
         y: string;
     };
-    artifactId?: string | undefined;
-    tableName?: string | undefined;
+    title?: string | undefined;
     panelId?: string | undefined;
-}, {
-    llmResult: {
-        success: boolean;
-        details: string;
-        data: import("..").PanelResult;
-        errorMessage?: undefined;
-    };
-} | {
-    llmResult: {
-        success: boolean;
-        errorMessage: string;
-        details?: undefined;
-        data?: undefined;
+}, ChartToolOutput<{
+    chartType: "box-plot";
+    settings: {
+        x?: string | undefined;
+        y?: string | undefined;
     };
-}>;
+    settingsOpen?: boolean | undefined;
+    dataPolicy?: {
+        disabled?: boolean | undefined;
+        maxRows?: number | undefined;
+        reason?: string | undefined;
+    } | undefined;
+}>>;
 //# sourceMappingURL=tool.d.ts.map

package/dist/charts/chart-types/box-plot/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/box-plot/tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,OAAO,EAAC,KAAK,iBAAiB,EAAC,MAAM,eAAe,CAAC;AAQrD,eAAO,MAAM,qBAAqB;;;;;;;;;;iBAEhC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEtE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;GA4E1D"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/box-plot/tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAOtB,OAAO,EAAC,eAAe,EAAE,eAAe,EAAC,MAAM,eAAe,CAAC;AAI/D,eAAO,MAAM,gBAAgB;;;;;;;;;iBAE3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,wBAAgB,mBAAmB,CAAC,EAClC,eAAe,EACf,QAAQ,GACT,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;IAmDjB"}

package/dist/charts/chart-types/box-plot/tool.js

@@ -1,13 +1,13 @@
 import { tool } from 'ai';
 import { BoxPlotChartSettings } from './schema';
-import { BaseChartToolParameters } from '../../../ai/tool-schemas';
-import { validateColumnExists } from '../../../ai/tool-validation';
+import { BaseChartToolInput } from '../../../ai/tool-schemas';
 import { NUMERIC_COLUMN_TYPES, CATEGORICAL_COLUMN_TYPES, } from '../../../column-types-utils';
-import { createOrUpdateChartPanel } from '../../../ai/tool-helpers';
-export const BoxPlotToolParameters = BaseChartToolParameters.extend({
+import { validateBoxPlotSettings } from './validation';
+import { ensureTable } from '../../../ai/tool-helpers';
+export const BoxPlotToolInput = BaseChartToolInput.extend({
     settings: BoxPlotChartSettings.required(),
 });
-export function createBoxPlotAiTool(deps) {
+export function createBoxPlotAiTool({ databaseAdapter, addChart, }) {
     return tool({
         description: `Box plot: compares distributions of numeric values across categories. Shows median, quartiles (25th, 75th percentiles), and outliers per group.
 
@@ -20,45 +20,37 @@ Required:
 
 NOTE: Box plots aggregate data by computing quartiles and outliers per group, so they handle large datasets efficiently (no data point limit).
 
-To UPDATE an existing box plot: provide the panelId parameter. Otherwise creates new panel.
-
 Best for: comparing distributions between groups, finding outliers per category, seeing spread and variance differences.
 
 Do NOT use for: single distribution (use histogram), time trends (use line-chart), simple counts (use count-plot).`,
-        inputSchema: BoxPlotToolParameters,
-        execute: async (params, context) => {
+        inputSchema: BoxPlotToolInput,
+        execute: async ({ tableName, title, settings, panelId }) => {
             try {
-                const artifactId = deps.resolveArtifact(params.artifactId, params.createArtifactIfMissing, context);
-                const { tableName, columns } = deps.resolveTable(artifactId, params.tableName);
-                // Validate settings
-                validateColumnExists(params.settings.x, CATEGORICAL_COLUMN_TYPES, columns, 'x');
-                validateColumnExists(params.settings.y, NUMERIC_COLUMN_TYPES, columns, 'y');
-                const result = createOrUpdateChartPanel(deps, {
-                    panelId: params.panelId,
-                    dashboardId: artifactId,
+                const dataTable = ensureTable(databaseAdapter, tableName);
+                validateBoxPlotSettings({
+                    dataTable,
+                    settings,
+                });
+                const config = {
+                    chartType: 'box-plot',
+                    settings,
+                };
+                await addChart({
                     tableName,
-                    title: `Box plot - ${params.settings.y} by ${params.settings.x}`,
-                    config: {
-                        chartType: 'box-plot',
-                        settings: params.settings,
-                    },
+                    panelId,
+                    title,
+                    config,
                 });
                 return {
-                    llmResult: {
-                        success: true,
-                        details: params.panelId
-                            ? `Updated box plot "${result.title}".`
-                            : `Created box plot "${result.title}".`,
-                        data: result,
-                    },
+                    success: true,
+                    details: `Generated box plot configuration.`,
+                    data: config,
                 };
             }
             catch (error) {
                 return {
-                    llmResult: {
-                        success: false,
-                        errorMessage: error instanceof Error ? error.message : String(error),
-                    },
+                    success: false,
+                    errorMessage: error instanceof Error ? error.message : String(error),
                 };
             }
         },

package/dist/charts/chart-types/box-plot/tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/box-plot/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AAExB,OAAO,EAAC,oBAAoB,EAAC,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAC,uBAAuB,EAAC,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AACjE,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAC,wBAAwB,EAAC,MAAM,0BAA0B,CAAC;AAElE,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAClE,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAIH,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,OAAO,IAAI,CAAC;QACV,WAAW,EAAE;;;;;;oCAMmB,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;gBACvD,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;mHAQoE;QAC/G,WAAW,EAAE,qBAAqB;QAClC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YACjC,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CACrC,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,uBAAuB,EAC9B,OAAO,CACR,CAAC;gBACF,MAAM,EAAC,SAAS,EAAE,OAAO,EAAC,GAAG,IAAI,CAAC,YAAY,CAC5C,UAAU,EACV,MAAM,CAAC,SAAS,CACjB,CAAC;gBAEF,oBAAoB;gBACpB,oBAAoB,CAClB,MAAM,CAAC,QAAQ,CAAC,CAAC,EACjB,wBAAwB,EACxB,OAAO,EACP,GAAG,CACJ,CAAC;gBACF,oBAAoB,CAClB,MAAM,CAAC,QAAQ,CAAC,CAAC,EACjB,oBAAoB,EACpB,OAAO,EACP,GAAG,CACJ,CAAC;gBAEF,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,EAAE;oBAC5C,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,WAAW,EAAE,UAAU;oBACvB,SAAS;oBACT,KAAK,EAAE,cAAc,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE;oBAChE,MAAM,EAAE;wBACN,SAAS,EAAE,UAAU;wBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;qBAC1B;iBACF,CAAC,CAAC;gBAEH,OAAO;oBACL,SAAS,EAAE;wBACT,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,MAAM,CAAC,OAAO;4BACrB,CAAC,CAAC,qBAAqB,MAAM,CAAC,KAAK,IAAI;4BACvC,CAAC,CAAC,qBAAqB,MAAM,CAAC,KAAK,IAAI;wBACzC,IAAI,EAAE,MAAM;qBACb;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,SAAS,EAAE;wBACT,OAAO,EAAE,KAAK;wBACd,YAAY,EACV,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBACzD;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {tool} from 'ai';\nimport {z} from 'zod';\nimport {BoxPlotChartSettings} from './schema';\nimport {BaseChartToolParameters} from '../../../ai/tool-schemas';\nimport {type DashboardToolDeps} from '../base-types';\nimport {validateColumnExists} from '../../../ai/tool-validation';\nimport {\n  NUMERIC_COLUMN_TYPES,\n  CATEGORICAL_COLUMN_TYPES,\n} from '../../../column-types-utils';\nimport {createOrUpdateChartPanel} from '../../../ai/tool-helpers';\n\nexport const BoxPlotToolParameters = BaseChartToolParameters.extend({\n  settings: BoxPlotChartSettings.required(),\n});\n\nexport type BoxPlotToolParams = z.infer<typeof BoxPlotToolParameters>;\n\nexport function createBoxPlotAiTool(deps: DashboardToolDeps) {\n  return tool({\n    description: `Box plot: compares distributions of numeric values across categories. Shows median, quartiles (25th, 75th percentiles), and outliers per group.\n\nUse when: user asks to \"compare [numeric] across/by [category]\", \"distribution by group\", \"show outliers by\", \"compare ranges\".\nExample queries: \"compare population by administrative region\", \"show elevation distribution by terrain type\", \"parcel area range by zone\", \"compare building heights across districts\", \"temperature by climate zone\".\n\nRequired:\n- x: categorical/grouping column (${CATEGORICAL_COLUMN_TYPES.join(', ')}) - e.g., region, terrain type, zone classification\n- y: numeric (${NUMERIC_COLUMN_TYPES.join(', ')})\n\nNOTE: Box plots aggregate data by computing quartiles and outliers per group, so they handle large datasets efficiently (no data point limit).\n\nTo UPDATE an existing box plot: provide the panelId parameter. Otherwise creates new panel.\n\nBest for: comparing distributions between groups, finding outliers per category, seeing spread and variance differences.\n\nDo NOT use for: single distribution (use histogram), time trends (use line-chart), simple counts (use count-plot).`,\n    inputSchema: BoxPlotToolParameters,\n    execute: async (params, context) => {\n      try {\n        const artifactId = deps.resolveArtifact(\n          params.artifactId,\n          params.createArtifactIfMissing,\n          context,\n        );\n        const {tableName, columns} = deps.resolveTable(\n          artifactId,\n          params.tableName,\n        );\n\n        // Validate settings\n        validateColumnExists(\n          params.settings.x,\n          CATEGORICAL_COLUMN_TYPES,\n          columns,\n          'x',\n        );\n        validateColumnExists(\n          params.settings.y,\n          NUMERIC_COLUMN_TYPES,\n          columns,\n          'y',\n        );\n\n        const result = createOrUpdateChartPanel(deps, {\n          panelId: params.panelId,\n          dashboardId: artifactId,\n          tableName,\n          title: `Box plot - ${params.settings.y} by ${params.settings.x}`,\n          config: {\n            chartType: 'box-plot',\n            settings: params.settings,\n          },\n        });\n\n        return {\n          llmResult: {\n            success: true,\n            details: params.panelId\n              ? `Updated box plot \"${result.title}\".`\n              : `Created box plot \"${result.title}\".`,\n            data: result,\n          },\n        };\n      } catch (error) {\n        return {\n          llmResult: {\n            success: false,\n            errorMessage:\n              error instanceof Error ? error.message : String(error),\n          },\n        };\n      }\n    },\n  });\n}\n"]}
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/box-plot/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AAExB,OAAO,EAAqB,oBAAoB,EAAC,MAAM,UAAU,CAAC;AAClE,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAC,uBAAuB,EAAC,MAAM,cAAc,CAAC;AACrD,OAAO,EAAC,WAAW,EAAC,MAAM,0BAA0B,CAAC;AAErD,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,MAAM,CAAC;IACxD,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAIH,MAAM,UAAU,mBAAmB,CAAC,EAClC,eAAe,EACf,QAAQ,GACQ;IAChB,OAAO,IAAI,CAAwD;QACjE,WAAW,EAAE;;;;;;oCAMmB,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;gBACvD,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;mHAMoE;QAC/G,WAAW,EAAE,gBAAgB;QAC7B,OAAO,EAAE,KAAK,EAAE,EAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAC,EAAE,EAAE;YACvD,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,WAAW,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;gBAE1D,uBAAuB,CAAC;oBACtB,SAAS;oBACT,QAAQ;iBACT,CAAC,CAAC;gBAEH,MAAM,MAAM,GAAuB;oBACjC,SAAS,EAAE,UAAmB;oBAC9B,QAAQ;iBACT,CAAC;gBAEF,MAAM,QAAQ,CAAC;oBACb,SAAS;oBACT,OAAO;oBACP,KAAK;oBACL,MAAM;iBACP,CAAC,CAAC;gBAEH,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,mCAAmC;oBAC5C,IAAI,EAAE,MAAM;iBACb,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 {BoxPlotChartConfig, BoxPlotChartSettings} from './schema';\nimport {BaseChartToolInput} from '../../../ai/tool-schemas';\nimport {\n  NUMERIC_COLUMN_TYPES,\n  CATEGORICAL_COLUMN_TYPES,\n} from '../../../column-types-utils';\nimport {ChartToolParams, ChartToolOutput} from '../tool-types';\nimport {validateBoxPlotSettings} from './validation';\nimport {ensureTable} from '../../../ai/tool-helpers';\n\nexport const BoxPlotToolInput = BaseChartToolInput.extend({\n  settings: BoxPlotChartSettings.required(),\n});\n\nexport type BoxPlotToolInput = z.infer<typeof BoxPlotToolInput>;\n\nexport function createBoxPlotAiTool({\n  databaseAdapter,\n  addChart,\n}: ChartToolParams) {\n  return tool<BoxPlotToolInput, ChartToolOutput<BoxPlotChartConfig>>({\n    description: `Box plot: compares distributions of numeric values across categories. Shows median, quartiles (25th, 75th percentiles), and outliers per group.\n\nUse when: user asks to \"compare [numeric] across/by [category]\", \"distribution by group\", \"show outliers by\", \"compare ranges\".\nExample queries: \"compare population by administrative region\", \"show elevation distribution by terrain type\", \"parcel area range by zone\", \"compare building heights across districts\", \"temperature by climate zone\".\n\nRequired:\n- x: categorical/grouping column (${CATEGORICAL_COLUMN_TYPES.join(', ')}) - e.g., region, terrain type, zone classification\n- y: numeric (${NUMERIC_COLUMN_TYPES.join(', ')})\n\nNOTE: Box plots aggregate data by computing quartiles and outliers per group, so they handle large datasets efficiently (no data point limit).\n\nBest for: comparing distributions between groups, finding outliers per category, seeing spread and variance differences.\n\nDo NOT use for: single distribution (use histogram), time trends (use line-chart), simple counts (use count-plot).`,\n    inputSchema: BoxPlotToolInput,\n    execute: async ({tableName, title, settings, panelId}) => {\n      try {\n        const dataTable = ensureTable(databaseAdapter, tableName);\n\n        validateBoxPlotSettings({\n          dataTable,\n          settings,\n        });\n\n        const config: BoxPlotChartConfig = {\n          chartType: 'box-plot' as const,\n          settings,\n        };\n\n        await addChart({\n          tableName,\n          panelId,\n          title,\n          config,\n        });\n\n        return {\n          success: true,\n          details: `Generated box plot configuration.`,\n          data: config,\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/charts/chart-types/box-plot/validation.d.ts

@@ -0,0 +1,9 @@
+import { BoxPlotChartSettings } from './schema';
+import { ValidateSpecOptions } from '../base-types';
+import { TableColumn } from '@sqlrooms/duckdb';
+export type ValidatedBoxPlotSettings = {
+    xColumn: TableColumn;
+    yColumn: TableColumn;
+};
+export declare function validateBoxPlotSettings({ dataTable, settings: { x, y }, }: ValidateSpecOptions<BoxPlotChartSettings>): ValidatedBoxPlotSettings;
+//# sourceMappingURL=validation.d.ts.map

package/dist/charts/chart-types/box-plot/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/box-plot/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAC,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAC,mBAAmB,EAAC,MAAM,eAAe,CAAC;AAOlD,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAE7C,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,EACtC,SAAS,EACT,QAAQ,EAAE,EAAC,CAAC,EAAE,CAAC,EAAC,GACjB,EAAE,mBAAmB,CAAC,oBAAoB,CAAC,GAAG,wBAAwB,CAiCtE"}

package/dist/charts/chart-types/box-plot/validation.js

@@ -0,0 +1,32 @@
+import { InvalidColumnTypeError, MissingColumnsError, RequiredFieldsError, } from '../errors';
+import { isCategoricalType, isNumericType } from '../../../column-types-utils';
+export function validateBoxPlotSettings({ dataTable, settings: { x, y }, }) {
+    // Basic validation for required fields
+    if (!x || !y) {
+        throw new RequiredFieldsError([
+            ...(x ? [] : ['X field (categorical)']),
+            ...(y ? [] : ['Y field (numeric)']),
+        ]);
+    }
+    // Validate X and Y field existence
+    const xColumn = dataTable.columns.find((col) => col.name === x);
+    const yColumn = dataTable.columns.find((col) => col.name === y);
+    if (!xColumn || !yColumn) {
+        throw new MissingColumnsError([
+            ...(xColumn ? [] : [x]),
+            ...(yColumn ? [] : [y]),
+        ]);
+    }
+    // Validate X is categorical and Y is numeric
+    if (!isCategoricalType(xColumn.type)) {
+        throw new InvalidColumnTypeError(xColumn.name, 'categorical');
+    }
+    if (!isNumericType(yColumn.type)) {
+        throw new InvalidColumnTypeError(yColumn.name, 'numeric');
+    }
+    return {
+        xColumn,
+        yColumn,
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/charts/chart-types/box-plot/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/box-plot/validation.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAC,iBAAiB,EAAE,aAAa,EAAC,MAAM,6BAA6B,CAAC;AAQ7E,MAAM,UAAU,uBAAuB,CAAC,EACtC,SAAS,EACT,QAAQ,EAAE,EAAC,CAAC,EAAE,CAAC,EAAC,GAC0B;IAC1C,uCAAuC;IACvC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACb,MAAM,IAAI,mBAAmB,CAAC;YAC5B,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC;YACvC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;SACpC,CAAC,CAAC;IACL,CAAC;IAED,mCAAmC;IACnC,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IAEhE,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,IAAI,mBAAmB,CAAC;YAC5B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACxB,CAAC,CAAC;IACL,CAAC;IAED,6CAA6C;IAC7C,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,sBAAsB,CAAC,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,sBAAsB,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO;QACL,OAAO;QACP,OAAO;KACR,CAAC;AACJ,CAAC","sourcesContent":["import {BoxPlotChartSettings} from './schema';\nimport {ValidateSpecOptions} from '../base-types';\nimport {\n  InvalidColumnTypeError,\n  MissingColumnsError,\n  RequiredFieldsError,\n} from '../errors';\nimport {isCategoricalType, isNumericType} from '../../../column-types-utils';\nimport {TableColumn} from '@sqlrooms/duckdb';\n\nexport type ValidatedBoxPlotSettings = {\n  xColumn: TableColumn;\n  yColumn: TableColumn;\n};\n\nexport function validateBoxPlotSettings({\n  dataTable,\n  settings: {x, y},\n}: ValidateSpecOptions<BoxPlotChartSettings>): ValidatedBoxPlotSettings {\n  // Basic validation for required fields\n  if (!x || !y) {\n    throw new RequiredFieldsError([\n      ...(x ? [] : ['X field (categorical)']),\n      ...(y ? [] : ['Y field (numeric)']),\n    ]);\n  }\n\n  // Validate X and Y field existence\n  const xColumn = dataTable.columns.find((col) => col.name === x);\n  const yColumn = dataTable.columns.find((col) => col.name === y);\n\n  if (!xColumn || !yColumn) {\n    throw new MissingColumnsError([\n      ...(xColumn ? [] : [x]),\n      ...(yColumn ? [] : [y]),\n    ]);\n  }\n\n  // Validate X is categorical and Y is numeric\n  if (!isCategoricalType(xColumn.type)) {\n    throw new InvalidColumnTypeError(xColumn.name, 'categorical');\n  }\n\n  if (!isNumericType(yColumn.type)) {\n    throw new InvalidColumnTypeError(yColumn.name, 'numeric');\n  }\n\n  return {\n    xColumn,\n    yColumn,\n  };\n}\n"]}

package/dist/charts/chart-types/column-types.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Column info passed to chart builder UI
+ */
+export interface ChartBuilderColumn {
+    name: string;
+    type: string;
+}
+//# sourceMappingURL=column-types.d.ts.map

package/dist/charts/chart-types/column-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-types.d.ts","sourceRoot":"","sources":["../../../src/charts/chart-types/column-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/charts/chart-types/column-types.js

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

package/dist/charts/chart-types/column-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-types.js","sourceRoot":"","sources":["../../../src/charts/chart-types/column-types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Column info passed to chart builder UI\n */\nexport interface ChartBuilderColumn {\n  name: string;\n  type: string;\n}\n"]}

package/dist/charts/chart-types/count-plot/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAC,oBAAoB,EAAyB,MAAM,UAAU,CAAC;AAStE,eAAO,MAAM,kBAAkB,EAAE,uBAAuB,CAAC,oBAAoB,CAW1E,CAAC"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAC,oBAAoB,EAAyB,MAAM,UAAU,CAAC;AAStE,eAAO,MAAM,kBAAkB,EAAE,uBAAuB,CAAC,oBAAoB,CAY1E,CAAC"}

package/dist/charts/chart-types/count-plot/definition.js

@@ -9,6 +9,7 @@ export const countPlotChartType = {
     id: 'count-plot',
     label: 'Count Plot',
     description: DESCRIPTION,
+    aiDescription: `${DESCRIPTION} - frequency of categorical values (always safe, aggregates automatically)`,
     icon: BarChartHorizontal,
     schema: CountPlotChartSettings,
     settingsComponent: CountPlotSettingsComponent,

package/dist/charts/chart-types/count-plot/definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,sBAAsB,EAAC,MAAM,UAAU,CAAC;AACtE,OAAO,EAAC,oBAAoB,EAAC,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAC,0BAA0B,EAAC,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAC,qBAAqB,EAAC,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAC,kBAAkB,EAAC,MAAM,cAAc,CAAC;AAChD,OAAO,EAAC,mBAAmB,EAAC,MAAM,QAAQ,CAAC;AAE3C,MAAM,WAAW,GAAG,gCAAgC,CAAC;AAErD,MAAM,CAAC,MAAM,kBAAkB,GAC7B;IACE,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,YAAY;IACnB,WAAW,EAAE,WAAW;IACxB,IAAI,EAAE,kBAAkB;IACxB,MAAM,EAAE,sBAAsB;IAC9B,iBAAiB,EAAE,0BAA0B;IAC7C,UAAU,EAAE,oBAAoB,CAAC,WAAW,CAAC;IAC7C,UAAU,EAAE,qBAAqB;IACjC,UAAU,EAAE,mBAAmB;CAChC,CAAC","sourcesContent":["import type {SpecChartTypeDefinition} from '../base-types';\nimport {CountPlotChartConfig, CountPlotChartSettings} from './schema';\nimport {titleFromDescription} from '../../../chart-builders/chartTypeUtils';\nimport {CountPlotSettingsComponent} from './CountPlotSettings';\nimport {createCountPlotAiTool} from './tool';\nimport {BarChartHorizontal} from 'lucide-react';\nimport {createCountPlotSpec} from './spec';\n\nconst DESCRIPTION = 'Create a count plot of a field';\n\nexport const countPlotChartType: SpecChartTypeDefinition<CountPlotChartConfig> =\n  {\n    id: 'count-plot',\n    label: 'Count Plot',\n    description: DESCRIPTION,\n    icon: BarChartHorizontal,\n    schema: CountPlotChartSettings,\n    settingsComponent: CountPlotSettingsComponent,\n    buildTitle: titleFromDescription(DESCRIPTION),\n    createTool: createCountPlotAiTool,\n    createSpec: createCountPlotSpec,\n  };\n"]}
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,sBAAsB,EAAC,MAAM,UAAU,CAAC;AACtE,OAAO,EAAC,oBAAoB,EAAC,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAC,0BAA0B,EAAC,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAC,qBAAqB,EAAC,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAC,kBAAkB,EAAC,MAAM,cAAc,CAAC;AAChD,OAAO,EAAC,mBAAmB,EAAC,MAAM,QAAQ,CAAC;AAE3C,MAAM,WAAW,GAAG,gCAAgC,CAAC;AAErD,MAAM,CAAC,MAAM,kBAAkB,GAC7B;IACE,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,YAAY;IACnB,WAAW,EAAE,WAAW;IACxB,aAAa,EAAE,GAAG,WAAW,4EAA4E;IACzG,IAAI,EAAE,kBAAkB;IACxB,MAAM,EAAE,sBAAsB;IAC9B,iBAAiB,EAAE,0BAA0B;IAC7C,UAAU,EAAE,oBAAoB,CAAC,WAAW,CAAC;IAC7C,UAAU,EAAE,qBAAqB;IACjC,UAAU,EAAE,mBAAmB;CAChC,CAAC","sourcesContent":["import type {SpecChartTypeDefinition} from '../base-types';\nimport {CountPlotChartConfig, CountPlotChartSettings} from './schema';\nimport {titleFromDescription} from '../../../chart-builders/chartTypeUtils';\nimport {CountPlotSettingsComponent} from './CountPlotSettings';\nimport {createCountPlotAiTool} from './tool';\nimport {BarChartHorizontal} from 'lucide-react';\nimport {createCountPlotSpec} from './spec';\n\nconst DESCRIPTION = 'Create a count plot of a field';\n\nexport const countPlotChartType: SpecChartTypeDefinition<CountPlotChartConfig> =\n  {\n    id: 'count-plot',\n    label: 'Count Plot',\n    description: DESCRIPTION,\n    aiDescription: `${DESCRIPTION} - frequency of categorical values (always safe, aggregates automatically)`,\n    icon: BarChartHorizontal,\n    schema: CountPlotChartSettings,\n    settingsComponent: CountPlotSettingsComponent,\n    buildTitle: titleFromDescription(DESCRIPTION),\n    createTool: createCountPlotAiTool,\n    createSpec: createCountPlotSpec,\n  };\n"]}

package/dist/charts/chart-types/count-plot/spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAC,sBAAsB,EAAC,MAAM,UAAU,CAAC;AAMhD,OAAO,EAAC,iBAAiB,EAAyB,MAAM,eAAe,CAAC;AAMxE,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,CAAC,sBAAsB,CAAC,GACjD,IAAI,CA4DN"}
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAC,sBAAsB,EAAC,MAAM,UAAU,CAAC;AAChD,OAAO,EAAC,iBAAiB,EAAyB,MAAM,eAAe,CAAC;AAMxE,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,CAAC,sBAAsB,CAAC,GACjD,IAAI,CA4DN"}

package/dist/charts/chart-types/count-plot/spec.js

@@ -1,6 +1,5 @@
-import { InvalidColumnTypeError, MissingColumnsError, RequiredFieldsError, } from '../errors';
 import { getChartTableReference } from '../base-types';
-import { isCategoricalType } from '../../../column-types-utils';
+import { validateCountPlotSettings } from './validation';
 const BG_COLOR = 'var(--color-chart-overlay)';
 const FG_COLOR = 'var(--color-chart-1)';
 export function createCountPlotSpec(options) {
@@ -60,21 +59,4 @@ export function createCountPlotSpec(options) {
         params: { brush: { select: 'crossfilter' } },
     };
 }
-function validateCountPlotSettings({ dataTable, settings: { field }, }) {
-    // Basic validation for required fields
-    if (!field) {
-        throw new RequiredFieldsError('Field');
-    }
-    // Validate field existence and type
-    const fieldColumn = dataTable.columns.find((col) => col.name === field);
-    if (!fieldColumn) {
-        throw new MissingColumnsError(field);
-    }
-    if (!isCategoricalType(fieldColumn.type)) {
-        throw new InvalidColumnTypeError(fieldColumn.name, 'categorical');
-    }
-    return {
-        fieldColumn,
-    };
-}
 //# sourceMappingURL=spec.js.map

package/dist/charts/chart-types/count-plot/spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/spec.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAoB,sBAAsB,EAAC,MAAM,eAAe,CAAC;AACxE,OAAO,EAAC,iBAAiB,EAAC,MAAM,6BAA6B,CAAC;AAE9D,MAAM,QAAQ,GAAG,4BAA4B,CAAC;AAC9C,MAAM,QAAQ,GAAG,sBAAsB,CAAC;AAExC,MAAM,UAAU,mBAAmB,CACjC,OAAkD;IAElD,MAAM,EAAC,SAAS,EAAE,aAAa,EAAC,GAAG,OAAO,CAAC;IAE3C,MAAM,EAAC,WAAW,EAAC,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,cAAc,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAEzD,4DAA4D;IAC5D,yCAAyC;IACzC,MAAM,IAAI,GAAc;QACtB;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,EAAC,IAAI,EAAE,cAAc,EAAC;YAC5B,CAAC,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;YAChB,CAAC,EAAE;gBACD,MAAM,EAAE,WAAW,CAAC,IAAI;gBACxB,IAAI,EAAE,EAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAC;aAC5C;YACD,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;SACX;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,EAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAC;YAChD,CAAC,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;YAChB,CAAC,EAAE;gBACD,MAAM,EAAE,WAAW,CAAC,IAAI;gBACxB,IAAI,EAAE,EAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAC;aAC5C;YACD,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;SACX;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,EAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAC;YAChD,CAAC,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;YAChB,CAAC,EAAE;gBACD,MAAM,EAAE,WAAW,CAAC,IAAI;gBACxB,IAAI,EAAE,EAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAC;aAC5C;YACD,IAAI,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;YACnB,EAAE,EAAE,CAAC;YACL,UAAU,EAAE,OAAO;YACnB,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,EAAE;SACb;KACF,CAAC;IAEF,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,EAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAC,CAAC,CAAC;IACjD,CAAC;IAED,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,OAAO;QACf,MAAM,EAAE,WAAW,CAAC,IAAI;QACxB,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,GAAG;QACV,OAAO,EAAE,EAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAC;QACnD,MAAM,EAAE,EAAC,KAAK,EAAE,EAAC,MAAM,EAAE,aAAa,EAAC,EAAC;KACjC,CAAC;AACZ,CAAC;AAED,SAAS,yBAAyB,CAAC,EACjC,SAAS,EACT,QAAQ,EAAE,EAAC,KAAK,EAAC,GACyB;IAC1C,uCAAuC;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,oCAAoC;IACpC,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;IAExE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,sBAAsB,CAAC,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACpE,CAAC;IAED,OAAO;QACL,WAAW;KACZ,CAAC;AACJ,CAAC","sourcesContent":["import type {Spec} from '@uwdata/mosaic-spec';\nimport {CountPlotChartSettings} from './schema';\nimport {\n  InvalidColumnTypeError,\n  MissingColumnsError,\n  RequiredFieldsError,\n} from '../errors';\nimport {CreateSpecOptions, getChartTableReference} from '../base-types';\nimport {isCategoricalType} from '../../../column-types-utils';\n\nconst BG_COLOR = 'var(--color-chart-overlay)';\nconst FG_COLOR = 'var(--color-chart-1)';\n\nexport function createCountPlotSpec(\n  options: CreateSpecOptions<CountPlotChartSettings>,\n): Spec {\n  const {dataTable, selectionName} = options;\n\n  const {fieldColumn} = validateCountPlotSettings(options);\n  const tableReference = getChartTableReference(dataTable);\n\n  // Count plot shows categorical frequency as horizontal bars\n  // Categories on Y-axis, counts on X-axis\n  const plot: unknown[] = [\n    {\n      mark: 'barX',\n      data: {from: tableReference},\n      x: {count: null},\n      y: {\n        column: fieldColumn.name,\n        sort: {x: 'sum', order: 'desc', limit: 100},\n      },\n      fill: BG_COLOR,\n      inset: 0.5,\n    },\n    {\n      mark: 'barX',\n      data: {from: tableReference, filterBy: '$brush'},\n      x: {count: null},\n      y: {\n        column: fieldColumn.name,\n        sort: {x: 'sum', order: 'desc', limit: 100},\n      },\n      fill: FG_COLOR,\n      inset: 0.5,\n    },\n    {\n      mark: 'text',\n      data: {from: tableReference, filterBy: '$brush'},\n      x: {count: null},\n      y: {\n        column: fieldColumn.name,\n        sort: {x: 'sum', order: 'desc', limit: 100},\n      },\n      text: {count: null},\n      dx: 5,\n      textAnchor: 'start',\n      fill: 'currentColor',\n      fontSize: 11,\n    },\n  ];\n\n  if (selectionName) {\n    plot.push({select: 'intervalY', as: '$brush'});\n  }\n\n  return {\n    plot,\n    xLabel: 'Count',\n    yLabel: fieldColumn.name,\n    height: 400,\n    width: 380,\n    margins: {left: 50, right: 50, top: 20, bottom: 50},\n    params: {brush: {select: 'crossfilter'}},\n  } as Spec;\n}\n\nfunction validateCountPlotSettings({\n  dataTable,\n  settings: {field},\n}: CreateSpecOptions<CountPlotChartSettings>) {\n  // Basic validation for required fields\n  if (!field) {\n    throw new RequiredFieldsError('Field');\n  }\n\n  // Validate field existence and type\n  const fieldColumn = dataTable.columns.find((col) => col.name === field);\n\n  if (!fieldColumn) {\n    throw new MissingColumnsError(field);\n  }\n\n  if (!isCategoricalType(fieldColumn.type)) {\n    throw new InvalidColumnTypeError(fieldColumn.name, 'categorical');\n  }\n\n  return {\n    fieldColumn,\n  };\n}\n"]}
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/spec.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,sBAAsB,EAAC,MAAM,eAAe,CAAC;AACxE,OAAO,EAAC,yBAAyB,EAAC,MAAM,cAAc,CAAC;AAEvD,MAAM,QAAQ,GAAG,4BAA4B,CAAC;AAC9C,MAAM,QAAQ,GAAG,sBAAsB,CAAC;AAExC,MAAM,UAAU,mBAAmB,CACjC,OAAkD;IAElD,MAAM,EAAC,SAAS,EAAE,aAAa,EAAC,GAAG,OAAO,CAAC;IAE3C,MAAM,EAAC,WAAW,EAAC,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,cAAc,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAEzD,4DAA4D;IAC5D,yCAAyC;IACzC,MAAM,IAAI,GAAc;QACtB;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,EAAC,IAAI,EAAE,cAAc,EAAC;YAC5B,CAAC,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;YAChB,CAAC,EAAE;gBACD,MAAM,EAAE,WAAW,CAAC,IAAI;gBACxB,IAAI,EAAE,EAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAC;aAC5C;YACD,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;SACX;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,EAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAC;YAChD,CAAC,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;YAChB,CAAC,EAAE;gBACD,MAAM,EAAE,WAAW,CAAC,IAAI;gBACxB,IAAI,EAAE,EAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAC;aAC5C;YACD,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;SACX;QACD;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,EAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAC;YAChD,CAAC,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;YAChB,CAAC,EAAE;gBACD,MAAM,EAAE,WAAW,CAAC,IAAI;gBACxB,IAAI,EAAE,EAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAC;aAC5C;YACD,IAAI,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC;YACnB,EAAE,EAAE,CAAC;YACL,UAAU,EAAE,OAAO;YACnB,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,EAAE;SACb;KACF,CAAC;IAEF,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,EAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAC,CAAC,CAAC;IACjD,CAAC;IAED,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,OAAO;QACf,MAAM,EAAE,WAAW,CAAC,IAAI;QACxB,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,GAAG;QACV,OAAO,EAAE,EAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAC;QACnD,MAAM,EAAE,EAAC,KAAK,EAAE,EAAC,MAAM,EAAE,aAAa,EAAC,EAAC;KACjC,CAAC;AACZ,CAAC","sourcesContent":["import type {Spec} from '@uwdata/mosaic-spec';\nimport {CountPlotChartSettings} from './schema';\nimport {CreateSpecOptions, getChartTableReference} from '../base-types';\nimport {validateCountPlotSettings} from './validation';\n\nconst BG_COLOR = 'var(--color-chart-overlay)';\nconst FG_COLOR = 'var(--color-chart-1)';\n\nexport function createCountPlotSpec(\n  options: CreateSpecOptions<CountPlotChartSettings>,\n): Spec {\n  const {dataTable, selectionName} = options;\n\n  const {fieldColumn} = validateCountPlotSettings(options);\n  const tableReference = getChartTableReference(dataTable);\n\n  // Count plot shows categorical frequency as horizontal bars\n  // Categories on Y-axis, counts on X-axis\n  const plot: unknown[] = [\n    {\n      mark: 'barX',\n      data: {from: tableReference},\n      x: {count: null},\n      y: {\n        column: fieldColumn.name,\n        sort: {x: 'sum', order: 'desc', limit: 100},\n      },\n      fill: BG_COLOR,\n      inset: 0.5,\n    },\n    {\n      mark: 'barX',\n      data: {from: tableReference, filterBy: '$brush'},\n      x: {count: null},\n      y: {\n        column: fieldColumn.name,\n        sort: {x: 'sum', order: 'desc', limit: 100},\n      },\n      fill: FG_COLOR,\n      inset: 0.5,\n    },\n    {\n      mark: 'text',\n      data: {from: tableReference, filterBy: '$brush'},\n      x: {count: null},\n      y: {\n        column: fieldColumn.name,\n        sort: {x: 'sum', order: 'desc', limit: 100},\n      },\n      text: {count: null},\n      dx: 5,\n      textAnchor: 'start',\n      fill: 'currentColor',\n      fontSize: 11,\n    },\n  ];\n\n  if (selectionName) {\n    plot.push({select: 'intervalY', as: '$brush'});\n  }\n\n  return {\n    plot,\n    xLabel: 'Count',\n    yLabel: fieldColumn.name,\n    height: 400,\n    width: 380,\n    margins: {left: 50, right: 50, top: 20, bottom: 50},\n    params: {brush: {select: 'crossfilter'}},\n  } as Spec;\n}\n"]}

package/dist/charts/chart-types/count-plot/tool.d.ts

@@ -1,38 +1,33 @@
 import { z } from 'zod';
-import { type DashboardToolDeps } from '../base-types';
-export declare const CountPlotToolParameters: z.ZodObject<{
-    artifactId: z.ZodOptional<z.ZodString>;
-    tableName: z.ZodOptional<z.ZodString>;
-    createArtifactIfMissing: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+import { ChartToolParams, ChartToolOutput } from '../tool-types';
+export declare const CountPlotToolInput: z.ZodObject<{
+    tableName: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
     panelId: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodString;
     settings: z.ZodObject<{
         field: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
-export type CountPlotToolParams = z.infer<typeof CountPlotToolParameters>;
-export declare function createCountPlotAiTool(deps: DashboardToolDeps): import("ai").Tool<{
-    createArtifactIfMissing: boolean;
+export type CountPlotToolInput = z.infer<typeof CountPlotToolInput>;
+export declare function createCountPlotAiTool({ databaseAdapter, addChart, }: ChartToolParams): import("ai").Tool<{
+    tableName: string;
     reasoning: string;
     settings: {
         field: string;
     };
-    artifactId?: string | undefined;
-    tableName?: string | undefined;
+    title?: string | undefined;
     panelId?: string | undefined;
-}, {
-    llmResult: {
-        success: boolean;
-        details: string;
-        data: import("..").PanelResult;
-        errorMessage?: undefined;
-    };
-} | {
-    llmResult: {
-        success: boolean;
-        errorMessage: string;
-        details?: undefined;
-        data?: undefined;
+}, ChartToolOutput<{
+    chartType: "count-plot";
+    settings: {
+        field?: string | undefined;
     };
-}>;
+    settingsOpen?: boolean | undefined;
+    dataPolicy?: {
+        disabled?: boolean | undefined;
+        maxRows?: number | undefined;
+        reason?: string | undefined;
+    } | undefined;
+}>>;
 //# sourceMappingURL=tool.d.ts.map

package/dist/charts/chart-types/count-plot/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,OAAO,EAAC,KAAK,iBAAiB,EAAC,MAAM,eAAe,CAAC;AAKrD,eAAO,MAAM,uBAAuB;;;;;;;;;iBAElC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE1E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;GAmE5D"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAItB,OAAO,EAAC,eAAe,EAAE,eAAe,EAAC,MAAM,eAAe,CAAC;AAI/D,eAAO,MAAM,kBAAkB;;;;;;;;iBAE7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,wBAAgB,qBAAqB,CAAC,EACpC,eAAe,EACf,QAAQ,GACT,EAAE,eAAe;;;;;;;;;;;;;;;;;;;IAgDjB"}

package/dist/charts/chart-types/count-plot/tool.js

@@ -1,13 +1,13 @@
 import { tool } from 'ai';
 import { CountPlotChartSettings } from './schema';
-import { BaseChartToolParameters } from '../../../ai/tool-schemas';
-import { validateColumnExists } from '../../../ai/tool-validation';
+import { BaseChartToolInput } from '../../../ai/tool-schemas';
 import { CATEGORICAL_COLUMN_TYPES } from '../../../column-types-utils';
-import { createOrUpdateChartPanel } from '../../../ai/tool-helpers';
-export const CountPlotToolParameters = BaseChartToolParameters.extend({
+import { validateCountPlotSettings } from './validation';
+import { ensureTable } from '../../../ai/tool-helpers';
+export const CountPlotToolInput = BaseChartToolInput.extend({
     settings: CountPlotChartSettings.required(),
 });
-export function createCountPlotAiTool(deps) {
+export function createCountPlotAiTool({ databaseAdapter, addChart, }) {
     return tool({
         description: `Count plot: horizontal bar chart showing frequency of categorical/text values. Counts how many times each unique value appears.
 
@@ -18,43 +18,36 @@ Required: field must be categorical/text (${CATEGORICAL_COLUMN_TYPES.join(', ')}
 
 NOTE: Count plots aggregate by counting unique values, so they handle large datasets efficiently (no data point limit).
 
-To UPDATE an existing count plot: provide the panelId parameter. Otherwise creates new panel.
-
 CRITICAL: Only for categorical data (text, categories, enums).
 Do NOT use for: numeric distributions (use histogram), relationships between columns (use scatter-plot), time series (use line-chart).`,
-        inputSchema: CountPlotToolParameters,
-        execute: async (params, context) => {
+        inputSchema: CountPlotToolInput,
+        execute: async ({ tableName, title, settings, panelId }) => {
             try {
-                const artifactId = deps.resolveArtifact(params.artifactId, params.createArtifactIfMissing, context);
-                const { tableName, columns } = deps.resolveTable(artifactId, params.tableName);
-                // Validate settings - expect categorical columns
-                validateColumnExists(params.settings.field, CATEGORICAL_COLUMN_TYPES, columns, 'field');
-                const result = createOrUpdateChartPanel(deps, {
-                    panelId: params.panelId,
-                    dashboardId: artifactId,
+                const dataTable = ensureTable(databaseAdapter, tableName);
+                validateCountPlotSettings({
+                    dataTable,
+                    settings,
+                });
+                const chartConfig = {
+                    chartType: 'count-plot',
+                    settings,
+                };
+                await addChart({
                     tableName,
-                    title: `Count plot of ${params.settings.field}`,
-                    config: {
-                        chartType: 'count-plot',
-                        settings: params.settings,
-                    },
+                    panelId,
+                    title,
+                    config: chartConfig,
                 });
                 return {
-                    llmResult: {
-                        success: true,
-                        details: params.panelId
-                            ? `Updated count plot "${result.title}".`
-                            : `Created count plot "${result.title}".`,
-                        data: result,
-                    },
+                    success: true,
+                    details: `Generated count plot configuration for "${settings.field}".`,
+                    data: chartConfig,
                 };
             }
             catch (error) {
                 return {
-                    llmResult: {
-                        success: false,
-                        errorMessage: error instanceof Error ? error.message : String(error),
-                    },
+                    success: false,
+                    errorMessage: error instanceof Error ? error.message : String(error),
                 };
             }
         },

package/dist/charts/chart-types/count-plot/tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AAExB,OAAO,EAAC,sBAAsB,EAAC,MAAM,UAAU,CAAC;AAChD,OAAO,EAAC,uBAAuB,EAAC,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAC,oBAAoB,EAAC,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAC,wBAAwB,EAAC,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAC,wBAAwB,EAAC,MAAM,0BAA0B,CAAC;AAElE,MAAM,CAAC,MAAM,uBAAuB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IACpE,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC;AAIH,MAAM,UAAU,qBAAqB,CAAC,IAAuB;IAC3D,OAAO,IAAI,CAAC;QACV,WAAW,EAAE;;;;;4CAK2B,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;uIAOwD;QACnI,WAAW,EAAE,uBAAuB;QACpC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YACjC,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CACrC,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,uBAAuB,EAC9B,OAAO,CACR,CAAC;gBACF,MAAM,EAAC,SAAS,EAAE,OAAO,EAAC,GAAG,IAAI,CAAC,YAAY,CAC5C,UAAU,EACV,MAAM,CAAC,SAAS,CACjB,CAAC;gBAEF,iDAAiD;gBACjD,oBAAoB,CAClB,MAAM,CAAC,QAAQ,CAAC,KAAK,EACrB,wBAAwB,EACxB,OAAO,EACP,OAAO,CACR,CAAC;gBAEF,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,EAAE;oBAC5C,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,WAAW,EAAE,UAAU;oBACvB,SAAS;oBACT,KAAK,EAAE,iBAAiB,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE;oBAC/C,MAAM,EAAE;wBACN,SAAS,EAAE,YAAY;wBACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;qBAC1B;iBACF,CAAC,CAAC;gBAEH,OAAO;oBACL,SAAS,EAAE;wBACT,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,MAAM,CAAC,OAAO;4BACrB,CAAC,CAAC,uBAAuB,MAAM,CAAC,KAAK,IAAI;4BACzC,CAAC,CAAC,uBAAuB,MAAM,CAAC,KAAK,IAAI;wBAC3C,IAAI,EAAE,MAAM;qBACb;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,SAAS,EAAE;wBACT,OAAO,EAAE,KAAK;wBACd,YAAY,EACV,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBACzD;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {tool} from 'ai';\nimport {z} from 'zod';\nimport {CountPlotChartSettings} from './schema';\nimport {BaseChartToolParameters} from '../../../ai/tool-schemas';\nimport {type DashboardToolDeps} from '../base-types';\nimport {validateColumnExists} from '../../../ai/tool-validation';\nimport {CATEGORICAL_COLUMN_TYPES} from '../../../column-types-utils';\nimport {createOrUpdateChartPanel} from '../../../ai/tool-helpers';\n\nexport const CountPlotToolParameters = BaseChartToolParameters.extend({\n  settings: CountPlotChartSettings.required(),\n});\n\nexport type CountPlotToolParams = z.infer<typeof CountPlotToolParameters>;\n\nexport function createCountPlotAiTool(deps: DashboardToolDeps) {\n  return tool({\n    description: `Count plot: horizontal bar chart showing frequency of categorical/text values. Counts how many times each unique value appears.\n\nUse when: user asks to \"count\", \"frequency of\", \"how many\", \"breakdown by category\", \"distribution of [text/category column]\".\nExample queries: \"count by land use type\", \"how many features per administrative region\", \"frequency of terrain types\", \"breakdown by zone classification\", \"count parcels by ownership type\".\n\nRequired: field must be categorical/text (${CATEGORICAL_COLUMN_TYPES.join(', ')}).\n\nNOTE: Count plots aggregate by counting unique values, so they handle large datasets efficiently (no data point limit).\n\nTo UPDATE an existing count plot: provide the panelId parameter. Otherwise creates new panel.\n\nCRITICAL: Only for categorical data (text, categories, enums).\nDo NOT use for: numeric distributions (use histogram), relationships between columns (use scatter-plot), time series (use line-chart).`,\n    inputSchema: CountPlotToolParameters,\n    execute: async (params, context) => {\n      try {\n        const artifactId = deps.resolveArtifact(\n          params.artifactId,\n          params.createArtifactIfMissing,\n          context,\n        );\n        const {tableName, columns} = deps.resolveTable(\n          artifactId,\n          params.tableName,\n        );\n\n        // Validate settings - expect categorical columns\n        validateColumnExists(\n          params.settings.field,\n          CATEGORICAL_COLUMN_TYPES,\n          columns,\n          'field',\n        );\n\n        const result = createOrUpdateChartPanel(deps, {\n          panelId: params.panelId,\n          dashboardId: artifactId,\n          tableName,\n          title: `Count plot of ${params.settings.field}`,\n          config: {\n            chartType: 'count-plot',\n            settings: params.settings,\n          },\n        });\n\n        return {\n          llmResult: {\n            success: true,\n            details: params.panelId\n              ? `Updated count plot \"${result.title}\".`\n              : `Created count plot \"${result.title}\".`,\n            data: result,\n          },\n        };\n      } catch (error) {\n        return {\n          llmResult: {\n            success: false,\n            errorMessage:\n              error instanceof Error ? error.message : String(error),\n          },\n        };\n      }\n    },\n  });\n}\n"]}
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AAExB,OAAO,EAAuB,sBAAsB,EAAC,MAAM,UAAU,CAAC;AACtE,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAC,wBAAwB,EAAC,MAAM,6BAA6B,CAAC;AAErE,OAAO,EAAC,yBAAyB,EAAC,MAAM,cAAc,CAAC;AACvD,OAAO,EAAC,WAAW,EAAC,MAAM,0BAA0B,CAAC;AAErD,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,MAAM,CAAC;IAC1D,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC;AAIH,MAAM,UAAU,qBAAqB,CAAC,EACpC,eAAe,EACf,QAAQ,GACQ;IAChB,OAAO,IAAI,CAA4D;QACrE,WAAW,EAAE;;;;;4CAK2B,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;uIAKwD;QACnI,WAAW,EAAE,kBAAkB;QAC/B,OAAO,EAAE,KAAK,EAAE,EAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAC,EAAE,EAAE;YACvD,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,WAAW,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;gBAE1D,yBAAyB,CAAC;oBACxB,SAAS;oBACT,QAAQ;iBACT,CAAC,CAAC;gBAEH,MAAM,WAAW,GAAyB;oBACxC,SAAS,EAAE,YAAqB;oBAChC,QAAQ;iBACT,CAAC;gBAEF,MAAM,QAAQ,CAAC;oBACb,SAAS;oBACT,OAAO;oBACP,KAAK;oBACL,MAAM,EAAE,WAAW;iBACpB,CAAC,CAAC;gBAEH,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,2CAA2C,QAAQ,CAAC,KAAK,IAAI;oBACtE,IAAI,EAAE,WAAW;iBAClB,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 {CountPlotChartConfig, CountPlotChartSettings} from './schema';\nimport {BaseChartToolInput} from '../../../ai/tool-schemas';\nimport {CATEGORICAL_COLUMN_TYPES} from '../../../column-types-utils';\nimport {ChartToolParams, ChartToolOutput} from '../tool-types';\nimport {validateCountPlotSettings} from './validation';\nimport {ensureTable} from '../../../ai/tool-helpers';\n\nexport const CountPlotToolInput = BaseChartToolInput.extend({\n  settings: CountPlotChartSettings.required(),\n});\n\nexport type CountPlotToolInput = z.infer<typeof CountPlotToolInput>;\n\nexport function createCountPlotAiTool({\n  databaseAdapter,\n  addChart,\n}: ChartToolParams) {\n  return tool<CountPlotToolInput, ChartToolOutput<CountPlotChartConfig>>({\n    description: `Count plot: horizontal bar chart showing frequency of categorical/text values. Counts how many times each unique value appears.\n\nUse when: user asks to \"count\", \"frequency of\", \"how many\", \"breakdown by category\", \"distribution of [text/category column]\".\nExample queries: \"count by land use type\", \"how many features per administrative region\", \"frequency of terrain types\", \"breakdown by zone classification\", \"count parcels by ownership type\".\n\nRequired: field must be categorical/text (${CATEGORICAL_COLUMN_TYPES.join(', ')}).\n\nNOTE: Count plots aggregate by counting unique values, so they handle large datasets efficiently (no data point limit).\n\nCRITICAL: Only for categorical data (text, categories, enums).\nDo NOT use for: numeric distributions (use histogram), relationships between columns (use scatter-plot), time series (use line-chart).`,\n    inputSchema: CountPlotToolInput,\n    execute: async ({tableName, title, settings, panelId}) => {\n      try {\n        const dataTable = ensureTable(databaseAdapter, tableName);\n\n        validateCountPlotSettings({\n          dataTable,\n          settings,\n        });\n\n        const chartConfig: CountPlotChartConfig = {\n          chartType: 'count-plot' as const,\n          settings,\n        };\n\n        await addChart({\n          tableName,\n          panelId,\n          title,\n          config: chartConfig,\n        });\n\n        return {\n          success: true,\n          details: `Generated count plot configuration for \"${settings.field}\".`,\n          data: chartConfig,\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/charts/chart-types/count-plot/validation.d.ts

@@ -0,0 +1,8 @@
+import { CountPlotChartSettings } from './schema';
+import { ValidateSpecOptions } from '../base-types';
+import { TableColumn } from '@sqlrooms/duckdb';
+export type ValidatedCountPlotSettings = {
+    fieldColumn: TableColumn;
+};
+export declare function validateCountPlotSettings({ dataTable, settings: { field }, }: ValidateSpecOptions<CountPlotChartSettings>): ValidatedCountPlotSettings;
+//# sourceMappingURL=validation.d.ts.map

package/dist/charts/chart-types/count-plot/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/count-plot/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,sBAAsB,EAAC,MAAM,UAAU,CAAC;AAChD,OAAO,EAAC,mBAAmB,EAAC,MAAM,eAAe,CAAC;AAOlD,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAE7C,MAAM,MAAM,0BAA0B,GAAG;IACvC,WAAW,EAAE,WAAW,CAAC;CAC1B,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,EACxC,SAAS,EACT,QAAQ,EAAE,EAAC,KAAK,EAAC,GAClB,EAAE,mBAAmB,CAAC,sBAAsB,CAAC,GAAG,0BAA0B,CAoB1E"}