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

package/dist/chart-types/profiler-tool.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+import type { DashboardToolDeps } from './base-types';
+export declare const ProfilerToolParameters: z.ZodObject<{
+    artifactId: z.ZodOptional<z.ZodString>;
+    tableName: z.ZodOptional<z.ZodString>;
+    createArtifactIfMissing: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    panelId: z.ZodOptional<z.ZodString>;
+    title: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    config: z.ZodObject<{
+        pageSize: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export type ProfilerToolParams = z.infer<typeof ProfilerToolParameters>;
+export declare function createProfilerTool(deps: DashboardToolDeps): import("ai").Tool<{
+    createArtifactIfMissing: boolean;
+    title: string;
+    config: {
+        pageSize?: number | undefined;
+    };
+    reasoning: string;
+    artifactId?: string | undefined;
+    tableName?: string | undefined;
+    panelId?: string | undefined;
+}, {
+    llmResult: {
+        success: boolean;
+        details: string;
+        data: import("./tool-helpers").PanelResult;
+        errorMessage?: undefined;
+    };
+} | {
+    llmResult: {
+        success: boolean;
+        errorMessage: string;
+        details?: undefined;
+        data?: undefined;
+    };
+}>;
+//# sourceMappingURL=profiler-tool.d.ts.map

package/dist/chart-types/profiler-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-tool.d.ts","sourceRoot":"","sources":["../../src/chart-types/profiler-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,cAAc,CAAC;AAIpD,eAAO,MAAM,sBAAsB;;;;;;;;;;iBA2BjC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAExE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;GA8CzD"}

package/dist/chart-types/profiler-tool.js

@@ -0,0 +1,73 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+import { createOrUpdateProfilerPanel } from './tool-helpers';
+import { ProfilerPanelConfig } from '../dashboard/core-types';
+export const ProfilerToolParameters = z.object({
+    artifactId: z
+        .string()
+        .optional()
+        .describe('Optional dashboard artifact ID. Defaults to current dashboard.'),
+    tableName: z
+        .string()
+        .optional()
+        .describe('Optional table name. Use when no table is selected yet.'),
+    createArtifactIfMissing: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('If true, create dashboard artifact if missing.'),
+    panelId: z
+        .string()
+        .optional()
+        .describe('Optional panel ID. If provided, updates the existing panel instead of creating new one.'),
+    title: z
+        .string()
+        .optional()
+        .default('Profiler')
+        .describe('Title for the profiler panel.'),
+    config: ProfilerPanelConfig,
+    reasoning: z.string().describe('Brief rationale for creating the profiler.'),
+});
+export function createProfilerTool(deps) {
+    return tool({
+        description: `Data profiler: displays table schema and statistics for all columns (count, distinct values, min/max, etc.).
+
+Use when: user asks to "profile the data", "show table statistics", "what's in this table", "summarize columns", "give me an overview of the data".
+
+Useful for: quick data exploration, understanding data quality, finding missing values, identifying column types.
+
+To UPDATE an existing profiler: provide the panelId parameter. Otherwise creates new panel.`,
+        inputSchema: ProfilerToolParameters,
+        execute: async (params) => {
+            try {
+                const artifactId = deps.resolveArtifact(params.artifactId, params.createArtifactIfMissing);
+                const { tableName } = deps.resolveTable(artifactId, params.tableName);
+                const result = createOrUpdateProfilerPanel(deps, {
+                    panelId: params.panelId,
+                    dashboardId: artifactId,
+                    tableName,
+                    title: params.title || 'Profiler',
+                    config: params.config,
+                });
+                return {
+                    llmResult: {
+                        success: true,
+                        details: params.panelId
+                            ? `Updated profiler "${result.title}".`
+                            : `Created profiler "${result.title}".`,
+                        data: result,
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    llmResult: {
+                        success: false,
+                        errorMessage: error instanceof Error ? error.message : String(error),
+                    },
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=profiler-tool.js.map

package/dist/chart-types/profiler-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-tool.js","sourceRoot":"","sources":["../../src/chart-types/profiler-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AACxB,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,OAAO,EAAC,2BAA2B,EAAC,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAC,mBAAmB,EAAC,MAAM,yBAAyB,CAAC;AAE5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gEAAgE,CAAC;IAC7E,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;IACtE,uBAAuB,EAAE,CAAC;SACvB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,gDAAgD,CAAC;IAC7D,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yFAAyF,CAC1F;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,UAAU,CAAC;SACnB,QAAQ,CAAC,+BAA+B,CAAC;IAC5C,MAAM,EAAE,mBAAmB;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CAC7E,CAAC,CAAC;AAIH,MAAM,UAAU,kBAAkB,CAAC,IAAuB;IACxD,OAAO,IAAI,CAAC;QACV,WAAW,EAAE;;;;;;4FAM2E;QACxF,WAAW,EAAE,sBAAsB;QACnC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACxB,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CACrC,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,uBAAuB,CAC/B,CAAC;gBACF,MAAM,EAAC,SAAS,EAAC,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;gBAEpE,MAAM,MAAM,GAAG,2BAA2B,CAAC,IAAI,EAAE;oBAC/C,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,WAAW,EAAE,UAAU;oBACvB,SAAS;oBACT,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,UAAU;oBACjC,MAAM,EAAE,MAAM,CAAC,MAAM;iBACtB,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 type {DashboardToolDeps} from './base-types';\nimport {createOrUpdateProfilerPanel} from './tool-helpers';\nimport {ProfilerPanelConfig} from '../dashboard/core-types';\n\nexport const ProfilerToolParameters = z.object({\n  artifactId: z\n    .string()\n    .optional()\n    .describe('Optional dashboard artifact ID. Defaults to current dashboard.'),\n  tableName: z\n    .string()\n    .optional()\n    .describe('Optional table name. Use when no table is selected yet.'),\n  createArtifactIfMissing: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('If true, create dashboard artifact if missing.'),\n  panelId: z\n    .string()\n    .optional()\n    .describe(\n      'Optional panel ID. If provided, updates the existing panel instead of creating new one.',\n    ),\n  title: z\n    .string()\n    .optional()\n    .default('Profiler')\n    .describe('Title for the profiler panel.'),\n  config: ProfilerPanelConfig,\n  reasoning: z.string().describe('Brief rationale for creating the profiler.'),\n});\n\nexport type ProfilerToolParams = z.infer<typeof ProfilerToolParameters>;\n\nexport function createProfilerTool(deps: DashboardToolDeps) {\n  return tool({\n    description: `Data profiler: displays table schema and statistics for all columns (count, distinct values, min/max, etc.).\n\nUse when: user asks to \"profile the data\", \"show table statistics\", \"what's in this table\", \"summarize columns\", \"give me an overview of the data\".\n\nUseful for: quick data exploration, understanding data quality, finding missing values, identifying column types.\n\nTo UPDATE an existing profiler: provide the panelId parameter. Otherwise creates new panel.`,\n    inputSchema: ProfilerToolParameters,\n    execute: async (params) => {\n      try {\n        const artifactId = deps.resolveArtifact(\n          params.artifactId,\n          params.createArtifactIfMissing,\n        );\n        const {tableName} = deps.resolveTable(artifactId, params.tableName);\n\n        const result = createOrUpdateProfilerPanel(deps, {\n          panelId: params.panelId,\n          dashboardId: artifactId,\n          tableName,\n          title: params.title || 'Profiler',\n          config: params.config,\n        });\n\n        return {\n          llmResult: {\n            success: true,\n            details: params.panelId\n              ? `Updated profiler \"${result.title}\".`\n              : `Created profiler \"${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"]}

package/dist/chart-types/remove-panel-tool.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import type { DashboardToolDeps } from './base-types';
+export declare const RemovePanelToolParameters: z.ZodObject<{
+    artifactId: z.ZodOptional<z.ZodString>;
+    panelId: z.ZodString;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export type RemovePanelToolParams = z.infer<typeof RemovePanelToolParameters>;
+export declare function createRemovePanelTool(deps: DashboardToolDeps): import("ai").Tool<{
+    panelId: string;
+    reasoning: string;
+    artifactId?: string | undefined;
+}, {
+    llmResult: {
+        success: boolean;
+        details: string;
+        data: {
+            artifactId: string;
+            panelId: string;
+        };
+        errorMessage?: undefined;
+    };
+} | {
+    llmResult: {
+        success: boolean;
+        errorMessage: string;
+        details?: undefined;
+        data?: undefined;
+    };
+}>;
+//# sourceMappingURL=remove-panel-tool.d.ts.map

package/dist/chart-types/remove-panel-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-panel-tool.d.ts","sourceRoot":"","sources":["../../src/chart-types/remove-panel-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,cAAc,CAAC;AAEpD,eAAO,MAAM,yBAAyB;;;;iBAWpC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE9E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;GA+C5D"}

package/dist/chart-types/remove-panel-tool.js

@@ -0,0 +1,55 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+export const RemovePanelToolParameters = z.object({
+    artifactId: z
+        .string()
+        .optional()
+        .describe('Optional dashboard artifact ID. Defaults to current dashboard.'),
+    panelId: z
+        .string()
+        .describe('ID of the panel to remove. Use list_dashboard_panels to discover panel IDs.'),
+    reasoning: z.string().describe('Brief rationale for removing this panel.'),
+});
+export function createRemovePanelTool(deps) {
+    return tool({
+        description: `Remove dashboard panel: deletes a panel from the dashboard by its ID.
+
+Use when: user asks to "remove", "delete", "get rid of" a specific panel.
+
+Use list_dashboard_panels first to discover panel IDs.`,
+        inputSchema: RemovePanelToolParameters,
+        execute: async (params) => {
+            try {
+                const artifactId = deps.resolveArtifact(params.artifactId);
+                const dashboard = deps.getDashboard(artifactId);
+                if (!dashboard) {
+                    throw new Error(`Dashboard "${artifactId}" not found.`);
+                }
+                const panelExists = dashboard.panels.some((panel) => panel.id === params.panelId);
+                if (!panelExists) {
+                    throw new Error(`Panel "${params.panelId}" not found in dashboard "${artifactId}". Cannot remove.`);
+                }
+                deps.removePanel(artifactId, params.panelId);
+                return {
+                    llmResult: {
+                        success: true,
+                        details: `Removed panel "${params.panelId}" from dashboard.`,
+                        data: {
+                            artifactId,
+                            panelId: params.panelId,
+                        },
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    llmResult: {
+                        success: false,
+                        errorMessage: error instanceof Error ? error.message : String(error),
+                    },
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=remove-panel-tool.js.map

package/dist/chart-types/remove-panel-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-panel-tool.js","sourceRoot":"","sources":["../../src/chart-types/remove-panel-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AACxB,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gEAAgE,CAAC;IAC7E,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CACP,6EAA6E,CAC9E;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;CAC3E,CAAC,CAAC;AAIH,MAAM,UAAU,qBAAqB,CAAC,IAAuB;IAC3D,OAAO,IAAI,CAAC;QACV,WAAW,EAAE;;;;uDAIsC;QACnD,WAAW,EAAE,yBAAyB;QACtC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACxB,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;gBAChD,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,MAAM,IAAI,KAAK,CAAC,cAAc,UAAU,cAAc,CAAC,CAAC;gBAC1D,CAAC;gBACD,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CACvC,CAAC,KAAmB,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,OAAO,CACrD,CAAC;gBACF,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CACb,UAAU,MAAM,CAAC,OAAO,6BAA6B,UAAU,mBAAmB,CACnF,CAAC;gBACJ,CAAC;gBAED,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;gBAE7C,OAAO;oBACL,SAAS,EAAE;wBACT,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,kBAAkB,MAAM,CAAC,OAAO,mBAAmB;wBAC5D,IAAI,EAAE;4BACJ,UAAU;4BACV,OAAO,EAAE,MAAM,CAAC,OAAO;yBACxB;qBACF;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 type {DashboardToolDeps} from './base-types';\n\nexport const RemovePanelToolParameters = z.object({\n  artifactId: z\n    .string()\n    .optional()\n    .describe('Optional dashboard artifact ID. Defaults to current dashboard.'),\n  panelId: z\n    .string()\n    .describe(\n      'ID of the panel to remove. Use list_dashboard_panels to discover panel IDs.',\n    ),\n  reasoning: z.string().describe('Brief rationale for removing this panel.'),\n});\n\nexport type RemovePanelToolParams = z.infer<typeof RemovePanelToolParameters>;\n\nexport function createRemovePanelTool(deps: DashboardToolDeps) {\n  return tool({\n    description: `Remove dashboard panel: deletes a panel from the dashboard by its ID.\n\nUse when: user asks to \"remove\", \"delete\", \"get rid of\" a specific panel.\n\nUse list_dashboard_panels first to discover panel IDs.`,\n    inputSchema: RemovePanelToolParameters,\n    execute: async (params) => {\n      try {\n        const artifactId = deps.resolveArtifact(params.artifactId);\n        const dashboard = deps.getDashboard(artifactId);\n        if (!dashboard) {\n          throw new Error(`Dashboard \"${artifactId}\" not found.`);\n        }\n        const panelExists = dashboard.panels.some(\n          (panel: {id: string}) => panel.id === params.panelId,\n        );\n        if (!panelExists) {\n          throw new Error(\n            `Panel \"${params.panelId}\" not found in dashboard \"${artifactId}\". Cannot remove.`,\n          );\n        }\n\n        deps.removePanel(artifactId, params.panelId);\n\n        return {\n          llmResult: {\n            success: true,\n            details: `Removed panel \"${params.panelId}\" from dashboard.`,\n            data: {\n              artifactId,\n              panelId: params.panelId,\n            },\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"]}

package/dist/chart-types/text-panel-tool.d.ts

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import type { DashboardToolDeps } from './base-types';
+export declare const TextPanelToolParameters: z.ZodObject<{
+    artifactId: z.ZodOptional<z.ZodString>;
+    createArtifactIfMissing: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    panelId: z.ZodOptional<z.ZodString>;
+    title: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    config: z.ZodObject<{
+        content: z.ZodDefault<z.ZodString>;
+        toolbarOpen: z.ZodDefault<z.ZodBoolean>;
+        sourcePanelOpen: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export type TextPanelToolParams = z.infer<typeof TextPanelToolParameters>;
+export declare function createTextPanelTool(deps: DashboardToolDeps): import("ai").Tool<{
+    createArtifactIfMissing: boolean;
+    title: string;
+    config: {
+        content: string;
+        toolbarOpen: boolean;
+        sourcePanelOpen: boolean;
+    };
+    reasoning: string;
+    artifactId?: string | undefined;
+    panelId?: string | undefined;
+}, {
+    llmResult: {
+        success: boolean;
+        details: string;
+        data: import("./tool-helpers").PanelResult;
+        errorMessage?: undefined;
+    };
+} | {
+    llmResult: {
+        success: boolean;
+        errorMessage: string;
+        details?: undefined;
+        data?: undefined;
+    };
+}>;
+//# sourceMappingURL=text-panel-tool.d.ts.map

package/dist/chart-types/text-panel-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-panel-tool.d.ts","sourceRoot":"","sources":["../../src/chart-types/text-panel-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,cAAc,CAAC;AAIpD,eAAO,MAAM,uBAAuB;;;;;;;;;;;iBAyBlC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE1E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;GA8C1D"}

package/dist/chart-types/text-panel-tool.js

@@ -0,0 +1,71 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+import { createOrUpdateTextPanel } from './tool-helpers';
+import { TextPanelConfig } from '../dashboard/core-types';
+export const TextPanelToolParameters = z.object({
+    artifactId: z
+        .string()
+        .optional()
+        .describe('Optional dashboard artifact ID. Defaults to current dashboard.'),
+    createArtifactIfMissing: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('If true, create dashboard artifact if missing.'),
+    panelId: z
+        .string()
+        .optional()
+        .describe('Optional panel ID. If provided, updates the existing panel instead of creating new one.'),
+    title: z
+        .string()
+        .optional()
+        .default('Text')
+        .describe('Title for the text panel.'),
+    config: TextPanelConfig,
+    reasoning: z
+        .string()
+        .describe('Brief rationale for creating the text panel.'),
+});
+export function createTextPanelTool(deps) {
+    return tool({
+        description: `Text panel: displays markdown-formatted text for annotations, insights, explanations, or dashboard headers.
+
+Use when: user asks to "add text", "annotate findings", "add description", "summarize insights", or when you want to provide context for charts.
+
+Supports Markdown: headings, lists, bold, italic, links, code blocks.
+
+Best for: documenting insights discovered during data exploration, adding dashboard titles/sections, explaining chart findings.
+
+To UPDATE an existing text panel: provide the panelId parameter. Otherwise creates new panel.`,
+        inputSchema: TextPanelToolParameters,
+        execute: async (params) => {
+            try {
+                const artifactId = deps.resolveArtifact(params.artifactId, params.createArtifactIfMissing);
+                const result = createOrUpdateTextPanel(deps, {
+                    panelId: params.panelId,
+                    dashboardId: artifactId,
+                    title: params.title || 'Text',
+                    config: params.config,
+                });
+                return {
+                    llmResult: {
+                        success: true,
+                        details: params.panelId
+                            ? `Updated text panel "${result.title}".`
+                            : `Created text panel "${result.title}".`,
+                        data: result,
+                    },
+                };
+            }
+            catch (error) {
+                return {
+                    llmResult: {
+                        success: false,
+                        errorMessage: error instanceof Error ? error.message : String(error),
+                    },
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=text-panel-tool.js.map

package/dist/chart-types/text-panel-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-panel-tool.js","sourceRoot":"","sources":["../../src/chart-types/text-panel-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,IAAI,CAAC;AACxB,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,OAAO,EAAC,uBAAuB,EAAC,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAC,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAExD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gEAAgE,CAAC;IAC7E,uBAAuB,EAAE,CAAC;SACvB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,gDAAgD,CAAC;IAC7D,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yFAAyF,CAC1F;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,2BAA2B,CAAC;IACxC,MAAM,EAAE,eAAe;IACvB,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,8CAA8C,CAAC;CAC5D,CAAC,CAAC;AAIH,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,OAAO,IAAI,CAAC;QACV,WAAW,EAAE;;;;;;;;8FAQ6E;QAC1F,WAAW,EAAE,uBAAuB;QACpC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACxB,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CACrC,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,uBAAuB,CAC/B,CAAC;gBAEF,MAAM,MAAM,GAAG,uBAAuB,CAAC,IAAI,EAAE;oBAC3C,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,WAAW,EAAE,UAAU;oBACvB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM;oBAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;iBACtB,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 type {DashboardToolDeps} from './base-types';\nimport {createOrUpdateTextPanel} from './tool-helpers';\nimport {TextPanelConfig} from '../dashboard/core-types';\n\nexport const TextPanelToolParameters = z.object({\n  artifactId: z\n    .string()\n    .optional()\n    .describe('Optional dashboard artifact ID. Defaults to current dashboard.'),\n  createArtifactIfMissing: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('If true, create dashboard artifact if missing.'),\n  panelId: z\n    .string()\n    .optional()\n    .describe(\n      'Optional panel ID. If provided, updates the existing panel instead of creating new one.',\n    ),\n  title: z\n    .string()\n    .optional()\n    .default('Text')\n    .describe('Title for the text panel.'),\n  config: TextPanelConfig,\n  reasoning: z\n    .string()\n    .describe('Brief rationale for creating the text panel.'),\n});\n\nexport type TextPanelToolParams = z.infer<typeof TextPanelToolParameters>;\n\nexport function createTextPanelTool(deps: DashboardToolDeps) {\n  return tool({\n    description: `Text panel: displays markdown-formatted text for annotations, insights, explanations, or dashboard headers.\n\nUse when: user asks to \"add text\", \"annotate findings\", \"add description\", \"summarize insights\", or when you want to provide context for charts.\n\nSupports Markdown: headings, lists, bold, italic, links, code blocks.\n\nBest for: documenting insights discovered during data exploration, adding dashboard titles/sections, explaining chart findings.\n\nTo UPDATE an existing text panel: provide the panelId parameter. Otherwise creates new panel.`,\n    inputSchema: TextPanelToolParameters,\n    execute: async (params) => {\n      try {\n        const artifactId = deps.resolveArtifact(\n          params.artifactId,\n          params.createArtifactIfMissing,\n        );\n\n        const result = createOrUpdateTextPanel(deps, {\n          panelId: params.panelId,\n          dashboardId: artifactId,\n          title: params.title || 'Text',\n          config: params.config,\n        });\n\n        return {\n          llmResult: {\n            success: true,\n            details: params.panelId\n              ? `Updated text panel \"${result.title}\".`\n              : `Created text panel \"${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"]}

package/dist/chart-types/tool-helpers.d.ts

@@ -0,0 +1,44 @@
+import type { DashboardToolDeps } from './base-types';
+import type { ProfilerPanelConfig, TextPanelConfig } from '../dashboard/core-types';
+import type { ChartConfig } from './chart-config';
+export interface PanelResult {
+    panelId: string;
+    artifactId: string;
+    title: string;
+    config: ChartConfig | ProfilerPanelConfig | TextPanelConfig;
+}
+export interface CreateOrUpdateChartPanelParams {
+    panelId?: string;
+    dashboardId: string;
+    tableName: string;
+    title: string;
+    config: ChartConfig;
+}
+export interface CreateOrUpdateProfilerPanelParams {
+    panelId?: string;
+    dashboardId: string;
+    tableName: string;
+    title: string;
+    config: ProfilerPanelConfig;
+}
+export interface CreateOrUpdateTextPanelParams {
+    panelId?: string;
+    dashboardId: string;
+    title: string;
+    config: TextPanelConfig;
+}
+/**
+ * Universal helper to create or update a chart panel.
+ * Handles everything: panel config creation, add/update logic, artifact switching.
+ * When updating, both source and config are updated to allow changing the data source.
+ */
+export declare function createOrUpdateChartPanel(deps: DashboardToolDeps, params: CreateOrUpdateChartPanelParams): PanelResult;
+/**
+ * Universal helper to create or update a profiler panel.
+ */
+export declare function createOrUpdateProfilerPanel(deps: DashboardToolDeps, params: CreateOrUpdateProfilerPanelParams): PanelResult;
+/**
+ * Universal helper to create or update a text panel.
+ */
+export declare function createOrUpdateTextPanel(deps: DashboardToolDeps, params: CreateOrUpdateTextPanelParams): PanelResult;
+//# sourceMappingURL=tool-helpers.d.ts.map

package/dist/chart-types/tool-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-helpers.d.ts","sourceRoot":"","sources":["../../src/chart-types/tool-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,cAAc,CAAC;AAOpD,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,mBAAmB,GAAG,eAAe,CAAC;CAC7D;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,iCAAiC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,eAAe,CAAC;CACzB;AAkCD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,8BAA8B,GACrC,WAAW,CAoCb;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,iCAAiC,GACxC,WAAW,CAmCb;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,6BAA6B,GACpC,WAAW,CAmCb"}

package/dist/chart-types/tool-helpers.js

@@ -0,0 +1,129 @@
+import { createMosaicDashboardChartPanelConfig, createMosaicDashboardProfilerPanelConfig, createMosaicDashboardTextPanelConfig, } from '../dashboard/MosaicDashboardSlice';
+/**
+ * Validates that a dashboard exists. Throws if not found.
+ */
+function ensureDashboard(deps, dashboardId) {
+    const dashboard = deps.getDashboard(dashboardId);
+    if (!dashboard) {
+        throw new Error(`Dashboard "${dashboardId}" not found. Cannot update panel.`);
+    }
+    return dashboard;
+}
+/**
+ * Validates that a panel exists in a dashboard. Throws if not found.
+ */
+function ensurePanel(dashboard, dashboardId, panelId) {
+    const panelExists = dashboard.panels.some((p) => p.id === panelId);
+    if (!panelExists) {
+        throw new Error(`Panel "${panelId}" not found in dashboard "${dashboardId}". Cannot update.`);
+    }
+}
+/**
+ * Universal helper to create or update a chart panel.
+ * Handles everything: panel config creation, add/update logic, artifact switching.
+ * When updating, both source and config are updated to allow changing the data source.
+ */
+export function createOrUpdateChartPanel(deps, params) {
+    if (params.panelId) {
+        // Validate panel exists before attempting update
+        const dashboard = ensureDashboard(deps, params.dashboardId);
+        ensurePanel(dashboard, params.dashboardId, params.panelId);
+        // Update existing panel - update both source and config
+        deps.updatePanel(params.dashboardId, params.panelId, {
+            title: params.title,
+            source: { tableName: params.tableName },
+            config: params.config,
+        });
+        return {
+            panelId: params.panelId,
+            artifactId: params.dashboardId,
+            title: params.title,
+            config: params.config,
+        };
+    }
+    else {
+        // Create new panel - create config and add to dashboard
+        const panel = createMosaicDashboardChartPanelConfig(params.title, params.config);
+        const panelId = deps.addPanel(params.dashboardId, panel);
+        deps.setCurrentArtifact(params.dashboardId);
+        return {
+            panelId,
+            artifactId: params.dashboardId,
+            title: params.title,
+            config: params.config,
+        };
+    }
+}
+/**
+ * Universal helper to create or update a profiler panel.
+ */
+export function createOrUpdateProfilerPanel(deps, params) {
+    if (params.panelId) {
+        // Validate panel exists before attempting update
+        const dashboard = ensureDashboard(deps, params.dashboardId);
+        ensurePanel(dashboard, params.dashboardId, params.panelId);
+        deps.updatePanel(params.dashboardId, params.panelId, {
+            config: params.config,
+            source: { tableName: params.tableName },
+            title: params.title,
+        });
+        return {
+            panelId: params.panelId,
+            artifactId: params.dashboardId,
+            title: params.title,
+            config: params.config,
+        };
+    }
+    else {
+        // Create new panel - create full panel config
+        const panel = createMosaicDashboardProfilerPanelConfig({
+            title: params.title,
+            config: params.config,
+        });
+        const panelId = deps.addPanel(params.dashboardId, panel);
+        deps.setCurrentArtifact(params.dashboardId);
+        return {
+            panelId,
+            artifactId: params.dashboardId,
+            title: panel.title,
+            config: panel.config,
+        };
+    }
+}
+/**
+ * Universal helper to create or update a text panel.
+ */
+export function createOrUpdateTextPanel(deps, params) {
+    if (params.panelId) {
+        // Validate panel exists before attempting update
+        const dashboard = ensureDashboard(deps, params.dashboardId);
+        ensurePanel(dashboard, params.dashboardId, params.panelId);
+        // Update existing panel
+        deps.updatePanel(params.dashboardId, params.panelId, {
+            title: params.title,
+            config: params.config,
+        });
+        return {
+            panelId: params.panelId,
+            artifactId: params.dashboardId,
+            title: params.title,
+            config: params.config,
+        };
+    }
+    else {
+        // Create new panel - create full panel config
+        const panel = createMosaicDashboardTextPanelConfig({
+            title: params.title,
+            config: params.config,
+        });
+        const panelId = deps.addPanel(params.dashboardId, panel);
+        deps.setCurrentArtifact(params.dashboardId);
+        return {
+            panelId,
+            artifactId: params.dashboardId,
+            title: panel.title,
+            config: panel.config,
+        };
+    }
+}
+//# sourceMappingURL=tool-helpers.js.map

package/dist/chart-types/tool-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-helpers.js","sourceRoot":"","sources":["../../src/chart-types/tool-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import type {DashboardToolDeps} from './base-types';\nimport {\n  createMosaicDashboardChartPanelConfig,\n  createMosaicDashboardProfilerPanelConfig,\n  createMosaicDashboardTextPanelConfig,\n} from '../dashboard/MosaicDashboardSlice';\nimport {MosaicDashboardEntry} from '../dashboard/dashboard-types';\nimport type {\n  ProfilerPanelConfig,\n  TextPanelConfig,\n} from '../dashboard/core-types';\nimport type {ChartConfig} from './chart-config';\n\nexport interface PanelResult {\n  panelId: string;\n  artifactId: string;\n  title: string;\n  config: ChartConfig | ProfilerPanelConfig | TextPanelConfig;\n}\n\nexport interface CreateOrUpdateChartPanelParams {\n  panelId?: string;\n  dashboardId: string;\n  tableName: string;\n  title: string;\n  config: ChartConfig;\n}\n\nexport interface CreateOrUpdateProfilerPanelParams {\n  panelId?: string;\n  dashboardId: string;\n  tableName: string;\n  title: string;\n  config: ProfilerPanelConfig;\n}\n\nexport interface CreateOrUpdateTextPanelParams {\n  panelId?: string;\n  dashboardId: string;\n  title: string;\n  config: TextPanelConfig;\n}\n\n/**\n * Validates that a dashboard exists. Throws if not found.\n */\nfunction ensureDashboard(\n  deps: DashboardToolDeps,\n  dashboardId: string,\n): NonNullable<ReturnType<DashboardToolDeps['getDashboard']>> {\n  const dashboard = deps.getDashboard(dashboardId);\n  if (!dashboard) {\n    throw new Error(\n      `Dashboard \"${dashboardId}\" not found. Cannot update panel.`,\n    );\n  }\n  return dashboard;\n}\n\n/**\n * Validates that a panel exists in a dashboard. Throws if not found.\n */\nfunction ensurePanel(\n  dashboard: MosaicDashboardEntry,\n  dashboardId: string,\n  panelId: string,\n): void {\n  const panelExists = dashboard.panels.some((p) => p.id === panelId);\n  if (!panelExists) {\n    throw new Error(\n      `Panel \"${panelId}\" not found in dashboard \"${dashboardId}\". Cannot update.`,\n    );\n  }\n}\n\n/**\n * Universal helper to create or update a chart panel.\n * Handles everything: panel config creation, add/update logic, artifact switching.\n * When updating, both source and config are updated to allow changing the data source.\n */\nexport function createOrUpdateChartPanel(\n  deps: DashboardToolDeps,\n  params: CreateOrUpdateChartPanelParams,\n): PanelResult {\n  if (params.panelId) {\n    // Validate panel exists before attempting update\n    const dashboard = ensureDashboard(deps, params.dashboardId);\n    ensurePanel(dashboard, params.dashboardId, params.panelId);\n\n    // Update existing panel - update both source and config\n    deps.updatePanel(params.dashboardId, params.panelId, {\n      title: params.title,\n      source: {tableName: params.tableName},\n      config: params.config,\n    });\n\n    return {\n      panelId: params.panelId,\n      artifactId: params.dashboardId,\n      title: params.title,\n      config: params.config,\n    };\n  } else {\n    // Create new panel - create config and add to dashboard\n    const panel = createMosaicDashboardChartPanelConfig(\n      params.title,\n      params.config,\n    );\n\n    const panelId = deps.addPanel(params.dashboardId, panel);\n    deps.setCurrentArtifact(params.dashboardId);\n\n    return {\n      panelId,\n      artifactId: params.dashboardId,\n      title: params.title,\n      config: params.config,\n    };\n  }\n}\n\n/**\n * Universal helper to create or update a profiler panel.\n */\nexport function createOrUpdateProfilerPanel(\n  deps: DashboardToolDeps,\n  params: CreateOrUpdateProfilerPanelParams,\n): PanelResult {\n  if (params.panelId) {\n    // Validate panel exists before attempting update\n    const dashboard = ensureDashboard(deps, params.dashboardId);\n    ensurePanel(dashboard, params.dashboardId, params.panelId);\n\n    deps.updatePanel(params.dashboardId, params.panelId, {\n      config: params.config,\n      source: {tableName: params.tableName},\n      title: params.title,\n    });\n\n    return {\n      panelId: params.panelId,\n      artifactId: params.dashboardId,\n      title: params.title,\n      config: params.config,\n    };\n  } else {\n    // Create new panel - create full panel config\n    const panel = createMosaicDashboardProfilerPanelConfig({\n      title: params.title,\n      config: params.config,\n    });\n\n    const panelId = deps.addPanel(params.dashboardId, panel);\n    deps.setCurrentArtifact(params.dashboardId);\n\n    return {\n      panelId,\n      artifactId: params.dashboardId,\n      title: panel.title,\n      config: panel.config,\n    };\n  }\n}\n\n/**\n * Universal helper to create or update a text panel.\n */\nexport function createOrUpdateTextPanel(\n  deps: DashboardToolDeps,\n  params: CreateOrUpdateTextPanelParams,\n): PanelResult {\n  if (params.panelId) {\n    // Validate panel exists before attempting update\n    const dashboard = ensureDashboard(deps, params.dashboardId);\n    ensurePanel(dashboard, params.dashboardId, params.panelId);\n\n    // Update existing panel\n    deps.updatePanel(params.dashboardId, params.panelId, {\n      title: params.title,\n      config: params.config,\n    });\n\n    return {\n      panelId: params.panelId,\n      artifactId: params.dashboardId,\n      title: params.title,\n      config: params.config,\n    };\n  } else {\n    // Create new panel - create full panel config\n    const panel = createMosaicDashboardTextPanelConfig({\n      title: params.title,\n      config: params.config,\n    });\n\n    const panelId = deps.addPanel(params.dashboardId, panel);\n    deps.setCurrentArtifact(params.dashboardId);\n\n    return {\n      panelId,\n      artifactId: params.dashboardId,\n      title: panel.title,\n      config: panel.config,\n    };\n  }\n}\n"]}

package/dist/chart-types/tool-schemas.d.ts

@@ -3,6 +3,7 @@ export declare const BaseChartToolParameters: z.ZodObject<{
     artifactId: z.ZodOptional<z.ZodString>;
     tableName: z.ZodOptional<z.ZodString>;
     createArtifactIfMissing: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    panelId: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodString;
 }, z.core.$strip>;
 //# sourceMappingURL=tool-schemas.d.ts.map

package/dist/chart-types/tool-schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-schemas.d.ts","sourceRoot":"","sources":["../../src/chart-types/tool-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,eAAO,MAAM,uBAAuB;;;;;iBAelC,CAAC"}
+{"version":3,"file":"tool-schemas.d.ts","sourceRoot":"","sources":["../../src/chart-types/tool-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,eAAO,MAAM,uBAAuB;;;;;;iBAuBlC,CAAC"}

package/dist/chart-types/tool-schemas.js

@@ -3,7 +3,7 @@ export const BaseChartToolParameters = z.object({
     artifactId: z
         .string()
         .optional()
-        .describe('Optional dashboard artifact ID. Defaults to current dashboard.'),
+        .describe('Optional dashboard artifact ID. Prefer passing this explicitly; if omitted, the host may use an unambiguous primary dashboard context.'),
     tableName: z
         .string()
         .optional()
@@ -13,6 +13,10 @@ export const BaseChartToolParameters = z.object({
         .optional()
         .default(true)
         .describe('If true, create dashboard artifact if missing.'),
+    panelId: z
+        .string()
+        .optional()
+        .describe('Optional panel ID. If provided, updates the existing panel instead of creating new one.'),
     reasoning: z.string().describe('Brief rationale for the chart choice.'),
 });
 //# sourceMappingURL=tool-schemas.js.map

package/dist/chart-types/tool-schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-schemas.js","sourceRoot":"","sources":["../../src/chart-types/tool-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gEAAgE,CAAC;IAC7E,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;IACtE,uBAAuB,EAAE,CAAC;SACvB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,gDAAgD,CAAC;IAC7D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CACxE,CAAC,CAAC","sourcesContent":["import {z} from 'zod';\n\nexport const BaseChartToolParameters = z.object({\n  artifactId: z\n    .string()\n    .optional()\n    .describe('Optional dashboard artifact ID. Defaults to current dashboard.'),\n  tableName: z\n    .string()\n    .optional()\n    .describe('Optional table name. Use when no table is selected yet.'),\n  createArtifactIfMissing: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('If true, create dashboard artifact if missing.'),\n  reasoning: z.string().describe('Brief rationale for the chart choice.'),\n});\n"]}
+{"version":3,"file":"tool-schemas.js","sourceRoot":"","sources":["../../src/chart-types/tool-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,wIAAwI,CACzI;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;IACtE,uBAAuB,EAAE,CAAC;SACvB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,gDAAgD,CAAC;IAC7D,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yFAAyF,CAC1F;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CACxE,CAAC,CAAC","sourcesContent":["import {z} from 'zod';\n\nexport const BaseChartToolParameters = z.object({\n  artifactId: z\n    .string()\n    .optional()\n    .describe(\n      'Optional dashboard artifact ID. Prefer passing this explicitly; if omitted, the host may use an unambiguous primary dashboard context.',\n    ),\n  tableName: z\n    .string()\n    .optional()\n    .describe('Optional table name. Use when no table is selected yet.'),\n  createArtifactIfMissing: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('If true, create dashboard artifact if missing.'),\n  panelId: z\n    .string()\n    .optional()\n    .describe(\n      'Optional panel ID. If provided, updates the existing panel instead of creating new one.',\n    ),\n  reasoning: z.string().describe('Brief rationale for the chart choice.'),\n});\n"]}

package/dist/dashboard/MosaicDashboard.d.ts

@@ -1,12 +1,15 @@
 import { PropsWithChildren, ReactElement } from 'react';
 import { MosaicDashboardPanels } from './MosaicDashboardPanels';
-import { MosaicDashboardToolbar } from './MosaicDashboardToolbar';
+import { MosaicDashboardToolbar } from './toolbar/MosaicDashboardToolbar';
+import type { MosaicDashboardInitialStateProps } from './initial-state/MosaicDashboardInitialState';
 export type MosaicDashboardRootProps = PropsWithChildren<{
     dashboardId: string;
+    onStart?: MosaicDashboardInitialStateProps['onStart'];
 }>;
-export declare function MosaicDashboardRoot({ children, dashboardId, }: MosaicDashboardRootProps): import("react/jsx-runtime").JSX.Element;
+export declare function MosaicDashboardRoot({ children, dashboardId, onStart, }: MosaicDashboardRootProps): import("react/jsx-runtime").JSX.Element;
 export type MosaicDashboardProps = {
     dashboardId: string;
+    onStart?: MosaicDashboardInitialStateProps['onStart'];
 };
 type MosaicDashboardCompoundComponent = ((props: MosaicDashboardProps) => ReactElement) & {
     Root: typeof MosaicDashboardRoot;

package/dist/dashboard/MosaicDashboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MosaicDashboard.d.ts","sourceRoot":"","sources":["../../src/dashboard/MosaicDashboard.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,YAAY,EAKb,MAAM,OAAO,CAAC;AAGf,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAC;AAM9D,OAAO,EAAC,sBAAsB,EAAC,MAAM,0BAA0B,CAAC;AAIhE,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;IACvD,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,WAAW,GACZ,EAAE,wBAAwB,2CAuI1B;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAiBF,KAAK,gCAAgC,GAAG,CAAC,CACvC,KAAK,EAAE,oBAAoB,KACxB,YAAY,CAAC,GAAG;IACnB,IAAI,EAAE,OAAO,mBAAmB,CAAC;IACjC,OAAO,EAAE,OAAO,sBAAsB,CAAC;IACvC,MAAM,EAAE,OAAO,qBAAqB,CAAC;CACtC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,gCAO7B,CAAC"}
+{"version":3,"file":"MosaicDashboard.d.ts","sourceRoot":"","sources":["../../src/dashboard/MosaicDashboard.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,YAAY,EAKb,MAAM,OAAO,CAAC;AAGf,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAC;AAM9D,OAAO,EAAC,sBAAsB,EAAC,MAAM,kCAAkC,CAAC;AAIxE,OAAO,KAAK,EAAC,gCAAgC,EAAC,MAAM,6CAA6C,CAAC;AAElG,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,gCAAgC,CAAC,SAAS,CAAC,CAAC;CACvD,CAAC,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,WAAW,EACX,OAAO,GACR,EAAE,wBAAwB,2CAgG1B;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,gCAAgC,CAAC,SAAS,CAAC,CAAC;CACvD,CAAC;AAkBF,KAAK,gCAAgC,GAAG,CAAC,CACvC,KAAK,EAAE,oBAAoB,KACxB,YAAY,CAAC,GAAG;IACnB,IAAI,EAAE,OAAO,mBAAmB,CAAC;IACjC,OAAO,EAAE,OAAO,sBAAsB,CAAC;IACvC,MAAM,EAAE,OAAO,qBAAqB,CAAC;CACtC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,gCAO7B,CAAC"}