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

package/.xpertai-plugin/plugin.json

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

package/README.md

@@ -49,7 +49,7 @@ The creation tool returns `{ dashboard: { artifactId, versionId, versionNumber,
 
 ## Save, filter, refresh
 
-`xpert.live-dashboard/v1` contains id/title/bindings/controls/charts/tables and optional `presentation: { type: "html", html }`. Charts reference stable Dataset field IDs. Controls map to typed binding parameters. Filter and refresh execute the saved server-side definition for the current viewer.
+`xpert.live-dashboard` contains id/title/bindings/controls/charts/tables and optional `presentation: { type: "html", html }`. Charts reference stable Dataset field IDs. Controls map to typed binding parameters. Filter and refresh execute the saved server-side definition for the current viewer.
 
 Save validates and queries all bindings before writing immutable JSON. `expectedVersionId` (null for new) and platform Artifact row-lock compare-and-set prevent lost updates. Content hashes support retries. Saved files contain definitions, not result rows.
 
@@ -75,7 +75,7 @@ The renderer runs in a script-only sandbox with no-network CSP. A small in-memor
 
 ## Build and validation
 
-Use the xpertai workspace's declared Corepack/pnpm. Development dependencies pin published SDK/contracts 3.25.0 and the Data Analytics renderer 0.1.35; no local platform or community links are required.
+Use the xpertai workspace's declared Corepack/pnpm. Development dependencies pin published SDK/contracts 3.26.1 and the Data Analytics renderer 0.1.35; no local platform or community links are required.
 
 ```sh
 corepack pnpm install --frozen-lockfile

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

@@ -1,20 +1,20 @@
 import { z } from 'zod/v3';
 import type { AnalyticsDiscoveryResult } from '@xpert-ai/contracts';
 export declare const discoverToolSchema: z.ZodObject<{
-    dataSourceId: z.ZodString;
+    source: z.ZodType<import("@xpert-ai/contracts").AnalyticsSourceRef, z.ZodTypeDef, import("@xpert-ai/contracts").AnalyticsSourceRef>;
     providerId: z.ZodString;
     requestJson: z.ZodDefault<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    dataSourceId: string;
+    source: import("@xpert-ai/contracts").AnalyticsSourceRef;
     providerId: string;
     requestJson: string;
 }, {
-    dataSourceId: string;
+    source: import("@xpert-ai/contracts").AnalyticsSourceRef;
     providerId: string;
     requestJson?: string | undefined;
 }>;
 export declare const agentBindingSchema: z.ZodObject<{
-    dataSourceId: z.ZodString;
+    source: z.ZodType<import("@xpert-ai/contracts").AnalyticsSourceRef, z.ZodTypeDef, import("@xpert-ai/contracts").AnalyticsSourceRef>;
     providerId: z.ZodString;
     output: z.ZodObject<{
         datasetId: z.ZodString;
@@ -97,6 +97,7 @@ export declare const agentBindingSchema: z.ZodObject<{
     }>, "many">;
     payloadJson: z.ZodString;
 }, "strict", z.ZodTypeAny, {
+    source: import("@xpert-ai/contracts").AnalyticsSourceRef;
     parameters: {
         type: "string" | "number" | "boolean" | "date";
         name: string;
@@ -104,7 +105,6 @@ export declare const agentBindingSchema: z.ZodObject<{
         defaultValue?: string | number | boolean | null | undefined;
         allowedValues?: (string | number | boolean | null)[] | undefined;
     }[];
-    dataSourceId: string;
     providerId: string;
     output: {
         datasetId?: string;
@@ -122,6 +122,7 @@ export declare const agentBindingSchema: z.ZodObject<{
     };
     payloadJson: string;
 }, {
+    source: import("@xpert-ai/contracts").AnalyticsSourceRef;
     parameters: {
         type: "string" | "number" | "boolean" | "date";
         name: string;
@@ -129,7 +130,6 @@ export declare const agentBindingSchema: z.ZodObject<{
         defaultValue?: string | number | boolean | null | undefined;
         allowedValues?: (string | number | boolean | null)[] | undefined;
     }[];
-    dataSourceId: string;
     providerId: string;
     output: {
         datasetId?: string;
@@ -149,7 +149,7 @@ export declare const agentBindingSchema: z.ZodObject<{
 }>;
 export declare const previewToolSchema: z.ZodObject<{
     binding: z.ZodObject<{
-        dataSourceId: z.ZodString;
+        source: z.ZodType<import("@xpert-ai/contracts").AnalyticsSourceRef, z.ZodTypeDef, import("@xpert-ai/contracts").AnalyticsSourceRef>;
         providerId: z.ZodString;
         output: z.ZodObject<{
             datasetId: z.ZodString;
@@ -232,6 +232,7 @@ export declare const previewToolSchema: z.ZodObject<{
         }>, "many">;
         payloadJson: z.ZodString;
     }, "strict", z.ZodTypeAny, {
+        source: import("@xpert-ai/contracts").AnalyticsSourceRef;
         parameters: {
             type: "string" | "number" | "boolean" | "date";
             name: string;
@@ -239,7 +240,6 @@ export declare const previewToolSchema: z.ZodObject<{
             defaultValue?: string | number | boolean | null | undefined;
             allowedValues?: (string | number | boolean | null)[] | undefined;
         }[];
-        dataSourceId: string;
         providerId: string;
         output: {
             datasetId?: string;
@@ -257,6 +257,7 @@ export declare const previewToolSchema: z.ZodObject<{
         };
         payloadJson: string;
     }, {
+        source: import("@xpert-ai/contracts").AnalyticsSourceRef;
         parameters: {
             type: "string" | "number" | "boolean" | "date";
             name: string;
@@ -264,7 +265,6 @@ export declare const previewToolSchema: z.ZodObject<{
             defaultValue?: string | number | boolean | null | undefined;
             allowedValues?: (string | number | boolean | null)[] | undefined;
         }[];
-        dataSourceId: string;
         providerId: string;
         output: {
             datasetId?: string;
@@ -284,6 +284,7 @@ export declare const previewToolSchema: z.ZodObject<{
     }>;
 }, "strict", z.ZodTypeAny, {
     binding: {
+        source: import("@xpert-ai/contracts").AnalyticsSourceRef;
         parameters: {
             type: "string" | "number" | "boolean" | "date";
             name: string;
@@ -291,7 +292,6 @@ export declare const previewToolSchema: z.ZodObject<{
             defaultValue?: string | number | boolean | null | undefined;
             allowedValues?: (string | number | boolean | null)[] | undefined;
         }[];
-        dataSourceId: string;
         providerId: string;
         output: {
             datasetId?: string;
@@ -311,6 +311,7 @@ export declare const previewToolSchema: z.ZodObject<{
     };
 }, {
     binding: {
+        source: import("@xpert-ai/contracts").AnalyticsSourceRef;
         parameters: {
             type: "string" | "number" | "boolean" | "date";
             name: string;
@@ -318,7 +319,6 @@ export declare const previewToolSchema: z.ZodObject<{
             defaultValue?: string | number | boolean | null | undefined;
             allowedValues?: (string | number | boolean | null)[] | undefined;
         }[];
-        dataSourceId: string;
         providerId: string;
         output: {
             datasetId?: string;

package/dist/lib/agent.schema.js

@@ -14,9 +14,9 @@ const agentControlsSchema = v3_1.z.array(dashboard_schema_1.dashboardSchema.inne
     defaultValue: dashboard_schema_1.dashboardSchema.innerType().shape.controls.element.shape.defaultValue.unwrap()
         .describe('Required: copy the verified Binding parameter defaultValue, including explicit null for an all-values filter.')
 })).max(24);
-exports.discoverToolSchema = v3_1.z.object({ dataSourceId: v3_1.z.string().uuid(), providerId: v3_1.z.string().min(1).max(160),
+exports.discoverToolSchema = v3_1.z.object({ source: analytics_1.analyticsSourceRefSchema, providerId: v3_1.z.string().min(1).max(160),
     requestJson: objectJson.default('{}').describe('JSON text. Start with "{}"; then JSON.stringify the returned inspectRequest/nextRequest directly. Do not wrap it in inspectRequest.') }).strict();
-exports.agentBindingSchema = analytics_1.analyticsBindingObjectSchema.omit({ payload: true, schemaVersion: true, id: true, operation: true, contractVersion: true }).extend({
+exports.agentBindingSchema = analytics_1.analyticsBindingObjectSchema.omit({ payload: true, id: true, operation: true, contractVersion: true }).extend({
     parameters: v3_1.z.array(analytics_1.analyticsBindingObjectSchema.shape.parameters.element.omit({ controlId: true })).max(24),
     payloadJson: objectJson
 }).strict();
@@ -46,7 +46,7 @@ function parseObjectJson(text) {
 }
 function fromAgentBinding(input, contract) {
     const { payloadJson, ...binding } = input;
-    return analytics_1.analyticsBindingSchema.parse({ ...binding, schemaVersion: 1, id: input.output.datasetId,
+    return analytics_1.analyticsBindingSchema.parse({ ...binding, id: input.output.datasetId,
         operation: contract.operation, contractVersion: contract.contractVersion,
         parameters: input.parameters.map(parameter => ({ ...parameter, controlId: parameter.name })), payload: parseObjectJson(payloadJson) });
 }

package/dist/lib/analytics-source.d.ts

@@ -0,0 +1,3 @@
+import type { AnalyticsSourceRef } from '@xpert-ai/contracts';
+/** Catalogs show the latest version; historical pinned queries still resolve through the host ACL. */
+export declare function sameAnalyticsResource(left: AnalyticsSourceRef, right: AnalyticsSourceRef): boolean;

package/dist/lib/analytics-source.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sameAnalyticsResource = sameAnalyticsResource;
+/** Catalogs show the latest version; historical pinned queries still resolve through the host ACL. */
+function sameAnalyticsResource(left, right) {
+    if (left.kind === 'data-source')
+        return right.kind === 'data-source' && left.dataSourceId === right.dataSourceId;
+    if (left.kind === 'definition')
+        return right.kind === 'definition' && left.definitionId === right.definitionId;
+    return right.kind === 'artifact' && left.artifactId === right.artifactId;
+}

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

@@ -1,5 +1,6 @@
-/** Self-contained for hosts that do not load the plugin's icon font. */
+/** Rising data columns with a detached live signal, legible without host fonts or CSS. */
 export declare const dashboardIcon: {
     type: "svg";
+    alt: string;
     value: string;
 };

package/dist/lib/dashboard-icon.js

@@ -1,8 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dashboardIcon = void 0;
-/** Self-contained for hosts that do not load the plugin's icon font. */
+const palette = { tile: '#EAF0FA', chart: '#3659A2', live: '#178577' };
+/** Rising data columns with a detached live signal, legible without host fonts or CSS. */
 exports.dashboardIcon = {
     type: 'svg',
-    value: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="18" height="18" rx="3"/><path d="M7 16v-4m5 4V7m5 9v-6"/></svg>'
+    alt: 'Live dashboards',
+    value: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="none">
+    <rect x="24" y="24" width="208" height="208" rx="40" fill="${palette.tile}"/>
+    <rect x="66" y="144" width="26" height="44" rx="7" fill="${palette.chart}"/>
+    <rect x="114" y="112" width="26" height="76" rx="7" fill="${palette.chart}"/>
+    <rect x="162" y="96" width="26" height="92" rx="7" fill="${palette.live}"/>
+    <circle cx="175" cy="72" r="13" fill="${palette.live}"/>
+  </svg>`
 };

package/dist/lib/dashboard-sharing.js

@@ -2,12 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DASHBOARD_SHARE_KEY = void 0;
 exports.dashboardSharingIssues = dashboardSharingIssues;
+const analytics_source_1 = require("./analytics-source");
 exports.DASHBOARD_SHARE_KEY = 'team-readonly';
 /** Apply the same provider policy when enabling a share and advancing a latest share. */
 function dashboardSharingIssues(manifest, sources) {
     const issues = [];
     for (const binding of manifest.bindings) {
-        const provider = sources.find(source => source.id === binding.dataSourceId)?.providers.find(provider => provider.id === binding.providerId);
+        const provider = sources.find(source => (0, analytics_source_1.sameAnalyticsResource)(source.source, binding.source))?.providers.find(provider => provider.id === binding.providerId);
         if (!provider)
             issues.push({ code: 'DASHBOARD_SOURCE_UNAVAILABLE', bindingId: binding.id });
         else if (provider.sharing?.mode === 'owner_only')