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

package/index.cjs.js

@@ -33,20 +33,20 @@ require('js-tiktoken');
 var base = require('@langchain/core/language_models/base');
 
 function _interopNamespaceDefault(e) {
-	var n = Object.create(null);
-	if (e) {
-		Object.keys(e).forEach(function (k) {
-			if (k !== 'default') {
-				var d = Object.getOwnPropertyDescriptor(e, k);
-				Object.defineProperty(n, k, d.get ? d : {
-					enumerable: true,
-					get: function () { return e[k]; }
-				});
-			}
-		});
-	}
-	n.default = e;
-	return Object.freeze(n);
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n.default = e;
+    return Object.freeze(n);
 }
 
 var fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
@@ -58,11 +58,11 @@ var _axios__namespace = /*#__PURE__*/_interopNamespaceDefault(_axios);
  * 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'
 };
 
 /**
@@ -107,10 +107,10 @@ function _extends() {
 function createPluginLogger(scope, baseMeta = {}) {
     const nestLogger = new common.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) {
@@ -141,6 +141,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();
@@ -153,6 +155,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) {
@@ -194,9 +201,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
@@ -212,21 +219,71 @@ class RequestContext {
         // Return the extracted language code or the default language (ENGLISH) if not found
         return lang || contracts.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 common.BadRequestException(`Unsupported scope level: ${scopeLevelHeader}`);
+            }
+            if (scopeLevelHeader === TENANT_SCOPE) {
+                if (organizationId) {
+                    throw new common.BadRequestException('Tenant scope requests must not include Organization-Id.');
                 }
+                return {
+                    tenantId,
+                    level: TENANT_SCOPE,
+                    organizationId: null
+                };
+            }
+            if (!organizationId) {
+                throw new common.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 common.BadRequestException('Organization scope is required for this operation.');
+        }
+        return scope.organizationId;
     }
     static hasPermissions(findPermissions, throwError) {
         const requestContext = RequestContext.currentRequestContext();
@@ -280,22 +337,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 {
@@ -332,8 +389,23 @@ const als = new node_async_hooks.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
 exports.RequestContextMiddleware = class RequestContextMiddleware {
     use(req, _res, next) {
         var _req_user;
@@ -434,10 +506,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();
@@ -451,34 +523,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 common.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([
     common.Inject(exports.StrategyBus),
-    __metadata("design:type", typeof exports.StrategyBus === "undefined" ? Object : exports.StrategyBus)
+    __metadata("design:type", exports.StrategyBus)
 ], BaseStrategyRegistry.prototype, "bus", void 0);
 
 exports.IntegrationStrategyRegistry = class IntegrationStrategyRegistry extends BaseStrategyRegistry {
@@ -488,10 +568,9 @@ exports.IntegrationStrategyRegistry = class IntegrationStrategyRegistry extends
 };
 exports.IntegrationStrategyRegistry = __decorate([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
-        typeof core.Reflector === "undefined" ? Object : core.Reflector
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.IntegrationStrategyRegistry);
 
@@ -505,10 +584,9 @@ exports.WorkflowTriggerRegistry = class WorkflowTriggerRegistry extends BaseStra
 };
 exports.WorkflowTriggerRegistry = __decorate([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
-        typeof core.Reflector === "undefined" ? Object : core.Reflector
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.WorkflowTriggerRegistry);
 
@@ -517,21 +595,22 @@ const WORKFLOW_NODE_STRATEGY = 'WORKFLOW_NODE_STRATEGY';
  * Decorator to mark a provider as a Workflow Node Strategy
  */ const WorkflowNodeStrategy = (provider)=>common.applyDecorators(common.SetMetadata(WORKFLOW_NODE_STRATEGY, provider), common.SetMetadata(STRATEGY_META_KEY, WORKFLOW_NODE_STRATEGY));
 
-exports.WorkflowNodeRegistry = class WorkflowNodeRegistry extends BaseStrategyRegistry {
+/**
+ * Registry for Workflow Node Strategies
+ */ exports.WorkflowNodeRegistry = class WorkflowNodeRegistry extends BaseStrategyRegistry {
     constructor(discoveryService, reflector){
         super(WORKFLOW_NODE_STRATEGY, discoveryService, reflector);
     }
 };
 exports.WorkflowNodeRegistry = __decorate([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
-        typeof core.Reflector === "undefined" ? Object : core.Reflector
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.WorkflowNodeRegistry);
 
-const COMMAND_METADATA$1 = '__command__';
+const COMMAND_METADATA$2 = '__command__';
 /**
  * Wrap Workflow Node Execution Command
  */ class WrapWorkflowNodeExecutionCommand extends cqrs.Command {
@@ -542,7 +621,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);
 
@@ -556,10 +635,9 @@ exports.VectorStoreRegistry = class VectorStoreRegistry extends BaseStrategyRegi
 };
 exports.VectorStoreRegistry = __decorate([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
-        typeof core.Reflector === "undefined" ? Object : core.Reflector
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.VectorStoreRegistry);
 
@@ -573,10 +651,9 @@ exports.TextSplitterRegistry = class TextSplitterRegistry extends BaseStrategyRe
 };
 exports.TextSplitterRegistry = __decorate([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
-        typeof core.Reflector === "undefined" ? Object : core.Reflector
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.TextSplitterRegistry);
 
@@ -592,10 +669,9 @@ exports.DocumentSourceRegistry = class DocumentSourceRegistry extends BaseStrate
 };
 exports.DocumentSourceRegistry = __decorate([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
-        typeof core.Reflector === "undefined" ? Object : core.Reflector
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.DocumentSourceRegistry);
 
@@ -611,10 +687,9 @@ exports.DocumentTransformerRegistry = class DocumentTransformerRegistry extends
 };
 exports.DocumentTransformerRegistry = __decorate([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
-        typeof core.Reflector === "undefined" ? Object : core.Reflector
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.DocumentTransformerRegistry);
 
@@ -630,16 +705,15 @@ exports.RetrieverRegistry = class RetrieverRegistry extends BaseStrategyRegistry
 };
 exports.RetrieverRegistry = __decorate([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
-        typeof core.Reflector === "undefined" ? Object : core.Reflector
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.RetrieverRegistry);
 
 /**
  * Merge parent chunks with their child chunks based on metadata (parentId and chunkId)
- * 
+ *
  * @deprecated use buildChunkTreeAndFindLeaves instead
  */ function mergeParentChildChunks(chunks, children // Child chunks
 ) {
@@ -705,10 +779,9 @@ exports.ImageUnderstandingRegistry = class ImageUnderstandingRegistry extends Ba
 };
 exports.ImageUnderstandingRegistry = __decorate([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
-        typeof core.Reflector === "undefined" ? Object : core.Reflector
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.ImageUnderstandingRegistry);
 
@@ -722,10 +795,9 @@ exports.KnowledgeStrategyRegistry = class KnowledgeStrategyRegistry extends Base
 };
 exports.KnowledgeStrategyRegistry = __decorate([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
-        typeof core.Reflector === "undefined" ? Object : core.Reflector
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.KnowledgeStrategyRegistry);
 
@@ -741,10 +813,9 @@ exports.ToolsetRegistry = class ToolsetRegistry extends BaseStrategyRegistry {
 };
 exports.ToolsetRegistry = __decorate([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
-        typeof core.Reflector === "undefined" ? Object : core.Reflector
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.ToolsetRegistry);
 
@@ -752,26 +823,26 @@ exports.ToolsetRegistry = __decorate([
  * Base ability for all toolsets
  */ class BaseToolset extends tools.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;
     }
     /**
@@ -829,26 +900,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() {
@@ -857,27 +928,27 @@ class BuiltinToolset extends BaseToolset {
     }
     constructor(providerName, toolset, params){
         super(params);
+        this.logger = new common.Logger(this.constructor.name);
         this.providerName = providerName;
         this.toolset = toolset;
         this.params = params;
-        this.logger = new common.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.resolve(targetPath);
         for (const s of this.scope){
@@ -887,33 +958,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.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);
@@ -925,22 +996,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;
@@ -1047,7 +1118,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
@@ -1116,10 +1187,9 @@ exports.DataSourceStrategyRegistry = class DataSourceStrategyRegistry extends Ba
 };
 exports.DataSourceStrategyRegistry = __decorate([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
-        typeof core.Reflector === "undefined" ? Object : core.Reflector
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.DataSourceStrategyRegistry);
 
@@ -1128,12 +1198,12 @@ exports.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);
@@ -1169,9 +1239,10 @@ exports.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();
     }
 }
 
@@ -1271,13 +1342,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 exports.DBTableAction.CREATE_TABLE:
                 {
                     // Default implementation for creating table (generic SQL syntax)
-                    const { schema, table, columns, createMode = "error" } = params;
+                    const { schema, table, columns, createMode = exports.DBCreateTableMode.ERROR } = params;
                     const tableName = schema ? `${schema}.${table}` : table;
                     // Check if table exists (try to query table info)
                     let exists = false;
@@ -1289,17 +1360,17 @@ class BaseSQLQueryRunner extends BaseQueryRunner {
                         exists = false;
                     }
                     // --- MODE: ERROR → throw error if table exists ---
-                    if (exists && createMode === "error") {
+                    if (exists && createMode === exports.DBCreateTableMode.ERROR) {
                         throw new Error(`Table "${tableName}" already exists`);
                     }
                     // --- MODE: IGNORE → do nothing if exists ---
-                    if (exists && createMode === "ignore") {
+                    if (exists && createMode === exports.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 === exports.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){
@@ -1324,7 +1395,7 @@ class BaseSQLQueryRunner extends BaseQueryRunner {
                     await this.runQuery(createTableStatement, options);
                     return;
                 }
-            case "dropTable":
+            case exports.DBTableAction.DROP_TABLE:
                 {
                     // Default implementation for dropping table
                     const { schema, table } = params;
@@ -1338,8 +1409,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)';
@@ -1359,8 +1430,8 @@ class BaseSQLQueryRunner extends BaseQueryRunner {
     }
     constructor(...args){
         super(...args);
-        this.syntax = "sql";
-        this.protocol = "sql";
+        this.syntax = exports.DBSyntaxEnum.SQL;
+        this.protocol = exports.DBProtocolEnum.SQL;
     }
 }
 exports.DBTableAction = void 0;
@@ -1381,7 +1452,9 @@ exports.DBTableAction = void 0;
     DBTableAction["CLONE_TABLE"] = "cloneTable";
     DBTableAction["OPTIMIZE_TABLE"] = "optimizeTable";
 })(exports.DBTableAction || (exports.DBTableAction = {}));
-exports.DBCreateTableMode = void 0;
+/**
+ * Modes for creating a table, if the table already exists
+ */ exports.DBCreateTableMode = void 0;
 (function(DBCreateTableMode) {
     DBCreateTableMode["ERROR"] = "error";
     DBCreateTableMode["IGNORE"] = "ignore";
@@ -1411,8 +1484,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:///')) {
@@ -1447,10 +1519,9 @@ exports.AIModelProviderRegistry = class AIModelProviderRegistry extends BaseStra
 };
 exports.AIModelProviderRegistry = __decorate([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
-        typeof core.Reflector === "undefined" ? Object : core.Reflector
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.AIModelProviderRegistry);
 
@@ -1461,7 +1532,8 @@ class CredentialsValidateFailedError extends common.ForbiddenException {
 class AIModelProviderNotFoundException extends common.NotFoundException {
 }
 
-exports.ModelProvider = class ModelProvider {
+var ModelProvider_1;
+exports.ModelProvider = ModelProvider_1 = class ModelProvider {
     get name() {
         return this.getProviderSchema().provider;
     }
@@ -1469,10 +1541,10 @@ exports.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() {
@@ -1507,11 +1579,11 @@ exports.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);
@@ -1563,7 +1635,7 @@ exports.ModelProvider = class ModelProvider {
         return null;
     }
     constructor(){
-        this.logger = new common.Logger(ModelProvider.name);
+        this.logger = new common.Logger(ModelProvider_1.name);
         // protected providerSchema: IAiProviderEntity | null = null
         this.modelManagers = new Map();
         const provider = Reflect.getMetadata(AI_MODEL_PROVIDER, this.constructor);
@@ -1573,9 +1645,8 @@ exports.ModelProvider = class ModelProvider {
         this.dir = dir;
     }
 };
-exports.ModelProvider = __decorate([
+exports.ModelProvider = ModelProvider_1 = __decorate([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [])
 ], exports.ModelProvider);
 
@@ -1764,7 +1835,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!`);
     }
@@ -1839,13 +1911,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) {
@@ -1917,29 +1989,28 @@ let AIModel = class AIModel {
         };
     }
     constructor(modelProvider, modelType){
-        this.modelProvider = modelProvider;
-        this.modelType = modelType;
-        this.logger = new common.Logger(AIModel.name);
+        this.logger = new common.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([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof exports.ModelProvider === "undefined" ? Object : exports.ModelProvider,
-        typeof contracts.AiModelTypeEnum === "undefined" ? Object : contracts.AiModelTypeEnum
+        exports.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}`);
     }
@@ -2005,17 +2076,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);
@@ -2023,11 +2095,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;
@@ -2147,15 +2219,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 common.Logger(LargeLanguageModel.name);
+        _class_private_field_loose_base(this, _logger)[_logger] = new common.Logger(_a.name);
     }
 }
+_a = LargeLanguageModel;
 function calcTokenUsage(output) {
     var _output_generations;
     const tokenUsage = {
@@ -2203,8 +2348,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 openai.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>') {
@@ -2390,7 +2535,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 cqrs.Command {
@@ -2401,10 +2546,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)=>common.applyDecorators(common.SetMetadata(SKILL_SOURCE_PROVIDER, provider), common.SetMetadata(STRATEGY_META_KEY, SKILL_SOURCE_PROVIDER));
+
+exports.SkillSourceProviderRegistry = class SkillSourceProviderRegistry extends BaseStrategyRegistry {
+    constructor(discoveryService, reflector){
+        super(SKILL_SOURCE_PROVIDER, discoveryService, reflector);
+    }
+};
+exports.SkillSourceProviderRegistry = __decorate([
+    common.Injectable(),
+    __metadata("design:paramtypes", [
+        core.DiscoveryService,
+        core.Reflector
+    ])
+], exports.SkillSourceProviderRegistry);
+
 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));
 
@@ -2415,10 +2576,9 @@ exports.AgentMiddlewareRegistry = class AgentMiddlewareRegistry extends BaseStra
 };
 exports.AgentMiddlewareRegistry = __decorate([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
-        typeof core.Reflector === "undefined" ? Object : core.Reflector
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.AgentMiddlewareRegistry);
 
@@ -2430,15 +2590,7 @@ 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 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)) {
@@ -2504,10 +2656,9 @@ exports.HandoffProcessorRegistry = class HandoffProcessorRegistry extends BaseSt
 };
 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
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.HandoffProcessorRegistry);
 
@@ -2616,26 +2767,52 @@ exports.HandoffProcessorRegistry = __decorate([
  * ```
  */ const ChatChannel = (type)=>common.SetMetadata(CHAT_CHANNEL, type);
 
-exports.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!')
+ * ```
+ */ 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
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.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)=>common.applyDecorators(common.SetMetadata(FILE_STORAGE_PROVIDER, provider), common.SetMetadata(STRATEGY_META_KEY, FILE_STORAGE_PROVIDER));
@@ -2647,10 +2824,9 @@ exports.FileStorageProviderRegistry = class FileStorageProviderRegistry extends
 };
 exports.FileStorageProviderRegistry = __decorate([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
-        typeof core.Reflector === "undefined" ? Object : core.Reflector
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.FileStorageProviderRegistry);
 
@@ -2664,10 +2840,9 @@ exports.FileUploadTargetRegistry = class FileUploadTargetRegistry extends BaseSt
 };
 exports.FileUploadTargetRegistry = __decorate([
     common.Injectable(),
-    __metadata("design:type", Function),
     __metadata("design:paramtypes", [
-        typeof core.DiscoveryService === "undefined" ? Object : core.DiscoveryService,
-        typeof core.Reflector === "undefined" ? Object : core.Reflector
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.FileUploadTargetRegistry);
 
@@ -2722,8 +2897,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;
@@ -3341,6 +3526,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) {
@@ -3349,13 +3541,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 [];
         }
@@ -3377,14 +3569,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';
         }
@@ -3395,34 +3587,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:')) {
@@ -3446,8 +3638,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;
@@ -3458,10 +3650,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){
@@ -3480,8 +3672,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';
@@ -3489,10 +3681,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)) {
@@ -3514,7 +3706,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.`
@@ -3543,10 +3735,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 {
@@ -3559,10 +3751,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:
                 {
@@ -3592,10 +3784,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'
@@ -3635,29 +3827,50 @@ exports.SandboxProviderRegistry = class SandboxProviderRegistry extends BaseStra
 };
 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
+        core.DiscoveryService,
+        core.Reflector
     ])
 ], exports.SandboxProviderRegistry);
 
-Object.defineProperty(exports, "IColumnDef", {
-	enumerable: true,
-	get: function () { return contracts.IColumnDef; }
-});
-Object.defineProperty(exports, "IDSSchema", {
-	enumerable: true,
-	get: function () { return contracts.IDSSchema; }
-});
-Object.defineProperty(exports, "IDSTable", {
-	enumerable: true,
-	get: function () { return contracts.IDSTable; }
-});
-Object.defineProperty(exports, "TDocumentAsset", {
-	enumerable: true,
-	get: function () { return contracts.TDocumentAsset; }
-});
+const VIEW_EXTENSION_PROVIDER = 'VIEW_EXTENSION_PROVIDER';
+const ViewExtensionProvider = (providerKey)=>common.applyDecorators(common.SetMetadata(VIEW_EXTENSION_PROVIDER, providerKey), common.SetMetadata(STRATEGY_META_KEY, VIEW_EXTENSION_PROVIDER));
+
+exports.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);
+    }
+};
+exports.ViewExtensionProviderRegistry = __decorate([
+    common.Injectable(),
+    __metadata("design:paramtypes", [
+        core.DiscoveryService,
+        core.Reflector
+    ])
+], exports.ViewExtensionProviderRegistry);
+
 exports.AGENT_CHAT_DISPATCH_MESSAGE_TYPE = AGENT_CHAT_DISPATCH_MESSAGE_TYPE;
 exports.AGENT_MIDDLEWARE_STRATEGY = AGENT_MIDDLEWARE_STRATEGY;
 exports.AIModelProviderNotFoundException = AIModelProviderNotFoundException;
@@ -3739,8 +3952,10 @@ exports.RerankModel = RerankModel;
 exports.RetrieverStrategy = RetrieverStrategy;
 exports.SANDBOX_PROVIDER = SANDBOX_PROVIDER;
 exports.SANDBOX_SHELL_TIMEOUT_LIMITS_SEC = SANDBOX_SHELL_TIMEOUT_LIMITS_SEC;
+exports.SKILL_SOURCE_PROVIDER = SKILL_SOURCE_PROVIDER;
 exports.STRATEGY_META_KEY = STRATEGY_META_KEY;
 exports.SandboxProviderStrategy = SandboxProviderStrategy;
+exports.SkillSourceProviderStrategy = SkillSourceProviderStrategy;
 exports.Speech2TextChatModel = Speech2TextChatModel;
 exports.SpeechToTextModel = SpeechToTextModel;
 exports.TEXT_SPLITTER_STRATEGY = TEXT_SPLITTER_STRATEGY;
@@ -3751,7 +3966,9 @@ exports.TextToSpeechModel = TextToSpeechModel;
 exports.ToolsetStrategy = ToolsetStrategy;
 exports.USER_PERMISSION_SERVICE_TOKEN = USER_PERMISSION_SERVICE_TOKEN;
 exports.VECTOR_STORE_STRATEGY = VECTOR_STORE_STRATEGY;
+exports.VIEW_EXTENSION_PROVIDER = VIEW_EXTENSION_PROVIDER;
 exports.VectorStoreStrategy = VectorStoreStrategy;
+exports.ViewExtensionProvider = ViewExtensionProvider;
 exports.WORKFLOW_NODE_STRATEGY = WORKFLOW_NODE_STRATEGY;
 exports.WORKFLOW_TRIGGER_STRATEGY = WORKFLOW_TRIGGER_STRATEGY;
 exports.WorkflowNodeStrategy = WorkflowNodeStrategy;
@@ -3785,6 +4002,7 @@ exports.loadYamlFile = loadYamlFile;
 exports.mergeCredentials = mergeCredentials;
 exports.mergeParentChildChunks = mergeParentChildChunks;
 exports.normalizeContextSize = normalizeContextSize;
+exports.resolveSandboxBackend = resolveSandboxBackend;
 exports.resolveSandboxExecutionOptions = resolveSandboxExecutionOptions;
 exports.runWithRequestContext = runWithRequestContext;
 exports.secondsToMilliseconds = secondsToMilliseconds;