@lark-apaas/nestjs-capability 0.0.1-alpha.8 → 0.1.0

package/dist/index.cjs

@@ -41,10 +41,15 @@ __export(index_exports, {
   PluginLoaderService: () => PluginLoaderService,
   PluginNotFoundError: () => PluginNotFoundError,
   TemplateEngineService: () => TemplateEngineService,
-  WebhookController: () => WebhookController
+  WebhookController: () => WebhookController,
+  migrationAdaptor: () => migrationAdaptor
 });
 module.exports = __toCommonJS(index_exports);
 
+// ../../../node_modules/tsup/assets/cjs_shims.js
+var getImportMetaUrl = /* @__PURE__ */ __name(() => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href, "getImportMetaUrl");
+var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+
 // src/interfaces/error-codes.ts
 var ErrorCodes = {
   /** 成功 */
@@ -75,9 +80,9 @@ var TemplateEngineService = class {
     __name(this, "TemplateEngineService");
   }
   // 匹配 {{input.xxx}} 或 {{input.xxx.yyy}} 表达式
-  EXPR_REGEX = /\{\{input\.([a-zA-Z_][a-zA-Z_0-9]*(?:\.[a-zA-Z_][a-zA-Z_0-9]*)*)\}\}/g;
+  EXPR_REGEX = /\{\{\s*input\.([a-zA-Z_][a-zA-Z_0-9]*(?:\.[a-zA-Z_][a-zA-Z_0-9]*)*\s*)\}\}/g;
   // 匹配整串单个表达式
-  WHOLE_STRING_EXPR_REGEX = /^\{\{input\.([a-zA-Z_][a-zA-Z_0-9]*(?:\.[a-zA-Z_][a-zA-Z_0-9]*)*)\}\}$/;
+  WHOLE_STRING_EXPR_REGEX = /^\{\{\s*input\.([a-zA-Z_][a-zA-Z_0-9]*(?:\.[a-zA-Z_][a-zA-Z_0-9]*)*)\s*\}\}$/;
   resolve(template, input) {
     if (typeof template === "string") {
       return this.resolveString(template, input);
@@ -136,6 +141,8 @@ TemplateEngineService = _ts_decorate([
 
 // src/services/plugin-loader.service.ts
 var import_common2 = require("@nestjs/common");
+var import_node_module = require("module");
+var import_node_url = require("url");
 function _ts_decorate2(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -143,13 +150,16 @@ function _ts_decorate2(decorators, target, key, desc) {
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate2, "_ts_decorate");
+var require2 = (0, import_node_module.createRequire)(importMetaUrl);
 var PluginNotFoundError = class extends Error {
   static {
     __name(this, "PluginNotFoundError");
   }
+  pluginKey;
   constructor(pluginKey) {
     super(`Plugin not found: ${pluginKey}`);
     this.name = "PluginNotFoundError";
+    this.pluginKey = pluginKey;
   }
 };
 var PluginLoadError = class extends Error {
@@ -167,6 +177,8 @@ var PluginLoaderService = class _PluginLoaderService {
   }
   logger = new import_common2.Logger(_PluginLoaderService.name);
   pluginInstances = /* @__PURE__ */ new Map();
+  /** 记录每个插件的加载版本（时间戳），用于 ESM 缓存绕过 */
+  pluginVersions = /* @__PURE__ */ new Map();
   async loadPlugin(pluginKey) {
     const cached = this.pluginInstances.get(pluginKey);
     if (cached) {
@@ -175,7 +187,12 @@ var PluginLoaderService = class _PluginLoaderService {
     }
     this.logger.log(`Loading plugin: ${pluginKey}`);
     try {
-      const pluginPackage = (await import(pluginKey)).default;
+      const resolvedPath = require2.resolve(pluginKey);
+      const version = this.pluginVersions.get(pluginKey) ?? 0;
+      const fileUrl = (0, import_node_url.pathToFileURL)(resolvedPath).href;
+      const importPath = version > 0 ? `${fileUrl}?v=${version}` : fileUrl;
+      const mod = await import(importPath);
+      const pluginPackage = mod.default ?? mod;
       if (typeof pluginPackage.create !== "function") {
         throw new PluginLoadError(pluginKey, "Plugin does not export create() function");
       }
@@ -192,21 +209,68 @@ var PluginLoaderService = class _PluginLoaderService {
   }
   isPluginInstalled(pluginKey) {
     try {
-      require.resolve(pluginKey);
+      require2.resolve(pluginKey);
       return true;
     } catch {
       return false;
     }
   }
+  /**
+  * 清除插件缓存
+  * - 清除应用层 pluginInstances 缓存
+  * - 清除 Node.js CJS 模块缓存（require.cache）
+  * - 更新版本号，下次 import 时绕过 ESM 缓存
+  * @param pluginKey - 插件标识，不传则清除所有
+  */
   clearCache(pluginKey) {
     if (pluginKey) {
       this.pluginInstances.delete(pluginKey);
+      this.clearNodeModuleCache(pluginKey);
+      this.pluginVersions.set(pluginKey, Date.now());
       this.logger.log(`Cleared cache for plugin: ${pluginKey}`);
     } else {
+      for (const key of this.pluginInstances.keys()) {
+        this.clearNodeModuleCache(key);
+        this.pluginVersions.set(key, Date.now());
+      }
       this.pluginInstances.clear();
       this.logger.log("Cleared all plugin caches");
     }
   }
+  /**
+  * 清除 CJS 模块缓存
+  */
+  clearNodeModuleCache(pluginKey) {
+    try {
+      const resolvedPath = require2.resolve(pluginKey);
+      const mod = require2.cache[resolvedPath];
+      if (mod) {
+        this.clearModuleAndChildren(mod, pluginKey);
+      }
+      delete require2.cache[resolvedPath];
+    } catch {
+    }
+  }
+  /**
+  * 递归清除子模块缓存
+  */
+  clearModuleAndChildren(mod, pluginKey) {
+    const pluginScope = pluginKey.startsWith("@") ? pluginKey.split("/").slice(0, 2).join("/") : pluginKey;
+    mod.children.forEach((child) => {
+      if (child.filename.includes(`node_modules/${pluginScope}`)) {
+        this.clearModuleAndChildren(child, pluginKey);
+        delete require2.cache[child.filename];
+      }
+    });
+  }
+  /**
+  * 强制重新加载插件
+  * @param pluginKey - 插件标识
+  */
+  async reloadPlugin(pluginKey) {
+    this.clearCache(pluginKey);
+    return this.loadPlugin(pluginKey);
+  }
 };
 PluginLoaderService = _ts_decorate2([
   (0, import_common2.Injectable)()
@@ -217,6 +281,7 @@ var import_common3 = require("@nestjs/common");
 var import_nestjs_common = require("@lark-apaas/nestjs-common");
 var fs = __toESM(require("fs"), 1);
 var path = __toESM(require("path"), 1);
+var chokidar = __toESM(require("chokidar"), 1);
 
 // src/utils/log-utils.ts
 var DEFAULT_MAX_LENGTH = 1e3;
@@ -238,6 +303,43 @@ function stringifyForLog(value, maxLength = DEFAULT_MAX_LENGTH) {
 }
 __name(stringifyForLog, "stringifyForLog");
 
+// src/utils/migration-adaptor.ts
+async function migrationAdaptor(promise) {
+  try {
+    const result = await promise;
+    return {
+      code: 0,
+      data: {
+        output: result,
+        outcome: "success"
+      }
+    };
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    const appStatusCode = error instanceof Error && "code" in error ? String(error.code) : "EXECUTION_ERROR";
+    return {
+      code: -1,
+      data: {
+        outcome: "error",
+        failureOutput: {
+          response: {
+            status: {
+              protocolStatusCode: "500",
+              appStatusCode
+            },
+            body: JSON.stringify({
+              error: errorMessage,
+              stack: error instanceof Error ? error.stack : void 0
+            })
+          }
+        }
+      },
+      message: errorMessage
+    };
+  }
+}
+__name(migrationAdaptor, "migrationAdaptor");
+
 // src/services/capability.service.ts
 function _ts_decorate3(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -260,18 +362,24 @@ var CapabilityNotFoundError = class extends Error {
   static {
     __name(this, "CapabilityNotFoundError");
   }
+  capabilityId;
   constructor(capabilityId) {
     super(`Capability not found: ${capabilityId}`);
     this.name = "CapabilityNotFoundError";
+    this.capabilityId = capabilityId;
   }
 };
 var ActionNotFoundError = class extends Error {
   static {
     __name(this, "ActionNotFoundError");
   }
+  pluginKey;
+  actionName;
   constructor(pluginKey, actionName) {
     super(`Action '${actionName}' not found in plugin ${pluginKey}`);
     this.name = "ActionNotFoundError";
+    this.pluginKey = pluginKey;
+    this.actionName = actionName;
   }
 };
 var CapabilityService = class _CapabilityService {
@@ -284,20 +392,153 @@ var CapabilityService = class _CapabilityService {
   templateEngineService;
   logger = new import_common3.Logger(_CapabilityService.name);
   capabilities = /* @__PURE__ */ new Map();
+  /** 文件路径到 capability id 的映射，用于文件删除时查找 */
+  filePathToId = /* @__PURE__ */ new Map();
   capabilitiesDir;
+  fileWatcher = null;
+  options = {};
   constructor(requestContextService, platformHttpClient, pluginLoaderService, templateEngineService) {
     this.requestContextService = requestContextService;
     this.platformHttpClient = platformHttpClient;
     this.pluginLoaderService = pluginLoaderService;
     this.templateEngineService = templateEngineService;
-    this.capabilitiesDir = path.join(process.cwd(), "server/capabilities");
+    const isDev = process.env.NODE_ENV === "development";
+    this.capabilitiesDir = path.join(process.cwd(), isDev ? "server/capabilities" : "capabilities");
+  }
+  /**
+  * 设置模块配置
+  */
+  setOptions(options) {
+    this.options = options;
+    if (options.capabilitiesDir) {
+      this.capabilitiesDir = options.capabilitiesDir;
+    }
   }
   setCapabilitiesDir(dir) {
     this.capabilitiesDir = dir;
   }
   async onModuleInit() {
     await this.loadCapabilities();
+    if (this.options.enableWatching) {
+      this.startWatching();
+    }
+  }
+  async onModuleDestroy() {
+    this.stopWatching();
+  }
+  // ==================== 文件监听相关方法 ====================
+  /**
+  * 启动文件监听（沙箱环境自动调用）
+  */
+  startWatching() {
+    if (this.fileWatcher) {
+      return;
+    }
+    if (!fs.existsSync(this.capabilitiesDir)) {
+      this.logger.warn(`Cannot start watching: directory not found: ${this.capabilitiesDir}`);
+      return;
+    }
+    const pattern = path.join(this.capabilitiesDir, "*.json");
+    const debounce = this.options.watchDebounce ?? 300;
+    this.logger.log(`Starting file watcher: ${pattern}`);
+    this.fileWatcher = chokidar.watch(pattern, {
+      persistent: true,
+      ignoreInitial: true,
+      awaitWriteFinish: {
+        // 等待写入完成
+        stabilityThreshold: debounce,
+        pollInterval: 100
+      }
+    });
+    this.fileWatcher.on("add", (filePath) => this.handleFileAdd(filePath)).on("change", (filePath) => this.handleFileChange(filePath)).on("unlink", (filePath) => this.handleFileUnlink(filePath)).on("error", (error) => this.logger.error("File watcher error:", error));
+    this.logger.log("File watcher started");
+  }
+  /**
+  * 停止文件监听
+  */
+  stopWatching() {
+    if (this.fileWatcher) {
+      this.fileWatcher.close();
+      this.fileWatcher = null;
+      this.logger.log("File watcher stopped");
+    }
+  }
+  /**
+  * 重新加载所有能力配置
+  */
+  async reloadAllCapabilities() {
+    this.capabilities.clear();
+    this.filePathToId.clear();
+    await this.loadCapabilities();
+  }
+  handleFileAdd(filePath) {
+    this.logger.log(`Capability file added: ${filePath}`);
+    try {
+      this.loadCapabilityFromFile(filePath);
+      const capabilityId = this.filePathToId.get(filePath);
+      if (capabilityId) {
+        const config = this.capabilities.get(capabilityId);
+        if (config?.pluginKey) {
+          this.pluginLoaderService.clearCache(config.pluginKey);
+          this.logger.log(`Cleared plugin cache for new capability: ${config.pluginKey}`);
+        }
+      }
+    } catch (error) {
+      this.logger.error(`Failed to load new capability: ${filePath}`, error);
+    }
   }
+  handleFileChange(filePath) {
+    this.logger.log(`Capability file changed: ${filePath}`);
+    try {
+      this.reloadCapabilityFromFile(filePath);
+    } catch (error) {
+      this.logger.error(`Failed to reload capability: ${filePath}`, error);
+    }
+  }
+  handleFileUnlink(filePath) {
+    this.logger.log(`Capability file removed: ${filePath}`);
+    this.removeCapabilityByFile(filePath);
+  }
+  /**
+  * 从文件加载单个能力配置
+  */
+  loadCapabilityFromFile(filePath) {
+    const content = fs.readFileSync(filePath, "utf-8");
+    const config = JSON.parse(content);
+    if (!config.id) {
+      this.logger.warn(`Skipping capability without id: ${filePath}`);
+      return;
+    }
+    this.capabilities.set(config.id, config);
+    this.filePathToId.set(filePath, config.id);
+    this.logger.log(`Loaded capability: ${config.id} (${config.name})`);
+  }
+  /**
+  * 重新加载单个能力配置
+  */
+  reloadCapabilityFromFile(filePath) {
+    const oldId = this.filePathToId.get(filePath);
+    if (oldId) {
+      const oldConfig = this.capabilities.get(oldId);
+      if (oldConfig) {
+        this.pluginLoaderService.clearCache(oldConfig.pluginKey);
+      }
+      this.capabilities.delete(oldId);
+    }
+    this.loadCapabilityFromFile(filePath);
+  }
+  /**
+  * 根据文件路径移除能力配置
+  */
+  removeCapabilityByFile(filePath) {
+    const capabilityId = this.filePathToId.get(filePath);
+    if (capabilityId) {
+      this.capabilities.delete(capabilityId);
+      this.filePathToId.delete(filePath);
+      this.logger.log(`Removed capability: ${capabilityId}`);
+    }
+  }
+  // ==================== 原有方法 ====================
   async loadCapabilities() {
     this.logger.log(`Loading capabilities from ${this.capabilitiesDir}`);
     if (!fs.existsSync(this.capabilitiesDir)) {
@@ -308,14 +549,7 @@ var CapabilityService = class _CapabilityService {
     for (const file of files) {
       try {
         const filePath = path.join(this.capabilitiesDir, file);
-        const content = fs.readFileSync(filePath, "utf-8");
-        const config = JSON.parse(content);
-        if (!config.id) {
-          this.logger.warn(`Skipping capability without id: ${file}`);
-          continue;
-        }
-        this.capabilities.set(config.id, config);
-        this.logger.log(`Loaded capability: ${config.id} (${config.name})`);
+        this.loadCapabilityFromFile(filePath);
       } catch (error) {
         this.logger.error(`Failed to load capability from ${file}:`, error);
       }
@@ -592,6 +826,7 @@ CapabilityService = _ts_decorate3([
 
 // src/controllers/debug.controller.ts
 var import_common4 = require("@nestjs/common");
+var import_swagger = require("@nestjs/swagger");
 function _ts_decorate4(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -622,19 +857,27 @@ var DebugController = class _DebugController {
     this.pluginLoaderService = pluginLoaderService;
     this.templateEngineService = templateEngineService;
   }
-  list() {
-    const capabilities = this.capabilityService.listCapabilities();
-    return {
-      status_code: ErrorCodes.SUCCESS,
-      data: {
-        capabilities: capabilities.map((c) => ({
-          id: c.id,
-          name: c.name,
-          pluginID: c.pluginKey,
-          pluginVersion: c.pluginVersion
-        }))
-      }
-    };
+  list(res) {
+    try {
+      const capabilities = this.capabilityService.listCapabilities();
+      res.status(import_common4.HttpStatus.OK).json({
+        status_code: ErrorCodes.SUCCESS,
+        data: {
+          capabilities: capabilities.map((c) => ({
+            id: c.id,
+            name: c.name,
+            pluginID: c.pluginKey,
+            pluginVersion: c.pluginVersion
+          }))
+        }
+      });
+    } catch (error) {
+      this.logger.error("Failed to list capabilities", error);
+      res.status(import_common4.HttpStatus.INTERNAL_SERVER_ERROR).json({
+        status_code: ErrorCodes.EXECUTION_ERROR,
+        error_msg: `Failed to list capabilities: ${error instanceof Error ? error.message : String(error)}`
+      });
+    }
   }
   /**
   * 获取 capability 配置
@@ -646,11 +889,7 @@ var DebugController = class _DebugController {
     }
     const config = this.capabilityService.getCapability(capabilityId);
     if (!config) {
-      throw new import_common4.HttpException({
-        code: 1,
-        message: `Capability not found: ${capabilityId}`,
-        error: "CAPABILITY_NOT_FOUND"
-      }, import_common4.HttpStatus.NOT_FOUND);
+      throw new CapabilityNotFoundError(capabilityId);
     }
     return config;
   }
@@ -665,25 +904,21 @@ var DebugController = class _DebugController {
     const pluginInstance = await this.pluginLoaderService.loadPlugin(pluginKey);
     const actions = pluginInstance.listActions();
     if (actions.length === 0) {
-      throw new import_common4.HttpException({
-        code: 1,
-        message: `Plugin ${pluginKey} has no actions`,
-        error: "NO_ACTIONS"
-      }, import_common4.HttpStatus.BAD_REQUEST);
+      throw new Error(`Plugin ${pluginKey} has no actions`);
     }
     return actions[0];
   }
-  async debug(capabilityId, body) {
+  async debug(capabilityId, body, res) {
     const startTime = Date.now();
     const params = body.params ?? {};
-    const config = this.getCapabilityConfig(capabilityId, body.capability);
-    const action = await this.getActionName(config.pluginKey, body.action);
-    const resolvedParams = this.templateEngineService.resolve(config.formValue, params);
     try {
+      const config = this.getCapabilityConfig(capabilityId, body.capability);
+      const action = await this.getActionName(config.pluginKey, body.action);
+      const resolvedParams = this.templateEngineService.resolve(config.formValue, params);
       const result = await this.capabilityService.loadWithConfig(config).call(action, params, {
         isDebug: true
       });
-      return {
+      res.status(import_common4.HttpStatus.OK).json({
         status_code: ErrorCodes.SUCCESS,
         data: {
           output: result,
@@ -695,32 +930,39 @@ var DebugController = class _DebugController {
             action
           }
         }
-      };
+      });
     } catch (error) {
-      if (error instanceof CapabilityNotFoundError) {
-        throw new import_common4.HttpException({
-          status_code: ErrorCodes.CAPABILITY_NOT_FOUND,
-          error_msg: `Capability not found: ${capabilityId}`
-        }, import_common4.HttpStatus.NOT_FOUND);
-      }
-      if (error instanceof PluginNotFoundError) {
-        throw new import_common4.HttpException({
-          status_code: ErrorCodes.PLUGIN_NOT_FOUND,
-          error_msg: `Plugin not found: ${config.pluginKey}`
-        }, import_common4.HttpStatus.INTERNAL_SERVER_ERROR);
-      }
-      if (error instanceof ActionNotFoundError) {
-        throw new import_common4.HttpException({
-          status_code: ErrorCodes.ACTION_NOT_FOUND,
-          error_msg: `Action '${action}' not found in plugin ${config.pluginKey}`
-        }, import_common4.HttpStatus.BAD_REQUEST);
-      }
-      throw new import_common4.HttpException({
-        status_code: ErrorCodes.EXECUTION_ERROR,
-        error_msg: `Execution failed: ${error instanceof Error ? error.message : String(error)}`
-      }, import_common4.HttpStatus.INTERNAL_SERVER_ERROR);
+      this.logger.error("Debug execution failed", error);
+      res.status(import_common4.HttpStatus.INTERNAL_SERVER_ERROR).json(this.buildErrorResponse(error));
     }
   }
+  /**
+  * 构建错误响应
+  */
+  buildErrorResponse(error) {
+    if (error instanceof CapabilityNotFoundError) {
+      return {
+        status_code: ErrorCodes.CAPABILITY_NOT_FOUND,
+        error_msg: `Capability not found: ${error.capabilityId}`
+      };
+    }
+    if (error instanceof PluginNotFoundError) {
+      return {
+        status_code: ErrorCodes.PLUGIN_NOT_FOUND,
+        error_msg: `Plugin not found, please install plugin: ${error.pluginKey}`
+      };
+    }
+    if (error instanceof ActionNotFoundError) {
+      return {
+        status_code: ErrorCodes.ACTION_NOT_FOUND,
+        error_msg: `Action '${error.actionName}' not found in plugin ${error.pluginKey}`
+      };
+    }
+    return {
+      status_code: ErrorCodes.EXECUTION_ERROR,
+      error_msg: `Execution failed: ${error instanceof Error ? error.message : String(error)}`
+    };
+  }
   async debugStream(capabilityId, body, res) {
     const params = body.params ?? {};
     res.setHeader("Content-Type", "text/event-stream");
@@ -751,9 +993,7 @@ var DebugController = class _DebugController {
                 status_code: ErrorCodes.SUCCESS,
                 data: {
                   type: "content",
-                  delta: {
-                    content: pendingChunk
-                  }
+                  delta: pendingChunk
                 }
               };
               res.write(`data: ${JSON.stringify(response)}
@@ -769,9 +1009,7 @@ var DebugController = class _DebugController {
                 status_code: ErrorCodes.SUCCESS,
                 data: {
                   type: "content",
-                  delta: {
-                    content: pendingChunk
-                  },
+                  delta: pendingChunk,
                   finished: true
                 }
               };
@@ -811,9 +1049,7 @@ var DebugController = class _DebugController {
           status_code: ErrorCodes.SUCCESS,
           data: {
             type: "content",
-            delta: {
-              content: pendingChunk
-            },
+            delta: pendingChunk,
             finished: true
           }
         };
@@ -843,18 +1079,23 @@ var DebugController = class _DebugController {
 };
 _ts_decorate4([
   (0, import_common4.Get)("list"),
+  _ts_param2(0, (0, import_common4.Res)()),
   _ts_metadata2("design:type", Function),
-  _ts_metadata2("design:paramtypes", []),
-  _ts_metadata2("design:returntype", typeof SuccessResponse === "undefined" ? Object : SuccessResponse)
+  _ts_metadata2("design:paramtypes", [
+    typeof Response === "undefined" ? Object : Response
+  ]),
+  _ts_metadata2("design:returntype", void 0)
 ], DebugController.prototype, "list", null);
 _ts_decorate4([
   (0, import_common4.Post)("debug/:capability_id"),
   _ts_param2(0, (0, import_common4.Param)("capability_id")),
   _ts_param2(1, (0, import_common4.Body)()),
+  _ts_param2(2, (0, import_common4.Res)()),
   _ts_metadata2("design:type", Function),
   _ts_metadata2("design:paramtypes", [
     String,
-    typeof DebugRequestBody === "undefined" ? Object : DebugRequestBody
+    typeof DebugRequestBody === "undefined" ? Object : DebugRequestBody,
+    typeof Response === "undefined" ? Object : Response
   ]),
   _ts_metadata2("design:returntype", Promise)
 ], DebugController.prototype, "debug", null);
@@ -872,6 +1113,7 @@ _ts_decorate4([
   _ts_metadata2("design:returntype", Promise)
 ], DebugController.prototype, "debugStream", null);
 DebugController = _ts_decorate4([
+  (0, import_swagger.ApiExcludeController)(),
   (0, import_common4.Controller)("__innerapi__/capability"),
   _ts_metadata2("design:type", Function),
   _ts_metadata2("design:paramtypes", [
@@ -883,6 +1125,7 @@ DebugController = _ts_decorate4([
 
 // src/controllers/webhook.controller.ts
 var import_common5 = require("@nestjs/common");
+var import_swagger2 = require("@nestjs/swagger");
 function _ts_decorate5(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -909,54 +1152,69 @@ var WebhookController = class _WebhookController {
   constructor(capabilityService) {
     this.capabilityService = capabilityService;
   }
-  list() {
-    const capabilities = this.capabilityService.listCapabilities();
-    return {
-      status_code: ErrorCodes.SUCCESS,
-      data: {
-        capabilities: capabilities.map((c) => ({
-          id: c.id,
-          name: c.name,
-          pluginID: c.pluginKey,
-          pluginVersion: c.pluginVersion
-        }))
-      }
-    };
+  list(res) {
+    try {
+      const capabilities = this.capabilityService.listCapabilities();
+      res.status(import_common5.HttpStatus.OK).json({
+        status_code: ErrorCodes.SUCCESS,
+        data: {
+          capabilities: capabilities.map((c) => ({
+            id: c.id,
+            name: c.name,
+            pluginID: c.pluginKey,
+            pluginVersion: c.pluginVersion
+          }))
+        }
+      });
+    } catch (error) {
+      this.logger.error("Failed to list capabilities", error);
+      res.status(import_common5.HttpStatus.INTERNAL_SERVER_ERROR).json({
+        status_code: ErrorCodes.EXECUTION_ERROR,
+        error_msg: `Failed to list capabilities: ${error instanceof Error ? error.message : String(error)}`
+      });
+    }
   }
-  async execute(capabilityId, body) {
+  async execute(capabilityId, body, res) {
     try {
       const result = await this.capabilityService.load(capabilityId).call(body.action, body.params);
-      return {
+      res.status(import_common5.HttpStatus.OK).json({
         status_code: ErrorCodes.SUCCESS,
         data: {
           output: result
         }
-      };
+      });
     } catch (error) {
-      if (error instanceof CapabilityNotFoundError) {
-        throw new import_common5.HttpException({
-          status_code: ErrorCodes.CAPABILITY_NOT_FOUND,
-          error_msg: `Capability not found: ${capabilityId}`
-        }, import_common5.HttpStatus.NOT_FOUND);
-      }
-      if (error instanceof PluginNotFoundError) {
-        throw new import_common5.HttpException({
-          status_code: ErrorCodes.PLUGIN_NOT_FOUND,
-          error_msg: `Plugin not found`
-        }, import_common5.HttpStatus.INTERNAL_SERVER_ERROR);
-      }
-      if (error instanceof ActionNotFoundError) {
-        throw new import_common5.HttpException({
-          status_code: ErrorCodes.ACTION_NOT_FOUND,
-          error_msg: `Action '${body.action}' not found`
-        }, import_common5.HttpStatus.BAD_REQUEST);
-      }
-      throw new import_common5.HttpException({
-        status_code: ErrorCodes.EXECUTION_ERROR,
-        error_msg: `Execution failed: ${error instanceof Error ? error.message : String(error)}`
-      }, import_common5.HttpStatus.INTERNAL_SERVER_ERROR);
+      this.logger.error("Capability execution failed", error);
+      res.status(import_common5.HttpStatus.INTERNAL_SERVER_ERROR).json(this.buildErrorResponse(error));
     }
   }
+  /**
+  * 构建错误响应
+  */
+  buildErrorResponse(error) {
+    if (error instanceof CapabilityNotFoundError) {
+      return {
+        status_code: ErrorCodes.CAPABILITY_NOT_FOUND,
+        error_msg: `Capability not found: ${error.capabilityId}`
+      };
+    }
+    if (error instanceof PluginNotFoundError) {
+      return {
+        status_code: ErrorCodes.PLUGIN_NOT_FOUND,
+        error_msg: `Plugin not found, please install plugin: ${error.pluginKey}`
+      };
+    }
+    if (error instanceof ActionNotFoundError) {
+      return {
+        status_code: ErrorCodes.ACTION_NOT_FOUND,
+        error_msg: `Action '${error.actionName}' not found in plugin ${error.pluginKey}`
+      };
+    }
+    return {
+      status_code: ErrorCodes.EXECUTION_ERROR,
+      error_msg: `Execution failed: ${error instanceof Error ? error.message : String(error)}`
+    };
+  }
   async executeStream(capabilityId, body, res) {
     const loggerContext = {
       capability_id: capabilityId,
@@ -981,9 +1239,7 @@ var WebhookController = class _WebhookController {
                 status_code: ErrorCodes.SUCCESS,
                 data: {
                   type: "content",
-                  delta: {
-                    content: pendingChunk
-                  }
+                  delta: pendingChunk
                 }
               };
               res.write(`data: ${JSON.stringify(response)}
@@ -999,9 +1255,7 @@ var WebhookController = class _WebhookController {
                 status_code: ErrorCodes.SUCCESS,
                 data: {
                   type: "content",
-                  delta: {
-                    content: pendingChunk
-                  },
+                  delta: pendingChunk,
                   finished: true
                 }
               };
@@ -1041,9 +1295,7 @@ var WebhookController = class _WebhookController {
           status_code: ErrorCodes.SUCCESS,
           data: {
             type: "content",
-            delta: {
-              content: pendingChunk
-            },
+            delta: pendingChunk,
             finished: true
           }
         };
@@ -1073,18 +1325,23 @@ var WebhookController = class _WebhookController {
 };
 _ts_decorate5([
   (0, import_common5.Get)("list"),
+  _ts_param3(0, (0, import_common5.Res)()),
   _ts_metadata3("design:type", Function),
-  _ts_metadata3("design:paramtypes", []),
-  _ts_metadata3("design:returntype", typeof SuccessResponse === "undefined" ? Object : SuccessResponse)
+  _ts_metadata3("design:paramtypes", [
+    typeof Response === "undefined" ? Object : Response
+  ]),
+  _ts_metadata3("design:returntype", void 0)
 ], WebhookController.prototype, "list", null);
 _ts_decorate5([
   (0, import_common5.Post)(":capability_id"),
   _ts_param3(0, (0, import_common5.Param)("capability_id")),
   _ts_param3(1, (0, import_common5.Body)()),
+  _ts_param3(2, (0, import_common5.Res)()),
   _ts_metadata3("design:type", Function),
   _ts_metadata3("design:paramtypes", [
     String,
-    typeof ExecuteRequestBody === "undefined" ? Object : ExecuteRequestBody
+    typeof ExecuteRequestBody === "undefined" ? Object : ExecuteRequestBody,
+    typeof Response === "undefined" ? Object : Response
   ]),
   _ts_metadata3("design:returntype", Promise)
 ], WebhookController.prototype, "execute", null);
@@ -1102,6 +1359,7 @@ _ts_decorate5([
   _ts_metadata3("design:returntype", Promise)
 ], WebhookController.prototype, "executeStream", null);
 WebhookController = _ts_decorate5([
+  (0, import_swagger2.ApiExcludeController)(),
   (0, import_common5.Controller)("api/capability"),
   _ts_metadata3("design:type", Function),
   _ts_metadata3("design:paramtypes", [
@@ -1151,8 +1409,8 @@ var CapabilityModule = class _CapabilityModule {
           provide: CapabilityService,
           useFactory: /* @__PURE__ */ __name((requestContextService, httpClient, pluginLoader, templateEngine, moduleOptions) => {
             const service = new CapabilityService(requestContextService, httpClient, pluginLoader, templateEngine);
-            if (moduleOptions?.capabilitiesDir) {
-              service.setCapabilitiesDir(moduleOptions.capabilitiesDir);
+            if (moduleOptions) {
+              service.setOptions(moduleOptions);
             }
             return service;
           }, "useFactory"),
@@ -1201,6 +1459,7 @@ CapabilityModule = _ts_decorate6([
   PluginLoaderService,
   PluginNotFoundError,
   TemplateEngineService,
-  WebhookController
+  WebhookController,
+  migrationAdaptor
 });
 //# sourceMappingURL=index.cjs.map