@xpert-ai/plugin-sdk 3.7.2 → 3.8.1

package/index.cjs.js

@@ -30,6 +30,7 @@ var chat_models = require('@langchain/core/language_models/chat_models');
 var messages = require('@langchain/core/messages');
 var env = require('@langchain/core/utils/env');
 require('js-tiktoken');
+var base = require('@langchain/core/language_models/base');
 
 function _interopNamespaceDefault(e) {
 	var n = Object.create(null);
@@ -530,6 +531,7 @@ exports.WorkflowNodeRegistry = __decorate([
     ])
 ], exports.WorkflowNodeRegistry);
 
+const COMMAND_METADATA$1 = '__command__';
 /**
  * Wrap Workflow Node Execution Command
  */ class WrapWorkflowNodeExecutionCommand extends cqrs.Command {
@@ -540,6 +542,9 @@ exports.WorkflowNodeRegistry = __decorate([
     }
 }
 WrapWorkflowNodeExecutionCommand.type = '[Workflow] Wrap Workflow Node Execution';
+Reflect.defineMetadata(COMMAND_METADATA$1, {
+    id: WrapWorkflowNodeExecutionCommand.type
+}, WrapWorkflowNodeExecutionCommand);
 
 const VECTOR_STORE_STRATEGY = 'VECTOR_STORE_STRATEGY';
 const VectorStoreStrategy = (provider)=>common.applyDecorators(common.SetMetadata(VECTOR_STORE_STRATEGY, provider), common.SetMetadata(STRATEGY_META_KEY, VECTOR_STORE_STRATEGY));
@@ -951,6 +956,52 @@ BuiltinToolset.provider = '';
     }
 }
 
+/**
+ * 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)=>{
+        const method = descriptor.value;
+        if (typeof method !== 'function') {
+            throw new Error('RequirePermissionOperation can only be applied to methods');
+        }
+        Reflect.defineMetadata(PERMISSION_OPERATION_METADATA_KEY, {
+            permissionType,
+            operation
+        }, method);
+    };
+}
+function getPermissionOperationMetadata(method) {
+    if (typeof method !== 'function') {
+        return undefined;
+    }
+    return Reflect.getMetadata(PERMISSION_OPERATION_METADATA_KEY, method);
+}
+function getRequiredPermissionOperation(method, permissionType) {
+    const metadata = getPermissionOperationMetadata(method);
+    if (!metadata || metadata.permissionType !== permissionType) {
+        return undefined;
+    }
+    return metadata.operation;
+}
+
+/**
+ * System token for resolving handoff queue service from plugin context.
+ */ const HANDOFF_PERMISSION_SERVICE_TOKEN = 'XPERT_PLUGIN_HANDOFF_PERMISSION_SERVICE';
+/**
+ * Internal system token used by core to expose the handoff queue bridge.
+ */ const HANDOFF_QUEUE_SERVICE_TOKEN = 'XPERT_HANDOFF_QUEUE_SERVICE';
+
+/**
+ * System token for resolving user permission service from plugin context.
+ */ const USER_PERMISSION_SERVICE_TOKEN = 'XPERT_PLUGIN_USER_PERMISSION_SERVICE';
+
 async function createI18nInstance(pluginDir, language) {
     const instance = i18next.createInstance();
     const i18nDir = path.join(pluginDir, 'i18n');
@@ -1365,6 +1416,18 @@ function AIModelProviderStrategy(provider) {
     if (file == null ? void 0 : file.startsWith('file:///')) {
         file = file.replace('file://', '');
     }
+    // Strip :line:col suffix (e.g. "/path/file.js:37:5" -> "/path/file.js")
+    if (file) {
+        file = file.replace(/:\d+:\d+$/, '');
+    }
+    // Decode URL-encoded paths (e.g. Chinese characters: %E9%A1%B9%E7%9B%AE -> 项目)
+    if (file) {
+        try {
+            file = decodeURIComponent(file);
+        } catch (e) {
+        // keep as-is if decode fails
+        }
+    }
     const dir = file ? path.dirname(file) : process.cwd();
     return function(target) {
         common.SetMetadata(STRATEGY_META_KEY, AI_MODEL_PROVIDER)(target);
@@ -2283,6 +2346,49 @@ class Speech2TextChatModel extends chat_models.BaseChatModel {
     return 0;
 }
 
+function getModelContextSize(input) {
+    if (isCopilotModel(input)) {
+        var _input_options;
+        return normalizeContextSize((_input_options = input.options) == null ? void 0 : _input_options[contracts.ModelPropertyKey.CONTEXT_SIZE]);
+    }
+    // Backward compatibility for langchain <1.0.0
+    if (input.metadata && "profile" in input.metadata) {
+        const profile = input.metadata['profile'];
+        if ("maxInputTokens" in profile && (typeof profile.maxInputTokens === "number" || profile.maxInputTokens == null)) {
+            var _profile_maxInputTokens;
+            return (_profile_maxInputTokens = profile.maxInputTokens) != null ? _profile_maxInputTokens : undefined;
+        }
+    }
+    // Langchain v1.0.0+
+    if ("profile" in input && typeof input.profile === "object" && input.profile && "maxInputTokens" in input.profile && (typeof input.profile.maxInputTokens === "number" || input.profile.maxInputTokens == null)) {
+        var _input_profile_maxInputTokens;
+        return (_input_profile_maxInputTokens = input.profile.maxInputTokens) != null ? _input_profile_maxInputTokens : undefined;
+    }
+    if ("model" in input && typeof input.model === "string") {
+        return base.getModelContextSize(input.model);
+    }
+    if ("modelName" in input && typeof input.modelName === "string") {
+        return base.getModelContextSize(input.modelName);
+    }
+    return undefined;
+}
+function isCopilotModel(input) {
+    return typeof input === "object" && input !== null && !("invoke" in input);
+}
+function normalizeContextSize(value) {
+    if (typeof value === "number" && Number.isFinite(value) && value > 0) {
+        return Math.floor(value);
+    }
+    if (typeof value === "string") {
+        const parsed = Number.parseInt(value, 10);
+        if (Number.isFinite(parsed) && parsed > 0) {
+            return parsed;
+        }
+    }
+    return undefined;
+}
+
+const COMMAND_METADATA = '__command__';
 /**
  * Get a Chat Model of copilot model and check it's token limitation, record the token usage
  */ class CreateModelClientCommand extends cqrs.Command {
@@ -2293,6 +2399,9 @@ class Speech2TextChatModel extends chat_models.BaseChatModel {
     }
 }
 CreateModelClientCommand.type = '[AI Model] Create Model Client';
+Reflect.defineMetadata(COMMAND_METADATA, {
+    id: CreateModelClientCommand.type
+}, CreateModelClientCommand);
 
 const AGENT_MIDDLEWARE_STRATEGY = 'AGENT_MIDDLEWARE_STRATEGY';
 const AgentMiddlewareStrategy = (provider)=>common.applyDecorators(common.SetMetadata(AGENT_MIDDLEWARE_STRATEGY, provider), common.SetMetadata(STRATEGY_META_KEY, AGENT_MIDDLEWARE_STRATEGY));
@@ -2319,6 +2428,1152 @@ exports.AgentMiddlewareRegistry = __decorate([
     "end"
 ];
 
+/**
+ * Structured message types (suggested format):
+ * - channel.{provider}.{action}.v{number}
+ * - agent.{action}.v{number}
+ * - system.{action}.v{number}
+ * - plugin.{domain}.{action}.v{number}
+ *
+ * Note: At runtime, any string type is still allowed, facilitating dynamic extension by plugins.
+ */ const SEGMENT_PATTERN = /^[a-z][a-z0-9_-]*$/i;
+const VERSION_PATTERN = /^v[1-9][0-9]*$/;
+function assertSegment(input, name) {
+    if (!SEGMENT_PATTERN.test(input)) {
+        throw new Error(`Invalid ${name} segment: "${input}"`);
+    }
+}
+/**
+ * Unified construction of channel message types to avoid manual string errors.
+ * Example: channel.lark.inbound.v1
+ */ function defineChannelMessageType(provider, action, version) {
+    assertSegment(provider, 'provider');
+    assertSegment(action, 'action');
+    if (!Number.isInteger(version) || version <= 0) {
+        throw new Error(`Invalid version: "${version}"`);
+    }
+    return `channel.${provider}.${action}.v${version}`;
+}
+/**
+ * Unified construction of agent message types.
+ * Example: agent.handoff.v1
+ */ function defineAgentMessageType(action, version) {
+    assertSegment(action, 'action');
+    if (!Number.isInteger(version) || version <= 0) {
+        throw new Error(`Invalid version: "${version}"`);
+    }
+    return `agent.${action}.v${version}`;
+}
+/**
+ * Check if a type conforms to the structured naming convention (format only, no semantic validation).
+ */ function isStructuredMessageType(type) {
+    const parts = type.split('.');
+    if (parts.length < 3) {
+        return false;
+    }
+    const version = parts[parts.length - 1];
+    if (!VERSION_PATTERN.test(version)) {
+        return false;
+    }
+    return parts.slice(0, -1).every((part)=>SEGMENT_PATTERN.test(part));
+}
+
+const AGENT_CHAT_DISPATCH_MESSAGE_TYPE = defineAgentMessageType('chat_dispatch', 1);
+
+/**
+ * Handoff Processor meta key。
+ */ const HANDOFF_PROCESSOR_STRATEGY = 'HANDOFF_PROCESSOR_STRATEGY';
+/**
+ * Declare on a provider:
+ * 1) Which message types it handles
+ * 2) Default execution policy (lane/timeout)
+ */ function HandoffProcessorStrategy(provider, metadata) {
+    var _metadata_types;
+    if (!(metadata == null ? void 0 : (_metadata_types = metadata.types) == null ? void 0 : _metadata_types.length)) {
+        throw new Error('HandoffProcessor requires at least one message type');
+    }
+    return common.applyDecorators(common.SetMetadata(HANDOFF_PROCESSOR_STRATEGY, provider), common.SetMetadata(STRATEGY_META_KEY, HANDOFF_PROCESSOR_STRATEGY));
+}
+
+exports.HandoffProcessorRegistry = class HandoffProcessorRegistry extends BaseStrategyRegistry {
+    constructor(discoveryService, reflector){
+        super(HANDOFF_PROCESSOR_STRATEGY, discoveryService, reflector);
+    }
+};
+exports.HandoffProcessorRegistry = __decorate([
+    common.Injectable(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [
+        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
+        typeof core.Reflector === "undefined" ? Object : core.Reflector
+    ])
+], exports.HandoffProcessorRegistry);
+
+/**
+ * Handoff execution types.
+ *
+ * Note:
+ * - Two-gate lane/session permit logic has been removed.
+ * - Lane is now an execution tag for observability and soft policy only.
+ */ const DEFAULT_EXECUTION_CONFIG = {
+    lanes: {
+        main: 8,
+        subagent: 16,
+        cron: 4,
+        nested: 8
+    },
+    runTtlMs: 10 * 60 * 1000
+};
+
+/**
+ * Common platform message length limits
+ */ const CHAT_CHANNEL_TEXT_LIMITS = {
+    lark: 4000,
+    wecom: 2048,
+    dingtalk: 4000,
+    slack: 4000,
+    telegram: 4096,
+    discord: 2000
+};
+/**
+ * Chunk long text by specified length
+ *
+ * @param text - Text to chunk
+ * @param limit - Maximum characters per chunk
+ * @param mode - Chunking mode: 'text' splits by character, 'markdown' tries to preserve paragraphs
+ * @returns Array of chunked text
+ */ function chunkText(text, limit, mode = 'text') {
+    if (!text || text.length <= limit) {
+        return [
+            text
+        ];
+    }
+    const chunks = [];
+    if (mode === 'markdown') {
+        // Markdown mode: try to split at paragraph boundaries
+        const paragraphs = text.split(/\n\n+/);
+        let currentChunk = '';
+        for (const para of paragraphs){
+            if (currentChunk.length + para.length + 2 <= limit) {
+                currentChunk += (currentChunk ? '\n\n' : '') + para;
+            } else if (para.length > limit) {
+                // Paragraph itself is too long, need hard split
+                if (currentChunk) {
+                    chunks.push(currentChunk);
+                    currentChunk = '';
+                }
+                let remaining = para;
+                while(remaining.length > limit){
+                    chunks.push(remaining.slice(0, limit));
+                    remaining = remaining.slice(limit);
+                }
+                currentChunk = remaining;
+            } else {
+                if (currentChunk) {
+                    chunks.push(currentChunk);
+                }
+                currentChunk = para;
+            }
+        }
+        if (currentChunk) {
+            chunks.push(currentChunk);
+        }
+    } else {
+        // Plain text mode: split directly by length
+        let remaining = text;
+        while(remaining.length > limit){
+            chunks.push(remaining.slice(0, limit));
+            remaining = remaining.slice(limit);
+        }
+        if (remaining) {
+            chunks.push(remaining);
+        }
+    }
+    return chunks;
+}
+
+/**
+ * Metadata key for chat channel
+ */ const CHAT_CHANNEL = 'CHAT_CHANNEL';
+/**
+ * Decorator for chat channel implementations
+ *
+ * Use this decorator to register a chat channel implementation.
+ * The decorated class will be automatically discovered and registered
+ * to ChatChannelRegistry on module initialization.
+ *
+ * @param type - The channel type identifier (e.g., 'lark', 'wecom', 'dingtalk')
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * @ChatChannel('lark')
+ * export class LarkChatChannel implements IChatChannel {
+ *   // Implementation
+ * }
+ * ```
+ */ const ChatChannel = (type)=>common.SetMetadata(CHAT_CHANNEL, type);
+
+exports.ChatChannelRegistry = class ChatChannelRegistry extends BaseStrategyRegistry {
+    constructor(discoveryService, reflector){
+        super(CHAT_CHANNEL, discoveryService, reflector);
+    }
+};
+exports.ChatChannelRegistry = __decorate([
+    common.Injectable(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [
+        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
+        typeof core.Reflector === "undefined" ? Object : core.Reflector
+    ])
+], exports.ChatChannelRegistry);
+
+class CancelConversationCommand {
+    constructor(input){
+        this.input = input;
+    }
+}
+CancelConversationCommand.type = '[Chat Conversation] Cancel';
+
+/**
+ * Protocol definition for pluggable memory backends.
+ *
+ * This module defines the BackendProtocol that all backend implementations
+ * must follow. Backends can store files in different locations (state, filesystem,
+ * database, etc.) and provide a uniform interface for file operations.
+ */ /**
+ * Type guard to check if a backend supports execution.
+ *
+ * @param backend - Backend instance to check
+ * @returns True if the backend implements SandboxBackendProtocol
+ */ function isSandboxBackend(backend) {
+    return typeof backend.execute === "function" && typeof backend.id === "string";
+}
+
+/**
+ * BaseSandbox: Abstract base class for sandbox backends with command execution.
+ *
+ * This class provides default implementations for all SandboxBackendProtocol
+ * methods using shell commands executed via execute(). Concrete implementations
+ * only need to implement the execute() method.
+ *
+ * Requires Node.js 20+ on the sandbox host.
+ */ const MAX_LINE_LENGTH = 500;
+const MAX_GREP_LINE_LENGTH = 2000;
+const GREP_RESULT_LIMIT = 100;
+const GLOB_RESULT_LIMIT = 100;
+const WRITE_EXISTS_OUTPUT = "Error: File already exists";
+/**
+ * UTF-8 safe Base64 encoding function.
+ * Replaces btoa() which only supports Latin1 characters.
+ */ function utf8ToBase64(str) {
+    return Buffer.from(str, 'utf-8').toString('base64');
+}
+/**
+ * Format glob results into human-readable output.
+ */ function formatGlobOutput(files, pattern) {
+    const limit = GLOB_RESULT_LIMIT;
+    const truncated = files.length > limit;
+    const finalFiles = truncated ? files.slice(0, limit) : files;
+    if (finalFiles.length === 0) {
+        return "No files found";
+    }
+    const lines = [];
+    for (const file of finalFiles){
+        lines.push(file.path);
+    }
+    if (truncated) {
+        lines.push("");
+        lines.push("(Results truncated. Consider using a more specific path or pattern.)");
+    }
+    return lines.join("\n");
+}
+/**
+ * Format grep matches into human-readable output grouped by file.
+ */ function formatGrepOutput(matches) {
+    const limit = GREP_RESULT_LIMIT;
+    const truncated = matches.length > limit;
+    const finalMatches = truncated ? matches.slice(0, limit) : matches;
+    if (finalMatches.length === 0) {
+        return "No matches found";
+    }
+    const lines = [
+        `Found ${finalMatches.length} matches`
+    ];
+    let currentFile = "";
+    for (const match of finalMatches){
+        if (currentFile !== match.path) {
+            if (currentFile !== "") {
+                lines.push("");
+            }
+            currentFile = match.path;
+            lines.push(`${match.path}:`);
+        }
+        const text = match.text.length > MAX_GREP_LINE_LENGTH ? match.text.substring(0, MAX_GREP_LINE_LENGTH) + "..." : match.text;
+        lines.push(`  Line ${match.line}: ${text}`);
+    }
+    if (truncated) {
+        lines.push("");
+        lines.push("(Results truncated. Consider using a more specific path or pattern.)");
+    }
+    return lines.join("\n");
+}
+/**
+ * Node.js command template for glob operations.
+ * Uses web-standard atob() for base64 decoding.
+ */ function buildGlobCommand(searchPath, pattern) {
+    const pathB64 = utf8ToBase64(searchPath);
+    const patternB64 = utf8ToBase64(pattern);
+    return `node -e "
+const fs = require('fs');
+const path = require('path');
+
+const searchPath = Buffer.from('${pathB64}', 'base64').toString('utf-8');
+const pattern = Buffer.from('${patternB64}', 'base64').toString('utf-8');
+
+function globMatch(relativePath, pattern) {
+  const regexPattern = pattern
+    .replace(/\\*\\*/g, '<<<GLOBSTAR>>>')
+    .replace(/\\*/g, '[^/]*')
+    .replace(/\\?/g, '.')
+    .replace(/<<<GLOBSTAR>>>/g, '.*');
+  return new RegExp('^' + regexPattern + '$').test(relativePath);
+}
+
+function walkDir(dir, baseDir, results) {
+  try {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+      const relativePath = path.relative(baseDir, fullPath);
+      if (entry.isDirectory()) {
+        walkDir(fullPath, baseDir, results);
+      } else if (globMatch(relativePath, pattern)) {
+        const stat = fs.statSync(fullPath);
+        console.log(JSON.stringify({
+          path: relativePath,
+          size: stat.size,
+          mtime: stat.mtimeMs,
+          isDir: false
+        }));
+      }
+    }
+  } catch (e) {
+    // Silent failure for non-existent paths
+  }
+}
+
+try {
+  process.chdir(searchPath);
+  walkDir('.', '.', []);
+} catch (e) {
+  // Silent failure for non-existent paths
+}
+"`;
+}
+/**
+ * Node.js command template for listing directory contents.
+ */ function buildLsCommand(dirPath) {
+    const pathB64 = utf8ToBase64(dirPath);
+    return `node -e "
+const fs = require('fs');
+const path = require('path');
+
+const dirPath = Buffer.from('${pathB64}', 'base64').toString('utf-8');
+
+try {
+  const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dirPath, entry.name);
+    const stat = fs.statSync(fullPath);
+    console.log(JSON.stringify({
+      path: entry.isDirectory() ? fullPath + '/' : fullPath,
+      size: stat.size,
+      mtime: stat.mtimeMs,
+      isDir: entry.isDirectory()
+    }));
+  }
+} catch (e) {
+  console.error('Error: ' + e.message);
+  process.exit(1);
+}
+"`;
+}
+const INDENTATION_SPACES = 2;
+const MAX_ENTRY_LENGTH = 500;
+/**
+ * Node.js command template for recursive directory listing with depth control.
+ */ function buildListDirCommand(dirPath, offset, limit, depth) {
+    const pathB64 = utf8ToBase64(dirPath);
+    const safeOffset = Number.isFinite(offset) && offset > 0 ? Math.floor(offset) : 1;
+    const safeLimit = Number.isFinite(limit) && limit > 0 ? Math.floor(limit) : 25;
+    const safeDepth = Number.isFinite(depth) && depth > 0 ? Math.floor(depth) : 2;
+    return `node -e "
+const fs = require('fs');
+const path = require('path');
+
+const dirPath = Buffer.from('${pathB64}', 'base64').toString('utf-8');
+const offset = ${safeOffset};
+const limit = ${safeLimit};
+const maxDepth = ${safeDepth};
+const INDENTATION_SPACES = ${INDENTATION_SPACES};
+const MAX_ENTRY_LENGTH = ${MAX_ENTRY_LENGTH};
+
+if (!path.isAbsolute(dirPath)) {
+  console.error('Error: dir_path must be an absolute path');
+  process.exit(1);
+}
+
+if (!fs.existsSync(dirPath)) {
+  console.error('Error: Directory not found');
+  process.exit(1);
+}
+
+if (!fs.statSync(dirPath).isDirectory()) {
+  console.error('Error: Path is not a directory');
+  process.exit(1);
+}
+
+function collectEntries(currentPath, relativePrefix, remainingDepth, entries) {
+  if (remainingDepth === 0) return;
+
+  try {
+    const dirEntries = fs.readdirSync(currentPath, { withFileTypes: true });
+    const sortedEntries = dirEntries
+      .map(entry => {
+        const fullPath = path.join(currentPath, entry.name);
+        const relativePath = path.join(relativePrefix, entry.name);
+        const displayName = entry.name.length > MAX_ENTRY_LENGTH
+          ? entry.name.substring(0, MAX_ENTRY_LENGTH)
+          : entry.name;
+
+        let kind = 'file';
+        if (entry.isSymbolicLink()) kind = 'symlink';
+        else if (entry.isDirectory()) kind = 'directory';
+
+        return {
+          fullPath,
+          relativePath,
+          displayName,
+          kind,
+          depth: relativePrefix.split(path.sep).filter(Boolean).length
+        };
+      })
+      .sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+
+    for (const entry of sortedEntries) {
+      entries.push(entry);
+      if (entry.kind === 'directory' && remainingDepth > 1) {
+        collectEntries(entry.fullPath, entry.relativePath, remainingDepth - 1, entries);
+      }
+    }
+  } catch (e) {
+    // Skip unreadable directories
+  }
+}
+
+const allEntries = [];
+collectEntries(dirPath, '', maxDepth, allEntries);
+
+if (allEntries.length === 0) {
+  console.log('Absolute path: ' + dirPath);
+  console.log('(Empty directory)');
+  process.exit(0);
+}
+
+const startIndex = offset - 1;
+if (startIndex >= allEntries.length) {
+  console.error('Error: offset exceeds directory entry count');
+  process.exit(1);
+}
+
+const endIndex = Math.min(startIndex + limit, allEntries.length);
+const selectedEntries = allEntries.slice(startIndex, endIndex);
+
+console.log('Absolute path: ' + dirPath);
+
+for (const entry of selectedEntries) {
+  const indent = ' '.repeat(entry.depth * INDENTATION_SPACES);
+  let name = entry.displayName;
+  if (entry.kind === 'directory') name += '/';
+  else if (entry.kind === 'symlink') name += '@';
+  console.log(indent + name);
+}
+
+if (endIndex < allEntries.length) {
+  console.log('More than ' + limit + ' entries found');
+}
+"`;
+}
+const TAB_WIDTH = 4;
+const COMMENT_PREFIXES = [
+    '#',
+    '//',
+    '--'
+];
+/**
+ * Node.js command template for slice mode reading.
+ */ function buildSliceReadCommand(filePath, offset, limit) {
+    const pathB64 = utf8ToBase64(filePath);
+    const safeOffset = Number.isFinite(offset) && offset > 0 ? Math.floor(offset) - 1 : 0;
+    const safeLimit = Number.isFinite(limit) && limit > 0 && limit < Number.MAX_SAFE_INTEGER ? Math.floor(limit) : 2000;
+    return `node -e "
+const fs = require('fs');
+const MAX_LINE_LENGTH = ${MAX_LINE_LENGTH};
+
+const filePath = Buffer.from('${pathB64}', 'base64').toString('utf-8');
+const offset = ${safeOffset};
+const limit = ${safeLimit};
+
+if (!fs.existsSync(filePath)) {
+  console.log('Error: File not found');
+  process.exit(1);
+}
+
+const stat = fs.statSync(filePath);
+if (stat.size === 0) {
+  console.log('System reminder: File exists but has empty contents');
+  process.exit(0);
+}
+
+const content = fs.readFileSync(filePath, 'utf-8');
+const lines = content.split('\\n');
+
+if (offset >= lines.length) {
+  console.log('Error: offset exceeds file length');
+  process.exit(1);
+}
+
+const selected = lines.slice(offset, offset + limit);
+
+for (let i = 0; i < selected.length; i++) {
+  const lineNum = offset + i + 1;
+  let line = selected[i];
+  if (line.length > MAX_LINE_LENGTH) {
+    line = line.substring(0, MAX_LINE_LENGTH);
+  }
+  console.log('L' + lineNum + ': ' + line);
+}
+"`;
+}
+/**
+ * Node.js command template for indentation mode reading.
+ */ function buildIndentationReadCommand(filePath, offset, limit, options) {
+    const pathB64 = utf8ToBase64(filePath);
+    const safeOffset = Number.isFinite(offset) && offset > 0 ? Math.floor(offset) : 1;
+    const safeLimit = Number.isFinite(limit) && limit > 0 && limit < Number.MAX_SAFE_INTEGER ? Math.floor(limit) : 2000;
+    var _options_anchor_line;
+    const anchorLine = (_options_anchor_line = options.anchor_line) != null ? _options_anchor_line : safeOffset;
+    var _options_max_levels;
+    const maxLevels = (_options_max_levels = options.max_levels) != null ? _options_max_levels : 0;
+    var _options_include_siblings;
+    const includeSiblings = (_options_include_siblings = options.include_siblings) != null ? _options_include_siblings : false;
+    var _options_include_header;
+    const includeHeader = (_options_include_header = options.include_header) != null ? _options_include_header : true;
+    var _options_max_lines;
+    const maxLines = (_options_max_lines = options.max_lines) != null ? _options_max_lines : safeLimit;
+    return `node -e "
+const fs = require('fs');
+const MAX_LINE_LENGTH = ${MAX_LINE_LENGTH};
+const TAB_WIDTH = ${TAB_WIDTH};
+const COMMENT_PREFIXES = ${JSON.stringify(COMMENT_PREFIXES)};
+
+const filePath = Buffer.from('${pathB64}', 'base64').toString('utf-8');
+const anchorLine = ${anchorLine};
+const limit = ${safeLimit};
+const maxLevels = ${maxLevels};
+const includeSiblings = ${includeSiblings};
+const includeHeader = ${includeHeader};
+const maxLines = ${maxLines};
+
+if (!fs.existsSync(filePath)) {
+  console.log('Error: File not found');
+  process.exit(1);
+}
+
+const content = fs.readFileSync(filePath, 'utf-8');
+const rawLines = content.split('\\n');
+
+if (rawLines.length === 0 || anchorLine > rawLines.length) {
+  console.log('Error: anchor_line exceeds file length');
+  process.exit(1);
+}
+
+function measureIndent(line) {
+  let indent = 0;
+  for (const c of line) {
+    if (c === ' ') indent++;
+    else if (c === '\\t') indent += TAB_WIDTH;
+    else break;
+  }
+  return indent;
+}
+
+function isBlank(line) { return line.trim() === ''; }
+function isComment(line) { return COMMENT_PREFIXES.some(p => line.trim().startsWith(p)); }
+function formatLine(line) { return line.length > MAX_LINE_LENGTH ? line.substring(0, MAX_LINE_LENGTH) : line; }
+
+const records = rawLines.map((raw, i) => ({
+  number: i + 1,
+  raw,
+  display: formatLine(raw),
+  indent: measureIndent(raw)
+}));
+
+const effectiveIndents = [];
+let prevIndent = 0;
+for (const r of records) {
+  if (isBlank(r.raw)) {
+    effectiveIndents.push(prevIndent);
+  } else {
+    prevIndent = r.indent;
+    effectiveIndents.push(prevIndent);
+  }
+}
+
+const anchorIndex = anchorLine - 1;
+const anchorIndent = effectiveIndents[anchorIndex];
+const minIndent = maxLevels === 0 ? 0 : Math.max(0, anchorIndent - maxLevels * TAB_WIDTH);
+const finalLimit = Math.min(limit, maxLines, records.length);
+
+if (finalLimit === 1) {
+  console.log('L' + records[anchorIndex].number + ': ' + records[anchorIndex].display);
+  process.exit(0);
+}
+
+const out = [records[anchorIndex]];
+let i = anchorIndex - 1;
+let j = anchorIndex + 1;
+let iCounterMinIndent = 0;
+let jCounterMinIndent = 0;
+
+while (out.length < finalLimit) {
+  let progressed = 0;
+
+  if (i >= 0) {
+    if (effectiveIndents[i] >= minIndent) {
+      out.unshift(records[i]);
+      progressed++;
+      const curI = i;
+      i--;
+
+      if (effectiveIndents[curI] === minIndent && !includeSiblings) {
+        const allowHeaderComment = includeHeader && isComment(records[curI].raw);
+        const canTakeLine = allowHeaderComment || iCounterMinIndent === 0;
+        if (canTakeLine) {
+          iCounterMinIndent++;
+        } else {
+          out.shift();
+          progressed--;
+          i = -1;
+        }
+      }
+
+      if (out.length >= finalLimit) break;
+    } else {
+      i = -1;
+    }
+  }
+
+  if (j < records.length) {
+    if (effectiveIndents[j] >= minIndent) {
+      out.push(records[j]);
+      progressed++;
+      const curJ = j;
+      j++;
+
+      if (effectiveIndents[curJ] === minIndent && !includeSiblings) {
+        if (jCounterMinIndent > 0) {
+          out.pop();
+          progressed--;
+          j = records.length;
+        }
+        jCounterMinIndent++;
+      }
+    } else {
+      j = records.length;
+    }
+  }
+
+  if (progressed === 0) break;
+}
+
+while (out.length > 0 && isBlank(out[0].raw)) out.shift();
+while (out.length > 0 && isBlank(out[out.length - 1].raw)) out.pop();
+
+for (const r of out) {
+  console.log('L' + r.number + ': ' + r.display);
+}
+"`;
+}
+/**
+ * Node.js command template for writing files.
+ */ function buildWriteCommand(filePath, content) {
+    const pathB64 = utf8ToBase64(filePath);
+    const contentB64 = utf8ToBase64(content);
+    return `node -e "
+const fs = require('fs');
+const path = require('path');
+
+const filePath = Buffer.from('${pathB64}', 'base64').toString('utf-8');
+const content = Buffer.from('${contentB64}', 'base64').toString('utf-8');
+
+if (fs.existsSync(filePath)) {
+  console.error('${WRITE_EXISTS_OUTPUT}');
+  process.exit(1);
+}
+
+const parentDir = path.dirname(filePath) || '.';
+fs.mkdirSync(parentDir, { recursive: true });
+
+fs.writeFileSync(filePath, content, 'utf-8');
+console.log('OK');
+"`;
+}
+function buildExistsCommand(filePath) {
+    const pathB64 = utf8ToBase64(filePath);
+    return `node -e "
+const fs = require('fs');
+const filePath = Buffer.from('${pathB64}', 'base64').toString('utf-8');
+process.exit(fs.existsSync(filePath) ? 0 : 1);
+"`;
+}
+/**
+ * Node.js command template for appending to files.
+ */ function buildAppendCommand(filePath, content) {
+    const pathB64 = utf8ToBase64(filePath);
+    const contentB64 = utf8ToBase64(content);
+    return `node -e "
+const fs = require('fs');
+const path = require('path');
+
+const filePath = Buffer.from('${pathB64}', 'base64').toString('utf-8');
+const content = Buffer.from('${contentB64}', 'base64').toString('utf-8');
+
+const parentDir = path.dirname(filePath) || '.';
+fs.mkdirSync(parentDir, { recursive: true });
+
+fs.appendFileSync(filePath, content, 'utf-8');
+console.log('OK');
+"`;
+}
+/**
+ * Node.js command template for editing files.
+ */ function buildEditCommand(filePath, oldStr, newStr, replaceAll) {
+    const pathB64 = utf8ToBase64(filePath);
+    const oldB64 = utf8ToBase64(oldStr);
+    const newB64 = utf8ToBase64(newStr);
+    return `node -e "
+const fs = require('fs');
+
+const filePath = Buffer.from('${pathB64}', 'base64').toString('utf-8');
+const oldStr = Buffer.from('${oldB64}', 'base64').toString('utf-8');
+const newStr = Buffer.from('${newB64}', 'base64').toString('utf-8');
+const replaceAll = ${Boolean(replaceAll)};
+
+let text;
+try {
+  text = fs.readFileSync(filePath, 'utf-8');
+} catch (e) {
+  process.exit(3);
+}
+
+const count = text.split(oldStr).length - 1;
+
+if (count === 0) {
+  process.exit(1);
+}
+if (count > 1 && !replaceAll) {
+  process.exit(2);
+}
+
+const result = text.split(oldStr).join(newStr);
+fs.writeFileSync(filePath, result, 'utf-8');
+console.log(count);
+"`;
+}
+/**
+ * Node.js command template for grep operations.
+ */ function buildGrepCommand(pattern, searchPath, globPattern) {
+    const patternB64 = utf8ToBase64(pattern);
+    const pathB64 = utf8ToBase64(searchPath);
+    const globB64 = globPattern ? utf8ToBase64(globPattern) : "";
+    return `node -e "
+const fs = require('fs');
+const path = require('path');
+
+const pattern = Buffer.from('${patternB64}', 'base64').toString('utf-8');
+const searchPath = Buffer.from('${pathB64}', 'base64').toString('utf-8');
+const globPattern = ${globPattern ? `Buffer.from('${globB64}', 'base64').toString('utf-8')` : "null"};
+
+let regex;
+try {
+  regex = new RegExp(pattern);
+} catch (e) {
+  console.error('Invalid regex: ' + e.message);
+  process.exit(1);
+}
+
+function globMatch(filePath, pattern) {
+  if (!pattern) return true;
+  const regexPattern = pattern
+    .replace(/\\*\\*/g, '<<<GLOBSTAR>>>')
+    .replace(/\\*/g, '[^/]*')
+    .replace(/\\?/g, '.')
+    .replace(/<<<GLOBSTAR>>>/g, '.*');
+  return new RegExp('^' + regexPattern + '$').test(filePath);
+}
+
+function walkDir(dir, results) {
+  try {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        walkDir(fullPath, results);
+      } else {
+        const relativePath = path.relative(searchPath, fullPath);
+        if (globMatch(relativePath, globPattern)) {
+          try {
+            const content = fs.readFileSync(fullPath, 'utf-8');
+            const lines = content.split('\\n');
+            for (let i = 0; i < lines.length; i++) {
+              if (regex.test(lines[i])) {
+                console.log(JSON.stringify({
+                  path: fullPath,
+                  line: i + 1,
+                  text: lines[i]
+                }));
+              }
+            }
+          } catch (e) {
+            // Skip unreadable files
+          }
+        }
+      }
+    }
+  } catch (e) {
+    // Skip unreadable directories
+  }
+}
+
+try {
+  walkDir(searchPath, []);
+} catch (e) {
+  // Silent failure
+}
+"`;
+}
+/**
+ * Base sandbox implementation with execute() as the only abstract method.
+ *
+ * This class provides default implementations for all SandboxBackendProtocol
+ * methods using shell commands executed via execute(). Concrete implementations
+ * only need to implement the execute() method.
+ *
+ * Requires Node.js 20+ on the sandbox host.
+ */ class BaseSandbox {
+    async streamExecute(command, onLine) {
+        const result = await this.execute(command);
+        if (result.output) {
+            onLine(result.output);
+        }
+        return result;
+    }
+    /**
+   * List files and directories in the specified directory (non-recursive).
+   *
+   * @param path - Absolute path to directory
+   * @returns List of FileInfo objects for files and directories directly in the directory.
+   */ async lsInfo(path) {
+        const command = buildLsCommand(path);
+        const result = await this.execute(command);
+        if (result.exitCode !== 0) {
+            return [];
+        }
+        const infos = [];
+        const lines = result.output.trim().split("\n").filter(Boolean);
+        for (const line of lines){
+            try {
+                const parsed = JSON.parse(line);
+                infos.push({
+                    path: parsed.path,
+                    is_dir: parsed.isDir,
+                    size: parsed.size,
+                    modified_at: parsed.mtime ? new Date(parsed.mtime).toISOString() : undefined
+                });
+            } catch (e) {
+            // Skip invalid JSON lines
+            }
+        }
+        return infos;
+    }
+    /**
+   * List directory contents recursively with depth control and pagination.
+   *
+   * @param dirPath - Absolute path to directory
+   * @param offset - 1-indexed entry number to start from (default: 1)
+   * @param limit - Maximum number of entries to return (default: 25)
+   * @param depth - Maximum depth to traverse (default: 2)
+   * @returns Human-readable directory tree with indentation
+   */ async listDir(dirPath, offset = 1, limit = 25, depth = 2) {
+        if (offset < 1) {
+            return "Error: offset must be a 1-indexed entry number";
+        }
+        if (limit < 1) {
+            return "Error: limit must be greater than zero";
+        }
+        if (depth < 1) {
+            return "Error: depth must be greater than zero";
+        }
+        const command = buildListDirCommand(dirPath, offset, limit, depth);
+        const result = await this.execute(command);
+        if (result.exitCode !== 0) {
+            return result.output || `Error: Failed to list directory '${dirPath}'`;
+        }
+        return result.output;
+    }
+    /**
+   * Read file content with line numbers.
+   *
+   * @param filePath - Absolute file path
+   * @param offset - Line offset to start reading from (1-indexed)
+   * @param limit - Maximum number of lines to read
+   * @param mode - Read mode: 'slice' (default) or 'indentation'
+   * @param indentation - Configuration for indentation mode
+   * @returns Formatted file content with line numbers, or error message
+   */ async read(filePath, offset = 1, limit = 2000, mode = 'slice', indentation) {
+        const command = mode === 'indentation' ? buildIndentationReadCommand(filePath, offset, limit, indentation != null ? indentation : {}) : buildSliceReadCommand(filePath, offset, limit);
+        const result = await this.execute(command);
+        if (result.exitCode !== 0) {
+            return result.output || `Error: File '${filePath}' not found`;
+        }
+        return result.output;
+    }
+    /**
+   * Structured search results or error string for invalid input.
+   */ async grepRaw(pattern, path = "/", include = null) {
+        const command = buildGrepCommand(pattern, path, include);
+        const result = await this.execute(command);
+        if (result.exitCode === 1) {
+            // Check if it's a regex error
+            if (result.output.includes("Invalid regex:")) {
+                return result.output.trim();
+            }
+        }
+        const matches = [];
+        const lines = result.output.trim().split("\n").filter(Boolean);
+        for (const line of lines){
+            try {
+                const parsed = JSON.parse(line);
+                matches.push({
+                    path: parsed.path,
+                    line: parsed.line,
+                    text: parsed.text
+                });
+            } catch (e) {
+            // Skip invalid JSON lines
+            }
+        }
+        return matches;
+    }
+    /**
+   * Search file contents for a regex pattern, returning human-readable output.
+   */ async grep(pattern, path = "/", include = null) {
+        const result = await this.grepRaw(pattern, path, include);
+        if (typeof result === "string") {
+            return result;
+        }
+        if (result.length === 0) {
+            return "No matches found";
+        }
+        return formatGrepOutput(result);
+    }
+    /**
+   * Structured glob matching returning FileInfo objects.
+   */ async globInfo(pattern, path = "/") {
+        const command = buildGlobCommand(path, pattern);
+        const result = await this.execute(command);
+        const infos = [];
+        const lines = result.output.trim().split("\n").filter(Boolean);
+        for (const line of lines){
+            try {
+                const parsed = JSON.parse(line);
+                infos.push({
+                    path: parsed.path,
+                    is_dir: parsed.isDir,
+                    size: parsed.size,
+                    modified_at: parsed.mtime ? new Date(parsed.mtime).toISOString() : undefined
+                });
+            } catch (e) {
+            // Skip invalid JSON lines
+            }
+        }
+        return infos;
+    }
+    /**
+   * Find files matching a glob pattern, returning human-readable output.
+   */ async glob(pattern, path = "/") {
+        const files = await this.globInfo(pattern, path);
+        if (files.length === 0) {
+            return "No files found";
+        }
+        return formatGlobOutput(files);
+    }
+    /**
+   * Create a new file with content.
+   */ async write(filePath, content) {
+        const command = buildWriteCommand(filePath, content);
+        const result = await this.execute(command);
+        if (result.exitCode !== 0) {
+            const output = (result.output || "").trim();
+            if (output.includes(WRITE_EXISTS_OUTPUT)) {
+                return {
+                    error: `Cannot write to ${filePath} because it already exists. Read and then make an edit, or write to a new path.`
+                };
+            }
+            const fallback = await this.writeViaUpload(filePath, content);
+            if (!fallback.error) {
+                return fallback;
+            }
+            return {
+                error: output ? `Failed to write file '${filePath}': ${output}` : `Failed to write file '${filePath}'.`
+            };
+        }
+        return {
+            path: filePath,
+            filesUpdate: null
+        };
+    }
+    async writeViaUpload(filePath, content) {
+        const existsCheck = await this.execute(buildExistsCommand(filePath));
+        if (existsCheck.exitCode === 0) {
+            return {
+                error: `Cannot write to ${filePath} because it already exists. Read and then make an edit, or write to a new path.`
+            };
+        }
+        const uploads = await this.uploadFiles([
+            [
+                filePath,
+                Buffer.from(content, "utf-8")
+            ]
+        ]);
+        const first = uploads[0];
+        if (!first) {
+            return {
+                error: `Failed to write file '${filePath}': upload returned no result.`
+            };
+        }
+        if (first.error) {
+            return {
+                error: `Failed to write file '${filePath}': ${first.error}`
+            };
+        }
+        return {
+            path: filePath,
+            filesUpdate: null
+        };
+    }
+    /**
+   * Append content to a file. Creates the file if it doesn't exist.
+   */ async append(filePath, content) {
+        const command = buildAppendCommand(filePath, content);
+        const result = await this.execute(command);
+        if (result.exitCode !== 0) {
+            const output = (result.output || "").trim();
+            return {
+                error: output ? `Failed to append to file '${filePath}': ${output}` : `Failed to append to file '${filePath}'.`
+            };
+        }
+        return {
+            path: filePath,
+            filesUpdate: null
+        };
+    }
+    /**
+   * Edit a file by replacing string occurrences.
+   */ async edit(filePath, oldString, newString, replaceAll = false) {
+        const command = buildEditCommand(filePath, oldString, newString, replaceAll);
+        const result = await this.execute(command);
+        switch(result.exitCode){
+            case 0:
+                {
+                    const occurrences = parseInt(result.output.trim(), 10) || 1;
+                    return {
+                        path: filePath,
+                        filesUpdate: null,
+                        occurrences
+                    };
+                }
+            case 1:
+                return {
+                    error: `String not found in file '${filePath}'`
+                };
+            case 2:
+                return {
+                    error: `Multiple occurrences found in '${filePath}'. Use replaceAll=true to replace all.`
+                };
+            case 3:
+                return {
+                    error: `Error: File '${filePath}' not found`
+                };
+            default:
+                return {
+                    error: `Unknown error editing file '${filePath}'`
+                };
+        }
+    }
+    /**
+   * Perform multiple sequential edits on a single file.
+   * All edits are applied sequentially, with each edit operating on the result of the previous edit.
+   * All edits must succeed for the operation to succeed (atomic).
+   */ async multiEdit(filePath, edits) {
+        if (!edits || edits.length === 0) {
+            return {
+                error: "No edits provided"
+            };
+        }
+        const results = [];
+        for (const edit of edits){
+            var _edit_replaceAll;
+            const result = await this.edit(filePath, edit.oldString, edit.newString, (_edit_replaceAll = edit.replaceAll) != null ? _edit_replaceAll : false);
+            results.push(result);
+            // If any edit fails, return immediately with error
+            if (result.error) {
+                return {
+                    error: `Multi-edit failed at edit ${results.length}: ${result.error}`,
+                    path: filePath,
+                    filesUpdate: null,
+                    results
+                };
+            }
+        }
+        // All edits succeeded
+        return {
+            path: filePath,
+            filesUpdate: null,
+            results
+        };
+    }
+}
+
+const SANDBOX_PROVIDER = 'SANDBOX_PROVIDER';
+const SandboxProviderStrategy = (provider)=>common.applyDecorators(common.SetMetadata(SANDBOX_PROVIDER, provider), common.SetMetadata(STRATEGY_META_KEY, SANDBOX_PROVIDER));
+
+exports.SandboxProviderRegistry = class SandboxProviderRegistry extends BaseStrategyRegistry {
+    constructor(discoveryService, reflector){
+        super(SANDBOX_PROVIDER, discoveryService, reflector);
+    }
+};
+exports.SandboxProviderRegistry = __decorate([
+    common.Injectable(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [
+        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
+        typeof core.Reflector === "undefined" ? Object : core.Reflector
+    ])
+], exports.SandboxProviderRegistry);
+
 Object.defineProperty(exports, "IColumnDef", {
 	enumerable: true,
 	get: function () { return contracts.IColumnDef; }
@@ -2335,32 +3590,45 @@ Object.defineProperty(exports, "TDocumentAsset", {
 	enumerable: true,
 	get: function () { return contracts.TDocumentAsset; }
 });
+exports.AGENT_CHAT_DISPATCH_MESSAGE_TYPE = AGENT_CHAT_DISPATCH_MESSAGE_TYPE;
 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.AdapterDataSourceStrategy = AdapterDataSourceStrategy;
 exports.AgentMiddlewareStrategy = AgentMiddlewareStrategy;
 exports.AiModelNotFoundException = AiModelNotFoundException;
 exports.BaseHTTPQueryRunner = BaseHTTPQueryRunner;
 exports.BaseQueryRunner = BaseQueryRunner;
 exports.BaseSQLQueryRunner = BaseSQLQueryRunner;
+exports.BaseSandbox = BaseSandbox;
 exports.BaseStrategyRegistry = BaseStrategyRegistry;
 exports.BaseTool = BaseTool;
 exports.BaseToolset = BaseToolset;
 exports.BuiltinToolset = BuiltinToolset;
+exports.CHAT_CHANNEL = CHAT_CHANNEL;
+exports.CHAT_CHANNEL_TEXT_LIMITS = CHAT_CHANNEL_TEXT_LIMITS;
+exports.CancelConversationCommand = CancelConversationCommand;
+exports.ChatChannel = ChatChannel;
 exports.ChatOAICompatReasoningModel = ChatOAICompatReasoningModel;
 exports.CommonParameterRules = CommonParameterRules;
 exports.CreateModelClientCommand = CreateModelClientCommand;
 exports.CredentialsValidateFailedError = CredentialsValidateFailedError;
 exports.DATASOURCE_STRATEGY = DATASOURCE_STRATEGY;
+exports.DEFAULT_EXECUTION_CONFIG = DEFAULT_EXECUTION_CONFIG;
 exports.DOCUMENT_SOURCE_STRATEGY = DOCUMENT_SOURCE_STRATEGY;
 exports.DOCUMENT_TRANSFORMER_STRATEGY = DOCUMENT_TRANSFORMER_STRATEGY;
 exports.DataSourceStrategy = DataSourceStrategy;
 exports.DocumentSourceStrategy = DocumentSourceStrategy;
 exports.DocumentTransformerStrategy = DocumentTransformerStrategy;
 exports.GLOBAL_ORGANIZATION_SCOPE = GLOBAL_ORGANIZATION_SCOPE;
+exports.HANDOFF_PERMISSION_SERVICE_TOKEN = HANDOFF_PERMISSION_SERVICE_TOKEN;
+exports.HANDOFF_PROCESSOR_STRATEGY = HANDOFF_PROCESSOR_STRATEGY;
+exports.HANDOFF_QUEUE_SERVICE_TOKEN = HANDOFF_QUEUE_SERVICE_TOKEN;
+exports.HandoffProcessorStrategy = HandoffProcessorStrategy;
 exports.IMAGE_UNDERSTANDING_STRATEGY = IMAGE_UNDERSTANDING_STRATEGY;
+exports.INTEGRATION_PERMISSION_SERVICE_TOKEN = INTEGRATION_PERMISSION_SERVICE_TOKEN;
 exports.INTEGRATION_STRATEGY = INTEGRATION_STRATEGY;
 exports.ImageUnderstandingStrategy = ImageUnderstandingStrategy;
 exports.IntegrationStrategyKey = IntegrationStrategyKey;
@@ -2372,6 +3640,7 @@ exports.LLMUsage = LLMUsage;
 exports.LargeLanguageModel = LargeLanguageModel;
 exports.ORGANIZATION_METADATA_KEY = ORGANIZATION_METADATA_KEY;
 exports.OpenAICompatibleReranker = OpenAICompatibleReranker;
+exports.PERMISSION_OPERATION_METADATA_KEY = PERMISSION_OPERATION_METADATA_KEY;
 exports.PLUGIN_METADATA = PLUGIN_METADATA;
 exports.PLUGIN_METADATA_KEY = PLUGIN_METADATA_KEY;
 exports.PROVIDE_AI_MODEL_LLM = PROVIDE_AI_MODEL_LLM;
@@ -2382,9 +3651,12 @@ exports.PROVIDE_AI_MODEL_TEXT_EMBEDDING = PROVIDE_AI_MODEL_TEXT_EMBEDDING;
 exports.PROVIDE_AI_MODEL_TTS = PROVIDE_AI_MODEL_TTS;
 exports.RETRIEVER_STRATEGY = RETRIEVER_STRATEGY;
 exports.RequestContext = RequestContext;
+exports.RequirePermissionOperation = RequirePermissionOperation;
 exports.RerankModel = RerankModel;
 exports.RetrieverStrategy = RetrieverStrategy;
+exports.SANDBOX_PROVIDER = SANDBOX_PROVIDER;
 exports.STRATEGY_META_KEY = STRATEGY_META_KEY;
+exports.SandboxProviderStrategy = SandboxProviderStrategy;
 exports.Speech2TextChatModel = Speech2TextChatModel;
 exports.SpeechToTextModel = SpeechToTextModel;
 exports.TEXT_SPLITTER_STRATEGY = TEXT_SPLITTER_STRATEGY;
@@ -2393,6 +3665,7 @@ exports.TextEmbeddingModelManager = TextEmbeddingModelManager;
 exports.TextSplitterStrategy = TextSplitterStrategy;
 exports.TextToSpeechModel = TextToSpeechModel;
 exports.ToolsetStrategy = ToolsetStrategy;
+exports.USER_PERMISSION_SERVICE_TOKEN = USER_PERMISSION_SERVICE_TOKEN;
 exports.VECTOR_STORE_STRATEGY = VECTOR_STORE_STRATEGY;
 exports.VectorStoreStrategy = VectorStoreStrategy;
 exports.WORKFLOW_NODE_STRATEGY = WORKFLOW_NODE_STRATEGY;
@@ -2404,17 +3677,26 @@ exports.XpFileSystem = XpFileSystem;
 exports.XpertServerPlugin = XpertServerPlugin;
 exports.als = als;
 exports.calcTokenUsage = calcTokenUsage;
+exports.chunkText = chunkText;
 exports.countTokensSafe = countTokensSafe;
 exports.createI18nInstance = createI18nInstance;
 exports.createPluginLogger = createPluginLogger;
+exports.defineAgentMessageType = defineAgentMessageType;
+exports.defineChannelMessageType = defineChannelMessageType;
 exports.downloadRemoteFile = downloadRemoteFile;
 exports.getErrorMessage = getErrorMessage;
+exports.getModelContextSize = getModelContextSize;
+exports.getPermissionOperationMetadata = getPermissionOperationMetadata;
 exports.getPositionList = getPositionList;
 exports.getPositionMap = getPositionMap;
 exports.getRequestContext = getRequestContext;
+exports.getRequiredPermissionOperation = getRequiredPermissionOperation;
 exports.isRemoteFile = isRemoteFile;
+exports.isSandboxBackend = isSandboxBackend;
+exports.isStructuredMessageType = isStructuredMessageType;
 exports.loadYamlFile = loadYamlFile;
 exports.mergeCredentials = mergeCredentials;
 exports.mergeParentChildChunks = mergeParentChildChunks;
+exports.normalizeContextSize = normalizeContextSize;
 exports.runWithRequestContext = runWithRequestContext;
 exports.sumTokenUsage = sumTokenUsage;