@springbrand/chat-client 0.1.3-alpha.44 → 0.1.3-alpha.46

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springbrand/chat-client",
-  "version": "0.1.3-alpha.44",
+  "version": "0.1.3-alpha.46",
   "type": "module",
   "files": [
     "src",
@@ -27,7 +27,7 @@
     "@types/react-dom": "^19.2.5",
     "react-dom": "^19.2.8",
     "typescript": "^7.0.2",
-    "@springbrand/agent-runtime": "0.2.0-alpha.60"
+    "@springbrand/agent-runtime": "0.2.0-alpha.62"
   },
   "scripts": {
     "typecheck": "tsc --noEmit"

package/src/use-universal-agent-chat.ts

@@ -26,6 +26,7 @@ import {
   type RuntimeConfigUpdateResult,
   type RuntimeQueuedSubmission,
   type RuntimeState,
+  type RuntimeTurnState,
 } from "@springbrand/agent-runtime/contracts";
 import { createSafeUIMessageAgentConnection } from "./ui-message-stream-guard";
 import { CURRENT_INBOX_AGENT_PATH } from "./chat-sessions";
@@ -90,26 +91,6 @@ type ChatApproval = {
   requestId: string;
 };
 
-type ChatQueuedSubmission = {
-  submissionId: string;
-  messageId: string;
-  preview: string;
-  position: number;
-  createdAt: number;
-};
-
-type ChatTurn = {
-  activeSubmissionId?: string;
-  activeRequestId?: string;
-  activeMessageId?: string;
-  recoveryAttempt?: number;
-  recoveryMax?: number;
-  recoveryReason?: "no_meaningful_model_progress" | "transient_model_error";
-  steerable: boolean;
-  hasPendingSteer: boolean;
-  queued: ChatQueuedSubmission[];
-};
-
 export interface ChatRuntime {
   messages: ChatMessage[];
   status: ChatStatus;
@@ -118,10 +99,12 @@ export interface ChatRuntime {
   runtimeLoad: ChatRuntimeLoadState | undefined;
   isStreaming: boolean;
   error: string | Error | undefined;
+  /** Reusing messageId makes delivery idempotent across caller retries. */
   sendText: (
     text: string,
     files?: readonly FileUIPart[],
     capabilities?: readonly RequestedCapability[],
+    messageId?: string,
   ) => Promise<boolean>;
   steerText: (
     text: string,
@@ -175,7 +158,7 @@ export interface ChatRuntime {
   isToolContinuation: boolean;
   approvals: ChatApproval[] | undefined;
   approvalsLoaded: boolean;
-  turn: ChatTurn | undefined;
+  turn: RuntimeTurnState | undefined;
   turnActive: boolean;
   canSteer: boolean;
 }
@@ -339,6 +322,7 @@ function createChatMessage(
   text: string,
   files?: readonly FileUIPart[],
   capabilities: readonly RequestedCapability[] = [],
+  messageId?: string,
 ): ChatMessage | null {
   const normalizedText = text.trim();
   if (!normalizedText && !files?.length) return null;
@@ -351,7 +335,7 @@ function createChatMessage(
     return true;
   });
   return {
-    id: nanoid(),
+    id: messageId ?? nanoid(),
     role: "user",
     parts: [
       ...(files ?? []),
@@ -869,8 +853,9 @@ export function useUniversalAgentChat(): ChatRuntime {
     text: string,
     files?: readonly FileUIPart[],
     capabilities?: readonly RequestedCapability[],
+    messageId?: string,
   ): Promise<boolean> => {
-    const message = createChatMessage(text, files, capabilities);
+    const message = createChatMessage(text, files, capabilities, messageId);
     return message
       ? submitMessage(message, "enqueue", "message")
       : false;