@xpert-ai/plugin-sdk 3.9.9 → 4.0.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @xpert-ai/plugin-sdk
 
+## 4.0.0
+
+### Minor Changes
+
+- df9d7e2: agentic app
+
+### Patch Changes
+
+- Updated dependencies [df9d7e2]
+  - @xpert-ai/contracts@3.10.0
+
 ## 3.9.9
 
 ### Patch Changes

package/README.md

@@ -15,3 +15,7 @@ Run `nx test plugin-sdk` to execute the unit tests via [Jest](https://jestjs.io)
 ## Permissions
 
 [插件权限设计指南](./PERMISSIONS.md)
+
+## View extensions
+
+[View Extension Protocol](./docs/view-extension-protocol.md)

package/index.cjs.js

@@ -359,22 +359,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 } = jsonwebtoken.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 jsonwebtoken.JsonWebTokenError) {
-                    return false;
-                } else {
-                    throw error;
+                    if (role) {
+                        return roles.includes(role);
+                    }
+                } catch (error) {
+                    if (!(error instanceof jsonwebtoken.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 common.HttpException('Unauthorized', common.HttpStatus.UNAUTHORIZED);
@@ -2637,6 +2640,52 @@ exports.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) {
@@ -3972,6 +4021,420 @@ exports.ViewExtensionProviderRegistry = __decorate([
     ])
 ], exports.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';
 
 exports.ACCOUNT_BINDING_PERMISSION_SERVICE_TOKEN = ACCOUNT_BINDING_PERMISSION_SERVICE_TOKEN;
@@ -3984,6 +4447,7 @@ exports.ANALYTICS_PERMISSION_SERVICE_TOKEN = ANALYTICS_PERMISSION_SERVICE_TOKEN;
 exports.AdapterDataSourceStrategy = AdapterDataSourceStrategy;
 exports.AgentMiddlewareStrategy = AgentMiddlewareStrategy;
 exports.AiModelNotFoundException = AiModelNotFoundException;
+exports.AssistantTaskRuntimeCapability = AssistantTaskRuntimeCapability;
 exports.BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN = BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN;
 exports.BaseHTTPQueryRunner = BaseHTTPQueryRunner;
 exports.BaseQueryRunner = BaseQueryRunner;
@@ -4016,10 +4480,12 @@ exports.DEFAULT_SANDBOX_SHELL_TIMEOUT_SEC = DEFAULT_SANDBOX_SHELL_TIMEOUT_SEC;
 exports.DOCUMENT_SOURCE_STRATEGY = DOCUMENT_SOURCE_STRATEGY;
 exports.DOCUMENT_TRANSFORMER_STRATEGY = DOCUMENT_TRANSFORMER_STRATEGY;
 exports.DataSourceStrategy = DataSourceStrategy;
+exports.DefaultAgentMiddlewareRuntimeCapabilityRegistry = DefaultAgentMiddlewareRuntimeCapabilityRegistry;
 exports.DocumentSourceStrategy = DocumentSourceStrategy;
 exports.DocumentTransformerStrategy = DocumentTransformerStrategy;
 exports.FILE_STORAGE_PROVIDER = FILE_STORAGE_PROVIDER;
 exports.FILE_UPLOAD_TARGET_STRATEGY = FILE_UPLOAD_TARGET_STRATEGY;
+exports.FileRuntimeCapability = FileRuntimeCapability;
 exports.FileStorageProvider = FileStorageProvider;
 exports.FileUploadTargetStrategy = FileUploadTargetStrategy;
 exports.GLOBAL_ORGANIZATION_SCOPE = GLOBAL_ORGANIZATION_SCOPE;
@@ -4036,6 +4502,7 @@ exports.JUMP_TO_TARGETS = JUMP_TO_TARGETS;
 exports.JsonSchemaValidator = JsonSchemaValidator;
 exports.KNOWLEDGE_STRATEGY = KNOWLEDGE_STRATEGY;
 exports.KnowledgeStrategyKey = KnowledgeStrategyKey;
+exports.KnowledgebaseRuntimeCapability = KnowledgebaseRuntimeCapability;
 exports.LLMUsage = LLMUsage;
 exports.LargeLanguageModel = LargeLanguageModel;
 exports.ORGANIZATION_METADATA_KEY = ORGANIZATION_METADATA_KEY;
@@ -4083,6 +4550,7 @@ exports.WORKFLOW_TRIGGER_STRATEGY = WORKFLOW_TRIGGER_STRATEGY;
 exports.WorkflowNodeStrategy = WorkflowNodeStrategy;
 exports.WorkflowTriggerStrategy = WorkflowTriggerStrategy;
 exports.WrapWorkflowNodeExecutionCommand = WrapWorkflowNodeExecutionCommand;
+exports.XPERT_RUNTIME_CAPABILITIES_TOKEN = XPERT_RUNTIME_CAPABILITIES_TOKEN;
 exports.XpFileSystem = XpFileSystem;
 exports.XpertServerPlugin = XpertServerPlugin;
 exports.als = als;
@@ -4093,6 +4561,7 @@ exports.chunkText = chunkText;
 exports.countTokensSafe = countTokensSafe;
 exports.createI18nInstance = createI18nInstance;
 exports.createPluginLogger = createPluginLogger;
+exports.createRuntimeCapability = createRuntimeCapability;
 exports.defineAgentMessageType = defineAgentMessageType;
 exports.defineChannelMessageType = defineChannelMessageType;
 exports.downloadRemoteFile = downloadRemoteFile;
@@ -4114,6 +4583,7 @@ exports.loadYamlFile = loadYamlFile;
 exports.mergeCredentials = mergeCredentials;
 exports.mergeParentChildChunks = mergeParentChildChunks;
 exports.normalizeContextSize = normalizeContextSize;
+exports.renderRemoteReactIframeHtml = renderRemoteReactIframeHtml;
 exports.resolveSandboxBackend = resolveSandboxBackend;
 exports.resolveSandboxExecutionOptions = resolveSandboxExecutionOptions;
 exports.resolveSandboxManagedServiceAdapter = resolveSandboxManagedServiceAdapter;