@dudousxd/nestjs-agent-react 0.31.4 → 0.32.0

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 import * as ai from 'ai';
 import { ChatTransport, UIMessage, UIMessageChunk, DataUIPart, UIDataTypes } from 'ai';
-import { A as AgentRequestError, a as AgentBackend, U as UploadAttachmentOptions, C as ChatStreamRequest, b as ChatStreamResponse, H as HttpErrorListener, c as AttachmentUploadStrategy } from './client-BuobfZtx.cjs';
-export { d as AgentBackendUnsupportedError, e as AgentClient, f as AgentClientOptions, g as AgentConnection, h as AgentHttpError, i as CancelResult, M as MessageFeedbackInput, Q as QueuedMessageUpdate, j as QueuedSendResult, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-BuobfZtx.cjs';
-import { MessageAttachment, AgentClientConfig, AgentCatalogEntry, ModelCatalogEntry, ModelCatalogView, ModelCatalogLock, QuotaReport, QuotaWindow, QuotaBlock, QuotaWarning, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, QueuePause, ToolCatalogEntry } from '@dudousxd/nestjs-agent-core';
+import { A as AgentRequestError, a as AgentBackend, U as UploadAttachmentOptions, C as ChatStreamRequest, b as ChatStreamResponse, H as HttpErrorListener, c as AttachmentUploadStrategy } from './client-C7eu9WMJ.cjs';
+export { d as AgentBackendUnsupportedError, e as AgentClient, f as AgentClientOptions, g as AgentConnection, h as AgentHttpError, i as CancelResult, M as MessageFeedbackInput, Q as QueuedMessageUpdate, j as QueuedSendResult, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-C7eu9WMJ.cjs';
+import { MessageAttachment, AgentClientConfig, AgentCatalogEntry, PersonaCatalogEntry, ModelCatalogEntry, ModelCatalogView, ModelCatalogLock, QuotaReport, QuotaWindow, QuotaBlock, QuotaWarning, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, QueuePause, ToolCatalogEntry } from '@dudousxd/nestjs-agent-core';
 export { ALL_AGENTS, ChatQueueState, ElicitationInput, ElicitationInputType, QueuePause, QueuePauseReason, QueuedMessageView, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
 import * as React from 'react';
 import React__default, { ReactNode, Context } from 'react';
@@ -107,6 +107,8 @@ interface AgentChatTransportOptions {
     credentials?: RequestCredentials;
     /** Named agent to run the turn (backend `agent` field). */
     agent?: string;
+    /** One of the agent's personas to answer as (backend `persona` field). */
+    persona?: string;
     /**
      * Extra body fields evaluated per send — the hook injects `threadId`
      * and `pageContext` through this. Returned object is spread into the
@@ -542,13 +544,21 @@ interface AgentsState {
     agents: AgentCatalogEntry[];
     /** The agent a turn runs as when none is named. */
     defaultAgent: string | null;
+    /**
+     * An agent's personas — the data behind a persona picker. `agent` omitted → the default agent's.
+     * `[]` for an agent that declares none (or before the list loads).
+     */
+    personasOf: (agent?: string) => PersonaCatalogEntry[];
+    /** The persona `agent` (default: the default agent) runs under when a send names none, or `null`. */
+    defaultPersonaOf: (agent?: string) => string | null;
     isLoading: boolean;
     error: Error | null;
     refresh: () => Promise<void>;
 }
 /**
- * The registered agents (`GET <base>/agents`) — the data behind an agent picker. Send the pick as
- * `useAgentChat({ agent })`, or pin it on a thread with `PATCH <base>/threads/:id { defaultAgent }`.
+ * The registered agents (`GET <base>/agents`) — the data behind an agent picker, and each agent's
+ * personas behind a persona picker. Send the pick as `useAgentChat({ agent, persona })`, or pin it on
+ * a thread with `PATCH <base>/threads/:id { defaultAgent, persona }`.
  */
 declare function useAgents(options?: UseAgentsOptions): AgentsState;
 
@@ -1653,6 +1663,10 @@ interface AgentMessageMetadata extends Partial<StoredTurnMetadata> {
     costUsd?: number | null;
     /** ISO timestamp: the stored row's `createdAt` (a merged turn: its first row's), or when a live turn started streaming. */
     createdAt?: string;
+    /** The agent that wrote a replayed message, when the row names one (`StoredMessage.agentName`). */
+    agentName?: string;
+    /** The persona the turn that wrote a replayed message ran under (`StoredMessage.persona`). */
+    persona?: string;
     /** Host-defined keys: `StoredMessage.metadata` and the stream's `message-metadata` frames. */
     [key: string]: unknown;
 }
@@ -1710,6 +1724,13 @@ interface UseAgentChatOptions<B extends AgentBackend = AgentBackend> {
     reconnect?: ReconnectOptions | false;
     /** Named agent to run each turn. */
     agent?: string;
+    /**
+     * One of the agent's personas (`GET <base>/agents` lists them) to answer as. Read per send, so a
+     * picker can switch it between messages; the server pins it on the thread, and `threadPersona`
+     * reports it back. Omitted → the thread's pinned persona, else the agent's default. A single send
+     * can name its own: `sendMessage(message, { body: { persona } })`.
+     */
+    persona?: string;
     /**
      * Thread this chat is bound to. Omitted → the backend creates one on the first send
      * ({@link UseAgentChatOptions.onThreadCreated}). Changing it switches the chat to that thread:
@@ -1971,6 +1992,11 @@ declare function useAgentChat<B extends AgentBackend = AgentBackend>(options?: U
     queue: ChatQueue;
     /** The model picker: `list`, `selected`, `select(id)`, `pinToThread(id)`. */
     models: ChatModels;
+    /**
+     * The persona pinned on this thread (`ThreadSummary.persona`), or `null` when none is — what a
+     * persona picker on a reopened thread starts from (`?? agent.defaultPersona`).
+     */
+    threadPersona: string | null;
     /** The caller's budget (`GET <base>/quota`); `quota.blocked` gates sends. */
     quota: QuotaState;
     /** The window blocking sends right now (the `blocked` option, else the quota report's). */

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import * as ai from 'ai';
 import { ChatTransport, UIMessage, UIMessageChunk, DataUIPart, UIDataTypes } from 'ai';
-import { A as AgentRequestError, a as AgentBackend, U as UploadAttachmentOptions, C as ChatStreamRequest, b as ChatStreamResponse, H as HttpErrorListener, c as AttachmentUploadStrategy } from './client-BuobfZtx.js';
-export { d as AgentBackendUnsupportedError, e as AgentClient, f as AgentClientOptions, g as AgentConnection, h as AgentHttpError, i as CancelResult, M as MessageFeedbackInput, Q as QueuedMessageUpdate, j as QueuedSendResult, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-BuobfZtx.js';
-import { MessageAttachment, AgentClientConfig, AgentCatalogEntry, ModelCatalogEntry, ModelCatalogView, ModelCatalogLock, QuotaReport, QuotaWindow, QuotaBlock, QuotaWarning, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, QueuePause, ToolCatalogEntry } from '@dudousxd/nestjs-agent-core';
+import { A as AgentRequestError, a as AgentBackend, U as UploadAttachmentOptions, C as ChatStreamRequest, b as ChatStreamResponse, H as HttpErrorListener, c as AttachmentUploadStrategy } from './client-C7eu9WMJ.js';
+export { d as AgentBackendUnsupportedError, e as AgentClient, f as AgentClientOptions, g as AgentConnection, h as AgentHttpError, i as CancelResult, M as MessageFeedbackInput, Q as QueuedMessageUpdate, j as QueuedSendResult, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-C7eu9WMJ.js';
+import { MessageAttachment, AgentClientConfig, AgentCatalogEntry, PersonaCatalogEntry, ModelCatalogEntry, ModelCatalogView, ModelCatalogLock, QuotaReport, QuotaWindow, QuotaBlock, QuotaWarning, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, QueuePause, ToolCatalogEntry } from '@dudousxd/nestjs-agent-core';
 export { ALL_AGENTS, ChatQueueState, ElicitationInput, ElicitationInputType, QueuePause, QueuePauseReason, QueuedMessageView, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
 import * as React from 'react';
 import React__default, { ReactNode, Context } from 'react';
@@ -107,6 +107,8 @@ interface AgentChatTransportOptions {
     credentials?: RequestCredentials;
     /** Named agent to run the turn (backend `agent` field). */
     agent?: string;
+    /** One of the agent's personas to answer as (backend `persona` field). */
+    persona?: string;
     /**
      * Extra body fields evaluated per send — the hook injects `threadId`
      * and `pageContext` through this. Returned object is spread into the
@@ -542,13 +544,21 @@ interface AgentsState {
     agents: AgentCatalogEntry[];
     /** The agent a turn runs as when none is named. */
     defaultAgent: string | null;
+    /**
+     * An agent's personas — the data behind a persona picker. `agent` omitted → the default agent's.
+     * `[]` for an agent that declares none (or before the list loads).
+     */
+    personasOf: (agent?: string) => PersonaCatalogEntry[];
+    /** The persona `agent` (default: the default agent) runs under when a send names none, or `null`. */
+    defaultPersonaOf: (agent?: string) => string | null;
     isLoading: boolean;
     error: Error | null;
     refresh: () => Promise<void>;
 }
 /**
- * The registered agents (`GET <base>/agents`) — the data behind an agent picker. Send the pick as
- * `useAgentChat({ agent })`, or pin it on a thread with `PATCH <base>/threads/:id { defaultAgent }`.
+ * The registered agents (`GET <base>/agents`) — the data behind an agent picker, and each agent's
+ * personas behind a persona picker. Send the pick as `useAgentChat({ agent, persona })`, or pin it on
+ * a thread with `PATCH <base>/threads/:id { defaultAgent, persona }`.
  */
 declare function useAgents(options?: UseAgentsOptions): AgentsState;
 
@@ -1653,6 +1663,10 @@ interface AgentMessageMetadata extends Partial<StoredTurnMetadata> {
     costUsd?: number | null;
     /** ISO timestamp: the stored row's `createdAt` (a merged turn: its first row's), or when a live turn started streaming. */
     createdAt?: string;
+    /** The agent that wrote a replayed message, when the row names one (`StoredMessage.agentName`). */
+    agentName?: string;
+    /** The persona the turn that wrote a replayed message ran under (`StoredMessage.persona`). */
+    persona?: string;
     /** Host-defined keys: `StoredMessage.metadata` and the stream's `message-metadata` frames. */
     [key: string]: unknown;
 }
@@ -1710,6 +1724,13 @@ interface UseAgentChatOptions<B extends AgentBackend = AgentBackend> {
     reconnect?: ReconnectOptions | false;
     /** Named agent to run each turn. */
     agent?: string;
+    /**
+     * One of the agent's personas (`GET <base>/agents` lists them) to answer as. Read per send, so a
+     * picker can switch it between messages; the server pins it on the thread, and `threadPersona`
+     * reports it back. Omitted → the thread's pinned persona, else the agent's default. A single send
+     * can name its own: `sendMessage(message, { body: { persona } })`.
+     */
+    persona?: string;
     /**
      * Thread this chat is bound to. Omitted → the backend creates one on the first send
      * ({@link UseAgentChatOptions.onThreadCreated}). Changing it switches the chat to that thread:
@@ -1971,6 +1992,11 @@ declare function useAgentChat<B extends AgentBackend = AgentBackend>(options?: U
     queue: ChatQueue;
     /** The model picker: `list`, `selected`, `select(id)`, `pinToThread(id)`. */
     models: ChatModels;
+    /**
+     * The persona pinned on this thread (`ThreadSummary.persona`), or `null` when none is — what a
+     * persona picker on a reopened thread starts from (`?? agent.defaultPersona`).
+     */
+    threadPersona: string | null;
     /** The caller's budget (`GET <base>/quota`); `quota.blocked` gates sends. */
     quota: QuotaState;
     /** The window blocking sends right now (the `blocked` option, else the quota report's). */