@dudousxd/nestjs-agent 0.4.1 → 0.6.0

package/dist/durable/index.cjs

@@ -21,7 +21,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/durable/index.ts
 var durable_exports = {};
 __export(durable_exports, {
+  AGENT_DISPATCHED_STEPS: () => AGENT_DISPATCHED_STEPS,
   AgentDurableModule: () => AgentDurableModule,
+  AgentRunSteps: () => AgentRunSteps,
   AgentRunWorkflow: () => AgentRunWorkflow,
   DurableAgentRunner: () => DurableAgentRunner,
   agentDurable: () => agentDurable
@@ -29,10 +31,10 @@ __export(durable_exports, {
 module.exports = __toCommonJS(durable_exports);
 
 // src/durable/agent-run.workflow.ts
-var import_nestjs_agent_core = require("@dudousxd/nestjs-agent-core");
-var import_nestjs_durable = require("@dudousxd/nestjs-durable");
+var import_nestjs_agent_core2 = 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_common = require("@nestjs/common");
+var import_common2 = require("@nestjs/common");
 
 // src/agent-deps.ts
 function utcDay(date = /* @__PURE__ */ new Date()) {
@@ -50,7 +52,10 @@ function childSinkWriter(writer) {
 }
 __name(childSinkWriter, "childSinkWriter");
 
-// src/durable/agent-run.workflow.ts
+// src/durable/agent-run.steps.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;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -68,15 +73,107 @@ function _ts_param(paramIndex, decorator) {
   };
 }
 __name(_ts_param, "_ts_param");
+var AgentRunSteps = class {
+  static {
+    __name(this, "AgentRunSteps");
+  }
+  factory;
+  constructor(factory) {
+    this.factory = factory;
+  }
+  /**
+  * Retryable: every side effect (persist/quota/stream markers) happens loop-side under
+  * `hooks.step`, so a durable retry only re-runs the model call and re-streams its tokens — never
+  * double-writes. NEVER call `writer.end()`/`fail()` here: the workflow owns the stream's lifecycle,
+  * across however many turns/retries it takes.
+  */
+  async llm(input) {
+    const deps = this.factory.forAgent(input.agentName);
+    const tools = await deps.registry.definitionsFor(input.actor, deps.rolesPolicy, deps.toolAllowList);
+    const opened = await deps.sink.open(input.sinkRunId);
+    const writer = input.childSink ? childSinkWriter(opened) : opened;
+    return deps.model.runTurn({
+      system: input.system,
+      messages: input.messages,
+      tools,
+      sink: writer
+    });
+  }
+  /**
+  * No retries — a tool may not be idempotent (a bare `@Step()` carries none, unlike `llm` above).
+  * The timeout is applied HERE, handler-side, via `withToolTimeout` — never as a durable dispatch
+  * `timeoutMs`, which bounds engine liveness (retryable) rather than the tool's own business outcome.
+  */
+  async tool(input) {
+    const deps = this.factory.forAgent(input.ctx.agentName);
+    const ctx = {
+      ...input.ctx
+    };
+    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;
+  }
+};
+_ts_decorate([
+  (0, import_nestjs_durable.Step)({
+    retries: 3
+  }),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", [
+    typeof DispatchedLlmInput === "undefined" ? Object : DispatchedLlmInput
+  ]),
+  _ts_metadata("design:returntype", Promise)
+], AgentRunSteps.prototype, "llm", null);
+_ts_decorate([
+  (0, import_nestjs_durable.Step)(),
+  _ts_metadata("design:type", Function),
+  _ts_metadata("design:paramtypes", [
+    typeof ToolStepEnvelope === "undefined" ? Object : ToolStepEnvelope
+  ]),
+  _ts_metadata("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", [
+    typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory
+  ])
+], AgentRunSteps);
+
+// src/durable/dispatched-steps.token.ts
+var AGENT_DISPATCHED_STEPS = Symbol.for("@dudousxd/nestjs-agent:dispatched-steps");
+
+// src/durable/agent-run.workflow.ts
+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(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata2, "_ts_metadata");
+function _ts_param2(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param2, "_ts_param");
 var AgentRunWorkflow = class _AgentRunWorkflow {
   static {
     __name(this, "AgentRunWorkflow");
   }
   factory;
   store;
-  constructor(factory, store) {
+  steps;
+  dispatchedSteps;
+  constructor(factory, store, steps, dispatchedSteps) {
     this.factory = factory;
     this.store = store;
+    this.steps = steps;
+    this.dispatchedSteps = dispatchedSteps;
   }
   async run(ctx, input) {
     const day = input.day ?? utcDay();
@@ -91,6 +188,8 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
       openSink: /* @__PURE__ */ __name(async () => input.sinkRunId !== void 0 ? childSinkWriter(await deps.sink.open(sinkRunId)) : deps.sink.open(ctx.runId), "openSink"),
       awaitApproval: /* @__PURE__ */ __name((call) => ctx.waitForSignal(`tool:${ctx.runId}:${call.id}`), "awaitApproval"),
       step: /* @__PURE__ */ __name((name, fn) => ctx.localStep(name, fn), "step"),
+      // Dispatched-step suspends must escape the loop's tool catch — control flow, not a tool failure.
+      isControlFlowError: /* @__PURE__ */ __name((error) => error instanceof import_nestjs_durable_core.WorkflowSuspended || error instanceof import_nestjs_durable_core.ContinueAsNew, "isControlFlowError"),
       runAgent: /* @__PURE__ */ __name(async (agentName, task) => {
         const subThreadId = await ctx.localStep(`subthread:${agentName}`, async () => {
           const thread = await this.store.createThread({
@@ -108,10 +207,23 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
           delegationDepth: (input.delegationDepth ?? 0) + 1,
           sinkRunId
         });
-      }, "runAgent")
+      }, "runAgent"),
+      // Routes the two long steps through AgentRunSteps as engine-dispatched `ctx.step`s instead of
+      // `ctx.localStep`s, so a turn isn't pinned to this workflow worker for the model call or a tool
+      // execution. `sinkRunId`/`childSink` are sink routing this workflow already resolved above —
+      // core's dispatchLlm signature stays sink-topology-agnostic, so we add them here, not in core.
+      ...this.dispatchedSteps ? {
+        dispatchLlm: /* @__PURE__ */ __name((_index, envelope) => ctx.step(this.steps.llm, {
+          ...envelope,
+          runId: ctx.runId,
+          sinkRunId,
+          childSink: input.sinkRunId !== void 0
+        }), "dispatchLlm"),
+        dispatchTool: /* @__PURE__ */ __name((_call, envelope) => ctx.step(this.steps.tool, envelope), "dispatchTool")
+      } : {}
     };
     try {
-      const result = await (0, import_nestjs_agent_core.runAgentLoop)({
+      const result = await (0, import_nestjs_agent_core2.runAgentLoop)({
         ...deps,
         day
       }, input, hooks);
@@ -122,12 +234,18 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
         throw error;
       }
       const message = error instanceof Error ? error.message : String(error);
-      const code = error instanceof import_nestjs_agent_core.QuotaExceededError ? "quota_exceeded" : "run_failed";
-      (0, import_nestjs_agent_core.publishAgentRunFailed)({
+      const code = error instanceof import_nestjs_agent_core2.QuotaExceededError ? "quota_exceeded" : "run_failed";
+      (0, import_nestjs_agent_core2.publishAgentRunFailed)({
         runId: ctx.runId,
         code,
         message
       });
+      await ctx.localStep("persist:run:fail", () => this.store.recordRunEnd?.({
+        runId: ctx.runId,
+        status: "failed",
+        errorCode: code,
+        errorMessage: message
+      }) ?? Promise.resolve());
       await ctx.localStep("deactivate", () => this.store.setActiveStream(input.threadId, null));
       const writer = await hooks.openSink();
       await writer.fail({
@@ -138,37 +256,40 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
     }
   }
 };
-AgentRunWorkflow = _ts_decorate([
-  (0, import_common.Injectable)(),
-  (0, import_nestjs_durable.Workflow)({
+AgentRunWorkflow = _ts_decorate2([
+  (0, import_common2.Injectable)(),
+  (0, import_nestjs_durable2.Workflow)({
     name: "agent.run",
     version: "1"
   }),
-  _ts_param(0, (0, import_common.Inject)(import_nestjs_agent_core.AGENT_DEPS_FACTORY)),
-  _ts_param(1, (0, import_common.Inject)(import_nestjs_agent_core.AGENT_STORE)),
-  _ts_metadata("design:type", Function),
-  _ts_metadata("design:paramtypes", [
+  _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(3, (0, import_common2.Inject)(AGENT_DISPATCHED_STEPS)),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
-    typeof AgentStore === "undefined" ? Object : AgentStore
+    typeof AgentStore === "undefined" ? Object : AgentStore,
+    typeof AgentRunSteps === "undefined" ? Object : AgentRunSteps,
+    Boolean
   ])
 ], AgentRunWorkflow);
 
 // src/durable/durable-agent-runner.ts
 var import_node_crypto = require("crypto");
-var import_nestjs_durable2 = require("@dudousxd/nestjs-durable");
+var import_nestjs_durable3 = require("@dudousxd/nestjs-durable");
 var import_nestjs_durable_core2 = require("@dudousxd/nestjs-durable-core");
-var import_common2 = require("@nestjs/common");
-function _ts_decorate2(decorators, target, key, desc) {
+var import_common3 = require("@nestjs/common");
+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);
   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(k, v) {
+__name(_ts_decorate3, "_ts_decorate");
+function _ts_metadata3(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata2, "_ts_metadata");
+__name(_ts_metadata3, "_ts_metadata");
 var DurableAgentRunner = class {
   static {
     __name(this, "DurableAgentRunner");
@@ -201,24 +322,95 @@ var DurableAgentRunner = class {
     await Promise.resolve();
   }
 };
-DurableAgentRunner = _ts_decorate2([
-  (0, import_common2.Injectable)(),
-  _ts_metadata2("design:type", Function),
-  _ts_metadata2("design:paramtypes", [
-    typeof import_nestjs_durable2.WorkflowService === "undefined" ? Object : import_nestjs_durable2.WorkflowService
+DurableAgentRunner = _ts_decorate3([
+  (0, import_common3.Injectable)(),
+  _ts_metadata3("design:type", Function),
+  _ts_metadata3("design:paramtypes", [
+    typeof import_nestjs_durable3.WorkflowService === "undefined" ? Object : import_nestjs_durable3.WorkflowService
   ])
 ], DurableAgentRunner);
 
 // src/durable/agent-durable.module.ts
-var import_nestjs_agent_core2 = require("@dudousxd/nestjs-agent-core");
-var import_common3 = require("@nestjs/common");
-function _ts_decorate3(decorators, target, key, desc) {
+var import_nestjs_agent_core4 = require("@dudousxd/nestjs-agent-core");
+var import_common4 = require("@nestjs/common");
+
+// src/in-process-sink.ts
+var import_nestjs_agent_core3 = require("@dudousxd/nestjs-agent-core");
+var InProcessTokenStreamSink = class {
+  static {
+    __name(this, "InProcessTokenStreamSink");
+  }
+  runs = /* @__PURE__ */ new Map();
+  buffer(runId) {
+    let buf = this.runs.get(runId);
+    if (buf === void 0) {
+      buf = {
+        chunks: [],
+        ended: false,
+        notify: /* @__PURE__ */ new Set()
+      };
+      this.runs.set(runId, buf);
+    }
+    return buf;
+  }
+  wake(buf) {
+    for (const resolve of buf.notify) {
+      resolve();
+    }
+    buf.notify.clear();
+  }
+  open(runId) {
+    const buf = this.buffer(runId);
+    return {
+      write: /* @__PURE__ */ __name((chunk) => {
+        buf.chunks.push(chunk);
+        this.wake(buf);
+      }, "write"),
+      end: /* @__PURE__ */ __name(() => {
+        buf.ended = true;
+        this.wake(buf);
+      }, "end"),
+      fail: /* @__PURE__ */ __name((error) => {
+        buf.failure = error;
+        buf.ended = true;
+        this.wake(buf);
+      }, "fail")
+    };
+  }
+  async *subscribe(runId) {
+    const buf = this.buffer(runId);
+    let index = 0;
+    while (true) {
+      while (index < buf.chunks.length) {
+        const chunk = buf.chunks[index];
+        index += 1;
+        if (chunk !== void 0) {
+          yield chunk;
+        }
+      }
+      if (buf.ended) {
+        if (buf.failure !== void 0) {
+          throw new import_nestjs_agent_core3.AgentStreamError(buf.failure);
+        }
+        return;
+      }
+      await new Promise((resolve) => buf.notify.add(resolve));
+    }
+  }
+  close(runId) {
+    this.runs.delete(runId);
+  }
+};
+
+// src/durable/agent-durable.module.ts
+function _ts_decorate4(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate3, "_ts_decorate");
+__name(_ts_decorate4, "_ts_decorate");
+var logger = new import_common4.Logger("AgentDurableModule");
 var AgentDurableModule = class _AgentDurableModule {
   static {
     __name(this, "AgentDurableModule");
@@ -235,50 +427,67 @@ var AgentDurableModule = class _AgentDurableModule {
     };
   }
 };
-AgentDurableModule = _ts_decorate3([
-  (0, import_common3.Global)(),
-  (0, import_common3.Module)({
+AgentDurableModule = _ts_decorate4([
+  (0, import_common4.Global)(),
+  (0, import_common4.Module)({
     providers: [
       AgentRunWorkflow,
+      AgentRunSteps,
       DurableAgentRunner,
       {
-        provide: import_nestjs_agent_core2.AGENT_DURABLE_RUNNER,
+        provide: import_nestjs_agent_core4.AGENT_DURABLE_RUNNER,
         useExisting: DurableAgentRunner
+      },
+      {
+        provide: AGENT_DISPATCHED_STEPS,
+        useFactory: /* @__PURE__ */ __name((options, sink) => {
+          const enabled = options.durable === true && options.dispatchedSteps !== false;
+          if (enabled && sink instanceof InProcessTokenStreamSink) {
+            logger.warn("Dispatched steps are active (the default under durable: true) with the default InProcessTokenStreamSink, which only buffers tokens in-process. A dispatched `llm` step served by a different worker 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, or set dispatchedSteps: false to keep the turn in-process localSteps.");
+          }
+          return enabled;
+        }, "useFactory"),
+        inject: [
+          import_nestjs_agent_core4.AGENT_OPTIONS,
+          import_nestjs_agent_core4.AGENT_SINK
+        ]
       }
     ],
     exports: [
-      import_nestjs_agent_core2.AGENT_DURABLE_RUNNER,
-      AgentRunWorkflow
+      import_nestjs_agent_core4.AGENT_DURABLE_RUNNER,
+      AgentRunWorkflow,
+      AgentRunSteps,
+      AGENT_DISPATCHED_STEPS
     ]
   })
 ], AgentDurableModule);
 
 // src/agent.module.ts
-var import_nestjs_agent_core16 = require("@dudousxd/nestjs-agent-core");
-var import_common15 = require("@nestjs/common");
+var import_nestjs_agent_core17 = require("@dudousxd/nestjs-agent-core");
+var import_common17 = require("@nestjs/common");
 var import_core3 = require("@nestjs/core");
 
 // src/agent-deps.factory.ts
-var import_nestjs_agent_core3 = require("@dudousxd/nestjs-agent-core");
-var import_nestjs_agent_core4 = require("@dudousxd/nestjs-agent-core");
-var import_common4 = require("@nestjs/common");
-function _ts_decorate4(decorators, target, key, desc) {
+var import_nestjs_agent_core5 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core6 = require("@dudousxd/nestjs-agent-core");
+var import_common5 = require("@nestjs/common");
+function _ts_decorate5(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate4, "_ts_decorate");
-function _ts_metadata3(k, v) {
+__name(_ts_decorate5, "_ts_decorate");
+function _ts_metadata4(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata3, "_ts_metadata");
-function _ts_param2(paramIndex, decorator) {
+__name(_ts_metadata4, "_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");
 function delegateToolName(target) {
   return `ask_${target.replace(/[^a-zA-Z0-9]+/g, "_")}`;
 }
@@ -386,28 +595,28 @@ var AgentDepsFactory2 = class {
     return void 0;
   }
 };
-AgentDepsFactory2 = _ts_decorate4([
-  (0, import_common4.Injectable)(),
-  _ts_param2(0, (0, import_common4.Inject)(import_nestjs_agent_core4.AGENT_OPTIONS)),
-  _ts_param2(1, (0, import_common4.Inject)(import_nestjs_agent_core3.AGENT_MODEL)),
-  _ts_param2(2, (0, import_common4.Inject)(import_nestjs_agent_core3.AGENT_STORE)),
-  _ts_param2(3, (0, import_common4.Inject)(import_nestjs_agent_core3.AGENT_SINK)),
-  _ts_param2(4, (0, import_common4.Inject)(import_nestjs_agent_core3.AGENT_ROLES_POLICY)),
-  _ts_param2(5, (0, import_common4.Inject)(import_nestjs_agent_core3.AGENT_TOOL_REGISTRY)),
-  _ts_param2(6, (0, import_common4.Inject)(import_nestjs_agent_core3.AGENT_REGISTRY)),
-  _ts_param2(7, (0, import_common4.Inject)(import_nestjs_agent_core3.AGENT_PROMPT_CONTRIBUTORS)),
-  _ts_param2(8, (0, import_common4.Inject)(import_nestjs_agent_core3.AGENT_QUOTA_STORE)),
-  _ts_param2(9, (0, import_common4.Optional)()),
-  _ts_param2(9, (0, import_common4.Inject)(import_nestjs_agent_core3.AGENT_PRICING_STORE)),
-  _ts_metadata3("design:type", Function),
-  _ts_metadata3("design:paramtypes", [
+AgentDepsFactory2 = _ts_decorate5([
+  (0, import_common5.Injectable)(),
+  _ts_param3(0, (0, import_common5.Inject)(import_nestjs_agent_core6.AGENT_OPTIONS)),
+  _ts_param3(1, (0, import_common5.Inject)(import_nestjs_agent_core5.AGENT_MODEL)),
+  _ts_param3(2, (0, import_common5.Inject)(import_nestjs_agent_core5.AGENT_STORE)),
+  _ts_param3(3, (0, import_common5.Inject)(import_nestjs_agent_core5.AGENT_SINK)),
+  _ts_param3(4, (0, import_common5.Inject)(import_nestjs_agent_core5.AGENT_ROLES_POLICY)),
+  _ts_param3(5, (0, import_common5.Inject)(import_nestjs_agent_core5.AGENT_TOOL_REGISTRY)),
+  _ts_param3(6, (0, import_common5.Inject)(import_nestjs_agent_core5.AGENT_REGISTRY)),
+  _ts_param3(7, (0, import_common5.Inject)(import_nestjs_agent_core5.AGENT_PROMPT_CONTRIBUTORS)),
+  _ts_param3(8, (0, import_common5.Inject)(import_nestjs_agent_core5.AGENT_QUOTA_STORE)),
+  _ts_param3(9, (0, import_common5.Optional)()),
+  _ts_param3(9, (0, import_common5.Inject)(import_nestjs_agent_core5.AGENT_PRICING_STORE)),
+  _ts_metadata4("design:type", Function),
+  _ts_metadata4("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_core3.ToolRegistry === "undefined" ? Object : import_nestjs_agent_core3.ToolRegistry,
-    typeof import_nestjs_agent_core3.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core3.AgentRegistry,
+    typeof import_nestjs_agent_core5.ToolRegistry === "undefined" ? Object : import_nestjs_agent_core5.ToolRegistry,
+    typeof import_nestjs_agent_core5.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core5.AgentRegistry,
     Array,
     Object,
     Object
@@ -415,25 +624,25 @@ AgentDepsFactory2 = _ts_decorate4([
 ], AgentDepsFactory2);
 
 // src/agent.service.ts
-var import_nestjs_agent_core5 = require("@dudousxd/nestjs-agent-core");
-var import_common5 = require("@nestjs/common");
-function _ts_decorate5(decorators, target, key, desc) {
+var import_nestjs_agent_core7 = require("@dudousxd/nestjs-agent-core");
+var import_common6 = require("@nestjs/common");
+function _ts_decorate6(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate5, "_ts_decorate");
-function _ts_metadata4(k, v) {
+__name(_ts_decorate6, "_ts_decorate");
+function _ts_metadata5(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata4, "_ts_metadata");
-function _ts_param3(paramIndex, decorator) {
+__name(_ts_metadata5, "_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");
 var AgentService = class {
   static {
     __name(this, "AgentService");
@@ -453,7 +662,7 @@ var AgentService = class {
     let threadId = params.threadId;
     if (threadId === void 0) {
       if (params.regenerate === true) {
-        throw new import_common5.BadRequestException("regenerate requires an existing threadId");
+        throw new import_common6.BadRequestException("regenerate requires an existing threadId");
       }
       const created = await this.store.createThread({
         actor: params.actor,
@@ -492,20 +701,32 @@ var AgentService = class {
     return this.deps.forAgent().sink.subscribe(runId);
   }
   async approve(actor, toolCallId) {
-    const runId = await this.runForOwnedToolCall(actor, toolCallId);
-    return this.runner.signal(runId, toolCallId, {
+    await this.assertOwnsToolCall(actor, toolCallId);
+    return this.signalToolCall(toolCallId, {
       approved: true
     });
   }
   async reject(actor, toolCallId, reason) {
-    const runId = await this.runForOwnedToolCall(actor, toolCallId);
-    return this.runner.signal(runId, toolCallId, {
+    await this.assertOwnsToolCall(actor, toolCallId);
+    return this.signalToolCall(toolCallId, {
       approved: false,
       ...reason !== void 0 ? {
         reason
       } : {}
     });
   }
+  /**
+  * The decision core behind approve/reject, WITHOUT an ownership check: resolves the run
+  * currently awaiting `toolCallId` and signals it. `approve`/`reject` above call this after their
+  * own `assertOwnsToolCall` gate; the console `AgentApprovalPort` adapter (bound by `AgentModule`)
+  * calls it directly — a console caller is already authorized by the dashboard's own guards, and
+  * re-deriving thread ownership here would reject a legitimate operator decision (an operator is
+  * not the thread's own actor).
+  */
+  async signalToolCall(toolCallId, decision) {
+    const runId = await this.resolveRunForToolCall(toolCallId);
+    return this.runner.signal(runId, toolCallId, decision);
+  }
   async cancel(actor, runId) {
     await this.assertOwnsActiveStream(actor, runId);
     return this.runner.cancel(runId);
@@ -549,7 +770,7 @@ var AgentService = class {
       return;
     }
     if (this.store.updateThread === void 0) {
-      throw new import_common5.NotImplementedException("Setting a thread's defaultAgent requires an AgentStore that implements updateThread(); the bound store does not support it.");
+      throw new import_common6.NotImplementedException("Setting a thread's defaultAgent requires an AgentStore that implements updateThread(); the bound store does not support it.");
     }
     await this.store.updateThread(threadId, {
       ...title !== void 0 ? {
@@ -561,10 +782,10 @@ var AgentService = class {
   validateTitle(title) {
     const trimmed = title.trim();
     if (trimmed.length === 0) {
-      throw new import_common5.BadRequestException("title must not be empty");
+      throw new import_common6.BadRequestException("title must not be empty");
     }
     if (trimmed.length > 200) {
-      throw new import_common5.BadRequestException("title must be at most 200 characters");
+      throw new import_common6.BadRequestException("title must be at most 200 characters");
     }
     return trimmed;
   }
@@ -646,29 +867,35 @@ var AgentService = class {
   async assertOwnsThread(actor, threadId) {
     const owner = await this.store.ownerOfThread(threadId);
     if (owner === null) {
-      throw new import_common5.NotFoundException(`thread ${threadId} not found`);
+      throw new import_common6.NotFoundException(`thread ${threadId} not found`);
     }
     if (owner !== actor.id) {
-      throw new import_common5.ForbiddenException("thread belongs to another actor");
+      throw new import_common6.ForbiddenException("thread belongs to another actor");
     }
   }
   /**
-  * Authorization + routing seam for HITL approve/reject: assert the caller owns the tool call's
-  * thread, then resolve the run currently awaiting that call (its thread's active stream). That run
-  * is the sub-agent's own child run when the pending call belongs to a delegated agent — the client
-  * never knows or supplies a runId; it is derived here from the tool call alone.
+  * Authorization seam for HITL approve/reject: the caller must own the tool call's thread. Split
+  * out from run resolution (see {@link resolveRunForToolCall}) so the console `AgentApprovalPort`
+  * adapter can resolve+signal a decision WITHOUT this check — it is authorized upstream instead.
   */
-  async runForOwnedToolCall(actor, toolCallId) {
+  async assertOwnsToolCall(actor, toolCallId) {
     const owner = await this.store.ownerOfToolCall(toolCallId);
     if (owner === null) {
-      throw new import_common5.NotFoundException(`tool call ${toolCallId} not found`);
+      throw new import_common6.NotFoundException(`tool call ${toolCallId} not found`);
     }
     if (owner !== actor.id) {
-      throw new import_common5.ForbiddenException("tool call belongs to another actor");
+      throw new import_common6.ForbiddenException("tool call belongs to another actor");
     }
+  }
+  /**
+  * Resolve the run currently awaiting `toolCallId` (its thread's active stream). That run is the
+  * sub-agent's own child run when the pending call belongs to a delegated agent — the client never
+  * knows or supplies a runId; it is derived here from the tool call alone.
+  */
+  async resolveRunForToolCall(toolCallId) {
     const runId = await this.store.runForToolCall(toolCallId);
     if (runId === null) {
-      throw new import_common5.NotFoundException(`tool call ${toolCallId} has no active run to signal`);
+      throw new import_common6.NotFoundException(`tool call ${toolCallId} has no active run to signal`);
     }
     return runId;
   }
@@ -676,21 +903,21 @@ var AgentService = class {
   async assertOwnsActiveStream(actor, runId) {
     const owner = await this.store.ownerOfActiveStream(runId);
     if (owner === null) {
-      throw new import_common5.NotFoundException(`no active run ${runId}`);
+      throw new import_common6.NotFoundException(`no active run ${runId}`);
     }
     if (owner !== actor.id) {
-      throw new import_common5.ForbiddenException("run belongs to another actor");
+      throw new import_common6.ForbiddenException("run belongs to another actor");
     }
   }
 };
-AgentService = _ts_decorate5([
-  (0, import_common5.Injectable)(),
-  _ts_param3(0, (0, import_common5.Inject)(import_nestjs_agent_core5.AGENT_RUNNER)),
-  _ts_param3(1, (0, import_common5.Inject)(import_nestjs_agent_core5.AGENT_STORE)),
-  _ts_param3(2, (0, import_common5.Inject)(import_nestjs_agent_core5.AGENT_DEPS_FACTORY)),
-  _ts_param3(3, (0, import_common5.Inject)(import_nestjs_agent_core5.AGENT_QUOTA_STORE)),
-  _ts_metadata4("design:type", Function),
-  _ts_metadata4("design:paramtypes", [
+AgentService = _ts_decorate6([
+  (0, import_common6.Injectable)(),
+  _ts_param4(0, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_RUNNER)),
+  _ts_param4(1, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_STORE)),
+  _ts_param4(2, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_DEPS_FACTORY)),
+  _ts_param4(3, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_QUOTA_STORE)),
+  _ts_metadata5("design:type", Function),
+  _ts_metadata5("design:paramtypes", [
     typeof AgentRunner === "undefined" ? Object : AgentRunner,
     typeof AgentStore === "undefined" ? Object : AgentStore,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
@@ -698,26 +925,75 @@ AgentService = _ts_decorate5([
   ])
 ], AgentService);
 
+// src/approval-port.adapter.ts
+var import_common7 = require("@nestjs/common");
+function _ts_decorate7(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate7, "_ts_decorate");
+function _ts_metadata6(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata6, "_ts_metadata");
+var AgentApprovalPortAdapter = class {
+  static {
+    __name(this, "AgentApprovalPortAdapter");
+  }
+  agent;
+  constructor(agent) {
+    this.agent = agent;
+  }
+  async approve(toolCallId, opts) {
+    await this.agent.signalToolCall(toolCallId, {
+      approved: true,
+      ...opts?.executedByRef !== void 0 ? {
+        executedByRef: opts.executedByRef
+      } : {}
+    });
+  }
+  async reject(toolCallId, opts) {
+    await this.agent.signalToolCall(toolCallId, {
+      approved: false,
+      ...opts?.executedByRef !== void 0 ? {
+        executedByRef: opts.executedByRef
+      } : {},
+      ...opts?.reason !== void 0 ? {
+        reason: opts.reason
+      } : {}
+    });
+  }
+};
+AgentApprovalPortAdapter = _ts_decorate7([
+  (0, import_common7.Injectable)(),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("design:paramtypes", [
+    typeof AgentService === "undefined" ? Object : AgentService
+  ])
+], AgentApprovalPortAdapter);
+
 // src/controller/agents.controller.ts
-var import_nestjs_agent_core6 = require("@dudousxd/nestjs-agent-core");
-var import_common6 = require("@nestjs/common");
-function _ts_decorate6(decorators, target, key, desc) {
+var import_nestjs_agent_core8 = require("@dudousxd/nestjs-agent-core");
+var import_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);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate6, "_ts_decorate");
-function _ts_metadata5(k, v) {
+__name(_ts_decorate8, "_ts_decorate");
+function _ts_metadata7(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata5, "_ts_metadata");
-function _ts_param4(paramIndex, decorator) {
+__name(_ts_metadata7, "_ts_metadata");
+function _ts_param5(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param4, "_ts_param");
+__name(_ts_param5, "_ts_param");
 var AgentsController = class {
   static {
     __name(this, "AgentsController");
@@ -739,44 +1015,44 @@ var AgentsController = class {
     }));
   }
 };
-_ts_decorate6([
-  (0, import_common6.Get)(),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", []),
-  _ts_metadata5("design:returntype", Array)
+_ts_decorate8([
+  (0, import_common8.Get)(),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", []),
+  _ts_metadata7("design:returntype", Array)
 ], AgentsController.prototype, "list", null);
-AgentsController = _ts_decorate6([
-  (0, import_common6.Controller)("agents"),
-  _ts_param4(0, (0, import_common6.Inject)(import_nestjs_agent_core6.AGENT_REGISTRY)),
-  _ts_param4(1, (0, import_common6.Inject)(import_nestjs_agent_core6.AGENT_DEPS_FACTORY)),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
-    typeof import_nestjs_agent_core6.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core6.AgentRegistry,
+AgentsController = _ts_decorate8([
+  (0, import_common8.Controller)("agents"),
+  _ts_param5(0, (0, import_common8.Inject)(import_nestjs_agent_core8.AGENT_REGISTRY)),
+  _ts_param5(1, (0, import_common8.Inject)(import_nestjs_agent_core8.AGENT_DEPS_FACTORY)),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", [
+    typeof import_nestjs_agent_core8.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core8.AgentRegistry,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory
   ])
 ], AgentsController);
 
 // src/controller/attachments.controller.ts
-var import_nestjs_agent_core7 = require("@dudousxd/nestjs-agent-core");
-var import_common7 = require("@nestjs/common");
+var import_nestjs_agent_core9 = require("@dudousxd/nestjs-agent-core");
+var import_common9 = require("@nestjs/common");
 var import_platform_express = require("@nestjs/platform-express");
-function _ts_decorate7(decorators, target, key, desc) {
+function _ts_decorate9(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate7, "_ts_decorate");
-function _ts_metadata6(k, v) {
+__name(_ts_decorate9, "_ts_decorate");
+function _ts_metadata8(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata6, "_ts_metadata");
-function _ts_param5(paramIndex, decorator) {
+__name(_ts_metadata8, "_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 DEFAULT_MAX_ATTACHMENT_BYTES = 20 * 1024 * 1024;
 var DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES = [
   "image/png",
@@ -812,18 +1088,18 @@ var AttachmentsController = class {
   }
   async upload(req, file) {
     if (this.staging === void 0) {
-      throw new import_common7.NotImplementedException("Attachment upload is not configured on this server.");
+      throw new import_common9.NotImplementedException("Attachment upload is not configured on this server.");
     }
     if (file === void 0) {
-      throw new import_common7.BadRequestException('multipart field "file" is required');
+      throw new import_common9.BadRequestException('multipart field "file" is required');
     }
     const allowedContentTypes = this.options.attachments?.allowedContentTypes ?? DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES;
     if (!allowedContentTypes.includes(file.mimetype)) {
-      throw new import_common7.UnsupportedMediaTypeException(`content type "${file.mimetype}" is not allowed (allowed: ${allowedContentTypes.join(", ")})`);
+      throw new import_common9.UnsupportedMediaTypeException(`content type "${file.mimetype}" is not allowed (allowed: ${allowedContentTypes.join(", ")})`);
     }
     const maxBytes = this.options.attachments?.maxBytes ?? DEFAULT_MAX_ATTACHMENT_BYTES;
     if (file.size > maxBytes) {
-      throw new import_common7.PayloadTooLargeException(`file exceeds the ${maxBytes}-byte limit`);
+      throw new import_common9.PayloadTooLargeException(`file exceeds the ${maxBytes}-byte limit`);
     }
     const actor = await this.actorResolver.resolve(req);
     return this.staging.stage({
@@ -835,26 +1111,26 @@ var AttachmentsController = class {
     });
   }
 };
-_ts_decorate7([
-  (0, import_common7.Post)(),
-  (0, import_common7.UseInterceptors)((0, import_platform_express.FileInterceptor)("file")),
-  _ts_param5(0, (0, import_common7.Req)()),
-  _ts_param5(1, (0, import_common7.UploadedFile)()),
-  _ts_metadata6("design:type", Function),
-  _ts_metadata6("design:paramtypes", [
+_ts_decorate9([
+  (0, import_common9.Post)(),
+  (0, import_common9.UseInterceptors)((0, import_platform_express.FileInterceptor)("file")),
+  _ts_param6(0, (0, import_common9.Req)()),
+  _ts_param6(1, (0, import_common9.UploadedFile)()),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     Object
   ]),
-  _ts_metadata6("design:returntype", Promise)
+  _ts_metadata8("design:returntype", Promise)
 ], AttachmentsController.prototype, "upload", null);
-AttachmentsController = _ts_decorate7([
-  (0, import_common7.Controller)("attachments"),
-  _ts_param5(0, (0, import_common7.Inject)(import_nestjs_agent_core7.AGENT_OPTIONS)),
-  _ts_param5(1, (0, import_common7.Inject)(import_nestjs_agent_core7.AGENT_ACTOR_RESOLVER)),
-  _ts_param5(2, (0, import_common7.Optional)()),
-  _ts_param5(2, (0, import_common7.Inject)(import_nestjs_agent_core7.AGENT_ATTACHMENT_STAGING)),
-  _ts_metadata6("design:type", Function),
-  _ts_metadata6("design:paramtypes", [
+AttachmentsController = _ts_decorate9([
+  (0, import_common9.Controller)("attachments"),
+  _ts_param6(0, (0, import_common9.Inject)(import_nestjs_agent_core9.AGENT_OPTIONS)),
+  _ts_param6(1, (0, import_common9.Inject)(import_nestjs_agent_core9.AGENT_ACTOR_RESOLVER)),
+  _ts_param6(2, (0, import_common9.Optional)()),
+  _ts_param6(2, (0, import_common9.Inject)(import_nestjs_agent_core9.AGENT_ATTACHMENT_STAGING)),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     Object
@@ -862,25 +1138,25 @@ AttachmentsController = _ts_decorate7([
 ], AttachmentsController);
 
 // src/controller/chat.controller.ts
-var import_nestjs_agent_core8 = require("@dudousxd/nestjs-agent-core");
-var import_common8 = require("@nestjs/common");
-function _ts_decorate8(decorators, target, key, desc) {
+var import_nestjs_agent_core10 = require("@dudousxd/nestjs-agent-core");
+var import_common10 = require("@nestjs/common");
+function _ts_decorate10(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate8, "_ts_decorate");
-function _ts_metadata7(k, v) {
+__name(_ts_decorate10, "_ts_decorate");
+function _ts_metadata9(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata7, "_ts_metadata");
-function _ts_param6(paramIndex, decorator) {
+__name(_ts_metadata9, "_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 ChatController = class {
   static {
     __name(this, "ChatController");
@@ -968,7 +1244,7 @@ data: ${JSON.stringify({
       }
       res.write("event: done\ndata: {}\n\n");
     } catch (error) {
-      const payload = error instanceof import_nestjs_agent_core8.AgentStreamError ? {
+      const payload = error instanceof import_nestjs_agent_core10.AgentStreamError ? {
         code: error.code,
         message: error.message
       } : {
@@ -983,71 +1259,71 @@ data: ${JSON.stringify(payload)}
     res.end();
   }
 };
-_ts_decorate8([
-  (0, import_common8.Post)("chat"),
-  _ts_param6(0, (0, import_common8.Req)()),
-  _ts_param6(1, (0, import_common8.Res)()),
-  _ts_param6(2, (0, import_common8.Body)()),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
+_ts_decorate10([
+  (0, import_common10.Post)("chat"),
+  _ts_param7(0, (0, import_common10.Req)()),
+  _ts_param7(1, (0, import_common10.Res)()),
+  _ts_param7(2, (0, import_common10.Body)()),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof Response === "undefined" ? Object : Response,
     typeof ChatBody === "undefined" ? Object : ChatBody
   ]),
-  _ts_metadata7("design:returntype", Promise)
+  _ts_metadata9("design:returntype", Promise)
 ], ChatController.prototype, "chat", null);
-_ts_decorate8([
-  (0, import_common8.Get)("chat/:runId/stream"),
-  _ts_param6(0, (0, import_common8.Param)("runId")),
-  _ts_param6(1, (0, import_common8.Res)()),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
+_ts_decorate10([
+  (0, import_common10.Get)("chat/:runId/stream"),
+  _ts_param7(0, (0, import_common10.Param)("runId")),
+  _ts_param7(1, (0, import_common10.Res)()),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", [
     String,
     typeof Response === "undefined" ? Object : Response
   ]),
-  _ts_metadata7("design:returntype", Promise)
+  _ts_metadata9("design:returntype", Promise)
 ], ChatController.prototype, "stream", null);
-_ts_decorate8([
-  (0, import_common8.Post)("chat/:runId/cancel"),
-  _ts_param6(0, (0, import_common8.Req)()),
-  _ts_param6(1, (0, import_common8.Param)("runId")),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
+_ts_decorate10([
+  (0, import_common10.Post)("chat/:runId/cancel"),
+  _ts_param7(0, (0, import_common10.Req)()),
+  _ts_param7(1, (0, import_common10.Param)("runId")),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata7("design:returntype", Promise)
+  _ts_metadata9("design:returntype", Promise)
 ], ChatController.prototype, "cancel", null);
-ChatController = _ts_decorate8([
-  (0, import_common8.Controller)(),
-  _ts_param6(1, (0, import_common8.Inject)(import_nestjs_agent_core8.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
+ChatController = _ts_decorate10([
+  (0, import_common10.Controller)(),
+  _ts_param7(1, (0, import_common10.Inject)(import_nestjs_agent_core10.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ChatController);
 
 // src/controller/quota.controller.ts
-var import_nestjs_agent_core9 = require("@dudousxd/nestjs-agent-core");
-var import_common9 = require("@nestjs/common");
-function _ts_decorate9(decorators, target, key, desc) {
+var import_nestjs_agent_core11 = require("@dudousxd/nestjs-agent-core");
+var import_common11 = require("@nestjs/common");
+function _ts_decorate11(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate9, "_ts_decorate");
-function _ts_metadata8(k, v) {
+__name(_ts_decorate11, "_ts_decorate");
+function _ts_metadata10(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata8, "_ts_metadata");
-function _ts_param7(paramIndex, decorator) {
+__name(_ts_metadata10, "_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 QuotaController = class {
   static {
     __name(this, "QuotaController");
@@ -1063,45 +1339,45 @@ var QuotaController = class {
     return this.agent.quotaToday(actor.id);
   }
 };
-_ts_decorate9([
-  (0, import_common9.Get)("today"),
-  _ts_param7(0, (0, import_common9.Req)()),
-  _ts_metadata8("design:type", Function),
-  _ts_metadata8("design:paramtypes", [
+_ts_decorate11([
+  (0, import_common11.Get)("today"),
+  _ts_param8(0, (0, import_common11.Req)()),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata8("design:returntype", Promise)
+  _ts_metadata10("design:returntype", Promise)
 ], QuotaController.prototype, "today", null);
-QuotaController = _ts_decorate9([
-  (0, import_common9.Controller)("quota"),
-  _ts_param7(1, (0, import_common9.Inject)(import_nestjs_agent_core9.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata8("design:type", Function),
-  _ts_metadata8("design:paramtypes", [
+QuotaController = _ts_decorate11([
+  (0, import_common11.Controller)("quota"),
+  _ts_param8(1, (0, import_common11.Inject)(import_nestjs_agent_core11.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], QuotaController);
 
 // src/controller/threads.controller.ts
-var import_nestjs_agent_core10 = require("@dudousxd/nestjs-agent-core");
-var import_common10 = require("@nestjs/common");
-function _ts_decorate10(decorators, target, key, desc) {
+var import_nestjs_agent_core12 = require("@dudousxd/nestjs-agent-core");
+var import_common12 = require("@nestjs/common");
+function _ts_decorate12(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate10, "_ts_decorate");
-function _ts_metadata9(k, v) {
+__name(_ts_decorate12, "_ts_decorate");
+function _ts_metadata11(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata9, "_ts_metadata");
-function _ts_param8(paramIndex, decorator) {
+__name(_ts_metadata11, "_ts_metadata");
+function _ts_param9(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param8, "_ts_param");
+__name(_ts_param9, "_ts_param");
 var ThreadsController = class {
   static {
     __name(this, "ThreadsController");
@@ -1165,117 +1441,117 @@ var ThreadsController = class {
     };
   }
 };
-_ts_decorate10([
-  (0, import_common10.Get)(),
-  _ts_param8(0, (0, import_common10.Req)()),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+_ts_decorate12([
+  (0, import_common12.Get)(),
+  _ts_param9(0, (0, import_common12.Req)()),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata9("design:returntype", Promise)
+  _ts_metadata11("design:returntype", Promise)
 ], ThreadsController.prototype, "list", null);
-_ts_decorate10([
-  (0, import_common10.Get)(":id"),
-  _ts_param8(0, (0, import_common10.Req)()),
-  _ts_param8(1, (0, import_common10.Param)("id")),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+_ts_decorate12([
+  (0, import_common12.Get)(":id"),
+  _ts_param9(0, (0, import_common12.Req)()),
+  _ts_param9(1, (0, import_common12.Param)("id")),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata9("design:returntype", Promise)
+  _ts_metadata11("design:returntype", Promise)
 ], ThreadsController.prototype, "detail", null);
-_ts_decorate10([
-  (0, import_common10.Delete)(":id"),
-  _ts_param8(0, (0, import_common10.Req)()),
-  _ts_param8(1, (0, import_common10.Param)("id")),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+_ts_decorate12([
+  (0, import_common12.Delete)(":id"),
+  _ts_param9(0, (0, import_common12.Req)()),
+  _ts_param9(1, (0, import_common12.Param)("id")),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata9("design:returntype", Promise)
+  _ts_metadata11("design:returntype", Promise)
 ], ThreadsController.prototype, "remove", null);
-_ts_decorate10([
-  (0, import_common10.Post)(":id/fork-from/:messageId"),
-  _ts_param8(0, (0, import_common10.Req)()),
-  _ts_param8(1, (0, import_common10.Param)("id")),
-  _ts_param8(2, (0, import_common10.Param)("messageId")),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+_ts_decorate12([
+  (0, import_common12.Post)(":id/fork-from/:messageId"),
+  _ts_param9(0, (0, import_common12.Req)()),
+  _ts_param9(1, (0, import_common12.Param)("id")),
+  _ts_param9(2, (0, import_common12.Param)("messageId")),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     String
   ]),
-  _ts_metadata9("design:returntype", Promise)
+  _ts_metadata11("design:returntype", Promise)
 ], ThreadsController.prototype, "fork", null);
-_ts_decorate10([
-  (0, import_common10.Patch)(":id"),
-  _ts_param8(0, (0, import_common10.Req)()),
-  _ts_param8(1, (0, import_common10.Param)("id")),
-  _ts_param8(2, (0, import_common10.Body)()),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+_ts_decorate12([
+  (0, import_common12.Patch)(":id"),
+  _ts_param9(0, (0, import_common12.Req)()),
+  _ts_param9(1, (0, import_common12.Param)("id")),
+  _ts_param9(2, (0, import_common12.Body)()),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     typeof UpdateThreadBody === "undefined" ? Object : UpdateThreadBody
   ]),
-  _ts_metadata9("design:returntype", Promise)
+  _ts_metadata11("design:returntype", Promise)
 ], ThreadsController.prototype, "update", null);
-_ts_decorate10([
-  (0, import_common10.Post)(":id/promote"),
-  _ts_param8(0, (0, import_common10.Req)()),
-  _ts_param8(1, (0, import_common10.Param)("id")),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+_ts_decorate12([
+  (0, import_common12.Post)(":id/promote"),
+  _ts_param9(0, (0, import_common12.Req)()),
+  _ts_param9(1, (0, import_common12.Param)("id")),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata9("design:returntype", Promise)
+  _ts_metadata11("design:returntype", Promise)
 ], ThreadsController.prototype, "promote", null);
-_ts_decorate10([
-  (0, import_common10.Delete)(":id/from/:messageId"),
-  _ts_param8(0, (0, import_common10.Req)()),
-  _ts_param8(1, (0, import_common10.Param)("id")),
-  _ts_param8(2, (0, import_common10.Param)("messageId")),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+_ts_decorate12([
+  (0, import_common12.Delete)(":id/from/:messageId"),
+  _ts_param9(0, (0, import_common12.Req)()),
+  _ts_param9(1, (0, import_common12.Param)("id")),
+  _ts_param9(2, (0, import_common12.Param)("messageId")),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     String
   ]),
-  _ts_metadata9("design:returntype", Promise)
+  _ts_metadata11("design:returntype", Promise)
 ], ThreadsController.prototype, "truncateFrom", null);
-ThreadsController = _ts_decorate10([
-  (0, import_common10.Controller)("threads"),
-  _ts_param8(1, (0, import_common10.Inject)(import_nestjs_agent_core10.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+ThreadsController = _ts_decorate12([
+  (0, import_common12.Controller)("threads"),
+  _ts_param9(1, (0, import_common12.Inject)(import_nestjs_agent_core12.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ThreadsController);
 
 // src/controller/tool-call.controller.ts
-var import_nestjs_agent_core11 = require("@dudousxd/nestjs-agent-core");
-var import_common11 = require("@nestjs/common");
-function _ts_decorate11(decorators, target, key, desc) {
+var import_nestjs_agent_core13 = require("@dudousxd/nestjs-agent-core");
+var import_common13 = require("@nestjs/common");
+function _ts_decorate13(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate11, "_ts_decorate");
-function _ts_metadata10(k, v) {
+__name(_ts_decorate13, "_ts_decorate");
+function _ts_metadata12(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata10, "_ts_metadata");
-function _ts_param9(paramIndex, decorator) {
+__name(_ts_metadata12, "_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 ToolCallController = class {
   static {
     __name(this, "ToolCallController");
@@ -1301,41 +1577,41 @@ var ToolCallController = class {
     };
   }
 };
-_ts_decorate11([
-  (0, import_common11.Post)("approve"),
-  _ts_param9(0, (0, import_common11.Req)()),
-  _ts_param9(1, (0, import_common11.Body)()),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+_ts_decorate13([
+  (0, import_common13.Post)("approve"),
+  _ts_param10(0, (0, import_common13.Req)()),
+  _ts_param10(1, (0, import_common13.Body)()),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof ApproveBody === "undefined" ? Object : ApproveBody
   ]),
-  _ts_metadata10("design:returntype", Promise)
+  _ts_metadata12("design:returntype", Promise)
 ], ToolCallController.prototype, "approve", null);
-_ts_decorate11([
-  (0, import_common11.Post)("reject"),
-  _ts_param9(0, (0, import_common11.Req)()),
-  _ts_param9(1, (0, import_common11.Body)()),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+_ts_decorate13([
+  (0, import_common13.Post)("reject"),
+  _ts_param10(0, (0, import_common13.Req)()),
+  _ts_param10(1, (0, import_common13.Body)()),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof RejectBody === "undefined" ? Object : RejectBody
   ]),
-  _ts_metadata10("design:returntype", Promise)
+  _ts_metadata12("design:returntype", Promise)
 ], ToolCallController.prototype, "reject", null);
-ToolCallController = _ts_decorate11([
-  (0, import_common11.Controller)("tool-call"),
-  _ts_param9(1, (0, import_common11.Inject)(import_nestjs_agent_core11.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+ToolCallController = _ts_decorate13([
+  (0, import_common13.Controller)("tool-call"),
+  _ts_param10(1, (0, import_common13.Inject)(import_nestjs_agent_core13.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ToolCallController);
 
 // src/discovery/agent-discovery.service.ts
-var import_nestjs_agent_core12 = require("@dudousxd/nestjs-agent-core");
-var import_common12 = require("@nestjs/common");
+var import_nestjs_agent_core14 = require("@dudousxd/nestjs-agent-core");
+var import_common14 = require("@nestjs/common");
 var import_core = require("@nestjs/core");
 
 // src/decorator/agent.decorator.ts
@@ -1352,23 +1628,23 @@ var SYSTEM_PROMPT_METADATA = Symbol.for("@dudousxd/nestjs-agent:system-prompt");
 var SYSTEM_PROMPT_CONTRIBUTOR_METADATA = Symbol.for("@dudousxd/nestjs-agent:system-prompt-contributor");
 
 // src/discovery/agent-discovery.service.ts
-function _ts_decorate12(decorators, target, key, desc) {
+function _ts_decorate14(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate12, "_ts_decorate");
-function _ts_metadata11(k, v) {
+__name(_ts_decorate14, "_ts_decorate");
+function _ts_metadata13(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata11, "_ts_metadata");
-function _ts_param10(paramIndex, decorator) {
+__name(_ts_metadata13, "_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 AgentDiscoveryService = class _AgentDiscoveryService {
   static {
     __name(this, "AgentDiscoveryService");
@@ -1377,7 +1653,7 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
   scanner;
   registry;
   contributors;
-  logger = new import_common12.Logger(_AgentDiscoveryService.name);
+  logger = new import_common14.Logger(_AgentDiscoveryService.name);
   constructor(discovery, scanner, registry, contributors) {
     this.discovery = discovery;
     this.scanner = scanner;
@@ -1465,22 +1741,22 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
     return (ctx) => candidate.call(instance, ctx);
   }
 };
-AgentDiscoveryService = _ts_decorate12([
-  (0, import_common12.Injectable)(),
-  _ts_param10(2, (0, import_common12.Inject)(import_nestjs_agent_core12.AGENT_REGISTRY)),
-  _ts_param10(3, (0, import_common12.Inject)(import_nestjs_agent_core12.AGENT_PROMPT_CONTRIBUTORS)),
-  _ts_metadata11("design:type", Function),
-  _ts_metadata11("design:paramtypes", [
+AgentDiscoveryService = _ts_decorate14([
+  (0, import_common14.Injectable)(),
+  _ts_param11(2, (0, import_common14.Inject)(import_nestjs_agent_core14.AGENT_REGISTRY)),
+  _ts_param11(3, (0, import_common14.Inject)(import_nestjs_agent_core14.AGENT_PROMPT_CONTRIBUTORS)),
+  _ts_metadata13("design:type", Function),
+  _ts_metadata13("design:paramtypes", [
     typeof import_core.DiscoveryService === "undefined" ? Object : import_core.DiscoveryService,
     typeof import_core.MetadataScanner === "undefined" ? Object : import_core.MetadataScanner,
-    typeof import_nestjs_agent_core12.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core12.AgentRegistry,
+    typeof import_nestjs_agent_core14.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core14.AgentRegistry,
     Array
   ])
 ], AgentDiscoveryService);
 
 // src/discovery/ai-tool-discovery.service.ts
-var import_nestjs_agent_core13 = require("@dudousxd/nestjs-agent-core");
-var import_common13 = require("@nestjs/common");
+var import_nestjs_agent_core15 = require("@dudousxd/nestjs-agent-core");
+var import_common15 = require("@nestjs/common");
 var import_core2 = require("@nestjs/core");
 var import_zod = require("zod");
 
@@ -1500,23 +1776,23 @@ function isBrandedFunctionalTool(value) {
 __name(isBrandedFunctionalTool, "isBrandedFunctionalTool");
 
 // src/discovery/ai-tool-discovery.service.ts
-function _ts_decorate13(decorators, target, key, desc) {
+function _ts_decorate15(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate13, "_ts_decorate");
-function _ts_metadata12(k, v) {
+__name(_ts_decorate15, "_ts_decorate");
+function _ts_metadata14(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata12, "_ts_metadata");
-function _ts_param11(paramIndex, decorator) {
+__name(_ts_metadata14, "_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 AiToolDiscoveryService = class _AiToolDiscoveryService {
   static {
     __name(this, "AiToolDiscoveryService");
@@ -1525,7 +1801,7 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
   registry;
   agents;
   options;
-  logger = new import_common13.Logger(_AiToolDiscoveryService.name);
+  logger = new import_common15.Logger(_AiToolDiscoveryService.name);
   constructor(discovery, registry, agents, options) {
     this.discovery = discovery;
     this.registry = registry;
@@ -1623,13 +1899,13 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
     return true;
   }
 };
-AiToolDiscoveryService = _ts_decorate13([
-  (0, import_common13.Injectable)(),
-  _ts_param11(1, (0, import_common13.Inject)(import_nestjs_agent_core13.AGENT_TOOL_REGISTRY)),
-  _ts_param11(2, (0, import_common13.Inject)(import_nestjs_agent_core13.AGENT_REGISTRY)),
-  _ts_param11(3, (0, import_common13.Inject)(import_nestjs_agent_core13.AGENT_OPTIONS)),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+AiToolDiscoveryService = _ts_decorate15([
+  (0, import_common15.Injectable)(),
+  _ts_param12(1, (0, import_common15.Inject)(import_nestjs_agent_core15.AGENT_TOOL_REGISTRY)),
+  _ts_param12(2, (0, import_common15.Inject)(import_nestjs_agent_core15.AGENT_REGISTRY)),
+  _ts_param12(3, (0, import_common15.Inject)(import_nestjs_agent_core15.AGENT_OPTIONS)),
+  _ts_metadata14("design:type", Function),
+  _ts_metadata14("design:paramtypes", [
     typeof import_core2.DiscoveryService === "undefined" ? Object : import_core2.DiscoveryService,
     typeof ToolRegistry === "undefined" ? Object : ToolRegistry,
     typeof AgentRegistry === "undefined" ? Object : AgentRegistry,
@@ -1637,74 +1913,6 @@ AiToolDiscoveryService = _ts_decorate13([
   ])
 ], AiToolDiscoveryService);
 
-// src/in-process-sink.ts
-var import_nestjs_agent_core14 = require("@dudousxd/nestjs-agent-core");
-var InProcessTokenStreamSink = class {
-  static {
-    __name(this, "InProcessTokenStreamSink");
-  }
-  runs = /* @__PURE__ */ new Map();
-  buffer(runId) {
-    let buf = this.runs.get(runId);
-    if (buf === void 0) {
-      buf = {
-        chunks: [],
-        ended: false,
-        notify: /* @__PURE__ */ new Set()
-      };
-      this.runs.set(runId, buf);
-    }
-    return buf;
-  }
-  wake(buf) {
-    for (const resolve of buf.notify) {
-      resolve();
-    }
-    buf.notify.clear();
-  }
-  open(runId) {
-    const buf = this.buffer(runId);
-    return {
-      write: /* @__PURE__ */ __name((chunk) => {
-        buf.chunks.push(chunk);
-        this.wake(buf);
-      }, "write"),
-      end: /* @__PURE__ */ __name(() => {
-        buf.ended = true;
-        this.wake(buf);
-      }, "end"),
-      fail: /* @__PURE__ */ __name((error) => {
-        buf.failure = error;
-        buf.ended = true;
-        this.wake(buf);
-      }, "fail")
-    };
-  }
-  async *subscribe(runId) {
-    const buf = this.buffer(runId);
-    let index = 0;
-    while (true) {
-      while (index < buf.chunks.length) {
-        const chunk = buf.chunks[index];
-        index += 1;
-        if (chunk !== void 0) {
-          yield chunk;
-        }
-      }
-      if (buf.ended) {
-        if (buf.failure !== void 0) {
-          throw new import_nestjs_agent_core14.AgentStreamError(buf.failure);
-        }
-        return;
-      }
-      await new Promise((resolve) => buf.notify.add(resolve));
-    }
-  }
-  close(runId) {
-    this.runs.delete(runId);
-  }
-};
-
 // src/ledger-quota-store.ts
 var LedgerQuotaStore = class {
   static {
@@ -1729,32 +1937,32 @@ var LedgerQuotaStore = class {
 };
 
 // src/runner/inline-agent-runner.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_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_decorate14, "_ts_decorate");
-function _ts_metadata13(k, v) {
+__name(_ts_decorate16, "_ts_decorate");
+function _ts_metadata15(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata13, "_ts_metadata");
-function _ts_param12(paramIndex, decorator) {
+__name(_ts_metadata15, "_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 InlineAgentRunner = class _InlineAgentRunner {
   static {
     __name(this, "InlineAgentRunner");
   }
   factory;
   store;
-  logger = new import_common14.Logger(_InlineAgentRunner.name);
+  logger = new import_common16.Logger(_InlineAgentRunner.name);
   pending = /* @__PURE__ */ new Map();
   constructor(factory, store) {
     this.factory = factory;
@@ -1765,18 +1973,24 @@ var InlineAgentRunner = class _InlineAgentRunner {
     const day = input.day ?? utcDay();
     const deps = this.factory.forAgent(input.agentName);
     const hooks = this.topLevelHooks(runId, deps, input.actor, day);
-    void (0, import_nestjs_agent_core15.runAgentLoop)({
+    void (0, import_nestjs_agent_core16.runAgentLoop)({
       ...deps,
       day
     }, input, hooks).then(() => this.store.setActiveStream(input.threadId, null)).catch(async (error) => {
       const message = error instanceof Error ? error.message : String(error);
-      const code = error instanceof import_nestjs_agent_core15.QuotaExceededError ? "quota_exceeded" : "run_failed";
+      const code = error instanceof import_nestjs_agent_core16.QuotaExceededError ? "quota_exceeded" : "run_failed";
       this.logger.error(`agent run ${runId} failed (${code}): ${message}`);
-      (0, import_nestjs_agent_core15.publishAgentRunFailed)({
+      (0, import_nestjs_agent_core16.publishAgentRunFailed)({
         runId,
         code,
         message
       });
+      await this.store.recordRunEnd?.({
+        runId,
+        status: "failed",
+        errorCode: code,
+        errorMessage: message
+      });
       await this.store.setActiveStream(input.threadId, null);
       const writer = await deps.sink.open(runId);
       await writer.fail({
@@ -1836,7 +2050,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
       runAgent: /* @__PURE__ */ __name((childName, childTask) => this.runNested(childName, childTask, actor, day, depth + 1, sinkRunId), "runAgent")
     };
     try {
-      return await (0, import_nestjs_agent_core15.runAgentLoop)({
+      return await (0, import_nestjs_agent_core16.runAgentLoop)({
         ...deps,
         day
       }, {
@@ -1853,84 +2067,84 @@ var InlineAgentRunner = class _InlineAgentRunner {
     }
   }
 };
-InlineAgentRunner = _ts_decorate14([
-  (0, import_common14.Injectable)(),
-  _ts_param12(0, (0, import_common14.Inject)(import_nestjs_agent_core15.AGENT_DEPS_FACTORY)),
-  _ts_param12(1, (0, import_common14.Inject)(import_nestjs_agent_core15.AGENT_STORE)),
-  _ts_metadata13("design:type", Function),
-  _ts_metadata13("design:paramtypes", [
+InlineAgentRunner = _ts_decorate16([
+  (0, import_common16.Injectable)(),
+  _ts_param13(0, (0, import_common16.Inject)(import_nestjs_agent_core16.AGENT_DEPS_FACTORY)),
+  _ts_param13(1, (0, import_common16.Inject)(import_nestjs_agent_core16.AGENT_STORE)),
+  _ts_metadata15("design:type", Function),
+  _ts_metadata15("design:paramtypes", [
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
     typeof AgentStore === "undefined" ? Object : AgentStore
   ])
 ], InlineAgentRunner);
 
 // src/agent.module.ts
-function _ts_decorate15(decorators, target, key, desc) {
+function _ts_decorate17(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   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_decorate15, "_ts_decorate");
+__name(_ts_decorate17, "_ts_decorate");
 var DEFAULT_PATH = "agent";
 function sharedProviders(durable, includeStore) {
   const providers = [
     {
-      provide: import_nestjs_agent_core16.AGENT_TOOL_REGISTRY,
-      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core16.ToolRegistry(), "useFactory")
+      provide: import_nestjs_agent_core17.AGENT_TOOL_REGISTRY,
+      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core17.ToolRegistry(), "useFactory")
     },
     // Starts empty; AgentDiscoveryService populates it from `@Agent`-decorated providers at boot.
     {
-      provide: import_nestjs_agent_core16.AGENT_REGISTRY,
-      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core16.AgentRegistry(), "useFactory")
+      provide: import_nestjs_agent_core17.AGENT_REGISTRY,
+      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core17.AgentRegistry(), "useFactory")
     },
     // A shared, mutable list AgentDiscoveryService fills with `@SystemPromptContributor()` methods.
     {
-      provide: import_nestjs_agent_core16.AGENT_PROMPT_CONTRIBUTORS,
+      provide: import_nestjs_agent_core17.AGENT_PROMPT_CONTRIBUTORS,
       useFactory: /* @__PURE__ */ __name(() => [], "useFactory")
     },
     {
-      provide: import_nestjs_agent_core16.AGENT_SINK,
+      provide: import_nestjs_agent_core17.AGENT_SINK,
       useFactory: /* @__PURE__ */ __name((options) => options.sink ?? new InProcessTokenStreamSink(), "useFactory"),
       inject: [
-        import_nestjs_agent_core16.AGENT_OPTIONS
+        import_nestjs_agent_core17.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core16.AGENT_ROLES_POLICY,
-      useFactory: /* @__PURE__ */ __name((options) => options.rolesPolicy ?? new import_nestjs_agent_core16.DefaultRolesPolicy(options.defaultRoles), "useFactory"),
+      provide: import_nestjs_agent_core17.AGENT_ROLES_POLICY,
+      useFactory: /* @__PURE__ */ __name((options) => options.rolesPolicy ?? new import_nestjs_agent_core17.DefaultRolesPolicy(options.defaultRoles), "useFactory"),
       inject: [
-        import_nestjs_agent_core16.AGENT_OPTIONS
+        import_nestjs_agent_core17.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core16.AGENT_ACTOR_RESOLVER,
+      provide: import_nestjs_agent_core17.AGENT_ACTOR_RESOLVER,
       useFactory: /* @__PURE__ */ __name((options) => options.actorResolver, "useFactory"),
       inject: [
-        import_nestjs_agent_core16.AGENT_OPTIONS
+        import_nestjs_agent_core17.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core16.AGENT_MODEL,
+      provide: import_nestjs_agent_core17.AGENT_MODEL,
       useFactory: /* @__PURE__ */ __name((o) => o.model, "useFactory"),
       inject: [
-        import_nestjs_agent_core16.AGENT_OPTIONS
+        import_nestjs_agent_core17.AGENT_OPTIONS
       ]
     },
     {
       // An explicit `quota` wins; otherwise `quotaLimitTokens` binds the built-in ledger-backed
       // store; otherwise quotas are off (undefined). The ledger store reads the same usage rows
       // the loop already writes, so enforcement needs no extra shared state across replicas.
-      provide: import_nestjs_agent_core16.AGENT_QUOTA_STORE,
+      provide: import_nestjs_agent_core17.AGENT_QUOTA_STORE,
       useFactory: /* @__PURE__ */ __name((o, store) => o.quota ?? (o.quotaLimitTokens !== void 0 ? new LedgerQuotaStore(store, o.quotaLimitTokens) : void 0), "useFactory"),
       inject: [
-        import_nestjs_agent_core16.AGENT_OPTIONS,
-        import_nestjs_agent_core16.AGENT_STORE
+        import_nestjs_agent_core17.AGENT_OPTIONS,
+        import_nestjs_agent_core17.AGENT_STORE
       ]
     },
     AgentDepsFactory2,
     {
-      provide: import_nestjs_agent_core16.AGENT_DEPS_FACTORY,
+      provide: import_nestjs_agent_core17.AGENT_DEPS_FACTORY,
       useExisting: AgentDepsFactory2
     },
     // Populates the registry + contributors (onModuleInit) BEFORE AiToolDiscoveryService synthesizes
@@ -1938,20 +2152,27 @@ function sharedProviders(durable, includeStore) {
     AgentDiscoveryService,
     AiToolDiscoveryService,
     InlineAgentRunner,
-    AgentService
+    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_core17.AGENT_APPROVAL_PORT,
+      useExisting: AgentApprovalPortAdapter
+    }
   ];
   if (includeStore) {
     providers.push({
-      provide: import_nestjs_agent_core16.AGENT_STORE,
+      provide: import_nestjs_agent_core17.AGENT_STORE,
       useFactory: /* @__PURE__ */ __name((o) => o.store, "useFactory"),
       inject: [
-        import_nestjs_agent_core16.AGENT_OPTIONS
+        import_nestjs_agent_core17.AGENT_OPTIONS
       ]
     });
   }
   if (durable) {
     providers.push({
-      provide: import_nestjs_agent_core16.AGENT_RUNNER,
+      provide: import_nestjs_agent_core17.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.");
@@ -1960,14 +2181,14 @@ function sharedProviders(durable, includeStore) {
       }, "useFactory"),
       inject: [
         {
-          token: import_nestjs_agent_core16.AGENT_DURABLE_RUNNER,
+          token: import_nestjs_agent_core17.AGENT_DURABLE_RUNNER,
           optional: true
         }
       ]
     });
   } else {
     providers.push({
-      provide: import_nestjs_agent_core16.AGENT_RUNNER,
+      provide: import_nestjs_agent_core17.AGENT_RUNNER,
       useExisting: InlineAgentRunner
     });
   }
@@ -1976,22 +2197,23 @@ function sharedProviders(durable, includeStore) {
 __name(sharedProviders, "sharedProviders");
 function exportsFor(includeStore) {
   return [
-    import_nestjs_agent_core16.AGENT_OPTIONS,
-    import_nestjs_agent_core16.AGENT_TOOL_REGISTRY,
-    import_nestjs_agent_core16.AGENT_REGISTRY,
-    import_nestjs_agent_core16.AGENT_SINK,
-    import_nestjs_agent_core16.AGENT_ROLES_POLICY,
-    import_nestjs_agent_core16.AGENT_ACTOR_RESOLVER,
-    import_nestjs_agent_core16.AGENT_MODEL,
+    import_nestjs_agent_core17.AGENT_OPTIONS,
+    import_nestjs_agent_core17.AGENT_TOOL_REGISTRY,
+    import_nestjs_agent_core17.AGENT_REGISTRY,
+    import_nestjs_agent_core17.AGENT_SINK,
+    import_nestjs_agent_core17.AGENT_ROLES_POLICY,
+    import_nestjs_agent_core17.AGENT_ACTOR_RESOLVER,
+    import_nestjs_agent_core17.AGENT_MODEL,
     ...includeStore ? [
-      import_nestjs_agent_core16.AGENT_STORE
+      import_nestjs_agent_core17.AGENT_STORE
     ] : [],
-    import_nestjs_agent_core16.AGENT_QUOTA_STORE,
-    import_nestjs_agent_core16.AGENT_PROMPT_CONTRIBUTORS,
-    import_nestjs_agent_core16.AGENT_DEPS_FACTORY,
+    import_nestjs_agent_core17.AGENT_QUOTA_STORE,
+    import_nestjs_agent_core17.AGENT_PROMPT_CONTRIBUTORS,
+    import_nestjs_agent_core17.AGENT_DEPS_FACTORY,
     AgentDepsFactory2,
     AgentService,
-    InlineAgentRunner
+    InlineAgentRunner,
+    import_nestjs_agent_core17.AGENT_APPROVAL_PORT
   ];
 }
 __name(exportsFor, "exportsFor");
@@ -2036,11 +2258,18 @@ function routerFor(path) {
   ]);
 }
 __name(routerFor, "routerFor");
+function assertDispatchedStepsRequiresDurable(dispatchedSteps, durable) {
+  if (dispatchedSteps && !durable) {
+    throw new Error("AgentModule dispatchedSteps: true requires durable: true \u2014 dispatched steps are routed durable steps (AgentRunSteps.llm/tool) with no in-process equivalent.");
+  }
+}
+__name(assertDispatchedStepsRequiresDurable, "assertDispatchedStepsRequiresDurable");
 var AgentModule = class _AgentModule {
   static {
     __name(this, "AgentModule");
   }
   static forRoot(options) {
+    assertDispatchedStepsRequiresDurable(options.dispatchedSteps ?? false, options.durable ?? false);
     const path = options.path ?? DEFAULT_PATH;
     const includeStore = options.store !== void 0;
     applyGuards(options.guards);
@@ -2054,7 +2283,7 @@ var AgentModule = class _AgentModule {
       controllers: controllersFor(options.attachments?.upload === true),
       providers: [
         {
-          provide: import_nestjs_agent_core16.AGENT_OPTIONS,
+          provide: import_nestjs_agent_core17.AGENT_OPTIONS,
           useValue: options
         },
         ...sharedProviders(options.durable ?? false, includeStore),
@@ -2064,6 +2293,7 @@ var AgentModule = class _AgentModule {
     };
   }
   static forRootAsync(options) {
+    assertDispatchedStepsRequiresDurable(options.dispatchedSteps ?? false, options.durable ?? false);
     const path = options.path ?? DEFAULT_PATH;
     const includeStore = options.externalStore !== true;
     applyGuards(options.guards);
@@ -2078,8 +2308,18 @@ var AgentModule = class _AgentModule {
       controllers: controllersFor(options.attachmentsUpload === true),
       providers: [
         {
-          provide: import_nestjs_agent_core16.AGENT_OPTIONS,
-          useFactory: options.useFactory,
+          provide: import_nestjs_agent_core17.AGENT_OPTIONS,
+          // Stamp the STATIC wiring flags onto the factory result: `durable`/`dispatchedSteps` are
+          // authoritative on the async config object (they decided the actual wiring above), and
+          // `AgentDurableModule` derives the effective dispatched-steps value from AGENT_OPTIONS —
+          // without this stamp, an async host would get in-process localSteps despite durable: true.
+          useFactory: /* @__PURE__ */ __name(async (...args) => ({
+            ...await options.useFactory(...args),
+            durable: options.durable ?? false,
+            ...options.dispatchedSteps !== void 0 ? {
+              dispatchedSteps: options.dispatchedSteps
+            } : {}
+          }), "useFactory"),
           inject: options.inject ?? []
         },
         ...sharedProviders(options.durable ?? false, includeStore),
@@ -2089,9 +2329,9 @@ var AgentModule = class _AgentModule {
     };
   }
 };
-AgentModule = _ts_decorate15([
-  (0, import_common15.Global)(),
-  (0, import_common15.Module)({})
+AgentModule = _ts_decorate17([
+  (0, import_common17.Global)(),
+  (0, import_common17.Module)({})
 ], AgentModule);
 
 // src/durable/agent-durable.ts
@@ -2107,7 +2347,9 @@ function agentDurable(options) {
 __name(agentDurable, "agentDurable");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AGENT_DISPATCHED_STEPS,
   AgentDurableModule,
+  AgentRunSteps,
   AgentRunWorkflow,
   DurableAgentRunner,
   agentDurable