@xpert-ai/plugin-sdk 3.15.5 → 3.15.7

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @xpert-ai/plugin-sdk
 
+## 3.15.7
+
+### Patch Changes
+
+- 5e553ae: Add connector strategy contracts and runtime capability helpers for workspace connector plugins.
+
+## 3.15.6
+
+### Patch Changes
+
+- 3249145: plugin artifact namespace
+- Updated dependencies [3249145]
+  - @xpert-ai/contracts@3.15.7
+
 ## 3.15.5
 
 ### Patch Changes

package/index.cjs.js

@@ -88,6 +88,34 @@ var _axios__namespace = /*#__PURE__*/_interopNamespaceDefault(_axios);
     };
 }
 
+const ARTIFACT_NAMESPACE_PATTERN = /^[a-z0-9_]+$/;
+function normalizeArtifactSegment(value) {
+    return value.trim().replace(/^@[^/]+\//, '').replace(/^plugin[-_]/, '').replace(/([a-z0-9])([A-Z])/g, '$1_$2').replace(/[^A-Za-z0-9]+/g, '_').replace(/_+/g, '_').replace(/^_+|_+$/g, '').toLowerCase();
+}
+/**
+ * Derive the v1 default artifact namespace from an npm package name.
+ * Explicit `artifactNamespace` should stay stable after publish; this fallback is for compatibility.
+ */ function derivePluginArtifactNamespace(packageName) {
+    const namespace = normalizeArtifactSegment(packageName);
+    assertPluginArtifactNamePart(namespace, 'artifact namespace');
+    return namespace;
+}
+/**
+ * Build the physical table name for a plugin-owned database table.
+ * Keep table keys stable; the returned name is part of the plugin data contract.
+ */ function pluginArtifactTableName(namespace, tableKey) {
+    const normalizedNamespace = namespace.trim();
+    const normalizedTableKey = tableKey.trim();
+    assertPluginArtifactNamePart(normalizedNamespace, 'artifact namespace');
+    assertPluginArtifactNamePart(normalizedTableKey, 'artifact table key');
+    return `plugin_${normalizedNamespace}_${normalizedTableKey}`;
+}
+function assertPluginArtifactNamePart(value, label) {
+    if (!value || !ARTIFACT_NAMESPACE_PATTERN.test(value)) {
+        throw new Error(`${label} must contain only lowercase letters, numbers, and underscores`);
+    }
+}
+
 const ORGANIZATION_METADATA_KEY = 'xpert:organizationId';
 const PLUGIN_METADATA_KEY = 'xpert:pluginName';
 const GLOBAL_ORGANIZATION_SCOPE = 'global';
@@ -3092,6 +3120,26 @@ exports.SSOProviderRegistry = __decorate([
     ])
 ], exports.SSOProviderRegistry);
 
+const ConnectorRuntimeCapability = createRuntimeCapability('platform.connector', {
+    description: 'Resolve workspace connector credentials for agent middleware.'
+});
+
+const CONNECTOR_STRATEGY = 'CONNECTOR_STRATEGY';
+const ConnectorStrategyKey = (provider)=>common.applyDecorators(common.SetMetadata(CONNECTOR_STRATEGY, provider), common.SetMetadata(STRATEGY_META_KEY, CONNECTOR_STRATEGY));
+
+exports.ConnectorStrategyRegistry = class ConnectorStrategyRegistry extends BaseStrategyRegistry {
+    constructor(discoveryService, reflector){
+        super(CONNECTOR_STRATEGY, discoveryService, reflector);
+    }
+};
+exports.ConnectorStrategyRegistry = __decorate([
+    common.Injectable(),
+    __metadata("design:paramtypes", [
+        core.DiscoveryService,
+        core.Reflector
+    ])
+], exports.ConnectorStrategyRegistry);
+
 const SANDBOX_SHELL_TIMEOUT_LIMITS_SEC = {
     min: 1,
     max: 3600
@@ -4640,10 +4688,13 @@ exports.BuiltinToolset = BuiltinToolset;
 exports.CHAT_CHANNEL = CHAT_CHANNEL;
 exports.CHAT_CHANNEL_TEXT_LIMITS = CHAT_CHANNEL_TEXT_LIMITS;
 exports.CONNECTION_COMMAND_ROUTER_TOKEN = CONNECTION_COMMAND_ROUTER_TOKEN;
+exports.CONNECTOR_STRATEGY = CONNECTOR_STRATEGY;
 exports.CancelConversationCommand = CancelConversationCommand;
 exports.ChatChannel = ChatChannel;
 exports.ChatOAICompatReasoningModel = ChatOAICompatReasoningModel;
 exports.CommonParameterRules = CommonParameterRules;
+exports.ConnectorRuntimeCapability = ConnectorRuntimeCapability;
+exports.ConnectorStrategyKey = ConnectorStrategyKey;
 exports.CreateModelClientCommand = CreateModelClientCommand;
 exports.CredentialsValidateFailedError = CredentialsValidateFailedError;
 exports.DATASOURCE_STRATEGY = DATASOURCE_STRATEGY;
@@ -4762,6 +4813,7 @@ exports.createPluginLogger = createPluginLogger;
 exports.createRuntimeCapability = createRuntimeCapability;
 exports.defineAgentMessageType = defineAgentMessageType;
 exports.defineChannelMessageType = defineChannelMessageType;
+exports.derivePluginArtifactNamespace = derivePluginArtifactNamespace;
 exports.downloadRemoteFile = downloadRemoteFile;
 exports.formatSandboxTimeout = formatSandboxTimeout;
 exports.getDefaultTenantId = getDefaultTenantId;
@@ -4784,6 +4836,7 @@ exports.loadYamlFile = loadYamlFile;
 exports.mergeCredentials = mergeCredentials;
 exports.mergeParentChildChunks = mergeParentChildChunks;
 exports.normalizeContextSize = normalizeContextSize;
+exports.pluginArtifactTableName = pluginArtifactTableName;
 exports.renderRemoteReactIframeHtml = renderRemoteReactIframeHtml;
 exports.resolveSandboxBackend = resolveSandboxBackend;
 exports.resolveSandboxExecutionOptions = resolveSandboxExecutionOptions;

package/index.esm.js

@@ -68,6 +68,34 @@ import { getModelContextSize as getModelContextSize$1 } from '@langchain/core/la
     };
 }
 
+const ARTIFACT_NAMESPACE_PATTERN = /^[a-z0-9_]+$/;
+function normalizeArtifactSegment(value) {
+    return value.trim().replace(/^@[^/]+\//, '').replace(/^plugin[-_]/, '').replace(/([a-z0-9])([A-Z])/g, '$1_$2').replace(/[^A-Za-z0-9]+/g, '_').replace(/_+/g, '_').replace(/^_+|_+$/g, '').toLowerCase();
+}
+/**
+ * Derive the v1 default artifact namespace from an npm package name.
+ * Explicit `artifactNamespace` should stay stable after publish; this fallback is for compatibility.
+ */ function derivePluginArtifactNamespace(packageName) {
+    const namespace = normalizeArtifactSegment(packageName);
+    assertPluginArtifactNamePart(namespace, 'artifact namespace');
+    return namespace;
+}
+/**
+ * Build the physical table name for a plugin-owned database table.
+ * Keep table keys stable; the returned name is part of the plugin data contract.
+ */ function pluginArtifactTableName(namespace, tableKey) {
+    const normalizedNamespace = namespace.trim();
+    const normalizedTableKey = tableKey.trim();
+    assertPluginArtifactNamePart(normalizedNamespace, 'artifact namespace');
+    assertPluginArtifactNamePart(normalizedTableKey, 'artifact table key');
+    return `plugin_${normalizedNamespace}_${normalizedTableKey}`;
+}
+function assertPluginArtifactNamePart(value, label) {
+    if (!value || !ARTIFACT_NAMESPACE_PATTERN.test(value)) {
+        throw new Error(`${label} must contain only lowercase letters, numbers, and underscores`);
+    }
+}
+
 const ORGANIZATION_METADATA_KEY = 'xpert:organizationId';
 const PLUGIN_METADATA_KEY = 'xpert:pluginName';
 const GLOBAL_ORGANIZATION_SCOPE = 'global';
@@ -3072,6 +3100,26 @@ SSOProviderRegistry = __decorate([
     ])
 ], SSOProviderRegistry);
 
+const ConnectorRuntimeCapability = createRuntimeCapability('platform.connector', {
+    description: 'Resolve workspace connector credentials for agent middleware.'
+});
+
+const CONNECTOR_STRATEGY = 'CONNECTOR_STRATEGY';
+const ConnectorStrategyKey = (provider)=>applyDecorators(SetMetadata(CONNECTOR_STRATEGY, provider), SetMetadata(STRATEGY_META_KEY, CONNECTOR_STRATEGY));
+
+let ConnectorStrategyRegistry = class ConnectorStrategyRegistry extends BaseStrategyRegistry {
+    constructor(discoveryService, reflector){
+        super(CONNECTOR_STRATEGY, discoveryService, reflector);
+    }
+};
+ConnectorStrategyRegistry = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [
+        DiscoveryService,
+        Reflector
+    ])
+], ConnectorStrategyRegistry);
+
 const SANDBOX_SHELL_TIMEOUT_LIMITS_SEC = {
     min: 1,
     max: 3600
@@ -4588,4 +4636,4 @@ function escapeHtmlAttribute(value) {
 
 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, AssistantTaskRuntimeCapability, BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN, BUILTIN_GLOBAL_SCOPE, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, BaseTool, BaseToolset, BuiltinToolset, CHAT_CHANNEL, CHAT_CHANNEL_TEXT_LIMITS, CONNECTION_COMMAND_ROUTER_TOKEN, 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, 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_PROVIDER, SANDBOX_SHELL_TIMEOUT_LIMITS_SEC, 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, 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, buildSandboxTimeoutMessage, calcTokenUsage, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, createRuntimeCapability, defineAgentMessageType, defineChannelMessageType, downloadRemoteFile, formatSandboxTimeout, getDefaultTenantId, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, getTenantGlobalScopeKey, isRemoteFile, isSandboxBackend, isSandboxManagedServiceAdapter, isSandboxServiceProxyAdapter, isSandboxTerminalAdapter, isStructuredMessageType, isTenantGlobalScopeKey, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, renderRemoteReactIframeHtml, resolveSandboxBackend, resolveSandboxExecutionOptions, resolveSandboxManagedServiceAdapter, resolveSandboxServiceProxyAdapter, resolveSandboxTerminalAdapter, resolveTenantGlobalScopeKey, runWithRequestContext, secondsToMilliseconds, setDefaultTenantId, 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, AssistantTaskRuntimeCapability, BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN, BUILTIN_GLOBAL_SCOPE, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, BaseTool, BaseToolset, BuiltinToolset, CHAT_CHANNEL, CHAT_CHANNEL_TEXT_LIMITS, CONNECTION_COMMAND_ROUTER_TOKEN, CONNECTOR_STRATEGY, CancelConversationCommand, ChatChannel, ChatChannelRegistry, ChatOAICompatReasoningModel, 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_PROVIDER, SANDBOX_SHELL_TIMEOUT_LIMITS_SEC, 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, 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, buildSandboxTimeoutMessage, calcTokenUsage, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, createRuntimeCapability, defineAgentMessageType, defineChannelMessageType, derivePluginArtifactNamespace, downloadRemoteFile, formatSandboxTimeout, getDefaultTenantId, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, getTenantGlobalScopeKey, isRemoteFile, isSandboxBackend, isSandboxManagedServiceAdapter, isSandboxServiceProxyAdapter, isSandboxTerminalAdapter, isStructuredMessageType, isTenantGlobalScopeKey, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, pluginArtifactTableName, renderRemoteReactIframeHtml, resolveSandboxBackend, resolveSandboxExecutionOptions, resolveSandboxManagedServiceAdapter, resolveSandboxServiceProxyAdapter, resolveSandboxTerminalAdapter, resolveTenantGlobalScopeKey, runWithRequestContext, secondsToMilliseconds, setDefaultTenantId, sumTokenUsage };

package/package.json

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

package/src/index.d.ts

@@ -1,6 +1,7 @@
 export * from './lib/plugin';
 export * from './lib/plugin.interface';
 export * from './lib/plugin-metadata';
+export * from './lib/artifact-namespace';
 export * from './lib/types';
 export * from './lib/logger';
 export * from './lib/integration/index';
@@ -17,6 +18,7 @@ export * from './lib/channel/index';
 export * from './lib/file/index';
 export * from './lib/strategy';
 export * from './lib/sso/index';
+export * from './lib/connector/index';
 export * from './lib/sandbox/index';
 export * from './lib/managed-connection/index';
 export * from './lib/managed-queue/index';

package/src/lib/artifact-namespace.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Derive the v1 default artifact namespace from an npm package name.
+ * Explicit `artifactNamespace` should stay stable after publish; this fallback is for compatibility.
+ */
+export declare function derivePluginArtifactNamespace(packageName: string): string;
+/**
+ * Build the physical table name for a plugin-owned database table.
+ * Keep table keys stable; the returned name is part of the plugin data contract.
+ */
+export declare function pluginArtifactTableName(namespace: string, tableKey: string): string;

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

@@ -0,0 +1,4 @@
+export * from './runtime-capability';
+export * from './strategy.decorator';
+export * from './strategy.interface';
+export * from './strategy.registry';

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

@@ -0,0 +1,2 @@
+import type { ConnectorRuntimeApi } from './strategy.interface';
+export declare const ConnectorRuntimeCapability: import("../core").RuntimeCapabilityKey<ConnectorRuntimeApi>;

package/src/lib/connector/strategy.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare const CONNECTOR_STRATEGY = "CONNECTOR_STRATEGY";
+export declare const ConnectorStrategyKey: (provider: string) => <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

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

@@ -0,0 +1,207 @@
+import type { I18nText, IconDefinition } from '@xpert-ai/contracts';
+export type RuntimeI18nText = I18nText;
+export type RuntimeCapabilityIcon = IconDefinition;
+export type ConnectorStatus = 'pending' | 'active' | 'expired' | 'error' | 'disconnected';
+export type ConnectorOAuthConfig = {
+    type: 'oauth2';
+    authorizationUrl?: string;
+    tokenUrl?: string;
+    userInfoUrl?: string;
+    scopes?: string[];
+    redirectPath?: string;
+};
+export type ConnectorAppCredentialField = {
+    name: string;
+    label: RuntimeI18nText;
+    type?: 'text' | 'password';
+    required?: boolean;
+    placeholder?: RuntimeI18nText;
+    description?: RuntimeI18nText;
+    secret?: boolean;
+};
+export type ConnectorAppCredentialsConfig = {
+    integrationLabel?: RuntimeI18nText;
+    noIntegrationLabel?: RuntimeI18nText;
+    noIntegrationDescription?: RuntimeI18nText;
+    fields?: ConnectorAppCredentialField[];
+    help?: {
+        label: RuntimeI18nText;
+        url: string;
+    };
+    defaultValues?: Record<string, string | number | boolean | null>;
+    integrationName?: RuntimeI18nText;
+};
+export type ConnectorAppIntegration = {
+    id?: string;
+    provider: string;
+    name?: string;
+    description?: string | null;
+    options?: unknown;
+};
+export type ConnectorAppIntegrationSelectOption = {
+    value: string;
+    label: string;
+    description?: string | null;
+};
+export type ConnectorPermissionDeclaration = {
+    key: string;
+    label?: RuntimeI18nText;
+    description?: RuntimeI18nText;
+    identity?: 'user' | 'app' | 'tenant';
+    scopes?: string[];
+    credential?: 'access_token' | 'refresh_token' | 'app_credential' | 'api_key';
+    storage?: 'platform_vault' | 'runtime_only' | 'external';
+    required?: boolean;
+};
+export type ConnectorDefinition = {
+    provider: string;
+    label: RuntimeI18nText;
+    description?: RuntimeI18nText;
+    icon?: RuntimeCapabilityIcon;
+    auth: ConnectorOAuthConfig;
+    permissions?: ConnectorPermissionDeclaration[];
+    appIntegrationProvider?: string;
+    appIntegrationOptional?: boolean;
+    appCredentials?: ConnectorAppCredentialsConfig;
+};
+export type ConnectorProfile = {
+    openId?: string;
+    unionId?: string;
+    userId?: string;
+    name?: string;
+    avatarUrl?: string;
+    email?: string;
+    [key: string]: unknown;
+};
+export type ConnectorInstance = {
+    id: string;
+    workspaceId: string;
+    provider: string;
+    status: ConnectorStatus;
+    appIntegrationId?: string | null;
+    profile?: ConnectorProfile | null;
+    scopes?: string[];
+    expiresAt?: string | null;
+    refreshExpiresAt?: string | null;
+    connectedAt?: string | null;
+    disconnectedAt?: string | null;
+    lastError?: string | null;
+    createdById?: string | null;
+    updatedById?: string | null;
+    createdAt?: string;
+    updatedAt?: string;
+};
+export type ConnectorOAuthStartRequest = {
+    appIntegrationId?: string;
+    app?: ConnectorAppCredentialPayload;
+};
+export type ConnectorOAuthStartResponse = {
+    connector: ConnectorInstance;
+    authorizationUrl: string;
+    stateExpiresAt: string;
+    pollIntervalSeconds?: number | null;
+};
+export type ConnectorOAuthStatusResponse = {
+    connector: ConnectorInstance;
+    authorizationUrl?: string | null;
+    stateExpiresAt?: string | null;
+    pollIntervalSeconds?: number | null;
+    message?: string | null;
+};
+export type ConnectorRuntimeCredential = {
+    connectorId: string;
+    workspaceId: string;
+    provider: string;
+    appId: string;
+    brand?: string;
+    accessToken: string;
+    expiresAt?: string | null;
+    scopes?: string[];
+    profile?: ConnectorProfile | null;
+};
+export type ConnectorRuntimeGetInput = {
+    workspaceId: string;
+    provider: string;
+    connectorId?: string;
+};
+export interface ConnectorRuntimeApi {
+    getConnector(input: ConnectorRuntimeGetInput): Promise<ConnectorRuntimeCredential>;
+}
+export type ConnectorSelectOption = {
+    value: string;
+    label: RuntimeI18nText;
+    provider: string;
+    status: ConnectorStatus;
+    description?: RuntimeI18nText;
+    avatarUrl?: string;
+};
+export type ConnectorAppCredentialPayload = Record<string, unknown>;
+export type ConnectorAuthorizationUrlInput = {
+    app?: ConnectorAppCredentialPayload;
+    redirectUri: string;
+    state: string;
+    scopes?: string[];
+};
+export type ConnectorAuthorizationUrlResult = {
+    authorizationUrl: string;
+    scopes?: string[];
+    metadata?: Record<string, unknown>;
+    pollIntervalSeconds?: number | null;
+};
+export type ConnectorOAuthCodeInput = {
+    app?: ConnectorAppCredentialPayload;
+    code: string;
+    redirectUri: string;
+    scopes?: string[];
+};
+export type ConnectorRefreshInput = {
+    app?: ConnectorAppCredentialPayload;
+    refreshToken: string;
+};
+export type ConnectorOAuthCredential = {
+    appId: string;
+    brand?: string;
+    /**
+     * Provider app credentials retained only for encrypted platform storage and token refresh.
+     * Hosts must not expose this field through public connector or runtime credential APIs.
+     */
+    app?: ConnectorAppCredentialPayload;
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt?: string | null;
+    refreshExpiresAt?: string | null;
+    scopes?: string[];
+    profile?: ConnectorProfile | null;
+};
+export type ConnectorOAuthCompleteRequest = {
+    state: string;
+    code: string;
+};
+export type ConnectorAuthorizationPollInput = {
+    metadata?: Record<string, unknown> | null;
+    redirectUri: string;
+    scopes?: string[];
+};
+export type ConnectorAuthorizationPollResult = {
+    status: 'pending';
+    authorizationUrl?: string;
+    metadata?: Record<string, unknown>;
+    pollIntervalSeconds?: number | null;
+    message?: string;
+} | {
+    status: 'complete';
+    credential: ConnectorOAuthCredential;
+    metadata?: Record<string, unknown>;
+} | {
+    status: 'error';
+    error: string;
+    metadata?: Record<string, unknown>;
+};
+export interface ConnectorStrategy {
+    definition: ConnectorDefinition;
+    isSelectableAppIntegration?(integration: ConnectorAppIntegration): boolean | Promise<boolean>;
+    buildAuthorizationUrl(input: ConnectorAuthorizationUrlInput): Promise<ConnectorAuthorizationUrlResult>;
+    exchangeOAuthCode(input: ConnectorOAuthCodeInput): Promise<ConnectorOAuthCredential>;
+    refreshCredential?(input: ConnectorRefreshInput): Promise<ConnectorOAuthCredential>;
+    pollAuthorization?(input: ConnectorAuthorizationPollInput): Promise<ConnectorAuthorizationPollResult>;
+}

package/src/lib/connector/strategy.registry.d.ts

@@ -0,0 +1,6 @@
+import { DiscoveryService, Reflector } from '@nestjs/core';
+import { BaseStrategyRegistry } from '../strategy';
+import type { ConnectorStrategy } from './strategy.interface';
+export declare class ConnectorStrategyRegistry extends BaseStrategyRegistry<ConnectorStrategy> {
+    constructor(discoveryService: DiscoveryService, reflector: Reflector);
+}

package/src/lib/workflow/node/strategy.interface.d.ts

@@ -1,6 +1,5 @@
 import { Runnable, RunnableToolLike } from '@langchain/core/runnables';
-import { DynamicStructuredTool, StructuredToolInterface } from '@langchain/core/tools';
-import { ToolInputSchemaBase } from '@langchain/core/dist/tools/types';
+import { DynamicStructuredTool, StructuredToolInterface, type ToolSchemaBase } from '@langchain/core/tools';
 import { InteropZodType } from '@langchain/core/utils/types';
 import { BaseChannel } from '@langchain/langgraph';
 import { IEnvironment, IWorkflowNode, TWorkflowNodeMeta, TVariableAssigner, TXpertGraph, TWorkflowVarGroup, TXpertParameter, TXpertTeamNode } from '@xpert-ai/contracts';
@@ -26,7 +25,7 @@ export type TWorkflowNodeResult = {
         title: string;
         id?: string;
     };
-    tool?: DynamicStructuredTool<ToolInputSchemaBase, any, any> | StructuredToolInterface<ToolInputSchemaBase, any, any> | RunnableToolLike<InteropZodType, unknown>;
+    tool?: DynamicStructuredTool<ToolSchemaBase, any, any> | StructuredToolInterface<ToolSchemaBase, any, any> | RunnableToolLike<InteropZodType, unknown>;
     variables?: TVariableAssigner[];
 };
 /**