@dudousxd/nestjs-agent 0.3.1 → 0.3.3

package/dist/durable/index.js

@@ -124,7 +124,9 @@ AgentRunWorkflow = _ts_decorate([
 ], AgentRunWorkflow);
 
 // src/durable/durable-agent-runner.ts
+import { randomUUID } from "node:crypto";
 import { WorkflowService } from "@dudousxd/nestjs-durable";
+import { WorkflowSuspended as WorkflowSuspended2 } from "@dudousxd/nestjs-durable-core";
 import { Injectable as Injectable2 } from "@nestjs/common";
 function _ts_decorate2(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -150,9 +152,16 @@ var DurableAgentRunner = class {
       ...input,
       day: input.day ?? utcDay()
     };
-    const result = await this.workflows.start(AgentRunWorkflow, stamped);
+    const runId = randomUUID();
+    try {
+      await this.workflows.start(AgentRunWorkflow, stamped, runId);
+    } catch (error) {
+      if (!(error instanceof WorkflowSuspended2)) {
+        throw error;
+      }
+    }
     return {
-      runId: result.runId
+      runId
     };
   }
   async signal(runId, toolCallId, decision) {
@@ -215,7 +224,7 @@ AgentDurableModule = _ts_decorate3([
 ], AgentDurableModule);
 
 // src/agent.module.ts
-import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER5, AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY4, AGENT_DURABLE_RUNNER as AGENT_DURABLE_RUNNER2, AGENT_MODEL as AGENT_MODEL2, AGENT_OPTIONS as AGENT_OPTIONS3, AGENT_PROMPT_CONTRIBUTORS as AGENT_PROMPT_CONTRIBUTORS3, AGENT_QUOTA_STORE as AGENT_QUOTA_STORE3, AGENT_REGISTRY as AGENT_REGISTRY4, AGENT_ROLES_POLICY as AGENT_ROLES_POLICY2, AGENT_RUNNER as AGENT_RUNNER2, AGENT_SINK as AGENT_SINK2, AGENT_STORE as AGENT_STORE5, AGENT_TOOL_REGISTRY as AGENT_TOOL_REGISTRY3, AgentRegistry as AgentRegistry4, DefaultRolesPolicy, ToolRegistry as ToolRegistry3 } from "@dudousxd/nestjs-agent-core";
+import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER5, AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY5, AGENT_DURABLE_RUNNER as AGENT_DURABLE_RUNNER2, AGENT_MODEL as AGENT_MODEL2, AGENT_OPTIONS as AGENT_OPTIONS3, AGENT_PROMPT_CONTRIBUTORS as AGENT_PROMPT_CONTRIBUTORS3, AGENT_QUOTA_STORE as AGENT_QUOTA_STORE3, AGENT_REGISTRY as AGENT_REGISTRY5, AGENT_ROLES_POLICY as AGENT_ROLES_POLICY2, AGENT_RUNNER as AGENT_RUNNER2, AGENT_SINK as AGENT_SINK2, AGENT_STORE as AGENT_STORE5, AGENT_TOOL_REGISTRY as AGENT_TOOL_REGISTRY3, AgentRegistry as AgentRegistry5, DefaultRolesPolicy, ToolRegistry as ToolRegistry3 } from "@dudousxd/nestjs-agent-core";
 import { Global as Global2, Module as Module2 } from "@nestjs/common";
 import { DiscoveryModule, RouterModule } from "@nestjs/core";
 
@@ -427,6 +436,9 @@ var AgentService = class {
       ...params.regenerate === true ? {
         regenerate: true
       } : {},
+      ...params.attachments !== void 0 ? {
+        attachments: params.attachments
+      } : {},
       ...params.pageContext !== void 0 ? {
         pageContext: params.pageContext
       } : {}
@@ -582,9 +594,9 @@ AgentService = _ts_decorate5([
   ])
 ], AgentService);
 
-// src/controller/chat.controller.ts
-import { AGENT_ACTOR_RESOLVER, AgentStreamError } from "@dudousxd/nestjs-agent-core";
-import { Body, Controller, Get, Inject as Inject4, Param, Post, Req, Res } from "@nestjs/common";
+// src/controller/agents.controller.ts
+import { AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY3, AGENT_REGISTRY as AGENT_REGISTRY2, AgentRegistry as AgentRegistry3 } from "@dudousxd/nestjs-agent-core";
+import { Controller, Get, Inject as Inject4 } from "@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);
@@ -602,6 +614,64 @@ function _ts_param4(paramIndex, decorator) {
   };
 }
 __name(_ts_param4, "_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_decorate6([
+  Get(),
+  _ts_metadata5("design:type", Function),
+  _ts_metadata5("design:paramtypes", []),
+  _ts_metadata5("design:returntype", Array)
+], AgentsController.prototype, "list", null);
+AgentsController = _ts_decorate6([
+  Controller("agents"),
+  _ts_param4(0, Inject4(AGENT_REGISTRY2)),
+  _ts_param4(1, Inject4(AGENT_DEPS_FACTORY3)),
+  _ts_metadata5("design:type", Function),
+  _ts_metadata5("design:paramtypes", [
+    typeof AgentRegistry3 === "undefined" ? Object : AgentRegistry3,
+    typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory
+  ])
+], AgentsController);
+
+// src/controller/chat.controller.ts
+import { AGENT_ACTOR_RESOLVER, AgentStreamError } from "@dudousxd/nestjs-agent-core";
+import { Body, Controller as Controller2, Get as Get2, Inject as Inject5, Param, Post, Req, Res } from "@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_decorate7, "_ts_decorate");
+function _ts_metadata6(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata6, "_ts_metadata");
+function _ts_param5(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param5, "_ts_param");
 var ChatController = class {
   static {
     __name(this, "ChatController");
@@ -623,6 +693,9 @@ var ChatController = class {
       ...body.agent !== void 0 ? {
         agentName: body.agent
       } : {},
+      ...body.attachments !== void 0 ? {
+        attachments: body.attachments
+      } : {},
       ...body.pageContext !== void 0 ? {
         pageContext: body.pageContext
       } : {},
@@ -661,11 +734,26 @@ data: ${JSON.stringify({
 
 `);
     const decoder = new TextDecoder();
+    let buffer = "";
     try {
       for await (const chunk of this.agent.subscribe(runId)) {
-        res.write(`data: ${JSON.stringify({
-          delta: decoder.decode(chunk)
-        })}
+        buffer += decoder.decode(chunk, {
+          stream: true
+        });
+        let newline = buffer.indexOf("\n");
+        while (newline !== -1) {
+          const line = buffer.slice(0, newline);
+          buffer = buffer.slice(newline + 1);
+          if (line.length > 0) {
+            res.write(`data: ${line}
+
+`);
+          }
+          newline = buffer.indexOf("\n");
+        }
+      }
+      if (buffer.length > 0) {
+        res.write(`data: ${buffer}
 
 `);
       }
@@ -686,46 +774,46 @@ data: ${JSON.stringify(payload)}
     res.end();
   }
 };
-_ts_decorate6([
+_ts_decorate7([
   Post("chat"),
-  _ts_param4(0, Req()),
-  _ts_param4(1, Res()),
-  _ts_param4(2, Body()),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+  _ts_param5(0, Req()),
+  _ts_param5(1, Res()),
+  _ts_param5(2, Body()),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof Response === "undefined" ? Object : Response,
     typeof ChatBody === "undefined" ? Object : ChatBody
   ]),
-  _ts_metadata5("design:returntype", Promise)
+  _ts_metadata6("design:returntype", Promise)
 ], ChatController.prototype, "chat", null);
-_ts_decorate6([
-  Get("chat/:runId/stream"),
-  _ts_param4(0, Param("runId")),
-  _ts_param4(1, Res()),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+_ts_decorate7([
+  Get2("chat/:runId/stream"),
+  _ts_param5(0, Param("runId")),
+  _ts_param5(1, Res()),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("design:paramtypes", [
     String,
     typeof Response === "undefined" ? Object : Response
   ]),
-  _ts_metadata5("design:returntype", Promise)
+  _ts_metadata6("design:returntype", Promise)
 ], ChatController.prototype, "stream", null);
-_ts_decorate6([
+_ts_decorate7([
   Post("chat/:runId/cancel"),
-  _ts_param4(0, Req()),
-  _ts_param4(1, Param("runId")),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+  _ts_param5(0, Req()),
+  _ts_param5(1, Param("runId")),
+  _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)
 ], ChatController.prototype, "cancel", null);
-ChatController = _ts_decorate6([
-  Controller(),
-  _ts_param4(1, Inject4(AGENT_ACTOR_RESOLVER)),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+ChatController = _ts_decorate7([
+  Controller2(),
+  _ts_param5(1, Inject5(AGENT_ACTOR_RESOLVER)),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
@@ -733,24 +821,24 @@ ChatController = _ts_decorate6([
 
 // src/controller/quota.controller.ts
 import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER2 } from "@dudousxd/nestjs-agent-core";
-import { Controller as Controller2, Get as Get2, Inject as Inject5, Req as Req2 } from "@nestjs/common";
-function _ts_decorate7(decorators, target, key, desc) {
+import { Controller as Controller3, Get as Get3, Inject as Inject6, Req as Req2 } from "@nestjs/common";
+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_metadata6(k, v) {
+__name(_ts_decorate8, "_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_param5(paramIndex, decorator) {
+__name(_ts_metadata7, "_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 QuotaController = class {
   static {
     __name(this, "QuotaController");
@@ -766,20 +854,20 @@ var QuotaController = class {
     return this.agent.quotaToday(actor.id);
   }
 };
-_ts_decorate7([
-  Get2("today"),
-  _ts_param5(0, Req2()),
-  _ts_metadata6("design:type", Function),
-  _ts_metadata6("design:paramtypes", [
+_ts_decorate8([
+  Get3("today"),
+  _ts_param6(0, Req2()),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata6("design:returntype", Promise)
+  _ts_metadata7("design:returntype", Promise)
 ], QuotaController.prototype, "today", null);
-QuotaController = _ts_decorate7([
-  Controller2("quota"),
-  _ts_param5(1, Inject5(AGENT_ACTOR_RESOLVER2)),
-  _ts_metadata6("design:type", Function),
-  _ts_metadata6("design:paramtypes", [
+QuotaController = _ts_decorate8([
+  Controller3("quota"),
+  _ts_param6(1, Inject6(AGENT_ACTOR_RESOLVER2)),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
@@ -787,24 +875,24 @@ QuotaController = _ts_decorate7([
 
 // src/controller/threads.controller.ts
 import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER3 } from "@dudousxd/nestjs-agent-core";
-import { Body as Body2, Controller as Controller3, Delete, Get as Get3, Inject as Inject6, Param as Param2, Patch, Post as Post2, Req as Req3 } from "@nestjs/common";
-function _ts_decorate8(decorators, target, key, desc) {
+import { Body as Body2, Controller as Controller4, Delete, Get as Get4, Inject as Inject7, Param as Param2, Patch, Post as Post2, Req as Req3 } from "@nestjs/common";
+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_metadata7(k, v) {
+__name(_ts_decorate9, "_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_param6(paramIndex, decorator) {
+__name(_ts_metadata8, "_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 ThreadsController = class {
   static {
     __name(this, "ThreadsController");
@@ -856,92 +944,92 @@ var ThreadsController = class {
     };
   }
 };
-_ts_decorate8([
-  Get3(),
-  _ts_param6(0, Req3()),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
+_ts_decorate9([
+  Get4(),
+  _ts_param7(0, Req3()),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata7("design:returntype", Promise)
+  _ts_metadata8("design:returntype", Promise)
 ], ThreadsController.prototype, "list", null);
-_ts_decorate8([
-  Get3(":id"),
-  _ts_param6(0, Req3()),
-  _ts_param6(1, Param2("id")),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
+_ts_decorate9([
+  Get4(":id"),
+  _ts_param7(0, Req3()),
+  _ts_param7(1, Param2("id")),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata7("design:returntype", Promise)
+  _ts_metadata8("design:returntype", Promise)
 ], ThreadsController.prototype, "detail", null);
-_ts_decorate8([
+_ts_decorate9([
   Delete(":id"),
-  _ts_param6(0, Req3()),
-  _ts_param6(1, Param2("id")),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
+  _ts_param7(0, Req3()),
+  _ts_param7(1, Param2("id")),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata7("design:returntype", Promise)
+  _ts_metadata8("design:returntype", Promise)
 ], ThreadsController.prototype, "remove", null);
-_ts_decorate8([
+_ts_decorate9([
   Post2(":id/fork-from/:messageId"),
-  _ts_param6(0, Req3()),
-  _ts_param6(1, Param2("id")),
-  _ts_param6(2, Param2("messageId")),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
+  _ts_param7(0, Req3()),
+  _ts_param7(1, Param2("id")),
+  _ts_param7(2, Param2("messageId")),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     String
   ]),
-  _ts_metadata7("design:returntype", Promise)
+  _ts_metadata8("design:returntype", Promise)
 ], ThreadsController.prototype, "fork", null);
-_ts_decorate8([
+_ts_decorate9([
   Patch(":id"),
-  _ts_param6(0, Req3()),
-  _ts_param6(1, Param2("id")),
-  _ts_param6(2, Body2()),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
+  _ts_param7(0, Req3()),
+  _ts_param7(1, Param2("id")),
+  _ts_param7(2, Body2()),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     typeof RenameThreadBody === "undefined" ? Object : RenameThreadBody
   ]),
-  _ts_metadata7("design:returntype", Promise)
+  _ts_metadata8("design:returntype", Promise)
 ], ThreadsController.prototype, "rename", null);
-_ts_decorate8([
+_ts_decorate9([
   Post2(":id/promote"),
-  _ts_param6(0, Req3()),
-  _ts_param6(1, Param2("id")),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
+  _ts_param7(0, Req3()),
+  _ts_param7(1, Param2("id")),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata7("design:returntype", Promise)
+  _ts_metadata8("design:returntype", Promise)
 ], ThreadsController.prototype, "promote", null);
-_ts_decorate8([
+_ts_decorate9([
   Delete(":id/from/:messageId"),
-  _ts_param6(0, Req3()),
-  _ts_param6(1, Param2("id")),
-  _ts_param6(2, Param2("messageId")),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
+  _ts_param7(0, Req3()),
+  _ts_param7(1, Param2("id")),
+  _ts_param7(2, Param2("messageId")),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     String
   ]),
-  _ts_metadata7("design:returntype", Promise)
+  _ts_metadata8("design:returntype", Promise)
 ], ThreadsController.prototype, "truncateFrom", null);
-ThreadsController = _ts_decorate8([
-  Controller3("threads"),
-  _ts_param6(1, Inject6(AGENT_ACTOR_RESOLVER3)),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
+ThreadsController = _ts_decorate9([
+  Controller4("threads"),
+  _ts_param7(1, Inject7(AGENT_ACTOR_RESOLVER3)),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
@@ -949,24 +1037,24 @@ ThreadsController = _ts_decorate8([
 
 // src/controller/tool-call.controller.ts
 import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER4 } from "@dudousxd/nestjs-agent-core";
-import { Body as Body3, Controller as Controller4, Inject as Inject7, Post as Post3, Req as Req4 } from "@nestjs/common";
-function _ts_decorate9(decorators, target, key, desc) {
+import { Body as Body3, Controller as Controller5, Inject as Inject8, Post as Post3, Req as Req4 } from "@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_metadata8(k, v) {
+__name(_ts_decorate10, "_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_param7(paramIndex, decorator) {
+__name(_ts_metadata9, "_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 ToolCallController = class {
   static {
     __name(this, "ToolCallController");
@@ -992,41 +1080,41 @@ var ToolCallController = class {
     };
   }
 };
-_ts_decorate9([
+_ts_decorate10([
   Post3("approve"),
-  _ts_param7(0, Req4()),
-  _ts_param7(1, Body3()),
-  _ts_metadata8("design:type", Function),
-  _ts_metadata8("design:paramtypes", [
+  _ts_param8(0, Req4()),
+  _ts_param8(1, Body3()),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof ApproveBody === "undefined" ? Object : ApproveBody
   ]),
-  _ts_metadata8("design:returntype", Promise)
+  _ts_metadata9("design:returntype", Promise)
 ], ToolCallController.prototype, "approve", null);
-_ts_decorate9([
+_ts_decorate10([
   Post3("reject"),
-  _ts_param7(0, Req4()),
-  _ts_param7(1, Body3()),
-  _ts_metadata8("design:type", Function),
-  _ts_metadata8("design:paramtypes", [
+  _ts_param8(0, Req4()),
+  _ts_param8(1, Body3()),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof RejectBody === "undefined" ? Object : RejectBody
   ]),
-  _ts_metadata8("design:returntype", Promise)
+  _ts_metadata9("design:returntype", Promise)
 ], ToolCallController.prototype, "reject", null);
-ToolCallController = _ts_decorate9([
-  Controller4("tool-call"),
-  _ts_param7(1, Inject7(AGENT_ACTOR_RESOLVER4)),
-  _ts_metadata8("design:type", Function),
-  _ts_metadata8("design:paramtypes", [
+ToolCallController = _ts_decorate10([
+  Controller5("tool-call"),
+  _ts_param8(1, Inject8(AGENT_ACTOR_RESOLVER4)),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ToolCallController);
 
 // src/discovery/agent-discovery.service.ts
-import { AGENT_PROMPT_CONTRIBUTORS as AGENT_PROMPT_CONTRIBUTORS2, AGENT_REGISTRY as AGENT_REGISTRY2, AgentRegistry as AgentRegistry3 } from "@dudousxd/nestjs-agent-core";
-import { Inject as Inject8, Injectable as Injectable5, Logger } from "@nestjs/common";
+import { AGENT_PROMPT_CONTRIBUTORS as AGENT_PROMPT_CONTRIBUTORS2, AGENT_REGISTRY as AGENT_REGISTRY3, AgentRegistry as AgentRegistry4 } from "@dudousxd/nestjs-agent-core";
+import { Inject as Inject9, Injectable as Injectable5, Logger } from "@nestjs/common";
 import { DiscoveryService, MetadataScanner } from "@nestjs/core";
 
 // src/decorator/agent.decorator.ts
@@ -1043,23 +1131,23 @@ var SYSTEM_PROMPT_METADATA = Symbol.for("@dudousxd/nestjs-agent:system-prompt");
 var SYSTEM_PROMPT_CONTRIBUTOR_METADATA = Symbol.for("@dudousxd/nestjs-agent:system-prompt-contributor");
 
 // src/discovery/agent-discovery.service.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");
-function _ts_metadata9(k, v) {
+__name(_ts_decorate11, "_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_param8(paramIndex, decorator) {
+__name(_ts_metadata10, "_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 AgentDiscoveryService = class _AgentDiscoveryService {
   static {
     __name(this, "AgentDiscoveryService");
@@ -1094,6 +1182,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
@@ -1153,22 +1244,22 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
     return (ctx) => candidate.call(instance, ctx);
   }
 };
-AgentDiscoveryService = _ts_decorate10([
+AgentDiscoveryService = _ts_decorate11([
   Injectable5(),
-  _ts_param8(2, Inject8(AGENT_REGISTRY2)),
-  _ts_param8(3, Inject8(AGENT_PROMPT_CONTRIBUTORS2)),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+  _ts_param9(2, Inject9(AGENT_REGISTRY3)),
+  _ts_param9(3, Inject9(AGENT_PROMPT_CONTRIBUTORS2)),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
     typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
     typeof MetadataScanner === "undefined" ? Object : MetadataScanner,
-    typeof AgentRegistry3 === "undefined" ? Object : AgentRegistry3,
+    typeof AgentRegistry4 === "undefined" ? Object : AgentRegistry4,
     Array
   ])
 ], AgentDiscoveryService);
 
 // src/discovery/ai-tool-discovery.service.ts
-import { AGENT_OPTIONS as AGENT_OPTIONS2, AGENT_REGISTRY as AGENT_REGISTRY3, AGENT_TOOL_REGISTRY as AGENT_TOOL_REGISTRY2 } from "@dudousxd/nestjs-agent-core";
-import { Inject as Inject9, Injectable as Injectable6, Logger as Logger2 } from "@nestjs/common";
+import { AGENT_OPTIONS as AGENT_OPTIONS2, AGENT_REGISTRY as AGENT_REGISTRY4, AGENT_TOOL_REGISTRY as AGENT_TOOL_REGISTRY2 } from "@dudousxd/nestjs-agent-core";
+import { Inject as Inject10, Injectable as Injectable6, Logger as Logger2 } from "@nestjs/common";
 import { DiscoveryService as DiscoveryService2 } from "@nestjs/core";
 import { z } from "zod";
 
@@ -1188,23 +1279,23 @@ function isBrandedFunctionalTool(value) {
 __name(isBrandedFunctionalTool, "isBrandedFunctionalTool");
 
 // src/discovery/ai-tool-discovery.service.ts
-function _ts_decorate11(decorators, target, key, desc) {
+function _ts_decorate12(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_decorate11, "_ts_decorate");
-function _ts_metadata10(k, v) {
+__name(_ts_decorate12, "_ts_decorate");
+function _ts_metadata11(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata10, "_ts_metadata");
-function _ts_param9(paramIndex, decorator) {
+__name(_ts_metadata11, "_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 AiToolDiscoveryService = class _AiToolDiscoveryService {
   static {
     __name(this, "AiToolDiscoveryService");
@@ -1311,13 +1402,13 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
     return true;
   }
 };
-AiToolDiscoveryService = _ts_decorate11([
+AiToolDiscoveryService = _ts_decorate12([
   Injectable6(),
-  _ts_param9(1, Inject9(AGENT_TOOL_REGISTRY2)),
-  _ts_param9(2, Inject9(AGENT_REGISTRY3)),
-  _ts_param9(3, Inject9(AGENT_OPTIONS2)),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+  _ts_param10(1, Inject10(AGENT_TOOL_REGISTRY2)),
+  _ts_param10(2, Inject10(AGENT_REGISTRY4)),
+  _ts_param10(3, Inject10(AGENT_OPTIONS2)),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof DiscoveryService2 === "undefined" ? Object : DiscoveryService2,
     typeof ToolRegistry === "undefined" ? Object : ToolRegistry,
     typeof AgentRegistry === "undefined" ? Object : AgentRegistry,
@@ -1417,25 +1508,25 @@ var LedgerQuotaStore = class {
 };
 
 // src/runner/inline-agent-runner.ts
-import { AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY3, AGENT_STORE as AGENT_STORE4, QuotaExceededError as QuotaExceededError2, publishAgentRunFailed as publishAgentRunFailed2, runAgentLoop as runAgentLoop2 } from "@dudousxd/nestjs-agent-core";
-import { Inject as Inject10, Injectable as Injectable7, Logger as Logger3 } from "@nestjs/common";
-function _ts_decorate12(decorators, target, key, desc) {
+import { AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY4, AGENT_STORE as AGENT_STORE4, QuotaExceededError as QuotaExceededError2, publishAgentRunFailed as publishAgentRunFailed2, runAgentLoop as runAgentLoop2 } from "@dudousxd/nestjs-agent-core";
+import { Inject as Inject11, Injectable as Injectable7, Logger as Logger3 } from "@nestjs/common";
+function _ts_decorate13(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_decorate12, "_ts_decorate");
-function _ts_metadata11(k, v) {
+__name(_ts_decorate13, "_ts_decorate");
+function _ts_metadata12(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata11, "_ts_metadata");
-function _ts_param10(paramIndex, decorator) {
+__name(_ts_metadata12, "_ts_metadata");
+function _ts_param11(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param10, "_ts_param");
+__name(_ts_param11, "_ts_param");
 var InlineAgentRunner = class _InlineAgentRunner {
   static {
     __name(this, "InlineAgentRunner");
@@ -1536,25 +1627,25 @@ var InlineAgentRunner = class _InlineAgentRunner {
     }, hooks);
   }
 };
-InlineAgentRunner = _ts_decorate12([
+InlineAgentRunner = _ts_decorate13([
   Injectable7(),
-  _ts_param10(0, Inject10(AGENT_DEPS_FACTORY3)),
-  _ts_param10(1, Inject10(AGENT_STORE4)),
-  _ts_metadata11("design:type", Function),
-  _ts_metadata11("design:paramtypes", [
+  _ts_param11(0, Inject11(AGENT_DEPS_FACTORY4)),
+  _ts_param11(1, Inject11(AGENT_STORE4)),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
     typeof AgentStore === "undefined" ? Object : AgentStore
   ])
 ], InlineAgentRunner);
 
 // src/agent.module.ts
-function _ts_decorate13(decorators, target, key, desc) {
+function _ts_decorate14(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_decorate13, "_ts_decorate");
+__name(_ts_decorate14, "_ts_decorate");
 var DEFAULT_PATH = "agent";
 function sharedProviders(durable, includeStore) {
   const providers = [
@@ -1564,8 +1655,8 @@ function sharedProviders(durable, includeStore) {
     },
     // Starts empty; AgentDiscoveryService populates it from `@Agent`-decorated providers at boot.
     {
-      provide: AGENT_REGISTRY4,
-      useFactory: /* @__PURE__ */ __name(() => new AgentRegistry4(), "useFactory")
+      provide: AGENT_REGISTRY5,
+      useFactory: /* @__PURE__ */ __name(() => new AgentRegistry5(), "useFactory")
     },
     // A shared, mutable list AgentDiscoveryService fills with `@SystemPromptContributor()` methods.
     {
@@ -1613,7 +1704,7 @@ function sharedProviders(durable, includeStore) {
     },
     AgentDepsFactory2,
     {
-      provide: AGENT_DEPS_FACTORY4,
+      provide: AGENT_DEPS_FACTORY5,
       useExisting: AgentDepsFactory2
     },
     // Populates the registry + contributors (onModuleInit) BEFORE AiToolDiscoveryService synthesizes
@@ -1661,7 +1752,7 @@ function exportsFor(includeStore) {
   return [
     AGENT_OPTIONS3,
     AGENT_TOOL_REGISTRY3,
-    AGENT_REGISTRY4,
+    AGENT_REGISTRY5,
     AGENT_SINK2,
     AGENT_ROLES_POLICY2,
     AGENT_ACTOR_RESOLVER5,
@@ -1671,7 +1762,7 @@ function exportsFor(includeStore) {
     ] : [],
     AGENT_QUOTA_STORE3,
     AGENT_PROMPT_CONTRIBUTORS3,
-    AGENT_DEPS_FACTORY4,
+    AGENT_DEPS_FACTORY5,
     AgentDepsFactory2,
     AgentService,
     InlineAgentRunner
@@ -1682,7 +1773,8 @@ var CONTROLLERS = [
   ChatController,
   ThreadsController,
   ToolCallController,
-  QuotaController
+  QuotaController,
+  AgentsController
 ];
 function routerFor(path) {
   return RouterModule.register([
@@ -1720,6 +1812,7 @@ var AgentModule = class _AgentModule {
   }
   static forRootAsync(options) {
     const path = options.path ?? DEFAULT_PATH;
+    const includeStore = options.externalStore !== true;
     return {
       module: _AgentModule,
       global: true,
@@ -1735,15 +1828,13 @@ var AgentModule = class _AgentModule {
           useFactory: options.useFactory,
           inject: options.inject ?? []
         },
-        // The async factory resolves too late to inspect `store`, so we always bind AGENT_STORE here
-        // (its factory reads the resolved options). Omit-and-import-a-store-module is a `forRoot` path.
-        ...sharedProviders(options.durable ?? false, true)
+        ...sharedProviders(options.durable ?? false, includeStore)
       ],
-      exports: exportsFor(true)
+      exports: exportsFor(includeStore)
     };
   }
 };
-AgentModule = _ts_decorate13([
+AgentModule = _ts_decorate14([
   Global2(),
   Module2({})
 ], AgentModule);