@dudousxd/nestjs-agent-react 0.32.0 → 0.34.0

package/dist/index.d.cts

@@ -1,13 +1,16 @@
 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-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';
+import { A as AgentRequestError, a as AgentBackend, U as UploadAttachmentOptions, C as ChatStreamRequest, b as ChatStreamResponse, H as HttpErrorListener, c as AttachmentUploadStrategy } from './client-BdHUuqy-.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-BdHUuqy-.cjs';
+import { MessageAttachment, AgentClientConfig, AgentCatalogEntry, PersonaCatalogEntry, ModelCatalogEntry, ModelCatalogView, ModelCatalogLock, QuotaReport, QuotaWindow, QuotaBlock, QuotaWarning, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, QueuePause, ToolCatalogEntry, ActionProposalView } 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 { g as GenuiProviderValue, T as TranscriptUiBlock, A as ApproveOptions, j as ApprovalTarget, k as TranscriptBlock, U as UsageSummary, l as TimestampInfo, C as ChatStatus, m as TranscriptFile, M as MessageUsageInfo, n as ToolCatalog, o as AnyToolUIPart } from './generative-ui-CyHY8Lh1.cjs';
+export { p as ApprovalBlockOptions, B as BuildBlocksOptions, q as CoercibleQuestion, D as DescribeToolCallOptions, E as ElicitationBlockOptions, r as GroupToolActivityOptions, R as RawAnswer, s as ResolvedReading, t as ResolvedResultView, v as RetrievedPassage, S as SettleAction, w as ToolActivityGroup, x as ToolCallDescription, y as ToolCallState, z as ToolCallStatus, F as TranscriptApproval, H as TranscriptApprovalStatus, I as TranscriptElicitationBlock, J as TranscriptElicitationOutcome, K as TranscriptFilesBlock, L as TranscriptQuestion, N as TranscriptQuestionOption, O as TranscriptReasoningBlock, P as TranscriptSettleState, Q as TranscriptSource, V as TranscriptSourcesBlock, W as TranscriptTextBlock, X as TranscriptToolBlock, Y as TranscriptToolCall, Z as buildTranscriptBlocks, _ as coerceAnswer, $ as correctedCallIds, a0 as describeTimestamp, a1 as describeToolCall, a2 as describeUsage, a3 as extractMessageText, a4 as fillTemplate, a5 as formatRelativeTime, a6 as groupToolActivity, a7 as inferResultView, a8 as isActionCall, a9 as phraseFor, aa as proposalNeedsPolling, ab as readPath, ac as reconcileProposalMessages, ad as resolveResultView, ae as toolCallState, af as toolCatalogFrom } from './generative-ui-CyHY8Lh1.cjs';
+import './types-DZtFsWec.cjs';
 
 /**
  * The `code`s this library's own loop closes a failed run's stream with (`event: error`). A client
@@ -408,7 +411,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;
@@ -455,6 +458,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
@@ -507,12 +512,18 @@ 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.
  */
 declare function useAgentBackend<B extends AgentBackend = AgentBackend>(own?: B): B;
+/**
+ * The UI capabilities the nearest `<AgentProvider uiCapabilities>` declared, or `undefined` when it
+ * declared none. `useAgentChat` reads this unless given its own `uiCapabilities`; read it too when a
+ * hook of yours talks to the agent outside `useAgentChat`.
+ */
+declare function useAgentUiCapabilities(): UiCapabilities | undefined;
 
 interface UseAgentConfigOptions {
     /** Default: the enclosing `<AgentProvider>`'s. Without `getConfig` the config stays `undefined`. */
@@ -976,12 +987,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;
@@ -1711,6 +1724,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.
@@ -1960,6 +1977,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;
@@ -2002,8 +2020,8 @@ declare function useAgentChat<B extends AgentBackend = AgentBackend>(options?: U
     /** 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;
@@ -2032,4 +2050,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: ActionProposalView[];
+    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, useAgentUiCapabilities, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };

package/dist/index.d.ts

@@ -1,13 +1,16 @@
 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-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';
+import { A as AgentRequestError, a as AgentBackend, U as UploadAttachmentOptions, C as ChatStreamRequest, b as ChatStreamResponse, H as HttpErrorListener, c as AttachmentUploadStrategy } from './client-BdHUuqy-.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-BdHUuqy-.js';
+import { MessageAttachment, AgentClientConfig, AgentCatalogEntry, PersonaCatalogEntry, ModelCatalogEntry, ModelCatalogView, ModelCatalogLock, QuotaReport, QuotaWindow, QuotaBlock, QuotaWarning, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, QueuePause, ToolCatalogEntry, ActionProposalView } 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 { g as GenuiProviderValue, T as TranscriptUiBlock, A as ApproveOptions, j as ApprovalTarget, k as TranscriptBlock, U as UsageSummary, l as TimestampInfo, C as ChatStatus, m as TranscriptFile, M as MessageUsageInfo, n as ToolCatalog, o as AnyToolUIPart } from './generative-ui-DdUZPCXX.js';
+export { p as ApprovalBlockOptions, B as BuildBlocksOptions, q as CoercibleQuestion, D as DescribeToolCallOptions, E as ElicitationBlockOptions, r as GroupToolActivityOptions, R as RawAnswer, s as ResolvedReading, t as ResolvedResultView, v as RetrievedPassage, S as SettleAction, w as ToolActivityGroup, x as ToolCallDescription, y as ToolCallState, z as ToolCallStatus, F as TranscriptApproval, H as TranscriptApprovalStatus, I as TranscriptElicitationBlock, J as TranscriptElicitationOutcome, K as TranscriptFilesBlock, L as TranscriptQuestion, N as TranscriptQuestionOption, O as TranscriptReasoningBlock, P as TranscriptSettleState, Q as TranscriptSource, V as TranscriptSourcesBlock, W as TranscriptTextBlock, X as TranscriptToolBlock, Y as TranscriptToolCall, Z as buildTranscriptBlocks, _ as coerceAnswer, $ as correctedCallIds, a0 as describeTimestamp, a1 as describeToolCall, a2 as describeUsage, a3 as extractMessageText, a4 as fillTemplate, a5 as formatRelativeTime, a6 as groupToolActivity, a7 as inferResultView, a8 as isActionCall, a9 as phraseFor, aa as proposalNeedsPolling, ab as readPath, ac as reconcileProposalMessages, ad as resolveResultView, ae as toolCallState, af as toolCatalogFrom } from './generative-ui-DdUZPCXX.js';
+import './types-DZtFsWec.js';
 
 /**
  * The `code`s this library's own loop closes a failed run's stream with (`event: error`). A client
@@ -408,7 +411,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;
@@ -455,6 +458,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
@@ -507,12 +512,18 @@ 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.
  */
 declare function useAgentBackend<B extends AgentBackend = AgentBackend>(own?: B): B;
+/**
+ * The UI capabilities the nearest `<AgentProvider uiCapabilities>` declared, or `undefined` when it
+ * declared none. `useAgentChat` reads this unless given its own `uiCapabilities`; read it too when a
+ * hook of yours talks to the agent outside `useAgentChat`.
+ */
+declare function useAgentUiCapabilities(): UiCapabilities | undefined;
 
 interface UseAgentConfigOptions {
     /** Default: the enclosing `<AgentProvider>`'s. Without `getConfig` the config stays `undefined`. */
@@ -976,12 +987,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;
@@ -1711,6 +1724,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.
@@ -1960,6 +1977,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;
@@ -2002,8 +2020,8 @@ declare function useAgentChat<B extends AgentBackend = AgentBackend>(options?: U
     /** 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;
@@ -2032,4 +2050,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: ActionProposalView[];
+    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, useAgentUiCapabilities, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };