@dudousxd/nestjs-agent 1.5.0 → 1.7.0

package/dist/index.cjs

@@ -42,6 +42,8 @@ __export(index_exports, {
   InlineAgentRunner: () => InlineAgentRunner,
   LedgerQuotaStore: () => LedgerQuotaStore,
   MemoriesController: () => MemoriesController,
+  MessagesController: () => MessagesController,
+  ModelsController: () => ModelsController,
   SKILL_METADATA: () => SKILL_METADATA,
   SYSTEM_PROMPT_CONTRIBUTOR_METADATA: () => SYSTEM_PROMPT_CONTRIBUTOR_METADATA,
   SYSTEM_PROMPT_METADATA: () => SYSTEM_PROMPT_METADATA,
@@ -64,8 +66,8 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/agent.module.ts
-var import_nestjs_agent_core20 = require("@dudousxd/nestjs-agent-core");
-var import_common17 = require("@nestjs/common");
+var import_nestjs_agent_core22 = require("@dudousxd/nestjs-agent-core");
+var import_common19 = require("@nestjs/common");
 var import_core4 = require("@nestjs/core");
 
 // src/agent-deps.factory.ts
@@ -389,15 +391,72 @@ var AgentService = class {
   deps;
   quota;
   staging;
-  constructor(runner, store, deps, quota, staging) {
+  models;
+  constructor(runner, store, deps, quota, staging, models) {
     this.runner = runner;
     this.store = store;
     this.deps = deps;
     this.quota = quota;
     this.staging = staging;
+    this.models = models;
+  }
+  /**
+  * The models `actor` may pick for `agent` (`GET <base>/models`). An empty catalog when none is
+  * bound, so a picker simply has nothing to offer.
+  */
+  async listModels(actor, agent) {
+    if (this.models === void 0) {
+      return {
+        providers: [],
+        default: null
+      };
+    }
+    return this.models.list({
+      actor,
+      ...agent !== void 0 ? {
+        agent
+      } : {}
+    });
+  }
+  /**
+  * `model` if the catalog offers it to this actor and agent right now, else a 400 naming why. The
+  * one gate every model choice passes — a send's own, and a thread's pinned one at the moment it is
+  * pinned and again at every turn that runs on it (availability can change in between).
+  */
+  async assertModelAllowed(actor, agent, model) {
+    if (this.models === void 0) {
+      throw new import_common2.BadRequestException(`model "${model}" cannot be selected: no ModelCatalog is configured (AgentModule.forRoot({ models }))`);
+    }
+    const entry = (0, import_nestjs_agent_core3.findCatalogModel)(await this.models.list({
+      actor,
+      agent
+    }), model);
+    if (entry === void 0) {
+      throw new import_common2.BadRequestException(`model "${model}" is not offered`);
+    }
+    if (!entry.available) {
+      throw new import_common2.BadRequestException(`model "${model}" is not available${entry.unavailableReason ? `: ${entry.unavailableReason}` : ""}`);
+    }
+    return entry.id;
+  }
+  /** The model a turn runs on: the send's own, else the thread's pinned one, else none. */
+  async resolveModel(actor, agent, requested, threadId) {
+    const model = requested ?? (threadId !== void 0 ? await this.threadModel(threadId) : null);
+    if (model === null || model === void 0) {
+      return void 0;
+    }
+    return this.assertModelAllowed(actor, agent, model);
+  }
+  async threadModel(threadId) {
+    const projecting = this.store;
+    if (typeof projecting.modelForThread === "function") {
+      return projecting.modelForThread(threadId);
+    }
+    return (await this.store.getThread(threadId))?.model ?? null;
   }
   async chat(params) {
     const agentName = await this.resolveAgentName(params.agentName, params.threadId);
+    const model = await this.resolveModel(params.actor, agentName, params.model, params.threadId);
     const attachments = await this.resolveAttachments(params.actor, params.attachments ?? []);
     let threadId = params.threadId;
     if (threadId === void 0) {
@@ -428,6 +487,9 @@ var AgentService = class {
       } : {},
       ...params.pageContext !== void 0 ? {
         pageContext: params.pageContext
+      } : {},
+      ...model !== void 0 ? {
+        model
       } : {}
     };
     const { runId } = await this.runner.start(input);
@@ -598,20 +660,26 @@ var AgentService = class {
   async updateThread(actor, threadId, patch) {
     const title = patch.title !== void 0 ? this.validateTitle(patch.title) : void 0;
     await this.assertOwnsThread(actor, threadId);
-    if (patch.defaultAgent === void 0) {
+    if (patch.defaultAgent === void 0 && patch.model === void 0) {
       if (title !== void 0) {
         await this.store.setTitle(threadId, title);
       }
       return;
     }
     if (this.store.updateThread === void 0) {
-      throw new import_common2.NotImplementedException("Setting a thread's defaultAgent requires an AgentStore that implements updateThread(); the bound store does not support it.");
+      throw new import_common2.NotImplementedException("Setting a thread's defaultAgent or model requires an AgentStore that implements updateThread(); the bound store does not support it.");
     }
+    const model = patch.model === void 0 || patch.model === null ? patch.model : await this.assertModelAllowed(actor, patch.defaultAgent ?? await this.resolveAgentName(void 0, threadId), patch.model);
     await this.store.updateThread(threadId, {
       ...title !== void 0 ? {
         title
       } : {},
-      defaultAgent: patch.defaultAgent
+      ...patch.defaultAgent !== void 0 ? {
+        defaultAgent: patch.defaultAgent
+      } : {},
+      ...model !== void 0 ? {
+        model
+      } : {}
     });
   }
   validateTitle(title) {
@@ -658,6 +726,7 @@ var AgentService = class {
     return {
       ...thread,
       defaultAgent: thread.defaultAgent ?? null,
+      model: thread.model ?? null,
       activeRunId: await this.store.activeRunForThread?.(thread.id) ?? null
     };
   }
@@ -685,6 +754,40 @@ var AgentService = class {
     return this.store.truncateFrom(threadId, messageId);
   }
   /**
+  * Rate a message in one of `actor`'s threads: `'up'`/`'down'` with an optional comment, or `null`
+  * to clear the rating. Answers `404` for an unknown message, `403` for another actor's, and `501`
+  * on a store without `threadOfMessage` + `setMessageFeedback`.
+  */
+  async setMessageFeedback(actor, messageId, input) {
+    if (input.value !== null && input.value !== "up" && input.value !== "down") {
+      throw new import_common2.BadRequestException("value must be 'up', 'down' or null");
+    }
+    if (input.comment !== void 0 && typeof input.comment !== "string") {
+      throw new import_common2.BadRequestException("comment must be a string");
+    }
+    const comment = input.comment?.trim();
+    if (comment !== void 0 && comment.length > 2e3) {
+      throw new import_common2.BadRequestException("comment must be at most 2000 characters");
+    }
+    if (this.store.threadOfMessage === void 0 || this.store.setMessageFeedback === void 0) {
+      throw new import_common2.NotImplementedException("Message feedback requires an AgentStore that implements threadOfMessage() and setMessageFeedback(); the bound store does not support it.");
+    }
+    const threadId = await this.store.threadOfMessage(messageId);
+    if (threadId === null) {
+      throw new import_common2.NotFoundException(`message ${messageId} not found`);
+    }
+    await this.assertOwnsThread(actor, threadId);
+    const feedback = input.value === null ? null : {
+      value: input.value,
+      ...comment !== void 0 && comment.length > 0 ? {
+        comment
+      } : {},
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await this.store.setMessageFeedback(messageId, feedback);
+    return feedback;
+  }
+  /**
   * Every file this actor has staged, newest first — across threads, including uploads that were
   * never sent, which nothing else on this surface can see.
   *
@@ -891,13 +994,16 @@ AgentService = _ts_decorate2([
   _ts_param2(3, (0, import_common2.Inject)(import_nestjs_agent_core3.AGENT_QUOTA_STORE)),
   _ts_param2(4, (0, import_common2.Optional)()),
   _ts_param2(4, (0, import_common2.Inject)(import_nestjs_agent_core3.AGENT_ATTACHMENT_STAGING)),
+  _ts_param2(5, (0, import_common2.Optional)()),
+  _ts_param2(5, (0, import_common2.Inject)(import_nestjs_agent_core3.AGENT_MODEL_CATALOG)),
   _ts_metadata2("design:type", Function),
   _ts_metadata2("design:paramtypes", [
     typeof AgentRunner === "undefined" ? Object : AgentRunner,
     typeof AgentStore === "undefined" ? Object : AgentStore,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
     Object,
-    typeof AttachmentStagingStore === "undefined" ? Object : AttachmentStagingStore
+    typeof AttachmentStagingStore === "undefined" ? Object : AttachmentStagingStore,
+    typeof ModelCatalog === "undefined" ? Object : ModelCatalog
   ])
 ], AgentService);
 
@@ -1269,13 +1375,22 @@ var ChatController = class {
       } : {},
       ...body.transient === true ? {
         transient: true
+      } : {},
+      ...typeof body.model === "string" && body.model.length > 0 ? {
+        model: body.model
       } : {}
     });
     await this.pipe(res, runId, this.agent.subscribe(runId), threadId);
   }
-  async stream(req, runId, res) {
+  /**
+  * Attach to a run's stream: every buffered frame, then live ones. `?after=<seq>` (or the SSE
+  * `Last-Event-ID` header a browser `EventSource` sends on its own) skips the frames a reconnecting
+  * client already has — see {@link pipe} for how frames are numbered.
+  */
+  async stream(req, runId, res, after) {
     const actor = await this.actorResolver.resolve(req);
-    await this.pipe(res, runId, await this.agent.subscribeAs(actor, runId));
+    const cursor = parseCursor(after) ?? parseCursor(req.headers["last-event-id"]) ?? 0;
+    await this.pipe(res, runId, await this.agent.subscribeAs(actor, runId), void 0, cursor);
   }
   async cancel(req, runId) {
     const actor = await this.actorResolver.resolve(req);
@@ -1284,7 +1399,15 @@ var ChatController = class {
       aborted: true
     };
   }
-  async pipe(res, runId, events, threadId) {
+  /**
+  * Every `data:` frame carries an SSE `id:` — its 1-based sequence number within the run. The
+  * number is a pure function of the run's buffered stream (every sink replays a run from its first
+  * chunk, in write order), so the same frame gets the same number on the POST that started the run
+  * and on any later `GET …/stream`, whichever replica serves it. A reconnecting client passes the
+  * last one it saw as `?after=`; frames at or below it are read off the sink but not re-sent.
+  * `meta`, `done` and `error` carry no id: `meta` is re-sent on every attach, the terminals once.
+  */
+  async pipe(res, runId, events, threadId, after = 0) {
     res.setHeader("Content-Type", "text/event-stream");
     res.setHeader("Cache-Control", "no-cache");
     res.setHeader("Connection", "keep-alive");
@@ -1301,6 +1424,16 @@ data: ${JSON.stringify({
 `);
     const decoder = new TextDecoder();
     let buffer = "";
+    let seq = 0;
+    const forward = /* @__PURE__ */ __name((line) => {
+      seq += 1;
+      if (seq > after) {
+        res.write(`id: ${seq}
+data: ${line}
+
+`);
+      }
+    }, "forward");
     try {
       for await (const chunk of events) {
         buffer += decoder.decode(chunk, {
@@ -1311,17 +1444,13 @@ data: ${JSON.stringify({
           const line = buffer.slice(0, newline);
           buffer = buffer.slice(newline + 1);
           if (line.length > 0) {
-            res.write(`data: ${line}
-
-`);
+            forward(line);
           }
           newline = buffer.indexOf("\n");
         }
       }
       if (buffer.length > 0) {
-        res.write(`data: ${buffer}
-
-`);
+        forward(buffer);
       }
       res.write("event: done\ndata: {}\n\n");
     } catch (error) {
@@ -1358,11 +1487,13 @@ _ts_decorate6([
   _ts_param5(0, (0, import_common6.Req)()),
   _ts_param5(1, (0, import_common6.Param)("runId")),
   _ts_param5(2, (0, import_common6.Res)()),
+  _ts_param5(3, (0, import_common6.Query)("after")),
   _ts_metadata6("design:type", Function),
   _ts_metadata6("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
-    typeof Response === "undefined" ? Object : Response
+    typeof Response === "undefined" ? Object : Response,
+    String
   ]),
   _ts_metadata6("design:returntype", Promise)
 ], ChatController.prototype, "stream", null);
@@ -1386,6 +1517,15 @@ ChatController = _ts_decorate6([
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ChatController);
+function parseCursor(raw) {
+  const value = Array.isArray(raw) ? raw[0] : raw;
+  if (typeof value !== "string" || !/^\d+$/.test(value.trim())) {
+    return void 0;
+  }
+  const parsed = Number(value.trim());
+  return Number.isSafeInteger(parsed) ? parsed : void 0;
+}
+__name(parseCursor, "parseCursor");
 
 // src/controller/memories.controller.ts
 var import_nestjs_agent_core7 = require("@dudousxd/nestjs-agent-core");
@@ -1522,7 +1662,7 @@ MemoriesController = _ts_decorate7([
   ])
 ], MemoriesController);
 
-// src/controller/quota.controller.ts
+// src/controller/messages.controller.ts
 var import_nestjs_agent_core8 = require("@dudousxd/nestjs-agent-core");
 var import_common8 = require("@nestjs/common");
 function _ts_decorate8(decorators, target, key, desc) {
@@ -1551,9 +1691,9 @@ function _ts_param7(paramIndex, decorator) {
   };
 }
 __name(_ts_param7, "_ts_param");
-var QuotaController = class {
+var MessagesController = class {
   static {
-    __name(this, "QuotaController");
+    __name(this, "MessagesController");
   }
   agent;
   actorResolver;
@@ -1561,31 +1701,48 @@ var QuotaController = class {
     this.agent = agent;
     this.actorResolver = actorResolver;
   }
-  async today(req) {
+  /**
+  * Rate a message: `{ value: 'up' | 'down' | null, comment? }`. Answers the stored rating
+  * (`{ feedback: null }` once cleared). Only the thread's owner may rate its messages.
+  */
+  async feedback(req, id, body) {
     const actor = await this.actorResolver.resolve(req);
-    return this.agent.quotaToday(actor.id);
+    const feedback = await this.agent.setMessageFeedback(actor, id, {
+      value: body?.value ?? null,
+      ...body?.comment !== void 0 ? {
+        comment: body.comment
+      } : {}
+    });
+    return {
+      feedback
+    };
   }
 };
 _ts_decorate8([
-  (0, import_common8.Get)("today"),
+  (0, import_common8.Post)(":id/feedback"),
+  (0, import_common8.HttpCode)(200),
   _ts_param7(0, (0, import_common8.Req)()),
+  _ts_param7(1, (0, import_common8.Param)("id")),
+  _ts_param7(2, (0, import_common8.Body)()),
   _ts_metadata8("design:type", Function),
   _ts_metadata8("design:paramtypes", [
-    typeof Request === "undefined" ? Object : Request
+    typeof Request === "undefined" ? Object : Request,
+    String,
+    typeof FeedbackBody === "undefined" ? Object : FeedbackBody
   ]),
   _ts_metadata8("design:returntype", Promise)
-], QuotaController.prototype, "today", null);
-QuotaController = _ts_decorate8([
-  (0, import_common8.Controller)("quota"),
+], MessagesController.prototype, "feedback", null);
+MessagesController = _ts_decorate8([
+  (0, import_common8.Controller)("messages"),
   _ts_param7(1, (0, import_common8.Inject)(import_nestjs_agent_core8.AGENT_ACTOR_RESOLVER)),
   _ts_metadata8("design:type", Function),
   _ts_metadata8("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
-], QuotaController);
+], MessagesController);
 
-// src/controller/skills.controller.ts
+// src/controller/models.controller.ts
 var import_nestjs_agent_core9 = require("@dudousxd/nestjs-agent-core");
 var import_common9 = require("@nestjs/common");
 function _ts_decorate9(decorators, target, key, desc) {
@@ -1614,6 +1771,138 @@ function _ts_param8(paramIndex, decorator) {
   };
 }
 __name(_ts_param8, "_ts_param");
+var ModelsController = class {
+  static {
+    __name(this, "ModelsController");
+  }
+  agent;
+  actorResolver;
+  constructor(agent, actorResolver) {
+    this.agent = agent;
+    this.actorResolver = actorResolver;
+  }
+  /**
+  * The models the caller may pick for `agent` (the default agent when omitted), grouped by
+  * provider, with badges and availability — the bound `ModelCatalog`'s answer, or an empty one.
+  */
+  async list(req, agent) {
+    const actor = await this.actorResolver.resolve(req);
+    return this.agent.listModels(actor, agent);
+  }
+};
+_ts_decorate9([
+  (0, import_common9.Get)(),
+  _ts_param8(0, (0, import_common9.Req)()),
+  _ts_param8(1, (0, import_common9.Query)("agent")),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", [
+    typeof Request === "undefined" ? Object : Request,
+    String
+  ]),
+  _ts_metadata9("design:returntype", Promise)
+], ModelsController.prototype, "list", null);
+ModelsController = _ts_decorate9([
+  (0, import_common9.Controller)("models"),
+  _ts_param8(1, (0, import_common9.Inject)(import_nestjs_agent_core9.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", [
+    typeof AgentService === "undefined" ? Object : AgentService,
+    typeof ActorResolver === "undefined" ? Object : ActorResolver
+  ])
+], ModelsController);
+
+// src/controller/quota.controller.ts
+var import_nestjs_agent_core10 = 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_decorate10, "_ts_decorate");
+function _ts_metadata10(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
+}
+__name(_ts_metadata10, "_ts_metadata");
+function _ts_param9(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param9, "_ts_param");
+var QuotaController = class {
+  static {
+    __name(this, "QuotaController");
+  }
+  agent;
+  actorResolver;
+  constructor(agent, actorResolver) {
+    this.agent = agent;
+    this.actorResolver = actorResolver;
+  }
+  async today(req) {
+    const actor = await this.actorResolver.resolve(req);
+    return this.agent.quotaToday(actor.id);
+  }
+};
+_ts_decorate10([
+  (0, import_common10.Get)("today"),
+  _ts_param9(0, (0, import_common10.Req)()),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
+    typeof Request === "undefined" ? Object : Request
+  ]),
+  _ts_metadata10("design:returntype", Promise)
+], QuotaController.prototype, "today", null);
+QuotaController = _ts_decorate10([
+  (0, import_common10.Controller)("quota"),
+  _ts_param9(1, (0, import_common10.Inject)(import_nestjs_agent_core10.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
+    typeof AgentService === "undefined" ? Object : AgentService,
+    typeof ActorResolver === "undefined" ? Object : ActorResolver
+  ])
+], QuotaController);
+
+// src/controller/skills.controller.ts
+var import_nestjs_agent_core11 = require("@dudousxd/nestjs-agent-core");
+var import_common11 = require("@nestjs/common");
+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_decorate11, "_ts_decorate");
+function _ts_metadata11(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
+}
+__name(_ts_metadata11, "_ts_metadata");
+function _ts_param10(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param10, "_ts_param");
 var SkillsController = class {
   static {
     __name(this, "SkillsController");
@@ -1629,40 +1918,40 @@ var SkillsController = class {
       return [];
     }
     const actor = await this.actorResolver.resolve(req);
-    const offer = await (0, import_nestjs_agent_core9.offerSkills)(this.skills, {
+    const offer = await (0, import_nestjs_agent_core11.offerSkills)(this.skills, {
       actor,
       threadId: threadId ?? ""
     });
     return offer.entries;
   }
 };
-_ts_decorate9([
-  (0, import_common9.Get)(),
-  _ts_param8(0, (0, import_common9.Req)()),
-  _ts_param8(1, (0, import_common9.Query)("threadId")),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+_ts_decorate11([
+  (0, import_common11.Get)(),
+  _ts_param10(0, (0, import_common11.Req)()),
+  _ts_param10(1, (0, import_common11.Query)("threadId")),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata9("design:returntype", Promise)
+  _ts_metadata11("design:returntype", Promise)
 ], SkillsController.prototype, "list", null);
-SkillsController = _ts_decorate9([
-  (0, import_common9.Controller)("skills"),
-  _ts_param8(0, (0, import_common9.Inject)(import_nestjs_agent_core9.AGENT_ACTOR_RESOLVER)),
-  _ts_param8(1, (0, import_common9.Optional)()),
-  _ts_param8(1, (0, import_common9.Inject)(import_nestjs_agent_core9.AGENT_SKILLS)),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+SkillsController = _ts_decorate11([
+  (0, import_common11.Controller)("skills"),
+  _ts_param10(0, (0, import_common11.Inject)(import_nestjs_agent_core11.AGENT_ACTOR_RESOLVER)),
+  _ts_param10(1, (0, import_common11.Optional)()),
+  _ts_param10(1, (0, import_common11.Inject)(import_nestjs_agent_core11.AGENT_SKILLS)),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     Object
   ])
 ], SkillsController);
 
 // src/controller/threads.controller.ts
-var import_nestjs_agent_core10 = require("@dudousxd/nestjs-agent-core");
-var import_common10 = require("@nestjs/common");
-function _ts_decorate10(decorators, target, key, desc) {
+var import_nestjs_agent_core12 = require("@dudousxd/nestjs-agent-core");
+var import_common12 = require("@nestjs/common");
+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);
@@ -1675,19 +1964,19 @@ function _ts_decorate10(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate10, "_ts_decorate");
-function _ts_metadata10(metadataKey, metadataValue) {
+__name(_ts_decorate12, "_ts_decorate");
+function _ts_metadata12(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata10, "_ts_metadata");
-function _ts_param9(paramIndex, decorator) {
+__name(_ts_metadata12, "_ts_metadata");
+function _ts_param11(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param9, "_ts_param");
+__name(_ts_param11, "_ts_param");
 var ThreadsController = class {
   static {
     __name(this, "ThreadsController");
@@ -1730,6 +2019,9 @@ var ThreadsController = class {
       } : {},
       ..."defaultAgent" in body ? {
         defaultAgent: body.defaultAgent ?? null
+      } : {},
+      ..."model" in body ? {
+        model: body.model ?? null
       } : {}
     });
     return {
@@ -1751,101 +2043,101 @@ var ThreadsController = class {
     };
   }
 };
-_ts_decorate10([
-  (0, import_common10.Get)(),
-  _ts_param9(0, (0, import_common10.Req)()),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+_ts_decorate12([
+  (0, import_common12.Get)(),
+  _ts_param11(0, (0, import_common12.Req)()),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata10("design:returntype", Promise)
+  _ts_metadata12("design:returntype", Promise)
 ], ThreadsController.prototype, "list", null);
-_ts_decorate10([
-  (0, import_common10.Get)(":id"),
-  _ts_param9(0, (0, import_common10.Req)()),
-  _ts_param9(1, (0, import_common10.Param)("id")),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+_ts_decorate12([
+  (0, import_common12.Get)(":id"),
+  _ts_param11(0, (0, import_common12.Req)()),
+  _ts_param11(1, (0, import_common12.Param)("id")),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata10("design:returntype", Promise)
+  _ts_metadata12("design:returntype", Promise)
 ], ThreadsController.prototype, "detail", null);
-_ts_decorate10([
-  (0, import_common10.Delete)(":id"),
-  _ts_param9(0, (0, import_common10.Req)()),
-  _ts_param9(1, (0, import_common10.Param)("id")),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+_ts_decorate12([
+  (0, import_common12.Delete)(":id"),
+  _ts_param11(0, (0, import_common12.Req)()),
+  _ts_param11(1, (0, import_common12.Param)("id")),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata10("design:returntype", Promise)
+  _ts_metadata12("design:returntype", Promise)
 ], ThreadsController.prototype, "remove", null);
-_ts_decorate10([
-  (0, import_common10.Post)(":id/fork-from/:messageId"),
-  _ts_param9(0, (0, import_common10.Req)()),
-  _ts_param9(1, (0, import_common10.Param)("id")),
-  _ts_param9(2, (0, import_common10.Param)("messageId")),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+_ts_decorate12([
+  (0, import_common12.Post)(":id/fork-from/:messageId"),
+  _ts_param11(0, (0, import_common12.Req)()),
+  _ts_param11(1, (0, import_common12.Param)("id")),
+  _ts_param11(2, (0, import_common12.Param)("messageId")),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     String
   ]),
-  _ts_metadata10("design:returntype", Promise)
+  _ts_metadata12("design:returntype", Promise)
 ], ThreadsController.prototype, "fork", null);
-_ts_decorate10([
-  (0, import_common10.Patch)(":id"),
-  _ts_param9(0, (0, import_common10.Req)()),
-  _ts_param9(1, (0, import_common10.Param)("id")),
-  _ts_param9(2, (0, import_common10.Body)()),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+_ts_decorate12([
+  (0, import_common12.Patch)(":id"),
+  _ts_param11(0, (0, import_common12.Req)()),
+  _ts_param11(1, (0, import_common12.Param)("id")),
+  _ts_param11(2, (0, import_common12.Body)()),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     typeof UpdateThreadBody === "undefined" ? Object : UpdateThreadBody
   ]),
-  _ts_metadata10("design:returntype", Promise)
+  _ts_metadata12("design:returntype", Promise)
 ], ThreadsController.prototype, "update", null);
-_ts_decorate10([
-  (0, import_common10.Post)(":id/promote"),
-  _ts_param9(0, (0, import_common10.Req)()),
-  _ts_param9(1, (0, import_common10.Param)("id")),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+_ts_decorate12([
+  (0, import_common12.Post)(":id/promote"),
+  _ts_param11(0, (0, import_common12.Req)()),
+  _ts_param11(1, (0, import_common12.Param)("id")),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata10("design:returntype", Promise)
+  _ts_metadata12("design:returntype", Promise)
 ], ThreadsController.prototype, "promote", null);
-_ts_decorate10([
-  (0, import_common10.Delete)(":id/from/:messageId"),
-  _ts_param9(0, (0, import_common10.Req)()),
-  _ts_param9(1, (0, import_common10.Param)("id")),
-  _ts_param9(2, (0, import_common10.Param)("messageId")),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+_ts_decorate12([
+  (0, import_common12.Delete)(":id/from/:messageId"),
+  _ts_param11(0, (0, import_common12.Req)()),
+  _ts_param11(1, (0, import_common12.Param)("id")),
+  _ts_param11(2, (0, import_common12.Param)("messageId")),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     String
   ]),
-  _ts_metadata10("design:returntype", Promise)
+  _ts_metadata12("design:returntype", Promise)
 ], ThreadsController.prototype, "truncateFrom", null);
-ThreadsController = _ts_decorate10([
-  (0, import_common10.Controller)("threads"),
-  _ts_param9(1, (0, import_common10.Inject)(import_nestjs_agent_core10.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+ThreadsController = _ts_decorate12([
+  (0, import_common12.Controller)("threads"),
+  _ts_param11(1, (0, import_common12.Inject)(import_nestjs_agent_core12.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ThreadsController);
 
 // src/controller/tool-call.controller.ts
-var import_nestjs_agent_core11 = require("@dudousxd/nestjs-agent-core");
-var import_common11 = require("@nestjs/common");
-function _ts_decorate11(decorators, target, key, desc) {
+var import_nestjs_agent_core13 = require("@dudousxd/nestjs-agent-core");
+var import_common13 = require("@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);
@@ -1858,19 +2150,19 @@ function _ts_decorate11(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate11, "_ts_decorate");
-function _ts_metadata11(metadataKey, metadataValue) {
+__name(_ts_decorate13, "_ts_decorate");
+function _ts_metadata13(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata11, "_ts_metadata");
-function _ts_param10(paramIndex, decorator) {
+__name(_ts_metadata13, "_ts_metadata");
+function _ts_param12(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param10, "_ts_param");
+__name(_ts_param12, "_ts_param");
 var MAX_ANSWERED_QUESTIONS = 100;
 var MAX_VALUES_PER_QUESTION = 100;
 var MAX_ANSWER_VALUE_LENGTH = 4096;
@@ -1879,7 +2171,7 @@ var MAX_VIA_LENGTH = 64;
 var DEFAULT_VIA = "web";
 function toolCallId(claimed) {
   if (typeof claimed !== "string" || claimed.length === 0) {
-    throw new import_common11.BadRequestException("toolCallId must be a non-empty string");
+    throw new import_common13.BadRequestException("toolCallId must be a non-empty string");
   }
   return claimed;
 }
@@ -1889,10 +2181,10 @@ function rejectReason(claimed) {
     return void 0;
   }
   if (typeof claimed !== "string") {
-    throw new import_common11.BadRequestException("reason must be a string");
+    throw new import_common13.BadRequestException("reason must be a string");
   }
   if (claimed.length > MAX_REJECT_REASON_LENGTH) {
-    throw new import_common11.BadRequestException(`reason must be at most ${MAX_REJECT_REASON_LENGTH} characters`);
+    throw new import_common13.BadRequestException(`reason must be at most ${MAX_REJECT_REASON_LENGTH} characters`);
   }
   return claimed;
 }
@@ -1902,7 +2194,7 @@ function remember(claimed) {
     return false;
   }
   if (typeof claimed !== "boolean") {
-    throw new import_common11.BadRequestException("remember must be a boolean");
+    throw new import_common13.BadRequestException("remember must be a boolean");
   }
   return claimed;
 }
@@ -1912,7 +2204,7 @@ function via(claimed) {
     return DEFAULT_VIA;
   }
   if (typeof claimed !== "string" || claimed.length === 0 || claimed.length > MAX_VIA_LENGTH) {
-    throw new import_common11.BadRequestException(`via must be a string of 1-${MAX_VIA_LENGTH} characters`);
+    throw new import_common13.BadRequestException(`via must be a string of 1-${MAX_VIA_LENGTH} characters`);
   }
   return claimed;
 }
@@ -1922,26 +2214,26 @@ function answers(claimed) {
     return void 0;
   }
   if (typeof claimed !== "object" || claimed === null || Array.isArray(claimed)) {
-    throw new import_common11.BadRequestException("answers must be an object of questionId \u2192 chosen values");
+    throw new import_common13.BadRequestException("answers must be an object of questionId \u2192 chosen values");
   }
   const entries = Object.entries(claimed);
   if (entries.length > MAX_ANSWERED_QUESTIONS) {
-    throw new import_common11.BadRequestException(`answers may cover at most ${MAX_ANSWERED_QUESTIONS} questions`);
+    throw new import_common13.BadRequestException(`answers may cover at most ${MAX_ANSWERED_QUESTIONS} questions`);
   }
   const validated = /* @__PURE__ */ Object.create(null);
   for (const [questionId, values] of entries) {
     if (!Array.isArray(values)) {
-      throw new import_common11.BadRequestException(`answers["${questionId}"] must be an array of chosen values`);
+      throw new import_common13.BadRequestException(`answers["${questionId}"] must be an array of chosen values`);
     }
     if (values.length > MAX_VALUES_PER_QUESTION) {
-      throw new import_common11.BadRequestException(`answers["${questionId}"] may carry at most ${MAX_VALUES_PER_QUESTION} values`);
+      throw new import_common13.BadRequestException(`answers["${questionId}"] may carry at most ${MAX_VALUES_PER_QUESTION} values`);
     }
     for (const value of values) {
       if (typeof value !== "string") {
-        throw new import_common11.BadRequestException(`answers["${questionId}"] must contain only strings`);
+        throw new import_common13.BadRequestException(`answers["${questionId}"] must contain only strings`);
       }
       if (value.length > MAX_ANSWER_VALUE_LENGTH) {
-        throw new import_common11.BadRequestException(`answers["${questionId}"] values must be at most ${MAX_ANSWER_VALUE_LENGTH} characters`);
+        throw new import_common13.BadRequestException(`answers["${questionId}"] values must be at most ${MAX_ANSWER_VALUE_LENGTH} characters`);
       }
     }
     validated[questionId] = values;
@@ -1999,64 +2291,64 @@ var ToolCallController = class {
     };
   }
 };
-_ts_decorate11([
-  (0, import_common11.Post)("approve"),
-  _ts_param10(0, (0, import_common11.Req)()),
-  _ts_param10(1, (0, import_common11.Body)()),
-  _ts_metadata11("design:type", Function),
-  _ts_metadata11("design:paramtypes", [
+_ts_decorate13([
+  (0, import_common13.Post)("approve"),
+  _ts_param12(0, (0, import_common13.Req)()),
+  _ts_param12(1, (0, import_common13.Body)()),
+  _ts_metadata13("design:type", Function),
+  _ts_metadata13("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof ApproveBody === "undefined" ? Object : ApproveBody
   ]),
-  _ts_metadata11("design:returntype", Promise)
+  _ts_metadata13("design:returntype", Promise)
 ], ToolCallController.prototype, "approve", null);
-_ts_decorate11([
-  (0, import_common11.Post)("reject"),
-  _ts_param10(0, (0, import_common11.Req)()),
-  _ts_param10(1, (0, import_common11.Body)()),
-  _ts_metadata11("design:type", Function),
-  _ts_metadata11("design:paramtypes", [
+_ts_decorate13([
+  (0, import_common13.Post)("reject"),
+  _ts_param12(0, (0, import_common13.Req)()),
+  _ts_param12(1, (0, import_common13.Body)()),
+  _ts_metadata13("design:type", Function),
+  _ts_metadata13("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof RejectBody === "undefined" ? Object : RejectBody
   ]),
-  _ts_metadata11("design:returntype", Promise)
+  _ts_metadata13("design:returntype", Promise)
 ], ToolCallController.prototype, "reject", null);
-_ts_decorate11([
-  (0, import_common11.Post)("answer"),
-  _ts_param10(0, (0, import_common11.Req)()),
-  _ts_param10(1, (0, import_common11.Body)()),
-  _ts_metadata11("design:type", Function),
-  _ts_metadata11("design:paramtypes", [
+_ts_decorate13([
+  (0, import_common13.Post)("answer"),
+  _ts_param12(0, (0, import_common13.Req)()),
+  _ts_param12(1, (0, import_common13.Body)()),
+  _ts_metadata13("design:type", Function),
+  _ts_metadata13("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof AnswerBody === "undefined" ? Object : AnswerBody
   ]),
-  _ts_metadata11("design:returntype", Promise)
+  _ts_metadata13("design:returntype", Promise)
 ], ToolCallController.prototype, "answer", null);
-_ts_decorate11([
-  (0, import_common11.Post)("skip"),
-  _ts_param10(0, (0, import_common11.Req)()),
-  _ts_param10(1, (0, import_common11.Body)()),
-  _ts_metadata11("design:type", Function),
-  _ts_metadata11("design:paramtypes", [
+_ts_decorate13([
+  (0, import_common13.Post)("skip"),
+  _ts_param12(0, (0, import_common13.Req)()),
+  _ts_param12(1, (0, import_common13.Body)()),
+  _ts_metadata13("design:type", Function),
+  _ts_metadata13("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     Object
   ]),
-  _ts_metadata11("design:returntype", Promise)
+  _ts_metadata13("design:returntype", Promise)
 ], ToolCallController.prototype, "skip", null);
-ToolCallController = _ts_decorate11([
-  (0, import_common11.Controller)("tool-call"),
-  _ts_param10(1, (0, import_common11.Inject)(import_nestjs_agent_core11.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata11("design:type", Function),
-  _ts_metadata11("design:paramtypes", [
+ToolCallController = _ts_decorate13([
+  (0, import_common13.Controller)("tool-call"),
+  _ts_param12(1, (0, import_common13.Inject)(import_nestjs_agent_core13.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata13("design:type", Function),
+  _ts_metadata13("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ToolCallController);
 
 // src/controller/tools.controller.ts
-var import_nestjs_agent_core12 = require("@dudousxd/nestjs-agent-core");
-var import_common12 = require("@nestjs/common");
-function _ts_decorate12(decorators, target, key, desc) {
+var import_nestjs_agent_core14 = require("@dudousxd/nestjs-agent-core");
+var import_common14 = require("@nestjs/common");
+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);
@@ -2069,19 +2361,19 @@ function _ts_decorate12(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate12, "_ts_decorate");
-function _ts_metadata12(metadataKey, metadataValue) {
+__name(_ts_decorate14, "_ts_decorate");
+function _ts_metadata14(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata12, "_ts_metadata");
-function _ts_param11(paramIndex, decorator) {
+__name(_ts_metadata14, "_ts_metadata");
+function _ts_param13(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param11, "_ts_param");
+__name(_ts_param13, "_ts_param");
 var ToolsController = class {
   static {
     __name(this, "ToolsController");
@@ -2096,7 +2388,7 @@ var ToolsController = class {
   }
   async list(req, agent) {
     if (agent !== void 0 && this.agents.get(agent) === void 0) {
-      throw new import_common12.NotFoundException(`No agent named "${agent}"`);
+      throw new import_common14.NotFoundException(`No agent named "${agent}"`);
     }
     const actor = await this.actorResolver.resolve(req);
     const deps = this.depsFactory.forAgent(agent);
@@ -2110,33 +2402,33 @@ var ToolsController = class {
     }));
   }
 };
-_ts_decorate12([
-  (0, import_common12.Get)(),
-  _ts_param11(0, (0, import_common12.Req)()),
-  _ts_param11(1, (0, import_common12.Query)("agent")),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+_ts_decorate14([
+  (0, import_common14.Get)(),
+  _ts_param13(0, (0, import_common14.Req)()),
+  _ts_param13(1, (0, import_common14.Query)("agent")),
+  _ts_metadata14("design:type", Function),
+  _ts_metadata14("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata12("design:returntype", Promise)
+  _ts_metadata14("design:returntype", Promise)
 ], ToolsController.prototype, "list", null);
-ToolsController = _ts_decorate12([
-  (0, import_common12.Controller)("tools"),
-  _ts_param11(0, (0, import_common12.Inject)(import_nestjs_agent_core12.AGENT_ACTOR_RESOLVER)),
-  _ts_param11(1, (0, import_common12.Inject)(import_nestjs_agent_core12.AGENT_DEPS_FACTORY)),
-  _ts_param11(2, (0, import_common12.Inject)(import_nestjs_agent_core12.AGENT_REGISTRY)),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+ToolsController = _ts_decorate14([
+  (0, import_common14.Controller)("tools"),
+  _ts_param13(0, (0, import_common14.Inject)(import_nestjs_agent_core14.AGENT_ACTOR_RESOLVER)),
+  _ts_param13(1, (0, import_common14.Inject)(import_nestjs_agent_core14.AGENT_DEPS_FACTORY)),
+  _ts_param13(2, (0, import_common14.Inject)(import_nestjs_agent_core14.AGENT_REGISTRY)),
+  _ts_metadata14("design:type", Function),
+  _ts_metadata14("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
-    typeof import_nestjs_agent_core12.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core12.AgentRegistry
+    typeof import_nestjs_agent_core14.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core14.AgentRegistry
   ])
 ], ToolsController);
 
 // src/discovery/agent-discovery.service.ts
-var import_nestjs_agent_core13 = require("@dudousxd/nestjs-agent-core");
-var import_common13 = require("@nestjs/common");
+var import_nestjs_agent_core15 = require("@dudousxd/nestjs-agent-core");
+var import_common15 = require("@nestjs/common");
 var import_core = require("@nestjs/core");
 
 // src/decorator/agent.decorator.ts
@@ -2171,7 +2463,7 @@ function SystemPromptContributor() {
 __name(SystemPromptContributor, "SystemPromptContributor");
 
 // src/discovery/agent-discovery.service.ts
-function _ts_decorate13(decorators, target, key, desc) {
+function _ts_decorate15(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);
@@ -2184,19 +2476,19 @@ function _ts_decorate13(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate13, "_ts_decorate");
-function _ts_metadata13(metadataKey, metadataValue) {
+__name(_ts_decorate15, "_ts_decorate");
+function _ts_metadata15(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata13, "_ts_metadata");
-function _ts_param12(paramIndex, decorator) {
+__name(_ts_metadata15, "_ts_metadata");
+function _ts_param14(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param12, "_ts_param");
+__name(_ts_param14, "_ts_param");
 var AgentDiscoveryService = class _AgentDiscoveryService {
   static {
     __name(this, "AgentDiscoveryService");
@@ -2205,7 +2497,7 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
   scanner;
   registry;
   contributors;
-  logger = new import_common13.Logger(_AgentDiscoveryService.name);
+  logger = new import_common15.Logger(_AgentDiscoveryService.name);
   constructor(discovery, scanner, registry, contributors) {
     this.discovery = discovery;
     this.scanner = scanner;
@@ -2323,22 +2615,22 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
     return (ctx) => candidate.call(instance, ctx);
   }
 };
-AgentDiscoveryService = _ts_decorate13([
-  (0, import_common13.Injectable)(),
-  _ts_param12(2, (0, import_common13.Inject)(import_nestjs_agent_core13.AGENT_REGISTRY)),
-  _ts_param12(3, (0, import_common13.Inject)(import_nestjs_agent_core13.AGENT_PROMPT_CONTRIBUTORS)),
-  _ts_metadata13("design:type", Function),
-  _ts_metadata13("design:paramtypes", [
+AgentDiscoveryService = _ts_decorate15([
+  (0, import_common15.Injectable)(),
+  _ts_param14(2, (0, import_common15.Inject)(import_nestjs_agent_core15.AGENT_REGISTRY)),
+  _ts_param14(3, (0, import_common15.Inject)(import_nestjs_agent_core15.AGENT_PROMPT_CONTRIBUTORS)),
+  _ts_metadata15("design:type", Function),
+  _ts_metadata15("design:paramtypes", [
     typeof import_core.DiscoveryService === "undefined" ? Object : import_core.DiscoveryService,
     typeof import_core.MetadataScanner === "undefined" ? Object : import_core.MetadataScanner,
-    typeof import_nestjs_agent_core13.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core13.AgentRegistry,
+    typeof import_nestjs_agent_core15.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core15.AgentRegistry,
     Array
   ])
 ], AgentDiscoveryService);
 
 // src/discovery/ai-tool-discovery.service.ts
-var import_nestjs_agent_core14 = require("@dudousxd/nestjs-agent-core");
-var import_common14 = require("@nestjs/common");
+var import_nestjs_agent_core16 = require("@dudousxd/nestjs-agent-core");
+var import_common16 = require("@nestjs/common");
 var import_core2 = require("@nestjs/core");
 var import_zod = require("zod");
 
@@ -2387,7 +2679,7 @@ function provideAgentTool(factoryOrTool, inject) {
 __name(provideAgentTool, "provideAgentTool");
 
 // src/discovery/ai-tool-discovery.service.ts
-function _ts_decorate14(decorators, target, key, desc) {
+function _ts_decorate16(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);
@@ -2400,19 +2692,19 @@ function _ts_decorate14(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate14, "_ts_decorate");
-function _ts_metadata14(metadataKey, metadataValue) {
+__name(_ts_decorate16, "_ts_decorate");
+function _ts_metadata16(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata14, "_ts_metadata");
-function _ts_param13(paramIndex, decorator) {
+__name(_ts_metadata16, "_ts_metadata");
+function _ts_param15(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param13, "_ts_param");
+__name(_ts_param15, "_ts_param");
 var AiToolDiscoveryService = class _AiToolDiscoveryService {
   static {
     __name(this, "AiToolDiscoveryService");
@@ -2421,7 +2713,7 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
   registry;
   agents;
   options;
-  logger = new import_common14.Logger(_AiToolDiscoveryService.name);
+  logger = new import_common16.Logger(_AiToolDiscoveryService.name);
   constructor(discovery, registry, agents, options) {
     this.discovery = discovery;
     this.registry = registry;
@@ -2495,7 +2787,7 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
     let delegates = 0;
     for (const definition of this.agents.list()) {
       for (const edge of definition.delegatesTo ?? []) {
-        const { agent: target, detached } = (0, import_nestjs_agent_core14.normalizeDelegation)(edge);
+        const { agent: target, detached } = (0, import_nestjs_agent_core16.normalizeDelegation)(edge);
         const targetDefinition = this.agents.get(target);
         if (targetDefinition === void 0) {
           throw new Error(`Agent "${definition.name}" hands off to "${target}", which is not a registered @Agent. Declare it as an @Agent provider or fix the reference.`);
@@ -2545,13 +2837,13 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
     return true;
   }
 };
-AiToolDiscoveryService = _ts_decorate14([
-  (0, import_common14.Injectable)(),
-  _ts_param13(1, (0, import_common14.Inject)(import_nestjs_agent_core14.AGENT_TOOL_REGISTRY)),
-  _ts_param13(2, (0, import_common14.Inject)(import_nestjs_agent_core14.AGENT_REGISTRY)),
-  _ts_param13(3, (0, import_common14.Inject)(import_nestjs_agent_core14.AGENT_OPTIONS)),
-  _ts_metadata14("design:type", Function),
-  _ts_metadata14("design:paramtypes", [
+AiToolDiscoveryService = _ts_decorate16([
+  (0, import_common16.Injectable)(),
+  _ts_param15(1, (0, import_common16.Inject)(import_nestjs_agent_core16.AGENT_TOOL_REGISTRY)),
+  _ts_param15(2, (0, import_common16.Inject)(import_nestjs_agent_core16.AGENT_REGISTRY)),
+  _ts_param15(3, (0, import_common16.Inject)(import_nestjs_agent_core16.AGENT_OPTIONS)),
+  _ts_metadata16("design:type", Function),
+  _ts_metadata16("design:paramtypes", [
     typeof import_core2.DiscoveryService === "undefined" ? Object : import_core2.DiscoveryService,
     typeof ToolRegistry === "undefined" ? Object : ToolRegistry,
     typeof AgentRegistry === "undefined" ? Object : AgentRegistry,
@@ -2560,13 +2852,13 @@ AiToolDiscoveryService = _ts_decorate14([
 ], AiToolDiscoveryService);
 
 // src/discovery/skill-discovery.service.ts
-var import_nestjs_agent_core16 = require("@dudousxd/nestjs-agent-core");
-var import_common15 = require("@nestjs/common");
+var import_nestjs_agent_core18 = require("@dudousxd/nestjs-agent-core");
+var import_common17 = require("@nestjs/common");
 var import_core3 = require("@nestjs/core");
 
 // src/decorator/skill.decorator.ts
 var import_reflect_metadata4 = require("reflect-metadata");
-var import_nestjs_agent_core15 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core17 = require("@dudousxd/nestjs-agent-core");
 var SKILL_METADATA = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:skill-metadata");
 function Skill(options) {
   return (target) => {
@@ -2579,12 +2871,12 @@ function readSkillMetadata(target) {
 }
 __name(readSkillMetadata, "readSkillMetadata");
 function skillScope(options) {
-  return options.scope ?? import_nestjs_agent_core15.GLOBAL_SCOPE;
+  return options.scope ?? import_nestjs_agent_core17.GLOBAL_SCOPE;
 }
 __name(skillScope, "skillScope");
 
 // src/discovery/skill-discovery.service.ts
-function _ts_decorate15(decorators, target, key, desc) {
+function _ts_decorate17(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);
@@ -2597,26 +2889,26 @@ function _ts_decorate15(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate15, "_ts_decorate");
-function _ts_metadata15(metadataKey, metadataValue) {
+__name(_ts_decorate17, "_ts_decorate");
+function _ts_metadata17(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata15, "_ts_metadata");
-function _ts_param14(paramIndex, decorator) {
+__name(_ts_metadata17, "_ts_metadata");
+function _ts_param16(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param14, "_ts_param");
+__name(_ts_param16, "_ts_param");
 var SkillDiscoveryService = class _SkillDiscoveryService {
   static {
     __name(this, "SkillDiscoveryService");
   }
   discovery;
   declared;
-  logger = new import_common15.Logger(_SkillDiscoveryService.name);
+  logger = new import_common17.Logger(_SkillDiscoveryService.name);
   constructor(discovery, declared) {
     this.discovery = discovery;
     this.declared = declared;
@@ -2653,18 +2945,18 @@ var SkillDiscoveryService = class _SkillDiscoveryService {
     return flat === void 0 ? void 0 : () => flat;
   }
 };
-SkillDiscoveryService = _ts_decorate15([
-  (0, import_common15.Injectable)(),
-  _ts_param14(1, (0, import_common15.Inject)(import_nestjs_agent_core16.AGENT_SKILL_SOURCES)),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+SkillDiscoveryService = _ts_decorate17([
+  (0, import_common17.Injectable)(),
+  _ts_param16(1, (0, import_common17.Inject)(import_nestjs_agent_core18.AGENT_SKILL_SOURCES)),
+  _ts_metadata17("design:type", Function),
+  _ts_metadata17("design:paramtypes", [
     typeof import_core3.DiscoveryService === "undefined" ? Object : import_core3.DiscoveryService,
     Array
   ])
 ], SkillDiscoveryService);
 
 // src/in-process-sink.ts
-var import_nestjs_agent_core17 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core19 = require("@dudousxd/nestjs-agent-core");
 var InProcessTokenStreamSink = class {
   static {
     __name(this, "InProcessTokenStreamSink");
@@ -2719,7 +3011,7 @@ var InProcessTokenStreamSink = class {
       }
       if (buf.ended) {
         if (buf.failure !== void 0) {
-          throw new import_nestjs_agent_core17.AgentStreamError(buf.failure);
+          throw new import_nestjs_agent_core19.AgentStreamError(buf.failure);
         }
         return;
       }
@@ -2755,9 +3047,9 @@ var LedgerQuotaStore = class {
 };
 
 // src/runner/inline-agent-runner.ts
-var import_nestjs_agent_core18 = require("@dudousxd/nestjs-agent-core");
-var import_common16 = require("@nestjs/common");
-function _ts_decorate16(decorators, target, key, desc) {
+var import_nestjs_agent_core20 = require("@dudousxd/nestjs-agent-core");
+var import_common18 = require("@nestjs/common");
+function _ts_decorate18(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);
@@ -2770,26 +3062,26 @@ function _ts_decorate16(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate16, "_ts_decorate");
-function _ts_metadata16(metadataKey, metadataValue) {
+__name(_ts_decorate18, "_ts_decorate");
+function _ts_metadata18(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata16, "_ts_metadata");
-function _ts_param15(paramIndex, decorator) {
+__name(_ts_metadata18, "_ts_metadata");
+function _ts_param17(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param15, "_ts_param");
+__name(_ts_param17, "_ts_param");
 var InlineAgentRunner = class _InlineAgentRunner {
   static {
     __name(this, "InlineAgentRunner");
   }
   factory;
   store;
-  logger = new import_common16.Logger(_InlineAgentRunner.name);
+  logger = new import_common18.Logger(_InlineAgentRunner.name);
   pending = /* @__PURE__ */ new Map();
   /**
   * Runs someone has asked to stop. In-process, like `pending`, and for the same reason: this runner
@@ -2818,18 +3110,18 @@ var InlineAgentRunner = class _InlineAgentRunner {
         ] : []
       ]
     });
-    void (0, import_nestjs_agent_core18.runAgentLoop)({
+    void (0, import_nestjs_agent_core20.runAgentLoop)({
       ...deps,
       day
     }, input, hooks).then(() => this.store.setActiveStream(input.threadId, null)).catch(async (error) => {
-      if (error instanceof import_nestjs_agent_core18.RunCancelledError) {
+      if (error instanceof import_nestjs_agent_core20.RunCancelledError) {
         await this.settleCancelled(runId, input.threadId, deps);
         return;
       }
       const message = error instanceof Error ? error.message : String(error);
-      const code = (0, import_nestjs_agent_core18.agentFailureCode)(error);
+      const code = (0, import_nestjs_agent_core20.agentFailureCode)(error);
       this.logger.error(`agent run ${runId} failed (${code}): ${message}`);
-      (0, import_nestjs_agent_core18.publishAgentRunFailed)({
+      (0, import_nestjs_agent_core20.publishAgentRunFailed)({
         runId,
         code,
         message
@@ -2878,7 +3170,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
     for (const [key, waiter] of this.pending) {
       if (key.startsWith(`${runId}:`)) {
         this.pending.delete(key);
-        waiter.reject(new import_nestjs_agent_core18.RunCancelledError());
+        waiter.reject(new import_nestjs_agent_core20.RunCancelledError());
       }
     }
     await Promise.resolve();
@@ -2893,7 +3185,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
     this.logger.log(`agent run ${runId} cancelled`);
     await this.store.setActiveStream(threadId, null);
     const writer = await deps.sink.open(runId);
-    await writer.write((0, import_nestjs_agent_core18.encodeStreamEvent)({
+    await writer.write((0, import_nestjs_agent_core20.encodeStreamEvent)({
       kind: "cancelled"
     }));
     await writer.end();
@@ -2954,7 +3246,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
       awaitApproval: /* @__PURE__ */ __name((call, _ctx, opts) => this.parkApproval(runId, call.id, opts?.timeoutMs), "awaitApproval"),
       awaitAnswers: /* @__PURE__ */ __name((request) => this.park(runId, request.id), "awaitAnswers"),
       step: /* @__PURE__ */ __name((_name, fn) => fn(), "step"),
-      parallel: import_nestjs_agent_core18.settleAll,
+      parallel: import_nestjs_agent_core20.settleAll,
       cancelled: /* @__PURE__ */ __name(async () => this.cancelled.has(runId), "cancelled"),
       runAgent: /* @__PURE__ */ __name((agentName, task) => this.runNested({
         agentName,
@@ -3005,7 +3297,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
       awaitApproval: /* @__PURE__ */ __name((call, _ctx, opts) => this.parkApproval(runId, call.id, opts?.timeoutMs), "awaitApproval"),
       awaitAnswers: /* @__PURE__ */ __name((request) => this.park(runId, request.id), "awaitAnswers"),
       step: /* @__PURE__ */ __name((_name, fn) => fn(), "step"),
-      parallel: import_nestjs_agent_core18.settleAll,
+      parallel: import_nestjs_agent_core20.settleAll,
       cancelled: /* @__PURE__ */ __name(async () => this.cancelled.has(runId), "cancelled"),
       runAgent: /* @__PURE__ */ __name((childName, childTask) => this.runNested({
         agentName: childName,
@@ -3038,7 +3330,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
         }
       }), "startAgent")
     };
-    void (0, import_nestjs_agent_core18.runAgentLoop)({
+    void (0, import_nestjs_agent_core20.runAgentLoop)({
       ...deps,
       day
     }, {
@@ -3052,13 +3344,13 @@ var InlineAgentRunner = class _InlineAgentRunner {
       parentRunId,
       deliverTo
     }, hooks).catch(async (error) => {
-      const cancelled = error instanceof import_nestjs_agent_core18.RunCancelledError;
+      const cancelled = error instanceof import_nestjs_agent_core20.RunCancelledError;
       const message = error instanceof Error ? error.message : String(error);
       if (!cancelled) {
         this.logger.error(`detached agent run ${runId} failed: ${message}`);
-        (0, import_nestjs_agent_core18.publishAgentRunFailed)({
+        (0, import_nestjs_agent_core20.publishAgentRunFailed)({
           runId,
-          code: (0, import_nestjs_agent_core18.agentFailureCode)(error),
+          code: (0, import_nestjs_agent_core20.agentFailureCode)(error),
           message
         });
       }
@@ -3066,11 +3358,11 @@ var InlineAgentRunner = class _InlineAgentRunner {
         runId,
         status: cancelled ? "cancelled" : "failed",
         ...cancelled ? {} : {
-          errorCode: (0, import_nestjs_agent_core18.agentFailureCode)(error),
+          errorCode: (0, import_nestjs_agent_core20.agentFailureCode)(error),
           errorMessage: message
         }
       });
-      await (0, import_nestjs_agent_core18.settleUnsettledDelegation)({
+      await (0, import_nestjs_agent_core20.settleUnsettledDelegation)({
         store: this.store,
         delivery: deliverTo,
         agent: agentName,
@@ -3109,7 +3401,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
       awaitApproval: /* @__PURE__ */ __name((call, _ctx, opts) => this.parkApproval(runId, call.id, opts?.timeoutMs), "awaitApproval"),
       awaitAnswers: /* @__PURE__ */ __name((request) => this.park(runId, request.id), "awaitAnswers"),
       step: /* @__PURE__ */ __name((_name, fn) => fn(), "step"),
-      parallel: import_nestjs_agent_core18.settleAll,
+      parallel: import_nestjs_agent_core20.settleAll,
       // A child stops when it is cancelled OR when the run a human is actually watching is: the
       // canceller names the top-level run, which is the only id that ever left the server.
       cancelled: /* @__PURE__ */ __name(async () => this.cancelled.has(runId) || this.cancelled.has(sinkRunId), "cancelled"),
@@ -3144,7 +3436,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
       }), "startAgent")
     };
     try {
-      return await (0, import_nestjs_agent_core18.runAgentLoop)({
+      return await (0, import_nestjs_agent_core20.runAgentLoop)({
         ...deps,
         day
       }, {
@@ -3163,19 +3455,19 @@ var InlineAgentRunner = class _InlineAgentRunner {
     }
   }
 };
-InlineAgentRunner = _ts_decorate16([
-  (0, import_common16.Injectable)(),
-  _ts_param15(0, (0, import_common16.Inject)(import_nestjs_agent_core18.AGENT_DEPS_FACTORY)),
-  _ts_param15(1, (0, import_common16.Inject)(import_nestjs_agent_core18.AGENT_STORE)),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+InlineAgentRunner = _ts_decorate18([
+  (0, import_common18.Injectable)(),
+  _ts_param17(0, (0, import_common18.Inject)(import_nestjs_agent_core20.AGENT_DEPS_FACTORY)),
+  _ts_param17(1, (0, import_common18.Inject)(import_nestjs_agent_core20.AGENT_STORE)),
+  _ts_metadata18("design:type", Function),
+  _ts_metadata18("design:paramtypes", [
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
     typeof AgentStore === "undefined" ? Object : AgentStore
   ])
 ], InlineAgentRunner);
 
 // src/skills-config.ts
-var import_nestjs_agent_core19 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core21 = require("@dudousxd/nestjs-agent-core");
 function declaredSkillProvider(declared) {
   return {
     list: /* @__PURE__ */ __name(({ scopes }) => declared.filter((skill) => scopes.includes(skill.scope)).map(({ name, description, scope }) => ({
@@ -3201,7 +3493,7 @@ function resolveSkillsConfig(options, declared) {
     declaredSkillProvider(declared)
   ];
   return {
-    provider: providers.length === 1 ? providers[0] : (0, import_nestjs_agent_core19.compositeSkillProvider)(providers),
+    provider: providers.length === 1 ? providers[0] : (0, import_nestjs_agent_core21.compositeSkillProvider)(providers),
     ...options.scopes !== void 0 ? {
       scopes: options.scopes
     } : {},
@@ -3213,7 +3505,7 @@ function resolveSkillsConfig(options, declared) {
 __name(resolveSkillsConfig, "resolveSkillsConfig");
 
 // src/agent.module.ts
-function _ts_decorate17(decorators, target, key, desc) {
+function _ts_decorate19(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);
@@ -3226,92 +3518,99 @@ function _ts_decorate17(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate17, "_ts_decorate");
+__name(_ts_decorate19, "_ts_decorate");
 var DEFAULT_PATH = "agent";
 function sharedProviders(durable, includeStore) {
   const providers = [
     {
-      provide: import_nestjs_agent_core20.AGENT_TOOL_REGISTRY,
-      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core20.ToolRegistry(), "useFactory")
+      provide: import_nestjs_agent_core22.AGENT_TOOL_REGISTRY,
+      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core22.ToolRegistry(), "useFactory")
     },
     // Starts empty; AgentDiscoveryService populates it from `@Agent`-decorated providers at boot.
     {
-      provide: import_nestjs_agent_core20.AGENT_REGISTRY,
-      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core20.AgentRegistry(), "useFactory")
+      provide: import_nestjs_agent_core22.AGENT_REGISTRY,
+      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core22.AgentRegistry(), "useFactory")
     },
     // A shared, mutable list AgentDiscoveryService fills with `@SystemPromptContributor()` methods.
     {
-      provide: import_nestjs_agent_core20.AGENT_PROMPT_CONTRIBUTORS,
+      provide: import_nestjs_agent_core22.AGENT_PROMPT_CONTRIBUTORS,
       useFactory: /* @__PURE__ */ __name(() => [], "useFactory")
     },
     // Likewise for `@Skill`-decorated providers — filled by SkillDiscoveryService at onModuleInit,
     // read lazily by the AGENT_SKILLS provider below (which DI builds before discovery has run).
     {
-      provide: import_nestjs_agent_core20.AGENT_SKILL_SOURCES,
+      provide: import_nestjs_agent_core22.AGENT_SKILL_SOURCES,
       useFactory: /* @__PURE__ */ __name(() => [], "useFactory")
     },
     {
       // One resolution, shared by the loop's deps and the listing endpoint: a second one would
       // drift, and a user would be offered a skill the agent cannot reach. `undefined` when the
       // host configured none — which is what keeps the turn's checkpoint sequence unchanged.
-      provide: import_nestjs_agent_core20.AGENT_SKILLS,
+      provide: import_nestjs_agent_core22.AGENT_SKILLS,
       useFactory: /* @__PURE__ */ __name((options, declared) => resolveSkillsConfig(options.skills, declared), "useFactory"),
       inject: [
-        import_nestjs_agent_core20.AGENT_OPTIONS,
-        import_nestjs_agent_core20.AGENT_SKILL_SOURCES
+        import_nestjs_agent_core22.AGENT_OPTIONS,
+        import_nestjs_agent_core22.AGENT_SKILL_SOURCES
       ]
     },
     {
       // One resolution, shared by the loop's deps and the read-back endpoint: a person has to be
       // shown what the model was shown, and two resolutions would eventually disagree about that.
-      provide: import_nestjs_agent_core20.AGENT_MEMORY,
+      provide: import_nestjs_agent_core22.AGENT_MEMORY,
       useFactory: /* @__PURE__ */ __name((options) => options.memory, "useFactory"),
       inject: [
-        import_nestjs_agent_core20.AGENT_OPTIONS
+        import_nestjs_agent_core22.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core20.AGENT_SINK,
+      provide: import_nestjs_agent_core22.AGENT_SINK,
       useFactory: /* @__PURE__ */ __name((options) => options.sink ?? new InProcessTokenStreamSink(), "useFactory"),
       inject: [
-        import_nestjs_agent_core20.AGENT_OPTIONS
+        import_nestjs_agent_core22.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core20.AGENT_ROLES_POLICY,
-      useFactory: /* @__PURE__ */ __name((options) => options.rolesPolicy ?? new import_nestjs_agent_core20.DefaultRolesPolicy(options.defaultRoles), "useFactory"),
+      provide: import_nestjs_agent_core22.AGENT_ROLES_POLICY,
+      useFactory: /* @__PURE__ */ __name((options) => options.rolesPolicy ?? new import_nestjs_agent_core22.DefaultRolesPolicy(options.defaultRoles), "useFactory"),
       inject: [
-        import_nestjs_agent_core20.AGENT_OPTIONS
+        import_nestjs_agent_core22.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core20.AGENT_ACTOR_RESOLVER,
+      provide: import_nestjs_agent_core22.AGENT_ACTOR_RESOLVER,
       useFactory: /* @__PURE__ */ __name((options) => options.actorResolver, "useFactory"),
       inject: [
-        import_nestjs_agent_core20.AGENT_OPTIONS
+        import_nestjs_agent_core22.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core20.AGENT_MODEL,
+      provide: import_nestjs_agent_core22.AGENT_MODEL,
       useFactory: /* @__PURE__ */ __name((o) => o.model, "useFactory"),
       inject: [
-        import_nestjs_agent_core20.AGENT_OPTIONS
+        import_nestjs_agent_core22.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_core20.AGENT_QUOTA_STORE,
+      provide: import_nestjs_agent_core22.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_core20.AGENT_OPTIONS,
-        import_nestjs_agent_core20.AGENT_STORE
+        import_nestjs_agent_core22.AGENT_OPTIONS,
+        import_nestjs_agent_core22.AGENT_STORE
+      ]
+    },
+    {
+      provide: import_nestjs_agent_core22.AGENT_MODEL_CATALOG,
+      useFactory: /* @__PURE__ */ __name((o) => o.models, "useFactory"),
+      inject: [
+        import_nestjs_agent_core22.AGENT_OPTIONS
       ]
     },
     AgentDepsFactory2,
     {
-      provide: import_nestjs_agent_core20.AGENT_DEPS_FACTORY,
+      provide: import_nestjs_agent_core22.AGENT_DEPS_FACTORY,
       useExisting: AgentDepsFactory2
     },
     // Populates the registry + contributors (onModuleInit) BEFORE AiToolDiscoveryService synthesizes
@@ -3325,22 +3624,22 @@ function sharedProviders(durable, includeStore) {
     // through AgentService.signalToolCall, which reaches whichever AGENT_RUNNER is bound above.
     AgentApprovalPortAdapter,
     {
-      provide: import_nestjs_agent_core20.AGENT_APPROVAL_PORT,
+      provide: import_nestjs_agent_core22.AGENT_APPROVAL_PORT,
       useExisting: AgentApprovalPortAdapter
     }
   ];
   if (includeStore) {
     providers.push({
-      provide: import_nestjs_agent_core20.AGENT_STORE,
+      provide: import_nestjs_agent_core22.AGENT_STORE,
       useFactory: /* @__PURE__ */ __name((o) => o.store, "useFactory"),
       inject: [
-        import_nestjs_agent_core20.AGENT_OPTIONS
+        import_nestjs_agent_core22.AGENT_OPTIONS
       ]
     });
   }
   if (durable) {
     providers.push({
-      provide: import_nestjs_agent_core20.AGENT_RUNNER,
+      provide: import_nestjs_agent_core22.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.");
@@ -3349,14 +3648,14 @@ function sharedProviders(durable, includeStore) {
       }, "useFactory"),
       inject: [
         {
-          token: import_nestjs_agent_core20.AGENT_DURABLE_RUNNER,
+          token: import_nestjs_agent_core22.AGENT_DURABLE_RUNNER,
           optional: true
         }
       ]
     });
   } else {
     providers.push({
-      provide: import_nestjs_agent_core20.AGENT_RUNNER,
+      provide: import_nestjs_agent_core22.AGENT_RUNNER,
       useExisting: InlineAgentRunner
     });
   }
@@ -3365,25 +3664,26 @@ function sharedProviders(durable, includeStore) {
 __name(sharedProviders, "sharedProviders");
 function exportsFor(includeStore) {
   return [
-    import_nestjs_agent_core20.AGENT_OPTIONS,
-    import_nestjs_agent_core20.AGENT_TOOL_REGISTRY,
-    import_nestjs_agent_core20.AGENT_REGISTRY,
-    import_nestjs_agent_core20.AGENT_SINK,
-    import_nestjs_agent_core20.AGENT_ROLES_POLICY,
-    import_nestjs_agent_core20.AGENT_ACTOR_RESOLVER,
-    import_nestjs_agent_core20.AGENT_MODEL,
+    import_nestjs_agent_core22.AGENT_OPTIONS,
+    import_nestjs_agent_core22.AGENT_TOOL_REGISTRY,
+    import_nestjs_agent_core22.AGENT_REGISTRY,
+    import_nestjs_agent_core22.AGENT_SINK,
+    import_nestjs_agent_core22.AGENT_ROLES_POLICY,
+    import_nestjs_agent_core22.AGENT_ACTOR_RESOLVER,
+    import_nestjs_agent_core22.AGENT_MODEL,
     ...includeStore ? [
-      import_nestjs_agent_core20.AGENT_STORE
+      import_nestjs_agent_core22.AGENT_STORE
     ] : [],
-    import_nestjs_agent_core20.AGENT_QUOTA_STORE,
-    import_nestjs_agent_core20.AGENT_PROMPT_CONTRIBUTORS,
-    import_nestjs_agent_core20.AGENT_SKILLS,
-    import_nestjs_agent_core20.AGENT_MEMORY,
-    import_nestjs_agent_core20.AGENT_DEPS_FACTORY,
+    import_nestjs_agent_core22.AGENT_QUOTA_STORE,
+    import_nestjs_agent_core22.AGENT_MODEL_CATALOG,
+    import_nestjs_agent_core22.AGENT_PROMPT_CONTRIBUTORS,
+    import_nestjs_agent_core22.AGENT_SKILLS,
+    import_nestjs_agent_core22.AGENT_MEMORY,
+    import_nestjs_agent_core22.AGENT_DEPS_FACTORY,
     AgentDepsFactory2,
     AgentService,
     InlineAgentRunner,
-    import_nestjs_agent_core20.AGENT_APPROVAL_PORT
+    import_nestjs_agent_core22.AGENT_APPROVAL_PORT
   ];
 }
 __name(exportsFor, "exportsFor");
@@ -3395,7 +3695,9 @@ var BASE_CONTROLLERS = [
   AgentsController,
   SkillsController,
   MemoriesController,
-  ToolsController
+  ToolsController,
+  MessagesController,
+  ModelsController
 ];
 var GUARDABLE_CONTROLLERS = [
   ...BASE_CONTROLLERS,
@@ -3453,7 +3755,7 @@ var AgentModule = class _AgentModule {
       controllers: controllersForSurface(options.surface, options.attachments?.upload === true),
       providers: [
         {
-          provide: import_nestjs_agent_core20.AGENT_OPTIONS,
+          provide: import_nestjs_agent_core22.AGENT_OPTIONS,
           useValue: options
         },
         ...sharedProviders(options.durable ?? false, includeStore),
@@ -3477,7 +3779,7 @@ var AgentModule = class _AgentModule {
       controllers: controllersForSurface(options.surface, options.attachmentsUpload === true),
       providers: [
         {
-          provide: import_nestjs_agent_core20.AGENT_OPTIONS,
+          provide: import_nestjs_agent_core22.AGENT_OPTIONS,
           // Stamp the STATIC wiring flags onto the factory result: `durable`/`surface` are
           // authoritative on the async config object (they decided the actual wiring above), and
           // the durable module reads `durable` back off AGENT_OPTIONS. `surface` isn't read back by
@@ -3498,13 +3800,13 @@ var AgentModule = class _AgentModule {
     };
   }
 };
-AgentModule = _ts_decorate17([
-  (0, import_common17.Global)(),
-  (0, import_common17.Module)({})
+AgentModule = _ts_decorate19([
+  (0, import_common19.Global)(),
+  (0, import_common19.Module)({})
 ], AgentModule);
 
 // src/resolver/header-actor-resolver.ts
-var import_common18 = require("@nestjs/common");
+var import_common20 = require("@nestjs/common");
 function readHeader(req, name) {
   if (typeof req !== "object" || req === null || !("headers" in req)) return void 0;
   const { headers } = req;
@@ -3520,7 +3822,7 @@ var HeaderActorResolver = class {
   resolve(req) {
     const id = readHeader(req, "x-actor-id");
     if (id === void 0 || id.length === 0) {
-      throw new import_common18.UnauthorizedException("HeaderActorResolver: missing x-actor-id header. No default actor is fabricated. Send x-actor-id from a trusted gateway, or configure AgentModule.forRoot({ actorResolver }) with a resolver that reads your authenticated principal.");
+      throw new import_common20.UnauthorizedException("HeaderActorResolver: missing x-actor-id header. No default actor is fabricated. Send x-actor-id from a trusted gateway, or configure AgentModule.forRoot({ actorResolver }) with a resolver that reads your authenticated principal.");
     }
     const roles = (readHeader(req, "x-actor-role") ?? "").split(",").map((role) => role.trim()).filter((role) => role.length > 0);
     const tenantRef = readHeader(req, "x-tenant-ref");
@@ -3558,6 +3860,8 @@ __reExport(index_exports, require("@dudousxd/nestjs-agent-core"), module.exports
   InlineAgentRunner,
   LedgerQuotaStore,
   MemoriesController,
+  MessagesController,
+  ModelsController,
   SKILL_METADATA,
   SYSTEM_PROMPT_CONTRIBUTOR_METADATA,
   SYSTEM_PROMPT_METADATA,