@dudousxd/nestjs-agent 1.20.0 → 1.22.0

package/dist/index.d.cts

@@ -1,17 +1,64 @@
-import { DynamicModule, Type, OnApplicationBootstrap, OnModuleInit, ConflictException } from '@nestjs/common';
-import { b as AgentModuleOptions, c as AgentModuleAsyncOptions, A as AgentDepsFactory, C as ChatQueueService, d as AgentProtocolAdapter, e as AgentSkillsOptions } from './chat-queue.service-C0hr7dqx.cjs';
-export { f as AGENT_TOOL_BRAND, g as AgentAttachmentsOptions, h as AgentDeps, i as AgentMemoryOptions, a as AgentSurface, F as FunctionalTool, L as LedgerQuotaProvider, Q as QueuePlan, j as QueueSettleOutcome, k as QueuedTurn, l as QueuedTurnStarter, m as QuotaLimits, n as QuotaWindowLimits, o as delegateToolName, p as provideAgentTool, q as provideAgentTools, u as utcDay } from './chat-queue.service-C0hr7dqx.cjs';
-import { AgentRunner, AgentStore, AttachmentStagingStore, ModelCatalog, QuotaProvider, Actor, QuotaReport, ModelCatalogView, AttachmentRef, PageContext, ChatQueueState, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, MessageFeedbackValue, MessageFeedback, StagedAttachment, ActorResolver, AgentApprovalPort, MessageAttachment, AgentAttachmentConfig, AgentClientConfig, ToolPresentation, AgentHistoryWindow, AgentIntake, Persona, SkillContext, ToolRegistry, AgentRegistry, PromptContributor, SkillsConfig, SkillCatalogEntry, ToolCatalogEntry, MemoryConfig, MemoryDigestEntry, SkillProvider, AgentRunInput, AgentRunStartOptions, TokenStreamSink, SinkWriter } from '@dudousxd/nestjs-agent-core';
+import { DynamicModule, Type, OnApplicationBootstrap, OnModuleInit, ConflictException, OnModuleDestroy } from '@nestjs/common';
+import { b as AgentModuleOptions, c as AgentModuleAsyncOptions, A as AgentDepsFactory, C as ChatQueueService, d as AgentProtocolAdapter, e as AgentSkillsOptions } from './chat-queue.service-Dx9OsjcF.cjs';
+export { f as AGENT_TOOL_BRAND, g as AgentAttachmentsOptions, h as AgentDeps, i as AgentMemoryOptions, a as AgentSurface, F as FunctionalTool, L as LedgerQuotaProvider, Q as QueuePlan, j as QueueSettleOutcome, k as QueuedTurn, l as QueuedTurnStarter, m as QuotaLimits, n as QuotaWindowLimits, o as defineTool, p as delegateToolName, q as provideAgentTool, r as provideAgentTools, u as utcDay } from './chat-queue.service-Dx9OsjcF.cjs';
+import * as _dudousxd_nestjs_agent_core from '@dudousxd/nestjs-agent-core';
+import { AgentStore, Actor, ListActionProposals, ActionProposalMutationView, AgentRunner, AttachmentStagingStore, ModelCatalog, QuotaProvider, QuotaReport, ModelCatalogView, AttachmentRef, PageContext, ChatQueueState, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, MessageFeedbackValue, MessageFeedback, StagedAttachment, ActorResolver, AgentApprovalPort, MessageAttachment, AgentAttachmentConfig, AgentClientConfig, ToolSpec, ToolPresentation, AgentHistoryWindow, AgentIntake, Persona, SkillContext, ToolRegistry, AgentRegistry, PromptContributor, SkillsConfig, SkillCatalogEntry, ToolCatalogEntry, MemoryConfig, MemoryDigestEntry, SkillProvider, AgentRunInput, AgentRunStartOptions, TokenStreamSink, SinkWriter } from '@dudousxd/nestjs-agent-core';
 export * from '@dudousxd/nestjs-agent-core';
+export { FunctionalToolDefinition } from '@dudousxd/nestjs-agent-core';
 import { Request, Response } from 'express';
+import { UiCapabilities } from '@dudousxd/nestjs-agent-core/genui';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { DiscoveryService, MetadataScanner } from '@nestjs/core';
+import './genui/index.cjs';
 
 declare class AgentModule {
     static forRoot(options: AgentModuleOptions): DynamicModule;
     static forRootAsync(options: AgentModuleAsyncOptions): DynamicModule;
 }
 
+declare class ActionProposalService {
+    private readonly store;
+    private readonly options;
+    constructor(store: AgentStore, options: Pick<AgentModuleOptions, 'approvalPolicy' | 'actionProposalText'>);
+    /** The words a text decision is made of, and what the agent answers — English unless configured. */
+    private readonly vocabulary;
+    private readonly replies;
+    private capability;
+    private scope;
+    private mayDecide;
+    listPage(threadId: string, actor: Actor, query?: Pick<ListActionProposals, 'after'>): Promise<{
+        next?: {
+            createdAt: number;
+            id: string;
+        };
+        items: _dudousxd_nestjs_agent_core.ActionProposalView[];
+    }>;
+    list(threadId: string, actor: Actor): Promise<_dudousxd_nestjs_agent_core.ActionProposalView[]>;
+    decide(threadId: string, proposalId: string, actor: Actor, command: {
+        decision: 'approved' | 'rejected';
+        remember?: boolean;
+        reason?: string;
+        via?: string;
+    }): Promise<ActionProposalMutationView>;
+    handleTextDecision(threadId: string, actor: Actor, text: string): Promise<{
+        status: "unmatched";
+    } | {
+        threadId: string;
+        proposalDecision: ActionProposalMutationView;
+        text: string;
+    } | {
+        threadId: string;
+        proposalDecision: {
+            status: "ambiguous";
+            proposalIds: string[];
+        };
+        text: string;
+    }>;
+    private textReceipt;
+    /** The configured reply to a decision the store answered with `result`. */
+    reply(result: ActionProposalMutationView, decision: 'approved' | 'rejected'): string;
+}
+
 /**
  * What a send does when its thread already has a turn running:
  *  - `'auto'` (default) — run now when the thread is idle, else wait in the thread's queue.
@@ -39,8 +86,14 @@ type ChatSendResult = {
     runId: string;
     threadId: string;
     queued?: undefined;
-} | QueuedSend;
+} | QueuedSend | {
+    threadId: string;
+    proposalDecision: unknown;
+    text: string;
+    queued?: undefined;
+};
 interface ChatParams {
+    uiCapabilities?: UiCapabilities;
     actor: Actor;
     message: string;
     threadId?: string;
@@ -103,7 +156,36 @@ declare class AgentService {
     private readonly quotaProvider?;
     private readonly options?;
     private readonly queue?;
-    constructor(runner: AgentRunner, store: AgentStore, deps: AgentDepsFactory, staging?: AttachmentStagingStore | undefined, models?: ModelCatalog | undefined, quotaProvider?: QuotaProvider | undefined, options?: Pick<AgentModuleOptions, "quota"> | undefined, queue?: ChatQueueService | undefined);
+    private readonly proposals?;
+    constructor(runner: AgentRunner, store: AgentStore, deps: AgentDepsFactory, staging?: AttachmentStagingStore | undefined, models?: ModelCatalog | undefined, quotaProvider?: QuotaProvider | undefined, options?: Pick<AgentModuleOptions, "quota" | "actionApprovalMode"> | undefined, queue?: ChatQueueService | undefined, proposals?: ActionProposalService | undefined);
+    /**
+     * 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.
+     */
+    decideActionProposal(actor: Actor, threadId: string, proposalId: string, command: {
+        decision: 'approved' | 'rejected';
+        remember?: boolean;
+        reason?: string;
+        via: string;
+    }): Promise<{
+        proposalDecision: ActionProposalMutationView;
+        text: string;
+    }>;
+    handleTextDecision(threadId: string, actor: Actor, text: string): Promise<{
+        status: "unmatched";
+    } | {
+        threadId: string;
+        proposalDecision: ActionProposalMutationView;
+        text: string;
+    } | {
+        threadId: string;
+        proposalDecision: {
+            status: "ambiguous";
+            proposalIds: string[];
+        };
+        text: string;
+    }>;
     /** The queue service when the bound store can hold a queue, else `undefined`. */
     private queueing;
     /** The queue service, or a 501 naming what is missing. */
@@ -149,7 +231,9 @@ declare class AgentService {
      * Send a message: start a turn, or — when its thread already has one running — queue the message
      * to run after it (see {@link ChatSendMode}). What `POST <base>/chat` calls.
      */
-    send(params: ChatParams): Promise<ChatSendResult>;
+    send(params: ChatParams, sendOptions?: {
+        textDecisions?: boolean;
+    }): Promise<ChatSendResult>;
     /**
      * Start a turn the thread is already claimed for, under the claimed id. A runner that minted an
      * id of its own anyway gets the thread re-pointed at it; one that fails to start frees the thread.
@@ -456,6 +540,15 @@ declare class AgUiRunHandler {
      * bad entry settles nothing.
      */
     private settle;
+    /**
+     * 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`.
+     */
+    private decideProposals;
+    /** Answer with a complete list of events, no run behind them. */
+    private writeEvents;
     /**
      * 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,
@@ -492,7 +585,24 @@ declare function agUiAdapter(options?: AgUiAdapterOptions): AgentProtocolAdapter
  */
 declare class AgentApprovalPortAdapter implements AgentApprovalPort {
     private readonly agent;
-    constructor(agent: AgentService);
+    private readonly proposals?;
+    constructor(agent: AgentService, proposals?: ActionProposalService | undefined);
+    approveActionProposal(actor: Actor, target: {
+        kind: 'proposal';
+        threadId: string;
+        proposalId: string;
+    }, opts?: {
+        remember?: boolean;
+        decidedVia?: string;
+    }): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationView>;
+    rejectActionProposal(actor: Actor, target: {
+        kind: 'proposal';
+        threadId: string;
+        proposalId: string;
+    }, opts?: {
+        reason?: string;
+        decidedVia?: string;
+    }): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationView>;
     approve(toolCallId: string, opts?: {
         executedByRef?: string;
         remember?: boolean;
@@ -581,6 +691,7 @@ declare class ConfigController {
 
 declare const AI_TOOL_METADATA: unique symbol;
 interface AiToolOptions {
+    replacementKey?: ToolSpec['replacementKey'];
     /**
      * What the model calls it. Omit → the class name, camelCased, with a trailing `Tool` dropped
      * (`GetWeatherTool` → `getWeather`).
@@ -1334,4 +1445,24 @@ declare class RunNotActiveException extends ConflictException {
     constructor(runId: string);
 }
 
-export { AGENT_CHAT_QUEUE, AGENT_METADATA, AI_TOOL_METADATA, ATTACHMENT_PAGE_SIZE, type AgUiAdapterOptions, AgUiRunHandler, Agent, AgentApprovalPortAdapter, AgentDepsFactory, AgentDiscoveryService, AgentModule, AgentModuleAsyncOptions, AgentModuleOptions, type AgentOptions, AgentProtocolAdapter, AgentService, AgentSkillsOptions, AiTool, AiToolDiscoveryService, type AiToolOptions, type AnonymousActorOptions, AnonymousActorResolver, type AttachmentLimits, AttachmentsController, type ChatParams, ChatQueueService, type ChatSendMode, type ChatSendResult, ConfigController, DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES, DEFAULT_MAX_ATTACHMENT_BYTES, type DeclaredSkill, HeaderActorResolver, InProcessTokenStreamSink, InlineAgentRunner, MAX_ATTACHMENTS_PER_MESSAGE, MemoriesController, MessagesController, ModelsController, QueueController, type QueuedSend, type RequestUserMapper, type ResolvedAiToolOptions, RunNotActiveException, SKILL_METADATA, SYSTEM_PROMPT_CONTRIBUTOR_METADATA, SYSTEM_PROMPT_METADATA, Skill, type SkillBody, SkillDiscoveryService, type SkillOptions, SkillsController, SystemPrompt, SystemPromptContributor, type ThreadDefaultAgentReader, type ThreadModelReader, type ThreadPersonaReader, ToolsController, agUiAdapter, attachmentLimits, declaredSkillProvider, defaultRequestUserMapper, readAgentMetadata, readAiToolMetadata, readSkillMetadata, requestUserActorResolver, resolveSkillsConfig, skillScope, threadPersona, toolNameFromClass };
+declare class ActionProposalController {
+    private readonly proposals;
+    private readonly actors;
+    constructor(proposals: ActionProposalService, actors: ActorResolver);
+    list(threadId: string, request: Request, cursor: unknown, response: Response): Promise<_dudousxd_nestjs_agent_core.ActionProposalView[]>;
+    approve(threadId: string, proposalId: string, request: Request, body: unknown): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationView>;
+    reject(threadId: string, proposalId: string, request: Request, body: unknown): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationView>;
+}
+
+declare class ActionProposalWorkerService implements OnModuleInit, OnModuleDestroy {
+    private readonly store;
+    private readonly options;
+    private readonly deps;
+    private worker;
+    private readonly logger;
+    constructor(store: AgentStore, options: AgentModuleOptions, deps: AgentDepsFactory);
+    onModuleInit(): void;
+    onModuleDestroy(): Promise<void>;
+}
+
+export { AGENT_CHAT_QUEUE, AGENT_METADATA, AI_TOOL_METADATA, ATTACHMENT_PAGE_SIZE, ActionProposalController, ActionProposalService, ActionProposalWorkerService, type AgUiAdapterOptions, AgUiRunHandler, Agent, AgentApprovalPortAdapter, AgentDepsFactory, AgentDiscoveryService, AgentModule, AgentModuleAsyncOptions, AgentModuleOptions, type AgentOptions, AgentProtocolAdapter, AgentService, AgentSkillsOptions, AiTool, AiToolDiscoveryService, type AiToolOptions, type AnonymousActorOptions, AnonymousActorResolver, type AttachmentLimits, AttachmentsController, type ChatParams, ChatQueueService, type ChatSendMode, type ChatSendResult, ConfigController, DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES, DEFAULT_MAX_ATTACHMENT_BYTES, type DeclaredSkill, HeaderActorResolver, InProcessTokenStreamSink, InlineAgentRunner, MAX_ATTACHMENTS_PER_MESSAGE, MemoriesController, MessagesController, ModelsController, QueueController, type QueuedSend, type RequestUserMapper, type ResolvedAiToolOptions, RunNotActiveException, SKILL_METADATA, SYSTEM_PROMPT_CONTRIBUTOR_METADATA, SYSTEM_PROMPT_METADATA, Skill, type SkillBody, SkillDiscoveryService, type SkillOptions, SkillsController, SystemPrompt, SystemPromptContributor, type ThreadDefaultAgentReader, type ThreadModelReader, type ThreadPersonaReader, ToolsController, agUiAdapter, attachmentLimits, declaredSkillProvider, defaultRequestUserMapper, readAgentMetadata, readAiToolMetadata, readSkillMetadata, requestUserActorResolver, resolveSkillsConfig, skillScope, threadPersona, toolNameFromClass };

package/dist/index.d.ts

@@ -1,17 +1,64 @@
-import { DynamicModule, Type, OnApplicationBootstrap, OnModuleInit, ConflictException } from '@nestjs/common';
-import { b as AgentModuleOptions, c as AgentModuleAsyncOptions, A as AgentDepsFactory, C as ChatQueueService, d as AgentProtocolAdapter, e as AgentSkillsOptions } from './chat-queue.service-C0hr7dqx.js';
-export { f as AGENT_TOOL_BRAND, g as AgentAttachmentsOptions, h as AgentDeps, i as AgentMemoryOptions, a as AgentSurface, F as FunctionalTool, L as LedgerQuotaProvider, Q as QueuePlan, j as QueueSettleOutcome, k as QueuedTurn, l as QueuedTurnStarter, m as QuotaLimits, n as QuotaWindowLimits, o as delegateToolName, p as provideAgentTool, q as provideAgentTools, u as utcDay } from './chat-queue.service-C0hr7dqx.js';
-import { AgentRunner, AgentStore, AttachmentStagingStore, ModelCatalog, QuotaProvider, Actor, QuotaReport, ModelCatalogView, AttachmentRef, PageContext, ChatQueueState, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, MessageFeedbackValue, MessageFeedback, StagedAttachment, ActorResolver, AgentApprovalPort, MessageAttachment, AgentAttachmentConfig, AgentClientConfig, ToolPresentation, AgentHistoryWindow, AgentIntake, Persona, SkillContext, ToolRegistry, AgentRegistry, PromptContributor, SkillsConfig, SkillCatalogEntry, ToolCatalogEntry, MemoryConfig, MemoryDigestEntry, SkillProvider, AgentRunInput, AgentRunStartOptions, TokenStreamSink, SinkWriter } from '@dudousxd/nestjs-agent-core';
+import { DynamicModule, Type, OnApplicationBootstrap, OnModuleInit, ConflictException, OnModuleDestroy } from '@nestjs/common';
+import { b as AgentModuleOptions, c as AgentModuleAsyncOptions, A as AgentDepsFactory, C as ChatQueueService, d as AgentProtocolAdapter, e as AgentSkillsOptions } from './chat-queue.service-CTyX_yNr.js';
+export { f as AGENT_TOOL_BRAND, g as AgentAttachmentsOptions, h as AgentDeps, i as AgentMemoryOptions, a as AgentSurface, F as FunctionalTool, L as LedgerQuotaProvider, Q as QueuePlan, j as QueueSettleOutcome, k as QueuedTurn, l as QueuedTurnStarter, m as QuotaLimits, n as QuotaWindowLimits, o as defineTool, p as delegateToolName, q as provideAgentTool, r as provideAgentTools, u as utcDay } from './chat-queue.service-CTyX_yNr.js';
+import * as _dudousxd_nestjs_agent_core from '@dudousxd/nestjs-agent-core';
+import { AgentStore, Actor, ListActionProposals, ActionProposalMutationView, AgentRunner, AttachmentStagingStore, ModelCatalog, QuotaProvider, QuotaReport, ModelCatalogView, AttachmentRef, PageContext, ChatQueueState, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, MessageFeedbackValue, MessageFeedback, StagedAttachment, ActorResolver, AgentApprovalPort, MessageAttachment, AgentAttachmentConfig, AgentClientConfig, ToolSpec, ToolPresentation, AgentHistoryWindow, AgentIntake, Persona, SkillContext, ToolRegistry, AgentRegistry, PromptContributor, SkillsConfig, SkillCatalogEntry, ToolCatalogEntry, MemoryConfig, MemoryDigestEntry, SkillProvider, AgentRunInput, AgentRunStartOptions, TokenStreamSink, SinkWriter } from '@dudousxd/nestjs-agent-core';
 export * from '@dudousxd/nestjs-agent-core';
+export { FunctionalToolDefinition } from '@dudousxd/nestjs-agent-core';
 import { Request, Response } from 'express';
+import { UiCapabilities } from '@dudousxd/nestjs-agent-core/genui';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { DiscoveryService, MetadataScanner } from '@nestjs/core';
+import './genui/index.js';
 
 declare class AgentModule {
     static forRoot(options: AgentModuleOptions): DynamicModule;
     static forRootAsync(options: AgentModuleAsyncOptions): DynamicModule;
 }
 
+declare class ActionProposalService {
+    private readonly store;
+    private readonly options;
+    constructor(store: AgentStore, options: Pick<AgentModuleOptions, 'approvalPolicy' | 'actionProposalText'>);
+    /** The words a text decision is made of, and what the agent answers — English unless configured. */
+    private readonly vocabulary;
+    private readonly replies;
+    private capability;
+    private scope;
+    private mayDecide;
+    listPage(threadId: string, actor: Actor, query?: Pick<ListActionProposals, 'after'>): Promise<{
+        next?: {
+            createdAt: number;
+            id: string;
+        };
+        items: _dudousxd_nestjs_agent_core.ActionProposalView[];
+    }>;
+    list(threadId: string, actor: Actor): Promise<_dudousxd_nestjs_agent_core.ActionProposalView[]>;
+    decide(threadId: string, proposalId: string, actor: Actor, command: {
+        decision: 'approved' | 'rejected';
+        remember?: boolean;
+        reason?: string;
+        via?: string;
+    }): Promise<ActionProposalMutationView>;
+    handleTextDecision(threadId: string, actor: Actor, text: string): Promise<{
+        status: "unmatched";
+    } | {
+        threadId: string;
+        proposalDecision: ActionProposalMutationView;
+        text: string;
+    } | {
+        threadId: string;
+        proposalDecision: {
+            status: "ambiguous";
+            proposalIds: string[];
+        };
+        text: string;
+    }>;
+    private textReceipt;
+    /** The configured reply to a decision the store answered with `result`. */
+    reply(result: ActionProposalMutationView, decision: 'approved' | 'rejected'): string;
+}
+
 /**
  * What a send does when its thread already has a turn running:
  *  - `'auto'` (default) — run now when the thread is idle, else wait in the thread's queue.
@@ -39,8 +86,14 @@ type ChatSendResult = {
     runId: string;
     threadId: string;
     queued?: undefined;
-} | QueuedSend;
+} | QueuedSend | {
+    threadId: string;
+    proposalDecision: unknown;
+    text: string;
+    queued?: undefined;
+};
 interface ChatParams {
+    uiCapabilities?: UiCapabilities;
     actor: Actor;
     message: string;
     threadId?: string;
@@ -103,7 +156,36 @@ declare class AgentService {
     private readonly quotaProvider?;
     private readonly options?;
     private readonly queue?;
-    constructor(runner: AgentRunner, store: AgentStore, deps: AgentDepsFactory, staging?: AttachmentStagingStore | undefined, models?: ModelCatalog | undefined, quotaProvider?: QuotaProvider | undefined, options?: Pick<AgentModuleOptions, "quota"> | undefined, queue?: ChatQueueService | undefined);
+    private readonly proposals?;
+    constructor(runner: AgentRunner, store: AgentStore, deps: AgentDepsFactory, staging?: AttachmentStagingStore | undefined, models?: ModelCatalog | undefined, quotaProvider?: QuotaProvider | undefined, options?: Pick<AgentModuleOptions, "quota" | "actionApprovalMode"> | undefined, queue?: ChatQueueService | undefined, proposals?: ActionProposalService | undefined);
+    /**
+     * 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.
+     */
+    decideActionProposal(actor: Actor, threadId: string, proposalId: string, command: {
+        decision: 'approved' | 'rejected';
+        remember?: boolean;
+        reason?: string;
+        via: string;
+    }): Promise<{
+        proposalDecision: ActionProposalMutationView;
+        text: string;
+    }>;
+    handleTextDecision(threadId: string, actor: Actor, text: string): Promise<{
+        status: "unmatched";
+    } | {
+        threadId: string;
+        proposalDecision: ActionProposalMutationView;
+        text: string;
+    } | {
+        threadId: string;
+        proposalDecision: {
+            status: "ambiguous";
+            proposalIds: string[];
+        };
+        text: string;
+    }>;
     /** The queue service when the bound store can hold a queue, else `undefined`. */
     private queueing;
     /** The queue service, or a 501 naming what is missing. */
@@ -149,7 +231,9 @@ declare class AgentService {
      * Send a message: start a turn, or — when its thread already has one running — queue the message
      * to run after it (see {@link ChatSendMode}). What `POST <base>/chat` calls.
      */
-    send(params: ChatParams): Promise<ChatSendResult>;
+    send(params: ChatParams, sendOptions?: {
+        textDecisions?: boolean;
+    }): Promise<ChatSendResult>;
     /**
      * Start a turn the thread is already claimed for, under the claimed id. A runner that minted an
      * id of its own anyway gets the thread re-pointed at it; one that fails to start frees the thread.
@@ -456,6 +540,15 @@ declare class AgUiRunHandler {
      * bad entry settles nothing.
      */
     private settle;
+    /**
+     * 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`.
+     */
+    private decideProposals;
+    /** Answer with a complete list of events, no run behind them. */
+    private writeEvents;
     /**
      * 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,
@@ -492,7 +585,24 @@ declare function agUiAdapter(options?: AgUiAdapterOptions): AgentProtocolAdapter
  */
 declare class AgentApprovalPortAdapter implements AgentApprovalPort {
     private readonly agent;
-    constructor(agent: AgentService);
+    private readonly proposals?;
+    constructor(agent: AgentService, proposals?: ActionProposalService | undefined);
+    approveActionProposal(actor: Actor, target: {
+        kind: 'proposal';
+        threadId: string;
+        proposalId: string;
+    }, opts?: {
+        remember?: boolean;
+        decidedVia?: string;
+    }): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationView>;
+    rejectActionProposal(actor: Actor, target: {
+        kind: 'proposal';
+        threadId: string;
+        proposalId: string;
+    }, opts?: {
+        reason?: string;
+        decidedVia?: string;
+    }): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationView>;
     approve(toolCallId: string, opts?: {
         executedByRef?: string;
         remember?: boolean;
@@ -581,6 +691,7 @@ declare class ConfigController {
 
 declare const AI_TOOL_METADATA: unique symbol;
 interface AiToolOptions {
+    replacementKey?: ToolSpec['replacementKey'];
     /**
      * What the model calls it. Omit → the class name, camelCased, with a trailing `Tool` dropped
      * (`GetWeatherTool` → `getWeather`).
@@ -1334,4 +1445,24 @@ declare class RunNotActiveException extends ConflictException {
     constructor(runId: string);
 }
 
-export { AGENT_CHAT_QUEUE, AGENT_METADATA, AI_TOOL_METADATA, ATTACHMENT_PAGE_SIZE, type AgUiAdapterOptions, AgUiRunHandler, Agent, AgentApprovalPortAdapter, AgentDepsFactory, AgentDiscoveryService, AgentModule, AgentModuleAsyncOptions, AgentModuleOptions, type AgentOptions, AgentProtocolAdapter, AgentService, AgentSkillsOptions, AiTool, AiToolDiscoveryService, type AiToolOptions, type AnonymousActorOptions, AnonymousActorResolver, type AttachmentLimits, AttachmentsController, type ChatParams, ChatQueueService, type ChatSendMode, type ChatSendResult, ConfigController, DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES, DEFAULT_MAX_ATTACHMENT_BYTES, type DeclaredSkill, HeaderActorResolver, InProcessTokenStreamSink, InlineAgentRunner, MAX_ATTACHMENTS_PER_MESSAGE, MemoriesController, MessagesController, ModelsController, QueueController, type QueuedSend, type RequestUserMapper, type ResolvedAiToolOptions, RunNotActiveException, SKILL_METADATA, SYSTEM_PROMPT_CONTRIBUTOR_METADATA, SYSTEM_PROMPT_METADATA, Skill, type SkillBody, SkillDiscoveryService, type SkillOptions, SkillsController, SystemPrompt, SystemPromptContributor, type ThreadDefaultAgentReader, type ThreadModelReader, type ThreadPersonaReader, ToolsController, agUiAdapter, attachmentLimits, declaredSkillProvider, defaultRequestUserMapper, readAgentMetadata, readAiToolMetadata, readSkillMetadata, requestUserActorResolver, resolveSkillsConfig, skillScope, threadPersona, toolNameFromClass };
+declare class ActionProposalController {
+    private readonly proposals;
+    private readonly actors;
+    constructor(proposals: ActionProposalService, actors: ActorResolver);
+    list(threadId: string, request: Request, cursor: unknown, response: Response): Promise<_dudousxd_nestjs_agent_core.ActionProposalView[]>;
+    approve(threadId: string, proposalId: string, request: Request, body: unknown): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationView>;
+    reject(threadId: string, proposalId: string, request: Request, body: unknown): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationView>;
+}
+
+declare class ActionProposalWorkerService implements OnModuleInit, OnModuleDestroy {
+    private readonly store;
+    private readonly options;
+    private readonly deps;
+    private worker;
+    private readonly logger;
+    constructor(store: AgentStore, options: AgentModuleOptions, deps: AgentDepsFactory);
+    onModuleInit(): void;
+    onModuleDestroy(): Promise<void>;
+}
+
+export { AGENT_CHAT_QUEUE, AGENT_METADATA, AI_TOOL_METADATA, ATTACHMENT_PAGE_SIZE, ActionProposalController, ActionProposalService, ActionProposalWorkerService, type AgUiAdapterOptions, AgUiRunHandler, Agent, AgentApprovalPortAdapter, AgentDepsFactory, AgentDiscoveryService, AgentModule, AgentModuleAsyncOptions, AgentModuleOptions, type AgentOptions, AgentProtocolAdapter, AgentService, AgentSkillsOptions, AiTool, AiToolDiscoveryService, type AiToolOptions, type AnonymousActorOptions, AnonymousActorResolver, type AttachmentLimits, AttachmentsController, type ChatParams, ChatQueueService, type ChatSendMode, type ChatSendResult, ConfigController, DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES, DEFAULT_MAX_ATTACHMENT_BYTES, type DeclaredSkill, HeaderActorResolver, InProcessTokenStreamSink, InlineAgentRunner, MAX_ATTACHMENTS_PER_MESSAGE, MemoriesController, MessagesController, ModelsController, QueueController, type QueuedSend, type RequestUserMapper, type ResolvedAiToolOptions, RunNotActiveException, SKILL_METADATA, SYSTEM_PROMPT_CONTRIBUTOR_METADATA, SYSTEM_PROMPT_METADATA, Skill, type SkillBody, SkillDiscoveryService, type SkillOptions, SkillsController, SystemPrompt, SystemPromptContributor, type ThreadDefaultAgentReader, type ThreadModelReader, type ThreadPersonaReader, ToolsController, agUiAdapter, attachmentLimits, declaredSkillProvider, defaultRequestUserMapper, readAgentMetadata, readAiToolMetadata, readSkillMetadata, requestUserActorResolver, resolveSkillsConfig, skillScope, threadPersona, toolNameFromClass };