@xpert-ai/plugin-sdk 3.8.3 → 3.9.0-beta.0

package/index.esm.js

@@ -1,10 +1,9 @@
-import { Module, Logger, applyDecorators, SetMetadata, HttpException, HttpStatus, Injectable, Inject, NotFoundException, ForbiddenException } from '@nestjs/common';
+import { Module, Logger, applyDecorators, SetMetadata, HttpException, HttpStatus, BadRequestException, Injectable, Inject, NotFoundException, ForbiddenException } from '@nestjs/common';
 import { MODULE_METADATA } from '@nestjs/common/constants';
 import { pick } from 'lodash-es';
 import { DiscoveryService, Reflector } from '@nestjs/core';
 import { Subject, filter } from 'rxjs';
 import { LanguagesEnum, AiModelTypeEnum, ParameterType, PriceType, FetchFrom, ModelFeature, ModelPropertyKey } from '@metad/contracts';
-export { IColumnDef, IDSSchema, IDSTable, TDocumentAsset } from '@metad/contracts';
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { ExtractJwt } from 'passport-jwt';
 import { verify, JsonWebTokenError } from 'jsonwebtoken';
@@ -38,11 +37,11 @@ import { getModelContextSize as getModelContextSize$1 } from '@langchain/core/la
  * Metadata keys used in plugins for defining various aspects like entities, subscribers, and configurations.
  */ const PLUGIN_METADATA = {
     /**
-	 * Key representing the entities registered within the plugin.
-	 */ ENTITIES: 'entities',
+     * Key representing the entities registered within the plugin.
+     */ ENTITIES: 'entities',
     /**
-	 * Key representing event subscribers within the plugin.
-	 */ SUBSCRIBERS: 'subscribers'
+     * Key representing event subscribers within the plugin.
+     */ SUBSCRIBERS: 'subscribers'
 };
 
 /**
@@ -87,10 +86,10 @@ function _extends() {
 function createPluginLogger(scope, baseMeta = {}) {
     const nestLogger = new Logger(scope);
     const wrap = (level, msg, meta)=>{
-        var _nestLogger_level;
+        var // 保持与 Nest Logger 接口对齐
+        _nestLogger_level;
         const payload = meta ? _extends({}, baseMeta, meta) : baseMeta;
-        (_nestLogger_level = // 保持与 Nest Logger 接口对齐
-        nestLogger[level]) == null ? void 0 : _nestLogger_level.call(nestLogger, msg + (Object.keys(payload).length ? ` ${JSON.stringify(payload)}` : ''));
+        (_nestLogger_level = nestLogger[level]) == null ? void 0 : _nestLogger_level.call(nestLogger, msg + (Object.keys(payload).length ? ` ${JSON.stringify(payload)}` : ''));
     };
     return {
         child (meta) {
@@ -121,6 +120,8 @@ typeof SuppressedError === "function" ? SuppressedError : function _SuppressedEr
 };
 
 // request-context.ts
+const TENANT_SCOPE = 'tenant';
+const ORGANIZATION_SCOPE = 'organization';
 class RequestContext {
     static currentRequestContext() {
         const session = getRequestContext();
@@ -133,6 +134,11 @@ class RequestContext {
         }
         return null;
     }
+    static currentApiKey() {
+        const user = RequestContext.currentUser();
+        var _user_apiKey;
+        return (_user_apiKey = user == null ? void 0 : user.apiKey) != null ? _user_apiKey : null;
+    }
     static currentTenantId() {
         const user = RequestContext.currentUser();
         if (user) {
@@ -174,9 +180,9 @@ class RequestContext {
         ], throwError);
     }
     /**
-   * Retrieves the language code from the headers of the current request.
-   * @returns The language code (LanguagesEnum) extracted from the headers, or the default language (ENGLISH) if not found.
-   */ static getLanguageCode() {
+     * Retrieves the language code from the headers of the current request.
+     * @returns The language code (LanguagesEnum) extracted from the headers, or the default language (ENGLISH) if not found.
+     */ static getLanguageCode() {
         // Retrieve the current request
         const req = RequestContext.currentRequest();
         // Variable to store the extracted language code
@@ -192,21 +198,71 @@ class RequestContext {
         // Return the extracted language code or the default language (ENGLISH) if not found
         return lang || LanguagesEnum.English;
     }
-    static getOrganizationId() {
-        const req = this.currentRequest();
-        let organizationId;
-        const keys = [
+    static getScope() {
+        const request = this.currentRequest();
+        const user = this.currentUser();
+        var _user_tenantId, _ref;
+        const tenantId = (_ref = (_user_tenantId = user == null ? void 0 : user.tenantId) != null ? _user_tenantId : getHeaderValue(request, [
+            'tenant-id'
+        ])) != null ? _ref : null;
+        var _getHeaderValue;
+        const organizationId = (_getHeaderValue = getHeaderValue(request, [
             'organization-id'
-        ];
-        if (req) {
-            for (const key of keys){
-                if (req.headers && req.headers[key]) {
-                    organizationId = req.headers[key];
-                    break;
+        ])) != null ? _getHeaderValue : null;
+        const scopeLevelHeader = getHeaderValue(request, [
+            'x-scope-level'
+        ]);
+        if (scopeLevelHeader) {
+            if (scopeLevelHeader !== TENANT_SCOPE && scopeLevelHeader !== ORGANIZATION_SCOPE) {
+                throw new BadRequestException(`Unsupported scope level: ${scopeLevelHeader}`);
+            }
+            if (scopeLevelHeader === TENANT_SCOPE) {
+                if (organizationId) {
+                    throw new BadRequestException('Tenant scope requests must not include Organization-Id.');
                 }
+                return {
+                    tenantId,
+                    level: TENANT_SCOPE,
+                    organizationId: null
+                };
+            }
+            if (!organizationId) {
+                throw new BadRequestException('Organization scope requests require Organization-Id.');
             }
+            return {
+                tenantId,
+                level: ORGANIZATION_SCOPE,
+                organizationId
+            };
+        }
+        if (organizationId) {
+            return {
+                tenantId,
+                level: ORGANIZATION_SCOPE,
+                organizationId
+            };
         }
-        return organizationId;
+        return {
+            tenantId,
+            level: TENANT_SCOPE,
+            organizationId: null
+        };
+    }
+    static getOrganizationId() {
+        return this.getScope().organizationId;
+    }
+    static isTenantScope() {
+        return this.getScope().level === TENANT_SCOPE;
+    }
+    static isOrganizationScope() {
+        return this.getScope().level === ORGANIZATION_SCOPE;
+    }
+    static requireOrganizationScope() {
+        const scope = this.getScope();
+        if (scope.level !== ORGANIZATION_SCOPE || !scope.organizationId) {
+            throw new BadRequestException('Organization scope is required for this operation.');
+        }
+        return scope.organizationId;
     }
     static hasPermissions(findPermissions, throwError) {
         const requestContext = RequestContext.currentRequestContext();
@@ -260,22 +316,22 @@ class RequestContext {
         return null;
     }
     /**
-   * Checks if the current user has a specific role.
-   * @param {RolesEnum} role - The role to check.
-   * @param {boolean} throwError - Flag indicating whether to throw an error if the role is not granted.
-   * @returns {boolean} - True if the user has the role, otherwise false.
-   */ static hasRole(role, throwError) {
+     * Checks if the current user has a specific role.
+     * @param {RolesEnum} role - The role to check.
+     * @param {boolean} throwError - Flag indicating whether to throw an error if the role is not granted.
+     * @returns {boolean} - True if the user has the role, otherwise false.
+     */ static hasRole(role, throwError) {
         return this.hasRoles([
             role
         ], throwError);
     }
     /**
-   * Checks if the current request context has any of the specified roles.
-   *
-   * @param roles - An array of roles to check.
-   * @param throwError - Whether to throw an error if no roles are found.
-   * @returns True if any of the required roles are found, otherwise false.
-   */ static hasRoles(roles, throwError) {
+     * Checks if the current request context has any of the specified roles.
+     *
+     * @param roles - An array of roles to check.
+     * @param throwError - Whether to throw an error if no roles are found.
+     * @returns True if any of the required roles are found, otherwise false.
+     */ static hasRoles(roles, throwError) {
         const context = RequestContext.currentRequestContext();
         if (context) {
             try {
@@ -312,8 +368,23 @@ const als = new AsyncLocalStorage();
 function getRequestContext() {
     return als.getStore();
 }
+function getHeaderValue(req, keys) {
+    if (!(req == null ? void 0 : req.headers)) {
+        return null;
+    }
+    for (const key of keys){
+        const value = req.headers[key];
+        if (Array.isArray(value)) {
+            var _value_;
+            return (_value_ = value[0]) != null ? _value_ : null;
+        }
+        if (typeof value === 'string' && value) {
+            return value;
+        }
+    }
+    return null;
+}
 
-// request-context.middleware.ts
 let RequestContextMiddleware = class RequestContextMiddleware {
     use(req, _res, next) {
         var _req_user;
@@ -414,10 +485,10 @@ class BaseStrategyRegistry {
     }
     /**
      * Get strategy by type from the given organization including global strategies as fallback.
-     * 
-     * @param type 
-     * @param organizationId 
-     * @returns 
+     *
+     * @param type
+     * @param organizationId
+     * @returns
      */ get(type, organizationId) {
         var _this_strategies_get, _this_strategies_get1;
         organizationId != null ? organizationId : organizationId = RequestContext.getOrganizationId();
@@ -431,34 +502,42 @@ class BaseStrategyRegistry {
     }
     /**
      * List all strategies for the given organization including global strategies, or only global strategies if global org is specified.
-     * 
-     * @param organizationId 
-     * @returns 
+     *
+     * @param organizationId
+     * @returns
      */ list(organizationId) {
-        var _this_strategies_get, _this_strategies_get1;
+        var _this_strategies_get;
         organizationId != null ? organizationId : organizationId = RequestContext.getOrganizationId();
         const orgKey = this.resolveOrganization(organizationId);
-        var _this_strategies_get_values;
-        const scoped = (_this_strategies_get_values = (_this_strategies_get = this.strategies.get(orgKey)) == null ? void 0 : _this_strategies_get.values()) != null ? _this_strategies_get_values : [];
-        var _this_strategies_get_values1;
-        const global = orgKey === GLOBAL_ORGANIZATION_SCOPE ? [] : (_this_strategies_get_values1 = (_this_strategies_get1 = this.strategies.get(GLOBAL_ORGANIZATION_SCOPE)) == null ? void 0 : _this_strategies_get1.values()) != null ? _this_strategies_get_values1 : [];
-        return Array.from(new Set([
-            ...scoped,
-            ...global
-        ]));
+        const effective = new Map();
+        var _this_strategies_get_entries;
+        for (const [type, strategy] of (_this_strategies_get_entries = (_this_strategies_get = this.strategies.get(orgKey)) == null ? void 0 : _this_strategies_get.entries()) != null ? _this_strategies_get_entries : []){
+            effective.set(type, strategy);
+        }
+        if (orgKey !== GLOBAL_ORGANIZATION_SCOPE) {
+            var _this_strategies_get1;
+            var _this_strategies_get_entries1;
+            for (const [type, strategy] of (_this_strategies_get_entries1 = (_this_strategies_get1 = this.strategies.get(GLOBAL_ORGANIZATION_SCOPE)) == null ? void 0 : _this_strategies_get1.entries()) != null ? _this_strategies_get_entries1 : []){
+                if (!effective.has(type)) {
+                    effective.set(type, strategy);
+                }
+            }
+        }
+        return Array.from(effective.values());
     }
     constructor(strategyKey, discoveryService, reflector){
-        this.strategyKey = strategyKey;
-        this.discoveryService = discoveryService;
-        this.reflector = reflector;
         this.logger = new Logger(BaseStrategyRegistry.name);
+        // Map<organizationId, Map<type, strategy>>
         this.strategies = new Map();
         this.pluginStrategies = new Map();
+        this.strategyKey = strategyKey;
+        this.discoveryService = discoveryService;
+        this.reflector = reflector;
     }
 }
 __decorate([
     Inject(StrategyBus),
-    __metadata("design:type", typeof StrategyBus === "undefined" ? Object : StrategyBus)
+    __metadata("design:type", StrategyBus)
 ], BaseStrategyRegistry.prototype, "bus", void 0);
 
 let IntegrationStrategyRegistry = class IntegrationStrategyRegistry extends BaseStrategyRegistry {
@@ -468,10 +547,9 @@ let IntegrationStrategyRegistry = class IntegrationStrategyRegistry extends Base
 };
 IntegrationStrategyRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], IntegrationStrategyRegistry);
 
@@ -485,10 +563,9 @@ let WorkflowTriggerRegistry = class WorkflowTriggerRegistry extends BaseStrategy
 };
 WorkflowTriggerRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], WorkflowTriggerRegistry);
 
@@ -497,21 +574,22 @@ const WORKFLOW_NODE_STRATEGY = 'WORKFLOW_NODE_STRATEGY';
  * Decorator to mark a provider as a Workflow Node Strategy
  */ const WorkflowNodeStrategy = (provider)=>applyDecorators(SetMetadata(WORKFLOW_NODE_STRATEGY, provider), SetMetadata(STRATEGY_META_KEY, WORKFLOW_NODE_STRATEGY));
 
-let WorkflowNodeRegistry = class WorkflowNodeRegistry extends BaseStrategyRegistry {
+/**
+ * Registry for Workflow Node Strategies
+ */ let WorkflowNodeRegistry = class WorkflowNodeRegistry extends BaseStrategyRegistry {
     constructor(discoveryService, reflector){
         super(WORKFLOW_NODE_STRATEGY, discoveryService, reflector);
     }
 };
 WorkflowNodeRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], WorkflowNodeRegistry);
 
-const COMMAND_METADATA$1 = '__command__';
+const COMMAND_METADATA$2 = '__command__';
 /**
  * Wrap Workflow Node Execution Command
  */ class WrapWorkflowNodeExecutionCommand extends Command {
@@ -522,7 +600,7 @@ const COMMAND_METADATA$1 = '__command__';
     }
 }
 WrapWorkflowNodeExecutionCommand.type = '[Workflow] Wrap Workflow Node Execution';
-Reflect.defineMetadata(COMMAND_METADATA$1, {
+Reflect.defineMetadata(COMMAND_METADATA$2, {
     id: WrapWorkflowNodeExecutionCommand.type
 }, WrapWorkflowNodeExecutionCommand);
 
@@ -536,10 +614,9 @@ let VectorStoreRegistry = class VectorStoreRegistry extends BaseStrategyRegistry
 };
 VectorStoreRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], VectorStoreRegistry);
 
@@ -553,10 +630,9 @@ let TextSplitterRegistry = class TextSplitterRegistry extends BaseStrategyRegist
 };
 TextSplitterRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], TextSplitterRegistry);
 
@@ -572,10 +648,9 @@ let DocumentSourceRegistry = class DocumentSourceRegistry extends BaseStrategyRe
 };
 DocumentSourceRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], DocumentSourceRegistry);
 
@@ -591,10 +666,9 @@ let DocumentTransformerRegistry = class DocumentTransformerRegistry extends Base
 };
 DocumentTransformerRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], DocumentTransformerRegistry);
 
@@ -610,16 +684,15 @@ let RetrieverRegistry = class RetrieverRegistry extends BaseStrategyRegistry {
 };
 RetrieverRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], RetrieverRegistry);
 
 /**
  * Merge parent chunks with their child chunks based on metadata (parentId and chunkId)
- * 
+ *
  * @deprecated use buildChunkTreeAndFindLeaves instead
  */ function mergeParentChildChunks(chunks, children // Child chunks
 ) {
@@ -685,10 +758,9 @@ let ImageUnderstandingRegistry = class ImageUnderstandingRegistry extends BaseSt
 };
 ImageUnderstandingRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], ImageUnderstandingRegistry);
 
@@ -702,10 +774,9 @@ let KnowledgeStrategyRegistry = class KnowledgeStrategyRegistry extends BaseStra
 };
 KnowledgeStrategyRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], KnowledgeStrategyRegistry);
 
@@ -721,10 +792,9 @@ let ToolsetRegistry = class ToolsetRegistry extends BaseStrategyRegistry {
 };
 ToolsetRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], ToolsetRegistry);
 
@@ -732,26 +802,26 @@ ToolsetRegistry = __decorate([
  * Base ability for all toolsets
  */ class BaseToolset extends BaseToolkit {
     /**
-	 * Async init tools
-	 *
-	 * @returns
-	 */ async initTools() {
+     * Async init tools
+     *
+     * @returns
+     */ async initTools() {
         return this.tools;
     }
     /**
-	 * Get one tool
-	 *
-	 * @param toolName
-	 * @returns
-	 */ getTool(toolName) {
+     * Get one tool
+     *
+     * @param toolName
+     * @returns
+     */ getTool(toolName) {
         var _this_getTools;
         return (_this_getTools = this.getTools()) == null ? void 0 : _this_getTools.find((tool)=>tool.name === toolName);
     }
     /**
-	 * Get state variables config
-	 *
-	 * @returns State variables
-	 */ async getVariables() {
+     * Get state variables config
+     *
+     * @returns State variables
+     */ async getVariables() {
         return null;
     }
     /**
@@ -809,26 +879,26 @@ class BuiltinToolset extends BaseToolset {
         return (_this_toolset = this.toolset) == null ? void 0 : _this_toolset.credentials;
     }
     getToolTitle(name) {
-        var _this_toolset_tools, _this_toolset, _this;
+        var _this_toolset_tools, _this_toolset, _tool_schema;
         const tool = (_this_toolset = this.toolset) == null ? void 0 : (_this_toolset_tools = _this_toolset.tools) == null ? void 0 : _this_toolset_tools.find((tool)=>tool.name === name);
-        const identity = (_this = tool == null ? void 0 : tool.schema) == null ? void 0 : _this.identity;
+        const identity = tool == null ? void 0 : (_tool_schema = tool.schema) == null ? void 0 : _tool_schema.identity;
         if (identity) {
             return identity.label;
         }
         return null;
     }
     /**
-	 * Get credentials schema
-	 *
-	 * @returns Credentials schema
-	 */ getCredentialsSchema() {
+     * Get credentials schema
+     *
+     * @returns Credentials schema
+     */ getCredentialsSchema() {
         return _extends({}, this.credentialsSchema);
     }
     /**
-	 * Get toolset entity
-	 *
-	 * @returns XpertToolset
-	 */ getToolset() {
+     * Get toolset entity
+     *
+     * @returns XpertToolset
+     */ getToolset() {
         return this.toolset;
     }
     getName() {
@@ -837,27 +907,27 @@ class BuiltinToolset extends BaseToolset {
     }
     constructor(providerName, toolset, params){
         super(params);
+        this.logger = new Logger(this.constructor.name);
         this.providerName = providerName;
         this.toolset = toolset;
         this.params = params;
-        this.logger = new Logger(this.constructor.name);
     }
-}
+} 
 BuiltinToolset.provider = '';
 
 /**
  * Restricted FileSystem based on granted permissions
  */ class XpFileSystem {
     /**
-   * Check if operation is allowed
-   */ ensureAllowed(op) {
+     * Check if operation is allowed
+     */ ensureAllowed(op) {
         if (!this.allowedOps.has(op)) {
             throw new Error(`Permission denied: ${op} operation not allowed`);
         }
     }
     /**
-   * Check if path is within scope
-   */ ensureInScope(targetPath) {
+     * Check if path is within scope
+     */ ensureInScope(targetPath) {
         if (!this.scope || this.scope.length === 0) return;
         const resolved = path__default.resolve(targetPath);
         for (const s of this.scope){
@@ -867,33 +937,33 @@ BuiltinToolset.provider = '';
         throw new Error(`Permission denied: path "${targetPath}" is out of scope`);
     }
     /**
-   * Get the absolute path of file in the file system.
-   * 
-   * @param filePath Relative file path
-   * @returns Absolute file path
-   */ fullPath(filePath) {
+     * Get the absolute path of file in the file system.
+     *
+     * @param filePath Relative file path
+     * @returns Absolute file path
+     */ fullPath(filePath) {
         return path__default.join(this.basePath, filePath);
     }
     /**
-   * Get web url for a given file path in the file system.
-   * 
-   * @param filePath Relative file path
-   * @returns Web URL of file
-   */ fullUrl(filePath) {
+     * Get web url for a given file path in the file system.
+     *
+     * @param filePath Relative file path
+     * @returns Web URL of file
+     */ fullUrl(filePath) {
         const url = new URL(filePath, this.baseUrl);
         return url.href;
     }
     /**
-   * Read file contents
-   */ async readFile(filePath, encoding = 'utf-8') {
+     * Read file contents
+     */ async readFile(filePath, encoding = 'utf-8') {
         this.ensureAllowed('read');
         const fullPath = this.fullPath(filePath);
         this.ensureInScope(fullPath);
         return await fsPromises.readFile(fullPath);
     }
     /**
-   * Write file contents
-   */ async writeFile(filePath, content) {
+     * Write file contents
+     */ async writeFile(filePath, content) {
         this.ensureAllowed('write');
         const fullPath = this.fullPath(filePath);
         this.ensureInScope(fullPath);
@@ -905,22 +975,22 @@ BuiltinToolset.provider = '';
         return url.href;
     }
     /**
-   * Delete a file
-   */ async deleteFile(filePath) {
+     * Delete a file
+     */ async deleteFile(filePath) {
         this.ensureAllowed('delete');
         this.ensureInScope(filePath);
         await fsPromises.unlink(filePath);
     }
     /**
-   * List directory contents
-   */ async listDir(dirPath) {
+     * List directory contents
+     */ async listDir(dirPath) {
         this.ensureAllowed('list');
         this.ensureInScope(dirPath);
         return fsPromises.readdir(dirPath);
     }
     /**
-   * Utility: check if a file or directory exists
-   */ async exists(targetPath) {
+     * Utility: check if a file or directory exists
+     */ async exists(targetPath) {
         try {
             await fsPromises.access(targetPath);
             return true;
@@ -1027,7 +1097,7 @@ function loadYamlFile(filePath, logger, ignoreError = true, defaultValue = {}) {
 }
 /**
  * Get the mapping from name to index from a YAML file
- * 
+ *
  * @param folderPath
  * @param fileName the YAML file name, default to '_position.yaml'
  * @return a dict with name as key and index as value
@@ -1096,10 +1166,9 @@ let DataSourceStrategyRegistry = class DataSourceStrategyRegistry extends BaseSt
 };
 DataSourceStrategyRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], DataSourceStrategyRegistry);
 
@@ -1108,12 +1177,12 @@ DataSourceStrategyRegistry = __decorate([
  * into datasource strategies consumable by the plugin SDK.
  */ class AdapterDataSourceStrategy {
     /**
-   * Get from cache or create new instance of DB adapter.
-   * 
-   * @param options 
-   * @param id 
-   * @returns 
-   */ async create(options, id) {
+     * Get from cache or create new instance of DB adapter.
+     *
+     * @param options
+     * @param id
+     * @returns
+     */ async create(options, id) {
         if (id) {
             if (this.runners.has(id)) {
                 return this.runners.get(id);
@@ -1149,9 +1218,10 @@ DataSourceStrategyRegistry = __decorate([
         return this.runnerClass;
     }
     constructor(runnerClass, extraArgs = []){
+        this.runners = new Map() // dataSourceId -> runner instance
+        ;
         this.runnerClass = runnerClass;
         this.extraArgs = extraArgs;
-        this.runners = new Map();
     }
 }
 
@@ -1251,13 +1321,13 @@ class BaseSQLQueryRunner extends BaseQueryRunner {
         await this.runQuery(`SELECT 1`);
     }
     /**
-   * Default implementation for table operations
-   */ async tableOp(action, params, options) {
+     * Default implementation for table operations
+     */ async tableOp(action, params, options) {
         switch(action){
-            case "createTable":
+            case DBTableAction.CREATE_TABLE:
                 {
                     // Default implementation for creating table (generic SQL syntax)
-                    const { schema, table, columns, createMode = "error" } = params;
+                    const { schema, table, columns, createMode = DBCreateTableMode.ERROR } = params;
                     const tableName = schema ? `${schema}.${table}` : table;
                     // Check if table exists (try to query table info)
                     let exists = false;
@@ -1269,17 +1339,17 @@ class BaseSQLQueryRunner extends BaseQueryRunner {
                         exists = false;
                     }
                     // --- MODE: ERROR → throw error if table exists ---
-                    if (exists && createMode === "error") {
+                    if (exists && createMode === DBCreateTableMode.ERROR) {
                         throw new Error(`Table "${tableName}" already exists`);
                     }
                     // --- MODE: IGNORE → do nothing if exists ---
-                    if (exists && createMode === "ignore") {
+                    if (exists && createMode === DBCreateTableMode.IGNORE) {
                         return;
                     }
                     // --- MODE: UPGRADE → auto upgrade (simple implementation: only add new columns) ---
                     // Note: This default implementation does not support modifying column types, 
                     //       recommend each database to implement its own version
-                    if (exists && createMode === "upgrade") {
+                    if (exists && createMode === DBCreateTableMode.UPGRADE) {
                         console.warn(`[BaseSQLQueryRunner] UPGRADE mode uses basic implementation. Consider implementing tableOp for better support.`);
                         // Try to add new columns (will fail if column already exists, but doesn't affect)
                         for (const col of columns){
@@ -1304,7 +1374,7 @@ class BaseSQLQueryRunner extends BaseQueryRunner {
                     await this.runQuery(createTableStatement, options);
                     return;
                 }
-            case "dropTable":
+            case DBTableAction.DROP_TABLE:
                 {
                     // Default implementation for dropping table
                     const { schema, table } = params;
@@ -1318,8 +1388,8 @@ class BaseSQLQueryRunner extends BaseQueryRunner {
         }
     }
     /**
-   * Generic type mapping (subclasses can override)
-   */ mapColumnType(type, isKey, length) {
+     * Generic type mapping (subclasses can override)
+     */ mapColumnType(type, isKey, length) {
         switch(type == null ? void 0 : type.toLowerCase()){
             case 'string':
                 return length ? `VARCHAR(${length})` : isKey ? 'VARCHAR(255)' : 'VARCHAR(1000)';
@@ -1339,8 +1409,8 @@ class BaseSQLQueryRunner extends BaseQueryRunner {
     }
     constructor(...args){
         super(...args);
-        this.syntax = "sql";
-        this.protocol = "sql";
+        this.syntax = DBSyntaxEnum.SQL;
+        this.protocol = DBProtocolEnum.SQL;
     }
 }
 var DBTableAction;
@@ -1361,7 +1431,9 @@ var DBTableAction;
     DBTableAction["CLONE_TABLE"] = "cloneTable";
     DBTableAction["OPTIMIZE_TABLE"] = "optimizeTable";
 })(DBTableAction || (DBTableAction = {}));
-var DBCreateTableMode;
+/**
+ * Modes for creating a table, if the table already exists
+ */ var DBCreateTableMode;
 (function(DBCreateTableMode) {
     DBCreateTableMode["ERROR"] = "error";
     DBCreateTableMode["IGNORE"] = "ignore";
@@ -1391,8 +1463,7 @@ function AIModelProviderStrategy(provider) {
     const match = (callerLine == null ? void 0 : callerLine.match(/\((file:\/\/\/[^\s)]+)\)/)) || (// case 1: file:///path...
     callerLine == null ? void 0 : callerLine.match(/\((\/[^\s)]+)\)/)) || (// case 2: (/Users/xxx)
     callerLine == null ? void 0 : callerLine.match(/at (file:\/\/\/[^\s]+)/)) || (// case 3: at file:///...
-    callerLine == null ? void 0 : callerLine.match(/at (\/[^\s]+)/) // case 4: at /Users/xxx
-    );
+    callerLine == null ? void 0 : callerLine.match(/at (\/[^\s]+)/)); // case 4: at /Users/xxx
     let file = match == null ? void 0 : match[1];
     // remove the file:/// prefix
     if (file == null ? void 0 : file.startsWith('file:///')) {
@@ -1427,10 +1498,9 @@ let AIModelProviderRegistry = class AIModelProviderRegistry extends BaseStrategy
 };
 AIModelProviderRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], AIModelProviderRegistry);
 
@@ -1441,7 +1511,8 @@ class CredentialsValidateFailedError extends ForbiddenException {
 class AIModelProviderNotFoundException extends NotFoundException {
 }
 
-let ModelProvider = class ModelProvider {
+var ModelProvider_1;
+let ModelProvider = ModelProvider_1 = class ModelProvider {
     get name() {
         return this.getProviderSchema().provider;
     }
@@ -1449,10 +1520,10 @@ let ModelProvider = class ModelProvider {
         await this.validateProviderCredentials(credentials);
     }
     /**
-   * Get provider lib root path.
-   *
-   * @returns Root of library
-   */ getProviderServerPath() {
+     * Get provider lib root path.
+     *
+     * @returns Root of library
+     */ getProviderServerPath() {
         return this.dir;
     }
     getProviderSchema() {
@@ -1487,11 +1558,11 @@ let ModelProvider = class ModelProvider {
         return modelInstance;
     }
     /**
-   * Get provider models.
-   * @param modelType - model type
-   * @param onlyActive - only active models
-   * @return provider models
-   */ getProviderModels(modelType, onlyActive = false) {
+     * Get provider models.
+     * @param modelType - model type
+     * @param onlyActive - only active models
+     * @return provider models
+     */ getProviderModels(modelType, onlyActive = false) {
         let modelTypes = [];
         if (modelType) {
             modelTypes.push(modelType);
@@ -1543,7 +1614,7 @@ let ModelProvider = class ModelProvider {
         return null;
     }
     constructor(){
-        this.logger = new Logger(ModelProvider.name);
+        this.logger = new Logger(ModelProvider_1.name);
         // protected providerSchema: IAiProviderEntity | null = null
         this.modelManagers = new Map();
         const provider = Reflect.getMetadata(AI_MODEL_PROVIDER, this.constructor);
@@ -1553,9 +1624,8 @@ let ModelProvider = class ModelProvider {
         this.dir = dir;
     }
 };
-ModelProvider = __decorate([
+ModelProvider = ModelProvider_1 = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [])
 ], ModelProvider);
 
@@ -1744,7 +1814,8 @@ function mergeCredentials(credentials, modelProperties) {
     return _extends({}, credentials != null ? credentials : {}, modelProperties != null ? modelProperties : {});
 }
 
-let AIModel = class AIModel {
+var AIModel_1;
+let AIModel = AIModel_1 = class AIModel {
     getChatModel(copilotModel, options) {
         throw new Error(`Unsupport chat model!`);
     }
@@ -1819,13 +1890,13 @@ let AIModel = class AIModel {
         return null;
     }
     /**
-	 * Get customizable model schema.
-	 * Implement this method in ai model sub class that can customize model
-	 * 
-	 * @param model model name
-	 * @param credentials model credentials
-	 * @returns model schema
-	 */ getCustomizableModelSchemaFromCredentials(model, credentials) {
+     * Get customizable model schema.
+     * Implement this method in ai model sub class that can customize model
+     *
+     * @param model model name
+     * @param credentials model credentials
+     * @returns model schema
+     */ getCustomizableModelSchemaFromCredentials(model, credentials) {
         return null;
     }
     processParameterRules(yamlData) {
@@ -1897,29 +1968,28 @@ let AIModel = class AIModel {
         };
     }
     constructor(modelProvider, modelType){
-        this.modelProvider = modelProvider;
-        this.modelType = modelType;
-        this.logger = new Logger(AIModel.name);
+        this.logger = new Logger(AIModel_1.name);
         this.modelSchemas = null;
         this.positions = null;
+        this.modelProvider = modelProvider;
+        this.modelType = modelType;
         this.modelProvider.registerAIModelInstance(this.modelType, this);
     }
 };
-AIModel = __decorate([
+AIModel = AIModel_1 = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof ModelProvider === "undefined" ? Object : ModelProvider,
-        typeof AiModelTypeEnum === "undefined" ? Object : AiModelTypeEnum
+        ModelProvider,
+        String
     ])
 ], AIModel);
 function getDefaultParameterRuleVariableMap(name) {
     /**
-	 * Get default parameter rule for given name
-	 *
-	 * @param name - parameter name
-	 * @return parameter rule
-	 */ const defaultParameterRule = PARAMETER_RULE_TEMPLATE[name];
+     * Get default parameter rule for given name
+     *
+     * @param name - parameter name
+     * @return parameter rule
+     */ const defaultParameterRule = PARAMETER_RULE_TEMPLATE[name];
     if (!defaultParameterRule) {
         throw new Error(`Invalid model parameter rule name ${name}`);
     }
@@ -1985,17 +2055,18 @@ function _class_private_field_loose_key(name) {
     return "__private_" + id++ + "_" + name;
 }
 
+var _a;
 class LLMUsage {
     static emptyUsage() {
         return new LLMUsage(0, 0.0, 0.0, 0.0, 0, 0.0, 0.0, 0.0, 0, 0.0, 'USD', 0.0);
     }
     plus(other) {
         /**
-		 * Add two LLMUsage instances together.
-		 *
-		 * @param other: Another LLMUsage instance to add
-		 * @return: A new LLMUsage instance with summed values
-		 */ if (this.totalTokens === 0) {
+         * Add two LLMUsage instances together.
+         *
+         * @param other: Another LLMUsage instance to add
+         * @return: A new LLMUsage instance with summed values
+         */ if (this.totalTokens === 0) {
             return other;
         } else {
             return new LLMUsage(this.promptTokens + other.promptTokens, other.promptUnitPrice, other.promptPriceUnit, this.promptPrice + other.promptPrice, this.completionTokens + other.completionTokens, other.completionUnitPrice, other.completionPriceUnit, this.completionPrice + other.completionPrice, this.totalTokens + other.totalTokens, this.totalPrice + other.totalPrice, other.currency, this.latency + other.latency);
@@ -2003,11 +2074,11 @@ class LLMUsage {
     }
     add(other) {
         /**
-		 * Overload the + operator to add two LLMUsage instances.
-		 *
-		 * @param other: Another LLMUsage instance to add
-		 * @return: A new LLMUsage instance with summed values
-		 */ return this.plus(other);
+         * Overload the + operator to add two LLMUsage instances.
+         *
+         * @param other: Another LLMUsage instance to add
+         * @return: A new LLMUsage instance with summed values
+         */ return this.plus(other);
     }
     constructor(promptTokens, promptUnitPrice, promptPriceUnit, promptPrice, completionTokens, completionUnitPrice, completionPriceUnit, completionPrice, totalTokens, totalPrice, currency, latency){
         this.promptTokens = promptTokens;
@@ -2127,15 +2198,88 @@ class LargeLanguageModel extends AIModel {
             }
         };
     }
+    createHandleVerboseCallbacks(enabled, logger) {
+        if (!enabled) {
+            return [];
+        }
+        const targetLogger = logger != null ? logger : _class_private_field_loose_base(this, _logger)[_logger];
+        return [
+            {
+                handleChatModelStart: (llm, messages, runId, parentRunId, extraParams, tags, metadata, runName)=>{
+                    targetLogger.verbose(this.formatVerboseLog('chat_model/start', {
+                        runId,
+                        parentRunId,
+                        runName,
+                        model: llm,
+                        messages,
+                        extraParams,
+                        tags,
+                        metadata
+                    }));
+                },
+                handleLLMStart: (llm, prompts, runId, parentRunId, extraParams, tags, metadata, runName)=>{
+                    targetLogger.verbose(this.formatVerboseLog('llm/start', {
+                        runId,
+                        parentRunId,
+                        runName,
+                        model: llm,
+                        prompts,
+                        extraParams,
+                        tags,
+                        metadata
+                    }));
+                },
+                handleLLMEnd: (output, runId, parentRunId, tags, extraParams)=>{
+                    targetLogger.verbose(this.formatVerboseLog('llm/end', {
+                        runId,
+                        parentRunId,
+                        output,
+                        tags,
+                        extraParams
+                    }));
+                },
+                handleLLMError: (err, runId, parentRunId, tags, extraParams)=>{
+                    targetLogger.verbose(this.formatVerboseLog('llm/error', {
+                        runId,
+                        parentRunId,
+                        error: this.formatError(err),
+                        tags,
+                        extraParams
+                    }));
+                }
+            }
+        ];
+    }
+    formatVerboseLog(event, payload) {
+        return `[langchain][${event}] ${this.stringifyLogPayload(payload)}`;
+    }
+    stringifyLogPayload(payload) {
+        try {
+            return JSON.stringify(payload, null, 2);
+        } catch (error) {
+            return `[unserializable payload: ${this.formatError(error)}]`;
+        }
+    }
+    formatError(error) {
+        if (error instanceof Error) {
+            return {
+                name: error.name,
+                message: error.message,
+                stack: error.stack
+            };
+        }
+        return error;
+    }
     constructor(...args){
         super(...args);
         Object.defineProperty(this, _logger, {
             writable: true,
             value: void 0
         });
-        _class_private_field_loose_base(this, _logger)[_logger] = new Logger(LargeLanguageModel.name);
+        _class_private_field_loose_base(this, _logger)[_logger] = new Logger(_a.name);
     }
 }
+_a = LargeLanguageModel;
 function calcTokenUsage(output) {
     var _output_generations;
     const tokenUsage = {
@@ -2183,8 +2327,8 @@ function calcTokenUsage(output) {
  * In this way, the reasoning process in the model output can be separated from the main content, making it easier for subsequent structured processing and display.
  */ class ChatOAICompatReasoningModel extends ChatOpenAICompletions {
     /**
-	 * 
-	 */ _convertCompletionsDeltaToBaseMessageChunk(// eslint-disable-next-line @typescript-eslint/no-explicit-any
+     *
+     */ _convertCompletionsDeltaToBaseMessageChunk(// eslint-disable-next-line @typescript-eslint/no-explicit-any
     delta, rawResponse, defaultRole) {
         const messageChunk = super._convertCompletionsDeltaToBaseMessageChunk(delta, rawResponse, defaultRole);
         if (delta['content'] === '<think>') {
@@ -2370,7 +2514,7 @@ function normalizeContextSize(value) {
     return undefined;
 }
 
-const COMMAND_METADATA = '__command__';
+const COMMAND_METADATA$1 = '__command__';
 /**
  * Get a Chat Model of copilot model and check it's token limitation, record the token usage
  */ class CreateModelClientCommand extends Command {
@@ -2381,10 +2525,26 @@ const COMMAND_METADATA = '__command__';
     }
 }
 CreateModelClientCommand.type = '[AI Model] Create Model Client';
-Reflect.defineMetadata(COMMAND_METADATA, {
+Reflect.defineMetadata(COMMAND_METADATA$1, {
     id: CreateModelClientCommand.type
 }, CreateModelClientCommand);
 
+const SKILL_SOURCE_PROVIDER = 'SKILL_SOURCE_PROVIDER';
+const SkillSourceProviderStrategy = (provider)=>applyDecorators(SetMetadata(SKILL_SOURCE_PROVIDER, provider), SetMetadata(STRATEGY_META_KEY, SKILL_SOURCE_PROVIDER));
+
+let SkillSourceProviderRegistry = class SkillSourceProviderRegistry extends BaseStrategyRegistry {
+    constructor(discoveryService, reflector){
+        super(SKILL_SOURCE_PROVIDER, discoveryService, reflector);
+    }
+};
+SkillSourceProviderRegistry = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [
+        DiscoveryService,
+        Reflector
+    ])
+], SkillSourceProviderRegistry);
+
 const AGENT_MIDDLEWARE_STRATEGY = 'AGENT_MIDDLEWARE_STRATEGY';
 const AgentMiddlewareStrategy = (provider)=>applyDecorators(SetMetadata(AGENT_MIDDLEWARE_STRATEGY, provider), SetMetadata(STRATEGY_META_KEY, AGENT_MIDDLEWARE_STRATEGY));
 
@@ -2395,10 +2555,9 @@ let AgentMiddlewareRegistry = class AgentMiddlewareRegistry extends BaseStrategy
 };
 AgentMiddlewareRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], AgentMiddlewareRegistry);
 
@@ -2410,15 +2569,7 @@ 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 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)) {
@@ -2484,10 +2635,9 @@ let HandoffProcessorRegistry = class HandoffProcessorRegistry extends BaseStrate
 };
 HandoffProcessorRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], HandoffProcessorRegistry);
 
@@ -2596,26 +2746,52 @@ HandoffProcessorRegistry = __decorate([
  * ```
  */ const ChatChannel = (type)=>SetMetadata(CHAT_CHANNEL, type);
 
-let ChatChannelRegistry = class ChatChannelRegistry extends BaseStrategyRegistry {
+/**
+ * Chat Channel Registry
+ *
+ * Manages all registered chat channel implementations.
+ * Channels are automatically discovered and registered via @ChatChannel decorator.
+ *
+ * Supports:
+ * - Organization-scoped channels
+ * - Global channels (fallback)
+ * - Plugin-based registration/removal
+ * - Dynamic channel lookup
+ *
+ * @example
+ * ```typescript
+ * // Get channel by type
+ * const channel = registry.get('lark')
+ *
+ * // List all available channels for an organization
+ * const channels = registry.list(organizationId)
+ *
+ * // Send message using a channel
+ * await channel.sendText(ctx, 'Hello!')
+ * ```
+ */ let ChatChannelRegistry = class ChatChannelRegistry extends BaseStrategyRegistry {
     constructor(discoveryService, reflector){
         super(CHAT_CHANNEL, discoveryService, reflector);
     }
 };
 ChatChannelRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], ChatChannelRegistry);
 
+const COMMAND_METADATA = '__command__';
 class CancelConversationCommand {
     constructor(input){
         this.input = input;
     }
 }
 CancelConversationCommand.type = '[Chat Conversation] Cancel';
+Reflect.defineMetadata(COMMAND_METADATA, {
+    id: CancelConversationCommand.type
+}, CancelConversationCommand);
 
 const FILE_STORAGE_PROVIDER = 'FILE_STORAGE_PROVIDER';
 const FileStorageProvider = (provider)=>applyDecorators(SetMetadata(FILE_STORAGE_PROVIDER, provider), SetMetadata(STRATEGY_META_KEY, FILE_STORAGE_PROVIDER));
@@ -2627,10 +2803,9 @@ let FileStorageProviderRegistry = class FileStorageProviderRegistry extends Base
 };
 FileStorageProviderRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], FileStorageProviderRegistry);
 
@@ -2644,10 +2819,9 @@ let FileUploadTargetRegistry = class FileUploadTargetRegistry extends BaseStrate
 };
 FileUploadTargetRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], FileUploadTargetRegistry);
 
@@ -2702,8 +2876,18 @@ function resolveSandboxExecutionOptions(options, defaults = DEFAULT_SANDBOX_SHEL
  *
  * @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';
+ */ function isObjectLike(value) {
+    return typeof value === 'object' && value !== null;
+}
+function isSandboxBackend(backend) {
+    return isObjectLike(backend) && typeof Reflect.get(backend, 'execute') === 'function' && typeof Reflect.get(backend, 'id') === 'string';
+}
+function resolveSandboxBackend(sandbox) {
+    if (!isObjectLike(sandbox)) {
+        return null;
+    }
+    const candidate = Reflect.has(sandbox, 'backend') ? Reflect.get(sandbox, 'backend') : sandbox;
+    return isSandboxBackend(candidate) ? candidate : null;
 }
 
 const MAX_LINE_LENGTH = 500;
@@ -3321,6 +3505,13 @@ try {
  *
  * Requires Node.js 20+ on the sandbox host.
  */ class BaseSandbox {
+    /**
+     * Internal hook for file/search operations. Concrete backends can override
+     * this to distinguish "background helper commands" from user-facing shell
+     * execute calls.
+     */ executeOperation(command, options) {
+        return this.execute(command, options);
+    }
     async streamExecute(command, onLine, options) {
         const result = await this.execute(command, options);
         if (result.output) {
@@ -3329,13 +3520,13 @@ try {
         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) {
+     * 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, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
+        const result = await this.executeOperation(command, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
         if (result.exitCode !== 0) {
             return [];
         }
@@ -3357,14 +3548,14 @@ try {
         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) {
+     * 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';
         }
@@ -3375,34 +3566,34 @@ try {
             return 'Error: depth must be greater than zero';
         }
         const command = buildListDirCommand(dirPath, offset, limit, depth);
-        const result = await this.execute(command, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
+        const result = await this.executeOperation(command, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
         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) {
+     * 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, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
+        const result = await this.executeOperation(command, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
         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) {
+     * 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, DEFAULT_SANDBOX_FILE_SEARCH_EXECUTION_OPTIONS);
+        const result = await this.executeOperation(command, DEFAULT_SANDBOX_FILE_SEARCH_EXECUTION_OPTIONS);
         if (result.exitCode === 1) {
             // Check if it's a regex error
             if (result.output.includes('Invalid regex:')) {
@@ -3426,8 +3617,8 @@ try {
         return matches;
     }
     /**
-   * Search file contents for a regex pattern, returning human-readable output.
-   */ async grep(pattern, path = '/', include = null) {
+     * 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;
@@ -3438,10 +3629,10 @@ try {
         return formatGrepOutput(result);
     }
     /**
-   * Structured glob matching returning FileInfo objects.
-   */ async globInfo(pattern, path = '/') {
+     * Structured glob matching returning FileInfo objects.
+     */ async globInfo(pattern, path = '/') {
         const command = buildGlobCommand(path, pattern);
-        const result = await this.execute(command, DEFAULT_SANDBOX_FILE_SEARCH_EXECUTION_OPTIONS);
+        const result = await this.executeOperation(command, DEFAULT_SANDBOX_FILE_SEARCH_EXECUTION_OPTIONS);
         const infos = [];
         const lines = result.output.trim().split('\n').filter(Boolean);
         for (const line of lines){
@@ -3460,8 +3651,8 @@ try {
         return infos;
     }
     /**
-   * Find files matching a glob pattern, returning human-readable output.
-   */ async glob(pattern, path = '/') {
+     * 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';
@@ -3469,10 +3660,10 @@ try {
         return formatGlobOutput(files);
     }
     /**
-   * Create a new file with content.
-   */ async write(filePath, content) {
+     * Create a new file with content.
+     */ async write(filePath, content) {
         const command = buildWriteCommand(filePath, content);
-        const result = await this.execute(command, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
+        const result = await this.executeOperation(command, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
         if (result.exitCode !== 0) {
             const output = (result.output || '').trim();
             if (output.includes(WRITE_EXISTS_OUTPUT)) {
@@ -3494,7 +3685,7 @@ try {
         };
     }
     async writeViaUpload(filePath, content) {
-        const existsCheck = await this.execute(buildExistsCommand(filePath), DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
+        const existsCheck = await this.executeOperation(buildExistsCommand(filePath), DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
         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.`
@@ -3523,10 +3714,10 @@ try {
         };
     }
     /**
-   * Append content to a file. Creates the file if it doesn't exist.
-   */ async append(filePath, content) {
+     * 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, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
+        const result = await this.executeOperation(command, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
         if (result.exitCode !== 0) {
             const output = (result.output || '').trim();
             return {
@@ -3539,10 +3730,10 @@ try {
         };
     }
     /**
-   * Edit a file by replacing string occurrences.
-   */ async edit(filePath, oldString, newString, replaceAll = false) {
+     * 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, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
+        const result = await this.executeOperation(command, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
         switch(result.exitCode){
             case 0:
                 {
@@ -3572,10 +3763,10 @@ try {
         }
     }
     /**
-   * 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) {
+     * 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'
@@ -3615,11 +3806,48 @@ let SandboxProviderRegistry = class SandboxProviderRegistry extends BaseStrategy
 };
 SandboxProviderRegistry = __decorate([
     Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
-        typeof Reflector === "undefined" ? Object : Reflector
+        DiscoveryService,
+        Reflector
     ])
 ], SandboxProviderRegistry);
 
-export { AGENT_CHAT_DISPATCH_MESSAGE_TYPE, AGENT_MIDDLEWARE_STRATEGY, AIModelProviderNotFoundException, AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, ANALYTICS_PERMISSION_SERVICE_TOKEN, AdapterDataSourceStrategy, AgentMiddlewareRegistry, AgentMiddlewareStrategy, AiModelNotFoundException, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, BaseTool, BaseToolset, BuiltinToolset, CHAT_CHANNEL, CHAT_CHANNEL_TEXT_LIMITS, CancelConversationCommand, ChatChannel, ChatChannelRegistry, ChatOAICompatReasoningModel, CommonParameterRules, CreateModelClientCommand, CredentialsValidateFailedError, DATASOURCE_STRATEGY, DBCreateTableMode, DBProtocolEnum, DBSyntaxEnum, DBTableAction, DBTableDataAction, DEFAULT_EXECUTION_CONFIG, DEFAULT_SANDBOX_EXECUTION_MAX_OUTPUT_BYTES, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_SEC, DEFAULT_SANDBOX_FILE_SEARCH_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_SEC, DEFAULT_SANDBOX_SHELL_EXECUTION_OPTIONS, DEFAULT_SANDBOX_SHELL_TIMEOUT_MS, DEFAULT_SANDBOX_SHELL_TIMEOUT_SEC, DOCUMENT_SOURCE_STRATEGY, DOCUMENT_TRANSFORMER_STRATEGY, DataSourceStrategy, DataSourceStrategyRegistry, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, FILE_STORAGE_PROVIDER, FILE_UPLOAD_TARGET_STRATEGY, FileStorageProvider, FileStorageProviderRegistry, FileUploadTargetRegistry, FileUploadTargetStrategy, GLOBAL_ORGANIZATION_SCOPE, HANDOFF_PERMISSION_SERVICE_TOKEN, HANDOFF_PROCESSOR_STRATEGY, HANDOFF_QUEUE_SERVICE_TOKEN, HandoffProcessorRegistry, HandoffProcessorStrategy, IMAGE_UNDERSTANDING_STRATEGY, INTEGRATION_PERMISSION_SERVICE_TOKEN, INTEGRATION_STRATEGY, ImageUnderstandingRegistry, ImageUnderstandingStrategy, IntegrationStrategyKey, IntegrationStrategyRegistry, JUMP_TO_TARGETS, JsonSchemaValidator, KNOWLEDGE_STRATEGY, KnowledgeStrategyKey, KnowledgeStrategyRegistry, LLMUsage, LargeLanguageModel, ModelProvider, ORGANIZATION_METADATA_KEY, OpenAICompatibleReranker, PERMISSION_OPERATION_METADATA_KEY, PLUGIN_CONFIG_RESOLVER_TOKEN, PLUGIN_METADATA, PLUGIN_METADATA_KEY, PROVIDE_AI_MODEL_LLM, PROVIDE_AI_MODEL_MODERATION, PROVIDE_AI_MODEL_RERANK, PROVIDE_AI_MODEL_SPEECH2TEXT, PROVIDE_AI_MODEL_TEXT_EMBEDDING, PROVIDE_AI_MODEL_TTS, RETRIEVER_STRATEGY, RequestContext, RequestContextMiddleware, RequirePermissionOperation, RerankModel, RetrieverRegistry, RetrieverStrategy, SANDBOX_PROVIDER, SANDBOX_SHELL_TIMEOUT_LIMITS_SEC, STRATEGY_META_KEY, SandboxProviderRegistry, SandboxProviderStrategy, Speech2TextChatModel, SpeechToTextModel, StrategyBus, TEXT_SPLITTER_STRATEGY, TOOLSET_STRATEGY, TextEmbeddingModelManager, TextSplitterRegistry, TextSplitterStrategy, TextToSpeechModel, ToolsetRegistry, ToolsetStrategy, USER_PERMISSION_SERVICE_TOKEN, VECTOR_STORE_STRATEGY, VectorStoreRegistry, VectorStoreStrategy, WORKFLOW_NODE_STRATEGY, WORKFLOW_TRIGGER_STRATEGY, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, WrapWorkflowNodeExecutionCommand, XpFileSystem, XpertServerPlugin, als, appendSandboxMessage, buildSandboxTimeoutMessage, calcTokenUsage, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, defineAgentMessageType, defineChannelMessageType, downloadRemoteFile, formatSandboxTimeout, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, isRemoteFile, isSandboxBackend, isStructuredMessageType, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, resolveSandboxExecutionOptions, runWithRequestContext, secondsToMilliseconds, sumTokenUsage };
+const VIEW_EXTENSION_PROVIDER = 'VIEW_EXTENSION_PROVIDER';
+const ViewExtensionProvider = (providerKey)=>applyDecorators(SetMetadata(VIEW_EXTENSION_PROVIDER, providerKey), SetMetadata(STRATEGY_META_KEY, VIEW_EXTENSION_PROVIDER));
+
+let ViewExtensionProviderRegistry = class ViewExtensionProviderRegistry extends BaseStrategyRegistry {
+    listEntries(organizationId) {
+        var _this_strategies_get;
+        const orgKey = this.resolveOrganization(organizationId);
+        const entries = new Map();
+        var _this_strategies_get_entries;
+        for (const [providerKey, provider] of (_this_strategies_get_entries = (_this_strategies_get = this.strategies.get(orgKey)) == null ? void 0 : _this_strategies_get.entries()) != null ? _this_strategies_get_entries : []){
+            entries.set(providerKey, provider);
+        }
+        if (orgKey !== GLOBAL_ORGANIZATION_SCOPE) {
+            var _this_strategies_get1;
+            var _this_strategies_get_entries1;
+            for (const [providerKey, provider] of (_this_strategies_get_entries1 = (_this_strategies_get1 = this.strategies.get(GLOBAL_ORGANIZATION_SCOPE)) == null ? void 0 : _this_strategies_get1.entries()) != null ? _this_strategies_get_entries1 : []){
+                if (!entries.has(providerKey)) {
+                    entries.set(providerKey, provider);
+                }
+            }
+        }
+        return Array.from(entries.entries()).map(([providerKey, provider])=>({
+                providerKey,
+                provider
+            }));
+    }
+    constructor(discoveryService, reflector){
+        super(VIEW_EXTENSION_PROVIDER, discoveryService, reflector);
+    }
+};
+ViewExtensionProviderRegistry = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [
+        DiscoveryService,
+        Reflector
+    ])
+], ViewExtensionProviderRegistry);
+
+export { AGENT_CHAT_DISPATCH_MESSAGE_TYPE, AGENT_MIDDLEWARE_STRATEGY, AIModelProviderNotFoundException, AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, ANALYTICS_PERMISSION_SERVICE_TOKEN, AdapterDataSourceStrategy, AgentMiddlewareRegistry, AgentMiddlewareStrategy, AiModelNotFoundException, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, BaseTool, BaseToolset, BuiltinToolset, CHAT_CHANNEL, CHAT_CHANNEL_TEXT_LIMITS, CancelConversationCommand, ChatChannel, ChatChannelRegistry, ChatOAICompatReasoningModel, CommonParameterRules, CreateModelClientCommand, CredentialsValidateFailedError, DATASOURCE_STRATEGY, DBCreateTableMode, DBProtocolEnum, DBSyntaxEnum, DBTableAction, DBTableDataAction, DEFAULT_EXECUTION_CONFIG, DEFAULT_SANDBOX_EXECUTION_MAX_OUTPUT_BYTES, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_SEC, DEFAULT_SANDBOX_FILE_SEARCH_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_SEC, DEFAULT_SANDBOX_SHELL_EXECUTION_OPTIONS, DEFAULT_SANDBOX_SHELL_TIMEOUT_MS, DEFAULT_SANDBOX_SHELL_TIMEOUT_SEC, DOCUMENT_SOURCE_STRATEGY, DOCUMENT_TRANSFORMER_STRATEGY, DataSourceStrategy, DataSourceStrategyRegistry, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, FILE_STORAGE_PROVIDER, FILE_UPLOAD_TARGET_STRATEGY, FileStorageProvider, FileStorageProviderRegistry, FileUploadTargetRegistry, FileUploadTargetStrategy, GLOBAL_ORGANIZATION_SCOPE, HANDOFF_PERMISSION_SERVICE_TOKEN, HANDOFF_PROCESSOR_STRATEGY, HANDOFF_QUEUE_SERVICE_TOKEN, HandoffProcessorRegistry, HandoffProcessorStrategy, IMAGE_UNDERSTANDING_STRATEGY, INTEGRATION_PERMISSION_SERVICE_TOKEN, INTEGRATION_STRATEGY, ImageUnderstandingRegistry, ImageUnderstandingStrategy, IntegrationStrategyKey, IntegrationStrategyRegistry, JUMP_TO_TARGETS, JsonSchemaValidator, KNOWLEDGE_STRATEGY, KnowledgeStrategyKey, KnowledgeStrategyRegistry, LLMUsage, LargeLanguageModel, ModelProvider, ORGANIZATION_METADATA_KEY, OpenAICompatibleReranker, PERMISSION_OPERATION_METADATA_KEY, PLUGIN_CONFIG_RESOLVER_TOKEN, PLUGIN_METADATA, PLUGIN_METADATA_KEY, PROVIDE_AI_MODEL_LLM, PROVIDE_AI_MODEL_MODERATION, PROVIDE_AI_MODEL_RERANK, PROVIDE_AI_MODEL_SPEECH2TEXT, PROVIDE_AI_MODEL_TEXT_EMBEDDING, PROVIDE_AI_MODEL_TTS, RETRIEVER_STRATEGY, RequestContext, RequestContextMiddleware, RequirePermissionOperation, RerankModel, RetrieverRegistry, RetrieverStrategy, SANDBOX_PROVIDER, SANDBOX_SHELL_TIMEOUT_LIMITS_SEC, SKILL_SOURCE_PROVIDER, STRATEGY_META_KEY, SandboxProviderRegistry, SandboxProviderStrategy, SkillSourceProviderRegistry, SkillSourceProviderStrategy, Speech2TextChatModel, SpeechToTextModel, StrategyBus, TEXT_SPLITTER_STRATEGY, TOOLSET_STRATEGY, TextEmbeddingModelManager, TextSplitterRegistry, TextSplitterStrategy, TextToSpeechModel, ToolsetRegistry, ToolsetStrategy, USER_PERMISSION_SERVICE_TOKEN, VECTOR_STORE_STRATEGY, VIEW_EXTENSION_PROVIDER, VectorStoreRegistry, VectorStoreStrategy, ViewExtensionProvider, ViewExtensionProviderRegistry, WORKFLOW_NODE_STRATEGY, WORKFLOW_TRIGGER_STRATEGY, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, WrapWorkflowNodeExecutionCommand, XpFileSystem, XpertServerPlugin, als, appendSandboxMessage, buildSandboxTimeoutMessage, calcTokenUsage, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, defineAgentMessageType, defineChannelMessageType, downloadRemoteFile, formatSandboxTimeout, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, isRemoteFile, isSandboxBackend, isStructuredMessageType, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, resolveSandboxBackend, resolveSandboxExecutionOptions, runWithRequestContext, secondsToMilliseconds, sumTokenUsage };