@dudousxd/nestjs-agent 1.14.0 → 1.15.0

package/dist/durable/index.cjs

@@ -30,10 +30,10 @@ __export(durable_exports, {
 module.exports = __toCommonJS(durable_exports);
 
 // src/durable/agent-run.workflow.ts
-var import_nestjs_agent_core2 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core3 = require("@dudousxd/nestjs-agent-core");
 var import_nestjs_durable2 = require("@dudousxd/nestjs-durable");
 var import_nestjs_durable_core = require("@dudousxd/nestjs-durable-core");
-var import_common2 = require("@nestjs/common");
+var import_common3 = require("@nestjs/common");
 
 // src/agent-deps.ts
 function utcDay(date = /* @__PURE__ */ new Date()) {
@@ -51,9 +51,8 @@ function childSinkWriter(writer) {
 }
 __name(childSinkWriter, "childSinkWriter");
 
-// src/durable/agent-run.steps.ts
+// src/queue/chat-queue.service.ts
 var import_nestjs_agent_core = require("@dudousxd/nestjs-agent-core");
-var import_nestjs_durable = require("@dudousxd/nestjs-durable");
 var import_common = require("@nestjs/common");
 function _ts_decorate(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -81,6 +80,434 @@ function _ts_param(paramIndex, decorator) {
   };
 }
 __name(_ts_param, "_ts_param");
+var MAX_DRAIN_ATTEMPTS = 8;
+var ChatQueueService = class _ChatQueueService {
+  static {
+    __name(this, "ChatQueueService");
+  }
+  store;
+  sink;
+  quotaProvider;
+  options;
+  staging;
+  logger = new import_common.Logger(_ChatQueueService.name);
+  /**
+  * Runs this process claimed a thread for and has not handed to a runner yet. A holder in here is
+  * alive whatever the runner says — it simply has not registered the run yet.
+  */
+  starting = /* @__PURE__ */ new Set();
+  constructor(store, sink, quotaProvider, options, staging) {
+    this.store = store;
+    this.sink = sink;
+    this.quotaProvider = quotaProvider;
+    this.options = options;
+    this.staging = staging;
+  }
+  /** Whether the bound store can hold a queue. Without one, a busy thread is not queued. */
+  get supported() {
+    return (0, import_nestjs_agent_core.isChatQueueStore)(this.store);
+  }
+  /** The bound store as a queue store, or a 501 naming what is missing. */
+  queueStore() {
+    if (!(0, import_nestjs_agent_core.isChatQueueStore)(this.store)) {
+      throw new import_common.NotImplementedException("Queueing messages requires an AgentStore that implements ChatQueueStore (enqueueMessage, listQueue, \u2026, claimActiveStream, releaseActiveStream); the bound store does not.");
+    }
+    return this.store;
+  }
+  async state(threadId) {
+    const store = this.queueStore();
+    const [items, paused] = await Promise.all([
+      store.listQueue(threadId),
+      store.queuePause(threadId)
+    ]);
+    return {
+      items: items.map(import_nestjs_agent_core.queuedMessageView),
+      paused
+    };
+  }
+  /**
+  * Whether `holder` is still running. A run this process is about to start is; otherwise the
+  * runner decides, and a runner that cannot tell says yes.
+  */
+  async isAlive(holder, runner) {
+    if (this.starting.has(holder)) {
+      return true;
+    }
+    if (typeof runner.isRunActive !== "function") {
+      return true;
+    }
+    try {
+      return await runner.isRunActive(holder);
+    } catch {
+      return true;
+    }
+  }
+  /**
+  * The run holding `threadId`, or `null` when it is free — a holder the runner reports dead counts
+  * as free, and is returned as `stale` so the caller can claim over it.
+  */
+  async holder(threadId, runner) {
+    const holder = await this.queueStore().activeRunForThread(threadId);
+    if (holder === null) {
+      return {
+        live: null,
+        stale: null
+      };
+    }
+    return await this.isAlive(holder, runner) ? {
+      live: holder,
+      stale: null
+    } : {
+      live: null,
+      stale: holder
+    };
+  }
+  /**
+  * Decide what follows a TOP-LEVEL run that is settling on `threadId`, and move the thread there:
+  * hand it to the next queued message (claimed and popped here, started by the caller), or pause
+  * the queue, or release the thread. Call it BEFORE the run's terminal frame, so a client reading
+  * the stream learns what comes next from the `queue` frame, and so the thread is already free
+  * when the client sees the run end.
+  *
+  * A no-op returning `{}` on a store without a queue.
+  */
+  async plan(args) {
+    if (!(0, import_nestjs_agent_core.isChatQueueStore)(this.store)) {
+      return {};
+    }
+    const store = this.store;
+    const { threadId, outcome } = args;
+    if (await store.activeRunForThread(threadId) !== args.runId) {
+      return {};
+    }
+    let holding = args.runId;
+    for (let attempt = 0; attempt < MAX_DRAIN_ATTEMPTS; attempt += 1) {
+      const items = await store.listQueue(threadId);
+      const head = items[0];
+      if (head === void 0) {
+        if (holding !== null) {
+          await store.releaseActiveStream(threadId, holding);
+          holding = null;
+          continue;
+        }
+        return {};
+      }
+      let pause = await store.queuePause(threadId);
+      if (pause === null) {
+        const reason = pauseReasonFor(outcome, head);
+        if (reason !== null) {
+          pause = {
+            reason,
+            ...outcome === "failed" && args.error !== void 0 ? {
+              message: args.error
+            } : {},
+            at: (/* @__PURE__ */ new Date()).toISOString()
+          };
+          await store.setQueuePause(threadId, pause);
+        }
+      }
+      if (pause === null) {
+        const blocked = await this.quotaBlock(head.actor);
+        if (blocked !== null) {
+          pause = {
+            reason: "quota_exceeded",
+            message: blocked,
+            at: (/* @__PURE__ */ new Date()).toISOString()
+          };
+          await store.setQueuePause(threadId, pause);
+        }
+      }
+      if (pause !== null) {
+        if (holding !== null) {
+          await store.releaseActiveStream(threadId, holding);
+        }
+        return {
+          frame: queueFrame(items, pause)
+        };
+      }
+      const claimed = await store.claimActiveStream(threadId, head.id, holding !== null ? {
+        replacing: holding
+      } : {});
+      if (!claimed) {
+        return {};
+      }
+      holding = head.id;
+      if (!await store.removeQueuedMessage(head.id)) {
+        await store.releaseActiveStream(threadId, head.id);
+        holding = null;
+        continue;
+      }
+      const next = {
+        runId: head.id,
+        messageId: head.id,
+        input: await this.inputFor(head)
+      };
+      return {
+        next,
+        frame: queueFrame(items.slice(1), null, {
+          messageId: head.id,
+          runId: head.id
+        })
+      };
+    }
+    if (holding !== null) {
+      await store.releaseActiveStream(threadId, holding);
+    }
+    return {};
+  }
+  /**
+  * {@link plan}, then start what it picked with `start`. What an in-process settle (the inline
+  * runner, a durable cancel issued outside a workflow) calls; answers the frame to write.
+  */
+  async handoff(args, start) {
+    const plan = await this.plan(args);
+    if (plan.next === void 0) {
+      return plan.frame;
+    }
+    return await this.launch(args.threadId, plan.next, start) ? plan.frame : this.pausedFrame(args.threadId);
+  }
+  /**
+  * Start the head of an IDLE thread's queue — after a send queued behind a run that turned out to
+  * be gone, after a resume, after a stale holder. Does nothing while a live run holds the thread
+  * (its settle drains) or while the queue is paused. Answers the started run's id, if any.
+  */
+  async kick(threadId, runner) {
+    if (!(0, import_nestjs_agent_core.isChatQueueStore)(this.store)) {
+      return void 0;
+    }
+    const { live, stale } = await this.holder(threadId, runner);
+    if (live !== null) {
+      return void 0;
+    }
+    if (stale !== null) {
+      this.logger.warn(`thread ${threadId} was held by run ${stale}, which is no longer running`);
+    }
+    const plan = await this.plan({
+      threadId,
+      runId: stale,
+      outcome: "completed"
+    });
+    if (plan.next === void 0) {
+      return void 0;
+    }
+    const started = await this.launch(threadId, plan.next, (input, runId) => runner.start(input, {
+      runId
+    }));
+    if (started && plan.frame !== void 0) {
+      await this.write(plan.next.runId, plan.frame);
+    }
+    return started ? plan.next.runId : void 0;
+  }
+  /**
+  * Start a turn the thread is already claimed for. On failure the message goes back to the head of
+  * the queue, the queue pauses (`start_failed`), and the claim is released — nothing is lost and
+  * nothing is left holding the thread.
+  */
+  async launch(threadId, next, start) {
+    this.starting.add(next.runId);
+    try {
+      await start(next.input, next.runId);
+      return true;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      this.logger.error(`queued message ${next.messageId} could not start: ${message}`);
+      await this.restore(threadId, next, "start_failed", message);
+      return false;
+    } finally {
+      this.starting.delete(next.runId);
+    }
+  }
+  /** Put a turn that never started back at the head of its queue, paused, and free the thread. */
+  async restore(threadId, next, reason, message) {
+    const store = this.queueStore();
+    const { input } = next;
+    await store.enqueueMessage({
+      threadId,
+      actor: input.actor,
+      content: input.userText,
+      at: "head",
+      ...input.attachments !== void 0 ? {
+        attachments: input.attachments
+      } : {},
+      ...input.agentName !== void 0 ? {
+        agentName: input.agentName
+      } : {},
+      ...input.model !== void 0 ? {
+        model: input.model
+      } : {},
+      ...input.pageContext !== void 0 ? {
+        pageContext: input.pageContext
+      } : {}
+    });
+    await store.setQueuePause(threadId, {
+      reason,
+      message,
+      at: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    await store.releaseActiveStream(threadId, next.runId);
+  }
+  /** A `queue` frame with the thread's current state. */
+  async pausedFrame(threadId) {
+    return {
+      kind: "queue",
+      queue: await this.state(threadId)
+    };
+  }
+  /**
+  * Tell whoever is watching the thread that its queue changed: a `queue` frame into the stream of
+  * the run holding it. Best-effort — a thread nobody is streaming has no one to tell, and the next
+  * read of the thread carries the queue anyway.
+  */
+  async publish(threadId) {
+    const state = await this.state(threadId);
+    const holder = await this.queueStore().activeRunForThread(threadId);
+    if (holder !== null) {
+      await this.write(holder, {
+        kind: "queue",
+        queue: state
+      }).catch((error) => {
+        this.logger.warn(`could not publish the queue of thread ${threadId}: ${error instanceof Error ? error.message : String(error)}`);
+      });
+    }
+    return state;
+  }
+  async write(runId, frame) {
+    const writer = await this.sink.open(runId);
+    await writer.write((0, import_nestjs_agent_core.encodeStreamEvent)(frame));
+  }
+  /** Why `actor` may not start a turn now (the quota message), or `null`. */
+  async quotaBlock(actor) {
+    if (this.options?.quota === void 0 || this.quotaProvider === void 0) {
+      return null;
+    }
+    try {
+      const { blocked } = await this.quotaProvider.report({
+        actor
+      });
+      if (blocked === void 0) {
+        return null;
+      }
+      return blocked.reason ?? `The ${blocked.period === "day" ? "daily" : "monthly"} quota is used up`;
+    } catch {
+      return null;
+    }
+  }
+  /**
+  * The turn a queued message starts: everything it was queued with, today's date, and its
+  * attachments' urls minted afresh — the ones stored at enqueue time may have expired while it
+  * waited. An attachment the staging store no longer resolves keeps its stored url.
+  */
+  async inputFor(message) {
+    const attachments = await this.freshAttachments(message.actor, message.attachments ?? []);
+    return {
+      threadId: message.threadId,
+      actor: message.actor,
+      userText: message.content,
+      day: utcDay(),
+      ...message.agentName !== void 0 ? {
+        agentName: message.agentName
+      } : {},
+      ...attachments.length > 0 ? {
+        attachments
+      } : {},
+      ...message.pageContext !== void 0 ? {
+        pageContext: message.pageContext
+      } : {},
+      ...message.model !== void 0 ? {
+        model: message.model
+      } : {}
+    };
+  }
+  async freshAttachments(actor, attachments) {
+    const staging = this.staging;
+    if (attachments.length === 0 || staging === void 0 || typeof staging.resolve !== "function") {
+      return attachments;
+    }
+    return Promise.all(attachments.map(async (attachment) => {
+      try {
+        return await staging.resolve({
+          mediaId: attachment.mediaId,
+          actor
+        }) ?? attachment;
+      } catch {
+        return attachment;
+      }
+    }));
+  }
+};
+ChatQueueService = _ts_decorate([
+  (0, import_common.Injectable)(),
+  _ts_param(0, (0, import_common.Inject)(import_nestjs_agent_core.AGENT_STORE)),
+  _ts_param(1, (0, import_common.Inject)(import_nestjs_agent_core.AGENT_SINK)),
+  _ts_param(2, (0, import_common.Optional)()),
+  _ts_param(2, (0, import_common.Inject)(import_nestjs_agent_core.AGENT_QUOTA_PROVIDER)),
+  _ts_param(3, (0, import_common.Optional)()),
+  _ts_param(3, (0, import_common.Inject)(import_nestjs_agent_core.AGENT_OPTIONS)),
+  _ts_param(4, (0, import_common.Optional)()),
+  _ts_param(4, (0, import_common.Inject)(import_nestjs_agent_core.AGENT_ATTACHMENT_STAGING)),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", [
+    typeof AgentStore === "undefined" ? Object : AgentStore,
+    typeof TokenStreamSink === "undefined" ? Object : TokenStreamSink,
+    typeof QuotaProvider === "undefined" ? Object : QuotaProvider,
+    typeof Pick === "undefined" ? Object : Pick,
+    typeof AttachmentStagingStore === "undefined" ? Object : AttachmentStagingStore
+  ])
+], ChatQueueService);
+function pauseReasonFor(outcome, head) {
+  if (outcome === "failed") {
+    return "run_failed";
+  }
+  if (outcome === "cancelled" && head.interrupt !== true) {
+    return "cancelled";
+  }
+  return null;
+}
+__name(pauseReasonFor, "pauseReasonFor");
+function queueFrame(items, paused, started) {
+  return {
+    kind: "queue",
+    queue: {
+      items: items.map(import_nestjs_agent_core.queuedMessageView),
+      paused
+    },
+    ...started !== void 0 ? {
+      started
+    } : {}
+  };
+}
+__name(queueFrame, "queueFrame");
+
+// src/durable/agent-run.steps.ts
+var import_nestjs_agent_core2 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_durable = require("@dudousxd/nestjs-durable");
+var import_common2 = require("@nestjs/common");
+function _ts_decorate2(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
+    r = Reflect.decorate(decorators, target, key, desc);
+  } else {
+    for (var i = decorators.length - 1; i >= 0; i--) {
+      if (d = decorators[i]) {
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      }
+    }
+  }
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate2, "_ts_decorate");
+function _ts_metadata2(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
+}
+__name(_ts_metadata2, "_ts_metadata");
+function _ts_param2(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param2, "_ts_param");
 var AgentRunSteps = class {
   static {
     __name(this, "AgentRunSteps");
@@ -97,9 +524,9 @@ var AgentRunSteps = class {
   */
   async llm(input) {
     const deps = this.factory.forAgent(input.agentName);
-    const tools = (0, import_nestjs_agent_core.withMemoryTool)({
-      tools: (0, import_nestjs_agent_core.withSkillTool)({
-        tools: (0, import_nestjs_agent_core.withAskTool)({
+    const tools = (0, import_nestjs_agent_core2.withMemoryTool)({
+      tools: (0, import_nestjs_agent_core2.withSkillTool)({
+        tools: (0, import_nestjs_agent_core2.withAskTool)({
           tools: await deps.registry.definitionsFor(input.actor, deps.rolesPolicy, deps.toolAllowList, {
             ...input.threadId !== void 0 ? {
               threadId: input.threadId
@@ -114,7 +541,7 @@ var AgentRunSteps = class {
       }),
       enabled: deps.memory?.provider.write !== void 0
     });
-    const buffer = input.bufferOutput === true ? (0, import_nestjs_agent_core.createFrameBuffer)() : void 0;
+    const buffer = input.bufferOutput === true ? (0, import_nestjs_agent_core2.createFrameBuffer)() : void 0;
     let writer;
     if (buffer !== void 0) {
       writer = buffer.writer;
@@ -122,8 +549,8 @@ var AgentRunSteps = class {
       const opened = await deps.sink.open(input.sinkRunId);
       writer = input.childSink ? childSinkWriter(opened) : opened;
     }
-    const frames = (0, import_nestjs_agent_core.observeTurnFrames)(writer);
-    const turn = (0, import_nestjs_agent_core.withTurnFrames)(await (0, import_nestjs_agent_core.traceLlmTurn)(input.runId, input.step, () => deps.model.runTurn({
+    const frames = (0, import_nestjs_agent_core2.observeTurnFrames)(writer);
+    const turn = (0, import_nestjs_agent_core2.withTurnFrames)(await (0, import_nestjs_agent_core2.traceLlmTurn)(input.runId, input.step, () => deps.model.runTurn({
       system: input.system,
       messages: input.messages,
       tools,
@@ -132,7 +559,7 @@ var AgentRunSteps = class {
         model: input.model
       } : {}
     })), frames.summary());
-    const stamped = (0, import_nestjs_agent_core.stampToolKinds)(turn, deps);
+    const stamped = (0, import_nestjs_agent_core2.stampToolKinds)(turn, deps);
     return buffer === void 0 ? stamped : {
       ...stamped,
       bufferedFrames: buffer.frames()
@@ -155,9 +582,9 @@ var AgentRunSteps = class {
     }
     const sinkRunId = input.sinkRunId;
     let opened;
-    const ui = (0, import_nestjs_agent_core.createUiCollector)(input.toolCallId, sinkRunId === void 0 ? void 0 : async (event) => {
+    const ui = (0, import_nestjs_agent_core2.createUiCollector)(input.toolCallId, sinkRunId === void 0 ? void 0 : async (event) => {
       opened ??= Promise.resolve(deps.sink.open(sinkRunId)).then((writer) => input.childSink === true ? childSinkWriter(writer) : writer);
-      await (await opened).write((0, import_nestjs_agent_core.encodeStreamEvent)(event));
+      await (await opened).write((0, import_nestjs_agent_core2.encodeStreamEvent)(event));
     });
     const ctx = {
       ...input.ctx,
@@ -171,17 +598,17 @@ var AgentRunSteps = class {
         classify: localClassify
       } : {}
     };
-    const output = await (0, import_nestjs_agent_core.traceToolExecution)(input.ctx.runId, {
+    const output = await (0, import_nestjs_agent_core2.traceToolExecution)(input.ctx.runId, {
       toolCallId: input.toolCallId,
       toolName: input.toolName,
       toolType: input.toolType
-    }, () => (0, import_nestjs_agent_core.invokeWithTransientRetry)(() => {
+    }, () => (0, import_nestjs_agent_core2.invokeWithTransientRetry)(() => {
       ui.restart();
       const invocation = deps.registry.invoke(input.toolName, input.input, ctx, deps.rolesPolicy);
-      return input.timeoutMs !== void 0 ? (0, import_nestjs_agent_core.withToolTimeout)(invocation, input.timeoutMs, input.toolName) : invocation;
+      return input.timeoutMs !== void 0 ? (0, import_nestjs_agent_core2.withToolTimeout)(invocation, input.timeoutMs, input.toolName) : invocation;
     }, transientRetry, {
       onRetry: /* @__PURE__ */ __name((attempt, error) => {
-        (0, import_nestjs_agent_core.publishAgentToolRetry)({
+        (0, import_nestjs_agent_core2.publishAgentToolRetry)({
           toolName: input.toolName,
           toolCallId: input.toolCallId,
           attempt,
@@ -189,38 +616,38 @@ var AgentRunSteps = class {
         });
       }, "onRetry")
     }));
-    return input.collectUi === true ? (0, import_nestjs_agent_core.wrapToolStepOutput)(output, ui.components()) : output;
+    return input.collectUi === true ? (0, import_nestjs_agent_core2.wrapToolStepOutput)(output, ui.components()) : output;
   }
 };
-_ts_decorate([
+_ts_decorate2([
   (0, import_nestjs_durable.Step)({
     retries: 3
   }),
-  _ts_metadata("design:type", Function),
-  _ts_metadata("design:paramtypes", [
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [
     typeof DispatchedLlmInput === "undefined" ? Object : DispatchedLlmInput
   ]),
-  _ts_metadata("design:returntype", Promise)
+  _ts_metadata2("design:returntype", Promise)
 ], AgentRunSteps.prototype, "llm", null);
-_ts_decorate([
+_ts_decorate2([
   (0, import_nestjs_durable.Step)(),
-  _ts_metadata("design:type", Function),
-  _ts_metadata("design:paramtypes", [
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [
     typeof DispatchedToolInput === "undefined" ? Object : DispatchedToolInput
   ]),
-  _ts_metadata("design:returntype", Promise)
+  _ts_metadata2("design:returntype", Promise)
 ], AgentRunSteps.prototype, "tool", null);
-AgentRunSteps = _ts_decorate([
-  (0, import_common.Injectable)(),
-  _ts_param(0, (0, import_common.Inject)(import_nestjs_agent_core.AGENT_DEPS_FACTORY)),
-  _ts_metadata("design:type", Function),
-  _ts_metadata("design:paramtypes", [
+AgentRunSteps = _ts_decorate2([
+  (0, import_common2.Injectable)(),
+  _ts_param2(0, (0, import_common2.Inject)(import_nestjs_agent_core2.AGENT_DEPS_FACTORY)),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory
   ])
 ], AgentRunSteps);
 
 // src/durable/agent-run.workflow.ts
-function _ts_decorate2(decorators, target, key, desc) {
+function _ts_decorate3(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -233,19 +660,19 @@ function _ts_decorate2(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate2, "_ts_decorate");
-function _ts_metadata2(metadataKey, metadataValue) {
+__name(_ts_decorate3, "_ts_decorate");
+function _ts_metadata3(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata2, "_ts_metadata");
-function _ts_param2(paramIndex, decorator) {
+__name(_ts_metadata3, "_ts_metadata");
+function _ts_param3(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param2, "_ts_param");
+__name(_ts_param3, "_ts_param");
 var AgentRunWorkflow = class _AgentRunWorkflow {
   static {
     __name(this, "AgentRunWorkflow");
@@ -253,10 +680,63 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
   factory;
   store;
   runs;
-  constructor(factory, store, runs) {
+  queue;
+  constructor(factory, store, runs, queue) {
     this.factory = factory;
     this.store = store;
     this.runs = runs;
+    this.queue = queue;
+  }
+  /**
+  * Move the thread past this settling turn — to the next queued message, started here as a
+  * fire-and-forget `ctx.startChild` under the message's own id, or to a paused/empty queue — and
+  * answer the `queue` frame to write before the turn's terminal.
+  *
+  * Journaled: the decision (which message, claimed and popped) is one `localStep`, so a replay
+  * reads it back instead of popping a second message, and the start is the runtime's own
+  * replay-safe spawn. Gated by `ctx.patched`, so a run recorded before the queue existed replays
+  * against the history it has. A no-op for a sub-agent's run and on a store without a queue.
+  */
+  async advanceQueue(ctx, input, outcome, error) {
+    const queue = this.queue;
+    if (queue === void 0 || !queue.supported || input.sinkRunId !== void 0 || input.deliverTo !== void 0) {
+      return void 0;
+    }
+    if (!await ctx.patched("agent:chat-queue")) {
+      return void 0;
+    }
+    const plan = await ctx.localStep(`queue:${outcome}`, async () => {
+      try {
+        const settled = outcome === "completed" && await this.isCancelled(ctx.runId) ? "cancelled" : outcome;
+        return await queue.plan({
+          threadId: input.threadId,
+          runId: ctx.runId,
+          outcome: settled,
+          ...error !== void 0 ? {
+            error
+          } : {}
+        });
+      } catch {
+        return {};
+      }
+    });
+    const next = plan.next;
+    if (next === void 0) {
+      return plan.frame;
+    }
+    try {
+      await ctx.startChild(_AgentRunWorkflow, next.input, next.runId);
+      return plan.frame;
+    } catch (failure) {
+      if ((0, import_nestjs_durable_core.isWorkflowControlFlowSignal)(failure)) {
+        throw failure;
+      }
+      const reason = failure instanceof Error ? failure.message : String(failure);
+      return ctx.localStep("queue:restore", async () => {
+        await queue.restore(input.threadId, next, "start_failed", reason);
+        return queue.pausedFrame(input.threadId);
+      });
+    }
   }
   /**
   * Has someone asked this run to stop? Read from the runtime's own run status, which is where
@@ -294,7 +774,7 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
     if (delivery === void 0) {
       return;
     }
-    await ctx.localStep("deliver:detached:unsettled", () => (0, import_nestjs_agent_core2.settleUnsettledDelegation)({
+    await ctx.localStep("deliver:detached:unsettled", () => (0, import_nestjs_agent_core3.settleUnsettledDelegation)({
       store: this.store,
       delivery,
       agent: input.agentName ?? "default",
@@ -322,7 +802,25 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
     const hooks = {
       runId: ctx.runId,
       // A child forwards into the top-level sink but must not end/fail it (the top-level run owns it).
-      openSink: /* @__PURE__ */ __name(async () => input.sinkRunId !== void 0 ? childSinkWriter(await deps.sink.open(sinkRunId)) : deps.sink.open(ctx.runId), "openSink"),
+      // A thread's own turn hands the thread to its queue just before the loop ends the stream, so
+      // the reader learns what runs next from the `queue` frame, before the end.
+      openSink: /* @__PURE__ */ __name(async () => {
+        if (input.sinkRunId !== void 0) {
+          return childSinkWriter(await deps.sink.open(sinkRunId));
+        }
+        const writer = await deps.sink.open(ctx.runId);
+        return {
+          write: /* @__PURE__ */ __name((chunk) => writer.write(chunk), "write"),
+          fail: /* @__PURE__ */ __name((failure) => writer.fail(failure), "fail"),
+          end: /* @__PURE__ */ __name(async () => {
+            const frame = await this.advanceQueue(ctx, input, "completed");
+            if (frame !== void 0) {
+              await writer.write((0, import_nestjs_agent_core3.encodeStreamEvent)(frame));
+            }
+            await writer.end();
+          }, "end")
+        };
+      }, "openSink"),
       // A policy's time to live becomes the signal wait's own timeout: the runtime journals the
       // deadline on the first call (a position of its own, reached only for a call the journal says
       // has a ttl) and wakes the run when it passes. The lapse comes back as a Decision rather than a
@@ -347,7 +845,7 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
       // await, so launching a batch in one tick — what `settleAll` does — fixes the block of
       // positions in call order however the tools then settle. `ctx.patched` keeps a run that
       // recorded the one-call-at-a-time shape replaying against that shape.
-      parallel: import_nestjs_agent_core2.settleAll,
+      parallel: import_nestjs_agent_core3.settleAll,
       cancelled: /* @__PURE__ */ __name(() => this.isCancelled(ctx.runId), "cancelled"),
       patched: /* @__PURE__ */ __name((id) => ctx.patched(id), "patched"),
       // Dispatched-step suspends must escape the loop's tool catch — control flow, not a tool
@@ -441,29 +939,29 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
       } : {}
     };
     try {
-      const result = await (0, import_nestjs_agent_core2.runAgentLoop)({
+      const result = await (0, import_nestjs_agent_core3.runAgentLoop)({
         ...deps,
         day
       }, input, hooks);
-      await ctx.localStep("deactivate", () => this.store.setActiveStream(input.threadId, null));
+      await ctx.localStep("deactivate", () => (0, import_nestjs_agent_core3.releaseThreadRun)(this.store, input.threadId, ctx.runId));
       return result;
     } catch (error) {
       if ((0, import_nestjs_durable_core.isWorkflowControlFlowSignal)(error)) {
         throw error;
       }
-      if (error instanceof import_nestjs_agent_core2.RunCancelledError) {
-        await ctx.localStep("deactivate", () => this.store.setActiveStream(input.threadId, null));
+      if (error instanceof import_nestjs_agent_core3.RunCancelledError) {
+        await ctx.localStep("deactivate", () => (0, import_nestjs_agent_core3.releaseThreadRun)(this.store, input.threadId, ctx.runId));
         await this.settleDetachedParent(ctx, input, {
           status: "cancelled"
         });
         throw error;
       }
-      if ((0, import_nestjs_agent_core2.isReplayIntegrityError)(error)) {
+      if ((0, import_nestjs_agent_core3.isReplayIntegrityError)(error)) {
         const failure = {
           code: "run_failed",
           message: error.message
         };
-        (0, import_nestjs_agent_core2.publishAgentRunFailed)({
+        (0, import_nestjs_agent_core3.publishAgentRunFailed)({
           runId: ctx.runId,
           ...failure
         });
@@ -471,8 +969,8 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
         throw error;
       }
       const message = error instanceof Error ? error.message : String(error);
-      const code = (0, import_nestjs_agent_core2.agentFailureCode)(error);
-      (0, import_nestjs_agent_core2.publishAgentRunFailed)({
+      const code = (0, import_nestjs_agent_core3.agentFailureCode)(error);
+      (0, import_nestjs_agent_core3.publishAgentRunFailed)({
         runId: ctx.runId,
         code,
         message
@@ -483,12 +981,16 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
         errorCode: code,
         errorMessage: message
       }) ?? Promise.resolve());
-      await ctx.localStep("deactivate", () => this.store.setActiveStream(input.threadId, null));
+      const queueFrame2 = await this.advanceQueue(ctx, input, "failed", message);
+      await ctx.localStep("deactivate", () => (0, import_nestjs_agent_core3.releaseThreadRun)(this.store, input.threadId, ctx.runId));
       await this.settleDetachedParent(ctx, input, {
         status: "failed",
         error: message
       });
       const writer = await hooks.openSink();
+      if (queueFrame2 !== void 0) {
+        await writer.write((0, import_nestjs_agent_core3.encodeStreamEvent)(queueFrame2));
+      }
       await writer.fail({
         code,
         message
@@ -497,21 +999,23 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
     }
   }
 };
-AgentRunWorkflow = _ts_decorate2([
-  (0, import_common2.Injectable)(),
+AgentRunWorkflow = _ts_decorate3([
+  (0, import_common3.Injectable)(),
   (0, import_nestjs_durable2.Workflow)({
     name: "agent.run",
     version: "1"
   }),
-  _ts_param2(0, (0, import_common2.Inject)(import_nestjs_agent_core2.AGENT_DEPS_FACTORY)),
-  _ts_param2(1, (0, import_common2.Inject)(import_nestjs_agent_core2.AGENT_STORE)),
-  _ts_param2(2, (0, import_common2.Optional)()),
-  _ts_param2(2, (0, import_common2.Inject)(import_nestjs_durable2.RUN_GATEWAY)),
-  _ts_metadata2("design:type", Function),
-  _ts_metadata2("design:paramtypes", [
+  _ts_param3(0, (0, import_common3.Inject)(import_nestjs_agent_core3.AGENT_DEPS_FACTORY)),
+  _ts_param3(1, (0, import_common3.Inject)(import_nestjs_agent_core3.AGENT_STORE)),
+  _ts_param3(2, (0, import_common3.Optional)()),
+  _ts_param3(2, (0, import_common3.Inject)(import_nestjs_durable2.RUN_GATEWAY)),
+  _ts_param3(3, (0, import_common3.Optional)()),
+  _ts_metadata3("design:type", Function),
+  _ts_metadata3("design:paramtypes", [
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
     typeof AgentStore === "undefined" ? Object : AgentStore,
-    typeof RunGateway === "undefined" ? Object : RunGateway
+    typeof RunGateway === "undefined" ? Object : RunGateway,
+    typeof ChatQueueService === "undefined" ? Object : ChatQueueService
   ])
 ], AgentRunWorkflow);
 function isSignalTimeout(error) {
@@ -521,13 +1025,13 @@ __name(isSignalTimeout, "isSignalTimeout");
 
 // src/durable/durable-agent-runner.ts
 var import_node_crypto = require("crypto");
-var import_nestjs_agent_core4 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core5 = require("@dudousxd/nestjs-agent-core");
 var import_nestjs_durable3 = require("@dudousxd/nestjs-durable");
 var import_nestjs_durable_core2 = require("@dudousxd/nestjs-durable-core");
-var import_common3 = require("@nestjs/common");
+var import_common4 = require("@nestjs/common");
 
 // src/in-process-sink.ts
-var import_nestjs_agent_core3 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core4 = require("@dudousxd/nestjs-agent-core");
 var InProcessTokenStreamSink = class {
   static {
     __name(this, "InProcessTokenStreamSink");
@@ -582,7 +1086,7 @@ var InProcessTokenStreamSink = class {
       }
       if (buf.ended) {
         if (buf.failure !== void 0) {
-          throw new import_nestjs_agent_core3.AgentStreamError(buf.failure);
+          throw new import_nestjs_agent_core4.AgentStreamError(buf.failure);
         }
         return;
       }
@@ -595,7 +1099,7 @@ var InProcessTokenStreamSink = class {
 };
 
 // src/durable/durable-agent-runner.ts
-function _ts_decorate3(decorators, target, key, desc) {
+function _ts_decorate4(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -608,19 +1112,19 @@ function _ts_decorate3(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate3, "_ts_decorate");
-function _ts_metadata3(metadataKey, metadataValue) {
+__name(_ts_decorate4, "_ts_decorate");
+function _ts_metadata4(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata3, "_ts_metadata");
-function _ts_param3(paramIndex, decorator) {
+__name(_ts_metadata4, "_ts_metadata");
+function _ts_param4(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param3, "_ts_param");
+__name(_ts_param4, "_ts_param");
 function threadOfRun(input) {
   if (typeof input !== "object" || input === null || !("threadId" in input)) {
     return void 0;
@@ -628,6 +1132,10 @@ function threadOfRun(input) {
   return typeof input.threadId === "string" ? input.threadId : void 0;
 }
 __name(threadOfRun, "threadOfRun");
+function isThreadTurn(input) {
+  return typeof input === "object" && input !== null && input.sinkRunId === void 0 && input.deliverTo === void 0;
+}
+__name(isThreadTurn, "isThreadTurn");
 var DurableAgentRunner = class _DurableAgentRunner {
   static {
     __name(this, "DurableAgentRunner");
@@ -636,22 +1144,24 @@ var DurableAgentRunner = class _DurableAgentRunner {
   runs;
   store;
   sink;
-  logger = new import_common3.Logger(_DurableAgentRunner.name);
-  constructor(workflows, runs, store, sink) {
+  queue;
+  logger = new import_common4.Logger(_DurableAgentRunner.name);
+  constructor(workflows, runs, store, sink, queue) {
     this.workflows = workflows;
     this.runs = runs;
     this.store = store;
     this.sink = sink;
+    this.queue = queue;
     if (this.sink instanceof InProcessTokenStreamSink) {
       this.logger.warn("durable: true with the default InProcessTokenStreamSink, which only buffers tokens in this process. The worker that runs the turn \u2014 and the one that serves its dispatched `llm` step \u2014 cannot stream into this buffer. Wire a cross-process TokenStreamSink (e.g. a Redis pub/sub sink) via AgentModule.forRoot({ sink }) before running multi-pod.");
     }
   }
-  async start(input) {
+  async start(input, options = {}) {
     const stamped = {
       ...input,
       day: input.day ?? utcDay()
     };
-    const runId = (0, import_node_crypto.randomUUID)();
+    const runId = options.runId ?? (0, import_node_crypto.randomUUID)();
     try {
       await this.workflows.start(AgentRunWorkflow, stamped, runId);
     } catch (error) {
@@ -663,6 +1173,19 @@ var DurableAgentRunner = class _DurableAgentRunner {
       runId
     };
   }
+  /**
+  * From the runtime's own run row. A run it does not know yet counts as running — a queued turn is
+  * claimed before its `startChild` lands — and so does one it cannot be asked about: only a run the
+  * runtime reports settled (`completed`/`failed`/`cancelled`/`dead`) is stale.
+  */
+  async isRunActive(runId) {
+    try {
+      const status = (await this.runs.getRunDetail(runId))?.run.status;
+      return !(status === "completed" || status === "failed" || status === "cancelled" || status === "dead");
+    } catch {
+      return true;
+    }
+  }
   async signal(runId, toolCallId2, reply) {
     await this.workflows.signal(`tool:${runId}:${toolCallId2}`, reply);
   }
@@ -692,15 +1215,32 @@ var DurableAgentRunner = class _DurableAgentRunner {
   */
   async cancel(runId) {
     this.logger.log(`cancelling agent run ${runId}`);
-    const threadId = await this.threadOf(runId);
+    const input = await this.inputOf(runId);
+    const threadId = threadOfRun(input);
     await this.runs.cancel(runId, {
       compensate: true
     });
+    const writer = await this.sink.open(runId);
     if (threadId !== void 0) {
-      await this.store.setActiveStream(threadId, null);
+      if (this.queue?.supported === true && isThreadTurn(input)) {
+        try {
+          const frame = await this.queue.handoff({
+            threadId,
+            runId,
+            outcome: "cancelled"
+          }, (next, nextRunId) => this.start(next, {
+            runId: nextRunId
+          }));
+          if (frame !== void 0) {
+            await writer.write((0, import_nestjs_agent_core5.encodeStreamEvent)(frame));
+          }
+        } catch (error) {
+          this.logger.error(`could not advance the queue of thread ${threadId} after cancelling ${runId}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+      }
+      await (0, import_nestjs_agent_core5.releaseThreadRun)(this.store, threadId, runId);
     }
-    const writer = await this.sink.open(runId);
-    await writer.write((0, import_nestjs_agent_core4.encodeStreamEvent)({
+    await writer.write((0, import_nestjs_agent_core5.encodeStreamEvent)({
       kind: "cancelled"
     }));
     await writer.end();
@@ -710,7 +1250,7 @@ var DurableAgentRunner = class _DurableAgentRunner {
     });
   }
   /**
-  * Which thread a run was streaming, or `undefined` where the gateway cannot say.
+  * The input a run was started with (which thread it was streaming), or `undefined` where the gateway cannot say.
   *
   * A read failure answers `undefined` instead of propagating, the same posture `AgentRunWorkflow`
   * takes for its own cancel observation: failing to ask is not an answer worth failing a cancel
@@ -719,32 +1259,34 @@ var DurableAgentRunner = class _DurableAgentRunner {
   * with a subscriber holding a stream that never settles, from the one call whose entire job is to
   * make a run stop.
   */
-  async threadOf(runId) {
+  async inputOf(runId) {
     try {
-      return threadOfRun((await this.runs.getRunDetail(runId))?.run.input);
+      return (await this.runs.getRunDetail(runId))?.run.input;
     } catch {
       return void 0;
     }
   }
 };
-DurableAgentRunner = _ts_decorate3([
-  (0, import_common3.Injectable)(),
-  _ts_param3(1, (0, import_common3.Inject)(import_nestjs_durable3.RUN_GATEWAY)),
-  _ts_param3(2, (0, import_common3.Inject)(import_nestjs_agent_core4.AGENT_STORE)),
-  _ts_param3(3, (0, import_common3.Inject)(import_nestjs_agent_core4.AGENT_SINK)),
-  _ts_metadata3("design:type", Function),
-  _ts_metadata3("design:paramtypes", [
+DurableAgentRunner = _ts_decorate4([
+  (0, import_common4.Injectable)(),
+  _ts_param4(1, (0, import_common4.Inject)(import_nestjs_durable3.RUN_GATEWAY)),
+  _ts_param4(2, (0, import_common4.Inject)(import_nestjs_agent_core5.AGENT_STORE)),
+  _ts_param4(3, (0, import_common4.Inject)(import_nestjs_agent_core5.AGENT_SINK)),
+  _ts_param4(4, (0, import_common4.Optional)()),
+  _ts_metadata4("design:type", Function),
+  _ts_metadata4("design:paramtypes", [
     typeof import_nestjs_durable3.WorkflowService === "undefined" ? Object : import_nestjs_durable3.WorkflowService,
     typeof RunGateway === "undefined" ? Object : RunGateway,
     typeof AgentStore === "undefined" ? Object : AgentStore,
-    typeof TokenStreamSink === "undefined" ? Object : TokenStreamSink
+    typeof TokenStreamSink === "undefined" ? Object : TokenStreamSink,
+    typeof ChatQueueService === "undefined" ? Object : ChatQueueService
   ])
 ], DurableAgentRunner);
 
 // src/durable/agent-durable.module.ts
-var import_nestjs_agent_core5 = require("@dudousxd/nestjs-agent-core");
-var import_common4 = require("@nestjs/common");
-function _ts_decorate4(decorators, target, key, desc) {
+var import_nestjs_agent_core6 = require("@dudousxd/nestjs-agent-core");
+var import_common5 = require("@nestjs/common");
+function _ts_decorate5(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -757,12 +1299,12 @@ function _ts_decorate4(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate4, "_ts_decorate");
+__name(_ts_decorate5, "_ts_decorate");
 function runnerProviders() {
   return [
     DurableAgentRunner,
     {
-      provide: import_nestjs_agent_core5.AGENT_DURABLE_RUNNER,
+      provide: import_nestjs_agent_core6.AGENT_DURABLE_RUNNER,
       useExisting: DurableAgentRunner
     }
   ];
@@ -773,15 +1315,15 @@ var AgentDurableHttpModule = class AgentDurableHttpModule2 {
     __name(this, "AgentDurableHttpModule");
   }
 };
-AgentDurableHttpModule = _ts_decorate4([
-  (0, import_common4.Global)(),
-  (0, import_common4.Module)({
+AgentDurableHttpModule = _ts_decorate5([
+  (0, import_common5.Global)(),
+  (0, import_common5.Module)({
     providers: [
       AgentRunWorkflow,
       ...runnerProviders()
     ],
     exports: [
-      import_nestjs_agent_core5.AGENT_DURABLE_RUNNER,
+      import_nestjs_agent_core6.AGENT_DURABLE_RUNNER,
       AgentRunWorkflow
     ]
   })
@@ -811,16 +1353,16 @@ var AgentDurableModule = class _AgentDurableModule {
     };
   }
 };
-AgentDurableModule = _ts_decorate4([
-  (0, import_common4.Global)(),
-  (0, import_common4.Module)({
+AgentDurableModule = _ts_decorate5([
+  (0, import_common5.Global)(),
+  (0, import_common5.Module)({
     providers: [
       AgentRunWorkflow,
       AgentRunSteps,
       ...runnerProviders()
     ],
     exports: [
-      import_nestjs_agent_core5.AGENT_DURABLE_RUNNER,
+      import_nestjs_agent_core6.AGENT_DURABLE_RUNNER,
       AgentRunWorkflow,
       AgentRunSteps
     ]
@@ -828,15 +1370,15 @@ AgentDurableModule = _ts_decorate4([
 ], AgentDurableModule);
 
 // src/agent.module.ts
-var import_nestjs_agent_core28 = require("@dudousxd/nestjs-agent-core");
-var import_common24 = require("@nestjs/common");
+var import_nestjs_agent_core30 = require("@dudousxd/nestjs-agent-core");
+var import_common26 = require("@nestjs/common");
 var import_core4 = require("@nestjs/core");
 
 // src/agent-deps.factory.ts
-var import_nestjs_agent_core6 = require("@dudousxd/nestjs-agent-core");
 var import_nestjs_agent_core7 = require("@dudousxd/nestjs-agent-core");
-var import_common5 = require("@nestjs/common");
-function _ts_decorate5(decorators, target, key, desc) {
+var import_nestjs_agent_core8 = require("@dudousxd/nestjs-agent-core");
+var import_common6 = require("@nestjs/common");
+function _ts_decorate6(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -849,19 +1391,19 @@ function _ts_decorate5(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate5, "_ts_decorate");
-function _ts_metadata4(metadataKey, metadataValue) {
+__name(_ts_decorate6, "_ts_decorate");
+function _ts_metadata5(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata4, "_ts_metadata");
-function _ts_param4(paramIndex, decorator) {
+__name(_ts_metadata5, "_ts_metadata");
+function _ts_param5(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param4, "_ts_param");
+__name(_ts_param5, "_ts_param");
 function delegateToolName(args) {
   const slug = args.target.replace(/[^a-zA-Z0-9]+/g, "_");
   return args.detached === true ? `start_${slug}` : `ask_${slug}`;
@@ -919,7 +1461,7 @@ var AgentDepsFactory2 = class {
       return void 0;
     }
     const delegated = (definition.delegatesTo ?? []).map((edge) => {
-      const { agent, detached } = (0, import_nestjs_agent_core6.normalizeDelegation)(edge);
+      const { agent, detached } = (0, import_nestjs_agent_core7.normalizeDelegation)(edge);
       return delegateToolName({
         target: agent,
         detached
@@ -1032,7 +1574,7 @@ var AgentDepsFactory2 = class {
   }
   /** Build the built-in window policy from the declarative `{ maxMessages, maxTokens, summarize }`. */
   window(config) {
-    return (0, import_nestjs_agent_core6.windowHistory)({
+    return (0, import_nestjs_agent_core7.windowHistory)({
       ...config.maxMessages !== void 0 ? {
         maxMessages: config.maxMessages
       } : {},
@@ -1042,7 +1584,7 @@ var AgentDepsFactory2 = class {
       // The shared module model, not a per-agent one: an agent's `modelId` is an accounting label,
       // and only one provider is ever bound.
       ...config.summarize === true ? {
-        summarize: (0, import_nestjs_agent_core6.summarizeWithModel)(this.model)
+        summarize: (0, import_nestjs_agent_core7.summarizeWithModel)(this.model)
       } : {}
     });
   }
@@ -1058,31 +1600,31 @@ var AgentDepsFactory2 = class {
     return void 0;
   }
 };
-AgentDepsFactory2 = _ts_decorate5([
-  (0, import_common5.Injectable)(),
-  _ts_param4(0, (0, import_common5.Inject)(import_nestjs_agent_core7.AGENT_OPTIONS)),
-  _ts_param4(1, (0, import_common5.Inject)(import_nestjs_agent_core6.AGENT_MODEL)),
-  _ts_param4(2, (0, import_common5.Inject)(import_nestjs_agent_core6.AGENT_STORE)),
-  _ts_param4(3, (0, import_common5.Inject)(import_nestjs_agent_core6.AGENT_SINK)),
-  _ts_param4(4, (0, import_common5.Inject)(import_nestjs_agent_core6.AGENT_ROLES_POLICY)),
-  _ts_param4(5, (0, import_common5.Inject)(import_nestjs_agent_core6.AGENT_TOOL_REGISTRY)),
-  _ts_param4(6, (0, import_common5.Inject)(import_nestjs_agent_core6.AGENT_REGISTRY)),
-  _ts_param4(7, (0, import_common5.Inject)(import_nestjs_agent_core6.AGENT_PROMPT_CONTRIBUTORS)),
-  _ts_param4(8, (0, import_common5.Optional)()),
-  _ts_param4(8, (0, import_common5.Inject)(import_nestjs_agent_core6.AGENT_PRICING_STORE)),
-  _ts_param4(9, (0, import_common5.Optional)()),
-  _ts_param4(9, (0, import_common5.Inject)(import_nestjs_agent_core6.AGENT_SKILLS)),
-  _ts_param4(10, (0, import_common5.Optional)()),
-  _ts_param4(10, (0, import_common5.Inject)(import_nestjs_agent_core6.AGENT_MEMORY)),
-  _ts_metadata4("design:type", Function),
-  _ts_metadata4("design:paramtypes", [
+AgentDepsFactory2 = _ts_decorate6([
+  (0, import_common6.Injectable)(),
+  _ts_param5(0, (0, import_common6.Inject)(import_nestjs_agent_core8.AGENT_OPTIONS)),
+  _ts_param5(1, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_MODEL)),
+  _ts_param5(2, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_STORE)),
+  _ts_param5(3, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_SINK)),
+  _ts_param5(4, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_ROLES_POLICY)),
+  _ts_param5(5, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_TOOL_REGISTRY)),
+  _ts_param5(6, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_REGISTRY)),
+  _ts_param5(7, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_PROMPT_CONTRIBUTORS)),
+  _ts_param5(8, (0, import_common6.Optional)()),
+  _ts_param5(8, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_PRICING_STORE)),
+  _ts_param5(9, (0, import_common6.Optional)()),
+  _ts_param5(9, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_SKILLS)),
+  _ts_param5(10, (0, import_common6.Optional)()),
+  _ts_param5(10, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_MEMORY)),
+  _ts_metadata5("design:type", Function),
+  _ts_metadata5("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
     typeof ModelProvider === "undefined" ? Object : ModelProvider,
     typeof AgentStore === "undefined" ? Object : AgentStore,
     typeof TokenStreamSink === "undefined" ? Object : TokenStreamSink,
     typeof RolesPolicy === "undefined" ? Object : RolesPolicy,
-    typeof import_nestjs_agent_core6.ToolRegistry === "undefined" ? Object : import_nestjs_agent_core6.ToolRegistry,
-    typeof import_nestjs_agent_core6.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core6.AgentRegistry,
+    typeof import_nestjs_agent_core7.ToolRegistry === "undefined" ? Object : import_nestjs_agent_core7.ToolRegistry,
+    typeof import_nestjs_agent_core7.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core7.AgentRegistry,
     Array,
     Object,
     Object,
@@ -1091,9 +1633,9 @@ AgentDepsFactory2 = _ts_decorate5([
 ], AgentDepsFactory2);
 
 // src/agent.service.ts
-var import_nestjs_agent_core8 = require("@dudousxd/nestjs-agent-core");
-var import_common6 = require("@nestjs/common");
-function _ts_decorate6(decorators, target, key, desc) {
+var import_nestjs_agent_core9 = require("@dudousxd/nestjs-agent-core");
+var import_common7 = require("@nestjs/common");
+function _ts_decorate7(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -1106,19 +1648,19 @@ function _ts_decorate6(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate6, "_ts_decorate");
-function _ts_metadata5(metadataKey, metadataValue) {
+__name(_ts_decorate7, "_ts_decorate");
+function _ts_metadata6(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata5, "_ts_metadata");
-function _ts_param5(paramIndex, decorator) {
+__name(_ts_metadata6, "_ts_metadata");
+function _ts_param6(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param5, "_ts_param");
+__name(_ts_param6, "_ts_param");
 var AgentService = class {
   static {
     __name(this, "AgentService");
@@ -1130,7 +1672,8 @@ var AgentService = class {
   models;
   quotaProvider;
   options;
-  constructor(runner, store, deps, staging, models, quotaProvider, options) {
+  queue;
+  constructor(runner, store, deps, staging, models, quotaProvider, options, queue) {
     this.runner = runner;
     this.store = store;
     this.deps = deps;
@@ -1138,6 +1681,19 @@ var AgentService = class {
     this.models = models;
     this.quotaProvider = quotaProvider;
     this.options = options;
+    this.queue = queue;
+  }
+  /** The queue service when the bound store can hold a queue, else `undefined`. */
+  queueing() {
+    return this.queue?.supported === true ? this.queue : void 0;
+  }
+  /** The queue service, or a 501 naming what is missing. */
+  requireQueue() {
+    const queue = this.queueing();
+    if (queue === void 0) {
+      throw new import_common7.NotImplementedException("Queueing messages requires an AgentStore that implements ChatQueueStore; the bound store does not.");
+    }
+    return queue;
   }
   /**
   * The actor's budget across windows (`GET <base>/quota`) — the bound {@link QuotaProvider}'s
@@ -1172,12 +1728,12 @@ var AgentService = class {
       actor
     });
     if (blocked !== void 0) {
-      throw new import_common6.HttpException({
-        statusCode: import_common6.HttpStatus.TOO_MANY_REQUESTS,
+      throw new import_common7.HttpException({
+        statusCode: import_common7.HttpStatus.TOO_MANY_REQUESTS,
         code: "quota_exceeded",
         period: blocked.period,
         message: blocked.reason ?? `The ${blocked.period === "day" ? "daily" : "monthly"} quota is used up`
-      }, import_common6.HttpStatus.TOO_MANY_REQUESTS);
+      }, import_common7.HttpStatus.TOO_MANY_REQUESTS);
     }
   }
   /**
@@ -1205,17 +1761,17 @@ var AgentService = class {
   */
   async assertModelAllowed(actor, agent, model) {
     if (this.models === void 0) {
-      throw new import_common6.BadRequestException(`model "${model}" cannot be selected: no ModelCatalog is configured (AgentModule.forRoot({ models }))`);
+      throw new import_common7.BadRequestException(`model "${model}" cannot be selected: no ModelCatalog is configured (AgentModule.forRoot({ models }))`);
     }
-    const entry = (0, import_nestjs_agent_core8.findCatalogModel)(await this.models.list({
+    const entry = (0, import_nestjs_agent_core9.findCatalogModel)(await this.models.list({
       actor,
       agent
     }), model);
     if (entry === void 0) {
-      throw new import_common6.BadRequestException(`model "${model}" is not offered`);
+      throw new import_common7.BadRequestException(`model "${model}" is not offered`);
     }
     if (!entry.available) {
-      throw new import_common6.BadRequestException(`model "${model}" is not available${entry.unavailableReason ? `: ${entry.unavailableReason}` : ""}`);
+      throw new import_common7.BadRequestException(`model "${model}" is not available${entry.unavailableReason ? `: ${entry.unavailableReason}` : ""}`);
     }
     return entry.id;
   }
@@ -1231,7 +1787,7 @@ var AgentService = class {
     })).locked : void 0;
     if (locked !== void 0) {
       if (requested !== void 0 && requested !== locked.model) {
-        throw new import_common6.BadRequestException(`model "${requested}" cannot be selected: ${locked.reason ?? `this agent always uses "${locked.model}"`}`);
+        throw new import_common7.BadRequestException(`model "${requested}" cannot be selected: ${locked.reason ?? `this agent always uses "${locked.model}"`}`);
       }
       return locked.model;
     }
@@ -1248,7 +1804,44 @@ var AgentService = class {
     }
     return (await this.store.getThread(threadId))?.model ?? null;
   }
+  /**
+  * Start a turn — for in-process callers that need a run id back. A send that would have to wait
+  * (its thread already has a turn running) is refused with `409` instead; {@link send} is the form
+  * that queues it.
+  */
   async chat(params) {
+    const result = await this.send({
+      ...params,
+      mode: "auto"
+    });
+    if (result.queued !== true) {
+      return result;
+    }
+    if (result.runId !== void 0) {
+      return {
+        runId: result.runId,
+        threadId: result.threadId
+      };
+    }
+    const store = this.requireQueue().queueStore();
+    if (!await store.removeQueuedMessage(result.messageId)) {
+      return {
+        runId: result.messageId,
+        threadId: result.threadId
+      };
+    }
+    await this.requireQueue().publish(result.threadId);
+    throw new import_common7.ConflictException({
+      statusCode: 409,
+      code: "run_active",
+      message: `thread ${result.threadId} already has a turn running`
+    });
+  }
+  /**
+  * Send a message: start a turn, or — when its thread already has one running — queue the message
+  * to run after it (see {@link ChatSendMode}). What `POST <base>/chat` calls.
+  */
+  async send(params) {
     await this.assertWithinQuota(params.actor);
     const agentName = await this.resolveAgentName(params.agentName, params.threadId);
     const model = await this.resolveModel(params.actor, agentName, params.model, params.threadId);
@@ -1256,7 +1849,7 @@ var AgentService = class {
     let threadId = params.threadId;
     if (threadId === void 0) {
       if (params.regenerate === true) {
-        throw new import_common6.BadRequestException("regenerate requires an existing threadId");
+        throw new import_common7.BadRequestException("regenerate requires an existing threadId");
       }
       const created = await this.store.createThread({
         actor: params.actor,
@@ -1265,7 +1858,7 @@ var AgentService = class {
         } : {}
       });
       threadId = created.id;
-    } else if (params.regenerate === true) {
+    } else {
       await this.assertOwnsThread(params.actor, threadId);
     }
     const input = {
@@ -1287,13 +1880,195 @@ var AgentService = class {
         model
       } : {}
     };
-    const { runId } = await this.runner.start(input);
-    await this.store.setActiveStream(threadId, runId);
+    const queue = this.queueing();
+    if (queue === void 0) {
+      const { runId } = await this.runner.start(input);
+      await this.store.setActiveStream(threadId, runId);
+      return {
+        runId,
+        threadId
+      };
+    }
+    const mode = params.mode ?? "auto";
+    const { live, stale } = await queue.holder(threadId, this.runner);
+    if (live === null && mode !== "queue") {
+      const runId = crypto.randomUUID();
+      if (await queue.queueStore().claimActiveStream(threadId, runId, stale !== null ? {
+        replacing: stale
+      } : {})) {
+        return {
+          runId: await this.startClaimed(input, runId),
+          threadId
+        };
+      }
+    }
+    if (params.regenerate === true) {
+      throw new import_common7.ConflictException({
+        statusCode: 409,
+        code: "run_active",
+        message: "cannot regenerate while a turn is running on this thread"
+      });
+    }
+    return this.enqueue(queue, input, mode, live);
+  }
+  /**
+  * Start a turn the thread is already claimed for, under the claimed id. A runner that minted an
+  * id of its own anyway gets the thread re-pointed at it; one that fails to start frees the thread.
+  */
+  async startClaimed(input, runId) {
+    const store = this.requireQueue().queueStore();
+    let started;
+    try {
+      started = (await this.runner.start(input, {
+        runId
+      })).runId;
+    } catch (error) {
+      await store.releaseActiveStream(input.threadId, runId);
+      throw error;
+    }
+    if (started !== runId) {
+      await store.claimActiveStream(input.threadId, started, {
+        replacing: runId
+      });
+    }
+    return started;
+  }
+  /** Put a send in its thread's queue, then drain it if the thread turned out to be free. */
+  async enqueue(queue, input, mode, live) {
+    const store = queue.queueStore();
+    const threadId = input.threadId;
+    const interrupting = mode === "interrupt" && live !== null ? live : void 0;
+    const queued = await store.enqueueMessage({
+      threadId,
+      actor: input.actor,
+      content: input.userText,
+      ...input.attachments !== void 0 ? {
+        attachments: input.attachments
+      } : {},
+      ...input.agentName !== void 0 ? {
+        agentName: input.agentName
+      } : {},
+      ...input.model !== void 0 ? {
+        model: input.model
+      } : {},
+      ...input.pageContext !== void 0 ? {
+        pageContext: input.pageContext
+      } : {},
+      ...interrupting !== void 0 ? {
+        interrupt: true,
+        at: "head"
+      } : {}
+    });
+    let runId;
+    if (interrupting !== void 0) {
+      await store.setQueuePause(threadId, null);
+      await queue.publish(threadId);
+      await this.runner.cancel(interrupting);
+    } else {
+      runId = await queue.kick(threadId, this.runner);
+      if (runId === void 0) {
+        await queue.publish(threadId);
+      }
+    }
+    const state = await queue.state(threadId);
+    const position = state.items.findIndex((item) => item.id === queued.id);
+    return {
+      threadId,
+      queued: true,
+      messageId: queued.id,
+      position: position === -1 ? 0 : position,
+      queue: state,
+      ...runId !== void 0 && runId === queued.id ? {
+        runId
+      } : {},
+      ...interrupting !== void 0 ? {
+        interrupting
+      } : {}
+    };
+  }
+  /** `GET <base>/threads/:id/queue` — the thread's waiting messages and whether it drains. */
+  async getQueue(actor, threadId) {
+    await this.assertOwnsThread(actor, threadId);
+    return this.requireQueue().state(threadId);
+  }
+  /**
+  * `PATCH <base>/queue/:messageId` — change a waiting message's text and/or attachments, and/or move
+  * it to `position` in the queue. Answers the thread's queue.
+  */
+  async updateQueuedMessage(actor, messageId, patch) {
+    const queue = this.requireQueue();
+    const store = queue.queueStore();
+    const threadId = await this.assertOwnsQueuedMessage(actor, messageId);
+    if (patch.message !== void 0 && patch.message.trim().length === 0) {
+      throw new import_common7.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) {
+      const updated = await store.updateQueuedMessage(messageId, {
+        ...patch.message !== void 0 ? {
+          content: patch.message
+        } : {},
+        ...attachments !== void 0 ? {
+          attachments
+        } : {}
+      });
+      if (updated === null) {
+        throw new import_common7.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_common7.BadRequestException("position must be a non-negative integer");
+      }
+      if (!await store.moveQueuedMessage(messageId, patch.position)) {
+        throw new import_common7.GoneException(`queued message ${messageId} already started or was removed`);
+      }
+    }
+    return queue.publish(threadId);
+  }
+  /** `DELETE <base>/queue/:messageId` — drop a waiting message. Answers the thread's queue. */
+  async removeQueuedMessage(actor, messageId) {
+    const queue = this.requireQueue();
+    const threadId = await this.assertOwnsQueuedMessage(actor, messageId);
+    if (!await queue.queueStore().removeQueuedMessage(messageId)) {
+      throw new import_common7.GoneException(`queued message ${messageId} already started or was removed`);
+    }
+    return queue.publish(threadId);
+  }
+  /** `DELETE <base>/threads/:id/queue` — drop every waiting message (and any pause). */
+  async clearQueue(actor, threadId) {
+    await this.assertOwnsThread(actor, threadId);
+    const queue = this.requireQueue();
+    await queue.queueStore().clearQueue(threadId);
+    await queue.queueStore().setQueuePause(threadId, null);
+    return queue.publish(threadId);
+  }
+  /**
+  * `POST <base>/threads/:id/queue/resume` — lift a pause and start the head when nothing is
+  * running. Answers the queue, and the run the head started under, if it did.
+  */
+  async resumeQueue(actor, threadId) {
+    await this.assertOwnsThread(actor, threadId);
+    const queue = this.requireQueue();
+    await queue.queueStore().setQueuePause(threadId, null);
+    const runId = await queue.kick(threadId, this.runner);
+    const state = runId === void 0 ? await queue.publish(threadId) : await queue.state(threadId);
     return {
-      runId,
-      threadId
+      ...state,
+      ...runId !== void 0 ? {
+        runId
+      } : {}
     };
   }
+  /** The thread a queued message waits on, once the caller is shown to own it. */
+  async assertOwnsQueuedMessage(actor, messageId) {
+    const message = await this.requireQueue().queueStore().getQueuedMessage(messageId);
+    if (message === null) {
+      throw new import_common7.NotFoundException(`queued message ${messageId} not found`);
+    }
+    await this.assertOwnsThread(actor, message.threadId);
+    return message.threadId;
+  }
   /**
   * Rebuild this turn's attachments from the staging store, keyed by the ids the caller claimed.
   * The model provider fetches {@link MessageAttachment.url} verbatim, so that url is only ever
@@ -1310,7 +2085,7 @@ var AgentService = class {
     }
     const staging = this.staging;
     if (staging === void 0 || typeof staging.resolve !== "function") {
-      throw new import_common6.NotImplementedException("Message attachments require an AGENT_ATTACHMENT_STAGING provider implementing resolve(); attachment urls are never taken from the request.");
+      throw new import_common7.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) {
@@ -1319,7 +2094,7 @@ var AgentService = class {
         actor
       });
       if (attachment === null) {
-        throw new import_common6.ForbiddenException(`attachment ${ref.mediaId} is not available to this actor`);
+        throw new import_common7.ForbiddenException(`attachment ${ref.mediaId} is not available to this actor`);
       }
       resolved.push(attachment);
     }
@@ -1468,7 +2243,7 @@ var AgentService = class {
       return;
     }
     if (this.store.updateThread === void 0) {
-      throw new import_common6.NotImplementedException("Setting a thread's defaultAgent or model requires an AgentStore that implements updateThread(); the bound store does not support it.");
+      throw new import_common7.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, {
@@ -1486,10 +2261,10 @@ var AgentService = class {
   validateTitle(title) {
     const trimmed = title.trim();
     if (trimmed.length === 0) {
-      throw new import_common6.BadRequestException("title must not be empty");
+      throw new import_common7.BadRequestException("title must not be empty");
     }
     if (trimmed.length > 200) {
-      throw new import_common6.BadRequestException("title must be at most 200 characters");
+      throw new import_common7.BadRequestException("title must be at most 200 characters");
     }
     return trimmed;
   }
@@ -1533,9 +2308,13 @@ var AgentService = class {
   }
   async toDetailView(thread, actor) {
     const summary = await this.toSummaryView(thread);
+    const queue = this.queueing();
     return {
       ...summary,
-      messages: await this.freshAttachmentUrls(thread.messages, actor)
+      messages: await this.freshAttachmentUrls(thread.messages, actor),
+      ...queue !== void 0 ? {
+        queue: await queue.state(thread.id)
+      } : {}
     };
   }
   /**
@@ -1588,21 +2367,21 @@ var AgentService = class {
   */
   async setMessageFeedback(actor, messageId, input) {
     if (input.value !== null && input.value !== "up" && input.value !== "down") {
-      throw new import_common6.BadRequestException("value must be 'up', 'down' or null");
+      throw new import_common7.BadRequestException("value must be 'up', 'down' or null");
     }
     if (input.comment !== void 0 && typeof input.comment !== "string") {
-      throw new import_common6.BadRequestException("comment must be a string");
+      throw new import_common7.BadRequestException("comment must be a string");
     }
     const comment = input.comment?.trim();
     if (comment !== void 0 && comment.length > 2e3) {
-      throw new import_common6.BadRequestException("comment must be at most 2000 characters");
+      throw new import_common7.BadRequestException("comment must be at most 2000 characters");
     }
     if (this.store.threadOfMessage === void 0 || this.store.setMessageFeedback === void 0) {
-      throw new import_common6.NotImplementedException("Message feedback requires an AgentStore that implements threadOfMessage() and setMessageFeedback(); the bound store does not support it.");
+      throw new import_common7.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_common6.NotFoundException(`message ${messageId} not found`);
+      throw new import_common7.NotFoundException(`message ${messageId} not found`);
     }
     await this.assertOwnsThread(actor, threadId);
     const feedback = input.value === null ? null : {
@@ -1650,7 +2429,7 @@ var AgentService = class {
     const list = this.attachmentInventory();
     const referencedMediaIds = this.store.referencedMediaIds?.bind(this.store);
     if (referencedMediaIds === void 0) {
-      throw new import_common6.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_common7.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({
@@ -1672,7 +2451,7 @@ var AgentService = class {
   attachmentInventory() {
     const list = this.staging?.list?.bind(this.staging);
     if (list === void 0) {
-      throw new import_common6.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_common7.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;
   }
@@ -1683,10 +2462,10 @@ var AgentService = class {
   async assertOwnsThread(actor, threadId) {
     const owner = await this.store.ownerOfThread(threadId);
     if (owner === null) {
-      throw new import_common6.NotFoundException(`thread ${threadId} not found`);
+      throw new import_common7.NotFoundException(`thread ${threadId} not found`);
     }
     if (owner !== actor.id) {
-      throw new import_common6.ForbiddenException("thread belongs to another actor");
+      throw new import_common7.ForbiddenException("thread belongs to another actor");
     }
   }
   /**
@@ -1697,10 +2476,10 @@ var AgentService = class {
   async assertOwnsToolCall(actor, toolCallId2) {
     const owner = await this.store.ownerOfToolCall(toolCallId2);
     if (owner === null) {
-      throw new import_common6.NotFoundException(`tool call ${toolCallId2} not found`);
+      throw new import_common7.NotFoundException(`tool call ${toolCallId2} not found`);
     }
     if (owner !== actor.id) {
-      throw new import_common6.ForbiddenException("tool call belongs to another actor");
+      throw new import_common7.ForbiddenException("tool call belongs to another actor");
     }
   }
   /**
@@ -1715,12 +2494,12 @@ var AgentService = class {
     if (this.store.toolCallInput === void 0) {
       return;
     }
-    const questions = (0, import_nestjs_agent_core8.readElicitationQuestions)(await this.store.toolCallInput(toolCallId2));
+    const questions = (0, import_nestjs_agent_core9.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_core8.validateElicitationAnswer)(question, submitted ?? question.defaults ?? []);
+      const problem = (0, import_nestjs_agent_core9.validateElicitationAnswer)(question, submitted ?? question.defaults ?? []);
       if (problem !== null) {
-        throw new import_common6.BadRequestException(`answers["${question.id}"] ${problem}`);
+        throw new import_common7.BadRequestException(`answers["${question.id}"] ${problem}`);
       }
     }
   }
@@ -1732,21 +2511,21 @@ var AgentService = class {
   */
   async assertMayDecide(actor, toolCallId2) {
     const approval = await this.store.toolCallApproval?.(toolCallId2);
-    const approver = approval?.approver ?? import_nestjs_agent_core8.REQUESTER_APPROVER;
-    if (approver === import_nestjs_agent_core8.REQUESTER_APPROVER) {
+    const approver = approval?.approver ?? import_nestjs_agent_core9.REQUESTER_APPROVER;
+    if (approver === import_nestjs_agent_core9.REQUESTER_APPROVER) {
       return this.assertOwnsToolCall(actor, toolCallId2);
     }
     const requesterRef = await this.store.ownerOfToolCall(toolCallId2);
     if (requesterRef === null) {
-      throw new import_common6.NotFoundException(`tool call ${toolCallId2} not found`);
+      throw new import_common7.NotFoundException(`tool call ${toolCallId2} not found`);
     }
-    const allowed = await (0, import_nestjs_agent_core8.mayDecideApproval)(this.deps.forAgent().approvalPolicy, actor, {
+    const allowed = await (0, import_nestjs_agent_core9.mayDecideApproval)(this.deps.forAgent().approvalPolicy, actor, {
       toolCallId: toolCallId2,
       approver,
       requesterRef
     });
     if (!allowed) {
-      throw new import_common6.ForbiddenException(`this approval is for ${approver}`);
+      throw new import_common7.ForbiddenException(`this approval is for ${approver}`);
     }
   }
   /**
@@ -1762,7 +2541,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_common6.GoneException(`the approval request for tool call ${toolCallId2} has expired`);
+      throw new import_common7.GoneException(`the approval request for tool call ${toolCallId2} has expired`);
     }
   }
   /**
@@ -1775,7 +2554,7 @@ var AgentService = class {
   async resolveRunForToolCall(toolCallId2) {
     const runId = await this.store.runForToolCall(toolCallId2);
     if (runId === null) {
-      throw new import_common6.NotFoundException(`tool call ${toolCallId2} has no active run to signal`);
+      throw new import_common7.NotFoundException(`tool call ${toolCallId2} has no active run to signal`);
     }
     return runId;
   }
@@ -1783,41 +2562,43 @@ var AgentService = class {
   async assertOwnsActiveStream(actor, runId) {
     const owner = await this.store.ownerOfActiveStream(runId);
     if (owner === null) {
-      throw new import_common6.NotFoundException(`no active run ${runId}`);
+      throw new import_common7.NotFoundException(`no active run ${runId}`);
     }
     if (owner !== actor.id) {
-      throw new import_common6.ForbiddenException("run belongs to another actor");
+      throw new import_common7.ForbiddenException("run belongs to another actor");
     }
   }
 };
-AgentService = _ts_decorate6([
-  (0, import_common6.Injectable)(),
-  _ts_param5(0, (0, import_common6.Inject)(import_nestjs_agent_core8.AGENT_RUNNER)),
-  _ts_param5(1, (0, import_common6.Inject)(import_nestjs_agent_core8.AGENT_STORE)),
-  _ts_param5(2, (0, import_common6.Inject)(import_nestjs_agent_core8.AGENT_DEPS_FACTORY)),
-  _ts_param5(3, (0, import_common6.Optional)()),
-  _ts_param5(3, (0, import_common6.Inject)(import_nestjs_agent_core8.AGENT_ATTACHMENT_STAGING)),
-  _ts_param5(4, (0, import_common6.Optional)()),
-  _ts_param5(4, (0, import_common6.Inject)(import_nestjs_agent_core8.AGENT_MODEL_CATALOG)),
-  _ts_param5(5, (0, import_common6.Optional)()),
-  _ts_param5(5, (0, import_common6.Inject)(import_nestjs_agent_core8.AGENT_QUOTA_PROVIDER)),
-  _ts_param5(6, (0, import_common6.Optional)()),
-  _ts_param5(6, (0, import_common6.Inject)(import_nestjs_agent_core8.AGENT_OPTIONS)),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+AgentService = _ts_decorate7([
+  (0, import_common7.Injectable)(),
+  _ts_param6(0, (0, import_common7.Inject)(import_nestjs_agent_core9.AGENT_RUNNER)),
+  _ts_param6(1, (0, import_common7.Inject)(import_nestjs_agent_core9.AGENT_STORE)),
+  _ts_param6(2, (0, import_common7.Inject)(import_nestjs_agent_core9.AGENT_DEPS_FACTORY)),
+  _ts_param6(3, (0, import_common7.Optional)()),
+  _ts_param6(3, (0, import_common7.Inject)(import_nestjs_agent_core9.AGENT_ATTACHMENT_STAGING)),
+  _ts_param6(4, (0, import_common7.Optional)()),
+  _ts_param6(4, (0, import_common7.Inject)(import_nestjs_agent_core9.AGENT_MODEL_CATALOG)),
+  _ts_param6(5, (0, import_common7.Optional)()),
+  _ts_param6(5, (0, import_common7.Inject)(import_nestjs_agent_core9.AGENT_QUOTA_PROVIDER)),
+  _ts_param6(6, (0, import_common7.Optional)()),
+  _ts_param6(6, (0, import_common7.Inject)(import_nestjs_agent_core9.AGENT_OPTIONS)),
+  _ts_param6(7, (0, import_common7.Optional)()),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("design:paramtypes", [
     typeof AgentRunner === "undefined" ? Object : AgentRunner,
     typeof AgentStore === "undefined" ? Object : AgentStore,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
     typeof AttachmentStagingStore === "undefined" ? Object : AttachmentStagingStore,
     typeof ModelCatalog === "undefined" ? Object : ModelCatalog,
     typeof QuotaProvider === "undefined" ? Object : QuotaProvider,
-    typeof Pick === "undefined" ? Object : Pick
+    typeof Pick === "undefined" ? Object : Pick,
+    typeof ChatQueueService === "undefined" ? Object : ChatQueueService
   ])
 ], AgentService);
 
 // src/approval-port.adapter.ts
-var import_common7 = require("@nestjs/common");
-function _ts_decorate7(decorators, target, key, desc) {
+var import_common8 = require("@nestjs/common");
+function _ts_decorate8(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -1830,13 +2611,13 @@ function _ts_decorate7(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate7, "_ts_decorate");
-function _ts_metadata6(metadataKey, metadataValue) {
+__name(_ts_decorate8, "_ts_decorate");
+function _ts_metadata7(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata6, "_ts_metadata");
+__name(_ts_metadata7, "_ts_metadata");
 var AgentApprovalPortAdapter = class {
   static {
     __name(this, "AgentApprovalPortAdapter");
@@ -1874,18 +2655,18 @@ var AgentApprovalPortAdapter = class {
     });
   }
 };
-AgentApprovalPortAdapter = _ts_decorate7([
-  (0, import_common7.Injectable)(),
-  _ts_metadata6("design:type", Function),
-  _ts_metadata6("design:paramtypes", [
+AgentApprovalPortAdapter = _ts_decorate8([
+  (0, import_common8.Injectable)(),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService
   ])
 ], AgentApprovalPortAdapter);
 
 // src/controller/agents.controller.ts
-var import_nestjs_agent_core9 = require("@dudousxd/nestjs-agent-core");
-var import_common8 = require("@nestjs/common");
-function _ts_decorate8(decorators, target, key, desc) {
+var import_nestjs_agent_core10 = require("@dudousxd/nestjs-agent-core");
+var import_common9 = 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") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -1898,19 +2679,19 @@ function _ts_decorate8(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate8, "_ts_decorate");
-function _ts_metadata7(metadataKey, metadataValue) {
+__name(_ts_decorate9, "_ts_decorate");
+function _ts_metadata8(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata7, "_ts_metadata");
-function _ts_param6(paramIndex, decorator) {
+__name(_ts_metadata8, "_ts_metadata");
+function _ts_param7(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param6, "_ts_param");
+__name(_ts_param7, "_ts_param");
 var AgentsController = class {
   static {
     __name(this, "AgentsController");
@@ -1932,26 +2713,26 @@ var AgentsController = class {
     }));
   }
 };
-_ts_decorate8([
-  (0, import_common8.Get)(),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", []),
-  _ts_metadata7("design:returntype", Array)
+_ts_decorate9([
+  (0, import_common9.Get)(),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", []),
+  _ts_metadata8("design:returntype", Array)
 ], AgentsController.prototype, "list", null);
-AgentsController = _ts_decorate8([
-  (0, import_common8.Controller)("agents"),
-  _ts_param6(0, (0, import_common8.Inject)(import_nestjs_agent_core9.AGENT_REGISTRY)),
-  _ts_param6(1, (0, import_common8.Inject)(import_nestjs_agent_core9.AGENT_DEPS_FACTORY)),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
-    typeof import_nestjs_agent_core9.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core9.AgentRegistry,
+AgentsController = _ts_decorate9([
+  (0, import_common9.Controller)("agents"),
+  _ts_param7(0, (0, import_common9.Inject)(import_nestjs_agent_core10.AGENT_REGISTRY)),
+  _ts_param7(1, (0, import_common9.Inject)(import_nestjs_agent_core10.AGENT_DEPS_FACTORY)),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", [
+    typeof import_nestjs_agent_core10.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core10.AgentRegistry,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory
   ])
 ], AgentsController);
 
 // src/controller/attachments.controller.ts
-var import_nestjs_agent_core10 = require("@dudousxd/nestjs-agent-core");
-var import_common9 = require("@nestjs/common");
+var import_nestjs_agent_core11 = require("@dudousxd/nestjs-agent-core");
+var import_common10 = require("@nestjs/common");
 var import_platform_express = require("@nestjs/platform-express");
 
 // src/attachment-limits.ts
@@ -1980,7 +2761,7 @@ function attachmentLimits(options, staging) {
 __name(attachmentLimits, "attachmentLimits");
 
 // src/controller/attachments.controller.ts
-function _ts_decorate9(decorators, target, key, desc) {
+function _ts_decorate10(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -1993,19 +2774,19 @@ function _ts_decorate9(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate9, "_ts_decorate");
-function _ts_metadata8(metadataKey, metadataValue) {
+__name(_ts_decorate10, "_ts_decorate");
+function _ts_metadata9(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata8, "_ts_metadata");
-function _ts_param7(paramIndex, decorator) {
+__name(_ts_metadata9, "_ts_metadata");
+function _ts_param8(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param7, "_ts_param");
+__name(_ts_param8, "_ts_param");
 var HARD_MAX_ATTACHMENT_BYTES = 32 * 1024 * 1024;
 var ATTACHMENT_PAGE_SIZE = 50;
 var AttachmentsController = class {
@@ -2039,17 +2820,17 @@ var AttachmentsController = class {
   }
   async upload(req, file) {
     if (this.staging === void 0) {
-      throw new import_common9.NotImplementedException("Attachment upload is not configured on this server: bind AGENT_ATTACHMENT_STAGING (e.g. import AgentMediaAttachmentsModule).");
+      throw new import_common10.NotImplementedException("Attachment upload is not configured on this server: bind AGENT_ATTACHMENT_STAGING (e.g. import AgentMediaAttachmentsModule).");
     }
     if (file === void 0) {
-      throw new import_common9.BadRequestException('multipart field "file" is required');
+      throw new import_common10.BadRequestException('multipart field "file" is required');
     }
     const { allowedContentTypes, maxBytes } = attachmentLimits(this.options, this.staging);
     if (!allowedContentTypes.includes(file.mimetype)) {
-      throw new import_common9.UnsupportedMediaTypeException(`content type "${file.mimetype}" is not allowed (allowed: ${allowedContentTypes.join(", ")})`);
+      throw new import_common10.UnsupportedMediaTypeException(`content type "${file.mimetype}" is not allowed (allowed: ${allowedContentTypes.join(", ")})`);
     }
     if (file.size > maxBytes) {
-      throw new import_common9.PayloadTooLargeException(`file exceeds the ${maxBytes}-byte limit`);
+      throw new import_common10.PayloadTooLargeException(`file exceeds the ${maxBytes}-byte limit`);
     }
     const actor = await this.actorResolver.resolve(req);
     return this.staging.stage({
@@ -2061,39 +2842,39 @@ var AttachmentsController = class {
     });
   }
 };
-_ts_decorate9([
-  (0, import_common9.Get)(),
-  _ts_param7(0, (0, import_common9.Req)()),
-  _ts_metadata8("design:type", Function),
-  _ts_metadata8("design:paramtypes", [
+_ts_decorate10([
+  (0, import_common10.Get)(),
+  _ts_param8(0, (0, import_common10.Req)()),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata8("design:returntype", Promise)
+  _ts_metadata9("design:returntype", Promise)
 ], AttachmentsController.prototype, "list", null);
-_ts_decorate9([
-  (0, import_common9.Post)(),
-  (0, import_common9.UseInterceptors)((0, import_platform_express.FileInterceptor)("file", {
+_ts_decorate10([
+  (0, import_common10.Post)(),
+  (0, import_common10.UseInterceptors)((0, import_platform_express.FileInterceptor)("file", {
     limits: {
       fileSize: HARD_MAX_ATTACHMENT_BYTES
     }
   })),
-  _ts_param7(0, (0, import_common9.Req)()),
-  _ts_param7(1, (0, import_common9.UploadedFile)()),
-  _ts_metadata8("design:type", Function),
-  _ts_metadata8("design:paramtypes", [
+  _ts_param8(0, (0, import_common10.Req)()),
+  _ts_param8(1, (0, import_common10.UploadedFile)()),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     Object
   ]),
-  _ts_metadata8("design:returntype", Promise)
+  _ts_metadata9("design:returntype", Promise)
 ], AttachmentsController.prototype, "upload", null);
-AttachmentsController = _ts_decorate9([
-  (0, import_common9.Controller)("attachments"),
-  _ts_param7(0, (0, import_common9.Inject)(import_nestjs_agent_core10.AGENT_OPTIONS)),
-  _ts_param7(1, (0, import_common9.Inject)(import_nestjs_agent_core10.AGENT_ACTOR_RESOLVER)),
-  _ts_param7(3, (0, import_common9.Optional)()),
-  _ts_param7(3, (0, import_common9.Inject)(import_nestjs_agent_core10.AGENT_ATTACHMENT_STAGING)),
-  _ts_metadata8("design:type", Function),
-  _ts_metadata8("design:paramtypes", [
+AttachmentsController = _ts_decorate10([
+  (0, import_common10.Controller)("attachments"),
+  _ts_param8(0, (0, import_common10.Inject)(import_nestjs_agent_core11.AGENT_OPTIONS)),
+  _ts_param8(1, (0, import_common10.Inject)(import_nestjs_agent_core11.AGENT_ACTOR_RESOLVER)),
+  _ts_param8(3, (0, import_common10.Optional)()),
+  _ts_param8(3, (0, import_common10.Inject)(import_nestjs_agent_core11.AGENT_ATTACHMENT_STAGING)),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -2102,9 +2883,9 @@ AttachmentsController = _ts_decorate9([
 ], AttachmentsController);
 
 // src/controller/chat.controller.ts
-var import_nestjs_agent_core11 = require("@dudousxd/nestjs-agent-core");
-var import_common10 = require("@nestjs/common");
-function _ts_decorate10(decorators, target, key, desc) {
+var import_nestjs_agent_core12 = require("@dudousxd/nestjs-agent-core");
+var import_common11 = require("@nestjs/common");
+function _ts_decorate11(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -2117,39 +2898,52 @@ function _ts_decorate10(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate10, "_ts_decorate");
-function _ts_metadata9(metadataKey, metadataValue) {
+__name(_ts_decorate11, "_ts_decorate");
+function _ts_metadata10(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata9, "_ts_metadata");
-function _ts_param8(paramIndex, decorator) {
+__name(_ts_metadata10, "_ts_metadata");
+function _ts_param9(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param8, "_ts_param");
+__name(_ts_param9, "_ts_param");
+function sendMode(body) {
+  if (body.interrupt === true) {
+    return "interrupt";
+  }
+  if (body.mode === void 0 || body.mode === null) {
+    return "auto";
+  }
+  if (body.mode === "auto" || body.mode === "queue" || body.mode === "interrupt") {
+    return body.mode;
+  }
+  throw new import_common11.BadRequestException("mode must be 'auto', 'queue' or 'interrupt'");
+}
+__name(sendMode, "sendMode");
 function attachmentRefs(claimed) {
   if (claimed === void 0) {
     return [];
   }
   if (!Array.isArray(claimed)) {
-    throw new import_common10.BadRequestException("attachments must be an array of { mediaId }");
+    throw new import_common11.BadRequestException("attachments must be an array of { mediaId }");
   }
   if (claimed.length > MAX_ATTACHMENTS_PER_MESSAGE) {
-    throw new import_common10.BadRequestException(`a message may carry at most ${MAX_ATTACHMENTS_PER_MESSAGE} attachments`);
+    throw new import_common11.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_common10.BadRequestException("each attachment must be an object with a mediaId");
+      throw new import_common11.BadRequestException("each attachment must be an object with a mediaId");
     }
     if (Object.keys(entry).some((key) => key !== "mediaId")) {
-      throw new import_common10.BadRequestException("attachments are { mediaId } refs \u2014 send nothing but the id");
+      throw new import_common11.BadRequestException("attachments are { mediaId } refs \u2014 send nothing but the id");
     }
     const { mediaId } = entry;
     if (typeof mediaId !== "string" || mediaId.length === 0) {
-      throw new import_common10.BadRequestException("each attachment must carry a non-empty string mediaId");
+      throw new import_common11.BadRequestException("each attachment must carry a non-empty string mediaId");
     }
     return {
       mediaId
@@ -2167,10 +2961,17 @@ var ChatController = class {
     this.agent = agent;
     this.actorResolver = actorResolver;
   }
+  /**
+  * Start a turn and stream it — or, when the thread already has one running, queue the message and
+  * answer `202 { queued: true, messageId, position, queue, … }` (JSON, no stream): it runs when the
+  * turn ahead of it settles, and the stream of the run holding the thread announces it with a
+  * `queue` frame.
+  */
   async chat(req, res, body) {
     const actor = await this.actorResolver.resolve(req);
     const attachments = attachmentRefs(body.attachments);
-    const { runId, threadId } = await this.agent.chat({
+    const mode = sendMode(body);
+    const result = await this.agent.send({
       actor,
       message: body.message,
       ...body.threadId !== void 0 ? {
@@ -2193,8 +2994,14 @@ var ChatController = class {
       } : {},
       ...typeof body.model === "string" && body.model.length > 0 ? {
         model: body.model
-      } : {}
+      } : {},
+      mode
     });
+    if (result.queued === true) {
+      res.status(202).json(result);
+      return;
+    }
+    const { runId, threadId } = result;
     await this.pipe(res, runId, this.agent.subscribe(runId), threadId);
   }
   /**
@@ -2269,7 +3076,7 @@ data: ${line}
       }
       res.write("event: done\ndata: {}\n\n");
     } catch (error) {
-      const payload = error instanceof import_nestjs_agent_core11.AgentStreamError ? {
+      const payload = error instanceof import_nestjs_agent_core12.AgentStreamError ? {
         code: error.code,
         message: error.message
       } : {
@@ -2284,50 +3091,50 @@ data: ${JSON.stringify(payload)}
     res.end();
   }
 };
-_ts_decorate10([
-  (0, import_common10.Post)("chat"),
-  _ts_param8(0, (0, import_common10.Req)()),
-  _ts_param8(1, (0, import_common10.Res)()),
-  _ts_param8(2, (0, import_common10.Body)()),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+_ts_decorate11([
+  (0, import_common11.Post)("chat"),
+  _ts_param9(0, (0, import_common11.Req)()),
+  _ts_param9(1, (0, import_common11.Res)()),
+  _ts_param9(2, (0, import_common11.Body)()),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof Response === "undefined" ? Object : Response,
     typeof ChatBody === "undefined" ? Object : ChatBody
   ]),
-  _ts_metadata9("design:returntype", Promise)
+  _ts_metadata10("design:returntype", Promise)
 ], ChatController.prototype, "chat", null);
-_ts_decorate10([
-  (0, import_common10.Get)("chat/:runId/stream"),
-  _ts_param8(0, (0, import_common10.Req)()),
-  _ts_param8(1, (0, import_common10.Param)("runId")),
-  _ts_param8(2, (0, import_common10.Res)()),
-  _ts_param8(3, (0, import_common10.Query)("after")),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+_ts_decorate11([
+  (0, import_common11.Get)("chat/:runId/stream"),
+  _ts_param9(0, (0, import_common11.Req)()),
+  _ts_param9(1, (0, import_common11.Param)("runId")),
+  _ts_param9(2, (0, import_common11.Res)()),
+  _ts_param9(3, (0, import_common11.Query)("after")),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     typeof Response === "undefined" ? Object : Response,
     String
   ]),
-  _ts_metadata9("design:returntype", Promise)
+  _ts_metadata10("design:returntype", Promise)
 ], ChatController.prototype, "stream", null);
-_ts_decorate10([
-  (0, import_common10.Post)("chat/:runId/cancel"),
-  _ts_param8(0, (0, import_common10.Req)()),
-  _ts_param8(1, (0, import_common10.Param)("runId")),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+_ts_decorate11([
+  (0, import_common11.Post)("chat/:runId/cancel"),
+  _ts_param9(0, (0, import_common11.Req)()),
+  _ts_param9(1, (0, import_common11.Param)("runId")),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata9("design:returntype", Promise)
+  _ts_metadata10("design:returntype", Promise)
 ], ChatController.prototype, "cancel", null);
-ChatController = _ts_decorate10([
-  (0, import_common10.Controller)(),
-  _ts_param8(1, (0, import_common10.Inject)(import_nestjs_agent_core11.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+ChatController = _ts_decorate11([
+  (0, import_common11.Controller)(),
+  _ts_param9(1, (0, import_common11.Inject)(import_nestjs_agent_core12.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
@@ -2343,8 +3150,8 @@ function parseCursor(raw) {
 __name(parseCursor, "parseCursor");
 
 // src/controller/config.controller.ts
-var import_nestjs_agent_core12 = require("@dudousxd/nestjs-agent-core");
-var import_common11 = require("@nestjs/common");
+var import_nestjs_agent_core13 = require("@dudousxd/nestjs-agent-core");
+var import_common12 = require("@nestjs/common");
 
 // src/resolver/anonymous-actor-resolver.ts
 var import_node_crypto2 = require("crypto");
@@ -2434,7 +3241,7 @@ var AnonymousActorResolver = class {
 };
 
 // src/controller/config.controller.ts
-function _ts_decorate11(decorators, target, key, desc) {
+function _ts_decorate12(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -2447,19 +3254,19 @@ function _ts_decorate11(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate11, "_ts_decorate");
-function _ts_metadata10(metadataKey, metadataValue) {
+__name(_ts_decorate12, "_ts_decorate");
+function _ts_metadata11(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata10, "_ts_metadata");
-function _ts_param9(paramIndex, decorator) {
+__name(_ts_metadata11, "_ts_metadata");
+function _ts_param10(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param9, "_ts_param");
+__name(_ts_param10, "_ts_param");
 var ConfigController = class {
   static {
     __name(this, "ConfigController");
@@ -2490,25 +3297,25 @@ var ConfigController = class {
     };
   }
 };
-_ts_decorate11([
-  (0, import_common11.Get)(),
-  _ts_param9(0, (0, import_common11.Req)()),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+_ts_decorate12([
+  (0, import_common12.Get)(),
+  _ts_param10(0, (0, import_common12.Req)()),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata10("design:returntype", Promise)
+  _ts_metadata11("design:returntype", Promise)
 ], ConfigController.prototype, "config", null);
-ConfigController = _ts_decorate11([
-  (0, import_common11.Controller)("config"),
-  _ts_param9(0, (0, import_common11.Inject)(import_nestjs_agent_core12.AGENT_OPTIONS)),
-  _ts_param9(1, (0, import_common11.Inject)(import_nestjs_agent_core12.AGENT_ACTOR_RESOLVER)),
-  _ts_param9(2, (0, import_common11.Optional)()),
-  _ts_param9(2, (0, import_common11.Inject)(import_nestjs_agent_core12.AGENT_ATTACHMENT_STAGING)),
-  _ts_param9(3, (0, import_common11.Optional)()),
-  _ts_param9(3, (0, import_common11.Inject)(import_nestjs_agent_core12.AGENT_MODEL_CATALOG)),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+ConfigController = _ts_decorate12([
+  (0, import_common12.Controller)("config"),
+  _ts_param10(0, (0, import_common12.Inject)(import_nestjs_agent_core13.AGENT_OPTIONS)),
+  _ts_param10(1, (0, import_common12.Inject)(import_nestjs_agent_core13.AGENT_ACTOR_RESOLVER)),
+  _ts_param10(2, (0, import_common12.Optional)()),
+  _ts_param10(2, (0, import_common12.Inject)(import_nestjs_agent_core13.AGENT_ATTACHMENT_STAGING)),
+  _ts_param10(3, (0, import_common12.Optional)()),
+  _ts_param10(3, (0, import_common12.Inject)(import_nestjs_agent_core13.AGENT_MODEL_CATALOG)),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     Object,
@@ -2517,9 +3324,9 @@ ConfigController = _ts_decorate11([
 ], ConfigController);
 
 // src/controller/memories.controller.ts
-var import_nestjs_agent_core13 = require("@dudousxd/nestjs-agent-core");
-var import_common12 = require("@nestjs/common");
-function _ts_decorate12(decorators, target, key, desc) {
+var import_nestjs_agent_core14 = require("@dudousxd/nestjs-agent-core");
+var import_common13 = require("@nestjs/common");
+function _ts_decorate13(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -2532,19 +3339,19 @@ function _ts_decorate12(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate12, "_ts_decorate");
-function _ts_metadata11(metadataKey, metadataValue) {
+__name(_ts_decorate13, "_ts_decorate");
+function _ts_metadata12(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata11, "_ts_metadata");
-function _ts_param10(paramIndex, decorator) {
+__name(_ts_metadata12, "_ts_metadata");
+function _ts_param11(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param10, "_ts_param");
+__name(_ts_param11, "_ts_param");
 var MemoriesController = class {
   static {
     __name(this, "MemoriesController");
@@ -2578,20 +3385,20 @@ var MemoriesController = class {
   */
   async forget(req, id) {
     if (this.memory === void 0) {
-      throw new import_common12.NotFoundException("No memory is configured in this deployment.");
+      throw new import_common13.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_common12.NotFoundException(`No memory with id "${id}".`);
+      throw new import_common13.NotFoundException(`No memory with id "${id}".`);
     }
-    const verdict = (0, import_nestjs_agent_core13.memoryForgetVerdict)({
+    const verdict = (0, import_nestjs_agent_core14.memoryForgetVerdict)({
       record: entry,
       actor
     });
     if (!verdict.allowed) {
-      throw new import_common12.ForbiddenException(verdict.reason);
+      throw new import_common13.ForbiddenException(verdict.reason);
     }
     return {
       forgotten: await this.memory.provider.forget({
@@ -2605,7 +3412,7 @@ var MemoriesController = class {
   }
   async unbounded(threadId, actor) {
     const config = this.memory;
-    return await (0, import_nestjs_agent_core13.offerMemories)({
+    return await (0, import_nestjs_agent_core14.offerMemories)({
       config: {
         ...config,
         maxMemories: Number.POSITIVE_INFINITY
@@ -2617,44 +3424,44 @@ var MemoriesController = class {
     });
   }
 };
-_ts_decorate12([
-  (0, import_common12.Get)(),
-  _ts_param10(0, (0, import_common12.Req)()),
-  _ts_param10(1, (0, import_common12.Query)("threadId")),
-  _ts_metadata11("design:type", Function),
-  _ts_metadata11("design:paramtypes", [
+_ts_decorate13([
+  (0, import_common13.Get)(),
+  _ts_param11(0, (0, import_common13.Req)()),
+  _ts_param11(1, (0, import_common13.Query)("threadId")),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata11("design:returntype", Promise)
+  _ts_metadata12("design:returntype", Promise)
 ], MemoriesController.prototype, "list", null);
-_ts_decorate12([
-  (0, import_common12.Delete)(":id"),
-  _ts_param10(0, (0, import_common12.Req)()),
-  _ts_param10(1, (0, import_common12.Param)("id")),
-  _ts_metadata11("design:type", Function),
-  _ts_metadata11("design:paramtypes", [
+_ts_decorate13([
+  (0, import_common13.Delete)(":id"),
+  _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,
     String
   ]),
-  _ts_metadata11("design:returntype", Promise)
+  _ts_metadata12("design:returntype", Promise)
 ], MemoriesController.prototype, "forget", null);
-MemoriesController = _ts_decorate12([
-  (0, import_common12.Controller)("memories"),
-  _ts_param10(0, (0, import_common12.Inject)(import_nestjs_agent_core13.AGENT_ACTOR_RESOLVER)),
-  _ts_param10(1, (0, import_common12.Optional)()),
-  _ts_param10(1, (0, import_common12.Inject)(import_nestjs_agent_core13.AGENT_MEMORY)),
-  _ts_metadata11("design:type", Function),
-  _ts_metadata11("design:paramtypes", [
+MemoriesController = _ts_decorate13([
+  (0, import_common13.Controller)("memories"),
+  _ts_param11(0, (0, import_common13.Inject)(import_nestjs_agent_core14.AGENT_ACTOR_RESOLVER)),
+  _ts_param11(1, (0, import_common13.Optional)()),
+  _ts_param11(1, (0, import_common13.Inject)(import_nestjs_agent_core14.AGENT_MEMORY)),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     Object
   ])
 ], MemoriesController);
 
 // src/controller/messages.controller.ts
-var import_nestjs_agent_core14 = require("@dudousxd/nestjs-agent-core");
-var import_common13 = require("@nestjs/common");
-function _ts_decorate13(decorators, target, key, desc) {
+var import_nestjs_agent_core15 = require("@dudousxd/nestjs-agent-core");
+var import_common14 = require("@nestjs/common");
+function _ts_decorate14(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -2667,19 +3474,19 @@ function _ts_decorate13(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate13, "_ts_decorate");
-function _ts_metadata12(metadataKey, metadataValue) {
+__name(_ts_decorate14, "_ts_decorate");
+function _ts_metadata13(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata12, "_ts_metadata");
-function _ts_param11(paramIndex, decorator) {
+__name(_ts_metadata13, "_ts_metadata");
+function _ts_param12(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param11, "_ts_param");
+__name(_ts_param12, "_ts_param");
 var MessagesController = class {
   static {
     __name(this, "MessagesController");
@@ -2707,34 +3514,34 @@ var MessagesController = class {
     };
   }
 };
-_ts_decorate13([
-  (0, import_common13.Post)(":id/feedback"),
-  (0, import_common13.HttpCode)(200),
-  _ts_param11(0, (0, import_common13.Req)()),
-  _ts_param11(1, (0, import_common13.Param)("id")),
-  _ts_param11(2, (0, import_common13.Body)()),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+_ts_decorate14([
+  (0, import_common14.Post)(":id/feedback"),
+  (0, import_common14.HttpCode)(200),
+  _ts_param12(0, (0, import_common14.Req)()),
+  _ts_param12(1, (0, import_common14.Param)("id")),
+  _ts_param12(2, (0, import_common14.Body)()),
+  _ts_metadata13("design:type", Function),
+  _ts_metadata13("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     typeof FeedbackBody === "undefined" ? Object : FeedbackBody
   ]),
-  _ts_metadata12("design:returntype", Promise)
+  _ts_metadata13("design:returntype", Promise)
 ], MessagesController.prototype, "feedback", null);
-MessagesController = _ts_decorate13([
-  (0, import_common13.Controller)("messages"),
-  _ts_param11(1, (0, import_common13.Inject)(import_nestjs_agent_core14.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+MessagesController = _ts_decorate14([
+  (0, import_common14.Controller)("messages"),
+  _ts_param12(1, (0, import_common14.Inject)(import_nestjs_agent_core15.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata13("design:type", Function),
+  _ts_metadata13("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], MessagesController);
 
 // src/controller/models.controller.ts
-var import_nestjs_agent_core15 = require("@dudousxd/nestjs-agent-core");
-var import_common14 = require("@nestjs/common");
-function _ts_decorate14(decorators, target, key, desc) {
+var import_nestjs_agent_core16 = require("@dudousxd/nestjs-agent-core");
+var import_common15 = 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") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -2747,19 +3554,19 @@ function _ts_decorate14(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate14, "_ts_decorate");
-function _ts_metadata13(metadataKey, metadataValue) {
+__name(_ts_decorate15, "_ts_decorate");
+function _ts_metadata14(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata13, "_ts_metadata");
-function _ts_param12(paramIndex, decorator) {
+__name(_ts_metadata14, "_ts_metadata");
+function _ts_param13(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param12, "_ts_param");
+__name(_ts_param13, "_ts_param");
 var ModelsController = class {
   static {
     __name(this, "ModelsController");
@@ -2779,31 +3586,172 @@ var ModelsController = class {
     return this.agent.listModels(actor, agent);
   }
 };
-_ts_decorate14([
-  (0, import_common14.Get)(),
-  _ts_param12(0, (0, import_common14.Req)()),
-  _ts_param12(1, (0, import_common14.Query)("agent")),
-  _ts_metadata13("design:type", Function),
-  _ts_metadata13("design:paramtypes", [
+_ts_decorate15([
+  (0, import_common15.Get)(),
+  _ts_param13(0, (0, import_common15.Req)()),
+  _ts_param13(1, (0, import_common15.Query)("agent")),
+  _ts_metadata14("design:type", Function),
+  _ts_metadata14("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata13("design:returntype", Promise)
+  _ts_metadata14("design:returntype", Promise)
 ], ModelsController.prototype, "list", null);
-ModelsController = _ts_decorate14([
-  (0, import_common14.Controller)("models"),
-  _ts_param12(1, (0, import_common14.Inject)(import_nestjs_agent_core15.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata13("design:type", Function),
-  _ts_metadata13("design:paramtypes", [
+ModelsController = _ts_decorate15([
+  (0, import_common15.Controller)("models"),
+  _ts_param13(1, (0, import_common15.Inject)(import_nestjs_agent_core16.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata14("design:type", Function),
+  _ts_metadata14("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ModelsController);
 
+// src/controller/queue.controller.ts
+var import_nestjs_agent_core17 = require("@dudousxd/nestjs-agent-core");
+var import_common16 = 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") {
+    r = Reflect.decorate(decorators, target, key, desc);
+  } else {
+    for (var i = decorators.length - 1; i >= 0; i--) {
+      if (d = decorators[i]) {
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      }
+    }
+  }
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate16, "_ts_decorate");
+function _ts_metadata15(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
+}
+__name(_ts_metadata15, "_ts_metadata");
+function _ts_param14(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param14, "_ts_param");
+var QueueController = class {
+  static {
+    __name(this, "QueueController");
+  }
+  agent;
+  actorResolver;
+  constructor(agent, actorResolver) {
+    this.agent = agent;
+    this.actorResolver = actorResolver;
+  }
+  async list(req, id) {
+    return this.agent.getQueue(await this.actorResolver.resolve(req), id);
+  }
+  async clear(req, id) {
+    return this.agent.clearQueue(await this.actorResolver.resolve(req), id);
+  }
+  /** Lift a pause; the head starts when nothing is running. Carries `runId` when it started. */
+  async resume(req, id) {
+    return this.agent.resumeQueue(await this.actorResolver.resolve(req), id);
+  }
+  async update(req, messageId, body) {
+    const actor = await this.actorResolver.resolve(req);
+    if (body.message !== void 0 && typeof body.message !== "string") {
+      throw new import_common16.BadRequestException("message must be a string");
+    }
+    if (body.position !== void 0 && typeof body.position !== "number") {
+      throw new import_common16.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, {
+      ...body.message !== void 0 ? {
+        message: body.message
+      } : {},
+      ...attachments !== void 0 ? {
+        attachments
+      } : {},
+      ...body.position !== void 0 ? {
+        position: body.position
+      } : {}
+    });
+  }
+  async remove(req, messageId) {
+    return this.agent.removeQueuedMessage(await this.actorResolver.resolve(req), messageId);
+  }
+};
+_ts_decorate16([
+  (0, import_common16.Get)("threads/:id/queue"),
+  _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,
+    String
+  ]),
+  _ts_metadata15("design:returntype", Promise)
+], QueueController.prototype, "list", null);
+_ts_decorate16([
+  (0, import_common16.Delete)("threads/:id/queue"),
+  _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,
+    String
+  ]),
+  _ts_metadata15("design:returntype", Promise)
+], QueueController.prototype, "clear", null);
+_ts_decorate16([
+  (0, import_common16.Post)("threads/:id/queue/resume"),
+  _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,
+    String
+  ]),
+  _ts_metadata15("design:returntype", Promise)
+], QueueController.prototype, "resume", null);
+_ts_decorate16([
+  (0, import_common16.Patch)("queue/:messageId"),
+  _ts_param14(0, (0, import_common16.Req)()),
+  _ts_param14(1, (0, import_common16.Param)("messageId")),
+  _ts_param14(2, (0, import_common16.Body)()),
+  _ts_metadata15("design:type", Function),
+  _ts_metadata15("design:paramtypes", [
+    typeof Request === "undefined" ? Object : Request,
+    String,
+    typeof UpdateQueuedMessageBody === "undefined" ? Object : UpdateQueuedMessageBody
+  ]),
+  _ts_metadata15("design:returntype", Promise)
+], QueueController.prototype, "update", null);
+_ts_decorate16([
+  (0, import_common16.Delete)("queue/:messageId"),
+  _ts_param14(0, (0, import_common16.Req)()),
+  _ts_param14(1, (0, import_common16.Param)("messageId")),
+  _ts_metadata15("design:type", Function),
+  _ts_metadata15("design:paramtypes", [
+    typeof Request === "undefined" ? Object : Request,
+    String
+  ]),
+  _ts_metadata15("design:returntype", Promise)
+], QueueController.prototype, "remove", null);
+QueueController = _ts_decorate16([
+  (0, import_common16.Controller)(),
+  _ts_param14(1, (0, import_common16.Inject)(import_nestjs_agent_core17.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata15("design:type", Function),
+  _ts_metadata15("design:paramtypes", [
+    typeof AgentService === "undefined" ? Object : AgentService,
+    typeof ActorResolver === "undefined" ? Object : ActorResolver
+  ])
+], QueueController);
+
 // src/controller/quota.controller.ts
-var import_nestjs_agent_core16 = require("@dudousxd/nestjs-agent-core");
-var import_common15 = require("@nestjs/common");
-function _ts_decorate15(decorators, target, key, desc) {
+var import_nestjs_agent_core18 = require("@dudousxd/nestjs-agent-core");
+var import_common17 = 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") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -2816,19 +3764,19 @@ function _ts_decorate15(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate15, "_ts_decorate");
-function _ts_metadata14(metadataKey, metadataValue) {
+__name(_ts_decorate17, "_ts_decorate");
+function _ts_metadata16(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata14, "_ts_metadata");
-function _ts_param13(paramIndex, decorator) {
+__name(_ts_metadata16, "_ts_metadata");
+function _ts_param15(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param13, "_ts_param");
+__name(_ts_param15, "_ts_param");
 var QuotaController = class {
   static {
     __name(this, "QuotaController");
@@ -2848,29 +3796,29 @@ var QuotaController = class {
     return this.agent.quotaReport(actor);
   }
 };
-_ts_decorate15([
-  (0, import_common15.Get)(),
-  _ts_param13(0, (0, import_common15.Req)()),
-  _ts_metadata14("design:type", Function),
-  _ts_metadata14("design:paramtypes", [
+_ts_decorate17([
+  (0, import_common17.Get)(),
+  _ts_param15(0, (0, import_common17.Req)()),
+  _ts_metadata16("design:type", Function),
+  _ts_metadata16("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata14("design:returntype", Promise)
+  _ts_metadata16("design:returntype", Promise)
 ], QuotaController.prototype, "report", null);
-QuotaController = _ts_decorate15([
-  (0, import_common15.Controller)("quota"),
-  _ts_param13(1, (0, import_common15.Inject)(import_nestjs_agent_core16.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata14("design:type", Function),
-  _ts_metadata14("design:paramtypes", [
+QuotaController = _ts_decorate17([
+  (0, import_common17.Controller)("quota"),
+  _ts_param15(1, (0, import_common17.Inject)(import_nestjs_agent_core18.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata16("design:type", Function),
+  _ts_metadata16("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], QuotaController);
 
 // src/controller/skills.controller.ts
-var import_nestjs_agent_core17 = require("@dudousxd/nestjs-agent-core");
-var import_common16 = require("@nestjs/common");
-function _ts_decorate16(decorators, target, key, desc) {
+var import_nestjs_agent_core19 = require("@dudousxd/nestjs-agent-core");
+var import_common18 = require("@nestjs/common");
+function _ts_decorate18(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -2883,19 +3831,19 @@ function _ts_decorate16(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate16, "_ts_decorate");
-function _ts_metadata15(metadataKey, metadataValue) {
+__name(_ts_decorate18, "_ts_decorate");
+function _ts_metadata17(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata15, "_ts_metadata");
-function _ts_param14(paramIndex, decorator) {
+__name(_ts_metadata17, "_ts_metadata");
+function _ts_param16(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param14, "_ts_param");
+__name(_ts_param16, "_ts_param");
 var SkillsController = class {
   static {
     __name(this, "SkillsController");
@@ -2911,40 +3859,40 @@ var SkillsController = class {
       return [];
     }
     const actor = await this.actorResolver.resolve(req);
-    const offer = await (0, import_nestjs_agent_core17.offerSkills)(this.skills, {
+    const offer = await (0, import_nestjs_agent_core19.offerSkills)(this.skills, {
       actor,
       threadId: threadId ?? ""
     });
     return offer.entries;
   }
 };
-_ts_decorate16([
-  (0, import_common16.Get)(),
-  _ts_param14(0, (0, import_common16.Req)()),
-  _ts_param14(1, (0, import_common16.Query)("threadId")),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+_ts_decorate18([
+  (0, import_common18.Get)(),
+  _ts_param16(0, (0, import_common18.Req)()),
+  _ts_param16(1, (0, import_common18.Query)("threadId")),
+  _ts_metadata17("design:type", Function),
+  _ts_metadata17("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata15("design:returntype", Promise)
+  _ts_metadata17("design:returntype", Promise)
 ], SkillsController.prototype, "list", null);
-SkillsController = _ts_decorate16([
-  (0, import_common16.Controller)("skills"),
-  _ts_param14(0, (0, import_common16.Inject)(import_nestjs_agent_core17.AGENT_ACTOR_RESOLVER)),
-  _ts_param14(1, (0, import_common16.Optional)()),
-  _ts_param14(1, (0, import_common16.Inject)(import_nestjs_agent_core17.AGENT_SKILLS)),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+SkillsController = _ts_decorate18([
+  (0, import_common18.Controller)("skills"),
+  _ts_param16(0, (0, import_common18.Inject)(import_nestjs_agent_core19.AGENT_ACTOR_RESOLVER)),
+  _ts_param16(1, (0, import_common18.Optional)()),
+  _ts_param16(1, (0, import_common18.Inject)(import_nestjs_agent_core19.AGENT_SKILLS)),
+  _ts_metadata17("design:type", Function),
+  _ts_metadata17("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     Object
   ])
 ], SkillsController);
 
 // src/controller/threads.controller.ts
-var import_nestjs_agent_core18 = require("@dudousxd/nestjs-agent-core");
-var import_common17 = require("@nestjs/common");
-function _ts_decorate17(decorators, target, key, desc) {
+var import_nestjs_agent_core20 = require("@dudousxd/nestjs-agent-core");
+var import_common19 = require("@nestjs/common");
+function _ts_decorate19(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -2957,19 +3905,19 @@ function _ts_decorate17(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate17, "_ts_decorate");
-function _ts_metadata16(metadataKey, metadataValue) {
+__name(_ts_decorate19, "_ts_decorate");
+function _ts_metadata18(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata16, "_ts_metadata");
-function _ts_param15(paramIndex, decorator) {
+__name(_ts_metadata18, "_ts_metadata");
+function _ts_param17(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param15, "_ts_param");
+__name(_ts_param17, "_ts_param");
 var ThreadsController = class {
   static {
     __name(this, "ThreadsController");
@@ -3036,101 +3984,101 @@ var ThreadsController = class {
     };
   }
 };
-_ts_decorate17([
-  (0, import_common17.Get)(),
-  _ts_param15(0, (0, import_common17.Req)()),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+_ts_decorate19([
+  (0, import_common19.Get)(),
+  _ts_param17(0, (0, import_common19.Req)()),
+  _ts_metadata18("design:type", Function),
+  _ts_metadata18("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata16("design:returntype", Promise)
+  _ts_metadata18("design:returntype", Promise)
 ], ThreadsController.prototype, "list", null);
-_ts_decorate17([
-  (0, import_common17.Get)(":id"),
-  _ts_param15(0, (0, import_common17.Req)()),
-  _ts_param15(1, (0, import_common17.Param)("id")),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+_ts_decorate19([
+  (0, import_common19.Get)(":id"),
+  _ts_param17(0, (0, import_common19.Req)()),
+  _ts_param17(1, (0, import_common19.Param)("id")),
+  _ts_metadata18("design:type", Function),
+  _ts_metadata18("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata16("design:returntype", Promise)
+  _ts_metadata18("design:returntype", Promise)
 ], ThreadsController.prototype, "detail", null);
-_ts_decorate17([
-  (0, import_common17.Delete)(":id"),
-  _ts_param15(0, (0, import_common17.Req)()),
-  _ts_param15(1, (0, import_common17.Param)("id")),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+_ts_decorate19([
+  (0, import_common19.Delete)(":id"),
+  _ts_param17(0, (0, import_common19.Req)()),
+  _ts_param17(1, (0, import_common19.Param)("id")),
+  _ts_metadata18("design:type", Function),
+  _ts_metadata18("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata16("design:returntype", Promise)
+  _ts_metadata18("design:returntype", Promise)
 ], ThreadsController.prototype, "remove", null);
-_ts_decorate17([
-  (0, import_common17.Post)(":id/fork-from/:messageId"),
-  _ts_param15(0, (0, import_common17.Req)()),
-  _ts_param15(1, (0, import_common17.Param)("id")),
-  _ts_param15(2, (0, import_common17.Param)("messageId")),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+_ts_decorate19([
+  (0, import_common19.Post)(":id/fork-from/:messageId"),
+  _ts_param17(0, (0, import_common19.Req)()),
+  _ts_param17(1, (0, import_common19.Param)("id")),
+  _ts_param17(2, (0, import_common19.Param)("messageId")),
+  _ts_metadata18("design:type", Function),
+  _ts_metadata18("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     String
   ]),
-  _ts_metadata16("design:returntype", Promise)
+  _ts_metadata18("design:returntype", Promise)
 ], ThreadsController.prototype, "fork", null);
-_ts_decorate17([
-  (0, import_common17.Patch)(":id"),
-  _ts_param15(0, (0, import_common17.Req)()),
-  _ts_param15(1, (0, import_common17.Param)("id")),
-  _ts_param15(2, (0, import_common17.Body)()),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+_ts_decorate19([
+  (0, import_common19.Patch)(":id"),
+  _ts_param17(0, (0, import_common19.Req)()),
+  _ts_param17(1, (0, import_common19.Param)("id")),
+  _ts_param17(2, (0, import_common19.Body)()),
+  _ts_metadata18("design:type", Function),
+  _ts_metadata18("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     typeof UpdateThreadBody === "undefined" ? Object : UpdateThreadBody
   ]),
-  _ts_metadata16("design:returntype", Promise)
+  _ts_metadata18("design:returntype", Promise)
 ], ThreadsController.prototype, "update", null);
-_ts_decorate17([
-  (0, import_common17.Post)(":id/promote"),
-  _ts_param15(0, (0, import_common17.Req)()),
-  _ts_param15(1, (0, import_common17.Param)("id")),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+_ts_decorate19([
+  (0, import_common19.Post)(":id/promote"),
+  _ts_param17(0, (0, import_common19.Req)()),
+  _ts_param17(1, (0, import_common19.Param)("id")),
+  _ts_metadata18("design:type", Function),
+  _ts_metadata18("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata16("design:returntype", Promise)
+  _ts_metadata18("design:returntype", Promise)
 ], ThreadsController.prototype, "promote", null);
-_ts_decorate17([
-  (0, import_common17.Delete)(":id/from/:messageId"),
-  _ts_param15(0, (0, import_common17.Req)()),
-  _ts_param15(1, (0, import_common17.Param)("id")),
-  _ts_param15(2, (0, import_common17.Param)("messageId")),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+_ts_decorate19([
+  (0, import_common19.Delete)(":id/from/:messageId"),
+  _ts_param17(0, (0, import_common19.Req)()),
+  _ts_param17(1, (0, import_common19.Param)("id")),
+  _ts_param17(2, (0, import_common19.Param)("messageId")),
+  _ts_metadata18("design:type", Function),
+  _ts_metadata18("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     String
   ]),
-  _ts_metadata16("design:returntype", Promise)
+  _ts_metadata18("design:returntype", Promise)
 ], ThreadsController.prototype, "truncateFrom", null);
-ThreadsController = _ts_decorate17([
-  (0, import_common17.Controller)("threads"),
-  _ts_param15(1, (0, import_common17.Inject)(import_nestjs_agent_core18.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+ThreadsController = _ts_decorate19([
+  (0, import_common19.Controller)("threads"),
+  _ts_param17(1, (0, import_common19.Inject)(import_nestjs_agent_core20.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata18("design:type", Function),
+  _ts_metadata18("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ThreadsController);
 
 // src/controller/tool-call.controller.ts
-var import_nestjs_agent_core19 = require("@dudousxd/nestjs-agent-core");
-var import_common18 = require("@nestjs/common");
-function _ts_decorate18(decorators, target, key, desc) {
+var import_nestjs_agent_core21 = require("@dudousxd/nestjs-agent-core");
+var import_common20 = require("@nestjs/common");
+function _ts_decorate20(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -3143,19 +4091,19 @@ function _ts_decorate18(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate18, "_ts_decorate");
-function _ts_metadata17(metadataKey, metadataValue) {
+__name(_ts_decorate20, "_ts_decorate");
+function _ts_metadata19(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata17, "_ts_metadata");
-function _ts_param16(paramIndex, decorator) {
+__name(_ts_metadata19, "_ts_metadata");
+function _ts_param18(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param16, "_ts_param");
+__name(_ts_param18, "_ts_param");
 var MAX_ANSWERED_QUESTIONS = 100;
 var MAX_VALUES_PER_QUESTION = 100;
 var MAX_ANSWER_VALUE_LENGTH = 4096;
@@ -3164,7 +4112,7 @@ var MAX_VIA_LENGTH = 64;
 var DEFAULT_VIA = "web";
 function toolCallId(claimed) {
   if (typeof claimed !== "string" || claimed.length === 0) {
-    throw new import_common18.BadRequestException("toolCallId must be a non-empty string");
+    throw new import_common20.BadRequestException("toolCallId must be a non-empty string");
   }
   return claimed;
 }
@@ -3174,10 +4122,10 @@ function rejectReason(claimed) {
     return void 0;
   }
   if (typeof claimed !== "string") {
-    throw new import_common18.BadRequestException("reason must be a string");
+    throw new import_common20.BadRequestException("reason must be a string");
   }
   if (claimed.length > MAX_REJECT_REASON_LENGTH) {
-    throw new import_common18.BadRequestException(`reason must be at most ${MAX_REJECT_REASON_LENGTH} characters`);
+    throw new import_common20.BadRequestException(`reason must be at most ${MAX_REJECT_REASON_LENGTH} characters`);
   }
   return claimed;
 }
@@ -3187,7 +4135,7 @@ function remember(claimed) {
     return false;
   }
   if (typeof claimed !== "boolean") {
-    throw new import_common18.BadRequestException("remember must be a boolean");
+    throw new import_common20.BadRequestException("remember must be a boolean");
   }
   return claimed;
 }
@@ -3197,7 +4145,7 @@ function via(claimed) {
     return DEFAULT_VIA;
   }
   if (typeof claimed !== "string" || claimed.length === 0 || claimed.length > MAX_VIA_LENGTH) {
-    throw new import_common18.BadRequestException(`via must be a string of 1-${MAX_VIA_LENGTH} characters`);
+    throw new import_common20.BadRequestException(`via must be a string of 1-${MAX_VIA_LENGTH} characters`);
   }
   return claimed;
 }
@@ -3207,26 +4155,26 @@ function answers(claimed) {
     return void 0;
   }
   if (typeof claimed !== "object" || claimed === null || Array.isArray(claimed)) {
-    throw new import_common18.BadRequestException("answers must be an object of questionId \u2192 chosen values");
+    throw new import_common20.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_common18.BadRequestException(`answers may cover at most ${MAX_ANSWERED_QUESTIONS} questions`);
+    throw new import_common20.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_common18.BadRequestException(`answers["${questionId}"] must be an array of chosen values`);
+      throw new import_common20.BadRequestException(`answers["${questionId}"] must be an array of chosen values`);
     }
     if (values.length > MAX_VALUES_PER_QUESTION) {
-      throw new import_common18.BadRequestException(`answers["${questionId}"] may carry at most ${MAX_VALUES_PER_QUESTION} values`);
+      throw new import_common20.BadRequestException(`answers["${questionId}"] may carry at most ${MAX_VALUES_PER_QUESTION} values`);
     }
     for (const value of values) {
       if (typeof value !== "string") {
-        throw new import_common18.BadRequestException(`answers["${questionId}"] must contain only strings`);
+        throw new import_common20.BadRequestException(`answers["${questionId}"] must contain only strings`);
       }
       if (value.length > MAX_ANSWER_VALUE_LENGTH) {
-        throw new import_common18.BadRequestException(`answers["${questionId}"] values must be at most ${MAX_ANSWER_VALUE_LENGTH} characters`);
+        throw new import_common20.BadRequestException(`answers["${questionId}"] values must be at most ${MAX_ANSWER_VALUE_LENGTH} characters`);
       }
     }
     validated[questionId] = values;
@@ -3288,64 +4236,64 @@ var ToolCallController = class {
     };
   }
 };
-_ts_decorate18([
-  (0, import_common18.Post)("approve"),
-  _ts_param16(0, (0, import_common18.Req)()),
-  _ts_param16(1, (0, import_common18.Body)()),
-  _ts_metadata17("design:type", Function),
-  _ts_metadata17("design:paramtypes", [
+_ts_decorate20([
+  (0, import_common20.Post)("approve"),
+  _ts_param18(0, (0, import_common20.Req)()),
+  _ts_param18(1, (0, import_common20.Body)()),
+  _ts_metadata19("design:type", Function),
+  _ts_metadata19("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof ApproveBody === "undefined" ? Object : ApproveBody
   ]),
-  _ts_metadata17("design:returntype", Promise)
+  _ts_metadata19("design:returntype", Promise)
 ], ToolCallController.prototype, "approve", null);
-_ts_decorate18([
-  (0, import_common18.Post)("reject"),
-  _ts_param16(0, (0, import_common18.Req)()),
-  _ts_param16(1, (0, import_common18.Body)()),
-  _ts_metadata17("design:type", Function),
-  _ts_metadata17("design:paramtypes", [
+_ts_decorate20([
+  (0, import_common20.Post)("reject"),
+  _ts_param18(0, (0, import_common20.Req)()),
+  _ts_param18(1, (0, import_common20.Body)()),
+  _ts_metadata19("design:type", Function),
+  _ts_metadata19("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof RejectBody === "undefined" ? Object : RejectBody
   ]),
-  _ts_metadata17("design:returntype", Promise)
+  _ts_metadata19("design:returntype", Promise)
 ], ToolCallController.prototype, "reject", null);
-_ts_decorate18([
-  (0, import_common18.Post)("answer"),
-  _ts_param16(0, (0, import_common18.Req)()),
-  _ts_param16(1, (0, import_common18.Body)()),
-  _ts_metadata17("design:type", Function),
-  _ts_metadata17("design:paramtypes", [
+_ts_decorate20([
+  (0, import_common20.Post)("answer"),
+  _ts_param18(0, (0, import_common20.Req)()),
+  _ts_param18(1, (0, import_common20.Body)()),
+  _ts_metadata19("design:type", Function),
+  _ts_metadata19("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof AnswerBody === "undefined" ? Object : AnswerBody
   ]),
-  _ts_metadata17("design:returntype", Promise)
+  _ts_metadata19("design:returntype", Promise)
 ], ToolCallController.prototype, "answer", null);
-_ts_decorate18([
-  (0, import_common18.Post)("skip"),
-  _ts_param16(0, (0, import_common18.Req)()),
-  _ts_param16(1, (0, import_common18.Body)()),
-  _ts_metadata17("design:type", Function),
-  _ts_metadata17("design:paramtypes", [
+_ts_decorate20([
+  (0, import_common20.Post)("skip"),
+  _ts_param18(0, (0, import_common20.Req)()),
+  _ts_param18(1, (0, import_common20.Body)()),
+  _ts_metadata19("design:type", Function),
+  _ts_metadata19("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     Object
   ]),
-  _ts_metadata17("design:returntype", Promise)
+  _ts_metadata19("design:returntype", Promise)
 ], ToolCallController.prototype, "skip", null);
-ToolCallController = _ts_decorate18([
-  (0, import_common18.Controller)("tool-call"),
-  _ts_param16(1, (0, import_common18.Inject)(import_nestjs_agent_core19.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata17("design:type", Function),
-  _ts_metadata17("design:paramtypes", [
+ToolCallController = _ts_decorate20([
+  (0, import_common20.Controller)("tool-call"),
+  _ts_param18(1, (0, import_common20.Inject)(import_nestjs_agent_core21.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata19("design:type", Function),
+  _ts_metadata19("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ToolCallController);
 
 // src/controller/tools.controller.ts
-var import_nestjs_agent_core20 = require("@dudousxd/nestjs-agent-core");
-var import_common19 = require("@nestjs/common");
-function _ts_decorate19(decorators, target, key, desc) {
+var import_nestjs_agent_core22 = require("@dudousxd/nestjs-agent-core");
+var import_common21 = 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") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -3358,19 +4306,19 @@ function _ts_decorate19(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate19, "_ts_decorate");
-function _ts_metadata18(metadataKey, metadataValue) {
+__name(_ts_decorate21, "_ts_decorate");
+function _ts_metadata20(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata18, "_ts_metadata");
-function _ts_param17(paramIndex, decorator) {
+__name(_ts_metadata20, "_ts_metadata");
+function _ts_param19(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param17, "_ts_param");
+__name(_ts_param19, "_ts_param");
 var ToolsController = class {
   static {
     __name(this, "ToolsController");
@@ -3384,11 +4332,11 @@ var ToolsController = class {
     this.agents = agents;
   }
   async list(req, agent) {
-    if (agent !== void 0 && agent !== import_nestjs_agent_core20.ALL_AGENTS && this.agents.get(agent) === void 0) {
-      throw new import_common19.NotFoundException(`No agent named "${agent}"`);
+    if (agent !== void 0 && agent !== import_nestjs_agent_core22.ALL_AGENTS && this.agents.get(agent) === void 0) {
+      throw new import_common21.NotFoundException(`No agent named "${agent}"`);
     }
     const actor = await this.actorResolver.resolve(req);
-    const names = agent === import_nestjs_agent_core20.ALL_AGENTS ? [
+    const names = agent === import_nestjs_agent_core22.ALL_AGENTS ? [
       void 0,
       ...this.agents.list().map((definition) => definition.name)
     ] : [
@@ -3414,33 +4362,33 @@ var ToolsController = class {
     ];
   }
 };
-_ts_decorate19([
-  (0, import_common19.Get)(),
-  _ts_param17(0, (0, import_common19.Req)()),
-  _ts_param17(1, (0, import_common19.Query)("agent")),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+_ts_decorate21([
+  (0, import_common21.Get)(),
+  _ts_param19(0, (0, import_common21.Req)()),
+  _ts_param19(1, (0, import_common21.Query)("agent")),
+  _ts_metadata20("design:type", Function),
+  _ts_metadata20("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata18("design:returntype", Promise)
+  _ts_metadata20("design:returntype", Promise)
 ], ToolsController.prototype, "list", null);
-ToolsController = _ts_decorate19([
-  (0, import_common19.Controller)("tools"),
-  _ts_param17(0, (0, import_common19.Inject)(import_nestjs_agent_core20.AGENT_ACTOR_RESOLVER)),
-  _ts_param17(1, (0, import_common19.Inject)(import_nestjs_agent_core20.AGENT_DEPS_FACTORY)),
-  _ts_param17(2, (0, import_common19.Inject)(import_nestjs_agent_core20.AGENT_REGISTRY)),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+ToolsController = _ts_decorate21([
+  (0, import_common21.Controller)("tools"),
+  _ts_param19(0, (0, import_common21.Inject)(import_nestjs_agent_core22.AGENT_ACTOR_RESOLVER)),
+  _ts_param19(1, (0, import_common21.Inject)(import_nestjs_agent_core22.AGENT_DEPS_FACTORY)),
+  _ts_param19(2, (0, import_common21.Inject)(import_nestjs_agent_core22.AGENT_REGISTRY)),
+  _ts_metadata20("design:type", Function),
+  _ts_metadata20("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
-    typeof import_nestjs_agent_core20.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core20.AgentRegistry
+    typeof import_nestjs_agent_core22.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core22.AgentRegistry
   ])
 ], ToolsController);
 
 // src/discovery/agent-discovery.service.ts
-var import_nestjs_agent_core21 = require("@dudousxd/nestjs-agent-core");
-var import_common20 = require("@nestjs/common");
+var import_nestjs_agent_core23 = require("@dudousxd/nestjs-agent-core");
+var import_common22 = require("@nestjs/common");
 var import_core = require("@nestjs/core");
 
 // src/decorator/agent.decorator.ts
@@ -3457,7 +4405,7 @@ var SYSTEM_PROMPT_METADATA = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:
 var SYSTEM_PROMPT_CONTRIBUTOR_METADATA = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:system-prompt-contributor");
 
 // src/discovery/agent-discovery.service.ts
-function _ts_decorate20(decorators, target, key, desc) {
+function _ts_decorate22(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -3470,19 +4418,19 @@ function _ts_decorate20(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate20, "_ts_decorate");
-function _ts_metadata19(metadataKey, metadataValue) {
+__name(_ts_decorate22, "_ts_decorate");
+function _ts_metadata21(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata19, "_ts_metadata");
-function _ts_param18(paramIndex, decorator) {
+__name(_ts_metadata21, "_ts_metadata");
+function _ts_param20(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param18, "_ts_param");
+__name(_ts_param20, "_ts_param");
 var AgentDiscoveryService = class _AgentDiscoveryService {
   static {
     __name(this, "AgentDiscoveryService");
@@ -3491,7 +4439,7 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
   scanner;
   registry;
   contributors;
-  logger = new import_common20.Logger(_AgentDiscoveryService.name);
+  logger = new import_common22.Logger(_AgentDiscoveryService.name);
   constructor(discovery, scanner, registry, contributors) {
     this.discovery = discovery;
     this.scanner = scanner;
@@ -3609,22 +4557,22 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
     return (ctx) => candidate.call(instance, ctx);
   }
 };
-AgentDiscoveryService = _ts_decorate20([
-  (0, import_common20.Injectable)(),
-  _ts_param18(2, (0, import_common20.Inject)(import_nestjs_agent_core21.AGENT_REGISTRY)),
-  _ts_param18(3, (0, import_common20.Inject)(import_nestjs_agent_core21.AGENT_PROMPT_CONTRIBUTORS)),
-  _ts_metadata19("design:type", Function),
-  _ts_metadata19("design:paramtypes", [
+AgentDiscoveryService = _ts_decorate22([
+  (0, import_common22.Injectable)(),
+  _ts_param20(2, (0, import_common22.Inject)(import_nestjs_agent_core23.AGENT_REGISTRY)),
+  _ts_param20(3, (0, import_common22.Inject)(import_nestjs_agent_core23.AGENT_PROMPT_CONTRIBUTORS)),
+  _ts_metadata21("design:type", Function),
+  _ts_metadata21("design:paramtypes", [
     typeof import_core.DiscoveryService === "undefined" ? Object : import_core.DiscoveryService,
     typeof import_core.MetadataScanner === "undefined" ? Object : import_core.MetadataScanner,
-    typeof import_nestjs_agent_core21.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core21.AgentRegistry,
+    typeof import_nestjs_agent_core23.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core23.AgentRegistry,
     Array
   ])
 ], AgentDiscoveryService);
 
 // src/discovery/ai-tool-discovery.service.ts
-var import_nestjs_agent_core22 = require("@dudousxd/nestjs-agent-core");
-var import_common21 = require("@nestjs/common");
+var import_nestjs_agent_core24 = require("@dudousxd/nestjs-agent-core");
+var import_common23 = require("@nestjs/common");
 var import_core2 = require("@nestjs/core");
 var import_zod = require("zod");
 
@@ -3644,7 +4592,7 @@ function isBrandedFunctionalTool(value) {
 __name(isBrandedFunctionalTool, "isBrandedFunctionalTool");
 
 // src/discovery/ai-tool-discovery.service.ts
-function _ts_decorate21(decorators, target, key, desc) {
+function _ts_decorate23(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -3657,19 +4605,19 @@ function _ts_decorate21(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate21, "_ts_decorate");
-function _ts_metadata20(metadataKey, metadataValue) {
+__name(_ts_decorate23, "_ts_decorate");
+function _ts_metadata22(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata20, "_ts_metadata");
-function _ts_param19(paramIndex, decorator) {
+__name(_ts_metadata22, "_ts_metadata");
+function _ts_param21(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param19, "_ts_param");
+__name(_ts_param21, "_ts_param");
 var AiToolDiscoveryService = class _AiToolDiscoveryService {
   static {
     __name(this, "AiToolDiscoveryService");
@@ -3678,7 +4626,7 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
   registry;
   agents;
   options;
-  logger = new import_common21.Logger(_AiToolDiscoveryService.name);
+  logger = new import_common23.Logger(_AiToolDiscoveryService.name);
   constructor(discovery, registry, agents, options) {
     this.discovery = discovery;
     this.registry = registry;
@@ -3763,7 +4711,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_core22.normalizeDelegation)(edge);
+        const { agent: target, detached } = (0, import_nestjs_agent_core24.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.`);
@@ -3813,13 +4761,13 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
     return true;
   }
 };
-AiToolDiscoveryService = _ts_decorate21([
-  (0, import_common21.Injectable)(),
-  _ts_param19(1, (0, import_common21.Inject)(import_nestjs_agent_core22.AGENT_TOOL_REGISTRY)),
-  _ts_param19(2, (0, import_common21.Inject)(import_nestjs_agent_core22.AGENT_REGISTRY)),
-  _ts_param19(3, (0, import_common21.Inject)(import_nestjs_agent_core22.AGENT_OPTIONS)),
-  _ts_metadata20("design:type", Function),
-  _ts_metadata20("design:paramtypes", [
+AiToolDiscoveryService = _ts_decorate23([
+  (0, import_common23.Injectable)(),
+  _ts_param21(1, (0, import_common23.Inject)(import_nestjs_agent_core24.AGENT_TOOL_REGISTRY)),
+  _ts_param21(2, (0, import_common23.Inject)(import_nestjs_agent_core24.AGENT_REGISTRY)),
+  _ts_param21(3, (0, import_common23.Inject)(import_nestjs_agent_core24.AGENT_OPTIONS)),
+  _ts_metadata22("design:type", Function),
+  _ts_metadata22("design:paramtypes", [
     typeof import_core2.DiscoveryService === "undefined" ? Object : import_core2.DiscoveryService,
     typeof ToolRegistry === "undefined" ? Object : ToolRegistry,
     typeof AgentRegistry === "undefined" ? Object : AgentRegistry,
@@ -3828,25 +4776,25 @@ AiToolDiscoveryService = _ts_decorate21([
 ], AiToolDiscoveryService);
 
 // src/discovery/skill-discovery.service.ts
-var import_nestjs_agent_core24 = require("@dudousxd/nestjs-agent-core");
-var import_common22 = require("@nestjs/common");
+var import_nestjs_agent_core26 = require("@dudousxd/nestjs-agent-core");
+var import_common24 = 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_core23 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core25 = require("@dudousxd/nestjs-agent-core");
 var SKILL_METADATA = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:skill-metadata");
 function readSkillMetadata(target) {
   return Reflect.getMetadata(SKILL_METADATA, target);
 }
 __name(readSkillMetadata, "readSkillMetadata");
 function skillScope(options) {
-  return options.scope ?? import_nestjs_agent_core23.GLOBAL_SCOPE;
+  return options.scope ?? import_nestjs_agent_core25.GLOBAL_SCOPE;
 }
 __name(skillScope, "skillScope");
 
 // src/discovery/skill-discovery.service.ts
-function _ts_decorate22(decorators, target, key, desc) {
+function _ts_decorate24(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -3859,26 +4807,26 @@ function _ts_decorate22(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate22, "_ts_decorate");
-function _ts_metadata21(metadataKey, metadataValue) {
+__name(_ts_decorate24, "_ts_decorate");
+function _ts_metadata23(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata21, "_ts_metadata");
-function _ts_param20(paramIndex, decorator) {
+__name(_ts_metadata23, "_ts_metadata");
+function _ts_param22(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param20, "_ts_param");
+__name(_ts_param22, "_ts_param");
 var SkillDiscoveryService = class _SkillDiscoveryService {
   static {
     __name(this, "SkillDiscoveryService");
   }
   discovery;
   declared;
-  logger = new import_common22.Logger(_SkillDiscoveryService.name);
+  logger = new import_common24.Logger(_SkillDiscoveryService.name);
   constructor(discovery, declared) {
     this.discovery = discovery;
     this.declared = declared;
@@ -3915,18 +4863,18 @@ var SkillDiscoveryService = class _SkillDiscoveryService {
     return flat === void 0 ? void 0 : () => flat;
   }
 };
-SkillDiscoveryService = _ts_decorate22([
-  (0, import_common22.Injectable)(),
-  _ts_param20(1, (0, import_common22.Inject)(import_nestjs_agent_core24.AGENT_SKILL_SOURCES)),
-  _ts_metadata21("design:type", Function),
-  _ts_metadata21("design:paramtypes", [
+SkillDiscoveryService = _ts_decorate24([
+  (0, import_common24.Injectable)(),
+  _ts_param22(1, (0, import_common24.Inject)(import_nestjs_agent_core26.AGENT_SKILL_SOURCES)),
+  _ts_metadata23("design:type", Function),
+  _ts_metadata23("design:paramtypes", [
     typeof import_core3.DiscoveryService === "undefined" ? Object : import_core3.DiscoveryService,
     Array
   ])
 ], SkillDiscoveryService);
 
 // src/ledger-quota-provider.ts
-var import_nestjs_agent_core25 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core27 = require("@dudousxd/nestjs-agent-core");
 var LedgerQuotaProvider = class {
   static {
     __name(this, "LedgerQuotaProvider");
@@ -3946,12 +4894,12 @@ var LedgerQuotaProvider = class {
       await this.dayWindow(actorRef, now)
     ];
     if (this.store.usageBetween !== void 0) {
-      const range = (0, import_nestjs_agent_core25.quotaPeriodRange)("month", now);
+      const range = (0, import_nestjs_agent_core27.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_core25.exhaustedWindow)(windows);
-    const warning = (0, import_nestjs_agent_core25.quotaWarning)(windows);
+    const blocked = (0, import_nestjs_agent_core27.exhaustedWindow)(windows);
+    const warning = (0, import_nestjs_agent_core27.quotaWarning)(windows);
     return {
       windows,
       ...blocked !== void 0 ? {
@@ -3963,7 +4911,7 @@ var LedgerQuotaProvider = class {
     };
   }
   async dayWindow(actorRef, now) {
-    const range = (0, import_nestjs_agent_core25.quotaPeriodRange)("day", now);
+    const range = (0, import_nestjs_agent_core27.quotaPeriodRange)("day", now);
     const { usedTokens, costUsd } = await this.store.quotaToday(actorRef, range.fromDay);
     return this.window("day", usedTokens, costUsd, range.resetsAt);
   }
@@ -3988,9 +4936,9 @@ var LedgerQuotaProvider = class {
 };
 
 // src/runner/inline-agent-runner.ts
-var import_nestjs_agent_core26 = require("@dudousxd/nestjs-agent-core");
-var import_common23 = require("@nestjs/common");
-function _ts_decorate23(decorators, target, key, desc) {
+var import_nestjs_agent_core28 = require("@dudousxd/nestjs-agent-core");
+var import_common25 = require("@nestjs/common");
+function _ts_decorate25(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -4003,26 +4951,27 @@ function _ts_decorate23(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate23, "_ts_decorate");
-function _ts_metadata22(metadataKey, metadataValue) {
+__name(_ts_decorate25, "_ts_decorate");
+function _ts_metadata24(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata22, "_ts_metadata");
-function _ts_param21(paramIndex, decorator) {
+__name(_ts_metadata24, "_ts_metadata");
+function _ts_param23(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param21, "_ts_param");
+__name(_ts_param23, "_ts_param");
 var InlineAgentRunner = class _InlineAgentRunner {
   static {
     __name(this, "InlineAgentRunner");
   }
   factory;
   store;
-  logger = new import_common23.Logger(_InlineAgentRunner.name);
+  queue;
+  logger = new import_common25.Logger(_InlineAgentRunner.name);
   pending = /* @__PURE__ */ new Map();
   /**
   * Runs someone has asked to stop. In-process, like `pending`, and for the same reason: this runner
@@ -4030,14 +4979,25 @@ var InlineAgentRunner = class _InlineAgentRunner {
   * running it. A cancelled id is dropped once the run settles, so the set tracks live runs only.
   */
   cancelled = /* @__PURE__ */ new Set();
-  constructor(factory, store) {
+  /** Top-level runs this process is running now — what {@link isRunActive} answers from. */
+  live = /* @__PURE__ */ new Set();
+  constructor(factory, store, queue) {
     this.factory = factory;
     this.store = store;
+    this.queue = queue;
   }
-  async start(input) {
-    const runId = crypto.randomUUID();
+  /**
+  * In-process, so exact: a run this process is not running is not running anywhere — the process
+  * 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);
+  }
+  async start(input, options = {}) {
+    const runId = options.runId ?? crypto.randomUUID();
     const day = input.day ?? utcDay();
     const deps = this.factory.forAgent(input.agentName);
+    this.live.add(runId);
     const hooks = this.topLevelHooks({
       runId,
       deps,
@@ -4049,20 +5009,21 @@ var InlineAgentRunner = class _InlineAgentRunner {
         ...input.agentName !== void 0 ? [
           input.agentName
         ] : []
-      ]
+      ],
+      input
     });
-    void (0, import_nestjs_agent_core26.runAgentLoop)({
+    void (0, import_nestjs_agent_core28.runAgentLoop)({
       ...deps,
       day
-    }, input, hooks).then(() => this.store.setActiveStream(input.threadId, null)).catch(async (error) => {
-      if (error instanceof import_nestjs_agent_core26.RunCancelledError) {
-        await this.settleCancelled(runId, input.threadId, deps);
+    }, input, hooks).then(() => (0, import_nestjs_agent_core28.releaseThreadRun)(this.store, input.threadId, runId)).catch(async (error) => {
+      if (error instanceof import_nestjs_agent_core28.RunCancelledError) {
+        await this.settleCancelled(runId, input, deps);
         return;
       }
       const message = error instanceof Error ? error.message : String(error);
-      const code = (0, import_nestjs_agent_core26.agentFailureCode)(error);
+      const code = (0, import_nestjs_agent_core28.agentFailureCode)(error);
       this.logger.error(`agent run ${runId} failed (${code}): ${message}`);
-      (0, import_nestjs_agent_core26.publishAgentRunFailed)({
+      (0, import_nestjs_agent_core28.publishAgentRunFailed)({
         runId,
         code,
         message
@@ -4073,13 +5034,17 @@ var InlineAgentRunner = class _InlineAgentRunner {
         errorCode: code,
         errorMessage: message
       });
-      await this.store.setActiveStream(input.threadId, null);
       const writer = await deps.sink.open(runId);
+      await this.settleQueue(writer, input, runId, "failed", message);
+      await (0, import_nestjs_agent_core28.releaseThreadRun)(this.store, input.threadId, runId);
       await writer.fail({
         code,
         message
       });
-    }).finally(() => this.cancelled.delete(runId));
+    }).finally(() => {
+      this.cancelled.delete(runId);
+      this.live.delete(runId);
+    });
     return {
       runId
     };
@@ -4111,7 +5076,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_core26.RunCancelledError());
+        waiter.reject(new import_nestjs_agent_core28.RunCancelledError());
       }
     }
     await Promise.resolve();
@@ -4122,11 +5087,12 @@ var InlineAgentRunner = class _InlineAgentRunner {
   * the stream ENDED after a `cancelled` frame rather than failed, so a client that retries failed
   * streams does not retry this one.
   */
-  async settleCancelled(runId, threadId, deps) {
+  async settleCancelled(runId, input, deps) {
     this.logger.log(`agent run ${runId} cancelled`);
-    await this.store.setActiveStream(threadId, null);
     const writer = await deps.sink.open(runId);
-    await writer.write((0, import_nestjs_agent_core26.encodeStreamEvent)({
+    await this.settleQueue(writer, input, runId, "cancelled");
+    await (0, import_nestjs_agent_core28.releaseThreadRun)(this.store, input.threadId, runId);
+    await writer.write((0, import_nestjs_agent_core28.encodeStreamEvent)({
       kind: "cancelled"
     }));
     await writer.end();
@@ -4136,6 +5102,38 @@ var InlineAgentRunner = class _InlineAgentRunner {
     });
   }
   /**
+  * Move the thread past a settling TOP-LEVEL run — to the next queued message, which starts here,
+  * or to a paused/empty queue — and write the resulting `queue` frame into this run's stream. A
+  * no-op without a queue-capable store, and for a run that is not a thread's own turn.
+  *
+  * Never throws: the run is settling either way, and a queue that could not be advanced is picked
+  * up by the next send or resume on the thread.
+  */
+  async settleQueue(writer, input, runId, outcome, error) {
+    const queue = this.queue;
+    if (queue === void 0 || !queue.supported || !isThreadTurn2(input)) {
+      return;
+    }
+    const settled = outcome === "completed" && this.cancelled.has(runId) ? "cancelled" : outcome;
+    try {
+      const frame = await queue.handoff({
+        threadId: input.threadId,
+        runId,
+        outcome: settled,
+        ...error !== void 0 ? {
+          error
+        } : {}
+      }, (next, nextRunId) => this.start(next, {
+        runId: nextRunId
+      }));
+      if (frame !== void 0) {
+        await writer.write((0, import_nestjs_agent_core28.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)}`);
+    }
+  }
+  /**
   * Park a run on a human, keyed by run + tool call. One map for approvals and for question-set
   * answers alike: both wait on the same key, and `signal` cannot tell (or need to tell) which
   * shape it is delivering — the loop asked for one and only ever gets what the caller sent. A
@@ -4180,14 +5178,27 @@ var InlineAgentRunner = class _InlineAgentRunner {
     });
   }
   topLevelHooks(args) {
-    const { runId, deps, actor, day, threadId, chainBelow } = args;
+    const { runId, deps, actor, day, threadId, chainBelow, input } = args;
     return {
       runId,
-      openSink: /* @__PURE__ */ __name(() => deps.sink.open(runId), "openSink"),
+      // The loop ends the stream when the turn completes. Just before, the thread passes to the next
+      // queued message (or is released), and the reader is told which — so by the time a client
+      // sees the run end, the thread is already free or already running what it queued.
+      openSink: /* @__PURE__ */ __name(async () => {
+        const writer = await deps.sink.open(runId);
+        return this.queue === void 0 ? writer : {
+          write: /* @__PURE__ */ __name((chunk) => writer.write(chunk), "write"),
+          fail: /* @__PURE__ */ __name((error) => writer.fail(error), "fail"),
+          end: /* @__PURE__ */ __name(async () => {
+            await this.settleQueue(writer, input, runId, "completed");
+            await writer.end();
+          }, "end")
+        };
+      }, "openSink"),
       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_core26.settleAll,
+      parallel: import_nestjs_agent_core28.settleAll,
       cancelled: /* @__PURE__ */ __name(async () => this.cancelled.has(runId), "cancelled"),
       runAgent: /* @__PURE__ */ __name((agentName, task) => this.runNested({
         agentName,
@@ -4238,7 +5249,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_core26.settleAll,
+      parallel: import_nestjs_agent_core28.settleAll,
       cancelled: /* @__PURE__ */ __name(async () => this.cancelled.has(runId), "cancelled"),
       runAgent: /* @__PURE__ */ __name((childName, childTask) => this.runNested({
         agentName: childName,
@@ -4271,7 +5282,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
         }
       }), "startAgent")
     };
-    void (0, import_nestjs_agent_core26.runAgentLoop)({
+    void (0, import_nestjs_agent_core28.runAgentLoop)({
       ...deps,
       day
     }, {
@@ -4285,13 +5296,13 @@ var InlineAgentRunner = class _InlineAgentRunner {
       parentRunId,
       deliverTo
     }, hooks).catch(async (error) => {
-      const cancelled = error instanceof import_nestjs_agent_core26.RunCancelledError;
+      const cancelled = error instanceof import_nestjs_agent_core28.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_core26.publishAgentRunFailed)({
+        (0, import_nestjs_agent_core28.publishAgentRunFailed)({
           runId,
-          code: (0, import_nestjs_agent_core26.agentFailureCode)(error),
+          code: (0, import_nestjs_agent_core28.agentFailureCode)(error),
           message
         });
       }
@@ -4299,11 +5310,11 @@ var InlineAgentRunner = class _InlineAgentRunner {
         runId,
         status: cancelled ? "cancelled" : "failed",
         ...cancelled ? {} : {
-          errorCode: (0, import_nestjs_agent_core26.agentFailureCode)(error),
+          errorCode: (0, import_nestjs_agent_core28.agentFailureCode)(error),
           errorMessage: message
         }
       });
-      await (0, import_nestjs_agent_core26.settleUnsettledDelegation)({
+      await (0, import_nestjs_agent_core28.settleUnsettledDelegation)({
         store: this.store,
         delivery: deliverTo,
         agent: agentName,
@@ -4342,7 +5353,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_core26.settleAll,
+      parallel: import_nestjs_agent_core28.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"),
@@ -4377,7 +5388,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
       }), "startAgent")
     };
     try {
-      return await (0, import_nestjs_agent_core26.runAgentLoop)({
+      return await (0, import_nestjs_agent_core28.runAgentLoop)({
         ...deps,
         day
       }, {
@@ -4396,19 +5407,25 @@ var InlineAgentRunner = class _InlineAgentRunner {
     }
   }
 };
-InlineAgentRunner = _ts_decorate23([
-  (0, import_common23.Injectable)(),
-  _ts_param21(0, (0, import_common23.Inject)(import_nestjs_agent_core26.AGENT_DEPS_FACTORY)),
-  _ts_param21(1, (0, import_common23.Inject)(import_nestjs_agent_core26.AGENT_STORE)),
-  _ts_metadata22("design:type", Function),
-  _ts_metadata22("design:paramtypes", [
+InlineAgentRunner = _ts_decorate25([
+  (0, import_common25.Injectable)(),
+  _ts_param23(0, (0, import_common25.Inject)(import_nestjs_agent_core28.AGENT_DEPS_FACTORY)),
+  _ts_param23(1, (0, import_common25.Inject)(import_nestjs_agent_core28.AGENT_STORE)),
+  _ts_param23(2, (0, import_common25.Optional)()),
+  _ts_metadata24("design:type", Function),
+  _ts_metadata24("design:paramtypes", [
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
-    typeof AgentStore === "undefined" ? Object : AgentStore
+    typeof AgentStore === "undefined" ? Object : AgentStore,
+    typeof ChatQueueService === "undefined" ? Object : ChatQueueService
   ])
 ], InlineAgentRunner);
+function isThreadTurn2(input) {
+  return input.sinkRunId === void 0 && input.deliverTo === void 0;
+}
+__name(isThreadTurn2, "isThreadTurn");
 
 // src/skills-config.ts
-var import_nestjs_agent_core27 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core29 = require("@dudousxd/nestjs-agent-core");
 function declaredSkillProvider(declared) {
   return {
     list: /* @__PURE__ */ __name(({ scopes }) => declared.filter((skill) => scopes.includes(skill.scope)).map(({ name, description, scope }) => ({
@@ -4434,7 +5451,7 @@ function resolveSkillsConfig(options, declared) {
     declaredSkillProvider(declared)
   ];
   return {
-    provider: providers.length === 1 ? providers[0] : (0, import_nestjs_agent_core27.compositeSkillProvider)(providers),
+    provider: providers.length === 1 ? providers[0] : (0, import_nestjs_agent_core29.compositeSkillProvider)(providers),
     ...options.scopes !== void 0 ? {
       scopes: options.scopes
     } : {},
@@ -4446,7 +5463,7 @@ function resolveSkillsConfig(options, declared) {
 __name(resolveSkillsConfig, "resolveSkillsConfig");
 
 // src/agent.module.ts
-function _ts_decorate24(decorators, target, key, desc) {
+function _ts_decorate26(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -4459,13 +5476,13 @@ function _ts_decorate24(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate24, "_ts_decorate");
+__name(_ts_decorate26, "_ts_decorate");
 var DEFAULT_PATH = "agent";
-var logger = new import_common24.Logger("AgentModule");
+var logger = new import_common26.Logger("AgentModule");
 function externalStoreWrapper(modules) {
   for (const module2 of modules.values()) {
     if (module2.metatype === AgentModule) continue;
-    const wrapper = module2.providers.get(import_nestjs_agent_core28.AGENT_STORE);
+    const wrapper = module2.providers.get(import_nestjs_agent_core30.AGENT_STORE);
     if (wrapper !== void 0) return wrapper;
   }
   return void 0;
@@ -4496,7 +5513,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_core28.InMemoryAgentStore();
+  return new import_nestjs_agent_core30.InMemoryAgentStore();
 }
 __name(resolveStore, "resolveStore");
 function isQuotaProvider(quota) {
@@ -4512,99 +5529,99 @@ __name(resolveCatalog, "resolveCatalog");
 function sharedProviders(durable) {
   const providers = [
     {
-      provide: import_nestjs_agent_core28.AGENT_TOOL_REGISTRY,
-      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core28.ToolRegistry(), "useFactory")
+      provide: import_nestjs_agent_core30.AGENT_TOOL_REGISTRY,
+      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core30.ToolRegistry(), "useFactory")
     },
     // Starts empty; AgentDiscoveryService populates it from `@Agent`-decorated providers at boot.
     {
-      provide: import_nestjs_agent_core28.AGENT_REGISTRY,
-      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core28.AgentRegistry(), "useFactory")
+      provide: import_nestjs_agent_core30.AGENT_REGISTRY,
+      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core30.AgentRegistry(), "useFactory")
     },
     // A shared, mutable list AgentDiscoveryService fills with `@SystemPromptContributor()` methods.
     {
-      provide: import_nestjs_agent_core28.AGENT_PROMPT_CONTRIBUTORS,
+      provide: import_nestjs_agent_core30.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_core28.AGENT_SKILL_SOURCES,
+      provide: import_nestjs_agent_core30.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_core28.AGENT_SKILLS,
+      provide: import_nestjs_agent_core30.AGENT_SKILLS,
       useFactory: /* @__PURE__ */ __name((options, declared) => resolveSkillsConfig(options.skills, declared), "useFactory"),
       inject: [
-        import_nestjs_agent_core28.AGENT_OPTIONS,
-        import_nestjs_agent_core28.AGENT_SKILL_SOURCES
+        import_nestjs_agent_core30.AGENT_OPTIONS,
+        import_nestjs_agent_core30.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_core28.AGENT_MEMORY,
+      provide: import_nestjs_agent_core30.AGENT_MEMORY,
       useFactory: /* @__PURE__ */ __name((options) => options.memory, "useFactory"),
       inject: [
-        import_nestjs_agent_core28.AGENT_OPTIONS
+        import_nestjs_agent_core30.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core28.AGENT_SINK,
+      provide: import_nestjs_agent_core30.AGENT_SINK,
       useFactory: /* @__PURE__ */ __name((options) => options.sink ?? new InProcessTokenStreamSink(), "useFactory"),
       inject: [
-        import_nestjs_agent_core28.AGENT_OPTIONS
+        import_nestjs_agent_core30.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core28.AGENT_ROLES_POLICY,
-      useFactory: /* @__PURE__ */ __name((options) => options.rolesPolicy ?? new import_nestjs_agent_core28.DefaultRolesPolicy(options.defaultRoles), "useFactory"),
+      provide: import_nestjs_agent_core30.AGENT_ROLES_POLICY,
+      useFactory: /* @__PURE__ */ __name((options) => options.rolesPolicy ?? new import_nestjs_agent_core30.DefaultRolesPolicy(options.defaultRoles), "useFactory"),
       inject: [
-        import_nestjs_agent_core28.AGENT_OPTIONS
+        import_nestjs_agent_core30.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core28.AGENT_ACTOR_RESOLVER,
+      provide: import_nestjs_agent_core30.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_core28.AGENT_OPTIONS
+        import_nestjs_agent_core30.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core28.AGENT_MODEL,
+      provide: import_nestjs_agent_core30.AGENT_MODEL,
       useFactory: /* @__PURE__ */ __name((o) => o.model, "useFactory"),
       inject: [
-        import_nestjs_agent_core28.AGENT_OPTIONS
+        import_nestjs_agent_core30.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_core28.AGENT_QUOTA_PROVIDER,
+      provide: import_nestjs_agent_core30.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_core28.AGENT_OPTIONS,
-        import_nestjs_agent_core28.AGENT_STORE
+        import_nestjs_agent_core30.AGENT_OPTIONS,
+        import_nestjs_agent_core30.AGENT_STORE
       ]
     },
     {
-      provide: import_nestjs_agent_core28.AGENT_MODEL_CATALOG,
+      provide: import_nestjs_agent_core30.AGENT_MODEL_CATALOG,
       useFactory: /* @__PURE__ */ __name((o) => resolveCatalog(o), "useFactory"),
       inject: [
-        import_nestjs_agent_core28.AGENT_OPTIONS
+        import_nestjs_agent_core30.AGENT_OPTIONS
       ]
     },
     AgentDepsFactory2,
     {
-      provide: import_nestjs_agent_core28.AGENT_DEPS_FACTORY,
+      provide: import_nestjs_agent_core30.AGENT_DEPS_FACTORY,
       useExisting: AgentDepsFactory2
     },
     // Populates the registry + contributors (onModuleInit) BEFORE AiToolDiscoveryService synthesizes
@@ -4612,27 +5629,30 @@ function sharedProviders(durable) {
     AgentDiscoveryService,
     AiToolDiscoveryService,
     SkillDiscoveryService,
+    // The thread message queue — every surface, since both runners and the durable workflow settle
+    // into it, and the chat routes enqueue into it.
+    ChatQueueService,
     InlineAgentRunner,
     AgentService,
     // Bound ALWAYS (durable or inline) — the console's cross-thread approvals inbox routes decisions
     // through AgentService.signalToolCall, which reaches whichever AGENT_RUNNER is bound above.
     AgentApprovalPortAdapter,
     {
-      provide: import_nestjs_agent_core28.AGENT_APPROVAL_PORT,
+      provide: import_nestjs_agent_core30.AGENT_APPROVAL_PORT,
       useExisting: AgentApprovalPortAdapter
     }
   ];
   providers.push({
-    provide: import_nestjs_agent_core28.AGENT_STORE,
+    provide: import_nestjs_agent_core30.AGENT_STORE,
     useFactory: /* @__PURE__ */ __name((o, modules) => resolveStore(o, modules), "useFactory"),
     inject: [
-      import_nestjs_agent_core28.AGENT_OPTIONS,
+      import_nestjs_agent_core30.AGENT_OPTIONS,
       import_core4.ModulesContainer
     ]
   });
   if (durable) {
     providers.push({
-      provide: import_nestjs_agent_core28.AGENT_RUNNER,
+      provide: import_nestjs_agent_core30.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.");
@@ -4641,14 +5661,14 @@ function sharedProviders(durable) {
       }, "useFactory"),
       inject: [
         {
-          token: import_nestjs_agent_core28.AGENT_DURABLE_RUNNER,
+          token: import_nestjs_agent_core30.AGENT_DURABLE_RUNNER,
           optional: true
         }
       ]
     });
   } else {
     providers.push({
-      provide: import_nestjs_agent_core28.AGENT_RUNNER,
+      provide: import_nestjs_agent_core30.AGENT_RUNNER,
       useExisting: InlineAgentRunner
     });
   }
@@ -4657,29 +5677,31 @@ function sharedProviders(durable) {
 __name(sharedProviders, "sharedProviders");
 function exportsFor() {
   return [
-    import_nestjs_agent_core28.AGENT_OPTIONS,
-    import_nestjs_agent_core28.AGENT_TOOL_REGISTRY,
-    import_nestjs_agent_core28.AGENT_REGISTRY,
-    import_nestjs_agent_core28.AGENT_SINK,
-    import_nestjs_agent_core28.AGENT_ROLES_POLICY,
-    import_nestjs_agent_core28.AGENT_ACTOR_RESOLVER,
-    import_nestjs_agent_core28.AGENT_MODEL,
-    import_nestjs_agent_core28.AGENT_STORE,
-    import_nestjs_agent_core28.AGENT_MODEL_CATALOG,
-    import_nestjs_agent_core28.AGENT_QUOTA_PROVIDER,
-    import_nestjs_agent_core28.AGENT_PROMPT_CONTRIBUTORS,
-    import_nestjs_agent_core28.AGENT_SKILLS,
-    import_nestjs_agent_core28.AGENT_MEMORY,
-    import_nestjs_agent_core28.AGENT_DEPS_FACTORY,
+    import_nestjs_agent_core30.AGENT_OPTIONS,
+    import_nestjs_agent_core30.AGENT_TOOL_REGISTRY,
+    import_nestjs_agent_core30.AGENT_REGISTRY,
+    import_nestjs_agent_core30.AGENT_SINK,
+    import_nestjs_agent_core30.AGENT_ROLES_POLICY,
+    import_nestjs_agent_core30.AGENT_ACTOR_RESOLVER,
+    import_nestjs_agent_core30.AGENT_MODEL,
+    import_nestjs_agent_core30.AGENT_STORE,
+    import_nestjs_agent_core30.AGENT_MODEL_CATALOG,
+    import_nestjs_agent_core30.AGENT_QUOTA_PROVIDER,
+    import_nestjs_agent_core30.AGENT_PROMPT_CONTRIBUTORS,
+    import_nestjs_agent_core30.AGENT_SKILLS,
+    import_nestjs_agent_core30.AGENT_MEMORY,
+    import_nestjs_agent_core30.AGENT_DEPS_FACTORY,
     AgentDepsFactory2,
     AgentService,
+    ChatQueueService,
     InlineAgentRunner,
-    import_nestjs_agent_core28.AGENT_APPROVAL_PORT
+    import_nestjs_agent_core30.AGENT_APPROVAL_PORT
   ];
 }
 __name(exportsFor, "exportsFor");
 var BASE_CONTROLLERS = [
   ChatController,
+  QueueController,
   ThreadsController,
   ToolCallController,
   QuotaController,
@@ -4737,7 +5759,7 @@ var AgentModule = class _AgentModule {
       controllers: controllersForSurface(options.surface),
       providers: [
         {
-          provide: import_nestjs_agent_core28.AGENT_OPTIONS,
+          provide: import_nestjs_agent_core30.AGENT_OPTIONS,
           useValue: options
         },
         ...sharedProviders(options.durable ?? false),
@@ -4760,7 +5782,7 @@ var AgentModule = class _AgentModule {
       controllers: controllersForSurface(options.surface),
       providers: [
         {
-          provide: import_nestjs_agent_core28.AGENT_OPTIONS,
+          provide: import_nestjs_agent_core30.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
@@ -4781,9 +5803,9 @@ var AgentModule = class _AgentModule {
     };
   }
 };
-AgentModule = _ts_decorate24([
-  (0, import_common24.Global)(),
-  (0, import_common24.Module)({})
+AgentModule = _ts_decorate26([
+  (0, import_common26.Global)(),
+  (0, import_common26.Module)({})
 ], AgentModule);
 
 // src/durable/agent-durable.ts