@dudousxd/nestjs-agent-react 0.3.3 → 0.4.1

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as ai from 'ai';
 import { ChatTransport, UIMessage, UIMessageChunk, ToolUIPart, DynamicToolUIPart } from 'ai';
 import * as _dudousxd_nestjs_agent_core from '@dudousxd/nestjs-agent-core';
-import { ThreadSummary, ThreadDetail, QuotaView } from '@dudousxd/nestjs-agent-core';
+import { ThreadSummary, ThreadDetail, MessageAttachment, QuotaView, StoredMessage } from '@dudousxd/nestjs-agent-core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 
@@ -112,6 +112,15 @@ interface CancelResult {
 interface OkResult {
     ok: boolean;
 }
+/**
+ * Partial update accepted by `PATCH /agent/threads/:threadId`. `defaultAgent: null` clears a
+ * previously-set default back to the module's own default; omitting it leaves the thread's
+ * current default untouched.
+ */
+interface ThreadPatch {
+    title?: string;
+    defaultAgent?: string | null;
+}
 interface AgentClientOptions {
     /** Origin + base path, e.g. `https://api.example.com`. Defaults to `''`. */
     baseUrl?: string;
@@ -136,6 +145,14 @@ declare class AgentClient {
     deleteThread(id: string): Promise<void>;
     forkFromMessage(threadId: string, messageId: string): Promise<ThreadSummary>;
     renameThread(id: string, title: string): Promise<OkResult>;
+    /** General `PATCH /agent/threads/:threadId` — title and/or the thread's pinned default agent. */
+    updateThread(id: string, patch: ThreadPatch): Promise<OkResult>;
+    /**
+     * Uploads a file (image/PDF) for a vision-capable model turn. Multipart, field name `file` —
+     * mirrors the backend's `POST /agent/attachments`. The returned {@link MessageAttachment} is
+     * what a caller then rides on `sendMessage({ text }, { body: { attachments: [...] } })`.
+     */
+    uploadAttachment(file: File): Promise<MessageAttachment>;
     promoteThread(id: string): Promise<OkResult>;
     truncateFromMessage(threadId: string, messageId: string): Promise<OkResult>;
     getQuotaToday(): Promise<QuotaToday>;
@@ -148,8 +165,31 @@ declare class AgentClient {
         reason?: string;
     }): Promise<void>;
     private request;
+    private handleResponse;
 }
 
+/**
+ * Convert a persisted `StoredMessage` (the agent-lib's on-disk shape) into an AI SDK v7
+ * `UIMessage` so a loaded thread can seed `useChat`'s `initialMessages` / `messages`.
+ *
+ * The lib stores a message as flat `content` text plus `toolCalls`/`toolResults` arrays; the SDK
+ * renders from `parts`. This maps:
+ *   - `content`            → a single `text` part (skipped when empty).
+ *   - each `attachment`    → a `file` part (image/PDF) so the user bubble re-renders its
+ *                            thumbnails on a reloaded thread.
+ *   - each `toolCall`      → a `tool-<name>` part, pairing its `toolResult` (matched by id):
+ *       - a result found   → `output-available` state, carrying `output`.
+ *       - no result found  → `input-available` state (the call never finished, e.g. the run was
+ *                            interrupted) — `output` is omitted, never a fabricated value.
+ *     When the store reports the tool's kind (`'read' | 'action'`), it rides along as
+ *     `toolMetadata.toolKind` so a UI can render an approval affordance for `action` tools
+ *     without hardcoding tool-name sets, matching how live-streamed tool parts carry it.
+ *
+ * Live streaming still arrives as fully-typed SDK tool parts (see `AgentChatTransport`); this
+ * converter only feeds replayed history, so the tool cards render the same either way.
+ */
+declare function storedMessageToUiMessage(message: StoredMessage): UIMessage;
+
 interface UseAgentChatOptions {
     /** Origin + base path, e.g. `https://api.example.com`. Defaults to `''`. */
     baseUrl?: string;
@@ -173,8 +213,19 @@ interface UseAgentChatOptions {
      * Run id of a buffered stream to reconnect to on mount — wire this to the thread's
      * `activeStreamId`. Its presence both gates the SDK's `resume` and names the run, so a normal
      * mount (no id) never fires a doomed resume GET. Omitted → no resume.
+     *
+     * For the common case (no id in hand yet), prefer {@link UseAgentChatOptions.resume} — it does
+     * this fetch-and-wire for you.
      */
     resumeRunId?: string;
+    /**
+     * When `true` and the hook (re)mounts with a `threadId`, the hook fetches the thread and, if its
+     * `activeRunId` is non-null (a turn was still streaming when the page loaded/reloaded), attaches
+     * to that run's `GET /agent/chat/:runId/stream` automatically — the in-flight turn streams into
+     * this session's message state exactly as if the send had happened here. A no-op when `threadId`
+     * is omitted (nothing to resume) or the fetched thread has no active run. Default `false`.
+     */
+    resume?: boolean;
     /** Read at every send to capture a page snapshot for the page-assistant. */
     getPageContext?: () => Record<string, unknown> | null;
     /** Fired after each streamed turn finishes (e.g. to refetch the sidebar). */
@@ -201,6 +252,8 @@ interface AddToolResultArgs {
 declare function useAgentChat(options: UseAgentChatOptions): {
     addToolResult: ({ tool, toolCallId, output }: AddToolResultArgs) => void | PromiseLike<void>;
     runId: string | undefined;
+    /** The `resume`-fetched thread's active run id, or `null` once resolved with none. */
+    activeRunId: string | null;
     client: AgentClient;
     threads: ThreadSummary[];
     loadThreads: () => Promise<ThreadSummary[]>;
@@ -229,7 +282,7 @@ declare function useAgentChat(options: UseAgentChatOptions): {
     status: ai.ChatStatus;
     sendMessage: (message?: (Omit<UIMessage<unknown, ai.UIDataTypes, ai.UITools>, "id" | "role"> & {
         id?: string;
-        role?: "system" | "user" | "assistant";
+        role?: "user" | "assistant" | "system";
     } & {
         text?: never;
         files?: never;
@@ -437,4 +490,4 @@ interface SpeechRecognitionHook {
  */
 declare function useSpeechRecognition({ lang, onFinalTranscript, onInterimTranscript, }: UseSpeechRecognitionOptions): SpeechRecognitionHook;
 
-export { AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentStreamMeta, type AnyToolUIPart, type CancelResult, ChatInput, type ChatInputProps, type ChatStatus, DEFAULT_SPEECH_LANG, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageList, type MessageListClassNames, type MessageListProps, type MessageUsageInfo, type QuotaToday, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, SPEECH_LANGUAGES, type SpeechLanguage, type SpeechRecognitionHook, type UseAgentChatOptions, type UseSpeechRecognitionOptions, formatRelativeTime, loadStoredSpeechLang, persistSpeechLang, useAgentChat, useSpeechRecognition };
+export { AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentStreamMeta, type AnyToolUIPart, type CancelResult, ChatInput, type ChatInputProps, type ChatStatus, DEFAULT_SPEECH_LANG, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageList, type MessageListClassNames, type MessageListProps, type MessageUsageInfo, type QuotaToday, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, SPEECH_LANGUAGES, type SpeechLanguage, type SpeechRecognitionHook, type ThreadPatch, type UseAgentChatOptions, type UseSpeechRecognitionOptions, formatRelativeTime, loadStoredSpeechLang, persistSpeechLang, storedMessageToUiMessage, useAgentChat, useSpeechRecognition };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as ai from 'ai';
 import { ChatTransport, UIMessage, UIMessageChunk, ToolUIPart, DynamicToolUIPart } from 'ai';
 import * as _dudousxd_nestjs_agent_core from '@dudousxd/nestjs-agent-core';
-import { ThreadSummary, ThreadDetail, QuotaView } from '@dudousxd/nestjs-agent-core';
+import { ThreadSummary, ThreadDetail, MessageAttachment, QuotaView, StoredMessage } from '@dudousxd/nestjs-agent-core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 
@@ -112,6 +112,15 @@ interface CancelResult {
 interface OkResult {
     ok: boolean;
 }
+/**
+ * Partial update accepted by `PATCH /agent/threads/:threadId`. `defaultAgent: null` clears a
+ * previously-set default back to the module's own default; omitting it leaves the thread's
+ * current default untouched.
+ */
+interface ThreadPatch {
+    title?: string;
+    defaultAgent?: string | null;
+}
 interface AgentClientOptions {
     /** Origin + base path, e.g. `https://api.example.com`. Defaults to `''`. */
     baseUrl?: string;
@@ -136,6 +145,14 @@ declare class AgentClient {
     deleteThread(id: string): Promise<void>;
     forkFromMessage(threadId: string, messageId: string): Promise<ThreadSummary>;
     renameThread(id: string, title: string): Promise<OkResult>;
+    /** General `PATCH /agent/threads/:threadId` — title and/or the thread's pinned default agent. */
+    updateThread(id: string, patch: ThreadPatch): Promise<OkResult>;
+    /**
+     * Uploads a file (image/PDF) for a vision-capable model turn. Multipart, field name `file` —
+     * mirrors the backend's `POST /agent/attachments`. The returned {@link MessageAttachment} is
+     * what a caller then rides on `sendMessage({ text }, { body: { attachments: [...] } })`.
+     */
+    uploadAttachment(file: File): Promise<MessageAttachment>;
     promoteThread(id: string): Promise<OkResult>;
     truncateFromMessage(threadId: string, messageId: string): Promise<OkResult>;
     getQuotaToday(): Promise<QuotaToday>;
@@ -148,8 +165,31 @@ declare class AgentClient {
         reason?: string;
     }): Promise<void>;
     private request;
+    private handleResponse;
 }
 
+/**
+ * Convert a persisted `StoredMessage` (the agent-lib's on-disk shape) into an AI SDK v7
+ * `UIMessage` so a loaded thread can seed `useChat`'s `initialMessages` / `messages`.
+ *
+ * The lib stores a message as flat `content` text plus `toolCalls`/`toolResults` arrays; the SDK
+ * renders from `parts`. This maps:
+ *   - `content`            → a single `text` part (skipped when empty).
+ *   - each `attachment`    → a `file` part (image/PDF) so the user bubble re-renders its
+ *                            thumbnails on a reloaded thread.
+ *   - each `toolCall`      → a `tool-<name>` part, pairing its `toolResult` (matched by id):
+ *       - a result found   → `output-available` state, carrying `output`.
+ *       - no result found  → `input-available` state (the call never finished, e.g. the run was
+ *                            interrupted) — `output` is omitted, never a fabricated value.
+ *     When the store reports the tool's kind (`'read' | 'action'`), it rides along as
+ *     `toolMetadata.toolKind` so a UI can render an approval affordance for `action` tools
+ *     without hardcoding tool-name sets, matching how live-streamed tool parts carry it.
+ *
+ * Live streaming still arrives as fully-typed SDK tool parts (see `AgentChatTransport`); this
+ * converter only feeds replayed history, so the tool cards render the same either way.
+ */
+declare function storedMessageToUiMessage(message: StoredMessage): UIMessage;
+
 interface UseAgentChatOptions {
     /** Origin + base path, e.g. `https://api.example.com`. Defaults to `''`. */
     baseUrl?: string;
@@ -173,8 +213,19 @@ interface UseAgentChatOptions {
      * Run id of a buffered stream to reconnect to on mount — wire this to the thread's
      * `activeStreamId`. Its presence both gates the SDK's `resume` and names the run, so a normal
      * mount (no id) never fires a doomed resume GET. Omitted → no resume.
+     *
+     * For the common case (no id in hand yet), prefer {@link UseAgentChatOptions.resume} — it does
+     * this fetch-and-wire for you.
      */
     resumeRunId?: string;
+    /**
+     * When `true` and the hook (re)mounts with a `threadId`, the hook fetches the thread and, if its
+     * `activeRunId` is non-null (a turn was still streaming when the page loaded/reloaded), attaches
+     * to that run's `GET /agent/chat/:runId/stream` automatically — the in-flight turn streams into
+     * this session's message state exactly as if the send had happened here. A no-op when `threadId`
+     * is omitted (nothing to resume) or the fetched thread has no active run. Default `false`.
+     */
+    resume?: boolean;
     /** Read at every send to capture a page snapshot for the page-assistant. */
     getPageContext?: () => Record<string, unknown> | null;
     /** Fired after each streamed turn finishes (e.g. to refetch the sidebar). */
@@ -201,6 +252,8 @@ interface AddToolResultArgs {
 declare function useAgentChat(options: UseAgentChatOptions): {
     addToolResult: ({ tool, toolCallId, output }: AddToolResultArgs) => void | PromiseLike<void>;
     runId: string | undefined;
+    /** The `resume`-fetched thread's active run id, or `null` once resolved with none. */
+    activeRunId: string | null;
     client: AgentClient;
     threads: ThreadSummary[];
     loadThreads: () => Promise<ThreadSummary[]>;
@@ -229,7 +282,7 @@ declare function useAgentChat(options: UseAgentChatOptions): {
     status: ai.ChatStatus;
     sendMessage: (message?: (Omit<UIMessage<unknown, ai.UIDataTypes, ai.UITools>, "id" | "role"> & {
         id?: string;
-        role?: "system" | "user" | "assistant";
+        role?: "user" | "assistant" | "system";
     } & {
         text?: never;
         files?: never;
@@ -437,4 +490,4 @@ interface SpeechRecognitionHook {
  */
 declare function useSpeechRecognition({ lang, onFinalTranscript, onInterimTranscript, }: UseSpeechRecognitionOptions): SpeechRecognitionHook;
 
-export { AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentStreamMeta, type AnyToolUIPart, type CancelResult, ChatInput, type ChatInputProps, type ChatStatus, DEFAULT_SPEECH_LANG, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageList, type MessageListClassNames, type MessageListProps, type MessageUsageInfo, type QuotaToday, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, SPEECH_LANGUAGES, type SpeechLanguage, type SpeechRecognitionHook, type UseAgentChatOptions, type UseSpeechRecognitionOptions, formatRelativeTime, loadStoredSpeechLang, persistSpeechLang, useAgentChat, useSpeechRecognition };
+export { AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentStreamMeta, type AnyToolUIPart, type CancelResult, ChatInput, type ChatInputProps, type ChatStatus, DEFAULT_SPEECH_LANG, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageList, type MessageListClassNames, type MessageListProps, type MessageUsageInfo, type QuotaToday, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, SPEECH_LANGUAGES, type SpeechLanguage, type SpeechRecognitionHook, type ThreadPatch, type UseAgentChatOptions, type UseSpeechRecognitionOptions, formatRelativeTime, loadStoredSpeechLang, persistSpeechLang, storedMessageToUiMessage, useAgentChat, useSpeechRecognition };

package/dist/index.js

@@ -177,6 +177,14 @@ var AgentChatTransport = class {
               break;
             case "step-finish":
               closeStep();
+              if (event.costUsd !== void 0) {
+                controller.enqueue({
+                  type: "message-metadata",
+                  messageMetadata: {
+                    costUsd: event.costUsd
+                  }
+                });
+              }
               break;
             case "text":
               ensureStep();
@@ -213,7 +221,15 @@ var AgentChatTransport = class {
               controller.enqueue({
                 type: "tool-input-start",
                 toolCallId: event.id,
-                toolName: event.name
+                toolName: event.name,
+                // `toolKind` is absent on older backends — omitted (not `undefined`-valued) so
+                // `toolMetadata` itself is only present when there's something to say, letting a
+                // UI gate approval affordances on `kind === 'action'` without hardcoding tool names.
+                ...event.toolKind !== void 0 ? {
+                  toolMetadata: {
+                    toolKind: event.toolKind
+                  }
+                } : {}
               });
               break;
             case "tool-input-delta":
@@ -230,7 +246,12 @@ var AgentChatTransport = class {
                 type: "tool-input-available",
                 toolCallId: event.id,
                 toolName: event.name,
-                input: event.input
+                input: event.input,
+                ...event.toolKind !== void 0 ? {
+                  toolMetadata: {
+                    toolKind: event.toolKind
+                  }
+                } : {}
               });
               break;
             case "tool-output":
@@ -412,10 +433,39 @@ var AgentClient = class {
     return this.request("POST", `/agent/threads/${encodeURIComponent(threadId)}/fork-from/${encodeURIComponent(messageId)}`);
   }
   renameThread(id, title) {
-    return this.request("PATCH", `/agent/threads/${encodeURIComponent(id)}`, {
+    return this.updateThread(id, {
       title
     });
   }
+  /** General `PATCH /agent/threads/:threadId` — title and/or the thread's pinned default agent. */
+  updateThread(id, patch) {
+    return this.request("PATCH", `/agent/threads/${encodeURIComponent(id)}`, patch);
+  }
+  /**
+  * Uploads a file (image/PDF) for a vision-capable model turn. Multipart, field name `file` —
+  * mirrors the backend's `POST /agent/attachments`. The returned {@link MessageAttachment} is
+  * what a caller then rides on `sendMessage({ text }, { body: { attachments: [...] } })`.
+  */
+  async uploadAttachment(file) {
+    const fetchImpl = this.options.fetch ?? globalThis.fetch;
+    const baseUrl = (this.options.baseUrl ?? "").replace(/\/$/, "");
+    const dynamic = await this.options.getHeaders?.() ?? {};
+    const formData = new FormData();
+    formData.append("file", file);
+    const response = await fetchImpl(`${baseUrl}/agent/attachments`, {
+      method: "POST",
+      headers: {
+        accept: "application/json",
+        ...this.options.headers,
+        ...dynamic
+      },
+      body: formData,
+      ...this.options.credentials !== void 0 ? {
+        credentials: this.options.credentials
+      } : {}
+    });
+    return this.handleResponse(response, "POST", "/agent/attachments");
+  }
   promoteThread(id) {
     return this.request("POST", `/agent/threads/${encodeURIComponent(id)}/promote`);
   }
@@ -455,6 +505,9 @@ var AgentClient = class {
         credentials: this.options.credentials
       } : {}
     });
+    return this.handleResponse(response, method, path);
+  }
+  async handleResponse(response, method, path) {
     if (!response.ok) {
       throw new AgentHttpError(response.status, method, path, response.statusText);
     }
@@ -465,15 +518,64 @@ var AgentClient = class {
   }
 };
 
+// src/stored-message-to-ui-message.ts
+function storedMessageToUiMessage(message) {
+  const parts = [];
+  if (message.content) {
+    parts.push({
+      type: "text",
+      text: message.content
+    });
+  }
+  for (const attachment of message.attachments ?? []) {
+    parts.push({
+      type: "file",
+      mediaType: attachment.contentType,
+      filename: attachment.name,
+      url: attachment.url
+    });
+  }
+  for (const call of message.toolCalls ?? []) {
+    const result = message.toolResults?.find((candidate) => candidate.id === call.id);
+    const toolKind = call.kind;
+    parts.push({
+      type: `tool-${call.name}`,
+      toolCallId: call.id,
+      ...toolKind !== void 0 ? {
+        toolMetadata: {
+          toolKind
+        }
+      } : {},
+      ...result !== void 0 ? {
+        state: "output-available",
+        input: call.input,
+        output: result.output
+      } : {
+        state: "input-available",
+        input: call.input
+      }
+    });
+  }
+  return {
+    id: message.id,
+    role: message.role,
+    parts
+  };
+}
+__name(storedMessageToUiMessage, "storedMessageToUiMessage");
+
 // src/use-agent-chat.ts
 import { useChat } from "@ai-sdk/react";
-import { useCallback, useMemo, useRef, useState } from "react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 function useAgentChat(options) {
   const latest = useRef(options);
   latest.current = options;
   const [runId, setRunId] = useState(options.resumeRunId);
   const runIdRef = useRef(runId);
   runIdRef.current = runId;
+  const autoResumeRunIdRef = useRef(void 0);
+  const [autoResume, setAutoResume] = useState(false);
+  const [activeRunId, setActiveRunId] = useState(null);
   const regenerateNext = useRef(false);
   const createdThreadId = useRef(void 0);
   const client = useMemo(() => {
@@ -491,6 +593,26 @@ function useAgentChat(options) {
       getHeaders: /* @__PURE__ */ __name(async () => mergeHeaders(latest.current), "getHeaders")
     });
   }, []);
+  useEffect(() => {
+    if (!options.resume || options.threadId === void 0) return;
+    let cancelled = false;
+    const threadId = options.threadId;
+    void client.getThread(threadId).then((thread) => {
+      if (cancelled) return;
+      setActiveRunId(thread.activeRunId ?? null);
+      if (thread.activeRunId != null) {
+        autoResumeRunIdRef.current = thread.activeRunId;
+        setAutoResume(true);
+      }
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [
+    client,
+    options.resume,
+    options.threadId
+  ]);
   const transport = useMemo(() => {
     function onMeta(meta) {
       setRunId(meta.runId);
@@ -532,13 +654,13 @@ function useAgentChat(options) {
           } : {}
         };
       }, "getBody"),
-      getResumeRunId: /* @__PURE__ */ __name(() => latest.current.resumeRunId, "getResumeRunId"),
+      getResumeRunId: /* @__PURE__ */ __name(() => latest.current.resumeRunId ?? autoResumeRunIdRef.current, "getResumeRunId"),
       onMeta
     });
   }, []);
   const chat = useChat({
     transport,
-    resume: options.resumeRunId !== void 0,
+    resume: options.resumeRunId !== void 0 || autoResume,
     ...options.threadId !== void 0 ? {
       id: options.threadId
     } : {},
@@ -605,10 +727,10 @@ function useAgentChat(options) {
   ]);
   const cancel = useCallback(async () => {
     chatRef.current.stop();
-    const activeRunId = runIdRef.current;
-    if (activeRunId) {
+    const activeRunId2 = runIdRef.current;
+    if (activeRunId2) {
       try {
-        await client.cancelStream(activeRunId);
+        await client.cancelStream(activeRunId2);
       } catch {
       }
     }
@@ -640,6 +762,8 @@ function useAgentChat(options) {
     ...chat,
     addToolResult,
     runId,
+    /** The `resume`-fetched thread's active run id, or `null` once resolved with none. */
+    activeRunId,
     client,
     threads,
     loadThreads,
@@ -668,10 +792,10 @@ async function mergeHeaders(options) {
 __name(mergeHeaders, "mergeHeaders");
 
 // src/components/chat-input.tsx
-import React, { useEffect as useEffect2, useState as useState3 } from "react";
+import React, { useEffect as useEffect3, useState as useState3 } from "react";
 
 // src/components/use-speech-recognition.ts
-import { useCallback as useCallback2, useEffect, useMemo as useMemo2, useRef as useRef2, useState as useState2 } from "react";
+import { useCallback as useCallback2, useEffect as useEffect2, useMemo as useMemo2, useRef as useRef2, useState as useState2 } from "react";
 function getRecognitionCtor() {
   if (typeof window === "undefined") return null;
   const scope = window;
@@ -687,7 +811,7 @@ function useSpeechRecognition({ lang = "en-US", onFinalTranscript, onInterimTran
   const interimRef = useRef2(onInterimTranscript);
   finalRef.current = onFinalTranscript;
   interimRef.current = onInterimTranscript;
-  useEffect(() => {
+  useEffect2(() => {
     if (!ctor) return;
     const recognition = new ctor();
     recognition.lang = lang;
@@ -767,7 +891,7 @@ function ChatInput({ onSubmit, disabled, placeholder, rows = 2, enableSpeech = t
     }, "onFinalTranscript"),
     onInterimTranscript: /* @__PURE__ */ __name((text) => setInterim(text), "onInterimTranscript")
   });
-  useEffect2(() => {
+  useEffect3(() => {
     if (!speech.isListening) setInterim("");
   }, [
     speech.isListening
@@ -826,7 +950,7 @@ __name(ChatInput, "ChatInput");
 
 // src/components/message-item.tsx
 import { isTextUIPart, isToolUIPart } from "ai";
-import React2, { useEffect as useEffect3, useRef as useRef3, useState as useState4 } from "react";
+import React2, { useEffect as useEffect4, useRef as useRef3, useState as useState4 } from "react";
 function MessageItem({ message, renderToolPart, renderToolGroup, renderText, classNames, isStreaming = false, editable, onEditSubmit, regeneratable, onRegenerate, onFork, usage, createdAt }) {
   const isUser = message.role === "user";
   const parts = message.parts ?? [];
@@ -930,7 +1054,7 @@ function EditableUserBubble({ message, onSubmit, renderText, classNames, actions
   const [isEditing, setIsEditing] = useState4(false);
   const [draft, setDraft] = useState4(initialText);
   const textareaRef = useRef3(null);
-  useEffect3(() => {
+  useEffect4(() => {
     if (isEditing && textareaRef.current) {
       const el = textareaRef.current;
       el.focus();
@@ -1248,6 +1372,7 @@ export {
   formatRelativeTime,
   loadStoredSpeechLang,
   persistSpeechLang,
+  storedMessageToUiMessage,
   useAgentChat,
   useSpeechRecognition
 };