@dudousxd/nestjs-agent-react 0.16.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, ModelCatalogView, AgentCatalogEntry, MessageFeedbackValue, MessageFeedback, ModelCatalogEntry, 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';
@@ -106,6 +106,8 @@ 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. */
@@ -347,6 +349,34 @@ interface ModelsState {
  */
 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;
@@ -546,6 +576,8 @@ declare class AgentClient implements AgentBackend {
     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>;
     /**
@@ -1373,6 +1405,12 @@ 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
@@ -1563,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 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, 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 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, 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, ModelCatalogView, AgentCatalogEntry, MessageFeedbackValue, MessageFeedback, ModelCatalogEntry, 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';
@@ -106,6 +106,8 @@ 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. */
@@ -347,6 +349,34 @@ interface ModelsState {
  */
 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;
@@ -546,6 +576,8 @@ declare class AgentClient implements AgentBackend {
     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>;
     /**
@@ -1373,6 +1405,12 @@ 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
@@ -1563,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 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, 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 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, 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.js

@@ -156,6 +156,10 @@ var AgentClient = class {
   listAgents() {
     return this.request("GET", "/agent/agents");
   }
+  /** `GET /agent/quota` — the caller's budget windows and the one blocking sends, if any. */
+  getQuota() {
+    return this.request("GET", "/agent/quota");
+  }
   getQuotaToday() {
     return this.request("GET", "/agent/quota/today");
   }
@@ -1103,6 +1107,74 @@ function useModels(options) {
 }
 __name(useModels, "useModels");
 
+// src/quota/use-quota.ts
+import { useEffect as useEffect3, useMemo as useMemo3 } from "react";
+
+// src/threads/threads-events.ts
+var listeners = /* @__PURE__ */ new WeakMap();
+function notifyThreads(backend, event) {
+  for (const listener of listeners.get(backend) ?? []) {
+    listener(event);
+  }
+}
+__name(notifyThreads, "notifyThreads");
+function onThreadsEvent(backend, listener) {
+  let set = listeners.get(backend);
+  if (set === void 0) {
+    set = /* @__PURE__ */ new Set();
+    listeners.set(backend, set);
+  }
+  set.add(listener);
+  return () => {
+    set.delete(listener);
+  };
+}
+__name(onThreadsEvent, "onThreadsEvent");
+
+// src/quota/use-quota.ts
+function useQuota(options) {
+  const { backend, enabled = true, pollMs } = options;
+  const { data, isLoading, error, refresh } = useResource(() => requireBackendMethod(backend, "getQuota")(), "", enabled);
+  useEffect3(() => {
+    if (!enabled) return;
+    return onThreadsEvent(backend, (event) => {
+      if (event.type === "changed") void refresh();
+    });
+  }, [
+    backend,
+    enabled,
+    refresh
+  ]);
+  useEffect3(() => {
+    if (!enabled || pollMs === void 0 || pollMs <= 0) return;
+    const timer = setInterval(() => void refresh(), pollMs);
+    return () => clearInterval(timer);
+  }, [
+    enabled,
+    pollMs,
+    refresh
+  ]);
+  return useMemo3(() => {
+    const windows = data?.windows ?? [];
+    return {
+      report: data,
+      windows,
+      day: windows.find((window2) => window2.period === "day"),
+      month: windows.find((window2) => window2.period === "month"),
+      blocked: data?.blocked ?? null,
+      isLoading,
+      error,
+      refresh
+    };
+  }, [
+    data,
+    isLoading,
+    error,
+    refresh
+  ]);
+}
+__name(useQuota, "useQuota");
+
 // src/feedback/use-message-feedback.ts
 import { useCallback as useCallback2, useRef as useRef3, useState as useState3 } from "react";
 function useMessageFeedback(options) {
@@ -1212,29 +1284,8 @@ function metadataOf(message) {
 }
 __name(metadataOf, "metadataOf");
 
-// src/threads/threads-events.ts
-var listeners = /* @__PURE__ */ new WeakMap();
-function notifyThreads(backend, event) {
-  for (const listener of listeners.get(backend) ?? []) {
-    listener(event);
-  }
-}
-__name(notifyThreads, "notifyThreads");
-function onThreadsEvent(backend, listener) {
-  let set = listeners.get(backend);
-  if (set === void 0) {
-    set = /* @__PURE__ */ new Set();
-    listeners.set(backend, set);
-  }
-  set.add(listener);
-  return () => {
-    set.delete(listener);
-  };
-}
-__name(onThreadsEvent, "onThreadsEvent");
-
 // src/threads/use-threads.ts
-import { useCallback as useCallback3, useEffect as useEffect3, useRef as useRef4, useState as useState4 } from "react";
+import { useCallback as useCallback3, useEffect as useEffect4, useRef as useRef4, useState as useState4 } from "react";
 function useThreads(options) {
   const { backend, enabled = true } = options;
   const [threads, setThreads] = useState4([]);
@@ -1260,7 +1311,7 @@ function useThreads(options) {
   }, [
     backend
   ]);
-  useEffect3(() => {
+  useEffect4(() => {
     if (!enabled) return;
     void refresh();
     return onThreadsEvent(backend, (event) => {
@@ -1377,10 +1428,10 @@ function backgroundRunsFromThread(messages) {
 __name(backgroundRunsFromThread, "backgroundRunsFromThread");
 
 // src/components/chat-input.tsx
-import React2, { useEffect as useEffect5, useState as useState6 } from "react";
+import React2, { useEffect as useEffect6, useState as useState6 } from "react";
 
 // src/components/use-speech-recognition.ts
-import { useCallback as useCallback4, useEffect as useEffect4, useMemo as useMemo3, useRef as useRef5, useState as useState5 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect5, useMemo as useMemo4, useRef as useRef5, useState as useState5 } from "react";
 function getRecognitionCtor() {
   if (typeof window === "undefined") return null;
   const scope = window;
@@ -1390,13 +1441,13 @@ __name(getRecognitionCtor, "getRecognitionCtor");
 function useSpeechRecognition({ lang = "en-US", onFinalTranscript, onInterimTranscript }) {
   const recognitionRef = useRef5(null);
   const [isListening, setIsListening] = useState5(false);
-  const ctor = useMemo3(() => getRecognitionCtor(), []);
+  const ctor = useMemo4(() => getRecognitionCtor(), []);
   const isSupported = ctor !== null;
   const finalRef = useRef5(onFinalTranscript);
   const interimRef = useRef5(onInterimTranscript);
   finalRef.current = onFinalTranscript;
   interimRef.current = onInterimTranscript;
-  useEffect4(() => {
+  useEffect5(() => {
     if (!ctor) return;
     const recognition = new ctor();
     recognition.lang = lang;
@@ -1476,7 +1527,7 @@ function ChatInput({ onSubmit, disabled, placeholder, rows = 2, enableSpeech = t
     }, "onFinalTranscript"),
     onInterimTranscript: /* @__PURE__ */ __name((text) => setInterim(text), "onInterimTranscript")
   });
-  useEffect5(() => {
+  useEffect6(() => {
     if (!speech.isListening) setInterim("");
   }, [
     speech.isListening
@@ -1543,7 +1594,7 @@ __name(ChatInput, "ChatInput");
 import React3 from "react";
 
 // src/transcript/use-chat-transcript.ts
-import { useCallback as useCallback6, useEffect as useEffect7, useRef as useRef7, useState as useState8 } from "react";
+import { useCallback as useCallback6, useEffect as useEffect8, useRef as useRef7, useState as useState8 } from "react";
 
 // src/transcript/model.ts
 import { readElicitationInput, validateElicitationAnswer as validateElicitationAnswer2 } from "@dudousxd/nestjs-agent-core";
@@ -2520,7 +2571,7 @@ function formatCostUsd(cost) {
 __name(formatCostUsd, "formatCostUsd");
 
 // src/transcript/use-stick-to-bottom.ts
-import { useCallback as useCallback5, useEffect as useEffect6, useRef as useRef6, useState as useState7 } from "react";
+import { useCallback as useCallback5, useEffect as useEffect7, useRef as useRef6, useState as useState7 } from "react";
 function useStickToBottom({ contentKey, threshold = 32 }) {
   const containerRef = useRef6(null);
   const [isAtBottom, setIsAtBottom] = useState7(true);
@@ -2550,7 +2601,7 @@ function useStickToBottom({ contentKey, threshold = 32 }) {
   }, [
     measure
   ]);
-  useEffect6(() => {
+  useEffect7(() => {
     if (isAtBottom) {
       scrollToBottom();
     }
@@ -2588,7 +2639,7 @@ function useChatTranscript(options) {
   const isStreaming = status === "streaming" || status === "reconnecting";
   const isBusy = status === "submitted" || isStreaming;
   const isEmpty = messages.length === 0;
-  useEffect7(() => {
+  useEffect8(() => {
     if (!isBusy) {
       setStopRequested(false);
     }
@@ -2687,7 +2738,7 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
     messages
   };
   const copyTimers = useRef7(/* @__PURE__ */ new Map());
-  useEffect7(() => () => {
+  useEffect8(() => () => {
     for (const timer of copyTimers.current.values()) {
       clearTimeout(timer);
     }
@@ -3430,7 +3481,7 @@ function toItem(entry) {
 __name(toItem, "toItem");
 
 // src/composer/use-composer-autocomplete.ts
-import { useCallback as useCallback7, useEffect as useEffect8, useId, useLayoutEffect, useMemo as useMemo4, useRef as useRef8, useState as useState9 } from "react";
+import { useCallback as useCallback7, useEffect as useEffect9, useId, useLayoutEffect, useMemo as useMemo5, useRef as useRef8, useState as useState9 } from "react";
 function useComposerAutocomplete(options) {
   const { value, sources, acceptOnTab = true } = options;
   const latest = useRef8(options);
@@ -3443,7 +3494,7 @@ function useComposerAutocomplete(options) {
   const [activeIndex, setActiveIndex] = useState9(0);
   const [dismissedIndex, setDismissedIndex] = useState9(null);
   const safeCaret = Math.min(caret, value.length);
-  const match = useMemo4(() => findActiveTrigger(value, safeCaret, sources), [
+  const match = useMemo5(() => findActiveTrigger(value, safeCaret, sources), [
     value,
     safeCaret,
     sources
@@ -3458,7 +3509,7 @@ function useComposerAutocomplete(options) {
   const activeIndexRef = useRef8(activeIndex);
   activeIndexRef.current = activeIndex;
   const requestKey = isActive && match ? `${match.source.id}\0${match.query}` : null;
-  useEffect8(() => {
+  useEffect9(() => {
     const current = matchRef.current;
     if (requestKey === null || current === null) {
       setItems([]);
@@ -3668,7 +3719,7 @@ function isPromise(value) {
 __name(isPromise, "isPromise");
 
 // src/presentation/use-tool-catalog.ts
-import { useCallback as useCallback8, useEffect as useEffect9, useMemo as useMemo5, useState as useState10 } from "react";
+import { useCallback as useCallback8, useEffect as useEffect10, useMemo as useMemo6, useState as useState10 } from "react";
 var shared = /* @__PURE__ */ new WeakMap();
 function load(client, agent) {
   let byAgent = shared.get(client);
@@ -3696,7 +3747,7 @@ function useToolCatalog(options) {
   const [isLoading, setLoading] = useState10(enabled);
   const [error, setError] = useState10(null);
   const [generation, setGeneration] = useState10(0);
-  useEffect9(() => {
+  useEffect10(() => {
     if (!enabled) {
       setLoading(false);
       return;
@@ -3729,7 +3780,7 @@ function useToolCatalog(options) {
     client,
     agent
   ]);
-  const catalog = useMemo5(() => toolCatalogFrom(entries), [
+  const catalog = useMemo6(() => toolCatalogFrom(entries), [
     entries
   ]);
   return {
@@ -3743,7 +3794,7 @@ function useToolCatalog(options) {
 __name(useToolCatalog, "useToolCatalog");
 
 // src/approvals/countdown.ts
-import { useEffect as useEffect10, useRef as useRef9, useState as useState11 } from "react";
+import { useEffect as useEffect11, useRef as useRef9, useState as useState11 } from "react";
 function approvalCountdown(expiresAt, now = Date.now()) {
   const deadline = expiresAt == null ? Number.NaN : Date.parse(expiresAt);
   if (!Number.isFinite(deadline)) {
@@ -3764,7 +3815,7 @@ function useApprovalCountdown(expiresAt, options = {}) {
   const nowRef = useRef9(options.now ?? Date.now);
   nowRef.current = options.now ?? Date.now;
   const [state, setState] = useState11(() => approvalCountdown(expiresAt, nowRef.current()));
-  useEffect10(() => {
+  useEffect11(() => {
     const read = /* @__PURE__ */ __name(() => approvalCountdown(expiresAt, nowRef.current()), "read");
     const first = read();
     setState(first);
@@ -4006,7 +4057,7 @@ __name(sumUsage, "sumUsage");
 
 // src/use-agent-chat.ts
 import { useChat } from "@ai-sdk/react";
-import { useCallback as useCallback9, useEffect as useEffect11, useMemo as useMemo6, useRef as useRef10, useState as useState12 } from "react";
+import { useCallback as useCallback9, useEffect as useEffect12, useMemo as useMemo7, useRef as useRef10, useState as useState12 } from "react";
 function useAgentChat(options) {
   const latest = useRef10(options);
   latest.current = options;
@@ -4019,7 +4070,7 @@ function useAgentChat(options) {
   const [activeRunId, setActiveRunId] = useState12(null);
   const regenerateNext = useRef10(false);
   const createdThreadId = useRef10(void 0);
-  const client = useMemo6(() => {
+  const client = useMemo7(() => {
     if (options.backend) return options.backend;
     if (options.client) return options.client;
     return new AgentClient({
@@ -4039,7 +4090,7 @@ function useAgentChat(options) {
     status: "live"
   });
   const resyncAfterSettle = useRef10(false);
-  useEffect11(() => {
+  useEffect12(() => {
     if (!options.resume || options.threadId === void 0) return;
     let cancelled = false;
     const threadId = options.threadId;
@@ -4059,7 +4110,7 @@ function useAgentChat(options) {
     options.resume,
     options.threadId
   ]);
-  const transport = useMemo6(() => {
+  const transport = useMemo7(() => {
     function onMeta(meta) {
       settlingRunIdRef.current = meta.runId;
       setRunId(meta.runId);
@@ -4180,6 +4231,8 @@ function useAgentChat(options) {
     transport
   ]);
   const sendMessage = useCallback9(async (...args) => {
+    const blocked = latest.current.blocked;
+    if (blocked != null) throw new QuotaBlockedError(blocked);
     if (isTurnInFlight()) return;
     turnInFlight.current = true;
     try {
@@ -4223,7 +4276,7 @@ function useAgentChat(options) {
   ]);
   backgroundRef.current = refreshBackground;
   const isWorking = backgroundRuns.some((run) => run.status === "running");
-  useEffect11(() => {
+  useEffect12(() => {
     if (options.background !== true || options.threadId === void 0) {
       return;
     }
@@ -4233,7 +4286,7 @@ function useAgentChat(options) {
     options.threadId,
     refreshBackground
   ]);
-  useEffect11(() => {
+  useEffect12(() => {
     const every = latest.current.backgroundPollMs ?? 5e3;
     if (latest.current.background !== true || !isWorking || every <= 0) {
       return;
@@ -4347,6 +4400,8 @@ function useAgentChat(options) {
     client
   ]);
   const regenerate = useCallback9(() => {
+    const blocked = latest.current.blocked;
+    if (blocked != null) throw new QuotaBlockedError(blocked);
     if (isTurnInFlight()) return;
     regenerateNext.current = true;
     turnInFlight.current = true;
@@ -4418,6 +4473,16 @@ function useAgentChat(options) {
   };
 }
 __name(useAgentChat, "useAgentChat");
+var QuotaBlockedError = class extends Error {
+  static {
+    __name(this, "QuotaBlockedError");
+  }
+  block;
+  constructor(block) {
+    super(block.reason ?? `The ${block.period === "day" ? "daily" : "monthly"} quota is used up`), this.block = block;
+    this.name = "QuotaBlockedError";
+  }
+};
 async function mergeHeaders(options) {
   const dynamic = await options.getHeaders?.() ?? {};
   return {
@@ -4436,6 +4501,7 @@ export {
   MessageItem,
   MessageItemView,
   MessageList,
+  QuotaBlockedError,
   SPEECH_LANGUAGES,
   applyCompletion,
   approvalCountdown,
@@ -4477,6 +4543,7 @@ export {
   useElapsed,
   useMessageFeedback,
   useModels,
+  useQuota,
   useSpeechRecognition,
   useStickToBottom,
   useThreads,