@dudousxd/nestjs-agent 0.3.1 → 0.3.2

package/dist/index.cjs

@@ -49,8 +49,8 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/agent.module.ts
-var import_nestjs_agent_core12 = require("@dudousxd/nestjs-agent-core");
-var import_common10 = require("@nestjs/common");
+var import_nestjs_agent_core13 = require("@dudousxd/nestjs-agent-core");
+var import_common11 = require("@nestjs/common");
 var import_core3 = require("@nestjs/core");
 
 // src/agent-deps.factory.ts
@@ -434,7 +434,7 @@ AgentService = _ts_decorate2([
   ])
 ], AgentService);
 
-// src/controller/chat.controller.ts
+// src/controller/agents.controller.ts
 var import_nestjs_agent_core4 = require("@dudousxd/nestjs-agent-core");
 var import_common3 = require("@nestjs/common");
 function _ts_decorate3(decorators, target, key, desc) {
@@ -454,6 +454,64 @@ function _ts_param3(paramIndex, decorator) {
   };
 }
 __name(_ts_param3, "_ts_param");
+var AgentsController = class {
+  static {
+    __name(this, "AgentsController");
+  }
+  agents;
+  depsFactory;
+  constructor(agents, depsFactory) {
+    this.agents = agents;
+    this.depsFactory = depsFactory;
+  }
+  list() {
+    const defaultAgentName = this.depsFactory.defaultAgentName();
+    return this.agents.list().map((definition) => ({
+      name: definition.name,
+      description: definition.description ?? "",
+      ...definition.name === defaultAgentName ? {
+        isDefault: true
+      } : {}
+    }));
+  }
+};
+_ts_decorate3([
+  (0, import_common3.Get)(),
+  _ts_metadata3("design:type", Function),
+  _ts_metadata3("design:paramtypes", []),
+  _ts_metadata3("design:returntype", Array)
+], AgentsController.prototype, "list", null);
+AgentsController = _ts_decorate3([
+  (0, import_common3.Controller)("agents"),
+  _ts_param3(0, (0, import_common3.Inject)(import_nestjs_agent_core4.AGENT_REGISTRY)),
+  _ts_param3(1, (0, import_common3.Inject)(import_nestjs_agent_core4.AGENT_DEPS_FACTORY)),
+  _ts_metadata3("design:type", Function),
+  _ts_metadata3("design:paramtypes", [
+    typeof import_nestjs_agent_core4.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core4.AgentRegistry,
+    typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory
+  ])
+], AgentsController);
+
+// src/controller/chat.controller.ts
+var import_nestjs_agent_core5 = require("@dudousxd/nestjs-agent-core");
+var import_common4 = require("@nestjs/common");
+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);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate4, "_ts_decorate");
+function _ts_metadata4(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata4, "_ts_metadata");
+function _ts_param4(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param4, "_ts_param");
 var ChatController = class {
   static {
     __name(this, "ChatController");
@@ -523,7 +581,7 @@ data: ${JSON.stringify({
       }
       res.write("event: done\ndata: {}\n\n");
     } catch (error) {
-      const payload = error instanceof import_nestjs_agent_core4.AgentStreamError ? {
+      const payload = error instanceof import_nestjs_agent_core5.AgentStreamError ? {
         code: error.code,
         message: error.message
       } : {
@@ -538,71 +596,71 @@ data: ${JSON.stringify(payload)}
     res.end();
   }
 };
-_ts_decorate3([
-  (0, import_common3.Post)("chat"),
-  _ts_param3(0, (0, import_common3.Req)()),
-  _ts_param3(1, (0, import_common3.Res)()),
-  _ts_param3(2, (0, import_common3.Body)()),
-  _ts_metadata3("design:type", Function),
-  _ts_metadata3("design:paramtypes", [
+_ts_decorate4([
+  (0, import_common4.Post)("chat"),
+  _ts_param4(0, (0, import_common4.Req)()),
+  _ts_param4(1, (0, import_common4.Res)()),
+  _ts_param4(2, (0, import_common4.Body)()),
+  _ts_metadata4("design:type", Function),
+  _ts_metadata4("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof Response === "undefined" ? Object : Response,
     typeof ChatBody === "undefined" ? Object : ChatBody
   ]),
-  _ts_metadata3("design:returntype", Promise)
+  _ts_metadata4("design:returntype", Promise)
 ], ChatController.prototype, "chat", null);
-_ts_decorate3([
-  (0, import_common3.Get)("chat/:runId/stream"),
-  _ts_param3(0, (0, import_common3.Param)("runId")),
-  _ts_param3(1, (0, import_common3.Res)()),
-  _ts_metadata3("design:type", Function),
-  _ts_metadata3("design:paramtypes", [
+_ts_decorate4([
+  (0, import_common4.Get)("chat/:runId/stream"),
+  _ts_param4(0, (0, import_common4.Param)("runId")),
+  _ts_param4(1, (0, import_common4.Res)()),
+  _ts_metadata4("design:type", Function),
+  _ts_metadata4("design:paramtypes", [
     String,
     typeof Response === "undefined" ? Object : Response
   ]),
-  _ts_metadata3("design:returntype", Promise)
+  _ts_metadata4("design:returntype", Promise)
 ], ChatController.prototype, "stream", null);
-_ts_decorate3([
-  (0, import_common3.Post)("chat/:runId/cancel"),
-  _ts_param3(0, (0, import_common3.Req)()),
-  _ts_param3(1, (0, import_common3.Param)("runId")),
-  _ts_metadata3("design:type", Function),
-  _ts_metadata3("design:paramtypes", [
+_ts_decorate4([
+  (0, import_common4.Post)("chat/:runId/cancel"),
+  _ts_param4(0, (0, import_common4.Req)()),
+  _ts_param4(1, (0, import_common4.Param)("runId")),
+  _ts_metadata4("design:type", Function),
+  _ts_metadata4("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata3("design:returntype", Promise)
+  _ts_metadata4("design:returntype", Promise)
 ], ChatController.prototype, "cancel", null);
-ChatController = _ts_decorate3([
-  (0, import_common3.Controller)(),
-  _ts_param3(1, (0, import_common3.Inject)(import_nestjs_agent_core4.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata3("design:type", Function),
-  _ts_metadata3("design:paramtypes", [
+ChatController = _ts_decorate4([
+  (0, import_common4.Controller)(),
+  _ts_param4(1, (0, import_common4.Inject)(import_nestjs_agent_core5.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata4("design:type", Function),
+  _ts_metadata4("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ChatController);
 
 // src/controller/quota.controller.ts
-var import_nestjs_agent_core5 = require("@dudousxd/nestjs-agent-core");
-var import_common4 = require("@nestjs/common");
-function _ts_decorate4(decorators, target, key, desc) {
+var import_nestjs_agent_core6 = require("@dudousxd/nestjs-agent-core");
+var import_common5 = require("@nestjs/common");
+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);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate4, "_ts_decorate");
-function _ts_metadata4(k, v) {
+__name(_ts_decorate5, "_ts_decorate");
+function _ts_metadata5(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata4, "_ts_metadata");
-function _ts_param4(paramIndex, decorator) {
+__name(_ts_metadata5, "_ts_metadata");
+function _ts_param5(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param4, "_ts_param");
+__name(_ts_param5, "_ts_param");
 var QuotaController = class {
   static {
     __name(this, "QuotaController");
@@ -618,45 +676,45 @@ var QuotaController = class {
     return this.agent.quotaToday(actor.id);
   }
 };
-_ts_decorate4([
-  (0, import_common4.Get)("today"),
-  _ts_param4(0, (0, import_common4.Req)()),
-  _ts_metadata4("design:type", Function),
-  _ts_metadata4("design:paramtypes", [
+_ts_decorate5([
+  (0, import_common5.Get)("today"),
+  _ts_param5(0, (0, import_common5.Req)()),
+  _ts_metadata5("design:type", Function),
+  _ts_metadata5("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata4("design:returntype", Promise)
+  _ts_metadata5("design:returntype", Promise)
 ], QuotaController.prototype, "today", null);
-QuotaController = _ts_decorate4([
-  (0, import_common4.Controller)("quota"),
-  _ts_param4(1, (0, import_common4.Inject)(import_nestjs_agent_core5.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata4("design:type", Function),
-  _ts_metadata4("design:paramtypes", [
+QuotaController = _ts_decorate5([
+  (0, import_common5.Controller)("quota"),
+  _ts_param5(1, (0, import_common5.Inject)(import_nestjs_agent_core6.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata5("design:type", Function),
+  _ts_metadata5("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], QuotaController);
 
 // src/controller/threads.controller.ts
-var import_nestjs_agent_core6 = require("@dudousxd/nestjs-agent-core");
-var import_common5 = require("@nestjs/common");
-function _ts_decorate5(decorators, target, key, desc) {
+var import_nestjs_agent_core7 = require("@dudousxd/nestjs-agent-core");
+var import_common6 = require("@nestjs/common");
+function _ts_decorate6(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);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate5, "_ts_decorate");
-function _ts_metadata5(k, v) {
+__name(_ts_decorate6, "_ts_decorate");
+function _ts_metadata6(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata5, "_ts_metadata");
-function _ts_param5(paramIndex, decorator) {
+__name(_ts_metadata6, "_ts_metadata");
+function _ts_param6(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param5, "_ts_param");
+__name(_ts_param6, "_ts_param");
 var ThreadsController = class {
   static {
     __name(this, "ThreadsController");
@@ -708,117 +766,117 @@ var ThreadsController = class {
     };
   }
 };
-_ts_decorate5([
-  (0, import_common5.Get)(),
-  _ts_param5(0, (0, import_common5.Req)()),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+_ts_decorate6([
+  (0, import_common6.Get)(),
+  _ts_param6(0, (0, import_common6.Req)()),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata5("design:returntype", Promise)
+  _ts_metadata6("design:returntype", Promise)
 ], ThreadsController.prototype, "list", null);
-_ts_decorate5([
-  (0, import_common5.Get)(":id"),
-  _ts_param5(0, (0, import_common5.Req)()),
-  _ts_param5(1, (0, import_common5.Param)("id")),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+_ts_decorate6([
+  (0, import_common6.Get)(":id"),
+  _ts_param6(0, (0, import_common6.Req)()),
+  _ts_param6(1, (0, import_common6.Param)("id")),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata5("design:returntype", Promise)
+  _ts_metadata6("design:returntype", Promise)
 ], ThreadsController.prototype, "detail", null);
-_ts_decorate5([
-  (0, import_common5.Delete)(":id"),
-  _ts_param5(0, (0, import_common5.Req)()),
-  _ts_param5(1, (0, import_common5.Param)("id")),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+_ts_decorate6([
+  (0, import_common6.Delete)(":id"),
+  _ts_param6(0, (0, import_common6.Req)()),
+  _ts_param6(1, (0, import_common6.Param)("id")),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata5("design:returntype", Promise)
+  _ts_metadata6("design:returntype", Promise)
 ], ThreadsController.prototype, "remove", null);
-_ts_decorate5([
-  (0, import_common5.Post)(":id/fork-from/:messageId"),
-  _ts_param5(0, (0, import_common5.Req)()),
-  _ts_param5(1, (0, import_common5.Param)("id")),
-  _ts_param5(2, (0, import_common5.Param)("messageId")),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+_ts_decorate6([
+  (0, import_common6.Post)(":id/fork-from/:messageId"),
+  _ts_param6(0, (0, import_common6.Req)()),
+  _ts_param6(1, (0, import_common6.Param)("id")),
+  _ts_param6(2, (0, import_common6.Param)("messageId")),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     String
   ]),
-  _ts_metadata5("design:returntype", Promise)
+  _ts_metadata6("design:returntype", Promise)
 ], ThreadsController.prototype, "fork", null);
-_ts_decorate5([
-  (0, import_common5.Patch)(":id"),
-  _ts_param5(0, (0, import_common5.Req)()),
-  _ts_param5(1, (0, import_common5.Param)("id")),
-  _ts_param5(2, (0, import_common5.Body)()),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+_ts_decorate6([
+  (0, import_common6.Patch)(":id"),
+  _ts_param6(0, (0, import_common6.Req)()),
+  _ts_param6(1, (0, import_common6.Param)("id")),
+  _ts_param6(2, (0, import_common6.Body)()),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     typeof RenameThreadBody === "undefined" ? Object : RenameThreadBody
   ]),
-  _ts_metadata5("design:returntype", Promise)
+  _ts_metadata6("design:returntype", Promise)
 ], ThreadsController.prototype, "rename", null);
-_ts_decorate5([
-  (0, import_common5.Post)(":id/promote"),
-  _ts_param5(0, (0, import_common5.Req)()),
-  _ts_param5(1, (0, import_common5.Param)("id")),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+_ts_decorate6([
+  (0, import_common6.Post)(":id/promote"),
+  _ts_param6(0, (0, import_common6.Req)()),
+  _ts_param6(1, (0, import_common6.Param)("id")),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata5("design:returntype", Promise)
+  _ts_metadata6("design:returntype", Promise)
 ], ThreadsController.prototype, "promote", null);
-_ts_decorate5([
-  (0, import_common5.Delete)(":id/from/:messageId"),
-  _ts_param5(0, (0, import_common5.Req)()),
-  _ts_param5(1, (0, import_common5.Param)("id")),
-  _ts_param5(2, (0, import_common5.Param)("messageId")),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+_ts_decorate6([
+  (0, import_common6.Delete)(":id/from/:messageId"),
+  _ts_param6(0, (0, import_common6.Req)()),
+  _ts_param6(1, (0, import_common6.Param)("id")),
+  _ts_param6(2, (0, import_common6.Param)("messageId")),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     String
   ]),
-  _ts_metadata5("design:returntype", Promise)
+  _ts_metadata6("design:returntype", Promise)
 ], ThreadsController.prototype, "truncateFrom", null);
-ThreadsController = _ts_decorate5([
-  (0, import_common5.Controller)("threads"),
-  _ts_param5(1, (0, import_common5.Inject)(import_nestjs_agent_core6.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+ThreadsController = _ts_decorate6([
+  (0, import_common6.Controller)("threads"),
+  _ts_param6(1, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ThreadsController);
 
 // src/controller/tool-call.controller.ts
-var import_nestjs_agent_core7 = require("@dudousxd/nestjs-agent-core");
-var import_common6 = require("@nestjs/common");
-function _ts_decorate6(decorators, target, key, desc) {
+var import_nestjs_agent_core8 = require("@dudousxd/nestjs-agent-core");
+var import_common7 = require("@nestjs/common");
+function _ts_decorate7(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);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate6, "_ts_decorate");
-function _ts_metadata6(k, v) {
+__name(_ts_decorate7, "_ts_decorate");
+function _ts_metadata7(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata6, "_ts_metadata");
-function _ts_param6(paramIndex, decorator) {
+__name(_ts_metadata7, "_ts_metadata");
+function _ts_param7(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param6, "_ts_param");
+__name(_ts_param7, "_ts_param");
 var ToolCallController = class {
   static {
     __name(this, "ToolCallController");
@@ -844,41 +902,41 @@ var ToolCallController = class {
     };
   }
 };
-_ts_decorate6([
-  (0, import_common6.Post)("approve"),
-  _ts_param6(0, (0, import_common6.Req)()),
-  _ts_param6(1, (0, import_common6.Body)()),
-  _ts_metadata6("design:type", Function),
-  _ts_metadata6("design:paramtypes", [
+_ts_decorate7([
+  (0, import_common7.Post)("approve"),
+  _ts_param7(0, (0, import_common7.Req)()),
+  _ts_param7(1, (0, import_common7.Body)()),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof ApproveBody === "undefined" ? Object : ApproveBody
   ]),
-  _ts_metadata6("design:returntype", Promise)
+  _ts_metadata7("design:returntype", Promise)
 ], ToolCallController.prototype, "approve", null);
-_ts_decorate6([
-  (0, import_common6.Post)("reject"),
-  _ts_param6(0, (0, import_common6.Req)()),
-  _ts_param6(1, (0, import_common6.Body)()),
-  _ts_metadata6("design:type", Function),
-  _ts_metadata6("design:paramtypes", [
+_ts_decorate7([
+  (0, import_common7.Post)("reject"),
+  _ts_param7(0, (0, import_common7.Req)()),
+  _ts_param7(1, (0, import_common7.Body)()),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof RejectBody === "undefined" ? Object : RejectBody
   ]),
-  _ts_metadata6("design:returntype", Promise)
+  _ts_metadata7("design:returntype", Promise)
 ], ToolCallController.prototype, "reject", null);
-ToolCallController = _ts_decorate6([
-  (0, import_common6.Controller)("tool-call"),
-  _ts_param6(1, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata6("design:type", Function),
-  _ts_metadata6("design:paramtypes", [
+ToolCallController = _ts_decorate7([
+  (0, import_common7.Controller)("tool-call"),
+  _ts_param7(1, (0, import_common7.Inject)(import_nestjs_agent_core8.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ToolCallController);
 
 // src/discovery/agent-discovery.service.ts
-var import_nestjs_agent_core8 = require("@dudousxd/nestjs-agent-core");
-var import_common7 = require("@nestjs/common");
+var import_nestjs_agent_core9 = require("@dudousxd/nestjs-agent-core");
+var import_common8 = require("@nestjs/common");
 var import_core = require("@nestjs/core");
 
 // src/decorator/agent.decorator.ts
@@ -913,23 +971,23 @@ function SystemPromptContributor() {
 __name(SystemPromptContributor, "SystemPromptContributor");
 
 // src/discovery/agent-discovery.service.ts
-function _ts_decorate7(decorators, target, key, desc) {
+function _ts_decorate8(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);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate7, "_ts_decorate");
-function _ts_metadata7(k, v) {
+__name(_ts_decorate8, "_ts_decorate");
+function _ts_metadata8(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata7, "_ts_metadata");
-function _ts_param7(paramIndex, decorator) {
+__name(_ts_metadata8, "_ts_metadata");
+function _ts_param8(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param7, "_ts_param");
+__name(_ts_param8, "_ts_param");
 var AgentDiscoveryService = class _AgentDiscoveryService {
   static {
     __name(this, "AgentDiscoveryService");
@@ -938,7 +996,7 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
   scanner;
   registry;
   contributors;
-  logger = new import_common7.Logger(_AgentDiscoveryService.name);
+  logger = new import_common8.Logger(_AgentDiscoveryService.name);
   constructor(discovery, scanner, registry, contributors) {
     this.discovery = discovery;
     this.scanner = scanner;
@@ -964,6 +1022,9 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
     const systemPrompt = promptMethod !== void 0 ? (ctx) => promptMethod(ctx) : meta.systemPrompt ?? "You are a helpful assistant.";
     return {
       name: meta.name,
+      ...meta.description !== void 0 ? {
+        description: meta.description
+      } : {},
       systemPrompt,
       ...meta.tools !== void 0 ? {
         tools: meta.tools
@@ -1023,22 +1084,22 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
     return (ctx) => candidate.call(instance, ctx);
   }
 };
-AgentDiscoveryService = _ts_decorate7([
-  (0, import_common7.Injectable)(),
-  _ts_param7(2, (0, import_common7.Inject)(import_nestjs_agent_core8.AGENT_REGISTRY)),
-  _ts_param7(3, (0, import_common7.Inject)(import_nestjs_agent_core8.AGENT_PROMPT_CONTRIBUTORS)),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
+AgentDiscoveryService = _ts_decorate8([
+  (0, import_common8.Injectable)(),
+  _ts_param8(2, (0, import_common8.Inject)(import_nestjs_agent_core9.AGENT_REGISTRY)),
+  _ts_param8(3, (0, import_common8.Inject)(import_nestjs_agent_core9.AGENT_PROMPT_CONTRIBUTORS)),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", [
     typeof import_core.DiscoveryService === "undefined" ? Object : import_core.DiscoveryService,
     typeof import_core.MetadataScanner === "undefined" ? Object : import_core.MetadataScanner,
-    typeof import_nestjs_agent_core8.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core8.AgentRegistry,
+    typeof import_nestjs_agent_core9.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core9.AgentRegistry,
     Array
   ])
 ], AgentDiscoveryService);
 
 // src/discovery/ai-tool-discovery.service.ts
-var import_nestjs_agent_core9 = require("@dudousxd/nestjs-agent-core");
-var import_common8 = require("@nestjs/common");
+var import_nestjs_agent_core10 = require("@dudousxd/nestjs-agent-core");
+var import_common9 = require("@nestjs/common");
 var import_core2 = require("@nestjs/core");
 var import_zod = require("zod");
 
@@ -1087,23 +1148,23 @@ function provideAgentTool(factoryOrTool, inject) {
 __name(provideAgentTool, "provideAgentTool");
 
 // src/discovery/ai-tool-discovery.service.ts
-function _ts_decorate8(decorators, target, key, desc) {
+function _ts_decorate9(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);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate8, "_ts_decorate");
-function _ts_metadata8(k, v) {
+__name(_ts_decorate9, "_ts_decorate");
+function _ts_metadata9(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata8, "_ts_metadata");
-function _ts_param8(paramIndex, decorator) {
+__name(_ts_metadata9, "_ts_metadata");
+function _ts_param9(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param8, "_ts_param");
+__name(_ts_param9, "_ts_param");
 var AiToolDiscoveryService = class _AiToolDiscoveryService {
   static {
     __name(this, "AiToolDiscoveryService");
@@ -1112,7 +1173,7 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
   registry;
   agents;
   options;
-  logger = new import_common8.Logger(_AiToolDiscoveryService.name);
+  logger = new import_common9.Logger(_AiToolDiscoveryService.name);
   constructor(discovery, registry, agents, options) {
     this.discovery = discovery;
     this.registry = registry;
@@ -1210,13 +1271,13 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
     return true;
   }
 };
-AiToolDiscoveryService = _ts_decorate8([
-  (0, import_common8.Injectable)(),
-  _ts_param8(1, (0, import_common8.Inject)(import_nestjs_agent_core9.AGENT_TOOL_REGISTRY)),
-  _ts_param8(2, (0, import_common8.Inject)(import_nestjs_agent_core9.AGENT_REGISTRY)),
-  _ts_param8(3, (0, import_common8.Inject)(import_nestjs_agent_core9.AGENT_OPTIONS)),
-  _ts_metadata8("design:type", Function),
-  _ts_metadata8("design:paramtypes", [
+AiToolDiscoveryService = _ts_decorate9([
+  (0, import_common9.Injectable)(),
+  _ts_param9(1, (0, import_common9.Inject)(import_nestjs_agent_core10.AGENT_TOOL_REGISTRY)),
+  _ts_param9(2, (0, import_common9.Inject)(import_nestjs_agent_core10.AGENT_REGISTRY)),
+  _ts_param9(3, (0, import_common9.Inject)(import_nestjs_agent_core10.AGENT_OPTIONS)),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", [
     typeof import_core2.DiscoveryService === "undefined" ? Object : import_core2.DiscoveryService,
     typeof ToolRegistry === "undefined" ? Object : ToolRegistry,
     typeof AgentRegistry === "undefined" ? Object : AgentRegistry,
@@ -1225,7 +1286,7 @@ AiToolDiscoveryService = _ts_decorate8([
 ], AiToolDiscoveryService);
 
 // src/in-process-sink.ts
-var import_nestjs_agent_core10 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core11 = require("@dudousxd/nestjs-agent-core");
 var InProcessTokenStreamSink = class {
   static {
     __name(this, "InProcessTokenStreamSink");
@@ -1280,7 +1341,7 @@ var InProcessTokenStreamSink = class {
       }
       if (buf.ended) {
         if (buf.failure !== void 0) {
-          throw new import_nestjs_agent_core10.AgentStreamError(buf.failure);
+          throw new import_nestjs_agent_core11.AgentStreamError(buf.failure);
         }
         return;
       }
@@ -1316,32 +1377,32 @@ var LedgerQuotaStore = class {
 };
 
 // src/runner/inline-agent-runner.ts
-var import_nestjs_agent_core11 = require("@dudousxd/nestjs-agent-core");
-var import_common9 = require("@nestjs/common");
-function _ts_decorate9(decorators, target, key, desc) {
+var import_nestjs_agent_core12 = require("@dudousxd/nestjs-agent-core");
+var import_common10 = require("@nestjs/common");
+function _ts_decorate10(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);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate9, "_ts_decorate");
-function _ts_metadata9(k, v) {
+__name(_ts_decorate10, "_ts_decorate");
+function _ts_metadata10(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata9, "_ts_metadata");
-function _ts_param9(paramIndex, decorator) {
+__name(_ts_metadata10, "_ts_metadata");
+function _ts_param10(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param9, "_ts_param");
+__name(_ts_param10, "_ts_param");
 var InlineAgentRunner = class _InlineAgentRunner {
   static {
     __name(this, "InlineAgentRunner");
   }
   factory;
   store;
-  logger = new import_common9.Logger(_InlineAgentRunner.name);
+  logger = new import_common10.Logger(_InlineAgentRunner.name);
   pending = /* @__PURE__ */ new Map();
   constructor(factory, store) {
     this.factory = factory;
@@ -1352,14 +1413,14 @@ var InlineAgentRunner = class _InlineAgentRunner {
     const day = input.day ?? utcDay();
     const deps = this.factory.forAgent(input.agentName);
     const hooks = this.topLevelHooks(runId, deps, input.actor, day);
-    void (0, import_nestjs_agent_core11.runAgentLoop)({
+    void (0, import_nestjs_agent_core12.runAgentLoop)({
       ...deps,
       day
     }, input, hooks).catch(async (error) => {
       const message = error instanceof Error ? error.message : String(error);
-      const code = error instanceof import_nestjs_agent_core11.QuotaExceededError ? "quota_exceeded" : "run_failed";
+      const code = error instanceof import_nestjs_agent_core12.QuotaExceededError ? "quota_exceeded" : "run_failed";
       this.logger.error(`agent run ${runId} failed (${code}): ${message}`);
-      (0, import_nestjs_agent_core11.publishAgentRunFailed)({
+      (0, import_nestjs_agent_core12.publishAgentRunFailed)({
         runId,
         code,
         message
@@ -1421,7 +1482,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
       step: /* @__PURE__ */ __name((_name, fn) => fn(), "step"),
       runAgent: /* @__PURE__ */ __name((childName, childTask) => this.runNested(childName, childTask, actor, day, depth + 1, sinkRunId), "runAgent")
     };
-    return (0, import_nestjs_agent_core11.runAgentLoop)({
+    return (0, import_nestjs_agent_core12.runAgentLoop)({
       ...deps,
       day
     }, {
@@ -1435,84 +1496,84 @@ var InlineAgentRunner = class _InlineAgentRunner {
     }, hooks);
   }
 };
-InlineAgentRunner = _ts_decorate9([
-  (0, import_common9.Injectable)(),
-  _ts_param9(0, (0, import_common9.Inject)(import_nestjs_agent_core11.AGENT_DEPS_FACTORY)),
-  _ts_param9(1, (0, import_common9.Inject)(import_nestjs_agent_core11.AGENT_STORE)),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+InlineAgentRunner = _ts_decorate10([
+  (0, import_common10.Injectable)(),
+  _ts_param10(0, (0, import_common10.Inject)(import_nestjs_agent_core12.AGENT_DEPS_FACTORY)),
+  _ts_param10(1, (0, import_common10.Inject)(import_nestjs_agent_core12.AGENT_STORE)),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
     typeof AgentStore === "undefined" ? Object : AgentStore
   ])
 ], InlineAgentRunner);
 
 // src/agent.module.ts
-function _ts_decorate10(decorators, target, key, desc) {
+function _ts_decorate11(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);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate10, "_ts_decorate");
+__name(_ts_decorate11, "_ts_decorate");
 var DEFAULT_PATH = "agent";
 function sharedProviders(durable, includeStore) {
   const providers = [
     {
-      provide: import_nestjs_agent_core12.AGENT_TOOL_REGISTRY,
-      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core12.ToolRegistry(), "useFactory")
+      provide: import_nestjs_agent_core13.AGENT_TOOL_REGISTRY,
+      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core13.ToolRegistry(), "useFactory")
     },
     // Starts empty; AgentDiscoveryService populates it from `@Agent`-decorated providers at boot.
     {
-      provide: import_nestjs_agent_core12.AGENT_REGISTRY,
-      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core12.AgentRegistry(), "useFactory")
+      provide: import_nestjs_agent_core13.AGENT_REGISTRY,
+      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core13.AgentRegistry(), "useFactory")
     },
     // A shared, mutable list AgentDiscoveryService fills with `@SystemPromptContributor()` methods.
     {
-      provide: import_nestjs_agent_core12.AGENT_PROMPT_CONTRIBUTORS,
+      provide: import_nestjs_agent_core13.AGENT_PROMPT_CONTRIBUTORS,
       useFactory: /* @__PURE__ */ __name(() => [], "useFactory")
     },
     {
-      provide: import_nestjs_agent_core12.AGENT_SINK,
+      provide: import_nestjs_agent_core13.AGENT_SINK,
       useFactory: /* @__PURE__ */ __name((options) => options.sink ?? new InProcessTokenStreamSink(), "useFactory"),
       inject: [
-        import_nestjs_agent_core12.AGENT_OPTIONS
+        import_nestjs_agent_core13.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core12.AGENT_ROLES_POLICY,
-      useFactory: /* @__PURE__ */ __name((options) => options.rolesPolicy ?? new import_nestjs_agent_core12.DefaultRolesPolicy(options.defaultRoles), "useFactory"),
+      provide: import_nestjs_agent_core13.AGENT_ROLES_POLICY,
+      useFactory: /* @__PURE__ */ __name((options) => options.rolesPolicy ?? new import_nestjs_agent_core13.DefaultRolesPolicy(options.defaultRoles), "useFactory"),
       inject: [
-        import_nestjs_agent_core12.AGENT_OPTIONS
+        import_nestjs_agent_core13.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core12.AGENT_ACTOR_RESOLVER,
+      provide: import_nestjs_agent_core13.AGENT_ACTOR_RESOLVER,
       useFactory: /* @__PURE__ */ __name((options) => options.actorResolver, "useFactory"),
       inject: [
-        import_nestjs_agent_core12.AGENT_OPTIONS
+        import_nestjs_agent_core13.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core12.AGENT_MODEL,
+      provide: import_nestjs_agent_core13.AGENT_MODEL,
       useFactory: /* @__PURE__ */ __name((o) => o.model, "useFactory"),
       inject: [
-        import_nestjs_agent_core12.AGENT_OPTIONS
+        import_nestjs_agent_core13.AGENT_OPTIONS
       ]
     },
     {
       // An explicit `quota` wins; otherwise `quotaLimitTokens` binds the built-in ledger-backed
       // store; otherwise quotas are off (undefined). The ledger store reads the same usage rows
       // the loop already writes, so enforcement needs no extra shared state across replicas.
-      provide: import_nestjs_agent_core12.AGENT_QUOTA_STORE,
+      provide: import_nestjs_agent_core13.AGENT_QUOTA_STORE,
       useFactory: /* @__PURE__ */ __name((o, store) => o.quota ?? (o.quotaLimitTokens !== void 0 ? new LedgerQuotaStore(store, o.quotaLimitTokens) : void 0), "useFactory"),
       inject: [
-        import_nestjs_agent_core12.AGENT_OPTIONS,
-        import_nestjs_agent_core12.AGENT_STORE
+        import_nestjs_agent_core13.AGENT_OPTIONS,
+        import_nestjs_agent_core13.AGENT_STORE
       ]
     },
     AgentDepsFactory2,
     {
-      provide: import_nestjs_agent_core12.AGENT_DEPS_FACTORY,
+      provide: import_nestjs_agent_core13.AGENT_DEPS_FACTORY,
       useExisting: AgentDepsFactory2
     },
     // Populates the registry + contributors (onModuleInit) BEFORE AiToolDiscoveryService synthesizes
@@ -1524,16 +1585,16 @@ function sharedProviders(durable, includeStore) {
   ];
   if (includeStore) {
     providers.push({
-      provide: import_nestjs_agent_core12.AGENT_STORE,
+      provide: import_nestjs_agent_core13.AGENT_STORE,
       useFactory: /* @__PURE__ */ __name((o) => o.store, "useFactory"),
       inject: [
-        import_nestjs_agent_core12.AGENT_OPTIONS
+        import_nestjs_agent_core13.AGENT_OPTIONS
       ]
     });
   }
   if (durable) {
     providers.push({
-      provide: import_nestjs_agent_core12.AGENT_RUNNER,
+      provide: import_nestjs_agent_core13.AGENT_RUNNER,
       useFactory: /* @__PURE__ */ __name((durableRunner) => {
         if (durableRunner === void 0) {
           throw new Error("AgentModule.forRoot({ durable: true }) requires importing AgentDurableModule from '@dudousxd/nestjs-agent/durable' (alongside a configured DurableModule). It was not found.");
@@ -1542,14 +1603,14 @@ function sharedProviders(durable, includeStore) {
       }, "useFactory"),
       inject: [
         {
-          token: import_nestjs_agent_core12.AGENT_DURABLE_RUNNER,
+          token: import_nestjs_agent_core13.AGENT_DURABLE_RUNNER,
           optional: true
         }
       ]
     });
   } else {
     providers.push({
-      provide: import_nestjs_agent_core12.AGENT_RUNNER,
+      provide: import_nestjs_agent_core13.AGENT_RUNNER,
       useExisting: InlineAgentRunner
     });
   }
@@ -1558,19 +1619,19 @@ function sharedProviders(durable, includeStore) {
 __name(sharedProviders, "sharedProviders");
 function exportsFor(includeStore) {
   return [
-    import_nestjs_agent_core12.AGENT_OPTIONS,
-    import_nestjs_agent_core12.AGENT_TOOL_REGISTRY,
-    import_nestjs_agent_core12.AGENT_REGISTRY,
-    import_nestjs_agent_core12.AGENT_SINK,
-    import_nestjs_agent_core12.AGENT_ROLES_POLICY,
-    import_nestjs_agent_core12.AGENT_ACTOR_RESOLVER,
-    import_nestjs_agent_core12.AGENT_MODEL,
+    import_nestjs_agent_core13.AGENT_OPTIONS,
+    import_nestjs_agent_core13.AGENT_TOOL_REGISTRY,
+    import_nestjs_agent_core13.AGENT_REGISTRY,
+    import_nestjs_agent_core13.AGENT_SINK,
+    import_nestjs_agent_core13.AGENT_ROLES_POLICY,
+    import_nestjs_agent_core13.AGENT_ACTOR_RESOLVER,
+    import_nestjs_agent_core13.AGENT_MODEL,
     ...includeStore ? [
-      import_nestjs_agent_core12.AGENT_STORE
+      import_nestjs_agent_core13.AGENT_STORE
     ] : [],
-    import_nestjs_agent_core12.AGENT_QUOTA_STORE,
-    import_nestjs_agent_core12.AGENT_PROMPT_CONTRIBUTORS,
-    import_nestjs_agent_core12.AGENT_DEPS_FACTORY,
+    import_nestjs_agent_core13.AGENT_QUOTA_STORE,
+    import_nestjs_agent_core13.AGENT_PROMPT_CONTRIBUTORS,
+    import_nestjs_agent_core13.AGENT_DEPS_FACTORY,
     AgentDepsFactory2,
     AgentService,
     InlineAgentRunner
@@ -1581,7 +1642,8 @@ var CONTROLLERS = [
   ChatController,
   ThreadsController,
   ToolCallController,
-  QuotaController
+  QuotaController,
+  AgentsController
 ];
 function routerFor(path) {
   return import_core3.RouterModule.register([
@@ -1609,7 +1671,7 @@ var AgentModule = class _AgentModule {
       controllers: CONTROLLERS,
       providers: [
         {
-          provide: import_nestjs_agent_core12.AGENT_OPTIONS,
+          provide: import_nestjs_agent_core13.AGENT_OPTIONS,
           useValue: options
         },
         ...sharedProviders(options.durable ?? false, includeStore)
@@ -1630,7 +1692,7 @@ var AgentModule = class _AgentModule {
       controllers: CONTROLLERS,
       providers: [
         {
-          provide: import_nestjs_agent_core12.AGENT_OPTIONS,
+          provide: import_nestjs_agent_core13.AGENT_OPTIONS,
           useFactory: options.useFactory,
           inject: options.inject ?? []
         },
@@ -1642,9 +1704,9 @@ var AgentModule = class _AgentModule {
     };
   }
 };
-AgentModule = _ts_decorate10([
-  (0, import_common10.Global)(),
-  (0, import_common10.Module)({})
+AgentModule = _ts_decorate11([
+  (0, import_common11.Global)(),
+  (0, import_common11.Module)({})
 ], AgentModule);
 
 // src/resolver/header-actor-resolver.ts