@dudousxd/nestjs-agent-react 0.15.0 → 0.17.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as ai from 'ai';
 import { ChatTransport, UIMessage, UIMessageChunk, DataUIPart, UIDataTypes } from 'ai';
 import * as _dudousxd_nestjs_agent_core from '@dudousxd/nestjs-agent-core';
-import { ThreadSummary, ThreadDetail, MessageAttachment, ToolCatalogEntry, SkillCatalogEntry, QuotaView, MessageFeedbackValue, MessageFeedback, StoredMessage } from '@dudousxd/nestjs-agent-core';
+import { ThreadSummary, ThreadDetail, MessageAttachment, ToolCatalogEntry, SkillCatalogEntry, QuotaView, QuotaReport, ModelCatalogView, AgentCatalogEntry, MessageFeedbackValue, MessageFeedback, ModelCatalogEntry, QuotaWindow, QuotaBlock, StoredMessage } from '@dudousxd/nestjs-agent-core';
 export { ElicitationInput, ElicitationInputType, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
 import React__default from 'react';
 import { 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, T as TranscriptUiBlock } from './model-gHqjNjLJ.cjs';
@@ -15,10 +15,12 @@ export { f as ApprovalBlockOptions, B as BuildBlocksOptions, g as CoercibleQuest
 interface ThreadPatch {
     title?: string;
     defaultAgent?: string | null;
+    /** Pin a catalog model on the thread; `null` unpins it. */
+    model?: string | null;
 }
 /** Starting a turn: the body `POST <base>/chat` takes (see docs/stream-protocol.md). */
 interface ChatStreamRequest {
-    /** `{ message, threadId?, agent?, attachments?, pageContext?, regenerate?, … }`. */
+    /** `{ message, threadId?, agent?, model?, attachments?, pageContext?, regenerate?, … }`. */
     body: Record<string, unknown>;
     /** Per-request headers the AI SDK was handed for this send. */
     headers?: Record<string, string>;
@@ -104,6 +106,12 @@ interface AgentBackend {
     listTools?(agent?: string): Promise<ToolCatalogEntry[]>;
     listSkills?(threadId?: string): Promise<SkillCatalogEntry[]>;
     getQuotaToday?(): Promise<QuotaView>;
+    /** `GET <base>/quota` — every budget window, and which one blocks sends, if any. */
+    getQuota?(): Promise<QuotaReport>;
+    /** `GET <base>/models?agent=` — what a model picker offers. */
+    listModels?(agent?: string): Promise<ModelCatalogView>;
+    /** `GET <base>/agents` — what an agent picker offers. */
+    listAgents?(): Promise<AgentCatalogEntry[]>;
     setMessageFeedback?(messageId: string, input: MessageFeedbackInput): Promise<{
         feedback: MessageFeedback | null;
     }>;
@@ -286,6 +294,89 @@ declare class AgentChatTransport implements ChatTransport<UIMessage> {
     private toChunkStream;
 }
 
+interface UseAgentsOptions {
+    /** `useAgentChat(...).backend`, or your own. Must implement `listAgents`. */
+    backend: AgentBackend;
+    /** `false` holds the request. Default `true`. */
+    enabled?: boolean;
+}
+interface AgentsState {
+    /** `[]` until loaded. */
+    agents: AgentCatalogEntry[];
+    /** The agent a turn runs as when none is named. */
+    defaultAgent: 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 }`.
+ */
+declare function useAgents(options: UseAgentsOptions): AgentsState;
+
+interface UseModelsOptions {
+    /** `useAgentChat(...).backend`, or your own. Must implement `listModels`. */
+    backend: AgentBackend;
+    /** The agent to list models for; omitted → the default agent. */
+    agent?: string;
+    /** `false` holds the request. Default `true`. */
+    enabled?: boolean;
+}
+/** A catalog entry with the provider it sits under, for a flat list or a search. */
+interface ModelOption extends ModelCatalogEntry {
+    providerId: string;
+    providerLabel: string;
+}
+interface ModelsState {
+    /** Grouped as the server sent them. `[]` until loaded. */
+    providers: ModelCatalogView['providers'];
+    /** Every model, flattened in provider order. */
+    models: ModelOption[];
+    /** The model a turn runs on when none is picked, or `null` when the provider decides. */
+    defaultModel: string | null;
+    /** The entry for `id`, or `undefined`. */
+    find: (id: string | null | undefined) => ModelOption | undefined;
+    isLoading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+}
+/**
+ * The models this caller may pick (`GET <base>/models?agent=`), with badges and availability — the
+ * data behind a model picker. Headless: render the options however you like, then send the pick
+ * as `useAgentChat({ model })`, `sendMessage(msg, { body: { model } })`, or pin it on the thread
+ * with `chat.setThreadModel(id)`.
+ */
+declare function useModels(options: UseModelsOptions): ModelsState;
+
+interface UseQuotaOptions {
+    /** `useAgentChat(...).backend`, or your own. 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`. */
+    pollMs?: number;
+}
+interface QuotaState {
+    /** The full report, once loaded. */
+    report: QuotaReport | undefined;
+    windows: QuotaWindow[];
+    /** The `day` / `month` windows, when the server reports them. */
+    day: QuotaWindow | undefined;
+    month: QuotaWindow | undefined;
+    /** The window that blocks sends, or `null` — pass it to `useAgentChat({ blocked })`. */
+    blocked: QuotaBlock | null;
+    isLoading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+}
+/**
+ * The caller's budget (`GET <base>/quota`): every window's usage against its ceilings, and which
+ * 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;
+
 interface UseMessageFeedbackOptions {
     /** `useAgentChat(...).backend`, or your own. Must implement `setMessageFeedback`. */
     backend: AgentBackend;
@@ -481,6 +572,12 @@ declare class AgentClient implements AgentBackend {
     uploadAttachment(file: File, options?: UploadAttachmentOptions): Promise<MessageAttachment>;
     promoteThread(id: string): Promise<OkResult>;
     truncateFromMessage(threadId: string, messageId: string): Promise<OkResult>;
+    /** `GET /agent/models?agent=` — the models this caller may pick, grouped by provider. */
+    listModels(agent?: string): Promise<ModelCatalogView>;
+    /** `GET /agent/agents` — the registered agents, the default one flagged. */
+    listAgents(): Promise<AgentCatalogEntry[]>;
+    /** `GET /agent/quota` — the caller's budget windows and the one blocking sends, if any. */
+    getQuota(): Promise<QuotaReport>;
     getQuotaToday(): Promise<QuotaToday>;
     cancelStream(runId: string): Promise<CancelResult>;
     /**
@@ -1308,6 +1405,18 @@ interface UseAgentChatOptions<B extends AgentBackend = AgentClient> {
     client?: B;
     /** Named agent to run each turn. */
     agent?: string;
+    /**
+     * The quota window blocking sends — `useQuota(...).blocked`. While set, `sendMessage` and
+     * `regenerate` refuse with {@link QuotaBlockedError} instead of starting a turn the server would
+     * refuse anyway.
+     */
+    blocked?: QuotaBlock | null;
+    /**
+     * Catalog model to run each turn on (see `useModels`), sent as the body's `model`. Read at every
+     * send, so a picker can change it between turns. Omitted → the thread's pinned model, else the
+     * server default. A single send can still override it with `sendMessage(msg, { body: { model } })`.
+     */
+    model?: string;
     /** Thread this chat is bound to. Omitted → backend creates one on send. */
     threadId?: string;
     /** Persisted history to seed `useChat` with (consumed on mount only). */
@@ -1447,6 +1556,7 @@ declare function useAgentChat<B extends AgentBackend = AgentClient>(options: Use
      * on the first send. A getter, because the created id is learned mid-stream.
      */
     getThreadId: () => string | undefined;
+    setThreadModel: (model: string | null) => Promise<void>;
     /** The backend this chat talks to — pass it to `useThreads`, `useMessageFeedback`, … */
     backend: B;
     /** Same object as {@link backend}; kept for callers that read it under its old name. */
@@ -1491,5 +1601,10 @@ declare function useAgentChat<B extends AgentBackend = AgentClient>(options: Use
     addToolApprovalResponse: ai.ChatAddToolApproveResponseFunction;
     clearError: () => void;
 };
+/** A send refused on the client because a quota window is exhausted (`useAgentChat({ blocked })`). */
+declare class QuotaBlockedError extends Error {
+    readonly block: QuotaBlock;
+    constructor(block: QuotaBlock);
+}
 
-export { type AgentBackend, AgentBackendUnsupportedError, AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentMessageMetadata, type AgentStreamMeta, type AggregatedTurnUsage, AnyToolUIPart, type ApprovalCountdown, ApproveOptions, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type CancelResult, type ChatBackground, ChatInput, type ChatInputProps, ChatStatus, type ChatStreamRequest, type ChatStreamResponse, type ChatTranscript, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type MessageFeedbackInput, type MessageFeedbackState, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type QuotaToday, type ReconnectOptions, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, type ResumeStreamRequest, SPEECH_LANGUAGES, type SkillSuggestionData, type SkillsSourceOptions, type SpeechLanguage, type SpeechRecognitionHook, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type StreamConnectionState, type ThreadPatch, 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, type UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, type UseApprovalCountdownOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseMessageFeedbackOptions, type UseSpeechRecognitionOptions, type UseThreadsOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, applyCompletion, approvalCountdown, backgroundRunsFromThread, createSkillsSource, filterAutocompleteItems, findActiveTrigger, formatElapsed, loadStoredSpeechLang, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, requireBackendMethod, storedMessageToUiMessage, storedThreadToUiMessages, useAgentChat, useApprovalCountdown, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };
+export { type AgentBackend, AgentBackendUnsupportedError, AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentMessageMetadata, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, AnyToolUIPart, type ApprovalCountdown, ApproveOptions, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type CancelResult, type ChatBackground, ChatInput, type ChatInputProps, ChatStatus, type ChatStreamRequest, type ChatStreamResponse, type ChatTranscript, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type MessageFeedbackInput, type MessageFeedbackState, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, QuotaBlockedError, type QuotaState, type QuotaToday, type ReconnectOptions, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, type ResumeStreamRequest, SPEECH_LANGUAGES, type SkillSuggestionData, type SkillsSourceOptions, type SpeechLanguage, type SpeechRecognitionHook, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type StreamConnectionState, type ThreadPatch, 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, type UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, type UseAgentsOptions, type UseApprovalCountdownOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseMessageFeedbackOptions, type UseModelsOptions, type UseQuotaOptions, type UseSpeechRecognitionOptions, type UseThreadsOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, applyCompletion, approvalCountdown, backgroundRunsFromThread, createSkillsSource, filterAutocompleteItems, findActiveTrigger, formatElapsed, loadStoredSpeechLang, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, requireBackendMethod, storedMessageToUiMessage, storedThreadToUiMessages, useAgentChat, useAgents, useApprovalCountdown, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as ai from 'ai';
 import { ChatTransport, UIMessage, UIMessageChunk, DataUIPart, UIDataTypes } from 'ai';
 import * as _dudousxd_nestjs_agent_core from '@dudousxd/nestjs-agent-core';
-import { ThreadSummary, ThreadDetail, MessageAttachment, ToolCatalogEntry, SkillCatalogEntry, QuotaView, MessageFeedbackValue, MessageFeedback, StoredMessage } from '@dudousxd/nestjs-agent-core';
+import { ThreadSummary, ThreadDetail, MessageAttachment, ToolCatalogEntry, SkillCatalogEntry, QuotaView, QuotaReport, ModelCatalogView, AgentCatalogEntry, MessageFeedbackValue, MessageFeedback, ModelCatalogEntry, QuotaWindow, QuotaBlock, StoredMessage } from '@dudousxd/nestjs-agent-core';
 export { ElicitationInput, ElicitationInputType, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
 import React__default from 'react';
 import { 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, T as TranscriptUiBlock } from './model-gHqjNjLJ.js';
@@ -15,10 +15,12 @@ export { f as ApprovalBlockOptions, B as BuildBlocksOptions, g as CoercibleQuest
 interface ThreadPatch {
     title?: string;
     defaultAgent?: string | null;
+    /** Pin a catalog model on the thread; `null` unpins it. */
+    model?: string | null;
 }
 /** Starting a turn: the body `POST <base>/chat` takes (see docs/stream-protocol.md). */
 interface ChatStreamRequest {
-    /** `{ message, threadId?, agent?, attachments?, pageContext?, regenerate?, … }`. */
+    /** `{ message, threadId?, agent?, model?, attachments?, pageContext?, regenerate?, … }`. */
     body: Record<string, unknown>;
     /** Per-request headers the AI SDK was handed for this send. */
     headers?: Record<string, string>;
@@ -104,6 +106,12 @@ interface AgentBackend {
     listTools?(agent?: string): Promise<ToolCatalogEntry[]>;
     listSkills?(threadId?: string): Promise<SkillCatalogEntry[]>;
     getQuotaToday?(): Promise<QuotaView>;
+    /** `GET <base>/quota` — every budget window, and which one blocks sends, if any. */
+    getQuota?(): Promise<QuotaReport>;
+    /** `GET <base>/models?agent=` — what a model picker offers. */
+    listModels?(agent?: string): Promise<ModelCatalogView>;
+    /** `GET <base>/agents` — what an agent picker offers. */
+    listAgents?(): Promise<AgentCatalogEntry[]>;
     setMessageFeedback?(messageId: string, input: MessageFeedbackInput): Promise<{
         feedback: MessageFeedback | null;
     }>;
@@ -286,6 +294,89 @@ declare class AgentChatTransport implements ChatTransport<UIMessage> {
     private toChunkStream;
 }
 
+interface UseAgentsOptions {
+    /** `useAgentChat(...).backend`, or your own. Must implement `listAgents`. */
+    backend: AgentBackend;
+    /** `false` holds the request. Default `true`. */
+    enabled?: boolean;
+}
+interface AgentsState {
+    /** `[]` until loaded. */
+    agents: AgentCatalogEntry[];
+    /** The agent a turn runs as when none is named. */
+    defaultAgent: 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 }`.
+ */
+declare function useAgents(options: UseAgentsOptions): AgentsState;
+
+interface UseModelsOptions {
+    /** `useAgentChat(...).backend`, or your own. Must implement `listModels`. */
+    backend: AgentBackend;
+    /** The agent to list models for; omitted → the default agent. */
+    agent?: string;
+    /** `false` holds the request. Default `true`. */
+    enabled?: boolean;
+}
+/** A catalog entry with the provider it sits under, for a flat list or a search. */
+interface ModelOption extends ModelCatalogEntry {
+    providerId: string;
+    providerLabel: string;
+}
+interface ModelsState {
+    /** Grouped as the server sent them. `[]` until loaded. */
+    providers: ModelCatalogView['providers'];
+    /** Every model, flattened in provider order. */
+    models: ModelOption[];
+    /** The model a turn runs on when none is picked, or `null` when the provider decides. */
+    defaultModel: string | null;
+    /** The entry for `id`, or `undefined`. */
+    find: (id: string | null | undefined) => ModelOption | undefined;
+    isLoading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+}
+/**
+ * The models this caller may pick (`GET <base>/models?agent=`), with badges and availability — the
+ * data behind a model picker. Headless: render the options however you like, then send the pick
+ * as `useAgentChat({ model })`, `sendMessage(msg, { body: { model } })`, or pin it on the thread
+ * with `chat.setThreadModel(id)`.
+ */
+declare function useModels(options: UseModelsOptions): ModelsState;
+
+interface UseQuotaOptions {
+    /** `useAgentChat(...).backend`, or your own. 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`. */
+    pollMs?: number;
+}
+interface QuotaState {
+    /** The full report, once loaded. */
+    report: QuotaReport | undefined;
+    windows: QuotaWindow[];
+    /** The `day` / `month` windows, when the server reports them. */
+    day: QuotaWindow | undefined;
+    month: QuotaWindow | undefined;
+    /** The window that blocks sends, or `null` — pass it to `useAgentChat({ blocked })`. */
+    blocked: QuotaBlock | null;
+    isLoading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+}
+/**
+ * The caller's budget (`GET <base>/quota`): every window's usage against its ceilings, and which
+ * 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;
+
 interface UseMessageFeedbackOptions {
     /** `useAgentChat(...).backend`, or your own. Must implement `setMessageFeedback`. */
     backend: AgentBackend;
@@ -481,6 +572,12 @@ declare class AgentClient implements AgentBackend {
     uploadAttachment(file: File, options?: UploadAttachmentOptions): Promise<MessageAttachment>;
     promoteThread(id: string): Promise<OkResult>;
     truncateFromMessage(threadId: string, messageId: string): Promise<OkResult>;
+    /** `GET /agent/models?agent=` — the models this caller may pick, grouped by provider. */
+    listModels(agent?: string): Promise<ModelCatalogView>;
+    /** `GET /agent/agents` — the registered agents, the default one flagged. */
+    listAgents(): Promise<AgentCatalogEntry[]>;
+    /** `GET /agent/quota` — the caller's budget windows and the one blocking sends, if any. */
+    getQuota(): Promise<QuotaReport>;
     getQuotaToday(): Promise<QuotaToday>;
     cancelStream(runId: string): Promise<CancelResult>;
     /**
@@ -1308,6 +1405,18 @@ interface UseAgentChatOptions<B extends AgentBackend = AgentClient> {
     client?: B;
     /** Named agent to run each turn. */
     agent?: string;
+    /**
+     * The quota window blocking sends — `useQuota(...).blocked`. While set, `sendMessage` and
+     * `regenerate` refuse with {@link QuotaBlockedError} instead of starting a turn the server would
+     * refuse anyway.
+     */
+    blocked?: QuotaBlock | null;
+    /**
+     * Catalog model to run each turn on (see `useModels`), sent as the body's `model`. Read at every
+     * send, so a picker can change it between turns. Omitted → the thread's pinned model, else the
+     * server default. A single send can still override it with `sendMessage(msg, { body: { model } })`.
+     */
+    model?: string;
     /** Thread this chat is bound to. Omitted → backend creates one on send. */
     threadId?: string;
     /** Persisted history to seed `useChat` with (consumed on mount only). */
@@ -1447,6 +1556,7 @@ declare function useAgentChat<B extends AgentBackend = AgentClient>(options: Use
      * on the first send. A getter, because the created id is learned mid-stream.
      */
     getThreadId: () => string | undefined;
+    setThreadModel: (model: string | null) => Promise<void>;
     /** The backend this chat talks to — pass it to `useThreads`, `useMessageFeedback`, … */
     backend: B;
     /** Same object as {@link backend}; kept for callers that read it under its old name. */
@@ -1491,5 +1601,10 @@ declare function useAgentChat<B extends AgentBackend = AgentClient>(options: Use
     addToolApprovalResponse: ai.ChatAddToolApproveResponseFunction;
     clearError: () => void;
 };
+/** A send refused on the client because a quota window is exhausted (`useAgentChat({ blocked })`). */
+declare class QuotaBlockedError extends Error {
+    readonly block: QuotaBlock;
+    constructor(block: QuotaBlock);
+}
 
-export { type AgentBackend, AgentBackendUnsupportedError, AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentMessageMetadata, type AgentStreamMeta, type AggregatedTurnUsage, AnyToolUIPart, type ApprovalCountdown, ApproveOptions, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type CancelResult, type ChatBackground, ChatInput, type ChatInputProps, ChatStatus, type ChatStreamRequest, type ChatStreamResponse, type ChatTranscript, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type MessageFeedbackInput, type MessageFeedbackState, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type QuotaToday, type ReconnectOptions, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, type ResumeStreamRequest, SPEECH_LANGUAGES, type SkillSuggestionData, type SkillsSourceOptions, type SpeechLanguage, type SpeechRecognitionHook, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type StreamConnectionState, type ThreadPatch, 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, type UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, type UseApprovalCountdownOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseMessageFeedbackOptions, type UseSpeechRecognitionOptions, type UseThreadsOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, applyCompletion, approvalCountdown, backgroundRunsFromThread, createSkillsSource, filterAutocompleteItems, findActiveTrigger, formatElapsed, loadStoredSpeechLang, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, requireBackendMethod, storedMessageToUiMessage, storedThreadToUiMessages, useAgentChat, useApprovalCountdown, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };
+export { type AgentBackend, AgentBackendUnsupportedError, AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentMessageMetadata, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, AnyToolUIPart, type ApprovalCountdown, ApproveOptions, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type CancelResult, type ChatBackground, ChatInput, type ChatInputProps, ChatStatus, type ChatStreamRequest, type ChatStreamResponse, type ChatTranscript, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type MessageFeedbackInput, type MessageFeedbackState, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, QuotaBlockedError, type QuotaState, type QuotaToday, type ReconnectOptions, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, type ResumeStreamRequest, SPEECH_LANGUAGES, type SkillSuggestionData, type SkillsSourceOptions, type SpeechLanguage, type SpeechRecognitionHook, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type StreamConnectionState, type ThreadPatch, 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, type UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, type UseAgentsOptions, type UseApprovalCountdownOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseMessageFeedbackOptions, type UseModelsOptions, type UseQuotaOptions, type UseSpeechRecognitionOptions, type UseThreadsOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, applyCompletion, approvalCountdown, backgroundRunsFromThread, createSkillsSource, filterAutocompleteItems, findActiveTrigger, formatElapsed, loadStoredSpeechLang, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, requireBackendMethod, storedMessageToUiMessage, storedThreadToUiMessages, useAgentChat, useAgents, useApprovalCountdown, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };