@dudousxd/nestjs-agent 1.19.3 → 1.21.0

package/dist/durable/index.cjs

@@ -30,7 +30,7 @@ __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_core4 = require("@dudousxd/nestjs-agent-core");
 var import_nestjs_durable2 = require("@dudousxd/nestjs-durable");
 var import_nestjs_durable_core2 = require("@dudousxd/nestjs-durable-core");
 var import_common2 = require("@nestjs/common");
@@ -62,6 +62,8 @@ var AGENT_CHAT_QUEUE = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:chat-q
 
 // src/durable/agent-run.steps.ts
 var import_nestjs_agent_core = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core2 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core3 = require("@dudousxd/nestjs-agent-core");
 var import_nestjs_durable = require("@dudousxd/nestjs-durable");
 var import_common = require("@nestjs/common");
 
@@ -122,24 +124,34 @@ var AgentRunSteps = class {
   }
   async runLlm(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)({
-          tools: await deps.registry.definitionsFor(input.actor, deps.rolesPolicy, deps.toolAllowList, {
-            ...input.threadId !== void 0 ? {
-              threadId: input.threadId
-            } : {},
-            ...input.agentName !== void 0 ? {
-              agentName: input.agentName
-            } : {}
-          }),
+    const tools = (0, import_nestjs_agent_core3.withMemoryTool)({
+      tools: (0, import_nestjs_agent_core3.withSkillTool)({
+        tools: (0, import_nestjs_agent_core3.withAskTool)({
+          tools: await deps.registry.definitionsFor(
+            input.actor,
+            deps.rolesPolicy,
+            // The persona narrowing the loop journaled in `persona:resolve` rides the envelope:
+            // this worker's own persona config may already say something else.
+            (0, import_nestjs_agent_core3.intersectAllowLists)(deps.toolAllowList, input.personaAllowedTools),
+            {
+              ...input.threadId !== void 0 ? {
+                threadId: input.threadId
+              } : {},
+              ...input.preflightContext?.uiCapabilities !== void 0 ? {
+                uiCapabilities: input.preflightContext.uiCapabilities
+              } : {},
+              ...input.agentName !== void 0 ? {
+                agentName: input.agentName
+              } : {}
+            }
+          ),
           ask: deps.ask
         }),
         enabled: deps.skills !== void 0
       }),
       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_core3.createFrameBuffer)() : void 0;
     let writer;
     if (buffer !== void 0) {
       writer = buffer.writer;
@@ -147,8 +159,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_core3.observeTurnFrames)(writer);
+    const turn = (0, import_nestjs_agent_core3.withTurnFrames)(await (0, import_nestjs_agent_core3.traceLlmTurn)(input.runId, input.step, () => deps.model.runTurn({
       system: input.system,
       messages: input.messages,
       tools,
@@ -157,7 +169,68 @@ var AgentRunSteps = class {
         model: input.model
       } : {}
     })), frames.summary());
-    const stamped = (0, import_nestjs_agent_core.stampToolKinds)(turn, deps);
+    const stamped = (0, import_nestjs_agent_core3.stampToolKinds)(turn, deps);
+    const allowedTools = (0, import_nestjs_agent_core3.intersectAllowLists)(deps.toolAllowList, input.personaAllowedTools);
+    for (const call of stamped.toolCalls) {
+      if (call.kind !== "action") continue;
+      try {
+        const context = input.preflightContext ?? {
+          actor: input.actor,
+          threadId: input.threadId ?? "",
+          runId: input.runId,
+          requestId: input.runId,
+          ...input.agentName !== void 0 ? {
+            agentName: input.agentName
+          } : {}
+        };
+        if (input.actionApprovalMode === "independent") {
+          const spec = deps.registry.spec(call.name);
+          call.actionApproval = await (0, import_nestjs_agent_core2.resolveActionProposalApproval)({
+            actor: input.actor,
+            store: deps.store,
+            tool: {
+              name: call.name,
+              kind: "action",
+              ...spec !== void 0 ? {
+                spec
+              } : {}
+            },
+            thread: {
+              threadId: context.threadId,
+              runId: input.runId,
+              ...input.agentName !== void 0 ? {
+                agentName: input.agentName
+              } : {}
+            },
+            ...deps.approvalPolicy !== void 0 ? {
+              policy: deps.approvalPolicy
+            } : {}
+          });
+        }
+        if (call.actionApproval?.mode === "ask") {
+          call.prepared = await (0, import_nestjs_agent_core2.prepareActionProposal)(deps.registry, call.name, call.input, {
+            ...(0, import_nestjs_agent_core3.toolCallContext)(context, call.id),
+            emitUi: (0, import_nestjs_agent_core3.createNoopEmitUi)(call.id)
+          }, deps.rolesPolicy, allowedTools === void 0 ? {} : {
+            allowedTools
+          });
+          call.preflight = call.prepared.preflight;
+        } else {
+          call.preflight = await deps.registry.prepare(call.name, call.input, {
+            ...(0, import_nestjs_agent_core3.toolCallContext)(context, call.id),
+            emitUi: (0, import_nestjs_agent_core3.createNoopEmitUi)(call.id)
+          }, deps.rolesPolicy, allowedTools === void 0 ? {} : {
+            allowedTools
+          });
+        }
+      } catch (error) {
+        if ((0, import_nestjs_agent_core3.isControlFlowSignal)(error) || (0, import_nestjs_agent_core3.isReplayIntegrityError)(error)) throw error;
+        call.preflight = {
+          status: "failed",
+          error: error instanceof Error ? error.message : String(error)
+        };
+      }
+    }
     return buffer === void 0 ? stamped : {
       ...stamped,
       bufferedFrames: buffer.frames()
@@ -183,12 +256,12 @@ 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_core.createNegotiatedUiCollector)(input.toolCallId, input.ctx, deps.resolveUiCatalog, 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_core3.encodeStreamEvent)(event));
     });
     const ctx = {
-      ...(0, import_nestjs_agent_core.toolCallContext)(input.ctx, input.toolCallId),
+      ...(0, import_nestjs_agent_core3.toolCallContext)(input.ctx, input.toolCallId),
       emitUi: ui.emit
     };
     const localClassify = deps.toolTransientRetry !== false ? deps.toolTransientRetry?.classify : void 0;
@@ -199,25 +272,38 @@ var AgentRunSteps = class {
         classify: localClassify
       } : {}
     };
-    const output = await (0, import_nestjs_agent_core.traceToolExecution)(input.ctx.runId, {
-      toolCallId: input.toolCallId,
-      toolName: input.toolName,
-      toolType: input.toolType
-    }, () => (0, import_nestjs_agent_core.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;
-    }, transientRetry, {
-      onRetry: /* @__PURE__ */ __name((attempt, error) => {
-        (0, import_nestjs_agent_core.publishAgentToolRetry)({
-          toolName: input.toolName,
-          toolCallId: input.toolCallId,
-          attempt,
-          message: error instanceof Error ? error.message : String(error)
+    const allowedTools = (0, import_nestjs_agent_core3.intersectAllowLists)(deps.toolAllowList, input.allowedTools === void 0 ? void 0 : [
+      ...input.allowedTools
+    ]);
+    let output;
+    try {
+      output = await (0, import_nestjs_agent_core3.traceToolExecution)(input.ctx.runId, {
+        toolCallId: input.toolCallId,
+        toolName: input.toolName,
+        toolType: input.toolType
+      }, () => (0, import_nestjs_agent_core3.invokeWithTransientRetry)(() => {
+        ui.restart();
+        const invocation = deps.registry.invoke(input.toolName, input.input, ctx, deps.rolesPolicy, allowedTools === void 0 ? {} : {
+          allowedTools
         });
-      }, "onRetry")
-    }));
-    return input.collectUi === true ? (0, import_nestjs_agent_core.wrapToolStepOutput)(output, ui.components()) : output;
+        return input.timeoutMs !== void 0 ? (0, import_nestjs_agent_core3.withToolTimeout)(invocation, input.timeoutMs, input.toolName) : invocation;
+      }, transientRetry, {
+        onRetry: /* @__PURE__ */ __name((attempt, error) => {
+          (0, import_nestjs_agent_core3.publishAgentToolRetry)({
+            toolName: input.toolName,
+            toolCallId: input.toolCallId,
+            attempt,
+            message: error instanceof Error ? error.message : String(error)
+          });
+        }, "onRetry")
+      }));
+    } catch (error) {
+      if (error instanceof Error && error.name === "ToolPreflightDeniedError") {
+        return (0, import_nestjs_agent_core3.wrapToolPreflightDenied)(error.message);
+      }
+      throw error;
+    }
+    return input.collectUi === true ? (0, import_nestjs_agent_core3.wrapToolStepOutput)(output, ui.components(), ui.text()) : output;
   }
 };
 _ts_decorate([
@@ -240,7 +326,7 @@ _ts_decorate([
 ], 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_param(0, (0, import_common.Inject)(import_nestjs_agent_core3.AGENT_DEPS_FACTORY)),
   _ts_metadata("design:type", Function),
   _ts_metadata("design:paramtypes", [
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory
@@ -424,7 +510,7 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
     if (delivery === void 0) {
       return;
     }
-    await stepOf(ctx)("deliver:detached:unsettled", () => (0, import_nestjs_agent_core2.settleUnsettledDelegation)({
+    await stepOf(ctx)("deliver:detached:unsettled", () => (0, import_nestjs_agent_core4.settleUnsettledDelegation)({
       store: this.store,
       delivery,
       agent: input.agentName ?? "default",
@@ -465,7 +551,7 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
           end: /* @__PURE__ */ __name(async () => {
             const frame = await this.advanceQueue(ctx, input, "completed");
             if (frame !== void 0) {
-              await writer.write((0, import_nestjs_agent_core2.encodeStreamEvent)(frame));
+              await writer.write((0, import_nestjs_agent_core4.encodeStreamEvent)(frame));
             }
             await writer.end();
           }, "end")
@@ -497,7 +583,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_core4.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
@@ -600,33 +686,33 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
       } : {}
     };
     try {
-      const result = await (0, import_nestjs_agent_core2.runAgentLoop)({
+      const result = await (0, import_nestjs_agent_core4.runAgentLoop)({
         ...deps,
         day
       }, input, hooks);
-      await stepOf(ctx)("deactivate", () => (0, import_nestjs_agent_core2.releaseThreadRun)(this.store, input.threadId, ctx.runId));
+      await stepOf(ctx)("deactivate", () => (0, import_nestjs_agent_core4.releaseThreadRun)(this.store, input.threadId, ctx.runId));
       return result;
     } catch (error) {
       if ((0, import_nestjs_durable_core2.isWorkflowControlFlowSignal)(error)) {
         throw error;
       }
-      if (error instanceof import_nestjs_agent_core2.RunCancelledError) {
-        await stepOf(ctx)("deactivate", () => (0, import_nestjs_agent_core2.releaseThreadRun)(this.store, input.threadId, ctx.runId));
+      if (error instanceof import_nestjs_agent_core4.RunCancelledError) {
+        await stepOf(ctx)("deactivate", () => (0, import_nestjs_agent_core4.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_core4.isReplayIntegrityError)(error)) {
         const detail = error.message;
-        const code2 = (0, import_nestjs_agent_core2.agentFailureCode)(error);
+        const code2 = (0, import_nestjs_agent_core4.agentFailureCode)(error);
         this.logger.error(`agent run ${ctx.runId} failed (${code2}): ${detail}`);
-        (0, import_nestjs_agent_core2.publishAgentRunFailed)({
+        (0, import_nestjs_agent_core4.publishAgentRunFailed)({
           runId: ctx.runId,
           code: code2,
           message: detail
         });
-        await (0, import_nestjs_agent_core2.settleDeadRun)(this.store, {
+        await (0, import_nestjs_agent_core4.settleDeadRun)(this.store, {
           runId: ctx.runId,
           threadId: input.threadId,
           failure: {
@@ -634,13 +720,13 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
             message: detail
           }
         });
-        await (await hooks.openSink()).fail((0, import_nestjs_agent_core2.streamFailure)(error));
+        await (await hooks.openSink()).fail((0, import_nestjs_agent_core4.streamFailure)(error));
         throw error;
       }
       const message = error instanceof Error ? error.message : String(error);
-      const code = (0, import_nestjs_agent_core2.agentFailureCode)(error);
+      const code = (0, import_nestjs_agent_core4.agentFailureCode)(error);
       this.logger.error(`agent run ${ctx.runId} failed (${code}): ${message}`);
-      (0, import_nestjs_agent_core2.publishAgentRunFailed)({
+      (0, import_nestjs_agent_core4.publishAgentRunFailed)({
         runId: ctx.runId,
         code,
         message
@@ -652,19 +738,19 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
           errorCode: code,
           errorMessage: message
         });
-        await Promise.resolve(this.store.failUnsettledToolCalls?.(ctx.runId, import_nestjs_agent_core2.RUN_ENDED_BEFORE_TOOL_CALL)).catch(() => 0);
+        await Promise.resolve(this.store.failUnsettledToolCalls?.(ctx.runId, import_nestjs_agent_core4.RUN_ENDED_BEFORE_TOOL_CALL)).catch(() => 0);
       });
       const queueFrame2 = await this.advanceQueue(ctx, input, "failed", message);
-      await stepOf(ctx)("deactivate", () => (0, import_nestjs_agent_core2.releaseThreadRun)(this.store, input.threadId, ctx.runId));
+      await stepOf(ctx)("deactivate", () => (0, import_nestjs_agent_core4.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_core2.encodeStreamEvent)(queueFrame2));
+        await writer.write((0, import_nestjs_agent_core4.encodeStreamEvent)(queueFrame2));
       }
-      await writer.fail((0, import_nestjs_agent_core2.streamFailure)(error));
+      await writer.fail((0, import_nestjs_agent_core4.streamFailure)(error));
       throw error;
     }
   }
@@ -675,8 +761,8 @@ AgentRunWorkflow = _ts_decorate2([
     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(0, (0, import_common2.Inject)(import_nestjs_agent_core4.AGENT_DEPS_FACTORY)),
+  _ts_param2(1, (0, import_common2.Inject)(import_nestjs_agent_core4.AGENT_STORE)),
   _ts_param2(2, (0, import_common2.Optional)()),
   _ts_param2(2, (0, import_common2.Inject)(import_nestjs_durable2.RUN_GATEWAY)),
   _ts_param2(3, (0, import_common2.Optional)()),
@@ -698,13 +784,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_core6 = require("@dudousxd/nestjs-agent-core");
 var import_nestjs_durable3 = require("@dudousxd/nestjs-durable");
 var import_nestjs_durable_core3 = require("@dudousxd/nestjs-durable-core");
 var import_common3 = require("@nestjs/common");
 
 // src/in-process-sink.ts
-var import_nestjs_agent_core3 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core5 = require("@dudousxd/nestjs-agent-core");
 var InProcessTokenStreamSink = class {
   static {
     __name(this, "InProcessTokenStreamSink");
@@ -759,7 +845,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_core5.AgentStreamError(buf.failure);
         }
         return;
       }
@@ -924,15 +1010,15 @@ var DurableAgentRunner = class _DurableAgentRunner {
             runId: nextRunId
           }));
           if (frame !== void 0) {
-            await writer.write((0, import_nestjs_agent_core4.encodeStreamEvent)(frame));
+            await writer.write((0, import_nestjs_agent_core6.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_core4.releaseThreadRun)(this.store, threadId, runId);
+      await (0, import_nestjs_agent_core6.releaseThreadRun)(this.store, threadId, runId);
     }
-    await writer.write((0, import_nestjs_agent_core4.encodeStreamEvent)({
+    await writer.write((0, import_nestjs_agent_core6.encodeStreamEvent)({
       kind: "cancelled"
     }));
     await writer.end();
@@ -955,7 +1041,7 @@ var DurableAgentRunner = class _DurableAgentRunner {
       return;
     }
     try {
-      await (0, import_nestjs_agent_core4.settleUnsettledDelegation)({
+      await (0, import_nestjs_agent_core6.settleUnsettledDelegation)({
         store: this.store,
         delivery: target.delivery,
         agent: target.agent,
@@ -978,11 +1064,11 @@ var DurableAgentRunner = class _DurableAgentRunner {
     }
     const subThreadId = threadOfRun(child.run.input);
     if (subThreadId !== void 0) {
-      await (0, import_nestjs_agent_core4.releaseThreadRun)(this.store, subThreadId, childId);
+      await (0, import_nestjs_agent_core6.releaseThreadRun)(this.store, subThreadId, childId);
     }
     await this.settleCancelledDelegation(childId, child.run.input);
     const writer = await this.sink.open(childId);
-    await writer.write((0, import_nestjs_agent_core4.encodeStreamEvent)({
+    await writer.write((0, import_nestjs_agent_core6.encodeStreamEvent)({
       kind: "cancelled"
     }));
     await writer.end();
@@ -1012,8 +1098,8 @@ var DurableAgentRunner = class _DurableAgentRunner {
 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_param3(2, (0, import_common3.Inject)(import_nestjs_agent_core6.AGENT_STORE)),
+  _ts_param3(3, (0, import_common3.Inject)(import_nestjs_agent_core6.AGENT_SINK)),
   _ts_param3(4, (0, import_common3.Optional)()),
   _ts_param3(4, (0, import_common3.Inject)(AGENT_CHAT_QUEUE)),
   _ts_metadata3("design:type", Function),
@@ -1027,7 +1113,7 @@ DurableAgentRunner = _ts_decorate3([
 ], DurableAgentRunner);
 
 // src/durable/agent-durable.module.ts
-var import_nestjs_agent_core5 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core7 = require("@dudousxd/nestjs-agent-core");
 var import_common4 = require("@nestjs/common");
 function _ts_decorate4(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -1047,7 +1133,7 @@ function runnerProviders() {
   return [
     DurableAgentRunner,
     {
-      provide: import_nestjs_agent_core5.AGENT_DURABLE_RUNNER,
+      provide: import_nestjs_agent_core7.AGENT_DURABLE_RUNNER,
       useExisting: DurableAgentRunner
     }
   ];
@@ -1066,7 +1152,7 @@ AgentDurableHttpModule = _ts_decorate4([
       ...runnerProviders()
     ],
     exports: [
-      import_nestjs_agent_core5.AGENT_DURABLE_RUNNER,
+      import_nestjs_agent_core7.AGENT_DURABLE_RUNNER,
       AgentRunWorkflow
     ]
   })
@@ -1105,7 +1191,7 @@ AgentDurableModule = _ts_decorate4([
       ...runnerProviders()
     ],
     exports: [
-      import_nestjs_agent_core5.AGENT_DURABLE_RUNNER,
+      import_nestjs_agent_core7.AGENT_DURABLE_RUNNER,
       AgentRunWorkflow,
       AgentRunSteps
     ]
@@ -1113,14 +1199,44 @@ AgentDurableModule = _ts_decorate4([
 ], AgentDurableModule);
 
 // src/agent.module.ts
-var import_nestjs_agent_core31 = require("@dudousxd/nestjs-agent-core");
-var import_common27 = require("@nestjs/common");
+var import_nestjs_agent_core37 = require("@dudousxd/nestjs-agent-core");
+var import_common31 = 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_nestjs_agent_core8 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core9 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core10 = require("@dudousxd/nestjs-agent-core");
+var import_common6 = require("@nestjs/common");
+
+// src/genui/agent-genui.module.ts
+var import_genui = require("@dudousxd/nestjs-agent-core/genui");
 var import_common5 = require("@nestjs/common");
+
+// src/functional-tool.ts
+var AGENT_TOOL_BRAND = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:functional-tool");
+function brand(tool) {
+  return {
+    [AGENT_TOOL_BRAND]: true,
+    spec: tool.spec,
+    handler: tool.handler
+  };
+}
+__name(brand, "brand");
+function isBrandedFunctionalTool(value) {
+  return AGENT_TOOL_BRAND in value && "spec" in value && "handler" in value;
+}
+__name(isBrandedFunctionalTool, "isBrandedFunctionalTool");
+function provideAgentTools(factory, inject) {
+  return {
+    provide: /* @__PURE__ */ Symbol("nestjs-agent:functional-tool-list"),
+    useFactory: /* @__PURE__ */ __name(async (...deps) => (await factory(...deps)).map(brand), "useFactory"),
+    inject: inject ?? []
+  };
+}
+__name(provideAgentTools, "provideAgentTools");
+
+// src/genui/agent-genui.module.ts
 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") {
@@ -1135,6 +1251,124 @@ function _ts_decorate5(decorators, target, key, desc) {
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate5, "_ts_decorate");
+var GENUI_CATALOG = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:genui-catalog");
+var GENUI_OPTIONS = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:genui-options");
+var GenuiCatalogResolver = class {
+  static {
+    __name(this, "GenuiCatalogResolver");
+  }
+};
+function resolverProviders(resolver) {
+  if (resolver === void 0) return [];
+  return [
+    typeof resolver === "function" ? {
+      provide: GenuiCatalogResolver,
+      useClass: resolver
+    } : {
+      provide: GenuiCatalogResolver,
+      useValue: resolver
+    }
+  ];
+}
+__name(resolverProviders, "resolverProviders");
+function toolOptions(options, resolver) {
+  const { catalog: _catalog, ...rest } = options;
+  return {
+    ...rest,
+    ...resolver !== void 0 ? {
+      resolveCatalog: /* @__PURE__ */ __name((scope) => resolver.resolve(scope), "resolveCatalog")
+    } : {}
+  };
+}
+__name(toolOptions, "toolOptions");
+function coreProviders(resolver) {
+  return [
+    {
+      provide: GENUI_CATALOG,
+      useFactory: /* @__PURE__ */ __name((options) => options.catalog ?? (0, import_genui.defineCatalog)([]), "useFactory"),
+      inject: [
+        GENUI_OPTIONS
+      ]
+    },
+    ...resolverProviders(resolver),
+    // The generated tools, registered by the agent module's discovery like any `provideAgentTool`.
+    // Built from the injected catalog, so `overrideProvider(GENUI_CATALOG)` changes them too.
+    provideAgentTools((options, catalog, perRequest) => (0, import_genui.genuiTools)(catalog, toolOptions(options, perRequest)), [
+      GENUI_OPTIONS,
+      GENUI_CATALOG,
+      {
+        token: GenuiCatalogResolver,
+        optional: true
+      }
+    ])
+  ];
+}
+__name(coreProviders, "coreProviders");
+var EXPORTS = [
+  GENUI_CATALOG,
+  GENUI_OPTIONS
+];
+var AgentGenuiModule = class _AgentGenuiModule {
+  static {
+    __name(this, "AgentGenuiModule");
+  }
+  static forRoot(options = {}) {
+    const { resolver, ...rest } = options;
+    return {
+      module: _AgentGenuiModule,
+      global: true,
+      providers: [
+        {
+          provide: GENUI_OPTIONS,
+          useValue: rest
+        },
+        ...coreProviders(resolver)
+      ],
+      exports: resolver === void 0 ? EXPORTS : [
+        ...EXPORTS,
+        GenuiCatalogResolver
+      ]
+    };
+  }
+  static forRootAsync(options) {
+    return {
+      module: _AgentGenuiModule,
+      global: true,
+      imports: options.imports ?? [],
+      providers: [
+        {
+          provide: GENUI_OPTIONS,
+          useFactory: options.useFactory,
+          inject: options.inject ?? []
+        },
+        ...coreProviders(options.resolver)
+      ],
+      exports: options.resolver === void 0 ? EXPORTS : [
+        ...EXPORTS,
+        GenuiCatalogResolver
+      ]
+    };
+  }
+};
+AgentGenuiModule = _ts_decorate5([
+  (0, import_common5.Module)({})
+], AgentGenuiModule);
+
+// src/agent-deps.factory.ts
+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_decorate6, "_ts_decorate");
 function _ts_metadata4(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
@@ -1167,7 +1401,9 @@ var AgentDepsFactory2 = class {
   pricingStore;
   skills;
   memory;
-  constructor(options, model, store, sink, rolesPolicy, registry, agents, promptContributors, pricingStore, skills, memory) {
+  uiCatalog;
+  uiCatalogResolver;
+  constructor(options, model, store, sink, rolesPolicy, registry, agents, promptContributors, pricingStore, skills, memory, uiCatalog, uiCatalogResolver) {
     this.options = options;
     this.model = model;
     this.store = store;
@@ -1179,6 +1415,9 @@ var AgentDepsFactory2 = class {
     this.pricingStore = pricingStore;
     this.skills = skills;
     this.memory = memory;
+    this.uiCatalog = uiCatalog;
+    this.uiCatalogResolver = uiCatalogResolver;
+    if (options.actionApprovalMode === "independent") (0, import_nestjs_agent_core8.assertIndependentActionCapabilities)(store, options.backgroundActorResolver);
   }
   /** The turn's memory seam, shared with the read-back endpoint. Undefined → memory is not configured. */
   memoryConfig() {
@@ -1204,7 +1443,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_core9.normalizeDelegation)(edge);
       return delegateToolName({
         target: agent,
         detached
@@ -1218,8 +1457,76 @@ var AgentDepsFactory2 = class {
       ...delegated
     ];
   }
+  /**
+  * The agent a name stands for: itself when it is a registered agent (or unknown — the bare
+  * assistant), else the agent whose persona took the name over (`Persona.aliases`) and that persona.
+  */
+  resolveAgent(name) {
+    if (this.agents.has(name)) {
+      return {
+        agentName: name
+      };
+    }
+    const alias = (0, import_nestjs_agent_core9.resolvePersonaAlias)(this.agents.list(), name);
+    return alias === void 0 ? {
+      agentName: name
+    } : {
+      agentName: alias.agent,
+      persona: alias.persona
+    };
+  }
+  /** `agentName`'s personas as a picker reads them. Empty when it declares none. */
+  personaCatalog(agentName) {
+    return (this.agents.get(agentName)?.personas ?? []).map(import_nestjs_agent_core9.personaCatalogEntry);
+  }
+  /** The persona `agentName` runs under when nothing names one. Undefined → none. */
+  defaultPersona(agentName) {
+    return this.agents.get(agentName)?.defaultPersona;
+  }
+  /**
+  * The persona a turn of `agentName` runs under, most specific first: the one the send names
+  * (refused with `400 persona_not_found` when the agent does not declare it), else the thread's
+  * pinned one when this agent declares it, else the agent's default. Undefined → none.
+  */
+  resolvePersona(args) {
+    const definition = this.agents.get(args.agentName);
+    if (args.requested !== void 0) {
+      if ((0, import_nestjs_agent_core9.findPersona)(definition, args.requested) === void 0) {
+        throw new import_common6.BadRequestException({
+          statusCode: 400,
+          code: "persona_not_found",
+          message: `agent "${args.agentName}" has no persona "${args.requested}"`
+        });
+      }
+      return args.requested;
+    }
+    const pinned = args.threadPersona ?? void 0;
+    if (pinned !== void 0 && (0, import_nestjs_agent_core9.findPersona)(definition, pinned) !== void 0) {
+      return pinned;
+    }
+    return definition?.defaultPersona;
+  }
+  forProposal(proposal, _actor) {
+    const name = proposal.executionContext?.agentName;
+    if (name !== void 0 && !this.agents.has(name) && !(name === "default" && this.defaultAgentName() === "default" && this.agents.list().length === 0)) throw new Error(`Recorded agent ${name} no longer exists`);
+    const deps = this.forAgent(name);
+    const id = proposal.executionContext?.persona;
+    if (id !== void 0) {
+      const persona = deps.personas?.find((persona2) => persona2.id === id);
+      if (!persona) throw new Error(`Recorded persona ${id} no longer exists`);
+      return this.withPersona(deps, persona);
+    }
+    return deps;
+  }
   forAgent(agentName) {
     const name = agentName ?? this.defaultAgentName();
+    if (agentName !== void 0 && !this.agents.has(agentName)) {
+      const alias = (0, import_nestjs_agent_core9.resolvePersonaAlias)(this.agents.list(), agentName);
+      const persona = alias === void 0 ? void 0 : (0, import_nestjs_agent_core9.findPersona)(this.agents.get(alias.agent), alias.persona);
+      if (alias !== void 0 && persona !== void 0) {
+        return this.withPersona(this.forAgent(alias.agent), persona);
+      }
+    }
     const definition = this.agents.get(name);
     const toolAllowList = this.effectiveTools(definition);
     const followUpsCount = this.followUpsCount();
@@ -1229,12 +1536,27 @@ var AgentDepsFactory2 = class {
     return {
       model: this.model,
       store: this.store,
+      ...this.options.actionApprovalMode !== void 0 ? {
+        actionApprovalMode: this.options.actionApprovalMode
+      } : {},
       sink: this.sink,
       rolesPolicy: this.rolesPolicy,
       ...this.options.approvalPolicy !== void 0 ? {
         approvalPolicy: this.options.approvalPolicy
       } : {},
       registry: this.registry,
+      ...this.uiCatalog !== void 0 || this.uiCatalogResolver !== void 0 ? {
+        resolveUiCatalog: /* @__PURE__ */ __name((scope) => {
+          const catalog = this.uiCatalogResolver?.resolve({
+            ...scope,
+            ...scope.actor.tenantRef !== void 0 ? {
+              tenant: scope.actor.tenantRef
+            } : {}
+          }) ?? this.uiCatalog;
+          if (!catalog) throw new Error("UI catalog unavailable");
+          return catalog;
+        }, "resolveUiCatalog")
+      } : {},
       promptContributors: this.promptContributors,
       systemPrompt: definition?.systemPrompt ?? this.options.systemPrompt ?? "You are a helpful assistant.",
       maxSteps: definition?.maxSteps ?? 8,
@@ -1284,6 +1606,9 @@ var AgentDepsFactory2 = class {
       ...toolAllowList !== void 0 ? {
         toolAllowList
       } : {},
+      ...definition?.personas !== void 0 ? {
+        personas: definition.personas
+      } : {},
       ...this.options.toolTimeoutMs !== void 0 ? {
         toolTimeoutMs: this.options.toolTimeoutMs
       } : {},
@@ -1302,6 +1627,45 @@ var AgentDepsFactory2 = class {
     };
   }
   /**
+  * A persona baked into an agent's deps — how a run journaled under an agent name that a persona
+  * has since taken over (`Persona.aliases`) is served. That run names no persona of its own (it
+  * predates them, and its input cannot change), so the persona applies the way the old agent's own
+  * config did: as config, re-read on every replay, with no checkpoint of its own.
+  */
+  withPersona(deps, persona) {
+    const base = deps.systemPrompt;
+    const ref = {
+      id: persona.id,
+      label: persona.label
+    };
+    const resolve = /* @__PURE__ */ __name(async (prompt, ctx) => typeof prompt === "function" ? prompt(ctx) : prompt, "resolve");
+    const own = persona.systemPrompt;
+    const systemPrompt = /* @__PURE__ */ __name(async (ctx) => {
+      const scoped = {
+        ...ctx,
+        persona: ref
+      };
+      if (own === void 0) {
+        return resolve(base, scoped);
+      }
+      const basePrompt = typeof own === "function" ? await resolve(base, scoped) : void 0;
+      return resolve(own, {
+        ...scoped,
+        ...basePrompt !== void 0 ? {
+          basePrompt
+        } : {}
+      });
+    }, "systemPrompt");
+    const toolAllowList = (0, import_nestjs_agent_core9.intersectAllowLists)(deps.toolAllowList, persona.allowedTools);
+    return {
+      ...deps,
+      systemPrompt,
+      ...toolAllowList !== void 0 ? {
+        toolAllowList
+      } : {}
+    };
+  }
+  /**
   * The ceiling on how much of a thread this agent's turns carry, most specific wins: the agent's
   * own `@Agent({ history })`, else a module-wide custom `historyPolicy`, else the module-wide
   * `history` window. Undefined → unbounded, the behaviour of a module that configures none.
@@ -1317,7 +1681,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_core9.windowHistory)({
       ...config.maxMessages !== void 0 ? {
         maxMessages: config.maxMessages
       } : {},
@@ -1327,7 +1691,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_core9.summarizeWithModel)(this.model)
       } : {}
     });
   }
@@ -1343,22 +1707,25 @@ 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)),
+AgentDepsFactory2 = _ts_decorate6([
+  (0, import_common6.Injectable)(),
+  _ts_param4(0, (0, import_common6.Inject)(import_nestjs_agent_core10.AGENT_OPTIONS)),
+  _ts_param4(1, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_MODEL)),
+  _ts_param4(2, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_STORE)),
+  _ts_param4(3, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_SINK)),
+  _ts_param4(4, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_ROLES_POLICY)),
+  _ts_param4(5, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_TOOL_REGISTRY)),
+  _ts_param4(6, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_REGISTRY)),
+  _ts_param4(7, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_PROMPT_CONTRIBUTORS)),
+  _ts_param4(8, (0, import_common6.Optional)()),
+  _ts_param4(8, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_PRICING_STORE)),
+  _ts_param4(9, (0, import_common6.Optional)()),
+  _ts_param4(9, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_SKILLS)),
+  _ts_param4(10, (0, import_common6.Optional)()),
+  _ts_param4(10, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_MEMORY)),
+  _ts_param4(11, (0, import_common6.Optional)()),
+  _ts_param4(11, (0, import_common6.Inject)(GENUI_CATALOG)),
+  _ts_param4(12, (0, import_common6.Optional)()),
   _ts_metadata4("design:type", Function),
   _ts_metadata4("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
@@ -1366,23 +1733,25 @@ AgentDepsFactory2 = _ts_decorate5([
     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_core9.ToolRegistry === "undefined" ? Object : import_nestjs_agent_core9.ToolRegistry,
+    typeof import_nestjs_agent_core9.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core9.AgentRegistry,
     Array,
     Object,
     Object,
-    Object
+    Object,
+    typeof Catalog === "undefined" ? Object : Catalog,
+    typeof GenuiCatalogResolver === "undefined" ? Object : GenuiCatalogResolver
   ])
 ], AgentDepsFactory2);
 
 // src/agent.service.ts
-var import_nestjs_agent_core10 = require("@dudousxd/nestjs-agent-core");
-var import_common8 = require("@nestjs/common");
+var import_nestjs_agent_core14 = require("@dudousxd/nestjs-agent-core");
+var import_common10 = require("@nestjs/common");
 
-// src/queue/chat-queue.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) {
+// src/proposals/action-proposal.service.ts
+var import_nestjs_agent_core11 = 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);
@@ -1395,7 +1764,7 @@ function _ts_decorate6(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate6, "_ts_decorate");
+__name(_ts_decorate7, "_ts_decorate");
 function _ts_metadata5(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
@@ -1408,6 +1777,168 @@ function _ts_param5(paramIndex, decorator) {
   };
 }
 __name(_ts_param5, "_ts_param");
+var ActionProposalService = class {
+  static {
+    __name(this, "ActionProposalService");
+  }
+  store;
+  options;
+  constructor(store, options) {
+    this.store = store;
+    this.options = options;
+  }
+  capability() {
+    const store = this.store;
+    if (typeof store.getThreadActionProposalScope !== "function" || typeof store.listActionProposals !== "function") throw new import_common7.NotImplementedException("Action proposals are unavailable");
+    return store;
+  }
+  async scope(threadId, actor) {
+    const scope = await this.capability().getThreadActionProposalScope(threadId);
+    if (!scope) throw new import_common7.NotFoundException("Thread not found");
+    if (scope.tenantRef !== (actor.tenantRef ?? null)) throw new import_common7.ForbiddenException("Wrong proposal tenant");
+    return scope;
+  }
+  mayDecide(actor, proposal) {
+    return (0, import_nestjs_agent_core11.mayDecideApproval)(this.options.approvalPolicy, actor, {
+      toolCallId: proposal.originToolCallId,
+      approver: proposal.approver,
+      requesterRef: proposal.actorRef
+    });
+  }
+  async listPage(threadId, actor, query = {}) {
+    const scope = await this.scope(threadId, actor);
+    const rows = await this.capability().listActionProposals(scope, {
+      limit: 1e3,
+      ...query
+    });
+    const visible = [];
+    for (const row of rows) if (scope.actorRef === actor.id || await this.mayDecide(actor, row)) visible.push(row);
+    const last = rows.at(-1);
+    return {
+      items: visible,
+      ...rows.length === 1e3 && last ? {
+        next: {
+          createdAt: last.createdAt,
+          id: last.id
+        }
+      } : {}
+    };
+  }
+  async list(threadId, actor) {
+    return (await this.listPage(threadId, actor)).items;
+  }
+  async decide(threadId, proposalId, actor, command) {
+    const scope = await this.scope(threadId, actor);
+    const proposal = await this.capability().getActionProposal(scope, proposalId);
+    if (!proposal) throw new import_common7.NotFoundException("Proposal not found");
+    if (!await this.mayDecide(actor, proposal)) throw new import_common7.ForbiddenException("May not decide this proposal");
+    return this.capability().decideActionProposal(scope, proposalId, {
+      decision: command.decision,
+      actorRef: actor.id,
+      via: command.via ?? "web",
+      ...command.remember !== void 0 ? {
+        remember: command.remember
+      } : {},
+      ...command.reason !== void 0 ? {
+        reason: command.reason
+      } : {}
+    });
+  }
+  async handleTextDecision(threadId, actor, text) {
+    const command = (0, import_nestjs_agent_core11.parseTextActionProposalCommand)(text);
+    if (command.status === "unmatched") return command;
+    if (command.proposalId !== void 0) {
+      const result2 = await this.decide(threadId, command.proposalId, actor, {
+        decision: command.decision,
+        remember: command.remember,
+        via: "text"
+      });
+      return this.textReceipt(threadId, result2);
+    }
+    const candidates = [];
+    const scope = await this.scope(threadId, actor);
+    const pending = await this.capability().listActionProposals(scope, {
+      decision: "pending",
+      limit: 1e3
+    });
+    for (const proposal of pending) if (await this.mayDecide(actor, proposal)) candidates.push(proposal);
+    const resolution = (0, import_nestjs_agent_core11.resolveTextActionProposalDecision)(text, candidates);
+    if (resolution.status === "unmatched") return resolution;
+    if (resolution.status === "ambiguous" || resolution.status === "decision" && pending.length === 1e3 && !text.includes("#")) return {
+      threadId,
+      proposalDecision: {
+        status: "ambiguous",
+        proposalIds: candidates.map(({ id }) => id)
+      },
+      text: `Choose the action to decide: ${candidates.map(({ id }) => id).map((id) => `#${id}`).join(", ")}`
+    };
+    const result = await this.decide(threadId, resolution.proposalId, actor, {
+      decision: resolution.decision,
+      remember: resolution.remember,
+      via: "text"
+    });
+    return this.textReceipt(threadId, result);
+  }
+  textReceipt(threadId, result) {
+    return {
+      threadId,
+      proposalDecision: result,
+      text: result.proposal?.decision === "approved" ? "Action approved and queued for execution." : `Action ${result.proposal?.decision ?? result.status}; no execution was performed by this decision.`
+    };
+  }
+};
+ActionProposalService = _ts_decorate7([
+  (0, import_common7.Injectable)(),
+  _ts_param5(0, (0, import_common7.Inject)(import_nestjs_agent_core11.AGENT_STORE)),
+  _ts_param5(1, (0, import_common7.Inject)(import_nestjs_agent_core11.AGENT_OPTIONS)),
+  _ts_metadata5("design:type", Function),
+  _ts_metadata5("design:paramtypes", [
+    typeof AgentStore === "undefined" ? Object : AgentStore,
+    typeof Pick === "undefined" ? Object : Pick
+  ])
+], ActionProposalService);
+
+// src/queue/chat-queue.service.ts
+var import_nestjs_agent_core12 = require("@dudousxd/nestjs-agent-core");
+var import_common8 = require("@nestjs/common");
+
+// src/thread-persona.ts
+async function threadPersona(store, threadId) {
+  const projecting = store;
+  if (typeof projecting.personaForThread === "function") {
+    return projecting.personaForThread(threadId);
+  }
+  return (await store.getThread(threadId))?.persona ?? null;
+}
+__name(threadPersona, "threadPersona");
+
+// src/queue/chat-queue.service.ts
+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_decorate8, "_ts_decorate");
+function _ts_metadata6(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
+}
+__name(_ts_metadata6, "_ts_metadata");
+function _ts_param6(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param6, "_ts_param");
 var MAX_DRAIN_ATTEMPTS = 8;
 var ChatQueueService2 = class _ChatQueueService {
   static {
@@ -1418,27 +1949,29 @@ var ChatQueueService2 = class _ChatQueueService {
   quotaProvider;
   options;
   staging;
-  logger = new import_common6.Logger(_ChatQueueService.name);
+  deps;
+  logger = new import_common8.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) {
+  constructor(store, sink, quotaProvider, options, staging, deps) {
     this.store = store;
     this.sink = sink;
     this.quotaProvider = quotaProvider;
     this.options = options;
     this.staging = staging;
+    this.deps = deps;
   }
   /** Whether the bound store can hold a queue. Without one, a busy thread is not queued. */
   get supported() {
-    return (0, import_nestjs_agent_core8.isChatQueueStore)(this.store);
+    return (0, import_nestjs_agent_core12.isChatQueueStore)(this.store);
   }
   /** The bound store as a queue store, or a 501 naming what is missing. */
   queueStore() {
-    if (!(0, import_nestjs_agent_core8.isChatQueueStore)(this.store)) {
-      throw new import_common6.NotImplementedException("Queueing messages requires an AgentStore that implements ChatQueueStore (enqueueMessage, listQueue, \u2026, claimActiveStream, releaseActiveStream); the bound store does not.");
+    if (!(0, import_nestjs_agent_core12.isChatQueueStore)(this.store)) {
+      throw new import_common8.NotImplementedException("Queueing messages requires an AgentStore that implements ChatQueueStore (enqueueMessage, listQueue, \u2026, claimActiveStream, releaseActiveStream); the bound store does not.");
     }
     return this.store;
   }
@@ -1449,7 +1982,7 @@ var ChatQueueService2 = class _ChatQueueService {
       store.queuePause(threadId)
     ]);
     return {
-      items: items.map(import_nestjs_agent_core8.queuedMessageView),
+      items: items.map(import_nestjs_agent_core12.queuedMessageView),
       paused
     };
   }
@@ -1500,7 +2033,7 @@ var ChatQueueService2 = class _ChatQueueService {
   * A no-op returning `{}` on a store without a queue.
   */
   async plan(args) {
-    if (!(0, import_nestjs_agent_core8.isChatQueueStore)(this.store)) {
+    if (!(0, import_nestjs_agent_core12.isChatQueueStore)(this.store)) {
       return {};
     }
     const store = this.store;
@@ -1600,7 +2133,7 @@ var ChatQueueService2 = class _ChatQueueService {
   * (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_core8.isChatQueueStore)(this.store)) {
+    if (!(0, import_nestjs_agent_core12.isChatQueueStore)(this.store)) {
       return void 0;
     }
     const { live, stale } = await this.holder(threadId, runner);
@@ -1665,6 +2198,9 @@ var ChatQueueService2 = class _ChatQueueService {
       } : {},
       ...input.pageContext !== void 0 ? {
         pageContext: input.pageContext
+      } : {},
+      ...input.uiCapabilities !== void 0 ? {
+        uiCapabilities: input.uiCapabilities
       } : {}
     });
     await store.setQueuePause(threadId, {
@@ -1701,7 +2237,7 @@ var ChatQueueService2 = class _ChatQueueService {
   }
   async write(runId, frame) {
     const writer = await this.sink.open(runId);
-    await writer.write((0, import_nestjs_agent_core8.encodeStreamEvent)(frame));
+    await writer.write((0, import_nestjs_agent_core12.encodeStreamEvent)(frame));
   }
   /** Why `actor` may not start a turn now (the quota message), or `null`. */
   async quotaBlock(actor) {
@@ -1727,13 +2263,17 @@ var ChatQueueService2 = class _ChatQueueService {
   */
   async inputFor(message) {
     const attachments = await this.freshAttachments(message.actor, message.attachments ?? []);
+    const { agentName, persona } = await this.targetFor(message);
     return {
       threadId: message.threadId,
       actor: message.actor,
       userText: message.content,
       day: utcDay(),
-      ...message.agentName !== void 0 ? {
-        agentName: message.agentName
+      ...agentName !== void 0 ? {
+        agentName
+      } : {},
+      ...persona !== void 0 ? {
+        persona
       } : {},
       ...attachments.length > 0 ? {
         attachments
@@ -1741,13 +2281,47 @@ var ChatQueueService2 = class _ChatQueueService {
       ...message.pageContext !== void 0 ? {
         pageContext: message.pageContext
       } : {},
+      ...message.uiCapabilities !== void 0 ? {
+        uiCapabilities: message.uiCapabilities
+      } : {},
       ...message.model !== void 0 ? {
         model: message.model
       } : {}
     };
   }
-  async freshAttachments(actor, attachments) {
-    const staging = this.staging;
+  /**
+  * The agent and persona a queued message starts as. A message carries the persona its send
+  * resolved; one that carries none — queued before personas existed, or by a host that sets none —
+  * resolves it now, exactly as a send would: an agent name a persona took over, then the thread's
+  * pinned persona, then the agent's default. Never refused here: nobody is waiting on a 400.
+  */
+  async targetFor(message) {
+    const deps = this.deps;
+    if (message.persona !== void 0 || deps === void 0 || message.agentName === void 0) {
+      return {
+        ...message.agentName !== void 0 ? {
+          agentName: message.agentName
+        } : {},
+        ...message.persona !== void 0 ? {
+          persona: message.persona
+        } : {}
+      };
+    }
+    const target = deps.resolveAgent(message.agentName);
+    const hasPersonas = deps.personaCatalog(target.agentName).length > 0;
+    const persona = target.persona ?? (hasPersonas ? deps.resolvePersona({
+      agentName: target.agentName,
+      threadPersona: await threadPersona(this.store, message.threadId)
+    }) : void 0);
+    return {
+      agentName: target.agentName,
+      ...persona !== void 0 ? {
+        persona
+      } : {}
+    };
+  }
+  async freshAttachments(actor, attachments) {
+    const staging = this.staging;
     if (attachments.length === 0 || staging === void 0 || typeof staging.resolve !== "function") {
       return attachments;
     }
@@ -1763,23 +2337,26 @@ var ChatQueueService2 = class _ChatQueueService {
     }));
   }
 };
-ChatQueueService2 = _ts_decorate6([
-  (0, import_common6.Injectable)(),
-  _ts_param5(0, (0, import_common6.Inject)(import_nestjs_agent_core8.AGENT_STORE)),
-  _ts_param5(1, (0, import_common6.Inject)(import_nestjs_agent_core8.AGENT_SINK)),
-  _ts_param5(2, (0, import_common6.Optional)()),
-  _ts_param5(2, (0, import_common6.Inject)(import_nestjs_agent_core8.AGENT_QUOTA_PROVIDER)),
-  _ts_param5(3, (0, import_common6.Optional)()),
-  _ts_param5(3, (0, import_common6.Inject)(import_nestjs_agent_core8.AGENT_OPTIONS)),
-  _ts_param5(4, (0, import_common6.Optional)()),
-  _ts_param5(4, (0, import_common6.Inject)(import_nestjs_agent_core8.AGENT_ATTACHMENT_STAGING)),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+ChatQueueService2 = _ts_decorate8([
+  (0, import_common8.Injectable)(),
+  _ts_param6(0, (0, import_common8.Inject)(import_nestjs_agent_core12.AGENT_STORE)),
+  _ts_param6(1, (0, import_common8.Inject)(import_nestjs_agent_core12.AGENT_SINK)),
+  _ts_param6(2, (0, import_common8.Optional)()),
+  _ts_param6(2, (0, import_common8.Inject)(import_nestjs_agent_core12.AGENT_QUOTA_PROVIDER)),
+  _ts_param6(3, (0, import_common8.Optional)()),
+  _ts_param6(3, (0, import_common8.Inject)(import_nestjs_agent_core12.AGENT_OPTIONS)),
+  _ts_param6(4, (0, import_common8.Optional)()),
+  _ts_param6(4, (0, import_common8.Inject)(import_nestjs_agent_core12.AGENT_ATTACHMENT_STAGING)),
+  _ts_param6(5, (0, import_common8.Optional)()),
+  _ts_param6(5, (0, import_common8.Inject)(import_nestjs_agent_core12.AGENT_DEPS_FACTORY)),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("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
+    typeof AttachmentStagingStore === "undefined" ? Object : AttachmentStagingStore,
+    typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory
   ])
 ], ChatQueueService2);
 function pauseReasonFor(outcome, head) {
@@ -1796,7 +2373,7 @@ function queueFrame(items, paused, started) {
   return {
     kind: "queue",
     queue: {
-      items: items.map(import_nestjs_agent_core8.queuedMessageView),
+      items: items.map(import_nestjs_agent_core12.queuedMessageView),
       paused
     },
     ...started !== void 0 ? {
@@ -1807,25 +2384,25 @@ function queueFrame(items, paused, started) {
 __name(queueFrame, "queueFrame");
 
 // src/run-not-active.exception.ts
-var import_nestjs_agent_core9 = require("@dudousxd/nestjs-agent-core");
-var import_common7 = require("@nestjs/common");
-var RunNotActiveException = class extends import_common7.ConflictException {
+var import_nestjs_agent_core13 = require("@dudousxd/nestjs-agent-core");
+var import_common9 = require("@nestjs/common");
+var RunNotActiveException = class extends import_common9.ConflictException {
   static {
     __name(this, "RunNotActiveException");
   }
   runId;
-  code = import_nestjs_agent_core9.RUN_NOT_ACTIVE_CODE;
+  code = import_nestjs_agent_core13.RUN_NOT_ACTIVE_CODE;
   constructor(runId) {
     super({
       statusCode: 409,
-      code: import_nestjs_agent_core9.RUN_NOT_ACTIVE_CODE,
-      message: import_nestjs_agent_core9.RUN_NOT_ACTIVE_MESSAGE
+      code: import_nestjs_agent_core13.RUN_NOT_ACTIVE_CODE,
+      message: import_nestjs_agent_core13.RUN_NOT_ACTIVE_MESSAGE
     }), this.runId = runId;
   }
 };
 
 // src/agent.service.ts
-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);
@@ -1838,19 +2415,19 @@ 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_decorate9, "_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");
-function _ts_param6(paramIndex, decorator) {
+__name(_ts_metadata7, "_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 AgentService = class {
   static {
     __name(this, "AgentService");
@@ -1863,7 +2440,8 @@ var AgentService = class {
   quotaProvider;
   options;
   queue;
-  constructor(runner, store, deps, staging, models, quotaProvider, options, queue) {
+  proposals;
+  constructor(runner, store, deps, staging, models, quotaProvider, options, queue, proposals) {
     this.runner = runner;
     this.store = store;
     this.deps = deps;
@@ -1872,6 +2450,13 @@ var AgentService = class {
     this.quotaProvider = quotaProvider;
     this.options = options;
     this.queue = queue;
+    this.proposals = proposals;
+  }
+  async handleTextDecision(threadId, actor, text) {
+    if (this.options?.actionApprovalMode !== "independent" || !this.proposals) return {
+      status: "unmatched"
+    };
+    return this.proposals.handleTextDecision(threadId, actor, text);
   }
   /** The queue service when the bound store can hold a queue, else `undefined`. */
   queueing() {
@@ -1881,7 +2466,7 @@ var AgentService = class {
   requireQueue() {
     const queue = this.queueing();
     if (queue === void 0) {
-      throw new import_common8.NotImplementedException("Queueing messages requires an AgentStore that implements ChatQueueStore; the bound store does not.");
+      throw new import_common10.NotImplementedException("Queueing messages requires an AgentStore that implements ChatQueueStore; the bound store does not.");
     }
     return queue;
   }
@@ -1918,12 +2503,12 @@ var AgentService = class {
       actor
     });
     if (blocked !== void 0) {
-      throw new import_common8.HttpException({
-        statusCode: import_common8.HttpStatus.TOO_MANY_REQUESTS,
+      throw new import_common10.HttpException({
+        statusCode: import_common10.HttpStatus.TOO_MANY_REQUESTS,
         code: "quota_exceeded",
         period: blocked.period,
         message: blocked.reason ?? `The ${blocked.period === "day" ? "daily" : "monthly"} quota is used up`
-      }, import_common8.HttpStatus.TOO_MANY_REQUESTS);
+      }, import_common10.HttpStatus.TOO_MANY_REQUESTS);
     }
   }
   /**
@@ -1951,17 +2536,17 @@ var AgentService = class {
   */
   async assertModelAllowed(actor, agent, model) {
     if (this.models === void 0) {
-      throw new import_common8.BadRequestException(`model "${model}" cannot be selected: no ModelCatalog is configured (AgentModule.forRoot({ models }))`);
+      throw new import_common10.BadRequestException(`model "${model}" cannot be selected: no ModelCatalog is configured (AgentModule.forRoot({ models }))`);
     }
-    const entry = (0, import_nestjs_agent_core10.findCatalogModel)(await this.models.list({
+    const entry = (0, import_nestjs_agent_core14.findCatalogModel)(await this.models.list({
       actor,
       agent
     }), model);
     if (entry === void 0) {
-      throw new import_common8.BadRequestException(`model "${model}" is not offered`);
+      throw new import_common10.BadRequestException(`model "${model}" is not offered`);
     }
     if (!entry.available) {
-      throw new import_common8.BadRequestException(`model "${model}" is not available${entry.unavailableReason ? `: ${entry.unavailableReason}` : ""}`);
+      throw new import_common10.BadRequestException(`model "${model}" is not available${entry.unavailableReason ? `: ${entry.unavailableReason}` : ""}`);
     }
     return entry.id;
   }
@@ -1977,7 +2562,7 @@ var AgentService = class {
     })).locked : void 0;
     if (locked !== void 0) {
       if (requested !== void 0 && requested !== locked.model) {
-        throw new import_common8.BadRequestException(`model "${requested}" cannot be selected: ${locked.reason ?? `this agent always uses "${locked.model}"`}`);
+        throw new import_common10.BadRequestException(`model "${requested}" cannot be selected: ${locked.reason ?? `this agent always uses "${locked.model}"`}`);
       }
       return locked.model;
     }
@@ -2003,7 +2588,10 @@ var AgentService = class {
     const result = await this.send({
       ...params,
       mode: "auto"
+    }, {
+      textDecisions: false
     });
+    if ("proposalDecision" in result) throw new Error("Unexpected text decision in run-only API");
     if (result.queued !== true) {
       return result;
     }
@@ -2021,7 +2609,7 @@ var AgentService = class {
       };
     }
     await this.requireQueue().publish(result.threadId);
-    throw new import_common8.ConflictException({
+    throw new import_common10.ConflictException({
       statusCode: 409,
       code: "run_active",
       message: `thread ${result.threadId} already has a turn running`
@@ -2031,15 +2619,21 @@ var AgentService = class {
   * 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) {
+  async send(params, sendOptions = {}) {
+    if (sendOptions.textDecisions !== false && this.options?.actionApprovalMode === "independent" && params.threadId !== void 0 && params.regenerate !== true && this.proposals) {
+      const decision = await this.proposals.handleTextDecision(params.threadId, params.actor, params.message);
+      if ("proposalDecision" in decision) return decision;
+    }
     await this.assertWithinQuota(params.actor);
-    const agentName = await this.resolveAgentName(params.agentName, params.threadId);
+    const target = this.deps.resolveAgent(await this.resolveAgentName(params.agentName, params.threadId));
+    const agentName = target.agentName;
+    const persona = await this.resolvePersona(agentName, params.personaId ?? target.persona, params.threadId);
     const model = await this.resolveModel(params.actor, agentName, params.model, params.threadId);
     const attachments = await this.resolveAttachments(params.actor, params.attachments ?? []);
     let threadId = params.threadId;
     if (threadId === void 0) {
       if (params.regenerate === true) {
-        throw new import_common8.BadRequestException("regenerate requires an existing threadId");
+        throw new import_common10.BadRequestException("regenerate requires an existing threadId");
       }
       const created = await this.store.createThread({
         actor: params.actor,
@@ -2048,11 +2642,17 @@ var AgentService = class {
         } : {},
         ...params.newThreadId !== void 0 ? {
           id: params.newThreadId
+        } : {},
+        ...params.personaId !== void 0 ? {
+          persona: params.personaId
         } : {}
       });
       threadId = created.id;
     } else {
       await this.assertOwnsThread(params.actor, threadId);
+      if (params.personaId !== void 0) {
+        await this.pinThreadPersona(threadId, params.personaId);
+      }
     }
     const input = {
       threadId,
@@ -2060,6 +2660,9 @@ var AgentService = class {
       userText: params.message,
       day: utcDay(),
       agentName,
+      ...persona !== void 0 ? {
+        persona
+      } : {},
       ...params.regenerate === true ? {
         regenerate: true
       } : {},
@@ -2069,12 +2672,16 @@ var AgentService = class {
       ...params.pageContext !== void 0 ? {
         pageContext: params.pageContext
       } : {},
+      ...params.uiCapabilities !== void 0 ? {
+        uiCapabilities: params.uiCapabilities
+      } : {},
       ...model !== void 0 ? {
         model
       } : {}
     };
     const queue = this.queueing();
     if (queue === void 0) {
+      if (this.options?.actionApprovalMode === "independent") throw new Error("Independent actions require queued thread admission");
       const { runId } = await this.runner.start(input);
       await this.store.setActiveStream(threadId, runId);
       return {
@@ -2085,7 +2692,7 @@ var AgentService = class {
     const mode = params.mode ?? "auto";
     const { live, stale } = await queue.holder(threadId, this.runner);
     if (stale !== null) {
-      await (0, import_nestjs_agent_core10.settleDeadRun)(this.store, {
+      await (0, import_nestjs_agent_core14.settleDeadRun)(this.store, {
         runId: stale
       });
     }
@@ -2101,7 +2708,7 @@ var AgentService = class {
       }
     }
     if (params.regenerate === true) {
-      throw new import_common8.ConflictException({
+      throw new import_common10.ConflictException({
         statusCode: 409,
         code: "run_active",
         message: "cannot regenerate while a turn is running on this thread"
@@ -2146,12 +2753,18 @@ var AgentService = class {
       ...input.agentName !== void 0 ? {
         agentName: input.agentName
       } : {},
+      ...input.persona !== void 0 ? {
+        persona: input.persona
+      } : {},
       ...input.model !== void 0 ? {
         model: input.model
       } : {},
       ...input.pageContext !== void 0 ? {
         pageContext: input.pageContext
       } : {},
+      ...input.uiCapabilities !== void 0 ? {
+        uiCapabilities: input.uiCapabilities
+      } : {},
       ...interrupting !== void 0 ? {
         interrupt: true,
         at: "head"
@@ -2198,7 +2811,7 @@ var AgentService = class {
     const store = queue.queueStore();
     const threadId = await this.assertOwnsQueuedMessage(actor, messageId);
     if (patch.message !== void 0 && patch.message.trim().length === 0) {
-      throw new import_common8.BadRequestException("message must not be empty");
+      throw new import_common10.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) {
@@ -2211,15 +2824,15 @@ var AgentService = class {
         } : {}
       });
       if (updated === null) {
-        throw new import_common8.GoneException(`queued message ${messageId} already started or was removed`);
+        throw new import_common10.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_common8.BadRequestException("position must be a non-negative integer");
+        throw new import_common10.BadRequestException("position must be a non-negative integer");
       }
       if (!await store.moveQueuedMessage(messageId, patch.position)) {
-        throw new import_common8.GoneException(`queued message ${messageId} already started or was removed`);
+        throw new import_common10.GoneException(`queued message ${messageId} already started or was removed`);
       }
     }
     return queue.publish(threadId);
@@ -2229,7 +2842,7 @@ var AgentService = class {
     const queue = this.requireQueue();
     const threadId = await this.assertOwnsQueuedMessage(actor, messageId);
     if (!await queue.queueStore().removeQueuedMessage(messageId)) {
-      throw new import_common8.GoneException(`queued message ${messageId} already started or was removed`);
+      throw new import_common10.GoneException(`queued message ${messageId} already started or was removed`);
     }
     return queue.publish(threadId);
   }
@@ -2248,7 +2861,7 @@ var AgentService = class {
     const queue = this.requireQueue();
     const store = queue.queueStore();
     const threadId = await this.assertOwnsQueuedMessage(actor, messageId);
-    const gone = /* @__PURE__ */ __name(() => new import_common8.GoneException(`queued message ${messageId} already started or was removed`), "gone");
+    const gone = /* @__PURE__ */ __name(() => new import_common10.GoneException(`queued message ${messageId} already started or was removed`), "gone");
     const marked = await store.updateQueuedMessage(messageId, {
       interrupt: true
     });
@@ -2256,7 +2869,7 @@ var AgentService = class {
       throw gone();
     }
     if (marked.interrupt !== true) {
-      throw new import_common8.NotImplementedException("Interrupting a queued message requires a ChatQueueStore whose updateQueuedMessage stores `interrupt`; the bound store ignored it.");
+      throw new import_common10.NotImplementedException("Interrupting a queued message requires a ChatQueueStore whose updateQueuedMessage stores `interrupt`; the bound store ignored it.");
     }
     if (!await store.moveQueuedMessage(messageId, 0)) {
       throw gone();
@@ -2315,7 +2928,7 @@ var AgentService = class {
   async assertOwnsQueuedMessage(actor, messageId) {
     const message = await this.requireQueue().queueStore().getQueuedMessage(messageId);
     if (message === null) {
-      throw new import_common8.NotFoundException(`queued message ${messageId} not found`);
+      throw new import_common10.NotFoundException(`queued message ${messageId} not found`);
     }
     await this.assertOwnsThread(actor, message.threadId);
     return message.threadId;
@@ -2336,7 +2949,7 @@ var AgentService = class {
     }
     const staging = this.staging;
     if (staging === void 0 || typeof staging.resolve !== "function") {
-      throw new import_common8.NotImplementedException("Message attachments require an AGENT_ATTACHMENT_STAGING provider implementing resolve(); attachment urls are never taken from the request.");
+      throw new import_common10.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) {
@@ -2345,7 +2958,7 @@ var AgentService = class {
         actor
       });
       if (attachment === null) {
-        throw new import_common8.ForbiddenException(`attachment ${ref.mediaId} is not available to this actor`);
+        throw new import_common10.ForbiddenException(`attachment ${ref.mediaId} is not available to this actor`);
       }
       resolved.push(attachment);
     }
@@ -2447,6 +3060,7 @@ var AgentService = class {
   * not the thread's own actor).
   */
   async signalToolCall(toolCallId2, reply) {
+    if ((await this.store.toolCallApproval?.(toolCallId2))?.status === "proposed") throw new import_common10.ConflictException("Independent proposals require the scoped proposal decision route");
     await this.assertNotExpired(toolCallId2);
     const runId = await this.resolveRunForToolCall(toolCallId2);
     await this.assertRunWaiting(runId);
@@ -2467,7 +3081,7 @@ var AgentService = class {
     if (active) {
       return;
     }
-    await (0, import_nestjs_agent_core10.settleDeadRun)(this.store, {
+    await (0, import_nestjs_agent_core14.settleDeadRun)(this.store, {
       runId
     });
     throw new RunNotActiveException(runId);
@@ -2487,7 +3101,7 @@ var AgentService = class {
       throw new RunNotActiveException(runId);
     }
     if (owner !== actor.id) {
-      throw new import_common8.ForbiddenException("run belongs to another actor");
+      throw new import_common10.ForbiddenException("run belongs to another actor");
     }
   }
   /**
@@ -2540,16 +3154,22 @@ var AgentService = class {
   async updateThread(actor, threadId, patch) {
     const title = patch.title !== void 0 ? this.validateTitle(patch.title) : void 0;
     await this.assertOwnsThread(actor, threadId);
-    if (patch.defaultAgent === void 0 && patch.model === void 0) {
+    if (patch.defaultAgent === void 0 && patch.model === void 0 && patch.persona === void 0) {
       if (title !== void 0) {
         await this.store.setTitle(threadId, title);
       }
       return;
     }
     if (this.store.updateThread === void 0) {
-      throw new import_common8.NotImplementedException("Setting a thread's defaultAgent or model requires an AgentStore that implements updateThread(); the bound store does not support it.");
+      throw new import_common10.NotImplementedException("Setting a thread's defaultAgent, model or persona 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);
+    if (patch.persona !== void 0 && patch.persona !== null) {
+      this.deps.resolvePersona({
+        agentName: this.deps.resolveAgent(patch.defaultAgent ?? await this.resolveAgentName(void 0, threadId)).agentName,
+        requested: patch.persona
+      });
+    }
     await this.store.updateThread(threadId, {
       ...title !== void 0 ? {
         title
@@ -2559,16 +3179,46 @@ var AgentService = class {
       } : {},
       ...model !== void 0 ? {
         model
+      } : {},
+      ...patch.persona !== void 0 ? {
+        persona: patch.persona
+      } : {}
+    });
+  }
+  /**
+  * The persona this send runs under — see {@link AgentDepsFactory.resolvePersona}. The thread's
+  * pinned persona is read only when the send names none AND the agent has personas to pick from.
+  */
+  async resolvePersona(agentName, requested, threadId) {
+    const needsThread = requested === void 0 && threadId !== void 0 && this.deps.personaCatalog(agentName).length > 0;
+    return this.deps.resolvePersona({
+      agentName,
+      ...requested !== void 0 ? {
+        requested
+      } : {},
+      ...needsThread ? {
+        threadPersona: await threadPersona(this.store, threadId)
       } : {}
     });
   }
+  /** Pin `persona` on the thread when it is not already — a no-op on a store that cannot. */
+  async pinThreadPersona(threadId, persona) {
+    if (this.store.updateThread === void 0) {
+      return;
+    }
+    if (await threadPersona(this.store, threadId) !== persona) {
+      await this.store.updateThread(threadId, {
+        persona
+      });
+    }
+  }
   validateTitle(title) {
     const trimmed = title.trim();
     if (trimmed.length === 0) {
-      throw new import_common8.BadRequestException("title must not be empty");
+      throw new import_common10.BadRequestException("title must not be empty");
     }
     if (trimmed.length > 200) {
-      throw new import_common8.BadRequestException("title must be at most 200 characters");
+      throw new import_common10.BadRequestException("title must be at most 200 characters");
     }
     return trimmed;
   }
@@ -2607,6 +3257,7 @@ var AgentService = class {
       ...thread,
       defaultAgent: thread.defaultAgent ?? null,
       model: thread.model ?? null,
+      persona: thread.persona ?? null,
       activeRunId: await this.store.activeRunForThread?.(thread.id) ?? thread.activeRunId ?? null
     };
   }
@@ -2671,21 +3322,21 @@ var AgentService = class {
   */
   async setMessageFeedback(actor, messageId, input) {
     if (input.value !== null && input.value !== "up" && input.value !== "down") {
-      throw new import_common8.BadRequestException("value must be 'up', 'down' or null");
+      throw new import_common10.BadRequestException("value must be 'up', 'down' or null");
     }
     if (input.comment !== void 0 && typeof input.comment !== "string") {
-      throw new import_common8.BadRequestException("comment must be a string");
+      throw new import_common10.BadRequestException("comment must be a string");
     }
     const comment = input.comment?.trim();
     if (comment !== void 0 && comment.length > 2e3) {
-      throw new import_common8.BadRequestException("comment must be at most 2000 characters");
+      throw new import_common10.BadRequestException("comment must be at most 2000 characters");
     }
     if (this.store.threadOfMessage === void 0 || this.store.setMessageFeedback === void 0) {
-      throw new import_common8.NotImplementedException("Message feedback requires an AgentStore that implements threadOfMessage() and setMessageFeedback(); the bound store does not support it.");
+      throw new import_common10.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_common8.NotFoundException(`message ${messageId} not found`);
+      throw new import_common10.NotFoundException(`message ${messageId} not found`);
     }
     await this.assertOwnsThread(actor, threadId);
     const feedback = input.value === null ? null : {
@@ -2733,7 +3384,7 @@ var AgentService = class {
     const list = this.attachmentInventory();
     const referencedMediaIds = this.store.referencedMediaIds?.bind(this.store);
     if (referencedMediaIds === void 0) {
-      throw new import_common8.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_common10.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({
@@ -2755,7 +3406,7 @@ var AgentService = class {
   attachmentInventory() {
     const list = this.staging?.list?.bind(this.staging);
     if (list === void 0) {
-      throw new import_common8.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_common10.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;
   }
@@ -2766,10 +3417,10 @@ var AgentService = class {
   async assertOwnsThread(actor, threadId) {
     const owner = await this.store.ownerOfThread(threadId);
     if (owner === null) {
-      throw new import_common8.NotFoundException(`thread ${threadId} not found`);
+      throw new import_common10.NotFoundException(`thread ${threadId} not found`);
     }
     if (owner !== actor.id) {
-      throw new import_common8.ForbiddenException("thread belongs to another actor");
+      throw new import_common10.ForbiddenException("thread belongs to another actor");
     }
   }
   /**
@@ -2780,10 +3431,10 @@ var AgentService = class {
   async assertOwnsToolCall(actor, toolCallId2) {
     const owner = await this.store.ownerOfToolCall(toolCallId2);
     if (owner === null) {
-      throw new import_common8.NotFoundException(`tool call ${toolCallId2} not found`);
+      throw new import_common10.NotFoundException(`tool call ${toolCallId2} not found`);
     }
     if (owner !== actor.id) {
-      throw new import_common8.ForbiddenException("tool call belongs to another actor");
+      throw new import_common10.ForbiddenException("tool call belongs to another actor");
     }
   }
   /**
@@ -2798,12 +3449,12 @@ var AgentService = class {
     if (this.store.toolCallInput === void 0) {
       return;
     }
-    const questions = (0, import_nestjs_agent_core10.readElicitationQuestions)(await this.store.toolCallInput(toolCallId2));
+    const questions = (0, import_nestjs_agent_core14.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_core10.validateElicitationAnswer)(question, submitted ?? question.defaults ?? []);
+      const problem = (0, import_nestjs_agent_core14.validateElicitationAnswer)(question, submitted ?? question.defaults ?? []);
       if (problem !== null) {
-        throw new import_common8.BadRequestException(`answers["${question.id}"] ${problem}`);
+        throw new import_common10.BadRequestException(`answers["${question.id}"] ${problem}`);
       }
     }
   }
@@ -2815,21 +3466,21 @@ var AgentService = class {
   */
   async assertMayDecide(actor, toolCallId2) {
     const approval = await this.store.toolCallApproval?.(toolCallId2);
-    const approver = approval?.approver ?? import_nestjs_agent_core10.REQUESTER_APPROVER;
-    if (approver === import_nestjs_agent_core10.REQUESTER_APPROVER) {
+    const approver = approval?.approver ?? import_nestjs_agent_core14.REQUESTER_APPROVER;
+    if (approver === import_nestjs_agent_core14.REQUESTER_APPROVER) {
       return this.assertOwnsToolCall(actor, toolCallId2);
     }
     const requesterRef = await this.store.ownerOfToolCall(toolCallId2);
     if (requesterRef === null) {
-      throw new import_common8.NotFoundException(`tool call ${toolCallId2} not found`);
+      throw new import_common10.NotFoundException(`tool call ${toolCallId2} not found`);
     }
-    const allowed = await (0, import_nestjs_agent_core10.mayDecideApproval)(this.deps.forAgent().approvalPolicy, actor, {
+    const allowed = await (0, import_nestjs_agent_core14.mayDecideApproval)(this.deps.forAgent().approvalPolicy, actor, {
       toolCallId: toolCallId2,
       approver,
       requesterRef
     });
     if (!allowed) {
-      throw new import_common8.ForbiddenException(`this approval is for ${approver}`);
+      throw new import_common10.ForbiddenException(`this approval is for ${approver}`);
     }
   }
   /**
@@ -2845,7 +3496,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_common8.GoneException(`the approval request for tool call ${toolCallId2} has expired`);
+      throw new import_common10.GoneException(`the approval request for tool call ${toolCallId2} has expired`);
     }
   }
   /**
@@ -2858,7 +3509,7 @@ var AgentService = class {
   async resolveRunForToolCall(toolCallId2) {
     const runId = await this.store.runForToolCall(toolCallId2);
     if (runId === null) {
-      throw new import_common8.NotFoundException(`tool call ${toolCallId2} has no active run to signal`);
+      throw new import_common10.NotFoundException(`tool call ${toolCallId2} has no active run to signal`);
     }
     return runId;
   }
@@ -2866,29 +3517,30 @@ var AgentService = class {
   async assertOwnsActiveStream(actor, runId) {
     const owner = await this.store.ownerOfActiveStream(runId);
     if (owner === null) {
-      throw new import_common8.NotFoundException(`no active run ${runId}`);
+      throw new import_common10.NotFoundException(`no active run ${runId}`);
     }
     if (owner !== actor.id) {
-      throw new import_common8.ForbiddenException("run belongs to another actor");
+      throw new import_common10.ForbiddenException("run belongs to another actor");
     }
   }
 };
-AgentService = _ts_decorate7([
-  (0, import_common8.Injectable)(),
-  _ts_param6(0, (0, import_common8.Inject)(import_nestjs_agent_core10.AGENT_RUNNER)),
-  _ts_param6(1, (0, import_common8.Inject)(import_nestjs_agent_core10.AGENT_STORE)),
-  _ts_param6(2, (0, import_common8.Inject)(import_nestjs_agent_core10.AGENT_DEPS_FACTORY)),
-  _ts_param6(3, (0, import_common8.Optional)()),
-  _ts_param6(3, (0, import_common8.Inject)(import_nestjs_agent_core10.AGENT_ATTACHMENT_STAGING)),
-  _ts_param6(4, (0, import_common8.Optional)()),
-  _ts_param6(4, (0, import_common8.Inject)(import_nestjs_agent_core10.AGENT_MODEL_CATALOG)),
-  _ts_param6(5, (0, import_common8.Optional)()),
-  _ts_param6(5, (0, import_common8.Inject)(import_nestjs_agent_core10.AGENT_QUOTA_PROVIDER)),
-  _ts_param6(6, (0, import_common8.Optional)()),
-  _ts_param6(6, (0, import_common8.Inject)(import_nestjs_agent_core10.AGENT_OPTIONS)),
-  _ts_param6(7, (0, import_common8.Optional)()),
-  _ts_metadata6("design:type", Function),
-  _ts_metadata6("design:paramtypes", [
+AgentService = _ts_decorate9([
+  (0, import_common10.Injectable)(),
+  _ts_param7(0, (0, import_common10.Inject)(import_nestjs_agent_core14.AGENT_RUNNER)),
+  _ts_param7(1, (0, import_common10.Inject)(import_nestjs_agent_core14.AGENT_STORE)),
+  _ts_param7(2, (0, import_common10.Inject)(import_nestjs_agent_core14.AGENT_DEPS_FACTORY)),
+  _ts_param7(3, (0, import_common10.Optional)()),
+  _ts_param7(3, (0, import_common10.Inject)(import_nestjs_agent_core14.AGENT_ATTACHMENT_STAGING)),
+  _ts_param7(4, (0, import_common10.Optional)()),
+  _ts_param7(4, (0, import_common10.Inject)(import_nestjs_agent_core14.AGENT_MODEL_CATALOG)),
+  _ts_param7(5, (0, import_common10.Optional)()),
+  _ts_param7(5, (0, import_common10.Inject)(import_nestjs_agent_core14.AGENT_QUOTA_PROVIDER)),
+  _ts_param7(6, (0, import_common10.Optional)()),
+  _ts_param7(6, (0, import_common10.Inject)(import_nestjs_agent_core14.AGENT_OPTIONS)),
+  _ts_param7(7, (0, import_common10.Optional)()),
+  _ts_param7(8, (0, import_common10.Optional)()),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", [
     typeof AgentRunner === "undefined" ? Object : AgentRunner,
     typeof AgentStore === "undefined" ? Object : AgentStore,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
@@ -2896,13 +3548,14 @@ AgentService = _ts_decorate7([
     typeof ModelCatalog === "undefined" ? Object : ModelCatalog,
     typeof QuotaProvider === "undefined" ? Object : QuotaProvider,
     typeof Pick === "undefined" ? Object : Pick,
-    typeof ChatQueueService2 === "undefined" ? Object : ChatQueueService2
+    typeof ChatQueueService2 === "undefined" ? Object : ChatQueueService2,
+    typeof ActionProposalService === "undefined" ? Object : ActionProposalService
   ])
 ], AgentService);
 
 // src/approval-port.adapter.ts
-var import_common9 = require("@nestjs/common");
-function _ts_decorate8(decorators, target, key, desc) {
+var import_common11 = require("@nestjs/common");
+function _ts_decorate10(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -2915,20 +3568,48 @@ 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_decorate10, "_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");
+__name(_ts_metadata8, "_ts_metadata");
+function _ts_param8(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param8, "_ts_param");
 var AgentApprovalPortAdapter = class {
   static {
     __name(this, "AgentApprovalPortAdapter");
   }
   agent;
-  constructor(agent) {
+  proposals;
+  constructor(agent, proposals) {
     this.agent = agent;
+    this.proposals = proposals;
+  }
+  async approveActionProposal(actor, target, opts) {
+    if (!this.proposals) throw new import_common11.NotImplementedException("Action proposals unavailable");
+    return this.proposals.decide(target.threadId, target.proposalId, actor, {
+      decision: "approved",
+      ...opts?.remember !== void 0 ? {
+        remember: opts.remember
+      } : {},
+      via: opts?.decidedVia ?? "console"
+    });
+  }
+  async rejectActionProposal(actor, target, opts) {
+    if (!this.proposals) throw new import_common11.NotImplementedException("Action proposals unavailable");
+    return this.proposals.decide(target.threadId, target.proposalId, actor, {
+      decision: "rejected",
+      ...opts?.reason !== void 0 ? {
+        reason: opts.reason
+      } : {},
+      via: opts?.decidedVia ?? "console"
+    });
   }
   async approve(toolCallId2, opts) {
     await this.agent.signalToolCall(toolCallId2, {
@@ -2959,18 +3640,20 @@ var AgentApprovalPortAdapter = class {
     });
   }
 };
-AgentApprovalPortAdapter = _ts_decorate8([
-  (0, import_common9.Injectable)(),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
-    typeof AgentService === "undefined" ? Object : AgentService
+AgentApprovalPortAdapter = _ts_decorate10([
+  (0, import_common11.Injectable)(),
+  _ts_param8(1, (0, import_common11.Optional)()),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", [
+    typeof AgentService === "undefined" ? Object : AgentService,
+    typeof ActionProposalService === "undefined" ? Object : ActionProposalService
   ])
 ], AgentApprovalPortAdapter);
 
 // src/controller/agents.controller.ts
-var import_nestjs_agent_core11 = require("@dudousxd/nestjs-agent-core");
-var import_common10 = require("@nestjs/common");
-function _ts_decorate9(decorators, target, key, desc) {
+var import_nestjs_agent_core15 = require("@dudousxd/nestjs-agent-core");
+var import_common12 = require("@nestjs/common");
+function _ts_decorate11(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -2983,19 +3666,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_decorate11, "_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_param9(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param7, "_ts_param");
+__name(_ts_param9, "_ts_param");
 var AgentsController = class {
   static {
     __name(this, "AgentsController");
@@ -3008,35 +3691,44 @@ var AgentsController = class {
   }
   list() {
     const defaultAgentName = this.depsFactory.defaultAgentName();
-    return this.agents.list().map((definition) => ({
-      name: definition.name,
-      description: definition.description ?? "",
-      ...definition.name === defaultAgentName ? {
-        isDefault: true
-      } : {}
-    }));
+    return this.agents.list().map((definition) => {
+      const personas = this.depsFactory.personaCatalog(definition.name);
+      return {
+        name: definition.name,
+        description: definition.description ?? "",
+        ...definition.name === defaultAgentName ? {
+          isDefault: true
+        } : {},
+        ...personas.length > 0 ? {
+          personas
+        } : {},
+        ...definition.defaultPersona !== void 0 ? {
+          defaultPersona: definition.defaultPersona
+        } : {}
+      };
+    });
   }
 };
-_ts_decorate9([
-  (0, import_common10.Get)(),
-  _ts_metadata8("design:type", Function),
-  _ts_metadata8("design:paramtypes", []),
-  _ts_metadata8("design:returntype", Array)
+_ts_decorate11([
+  (0, import_common12.Get)(),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", []),
+  _ts_metadata9("design:returntype", Array)
 ], AgentsController.prototype, "list", null);
-AgentsController = _ts_decorate9([
-  (0, import_common10.Controller)("agents"),
-  _ts_param7(0, (0, import_common10.Inject)(import_nestjs_agent_core11.AGENT_REGISTRY)),
-  _ts_param7(1, (0, import_common10.Inject)(import_nestjs_agent_core11.AGENT_DEPS_FACTORY)),
-  _ts_metadata8("design:type", Function),
-  _ts_metadata8("design:paramtypes", [
-    typeof import_nestjs_agent_core11.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core11.AgentRegistry,
+AgentsController = _ts_decorate11([
+  (0, import_common12.Controller)("agents"),
+  _ts_param9(0, (0, import_common12.Inject)(import_nestjs_agent_core15.AGENT_REGISTRY)),
+  _ts_param9(1, (0, import_common12.Inject)(import_nestjs_agent_core15.AGENT_DEPS_FACTORY)),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", [
+    typeof import_nestjs_agent_core15.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core15.AgentRegistry,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory
   ])
 ], AgentsController);
 
 // src/controller/attachments.controller.ts
-var import_nestjs_agent_core12 = require("@dudousxd/nestjs-agent-core");
-var import_common11 = require("@nestjs/common");
+var import_nestjs_agent_core16 = require("@dudousxd/nestjs-agent-core");
+var import_common13 = require("@nestjs/common");
 var import_platform_express = require("@nestjs/platform-express");
 
 // src/attachment-limits.ts
@@ -3065,7 +3757,7 @@ function attachmentLimits(options, staging) {
 __name(attachmentLimits, "attachmentLimits");
 
 // src/controller/attachments.controller.ts
-function _ts_decorate10(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);
@@ -3078,19 +3770,19 @@ function _ts_decorate10(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate10, "_ts_decorate");
-function _ts_metadata9(metadataKey, metadataValue) {
+__name(_ts_decorate12, "_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_param10(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param8, "_ts_param");
+__name(_ts_param10, "_ts_param");
 var HARD_MAX_ATTACHMENT_BYTES = 32 * 1024 * 1024;
 var ATTACHMENT_PAGE_SIZE = 50;
 var AttachmentsController = class {
@@ -3124,17 +3816,17 @@ var AttachmentsController = class {
   }
   async upload(req, file) {
     if (this.staging === void 0) {
-      throw new import_common11.NotImplementedException("Attachment upload is not configured on this server: bind AGENT_ATTACHMENT_STAGING (e.g. import AgentMediaAttachmentsModule).");
+      throw new import_common13.NotImplementedException("Attachment upload is not configured on this server: bind AGENT_ATTACHMENT_STAGING (e.g. import AgentMediaAttachmentsModule).");
     }
     if (file === void 0) {
-      throw new import_common11.BadRequestException('multipart field "file" is required');
+      throw new import_common13.BadRequestException('multipart field "file" is required');
     }
     const { allowedContentTypes, maxBytes } = attachmentLimits(this.options, this.staging);
     if (!allowedContentTypes.includes(file.mimetype)) {
-      throw new import_common11.UnsupportedMediaTypeException(`content type "${file.mimetype}" is not allowed (allowed: ${allowedContentTypes.join(", ")})`);
+      throw new import_common13.UnsupportedMediaTypeException(`content type "${file.mimetype}" is not allowed (allowed: ${allowedContentTypes.join(", ")})`);
     }
     if (file.size > maxBytes) {
-      throw new import_common11.PayloadTooLargeException(`file exceeds the ${maxBytes}-byte limit`);
+      throw new import_common13.PayloadTooLargeException(`file exceeds the ${maxBytes}-byte limit`);
     }
     const actor = await this.actorResolver.resolve(req);
     return this.staging.stage({
@@ -3146,39 +3838,39 @@ var AttachmentsController = class {
     });
   }
 };
-_ts_decorate10([
-  (0, import_common11.Get)(),
-  _ts_param8(0, (0, import_common11.Req)()),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+_ts_decorate12([
+  (0, import_common13.Get)(),
+  _ts_param10(0, (0, import_common13.Req)()),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata9("design:returntype", Promise)
+  _ts_metadata10("design:returntype", Promise)
 ], AttachmentsController.prototype, "list", null);
-_ts_decorate10([
-  (0, import_common11.Post)(),
-  (0, import_common11.UseInterceptors)((0, import_platform_express.FileInterceptor)("file", {
+_ts_decorate12([
+  (0, import_common13.Post)(),
+  (0, import_common13.UseInterceptors)((0, import_platform_express.FileInterceptor)("file", {
     limits: {
       fileSize: HARD_MAX_ATTACHMENT_BYTES
     }
   })),
-  _ts_param8(0, (0, import_common11.Req)()),
-  _ts_param8(1, (0, import_common11.UploadedFile)()),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+  _ts_param10(0, (0, import_common13.Req)()),
+  _ts_param10(1, (0, import_common13.UploadedFile)()),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     Object
   ]),
-  _ts_metadata9("design:returntype", Promise)
+  _ts_metadata10("design:returntype", Promise)
 ], AttachmentsController.prototype, "upload", null);
-AttachmentsController = _ts_decorate10([
-  (0, import_common11.Controller)("attachments"),
-  _ts_param8(0, (0, import_common11.Inject)(import_nestjs_agent_core12.AGENT_OPTIONS)),
-  _ts_param8(1, (0, import_common11.Inject)(import_nestjs_agent_core12.AGENT_ACTOR_RESOLVER)),
-  _ts_param8(3, (0, import_common11.Optional)()),
-  _ts_param8(3, (0, import_common11.Inject)(import_nestjs_agent_core12.AGENT_ATTACHMENT_STAGING)),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+AttachmentsController = _ts_decorate12([
+  (0, import_common13.Controller)("attachments"),
+  _ts_param10(0, (0, import_common13.Inject)(import_nestjs_agent_core16.AGENT_OPTIONS)),
+  _ts_param10(1, (0, import_common13.Inject)(import_nestjs_agent_core16.AGENT_ACTOR_RESOLVER)),
+  _ts_param10(3, (0, import_common13.Optional)()),
+  _ts_param10(3, (0, import_common13.Inject)(import_nestjs_agent_core16.AGENT_ATTACHMENT_STAGING)),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -3187,9 +3879,10 @@ AttachmentsController = _ts_decorate10([
 ], AttachmentsController);
 
 // src/controller/chat.controller.ts
-var import_nestjs_agent_core13 = require("@dudousxd/nestjs-agent-core");
-var import_common12 = require("@nestjs/common");
-function _ts_decorate11(decorators, target, key, desc) {
+var import_nestjs_agent_core17 = require("@dudousxd/nestjs-agent-core");
+var import_genui2 = require("@dudousxd/nestjs-agent-core/genui");
+var import_common14 = require("@nestjs/common");
+function _ts_decorate13(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -3202,19 +3895,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_decorate13, "_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_param11(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param9, "_ts_param");
+__name(_ts_param11, "_ts_param");
 function sendMode(body) {
   if (body.interrupt === true) {
     return "interrupt";
@@ -3225,7 +3918,7 @@ function sendMode(body) {
   if (body.mode === "auto" || body.mode === "queue" || body.mode === "interrupt") {
     return body.mode;
   }
-  throw new import_common12.BadRequestException("mode must be 'auto', 'queue' or 'interrupt'");
+  throw new import_common14.BadRequestException("mode must be 'auto', 'queue' or 'interrupt'");
 }
 __name(sendMode, "sendMode");
 function attachmentRefs(claimed) {
@@ -3233,21 +3926,21 @@ function attachmentRefs(claimed) {
     return [];
   }
   if (!Array.isArray(claimed)) {
-    throw new import_common12.BadRequestException("attachments must be an array of { mediaId }");
+    throw new import_common14.BadRequestException("attachments must be an array of { mediaId }");
   }
   if (claimed.length > MAX_ATTACHMENTS_PER_MESSAGE) {
-    throw new import_common12.BadRequestException(`a message may carry at most ${MAX_ATTACHMENTS_PER_MESSAGE} attachments`);
+    throw new import_common14.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_common12.BadRequestException("each attachment must be an object with a mediaId");
+      throw new import_common14.BadRequestException("each attachment must be an object with a mediaId");
     }
     if (Object.keys(entry).some((key) => key !== "mediaId")) {
-      throw new import_common12.BadRequestException("attachments are { mediaId } refs \u2014 send nothing but the id");
+      throw new import_common14.BadRequestException("attachments are { mediaId } refs \u2014 send nothing but the id");
     }
     const { mediaId } = entry;
     if (typeof mediaId !== "string" || mediaId.length === 0) {
-      throw new import_common12.BadRequestException("each attachment must carry a non-empty string mediaId");
+      throw new import_common14.BadRequestException("each attachment must carry a non-empty string mediaId");
     }
     return {
       mediaId
@@ -3275,15 +3968,27 @@ var ChatController = class {
     const actor = await this.actorResolver.resolve(req);
     const attachments = attachmentRefs(body.attachments);
     const mode = sendMode(body);
+    let uiCapabilities;
+    try {
+      uiCapabilities = body.uiCapabilities === void 0 ? void 0 : (0, import_genui2.validateUiCapabilities)(body.uiCapabilities);
+    } catch {
+      throw new import_common14.BadRequestException("Invalid UI capabilities");
+    }
     const result = await this.agent.send({
       actor,
       message: body.message,
+      ...uiCapabilities !== void 0 ? {
+        uiCapabilities
+      } : {},
       ...body.threadId !== void 0 ? {
         threadId: body.threadId
       } : {},
       ...body.agent !== void 0 ? {
         agentName: body.agent
       } : {},
+      ...typeof body.persona === "string" && body.persona.length > 0 ? {
+        personaId: body.persona
+      } : {},
       ...attachments.length > 0 ? {
         attachments
       } : {},
@@ -3301,6 +4006,10 @@ var ChatController = class {
       } : {},
       mode
     });
+    if ("proposalDecision" in result) {
+      res.status(200).json(result);
+      return;
+    }
     if (result.queued === true) {
       res.status(202).json(result);
       return;
@@ -3380,10 +4089,10 @@ data: ${line}
       }
       res.write("event: done\ndata: {}\n\n");
     } catch (error) {
-      const payload = error instanceof import_nestjs_agent_core13.AgentStreamError ? {
+      const payload = error instanceof import_nestjs_agent_core17.AgentStreamError ? {
         code: error.code,
         message: error.message
-      } : (0, import_nestjs_agent_core13.streamFailure)(error);
+      } : (0, import_nestjs_agent_core17.streamFailure)(error);
       res.write(`event: error
 data: ${JSON.stringify(payload)}
 
@@ -3392,50 +4101,50 @@ data: ${JSON.stringify(payload)}
     res.end();
   }
 };
-_ts_decorate11([
-  (0, import_common12.Post)("chat"),
-  _ts_param9(0, (0, import_common12.Req)()),
-  _ts_param9(1, (0, import_common12.Res)()),
-  _ts_param9(2, (0, import_common12.Body)()),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+_ts_decorate13([
+  (0, import_common14.Post)("chat"),
+  _ts_param11(0, (0, import_common14.Req)()),
+  _ts_param11(1, (0, import_common14.Res)()),
+  _ts_param11(2, (0, import_common14.Body)()),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof Response === "undefined" ? Object : Response,
     typeof ChatBody === "undefined" ? Object : ChatBody
   ]),
-  _ts_metadata10("design:returntype", Promise)
+  _ts_metadata11("design:returntype", Promise)
 ], ChatController.prototype, "chat", null);
-_ts_decorate11([
-  (0, import_common12.Get)("chat/:runId/stream"),
-  _ts_param9(0, (0, import_common12.Req)()),
-  _ts_param9(1, (0, import_common12.Param)("runId")),
-  _ts_param9(2, (0, import_common12.Res)()),
-  _ts_param9(3, (0, import_common12.Query)("after")),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+_ts_decorate13([
+  (0, import_common14.Get)("chat/:runId/stream"),
+  _ts_param11(0, (0, import_common14.Req)()),
+  _ts_param11(1, (0, import_common14.Param)("runId")),
+  _ts_param11(2, (0, import_common14.Res)()),
+  _ts_param11(3, (0, import_common14.Query)("after")),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     typeof Response === "undefined" ? Object : Response,
     String
   ]),
-  _ts_metadata10("design:returntype", Promise)
+  _ts_metadata11("design:returntype", Promise)
 ], ChatController.prototype, "stream", null);
-_ts_decorate11([
-  (0, import_common12.Post)("chat/:runId/cancel"),
-  _ts_param9(0, (0, import_common12.Req)()),
-  _ts_param9(1, (0, import_common12.Param)("runId")),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+_ts_decorate13([
+  (0, import_common14.Post)("chat/:runId/cancel"),
+  _ts_param11(0, (0, import_common14.Req)()),
+  _ts_param11(1, (0, import_common14.Param)("runId")),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata10("design:returntype", Promise)
+  _ts_metadata11("design:returntype", Promise)
 ], ChatController.prototype, "cancel", null);
-ChatController = _ts_decorate11([
-  (0, import_common12.Controller)(),
-  _ts_param9(1, (0, import_common12.Inject)(import_nestjs_agent_core13.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+ChatController = _ts_decorate13([
+  (0, import_common14.Controller)(),
+  _ts_param11(1, (0, import_common14.Inject)(import_nestjs_agent_core17.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
@@ -3451,8 +4160,8 @@ function parseCursor(raw) {
 __name(parseCursor, "parseCursor");
 
 // src/controller/config.controller.ts
-var import_nestjs_agent_core14 = require("@dudousxd/nestjs-agent-core");
-var import_common13 = require("@nestjs/common");
+var import_nestjs_agent_core18 = require("@dudousxd/nestjs-agent-core");
+var import_common15 = require("@nestjs/common");
 
 // src/resolver/anonymous-actor-resolver.ts
 var import_node_crypto2 = require("crypto");
@@ -3542,7 +4251,7 @@ var AnonymousActorResolver = class {
 };
 
 // src/controller/config.controller.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);
@@ -3555,19 +4264,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_decorate14, "_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_param12(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param10, "_ts_param");
+__name(_ts_param12, "_ts_param");
 var ConfigController = class {
   static {
     __name(this, "ConfigController");
@@ -3598,25 +4307,25 @@ var ConfigController = class {
     };
   }
 };
-_ts_decorate12([
-  (0, import_common13.Get)(),
-  _ts_param10(0, (0, import_common13.Req)()),
-  _ts_metadata11("design:type", Function),
-  _ts_metadata11("design:paramtypes", [
+_ts_decorate14([
+  (0, import_common15.Get)(),
+  _ts_param12(0, (0, import_common15.Req)()),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata11("design:returntype", Promise)
+  _ts_metadata12("design:returntype", Promise)
 ], ConfigController.prototype, "config", null);
-ConfigController = _ts_decorate12([
-  (0, import_common13.Controller)("config"),
-  _ts_param10(0, (0, import_common13.Inject)(import_nestjs_agent_core14.AGENT_OPTIONS)),
-  _ts_param10(1, (0, import_common13.Inject)(import_nestjs_agent_core14.AGENT_ACTOR_RESOLVER)),
-  _ts_param10(2, (0, import_common13.Optional)()),
-  _ts_param10(2, (0, import_common13.Inject)(import_nestjs_agent_core14.AGENT_ATTACHMENT_STAGING)),
-  _ts_param10(3, (0, import_common13.Optional)()),
-  _ts_param10(3, (0, import_common13.Inject)(import_nestjs_agent_core14.AGENT_MODEL_CATALOG)),
-  _ts_metadata11("design:type", Function),
-  _ts_metadata11("design:paramtypes", [
+ConfigController = _ts_decorate14([
+  (0, import_common15.Controller)("config"),
+  _ts_param12(0, (0, import_common15.Inject)(import_nestjs_agent_core18.AGENT_OPTIONS)),
+  _ts_param12(1, (0, import_common15.Inject)(import_nestjs_agent_core18.AGENT_ACTOR_RESOLVER)),
+  _ts_param12(2, (0, import_common15.Optional)()),
+  _ts_param12(2, (0, import_common15.Inject)(import_nestjs_agent_core18.AGENT_ATTACHMENT_STAGING)),
+  _ts_param12(3, (0, import_common15.Optional)()),
+  _ts_param12(3, (0, import_common15.Inject)(import_nestjs_agent_core18.AGENT_MODEL_CATALOG)),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     Object,
@@ -3625,9 +4334,9 @@ ConfigController = _ts_decorate12([
 ], ConfigController);
 
 // src/controller/memories.controller.ts
-var import_nestjs_agent_core15 = require("@dudousxd/nestjs-agent-core");
-var import_common14 = require("@nestjs/common");
-function _ts_decorate13(decorators, target, key, desc) {
+var import_nestjs_agent_core19 = require("@dudousxd/nestjs-agent-core");
+var import_common16 = require("@nestjs/common");
+function _ts_decorate15(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -3640,19 +4349,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_decorate15, "_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_param13(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param11, "_ts_param");
+__name(_ts_param13, "_ts_param");
 var MemoriesController = class {
   static {
     __name(this, "MemoriesController");
@@ -3686,20 +4395,20 @@ var MemoriesController = class {
   */
   async forget(req, id) {
     if (this.memory === void 0) {
-      throw new import_common14.NotFoundException("No memory is configured in this deployment.");
+      throw new import_common16.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_common14.NotFoundException(`No memory with id "${id}".`);
+      throw new import_common16.NotFoundException(`No memory with id "${id}".`);
     }
-    const verdict = (0, import_nestjs_agent_core15.memoryForgetVerdict)({
+    const verdict = (0, import_nestjs_agent_core19.memoryForgetVerdict)({
       record: entry,
       actor
     });
     if (!verdict.allowed) {
-      throw new import_common14.ForbiddenException(verdict.reason);
+      throw new import_common16.ForbiddenException(verdict.reason);
     }
     return {
       forgotten: await this.memory.provider.forget({
@@ -3713,7 +4422,7 @@ var MemoriesController = class {
   }
   async unbounded(threadId, actor) {
     const config = this.memory;
-    return await (0, import_nestjs_agent_core15.offerMemories)({
+    return await (0, import_nestjs_agent_core19.offerMemories)({
       config: {
         ...config,
         maxMemories: Number.POSITIVE_INFINITY
@@ -3725,44 +4434,44 @@ var MemoriesController = class {
     });
   }
 };
-_ts_decorate13([
-  (0, import_common14.Get)(),
-  _ts_param11(0, (0, import_common14.Req)()),
-  _ts_param11(1, (0, import_common14.Query)("threadId")),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+_ts_decorate15([
+  (0, import_common16.Get)(),
+  _ts_param13(0, (0, import_common16.Req)()),
+  _ts_param13(1, (0, import_common16.Query)("threadId")),
+  _ts_metadata13("design:type", Function),
+  _ts_metadata13("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata12("design:returntype", Promise)
+  _ts_metadata13("design:returntype", Promise)
 ], MemoriesController.prototype, "list", null);
-_ts_decorate13([
-  (0, import_common14.Delete)(":id"),
-  _ts_param11(0, (0, import_common14.Req)()),
-  _ts_param11(1, (0, import_common14.Param)("id")),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+_ts_decorate15([
+  (0, import_common16.Delete)(":id"),
+  _ts_param13(0, (0, import_common16.Req)()),
+  _ts_param13(1, (0, import_common16.Param)("id")),
+  _ts_metadata13("design:type", Function),
+  _ts_metadata13("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata12("design:returntype", Promise)
+  _ts_metadata13("design:returntype", Promise)
 ], MemoriesController.prototype, "forget", null);
-MemoriesController = _ts_decorate13([
-  (0, import_common14.Controller)("memories"),
-  _ts_param11(0, (0, import_common14.Inject)(import_nestjs_agent_core15.AGENT_ACTOR_RESOLVER)),
-  _ts_param11(1, (0, import_common14.Optional)()),
-  _ts_param11(1, (0, import_common14.Inject)(import_nestjs_agent_core15.AGENT_MEMORY)),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+MemoriesController = _ts_decorate15([
+  (0, import_common16.Controller)("memories"),
+  _ts_param13(0, (0, import_common16.Inject)(import_nestjs_agent_core19.AGENT_ACTOR_RESOLVER)),
+  _ts_param13(1, (0, import_common16.Optional)()),
+  _ts_param13(1, (0, import_common16.Inject)(import_nestjs_agent_core19.AGENT_MEMORY)),
+  _ts_metadata13("design:type", Function),
+  _ts_metadata13("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     Object
   ])
 ], MemoriesController);
 
 // src/controller/messages.controller.ts
-var import_nestjs_agent_core16 = require("@dudousxd/nestjs-agent-core");
-var import_common15 = require("@nestjs/common");
-function _ts_decorate14(decorators, target, key, desc) {
+var import_nestjs_agent_core20 = require("@dudousxd/nestjs-agent-core");
+var import_common17 = require("@nestjs/common");
+function _ts_decorate16(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -3775,19 +4484,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_decorate16, "_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_param14(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param12, "_ts_param");
+__name(_ts_param14, "_ts_param");
 var MessagesController = class {
   static {
     __name(this, "MessagesController");
@@ -3815,34 +4524,34 @@ var MessagesController = class {
     };
   }
 };
-_ts_decorate14([
-  (0, import_common15.Post)(":id/feedback"),
-  (0, import_common15.HttpCode)(200),
-  _ts_param12(0, (0, import_common15.Req)()),
-  _ts_param12(1, (0, import_common15.Param)("id")),
-  _ts_param12(2, (0, import_common15.Body)()),
-  _ts_metadata13("design:type", Function),
-  _ts_metadata13("design:paramtypes", [
+_ts_decorate16([
+  (0, import_common17.Post)(":id/feedback"),
+  (0, import_common17.HttpCode)(200),
+  _ts_param14(0, (0, import_common17.Req)()),
+  _ts_param14(1, (0, import_common17.Param)("id")),
+  _ts_param14(2, (0, import_common17.Body)()),
+  _ts_metadata14("design:type", Function),
+  _ts_metadata14("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     typeof FeedbackBody === "undefined" ? Object : FeedbackBody
   ]),
-  _ts_metadata13("design:returntype", Promise)
+  _ts_metadata14("design:returntype", Promise)
 ], MessagesController.prototype, "feedback", null);
-MessagesController = _ts_decorate14([
-  (0, import_common15.Controller)("messages"),
-  _ts_param12(1, (0, import_common15.Inject)(import_nestjs_agent_core16.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata13("design:type", Function),
-  _ts_metadata13("design:paramtypes", [
+MessagesController = _ts_decorate16([
+  (0, import_common17.Controller)("messages"),
+  _ts_param14(1, (0, import_common17.Inject)(import_nestjs_agent_core20.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata14("design:type", Function),
+  _ts_metadata14("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], MessagesController);
 
 // src/controller/models.controller.ts
-var import_nestjs_agent_core17 = require("@dudousxd/nestjs-agent-core");
-var import_common16 = require("@nestjs/common");
-function _ts_decorate15(decorators, target, key, desc) {
+var import_nestjs_agent_core21 = require("@dudousxd/nestjs-agent-core");
+var import_common18 = require("@nestjs/common");
+function _ts_decorate17(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -3855,19 +4564,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_metadata15(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_metadata15, "_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 ModelsController = class {
   static {
     __name(this, "ModelsController");
@@ -3887,31 +4596,31 @@ var ModelsController = class {
     return this.agent.listModels(actor, agent);
   }
 };
-_ts_decorate15([
-  (0, import_common16.Get)(),
-  _ts_param13(0, (0, import_common16.Req)()),
-  _ts_param13(1, (0, import_common16.Query)("agent")),
-  _ts_metadata14("design:type", Function),
-  _ts_metadata14("design:paramtypes", [
+_ts_decorate17([
+  (0, import_common18.Get)(),
+  _ts_param15(0, (0, import_common18.Req)()),
+  _ts_param15(1, (0, import_common18.Query)("agent")),
+  _ts_metadata15("design:type", Function),
+  _ts_metadata15("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata14("design:returntype", Promise)
+  _ts_metadata15("design:returntype", Promise)
 ], ModelsController.prototype, "list", null);
-ModelsController = _ts_decorate15([
-  (0, import_common16.Controller)("models"),
-  _ts_param13(1, (0, import_common16.Inject)(import_nestjs_agent_core17.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata14("design:type", Function),
-  _ts_metadata14("design:paramtypes", [
+ModelsController = _ts_decorate17([
+  (0, import_common18.Controller)("models"),
+  _ts_param15(1, (0, import_common18.Inject)(import_nestjs_agent_core21.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata15("design:type", Function),
+  _ts_metadata15("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ModelsController);
 
 // src/controller/queue.controller.ts
-var import_nestjs_agent_core18 = require("@dudousxd/nestjs-agent-core");
-var import_common17 = require("@nestjs/common");
-function _ts_decorate16(decorators, target, key, desc) {
+var import_nestjs_agent_core22 = require("@dudousxd/nestjs-agent-core");
+var import_common19 = 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);
@@ -3924,19 +4633,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_metadata16(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_metadata16, "_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 QueueController = class {
   static {
     __name(this, "QueueController");
@@ -3960,10 +4669,10 @@ var QueueController = class {
   async update(req, messageId, body) {
     const actor = await this.actorResolver.resolve(req);
     if (body.message !== void 0 && typeof body.message !== "string") {
-      throw new import_common17.BadRequestException("message must be a string");
+      throw new import_common19.BadRequestException("message must be a string");
     }
     if (body.position !== void 0 && typeof body.position !== "number") {
-      throw new import_common17.BadRequestException("position must be a number");
+      throw new import_common19.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, {
@@ -3990,88 +4699,88 @@ var QueueController = class {
     return this.agent.removeQueuedMessage(await this.actorResolver.resolve(req), messageId);
   }
 };
-_ts_decorate16([
-  (0, import_common17.Get)("threads/:id/queue"),
-  _ts_param14(0, (0, import_common17.Req)()),
-  _ts_param14(1, (0, import_common17.Param)("id")),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+_ts_decorate18([
+  (0, import_common19.Get)("threads/:id/queue"),
+  _ts_param16(0, (0, import_common19.Req)()),
+  _ts_param16(1, (0, import_common19.Param)("id")),
+  _ts_metadata16("design:type", Function),
+  _ts_metadata16("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata15("design:returntype", Promise)
+  _ts_metadata16("design:returntype", Promise)
 ], QueueController.prototype, "list", null);
-_ts_decorate16([
-  (0, import_common17.Delete)("threads/:id/queue"),
-  _ts_param14(0, (0, import_common17.Req)()),
-  _ts_param14(1, (0, import_common17.Param)("id")),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+_ts_decorate18([
+  (0, import_common19.Delete)("threads/:id/queue"),
+  _ts_param16(0, (0, import_common19.Req)()),
+  _ts_param16(1, (0, import_common19.Param)("id")),
+  _ts_metadata16("design:type", Function),
+  _ts_metadata16("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata15("design:returntype", Promise)
+  _ts_metadata16("design:returntype", Promise)
 ], QueueController.prototype, "clear", null);
-_ts_decorate16([
-  (0, import_common17.Post)("threads/:id/queue/resume"),
-  _ts_param14(0, (0, import_common17.Req)()),
-  _ts_param14(1, (0, import_common17.Param)("id")),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+_ts_decorate18([
+  (0, import_common19.Post)("threads/:id/queue/resume"),
+  _ts_param16(0, (0, import_common19.Req)()),
+  _ts_param16(1, (0, import_common19.Param)("id")),
+  _ts_metadata16("design:type", Function),
+  _ts_metadata16("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata15("design:returntype", Promise)
+  _ts_metadata16("design:returntype", Promise)
 ], QueueController.prototype, "resume", null);
-_ts_decorate16([
-  (0, import_common17.Patch)("queue/:messageId"),
-  _ts_param14(0, (0, import_common17.Req)()),
-  _ts_param14(1, (0, import_common17.Param)("messageId")),
-  _ts_param14(2, (0, import_common17.Body)()),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+_ts_decorate18([
+  (0, import_common19.Patch)("queue/:messageId"),
+  _ts_param16(0, (0, import_common19.Req)()),
+  _ts_param16(1, (0, import_common19.Param)("messageId")),
+  _ts_param16(2, (0, import_common19.Body)()),
+  _ts_metadata16("design:type", Function),
+  _ts_metadata16("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     typeof UpdateQueuedMessageBody === "undefined" ? Object : UpdateQueuedMessageBody
   ]),
-  _ts_metadata15("design:returntype", Promise)
+  _ts_metadata16("design:returntype", Promise)
 ], QueueController.prototype, "update", null);
-_ts_decorate16([
-  (0, import_common17.Post)("queue/:messageId/interrupt"),
-  _ts_param14(0, (0, import_common17.Req)()),
-  _ts_param14(1, (0, import_common17.Param)("messageId")),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+_ts_decorate18([
+  (0, import_common19.Post)("queue/:messageId/interrupt"),
+  _ts_param16(0, (0, import_common19.Req)()),
+  _ts_param16(1, (0, import_common19.Param)("messageId")),
+  _ts_metadata16("design:type", Function),
+  _ts_metadata16("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata15("design:returntype", Promise)
+  _ts_metadata16("design:returntype", Promise)
 ], QueueController.prototype, "interrupt", null);
-_ts_decorate16([
-  (0, import_common17.Delete)("queue/:messageId"),
-  _ts_param14(0, (0, import_common17.Req)()),
-  _ts_param14(1, (0, import_common17.Param)("messageId")),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+_ts_decorate18([
+  (0, import_common19.Delete)("queue/:messageId"),
+  _ts_param16(0, (0, import_common19.Req)()),
+  _ts_param16(1, (0, import_common19.Param)("messageId")),
+  _ts_metadata16("design:type", Function),
+  _ts_metadata16("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata15("design:returntype", Promise)
+  _ts_metadata16("design:returntype", Promise)
 ], QueueController.prototype, "remove", null);
-QueueController = _ts_decorate16([
-  (0, import_common17.Controller)(),
-  _ts_param14(1, (0, import_common17.Inject)(import_nestjs_agent_core18.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+QueueController = _ts_decorate18([
+  (0, import_common19.Controller)(),
+  _ts_param16(1, (0, import_common19.Inject)(import_nestjs_agent_core22.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata16("design:type", Function),
+  _ts_metadata16("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], QueueController);
 
 // src/controller/quota.controller.ts
-var import_nestjs_agent_core19 = require("@dudousxd/nestjs-agent-core");
-var import_common18 = require("@nestjs/common");
-function _ts_decorate17(decorators, target, key, desc) {
+var import_nestjs_agent_core23 = require("@dudousxd/nestjs-agent-core");
+var import_common20 = 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);
@@ -4084,19 +4793,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_metadata17(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_metadata17, "_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 QuotaController = class {
   static {
     __name(this, "QuotaController");
@@ -4116,29 +4825,29 @@ var QuotaController = class {
     return this.agent.quotaReport(actor);
   }
 };
-_ts_decorate17([
-  (0, import_common18.Get)(),
-  _ts_param15(0, (0, import_common18.Req)()),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+_ts_decorate19([
+  (0, import_common20.Get)(),
+  _ts_param17(0, (0, import_common20.Req)()),
+  _ts_metadata17("design:type", Function),
+  _ts_metadata17("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata16("design:returntype", Promise)
+  _ts_metadata17("design:returntype", Promise)
 ], QuotaController.prototype, "report", null);
-QuotaController = _ts_decorate17([
-  (0, import_common18.Controller)("quota"),
-  _ts_param15(1, (0, import_common18.Inject)(import_nestjs_agent_core19.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+QuotaController = _ts_decorate19([
+  (0, import_common20.Controller)("quota"),
+  _ts_param17(1, (0, import_common20.Inject)(import_nestjs_agent_core23.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata17("design:type", Function),
+  _ts_metadata17("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], QuotaController);
 
 // src/controller/skills.controller.ts
-var import_nestjs_agent_core20 = require("@dudousxd/nestjs-agent-core");
-var import_common19 = require("@nestjs/common");
-function _ts_decorate18(decorators, target, key, desc) {
+var import_nestjs_agent_core24 = require("@dudousxd/nestjs-agent-core");
+var import_common21 = 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);
@@ -4151,19 +4860,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_metadata18(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_metadata18, "_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 SkillsController = class {
   static {
     __name(this, "SkillsController");
@@ -4179,40 +4888,40 @@ var SkillsController = class {
       return [];
     }
     const actor = await this.actorResolver.resolve(req);
-    const offer = await (0, import_nestjs_agent_core20.offerSkills)(this.skills, {
+    const offer = await (0, import_nestjs_agent_core24.offerSkills)(this.skills, {
       actor,
       threadId: threadId ?? ""
     });
     return offer.entries;
   }
 };
-_ts_decorate18([
-  (0, import_common19.Get)(),
-  _ts_param16(0, (0, import_common19.Req)()),
-  _ts_param16(1, (0, import_common19.Query)("threadId")),
-  _ts_metadata17("design:type", Function),
-  _ts_metadata17("design:paramtypes", [
+_ts_decorate20([
+  (0, import_common21.Get)(),
+  _ts_param18(0, (0, import_common21.Req)()),
+  _ts_param18(1, (0, import_common21.Query)("threadId")),
+  _ts_metadata18("design:type", Function),
+  _ts_metadata18("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata17("design:returntype", Promise)
+  _ts_metadata18("design:returntype", Promise)
 ], SkillsController.prototype, "list", null);
-SkillsController = _ts_decorate18([
-  (0, import_common19.Controller)("skills"),
-  _ts_param16(0, (0, import_common19.Inject)(import_nestjs_agent_core20.AGENT_ACTOR_RESOLVER)),
-  _ts_param16(1, (0, import_common19.Optional)()),
-  _ts_param16(1, (0, import_common19.Inject)(import_nestjs_agent_core20.AGENT_SKILLS)),
-  _ts_metadata17("design:type", Function),
-  _ts_metadata17("design:paramtypes", [
+SkillsController = _ts_decorate20([
+  (0, import_common21.Controller)("skills"),
+  _ts_param18(0, (0, import_common21.Inject)(import_nestjs_agent_core24.AGENT_ACTOR_RESOLVER)),
+  _ts_param18(1, (0, import_common21.Optional)()),
+  _ts_param18(1, (0, import_common21.Inject)(import_nestjs_agent_core24.AGENT_SKILLS)),
+  _ts_metadata18("design:type", Function),
+  _ts_metadata18("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     Object
   ])
 ], SkillsController);
 
 // src/controller/threads.controller.ts
-var import_nestjs_agent_core21 = require("@dudousxd/nestjs-agent-core");
-var import_common20 = require("@nestjs/common");
-function _ts_decorate19(decorators, target, key, desc) {
+var import_nestjs_agent_core25 = require("@dudousxd/nestjs-agent-core");
+var import_common22 = require("@nestjs/common");
+function _ts_decorate21(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -4225,19 +4934,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_metadata19(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_metadata19, "_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 ThreadsController = class {
   static {
     __name(this, "ThreadsController");
@@ -4283,6 +4992,9 @@ var ThreadsController = class {
       } : {},
       ..."model" in body ? {
         model: body.model ?? null
+      } : {},
+      ..."persona" in body ? {
+        persona: body.persona ?? null
       } : {}
     });
     return {
@@ -4304,101 +5016,101 @@ var ThreadsController = class {
     };
   }
 };
-_ts_decorate19([
-  (0, import_common20.Get)(),
-  _ts_param17(0, (0, import_common20.Req)()),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+_ts_decorate21([
+  (0, import_common22.Get)(),
+  _ts_param19(0, (0, import_common22.Req)()),
+  _ts_metadata19("design:type", Function),
+  _ts_metadata19("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata18("design:returntype", Promise)
+  _ts_metadata19("design:returntype", Promise)
 ], ThreadsController.prototype, "list", null);
-_ts_decorate19([
-  (0, import_common20.Get)(":id"),
-  _ts_param17(0, (0, import_common20.Req)()),
-  _ts_param17(1, (0, import_common20.Param)("id")),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+_ts_decorate21([
+  (0, import_common22.Get)(":id"),
+  _ts_param19(0, (0, import_common22.Req)()),
+  _ts_param19(1, (0, import_common22.Param)("id")),
+  _ts_metadata19("design:type", Function),
+  _ts_metadata19("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata18("design:returntype", Promise)
+  _ts_metadata19("design:returntype", Promise)
 ], ThreadsController.prototype, "detail", null);
-_ts_decorate19([
-  (0, import_common20.Delete)(":id"),
-  _ts_param17(0, (0, import_common20.Req)()),
-  _ts_param17(1, (0, import_common20.Param)("id")),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+_ts_decorate21([
+  (0, import_common22.Delete)(":id"),
+  _ts_param19(0, (0, import_common22.Req)()),
+  _ts_param19(1, (0, import_common22.Param)("id")),
+  _ts_metadata19("design:type", Function),
+  _ts_metadata19("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata18("design:returntype", Promise)
+  _ts_metadata19("design:returntype", Promise)
 ], ThreadsController.prototype, "remove", null);
-_ts_decorate19([
-  (0, import_common20.Post)(":id/fork-from/:messageId"),
-  _ts_param17(0, (0, import_common20.Req)()),
-  _ts_param17(1, (0, import_common20.Param)("id")),
-  _ts_param17(2, (0, import_common20.Param)("messageId")),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+_ts_decorate21([
+  (0, import_common22.Post)(":id/fork-from/:messageId"),
+  _ts_param19(0, (0, import_common22.Req)()),
+  _ts_param19(1, (0, import_common22.Param)("id")),
+  _ts_param19(2, (0, import_common22.Param)("messageId")),
+  _ts_metadata19("design:type", Function),
+  _ts_metadata19("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     String
   ]),
-  _ts_metadata18("design:returntype", Promise)
+  _ts_metadata19("design:returntype", Promise)
 ], ThreadsController.prototype, "fork", null);
-_ts_decorate19([
-  (0, import_common20.Patch)(":id"),
-  _ts_param17(0, (0, import_common20.Req)()),
-  _ts_param17(1, (0, import_common20.Param)("id")),
-  _ts_param17(2, (0, import_common20.Body)()),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+_ts_decorate21([
+  (0, import_common22.Patch)(":id"),
+  _ts_param19(0, (0, import_common22.Req)()),
+  _ts_param19(1, (0, import_common22.Param)("id")),
+  _ts_param19(2, (0, import_common22.Body)()),
+  _ts_metadata19("design:type", Function),
+  _ts_metadata19("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     typeof UpdateThreadBody === "undefined" ? Object : UpdateThreadBody
   ]),
-  _ts_metadata18("design:returntype", Promise)
+  _ts_metadata19("design:returntype", Promise)
 ], ThreadsController.prototype, "update", null);
-_ts_decorate19([
-  (0, import_common20.Post)(":id/promote"),
-  _ts_param17(0, (0, import_common20.Req)()),
-  _ts_param17(1, (0, import_common20.Param)("id")),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+_ts_decorate21([
+  (0, import_common22.Post)(":id/promote"),
+  _ts_param19(0, (0, import_common22.Req)()),
+  _ts_param19(1, (0, import_common22.Param)("id")),
+  _ts_metadata19("design:type", Function),
+  _ts_metadata19("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata18("design:returntype", Promise)
+  _ts_metadata19("design:returntype", Promise)
 ], ThreadsController.prototype, "promote", null);
-_ts_decorate19([
-  (0, import_common20.Delete)(":id/from/:messageId"),
-  _ts_param17(0, (0, import_common20.Req)()),
-  _ts_param17(1, (0, import_common20.Param)("id")),
-  _ts_param17(2, (0, import_common20.Param)("messageId")),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+_ts_decorate21([
+  (0, import_common22.Delete)(":id/from/:messageId"),
+  _ts_param19(0, (0, import_common22.Req)()),
+  _ts_param19(1, (0, import_common22.Param)("id")),
+  _ts_param19(2, (0, import_common22.Param)("messageId")),
+  _ts_metadata19("design:type", Function),
+  _ts_metadata19("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     String
   ]),
-  _ts_metadata18("design:returntype", Promise)
+  _ts_metadata19("design:returntype", Promise)
 ], ThreadsController.prototype, "truncateFrom", null);
-ThreadsController = _ts_decorate19([
-  (0, import_common20.Controller)("threads"),
-  _ts_param17(1, (0, import_common20.Inject)(import_nestjs_agent_core21.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+ThreadsController = _ts_decorate21([
+  (0, import_common22.Controller)("threads"),
+  _ts_param19(1, (0, import_common22.Inject)(import_nestjs_agent_core25.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata19("design:type", Function),
+  _ts_metadata19("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ThreadsController);
 
 // src/controller/tool-call.controller.ts
-var import_nestjs_agent_core22 = require("@dudousxd/nestjs-agent-core");
-var import_common21 = require("@nestjs/common");
-function _ts_decorate20(decorators, target, key, desc) {
+var import_nestjs_agent_core26 = require("@dudousxd/nestjs-agent-core");
+var import_common23 = require("@nestjs/common");
+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);
@@ -4411,19 +5123,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_metadata20(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_metadata20, "_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 MAX_ANSWERED_QUESTIONS = 100;
 var MAX_VALUES_PER_QUESTION = 100;
 var MAX_ANSWER_VALUE_LENGTH = 4096;
@@ -4432,7 +5144,7 @@ var MAX_VIA_LENGTH = 64;
 var DEFAULT_VIA = "web";
 function toolCallId(claimed) {
   if (typeof claimed !== "string" || claimed.length === 0) {
-    throw new import_common21.BadRequestException("toolCallId must be a non-empty string");
+    throw new import_common23.BadRequestException("toolCallId must be a non-empty string");
   }
   return claimed;
 }
@@ -4442,10 +5154,10 @@ function rejectReason(claimed) {
     return void 0;
   }
   if (typeof claimed !== "string") {
-    throw new import_common21.BadRequestException("reason must be a string");
+    throw new import_common23.BadRequestException("reason must be a string");
   }
   if (claimed.length > MAX_REJECT_REASON_LENGTH) {
-    throw new import_common21.BadRequestException(`reason must be at most ${MAX_REJECT_REASON_LENGTH} characters`);
+    throw new import_common23.BadRequestException(`reason must be at most ${MAX_REJECT_REASON_LENGTH} characters`);
   }
   return claimed;
 }
@@ -4455,7 +5167,7 @@ function remember(claimed) {
     return false;
   }
   if (typeof claimed !== "boolean") {
-    throw new import_common21.BadRequestException("remember must be a boolean");
+    throw new import_common23.BadRequestException("remember must be a boolean");
   }
   return claimed;
 }
@@ -4465,7 +5177,7 @@ function via(claimed) {
     return DEFAULT_VIA;
   }
   if (typeof claimed !== "string" || claimed.length === 0 || claimed.length > MAX_VIA_LENGTH) {
-    throw new import_common21.BadRequestException(`via must be a string of 1-${MAX_VIA_LENGTH} characters`);
+    throw new import_common23.BadRequestException(`via must be a string of 1-${MAX_VIA_LENGTH} characters`);
   }
   return claimed;
 }
@@ -4475,26 +5187,26 @@ function answers(claimed) {
     return void 0;
   }
   if (typeof claimed !== "object" || claimed === null || Array.isArray(claimed)) {
-    throw new import_common21.BadRequestException("answers must be an object of questionId \u2192 chosen values");
+    throw new import_common23.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_common21.BadRequestException(`answers may cover at most ${MAX_ANSWERED_QUESTIONS} questions`);
+    throw new import_common23.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_common21.BadRequestException(`answers["${questionId}"] must be an array of chosen values`);
+      throw new import_common23.BadRequestException(`answers["${questionId}"] must be an array of chosen values`);
     }
     if (values.length > MAX_VALUES_PER_QUESTION) {
-      throw new import_common21.BadRequestException(`answers["${questionId}"] may carry at most ${MAX_VALUES_PER_QUESTION} values`);
+      throw new import_common23.BadRequestException(`answers["${questionId}"] may carry at most ${MAX_VALUES_PER_QUESTION} values`);
     }
     for (const value of values) {
       if (typeof value !== "string") {
-        throw new import_common21.BadRequestException(`answers["${questionId}"] must contain only strings`);
+        throw new import_common23.BadRequestException(`answers["${questionId}"] must contain only strings`);
       }
       if (value.length > MAX_ANSWER_VALUE_LENGTH) {
-        throw new import_common21.BadRequestException(`answers["${questionId}"] values must be at most ${MAX_ANSWER_VALUE_LENGTH} characters`);
+        throw new import_common23.BadRequestException(`answers["${questionId}"] values must be at most ${MAX_ANSWER_VALUE_LENGTH} characters`);
       }
     }
     validated[questionId] = values;
@@ -4556,64 +5268,64 @@ var ToolCallController = class {
     };
   }
 };
-_ts_decorate20([
-  (0, import_common21.Post)("approve"),
-  _ts_param18(0, (0, import_common21.Req)()),
-  _ts_param18(1, (0, import_common21.Body)()),
-  _ts_metadata19("design:type", Function),
-  _ts_metadata19("design:paramtypes", [
+_ts_decorate22([
+  (0, import_common23.Post)("approve"),
+  _ts_param20(0, (0, import_common23.Req)()),
+  _ts_param20(1, (0, import_common23.Body)()),
+  _ts_metadata20("design:type", Function),
+  _ts_metadata20("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof ApproveBody === "undefined" ? Object : ApproveBody
   ]),
-  _ts_metadata19("design:returntype", Promise)
+  _ts_metadata20("design:returntype", Promise)
 ], ToolCallController.prototype, "approve", null);
-_ts_decorate20([
-  (0, import_common21.Post)("reject"),
-  _ts_param18(0, (0, import_common21.Req)()),
-  _ts_param18(1, (0, import_common21.Body)()),
-  _ts_metadata19("design:type", Function),
-  _ts_metadata19("design:paramtypes", [
+_ts_decorate22([
+  (0, import_common23.Post)("reject"),
+  _ts_param20(0, (0, import_common23.Req)()),
+  _ts_param20(1, (0, import_common23.Body)()),
+  _ts_metadata20("design:type", Function),
+  _ts_metadata20("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof RejectBody === "undefined" ? Object : RejectBody
   ]),
-  _ts_metadata19("design:returntype", Promise)
+  _ts_metadata20("design:returntype", Promise)
 ], ToolCallController.prototype, "reject", null);
-_ts_decorate20([
-  (0, import_common21.Post)("answer"),
-  _ts_param18(0, (0, import_common21.Req)()),
-  _ts_param18(1, (0, import_common21.Body)()),
-  _ts_metadata19("design:type", Function),
-  _ts_metadata19("design:paramtypes", [
+_ts_decorate22([
+  (0, import_common23.Post)("answer"),
+  _ts_param20(0, (0, import_common23.Req)()),
+  _ts_param20(1, (0, import_common23.Body)()),
+  _ts_metadata20("design:type", Function),
+  _ts_metadata20("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof AnswerBody === "undefined" ? Object : AnswerBody
   ]),
-  _ts_metadata19("design:returntype", Promise)
+  _ts_metadata20("design:returntype", Promise)
 ], ToolCallController.prototype, "answer", null);
-_ts_decorate20([
-  (0, import_common21.Post)("skip"),
-  _ts_param18(0, (0, import_common21.Req)()),
-  _ts_param18(1, (0, import_common21.Body)()),
-  _ts_metadata19("design:type", Function),
-  _ts_metadata19("design:paramtypes", [
+_ts_decorate22([
+  (0, import_common23.Post)("skip"),
+  _ts_param20(0, (0, import_common23.Req)()),
+  _ts_param20(1, (0, import_common23.Body)()),
+  _ts_metadata20("design:type", Function),
+  _ts_metadata20("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     Object
   ]),
-  _ts_metadata19("design:returntype", Promise)
+  _ts_metadata20("design:returntype", Promise)
 ], ToolCallController.prototype, "skip", null);
-ToolCallController = _ts_decorate20([
-  (0, import_common21.Controller)("tool-call"),
-  _ts_param18(1, (0, import_common21.Inject)(import_nestjs_agent_core22.AGENT_ACTOR_RESOLVER)),
-  _ts_metadata19("design:type", Function),
-  _ts_metadata19("design:paramtypes", [
+ToolCallController = _ts_decorate22([
+  (0, import_common23.Controller)("tool-call"),
+  _ts_param20(1, (0, import_common23.Inject)(import_nestjs_agent_core26.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata20("design:type", Function),
+  _ts_metadata20("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ToolCallController);
 
 // src/controller/tools.controller.ts
-var import_nestjs_agent_core23 = require("@dudousxd/nestjs-agent-core");
-var import_common22 = require("@nestjs/common");
-function _ts_decorate21(decorators, target, key, desc) {
+var import_nestjs_agent_core27 = require("@dudousxd/nestjs-agent-core");
+var import_common24 = require("@nestjs/common");
+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);
@@ -4626,19 +5338,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_metadata21(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_metadata21, "_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 ToolsController = class {
   static {
     __name(this, "ToolsController");
@@ -4652,11 +5364,11 @@ var ToolsController = class {
     this.agents = agents;
   }
   async list(req, agent) {
-    if (agent !== void 0 && agent !== import_nestjs_agent_core23.ALL_AGENTS && this.agents.get(agent) === void 0) {
-      throw new import_common22.NotFoundException(`No agent named "${agent}"`);
+    if (agent !== void 0 && agent !== import_nestjs_agent_core27.ALL_AGENTS && this.agents.get(agent) === void 0) {
+      throw new import_common24.NotFoundException(`No agent named "${agent}"`);
     }
     const actor = await this.actorResolver.resolve(req);
-    const names = agent === import_nestjs_agent_core23.ALL_AGENTS ? [
+    const names = agent === import_nestjs_agent_core27.ALL_AGENTS ? [
       void 0,
       ...this.agents.list().map((definition) => definition.name)
     ] : [
@@ -4682,33 +5394,33 @@ var ToolsController = class {
     ];
   }
 };
-_ts_decorate21([
-  (0, import_common22.Get)(),
-  _ts_param19(0, (0, import_common22.Req)()),
-  _ts_param19(1, (0, import_common22.Query)("agent")),
-  _ts_metadata20("design:type", Function),
-  _ts_metadata20("design:paramtypes", [
+_ts_decorate23([
+  (0, import_common24.Get)(),
+  _ts_param21(0, (0, import_common24.Req)()),
+  _ts_param21(1, (0, import_common24.Query)("agent")),
+  _ts_metadata21("design:type", Function),
+  _ts_metadata21("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata20("design:returntype", Promise)
+  _ts_metadata21("design:returntype", Promise)
 ], ToolsController.prototype, "list", null);
-ToolsController = _ts_decorate21([
-  (0, import_common22.Controller)("tools"),
-  _ts_param19(0, (0, import_common22.Inject)(import_nestjs_agent_core23.AGENT_ACTOR_RESOLVER)),
-  _ts_param19(1, (0, import_common22.Inject)(import_nestjs_agent_core23.AGENT_DEPS_FACTORY)),
-  _ts_param19(2, (0, import_common22.Inject)(import_nestjs_agent_core23.AGENT_REGISTRY)),
-  _ts_metadata20("design:type", Function),
-  _ts_metadata20("design:paramtypes", [
+ToolsController = _ts_decorate23([
+  (0, import_common24.Controller)("tools"),
+  _ts_param21(0, (0, import_common24.Inject)(import_nestjs_agent_core27.AGENT_ACTOR_RESOLVER)),
+  _ts_param21(1, (0, import_common24.Inject)(import_nestjs_agent_core27.AGENT_DEPS_FACTORY)),
+  _ts_param21(2, (0, import_common24.Inject)(import_nestjs_agent_core27.AGENT_REGISTRY)),
+  _ts_metadata21("design:type", Function),
+  _ts_metadata21("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
-    typeof import_nestjs_agent_core23.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core23.AgentRegistry
+    typeof import_nestjs_agent_core27.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core27.AgentRegistry
   ])
 ], ToolsController);
 
 // src/discovery/agent-discovery.service.ts
-var import_nestjs_agent_core24 = require("@dudousxd/nestjs-agent-core");
-var import_common23 = require("@nestjs/common");
+var import_nestjs_agent_core28 = require("@dudousxd/nestjs-agent-core");
+var import_common25 = require("@nestjs/common");
 var import_core = require("@nestjs/core");
 
 // src/decorator/agent.decorator.ts
@@ -4725,7 +5437,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_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);
@@ -4738,19 +5450,19 @@ 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_metadata22(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_metadata22, "_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 AgentDiscoveryService = class _AgentDiscoveryService {
   static {
     __name(this, "AgentDiscoveryService");
@@ -4759,7 +5471,7 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
   scanner;
   registry;
   contributors;
-  logger = new import_common23.Logger(_AgentDiscoveryService.name);
+  logger = new import_common25.Logger(_AgentDiscoveryService.name);
   constructor(discovery, scanner, registry, contributors) {
     this.discovery = discovery;
     this.scanner = scanner;
@@ -4778,6 +5490,7 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
       }
       this.collectContributors(instance);
     }
+    this.assertPersonas(this.registry.list());
   }
   /** Build the internal {@link AgentDefinition} from an `@Agent` instance and its options. */
   definitionFrom(instance, meta) {
@@ -4821,10 +5534,48 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
       } : {},
       ...meta.handoff !== void 0 ? {
         delegatesTo: this.handoffEdges(meta)
+      } : {},
+      ...meta.personas !== void 0 ? {
+        personas: meta.personas
+      } : {},
+      ...meta.defaultPersona !== void 0 ? {
+        defaultPersona: meta.defaultPersona
       } : {}
     };
   }
   /**
+  * Refuse to boot on a persona declaration that could only fail later, per request: a default that
+  * names no persona, an id declared twice, an alias two personas claim, or an alias that is a real
+  * agent's name (which would never be reached — a registered agent always wins).
+  */
+  assertPersonas(definitions) {
+    const agentNames = new Set(definitions.map((definition) => definition.name));
+    const aliasOwner = /* @__PURE__ */ new Map();
+    for (const definition of definitions) {
+      const ids = /* @__PURE__ */ new Set();
+      for (const persona of definition.personas ?? []) {
+        if (ids.has(persona.id)) {
+          throw new Error(`Agent "${definition.name}" declares persona "${persona.id}" twice.`);
+        }
+        ids.add(persona.id);
+        for (const alias of persona.aliases ?? []) {
+          const owner = `${definition.name}/${persona.id}`;
+          if (agentNames.has(alias)) {
+            throw new Error(`Persona ${owner} claims the alias "${alias}", which is a registered agent's name.`);
+          }
+          const previous = aliasOwner.get(alias);
+          if (previous !== void 0) {
+            throw new Error(`Personas ${previous} and ${owner} both claim the alias "${alias}".`);
+          }
+          aliasOwner.set(alias, owner);
+        }
+      }
+      if (definition.defaultPersona !== void 0 && !ids.has(definition.defaultPersona)) {
+        throw new Error(`Agent "${definition.name}" names "${definition.defaultPersona}" as its default persona, but declares no persona with that id.`);
+      }
+    }
+  }
+  /**
   * Resolve each handoff entry to an {@link AgentDelegation} — its target's registered name, plus
   * whether that edge detaches (skipping non-agent classes). A bare name is kept for a plain edge
   * rather than an always-object form, so a definition an older host built by hand still reads.
@@ -4877,22 +5628,22 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
     return (ctx) => candidate.call(instance, ctx);
   }
 };
-AgentDiscoveryService = _ts_decorate22([
-  (0, import_common23.Injectable)(),
-  _ts_param20(2, (0, import_common23.Inject)(import_nestjs_agent_core24.AGENT_REGISTRY)),
-  _ts_param20(3, (0, import_common23.Inject)(import_nestjs_agent_core24.AGENT_PROMPT_CONTRIBUTORS)),
-  _ts_metadata21("design:type", Function),
-  _ts_metadata21("design:paramtypes", [
+AgentDiscoveryService = _ts_decorate24([
+  (0, import_common25.Injectable)(),
+  _ts_param22(2, (0, import_common25.Inject)(import_nestjs_agent_core28.AGENT_REGISTRY)),
+  _ts_param22(3, (0, import_common25.Inject)(import_nestjs_agent_core28.AGENT_PROMPT_CONTRIBUTORS)),
+  _ts_metadata22("design:type", Function),
+  _ts_metadata22("design:paramtypes", [
     typeof import_core.DiscoveryService === "undefined" ? Object : import_core.DiscoveryService,
     typeof import_core.MetadataScanner === "undefined" ? Object : import_core.MetadataScanner,
-    typeof import_nestjs_agent_core24.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core24.AgentRegistry,
+    typeof import_nestjs_agent_core28.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core28.AgentRegistry,
     Array
   ])
 ], AgentDiscoveryService);
 
 // src/discovery/ai-tool-discovery.service.ts
-var import_nestjs_agent_core25 = require("@dudousxd/nestjs-agent-core");
-var import_common24 = require("@nestjs/common");
+var import_nestjs_agent_core29 = require("@dudousxd/nestjs-agent-core");
+var import_common26 = require("@nestjs/common");
 var import_core2 = require("@nestjs/core");
 var import_zod = require("zod");
 
@@ -4904,15 +5655,8 @@ function readAiToolMetadata(target) {
 }
 __name(readAiToolMetadata, "readAiToolMetadata");
 
-// src/functional-tool.ts
-var AGENT_TOOL_BRAND = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:functional-tool");
-function isBrandedFunctionalTool(value) {
-  return AGENT_TOOL_BRAND in value && "spec" in value && "handler" in value;
-}
-__name(isBrandedFunctionalTool, "isBrandedFunctionalTool");
-
 // src/discovery/ai-tool-discovery.service.ts
-function _ts_decorate23(decorators, target, key, desc) {
+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);
@@ -4925,19 +5669,19 @@ 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_metadata23(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_metadata23, "_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 AiToolDiscoveryService = class _AiToolDiscoveryService {
   static {
     __name(this, "AiToolDiscoveryService");
@@ -4946,7 +5690,7 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
   registry;
   agents;
   options;
-  logger = new import_common24.Logger(_AiToolDiscoveryService.name);
+  logger = new import_common26.Logger(_AiToolDiscoveryService.name);
   constructor(discovery, registry, agents, options) {
     this.discovery = discovery;
     this.registry = registry;
@@ -5005,9 +5749,15 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
         } : {},
         ...meta.terminal === true ? {
           terminal: true
+        } : {},
+        ...meta.replacementKey !== void 0 ? {
+          replacementKey: meta.replacementKey
         } : {}
       }, {
         execute: /* @__PURE__ */ __name((input, ctx) => instance.execute(input, ctx), "execute"),
+        ...typeof handler.preflight === "function" ? {
+          preflight: /* @__PURE__ */ __name((input, ctx, options) => instance.preflight(input, ctx, options), "preflight")
+        } : {},
         // Forwarded, not copied: the registry holds this wrapper rather than the provider, so an
         // `isEnabled()`/`canUse()` left behind here would be a gate that silently never applies.
         // Called through `instance` so each keeps its `this` (and its injected deps).
@@ -5031,7 +5781,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_core25.normalizeDelegation)(edge);
+        const { agent: target, detached } = (0, import_nestjs_agent_core29.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.`);
@@ -5081,13 +5831,13 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
     return true;
   }
 };
-AiToolDiscoveryService = _ts_decorate23([
-  (0, import_common24.Injectable)(),
-  _ts_param21(1, (0, import_common24.Inject)(import_nestjs_agent_core25.AGENT_TOOL_REGISTRY)),
-  _ts_param21(2, (0, import_common24.Inject)(import_nestjs_agent_core25.AGENT_REGISTRY)),
-  _ts_param21(3, (0, import_common24.Inject)(import_nestjs_agent_core25.AGENT_OPTIONS)),
-  _ts_metadata22("design:type", Function),
-  _ts_metadata22("design:paramtypes", [
+AiToolDiscoveryService = _ts_decorate25([
+  (0, import_common26.Injectable)(),
+  _ts_param23(1, (0, import_common26.Inject)(import_nestjs_agent_core29.AGENT_TOOL_REGISTRY)),
+  _ts_param23(2, (0, import_common26.Inject)(import_nestjs_agent_core29.AGENT_REGISTRY)),
+  _ts_param23(3, (0, import_common26.Inject)(import_nestjs_agent_core29.AGENT_OPTIONS)),
+  _ts_metadata23("design:type", Function),
+  _ts_metadata23("design:paramtypes", [
     typeof import_core2.DiscoveryService === "undefined" ? Object : import_core2.DiscoveryService,
     typeof ToolRegistry === "undefined" ? Object : ToolRegistry,
     typeof AgentRegistry === "undefined" ? Object : AgentRegistry,
@@ -5096,25 +5846,25 @@ AiToolDiscoveryService = _ts_decorate23([
 ], AiToolDiscoveryService);
 
 // src/discovery/skill-discovery.service.ts
-var import_nestjs_agent_core27 = require("@dudousxd/nestjs-agent-core");
-var import_common25 = require("@nestjs/common");
+var import_nestjs_agent_core31 = require("@dudousxd/nestjs-agent-core");
+var import_common27 = 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_core26 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core30 = 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_core26.GLOBAL_SCOPE;
+  return options.scope ?? import_nestjs_agent_core30.GLOBAL_SCOPE;
 }
 __name(skillScope, "skillScope");
 
 // src/discovery/skill-discovery.service.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);
@@ -5127,26 +5877,26 @@ function _ts_decorate24(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate24, "_ts_decorate");
-function _ts_metadata23(metadataKey, metadataValue) {
+__name(_ts_decorate26, "_ts_decorate");
+function _ts_metadata24(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata23, "_ts_metadata");
-function _ts_param22(paramIndex, decorator) {
+__name(_ts_metadata24, "_ts_metadata");
+function _ts_param24(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param22, "_ts_param");
+__name(_ts_param24, "_ts_param");
 var SkillDiscoveryService = class _SkillDiscoveryService {
   static {
     __name(this, "SkillDiscoveryService");
   }
   discovery;
   declared;
-  logger = new import_common25.Logger(_SkillDiscoveryService.name);
+  logger = new import_common27.Logger(_SkillDiscoveryService.name);
   constructor(discovery, declared) {
     this.discovery = discovery;
     this.declared = declared;
@@ -5183,18 +5933,18 @@ var SkillDiscoveryService = class _SkillDiscoveryService {
     return flat === void 0 ? void 0 : () => flat;
   }
 };
-SkillDiscoveryService = _ts_decorate24([
-  (0, import_common25.Injectable)(),
-  _ts_param22(1, (0, import_common25.Inject)(import_nestjs_agent_core27.AGENT_SKILL_SOURCES)),
-  _ts_metadata23("design:type", Function),
-  _ts_metadata23("design:paramtypes", [
+SkillDiscoveryService = _ts_decorate26([
+  (0, import_common27.Injectable)(),
+  _ts_param24(1, (0, import_common27.Inject)(import_nestjs_agent_core31.AGENT_SKILL_SOURCES)),
+  _ts_metadata24("design:type", Function),
+  _ts_metadata24("design:paramtypes", [
     typeof import_core3.DiscoveryService === "undefined" ? Object : import_core3.DiscoveryService,
     Array
   ])
 ], SkillDiscoveryService);
 
 // src/ledger-quota-provider.ts
-var import_nestjs_agent_core28 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core32 = require("@dudousxd/nestjs-agent-core");
 var LedgerQuotaProvider = class {
   static {
     __name(this, "LedgerQuotaProvider");
@@ -5214,12 +5964,12 @@ var LedgerQuotaProvider = class {
       await this.dayWindow(actorRef, now)
     ];
     if (this.store.usageBetween !== void 0) {
-      const range = (0, import_nestjs_agent_core28.quotaPeriodRange)("month", now);
+      const range = (0, import_nestjs_agent_core32.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_core28.exhaustedWindow)(windows);
-    const warning = (0, import_nestjs_agent_core28.quotaWarning)(windows);
+    const blocked = (0, import_nestjs_agent_core32.exhaustedWindow)(windows);
+    const warning = (0, import_nestjs_agent_core32.quotaWarning)(windows);
     return {
       windows,
       ...blocked !== void 0 ? {
@@ -5231,7 +5981,7 @@ var LedgerQuotaProvider = class {
     };
   }
   async dayWindow(actorRef, now) {
-    const range = (0, import_nestjs_agent_core28.quotaPeriodRange)("day", now);
+    const range = (0, import_nestjs_agent_core32.quotaPeriodRange)("day", now);
     const { usedTokens, costUsd } = await this.store.quotaToday(actorRef, range.fromDay);
     return this.window("day", usedTokens, costUsd, range.resetsAt);
   }
@@ -5255,10 +6005,245 @@ var LedgerQuotaProvider = class {
   }
 };
 
+// src/proposals/action-proposal-worker.service.ts
+var import_node_crypto3 = require("crypto");
+var import_nestjs_agent_core33 = require("@dudousxd/nestjs-agent-core");
+var import_common28 = require("@nestjs/common");
+function _ts_decorate27(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_decorate27, "_ts_decorate");
+function _ts_metadata25(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
+}
+__name(_ts_metadata25, "_ts_metadata");
+function _ts_param25(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param25, "_ts_param");
+var ActionProposalWorkerService = class _ActionProposalWorkerService {
+  static {
+    __name(this, "ActionProposalWorkerService");
+  }
+  store;
+  options;
+  deps;
+  worker;
+  logger = new import_common28.Logger(_ActionProposalWorkerService.name);
+  constructor(store, options, deps) {
+    this.store = store;
+    this.options = options;
+    this.deps = deps;
+  }
+  onModuleInit() {
+    if (this.options.actionApprovalMode !== "independent") return;
+    (0, import_nestjs_agent_core33.assertIndependentActionCapabilities)(this.store, this.options.backgroundActorResolver);
+    if (this.options.surface === "http") return;
+    const resolver = this.options.backgroundActorResolver;
+    if (!resolver) throw new Error("BackgroundActorResolver is required");
+    this.worker = new import_nestjs_agent_core33.ActionProposalWorker({
+      store: this.store,
+      workerId: (0, import_node_crypto3.randomUUID)(),
+      ...this.options.actionProposalWorker,
+      executor: new import_nestjs_agent_core33.ActionProposalExecutor({
+        resolver,
+        resolveExecution: /* @__PURE__ */ __name(async (proposal, actor) => {
+          const deps = this.deps.forProposal(proposal, actor);
+          return {
+            registry: deps.registry,
+            rolesPolicy: deps.rolesPolicy,
+            ...deps.resolveUiCatalog !== void 0 ? {
+              resolveUiCatalog: deps.resolveUiCatalog
+            } : {},
+            ...deps.toolAllowList !== void 0 ? {
+              allowedTools: deps.toolAllowList
+            } : {}
+          };
+        }, "resolveExecution")
+      }),
+      onError: /* @__PURE__ */ __name((error) => this.logger.error(error), "onError")
+    });
+    this.worker.start();
+  }
+  async onModuleDestroy() {
+    await this.worker?.stop();
+  }
+};
+ActionProposalWorkerService = _ts_decorate27([
+  (0, import_common28.Injectable)(),
+  _ts_param25(0, (0, import_common28.Inject)(import_nestjs_agent_core33.AGENT_STORE)),
+  _ts_param25(1, (0, import_common28.Inject)(import_nestjs_agent_core33.AGENT_OPTIONS)),
+  _ts_param25(2, (0, import_common28.Inject)(import_nestjs_agent_core33.AGENT_DEPS_FACTORY)),
+  _ts_metadata25("design:type", Function),
+  _ts_metadata25("design:paramtypes", [
+    typeof AgentStore === "undefined" ? Object : AgentStore,
+    typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
+    typeof AgentDepsFactory2 === "undefined" ? Object : AgentDepsFactory2
+  ])
+], ActionProposalWorkerService);
+
+// src/proposals/action-proposal.controller.ts
+var import_nestjs_agent_core34 = require("@dudousxd/nestjs-agent-core");
+var import_common29 = require("@nestjs/common");
+function _ts_decorate28(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_decorate28, "_ts_decorate");
+function _ts_metadata26(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
+}
+__name(_ts_metadata26, "_ts_metadata");
+function _ts_param26(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param26, "_ts_param");
+function bodyFields(body, field) {
+  if (body === void 0) return {};
+  if (typeof body !== "object" || body === null || Array.isArray(body) || Object.keys(body).some((key) => key !== field)) throw new import_common29.BadRequestException(`Only ${field} is accepted`);
+  const value = body;
+  if (value[field] !== void 0 && (field === "remember" && typeof value[field] !== "boolean" || field === "reason" && typeof value[field] !== "string")) throw new import_common29.BadRequestException(`Invalid ${field}`);
+  return value;
+}
+__name(bodyFields, "bodyFields");
+var ActionProposalController = class {
+  static {
+    __name(this, "ActionProposalController");
+  }
+  proposals;
+  actors;
+  constructor(proposals, actors) {
+    this.proposals = proposals;
+    this.actors = actors;
+  }
+  async list(threadId, request, cursor, response) {
+    let query = {};
+    if (cursor !== void 0) {
+      try {
+        if (typeof cursor !== "string") throw new Error("Invalid cursor");
+        query = {
+          after: JSON.parse(cursor)
+        };
+        (0, import_nestjs_agent_core34.validateActionProposalListQuery)(query);
+      } catch {
+        throw new import_common29.BadRequestException("Invalid action proposal cursor");
+      }
+    }
+    const page = await this.proposals.listPage(threadId, await this.actors.resolve(request), query);
+    if (page.next) {
+      response.setHeader("X-Action-Proposals-Next", encodeURIComponent(JSON.stringify(page.next)));
+      const exposed = response.getHeader("Access-Control-Expose-Headers");
+      response.setHeader("Access-Control-Expose-Headers", `${exposed === void 0 ? "" : `${String(exposed)}, `}X-Action-Proposals-Next`);
+    }
+    return page.items;
+  }
+  async approve(threadId, proposalId, request, body) {
+    const value = bodyFields(body, "remember");
+    return this.proposals.decide(threadId, proposalId, await this.actors.resolve(request), {
+      decision: "approved",
+      ...typeof value.remember === "boolean" ? {
+        remember: value.remember
+      } : {}
+    });
+  }
+  async reject(threadId, proposalId, request, body) {
+    const value = bodyFields(body, "reason");
+    return this.proposals.decide(threadId, proposalId, await this.actors.resolve(request), {
+      decision: "rejected",
+      ...typeof value.reason === "string" ? {
+        reason: value.reason
+      } : {}
+    });
+  }
+};
+_ts_decorate28([
+  (0, import_common29.Get)(),
+  _ts_param26(0, (0, import_common29.Param)("threadId")),
+  _ts_param26(1, (0, import_common29.Req)()),
+  _ts_param26(2, (0, import_common29.Query)("after")),
+  _ts_param26(3, (0, import_common29.Res)({
+    passthrough: true
+  })),
+  _ts_metadata26("design:type", Function),
+  _ts_metadata26("design:paramtypes", [
+    String,
+    typeof Request === "undefined" ? Object : Request,
+    Object,
+    typeof Response === "undefined" ? Object : Response
+  ]),
+  _ts_metadata26("design:returntype", Promise)
+], ActionProposalController.prototype, "list", null);
+_ts_decorate28([
+  (0, import_common29.Post)(":proposalId/approve"),
+  _ts_param26(0, (0, import_common29.Param)("threadId")),
+  _ts_param26(1, (0, import_common29.Param)("proposalId")),
+  _ts_param26(2, (0, import_common29.Req)()),
+  _ts_param26(3, (0, import_common29.Body)()),
+  _ts_metadata26("design:type", Function),
+  _ts_metadata26("design:paramtypes", [
+    String,
+    String,
+    typeof Request === "undefined" ? Object : Request,
+    Object
+  ]),
+  _ts_metadata26("design:returntype", Promise)
+], ActionProposalController.prototype, "approve", null);
+_ts_decorate28([
+  (0, import_common29.Post)(":proposalId/reject"),
+  _ts_param26(0, (0, import_common29.Param)("threadId")),
+  _ts_param26(1, (0, import_common29.Param)("proposalId")),
+  _ts_param26(2, (0, import_common29.Req)()),
+  _ts_param26(3, (0, import_common29.Body)()),
+  _ts_metadata26("design:type", Function),
+  _ts_metadata26("design:paramtypes", [
+    String,
+    String,
+    typeof Request === "undefined" ? Object : Request,
+    Object
+  ]),
+  _ts_metadata26("design:returntype", Promise)
+], ActionProposalController.prototype, "reject", null);
+ActionProposalController = _ts_decorate28([
+  (0, import_common29.Controller)("threads/:threadId/action-proposals"),
+  _ts_param26(1, (0, import_common29.Inject)(import_nestjs_agent_core34.AGENT_ACTOR_RESOLVER)),
+  _ts_metadata26("design:type", Function),
+  _ts_metadata26("design:paramtypes", [
+    typeof ActionProposalService === "undefined" ? Object : ActionProposalService,
+    typeof ActorResolver === "undefined" ? Object : ActorResolver
+  ])
+], ActionProposalController);
+
 // src/runner/inline-agent-runner.ts
-var import_nestjs_agent_core29 = require("@dudousxd/nestjs-agent-core");
-var import_common26 = require("@nestjs/common");
-function _ts_decorate25(decorators, target, key, desc) {
+var import_nestjs_agent_core35 = require("@dudousxd/nestjs-agent-core");
+var import_common30 = require("@nestjs/common");
+function _ts_decorate29(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);
@@ -5271,19 +6256,19 @@ function _ts_decorate25(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate25, "_ts_decorate");
-function _ts_metadata24(metadataKey, metadataValue) {
+__name(_ts_decorate29, "_ts_decorate");
+function _ts_metadata27(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata24, "_ts_metadata");
-function _ts_param23(paramIndex, decorator) {
+__name(_ts_metadata27, "_ts_metadata");
+function _ts_param27(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param23, "_ts_param");
+__name(_ts_param27, "_ts_param");
 var InlineAgentRunner = class _InlineAgentRunner {
   static {
     __name(this, "InlineAgentRunner");
@@ -5291,7 +6276,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
   factory;
   store;
   queue;
-  logger = new import_common26.Logger(_InlineAgentRunner.name);
+  logger = new import_common30.Logger(_InlineAgentRunner.name);
   pending = /* @__PURE__ */ new Map();
   /**
   * Runs someone has asked to stop. In-process, like `pending`, and for the same reason: this runner
@@ -5340,18 +6325,18 @@ var InlineAgentRunner = class _InlineAgentRunner {
       ],
       input
     });
-    void (0, import_nestjs_agent_core29.runAgentLoop)({
+    void (0, import_nestjs_agent_core35.runAgentLoop)({
       ...deps,
       day
-    }, input, hooks).then(() => (0, import_nestjs_agent_core29.releaseThreadRun)(this.store, input.threadId, runId)).catch(async (error) => {
-      if (error instanceof import_nestjs_agent_core29.RunCancelledError) {
+    }, input, hooks).then(() => (0, import_nestjs_agent_core35.releaseThreadRun)(this.store, input.threadId, runId)).catch(async (error) => {
+      if (error instanceof import_nestjs_agent_core35.RunCancelledError) {
         await this.settleCancelled(runId, input, deps);
         return;
       }
       const message = error instanceof Error ? error.message : String(error);
-      const code = (0, import_nestjs_agent_core29.agentFailureCode)(error);
+      const code = (0, import_nestjs_agent_core35.agentFailureCode)(error);
       this.logger.error(`agent run ${runId} failed (${code}): ${message}`);
-      (0, import_nestjs_agent_core29.publishAgentRunFailed)({
+      (0, import_nestjs_agent_core35.publishAgentRunFailed)({
         runId,
         code,
         message
@@ -5362,11 +6347,11 @@ var InlineAgentRunner = class _InlineAgentRunner {
         errorCode: code,
         errorMessage: message
       });
-      await Promise.resolve(this.store.failUnsettledToolCalls?.(runId, import_nestjs_agent_core29.RUN_ENDED_BEFORE_TOOL_CALL)).catch(() => 0);
+      await Promise.resolve(this.store.failUnsettledToolCalls?.(runId, import_nestjs_agent_core35.RUN_ENDED_BEFORE_TOOL_CALL)).catch(() => 0);
       const writer = await deps.sink.open(runId);
       await this.settleQueue(writer, input, runId, "failed", message);
-      await (0, import_nestjs_agent_core29.releaseThreadRun)(this.store, input.threadId, runId);
-      await writer.fail((0, import_nestjs_agent_core29.streamFailure)(error));
+      await (0, import_nestjs_agent_core35.releaseThreadRun)(this.store, input.threadId, runId);
+      await writer.fail((0, import_nestjs_agent_core35.streamFailure)(error));
     }).finally(() => {
       this.cancelled.delete(runId);
       this.live.delete(runId);
@@ -5402,7 +6387,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_core29.RunCancelledError());
+        waiter.reject(new import_nestjs_agent_core35.RunCancelledError());
       }
     }
     await Promise.resolve();
@@ -5417,8 +6402,8 @@ var InlineAgentRunner = class _InlineAgentRunner {
     this.logger.log(`agent run ${runId} cancelled`);
     const writer = await deps.sink.open(runId);
     await this.settleQueue(writer, input, runId, "cancelled");
-    await (0, import_nestjs_agent_core29.releaseThreadRun)(this.store, input.threadId, runId);
-    await writer.write((0, import_nestjs_agent_core29.encodeStreamEvent)({
+    await (0, import_nestjs_agent_core35.releaseThreadRun)(this.store, input.threadId, runId);
+    await writer.write((0, import_nestjs_agent_core35.encodeStreamEvent)({
       kind: "cancelled"
     }));
     await writer.end();
@@ -5453,7 +6438,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
         runId: nextRunId
       }));
       if (frame !== void 0) {
-        await writer.write((0, import_nestjs_agent_core29.encodeStreamEvent)(frame));
+        await writer.write((0, import_nestjs_agent_core35.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)}`);
@@ -5524,7 +6509,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_core29.settleAll,
+      parallel: import_nestjs_agent_core35.settleAll,
       cancelled: /* @__PURE__ */ __name(async () => this.cancelled.has(runId), "cancelled"),
       runAgent: /* @__PURE__ */ __name((agentName, task) => this.runNested({
         agentName,
@@ -5575,7 +6560,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_core29.settleAll,
+      parallel: import_nestjs_agent_core35.settleAll,
       cancelled: /* @__PURE__ */ __name(async () => this.cancelled.has(runId), "cancelled"),
       runAgent: /* @__PURE__ */ __name((childName, childTask) => this.runNested({
         agentName: childName,
@@ -5608,7 +6593,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
         }
       }), "startAgent")
     };
-    void (0, import_nestjs_agent_core29.runAgentLoop)({
+    void (0, import_nestjs_agent_core35.runAgentLoop)({
       ...deps,
       day
     }, {
@@ -5622,13 +6607,13 @@ var InlineAgentRunner = class _InlineAgentRunner {
       parentRunId,
       deliverTo
     }, hooks).catch(async (error) => {
-      const cancelled = error instanceof import_nestjs_agent_core29.RunCancelledError;
+      const cancelled = error instanceof import_nestjs_agent_core35.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_core29.publishAgentRunFailed)({
+        (0, import_nestjs_agent_core35.publishAgentRunFailed)({
           runId,
-          code: (0, import_nestjs_agent_core29.agentFailureCode)(error),
+          code: (0, import_nestjs_agent_core35.agentFailureCode)(error),
           message
         });
       }
@@ -5636,12 +6621,12 @@ var InlineAgentRunner = class _InlineAgentRunner {
         runId,
         status: cancelled ? "cancelled" : "failed",
         ...cancelled ? {} : {
-          errorCode: (0, import_nestjs_agent_core29.agentFailureCode)(error),
+          errorCode: (0, import_nestjs_agent_core35.agentFailureCode)(error),
           errorMessage: message
         }
       });
-      await Promise.resolve(this.store.failUnsettledToolCalls?.(runId, import_nestjs_agent_core29.RUN_ENDED_BEFORE_TOOL_CALL)).catch(() => 0);
-      await (0, import_nestjs_agent_core29.settleUnsettledDelegation)({
+      await Promise.resolve(this.store.failUnsettledToolCalls?.(runId, import_nestjs_agent_core35.RUN_ENDED_BEFORE_TOOL_CALL)).catch(() => 0);
+      await (0, import_nestjs_agent_core35.settleUnsettledDelegation)({
         store: this.store,
         delivery: deliverTo,
         agent: agentName,
@@ -5680,7 +6665,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_core29.settleAll,
+      parallel: import_nestjs_agent_core35.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"),
@@ -5715,7 +6700,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
       }), "startAgent")
     };
     try {
-      return await (0, import_nestjs_agent_core29.runAgentLoop)({
+      return await (0, import_nestjs_agent_core35.runAgentLoop)({
         ...deps,
         day
       }, {
@@ -5734,13 +6719,13 @@ var InlineAgentRunner = class _InlineAgentRunner {
     }
   }
 };
-InlineAgentRunner = _ts_decorate25([
-  (0, import_common26.Injectable)(),
-  _ts_param23(0, (0, import_common26.Inject)(import_nestjs_agent_core29.AGENT_DEPS_FACTORY)),
-  _ts_param23(1, (0, import_common26.Inject)(import_nestjs_agent_core29.AGENT_STORE)),
-  _ts_param23(2, (0, import_common26.Optional)()),
-  _ts_metadata24("design:type", Function),
-  _ts_metadata24("design:paramtypes", [
+InlineAgentRunner = _ts_decorate29([
+  (0, import_common30.Injectable)(),
+  _ts_param27(0, (0, import_common30.Inject)(import_nestjs_agent_core35.AGENT_DEPS_FACTORY)),
+  _ts_param27(1, (0, import_common30.Inject)(import_nestjs_agent_core35.AGENT_STORE)),
+  _ts_param27(2, (0, import_common30.Optional)()),
+  _ts_metadata27("design:type", Function),
+  _ts_metadata27("design:paramtypes", [
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
     typeof AgentStore === "undefined" ? Object : AgentStore,
     typeof ChatQueueService2 === "undefined" ? Object : ChatQueueService2
@@ -5752,7 +6737,7 @@ function isThreadTurn2(input) {
 __name(isThreadTurn2, "isThreadTurn");
 
 // src/skills-config.ts
-var import_nestjs_agent_core30 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core36 = require("@dudousxd/nestjs-agent-core");
 function declaredSkillProvider(declared) {
   return {
     list: /* @__PURE__ */ __name(({ scopes }) => declared.filter((skill) => scopes.includes(skill.scope)).map(({ name, description, scope }) => ({
@@ -5778,7 +6763,7 @@ function resolveSkillsConfig(options, declared) {
     declaredSkillProvider(declared)
   ];
   return {
-    provider: providers.length === 1 ? providers[0] : (0, import_nestjs_agent_core30.compositeSkillProvider)(providers),
+    provider: providers.length === 1 ? providers[0] : (0, import_nestjs_agent_core36.compositeSkillProvider)(providers),
     ...options.scopes !== void 0 ? {
       scopes: options.scopes
     } : {},
@@ -5790,7 +6775,7 @@ function resolveSkillsConfig(options, declared) {
 __name(resolveSkillsConfig, "resolveSkillsConfig");
 
 // src/agent.module.ts
-function _ts_decorate26(decorators, target, key, desc) {
+function _ts_decorate30(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);
@@ -5803,13 +6788,13 @@ function _ts_decorate26(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate26, "_ts_decorate");
+__name(_ts_decorate30, "_ts_decorate");
 var DEFAULT_PATH = "agent";
-var logger = new import_common27.Logger("AgentModule");
+var logger = new import_common31.Logger("AgentModule");
 function externalStoreWrapper(modules) {
   for (const module2 of modules.values()) {
     if (module2.metatype === AgentModule) continue;
-    const wrapper = module2.providers.get(import_nestjs_agent_core31.AGENT_STORE);
+    const wrapper = module2.providers.get(import_nestjs_agent_core37.AGENT_STORE);
     if (wrapper !== void 0) return wrapper;
   }
   return void 0;
@@ -5840,7 +6825,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_core31.InMemoryAgentStore();
+  return new import_nestjs_agent_core37.InMemoryAgentStore();
 }
 __name(resolveStore, "resolveStore");
 function isQuotaProvider(quota) {
@@ -5856,99 +6841,99 @@ __name(resolveCatalog, "resolveCatalog");
 function sharedProviders(durable) {
   const providers = [
     {
-      provide: import_nestjs_agent_core31.AGENT_TOOL_REGISTRY,
-      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core31.ToolRegistry(), "useFactory")
+      provide: import_nestjs_agent_core37.AGENT_TOOL_REGISTRY,
+      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core37.ToolRegistry(), "useFactory")
     },
     // Starts empty; AgentDiscoveryService populates it from `@Agent`-decorated providers at boot.
     {
-      provide: import_nestjs_agent_core31.AGENT_REGISTRY,
-      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core31.AgentRegistry(), "useFactory")
+      provide: import_nestjs_agent_core37.AGENT_REGISTRY,
+      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core37.AgentRegistry(), "useFactory")
     },
     // A shared, mutable list AgentDiscoveryService fills with `@SystemPromptContributor()` methods.
     {
-      provide: import_nestjs_agent_core31.AGENT_PROMPT_CONTRIBUTORS,
+      provide: import_nestjs_agent_core37.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_core31.AGENT_SKILL_SOURCES,
+      provide: import_nestjs_agent_core37.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_core31.AGENT_SKILLS,
+      provide: import_nestjs_agent_core37.AGENT_SKILLS,
       useFactory: /* @__PURE__ */ __name((options, declared) => resolveSkillsConfig(options.skills, declared), "useFactory"),
       inject: [
-        import_nestjs_agent_core31.AGENT_OPTIONS,
-        import_nestjs_agent_core31.AGENT_SKILL_SOURCES
+        import_nestjs_agent_core37.AGENT_OPTIONS,
+        import_nestjs_agent_core37.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_core31.AGENT_MEMORY,
+      provide: import_nestjs_agent_core37.AGENT_MEMORY,
       useFactory: /* @__PURE__ */ __name((options) => options.memory, "useFactory"),
       inject: [
-        import_nestjs_agent_core31.AGENT_OPTIONS
+        import_nestjs_agent_core37.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core31.AGENT_SINK,
+      provide: import_nestjs_agent_core37.AGENT_SINK,
       useFactory: /* @__PURE__ */ __name((options) => options.sink ?? new InProcessTokenStreamSink(), "useFactory"),
       inject: [
-        import_nestjs_agent_core31.AGENT_OPTIONS
+        import_nestjs_agent_core37.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core31.AGENT_ROLES_POLICY,
-      useFactory: /* @__PURE__ */ __name((options) => options.rolesPolicy ?? (options.emptyRoles === "deny" ? new import_nestjs_agent_core31.ClosedRolesPolicy(options.defaultRoles) : new import_nestjs_agent_core31.DefaultRolesPolicy(options.defaultRoles)), "useFactory"),
+      provide: import_nestjs_agent_core37.AGENT_ROLES_POLICY,
+      useFactory: /* @__PURE__ */ __name((options) => options.rolesPolicy ?? (options.emptyRoles === "deny" ? new import_nestjs_agent_core37.ClosedRolesPolicy(options.defaultRoles) : new import_nestjs_agent_core37.DefaultRolesPolicy(options.defaultRoles)), "useFactory"),
       inject: [
-        import_nestjs_agent_core31.AGENT_OPTIONS
+        import_nestjs_agent_core37.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core31.AGENT_ACTOR_RESOLVER,
+      provide: import_nestjs_agent_core37.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_core31.AGENT_OPTIONS
+        import_nestjs_agent_core37.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core31.AGENT_MODEL,
+      provide: import_nestjs_agent_core37.AGENT_MODEL,
       useFactory: /* @__PURE__ */ __name((o) => o.model, "useFactory"),
       inject: [
-        import_nestjs_agent_core31.AGENT_OPTIONS
+        import_nestjs_agent_core37.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_core31.AGENT_QUOTA_PROVIDER,
+      provide: import_nestjs_agent_core37.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_core31.AGENT_OPTIONS,
-        import_nestjs_agent_core31.AGENT_STORE
+        import_nestjs_agent_core37.AGENT_OPTIONS,
+        import_nestjs_agent_core37.AGENT_STORE
       ]
     },
     {
-      provide: import_nestjs_agent_core31.AGENT_MODEL_CATALOG,
+      provide: import_nestjs_agent_core37.AGENT_MODEL_CATALOG,
       useFactory: /* @__PURE__ */ __name((o) => resolveCatalog(o), "useFactory"),
       inject: [
-        import_nestjs_agent_core31.AGENT_OPTIONS
+        import_nestjs_agent_core37.AGENT_OPTIONS
       ]
     },
     AgentDepsFactory2,
     {
-      provide: import_nestjs_agent_core31.AGENT_DEPS_FACTORY,
+      provide: import_nestjs_agent_core37.AGENT_DEPS_FACTORY,
       useExisting: AgentDepsFactory2
     },
     // Populates the registry + contributors (onModuleInit) BEFORE AiToolDiscoveryService synthesizes
@@ -5965,25 +6950,27 @@ function sharedProviders(durable) {
     },
     InlineAgentRunner,
     AgentService,
+    ActionProposalService,
+    ActionProposalWorkerService,
     // 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_core31.AGENT_APPROVAL_PORT,
+      provide: import_nestjs_agent_core37.AGENT_APPROVAL_PORT,
       useExisting: AgentApprovalPortAdapter
     }
   ];
   providers.push({
-    provide: import_nestjs_agent_core31.AGENT_STORE,
+    provide: import_nestjs_agent_core37.AGENT_STORE,
     useFactory: /* @__PURE__ */ __name((o, modules) => resolveStore(o, modules), "useFactory"),
     inject: [
-      import_nestjs_agent_core31.AGENT_OPTIONS,
+      import_nestjs_agent_core37.AGENT_OPTIONS,
       import_core4.ModulesContainer
     ]
   });
   if (durable) {
     providers.push({
-      provide: import_nestjs_agent_core31.AGENT_RUNNER,
+      provide: import_nestjs_agent_core37.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.");
@@ -5992,14 +6979,14 @@ function sharedProviders(durable) {
       }, "useFactory"),
       inject: [
         {
-          token: import_nestjs_agent_core31.AGENT_DURABLE_RUNNER,
+          token: import_nestjs_agent_core37.AGENT_DURABLE_RUNNER,
           optional: true
         }
       ]
     });
   } else {
     providers.push({
-      provide: import_nestjs_agent_core31.AGENT_RUNNER,
+      provide: import_nestjs_agent_core37.AGENT_RUNNER,
       useExisting: InlineAgentRunner
     });
   }
@@ -6008,30 +6995,33 @@ function sharedProviders(durable) {
 __name(sharedProviders, "sharedProviders");
 function exportsFor() {
   return [
-    import_nestjs_agent_core31.AGENT_OPTIONS,
-    import_nestjs_agent_core31.AGENT_TOOL_REGISTRY,
-    import_nestjs_agent_core31.AGENT_REGISTRY,
-    import_nestjs_agent_core31.AGENT_SINK,
-    import_nestjs_agent_core31.AGENT_ROLES_POLICY,
-    import_nestjs_agent_core31.AGENT_ACTOR_RESOLVER,
-    import_nestjs_agent_core31.AGENT_MODEL,
-    import_nestjs_agent_core31.AGENT_STORE,
-    import_nestjs_agent_core31.AGENT_MODEL_CATALOG,
-    import_nestjs_agent_core31.AGENT_QUOTA_PROVIDER,
-    import_nestjs_agent_core31.AGENT_PROMPT_CONTRIBUTORS,
-    import_nestjs_agent_core31.AGENT_SKILLS,
-    import_nestjs_agent_core31.AGENT_MEMORY,
-    import_nestjs_agent_core31.AGENT_DEPS_FACTORY,
+    import_nestjs_agent_core37.AGENT_OPTIONS,
+    import_nestjs_agent_core37.AGENT_TOOL_REGISTRY,
+    import_nestjs_agent_core37.AGENT_REGISTRY,
+    import_nestjs_agent_core37.AGENT_SINK,
+    import_nestjs_agent_core37.AGENT_ROLES_POLICY,
+    import_nestjs_agent_core37.AGENT_ACTOR_RESOLVER,
+    import_nestjs_agent_core37.AGENT_MODEL,
+    import_nestjs_agent_core37.AGENT_STORE,
+    import_nestjs_agent_core37.AGENT_MODEL_CATALOG,
+    import_nestjs_agent_core37.AGENT_QUOTA_PROVIDER,
+    import_nestjs_agent_core37.AGENT_PROMPT_CONTRIBUTORS,
+    import_nestjs_agent_core37.AGENT_SKILLS,
+    import_nestjs_agent_core37.AGENT_MEMORY,
+    import_nestjs_agent_core37.AGENT_DEPS_FACTORY,
     AgentDepsFactory2,
     AgentService,
+    ActionProposalService,
+    ActionProposalWorkerService,
     ChatQueueService2,
     AGENT_CHAT_QUEUE,
     InlineAgentRunner,
-    import_nestjs_agent_core31.AGENT_APPROVAL_PORT
+    import_nestjs_agent_core37.AGENT_APPROVAL_PORT
   ];
 }
 __name(exportsFor, "exportsFor");
 var BASE_CONTROLLERS = [
+  ActionProposalController,
   ChatController,
   QueueController,
   ThreadsController,
@@ -6104,7 +7094,7 @@ var AgentModule = class _AgentModule {
       controllers: controllersForSurface(options.surface, options.adapters),
       providers: [
         {
-          provide: import_nestjs_agent_core31.AGENT_OPTIONS,
+          provide: import_nestjs_agent_core37.AGENT_OPTIONS,
           useValue: options
         },
         ...sharedProviders(options.durable ?? false),
@@ -6128,7 +7118,7 @@ var AgentModule = class _AgentModule {
       controllers: controllersForSurface(options.surface, options.adapters),
       providers: [
         {
-          provide: import_nestjs_agent_core31.AGENT_OPTIONS,
+          provide: import_nestjs_agent_core37.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
@@ -6150,9 +7140,9 @@ var AgentModule = class _AgentModule {
     };
   }
 };
-AgentModule = _ts_decorate26([
-  (0, import_common27.Global)(),
-  (0, import_common27.Module)({})
+AgentModule = _ts_decorate30([
+  (0, import_common31.Global)(),
+  (0, import_common31.Module)({})
 ], AgentModule);
 
 // src/durable/agent-durable.ts