@dudousxd/nestjs-agent 1.21.0 → 1.23.0

package/dist/index.cjs

@@ -68,6 +68,7 @@ __export(index_exports, {
   attachmentLimits: () => attachmentLimits,
   declaredSkillProvider: () => declaredSkillProvider,
   defaultRequestUserMapper: () => defaultRequestUserMapper,
+  defineTool: () => defineTool,
   delegateToolName: () => delegateToolName,
   provideAgentTool: () => provideAgentTool,
   provideAgentTools: () => provideAgentTools,
@@ -84,14 +85,14 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/agent.module.ts
-var import_nestjs_agent_core31 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core33 = require("@dudousxd/nestjs-agent-core");
 var import_common27 = require("@nestjs/common");
 var import_core4 = require("@nestjs/core");
 
 // src/agent-deps.factory.ts
-var import_nestjs_agent_core = require("@dudousxd/nestjs-agent-core");
 var import_nestjs_agent_core2 = require("@dudousxd/nestjs-agent-core");
 var import_nestjs_agent_core3 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core4 = require("@dudousxd/nestjs-agent-core");
 var import_common2 = require("@nestjs/common");
 
 // src/genui/agent-genui.module.ts
@@ -99,6 +100,7 @@ var import_genui = require("@dudousxd/nestjs-agent-core/genui");
 var import_common = require("@nestjs/common");
 
 // src/functional-tool.ts
+var import_nestjs_agent_core = require("@dudousxd/nestjs-agent-core");
 var AGENT_TOOL_BRAND = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:functional-tool");
 function brand(tool) {
   return {
@@ -135,6 +137,7 @@ function provideAgentTools(factory, inject) {
   };
 }
 __name(provideAgentTools, "provideAgentTools");
+var defineTool = import_nestjs_agent_core.createFunctionalTool;
 
 // src/genui/agent-genui.module.ts
 function _ts_decorate(decorators, target, key, desc) {
@@ -317,7 +320,7 @@ var AgentDepsFactory2 = class {
     this.memory = memory;
     this.uiCatalog = uiCatalog;
     this.uiCatalogResolver = uiCatalogResolver;
-    if (options.actionApprovalMode === "independent") (0, import_nestjs_agent_core.assertIndependentActionCapabilities)(store, options.backgroundActorResolver);
+    if (options.actionApprovalMode === "independent") (0, import_nestjs_agent_core2.assertIndependentActionCapabilities)(store, options.backgroundActorResolver);
   }
   /** The turn's memory seam, shared with the read-back endpoint. Undefined → memory is not configured. */
   memoryConfig() {
@@ -343,7 +346,7 @@ var AgentDepsFactory2 = class {
       return void 0;
     }
     const delegated = (definition.delegatesTo ?? []).map((edge) => {
-      const { agent, detached } = (0, import_nestjs_agent_core2.normalizeDelegation)(edge);
+      const { agent, detached } = (0, import_nestjs_agent_core3.normalizeDelegation)(edge);
       return delegateToolName({
         target: agent,
         detached
@@ -367,7 +370,7 @@ var AgentDepsFactory2 = class {
         agentName: name
       };
     }
-    const alias = (0, import_nestjs_agent_core2.resolvePersonaAlias)(this.agents.list(), name);
+    const alias = (0, import_nestjs_agent_core3.resolvePersonaAlias)(this.agents.list(), name);
     return alias === void 0 ? {
       agentName: name
     } : {
@@ -377,7 +380,7 @@ var AgentDepsFactory2 = class {
   }
   /** `agentName`'s personas as a picker reads them. Empty when it declares none. */
   personaCatalog(agentName) {
-    return (this.agents.get(agentName)?.personas ?? []).map(import_nestjs_agent_core2.personaCatalogEntry);
+    return (this.agents.get(agentName)?.personas ?? []).map(import_nestjs_agent_core3.personaCatalogEntry);
   }
   /** The persona `agentName` runs under when nothing names one. Undefined → none. */
   defaultPersona(agentName) {
@@ -391,7 +394,7 @@ var AgentDepsFactory2 = class {
   resolvePersona(args) {
     const definition = this.agents.get(args.agentName);
     if (args.requested !== void 0) {
-      if ((0, import_nestjs_agent_core2.findPersona)(definition, args.requested) === void 0) {
+      if ((0, import_nestjs_agent_core3.findPersona)(definition, args.requested) === void 0) {
         throw new import_common2.BadRequestException({
           statusCode: 400,
           code: "persona_not_found",
@@ -401,7 +404,7 @@ var AgentDepsFactory2 = class {
       return args.requested;
     }
     const pinned = args.threadPersona ?? void 0;
-    if (pinned !== void 0 && (0, import_nestjs_agent_core2.findPersona)(definition, pinned) !== void 0) {
+    if (pinned !== void 0 && (0, import_nestjs_agent_core3.findPersona)(definition, pinned) !== void 0) {
       return pinned;
     }
     return definition?.defaultPersona;
@@ -421,8 +424,8 @@ var AgentDepsFactory2 = class {
   forAgent(agentName) {
     const name = agentName ?? this.defaultAgentName();
     if (agentName !== void 0 && !this.agents.has(agentName)) {
-      const alias = (0, import_nestjs_agent_core2.resolvePersonaAlias)(this.agents.list(), agentName);
-      const persona = alias === void 0 ? void 0 : (0, import_nestjs_agent_core2.findPersona)(this.agents.get(alias.agent), alias.persona);
+      const alias = (0, import_nestjs_agent_core3.resolvePersonaAlias)(this.agents.list(), agentName);
+      const persona = alias === void 0 ? void 0 : (0, import_nestjs_agent_core3.findPersona)(this.agents.get(alias.agent), alias.persona);
       if (alias !== void 0 && persona !== void 0) {
         return this.withPersona(this.forAgent(alias.agent), persona);
       }
@@ -556,7 +559,7 @@ var AgentDepsFactory2 = class {
         } : {}
       });
     }, "systemPrompt");
-    const toolAllowList = (0, import_nestjs_agent_core2.intersectAllowLists)(deps.toolAllowList, persona.allowedTools);
+    const toolAllowList = (0, import_nestjs_agent_core3.intersectAllowLists)(deps.toolAllowList, persona.allowedTools);
     return {
       ...deps,
       systemPrompt,
@@ -581,7 +584,7 @@ var AgentDepsFactory2 = class {
   }
   /** Build the built-in window policy from the declarative `{ maxMessages, maxTokens, summarize }`. */
   window(config) {
-    return (0, import_nestjs_agent_core2.windowHistory)({
+    return (0, import_nestjs_agent_core3.windowHistory)({
       ...config.maxMessages !== void 0 ? {
         maxMessages: config.maxMessages
       } : {},
@@ -591,7 +594,7 @@ var AgentDepsFactory2 = class {
       // The shared module model, not a per-agent one: an agent's `modelId` is an accounting label,
       // and only one provider is ever bound.
       ...config.summarize === true ? {
-        summarize: (0, import_nestjs_agent_core2.summarizeWithModel)(this.model)
+        summarize: (0, import_nestjs_agent_core3.summarizeWithModel)(this.model)
       } : {}
     });
   }
@@ -609,20 +612,20 @@ var AgentDepsFactory2 = class {
 };
 AgentDepsFactory2 = _ts_decorate2([
   (0, import_common2.Injectable)(),
-  _ts_param(0, (0, import_common2.Inject)(import_nestjs_agent_core3.AGENT_OPTIONS)),
-  _ts_param(1, (0, import_common2.Inject)(import_nestjs_agent_core2.AGENT_MODEL)),
-  _ts_param(2, (0, import_common2.Inject)(import_nestjs_agent_core2.AGENT_STORE)),
-  _ts_param(3, (0, import_common2.Inject)(import_nestjs_agent_core2.AGENT_SINK)),
-  _ts_param(4, (0, import_common2.Inject)(import_nestjs_agent_core2.AGENT_ROLES_POLICY)),
-  _ts_param(5, (0, import_common2.Inject)(import_nestjs_agent_core2.AGENT_TOOL_REGISTRY)),
-  _ts_param(6, (0, import_common2.Inject)(import_nestjs_agent_core2.AGENT_REGISTRY)),
-  _ts_param(7, (0, import_common2.Inject)(import_nestjs_agent_core2.AGENT_PROMPT_CONTRIBUTORS)),
+  _ts_param(0, (0, import_common2.Inject)(import_nestjs_agent_core4.AGENT_OPTIONS)),
+  _ts_param(1, (0, import_common2.Inject)(import_nestjs_agent_core3.AGENT_MODEL)),
+  _ts_param(2, (0, import_common2.Inject)(import_nestjs_agent_core3.AGENT_STORE)),
+  _ts_param(3, (0, import_common2.Inject)(import_nestjs_agent_core3.AGENT_SINK)),
+  _ts_param(4, (0, import_common2.Inject)(import_nestjs_agent_core3.AGENT_ROLES_POLICY)),
+  _ts_param(5, (0, import_common2.Inject)(import_nestjs_agent_core3.AGENT_TOOL_REGISTRY)),
+  _ts_param(6, (0, import_common2.Inject)(import_nestjs_agent_core3.AGENT_REGISTRY)),
+  _ts_param(7, (0, import_common2.Inject)(import_nestjs_agent_core3.AGENT_PROMPT_CONTRIBUTORS)),
   _ts_param(8, (0, import_common2.Optional)()),
-  _ts_param(8, (0, import_common2.Inject)(import_nestjs_agent_core2.AGENT_PRICING_STORE)),
+  _ts_param(8, (0, import_common2.Inject)(import_nestjs_agent_core3.AGENT_PRICING_STORE)),
   _ts_param(9, (0, import_common2.Optional)()),
-  _ts_param(9, (0, import_common2.Inject)(import_nestjs_agent_core2.AGENT_SKILLS)),
+  _ts_param(9, (0, import_common2.Inject)(import_nestjs_agent_core3.AGENT_SKILLS)),
   _ts_param(10, (0, import_common2.Optional)()),
-  _ts_param(10, (0, import_common2.Inject)(import_nestjs_agent_core2.AGENT_MEMORY)),
+  _ts_param(10, (0, import_common2.Inject)(import_nestjs_agent_core3.AGENT_MEMORY)),
   _ts_param(11, (0, import_common2.Optional)()),
   _ts_param(11, (0, import_common2.Inject)(GENUI_CATALOG)),
   _ts_param(12, (0, import_common2.Optional)()),
@@ -633,8 +636,8 @@ AgentDepsFactory2 = _ts_decorate2([
     typeof AgentStore === "undefined" ? Object : AgentStore,
     typeof TokenStreamSink === "undefined" ? Object : TokenStreamSink,
     typeof RolesPolicy === "undefined" ? Object : RolesPolicy,
-    typeof import_nestjs_agent_core2.ToolRegistry === "undefined" ? Object : import_nestjs_agent_core2.ToolRegistry,
-    typeof import_nestjs_agent_core2.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core2.AgentRegistry,
+    typeof import_nestjs_agent_core3.ToolRegistry === "undefined" ? Object : import_nestjs_agent_core3.ToolRegistry,
+    typeof import_nestjs_agent_core3.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core3.AgentRegistry,
     Array,
     Object,
     Object,
@@ -645,7 +648,7 @@ AgentDepsFactory2 = _ts_decorate2([
 ], AgentDepsFactory2);
 
 // src/agent.service.ts
-var import_nestjs_agent_core7 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core9 = require("@dudousxd/nestjs-agent-core");
 var import_common6 = require("@nestjs/common");
 
 // src/agent-deps.ts
@@ -671,7 +674,7 @@ function childSinkWriter(writer) {
 __name(childSinkWriter, "childSinkWriter");
 
 // src/proposals/action-proposal.service.ts
-var import_nestjs_agent_core4 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core5 = require("@dudousxd/nestjs-agent-core");
 var import_common3 = require("@nestjs/common");
 function _ts_decorate3(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -708,7 +711,19 @@ var ActionProposalService = class {
   constructor(store, options) {
     this.store = store;
     this.options = options;
+    const text = options.actionProposalText;
+    this.vocabulary = {
+      ...import_nestjs_agent_core5.DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY,
+      ...text?.vocabulary
+    };
+    this.replies = {
+      ...import_nestjs_agent_core5.DEFAULT_TEXT_ACTION_PROPOSAL_REPLIES,
+      ...text?.replies
+    };
   }
+  /** The words a text decision is made of, and what the agent answers — English unless configured. */
+  vocabulary;
+  replies;
   capability() {
     const store = this.store;
     if (typeof store.getThreadActionProposalScope !== "function" || typeof store.listActionProposals !== "function") throw new import_common3.NotImplementedException("Action proposals are unavailable");
@@ -721,7 +736,7 @@ var ActionProposalService = class {
     return scope;
   }
   mayDecide(actor, proposal) {
-    return (0, import_nestjs_agent_core4.mayDecideApproval)(this.options.approvalPolicy, actor, {
+    return (0, import_nestjs_agent_core5.mayDecideApproval)(this.options.approvalPolicy, actor, {
       toolCallId: proposal.originToolCallId,
       approver: proposal.approver,
       requesterRef: proposal.actorRef
@@ -737,7 +752,8 @@ var ActionProposalService = class {
     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,
+      // The public view: a row carries the worker's lease token and the tool's idempotency key.
+      items: visible.map(import_nestjs_agent_core5.toActionProposalView),
       ...rows.length === 1e3 && last ? {
         next: {
           createdAt: last.createdAt,
@@ -754,7 +770,7 @@ var ActionProposalService = class {
     const proposal = await this.capability().getActionProposal(scope, proposalId);
     if (!proposal) throw new import_common3.NotFoundException("Proposal not found");
     if (!await this.mayDecide(actor, proposal)) throw new import_common3.ForbiddenException("May not decide this proposal");
-    return this.capability().decideActionProposal(scope, proposalId, {
+    const result = await this.capability().decideActionProposal(scope, proposalId, {
       decision: command.decision,
       actorRef: actor.id,
       via: command.via ?? "web",
@@ -765,9 +781,10 @@ var ActionProposalService = class {
         reason: command.reason
       } : {}
     });
+    return (0, import_nestjs_agent_core5.toActionProposalMutationView)(result);
   }
   async handleTextDecision(threadId, actor, text) {
-    const command = (0, import_nestjs_agent_core4.parseTextActionProposalCommand)(text);
+    const command = (0, import_nestjs_agent_core5.parseTextActionProposalCommand)(text, this.vocabulary);
     if (command.status === "unmatched") return command;
     if (command.proposalId !== void 0) {
       const result2 = await this.decide(threadId, command.proposalId, actor, {
@@ -775,7 +792,7 @@ var ActionProposalService = class {
         remember: command.remember,
         via: "text"
       });
-      return this.textReceipt(threadId, result2);
+      return this.textReceipt(threadId, result2, command.decision);
     }
     const candidates = [];
     const scope = await this.scope(threadId, actor);
@@ -784,35 +801,43 @@ var ActionProposalService = class {
       limit: 1e3
     });
     for (const proposal of pending) if (await this.mayDecide(actor, proposal)) candidates.push(proposal);
-    const resolution = (0, import_nestjs_agent_core4.resolveTextActionProposalDecision)(text, candidates);
+    const resolution = (0, import_nestjs_agent_core5.resolveTextActionProposalDecision)(text, candidates, this.vocabulary);
     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 saturated = pending.length === 1e3 && !text.includes("#");
+    if (resolution.status === "ambiguous" || saturated) {
+      const proposalIds = candidates.map(({ id }) => id);
+      return {
+        threadId,
+        proposalDecision: {
+          status: "ambiguous",
+          proposalIds
+        },
+        text: saturated ? this.replies.tooMany : this.replies.ambiguous(proposalIds)
+      };
+    }
     const result = await this.decide(threadId, resolution.proposalId, actor, {
       decision: resolution.decision,
       remember: resolution.remember,
       via: "text"
     });
-    return this.textReceipt(threadId, result);
+    return this.textReceipt(threadId, result, resolution.decision);
   }
-  textReceipt(threadId, result) {
+  textReceipt(threadId, result, decision) {
     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.`
+      text: this.reply(result, decision)
     };
   }
+  /** The configured reply to a decision the store answered with `result`. */
+  reply(result, decision) {
+    return (0, import_nestjs_agent_core5.textActionProposalReply)(result, decision, this.replies);
+  }
 };
 ActionProposalService = _ts_decorate3([
   (0, import_common3.Injectable)(),
-  _ts_param2(0, (0, import_common3.Inject)(import_nestjs_agent_core4.AGENT_STORE)),
-  _ts_param2(1, (0, import_common3.Inject)(import_nestjs_agent_core4.AGENT_OPTIONS)),
+  _ts_param2(0, (0, import_common3.Inject)(import_nestjs_agent_core5.AGENT_STORE)),
+  _ts_param2(1, (0, import_common3.Inject)(import_nestjs_agent_core5.AGENT_OPTIONS)),
   _ts_metadata2("design:type", Function),
   _ts_metadata2("design:paramtypes", [
     typeof AgentStore === "undefined" ? Object : AgentStore,
@@ -821,9 +846,36 @@ ActionProposalService = _ts_decorate3([
 ], ActionProposalService);
 
 // src/queue/chat-queue.service.ts
-var import_nestjs_agent_core5 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core7 = require("@dudousxd/nestjs-agent-core");
 var import_common4 = require("@nestjs/common");
 
+// src/quota-exceeded.ts
+var import_nestjs_agent_core6 = require("@dudousxd/nestjs-agent-core");
+function publishQuotaBlocked(actor, report, blocked) {
+  const window = report.windows.find((candidate) => candidate.period === blocked.period);
+  const payload = {
+    actorId: actor.id,
+    period: blocked.period,
+    ...blocked.reason !== void 0 ? {
+      reason: blocked.reason
+    } : {},
+    ...window?.usedTokens !== void 0 ? {
+      usedTokens: window.usedTokens
+    } : {},
+    ...window?.limitTokens !== void 0 ? {
+      limitTokens: window.limitTokens
+    } : {},
+    ...window !== void 0 ? {
+      usedUsd: window.usedUsd
+    } : {},
+    ...window?.limitUsd !== void 0 ? {
+      limitUsd: window.limitUsd
+    } : {}
+  };
+  (0, import_nestjs_agent_core6.publishAgentQuotaExceeded)(payload);
+}
+__name(publishQuotaBlocked, "publishQuotaBlocked");
+
 // src/thread-persona.ts
 async function threadPersona(store, threadId) {
   const projecting = store;
@@ -888,11 +940,11 @@ var ChatQueueService = class _ChatQueueService {
   }
   /** Whether the bound store can hold a queue. Without one, a busy thread is not queued. */
   get supported() {
-    return (0, import_nestjs_agent_core5.isChatQueueStore)(this.store);
+    return (0, import_nestjs_agent_core7.isChatQueueStore)(this.store);
   }
   /** The bound store as a queue store, or a 501 naming what is missing. */
   queueStore() {
-    if (!(0, import_nestjs_agent_core5.isChatQueueStore)(this.store)) {
+    if (!(0, import_nestjs_agent_core7.isChatQueueStore)(this.store)) {
       throw new import_common4.NotImplementedException("Queueing messages requires an AgentStore that implements ChatQueueStore (enqueueMessage, listQueue, \u2026, claimActiveStream, releaseActiveStream); the bound store does not.");
     }
     return this.store;
@@ -904,7 +956,7 @@ var ChatQueueService = class _ChatQueueService {
       store.queuePause(threadId)
     ]);
     return {
-      items: items.map(import_nestjs_agent_core5.queuedMessageView),
+      items: items.map(import_nestjs_agent_core7.queuedMessageView),
       paused
     };
   }
@@ -955,7 +1007,7 @@ var ChatQueueService = class _ChatQueueService {
   * A no-op returning `{}` on a store without a queue.
   */
   async plan(args) {
-    if (!(0, import_nestjs_agent_core5.isChatQueueStore)(this.store)) {
+    if (!(0, import_nestjs_agent_core7.isChatQueueStore)(this.store)) {
       return {};
     }
     const store = this.store;
@@ -1055,7 +1107,7 @@ var ChatQueueService = class _ChatQueueService {
   * (its settle drains) or while the queue is paused. Answers the started run's id, if any.
   */
   async kick(threadId, runner) {
-    if (!(0, import_nestjs_agent_core5.isChatQueueStore)(this.store)) {
+    if (!(0, import_nestjs_agent_core7.isChatQueueStore)(this.store)) {
       return void 0;
     }
     const { live, stale } = await this.holder(threadId, runner);
@@ -1123,6 +1175,9 @@ var ChatQueueService = class _ChatQueueService {
       } : {},
       ...input.uiCapabilities !== void 0 ? {
         uiCapabilities: input.uiCapabilities
+      } : {},
+      ...input.hostContext !== void 0 ? {
+        hostContext: input.hostContext
       } : {}
     });
     await store.setQueuePause(threadId, {
@@ -1159,7 +1214,7 @@ var ChatQueueService = class _ChatQueueService {
   }
   async write(runId, frame) {
     const writer = await this.sink.open(runId);
-    await writer.write((0, import_nestjs_agent_core5.encodeStreamEvent)(frame));
+    await writer.write((0, import_nestjs_agent_core7.encodeStreamEvent)(frame));
   }
   /** Why `actor` may not start a turn now (the quota message), or `null`. */
   async quotaBlock(actor) {
@@ -1167,12 +1222,14 @@ var ChatQueueService = class _ChatQueueService {
       return null;
     }
     try {
-      const { blocked } = await this.quotaProvider.report({
+      const report = await this.quotaProvider.report({
         actor
       });
+      const { blocked } = report;
       if (blocked === void 0) {
         return null;
       }
+      publishQuotaBlocked(actor, report, blocked);
       return blocked.reason ?? `The ${blocked.period === "day" ? "daily" : "monthly"} quota is used up`;
     } catch {
       return null;
@@ -1206,6 +1263,9 @@ var ChatQueueService = class _ChatQueueService {
       ...message.uiCapabilities !== void 0 ? {
         uiCapabilities: message.uiCapabilities
       } : {},
+      ...message.hostContext !== void 0 ? {
+        hostContext: message.hostContext
+      } : {},
       ...message.model !== void 0 ? {
         model: message.model
       } : {}
@@ -1261,16 +1321,16 @@ var ChatQueueService = class _ChatQueueService {
 };
 ChatQueueService = _ts_decorate4([
   (0, import_common4.Injectable)(),
-  _ts_param3(0, (0, import_common4.Inject)(import_nestjs_agent_core5.AGENT_STORE)),
-  _ts_param3(1, (0, import_common4.Inject)(import_nestjs_agent_core5.AGENT_SINK)),
+  _ts_param3(0, (0, import_common4.Inject)(import_nestjs_agent_core7.AGENT_STORE)),
+  _ts_param3(1, (0, import_common4.Inject)(import_nestjs_agent_core7.AGENT_SINK)),
   _ts_param3(2, (0, import_common4.Optional)()),
-  _ts_param3(2, (0, import_common4.Inject)(import_nestjs_agent_core5.AGENT_QUOTA_PROVIDER)),
+  _ts_param3(2, (0, import_common4.Inject)(import_nestjs_agent_core7.AGENT_QUOTA_PROVIDER)),
   _ts_param3(3, (0, import_common4.Optional)()),
-  _ts_param3(3, (0, import_common4.Inject)(import_nestjs_agent_core5.AGENT_OPTIONS)),
+  _ts_param3(3, (0, import_common4.Inject)(import_nestjs_agent_core7.AGENT_OPTIONS)),
   _ts_param3(4, (0, import_common4.Optional)()),
-  _ts_param3(4, (0, import_common4.Inject)(import_nestjs_agent_core5.AGENT_ATTACHMENT_STAGING)),
+  _ts_param3(4, (0, import_common4.Inject)(import_nestjs_agent_core7.AGENT_ATTACHMENT_STAGING)),
   _ts_param3(5, (0, import_common4.Optional)()),
-  _ts_param3(5, (0, import_common4.Inject)(import_nestjs_agent_core5.AGENT_DEPS_FACTORY)),
+  _ts_param3(5, (0, import_common4.Inject)(import_nestjs_agent_core7.AGENT_DEPS_FACTORY)),
   _ts_metadata3("design:type", Function),
   _ts_metadata3("design:paramtypes", [
     typeof AgentStore === "undefined" ? Object : AgentStore,
@@ -1295,7 +1355,7 @@ function queueFrame(items, paused, started) {
   return {
     kind: "queue",
     queue: {
-      items: items.map(import_nestjs_agent_core5.queuedMessageView),
+      items: items.map(import_nestjs_agent_core7.queuedMessageView),
       paused
     },
     ...started !== void 0 ? {
@@ -1306,19 +1366,19 @@ function queueFrame(items, paused, started) {
 __name(queueFrame, "queueFrame");
 
 // src/run-not-active.exception.ts
-var import_nestjs_agent_core6 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core8 = require("@dudousxd/nestjs-agent-core");
 var import_common5 = require("@nestjs/common");
 var RunNotActiveException = class extends import_common5.ConflictException {
   static {
     __name(this, "RunNotActiveException");
   }
   runId;
-  code = import_nestjs_agent_core6.RUN_NOT_ACTIVE_CODE;
+  code = import_nestjs_agent_core8.RUN_NOT_ACTIVE_CODE;
   constructor(runId) {
     super({
       statusCode: 409,
-      code: import_nestjs_agent_core6.RUN_NOT_ACTIVE_CODE,
-      message: import_nestjs_agent_core6.RUN_NOT_ACTIVE_MESSAGE
+      code: import_nestjs_agent_core8.RUN_NOT_ACTIVE_CODE,
+      message: import_nestjs_agent_core8.RUN_NOT_ACTIVE_MESSAGE
     }), this.runId = runId;
   }
 };
@@ -1374,6 +1434,21 @@ var AgentService = class {
     this.queue = queue;
     this.proposals = proposals;
   }
+  /**
+  * Decide one independent proposal through the scoped proposal service — what the native
+  * `action-proposals/:id/approve|reject` routes call — and the reply to show for it. `404` when
+  * proposals are not on, `403`/`404` when this actor may not decide it.
+  */
+  async decideActionProposal(actor, threadId, proposalId, command) {
+    if (this.options?.actionApprovalMode !== "independent" || !this.proposals) {
+      throw new import_common6.NotFoundException("Proposal not found");
+    }
+    const result = await this.proposals.decide(threadId, proposalId, actor, command);
+    return {
+      proposalDecision: result,
+      text: this.proposals.reply(result, command.decision)
+    };
+  }
   async handleTextDecision(threadId, actor, text) {
     if (this.options?.actionApprovalMode !== "independent" || !this.proposals) return {
       status: "unmatched"
@@ -1421,10 +1496,12 @@ var AgentService = class {
     if (this.options?.quota === void 0 || this.quotaProvider === void 0) {
       return;
     }
-    const { blocked } = await this.quotaProvider.report({
+    const report = await this.quotaProvider.report({
       actor
     });
+    const { blocked } = report;
     if (blocked !== void 0) {
+      publishQuotaBlocked(actor, report, blocked);
       throw new import_common6.HttpException({
         statusCode: import_common6.HttpStatus.TOO_MANY_REQUESTS,
         code: "quota_exceeded",
@@ -1460,7 +1537,7 @@ var AgentService = class {
     if (this.models === void 0) {
       throw new import_common6.BadRequestException(`model "${model}" cannot be selected: no ModelCatalog is configured (AgentModule.forRoot({ models }))`);
     }
-    const entry = (0, import_nestjs_agent_core7.findCatalogModel)(await this.models.list({
+    const entry = (0, import_nestjs_agent_core9.findCatalogModel)(await this.models.list({
       actor,
       agent
     }), model);
@@ -1559,6 +1636,9 @@ var AgentService = class {
       }
       const created = await this.store.createThread({
         actor: params.actor,
+        ...agentName !== void 0 ? {
+          agentName
+        } : {},
         ...params.transient === true ? {
           transient: true
         } : {},
@@ -1571,7 +1651,7 @@ var AgentService = class {
       });
       threadId = created.id;
     } else {
-      await this.assertOwnsThread(params.actor, threadId);
+      if (params.authorized !== true) await this.assertOwnsThread(params.actor, threadId);
       if (params.personaId !== void 0) {
         await this.pinThreadPersona(threadId, params.personaId);
       }
@@ -1597,6 +1677,9 @@ var AgentService = class {
       ...params.uiCapabilities !== void 0 ? {
         uiCapabilities: params.uiCapabilities
       } : {},
+      ...params.hostContext !== void 0 ? {
+        hostContext: params.hostContext
+      } : {},
       ...model !== void 0 ? {
         model
       } : {}
@@ -1614,12 +1697,12 @@ var AgentService = class {
     const mode = params.mode ?? "auto";
     const { live, stale } = await queue.holder(threadId, this.runner);
     if (stale !== null) {
-      await (0, import_nestjs_agent_core7.settleDeadRun)(this.store, {
+      await (0, import_nestjs_agent_core9.settleDeadRun)(this.store, {
         runId: stale
       });
     }
     if (live === null && mode !== "queue") {
-      const runId = crypto.randomUUID();
+      const runId = this.runner.runIdFor?.(input) ?? crypto.randomUUID();
       if (await queue.queueStore().claimActiveStream(threadId, runId, stale !== null ? {
         replacing: stale
       } : {})) {
@@ -1687,6 +1770,9 @@ var AgentService = class {
       ...input.uiCapabilities !== void 0 ? {
         uiCapabilities: input.uiCapabilities
       } : {},
+      ...input.hostContext !== void 0 ? {
+        hostContext: input.hostContext
+      } : {},
       ...interrupting !== void 0 ? {
         interrupt: true,
         at: "head"
@@ -2003,7 +2089,7 @@ var AgentService = class {
     if (active) {
       return;
     }
-    await (0, import_nestjs_agent_core7.settleDeadRun)(this.store, {
+    await (0, import_nestjs_agent_core9.settleDeadRun)(this.store, {
       runId
     });
     throw new RunNotActiveException(runId);
@@ -2371,10 +2457,10 @@ var AgentService = class {
     if (this.store.toolCallInput === void 0) {
       return;
     }
-    const questions = (0, import_nestjs_agent_core7.readElicitationQuestions)(await this.store.toolCallInput(toolCallId2));
+    const questions = (0, import_nestjs_agent_core9.readElicitationQuestions)(await this.store.toolCallInput(toolCallId2));
     for (const question of questions) {
       const submitted = Object.hasOwn(answers2, question.id) ? answers2[question.id] : void 0;
-      const problem = (0, import_nestjs_agent_core7.validateElicitationAnswer)(question, submitted ?? question.defaults ?? []);
+      const problem = (0, import_nestjs_agent_core9.validateElicitationAnswer)(question, submitted ?? question.defaults ?? []);
       if (problem !== null) {
         throw new import_common6.BadRequestException(`answers["${question.id}"] ${problem}`);
       }
@@ -2388,15 +2474,15 @@ var AgentService = class {
   */
   async assertMayDecide(actor, toolCallId2) {
     const approval = await this.store.toolCallApproval?.(toolCallId2);
-    const approver = approval?.approver ?? import_nestjs_agent_core7.REQUESTER_APPROVER;
-    if (approver === import_nestjs_agent_core7.REQUESTER_APPROVER) {
+    const approver = approval?.approver ?? import_nestjs_agent_core9.REQUESTER_APPROVER;
+    if (approver === import_nestjs_agent_core9.REQUESTER_APPROVER) {
       return this.assertOwnsToolCall(actor, toolCallId2);
     }
     const requesterRef = await this.store.ownerOfToolCall(toolCallId2);
     if (requesterRef === null) {
       throw new import_common6.NotFoundException(`tool call ${toolCallId2} not found`);
     }
-    const allowed = await (0, import_nestjs_agent_core7.mayDecideApproval)(this.deps.forAgent().approvalPolicy, actor, {
+    const allowed = await (0, import_nestjs_agent_core9.mayDecideApproval)(this.deps.forAgent().approvalPolicy, actor, {
       toolCallId: toolCallId2,
       approver,
       requesterRef
@@ -2448,17 +2534,17 @@ var AgentService = class {
 };
 AgentService = _ts_decorate5([
   (0, import_common6.Injectable)(),
-  _ts_param4(0, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_RUNNER)),
-  _ts_param4(1, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_STORE)),
-  _ts_param4(2, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_DEPS_FACTORY)),
+  _ts_param4(0, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_RUNNER)),
+  _ts_param4(1, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_STORE)),
+  _ts_param4(2, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_DEPS_FACTORY)),
   _ts_param4(3, (0, import_common6.Optional)()),
-  _ts_param4(3, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_ATTACHMENT_STAGING)),
+  _ts_param4(3, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_ATTACHMENT_STAGING)),
   _ts_param4(4, (0, import_common6.Optional)()),
-  _ts_param4(4, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_MODEL_CATALOG)),
+  _ts_param4(4, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_MODEL_CATALOG)),
   _ts_param4(5, (0, import_common6.Optional)()),
-  _ts_param4(5, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_QUOTA_PROVIDER)),
+  _ts_param4(5, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_QUOTA_PROVIDER)),
   _ts_param4(6, (0, import_common6.Optional)()),
-  _ts_param4(6, (0, import_common6.Inject)(import_nestjs_agent_core7.AGENT_OPTIONS)),
+  _ts_param4(6, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_OPTIONS)),
   _ts_param4(7, (0, import_common6.Optional)()),
   _ts_param4(8, (0, import_common6.Optional)()),
   _ts_metadata4("design:type", Function),
@@ -2573,7 +2659,7 @@ AgentApprovalPortAdapter = _ts_decorate6([
 ], AgentApprovalPortAdapter);
 
 // src/controller/agents.controller.ts
-var import_nestjs_agent_core8 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core10 = require("@dudousxd/nestjs-agent-core");
 var import_common8 = require("@nestjs/common");
 function _ts_decorate7(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -2639,17 +2725,17 @@ _ts_decorate7([
 ], AgentsController.prototype, "list", null);
 AgentsController = _ts_decorate7([
   (0, import_common8.Controller)("agents"),
-  _ts_param6(0, (0, import_common8.Inject)(import_nestjs_agent_core8.AGENT_REGISTRY)),
-  _ts_param6(1, (0, import_common8.Inject)(import_nestjs_agent_core8.AGENT_DEPS_FACTORY)),
+  _ts_param6(0, (0, import_common8.Inject)(import_nestjs_agent_core10.AGENT_REGISTRY)),
+  _ts_param6(1, (0, import_common8.Inject)(import_nestjs_agent_core10.AGENT_DEPS_FACTORY)),
   _ts_metadata6("design:type", Function),
   _ts_metadata6("design:paramtypes", [
-    typeof import_nestjs_agent_core8.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core8.AgentRegistry,
+    typeof import_nestjs_agent_core10.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core10.AgentRegistry,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory
   ])
 ], AgentsController);
 
 // src/controller/attachments.controller.ts
-var import_nestjs_agent_core9 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core11 = require("@dudousxd/nestjs-agent-core");
 var import_common9 = require("@nestjs/common");
 var import_platform_express = require("@nestjs/platform-express");
 
@@ -2787,10 +2873,10 @@ _ts_decorate8([
 ], AttachmentsController.prototype, "upload", null);
 AttachmentsController = _ts_decorate8([
   (0, import_common9.Controller)("attachments"),
-  _ts_param7(0, (0, import_common9.Inject)(import_nestjs_agent_core9.AGENT_OPTIONS)),
-  _ts_param7(1, (0, import_common9.Inject)(import_nestjs_agent_core9.AGENT_ACTOR_RESOLVER)),
+  _ts_param7(0, (0, import_common9.Inject)(import_nestjs_agent_core11.AGENT_OPTIONS)),
+  _ts_param7(1, (0, import_common9.Inject)(import_nestjs_agent_core11.AGENT_ACTOR_RESOLVER)),
   _ts_param7(3, (0, import_common9.Optional)()),
-  _ts_param7(3, (0, import_common9.Inject)(import_nestjs_agent_core9.AGENT_ATTACHMENT_STAGING)),
+  _ts_param7(3, (0, import_common9.Inject)(import_nestjs_agent_core11.AGENT_ATTACHMENT_STAGING)),
   _ts_metadata7("design:type", Function),
   _ts_metadata7("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
@@ -2801,7 +2887,7 @@ AttachmentsController = _ts_decorate8([
 ], AttachmentsController);
 
 // src/controller/chat.controller.ts
-var import_nestjs_agent_core10 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core12 = require("@dudousxd/nestjs-agent-core");
 var import_genui2 = require("@dudousxd/nestjs-agent-core/genui");
 var import_common10 = require("@nestjs/common");
 function _ts_decorate9(decorators, target, key, desc) {
@@ -3011,10 +3097,10 @@ data: ${line}
       }
       res.write("event: done\ndata: {}\n\n");
     } catch (error) {
-      const payload = error instanceof import_nestjs_agent_core10.AgentStreamError ? {
+      const payload = error instanceof import_nestjs_agent_core12.AgentStreamError ? {
         code: error.code,
         message: error.message
-      } : (0, import_nestjs_agent_core10.streamFailure)(error);
+      } : (0, import_nestjs_agent_core12.streamFailure)(error);
       res.write(`event: error
 data: ${JSON.stringify(payload)}
 
@@ -3064,7 +3150,7 @@ _ts_decorate9([
 ], ChatController.prototype, "cancel", null);
 ChatController = _ts_decorate9([
   (0, import_common10.Controller)(),
-  _ts_param8(1, (0, import_common10.Inject)(import_nestjs_agent_core10.AGENT_ACTOR_RESOLVER)),
+  _ts_param8(1, (0, import_common10.Inject)(import_nestjs_agent_core12.AGENT_ACTOR_RESOLVER)),
   _ts_metadata8("design:type", Function),
   _ts_metadata8("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -3082,7 +3168,7 @@ function parseCursor(raw) {
 __name(parseCursor, "parseCursor");
 
 // src/controller/config.controller.ts
-var import_nestjs_agent_core11 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core13 = require("@dudousxd/nestjs-agent-core");
 var import_common11 = require("@nestjs/common");
 
 // src/resolver/anonymous-actor-resolver.ts
@@ -3240,12 +3326,12 @@ _ts_decorate10([
 ], ConfigController.prototype, "config", null);
 ConfigController = _ts_decorate10([
   (0, import_common11.Controller)("config"),
-  _ts_param9(0, (0, import_common11.Inject)(import_nestjs_agent_core11.AGENT_OPTIONS)),
-  _ts_param9(1, (0, import_common11.Inject)(import_nestjs_agent_core11.AGENT_ACTOR_RESOLVER)),
+  _ts_param9(0, (0, import_common11.Inject)(import_nestjs_agent_core13.AGENT_OPTIONS)),
+  _ts_param9(1, (0, import_common11.Inject)(import_nestjs_agent_core13.AGENT_ACTOR_RESOLVER)),
   _ts_param9(2, (0, import_common11.Optional)()),
-  _ts_param9(2, (0, import_common11.Inject)(import_nestjs_agent_core11.AGENT_ATTACHMENT_STAGING)),
+  _ts_param9(2, (0, import_common11.Inject)(import_nestjs_agent_core13.AGENT_ATTACHMENT_STAGING)),
   _ts_param9(3, (0, import_common11.Optional)()),
-  _ts_param9(3, (0, import_common11.Inject)(import_nestjs_agent_core11.AGENT_MODEL_CATALOG)),
+  _ts_param9(3, (0, import_common11.Inject)(import_nestjs_agent_core13.AGENT_MODEL_CATALOG)),
   _ts_metadata9("design:type", Function),
   _ts_metadata9("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
@@ -3256,7 +3342,7 @@ ConfigController = _ts_decorate10([
 ], ConfigController);
 
 // src/controller/memories.controller.ts
-var import_nestjs_agent_core12 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core14 = require("@dudousxd/nestjs-agent-core");
 var import_common12 = require("@nestjs/common");
 function _ts_decorate11(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -3325,7 +3411,7 @@ var MemoriesController = class {
     if (entry === void 0) {
       throw new import_common12.NotFoundException(`No memory with id "${id}".`);
     }
-    const verdict = (0, import_nestjs_agent_core12.memoryForgetVerdict)({
+    const verdict = (0, import_nestjs_agent_core14.memoryForgetVerdict)({
       record: entry,
       actor
     });
@@ -3344,7 +3430,7 @@ var MemoriesController = class {
   }
   async unbounded(threadId, actor) {
     const config = this.memory;
-    return await (0, import_nestjs_agent_core12.offerMemories)({
+    return await (0, import_nestjs_agent_core14.offerMemories)({
       config: {
         ...config,
         maxMemories: Number.POSITIVE_INFINITY
@@ -3380,9 +3466,9 @@ _ts_decorate11([
 ], MemoriesController.prototype, "forget", null);
 MemoriesController = _ts_decorate11([
   (0, import_common12.Controller)("memories"),
-  _ts_param10(0, (0, import_common12.Inject)(import_nestjs_agent_core12.AGENT_ACTOR_RESOLVER)),
+  _ts_param10(0, (0, import_common12.Inject)(import_nestjs_agent_core14.AGENT_ACTOR_RESOLVER)),
   _ts_param10(1, (0, import_common12.Optional)()),
-  _ts_param10(1, (0, import_common12.Inject)(import_nestjs_agent_core12.AGENT_MEMORY)),
+  _ts_param10(1, (0, import_common12.Inject)(import_nestjs_agent_core14.AGENT_MEMORY)),
   _ts_metadata10("design:type", Function),
   _ts_metadata10("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
@@ -3391,7 +3477,7 @@ MemoriesController = _ts_decorate11([
 ], MemoriesController);
 
 // src/controller/messages.controller.ts
-var import_nestjs_agent_core13 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core15 = require("@dudousxd/nestjs-agent-core");
 var import_common13 = require("@nestjs/common");
 function _ts_decorate12(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -3462,7 +3548,7 @@ _ts_decorate12([
 ], MessagesController.prototype, "feedback", null);
 MessagesController = _ts_decorate12([
   (0, import_common13.Controller)("messages"),
-  _ts_param11(1, (0, import_common13.Inject)(import_nestjs_agent_core13.AGENT_ACTOR_RESOLVER)),
+  _ts_param11(1, (0, import_common13.Inject)(import_nestjs_agent_core15.AGENT_ACTOR_RESOLVER)),
   _ts_metadata11("design:type", Function),
   _ts_metadata11("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -3471,7 +3557,7 @@ MessagesController = _ts_decorate12([
 ], MessagesController);
 
 // src/controller/models.controller.ts
-var import_nestjs_agent_core14 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core16 = require("@dudousxd/nestjs-agent-core");
 var import_common14 = require("@nestjs/common");
 function _ts_decorate13(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -3531,7 +3617,7 @@ _ts_decorate13([
 ], ModelsController.prototype, "list", null);
 ModelsController = _ts_decorate13([
   (0, import_common14.Controller)("models"),
-  _ts_param12(1, (0, import_common14.Inject)(import_nestjs_agent_core14.AGENT_ACTOR_RESOLVER)),
+  _ts_param12(1, (0, import_common14.Inject)(import_nestjs_agent_core16.AGENT_ACTOR_RESOLVER)),
   _ts_metadata12("design:type", Function),
   _ts_metadata12("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -3540,7 +3626,7 @@ ModelsController = _ts_decorate13([
 ], ModelsController);
 
 // src/controller/queue.controller.ts
-var import_nestjs_agent_core15 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core17 = require("@dudousxd/nestjs-agent-core");
 var import_common15 = require("@nestjs/common");
 function _ts_decorate14(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -3691,7 +3777,7 @@ _ts_decorate14([
 ], QueueController.prototype, "remove", null);
 QueueController = _ts_decorate14([
   (0, import_common15.Controller)(),
-  _ts_param13(1, (0, import_common15.Inject)(import_nestjs_agent_core15.AGENT_ACTOR_RESOLVER)),
+  _ts_param13(1, (0, import_common15.Inject)(import_nestjs_agent_core17.AGENT_ACTOR_RESOLVER)),
   _ts_metadata13("design:type", Function),
   _ts_metadata13("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -3700,7 +3786,7 @@ QueueController = _ts_decorate14([
 ], QueueController);
 
 // src/controller/quota.controller.ts
-var import_nestjs_agent_core16 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core18 = require("@dudousxd/nestjs-agent-core");
 var import_common16 = require("@nestjs/common");
 function _ts_decorate15(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -3758,7 +3844,7 @@ _ts_decorate15([
 ], QuotaController.prototype, "report", null);
 QuotaController = _ts_decorate15([
   (0, import_common16.Controller)("quota"),
-  _ts_param14(1, (0, import_common16.Inject)(import_nestjs_agent_core16.AGENT_ACTOR_RESOLVER)),
+  _ts_param14(1, (0, import_common16.Inject)(import_nestjs_agent_core18.AGENT_ACTOR_RESOLVER)),
   _ts_metadata14("design:type", Function),
   _ts_metadata14("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -3767,7 +3853,7 @@ QuotaController = _ts_decorate15([
 ], QuotaController);
 
 // src/controller/skills.controller.ts
-var import_nestjs_agent_core17 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core19 = require("@dudousxd/nestjs-agent-core");
 var import_common17 = require("@nestjs/common");
 function _ts_decorate16(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -3810,7 +3896,7 @@ var SkillsController = class {
       return [];
     }
     const actor = await this.actorResolver.resolve(req);
-    const offer = await (0, import_nestjs_agent_core17.offerSkills)(this.skills, {
+    const offer = await (0, import_nestjs_agent_core19.offerSkills)(this.skills, {
       actor,
       threadId: threadId ?? ""
     });
@@ -3830,9 +3916,9 @@ _ts_decorate16([
 ], SkillsController.prototype, "list", null);
 SkillsController = _ts_decorate16([
   (0, import_common17.Controller)("skills"),
-  _ts_param15(0, (0, import_common17.Inject)(import_nestjs_agent_core17.AGENT_ACTOR_RESOLVER)),
+  _ts_param15(0, (0, import_common17.Inject)(import_nestjs_agent_core19.AGENT_ACTOR_RESOLVER)),
   _ts_param15(1, (0, import_common17.Optional)()),
-  _ts_param15(1, (0, import_common17.Inject)(import_nestjs_agent_core17.AGENT_SKILLS)),
+  _ts_param15(1, (0, import_common17.Inject)(import_nestjs_agent_core19.AGENT_SKILLS)),
   _ts_metadata15("design:type", Function),
   _ts_metadata15("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
@@ -3841,7 +3927,7 @@ SkillsController = _ts_decorate16([
 ], SkillsController);
 
 // src/controller/threads.controller.ts
-var import_nestjs_agent_core18 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core20 = require("@dudousxd/nestjs-agent-core");
 var import_common18 = require("@nestjs/common");
 function _ts_decorate17(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -4021,7 +4107,7 @@ _ts_decorate17([
 ], ThreadsController.prototype, "truncateFrom", null);
 ThreadsController = _ts_decorate17([
   (0, import_common18.Controller)("threads"),
-  _ts_param16(1, (0, import_common18.Inject)(import_nestjs_agent_core18.AGENT_ACTOR_RESOLVER)),
+  _ts_param16(1, (0, import_common18.Inject)(import_nestjs_agent_core20.AGENT_ACTOR_RESOLVER)),
   _ts_metadata16("design:type", Function),
   _ts_metadata16("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -4030,7 +4116,7 @@ ThreadsController = _ts_decorate17([
 ], ThreadsController);
 
 // src/controller/tool-call.controller.ts
-var import_nestjs_agent_core19 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core21 = require("@dudousxd/nestjs-agent-core");
 var import_common19 = require("@nestjs/common");
 function _ts_decorate18(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -4236,7 +4322,7 @@ _ts_decorate18([
 ], ToolCallController.prototype, "skip", null);
 ToolCallController = _ts_decorate18([
   (0, import_common19.Controller)("tool-call"),
-  _ts_param17(1, (0, import_common19.Inject)(import_nestjs_agent_core19.AGENT_ACTOR_RESOLVER)),
+  _ts_param17(1, (0, import_common19.Inject)(import_nestjs_agent_core21.AGENT_ACTOR_RESOLVER)),
   _ts_metadata17("design:type", Function),
   _ts_metadata17("design:paramtypes", [
     typeof AgentService === "undefined" ? Object : AgentService,
@@ -4245,7 +4331,7 @@ ToolCallController = _ts_decorate18([
 ], ToolCallController);
 
 // src/controller/tools.controller.ts
-var import_nestjs_agent_core20 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core22 = require("@dudousxd/nestjs-agent-core");
 var import_common20 = require("@nestjs/common");
 function _ts_decorate19(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -4286,11 +4372,11 @@ var ToolsController = class {
     this.agents = agents;
   }
   async list(req, agent) {
-    if (agent !== void 0 && agent !== import_nestjs_agent_core20.ALL_AGENTS && this.agents.get(agent) === void 0) {
+    if (agent !== void 0 && agent !== import_nestjs_agent_core22.ALL_AGENTS && this.agents.get(agent) === void 0) {
       throw new import_common20.NotFoundException(`No agent named "${agent}"`);
     }
     const actor = await this.actorResolver.resolve(req);
-    const names = agent === import_nestjs_agent_core20.ALL_AGENTS ? [
+    const names = agent === import_nestjs_agent_core22.ALL_AGENTS ? [
       void 0,
       ...this.agents.list().map((definition) => definition.name)
     ] : [
@@ -4329,19 +4415,19 @@ _ts_decorate19([
 ], ToolsController.prototype, "list", null);
 ToolsController = _ts_decorate19([
   (0, import_common20.Controller)("tools"),
-  _ts_param18(0, (0, import_common20.Inject)(import_nestjs_agent_core20.AGENT_ACTOR_RESOLVER)),
-  _ts_param18(1, (0, import_common20.Inject)(import_nestjs_agent_core20.AGENT_DEPS_FACTORY)),
-  _ts_param18(2, (0, import_common20.Inject)(import_nestjs_agent_core20.AGENT_REGISTRY)),
+  _ts_param18(0, (0, import_common20.Inject)(import_nestjs_agent_core22.AGENT_ACTOR_RESOLVER)),
+  _ts_param18(1, (0, import_common20.Inject)(import_nestjs_agent_core22.AGENT_DEPS_FACTORY)),
+  _ts_param18(2, (0, import_common20.Inject)(import_nestjs_agent_core22.AGENT_REGISTRY)),
   _ts_metadata18("design:type", Function),
   _ts_metadata18("design:paramtypes", [
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
-    typeof import_nestjs_agent_core20.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core20.AgentRegistry
+    typeof import_nestjs_agent_core22.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core22.AgentRegistry
   ])
 ], ToolsController);
 
 // src/discovery/agent-discovery.service.ts
-var import_nestjs_agent_core21 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core23 = require("@dudousxd/nestjs-agent-core");
 var import_common21 = require("@nestjs/common");
 var import_core = require("@nestjs/core");
 
@@ -4570,19 +4656,19 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
 };
 AgentDiscoveryService = _ts_decorate20([
   (0, import_common21.Injectable)(),
-  _ts_param19(2, (0, import_common21.Inject)(import_nestjs_agent_core21.AGENT_REGISTRY)),
-  _ts_param19(3, (0, import_common21.Inject)(import_nestjs_agent_core21.AGENT_PROMPT_CONTRIBUTORS)),
+  _ts_param19(2, (0, import_common21.Inject)(import_nestjs_agent_core23.AGENT_REGISTRY)),
+  _ts_param19(3, (0, import_common21.Inject)(import_nestjs_agent_core23.AGENT_PROMPT_CONTRIBUTORS)),
   _ts_metadata19("design:type", Function),
   _ts_metadata19("design:paramtypes", [
     typeof import_core.DiscoveryService === "undefined" ? Object : import_core.DiscoveryService,
     typeof import_core.MetadataScanner === "undefined" ? Object : import_core.MetadataScanner,
-    typeof import_nestjs_agent_core21.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core21.AgentRegistry,
+    typeof import_nestjs_agent_core23.AgentRegistry === "undefined" ? Object : import_nestjs_agent_core23.AgentRegistry,
     Array
   ])
 ], AgentDiscoveryService);
 
 // src/discovery/ai-tool-discovery.service.ts
-var import_nestjs_agent_core22 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core24 = require("@dudousxd/nestjs-agent-core");
 var import_common22 = require("@nestjs/common");
 var import_core2 = require("@nestjs/core");
 var import_zod = require("zod");
@@ -4715,6 +4801,9 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
         } : {}
       }, {
         execute: /* @__PURE__ */ __name((input, ctx) => instance.execute(input, ctx), "execute"),
+        ...typeof handler.present === "function" ? {
+          present: /* @__PURE__ */ __name((output, ctx) => instance.present(output, ctx), "present")
+        } : {},
         ...typeof handler.preflight === "function" ? {
           preflight: /* @__PURE__ */ __name((input, ctx, options) => instance.preflight(input, ctx, options), "preflight")
         } : {},
@@ -4741,7 +4830,7 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
     let delegates = 0;
     for (const definition of this.agents.list()) {
       for (const edge of definition.delegatesTo ?? []) {
-        const { agent: target, detached } = (0, import_nestjs_agent_core22.normalizeDelegation)(edge);
+        const { agent: target, detached } = (0, import_nestjs_agent_core24.normalizeDelegation)(edge);
         const targetDefinition = this.agents.get(target);
         if (targetDefinition === void 0) {
           throw new Error(`Agent "${definition.name}" hands off to "${target}", which is not a registered @Agent. Declare it as an @Agent provider or fix the reference.`);
@@ -4793,9 +4882,9 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
 };
 AiToolDiscoveryService = _ts_decorate21([
   (0, import_common22.Injectable)(),
-  _ts_param20(1, (0, import_common22.Inject)(import_nestjs_agent_core22.AGENT_TOOL_REGISTRY)),
-  _ts_param20(2, (0, import_common22.Inject)(import_nestjs_agent_core22.AGENT_REGISTRY)),
-  _ts_param20(3, (0, import_common22.Inject)(import_nestjs_agent_core22.AGENT_OPTIONS)),
+  _ts_param20(1, (0, import_common22.Inject)(import_nestjs_agent_core24.AGENT_TOOL_REGISTRY)),
+  _ts_param20(2, (0, import_common22.Inject)(import_nestjs_agent_core24.AGENT_REGISTRY)),
+  _ts_param20(3, (0, import_common22.Inject)(import_nestjs_agent_core24.AGENT_OPTIONS)),
   _ts_metadata20("design:type", Function),
   _ts_metadata20("design:paramtypes", [
     typeof import_core2.DiscoveryService === "undefined" ? Object : import_core2.DiscoveryService,
@@ -4806,13 +4895,13 @@ AiToolDiscoveryService = _ts_decorate21([
 ], AiToolDiscoveryService);
 
 // src/discovery/skill-discovery.service.ts
-var import_nestjs_agent_core24 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core26 = require("@dudousxd/nestjs-agent-core");
 var import_common23 = require("@nestjs/common");
 var import_core3 = require("@nestjs/core");
 
 // src/decorator/skill.decorator.ts
 var import_reflect_metadata4 = require("reflect-metadata");
-var import_nestjs_agent_core23 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core25 = require("@dudousxd/nestjs-agent-core");
 var SKILL_METADATA = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:skill-metadata");
 function Skill(options) {
   return (target) => {
@@ -4825,7 +4914,7 @@ function readSkillMetadata(target) {
 }
 __name(readSkillMetadata, "readSkillMetadata");
 function skillScope(options) {
-  return options.scope ?? import_nestjs_agent_core23.GLOBAL_SCOPE;
+  return options.scope ?? import_nestjs_agent_core25.GLOBAL_SCOPE;
 }
 __name(skillScope, "skillScope");
 
@@ -4901,7 +4990,7 @@ var SkillDiscoveryService = class _SkillDiscoveryService {
 };
 SkillDiscoveryService = _ts_decorate22([
   (0, import_common23.Injectable)(),
-  _ts_param21(1, (0, import_common23.Inject)(import_nestjs_agent_core24.AGENT_SKILL_SOURCES)),
+  _ts_param21(1, (0, import_common23.Inject)(import_nestjs_agent_core26.AGENT_SKILL_SOURCES)),
   _ts_metadata21("design:type", Function),
   _ts_metadata21("design:paramtypes", [
     typeof import_core3.DiscoveryService === "undefined" ? Object : import_core3.DiscoveryService,
@@ -4910,7 +4999,7 @@ SkillDiscoveryService = _ts_decorate22([
 ], SkillDiscoveryService);
 
 // src/in-process-sink.ts
-var import_nestjs_agent_core25 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core27 = require("@dudousxd/nestjs-agent-core");
 var InProcessTokenStreamSink = class {
   static {
     __name(this, "InProcessTokenStreamSink");
@@ -4965,7 +5054,7 @@ var InProcessTokenStreamSink = class {
       }
       if (buf.ended) {
         if (buf.failure !== void 0) {
-          throw new import_nestjs_agent_core25.AgentStreamError(buf.failure);
+          throw new import_nestjs_agent_core27.AgentStreamError(buf.failure);
         }
         return;
       }
@@ -4978,7 +5067,7 @@ var InProcessTokenStreamSink = class {
 };
 
 // src/ledger-quota-provider.ts
-var import_nestjs_agent_core26 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core28 = require("@dudousxd/nestjs-agent-core");
 var LedgerQuotaProvider = class {
   static {
     __name(this, "LedgerQuotaProvider");
@@ -4998,12 +5087,12 @@ var LedgerQuotaProvider = class {
       await this.dayWindow(actorRef, now)
     ];
     if (this.store.usageBetween !== void 0) {
-      const range = (0, import_nestjs_agent_core26.quotaPeriodRange)("month", now);
+      const range = (0, import_nestjs_agent_core28.quotaPeriodRange)("month", now);
       const used = await this.store.usageBetween(actorRef, range.fromDay, range.toDay);
       windows.push(this.window("month", used.usedTokens, used.costUsd, range.resetsAt));
     }
-    const blocked = (0, import_nestjs_agent_core26.exhaustedWindow)(windows);
-    const warning = (0, import_nestjs_agent_core26.quotaWarning)(windows);
+    const blocked = (0, import_nestjs_agent_core28.exhaustedWindow)(windows);
+    const warning = (0, import_nestjs_agent_core28.quotaWarning)(windows);
     return {
       windows,
       ...blocked !== void 0 ? {
@@ -5015,7 +5104,7 @@ var LedgerQuotaProvider = class {
     };
   }
   async dayWindow(actorRef, now) {
-    const range = (0, import_nestjs_agent_core26.quotaPeriodRange)("day", now);
+    const range = (0, import_nestjs_agent_core28.quotaPeriodRange)("day", now);
     const { usedTokens, costUsd } = await this.store.quotaToday(actorRef, range.fromDay);
     return this.window("day", usedTokens, costUsd, range.resetsAt);
   }
@@ -5041,7 +5130,7 @@ var LedgerQuotaProvider = class {
 
 // src/proposals/action-proposal-worker.service.ts
 var import_node_crypto2 = require("crypto");
-var import_nestjs_agent_core27 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core29 = require("@dudousxd/nestjs-agent-core");
 var import_common24 = require("@nestjs/common");
 function _ts_decorate23(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -5085,15 +5174,15 @@ var ActionProposalWorkerService = class _ActionProposalWorkerService {
   }
   onModuleInit() {
     if (this.options.actionApprovalMode !== "independent") return;
-    (0, import_nestjs_agent_core27.assertIndependentActionCapabilities)(this.store, this.options.backgroundActorResolver);
+    (0, import_nestjs_agent_core29.assertIndependentActionCapabilities)(this.store, this.options.backgroundActorResolver);
     if (this.options.surface === "http") return;
     const resolver = this.options.backgroundActorResolver;
     if (!resolver) throw new Error("BackgroundActorResolver is required");
-    this.worker = new import_nestjs_agent_core27.ActionProposalWorker({
+    this.worker = new import_nestjs_agent_core29.ActionProposalWorker({
       store: this.store,
       workerId: (0, import_node_crypto2.randomUUID)(),
       ...this.options.actionProposalWorker,
-      executor: new import_nestjs_agent_core27.ActionProposalExecutor({
+      executor: new import_nestjs_agent_core29.ActionProposalExecutor({
         resolver,
         resolveExecution: /* @__PURE__ */ __name(async (proposal, actor) => {
           const deps = this.deps.forProposal(proposal, actor);
@@ -5119,9 +5208,9 @@ var ActionProposalWorkerService = class _ActionProposalWorkerService {
 };
 ActionProposalWorkerService = _ts_decorate23([
   (0, import_common24.Injectable)(),
-  _ts_param22(0, (0, import_common24.Inject)(import_nestjs_agent_core27.AGENT_STORE)),
-  _ts_param22(1, (0, import_common24.Inject)(import_nestjs_agent_core27.AGENT_OPTIONS)),
-  _ts_param22(2, (0, import_common24.Inject)(import_nestjs_agent_core27.AGENT_DEPS_FACTORY)),
+  _ts_param22(0, (0, import_common24.Inject)(import_nestjs_agent_core29.AGENT_STORE)),
+  _ts_param22(1, (0, import_common24.Inject)(import_nestjs_agent_core29.AGENT_OPTIONS)),
+  _ts_param22(2, (0, import_common24.Inject)(import_nestjs_agent_core29.AGENT_DEPS_FACTORY)),
   _ts_metadata22("design:type", Function),
   _ts_metadata22("design:paramtypes", [
     typeof AgentStore === "undefined" ? Object : AgentStore,
@@ -5131,7 +5220,7 @@ ActionProposalWorkerService = _ts_decorate23([
 ], ActionProposalWorkerService);
 
 // src/proposals/action-proposal.controller.ts
-var import_nestjs_agent_core28 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core30 = require("@dudousxd/nestjs-agent-core");
 var import_common25 = require("@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;
@@ -5185,7 +5274,7 @@ var ActionProposalController = class {
         query = {
           after: JSON.parse(cursor)
         };
-        (0, import_nestjs_agent_core28.validateActionProposalListQuery)(query);
+        (0, import_nestjs_agent_core30.validateActionProposalListQuery)(query);
       } catch {
         throw new import_common25.BadRequestException("Invalid action proposal cursor");
       }
@@ -5266,7 +5355,7 @@ _ts_decorate24([
 ], ActionProposalController.prototype, "reject", null);
 ActionProposalController = _ts_decorate24([
   (0, import_common25.Controller)("threads/:threadId/action-proposals"),
-  _ts_param23(1, (0, import_common25.Inject)(import_nestjs_agent_core28.AGENT_ACTOR_RESOLVER)),
+  _ts_param23(1, (0, import_common25.Inject)(import_nestjs_agent_core30.AGENT_ACTOR_RESOLVER)),
   _ts_metadata23("design:type", Function),
   _ts_metadata23("design:paramtypes", [
     typeof ActionProposalService === "undefined" ? Object : ActionProposalService,
@@ -5278,7 +5367,7 @@ ActionProposalController = _ts_decorate24([
 var AGENT_CHAT_QUEUE = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:chat-queue");
 
 // src/runner/inline-agent-runner.ts
-var import_nestjs_agent_core29 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core31 = require("@dudousxd/nestjs-agent-core");
 var import_common26 = require("@nestjs/common");
 function _ts_decorate25(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -5362,18 +5451,18 @@ var InlineAgentRunner = class _InlineAgentRunner {
       ],
       input
     });
-    void (0, import_nestjs_agent_core29.runAgentLoop)({
+    void (0, import_nestjs_agent_core31.runAgentLoop)({
       ...deps,
       day
-    }, input, hooks).then(() => (0, import_nestjs_agent_core29.releaseThreadRun)(this.store, input.threadId, runId)).catch(async (error) => {
-      if (error instanceof import_nestjs_agent_core29.RunCancelledError) {
+    }, input, hooks).then(() => (0, import_nestjs_agent_core31.releaseThreadRun)(this.store, input.threadId, runId)).catch(async (error) => {
+      if (error instanceof import_nestjs_agent_core31.RunCancelledError) {
         await this.settleCancelled(runId, input, deps);
         return;
       }
       const message = error instanceof Error ? error.message : String(error);
-      const code = (0, import_nestjs_agent_core29.agentFailureCode)(error);
+      const code = (0, import_nestjs_agent_core31.agentFailureCode)(error);
       this.logger.error(`agent run ${runId} failed (${code}): ${message}`);
-      (0, import_nestjs_agent_core29.publishAgentRunFailed)({
+      (0, import_nestjs_agent_core31.publishAgentRunFailed)({
         runId,
         code,
         message
@@ -5384,11 +5473,11 @@ var InlineAgentRunner = class _InlineAgentRunner {
         errorCode: code,
         errorMessage: message
       });
-      await Promise.resolve(this.store.failUnsettledToolCalls?.(runId, import_nestjs_agent_core29.RUN_ENDED_BEFORE_TOOL_CALL)).catch(() => 0);
+      await Promise.resolve(this.store.failUnsettledToolCalls?.(runId, import_nestjs_agent_core31.RUN_ENDED_BEFORE_TOOL_CALL)).catch(() => 0);
       const writer = await deps.sink.open(runId);
       await this.settleQueue(writer, input, runId, "failed", message);
-      await (0, import_nestjs_agent_core29.releaseThreadRun)(this.store, input.threadId, runId);
-      await writer.fail((0, import_nestjs_agent_core29.streamFailure)(error));
+      await (0, import_nestjs_agent_core31.releaseThreadRun)(this.store, input.threadId, runId);
+      await writer.fail((0, import_nestjs_agent_core31.streamFailure)(error));
     }).finally(() => {
       this.cancelled.delete(runId);
       this.live.delete(runId);
@@ -5424,7 +5513,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
     for (const [key, waiter] of this.pending) {
       if (key.startsWith(`${runId}:`)) {
         this.pending.delete(key);
-        waiter.reject(new import_nestjs_agent_core29.RunCancelledError());
+        waiter.reject(new import_nestjs_agent_core31.RunCancelledError());
       }
     }
     await Promise.resolve();
@@ -5439,8 +5528,8 @@ var InlineAgentRunner = class _InlineAgentRunner {
     this.logger.log(`agent run ${runId} cancelled`);
     const writer = await deps.sink.open(runId);
     await this.settleQueue(writer, input, runId, "cancelled");
-    await (0, import_nestjs_agent_core29.releaseThreadRun)(this.store, input.threadId, runId);
-    await writer.write((0, import_nestjs_agent_core29.encodeStreamEvent)({
+    await (0, import_nestjs_agent_core31.releaseThreadRun)(this.store, input.threadId, runId);
+    await writer.write((0, import_nestjs_agent_core31.encodeStreamEvent)({
       kind: "cancelled"
     }));
     await writer.end();
@@ -5475,7 +5564,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
         runId: nextRunId
       }));
       if (frame !== void 0) {
-        await writer.write((0, import_nestjs_agent_core29.encodeStreamEvent)(frame));
+        await writer.write((0, import_nestjs_agent_core31.encodeStreamEvent)(frame));
       }
     } catch (failure) {
       this.logger.error(`could not advance the queue of thread ${input.threadId} after run ${runId}: ${failure instanceof Error ? failure.message : String(failure)}`);
@@ -5546,7 +5635,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
       awaitApproval: /* @__PURE__ */ __name((call, _ctx, opts) => this.parkApproval(runId, call.id, opts?.timeoutMs), "awaitApproval"),
       awaitAnswers: /* @__PURE__ */ __name((request) => this.park(runId, request.id), "awaitAnswers"),
       step: /* @__PURE__ */ __name((_name, fn) => fn(), "step"),
-      parallel: import_nestjs_agent_core29.settleAll,
+      parallel: import_nestjs_agent_core31.settleAll,
       cancelled: /* @__PURE__ */ __name(async () => this.cancelled.has(runId), "cancelled"),
       runAgent: /* @__PURE__ */ __name((agentName, task) => this.runNested({
         agentName,
@@ -5597,7 +5686,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
       awaitApproval: /* @__PURE__ */ __name((call, _ctx, opts) => this.parkApproval(runId, call.id, opts?.timeoutMs), "awaitApproval"),
       awaitAnswers: /* @__PURE__ */ __name((request) => this.park(runId, request.id), "awaitAnswers"),
       step: /* @__PURE__ */ __name((_name, fn) => fn(), "step"),
-      parallel: import_nestjs_agent_core29.settleAll,
+      parallel: import_nestjs_agent_core31.settleAll,
       cancelled: /* @__PURE__ */ __name(async () => this.cancelled.has(runId), "cancelled"),
       runAgent: /* @__PURE__ */ __name((childName, childTask) => this.runNested({
         agentName: childName,
@@ -5630,7 +5719,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
         }
       }), "startAgent")
     };
-    void (0, import_nestjs_agent_core29.runAgentLoop)({
+    void (0, import_nestjs_agent_core31.runAgentLoop)({
       ...deps,
       day
     }, {
@@ -5644,13 +5733,13 @@ var InlineAgentRunner = class _InlineAgentRunner {
       parentRunId,
       deliverTo
     }, hooks).catch(async (error) => {
-      const cancelled = error instanceof import_nestjs_agent_core29.RunCancelledError;
+      const cancelled = error instanceof import_nestjs_agent_core31.RunCancelledError;
       const message = error instanceof Error ? error.message : String(error);
       if (!cancelled) {
         this.logger.error(`detached agent run ${runId} failed: ${message}`);
-        (0, import_nestjs_agent_core29.publishAgentRunFailed)({
+        (0, import_nestjs_agent_core31.publishAgentRunFailed)({
           runId,
-          code: (0, import_nestjs_agent_core29.agentFailureCode)(error),
+          code: (0, import_nestjs_agent_core31.agentFailureCode)(error),
           message
         });
       }
@@ -5658,12 +5747,12 @@ var InlineAgentRunner = class _InlineAgentRunner {
         runId,
         status: cancelled ? "cancelled" : "failed",
         ...cancelled ? {} : {
-          errorCode: (0, import_nestjs_agent_core29.agentFailureCode)(error),
+          errorCode: (0, import_nestjs_agent_core31.agentFailureCode)(error),
           errorMessage: message
         }
       });
-      await Promise.resolve(this.store.failUnsettledToolCalls?.(runId, import_nestjs_agent_core29.RUN_ENDED_BEFORE_TOOL_CALL)).catch(() => 0);
-      await (0, import_nestjs_agent_core29.settleUnsettledDelegation)({
+      await Promise.resolve(this.store.failUnsettledToolCalls?.(runId, import_nestjs_agent_core31.RUN_ENDED_BEFORE_TOOL_CALL)).catch(() => 0);
+      await (0, import_nestjs_agent_core31.settleUnsettledDelegation)({
         store: this.store,
         delivery: deliverTo,
         agent: agentName,
@@ -5702,7 +5791,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
       awaitApproval: /* @__PURE__ */ __name((call, _ctx, opts) => this.parkApproval(runId, call.id, opts?.timeoutMs), "awaitApproval"),
       awaitAnswers: /* @__PURE__ */ __name((request) => this.park(runId, request.id), "awaitAnswers"),
       step: /* @__PURE__ */ __name((_name, fn) => fn(), "step"),
-      parallel: import_nestjs_agent_core29.settleAll,
+      parallel: import_nestjs_agent_core31.settleAll,
       // A child stops when it is cancelled OR when the run a human is actually watching is: the
       // canceller names the top-level run, which is the only id that ever left the server.
       cancelled: /* @__PURE__ */ __name(async () => this.cancelled.has(runId) || this.cancelled.has(sinkRunId), "cancelled"),
@@ -5737,7 +5826,7 @@ var InlineAgentRunner = class _InlineAgentRunner {
       }), "startAgent")
     };
     try {
-      return await (0, import_nestjs_agent_core29.runAgentLoop)({
+      return await (0, import_nestjs_agent_core31.runAgentLoop)({
         ...deps,
         day
       }, {
@@ -5758,8 +5847,8 @@ var InlineAgentRunner = class _InlineAgentRunner {
 };
 InlineAgentRunner = _ts_decorate25([
   (0, import_common26.Injectable)(),
-  _ts_param24(0, (0, import_common26.Inject)(import_nestjs_agent_core29.AGENT_DEPS_FACTORY)),
-  _ts_param24(1, (0, import_common26.Inject)(import_nestjs_agent_core29.AGENT_STORE)),
+  _ts_param24(0, (0, import_common26.Inject)(import_nestjs_agent_core31.AGENT_DEPS_FACTORY)),
+  _ts_param24(1, (0, import_common26.Inject)(import_nestjs_agent_core31.AGENT_STORE)),
   _ts_param24(2, (0, import_common26.Optional)()),
   _ts_metadata24("design:type", Function),
   _ts_metadata24("design:paramtypes", [
@@ -5774,7 +5863,7 @@ function isThreadTurn(input) {
 __name(isThreadTurn, "isThreadTurn");
 
 // src/skills-config.ts
-var import_nestjs_agent_core30 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core32 = require("@dudousxd/nestjs-agent-core");
 function declaredSkillProvider(declared) {
   return {
     list: /* @__PURE__ */ __name(({ scopes }) => declared.filter((skill) => scopes.includes(skill.scope)).map(({ name, description, scope }) => ({
@@ -5800,7 +5889,7 @@ function resolveSkillsConfig(options, declared) {
     declaredSkillProvider(declared)
   ];
   return {
-    provider: providers.length === 1 ? providers[0] : (0, import_nestjs_agent_core30.compositeSkillProvider)(providers),
+    provider: providers.length === 1 ? providers[0] : (0, import_nestjs_agent_core32.compositeSkillProvider)(providers),
     ...options.scopes !== void 0 ? {
       scopes: options.scopes
     } : {},
@@ -5828,15 +5917,15 @@ function _ts_decorate26(decorators, target, key, desc) {
 __name(_ts_decorate26, "_ts_decorate");
 var DEFAULT_PATH = "agent";
 var logger = new import_common27.Logger("AgentModule");
-function externalStoreWrapper(modules) {
+function externalWrapper(modules, token) {
   for (const module2 of modules.values()) {
     if (module2.metatype === AgentModule) continue;
-    const wrapper = module2.providers.get(import_nestjs_agent_core31.AGENT_STORE);
+    const wrapper = module2.providers.get(token);
     if (wrapper !== void 0) return wrapper;
   }
   return void 0;
 }
-__name(externalStoreWrapper, "externalStoreWrapper");
+__name(externalWrapper, "externalWrapper");
 function forwardingStore(wrapper) {
   const target = /* @__PURE__ */ __name(() => {
     const instance = wrapper.instance;
@@ -5859,118 +5948,143 @@ function forwardingStore(wrapper) {
 __name(forwardingStore, "forwardingStore");
 function resolveStore(options, modules) {
   if (options.store !== void 0) return options.store;
-  const external = externalStoreWrapper(modules);
+  const external = externalWrapper(modules, import_nestjs_agent_core33.AGENT_STORE);
   if (external !== void 0) return forwardingStore(external);
   logger.warn("No `store` configured and no store module imported \u2014 using the in-memory store. Threads are lost on restart and not shared between processes: not for production. Pass `store`, or import a store module (e.g. MikroOrmAgentStoreModule.forFeature()).");
-  return new import_nestjs_agent_core31.InMemoryAgentStore();
+  return new import_nestjs_agent_core33.InMemoryAgentStore();
 }
 __name(resolveStore, "resolveStore");
+function resolveRolesPolicy(options, modules) {
+  const external = externalWrapper(modules, import_nestjs_agent_core33.AGENT_ROLES_POLICY);
+  if (options.rolesPolicy !== void 0) {
+    if (external !== void 0) {
+      logger.warn("Both a `rolesPolicy` option and a module binding AGENT_ROLES_POLICY (e.g. AgentAuthzModule) are configured \u2014 the `rolesPolicy` option wins.");
+    }
+    return options.rolesPolicy;
+  }
+  if (external !== void 0) return forwardingPolicy(external);
+  return options.emptyRoles === "deny" ? new import_nestjs_agent_core33.ClosedRolesPolicy(options.defaultRoles) : new import_nestjs_agent_core33.DefaultRolesPolicy(options.defaultRoles);
+}
+__name(resolveRolesPolicy, "resolveRolesPolicy");
+function forwardingPolicy(wrapper) {
+  return {
+    can(actor, tool) {
+      const policy = wrapper.instance;
+      if (policy === void 0 || policy === null) {
+        throw new Error("AgentModule: the AGENT_ROLES_POLICY bound by another module is not ready yet");
+      }
+      return policy.can(actor, tool);
+    }
+  };
+}
+__name(forwardingPolicy, "forwardingPolicy");
 function isQuotaProvider(quota) {
   return quota !== void 0 && typeof quota.report === "function";
 }
 __name(isQuotaProvider, "isQuotaProvider");
 function resolveCatalog(options) {
   if (options.models !== void 0) return options.models;
-  const carried = options.model.catalog;
+  const carried = options.model?.catalog;
   return carried !== void 0 && typeof carried.list === "function" ? carried : void 0;
 }
 __name(resolveCatalog, "resolveCatalog");
-function sharedProviders(durable) {
+function sharedProviders(durable, engine) {
   const providers = [
     {
-      provide: import_nestjs_agent_core31.AGENT_TOOL_REGISTRY,
-      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core31.ToolRegistry(), "useFactory")
+      provide: import_nestjs_agent_core33.AGENT_TOOL_REGISTRY,
+      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core33.ToolRegistry(), "useFactory")
     },
     // Starts empty; AgentDiscoveryService populates it from `@Agent`-decorated providers at boot.
     {
-      provide: import_nestjs_agent_core31.AGENT_REGISTRY,
-      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core31.AgentRegistry(), "useFactory")
+      provide: import_nestjs_agent_core33.AGENT_REGISTRY,
+      useFactory: /* @__PURE__ */ __name(() => new import_nestjs_agent_core33.AgentRegistry(), "useFactory")
     },
     // A shared, mutable list AgentDiscoveryService fills with `@SystemPromptContributor()` methods.
     {
-      provide: import_nestjs_agent_core31.AGENT_PROMPT_CONTRIBUTORS,
+      provide: import_nestjs_agent_core33.AGENT_PROMPT_CONTRIBUTORS,
       useFactory: /* @__PURE__ */ __name(() => [], "useFactory")
     },
     // Likewise for `@Skill`-decorated providers — filled by SkillDiscoveryService at onModuleInit,
     // read lazily by the AGENT_SKILLS provider below (which DI builds before discovery has run).
     {
-      provide: import_nestjs_agent_core31.AGENT_SKILL_SOURCES,
+      provide: import_nestjs_agent_core33.AGENT_SKILL_SOURCES,
       useFactory: /* @__PURE__ */ __name(() => [], "useFactory")
     },
     {
       // One resolution, shared by the loop's deps and the listing endpoint: a second one would
       // drift, and a user would be offered a skill the agent cannot reach. `undefined` when the
       // host configured none — which is what keeps the turn's checkpoint sequence unchanged.
-      provide: import_nestjs_agent_core31.AGENT_SKILLS,
+      provide: import_nestjs_agent_core33.AGENT_SKILLS,
       useFactory: /* @__PURE__ */ __name((options, declared) => resolveSkillsConfig(options.skills, declared), "useFactory"),
       inject: [
-        import_nestjs_agent_core31.AGENT_OPTIONS,
-        import_nestjs_agent_core31.AGENT_SKILL_SOURCES
+        import_nestjs_agent_core33.AGENT_OPTIONS,
+        import_nestjs_agent_core33.AGENT_SKILL_SOURCES
       ]
     },
     {
       // One resolution, shared by the loop's deps and the read-back endpoint: a person has to be
       // shown what the model was shown, and two resolutions would eventually disagree about that.
-      provide: import_nestjs_agent_core31.AGENT_MEMORY,
+      provide: import_nestjs_agent_core33.AGENT_MEMORY,
       useFactory: /* @__PURE__ */ __name((options) => options.memory, "useFactory"),
       inject: [
-        import_nestjs_agent_core31.AGENT_OPTIONS
+        import_nestjs_agent_core33.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core31.AGENT_SINK,
+      provide: import_nestjs_agent_core33.AGENT_SINK,
       useFactory: /* @__PURE__ */ __name((options) => options.sink ?? new InProcessTokenStreamSink(), "useFactory"),
       inject: [
-        import_nestjs_agent_core31.AGENT_OPTIONS
+        import_nestjs_agent_core33.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core31.AGENT_ROLES_POLICY,
-      useFactory: /* @__PURE__ */ __name((options) => options.rolesPolicy ?? (options.emptyRoles === "deny" ? new import_nestjs_agent_core31.ClosedRolesPolicy(options.defaultRoles) : new import_nestjs_agent_core31.DefaultRolesPolicy(options.defaultRoles)), "useFactory"),
+      provide: import_nestjs_agent_core33.AGENT_ROLES_POLICY,
+      useFactory: /* @__PURE__ */ __name((options, modules) => resolveRolesPolicy(options, modules), "useFactory"),
       inject: [
-        import_nestjs_agent_core31.AGENT_OPTIONS
+        import_nestjs_agent_core33.AGENT_OPTIONS,
+        import_core4.ModulesContainer
       ]
     },
     {
-      provide: import_nestjs_agent_core31.AGENT_ACTOR_RESOLVER,
+      provide: import_nestjs_agent_core33.AGENT_ACTOR_RESOLVER,
       useFactory: /* @__PURE__ */ __name((options) => {
         if (options.actorResolver !== void 0) return options.actorResolver;
         logger.warn("No `actorResolver` configured \u2014 the agent endpoints are PUBLIC: every browser gets its own anonymous identity (an HttpOnly cookie). Set `actorResolver: requestUserActorResolver()` (or your own) to require login.");
         return new AnonymousActorResolver();
       }, "useFactory"),
       inject: [
-        import_nestjs_agent_core31.AGENT_OPTIONS
+        import_nestjs_agent_core33.AGENT_OPTIONS
       ]
     },
     {
-      provide: import_nestjs_agent_core31.AGENT_MODEL,
+      provide: import_nestjs_agent_core33.AGENT_MODEL,
       useFactory: /* @__PURE__ */ __name((o) => o.model, "useFactory"),
       inject: [
-        import_nestjs_agent_core31.AGENT_OPTIONS
+        import_nestjs_agent_core33.AGENT_OPTIONS
       ]
     },
     {
       // `quota` is either a provider of the host's own or ceilings for the built-in ledger one;
       // omitted, the ledger provider still reports usage, with no ceiling to block on.
-      provide: import_nestjs_agent_core31.AGENT_QUOTA_PROVIDER,
+      provide: import_nestjs_agent_core33.AGENT_QUOTA_PROVIDER,
       useFactory: /* @__PURE__ */ __name((o, store) => isQuotaProvider(o.quota) ? o.quota : new LedgerQuotaProvider(store, o.quota?.limits, o.quota?.warnAt !== void 0 ? {
         warnAt: o.quota.warnAt
       } : {}), "useFactory"),
       inject: [
-        import_nestjs_agent_core31.AGENT_OPTIONS,
-        import_nestjs_agent_core31.AGENT_STORE
+        import_nestjs_agent_core33.AGENT_OPTIONS,
+        import_nestjs_agent_core33.AGENT_STORE
       ]
     },
     {
-      provide: import_nestjs_agent_core31.AGENT_MODEL_CATALOG,
+      provide: import_nestjs_agent_core33.AGENT_MODEL_CATALOG,
       useFactory: /* @__PURE__ */ __name((o) => resolveCatalog(o), "useFactory"),
       inject: [
-        import_nestjs_agent_core31.AGENT_OPTIONS
+        import_nestjs_agent_core33.AGENT_OPTIONS
       ]
     },
     AgentDepsFactory2,
     {
-      provide: import_nestjs_agent_core31.AGENT_DEPS_FACTORY,
+      provide: import_nestjs_agent_core33.AGENT_DEPS_FACTORY,
       useExisting: AgentDepsFactory2
     },
     // Populates the registry + contributors (onModuleInit) BEFORE AiToolDiscoveryService synthesizes
@@ -5993,21 +6107,26 @@ function sharedProviders(durable) {
     // through AgentService.signalToolCall, which reaches whichever AGENT_RUNNER is bound above.
     AgentApprovalPortAdapter,
     {
-      provide: import_nestjs_agent_core31.AGENT_APPROVAL_PORT,
+      provide: import_nestjs_agent_core33.AGENT_APPROVAL_PORT,
       useExisting: AgentApprovalPortAdapter
     }
   ];
   providers.push({
-    provide: import_nestjs_agent_core31.AGENT_STORE,
+    provide: import_nestjs_agent_core33.AGENT_STORE,
     useFactory: /* @__PURE__ */ __name((o, modules) => resolveStore(o, modules), "useFactory"),
     inject: [
-      import_nestjs_agent_core31.AGENT_OPTIONS,
+      import_nestjs_agent_core33.AGENT_OPTIONS,
       import_core4.ModulesContainer
     ]
   });
-  if (durable) {
+  if (engine !== void 0) {
+    providers.push(...engine.providers, {
+      provide: import_nestjs_agent_core33.AGENT_RUNNER,
+      useExisting: engine.runner
+    });
+  } else if (durable) {
     providers.push({
-      provide: import_nestjs_agent_core31.AGENT_RUNNER,
+      provide: import_nestjs_agent_core33.AGENT_RUNNER,
       useFactory: /* @__PURE__ */ __name((durableRunner) => {
         if (durableRunner === void 0) {
           throw new Error("AgentModule.forRoot({ durable: true }) requires importing AgentDurableModule from '@dudousxd/nestjs-agent/durable' (alongside a configured DurableModule). It was not found.");
@@ -6016,36 +6135,37 @@ function sharedProviders(durable) {
       }, "useFactory"),
       inject: [
         {
-          token: import_nestjs_agent_core31.AGENT_DURABLE_RUNNER,
+          token: import_nestjs_agent_core33.AGENT_DURABLE_RUNNER,
           optional: true
         }
       ]
     });
   } else {
     providers.push({
-      provide: import_nestjs_agent_core31.AGENT_RUNNER,
+      provide: import_nestjs_agent_core33.AGENT_RUNNER,
       useExisting: InlineAgentRunner
     });
   }
   return providers;
 }
 __name(sharedProviders, "sharedProviders");
-function exportsFor() {
+function exportsFor(engine) {
   return [
-    import_nestjs_agent_core31.AGENT_OPTIONS,
-    import_nestjs_agent_core31.AGENT_TOOL_REGISTRY,
-    import_nestjs_agent_core31.AGENT_REGISTRY,
-    import_nestjs_agent_core31.AGENT_SINK,
-    import_nestjs_agent_core31.AGENT_ROLES_POLICY,
-    import_nestjs_agent_core31.AGENT_ACTOR_RESOLVER,
-    import_nestjs_agent_core31.AGENT_MODEL,
-    import_nestjs_agent_core31.AGENT_STORE,
-    import_nestjs_agent_core31.AGENT_MODEL_CATALOG,
-    import_nestjs_agent_core31.AGENT_QUOTA_PROVIDER,
-    import_nestjs_agent_core31.AGENT_PROMPT_CONTRIBUTORS,
-    import_nestjs_agent_core31.AGENT_SKILLS,
-    import_nestjs_agent_core31.AGENT_MEMORY,
-    import_nestjs_agent_core31.AGENT_DEPS_FACTORY,
+    ...engine?.exports ?? [],
+    import_nestjs_agent_core33.AGENT_OPTIONS,
+    import_nestjs_agent_core33.AGENT_TOOL_REGISTRY,
+    import_nestjs_agent_core33.AGENT_REGISTRY,
+    import_nestjs_agent_core33.AGENT_SINK,
+    import_nestjs_agent_core33.AGENT_ROLES_POLICY,
+    import_nestjs_agent_core33.AGENT_ACTOR_RESOLVER,
+    import_nestjs_agent_core33.AGENT_MODEL,
+    import_nestjs_agent_core33.AGENT_STORE,
+    import_nestjs_agent_core33.AGENT_MODEL_CATALOG,
+    import_nestjs_agent_core33.AGENT_QUOTA_PROVIDER,
+    import_nestjs_agent_core33.AGENT_PROMPT_CONTRIBUTORS,
+    import_nestjs_agent_core33.AGENT_SKILLS,
+    import_nestjs_agent_core33.AGENT_MEMORY,
+    import_nestjs_agent_core33.AGENT_DEPS_FACTORY,
     AgentDepsFactory2,
     AgentService,
     ActionProposalService,
@@ -6053,7 +6173,7 @@ function exportsFor() {
     ChatQueueService,
     AGENT_CHAT_QUEUE,
     InlineAgentRunner,
-    import_nestjs_agent_core31.AGENT_APPROVAL_PORT
+    import_nestjs_agent_core33.AGENT_APPROVAL_PORT
   ];
 }
 __name(exportsFor, "exportsFor");
@@ -6081,10 +6201,11 @@ function adapterProviders(adapters) {
   return (adapters ?? []).flatMap((adapter) => adapter.providers ?? []);
 }
 __name(adapterProviders, "adapterProviders");
-function controllersForSurface(surface, adapters) {
+function controllersForSurface(surface, adapters, engine) {
   return surface === "engine" ? [] : [
     ...BASE_CONTROLLERS,
-    ...adapterControllers(adapters)
+    ...adapterControllers(adapters),
+    ...engine?.controllers ?? []
   ];
 }
 __name(controllersForSurface, "controllersForSurface");
@@ -6114,12 +6235,22 @@ function routerFor(path) {
   ]);
 }
 __name(routerFor, "routerFor");
+function assertRunnable(options) {
+  if (options.engine !== void 0 && options.durable === true) {
+    throw new Error(`AgentModule: \`durable: true\` runs turns on the library's loop, but the \`${options.engine.name}\` engine runs them instead. Drop \`durable\` (the engine decides how its turns survive a restart).`);
+  }
+  if (options.engine === void 0 && options.model === void 0) {
+    throw new Error("AgentModule: set `model` (the loop runs the turns) or `engine` (something else does).");
+  }
+}
+__name(assertRunnable, "assertRunnable");
 var AgentModule = class _AgentModule {
   static {
     __name(this, "AgentModule");
   }
   static forRoot(options) {
     const path = options.path ?? DEFAULT_PATH;
+    assertRunnable(options);
     applyGuards(options.guards, options.adapters);
     return {
       module: _AgentModule,
@@ -6128,21 +6259,27 @@ var AgentModule = class _AgentModule {
         import_core4.DiscoveryModule,
         routerFor(path)
       ],
-      controllers: controllersForSurface(options.surface, options.adapters),
+      controllers: controllersForSurface(options.surface, options.adapters, options.engine),
       providers: [
         {
-          provide: import_nestjs_agent_core31.AGENT_OPTIONS,
+          provide: import_nestjs_agent_core33.AGENT_OPTIONS,
           useValue: options
         },
-        ...sharedProviders(options.durable ?? false),
+        ...sharedProviders(options.durable ?? false, options.engine),
         ...guardProviders(options.guards),
         ...adapterProviders(options.adapters)
       ],
-      exports: exportsFor()
+      exports: exportsFor(options.engine)
     };
   }
   static forRootAsync(options) {
     const path = options.path ?? DEFAULT_PATH;
+    if (options.engine !== void 0) {
+      assertRunnable({
+        engine: options.engine,
+        durable: options.durable ?? false
+      });
+    }
     applyGuards(options.guards, options.adapters);
     return {
       module: _AgentModule,
@@ -6152,28 +6289,35 @@ var AgentModule = class _AgentModule {
         routerFor(path),
         ...options.imports ?? []
       ],
-      controllers: controllersForSurface(options.surface, options.adapters),
+      controllers: controllersForSurface(options.surface, options.adapters, options.engine),
       providers: [
         {
-          provide: import_nestjs_agent_core31.AGENT_OPTIONS,
+          provide: import_nestjs_agent_core33.AGENT_OPTIONS,
           // Stamp the STATIC wiring flags onto the factory result: `durable`/`surface` are
           // authoritative on the async config object (they decided the actual wiring above), and
           // the durable module reads `durable` back off AGENT_OPTIONS. `surface` isn't read back by
           // anything today (AgentDurableModule takes its own mirror option — see its doc for why),
           // but it's stamped here too so the EFFECTIVE value is always observable off
           // AGENT_OPTIONS, sync or async alike.
-          useFactory: /* @__PURE__ */ __name(async (...args) => ({
-            ...await options.useFactory(...args),
-            durable: options.durable ?? false,
-            surface: options.surface ?? "both"
-          }), "useFactory"),
+          useFactory: /* @__PURE__ */ __name(async (...args) => {
+            const resolved = {
+              ...await options.useFactory(...args),
+              durable: options.durable ?? false,
+              surface: options.surface ?? "both",
+              ...options.engine !== void 0 ? {
+                engine: options.engine
+              } : {}
+            };
+            assertRunnable(resolved);
+            return resolved;
+          }, "useFactory"),
           inject: options.inject ?? []
         },
-        ...sharedProviders(options.durable ?? false),
+        ...sharedProviders(options.durable ?? false, options.engine),
         ...guardProviders(options.guards),
         ...adapterProviders(options.adapters)
       ],
-      exports: exportsFor()
+      exports: exportsFor(options.engine)
     };
   }
 };
@@ -6183,7 +6327,7 @@ AgentModule = _ts_decorate26([
 ], AgentModule);
 
 // src/ag-ui/ag-ui.adapter.ts
-var import_nestjs_agent_core32 = require("@dudousxd/nestjs-agent-core");
+var import_nestjs_agent_core34 = require("@dudousxd/nestjs-agent-core");
 var import_ag_ui = require("@dudousxd/nestjs-agent-core/ag-ui");
 var import_common28 = require("@nestjs/common");
 function _ts_decorate27(decorators, target, key, desc) {
@@ -6270,6 +6414,19 @@ var AgUiRunHandler = class {
         warnings.push(`The resume entry ${id} answers an interrupt this agent did not raise.`);
       }
       const first = plan.decisions[0];
+      if (first !== void 0 && plan.decisions.every((d) => d.address.kind === "proposal")) {
+        const decided = await this.decideProposals(actor, plan.decisions);
+        this.writeEvents(res, [
+          ...warningEvents(warnings),
+          ...decided.flatMap((outcome, index) => (0, import_ag_ui.actionProposalDecisionEvents)({
+            threadId: input.threadId,
+            runId: index === 0 ? input.runId : `${input.runId}:${index}`,
+            text: outcome.text,
+            proposalDecision: outcome.proposalDecision
+          }))
+        ]);
+        return;
+      }
       if (first !== void 0) {
         const streamRunId = first.address.stream;
         await this.agent.assertResumable(actor, streamRunId);
@@ -6298,11 +6455,7 @@ var AgUiRunHandler = class {
     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 [
+        this.writeEvents(res, [
           ...warningEvents(warnings),
           ...(0, import_ag_ui.actionProposalDecisionEvents)({
             threadId: input.threadId,
@@ -6310,8 +6463,7 @@ var AgUiRunHandler = class {
             text: decision.text,
             proposalDecision: decision.proposalDecision
           })
-        ]) res.write((0, import_ag_ui.agUiSse)(event));
-        res.end();
+        ]);
         return;
       }
     }
@@ -6403,9 +6555,11 @@ var AgUiRunHandler = class {
   */
   async settle(actor, decisions) {
     const deliveries = [];
+    const proposals = decisions.filter((decision) => decision.address.kind === "proposal");
     for (const { address, entry } of decisions) {
       const { toolCallId: toolCallId2 } = address;
       const abandoned = entry.status === "cancelled";
+      if (address.kind === "proposal") continue;
       if (address.kind === "approval") {
         await this.agent.checkDecision(actor, toolCallId2);
         const decision = abandoned ? {
@@ -6442,9 +6596,53 @@ var AgUiRunHandler = class {
         via: AG_UI_VIA
       }));
     }
+    if (proposals.length > 0) await this.decideProposals(actor, proposals);
     for (const deliver of deliveries) await deliver();
   }
   /**
+  * Decide independent proposals through the proposal service — the call the native
+  * `action-proposals/:id/approve|reject` routes make — never by signalling the origin run, which
+  * is not waiting. Every payload is checked before the first decision; a refusal is the service's
+  * own `403`/`404`.
+  */
+  async decideProposals(actor, decisions) {
+    const planned = decisions.map(({ address, entry }) => {
+      const decision = entry.status === "cancelled" ? {
+        approved: false
+      } : (0, import_ag_ui.readApprovalPayload)(entry.payload);
+      if (decision === null || address.proposalId === void 0 || address.threadId === void 0) {
+        throw invalid("invalid_resume", "an approval is answered with { approved: boolean, reason?, remember? }");
+      }
+      return {
+        address,
+        decision
+      };
+    });
+    const outcomes = [];
+    for (const { address, decision } of planned) {
+      outcomes.push(await this.agent.decideActionProposal(actor, address.threadId, address.proposalId, {
+        decision: decision.approved ? "approved" : "rejected",
+        via: AG_UI_VIA,
+        ...decision.remember !== void 0 ? {
+          remember: decision.remember
+        } : {},
+        ...decision.reason !== void 0 ? {
+          reason: decision.reason
+        } : {}
+      }));
+    }
+    return outcomes;
+  }
+  /** Answer with a complete list of events, no run behind them. */
+  writeEvents(res, events) {
+    res.status(200);
+    res.setHeader("Content-Type", "text/event-stream");
+    res.setHeader("Cache-Control", "no-cache, no-transform");
+    res.flushHeaders();
+    for (const event of events) res.write((0, import_ag_ui.agUiSse)(event));
+    res.end();
+  }
+  /**
   * Pipe a run to the client as AG-UI 1.0 over SSE: one event per `data:` line, from `RUN_STARTED`
   * to the run's terminal event. It ends when the run stops to ask — the library run stays parked,
   * and the request that answers re-attaches to it.
@@ -6507,10 +6705,10 @@ function agUiAdapter(options = {}) {
   AgUiController = _ts_decorate27([
     (0, import_common28.Controller)(),
     _ts_param25(0, (0, import_common28.Inject)(AgentService)),
-    _ts_param25(1, (0, import_common28.Inject)(import_nestjs_agent_core32.AGENT_ACTOR_RESOLVER)),
-    _ts_param25(2, (0, import_common28.Inject)(import_nestjs_agent_core32.AGENT_OPTIONS)),
+    _ts_param25(1, (0, import_common28.Inject)(import_nestjs_agent_core34.AGENT_ACTOR_RESOLVER)),
+    _ts_param25(2, (0, import_common28.Inject)(import_nestjs_agent_core34.AGENT_OPTIONS)),
     _ts_param25(3, (0, import_common28.Optional)()),
-    _ts_param25(3, (0, import_common28.Inject)(import_nestjs_agent_core32.AGENT_ATTACHMENT_STAGING)),
+    _ts_param25(3, (0, import_common28.Inject)(import_nestjs_agent_core34.AGENT_ATTACHMENT_STAGING)),
     _ts_metadata25("design:type", Function),
     _ts_metadata25("design:paramtypes", [
       typeof AgentService === "undefined" ? Object : AgentService,
@@ -6652,6 +6850,7 @@ __reExport(index_exports, require("@dudousxd/nestjs-agent-core"), module.exports
   attachmentLimits,
   declaredSkillProvider,
   defaultRequestUserMapper,
+  defineTool,
   delegateToolName,
   provideAgentTool,
   provideAgentTools,