@dudousxd/nestjs-agent 1.19.3 → 1.21.0

package/dist/index.js

@@ -2,14 +2,59 @@ var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
 // src/agent.module.ts
-import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER13, AGENT_APPROVAL_PORT, AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY5, AGENT_DURABLE_RUNNER, 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_SINK3, AGENT_SKILLS as AGENT_SKILLS3, AGENT_SKILL_SOURCES as AGENT_SKILL_SOURCES2, AGENT_STORE as AGENT_STORE5, AGENT_TOOL_REGISTRY as AGENT_TOOL_REGISTRY3, AgentRegistry as AgentRegistry6, ClosedRolesPolicy, DefaultRolesPolicy, InMemoryAgentStore, ToolRegistry as ToolRegistry3 } from "@dudousxd/nestjs-agent-core";
-import { Global, Logger as Logger6, Module } from "@nestjs/common";
+import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER14, AGENT_APPROVAL_PORT, AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY7, AGENT_DURABLE_RUNNER, 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_SINK3, 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, Logger as Logger7, Module as Module2 } 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, AGENT_SKILLS, AGENT_STORE, 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, AGENT_SKILLS, AGENT_STORE, AGENT_TOOL_REGISTRY, AgentRegistry as AgentRegistry2, ToolRegistry as ToolRegistry2, findPersona, intersectAllowLists, normalizeDelegation, personaCatalogEntry, resolvePersonaAlias, summarizeWithModel, windowHistory } from "@dudousxd/nestjs-agent-core";
 import { AGENT_OPTIONS } from "@dudousxd/nestjs-agent-core";
-import { Inject, Injectable, Optional } from "@nestjs/common";
+import { BadRequestException, Inject as Inject2, Injectable, Optional } from "@nestjs/common";
+
+// src/genui/agent-genui.module.ts
+import { defineCatalog, genuiTools } from "@dudousxd/nestjs-agent-core/genui";
+import { Inject, Module } 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 provideAgentTool(factoryOrTool, inject) {
+  const provide = /* @__PURE__ */ Symbol("nestjs-agent:functional-tool-instance");
+  if (typeof factoryOrTool === "function") {
+    return {
+      provide,
+      useFactory: /* @__PURE__ */ __name((...deps) => brand(factoryOrTool(...deps)), "useFactory"),
+      inject: inject ?? []
+    };
+  }
+  return {
+    provide,
+    useValue: brand(factoryOrTool)
+  };
+}
+__name(provideAgentTool, "provideAgentTool");
+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_decorate(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
@@ -24,6 +69,124 @@ function _ts_decorate(decorators, target, key, desc) {
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 __name(_ts_decorate, "_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_decorate([
+  Module({})
+], AgentGenuiModule);
+
+// src/agent-deps.factory.ts
+function _ts_decorate2(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
+    r = Reflect.decorate(decorators, target, key, desc);
+  } else {
+    for (var i = decorators.length - 1; i >= 0; i--) {
+      if (d = decorators[i]) {
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      }
+    }
+  }
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate2, "_ts_decorate");
 function _ts_metadata(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
@@ -56,7 +219,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;
@@ -68,6 +233,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() {
@@ -107,8 +275,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();
@@ -118,12 +354,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,
@@ -173,6 +424,9 @@ var AgentDepsFactory2 = class {
       ...toolAllowList !== void 0 ? {
         toolAllowList
       } : {},
+      ...definition?.personas !== void 0 ? {
+        personas: definition.personas
+      } : {},
       ...this.options.toolTimeoutMs !== void 0 ? {
         toolTimeoutMs: this.options.toolTimeoutMs
       } : {},
@@ -191,6 +445,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 = intersectAllowLists(deps.toolAllowList, persona.allowedTools);
+    return {
+      ...deps,
+      systemPrompt,
+      ...toolAllowList !== void 0 ? {
+        toolAllowList
+      } : {}
+    };
+  }
+  /**
   * The ceiling on how much of a thread this agent's turns carry, most specific wins: the agent's
   * own `@Agent({ history })`, else a module-wide custom `historyPolicy`, else the module-wide
   * `history` window. Undefined → unbounded, the behaviour of a module that configures none.
@@ -232,22 +525,25 @@ var AgentDepsFactory2 = class {
     return void 0;
   }
 };
-AgentDepsFactory2 = _ts_decorate([
+AgentDepsFactory2 = _ts_decorate2([
   Injectable(),
-  _ts_param(0, Inject(AGENT_OPTIONS)),
-  _ts_param(1, Inject(AGENT_MODEL)),
-  _ts_param(2, Inject(AGENT_STORE)),
-  _ts_param(3, Inject(AGENT_SINK)),
-  _ts_param(4, Inject(AGENT_ROLES_POLICY)),
-  _ts_param(5, Inject(AGENT_TOOL_REGISTRY)),
-  _ts_param(6, Inject(AGENT_REGISTRY)),
-  _ts_param(7, Inject(AGENT_PROMPT_CONTRIBUTORS)),
+  _ts_param(0, Inject2(AGENT_OPTIONS)),
+  _ts_param(1, Inject2(AGENT_MODEL)),
+  _ts_param(2, Inject2(AGENT_STORE)),
+  _ts_param(3, Inject2(AGENT_SINK)),
+  _ts_param(4, Inject2(AGENT_ROLES_POLICY)),
+  _ts_param(5, Inject2(AGENT_TOOL_REGISTRY)),
+  _ts_param(6, Inject2(AGENT_REGISTRY)),
+  _ts_param(7, Inject2(AGENT_PROMPT_CONTRIBUTORS)),
   _ts_param(8, Optional()),
-  _ts_param(8, Inject(AGENT_PRICING_STORE)),
+  _ts_param(8, Inject2(AGENT_PRICING_STORE)),
   _ts_param(9, Optional()),
-  _ts_param(9, Inject(AGENT_SKILLS)),
+  _ts_param(9, Inject2(AGENT_SKILLS)),
   _ts_param(10, Optional()),
-  _ts_param(10, Inject(AGENT_MEMORY)),
+  _ts_param(10, Inject2(AGENT_MEMORY)),
+  _ts_param(11, Optional()),
+  _ts_param(11, Inject2(GENUI_CATALOG)),
+  _ts_param(12, Optional()),
   _ts_metadata("design:type", Function),
   _ts_metadata("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
@@ -260,13 +556,15 @@ AgentDepsFactory2 = _ts_decorate([
     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, AGENT_MODEL_CATALOG, AGENT_OPTIONS as AGENT_OPTIONS3, AGENT_QUOTA_PROVIDER as AGENT_QUOTA_PROVIDER2, AGENT_RUNNER, AGENT_STORE as AGENT_STORE3, REQUESTER_APPROVER, findCatalogModel, mayDecideApproval, readElicitationQuestions, settleDeadRun, validateElicitationAnswer } from "@dudousxd/nestjs-agent-core";
-import { BadRequestException, ConflictException as ConflictException2, ForbiddenException, GoneException, HttpException, HttpStatus, Inject as Inject3, Injectable as Injectable3, NotFoundException, NotImplementedException as NotImplementedException2, Optional as Optional3 } from "@nestjs/common";
+import { AGENT_ATTACHMENT_STAGING as AGENT_ATTACHMENT_STAGING2, AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY2, AGENT_MODEL_CATALOG, AGENT_OPTIONS as AGENT_OPTIONS4, AGENT_QUOTA_PROVIDER as AGENT_QUOTA_PROVIDER2, AGENT_RUNNER, AGENT_STORE as AGENT_STORE4, REQUESTER_APPROVER, findCatalogModel, mayDecideApproval as mayDecideApproval2, readElicitationQuestions, settleDeadRun, validateElicitationAnswer } from "@dudousxd/nestjs-agent-core";
+import { BadRequestException as BadRequestException2, ConflictException as ConflictException2, ForbiddenException as ForbiddenException2, GoneException, HttpException, HttpStatus, Inject as Inject5, Injectable as Injectable4, NotFoundException as NotFoundException2, NotImplementedException as NotImplementedException3, Optional as Optional3 } from "@nestjs/common";
 
 // src/agent-deps.ts
 function utcDay(date = /* @__PURE__ */ new Date()) {
@@ -290,10 +588,10 @@ function childSinkWriter(writer) {
 }
 __name(childSinkWriter, "childSinkWriter");
 
-// src/queue/chat-queue.service.ts
-import { AGENT_ATTACHMENT_STAGING, AGENT_OPTIONS as AGENT_OPTIONS2, AGENT_QUOTA_PROVIDER, AGENT_SINK as AGENT_SINK2, AGENT_STORE as AGENT_STORE2, encodeStreamEvent, isChatQueueStore, queuedMessageView } from "@dudousxd/nestjs-agent-core";
-import { Inject as Inject2, Injectable as Injectable2, Logger, NotImplementedException, Optional as Optional2 } from "@nestjs/common";
-function _ts_decorate2(decorators, target, key, desc) {
+// src/proposals/action-proposal.service.ts
+import { AGENT_OPTIONS as AGENT_OPTIONS2, AGENT_STORE as AGENT_STORE2, mayDecideApproval, parseTextActionProposalCommand, resolveTextActionProposalDecision } from "@dudousxd/nestjs-agent-core";
+import { ForbiddenException, Inject as Inject3, Injectable as Injectable2, NotFoundException, NotImplementedException } from "@nestjs/common";
+function _ts_decorate3(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -306,7 +604,7 @@ function _ts_decorate2(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate2, "_ts_decorate");
+__name(_ts_decorate3, "_ts_decorate");
 function _ts_metadata2(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
@@ -319,6 +617,168 @@ function _ts_param2(paramIndex, decorator) {
   };
 }
 __name(_ts_param2, "_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_decorate3([
+  Injectable2(),
+  _ts_param2(0, Inject3(AGENT_STORE2)),
+  _ts_param2(1, Inject3(AGENT_OPTIONS2)),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("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, AGENT_OPTIONS as AGENT_OPTIONS3, AGENT_QUOTA_PROVIDER, AGENT_SINK as AGENT_SINK2, AGENT_STORE as AGENT_STORE3, encodeStreamEvent, isChatQueueStore, queuedMessageView } from "@dudousxd/nestjs-agent-core";
+import { Inject as Inject4, Injectable as Injectable3, Logger, NotImplementedException as NotImplementedException2, Optional as Optional2 } 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_decorate4(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
+    r = Reflect.decorate(decorators, target, key, desc);
+  } else {
+    for (var i = decorators.length - 1; i >= 0; i--) {
+      if (d = decorators[i]) {
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      }
+    }
+  }
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate4, "_ts_decorate");
+function _ts_metadata3(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
+}
+__name(_ts_metadata3, "_ts_metadata");
+function _ts_param3(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param3, "_ts_param");
 var MAX_DRAIN_ATTEMPTS = 8;
 var ChatQueueService = class _ChatQueueService {
   static {
@@ -329,18 +789,20 @@ var ChatQueueService = class _ChatQueueService {
   quotaProvider;
   options;
   staging;
+  deps;
   logger = new Logger(_ChatQueueService.name);
   /**
   * Runs this process claimed a thread for and has not handed to a runner yet. A holder in here is
   * alive whatever the runner says — it simply has not registered the run yet.
   */
   starting = /* @__PURE__ */ new Set();
-  constructor(store, sink, quotaProvider, options, staging) {
+  constructor(store, sink, quotaProvider, options, staging, deps) {
     this.store = store;
     this.sink = sink;
     this.quotaProvider = quotaProvider;
     this.options = options;
     this.staging = staging;
+    this.deps = deps;
   }
   /** Whether the bound store can hold a queue. Without one, a busy thread is not queued. */
   get supported() {
@@ -349,7 +811,7 @@ var ChatQueueService = 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;
   }
@@ -576,6 +1038,9 @@ var ChatQueueService = class _ChatQueueService {
       } : {},
       ...input.pageContext !== void 0 ? {
         pageContext: input.pageContext
+      } : {},
+      ...input.uiCapabilities !== void 0 ? {
+        uiCapabilities: input.uiCapabilities
       } : {}
     });
     await store.setQueuePause(threadId, {
@@ -638,13 +1103,17 @@ var ChatQueueService = 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
@@ -652,11 +1121,45 @@ var ChatQueueService = 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") {
@@ -674,23 +1177,26 @@ var ChatQueueService = class _ChatQueueService {
     }));
   }
 };
-ChatQueueService = _ts_decorate2([
-  Injectable2(),
-  _ts_param2(0, Inject2(AGENT_STORE2)),
-  _ts_param2(1, Inject2(AGENT_SINK2)),
-  _ts_param2(2, Optional2()),
-  _ts_param2(2, Inject2(AGENT_QUOTA_PROVIDER)),
-  _ts_param2(3, Optional2()),
-  _ts_param2(3, Inject2(AGENT_OPTIONS2)),
-  _ts_param2(4, Optional2()),
-  _ts_param2(4, Inject2(AGENT_ATTACHMENT_STAGING)),
-  _ts_metadata2("design:type", Function),
-  _ts_metadata2("design:paramtypes", [
+ChatQueueService = _ts_decorate4([
+  Injectable3(),
+  _ts_param3(0, Inject4(AGENT_STORE3)),
+  _ts_param3(1, Inject4(AGENT_SINK2)),
+  _ts_param3(2, Optional2()),
+  _ts_param3(2, Inject4(AGENT_QUOTA_PROVIDER)),
+  _ts_param3(3, Optional2()),
+  _ts_param3(3, Inject4(AGENT_OPTIONS3)),
+  _ts_param3(4, Optional2()),
+  _ts_param3(4, Inject4(AGENT_ATTACHMENT_STAGING)),
+  _ts_param3(5, Optional2()),
+  _ts_param3(5, Inject4(AGENT_DEPS_FACTORY)),
+  _ts_metadata3("design:type", Function),
+  _ts_metadata3("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
   ])
 ], ChatQueueService);
 function pauseReasonFor(outcome, head) {
@@ -736,7 +1242,7 @@ var RunNotActiveException = class extends ConflictException {
 };
 
 // src/agent.service.ts
-function _ts_decorate3(decorators, target, key, desc) {
+function _ts_decorate5(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -749,19 +1255,19 @@ function _ts_decorate3(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate3, "_ts_decorate");
-function _ts_metadata3(metadataKey, metadataValue) {
+__name(_ts_decorate5, "_ts_decorate");
+function _ts_metadata4(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata3, "_ts_metadata");
-function _ts_param3(paramIndex, decorator) {
+__name(_ts_metadata4, "_ts_metadata");
+function _ts_param4(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param3, "_ts_param");
+__name(_ts_param4, "_ts_param");
 var AgentService = class {
   static {
     __name(this, "AgentService");
@@ -774,7 +1280,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;
@@ -783,8 +1290,15 @@ var AgentService = class {
     this.quotaProvider = quotaProvider;
     this.options = options;
     this.queue = queue;
+    this.proposals = proposals;
   }
-  /** The queue service when the bound store can hold a queue, else `undefined`. */
+  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() {
     return this.queue?.supported === true ? this.queue : void 0;
   }
@@ -792,7 +1306,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;
   }
@@ -862,17 +1376,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;
   }
@@ -888,7 +1402,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;
     }
@@ -914,7 +1428,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;
     }
@@ -942,15 +1459,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,
@@ -959,11 +1482,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,
@@ -971,6 +1500,9 @@ var AgentService = class {
       userText: params.message,
       day: utcDay(),
       agentName,
+      ...persona !== void 0 ? {
+        persona
+      } : {},
       ...params.regenerate === true ? {
         regenerate: true
       } : {},
@@ -980,12 +1512,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 {
@@ -1057,12 +1593,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"
@@ -1109,7 +1651,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) {
@@ -1127,7 +1669,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`);
@@ -1167,7 +1709,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();
@@ -1226,7 +1768,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;
@@ -1247,7 +1789,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) {
@@ -1256,7 +1798,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);
     }
@@ -1358,6 +1900,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);
@@ -1398,7 +1941,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");
     }
   }
   /**
@@ -1451,16 +1994,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
@@ -1470,16 +2019,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;
   }
@@ -1518,6 +2097,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
     };
   }
@@ -1582,21 +2162,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 : {
@@ -1644,7 +2224,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({
@@ -1666,7 +2246,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;
   }
@@ -1677,10 +2257,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");
     }
   }
   /**
@@ -1691,10 +2271,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");
     }
   }
   /**
@@ -1714,7 +2294,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}`);
       }
     }
   }
@@ -1732,15 +2312,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}`);
     }
   }
   /**
@@ -1769,7 +2349,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;
   }
@@ -1777,29 +2357,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_decorate3([
-  Injectable3(),
-  _ts_param3(0, Inject3(AGENT_RUNNER)),
-  _ts_param3(1, Inject3(AGENT_STORE3)),
-  _ts_param3(2, Inject3(AGENT_DEPS_FACTORY)),
-  _ts_param3(3, Optional3()),
-  _ts_param3(3, Inject3(AGENT_ATTACHMENT_STAGING2)),
-  _ts_param3(4, Optional3()),
-  _ts_param3(4, Inject3(AGENT_MODEL_CATALOG)),
-  _ts_param3(5, Optional3()),
-  _ts_param3(5, Inject3(AGENT_QUOTA_PROVIDER2)),
-  _ts_param3(6, Optional3()),
-  _ts_param3(6, Inject3(AGENT_OPTIONS3)),
-  _ts_param3(7, Optional3()),
-  _ts_metadata3("design:type", Function),
-  _ts_metadata3("design:paramtypes", [
+AgentService = _ts_decorate5([
+  Injectable4(),
+  _ts_param4(0, Inject5(AGENT_RUNNER)),
+  _ts_param4(1, Inject5(AGENT_STORE4)),
+  _ts_param4(2, Inject5(AGENT_DEPS_FACTORY2)),
+  _ts_param4(3, Optional3()),
+  _ts_param4(3, Inject5(AGENT_ATTACHMENT_STAGING2)),
+  _ts_param4(4, Optional3()),
+  _ts_param4(4, Inject5(AGENT_MODEL_CATALOG)),
+  _ts_param4(5, Optional3()),
+  _ts_param4(5, Inject5(AGENT_QUOTA_PROVIDER2)),
+  _ts_param4(6, Optional3()),
+  _ts_param4(6, Inject5(AGENT_OPTIONS4)),
+  _ts_param4(7, Optional3()),
+  _ts_param4(8, Optional3()),
+  _ts_metadata4("design:type", Function),
+  _ts_metadata4("design:paramtypes", [
     typeof AgentRunner === "undefined" ? Object : AgentRunner,
     typeof AgentStore === "undefined" ? Object : AgentStore,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
@@ -1807,13 +2388,14 @@ AgentService = _ts_decorate3([
     typeof ModelCatalog === "undefined" ? Object : ModelCatalog,
     typeof QuotaProvider === "undefined" ? Object : QuotaProvider,
     typeof Pick === "undefined" ? Object : Pick,
-    typeof ChatQueueService === "undefined" ? Object : ChatQueueService
+    typeof ChatQueueService === "undefined" ? Object : ChatQueueService,
+    typeof ActionProposalService === "undefined" ? Object : ActionProposalService
   ])
 ], AgentService);
 
 // src/approval-port.adapter.ts
-import { Injectable as Injectable4 } from "@nestjs/common";
-function _ts_decorate4(decorators, target, key, desc) {
+import { Injectable as Injectable5, NotImplementedException as NotImplementedException4, Optional as Optional4 } from "@nestjs/common";
+function _ts_decorate6(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -1826,20 +2408,48 @@ function _ts_decorate4(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate4, "_ts_decorate");
-function _ts_metadata4(metadataKey, metadataValue) {
+__name(_ts_decorate6, "_ts_decorate");
+function _ts_metadata5(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata4, "_ts_metadata");
+__name(_ts_metadata5, "_ts_metadata");
+function _ts_param5(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param5, "_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, {
@@ -1870,18 +2480,20 @@ var AgentApprovalPortAdapter = class {
     });
   }
 };
-AgentApprovalPortAdapter = _ts_decorate4([
-  Injectable4(),
-  _ts_metadata4("design:type", Function),
-  _ts_metadata4("design:paramtypes", [
-    typeof AgentService === "undefined" ? Object : AgentService
+AgentApprovalPortAdapter = _ts_decorate6([
+  Injectable5(),
+  _ts_param5(1, Optional4()),
+  _ts_metadata5("design:type", Function),
+  _ts_metadata5("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_FACTORY2, AGENT_REGISTRY as AGENT_REGISTRY2, AgentRegistry as AgentRegistry3 } from "@dudousxd/nestjs-agent-core";
-import { Controller, Get, Inject as Inject4 } from "@nestjs/common";
-function _ts_decorate5(decorators, target, key, desc) {
+import { AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY3, AGENT_REGISTRY as AGENT_REGISTRY2, AgentRegistry as AgentRegistry3 } from "@dudousxd/nestjs-agent-core";
+import { Controller, Get, Inject as Inject6 } 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);
@@ -1894,19 +2506,19 @@ function _ts_decorate5(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate5, "_ts_decorate");
-function _ts_metadata5(metadataKey, metadataValue) {
+__name(_ts_decorate7, "_ts_decorate");
+function _ts_metadata6(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata5, "_ts_metadata");
-function _ts_param4(paramIndex, decorator) {
+__name(_ts_metadata6, "_ts_metadata");
+function _ts_param6(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param4, "_ts_param");
+__name(_ts_param6, "_ts_param");
 var AgentsController = class {
   static {
     __name(this, "AgentsController");
@@ -1919,35 +2531,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_decorate5([
+_ts_decorate7([
   Get(),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", []),
-  _ts_metadata5("design:returntype", Array)
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("design:paramtypes", []),
+  _ts_metadata6("design:returntype", Array)
 ], AgentsController.prototype, "list", null);
-AgentsController = _ts_decorate5([
+AgentsController = _ts_decorate7([
   Controller("agents"),
-  _ts_param4(0, Inject4(AGENT_REGISTRY2)),
-  _ts_param4(1, Inject4(AGENT_DEPS_FACTORY2)),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+  _ts_param6(0, Inject6(AGENT_REGISTRY2)),
+  _ts_param6(1, Inject6(AGENT_DEPS_FACTORY3)),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("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 Inject5, NotImplementedException as NotImplementedException3, Optional as Optional4, 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 Inject7, NotImplementedException as NotImplementedException5, Optional as Optional5, PayloadTooLargeException, Post, Req, UnsupportedMediaTypeException, UploadedFile, UseInterceptors } from "@nestjs/common";
 import { FileInterceptor } from "@nestjs/platform-express";
 
 // src/attachment-limits.ts
@@ -1976,7 +2597,7 @@ function attachmentLimits(options, staging) {
 __name(attachmentLimits, "attachmentLimits");
 
 // src/controller/attachments.controller.ts
-function _ts_decorate6(decorators, target, key, desc) {
+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);
@@ -1989,19 +2610,19 @@ function _ts_decorate6(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate6, "_ts_decorate");
-function _ts_metadata6(metadataKey, metadataValue) {
+__name(_ts_decorate8, "_ts_decorate");
+function _ts_metadata7(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata6, "_ts_metadata");
-function _ts_param5(paramIndex, decorator) {
+__name(_ts_metadata7, "_ts_metadata");
+function _ts_param7(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param5, "_ts_param");
+__name(_ts_param7, "_ts_param");
 var HARD_MAX_ATTACHMENT_BYTES = 32 * 1024 * 1024;
 var ATTACHMENT_PAGE_SIZE = 50;
 var AttachmentsController = class {
@@ -2035,10 +2656,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)) {
@@ -2057,39 +2678,39 @@ var AttachmentsController = class {
     });
   }
 };
-_ts_decorate6([
+_ts_decorate8([
   Get2(),
-  _ts_param5(0, Req()),
-  _ts_metadata6("design:type", Function),
-  _ts_metadata6("design:paramtypes", [
+  _ts_param7(0, Req()),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata6("design:returntype", Promise)
+  _ts_metadata7("design:returntype", Promise)
 ], AttachmentsController.prototype, "list", null);
-_ts_decorate6([
+_ts_decorate8([
   Post(),
   UseInterceptors(FileInterceptor("file", {
     limits: {
       fileSize: HARD_MAX_ATTACHMENT_BYTES
     }
   })),
-  _ts_param5(0, Req()),
-  _ts_param5(1, UploadedFile()),
-  _ts_metadata6("design:type", Function),
-  _ts_metadata6("design:paramtypes", [
+  _ts_param7(0, Req()),
+  _ts_param7(1, UploadedFile()),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     Object
   ]),
-  _ts_metadata6("design:returntype", Promise)
+  _ts_metadata7("design:returntype", Promise)
 ], AttachmentsController.prototype, "upload", null);
-AttachmentsController = _ts_decorate6([
+AttachmentsController = _ts_decorate8([
   Controller2("attachments"),
-  _ts_param5(0, Inject5(AGENT_OPTIONS4)),
-  _ts_param5(1, Inject5(AGENT_ACTOR_RESOLVER)),
-  _ts_param5(3, Optional4()),
-  _ts_param5(3, Inject5(AGENT_ATTACHMENT_STAGING3)),
-  _ts_metadata6("design:type", Function),
-  _ts_metadata6("design:paramtypes", [
+  _ts_param7(0, Inject7(AGENT_OPTIONS5)),
+  _ts_param7(1, Inject7(AGENT_ACTOR_RESOLVER)),
+  _ts_param7(3, Optional5()),
+  _ts_param7(3, Inject7(AGENT_ATTACHMENT_STAGING3)),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -2099,8 +2720,9 @@ AttachmentsController = _ts_decorate6([
 
 // src/controller/chat.controller.ts
 import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER2, AgentStreamError, streamFailure } from "@dudousxd/nestjs-agent-core";
-import { BadRequestException as BadRequestException3, Body, Controller as Controller3, Get as Get3, Inject as Inject6, Param, Post as Post2, Query, Req as Req2, Res } from "@nestjs/common";
-function _ts_decorate7(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 Inject8, Param, Post as Post2, Query, Req as Req2, Res } from "@nestjs/common";
+function _ts_decorate9(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -2113,19 +2735,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_metadata7(metadataKey, metadataValue) {
+__name(_ts_decorate9, "_ts_decorate");
+function _ts_metadata8(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata7, "_ts_metadata");
-function _ts_param6(paramIndex, decorator) {
+__name(_ts_metadata8, "_ts_metadata");
+function _ts_param8(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param6, "_ts_param");
+__name(_ts_param8, "_ts_param");
 function sendMode(body) {
   if (body.interrupt === true) {
     return "interrupt";
@@ -2136,7 +2758,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) {
@@ -2144,21 +2766,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
@@ -2186,15 +2808,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
       } : {},
@@ -2212,6 +2846,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;
@@ -2303,50 +2941,50 @@ data: ${JSON.stringify(payload)}
     res.end();
   }
 };
-_ts_decorate7([
+_ts_decorate9([
   Post2("chat"),
-  _ts_param6(0, Req2()),
-  _ts_param6(1, Res()),
-  _ts_param6(2, Body()),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
+  _ts_param8(0, Req2()),
+  _ts_param8(1, Res()),
+  _ts_param8(2, Body()),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof Response === "undefined" ? Object : Response,
     typeof ChatBody === "undefined" ? Object : ChatBody
   ]),
-  _ts_metadata7("design:returntype", Promise)
+  _ts_metadata8("design:returntype", Promise)
 ], ChatController.prototype, "chat", null);
-_ts_decorate7([
+_ts_decorate9([
   Get3("chat/:runId/stream"),
-  _ts_param6(0, Req2()),
-  _ts_param6(1, Param("runId")),
-  _ts_param6(2, Res()),
-  _ts_param6(3, Query("after")),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
+  _ts_param8(0, Req2()),
+  _ts_param8(1, Param("runId")),
+  _ts_param8(2, Res()),
+  _ts_param8(3, Query("after")),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     typeof Response === "undefined" ? Object : Response,
     String
   ]),
-  _ts_metadata7("design:returntype", Promise)
+  _ts_metadata8("design:returntype", Promise)
 ], ChatController.prototype, "stream", null);
-_ts_decorate7([
+_ts_decorate9([
   Post2("chat/:runId/cancel"),
-  _ts_param6(0, Req2()),
-  _ts_param6(1, Param("runId")),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
+  _ts_param8(0, Req2()),
+  _ts_param8(1, Param("runId")),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata7("design:returntype", Promise)
+  _ts_metadata8("design:returntype", Promise)
 ], ChatController.prototype, "cancel", null);
-ChatController = _ts_decorate7([
+ChatController = _ts_decorate9([
   Controller3(),
-  _ts_param6(1, Inject6(AGENT_ACTOR_RESOLVER2)),
-  _ts_metadata7("design:type", Function),
-  _ts_metadata7("design:paramtypes", [
+  _ts_param8(1, Inject8(AGENT_ACTOR_RESOLVER2)),
+  _ts_metadata8("design:type", Function),
+  _ts_metadata8("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
@@ -2362,8 +3000,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 Inject7, Optional as Optional5, 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 Inject9, Optional as Optional6, Req as Req3 } from "@nestjs/common";
 
 // src/resolver/anonymous-actor-resolver.ts
 import { createHash, randomBytes } from "crypto";
@@ -2453,7 +3091,7 @@ var AnonymousActorResolver = class {
 };
 
 // src/controller/config.controller.ts
-function _ts_decorate8(decorators, target, key, desc) {
+function _ts_decorate10(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -2466,19 +3104,19 @@ function _ts_decorate8(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate8, "_ts_decorate");
-function _ts_metadata8(metadataKey, metadataValue) {
+__name(_ts_decorate10, "_ts_decorate");
+function _ts_metadata9(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata8, "_ts_metadata");
-function _ts_param7(paramIndex, decorator) {
+__name(_ts_metadata9, "_ts_metadata");
+function _ts_param9(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param7, "_ts_param");
+__name(_ts_param9, "_ts_param");
 var ConfigController = class {
   static {
     __name(this, "ConfigController");
@@ -2509,25 +3147,25 @@ var ConfigController = class {
     };
   }
 };
-_ts_decorate8([
+_ts_decorate10([
   Get4(),
-  _ts_param7(0, Req3()),
-  _ts_metadata8("design:type", Function),
-  _ts_metadata8("design:paramtypes", [
+  _ts_param9(0, Req3()),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata8("design:returntype", Promise)
+  _ts_metadata9("design:returntype", Promise)
 ], ConfigController.prototype, "config", null);
-ConfigController = _ts_decorate8([
+ConfigController = _ts_decorate10([
   Controller4("config"),
-  _ts_param7(0, Inject7(AGENT_OPTIONS5)),
-  _ts_param7(1, Inject7(AGENT_ACTOR_RESOLVER3)),
-  _ts_param7(2, Optional5()),
-  _ts_param7(2, Inject7(AGENT_ATTACHMENT_STAGING4)),
-  _ts_param7(3, Optional5()),
-  _ts_param7(3, Inject7(AGENT_MODEL_CATALOG2)),
-  _ts_metadata8("design:type", Function),
-  _ts_metadata8("design:paramtypes", [
+  _ts_param9(0, Inject9(AGENT_OPTIONS6)),
+  _ts_param9(1, Inject9(AGENT_ACTOR_RESOLVER3)),
+  _ts_param9(2, Optional6()),
+  _ts_param9(2, Inject9(AGENT_ATTACHMENT_STAGING4)),
+  _ts_param9(3, Optional6()),
+  _ts_param9(3, Inject9(AGENT_MODEL_CATALOG2)),
+  _ts_metadata9("design:type", Function),
+  _ts_metadata9("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     Object,
@@ -2537,8 +3175,8 @@ ConfigController = _ts_decorate8([
 
 // 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 Inject8, NotFoundException as NotFoundException2, Optional as Optional6, Param as Param2, Query as Query2, Req as Req4 } from "@nestjs/common";
-function _ts_decorate9(decorators, target, key, desc) {
+import { Controller as Controller5, Delete, ForbiddenException as ForbiddenException3, Get as Get5, Inject as Inject10, NotFoundException as NotFoundException3, Optional as Optional7, Param as Param2, Query as Query2, Req as Req4 } 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);
@@ -2551,19 +3189,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_metadata9(metadataKey, metadataValue) {
+__name(_ts_decorate11, "_ts_decorate");
+function _ts_metadata10(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata9, "_ts_metadata");
-function _ts_param8(paramIndex, decorator) {
+__name(_ts_metadata10, "_ts_metadata");
+function _ts_param10(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param8, "_ts_param");
+__name(_ts_param10, "_ts_param");
 var MemoriesController = class {
   static {
     __name(this, "MemoriesController");
@@ -2597,20 +3235,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({
@@ -2636,35 +3274,35 @@ var MemoriesController = class {
     });
   }
 };
-_ts_decorate9([
+_ts_decorate11([
   Get5(),
-  _ts_param8(0, Req4()),
-  _ts_param8(1, Query2("threadId")),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+  _ts_param10(0, Req4()),
+  _ts_param10(1, Query2("threadId")),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata9("design:returntype", Promise)
+  _ts_metadata10("design:returntype", Promise)
 ], MemoriesController.prototype, "list", null);
-_ts_decorate9([
+_ts_decorate11([
   Delete(":id"),
-  _ts_param8(0, Req4()),
-  _ts_param8(1, Param2("id")),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+  _ts_param10(0, Req4()),
+  _ts_param10(1, Param2("id")),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata9("design:returntype", Promise)
+  _ts_metadata10("design:returntype", Promise)
 ], MemoriesController.prototype, "forget", null);
-MemoriesController = _ts_decorate9([
+MemoriesController = _ts_decorate11([
   Controller5("memories"),
-  _ts_param8(0, Inject8(AGENT_ACTOR_RESOLVER4)),
-  _ts_param8(1, Optional6()),
-  _ts_param8(1, Inject8(AGENT_MEMORY2)),
-  _ts_metadata9("design:type", Function),
-  _ts_metadata9("design:paramtypes", [
+  _ts_param10(0, Inject10(AGENT_ACTOR_RESOLVER4)),
+  _ts_param10(1, Optional7()),
+  _ts_param10(1, Inject10(AGENT_MEMORY2)),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     Object
   ])
@@ -2672,8 +3310,8 @@ MemoriesController = _ts_decorate9([
 
 // 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 Inject9, Param as Param3, Post as Post3, Req as Req5 } from "@nestjs/common";
-function _ts_decorate10(decorators, target, key, desc) {
+import { Body as Body2, Controller as Controller6, HttpCode, Inject as Inject11, Param as Param3, Post as Post3, Req as Req5 } from "@nestjs/common";
+function _ts_decorate12(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -2686,19 +3324,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_metadata10(metadataKey, metadataValue) {
+__name(_ts_decorate12, "_ts_decorate");
+function _ts_metadata11(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata10, "_ts_metadata");
-function _ts_param9(paramIndex, decorator) {
+__name(_ts_metadata11, "_ts_metadata");
+function _ts_param11(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param9, "_ts_param");
+__name(_ts_param11, "_ts_param");
 var MessagesController = class {
   static {
     __name(this, "MessagesController");
@@ -2726,25 +3364,25 @@ var MessagesController = class {
     };
   }
 };
-_ts_decorate10([
+_ts_decorate12([
   Post3(":id/feedback"),
   HttpCode(200),
-  _ts_param9(0, Req5()),
-  _ts_param9(1, Param3("id")),
-  _ts_param9(2, Body2()),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+  _ts_param11(0, Req5()),
+  _ts_param11(1, Param3("id")),
+  _ts_param11(2, Body2()),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     typeof FeedbackBody === "undefined" ? Object : FeedbackBody
   ]),
-  _ts_metadata10("design:returntype", Promise)
+  _ts_metadata11("design:returntype", Promise)
 ], MessagesController.prototype, "feedback", null);
-MessagesController = _ts_decorate10([
+MessagesController = _ts_decorate12([
   Controller6("messages"),
-  _ts_param9(1, Inject9(AGENT_ACTOR_RESOLVER5)),
-  _ts_metadata10("design:type", Function),
-  _ts_metadata10("design:paramtypes", [
+  _ts_param11(1, Inject11(AGENT_ACTOR_RESOLVER5)),
+  _ts_metadata11("design:type", Function),
+  _ts_metadata11("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
@@ -2752,8 +3390,8 @@ MessagesController = _ts_decorate10([
 
 // 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 Inject10, Query as Query3, Req as Req6 } from "@nestjs/common";
-function _ts_decorate11(decorators, target, key, desc) {
+import { Controller as Controller7, Get as Get6, Inject as Inject12, Query as Query3, Req as Req6 } 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);
@@ -2766,19 +3404,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_metadata11(metadataKey, metadataValue) {
+__name(_ts_decorate13, "_ts_decorate");
+function _ts_metadata12(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata11, "_ts_metadata");
-function _ts_param10(paramIndex, decorator) {
+__name(_ts_metadata12, "_ts_metadata");
+function _ts_param12(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param10, "_ts_param");
+__name(_ts_param12, "_ts_param");
 var ModelsController = class {
   static {
     __name(this, "ModelsController");
@@ -2798,22 +3436,22 @@ var ModelsController = class {
     return this.agent.listModels(actor, agent);
   }
 };
-_ts_decorate11([
+_ts_decorate13([
   Get6(),
-  _ts_param10(0, Req6()),
-  _ts_param10(1, Query3("agent")),
-  _ts_metadata11("design:type", Function),
-  _ts_metadata11("design:paramtypes", [
+  _ts_param12(0, Req6()),
+  _ts_param12(1, Query3("agent")),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String
   ]),
-  _ts_metadata11("design:returntype", Promise)
+  _ts_metadata12("design:returntype", Promise)
 ], ModelsController.prototype, "list", null);
-ModelsController = _ts_decorate11([
+ModelsController = _ts_decorate13([
   Controller7("models"),
-  _ts_param10(1, Inject10(AGENT_ACTOR_RESOLVER6)),
-  _ts_metadata11("design:type", Function),
-  _ts_metadata11("design:paramtypes", [
+  _ts_param12(1, Inject12(AGENT_ACTOR_RESOLVER6)),
+  _ts_metadata12("design:type", Function),
+  _ts_metadata12("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
@@ -2821,8 +3459,8 @@ ModelsController = _ts_decorate11([
 
 // 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 Inject11, Param as Param4, Patch, Post as Post4, Req as Req7 } from "@nestjs/common";
-function _ts_decorate12(decorators, target, key, desc) {
+import { BadRequestException as BadRequestException5, Body as Body3, Controller as Controller8, Delete as Delete2, Get as Get7, Inject as Inject13, Param as Param4, Patch, Post as Post4, Req as Req7 } from "@nestjs/common";
+function _ts_decorate14(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -2835,19 +3473,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_metadata12(metadataKey, metadataValue) {
+__name(_ts_decorate14, "_ts_decorate");
+function _ts_metadata13(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata12, "_ts_metadata");
-function _ts_param11(paramIndex, decorator) {
+__name(_ts_metadata13, "_ts_metadata");
+function _ts_param13(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param11, "_ts_param");
+__name(_ts_param13, "_ts_param");
 var QueueController = class {
   static {
     __name(this, "QueueController");
@@ -2871,10 +3509,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, {
@@ -2901,79 +3539,79 @@ var QueueController = class {
     return this.agent.removeQueuedMessage(await this.actorResolver.resolve(req), messageId);
   }
 };
-_ts_decorate12([
+_ts_decorate14([
   Get7("threads/:id/queue"),
-  _ts_param11(0, Req7()),
-  _ts_param11(1, Param4("id")),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+  _ts_param13(0, Req7()),
+  _ts_param13(1, Param4("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)
 ], QueueController.prototype, "list", null);
-_ts_decorate12([
+_ts_decorate14([
   Delete2("threads/:id/queue"),
-  _ts_param11(0, Req7()),
-  _ts_param11(1, Param4("id")),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+  _ts_param13(0, Req7()),
+  _ts_param13(1, Param4("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)
 ], QueueController.prototype, "clear", null);
-_ts_decorate12([
+_ts_decorate14([
   Post4("threads/:id/queue/resume"),
-  _ts_param11(0, Req7()),
-  _ts_param11(1, Param4("id")),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+  _ts_param13(0, Req7()),
+  _ts_param13(1, Param4("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)
 ], QueueController.prototype, "resume", null);
-_ts_decorate12([
+_ts_decorate14([
   Patch("queue/:messageId"),
-  _ts_param11(0, Req7()),
-  _ts_param11(1, Param4("messageId")),
-  _ts_param11(2, Body3()),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+  _ts_param13(0, Req7()),
+  _ts_param13(1, Param4("messageId")),
+  _ts_param13(2, Body3()),
+  _ts_metadata13("design:type", Function),
+  _ts_metadata13("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     typeof UpdateQueuedMessageBody === "undefined" ? Object : UpdateQueuedMessageBody
   ]),
-  _ts_metadata12("design:returntype", Promise)
+  _ts_metadata13("design:returntype", Promise)
 ], QueueController.prototype, "update", null);
-_ts_decorate12([
+_ts_decorate14([
   Post4("queue/:messageId/interrupt"),
-  _ts_param11(0, Req7()),
-  _ts_param11(1, Param4("messageId")),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+  _ts_param13(0, Req7()),
+  _ts_param13(1, Param4("messageId")),
+  _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)
 ], QueueController.prototype, "interrupt", null);
-_ts_decorate12([
+_ts_decorate14([
   Delete2("queue/:messageId"),
-  _ts_param11(0, Req7()),
-  _ts_param11(1, Param4("messageId")),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+  _ts_param13(0, Req7()),
+  _ts_param13(1, Param4("messageId")),
+  _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)
 ], QueueController.prototype, "remove", null);
-QueueController = _ts_decorate12([
+QueueController = _ts_decorate14([
   Controller8(),
-  _ts_param11(1, Inject11(AGENT_ACTOR_RESOLVER7)),
-  _ts_metadata12("design:type", Function),
-  _ts_metadata12("design:paramtypes", [
+  _ts_param13(1, Inject13(AGENT_ACTOR_RESOLVER7)),
+  _ts_metadata13("design:type", Function),
+  _ts_metadata13("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
@@ -2981,8 +3619,8 @@ QueueController = _ts_decorate12([
 
 // 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 Inject12, Req as Req8 } from "@nestjs/common";
-function _ts_decorate13(decorators, target, key, desc) {
+import { Controller as Controller9, Get as Get8, Inject as Inject14, Req as Req8 } 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);
@@ -2995,19 +3633,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_metadata13(metadataKey, metadataValue) {
+__name(_ts_decorate15, "_ts_decorate");
+function _ts_metadata14(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata13, "_ts_metadata");
-function _ts_param12(paramIndex, decorator) {
+__name(_ts_metadata14, "_ts_metadata");
+function _ts_param14(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param12, "_ts_param");
+__name(_ts_param14, "_ts_param");
 var QuotaController = class {
   static {
     __name(this, "QuotaController");
@@ -3027,20 +3665,20 @@ var QuotaController = class {
     return this.agent.quotaReport(actor);
   }
 };
-_ts_decorate13([
+_ts_decorate15([
   Get8(),
-  _ts_param12(0, Req8()),
-  _ts_metadata13("design:type", Function),
-  _ts_metadata13("design:paramtypes", [
+  _ts_param14(0, Req8()),
+  _ts_metadata14("design:type", Function),
+  _ts_metadata14("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata13("design:returntype", Promise)
+  _ts_metadata14("design:returntype", Promise)
 ], QuotaController.prototype, "report", null);
-QuotaController = _ts_decorate13([
+QuotaController = _ts_decorate15([
   Controller9("quota"),
-  _ts_param12(1, Inject12(AGENT_ACTOR_RESOLVER8)),
-  _ts_metadata13("design:type", Function),
-  _ts_metadata13("design:paramtypes", [
+  _ts_param14(1, Inject14(AGENT_ACTOR_RESOLVER8)),
+  _ts_metadata14("design:type", Function),
+  _ts_metadata14("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
@@ -3048,8 +3686,8 @@ QuotaController = _ts_decorate13([
 
 // 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 Inject13, Optional as Optional7, Query as Query4, Req as Req9 } from "@nestjs/common";
-function _ts_decorate14(decorators, target, key, desc) {
+import { Controller as Controller10, Get as Get9, Inject as Inject15, Optional as Optional8, Query as Query4, Req as Req9 } 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);
@@ -3062,19 +3700,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_metadata14(metadataKey, metadataValue) {
+__name(_ts_decorate16, "_ts_decorate");
+function _ts_metadata15(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_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 SkillsController = class {
   static {
     __name(this, "SkillsController");
@@ -3097,24 +3735,24 @@ var SkillsController = class {
     return offer.entries;
   }
 };
-_ts_decorate14([
+_ts_decorate16([
   Get9(),
-  _ts_param13(0, Req9()),
-  _ts_param13(1, Query4("threadId")),
-  _ts_metadata14("design:type", Function),
-  _ts_metadata14("design:paramtypes", [
+  _ts_param15(0, Req9()),
+  _ts_param15(1, Query4("threadId")),
+  _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)
 ], SkillsController.prototype, "list", null);
-SkillsController = _ts_decorate14([
+SkillsController = _ts_decorate16([
   Controller10("skills"),
-  _ts_param13(0, Inject13(AGENT_ACTOR_RESOLVER9)),
-  _ts_param13(1, Optional7()),
-  _ts_param13(1, Inject13(AGENT_SKILLS2)),
-  _ts_metadata14("design:type", Function),
-  _ts_metadata14("design:paramtypes", [
+  _ts_param15(0, Inject15(AGENT_ACTOR_RESOLVER9)),
+  _ts_param15(1, Optional8()),
+  _ts_param15(1, Inject15(AGENT_SKILLS2)),
+  _ts_metadata15("design:type", Function),
+  _ts_metadata15("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     Object
   ])
@@ -3122,8 +3760,8 @@ SkillsController = _ts_decorate14([
 
 // 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 Inject14, Param as Param5, Patch as Patch2, Post as Post5, Req as Req10 } from "@nestjs/common";
-function _ts_decorate15(decorators, target, key, desc) {
+import { Body as Body4, Controller as Controller11, Delete as Delete3, Get as Get10, Inject as Inject16, Param as Param5, Patch as Patch2, Post as Post5, Req as Req10 } 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);
@@ -3136,19 +3774,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_metadata15(metadataKey, metadataValue) {
+__name(_ts_decorate17, "_ts_decorate");
+function _ts_metadata16(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_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 ThreadsController = class {
   static {
     __name(this, "ThreadsController");
@@ -3194,6 +3832,9 @@ var ThreadsController = class {
       } : {},
       ..."model" in body ? {
         model: body.model ?? null
+      } : {},
+      ..."persona" in body ? {
+        persona: body.persona ?? null
       } : {}
     });
     return {
@@ -3215,92 +3856,92 @@ var ThreadsController = class {
     };
   }
 };
-_ts_decorate15([
+_ts_decorate17([
   Get10(),
-  _ts_param14(0, Req10()),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+  _ts_param16(0, Req10()),
+  _ts_metadata16("design:type", Function),
+  _ts_metadata16("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request
   ]),
-  _ts_metadata15("design:returntype", Promise)
+  _ts_metadata16("design:returntype", Promise)
 ], ThreadsController.prototype, "list", null);
-_ts_decorate15([
+_ts_decorate17([
   Get10(":id"),
-  _ts_param14(0, Req10()),
-  _ts_param14(1, Param5("id")),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+  _ts_param16(0, Req10()),
+  _ts_param16(1, Param5("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)
 ], ThreadsController.prototype, "detail", null);
-_ts_decorate15([
+_ts_decorate17([
   Delete3(":id"),
-  _ts_param14(0, Req10()),
-  _ts_param14(1, Param5("id")),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+  _ts_param16(0, Req10()),
+  _ts_param16(1, Param5("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)
 ], ThreadsController.prototype, "remove", null);
-_ts_decorate15([
+_ts_decorate17([
   Post5(":id/fork-from/:messageId"),
-  _ts_param14(0, Req10()),
-  _ts_param14(1, Param5("id")),
-  _ts_param14(2, Param5("messageId")),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+  _ts_param16(0, Req10()),
+  _ts_param16(1, Param5("id")),
+  _ts_param16(2, Param5("messageId")),
+  _ts_metadata16("design:type", Function),
+  _ts_metadata16("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     String
   ]),
-  _ts_metadata15("design:returntype", Promise)
+  _ts_metadata16("design:returntype", Promise)
 ], ThreadsController.prototype, "fork", null);
-_ts_decorate15([
+_ts_decorate17([
   Patch2(":id"),
-  _ts_param14(0, Req10()),
-  _ts_param14(1, Param5("id")),
-  _ts_param14(2, Body4()),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+  _ts_param16(0, Req10()),
+  _ts_param16(1, Param5("id")),
+  _ts_param16(2, Body4()),
+  _ts_metadata16("design:type", Function),
+  _ts_metadata16("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     typeof UpdateThreadBody === "undefined" ? Object : UpdateThreadBody
   ]),
-  _ts_metadata15("design:returntype", Promise)
+  _ts_metadata16("design:returntype", Promise)
 ], ThreadsController.prototype, "update", null);
-_ts_decorate15([
+_ts_decorate17([
   Post5(":id/promote"),
-  _ts_param14(0, Req10()),
-  _ts_param14(1, Param5("id")),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+  _ts_param16(0, Req10()),
+  _ts_param16(1, Param5("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)
 ], ThreadsController.prototype, "promote", null);
-_ts_decorate15([
+_ts_decorate17([
   Delete3(":id/from/:messageId"),
-  _ts_param14(0, Req10()),
-  _ts_param14(1, Param5("id")),
-  _ts_param14(2, Param5("messageId")),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+  _ts_param16(0, Req10()),
+  _ts_param16(1, Param5("id")),
+  _ts_param16(2, Param5("messageId")),
+  _ts_metadata16("design:type", Function),
+  _ts_metadata16("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     String,
     String
   ]),
-  _ts_metadata15("design:returntype", Promise)
+  _ts_metadata16("design:returntype", Promise)
 ], ThreadsController.prototype, "truncateFrom", null);
-ThreadsController = _ts_decorate15([
+ThreadsController = _ts_decorate17([
   Controller11("threads"),
-  _ts_param14(1, Inject14(AGENT_ACTOR_RESOLVER10)),
-  _ts_metadata15("design:type", Function),
-  _ts_metadata15("design:paramtypes", [
+  _ts_param16(1, Inject16(AGENT_ACTOR_RESOLVER10)),
+  _ts_metadata16("design:type", Function),
+  _ts_metadata16("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
@@ -3308,8 +3949,8 @@ ThreadsController = _ts_decorate15([
 
 // 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 Inject15, Post as Post6, Req as Req11 } from "@nestjs/common";
-function _ts_decorate16(decorators, target, key, desc) {
+import { BadRequestException as BadRequestException6, Body as Body5, Controller as Controller12, Inject as Inject17, Post as Post6, Req as Req11 } 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);
@@ -3322,19 +3963,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_metadata16(metadataKey, metadataValue) {
+__name(_ts_decorate18, "_ts_decorate");
+function _ts_metadata17(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_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 MAX_ANSWERED_QUESTIONS = 100;
 var MAX_VALUES_PER_QUESTION = 100;
 var MAX_ANSWER_VALUE_LENGTH = 4096;
@@ -3343,7 +3984,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;
 }
@@ -3353,10 +3994,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;
 }
@@ -3366,7 +4007,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;
 }
@@ -3376,7 +4017,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;
 }
@@ -3386,26 +4027,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;
@@ -3467,64 +4108,64 @@ var ToolCallController = class {
     };
   }
 };
-_ts_decorate16([
+_ts_decorate18([
   Post6("approve"),
-  _ts_param15(0, Req11()),
-  _ts_param15(1, Body5()),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+  _ts_param17(0, Req11()),
+  _ts_param17(1, Body5()),
+  _ts_metadata17("design:type", Function),
+  _ts_metadata17("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof ApproveBody === "undefined" ? Object : ApproveBody
   ]),
-  _ts_metadata16("design:returntype", Promise)
+  _ts_metadata17("design:returntype", Promise)
 ], ToolCallController.prototype, "approve", null);
-_ts_decorate16([
+_ts_decorate18([
   Post6("reject"),
-  _ts_param15(0, Req11()),
-  _ts_param15(1, Body5()),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+  _ts_param17(0, Req11()),
+  _ts_param17(1, Body5()),
+  _ts_metadata17("design:type", Function),
+  _ts_metadata17("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof RejectBody === "undefined" ? Object : RejectBody
   ]),
-  _ts_metadata16("design:returntype", Promise)
+  _ts_metadata17("design:returntype", Promise)
 ], ToolCallController.prototype, "reject", null);
-_ts_decorate16([
+_ts_decorate18([
   Post6("answer"),
-  _ts_param15(0, Req11()),
-  _ts_param15(1, Body5()),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+  _ts_param17(0, Req11()),
+  _ts_param17(1, Body5()),
+  _ts_metadata17("design:type", Function),
+  _ts_metadata17("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     typeof AnswerBody === "undefined" ? Object : AnswerBody
   ]),
-  _ts_metadata16("design:returntype", Promise)
+  _ts_metadata17("design:returntype", Promise)
 ], ToolCallController.prototype, "answer", null);
-_ts_decorate16([
+_ts_decorate18([
   Post6("skip"),
-  _ts_param15(0, Req11()),
-  _ts_param15(1, Body5()),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+  _ts_param17(0, Req11()),
+  _ts_param17(1, Body5()),
+  _ts_metadata17("design:type", Function),
+  _ts_metadata17("design:paramtypes", [
     typeof Request === "undefined" ? Object : Request,
     Object
   ]),
-  _ts_metadata16("design:returntype", Promise)
+  _ts_metadata17("design:returntype", Promise)
 ], ToolCallController.prototype, "skip", null);
-ToolCallController = _ts_decorate16([
+ToolCallController = _ts_decorate18([
   Controller12("tool-call"),
-  _ts_param15(1, Inject15(AGENT_ACTOR_RESOLVER11)),
-  _ts_metadata16("design:type", Function),
-  _ts_metadata16("design:paramtypes", [
+  _ts_param17(1, Inject17(AGENT_ACTOR_RESOLVER11)),
+  _ts_metadata17("design:type", Function),
+  _ts_metadata17("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_FACTORY3, AGENT_REGISTRY as AGENT_REGISTRY3, ALL_AGENTS, AgentRegistry as AgentRegistry4 } from "@dudousxd/nestjs-agent-core";
-import { Controller as Controller13, Get as Get11, Inject as Inject16, NotFoundException as NotFoundException3, Query as Query5, Req as Req12 } from "@nestjs/common";
-function _ts_decorate17(decorators, target, key, desc) {
+import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER12, AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY4, AGENT_REGISTRY as AGENT_REGISTRY3, ALL_AGENTS, AgentRegistry as AgentRegistry4 } from "@dudousxd/nestjs-agent-core";
+import { Controller as Controller13, Get as Get11, Inject as Inject18, NotFoundException as NotFoundException4, Query as Query5, Req as Req12 } 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);
@@ -3537,19 +4178,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_metadata17(metadataKey, metadataValue) {
+__name(_ts_decorate19, "_ts_decorate");
+function _ts_metadata18(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_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 ToolsController = class {
   static {
     __name(this, "ToolsController");
@@ -3564,7 +4205,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 ? [
@@ -3593,24 +4234,24 @@ var ToolsController = class {
     ];
   }
 };
-_ts_decorate17([
+_ts_decorate19([
   Get11(),
-  _ts_param16(0, Req12()),
-  _ts_param16(1, Query5("agent")),
-  _ts_metadata17("design:type", Function),
-  _ts_metadata17("design:paramtypes", [
+  _ts_param18(0, Req12()),
+  _ts_param18(1, Query5("agent")),
+  _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)
 ], ToolsController.prototype, "list", null);
-ToolsController = _ts_decorate17([
+ToolsController = _ts_decorate19([
   Controller13("tools"),
-  _ts_param16(0, Inject16(AGENT_ACTOR_RESOLVER12)),
-  _ts_param16(1, Inject16(AGENT_DEPS_FACTORY3)),
-  _ts_param16(2, Inject16(AGENT_REGISTRY3)),
-  _ts_metadata17("design:type", Function),
-  _ts_metadata17("design:paramtypes", [
+  _ts_param18(0, Inject18(AGENT_ACTOR_RESOLVER12)),
+  _ts_param18(1, Inject18(AGENT_DEPS_FACTORY4)),
+  _ts_param18(2, Inject18(AGENT_REGISTRY3)),
+  _ts_metadata18("design:type", Function),
+  _ts_metadata18("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
     typeof AgentRegistry4 === "undefined" ? Object : AgentRegistry4
@@ -3619,7 +4260,7 @@ ToolsController = _ts_decorate17([
 
 // 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 Inject17, Injectable as Injectable5, Logger as Logger2 } from "@nestjs/common";
+import { Inject as Inject19, Injectable as Injectable6, Logger as Logger2 } from "@nestjs/common";
 import { DiscoveryService, MetadataScanner } from "@nestjs/core";
 
 // src/decorator/agent.decorator.ts
@@ -3654,7 +4295,7 @@ function SystemPromptContributor() {
 __name(SystemPromptContributor, "SystemPromptContributor");
 
 // src/discovery/agent-discovery.service.ts
-function _ts_decorate18(decorators, target, key, desc) {
+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);
@@ -3667,19 +4308,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_metadata18(metadataKey, metadataValue) {
+__name(_ts_decorate20, "_ts_decorate");
+function _ts_metadata19(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_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 AgentDiscoveryService = class _AgentDiscoveryService {
   static {
     __name(this, "AgentDiscoveryService");
@@ -3707,6 +4348,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) {
@@ -3750,10 +4392,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.
@@ -3806,12 +4486,12 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
     return (ctx) => candidate.call(instance, ctx);
   }
 };
-AgentDiscoveryService = _ts_decorate18([
-  Injectable5(),
-  _ts_param17(2, Inject17(AGENT_REGISTRY4)),
-  _ts_param17(3, Inject17(AGENT_PROMPT_CONTRIBUTORS2)),
-  _ts_metadata18("design:type", Function),
-  _ts_metadata18("design:paramtypes", [
+AgentDiscoveryService = _ts_decorate20([
+  Injectable6(),
+  _ts_param19(2, Inject19(AGENT_REGISTRY4)),
+  _ts_param19(3, Inject19(AGENT_PROMPT_CONTRIBUTORS2)),
+  _ts_metadata19("design:type", Function),
+  _ts_metadata19("design:paramtypes", [
     typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
     typeof MetadataScanner === "undefined" ? Object : MetadataScanner,
     typeof AgentRegistry5 === "undefined" ? Object : AgentRegistry5,
@@ -3820,8 +4500,8 @@ AgentDiscoveryService = _ts_decorate18([
 ], 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 Inject18, Injectable as Injectable6, Logger as Logger3 } 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 Inject20, Injectable as Injectable7, Logger as Logger3 } from "@nestjs/common";
 import { DiscoveryService as DiscoveryService2 } from "@nestjs/core";
 import { z } from "zod";
 
@@ -3853,46 +4533,8 @@ function readAiToolMetadata(target) {
 }
 __name(readAiToolMetadata, "readAiToolMetadata");
 
-// 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 provideAgentTool(factoryOrTool, inject) {
-  const provide = /* @__PURE__ */ Symbol("nestjs-agent:functional-tool-instance");
-  if (typeof factoryOrTool === "function") {
-    return {
-      provide,
-      useFactory: /* @__PURE__ */ __name((...deps) => brand(factoryOrTool(...deps)), "useFactory"),
-      inject: inject ?? []
-    };
-  }
-  return {
-    provide,
-    useValue: brand(factoryOrTool)
-  };
-}
-__name(provideAgentTool, "provideAgentTool");
-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/discovery/ai-tool-discovery.service.ts
-function _ts_decorate19(decorators, target, key, desc) {
+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);
@@ -3905,19 +4547,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_metadata19(metadataKey, metadataValue) {
+__name(_ts_decorate21, "_ts_decorate");
+function _ts_metadata20(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_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 AiToolDiscoveryService = class _AiToolDiscoveryService {
   static {
     __name(this, "AiToolDiscoveryService");
@@ -3985,9 +4627,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).
@@ -4061,13 +4709,13 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
     return true;
   }
 };
-AiToolDiscoveryService = _ts_decorate19([
-  Injectable6(),
-  _ts_param18(1, Inject18(AGENT_TOOL_REGISTRY2)),
-  _ts_param18(2, Inject18(AGENT_REGISTRY5)),
-  _ts_param18(3, Inject18(AGENT_OPTIONS6)),
-  _ts_metadata19("design:type", Function),
-  _ts_metadata19("design:paramtypes", [
+AiToolDiscoveryService = _ts_decorate21([
+  Injectable7(),
+  _ts_param20(1, Inject20(AGENT_TOOL_REGISTRY2)),
+  _ts_param20(2, Inject20(AGENT_REGISTRY5)),
+  _ts_param20(3, Inject20(AGENT_OPTIONS7)),
+  _ts_metadata20("design:type", Function),
+  _ts_metadata20("design:paramtypes", [
     typeof DiscoveryService2 === "undefined" ? Object : DiscoveryService2,
     typeof ToolRegistry === "undefined" ? Object : ToolRegistry,
     typeof AgentRegistry === "undefined" ? Object : AgentRegistry,
@@ -4077,7 +4725,7 @@ AiToolDiscoveryService = _ts_decorate19([
 
 // src/discovery/skill-discovery.service.ts
 import { AGENT_SKILL_SOURCES } from "@dudousxd/nestjs-agent-core";
-import { Inject as Inject19, Injectable as Injectable7, Logger as Logger4 } from "@nestjs/common";
+import { Inject as Inject21, Injectable as Injectable8, Logger as Logger4 } from "@nestjs/common";
 import { DiscoveryService as DiscoveryService3 } from "@nestjs/core";
 
 // src/decorator/skill.decorator.ts
@@ -4100,7 +4748,7 @@ function skillScope(options) {
 __name(skillScope, "skillScope");
 
 // src/discovery/skill-discovery.service.ts
-function _ts_decorate20(decorators, target, key, desc) {
+function _ts_decorate22(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -4113,19 +4761,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_metadata20(metadataKey, metadataValue) {
+__name(_ts_decorate22, "_ts_decorate");
+function _ts_metadata21(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_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 SkillDiscoveryService = class _SkillDiscoveryService {
   static {
     __name(this, "SkillDiscoveryService");
@@ -4169,11 +4817,11 @@ var SkillDiscoveryService = class _SkillDiscoveryService {
     return flat === void 0 ? void 0 : () => flat;
   }
 };
-SkillDiscoveryService = _ts_decorate20([
-  Injectable7(),
-  _ts_param19(1, Inject19(AGENT_SKILL_SOURCES)),
-  _ts_metadata20("design:type", Function),
-  _ts_metadata20("design:paramtypes", [
+SkillDiscoveryService = _ts_decorate22([
+  Injectable8(),
+  _ts_param21(1, Inject21(AGENT_SKILL_SOURCES)),
+  _ts_metadata21("design:type", Function),
+  _ts_metadata21("design:paramtypes", [
     typeof DiscoveryService3 === "undefined" ? Object : DiscoveryService3,
     Array
   ])
@@ -4309,13 +4957,248 @@ var LedgerQuotaProvider = class {
   }
 };
 
+// src/proposals/action-proposal-worker.service.ts
+import { randomUUID } from "crypto";
+import { AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY5, AGENT_OPTIONS as AGENT_OPTIONS8, AGENT_STORE as AGENT_STORE5, ActionProposalExecutor, ActionProposalWorker, assertIndependentActionCapabilities as assertIndependentActionCapabilities2 } from "@dudousxd/nestjs-agent-core";
+import { Inject as Inject22, Injectable as Injectable9, Logger as Logger5 } 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);
+  } 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_decorate23, "_ts_decorate");
+function _ts_metadata22(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
+}
+__name(_ts_metadata22, "_ts_metadata");
+function _ts_param22(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param22, "_ts_param");
+var ActionProposalWorkerService = class _ActionProposalWorkerService {
+  static {
+    __name(this, "ActionProposalWorkerService");
+  }
+  store;
+  options;
+  deps;
+  worker;
+  logger = new Logger5(_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: randomUUID(),
+      ...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_decorate23([
+  Injectable9(),
+  _ts_param22(0, Inject22(AGENT_STORE5)),
+  _ts_param22(1, Inject22(AGENT_OPTIONS8)),
+  _ts_param22(2, Inject22(AGENT_DEPS_FACTORY5)),
+  _ts_metadata22("design:type", Function),
+  _ts_metadata22("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 Inject23, Param as Param6, Post as Post7, Query as Query6, Req as Req13, Res as Res2 } from "@nestjs/common";
+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);
+  } 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_decorate24, "_ts_decorate");
+function _ts_metadata23(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
+}
+__name(_ts_metadata23, "_ts_metadata");
+function _ts_param23(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param23, "_ts_param");
+function bodyFields(body, field2) {
+  if (body === void 0) return {};
+  if (typeof body !== "object" || body === null || Array.isArray(body) || Object.keys(body).some((key) => key !== field2)) throw new BadRequestException7(`Only ${field2} is accepted`);
+  const value = body;
+  if (value[field2] !== void 0 && (field2 === "remember" && typeof value[field2] !== "boolean" || field2 === "reason" && typeof value[field2] !== "string")) throw new BadRequestException7(`Invalid ${field2}`);
+  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_decorate24([
+  Get12(),
+  _ts_param23(0, Param6("threadId")),
+  _ts_param23(1, Req13()),
+  _ts_param23(2, Query6("after")),
+  _ts_param23(3, Res2({
+    passthrough: true
+  })),
+  _ts_metadata23("design:type", Function),
+  _ts_metadata23("design:paramtypes", [
+    String,
+    typeof Request === "undefined" ? Object : Request,
+    Object,
+    typeof Response === "undefined" ? Object : Response
+  ]),
+  _ts_metadata23("design:returntype", Promise)
+], ActionProposalController.prototype, "list", null);
+_ts_decorate24([
+  Post7(":proposalId/approve"),
+  _ts_param23(0, Param6("threadId")),
+  _ts_param23(1, Param6("proposalId")),
+  _ts_param23(2, Req13()),
+  _ts_param23(3, Body6()),
+  _ts_metadata23("design:type", Function),
+  _ts_metadata23("design:paramtypes", [
+    String,
+    String,
+    typeof Request === "undefined" ? Object : Request,
+    Object
+  ]),
+  _ts_metadata23("design:returntype", Promise)
+], ActionProposalController.prototype, "approve", null);
+_ts_decorate24([
+  Post7(":proposalId/reject"),
+  _ts_param23(0, Param6("threadId")),
+  _ts_param23(1, Param6("proposalId")),
+  _ts_param23(2, Req13()),
+  _ts_param23(3, Body6()),
+  _ts_metadata23("design:type", Function),
+  _ts_metadata23("design:paramtypes", [
+    String,
+    String,
+    typeof Request === "undefined" ? Object : Request,
+    Object
+  ]),
+  _ts_metadata23("design:returntype", Promise)
+], ActionProposalController.prototype, "reject", null);
+ActionProposalController = _ts_decorate24([
+  Controller14("threads/:threadId/action-proposals"),
+  _ts_param23(1, Inject23(AGENT_ACTOR_RESOLVER13)),
+  _ts_metadata23("design:type", Function),
+  _ts_metadata23("design:paramtypes", [
+    typeof ActionProposalService === "undefined" ? Object : ActionProposalService,
+    typeof ActorResolver === "undefined" ? Object : ActorResolver
+  ])
+], ActionProposalController);
+
 // src/queue/chat-queue.token.ts
 var AGENT_CHAT_QUEUE = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:chat-queue");
 
 // src/runner/inline-agent-runner.ts
-import { AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY4, AGENT_STORE as AGENT_STORE4, RUN_ENDED_BEFORE_TOOL_CALL, RunCancelledError, agentFailureCode, encodeStreamEvent as encodeStreamEvent2, publishAgentRunFailed, releaseThreadRun, runAgentLoop, settleAll, settleUnsettledDelegation, streamFailure as streamFailure2 } from "@dudousxd/nestjs-agent-core";
-import { Inject as Inject20, Injectable as Injectable8, Logger as Logger5, Optional as Optional8 } from "@nestjs/common";
-function _ts_decorate21(decorators, target, key, desc) {
+import { AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY6, AGENT_STORE as AGENT_STORE6, RUN_ENDED_BEFORE_TOOL_CALL, RunCancelledError, agentFailureCode, encodeStreamEvent as encodeStreamEvent2, publishAgentRunFailed, releaseThreadRun, runAgentLoop, settleAll, settleUnsettledDelegation, streamFailure as streamFailure2 } from "@dudousxd/nestjs-agent-core";
+import { Inject as Inject24, Injectable as Injectable10, Logger as Logger6, Optional as Optional9 } from "@nestjs/common";
+function _ts_decorate25(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
     r = Reflect.decorate(decorators, target, key, desc);
@@ -4328,19 +5211,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_metadata21(metadataKey, metadataValue) {
+__name(_ts_decorate25, "_ts_decorate");
+function _ts_metadata24(metadataKey, metadataValue) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
     return Reflect.metadata(metadataKey, metadataValue);
   }
 }
-__name(_ts_metadata21, "_ts_metadata");
-function _ts_param20(paramIndex, decorator) {
+__name(_ts_metadata24, "_ts_metadata");
+function _ts_param24(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param20, "_ts_param");
+__name(_ts_param24, "_ts_param");
 var InlineAgentRunner = class _InlineAgentRunner {
   static {
     __name(this, "InlineAgentRunner");
@@ -4348,7 +5231,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
   factory;
   store;
   queue;
-  logger = new Logger5(_InlineAgentRunner.name);
+  logger = new Logger6(_InlineAgentRunner.name);
   pending = /* @__PURE__ */ new Map();
   /**
   * Runs someone has asked to stop. In-process, like `pending`, and for the same reason: this runner
@@ -4791,13 +5674,13 @@ var InlineAgentRunner = class _InlineAgentRunner {
     }
   }
 };
-InlineAgentRunner = _ts_decorate21([
-  Injectable8(),
-  _ts_param20(0, Inject20(AGENT_DEPS_FACTORY4)),
-  _ts_param20(1, Inject20(AGENT_STORE4)),
-  _ts_param20(2, Optional8()),
-  _ts_metadata21("design:type", Function),
-  _ts_metadata21("design:paramtypes", [
+InlineAgentRunner = _ts_decorate25([
+  Injectable10(),
+  _ts_param24(0, Inject24(AGENT_DEPS_FACTORY6)),
+  _ts_param24(1, Inject24(AGENT_STORE6)),
+  _ts_param24(2, Optional9()),
+  _ts_metadata24("design:type", Function),
+  _ts_metadata24("design:paramtypes", [
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
     typeof AgentStore === "undefined" ? Object : AgentStore,
     typeof ChatQueueService === "undefined" ? Object : ChatQueueService
@@ -4847,7 +5730,7 @@ function resolveSkillsConfig(options, declared) {
 __name(resolveSkillsConfig, "resolveSkillsConfig");
 
 // src/agent.module.ts
-function _ts_decorate22(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);
@@ -4860,13 +5743,13 @@ function _ts_decorate22(decorators, target, key, desc) {
   }
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate22, "_ts_decorate");
+__name(_ts_decorate26, "_ts_decorate");
 var DEFAULT_PATH = "agent";
-var logger = new Logger6("AgentModule");
+var logger = new Logger7("AgentModule");
 function externalStoreWrapper(modules) {
   for (const module of modules.values()) {
     if (module.metatype === AgentModule) continue;
-    const wrapper = module.providers.get(AGENT_STORE5);
+    const wrapper = module.providers.get(AGENT_STORE7);
     if (wrapper !== void 0) return wrapper;
   }
   return void 0;
@@ -4939,7 +5822,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
       ]
     },
@@ -4949,39 +5832,39 @@ function sharedProviders(durable) {
       provide: AGENT_MEMORY3,
       useFactory: /* @__PURE__ */ __name((options) => options.memory, "useFactory"),
       inject: [
-        AGENT_OPTIONS7
+        AGENT_OPTIONS9
       ]
     },
     {
       provide: AGENT_SINK3,
       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
       ]
     },
     {
@@ -4992,20 +5875,20 @@ function sharedProviders(durable) {
         warnAt: o.quota.warnAt
       } : {}), "useFactory"),
       inject: [
-        AGENT_OPTIONS7,
-        AGENT_STORE5
+        AGENT_OPTIONS9,
+        AGENT_STORE7
       ]
     },
     {
       provide: AGENT_MODEL_CATALOG3,
       useFactory: /* @__PURE__ */ __name((o) => resolveCatalog(o), "useFactory"),
       inject: [
-        AGENT_OPTIONS7
+        AGENT_OPTIONS9
       ]
     },
     AgentDepsFactory2,
     {
-      provide: AGENT_DEPS_FACTORY5,
+      provide: AGENT_DEPS_FACTORY7,
       useExisting: AgentDepsFactory2
     },
     // Populates the registry + contributors (onModuleInit) BEFORE AiToolDiscoveryService synthesizes
@@ -5022,6 +5905,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,
@@ -5031,10 +5916,10 @@ function sharedProviders(durable) {
     }
   ];
   providers.push({
-    provide: AGENT_STORE5,
+    provide: AGENT_STORE7,
     useFactory: /* @__PURE__ */ __name((o, modules) => resolveStore(o, modules), "useFactory"),
     inject: [
-      AGENT_OPTIONS7,
+      AGENT_OPTIONS9,
       ModulesContainer
     ]
   });
@@ -5065,22 +5950,24 @@ function sharedProviders(durable) {
 __name(sharedProviders, "sharedProviders");
 function exportsFor() {
   return [
-    AGENT_OPTIONS7,
+    AGENT_OPTIONS9,
     AGENT_TOOL_REGISTRY3,
     AGENT_REGISTRY6,
     AGENT_SINK3,
     AGENT_ROLES_POLICY2,
-    AGENT_ACTOR_RESOLVER13,
+    AGENT_ACTOR_RESOLVER14,
     AGENT_MODEL2,
-    AGENT_STORE5,
+    AGENT_STORE7,
     AGENT_MODEL_CATALOG3,
     AGENT_QUOTA_PROVIDER3,
     AGENT_PROMPT_CONTRIBUTORS3,
     AGENT_SKILLS3,
     AGENT_MEMORY3,
-    AGENT_DEPS_FACTORY5,
+    AGENT_DEPS_FACTORY7,
     AgentDepsFactory2,
     AgentService,
+    ActionProposalService,
+    ActionProposalWorkerService,
     ChatQueueService,
     AGENT_CHAT_QUEUE,
     InlineAgentRunner,
@@ -5089,6 +5976,7 @@ function exportsFor() {
 }
 __name(exportsFor, "exportsFor");
 var BASE_CONTROLLERS = [
+  ActionProposalController,
   ChatController,
   QueueController,
   ThreadsController,
@@ -5161,7 +6049,7 @@ var AgentModule = class _AgentModule {
       controllers: controllersForSurface(options.surface, options.adapters),
       providers: [
         {
-          provide: AGENT_OPTIONS7,
+          provide: AGENT_OPTIONS9,
           useValue: options
         },
         ...sharedProviders(options.durable ?? false),
@@ -5185,7 +6073,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
@@ -5207,16 +6095,16 @@ var AgentModule = class _AgentModule {
     };
   }
 };
-AgentModule = _ts_decorate22([
+AgentModule = _ts_decorate26([
   Global(),
-  Module({})
+  Module2({})
 ], AgentModule);
 
 // src/ag-ui/ag-ui.adapter.ts
-import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER14, AGENT_ATTACHMENT_STAGING as AGENT_ATTACHMENT_STAGING5, AGENT_OPTIONS as AGENT_OPTIONS8 } from "@dudousxd/nestjs-agent-core";
-import { AG_UI_CUSTOM, agUiEvents, agUiFramesFromNdjson, agUiSse, parseRunInput, planResume, readAnswersPayload, readApprovalPayload, readContext, readForwardedProps, readUserTurn } from "@dudousxd/nestjs-agent-core/ag-ui";
-import { BadRequestException as BadRequestException6, Body as Body6, Controller as Controller14, ForbiddenException as ForbiddenException3, HttpCode as HttpCode2, Inject as Inject21, Optional as Optional9, Post as Post7, Req as Req13, Res as Res2 } from "@nestjs/common";
-function _ts_decorate23(decorators, target, key, desc) {
+import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER15, AGENT_ATTACHMENT_STAGING as AGENT_ATTACHMENT_STAGING5, AGENT_OPTIONS as AGENT_OPTIONS10 } from "@dudousxd/nestjs-agent-core";
+import { AG_UI_CUSTOM, actionProposalDecisionEvents, agUiEvents, agUiFramesFromNdjson, agUiSse, parseRunInput, planResume, readAnswersPayload, readApprovalPayload, readContext, readForwardedProps, readUserTurn } from "@dudousxd/nestjs-agent-core/ag-ui";
+import { BadRequestException as BadRequestException8, Body as Body7, Controller as Controller15, ForbiddenException as ForbiddenException4, HttpCode as HttpCode2, Inject as Inject25, Optional as Optional10, Post as Post8, Req as Req14, Res as Res3 } 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);
@@ -5229,22 +6117,22 @@ 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_decorate27, "_ts_decorate");
+function _ts_metadata25(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_metadata25, "_ts_metadata");
+function _ts_param25(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param21, "_ts_param");
+__name(_ts_param25, "_ts_param");
 var AG_UI_VIA = "ag-ui";
 function invalid(code, message) {
-  return new BadRequestException6({
+  return new BadRequestException8({
     statusCode: 400,
     code,
     message
@@ -5323,7 +6211,27 @@ var AgUiRunHandler = class {
     warnings.push(...turn.dropped);
     const owner = await this.agent.threadOwner(input.threadId);
     if (owner !== null && owner !== actor.id) {
-      throw new ForbiddenException3("thread belongs to another actor");
+      throw new ForbiddenException4("thread belongs to another actor");
+    }
+    if (owner !== null && turn.media.length === 0) {
+      const decision = await this.agent.handleTextDecision(input.threadId, actor, turn.text);
+      if ("proposalDecision" in decision) {
+        res.status(200);
+        res.setHeader("Content-Type", "text/event-stream");
+        res.setHeader("Cache-Control", "no-cache, no-transform");
+        res.flushHeaders();
+        for (const event of [
+          ...warningEvents(warnings),
+          ...actionProposalDecisionEvents({
+            threadId: input.threadId,
+            runId: input.runId,
+            text: decision.text,
+            proposalDecision: decision.proposalDecision
+          })
+        ]) res.write(agUiSse(event));
+        res.end();
+        return;
+      }
     }
     const refs = await this.stage(actor, turn.media, warnings);
     if (turn.text.trim().length === 0 && refs.length === 0) {
@@ -5347,9 +6255,15 @@ var AgUiRunHandler = class {
       ...forwarded.agent !== void 0 ? {
         agentName: forwarded.agent
       } : {},
+      ...forwarded.persona !== void 0 ? {
+        personaId: forwarded.persona
+      } : {},
       ...forwarded.model !== void 0 ? {
         model: forwarded.model
       } : {},
+      ...forwarded.uiCapabilities !== void 0 ? {
+        uiCapabilities: forwarded.uiCapabilities
+      } : {},
       ...pageContext !== void 0 ? {
         pageContext
       } : {},
@@ -5494,29 +6408,29 @@ function agUiAdapter(options = {}) {
       return this.handle(req, res, body);
     }
   };
-  _ts_decorate23([
-    Post7(path),
+  _ts_decorate27([
+    Post8(path),
     HttpCode2(200),
-    _ts_param21(0, Req13()),
-    _ts_param21(1, Res2()),
-    _ts_param21(2, Body6()),
-    _ts_metadata22("design:type", Function),
-    _ts_metadata22("design:paramtypes", [
+    _ts_param25(0, Req14()),
+    _ts_param25(1, Res3()),
+    _ts_param25(2, Body7()),
+    _ts_metadata25("design:type", Function),
+    _ts_metadata25("design:paramtypes", [
       typeof Request === "undefined" ? Object : Request,
       typeof Response === "undefined" ? Object : Response,
       Object
     ]),
-    _ts_metadata22("design:returntype", typeof Promise === "undefined" ? Object : Promise)
+    _ts_metadata25("design:returntype", typeof Promise === "undefined" ? Object : Promise)
   ], AgUiController.prototype, "run", null);
-  AgUiController = _ts_decorate23([
-    Controller14(),
-    _ts_param21(0, Inject21(AgentService)),
-    _ts_param21(1, Inject21(AGENT_ACTOR_RESOLVER14)),
-    _ts_param21(2, Inject21(AGENT_OPTIONS8)),
-    _ts_param21(3, Optional9()),
-    _ts_param21(3, Inject21(AGENT_ATTACHMENT_STAGING5)),
-    _ts_metadata22("design:type", Function),
-    _ts_metadata22("design:paramtypes", [
+  AgUiController = _ts_decorate27([
+    Controller15(),
+    _ts_param25(0, Inject25(AgentService)),
+    _ts_param25(1, Inject25(AGENT_ACTOR_RESOLVER15)),
+    _ts_param25(2, Inject25(AGENT_OPTIONS10)),
+    _ts_param25(3, Optional10()),
+    _ts_param25(3, Inject25(AGENT_ATTACHMENT_STAGING5)),
+    _ts_metadata25("design:type", Function),
+    _ts_metadata25("design:paramtypes", [
       typeof AgentService === "undefined" ? Object : AgentService,
       typeof ActorResolver === "undefined" ? Object : ActorResolver,
       typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
@@ -5614,6 +6528,9 @@ export {
   AGENT_TOOL_BRAND,
   AI_TOOL_METADATA,
   ATTACHMENT_PAGE_SIZE,
+  ActionProposalController,
+  ActionProposalService,
+  ActionProposalWorkerService,
   AgUiRunHandler,
   Agent,
   AgentApprovalPortAdapter,
@@ -5661,6 +6578,7 @@ export {
   requestUserActorResolver,
   resolveSkillsConfig,
   skillScope,
+  threadPersona,
   toolNameFromClass,
   utcDay
 };