@xpert-ai/plugin-sdk 3.15.16 → 3.15.18

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @xpert-ai/plugin-sdk
 
+## 3.15.18
+
+### Patch Changes
+
+- 2f6bf18: Support localized plugin display names and descriptions across plugin metadata, the platform registry, and marketplace dialogs.
+- Updated dependencies [2f6bf18]
+  - @xpert-ai/contracts@3.15.18
+
+## 3.15.17
+
+### Patch Changes
+
+- 0a90701: release 3.15.17
+- Updated dependencies [0a90701]
+  - @xpert-ai/contracts@3.15.17
+
 ## 3.15.16
 
 ### Patch Changes

package/index.cjs.js

@@ -446,7 +446,25 @@ class RequestContext {
         this.extras = extras;
     }
 }
-const als = new node_async_hooks.AsyncLocalStorage();
+const REQUEST_CONTEXT_STORAGE_KEY = Symbol.for('xpert.plugin-sdk.request-context.storage.v1');
+function getSharedRequestContextStorage() {
+    const existing = Reflect.get(globalThis, REQUEST_CONTEXT_STORAGE_KEY);
+    if (existing instanceof node_async_hooks.AsyncLocalStorage) {
+        return existing;
+    }
+    const storage = new node_async_hooks.AsyncLocalStorage();
+    Reflect.defineProperty(globalThis, REQUEST_CONTEXT_STORAGE_KEY, {
+        value: storage,
+        configurable: false,
+        enumerable: false,
+        writable: false
+    });
+    return storage;
+}
+/**
+ * One process-wide context store shared by source, built, and dynamically loaded
+ * copies of the Plugin SDK. Plugin class identity may differ; the async scope must not.
+ */ const als = getSharedRequestContextStorage();
 function getRequestContext() {
     return als.getStore();
 }
@@ -536,9 +554,9 @@ class BaseStrategyRegistry {
         }
         const type = this.reflector.get(this.strategyKey, target);
         if (type) {
-            const pluginName = this.reflector.get(PLUGIN_METADATA_KEY, target);
-            var _this_reflector_get;
-            const organizationId = (_this_reflector_get = this.reflector.get(ORGANIZATION_METADATA_KEY, target)) != null ? _this_reflector_get : pluginName ? GLOBAL_ORGANIZATION_SCOPE : BUILTIN_GLOBAL_SCOPE;
+            const source = this.getSource(instance);
+            const pluginName = source.kind === 'plugin' ? source.pluginName : undefined;
+            const organizationId = source.scopeKey;
             var _this_strategies_get;
             const orgMap = (_this_strategies_get = this.strategies.get(organizationId)) != null ? _this_strategies_get : new Map();
             orgMap.set(type, instance);
@@ -552,6 +570,29 @@ class BaseStrategyRegistry {
             }
         }
     }
+    /** Returns the explicit registry provenance attached by the plugin loader. */ getSource(instance) {
+        const target = resolveStrategyMetadataTarget(instance);
+        if (!target) {
+            return {
+                kind: 'builtin',
+                scopeKey: BUILTIN_GLOBAL_SCOPE
+            };
+        }
+        const pluginName = this.reflector.get(PLUGIN_METADATA_KEY, target);
+        if (!pluginName) {
+            var _this_reflector_get;
+            return {
+                kind: 'builtin',
+                scopeKey: (_this_reflector_get = this.reflector.get(ORGANIZATION_METADATA_KEY, target)) != null ? _this_reflector_get : BUILTIN_GLOBAL_SCOPE
+            };
+        }
+        var _this_reflector_get1;
+        return {
+            kind: 'plugin',
+            pluginName,
+            scopeKey: (_this_reflector_get1 = this.reflector.get(ORGANIZATION_METADATA_KEY, target)) != null ? _this_reflector_get1 : GLOBAL_ORGANIZATION_SCOPE
+        };
+    }
     /**
      * Remove all strategies registered by the given plugin for the given scope.
      */ remove(organizationId, pluginName) {
@@ -2816,7 +2857,7 @@ const ArtifactsRuntimeCapability = createRuntimeCapability('platform.artifacts',
 
 /** Stable source identifier for portable workspace file references. */ const WORKSPACE_FILES_SOURCE = 'platform.workspace.files';
 const WorkspaceFilesRuntimeCapability = createRuntimeCapability('platform.workspace.files', {
-    description: 'Upload, understand, read, and delete raw files in Xpert workspace volumes.'
+    description: 'Upload, understand, resolve, read, and delete raw files in Xpert workspace volumes.'
 });
 
 /** Stable machine-readable failures emitted by the Sandbox Jobs capability. */ const SANDBOX_JOB_ERROR_CODES = [
@@ -2830,10 +2871,12 @@ const WorkspaceFilesRuntimeCapability = createRuntimeCapability('platform.worksp
     'BROWSER_LAUNCH_FAILED',
     'EXPORT_TIMEOUT',
     'EXPORT_OOM',
+    'EXPORT_MEDIA_FAILED',
     'EXPORT_INPUT_INVALID',
     'EXPORT_OUTPUT_INVALID',
     'SANDBOX_CANCELLED'
 ];
+/** Line prefix used by trusted Actions to report structured, provider-neutral progress. */ const SANDBOX_JOB_PROGRESS_PREFIX = 'XPERT_SANDBOX_PROGRESS ';
 /** Error carrying retry policy and Job identity across plugin queue handlers. */ class SandboxJobRuntimeError extends Error {
     constructor(code, message, retryable, jobId){
         super(message);
@@ -2843,8 +2886,14 @@ const WorkspaceFilesRuntimeCapability = createRuntimeCapability('platform.worksp
         this.name = 'SandboxJobRuntimeError';
     }
 }
+const SANDBOX_JOB_ERROR_CODE_SET = new Set(SANDBOX_JOB_ERROR_CODES);
 /** Narrows an unknown failure to the structured Sandbox Jobs runtime error contract. */ function isSandboxJobRuntimeError(error) {
-    return error instanceof SandboxJobRuntimeError;
+    if (error instanceof SandboxJobRuntimeError) return true;
+    if (typeof error !== 'object' || error === null) return false;
+    // Dynamically loaded plugins may resolve another Plugin SDK module instance,
+    // so class identity is not a reliable runtime boundary. Validate the stable shape.
+    const candidate = error;
+    return candidate.name === 'SandboxJobRuntimeError' && typeof candidate.message === 'string' && typeof candidate.code === 'string' && SANDBOX_JOB_ERROR_CODE_SET.has(candidate.code) && typeof candidate.retryable === 'boolean' && (candidate.jobId === undefined || typeof candidate.jobId === 'string');
 }
 /** Runtime capability key used to resolve SandboxJobsApi from the platform registry. */ const SandboxJobsRuntimeCapability = createRuntimeCapability('platform.sandbox.jobs', {
     description: 'Run registered plugin actions in isolated, short-lived Sandbox Runtime jobs.'
@@ -5006,6 +5055,7 @@ exports.RequirePermissionOperation = RequirePermissionOperation;
 exports.RerankModel = RerankModel;
 exports.RetrieverStrategy = RetrieverStrategy;
 exports.SANDBOX_JOB_ERROR_CODES = SANDBOX_JOB_ERROR_CODES;
+exports.SANDBOX_JOB_PROGRESS_PREFIX = SANDBOX_JOB_PROGRESS_PREFIX;
 exports.SANDBOX_PROVIDER = SANDBOX_PROVIDER;
 exports.SANDBOX_RUNTIME_PROVIDER = SANDBOX_RUNTIME_PROVIDER;
 exports.SANDBOX_SHELL_TIMEOUT_LIMITS_SEC = SANDBOX_SHELL_TIMEOUT_LIMITS_SEC;

package/index.esm.js

@@ -428,7 +428,25 @@ class RequestContext {
         this.extras = extras;
     }
 }
-const als = new AsyncLocalStorage();
+const REQUEST_CONTEXT_STORAGE_KEY = Symbol.for('xpert.plugin-sdk.request-context.storage.v1');
+function getSharedRequestContextStorage() {
+    const existing = Reflect.get(globalThis, REQUEST_CONTEXT_STORAGE_KEY);
+    if (existing instanceof AsyncLocalStorage) {
+        return existing;
+    }
+    const storage = new AsyncLocalStorage();
+    Reflect.defineProperty(globalThis, REQUEST_CONTEXT_STORAGE_KEY, {
+        value: storage,
+        configurable: false,
+        enumerable: false,
+        writable: false
+    });
+    return storage;
+}
+/**
+ * One process-wide context store shared by source, built, and dynamically loaded
+ * copies of the Plugin SDK. Plugin class identity may differ; the async scope must not.
+ */ const als = getSharedRequestContextStorage();
 function getRequestContext() {
     return als.getStore();
 }
@@ -518,9 +536,9 @@ class BaseStrategyRegistry {
         }
         const type = this.reflector.get(this.strategyKey, target);
         if (type) {
-            const pluginName = this.reflector.get(PLUGIN_METADATA_KEY, target);
-            var _this_reflector_get;
-            const organizationId = (_this_reflector_get = this.reflector.get(ORGANIZATION_METADATA_KEY, target)) != null ? _this_reflector_get : pluginName ? GLOBAL_ORGANIZATION_SCOPE : BUILTIN_GLOBAL_SCOPE;
+            const source = this.getSource(instance);
+            const pluginName = source.kind === 'plugin' ? source.pluginName : undefined;
+            const organizationId = source.scopeKey;
             var _this_strategies_get;
             const orgMap = (_this_strategies_get = this.strategies.get(organizationId)) != null ? _this_strategies_get : new Map();
             orgMap.set(type, instance);
@@ -534,6 +552,29 @@ class BaseStrategyRegistry {
             }
         }
     }
+    /** Returns the explicit registry provenance attached by the plugin loader. */ getSource(instance) {
+        const target = resolveStrategyMetadataTarget(instance);
+        if (!target) {
+            return {
+                kind: 'builtin',
+                scopeKey: BUILTIN_GLOBAL_SCOPE
+            };
+        }
+        const pluginName = this.reflector.get(PLUGIN_METADATA_KEY, target);
+        if (!pluginName) {
+            var _this_reflector_get;
+            return {
+                kind: 'builtin',
+                scopeKey: (_this_reflector_get = this.reflector.get(ORGANIZATION_METADATA_KEY, target)) != null ? _this_reflector_get : BUILTIN_GLOBAL_SCOPE
+            };
+        }
+        var _this_reflector_get1;
+        return {
+            kind: 'plugin',
+            pluginName,
+            scopeKey: (_this_reflector_get1 = this.reflector.get(ORGANIZATION_METADATA_KEY, target)) != null ? _this_reflector_get1 : GLOBAL_ORGANIZATION_SCOPE
+        };
+    }
     /**
      * Remove all strategies registered by the given plugin for the given scope.
      */ remove(organizationId, pluginName) {
@@ -2798,7 +2839,7 @@ const ArtifactsRuntimeCapability = createRuntimeCapability('platform.artifacts',
 
 /** Stable source identifier for portable workspace file references. */ const WORKSPACE_FILES_SOURCE = 'platform.workspace.files';
 const WorkspaceFilesRuntimeCapability = createRuntimeCapability('platform.workspace.files', {
-    description: 'Upload, understand, read, and delete raw files in Xpert workspace volumes.'
+    description: 'Upload, understand, resolve, read, and delete raw files in Xpert workspace volumes.'
 });
 
 /** Stable machine-readable failures emitted by the Sandbox Jobs capability. */ const SANDBOX_JOB_ERROR_CODES = [
@@ -2812,10 +2853,12 @@ const WorkspaceFilesRuntimeCapability = createRuntimeCapability('platform.worksp
     'BROWSER_LAUNCH_FAILED',
     'EXPORT_TIMEOUT',
     'EXPORT_OOM',
+    'EXPORT_MEDIA_FAILED',
     'EXPORT_INPUT_INVALID',
     'EXPORT_OUTPUT_INVALID',
     'SANDBOX_CANCELLED'
 ];
+/** Line prefix used by trusted Actions to report structured, provider-neutral progress. */ const SANDBOX_JOB_PROGRESS_PREFIX = 'XPERT_SANDBOX_PROGRESS ';
 /** Error carrying retry policy and Job identity across plugin queue handlers. */ class SandboxJobRuntimeError extends Error {
     constructor(code, message, retryable, jobId){
         super(message);
@@ -2825,8 +2868,14 @@ const WorkspaceFilesRuntimeCapability = createRuntimeCapability('platform.worksp
         this.name = 'SandboxJobRuntimeError';
     }
 }
+const SANDBOX_JOB_ERROR_CODE_SET = new Set(SANDBOX_JOB_ERROR_CODES);
 /** Narrows an unknown failure to the structured Sandbox Jobs runtime error contract. */ function isSandboxJobRuntimeError(error) {
-    return error instanceof SandboxJobRuntimeError;
+    if (error instanceof SandboxJobRuntimeError) return true;
+    if (typeof error !== 'object' || error === null) return false;
+    // Dynamically loaded plugins may resolve another Plugin SDK module instance,
+    // so class identity is not a reliable runtime boundary. Validate the stable shape.
+    const candidate = error;
+    return candidate.name === 'SandboxJobRuntimeError' && typeof candidate.message === 'string' && typeof candidate.code === 'string' && SANDBOX_JOB_ERROR_CODE_SET.has(candidate.code) && typeof candidate.retryable === 'boolean' && (candidate.jobId === undefined || typeof candidate.jobId === 'string');
 }
 /** Runtime capability key used to resolve SandboxJobsApi from the platform registry. */ const SandboxJobsRuntimeCapability = createRuntimeCapability('platform.sandbox.jobs', {
     description: 'Run registered plugin actions in isolated, short-lived Sandbox Runtime jobs.'
@@ -4866,4 +4915,4 @@ CollaborationDocumentProviderRegistry = __decorate([
     ])
 ], CollaborationDocumentProviderRegistry);
 
-export { ACCOUNT_BINDING_PERMISSION_SERVICE_TOKEN, AGENT_CHAT_DISPATCH_ERROR_STEER_TARGET_NOT_RUNNING, AGENT_CHAT_DISPATCH_MESSAGE_TYPE, AGENT_MIDDLEWARE_STRATEGY, AIModelProviderNotFoundException, AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, ANALYTICS_PERMISSION_SERVICE_TOKEN, AdapterDataSourceStrategy, AgentMiddlewareRegistry, AgentMiddlewareStrategy, AiModelNotFoundException, ArtifactsRuntimeCapability, AssistantTaskRuntimeCapability, BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN, BUILTIN_GLOBAL_SCOPE, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, BaseTool, BaseToolset, BuiltinToolset, CHAT_CHANNEL, CHAT_CHANNEL_TEXT_LIMITS, COLLABORATION_DOCUMENT_PROVIDER, CONNECTION_COMMAND_ROUTER_TOKEN, CONNECTOR_STRATEGY, CancelConversationCommand, ChatChannel, ChatChannelRegistry, ChatOAICompatReasoningModel, CollaborationDocumentProvider, CollaborationDocumentProviderRegistry, CollaborationRuntimeCapability, CommonParameterRules, ConnectorRuntimeCapability, ConnectorStrategyKey, ConnectorStrategyRegistry, 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, DefaultRuntimeCapabilityRegistry as DefaultAgentMiddlewareRuntimeCapabilityRegistry, DefaultRuntimeCapabilityRegistry, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, FILE_STORAGE_PROVIDER, FILE_UPLOAD_TARGET_STRATEGY, FileRuntimeCapability, 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, KnowledgebaseDocumentsRuntimeCapability, KnowledgebaseRuntimeCapability, LLMUsage, LargeLanguageModel, MANAGED_CONNECTION_REGISTRY_TOKEN, MANAGED_QUEUE_HANDLER_REGISTRY_TOKEN, MANAGED_QUEUE_SERVICE_TOKEN, ModelProvider, ORGANIZATION_METADATA_KEY, OpenAICompatibleReranker, PERMISSION_OPERATION_METADATA_KEY, PLUGIN_CONFIG_RESOLVER_TOKEN, PLUGIN_JOB_PROCESSOR_METADATA, PLUGIN_METADATA, PLUGIN_METADATA_KEY, PLUGIN_WEBHOOK_AUTH_METADATA_KEY, PLUGIN_WEBHOOK_AUTH_SERVICE_TOKEN, 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, PluginJobProcessor, PluginWebhookAuth, PluginWebhookAuthGuard, RETRIEVER_STRATEGY, RequestContext, RequestContextMiddleware, RequirePermissionOperation, RerankModel, RetrieverRegistry, RetrieverStrategy, SANDBOX_JOB_ERROR_CODES, SANDBOX_PROVIDER, SANDBOX_RUNTIME_PROVIDER, SANDBOX_SHELL_TIMEOUT_LIMITS_SEC, SANDBOX_WORKSPACE_MAPPER, SKILL_SOURCE_PROVIDER, SPEECH_TO_TEXT_PERMISSION_SERVICE_TOKEN, SPEECH_TO_TEXT_SERVICE_TOKEN, SSOProviderRegistry, SSOProviderStrategyKey, SSO_BINDING_PERMISSION_SERVICE_TOKEN, SSO_PROVIDER, STRATEGY_META_KEY, SYSTEM_GLOBAL_SCOPE, SandboxJobRuntimeError, SandboxJobsRuntimeCapability, SandboxProviderRegistry, SandboxProviderStrategy, SandboxRuntimeProviderRegistry, SandboxRuntimeProviderStrategy, SandboxWorkspaceMapperRegistry, SandboxWorkspaceMapperStrategy, SkillSourceProviderRegistry, SkillSourceProviderStrategy, Speech2TextChatModel, SpeechToTextModel, StrategyBus, TENANT_GLOBAL_SCOPE_PREFIX, TENANT_GLOBAL_SCOPE_SUFFIX, 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, WORKSPACE_FILES_SOURCE, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, WorkspaceFilesRuntimeCapability, WrapWorkflowNodeExecutionCommand, XPERT_RUNTIME_CAPABILITIES_TOKEN, XpFileSystem, XpertServerPlugin, als, appendSandboxMessage, assertConnectorDefinition, buildSandboxTimeoutMessage, calcTokenUsage, calculateModelPrice, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, createRuntimeCapability, defineAgentMessageType, defineChannelMessageType, derivePluginArtifactNamespace, downloadRemoteFile, formatSandboxTimeout, getDefaultTenantId, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, getTenantGlobalScopeKey, isDevelopmentSandboxRuntimeEnvironment, isRemoteFile, isSandboxBackend, isSandboxJobRuntimeError, isSandboxManagedServiceAdapter, isSandboxServiceProxyAdapter, isSandboxTerminalAdapter, isStrategyInstance, isStructuredMessageType, isTenantGlobalScopeKey, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, pluginArtifactTableName, renderRemoteModuleIframeHtml, renderRemoteReactIframeHtml, renderRemoteVueIframeHtml, resolveSandboxBackend, resolveSandboxExecutionOptions, resolveSandboxManagedServiceAdapter, resolveSandboxServiceProxyAdapter, resolveSandboxTerminalAdapter, resolveStrategyMetadataTarget, resolveTenantGlobalScopeKey, runWithRequestContext, secondsToMilliseconds, setDefaultTenantId, sumTokenUsage };
+export { ACCOUNT_BINDING_PERMISSION_SERVICE_TOKEN, AGENT_CHAT_DISPATCH_ERROR_STEER_TARGET_NOT_RUNNING, AGENT_CHAT_DISPATCH_MESSAGE_TYPE, AGENT_MIDDLEWARE_STRATEGY, AIModelProviderNotFoundException, AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, ANALYTICS_PERMISSION_SERVICE_TOKEN, AdapterDataSourceStrategy, AgentMiddlewareRegistry, AgentMiddlewareStrategy, AiModelNotFoundException, ArtifactsRuntimeCapability, AssistantTaskRuntimeCapability, BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN, BUILTIN_GLOBAL_SCOPE, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, BaseTool, BaseToolset, BuiltinToolset, CHAT_CHANNEL, CHAT_CHANNEL_TEXT_LIMITS, COLLABORATION_DOCUMENT_PROVIDER, CONNECTION_COMMAND_ROUTER_TOKEN, CONNECTOR_STRATEGY, CancelConversationCommand, ChatChannel, ChatChannelRegistry, ChatOAICompatReasoningModel, CollaborationDocumentProvider, CollaborationDocumentProviderRegistry, CollaborationRuntimeCapability, CommonParameterRules, ConnectorRuntimeCapability, ConnectorStrategyKey, ConnectorStrategyRegistry, 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, DefaultRuntimeCapabilityRegistry as DefaultAgentMiddlewareRuntimeCapabilityRegistry, DefaultRuntimeCapabilityRegistry, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, FILE_STORAGE_PROVIDER, FILE_UPLOAD_TARGET_STRATEGY, FileRuntimeCapability, 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, KnowledgebaseDocumentsRuntimeCapability, KnowledgebaseRuntimeCapability, LLMUsage, LargeLanguageModel, MANAGED_CONNECTION_REGISTRY_TOKEN, MANAGED_QUEUE_HANDLER_REGISTRY_TOKEN, MANAGED_QUEUE_SERVICE_TOKEN, ModelProvider, ORGANIZATION_METADATA_KEY, OpenAICompatibleReranker, PERMISSION_OPERATION_METADATA_KEY, PLUGIN_CONFIG_RESOLVER_TOKEN, PLUGIN_JOB_PROCESSOR_METADATA, PLUGIN_METADATA, PLUGIN_METADATA_KEY, PLUGIN_WEBHOOK_AUTH_METADATA_KEY, PLUGIN_WEBHOOK_AUTH_SERVICE_TOKEN, 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, PluginJobProcessor, PluginWebhookAuth, PluginWebhookAuthGuard, RETRIEVER_STRATEGY, RequestContext, RequestContextMiddleware, RequirePermissionOperation, RerankModel, RetrieverRegistry, RetrieverStrategy, SANDBOX_JOB_ERROR_CODES, SANDBOX_JOB_PROGRESS_PREFIX, SANDBOX_PROVIDER, SANDBOX_RUNTIME_PROVIDER, SANDBOX_SHELL_TIMEOUT_LIMITS_SEC, SANDBOX_WORKSPACE_MAPPER, SKILL_SOURCE_PROVIDER, SPEECH_TO_TEXT_PERMISSION_SERVICE_TOKEN, SPEECH_TO_TEXT_SERVICE_TOKEN, SSOProviderRegistry, SSOProviderStrategyKey, SSO_BINDING_PERMISSION_SERVICE_TOKEN, SSO_PROVIDER, STRATEGY_META_KEY, SYSTEM_GLOBAL_SCOPE, SandboxJobRuntimeError, SandboxJobsRuntimeCapability, SandboxProviderRegistry, SandboxProviderStrategy, SandboxRuntimeProviderRegistry, SandboxRuntimeProviderStrategy, SandboxWorkspaceMapperRegistry, SandboxWorkspaceMapperStrategy, SkillSourceProviderRegistry, SkillSourceProviderStrategy, Speech2TextChatModel, SpeechToTextModel, StrategyBus, TENANT_GLOBAL_SCOPE_PREFIX, TENANT_GLOBAL_SCOPE_SUFFIX, 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, WORKSPACE_FILES_SOURCE, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, WorkspaceFilesRuntimeCapability, WrapWorkflowNodeExecutionCommand, XPERT_RUNTIME_CAPABILITIES_TOKEN, XpFileSystem, XpertServerPlugin, als, appendSandboxMessage, assertConnectorDefinition, buildSandboxTimeoutMessage, calcTokenUsage, calculateModelPrice, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, createRuntimeCapability, defineAgentMessageType, defineChannelMessageType, derivePluginArtifactNamespace, downloadRemoteFile, formatSandboxTimeout, getDefaultTenantId, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, getTenantGlobalScopeKey, isDevelopmentSandboxRuntimeEnvironment, isRemoteFile, isSandboxBackend, isSandboxJobRuntimeError, isSandboxManagedServiceAdapter, isSandboxServiceProxyAdapter, isSandboxTerminalAdapter, isStrategyInstance, isStructuredMessageType, isTenantGlobalScopeKey, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, pluginArtifactTableName, renderRemoteModuleIframeHtml, renderRemoteReactIframeHtml, renderRemoteVueIframeHtml, resolveSandboxBackend, resolveSandboxExecutionOptions, resolveSandboxManagedServiceAdapter, resolveSandboxServiceProxyAdapter, resolveSandboxTerminalAdapter, resolveStrategyMetadataTarget, resolveTenantGlobalScopeKey, runWithRequestContext, secondsToMilliseconds, setDefaultTenantId, sumTokenUsage };

package/package.json

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

package/src/lib/agent/middleware/capabilities/assistant-task.d.ts

@@ -39,8 +39,12 @@ export type AgentMiddlewareAssistantTaskStatusInput = {
     clientMessageId?: string;
     xpertId?: string;
 };
+export type AgentMiddlewareAssistantTaskCancelResult = {
+    canceledExecutionIds: string[];
+};
 export interface AgentMiddlewareAssistantTaskApi {
     startTask(input: AgentMiddlewareAssistantTaskInput): Promise<AgentMiddlewareAssistantTaskResult>;
     getTaskStatus?(input: AgentMiddlewareAssistantTaskStatusInput): Promise<AgentMiddlewareAssistantTaskResult | null>;
+    cancelTask?(input: AgentMiddlewareAssistantTaskStatusInput): Promise<AgentMiddlewareAssistantTaskCancelResult>;
 }
 export declare const AssistantTaskRuntimeCapability: import("../../../core/runtime-capability").RuntimeCapabilityKey<AgentMiddlewareAssistantTaskApi>;

package/src/lib/core/context/request-context.d.ts

@@ -47,5 +47,9 @@ export declare class RequestContext {
      */
     static hasRoles(roles: RolesEnum[], throwError?: boolean): boolean;
 }
+/**
+ * One process-wide context store shared by source, built, and dynamically loaded
+ * copies of the Plugin SDK. Plugin class identity may differ; the async scope must not.
+ */
 export declare const als: AsyncLocalStorage<RequestContext>;
 export declare function getRequestContext(): RequestContext;

package/src/lib/managed-queue/index.d.ts

@@ -86,6 +86,11 @@ export type ManagedQueueJobContext = {
     queueName: string;
     jobName: string;
     scopeKey?: string | null;
+    /** Persisted queue ownership restored independently of ambient request context. */
+    tenantId?: string | null;
+    organizationId?: string | null;
+    /** Business actor captured when the logical job was enqueued. */
+    userId?: string | null;
 };
 export type ManagedQueueJobSnapshot<TPayload = unknown> = ManagedQueueJob<TPayload> & {
     state?: string;
@@ -95,7 +100,7 @@ export type ManagedQueueJobSnapshot<TPayload = unknown> = ManagedQueueJob<TPaylo
     processedOn?: number;
     finishedOn?: number;
 };
-export type ManagedQueueJobHandler<TPayload = unknown> = (job: ManagedQueueJob<TPayload>) => Promise<void> | void;
+export type ManagedQueueJobHandler<TPayload = unknown> = (job: ManagedQueueJob<TPayload>, context: ManagedQueueJobContext) => Promise<void> | void;
 export interface ManagedQueueJobProcessor<TPayload = unknown> {
     handle(job: ManagedQueueJob<TPayload>, context: ManagedQueueJobContext): Promise<void> | void;
 }

package/src/lib/runtime/capabilities/sandbox-jobs.d.ts

@@ -1,10 +1,27 @@
 import type { JSONValue } from '@xpert-ai/contracts';
 import type { WorkspaceFileScope, WorkspacePortableFileReference } from './workspace-files';
 /** Stable machine-readable failures emitted by the Sandbox Jobs capability. */
-export declare const SANDBOX_JOB_ERROR_CODES: readonly ["SANDBOX_ACTION_UNAVAILABLE", "SANDBOX_ACTION_INVALID", "SANDBOX_PROFILE_UNAVAILABLE", "SANDBOX_RUNTIME_UNAVAILABLE", "SANDBOX_VERSION_MISMATCH", "SANDBOX_CAPACITY_UNAVAILABLE", "SANDBOX_START_FAILED", "BROWSER_LAUNCH_FAILED", "EXPORT_TIMEOUT", "EXPORT_OOM", "EXPORT_INPUT_INVALID", "EXPORT_OUTPUT_INVALID", "SANDBOX_CANCELLED"];
+export declare const SANDBOX_JOB_ERROR_CODES: readonly ["SANDBOX_ACTION_UNAVAILABLE", "SANDBOX_ACTION_INVALID", "SANDBOX_PROFILE_UNAVAILABLE", "SANDBOX_RUNTIME_UNAVAILABLE", "SANDBOX_VERSION_MISMATCH", "SANDBOX_CAPACITY_UNAVAILABLE", "SANDBOX_START_FAILED", "BROWSER_LAUNCH_FAILED", "EXPORT_TIMEOUT", "EXPORT_OOM", "EXPORT_MEDIA_FAILED", "EXPORT_INPUT_INVALID", "EXPORT_OUTPUT_INVALID", "SANDBOX_CANCELLED"];
 export type SandboxJobErrorCode = (typeof SANDBOX_JOB_ERROR_CODES)[number];
 /** Persisted lifecycle states for a generic isolated background execution. */
 export type SandboxJobStatus = 'waiting' | 'starting' | 'running' | 'succeeded' | 'failed' | 'cancelled' | 'lost';
+/** Line prefix used by trusted Actions to report structured, provider-neutral progress. */
+export declare const SANDBOX_JOB_PROGRESS_PREFIX = "XPERT_SANDBOX_PROGRESS ";
+/** Latest structured progress reported by a Sandbox Action or Core lifecycle stage. */
+export type SandboxJobProgress = {
+    /** Normalized completion ratio from 0 through 1. */
+    progress: number;
+    /** Stable machine-readable stage such as `rendering`, `packaging`, or `complete`. */
+    stage?: string;
+    /** Optional bounded diagnostic intended for operational UIs and logs. */
+    message?: string;
+    /** Optional current work unit, for example the rendered frame number. */
+    current?: number;
+    /** Optional total work units corresponding to `current`. */
+    total?: number;
+    /** Platform timestamp of the latest accepted update. */
+    updatedAt?: Date | string | null;
+};
 /** Portable Workspace Files input materialized under `/workspace/input`. */
 export type SandboxJobFileInput = {
     /** Tenant-scoped portable reference; raw bytes never enter queue state. */
@@ -78,6 +95,8 @@ export type SandboxJobSnapshot = {
     action: string;
     actionVersion: string;
     status: SandboxJobStatus;
+    /** Latest persisted Action/Core progress, available while a Job is running and after reload. */
+    progress?: SandboxJobProgress | null;
     /** Attempt number; a new failed-job attempt may select a newly healthy Binding. */
     attempt: number;
     /** Provider and Binding are persisted so cleanup never depends on current selection. */

package/src/lib/runtime/capabilities/workspace-files.d.ts

@@ -160,6 +160,11 @@ export interface WorkspaceFilesApi {
     uploadBuffer(input: WorkspaceUploadBufferInput): Promise<WorkspaceFile>;
     /** Register an existing workspace file with the platform understanding pipeline. */
     understandFile(input: WorkspaceUnderstandFileInput): Promise<WorkspaceUnderstoodFile>;
+    /**
+     * Resolve metadata and an openable URL for an explicitly scoped workspace
+     * file without reading its bytes into the API process.
+     */
+    resolveFile(input: WorkspaceFileReference): Promise<WorkspaceFile>;
     /** Read raw bytes from an explicitly scoped workspace file reference. */
     readBuffer(input: WorkspaceFileReference): Promise<WorkspaceFileBuffer>;
     /** Delete an explicitly scoped workspace file. */

package/src/lib/sandbox/runtime-provider.d.ts

@@ -2,6 +2,16 @@
 export type SandboxRuntimeExecutionOptions = {
     timeoutMs?: number;
     maxOutputBytes?: number;
+    /**
+     * Streams normalized process output to Core while execution is active.
+     * Providers must treat observers as best-effort and must not let them fail the Runtime.
+     */
+    onOutput?: (output: SandboxRuntimeOutputChunk) => void;
+};
+/** One provider-neutral stdout/stderr chunk observed during Runtime execution. */
+export type SandboxRuntimeOutputChunk = {
+    stream: 'stdout' | 'stderr';
+    text: string;
 };
 /** Provider-observed reason why a Runtime execution stopped without a normal exit. */
 export type SandboxRuntimeTerminationReason = 'oom' | 'deadline' | 'cancelled' | 'runtime-died';

package/src/lib/strategy.d.ts

@@ -1,6 +1,14 @@
 import { OnModuleInit, type Type } from '@nestjs/common';
 import { DiscoveryService, Reflector } from '@nestjs/core';
 import { StrategyBus } from './core/strategy-bus';
+export type StrategySource = {
+    kind: 'builtin';
+    scopeKey: string;
+} | {
+    kind: 'plugin';
+    pluginName: string;
+    scopeKey: string;
+};
 export declare class BaseStrategyRegistry<S> implements OnModuleInit {
     protected readonly strategyKey: string;
     protected discoveryService: DiscoveryService;
@@ -12,6 +20,8 @@ export declare class BaseStrategyRegistry<S> implements OnModuleInit {
     constructor(strategyKey: string, discoveryService: DiscoveryService, reflector: Reflector);
     onModuleInit(): void;
     upsert(instance: unknown): void;
+    /** Returns the explicit registry provenance attached by the plugin loader. */
+    getSource(instance: S): StrategySource;
     /**
      * Remove all strategies registered by the given plugin for the given scope.
      */