@xpert-ai/plugin-live-dashboard 0.1.2 → 0.1.4

package/dist/lib/dashboard-view.schema.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dashboardViewDataSchema = exports.dashboardSavedSchema = exports.dashboardSummarySchema = void 0;
+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_schema_1 = require("./dashboard.schema");
+const dashboard_navigation_1 = require("./dashboard-navigation");
+exports.dashboardSummarySchema = v3_1.z.object({ artifactId: v3_1.z.string(), versionId: v3_1.z.string().nullish(), versionNumber: v3_1.z.number().optional(), title: v3_1.z.string().nullish(), updatedAt: v3_1.z.string().optional(), draftRevision: v3_1.z.number().optional(), isDraft: v3_1.z.boolean().optional(), baseVersionId: v3_1.z.string().nullish() });
+exports.dashboardSavedSchema = exports.dashboardSummarySchema.extend({ manifest: dashboard_schema_1.dashboardSchema, dependencies: artifact_document_1.artifactDocumentDependencyAssets.optional() });
+// Source identities belong to Analytics, including immutable Definitions and Artifacts.
+// The viewer consumes only the reference and label; DataSource fields are not universal.
+exports.dashboardViewDataSchema = v3_1.z.object({ meta: v3_1.z.object({
+        navigationTarget: dashboard_navigation_1.dashboardNavigationTargetSchema.optional(),
+        dashboards: v3_1.z.array(exports.dashboardSummarySchema),
+        sources: v3_1.z.array(v3_1.z.object({ source: analytics_1.analyticsSourceRefSchema, name: v3_1.z.string() })),
+        saved: exports.dashboardSavedSchema.optional(),
+        versions: v3_1.z.array(exports.dashboardSummarySchema).optional()
+    }) });

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

@@ -1,6 +1,6 @@
 import { z } from 'zod/v3';
 export declare const dashboardSchema: z.ZodEffects<z.ZodObject<{
-    schema: z.ZodLiteral<"xpert.live-dashboard/v1">;
+    schema: z.ZodLiteral<"xpert.live-dashboard">;
     id: z.ZodString;
     title: z.ZodString;
     bindings: z.ZodArray<z.ZodType<import("@xpert-ai/contracts").AnalyticsBinding, z.ZodTypeDef, import("@xpert-ai/contracts").AnalyticsBinding>, "many">;
@@ -114,7 +114,7 @@ export declare const dashboardSchema: z.ZodEffects<z.ZodObject<{
         fields: string[];
     }>, "many">;
 }, "strict", z.ZodTypeAny, {
-    schema: "xpert.live-dashboard/v1";
+    schema: "xpert.live-dashboard";
     id: string;
     title: string;
     bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
@@ -146,7 +146,7 @@ export declare const dashboardSchema: z.ZodEffects<z.ZodObject<{
         dependencies?: import("@xpert-ai/plugin-sdk/artifact-document").ArtifactDocumentDependencyLock[] | undefined;
     } | undefined;
 }, {
-    schema: "xpert.live-dashboard/v1";
+    schema: "xpert.live-dashboard";
     id: string;
     title: string;
     bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
@@ -184,7 +184,7 @@ export declare const dashboardSchema: z.ZodEffects<z.ZodObject<{
         }[] | undefined;
     } | undefined;
 }>, {
-    schema: "xpert.live-dashboard/v1";
+    schema: "xpert.live-dashboard";
     id: string;
     title: string;
     bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
@@ -216,7 +216,7 @@ export declare const dashboardSchema: z.ZodEffects<z.ZodObject<{
         dependencies?: import("@xpert-ai/plugin-sdk/artifact-document").ArtifactDocumentDependencyLock[] | undefined;
     } | undefined;
 }, {
-    schema: "xpert.live-dashboard/v1";
+    schema: "xpert.live-dashboard";
     id: string;
     title: string;
     bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
@@ -442,7 +442,7 @@ export type DashboardChanges = z.output<typeof dashboardChangesSchema>;
 export declare const controlsSchema: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
 export declare const saveSchema: z.ZodObject<{
     manifest: z.ZodEffects<z.ZodObject<{
-        schema: z.ZodLiteral<"xpert.live-dashboard/v1">;
+        schema: z.ZodLiteral<"xpert.live-dashboard">;
         id: z.ZodString;
         title: z.ZodString;
         bindings: z.ZodArray<z.ZodType<import("@xpert-ai/contracts").AnalyticsBinding, z.ZodTypeDef, import("@xpert-ai/contracts").AnalyticsBinding>, "many">;
@@ -556,7 +556,7 @@ export declare const saveSchema: z.ZodObject<{
             fields: string[];
         }>, "many">;
     }, "strict", z.ZodTypeAny, {
-        schema: "xpert.live-dashboard/v1";
+        schema: "xpert.live-dashboard";
         id: string;
         title: string;
         bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
@@ -588,7 +588,7 @@ export declare const saveSchema: z.ZodObject<{
             dependencies?: import("@xpert-ai/plugin-sdk/artifact-document").ArtifactDocumentDependencyLock[] | undefined;
         } | undefined;
     }, {
-        schema: "xpert.live-dashboard/v1";
+        schema: "xpert.live-dashboard";
         id: string;
         title: string;
         bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
@@ -626,7 +626,7 @@ export declare const saveSchema: z.ZodObject<{
             }[] | undefined;
         } | undefined;
     }>, {
-        schema: "xpert.live-dashboard/v1";
+        schema: "xpert.live-dashboard";
         id: string;
         title: string;
         bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
@@ -658,7 +658,7 @@ export declare const saveSchema: z.ZodObject<{
             dependencies?: import("@xpert-ai/plugin-sdk/artifact-document").ArtifactDocumentDependencyLock[] | undefined;
         } | undefined;
     }, {
-        schema: "xpert.live-dashboard/v1";
+        schema: "xpert.live-dashboard";
         id: string;
         title: string;
         bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
@@ -700,7 +700,7 @@ export declare const saveSchema: z.ZodObject<{
     expectedRevision: z.ZodDefault<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
     manifest: {
-        schema: "xpert.live-dashboard/v1";
+        schema: "xpert.live-dashboard";
         id: string;
         title: string;
         bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
@@ -736,7 +736,7 @@ export declare const saveSchema: z.ZodObject<{
     expectedRevision: number;
 }, {
     manifest: {
-        schema: "xpert.live-dashboard/v1";
+        schema: "xpert.live-dashboard";
         id: string;
         title: string;
         bindings: import("@xpert-ai/contracts").AnalyticsBinding[];

package/dist/lib/dashboard.schema.js

@@ -6,7 +6,7 @@ const analytics_1 = require("@xpert-ai/plugin-sdk/analytics");
 const artifact_document_1 = require("@xpert-ai/plugin-sdk/artifact-document");
 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/v1'), id: v3_1.z.string().uuid(), title: v3_1.z.string().min(1).max(160),
+    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).min(1).max(8),
     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']),

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

@@ -27,7 +27,7 @@ export declare class DashboardService {
     }>;
     open(context: XpertResolvedViewHostContext, artifactId: string, versionId?: string, draftRevision?: number): Promise<{
         manifest: {
-            schema: "xpert.live-dashboard/v1";
+            schema: "xpert.live-dashboard";
             id: string;
             title: string;
             bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
@@ -72,7 +72,7 @@ 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): Promise<{
         manifest: {
-            schema: "xpert.live-dashboard/v1";
+            schema: "xpert.live-dashboard";
             id: string;
             title: string;
             bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
@@ -195,7 +195,7 @@ export declare class DashboardService {
         } | undefined;
         datasets: import("@xpert-ai/contracts").AnalyticalDataset[];
         manifest: {
-            schema: "xpert.live-dashboard/v1";
+            schema: "xpert.live-dashboard";
             id: string;
             title: string;
             bindings: import("@xpert-ai/contracts").AnalyticsBinding[];

package/dist/lib/dashboard.service.js

@@ -159,12 +159,9 @@ let DashboardService = class DashboardService {
             const samples = [...(alternative !== undefined ? [alternative] : []),
                 ...(current !== null && parameter.allowedValues?.includes(null) ? [null] : [])];
             for (const value of samples) {
-                try {
-                    await this.runtime.require(plugin_sdk_1.AnalyticsRuntimeCapability).query(actor(context), { binding, controls: { ...controls, [parameter.controlId]: value } });
-                }
-                catch {
-                    throw new common_1.BadRequestException(`DASHBOARD_FILTER_PREVIEW_FAILED: ${parameter.controlId}; a declared non-default filter failed. Inspect the native parameter type and operator before retrying.`);
-                }
+                // 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 } });
             }
         }
     }

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

@@ -0,0 +1,56 @@
+import { z } from 'zod/v3';
+import { type IAgentMiddlewareContext } from '@xpert-ai/plugin-sdk';
+export declare const DEFINITION_GUIDANCE = "If dashboard_list_sources lacks the requested source, call analytics_definition_connections, then analytics_definition_inspect with an exact returned selection and inputJson=\"{}\". Follow its instructions, inspect real source data and generate the business definition yourself. Never ask users to fill internal IDs/configuration. Register using analytics_definition_register and a stable requestId, refresh dashboard_list_sources, discover the returned source and preview before saving. Settings \u2192 Analytics is for viewing, correction and version management. Do not create redundant definitions for already governed sources.";
+export declare function createDefinitionTools(context: IAgentMiddlewareContext, registered: () => void): (import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>, {}, {}, string> | import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+    providerId: z.ZodString;
+    connectionKey: z.ZodString;
+} & {
+    inputJson: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    providerId: string;
+    connectionKey: string;
+    inputJson: string;
+}, {
+    providerId: string;
+    connectionKey: string;
+    inputJson: string;
+}>, {
+    providerId: string;
+    connectionKey: string;
+    inputJson: string;
+}, {
+    providerId: string;
+    connectionKey: string;
+    inputJson: string;
+}, string> | import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+    providerId: z.ZodString;
+    connectionKey: z.ZodString;
+} & {
+    requestId: z.ZodString;
+    name: z.ZodString;
+    definitionJson: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    providerId: string;
+    connectionKey: string;
+    requestId: string;
+    definitionJson: string;
+}, {
+    name: string;
+    providerId: string;
+    connectionKey: string;
+    requestId: string;
+    definitionJson: string;
+}>, {
+    name: string;
+    providerId: string;
+    connectionKey: string;
+    requestId: string;
+    definitionJson: string;
+}, {
+    name: string;
+    providerId: string;
+    connectionKey: string;
+    requestId: string;
+    definitionJson: string;
+}, string>)[];

package/dist/lib/definition-tools.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFINITION_GUIDANCE = void 0;
+exports.createDefinitionTools = createDefinitionTools;
+const tools_1 = require("@langchain/core/tools");
+const v3_1 = require("zod/v3");
+const plugin_sdk_1 = require("@xpert-ai/plugin-sdk");
+const selection = v3_1.z.object({ providerId: v3_1.z.string().min(1).max(160), connectionKey: v3_1.z.string().min(1).max(400) }).strict();
+exports.DEFINITION_GUIDANCE = 'If dashboard_list_sources lacks the requested source, call analytics_definition_connections, then analytics_definition_inspect with an exact returned selection and inputJson="{}". Follow its instructions, inspect real source data and generate the business definition yourself. Never ask users to fill internal IDs/configuration. Register using analytics_definition_register and a stable requestId, refresh dashboard_list_sources, discover the returned source and preview before saving. Settings → Analytics is for viewing, correction and version management. Do not create redundant definitions for already governed sources.';
+function createDefinitionTools(context, registered) {
+    const api = () => {
+        if (!context.workspaceId || !context.xpertId || !context.organizationId || !context.runtime?.capabilities)
+            throw new Error('ANALYTICS_ASSISTANT_SCOPE_REQUIRED');
+        return { runtime: context.runtime.capabilities.require(plugin_sdk_1.AnalyticsDefinitionAuthoringCapability), scope: {
+                actor: { tenantId: context.tenantId, organizationId: context.organizationId, userId: context.userId },
+                workspaceId: context.workspaceId, xpertId: context.xpertId,
+                files: context.runtime.capabilities.require(plugin_sdk_1.WorkspaceFilesRuntimeCapability)
+            } };
+    };
+    return [
+        (0, tools_1.tool)(async () => { const { runtime, scope } = api(); return JSON.stringify(await runtime.catalog(scope)); }, {
+            name: 'analytics_definition_connections', description: 'List authorized connections for generating a missing analytics source. Returns exact providerId/connectionKey selections; no credentials.',
+            schema: v3_1.z.object({}).strict(), metadata: { toolName: { en_US: 'Find analytics inputs', zh_Hans: '发现分析输入' } }
+        }),
+        (0, tools_1.tool)(async ({ inputJson, ...selection }) => {
+            const { runtime, scope } = api();
+            return JSON.stringify(await runtime.inspect(scope, selection, plugin_sdk_1.analyticsOptionsSchema.parse(JSON.parse(inputJson))));
+        }, { name: 'analytics_definition_inspect', description: 'Inspect approved input metadata and provider authoring schemas. Start inputJson="{}". Follow inspectSchema for operation samples/file inspection. Input cannot override host scope.',
+            schema: selection.extend({ inputJson: v3_1.z.string().min(2).max(100000) }).strict(), verboseParsingErrors: true,
+            metadata: { toolName: { en_US: 'Inspect analytics input', zh_Hans: '检查分析输入' } }
+        }),
+        (0, tools_1.tool)(async ({ definitionJson, ...input }) => {
+            const { runtime, scope } = api();
+            const receipt = await runtime.register(scope, { ...input, definition: plugin_sdk_1.analyticsOptionsSchema.parse(JSON.parse(definitionJson)) });
+            registered();
+            return JSON.stringify(receipt);
+        }, { name: 'analytics_definition_register', description: 'Register an Agent-generated definition matching definitionSchema. System supplies identities and validates real input. Keep requestId stable on retries; changed intent needs another key. Returns an immutable source and discoveryRequest. Refresh sources, discover and preview it before saving a dashboard.',
+            schema: selection.extend({ requestId: v3_1.z.string().min(1).max(128), name: v3_1.z.string().min(1).max(200), definitionJson: v3_1.z.string().min(2).max(100000) }).strict(), verboseParsingErrors: true,
+            metadata: { toolName: { en_US: 'Register analytics definition', zh_Hans: '生成分析定义' } }
+        })
+    ];
+}

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

@@ -5,7 +5,7 @@ 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/v1";
+        schema: "xpert.live-dashboard";
         id: string;
         title: string;
         bindings: import("@xpert-ai/contracts").AnalyticsBinding[];

package/dist/lib/document-package.js

@@ -8,13 +8,13 @@ const artifact_document_1 = require("@xpert-ai/plugin-sdk/artifact-document");
 const dashboard_schema_1 = require("./dashboard.schema");
 exports.MAX_DASHBOARD_PACKAGE_BYTES = 9_000_000;
 const storedSchema = v3_1.z.union([
-    v3_1.z.object({ schema: v3_1.z.literal('xpert.live-dashboard.package/v1'), manifest: dashboard_schema_1.dashboardSchema, dependencies: artifact_document_1.artifactDocumentDependencyAssets }).strict(),
+    v3_1.z.object({ schema: v3_1.z.literal('xpert.live-dashboard.package'), manifest: dashboard_schema_1.dashboardSchema, dependencies: artifact_document_1.artifactDocumentDependencyAssets }).strict(),
     dashboard_schema_1.dashboardSchema.transform(manifest => ({ manifest, dependencies: [] }))
 ]);
 /** Definition and exact library bytes share one immutable Artifact Version and content checksum. */
 function encodeDashboardPackage(manifest, dependencies) {
     (0, artifact_document_1.verifyArtifactDocumentDependencies)(dependencies, manifest.presentation?.dependencies ?? []);
-    return Buffer.from(JSON.stringify(dependencies.length ? { schema: 'xpert.live-dashboard.package/v1', manifest, dependencies } : manifest));
+    return Buffer.from(JSON.stringify(dependencies.length ? { schema: 'xpert.live-dashboard.package', manifest, dependencies } : manifest));
 }
 function decodeDashboardPackage(bytes) {
     if (bytes.byteLength > exports.MAX_DASHBOARD_PACKAGE_BYTES)

package/dist/lib/middleware.d.ts

@@ -6,5 +6,5 @@ export declare class DashboardMiddleware implements IAgentMiddlewareStrategy {
     private readonly service;
     readonly meta: TAgentMiddlewareMeta;
     constructor(service: DashboardService);
-    createMiddleware(_options: object, context: IAgentMiddlewareContext): AgentMiddleware;
+    createMiddleware(_options: unknown, context: IAgentMiddlewareContext): AgentMiddleware;
 }

package/dist/lib/middleware.js

@@ -10,6 +10,9 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DashboardMiddleware = exports.DASHBOARD_GUIDANCE = void 0;
+const definition_tools_1 = require("./definition-tools");
+const analytics_source_1 = require("./analytics-source");
+const analytics_1 = require("@xpert-ai/plugin-sdk/analytics");
 const messages_1 = require("@langchain/core/messages");
 const tools_1 = require("@langchain/core/tools");
 const node_crypto_1 = require("node:crypto");
@@ -28,7 +31,7 @@ const filter_evidence_1 = require("./filter-evidence");
 const save_evidence_1 = require("./save-evidence");
 const resource_card_1 = require("./resource-card");
 const dashboard_icon_1 = require("./dashboard-icon");
-const middlewareOptionsSchema = v3_1.z.object({ allowedFinalProviders: v3_1.z.array(v3_1.z.string().min(1)).min(1).max(20).optional() }).strict();
+const middlewareOptionsSchema = v3_1.z.object({ allowedFinalProviders: v3_1.z.array(v3_1.z.string().min(1)).min(1).max(20).optional() }).strict().default({});
 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) {
@@ -57,7 +60,7 @@ let DashboardMiddleware = class DashboardMiddleware {
         const filterEvidence = (0, filter_evidence_1.createFilterEvidence)(this.service, scope, previews);
         const created = new Map();
         const preview = async (binding) => {
-            const contract = discovered.get(`${binding.dataSourceId}/${binding.providerId}`);
+            const contract = discovered.get(`${(0, analytics_1.analyticsSourceKey)(binding.source)}/${binding.providerId}`);
             if (!contract)
                 throw new Error('DASHBOARD_DISCOVER_REQUIRED');
             (0, plugin_sdk_1.validateAnalyticsPayload)(binding.payload, contract.payloadSchema);
@@ -96,7 +99,7 @@ let DashboardMiddleware = class DashboardMiddleware {
         const save = async (input, config, html, dependencies = []) => {
             const { previewIds, supersedesPaths, ...definition } = input;
             const bindings = resolvePreviews(previewIds);
-            const manifest = dashboard_schema_1.dashboardSchema.parse({ ...definition, bindings, schema: 'xpert.live-dashboard/v1', id: (0, node_crypto_1.randomUUID)(),
+            const manifest = dashboard_schema_1.dashboardSchema.parse({ ...definition, bindings, schema: 'xpert.live-dashboard', id: (0, node_crypto_1.randomUUID)(),
                 ...(html ? { presentation: { type: 'html', html, ...(dependencies.length ? { dependencies } : {}) } } : {}) });
             validateFinal(manifest, true);
             const key = hash({ input: { ...definition, previewIds }, html, dependencies });
@@ -141,13 +144,14 @@ let DashboardMiddleware = class DashboardMiddleware {
                     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: [
                             ...(typeof request.systemMessage?.content === 'string' ? [{ type: 'text', text: request.systemMessage.content }] : request.systemMessage?.content ?? []),
-                            { type: 'text', text: exports.DASHBOARD_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: exports.DASHBOARD_GUIDANCE + '\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.' : '') }
                         ] }) });
                 if (evidence.pending && result && !result.tool_calls?.length)
                     throw new Error('DASHBOARD_SAVE_NOT_CONFIRMED: the model stopped without a successful draft save receipt.');
                 return result;
             }, tools: [
                 filterEvidence.tool,
+                ...(0, definition_tools_1.createDefinitionTools)(context, () => { listedSources = undefined; }),
                 (0, tools_1.tool)(async () => JSON.stringify({ libraries: await (0, document_libraries_1.libraryLocks)(['echarts', 'three']),
                     pageRuntime: {
                         global: 'window.xpertLiveArtifact',
@@ -169,16 +173,16 @@ let DashboardMiddleware = class DashboardMiddleware {
                     schema: v3_1.z.object({}).strict(), verboseParsingErrors: true, metadata: { toolName: { en_US: 'List analytics sources', zh_Hans: '发现分析数据源' } }
                 }),
                 (0, tools_1.tool)(async (input) => {
-                    if (listedSources && !listedSources.some(source => source.id === input.dataSourceId && source.providers.some(provider => provider.id === input.providerId)))
-                        throw new Error(`DASHBOARD_SOURCE_SELECTION_INVALID: copy an exact dataSourceId/providerId pair from dashboard_list_sources; do not invent or combine IDs. Known pairs: ${JSON.stringify(listedSources.map(source => ({ dataSourceId: source.id, name: source.name, providerIds: source.providers.map(provider => provider.id) })))}. Refresh the list if the source changed. Initial requestJson is "{}"; then follow inspectRequest/nextRequest.`);
-                    const parsed = { dataSourceId: input.dataSourceId, providerId: input.providerId, request: (0, agent_schema_1.parseObjectJson)(input.requestJson) };
+                    if (listedSources && !listedSources.some(source => (0, analytics_source_1.sameAnalyticsResource)(source.source, input.source) && source.providers.some(provider => provider.id === input.providerId)))
+                        throw new Error(`DASHBOARD_SOURCE_SELECTION_INVALID: copy an exact source/providerId pair from dashboard_list_sources; do not invent or combine IDs. Known pairs: ${JSON.stringify(listedSources.map(source => ({ source: source.source, name: source.name, providerIds: source.providers.map(provider => provider.id) })))}. Refresh the list if the source changed. Initial requestJson is "{}"; then follow inspectRequest/nextRequest.`);
+                    const parsed = { source: input.source, providerId: input.providerId, request: (0, agent_schema_1.parseObjectJson)(input.requestJson) };
                     const result = await this.service.discover(scope, parsed);
-                    discovered.set(`${parsed.dataSourceId}/${parsed.providerId}`, result.queryContract);
+                    discovered.set(`${(0, analytics_1.analyticsSourceKey)(parsed.source)}/${parsed.providerId}`, result.queryContract);
                     return JSON.stringify(result);
                 }, { name: 'dashboard_discover', description: 'Discover provider-owned business metadata. Start requestJson="{}" then serialize inspectRequest/nextRequest. Inspect dataset fields, comments, measures and native query format before preview.',
                     schema: agent_schema_1.discoverToolSchema, verboseParsingErrors: true, metadata: { toolName: { en_US: 'Inspect business data', zh_Hans: '理解业务数据与指标' } } }),
                 (0, tools_1.tool)(async (input) => {
-                    const contract = discovered.get(`${input.binding.dataSourceId}/${input.binding.providerId}`);
+                    const contract = discovered.get(`${(0, analytics_1.analyticsSourceKey)(input.binding.source)}/${input.binding.providerId}`);
                     if (!contract)
                         throw new Error('DASHBOARD_DISCOVER_REQUIRED: discover the source before preview');
                     const binding = (0, agent_schema_1.fromAgentBinding)(input.binding, contract);

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

@@ -17,7 +17,7 @@ export declare class DashboardPresentationProvider implements IArtifactPresentat
                 title: string;
                 isDraft: boolean;
                 manifest: {
-                    schema: "xpert.live-dashboard/v1";
+                    schema: "xpert.live-dashboard";
                     id: string;
                     title: string;
                     bindings: import("@xpert-ai/contracts").AnalyticsBinding[];

package/dist/lib/resource-card.js

@@ -13,7 +13,7 @@ function dashboardResourceCard(scope, saved) {
         resource: { namespace: 'live_dashboard', type: 'live-dashboard', id: saved.artifactId, artifactId: saved.artifactId },
         title: saved.title,
         description: saved.state === 'draft' ? `Dashboard · Draft r${saved.revision}` : `Dashboard · v${saved.versionNumber}`,
-        icon: dashboard_icon_1.dashboardIcon,
+        icon: { type: dashboard_icon_1.dashboardIcon.type, value: dashboard_icon_1.dashboardIcon.value },
         open: {
             ...(0, dashboard_navigation_1.dashboardNavigationTarget)(scope), selectionId: saved.artifactId,
             ...(saved.state === 'published' && saved.versionId ? { parameters: { versionId: saved.versionId } } : {})

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

@@ -19,7 +19,7 @@ export declare class DashboardViewProvider implements IXpertViewExtensionProvide
         meta: {
             saved?: {
                 manifest: {
-                    schema: "xpert.live-dashboard/v1";
+                    schema: "xpert.live-dashboard";
                     id: string;
                     title: string;
                     bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
@@ -192,7 +192,7 @@ export declare class DashboardViewProvider implements IXpertViewExtensionProvide
             } | undefined;
             datasets: import("@xpert-ai/contracts").AnalyticalDataset[];
             manifest: {
-                schema: "xpert.live-dashboard/v1";
+                schema: "xpert.live-dashboard";
                 id: string;
                 title: string;
                 bindings: import("@xpert-ai/contracts").AnalyticsBinding[];

package/dist/lib/view.provider.js

@@ -20,6 +20,7 @@ const sharing_service_1 = require("./sharing.service");
 const dashboard_schema_1 = require("./dashboard.schema");
 const dashboard_receipt_1 = require("./dashboard-receipt");
 const dashboard_navigation_1 = require("./dashboard-navigation");
+const dashboard_icon_1 = require("./dashboard-icon");
 exports.VIEW_KEY = 'live-dashboard';
 exports.VIEW_PROVIDER = 'live-dashboard';
 exports.FEATURE = 'live_dashboard';
@@ -34,9 +35,9 @@ let DashboardViewProvider = class DashboardViewProvider {
         if (!(context.hostType === 'agent' && slot === 'agent.workbench' || context.hostType === 'project' && slot === 'detail.sections'))
             return [];
         return [{ key: exports.VIEW_KEY, title: text('Live dashboards', '实时看板'), hostType: context.hostType, slot, order: 35,
-                icon: { type: 'font', value: 'ri-bar-chart-box-line' }, refreshable: true, activation: { requiredFeatures: [exports.FEATURE] },
+                icon: dashboard_icon_1.dashboardIcon, refreshable: true, activation: { requiredFeatures: [exports.FEATURE] },
                 source: { provider: exports.VIEW_PROVIDER, plugin: dashboard_service_1.PLUGIN_NAME },
-                workbench: { fixed: true, menu: { enabled: true, label: text('Live dashboards', '实时看板'), order: 35 } },
+                workbench: { fixed: true, menu: { enabled: true, label: text('Live dashboards', '实时看板'), icon: dashboard_icon_1.dashboardIcon, order: 35 } },
                 view: { type: 'remote_component', runtime: 'react', protocolVersion: 1, component: { isolation: 'iframe', entry: exports.VIEW_KEY }, dataSource: { mode: 'platform' } },
                 dataSource: { mode: 'platform', querySchema: { supportsSelection: true, supportsParameters: true }, cache: { enabled: false } },
                 clientCommands: [{ key: contracts_1.ASSISTANT_CONTEXT_SET_COMMAND, label: text('Select dashboard for Assistant', '设置助理当前看板') },