@xpert-ai/plugin-sdk 3.17.3 → 3.17.5

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @xpert-ai/plugin-sdk
 
+## 3.17.5
+
+### Patch Changes
+
+- 9e59e41: Add stable tenant- and organization-scoped MCP publication, capability, authentication, execution context, tool result, resource, prompt, app, task, and change-event contracts for the Xpert MCP publishing platform.
+
+  Keep plugin schema contracts on the Zod v3 compatibility API while allowing consumers to install Zod 3.25 or Zod 4.
+
+- Updated dependencies [9e59e41]
+  - @xpert-ai/contracts@3.17.5
+
+## 3.17.4
+
+### Patch Changes
+
+- 7b6954a: project
+- Updated dependencies [7b6954a]
+  - @xpert-ai/contracts@3.17.4
+
 ## 3.17.3
 
 ### Patch Changes

package/index.cjs.js

@@ -37,7 +37,7 @@ var base$1 = require('@langchain/core/language_models/base');
 var connector = require('./connector.cjs.js');
 var collaborationClient = require('./collaboration-client.cjs.js');
 require('@langchain/core/tools');
-require('zod');
+require('zod/v3');
 
 function _interopNamespaceDefault(e) {
     var n = Object.create(null);
@@ -125,6 +125,7 @@ function assertPluginArtifactNamePart(value, label) {
 
 const ORGANIZATION_METADATA_KEY = 'xpert:organizationId';
 const PLUGIN_METADATA_KEY = 'xpert:pluginName';
+const PLUGIN_VERSION_METADATA_KEY = 'xpert:pluginVersion';
 const GLOBAL_ORGANIZATION_SCOPE = 'global';
 const SYSTEM_GLOBAL_SCOPE = 'system:global';
 const BUILTIN_GLOBAL_SCOPE = 'builtin:global';
@@ -591,12 +592,16 @@ class BaseStrategyRegistry {
                 scopeKey: (_this_reflector_get = this.reflector.get(ORGANIZATION_METADATA_KEY, target)) != null ? _this_reflector_get : BUILTIN_GLOBAL_SCOPE
             };
         }
+        const pluginVersion = this.reflector.get(PLUGIN_VERSION_METADATA_KEY, target);
         var _this_reflector_get1;
-        return {
+        return _extends._extends({
             kind: 'plugin',
-            pluginName,
+            pluginName
+        }, pluginVersion ? {
+            pluginVersion
+        } : {}, {
             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.
@@ -967,6 +972,10 @@ exports.ToolsetRegistry = __decorate([
     ])
 ], exports.ToolsetRegistry);
 
+function defineXpertTool(definition) {
+    return Object.freeze(definition);
+}
+
 /**
  * Restricted FileSystem based on granted permissions
  */ class XpFileSystem {
@@ -5752,6 +5761,46 @@ const EvolutionRuntimeCapability = modelProvider.createRuntimeCapability('platfo
     description: 'Ingest learning signals and resolve immutable capability versions for domain runtimes.'
 });
 
+function defineMcpApp(definition) {
+    return Object.freeze(definition);
+}
+
+const MCP_CAPABILITY_CHANGE_EVENT_TYPES = [
+    'tools.changed',
+    'resources.changed',
+    'resource.updated',
+    'prompts.changed',
+    'task.updated'
+];
+
+function defineMcpPrompt(definition) {
+    return Object.freeze(definition);
+}
+
+function defineMcpResource(definition) {
+    return Object.freeze(definition);
+}
+
+function defineMcpResourceTemplate(definition) {
+    return Object.freeze(definition);
+}
+
+function defineMcpCapabilities(definitions) {
+    return Object.freeze({
+        instructions: definitions.instructions,
+        tools: freezeItems(definitions.tools),
+        resources: freezeItems(definitions.resources),
+        resourceTemplates: freezeItems(definitions.resourceTemplates),
+        prompts: freezeItems(definitions.prompts),
+        apps: freezeItems(definitions.apps)
+    });
+}
+function freezeItems(items) {
+    return items ? Object.freeze([
+        ...items
+    ]) : undefined;
+}
+
 Object.defineProperty(exports, "ASSISTANT_CHAT_SEND_MESSAGE_COMMAND", {
     enumerable: true,
     get: function () { return contracts.ASSISTANT_CHAT_SEND_MESSAGE_COMMAND; }
@@ -5871,6 +5920,7 @@ exports.LargeLanguageModel = LargeLanguageModel;
 exports.MANAGED_CONNECTION_REGISTRY_TOKEN = MANAGED_CONNECTION_REGISTRY_TOKEN;
 exports.MANAGED_QUEUE_HANDLER_REGISTRY_TOKEN = MANAGED_QUEUE_HANDLER_REGISTRY_TOKEN;
 exports.MANAGED_QUEUE_SERVICE_TOKEN = MANAGED_QUEUE_SERVICE_TOKEN;
+exports.MCP_CAPABILITY_CHANGE_EVENT_TYPES = MCP_CAPABILITY_CHANGE_EVENT_TYPES;
 exports.MODEL_OUTPUT_VALIDATION_ERROR_CODE = MODEL_OUTPUT_VALIDATION_ERROR_CODE;
 exports.ModelOutputValidationError = ModelOutputValidationError;
 exports.ORGANIZATION_METADATA_KEY = ORGANIZATION_METADATA_KEY;
@@ -5880,6 +5930,7 @@ exports.PLUGIN_CONFIG_RESOLVER_TOKEN = PLUGIN_CONFIG_RESOLVER_TOKEN;
 exports.PLUGIN_JOB_PROCESSOR_METADATA = PLUGIN_JOB_PROCESSOR_METADATA;
 exports.PLUGIN_METADATA = PLUGIN_METADATA;
 exports.PLUGIN_METADATA_KEY = PLUGIN_METADATA_KEY;
+exports.PLUGIN_VERSION_METADATA_KEY = PLUGIN_VERSION_METADATA_KEY;
 exports.PLUGIN_WEBHOOK_AUTH_METADATA_KEY = PLUGIN_WEBHOOK_AUTH_METADATA_KEY;
 exports.PLUGIN_WEBHOOK_AUTH_SERVICE_TOKEN = PLUGIN_WEBHOOK_AUTH_SERVICE_TOKEN;
 exports.PROVIDE_AI_MODEL_LLM = PROVIDE_AI_MODEL_LLM;
@@ -5952,6 +6003,12 @@ exports.createI18nInstance = createI18nInstance;
 exports.createPluginLogger = createPluginLogger;
 exports.defineAgentMessageType = defineAgentMessageType;
 exports.defineChannelMessageType = defineChannelMessageType;
+exports.defineMcpApp = defineMcpApp;
+exports.defineMcpCapabilities = defineMcpCapabilities;
+exports.defineMcpPrompt = defineMcpPrompt;
+exports.defineMcpResource = defineMcpResource;
+exports.defineMcpResourceTemplate = defineMcpResourceTemplate;
+exports.defineXpertTool = defineXpertTool;
 exports.derivePluginArtifactNamespace = derivePluginArtifactNamespace;
 exports.downloadRemoteFile = downloadRemoteFile;
 exports.formatSandboxTimeout = formatSandboxTimeout;

package/index.esm.js

@@ -41,7 +41,7 @@ import { assertConnectorDefinition } from './connector.esm.js';
 export { getConnectorAuthMethods } from './connector.esm.js';
 export { base64ToBytes, bytesToBase64, createCollaborationClient, createCollaborationPresenceStore, createSocketIoTransportAdapter, createYjsDocumentAdapter } from './collaboration-client.esm.js';
 import '@langchain/core/tools';
-import 'zod';
+import 'zod/v3';
 
 /**
  * Metadata keys used in plugins for defining various aspects like entities, subscribers, and configurations.
@@ -107,6 +107,7 @@ function assertPluginArtifactNamePart(value, label) {
 
 const ORGANIZATION_METADATA_KEY = 'xpert:organizationId';
 const PLUGIN_METADATA_KEY = 'xpert:pluginName';
+const PLUGIN_VERSION_METADATA_KEY = 'xpert:pluginVersion';
 const GLOBAL_ORGANIZATION_SCOPE = 'global';
 const SYSTEM_GLOBAL_SCOPE = 'system:global';
 const BUILTIN_GLOBAL_SCOPE = 'builtin:global';
@@ -573,12 +574,16 @@ class BaseStrategyRegistry {
                 scopeKey: (_this_reflector_get = this.reflector.get(ORGANIZATION_METADATA_KEY, target)) != null ? _this_reflector_get : BUILTIN_GLOBAL_SCOPE
             };
         }
+        const pluginVersion = this.reflector.get(PLUGIN_VERSION_METADATA_KEY, target);
         var _this_reflector_get1;
-        return {
+        return _extends({
             kind: 'plugin',
-            pluginName,
+            pluginName
+        }, pluginVersion ? {
+            pluginVersion
+        } : {}, {
             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.
@@ -949,6 +954,10 @@ ToolsetRegistry = __decorate([
     ])
 ], ToolsetRegistry);
 
+function defineXpertTool(definition) {
+    return Object.freeze(definition);
+}
+
 /**
  * Restricted FileSystem based on granted permissions
  */ class XpFileSystem {
@@ -5734,4 +5743,44 @@ const EvolutionRuntimeCapability = createRuntimeCapability('platform.agent-evolu
     description: 'Ingest learning signals and resolve immutable capability versions for domain runtimes.'
 });
 
-export { ACCOUNT_BINDING_PERMISSION_SERVICE_TOKEN, AGENT_CHAT_DISPATCH_ERROR_STEER_TARGET_NOT_RUNNING, AGENT_CHAT_DISPATCH_MESSAGE_TYPE, AGENT_MIDDLEWARE_STRATEGY, AIModel, AIModelProviderNotFoundException, AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, AdapterDataSourceStrategy, AgentMiddlewareRegistry, AgentMiddlewareStrategy, AiModelNotFoundException, AssistantTaskRuntimeCapability, BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN, BUILTIN_GLOBAL_SCOPE, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, 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, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, EVOLUTION_RUNTIME_SERVICE_TOKEN, EVOLUTION_TARGET_PROVIDER, EvolutionRuntimeCapability, EvolutionTargetProviderRegistry, EvolutionTargetProviderStrategy, 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, ImageGenerationModel, ImageUnderstandingRegistry, ImageUnderstandingStrategy, IntegrationStrategyKey, IntegrationStrategyRegistry, JUMP_TO_TARGETS, JsonSchemaValidator, KNOWLEDGE_STRATEGY, KnowledgeStrategyKey, KnowledgeStrategyRegistry, LLMUsage, LargeLanguageModel, MANAGED_CONNECTION_REGISTRY_TOKEN, MANAGED_QUEUE_HANDLER_REGISTRY_TOKEN, MANAGED_QUEUE_SERVICE_TOKEN, MODEL_OUTPUT_VALIDATION_ERROR_CODE, ModelOutputValidationError, 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_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, 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, VIDEO_GENERATION_PERMISSION_SERVICE_TOKEN, VIDEO_GENERATION_SERVICE_TOKEN, VIDEO_GENERATOR_FAMILIES, VIEW_EXTENSION_CACHE_SERVICE_TOKEN, VIEW_EXTENSION_PROVIDER, VectorStoreRegistry, VectorStoreStrategy, VideoGenerationModel, ViewExtensionProvider, ViewExtensionProviderRegistry, WORKFLOW_NODE_STRATEGY, WORKFLOW_TRIGGER_STRATEGY, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, WrapWorkflowNodeExecutionCommand, XPERT_AGENT_MIDDLEWARE_RUNTIME_TOKEN, XpFileSystem, XpertServerPlugin, als, appendSandboxMessage, assertConnectorDefinition, buildSandboxTimeoutMessage, calcTokenUsage, calculateLLMUsagePrice, calculateModelPrice, calculateModelUsageCharge, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, createRuntimeCapability, defineAgentMessageType, defineChannelMessageType, derivePluginArtifactNamespace, downloadRemoteFile, formatSandboxTimeout, getDefaultTenantId, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, getTenantGlobalScopeKey, isDevelopmentSandboxRuntimeEnvironment, isModelOutputValidationError, isModelUsagePricingConfig, isRemoteFile, isSandboxBackend, isSandboxManagedServiceAdapter, isSandboxServiceProxyAdapter, isSandboxTerminalAdapter, isStrategyInstance, isStructuredMessageType, isTenantGlobalScopeKey, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, pluginArtifactTableName, processAsyncAIGCManagedJob, renderRemoteModuleIframeHtml, renderRemoteReactIframeHtml, renderRemoteVueIframeHtml, resolveModelUsagePricingSnapshot, resolveSandboxBackend, resolveSandboxExecutionOptions, resolveSandboxManagedServiceAdapter, resolveSandboxServiceProxyAdapter, resolveSandboxTerminalAdapter, resolveStrategyMetadataTarget, resolveTenantGlobalScopeKey, resolveTokenUsage, runWithRequestContext, secondsToMilliseconds, setDefaultTenantId, sumTokenUsage };
+function defineMcpApp(definition) {
+    return Object.freeze(definition);
+}
+
+const MCP_CAPABILITY_CHANGE_EVENT_TYPES = [
+    'tools.changed',
+    'resources.changed',
+    'resource.updated',
+    'prompts.changed',
+    'task.updated'
+];
+
+function defineMcpPrompt(definition) {
+    return Object.freeze(definition);
+}
+
+function defineMcpResource(definition) {
+    return Object.freeze(definition);
+}
+
+function defineMcpResourceTemplate(definition) {
+    return Object.freeze(definition);
+}
+
+function defineMcpCapabilities(definitions) {
+    return Object.freeze({
+        instructions: definitions.instructions,
+        tools: freezeItems(definitions.tools),
+        resources: freezeItems(definitions.resources),
+        resourceTemplates: freezeItems(definitions.resourceTemplates),
+        prompts: freezeItems(definitions.prompts),
+        apps: freezeItems(definitions.apps)
+    });
+}
+function freezeItems(items) {
+    return items ? Object.freeze([
+        ...items
+    ]) : undefined;
+}
+
+export { ACCOUNT_BINDING_PERMISSION_SERVICE_TOKEN, AGENT_CHAT_DISPATCH_ERROR_STEER_TARGET_NOT_RUNNING, AGENT_CHAT_DISPATCH_MESSAGE_TYPE, AGENT_MIDDLEWARE_STRATEGY, AIModel, AIModelProviderNotFoundException, AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, AdapterDataSourceStrategy, AgentMiddlewareRegistry, AgentMiddlewareStrategy, AiModelNotFoundException, AssistantTaskRuntimeCapability, BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN, BUILTIN_GLOBAL_SCOPE, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, 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, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, EVOLUTION_RUNTIME_SERVICE_TOKEN, EVOLUTION_TARGET_PROVIDER, EvolutionRuntimeCapability, EvolutionTargetProviderRegistry, EvolutionTargetProviderStrategy, 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, ImageGenerationModel, ImageUnderstandingRegistry, ImageUnderstandingStrategy, IntegrationStrategyKey, IntegrationStrategyRegistry, JUMP_TO_TARGETS, JsonSchemaValidator, KNOWLEDGE_STRATEGY, KnowledgeStrategyKey, KnowledgeStrategyRegistry, LLMUsage, LargeLanguageModel, MANAGED_CONNECTION_REGISTRY_TOKEN, MANAGED_QUEUE_HANDLER_REGISTRY_TOKEN, MANAGED_QUEUE_SERVICE_TOKEN, MCP_CAPABILITY_CHANGE_EVENT_TYPES, MODEL_OUTPUT_VALIDATION_ERROR_CODE, ModelOutputValidationError, ModelProvider, ORGANIZATION_METADATA_KEY, OpenAICompatibleReranker, PERMISSION_OPERATION_METADATA_KEY, PLUGIN_CONFIG_RESOLVER_TOKEN, PLUGIN_JOB_PROCESSOR_METADATA, PLUGIN_METADATA, PLUGIN_METADATA_KEY, PLUGIN_VERSION_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_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, 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, VIDEO_GENERATION_PERMISSION_SERVICE_TOKEN, VIDEO_GENERATION_SERVICE_TOKEN, VIDEO_GENERATOR_FAMILIES, VIEW_EXTENSION_CACHE_SERVICE_TOKEN, VIEW_EXTENSION_PROVIDER, VectorStoreRegistry, VectorStoreStrategy, VideoGenerationModel, ViewExtensionProvider, ViewExtensionProviderRegistry, WORKFLOW_NODE_STRATEGY, WORKFLOW_TRIGGER_STRATEGY, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, WrapWorkflowNodeExecutionCommand, XPERT_AGENT_MIDDLEWARE_RUNTIME_TOKEN, XpFileSystem, XpertServerPlugin, als, appendSandboxMessage, assertConnectorDefinition, buildSandboxTimeoutMessage, calcTokenUsage, calculateLLMUsagePrice, calculateModelPrice, calculateModelUsageCharge, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, createRuntimeCapability, defineAgentMessageType, defineChannelMessageType, defineMcpApp, defineMcpCapabilities, defineMcpPrompt, defineMcpResource, defineMcpResourceTemplate, defineXpertTool, derivePluginArtifactNamespace, downloadRemoteFile, formatSandboxTimeout, getDefaultTenantId, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, getTenantGlobalScopeKey, isDevelopmentSandboxRuntimeEnvironment, isModelOutputValidationError, isModelUsagePricingConfig, isRemoteFile, isSandboxBackend, isSandboxManagedServiceAdapter, isSandboxServiceProxyAdapter, isSandboxTerminalAdapter, isStrategyInstance, isStructuredMessageType, isTenantGlobalScopeKey, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, pluginArtifactTableName, processAsyncAIGCManagedJob, renderRemoteModuleIframeHtml, renderRemoteReactIframeHtml, renderRemoteVueIframeHtml, resolveModelUsagePricingSnapshot, resolveSandboxBackend, resolveSandboxExecutionOptions, resolveSandboxManagedServiceAdapter, resolveSandboxServiceProxyAdapter, resolveSandboxTerminalAdapter, resolveStrategyMetadataTarget, resolveTenantGlobalScopeKey, resolveTokenUsage, runWithRequestContext, secondsToMilliseconds, setDefaultTenantId, sumTokenUsage };

package/model-provider-toolset.cjs.js

@@ -5,7 +5,7 @@ require('@xpert-ai/contracts');
 require('./_extends.cjs.js');
 require('@nestjs/common');
 require('@langchain/core/tools');
-require('zod');
+require('zod/v3');
 
 
 

package/model-provider-toolset.esm.js

@@ -3,4 +3,4 @@ import '@xpert-ai/contracts';
 import './_extends.esm.js';
 import '@nestjs/common';
 import '@langchain/core/tools';
-import 'zod';
+import 'zod/v3';

package/model-provider.cjs.js

@@ -4,7 +4,7 @@ var contracts = require('@xpert-ai/contracts');
 var _extends = require('./_extends.cjs.js');
 var common = require('@nestjs/common');
 var tools = require('@langchain/core/tools');
-var zod = require('zod');
+var v3 = require('zod/v3');
 
 /**
  * Base ability for all toolsets
@@ -45,8 +45,8 @@ var zod = require('zod');
 class BaseTool extends tools.StructuredTool {
     constructor(...args){
         super(...args);
-        this.schema = zod.z.object({
-            input: zod.z.string().optional()
+        this.schema = v3.z.object({
+            input: v3.z.string().optional()
         }).transform((obj)=>obj.input);
     }
 }
@@ -98,6 +98,17 @@ class BuiltinToolset extends BaseToolset {
         var _this_toolset;
         return (_this_toolset = this.toolset) == null ? void 0 : _this_toolset.credentials;
     }
+    getMcpCapabilityDefinitions() {
+        return this.mcpCapabilities;
+    }
+    getMcpCapabilitySource() {
+        var _this_params, _this_params1;
+        return _extends._extends({}, ((_this_params = this.params) == null ? void 0 : _this_params.pluginName) ? {
+            pluginName: this.params.pluginName
+        } : {}, ((_this_params1 = this.params) == null ? void 0 : _this_params1.pluginVersion) ? {
+            pluginVersion: this.params.pluginVersion
+        } : {});
+    }
     getToolTitle(name) {
         var _this_toolset_tools, _this_toolset, _tool_schema;
         const tool = (_this_toolset = this.toolset) == null ? void 0 : (_this_toolset_tools = _this_toolset.tools) == null ? void 0 : _this_toolset_tools.find((tool)=>tool.name === name);
@@ -128,6 +139,7 @@ class BuiltinToolset extends BaseToolset {
     constructor(providerName, toolset, params){
         super(params);
         this.logger = new common.Logger(this.constructor.name);
+        this.mcpCapabilities = {};
         this.providerName = providerName;
         this.toolset = toolset;
         this.params = params;

package/model-provider.esm.js

@@ -2,7 +2,7 @@ import { AiModelTypeEnum } from '@xpert-ai/contracts';
 import { _ as _extends } from './_extends.esm.js';
 import { Logger } from '@nestjs/common';
 import { BaseToolkit, StructuredTool } from '@langchain/core/tools';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 
 /**
  * Base ability for all toolsets
@@ -96,6 +96,17 @@ class BuiltinToolset extends BaseToolset {
         var _this_toolset;
         return (_this_toolset = this.toolset) == null ? void 0 : _this_toolset.credentials;
     }
+    getMcpCapabilityDefinitions() {
+        return this.mcpCapabilities;
+    }
+    getMcpCapabilitySource() {
+        var _this_params, _this_params1;
+        return _extends({}, ((_this_params = this.params) == null ? void 0 : _this_params.pluginName) ? {
+            pluginName: this.params.pluginName
+        } : {}, ((_this_params1 = this.params) == null ? void 0 : _this_params1.pluginVersion) ? {
+            pluginVersion: this.params.pluginVersion
+        } : {});
+    }
     getToolTitle(name) {
         var _this_toolset_tools, _this_toolset, _tool_schema;
         const tool = (_this_toolset = this.toolset) == null ? void 0 : (_this_toolset_tools = _this_toolset.tools) == null ? void 0 : _this_toolset_tools.find((tool)=>tool.name === name);
@@ -126,6 +137,7 @@ class BuiltinToolset extends BaseToolset {
     constructor(providerName, toolset, params){
         super(params);
         this.logger = new Logger(this.constructor.name);
+        this.mcpCapabilities = {};
         this.providerName = providerName;
         this.toolset = toolset;
         this.params = params;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/plugin-sdk",
-  "version": "3.17.3",
+  "version": "3.17.5",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",
@@ -17,7 +17,7 @@
   },
   "dependencies": {
     "@langchain/openai": "0.6.9",
-    "@xpert-ai/contracts": "3.17.3",
+    "@xpert-ai/contracts": "3.17.5",
     "express": "^4.22.1",
     "js-tiktoken": "^1.0.21"
   },
@@ -35,7 +35,7 @@
     "passport-jwt": "*",
     "rxjs": "*",
     "yaml": "*",
-    "zod": "*"
+    "zod": "^3.25.0 || ^4.0.0"
   },
   "exports": {
     "./package.json": "./package.json",

package/src/index.d.ts

@@ -25,3 +25,4 @@ export * from './lib/managed-queue/index';
 export * from './lib/view-extension/index';
 export * from './lib/collaboration/index';
 export * from './lib/evolution/index';
+export * from './lib/mcp/index';

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

@@ -12,6 +12,17 @@ export type AgentMiddlewareAssistantTaskFile = {
     size?: number;
     role?: string;
 };
+/**
+ * Stable plugin skill reference used by Assistant Tasks.
+ *
+ * Plugin-owned callers must not persist workspace-local SkillPackage UUIDs.
+ * The host resolves this portable identity to the installed package and verifies
+ * that the target Agent is directly connected to the owning Skills Middleware.
+ */
+export type AgentMiddlewareAssistantTaskSkillRef = {
+    pluginName: string;
+    componentKey: string;
+};
 export type AgentMiddlewareAssistantTaskInput = {
     xpertId: string;
     agentKey?: string;
@@ -22,6 +33,8 @@ export type AgentMiddlewareAssistantTaskInput = {
     clientMessageId?: string;
     prompt: string;
     files?: AgentMiddlewareAssistantTaskFile[];
+    /** Skills that this task is expected to load through its target Agent's Skills Middleware. */
+    selectedSkillRefs?: AgentMiddlewareAssistantTaskSkillRef[];
     /** Additional bounded human-input fields exposed to runtime-state fixed filters. */
     humanInput?: Record<string, JSONValue>;
     context?: Record<string, unknown>;

package/src/lib/mcp/app.d.ts

@@ -0,0 +1,19 @@
+export interface McpAppCsp {
+    connectDomains?: string[];
+    resourceDomains?: string[];
+}
+export interface McpAppPermissions {
+    clipboardWrite?: boolean;
+    camera?: boolean;
+    microphone?: boolean;
+    geolocation?: boolean;
+}
+export interface McpAppDefinition {
+    key: string;
+    entry: string;
+    title?: string;
+    description?: string;
+    csp?: McpAppCsp;
+    permissions?: McpAppPermissions;
+}
+export declare function defineMcpApp(definition: McpAppDefinition): Readonly<McpAppDefinition>;

package/src/lib/mcp/completion.d.ts

@@ -0,0 +1,11 @@
+import type { ToolExecutionContext } from '../toolset/tool-execution-context';
+export interface McpCompletionRequest {
+    argument: string;
+    value: string;
+}
+export interface McpCompletionResult {
+    values: string[];
+    total?: number;
+    hasMore?: boolean;
+}
+export type McpCompletionHandler = (request: McpCompletionRequest, context: ToolExecutionContext) => McpCompletionResult | Promise<McpCompletionResult>;

package/src/lib/mcp/events.d.ts

@@ -0,0 +1,10 @@
+export declare const MCP_CAPABILITY_CHANGE_EVENT_TYPES: readonly ["tools.changed", "resources.changed", "resource.updated", "prompts.changed", "task.updated"];
+export type CapabilityChangeEventType = (typeof MCP_CAPABILITY_CHANGE_EVENT_TYPES)[number];
+export interface CapabilityChangeEvent {
+    type: CapabilityChangeEventType;
+    key?: string;
+    taskId?: string;
+}
+export interface ToolEventsApi {
+    emit(event: CapabilityChangeEvent): Promise<void> | void;
+}

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

@@ -0,0 +1,8 @@
+export * from './app';
+export * from './completion';
+export * from './events';
+export * from './prompt';
+export * from './resource';
+export * from './resource-template';
+export * from './runtime';
+export * from './task';

package/src/lib/mcp/prompt.d.ts

@@ -0,0 +1,45 @@
+import type { McpRequiredContext } from '@xpert-ai/contracts';
+import type { ToolExecutionContext } from '../toolset/tool-execution-context';
+import type { McpCompletionHandler } from './completion';
+export interface McpPromptArgument {
+    required: boolean;
+    description?: string;
+}
+export type McpPromptContent = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    data: string;
+    mimeType: string;
+} | {
+    type: 'audio';
+    data: string;
+    mimeType: string;
+} | {
+    type: 'resource';
+    uri: string;
+    mimeType?: string;
+    text?: string;
+    blob?: string;
+};
+export interface McpPromptMessage {
+    role: 'user' | 'assistant';
+    content: McpPromptContent;
+}
+export interface McpPromptResult {
+    description?: string;
+    messages: McpPromptMessage[];
+}
+export interface McpPromptDefinition {
+    key: string;
+    name: string;
+    title?: string;
+    description?: string;
+    arguments?: Record<string, McpPromptArgument>;
+    requiredContext?: McpRequiredContext[];
+    supportsCompletion?: boolean;
+    get(arguments_: Record<string, string>, context: ToolExecutionContext): McpPromptResult | Promise<McpPromptResult>;
+    complete?: McpCompletionHandler;
+}
+export declare function defineMcpPrompt(definition: McpPromptDefinition): Readonly<McpPromptDefinition>;

package/src/lib/mcp/resource-template.d.ts

@@ -0,0 +1,21 @@
+import type { McpRequiredContext } from '@xpert-ai/contracts';
+import type { ToolExecutionContext } from '../toolset/tool-execution-context';
+import type { McpCompletionHandler } from './completion';
+import type { McpResourceReadResult } from './resource';
+export interface McpResourceTemplateArgument {
+    required: boolean;
+    description?: string;
+}
+export interface McpResourceTemplateDefinition {
+    key: string;
+    uriTemplate: string;
+    title?: string;
+    description?: string;
+    mimeType?: string;
+    arguments: Record<string, McpResourceTemplateArgument>;
+    requiredContext?: McpRequiredContext[];
+    cacheTtlMs?: number;
+    read(arguments_: Record<string, string>, context: ToolExecutionContext): McpResourceReadResult | Promise<McpResourceReadResult>;
+    complete?: McpCompletionHandler;
+}
+export declare function defineMcpResourceTemplate(definition: McpResourceTemplateDefinition): Readonly<McpResourceTemplateDefinition>;

package/src/lib/mcp/resource.d.ts

@@ -0,0 +1,23 @@
+import type { JSONValue, McpRequiredContext } from '@xpert-ai/contracts';
+import type { ToolExecutionContext } from '../toolset/tool-execution-context';
+export interface McpResourceContent {
+    uri: string;
+    mimeType?: string;
+    text?: string;
+    blob?: string;
+    meta?: Record<string, JSONValue>;
+}
+export interface McpResourceReadResult {
+    contents: McpResourceContent[];
+}
+export interface McpResourceDefinition {
+    key: string;
+    uri: string;
+    title?: string;
+    description?: string;
+    mimeType?: string;
+    requiredContext?: McpRequiredContext[];
+    cacheTtlMs?: number;
+    read(context: ToolExecutionContext): McpResourceReadResult | Promise<McpResourceReadResult>;
+}
+export declare function defineMcpResource(definition: McpResourceDefinition): Readonly<McpResourceDefinition>;

package/src/lib/mcp/runtime.d.ts

@@ -0,0 +1,23 @@
+import type { McpAppDefinition } from './app';
+import type { McpPromptDefinition } from './prompt';
+import type { McpResourceDefinition } from './resource';
+import type { McpResourceTemplateDefinition } from './resource-template';
+import type { AnyXpertToolDefinition } from '../toolset/define-tool';
+export interface McpCapabilityDefinitions {
+    /** Lower-priority server guidance merged after platform and Publication instructions. */
+    instructions?: string;
+    tools?: readonly AnyXpertToolDefinition[];
+    resources?: readonly McpResourceDefinition[];
+    resourceTemplates?: readonly McpResourceTemplateDefinition[];
+    prompts?: readonly McpPromptDefinition[];
+    apps?: readonly McpAppDefinition[];
+}
+/** Implemented by toolsets that provide host-executed MCP capabilities in addition to tools. */
+export interface McpCapabilityRuntimeProvider {
+    getMcpCapabilityDefinitions(): Readonly<McpCapabilityDefinitions>;
+    getMcpCapabilitySource?(): {
+        pluginName?: string;
+        pluginVersion?: string;
+    };
+}
+export declare function defineMcpCapabilities(definitions: McpCapabilityDefinitions): Readonly<McpCapabilityDefinitions>;

package/src/lib/mcp/task.d.ts

@@ -0,0 +1,24 @@
+import type { JSONValue } from '@xpert-ai/contracts';
+export interface McpTaskExecutionPolicy {
+    mode: 'optional' | 'required';
+    maxLifetimeMs?: number;
+}
+export interface ToolTaskCreateRequest {
+    capabilityKey: string;
+    requestId: string;
+    idempotencyKey: string;
+    input?: JSONValue;
+    expiresAt?: Date | string;
+}
+export interface ToolTaskHandle {
+    taskId: string;
+    status: 'working' | 'input_required' | 'completed' | 'failed' | 'cancelled';
+}
+export interface ToolTasksApi {
+    create(request: ToolTaskCreateRequest): Promise<ToolTaskHandle>;
+    update(taskId: string, patch: {
+        progress?: number;
+        status?: ToolTaskHandle['status'];
+    }): Promise<ToolTaskHandle>;
+    cancel(taskId: string): Promise<ToolTaskHandle>;
+}

package/src/lib/strategy.d.ts

@@ -7,6 +7,7 @@ export type StrategySource = {
 } | {
     kind: 'plugin';
     pluginName: string;
+    pluginVersion?: string;
     scopeKey: string;
 };
 export declare class BaseStrategyRegistry<S> implements OnModuleInit {

package/src/lib/toolset/builtin.d.ts

@@ -6,6 +6,7 @@ import { CommandBus, QueryBus } from '@nestjs/cqrs';
 import { BaseToolset } from './toolset';
 import type { AgentMiddlewareModelProviderConnection, AgentMiddlewareRuntimeApi } from '../agent/middleware/runtime';
 import type { ManagedQueueService } from '../managed-queue';
+import type { McpCapabilityDefinitions, McpCapabilityRuntimeProvider } from '../mcp';
 /**
  * The context params of creating toolset
  */
@@ -36,11 +37,14 @@ export type TBuiltinToolsetParams = TToolsetParams & {
     managedQueue?: ManagedQueueService;
     /** Installation scope used to route jobs back to this plugin instance. */
     pluginScopeKey?: string;
+    /** Package provenance used to resolve plugin-owned MCP App bundles. */
+    pluginName?: string;
+    pluginVersion?: string;
 };
 export interface IBuiltinToolset {
     validateCredentials(credentials: TToolCredentials): Promise<void>;
 }
-export declare abstract class BuiltinToolset<T extends StructuredToolInterface = StructuredToolInterface, C = TToolCredentials> extends BaseToolset<T> implements IBuiltinToolset {
+export declare abstract class BuiltinToolset<T extends StructuredToolInterface = StructuredToolInterface, C = TToolCredentials> extends BaseToolset<T> implements IBuiltinToolset, McpCapabilityRuntimeProvider {
     providerName: string;
     protected toolset?: IXpertToolset;
     protected params?: TBuiltinToolsetParams;
@@ -50,6 +54,7 @@ export declare abstract class BuiltinToolset<T extends StructuredToolInterface =
     credentialsSchema?: {
         [key: string]: ToolProviderCredentials;
     };
+    protected mcpCapabilities: McpCapabilityDefinitions;
     get tenantId(): string;
     get organizationId(): string;
     get commandBus(): CommandBus<import("@nestjs/cqrs").ICommand>;
@@ -63,6 +68,11 @@ export declare abstract class BuiltinToolset<T extends StructuredToolInterface =
     _validateCredentials(credentials: C): Promise<void>;
     getId(): string;
     getCredentials(): C;
+    getMcpCapabilityDefinitions(): Readonly<McpCapabilityDefinitions>;
+    getMcpCapabilitySource(): {
+        pluginVersion?: string;
+        pluginName?: string;
+    };
     getToolTitle(name: string): string | I18nObject;
     /**
      * Get credentials schema

package/src/lib/toolset/define-tool.d.ts

@@ -0,0 +1,33 @@
+import type { McpRequiredContext, McpToolBehavior } from '@xpert-ai/contracts';
+import type { ZodTypeAny, infer as ZodInfer } from 'zod/v3';
+import type { McpTaskExecutionPolicy } from '../mcp/task';
+import type { ToolExecutionContext } from './tool-execution-context';
+import type { XpertToolResult } from './tool-result';
+export type XpertToolVisibility = 'model' | 'app';
+export interface XpertToolExposure {
+    mcp: {
+        eligible: boolean;
+    };
+}
+export interface XpertToolAppBinding {
+    resourceKey: string;
+}
+type StructuredOutput<TSchema extends ZodTypeAny | undefined> = TSchema extends ZodTypeAny ? ZodInfer<TSchema> : unknown;
+export interface XpertToolDefinition<TInputSchema extends ZodTypeAny, TOutputSchema extends ZodTypeAny | undefined = undefined> {
+    name: string;
+    title?: string;
+    description: string;
+    inputSchema: TInputSchema;
+    outputSchema?: TOutputSchema;
+    exposure: XpertToolExposure;
+    behavior: McpToolBehavior;
+    requiredContext: McpRequiredContext[];
+    visibility?: XpertToolVisibility[];
+    app?: XpertToolAppBinding;
+    task?: McpTaskExecutionPolicy;
+    execute(input: ZodInfer<TInputSchema>, context: ToolExecutionContext): XpertToolResult<StructuredOutput<TOutputSchema>> | Promise<XpertToolResult<StructuredOutput<TOutputSchema>>>;
+}
+/** Runtime-erased form used when a toolset exposes heterogeneous declared tools. */
+export type AnyXpertToolDefinition = XpertToolDefinition<ZodTypeAny, ZodTypeAny | undefined>;
+export declare function defineXpertTool<TInputSchema extends ZodTypeAny, TOutputSchema extends ZodTypeAny | undefined = undefined>(definition: XpertToolDefinition<TInputSchema, TOutputSchema>): Readonly<XpertToolDefinition<TInputSchema, TOutputSchema>>;
+export {};

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

@@ -4,3 +4,6 @@ export * from './strategy.registry';
 export * from './builtin';
 export * from './model-provider';
 export * from './toolset';
+export * from './define-tool';
+export * from './tool-execution-context';
+export * from './tool-result';

package/src/lib/toolset/strategy.interface.d.ts

@@ -1,6 +1,6 @@
 import { DynamicStructuredTool } from '@langchain/core/tools';
 import { I18nObject, IconDefinition } from '@xpert-ai/contracts';
-import { ZodSchema } from 'zod';
+import type { ZodSchema } from 'zod/v3';
 import { BuiltinToolset, TBuiltinToolsetParams } from './builtin';
 import type { VideoGenerationToolsetCapability } from '../core/permissions/video-generation';
 export interface IToolsetStrategy<TConfig = any> {

package/src/lib/toolset/tool-execution-context.d.ts

@@ -0,0 +1,56 @@
+import type { JSONValue, McpJsonSchema } from '@xpert-ai/contracts';
+import type { AgentMiddlewareRuntimeApi } from '../agent/middleware/runtime';
+import type { WorkspaceFilesApi } from '../runtime/capabilities/workspace-files';
+import type { CapabilityChangeEvent, ToolEventsApi } from '../mcp/events';
+import type { ToolTasksApi } from '../mcp/task';
+export type ToolExecutionSource = 'agent' | 'mcp' | 'workflow' | 'api';
+export interface ToolPrincipal {
+    type: 'user' | 'service_account';
+    id: string;
+    userId?: string;
+    clientId?: string;
+}
+export interface ToolCredentialsApi {
+    get<TValue extends JSONValue = JSONValue>(key: string): Promise<TValue | null>;
+}
+export type ToolModelsApi = Pick<AgentMiddlewareRuntimeApi, 'createModelClient' | 'getModelProvider'>;
+export interface ToolInputFormRequest {
+    type: 'form';
+    title: string;
+    schema: McpJsonSchema;
+}
+export interface ToolInputUrlRequest {
+    type: 'url';
+    url: string;
+    title?: string;
+}
+export type ToolInputRequest = ToolInputFormRequest | ToolInputUrlRequest;
+export interface ToolInputApi {
+    request<TValue extends JSONValue = JSONValue>(request: ToolInputRequest): Promise<TValue>;
+}
+export interface ToolHostApi {
+    files?: WorkspaceFilesApi;
+    credentials?: ToolCredentialsApi;
+    models?: ToolModelsApi;
+    tasks?: ToolTasksApi;
+    events?: ToolEventsApi;
+    input?: ToolInputApi;
+}
+export interface ToolExecutionContext {
+    source: ToolExecutionSource;
+    tenantId: string;
+    organizationId?: string;
+    /** Present only when the caller deliberately supplied a workspace-scoped execution boundary. */
+    workspaceId?: string;
+    projectId?: string;
+    principal: ToolPrincipal;
+    executionId: string;
+    requestId: string;
+    traceId?: string;
+    conversationId?: string;
+    xpertId?: string;
+    agentKey?: string;
+    signal?: AbortSignal;
+    host: ToolHostApi;
+}
+export type { CapabilityChangeEvent };

package/src/lib/toolset/tool-result.d.ts

@@ -0,0 +1,23 @@
+import type { JSONValue } from '@xpert-ai/contracts';
+export type XpertToolContent = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    data: string;
+    mimeType: string;
+} | {
+    type: 'audio';
+    data: string;
+    mimeType: string;
+} | {
+    type: 'resource_link';
+    uri: string;
+    name?: string;
+};
+export interface XpertToolResult<TStructuredContent = unknown> {
+    content?: XpertToolContent[];
+    structuredContent?: TStructuredContent;
+    meta?: Record<string, JSONValue>;
+    isError?: boolean;
+}

package/src/lib/toolset/toolset.d.ts

@@ -1,6 +1,6 @@
 import { BaseToolkit, StructuredTool, StructuredToolInterface } from "@langchain/core/tools";
 import { I18nObject, TStateVariable, TToolsetParams } from "@xpert-ai/contracts";
-import { z } from 'zod';
+import { z } from 'zod/v3';
 type ZodObjectAny = z.ZodObject<any, any, any, any>;
 /**
  * Base ability for all toolsets

package/src/lib/types.d.ts

@@ -1,10 +1,11 @@
 import { IconDefinition, I18nObject, JsonSchemaObjectType, PluginMeta, PluginTargetApp, PluginTargetAppMeta, TAvatar, type TPromptWorkflow, XpertTemplatePluginDependencies, XpertTypeEnum } from '@xpert-ai/contracts';
 import type { DynamicModule, INestApplicationContext } from '@nestjs/common';
 import { ModuleRef } from '@nestjs/core';
-import type { ZodSchema } from 'zod';
+import type { ZodSchema } from 'zod/v3';
 import type { Permissions } from './core/permissions';
 export declare const ORGANIZATION_METADATA_KEY = "xpert:organizationId";
 export declare const PLUGIN_METADATA_KEY = "xpert:pluginName";
+export declare const PLUGIN_VERSION_METADATA_KEY = "xpert:pluginVersion";
 export declare const GLOBAL_ORGANIZATION_SCOPE = "global";
 export declare const SYSTEM_GLOBAL_SCOPE = "system:global";
 export declare const BUILTIN_GLOBAL_SCOPE = "builtin:global";