@dudousxd/nestjs-agent-react 0.31.5 → 0.33.0

package/dist/index.d.cts

@@ -1,13 +1,15 @@
 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-B6EE8-AC.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-B6EE8-AC.cjs';
+import { MessageAttachment, AgentClientConfig, AgentCatalogEntry, PersonaCatalogEntry, ModelCatalogEntry, ModelCatalogView, ModelCatalogLock, QuotaReport, QuotaWindow, QuotaBlock, QuotaWarning, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, QueuePause, ToolCatalogEntry, ActionProposal } 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';
-import { o as GenuiProviderValue, T as TranscriptUiBlock, A as ApproveOptions, t as TranscriptBlock, U as UsageSummary, v as TimestampInfo, C as ChatStatus, w as TranscriptFile, M as MessageUsageInfo, x as ToolCatalog, y as AnyToolUIPart } from './generative-ui-VTZ1EADD.cjs';
-export { z as ApprovalBlockOptions, B as BuildBlocksOptions, D as CoercibleQuestion, E as DescribeToolCallOptions, F as ElicitationBlockOptions, H as GroupToolActivityOptions, I as RawAnswer, J as ResolvedReading, K as ResolvedResultView, L as RetrievedPassage, S as SettleAction, N as ToolActivityGroup, O as ToolCallDescription, P as ToolCallState, Q as ToolCallStatus, V as TranscriptApproval, W as TranscriptApprovalStatus, X as TranscriptElicitationBlock, Y as TranscriptElicitationOutcome, Z as TranscriptFilesBlock, _ as TranscriptQuestion, $ as TranscriptQuestionOption, a0 as TranscriptReasoningBlock, a1 as TranscriptSettleState, a2 as TranscriptSource, a3 as TranscriptSourcesBlock, a4 as TranscriptTextBlock, a5 as TranscriptToolBlock, a6 as TranscriptToolCall, a7 as buildTranscriptBlocks, a8 as coerceAnswer, a9 as correctedCallIds, aa as describeTimestamp, ab as describeToolCall, ac as describeUsage, ad as extractMessageText, ae as fillTemplate, af as formatRelativeTime, ag as groupToolActivity, ah as inferResultView, ai as isActionCall, aj as phraseFor, ak as readPath, al as resolveResultView, am as toolCallState, an as toolCatalogFrom } from './generative-ui-VTZ1EADD.cjs';
+import { UiCapabilities } from '@dudousxd/nestjs-agent-core/genui';
+export { UiCapabilities } from '@dudousxd/nestjs-agent-core/genui';
+import { o as GenuiProviderValue, T as TranscriptUiBlock, A as ApproveOptions, t as ApprovalTarget, v as TranscriptBlock, U as UsageSummary, w as TimestampInfo, C as ChatStatus, x as TranscriptFile, M as MessageUsageInfo, y as ToolCatalog, z as AnyToolUIPart } from './generative-ui-DOe2RsoO.cjs';
+export { B as ApprovalBlockOptions, D as BuildBlocksOptions, E as CoercibleQuestion, F as DescribeToolCallOptions, H as ElicitationBlockOptions, I as GroupToolActivityOptions, J as RawAnswer, K as ResolvedReading, L as ResolvedResultView, N as RetrievedPassage, S as SettleAction, O as ToolActivityGroup, P as ToolCallDescription, Q as ToolCallState, V as ToolCallStatus, W as TranscriptApproval, X as TranscriptApprovalStatus, Y as TranscriptElicitationBlock, Z as TranscriptElicitationOutcome, _ as TranscriptFilesBlock, $ as TranscriptQuestion, a0 as TranscriptQuestionOption, a1 as TranscriptReasoningBlock, a2 as TranscriptSettleState, a3 as TranscriptSource, a4 as TranscriptSourcesBlock, a5 as TranscriptTextBlock, a6 as TranscriptToolBlock, a7 as TranscriptToolCall, a8 as buildTranscriptBlocks, a9 as coerceAnswer, aa as correctedCallIds, ab as describeTimestamp, ac as describeToolCall, ad as describeUsage, ae as extractMessageText, af as fillTemplate, ag as formatRelativeTime, ah as groupToolActivity, ai as inferResultView, aj as isActionCall, ak as phraseFor, al as proposalNeedsPolling, am as readPath, an as reconcileProposalMessages, ao as resolveResultView, ap as toolCallState, aq as toolCatalogFrom } from './generative-ui-DOe2RsoO.cjs';
 
 /**
  * The `code`s this library's own loop closes a failed run's stream with (`event: error`). A client
@@ -107,6 +109,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
@@ -406,7 +410,7 @@ interface AgUiChatStreamOptions {
     /** Defaults to the global `fetch`, with `credentials: 'same-origin'`. */
     fetch?: typeof fetch;
     /**
-     * Shape `forwardedProps` from the send's body. Default: `{ pageContext, agent, model }` from the
+     * Shape `forwardedProps` from the send's body. Default: `{ pageContext, agent, model, persona, uiCapabilities }` from the
      * body, whichever are present.
      */
     forwardedProps?: (body: Record<string, unknown>) => unknown;
@@ -453,6 +457,8 @@ declare function reframeAgUiStream(source: ReadableStream<Uint8Array>, ids: {
 }): ReadableStream<Uint8Array>;
 
 interface AgentProviderProps {
+    /** Advertise exact supported component versions; omission keeps legacy support, [] is text only. */
+    uiCapabilities?: UiCapabilities;
     /**
      * A backend of your own — see {@link AgentBackend}. Omitted → an {@link AgentClient} over this
      * library's REST routes, built from the connection props below (which are ignored when a backend
@@ -505,7 +511,7 @@ interface AgentProviderProps {
  *
  * Without a provider every hook shares one same-origin client on `/agent`.
  */
-declare function AgentProvider({ backend, baseUrl, path, headers, getHeaders, credentials, fetch, onHttpError, attachments, genui, children, }: AgentProviderProps): React.JSX.Element;
+declare function AgentProvider({ backend, uiCapabilities, baseUrl, path, headers, getHeaders, credentials, fetch, onHttpError, attachments, genui, children, }: AgentProviderProps): React.JSX.Element;
 /**
  * The backend a hook talks to: `own` when given, else the enclosing {@link AgentProvider}'s, else a
  * shared same-origin client on `/agent`. For your own hooks over the same connection.
@@ -542,13 +548,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;
 
@@ -966,12 +980,14 @@ interface SkipInput {
 }
 /** Approving a tool call parked on a human. */
 interface ApproveInput extends ApproveOptions {
+    target?: ApprovalTarget;
     toolCallId: string;
     /** The surface the decision came through; the server records `'web'` when omitted. */
     via?: string;
 }
 /** Rejecting a tool call parked on a human. */
 interface RejectInput {
+    target?: ApprovalTarget;
     toolCallId: string;
     reason?: string;
     via?: string;
@@ -1653,6 +1669,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;
 }
@@ -1697,6 +1717,10 @@ interface AgentMessageMetadata extends Partial<StoredTurnMetadata> {
 declare function storedThreadToUiMessages(messages: StoredMessage[]): UIMessage[];
 
 interface UseAgentChatOptions<B extends AgentBackend = AgentBackend> {
+    uiCapabilities?: UiCapabilities;
+    proposalPollMs?: number;
+    /** Enable proposal reads even when history and resume are both disabled. */
+    proposals?: boolean;
     /**
      * What the chat talks to — see {@link AgentBackend}. Omitted → the enclosing `<AgentProvider>`'s,
      * else a same-origin client on `/agent`. Must be stable across renders.
@@ -1710,6 +1734,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:
@@ -1939,6 +1970,7 @@ declare function useAgentChat<B extends AgentBackend = AgentBackend>(options?: U
     addToolResult: ({ tool, toolCallId, output }: AddToolResultArgs) => void | PromiseLike<void>;
     /** Sub-agents this conversation started and did not wait for. */
     background: ChatBackground;
+    proposals: ActionProposalsState;
     runId: string | undefined;
     /** The loaded thread's running turn, or `null` once read with none. */
     activeRunId: string | null;
@@ -1971,13 +2003,18 @@ 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). */
     blocked: QuotaBlock | null;
     cancel: () => Promise<void>;
-    approve: ({ toolCallId, remember, via }: ApproveInput) => Promise<void>;
-    reject: ({ toolCallId, reason, via }: RejectInput) => Promise<void>;
+    approve: ({ toolCallId, target, remember, via }: ApproveInput) => Promise<void>;
+    reject: ({ toolCallId, target, reason, via }: RejectInput) => Promise<void>;
     answer: ({ toolCallId, answers, via }: AnswerInput) => Promise<void>;
     skip: ({ toolCallId, via }: SkipInput) => Promise<void>;
     regenerate: (_input?: Partial<MessageActionInput>) => void;
@@ -2006,4 +2043,11 @@ declare class QuotaBlockedError extends Error {
     constructor(block: QuotaBlock);
 }
 
-export { AGENT_RUN_ERROR_CODES, type AgUiChatStreamOptions, type AgUiContentPart, AgentBackend, AgentChatTransport, type AgentChatTransportOptions, type AgentConfigState, type AgentMessageMetadata, AgentProvider, type AgentProviderProps, AgentRequestError, type AgentRunErrorCode, type AgentRunFailure, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, type AmbientRenderUi, AmbientRenderUiContext, type AnswerInput, AnyToolUIPart, type ApprovalCountdown, type ApproveInput, ApproveOptions, type AttachmentRejection, AttachmentUploadStrategy, type AttachmentsState, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type ChatBackground, ChatInput, type ChatInputProps, type ChatQueue, ChatStatus, ChatStreamRequest, ChatStreamResponse, type ChatTranscript, type ClipboardLikeEvent, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DragLikeEvent, type EditSubmitInput, HttpErrorListener, type MessageActionInput, type MessageFeedbackState, type MessageFile, type MessageFileKind, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, type QueuedChatMessage, QuotaBlockedError, type QuotaState, RUN_NOT_ACTIVE_CODE, type ReconnectOptions, type RejectInput, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, SPEECH_LANGUAGES, type SendWhileRunning, type SkillSuggestionData, type SkillsSourceOptions, type SkipInput, type SpeechLanguage, type SpeechRecognitionHook, type StagedAttachment, type StagedAttachmentStatus, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type StreamConnectionState, type ThreadsEvent, type ThreadsState, TimestampInfo, ToolCatalog, type ToolCatalogState, type TranscriptActionState, TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, TranscriptFile, type TranscriptItem, type TranscriptItemOptions, type TranscriptQueuedFile, type TranscriptQueuedItem, type TranscriptStopState, TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, type UseAgentConfigOptions, type UseAgentsOptions, type UseApprovalCountdownOptions, type UseAttachmentsOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseMessageFeedbackOptions, type UseModelsOptions, type UseQuotaOptions, type UseSpeechRecognitionOptions, type UseThreadsOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, type WhileRunning, acceptsFile, agUiChatStream, applyCompletion, approvalCountdown, attachmentFile, backgroundRunsFromThread, createSkillsSource, dragHasFiles, fileKind, filesFromClipboard, filterAutocompleteItems, findActiveTrigger, formatElapsed, isRunNotActiveError, loadStoredSpeechLang, messageFiles, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, reframeAgUiStream, storedMessageToUiMessage, storedThreadToUiMessages, useAgentBackend, useAgentChat, useAgentConfig, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };
+interface ActionProposalsState {
+    items: ActionProposal[];
+    error: Error | null;
+    refresh(): Promise<void>;
+}
+declare function useActionProposals(backend: AgentBackend, threadId: string | undefined, setMessages: (update: (current: UIMessage[]) => UIMessage[]) => void, refreshKey: string, pollMs?: number): ActionProposalsState;
+
+export { AGENT_RUN_ERROR_CODES, type ActionProposalsState, type AgUiChatStreamOptions, type AgUiContentPart, AgentBackend, AgentChatTransport, type AgentChatTransportOptions, type AgentConfigState, type AgentMessageMetadata, AgentProvider, type AgentProviderProps, AgentRequestError, type AgentRunErrorCode, type AgentRunFailure, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, type AmbientRenderUi, AmbientRenderUiContext, type AnswerInput, AnyToolUIPart, type ApprovalCountdown, ApprovalTarget, type ApproveInput, ApproveOptions, type AttachmentRejection, AttachmentUploadStrategy, type AttachmentsState, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type ChatBackground, ChatInput, type ChatInputProps, type ChatQueue, ChatStatus, ChatStreamRequest, ChatStreamResponse, type ChatTranscript, type ClipboardLikeEvent, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DragLikeEvent, type EditSubmitInput, HttpErrorListener, type MessageActionInput, type MessageFeedbackState, type MessageFile, type MessageFileKind, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, type QueuedChatMessage, QuotaBlockedError, type QuotaState, RUN_NOT_ACTIVE_CODE, type ReconnectOptions, type RejectInput, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, SPEECH_LANGUAGES, type SendWhileRunning, type SkillSuggestionData, type SkillsSourceOptions, type SkipInput, type SpeechLanguage, type SpeechRecognitionHook, type StagedAttachment, type StagedAttachmentStatus, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type StreamConnectionState, type ThreadsEvent, type ThreadsState, TimestampInfo, ToolCatalog, type ToolCatalogState, type TranscriptActionState, TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, TranscriptFile, type TranscriptItem, type TranscriptItemOptions, type TranscriptQueuedFile, type TranscriptQueuedItem, type TranscriptStopState, TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, type UseAgentConfigOptions, type UseAgentsOptions, type UseApprovalCountdownOptions, type UseAttachmentsOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseMessageFeedbackOptions, type UseModelsOptions, type UseQuotaOptions, type UseSpeechRecognitionOptions, type UseThreadsOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, type WhileRunning, acceptsFile, agUiChatStream, applyCompletion, approvalCountdown, attachmentFile, backgroundRunsFromThread, createSkillsSource, dragHasFiles, fileKind, filesFromClipboard, filterAutocompleteItems, findActiveTrigger, formatElapsed, isRunNotActiveError, loadStoredSpeechLang, messageFiles, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, reframeAgUiStream, storedMessageToUiMessage, storedThreadToUiMessages, useActionProposals, useAgentBackend, useAgentChat, useAgentConfig, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };

package/dist/index.d.ts

@@ -1,13 +1,15 @@
 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-B6EE8-AC.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-B6EE8-AC.js';
+import { MessageAttachment, AgentClientConfig, AgentCatalogEntry, PersonaCatalogEntry, ModelCatalogEntry, ModelCatalogView, ModelCatalogLock, QuotaReport, QuotaWindow, QuotaBlock, QuotaWarning, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, QueuePause, ToolCatalogEntry, ActionProposal } 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';
-import { o as GenuiProviderValue, T as TranscriptUiBlock, A as ApproveOptions, t as TranscriptBlock, U as UsageSummary, v as TimestampInfo, C as ChatStatus, w as TranscriptFile, M as MessageUsageInfo, x as ToolCatalog, y as AnyToolUIPart } from './generative-ui-VTZ1EADD.js';
-export { z as ApprovalBlockOptions, B as BuildBlocksOptions, D as CoercibleQuestion, E as DescribeToolCallOptions, F as ElicitationBlockOptions, H as GroupToolActivityOptions, I as RawAnswer, J as ResolvedReading, K as ResolvedResultView, L as RetrievedPassage, S as SettleAction, N as ToolActivityGroup, O as ToolCallDescription, P as ToolCallState, Q as ToolCallStatus, V as TranscriptApproval, W as TranscriptApprovalStatus, X as TranscriptElicitationBlock, Y as TranscriptElicitationOutcome, Z as TranscriptFilesBlock, _ as TranscriptQuestion, $ as TranscriptQuestionOption, a0 as TranscriptReasoningBlock, a1 as TranscriptSettleState, a2 as TranscriptSource, a3 as TranscriptSourcesBlock, a4 as TranscriptTextBlock, a5 as TranscriptToolBlock, a6 as TranscriptToolCall, a7 as buildTranscriptBlocks, a8 as coerceAnswer, a9 as correctedCallIds, aa as describeTimestamp, ab as describeToolCall, ac as describeUsage, ad as extractMessageText, ae as fillTemplate, af as formatRelativeTime, ag as groupToolActivity, ah as inferResultView, ai as isActionCall, aj as phraseFor, ak as readPath, al as resolveResultView, am as toolCallState, an as toolCatalogFrom } from './generative-ui-VTZ1EADD.js';
+import { UiCapabilities } from '@dudousxd/nestjs-agent-core/genui';
+export { UiCapabilities } from '@dudousxd/nestjs-agent-core/genui';
+import { o as GenuiProviderValue, T as TranscriptUiBlock, A as ApproveOptions, t as ApprovalTarget, v as TranscriptBlock, U as UsageSummary, w as TimestampInfo, C as ChatStatus, x as TranscriptFile, M as MessageUsageInfo, y as ToolCatalog, z as AnyToolUIPart } from './generative-ui-DOe2RsoO.js';
+export { B as ApprovalBlockOptions, D as BuildBlocksOptions, E as CoercibleQuestion, F as DescribeToolCallOptions, H as ElicitationBlockOptions, I as GroupToolActivityOptions, J as RawAnswer, K as ResolvedReading, L as ResolvedResultView, N as RetrievedPassage, S as SettleAction, O as ToolActivityGroup, P as ToolCallDescription, Q as ToolCallState, V as ToolCallStatus, W as TranscriptApproval, X as TranscriptApprovalStatus, Y as TranscriptElicitationBlock, Z as TranscriptElicitationOutcome, _ as TranscriptFilesBlock, $ as TranscriptQuestion, a0 as TranscriptQuestionOption, a1 as TranscriptReasoningBlock, a2 as TranscriptSettleState, a3 as TranscriptSource, a4 as TranscriptSourcesBlock, a5 as TranscriptTextBlock, a6 as TranscriptToolBlock, a7 as TranscriptToolCall, a8 as buildTranscriptBlocks, a9 as coerceAnswer, aa as correctedCallIds, ab as describeTimestamp, ac as describeToolCall, ad as describeUsage, ae as extractMessageText, af as fillTemplate, ag as formatRelativeTime, ah as groupToolActivity, ai as inferResultView, aj as isActionCall, ak as phraseFor, al as proposalNeedsPolling, am as readPath, an as reconcileProposalMessages, ao as resolveResultView, ap as toolCallState, aq as toolCatalogFrom } from './generative-ui-DOe2RsoO.js';
 
 /**
  * The `code`s this library's own loop closes a failed run's stream with (`event: error`). A client
@@ -107,6 +109,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
@@ -406,7 +410,7 @@ interface AgUiChatStreamOptions {
     /** Defaults to the global `fetch`, with `credentials: 'same-origin'`. */
     fetch?: typeof fetch;
     /**
-     * Shape `forwardedProps` from the send's body. Default: `{ pageContext, agent, model }` from the
+     * Shape `forwardedProps` from the send's body. Default: `{ pageContext, agent, model, persona, uiCapabilities }` from the
      * body, whichever are present.
      */
     forwardedProps?: (body: Record<string, unknown>) => unknown;
@@ -453,6 +457,8 @@ declare function reframeAgUiStream(source: ReadableStream<Uint8Array>, ids: {
 }): ReadableStream<Uint8Array>;
 
 interface AgentProviderProps {
+    /** Advertise exact supported component versions; omission keeps legacy support, [] is text only. */
+    uiCapabilities?: UiCapabilities;
     /**
      * A backend of your own — see {@link AgentBackend}. Omitted → an {@link AgentClient} over this
      * library's REST routes, built from the connection props below (which are ignored when a backend
@@ -505,7 +511,7 @@ interface AgentProviderProps {
  *
  * Without a provider every hook shares one same-origin client on `/agent`.
  */
-declare function AgentProvider({ backend, baseUrl, path, headers, getHeaders, credentials, fetch, onHttpError, attachments, genui, children, }: AgentProviderProps): React.JSX.Element;
+declare function AgentProvider({ backend, uiCapabilities, baseUrl, path, headers, getHeaders, credentials, fetch, onHttpError, attachments, genui, children, }: AgentProviderProps): React.JSX.Element;
 /**
  * The backend a hook talks to: `own` when given, else the enclosing {@link AgentProvider}'s, else a
  * shared same-origin client on `/agent`. For your own hooks over the same connection.
@@ -542,13 +548,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;
 
@@ -966,12 +980,14 @@ interface SkipInput {
 }
 /** Approving a tool call parked on a human. */
 interface ApproveInput extends ApproveOptions {
+    target?: ApprovalTarget;
     toolCallId: string;
     /** The surface the decision came through; the server records `'web'` when omitted. */
     via?: string;
 }
 /** Rejecting a tool call parked on a human. */
 interface RejectInput {
+    target?: ApprovalTarget;
     toolCallId: string;
     reason?: string;
     via?: string;
@@ -1653,6 +1669,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;
 }
@@ -1697,6 +1717,10 @@ interface AgentMessageMetadata extends Partial<StoredTurnMetadata> {
 declare function storedThreadToUiMessages(messages: StoredMessage[]): UIMessage[];
 
 interface UseAgentChatOptions<B extends AgentBackend = AgentBackend> {
+    uiCapabilities?: UiCapabilities;
+    proposalPollMs?: number;
+    /** Enable proposal reads even when history and resume are both disabled. */
+    proposals?: boolean;
     /**
      * What the chat talks to — see {@link AgentBackend}. Omitted → the enclosing `<AgentProvider>`'s,
      * else a same-origin client on `/agent`. Must be stable across renders.
@@ -1710,6 +1734,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:
@@ -1939,6 +1970,7 @@ declare function useAgentChat<B extends AgentBackend = AgentBackend>(options?: U
     addToolResult: ({ tool, toolCallId, output }: AddToolResultArgs) => void | PromiseLike<void>;
     /** Sub-agents this conversation started and did not wait for. */
     background: ChatBackground;
+    proposals: ActionProposalsState;
     runId: string | undefined;
     /** The loaded thread's running turn, or `null` once read with none. */
     activeRunId: string | null;
@@ -1971,13 +2003,18 @@ 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). */
     blocked: QuotaBlock | null;
     cancel: () => Promise<void>;
-    approve: ({ toolCallId, remember, via }: ApproveInput) => Promise<void>;
-    reject: ({ toolCallId, reason, via }: RejectInput) => Promise<void>;
+    approve: ({ toolCallId, target, remember, via }: ApproveInput) => Promise<void>;
+    reject: ({ toolCallId, target, reason, via }: RejectInput) => Promise<void>;
     answer: ({ toolCallId, answers, via }: AnswerInput) => Promise<void>;
     skip: ({ toolCallId, via }: SkipInput) => Promise<void>;
     regenerate: (_input?: Partial<MessageActionInput>) => void;
@@ -2006,4 +2043,11 @@ declare class QuotaBlockedError extends Error {
     constructor(block: QuotaBlock);
 }
 
-export { AGENT_RUN_ERROR_CODES, type AgUiChatStreamOptions, type AgUiContentPart, AgentBackend, AgentChatTransport, type AgentChatTransportOptions, type AgentConfigState, type AgentMessageMetadata, AgentProvider, type AgentProviderProps, AgentRequestError, type AgentRunErrorCode, type AgentRunFailure, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, type AmbientRenderUi, AmbientRenderUiContext, type AnswerInput, AnyToolUIPart, type ApprovalCountdown, type ApproveInput, ApproveOptions, type AttachmentRejection, AttachmentUploadStrategy, type AttachmentsState, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type ChatBackground, ChatInput, type ChatInputProps, type ChatQueue, ChatStatus, ChatStreamRequest, ChatStreamResponse, type ChatTranscript, type ClipboardLikeEvent, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DragLikeEvent, type EditSubmitInput, HttpErrorListener, type MessageActionInput, type MessageFeedbackState, type MessageFile, type MessageFileKind, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, type QueuedChatMessage, QuotaBlockedError, type QuotaState, RUN_NOT_ACTIVE_CODE, type ReconnectOptions, type RejectInput, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, SPEECH_LANGUAGES, type SendWhileRunning, type SkillSuggestionData, type SkillsSourceOptions, type SkipInput, type SpeechLanguage, type SpeechRecognitionHook, type StagedAttachment, type StagedAttachmentStatus, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type StreamConnectionState, type ThreadsEvent, type ThreadsState, TimestampInfo, ToolCatalog, type ToolCatalogState, type TranscriptActionState, TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, TranscriptFile, type TranscriptItem, type TranscriptItemOptions, type TranscriptQueuedFile, type TranscriptQueuedItem, type TranscriptStopState, TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, type UseAgentConfigOptions, type UseAgentsOptions, type UseApprovalCountdownOptions, type UseAttachmentsOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseMessageFeedbackOptions, type UseModelsOptions, type UseQuotaOptions, type UseSpeechRecognitionOptions, type UseThreadsOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, type WhileRunning, acceptsFile, agUiChatStream, applyCompletion, approvalCountdown, attachmentFile, backgroundRunsFromThread, createSkillsSource, dragHasFiles, fileKind, filesFromClipboard, filterAutocompleteItems, findActiveTrigger, formatElapsed, isRunNotActiveError, loadStoredSpeechLang, messageFiles, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, reframeAgUiStream, storedMessageToUiMessage, storedThreadToUiMessages, useAgentBackend, useAgentChat, useAgentConfig, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };
+interface ActionProposalsState {
+    items: ActionProposal[];
+    error: Error | null;
+    refresh(): Promise<void>;
+}
+declare function useActionProposals(backend: AgentBackend, threadId: string | undefined, setMessages: (update: (current: UIMessage[]) => UIMessage[]) => void, refreshKey: string, pollMs?: number): ActionProposalsState;
+
+export { AGENT_RUN_ERROR_CODES, type ActionProposalsState, type AgUiChatStreamOptions, type AgUiContentPart, AgentBackend, AgentChatTransport, type AgentChatTransportOptions, type AgentConfigState, type AgentMessageMetadata, AgentProvider, type AgentProviderProps, AgentRequestError, type AgentRunErrorCode, type AgentRunFailure, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, type AmbientRenderUi, AmbientRenderUiContext, type AnswerInput, AnyToolUIPart, type ApprovalCountdown, ApprovalTarget, type ApproveInput, ApproveOptions, type AttachmentRejection, AttachmentUploadStrategy, type AttachmentsState, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type ChatBackground, ChatInput, type ChatInputProps, type ChatQueue, ChatStatus, ChatStreamRequest, ChatStreamResponse, type ChatTranscript, type ClipboardLikeEvent, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DragLikeEvent, type EditSubmitInput, HttpErrorListener, type MessageActionInput, type MessageFeedbackState, type MessageFile, type MessageFileKind, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, type QueuedChatMessage, QuotaBlockedError, type QuotaState, RUN_NOT_ACTIVE_CODE, type ReconnectOptions, type RejectInput, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, SPEECH_LANGUAGES, type SendWhileRunning, type SkillSuggestionData, type SkillsSourceOptions, type SkipInput, type SpeechLanguage, type SpeechRecognitionHook, type StagedAttachment, type StagedAttachmentStatus, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type StreamConnectionState, type ThreadsEvent, type ThreadsState, TimestampInfo, ToolCatalog, type ToolCatalogState, type TranscriptActionState, TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, TranscriptFile, type TranscriptItem, type TranscriptItemOptions, type TranscriptQueuedFile, type TranscriptQueuedItem, type TranscriptStopState, TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, type UseAgentConfigOptions, type UseAgentsOptions, type UseApprovalCountdownOptions, type UseAttachmentsOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseMessageFeedbackOptions, type UseModelsOptions, type UseQuotaOptions, type UseSpeechRecognitionOptions, type UseThreadsOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, type WhileRunning, acceptsFile, agUiChatStream, applyCompletion, approvalCountdown, attachmentFile, backgroundRunsFromThread, createSkillsSource, dragHasFiles, fileKind, filesFromClipboard, filterAutocompleteItems, findActiveTrigger, formatElapsed, isRunNotActiveError, loadStoredSpeechLang, messageFiles, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, reframeAgUiStream, storedMessageToUiMessage, storedThreadToUiMessages, useActionProposals, useAgentBackend, useAgentChat, useAgentConfig, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };