import { captureChatOperation } from "./operation-ownership"; import type { ChatMessage } from "./model"; import { type AgentChatState } from "./state"; import type { ThreadMessage, ThreadMessageInput, ThreadMessageQueueState, ThreadMessageSubmission, ThreadMessagesPage, AbortSignalLike } from "@agents24/client"; /** Retry uncertain admission once; the caller retains the same receipt and payload. */ export declare function retrySubmissionAdmission(admit: () => Promise): Promise; export type ThreadMessageNotice = { messageId: string; status: string; runId: string | null; cursor?: number; clientSubmissionId?: string | null; }; export type ThreadMessageQueueTransport = { list(threadId: string, signal?: AbortSignalLike): Promise; submit(input: ThreadMessageInput): Promise; edit(message: ThreadMessage, input: { text: string; attachmentIds?: readonly string[]; requestedAgentId?: string; requestedModelId?: string; mode?: "steer"; }): Promise; remove(message: ThreadMessage): Promise; resume(threadId: string): Promise<{ run_id: string | null; }>; }; export type RetractedMessageDraft = Pick; export declare function useThreadMessageQueue({ threadId, transport, onPromoted, onUnknownPromotion, onOptimistic, onDiscard, ownOperation: ownSelection }: { threadId: string | null; ownOperation?: (options?: Parameters[1]) => () => boolean; transport: ThreadMessageQueueTransport; onPromoted: (message: ThreadMessage, runId: string) => void; onUnknownPromotion?: (runId: string, threadId: string) => void; onOptimistic?: (message: ThreadMessage, uploading: boolean) => void; onDiscard?: (message: ThreadMessage) => void; }): { pendingMessages: readonly ThreadMessage[]; messageQueue: ThreadMessageQueueState | null; refresh: (selectedThreadId?: string | null, signal?: AbortSignalLike) => Promise; hydrate: (page: ThreadMessagesPage, selectedThreadId: string) => void; acceptNotice: (notice: ThreadMessageNotice) => boolean; beginSubmission: (input: { input: string; clientSubmissionId: string; mode?: "queue" | "steer"; attachmentIds?: readonly string[]; attachments?: ThreadMessage["attachments"]; uploading?: boolean; }, queued?: boolean) => ThreadMessage; discardSubmission: (message: ThreadMessage, failure?: unknown) => void; reset: () => void; confirmThreadAdmission: (admittedThreadId: string) => void; hasPendingAdmission: () => boolean; waitForInitialAdmission: () => Promise; submit: (input: Omit & { attachments?: ThreadMessage["attachments"]; queued?: boolean; uploading?: boolean; prepare?: () => Promise & { attachments?: ThreadMessage["attachments"]; }>; }) => Promise; edit: (message: ThreadMessage, input: { text: string; attachmentIds?: readonly string[]; requestedAgentId?: string; requestedModelId?: string; mode?: "steer"; }) => Promise; remove: (message: ThreadMessage) => Promise; retractForEdit: (message: ThreadMessage) => Promise; resume: () => Promise<{ run_id: string | null; } | null>; }; /** One provisional identity for first sends, idle sends, uploads and queue rows. */ export declare function optimisticSubmissionTurn(message: ThreadMessage): [ChatMessage, ChatMessage]; export declare function optimisticSubmissionState(state: AgentChatState, message: ThreadMessage, uploading: boolean): AgentChatState; export declare function discardOptimisticSubmission(state: AgentChatState, message: ThreadMessage): AgentChatState;