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

package/dist/lib/filter-evidence.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterTestSchema = void 0;
 exports.createFilterEvidence = createFilterEvidence;
 const tools_1 = require("@langchain/core/tools");
 const v3_1 = require("zod/v3");
 const plugin_sdk_1 = require("@xpert-ai/plugin-sdk");
 const scalar = v3_1.z.union([v3_1.z.string().max(4000), v3_1.z.number().finite(), v3_1.z.boolean(), v3_1.z.null()]);
-const schema = v3_1.z.object({ previewId: v3_1.z.string().min(1),
+exports.filterTestSchema = v3_1.z.object({ previewId: v3_1.z.string().min(1),
     controls: (0, plugin_sdk_1.jsonEncodedSchema)(v3_1.z.record(scalar)),
     expectations: (0, plugin_sdk_1.jsonEncodedSchema)(v3_1.z.array(v3_1.z.object({ fieldId: v3_1.z.string().min(1), oneOf: v3_1.z.array(scalar).min(1).max(100) }).strict()).min(1).max(24))
 }).strict();
@@ -55,6 +56,6 @@ function createFilterEvidence(service, scope, previews) {
             checked.set(input.previewId, controls);
             return JSON.stringify({ previewId: input.previewId, passed: true, checkedControls: [...controls], remainingControls: required(binding, input.previewId).map(parameter => parameter.controlId), rows: dataset.rows.slice(0, 20), completeness: dataset.completeness });
         }, { name: 'dashboard_test_filter', description: 'Verify a previewed Binding with concrete filter values and expected field values. For a nullable dimension selector, test a real non-null value and expect every row of the matching field to equal it before saving. Does not change defaults. A failed check must be repaired before create/update.',
-            schema, verboseParsingErrors: true, metadata: { toolName: { en_US: 'Verify filter results', zh_Hans: '验证筛选结果' } } })
+            schema: exports.filterTestSchema, verboseParsingErrors: true, metadata: { toolName: { en_US: 'Verify filter results', zh_Hans: '验证筛选结果' } } })
     };
 }

package/dist/lib/html-guidance.d.ts

@@ -1 +1,2 @@
 export declare const HTML_DASHBOARD_GUIDANCE = "For free-layout HTML dashboards, read the installed live-dashboard skill's references/html-runtime.md through read_skill_file, relative to its SKILL.md path in the skill catalog. Create/edit the HTML with SandboxFile; then dashboard_create_html or dashboard_update validates and saves it. Do not use generic present_files to save or preview a live dashboard. Its preview belongs to the Live dashboards Workbench. Call dashboard_libraries for packaged ECharts/Three.js. Network access is temporarily unrestricted for functional acceptance. CDN scripts/styles/fonts, CSS imports, external images and fetch/XHR are available under browser CORS and mixed-content rules. Tailwind CDN is supported; do not remove styling to avoid network validation. Platform business data remains declarative Binding queries through window.xpertLiveArtifact; never embed credentials. The page MUST declare const live = window.xpertLiveArtifact in its script (live is not a host global), register live.subscribe(bindingId, render), await live.ready(), and invoke live.query(bindingId, typedControls) for initial data and filter changes. window.__datasets and window.__refresh are not platform APIs and are never populated by the host. Read the runtime reference and its html-lifecycle.md example before writing HTML; preserve that lifecycle while freely changing the layout. Use one complete Dataset for KPI, trend and details when they share the same metric and filters; do not create a redundant unfiltered total Binding. Never let filtered and unfiltered subscriptions both write the same KPI: a refresh would race and overwrite the selected-region total. Distinct global totals need distinct, clearly labeled elements. Native data selects require data-dashboard-control=\"<controlId>\"; purely visual selects use data-dashboard-presentation. A data filter must query, not only filter cached browser rows. bindSelect controls ONE binding only. For a shared dimension filter across multiple bindings, follow the skill custom-select example and query every affected binding with the same typed controls; matching control IDs do not broadcast automatically. bindSelect derives options from Dataset fields and is only for dimension filters. Fixed query enums (days, page size, granularity) need options from parameter.allowedValues and a typed change listener calling live.query; never use date rows as numeric day-count options.";
+export declare const HTML_QUERY_ROUNDS = "For a filter shared by multiple Bindings use await live.queryMany(affectedBindingIds, typedControls); render explicit failures from the returned {datasets, failures}. Successful subscriptions are delivered together after that round settles. Individual live.query calls retain independent delivery for legacy pages.";

package/dist/lib/html-guidance.js

@@ -1,4 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HTML_DASHBOARD_GUIDANCE = void 0;
+exports.HTML_QUERY_ROUNDS = exports.HTML_DASHBOARD_GUIDANCE = void 0;
 exports.HTML_DASHBOARD_GUIDANCE = `For free-layout HTML dashboards, read the installed live-dashboard skill's references/html-runtime.md through read_skill_file, relative to its SKILL.md path in the skill catalog. Create/edit the HTML with SandboxFile; then dashboard_create_html or dashboard_update validates and saves it. Do not use generic present_files to save or preview a live dashboard. Its preview belongs to the Live dashboards Workbench. Call dashboard_libraries for packaged ECharts/Three.js. Network access is temporarily unrestricted for functional acceptance. CDN scripts/styles/fonts, CSS imports, external images and fetch/XHR are available under browser CORS and mixed-content rules. Tailwind CDN is supported; do not remove styling to avoid network validation. Platform business data remains declarative Binding queries through window.xpertLiveArtifact; never embed credentials. The page MUST declare const live = window.xpertLiveArtifact in its script (live is not a host global), register live.subscribe(bindingId, render), await live.ready(), and invoke live.query(bindingId, typedControls) for initial data and filter changes. window.__datasets and window.__refresh are not platform APIs and are never populated by the host. Read the runtime reference and its html-lifecycle.md example before writing HTML; preserve that lifecycle while freely changing the layout. Use one complete Dataset for KPI, trend and details when they share the same metric and filters; do not create a redundant unfiltered total Binding. Never let filtered and unfiltered subscriptions both write the same KPI: a refresh would race and overwrite the selected-region total. Distinct global totals need distinct, clearly labeled elements. Native data selects require data-dashboard-control="<controlId>"; purely visual selects use data-dashboard-presentation. A data filter must query, not only filter cached browser rows. bindSelect controls ONE binding only. For a shared dimension filter across multiple bindings, follow the skill custom-select example and query every affected binding with the same typed controls; matching control IDs do not broadcast automatically. bindSelect derives options from Dataset fields and is only for dimension filters. Fixed query enums (days, page size, granularity) need options from parameter.allowedValues and a typed change listener calling live.query; never use date rows as numeric day-count options.`;
+exports.HTML_QUERY_ROUNDS = 'For a filter shared by multiple Bindings use await live.queryMany(affectedBindingIds, typedControls); render explicit failures from the returned {datasets, failures}. Successful subscriptions are delivered together after that round settles. Individual live.query calls retain independent delivery for legacy pages.';

package/dist/lib/html-validation.js

@@ -22,7 +22,7 @@ const artifact_document_1 = require("@xpert-ai/plugin-sdk/artifact-document");
 const html_validation_feedback_1 = require("./html-validation-feedback");
 const PLUGIN = '@xpert-ai/plugin-live-dashboard', ACTION = 'live_dashboard.validate-html', POOL = 'sandbox-browser';
 const reportSchema = v3_1.z.object({ ok: v3_1.z.boolean(), errors: v3_1.z.array(v3_1.z.string().max(300)).max(16),
-    requestedBindings: v3_1.z.array(v3_1.z.string().max(80)).max(60), renderedTextLength: v3_1.z.number().int().nonnegative() }).strict();
+    requestedBindings: v3_1.z.array(v3_1.z.string().max(80)).max(64), renderedTextLength: v3_1.z.number().int().nonnegative() }).strict();
 const recordSchema = v3_1.z.object({ tenantId: v3_1.z.string(), organizationId: v3_1.z.string(), userId: v3_1.z.string(), manifestId: v3_1.z.string(), deadline: v3_1.z.number(),
     filePath: v3_1.z.string(), workspacePath: v3_1.z.string(), size: v3_1.z.number(), sha256: v3_1.z.string() }).strict();
 const digest = (buffer) => (0, node_crypto_1.createHash)('sha256').update(buffer).digest('hex');

package/dist/lib/middleware.d.ts

@@ -1,10 +1,12 @@
+import { DashboardSaveRequests } from './save-requests';
 import type { TAgentMiddlewareMeta } from '@xpert-ai/contracts';
 import { type AgentMiddleware, type IAgentMiddlewareStrategy, type IAgentMiddlewareContext } from '@xpert-ai/plugin-sdk';
 import { DashboardService } from './dashboard.service';
 export declare const DASHBOARD_GUIDANCE = "For a new independent dashboard, use a new unused HTML file path. An existing filename or matching title is not authorization to edit another Artifact; do not switch from creation to dashboard_open/update because a file already exists. For a new dashboard, call dashboard_list_sources before searching raw files, reading old scripts or creating transformations. Named governed sources may already provide the required query; inspect their provider contracts first. File-backed sources do not imply that a script must be written. For creating or editing live dashboards, first read the installed live-dashboard skill using read_skill_file and follow only the references relevant to the task. Use SandboxFile tools for all source-file authoring; HTML alone is not a saved dashboard. Follow preview.validation.checks immediately before authoring HTML; each suggestedCall must actually succeed. Business definitions, real data previews and nullable-filter tests are required before saving new or changed Bindings. Do not invent business data or substitute a different metric without agreement. Report completion only from a successful dashboard_create/dashboard_create_html/dashboard_update draft receipt. Human publication is separate. Successful create, update and open tools emit a chat resource card automatically; resourceCard.status reports emission. Its Open button selects the exact dashboard in Workbench. Never fabricate a link, call present_files for dashboard HTML, or output card JSON as text. If card delivery is unavailable, report the saved receipt and use the Workbench picker.";
 export declare class DashboardMiddleware implements IAgentMiddlewareStrategy {
     private readonly service;
+    private readonly saveRequests?;
     readonly meta: TAgentMiddlewareMeta;
-    constructor(service: DashboardService);
+    constructor(service: DashboardService, saveRequests?: DashboardSaveRequests | undefined);
     createMiddleware(_options: unknown, context: IAgentMiddlewareContext): AgentMiddleware;
 }

package/dist/lib/middleware.js

@@ -8,8 +8,14 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DashboardMiddleware = exports.DASHBOARD_GUIDANCE = void 0;
+const common_1 = require("@nestjs/common");
+const save_requests_1 = require("./save-requests");
+const bounded_map_1 = require("./bounded-map");
 const runtime_context_1 = require("./runtime-context");
 const definition_tools_1 = require("./definition-tools");
 const analytics_source_1 = require("./analytics-source");
@@ -46,8 +52,9 @@ const providerOptionSchema = {
 };
 exports.DASHBOARD_GUIDANCE = `For a new independent dashboard, use a new unused HTML file path. An existing filename or matching title is not authorization to edit another Artifact; do not switch from creation to dashboard_open/update because a file already exists. For a new dashboard, call dashboard_list_sources before searching raw files, reading old scripts or creating transformations. Named governed sources may already provide the required query; inspect their provider contracts first. File-backed sources do not imply that a script must be written. For creating or editing live dashboards, first read the installed live-dashboard skill using read_skill_file and follow only the references relevant to the task. Use SandboxFile tools for all source-file authoring; HTML alone is not a saved dashboard. Follow preview.validation.checks immediately before authoring HTML; each suggestedCall must actually succeed. Business definitions, real data previews and nullable-filter tests are required before saving new or changed Bindings. Do not invent business data or substitute a different metric without agreement. Report completion only from a successful dashboard_create/dashboard_create_html/dashboard_update draft receipt. Human publication is separate. Successful create, update and open tools emit a chat resource card automatically; resourceCard.status reports emission. Its Open button selects the exact dashboard in Workbench. Never fabricate a link, call present_files for dashboard HTML, or output card JSON as text. If card delivery is unavailable, report the saved receipt and use the Workbench picker.`;
 let DashboardMiddleware = class DashboardMiddleware {
-    constructor(service) {
+    constructor(service, saveRequests) {
         this.service = service;
+        this.saveRequests = saveRequests;
         this.meta = {
             name: 'LiveDashboard', label: { en_US: 'Live dashboards', zh_Hans: '实时看板' },
             description: { en_US: 'Discover, preview, create and update governed live dashboards.', zh_Hans: '发现业务数据、验证查询并持续修改实时看板。' },
@@ -63,6 +70,7 @@ let DashboardMiddleware = class DashboardMiddleware {
         };
     }
     createMiddleware(_options, context) {
+        const runId = (0, node_crypto_1.randomUUID)();
         const options = middlewareOptionsSchema.parse(_options);
         if (!context.xpertId)
             throw new Error('DASHBOARD_ASSISTANT_REQUIRED');
@@ -105,7 +113,7 @@ let DashboardMiddleware = class DashboardMiddleware {
             const controls = Object.fromEntries(binding.parameters.map((parameter) => [parameter.controlId, parameter.defaultValue ?? null]));
             const dataset = await this.service.preview(scope, { binding, controls });
             const previewId = previewKey(binding, controls);
-            if (previews.size >= 24 && !previews.has(previewId))
+            if (previews.size >= 256 && !previews.has(previewId))
                 throw new Error('DASHBOARD_PREVIEW_LIMIT');
             previews.set(previewId, binding);
             const rows = dataset.rows.slice(0, 20);
@@ -134,7 +142,7 @@ let DashboardMiddleware = class DashboardMiddleware {
                 }
             }
         };
-        const save = async (input, config, html, dependencies = []) => {
+        const save = async (input, config, html, dependencies = [], sourceFile) => {
             const { previewIds, supersedesPaths, creationIntent, ...definition } = input;
             const bindings = resolvePreviews(previewIds);
             const manifest = dashboard_schema_1.dashboardSchema.parse({ ...definition, bindings, schema: 'xpert.live-dashboard', id: (0, node_crypto_1.randomUUID)(),
@@ -154,6 +162,8 @@ let DashboardMiddleware = class DashboardMiddleware {
             const sameTitle = [...created.values()].find(item => item.manifest.title === manifest.title);
             if (sameTitle && !creationIntent)
                 throw new Error(`DASHBOARD_ALREADY_CREATED: this run already saved this dashboard. Use dashboard_open with artifactId ${sameTitle.receipt.artifactId}, then dashboard_update with fresh previewIds for data changes; preserve the Artifact instead of creating another one.`);
+            if (this.saveRequests && bindings.length > 8)
+                return JSON.stringify(await this.saveRequests.submit(scope, manifest, null, 0, `${runId}/${key}`, sourceFile));
             const result = await this.service.save(scope, manifest, null);
             created.set(key, { manifest, receipt: result });
             const resourceCard = await (0, resource_card_1.emitDashboardCard)(scope, { ...result, state: 'draft', revision: result.draftRevision }, config);
@@ -165,6 +175,20 @@ let DashboardMiddleware = class DashboardMiddleware {
                 throw new Error('DASHBOARD_WORKSPACE_REQUIRED');
             return files;
         });
+        const pendingRequests = new Map();
+        const activeRequests = new Set(), delivered = new Set();
+        const observeRequest = async (result, config) => {
+            if (!result.terminal)
+                activeRequests.add(result.requestId);
+            else
+                activeRequests.delete(result.requestId);
+            if (!result.dashboard || delivered.has(result.requestId))
+                return JSON.stringify(result);
+            delivered.add(result.requestId);
+            const resourceCard = await (0, resource_card_1.emitDashboardCard)(scope, { ...result.dashboard, state: 'draft', revision: result.dashboard.draftRevision }, config);
+            return JSON.stringify({ ...result, resourceCard });
+        };
+        let observing = false, waits = 0;
         const previewRetries = (0, preview_retry_1.createPreviewRetryGuard)();
         let modelCalls = 0;
         return { name: 'LiveDashboard', contextSchema: editing_1.dashboardContextSchema, stateSchema: editing_session_1.dashboardStateSchema,
@@ -173,12 +197,28 @@ let DashboardMiddleware = class DashboardMiddleware {
             wrapToolCall: async (request, handler) => {
                 const name = request.toolCall.name;
                 const args = request.toolCall.args;
+                observing = name === 'dashboard_wait_request';
+                if (observing && ++waits > 40)
+                    throw new Error('DASHBOARD_WAIT_BUDGET: resume with dashboard_get_request using the existing requestId; do not resubmit.');
                 const path = (0, plugin_sdk_1.workspaceFileMutationPath)(request.tool && 'metadata' in request.tool ? request.tool.metadata : undefined, args);
                 const creation = name === 'dashboard_create_html' ? agent_schema_1.createHtmlToolSchema.safeParse(args)
                     : name === 'dashboard_create' ? agent_schema_1.createToolSchema.safeParse(args) : undefined;
-                const save = dashboard_receipt_1.DASHBOARD_MUTATION_TOOLS.includes(name) ? evidence.beginSave(creation?.success ? creation.data.supersedesPaths : undefined, name === 'dashboard_create' ? 'draft' : 'source') : undefined;
+                const priorAttempt = (name === 'dashboard_wait_request' || name === 'dashboard_get_request') && typeof args.requestId === 'string' ? pendingRequests.get(args.requestId) : undefined;
+                const save = priorAttempt ?? (dashboard_receipt_1.DASHBOARD_MUTATION_TOOLS.includes(name) ? evidence.beginSave(creation?.success ? creation.data.supersedesPaths : undefined, name === 'dashboard_create' ? 'draft' : 'source') : undefined);
                 const result = path && (evidence.has(path) || previews.size > 0 && agent_schema_1.htmlPathSchema.safeParse(path).success)
                     ? await evidence.trackWrite(path, async () => handler(request)) : await previewRetries.run(request, handler);
+                if (save && 'content' in result && typeof result.content === 'string') {
+                    try {
+                        const pending = save_requests_1.saveRequestSchema.extend({ terminal: v3_1.z.boolean() }).passthrough().parse(JSON.parse(result.content));
+                        if (pending.terminal)
+                            activeRequests.delete(pending.requestId);
+                        else {
+                            pendingRequests.set(pending.requestId, save);
+                            activeRequests.add(pending.requestId);
+                        }
+                    }
+                    catch { /* normal synchronous result */ }
+                }
                 if (save && 'content' in result && (!('status' in result) || result.status !== 'error'))
                     await evidence.accept(save, result.content);
                 if ('content' in result && (!('status' in result) || result.status !== 'error')) {
@@ -202,18 +242,54 @@ let DashboardMiddleware = class DashboardMiddleware {
                     // A noncompliant model must not restart the failed loop even after tools were removed.
                     return result?.tool_calls?.length ? new messages_1.AIMessage(summary) : result;
                 }
-                const exhausted = ++modelCalls > options.maxModelCalls;
+                const exhausted = (observing ? modelCalls : ++modelCalls) > options.maxModelCalls;
                 if (exhausted && evidence.pending)
                     throw new Error('DASHBOARD_SAVE_NOT_CONFIRMED: no successful draft save receipt; Workspace changes have not been saved to the dashboard.');
-                const result = await handler({ ...request, ...(evidence.pending ? { toolChoice: 'required' } : {}), ...(exhausted ? { tools: [] } : {}), systemMessage: new messages_1.SystemMessage({ content: [
+                const result = await handler({ ...request, ...(evidence.pending || activeRequests.size ? { toolChoice: 'required' } : {}), ...(exhausted ? { tools: [] } : {}), systemMessage: new messages_1.SystemMessage({ content: [
                             ...(typeof request.systemMessage?.content === 'string' ? [{ type: 'text', text: request.systemMessage.content }] : request.systemMessage?.content ?? []),
-                            { type: 'text', text: exports.DASHBOARD_GUIDANCE + (editing.current() ? `\nCurrent editing target: ${JSON.stringify(editing.current())}. Continue this Artifact with dashboard_open/update unless the user explicitly requests a new independent dashboard.` : '') + '\n' + definition_tools_1.DEFINITION_GUIDANCE + '\n' + html_guidance_1.HTML_DASHBOARD_GUIDANCE + '\n' + editing_1.EDITING_GUIDANCE + (evidence.pending ? `\nDashboard changes are pending without a matching draft save receipt. Unsaved files: ${JSON.stringify(evidence.pendingPaths)}. Continue reading/repairing and call dashboard_create_html or dashboard_update with the exact file path; do not finish or claim it was saved. When abandoning earlier unsaved HTML creation candidates, explicitly pass their exact paths as supersedesPaths to dashboard_create or dashboard_create_html, matching the requested presentation mode. If a standard dashboard is already saved, repeat dashboard_create with the same definition/previewIds and supersedesPaths; do not create an unwanted HTML dashboard. This only abandons those candidates after a successful save; it never discards another Artifact editing copy.` : '') + (options.allowedFinalProviders ? `\nThis Assistant requires every saved dashboard binding to use one of these providers: ${options.allowedFinalProviders.join(', ')}. Other providers may be previewed only as upstream inputs. Do not save a direct-source substitute.` : '') + (exhausted ? '\nThe dashboard tool budget is exhausted. Stop calls; report only saved receipts or explain the concrete blocker truthfully.' : '') }
+                            { type: 'text', text: `Current dashboard authoring limit: ${this.service.maxBindings} Bindings (storage maximum 64). Shared charts may reuse one Binding; independent filter-option queries count too. Preview in batches, preserving each receipt and filter check.\n` + exports.DASHBOARD_GUIDANCE + (editing.current() ? `\nCurrent editing target: ${JSON.stringify(editing.current())}. Continue this Artifact with dashboard_open/update unless the user explicitly requests a new independent dashboard.` : '') + '\n' + definition_tools_1.DEFINITION_GUIDANCE + '\n' + html_guidance_1.HTML_DASHBOARD_GUIDANCE + '\n' + html_guidance_1.HTML_QUERY_ROUNDS + '\n' + editing_1.EDITING_GUIDANCE + (activeRequests.size ? `\nDurable save requests pending: ${JSON.stringify([...activeRequests])}. Keep calling dashboard_wait_request with the returned requestId and cursor until terminal. Do not resubmit or claim saved before a dashboard receipt. On a later conversation use dashboard_get_request to recover.` : '') + (evidence.pending ? `\nDashboard changes are pending without a matching draft save receipt. Unsaved files: ${JSON.stringify(evidence.pendingPaths)}. Continue reading/repairing and call dashboard_create_html or dashboard_update with the exact file path; do not finish or claim it was saved. When abandoning earlier unsaved HTML creation candidates, explicitly pass their exact paths as supersedesPaths to dashboard_create or dashboard_create_html, matching the requested presentation mode. If a standard dashboard is already saved, repeat dashboard_create with the same definition/previewIds and supersedesPaths; do not create an unwanted HTML dashboard. This only abandons those candidates after a successful save; it never discards another Artifact editing copy.` : '') + (options.allowedFinalProviders ? `\nThis Assistant requires every saved dashboard binding to use one of these providers: ${options.allowedFinalProviders.join(', ')}. Other providers may be previewed only as upstream inputs. Do not save a direct-source substitute.` : '') + (exhausted ? '\nThe dashboard tool budget is exhausted. Stop calls; report only saved receipts or explain the concrete blocker truthfully.' : '') }
                         ] }) });
-                if (evidence.pending && result && !result.tool_calls?.length)
+                if ((evidence.pending || activeRequests.size) && result && !result.tool_calls?.length)
                     throw new Error('DASHBOARD_SAVE_NOT_CONFIRMED: the model stopped without a successful draft save receipt.');
                 return result;
             }, tools: [
+                ...(this.saveRequests ? [
+                    (0, tools_1.tool)(async ({ requestId, cursor }, config) => observeRequest(await this.saveRequests.wait(scope, requestId, cursor, config.signal), config), {
+                        name: 'dashboard_wait_request', description: 'Wait up to 20 seconds for a durable save to change. Repeat with its returned cursor while nextAction=wait. A pending request is not a saved dashboard.', schema: save_requests_1.waitSaveRequestSchema
+                    }),
+                    (0, tools_1.tool)(async ({ requestId }, config) => observeRequest(await this.saveRequests.get(scope, requestId), config), {
+                        name: 'dashboard_get_request', description: 'Recover a prior durable save by its requestId. Do not submit duplicate work after reconnecting.', schema: save_requests_1.saveRequestSchema
+                    })
+                ] : []),
                 filterEvidence.tool,
+                (0, tools_1.tool)(async ({ items }) => JSON.stringify({ results: await (0, bounded_map_1.boundedMap)(items, async (item, index) => {
+                        try {
+                            return { index, status: 'succeeded', result: await previewRetries.attempt('dashboard_test_filter', item, () => filterEvidence.tool.invoke(item)) };
+                        }
+                        catch (error) {
+                            return { index, status: 'failed', message: error instanceof Error ? error.message : 'DASHBOARD_FILTER_TEST_FAILED' };
+                        }
+                    }) }), { name: 'dashboard_test_filter_batch', description: 'Run up to eight required filter checks with four workers. Preserves the exact per-preview filter evidence and retry limits.',
+                    schema: v3_1.z.object({ items: v3_1.z.array(filter_evidence_1.filterTestSchema).min(1).max(8) }).strict(), verboseParsingErrors: true }),
+                (0, tools_1.tool)(async ({ items }) => {
+                    const results = await (0, bounded_map_1.boundedMap)(items, async (item, index) => {
+                        try {
+                            const value = await previewRetries.attempt('dashboard_preview_binding', item, () => preview(plugin_sdk_1.analyticsBindingSchema.parse((0, json_input_1.parseJsonInput)(item.bindingJson, 'bindingJson'))));
+                            const result = JSON.parse(value), rows = result.rows.slice(0, 5);
+                            while (Buffer.byteLength(JSON.stringify(rows)) > 8000)
+                                rows.pop();
+                            return { index, status: 'succeeded', preview: { previewId: result.previewId, datasetId: result.datasetId, rows,
+                                    completeness: result.completeness, freshness: result.freshness, validation: result.validation,
+                                    preview: { displayedRows: rows.length, omittedRows: result.completeness.returnedRows - rows.length, note: 'Bounded display sample. Binding definition is unchanged from this batch item.' } } };
+                        }
+                        catch (error) {
+                            return { index, status: 'failed', message: error instanceof Error ? error.message : 'DASHBOARD_PREVIEW_FAILED' };
+                        }
+                    });
+                    return JSON.stringify({ results, next: 'Keep every successful previewId. Complete each preview.validation.checks using dashboard_test_filter or dashboard_test_filter_batch. Repair only failed items; never invent a receipt.' });
+                }, { name: 'dashboard_preview_batch', description: 'Preview up to eight complete canonical Bindings with at most four concurrent queries. Returns independent receipts and diagnostics; preserves retry and filter-evidence requirements.',
+                    schema: v3_1.z.object({ items: v3_1.z.array(v3_1.z.object({ bindingJson: v3_1.z.string().min(2).max(200000) }).strict()).min(1).max(8) }).strict(),
+                    verboseParsingErrors: true, metadata: { toolName: { en_US: 'Verify a batch of sources', zh_Hans: '批量验证看板来源' } } }),
                 ...(0, definition_tools_1.createDefinitionTools)(context, () => { listedSources = undefined; }),
                 (0, tools_1.tool)(async () => JSON.stringify({ libraries: (await (0, document_libraries_1.bundledLibraries)()).map(({ source, ...lock }) => lock),
                     online: { enabled: true, ...document_network_1.DASHBOARD_NETWORK_POLICY,
@@ -223,6 +299,7 @@ let DashboardMiddleware = class DashboardMiddleware {
                         bindingIds: [...new Set([...previews.values()].map(binding => binding.id))],
                         startup: 'const live = window.xpertLiveArtifact; live.subscribe(bindingId, renderDataset); await live.ready(); await live.query(bindingId, typedControls); Use an async function, with the exact binding IDs from saved previews.',
                         refresh: 'live.refresh(bindingId) requires a Binding ID. live.refresh() without an ID is invalid. For a page refresh button or timer, call Promise.all(bindingIds.map(id => live.refresh(id))). Each subscription redraws its KPI, chart and details.',
+                        batch: 'await live.queryMany(bindingIds, typedControls) returns {datasets, failures}; it commits successful subscriptions together after the group settles. Use for shared filters and initial multi-source rounds. Display unavailable sources from failures, never retain old values as current.',
                         filters: 'Mark native data selects with data-dashboard-control="<exact controlId>". Mark purely visual selects with data-dashboard-presentation instead. Changing a data select must call live.query for every affected Binding, not only filter cached rows in JS. bindSelect updates one Binding only. Read references/html-lifecycle.md before writing the page.'
                     },
                     usage: { 'trend-workspace': 'window.TrendWorkspace: pale-blue KPI rail and aligned trends. Read themes/trend-workspace/README.md.',
@@ -233,7 +310,7 @@ let DashboardMiddleware = class DashboardMiddleware {
                         three: 'window.THREE: bundled core including WebGLRenderer. Requires WebGL2; catch unavailable GPU contexts and show a clear fallback. External textures/models, loaders/addons, WebGPU and workers are not bundled.' },
                     lifecycle: 'Pass packaged library IDs to dashboard_create_html or dashboard_update. Actual version and bytes are pinned on save; omitted libraries on update preserves saved locks. Online resources must load successfully during preflight and viewing; they are not frozen with the Artifact.' }), { name: 'dashboard_libraries', description: 'Discover packaged libraries, themes, exact versions and the current unrestricted network policy. Tailwind CDN and other online dependencies are supported. Returns metadata, never library source.',
                     schema: v3_1.z.object({}).strict(), verboseParsingErrors: true, metadata: { toolName: { en_US: 'Discover dashboard libraries', zh_Hans: '查看看板前端图库' } } }),
-                ...(0, editing_1.createEditingTools)(this.service, scope, context, resolvePreviews, validateFinal, (path, artifactId) => evidence.opened(path, artifactId), editing.resolve),
+                ...(0, editing_1.createEditingTools)(this.service, scope, context, resolvePreviews, validateFinal, (path, artifactId) => evidence.opened(path, artifactId), editing.resolve, this.saveRequests),
                 (0, tools_1.tool)(async () => {
                     listedSources = await this.service.sources(scope);
                     return JSON.stringify(listedSources);
@@ -271,7 +348,7 @@ let DashboardMiddleware = class DashboardMiddleware {
                         throw new Error('DASHBOARD_HTML_TOO_LARGE');
                     const html = artifact_document_1.artifactDocumentHtml.parse(new TextDecoder('utf-8', { fatal: true }).decode(file.buffer));
                     const { path, libraries, supersedesPaths, ...definition } = input;
-                    const result = JSON.parse(await save({ ...definition, charts: [], tables: [] }, config, html, await (0, document_libraries_1.libraryLocks)(libraries ?? [])));
+                    const result = JSON.parse(await save({ ...definition, charts: [], tables: [] }, config, html, await (0, document_libraries_1.libraryLocks)(libraries ?? []), { path, sha256: (0, node_crypto_1.createHash)('sha256').update(file.buffer).digest('hex') }));
                     return JSON.stringify({ ...result, sourceFile: { path, sha256: (0, node_crypto_1.createHash)('sha256').update(file.buffer).digest('hex') } });
                 }, { name: 'dashboard_create_html', description: 'Save custom HTML from a Workspace path together with run-local preview receipts and controls in one persistent draft (human publication is separate). Requires real data preview; does not accept query payloads or cached rows.',
                     schema: agent_schema_1.createHtmlToolSchema, verboseParsingErrors: true,
@@ -282,7 +359,8 @@ let DashboardMiddleware = class DashboardMiddleware {
 exports.DashboardMiddleware = DashboardMiddleware;
 exports.DashboardMiddleware = DashboardMiddleware = __decorate([
     (0, plugin_sdk_1.AgentMiddlewareStrategy)('LiveDashboard'),
-    __metadata("design:paramtypes", [dashboard_service_1.DashboardService])
+    __param(1, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [dashboard_service_1.DashboardService, save_requests_1.DashboardSaveRequests])
 ], DashboardMiddleware);
 function previewKey(binding, controls) {
     return hash({ binding, controls: Object.fromEntries(binding.parameters.map((parameter) => [parameter.controlId, Object.hasOwn(controls, parameter.controlId) ? controls[parameter.controlId] : parameter.defaultValue ?? null])) });

package/dist/lib/plugin.js

@@ -7,6 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LiveDashboardPlugin = void 0;
+const save_requests_1 = require("./save-requests");
 const archive_service_1 = require("./archive.service");
 const projects_service_1 = require("./projects.service");
 const content_capability_1 = require("./content-capability");
@@ -25,5 +26,5 @@ let LiveDashboardPlugin = class LiveDashboardPlugin {
 };
 exports.LiveDashboardPlugin = LiveDashboardPlugin;
 exports.LiveDashboardPlugin = LiveDashboardPlugin = __decorate([
-    (0, plugin_sdk_1.XpertServerPlugin)({ controllers: [provider_options_controller_1.DashboardProviderOptionsController], providers: [archive_service_1.DashboardArchiveService, projects_service_1.DashboardProjectsService, monitor_1.DashboardMonitor, monitor_1.DashboardMonitorMiddleware, artifact_type_provider_1.DashboardArtifactType, content_capability_1.DashboardCapability, content_provider_1.DashboardContentProvider, content_provider_1.DashboardContentEditor, dashboard_service_1.DashboardService, view_provider_1.DashboardViewProvider, middleware_1.DashboardMiddleware, html_validation_1.HtmlDashboardValidation, presentation_provider_1.DashboardPresentationProvider, sharing_service_1.DashboardSharingService] })
+    (0, plugin_sdk_1.XpertServerPlugin)({ controllers: [provider_options_controller_1.DashboardProviderOptionsController], providers: [save_requests_1.DashboardSaveRequests, archive_service_1.DashboardArchiveService, projects_service_1.DashboardProjectsService, monitor_1.DashboardMonitor, monitor_1.DashboardMonitorMiddleware, artifact_type_provider_1.DashboardArtifactType, content_capability_1.DashboardCapability, content_provider_1.DashboardContentProvider, content_provider_1.DashboardContentEditor, dashboard_service_1.DashboardService, view_provider_1.DashboardViewProvider, middleware_1.DashboardMiddleware, html_validation_1.HtmlDashboardValidation, presentation_provider_1.DashboardPresentationProvider, sharing_service_1.DashboardSharingService] })
 ], LiveDashboardPlugin);

package/dist/lib/presentation.provider.d.ts

@@ -24,8 +24,8 @@ export declare class DashboardPresentationProvider implements IArtifactPresentat
                         allowedValues?: (string | number | boolean | null)[] | undefined;
                     }[];
                     charts: {
-                        title: string;
                         type: "bar" | "line" | "area" | "pie" | "scatter";
+                        title: string;
                         id: string;
                         datasetId: string;
                         x: string;

package/dist/lib/preview-retry.d.ts

@@ -1,7 +1,8 @@
 import type { AgentBuiltInState, ToolCallHandler, ToolCallRequest } from '@xpert-ai/plugin-sdk';
 /** Run-local bounds include tool-schema failures, before any discovery or query executes. */
 export declare function createPreviewRetryGuard(): {
-    readonly exhausted: boolean;
-    readonly summary: string;
-    run(request: ToolCallRequest<AgentBuiltInState>, handler: ToolCallHandler): Promise<import("@langchain/core/messages").ToolMessage | import("@langchain/langgraph").Command<unknown, Record<string, unknown>, string>>;
+    exhausted: boolean;
+    summary: string;
+    run(request: ToolCallRequest<AgentBuiltInState>, handler: ToolCallHandler): import("@xpert-ai/plugin-sdk").PromiseOrValue<import("@langchain/core/messages").ToolMessage | import("@langchain/langgraph").Command<unknown, Record<string, unknown>, string>>;
+    attempt<T>(name: string, args: unknown, handler: () => Promise<T>): Promise<T>;
 };

package/dist/lib/preview-retry.js

@@ -12,13 +12,11 @@ function createPreviewRetryGuard() {
         consecutiveFailures++;
         lastError = message.slice(0, 2000);
     };
-    return {
+    const guard = {
         get exhausted() { return consecutiveFailures >= 6; },
         get summary() { return `DASHBOARD_PREVIEW_RETRY_LIMIT: preview validation repeatedly failed. This run has stopped making tool calls. Report the last error and the required repair; do not claim an unconfirmed save. Last error: ${lastError}`; },
-        async run(request, handler) {
-            if (!PREVIEW_TOOLS.has(request.toolCall.name))
-                return handler(request);
-            const key = (0, node_crypto_1.createHash)('sha256').update(JSON.stringify({ name: request.toolCall.name, args: request.toolCall.args }, (_key, value) => value && typeof value === 'object' && !Array.isArray(value) ? Object.fromEntries(Object.entries(value).sort(([a], [b]) => a.localeCompare(b))) : value)).digest('hex');
+        async attempt(name, args, handler) {
+            const key = (0, node_crypto_1.createHash)('sha256').update(JSON.stringify({ name, args }, (_key, value) => value && typeof value === 'object' && !Array.isArray(value) ? Object.fromEntries(Object.entries(value).sort(([a], [b]) => a.localeCompare(b))) : value)).digest('hex');
             if (consecutiveFailures >= 6)
                 throw new Error(this.summary);
             if ((failures.get(key)?.count ?? 0) >= 2) {
@@ -30,8 +28,8 @@ function createPreviewRetryGuard() {
                 throw new Error('DASHBOARD_PREVIEW_IN_PROGRESS: wait for the identical preview already in progress; do not submit duplicates.');
             pending.add(key);
             try {
-                const result = await handler(request);
-                if ('status' in result && result.status === 'error' && 'content' in result) {
+                const result = await handler();
+                if (result && typeof result === 'object' && 'status' in result && result.status === 'error' && 'content' in result) {
                     recordFailure(key, typeof result.content === 'string' ? result.content : 'Preview tool returned an error');
                 }
                 else {
@@ -49,4 +47,12 @@ function createPreviewRetryGuard() {
             }
         }
     };
+    return { ...guard,
+        get exhausted() { return guard.exhausted; },
+        get summary() { return guard.summary; },
+        run(request, handler) {
+            return PREVIEW_TOOLS.has(request.toolCall.name)
+                ? guard.attempt(request.toolCall.name, request.toolCall.args, async () => handler(request)) : handler(request);
+        }
+    };
 }

package/dist/lib/prompt-workflows.js

@@ -6,7 +6,7 @@ const context = `Work in the current authorized Assistant/project scope. Use the
 Resolve source/provider pairs, Artifact IDs, fields and file paths from current tools, not names or previous conversation claims. Use only real query results; no invented business data, targets, thresholds, comparison periods or activity feeds. Keep queries read-only and bounded. Report actual tool failures and diagnosticId when supplied. A missing capability or runtime binding is a blocker, not permission to bypass validation or switch presentation modes.`;
 const metrics = `Confirm metric definitions, units, time range, grain and join keys from metadata and small real samples. Compute ratios from aggregated numerators and denominators, not sums/averages of percentages. Keep unknown/zero denominators as unavailable, not zero. Check join cardinality and avoid duplicate totals. Use chronological date ordering and comparable complete periods. State freshness and gaps; historical data must not be described as current operations. Avoid exposing unnecessary personal or sensitive row-level fields.`;
 const discover = `Call dashboard_list_sources first, then dashboard_discover for exact authorized source/provider pairs. Follow returned inspectRequest/nextRequest and query contracts; do not scan unrelated schemas or guess SQL fields. Prefer existing governed definitions. If the requested source is missing, use analytics_definition_connections and analytics_definition_inspect; register a missing definition with analytics_definition_register only when needed for this requested dashboard, then refresh sources. Never duplicate an existing definition or ask the user to supply internal IDs.`;
-const preview = `Before saving new or changed Bindings, call dashboard_preview or dashboard_preview_binding with the exact final queries and typed default controls in this run. Execute every preview.validation.checks[].suggestedCall with dashboard_test_filter; use observed non-default values and the all-values/null case when applicable. Follow each tool's schema, serialize JSON-string fields correctly, and copy returned bindingJson rather than nesting a Binding inside SQL. Changed queries/defaults need fresh evidence. Use at most eight final Bindings, sharing a query where its metric, grain and filters permit it. Never reuse historical previewIds or hard-code preview rows into the page.`;
+const preview = `Before saving new or changed Bindings, call dashboard_preview or dashboard_preview_binding with the exact final queries and typed default controls in this run. Execute every preview.validation.checks[].suggestedCall with dashboard_test_filter; use observed non-default values and the all-values/null case when applicable. Follow each tool's schema, serialize JSON-string fields correctly, and copy returned bindingJson rather than nesting a Binding inside SQL. Changed queries/defaults need fresh evidence. Respect the installation authoring limit (32 Bindings by default, at most 64), sharing a query where its metric, grain and filters permit it. Never reuse historical previewIds or hard-code preview rows into the page.`;
 const receipt = `Save a working draft and require a successful domain receipt with dashboard.artifactId, status "draft" and draftRevision. File writes, an existing resource card or an older published version are not proof of this save. Open the exact saved Artifact to inspect it; do not update an unchanged copy just to verify persistence. Verify real filter changes and refresh where available, distinguishing tool checks from unperformed viewer checks. Return the saved receipt, sources, metric definitions and a short manual acceptance checklist. Formal publication remains a separate human Workbench action.`;
 const newDashboard = `Create a NEW independent dashboard. Do not modify, rename or replace an existing Artifact, including the currently selected dashboard. Choose a distinct business title. In HTML mode choose an unused workspace-relative named .html path; never reuse an old page just because it has a similar title. Reuse verified source definitions, not an old dashboard's identity. If this run already saved the requested dashboard, keep its Artifact rather than creating a duplicate.`;
 const automaticTheme = `Choose one useful business theme from the authorized data, prioritizing an operational decision such as delivery delays, inventory backlog, supplier performance or production quality. Compare only a few plausible sources by completeness, freshness, metric clarity and actionable detail; then select the strongest one without repeatedly asking the user to choose. Explain who will use it, which decision it supports and which records require attention. If no source supports a defensible theme, report the missing data instead of making a decorative demo.`;

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

@@ -0,0 +1,9 @@
+import type { AnalyticalDataset } from '@xpert-ai/contracts';
+import { type ArtifactQueryInput, type ArtifactQueryPriority } from '@xpert-ai/plugin-sdk/artifact-document';
+import type { DashboardManifest } from './dashboard.schema';
+import { type SourceEvent } from './source-executions';
+/** One saved definition and actor. No cache survives a navigation or a version change. */
+export declare function createDashboardQuerySession(manifest: DashboardManifest, execute: (input: ArtifactQueryInput) => Promise<AnalyticalDataset>, changed: (datasets: AnalyticalDataset[], failures: string[]) => void, event: (event: SourceEvent) => void, busy: (value: boolean) => void): {
+    query(values: ArtifactQueryInput["controls"], priority?: ArtifactQueryPriority, only?: string[]): Promise<void>;
+    dispose(): void;
+};

package/dist/lib/query-session.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDashboardQuerySession = createDashboardQuerySession;
+const artifact_document_1 = require("@xpert-ai/plugin-sdk/artifact-document");
+const source_executions_1 = require("./source-executions");
+/** One saved definition and actor. No cache survives a navigation or a version change. */
+function createDashboardQuerySession(manifest, execute, changed, event, busy) {
+    const results = new Map(), failures = new Set();
+    const keys = new Map(), requests = new Map(), pending = new Set();
+    let sequence = 0, disposed = false;
+    const publish = () => { if (!disposed)
+        changed([...results.values()], [...failures]); };
+    const scheduler = (0, artifact_document_1.createArtifactQueryScheduler)({ execute, onBusy: busy, onState: state => {
+            if (disposed || !['queued', 'running'].includes(state.state))
+                return;
+            event({ type: state.state === 'queued' ? 'queue' : 'start', bindingId: state.bindingId,
+                requestId: requests.get(state.bindingId), controls: state.controls, at: new Date(state.state === 'queued' ? state.queuedAt : state.startedAt).toISOString() });
+        } });
+    return {
+        async query(values, priority = 'interactive', only) {
+            const affected = manifest.bindings.flatMap(binding => {
+                if (only && !only.includes(binding.id))
+                    return [];
+                const controls = Object.fromEntries(binding.parameters.map(parameter => [parameter.controlId,
+                    Object.hasOwn(values, parameter.controlId) ? values[parameter.controlId] : parameter.defaultValue ?? null]));
+                const key = JSON.stringify(controls);
+                if (priority === 'interactive' && keys.get(binding.id) === key && !failures.has(binding.output.datasetId))
+                    return [];
+                // A repeated refresh shares both the physical query and its Sources lifecycle.
+                const requestId = keys.get(binding.id) === key && pending.has(binding.id) ? requests.get(binding.id) : String(++sequence);
+                keys.set(binding.id, key);
+                pending.add(binding.id);
+                requests.set(binding.id, requestId);
+                results.delete(binding.output.datasetId);
+                failures.delete(binding.output.datasetId);
+                return [{ binding, controls, requestId }];
+            });
+            // Remove every affected old-parameter dataset before publishing any new result.
+            publish();
+            await Promise.all(affected.map(async ({ binding, controls, requestId }) => {
+                try {
+                    const result = await scheduler.query({ bindingId: binding.id, controls }, priority);
+                    if (disposed || requests.get(binding.id) !== requestId)
+                        return;
+                    results.set(binding.output.datasetId, result);
+                    if (new TextEncoder().encode(JSON.stringify([...results.values()])).byteLength > 3_000_000) {
+                        results.delete(binding.output.datasetId);
+                        throw new Error('DASHBOARD_RESULT_TOO_LARGE');
+                    }
+                    event({ type: 'success', bindingId: binding.id, requestId, result: source_executions_1.sourceDatasetSchema.parse(result), at: new Date().toISOString() });
+                }
+                catch {
+                    if (disposed || requests.get(binding.id) !== requestId)
+                        return;
+                    failures.add(binding.output.datasetId);
+                    event({ type: 'failure', bindingId: binding.id, requestId, at: new Date().toISOString() });
+                }
+                pending.delete(binding.id);
+                publish();
+            }));
+        },
+        dispose() { disposed = true; scheduler.dispose(); results.clear(); requests.clear(); keys.clear(); pending.clear(); }
+    };
+}

package/dist/lib/save-requests.d.ts

@@ -0,0 +1,118 @@
+import { z } from 'zod/v3';
+import type { XpertResolvedViewHostContext } from '@xpert-ai/contracts';
+import { type ManagedQueueJob, type ManagedQueueJobContext, type ManagedQueueService, type RuntimeCapabilityRegistry } from '@xpert-ai/plugin-sdk';
+import { type ArtifactDocumentDependencyAsset } from '@xpert-ai/plugin-sdk/artifact-document';
+import { DashboardService } from './dashboard.service';
+import { type DashboardManifest } from './dashboard.schema';
+declare const sourceFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    sha256: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    sha256: string;
+}, {
+    path: string;
+    sha256: string;
+}>;
+export declare const saveRequestSchema: z.ZodObject<{
+    requestId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    requestId: string;
+}, {
+    requestId: string;
+}>;
+export declare const waitSaveRequestSchema: z.ZodObject<{
+    requestId: z.ZodString;
+} & {
+    cursor: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    requestId: string;
+    cursor: string;
+}, {
+    requestId: string;
+    cursor: string;
+}>;
+/** Durable save orchestration; domain validation and CAS remain in DashboardService. */
+export declare class DashboardSaveRequests {
+    private readonly service;
+    private readonly runtime;
+    private readonly queue;
+    constructor(service: DashboardService, runtime: RuntimeCapabilityRegistry, queue: ManagedQueueService);
+    submit(context: XpertResolvedViewHostContext, manifest: DashboardManifest, expectedVersionId: string | null, expectedRevision: number, idempotencyKey: string, sourceFile?: z.infer<typeof sourceFileSchema>, dependencies?: ArtifactDocumentDependencyAsset[]): Promise<{
+        cursor: string;
+        nextAction: string;
+        error?: string | undefined;
+        sourceFile?: {
+            path: string;
+            sha256: string;
+        } | undefined;
+        dashboard?: {
+            status: "draft";
+            title: string;
+            artifactId: string;
+            draftRevision: number;
+            draftId: string;
+            baseVersionId: string | null;
+        } | undefined;
+        requestId: string;
+        state: "failed" | "running" | "succeeded" | "queued";
+        stage: string;
+        completed: number;
+        total: number;
+        terminal: boolean;
+    }>;
+    private reference;
+    private enqueue;
+    private read;
+    private snapshot;
+    get(context: XpertResolvedViewHostContext, requestId: string): Promise<{
+        cursor: string;
+        nextAction: string;
+        error?: string | undefined;
+        sourceFile?: {
+            path: string;
+            sha256: string;
+        } | undefined;
+        dashboard?: {
+            status: "draft";
+            title: string;
+            artifactId: string;
+            draftRevision: number;
+            draftId: string;
+            baseVersionId: string | null;
+        } | undefined;
+        requestId: string;
+        state: "failed" | "running" | "succeeded" | "queued";
+        stage: string;
+        completed: number;
+        total: number;
+        terminal: boolean;
+    }>;
+    wait(context: XpertResolvedViewHostContext, requestId: string, cursor: string, signal?: AbortSignal): Promise<{
+        cursor: string;
+        nextAction: string;
+        error?: string | undefined;
+        sourceFile?: {
+            path: string;
+            sha256: string;
+        } | undefined;
+        dashboard?: {
+            status: "draft";
+            title: string;
+            artifactId: string;
+            draftRevision: number;
+            draftId: string;
+            baseVersionId: string | null;
+        } | undefined;
+        requestId: string;
+        state: "failed" | "running" | "succeeded" | "queued";
+        stage: string;
+        completed: number;
+        total: number;
+        terminal: boolean;
+    }>;
+    handle(job: ManagedQueueJob<{
+        requestId: string;
+    }>, identity: ManagedQueueJobContext): Promise<void>;
+}
+export {};