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

package/dist/lib/dashboard.schema.js

@@ -1,13 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.queryBindingSchema = exports.querySchema = exports.saveSchema = exports.controlsSchema = exports.dashboardChangesSchema = exports.dashboardSchema = void 0;
+const capacity_1 = require("./capacity");
 const v3_1 = require("zod/v3");
 const analytics_1 = require("@xpert-ai/plugin-sdk/analytics");
 const artifact_document_1 = require("@xpert-ai/plugin-sdk/artifact-document");
+const dashboard_sources_1 = require("./dashboard-sources");
 const id = v3_1.z.string().regex(/^[A-Za-z][A-Za-z0-9_.-]{0,79}$/);
 exports.dashboardSchema = v3_1.z.object({
     schema: v3_1.z.literal('xpert.live-dashboard'), id: v3_1.z.string().uuid(), title: v3_1.z.string().min(1).max(160),
-    bindings: v3_1.z.array(analytics_1.analyticsBindingSchema).max(8),
+    bindings: v3_1.z.array(analytics_1.analyticsBindingSchema).max(capacity_1.MAX_DASHBOARD_BINDINGS),
+    sourceMetadata: dashboard_sources_1.sourceMetadataSchema.optional(),
+    components: dashboard_sources_1.dashboardComponentsSchema.optional(),
     presentation: v3_1.z.object({ type: v3_1.z.literal('html'), html: artifact_document_1.artifactDocumentHtml, dependencies: artifact_document_1.artifactDocumentDependencyLocks.optional() }).strict().optional(),
     controls: v3_1.z.array(v3_1.z.object({ controlId: id, type: v3_1.z.enum(['string', 'number', 'boolean', 'date']),
         defaultValue: v3_1.z.union([v3_1.z.string(), v3_1.z.number(), v3_1.z.boolean(), v3_1.z.null()]).optional(),
@@ -25,6 +29,20 @@ exports.dashboardSchema = v3_1.z.object({
         ctx.addIssue({ code: 'custom', message: 'An unconfigured draft must contain no views or controls' });
     unique(manifest.bindings.map((binding) => binding.id), 'binding');
     unique(manifest.bindings.map((binding) => binding.output.datasetId), 'dataset');
+    unique((manifest.sourceMetadata ?? []).map(item => item.bindingId), 'source metadata');
+    unique((manifest.components ?? []).map(item => item.id), 'component');
+    unique((manifest.components ?? []).map(item => item.elementId), 'component element');
+    for (const metadata of manifest.sourceMetadata ?? [])
+        if (!manifest.bindings.some(binding => binding.id === metadata.bindingId))
+            ctx.addIssue({ code: 'custom', message: 'Source metadata references an undeclared Binding' });
+    for (const component of manifest.components ?? []) {
+        unique(component.sources.map(source => source.bindingId), 'component source');
+        for (const source of component.sources) {
+            const binding = manifest.bindings.find(item => item.id === source.bindingId);
+            if (!binding || source.fieldIds?.some(field => !binding.output.fields.some(item => item.id === field)))
+                ctx.addIssue({ code: 'custom', message: 'Component references an undeclared Binding or field' });
+        }
+    }
     unique(manifest.controls.map((control) => control.controlId), 'control');
     unique([...manifest.charts, ...manifest.tables].map((view) => view.id), 'view');
     if (manifest.bindings.length && !manifest.presentation && !manifest.charts.length && !manifest.tables.length)
@@ -68,7 +86,7 @@ exports.dashboardSchema = v3_1.z.object({
 });
 /** Updates never choose identity or source scope; those come from the authorized saved version. */
 exports.dashboardChangesSchema = exports.dashboardSchema.innerType().pick({ title: true, bindings: true,
-    controls: true, charts: true, tables: true, presentation: true }).partial().strict();
+    controls: true, charts: true, tables: true, presentation: true, sourceMetadata: true, components: true }).partial().strict();
 exports.controlsSchema = v3_1.z.record(v3_1.z.union([v3_1.z.string().max(4000), v3_1.z.number().finite(), v3_1.z.boolean(), v3_1.z.null()]));
 exports.saveSchema = v3_1.z.object({ manifest: exports.dashboardSchema, expectedVersionId: v3_1.z.string().uuid().nullable(), expectedRevision: v3_1.z.number().int().nonnegative().default(0) }).strict();
 exports.querySchema = v3_1.z.object({ artifactId: v3_1.z.string().uuid(), versionId: v3_1.z.string().uuid().optional(), draftRevision: v3_1.z.number().int().positive().optional(), controls: exports.controlsSchema.default({}) }).strict();

package/dist/lib/dashboard.service.d.ts

@@ -1,13 +1,23 @@
+import { type DashboardConfig } from './capacity';
 import type { AnalyticsValue, AnalyticsDiscoveryRequest, AnalyticsQueryRequest, XpertResolvedViewHostContext } from '@xpert-ai/contracts';
 import { type RuntimeCapabilityRegistry } from '@xpert-ai/plugin-sdk';
 import { type DashboardManifest, type DashboardChanges } from './dashboard.schema';
+import { type ArtifactDocumentDependencyAsset } from '@xpert-ai/plugin-sdk/artifact-document';
 import { HtmlDashboardValidation } from './html-validation';
 import type { DashboardAccess, DashboardMode } from './project';
 export declare const PLUGIN_NAME = "@xpert-ai/plugin-live-dashboard";
+export type SaveProgress = (stage: string, completed: number, total: number) => Promise<void>;
+export type SaveOptions = {
+    requestId: string;
+    progress: SaveProgress;
+};
 export declare class DashboardService {
     private readonly runtime;
     private readonly htmlValidation;
-    constructor(runtime: RuntimeCapabilityRegistry, htmlValidation: HtmlDashboardValidation);
+    private readonly config?;
+    constructor(runtime: RuntimeCapabilityRegistry, htmlValidation: HtmlDashboardValidation, config?: DashboardConfig | undefined);
+    get maxBindings(): number;
+    assertCapacity(count: number, previousCount?: number): void;
     sources(context: XpertResolvedViewHostContext): Promise<import("@xpert-ai/contracts").AnalyticsSourceSummary[]>;
     discover(context: XpertResolvedViewHostContext, input: AnalyticsDiscoveryRequest): Promise<import("@xpert-ai/contracts").AnalyticsDiscoveryResult>;
     preview(context: XpertResolvedViewHostContext, input: AnalyticsQueryRequest): Promise<import("@xpert-ai/contracts").AnalyticalDataset>;
@@ -63,7 +73,17 @@ export declare class DashboardService {
     trash(context: XpertResolvedViewHostContext, artifactId: string, expectedRevision: number): Promise<{
         artifactId: string;
     }>;
-    save(context: XpertResolvedViewHostContext, manifest: DashboardManifest, expectedVersionId: string | null, expectedRevision?: number): Promise<{
+    previousBindingCount(context: XpertResolvedViewHostContext, manifest: DashboardManifest): Promise<number>;
+    /** Read-only reconciliation of a completed CAS after a worker/status-store interruption. */
+    savedRequestReceipt(context: XpertResolvedViewHostContext, manifestId: string, requestId: string, expectedRevision: number): Promise<{
+        artifactId: string;
+        draftId: string;
+        draftRevision: number;
+        baseVersionId: string | null;
+        status: "draft";
+        title: string;
+    } | null>;
+    save(context: XpertResolvedViewHostContext, manifest: DashboardManifest, expectedVersionId: string | null, expectedRevision?: number, importedDependencies?: ArtifactDocumentDependencyAsset[], task?: SaveOptions): Promise<{
         artifactId: string;
         draftId: string;
         draftRevision: number;
@@ -73,9 +93,9 @@ export declare class DashboardService {
     }>;
     open(context: XpertResolvedViewHostContext, artifactId: string, versionId?: string, draftRevision?: number, mode?: DashboardMode): Promise<{
         manifest: {
-            schema: "xpert.live-dashboard";
-            id: string;
             title: string;
+            id: string;
+            schema: "xpert.live-dashboard";
             bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
             controls: {
                 type: "string" | "number" | "boolean" | "date";
@@ -86,19 +106,34 @@ export declare class DashboardService {
             }[];
             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[];
             }[];
+            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;
             presentation?: {
                 type: "html";
                 html: string;
@@ -119,9 +154,9 @@ export declare class DashboardService {
     /** Trusted View transport only. Agent read tools receive locks, never megabytes of library code. */
     openDocument(context: XpertResolvedViewHostContext, artifactId: string, versionId?: string, draftRevision?: number, mode?: DashboardMode): Promise<{
         manifest: {
-            schema: "xpert.live-dashboard";
-            id: string;
             title: string;
+            id: string;
+            schema: "xpert.live-dashboard";
             bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
             controls: {
                 type: "string" | "number" | "boolean" | "date";
@@ -132,26 +167,41 @@ export declare class DashboardService {
             }[];
             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[];
             }[];
+            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;
             presentation?: {
                 type: "html";
                 html: string;
                 dependencies?: import("@xpert-ai/plugin-sdk/artifact-document").ArtifactDocumentDependencyLock[] | undefined;
             } | undefined;
         };
-        dependencies: import("@xpert-ai/plugin-sdk/artifact-document").ArtifactDocumentDependencyAsset[];
+        dependencies: ArtifactDocumentDependencyAsset[];
         contentHash: string;
         draftId?: string | undefined;
         draftRevision?: number | undefined;
@@ -250,9 +300,9 @@ export declare class DashboardService {
             reason: "unavailable";
         }[];
         manifest: {
-            schema: "xpert.live-dashboard";
-            id: string;
             title: string;
+            id: string;
+            schema: "xpert.live-dashboard";
             bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
             controls: {
                 type: "string" | "number" | "boolean" | "date";
@@ -263,19 +313,34 @@ export declare class DashboardService {
             }[];
             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[];
             }[];
+            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;
             presentation?: {
                 type: "html";
                 html: string;

package/dist/lib/dashboard.service.js

@@ -14,10 +14,14 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DashboardService = exports.PLUGIN_NAME = void 0;
 exports.projectId = projectId;
+const capacity_1 = require("./capacity");
+const bounded_map_1 = require("./bounded-map");
 const common_1 = require("@nestjs/common");
 const node_crypto_1 = require("node:crypto");
 const plugin_sdk_1 = require("@xpert-ai/plugin-sdk");
 const dashboard_schema_1 = require("./dashboard.schema");
+const source_validation_1 = require("./source-validation");
+const artifact_document_1 = require("@xpert-ai/plugin-sdk/artifact-document");
 const renderer_1 = require("./renderer");
 const dashboard_queries_1 = require("./dashboard-queries");
 const html_validation_1 = require("./html-validation");
@@ -28,9 +32,19 @@ exports.PLUGIN_NAME = '@xpert-ai/plugin-live-dashboard';
 const RESOURCE_TYPE = 'live-dashboard';
 const MIME_TYPE = 'application/json';
 let DashboardService = class DashboardService {
-    constructor(runtime, htmlValidation) {
+    constructor(runtime, htmlValidation, config) {
         this.runtime = runtime;
         this.htmlValidation = htmlValidation;
+        this.config = config;
+    }
+    get maxBindings() { return this.config?.maxBindings ?? capacity_1.DEFAULT_DASHBOARD_BINDINGS; }
+    assertCapacity(count, previousCount = 0) {
+        try {
+            (0, capacity_1.assertBindingCapacity)(count, previousCount, this.maxBindings);
+        }
+        catch (error) {
+            throw new common_1.BadRequestException(error instanceof Error ? error.message : 'DASHBOARD_BINDING_CAPACITY');
+        }
     }
     async sources(context) { await this.authorizeProject(context); return this.runtime.require(plugin_sdk_1.AnalyticsRuntimeCapability).list(actor(context)); }
     async discover(context, input) { await this.authorizeProject(context); return this.runtime.require(plugin_sdk_1.AnalyticsRuntimeCapability).discover(actor(context), input); }
@@ -98,10 +112,35 @@ let DashboardService = class DashboardService {
         await this.runtime.require(plugin_sdk_1.ArtifactDraftsRuntimeCapability).setRecycled({ artifactId, expectedRevision, recycled: true });
         return { artifactId };
     }
-    async save(context, manifest, expectedVersionId, expectedRevision = 0) {
+    async previousBindingCount(context, manifest) {
+        await this.authorizeProject(context, 'write');
+        const existing = await this.runtime.require(plugin_sdk_1.ArtifactsRuntimeCapability).findArtifactBySource({ pluginName: exports.PLUGIN_NAME, resourceType: RESOURCE_TYPE, resourceId: `${hostPrefix(context)}${manifest.id}` });
+        if (!existing)
+            return 0;
+        assertOwned(context, existing);
+        const draft = (await this.runtime.require(plugin_sdk_1.ArtifactDraftsRuntimeCapability).list([existing.id]))[0];
+        return existing.currentVersionId || draft ? (await this.open(context, existing.id)).manifest.bindings.length : 0;
+    }
+    /** Read-only reconciliation of a completed CAS after a worker/status-store interruption. */
+    async savedRequestReceipt(context, manifestId, requestId, expectedRevision) {
+        await this.authorizeProject(context, 'write');
+        const artifact = await this.runtime.require(plugin_sdk_1.ArtifactsRuntimeCapability).findArtifactBySource({ pluginName: exports.PLUGIN_NAME, resourceType: RESOURCE_TYPE, resourceId: `${hostPrefix(context)}${manifestId}` });
+        if (!artifact)
+            return null;
+        assertOwned(context, artifact);
+        if (artifact.status !== 'active')
+            throw new common_1.ForbiddenException('DASHBOARD_ARCHIVED');
+        const draft = await this.runtime.require(plugin_sdk_1.ArtifactDraftsRuntimeCapability).get(artifact.id);
+        if (draft?.metadata?.saveRequestId !== requestId || draft.revision !== expectedRevision + 1)
+            return null;
+        return { artifactId: artifact.id, draftId: draft.id, draftRevision: draft.revision, baseVersionId: draft.baseVersionId, status: 'draft', title: draft.title ?? artifact.title ?? '' };
+    }
+    async save(context, manifest, expectedVersionId, expectedRevision = 0, importedDependencies, task) {
+        await task?.progress('authorization', 0, manifest.bindings.length);
         await this.authorizeProject(context, 'write');
         const scopedActor = actor(context);
         const parsed = dashboard_schema_1.dashboardSchema.parse(manifest);
+        (0, source_validation_1.assertComponentElements)(parsed);
         const artifacts = this.runtime.require(plugin_sdk_1.ArtifactsRuntimeCapability);
         const source = { pluginName: exports.PLUGIN_NAME, resourceType: RESOURCE_TYPE, resourceId: `${hostPrefix(context)}${parsed.id}` };
         const existing = await artifacts.findArtifactBySource(source);
@@ -112,26 +151,40 @@ let DashboardService = class DashboardService {
         }
         // A failed first upload can leave an Artifact with no saved content; revision 0 initializes it.
         const previous = existing && (existing.currentVersionId || expectedRevision > 0) ? await this.openDocument(context, existing.id) : null;
-        const dependencies = await (0, document_libraries_1.resolveLibraryAssets)(parsed.presentation?.dependencies ?? [], previous?.dependencies);
+        this.assertCapacity(parsed.bindings.length, previous?.manifest.bindings.length ?? 0);
+        if (importedDependencies && existing)
+            throw new common_1.BadRequestException('DASHBOARD_IMPORT_NEW_ID_REQUIRED');
+        const dependencies = importedDependencies ? (0, artifact_document_1.verifyArtifactDocumentDependencies)(importedDependencies, parsed.presentation?.dependencies ?? [])
+            : await (0, document_libraries_1.resolveLibraryAssets)(parsed.presentation?.dependencies ?? [], previous?.dependencies);
         const buffer = (0, document_package_1.encodeDashboardPackage)(parsed, dependencies);
         if (buffer.byteLength > document_package_1.MAX_DASHBOARD_PACKAGE_BYTES)
             throw new common_1.BadRequestException('DASHBOARD_MANIFEST_TOO_LARGE');
         const digest = (0, node_crypto_1.createHash)('sha256').update(buffer).digest('hex');
+        if (existing && task) {
+            const draft = await this.runtime.require(plugin_sdk_1.ArtifactDraftsRuntimeCapability).get(existing.id);
+            if (draft?.metadata?.saveRequestId === task.requestId && draft.sha256 === digest && draft.revision === expectedRevision + 1)
+                return { artifactId: existing.id, draftId: draft.id, draftRevision: draft.revision, baseVersionId: draft.baseVersionId, status: 'draft', title: parsed.title };
+        }
         if ((existing?.currentVersionId ?? null) !== expectedVersionId)
             throw new common_1.ConflictException('DASHBOARD_VERSION_CONFLICT');
         // Recheck current data access even for an idempotent retry; the platform enforces the final CAS under a row lock.
-        const preview = await this.execute(context, parsed, Object.fromEntries(parsed.controls.filter((control) => control.defaultValue !== undefined).map((control) => [control.controlId, control.defaultValue ?? null])));
+        const preview = await (0, dashboard_queries_1.queryDashboard)(this.runtime, actor(context), parsed, Object.fromEntries(parsed.controls.filter((control) => control.defaultValue !== undefined).map((control) => [control.controlId, control.defaultValue ?? null])), task ? completed => task.progress('queries', completed, parsed.bindings.length) : undefined);
         if (!parsed.presentation)
             (0, renderer_1.toDataAnalyticsPayload)(parsed, preview);
-        for (const binding of parsed.bindings)
-            await this.probeControls(context, binding, Object.fromEntries(parsed.controls.filter((control) => control.defaultValue !== undefined).map((control) => [control.controlId, control.defaultValue ?? null])));
+        let completedFilters = 0;
+        await (0, bounded_map_1.boundedMap)(parsed.bindings, async (binding) => {
+            await this.probeControls(context, binding, Object.fromEntries(parsed.controls.filter((control) => control.defaultValue !== undefined).map((control) => [control.controlId, control.defaultValue ?? null])), task ? () => task.progress('filters', completedFilters, parsed.bindings.length) : undefined);
+            await task?.progress('filters', ++completedFilters, parsed.bindings.length);
+        });
+        await task?.progress('html', 0, 1);
         const htmlValidation = await this.htmlValidation.validate(context, parsed, preview, dependencies);
+        await task?.progress('save', 0, 1);
         const artifact = existing ?? await artifacts.createArtifact({ source, type: { pluginName: exports.PLUGIN_NAME, resourceType: RESOURCE_TYPE }, kind: 'file', title: parsed.title,
             scope: { ...scopedActor, ...(projectId(context) ? { projectId: projectId(context), userId: null } : { xpertId: context.hostId }) } });
         const reference = await this.runtime.require(plugin_sdk_1.ArtifactContentRuntimeCapability).write({ artifactId: artifact.id, buffer });
         const result = await this.runtime.require(plugin_sdk_1.ArtifactDraftsRuntimeCapability).save({ artifactId: artifact.id, expectedRevision,
             expectedCurrentVersionId: expectedVersionId, mimeType: MIME_TYPE, title: parsed.title, fileName: 'dashboard.json', sha256: digest,
-            ...(htmlValidation ? { metadata: { htmlValidation } } : {}), workspaceFileRef: reference });
+            ...((htmlValidation || task) ? { metadata: { ...(htmlValidation ? { htmlValidation } : {}), ...(task ? { saveRequestId: task.requestId } : {}) } } : {}), workspaceFileRef: reference });
         return { artifactId: artifact.id, draftId: result.id, draftRevision: result.revision, baseVersionId: result.baseVersionId, status: 'draft', title: parsed.title };
     }
     async open(context, artifactId, versionId, draftRevision, mode = 'draft') {
@@ -236,7 +289,7 @@ let DashboardService = class DashboardService {
     execute(context, manifest, input) {
         return (0, dashboard_queries_1.queryDashboard)(this.runtime, actor(context), manifest, input);
     }
-    async probeControls(context, binding, input) {
+    async probeControls(context, binding, input, checkpoint) {
         const controls = Object.fromEntries(binding.parameters.map((parameter) => [parameter.controlId,
             Object.hasOwn(input, parameter.controlId) ? input[parameter.controlId] : parameter.defaultValue ?? null]));
         // A null default can bypass a native predicate entirely. Verify a real selection too,
@@ -247,6 +300,7 @@ let DashboardService = class DashboardService {
             const samples = [...(alternative !== undefined ? [alternative] : []),
                 ...(current !== null && parameter.allowedValues?.includes(null) ? [null] : [])];
             for (const value of samples) {
+                await checkpoint?.();
                 // Analytics already redacts provider failures. Preserve its actionable validation
                 // errors: a duplicate grain is not a malformed filter and needs a different repair.
                 await this.runtime.require(plugin_sdk_1.AnalyticsRuntimeCapability).query(actor(context), { binding, controls: { ...controls, [parameter.controlId]: value } });
@@ -258,7 +312,9 @@ exports.DashboardService = DashboardService;
 exports.DashboardService = DashboardService = __decorate([
     (0, common_1.Injectable)(),
     __param(0, (0, common_1.Inject)(plugin_sdk_1.XPERT_RUNTIME_CAPABILITIES_TOKEN)),
-    __metadata("design:paramtypes", [Object, html_validation_1.HtmlDashboardValidation])
+    __param(2, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Inject)(capacity_1.DASHBOARD_CONFIG)),
+    __metadata("design:paramtypes", [Object, html_validation_1.HtmlDashboardValidation, Object])
 ], DashboardService);
 function actor(context) {
     if (!context.tenantId || !context.organizationId || !context.userId || !['agent', 'project'].includes(context.hostType))

package/dist/lib/definition-tools.d.ts

@@ -31,26 +31,26 @@ export declare function createDefinitionTools(context: IAgentMiddlewareContext,
     definitionJson: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     name: string;
+    requestId: string;
     providerId: string;
     connectionKey: string;
-    requestId: string;
     definitionJson: string;
 }, {
     name: string;
+    requestId: string;
     providerId: string;
     connectionKey: string;
-    requestId: string;
     definitionJson: string;
 }>, {
     name: string;
+    requestId: string;
     providerId: string;
     connectionKey: string;
-    requestId: string;
     definitionJson: string;
 }, {
     name: string;
+    requestId: string;
     providerId: string;
     connectionKey: string;
-    requestId: string;
     definitionJson: string;
 }, string>)[];

package/dist/lib/document-host.js

@@ -6,7 +6,7 @@ const artifact_document_1 = require("@xpert-ai/plugin-sdk/artifact-document");
 const document_network_1 = require("./document-network");
 /** The HTML never supplies or overrides its network permissions. */
 function mountDashboardDocument(frame, options) {
-    return (0, artifact_document_1.mountArtifactDocument)(frame, { ...options, networkPolicy: document_network_1.DASHBOARD_NETWORK_POLICY });
+    return (0, artifact_document_1.mountArtifactDocument)(frame, { ...options, dispatchesPerMinute: 60, networkPolicy: document_network_1.DASHBOARD_NETWORK_POLICY });
 }
 function isDashboardResourceAllowed(resourceType, url) {
     return (0, artifact_document_1.isArtifactDocumentResourceAllowed)(document_network_1.DASHBOARD_NETWORK_POLICY, resourceType, url);

package/dist/lib/document-package.d.ts

@@ -5,9 +5,9 @@ export declare const MAX_DASHBOARD_PACKAGE_BYTES = 9000000;
 export declare function encodeDashboardPackage(manifest: DashboardManifest, dependencies: ArtifactDocumentDependencyAsset[]): Buffer<ArrayBuffer>;
 export declare function decodeDashboardPackage(bytes: Buffer): {
     manifest: {
-        schema: "xpert.live-dashboard";
-        id: string;
         title: string;
+        id: string;
+        schema: "xpert.live-dashboard";
         bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
         controls: {
             type: "string" | "number" | "boolean" | "date";
@@ -18,19 +18,34 @@ export declare function decodeDashboardPackage(bytes: Buffer): {
         }[];
         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[];
         }[];
+        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;
         presentation?: {
             type: "html";
             html: string;

package/dist/lib/editing-patch.d.ts

@@ -5,16 +5,19 @@ export declare const removalsSchema: z.ZodOptional<z.ZodObject<{
     controlIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     viewIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     htmlElementIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    componentIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
 }, "strict", z.ZodTypeAny, {
     bindingIds: string[];
     controlIds: string[];
     viewIds: string[];
     htmlElementIds: string[];
+    componentIds: string[];
 }, {
     bindingIds?: string[] | undefined;
     controlIds?: string[] | undefined;
     viewIds?: string[] | undefined;
     htmlElementIds?: string[] | undefined;
+    componentIds?: string[] | undefined;
 }>>;
 export declare function upsertComponents<T>(existing: T[], changes: T[] | undefined, id: (item: T) => string, removed?: string[]): T[];
 export declare function htmlElementIds(html: string): Set<string>;

package/dist/lib/editing-patch.js

@@ -4,11 +4,13 @@ exports.removalsSchema = void 0;
 exports.upsertComponents = upsertComponents;
 exports.htmlElementIds = htmlElementIds;
 exports.assertHtmlPreserved = assertHtmlPreserved;
+const capacity_1 = require("./capacity");
 const parse5_1 = require("parse5");
 const v3_1 = require("zod/v3");
 exports.removalsSchema = v3_1.z.object({
-    bindingIds: v3_1.z.array(v3_1.z.string()).max(8).default([]), controlIds: v3_1.z.array(v3_1.z.string()).max(24).default([]),
-    viewIds: v3_1.z.array(v3_1.z.string()).max(40).default([]), htmlElementIds: v3_1.z.array(v3_1.z.string()).max(500).default([])
+    bindingIds: v3_1.z.array(v3_1.z.string()).max(capacity_1.MAX_DASHBOARD_BINDINGS).default([]), controlIds: v3_1.z.array(v3_1.z.string()).max(24).default([]),
+    viewIds: v3_1.z.array(v3_1.z.string()).max(40).default([]), htmlElementIds: v3_1.z.array(v3_1.z.string()).max(500).default([]),
+    componentIds: v3_1.z.array(v3_1.z.string()).max(160).default([])
 }).strict().optional().describe('Only explicitly requested removals. Arrays of changed components otherwise upsert by stable ID and preserve omitted components.');
 function upsertComponents(existing, changes, id, removed = []) {
     if (new Set(changes?.map(id)).size !== (changes?.length ?? 0))

package/dist/lib/editing-session.d.ts

@@ -84,41 +84,41 @@ export declare const dashboardStateSchema: z.ZodObject<{
             draftRevision?: number | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
+        scope: string;
         target: {
             artifactId: string;
             schemaVersion: 1;
             versionId?: string | undefined;
             draftRevision?: number | undefined;
         } | null;
-        scope: string;
     }, {
+        scope: string;
         target: {
             artifactId: string;
             schemaVersion: 1;
             versionId?: string | undefined;
             draftRevision?: number | undefined;
         } | null;
-        scope: string;
     }>>>;
 }, "strip", z.ZodTypeAny, {
     dashboardEditing?: {
+        scope: string;
         target: {
             artifactId: string;
             schemaVersion: 1;
             versionId?: string | undefined;
             draftRevision?: number | undefined;
         } | null;
-        scope: string;
     } | null | undefined;
 }, {
     dashboardEditing?: {
+        scope: string;
         target: {
             artifactId: string;
             schemaVersion: 1;
             versionId?: string | undefined;
             draftRevision?: number | undefined;
         } | null;
-        scope: string;
     } | null | undefined;
 }>;
 /** Checkpoints belong to an actor and conversation. Copied state must never choose another user's target. */