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

package/.xpertai-plugin/plugin.json

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

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

@@ -64,7 +64,10 @@ export declare const dashboardPickerPageSchema: z.ZodObject<{
     }>, "many">;
     page: z.ZodNumber;
     hasMore: z.ZodBoolean;
+    canEdit: z.ZodDefault<z.ZodBoolean>;
+    mode: z.ZodOptional<z.ZodEnum<["draft", "published"]>>;
 }, "strip", z.ZodTypeAny, {
+    canEdit: boolean;
     page: number;
     items: {
         artifactId: string;
@@ -78,6 +81,7 @@ export declare const dashboardPickerPageSchema: z.ZodObject<{
         canDelete?: boolean | undefined;
     }[];
     hasMore: boolean;
+    mode?: "draft" | "published" | undefined;
 }, {
     page: number;
     items: {
@@ -92,6 +96,8 @@ export declare const dashboardPickerPageSchema: z.ZodObject<{
         canDelete?: boolean | undefined;
     }[];
     hasMore: boolean;
+    mode?: "draft" | "published" | undefined;
+    canEdit?: boolean | undefined;
 }>;
 export declare const dashboardSavedSchema: z.ZodObject<{
     artifactId: z.ZodString;
@@ -578,6 +584,37 @@ export declare const dashboardViewDataSchema: z.ZodObject<{
             updatedAt?: string | undefined;
             canDelete?: boolean | undefined;
         }>, "many">;
+        selectedDashboard: z.ZodOptional<z.ZodObject<{
+            artifactId: z.ZodString;
+            versionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            versionNumber: z.ZodOptional<z.ZodNumber>;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            updatedAt: z.ZodOptional<z.ZodString>;
+            draftRevision: z.ZodOptional<z.ZodNumber>;
+            canDelete: z.ZodOptional<z.ZodBoolean>;
+            isDraft: z.ZodOptional<z.ZodBoolean>;
+            baseVersionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            artifactId: string;
+            title?: string | null | undefined;
+            versionId?: string | null | undefined;
+            draftRevision?: number | undefined;
+            versionNumber?: number | undefined;
+            baseVersionId?: string | null | undefined;
+            isDraft?: boolean | undefined;
+            updatedAt?: string | undefined;
+            canDelete?: boolean | undefined;
+        }, {
+            artifactId: string;
+            title?: string | null | undefined;
+            versionId?: string | null | undefined;
+            draftRevision?: number | undefined;
+            versionNumber?: number | undefined;
+            baseVersionId?: string | null | undefined;
+            isDraft?: boolean | undefined;
+            updatedAt?: string | undefined;
+            canDelete?: boolean | undefined;
+        }>>;
         sources: z.ZodArray<z.ZodObject<{
             source: z.ZodType<import("@xpert-ai/contracts").AnalyticsSourceRef, z.ZodTypeDef, import("@xpert-ai/contracts").AnalyticsSourceRef>;
             name: z.ZodString;
@@ -1100,6 +1137,17 @@ export declare const dashboardViewDataSchema: z.ZodObject<{
             target: "workbench.view";
             viewKey: "live-dashboard__live-dashboard";
         } | undefined;
+        selectedDashboard?: {
+            artifactId: string;
+            title?: string | null | undefined;
+            versionId?: string | null | undefined;
+            draftRevision?: number | undefined;
+            versionNumber?: number | undefined;
+            baseVersionId?: string | null | undefined;
+            isDraft?: boolean | undefined;
+            updatedAt?: string | undefined;
+            canDelete?: boolean | undefined;
+        } | undefined;
         versions?: {
             artifactId: string;
             title?: string | null | undefined;
@@ -1207,6 +1255,17 @@ export declare const dashboardViewDataSchema: z.ZodObject<{
             target: "workbench.view";
             viewKey: "live-dashboard__live-dashboard";
         } | undefined;
+        selectedDashboard?: {
+            artifactId: string;
+            title?: string | null | undefined;
+            versionId?: string | null | undefined;
+            draftRevision?: number | undefined;
+            versionNumber?: number | undefined;
+            baseVersionId?: string | null | undefined;
+            isDraft?: boolean | undefined;
+            updatedAt?: string | undefined;
+            canDelete?: boolean | undefined;
+        } | undefined;
         versions?: {
             artifactId: string;
             title?: string | null | undefined;
@@ -1303,6 +1362,17 @@ export declare const dashboardViewDataSchema: z.ZodObject<{
             target: "workbench.view";
             viewKey: "live-dashboard__live-dashboard";
         } | undefined;
+        selectedDashboard?: {
+            artifactId: string;
+            title?: string | null | undefined;
+            versionId?: string | null | undefined;
+            draftRevision?: number | undefined;
+            versionNumber?: number | undefined;
+            baseVersionId?: string | null | undefined;
+            isDraft?: boolean | undefined;
+            updatedAt?: string | undefined;
+            canDelete?: boolean | undefined;
+        } | undefined;
         versions?: {
             artifactId: string;
             title?: string | null | undefined;
@@ -1412,6 +1482,17 @@ export declare const dashboardViewDataSchema: z.ZodObject<{
             target: "workbench.view";
             viewKey: "live-dashboard__live-dashboard";
         } | undefined;
+        selectedDashboard?: {
+            artifactId: string;
+            title?: string | null | undefined;
+            versionId?: string | null | undefined;
+            draftRevision?: number | undefined;
+            versionNumber?: number | undefined;
+            baseVersionId?: string | null | undefined;
+            isDraft?: boolean | undefined;
+            updatedAt?: string | undefined;
+            canDelete?: boolean | undefined;
+        } | undefined;
         versions?: {
             artifactId: string;
             title?: string | null | undefined;

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

@@ -8,7 +8,7 @@ const projects_schema_1 = require("./projects.schema");
 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(), canDelete: v3_1.z.boolean().optional(), isDraft: v3_1.z.boolean().optional(), baseVersionId: v3_1.z.string().nullish() });
-exports.dashboardPickerPageSchema = v3_1.z.object({ items: v3_1.z.array(exports.dashboardSummarySchema), page: v3_1.z.number().int().positive(), hasMore: v3_1.z.boolean() });
+exports.dashboardPickerPageSchema = v3_1.z.object({ items: v3_1.z.array(exports.dashboardSummarySchema), page: v3_1.z.number().int().positive(), hasMore: v3_1.z.boolean(), canEdit: v3_1.z.boolean().default(false), mode: v3_1.z.enum(['draft', 'published']).optional() });
 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.
@@ -20,6 +20,7 @@ exports.dashboardViewDataSchema = v3_1.z.object({ meta: v3_1.z.object({
         pagination: v3_1.z.object({ page: v3_1.z.number(), pageSize: v3_1.z.number(), hasMore: v3_1.z.boolean() }).optional(),
         navigationTarget: dashboard_navigation_1.dashboardNavigationTargetSchema.optional(),
         dashboards: v3_1.z.array(exports.dashboardSummarySchema),
+        selectedDashboard: exports.dashboardSummarySchema.optional(),
         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.service.d.ts

@@ -14,11 +14,11 @@ export declare class DashboardService {
     list(context: XpertResolvedViewHostContext): Promise<{
         title: string | null | undefined;
         draftRevision?: number | undefined;
+        updatedAt: string | Date | undefined;
         canDelete: boolean;
         artifactId: string;
         versionId: string | null | undefined;
         versionNumber: number | undefined;
-        updatedAt: string | Date | undefined;
     }[]>;
     access(context: XpertResolvedViewHostContext): Promise<DashboardAccess>;
     listPage(context: XpertResolvedViewHostContext, page?: number, pageSize?: number): Promise<{
@@ -28,11 +28,11 @@ export declare class DashboardService {
         items: {
             title: string | null | undefined;
             draftRevision?: number | undefined;
+            updatedAt: string | Date | undefined;
             canDelete: boolean;
             artifactId: string;
             versionId: string | null | undefined;
             versionNumber: number | undefined;
-            updatedAt: string | Date | undefined;
         }[];
     }>;
     searchPage(context: XpertResolvedViewHostContext, input: {
@@ -42,15 +42,24 @@ export declare class DashboardService {
         items: {
             title: string | null | undefined;
             draftRevision?: number | undefined;
+            updatedAt: string | Date | undefined;
             canDelete: boolean;
             artifactId: string;
             versionId: string | null | undefined;
             versionNumber: number | undefined;
-            updatedAt: string | Date | undefined;
         }[];
         page: number;
         hasMore: boolean;
     }>;
+    selectedSummary(context: XpertResolvedViewHostContext, artifactId: string): Promise<{
+        title: string | null | undefined;
+        draftRevision?: number | undefined;
+        canDelete: boolean;
+        artifactId: string;
+        versionId: string | null | undefined;
+        versionNumber: number | undefined;
+        updatedAt: string | Date | undefined;
+    } | undefined>;
     trash(context: XpertResolvedViewHostContext, artifactId: string, expectedRevision: number): Promise<{
         artifactId: string;
     }>;

package/dist/lib/dashboard.service.js

@@ -59,7 +59,7 @@ let DashboardService = class DashboardService {
         return { page, pageSize, hasMore: page * pageSize < result.total, items: items.filter(item => access.canReadDraft || !!item.currentVersionId).map(item => {
                 const draft = drafts.get(item.id);
                 return { ...summary(item), canDelete: !!draft && access.canManage,
-                    ...(draft ? { title: draft.title ?? item.title, draftRevision: draft.revision } : {}) };
+                    ...(draft ? { title: draft.title ?? item.title, draftRevision: draft.revision, updatedAt: draft.updatedAt ?? item.updatedAt } : {}) };
             }) };
     }
     async searchPage(context, input) {
@@ -76,6 +76,18 @@ let DashboardService = class DashboardService {
         }
         return { items: matches.slice(offset, offset + pageSize), page: input.page, hasMore: matches.length > offset + pageSize };
     }
+    async selectedSummary(context, artifactId) {
+        const access = await this.access(context);
+        const artifact = await this.runtime.require(plugin_sdk_1.ArtifactsRuntimeCapability).getArtifact(artifactId);
+        assertOwned(context, artifact);
+        if (artifact.status !== 'active')
+            throw new common_1.ForbiddenException('DASHBOARD_ARCHIVED');
+        if (!access.canReadDraft && !artifact.currentVersionId)
+            return undefined;
+        const draft = access.canReadDraft ? (await this.runtime.require(plugin_sdk_1.ArtifactDraftsRuntimeCapability).list([artifactId]))[0] : undefined;
+        return { ...summary(artifact), canDelete: !!draft && access.canManage,
+            ...(draft ? { title: draft.title ?? artifact.title, draftRevision: draft.revision } : {}) };
+    }
     async trash(context, artifactId, expectedRevision) {
         await this.authorizeProject(context, 'manage');
         const artifact = await this.runtime.require(plugin_sdk_1.ArtifactsRuntimeCapability).getArtifact(artifactId);

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

@@ -9,6 +9,20 @@ export declare const projectSearchSchema: z.ZodObject<{
     search?: string | undefined;
     page?: number | undefined;
 }>;
+export declare const dashboardSearchSchema: z.ZodObject<{
+    search: z.ZodDefault<z.ZodString>;
+    page: z.ZodDefault<z.ZodNumber>;
+} & {
+    projectId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    search: string;
+    page: number;
+    projectId?: string | undefined;
+}, {
+    search?: string | undefined;
+    page?: number | undefined;
+    projectId?: string | undefined;
+}>;
 export declare const dashboardProjectSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;

package/dist/lib/projects.schema.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.dashboardProjectsSchema = exports.dashboardProjectSchema = exports.projectSearchSchema = void 0;
+exports.dashboardProjectsSchema = exports.dashboardProjectSchema = exports.dashboardSearchSchema = exports.projectSearchSchema = void 0;
 const v3_1 = require("zod/v3");
 exports.projectSearchSchema = v3_1.z.object({ search: v3_1.z.string().trim().max(200).default(''), page: v3_1.z.number().int().positive().default(1) }).strict();
+exports.dashboardSearchSchema = exports.projectSearchSchema.extend({ projectId: v3_1.z.string().uuid().optional() });
 exports.dashboardProjectSchema = v3_1.z.object({ id: v3_1.z.string().uuid(), name: v3_1.z.string() });
 exports.dashboardProjectsSchema = v3_1.z.object({ items: v3_1.z.array(exports.dashboardProjectSchema), page: v3_1.z.number().int().positive(), hasMore: v3_1.z.boolean() });

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

@@ -12,6 +12,8 @@ export declare class DashboardProjectsService {
         id: string;
         name: string;
     } | null>;
+    /** A picker target is untrusted until membership and the Assistant binding are revalidated. */
+    pickerContext(context: XpertResolvedViewHostContext, targetProjectId: string): Promise<XpertResolvedViewHostContext>;
     list(context: XpertResolvedViewHostContext, input: z.infer<typeof projectSearchSchema>): Promise<{
         items: {
             id: string;

package/dist/lib/projects.service.js

@@ -35,6 +35,16 @@ let DashboardProjectsService = class DashboardProjectsService {
         const access = await this.runtime.require(plugin_sdk_1.ProjectAccessRuntimeCapability).assertAssistant({ actor: this.actor(context), projectId: id, assistantId: context.hostId });
         return { id, name: access.name ?? id };
     }
+    /** A picker target is untrusted until membership and the Assistant binding are revalidated. */
+    async pickerContext(context, targetProjectId) {
+        const access = await this.runtime.require(plugin_sdk_1.ProjectAccessRuntimeCapability).assertAssistant({
+            actor: this.actor(context), projectId: targetProjectId, assistantId: context.hostId
+        });
+        if (access.archived || access.projectId !== targetProjectId)
+            throw new common_1.ForbiddenException('DASHBOARD_ACCESS_DENIED');
+        // Domain reads/deletes accept a Project host. Do not fabricate file/conversation grants.
+        return { ...context, hostType: 'project', hostId: access.projectId, runtimeScope: undefined };
+    }
     async list(context, input) {
         const actor = this.actor(context), access = this.runtime.require(plugin_sdk_1.ProjectAccessRuntimeCapability);
         const projects = await access.listReadable({ actor });

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

@@ -33,12 +33,21 @@ export declare class DashboardViewProvider implements IXpertViewExtensionProvide
             dashboards: {
                 title: string | null | undefined;
                 draftRevision?: number | undefined;
+                updatedAt: string | Date | undefined;
                 canDelete: boolean;
                 artifactId: string;
                 versionId: string | null | undefined;
                 versionNumber: number | undefined;
-                updatedAt: string | Date | undefined;
             }[];
+            selectedDashboard: {
+                title: string | null | undefined;
+                draftRevision?: number | undefined;
+                updatedAt: string | Date | undefined;
+                canDelete: boolean;
+                artifactId: string;
+                versionId: string | null | undefined;
+                versionNumber: number | undefined;
+            } | undefined;
             pagination: {
                 page: number;
                 pageSize: number;
@@ -113,12 +122,21 @@ export declare class DashboardViewProvider implements IXpertViewExtensionProvide
             dashboards: {
                 title: string | null | undefined;
                 draftRevision?: number | undefined;
+                updatedAt: string | Date | undefined;
                 canDelete: boolean;
                 artifactId: string;
                 versionId: string | null | undefined;
                 versionNumber: number | undefined;
-                updatedAt: string | Date | undefined;
             }[];
+            selectedDashboard: {
+                title: string | null | undefined;
+                draftRevision?: number | undefined;
+                updatedAt: string | Date | undefined;
+                canDelete: boolean;
+                artifactId: string;
+                versionId: string | null | undefined;
+                versionNumber: number | undefined;
+            } | undefined;
             pagination: {
                 page: number;
                 pageSize: number;
@@ -139,12 +157,21 @@ export declare class DashboardViewProvider implements IXpertViewExtensionProvide
             dashboards: {
                 title: string | null | undefined;
                 draftRevision?: number | undefined;
+                updatedAt: string | Date | undefined;
                 canDelete: boolean;
                 artifactId: string;
                 versionId: string | null | undefined;
                 versionNumber: number | undefined;
-                updatedAt: string | Date | undefined;
             }[];
+            selectedDashboard: {
+                title: string | null | undefined;
+                draftRevision?: number | undefined;
+                updatedAt: string | Date | undefined;
+                canDelete: boolean;
+                artifactId: string;
+                versionId: string | null | undefined;
+                versionNumber: number | undefined;
+            } | undefined;
             pagination: {
                 page: number;
                 pageSize: number;
@@ -156,14 +183,16 @@ export declare class DashboardViewProvider implements IXpertViewExtensionProvide
     executeViewAction(context: XpertResolvedViewHostContext, viewKey: string, action: string, request: XpertViewActionRequest): Promise<{
         success: boolean;
         data: {
+            canEdit: boolean;
+            mode: string;
             items: {
                 title: string | null | undefined;
                 draftRevision?: number | undefined;
+                updatedAt: string | Date | undefined;
                 canDelete: boolean;
                 artifactId: string;
                 versionId: string | null | undefined;
                 versionNumber: number | undefined;
-                updatedAt: string | Date | undefined;
             }[];
             page: number;
             hasMore: boolean;

package/dist/lib/view.provider.js

@@ -11,6 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DashboardViewProvider = exports.FEATURE = exports.VIEW_PROVIDER = exports.VIEW_KEY = void 0;
 const projects_service_1 = require("./projects.service");
+const projects_schema_1 = require("./projects.schema");
 const common_1 = require("@nestjs/common");
 const v3_1 = require("zod/v3");
 const contracts_1 = require("@xpert-ai/contracts");
@@ -74,10 +75,13 @@ let DashboardViewProvider = class DashboardViewProvider {
         if (mode === 'draft' && !access.canReadDraft)
             throw new common_1.ForbiddenException('DASHBOARD_DRAFT_ACCESS_DENIED');
         const page = await this.service.listPage(context, params.page, params.pageSize);
+        const selectedDashboard = params.artifactId
+            ? page.items.find(item => item.artifactId === params.artifactId) ?? await this.service.selectedSummary(context, params.artifactId)
+            : undefined;
         const versions = params.artifactId ? await this.service.history(context, params.artifactId) : undefined;
         const unavailable = params.artifactId && mode === 'published' && !params.versionId && !versions?.some(version => version.current);
         return { meta: { navigationTarget: (0, dashboard_navigation_1.dashboardNavigationTarget)(context), access, mode, currentProject,
-                dashboards: page.items, pagination: { page: page.page, pageSize: page.pageSize, hasMore: page.hasMore },
+                dashboards: page.items, selectedDashboard, pagination: { page: page.page, pageSize: page.pageSize, hasMore: page.hasMore },
                 sources: access.canEdit ? await this.service.sources(context) : [],
                 ...(unavailable ? { notice: 'not_published' } : params.artifactId ? {
                     saved: await this.service.openDocument(context, params.artifactId, params.versionId, params.draftRevision, mode), versions
@@ -86,10 +90,13 @@ let DashboardViewProvider = class DashboardViewProvider {
     async executeViewAction(context, viewKey, action, request) {
         assertView(viewKey);
         if (action === 'dashboards') {
-            const parsed = projects_service_1.projectSearchSchema.safeParse(request.input);
+            const parsed = projects_schema_1.dashboardSearchSchema.safeParse(request.input);
             if (!parsed.success)
                 throw new common_1.BadRequestException('DASHBOARD_INVALID_PICKER_QUERY');
-            return { success: true, data: await this.service.searchPage(context, parsed.data), refresh: false };
+            const target = parsed.data.projectId ? await this.projects.pickerContext(context, parsed.data.projectId) : context;
+            const page = await this.service.searchPage(target, parsed.data);
+            const access = await this.service.access(target);
+            return { success: true, data: { ...page, canEdit: access.canEdit, mode: access.canReadDraft ? 'draft' : 'published' }, refresh: false };
         }
         if (action === 'projects')
             return { success: true, data: await this.projects.list(context, projects_service_1.projectSearchSchema.parse(request.input)), refresh: false };
@@ -100,11 +107,12 @@ let DashboardViewProvider = class DashboardViewProvider {
             return { success: true, data: action === 'share-status' ? await this.sharing.inspect(context, input.artifactId, input.versionId) : await this.sharing.revoke(context, input.artifactId), refresh: false };
         }
         if (action === 'delete') {
-            const parsed = v3_1.z.object({ artifactId: v3_1.z.string().uuid(), expectedRevision: v3_1.z.number().int().positive(), confirmed: v3_1.z.literal(true) }).strict().safeParse(request.input);
+            const parsed = v3_1.z.object({ artifactId: v3_1.z.string().uuid(), expectedRevision: v3_1.z.number().int().positive(), confirmed: v3_1.z.literal(true), projectId: v3_1.z.string().uuid().optional() }).strict().safeParse(request.input);
             if (!parsed.success)
                 throw new common_1.BadRequestException('DASHBOARD_DELETION_CONFIRMATION_REQUIRED');
             const input = parsed.data;
-            return { success: true, data: await this.service.trash(context, input.artifactId, input.expectedRevision), refresh: false };
+            const target = input.projectId ? await this.projects.pickerContext(context, input.projectId) : context;
+            return { success: true, data: await this.service.trash(target, input.artifactId, input.expectedRevision), refresh: false };
         }
         if (action === 'publish') {
             const parsed = v3_1.z.object({ artifactId: v3_1.z.string().uuid(), expectedRevision: v3_1.z.number().int().positive(),