@xpert-ai/plugin-sdk 3.9.8 → 4.0.0

package/index.esm.js

@@ -338,22 +338,25 @@ class RequestContext {
      */ static hasRoles(roles, throwError) {
         const context = RequestContext.currentRequestContext();
         if (context) {
-            try {
-                // tslint:disable-next-line
-                const token = this.currentToken();
-                if (token) {
+            var _this_currentUser_role, _this_currentUser;
+            // tslint:disable-next-line
+            const token = this.currentToken();
+            if (token) {
+                try {
                     const { role } = verify(token, process.env['JWT_SECRET']);
-                    return roles.includes(role != null ? role : null);
-                } else if (this.currentUser().role) {
-                    return roles.includes(this.currentUser().role.name);
-                }
-            } catch (error) {
-                if (error instanceof JsonWebTokenError) {
-                    return false;
-                } else {
-                    throw error;
+                    if (role) {
+                        return roles.includes(role);
+                    }
+                } catch (error) {
+                    if (!(error instanceof JsonWebTokenError)) {
+                        throw error;
+                    }
                 }
             }
+            const role = (_this_currentUser = this.currentUser()) == null ? void 0 : (_this_currentUser_role = _this_currentUser.role) == null ? void 0 : _this_currentUser_role.name;
+            if (role) {
+                return roles.includes(role);
+            }
         }
         if (throwError) {
             throw new HttpException('Unauthorized', HttpStatus.UNAUTHORIZED);
@@ -2616,6 +2619,52 @@ AgentMiddlewareRegistry = __decorate([
     "end"
 ];
 
+function createRuntimeCapability(id, options = {}) {
+    return Object.freeze({
+        id,
+        description: options.description
+    });
+}
+const XPERT_RUNTIME_CAPABILITIES_TOKEN = 'XPERT_RUNTIME_CAPABILITIES';
+class DefaultAgentMiddlewareRuntimeCapabilityRegistry {
+    register(key, implementation) {
+        this.capabilities.set(runtimeCapabilityId(key), implementation);
+        return this;
+    }
+    has(key) {
+        return this.capabilities.has(runtimeCapabilityId(key));
+    }
+    get(key) {
+        return this.capabilities.get(runtimeCapabilityId(key));
+    }
+    require(key) {
+        const implementation = this.get(key);
+        if (!implementation) {
+            throw new Error(`Runtime capability '${runtimeCapabilityId(key)}' is not available`);
+        }
+        return implementation;
+    }
+    constructor(entries = []){
+        this.capabilities = new Map();
+        entries.forEach(([key, implementation])=>this.register(key, implementation));
+    }
+}
+function runtimeCapabilityId(key) {
+    return typeof key === 'string' ? key : key.id;
+}
+
+const KnowledgebaseRuntimeCapability = createRuntimeCapability('platform.knowledgebase', {
+    description: 'List, search, and write chunks in platform knowledgebases.'
+});
+
+const AssistantTaskRuntimeCapability = createRuntimeCapability('platform.assistant_task', {
+    description: 'Start asynchronous tasks on the current platform assistant.'
+});
+
+const FileRuntimeCapability = createRuntimeCapability('platform.file', {
+    description: 'Resolve platform file handles into previewable file URLs.'
+});
+
 const SEGMENT_PATTERN = /^[a-z][a-z0-9_-]*$/i;
 const VERSION_PATTERN = /^v[1-9][0-9]*$/;
 function assertSegment(input, name) {
@@ -3951,6 +4000,420 @@ ViewExtensionProviderRegistry = __decorate([
     ])
 ], ViewExtensionProviderRegistry);
 
+const XPERT_REMOTE_UI_CSS = `
+:root {
+  color-scheme: light;
+  --xui-font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  --xui-color-background: #fff;
+  --xui-color-foreground: #18181b;
+  --xui-color-card: #fff;
+  --xui-color-card-foreground: #18181b;
+  --xui-color-muted: #f4f4f5;
+  --xui-color-muted-foreground: #71717a;
+  --xui-color-border: #e4e4e7;
+  --xui-color-input: #d4d4d8;
+  --xui-color-primary: #18181b;
+  --xui-color-primary-foreground: #fff;
+  --xui-color-destructive: #dc2626;
+  --xui-color-destructive-background: #fef2f2;
+  --xui-color-success: #047857;
+  --xui-color-success-background: #ecfdf5;
+  --xui-radius-sm: 6px;
+  --xui-radius-md: 8px;
+  --xui-radius-lg: 10px;
+  --xui-font-size-xs: 0.75rem;
+  --xui-font-size-sm: 0.8125rem;
+  --xui-font-size-md: 0.875rem;
+  --xui-font-size-lg: 1rem;
+  --xui-font-size-control: var(--xui-font-size-sm);
+  --xui-font-size-button: var(--xui-font-size-sm);
+  --xui-font-size-table: var(--xui-font-size-sm);
+  --xui-control-height: 2rem;
+  --xui-button-height: 2rem;
+  --xui-button-height-sm: 1.75rem;
+  --xui-shadow-dialog: 0 20px 50px rgba(24, 24, 27, 0.22);
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  background: var(--xui-color-background);
+  color: var(--xui-color-foreground);
+  font-family: var(--xui-font-family);
+  font-size: var(--xui-font-size-md);
+}
+
+button,
+input,
+select,
+textarea {
+  font: inherit;
+}
+
+button {
+  cursor: pointer;
+}
+
+button:disabled,
+input:disabled,
+select:disabled,
+textarea:disabled {
+  cursor: not-allowed;
+  opacity: 0.56;
+}
+
+.xui-app {
+  min-height: 420px;
+  padding: 2px;
+}
+
+.xui-toolbar {
+  display: grid;
+  grid-template-columns: minmax(160px, 240px) minmax(160px, 240px) minmax(180px, 1fr) auto auto;
+  gap: 8px;
+  align-items: center;
+  margin-bottom: 12px;
+}
+
+.xui-control,
+.xui-input,
+.xui-textarea {
+  width: 100%;
+  min-width: 0;
+  border: 1px solid var(--xui-color-input);
+  border-radius: var(--xui-radius-md);
+  background: var(--xui-color-card);
+  color: var(--xui-color-card-foreground);
+  outline: none;
+}
+
+.xui-control,
+.xui-input {
+  height: var(--xui-control-height);
+  padding: 0 10px;
+  font-size: var(--xui-font-size-control);
+}
+
+.xui-textarea {
+  min-height: 84px;
+  padding: 8px 10px;
+  resize: vertical;
+  font-size: var(--xui-font-size-control);
+}
+
+.xui-button {
+  display: inline-flex;
+  height: var(--xui-button-height);
+  align-items: center;
+  justify-content: center;
+  gap: 6px;
+  border: 1px solid var(--xui-color-input);
+  border-radius: var(--xui-radius-md);
+  background: var(--xui-color-card);
+  color: var(--xui-color-card-foreground);
+  padding: 0 12px;
+  font-size: var(--xui-font-size-button);
+  white-space: nowrap;
+}
+
+.xui-button-primary {
+  border-color: var(--xui-color-primary);
+  background: var(--xui-color-primary);
+  color: var(--xui-color-primary-foreground);
+}
+
+.xui-button-danger {
+  border-color: color-mix(in srgb, var(--xui-color-destructive) 32%, transparent);
+  color: var(--xui-color-destructive);
+}
+
+.xui-button-sm {
+  height: var(--xui-button-height-sm);
+  padding: 0 8px;
+  font-size: var(--xui-font-size-xs);
+}
+
+.xui-notice {
+  display: flex;
+  align-items: center;
+  min-height: 36px;
+  margin-bottom: 12px;
+  border: 1px solid var(--xui-color-border);
+  border-radius: var(--xui-radius-md);
+  padding: 8px 10px;
+  color: var(--xui-color-muted-foreground);
+  background: var(--xui-color-muted);
+  font-size: var(--xui-font-size-sm);
+}
+
+.xui-notice-error {
+  border-color: color-mix(in srgb, var(--xui-color-destructive) 32%, transparent);
+  color: var(--xui-color-destructive);
+  background: var(--xui-color-destructive-background);
+}
+
+.xui-table-wrap {
+  overflow: auto;
+  border: 1px solid var(--xui-color-border);
+  border-radius: var(--xui-radius-md);
+}
+
+.xui-table {
+  width: 100%;
+  min-width: 880px;
+  border-collapse: collapse;
+}
+
+.xui-table th,
+.xui-table td {
+  border-bottom: 1px solid var(--xui-color-border);
+  padding: 10px;
+  text-align: left;
+  vertical-align: middle;
+  font-size: var(--xui-font-size-table);
+}
+
+.xui-table th {
+  background: var(--xui-color-muted);
+  color: var(--xui-color-muted-foreground);
+  font-weight: 600;
+}
+
+.xui-table tr:last-child td {
+  border-bottom: 0;
+}
+
+.xui-muted {
+  color: var(--xui-color-muted-foreground);
+}
+
+.xui-pill {
+  display: inline-flex;
+  align-items: center;
+  border: 1px solid var(--xui-color-border);
+  border-radius: 999px;
+  padding: 2px 8px;
+  font-size: var(--xui-font-size-xs);
+  color: var(--xui-color-muted-foreground);
+  background: var(--xui-color-muted);
+}
+
+.xui-actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+}
+
+.xui-pager {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  margin-top: 12px;
+  color: var(--xui-color-muted-foreground);
+  font-size: var(--xui-font-size-sm);
+}
+
+.xui-empty {
+  display: grid;
+  min-height: 180px;
+  place-items: center;
+  color: var(--xui-color-muted-foreground);
+  font-size: var(--xui-font-size-md);
+}
+
+.xui-modal-backdrop {
+  position: fixed;
+  inset: 0;
+  display: grid;
+  place-items: center;
+  background: rgba(24, 24, 27, 0.32);
+  padding: 16px;
+}
+
+.xui-modal {
+  width: min(720px, 100%);
+  max-height: calc(100vh - 32px);
+  overflow: auto;
+  border-radius: var(--xui-radius-lg);
+  background: var(--xui-color-card);
+  color: var(--xui-color-card-foreground);
+  box-shadow: var(--xui-shadow-dialog);
+}
+
+.xui-modal-header,
+.xui-modal-footer {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 14px 16px;
+  border-bottom: 1px solid var(--xui-color-border);
+}
+
+.xui-modal-footer {
+  border-top: 1px solid var(--xui-color-border);
+  border-bottom: 0;
+}
+
+.xui-modal-title {
+  margin: 0;
+  font-size: var(--xui-font-size-lg);
+  font-weight: 700;
+}
+
+.xui-form {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 12px;
+  padding: 16px;
+}
+
+.xui-field {
+  display: grid;
+  gap: 6px;
+}
+
+.xui-field-full {
+  grid-column: 1 / -1;
+}
+
+.xui-field label {
+  color: var(--xui-color-muted-foreground);
+  font-size: var(--xui-font-size-xs);
+  font-weight: 600;
+}
+
+.xui-checkbox {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  color: var(--xui-color-card-foreground);
+  font-size: var(--xui-font-size-sm);
+}
+
+@media (max-width: 760px) {
+  .xui-toolbar,
+  .xui-form {
+    grid-template-columns: 1fr;
+  }
+}
+`;
+const XPERT_REMOTE_UI_BOOTSTRAP = `
+(function () {
+  var CHANNEL = 'xpertai.remote_component'
+  var VERSION = 1
+  var TOKEN_MAP = {
+    fontFamily: '--xui-font-family',
+    colorBackground: '--xui-color-background',
+    colorForeground: '--xui-color-foreground',
+    colorCard: '--xui-color-card',
+    colorCardForeground: '--xui-color-card-foreground',
+    colorMuted: '--xui-color-muted',
+    colorMutedForeground: '--xui-color-muted-foreground',
+    colorBorder: '--xui-color-border',
+    colorInput: '--xui-color-input',
+    colorPrimary: '--xui-color-primary',
+    colorPrimaryForeground: '--xui-color-primary-foreground',
+    colorDestructive: '--xui-color-destructive',
+    colorDestructiveBackground: '--xui-color-destructive-background',
+    colorSuccess: '--xui-color-success',
+    colorSuccessBackground: '--xui-color-success-background',
+    radiusSm: '--xui-radius-sm',
+    radiusMd: '--xui-radius-md',
+    radiusLg: '--xui-radius-lg',
+    fontSizeXs: '--xui-font-size-xs',
+    fontSizeSm: '--xui-font-size-sm',
+    fontSizeMd: '--xui-font-size-md',
+    fontSizeLg: '--xui-font-size-lg',
+    fontSizeControl: '--xui-font-size-control',
+    fontSizeButton: '--xui-font-size-button',
+    fontSizeTable: '--xui-font-size-table',
+    controlHeight: '--xui-control-height',
+    buttonHeight: '--xui-button-height',
+    buttonHeightSm: '--xui-button-height-sm'
+  }
+
+  function isObject(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+  }
+
+  function applyTheme(theme) {
+    var mode = typeof theme === 'string' ? theme : isObject(theme) ? theme.mode : null
+    var tokens = isObject(theme) && isObject(theme.tokens) ? theme.tokens : {}
+    if (mode === 'dark') {
+      document.documentElement.dataset.theme = 'dark'
+      document.documentElement.style.colorScheme = 'dark'
+    } else {
+      document.documentElement.dataset.theme = 'light'
+      document.documentElement.style.colorScheme = 'light'
+    }
+    Object.keys(TOKEN_MAP).forEach(function (key) {
+      var value = tokens[key]
+      if (typeof value === 'string' && value.trim()) {
+        document.documentElement.style.setProperty(TOKEN_MAP[key], value.trim())
+      }
+    })
+  }
+
+  window.XpertRemoteUI = {
+    applyTheme: applyTheme
+  }
+
+  window.addEventListener('message', function (event) {
+    var message = event.data
+    if (
+      !isObject(message) ||
+      message.channel !== CHANNEL ||
+      message.protocolVersion !== VERSION ||
+      message.type !== 'init'
+    ) {
+      return
+    }
+    applyTheme(message.theme)
+  })
+})()
+`;
+function renderRemoteReactIframeHtml(options) {
+    var _options_lang, _options_appCss;
+    return `<!doctype html>
+<html lang="${escapeHtmlAttribute((_options_lang = options.lang) != null ? _options_lang : 'en')}">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>${escapeHtml(options.title)}</title>
+    <style>
+${XPERT_REMOTE_UI_CSS}
+${(_options_appCss = options.appCss) != null ? _options_appCss : ''}
+    </style>
+    <script>
+${options.reactUmd}
+    </script>
+    <script>
+${options.reactDomUmd}
+    </script>
+    <script>
+${XPERT_REMOTE_UI_BOOTSTRAP}
+    </script>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script>
+${options.appScript}
+    </script>
+  </body>
+</html>`;
+}
+function escapeHtml(value) {
+    return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#39;');
+}
+function escapeHtmlAttribute(value) {
+    return escapeHtml(value).replace(/`/g, '&#96;');
+}
+
 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, BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, BaseTool, BaseToolset, BuiltinToolset, CHAT_CHANNEL, CHAT_CHANNEL_TEXT_LIMITS, 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, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, FILE_STORAGE_PROVIDER, FILE_UPLOAD_TARGET_STRATEGY, 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, LLMUsage, LargeLanguageModel, ModelProvider, ORGANIZATION_METADATA_KEY, OpenAICompatibleReranker, PERMISSION_OPERATION_METADATA_KEY, PLUGIN_CONFIG_RESOLVER_TOKEN, PLUGIN_METADATA, PLUGIN_METADATA_KEY, 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, RETRIEVER_STRATEGY, RequestContext, RequestContextMiddleware, RequirePermissionOperation, RerankModel, RetrieverRegistry, RetrieverStrategy, SANDBOX_PROVIDER, SANDBOX_SHELL_TIMEOUT_LIMITS_SEC, SKILL_SOURCE_PROVIDER, SSOProviderRegistry, SSOProviderStrategyKey, SSO_BINDING_PERMISSION_SERVICE_TOKEN, SSO_PROVIDER, STRATEGY_META_KEY, SandboxProviderRegistry, SandboxProviderStrategy, SkillSourceProviderRegistry, SkillSourceProviderStrategy, Speech2TextChatModel, SpeechToTextModel, StrategyBus, 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, WrapWorkflowNodeExecutionCommand, XpFileSystem, XpertServerPlugin, als, appendSandboxMessage, buildSandboxTimeoutMessage, calcTokenUsage, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, defineAgentMessageType, defineChannelMessageType, downloadRemoteFile, formatSandboxTimeout, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, isRemoteFile, isSandboxBackend, isSandboxManagedServiceAdapter, isSandboxServiceProxyAdapter, isSandboxTerminalAdapter, isStructuredMessageType, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, resolveSandboxBackend, resolveSandboxExecutionOptions, resolveSandboxManagedServiceAdapter, resolveSandboxServiceProxyAdapter, resolveSandboxTerminalAdapter, runWithRequestContext, secondsToMilliseconds, 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, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, BaseTool, BaseToolset, BuiltinToolset, CHAT_CHANNEL, CHAT_CHANNEL_TEXT_LIMITS, 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, DefaultAgentMiddlewareRuntimeCapabilityRegistry, 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, KnowledgebaseRuntimeCapability, LLMUsage, LargeLanguageModel, ModelProvider, ORGANIZATION_METADATA_KEY, OpenAICompatibleReranker, PERMISSION_OPERATION_METADATA_KEY, PLUGIN_CONFIG_RESOLVER_TOKEN, PLUGIN_METADATA, PLUGIN_METADATA_KEY, 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, RETRIEVER_STRATEGY, RequestContext, RequestContextMiddleware, RequirePermissionOperation, RerankModel, RetrieverRegistry, RetrieverStrategy, SANDBOX_PROVIDER, SANDBOX_SHELL_TIMEOUT_LIMITS_SEC, SKILL_SOURCE_PROVIDER, SSOProviderRegistry, SSOProviderStrategyKey, SSO_BINDING_PERMISSION_SERVICE_TOKEN, SSO_PROVIDER, STRATEGY_META_KEY, SandboxProviderRegistry, SandboxProviderStrategy, SkillSourceProviderRegistry, SkillSourceProviderStrategy, Speech2TextChatModel, SpeechToTextModel, StrategyBus, 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, WrapWorkflowNodeExecutionCommand, XPERT_RUNTIME_CAPABILITIES_TOKEN, XpFileSystem, XpertServerPlugin, als, appendSandboxMessage, buildSandboxTimeoutMessage, calcTokenUsage, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, createRuntimeCapability, defineAgentMessageType, defineChannelMessageType, downloadRemoteFile, formatSandboxTimeout, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, isRemoteFile, isSandboxBackend, isSandboxManagedServiceAdapter, isSandboxServiceProxyAdapter, isSandboxTerminalAdapter, isStructuredMessageType, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, renderRemoteReactIframeHtml, resolveSandboxBackend, resolveSandboxExecutionOptions, resolveSandboxManagedServiceAdapter, resolveSandboxServiceProxyAdapter, resolveSandboxTerminalAdapter, runWithRequestContext, secondsToMilliseconds, sumTokenUsage };

package/package.json

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

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

@@ -0,0 +1,45 @@
+export type AgentMiddlewareAssistantTaskStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'interrupted' | 'unknown';
+export type AgentMiddlewareAssistantTaskFile = {
+    id?: string;
+    fileId?: string;
+    fileAssetId?: string;
+    storageFileId?: string;
+    originalName?: string;
+    name?: string;
+    mimeType?: string;
+    mimetype?: string;
+    size?: number;
+    role?: string;
+};
+export type AgentMiddlewareAssistantTaskInput = {
+    xpertId: string;
+    agentKey?: string;
+    conversationId?: string | null;
+    projectId?: string | null;
+    taskId?: string;
+    clientMessageId?: string;
+    prompt: string;
+    files?: AgentMiddlewareAssistantTaskFile[];
+    context?: Record<string, unknown>;
+};
+export type AgentMiddlewareAssistantTaskResult = {
+    status: AgentMiddlewareAssistantTaskStatus;
+    taskId?: string;
+    executionId?: string;
+    conversationId?: string;
+    threadId?: string;
+    errorMessage?: string;
+};
+export type AgentMiddlewareAssistantTaskStatusInput = {
+    taskId?: string;
+    executionId?: string;
+    conversationId?: string;
+    threadId?: string;
+    clientMessageId?: string;
+    xpertId?: string;
+};
+export interface AgentMiddlewareAssistantTaskApi {
+    startTask(input: AgentMiddlewareAssistantTaskInput): Promise<AgentMiddlewareAssistantTaskResult>;
+    getTaskStatus?(input: AgentMiddlewareAssistantTaskStatusInput): Promise<AgentMiddlewareAssistantTaskResult | null>;
+}
+export declare const AssistantTaskRuntimeCapability: import("../runtime-capability").RuntimeCapabilityKey<AgentMiddlewareAssistantTaskApi>;

package/src/lib/agent/middleware/capabilities/file.d.ts

@@ -0,0 +1,29 @@
+export type AgentMiddlewareFileReference = {
+    id?: string;
+    fileId?: string;
+    fileAssetId?: string;
+    storageFileId?: string;
+    name?: string;
+    originalName?: string;
+    mimeType?: string;
+    mimetype?: string;
+    size?: number;
+    url?: string;
+    fileUrl?: string;
+    previewUrl?: string;
+};
+export type AgentMiddlewareResolvedFile = {
+    id: string;
+    fileId?: string;
+    fileAssetId?: string;
+    storageFileId?: string;
+    name: string;
+    mimeType?: string;
+    size?: number;
+    url: string;
+    previewUrl?: string;
+};
+export interface AgentMiddlewareFileApi {
+    resolveFile(input: AgentMiddlewareFileReference): Promise<AgentMiddlewareResolvedFile | null>;
+}
+export declare const FileRuntimeCapability: import("../runtime-capability").RuntimeCapabilityKey<AgentMiddlewareFileApi>;

package/src/lib/agent/middleware/capabilities/index.d.ts

@@ -0,0 +1,3 @@
+export * from './knowledgebase';
+export * from './assistant-task';
+export * from './file';

package/src/lib/agent/middleware/capabilities/knowledgebase.d.ts

@@ -0,0 +1,70 @@
+import { JSONValue } from '@xpert-ai/contracts';
+export type AgentMiddlewareKnowledgebaseRetrievalMode = 'vector' | 'graph' | 'hybrid';
+export type AgentMiddlewareKnowledgebaseMetadata = Record<string, JSONValue>;
+export type AgentMiddlewareKnowledgebaseRetrievalSettings = {
+    mode?: AgentMiddlewareKnowledgebaseRetrievalMode;
+    neighborHops?: number;
+    entityTopK?: number;
+    communityTopK?: number;
+    graphWeight?: number;
+};
+export type AgentMiddlewareKnowledgebaseSearchInput = {
+    tenantId?: string;
+    organizationId?: string;
+    knowledgebaseIds: string[];
+    query: string;
+    k?: number;
+    score?: number;
+    filter?: AgentMiddlewareKnowledgebaseMetadata;
+    retrieval?: AgentMiddlewareKnowledgebaseRetrievalSettings;
+    source: string;
+    requestId?: string;
+};
+export type AgentMiddlewareKnowledgebaseDocument = {
+    pageContent: string;
+    metadata?: Record<string, unknown>;
+};
+export type AgentMiddlewareKnowledgebaseListInput = {
+    workspaceId?: string | null;
+    published?: boolean;
+    limit?: number;
+};
+export type AgentMiddlewareKnowledgebaseListItem = {
+    id: string;
+    name?: string;
+    description?: string | null;
+    type?: string | null;
+    status?: string | null;
+    permission?: string | null;
+    workspaceId?: string | null;
+    documentNum?: number | null;
+    chunkNum?: number | null;
+    graphRag?: {
+        enabled?: boolean;
+        [key: string]: JSONValue | undefined;
+    } | null;
+    graphStatus?: string | null;
+};
+export type AgentMiddlewareKnowledgebaseWriteChunkInput = {
+    xpertId: string;
+    agentKey: string;
+    knowledgebaseIds: string[];
+    knowledgebaseId: string;
+    text: string;
+    title?: string;
+    metadata?: AgentMiddlewareKnowledgebaseMetadata;
+    writeKey: string;
+    executionId?: string;
+    threadId?: string;
+};
+export type AgentMiddlewareKnowledgebaseWriteChunkResult = {
+    status?: 'created' | 'skipped';
+    chunkId?: string;
+    message?: string;
+};
+export interface AgentMiddlewareKnowledgebaseApi {
+    list(input: AgentMiddlewareKnowledgebaseListInput): Promise<AgentMiddlewareKnowledgebaseListItem[]>;
+    search(input: AgentMiddlewareKnowledgebaseSearchInput): Promise<AgentMiddlewareKnowledgebaseDocument[]>;
+    writeChunk(input: AgentMiddlewareKnowledgebaseWriteChunkInput): Promise<AgentMiddlewareKnowledgebaseWriteChunkResult>;
+}
+export declare const KnowledgebaseRuntimeCapability: import("../runtime-capability").RuntimeCapabilityKey<AgentMiddlewareKnowledgebaseApi>;