@agents24/react 0.2.11 → 0.2.12

package/dist/model.d.ts

@@ -204,6 +204,7 @@ export type ChatMessage = {
     id: string;
     /** Durable timeline identity when a mounted optimistic turn keeps its display key. */
     durableId?: string;
+    clientSubmissionId?: string;
     segmentIndex?: number | null;
     role: AgentChatMessageRole;
     runId?: string | null;

package/dist/thread-message-queue.d.ts

@@ -1,9 +1,14 @@
+import type { ChatMessage } from "./model";
+import { type AgentChatState } from "./state";
 import type { ThreadMessage, ThreadMessageInput, ThreadMessageQueueState, ThreadMessageSubmission, ThreadMessagesPage } from "@agents24/client";
+/** Retry uncertain admission once; the caller retains the same receipt and payload. */
+export declare function retrySubmissionAdmission<T>(admit: () => Promise<T>): Promise<T>;
 export type ThreadMessageNotice = {
     messageId: string;
     status: string;
     runId: string | null;
     cursor?: number;
+    clientSubmissionId?: string | null;
 };
 export type ThreadMessageQueueTransport = {
     list(threadId: string): Promise<ThreadMessagesPage>;
@@ -21,18 +26,34 @@ export type ThreadMessageQueueTransport = {
     }>;
 };
 export type RetractedMessageDraft = Pick<ThreadMessage, "text" | "attachment_ids" | "attachments">;
-export declare function useThreadMessageQueue({ threadId, transport, onPromoted }: {
+export declare function useThreadMessageQueue({ threadId, transport, onPromoted, onOptimistic, onDiscard }: {
     threadId: string | null;
     transport: ThreadMessageQueueTransport;
     onPromoted: (message: ThreadMessage, runId: string) => void;
+    onOptimistic?: (message: ThreadMessage, uploading: boolean) => void;
+    onDiscard?: (message: ThreadMessage) => void;
 }): {
     pendingMessages: readonly ThreadMessage[];
     messageQueue: ThreadMessageQueueState | null;
     refresh: (selectedThreadId?: string | null) => Promise<ThreadMessagesPage | null>;
     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) => void;
     submit: (input: Omit<ThreadMessageInput, "threadId"> & {
         attachments?: ThreadMessage["attachments"];
+        queued?: boolean;
+        uploading?: boolean;
+        prepare?: () => Promise<Pick<ThreadMessageInput, "attachmentIds"> & {
+            attachments?: ThreadMessage["attachments"];
+        }>;
     }) => Promise<ThreadMessageSubmission>;
     edit: (message: ThreadMessage, input: {
         text: string;
@@ -47,3 +68,7 @@ export declare function useThreadMessageQueue({ threadId, transport, onPromoted
         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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agents24/react",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "description": "DOM-free React state and hooks for Agents24 client applications.",
   "license": "MIT",
   "repository": {
@@ -40,7 +40,7 @@
     "prepack": "pnpm run build && pnpm run check:boundaries"
   },
   "dependencies": {
-    "@agents24/client": "0.2.10"
+    "@agents24/client": "0.2.11"
   },
   "peerDependencies": {
     "react": ">=19.0.0 <20.0.0"