@xpert-ai/plugin-sdk 3.15.18 → 3.16.1

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @xpert-ai/plugin-sdk
 
+## 3.16.1
+
+### Patch Changes
+
+- 57721a6: Normalize missing assistant roles in OpenAI-compatible completion responses.
+
+## 3.16.0
+
+### Minor Changes
+
+- b800da5: v3.16
+
+### Patch Changes
+
+- Updated dependencies [b800da5]
+  - @xpert-ai/contracts@3.16.0
+
 ## 3.15.18
 
 ### Patch Changes

package/index.cjs.js

@@ -1203,10 +1203,6 @@ const PLUGIN_CONFIG_RESOLVER_TOKEN = 'XPERT_PLUGIN_CONFIG_RESOLVER';
  * System token for resolving integration read service from plugin context.
  */ const INTEGRATION_PERMISSION_SERVICE_TOKEN = 'XPERT_PLUGIN_INTEGRATION_PERMISSION_SERVICE';
 
-/**
- * System token for resolving analytics permission service from plugin context.
- */ const ANALYTICS_PERMISSION_SERVICE_TOKEN = 'XPERT_PLUGIN_ANALYTICS_PERMISSION_SERVICE';
-
 const PERMISSION_OPERATION_METADATA_KEY = 'XPERT_PLUGIN_PERMISSION_OPERATION';
 function RequirePermissionOperation(permissionType, operation) {
     return (_target, _propertyKey, descriptor)=>{
@@ -1264,6 +1260,14 @@ function getRequiredPermissionOperation(method, permissionType) {
  * Internal system token used by core to expose the speech-to-text bridge.
  */ const SPEECH_TO_TEXT_SERVICE_TOKEN = 'XPERT_SPEECH_TO_TEXT_SERVICE';
 
+const VIDEO_GENERATOR_FAMILIES = [
+    'seedance',
+    'veo',
+    'kling'
+];
+const VIDEO_GENERATION_PERMISSION_SERVICE_TOKEN = 'XPERT_PLUGIN_VIDEO_GENERATION_PERMISSION_SERVICE';
+const VIDEO_GENERATION_SERVICE_TOKEN = 'XPERT_VIDEO_GENERATION_SERVICE';
+
 async function createI18nInstance(pluginDir, language) {
     const instance = i18next.createInstance();
     const i18nDir = path.join(pluginDir, 'i18n');
@@ -2441,17 +2445,15 @@ class LargeLanguageModel extends AIModel {
                     this.startedAt = performance.now();
                 },
                 handleLLMEnd: (output)=>{
-                    var _output_llmOutput, _output_llmOutput1;
-                    var _output_llmOutput_tokenUsage, _ref;
-                    const tokenUsage = (_ref = (_output_llmOutput_tokenUsage = (_output_llmOutput = output.llmOutput) == null ? void 0 : _output_llmOutput.tokenUsage) != null ? _output_llmOutput_tokenUsage : (_output_llmOutput1 = output.llmOutput) == null ? void 0 : _output_llmOutput1.estimatedTokenUsage) != null ? _ref : calcTokenUsage(output);
+                    const tokenUsage = resolveTokenUsage(output);
                     if (handleLLMTokens) {
-                        var _output_llmOutput2;
-                        var _output_llmOutput_totalTokens;
+                        const usage = this.calcResponseUsage(model, credentials, tokenUsage.promptTokens, tokenUsage.completionTokens);
+                        usage.totalTokens = tokenUsage.totalTokens;
                         handleLLMTokens({
                             copilot,
                             model,
-                            usage: this.calcResponseUsage(model, credentials, tokenUsage.promptTokens, tokenUsage.completionTokens),
-                            tokenUsed: (_output_llmOutput_totalTokens = (_output_llmOutput2 = output.llmOutput) == null ? void 0 : _output_llmOutput2.totalTokens) != null ? _output_llmOutput_totalTokens : sumTokenUsage(output)
+                            usage,
+                            tokenUsed: tokenUsage.totalTokens
                         });
                     }
                 }
@@ -2611,6 +2613,41 @@ function calcTokenUsage(output) {
     });
     return tokenUsage;
 }
+function resolveTokenUsage(output) {
+    var _output_llmOutput, _output_llmOutput1, _output_llmOutput2;
+    var _normalizeTokenUsage, _ref, _ref1, _ref2;
+    return (_ref2 = (_ref1 = (_ref = (_normalizeTokenUsage = normalizeTokenUsage(calcTokenUsage(output))) != null ? _normalizeTokenUsage : normalizeTokenUsage((_output_llmOutput = output.llmOutput) == null ? void 0 : _output_llmOutput['tokenUsage'])) != null ? _ref : normalizeTokenUsage((_output_llmOutput1 = output.llmOutput) == null ? void 0 : _output_llmOutput1['estimatedTokenUsage'])) != null ? _ref1 : normalizeTokenUsage({
+        totalTokens: (_output_llmOutput2 = output.llmOutput) == null ? void 0 : _output_llmOutput2['totalTokens']
+    })) != null ? _ref2 : {
+        promptTokens: 0,
+        completionTokens: 0,
+        totalTokens: 0
+    };
+}
+function normalizeTokenUsage(candidate) {
+    if (!candidate) {
+        return null;
+    }
+    if (!isValidTokenCount(candidate.promptTokens) || !isValidTokenCount(candidate.completionTokens) || !isValidTokenCount(candidate.totalTokens)) {
+        return null;
+    }
+    var _candidate_promptTokens;
+    const promptTokens = (_candidate_promptTokens = candidate.promptTokens) != null ? _candidate_promptTokens : 0;
+    var _candidate_completionTokens;
+    const completionTokens = (_candidate_completionTokens = candidate.completionTokens) != null ? _candidate_completionTokens : 0;
+    const totalTokens = candidate.totalTokens || promptTokens + completionTokens;
+    if (promptTokens === 0 && completionTokens === 0 && totalTokens === 0) {
+        return null;
+    }
+    return {
+        promptTokens,
+        completionTokens,
+        totalTokens
+    };
+}
+function isValidTokenCount(value) {
+    return value === undefined || Number.isFinite(value) && value >= 0;
+}
 /**
  * @deprecated use calcTokenUsage
  */ function sumTokenUsage(output) {
@@ -2642,7 +2679,12 @@ function calcTokenUsage(output) {
      *
      */ _convertCompletionsDeltaToBaseMessageChunk(// eslint-disable-next-line @typescript-eslint/no-explicit-any
     delta, rawResponse, defaultRole) {
-        const messageChunk = super._convertCompletionsDeltaToBaseMessageChunk(delta, rawResponse, defaultRole);
+        // Some OpenAI-compatible providers omit `delta.role` on the final usage
+        // chunk. Without a role, LangChain creates a generic ChatMessageChunk;
+        // persisting that chunk makes the next request contain `role: undefined`.
+        // Treat role-less completion deltas as assistant output so they remain
+        // valid both in the current stream and when the conversation is resumed.
+        const messageChunk = super._convertCompletionsDeltaToBaseMessageChunk(delta, rawResponse, defaultRole != null ? defaultRole : 'assistant');
         if (delta['content'] === '<think>') {
             this.thinking = true;
             messageChunk.content = '';
@@ -2658,7 +2700,14 @@ function calcTokenUsage(output) {
         return messageChunk;
     }
     _convertCompletionsMessageToBaseMessage(message, rawResponse) {
-        const langChainMessage = super._convertCompletionsMessageToBaseMessage(message, rawResponse);
+        var _message_role;
+        // Some compatible providers also omit the role on non-stream responses.
+        // Normalize that response before LangChain falls back to a generic
+        // message with role `unknown`.
+        const normalizedMessage = collaborationClient._extends({}, message, {
+            role: (_message_role = message.role) != null ? _message_role : 'assistant'
+        });
+        const langChainMessage = super._convertCompletionsMessageToBaseMessage(normalizedMessage, rawResponse);
         console.log(langChainMessage.content);
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         if (message.reasoning_content) {
@@ -2851,6 +2900,10 @@ const KnowledgebaseDocumentsRuntimeCapability = createRuntimeCapability('platfor
     description: 'Upload, import, create, process, inspect, and delete persistent knowledgebase documents.'
 });
 
+const ActorTokenRuntimeCapability = createRuntimeCapability('platform.actor-token', {
+    description: 'Mint a short-lived host-issued actor bearer token for outbound API calls.'
+});
+
 const ArtifactsRuntimeCapability = createRuntimeCapability('platform.artifacts', {
     description: 'Create, version, preview, download, share, archive, and delete platform-managed plugin and Agent artifacts.'
 });
@@ -4475,16 +4528,31 @@ const XPERT_REMOTE_UI_CSS = `
   --xui-color-foreground: #18181b;
   --xui-color-card: #fff;
   --xui-color-card-foreground: #18181b;
+  --xui-color-popover: var(--xui-color-card);
+  --xui-color-popover-foreground: var(--xui-color-card-foreground);
+  --xui-color-secondary: #f4f4f5;
+  --xui-color-secondary-foreground: #18181b;
   --xui-color-muted: #f4f4f5;
   --xui-color-muted-foreground: #71717a;
+  --xui-color-accent: #f4f4f5;
+  --xui-color-accent-foreground: #18181b;
   --xui-color-border: #e4e4e7;
   --xui-color-input: #d4d4d8;
   --xui-color-primary: #18181b;
   --xui-color-primary-foreground: #fff;
+  --xui-color-ring: var(--xui-color-primary);
   --xui-color-destructive: #dc2626;
+  --xui-color-destructive-foreground: #fff;
   --xui-color-destructive-background: #fef2f2;
   --xui-color-success: #047857;
   --xui-color-success-background: #ecfdf5;
+  --xui-color-warning: #b45309;
+  --xui-color-info: #2563eb;
+  --xui-color-chart-1: var(--xui-color-primary);
+  --xui-color-chart-2: var(--xui-color-success);
+  --xui-color-chart-3: var(--xui-color-warning);
+  --xui-color-chart-4: var(--xui-color-destructive);
+  --xui-color-chart-5: #7c3aed;
   --xui-radius-sm: 6px;
   --xui-radius-md: 8px;
   --xui-radius-lg: 10px;
@@ -4779,16 +4847,31 @@ const XPERT_REMOTE_UI_BOOTSTRAP = `
     colorForeground: '--xui-color-foreground',
     colorCard: '--xui-color-card',
     colorCardForeground: '--xui-color-card-foreground',
+    colorPopover: '--xui-color-popover',
+    colorPopoverForeground: '--xui-color-popover-foreground',
+    colorSecondary: '--xui-color-secondary',
+    colorSecondaryForeground: '--xui-color-secondary-foreground',
     colorMuted: '--xui-color-muted',
     colorMutedForeground: '--xui-color-muted-foreground',
+    colorAccent: '--xui-color-accent',
+    colorAccentForeground: '--xui-color-accent-foreground',
     colorBorder: '--xui-color-border',
     colorInput: '--xui-color-input',
     colorPrimary: '--xui-color-primary',
     colorPrimaryForeground: '--xui-color-primary-foreground',
+    colorRing: '--xui-color-ring',
     colorDestructive: '--xui-color-destructive',
+    colorDestructiveForeground: '--xui-color-destructive-foreground',
     colorDestructiveBackground: '--xui-color-destructive-background',
     colorSuccess: '--xui-color-success',
     colorSuccessBackground: '--xui-color-success-background',
+    colorWarning: '--xui-color-warning',
+    colorInfo: '--xui-color-info',
+    colorChart1: '--xui-color-chart-1',
+    colorChart2: '--xui-color-chart-2',
+    colorChart3: '--xui-color-chart-3',
+    colorChart4: '--xui-color-chart-4',
+    colorChart5: '--xui-color-chart-5',
     radiusSm: '--xui-radius-sm',
     radiusMd: '--xui-radius-md',
     radiusLg: '--xui-radius-lg',
@@ -4956,7 +5039,7 @@ exports.AGENT_MIDDLEWARE_STRATEGY = AGENT_MIDDLEWARE_STRATEGY;
 exports.AIModelProviderNotFoundException = AIModelProviderNotFoundException;
 exports.AIModelProviderStrategy = AIModelProviderStrategy;
 exports.AI_MODEL_PROVIDER = AI_MODEL_PROVIDER;
-exports.ANALYTICS_PERMISSION_SERVICE_TOKEN = ANALYTICS_PERMISSION_SERVICE_TOKEN;
+exports.ActorTokenRuntimeCapability = ActorTokenRuntimeCapability;
 exports.AdapterDataSourceStrategy = AdapterDataSourceStrategy;
 exports.AgentMiddlewareStrategy = AgentMiddlewareStrategy;
 exports.AiModelNotFoundException = AiModelNotFoundException;
@@ -5086,6 +5169,9 @@ exports.TextToSpeechModel = TextToSpeechModel;
 exports.ToolsetStrategy = ToolsetStrategy;
 exports.USER_PERMISSION_SERVICE_TOKEN = USER_PERMISSION_SERVICE_TOKEN;
 exports.VECTOR_STORE_STRATEGY = VECTOR_STORE_STRATEGY;
+exports.VIDEO_GENERATION_PERMISSION_SERVICE_TOKEN = VIDEO_GENERATION_PERMISSION_SERVICE_TOKEN;
+exports.VIDEO_GENERATION_SERVICE_TOKEN = VIDEO_GENERATION_SERVICE_TOKEN;
+exports.VIDEO_GENERATOR_FAMILIES = VIDEO_GENERATOR_FAMILIES;
 exports.VIEW_EXTENSION_CACHE_SERVICE_TOKEN = VIEW_EXTENSION_CACHE_SERVICE_TOKEN;
 exports.VIEW_EXTENSION_PROVIDER = VIEW_EXTENSION_PROVIDER;
 exports.VectorStoreStrategy = VectorStoreStrategy;
@@ -5149,6 +5235,7 @@ exports.resolveSandboxServiceProxyAdapter = resolveSandboxServiceProxyAdapter;
 exports.resolveSandboxTerminalAdapter = resolveSandboxTerminalAdapter;
 exports.resolveStrategyMetadataTarget = resolveStrategyMetadataTarget;
 exports.resolveTenantGlobalScopeKey = resolveTenantGlobalScopeKey;
+exports.resolveTokenUsage = resolveTokenUsage;
 exports.runWithRequestContext = runWithRequestContext;
 exports.secondsToMilliseconds = secondsToMilliseconds;
 exports.setDefaultTenantId = setDefaultTenantId;

package/index.esm.js

@@ -1185,10 +1185,6 @@ const PLUGIN_CONFIG_RESOLVER_TOKEN = 'XPERT_PLUGIN_CONFIG_RESOLVER';
  * System token for resolving integration read service from plugin context.
  */ const INTEGRATION_PERMISSION_SERVICE_TOKEN = 'XPERT_PLUGIN_INTEGRATION_PERMISSION_SERVICE';
 
-/**
- * System token for resolving analytics permission service from plugin context.
- */ const ANALYTICS_PERMISSION_SERVICE_TOKEN = 'XPERT_PLUGIN_ANALYTICS_PERMISSION_SERVICE';
-
 const PERMISSION_OPERATION_METADATA_KEY = 'XPERT_PLUGIN_PERMISSION_OPERATION';
 function RequirePermissionOperation(permissionType, operation) {
     return (_target, _propertyKey, descriptor)=>{
@@ -1246,6 +1242,14 @@ function getRequiredPermissionOperation(method, permissionType) {
  * Internal system token used by core to expose the speech-to-text bridge.
  */ const SPEECH_TO_TEXT_SERVICE_TOKEN = 'XPERT_SPEECH_TO_TEXT_SERVICE';
 
+const VIDEO_GENERATOR_FAMILIES = [
+    'seedance',
+    'veo',
+    'kling'
+];
+const VIDEO_GENERATION_PERMISSION_SERVICE_TOKEN = 'XPERT_PLUGIN_VIDEO_GENERATION_PERMISSION_SERVICE';
+const VIDEO_GENERATION_SERVICE_TOKEN = 'XPERT_VIDEO_GENERATION_SERVICE';
+
 async function createI18nInstance(pluginDir, language) {
     const instance = createInstance();
     const i18nDir = path__default.join(pluginDir, 'i18n');
@@ -2423,17 +2427,15 @@ class LargeLanguageModel extends AIModel {
                     this.startedAt = performance.now();
                 },
                 handleLLMEnd: (output)=>{
-                    var _output_llmOutput, _output_llmOutput1;
-                    var _output_llmOutput_tokenUsage, _ref;
-                    const tokenUsage = (_ref = (_output_llmOutput_tokenUsage = (_output_llmOutput = output.llmOutput) == null ? void 0 : _output_llmOutput.tokenUsage) != null ? _output_llmOutput_tokenUsage : (_output_llmOutput1 = output.llmOutput) == null ? void 0 : _output_llmOutput1.estimatedTokenUsage) != null ? _ref : calcTokenUsage(output);
+                    const tokenUsage = resolveTokenUsage(output);
                     if (handleLLMTokens) {
-                        var _output_llmOutput2;
-                        var _output_llmOutput_totalTokens;
+                        const usage = this.calcResponseUsage(model, credentials, tokenUsage.promptTokens, tokenUsage.completionTokens);
+                        usage.totalTokens = tokenUsage.totalTokens;
                         handleLLMTokens({
                             copilot,
                             model,
-                            usage: this.calcResponseUsage(model, credentials, tokenUsage.promptTokens, tokenUsage.completionTokens),
-                            tokenUsed: (_output_llmOutput_totalTokens = (_output_llmOutput2 = output.llmOutput) == null ? void 0 : _output_llmOutput2.totalTokens) != null ? _output_llmOutput_totalTokens : sumTokenUsage(output)
+                            usage,
+                            tokenUsed: tokenUsage.totalTokens
                         });
                     }
                 }
@@ -2593,6 +2595,41 @@ function calcTokenUsage(output) {
     });
     return tokenUsage;
 }
+function resolveTokenUsage(output) {
+    var _output_llmOutput, _output_llmOutput1, _output_llmOutput2;
+    var _normalizeTokenUsage, _ref, _ref1, _ref2;
+    return (_ref2 = (_ref1 = (_ref = (_normalizeTokenUsage = normalizeTokenUsage(calcTokenUsage(output))) != null ? _normalizeTokenUsage : normalizeTokenUsage((_output_llmOutput = output.llmOutput) == null ? void 0 : _output_llmOutput['tokenUsage'])) != null ? _ref : normalizeTokenUsage((_output_llmOutput1 = output.llmOutput) == null ? void 0 : _output_llmOutput1['estimatedTokenUsage'])) != null ? _ref1 : normalizeTokenUsage({
+        totalTokens: (_output_llmOutput2 = output.llmOutput) == null ? void 0 : _output_llmOutput2['totalTokens']
+    })) != null ? _ref2 : {
+        promptTokens: 0,
+        completionTokens: 0,
+        totalTokens: 0
+    };
+}
+function normalizeTokenUsage(candidate) {
+    if (!candidate) {
+        return null;
+    }
+    if (!isValidTokenCount(candidate.promptTokens) || !isValidTokenCount(candidate.completionTokens) || !isValidTokenCount(candidate.totalTokens)) {
+        return null;
+    }
+    var _candidate_promptTokens;
+    const promptTokens = (_candidate_promptTokens = candidate.promptTokens) != null ? _candidate_promptTokens : 0;
+    var _candidate_completionTokens;
+    const completionTokens = (_candidate_completionTokens = candidate.completionTokens) != null ? _candidate_completionTokens : 0;
+    const totalTokens = candidate.totalTokens || promptTokens + completionTokens;
+    if (promptTokens === 0 && completionTokens === 0 && totalTokens === 0) {
+        return null;
+    }
+    return {
+        promptTokens,
+        completionTokens,
+        totalTokens
+    };
+}
+function isValidTokenCount(value) {
+    return value === undefined || Number.isFinite(value) && value >= 0;
+}
 /**
  * @deprecated use calcTokenUsage
  */ function sumTokenUsage(output) {
@@ -2624,7 +2661,12 @@ function calcTokenUsage(output) {
      *
      */ _convertCompletionsDeltaToBaseMessageChunk(// eslint-disable-next-line @typescript-eslint/no-explicit-any
     delta, rawResponse, defaultRole) {
-        const messageChunk = super._convertCompletionsDeltaToBaseMessageChunk(delta, rawResponse, defaultRole);
+        // Some OpenAI-compatible providers omit `delta.role` on the final usage
+        // chunk. Without a role, LangChain creates a generic ChatMessageChunk;
+        // persisting that chunk makes the next request contain `role: undefined`.
+        // Treat role-less completion deltas as assistant output so they remain
+        // valid both in the current stream and when the conversation is resumed.
+        const messageChunk = super._convertCompletionsDeltaToBaseMessageChunk(delta, rawResponse, defaultRole != null ? defaultRole : 'assistant');
         if (delta['content'] === '<think>') {
             this.thinking = true;
             messageChunk.content = '';
@@ -2640,7 +2682,14 @@ function calcTokenUsage(output) {
         return messageChunk;
     }
     _convertCompletionsMessageToBaseMessage(message, rawResponse) {
-        const langChainMessage = super._convertCompletionsMessageToBaseMessage(message, rawResponse);
+        var _message_role;
+        // Some compatible providers also omit the role on non-stream responses.
+        // Normalize that response before LangChain falls back to a generic
+        // message with role `unknown`.
+        const normalizedMessage = _extends({}, message, {
+            role: (_message_role = message.role) != null ? _message_role : 'assistant'
+        });
+        const langChainMessage = super._convertCompletionsMessageToBaseMessage(normalizedMessage, rawResponse);
         console.log(langChainMessage.content);
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         if (message.reasoning_content) {
@@ -2833,6 +2882,10 @@ const KnowledgebaseDocumentsRuntimeCapability = createRuntimeCapability('platfor
     description: 'Upload, import, create, process, inspect, and delete persistent knowledgebase documents.'
 });
 
+const ActorTokenRuntimeCapability = createRuntimeCapability('platform.actor-token', {
+    description: 'Mint a short-lived host-issued actor bearer token for outbound API calls.'
+});
+
 const ArtifactsRuntimeCapability = createRuntimeCapability('platform.artifacts', {
     description: 'Create, version, preview, download, share, archive, and delete platform-managed plugin and Agent artifacts.'
 });
@@ -4457,16 +4510,31 @@ const XPERT_REMOTE_UI_CSS = `
   --xui-color-foreground: #18181b;
   --xui-color-card: #fff;
   --xui-color-card-foreground: #18181b;
+  --xui-color-popover: var(--xui-color-card);
+  --xui-color-popover-foreground: var(--xui-color-card-foreground);
+  --xui-color-secondary: #f4f4f5;
+  --xui-color-secondary-foreground: #18181b;
   --xui-color-muted: #f4f4f5;
   --xui-color-muted-foreground: #71717a;
+  --xui-color-accent: #f4f4f5;
+  --xui-color-accent-foreground: #18181b;
   --xui-color-border: #e4e4e7;
   --xui-color-input: #d4d4d8;
   --xui-color-primary: #18181b;
   --xui-color-primary-foreground: #fff;
+  --xui-color-ring: var(--xui-color-primary);
   --xui-color-destructive: #dc2626;
+  --xui-color-destructive-foreground: #fff;
   --xui-color-destructive-background: #fef2f2;
   --xui-color-success: #047857;
   --xui-color-success-background: #ecfdf5;
+  --xui-color-warning: #b45309;
+  --xui-color-info: #2563eb;
+  --xui-color-chart-1: var(--xui-color-primary);
+  --xui-color-chart-2: var(--xui-color-success);
+  --xui-color-chart-3: var(--xui-color-warning);
+  --xui-color-chart-4: var(--xui-color-destructive);
+  --xui-color-chart-5: #7c3aed;
   --xui-radius-sm: 6px;
   --xui-radius-md: 8px;
   --xui-radius-lg: 10px;
@@ -4761,16 +4829,31 @@ const XPERT_REMOTE_UI_BOOTSTRAP = `
     colorForeground: '--xui-color-foreground',
     colorCard: '--xui-color-card',
     colorCardForeground: '--xui-color-card-foreground',
+    colorPopover: '--xui-color-popover',
+    colorPopoverForeground: '--xui-color-popover-foreground',
+    colorSecondary: '--xui-color-secondary',
+    colorSecondaryForeground: '--xui-color-secondary-foreground',
     colorMuted: '--xui-color-muted',
     colorMutedForeground: '--xui-color-muted-foreground',
+    colorAccent: '--xui-color-accent',
+    colorAccentForeground: '--xui-color-accent-foreground',
     colorBorder: '--xui-color-border',
     colorInput: '--xui-color-input',
     colorPrimary: '--xui-color-primary',
     colorPrimaryForeground: '--xui-color-primary-foreground',
+    colorRing: '--xui-color-ring',
     colorDestructive: '--xui-color-destructive',
+    colorDestructiveForeground: '--xui-color-destructive-foreground',
     colorDestructiveBackground: '--xui-color-destructive-background',
     colorSuccess: '--xui-color-success',
     colorSuccessBackground: '--xui-color-success-background',
+    colorWarning: '--xui-color-warning',
+    colorInfo: '--xui-color-info',
+    colorChart1: '--xui-color-chart-1',
+    colorChart2: '--xui-color-chart-2',
+    colorChart3: '--xui-color-chart-3',
+    colorChart4: '--xui-color-chart-4',
+    colorChart5: '--xui-color-chart-5',
     radiusSm: '--xui-radius-sm',
     radiusMd: '--xui-radius-md',
     radiusLg: '--xui-radius-lg',
@@ -4915,4 +4998,4 @@ CollaborationDocumentProviderRegistry = __decorate([
     ])
 ], CollaborationDocumentProviderRegistry);
 
-export { ACCOUNT_BINDING_PERMISSION_SERVICE_TOKEN, AGENT_CHAT_DISPATCH_ERROR_STEER_TARGET_NOT_RUNNING, AGENT_CHAT_DISPATCH_MESSAGE_TYPE, AGENT_MIDDLEWARE_STRATEGY, AIModelProviderNotFoundException, AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, ANALYTICS_PERMISSION_SERVICE_TOKEN, AdapterDataSourceStrategy, AgentMiddlewareRegistry, AgentMiddlewareStrategy, AiModelNotFoundException, ArtifactsRuntimeCapability, AssistantTaskRuntimeCapability, BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN, BUILTIN_GLOBAL_SCOPE, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, BaseTool, BaseToolset, BuiltinToolset, CHAT_CHANNEL, CHAT_CHANNEL_TEXT_LIMITS, COLLABORATION_DOCUMENT_PROVIDER, CONNECTION_COMMAND_ROUTER_TOKEN, CONNECTOR_STRATEGY, CancelConversationCommand, ChatChannel, ChatChannelRegistry, ChatOAICompatReasoningModel, CollaborationDocumentProvider, CollaborationDocumentProviderRegistry, CollaborationRuntimeCapability, CommonParameterRules, ConnectorRuntimeCapability, ConnectorStrategyKey, ConnectorStrategyRegistry, CreateModelClientCommand, CredentialsValidateFailedError, DATASOURCE_STRATEGY, DBCreateTableMode, DBProtocolEnum, DBSyntaxEnum, DBTableAction, DBTableDataAction, DEFAULT_EXECUTION_CONFIG, DEFAULT_SANDBOX_EXECUTION_MAX_OUTPUT_BYTES, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_SEC, DEFAULT_SANDBOX_FILE_SEARCH_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_SEC, DEFAULT_SANDBOX_SHELL_EXECUTION_OPTIONS, DEFAULT_SANDBOX_SHELL_TIMEOUT_MS, DEFAULT_SANDBOX_SHELL_TIMEOUT_SEC, DOCUMENT_SOURCE_STRATEGY, DOCUMENT_TRANSFORMER_STRATEGY, DataSourceStrategy, DataSourceStrategyRegistry, DefaultRuntimeCapabilityRegistry as DefaultAgentMiddlewareRuntimeCapabilityRegistry, DefaultRuntimeCapabilityRegistry, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, FILE_STORAGE_PROVIDER, FILE_UPLOAD_TARGET_STRATEGY, FileRuntimeCapability, FileStorageProvider, FileStorageProviderRegistry, FileUploadTargetRegistry, FileUploadTargetStrategy, GLOBAL_ORGANIZATION_SCOPE, HANDOFF_PERMISSION_SERVICE_TOKEN, HANDOFF_PROCESSOR_STRATEGY, HANDOFF_QUEUE_SERVICE_TOKEN, HandoffProcessorRegistry, HandoffProcessorStrategy, IMAGE_UNDERSTANDING_STRATEGY, INTEGRATION_PERMISSION_SERVICE_TOKEN, INTEGRATION_STRATEGY, ImageUnderstandingRegistry, ImageUnderstandingStrategy, IntegrationStrategyKey, IntegrationStrategyRegistry, JUMP_TO_TARGETS, JsonSchemaValidator, KNOWLEDGE_STRATEGY, KnowledgeStrategyKey, KnowledgeStrategyRegistry, KnowledgebaseDocumentsRuntimeCapability, KnowledgebaseRuntimeCapability, LLMUsage, LargeLanguageModel, MANAGED_CONNECTION_REGISTRY_TOKEN, MANAGED_QUEUE_HANDLER_REGISTRY_TOKEN, MANAGED_QUEUE_SERVICE_TOKEN, ModelProvider, ORGANIZATION_METADATA_KEY, OpenAICompatibleReranker, PERMISSION_OPERATION_METADATA_KEY, PLUGIN_CONFIG_RESOLVER_TOKEN, PLUGIN_JOB_PROCESSOR_METADATA, PLUGIN_METADATA, PLUGIN_METADATA_KEY, PLUGIN_WEBHOOK_AUTH_METADATA_KEY, PLUGIN_WEBHOOK_AUTH_SERVICE_TOKEN, PROVIDE_AI_MODEL_LLM, PROVIDE_AI_MODEL_MODERATION, PROVIDE_AI_MODEL_RERANK, PROVIDE_AI_MODEL_SPEECH2TEXT, PROVIDE_AI_MODEL_TEXT_EMBEDDING, PROVIDE_AI_MODEL_TTS, PluginJobProcessor, PluginWebhookAuth, PluginWebhookAuthGuard, RETRIEVER_STRATEGY, RequestContext, RequestContextMiddleware, RequirePermissionOperation, RerankModel, RetrieverRegistry, RetrieverStrategy, SANDBOX_JOB_ERROR_CODES, SANDBOX_JOB_PROGRESS_PREFIX, SANDBOX_PROVIDER, SANDBOX_RUNTIME_PROVIDER, SANDBOX_SHELL_TIMEOUT_LIMITS_SEC, SANDBOX_WORKSPACE_MAPPER, 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, SandboxJobRuntimeError, SandboxJobsRuntimeCapability, SandboxProviderRegistry, SandboxProviderStrategy, SandboxRuntimeProviderRegistry, SandboxRuntimeProviderStrategy, SandboxWorkspaceMapperRegistry, SandboxWorkspaceMapperStrategy, SkillSourceProviderRegistry, SkillSourceProviderStrategy, Speech2TextChatModel, SpeechToTextModel, StrategyBus, TENANT_GLOBAL_SCOPE_PREFIX, TENANT_GLOBAL_SCOPE_SUFFIX, TEXT_SPLITTER_STRATEGY, TOOLSET_STRATEGY, TextEmbeddingModelManager, TextSplitterRegistry, TextSplitterStrategy, TextToSpeechModel, ToolsetRegistry, ToolsetStrategy, USER_PERMISSION_SERVICE_TOKEN, VECTOR_STORE_STRATEGY, VIEW_EXTENSION_CACHE_SERVICE_TOKEN, VIEW_EXTENSION_PROVIDER, VectorStoreRegistry, VectorStoreStrategy, ViewExtensionProvider, ViewExtensionProviderRegistry, WORKFLOW_NODE_STRATEGY, WORKFLOW_TRIGGER_STRATEGY, WORKSPACE_FILES_SOURCE, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, WorkspaceFilesRuntimeCapability, WrapWorkflowNodeExecutionCommand, XPERT_RUNTIME_CAPABILITIES_TOKEN, XpFileSystem, XpertServerPlugin, als, appendSandboxMessage, assertConnectorDefinition, buildSandboxTimeoutMessage, calcTokenUsage, calculateModelPrice, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, createRuntimeCapability, defineAgentMessageType, defineChannelMessageType, derivePluginArtifactNamespace, downloadRemoteFile, formatSandboxTimeout, getDefaultTenantId, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, getTenantGlobalScopeKey, isDevelopmentSandboxRuntimeEnvironment, isRemoteFile, isSandboxBackend, isSandboxJobRuntimeError, isSandboxManagedServiceAdapter, isSandboxServiceProxyAdapter, isSandboxTerminalAdapter, isStrategyInstance, isStructuredMessageType, isTenantGlobalScopeKey, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, pluginArtifactTableName, renderRemoteModuleIframeHtml, renderRemoteReactIframeHtml, renderRemoteVueIframeHtml, resolveSandboxBackend, resolveSandboxExecutionOptions, resolveSandboxManagedServiceAdapter, resolveSandboxServiceProxyAdapter, resolveSandboxTerminalAdapter, resolveStrategyMetadataTarget, resolveTenantGlobalScopeKey, runWithRequestContext, secondsToMilliseconds, setDefaultTenantId, sumTokenUsage };
+export { ACCOUNT_BINDING_PERMISSION_SERVICE_TOKEN, AGENT_CHAT_DISPATCH_ERROR_STEER_TARGET_NOT_RUNNING, AGENT_CHAT_DISPATCH_MESSAGE_TYPE, AGENT_MIDDLEWARE_STRATEGY, AIModelProviderNotFoundException, AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, ActorTokenRuntimeCapability, AdapterDataSourceStrategy, AgentMiddlewareRegistry, AgentMiddlewareStrategy, AiModelNotFoundException, ArtifactsRuntimeCapability, AssistantTaskRuntimeCapability, BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN, BUILTIN_GLOBAL_SCOPE, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, BaseTool, BaseToolset, BuiltinToolset, CHAT_CHANNEL, CHAT_CHANNEL_TEXT_LIMITS, COLLABORATION_DOCUMENT_PROVIDER, CONNECTION_COMMAND_ROUTER_TOKEN, CONNECTOR_STRATEGY, CancelConversationCommand, ChatChannel, ChatChannelRegistry, ChatOAICompatReasoningModel, CollaborationDocumentProvider, CollaborationDocumentProviderRegistry, CollaborationRuntimeCapability, CommonParameterRules, ConnectorRuntimeCapability, ConnectorStrategyKey, ConnectorStrategyRegistry, CreateModelClientCommand, CredentialsValidateFailedError, DATASOURCE_STRATEGY, DBCreateTableMode, DBProtocolEnum, DBSyntaxEnum, DBTableAction, DBTableDataAction, DEFAULT_EXECUTION_CONFIG, DEFAULT_SANDBOX_EXECUTION_MAX_OUTPUT_BYTES, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_SEC, DEFAULT_SANDBOX_FILE_SEARCH_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_SEC, DEFAULT_SANDBOX_SHELL_EXECUTION_OPTIONS, DEFAULT_SANDBOX_SHELL_TIMEOUT_MS, DEFAULT_SANDBOX_SHELL_TIMEOUT_SEC, DOCUMENT_SOURCE_STRATEGY, DOCUMENT_TRANSFORMER_STRATEGY, DataSourceStrategy, DataSourceStrategyRegistry, DefaultRuntimeCapabilityRegistry as DefaultAgentMiddlewareRuntimeCapabilityRegistry, DefaultRuntimeCapabilityRegistry, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, FILE_STORAGE_PROVIDER, FILE_UPLOAD_TARGET_STRATEGY, FileRuntimeCapability, FileStorageProvider, FileStorageProviderRegistry, FileUploadTargetRegistry, FileUploadTargetStrategy, GLOBAL_ORGANIZATION_SCOPE, HANDOFF_PERMISSION_SERVICE_TOKEN, HANDOFF_PROCESSOR_STRATEGY, HANDOFF_QUEUE_SERVICE_TOKEN, HandoffProcessorRegistry, HandoffProcessorStrategy, IMAGE_UNDERSTANDING_STRATEGY, INTEGRATION_PERMISSION_SERVICE_TOKEN, INTEGRATION_STRATEGY, ImageUnderstandingRegistry, ImageUnderstandingStrategy, IntegrationStrategyKey, IntegrationStrategyRegistry, JUMP_TO_TARGETS, JsonSchemaValidator, KNOWLEDGE_STRATEGY, KnowledgeStrategyKey, KnowledgeStrategyRegistry, KnowledgebaseDocumentsRuntimeCapability, KnowledgebaseRuntimeCapability, LLMUsage, LargeLanguageModel, MANAGED_CONNECTION_REGISTRY_TOKEN, MANAGED_QUEUE_HANDLER_REGISTRY_TOKEN, MANAGED_QUEUE_SERVICE_TOKEN, ModelProvider, ORGANIZATION_METADATA_KEY, OpenAICompatibleReranker, PERMISSION_OPERATION_METADATA_KEY, PLUGIN_CONFIG_RESOLVER_TOKEN, PLUGIN_JOB_PROCESSOR_METADATA, PLUGIN_METADATA, PLUGIN_METADATA_KEY, PLUGIN_WEBHOOK_AUTH_METADATA_KEY, PLUGIN_WEBHOOK_AUTH_SERVICE_TOKEN, PROVIDE_AI_MODEL_LLM, PROVIDE_AI_MODEL_MODERATION, PROVIDE_AI_MODEL_RERANK, PROVIDE_AI_MODEL_SPEECH2TEXT, PROVIDE_AI_MODEL_TEXT_EMBEDDING, PROVIDE_AI_MODEL_TTS, PluginJobProcessor, PluginWebhookAuth, PluginWebhookAuthGuard, RETRIEVER_STRATEGY, RequestContext, RequestContextMiddleware, RequirePermissionOperation, RerankModel, RetrieverRegistry, RetrieverStrategy, SANDBOX_JOB_ERROR_CODES, SANDBOX_JOB_PROGRESS_PREFIX, SANDBOX_PROVIDER, SANDBOX_RUNTIME_PROVIDER, SANDBOX_SHELL_TIMEOUT_LIMITS_SEC, SANDBOX_WORKSPACE_MAPPER, 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, SandboxJobRuntimeError, SandboxJobsRuntimeCapability, SandboxProviderRegistry, SandboxProviderStrategy, SandboxRuntimeProviderRegistry, SandboxRuntimeProviderStrategy, SandboxWorkspaceMapperRegistry, SandboxWorkspaceMapperStrategy, 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, VIDEO_GENERATION_PERMISSION_SERVICE_TOKEN, VIDEO_GENERATION_SERVICE_TOKEN, VIDEO_GENERATOR_FAMILIES, VIEW_EXTENSION_CACHE_SERVICE_TOKEN, VIEW_EXTENSION_PROVIDER, VectorStoreRegistry, VectorStoreStrategy, ViewExtensionProvider, ViewExtensionProviderRegistry, WORKFLOW_NODE_STRATEGY, WORKFLOW_TRIGGER_STRATEGY, WORKSPACE_FILES_SOURCE, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, WorkspaceFilesRuntimeCapability, WrapWorkflowNodeExecutionCommand, XPERT_RUNTIME_CAPABILITIES_TOKEN, XpFileSystem, XpertServerPlugin, als, appendSandboxMessage, assertConnectorDefinition, buildSandboxTimeoutMessage, calcTokenUsage, calculateModelPrice, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, createRuntimeCapability, defineAgentMessageType, defineChannelMessageType, derivePluginArtifactNamespace, downloadRemoteFile, formatSandboxTimeout, getDefaultTenantId, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, getTenantGlobalScopeKey, isDevelopmentSandboxRuntimeEnvironment, isRemoteFile, isSandboxBackend, isSandboxJobRuntimeError, isSandboxManagedServiceAdapter, isSandboxServiceProxyAdapter, isSandboxTerminalAdapter, isStrategyInstance, isStructuredMessageType, isTenantGlobalScopeKey, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, pluginArtifactTableName, renderRemoteModuleIframeHtml, renderRemoteReactIframeHtml, renderRemoteVueIframeHtml, resolveSandboxBackend, resolveSandboxExecutionOptions, resolveSandboxManagedServiceAdapter, resolveSandboxServiceProxyAdapter, resolveSandboxTerminalAdapter, resolveStrategyMetadataTarget, resolveTenantGlobalScopeKey, resolveTokenUsage, runWithRequestContext, secondsToMilliseconds, setDefaultTenantId, sumTokenUsage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/plugin-sdk",
-  "version": "3.15.18",
+  "version": "3.16.1",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",
@@ -17,7 +17,7 @@
   },
   "dependencies": {
     "@langchain/openai": "0.6.9",
-    "@xpert-ai/contracts": "3.15.18",
+    "@xpert-ai/contracts": "3.16.0",
     "express": "^4.22.1",
     "js-tiktoken": "^1.0.21"
   },
@@ -26,7 +26,6 @@
     "@nestjs/common": "*",
     "@nestjs/core": "*",
     "@nestjs/cqrs": "*",
-    "@xpert-ai/ocap-core": "3.9.1",
     "ajv": "*",
     "i18next": "*",
     "i18next-fs-backend": "*",

package/src/lib/ai-model/llm.d.ts

@@ -52,6 +52,7 @@ export declare abstract class LargeLanguageModel extends AIModel {
     private formatError;
 }
 export declare function calcTokenUsage(output: LLMResult): TTokenUsage;
+export declare function resolveTokenUsage(output: LLMResult): TTokenUsage;
 /**
  * @deprecated use calcTokenUsage
  */

package/src/lib/core/permissions/bound-identity-login.d.ts

@@ -1,6 +1,6 @@
 import type { IssuedAuthTokens } from './auth-login';
 import type { BasePermission } from './general';
-export type BoundIdentityLoginPermissionOperation = 'create';
+export type BoundIdentityLoginPermissionOperation = 'create' | 'provision';
 /**
  * Bound identity login permission
  * Example: { type: 'bound_identity_login', operations: ['create'], providers: ['lark'] }
@@ -20,6 +20,24 @@ export interface BoundIdentityLoginInput {
     tenantId: string;
     organizationId?: string | null;
 }
+export interface VerifiedEmailLoginInput {
+    provider: string;
+    subjectId: string;
+    tenantId: string;
+    verifiedEmail: string;
+    displayName?: string;
+    avatarUrl?: string;
+    profile?: Record<string, unknown>;
+    returnTo?: string;
+}
+export type VerifiedEmailLoginResult = {
+    status: 'authenticated';
+    tokens: IssuedAuthTokens;
+} | {
+    status: 'registration_required';
+    ticket: string;
+};
 export interface BoundIdentityLoginPermissionService {
     loginWithBoundIdentity(input: BoundIdentityLoginInput): Promise<IssuedAuthTokens | null>;
+    loginOrPrepareVerifiedEmail(input: VerifiedEmailLoginInput): Promise<VerifiedEmailLoginResult>;
 }

package/src/lib/core/permissions/index.d.ts

@@ -6,7 +6,6 @@
  * Core system will check and inject allowed resources accordingly.
  */
 export * from './general';
-export * from './analytics';
 export * from './operation';
 export * from './handoff';
 export * from './account-binding';
@@ -15,18 +14,19 @@ export * from './bound-identity-login';
 export * from './sso-binding';
 export * from './user';
 export * from './speech-to-text';
+export * from './video-generation';
 import type { FileSystemPermission, IntegrationPermission, KnowledgePermission, LLMPermission, VectorStorePermission } from './general';
-import type { AnalyticsPermission } from './analytics';
 import type { AccountBindingPermission } from './account-binding';
 import type { BoundIdentityLoginPermission } from './bound-identity-login';
 import type { HandoffPermission } from './handoff';
 import type { SpeechToTextPermission } from './speech-to-text';
 import type { SsoBindingPermission } from './sso-binding';
 import type { UserPermission } from './user';
+import type { VideoGenerationPermission } from './video-generation';
 /**
  * Union type for all permissions
  */
-export type Permission = LLMPermission | VectorStorePermission | KnowledgePermission | FileSystemPermission | IntegrationPermission | AnalyticsPermission | AccountBindingPermission | BoundIdentityLoginPermission | SsoBindingPermission | UserPermission | HandoffPermission | SpeechToTextPermission;
+export type Permission = LLMPermission | VectorStorePermission | KnowledgePermission | FileSystemPermission | IntegrationPermission | AccountBindingPermission | BoundIdentityLoginPermission | SsoBindingPermission | UserPermission | HandoffPermission | SpeechToTextPermission | VideoGenerationPermission;
 /**
  * Permissions array type
  */

package/src/lib/core/permissions/video-generation.d.ts

@@ -0,0 +1,159 @@
+import type { WorkspacePortableFileReference } from '../../runtime/capabilities/workspace-files';
+export declare const VIDEO_GENERATOR_FAMILIES: readonly ["seedance", "veo", "kling"];
+export type VideoGeneratorFamily = (typeof VIDEO_GENERATOR_FAMILIES)[number];
+export type VideoGenerationPermissionOperation = 'list' | 'submit' | 'query' | 'cancel';
+export type VideoGenerationMode = 'text_to_video' | 'image_to_video' | 'first_last_frame_to_video' | 'reference_to_video';
+export type VideoGenerationReferenceKind = 'image' | 'video' | 'audio';
+export type VideoGenerationReferencePurpose = 'reference' | 'first_frame' | 'last_frame';
+export interface VideoGenerationPermission {
+    type: 'video_generation';
+    operations?: VideoGenerationPermissionOperation[];
+    scope?: string[];
+    description?: string;
+}
+export declare const VIDEO_GENERATION_PERMISSION_SERVICE_TOKEN = "XPERT_PLUGIN_VIDEO_GENERATION_PERMISSION_SERVICE";
+export declare const VIDEO_GENERATION_SERVICE_TOKEN = "XPERT_VIDEO_GENERATION_SERVICE";
+export interface VideoGenerationReferenceLimit {
+    maxItems: number;
+}
+export interface VideoGenerationModelInputCapabilities {
+    referenceImages?: VideoGenerationReferenceLimit;
+    referenceVideos?: VideoGenerationReferenceLimit;
+    referenceAudios?: VideoGenerationReferenceLimit;
+    initialFrame?: boolean;
+    lastFrame?: boolean;
+}
+export interface VideoGenerationModelOption {
+    id: string;
+    label: string;
+    /** Optional per-model restriction. Defaults to the generator-level modes. */
+    modes?: readonly VideoGenerationMode[];
+    inputs?: VideoGenerationModelInputCapabilities;
+}
+interface VideoGenerationToolsetCapabilityBase {
+    family: VideoGeneratorFamily;
+    displayName: string;
+    modes: readonly VideoGenerationMode[];
+    models: readonly VideoGenerationModelOption[];
+    defaultModel: string;
+    resolutions: readonly string[];
+    aspectRatios: readonly string[];
+    durationSeconds: {
+        min: number;
+        max: number;
+        default: number;
+    };
+    supportsAudio: boolean;
+}
+/** Legacy single-image protocol. Kept so already installed provider plugins remain usable. */
+export interface VideoGenerationToolsetCapabilityV1 extends VideoGenerationToolsetCapabilityBase {
+    protocolVersion: 1;
+    tools: {
+        textToVideo?: string;
+        imageToVideo?: string;
+        query: string;
+        cancel?: string;
+    };
+}
+/**
+ * Capability-driven protocol. Submit tools consume normalized argument names:
+ * `input_image_file`, `first_frame_file`, `last_frame_file`, and
+ * `reference_{image,video,audio}_files`.
+ */
+export interface VideoGenerationToolsetCapabilityV2 extends VideoGenerationToolsetCapabilityBase {
+    protocolVersion: 2;
+    tools: {
+        textToVideo?: string;
+        imageToVideo?: string;
+        firstLastFrameToVideo?: string;
+        referenceToVideo?: string;
+        query: string;
+        cancel?: string;
+    };
+}
+export type VideoGenerationToolsetCapability = VideoGenerationToolsetCapabilityV1 | VideoGenerationToolsetCapabilityV2;
+export interface VideoGeneratorSummary {
+    id: string;
+    family: VideoGeneratorFamily;
+    name: string;
+    displayName: string;
+    linkedToXpert: boolean;
+    modes: VideoGenerationMode[];
+    models: VideoGenerationModelOption[];
+    defaultModel: string;
+    resolutions: string[];
+    aspectRatios: string[];
+    durationSeconds: {
+        min: number;
+        max: number;
+        default: number;
+    };
+    supportsAudio: boolean;
+    supportsCancel: boolean;
+}
+export interface ListVideoGeneratorsInput {
+    xpertId: string;
+}
+export interface ListVideoGeneratorsResult {
+    generators: VideoGeneratorSummary[];
+}
+export interface VideoGenerationReferenceInput {
+    kind: VideoGenerationReferenceKind;
+    purpose?: VideoGenerationReferencePurpose;
+    file: WorkspacePortableFileReference;
+}
+export interface SubmitVideoGenerationInput {
+    xpertId: string;
+    toolsetId: string;
+    projectId?: string | null;
+    prompt: string;
+    references?: readonly VideoGenerationReferenceInput[] | null;
+    /** @deprecated Use `references` with an image item. */
+    inputImage?: WorkspacePortableFileReference | null;
+    model?: string | null;
+    resolution?: string | null;
+    aspectRatio?: string | null;
+    durationSeconds?: number | null;
+    generateAudio?: boolean | null;
+}
+export interface SubmitVideoGenerationResult {
+    providerTaskId: string;
+    status: string;
+    model?: string;
+    mode?: VideoGenerationMode;
+    acceptedReferenceCount?: number;
+}
+export interface QueryVideoGenerationInput {
+    xpertId: string;
+    toolsetId: string;
+    projectId?: string | null;
+    providerTaskId: string;
+}
+export interface QueryVideoGenerationResult {
+    providerTaskId: string;
+    status: string;
+    completed: boolean;
+    failed: boolean;
+    model?: string;
+    errorCode?: string;
+    errorMessage?: string;
+    outputFile?: WorkspacePortableFileReference;
+}
+export interface CancelVideoGenerationInput {
+    xpertId: string;
+    toolsetId: string;
+    providerTaskId: string;
+}
+export interface CancelVideoGenerationResult {
+    providerTaskId: string;
+    supported: boolean;
+    cancelled: boolean;
+    status: string;
+}
+export interface VideoGenerationPermissionService {
+    listGenerators(input: ListVideoGeneratorsInput): Promise<ListVideoGeneratorsResult>;
+    submit(input: SubmitVideoGenerationInput): Promise<SubmitVideoGenerationResult>;
+    query(input: QueryVideoGenerationInput): Promise<QueryVideoGenerationResult>;
+    cancel(input: CancelVideoGenerationInput): Promise<CancelVideoGenerationResult>;
+}
+export {};

package/src/lib/runtime/capabilities/actor-token.d.ts

@@ -0,0 +1,15 @@
+export type ActorTokenAct = Record<string, string | number | boolean | null | undefined>;
+export interface ActorTokenRequest {
+    audience?: string | string[];
+    ttlSeconds?: number;
+    act?: ActorTokenAct;
+}
+export interface ActorTokenResult {
+    token: string;
+    expiresAt: string;
+    audience: string | string[];
+}
+export interface ActorTokenApi {
+    getToken(input?: ActorTokenRequest): Promise<ActorTokenResult>;
+}
+export declare const ActorTokenRuntimeCapability: import("../../core/runtime-capability").RuntimeCapabilityKey<ActorTokenApi>;

package/src/lib/runtime/capabilities/index.d.ts

@@ -1,5 +1,6 @@
 export * from './knowledgebase';
 export * from './knowledgebase-documents';
+export * from './actor-token';
 export * from './artifacts';
 export * from './workspace-files';
 export * from './sandbox-jobs';

package/src/lib/runtime/capabilities/workspace-files.d.ts

@@ -10,6 +10,7 @@ export declare const WORKSPACE_FILES_SOURCE: "platform.workspace.files";
  */
 export type WorkspaceFileScope = {
     tenantId?: string | null;
+    organizationId?: string | null;
     userId?: string | null;
     catalog?: WorkspaceFileCatalog | null;
     scopeId?: string | null;
@@ -151,6 +152,38 @@ export type WorkspaceUnderstoodFile = WorkspaceFile & {
     capabilities?: string[];
     summary?: string;
 };
+export type WorkspaceUnderstandingVectorStatus = 'pending' | 'ready' | 'failed' | 'unavailable';
+export type WorkspaceUnderstandingStatusInput = WorkspaceFileScope & {
+    fileAssetId: string;
+};
+/** Compact readiness DTO for an understood file. It never contains parsed text. */
+export type WorkspaceUnderstandingStatus = {
+    fileAssetId: string;
+    status: string;
+    parseMode: string;
+    capabilities: string[];
+    chunkCount: number;
+    indexedChunkCount: number;
+    vectorIndexStatus: WorkspaceUnderstandingVectorStatus;
+    errorCode?: string;
+    parsedAt?: string;
+};
+export type WorkspaceRetryUnderstandingInput = WorkspaceUnderstandingStatusInput;
+export type WorkspaceUnderstandingReferenceInput = {
+    fileAssetId: string;
+    chunkId: string;
+};
+export type WorkspaceValidateUnderstandingReferencesInput = WorkspaceFileScope & {
+    references: WorkspaceUnderstandingReferenceInput[];
+    excerptLength?: number;
+};
+export type WorkspaceValidatedUnderstandingReference = {
+    fileAssetId: string;
+    chunkId: string;
+    orderNo: number;
+    anchor?: Record<string, unknown>;
+    excerpt: string;
+};
 /**
  * Runtime capability contract for reading, writing, uploading, deleting, and
  * understanding files in Xpert workspace Volumes.
@@ -160,6 +193,12 @@ export interface WorkspaceFilesApi {
     uploadBuffer(input: WorkspaceUploadBufferInput): Promise<WorkspaceFile>;
     /** Register an existing workspace file with the platform understanding pipeline. */
     understandFile(input: WorkspaceUnderstandFileInput): Promise<WorkspaceUnderstoodFile>;
+    /** Return compact parsing and semantic-index readiness for one scoped FileAsset. */
+    getUnderstandingStatus(input: WorkspaceUnderstandingStatusInput): Promise<WorkspaceUnderstandingStatus>;
+    /** Retry parsing and semantic indexing for one failed scoped FileAsset. */
+    retryUnderstanding(input: WorkspaceRetryUnderstandingInput): Promise<WorkspaceUnderstandingStatus>;
+    /** Validate bounded FileAsset/chunk evidence without returning complete file contents. */
+    validateUnderstandingReferences(input: WorkspaceValidateUnderstandingReferencesInput): Promise<WorkspaceValidatedUnderstandingReference[]>;
     /**
      * Resolve metadata and an openable URL for an explicitly scoped workspace
      * file without reading its bytes into the API process.

package/src/lib/sandbox/sandbox.interface.d.ts

@@ -1,5 +1,5 @@
 import { TSandboxProviderMeta, TSandboxWorkForType } from '@xpert-ai/contracts';
-import { SandboxBackendProtocol } from './protocol';
+import { MaybePromise, SandboxBackendProtocol } from './protocol';
 export type SandboxWorkspaceBinding = {
     /**
      * Host-side bind source used by containerized sandboxes.
@@ -71,6 +71,11 @@ export type SandboxProviderCreateOptions = {
 export interface ISandboxProvider<T extends SandboxBackendProtocol = SandboxBackendProtocol> {
     type: string;
     meta: TSandboxProviderMeta;
+    /**
+     * Whether this provider is currently available in this deployment.
+     * Providers without an availability hook remain available for backward compatibility.
+     */
+    isAvailable?(): MaybePromise<boolean>;
     /**
      * Create a new sandbox instance
      *

package/src/lib/sandbox/terminal.d.ts

@@ -7,6 +7,8 @@ export type SandboxTerminalExit = {
 export type SandboxTerminalOpenOptions = {
     cols: number;
     rows: number;
+    /** Reports terminal transport or provider failures separately from process exit. */
+    onError?: (error: Error) => void;
     onExit: (event: SandboxTerminalExit) => void;
     onOutput: (data: string) => void;
 };

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

@@ -2,6 +2,7 @@ import { DynamicStructuredTool } from '@langchain/core/tools';
 import { I18nObject, IconDefinition } from '@xpert-ai/contracts';
 import { ZodSchema } from 'zod';
 import { BuiltinToolset, TBuiltinToolsetParams } from './builtin';
+import type { VideoGenerationToolsetCapability } from '../core/permissions/video-generation';
 export interface IToolsetStrategy<TConfig = any> {
     /**
      * Metadata about this toolset
@@ -14,6 +15,8 @@ export interface IToolsetStrategy<TConfig = any> {
         description?: I18nObject;
         configSchema: any;
         icon?: IconDefinition;
+        /** Optional normalized video-generation capability consumed by platform services. */
+        videoGeneration?: VideoGenerationToolsetCapability;
     };
     /**
      * Validate the configuration

package/src/lib/types.d.ts

@@ -1,4 +1,4 @@
-import { IconDefinition, JsonSchemaObjectType, PluginMeta, PluginTargetApp, PluginTargetAppMeta, TAvatar, type TPromptWorkflow, XpertTemplatePluginDependencies, XpertTypeEnum } from '@xpert-ai/contracts';
+import { IconDefinition, I18nObject, JsonSchemaObjectType, PluginMeta, PluginTargetApp, PluginTargetAppMeta, TAvatar, type TPromptWorkflow, XpertTemplatePluginDependencies, XpertTypeEnum } from '@xpert-ai/contracts';
 import type { DynamicModule, INestApplicationContext } from '@nestjs/common';
 import { ModuleRef } from '@nestjs/core';
 import type { ZodSchema } from 'zod';
@@ -60,8 +60,8 @@ export interface XpertTemplateContribution {
     key: string;
     id?: string;
     name?: string;
-    title?: string;
-    description?: string;
+    title?: string | I18nObject;
+    description?: string | I18nObject;
     category?: string;
     copyright?: string | null;
     privacyPolicy?: string | null;

package/src/lib/core/permissions/analytics.d.ts

@@ -1,45 +0,0 @@
-import type { BasePermission } from './general';
-export type AnalyticsPermissionOperation = 'dscore' | 'query' | 'model' | 'indicator' | 'create_indicator';
-/**
- * Analytics Permission
- * Example: { type: 'analytics', operations: ['dscore'] }
- */
-export interface AnalyticsPermission extends BasePermission {
-    type: 'analytics';
-    operations?: AnalyticsPermissionOperation[];
-    scope?: string[];
-}
-/**
- * System token for resolving analytics permission service from plugin context.
- */
-export declare const ANALYTICS_PERMISSION_SERVICE_TOKEN = "XPERT_PLUGIN_ANALYTICS_PERMISSION_SERVICE";
-export interface AnalyticsResolvedChatBIModel {
-    chatbiModelId: string;
-    modelId: string;
-    modelKey?: string;
-    cubeName: string;
-    entityCaption?: string;
-    entityDescription?: string;
-    prompts?: string[];
-}
-export interface AnalyticsDSCoreInput {
-    modelIds?: string[];
-    indicatorDraft?: boolean;
-    semanticModelDraft?: boolean;
-}
-export interface AnalyticsIndicatorValidationInput {
-    modelIds?: string[];
-    semanticModelId: string;
-    modelKey?: string;
-    statement: string;
-}
-/**
- * Analytics service exposed to plugins under permission control.
- */
-export interface AnalyticsPermissionService<TDSCoreService = unknown> {
-    resolveChatBIModels(modelIds: string[]): Promise<AnalyticsResolvedChatBIModel[]>;
-    getDSCoreService(input?: AnalyticsDSCoreInput): Promise<TDSCoreService>;
-    visitChatBIModel(modelId: string, cubeName: string): Promise<void>;
-    ensureCreateIndicatorAccess(): Promise<void>;
-    validateIndicatorStatement(input: AnalyticsIndicatorValidationInput): Promise<void>;
-}