@xpert-ai/plugin-live-dashboard 0.0.0-stage → 0.1.0

package/dist/lib/agent.schema.d.ts

@@ -0,0 +1,568 @@
+import { z } from 'zod/v3';
+import type { AnalyticsDiscoveryResult } from '@xpert-ai/contracts';
+export declare const discoverToolSchema: z.ZodObject<{
+    dataSourceId: z.ZodString;
+    providerId: z.ZodString;
+    requestJson: z.ZodDefault<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    dataSourceId: string;
+    providerId: string;
+    requestJson: string;
+}, {
+    dataSourceId: string;
+    providerId: string;
+    requestJson?: string | undefined;
+}>;
+export declare const agentBindingSchema: z.ZodObject<{
+    dataSourceId: z.ZodString;
+    providerId: z.ZodString;
+    output: z.ZodObject<{
+        datasetId: z.ZodString;
+        fields: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            sourceField: z.ZodString;
+            label: z.ZodString;
+            logicalType: z.ZodEnum<["string", "boolean", "int64", "float64", "decimal", "date", "timestamp"]>;
+            nullable: z.ZodBoolean;
+            role: z.ZodEnum<["dimension", "measure", "time", "identifier"]>;
+            semanticRef: z.ZodOptional<z.ZodString>;
+            unit: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            id?: string;
+            sourceField?: string;
+            label?: string;
+            logicalType?: "string" | "boolean" | "date" | "int64" | "float64" | "decimal" | "timestamp";
+            nullable?: boolean;
+            role?: "dimension" | "measure" | "time" | "identifier";
+            semanticRef?: string;
+            unit?: string;
+        }, {
+            id?: string;
+            sourceField?: string;
+            label?: string;
+            logicalType?: "string" | "boolean" | "date" | "int64" | "float64" | "decimal" | "timestamp";
+            nullable?: boolean;
+            role?: "dimension" | "measure" | "time" | "identifier";
+            semanticRef?: string;
+            unit?: string;
+        }>, "many">;
+        grain: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        datasetId?: string;
+        fields?: {
+            id?: string;
+            sourceField?: string;
+            label?: string;
+            logicalType?: "string" | "boolean" | "date" | "int64" | "float64" | "decimal" | "timestamp";
+            nullable?: boolean;
+            role?: "dimension" | "measure" | "time" | "identifier";
+            semanticRef?: string;
+            unit?: string;
+        }[];
+        grain?: string[];
+    }, {
+        datasetId?: string;
+        fields?: {
+            id?: string;
+            sourceField?: string;
+            label?: string;
+            logicalType?: "string" | "boolean" | "date" | "int64" | "float64" | "decimal" | "timestamp";
+            nullable?: boolean;
+            role?: "dimension" | "measure" | "time" | "identifier";
+            semanticRef?: string;
+            unit?: string;
+        }[];
+        grain?: string[];
+    }>;
+} & {
+    parameters: z.ZodArray<z.ZodObject<Omit<{
+        name: z.ZodString;
+        controlId: z.ZodString;
+        type: z.ZodEnum<["string", "number", "boolean", "date"]>;
+        required: z.ZodBoolean;
+        defaultValue: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+        allowedValues: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, "many">>;
+    }, "controlId">, "strict", z.ZodTypeAny, {
+        type: "string" | "number" | "boolean" | "date";
+        name: string;
+        required: boolean;
+        defaultValue?: string | number | boolean | null | undefined;
+        allowedValues?: (string | number | boolean | null)[] | undefined;
+    }, {
+        type: "string" | "number" | "boolean" | "date";
+        name: string;
+        required: boolean;
+        defaultValue?: string | number | boolean | null | undefined;
+        allowedValues?: (string | number | boolean | null)[] | undefined;
+    }>, "many">;
+    payloadJson: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    parameters: {
+        type: "string" | "number" | "boolean" | "date";
+        name: string;
+        required: boolean;
+        defaultValue?: string | number | boolean | null | undefined;
+        allowedValues?: (string | number | boolean | null)[] | undefined;
+    }[];
+    dataSourceId: string;
+    providerId: string;
+    output: {
+        datasetId?: string;
+        fields?: {
+            id?: string;
+            sourceField?: string;
+            label?: string;
+            logicalType?: "string" | "boolean" | "date" | "int64" | "float64" | "decimal" | "timestamp";
+            nullable?: boolean;
+            role?: "dimension" | "measure" | "time" | "identifier";
+            semanticRef?: string;
+            unit?: string;
+        }[];
+        grain?: string[];
+    };
+    payloadJson: string;
+}, {
+    parameters: {
+        type: "string" | "number" | "boolean" | "date";
+        name: string;
+        required: boolean;
+        defaultValue?: string | number | boolean | null | undefined;
+        allowedValues?: (string | number | boolean | null)[] | undefined;
+    }[];
+    dataSourceId: string;
+    providerId: string;
+    output: {
+        datasetId?: string;
+        fields?: {
+            id?: string;
+            sourceField?: string;
+            label?: string;
+            logicalType?: "string" | "boolean" | "date" | "int64" | "float64" | "decimal" | "timestamp";
+            nullable?: boolean;
+            role?: "dimension" | "measure" | "time" | "identifier";
+            semanticRef?: string;
+            unit?: string;
+        }[];
+        grain?: string[];
+    };
+    payloadJson: string;
+}>;
+export declare const previewToolSchema: z.ZodObject<{
+    binding: z.ZodObject<{
+        dataSourceId: z.ZodString;
+        providerId: z.ZodString;
+        output: z.ZodObject<{
+            datasetId: z.ZodString;
+            fields: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                sourceField: z.ZodString;
+                label: z.ZodString;
+                logicalType: z.ZodEnum<["string", "boolean", "int64", "float64", "decimal", "date", "timestamp"]>;
+                nullable: z.ZodBoolean;
+                role: z.ZodEnum<["dimension", "measure", "time", "identifier"]>;
+                semanticRef: z.ZodOptional<z.ZodString>;
+                unit: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                id?: string;
+                sourceField?: string;
+                label?: string;
+                logicalType?: "string" | "boolean" | "date" | "int64" | "float64" | "decimal" | "timestamp";
+                nullable?: boolean;
+                role?: "dimension" | "measure" | "time" | "identifier";
+                semanticRef?: string;
+                unit?: string;
+            }, {
+                id?: string;
+                sourceField?: string;
+                label?: string;
+                logicalType?: "string" | "boolean" | "date" | "int64" | "float64" | "decimal" | "timestamp";
+                nullable?: boolean;
+                role?: "dimension" | "measure" | "time" | "identifier";
+                semanticRef?: string;
+                unit?: string;
+            }>, "many">;
+            grain: z.ZodArray<z.ZodString, "many">;
+        }, "strict", z.ZodTypeAny, {
+            datasetId?: string;
+            fields?: {
+                id?: string;
+                sourceField?: string;
+                label?: string;
+                logicalType?: "string" | "boolean" | "date" | "int64" | "float64" | "decimal" | "timestamp";
+                nullable?: boolean;
+                role?: "dimension" | "measure" | "time" | "identifier";
+                semanticRef?: string;
+                unit?: string;
+            }[];
+            grain?: string[];
+        }, {
+            datasetId?: string;
+            fields?: {
+                id?: string;
+                sourceField?: string;
+                label?: string;
+                logicalType?: "string" | "boolean" | "date" | "int64" | "float64" | "decimal" | "timestamp";
+                nullable?: boolean;
+                role?: "dimension" | "measure" | "time" | "identifier";
+                semanticRef?: string;
+                unit?: string;
+            }[];
+            grain?: string[];
+        }>;
+    } & {
+        parameters: z.ZodArray<z.ZodObject<Omit<{
+            name: z.ZodString;
+            controlId: z.ZodString;
+            type: z.ZodEnum<["string", "number", "boolean", "date"]>;
+            required: z.ZodBoolean;
+            defaultValue: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+            allowedValues: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, "many">>;
+        }, "controlId">, "strict", z.ZodTypeAny, {
+            type: "string" | "number" | "boolean" | "date";
+            name: string;
+            required: boolean;
+            defaultValue?: string | number | boolean | null | undefined;
+            allowedValues?: (string | number | boolean | null)[] | undefined;
+        }, {
+            type: "string" | "number" | "boolean" | "date";
+            name: string;
+            required: boolean;
+            defaultValue?: string | number | boolean | null | undefined;
+            allowedValues?: (string | number | boolean | null)[] | undefined;
+        }>, "many">;
+        payloadJson: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        parameters: {
+            type: "string" | "number" | "boolean" | "date";
+            name: string;
+            required: boolean;
+            defaultValue?: string | number | boolean | null | undefined;
+            allowedValues?: (string | number | boolean | null)[] | undefined;
+        }[];
+        dataSourceId: string;
+        providerId: string;
+        output: {
+            datasetId?: string;
+            fields?: {
+                id?: string;
+                sourceField?: string;
+                label?: string;
+                logicalType?: "string" | "boolean" | "date" | "int64" | "float64" | "decimal" | "timestamp";
+                nullable?: boolean;
+                role?: "dimension" | "measure" | "time" | "identifier";
+                semanticRef?: string;
+                unit?: string;
+            }[];
+            grain?: string[];
+        };
+        payloadJson: string;
+    }, {
+        parameters: {
+            type: "string" | "number" | "boolean" | "date";
+            name: string;
+            required: boolean;
+            defaultValue?: string | number | boolean | null | undefined;
+            allowedValues?: (string | number | boolean | null)[] | undefined;
+        }[];
+        dataSourceId: string;
+        providerId: string;
+        output: {
+            datasetId?: string;
+            fields?: {
+                id?: string;
+                sourceField?: string;
+                label?: string;
+                logicalType?: "string" | "boolean" | "date" | "int64" | "float64" | "decimal" | "timestamp";
+                nullable?: boolean;
+                role?: "dimension" | "measure" | "time" | "identifier";
+                semanticRef?: string;
+                unit?: string;
+            }[];
+            grain?: string[];
+        };
+        payloadJson: string;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    binding: {
+        parameters: {
+            type: "string" | "number" | "boolean" | "date";
+            name: string;
+            required: boolean;
+            defaultValue?: string | number | boolean | null | undefined;
+            allowedValues?: (string | number | boolean | null)[] | undefined;
+        }[];
+        dataSourceId: string;
+        providerId: string;
+        output: {
+            datasetId?: string;
+            fields?: {
+                id?: string;
+                sourceField?: string;
+                label?: string;
+                logicalType?: "string" | "boolean" | "date" | "int64" | "float64" | "decimal" | "timestamp";
+                nullable?: boolean;
+                role?: "dimension" | "measure" | "time" | "identifier";
+                semanticRef?: string;
+                unit?: string;
+            }[];
+            grain?: string[];
+        };
+        payloadJson: string;
+    };
+}, {
+    binding: {
+        parameters: {
+            type: "string" | "number" | "boolean" | "date";
+            name: string;
+            required: boolean;
+            defaultValue?: string | number | boolean | null | undefined;
+            allowedValues?: (string | number | boolean | null)[] | undefined;
+        }[];
+        dataSourceId: string;
+        providerId: string;
+        output: {
+            datasetId?: string;
+            fields?: {
+                id?: string;
+                sourceField?: string;
+                label?: string;
+                logicalType?: "string" | "boolean" | "date" | "int64" | "float64" | "decimal" | "timestamp";
+                nullable?: boolean;
+                role?: "dimension" | "measure" | "time" | "identifier";
+                semanticRef?: string;
+                unit?: string;
+            }[];
+            grain?: string[];
+        };
+        payloadJson: string;
+    };
+}>;
+export declare const createToolSchema: z.ZodObject<{} & {
+    title: z.ZodString;
+    supersedesPaths: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+    controls: z.ZodEffects<z.ZodArray<z.ZodObject<{
+        controlId: z.ZodString;
+        type: z.ZodEnum<["string", "number", "boolean", "date"]>;
+        allowedValues: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, "many">>;
+        label: z.ZodString;
+    } & {
+        defaultValue: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+    }, "strict", z.ZodTypeAny, {
+        type: "string" | "number" | "boolean" | "date";
+        controlId: string;
+        defaultValue: string | number | boolean | null;
+        label: string;
+        allowedValues?: (string | number | boolean | null)[] | undefined;
+    }, {
+        type: "string" | "number" | "boolean" | "date";
+        controlId: string;
+        defaultValue: string | number | boolean | null;
+        label: string;
+        allowedValues?: (string | number | boolean | null)[] | undefined;
+    }>, "many">, {
+        type: "string" | "number" | "boolean" | "date";
+        controlId: string;
+        defaultValue: string | number | boolean | null;
+        label: string;
+        allowedValues?: (string | number | boolean | null)[] | undefined;
+    }[], unknown>;
+    charts: z.ZodEffects<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodEnum<["bar", "line", "area", "pie", "scatter"]>;
+        datasetId: z.ZodString;
+        x: z.ZodString;
+        y: z.ZodString;
+        color: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        type: "bar" | "line" | "area" | "pie" | "scatter";
+        id: string;
+        title: string;
+        datasetId: string;
+        x: string;
+        y: string;
+        color?: string | undefined;
+    }, {
+        type: "bar" | "line" | "area" | "pie" | "scatter";
+        id: string;
+        title: string;
+        datasetId: string;
+        x: string;
+        y: string;
+        color?: string | undefined;
+    }>, "many">, {
+        type: "bar" | "line" | "area" | "pie" | "scatter";
+        id: string;
+        title: string;
+        datasetId: string;
+        x: string;
+        y: string;
+        color?: string | undefined;
+    }[], unknown>;
+    tables: z.ZodEffects<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        datasetId: z.ZodString;
+        fields: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        datasetId: string;
+        fields: string[];
+    }, {
+        id: string;
+        title: string;
+        datasetId: string;
+        fields: string[];
+    }>, "many">, {
+        id: string;
+        title: string;
+        datasetId: string;
+        fields: string[];
+    }[], unknown>;
+    previewIds: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>;
+}, "strict", z.ZodTypeAny, {
+    title: string;
+    controls: {
+        type: "string" | "number" | "boolean" | "date";
+        controlId: string;
+        defaultValue: string | number | boolean | null;
+        label: string;
+        allowedValues?: (string | number | boolean | null)[] | undefined;
+    }[];
+    charts: {
+        type: "bar" | "line" | "area" | "pie" | "scatter";
+        id: string;
+        title: string;
+        datasetId: string;
+        x: string;
+        y: string;
+        color?: string | undefined;
+    }[];
+    tables: {
+        id: string;
+        title: string;
+        datasetId: string;
+        fields: string[];
+    }[];
+    previewIds: string[];
+    supersedesPaths?: string[] | undefined;
+}, {
+    title: string;
+    controls?: unknown;
+    charts?: unknown;
+    tables?: unknown;
+    supersedesPaths?: string[] | undefined;
+    previewIds?: unknown;
+}>;
+export declare const htmlPathSchema: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+export declare const createHtmlToolSchema: z.ZodObject<Omit<{} & {
+    title: z.ZodString;
+    supersedesPaths: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+    controls: z.ZodEffects<z.ZodArray<z.ZodObject<{
+        controlId: z.ZodString;
+        type: z.ZodEnum<["string", "number", "boolean", "date"]>;
+        allowedValues: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, "many">>;
+        label: z.ZodString;
+    } & {
+        defaultValue: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+    }, "strict", z.ZodTypeAny, {
+        type: "string" | "number" | "boolean" | "date";
+        controlId: string;
+        defaultValue: string | number | boolean | null;
+        label: string;
+        allowedValues?: (string | number | boolean | null)[] | undefined;
+    }, {
+        type: "string" | "number" | "boolean" | "date";
+        controlId: string;
+        defaultValue: string | number | boolean | null;
+        label: string;
+        allowedValues?: (string | number | boolean | null)[] | undefined;
+    }>, "many">, {
+        type: "string" | "number" | "boolean" | "date";
+        controlId: string;
+        defaultValue: string | number | boolean | null;
+        label: string;
+        allowedValues?: (string | number | boolean | null)[] | undefined;
+    }[], unknown>;
+    charts: z.ZodEffects<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodEnum<["bar", "line", "area", "pie", "scatter"]>;
+        datasetId: z.ZodString;
+        x: z.ZodString;
+        y: z.ZodString;
+        color: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        type: "bar" | "line" | "area" | "pie" | "scatter";
+        id: string;
+        title: string;
+        datasetId: string;
+        x: string;
+        y: string;
+        color?: string | undefined;
+    }, {
+        type: "bar" | "line" | "area" | "pie" | "scatter";
+        id: string;
+        title: string;
+        datasetId: string;
+        x: string;
+        y: string;
+        color?: string | undefined;
+    }>, "many">, {
+        type: "bar" | "line" | "area" | "pie" | "scatter";
+        id: string;
+        title: string;
+        datasetId: string;
+        x: string;
+        y: string;
+        color?: string | undefined;
+    }[], unknown>;
+    tables: z.ZodEffects<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        datasetId: z.ZodString;
+        fields: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        datasetId: string;
+        fields: string[];
+    }, {
+        id: string;
+        title: string;
+        datasetId: string;
+        fields: string[];
+    }>, "many">, {
+        id: string;
+        title: string;
+        datasetId: string;
+        fields: string[];
+    }[], unknown>;
+    previewIds: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>;
+}, "charts" | "tables"> & {
+    path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+    libraries: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["echarts", "three"]>, "many">, ("echarts" | "three")[], ("echarts" | "three")[]>>;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    title: string;
+    controls: {
+        type: "string" | "number" | "boolean" | "date";
+        controlId: string;
+        defaultValue: string | number | boolean | null;
+        label: string;
+        allowedValues?: (string | number | boolean | null)[] | undefined;
+    }[];
+    previewIds: string[];
+    supersedesPaths?: string[] | undefined;
+    libraries?: ("echarts" | "three")[] | undefined;
+}, {
+    path: string;
+    title: string;
+    controls?: unknown;
+    supersedesPaths?: string[] | undefined;
+    previewIds?: unknown;
+    libraries?: ("echarts" | "three")[] | undefined;
+}>;
+export declare function parseObjectJson(text: string): Record<string, import("@xpert-ai/contracts").JSONValue>;
+export declare function fromAgentBinding(input: z.infer<typeof agentBindingSchema>, contract: AnalyticsDiscoveryResult['queryContract']): import("@xpert-ai/contracts").AnalyticsBinding;

package/dist/lib/agent.schema.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHtmlToolSchema = exports.htmlPathSchema = exports.createToolSchema = exports.previewToolSchema = exports.agentBindingSchema = exports.discoverToolSchema = void 0;
+exports.parseObjectJson = parseObjectJson;
+exports.fromAgentBinding = fromAgentBinding;
+const v3_1 = require("zod/v3");
+const analytics_1 = require("@xpert-ai/plugin-sdk/analytics");
+const dashboard_schema_1 = require("./dashboard.schema");
+const plugin_sdk_1 = require("@xpert-ai/plugin-sdk");
+const document_libraries_1 = require("./document-libraries");
+// LLM tool schemas cannot reliably express recursive JSON unions. Only this model boundary uses JSON text.
+const objectJson = v3_1.z.string().min(2).max(64000).describe('A JSON object encoded as text. Use the exact provider-owned contract from discovery. No Markdown fences.');
+const agentControlsSchema = v3_1.z.array(dashboard_schema_1.dashboardSchema.innerType().shape.controls.element.extend({
+    defaultValue: dashboard_schema_1.dashboardSchema.innerType().shape.controls.element.shape.defaultValue.unwrap()
+        .describe('Required: copy the verified Binding parameter defaultValue, including explicit null for an all-values filter.')
+})).max(24);
+exports.discoverToolSchema = v3_1.z.object({ dataSourceId: v3_1.z.string().uuid(), providerId: v3_1.z.string().min(1).max(160),
+    requestJson: objectJson.default('{}').describe('JSON text. Start with "{}"; then JSON.stringify the returned inspectRequest/nextRequest directly. Do not wrap it in inspectRequest.') }).strict();
+exports.agentBindingSchema = analytics_1.analyticsBindingObjectSchema.omit({ payload: true, schemaVersion: true, id: true, operation: true, contractVersion: true }).extend({
+    parameters: v3_1.z.array(analytics_1.analyticsBindingObjectSchema.shape.parameters.element.omit({ controlId: true })).max(24),
+    payloadJson: objectJson
+}).strict();
+exports.previewToolSchema = v3_1.z.object({ binding: exports.agentBindingSchema }).strict();
+exports.createToolSchema = dashboard_schema_1.dashboardSchema.innerType().omit({ schema: true, id: true, bindings: true, presentation: true }).extend({
+    title: dashboard_schema_1.dashboardSchema.innerType().shape.title.describe('Saved Artifact title. When renaming an HTML dashboard, include the new title in the SAME dashboard_update call as htmlPath; changing the HTML heading alone does not rename the saved Artifact.'),
+    supersedesPaths: v3_1.z.array(plugin_sdk_1.workspaceRelativeFilePathSchema).max(16).optional().describe('Explicitly abandon earlier unsaved HTML creation candidates after this dashboard saves successfully. Copy exact pending paths; never include an Artifact editing copy. Files are not deleted or claimed as saved. Also use when choosing a standard dashboard instead of an HTML prototype.'),
+    controls: (0, plugin_sdk_1.jsonEncodedSchema)(agentControlsSchema),
+    charts: (0, plugin_sdk_1.jsonEncodedSchema)(dashboard_schema_1.dashboardSchema.innerType().shape.charts),
+    tables: (0, plugin_sdk_1.jsonEncodedSchema)(dashboard_schema_1.dashboardSchema.innerType().shape.tables),
+    previewIds: (0, plugin_sdk_1.jsonEncodedSchema)(v3_1.z.array(v3_1.z.string().min(1)).min(1).max(8).describe('Exact previewId receipts from successful dashboard_preview calls. Do not repeat bindings.'))
+}).strict();
+exports.htmlPathSchema = plugin_sdk_1.workspaceRelativeFilePathSchema.refine(path => {
+    const name = path.split('/').at(-1) ?? '';
+    return path.length <= 300 && /\.html$/i.test(name) && name.slice(0, -5).trim().length > 0 && !name.startsWith('.');
+}, 'Use a named HTML file such as dashboards/sales.html; .html alone is not a dashboard filename.')
+    .describe('Workspace-relative HTML file created or edited with SandboxFile, for example dashboards/sales.html. Copy the complete htmlPath from dashboard_open when editing.');
+exports.createHtmlToolSchema = exports.createToolSchema.omit({ charts: true, tables: true }).extend({ path: exports.htmlPathSchema,
+    libraries: document_libraries_1.libraryRequestsSchema.optional().describe('Bundled library IDs from dashboard_libraries. Omit for native SVG/Canvas/DOM; use ["echarts"] for ECharts or ["three"] for Three.js.') }).strict();
+function parseObjectJson(text) {
+    try {
+        return analytics_1.analyticsOptionsSchema.parse(JSON.parse(text));
+    }
+    catch {
+        throw new Error('DASHBOARD_INVALID_JSON: supply a JSON object encoded as text, matching the returned provider contract');
+    }
+}
+function fromAgentBinding(input, contract) {
+    const { payloadJson, ...binding } = input;
+    return analytics_1.analyticsBindingSchema.parse({ ...binding, schemaVersion: 1, id: input.output.datasetId,
+        operation: contract.operation, contractVersion: contract.contractVersion,
+        parameters: input.parameters.map(parameter => ({ ...parameter, controlId: parameter.name })), payload: parseObjectJson(payloadJson) });
+}

package/dist/lib/dashboard-icon.d.ts

@@ -0,0 +1,5 @@
+/** Self-contained for hosts that do not load the plugin's icon font. */
+export declare const dashboardIcon: {
+    type: "svg";
+    value: string;
+};

package/dist/lib/dashboard-icon.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dashboardIcon = void 0;
+/** Self-contained for hosts that do not load the plugin's icon font. */
+exports.dashboardIcon = {
+    type: 'svg',
+    value: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="18" height="18" rx="3"/><path d="M7 16v-4m5 4V7m5 9v-6"/></svg>'
+};

package/dist/lib/dashboard-navigation.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod/v3';
+export declare const DASHBOARD_VIEW_KEY = "live-dashboard__live-dashboard";
+export declare const dashboardNavigationSchema: z.ZodEffects<z.ZodObject<{
+    selectionId: z.ZodOptional<z.ZodString>;
+    parameters: z.ZodOptional<z.ZodObject<{
+        artifactId: z.ZodOptional<z.ZodString>;
+        versionId: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        artifactId?: string | undefined;
+        versionId?: string | undefined;
+    }, {
+        artifactId?: string | undefined;
+        versionId?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    selectionId?: string | undefined;
+    parameters?: {
+        artifactId?: string | undefined;
+        versionId?: string | undefined;
+    } | undefined;
+}, {
+    selectionId?: string | undefined;
+    parameters?: {
+        artifactId?: string | undefined;
+        versionId?: string | undefined;
+    } | undefined;
+}>, {
+    artifactId: string | undefined;
+    versionId: string | undefined;
+}, {
+    selectionId?: string | undefined;
+    parameters?: {
+        artifactId?: string | undefined;
+        versionId?: string | undefined;
+    } | undefined;
+}>;
+export type DashboardNavigation = z.infer<typeof dashboardNavigationSchema>;
+export declare const dashboardNavigationKey: (target: DashboardNavigation) => string;