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

package/CHANGELOG.md

@@ -1,12 +1,19 @@
 # @xpert-ai/plugin-sdk
 
-## 3.9.0-beta.3
+## 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

@@ -2944,14 +2944,14 @@ function resolveSandboxExecutionOptions(options, defaults = DEFAULT_SANDBOX_SHEL
  *
  * @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 +3880,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 +4066,7 @@ exports.getRequestContext = getRequestContext;
 exports.getRequiredPermissionOperation = getRequiredPermissionOperation;
 exports.isRemoteFile = isRemoteFile;
 exports.isSandboxBackend = isSandboxBackend;
+exports.isSandboxTerminalAdapter = isSandboxTerminalAdapter;
 exports.isStructuredMessageType = isStructuredMessageType;
 exports.loadYamlFile = loadYamlFile;
 exports.mergeCredentials = mergeCredentials;
@@ -4059,6 +4074,7 @@ exports.mergeParentChildChunks = mergeParentChildChunks;
 exports.normalizeContextSize = normalizeContextSize;
 exports.resolveSandboxBackend = resolveSandboxBackend;
 exports.resolveSandboxExecutionOptions = resolveSandboxExecutionOptions;
+exports.resolveSandboxTerminalAdapter = resolveSandboxTerminalAdapter;
 exports.runWithRequestContext = runWithRequestContext;
 exports.secondsToMilliseconds = secondsToMilliseconds;
 exports.sumTokenUsage = sumTokenUsage;

package/index.esm.js

@@ -2923,14 +2923,14 @@ function resolveSandboxExecutionOptions(options, defaults = DEFAULT_SANDBOX_SHEL
  *
  * @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 +3859,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 +3913,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, isSandboxTerminalAdapter, isStructuredMessageType, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, resolveSandboxBackend, resolveSandboxExecutionOptions, 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.0",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",

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

@@ -12,6 +12,7 @@ export interface IAgentMiddlewareContext {
     xpertId?: string;
     xpertFeatures?: TXpertFeatures | null;
     agentKey?: string;
+    knowledgebaseIds?: string[];
     node: IWFNMiddleware;
     tools: Map<string, StructuredToolInterface | RunnableToolLike>;
 }

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

@@ -4,6 +4,7 @@ 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/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;