@dudousxd/nestjs-agent 1.21.0 → 1.23.0

package/dist/index.d.cts

@@ -1,9 +1,10 @@
 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-CGsR40Ct.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-CGsR40Ct.cjs';
+import { b as AgentModuleOptions, c as AgentModuleAsyncOptions, A as AgentDepsFactory, C as ChatQueueService, d as AgentProtocolAdapter, e as AgentSkillsOptions } from './chat-queue.service-D1z3WjFI.cjs';
+export { f as AGENT_TOOL_BRAND, g as AgentAttachmentsOptions, h as AgentDeps, i as AgentEngine, j as AgentMemoryOptions, a as AgentSurface, F as FunctionalTool, L as LedgerQuotaProvider, Q as QueuePlan, k as QueueSettleOutcome, l as QueuedTurn, m as QueuedTurnStarter, n as QuotaLimits, o as QuotaWindowLimits, p as defineTool, q as delegateToolName, r as provideAgentTool, s as provideAgentTools, u as utcDay } from './chat-queue.service-D1z3WjFI.cjs';
 import * as _dudousxd_nestjs_agent_core from '@dudousxd/nestjs-agent-core';
-import { AgentStore, Actor, ListActionProposals, ActionProposalMutationResult, 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';
+import { AgentStore, Actor, ListActionProposals, ActionProposalMutationView, AgentRunner, AttachmentStagingStore, ModelCatalog, QuotaProvider, QuotaReport, ModelCatalogView, AgentHostContext, 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';
@@ -18,7 +19,10 @@ declare class AgentModule {
 declare class ActionProposalService {
     private readonly store;
     private readonly options;
-    constructor(store: AgentStore, options: Pick<AgentModuleOptions, 'approvalPolicy'>);
+    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;
@@ -27,20 +31,20 @@ declare class ActionProposalService {
             createdAt: number;
             id: string;
         };
-        items: _dudousxd_nestjs_agent_core.ActionProposal[];
+        items: _dudousxd_nestjs_agent_core.ActionProposalView[];
     }>;
-    list(threadId: string, actor: Actor): Promise<_dudousxd_nestjs_agent_core.ActionProposal[]>;
+    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<ActionProposalMutationResult>;
+    }): Promise<ActionProposalMutationView>;
     handleTextDecision(threadId: string, actor: Actor, text: string): Promise<{
         status: "unmatched";
     } | {
         threadId: string;
-        proposalDecision: ActionProposalMutationResult;
+        proposalDecision: ActionProposalMutationView;
         text: string;
     } | {
         threadId: string;
@@ -51,6 +55,8 @@ declare class ActionProposalService {
         text: string;
     }>;
     private textReceipt;
+    /** The configured reply to a decision the store answered with `result`. */
+    reply(result: ActionProposalMutationView, decision: 'approved' | 'rejected'): string;
 }
 
 /**
@@ -90,6 +96,14 @@ interface ChatParams {
     uiCapabilities?: UiCapabilities;
     actor: Actor;
     message: string;
+    /** The host's own facts about this send — see `AgentRunInput.hostContext`. */
+    hostContext?: AgentHostContext;
+    /**
+     * The HOST already decided this actor may write this thread — a chat-app thread several people
+     * share, where anyone in it may continue the conversation. Skips the thread-ownership check of a
+     * send; never set it from a request's own claim.
+     */
+    authorized?: boolean;
     threadId?: string;
     agentName?: string;
     /**
@@ -152,11 +166,25 @@ declare class AgentService {
     private readonly queue?;
     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: _dudousxd_nestjs_agent_core.ActionProposalMutationResult;
+        proposalDecision: ActionProposalMutationView;
         text: string;
     } | {
         threadId: string;
@@ -520,6 +548,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,
@@ -565,7 +602,7 @@ declare class AgentApprovalPortAdapter implements AgentApprovalPort {
     }, opts?: {
         remember?: boolean;
         decidedVia?: string;
-    }): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationResult>;
+    }): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationView>;
     rejectActionProposal(actor: Actor, target: {
         kind: 'proposal';
         threadId: string;
@@ -573,7 +610,7 @@ declare class AgentApprovalPortAdapter implements AgentApprovalPort {
     }, opts?: {
         reason?: string;
         decidedVia?: string;
-    }): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationResult>;
+    }): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationView>;
     approve(toolCallId: string, opts?: {
         executedByRef?: string;
         remember?: boolean;
@@ -1420,9 +1457,9 @@ 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.ActionProposal[]>;
-    approve(threadId: string, proposalId: string, request: Request, body: unknown): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationResult>;
-    reject(threadId: string, proposalId: string, request: Request, body: unknown): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationResult>;
+    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 {

package/dist/index.d.ts

@@ -1,9 +1,10 @@
 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-XG9RQCjU.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-XG9RQCjU.js';
+import { b as AgentModuleOptions, c as AgentModuleAsyncOptions, A as AgentDepsFactory, C as ChatQueueService, d as AgentProtocolAdapter, e as AgentSkillsOptions } from './chat-queue.service-CwxJDrBM.js';
+export { f as AGENT_TOOL_BRAND, g as AgentAttachmentsOptions, h as AgentDeps, i as AgentEngine, j as AgentMemoryOptions, a as AgentSurface, F as FunctionalTool, L as LedgerQuotaProvider, Q as QueuePlan, k as QueueSettleOutcome, l as QueuedTurn, m as QueuedTurnStarter, n as QuotaLimits, o as QuotaWindowLimits, p as defineTool, q as delegateToolName, r as provideAgentTool, s as provideAgentTools, u as utcDay } from './chat-queue.service-CwxJDrBM.js';
 import * as _dudousxd_nestjs_agent_core from '@dudousxd/nestjs-agent-core';
-import { AgentStore, Actor, ListActionProposals, ActionProposalMutationResult, 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';
+import { AgentStore, Actor, ListActionProposals, ActionProposalMutationView, AgentRunner, AttachmentStagingStore, ModelCatalog, QuotaProvider, QuotaReport, ModelCatalogView, AgentHostContext, 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';
@@ -18,7 +19,10 @@ declare class AgentModule {
 declare class ActionProposalService {
     private readonly store;
     private readonly options;
-    constructor(store: AgentStore, options: Pick<AgentModuleOptions, 'approvalPolicy'>);
+    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;
@@ -27,20 +31,20 @@ declare class ActionProposalService {
             createdAt: number;
             id: string;
         };
-        items: _dudousxd_nestjs_agent_core.ActionProposal[];
+        items: _dudousxd_nestjs_agent_core.ActionProposalView[];
     }>;
-    list(threadId: string, actor: Actor): Promise<_dudousxd_nestjs_agent_core.ActionProposal[]>;
+    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<ActionProposalMutationResult>;
+    }): Promise<ActionProposalMutationView>;
     handleTextDecision(threadId: string, actor: Actor, text: string): Promise<{
         status: "unmatched";
     } | {
         threadId: string;
-        proposalDecision: ActionProposalMutationResult;
+        proposalDecision: ActionProposalMutationView;
         text: string;
     } | {
         threadId: string;
@@ -51,6 +55,8 @@ declare class ActionProposalService {
         text: string;
     }>;
     private textReceipt;
+    /** The configured reply to a decision the store answered with `result`. */
+    reply(result: ActionProposalMutationView, decision: 'approved' | 'rejected'): string;
 }
 
 /**
@@ -90,6 +96,14 @@ interface ChatParams {
     uiCapabilities?: UiCapabilities;
     actor: Actor;
     message: string;
+    /** The host's own facts about this send — see `AgentRunInput.hostContext`. */
+    hostContext?: AgentHostContext;
+    /**
+     * The HOST already decided this actor may write this thread — a chat-app thread several people
+     * share, where anyone in it may continue the conversation. Skips the thread-ownership check of a
+     * send; never set it from a request's own claim.
+     */
+    authorized?: boolean;
     threadId?: string;
     agentName?: string;
     /**
@@ -152,11 +166,25 @@ declare class AgentService {
     private readonly queue?;
     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: _dudousxd_nestjs_agent_core.ActionProposalMutationResult;
+        proposalDecision: ActionProposalMutationView;
         text: string;
     } | {
         threadId: string;
@@ -520,6 +548,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,
@@ -565,7 +602,7 @@ declare class AgentApprovalPortAdapter implements AgentApprovalPort {
     }, opts?: {
         remember?: boolean;
         decidedVia?: string;
-    }): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationResult>;
+    }): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationView>;
     rejectActionProposal(actor: Actor, target: {
         kind: 'proposal';
         threadId: string;
@@ -573,7 +610,7 @@ declare class AgentApprovalPortAdapter implements AgentApprovalPort {
     }, opts?: {
         reason?: string;
         decidedVia?: string;
-    }): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationResult>;
+    }): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationView>;
     approve(toolCallId: string, opts?: {
         executedByRef?: string;
         remember?: boolean;
@@ -1420,9 +1457,9 @@ 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.ActionProposal[]>;
-    approve(threadId: string, proposalId: string, request: Request, body: unknown): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationResult>;
-    reject(threadId: string, proposalId: string, request: Request, body: unknown): Promise<_dudousxd_nestjs_agent_core.ActionProposalMutationResult>;
+    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 {