@xpert-ai/plugin-sdk 3.9.0-beta.3 → 3.9.1

package/CHANGELOG.md

@@ -1,12 +1,28 @@
 # @xpert-ai/plugin-sdk
 
-## 3.9.0-beta.3
+## 3.9.1
+
+### Patch Changes
+
+- e040933: Tenant shared workspace to organization's users
+- Updated dependencies [e040933]
+  - @xpert-ai/contracts@3.9.1
+  - @xpert-ai/ocap-core@3.9.1
+
+## 3.9.0
 
 ### Patch Changes
 
 - 4dcf5b5: add sso in plugin sdk
+- 7fff870: beta 2
+- c76facd: beta v
+- 5b5c8ef: Updates
 - Updated dependencies [4dcf5b5]
-  - @xpert-ai/contracts@3.9.0-beta.3
+- Updated dependencies [7fff870]
+- Updated dependencies [c76facd]
+- Updated dependencies [5b5c8ef]
+  - @xpert-ai/contracts@3.9.0
+  - @xpert-ai/ocap-core@3.9.0
 
 ## 3.9.0-beta.2
 

package/index.cjs.js

@@ -107,7 +107,7 @@ function _extends() {
 function createPluginLogger(scope, baseMeta = {}) {
     const nestLogger = new common.Logger(scope);
     const wrap = (level, msg, meta)=>{
-        var // 保持与 Nest Logger 接口对齐
+        var // Maintain alignment with the Nest Logger interface
         _nestLogger_level;
         const payload = meta ? _extends({}, baseMeta, meta) : baseMeta;
         (_nestLogger_level = nestLogger[level]) == null ? void 0 : _nestLogger_level.call(nestLogger, msg + (Object.keys(payload).length ? ` ${JSON.stringify(payload)}` : ''));
@@ -617,6 +617,8 @@ exports.WorkflowNodeRegistry = __decorate([
 const COMMAND_METADATA$2 = '__command__';
 /**
  * Wrap Workflow Node Execution Command
+ *
+ * @deprecated Prefer `IAgentMiddlewareContext.runtime.wrapWorkflowNodeExecution(...)` in middleware and plugin code.
  */ class WrapWorkflowNodeExecutionCommand extends cqrs.Command {
     constructor(fuc, params){
         super();
@@ -2569,6 +2571,8 @@ function normalizeContextSize(value) {
 const COMMAND_METADATA$1 = '__command__';
 /**
  * Get a Chat Model of copilot model and check it's token limitation, record the token usage
+ *
+ * @deprecated Prefer `IAgentMiddlewareContext.runtime.createModelClient(...)` in middleware and plugin code.
  */ class CreateModelClientCommand extends cqrs.Command {
     constructor(copilotModel, options){
         super();
@@ -2939,19 +2943,43 @@ function resolveSandboxExecutionOptions(options, defaults = DEFAULT_SANDBOX_SHEL
     };
 }
 
+function isObjectLike$2(value) {
+    return typeof value === 'object' && value !== null;
+}
+function isSandboxManagedServiceAdapter(value) {
+    return isObjectLike$2(value) && typeof Reflect.get(value, 'startService') === 'function' && typeof Reflect.get(value, 'listServices') === 'function' && typeof Reflect.get(value, 'getServiceLogs') === 'function' && typeof Reflect.get(value, 'stopService') === 'function' && typeof Reflect.get(value, 'restartService') === 'function';
+}
+function resolveSandboxManagedServiceAdapter(sandbox) {
+    if (!isObjectLike$2(sandbox)) {
+        return null;
+    }
+    const candidate = Reflect.has(sandbox, 'backend') ? Reflect.get(sandbox, 'backend') : sandbox;
+    return isSandboxManagedServiceAdapter(candidate) ? candidate : null;
+}
+function isSandboxServiceProxyAdapter(value) {
+    return isObjectLike$2(value) && typeof Reflect.get(value, 'proxyServiceRequest') === 'function';
+}
+function resolveSandboxServiceProxyAdapter(sandbox) {
+    if (!isObjectLike$2(sandbox)) {
+        return null;
+    }
+    const candidate = Reflect.has(sandbox, 'backend') ? Reflect.get(sandbox, 'backend') : sandbox;
+    return isSandboxServiceProxyAdapter(candidate) ? candidate : null;
+}
+
 /**
  * Type guard to check if a backend supports execution.
  *
  * @param backend - Backend instance to check
  * @returns True if the backend implements SandboxBackendProtocol
- */ function isObjectLike(value) {
+ */ function isObjectLike$1(value) {
     return typeof value === 'object' && value !== null;
 }
 function isSandboxBackend(backend) {
-    return isObjectLike(backend) && typeof Reflect.get(backend, 'execute') === 'function' && typeof Reflect.get(backend, 'id') === 'string';
+    return isObjectLike$1(backend) && typeof Reflect.get(backend, 'execute') === 'function' && typeof Reflect.get(backend, 'id') === 'string';
 }
 function resolveSandboxBackend(sandbox) {
-    if (!isObjectLike(sandbox)) {
+    if (!isObjectLike$1(sandbox)) {
         return null;
     }
     const candidate = Reflect.has(sandbox, 'backend') ? Reflect.get(sandbox, 'backend') : sandbox;
@@ -3880,6 +3908,20 @@ exports.SandboxProviderRegistry = __decorate([
     ])
 ], exports.SandboxProviderRegistry);
 
+function isObjectLike(value) {
+    return typeof value === 'object' && value !== null;
+}
+function isSandboxTerminalAdapter(value) {
+    return isObjectLike(value) && typeof Reflect.get(value, 'open') === 'function';
+}
+function resolveSandboxTerminalAdapter(sandbox) {
+    if (!isObjectLike(sandbox)) {
+        return null;
+    }
+    const candidate = Reflect.has(sandbox, 'backend') ? Reflect.get(sandbox, 'backend') : sandbox;
+    return isSandboxTerminalAdapter(candidate) ? candidate : null;
+}
+
 const VIEW_EXTENSION_PROVIDER = 'VIEW_EXTENSION_PROVIDER';
 const ViewExtensionProvider = (providerKey)=>common.applyDecorators(common.SetMetadata(VIEW_EXTENSION_PROVIDER, providerKey), common.SetMetadata(STRATEGY_META_KEY, VIEW_EXTENSION_PROVIDER));
 
@@ -4052,6 +4094,9 @@ exports.getRequestContext = getRequestContext;
 exports.getRequiredPermissionOperation = getRequiredPermissionOperation;
 exports.isRemoteFile = isRemoteFile;
 exports.isSandboxBackend = isSandboxBackend;
+exports.isSandboxManagedServiceAdapter = isSandboxManagedServiceAdapter;
+exports.isSandboxServiceProxyAdapter = isSandboxServiceProxyAdapter;
+exports.isSandboxTerminalAdapter = isSandboxTerminalAdapter;
 exports.isStructuredMessageType = isStructuredMessageType;
 exports.loadYamlFile = loadYamlFile;
 exports.mergeCredentials = mergeCredentials;
@@ -4059,6 +4104,9 @@ exports.mergeParentChildChunks = mergeParentChildChunks;
 exports.normalizeContextSize = normalizeContextSize;
 exports.resolveSandboxBackend = resolveSandboxBackend;
 exports.resolveSandboxExecutionOptions = resolveSandboxExecutionOptions;
+exports.resolveSandboxManagedServiceAdapter = resolveSandboxManagedServiceAdapter;
+exports.resolveSandboxServiceProxyAdapter = resolveSandboxServiceProxyAdapter;
+exports.resolveSandboxTerminalAdapter = resolveSandboxTerminalAdapter;
 exports.runWithRequestContext = runWithRequestContext;
 exports.secondsToMilliseconds = secondsToMilliseconds;
 exports.sumTokenUsage = sumTokenUsage;

package/index.esm.js

@@ -86,7 +86,7 @@ function _extends() {
 function createPluginLogger(scope, baseMeta = {}) {
     const nestLogger = new Logger(scope);
     const wrap = (level, msg, meta)=>{
-        var // 保持与 Nest Logger 接口对齐
+        var // Maintain alignment with the Nest Logger interface
         _nestLogger_level;
         const payload = meta ? _extends({}, baseMeta, meta) : baseMeta;
         (_nestLogger_level = nestLogger[level]) == null ? void 0 : _nestLogger_level.call(nestLogger, msg + (Object.keys(payload).length ? ` ${JSON.stringify(payload)}` : ''));
@@ -596,6 +596,8 @@ WorkflowNodeRegistry = __decorate([
 const COMMAND_METADATA$2 = '__command__';
 /**
  * Wrap Workflow Node Execution Command
+ *
+ * @deprecated Prefer `IAgentMiddlewareContext.runtime.wrapWorkflowNodeExecution(...)` in middleware and plugin code.
  */ class WrapWorkflowNodeExecutionCommand extends Command {
     constructor(fuc, params){
         super();
@@ -2548,6 +2550,8 @@ function normalizeContextSize(value) {
 const COMMAND_METADATA$1 = '__command__';
 /**
  * Get a Chat Model of copilot model and check it's token limitation, record the token usage
+ *
+ * @deprecated Prefer `IAgentMiddlewareContext.runtime.createModelClient(...)` in middleware and plugin code.
  */ class CreateModelClientCommand extends Command {
     constructor(copilotModel, options){
         super();
@@ -2918,19 +2922,43 @@ function resolveSandboxExecutionOptions(options, defaults = DEFAULT_SANDBOX_SHEL
     };
 }
 
+function isObjectLike$2(value) {
+    return typeof value === 'object' && value !== null;
+}
+function isSandboxManagedServiceAdapter(value) {
+    return isObjectLike$2(value) && typeof Reflect.get(value, 'startService') === 'function' && typeof Reflect.get(value, 'listServices') === 'function' && typeof Reflect.get(value, 'getServiceLogs') === 'function' && typeof Reflect.get(value, 'stopService') === 'function' && typeof Reflect.get(value, 'restartService') === 'function';
+}
+function resolveSandboxManagedServiceAdapter(sandbox) {
+    if (!isObjectLike$2(sandbox)) {
+        return null;
+    }
+    const candidate = Reflect.has(sandbox, 'backend') ? Reflect.get(sandbox, 'backend') : sandbox;
+    return isSandboxManagedServiceAdapter(candidate) ? candidate : null;
+}
+function isSandboxServiceProxyAdapter(value) {
+    return isObjectLike$2(value) && typeof Reflect.get(value, 'proxyServiceRequest') === 'function';
+}
+function resolveSandboxServiceProxyAdapter(sandbox) {
+    if (!isObjectLike$2(sandbox)) {
+        return null;
+    }
+    const candidate = Reflect.has(sandbox, 'backend') ? Reflect.get(sandbox, 'backend') : sandbox;
+    return isSandboxServiceProxyAdapter(candidate) ? candidate : null;
+}
+
 /**
  * Type guard to check if a backend supports execution.
  *
  * @param backend - Backend instance to check
  * @returns True if the backend implements SandboxBackendProtocol
- */ function isObjectLike(value) {
+ */ function isObjectLike$1(value) {
     return typeof value === 'object' && value !== null;
 }
 function isSandboxBackend(backend) {
-    return isObjectLike(backend) && typeof Reflect.get(backend, 'execute') === 'function' && typeof Reflect.get(backend, 'id') === 'string';
+    return isObjectLike$1(backend) && typeof Reflect.get(backend, 'execute') === 'function' && typeof Reflect.get(backend, 'id') === 'string';
 }
 function resolveSandboxBackend(sandbox) {
-    if (!isObjectLike(sandbox)) {
+    if (!isObjectLike$1(sandbox)) {
         return null;
     }
     const candidate = Reflect.has(sandbox, 'backend') ? Reflect.get(sandbox, 'backend') : sandbox;
@@ -3859,6 +3887,20 @@ SandboxProviderRegistry = __decorate([
     ])
 ], SandboxProviderRegistry);
 
+function isObjectLike(value) {
+    return typeof value === 'object' && value !== null;
+}
+function isSandboxTerminalAdapter(value) {
+    return isObjectLike(value) && typeof Reflect.get(value, 'open') === 'function';
+}
+function resolveSandboxTerminalAdapter(sandbox) {
+    if (!isObjectLike(sandbox)) {
+        return null;
+    }
+    const candidate = Reflect.has(sandbox, 'backend') ? Reflect.get(sandbox, 'backend') : sandbox;
+    return isSandboxTerminalAdapter(candidate) ? candidate : null;
+}
+
 const VIEW_EXTENSION_PROVIDER = 'VIEW_EXTENSION_PROVIDER';
 const ViewExtensionProvider = (providerKey)=>applyDecorators(SetMetadata(VIEW_EXTENSION_PROVIDER, providerKey), SetMetadata(STRATEGY_META_KEY, VIEW_EXTENSION_PROVIDER));
 
@@ -3899,4 +3941,4 @@ ViewExtensionProviderRegistry = __decorate([
 
 const VIEW_EXTENSION_CACHE_SERVICE_TOKEN = 'XPERT_PLUGIN_VIEW_EXTENSION_CACHE_SERVICE';
 
-export { ACCOUNT_BINDING_PERMISSION_SERVICE_TOKEN, AGENT_CHAT_DISPATCH_MESSAGE_TYPE, AGENT_MIDDLEWARE_STRATEGY, AIModelProviderNotFoundException, AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, ANALYTICS_PERMISSION_SERVICE_TOKEN, AdapterDataSourceStrategy, AgentMiddlewareRegistry, AgentMiddlewareStrategy, AiModelNotFoundException, BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, BaseTool, BaseToolset, BuiltinToolset, CHAT_CHANNEL, CHAT_CHANNEL_TEXT_LIMITS, CancelConversationCommand, ChatChannel, ChatChannelRegistry, ChatOAICompatReasoningModel, CommonParameterRules, CreateModelClientCommand, CredentialsValidateFailedError, DATASOURCE_STRATEGY, DBCreateTableMode, DBProtocolEnum, DBSyntaxEnum, DBTableAction, DBTableDataAction, DEFAULT_EXECUTION_CONFIG, DEFAULT_SANDBOX_EXECUTION_MAX_OUTPUT_BYTES, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_SEC, DEFAULT_SANDBOX_FILE_SEARCH_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_SEC, DEFAULT_SANDBOX_SHELL_EXECUTION_OPTIONS, DEFAULT_SANDBOX_SHELL_TIMEOUT_MS, DEFAULT_SANDBOX_SHELL_TIMEOUT_SEC, DOCUMENT_SOURCE_STRATEGY, DOCUMENT_TRANSFORMER_STRATEGY, DataSourceStrategy, DataSourceStrategyRegistry, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, FILE_STORAGE_PROVIDER, FILE_UPLOAD_TARGET_STRATEGY, FileStorageProvider, FileStorageProviderRegistry, FileUploadTargetRegistry, FileUploadTargetStrategy, GLOBAL_ORGANIZATION_SCOPE, HANDOFF_PERMISSION_SERVICE_TOKEN, HANDOFF_PROCESSOR_STRATEGY, HANDOFF_QUEUE_SERVICE_TOKEN, HandoffProcessorRegistry, HandoffProcessorStrategy, IMAGE_UNDERSTANDING_STRATEGY, INTEGRATION_PERMISSION_SERVICE_TOKEN, INTEGRATION_STRATEGY, ImageUnderstandingRegistry, ImageUnderstandingStrategy, IntegrationStrategyKey, IntegrationStrategyRegistry, JUMP_TO_TARGETS, JsonSchemaValidator, KNOWLEDGE_STRATEGY, KnowledgeStrategyKey, KnowledgeStrategyRegistry, LLMUsage, LargeLanguageModel, ModelProvider, ORGANIZATION_METADATA_KEY, OpenAICompatibleReranker, PERMISSION_OPERATION_METADATA_KEY, PLUGIN_CONFIG_RESOLVER_TOKEN, PLUGIN_METADATA, PLUGIN_METADATA_KEY, PROVIDE_AI_MODEL_LLM, PROVIDE_AI_MODEL_MODERATION, PROVIDE_AI_MODEL_RERANK, PROVIDE_AI_MODEL_SPEECH2TEXT, PROVIDE_AI_MODEL_TEXT_EMBEDDING, PROVIDE_AI_MODEL_TTS, RETRIEVER_STRATEGY, RequestContext, RequestContextMiddleware, RequirePermissionOperation, RerankModel, RetrieverRegistry, RetrieverStrategy, SANDBOX_PROVIDER, SANDBOX_SHELL_TIMEOUT_LIMITS_SEC, SKILL_SOURCE_PROVIDER, SSOProviderRegistry, SSOProviderStrategyKey, SSO_BINDING_PERMISSION_SERVICE_TOKEN, SSO_PROVIDER, STRATEGY_META_KEY, SandboxProviderRegistry, SandboxProviderStrategy, SkillSourceProviderRegistry, SkillSourceProviderStrategy, Speech2TextChatModel, SpeechToTextModel, StrategyBus, TEXT_SPLITTER_STRATEGY, TOOLSET_STRATEGY, TextEmbeddingModelManager, TextSplitterRegistry, TextSplitterStrategy, TextToSpeechModel, ToolsetRegistry, ToolsetStrategy, USER_PERMISSION_SERVICE_TOKEN, VECTOR_STORE_STRATEGY, VIEW_EXTENSION_CACHE_SERVICE_TOKEN, VIEW_EXTENSION_PROVIDER, VectorStoreRegistry, VectorStoreStrategy, ViewExtensionProvider, ViewExtensionProviderRegistry, WORKFLOW_NODE_STRATEGY, WORKFLOW_TRIGGER_STRATEGY, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, WrapWorkflowNodeExecutionCommand, XpFileSystem, XpertServerPlugin, als, appendSandboxMessage, buildSandboxTimeoutMessage, calcTokenUsage, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, defineAgentMessageType, defineChannelMessageType, downloadRemoteFile, formatSandboxTimeout, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, isRemoteFile, isSandboxBackend, isStructuredMessageType, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, resolveSandboxBackend, resolveSandboxExecutionOptions, runWithRequestContext, secondsToMilliseconds, sumTokenUsage };
+export { ACCOUNT_BINDING_PERMISSION_SERVICE_TOKEN, AGENT_CHAT_DISPATCH_MESSAGE_TYPE, AGENT_MIDDLEWARE_STRATEGY, AIModelProviderNotFoundException, AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, ANALYTICS_PERMISSION_SERVICE_TOKEN, AdapterDataSourceStrategy, AgentMiddlewareRegistry, AgentMiddlewareStrategy, AiModelNotFoundException, BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, BaseTool, BaseToolset, BuiltinToolset, CHAT_CHANNEL, CHAT_CHANNEL_TEXT_LIMITS, CancelConversationCommand, ChatChannel, ChatChannelRegistry, ChatOAICompatReasoningModel, CommonParameterRules, CreateModelClientCommand, CredentialsValidateFailedError, DATASOURCE_STRATEGY, DBCreateTableMode, DBProtocolEnum, DBSyntaxEnum, DBTableAction, DBTableDataAction, DEFAULT_EXECUTION_CONFIG, DEFAULT_SANDBOX_EXECUTION_MAX_OUTPUT_BYTES, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_SEC, DEFAULT_SANDBOX_FILE_SEARCH_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_SEC, DEFAULT_SANDBOX_SHELL_EXECUTION_OPTIONS, DEFAULT_SANDBOX_SHELL_TIMEOUT_MS, DEFAULT_SANDBOX_SHELL_TIMEOUT_SEC, DOCUMENT_SOURCE_STRATEGY, DOCUMENT_TRANSFORMER_STRATEGY, DataSourceStrategy, DataSourceStrategyRegistry, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, FILE_STORAGE_PROVIDER, FILE_UPLOAD_TARGET_STRATEGY, FileStorageProvider, FileStorageProviderRegistry, FileUploadTargetRegistry, FileUploadTargetStrategy, GLOBAL_ORGANIZATION_SCOPE, HANDOFF_PERMISSION_SERVICE_TOKEN, HANDOFF_PROCESSOR_STRATEGY, HANDOFF_QUEUE_SERVICE_TOKEN, HandoffProcessorRegistry, HandoffProcessorStrategy, IMAGE_UNDERSTANDING_STRATEGY, INTEGRATION_PERMISSION_SERVICE_TOKEN, INTEGRATION_STRATEGY, ImageUnderstandingRegistry, ImageUnderstandingStrategy, IntegrationStrategyKey, IntegrationStrategyRegistry, JUMP_TO_TARGETS, JsonSchemaValidator, KNOWLEDGE_STRATEGY, KnowledgeStrategyKey, KnowledgeStrategyRegistry, LLMUsage, LargeLanguageModel, ModelProvider, ORGANIZATION_METADATA_KEY, OpenAICompatibleReranker, PERMISSION_OPERATION_METADATA_KEY, PLUGIN_CONFIG_RESOLVER_TOKEN, PLUGIN_METADATA, PLUGIN_METADATA_KEY, PROVIDE_AI_MODEL_LLM, PROVIDE_AI_MODEL_MODERATION, PROVIDE_AI_MODEL_RERANK, PROVIDE_AI_MODEL_SPEECH2TEXT, PROVIDE_AI_MODEL_TEXT_EMBEDDING, PROVIDE_AI_MODEL_TTS, RETRIEVER_STRATEGY, RequestContext, RequestContextMiddleware, RequirePermissionOperation, RerankModel, RetrieverRegistry, RetrieverStrategy, SANDBOX_PROVIDER, SANDBOX_SHELL_TIMEOUT_LIMITS_SEC, SKILL_SOURCE_PROVIDER, SSOProviderRegistry, SSOProviderStrategyKey, SSO_BINDING_PERMISSION_SERVICE_TOKEN, SSO_PROVIDER, STRATEGY_META_KEY, SandboxProviderRegistry, SandboxProviderStrategy, SkillSourceProviderRegistry, SkillSourceProviderStrategy, Speech2TextChatModel, SpeechToTextModel, StrategyBus, TEXT_SPLITTER_STRATEGY, TOOLSET_STRATEGY, TextEmbeddingModelManager, TextSplitterRegistry, TextSplitterStrategy, TextToSpeechModel, ToolsetRegistry, ToolsetStrategy, USER_PERMISSION_SERVICE_TOKEN, VECTOR_STORE_STRATEGY, VIEW_EXTENSION_CACHE_SERVICE_TOKEN, VIEW_EXTENSION_PROVIDER, VectorStoreRegistry, VectorStoreStrategy, ViewExtensionProvider, ViewExtensionProviderRegistry, WORKFLOW_NODE_STRATEGY, WORKFLOW_TRIGGER_STRATEGY, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, WrapWorkflowNodeExecutionCommand, XpFileSystem, XpertServerPlugin, als, appendSandboxMessage, buildSandboxTimeoutMessage, calcTokenUsage, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, defineAgentMessageType, defineChannelMessageType, downloadRemoteFile, formatSandboxTimeout, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, isRemoteFile, isSandboxBackend, isSandboxManagedServiceAdapter, isSandboxServiceProxyAdapter, isSandboxTerminalAdapter, isStructuredMessageType, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, resolveSandboxBackend, resolveSandboxExecutionOptions, resolveSandboxManagedServiceAdapter, resolveSandboxServiceProxyAdapter, resolveSandboxTerminalAdapter, runWithRequestContext, secondsToMilliseconds, sumTokenUsage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/plugin-sdk",
-  "version": "3.9.0-beta.3",
+  "version": "3.9.1",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",

package/src/lib/agent/middleware/runtime.d.ts

@@ -1,6 +1,11 @@
+import { Embeddings } from '@langchain/core/embeddings';
+import { BaseLanguageModel } from '@langchain/core/language_models/base';
+import { BaseChatModel } from '@langchain/core/language_models/chat_models';
 import type { Runtime as LangGraphRuntime } from "@langchain/langgraph";
 import type { BaseMessage } from "@langchain/core/messages";
-import { TSandboxConfigurable } from "@xpert-ai/contracts";
+import { ICopilotModel, ILLMUsage, IXpertAgentExecution, JSONValue, TSandboxConfigurable } from "@xpert-ai/contracts";
+import { Subscriber } from 'rxjs';
+import { IRerank } from '../../ai-model/types';
 /**
  * Type for the agent's built-in state properties.
  */
@@ -56,4 +61,22 @@ export type Runtime<TContext = unknown> = Partial<Omit<LangGraphRuntime<TContext
         [key: string]: unknown;
     };
 };
+export type AgentMiddlewareModelClient = BaseLanguageModel | BaseChatModel | Embeddings | IRerank;
+export type AgentMiddlewareCreateModelClientOptions = {
+    abortController?: AbortController;
+    usageCallback: (tokens: ILLMUsage) => void;
+};
+export type AgentMiddlewareWrapWorkflowNodeExecutionResult<T> = {
+    output?: string | JSONValue;
+    state: T;
+};
+export type AgentMiddlewareWrapWorkflowNodeExecutionParams = {
+    execution: Partial<IXpertAgentExecution>;
+    subscriber?: Subscriber<MessageEvent>;
+    catchError?: (error: Error) => Promise<void>;
+};
+export interface AgentMiddlewareRuntimeApi {
+    createModelClient<T = AgentMiddlewareModelClient>(copilotModel: ICopilotModel, options: AgentMiddlewareCreateModelClientOptions): Promise<T>;
+    wrapWorkflowNodeExecution<T>(run: (execution: Partial<IXpertAgentExecution>) => Promise<AgentMiddlewareWrapWorkflowNodeExecutionResult<T>>, params: AgentMiddlewareWrapWorkflowNodeExecutionParams): Promise<T>;
+}
 export {};

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

@@ -3,6 +3,7 @@ import { StructuredToolInterface } from "@langchain/core/tools";
 import { RunnableToolLike } from '@langchain/core/runnables';
 import { AgentMiddleware } from './types';
 import { PromiseOrValue } from '../../types';
+import { AgentMiddlewareRuntimeApi } from './runtime';
 export interface IAgentMiddlewareContext {
     tenantId: string;
     userId: string;
@@ -12,8 +13,10 @@ export interface IAgentMiddlewareContext {
     xpertId?: string;
     xpertFeatures?: TXpertFeatures | null;
     agentKey?: string;
+    knowledgebaseIds?: string[];
     node: IWFNMiddleware;
     tools: Map<string, StructuredToolInterface | RunnableToolLike>;
+    runtime: AgentMiddlewareRuntimeApi;
 }
 export interface IAgentMiddlewareStrategy<T = unknown> {
     meta: TAgentMiddlewareMeta;

package/src/lib/ai-model/commands/create-model-client.command.d.ts

@@ -1,21 +1,14 @@
-import { Embeddings } from '@langchain/core/embeddings';
-import { BaseLanguageModel } from '@langchain/core/language_models/base';
-import { BaseChatModel } from '@langchain/core/language_models/chat_models';
-import { ICopilotModel, ILLMUsage } from '@xpert-ai/contracts';
+import { ICopilotModel } from '@xpert-ai/contracts';
 import { Command } from '@nestjs/cqrs';
-import { IRerank } from '../types';
+import { AgentMiddlewareCreateModelClientOptions, AgentMiddlewareModelClient } from '../../agent/middleware/runtime';
 /**
  * Get a Chat Model of copilot model and check it's token limitation, record the token usage
+ *
+ * @deprecated Prefer `IAgentMiddlewareContext.runtime.createModelClient(...)` in middleware and plugin code.
  */
-export declare class CreateModelClientCommand<T = BaseLanguageModel | BaseChatModel | Embeddings | IRerank> extends Command<T> {
+export declare class CreateModelClientCommand<T = AgentMiddlewareModelClient> extends Command<T> {
     readonly copilotModel: ICopilotModel;
-    readonly options: {
-        abortController?: AbortController;
-        usageCallback: (tokens: ILLMUsage) => void;
-    };
+    readonly options: AgentMiddlewareCreateModelClientOptions;
     static readonly type = "[AI Model] Create Model Client";
-    constructor(copilotModel: ICopilotModel, options: {
-        abortController?: AbortController;
-        usageCallback: (tokens: ILLMUsage) => void;
-    });
+    constructor(copilotModel: ICopilotModel, options: AgentMiddlewareCreateModelClientOptions);
 }

package/src/lib/sandbox/index.d.ts

@@ -1,9 +1,11 @@
 export * from './execution';
+export * from './managed-service';
 export * from './protocol';
 export * from './sandbox';
 export * from './sandbox.decorator';
 export * from './sandbox.interface';
 export * from './sandbox.registry';
+export * from './terminal';
 export * from './sandbox.interface';
 export * from './sandbox.decorator';
 export * from './sandbox.registry';

package/src/lib/sandbox/managed-service.d.ts

@@ -0,0 +1,70 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { ISandboxManagedService, TSandboxConfigurable, TSandboxManagedServiceEnvEntry, TSandboxManagedServiceLogs, TSandboxManagedServiceStatus, TSandboxManagedServiceTransportMode } from '@xpert-ai/contracts';
+import type { MaybePromise } from './protocol';
+export type SandboxManagedServiceStateChange = {
+    actualPort?: number | null;
+    exitCode?: number | null;
+    runtimeRef?: ISandboxManagedService['runtimeRef'];
+    signal?: string | null;
+    startedAt?: Date;
+    status: TSandboxManagedServiceStatus;
+    stoppedAt?: Date | null;
+    transportMode?: TSandboxManagedServiceTransportMode | null;
+};
+export type SandboxManagedServiceStartOptions = {
+    command: string;
+    cwd: string;
+    env?: TSandboxManagedServiceEnvEntry[];
+    metadata?: ISandboxManagedService['metadata'];
+    port?: number | null;
+    previewPath?: string | null;
+    readyPattern?: string | null;
+    serviceId: string;
+    onStateChange?: (change: SandboxManagedServiceStateChange) => MaybePromise<void>;
+};
+export type SandboxManagedServiceListOptions = {
+    services: ISandboxManagedService[];
+};
+export type SandboxManagedServiceListResult = {
+    services: ISandboxManagedService[];
+};
+export type SandboxManagedServiceLogsOptions = {
+    service: ISandboxManagedService;
+    tail?: number;
+};
+export type SandboxManagedServiceStopOptions = {
+    service: ISandboxManagedService;
+    onStateChange?: (change: SandboxManagedServiceStateChange) => MaybePromise<void>;
+};
+export type SandboxManagedServiceRestartOptions = {
+    command: string;
+    cwd: string;
+    env?: TSandboxManagedServiceEnvEntry[];
+    metadata?: ISandboxManagedService['metadata'];
+    port?: number | null;
+    previewPath?: string | null;
+    readyPattern?: string | null;
+    service: ISandboxManagedService;
+    onStateChange?: (change: SandboxManagedServiceStateChange) => MaybePromise<void>;
+};
+export type SandboxManagedServiceStartResult = SandboxManagedServiceStateChange;
+export interface SandboxManagedServiceAdapter {
+    getServiceLogs(options: SandboxManagedServiceLogsOptions): MaybePromise<TSandboxManagedServiceLogs>;
+    listServices(options: SandboxManagedServiceListOptions): MaybePromise<SandboxManagedServiceListResult>;
+    restartService(options: SandboxManagedServiceRestartOptions): MaybePromise<SandboxManagedServiceStartResult>;
+    startService(options: SandboxManagedServiceStartOptions): MaybePromise<SandboxManagedServiceStartResult>;
+    stopService(options: SandboxManagedServiceStopOptions): MaybePromise<SandboxManagedServiceStateChange>;
+}
+export type SandboxServiceProxyRequest = {
+    path: string;
+    request: IncomingMessage;
+    response: ServerResponse<IncomingMessage>;
+    service: ISandboxManagedService;
+};
+export interface SandboxServiceProxyAdapter {
+    proxyServiceRequest(request: SandboxServiceProxyRequest): MaybePromise<void>;
+}
+export declare function isSandboxManagedServiceAdapter(value: unknown): value is SandboxManagedServiceAdapter;
+export declare function resolveSandboxManagedServiceAdapter(sandbox: TSandboxConfigurable | SandboxManagedServiceAdapter | null | undefined | unknown): SandboxManagedServiceAdapter | null;
+export declare function isSandboxServiceProxyAdapter(value: unknown): value is SandboxServiceProxyAdapter;
+export declare function resolveSandboxServiceProxyAdapter(sandbox: TSandboxConfigurable | SandboxServiceProxyAdapter | null | undefined | unknown): SandboxServiceProxyAdapter | null;

package/src/lib/sandbox/sandbox.interface.d.ts

@@ -1,10 +1,36 @@
 import { TSandboxProviderMeta, TSandboxWorkForType } from '@xpert-ai/contracts';
 import { SandboxBackendProtocol } from './protocol';
+export type SandboxWorkspaceBinding = {
+    /**
+     * Host-side bind source used by containerized sandboxes.
+     */
+    bindSource?: string;
+    /**
+     * Mount target inside the sandbox container, such as `/workspace`.
+     */
+    containerMountPath?: string;
+    /**
+     * Server-visible canonical volume root.
+     */
+    volumeRoot: string;
+    /**
+     * Concrete sandbox-visible working path derived from the mapped workspace root.
+     */
+    workspacePath: string;
+    /**
+     * Sandbox-visible workspace root that corresponds to `volumeRoot`.
+     */
+    workspaceRoot: string;
+};
 export type SandboxProviderCreateOptions = {
     /**
      * Working space directory for the sandbox instance
      */
     workingDirectory?: string;
+    /**
+     * Explicit mapping between the server-visible volume root and the sandbox-visible workspace root.
+     */
+    workspaceBinding?: SandboxWorkspaceBinding;
     /**
      * Canonical sandbox environment identifier that owns the container lifecycle.
      */

package/src/lib/sandbox/terminal.d.ts

@@ -0,0 +1,22 @@
+import type { TSandboxConfigurable } from '@xpert-ai/contracts';
+import type { MaybePromise } from './protocol';
+export type SandboxTerminalExit = {
+    exitCode: number | null;
+    signal?: number | null;
+};
+export type SandboxTerminalOpenOptions = {
+    cols: number;
+    rows: number;
+    onExit: (event: SandboxTerminalExit) => void;
+    onOutput: (data: string) => void;
+};
+export interface SandboxTerminalSession {
+    close(): MaybePromise<void>;
+    resize(cols: number, rows: number): MaybePromise<void>;
+    write(data: string): MaybePromise<void>;
+}
+export interface SandboxTerminalAdapter {
+    open(options: SandboxTerminalOpenOptions): MaybePromise<SandboxTerminalSession>;
+}
+export declare function isSandboxTerminalAdapter(value: unknown): value is SandboxTerminalAdapter;
+export declare function resolveSandboxTerminalAdapter(sandbox: TSandboxConfigurable | SandboxTerminalAdapter | null | undefined | unknown): SandboxTerminalAdapter | null;

package/src/lib/workflow/commands/wrap-workflow-node-execution.command.d.ts

@@ -1,26 +1,14 @@
-import { IXpertAgentExecution, JSONValue } from '@xpert-ai/contracts';
+import { IXpertAgentExecution } from '@xpert-ai/contracts';
 import { Command } from '@nestjs/cqrs';
-import { Subscriber } from 'rxjs';
+import { AgentMiddlewareWrapWorkflowNodeExecutionParams, AgentMiddlewareWrapWorkflowNodeExecutionResult } from '../../agent/middleware/runtime';
 /**
  * Wrap Workflow Node Execution Command
+ *
+ * @deprecated Prefer `IAgentMiddlewareContext.runtime.wrapWorkflowNodeExecution(...)` in middleware and plugin code.
  */
 export declare class WrapWorkflowNodeExecutionCommand<T = any> extends Command<T> {
-    readonly fuc: (execution: Partial<IXpertAgentExecution>) => Promise<{
-        output?: string | JSONValue;
-        state: T;
-    }>;
-    readonly params: {
-        execution: Partial<IXpertAgentExecution>;
-        subscriber?: Subscriber<MessageEvent>;
-        catchError?: (error: Error) => Promise<void>;
-    };
+    readonly fuc: (execution: Partial<IXpertAgentExecution>) => Promise<AgentMiddlewareWrapWorkflowNodeExecutionResult<T>>;
+    readonly params: AgentMiddlewareWrapWorkflowNodeExecutionParams;
     static readonly type = "[Workflow] Wrap Workflow Node Execution";
-    constructor(fuc: (execution: Partial<IXpertAgentExecution>) => Promise<{
-        output?: string | JSONValue;
-        state: T;
-    }>, params: {
-        execution: Partial<IXpertAgentExecution>;
-        subscriber?: Subscriber<MessageEvent>;
-        catchError?: (error: Error) => Promise<void>;
-    });
+    constructor(fuc: (execution: Partial<IXpertAgentExecution>) => Promise<AgentMiddlewareWrapWorkflowNodeExecutionResult<T>>, params: AgentMiddlewareWrapWorkflowNodeExecutionParams);
 }