@xpert-ai/plugin-sdk 3.13.0 → 3.15.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @xpert-ai/plugin-sdk
 
+## 3.15.0
+
+### Minor Changes
+
+- c1e4da2: managed queue
+
+### Patch Changes
+
+- Updated dependencies [c1e4da2]
+  - @xpert-ai/contracts@3.15.1
+
+## 3.14.0
+
+### Minor Changes
+
+- 6f679b8: fix plugin tenant scope & human chat files types
+
+### Patch Changes
+
+- Updated dependencies [6f679b8]
+  - @xpert-ai/contracts@3.15.0
+
 ## 3.13.0
 
 ### Minor Changes

package/index.cjs.js

@@ -91,6 +91,7 @@ var _axios__namespace = /*#__PURE__*/_interopNamespaceDefault(_axios);
 const ORGANIZATION_METADATA_KEY = 'xpert:organizationId';
 const PLUGIN_METADATA_KEY = 'xpert:pluginName';
 const GLOBAL_ORGANIZATION_SCOPE = 'global';
+const BUILTIN_GLOBAL_SCOPE = 'builtin:global';
 const TENANT_GLOBAL_SCOPE_PREFIX = 'tenant:';
 const TENANT_GLOBAL_SCOPE_SUFFIX = ':global';
 const STRATEGY_META_KEY = 'XPERT_STRATEGY_META_KEY';
@@ -513,14 +514,14 @@ class BaseStrategyRegistry {
         if (type) {
             var _instance_metatype;
             const target = (_instance_metatype = instance.metatype) != null ? _instance_metatype : instance.constructor;
+            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 : GLOBAL_ORGANIZATION_SCOPE;
+            const organizationId = (_this_reflector_get = this.reflector.get(ORGANIZATION_METADATA_KEY, target)) != null ? _this_reflector_get : pluginName ? GLOBAL_ORGANIZATION_SCOPE : BUILTIN_GLOBAL_SCOPE;
             var _this_strategies_get;
             const orgMap = (_this_strategies_get = this.strategies.get(organizationId)) != null ? _this_strategies_get : new Map();
             orgMap.set(type, instance);
             this.strategies.set(organizationId, orgMap);
-            const pluginName = this.reflector.get(PLUGIN_METADATA_KEY, target);
-            this.logger.debug(`Registered strategy of type ${type} for organization ${organizationId} from plugin ${pluginName}`);
+            this.logger.debug(`Registered strategy of type ${type} for scope ${organizationId} from plugin ${pluginName}`);
             if (pluginName) {
                 var _this_pluginStrategies_get;
                 const pluginStrategies = (_this_pluginStrategies_get = this.pluginStrategies.get(pluginName)) != null ? _this_pluginStrategies_get : new Set();
@@ -530,7 +531,7 @@ class BaseStrategyRegistry {
         }
     }
     /**
-     * Remove all strategies registered by the given plugin for the given organization.
+     * Remove all strategies registered by the given plugin for the given scope.
      */ remove(organizationId, pluginName) {
         const strategies = this.pluginStrategies.get(pluginName);
         const orgMap = this.strategies.get(organizationId);
@@ -539,7 +540,7 @@ class BaseStrategyRegistry {
         }
     }
     /**
-     * Resolve organization id, falling back to request context org or global scope.
+     * Resolve the primary scope key, falling back to request context org or tenant-global scope.
      */ resolveOrganization(organizationId) {
         var _RequestContext_getScope;
         var _RequestContext_getScope_tenantId;
@@ -553,6 +554,20 @@ class BaseStrategyRegistry {
         const tenantId = (_RequestContext_getScope_tenantId = (_RequestContext_getScope = RequestContext.getScope()) == null ? void 0 : _RequestContext_getScope.tenantId) != null ? _RequestContext_getScope_tenantId : RequestContext.currentTenantId();
         return resolveTenantGlobalScopeKey(tenantId);
     }
+    resolveStrategyScopeKeys(organizationId) {
+        const orgKey = this.resolveOrganization(organizationId);
+        const globalKey = this.resolveGlobalFallbackOrganization();
+        const scopeKeys = [
+            orgKey
+        ];
+        if (orgKey !== globalKey) {
+            scopeKeys.push(globalKey);
+        }
+        if (!scopeKeys.includes(BUILTIN_GLOBAL_SCOPE)) {
+            scopeKeys.push(BUILTIN_GLOBAL_SCOPE);
+        }
+        return scopeKeys;
+    }
     /**
      * Get strategy by type from the given organization including global strategies as fallback.
      *
@@ -560,12 +575,11 @@ class BaseStrategyRegistry {
      * @param organizationId
      * @returns
      */ get(type, organizationId) {
-        var _this_strategies_get, _this_strategies_get1;
         organizationId != null ? organizationId : organizationId = RequestContext.getOrganizationId();
-        const orgKey = this.resolveOrganization(organizationId);
-        const globalKey = this.resolveGlobalFallbackOrganization();
-        var _this_strategies_get_get;
-        const strategy = (_this_strategies_get_get = (_this_strategies_get = this.strategies.get(orgKey)) == null ? void 0 : _this_strategies_get.get(type)) != null ? _this_strategies_get_get : orgKey === globalKey ? undefined : (_this_strategies_get1 = this.strategies.get(globalKey)) == null ? void 0 : _this_strategies_get1.get(type);
+        const strategy = this.resolveStrategyScopeKeys(organizationId).map((scopeKey)=>{
+            var _this_strategies_get;
+            return (_this_strategies_get = this.strategies.get(scopeKey)) == null ? void 0 : _this_strategies_get.get(type);
+        }).find((item)=>!!item);
         if (!strategy) {
             throw new Error(`No strategy found for type '${type}' for strategy '${this.strategyKey}'`);
         }
@@ -577,19 +591,12 @@ class BaseStrategyRegistry {
      * @param organizationId
      * @returns
      */ list(organizationId) {
-        var _this_strategies_get;
         organizationId != null ? organizationId : organizationId = RequestContext.getOrganizationId();
-        const orgKey = this.resolveOrganization(organizationId);
-        const globalKey = this.resolveGlobalFallbackOrganization();
         const effective = new Map();
-        var _this_strategies_get_entries;
-        for (const [type, strategy] of (_this_strategies_get_entries = (_this_strategies_get = this.strategies.get(orgKey)) == null ? void 0 : _this_strategies_get.entries()) != null ? _this_strategies_get_entries : []){
-            effective.set(type, strategy);
-        }
-        if (orgKey !== globalKey) {
-            var _this_strategies_get1;
-            var _this_strategies_get_entries1;
-            for (const [type, strategy] of (_this_strategies_get_entries1 = (_this_strategies_get1 = this.strategies.get(globalKey)) == null ? void 0 : _this_strategies_get1.entries()) != null ? _this_strategies_get_entries1 : []){
+        for (const scopeKey of this.resolveStrategyScopeKeys(organizationId)){
+            var _this_strategies_get;
+            var _this_strategies_get_entries;
+            for (const [type, strategy] of (_this_strategies_get_entries = (_this_strategies_get = this.strategies.get(scopeKey)) == null ? void 0 : _this_strategies_get.entries()) != null ? _this_strategies_get_entries : []){
                 if (!effective.has(type)) {
                     effective.set(type, strategy);
                 }
@@ -599,7 +606,7 @@ class BaseStrategyRegistry {
     }
     constructor(strategyKey, discoveryService, reflector){
         this.logger = new common.Logger(BaseStrategyRegistry.name);
-        // Map<organizationId, Map<type, strategy>>
+        // Map<scopeKey, Map<type, strategy>>
         this.strategies = new Map();
         this.pluginStrategies = new Map();
         this.strategyKey = strategyKey;
@@ -4108,23 +4115,56 @@ function resolveSandboxTerminalAdapter(sandbox) {
 const MANAGED_CONNECTION_REGISTRY_TOKEN = 'XPERT_MANAGED_CONNECTION_REGISTRY';
 const CONNECTION_COMMAND_ROUTER_TOKEN = 'XPERT_CONNECTION_COMMAND_ROUTER';
 
+const MANAGED_QUEUE_SERVICE_TOKEN = 'XPERT_MANAGED_QUEUE_SERVICE';
+const MANAGED_QUEUE_HANDLER_REGISTRY_TOKEN = 'XPERT_MANAGED_QUEUE_HANDLER_REGISTRY';
+const PLUGIN_JOB_PROCESSOR_METADATA = 'XPERT_PLUGIN_JOB_PROCESSOR_METADATA';
+function PluginJobProcessor(options) {
+    return (target)=>{
+        const metadata = normalizePluginJobProcessorMetadata(options);
+        var _Reflect_getMetadata;
+        const existing = (_Reflect_getMetadata = Reflect.getMetadata(PLUGIN_JOB_PROCESSOR_METADATA, target)) != null ? _Reflect_getMetadata : [];
+        Reflect.defineMetadata(PLUGIN_JOB_PROCESSOR_METADATA, [
+            metadata,
+            ...existing
+        ], target);
+    };
+}
+function normalizePluginJobProcessorMetadata(options) {
+    const pluginName = requireManagedQueueDecoratorValue(options.pluginName, 'pluginName');
+    var _options_queueName;
+    const queueName = requireManagedQueueDecoratorValue((_options_queueName = options.queueName) != null ? _options_queueName : options.queue, 'queueName');
+    var _options_jobName;
+    const jobName = requireManagedQueueDecoratorValue((_options_jobName = options.jobName) != null ? _options_jobName : options.jobType, 'jobName');
+    const concurrency = options.concurrency;
+    if (concurrency !== undefined && (!Number.isFinite(concurrency) || concurrency <= 0)) {
+        throw new Error('PluginJobProcessor concurrency must be a positive number');
+    }
+    return _extends({
+        pluginName,
+        queueName,
+        jobName
+    }, concurrency === undefined ? {} : {
+        concurrency: Math.trunc(concurrency)
+    });
+}
+function requireManagedQueueDecoratorValue(value, field) {
+    const normalized = `${value != null ? value : ''}`.trim();
+    if (!normalized) {
+        throw new Error(`PluginJobProcessor ${field} is required`);
+    }
+    return normalized;
+}
+
 const VIEW_EXTENSION_PROVIDER = 'VIEW_EXTENSION_PROVIDER';
 const ViewExtensionProvider = (providerKey)=>common.applyDecorators(common.SetMetadata(VIEW_EXTENSION_PROVIDER, providerKey), common.SetMetadata(STRATEGY_META_KEY, VIEW_EXTENSION_PROVIDER));
 
 exports.ViewExtensionProviderRegistry = class ViewExtensionProviderRegistry extends BaseStrategyRegistry {
     listEntries(organizationId) {
-        var _this_strategies_get;
-        const orgKey = this.resolveOrganization(organizationId);
-        const globalKey = this.resolveGlobalFallbackOrganization();
         const entries = new Map();
-        var _this_strategies_get_entries;
-        for (const [providerKey, provider] of (_this_strategies_get_entries = (_this_strategies_get = this.strategies.get(orgKey)) == null ? void 0 : _this_strategies_get.entries()) != null ? _this_strategies_get_entries : []){
-            entries.set(providerKey, provider);
-        }
-        if (orgKey !== globalKey) {
-            var _this_strategies_get1;
-            var _this_strategies_get_entries1;
-            for (const [providerKey, provider] of (_this_strategies_get_entries1 = (_this_strategies_get1 = this.strategies.get(globalKey)) == null ? void 0 : _this_strategies_get1.entries()) != null ? _this_strategies_get_entries1 : []){
+        for (const scopeKey of this.resolveStrategyScopeKeys(organizationId)){
+            var _this_strategies_get;
+            var _this_strategies_get_entries;
+            for (const [providerKey, provider] of (_this_strategies_get_entries = (_this_strategies_get = this.strategies.get(scopeKey)) == null ? void 0 : _this_strategies_get.entries()) != null ? _this_strategies_get_entries : []){
                 if (!entries.has(providerKey)) {
                     entries.set(providerKey, provider);
                 }
@@ -4583,6 +4623,7 @@ exports.AgentMiddlewareStrategy = AgentMiddlewareStrategy;
 exports.AiModelNotFoundException = AiModelNotFoundException;
 exports.AssistantTaskRuntimeCapability = AssistantTaskRuntimeCapability;
 exports.BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN = BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN;
+exports.BUILTIN_GLOBAL_SCOPE = BUILTIN_GLOBAL_SCOPE;
 exports.BaseHTTPQueryRunner = BaseHTTPQueryRunner;
 exports.BaseQueryRunner = BaseQueryRunner;
 exports.BaseSQLQueryRunner = BaseSQLQueryRunner;
@@ -4643,10 +4684,13 @@ exports.KnowledgebaseRuntimeCapability = KnowledgebaseRuntimeCapability;
 exports.LLMUsage = LLMUsage;
 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.ORGANIZATION_METADATA_KEY = ORGANIZATION_METADATA_KEY;
 exports.OpenAICompatibleReranker = OpenAICompatibleReranker;
 exports.PERMISSION_OPERATION_METADATA_KEY = PERMISSION_OPERATION_METADATA_KEY;
 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_WEBHOOK_AUTH_METADATA_KEY = PLUGIN_WEBHOOK_AUTH_METADATA_KEY;
@@ -4657,6 +4701,7 @@ exports.PROVIDE_AI_MODEL_RERANK = PROVIDE_AI_MODEL_RERANK;
 exports.PROVIDE_AI_MODEL_SPEECH2TEXT = PROVIDE_AI_MODEL_SPEECH2TEXT;
 exports.PROVIDE_AI_MODEL_TEXT_EMBEDDING = PROVIDE_AI_MODEL_TEXT_EMBEDDING;
 exports.PROVIDE_AI_MODEL_TTS = PROVIDE_AI_MODEL_TTS;
+exports.PluginJobProcessor = PluginJobProcessor;
 exports.PluginWebhookAuth = PluginWebhookAuth;
 exports.RETRIEVER_STRATEGY = RETRIEVER_STRATEGY;
 exports.RequestContext = RequestContext;

package/index.esm.js

@@ -71,6 +71,7 @@ import { getModelContextSize as getModelContextSize$1 } from '@langchain/core/la
 const ORGANIZATION_METADATA_KEY = 'xpert:organizationId';
 const PLUGIN_METADATA_KEY = 'xpert:pluginName';
 const GLOBAL_ORGANIZATION_SCOPE = 'global';
+const BUILTIN_GLOBAL_SCOPE = 'builtin:global';
 const TENANT_GLOBAL_SCOPE_PREFIX = 'tenant:';
 const TENANT_GLOBAL_SCOPE_SUFFIX = ':global';
 const STRATEGY_META_KEY = 'XPERT_STRATEGY_META_KEY';
@@ -493,14 +494,14 @@ class BaseStrategyRegistry {
         if (type) {
             var _instance_metatype;
             const target = (_instance_metatype = instance.metatype) != null ? _instance_metatype : instance.constructor;
+            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 : GLOBAL_ORGANIZATION_SCOPE;
+            const organizationId = (_this_reflector_get = this.reflector.get(ORGANIZATION_METADATA_KEY, target)) != null ? _this_reflector_get : pluginName ? GLOBAL_ORGANIZATION_SCOPE : BUILTIN_GLOBAL_SCOPE;
             var _this_strategies_get;
             const orgMap = (_this_strategies_get = this.strategies.get(organizationId)) != null ? _this_strategies_get : new Map();
             orgMap.set(type, instance);
             this.strategies.set(organizationId, orgMap);
-            const pluginName = this.reflector.get(PLUGIN_METADATA_KEY, target);
-            this.logger.debug(`Registered strategy of type ${type} for organization ${organizationId} from plugin ${pluginName}`);
+            this.logger.debug(`Registered strategy of type ${type} for scope ${organizationId} from plugin ${pluginName}`);
             if (pluginName) {
                 var _this_pluginStrategies_get;
                 const pluginStrategies = (_this_pluginStrategies_get = this.pluginStrategies.get(pluginName)) != null ? _this_pluginStrategies_get : new Set();
@@ -510,7 +511,7 @@ class BaseStrategyRegistry {
         }
     }
     /**
-     * Remove all strategies registered by the given plugin for the given organization.
+     * Remove all strategies registered by the given plugin for the given scope.
      */ remove(organizationId, pluginName) {
         const strategies = this.pluginStrategies.get(pluginName);
         const orgMap = this.strategies.get(organizationId);
@@ -519,7 +520,7 @@ class BaseStrategyRegistry {
         }
     }
     /**
-     * Resolve organization id, falling back to request context org or global scope.
+     * Resolve the primary scope key, falling back to request context org or tenant-global scope.
      */ resolveOrganization(organizationId) {
         var _RequestContext_getScope;
         var _RequestContext_getScope_tenantId;
@@ -533,6 +534,20 @@ class BaseStrategyRegistry {
         const tenantId = (_RequestContext_getScope_tenantId = (_RequestContext_getScope = RequestContext.getScope()) == null ? void 0 : _RequestContext_getScope.tenantId) != null ? _RequestContext_getScope_tenantId : RequestContext.currentTenantId();
         return resolveTenantGlobalScopeKey(tenantId);
     }
+    resolveStrategyScopeKeys(organizationId) {
+        const orgKey = this.resolveOrganization(organizationId);
+        const globalKey = this.resolveGlobalFallbackOrganization();
+        const scopeKeys = [
+            orgKey
+        ];
+        if (orgKey !== globalKey) {
+            scopeKeys.push(globalKey);
+        }
+        if (!scopeKeys.includes(BUILTIN_GLOBAL_SCOPE)) {
+            scopeKeys.push(BUILTIN_GLOBAL_SCOPE);
+        }
+        return scopeKeys;
+    }
     /**
      * Get strategy by type from the given organization including global strategies as fallback.
      *
@@ -540,12 +555,11 @@ class BaseStrategyRegistry {
      * @param organizationId
      * @returns
      */ get(type, organizationId) {
-        var _this_strategies_get, _this_strategies_get1;
         organizationId != null ? organizationId : organizationId = RequestContext.getOrganizationId();
-        const orgKey = this.resolveOrganization(organizationId);
-        const globalKey = this.resolveGlobalFallbackOrganization();
-        var _this_strategies_get_get;
-        const strategy = (_this_strategies_get_get = (_this_strategies_get = this.strategies.get(orgKey)) == null ? void 0 : _this_strategies_get.get(type)) != null ? _this_strategies_get_get : orgKey === globalKey ? undefined : (_this_strategies_get1 = this.strategies.get(globalKey)) == null ? void 0 : _this_strategies_get1.get(type);
+        const strategy = this.resolveStrategyScopeKeys(organizationId).map((scopeKey)=>{
+            var _this_strategies_get;
+            return (_this_strategies_get = this.strategies.get(scopeKey)) == null ? void 0 : _this_strategies_get.get(type);
+        }).find((item)=>!!item);
         if (!strategy) {
             throw new Error(`No strategy found for type '${type}' for strategy '${this.strategyKey}'`);
         }
@@ -557,19 +571,12 @@ class BaseStrategyRegistry {
      * @param organizationId
      * @returns
      */ list(organizationId) {
-        var _this_strategies_get;
         organizationId != null ? organizationId : organizationId = RequestContext.getOrganizationId();
-        const orgKey = this.resolveOrganization(organizationId);
-        const globalKey = this.resolveGlobalFallbackOrganization();
         const effective = new Map();
-        var _this_strategies_get_entries;
-        for (const [type, strategy] of (_this_strategies_get_entries = (_this_strategies_get = this.strategies.get(orgKey)) == null ? void 0 : _this_strategies_get.entries()) != null ? _this_strategies_get_entries : []){
-            effective.set(type, strategy);
-        }
-        if (orgKey !== globalKey) {
-            var _this_strategies_get1;
-            var _this_strategies_get_entries1;
-            for (const [type, strategy] of (_this_strategies_get_entries1 = (_this_strategies_get1 = this.strategies.get(globalKey)) == null ? void 0 : _this_strategies_get1.entries()) != null ? _this_strategies_get_entries1 : []){
+        for (const scopeKey of this.resolveStrategyScopeKeys(organizationId)){
+            var _this_strategies_get;
+            var _this_strategies_get_entries;
+            for (const [type, strategy] of (_this_strategies_get_entries = (_this_strategies_get = this.strategies.get(scopeKey)) == null ? void 0 : _this_strategies_get.entries()) != null ? _this_strategies_get_entries : []){
                 if (!effective.has(type)) {
                     effective.set(type, strategy);
                 }
@@ -579,7 +586,7 @@ class BaseStrategyRegistry {
     }
     constructor(strategyKey, discoveryService, reflector){
         this.logger = new Logger(BaseStrategyRegistry.name);
-        // Map<organizationId, Map<type, strategy>>
+        // Map<scopeKey, Map<type, strategy>>
         this.strategies = new Map();
         this.pluginStrategies = new Map();
         this.strategyKey = strategyKey;
@@ -4088,23 +4095,56 @@ function resolveSandboxTerminalAdapter(sandbox) {
 const MANAGED_CONNECTION_REGISTRY_TOKEN = 'XPERT_MANAGED_CONNECTION_REGISTRY';
 const CONNECTION_COMMAND_ROUTER_TOKEN = 'XPERT_CONNECTION_COMMAND_ROUTER';
 
+const MANAGED_QUEUE_SERVICE_TOKEN = 'XPERT_MANAGED_QUEUE_SERVICE';
+const MANAGED_QUEUE_HANDLER_REGISTRY_TOKEN = 'XPERT_MANAGED_QUEUE_HANDLER_REGISTRY';
+const PLUGIN_JOB_PROCESSOR_METADATA = 'XPERT_PLUGIN_JOB_PROCESSOR_METADATA';
+function PluginJobProcessor(options) {
+    return (target)=>{
+        const metadata = normalizePluginJobProcessorMetadata(options);
+        var _Reflect_getMetadata;
+        const existing = (_Reflect_getMetadata = Reflect.getMetadata(PLUGIN_JOB_PROCESSOR_METADATA, target)) != null ? _Reflect_getMetadata : [];
+        Reflect.defineMetadata(PLUGIN_JOB_PROCESSOR_METADATA, [
+            metadata,
+            ...existing
+        ], target);
+    };
+}
+function normalizePluginJobProcessorMetadata(options) {
+    const pluginName = requireManagedQueueDecoratorValue(options.pluginName, 'pluginName');
+    var _options_queueName;
+    const queueName = requireManagedQueueDecoratorValue((_options_queueName = options.queueName) != null ? _options_queueName : options.queue, 'queueName');
+    var _options_jobName;
+    const jobName = requireManagedQueueDecoratorValue((_options_jobName = options.jobName) != null ? _options_jobName : options.jobType, 'jobName');
+    const concurrency = options.concurrency;
+    if (concurrency !== undefined && (!Number.isFinite(concurrency) || concurrency <= 0)) {
+        throw new Error('PluginJobProcessor concurrency must be a positive number');
+    }
+    return _extends({
+        pluginName,
+        queueName,
+        jobName
+    }, concurrency === undefined ? {} : {
+        concurrency: Math.trunc(concurrency)
+    });
+}
+function requireManagedQueueDecoratorValue(value, field) {
+    const normalized = `${value != null ? value : ''}`.trim();
+    if (!normalized) {
+        throw new Error(`PluginJobProcessor ${field} is required`);
+    }
+    return normalized;
+}
+
 const VIEW_EXTENSION_PROVIDER = 'VIEW_EXTENSION_PROVIDER';
 const ViewExtensionProvider = (providerKey)=>applyDecorators(SetMetadata(VIEW_EXTENSION_PROVIDER, providerKey), SetMetadata(STRATEGY_META_KEY, VIEW_EXTENSION_PROVIDER));
 
 let ViewExtensionProviderRegistry = class ViewExtensionProviderRegistry extends BaseStrategyRegistry {
     listEntries(organizationId) {
-        var _this_strategies_get;
-        const orgKey = this.resolveOrganization(organizationId);
-        const globalKey = this.resolveGlobalFallbackOrganization();
         const entries = new Map();
-        var _this_strategies_get_entries;
-        for (const [providerKey, provider] of (_this_strategies_get_entries = (_this_strategies_get = this.strategies.get(orgKey)) == null ? void 0 : _this_strategies_get.entries()) != null ? _this_strategies_get_entries : []){
-            entries.set(providerKey, provider);
-        }
-        if (orgKey !== globalKey) {
-            var _this_strategies_get1;
-            var _this_strategies_get_entries1;
-            for (const [providerKey, provider] of (_this_strategies_get_entries1 = (_this_strategies_get1 = this.strategies.get(globalKey)) == null ? void 0 : _this_strategies_get1.entries()) != null ? _this_strategies_get_entries1 : []){
+        for (const scopeKey of this.resolveStrategyScopeKeys(organizationId)){
+            var _this_strategies_get;
+            var _this_strategies_get_entries;
+            for (const [providerKey, provider] of (_this_strategies_get_entries = (_this_strategies_get = this.strategies.get(scopeKey)) == null ? void 0 : _this_strategies_get.entries()) != null ? _this_strategies_get_entries : []){
                 if (!entries.has(providerKey)) {
                     entries.set(providerKey, provider);
                 }
@@ -4543,4 +4583,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, 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, ModelProvider, ORGANIZATION_METADATA_KEY, OpenAICompatibleReranker, PERMISSION_OPERATION_METADATA_KEY, PLUGIN_CONFIG_RESOLVER_TOKEN, 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, 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, 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, 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, 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, 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, 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/plugin-sdk",
-  "version": "3.13.0",
+  "version": "3.15.0",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",

package/src/index.d.ts

@@ -19,4 +19,5 @@ export * from './lib/strategy';
 export * from './lib/sso/index';
 export * from './lib/sandbox/index';
 export * from './lib/managed-connection/index';
+export * from './lib/managed-queue/index';
 export * from './lib/view-extension/index';

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

@@ -0,0 +1,106 @@
+export declare const MANAGED_QUEUE_SERVICE_TOKEN = "XPERT_MANAGED_QUEUE_SERVICE";
+export declare const MANAGED_QUEUE_HANDLER_REGISTRY_TOKEN = "XPERT_MANAGED_QUEUE_HANDLER_REGISTRY";
+export declare const PLUGIN_JOB_PROCESSOR_METADATA = "XPERT_PLUGIN_JOB_PROCESSOR_METADATA";
+export type PluginJobProcessorOptions = {
+    pluginName: string;
+    queueName?: string;
+    queue?: string;
+    jobName?: string;
+    jobType?: string;
+    concurrency?: number;
+};
+export type PluginJobProcessorMetadata = {
+    pluginName: string;
+    queueName: string;
+    jobName: string;
+    concurrency?: number;
+};
+export type ManagedQueueRemoveOption = boolean | number | {
+    age?: number;
+    count?: number;
+};
+export type ManagedQueueBackoffInput = number | {
+    type?: 'fixed' | 'exponential';
+    delay: number;
+};
+export type ManagedQueueRedis = {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, mode?: string, ttlMode?: string | number, ttlOrMode?: number | string): Promise<string | null>;
+    del(...keys: string[]): Promise<number>;
+    incr(key: string): Promise<number>;
+    expire(key: string, seconds: number): Promise<number>;
+    ttl(key: string): Promise<number>;
+    eval(script: string, numKeys: number, ...args: Array<string | number>): Promise<unknown>;
+};
+export type ManagedQueueEnqueueInput<TPayload = unknown> = {
+    pluginName: string;
+    queueName: string;
+    jobName: string;
+    payload: TPayload;
+    tenantId?: string | null;
+    organizationId?: string | null;
+    scopeKey?: string | null;
+    userId?: string | null;
+    jobId?: string;
+    delayMs?: number;
+    attempts?: number;
+    backoffMs?: ManagedQueueBackoffInput;
+    removeOnComplete?: ManagedQueueRemoveOption;
+    removeOnFail?: ManagedQueueRemoveOption;
+};
+export type ManagedQueueEnqueueResult = {
+    jobId: string;
+};
+export type ManagedQueueCancelInput = {
+    jobId: string;
+};
+export type ManagedQueueCancelResult = {
+    success: boolean;
+    jobId: string;
+    state?: string;
+    reason?: 'not_found' | 'active' | 'completed' | 'failed' | 'locked' | 'not_removable';
+    error?: string;
+};
+export type ManagedQueueJob<TPayload = unknown> = {
+    id?: string;
+    name: string;
+    data: TPayload;
+    attemptsMade: number;
+    opts?: Record<string, unknown>;
+};
+export type ManagedQueueJobContext = {
+    pluginName: string;
+    queueName: string;
+    jobName: string;
+    scopeKey?: string | null;
+};
+export type ManagedQueueJobSnapshot<TPayload = unknown> = ManagedQueueJob<TPayload> & {
+    state?: string;
+    timestamp?: number;
+    processedOn?: number;
+    finishedOn?: number;
+};
+export type ManagedQueueJobHandler<TPayload = unknown> = (job: ManagedQueueJob<TPayload>) => Promise<void> | void;
+export interface ManagedQueueJobProcessor<TPayload = unknown> {
+    handle(job: ManagedQueueJob<TPayload>, context: ManagedQueueJobContext): Promise<void> | void;
+}
+export type ManagedQueueHandlerRegistration<TPayload = unknown> = {
+    pluginName: string;
+    queueName: string;
+    jobName: string;
+    scopeKey?: string | null;
+    concurrency?: number;
+    handler: ManagedQueueJobHandler<TPayload>;
+};
+export interface ManagedQueueHandlerRegistry {
+    register<TPayload = unknown>(registration: ManagedQueueHandlerRegistration<TPayload>): () => void;
+}
+export interface ManagedQueueService {
+    enqueue<TPayload = unknown>(input: ManagedQueueEnqueueInput<TPayload>): Promise<ManagedQueueEnqueueResult>;
+    cancel(input: ManagedQueueCancelInput): Promise<ManagedQueueCancelResult>;
+    getJob<TPayload = unknown>(input: {
+        jobId: string;
+    }): Promise<ManagedQueueJobSnapshot<TPayload> | null>;
+    getRedis(): Promise<ManagedQueueRedis>;
+}
+export declare function PluginJobProcessor(options: PluginJobProcessorOptions): ClassDecorator;

package/src/lib/strategy.d.ts

@@ -13,14 +13,15 @@ export declare class BaseStrategyRegistry<S> implements OnModuleInit {
     onModuleInit(): void;
     upsert(instance: any): void;
     /**
-     * Remove all strategies registered by the given plugin for the given organization.
+     * Remove all strategies registered by the given plugin for the given scope.
      */
     remove(organizationId: string, pluginName: string): void;
     /**
-     * Resolve organization id, falling back to request context org or global scope.
+     * Resolve the primary scope key, falling back to request context org or tenant-global scope.
      */
     protected resolveOrganization(organizationId?: string): string;
     protected resolveGlobalFallbackOrganization(): string;
+    protected resolveStrategyScopeKeys(organizationId?: string): string[];
     /**
      * Get strategy by type from the given organization including global strategies as fallback.
      *

package/src/lib/types.d.ts

@@ -6,6 +6,7 @@ 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 GLOBAL_ORGANIZATION_SCOPE = "global";
+export declare const BUILTIN_GLOBAL_SCOPE = "builtin:global";
 export declare const TENANT_GLOBAL_SCOPE_PREFIX = "tenant:";
 export declare const TENANT_GLOBAL_SCOPE_SUFFIX = ":global";
 export declare const STRATEGY_META_KEY = "XPERT_STRATEGY_META_KEY";
@@ -86,6 +87,9 @@ export interface PluginContext<TConfig extends object = any> {
     app?: INestApplicationContext;
     logger: PluginLogger;
     config: TConfig;
+    tenantId?: string | null;
+    organizationId?: string | null;
+    scopeKey?: string | null;
     /** Helper method to access other Providers in the container */
     resolve<TInput = any, TResult = TInput>(token: any): TResult;
 }