@dudousxd/nestjs-agent 1.19.3 → 1.21.0

package/dist/durable/index.js

@@ -2,7 +2,7 @@ var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
 // src/durable/agent-run.workflow.ts
-import { AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY2, AGENT_STORE, RUN_ENDED_BEFORE_TOOL_CALL, RunCancelledError, agentFailureCode, encodeStreamEvent as encodeStreamEvent2, isReplayIntegrityError, publishAgentRunFailed, releaseThreadRun, runAgentLoop, settleAll, settleDeadRun, settleUnsettledDelegation, streamFailure } from "@dudousxd/nestjs-agent-core";
+import { AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY2, AGENT_STORE, RUN_ENDED_BEFORE_TOOL_CALL, RunCancelledError, agentFailureCode, encodeStreamEvent as encodeStreamEvent2, isReplayIntegrityError as isReplayIntegrityError2, publishAgentRunFailed, releaseThreadRun, runAgentLoop, settleAll, settleDeadRun, settleUnsettledDelegation, streamFailure } from "@dudousxd/nestjs-agent-core";
 import { RUN_GATEWAY, Workflow, WorkflowService } from "@dudousxd/nestjs-durable";
 import { isWorkflowControlFlowSignal } from "@dudousxd/nestjs-durable-core";
 import { Inject as Inject2, Injectable as Injectable2, Logger, Optional } from "@nestjs/common";
@@ -33,7 +33,9 @@ __name(childSinkWriter, "childSinkWriter");
 var AGENT_CHAT_QUEUE = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:chat-queue");
 
 // src/durable/agent-run.steps.ts
-import { AGENT_DEPS_FACTORY, createFrameBuffer, createUiCollector, encodeStreamEvent, invokeWithTransientRetry, observeTurnFrames, publishAgentToolRetry, stampToolKinds, toolCallContext, traceLlmTurn, traceToolExecution, withAskTool, withMemoryTool, withSkillTool, withToolTimeout, withTurnFrames, wrapToolStepOutput } from "@dudousxd/nestjs-agent-core";
+import { createNegotiatedUiCollector } from "@dudousxd/nestjs-agent-core";
+import { prepareActionProposal, resolveActionProposalApproval } from "@dudousxd/nestjs-agent-core";
+import { AGENT_DEPS_FACTORY, createFrameBuffer, createNoopEmitUi, encodeStreamEvent, intersectAllowLists, invokeWithTransientRetry, isControlFlowSignal, isReplayIntegrityError, observeTurnFrames, publishAgentToolRetry, stampToolKinds, toolCallContext, traceLlmTurn, traceToolExecution, withAskTool, withMemoryTool, withSkillTool, withToolTimeout, withTurnFrames, wrapToolPreflightDenied, wrapToolStepOutput } from "@dudousxd/nestjs-agent-core";
 import { Step } from "@dudousxd/nestjs-durable";
 import { Inject, Injectable } from "@nestjs/common";
 
@@ -97,14 +99,24 @@ var AgentRunSteps = class {
     const tools = withMemoryTool({
       tools: withSkillTool({
         tools: 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
-            } : {}
-          }),
+          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.
+            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
@@ -130,6 +142,67 @@ var AgentRunSteps = class {
       } : {}
     })), frames.summary());
     const stamped = stampToolKinds(turn, deps);
+    const allowedTools = 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 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 prepareActionProposal(deps.registry, call.name, call.input, {
+            ...toolCallContext(context, call.id),
+            emitUi: 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, {
+            ...toolCallContext(context, call.id),
+            emitUi: createNoopEmitUi(call.id)
+          }, deps.rolesPolicy, allowedTools === void 0 ? {} : {
+            allowedTools
+          });
+        }
+      } catch (error) {
+        if (isControlFlowSignal(error) || 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()
@@ -155,7 +228,7 @@ var AgentRunSteps = class {
     }
     const sinkRunId = input.sinkRunId;
     let opened;
-    const ui = createUiCollector(input.toolCallId, sinkRunId === void 0 ? void 0 : async (event) => {
+    const ui = 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(encodeStreamEvent(event));
     });
@@ -171,25 +244,38 @@ var AgentRunSteps = class {
         classify: localClassify
       } : {}
     };
-    const output = await traceToolExecution(input.ctx.runId, {
-      toolCallId: input.toolCallId,
-      toolName: input.toolName,
-      toolType: input.toolType
-    }, () => invokeWithTransientRetry(() => {
-      ui.restart();
-      const invocation = deps.registry.invoke(input.toolName, input.input, ctx, deps.rolesPolicy);
-      return input.timeoutMs !== void 0 ? withToolTimeout(invocation, input.timeoutMs, input.toolName) : invocation;
-    }, transientRetry, {
-      onRetry: /* @__PURE__ */ __name((attempt, error) => {
-        publishAgentToolRetry({
-          toolName: input.toolName,
-          toolCallId: input.toolCallId,
-          attempt,
-          message: error instanceof Error ? error.message : String(error)
+    const allowedTools = intersectAllowLists(deps.toolAllowList, input.allowedTools === void 0 ? void 0 : [
+      ...input.allowedTools
+    ]);
+    let output;
+    try {
+      output = await traceToolExecution(input.ctx.runId, {
+        toolCallId: input.toolCallId,
+        toolName: input.toolName,
+        toolType: input.toolType
+      }, () => invokeWithTransientRetry(() => {
+        ui.restart();
+        const invocation = deps.registry.invoke(input.toolName, input.input, ctx, deps.rolesPolicy, allowedTools === void 0 ? {} : {
+          allowedTools
         });
-      }, "onRetry")
-    }));
-    return input.collectUi === true ? wrapToolStepOutput(output, ui.components()) : output;
+        return input.timeoutMs !== void 0 ? withToolTimeout(invocation, input.timeoutMs, input.toolName) : invocation;
+      }, transientRetry, {
+        onRetry: /* @__PURE__ */ __name((attempt, error) => {
+          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 wrapToolPreflightDenied(error.message);
+      }
+      throw error;
+    }
+    return input.collectUi === true ? wrapToolStepOutput(output, ui.components(), ui.text()) : output;
   }
 };
 _ts_decorate([
@@ -589,7 +675,7 @@ var AgentRunWorkflow = class _AgentRunWorkflow {
         });
         throw error;
       }
-      if (isReplayIntegrityError(error)) {
+      if (isReplayIntegrityError2(error)) {
         const detail = error.message;
         const code2 = agentFailureCode(error);
         this.logger.error(`agent run ${ctx.runId} failed (${code2}): ${detail}`);
@@ -1085,14 +1171,44 @@ AgentDurableModule = _ts_decorate4([
 ], AgentDurableModule);
 
 // src/agent.module.ts
-import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER13, AGENT_APPROVAL_PORT, AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY7, AGENT_DURABLE_RUNNER as AGENT_DURABLE_RUNNER2, AGENT_MEMORY as AGENT_MEMORY3, AGENT_MODEL as AGENT_MODEL2, AGENT_MODEL_CATALOG as AGENT_MODEL_CATALOG3, AGENT_OPTIONS as AGENT_OPTIONS7, AGENT_PROMPT_CONTRIBUTORS as AGENT_PROMPT_CONTRIBUTORS3, AGENT_QUOTA_PROVIDER as AGENT_QUOTA_PROVIDER3, AGENT_REGISTRY as AGENT_REGISTRY6, AGENT_ROLES_POLICY as AGENT_ROLES_POLICY2, AGENT_RUNNER as AGENT_RUNNER2, AGENT_SINK as AGENT_SINK4, AGENT_SKILLS as AGENT_SKILLS3, AGENT_SKILL_SOURCES as AGENT_SKILL_SOURCES2, AGENT_STORE as AGENT_STORE7, AGENT_TOOL_REGISTRY as AGENT_TOOL_REGISTRY3, AgentRegistry as AgentRegistry6, ClosedRolesPolicy, DefaultRolesPolicy, InMemoryAgentStore, ToolRegistry as ToolRegistry3 } from "@dudousxd/nestjs-agent-core";
-import { Global as Global2, Logger as Logger8, Module as Module2 } from "@nestjs/common";
+import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER14, AGENT_APPROVAL_PORT, AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY9, AGENT_DURABLE_RUNNER as AGENT_DURABLE_RUNNER2, AGENT_MEMORY as AGENT_MEMORY3, AGENT_MODEL as AGENT_MODEL2, AGENT_MODEL_CATALOG as AGENT_MODEL_CATALOG3, AGENT_OPTIONS as AGENT_OPTIONS9, AGENT_PROMPT_CONTRIBUTORS as AGENT_PROMPT_CONTRIBUTORS3, AGENT_QUOTA_PROVIDER as AGENT_QUOTA_PROVIDER3, AGENT_REGISTRY as AGENT_REGISTRY6, AGENT_ROLES_POLICY as AGENT_ROLES_POLICY2, AGENT_RUNNER as AGENT_RUNNER2, AGENT_SINK as AGENT_SINK4, AGENT_SKILLS as AGENT_SKILLS3, AGENT_SKILL_SOURCES as AGENT_SKILL_SOURCES2, AGENT_STORE as AGENT_STORE9, AGENT_TOOL_REGISTRY as AGENT_TOOL_REGISTRY3, AgentRegistry as AgentRegistry6, ClosedRolesPolicy, DefaultRolesPolicy, InMemoryAgentStore, ToolRegistry as ToolRegistry3 } from "@dudousxd/nestjs-agent-core";
+import { Global as Global2, Logger as Logger9, Module as Module3 } from "@nestjs/common";
 import { DiscoveryModule, ModulesContainer, RouterModule } from "@nestjs/core";
 
 // src/agent-deps.factory.ts
-import { AGENT_MEMORY, AGENT_MODEL, AGENT_PRICING_STORE, AGENT_PROMPT_CONTRIBUTORS, AGENT_REGISTRY, AGENT_ROLES_POLICY, AGENT_SINK as AGENT_SINK2, AGENT_SKILLS, AGENT_STORE as AGENT_STORE3, AGENT_TOOL_REGISTRY, AgentRegistry as AgentRegistry2, ToolRegistry as ToolRegistry2, normalizeDelegation, summarizeWithModel, windowHistory } from "@dudousxd/nestjs-agent-core";
+import { assertIndependentActionCapabilities } from "@dudousxd/nestjs-agent-core";
+import { AGENT_MEMORY, AGENT_MODEL, AGENT_PRICING_STORE, AGENT_PROMPT_CONTRIBUTORS, AGENT_REGISTRY, AGENT_ROLES_POLICY, AGENT_SINK as AGENT_SINK2, AGENT_SKILLS, AGENT_STORE as AGENT_STORE3, AGENT_TOOL_REGISTRY, AgentRegistry as AgentRegistry2, ToolRegistry as ToolRegistry2, findPersona, intersectAllowLists as intersectAllowLists2, normalizeDelegation, personaCatalogEntry, resolvePersonaAlias, summarizeWithModel, windowHistory } from "@dudousxd/nestjs-agent-core";
 import { AGENT_OPTIONS } from "@dudousxd/nestjs-agent-core";
-import { Inject as Inject4, Injectable as Injectable4, Optional as Optional3 } from "@nestjs/common";
+import { BadRequestException, Inject as Inject5, Injectable as Injectable4, Optional as Optional3 } from "@nestjs/common";
+
+// src/genui/agent-genui.module.ts
+import { defineCatalog, genuiTools } from "@dudousxd/nestjs-agent-core/genui";
+import { Inject as Inject4, Module as Module2 } from "@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") {
@@ -1107,6 +1223,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 ?? 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) => 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([
+  Module2({})
+], 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);
@@ -1139,7 +1373,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;
@@ -1151,6 +1387,9 @@ var AgentDepsFactory2 = class {
     this.pricingStore = pricingStore;
     this.skills = skills;
     this.memory = memory;
+    this.uiCatalog = uiCatalog;
+    this.uiCatalogResolver = uiCatalogResolver;
+    if (options.actionApprovalMode === "independent") assertIndependentActionCapabilities(store, options.backgroundActorResolver);
   }
   /** The turn's memory seam, shared with the read-back endpoint. Undefined → memory is not configured. */
   memoryConfig() {
@@ -1190,8 +1429,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 = 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(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 (findPersona(definition, args.requested) === void 0) {
+        throw new 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 && 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 = resolvePersonaAlias(this.agents.list(), agentName);
+      const persona = alias === void 0 ? void 0 : 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();
@@ -1201,12 +1508,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,
@@ -1256,6 +1578,9 @@ var AgentDepsFactory2 = class {
       ...toolAllowList !== void 0 ? {
         toolAllowList
       } : {},
+      ...definition?.personas !== void 0 ? {
+        personas: definition.personas
+      } : {},
       ...this.options.toolTimeoutMs !== void 0 ? {
         toolTimeoutMs: this.options.toolTimeoutMs
       } : {},
@@ -1274,6 +1599,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 = intersectAllowLists2(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.
@@ -1315,22 +1679,25 @@ var AgentDepsFactory2 = class {
     return void 0;
   }
 };
-AgentDepsFactory2 = _ts_decorate5([
+AgentDepsFactory2 = _ts_decorate6([
   Injectable4(),
-  _ts_param4(0, Inject4(AGENT_OPTIONS)),
-  _ts_param4(1, Inject4(AGENT_MODEL)),
-  _ts_param4(2, Inject4(AGENT_STORE3)),
-  _ts_param4(3, Inject4(AGENT_SINK2)),
-  _ts_param4(4, Inject4(AGENT_ROLES_POLICY)),
-  _ts_param4(5, Inject4(AGENT_TOOL_REGISTRY)),
-  _ts_param4(6, Inject4(AGENT_REGISTRY)),
-  _ts_param4(7, Inject4(AGENT_PROMPT_CONTRIBUTORS)),
+  _ts_param4(0, Inject5(AGENT_OPTIONS)),
+  _ts_param4(1, Inject5(AGENT_MODEL)),
+  _ts_param4(2, Inject5(AGENT_STORE3)),
+  _ts_param4(3, Inject5(AGENT_SINK2)),
+  _ts_param4(4, Inject5(AGENT_ROLES_POLICY)),
+  _ts_param4(5, Inject5(AGENT_TOOL_REGISTRY)),
+  _ts_param4(6, Inject5(AGENT_REGISTRY)),
+  _ts_param4(7, Inject5(AGENT_PROMPT_CONTRIBUTORS)),
   _ts_param4(8, Optional3()),
-  _ts_param4(8, Inject4(AGENT_PRICING_STORE)),
+  _ts_param4(8, Inject5(AGENT_PRICING_STORE)),
   _ts_param4(9, Optional3()),
-  _ts_param4(9, Inject4(AGENT_SKILLS)),
+  _ts_param4(9, Inject5(AGENT_SKILLS)),
   _ts_param4(10, Optional3()),
-  _ts_param4(10, Inject4(AGENT_MEMORY)),
+  _ts_param4(10, Inject5(AGENT_MEMORY)),
+  _ts_param4(11, Optional3()),
+  _ts_param4(11, Inject5(GENUI_CATALOG)),
+  _ts_param4(12, Optional3()),
   _ts_metadata4("design:type", Function),
   _ts_metadata4("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
@@ -1343,18 +1710,20 @@ AgentDepsFactory2 = _ts_decorate5([
     Array,
     Object,
     Object,
-    Object
+    Object,
+    typeof Catalog === "undefined" ? Object : Catalog,
+    typeof GenuiCatalogResolver === "undefined" ? Object : GenuiCatalogResolver
   ])
 ], AgentDepsFactory2);
 
 // src/agent.service.ts
-import { AGENT_ATTACHMENT_STAGING as AGENT_ATTACHMENT_STAGING2, AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY3, AGENT_MODEL_CATALOG, AGENT_OPTIONS as AGENT_OPTIONS3, AGENT_QUOTA_PROVIDER as AGENT_QUOTA_PROVIDER2, AGENT_RUNNER, AGENT_STORE as AGENT_STORE5, REQUESTER_APPROVER, findCatalogModel, mayDecideApproval, readElicitationQuestions, settleDeadRun as settleDeadRun2, validateElicitationAnswer } from "@dudousxd/nestjs-agent-core";
-import { BadRequestException, ConflictException as ConflictException2, ForbiddenException, GoneException, HttpException, HttpStatus, Inject as Inject6, Injectable as Injectable6, NotFoundException, NotImplementedException as NotImplementedException2, Optional as Optional5 } from "@nestjs/common";
+import { AGENT_ATTACHMENT_STAGING as AGENT_ATTACHMENT_STAGING2, AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY4, AGENT_MODEL_CATALOG, AGENT_OPTIONS as AGENT_OPTIONS4, AGENT_QUOTA_PROVIDER as AGENT_QUOTA_PROVIDER2, AGENT_RUNNER, AGENT_STORE as AGENT_STORE6, REQUESTER_APPROVER, findCatalogModel, mayDecideApproval as mayDecideApproval2, readElicitationQuestions, settleDeadRun as settleDeadRun2, validateElicitationAnswer } from "@dudousxd/nestjs-agent-core";
+import { BadRequestException as BadRequestException2, ConflictException as ConflictException2, ForbiddenException as ForbiddenException2, GoneException, HttpException, HttpStatus, Inject as Inject8, Injectable as Injectable7, NotFoundException as NotFoundException2, NotImplementedException as NotImplementedException3, Optional as Optional5 } from "@nestjs/common";
 
-// src/queue/chat-queue.service.ts
-import { AGENT_ATTACHMENT_STAGING, AGENT_OPTIONS as AGENT_OPTIONS2, AGENT_QUOTA_PROVIDER, AGENT_SINK as AGENT_SINK3, AGENT_STORE as AGENT_STORE4, encodeStreamEvent as encodeStreamEvent4, isChatQueueStore, queuedMessageView } from "@dudousxd/nestjs-agent-core";
-import { Inject as Inject5, Injectable as Injectable5, Logger as Logger3, NotImplementedException, Optional as Optional4 } from "@nestjs/common";
-function _ts_decorate6(decorators, target, key, desc) {
+// src/proposals/action-proposal.service.ts
+import { AGENT_OPTIONS as AGENT_OPTIONS2, AGENT_STORE as AGENT_STORE4, mayDecideApproval, parseTextActionProposalCommand, resolveTextActionProposalDecision } from "@dudousxd/nestjs-agent-core";
+import { ForbiddenException, Inject as Inject6, Injectable as Injectable5, NotFoundException, NotImplementedException } from "@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);
@@ -1367,7 +1736,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);
@@ -1380,6 +1749,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 NotImplementedException("Action proposals are unavailable");
+    return store;
+  }
+  async scope(threadId, actor) {
+    const scope = await this.capability().getThreadActionProposalScope(threadId);
+    if (!scope) throw new NotFoundException("Thread not found");
+    if (scope.tenantRef !== (actor.tenantRef ?? null)) throw new ForbiddenException("Wrong proposal tenant");
+    return scope;
+  }
+  mayDecide(actor, proposal) {
+    return 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 NotFoundException("Proposal not found");
+    if (!await this.mayDecide(actor, proposal)) throw new 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 = 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 = 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([
+  Injectable5(),
+  _ts_param5(0, Inject6(AGENT_STORE4)),
+  _ts_param5(1, Inject6(AGENT_OPTIONS2)),
+  _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
+import { AGENT_ATTACHMENT_STAGING, AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY3, AGENT_OPTIONS as AGENT_OPTIONS3, AGENT_QUOTA_PROVIDER, AGENT_SINK as AGENT_SINK3, AGENT_STORE as AGENT_STORE5, encodeStreamEvent as encodeStreamEvent4, isChatQueueStore, queuedMessageView } from "@dudousxd/nestjs-agent-core";
+import { Inject as Inject7, Injectable as Injectable6, Logger as Logger3, NotImplementedException as NotImplementedException2, Optional as Optional4 } from "@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 {
@@ -1390,18 +1921,20 @@ var ChatQueueService2 = class _ChatQueueService {
   quotaProvider;
   options;
   staging;
+  deps;
   logger = new Logger3(_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() {
@@ -1410,7 +1943,7 @@ var ChatQueueService2 = class _ChatQueueService {
   /** The bound store as a queue store, or a 501 naming what is missing. */
   queueStore() {
     if (!isChatQueueStore(this.store)) {
-      throw new NotImplementedException("Queueing messages requires an AgentStore that implements ChatQueueStore (enqueueMessage, listQueue, \u2026, claimActiveStream, releaseActiveStream); the bound store does not.");
+      throw new NotImplementedException2("Queueing messages requires an AgentStore that implements ChatQueueStore (enqueueMessage, listQueue, \u2026, claimActiveStream, releaseActiveStream); the bound store does not.");
     }
     return this.store;
   }
@@ -1637,6 +2170,9 @@ var ChatQueueService2 = class _ChatQueueService {
       } : {},
       ...input.pageContext !== void 0 ? {
         pageContext: input.pageContext
+      } : {},
+      ...input.uiCapabilities !== void 0 ? {
+        uiCapabilities: input.uiCapabilities
       } : {}
     });
     await store.setQueuePause(threadId, {
@@ -1699,13 +2235,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
@@ -1713,11 +2253,45 @@ 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
       } : {}
     };
   }
+  /**
+  * 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") {
@@ -1735,23 +2309,26 @@ var ChatQueueService2 = class _ChatQueueService {
     }));
   }
 };
-ChatQueueService2 = _ts_decorate6([
-  Injectable5(),
-  _ts_param5(0, Inject5(AGENT_STORE4)),
-  _ts_param5(1, Inject5(AGENT_SINK3)),
-  _ts_param5(2, Optional4()),
-  _ts_param5(2, Inject5(AGENT_QUOTA_PROVIDER)),
-  _ts_param5(3, Optional4()),
-  _ts_param5(3, Inject5(AGENT_OPTIONS2)),
-  _ts_param5(4, Optional4()),
-  _ts_param5(4, Inject5(AGENT_ATTACHMENT_STAGING)),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+ChatQueueService2 = _ts_decorate8([
+  Injectable6(),
+  _ts_param6(0, Inject7(AGENT_STORE5)),
+  _ts_param6(1, Inject7(AGENT_SINK3)),
+  _ts_param6(2, Optional4()),
+  _ts_param6(2, Inject7(AGENT_QUOTA_PROVIDER)),
+  _ts_param6(3, Optional4()),
+  _ts_param6(3, Inject7(AGENT_OPTIONS3)),
+  _ts_param6(4, Optional4()),
+  _ts_param6(4, Inject7(AGENT_ATTACHMENT_STAGING)),
+  _ts_param6(5, Optional4()),
+  _ts_param6(5, Inject7(AGENT_DEPS_FACTORY3)),
+  _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) {
@@ -1797,7 +2374,7 @@ var RunNotActiveException = class extends ConflictException {
 };
 
 // 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);
@@ -1810,19 +2387,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");
@@ -1835,7 +2412,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;
@@ -1844,6 +2422,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() {
@@ -1853,7 +2438,7 @@ var AgentService = class {
   requireQueue() {
     const queue = this.queueing();
     if (queue === void 0) {
-      throw new NotImplementedException2("Queueing messages requires an AgentStore that implements ChatQueueStore; the bound store does not.");
+      throw new NotImplementedException3("Queueing messages requires an AgentStore that implements ChatQueueStore; the bound store does not.");
     }
     return queue;
   }
@@ -1923,17 +2508,17 @@ var AgentService = class {
   */
   async assertModelAllowed(actor, agent, model) {
     if (this.models === void 0) {
-      throw new BadRequestException(`model "${model}" cannot be selected: no ModelCatalog is configured (AgentModule.forRoot({ models }))`);
+      throw new BadRequestException2(`model "${model}" cannot be selected: no ModelCatalog is configured (AgentModule.forRoot({ models }))`);
     }
     const entry = findCatalogModel(await this.models.list({
       actor,
       agent
     }), model);
     if (entry === void 0) {
-      throw new BadRequestException(`model "${model}" is not offered`);
+      throw new BadRequestException2(`model "${model}" is not offered`);
     }
     if (!entry.available) {
-      throw new BadRequestException(`model "${model}" is not available${entry.unavailableReason ? `: ${entry.unavailableReason}` : ""}`);
+      throw new BadRequestException2(`model "${model}" is not available${entry.unavailableReason ? `: ${entry.unavailableReason}` : ""}`);
     }
     return entry.id;
   }
@@ -1949,7 +2534,7 @@ var AgentService = class {
     })).locked : void 0;
     if (locked !== void 0) {
       if (requested !== void 0 && requested !== locked.model) {
-        throw new BadRequestException(`model "${requested}" cannot be selected: ${locked.reason ?? `this agent always uses "${locked.model}"`}`);
+        throw new BadRequestException2(`model "${requested}" cannot be selected: ${locked.reason ?? `this agent always uses "${locked.model}"`}`);
       }
       return locked.model;
     }
@@ -1975,7 +2560,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;
     }
@@ -2003,15 +2591,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 BadRequestException("regenerate requires an existing threadId");
+        throw new BadRequestException2("regenerate requires an existing threadId");
       }
       const created = await this.store.createThread({
         actor: params.actor,
@@ -2020,11 +2614,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,
@@ -2032,6 +2632,9 @@ var AgentService = class {
       userText: params.message,
       day: utcDay(),
       agentName,
+      ...persona !== void 0 ? {
+        persona
+      } : {},
       ...params.regenerate === true ? {
         regenerate: true
       } : {},
@@ -2041,12 +2644,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 {
@@ -2118,12 +2725,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"
@@ -2170,7 +2783,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 BadRequestException("message must not be empty");
+      throw new BadRequestException2("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) {
@@ -2188,7 +2801,7 @@ var AgentService = class {
     }
     if (patch.position !== void 0) {
       if (!Number.isInteger(patch.position) || patch.position < 0) {
-        throw new BadRequestException("position must be a non-negative integer");
+        throw new BadRequestException2("position must be a non-negative integer");
       }
       if (!await store.moveQueuedMessage(messageId, patch.position)) {
         throw new GoneException(`queued message ${messageId} already started or was removed`);
@@ -2228,7 +2841,7 @@ var AgentService = class {
       throw gone();
     }
     if (marked.interrupt !== true) {
-      throw new NotImplementedException2("Interrupting a queued message requires a ChatQueueStore whose updateQueuedMessage stores `interrupt`; the bound store ignored it.");
+      throw new NotImplementedException3("Interrupting a queued message requires a ChatQueueStore whose updateQueuedMessage stores `interrupt`; the bound store ignored it.");
     }
     if (!await store.moveQueuedMessage(messageId, 0)) {
       throw gone();
@@ -2287,7 +2900,7 @@ var AgentService = class {
   async assertOwnsQueuedMessage(actor, messageId) {
     const message = await this.requireQueue().queueStore().getQueuedMessage(messageId);
     if (message === null) {
-      throw new NotFoundException(`queued message ${messageId} not found`);
+      throw new NotFoundException2(`queued message ${messageId} not found`);
     }
     await this.assertOwnsThread(actor, message.threadId);
     return message.threadId;
@@ -2308,7 +2921,7 @@ var AgentService = class {
     }
     const staging = this.staging;
     if (staging === void 0 || typeof staging.resolve !== "function") {
-      throw new NotImplementedException2("Message attachments require an AGENT_ATTACHMENT_STAGING provider implementing resolve(); attachment urls are never taken from the request.");
+      throw new NotImplementedException3("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) {
@@ -2317,7 +2930,7 @@ var AgentService = class {
         actor
       });
       if (attachment === null) {
-        throw new ForbiddenException(`attachment ${ref.mediaId} is not available to this actor`);
+        throw new ForbiddenException2(`attachment ${ref.mediaId} is not available to this actor`);
       }
       resolved.push(attachment);
     }
@@ -2419,6 +3032,7 @@ var AgentService = class {
   * not the thread's own actor).
   */
   async signalToolCall(toolCallId2, reply) {
+    if ((await this.store.toolCallApproval?.(toolCallId2))?.status === "proposed") throw new ConflictException2("Independent proposals require the scoped proposal decision route");
     await this.assertNotExpired(toolCallId2);
     const runId = await this.resolveRunForToolCall(toolCallId2);
     await this.assertRunWaiting(runId);
@@ -2459,7 +3073,7 @@ var AgentService = class {
       throw new RunNotActiveException(runId);
     }
     if (owner !== actor.id) {
-      throw new ForbiddenException("run belongs to another actor");
+      throw new ForbiddenException2("run belongs to another actor");
     }
   }
   /**
@@ -2512,16 +3126,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 NotImplementedException2("Setting a thread's defaultAgent or model requires an AgentStore that implements updateThread(); the bound store does not support it.");
+      throw new NotImplementedException3("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
@@ -2531,16 +3151,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 BadRequestException("title must not be empty");
+      throw new BadRequestException2("title must not be empty");
     }
     if (trimmed.length > 200) {
-      throw new BadRequestException("title must be at most 200 characters");
+      throw new BadRequestException2("title must be at most 200 characters");
     }
     return trimmed;
   }
@@ -2579,6 +3229,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
     };
   }
@@ -2643,21 +3294,21 @@ var AgentService = class {
   */
   async setMessageFeedback(actor, messageId, input) {
     if (input.value !== null && input.value !== "up" && input.value !== "down") {
-      throw new BadRequestException("value must be 'up', 'down' or null");
+      throw new BadRequestException2("value must be 'up', 'down' or null");
     }
     if (input.comment !== void 0 && typeof input.comment !== "string") {
-      throw new BadRequestException("comment must be a string");
+      throw new BadRequestException2("comment must be a string");
     }
     const comment = input.comment?.trim();
     if (comment !== void 0 && comment.length > 2e3) {
-      throw new BadRequestException("comment must be at most 2000 characters");
+      throw new BadRequestException2("comment must be at most 2000 characters");
     }
     if (this.store.threadOfMessage === void 0 || this.store.setMessageFeedback === void 0) {
-      throw new NotImplementedException2("Message feedback requires an AgentStore that implements threadOfMessage() and setMessageFeedback(); the bound store does not support it.");
+      throw new NotImplementedException3("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 NotFoundException(`message ${messageId} not found`);
+      throw new NotFoundException2(`message ${messageId} not found`);
     }
     await this.assertOwnsThread(actor, threadId);
     const feedback = input.value === null ? null : {
@@ -2705,7 +3356,7 @@ var AgentService = class {
     const list = this.attachmentInventory();
     const referencedMediaIds = this.store.referencedMediaIds?.bind(this.store);
     if (referencedMediaIds === void 0) {
-      throw new NotImplementedException2("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 NotImplementedException3("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({
@@ -2727,7 +3378,7 @@ var AgentService = class {
   attachmentInventory() {
     const list = this.staging?.list?.bind(this.staging);
     if (list === void 0) {
-      throw new NotImplementedException2("Listing attachments requires an AGENT_ATTACHMENT_STAGING provider implementing list(); the host owns the staged bytes, so only it can enumerate them.");
+      throw new NotImplementedException3("Listing attachments requires an AGENT_ATTACHMENT_STAGING provider implementing list(); the host owns the staged bytes, so only it can enumerate them.");
     }
     return list;
   }
@@ -2738,10 +3389,10 @@ var AgentService = class {
   async assertOwnsThread(actor, threadId) {
     const owner = await this.store.ownerOfThread(threadId);
     if (owner === null) {
-      throw new NotFoundException(`thread ${threadId} not found`);
+      throw new NotFoundException2(`thread ${threadId} not found`);
     }
     if (owner !== actor.id) {
-      throw new ForbiddenException("thread belongs to another actor");
+      throw new ForbiddenException2("thread belongs to another actor");
     }
   }
   /**
@@ -2752,10 +3403,10 @@ var AgentService = class {
   async assertOwnsToolCall(actor, toolCallId2) {
     const owner = await this.store.ownerOfToolCall(toolCallId2);
     if (owner === null) {
-      throw new NotFoundException(`tool call ${toolCallId2} not found`);
+      throw new NotFoundException2(`tool call ${toolCallId2} not found`);
     }
     if (owner !== actor.id) {
-      throw new ForbiddenException("tool call belongs to another actor");
+      throw new ForbiddenException2("tool call belongs to another actor");
     }
   }
   /**
@@ -2775,7 +3426,7 @@ var AgentService = class {
       const submitted = Object.hasOwn(answers2, question.id) ? answers2[question.id] : void 0;
       const problem = validateElicitationAnswer(question, submitted ?? question.defaults ?? []);
       if (problem !== null) {
-        throw new BadRequestException(`answers["${question.id}"] ${problem}`);
+        throw new BadRequestException2(`answers["${question.id}"] ${problem}`);
       }
     }
   }
@@ -2793,15 +3444,15 @@ var AgentService = class {
     }
     const requesterRef = await this.store.ownerOfToolCall(toolCallId2);
     if (requesterRef === null) {
-      throw new NotFoundException(`tool call ${toolCallId2} not found`);
+      throw new NotFoundException2(`tool call ${toolCallId2} not found`);
     }
-    const allowed = await mayDecideApproval(this.deps.forAgent().approvalPolicy, actor, {
+    const allowed = await mayDecideApproval2(this.deps.forAgent().approvalPolicy, actor, {
       toolCallId: toolCallId2,
       approver,
       requesterRef
     });
     if (!allowed) {
-      throw new ForbiddenException(`this approval is for ${approver}`);
+      throw new ForbiddenException2(`this approval is for ${approver}`);
     }
   }
   /**
@@ -2830,7 +3481,7 @@ var AgentService = class {
   async resolveRunForToolCall(toolCallId2) {
     const runId = await this.store.runForToolCall(toolCallId2);
     if (runId === null) {
-      throw new NotFoundException(`tool call ${toolCallId2} has no active run to signal`);
+      throw new NotFoundException2(`tool call ${toolCallId2} has no active run to signal`);
     }
     return runId;
   }
@@ -2838,29 +3489,30 @@ var AgentService = class {
   async assertOwnsActiveStream(actor, runId) {
     const owner = await this.store.ownerOfActiveStream(runId);
     if (owner === null) {
-      throw new NotFoundException(`no active run ${runId}`);
+      throw new NotFoundException2(`no active run ${runId}`);
     }
     if (owner !== actor.id) {
-      throw new ForbiddenException("run belongs to another actor");
+      throw new ForbiddenException2("run belongs to another actor");
     }
   }
 };
-AgentService = _ts_decorate7([
-  Injectable6(),
-  _ts_param6(0, Inject6(AGENT_RUNNER)),
-  _ts_param6(1, Inject6(AGENT_STORE5)),
-  _ts_param6(2, Inject6(AGENT_DEPS_FACTORY3)),
-  _ts_param6(3, Optional5()),
-  _ts_param6(3, Inject6(AGENT_ATTACHMENT_STAGING2)),
-  _ts_param6(4, Optional5()),
-  _ts_param6(4, Inject6(AGENT_MODEL_CATALOG)),
-  _ts_param6(5, Optional5()),
-  _ts_param6(5, Inject6(AGENT_QUOTA_PROVIDER2)),
-  _ts_param6(6, Optional5()),
-  _ts_param6(6, Inject6(AGENT_OPTIONS3)),
-  _ts_param6(7, Optional5()),
-  _ts_metadata6("design:type", Function),
-  _ts_metadata6("design:paramtypes", [
+AgentService = _ts_decorate9([
+  Injectable7(),
+  _ts_param7(0, Inject8(AGENT_RUNNER)),
+  _ts_param7(1, Inject8(AGENT_STORE6)),
+  _ts_param7(2, Inject8(AGENT_DEPS_FACTORY4)),
+  _ts_param7(3, Optional5()),
+  _ts_param7(3, Inject8(AGENT_ATTACHMENT_STAGING2)),
+  _ts_param7(4, Optional5()),
+  _ts_param7(4, Inject8(AGENT_MODEL_CATALOG)),
+  _ts_param7(5, Optional5()),
+  _ts_param7(5, Inject8(AGENT_QUOTA_PROVIDER2)),
+  _ts_param7(6, Optional5()),
+  _ts_param7(6, Inject8(AGENT_OPTIONS4)),
+  _ts_param7(7, Optional5()),
+  _ts_param7(8, Optional5()),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", [
     typeof AgentRunner === "undefined" ? Object : AgentRunner,
     typeof AgentStore === "undefined" ? Object : AgentStore,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
@@ -2868,13 +3520,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
-import { Injectable as Injectable7 } from "@nestjs/common";
-function _ts_decorate8(decorators, target, key, desc) {
+import { Injectable as Injectable8, NotImplementedException as NotImplementedException4, Optional as Optional6 } from "@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);
@@ -2887,20 +3540,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 NotImplementedException4("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 NotImplementedException4("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, {
@@ -2931,18 +3612,20 @@ var AgentApprovalPortAdapter = class {
     });
   }
 };
-AgentApprovalPortAdapter = _ts_decorate8([
-  Injectable7(),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
-    typeof AgentService === "undefined" ? Object : AgentService
+AgentApprovalPortAdapter = _ts_decorate10([
+  Injectable8(),
+  _ts_param8(1, Optional6()),
+  _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
-import { AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY4, AGENT_REGISTRY as AGENT_REGISTRY2, AgentRegistry as AgentRegistry3 } from "@dudousxd/nestjs-agent-core";
-import { Controller, Get, Inject as Inject7 } from "@nestjs/common";
-function _ts_decorate9(decorators, target, key, desc) {
+import { AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY5, AGENT_REGISTRY as AGENT_REGISTRY2, AgentRegistry as AgentRegistry3 } from "@dudousxd/nestjs-agent-core";
+import { Controller, Get, Inject as Inject9 } from "@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);
@@ -2955,19 +3638,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");
@@ -2980,35 +3663,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([
+_ts_decorate11([
   Get(),
-  _ts_metadata8("design:type", Function),
-  _ts_metadata8("design:paramtypes", []),
-  _ts_metadata8("design:returntype", Array)
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", []),
+  _ts_metadata9("design:returntype", Array)
 ], AgentsController.prototype, "list", null);
-AgentsController = _ts_decorate9([
+AgentsController = _ts_decorate11([
   Controller("agents"),
-  _ts_param7(0, Inject7(AGENT_REGISTRY2)),
-  _ts_param7(1, Inject7(AGENT_DEPS_FACTORY4)),
-  _ts_metadata8("design:type", Function),
-  _ts_metadata8("design:paramtypes", [
+  _ts_param9(0, Inject9(AGENT_REGISTRY2)),
+  _ts_param9(1, Inject9(AGENT_DEPS_FACTORY5)),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", [
     typeof AgentRegistry3 === "undefined" ? Object : AgentRegistry3,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory
   ])
 ], AgentsController);
 
 // src/controller/attachments.controller.ts
-import { AGENT_ACTOR_RESOLVER, AGENT_ATTACHMENT_STAGING as AGENT_ATTACHMENT_STAGING3, AGENT_OPTIONS as AGENT_OPTIONS4 } from "@dudousxd/nestjs-agent-core";
-import { BadRequestException as BadRequestException2, Controller as Controller2, Get as Get2, Inject as Inject8, NotImplementedException as NotImplementedException3, Optional as Optional6, PayloadTooLargeException, Post, Req, UnsupportedMediaTypeException, UploadedFile, UseInterceptors } from "@nestjs/common";
+import { AGENT_ACTOR_RESOLVER, AGENT_ATTACHMENT_STAGING as AGENT_ATTACHMENT_STAGING3, AGENT_OPTIONS as AGENT_OPTIONS5 } from "@dudousxd/nestjs-agent-core";
+import { BadRequestException as BadRequestException3, Controller as Controller2, Get as Get2, Inject as Inject10, NotImplementedException as NotImplementedException5, Optional as Optional7, PayloadTooLargeException, Post, Req, UnsupportedMediaTypeException, UploadedFile, UseInterceptors } from "@nestjs/common";
 import { FileInterceptor } from "@nestjs/platform-express";
 
 // src/attachment-limits.ts
@@ -3037,7 +3729,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);
@@ -3050,19 +3742,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 {
@@ -3096,10 +3788,10 @@ var AttachmentsController = class {
   }
   async upload(req, file) {
     if (this.staging === void 0) {
-      throw new NotImplementedException3("Attachment upload is not configured on this server: bind AGENT_ATTACHMENT_STAGING (e.g. import AgentMediaAttachmentsModule).");
+      throw new NotImplementedException5("Attachment upload is not configured on this server: bind AGENT_ATTACHMENT_STAGING (e.g. import AgentMediaAttachmentsModule).");
     }
     if (file === void 0) {
-      throw new BadRequestException2('multipart field "file" is required');
+      throw new BadRequestException3('multipart field "file" is required');
     }
     const { allowedContentTypes, maxBytes } = attachmentLimits(this.options, this.staging);
     if (!allowedContentTypes.includes(file.mimetype)) {
@@ -3118,39 +3810,39 @@ var AttachmentsController = class {
     });
   }
 };
-_ts_decorate10([
+_ts_decorate12([
   Get2(),
-  _ts_param8(0, Req()),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+  _ts_param10(0, 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([
+_ts_decorate12([
   Post(),
   UseInterceptors(FileInterceptor("file", {
     limits: {
       fileSize: HARD_MAX_ATTACHMENT_BYTES
     }
   })),
-  _ts_param8(0, Req()),
-  _ts_param8(1, UploadedFile()),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+  _ts_param10(0, Req()),
+  _ts_param10(1, 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([
+AttachmentsController = _ts_decorate12([
   Controller2("attachments"),
-  _ts_param8(0, Inject8(AGENT_OPTIONS4)),
-  _ts_param8(1, Inject8(AGENT_ACTOR_RESOLVER)),
-  _ts_param8(3, Optional6()),
-  _ts_param8(3, Inject8(AGENT_ATTACHMENT_STAGING3)),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+  _ts_param10(0, Inject10(AGENT_OPTIONS5)),
+  _ts_param10(1, Inject10(AGENT_ACTOR_RESOLVER)),
+  _ts_param10(3, Optional7()),
+  _ts_param10(3, Inject10(AGENT_ATTACHMENT_STAGING3)),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -3160,8 +3852,9 @@ AttachmentsController = _ts_decorate10([
 
 // src/controller/chat.controller.ts
 import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER2, AgentStreamError as AgentStreamError2, streamFailure as streamFailure2 } from "@dudousxd/nestjs-agent-core";
-import { BadRequestException as BadRequestException3, Body, Controller as Controller3, Get as Get3, Inject as Inject9, Param, Post as Post2, Query, Req as Req2, Res } from "@nestjs/common";
-function _ts_decorate11(decorators, target, key, desc) {
+import { validateUiCapabilities } from "@dudousxd/nestjs-agent-core/genui";
+import { BadRequestException as BadRequestException4, Body, Controller as Controller3, Get as Get3, Inject as Inject11, Param, Post as Post2, Query, Req as Req2, Res } from "@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);
@@ -3174,19 +3867,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";
@@ -3197,7 +3890,7 @@ function sendMode(body) {
   if (body.mode === "auto" || body.mode === "queue" || body.mode === "interrupt") {
     return body.mode;
   }
-  throw new BadRequestException3("mode must be 'auto', 'queue' or 'interrupt'");
+  throw new BadRequestException4("mode must be 'auto', 'queue' or 'interrupt'");
 }
 __name(sendMode, "sendMode");
 function attachmentRefs(claimed) {
@@ -3205,21 +3898,21 @@ function attachmentRefs(claimed) {
     return [];
   }
   if (!Array.isArray(claimed)) {
-    throw new BadRequestException3("attachments must be an array of { mediaId }");
+    throw new BadRequestException4("attachments must be an array of { mediaId }");
   }
   if (claimed.length > MAX_ATTACHMENTS_PER_MESSAGE) {
-    throw new BadRequestException3(`a message may carry at most ${MAX_ATTACHMENTS_PER_MESSAGE} attachments`);
+    throw new BadRequestException4(`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 BadRequestException3("each attachment must be an object with a mediaId");
+      throw new BadRequestException4("each attachment must be an object with a mediaId");
     }
     if (Object.keys(entry).some((key) => key !== "mediaId")) {
-      throw new BadRequestException3("attachments are { mediaId } refs \u2014 send nothing but the id");
+      throw new BadRequestException4("attachments are { mediaId } refs \u2014 send nothing but the id");
     }
     const { mediaId } = entry;
     if (typeof mediaId !== "string" || mediaId.length === 0) {
-      throw new BadRequestException3("each attachment must carry a non-empty string mediaId");
+      throw new BadRequestException4("each attachment must carry a non-empty string mediaId");
     }
     return {
       mediaId
@@ -3247,15 +3940,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 : validateUiCapabilities(body.uiCapabilities);
+    } catch {
+      throw new BadRequestException4("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
       } : {},
@@ -3273,6 +3978,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;
@@ -3364,50 +4073,50 @@ data: ${JSON.stringify(payload)}
     res.end();
   }
 };
-_ts_decorate11([
+_ts_decorate13([
   Post2("chat"),
-  _ts_param9(0, Req2()),
-  _ts_param9(1, Res()),
-  _ts_param9(2, Body()),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+  _ts_param11(0, Req2()),
+  _ts_param11(1, Res()),
+  _ts_param11(2, 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([
+_ts_decorate13([
   Get3("chat/:runId/stream"),
-  _ts_param9(0, Req2()),
-  _ts_param9(1, Param("runId")),
-  _ts_param9(2, Res()),
-  _ts_param9(3, Query("after")),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+  _ts_param11(0, Req2()),
+  _ts_param11(1, Param("runId")),
+  _ts_param11(2, Res()),
+  _ts_param11(3, 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([
+_ts_decorate13([
   Post2("chat/:runId/cancel"),
-  _ts_param9(0, Req2()),
-  _ts_param9(1, Param("runId")),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+  _ts_param11(0, Req2()),
+  _ts_param11(1, 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([
+ChatController = _ts_decorate13([
   Controller3(),
-  _ts_param9(1, Inject9(AGENT_ACTOR_RESOLVER2)),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+  _ts_param11(1, Inject11(AGENT_ACTOR_RESOLVER2)),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
@@ -3423,8 +4132,8 @@ function parseCursor(raw) {
 __name(parseCursor, "parseCursor");
 
 // src/controller/config.controller.ts
-import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER3, AGENT_ATTACHMENT_STAGING as AGENT_ATTACHMENT_STAGING4, AGENT_MODEL_CATALOG as AGENT_MODEL_CATALOG2, AGENT_OPTIONS as AGENT_OPTIONS5 } from "@dudousxd/nestjs-agent-core";
-import { Controller as Controller4, Get as Get4, Inject as Inject10, Optional as Optional7, Req as Req3 } from "@nestjs/common";
+import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER3, AGENT_ATTACHMENT_STAGING as AGENT_ATTACHMENT_STAGING4, AGENT_MODEL_CATALOG as AGENT_MODEL_CATALOG2, AGENT_OPTIONS as AGENT_OPTIONS6 } from "@dudousxd/nestjs-agent-core";
+import { Controller as Controller4, Get as Get4, Inject as Inject12, Optional as Optional8, Req as Req3 } from "@nestjs/common";
 
 // src/resolver/anonymous-actor-resolver.ts
 import { createHash, randomBytes } from "crypto";
@@ -3514,7 +4223,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);
@@ -3527,19 +4236,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");
@@ -3570,25 +4279,25 @@ var ConfigController = class {
     };
   }
 };
-_ts_decorate12([
+_ts_decorate14([
   Get4(),
-  _ts_param10(0, Req3()),
-  _ts_metadata11("design:type", Function),
-  _ts_metadata11("design:paramtypes", [
+  _ts_param12(0, Req3()),
+  _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([
+ConfigController = _ts_decorate14([
   Controller4("config"),
-  _ts_param10(0, Inject10(AGENT_OPTIONS5)),
-  _ts_param10(1, Inject10(AGENT_ACTOR_RESOLVER3)),
-  _ts_param10(2, Optional7()),
-  _ts_param10(2, Inject10(AGENT_ATTACHMENT_STAGING4)),
-  _ts_param10(3, Optional7()),
-  _ts_param10(3, Inject10(AGENT_MODEL_CATALOG2)),
-  _ts_metadata11("design:type", Function),
-  _ts_metadata11("design:paramtypes", [
+  _ts_param12(0, Inject12(AGENT_OPTIONS6)),
+  _ts_param12(1, Inject12(AGENT_ACTOR_RESOLVER3)),
+  _ts_param12(2, Optional8()),
+  _ts_param12(2, Inject12(AGENT_ATTACHMENT_STAGING4)),
+  _ts_param12(3, Optional8()),
+  _ts_param12(3, Inject12(AGENT_MODEL_CATALOG2)),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     Object,
@@ -3598,8 +4307,8 @@ ConfigController = _ts_decorate12([
 
 // src/controller/memories.controller.ts
 import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER4, AGENT_MEMORY as AGENT_MEMORY2, memoryForgetVerdict, offerMemories } from "@dudousxd/nestjs-agent-core";
-import { Controller as Controller5, Delete, ForbiddenException as ForbiddenException2, Get as Get5, Inject as Inject11, NotFoundException as NotFoundException2, Optional as Optional8, Param as Param2, Query as Query2, Req as Req4 } from "@nestjs/common";
-function _ts_decorate13(decorators, target, key, desc) {
+import { Controller as Controller5, Delete, ForbiddenException as ForbiddenException3, Get as Get5, Inject as Inject13, NotFoundException as NotFoundException3, Optional as Optional9, Param as Param2, Query as Query2, Req as Req4 } from "@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);
@@ -3612,19 +4321,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");
@@ -3658,20 +4367,20 @@ var MemoriesController = class {
   */
   async forget(req, id) {
     if (this.memory === void 0) {
-      throw new NotFoundException2("No memory is configured in this deployment.");
+      throw new NotFoundException3("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 NotFoundException2(`No memory with id "${id}".`);
+      throw new NotFoundException3(`No memory with id "${id}".`);
     }
     const verdict = memoryForgetVerdict({
       record: entry,
       actor
     });
     if (!verdict.allowed) {
-      throw new ForbiddenException2(verdict.reason);
+      throw new ForbiddenException3(verdict.reason);
     }
     return {
       forgotten: await this.memory.provider.forget({
@@ -3697,35 +4406,35 @@ var MemoriesController = class {
     });
   }
 };
-_ts_decorate13([
+_ts_decorate15([
   Get5(),
-  _ts_param11(0, Req4()),
-  _ts_param11(1, Query2("threadId")),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+  _ts_param13(0, Req4()),
+  _ts_param13(1, Query2("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([
+_ts_decorate15([
   Delete(":id"),
-  _ts_param11(0, Req4()),
-  _ts_param11(1, Param2("id")),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+  _ts_param13(0, Req4()),
+  _ts_param13(1, Param2("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([
+MemoriesController = _ts_decorate15([
   Controller5("memories"),
-  _ts_param11(0, Inject11(AGENT_ACTOR_RESOLVER4)),
-  _ts_param11(1, Optional8()),
-  _ts_param11(1, Inject11(AGENT_MEMORY2)),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+  _ts_param13(0, Inject13(AGENT_ACTOR_RESOLVER4)),
+  _ts_param13(1, Optional9()),
+  _ts_param13(1, Inject13(AGENT_MEMORY2)),
+  _ts_metadata13("design:type", Function),
+  _ts_metadata13("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     Object
   ])
@@ -3733,8 +4442,8 @@ MemoriesController = _ts_decorate13([
 
 // src/controller/messages.controller.ts
 import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER5 } from "@dudousxd/nestjs-agent-core";
-import { Body as Body2, Controller as Controller6, HttpCode, Inject as Inject12, Param as Param3, Post as Post3, Req as Req5 } from "@nestjs/common";
-function _ts_decorate14(decorators, target, key, desc) {
+import { Body as Body2, Controller as Controller6, HttpCode, Inject as Inject14, Param as Param3, Post as Post3, Req as Req5 } from "@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);
@@ -3747,19 +4456,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");
@@ -3787,25 +4496,25 @@ var MessagesController = class {
     };
   }
 };
-_ts_decorate14([
+_ts_decorate16([
   Post3(":id/feedback"),
   HttpCode(200),
-  _ts_param12(0, Req5()),
-  _ts_param12(1, Param3("id")),
-  _ts_param12(2, Body2()),
-  _ts_metadata13("design:type", Function),
-  _ts_metadata13("design:paramtypes", [
+  _ts_param14(0, Req5()),
+  _ts_param14(1, Param3("id")),
+  _ts_param14(2, Body2()),
+  _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([
+MessagesController = _ts_decorate16([
   Controller6("messages"),
-  _ts_param12(1, Inject12(AGENT_ACTOR_RESOLVER5)),
-  _ts_metadata13("design:type", Function),
-  _ts_metadata13("design:paramtypes", [
+  _ts_param14(1, Inject14(AGENT_ACTOR_RESOLVER5)),
+  _ts_metadata14("design:type", Function),
+  _ts_metadata14("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
@@ -3813,8 +4522,8 @@ MessagesController = _ts_decorate14([
 
 // src/controller/models.controller.ts
 import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER6 } from "@dudousxd/nestjs-agent-core";
-import { Controller as Controller7, Get as Get6, Inject as Inject13, Query as Query3, Req as Req6 } from "@nestjs/common";
-function _ts_decorate15(decorators, target, key, desc) {
+import { Controller as Controller7, Get as Get6, Inject as Inject15, Query as Query3, Req as Req6 } from "@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);
@@ -3827,19 +4536,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");
@@ -3859,22 +4568,22 @@ var ModelsController = class {
     return this.agent.listModels(actor, agent);
   }
 };
-_ts_decorate15([
+_ts_decorate17([
   Get6(),
-  _ts_param13(0, Req6()),
-  _ts_param13(1, Query3("agent")),
-  _ts_metadata14("design:type", Function),
-  _ts_metadata14("design:paramtypes", [
+  _ts_param15(0, Req6()),
+  _ts_param15(1, Query3("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([
+ModelsController = _ts_decorate17([
   Controller7("models"),
-  _ts_param13(1, Inject13(AGENT_ACTOR_RESOLVER6)),
-  _ts_metadata14("design:type", Function),
-  _ts_metadata14("design:paramtypes", [
+  _ts_param15(1, Inject15(AGENT_ACTOR_RESOLVER6)),
+  _ts_metadata15("design:type", Function),
+  _ts_metadata15("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
@@ -3882,8 +4591,8 @@ ModelsController = _ts_decorate15([
 
 // src/controller/queue.controller.ts
 import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER7 } from "@dudousxd/nestjs-agent-core";
-import { BadRequestException as BadRequestException4, Body as Body3, Controller as Controller8, Delete as Delete2, Get as Get7, Inject as Inject14, Param as Param4, Patch, Post as Post4, Req as Req7 } from "@nestjs/common";
-function _ts_decorate16(decorators, target, key, desc) {
+import { BadRequestException as BadRequestException5, Body as Body3, Controller as Controller8, Delete as Delete2, Get as Get7, Inject as Inject16, Param as Param4, Patch, Post as Post4, Req as Req7 } from "@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);
@@ -3896,19 +4605,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");
@@ -3932,10 +4641,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 BadRequestException4("message must be a string");
+      throw new BadRequestException5("message must be a string");
     }
     if (body.position !== void 0 && typeof body.position !== "number") {
-      throw new BadRequestException4("position must be a number");
+      throw new BadRequestException5("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, {
@@ -3962,79 +4671,79 @@ var QueueController = class {
     return this.agent.removeQueuedMessage(await this.actorResolver.resolve(req), messageId);
   }
 };
-_ts_decorate16([
+_ts_decorate18([
   Get7("threads/:id/queue"),
-  _ts_param14(0, Req7()),
-  _ts_param14(1, Param4("id")),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+  _ts_param16(0, Req7()),
+  _ts_param16(1, Param4("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([
+_ts_decorate18([
   Delete2("threads/:id/queue"),
-  _ts_param14(0, Req7()),
-  _ts_param14(1, Param4("id")),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+  _ts_param16(0, Req7()),
+  _ts_param16(1, Param4("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([
+_ts_decorate18([
   Post4("threads/:id/queue/resume"),
-  _ts_param14(0, Req7()),
-  _ts_param14(1, Param4("id")),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+  _ts_param16(0, Req7()),
+  _ts_param16(1, Param4("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([
+_ts_decorate18([
   Patch("queue/:messageId"),
-  _ts_param14(0, Req7()),
-  _ts_param14(1, Param4("messageId")),
-  _ts_param14(2, Body3()),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+  _ts_param16(0, Req7()),
+  _ts_param16(1, Param4("messageId")),
+  _ts_param16(2, Body3()),
+  _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([
+_ts_decorate18([
   Post4("queue/:messageId/interrupt"),
-  _ts_param14(0, Req7()),
-  _ts_param14(1, Param4("messageId")),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+  _ts_param16(0, Req7()),
+  _ts_param16(1, Param4("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([
+_ts_decorate18([
   Delete2("queue/:messageId"),
-  _ts_param14(0, Req7()),
-  _ts_param14(1, Param4("messageId")),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+  _ts_param16(0, Req7()),
+  _ts_param16(1, Param4("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([
+QueueController = _ts_decorate18([
   Controller8(),
-  _ts_param14(1, Inject14(AGENT_ACTOR_RESOLVER7)),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+  _ts_param16(1, Inject16(AGENT_ACTOR_RESOLVER7)),
+  _ts_metadata16("design:type", Function),
+  _ts_metadata16("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
@@ -4042,8 +4751,8 @@ QueueController = _ts_decorate16([
 
 // src/controller/quota.controller.ts
 import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER8 } from "@dudousxd/nestjs-agent-core";
-import { Controller as Controller9, Get as Get8, Inject as Inject15, Req as Req8 } from "@nestjs/common";
-function _ts_decorate17(decorators, target, key, desc) {
+import { Controller as Controller9, Get as Get8, Inject as Inject17, Req as Req8 } from "@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);
@@ -4056,19 +4765,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");
@@ -4088,20 +4797,20 @@ var QuotaController = class {
     return this.agent.quotaReport(actor);
   }
 };
-_ts_decorate17([
+_ts_decorate19([
   Get8(),
-  _ts_param15(0, Req8()),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+  _ts_param17(0, Req8()),
+  _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([
+QuotaController = _ts_decorate19([
   Controller9("quota"),
-  _ts_param15(1, Inject15(AGENT_ACTOR_RESOLVER8)),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+  _ts_param17(1, Inject17(AGENT_ACTOR_RESOLVER8)),
+  _ts_metadata17("design:type", Function),
+  _ts_metadata17("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
@@ -4109,8 +4818,8 @@ QuotaController = _ts_decorate17([
 
 // src/controller/skills.controller.ts
 import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER9, AGENT_SKILLS as AGENT_SKILLS2, offerSkills } from "@dudousxd/nestjs-agent-core";
-import { Controller as Controller10, Get as Get9, Inject as Inject16, Optional as Optional9, Query as Query4, Req as Req9 } from "@nestjs/common";
-function _ts_decorate18(decorators, target, key, desc) {
+import { Controller as Controller10, Get as Get9, Inject as Inject18, Optional as Optional10, Query as Query4, Req as Req9 } from "@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);
@@ -4123,19 +4832,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");
@@ -4158,24 +4867,24 @@ var SkillsController = class {
     return offer.entries;
   }
 };
-_ts_decorate18([
+_ts_decorate20([
   Get9(),
-  _ts_param16(0, Req9()),
-  _ts_param16(1, Query4("threadId")),
-  _ts_metadata17("design:type", Function),
-  _ts_metadata17("design:paramtypes", [
+  _ts_param18(0, Req9()),
+  _ts_param18(1, Query4("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([
+SkillsController = _ts_decorate20([
   Controller10("skills"),
-  _ts_param16(0, Inject16(AGENT_ACTOR_RESOLVER9)),
-  _ts_param16(1, Optional9()),
-  _ts_param16(1, Inject16(AGENT_SKILLS2)),
-  _ts_metadata17("design:type", Function),
-  _ts_metadata17("design:paramtypes", [
+  _ts_param18(0, Inject18(AGENT_ACTOR_RESOLVER9)),
+  _ts_param18(1, Optional10()),
+  _ts_param18(1, Inject18(AGENT_SKILLS2)),
+  _ts_metadata18("design:type", Function),
+  _ts_metadata18("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     Object
   ])
@@ -4183,8 +4892,8 @@ SkillsController = _ts_decorate18([
 
 // src/controller/threads.controller.ts
 import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER10 } from "@dudousxd/nestjs-agent-core";
-import { Body as Body4, Controller as Controller11, Delete as Delete3, Get as Get10, Inject as Inject17, Param as Param5, Patch as Patch2, Post as Post5, Req as Req10 } from "@nestjs/common";
-function _ts_decorate19(decorators, target, key, desc) {
+import { Body as Body4, Controller as Controller11, Delete as Delete3, Get as Get10, Inject as Inject19, Param as Param5, Patch as Patch2, Post as Post5, Req as Req10 } from "@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);
@@ -4197,19 +4906,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");
@@ -4255,6 +4964,9 @@ var ThreadsController = class {
       } : {},
       ..."model" in body ? {
         model: body.model ?? null
+      } : {},
+      ..."persona" in body ? {
+        persona: body.persona ?? null
       } : {}
     });
     return {
@@ -4276,92 +4988,92 @@ var ThreadsController = class {
     };
   }
 };
-_ts_decorate19([
+_ts_decorate21([
   Get10(),
-  _ts_param17(0, Req10()),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+  _ts_param19(0, Req10()),
+  _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([
+_ts_decorate21([
   Get10(":id"),
-  _ts_param17(0, Req10()),
-  _ts_param17(1, Param5("id")),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+  _ts_param19(0, Req10()),
+  _ts_param19(1, Param5("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([
+_ts_decorate21([
   Delete3(":id"),
-  _ts_param17(0, Req10()),
-  _ts_param17(1, Param5("id")),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+  _ts_param19(0, Req10()),
+  _ts_param19(1, Param5("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([
+_ts_decorate21([
   Post5(":id/fork-from/:messageId"),
-  _ts_param17(0, Req10()),
-  _ts_param17(1, Param5("id")),
-  _ts_param17(2, Param5("messageId")),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+  _ts_param19(0, Req10()),
+  _ts_param19(1, Param5("id")),
+  _ts_param19(2, Param5("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([
+_ts_decorate21([
   Patch2(":id"),
-  _ts_param17(0, Req10()),
-  _ts_param17(1, Param5("id")),
-  _ts_param17(2, Body4()),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+  _ts_param19(0, Req10()),
+  _ts_param19(1, Param5("id")),
+  _ts_param19(2, Body4()),
+  _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([
+_ts_decorate21([
   Post5(":id/promote"),
-  _ts_param17(0, Req10()),
-  _ts_param17(1, Param5("id")),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+  _ts_param19(0, Req10()),
+  _ts_param19(1, Param5("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([
+_ts_decorate21([
   Delete3(":id/from/:messageId"),
-  _ts_param17(0, Req10()),
-  _ts_param17(1, Param5("id")),
-  _ts_param17(2, Param5("messageId")),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+  _ts_param19(0, Req10()),
+  _ts_param19(1, Param5("id")),
+  _ts_param19(2, Param5("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([
+ThreadsController = _ts_decorate21([
   Controller11("threads"),
-  _ts_param17(1, Inject17(AGENT_ACTOR_RESOLVER10)),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+  _ts_param19(1, Inject19(AGENT_ACTOR_RESOLVER10)),
+  _ts_metadata19("design:type", Function),
+  _ts_metadata19("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
@@ -4369,8 +5081,8 @@ ThreadsController = _ts_decorate19([
 
 // src/controller/tool-call.controller.ts
 import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER11 } from "@dudousxd/nestjs-agent-core";
-import { BadRequestException as BadRequestException5, Body as Body5, Controller as Controller12, Inject as Inject18, Post as Post6, Req as Req11 } from "@nestjs/common";
-function _ts_decorate20(decorators, target, key, desc) {
+import { BadRequestException as BadRequestException6, Body as Body5, Controller as Controller12, Inject as Inject20, Post as Post6, Req as Req11 } from "@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);
@@ -4383,19 +5095,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;
@@ -4404,7 +5116,7 @@ var MAX_VIA_LENGTH = 64;
 var DEFAULT_VIA = "web";
 function toolCallId(claimed) {
   if (typeof claimed !== "string" || claimed.length === 0) {
-    throw new BadRequestException5("toolCallId must be a non-empty string");
+    throw new BadRequestException6("toolCallId must be a non-empty string");
   }
   return claimed;
 }
@@ -4414,10 +5126,10 @@ function rejectReason(claimed) {
     return void 0;
   }
   if (typeof claimed !== "string") {
-    throw new BadRequestException5("reason must be a string");
+    throw new BadRequestException6("reason must be a string");
   }
   if (claimed.length > MAX_REJECT_REASON_LENGTH) {
-    throw new BadRequestException5(`reason must be at most ${MAX_REJECT_REASON_LENGTH} characters`);
+    throw new BadRequestException6(`reason must be at most ${MAX_REJECT_REASON_LENGTH} characters`);
   }
   return claimed;
 }
@@ -4427,7 +5139,7 @@ function remember(claimed) {
     return false;
   }
   if (typeof claimed !== "boolean") {
-    throw new BadRequestException5("remember must be a boolean");
+    throw new BadRequestException6("remember must be a boolean");
   }
   return claimed;
 }
@@ -4437,7 +5149,7 @@ function via(claimed) {
     return DEFAULT_VIA;
   }
   if (typeof claimed !== "string" || claimed.length === 0 || claimed.length > MAX_VIA_LENGTH) {
-    throw new BadRequestException5(`via must be a string of 1-${MAX_VIA_LENGTH} characters`);
+    throw new BadRequestException6(`via must be a string of 1-${MAX_VIA_LENGTH} characters`);
   }
   return claimed;
 }
@@ -4447,26 +5159,26 @@ function answers(claimed) {
     return void 0;
   }
   if (typeof claimed !== "object" || claimed === null || Array.isArray(claimed)) {
-    throw new BadRequestException5("answers must be an object of questionId \u2192 chosen values");
+    throw new BadRequestException6("answers must be an object of questionId \u2192 chosen values");
   }
   const entries = Object.entries(claimed);
   if (entries.length > MAX_ANSWERED_QUESTIONS) {
-    throw new BadRequestException5(`answers may cover at most ${MAX_ANSWERED_QUESTIONS} questions`);
+    throw new BadRequestException6(`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 BadRequestException5(`answers["${questionId}"] must be an array of chosen values`);
+      throw new BadRequestException6(`answers["${questionId}"] must be an array of chosen values`);
     }
     if (values.length > MAX_VALUES_PER_QUESTION) {
-      throw new BadRequestException5(`answers["${questionId}"] may carry at most ${MAX_VALUES_PER_QUESTION} values`);
+      throw new BadRequestException6(`answers["${questionId}"] may carry at most ${MAX_VALUES_PER_QUESTION} values`);
     }
     for (const value of values) {
       if (typeof value !== "string") {
-        throw new BadRequestException5(`answers["${questionId}"] must contain only strings`);
+        throw new BadRequestException6(`answers["${questionId}"] must contain only strings`);
       }
       if (value.length > MAX_ANSWER_VALUE_LENGTH) {
-        throw new BadRequestException5(`answers["${questionId}"] values must be at most ${MAX_ANSWER_VALUE_LENGTH} characters`);
+        throw new BadRequestException6(`answers["${questionId}"] values must be at most ${MAX_ANSWER_VALUE_LENGTH} characters`);
       }
     }
     validated[questionId] = values;
@@ -4528,64 +5240,64 @@ var ToolCallController = class {
     };
   }
 };
-_ts_decorate20([
+_ts_decorate22([
   Post6("approve"),
-  _ts_param18(0, Req11()),
-  _ts_param18(1, Body5()),
-  _ts_metadata19("design:type", Function),
-  _ts_metadata19("design:paramtypes", [
+  _ts_param20(0, Req11()),
+  _ts_param20(1, Body5()),
+  _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([
+_ts_decorate22([
   Post6("reject"),
-  _ts_param18(0, Req11()),
-  _ts_param18(1, Body5()),
-  _ts_metadata19("design:type", Function),
-  _ts_metadata19("design:paramtypes", [
+  _ts_param20(0, Req11()),
+  _ts_param20(1, Body5()),
+  _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([
+_ts_decorate22([
   Post6("answer"),
-  _ts_param18(0, Req11()),
-  _ts_param18(1, Body5()),
-  _ts_metadata19("design:type", Function),
-  _ts_metadata19("design:paramtypes", [
+  _ts_param20(0, Req11()),
+  _ts_param20(1, Body5()),
+  _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([
+_ts_decorate22([
   Post6("skip"),
-  _ts_param18(0, Req11()),
-  _ts_param18(1, Body5()),
-  _ts_metadata19("design:type", Function),
-  _ts_metadata19("design:paramtypes", [
+  _ts_param20(0, Req11()),
+  _ts_param20(1, Body5()),
+  _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([
+ToolCallController = _ts_decorate22([
   Controller12("tool-call"),
-  _ts_param18(1, Inject18(AGENT_ACTOR_RESOLVER11)),
-  _ts_metadata19("design:type", Function),
-  _ts_metadata19("design:paramtypes", [
+  _ts_param20(1, Inject20(AGENT_ACTOR_RESOLVER11)),
+  _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
-import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER12, AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY5, AGENT_REGISTRY as AGENT_REGISTRY3, ALL_AGENTS, AgentRegistry as AgentRegistry4 } from "@dudousxd/nestjs-agent-core";
-import { Controller as Controller13, Get as Get11, Inject as Inject19, NotFoundException as NotFoundException3, Query as Query5, Req as Req12 } from "@nestjs/common";
-function _ts_decorate21(decorators, target, key, desc) {
+import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER12, AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY6, AGENT_REGISTRY as AGENT_REGISTRY3, ALL_AGENTS, AgentRegistry as AgentRegistry4 } from "@dudousxd/nestjs-agent-core";
+import { Controller as Controller13, Get as Get11, Inject as Inject21, NotFoundException as NotFoundException4, Query as Query5, Req as Req12 } from "@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);
@@ -4598,19 +5310,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");
@@ -4625,7 +5337,7 @@ var ToolsController = class {
   }
   async list(req, agent) {
     if (agent !== void 0 && agent !== ALL_AGENTS && this.agents.get(agent) === void 0) {
-      throw new NotFoundException3(`No agent named "${agent}"`);
+      throw new NotFoundException4(`No agent named "${agent}"`);
     }
     const actor = await this.actorResolver.resolve(req);
     const names = agent === ALL_AGENTS ? [
@@ -4654,24 +5366,24 @@ var ToolsController = class {
     ];
   }
 };
-_ts_decorate21([
+_ts_decorate23([
   Get11(),
-  _ts_param19(0, Req12()),
-  _ts_param19(1, Query5("agent")),
-  _ts_metadata20("design:type", Function),
-  _ts_metadata20("design:paramtypes", [
+  _ts_param21(0, Req12()),
+  _ts_param21(1, Query5("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([
+ToolsController = _ts_decorate23([
   Controller13("tools"),
-  _ts_param19(0, Inject19(AGENT_ACTOR_RESOLVER12)),
-  _ts_param19(1, Inject19(AGENT_DEPS_FACTORY5)),
-  _ts_param19(2, Inject19(AGENT_REGISTRY3)),
-  _ts_metadata20("design:type", Function),
-  _ts_metadata20("design:paramtypes", [
+  _ts_param21(0, Inject21(AGENT_ACTOR_RESOLVER12)),
+  _ts_param21(1, Inject21(AGENT_DEPS_FACTORY6)),
+  _ts_param21(2, Inject21(AGENT_REGISTRY3)),
+  _ts_metadata21("design:type", Function),
+  _ts_metadata21("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
     typeof AgentRegistry4 === "undefined" ? Object : AgentRegistry4
@@ -4680,7 +5392,7 @@ ToolsController = _ts_decorate21([
 
 // src/discovery/agent-discovery.service.ts
 import { AGENT_PROMPT_CONTRIBUTORS as AGENT_PROMPT_CONTRIBUTORS2, AGENT_REGISTRY as AGENT_REGISTRY4, AgentRegistry as AgentRegistry5 } from "@dudousxd/nestjs-agent-core";
-import { Inject as Inject20, Injectable as Injectable8, Logger as Logger4 } from "@nestjs/common";
+import { Inject as Inject22, Injectable as Injectable9, Logger as Logger4 } from "@nestjs/common";
 import { DiscoveryService, MetadataScanner } from "@nestjs/core";
 
 // src/decorator/agent.decorator.ts
@@ -4697,7 +5409,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);
@@ -4710,19 +5422,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");
@@ -4750,6 +5462,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) {
@@ -4793,10 +5506,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.
@@ -4849,12 +5600,12 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
     return (ctx) => candidate.call(instance, ctx);
   }
 };
-AgentDiscoveryService = _ts_decorate22([
-  Injectable8(),
-  _ts_param20(2, Inject20(AGENT_REGISTRY4)),
-  _ts_param20(3, Inject20(AGENT_PROMPT_CONTRIBUTORS2)),
-  _ts_metadata21("design:type", Function),
-  _ts_metadata21("design:paramtypes", [
+AgentDiscoveryService = _ts_decorate24([
+  Injectable9(),
+  _ts_param22(2, Inject22(AGENT_REGISTRY4)),
+  _ts_param22(3, Inject22(AGENT_PROMPT_CONTRIBUTORS2)),
+  _ts_metadata22("design:type", Function),
+  _ts_metadata22("design:paramtypes", [
     typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
     typeof MetadataScanner === "undefined" ? Object : MetadataScanner,
     typeof AgentRegistry5 === "undefined" ? Object : AgentRegistry5,
@@ -4863,8 +5614,8 @@ AgentDiscoveryService = _ts_decorate22([
 ], AgentDiscoveryService);
 
 // src/discovery/ai-tool-discovery.service.ts
-import { AGENT_OPTIONS as AGENT_OPTIONS6, AGENT_REGISTRY as AGENT_REGISTRY5, AGENT_TOOL_REGISTRY as AGENT_TOOL_REGISTRY2, normalizeDelegation as normalizeDelegation2 } from "@dudousxd/nestjs-agent-core";
-import { Inject as Inject21, Injectable as Injectable9, Logger as Logger5 } from "@nestjs/common";
+import { AGENT_OPTIONS as AGENT_OPTIONS7, AGENT_REGISTRY as AGENT_REGISTRY5, AGENT_TOOL_REGISTRY as AGENT_TOOL_REGISTRY2, normalizeDelegation as normalizeDelegation2 } from "@dudousxd/nestjs-agent-core";
+import { Inject as Inject23, Injectable as Injectable10, Logger as Logger5 } from "@nestjs/common";
 import { DiscoveryService as DiscoveryService2 } from "@nestjs/core";
 import { z } from "zod";
 
@@ -4876,15 +5627,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);
@@ -4897,19 +5641,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");
@@ -4977,9 +5721,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).
@@ -5053,13 +5803,13 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
     return true;
   }
 };
-AiToolDiscoveryService = _ts_decorate23([
-  Injectable9(),
-  _ts_param21(1, Inject21(AGENT_TOOL_REGISTRY2)),
-  _ts_param21(2, Inject21(AGENT_REGISTRY5)),
-  _ts_param21(3, Inject21(AGENT_OPTIONS6)),
-  _ts_metadata22("design:type", Function),
-  _ts_metadata22("design:paramtypes", [
+AiToolDiscoveryService = _ts_decorate25([
+  Injectable10(),
+  _ts_param23(1, Inject23(AGENT_TOOL_REGISTRY2)),
+  _ts_param23(2, Inject23(AGENT_REGISTRY5)),
+  _ts_param23(3, Inject23(AGENT_OPTIONS7)),
+  _ts_metadata23("design:type", Function),
+  _ts_metadata23("design:paramtypes", [
     typeof DiscoveryService2 === "undefined" ? Object : DiscoveryService2,
     typeof ToolRegistry === "undefined" ? Object : ToolRegistry,
     typeof AgentRegistry === "undefined" ? Object : AgentRegistry,
@@ -5069,7 +5819,7 @@ AiToolDiscoveryService = _ts_decorate23([
 
 // src/discovery/skill-discovery.service.ts
 import { AGENT_SKILL_SOURCES } from "@dudousxd/nestjs-agent-core";
-import { Inject as Inject22, Injectable as Injectable10, Logger as Logger6 } from "@nestjs/common";
+import { Inject as Inject24, Injectable as Injectable11, Logger as Logger6 } from "@nestjs/common";
 import { DiscoveryService as DiscoveryService3 } from "@nestjs/core";
 
 // src/decorator/skill.decorator.ts
@@ -5086,7 +5836,7 @@ function skillScope(options) {
 __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);
@@ -5099,19 +5849,19 @@ 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");
@@ -5155,11 +5905,11 @@ var SkillDiscoveryService = class _SkillDiscoveryService {
     return flat === void 0 ? void 0 : () => flat;
   }
 };
-SkillDiscoveryService = _ts_decorate24([
-  Injectable10(),
-  _ts_param22(1, Inject22(AGENT_SKILL_SOURCES)),
-  _ts_metadata23("design:type", Function),
-  _ts_metadata23("design:paramtypes", [
+SkillDiscoveryService = _ts_decorate26([
+  Injectable11(),
+  _ts_param24(1, Inject24(AGENT_SKILL_SOURCES)),
+  _ts_metadata24("design:type", Function),
+  _ts_metadata24("design:paramtypes", [
     typeof DiscoveryService3 === "undefined" ? Object : DiscoveryService3,
     Array
   ])
@@ -5227,10 +5977,245 @@ var LedgerQuotaProvider = class {
   }
 };
 
+// src/proposals/action-proposal-worker.service.ts
+import { randomUUID as randomUUID2 } from "crypto";
+import { AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY7, AGENT_OPTIONS as AGENT_OPTIONS8, AGENT_STORE as AGENT_STORE7, ActionProposalExecutor, ActionProposalWorker, assertIndependentActionCapabilities as assertIndependentActionCapabilities2 } from "@dudousxd/nestjs-agent-core";
+import { Inject as Inject25, Injectable as Injectable12, Logger as Logger7 } from "@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 Logger7(_ActionProposalWorkerService.name);
+  constructor(store, options, deps) {
+    this.store = store;
+    this.options = options;
+    this.deps = deps;
+  }
+  onModuleInit() {
+    if (this.options.actionApprovalMode !== "independent") return;
+    assertIndependentActionCapabilities2(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 ActionProposalWorker({
+      store: this.store,
+      workerId: randomUUID2(),
+      ...this.options.actionProposalWorker,
+      executor: new 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([
+  Injectable12(),
+  _ts_param25(0, Inject25(AGENT_STORE7)),
+  _ts_param25(1, Inject25(AGENT_OPTIONS8)),
+  _ts_param25(2, Inject25(AGENT_DEPS_FACTORY7)),
+  _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
+import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER13, validateActionProposalListQuery } from "@dudousxd/nestjs-agent-core";
+import { BadRequestException as BadRequestException7, Body as Body6, Controller as Controller14, Get as Get12, Inject as Inject26, Param as Param6, Post as Post7, Query as Query6, Req as Req13, Res as Res2 } from "@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 BadRequestException7(`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 BadRequestException7(`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)
+        };
+        validateActionProposalListQuery(query);
+      } catch {
+        throw new BadRequestException7("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([
+  Get12(),
+  _ts_param26(0, Param6("threadId")),
+  _ts_param26(1, Req13()),
+  _ts_param26(2, Query6("after")),
+  _ts_param26(3, Res2({
+    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([
+  Post7(":proposalId/approve"),
+  _ts_param26(0, Param6("threadId")),
+  _ts_param26(1, Param6("proposalId")),
+  _ts_param26(2, Req13()),
+  _ts_param26(3, Body6()),
+  _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([
+  Post7(":proposalId/reject"),
+  _ts_param26(0, Param6("threadId")),
+  _ts_param26(1, Param6("proposalId")),
+  _ts_param26(2, Req13()),
+  _ts_param26(3, Body6()),
+  _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([
+  Controller14("threads/:threadId/action-proposals"),
+  _ts_param26(1, Inject26(AGENT_ACTOR_RESOLVER13)),
+  _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
-import { AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY6, AGENT_STORE as AGENT_STORE6, RUN_ENDED_BEFORE_TOOL_CALL as RUN_ENDED_BEFORE_TOOL_CALL2, RunCancelledError as RunCancelledError2, agentFailureCode as agentFailureCode2, encodeStreamEvent as encodeStreamEvent5, publishAgentRunFailed as publishAgentRunFailed2, releaseThreadRun as releaseThreadRun3, runAgentLoop as runAgentLoop2, settleAll as settleAll2, settleUnsettledDelegation as settleUnsettledDelegation3, streamFailure as streamFailure3 } from "@dudousxd/nestjs-agent-core";
-import { Inject as Inject23, Injectable as Injectable11, Logger as Logger7, Optional as Optional10 } from "@nestjs/common";
-function _ts_decorate25(decorators, target, key, desc) {
+import { AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY8, AGENT_STORE as AGENT_STORE8, RUN_ENDED_BEFORE_TOOL_CALL as RUN_ENDED_BEFORE_TOOL_CALL2, RunCancelledError as RunCancelledError2, agentFailureCode as agentFailureCode2, encodeStreamEvent as encodeStreamEvent5, publishAgentRunFailed as publishAgentRunFailed2, releaseThreadRun as releaseThreadRun3, runAgentLoop as runAgentLoop2, settleAll as settleAll2, settleUnsettledDelegation as settleUnsettledDelegation3, streamFailure as streamFailure3 } from "@dudousxd/nestjs-agent-core";
+import { Inject as Inject27, Injectable as Injectable13, Logger as Logger8, Optional as Optional11 } from "@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);
@@ -5243,19 +6228,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");
@@ -5263,7 +6248,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
   factory;
   store;
   queue;
-  logger = new Logger7(_InlineAgentRunner.name);
+  logger = new Logger8(_InlineAgentRunner.name);
   pending = /* @__PURE__ */ new Map();
   /**
   * Runs someone has asked to stop. In-process, like `pending`, and for the same reason: this runner
@@ -5706,13 +6691,13 @@ var InlineAgentRunner = class _InlineAgentRunner {
     }
   }
 };
-InlineAgentRunner = _ts_decorate25([
-  Injectable11(),
-  _ts_param23(0, Inject23(AGENT_DEPS_FACTORY6)),
-  _ts_param23(1, Inject23(AGENT_STORE6)),
-  _ts_param23(2, Optional10()),
-  _ts_metadata24("design:type", Function),
-  _ts_metadata24("design:paramtypes", [
+InlineAgentRunner = _ts_decorate29([
+  Injectable13(),
+  _ts_param27(0, Inject27(AGENT_DEPS_FACTORY8)),
+  _ts_param27(1, Inject27(AGENT_STORE8)),
+  _ts_param27(2, Optional11()),
+  _ts_metadata27("design:type", Function),
+  _ts_metadata27("design:paramtypes", [
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
     typeof AgentStore === "undefined" ? Object : AgentStore,
     typeof ChatQueueService2 === "undefined" ? Object : ChatQueueService2
@@ -5762,7 +6747,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);
@@ -5775,13 +6760,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 Logger8("AgentModule");
+var logger = new Logger9("AgentModule");
 function externalStoreWrapper(modules) {
   for (const module of modules.values()) {
     if (module.metatype === AgentModule) continue;
-    const wrapper = module.providers.get(AGENT_STORE7);
+    const wrapper = module.providers.get(AGENT_STORE9);
     if (wrapper !== void 0) return wrapper;
   }
   return void 0;
@@ -5854,7 +6839,7 @@ function sharedProviders(durable) {
       provide: AGENT_SKILLS3,
       useFactory: /* @__PURE__ */ __name((options, declared) => resolveSkillsConfig(options.skills, declared), "useFactory"),
       inject: [
-        AGENT_OPTIONS7,
+        AGENT_OPTIONS9,
         AGENT_SKILL_SOURCES2
       ]
     },
@@ -5864,39 +6849,39 @@ function sharedProviders(durable) {
       provide: AGENT_MEMORY3,
       useFactory: /* @__PURE__ */ __name((options) => options.memory, "useFactory"),
       inject: [
-        AGENT_OPTIONS7
+        AGENT_OPTIONS9
       ]
     },
     {
       provide: AGENT_SINK4,
       useFactory: /* @__PURE__ */ __name((options) => options.sink ?? new InProcessTokenStreamSink(), "useFactory"),
       inject: [
-        AGENT_OPTIONS7
+        AGENT_OPTIONS9
       ]
     },
     {
       provide: AGENT_ROLES_POLICY2,
       useFactory: /* @__PURE__ */ __name((options) => options.rolesPolicy ?? (options.emptyRoles === "deny" ? new ClosedRolesPolicy(options.defaultRoles) : new DefaultRolesPolicy(options.defaultRoles)), "useFactory"),
       inject: [
-        AGENT_OPTIONS7
+        AGENT_OPTIONS9
       ]
     },
     {
-      provide: AGENT_ACTOR_RESOLVER13,
+      provide: AGENT_ACTOR_RESOLVER14,
       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: [
-        AGENT_OPTIONS7
+        AGENT_OPTIONS9
       ]
     },
     {
       provide: AGENT_MODEL2,
       useFactory: /* @__PURE__ */ __name((o) => o.model, "useFactory"),
       inject: [
-        AGENT_OPTIONS7
+        AGENT_OPTIONS9
       ]
     },
     {
@@ -5907,20 +6892,20 @@ function sharedProviders(durable) {
         warnAt: o.quota.warnAt
       } : {}), "useFactory"),
       inject: [
-        AGENT_OPTIONS7,
-        AGENT_STORE7
+        AGENT_OPTIONS9,
+        AGENT_STORE9
       ]
     },
     {
       provide: AGENT_MODEL_CATALOG3,
       useFactory: /* @__PURE__ */ __name((o) => resolveCatalog(o), "useFactory"),
       inject: [
-        AGENT_OPTIONS7
+        AGENT_OPTIONS9
       ]
     },
     AgentDepsFactory2,
     {
-      provide: AGENT_DEPS_FACTORY7,
+      provide: AGENT_DEPS_FACTORY9,
       useExisting: AgentDepsFactory2
     },
     // Populates the registry + contributors (onModuleInit) BEFORE AiToolDiscoveryService synthesizes
@@ -5937,6 +6922,8 @@ 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,
@@ -5946,10 +6933,10 @@ function sharedProviders(durable) {
     }
   ];
   providers.push({
-    provide: AGENT_STORE7,
+    provide: AGENT_STORE9,
     useFactory: /* @__PURE__ */ __name((o, modules) => resolveStore(o, modules), "useFactory"),
     inject: [
-      AGENT_OPTIONS7,
+      AGENT_OPTIONS9,
       ModulesContainer
     ]
   });
@@ -5980,22 +6967,24 @@ function sharedProviders(durable) {
 __name(sharedProviders, "sharedProviders");
 function exportsFor() {
   return [
-    AGENT_OPTIONS7,
+    AGENT_OPTIONS9,
     AGENT_TOOL_REGISTRY3,
     AGENT_REGISTRY6,
     AGENT_SINK4,
     AGENT_ROLES_POLICY2,
-    AGENT_ACTOR_RESOLVER13,
+    AGENT_ACTOR_RESOLVER14,
     AGENT_MODEL2,
-    AGENT_STORE7,
+    AGENT_STORE9,
     AGENT_MODEL_CATALOG3,
     AGENT_QUOTA_PROVIDER3,
     AGENT_PROMPT_CONTRIBUTORS3,
     AGENT_SKILLS3,
     AGENT_MEMORY3,
-    AGENT_DEPS_FACTORY7,
+    AGENT_DEPS_FACTORY9,
     AgentDepsFactory2,
     AgentService,
+    ActionProposalService,
+    ActionProposalWorkerService,
     ChatQueueService2,
     AGENT_CHAT_QUEUE,
     InlineAgentRunner,
@@ -6004,6 +6993,7 @@ function exportsFor() {
 }
 __name(exportsFor, "exportsFor");
 var BASE_CONTROLLERS = [
+  ActionProposalController,
   ChatController,
   QueueController,
   ThreadsController,
@@ -6076,7 +7066,7 @@ var AgentModule = class _AgentModule {
       controllers: controllersForSurface(options.surface, options.adapters),
       providers: [
         {
-          provide: AGENT_OPTIONS7,
+          provide: AGENT_OPTIONS9,
           useValue: options
         },
         ...sharedProviders(options.durable ?? false),
@@ -6100,7 +7090,7 @@ var AgentModule = class _AgentModule {
       controllers: controllersForSurface(options.surface, options.adapters),
       providers: [
         {
-          provide: AGENT_OPTIONS7,
+          provide: AGENT_OPTIONS9,
           // 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
@@ -6122,9 +7112,9 @@ var AgentModule = class _AgentModule {
     };
   }
 };
-AgentModule = _ts_decorate26([
+AgentModule = _ts_decorate30([
   Global2(),
-  Module2({})
+  Module3({})
 ], AgentModule);
 
 // src/durable/agent-durable.ts