@dudousxd/nestjs-agent 1.16.1 → 1.17.0

package/dist/index.cjs

@@ -49,6 +49,7 @@ __export(index_exports, {
   MessagesController: () => MessagesController,
   ModelsController: () => ModelsController,
   QueueController: () => QueueController,
+  RunNotActiveException: () => RunNotActiveException,
   SKILL_METADATA: () => SKILL_METADATA,
   SYSTEM_PROMPT_CONTRIBUTOR_METADATA: () => SYSTEM_PROMPT_CONTRIBUTOR_METADATA,
   SYSTEM_PROMPT_METADATA: () => SYSTEM_PROMPT_METADATA,
@@ -76,8 +77,8 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/agent.module.ts
-var import_nestjs_agent_core26 = require("@dudousxd/nestjs-agent-core");
-var import_common22 = require("@nestjs/common");
+var import_nestjs_agent_core27 = require("@dudousxd/nestjs-agent-core");
+var import_common23 = require("@nestjs/common");
 var import_core4 = require("@nestjs/core");
 
 // src/agent-deps.factory.ts
@@ -339,8 +340,8 @@ AgentDepsFactory2 = _ts_decorate([
 ], AgentDepsFactory2);
 
 // src/agent.service.ts
-var import_nestjs_agent_core4 = require("@dudousxd/nestjs-agent-core");
-var import_common3 = require("@nestjs/common");
+var import_nestjs_agent_core5 = require("@dudousxd/nestjs-agent-core");
+var import_common4 = require("@nestjs/common");
 
 // src/agent-deps.ts
 function utcDay(date = /* @__PURE__ */ new Date()) {
@@ -785,6 +786,24 @@ function queueFrame(items, paused, started) {
 }
 __name(queueFrame, "queueFrame");
 
+// src/run-not-active.exception.ts
+var import_nestjs_agent_core4 = require("@dudousxd/nestjs-agent-core");
+var import_common3 = require("@nestjs/common");
+var RunNotActiveException = class extends import_common3.ConflictException {
+  static {
+    __name(this, "RunNotActiveException");
+  }
+  runId;
+  code = import_nestjs_agent_core4.RUN_NOT_ACTIVE_CODE;
+  constructor(runId) {
+    super({
+      statusCode: 409,
+      code: import_nestjs_agent_core4.RUN_NOT_ACTIVE_CODE,
+      message: import_nestjs_agent_core4.RUN_NOT_ACTIVE_MESSAGE
+    }), this.runId = runId;
+  }
+};
+
 // src/agent.service.ts
 function _ts_decorate3(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -842,7 +861,7 @@ var AgentService = class {
   requireQueue() {
     const queue = this.queueing();
     if (queue === void 0) {
-      throw new import_common3.NotImplementedException("Queueing messages requires an AgentStore that implements ChatQueueStore; the bound store does not.");
+      throw new import_common4.NotImplementedException("Queueing messages requires an AgentStore that implements ChatQueueStore; the bound store does not.");
     }
     return queue;
   }
@@ -879,12 +898,12 @@ var AgentService = class {
       actor
     });
     if (blocked !== void 0) {
-      throw new import_common3.HttpException({
-        statusCode: import_common3.HttpStatus.TOO_MANY_REQUESTS,
+      throw new import_common4.HttpException({
+        statusCode: import_common4.HttpStatus.TOO_MANY_REQUESTS,
         code: "quota_exceeded",
         period: blocked.period,
         message: blocked.reason ?? `The ${blocked.period === "day" ? "daily" : "monthly"} quota is used up`
-      }, import_common3.HttpStatus.TOO_MANY_REQUESTS);
+      }, import_common4.HttpStatus.TOO_MANY_REQUESTS);
     }
   }
   /**
@@ -912,17 +931,17 @@ var AgentService = class {
   */
   async assertModelAllowed(actor, agent, model) {
     if (this.models === void 0) {
-      throw new import_common3.BadRequestException(`model "${model}" cannot be selected: no ModelCatalog is configured (AgentModule.forRoot({ models }))`);
+      throw new import_common4.BadRequestException(`model "${model}" cannot be selected: no ModelCatalog is configured (AgentModule.forRoot({ models }))`);
     }
-    const entry = (0, import_nestjs_agent_core4.findCatalogModel)(await this.models.list({
+    const entry = (0, import_nestjs_agent_core5.findCatalogModel)(await this.models.list({
       actor,
       agent
     }), model);
     if (entry === void 0) {
-      throw new import_common3.BadRequestException(`model "${model}" is not offered`);
+      throw new import_common4.BadRequestException(`model "${model}" is not offered`);
     }
     if (!entry.available) {
-      throw new import_common3.BadRequestException(`model "${model}" is not available${entry.unavailableReason ? `: ${entry.unavailableReason}` : ""}`);
+      throw new import_common4.BadRequestException(`model "${model}" is not available${entry.unavailableReason ? `: ${entry.unavailableReason}` : ""}`);
     }
     return entry.id;
   }
@@ -938,7 +957,7 @@ var AgentService = class {
     })).locked : void 0;
     if (locked !== void 0) {
       if (requested !== void 0 && requested !== locked.model) {
-        throw new import_common3.BadRequestException(`model "${requested}" cannot be selected: ${locked.reason ?? `this agent always uses "${locked.model}"`}`);
+        throw new import_common4.BadRequestException(`model "${requested}" cannot be selected: ${locked.reason ?? `this agent always uses "${locked.model}"`}`);
       }
       return locked.model;
     }
@@ -982,7 +1001,7 @@ var AgentService = class {
       };
     }
     await this.requireQueue().publish(result.threadId);
-    throw new import_common3.ConflictException({
+    throw new import_common4.ConflictException({
       statusCode: 409,
       code: "run_active",
       message: `thread ${result.threadId} already has a turn running`
@@ -1000,7 +1019,7 @@ var AgentService = class {
     let threadId = params.threadId;
     if (threadId === void 0) {
       if (params.regenerate === true) {
-        throw new import_common3.BadRequestException("regenerate requires an existing threadId");
+        throw new import_common4.BadRequestException("regenerate requires an existing threadId");
       }
       const created = await this.store.createThread({
         actor: params.actor,
@@ -1042,6 +1061,11 @@ var AgentService = class {
     }
     const mode = params.mode ?? "auto";
     const { live, stale } = await queue.holder(threadId, this.runner);
+    if (stale !== null) {
+      await (0, import_nestjs_agent_core5.settleDeadRun)(this.store, {
+        runId: stale
+      });
+    }
     if (live === null && mode !== "queue") {
       const runId = crypto.randomUUID();
       if (await queue.queueStore().claimActiveStream(threadId, runId, stale !== null ? {
@@ -1054,7 +1078,7 @@ var AgentService = class {
       }
     }
     if (params.regenerate === true) {
-      throw new import_common3.ConflictException({
+      throw new import_common4.ConflictException({
         statusCode: 409,
         code: "run_active",
         message: "cannot regenerate while a turn is running on this thread"
@@ -1151,7 +1175,7 @@ var AgentService = class {
     const store = queue.queueStore();
     const threadId = await this.assertOwnsQueuedMessage(actor, messageId);
     if (patch.message !== void 0 && patch.message.trim().length === 0) {
-      throw new import_common3.BadRequestException("message must not be empty");
+      throw new import_common4.BadRequestException("message must not be empty");
     }
     const attachments = patch.attachments === void 0 || patch.attachments === null ? patch.attachments : await this.resolveAttachments(actor, patch.attachments);
     if (patch.message !== void 0 || attachments !== void 0) {
@@ -1164,15 +1188,15 @@ var AgentService = class {
         } : {}
       });
       if (updated === null) {
-        throw new import_common3.GoneException(`queued message ${messageId} already started or was removed`);
+        throw new import_common4.GoneException(`queued message ${messageId} already started or was removed`);
       }
     }
     if (patch.position !== void 0) {
       if (!Number.isInteger(patch.position) || patch.position < 0) {
-        throw new import_common3.BadRequestException("position must be a non-negative integer");
+        throw new import_common4.BadRequestException("position must be a non-negative integer");
       }
       if (!await store.moveQueuedMessage(messageId, patch.position)) {
-        throw new import_common3.GoneException(`queued message ${messageId} already started or was removed`);
+        throw new import_common4.GoneException(`queued message ${messageId} already started or was removed`);
       }
     }
     return queue.publish(threadId);
@@ -1182,7 +1206,7 @@ var AgentService = class {
     const queue = this.requireQueue();
     const threadId = await this.assertOwnsQueuedMessage(actor, messageId);
     if (!await queue.queueStore().removeQueuedMessage(messageId)) {
-      throw new import_common3.GoneException(`queued message ${messageId} already started or was removed`);
+      throw new import_common4.GoneException(`queued message ${messageId} already started or was removed`);
     }
     return queue.publish(threadId);
   }
@@ -1201,7 +1225,7 @@ var AgentService = class {
     const queue = this.requireQueue();
     const store = queue.queueStore();
     const threadId = await this.assertOwnsQueuedMessage(actor, messageId);
-    const gone = /* @__PURE__ */ __name(() => new import_common3.GoneException(`queued message ${messageId} already started or was removed`), "gone");
+    const gone = /* @__PURE__ */ __name(() => new import_common4.GoneException(`queued message ${messageId} already started or was removed`), "gone");
     const marked = await store.updateQueuedMessage(messageId, {
       interrupt: true
     });
@@ -1209,7 +1233,7 @@ var AgentService = class {
       throw gone();
     }
     if (marked.interrupt !== true) {
-      throw new import_common3.NotImplementedException("Interrupting a queued message requires a ChatQueueStore whose updateQueuedMessage stores `interrupt`; the bound store ignored it.");
+      throw new import_common4.NotImplementedException("Interrupting a queued message requires a ChatQueueStore whose updateQueuedMessage stores `interrupt`; the bound store ignored it.");
     }
     if (!await store.moveQueuedMessage(messageId, 0)) {
       throw gone();
@@ -1268,7 +1292,7 @@ var AgentService = class {
   async assertOwnsQueuedMessage(actor, messageId) {
     const message = await this.requireQueue().queueStore().getQueuedMessage(messageId);
     if (message === null) {
-      throw new import_common3.NotFoundException(`queued message ${messageId} not found`);
+      throw new import_common4.NotFoundException(`queued message ${messageId} not found`);
     }
     await this.assertOwnsThread(actor, message.threadId);
     return message.threadId;
@@ -1289,7 +1313,7 @@ var AgentService = class {
     }
     const staging = this.staging;
     if (staging === void 0 || typeof staging.resolve !== "function") {
-      throw new import_common3.NotImplementedException("Message attachments require an AGENT_ATTACHMENT_STAGING provider implementing resolve(); attachment urls are never taken from the request.");
+      throw new import_common4.NotImplementedException("Message attachments require an AGENT_ATTACHMENT_STAGING provider implementing resolve(); attachment urls are never taken from the request.");
     }
     const resolved = [];
     for (const ref of refs) {
@@ -1298,7 +1322,7 @@ var AgentService = class {
         actor
       });
       if (attachment === null) {
-        throw new import_common3.ForbiddenException(`attachment ${ref.mediaId} is not available to this actor`);
+        throw new import_common4.ForbiddenException(`attachment ${ref.mediaId} is not available to this actor`);
       }
       resolved.push(attachment);
     }
@@ -1402,8 +1426,29 @@ var AgentService = class {
   async signalToolCall(toolCallId2, reply) {
     await this.assertNotExpired(toolCallId2);
     const runId = await this.resolveRunForToolCall(toolCallId2);
+    await this.assertRunWaiting(runId);
     return this.runner.signal(runId, toolCallId2, reply);
   }
+  /**
+  * Refuse a decision addressed at a run that is over (`409 run_not_active`). The runtime would take
+  * the signal and buffer it for a run that never comes back — the person's "yes" is accepted, the
+  * card says so, and nothing runs. Settles the calls the dead run left awaiting a decision on the
+  * way out, so the card stops asking. A runner that cannot say whether a run is alive is taken at
+  * its word that it is, and so is one that fails to answer.
+  */
+  async assertRunWaiting(runId) {
+    if (typeof this.runner.isRunActive !== "function") {
+      return;
+    }
+    const active = await this.runner.isRunActive(runId).catch(() => true);
+    if (active) {
+      return;
+    }
+    await (0, import_nestjs_agent_core5.settleDeadRun)(this.store, {
+      runId
+    });
+    throw new RunNotActiveException(runId);
+  }
   async cancel(actor, runId) {
     await this.assertOwnsActiveStream(actor, runId);
     return this.runner.cancel(runId);
@@ -1447,7 +1492,7 @@ var AgentService = class {
       return;
     }
     if (this.store.updateThread === void 0) {
-      throw new import_common3.NotImplementedException("Setting a thread's defaultAgent or model requires an AgentStore that implements updateThread(); the bound store does not support it.");
+      throw new import_common4.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, {
@@ -1465,10 +1510,10 @@ var AgentService = class {
   validateTitle(title) {
     const trimmed = title.trim();
     if (trimmed.length === 0) {
-      throw new import_common3.BadRequestException("title must not be empty");
+      throw new import_common4.BadRequestException("title must not be empty");
     }
     if (trimmed.length > 200) {
-      throw new import_common3.BadRequestException("title must be at most 200 characters");
+      throw new import_common4.BadRequestException("title must be at most 200 characters");
     }
     return trimmed;
   }
@@ -1571,21 +1616,21 @@ var AgentService = class {
   */
   async setMessageFeedback(actor, messageId, input) {
     if (input.value !== null && input.value !== "up" && input.value !== "down") {
-      throw new import_common3.BadRequestException("value must be 'up', 'down' or null");
+      throw new import_common4.BadRequestException("value must be 'up', 'down' or null");
     }
     if (input.comment !== void 0 && typeof input.comment !== "string") {
-      throw new import_common3.BadRequestException("comment must be a string");
+      throw new import_common4.BadRequestException("comment must be a string");
     }
     const comment = input.comment?.trim();
     if (comment !== void 0 && comment.length > 2e3) {
-      throw new import_common3.BadRequestException("comment must be at most 2000 characters");
+      throw new import_common4.BadRequestException("comment must be at most 2000 characters");
     }
     if (this.store.threadOfMessage === void 0 || this.store.setMessageFeedback === void 0) {
-      throw new import_common3.NotImplementedException("Message feedback requires an AgentStore that implements threadOfMessage() and setMessageFeedback(); the bound store does not support it.");
+      throw new import_common4.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_common3.NotFoundException(`message ${messageId} not found`);
+      throw new import_common4.NotFoundException(`message ${messageId} not found`);
     }
     await this.assertOwnsThread(actor, threadId);
     const feedback = input.value === null ? null : {
@@ -1633,7 +1678,7 @@ var AgentService = class {
     const list = this.attachmentInventory();
     const referencedMediaIds = this.store.referencedMediaIds?.bind(this.store);
     if (referencedMediaIds === void 0) {
-      throw new import_common3.NotImplementedException("Collecting attachments requires an AgentStore that implements referencedMediaIds(); the bound store cannot say which media a message still references, and guessing would delete files that are in use.");
+      throw new import_common4.NotImplementedException("Collecting attachments requires an AgentStore that implements referencedMediaIds(); the bound store cannot say which media a message still references, and guessing would delete files that are in use.");
     }
     const stagedBefore = options.olderThan.toISOString();
     const inventory = await list({
@@ -1655,7 +1700,7 @@ var AgentService = class {
   attachmentInventory() {
     const list = this.staging?.list?.bind(this.staging);
     if (list === void 0) {
-      throw new import_common3.NotImplementedException("Listing attachments requires an AGENT_ATTACHMENT_STAGING provider implementing list(); the host owns the staged bytes, so only it can enumerate them.");
+      throw new import_common4.NotImplementedException("Listing attachments requires an AGENT_ATTACHMENT_STAGING provider implementing list(); the host owns the staged bytes, so only it can enumerate them.");
     }
     return list;
   }
@@ -1666,10 +1711,10 @@ var AgentService = class {
   async assertOwnsThread(actor, threadId) {
     const owner = await this.store.ownerOfThread(threadId);
     if (owner === null) {
-      throw new import_common3.NotFoundException(`thread ${threadId} not found`);
+      throw new import_common4.NotFoundException(`thread ${threadId} not found`);
     }
     if (owner !== actor.id) {
-      throw new import_common3.ForbiddenException("thread belongs to another actor");
+      throw new import_common4.ForbiddenException("thread belongs to another actor");
     }
   }
   /**
@@ -1680,10 +1725,10 @@ var AgentService = class {
   async assertOwnsToolCall(actor, toolCallId2) {
     const owner = await this.store.ownerOfToolCall(toolCallId2);
     if (owner === null) {
-      throw new import_common3.NotFoundException(`tool call ${toolCallId2} not found`);
+      throw new import_common4.NotFoundException(`tool call ${toolCallId2} not found`);
     }
     if (owner !== actor.id) {
-      throw new import_common3.ForbiddenException("tool call belongs to another actor");
+      throw new import_common4.ForbiddenException("tool call belongs to another actor");
     }
   }
   /**
@@ -1698,12 +1743,12 @@ var AgentService = class {
     if (this.store.toolCallInput === void 0) {
       return;
     }
-    const questions = (0, import_nestjs_agent_core4.readElicitationQuestions)(await this.store.toolCallInput(toolCallId2));
+    const questions = (0, import_nestjs_agent_core5.readElicitationQuestions)(await this.store.toolCallInput(toolCallId2));
     for (const question of questions) {
       const submitted = Object.hasOwn(answers2, question.id) ? answers2[question.id] : void 0;
-      const problem = (0, import_nestjs_agent_core4.validateElicitationAnswer)(question, submitted ?? question.defaults ?? []);
+      const problem = (0, import_nestjs_agent_core5.validateElicitationAnswer)(question, submitted ?? question.defaults ?? []);
       if (problem !== null) {
-        throw new import_common3.BadRequestException(`answers["${question.id}"] ${problem}`);
+        throw new import_common4.BadRequestException(`answers["${question.id}"] ${problem}`);
       }
     }
   }
@@ -1715,21 +1760,21 @@ var AgentService = class {
   */
   async assertMayDecide(actor, toolCallId2) {
     const approval = await this.store.toolCallApproval?.(toolCallId2);
-    const approver = approval?.approver ?? import_nestjs_agent_core4.REQUESTER_APPROVER;
-    if (approver === import_nestjs_agent_core4.REQUESTER_APPROVER) {
+    const approver = approval?.approver ?? import_nestjs_agent_core5.REQUESTER_APPROVER;
+    if (approver === import_nestjs_agent_core5.REQUESTER_APPROVER) {
       return this.assertOwnsToolCall(actor, toolCallId2);
     }
     const requesterRef = await this.store.ownerOfToolCall(toolCallId2);
     if (requesterRef === null) {
-      throw new import_common3.NotFoundException(`tool call ${toolCallId2} not found`);
+      throw new import_common4.NotFoundException(`tool call ${toolCallId2} not found`);
     }
-    const allowed = await (0, import_nestjs_agent_core4.mayDecideApproval)(this.deps.forAgent().approvalPolicy, actor, {
+    const allowed = await (0, import_nestjs_agent_core5.mayDecideApproval)(this.deps.forAgent().approvalPolicy, actor, {
       toolCallId: toolCallId2,
       approver,
       requesterRef
     });
     if (!allowed) {
-      throw new import_common3.ForbiddenException(`this approval is for ${approver}`);
+      throw new import_common4.ForbiddenException(`this approval is for ${approver}`);
     }
   }
   /**
@@ -1745,7 +1790,7 @@ var AgentService = class {
     }
     const lapsed = approval.status === "expired" || approval.status === "pending_approval" && approval.expiresAt !== null && Date.parse(approval.expiresAt) <= Date.now();
     if (lapsed) {
-      throw new import_common3.GoneException(`the approval request for tool call ${toolCallId2} has expired`);
+      throw new import_common4.GoneException(`the approval request for tool call ${toolCallId2} has expired`);
     }
   }
   /**
@@ -1758,7 +1803,7 @@ var AgentService = class {
   async resolveRunForToolCall(toolCallId2) {
     const runId = await this.store.runForToolCall(toolCallId2);
     if (runId === null) {
-      throw new import_common3.NotFoundException(`tool call ${toolCallId2} has no active run to signal`);
+      throw new import_common4.NotFoundException(`tool call ${toolCallId2} has no active run to signal`);
     }
     return runId;
   }
@@ -1766,27 +1811,27 @@ var AgentService = class {
   async assertOwnsActiveStream(actor, runId) {
     const owner = await this.store.ownerOfActiveStream(runId);
     if (owner === null) {
-      throw new import_common3.NotFoundException(`no active run ${runId}`);
+      throw new import_common4.NotFoundException(`no active run ${runId}`);
     }
     if (owner !== actor.id) {
-      throw new import_common3.ForbiddenException("run belongs to another actor");
+      throw new import_common4.ForbiddenException("run belongs to another actor");
     }
   }
 };
 AgentService = _ts_decorate3([
-  (0, import_common3.Injectable)(),
-  _ts_param3(0, (0, import_common3.Inject)(import_nestjs_agent_core4.AGENT_RUNNER)),
-  _ts_param3(1, (0, import_common3.Inject)(import_nestjs_agent_core4.AGENT_STORE)),
-  _ts_param3(2, (0, import_common3.Inject)(import_nestjs_agent_core4.AGENT_DEPS_FACTORY)),
-  _ts_param3(3, (0, import_common3.Optional)()),
-  _ts_param3(3, (0, import_common3.Inject)(import_nestjs_agent_core4.AGENT_ATTACHMENT_STAGING)),
-  _ts_param3(4, (0, import_common3.Optional)()),
-  _ts_param3(4, (0, import_common3.Inject)(import_nestjs_agent_core4.AGENT_MODEL_CATALOG)),
-  _ts_param3(5, (0, import_common3.Optional)()),
-  _ts_param3(5, (0, import_common3.Inject)(import_nestjs_agent_core4.AGENT_QUOTA_PROVIDER)),
-  _ts_param3(6, (0, import_common3.Optional)()),
-  _ts_param3(6, (0, import_common3.Inject)(import_nestjs_agent_core4.AGENT_OPTIONS)),
-  _ts_param3(7, (0, import_common3.Optional)()),
+  (0, import_common4.Injectable)(),
+  _ts_param3(0, (0, import_common4.Inject)(import_nestjs_agent_core5.AGENT_RUNNER)),
+  _ts_param3(1, (0, import_common4.Inject)(import_nestjs_agent_core5.AGENT_STORE)),
+  _ts_param3(2, (0, import_common4.Inject)(import_nestjs_agent_core5.AGENT_DEPS_FACTORY)),
+  _ts_param3(3, (0, import_common4.Optional)()),
+  _ts_param3(3, (0, import_common4.Inject)(import_nestjs_agent_core5.AGENT_ATTACHMENT_STAGING)),
+  _ts_param3(4, (0, import_common4.Optional)()),
+  _ts_param3(4, (0, import_common4.Inject)(import_nestjs_agent_core5.AGENT_MODEL_CATALOG)),
+  _ts_param3(5, (0, import_common4.Optional)()),
+  _ts_param3(5, (0, import_common4.Inject)(import_nestjs_agent_core5.AGENT_QUOTA_PROVIDER)),
+  _ts_param3(6, (0, import_common4.Optional)()),
+  _ts_param3(6, (0, import_common4.Inject)(import_nestjs_agent_core5.AGENT_OPTIONS)),
+  _ts_param3(7, (0, import_common4.Optional)()),
   _ts_metadata3("design:type", Function),
   _ts_metadata3("design:paramtypes", [
     typeof AgentRunner === "undefined" ? Object : AgentRunner,
@@ -1801,7 +1846,7 @@ AgentService = _ts_decorate3([
 ], AgentService);
 
 // src/approval-port.adapter.ts
-var import_common4 = require("@nestjs/common");
+var import_common5 = require("@nestjs/common");
 function _ts_decorate4(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
@@ -1860,7 +1905,7 @@ var AgentApprovalPortAdapter = class {
   }
 };
 AgentApprovalPortAdapter = _ts_decorate4([
-  (0, import_common4.Injectable)(),
+  (0, import_common5.Injectable)(),
   _ts_metadata4("design:type", Function),
   _ts_metadata4("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService
@@ -1868,8 +1913,8 @@ AgentApprovalPortAdapter = _ts_decorate4([
 ], AgentApprovalPortAdapter);
 
 // src/controller/agents.controller.ts
-var import_nestjs_agent_core5 = require("@dudousxd/nestjs-agent-core");
-var import_common5 = require("@nestjs/common");
+var import_nestjs_agent_core6 = require("@dudousxd/nestjs-agent-core");
+var import_common6 = require("@nestjs/common");
 function _ts_decorate5(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
@@ -1918,25 +1963,25 @@ var AgentsController = class {
   }
 };
 _ts_decorate5([
-  (0, import_common5.Get)(),
+  (0, import_common6.Get)(),
   _ts_metadata5("design:type", Function),
   _ts_metadata5("design:paramtypes", []),
   _ts_metadata5("design:returntype", Array)
 ], AgentsController.prototype, "list", null);
 AgentsController = _ts_decorate5([
-  (0, import_common5.Controller)("agents"),
-  _ts_param4(0, (0, import_common5.Inject)(import_nestjs_agent_core5.AGENT_REGISTRY)),
-  _ts_param4(1, (0, import_common5.Inject)(import_nestjs_agent_core5.AGENT_DEPS_FACTORY)),
+  (0, import_common6.Controller)("agents"),
+  _ts_param4(0, (0, import_common6.Inject)(import_nestjs_agent_core6.AGENT_REGISTRY)),
+  _ts_param4(1, (0, import_common6.Inject)(import_nestjs_agent_core6.AGENT_DEPS_FACTORY)),
   _ts_metadata5("design:type", Function),
   _ts_metadata5("design:paramtypes", [
-    typeof import_nestjs_agent_core5.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core5.AgentRegistry,
+    typeof import_nestjs_agent_core6.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core6.AgentRegistry,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory
   ])
 ], AgentsController);
 
 // src/controller/attachments.controller.ts
-var import_nestjs_agent_core6 = require("@dudousxd/nestjs-agent-core");
-var import_common6 = require("@nestjs/common");
+var import_nestjs_agent_core7 = require("@dudousxd/nestjs-agent-core");
+var import_common7 = require("@nestjs/common");
 var import_platform_express = require("@nestjs/platform-express");
 
 // src/attachment-limits.ts
@@ -2024,17 +2069,17 @@ var AttachmentsController = class {
   }
   async upload(req, file) {
     if (this.staging === void 0) {
-      throw new import_common6.NotImplementedException("Attachment upload is not configured on this server: bind AGENT_ATTACHMENT_STAGING (e.g. import AgentMediaAttachmentsModule).");
+      throw new import_common7.NotImplementedException("Attachment upload is not configured on this server: bind AGENT_ATTACHMENT_STAGING (e.g. import AgentMediaAttachmentsModule).");
     }
     if (file === void 0) {
-      throw new import_common6.BadRequestException('multipart field "file" is required');
+      throw new import_common7.BadRequestException('multipart field "file" is required');
     }
     const { allowedContentTypes, maxBytes } = attachmentLimits(this.options, this.staging);
     if (!allowedContentTypes.includes(file.mimetype)) {
-      throw new import_common6.UnsupportedMediaTypeException(`content type "${file.mimetype}" is not allowed (allowed: ${allowedContentTypes.join(", ")})`);
+      throw new import_common7.UnsupportedMediaTypeException(`content type "${file.mimetype}" is not allowed (allowed: ${allowedContentTypes.join(", ")})`);
     }
     if (file.size > maxBytes) {
-      throw new import_common6.PayloadTooLargeException(`file exceeds the ${maxBytes}-byte limit`);
+      throw new import_common7.PayloadTooLargeException(`file exceeds the ${maxBytes}-byte limit`);
     }
     const actor = await this.actorResolver.resolve(req);
     return this.staging.stage({
@@ -2047,8 +2092,8 @@ var AttachmentsController = class {
   }
 };
 _ts_decorate6([
-  (0, import_common6.Get)(),
-  _ts_param5(0, (0, import_common6.Req)()),
+  (0, import_common7.Get)(),
+  _ts_param5(0, (0, import_common7.Req)()),
   _ts_metadata6("design:type", Function),
   _ts_metadata6("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
@@ -2056,14 +2101,14 @@ _ts_decorate6([
   _ts_metadata6("design:returntype", Promise)
 ], AttachmentsController.prototype, "list", null);
 _ts_decorate6([
-  (0, import_common6.Post)(),
-  (0, import_common6.UseInterceptors)((0, import_platform_express.FileInterceptor)("file", {
+  (0, import_common7.Post)(),
+  (0, import_common7.UseInterceptors)((0, import_platform_express.FileInterceptor)("file", {
     limits: {
       fileSize: HARD_MAX_ATTACHMENT_BYTES
     }
   })),
-  _ts_param5(0, (0, import_common6.Req)()),
-  _ts_param5(1, (0, import_common6.UploadedFile)()),
+  _ts_param5(0, (0, import_common7.Req)()),
+  _ts_param5(1, (0, import_common7.UploadedFile)()),
   _ts_metadata6("design:type", Function),
   _ts_metadata6("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -2072,11 +2117,11 @@ _ts_decorate6([
   _ts_metadata6("design:returntype", Promise)
 ], AttachmentsController.prototype, "upload", null);
 AttachmentsController = _ts_decorate6([
-  (0, import_common6.Controller)("attachments"),
-  _ts_param5(0, (0, import_common6.Inject)(import_nestjs_agent_core6.AGENT_OPTIONS)),
-  _ts_param5(1, (0, import_common6.Inject)(import_nestjs_agent_core6.AGENT_ACTOR_RESOLVER)),
-  _ts_param5(3, (0, import_common6.Optional)()),
-  _ts_param5(3, (0, import_common6.Inject)(import_nestjs_agent_core6.AGENT_ATTACHMENT_STAGING)),
+  (0, import_common7.Controller)("attachments"),
+  _ts_param5(0, (0, import_common7.Inject)(import_nestjs_agent_core7.AGENT_OPTIONS)),
+  _ts_param5(1, (0, import_common7.Inject)(import_nestjs_agent_core7.AGENT_ACTOR_RESOLVER)),
+  _ts_param5(3, (0, import_common7.Optional)()),
+  _ts_param5(3, (0, import_common7.Inject)(import_nestjs_agent_core7.AGENT_ATTACHMENT_STAGING)),
   _ts_metadata6("design:type", Function),
   _ts_metadata6("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
@@ -2087,8 +2132,8 @@ AttachmentsController = _ts_decorate6([
 ], AttachmentsController);
 
 // src/controller/chat.controller.ts
-var import_nestjs_agent_core7 = require("@dudousxd/nestjs-agent-core");
-var import_common7 = require("@nestjs/common");
+var import_nestjs_agent_core8 = require("@dudousxd/nestjs-agent-core");
+var import_common8 = require("@nestjs/common");
 function _ts_decorate7(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
@@ -2125,7 +2170,7 @@ function sendMode(body) {
   if (body.mode === "auto" || body.mode === "queue" || body.mode === "interrupt") {
     return body.mode;
   }
-  throw new import_common7.BadRequestException("mode must be 'auto', 'queue' or 'interrupt'");
+  throw new import_common8.BadRequestException("mode must be 'auto', 'queue' or 'interrupt'");
 }
 __name(sendMode, "sendMode");
 function attachmentRefs(claimed) {
@@ -2133,21 +2178,21 @@ function attachmentRefs(claimed) {
     return [];
   }
   if (!Array.isArray(claimed)) {
-    throw new import_common7.BadRequestException("attachments must be an array of { mediaId }");
+    throw new import_common8.BadRequestException("attachments must be an array of { mediaId }");
   }
   if (claimed.length > MAX_ATTACHMENTS_PER_MESSAGE) {
-    throw new import_common7.BadRequestException(`a message may carry at most ${MAX_ATTACHMENTS_PER_MESSAGE} attachments`);
+    throw new import_common8.BadRequestException(`a message may carry at most ${MAX_ATTACHMENTS_PER_MESSAGE} attachments`);
   }
   return claimed.map((entry) => {
     if (typeof entry !== "object" || entry === null || !("mediaId" in entry)) {
-      throw new import_common7.BadRequestException("each attachment must be an object with a mediaId");
+      throw new import_common8.BadRequestException("each attachment must be an object with a mediaId");
     }
     if (Object.keys(entry).some((key) => key !== "mediaId")) {
-      throw new import_common7.BadRequestException("attachments are { mediaId } refs \u2014 send nothing but the id");
+      throw new import_common8.BadRequestException("attachments are { mediaId } refs \u2014 send nothing but the id");
     }
     const { mediaId } = entry;
     if (typeof mediaId !== "string" || mediaId.length === 0) {
-      throw new import_common7.BadRequestException("each attachment must carry a non-empty string mediaId");
+      throw new import_common8.BadRequestException("each attachment must carry a non-empty string mediaId");
     }
     return {
       mediaId
@@ -2280,13 +2325,10 @@ data: ${line}
       }
       res.write("event: done\ndata: {}\n\n");
     } catch (error) {
-      const payload = error instanceof import_nestjs_agent_core7.AgentStreamError ? {
+      const payload = error instanceof import_nestjs_agent_core8.AgentStreamError ? {
         code: error.code,
         message: error.message
-      } : {
-        code: "run_failed",
-        message: error instanceof Error ? error.message : "stream error"
-      };
+      } : (0, import_nestjs_agent_core8.streamFailure)(error);
       res.write(`event: error
 data: ${JSON.stringify(payload)}
 
@@ -2296,10 +2338,10 @@ data: ${JSON.stringify(payload)}
   }
 };
 _ts_decorate7([
-  (0, import_common7.Post)("chat"),
-  _ts_param6(0, (0, import_common7.Req)()),
-  _ts_param6(1, (0, import_common7.Res)()),
-  _ts_param6(2, (0, import_common7.Body)()),
+  (0, import_common8.Post)("chat"),
+  _ts_param6(0, (0, import_common8.Req)()),
+  _ts_param6(1, (0, import_common8.Res)()),
+  _ts_param6(2, (0, import_common8.Body)()),
   _ts_metadata7("design:type", Function),
   _ts_metadata7("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -2309,11 +2351,11 @@ _ts_decorate7([
   _ts_metadata7("design:returntype", Promise)
 ], ChatController.prototype, "chat", null);
 _ts_decorate7([
-  (0, import_common7.Get)("chat/:runId/stream"),
-  _ts_param6(0, (0, import_common7.Req)()),
-  _ts_param6(1, (0, import_common7.Param)("runId")),
-  _ts_param6(2, (0, import_common7.Res)()),
-  _ts_param6(3, (0, import_common7.Query)("after")),
+  (0, import_common8.Get)("chat/:runId/stream"),
+  _ts_param6(0, (0, import_common8.Req)()),
+  _ts_param6(1, (0, import_common8.Param)("runId")),
+  _ts_param6(2, (0, import_common8.Res)()),
+  _ts_param6(3, (0, import_common8.Query)("after")),
   _ts_metadata7("design:type", Function),
   _ts_metadata7("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -2324,9 +2366,9 @@ _ts_decorate7([
   _ts_metadata7("design:returntype", Promise)
 ], ChatController.prototype, "stream", null);
 _ts_decorate7([
-  (0, import_common7.Post)("chat/:runId/cancel"),
-  _ts_param6(0, (0, import_common7.Req)()),
-  _ts_param6(1, (0, import_common7.Param)("runId")),
+  (0, import_common8.Post)("chat/:runId/cancel"),
+  _ts_param6(0, (0, import_common8.Req)()),
+  _ts_param6(1, (0, import_common8.Param)("runId")),
   _ts_metadata7("design:type", Function),
   _ts_metadata7("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -2335,8 +2377,8 @@ _ts_decorate7([
   _ts_metadata7("design:returntype", Promise)
 ], ChatController.prototype, "cancel", null);
 ChatController = _ts_decorate7([
-  (0, import_common7.Controller)(),
-  _ts_param6(1, (0, import_common7.Inject)(import_nestjs_agent_core7.AGENT_ACTOR_RESOLVER)),
+  (0, import_common8.Controller)(),
+  _ts_param6(1, (0, import_common8.Inject)(import_nestjs_agent_core8.AGENT_ACTOR_RESOLVER)),
   _ts_metadata7("design:type", Function),
   _ts_metadata7("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -2354,8 +2396,8 @@ function parseCursor(raw) {
 __name(parseCursor, "parseCursor");
 
 // src/controller/config.controller.ts
-var import_nestjs_agent_core8 = require("@dudousxd/nestjs-agent-core");
-var import_common8 = require("@nestjs/common");
+var import_nestjs_agent_core9 = require("@dudousxd/nestjs-agent-core");
+var import_common9 = require("@nestjs/common");
 
 // src/resolver/anonymous-actor-resolver.ts
 var import_node_crypto = require("crypto");
@@ -2502,8 +2544,8 @@ var ConfigController = class {
   }
 };
 _ts_decorate8([
-  (0, import_common8.Get)(),
-  _ts_param7(0, (0, import_common8.Req)()),
+  (0, import_common9.Get)(),
+  _ts_param7(0, (0, import_common9.Req)()),
   _ts_metadata8("design:type", Function),
   _ts_metadata8("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
@@ -2511,13 +2553,13 @@ _ts_decorate8([
   _ts_metadata8("design:returntype", Promise)
 ], ConfigController.prototype, "config", null);
 ConfigController = _ts_decorate8([
-  (0, import_common8.Controller)("config"),
-  _ts_param7(0, (0, import_common8.Inject)(import_nestjs_agent_core8.AGENT_OPTIONS)),
-  _ts_param7(1, (0, import_common8.Inject)(import_nestjs_agent_core8.AGENT_ACTOR_RESOLVER)),
-  _ts_param7(2, (0, import_common8.Optional)()),
-  _ts_param7(2, (0, import_common8.Inject)(import_nestjs_agent_core8.AGENT_ATTACHMENT_STAGING)),
-  _ts_param7(3, (0, import_common8.Optional)()),
-  _ts_param7(3, (0, import_common8.Inject)(import_nestjs_agent_core8.AGENT_MODEL_CATALOG)),
+  (0, import_common9.Controller)("config"),
+  _ts_param7(0, (0, import_common9.Inject)(import_nestjs_agent_core9.AGENT_OPTIONS)),
+  _ts_param7(1, (0, import_common9.Inject)(import_nestjs_agent_core9.AGENT_ACTOR_RESOLVER)),
+  _ts_param7(2, (0, import_common9.Optional)()),
+  _ts_param7(2, (0, import_common9.Inject)(import_nestjs_agent_core9.AGENT_ATTACHMENT_STAGING)),
+  _ts_param7(3, (0, import_common9.Optional)()),
+  _ts_param7(3, (0, import_common9.Inject)(import_nestjs_agent_core9.AGENT_MODEL_CATALOG)),
   _ts_metadata8("design:type", Function),
   _ts_metadata8("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
@@ -2528,8 +2570,8 @@ ConfigController = _ts_decorate8([
 ], ConfigController);
 
 // src/controller/memories.controller.ts
-var import_nestjs_agent_core9 = require("@dudousxd/nestjs-agent-core");
-var import_common9 = require("@nestjs/common");
+var import_nestjs_agent_core10 = require("@dudousxd/nestjs-agent-core");
+var import_common10 = require("@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") {
@@ -2589,20 +2631,20 @@ var MemoriesController = class {
   */
   async forget(req, id) {
     if (this.memory === void 0) {
-      throw new import_common9.NotFoundException("No memory is configured in this deployment.");
+      throw new import_common10.NotFoundException("No memory is configured in this deployment.");
     }
     const actor = await this.actorResolver.resolve(req);
     const digest = await this.unbounded("", actor);
     const entry = digest.entries.find((candidate) => candidate.id === id);
     if (entry === void 0) {
-      throw new import_common9.NotFoundException(`No memory with id "${id}".`);
+      throw new import_common10.NotFoundException(`No memory with id "${id}".`);
     }
-    const verdict = (0, import_nestjs_agent_core9.memoryForgetVerdict)({
+    const verdict = (0, import_nestjs_agent_core10.memoryForgetVerdict)({
       record: entry,
       actor
     });
     if (!verdict.allowed) {
-      throw new import_common9.ForbiddenException(verdict.reason);
+      throw new import_common10.ForbiddenException(verdict.reason);
     }
     return {
       forgotten: await this.memory.provider.forget({
@@ -2616,7 +2658,7 @@ var MemoriesController = class {
   }
   async unbounded(threadId, actor) {
     const config = this.memory;
-    return await (0, import_nestjs_agent_core9.offerMemories)({
+    return await (0, import_nestjs_agent_core10.offerMemories)({
       config: {
         ...config,
         maxMemories: Number.POSITIVE_INFINITY
@@ -2629,9 +2671,9 @@ var MemoriesController = class {
   }
 };
 _ts_decorate9([
-  (0, import_common9.Get)(),
-  _ts_param8(0, (0, import_common9.Req)()),
-  _ts_param8(1, (0, import_common9.Query)("threadId")),
+  (0, import_common10.Get)(),
+  _ts_param8(0, (0, import_common10.Req)()),
+  _ts_param8(1, (0, import_common10.Query)("threadId")),
   _ts_metadata9("design:type", Function),
   _ts_metadata9("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -2640,9 +2682,9 @@ _ts_decorate9([
   _ts_metadata9("design:returntype", Promise)
 ], MemoriesController.prototype, "list", null);
 _ts_decorate9([
-  (0, import_common9.Delete)(":id"),
-  _ts_param8(0, (0, import_common9.Req)()),
-  _ts_param8(1, (0, import_common9.Param)("id")),
+  (0, import_common10.Delete)(":id"),
+  _ts_param8(0, (0, import_common10.Req)()),
+  _ts_param8(1, (0, import_common10.Param)("id")),
   _ts_metadata9("design:type", Function),
   _ts_metadata9("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -2651,10 +2693,10 @@ _ts_decorate9([
   _ts_metadata9("design:returntype", Promise)
 ], MemoriesController.prototype, "forget", null);
 MemoriesController = _ts_decorate9([
-  (0, import_common9.Controller)("memories"),
-  _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_MEMORY)),
+  (0, import_common10.Controller)("memories"),
+  _ts_param8(0, (0, import_common10.Inject)(import_nestjs_agent_core10.AGENT_ACTOR_RESOLVER)),
+  _ts_param8(1, (0, import_common10.Optional)()),
+  _ts_param8(1, (0, import_common10.Inject)(import_nestjs_agent_core10.AGENT_MEMORY)),
   _ts_metadata9("design:type", Function),
   _ts_metadata9("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
@@ -2663,8 +2705,8 @@ MemoriesController = _ts_decorate9([
 ], MemoriesController);
 
 // src/controller/messages.controller.ts
-var import_nestjs_agent_core10 = require("@dudousxd/nestjs-agent-core");
-var import_common10 = require("@nestjs/common");
+var import_nestjs_agent_core11 = require("@dudousxd/nestjs-agent-core");
+var import_common11 = 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") {
@@ -2719,11 +2761,11 @@ var MessagesController = class {
   }
 };
 _ts_decorate10([
-  (0, import_common10.Post)(":id/feedback"),
-  (0, import_common10.HttpCode)(200),
-  _ts_param9(0, (0, import_common10.Req)()),
-  _ts_param9(1, (0, import_common10.Param)("id")),
-  _ts_param9(2, (0, import_common10.Body)()),
+  (0, import_common11.Post)(":id/feedback"),
+  (0, import_common11.HttpCode)(200),
+  _ts_param9(0, (0, import_common11.Req)()),
+  _ts_param9(1, (0, import_common11.Param)("id")),
+  _ts_param9(2, (0, import_common11.Body)()),
   _ts_metadata10("design:type", Function),
   _ts_metadata10("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -2733,8 +2775,8 @@ _ts_decorate10([
   _ts_metadata10("design:returntype", Promise)
 ], MessagesController.prototype, "feedback", null);
 MessagesController = _ts_decorate10([
-  (0, import_common10.Controller)("messages"),
-  _ts_param9(1, (0, import_common10.Inject)(import_nestjs_agent_core10.AGENT_ACTOR_RESOLVER)),
+  (0, import_common11.Controller)("messages"),
+  _ts_param9(1, (0, import_common11.Inject)(import_nestjs_agent_core11.AGENT_ACTOR_RESOLVER)),
   _ts_metadata10("design:type", Function),
   _ts_metadata10("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -2743,8 +2785,8 @@ MessagesController = _ts_decorate10([
 ], MessagesController);
 
 // src/controller/models.controller.ts
-var import_nestjs_agent_core11 = require("@dudousxd/nestjs-agent-core");
-var import_common11 = require("@nestjs/common");
+var import_nestjs_agent_core12 = require("@dudousxd/nestjs-agent-core");
+var import_common12 = 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") {
@@ -2791,9 +2833,9 @@ var ModelsController = class {
   }
 };
 _ts_decorate11([
-  (0, import_common11.Get)(),
-  _ts_param10(0, (0, import_common11.Req)()),
-  _ts_param10(1, (0, import_common11.Query)("agent")),
+  (0, import_common12.Get)(),
+  _ts_param10(0, (0, import_common12.Req)()),
+  _ts_param10(1, (0, import_common12.Query)("agent")),
   _ts_metadata11("design:type", Function),
   _ts_metadata11("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -2802,8 +2844,8 @@ _ts_decorate11([
   _ts_metadata11("design:returntype", Promise)
 ], ModelsController.prototype, "list", null);
 ModelsController = _ts_decorate11([
-  (0, import_common11.Controller)("models"),
-  _ts_param10(1, (0, import_common11.Inject)(import_nestjs_agent_core11.AGENT_ACTOR_RESOLVER)),
+  (0, import_common12.Controller)("models"),
+  _ts_param10(1, (0, import_common12.Inject)(import_nestjs_agent_core12.AGENT_ACTOR_RESOLVER)),
   _ts_metadata11("design:type", Function),
   _ts_metadata11("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -2812,8 +2854,8 @@ ModelsController = _ts_decorate11([
 ], ModelsController);
 
 // src/controller/queue.controller.ts
-var import_nestjs_agent_core12 = require("@dudousxd/nestjs-agent-core");
-var import_common12 = require("@nestjs/common");
+var import_nestjs_agent_core13 = require("@dudousxd/nestjs-agent-core");
+var import_common13 = 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") {
@@ -2863,10 +2905,10 @@ var QueueController = class {
   async update(req, messageId, body) {
     const actor = await this.actorResolver.resolve(req);
     if (body.message !== void 0 && typeof body.message !== "string") {
-      throw new import_common12.BadRequestException("message must be a string");
+      throw new import_common13.BadRequestException("message must be a string");
     }
     if (body.position !== void 0 && typeof body.position !== "number") {
-      throw new import_common12.BadRequestException("position must be a number");
+      throw new import_common13.BadRequestException("position must be a number");
     }
     const attachments = body.attachments === void 0 ? void 0 : body.attachments === null ? null : attachmentRefs(body.attachments);
     return this.agent.updateQueuedMessage(actor, messageId, {
@@ -2894,9 +2936,9 @@ var QueueController = class {
   }
 };
 _ts_decorate12([
-  (0, import_common12.Get)("threads/:id/queue"),
-  _ts_param11(0, (0, import_common12.Req)()),
-  _ts_param11(1, (0, import_common12.Param)("id")),
+  (0, import_common13.Get)("threads/:id/queue"),
+  _ts_param11(0, (0, import_common13.Req)()),
+  _ts_param11(1, (0, import_common13.Param)("id")),
   _ts_metadata12("design:type", Function),
   _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -2905,9 +2947,9 @@ _ts_decorate12([
   _ts_metadata12("design:returntype", Promise)
 ], QueueController.prototype, "list", null);
 _ts_decorate12([
-  (0, import_common12.Delete)("threads/:id/queue"),
-  _ts_param11(0, (0, import_common12.Req)()),
-  _ts_param11(1, (0, import_common12.Param)("id")),
+  (0, import_common13.Delete)("threads/:id/queue"),
+  _ts_param11(0, (0, import_common13.Req)()),
+  _ts_param11(1, (0, import_common13.Param)("id")),
   _ts_metadata12("design:type", Function),
   _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -2916,9 +2958,9 @@ _ts_decorate12([
   _ts_metadata12("design:returntype", Promise)
 ], QueueController.prototype, "clear", null);
 _ts_decorate12([
-  (0, import_common12.Post)("threads/:id/queue/resume"),
-  _ts_param11(0, (0, import_common12.Req)()),
-  _ts_param11(1, (0, import_common12.Param)("id")),
+  (0, import_common13.Post)("threads/:id/queue/resume"),
+  _ts_param11(0, (0, import_common13.Req)()),
+  _ts_param11(1, (0, import_common13.Param)("id")),
   _ts_metadata12("design:type", Function),
   _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -2927,10 +2969,10 @@ _ts_decorate12([
   _ts_metadata12("design:returntype", Promise)
 ], QueueController.prototype, "resume", null);
 _ts_decorate12([
-  (0, import_common12.Patch)("queue/:messageId"),
-  _ts_param11(0, (0, import_common12.Req)()),
-  _ts_param11(1, (0, import_common12.Param)("messageId")),
-  _ts_param11(2, (0, import_common12.Body)()),
+  (0, import_common13.Patch)("queue/:messageId"),
+  _ts_param11(0, (0, import_common13.Req)()),
+  _ts_param11(1, (0, import_common13.Param)("messageId")),
+  _ts_param11(2, (0, import_common13.Body)()),
   _ts_metadata12("design:type", Function),
   _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -2940,9 +2982,9 @@ _ts_decorate12([
   _ts_metadata12("design:returntype", Promise)
 ], QueueController.prototype, "update", null);
 _ts_decorate12([
-  (0, import_common12.Post)("queue/:messageId/interrupt"),
-  _ts_param11(0, (0, import_common12.Req)()),
-  _ts_param11(1, (0, import_common12.Param)("messageId")),
+  (0, import_common13.Post)("queue/:messageId/interrupt"),
+  _ts_param11(0, (0, import_common13.Req)()),
+  _ts_param11(1, (0, import_common13.Param)("messageId")),
   _ts_metadata12("design:type", Function),
   _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -2951,9 +2993,9 @@ _ts_decorate12([
   _ts_metadata12("design:returntype", Promise)
 ], QueueController.prototype, "interrupt", null);
 _ts_decorate12([
-  (0, import_common12.Delete)("queue/:messageId"),
-  _ts_param11(0, (0, import_common12.Req)()),
-  _ts_param11(1, (0, import_common12.Param)("messageId")),
+  (0, import_common13.Delete)("queue/:messageId"),
+  _ts_param11(0, (0, import_common13.Req)()),
+  _ts_param11(1, (0, import_common13.Param)("messageId")),
   _ts_metadata12("design:type", Function),
   _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -2962,8 +3004,8 @@ _ts_decorate12([
   _ts_metadata12("design:returntype", Promise)
 ], QueueController.prototype, "remove", null);
 QueueController = _ts_decorate12([
-  (0, import_common12.Controller)(),
-  _ts_param11(1, (0, import_common12.Inject)(import_nestjs_agent_core12.AGENT_ACTOR_RESOLVER)),
+  (0, import_common13.Controller)(),
+  _ts_param11(1, (0, import_common13.Inject)(import_nestjs_agent_core13.AGENT_ACTOR_RESOLVER)),
   _ts_metadata12("design:type", Function),
   _ts_metadata12("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -2972,8 +3014,8 @@ QueueController = _ts_decorate12([
 ], QueueController);
 
 // src/controller/quota.controller.ts
-var import_nestjs_agent_core13 = require("@dudousxd/nestjs-agent-core");
-var import_common13 = require("@nestjs/common");
+var import_nestjs_agent_core14 = require("@dudousxd/nestjs-agent-core");
+var import_common14 = 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") {
@@ -3020,8 +3062,8 @@ var QuotaController = class {
   }
 };
 _ts_decorate13([
-  (0, import_common13.Get)(),
-  _ts_param12(0, (0, import_common13.Req)()),
+  (0, import_common14.Get)(),
+  _ts_param12(0, (0, import_common14.Req)()),
   _ts_metadata13("design:type", Function),
   _ts_metadata13("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
@@ -3029,8 +3071,8 @@ _ts_decorate13([
   _ts_metadata13("design:returntype", Promise)
 ], QuotaController.prototype, "report", null);
 QuotaController = _ts_decorate13([
-  (0, import_common13.Controller)("quota"),
-  _ts_param12(1, (0, import_common13.Inject)(import_nestjs_agent_core13.AGENT_ACTOR_RESOLVER)),
+  (0, import_common14.Controller)("quota"),
+  _ts_param12(1, (0, import_common14.Inject)(import_nestjs_agent_core14.AGENT_ACTOR_RESOLVER)),
   _ts_metadata13("design:type", Function),
   _ts_metadata13("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -3039,8 +3081,8 @@ QuotaController = _ts_decorate13([
 ], QuotaController);
 
 // src/controller/skills.controller.ts
-var import_nestjs_agent_core14 = require("@dudousxd/nestjs-agent-core");
-var import_common14 = require("@nestjs/common");
+var import_nestjs_agent_core15 = require("@dudousxd/nestjs-agent-core");
+var import_common15 = 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") {
@@ -3082,7 +3124,7 @@ var SkillsController = class {
       return [];
     }
     const actor = await this.actorResolver.resolve(req);
-    const offer = await (0, import_nestjs_agent_core14.offerSkills)(this.skills, {
+    const offer = await (0, import_nestjs_agent_core15.offerSkills)(this.skills, {
       actor,
       threadId: threadId ?? ""
     });
@@ -3090,9 +3132,9 @@ var SkillsController = class {
   }
 };
 _ts_decorate14([
-  (0, import_common14.Get)(),
-  _ts_param13(0, (0, import_common14.Req)()),
-  _ts_param13(1, (0, import_common14.Query)("threadId")),
+  (0, import_common15.Get)(),
+  _ts_param13(0, (0, import_common15.Req)()),
+  _ts_param13(1, (0, import_common15.Query)("threadId")),
   _ts_metadata14("design:type", Function),
   _ts_metadata14("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -3101,10 +3143,10 @@ _ts_decorate14([
   _ts_metadata14("design:returntype", Promise)
 ], SkillsController.prototype, "list", null);
 SkillsController = _ts_decorate14([
-  (0, import_common14.Controller)("skills"),
-  _ts_param13(0, (0, import_common14.Inject)(import_nestjs_agent_core14.AGENT_ACTOR_RESOLVER)),
-  _ts_param13(1, (0, import_common14.Optional)()),
-  _ts_param13(1, (0, import_common14.Inject)(import_nestjs_agent_core14.AGENT_SKILLS)),
+  (0, import_common15.Controller)("skills"),
+  _ts_param13(0, (0, import_common15.Inject)(import_nestjs_agent_core15.AGENT_ACTOR_RESOLVER)),
+  _ts_param13(1, (0, import_common15.Optional)()),
+  _ts_param13(1, (0, import_common15.Inject)(import_nestjs_agent_core15.AGENT_SKILLS)),
   _ts_metadata14("design:type", Function),
   _ts_metadata14("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
@@ -3113,8 +3155,8 @@ SkillsController = _ts_decorate14([
 ], SkillsController);
 
 // src/controller/threads.controller.ts
-var import_nestjs_agent_core15 = require("@dudousxd/nestjs-agent-core");
-var import_common15 = require("@nestjs/common");
+var import_nestjs_agent_core16 = require("@dudousxd/nestjs-agent-core");
+var import_common16 = require("@nestjs/common");
 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") {
@@ -3208,8 +3250,8 @@ var ThreadsController = class {
   }
 };
 _ts_decorate15([
-  (0, import_common15.Get)(),
-  _ts_param14(0, (0, import_common15.Req)()),
+  (0, import_common16.Get)(),
+  _ts_param14(0, (0, import_common16.Req)()),
   _ts_metadata15("design:type", Function),
   _ts_metadata15("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
@@ -3217,9 +3259,9 @@ _ts_decorate15([
   _ts_metadata15("design:returntype", Promise)
 ], ThreadsController.prototype, "list", null);
 _ts_decorate15([
-  (0, import_common15.Get)(":id"),
-  _ts_param14(0, (0, import_common15.Req)()),
-  _ts_param14(1, (0, import_common15.Param)("id")),
+  (0, import_common16.Get)(":id"),
+  _ts_param14(0, (0, import_common16.Req)()),
+  _ts_param14(1, (0, import_common16.Param)("id")),
   _ts_metadata15("design:type", Function),
   _ts_metadata15("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -3228,9 +3270,9 @@ _ts_decorate15([
   _ts_metadata15("design:returntype", Promise)
 ], ThreadsController.prototype, "detail", null);
 _ts_decorate15([
-  (0, import_common15.Delete)(":id"),
-  _ts_param14(0, (0, import_common15.Req)()),
-  _ts_param14(1, (0, import_common15.Param)("id")),
+  (0, import_common16.Delete)(":id"),
+  _ts_param14(0, (0, import_common16.Req)()),
+  _ts_param14(1, (0, import_common16.Param)("id")),
   _ts_metadata15("design:type", Function),
   _ts_metadata15("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -3239,10 +3281,10 @@ _ts_decorate15([
   _ts_metadata15("design:returntype", Promise)
 ], ThreadsController.prototype, "remove", null);
 _ts_decorate15([
-  (0, import_common15.Post)(":id/fork-from/:messageId"),
-  _ts_param14(0, (0, import_common15.Req)()),
-  _ts_param14(1, (0, import_common15.Param)("id")),
-  _ts_param14(2, (0, import_common15.Param)("messageId")),
+  (0, import_common16.Post)(":id/fork-from/:messageId"),
+  _ts_param14(0, (0, import_common16.Req)()),
+  _ts_param14(1, (0, import_common16.Param)("id")),
+  _ts_param14(2, (0, import_common16.Param)("messageId")),
   _ts_metadata15("design:type", Function),
   _ts_metadata15("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -3252,10 +3294,10 @@ _ts_decorate15([
   _ts_metadata15("design:returntype", Promise)
 ], ThreadsController.prototype, "fork", null);
 _ts_decorate15([
-  (0, import_common15.Patch)(":id"),
-  _ts_param14(0, (0, import_common15.Req)()),
-  _ts_param14(1, (0, import_common15.Param)("id")),
-  _ts_param14(2, (0, import_common15.Body)()),
+  (0, import_common16.Patch)(":id"),
+  _ts_param14(0, (0, import_common16.Req)()),
+  _ts_param14(1, (0, import_common16.Param)("id")),
+  _ts_param14(2, (0, import_common16.Body)()),
   _ts_metadata15("design:type", Function),
   _ts_metadata15("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -3265,9 +3307,9 @@ _ts_decorate15([
   _ts_metadata15("design:returntype", Promise)
 ], ThreadsController.prototype, "update", null);
 _ts_decorate15([
-  (0, import_common15.Post)(":id/promote"),
-  _ts_param14(0, (0, import_common15.Req)()),
-  _ts_param14(1, (0, import_common15.Param)("id")),
+  (0, import_common16.Post)(":id/promote"),
+  _ts_param14(0, (0, import_common16.Req)()),
+  _ts_param14(1, (0, import_common16.Param)("id")),
   _ts_metadata15("design:type", Function),
   _ts_metadata15("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -3276,10 +3318,10 @@ _ts_decorate15([
   _ts_metadata15("design:returntype", Promise)
 ], ThreadsController.prototype, "promote", null);
 _ts_decorate15([
-  (0, import_common15.Delete)(":id/from/:messageId"),
-  _ts_param14(0, (0, import_common15.Req)()),
-  _ts_param14(1, (0, import_common15.Param)("id")),
-  _ts_param14(2, (0, import_common15.Param)("messageId")),
+  (0, import_common16.Delete)(":id/from/:messageId"),
+  _ts_param14(0, (0, import_common16.Req)()),
+  _ts_param14(1, (0, import_common16.Param)("id")),
+  _ts_param14(2, (0, import_common16.Param)("messageId")),
   _ts_metadata15("design:type", Function),
   _ts_metadata15("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -3289,8 +3331,8 @@ _ts_decorate15([
   _ts_metadata15("design:returntype", Promise)
 ], ThreadsController.prototype, "truncateFrom", null);
 ThreadsController = _ts_decorate15([
-  (0, import_common15.Controller)("threads"),
-  _ts_param14(1, (0, import_common15.Inject)(import_nestjs_agent_core15.AGENT_ACTOR_RESOLVER)),
+  (0, import_common16.Controller)("threads"),
+  _ts_param14(1, (0, import_common16.Inject)(import_nestjs_agent_core16.AGENT_ACTOR_RESOLVER)),
   _ts_metadata15("design:type", Function),
   _ts_metadata15("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -3299,8 +3341,8 @@ ThreadsController = _ts_decorate15([
 ], ThreadsController);
 
 // src/controller/tool-call.controller.ts
-var import_nestjs_agent_core16 = require("@dudousxd/nestjs-agent-core");
-var import_common16 = require("@nestjs/common");
+var import_nestjs_agent_core17 = require("@dudousxd/nestjs-agent-core");
+var import_common17 = require("@nestjs/common");
 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") {
@@ -3335,7 +3377,7 @@ var MAX_VIA_LENGTH = 64;
 var DEFAULT_VIA = "web";
 function toolCallId(claimed) {
   if (typeof claimed !== "string" || claimed.length === 0) {
-    throw new import_common16.BadRequestException("toolCallId must be a non-empty string");
+    throw new import_common17.BadRequestException("toolCallId must be a non-empty string");
   }
   return claimed;
 }
@@ -3345,10 +3387,10 @@ function rejectReason(claimed) {
     return void 0;
   }
   if (typeof claimed !== "string") {
-    throw new import_common16.BadRequestException("reason must be a string");
+    throw new import_common17.BadRequestException("reason must be a string");
   }
   if (claimed.length > MAX_REJECT_REASON_LENGTH) {
-    throw new import_common16.BadRequestException(`reason must be at most ${MAX_REJECT_REASON_LENGTH} characters`);
+    throw new import_common17.BadRequestException(`reason must be at most ${MAX_REJECT_REASON_LENGTH} characters`);
   }
   return claimed;
 }
@@ -3358,7 +3400,7 @@ function remember(claimed) {
     return false;
   }
   if (typeof claimed !== "boolean") {
-    throw new import_common16.BadRequestException("remember must be a boolean");
+    throw new import_common17.BadRequestException("remember must be a boolean");
   }
   return claimed;
 }
@@ -3368,7 +3410,7 @@ function via(claimed) {
     return DEFAULT_VIA;
   }
   if (typeof claimed !== "string" || claimed.length === 0 || claimed.length > MAX_VIA_LENGTH) {
-    throw new import_common16.BadRequestException(`via must be a string of 1-${MAX_VIA_LENGTH} characters`);
+    throw new import_common17.BadRequestException(`via must be a string of 1-${MAX_VIA_LENGTH} characters`);
   }
   return claimed;
 }
@@ -3378,26 +3420,26 @@ function answers(claimed) {
     return void 0;
   }
   if (typeof claimed !== "object" || claimed === null || Array.isArray(claimed)) {
-    throw new import_common16.BadRequestException("answers must be an object of questionId \u2192 chosen values");
+    throw new import_common17.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_common16.BadRequestException(`answers may cover at most ${MAX_ANSWERED_QUESTIONS} questions`);
+    throw new import_common17.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_common16.BadRequestException(`answers["${questionId}"] must be an array of chosen values`);
+      throw new import_common17.BadRequestException(`answers["${questionId}"] must be an array of chosen values`);
     }
     if (values.length > MAX_VALUES_PER_QUESTION) {
-      throw new import_common16.BadRequestException(`answers["${questionId}"] may carry at most ${MAX_VALUES_PER_QUESTION} values`);
+      throw new import_common17.BadRequestException(`answers["${questionId}"] may carry at most ${MAX_VALUES_PER_QUESTION} values`);
     }
     for (const value of values) {
       if (typeof value !== "string") {
-        throw new import_common16.BadRequestException(`answers["${questionId}"] must contain only strings`);
+        throw new import_common17.BadRequestException(`answers["${questionId}"] must contain only strings`);
       }
       if (value.length > MAX_ANSWER_VALUE_LENGTH) {
-        throw new import_common16.BadRequestException(`answers["${questionId}"] values must be at most ${MAX_ANSWER_VALUE_LENGTH} characters`);
+        throw new import_common17.BadRequestException(`answers["${questionId}"] values must be at most ${MAX_ANSWER_VALUE_LENGTH} characters`);
       }
     }
     validated[questionId] = values;
@@ -3460,9 +3502,9 @@ var ToolCallController = class {
   }
 };
 _ts_decorate16([
-  (0, import_common16.Post)("approve"),
-  _ts_param15(0, (0, import_common16.Req)()),
-  _ts_param15(1, (0, import_common16.Body)()),
+  (0, import_common17.Post)("approve"),
+  _ts_param15(0, (0, import_common17.Req)()),
+  _ts_param15(1, (0, import_common17.Body)()),
   _ts_metadata16("design:type", Function),
   _ts_metadata16("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -3471,9 +3513,9 @@ _ts_decorate16([
   _ts_metadata16("design:returntype", Promise)
 ], ToolCallController.prototype, "approve", null);
 _ts_decorate16([
-  (0, import_common16.Post)("reject"),
-  _ts_param15(0, (0, import_common16.Req)()),
-  _ts_param15(1, (0, import_common16.Body)()),
+  (0, import_common17.Post)("reject"),
+  _ts_param15(0, (0, import_common17.Req)()),
+  _ts_param15(1, (0, import_common17.Body)()),
   _ts_metadata16("design:type", Function),
   _ts_metadata16("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -3482,9 +3524,9 @@ _ts_decorate16([
   _ts_metadata16("design:returntype", Promise)
 ], ToolCallController.prototype, "reject", null);
 _ts_decorate16([
-  (0, import_common16.Post)("answer"),
-  _ts_param15(0, (0, import_common16.Req)()),
-  _ts_param15(1, (0, import_common16.Body)()),
+  (0, import_common17.Post)("answer"),
+  _ts_param15(0, (0, import_common17.Req)()),
+  _ts_param15(1, (0, import_common17.Body)()),
   _ts_metadata16("design:type", Function),
   _ts_metadata16("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -3493,9 +3535,9 @@ _ts_decorate16([
   _ts_metadata16("design:returntype", Promise)
 ], ToolCallController.prototype, "answer", null);
 _ts_decorate16([
-  (0, import_common16.Post)("skip"),
-  _ts_param15(0, (0, import_common16.Req)()),
-  _ts_param15(1, (0, import_common16.Body)()),
+  (0, import_common17.Post)("skip"),
+  _ts_param15(0, (0, import_common17.Req)()),
+  _ts_param15(1, (0, import_common17.Body)()),
   _ts_metadata16("design:type", Function),
   _ts_metadata16("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -3504,8 +3546,8 @@ _ts_decorate16([
   _ts_metadata16("design:returntype", Promise)
 ], ToolCallController.prototype, "skip", null);
 ToolCallController = _ts_decorate16([
-  (0, import_common16.Controller)("tool-call"),
-  _ts_param15(1, (0, import_common16.Inject)(import_nestjs_agent_core16.AGENT_ACTOR_RESOLVER)),
+  (0, import_common17.Controller)("tool-call"),
+  _ts_param15(1, (0, import_common17.Inject)(import_nestjs_agent_core17.AGENT_ACTOR_RESOLVER)),
   _ts_metadata16("design:type", Function),
   _ts_metadata16("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -3514,8 +3556,8 @@ ToolCallController = _ts_decorate16([
 ], ToolCallController);
 
 // src/controller/tools.controller.ts
-var import_nestjs_agent_core17 = require("@dudousxd/nestjs-agent-core");
-var import_common17 = require("@nestjs/common");
+var import_nestjs_agent_core18 = require("@dudousxd/nestjs-agent-core");
+var import_common18 = require("@nestjs/common");
 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") {
@@ -3555,11 +3597,11 @@ var ToolsController = class {
     this.agents = agents;
   }
   async list(req, agent) {
-    if (agent !== void 0 && agent !== import_nestjs_agent_core17.ALL_AGENTS && this.agents.get(agent) === void 0) {
-      throw new import_common17.NotFoundException(`No agent named "${agent}"`);
+    if (agent !== void 0 && agent !== import_nestjs_agent_core18.ALL_AGENTS && this.agents.get(agent) === void 0) {
+      throw new import_common18.NotFoundException(`No agent named "${agent}"`);
     }
     const actor = await this.actorResolver.resolve(req);
-    const names = agent === import_nestjs_agent_core17.ALL_AGENTS ? [
+    const names = agent === import_nestjs_agent_core18.ALL_AGENTS ? [
       void 0,
       ...this.agents.list().map((definition) => definition.name)
     ] : [
@@ -3586,9 +3628,9 @@ var ToolsController = class {
   }
 };
 _ts_decorate17([
-  (0, import_common17.Get)(),
-  _ts_param16(0, (0, import_common17.Req)()),
-  _ts_param16(1, (0, import_common17.Query)("agent")),
+  (0, import_common18.Get)(),
+  _ts_param16(0, (0, import_common18.Req)()),
+  _ts_param16(1, (0, import_common18.Query)("agent")),
   _ts_metadata17("design:type", Function),
   _ts_metadata17("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
@@ -3597,21 +3639,21 @@ _ts_decorate17([
   _ts_metadata17("design:returntype", Promise)
 ], ToolsController.prototype, "list", null);
 ToolsController = _ts_decorate17([
-  (0, import_common17.Controller)("tools"),
-  _ts_param16(0, (0, import_common17.Inject)(import_nestjs_agent_core17.AGENT_ACTOR_RESOLVER)),
-  _ts_param16(1, (0, import_common17.Inject)(import_nestjs_agent_core17.AGENT_DEPS_FACTORY)),
-  _ts_param16(2, (0, import_common17.Inject)(import_nestjs_agent_core17.AGENT_REGISTRY)),
+  (0, import_common18.Controller)("tools"),
+  _ts_param16(0, (0, import_common18.Inject)(import_nestjs_agent_core18.AGENT_ACTOR_RESOLVER)),
+  _ts_param16(1, (0, import_common18.Inject)(import_nestjs_agent_core18.AGENT_DEPS_FACTORY)),
+  _ts_param16(2, (0, import_common18.Inject)(import_nestjs_agent_core18.AGENT_REGISTRY)),
   _ts_metadata17("design:type", Function),
   _ts_metadata17("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
-    typeof import_nestjs_agent_core17.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core17.AgentRegistry
+    typeof import_nestjs_agent_core18.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core18.AgentRegistry
   ])
 ], ToolsController);
 
 // src/discovery/agent-discovery.service.ts
-var import_nestjs_agent_core18 = require("@dudousxd/nestjs-agent-core");
-var import_common18 = require("@nestjs/common");
+var import_nestjs_agent_core19 = require("@dudousxd/nestjs-agent-core");
+var import_common19 = require("@nestjs/common");
 var import_core = require("@nestjs/core");
 
 // src/decorator/agent.decorator.ts
@@ -3680,7 +3722,7 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
   scanner;
   registry;
   contributors;
-  logger = new import_common18.Logger(_AgentDiscoveryService.name);
+  logger = new import_common19.Logger(_AgentDiscoveryService.name);
   constructor(discovery, scanner, registry, contributors) {
     this.discovery = discovery;
     this.scanner = scanner;
@@ -3799,21 +3841,21 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
   }
 };
 AgentDiscoveryService = _ts_decorate18([
-  (0, import_common18.Injectable)(),
-  _ts_param17(2, (0, import_common18.Inject)(import_nestjs_agent_core18.AGENT_REGISTRY)),
-  _ts_param17(3, (0, import_common18.Inject)(import_nestjs_agent_core18.AGENT_PROMPT_CONTRIBUTORS)),
+  (0, import_common19.Injectable)(),
+  _ts_param17(2, (0, import_common19.Inject)(import_nestjs_agent_core19.AGENT_REGISTRY)),
+  _ts_param17(3, (0, import_common19.Inject)(import_nestjs_agent_core19.AGENT_PROMPT_CONTRIBUTORS)),
   _ts_metadata18("design:type", Function),
   _ts_metadata18("design:paramtypes", [
     typeof import_core.DiscoveryService === "undefined" ? Object : import_core.DiscoveryService,
     typeof import_core.MetadataScanner === "undefined" ? Object : import_core.MetadataScanner,
-    typeof import_nestjs_agent_core18.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core18.AgentRegistry,
+    typeof import_nestjs_agent_core19.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core19.AgentRegistry,
     Array
   ])
 ], AgentDiscoveryService);
 
 // src/discovery/ai-tool-discovery.service.ts
-var import_nestjs_agent_core19 = require("@dudousxd/nestjs-agent-core");
-var import_common19 = require("@nestjs/common");
+var import_nestjs_agent_core20 = require("@dudousxd/nestjs-agent-core");
+var import_common20 = require("@nestjs/common");
 var import_core2 = require("@nestjs/core");
 var import_zod = require("zod");
 
@@ -3918,7 +3960,7 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
   registry;
   agents;
   options;
-  logger = new import_common19.Logger(_AiToolDiscoveryService.name);
+  logger = new import_common20.Logger(_AiToolDiscoveryService.name);
   constructor(discovery, registry, agents, options) {
     this.discovery = discovery;
     this.registry = registry;
@@ -4003,7 +4045,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_core19.normalizeDelegation)(edge);
+        const { agent: target, detached } = (0, import_nestjs_agent_core20.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.`);
@@ -4054,10 +4096,10 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
   }
 };
 AiToolDiscoveryService = _ts_decorate19([
-  (0, import_common19.Injectable)(),
-  _ts_param18(1, (0, import_common19.Inject)(import_nestjs_agent_core19.AGENT_TOOL_REGISTRY)),
-  _ts_param18(2, (0, import_common19.Inject)(import_nestjs_agent_core19.AGENT_REGISTRY)),
-  _ts_param18(3, (0, import_common19.Inject)(import_nestjs_agent_core19.AGENT_OPTIONS)),
+  (0, import_common20.Injectable)(),
+  _ts_param18(1, (0, import_common20.Inject)(import_nestjs_agent_core20.AGENT_TOOL_REGISTRY)),
+  _ts_param18(2, (0, import_common20.Inject)(import_nestjs_agent_core20.AGENT_REGISTRY)),
+  _ts_param18(3, (0, import_common20.Inject)(import_nestjs_agent_core20.AGENT_OPTIONS)),
   _ts_metadata19("design:type", Function),
   _ts_metadata19("design:paramtypes", [
     typeof import_core2.DiscoveryService === "undefined" ? Object : import_core2.DiscoveryService,
@@ -4068,13 +4110,13 @@ AiToolDiscoveryService = _ts_decorate19([
 ], AiToolDiscoveryService);
 
 // src/discovery/skill-discovery.service.ts
-var import_nestjs_agent_core21 = require("@dudousxd/nestjs-agent-core");
-var import_common20 = require("@nestjs/common");
+var import_nestjs_agent_core22 = require("@dudousxd/nestjs-agent-core");
+var import_common21 = 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_core20 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core21 = require("@dudousxd/nestjs-agent-core");
 var SKILL_METADATA = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:skill-metadata");
 function Skill(options) {
   return (target) => {
@@ -4087,7 +4129,7 @@ function readSkillMetadata(target) {
 }
 __name(readSkillMetadata, "readSkillMetadata");
 function skillScope(options) {
-  return options.scope ?? import_nestjs_agent_core20.GLOBAL_SCOPE;
+  return options.scope ?? import_nestjs_agent_core21.GLOBAL_SCOPE;
 }
 __name(skillScope, "skillScope");
 
@@ -4124,7 +4166,7 @@ var SkillDiscoveryService = class _SkillDiscoveryService {
   }
   discovery;
   declared;
-  logger = new import_common20.Logger(_SkillDiscoveryService.name);
+  logger = new import_common21.Logger(_SkillDiscoveryService.name);
   constructor(discovery, declared) {
     this.discovery = discovery;
     this.declared = declared;
@@ -4162,8 +4204,8 @@ var SkillDiscoveryService = class _SkillDiscoveryService {
   }
 };
 SkillDiscoveryService = _ts_decorate20([
-  (0, import_common20.Injectable)(),
-  _ts_param19(1, (0, import_common20.Inject)(import_nestjs_agent_core21.AGENT_SKILL_SOURCES)),
+  (0, import_common21.Injectable)(),
+  _ts_param19(1, (0, import_common21.Inject)(import_nestjs_agent_core22.AGENT_SKILL_SOURCES)),
   _ts_metadata20("design:type", Function),
   _ts_metadata20("design:paramtypes", [
     typeof import_core3.DiscoveryService === "undefined" ? Object : import_core3.DiscoveryService,
@@ -4172,7 +4214,7 @@ SkillDiscoveryService = _ts_decorate20([
 ], SkillDiscoveryService);
 
 // src/in-process-sink.ts
-var import_nestjs_agent_core22 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core23 = require("@dudousxd/nestjs-agent-core");
 var InProcessTokenStreamSink = class {
   static {
     __name(this, "InProcessTokenStreamSink");
@@ -4227,7 +4269,7 @@ var InProcessTokenStreamSink = class {
       }
       if (buf.ended) {
         if (buf.failure !== void 0) {
-          throw new import_nestjs_agent_core22.AgentStreamError(buf.failure);
+          throw new import_nestjs_agent_core23.AgentStreamError(buf.failure);
         }
         return;
       }
@@ -4240,7 +4282,7 @@ var InProcessTokenStreamSink = class {
 };
 
 // src/ledger-quota-provider.ts
-var import_nestjs_agent_core23 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core24 = require("@dudousxd/nestjs-agent-core");
 var LedgerQuotaProvider = class {
   static {
     __name(this, "LedgerQuotaProvider");
@@ -4260,12 +4302,12 @@ var LedgerQuotaProvider = class {
       await this.dayWindow(actorRef, now)
     ];
     if (this.store.usageBetween !== void 0) {
-      const range = (0, import_nestjs_agent_core23.quotaPeriodRange)("month", now);
+      const range = (0, import_nestjs_agent_core24.quotaPeriodRange)("month", now);
       const used = await this.store.usageBetween(actorRef, range.fromDay, range.toDay);
       windows.push(this.window("month", used.usedTokens, used.costUsd, range.resetsAt));
     }
-    const blocked = (0, import_nestjs_agent_core23.exhaustedWindow)(windows);
-    const warning = (0, import_nestjs_agent_core23.quotaWarning)(windows);
+    const blocked = (0, import_nestjs_agent_core24.exhaustedWindow)(windows);
+    const warning = (0, import_nestjs_agent_core24.quotaWarning)(windows);
     return {
       windows,
       ...blocked !== void 0 ? {
@@ -4277,7 +4319,7 @@ var LedgerQuotaProvider = class {
     };
   }
   async dayWindow(actorRef, now) {
-    const range = (0, import_nestjs_agent_core23.quotaPeriodRange)("day", now);
+    const range = (0, import_nestjs_agent_core24.quotaPeriodRange)("day", now);
     const { usedTokens, costUsd } = await this.store.quotaToday(actorRef, range.fromDay);
     return this.window("day", usedTokens, costUsd, range.resetsAt);
   }
@@ -4302,8 +4344,8 @@ var LedgerQuotaProvider = class {
 };
 
 // src/runner/inline-agent-runner.ts
-var import_nestjs_agent_core24 = require("@dudousxd/nestjs-agent-core");
-var import_common21 = require("@nestjs/common");
+var import_nestjs_agent_core25 = require("@dudousxd/nestjs-agent-core");
+var import_common22 = require("@nestjs/common");
 function _ts_decorate21(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") {
@@ -4337,7 +4379,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
   factory;
   store;
   queue;
-  logger = new import_common21.Logger(_InlineAgentRunner.name);
+  logger = new import_common22.Logger(_InlineAgentRunner.name);
   pending = /* @__PURE__ */ new Map();
   /**
   * Runs someone has asked to stop. In-process, like `pending`, and for the same reason: this runner
@@ -4357,7 +4399,15 @@ var InlineAgentRunner = class _InlineAgentRunner {
   * that was running it is gone (a restart), and a thread it still holds is a stale claim.
   */
   async isRunActive(runId) {
-    return this.live.has(runId);
+    if (this.live.has(runId)) {
+      return true;
+    }
+    for (const key of this.pending.keys()) {
+      if (key.startsWith(`${runId}:`)) {
+        return true;
+      }
+    }
+    return false;
   }
   async start(input, options = {}) {
     const runId = options.runId ?? crypto.randomUUID();
@@ -4378,18 +4428,18 @@ var InlineAgentRunner = class _InlineAgentRunner {
       ],
       input
     });
-    void (0, import_nestjs_agent_core24.runAgentLoop)({
+    void (0, import_nestjs_agent_core25.runAgentLoop)({
       ...deps,
       day
-    }, input, hooks).then(() => (0, import_nestjs_agent_core24.releaseThreadRun)(this.store, input.threadId, runId)).catch(async (error) => {
-      if (error instanceof import_nestjs_agent_core24.RunCancelledError) {
+    }, input, hooks).then(() => (0, import_nestjs_agent_core25.releaseThreadRun)(this.store, input.threadId, runId)).catch(async (error) => {
+      if (error instanceof import_nestjs_agent_core25.RunCancelledError) {
         await this.settleCancelled(runId, input, deps);
         return;
       }
       const message = error instanceof Error ? error.message : String(error);
-      const code = (0, import_nestjs_agent_core24.agentFailureCode)(error);
+      const code = (0, import_nestjs_agent_core25.agentFailureCode)(error);
       this.logger.error(`agent run ${runId} failed (${code}): ${message}`);
-      (0, import_nestjs_agent_core24.publishAgentRunFailed)({
+      (0, import_nestjs_agent_core25.publishAgentRunFailed)({
         runId,
         code,
         message
@@ -4400,13 +4450,11 @@ var InlineAgentRunner = class _InlineAgentRunner {
         errorCode: code,
         errorMessage: message
       });
+      await Promise.resolve(this.store.failUnsettledToolCalls?.(runId, import_nestjs_agent_core25.RUN_ENDED_BEFORE_TOOL_CALL)).catch(() => 0);
       const writer = await deps.sink.open(runId);
       await this.settleQueue(writer, input, runId, "failed", message);
-      await (0, import_nestjs_agent_core24.releaseThreadRun)(this.store, input.threadId, runId);
-      await writer.fail({
-        code,
-        message
-      });
+      await (0, import_nestjs_agent_core25.releaseThreadRun)(this.store, input.threadId, runId);
+      await writer.fail((0, import_nestjs_agent_core25.streamFailure)(error));
     }).finally(() => {
       this.cancelled.delete(runId);
       this.live.delete(runId);
@@ -4442,7 +4490,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_core24.RunCancelledError());
+        waiter.reject(new import_nestjs_agent_core25.RunCancelledError());
       }
     }
     await Promise.resolve();
@@ -4457,8 +4505,8 @@ var InlineAgentRunner = class _InlineAgentRunner {
     this.logger.log(`agent run ${runId} cancelled`);
     const writer = await deps.sink.open(runId);
     await this.settleQueue(writer, input, runId, "cancelled");
-    await (0, import_nestjs_agent_core24.releaseThreadRun)(this.store, input.threadId, runId);
-    await writer.write((0, import_nestjs_agent_core24.encodeStreamEvent)({
+    await (0, import_nestjs_agent_core25.releaseThreadRun)(this.store, input.threadId, runId);
+    await writer.write((0, import_nestjs_agent_core25.encodeStreamEvent)({
       kind: "cancelled"
     }));
     await writer.end();
@@ -4493,7 +4541,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
         runId: nextRunId
       }));
       if (frame !== void 0) {
-        await writer.write((0, import_nestjs_agent_core24.encodeStreamEvent)(frame));
+        await writer.write((0, import_nestjs_agent_core25.encodeStreamEvent)(frame));
       }
     } catch (failure) {
       this.logger.error(`could not advance the queue of thread ${input.threadId} after run ${runId}: ${failure instanceof Error ? failure.message : String(failure)}`);
@@ -4564,7 +4612,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_core24.settleAll,
+      parallel: import_nestjs_agent_core25.settleAll,
       cancelled: /* @__PURE__ */ __name(async () => this.cancelled.has(runId), "cancelled"),
       runAgent: /* @__PURE__ */ __name((agentName, task) => this.runNested({
         agentName,
@@ -4615,7 +4663,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_core24.settleAll,
+      parallel: import_nestjs_agent_core25.settleAll,
       cancelled: /* @__PURE__ */ __name(async () => this.cancelled.has(runId), "cancelled"),
       runAgent: /* @__PURE__ */ __name((childName, childTask) => this.runNested({
         agentName: childName,
@@ -4648,7 +4696,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
         }
       }), "startAgent")
     };
-    void (0, import_nestjs_agent_core24.runAgentLoop)({
+    void (0, import_nestjs_agent_core25.runAgentLoop)({
       ...deps,
       day
     }, {
@@ -4662,13 +4710,13 @@ var InlineAgentRunner = class _InlineAgentRunner {
       parentRunId,
       deliverTo
     }, hooks).catch(async (error) => {
-      const cancelled = error instanceof import_nestjs_agent_core24.RunCancelledError;
+      const cancelled = error instanceof import_nestjs_agent_core25.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_core24.publishAgentRunFailed)({
+        (0, import_nestjs_agent_core25.publishAgentRunFailed)({
           runId,
-          code: (0, import_nestjs_agent_core24.agentFailureCode)(error),
+          code: (0, import_nestjs_agent_core25.agentFailureCode)(error),
           message
         });
       }
@@ -4676,11 +4724,12 @@ var InlineAgentRunner = class _InlineAgentRunner {
         runId,
         status: cancelled ? "cancelled" : "failed",
         ...cancelled ? {} : {
-          errorCode: (0, import_nestjs_agent_core24.agentFailureCode)(error),
+          errorCode: (0, import_nestjs_agent_core25.agentFailureCode)(error),
           errorMessage: message
         }
       });
-      await (0, import_nestjs_agent_core24.settleUnsettledDelegation)({
+      await Promise.resolve(this.store.failUnsettledToolCalls?.(runId, import_nestjs_agent_core25.RUN_ENDED_BEFORE_TOOL_CALL)).catch(() => 0);
+      await (0, import_nestjs_agent_core25.settleUnsettledDelegation)({
         store: this.store,
         delivery: deliverTo,
         agent: agentName,
@@ -4719,7 +4768,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_core24.settleAll,
+      parallel: import_nestjs_agent_core25.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"),
@@ -4754,7 +4803,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
       }), "startAgent")
     };
     try {
-      return await (0, import_nestjs_agent_core24.runAgentLoop)({
+      return await (0, import_nestjs_agent_core25.runAgentLoop)({
         ...deps,
         day
       }, {
@@ -4774,10 +4823,10 @@ var InlineAgentRunner = class _InlineAgentRunner {
   }
 };
 InlineAgentRunner = _ts_decorate21([
-  (0, import_common21.Injectable)(),
-  _ts_param20(0, (0, import_common21.Inject)(import_nestjs_agent_core24.AGENT_DEPS_FACTORY)),
-  _ts_param20(1, (0, import_common21.Inject)(import_nestjs_agent_core24.AGENT_STORE)),
-  _ts_param20(2, (0, import_common21.Optional)()),
+  (0, import_common22.Injectable)(),
+  _ts_param20(0, (0, import_common22.Inject)(import_nestjs_agent_core25.AGENT_DEPS_FACTORY)),
+  _ts_param20(1, (0, import_common22.Inject)(import_nestjs_agent_core25.AGENT_STORE)),
+  _ts_param20(2, (0, import_common22.Optional)()),
   _ts_metadata21("design:type", Function),
   _ts_metadata21("design:paramtypes", [
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
@@ -4791,7 +4840,7 @@ function isThreadTurn(input) {
 __name(isThreadTurn, "isThreadTurn");
 
 // src/skills-config.ts
-var import_nestjs_agent_core25 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core26 = require("@dudousxd/nestjs-agent-core");
 function declaredSkillProvider(declared) {
   return {
     list: /* @__PURE__ */ __name(({ scopes }) => declared.filter((skill) => scopes.includes(skill.scope)).map(({ name, description, scope }) => ({
@@ -4817,7 +4866,7 @@ function resolveSkillsConfig(options, declared) {
     declaredSkillProvider(declared)
   ];
   return {
-    provider: providers.length === 1 ? providers[0] : (0, import_nestjs_agent_core25.compositeSkillProvider)(providers),
+    provider: providers.length === 1 ? providers[0] : (0, import_nestjs_agent_core26.compositeSkillProvider)(providers),
     ...options.scopes !== void 0 ? {
       scopes: options.scopes
     } : {},
@@ -4844,11 +4893,11 @@ function _ts_decorate22(decorators, target, key, desc) {
 }
 __name(_ts_decorate22, "_ts_decorate");
 var DEFAULT_PATH = "agent";
-var logger = new import_common22.Logger("AgentModule");
+var logger = new import_common23.Logger("AgentModule");
 function externalStoreWrapper(modules) {
   for (const module2 of modules.values()) {
     if (module2.metatype === AgentModule) continue;
-    const wrapper = module2.providers.get(import_nestjs_agent_core26.AGENT_STORE);
+    const wrapper = module2.providers.get(import_nestjs_agent_core27.AGENT_STORE);
     if (wrapper !== void 0) return wrapper;
   }
   return void 0;
@@ -4879,7 +4928,7 @@ function resolveStore(options, modules) {
   const external = externalStoreWrapper(modules);
   if (external !== void 0) return forwardingStore(external);
   logger.warn("No `store` configured and no store module imported \u2014 using the in-memory store. Threads are lost on restart and not shared between processes: not for production. Pass `store`, or import a store module (e.g. MikroOrmAgentStoreModule.forFeature()).");
-  return new import_nestjs_agent_core26.InMemoryAgentStore();
+  return new import_nestjs_agent_core27.InMemoryAgentStore();
 }
 __name(resolveStore, "resolveStore");
 function isQuotaProvider(quota) {
@@ -4895,99 +4944,99 @@ __name(resolveCatalog, "resolveCatalog");
 function sharedProviders(durable) {
   const providers = [
     {
-      provide: import_nestjs_agent_core26.AGENT_TOOL_REGISTRY,
-      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core26.ToolRegistry(), "useFactory")
+      provide: import_nestjs_agent_core27.AGENT_TOOL_REGISTRY,
+      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core27.ToolRegistry(), "useFactory")
     },
     // Starts empty; AgentDiscoveryService populates it from `@Agent`-decorated providers at boot.
     {
-      provide: import_nestjs_agent_core26.AGENT_REGISTRY,
-      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core26.AgentRegistry(), "useFactory")
+      provide: import_nestjs_agent_core27.AGENT_REGISTRY,
+      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core27.AgentRegistry(), "useFactory")
     },
     // A shared, mutable list AgentDiscoveryService fills with `@SystemPromptContributor()` methods.
     {
-      provide: import_nestjs_agent_core26.AGENT_PROMPT_CONTRIBUTORS,
+      provide: import_nestjs_agent_core27.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_core26.AGENT_SKILL_SOURCES,
+      provide: import_nestjs_agent_core27.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_core26.AGENT_SKILLS,
+      provide: import_nestjs_agent_core27.AGENT_SKILLS,
       useFactory: /* @__PURE__ */ __name((options, declared) => resolveSkillsConfig(options.skills, declared), "useFactory"),
       inject: [
-        import_nestjs_agent_core26.AGENT_OPTIONS,
-        import_nestjs_agent_core26.AGENT_SKILL_SOURCES
+        import_nestjs_agent_core27.AGENT_OPTIONS,
+        import_nestjs_agent_core27.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_core26.AGENT_MEMORY,
+      provide: import_nestjs_agent_core27.AGENT_MEMORY,
       useFactory: /* @__PURE__ */ __name((options) => options.memory, "useFactory"),
       inject: [
-        import_nestjs_agent_core26.AGENT_OPTIONS
+        import_nestjs_agent_core27.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core26.AGENT_SINK,
+      provide: import_nestjs_agent_core27.AGENT_SINK,
       useFactory: /* @__PURE__ */ __name((options) => options.sink ?? new InProcessTokenStreamSink(), "useFactory"),
       inject: [
-        import_nestjs_agent_core26.AGENT_OPTIONS
+        import_nestjs_agent_core27.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core26.AGENT_ROLES_POLICY,
-      useFactory: /* @__PURE__ */ __name((options) => options.rolesPolicy ?? new import_nestjs_agent_core26.DefaultRolesPolicy(options.defaultRoles), "useFactory"),
+      provide: import_nestjs_agent_core27.AGENT_ROLES_POLICY,
+      useFactory: /* @__PURE__ */ __name((options) => options.rolesPolicy ?? new import_nestjs_agent_core27.DefaultRolesPolicy(options.defaultRoles), "useFactory"),
       inject: [
-        import_nestjs_agent_core26.AGENT_OPTIONS
+        import_nestjs_agent_core27.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core26.AGENT_ACTOR_RESOLVER,
+      provide: import_nestjs_agent_core27.AGENT_ACTOR_RESOLVER,
       useFactory: /* @__PURE__ */ __name((options) => {
         if (options.actorResolver !== void 0) return options.actorResolver;
         logger.warn("No `actorResolver` configured \u2014 the agent endpoints are PUBLIC: every browser gets its own anonymous identity (an HttpOnly cookie). Set `actorResolver: requestUserActorResolver()` (or your own) to require login.");
         return new AnonymousActorResolver();
       }, "useFactory"),
       inject: [
-        import_nestjs_agent_core26.AGENT_OPTIONS
+        import_nestjs_agent_core27.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core26.AGENT_MODEL,
+      provide: import_nestjs_agent_core27.AGENT_MODEL,
       useFactory: /* @__PURE__ */ __name((o) => o.model, "useFactory"),
       inject: [
-        import_nestjs_agent_core26.AGENT_OPTIONS
+        import_nestjs_agent_core27.AGENT_OPTIONS
       ]
     },
     {
       // `quota` is either a provider of the host's own or ceilings for the built-in ledger one;
       // omitted, the ledger provider still reports usage, with no ceiling to block on.
-      provide: import_nestjs_agent_core26.AGENT_QUOTA_PROVIDER,
+      provide: import_nestjs_agent_core27.AGENT_QUOTA_PROVIDER,
       useFactory: /* @__PURE__ */ __name((o, store) => isQuotaProvider(o.quota) ? o.quota : new LedgerQuotaProvider(store, o.quota?.limits, o.quota?.warnAt !== void 0 ? {
         warnAt: o.quota.warnAt
       } : {}), "useFactory"),
       inject: [
-        import_nestjs_agent_core26.AGENT_OPTIONS,
-        import_nestjs_agent_core26.AGENT_STORE
+        import_nestjs_agent_core27.AGENT_OPTIONS,
+        import_nestjs_agent_core27.AGENT_STORE
       ]
     },
     {
-      provide: import_nestjs_agent_core26.AGENT_MODEL_CATALOG,
+      provide: import_nestjs_agent_core27.AGENT_MODEL_CATALOG,
       useFactory: /* @__PURE__ */ __name((o) => resolveCatalog(o), "useFactory"),
       inject: [
-        import_nestjs_agent_core26.AGENT_OPTIONS
+        import_nestjs_agent_core27.AGENT_OPTIONS
       ]
     },
     AgentDepsFactory2,
     {
-      provide: import_nestjs_agent_core26.AGENT_DEPS_FACTORY,
+      provide: import_nestjs_agent_core27.AGENT_DEPS_FACTORY,
       useExisting: AgentDepsFactory2
     },
     // Populates the registry + contributors (onModuleInit) BEFORE AiToolDiscoveryService synthesizes
@@ -5004,21 +5053,21 @@ function sharedProviders(durable) {
     // through AgentService.signalToolCall, which reaches whichever AGENT_RUNNER is bound above.
     AgentApprovalPortAdapter,
     {
-      provide: import_nestjs_agent_core26.AGENT_APPROVAL_PORT,
+      provide: import_nestjs_agent_core27.AGENT_APPROVAL_PORT,
       useExisting: AgentApprovalPortAdapter
     }
   ];
   providers.push({
-    provide: import_nestjs_agent_core26.AGENT_STORE,
+    provide: import_nestjs_agent_core27.AGENT_STORE,
     useFactory: /* @__PURE__ */ __name((o, modules) => resolveStore(o, modules), "useFactory"),
     inject: [
-      import_nestjs_agent_core26.AGENT_OPTIONS,
+      import_nestjs_agent_core27.AGENT_OPTIONS,
       import_core4.ModulesContainer
     ]
   });
   if (durable) {
     providers.push({
-      provide: import_nestjs_agent_core26.AGENT_RUNNER,
+      provide: import_nestjs_agent_core27.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.");
@@ -5027,14 +5076,14 @@ function sharedProviders(durable) {
       }, "useFactory"),
       inject: [
         {
-          token: import_nestjs_agent_core26.AGENT_DURABLE_RUNNER,
+          token: import_nestjs_agent_core27.AGENT_DURABLE_RUNNER,
           optional: true
         }
       ]
     });
   } else {
     providers.push({
-      provide: import_nestjs_agent_core26.AGENT_RUNNER,
+      provide: import_nestjs_agent_core27.AGENT_RUNNER,
       useExisting: InlineAgentRunner
     });
   }
@@ -5043,25 +5092,25 @@ function sharedProviders(durable) {
 __name(sharedProviders, "sharedProviders");
 function exportsFor() {
   return [
-    import_nestjs_agent_core26.AGENT_OPTIONS,
-    import_nestjs_agent_core26.AGENT_TOOL_REGISTRY,
-    import_nestjs_agent_core26.AGENT_REGISTRY,
-    import_nestjs_agent_core26.AGENT_SINK,
-    import_nestjs_agent_core26.AGENT_ROLES_POLICY,
-    import_nestjs_agent_core26.AGENT_ACTOR_RESOLVER,
-    import_nestjs_agent_core26.AGENT_MODEL,
-    import_nestjs_agent_core26.AGENT_STORE,
-    import_nestjs_agent_core26.AGENT_MODEL_CATALOG,
-    import_nestjs_agent_core26.AGENT_QUOTA_PROVIDER,
-    import_nestjs_agent_core26.AGENT_PROMPT_CONTRIBUTORS,
-    import_nestjs_agent_core26.AGENT_SKILLS,
-    import_nestjs_agent_core26.AGENT_MEMORY,
-    import_nestjs_agent_core26.AGENT_DEPS_FACTORY,
+    import_nestjs_agent_core27.AGENT_OPTIONS,
+    import_nestjs_agent_core27.AGENT_TOOL_REGISTRY,
+    import_nestjs_agent_core27.AGENT_REGISTRY,
+    import_nestjs_agent_core27.AGENT_SINK,
+    import_nestjs_agent_core27.AGENT_ROLES_POLICY,
+    import_nestjs_agent_core27.AGENT_ACTOR_RESOLVER,
+    import_nestjs_agent_core27.AGENT_MODEL,
+    import_nestjs_agent_core27.AGENT_STORE,
+    import_nestjs_agent_core27.AGENT_MODEL_CATALOG,
+    import_nestjs_agent_core27.AGENT_QUOTA_PROVIDER,
+    import_nestjs_agent_core27.AGENT_PROMPT_CONTRIBUTORS,
+    import_nestjs_agent_core27.AGENT_SKILLS,
+    import_nestjs_agent_core27.AGENT_MEMORY,
+    import_nestjs_agent_core27.AGENT_DEPS_FACTORY,
     AgentDepsFactory2,
     AgentService,
     ChatQueueService,
     InlineAgentRunner,
-    import_nestjs_agent_core26.AGENT_APPROVAL_PORT
+    import_nestjs_agent_core27.AGENT_APPROVAL_PORT
   ];
 }
 __name(exportsFor, "exportsFor");
@@ -5125,7 +5174,7 @@ var AgentModule = class _AgentModule {
       controllers: controllersForSurface(options.surface),
       providers: [
         {
-          provide: import_nestjs_agent_core26.AGENT_OPTIONS,
+          provide: import_nestjs_agent_core27.AGENT_OPTIONS,
           useValue: options
         },
         ...sharedProviders(options.durable ?? false),
@@ -5148,7 +5197,7 @@ var AgentModule = class _AgentModule {
       controllers: controllersForSurface(options.surface),
       providers: [
         {
-          provide: import_nestjs_agent_core26.AGENT_OPTIONS,
+          provide: import_nestjs_agent_core27.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
@@ -5170,12 +5219,12 @@ var AgentModule = class _AgentModule {
   }
 };
 AgentModule = _ts_decorate22([
-  (0, import_common22.Global)(),
-  (0, import_common22.Module)({})
+  (0, import_common23.Global)(),
+  (0, import_common23.Module)({})
 ], AgentModule);
 
 // src/resolver/header-actor-resolver.ts
-var import_common23 = require("@nestjs/common");
+var import_common24 = require("@nestjs/common");
 function readHeader(req, name) {
   if (typeof req !== "object" || req === null || !("headers" in req)) return void 0;
   const { headers } = req;
@@ -5191,7 +5240,7 @@ var HeaderActorResolver = class {
   resolve(req) {
     const id = readHeader(req, "x-actor-id");
     if (id === void 0 || id.length === 0) {
-      throw new import_common23.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_common24.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");
@@ -5206,7 +5255,7 @@ var HeaderActorResolver = class {
 };
 
 // src/resolver/request-user-actor-resolver.ts
-var import_common24 = require("@nestjs/common");
+var import_common25 = require("@nestjs/common");
 function field(user, ...names) {
   for (const name of names) {
     const value = user[name];
@@ -5218,7 +5267,7 @@ __name(field, "field");
 function defaultRequestUserMapper(user) {
   const id = field(user, "id", "sub", "_id", "userId");
   if (id === void 0) {
-    throw new import_common24.UnauthorizedException("requestUserActorResolver: req.user has no id/sub/_id/userId \u2014 pass a mapper: requestUserActorResolver((user) => ({ id: \u2026, roles: \u2026 }))");
+    throw new import_common25.UnauthorizedException("requestUserActorResolver: req.user has no id/sub/_id/userId \u2014 pass a mapper: requestUserActorResolver((user) => ({ id: \u2026, roles: \u2026 }))");
   }
   const rawRoles = field(user, "roles", "role");
   const roles = Array.isArray(rawRoles) ? rawRoles.map(String) : typeof rawRoles === "string" ? [
@@ -5239,7 +5288,7 @@ function requestUserActorResolver(map) {
     async resolve(req) {
       const user = typeof req === "object" && req !== null ? req.user : void 0;
       if (user === void 0 || user === null || user === false) {
-        throw new import_common24.UnauthorizedException("Sign in to use the agent.");
+        throw new import_common25.UnauthorizedException("Sign in to use the agent.");
       }
       if (map !== void 0) return map(user, req);
       return defaultRequestUserMapper(user);
@@ -5279,6 +5328,7 @@ __reExport(index_exports, require("@dudousxd/nestjs-agent-core"), module.exports
   MessagesController,
   ModelsController,
   QueueController,
+  RunNotActiveException,
   SKILL_METADATA,
   SYSTEM_PROMPT_CONTRIBUTOR_METADATA,
   SYSTEM_PROMPT_METADATA,