@xpert-ai/plugin-sdk 3.18.2 → 3.18.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @xpert-ai/plugin-sdk
 
+## 3.18.3
+
+### Patch Changes
+
+- d107704: Add Assistant Profile display contracts and capability/activity indicators, trusted Assistant version identities, and the feature-gated Profile tab slot. Expose static Middleware Tool names and human Project access to plugin server services, and provide the shared Zard Hover Card interaction primitive.
+- Updated dependencies [d107704]
+  - @xpert-ai/contracts@3.18.2
+
 ## 3.18.2
 
 ### Patch Changes

package/index.cjs.js

@@ -1597,7 +1597,7 @@ class BaseSQLQueryRunner extends BaseQueryRunner {
                         return;
                     }
                     // --- MODE: UPGRADE → auto upgrade (simple implementation: only add new columns) ---
-                    // Note: This default implementation does not support modifying column types, 
+                    // Note: This default implementation does not support modifying column types,
                     //       recommend each database to implement its own version
                     if (exists && createMode === exports.DBCreateTableMode.UPGRADE) {
                         console.warn(`[BaseSQLQueryRunner] UPGRADE mode uses basic implementation. Consider implementing tableOp for better support.`);
@@ -6201,6 +6201,9 @@ class DecoratedToolsetStrategy {
     }
 }
 class DecoratedAgentMiddlewareStrategy {
+    getToolNames() {
+        return this.descriptor.tools.filter((item)=>item.middlewareProvider === this.provider).map((item)=>item.options.name);
+    }
     async createMiddleware(options, context) {
         const tools = this.descriptor.tools.filter((item)=>item.middlewareProvider === this.provider).map((item)=>createAgentTool(this.instance, item, context, options));
         const extensions = await (this.instance.getMiddlewareExtensions == null ? void 0 : this.instance.getMiddlewareExtensions.call(this.instance, this.provider, options, context));
@@ -6490,6 +6493,7 @@ exports.KnowledgebaseDocumentsRuntimeCapability = modelProvider.KnowledgebaseDoc
 exports.KnowledgebaseProvisioningRuntimeCapability = modelProvider.KnowledgebaseProvisioningRuntimeCapability;
 exports.KnowledgebaseRuntimeCapability = modelProvider.KnowledgebaseRuntimeCapability;
 exports.ModelProviderBuiltinToolset = modelProvider.ModelProviderBuiltinToolset;
+exports.ProjectAccessRuntimeCapability = modelProvider.ProjectAccessRuntimeCapability;
 exports.ProjectProvisioningRuntimeCapability = modelProvider.ProjectProvisioningRuntimeCapability;
 exports.SANDBOX_JOB_ERROR_CODES = modelProvider.SANDBOX_JOB_ERROR_CODES;
 exports.SANDBOX_JOB_PROGRESS_PREFIX = modelProvider.SANDBOX_JOB_PROGRESS_PREFIX;

package/index.esm.js

@@ -16,7 +16,7 @@ import fs__default from 'fs';
 import http from 'http';
 import https from 'https';
 import { c as createRuntimeCapability, B as BuiltinToolset } from './model-provider.esm.js';
-export { A as ActorTokenRuntimeCapability, a as ArtifactsRuntimeCapability, b as BaseTool, d as BaseToolset, D as DefaultAgentMiddlewareRuntimeCapabilityRegistry, D as DefaultRuntimeCapabilityRegistry, K as KnowledgeDocumentVisualAssetsRuntimeCapability, e as KnowledgebaseDocumentsRuntimeCapability, f as KnowledgebaseProvisioningRuntimeCapability, g as KnowledgebaseRuntimeCapability, M as ModelProviderBuiltinToolset, P as ProjectProvisioningRuntimeCapability, S as SANDBOX_JOB_ERROR_CODES, h as SANDBOX_JOB_PROGRESS_PREFIX, i as SandboxJobRuntimeError, j as SandboxJobsRuntimeCapability, W as WORKSPACE_FILES_SOURCE, k as WorkspaceFilesRuntimeCapability, X as XPERT_RUNTIME_CAPABILITIES_TOKEN, l as isSandboxJobRuntimeError } from './model-provider.esm.js';
+export { A as ActorTokenRuntimeCapability, a as ArtifactsRuntimeCapability, b as BaseTool, d as BaseToolset, D as DefaultAgentMiddlewareRuntimeCapabilityRegistry, D as DefaultRuntimeCapabilityRegistry, K as KnowledgeDocumentVisualAssetsRuntimeCapability, e as KnowledgebaseDocumentsRuntimeCapability, f as KnowledgebaseProvisioningRuntimeCapability, g as KnowledgebaseRuntimeCapability, M as ModelProviderBuiltinToolset, P as ProjectAccessRuntimeCapability, h as ProjectProvisioningRuntimeCapability, S as SANDBOX_JOB_ERROR_CODES, i as SANDBOX_JOB_PROGRESS_PREFIX, j as SandboxJobRuntimeError, k as SandboxJobsRuntimeCapability, W as WORKSPACE_FILES_SOURCE, l as WorkspaceFilesRuntimeCapability, X as XPERT_RUNTIME_CAPABILITIES_TOKEN, m as isSandboxJobRuntimeError } from './model-provider.esm.js';
 import fsPromises from 'fs/promises';
 import * as path from 'path';
 import path__default, { join } from 'path';
@@ -1579,7 +1579,7 @@ class BaseSQLQueryRunner extends BaseQueryRunner {
                         return;
                     }
                     // --- MODE: UPGRADE → auto upgrade (simple implementation: only add new columns) ---
-                    // Note: This default implementation does not support modifying column types, 
+                    // Note: This default implementation does not support modifying column types,
                     //       recommend each database to implement its own version
                     if (exists && createMode === DBCreateTableMode.UPGRADE) {
                         console.warn(`[BaseSQLQueryRunner] UPGRADE mode uses basic implementation. Consider implementing tableOp for better support.`);
@@ -6183,6 +6183,9 @@ class DecoratedToolsetStrategy {
     }
 }
 class DecoratedAgentMiddlewareStrategy {
+    getToolNames() {
+        return this.descriptor.tools.filter((item)=>item.middlewareProvider === this.provider).map((item)=>item.options.name);
+    }
     async createMiddleware(options, context) {
         const tools = this.descriptor.tools.filter((item)=>item.middlewareProvider === this.provider).map((item)=>createAgentTool(this.instance, item, context, options));
         const extensions = await (this.instance.getMiddlewareExtensions == null ? void 0 : this.instance.getMiddlewareExtensions.call(this.instance, this.provider, options, context));

package/model-provider.cjs.js

@@ -160,10 +160,13 @@ class DefaultRuntimeCapabilityRegistry {
         return this;
     }
     has(key) {
-        return this.capabilities.has(runtimeCapabilityId(key));
+        var _this_parent;
+        return this.capabilities.has(runtimeCapabilityId(key)) || ((_this_parent = this.parent) == null ? void 0 : _this_parent.get(key)) !== undefined;
     }
     get(key) {
-        return this.capabilities.get(runtimeCapabilityId(key));
+        var _this_parent;
+        const id = runtimeCapabilityId(key);
+        return this.capabilities.has(id) ? this.capabilities.get(id) : (_this_parent = this.parent) == null ? void 0 : _this_parent.get(key);
     }
     require(key) {
         const implementation = this.get(key);
@@ -172,8 +175,9 @@ class DefaultRuntimeCapabilityRegistry {
         }
         return implementation;
     }
-    constructor(entries = []){
+    constructor(entries = [], parent){
         this.capabilities = new Map();
+        this.parent = parent;
         entries.forEach(([key, implementation])=>this.register(key, implementation));
     }
 }
@@ -252,6 +256,10 @@ const ProjectProvisioningRuntimeCapability = createRuntimeCapability('platform.p
     description: 'Idempotently provision a platform Chat Project and connect it to an Assistant.'
 });
 
+const ProjectAccessRuntimeCapability = createRuntimeCapability('platform.project.access', {
+    description: 'Resolve human Project membership for platform and plugin operations.'
+});
+
 /**
  * Shared host-runtime plumbing for built-in tools backed by a configured model provider.
  * Provider request/response semantics remain owned by each plugin.
@@ -377,6 +385,7 @@ exports.KnowledgebaseDocumentsRuntimeCapability = KnowledgebaseDocumentsRuntimeC
 exports.KnowledgebaseProvisioningRuntimeCapability = KnowledgebaseProvisioningRuntimeCapability;
 exports.KnowledgebaseRuntimeCapability = KnowledgebaseRuntimeCapability;
 exports.ModelProviderBuiltinToolset = ModelProviderBuiltinToolset;
+exports.ProjectAccessRuntimeCapability = ProjectAccessRuntimeCapability;
 exports.ProjectProvisioningRuntimeCapability = ProjectProvisioningRuntimeCapability;
 exports.SANDBOX_JOB_ERROR_CODES = SANDBOX_JOB_ERROR_CODES;
 exports.SANDBOX_JOB_PROGRESS_PREFIX = SANDBOX_JOB_PROGRESS_PREFIX;

package/model-provider.esm.js

@@ -158,10 +158,13 @@ class DefaultRuntimeCapabilityRegistry {
         return this;
     }
     has(key) {
-        return this.capabilities.has(runtimeCapabilityId(key));
+        var _this_parent;
+        return this.capabilities.has(runtimeCapabilityId(key)) || ((_this_parent = this.parent) == null ? void 0 : _this_parent.get(key)) !== undefined;
     }
     get(key) {
-        return this.capabilities.get(runtimeCapabilityId(key));
+        var _this_parent;
+        const id = runtimeCapabilityId(key);
+        return this.capabilities.has(id) ? this.capabilities.get(id) : (_this_parent = this.parent) == null ? void 0 : _this_parent.get(key);
     }
     require(key) {
         const implementation = this.get(key);
@@ -170,8 +173,9 @@ class DefaultRuntimeCapabilityRegistry {
         }
         return implementation;
     }
-    constructor(entries = []){
+    constructor(entries = [], parent){
         this.capabilities = new Map();
+        this.parent = parent;
         entries.forEach(([key, implementation])=>this.register(key, implementation));
     }
 }
@@ -250,6 +254,10 @@ const ProjectProvisioningRuntimeCapability = createRuntimeCapability('platform.p
     description: 'Idempotently provision a platform Chat Project and connect it to an Assistant.'
 });
 
+const ProjectAccessRuntimeCapability = createRuntimeCapability('platform.project.access', {
+    description: 'Resolve human Project membership for platform and plugin operations.'
+});
+
 /**
  * Shared host-runtime plumbing for built-in tools backed by a configured model provider.
  * Provider request/response semantics remain owned by each plugin.
@@ -364,4 +372,4 @@ function normalizeWorkspaceScope(scope) {
     } : {});
 }
 
-export { ActorTokenRuntimeCapability as A, BuiltinToolset as B, DefaultRuntimeCapabilityRegistry as D, KnowledgeDocumentVisualAssetsRuntimeCapability as K, ModelProviderBuiltinToolset as M, ProjectProvisioningRuntimeCapability as P, SANDBOX_JOB_ERROR_CODES as S, WORKSPACE_FILES_SOURCE as W, XPERT_RUNTIME_CAPABILITIES_TOKEN as X, ArtifactsRuntimeCapability as a, BaseTool as b, createRuntimeCapability as c, BaseToolset as d, KnowledgebaseDocumentsRuntimeCapability as e, KnowledgebaseProvisioningRuntimeCapability as f, KnowledgebaseRuntimeCapability as g, SANDBOX_JOB_PROGRESS_PREFIX as h, SandboxJobRuntimeError as i, SandboxJobsRuntimeCapability as j, WorkspaceFilesRuntimeCapability as k, isSandboxJobRuntimeError as l };
+export { ActorTokenRuntimeCapability as A, BuiltinToolset as B, DefaultRuntimeCapabilityRegistry as D, KnowledgeDocumentVisualAssetsRuntimeCapability as K, ModelProviderBuiltinToolset as M, ProjectAccessRuntimeCapability as P, SANDBOX_JOB_ERROR_CODES as S, WORKSPACE_FILES_SOURCE as W, XPERT_RUNTIME_CAPABILITIES_TOKEN as X, ArtifactsRuntimeCapability as a, BaseTool as b, createRuntimeCapability as c, BaseToolset as d, KnowledgebaseDocumentsRuntimeCapability as e, KnowledgebaseProvisioningRuntimeCapability as f, KnowledgebaseRuntimeCapability as g, ProjectProvisioningRuntimeCapability as h, SANDBOX_JOB_PROGRESS_PREFIX as i, SandboxJobRuntimeError as j, SandboxJobsRuntimeCapability as k, WorkspaceFilesRuntimeCapability as l, isSandboxJobRuntimeError as m };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/plugin-sdk",
-  "version": "3.18.2",
+  "version": "3.18.3",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",
@@ -17,7 +17,7 @@
   },
   "dependencies": {
     "@langchain/openai": "0.6.9",
-    "@xpert-ai/contracts": "3.18.1",
+    "@xpert-ai/contracts": "3.18.2",
     "express": "^4.22.1",
     "js-tiktoken": "^1.0.21"
   },

package/src/lib/agent/middleware/strategy.interface.d.ts

@@ -25,5 +25,7 @@ export interface IAgentMiddlewareContext {
 }
 export interface IAgentMiddlewareStrategy<T = unknown> {
     meta: TAgentMiddlewareMeta;
+    /** Static Tool names exposed by this Middleware, for capability summaries without creating a runtime instance. */
+    getToolNames?(options: T): readonly string[];
     createMiddleware(options: T, context: IAgentMiddlewareContext): PromiseOrValue<AgentMiddleware>;
 }

package/src/lib/core/runtime-capability.d.ts

@@ -16,8 +16,9 @@ export interface RuntimeCapabilityRegistry {
 export type RuntimeCapabilityResolver = Pick<RuntimeCapabilityRegistry, 'get'>;
 export declare const XPERT_RUNTIME_CAPABILITIES_TOKEN = "XPERT_RUNTIME_CAPABILITIES";
 export declare class DefaultRuntimeCapabilityRegistry implements RuntimeCapabilityRegistry {
+    private readonly parent?;
     private readonly capabilities;
-    constructor(entries?: Array<[RuntimeCapabilityKey<unknown> | string, unknown]>);
+    constructor(entries?: Array<[RuntimeCapabilityKey<unknown> | string, unknown]>, parent?: RuntimeCapabilityResolver);
     register<T>(key: RuntimeCapabilityKey<T> | string, implementation: T): this;
     has<T>(key: RuntimeCapabilityKey<T> | string): boolean;
     get<T>(key: RuntimeCapabilityKey<T> | string): T | undefined;

package/src/lib/data/datasource/types.d.ts

@@ -1,7 +1,7 @@
 import * as _axios from 'axios';
 import { Readable } from 'stream';
-import { IColumnDef, IDSSchema, IDSTable } from '@xpert-ai/contracts';
-export { IColumnDef, IDSSchema, IDSTable } from '@xpert-ai/contracts';
+import { IColumnDef, IDataSourceCapabilityQuery, IDSSchema, IDSTable } from '@xpert-ai/contracts';
+export { IColumnDef, IDataSourceCapabilityQuery, IDSSchema, IDSTable } from '@xpert-ai/contracts';
 /**
  * The base options for DB adapters
  */
@@ -82,6 +82,11 @@ export interface DBQueryRunner {
      * @param tableName
      */
     getSchema(catalog?: string, tableName?: string): Promise<IDSSchema[]>;
+    /**
+     * Runs an adapter-owned, read-only capability without exposing its domain
+     * contract through the host platform.
+     */
+    queryCapability?(query: IDataSourceCapabilityQuery): Promise<unknown>;
     /**
      * Describe a sql query result schema
      *

package/src/lib/runtime/capabilities/index.d.ts

@@ -6,3 +6,4 @@ export * from './artifacts';
 export * from './workspace-files';
 export * from './sandbox-jobs';
 export * from './project-provisioning';
+export * from './project-access';

package/src/lib/runtime/capabilities/knowledgebase.d.ts

@@ -1,5 +1,5 @@
 import { JSONValue, KnowledgeFilterDiagnostics, KnowledgeFilterNode } from '@xpert-ai/contracts';
-export type KnowledgebaseRetrievalMode = 'vector' | 'graph' | 'hybrid';
+export type KnowledgebaseRetrievalMode = 'vector' | 'keyword' | 'graph' | 'hybrid';
 export type KnowledgebaseMetadata = Record<string, JSONValue>;
 export type KnowledgebaseRetrievalSettings = {
     mode?: KnowledgebaseRetrievalMode;

package/src/lib/runtime/capabilities/project-access.d.ts

@@ -0,0 +1,30 @@
+/** Trusted server actor. View providers derive this from host context; jobs persist that actor. */
+export interface ProjectAccessActor {
+    tenantId: string;
+    organizationId?: string | null;
+    userId: string;
+}
+export interface ProjectHumanAccess {
+    projectId: string;
+    role: 'owner' | 'manager' | 'editor' | 'member';
+    canManage: boolean;
+    archived: boolean;
+    /** Explicit Project bindings, for plugins that choose to use assignment as business policy. */
+    assistantIds?: string[];
+}
+/** Human membership only. Assistant assignment and business authorization remain plugin-owned. */
+export interface ProjectAccessApi {
+    listReadable(input: {
+        actor: ProjectAccessActor;
+        projectIds?: string[];
+    }): Promise<ProjectHumanAccess[]>;
+    assertEdit(input: {
+        actor: ProjectAccessActor;
+        projectId: string;
+    }): Promise<ProjectHumanAccess>;
+    assertManage(input: {
+        actor: ProjectAccessActor;
+        projectId: string;
+    }): Promise<ProjectHumanAccess>;
+}
+export declare const ProjectAccessRuntimeCapability: import("../../core/runtime-capability").RuntimeCapabilityKey<ProjectAccessApi>;

package/src/lib/runtime/capabilities/project-provisioning.d.ts

@@ -37,5 +37,13 @@ export type ProjectEnsureResult = {
 export interface ProjectProvisioningApi {
     /** Create or reconcile a Chat Project without changing its caller-supplied id. */
     ensure(input: ProjectEnsureInput): Promise<ProjectEnsureResult>;
+    /** Owner-only physical deletion of an archived plugin-bound Project and its workspace. */
+    purge?(input: {
+        projectId: string;
+        xpertId: string;
+    }): Promise<{
+        projectId: string;
+        deleted: boolean;
+    }>;
 }
 export declare const ProjectProvisioningRuntimeCapability: import("../../core/runtime-capability").RuntimeCapabilityKey<ProjectProvisioningApi>;

package/src/lib/tool-provider/adapters.d.ts

@@ -23,5 +23,6 @@ export declare class DecoratedAgentMiddlewareStrategy implements IAgentMiddlewar
     readonly provider: string;
     readonly meta: any;
     constructor(instance: XpertToolProviderInstance, descriptor: XpertToolProviderDescriptor, provider: string);
+    getToolNames(): readonly string[];
     createMiddleware(options: unknown, context: IAgentMiddlewareContext): Promise<AgentMiddleware>;
 }