@dudousxd/nestjs-agent-react 0.26.0 → 0.27.0

package/dist/index.d.cts

@@ -1,13 +1,13 @@
 import * as ai from 'ai';
 import { ChatTransport, UIMessage, UIMessageChunk, DataUIPart, UIDataTypes } from 'ai';
-import { A as AgentBackend, U as UploadAttachmentOptions, H as HttpErrorListener, a as AttachmentUploadStrategy } from './client-D4ZSbZJ8.cjs';
-export { b as AgentBackendUnsupportedError, c as AgentClient, d as AgentClientOptions, e as AgentConnection, f as AgentHttpError, g as AgentRequestError, C as CancelResult, h as ChatStreamRequest, i as ChatStreamResponse, M as MessageFeedbackInput, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-D4ZSbZJ8.cjs';
-import { MessageAttachment, AgentClientConfig, AgentCatalogEntry, ModelCatalogEntry, ModelCatalogView, ModelCatalogLock, QuotaReport, QuotaWindow, QuotaBlock, QuotaWarning, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, ToolCatalogEntry } from '@dudousxd/nestjs-agent-core';
-export { ALL_AGENTS, ElicitationInput, ElicitationInputType, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
+import { A as AgentBackend, U as UploadAttachmentOptions, H as HttpErrorListener, a as AttachmentUploadStrategy } from './client-DNM5Qm5N.cjs';
+export { b as AgentBackendUnsupportedError, c as AgentClient, d as AgentClientOptions, e as AgentConnection, f as AgentHttpError, g as AgentRequestError, C as CancelResult, h as ChatStreamRequest, i as ChatStreamResponse, M as MessageFeedbackInput, Q as QueuedMessageUpdate, j as QueuedSendResult, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-DNM5Qm5N.cjs';
+import { MessageAttachment, AgentClientConfig, AgentCatalogEntry, ModelCatalogEntry, ModelCatalogView, ModelCatalogLock, QuotaReport, QuotaWindow, QuotaBlock, QuotaWarning, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, QueuePause, ToolCatalogEntry } from '@dudousxd/nestjs-agent-core';
+export { ALL_AGENTS, ChatQueueState, ElicitationInput, ElicitationInputType, QueuePause, QueuePauseReason, QueuedMessageView, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
 import * as React from 'react';
 import React__default, { ReactNode, Context } from 'react';
-import { o as GenuiProviderValue, T as TranscriptUiBlock, A as ApproveOptions, t as TranscriptBlock, U as UsageSummary, v as TimestampInfo, C as ChatStatus, M as MessageUsageInfo, w as ToolCatalog, x as AnyToolUIPart, y as TranscriptFile } from './generative-ui-BejHxxbR.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-BejHxxbR.cjs';
+import { o as GenuiProviderValue, T as TranscriptUiBlock, A as ApproveOptions, t as TranscriptBlock, U as UsageSummary, v as TimestampInfo, C as ChatStatus, w as TranscriptFile, M as MessageUsageInfo, x as ToolCatalog, y as AnyToolUIPart } from './generative-ui-jT9TYfCi.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-jT9TYfCi.cjs';
 
 /** Identity surfaced by the backend's `meta` SSE frame / response headers. */
 interface AgentStreamMeta {
@@ -94,6 +94,12 @@ interface AgentChatTransportOptions {
      * an early failure (no meta ever arrives) to a PRIOR attempt's id.
      */
     onAttemptStart?: () => void;
+    /**
+     * A resume found nothing streaming under the run id (the backend answered 404): the run already
+     * ended. The SDK is told there is nothing to resume, so the caller is the one that has to reload
+     * what the run wrote — `useAgentChat` re-reads the thread.
+     */
+    onResumeGone?: (runId: string) => void;
     /** Injectable for tests / non-browser runtimes. Defaults to global fetch. */
     fetch?: typeof fetch;
 }
@@ -120,7 +126,9 @@ interface AgentChatTransportOptions {
  *                           native `tool-approval-request` (the part moves to `approval-requested`)
  *  - `approval-settled`   → `data-approval-settled` part keyed by the call id (who decided, through
  *                           what, remembered or not); the outcome still rides the call's own output
- *  - `title`, `cancelled` → transient `data-title` / `data-cancelled` (never stored on the message)
+ *  - `title`, `cancelled`, `queue` → transient `data-title` / `data-cancelled` / `data-queue` (never
+ *                           stored on the message). A send the server queued (`202`) is reported
+ *                           as a transient `data-queue` too, carrying `queuedSend`
  *  - any other kind       → `data-<kind>` part carrying the frame minus `kind`, keyed by its `id`
  *                           when it has one — forwarded, never dropped
  * `parentId` on a tool frame rides the part's `toolMetadata` next to `toolKind`.
@@ -645,6 +653,55 @@ interface ChatInputProps {
  */
 declare function ChatInput({ onSubmit, disabled, placeholder, rows, enableSpeech, speechLang, sendLabel, onStop, isStreaming, stopLabel, className, textareaClassName, sendButtonClassName, micButtonClassName, stopButtonClassName, renderMic, }: ChatInputProps): React__default.JSX.Element;
 
+/**
+ * What the composer (and `sendMessage`) does with a message sent while a turn is still running:
+ *  - `'queue'` (default) — it waits in the thread's queue and runs when the turn settles.
+ *  - `'interrupt'` — the running turn is cancelled and this message runs next.
+ *  - `'block'` — the composer refuses it (`blockedBy: 'busy'`), as before queues existed.
+ */
+type WhileRunning = 'queue' | 'interrupt' | 'block';
+/** A message waiting in the thread's queue, as the chat shows it. */
+interface QueuedChatMessage {
+    /** The server's id once it is queued; a local id while `state` is `'sending'`. */
+    id: string;
+    text: string;
+    attachments: MessageAttachment[];
+    /**
+     * `'sending'` — on its way to the server (it has no server id yet, so it cannot be edited).
+     * `'queued'` — waiting its turn.
+     */
+    state: 'sending' | 'queued';
+    /** Queued by an interrupt: it runs as soon as the cancelled turn settles. */
+    interrupt: boolean;
+    createdAt: string;
+}
+/** `chat.queue` — the thread's queue of waiting messages, and what can be done to it. */
+interface ChatQueue {
+    /** Waiting messages, in the order they will run. */
+    items: QueuedChatMessage[];
+    /** Why the queue stopped draining (a failed turn, a Stop, the quota), or `null`. */
+    paused: QueuePause | null;
+    /** The backend can queue (`enqueueMessage`). Without it sends made mid-turn are refused. */
+    isSupported: boolean;
+    /**
+     * Queue `text` (with already-uploaded `attachments`) on this chat's thread. `mode: 'interrupt'`
+     * cancels the running turn and runs it next. Starts at once when nothing is running.
+     */
+    add: (text: string, options?: {
+        attachments?: MessageAttachment[];
+        mode?: 'queue' | 'interrupt';
+    }) => Promise<void>;
+    remove: (id: string) => Promise<void>;
+    edit: (id: string, text: string) => Promise<void>;
+    /** Move a waiting message to `index` (0 → next). */
+    move: (id: string, index: number) => Promise<void>;
+    clear: () => Promise<void>;
+    /** Lift a pause; the head starts when nothing is running. */
+    resume: () => Promise<void>;
+    /** The last queue operation that failed, or `null`. */
+    error: Error | null;
+}
+
 interface StickToBottomOptions {
     /**
      * Changes whenever the rendered content grows — the signal to re-pin. A string rather than the
@@ -840,6 +897,37 @@ interface UseChatTranscriptOptions extends TranscriptItemOptions {
     /** Suggested follow-ups. The model only decides WHETHER they belong on screen. */
     followUps?: string[] | null;
     stickToBottomThreshold?: number;
+    /**
+     * Messages waiting in the thread's queue — `chat.queue` (`useAgentChat` wires it). They render
+     * after the transcript as {@link ChatTranscript.queued}: pending user messages, not yet sent.
+     */
+    queue?: {
+        items: QueuedChatMessage[];
+        paused: QueuePause | null;
+        remove?: (id: string) => void | Promise<void>;
+    } | null;
+}
+/**
+ * A message waiting in the thread's queue, as the transcript shows it: a user message that has not
+ * been sent to the model yet. Render it after {@link ChatTranscript.items}, dimmed or tagged.
+ */
+interface TranscriptQueuedItem {
+    id: string;
+    role: 'user';
+    text: string;
+    files: TranscriptFile[];
+    /**
+     * `'sending'` — on its way to the server. `'queued'` — waiting for the running turn.
+     * `'paused'` — waiting, but the queue is paused (see {@link ChatTranscript.queuePaused}).
+     */
+    state: 'sending' | 'queued' | 'paused';
+    /** 0-based place in the queue. */
+    position: number;
+    /** Runs next. */
+    isNext: boolean;
+    /** Queued by an interrupt — it runs as soon as the cancelled turn settles. */
+    interrupt: boolean;
+    remove: TranscriptActionState;
 }
 interface ChatTranscript {
     /** The mounted window, oldest first. `window.hiddenCount` says what is held back. */
@@ -857,6 +945,10 @@ interface ChatTranscript {
     window: TranscriptWindow;
     scroll: StickToBottom;
     stop: TranscriptStopState;
+    /** Messages waiting in the thread's queue, in run order — render after `items`. */
+    queued: TranscriptQueuedItem[];
+    /** Why the queue is not draining, or `null`. */
+    queuePaused: QueuePause | null;
 }
 /**
  * The model behind a chat transcript: messages normalized into items with their parts grouped into
@@ -980,6 +1072,14 @@ interface MessageListClassNames {
     errorRetry?: string;
     followUps?: string;
     followUpChip?: string;
+    /** The block of waiting (queued) messages after the transcript. */
+    queue?: string;
+    /** One waiting message; it also carries `data-state="sending|queued|paused"`. */
+    queuedItem?: string;
+    queuedRemove?: string;
+    /** The "queue paused" line and its resume button. */
+    queuePaused?: string;
+    queueResume?: string;
     message?: MessageItemClassNames;
 }
 interface MessageListProps {
@@ -1023,6 +1123,11 @@ interface MessageListProps {
     /** Last turn's error — paired with `onRetry`, renders a retry banner. */
     error?: Error | null;
     onRetry?: () => void | Promise<void>;
+    /**
+     * `chat.queue` — messages sent while a turn was running, drawn after the transcript as pending
+     * user messages (with a remove button), and a resume button while the queue is paused.
+     */
+    queue?: ChatQueue;
     classNames?: MessageListClassNames;
 }
 /**
@@ -1034,7 +1139,7 @@ interface MessageListProps {
  * Every decision here comes from `useChatTranscript`; the file below it is markup. A host that
  * wants a different layout drives that hook directly and never imports this component.
  */
-declare function MessageList({ messages, status, renderToolPart, renderToolGroup, renderText, renderReasoning, renderFiles, renderUi, reasoningLabel, getMeta, readOnly, onFork, editable, onEditSubmit, regeneratable, onRegenerate, getUsage, getCreatedAt, emptyState, typingIndicator, followUps, onFollowUpClick, error, onRetry, classNames, }: MessageListProps): React__default.JSX.Element;
+declare function MessageList({ messages, status, renderToolPart, renderToolGroup, renderText, renderReasoning, renderFiles, renderUi, reasoningLabel, getMeta, readOnly, onFork, editable, onEditSubmit, regeneratable, onRegenerate, getUsage, getCreatedAt, emptyState, typingIndicator, followUps, onFollowUpClick, error, onRetry, queue, classNames, }: MessageListProps): React__default.JSX.Element;
 
 /**
  * Languages the dictation mic offers. The Web Speech API expects a
@@ -1482,6 +1587,14 @@ interface UseAgentChatOptions<B extends AgentBackend = AgentBackend> {
     blocked?: QuotaBlock | null;
     /** Validation and upload for `chat.composer.files` — see `useAttachments`. */
     composer?: Omit<UseAttachmentsOptions, 'backend'>;
+    /**
+     * What `composer.submit()` and `sendMessage` do while a turn is still running. Default `'queue'`:
+     * the message waits in the thread's queue (server-side — it survives a reload) and runs when the
+     * turn settles; `chat.queue` lists and edits what is waiting. `'interrupt'` cancels the running
+     * turn and runs the message next. `'block'` refuses the send (`composer.blockedBy === 'busy'`).
+     * A backend without `enqueueMessage` behaves as `'block'`.
+     */
+    whileRunning?: WhileRunning;
     /**
      * Overrides for `chat.transcript` — anything `useChatTranscript` takes (`sources`, `editable` +
      * `onEditSubmit`, `followUps`, `getUsage`, a `toolCatalog` of your own, `onApprove: null`, …).
@@ -1650,6 +1763,11 @@ declare function useAgentChat<B extends AgentBackend = AgentBackend>(options?: U
     transcript: ChatTranscript;
     /** A headless composer: draft, files, send gate, `submit()`. */
     composer: ChatComposer;
+    /**
+     * Messages sent while a turn was running, waiting their turn (server-side): list, edit, move,
+     * remove, clear, and resume a paused queue.
+     */
+    queue: ChatQueue;
     /** The model picker: `list`, `selected`, `select(id)`, `pinToThread(id)`. */
     models: ChatModels;
     /** The caller's budget (`GET <base>/quota`); `quota.blocked` gates sends. */
@@ -1687,4 +1805,4 @@ declare class QuotaBlockedError extends Error {
     constructor(block: QuotaBlock);
 }
 
-export { AgentBackend, AgentChatTransport, type AgentChatTransportOptions, type AgentConfigState, type AgentMessageMetadata, AgentProvider, type AgentProviderProps, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, type AmbientRenderUi, AmbientRenderUiContext, type AnswerInput, AnyToolUIPart, type ApprovalCountdown, type ApproveInput, ApproveOptions, type AttachmentRejection, AttachmentUploadStrategy, type AttachmentsState, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type ChatBackground, ChatInput, type ChatInputProps, ChatStatus, type ChatTranscript, type ClipboardLikeEvent, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DragLikeEvent, type EditSubmitInput, HttpErrorListener, type MessageActionInput, type MessageFeedbackState, type MessageFile, type MessageFileKind, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, QuotaBlockedError, type QuotaState, type ReconnectOptions, type RejectInput, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, SPEECH_LANGUAGES, type SkillSuggestionData, type SkillsSourceOptions, type SkipInput, type SpeechLanguage, type SpeechRecognitionHook, type StagedAttachment, type StagedAttachmentStatus, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type StreamConnectionState, type ThreadsEvent, type ThreadsState, TimestampInfo, ToolCatalog, type ToolCatalogState, type TranscriptActionState, TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, TranscriptFile, type TranscriptItem, type TranscriptItemOptions, type TranscriptStopState, TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, type UseAgentConfigOptions, type UseAgentsOptions, type UseApprovalCountdownOptions, type UseAttachmentsOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseMessageFeedbackOptions, type UseModelsOptions, type UseQuotaOptions, type UseSpeechRecognitionOptions, type UseThreadsOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, acceptsFile, applyCompletion, approvalCountdown, backgroundRunsFromThread, createSkillsSource, dragHasFiles, fileKind, filesFromClipboard, filterAutocompleteItems, findActiveTrigger, formatElapsed, loadStoredSpeechLang, messageFiles, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, storedMessageToUiMessage, storedThreadToUiMessages, useAgentBackend, useAgentChat, useAgentConfig, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };
+export { AgentBackend, AgentChatTransport, type AgentChatTransportOptions, type AgentConfigState, type AgentMessageMetadata, AgentProvider, type AgentProviderProps, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, type AmbientRenderUi, AmbientRenderUiContext, type AnswerInput, AnyToolUIPart, type ApprovalCountdown, type ApproveInput, ApproveOptions, type AttachmentRejection, AttachmentUploadStrategy, type AttachmentsState, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type ChatBackground, ChatInput, type ChatInputProps, type ChatQueue, ChatStatus, type ChatTranscript, type ClipboardLikeEvent, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DragLikeEvent, type EditSubmitInput, HttpErrorListener, type MessageActionInput, type MessageFeedbackState, type MessageFile, type MessageFileKind, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, type QueuedChatMessage, QuotaBlockedError, type QuotaState, type ReconnectOptions, type RejectInput, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, SPEECH_LANGUAGES, type SkillSuggestionData, type SkillsSourceOptions, type SkipInput, type SpeechLanguage, type SpeechRecognitionHook, type StagedAttachment, type StagedAttachmentStatus, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type StreamConnectionState, type ThreadsEvent, type ThreadsState, TimestampInfo, ToolCatalog, type ToolCatalogState, type TranscriptActionState, TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, TranscriptFile, type TranscriptItem, type TranscriptItemOptions, type TranscriptQueuedItem, type TranscriptStopState, TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, type UseAgentConfigOptions, type UseAgentsOptions, type UseApprovalCountdownOptions, type UseAttachmentsOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseMessageFeedbackOptions, type UseModelsOptions, type UseQuotaOptions, type UseSpeechRecognitionOptions, type UseThreadsOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, type WhileRunning, acceptsFile, applyCompletion, approvalCountdown, backgroundRunsFromThread, createSkillsSource, dragHasFiles, fileKind, filesFromClipboard, filterAutocompleteItems, findActiveTrigger, formatElapsed, loadStoredSpeechLang, messageFiles, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, storedMessageToUiMessage, storedThreadToUiMessages, useAgentBackend, useAgentChat, useAgentConfig, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 import * as ai from 'ai';
 import { ChatTransport, UIMessage, UIMessageChunk, DataUIPart, UIDataTypes } from 'ai';
-import { A as AgentBackend, U as UploadAttachmentOptions, H as HttpErrorListener, a as AttachmentUploadStrategy } from './client-D4ZSbZJ8.js';
-export { b as AgentBackendUnsupportedError, c as AgentClient, d as AgentClientOptions, e as AgentConnection, f as AgentHttpError, g as AgentRequestError, C as CancelResult, h as ChatStreamRequest, i as ChatStreamResponse, M as MessageFeedbackInput, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-D4ZSbZJ8.js';
-import { MessageAttachment, AgentClientConfig, AgentCatalogEntry, ModelCatalogEntry, ModelCatalogView, ModelCatalogLock, QuotaReport, QuotaWindow, QuotaBlock, QuotaWarning, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, ToolCatalogEntry } from '@dudousxd/nestjs-agent-core';
-export { ALL_AGENTS, ElicitationInput, ElicitationInputType, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
+import { A as AgentBackend, U as UploadAttachmentOptions, H as HttpErrorListener, a as AttachmentUploadStrategy } from './client-DNM5Qm5N.js';
+export { b as AgentBackendUnsupportedError, c as AgentClient, d as AgentClientOptions, e as AgentConnection, f as AgentHttpError, g as AgentRequestError, C as CancelResult, h as ChatStreamRequest, i as ChatStreamResponse, M as MessageFeedbackInput, Q as QueuedMessageUpdate, j as QueuedSendResult, R as ResumeStreamRequest, T as ThreadPatch, r as requireBackendMethod } from './client-DNM5Qm5N.js';
+import { MessageAttachment, AgentClientConfig, AgentCatalogEntry, ModelCatalogEntry, ModelCatalogView, ModelCatalogLock, QuotaReport, QuotaWindow, QuotaBlock, QuotaWarning, MessageFeedback, MessageFeedbackValue, ThreadSummary, StoredMessage, QueuePause, ToolCatalogEntry } from '@dudousxd/nestjs-agent-core';
+export { ALL_AGENTS, ChatQueueState, ElicitationInput, ElicitationInputType, QueuePause, QueuePauseReason, QueuedMessageView, validateElicitationAnswer as validateAnswer, validateElicitationValue as validateAnswerValue } from '@dudousxd/nestjs-agent-core';
 import * as React from 'react';
 import React__default, { ReactNode, Context } from 'react';
-import { o as GenuiProviderValue, T as TranscriptUiBlock, A as ApproveOptions, t as TranscriptBlock, U as UsageSummary, v as TimestampInfo, C as ChatStatus, M as MessageUsageInfo, w as ToolCatalog, x as AnyToolUIPart, y as TranscriptFile } from './generative-ui-BejHxxbR.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-BejHxxbR.js';
+import { o as GenuiProviderValue, T as TranscriptUiBlock, A as ApproveOptions, t as TranscriptBlock, U as UsageSummary, v as TimestampInfo, C as ChatStatus, w as TranscriptFile, M as MessageUsageInfo, x as ToolCatalog, y as AnyToolUIPart } from './generative-ui-jT9TYfCi.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-jT9TYfCi.js';
 
 /** Identity surfaced by the backend's `meta` SSE frame / response headers. */
 interface AgentStreamMeta {
@@ -94,6 +94,12 @@ interface AgentChatTransportOptions {
      * an early failure (no meta ever arrives) to a PRIOR attempt's id.
      */
     onAttemptStart?: () => void;
+    /**
+     * A resume found nothing streaming under the run id (the backend answered 404): the run already
+     * ended. The SDK is told there is nothing to resume, so the caller is the one that has to reload
+     * what the run wrote — `useAgentChat` re-reads the thread.
+     */
+    onResumeGone?: (runId: string) => void;
     /** Injectable for tests / non-browser runtimes. Defaults to global fetch. */
     fetch?: typeof fetch;
 }
@@ -120,7 +126,9 @@ interface AgentChatTransportOptions {
  *                           native `tool-approval-request` (the part moves to `approval-requested`)
  *  - `approval-settled`   → `data-approval-settled` part keyed by the call id (who decided, through
  *                           what, remembered or not); the outcome still rides the call's own output
- *  - `title`, `cancelled` → transient `data-title` / `data-cancelled` (never stored on the message)
+ *  - `title`, `cancelled`, `queue` → transient `data-title` / `data-cancelled` / `data-queue` (never
+ *                           stored on the message). A send the server queued (`202`) is reported
+ *                           as a transient `data-queue` too, carrying `queuedSend`
  *  - any other kind       → `data-<kind>` part carrying the frame minus `kind`, keyed by its `id`
  *                           when it has one — forwarded, never dropped
  * `parentId` on a tool frame rides the part's `toolMetadata` next to `toolKind`.
@@ -645,6 +653,55 @@ interface ChatInputProps {
  */
 declare function ChatInput({ onSubmit, disabled, placeholder, rows, enableSpeech, speechLang, sendLabel, onStop, isStreaming, stopLabel, className, textareaClassName, sendButtonClassName, micButtonClassName, stopButtonClassName, renderMic, }: ChatInputProps): React__default.JSX.Element;
 
+/**
+ * What the composer (and `sendMessage`) does with a message sent while a turn is still running:
+ *  - `'queue'` (default) — it waits in the thread's queue and runs when the turn settles.
+ *  - `'interrupt'` — the running turn is cancelled and this message runs next.
+ *  - `'block'` — the composer refuses it (`blockedBy: 'busy'`), as before queues existed.
+ */
+type WhileRunning = 'queue' | 'interrupt' | 'block';
+/** A message waiting in the thread's queue, as the chat shows it. */
+interface QueuedChatMessage {
+    /** The server's id once it is queued; a local id while `state` is `'sending'`. */
+    id: string;
+    text: string;
+    attachments: MessageAttachment[];
+    /**
+     * `'sending'` — on its way to the server (it has no server id yet, so it cannot be edited).
+     * `'queued'` — waiting its turn.
+     */
+    state: 'sending' | 'queued';
+    /** Queued by an interrupt: it runs as soon as the cancelled turn settles. */
+    interrupt: boolean;
+    createdAt: string;
+}
+/** `chat.queue` — the thread's queue of waiting messages, and what can be done to it. */
+interface ChatQueue {
+    /** Waiting messages, in the order they will run. */
+    items: QueuedChatMessage[];
+    /** Why the queue stopped draining (a failed turn, a Stop, the quota), or `null`. */
+    paused: QueuePause | null;
+    /** The backend can queue (`enqueueMessage`). Without it sends made mid-turn are refused. */
+    isSupported: boolean;
+    /**
+     * Queue `text` (with already-uploaded `attachments`) on this chat's thread. `mode: 'interrupt'`
+     * cancels the running turn and runs it next. Starts at once when nothing is running.
+     */
+    add: (text: string, options?: {
+        attachments?: MessageAttachment[];
+        mode?: 'queue' | 'interrupt';
+    }) => Promise<void>;
+    remove: (id: string) => Promise<void>;
+    edit: (id: string, text: string) => Promise<void>;
+    /** Move a waiting message to `index` (0 → next). */
+    move: (id: string, index: number) => Promise<void>;
+    clear: () => Promise<void>;
+    /** Lift a pause; the head starts when nothing is running. */
+    resume: () => Promise<void>;
+    /** The last queue operation that failed, or `null`. */
+    error: Error | null;
+}
+
 interface StickToBottomOptions {
     /**
      * Changes whenever the rendered content grows — the signal to re-pin. A string rather than the
@@ -840,6 +897,37 @@ interface UseChatTranscriptOptions extends TranscriptItemOptions {
     /** Suggested follow-ups. The model only decides WHETHER they belong on screen. */
     followUps?: string[] | null;
     stickToBottomThreshold?: number;
+    /**
+     * Messages waiting in the thread's queue — `chat.queue` (`useAgentChat` wires it). They render
+     * after the transcript as {@link ChatTranscript.queued}: pending user messages, not yet sent.
+     */
+    queue?: {
+        items: QueuedChatMessage[];
+        paused: QueuePause | null;
+        remove?: (id: string) => void | Promise<void>;
+    } | null;
+}
+/**
+ * A message waiting in the thread's queue, as the transcript shows it: a user message that has not
+ * been sent to the model yet. Render it after {@link ChatTranscript.items}, dimmed or tagged.
+ */
+interface TranscriptQueuedItem {
+    id: string;
+    role: 'user';
+    text: string;
+    files: TranscriptFile[];
+    /**
+     * `'sending'` — on its way to the server. `'queued'` — waiting for the running turn.
+     * `'paused'` — waiting, but the queue is paused (see {@link ChatTranscript.queuePaused}).
+     */
+    state: 'sending' | 'queued' | 'paused';
+    /** 0-based place in the queue. */
+    position: number;
+    /** Runs next. */
+    isNext: boolean;
+    /** Queued by an interrupt — it runs as soon as the cancelled turn settles. */
+    interrupt: boolean;
+    remove: TranscriptActionState;
 }
 interface ChatTranscript {
     /** The mounted window, oldest first. `window.hiddenCount` says what is held back. */
@@ -857,6 +945,10 @@ interface ChatTranscript {
     window: TranscriptWindow;
     scroll: StickToBottom;
     stop: TranscriptStopState;
+    /** Messages waiting in the thread's queue, in run order — render after `items`. */
+    queued: TranscriptQueuedItem[];
+    /** Why the queue is not draining, or `null`. */
+    queuePaused: QueuePause | null;
 }
 /**
  * The model behind a chat transcript: messages normalized into items with their parts grouped into
@@ -980,6 +1072,14 @@ interface MessageListClassNames {
     errorRetry?: string;
     followUps?: string;
     followUpChip?: string;
+    /** The block of waiting (queued) messages after the transcript. */
+    queue?: string;
+    /** One waiting message; it also carries `data-state="sending|queued|paused"`. */
+    queuedItem?: string;
+    queuedRemove?: string;
+    /** The "queue paused" line and its resume button. */
+    queuePaused?: string;
+    queueResume?: string;
     message?: MessageItemClassNames;
 }
 interface MessageListProps {
@@ -1023,6 +1123,11 @@ interface MessageListProps {
     /** Last turn's error — paired with `onRetry`, renders a retry banner. */
     error?: Error | null;
     onRetry?: () => void | Promise<void>;
+    /**
+     * `chat.queue` — messages sent while a turn was running, drawn after the transcript as pending
+     * user messages (with a remove button), and a resume button while the queue is paused.
+     */
+    queue?: ChatQueue;
     classNames?: MessageListClassNames;
 }
 /**
@@ -1034,7 +1139,7 @@ interface MessageListProps {
  * Every decision here comes from `useChatTranscript`; the file below it is markup. A host that
  * wants a different layout drives that hook directly and never imports this component.
  */
-declare function MessageList({ messages, status, renderToolPart, renderToolGroup, renderText, renderReasoning, renderFiles, renderUi, reasoningLabel, getMeta, readOnly, onFork, editable, onEditSubmit, regeneratable, onRegenerate, getUsage, getCreatedAt, emptyState, typingIndicator, followUps, onFollowUpClick, error, onRetry, classNames, }: MessageListProps): React__default.JSX.Element;
+declare function MessageList({ messages, status, renderToolPart, renderToolGroup, renderText, renderReasoning, renderFiles, renderUi, reasoningLabel, getMeta, readOnly, onFork, editable, onEditSubmit, regeneratable, onRegenerate, getUsage, getCreatedAt, emptyState, typingIndicator, followUps, onFollowUpClick, error, onRetry, queue, classNames, }: MessageListProps): React__default.JSX.Element;
 
 /**
  * Languages the dictation mic offers. The Web Speech API expects a
@@ -1482,6 +1587,14 @@ interface UseAgentChatOptions<B extends AgentBackend = AgentBackend> {
     blocked?: QuotaBlock | null;
     /** Validation and upload for `chat.composer.files` — see `useAttachments`. */
     composer?: Omit<UseAttachmentsOptions, 'backend'>;
+    /**
+     * What `composer.submit()` and `sendMessage` do while a turn is still running. Default `'queue'`:
+     * the message waits in the thread's queue (server-side — it survives a reload) and runs when the
+     * turn settles; `chat.queue` lists and edits what is waiting. `'interrupt'` cancels the running
+     * turn and runs the message next. `'block'` refuses the send (`composer.blockedBy === 'busy'`).
+     * A backend without `enqueueMessage` behaves as `'block'`.
+     */
+    whileRunning?: WhileRunning;
     /**
      * Overrides for `chat.transcript` — anything `useChatTranscript` takes (`sources`, `editable` +
      * `onEditSubmit`, `followUps`, `getUsage`, a `toolCatalog` of your own, `onApprove: null`, …).
@@ -1650,6 +1763,11 @@ declare function useAgentChat<B extends AgentBackend = AgentBackend>(options?: U
     transcript: ChatTranscript;
     /** A headless composer: draft, files, send gate, `submit()`. */
     composer: ChatComposer;
+    /**
+     * Messages sent while a turn was running, waiting their turn (server-side): list, edit, move,
+     * remove, clear, and resume a paused queue.
+     */
+    queue: ChatQueue;
     /** The model picker: `list`, `selected`, `select(id)`, `pinToThread(id)`. */
     models: ChatModels;
     /** The caller's budget (`GET <base>/quota`); `quota.blocked` gates sends. */
@@ -1687,4 +1805,4 @@ declare class QuotaBlockedError extends Error {
     constructor(block: QuotaBlock);
 }
 
-export { AgentBackend, AgentChatTransport, type AgentChatTransportOptions, type AgentConfigState, type AgentMessageMetadata, AgentProvider, type AgentProviderProps, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, type AmbientRenderUi, AmbientRenderUiContext, type AnswerInput, AnyToolUIPart, type ApprovalCountdown, type ApproveInput, ApproveOptions, type AttachmentRejection, AttachmentUploadStrategy, type AttachmentsState, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type ChatBackground, ChatInput, type ChatInputProps, ChatStatus, type ChatTranscript, type ClipboardLikeEvent, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DragLikeEvent, type EditSubmitInput, HttpErrorListener, type MessageActionInput, type MessageFeedbackState, type MessageFile, type MessageFileKind, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, QuotaBlockedError, type QuotaState, type ReconnectOptions, type RejectInput, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, SPEECH_LANGUAGES, type SkillSuggestionData, type SkillsSourceOptions, type SkipInput, type SpeechLanguage, type SpeechRecognitionHook, type StagedAttachment, type StagedAttachmentStatus, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type StreamConnectionState, type ThreadsEvent, type ThreadsState, TimestampInfo, ToolCatalog, type ToolCatalogState, type TranscriptActionState, TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, TranscriptFile, type TranscriptItem, type TranscriptItemOptions, type TranscriptStopState, TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, type UseAgentConfigOptions, type UseAgentsOptions, type UseApprovalCountdownOptions, type UseAttachmentsOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseMessageFeedbackOptions, type UseModelsOptions, type UseQuotaOptions, type UseSpeechRecognitionOptions, type UseThreadsOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, acceptsFile, applyCompletion, approvalCountdown, backgroundRunsFromThread, createSkillsSource, dragHasFiles, fileKind, filesFromClipboard, filterAutocompleteItems, findActiveTrigger, formatElapsed, loadStoredSpeechLang, messageFiles, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, storedMessageToUiMessage, storedThreadToUiMessages, useAgentBackend, useAgentChat, useAgentConfig, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };
+export { AgentBackend, AgentChatTransport, type AgentChatTransportOptions, type AgentConfigState, type AgentMessageMetadata, AgentProvider, type AgentProviderProps, type AgentStreamMeta, type AgentsState, type AggregatedTurnUsage, type AmbientRenderUi, AmbientRenderUiContext, type AnswerInput, AnyToolUIPart, type ApprovalCountdown, type ApproveInput, ApproveOptions, type AttachmentRejection, AttachmentUploadStrategy, type AttachmentsState, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type ChatBackground, ChatInput, type ChatInputProps, type ChatQueue, ChatStatus, type ChatTranscript, type ClipboardLikeEvent, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type DragLikeEvent, type EditSubmitInput, HttpErrorListener, type MessageActionInput, type MessageFeedbackState, type MessageFile, type MessageFileKind, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, MessageUsageInfo, type ModelOption, type ModelsState, type QueuedChatMessage, QuotaBlockedError, type QuotaState, type ReconnectOptions, type RejectInput, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RenderUiFn, SPEECH_LANGUAGES, type SkillSuggestionData, type SkillsSourceOptions, type SkipInput, type SpeechLanguage, type SpeechRecognitionHook, type StagedAttachment, type StagedAttachmentStatus, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type StreamConnectionState, type ThreadsEvent, type ThreadsState, TimestampInfo, ToolCatalog, type ToolCatalogState, type TranscriptActionState, TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, TranscriptFile, type TranscriptItem, type TranscriptItemOptions, type TranscriptQueuedItem, type TranscriptStopState, TranscriptUiBlock, type TranscriptWindow, type TriggerMatch, type TriggerPosition, UploadAttachmentOptions, UsageSummary, type UseAgentChatOptions, type UseAgentConfigOptions, type UseAgentsOptions, type UseApprovalCountdownOptions, type UseAttachmentsOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseElapsedOptions, type UseMessageFeedbackOptions, type UseModelsOptions, type UseQuotaOptions, type UseSpeechRecognitionOptions, type UseThreadsOptions, type UseToolCatalogOptions, type UseTranscriptItemOptions, type WhileRunning, acceptsFile, applyCompletion, approvalCountdown, backgroundRunsFromThread, createSkillsSource, dragHasFiles, fileKind, filesFromClipboard, filterAutocompleteItems, findActiveTrigger, formatElapsed, loadStoredSpeechLang, messageFiles, notifyThreads, onThreadsEvent, persistSpeechLang, readReasoningMs, storedMessageToUiMessage, storedThreadToUiMessages, useAgentBackend, useAgentChat, useAgentConfig, useAgents, useAmbientRenderUi, useApprovalCountdown, useAttachments, useChatTranscript, useComposerAutocomplete, useElapsed, useMessageFeedback, useModels, useQuota, useSpeechRecognition, useStickToBottom, useThreads, useToolCatalog, useTranscriptItem };