@xpert-ai/plugin-sdk 3.14.0 → 3.15.1

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @xpert-ai/plugin-sdk
 
+## 3.15.1
+
+### Patch Changes
+
+- 8fded17: plugin scope for tenant
+- Updated dependencies [8fded17]
+  - @xpert-ai/contracts@3.15.2
+
+## 3.15.0
+
+### Minor Changes
+
+- c1e4da2: managed queue
+
+### Patch Changes
+
+- Updated dependencies [c1e4da2]
+  - @xpert-ai/contracts@3.15.1
+
 ## 3.14.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 SYSTEM_GLOBAL_SCOPE = 'system:global';
 const BUILTIN_GLOBAL_SCOPE = 'builtin:global';
 const TENANT_GLOBAL_SCOPE_PREFIX = 'tenant:';
 const TENANT_GLOBAL_SCOPE_SUFFIX = ':global';
@@ -563,6 +564,9 @@ class BaseStrategyRegistry {
         if (orgKey !== globalKey) {
             scopeKeys.push(globalKey);
         }
+        if (!scopeKeys.includes(SYSTEM_GLOBAL_SCOPE)) {
+            scopeKeys.push(SYSTEM_GLOBAL_SCOPE);
+        }
         if (!scopeKeys.includes(BUILTIN_GLOBAL_SCOPE)) {
             scopeKeys.push(BUILTIN_GLOBAL_SCOPE);
         }
@@ -4115,6 +4119,46 @@ 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));
 
@@ -4644,10 +4688,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;
@@ -4658,6 +4705,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;
@@ -4673,6 +4721,7 @@ exports.SSOProviderStrategyKey = SSOProviderStrategyKey;
 exports.SSO_BINDING_PERMISSION_SERVICE_TOKEN = SSO_BINDING_PERMISSION_SERVICE_TOKEN;
 exports.SSO_PROVIDER = SSO_PROVIDER;
 exports.STRATEGY_META_KEY = STRATEGY_META_KEY;
+exports.SYSTEM_GLOBAL_SCOPE = SYSTEM_GLOBAL_SCOPE;
 exports.SandboxProviderStrategy = SandboxProviderStrategy;
 exports.SkillSourceProviderStrategy = SkillSourceProviderStrategy;
 exports.Speech2TextChatModel = Speech2TextChatModel;

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 SYSTEM_GLOBAL_SCOPE = 'system:global';
 const BUILTIN_GLOBAL_SCOPE = 'builtin:global';
 const TENANT_GLOBAL_SCOPE_PREFIX = 'tenant:';
 const TENANT_GLOBAL_SCOPE_SUFFIX = ':global';
@@ -543,6 +544,9 @@ class BaseStrategyRegistry {
         if (orgKey !== globalKey) {
             scopeKeys.push(globalKey);
         }
+        if (!scopeKeys.includes(SYSTEM_GLOBAL_SCOPE)) {
+            scopeKeys.push(SYSTEM_GLOBAL_SCOPE);
+        }
         if (!scopeKeys.includes(BUILTIN_GLOBAL_SCOPE)) {
             scopeKeys.push(BUILTIN_GLOBAL_SCOPE);
         }
@@ -4095,6 +4099,46 @@ 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));
 
@@ -4543,4 +4587,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, 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, 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, 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.14.0",
+  "version": "3.15.1",
   "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/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 SYSTEM_GLOBAL_SCOPE = "system: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";
@@ -87,6 +88,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;
 }