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

package/.xpertai-plugin/plugin.json

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

package/README.md

@@ -4,6 +4,10 @@ System plugin `@xpert-ai/plugin-live-dashboard`: versioned live dashboards using
 
 See [implementation and installed-runtime acceptance](docs/acceptance.md) and [one-sentence Agent acceptance](docs/agent-acceptance.md). `examples/` contains equivalent PostgreSQL and data-xpert bindings for the same chart.
 
+Sources, component Inspect and portable dashboard archives are tracked in the
+[feature guide](docs/sources-inspect-portability.mdx) and
+[current acceptance record](docs/sources-inspect-portability-acceptance.mdx).
+
 ## Ownership and flow
 
 ```text

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

@@ -15,6 +15,7 @@ export declare const discoverToolSchema: z.ZodObject<{
 }>;
 export declare const agentBindingSchema: z.ZodObject<{
     source: z.ZodType<import("@xpert-ai/contracts").AnalyticsSourceRef, z.ZodTypeDef, import("@xpert-ai/contracts").AnalyticsSourceRef>;
+    providerId: z.ZodString;
     output: z.ZodObject<{
         datasetId: z.ZodString;
         fields: z.ZodArray<z.ZodObject<{
@@ -73,7 +74,6 @@ export declare const agentBindingSchema: z.ZodObject<{
         }[];
         grain?: string[];
     }>;
-    providerId: z.ZodString;
 } & {
     parameters: z.ZodArray<z.ZodObject<Omit<{
         name: z.ZodString;
@@ -98,6 +98,7 @@ export declare const agentBindingSchema: z.ZodObject<{
     payloadJson: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+    providerId: string;
     output: {
         datasetId?: string;
         fields?: {
@@ -119,10 +120,10 @@ export declare const agentBindingSchema: z.ZodObject<{
         defaultValue?: string | number | boolean | null | undefined;
         allowedValues?: (string | number | boolean | null)[] | undefined;
     }[];
-    providerId: string;
     payloadJson: string;
 }, {
     source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+    providerId: string;
     output: {
         datasetId?: string;
         fields?: {
@@ -144,12 +145,12 @@ export declare const agentBindingSchema: z.ZodObject<{
         defaultValue?: string | number | boolean | null | undefined;
         allowedValues?: (string | number | boolean | null)[] | undefined;
     }[];
-    providerId: string;
     payloadJson: string;
 }>;
 export declare const previewToolSchema: z.ZodObject<{
     binding: z.ZodObject<{
         source: z.ZodType<import("@xpert-ai/contracts").AnalyticsSourceRef, z.ZodTypeDef, import("@xpert-ai/contracts").AnalyticsSourceRef>;
+        providerId: z.ZodString;
         output: z.ZodObject<{
             datasetId: z.ZodString;
             fields: z.ZodArray<z.ZodObject<{
@@ -208,7 +209,6 @@ export declare const previewToolSchema: z.ZodObject<{
             }[];
             grain?: string[];
         }>;
-        providerId: z.ZodString;
     } & {
         parameters: z.ZodArray<z.ZodObject<Omit<{
             name: z.ZodString;
@@ -233,6 +233,7 @@ export declare const previewToolSchema: z.ZodObject<{
         payloadJson: z.ZodString;
     }, "strict", z.ZodTypeAny, {
         source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+        providerId: string;
         output: {
             datasetId?: string;
             fields?: {
@@ -254,10 +255,10 @@ export declare const previewToolSchema: z.ZodObject<{
             defaultValue?: string | number | boolean | null | undefined;
             allowedValues?: (string | number | boolean | null)[] | undefined;
         }[];
-        providerId: string;
         payloadJson: string;
     }, {
         source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+        providerId: string;
         output: {
             datasetId?: string;
             fields?: {
@@ -279,12 +280,12 @@ export declare const previewToolSchema: z.ZodObject<{
             defaultValue?: string | number | boolean | null | undefined;
             allowedValues?: (string | number | boolean | null)[] | undefined;
         }[];
-        providerId: string;
         payloadJson: string;
     }>;
 }, "strict", z.ZodTypeAny, {
     binding: {
         source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+        providerId: string;
         output: {
             datasetId?: string;
             fields?: {
@@ -306,12 +307,12 @@ export declare const previewToolSchema: z.ZodObject<{
             defaultValue?: string | number | boolean | null | undefined;
             allowedValues?: (string | number | boolean | null)[] | undefined;
         }[];
-        providerId: string;
         payloadJson: string;
     };
 }, {
     binding: {
         source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+        providerId: string;
         output: {
             datasetId?: string;
             fields?: {
@@ -333,7 +334,6 @@ export declare const previewToolSchema: z.ZodObject<{
             defaultValue?: string | number | boolean | null | undefined;
             allowedValues?: (string | number | boolean | null)[] | undefined;
         }[];
-        providerId: string;
         payloadJson: string;
     };
 }>;
@@ -376,25 +376,25 @@ export declare const createToolSchema: z.ZodObject<{} & {
         y: z.ZodString;
         color: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
+        title: string;
         type: "bar" | "line" | "area" | "pie" | "scatter";
         id: string;
-        title: string;
         datasetId: string;
         x: string;
         y: string;
         color?: string | undefined;
     }, {
+        title: string;
         type: "bar" | "line" | "area" | "pie" | "scatter";
         id: string;
-        title: string;
         datasetId: string;
         x: string;
         y: string;
         color?: string | undefined;
     }>, "many">, {
+        title: string;
         type: "bar" | "line" | "area" | "pie" | "scatter";
         id: string;
-        title: string;
         datasetId: string;
         x: string;
         y: string;
@@ -406,21 +406,81 @@ export declare const createToolSchema: z.ZodObject<{} & {
         datasetId: z.ZodString;
         fields: z.ZodArray<z.ZodString, "many">;
     }, "strict", z.ZodTypeAny, {
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         fields: string[];
     }, {
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         fields: string[];
     }>, "many">, {
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         fields: string[];
     }[], unknown>;
+    sourceMetadata: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
+        bindingId: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        bindingId: string;
+        title: string;
+        description?: string | undefined;
+    }, {
+        bindingId: string;
+        title: string;
+        description?: string | undefined;
+    }>, "many">, {
+        bindingId: string;
+        title: string;
+        description?: string | undefined;
+    }[], unknown>>;
+    components: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        elementId: z.ZodString;
+        title: z.ZodString;
+        kind: z.ZodEnum<["metric", "chart", "table", "filter", "text"]>;
+        sources: z.ZodArray<z.ZodObject<{
+            bindingId: z.ZodString;
+            fieldIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }, {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        title: string;
+        id: string;
+        elementId: string;
+        kind: "filter" | "metric" | "chart" | "table" | "text";
+        sources: {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }[];
+    }, {
+        title: string;
+        id: string;
+        elementId: string;
+        kind: "filter" | "metric" | "chart" | "table" | "text";
+        sources: {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }[];
+    }>, "many">, {
+        title: string;
+        id: string;
+        elementId: string;
+        kind: "filter" | "metric" | "chart" | "table" | "text";
+        sources: {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }[];
+    }[], unknown>>;
     previewIds: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>;
 }, "strict", z.ZodTypeAny, {
     title: string;
@@ -432,25 +492,42 @@ export declare const createToolSchema: z.ZodObject<{} & {
         allowedValues?: (string | number | boolean | null)[] | undefined;
     }[];
     charts: {
+        title: string;
         type: "bar" | "line" | "area" | "pie" | "scatter";
         id: string;
-        title: string;
         datasetId: string;
         x: string;
         y: string;
         color?: string | undefined;
     }[];
     tables: {
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         fields: string[];
     }[];
     previewIds: string[];
+    sourceMetadata?: {
+        bindingId: string;
+        title: string;
+        description?: string | undefined;
+    }[] | undefined;
+    components?: {
+        title: string;
+        id: string;
+        elementId: string;
+        kind: "filter" | "metric" | "chart" | "table" | "text";
+        sources: {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }[];
+    }[] | undefined;
     creationIntent?: "new" | "copy" | undefined;
     supersedesPaths?: string[] | undefined;
 }, {
     title: string;
+    sourceMetadata?: unknown;
+    components?: unknown;
     controls?: unknown;
     charts?: unknown;
     tables?: unknown;
@@ -498,25 +575,25 @@ export declare const createHtmlToolSchema: z.ZodObject<Omit<{} & {
         y: z.ZodString;
         color: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
+        title: string;
         type: "bar" | "line" | "area" | "pie" | "scatter";
         id: string;
-        title: string;
         datasetId: string;
         x: string;
         y: string;
         color?: string | undefined;
     }, {
+        title: string;
         type: "bar" | "line" | "area" | "pie" | "scatter";
         id: string;
-        title: string;
         datasetId: string;
         x: string;
         y: string;
         color?: string | undefined;
     }>, "many">, {
+        title: string;
         type: "bar" | "line" | "area" | "pie" | "scatter";
         id: string;
-        title: string;
         datasetId: string;
         x: string;
         y: string;
@@ -528,28 +605,88 @@ export declare const createHtmlToolSchema: z.ZodObject<Omit<{} & {
         datasetId: z.ZodString;
         fields: z.ZodArray<z.ZodString, "many">;
     }, "strict", z.ZodTypeAny, {
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         fields: string[];
     }, {
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         fields: string[];
     }>, "many">, {
-        id: string;
         title: string;
+        id: string;
         datasetId: string;
         fields: string[];
     }[], unknown>;
+    sourceMetadata: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
+        bindingId: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        bindingId: string;
+        title: string;
+        description?: string | undefined;
+    }, {
+        bindingId: string;
+        title: string;
+        description?: string | undefined;
+    }>, "many">, {
+        bindingId: string;
+        title: string;
+        description?: string | undefined;
+    }[], unknown>>;
+    components: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        elementId: z.ZodString;
+        title: z.ZodString;
+        kind: z.ZodEnum<["metric", "chart", "table", "filter", "text"]>;
+        sources: z.ZodArray<z.ZodObject<{
+            bindingId: z.ZodString;
+            fieldIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }, {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        title: string;
+        id: string;
+        elementId: string;
+        kind: "filter" | "metric" | "chart" | "table" | "text";
+        sources: {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }[];
+    }, {
+        title: string;
+        id: string;
+        elementId: string;
+        kind: "filter" | "metric" | "chart" | "table" | "text";
+        sources: {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }[];
+    }>, "many">, {
+        title: string;
+        id: string;
+        elementId: string;
+        kind: "filter" | "metric" | "chart" | "table" | "text";
+        sources: {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }[];
+    }[], unknown>>;
     previewIds: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>;
 }, "charts" | "tables"> & {
     path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
     libraries: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodArray<z.ZodEnum<["echarts", "three", "trend-workspace", "profit-atlas", "customer-brief"]>, "many">, ("echarts" | "three" | "trend-workspace" | "profit-atlas" | "customer-brief")[], ("echarts" | "three" | "trend-workspace" | "profit-atlas" | "customer-brief")[]>, ("echarts" | "three" | "trend-workspace" | "profit-atlas" | "customer-brief")[], ("echarts" | "three" | "trend-workspace" | "profit-atlas" | "customer-brief")[]>>;
 }, "strict", z.ZodTypeAny, {
-    path: string;
     title: string;
+    path: string;
     controls: {
         type: "string" | "number" | "boolean" | "date";
         controlId: string;
@@ -558,17 +695,34 @@ export declare const createHtmlToolSchema: z.ZodObject<Omit<{} & {
         allowedValues?: (string | number | boolean | null)[] | undefined;
     }[];
     previewIds: string[];
+    sourceMetadata?: {
+        bindingId: string;
+        title: string;
+        description?: string | undefined;
+    }[] | undefined;
+    components?: {
+        title: string;
+        id: string;
+        elementId: string;
+        kind: "filter" | "metric" | "chart" | "table" | "text";
+        sources: {
+            bindingId: string;
+            fieldIds?: string[] | undefined;
+        }[];
+    }[] | undefined;
     creationIntent?: "new" | "copy" | undefined;
     supersedesPaths?: string[] | undefined;
     libraries?: ("echarts" | "three" | "trend-workspace" | "profit-atlas" | "customer-brief")[] | undefined;
 }, {
-    path: string;
     title: string;
+    path: string;
+    sourceMetadata?: unknown;
+    components?: unknown;
     controls?: unknown;
     creationIntent?: "new" | "copy" | undefined;
     supersedesPaths?: string[] | undefined;
     previewIds?: unknown;
     libraries?: ("echarts" | "three" | "trend-workspace" | "profit-atlas" | "customer-brief")[] | undefined;
 }>;
-export declare function parseObjectJson(text: string): Record<string, import("@xpert-ai/contracts").JSONValue>;
+export declare function parseObjectJson(text: string, field?: 'requestJson' | 'binding.payloadJson'): Record<string, import("@xpert-ai/contracts").JSONValue>;
 export declare function fromAgentBinding(input: z.infer<typeof agentBindingSchema>, contract: AnalyticsDiscoveryResult['queryContract']): import("@xpert-ai/contracts").AnalyticsBinding;

package/dist/lib/agent.schema.js

@@ -8,6 +8,7 @@ const analytics_1 = require("@xpert-ai/plugin-sdk/analytics");
 const dashboard_schema_1 = require("./dashboard.schema");
 const plugin_sdk_1 = require("@xpert-ai/plugin-sdk");
 const document_libraries_1 = require("./document-libraries");
+const json_input_1 = require("./json-input");
 // LLM tool schemas cannot reliably express recursive JSON unions. Only this model boundary uses JSON text.
 const objectJson = v3_1.z.string().min(2).max(64000).describe('A JSON object encoded as text. Use the exact provider-owned contract from discovery. No Markdown fences.');
 const agentControlsSchema = v3_1.z.array(dashboard_schema_1.dashboardSchema.innerType().shape.controls.element.extend({
@@ -28,7 +29,9 @@ exports.createToolSchema = dashboard_schema_1.dashboardSchema.innerType().omit({
     controls: (0, plugin_sdk_1.jsonEncodedSchema)(agentControlsSchema),
     charts: (0, plugin_sdk_1.jsonEncodedSchema)(dashboard_schema_1.dashboardSchema.innerType().shape.charts),
     tables: (0, plugin_sdk_1.jsonEncodedSchema)(dashboard_schema_1.dashboardSchema.innerType().shape.tables),
-    previewIds: (0, plugin_sdk_1.jsonEncodedSchema)(v3_1.z.array(v3_1.z.string().min(1)).min(1).max(8).describe('Exact previewId receipts from successful dashboard_preview calls. Do not repeat bindings.'))
+    sourceMetadata: (0, plugin_sdk_1.jsonEncodedSchema)(dashboard_schema_1.dashboardSchema.innerType().shape.sourceMetadata.unwrap()).optional(),
+    components: (0, plugin_sdk_1.jsonEncodedSchema)(dashboard_schema_1.dashboardSchema.innerType().shape.components.unwrap()).optional(),
+    previewIds: (0, plugin_sdk_1.jsonEncodedSchema)(v3_1.z.array(v3_1.z.string().min(1)).min(1).max(8).describe('Exact current-run previewId receipts from successful dashboard_preview or dashboard_preview_binding calls. For updates, changed bindings upsert by stable binding.id; omitted bindings remain. Keep every intended changed/new binding receipt when retrying a failed save. Do not repeat bindings.'))
 }).strict();
 exports.htmlPathSchema = plugin_sdk_1.workspaceRelativeFilePathSchema.refine(path => {
     const name = path.split('/').at(-1) ?? '';
@@ -37,17 +40,15 @@ exports.htmlPathSchema = plugin_sdk_1.workspaceRelativeFilePathSchema.refine(pat
     .describe('Workspace-relative HTML file created or edited with SandboxFile, for example dashboards/sales.html. Copy the complete htmlPath from dashboard_open when editing.');
 exports.createHtmlToolSchema = exports.createToolSchema.omit({ charts: true, tables: true }).extend({ path: exports.htmlPathSchema,
     libraries: document_libraries_1.libraryRequestsSchema.optional().describe('Bundled IDs from dashboard_libraries. Omit for native SVG/Canvas/DOM; use echarts or three for charts. Optional: add exactly one visual theme (trend-workspace, profit-atlas, customer-brief) with echarts. Preserve the saved theme unless a change is requested.') }).strict();
-function parseObjectJson(text) {
-    try {
-        return analytics_1.analyticsOptionsSchema.parse(JSON.parse(text));
-    }
-    catch {
-        throw new Error('DASHBOARD_INVALID_JSON: supply a JSON object encoded as text, matching the returned provider contract');
-    }
+function parseObjectJson(text, field = 'requestJson') {
+    const parsed = analytics_1.analyticsOptionsSchema.safeParse((0, json_input_1.parseJsonInput)(text, field));
+    if (!parsed.success)
+        throw new Error(`DASHBOARD_INVALID_JSON: ${field} is valid JSON but must be an object matching the returned provider contract; arrays, null and scalar values are not accepted.`);
+    return parsed.data;
 }
 function fromAgentBinding(input, contract) {
     const { payloadJson, ...binding } = input;
     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) });
+        parameters: input.parameters.map(parameter => ({ ...parameter, controlId: parameter.name })), payload: parseObjectJson(payloadJson, 'binding.payloadJson') });
 }

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

@@ -0,0 +1,145 @@
+import { z } from 'zod/v3';
+import type { XpertResolvedViewHostContext } from '@xpert-ai/contracts';
+import { type RuntimeCapabilityRegistry, type WorkspacePortableFileReference } from '@xpert-ai/plugin-sdk';
+import { DashboardService } from './dashboard.service';
+export declare const importInputSchema: z.ZodObject<{
+    importId: z.ZodString;
+    bindings: z.ZodArray<z.ZodObject<{
+        bindingId: z.ZodString;
+        source: z.ZodType<import("@xpert-ai/contracts").AnalyticsSourceRef, z.ZodTypeDef, import("@xpert-ai/contracts").AnalyticsSourceRef>;
+        payload: z.ZodType<import("@xpert-ai/contracts").JSONValue, z.ZodTypeDef, import("@xpert-ai/contracts").JSONValue>;
+    }, "strict", z.ZodTypeAny, {
+        bindingId: string;
+        source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+        payload: import("@xpert-ai/contracts").JSONValue;
+    }, {
+        bindingId: string;
+        source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+        payload: import("@xpert-ai/contracts").JSONValue;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    bindings: {
+        bindingId: string;
+        source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+        payload: import("@xpert-ai/contracts").JSONValue;
+    }[];
+    importId: string;
+}, {
+    bindings: {
+        bindingId: string;
+        source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+        payload: import("@xpert-ai/contracts").JSONValue;
+    }[];
+    importId: string;
+}>;
+declare const importBrowseSchema: z.ZodObject<{
+    importId: z.ZodString;
+    bindingId: z.ZodString;
+    source: z.ZodType<import("@xpert-ai/contracts").AnalyticsSourceRef, z.ZodTypeDef, import("@xpert-ai/contracts").AnalyticsSourceRef>;
+    request: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<import("@xpert-ai/contracts").JSONValue, z.ZodTypeDef, import("@xpert-ai/contracts").JSONValue>>>;
+}, "strict", z.ZodTypeAny, {
+    bindingId: string;
+    source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+    importId: string;
+    request: Record<string, import("@xpert-ai/contracts").JSONValue>;
+}, {
+    bindingId: string;
+    source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+    importId: string;
+    request?: Record<string, import("@xpert-ai/contracts").JSONValue> | undefined;
+}>;
+type ImportInput = z.infer<typeof importInputSchema>;
+export declare class DashboardArchiveService {
+    private readonly dashboards;
+    private readonly runtime;
+    private readonly imports;
+    constructor(dashboards: DashboardService, runtime: RuntimeCapabilityRegistry);
+    private authorize;
+    private session;
+    prepare(context: XpertResolvedViewHostContext, bytes: Buffer): Promise<{
+        importId: `${string}-${string}-${string}-${string}-${string}`;
+        manifest: {
+            title: string;
+            id: string;
+            schema: "xpert.live-dashboard";
+            bindings: import("@xpert-ai/contracts").AnalyticsBinding[];
+            controls: {
+                type: "string" | "number" | "boolean" | "date";
+                controlId: string;
+                label: string;
+                defaultValue?: string | number | boolean | null | undefined;
+                allowedValues?: (string | number | boolean | null)[] | undefined;
+            }[];
+            charts: {
+                title: string;
+                type: "bar" | "line" | "area" | "pie" | "scatter";
+                id: string;
+                datasetId: string;
+                x: string;
+                y: string;
+                color?: string | undefined;
+            }[];
+            tables: {
+                title: string;
+                id: string;
+                datasetId: string;
+                fields: string[];
+            }[];
+            sourceMetadata?: {
+                bindingId: string;
+                title: string;
+                description?: string | undefined;
+            }[] | undefined;
+            components?: {
+                title: string;
+                id: string;
+                elementId: string;
+                kind: "filter" | "metric" | "chart" | "table" | "text";
+                sources: {
+                    bindingId: string;
+                    fieldIds?: string[] | undefined;
+                }[];
+            }[] | undefined;
+            presentation?: {
+                type: "html";
+                html: string;
+                dependencies?: import("@xpert-ai/plugin-sdk/artifact-document").ArtifactDocumentDependencyLock[] | undefined;
+            } | undefined;
+        };
+        requirements: {
+            schema: string;
+            version: number;
+            bindings: {
+                id: string;
+                providerId: string;
+                operation: string;
+                contractVersion: number;
+                source: import("@xpert-ai/contracts").AnalyticsSourceRef;
+            }[];
+            externalResources: string[];
+            dynamicResourcesMayExist: boolean;
+            includesQueryResults: boolean;
+            requiresAuthorizedHost: boolean;
+        };
+        sources: import("@xpert-ai/contracts").AnalyticsSourceSummary[];
+    }>;
+    browse(context: XpertResolvedViewHostContext, input: z.infer<typeof importBrowseSchema>): Promise<import("@xpert-ai/contracts").AnalyticsDiscoveryResult>;
+    commit(context: XpertResolvedViewHostContext, input: ImportInput): Promise<{
+        artifactId: string;
+        draftId: string;
+        draftRevision: number;
+        baseVersionId: string | null;
+        status: "draft";
+        title: string;
+    }>;
+    discard(context: XpertResolvedViewHostContext, id: string): Promise<{
+        discarded: boolean;
+    }>;
+    exportFile(context: XpertResolvedViewHostContext, fileKey: string): Promise<{
+        reference: WorkspacePortableFileReference;
+        fileName: string;
+        mimeType: string;
+        size: number;
+    }>;
+}
+export { importBrowseSchema };