@dudousxd/nestjs-agent 1.4.0 → 1.6.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { DynamicModule, OnModuleInit, Type, OnApplicationBootstrap } from '@nestjs/common';
 import { b as AgentModuleOptions, c as AgentModuleAsyncOptions, A as AgentDepsFactory, d as AgentSkillsOptions } from './agent-deps.factory-CUyVPsa1.cjs';
 export { e as AGENT_TOOL_BRAND, f as AgentAttachmentsOptions, g as AgentDeps, h as AgentMemoryOptions, a as AgentSurface, F as FunctionalTool, i as delegateToolName, p as provideAgentTool, u as utcDay } from './agent-deps.factory-CUyVPsa1.cjs';
-import { AgentRunner, AgentStore, QuotaStore, AttachmentStagingStore, Actor, AttachmentRef, PageContext, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, StagedAttachment, QuotaView, AgentApprovalPort, ActorResolver, MessageAttachment, ToolPresentation, AgentHistoryWindow, AgentIntake, SkillContext, ToolRegistry, AgentRegistry, PromptContributor, SkillsConfig, SkillCatalogEntry, ToolCatalogEntry, MemoryConfig, MemoryDigestEntry, SkillProvider, AgentRunInput, TokenStreamSink, SinkWriter, QuotaState } from '@dudousxd/nestjs-agent-core';
+import { AgentRunner, AgentStore, QuotaStore, AttachmentStagingStore, Actor, AttachmentRef, PageContext, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, MessageFeedbackValue, MessageFeedback, StagedAttachment, QuotaView, AgentApprovalPort, ActorResolver, MessageAttachment, ToolPresentation, AgentHistoryWindow, AgentIntake, SkillContext, ToolRegistry, AgentRegistry, PromptContributor, SkillsConfig, SkillCatalogEntry, ToolCatalogEntry, MemoryConfig, MemoryDigestEntry, SkillProvider, AgentRunInput, TokenStreamSink, SinkWriter, QuotaState } from '@dudousxd/nestjs-agent-core';
 export * from '@dudousxd/nestjs-agent-core';
 import { Request } from 'express';
 import { StandardSchemaV1 } from '@standard-schema/spec';
@@ -152,6 +152,15 @@ declare class AgentService {
      * thread-scoped mutations.
      */
     truncateThreadFrom(actor: Actor, threadId: string, messageId: string): Promise<void>;
+    /**
+     * Rate a message in one of `actor`'s threads: `'up'`/`'down'` with an optional comment, or `null`
+     * to clear the rating. Answers `404` for an unknown message, `403` for another actor's, and `501`
+     * on a store without `threadOfMessage` + `setMessageFeedback`.
+     */
+    setMessageFeedback(actor: Actor, messageId: string, input: {
+        value: MessageFeedbackValue | null;
+        comment?: string;
+    }): Promise<MessageFeedback | null>;
     /**
      * Every file this actor has staged, newest first — across threads, including uploads that were
      * never sent, which nothing else on this surface can see.
@@ -368,6 +377,11 @@ interface AiToolOptions {
      * ```
      */
     presentation?: ToolPresentation;
+    /**
+     * The turn ends once a call to this tool succeeds — no model call afterwards to narrate what the
+     * tool already showed (a composed UI answer, a hand-off). See `ToolSpec.terminal`.
+     */
+    terminal?: boolean;
 }
 /**
  * Marks a provider class as an AI tool. The class must implement `execute(input, ctx)`.
@@ -663,6 +677,24 @@ declare class SkillsController {
     threadId?: string): Promise<SkillCatalogEntry[]>;
 }
 
+interface FeedbackBody {
+    /** `null` clears the rating. */
+    value: MessageFeedbackValue | null;
+    comment?: string;
+}
+declare class MessagesController {
+    private readonly agent;
+    private readonly actorResolver;
+    constructor(agent: AgentService, actorResolver: ActorResolver);
+    /**
+     * Rate a message: `{ value: 'up' | 'down' | null, comment? }`. Answers the stored rating
+     * (`{ feedback: null }` once cleared). Only the thread's owner may rate its messages.
+     */
+    feedback(req: Request, id: string, body: FeedbackBody): Promise<{
+        feedback: MessageFeedback | null;
+    }>;
+}
+
 /**
  * The tools THIS caller can reach through an agent, with how a chat surface should talk about each
  * one (`@AiTool({ presentation })`) — so a client narrates "Querying orders" instead of printing
@@ -866,4 +898,4 @@ declare class HeaderActorResolver implements ActorResolver {
     resolve(req: unknown): Actor;
 }
 
-export { AGENT_METADATA, AI_TOOL_METADATA, ATTACHMENT_PAGE_SIZE, Agent, AgentApprovalPortAdapter, AgentDepsFactory, AgentDiscoveryService, AgentModule, AgentModuleAsyncOptions, AgentModuleOptions, type AgentOptions, AgentService, AgentSkillsOptions, AiTool, AiToolDiscoveryService, type AiToolOptions, AttachmentsController, type ChatParams, DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES, DEFAULT_MAX_ATTACHMENT_BYTES, type DeclaredSkill, HeaderActorResolver, InProcessTokenStreamSink, InlineAgentRunner, LedgerQuotaStore, MemoriesController, SKILL_METADATA, SYSTEM_PROMPT_CONTRIBUTOR_METADATA, SYSTEM_PROMPT_METADATA, Skill, type SkillBody, SkillDiscoveryService, type SkillOptions, SkillsController, SystemPrompt, SystemPromptContributor, type ThreadDefaultAgentReader, ToolsController, declaredSkillProvider, readAgentMetadata, readAiToolMetadata, readSkillMetadata, resolveSkillsConfig, skillScope };
+export { AGENT_METADATA, AI_TOOL_METADATA, ATTACHMENT_PAGE_SIZE, Agent, AgentApprovalPortAdapter, AgentDepsFactory, AgentDiscoveryService, AgentModule, AgentModuleAsyncOptions, AgentModuleOptions, type AgentOptions, AgentService, AgentSkillsOptions, AiTool, AiToolDiscoveryService, type AiToolOptions, AttachmentsController, type ChatParams, DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES, DEFAULT_MAX_ATTACHMENT_BYTES, type DeclaredSkill, HeaderActorResolver, InProcessTokenStreamSink, InlineAgentRunner, LedgerQuotaStore, MemoriesController, MessagesController, SKILL_METADATA, SYSTEM_PROMPT_CONTRIBUTOR_METADATA, SYSTEM_PROMPT_METADATA, Skill, type SkillBody, SkillDiscoveryService, type SkillOptions, SkillsController, SystemPrompt, SystemPromptContributor, type ThreadDefaultAgentReader, ToolsController, declaredSkillProvider, readAgentMetadata, readAiToolMetadata, readSkillMetadata, resolveSkillsConfig, skillScope };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { DynamicModule, OnModuleInit, Type, OnApplicationBootstrap } from '@nestjs/common';
 import { b as AgentModuleOptions, c as AgentModuleAsyncOptions, A as AgentDepsFactory, d as AgentSkillsOptions } from './agent-deps.factory-CUyVPsa1.js';
 export { e as AGENT_TOOL_BRAND, f as AgentAttachmentsOptions, g as AgentDeps, h as AgentMemoryOptions, a as AgentSurface, F as FunctionalTool, i as delegateToolName, p as provideAgentTool, u as utcDay } from './agent-deps.factory-CUyVPsa1.js';
-import { AgentRunner, AgentStore, QuotaStore, AttachmentStagingStore, Actor, AttachmentRef, PageContext, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, StagedAttachment, QuotaView, AgentApprovalPort, ActorResolver, MessageAttachment, ToolPresentation, AgentHistoryWindow, AgentIntake, SkillContext, ToolRegistry, AgentRegistry, PromptContributor, SkillsConfig, SkillCatalogEntry, ToolCatalogEntry, MemoryConfig, MemoryDigestEntry, SkillProvider, AgentRunInput, TokenStreamSink, SinkWriter, QuotaState } from '@dudousxd/nestjs-agent-core';
+import { AgentRunner, AgentStore, QuotaStore, AttachmentStagingStore, Actor, AttachmentRef, PageContext, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, MessageFeedbackValue, MessageFeedback, StagedAttachment, QuotaView, AgentApprovalPort, ActorResolver, MessageAttachment, ToolPresentation, AgentHistoryWindow, AgentIntake, SkillContext, ToolRegistry, AgentRegistry, PromptContributor, SkillsConfig, SkillCatalogEntry, ToolCatalogEntry, MemoryConfig, MemoryDigestEntry, SkillProvider, AgentRunInput, TokenStreamSink, SinkWriter, QuotaState } from '@dudousxd/nestjs-agent-core';
 export * from '@dudousxd/nestjs-agent-core';
 import { Request } from 'express';
 import { StandardSchemaV1 } from '@standard-schema/spec';
@@ -152,6 +152,15 @@ declare class AgentService {
      * thread-scoped mutations.
      */
     truncateThreadFrom(actor: Actor, threadId: string, messageId: string): Promise<void>;
+    /**
+     * Rate a message in one of `actor`'s threads: `'up'`/`'down'` with an optional comment, or `null`
+     * to clear the rating. Answers `404` for an unknown message, `403` for another actor's, and `501`
+     * on a store without `threadOfMessage` + `setMessageFeedback`.
+     */
+    setMessageFeedback(actor: Actor, messageId: string, input: {
+        value: MessageFeedbackValue | null;
+        comment?: string;
+    }): Promise<MessageFeedback | null>;
     /**
      * Every file this actor has staged, newest first — across threads, including uploads that were
      * never sent, which nothing else on this surface can see.
@@ -368,6 +377,11 @@ interface AiToolOptions {
      * ```
      */
     presentation?: ToolPresentation;
+    /**
+     * The turn ends once a call to this tool succeeds — no model call afterwards to narrate what the
+     * tool already showed (a composed UI answer, a hand-off). See `ToolSpec.terminal`.
+     */
+    terminal?: boolean;
 }
 /**
  * Marks a provider class as an AI tool. The class must implement `execute(input, ctx)`.
@@ -663,6 +677,24 @@ declare class SkillsController {
     threadId?: string): Promise<SkillCatalogEntry[]>;
 }
 
+interface FeedbackBody {
+    /** `null` clears the rating. */
+    value: MessageFeedbackValue | null;
+    comment?: string;
+}
+declare class MessagesController {
+    private readonly agent;
+    private readonly actorResolver;
+    constructor(agent: AgentService, actorResolver: ActorResolver);
+    /**
+     * Rate a message: `{ value: 'up' | 'down' | null, comment? }`. Answers the stored rating
+     * (`{ feedback: null }` once cleared). Only the thread's owner may rate its messages.
+     */
+    feedback(req: Request, id: string, body: FeedbackBody): Promise<{
+        feedback: MessageFeedback | null;
+    }>;
+}
+
 /**
  * The tools THIS caller can reach through an agent, with how a chat surface should talk about each
  * one (`@AiTool({ presentation })`) — so a client narrates "Querying orders" instead of printing
@@ -866,4 +898,4 @@ declare class HeaderActorResolver implements ActorResolver {
     resolve(req: unknown): Actor;
 }
 
-export { AGENT_METADATA, AI_TOOL_METADATA, ATTACHMENT_PAGE_SIZE, Agent, AgentApprovalPortAdapter, AgentDepsFactory, AgentDiscoveryService, AgentModule, AgentModuleAsyncOptions, AgentModuleOptions, type AgentOptions, AgentService, AgentSkillsOptions, AiTool, AiToolDiscoveryService, type AiToolOptions, AttachmentsController, type ChatParams, DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES, DEFAULT_MAX_ATTACHMENT_BYTES, type DeclaredSkill, HeaderActorResolver, InProcessTokenStreamSink, InlineAgentRunner, LedgerQuotaStore, MemoriesController, SKILL_METADATA, SYSTEM_PROMPT_CONTRIBUTOR_METADATA, SYSTEM_PROMPT_METADATA, Skill, type SkillBody, SkillDiscoveryService, type SkillOptions, SkillsController, SystemPrompt, SystemPromptContributor, type ThreadDefaultAgentReader, ToolsController, declaredSkillProvider, readAgentMetadata, readAiToolMetadata, readSkillMetadata, resolveSkillsConfig, skillScope };
+export { AGENT_METADATA, AI_TOOL_METADATA, ATTACHMENT_PAGE_SIZE, Agent, AgentApprovalPortAdapter, AgentDepsFactory, AgentDiscoveryService, AgentModule, AgentModuleAsyncOptions, AgentModuleOptions, type AgentOptions, AgentService, AgentSkillsOptions, AiTool, AiToolDiscoveryService, type AiToolOptions, AttachmentsController, type ChatParams, DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES, DEFAULT_MAX_ATTACHMENT_BYTES, type DeclaredSkill, HeaderActorResolver, InProcessTokenStreamSink, InlineAgentRunner, LedgerQuotaStore, MemoriesController, MessagesController, SKILL_METADATA, SYSTEM_PROMPT_CONTRIBUTOR_METADATA, SYSTEM_PROMPT_METADATA, Skill, type SkillBody, SkillDiscoveryService, type SkillOptions, SkillsController, SystemPrompt, SystemPromptContributor, type ThreadDefaultAgentReader, ToolsController, declaredSkillProvider, readAgentMetadata, readAiToolMetadata, readSkillMetadata, resolveSkillsConfig, skillScope };