@xpert-ai/plugin-live-dashboard 0.4.1 → 0.6.0

package/.xpertai-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/plugin-live-dashboard",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "level": "system",
   "artifactNamespace": "live_dashboard",
   "sandboxActions": "./dist/sandbox-actions/action.json",

package/README.md

@@ -4,6 +4,12 @@ System plugin `@xpert-ai/plugin-live-dashboard`: versioned live dashboards using
 
 See [implementation and installed-runtime acceptance](docs/acceptance.md) and [one-sentence Agent acceptance](docs/agent-acceptance.md). `examples/` contains equivalent PostgreSQL and data-xpert bindings for the same chart.
 
+Sources, component Inspect and portable dashboard archives are tracked in the
+[feature guide](docs/sources-inspect-portability.mdx) and
+[current acceptance record](docs/sources-inspect-portability-acceptance.mdx).
+
+Large dashboards now support 32 Bindings by default (64 protocol ceiling), bounded query scheduling, batch preview/filter validation and durable save progress. See the [feature guide](docs/large-dashboards.mdx) and [acceptance record](docs/large-dashboards-acceptance.mdx). These features require published SDK/contracts 3.33.0 or later; no SDK patch is required.
+
 ## Ownership and flow
 
 ```text
@@ -190,7 +196,7 @@ See [HTML mode and acceptance](docs/html-mode.md). Agent tools write a complete
 
 The platform browser entry `@xpert-ai/plugin-sdk/artifact-document` owns the sandbox, CSP, MessageChannel, request validation and latest-response policy. The plugin owns lifecycle and supplies a narrow callback to `query-binding`. Its server loads the exact saved Artifact version, finds the declared Binding, validates controls and rechecks source access. The endpoint rejects full Binding, Provider, SQL/payload and alternate source fields.
 
-HTML preflight checks each native select's alternative/restored values and each button path in a fresh document mount, with at most two pages active. A button path also clicks controls it inserts, reveals or enables, retaining their prerequisite state and the same query quota; traversal is bounded to the first 12 buttons and 12 clicks per path. Every scenario checks initial bindings and host refresh using the same preview datasets. Successful static resources can be reused within this validation (bounded to 32 MB, up to 8 MB per resource); every replay still passes the resource policy, and failed, redirected or non-cacheable responses are not replayed. A 55-second validation deadline fails closed and cancels remaining pages before the host's 60-second Action limit. This prevents repeated resource downloads and the synthetic interaction sweep from exhausting the Action budget or one document's rate window without raising the SDK's query/concurrency limits. A request storm within a scenario still blocks saving; preflight is not a full combinatorial or sustained-load test.
+HTML preflight checks each native select's alternative/restored values and each button path in a fresh document mount, with at most two pages active. A button path also clicks controls it inserts, reveals or enables, retaining their prerequisite state and the same query quota; traversal is bounded to the first 12 buttons and 12 clicks per path. Every scenario checks initial bindings and host refresh using the same preview datasets. Successful static resources can be reused within this validation (bounded to 32 MB, up to 8 MB per resource); every replay still passes the resource policy, and failed, redirected or non-cacheable responses are not replayed. A 55-second validation deadline fails closed and cancels remaining pages before the host's 60-second Action limit. This prevents repeated resource downloads and the synthetic interaction sweep from exhausting the Action budget or one document's rate window with a separate immutable-snapshot budget of at most 16 replays per Binding; live queries remain limited to 60 dispatches per minute and concurrency 4. A request storm within a scenario still blocks saving; preflight is not a full combinatorial or sustained-load test.
 
 Pages call `window.xpertLiveArtifact.ready()`, `subscribe(bindingId, render)`, `query(bindingId, controls)` and `refresh(bindingId)`. Register subscriptions before the first query so the toolbar can refresh without resetting the document. Use inline DOM/SVG/Canvas or online scripts/styles/fonts from the HTTPS origins returned by `dashboard_libraries.online`. Tailwind CDN, jsDelivr, cdnjs, unpkg and Google Fonts are supported according to their resource-type allowlist. Preflight and the displayed page use the same policy; failed loads prevent saving. Pin online versions where possible. Unlike packaged libraries, online bytes are not part of the immutable Artifact snapshot. Direct data requests, external images, eval, workers and frames remain unavailable. Script processing remains in the separate Workspace Script provider.
 
@@ -204,7 +210,7 @@ The renderer runs in a script-only sandbox with no-network CSP. A small in-memor
 
 ## Build and validation
 
-Use the xpertai workspace's declared Corepack/pnpm. Development dependencies pin published SDK/contracts 3.27.0 and the Data Analytics renderer 0.1.35; no local platform or community links are required. SDK 3.27.0 includes the host-owned online resource policy, so no SDK patch is required. Rebuild both the viewer and HTML preflight assets after changing the SDK; `verify:dist` checks their source fingerprints.
+Use the xpertai workspace's declared Corepack/pnpm. Development dependencies pin published SDK/contracts 3.33.0 and the Data Analytics renderer 0.1.35; no local platform or community links are required. SDK 3.33.0 supplies the host-owned online resource policy, bounded query scheduler and grouped query runtime without a local SDK patch. Rebuild both the viewer and HTML preflight assets after changing the SDK; `verify:dist` checks their source fingerprints.
 
 ```sh
 corepack pnpm install --frozen-lockfile

package/dist/index.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const capacity_1 = require("./lib/capacity");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const plugin_1 = require("./lib/plugin");
@@ -18,7 +19,8 @@ const plugin = {
                         { type: 'assistant-template', name: assistant_template_1.DASHBOARD_TEMPLATE_KEY, displayName: assistant_template_1.dashboardAssistantTemplate.title, description: assistant_template_1.dashboardAssistantTemplate.description }
                     ] } } }
     },
+    config: { schema: capacity_1.dashboardConfigSchema },
     templates: templates_1.dashboardTemplates,
-    register: () => ({ module: plugin_1.LiveDashboardPlugin })
+    register: context => ({ module: plugin_1.LiveDashboardPlugin, providers: [{ provide: capacity_1.DASHBOARD_CONFIG, useValue: capacity_1.dashboardConfigSchema.parse(context.config ?? {}) }] })
 };
 exports.default = plugin;

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

@@ -15,6 +15,7 @@ export declare const discoverToolSchema: z.ZodObject<{
 }>;
 export declare const agentBindingSchema: z.ZodObject<{
     source: z.ZodType<import("@xpert-ai/contracts").AnalyticsSourceRef, z.ZodTypeDef, import("@xpert-ai/contracts").AnalyticsSourceRef>;
+    providerId: z.ZodString;
     output: z.ZodObject<{
         datasetId: z.ZodString;
         fields: z.ZodArray<z.ZodObject<{
@@ -73,7 +74,6 @@ export declare const agentBindingSchema: z.ZodObject<{
         }[];
         grain?: string[];
     }>;
-    providerId: z.ZodString;
 } & {
     parameters: z.ZodArray<z.ZodObject<Omit<{
         name: z.ZodString;
@@ -98,6 +98,7 @@ export declare const agentBindingSchema: z.ZodObject<{
     payloadJson: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+    providerId: string;
     output: {
         datasetId?: string;
         fields?: {
@@ -119,10 +120,10 @@ export declare const agentBindingSchema: z.ZodObject<{
         defaultValue?: string | number | boolean | null | undefined;
         allowedValues?: (string | number | boolean | null)[] | undefined;
     }[];
-    providerId: string;
     payloadJson: string;
 }, {
     source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+    providerId: string;
     output: {
         datasetId?: string;
         fields?: {
@@ -144,12 +145,12 @@ export declare const agentBindingSchema: z.ZodObject<{
         defaultValue?: string | number | boolean | null | undefined;
         allowedValues?: (string | number | boolean | null)[] | undefined;
     }[];
-    providerId: string;
     payloadJson: string;
 }>;
 export declare const previewToolSchema: z.ZodObject<{
     binding: z.ZodObject<{
         source: z.ZodType<import("@xpert-ai/contracts").AnalyticsSourceRef, z.ZodTypeDef, import("@xpert-ai/contracts").AnalyticsSourceRef>;
+        providerId: z.ZodString;
         output: z.ZodObject<{
             datasetId: z.ZodString;
             fields: z.ZodArray<z.ZodObject<{
@@ -208,7 +209,6 @@ export declare const previewToolSchema: z.ZodObject<{
             }[];
             grain?: string[];
         }>;
-        providerId: z.ZodString;
     } & {
         parameters: z.ZodArray<z.ZodObject<Omit<{
             name: z.ZodString;
@@ -233,6 +233,7 @@ export declare const previewToolSchema: z.ZodObject<{
         payloadJson: z.ZodString;
     }, "strict", z.ZodTypeAny, {
         source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+        providerId: string;
         output: {
             datasetId?: string;
             fields?: {
@@ -254,10 +255,10 @@ export declare const previewToolSchema: z.ZodObject<{
             defaultValue?: string | number | boolean | null | undefined;
             allowedValues?: (string | number | boolean | null)[] | undefined;
         }[];
-        providerId: string;
         payloadJson: string;
     }, {
         source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+        providerId: string;
         output: {
             datasetId?: string;
             fields?: {
@@ -279,12 +280,12 @@ export declare const previewToolSchema: z.ZodObject<{
             defaultValue?: string | number | boolean | null | undefined;
             allowedValues?: (string | number | boolean | null)[] | undefined;
         }[];
-        providerId: string;
         payloadJson: string;
     }>;
 }, "strict", z.ZodTypeAny, {
     binding: {
         source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+        providerId: string;
         output: {
             datasetId?: string;
             fields?: {
@@ -306,12 +307,12 @@ export declare const previewToolSchema: z.ZodObject<{
             defaultValue?: string | number | boolean | null | undefined;
             allowedValues?: (string | number | boolean | null)[] | undefined;
         }[];
-        providerId: string;
         payloadJson: string;
     };
 }, {
     binding: {
         source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+        providerId: string;
         output: {
             datasetId?: string;
             fields?: {
@@ -333,7 +334,6 @@ export declare const previewToolSchema: z.ZodObject<{
             defaultValue?: string | number | boolean | null | undefined;
             allowedValues?: (string | number | boolean | null)[] | undefined;
         }[];
-        providerId: string;
         payloadJson: string;
     };
 }>;
@@ -377,24 +377,24 @@ export declare const createToolSchema: z.ZodObject<{} & {
         color: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
         type: "bar" | "line" | "area" | "pie" | "scatter";
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         x: string;
         y: string;
         color?: string | undefined;
     }, {
         type: "bar" | "line" | "area" | "pie" | "scatter";
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         x: string;
         y: string;
         color?: string | undefined;
     }>, "many">, {
         type: "bar" | "line" | "area" | "pie" | "scatter";
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         x: string;
         y: string;
@@ -406,21 +406,81 @@ export declare const createToolSchema: z.ZodObject<{} & {
         datasetId: z.ZodString;
         fields: z.ZodArray<z.ZodString, "many">;
     }, "strict", z.ZodTypeAny, {
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         fields: string[];
     }, {
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         fields: string[];
     }>, "many">, {
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         fields: string[];
     }[], unknown>;
+    sourceMetadata: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
+        bindingId: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        bindingId: string;
+        title: string;
+        description?: string | undefined;
+    }, {
+        bindingId: string;
+        title: string;
+        description?: string | undefined;
+    }>, "many">, {
+        bindingId: string;
+        title: string;
+        description?: string | undefined;
+    }[], unknown>>;
+    components: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        elementId: z.ZodString;
+        title: z.ZodString;
+        kind: z.ZodEnum<["metric", "chart", "table", "filter", "text"]>;
+        sources: z.ZodArray<z.ZodObject<{
+            bindingId: z.ZodString;
+            fieldIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }, {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        title: string;
+        id: string;
+        elementId: string;
+        kind: "filter" | "metric" | "chart" | "table" | "text";
+        sources: {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }[];
+    }, {
+        title: string;
+        id: string;
+        elementId: string;
+        kind: "filter" | "metric" | "chart" | "table" | "text";
+        sources: {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }[];
+    }>, "many">, {
+        title: string;
+        id: string;
+        elementId: string;
+        kind: "filter" | "metric" | "chart" | "table" | "text";
+        sources: {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }[];
+    }[], unknown>>;
     previewIds: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>;
 }, "strict", z.ZodTypeAny, {
     title: string;
@@ -433,24 +493,41 @@ export declare const createToolSchema: z.ZodObject<{} & {
     }[];
     charts: {
         type: "bar" | "line" | "area" | "pie" | "scatter";
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         x: string;
         y: string;
         color?: string | undefined;
     }[];
     tables: {
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         fields: string[];
     }[];
     previewIds: string[];
+    sourceMetadata?: {
+        bindingId: string;
+        title: string;
+        description?: string | undefined;
+    }[] | undefined;
+    components?: {
+        title: string;
+        id: string;
+        elementId: string;
+        kind: "filter" | "metric" | "chart" | "table" | "text";
+        sources: {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }[];
+    }[] | undefined;
     creationIntent?: "new" | "copy" | undefined;
     supersedesPaths?: string[] | undefined;
 }, {
     title: string;
+    sourceMetadata?: unknown;
+    components?: unknown;
     controls?: unknown;
     charts?: unknown;
     tables?: unknown;
@@ -499,24 +576,24 @@ export declare const createHtmlToolSchema: z.ZodObject<Omit<{} & {
         color: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
         type: "bar" | "line" | "area" | "pie" | "scatter";
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         x: string;
         y: string;
         color?: string | undefined;
     }, {
         type: "bar" | "line" | "area" | "pie" | "scatter";
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         x: string;
         y: string;
         color?: string | undefined;
     }>, "many">, {
         type: "bar" | "line" | "area" | "pie" | "scatter";
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         x: string;
         y: string;
@@ -528,21 +605,81 @@ export declare const createHtmlToolSchema: z.ZodObject<Omit<{} & {
         datasetId: z.ZodString;
         fields: z.ZodArray<z.ZodString, "many">;
     }, "strict", z.ZodTypeAny, {
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         fields: string[];
     }, {
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         fields: string[];
     }>, "many">, {
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         fields: string[];
     }[], unknown>;
+    sourceMetadata: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
+        bindingId: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        bindingId: string;
+        title: string;
+        description?: string | undefined;
+    }, {
+        bindingId: string;
+        title: string;
+        description?: string | undefined;
+    }>, "many">, {
+        bindingId: string;
+        title: string;
+        description?: string | undefined;
+    }[], unknown>>;
+    components: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        elementId: z.ZodString;
+        title: z.ZodString;
+        kind: z.ZodEnum<["metric", "chart", "table", "filter", "text"]>;
+        sources: z.ZodArray<z.ZodObject<{
+            bindingId: z.ZodString;
+            fieldIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }, {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        title: string;
+        id: string;
+        elementId: string;
+        kind: "filter" | "metric" | "chart" | "table" | "text";
+        sources: {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }[];
+    }, {
+        title: string;
+        id: string;
+        elementId: string;
+        kind: "filter" | "metric" | "chart" | "table" | "text";
+        sources: {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }[];
+    }>, "many">, {
+        title: string;
+        id: string;
+        elementId: string;
+        kind: "filter" | "metric" | "chart" | "table" | "text";
+        sources: {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }[];
+    }[], unknown>>;
     previewIds: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>;
 }, "charts" | "tables"> & {
     path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
@@ -558,17 +695,34 @@ export declare const createHtmlToolSchema: z.ZodObject<Omit<{} & {
         allowedValues?: (string | number | boolean | null)[] | undefined;
     }[];
     previewIds: string[];
+    sourceMetadata?: {
+        bindingId: string;
+        title: string;
+        description?: string | undefined;
+    }[] | undefined;
+    components?: {
+        title: string;
+        id: string;
+        elementId: string;
+        kind: "filter" | "metric" | "chart" | "table" | "text";
+        sources: {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }[];
+    }[] | undefined;
     creationIntent?: "new" | "copy" | undefined;
     supersedesPaths?: string[] | undefined;
     libraries?: ("echarts" | "three" | "trend-workspace" | "profit-atlas" | "customer-brief")[] | undefined;
 }, {
     path: string;
     title: string;
+    sourceMetadata?: unknown;
+    components?: unknown;
     controls?: unknown;
     creationIntent?: "new" | "copy" | undefined;
     supersedesPaths?: string[] | undefined;
     previewIds?: unknown;
     libraries?: ("echarts" | "three" | "trend-workspace" | "profit-atlas" | "customer-brief")[] | undefined;
 }>;
-export declare function parseObjectJson(text: string): Record<string, import("@xpert-ai/contracts").JSONValue>;
+export declare function parseObjectJson(text: string, field?: 'requestJson' | 'binding.payloadJson'): 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

@@ -3,11 +3,13 @@ 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 capacity_1 = require("./capacity");
 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");
+const json_input_1 = require("./json-input");
 // 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({
@@ -28,7 +30,9 @@ exports.createToolSchema = dashboard_schema_1.dashboardSchema.innerType().omit({
     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.'))
+    sourceMetadata: (0, plugin_sdk_1.jsonEncodedSchema)(dashboard_schema_1.dashboardSchema.innerType().shape.sourceMetadata.unwrap()).optional(),
+    components: (0, plugin_sdk_1.jsonEncodedSchema)(dashboard_schema_1.dashboardSchema.innerType().shape.components.unwrap()).optional(),
+    previewIds: (0, plugin_sdk_1.jsonEncodedSchema)(v3_1.z.array(v3_1.z.string().min(1)).min(1).max(capacity_1.MAX_DASHBOARD_BINDINGS).describe('Exact current-run previewId receipts from successful dashboard_preview or dashboard_preview_binding calls. For updates, changed bindings upsert by stable binding.id; omitted bindings remain. Keep every intended changed/new binding receipt when retrying a failed save. Do not repeat bindings.'))
 }).strict();
 exports.htmlPathSchema = plugin_sdk_1.workspaceRelativeFilePathSchema.refine(path => {
     const name = path.split('/').at(-1) ?? '';
@@ -37,17 +41,15 @@ exports.htmlPathSchema = plugin_sdk_1.workspaceRelativeFilePathSchema.refine(pat
     .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 IDs from dashboard_libraries. Omit for native SVG/Canvas/DOM; use echarts or three for charts. Optional: add exactly one visual theme (trend-workspace, profit-atlas, customer-brief) with echarts. Preserve the saved theme unless a change is requested.') }).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 parseObjectJson(text, field = 'requestJson') {
+    const parsed = analytics_1.analyticsOptionsSchema.safeParse((0, json_input_1.parseJsonInput)(text, field));
+    if (!parsed.success)
+        throw new Error(`DASHBOARD_INVALID_JSON: ${field} is valid JSON but must be an object matching the returned provider contract; arrays, null and scalar values are not accepted.`);
+    return parsed.data;
 }
 function fromAgentBinding(input, contract) {
     const { payloadJson, ...binding } = input;
     return analytics_1.analyticsBindingSchema.parse({ ...binding, id: input.output.datasetId,
         operation: contract.operation, contractVersion: contract.contractVersion,
-        parameters: input.parameters.map(parameter => ({ ...parameter, controlId: parameter.name })), payload: parseObjectJson(payloadJson) });
+        parameters: input.parameters.map(parameter => ({ ...parameter, controlId: parameter.name })), payload: parseObjectJson(payloadJson, 'binding.payloadJson') });
 }