@dudousxd/nestjs-agent-react 0.20.0 → 0.21.0

package/dist/index.d.cts

@@ -1,13 +1,14 @@
 import * as ai from 'ai';
 import { ChatTransport, UIMessage, UIMessageChunk, DataUIPart, UIDataTypes } from 'ai';
-import { A as AgentBackend, U as UploadAttachmentOptions, a as AgentClient, b as AttachmentUploadStrategy, Q as QuotaToday } from './client-0Wd-WPsu.cjs';
-export { c as AgentBackendUnsupportedError, d as AgentClientOptions, e as AgentConnection, f as AgentHttpError, C as CancelResult, g as ChatStreamRequest, h as ChatStreamResponse, M as MessageFeedbackInput, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-0Wd-WPsu.cjs';
+import { A as AgentBackend, U as UploadAttachmentOptions, a as AttachmentUploadStrategy, Q as QuotaToday } from './client-ePlgRwP-.cjs';
+export { b as AgentBackendUnsupportedError, c as AgentClient, d as AgentClientOptions, e as AgentConnection, f as AgentHttpError, C as CancelResult, g as ChatStreamRequest, h as ChatStreamResponse, M as MessageFeedbackInput, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-ePlgRwP-.cjs';
 import * as _dudousxd_nestjs_agent_core from '@dudousxd/nestjs-agent-core';
 import { MessageAttachment, AgentCatalogEntry, ModelCatalogEntry, ModelCatalogView, QuotaReport, QuotaWindow, QuotaBlock, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, ToolCatalogEntry, ThreadDetail } from '@dudousxd/nestjs-agent-core';
 export { ElicitationInput, ElicitationInputType, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
+import * as React from 'react';
 import React__default, { ReactNode, Context } from 'react';
-import { T as TranscriptUiBlock, a as TranscriptBlock, U as UsageSummary, b as TimestampInfo, C as ChatStatus, M as MessageUsageInfo, c as ToolCatalog, A as ApproveOptions, d as AnyToolUIPart, e as TranscriptFile } from './model-gHqjNjLJ.cjs';
-export { f as ApprovalBlockOptions, B as BuildBlocksOptions, g as CoercibleQuestion, D as DescribeToolCallOptions, E as ElicitationBlockOptions, G as GroupToolActivityOptions, R as RawAnswer, h as ResolvedReading, i as ResolvedResultView, j as RetrievedPassage, S as SettleAction, k as ToolActivityGroup, l as ToolCallDescription, m as ToolCallState, n as ToolCallStatus, o as TranscriptApproval, p as TranscriptApprovalStatus, q as TranscriptElicitationBlock, r as TranscriptElicitationOutcome, s as TranscriptFilesBlock, t as TranscriptQuestion, u as TranscriptQuestionOption, v as TranscriptReasoningBlock, w as TranscriptSettleState, x as TranscriptSource, y as TranscriptSourcesBlock, z as TranscriptTextBlock, F as TranscriptToolBlock, H as TranscriptToolCall, I as buildTranscriptBlocks, J as coerceAnswer, K as correctedCallIds, L as describeTimestamp, N as describeToolCall, O as describeUsage, P as extractMessageText, Q as fillTemplate, V as formatRelativeTime, W as groupToolActivity, X as inferResultView, Y as isActionCall, Z as phraseFor, _ as readPath, $ as resolveResultView, a0 as toolCallState, a1 as toolCatalogFrom } from './model-gHqjNjLJ.cjs';
+import { o as GenuiProviderValue, T as TranscriptUiBlock, t as TranscriptBlock, U as UsageSummary, v as TimestampInfo, C as ChatStatus, M as MessageUsageInfo, w as ToolCatalog, A as ApproveOptions, x as AnyToolUIPart, y as TranscriptFile } from './generative-ui-9AJNVKBZ.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-9AJNVKBZ.cjs';
 
 /** Identity surfaced by the backend's `meta` SSE frame / response headers. */
 interface AgentStreamMeta {
@@ -56,12 +57,10 @@ interface AgentChatTransportOptions {
     reconnect?: ReconnectOptions | false;
     /** Fires as a stream drops, reconnects, or gives up. */
     onConnectionChange?: (state: StreamConnectionState) => void;
-    /**
-     * Origin + base path the agent endpoints hang off, e.g.
-     * `https://api.example.com`. Endpoints are appended as
-     * `${baseUrl}/agent/chat` etc. Defaults to `''` (same origin).
-     */
+    /** The server's origin, e.g. `https://api.example.com`. Defaults to `''` (same origin). */
     baseUrl?: string;
+    /** The agent's route prefix (`AgentModule`'s `path`, global prefix included). Default `'agent'`. */
+    path?: string;
     /** Static headers merged into every request (e.g. a tenant ref). */
     headers?: Record<string, string>;
     /**
@@ -232,7 +231,7 @@ interface UseAttachmentsOptions {
      * answered; honour `signal` so `remove` can cancel; call `onProgress(0..1)` if you can.
      */
     upload?: (file: File, options: UploadAttachmentOptions) => Promise<MessageAttachment>;
-    /** Used for the default `upload`. One of `upload` / `backend` is required. */
+    /** Used for the default `upload`. Default: the enclosing `<AgentProvider>`'s. */
     backend?: AgentBackend;
     /** `<input accept>` grammar: `'image/*,.pdf'` or `['image/*', 'application/pdf']`. */
     accept?: string | readonly string[];
@@ -303,11 +302,65 @@ interface ClipboardLikeEvent {
  * files.clear();
  * ```
  */
-declare function useAttachments(options: UseAttachmentsOptions): AttachmentsState;
+declare function useAttachments(options?: UseAttachmentsOptions): AttachmentsState;
+
+interface AgentProviderProps {
+    /**
+     * 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
+     * is given). Must be stable across renders.
+     */
+    backend?: AgentBackend;
+    /** The server's origin, e.g. `https://api.example.com`. Default `''` (same origin). */
+    baseUrl?: string;
+    /** `AgentModule`'s `path`, global prefix included (`'api/agent'`). Default `'agent'`. */
+    path?: string;
+    /** Static headers on every request. */
+    headers?: Record<string, string>;
+    /**
+     * Read at every request — a short-lived bearer token, or a CSRF header read from a cookie
+     * (`{ 'X-XSRF-TOKEN': readCookie('XSRF-TOKEN') }`).
+     */
+    getHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
+    /** `'include'` when the API is on another origin and authenticates by cookie. */
+    credentials?: RequestCredentials;
+    /** Injectable for tests / non-browser runtimes. */
+    fetch?: typeof fetch;
+    /** Attachment uploads of the built-in client. */
+    attachments?: {
+        /** e.g. `mediaAttachments()` from `@dudousxd/nestjs-agent-react/media`. */
+        upload?: AttachmentUploadStrategy;
+    };
+    /**
+     * Set generative UI up here — the same settings `<GenuiProvider>` takes (registry, catalog,
+     * resolver, fallback, …). Every message then draws pushed components with them.
+     */
+    genui?: GenuiProviderValue;
+    children?: ReactNode;
+}
+/**
+ * The agent connection, once, at the app root. Every hook below it — `useAgentChat`, `useThreads`,
+ * `useModels`, `useAgents`, `useQuota`, `useToolCatalog`, `useMessageFeedback`, `useAttachments` —
+ * talks to it unless handed a `backend` of its own.
+ *
+ * ```tsx
+ * <AgentProvider baseUrl="https://api.example.com" credentials="include">
+ *   <App />
+ * </AgentProvider>
+ * ```
+ *
+ * Without a provider every hook shares one same-origin client on `/agent`.
+ */
+declare function AgentProvider({ backend, baseUrl, path, headers, getHeaders, credentials, fetch, 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;
 
 interface UseAgentsOptions {
-    /** `useAgentChat(...).backend`, or your own. Must implement `listAgents`. */
-    backend: AgentBackend;
+    /** Default: the enclosing `<AgentProvider>`'s. Must implement `listAgents`. */
+    backend?: AgentBackend;
     /** `false` holds the request. Default `true`. */
     enabled?: boolean;
 }
@@ -324,11 +377,11 @@ interface AgentsState {
  * 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 }`.
  */
-declare function useAgents(options: UseAgentsOptions): AgentsState;
+declare function useAgents(options?: UseAgentsOptions): AgentsState;
 
 interface UseModelsOptions {
-    /** `useAgentChat(...).backend`, or your own. Must implement `listModels`. */
-    backend: AgentBackend;
+    /** Default: the enclosing `<AgentProvider>`'s. Must implement `listModels`. */
+    backend?: AgentBackend;
     /** The agent to list models for; omitted → the default agent. */
     agent?: string;
     /** `false` holds the request. Default `true`. */
@@ -358,11 +411,11 @@ interface ModelsState {
  * as `useAgentChat({ model })`, `sendMessage(msg, { body: { model } })`, or pin it on the thread
  * with `chat.setThreadModel(id)`.
  */
-declare function useModels(options: UseModelsOptions): ModelsState;
+declare function useModels(options?: UseModelsOptions): ModelsState;
 
 interface UseQuotaOptions {
-    /** `useAgentChat(...).backend`, or your own. Must implement `getQuota`. */
-    backend: AgentBackend;
+    /** Default: the enclosing `<AgentProvider>`'s. Must implement `getQuota`. */
+    backend?: AgentBackend;
     /** `false` holds the request. Default `true`. */
     enabled?: boolean;
     /** Re-read every `pollMs` ms as well. Default: only on mount, after runs, and on `refresh`. */
@@ -386,11 +439,11 @@ interface QuotaState {
  * one — if any — blocks sends. Re-read after every run a chat on the same backend settles, so a
  * meter moves with the conversation. Headless: draw the meter yourself.
  */
-declare function useQuota(options: UseQuotaOptions): QuotaState;
+declare function useQuota(options?: UseQuotaOptions): QuotaState;
 
 interface UseMessageFeedbackOptions {
-    /** `useAgentChat(...).backend`, or your own. Must implement `setMessageFeedback`. */
-    backend: AgentBackend;
+    /** Default: the enclosing `<AgentProvider>`'s. Must implement `setMessageFeedback`. */
+    backend?: AgentBackend;
     /**
      * The thread the messages belong to — `useAgentChat(...).getThreadId`, or an id. Needed to rate a
      * message streamed in this session: its id is the client's own, so the persisted row it became is
@@ -415,7 +468,7 @@ interface MessageFeedbackState {
  * Headless: it holds the state and the calls, the host draws the buttons. A rating shows at once
  * and rolls back if the server refuses it.
  */
-declare function useMessageFeedback(options: UseMessageFeedbackOptions): MessageFeedbackState;
+declare function useMessageFeedback(options?: UseMessageFeedbackOptions): MessageFeedbackState;
 
 /**
  * What changed about a backend's thread list. `changed` → refetch (a thread was created, or a run
@@ -439,11 +492,11 @@ declare function onThreadsEvent(backend: AgentBackend, listener: Listener): () =
 
 interface UseThreadsOptions {
     /**
-     * The backend to list — `useAgentChat(...).backend`, or your own. Must be STABLE across renders:
+     * The backend to list. Default: the enclosing `<AgentProvider>`'s. Must be STABLE across renders:
      * the list refreshes itself when a chat on the SAME backend creates a thread, settles a run or
      * streams a title.
      */
-    backend: AgentBackend;
+    backend?: AgentBackend;
     /** `false` holds the first request (e.g. until the user is signed in). Default `true`. */
     enabled?: boolean;
 }
@@ -464,7 +517,7 @@ interface ThreadsState {
  * backend reports thread creation and settled runs (refetch) and streamed titles (patched in
  * place). Headless — it renders nothing.
  */
-declare function useThreads(options: UseThreadsOptions): ThreadsState;
+declare function useThreads(options?: UseThreadsOptions): ThreadsState;
 
 /**
  * A sub-agent the conversation started and did not wait for. The chat is free while it works, so a
@@ -1025,8 +1078,8 @@ interface SkillSuggestionData {
     shadows?: string[];
 }
 interface SkillsSourceOptions {
-    /** Any backend with `listSkills` — `useAgentChat(...).backend`. */
-    client: Pick<AgentBackend, 'listSkills'>;
+    /** Any backend with `listSkills` — `useAgentBackend()`, or `useAgentChat().backend`. */
+    backend: Pick<AgentBackend, 'listSkills'>;
     /**
      * Read at query time, not captured once: a threadless chat learns its id only when the backend
      * creates one on the first send, and a skill may be scoped to a conversation.
@@ -1122,13 +1175,12 @@ declare function useComposerAutocomplete(options: UseComposerAutocompleteOptions
 
 /** What the catalog needs of a backend. */
 type ToolsBackend = Pick<AgentBackend, 'listTools'>;
-
 interface UseToolCatalogOptions {
     /**
-     * The client to ask — `useAgentChat(...).client`, or one of your own. Must be STABLE across
-     * renders (the shared copy is keyed by it): a client constructed inline refetches every render.
+     * The backend to ask. Default: the enclosing `<AgentProvider>`'s. Must be STABLE across renders
+     * (the shared copy is keyed by it): a backend constructed inline refetches every render.
      */
-    client: ToolsBackend;
+    backend?: ToolsBackend;
     /** The agent whose tools to list. Omitted → the server's default agent. */
     agent?: string;
     /** `false` holds the request (e.g. until the user is signed in). Default `true`. */
@@ -1149,7 +1201,7 @@ interface ToolCatalogState {
  * `phraseFor`, `describeToolCall` and `groupToolActivity` — or pass `catalog` to
  * `useChatTranscript({ toolCatalog })` and read the phrases off the transcript's calls.
  */
-declare function useToolCatalog(options: UseToolCatalogOptions): ToolCatalogState;
+declare function useToolCatalog(options?: UseToolCatalogOptions): ToolCatalogState;
 
 interface ApprovalCountdown {
     /** Milliseconds until the request lapses, floored at 0; `null` when it never does. */
@@ -1272,11 +1324,10 @@ interface AgentMessageMetadata extends Partial<StoredTurnMetadata> {
  */
 declare function storedThreadToUiMessages(messages: StoredMessage[]): UIMessage[];
 
-interface UseAgentChatOptions<B extends AgentBackend = AgentClient> {
+interface UseAgentChatOptions<B extends AgentBackend = AgentBackend> {
     /**
-     * What the chat talks to — see {@link AgentBackend}. Omitted → an {@link AgentClient} over this
-     * library's REST routes, built from `baseUrl`, `headers`, `getHeaders`, `credentials` and `fetch`
-     * (which are ignored when a backend is given). Must be stable across renders.
+     * 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.
      */
     backend?: B;
     /**
@@ -1285,24 +1336,6 @@ interface UseAgentChatOptions<B extends AgentBackend = AgentClient> {
      * it off.
      */
     reconnect?: ReconnectOptions | false;
-    /** Origin + base path, e.g. `https://api.example.com`. Defaults to `''`. */
-    baseUrl?: string;
-    /** Static headers merged into every request. */
-    headers?: Record<string, string>;
-    /** Resolved per request — for short-lived bearer tokens. */
-    getHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
-    /** Forwarded to fetch so cookie auth/impersonation works. */
-    credentials?: RequestCredentials;
-    /** Injectable for tests / non-browser runtimes. */
-    fetch?: typeof fetch;
-    /**
-     * How the built-in client uploads attachments (ignored when a backend is given) — e.g.
-     * `mediaAttachments()` from `@dudousxd/nestjs-agent-react/media`. Pass `chat.backend` to
-     * `useAttachments` and every composer uses it.
-     */
-    attachments?: AttachmentUploadStrategy;
-    /** Reuse an existing client instead of constructing one. Prefer {@link backend}. */
-    client?: B;
     /** Named agent to run each turn. */
     agent?: string;
     /**
@@ -1422,7 +1455,7 @@ interface AddToolResultArgs {
  * fork, quota, cancel, and HITL approve/reject — all driven through
  * `AgentClient`. Mirrors flip's `useAdminChat`, generalized.
  */
-declare function useAgentChat<B extends AgentBackend = AgentClient>(options: UseAgentChatOptions<B>): {
+declare function useAgentChat<B extends AgentBackend = AgentBackend>(options?: UseAgentChatOptions<B>): {
     status: ChatStatus;
     /** Where the live stream stands — see {@link StreamConnectionState}. */
     connection: StreamConnectionState;
@@ -1457,10 +1490,8 @@ declare function useAgentChat<B extends AgentBackend = AgentClient>(options: Use
      */
     getThreadId: () => string | undefined;
     setThreadModel: (model: string | null) => Promise<void>;
-    /** The backend this chat talks to — pass it to `useThreads`, `useMessageFeedback`, … */
+    /** The backend this chat talks to — the same one every other hook under the provider uses. */
     backend: B;
-    /** Same object as {@link backend}; kept for callers that read it under its old name. */
-    client: B;
     threads: ThreadSummary[];
     loadThreads: () => Promise<ThreadSummary[]>;
     loadThread: (id: string) => Promise<ThreadDetail>;
@@ -1507,4 +1538,4 @@ declare class QuotaBlockedError extends Error {
     constructor(block: QuotaBlock);
 }
 
-export { AgentBackend, AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentMessageMetadata, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, type AmbientRenderUi, AmbientRenderUiContext, AnyToolUIPart, type ApprovalCountdown, ApproveOptions, type AttachmentRejection, AttachmentUploadStrategy, type AttachmentsState, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type ChatBackground, ChatInput, type ChatInputProps, ChatStatus, type ChatTranscript, type ClipboardLikeEvent, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DragLikeEvent, type MessageFeedbackState, type MessageFile, type MessageFileKind, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, QuotaBlockedError, type QuotaState, QuotaToday, type ReconnectOptions, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, SPEECH_LANGUAGES, type SkillSuggestionData, type SkillsSourceOptions, 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 TranscriptStopState, TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, 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, acceptsFile, applyCompletion, approvalCountdown, backgroundRunsFromThread, createSkillsSource, dragHasFiles, fileKind, filesFromClipboard, filterAutocompleteItems, findActiveTrigger, formatElapsed, loadStoredSpeechLang, messageFiles, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, storedMessageToUiMessage, storedThreadToUiMessages, useAgentChat, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };
+export { AgentBackend, AgentChatTransport, type AgentChatTransportOptions, type AgentMessageMetadata, AgentProvider, type AgentProviderProps, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, type AmbientRenderUi, AmbientRenderUiContext, AnyToolUIPart, type ApprovalCountdown, ApproveOptions, type AttachmentRejection, AttachmentUploadStrategy, type AttachmentsState, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type ChatBackground, ChatInput, type ChatInputProps, ChatStatus, type ChatTranscript, type ClipboardLikeEvent, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DragLikeEvent, type MessageFeedbackState, type MessageFile, type MessageFileKind, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, QuotaBlockedError, type QuotaState, QuotaToday, type ReconnectOptions, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, SPEECH_LANGUAGES, type SkillSuggestionData, type SkillsSourceOptions, 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 TranscriptStopState, TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, 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, acceptsFile, applyCompletion, approvalCountdown, backgroundRunsFromThread, createSkillsSource, dragHasFiles, fileKind, filesFromClipboard, filterAutocompleteItems, findActiveTrigger, formatElapsed, loadStoredSpeechLang, messageFiles, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, storedMessageToUiMessage, storedThreadToUiMessages, useAgentBackend, useAgentChat, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };

package/dist/index.d.ts

@@ -1,13 +1,14 @@
 import * as ai from 'ai';
 import { ChatTransport, UIMessage, UIMessageChunk, DataUIPart, UIDataTypes } from 'ai';
-import { A as AgentBackend, U as UploadAttachmentOptions, a as AgentClient, b as AttachmentUploadStrategy, Q as QuotaToday } from './client-0Wd-WPsu.js';
-export { c as AgentBackendUnsupportedError, d as AgentClientOptions, e as AgentConnection, f as AgentHttpError, C as CancelResult, g as ChatStreamRequest, h as ChatStreamResponse, M as MessageFeedbackInput, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-0Wd-WPsu.js';
+import { A as AgentBackend, U as UploadAttachmentOptions, a as AttachmentUploadStrategy, Q as QuotaToday } from './client-ePlgRwP-.js';
+export { b as AgentBackendUnsupportedError, c as AgentClient, d as AgentClientOptions, e as AgentConnection, f as AgentHttpError, C as CancelResult, g as ChatStreamRequest, h as ChatStreamResponse, M as MessageFeedbackInput, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-ePlgRwP-.js';
 import * as _dudousxd_nestjs_agent_core from '@dudousxd/nestjs-agent-core';
 import { MessageAttachment, AgentCatalogEntry, ModelCatalogEntry, ModelCatalogView, QuotaReport, QuotaWindow, QuotaBlock, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, ToolCatalogEntry, ThreadDetail } from '@dudousxd/nestjs-agent-core';
 export { ElicitationInput, ElicitationInputType, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
+import * as React from 'react';
 import React__default, { ReactNode, Context } from 'react';
-import { T as TranscriptUiBlock, a as TranscriptBlock, U as UsageSummary, b as TimestampInfo, C as ChatStatus, M as MessageUsageInfo, c as ToolCatalog, A as ApproveOptions, d as AnyToolUIPart, e as TranscriptFile } from './model-gHqjNjLJ.js';
-export { f as ApprovalBlockOptions, B as BuildBlocksOptions, g as CoercibleQuestion, D as DescribeToolCallOptions, E as ElicitationBlockOptions, G as GroupToolActivityOptions, R as RawAnswer, h as ResolvedReading, i as ResolvedResultView, j as RetrievedPassage, S as SettleAction, k as ToolActivityGroup, l as ToolCallDescription, m as ToolCallState, n as ToolCallStatus, o as TranscriptApproval, p as TranscriptApprovalStatus, q as TranscriptElicitationBlock, r as TranscriptElicitationOutcome, s as TranscriptFilesBlock, t as TranscriptQuestion, u as TranscriptQuestionOption, v as TranscriptReasoningBlock, w as TranscriptSettleState, x as TranscriptSource, y as TranscriptSourcesBlock, z as TranscriptTextBlock, F as TranscriptToolBlock, H as TranscriptToolCall, I as buildTranscriptBlocks, J as coerceAnswer, K as correctedCallIds, L as describeTimestamp, N as describeToolCall, O as describeUsage, P as extractMessageText, Q as fillTemplate, V as formatRelativeTime, W as groupToolActivity, X as inferResultView, Y as isActionCall, Z as phraseFor, _ as readPath, $ as resolveResultView, a0 as toolCallState, a1 as toolCatalogFrom } from './model-gHqjNjLJ.js';
+import { o as GenuiProviderValue, T as TranscriptUiBlock, t as TranscriptBlock, U as UsageSummary, v as TimestampInfo, C as ChatStatus, M as MessageUsageInfo, w as ToolCatalog, A as ApproveOptions, x as AnyToolUIPart, y as TranscriptFile } from './generative-ui-9AJNVKBZ.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-9AJNVKBZ.js';
 
 /** Identity surfaced by the backend's `meta` SSE frame / response headers. */
 interface AgentStreamMeta {
@@ -56,12 +57,10 @@ interface AgentChatTransportOptions {
     reconnect?: ReconnectOptions | false;
     /** Fires as a stream drops, reconnects, or gives up. */
     onConnectionChange?: (state: StreamConnectionState) => void;
-    /**
-     * Origin + base path the agent endpoints hang off, e.g.
-     * `https://api.example.com`. Endpoints are appended as
-     * `${baseUrl}/agent/chat` etc. Defaults to `''` (same origin).
-     */
+    /** The server's origin, e.g. `https://api.example.com`. Defaults to `''` (same origin). */
     baseUrl?: string;
+    /** The agent's route prefix (`AgentModule`'s `path`, global prefix included). Default `'agent'`. */
+    path?: string;
     /** Static headers merged into every request (e.g. a tenant ref). */
     headers?: Record<string, string>;
     /**
@@ -232,7 +231,7 @@ interface UseAttachmentsOptions {
      * answered; honour `signal` so `remove` can cancel; call `onProgress(0..1)` if you can.
      */
     upload?: (file: File, options: UploadAttachmentOptions) => Promise<MessageAttachment>;
-    /** Used for the default `upload`. One of `upload` / `backend` is required. */
+    /** Used for the default `upload`. Default: the enclosing `<AgentProvider>`'s. */
     backend?: AgentBackend;
     /** `<input accept>` grammar: `'image/*,.pdf'` or `['image/*', 'application/pdf']`. */
     accept?: string | readonly string[];
@@ -303,11 +302,65 @@ interface ClipboardLikeEvent {
  * files.clear();
  * ```
  */
-declare function useAttachments(options: UseAttachmentsOptions): AttachmentsState;
+declare function useAttachments(options?: UseAttachmentsOptions): AttachmentsState;
+
+interface AgentProviderProps {
+    /**
+     * 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
+     * is given). Must be stable across renders.
+     */
+    backend?: AgentBackend;
+    /** The server's origin, e.g. `https://api.example.com`. Default `''` (same origin). */
+    baseUrl?: string;
+    /** `AgentModule`'s `path`, global prefix included (`'api/agent'`). Default `'agent'`. */
+    path?: string;
+    /** Static headers on every request. */
+    headers?: Record<string, string>;
+    /**
+     * Read at every request — a short-lived bearer token, or a CSRF header read from a cookie
+     * (`{ 'X-XSRF-TOKEN': readCookie('XSRF-TOKEN') }`).
+     */
+    getHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
+    /** `'include'` when the API is on another origin and authenticates by cookie. */
+    credentials?: RequestCredentials;
+    /** Injectable for tests / non-browser runtimes. */
+    fetch?: typeof fetch;
+    /** Attachment uploads of the built-in client. */
+    attachments?: {
+        /** e.g. `mediaAttachments()` from `@dudousxd/nestjs-agent-react/media`. */
+        upload?: AttachmentUploadStrategy;
+    };
+    /**
+     * Set generative UI up here — the same settings `<GenuiProvider>` takes (registry, catalog,
+     * resolver, fallback, …). Every message then draws pushed components with them.
+     */
+    genui?: GenuiProviderValue;
+    children?: ReactNode;
+}
+/**
+ * The agent connection, once, at the app root. Every hook below it — `useAgentChat`, `useThreads`,
+ * `useModels`, `useAgents`, `useQuota`, `useToolCatalog`, `useMessageFeedback`, `useAttachments` —
+ * talks to it unless handed a `backend` of its own.
+ *
+ * ```tsx
+ * <AgentProvider baseUrl="https://api.example.com" credentials="include">
+ *   <App />
+ * </AgentProvider>
+ * ```
+ *
+ * Without a provider every hook shares one same-origin client on `/agent`.
+ */
+declare function AgentProvider({ backend, baseUrl, path, headers, getHeaders, credentials, fetch, 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;
 
 interface UseAgentsOptions {
-    /** `useAgentChat(...).backend`, or your own. Must implement `listAgents`. */
-    backend: AgentBackend;
+    /** Default: the enclosing `<AgentProvider>`'s. Must implement `listAgents`. */
+    backend?: AgentBackend;
     /** `false` holds the request. Default `true`. */
     enabled?: boolean;
 }
@@ -324,11 +377,11 @@ interface AgentsState {
  * 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 }`.
  */
-declare function useAgents(options: UseAgentsOptions): AgentsState;
+declare function useAgents(options?: UseAgentsOptions): AgentsState;
 
 interface UseModelsOptions {
-    /** `useAgentChat(...).backend`, or your own. Must implement `listModels`. */
-    backend: AgentBackend;
+    /** Default: the enclosing `<AgentProvider>`'s. Must implement `listModels`. */
+    backend?: AgentBackend;
     /** The agent to list models for; omitted → the default agent. */
     agent?: string;
     /** `false` holds the request. Default `true`. */
@@ -358,11 +411,11 @@ interface ModelsState {
  * as `useAgentChat({ model })`, `sendMessage(msg, { body: { model } })`, or pin it on the thread
  * with `chat.setThreadModel(id)`.
  */
-declare function useModels(options: UseModelsOptions): ModelsState;
+declare function useModels(options?: UseModelsOptions): ModelsState;
 
 interface UseQuotaOptions {
-    /** `useAgentChat(...).backend`, or your own. Must implement `getQuota`. */
-    backend: AgentBackend;
+    /** Default: the enclosing `<AgentProvider>`'s. Must implement `getQuota`. */
+    backend?: AgentBackend;
     /** `false` holds the request. Default `true`. */
     enabled?: boolean;
     /** Re-read every `pollMs` ms as well. Default: only on mount, after runs, and on `refresh`. */
@@ -386,11 +439,11 @@ interface QuotaState {
  * one — if any — blocks sends. Re-read after every run a chat on the same backend settles, so a
  * meter moves with the conversation. Headless: draw the meter yourself.
  */
-declare function useQuota(options: UseQuotaOptions): QuotaState;
+declare function useQuota(options?: UseQuotaOptions): QuotaState;
 
 interface UseMessageFeedbackOptions {
-    /** `useAgentChat(...).backend`, or your own. Must implement `setMessageFeedback`. */
-    backend: AgentBackend;
+    /** Default: the enclosing `<AgentProvider>`'s. Must implement `setMessageFeedback`. */
+    backend?: AgentBackend;
     /**
      * The thread the messages belong to — `useAgentChat(...).getThreadId`, or an id. Needed to rate a
      * message streamed in this session: its id is the client's own, so the persisted row it became is
@@ -415,7 +468,7 @@ interface MessageFeedbackState {
  * Headless: it holds the state and the calls, the host draws the buttons. A rating shows at once
  * and rolls back if the server refuses it.
  */
-declare function useMessageFeedback(options: UseMessageFeedbackOptions): MessageFeedbackState;
+declare function useMessageFeedback(options?: UseMessageFeedbackOptions): MessageFeedbackState;
 
 /**
  * What changed about a backend's thread list. `changed` → refetch (a thread was created, or a run
@@ -439,11 +492,11 @@ declare function onThreadsEvent(backend: AgentBackend, listener: Listener): () =
 
 interface UseThreadsOptions {
     /**
-     * The backend to list — `useAgentChat(...).backend`, or your own. Must be STABLE across renders:
+     * The backend to list. Default: the enclosing `<AgentProvider>`'s. Must be STABLE across renders:
      * the list refreshes itself when a chat on the SAME backend creates a thread, settles a run or
      * streams a title.
      */
-    backend: AgentBackend;
+    backend?: AgentBackend;
     /** `false` holds the first request (e.g. until the user is signed in). Default `true`. */
     enabled?: boolean;
 }
@@ -464,7 +517,7 @@ interface ThreadsState {
  * backend reports thread creation and settled runs (refetch) and streamed titles (patched in
  * place). Headless — it renders nothing.
  */
-declare function useThreads(options: UseThreadsOptions): ThreadsState;
+declare function useThreads(options?: UseThreadsOptions): ThreadsState;
 
 /**
  * A sub-agent the conversation started and did not wait for. The chat is free while it works, so a
@@ -1025,8 +1078,8 @@ interface SkillSuggestionData {
     shadows?: string[];
 }
 interface SkillsSourceOptions {
-    /** Any backend with `listSkills` — `useAgentChat(...).backend`. */
-    client: Pick<AgentBackend, 'listSkills'>;
+    /** Any backend with `listSkills` — `useAgentBackend()`, or `useAgentChat().backend`. */
+    backend: Pick<AgentBackend, 'listSkills'>;
     /**
      * Read at query time, not captured once: a threadless chat learns its id only when the backend
      * creates one on the first send, and a skill may be scoped to a conversation.
@@ -1122,13 +1175,12 @@ declare function useComposerAutocomplete(options: UseComposerAutocompleteOptions
 
 /** What the catalog needs of a backend. */
 type ToolsBackend = Pick<AgentBackend, 'listTools'>;
-
 interface UseToolCatalogOptions {
     /**
-     * The client to ask — `useAgentChat(...).client`, or one of your own. Must be STABLE across
-     * renders (the shared copy is keyed by it): a client constructed inline refetches every render.
+     * The backend to ask. Default: the enclosing `<AgentProvider>`'s. Must be STABLE across renders
+     * (the shared copy is keyed by it): a backend constructed inline refetches every render.
      */
-    client: ToolsBackend;
+    backend?: ToolsBackend;
     /** The agent whose tools to list. Omitted → the server's default agent. */
     agent?: string;
     /** `false` holds the request (e.g. until the user is signed in). Default `true`. */
@@ -1149,7 +1201,7 @@ interface ToolCatalogState {
  * `phraseFor`, `describeToolCall` and `groupToolActivity` — or pass `catalog` to
  * `useChatTranscript({ toolCatalog })` and read the phrases off the transcript's calls.
  */
-declare function useToolCatalog(options: UseToolCatalogOptions): ToolCatalogState;
+declare function useToolCatalog(options?: UseToolCatalogOptions): ToolCatalogState;
 
 interface ApprovalCountdown {
     /** Milliseconds until the request lapses, floored at 0; `null` when it never does. */
@@ -1272,11 +1324,10 @@ interface AgentMessageMetadata extends Partial<StoredTurnMetadata> {
  */
 declare function storedThreadToUiMessages(messages: StoredMessage[]): UIMessage[];
 
-interface UseAgentChatOptions<B extends AgentBackend = AgentClient> {
+interface UseAgentChatOptions<B extends AgentBackend = AgentBackend> {
     /**
-     * What the chat talks to — see {@link AgentBackend}. Omitted → an {@link AgentClient} over this
-     * library's REST routes, built from `baseUrl`, `headers`, `getHeaders`, `credentials` and `fetch`
-     * (which are ignored when a backend is given). Must be stable across renders.
+     * 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.
      */
     backend?: B;
     /**
@@ -1285,24 +1336,6 @@ interface UseAgentChatOptions<B extends AgentBackend = AgentClient> {
      * it off.
      */
     reconnect?: ReconnectOptions | false;
-    /** Origin + base path, e.g. `https://api.example.com`. Defaults to `''`. */
-    baseUrl?: string;
-    /** Static headers merged into every request. */
-    headers?: Record<string, string>;
-    /** Resolved per request — for short-lived bearer tokens. */
-    getHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
-    /** Forwarded to fetch so cookie auth/impersonation works. */
-    credentials?: RequestCredentials;
-    /** Injectable for tests / non-browser runtimes. */
-    fetch?: typeof fetch;
-    /**
-     * How the built-in client uploads attachments (ignored when a backend is given) — e.g.
-     * `mediaAttachments()` from `@dudousxd/nestjs-agent-react/media`. Pass `chat.backend` to
-     * `useAttachments` and every composer uses it.
-     */
-    attachments?: AttachmentUploadStrategy;
-    /** Reuse an existing client instead of constructing one. Prefer {@link backend}. */
-    client?: B;
     /** Named agent to run each turn. */
     agent?: string;
     /**
@@ -1422,7 +1455,7 @@ interface AddToolResultArgs {
  * fork, quota, cancel, and HITL approve/reject — all driven through
  * `AgentClient`. Mirrors flip's `useAdminChat`, generalized.
  */
-declare function useAgentChat<B extends AgentBackend = AgentClient>(options: UseAgentChatOptions<B>): {
+declare function useAgentChat<B extends AgentBackend = AgentBackend>(options?: UseAgentChatOptions<B>): {
     status: ChatStatus;
     /** Where the live stream stands — see {@link StreamConnectionState}. */
     connection: StreamConnectionState;
@@ -1457,10 +1490,8 @@ declare function useAgentChat<B extends AgentBackend = AgentClient>(options: Use
      */
     getThreadId: () => string | undefined;
     setThreadModel: (model: string | null) => Promise<void>;
-    /** The backend this chat talks to — pass it to `useThreads`, `useMessageFeedback`, … */
+    /** The backend this chat talks to — the same one every other hook under the provider uses. */
     backend: B;
-    /** Same object as {@link backend}; kept for callers that read it under its old name. */
-    client: B;
     threads: ThreadSummary[];
     loadThreads: () => Promise<ThreadSummary[]>;
     loadThread: (id: string) => Promise<ThreadDetail>;
@@ -1507,4 +1538,4 @@ declare class QuotaBlockedError extends Error {
     constructor(block: QuotaBlock);
 }
 
-export { AgentBackend, AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentMessageMetadata, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, type AmbientRenderUi, AmbientRenderUiContext, AnyToolUIPart, type ApprovalCountdown, ApproveOptions, type AttachmentRejection, AttachmentUploadStrategy, type AttachmentsState, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type ChatBackground, ChatInput, type ChatInputProps, ChatStatus, type ChatTranscript, type ClipboardLikeEvent, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DragLikeEvent, type MessageFeedbackState, type MessageFile, type MessageFileKind, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, QuotaBlockedError, type QuotaState, QuotaToday, type ReconnectOptions, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, SPEECH_LANGUAGES, type SkillSuggestionData, type SkillsSourceOptions, 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 TranscriptStopState, TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, 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, acceptsFile, applyCompletion, approvalCountdown, backgroundRunsFromThread, createSkillsSource, dragHasFiles, fileKind, filesFromClipboard, filterAutocompleteItems, findActiveTrigger, formatElapsed, loadStoredSpeechLang, messageFiles, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, storedMessageToUiMessage, storedThreadToUiMessages, useAgentChat, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };
+export { AgentBackend, AgentChatTransport, type AgentChatTransportOptions, type AgentMessageMetadata, AgentProvider, type AgentProviderProps, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, type AmbientRenderUi, AmbientRenderUiContext, AnyToolUIPart, type ApprovalCountdown, ApproveOptions, type AttachmentRejection, AttachmentUploadStrategy, type AttachmentsState, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type ChatBackground, ChatInput, type ChatInputProps, ChatStatus, type ChatTranscript, type ClipboardLikeEvent, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DragLikeEvent, type MessageFeedbackState, type MessageFile, type MessageFileKind, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, QuotaBlockedError, type QuotaState, QuotaToday, type ReconnectOptions, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, SPEECH_LANGUAGES, type SkillSuggestionData, type SkillsSourceOptions, 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 TranscriptStopState, TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, 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, acceptsFile, applyCompletion, approvalCountdown, backgroundRunsFromThread, createSkillsSource, dragHasFiles, fileKind, filesFromClipboard, filterAutocompleteItems, findActiveTrigger, formatElapsed, loadStoredSpeechLang, messageFiles, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, storedMessageToUiMessage, storedThreadToUiMessages, useAgentBackend, useAgentChat, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };