@dudousxd/nestjs-agent-react 0.21.0 → 0.22.1

package/dist/index.js

@@ -115,11 +115,6 @@ var AgentClient = class {
   forkFromMessage(threadId, messageId) {
     return this.request("POST", `/threads/${encodeURIComponent(threadId)}/fork-from/${encodeURIComponent(messageId)}`);
   }
-  renameThread(id, title) {
-    return this.updateThread(id, {
-      title
-    });
-  }
   /** General `PATCH <path>/threads/:threadId` — title and/or the thread's pinned default agent. */
   updateThread(id, patch) {
     return this.request("PATCH", `/threads/${encodeURIComponent(id)}`, patch);
@@ -212,9 +207,6 @@ var AgentClient = class {
   getQuota() {
     return this.request("GET", "/quota");
   }
-  getQuotaToday() {
-    return this.request("GET", "/quota/today");
-  }
   cancelStream(runId) {
     return this.request("POST", `/chat/${encodeURIComponent(runId)}/cancel`);
   }
@@ -626,13 +618,14 @@ var AgentChatTransport = class {
         function ensureStarted() {
           if (started) return;
           started = true;
-          controller.enqueue(streamRunId !== void 0 ? {
+          controller.enqueue({
             type: "start",
             messageMetadata: {
-              runId: streamRunId
+              ...streamRunId !== void 0 ? {
+                runId: streamRunId
+              } : {},
+              createdAt: (/* @__PURE__ */ new Date()).toISOString()
             }
-          } : {
-            type: "start"
           });
         }
         __name(ensureStarted, "ensureStarted");
@@ -3662,14 +3655,18 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
   const [picks, setPicks] = useState10(() => /* @__PURE__ */ new Map());
   const [settling, setSettling] = useState10(() => /* @__PURE__ */ new Map());
   const [settleErrors, setSettleErrors] = useState10(() => /* @__PURE__ */ new Map());
+  const backend = useAgentBackend();
+  const handlers = settleHandlers(options, backend);
   const latest = useRef9({
     options,
+    handlers,
     drafts,
     picks,
     messages
   });
   latest.current = {
     options,
+    handlers,
     drafts,
     picks,
     messages
@@ -3729,34 +3726,46 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
   }, []);
   const answer = useCallback8((toolCallId) => {
     const current = latest.current;
-    const onAnswer = current.options.onAnswer;
+    const onAnswer = current.handlers.onAnswer;
     if (!onAnswer) {
       return;
     }
-    settle(toolCallId, "answer", () => onAnswer(toolCallId, answersFor(current.picks, toolCallId)));
+    settle(toolCallId, "answer", () => onAnswer({
+      toolCallId,
+      answers: answersFor(current.picks, toolCallId)
+    }));
   }, [
     settle
   ]);
   const skip = useCallback8((toolCallId) => {
-    const onSkip = latest.current.options.onSkip;
+    const onSkip = latest.current.handlers.onSkip;
     if (onSkip) {
-      settle(toolCallId, "skip", () => onSkip(toolCallId));
+      settle(toolCallId, "skip", () => onSkip({
+        toolCallId
+      }));
     }
   }, [
     settle
   ]);
   const approve = useCallback8((toolCallId, options2) => {
-    const onApprove = latest.current.options.onApprove;
+    const onApprove = latest.current.handlers.onApprove;
     if (onApprove) {
-      settle(toolCallId, "approve", () => options2 === void 0 ? onApprove(toolCallId) : onApprove(toolCallId, options2));
+      settle(toolCallId, "approve", () => onApprove({
+        toolCallId,
+        ...options2?.remember === true ? {
+          remember: true
+        } : {}
+      }));
     }
   }, [
     settle
   ]);
   const reject = useCallback8((toolCallId) => {
-    const onReject = latest.current.options.onReject;
+    const onReject = latest.current.handlers.onReject;
     if (onReject) {
-      settle(toolCallId, "reject", () => onReject(toolCallId));
+      settle(toolCallId, "reject", () => onReject({
+        toolCallId
+      }));
     }
   }, [
     settle
@@ -3811,13 +3820,20 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
           return;
         }
         created.cancelEdit();
-        void latest.current.options.onEditSubmit?.(id, next);
+        void latest.current.options.onEditSubmit?.({
+          messageId: id,
+          text: next
+        });
       }, "save"),
       fork: /* @__PURE__ */ __name(() => {
-        void latest.current.options.onFork?.(id);
+        void latest.current.options.onFork?.({
+          messageId: id
+        });
       }, "fork"),
       regenerate: /* @__PURE__ */ __name(() => {
-        void latest.current.options.onRegenerate?.(id);
+        void latest.current.options.onRegenerate?.({
+          messageId: id
+        });
       }, "regenerate"),
       textareaRef: /* @__PURE__ */ __name((element) => {
         if (!element) {
@@ -3854,7 +3870,7 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
     const draft = drafts.get(message.id);
     const isEditing = draft !== void 0;
     const text = extractMessageText(message.parts);
-    const usage = options.getUsage?.(message) ?? null;
+    const usage = (options.getUsage ?? usageFromMetadata)(message);
     const isUser = message.role === "user";
     const isAssistant = message.role === "assistant";
     const isLastAssistant = isAssistant && message.id === lastAssistantId;
@@ -3876,22 +3892,22 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
         ...options.toolCatalog !== void 0 ? {
           toolCatalog: options.toolCatalog
         } : {},
-        ...options.onAnswer !== void 0 ? {
+        ...handlers.onAnswer !== void 0 ? {
           elicitation: {
             picked: /* @__PURE__ */ __name((toolCallId, questionId) => picks.get(pickKey(toolCallId, questionId)), "picked"),
             pick,
             canAnswer: true,
-            canSkip: options.onSkip !== void 0,
+            canSkip: handlers.onSkip !== void 0,
             answer,
             skip,
             submitting: /* @__PURE__ */ __name((toolCallId) => settling.get(toolCallId) ?? null, "submitting"),
             errorOf: /* @__PURE__ */ __name((toolCallId) => settleErrors.get(toolCallId) ?? null, "errorOf")
           }
         } : {},
-        ...options.onApprove !== void 0 || options.onReject !== void 0 ? {
+        ...handlers.onApprove !== void 0 || handlers.onReject !== void 0 ? {
           approval: {
-            canApprove: options.onApprove !== void 0,
-            canReject: options.onReject !== void 0,
+            canApprove: handlers.onApprove !== void 0,
+            canReject: handlers.onReject !== void 0,
             approve,
             reject,
             submitting: /* @__PURE__ */ __name((toolCallId) => settling.get(toolCallId) ?? null, "submitting"),
@@ -3901,7 +3917,7 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
       }),
       text,
       usage: usage ? describeUsage(usage) : null,
-      timestamp: describeTimestamp(options.getCreatedAt?.(message)),
+      timestamp: describeTimestamp((options.getCreatedAt ?? createdAtFromMetadata)(message)),
       copy: {
         available: text.length > 0,
         copied: copied.has(message.id),
@@ -3936,6 +3952,43 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
   return items;
 }
 __name(useTranscriptItems, "useTranscriptItems");
+function settleHandlers(options, backend) {
+  const pick = /* @__PURE__ */ __name((own, fallback2) => own === null ? void 0 : own ?? fallback2, "pick");
+  return {
+    onAnswer: pick(options.onAnswer, backend.answerToolCall ? async (input) => {
+      await backend.answerToolCall?.(input);
+    } : void 0),
+    onSkip: pick(options.onSkip, backend.skipToolCall ? async (input) => {
+      await backend.skipToolCall?.(input);
+    } : void 0),
+    onApprove: pick(options.onApprove, backend.approveToolCall ? async (input) => {
+      await backend.approveToolCall?.(input);
+    } : void 0),
+    onReject: pick(options.onReject, backend.rejectToolCall ? async (input) => {
+      await backend.rejectToolCall?.(input);
+    } : void 0)
+  };
+}
+__name(settleHandlers, "settleHandlers");
+function metadataOf2(message) {
+  const metadata = message.metadata;
+  return metadata !== null && typeof metadata === "object" ? metadata : {};
+}
+__name(metadataOf2, "metadataOf");
+function usageFromMetadata(message) {
+  const usage = metadataOf2(message).usage;
+  if (usage === void 0) return null;
+  return {
+    inputTokens: usage.inputTokens,
+    outputTokens: usage.outputTokens,
+    costUsd: usage.costUsd ?? null
+  };
+}
+__name(usageFromMetadata, "usageFromMetadata");
+function createdAtFromMetadata(message) {
+  return metadataOf2(message).createdAt ?? null;
+}
+__name(createdAtFromMetadata, "createdAtFromMetadata");
 function pickKey(toolCallId, questionId) {
   return `${toolCallId}|${questionId}`;
 }
@@ -3985,7 +4038,7 @@ function MessageItem({ message, isStreaming = false, editable, onEditSubmit, reg
       editable
     } : {},
     ...onEditSubmit ? {
-      onEditSubmit: /* @__PURE__ */ __name((_id, next) => onEditSubmit(next), "onEditSubmit")
+      onEditSubmit
     } : {},
     ...onFork ? {
       onFork
@@ -3994,7 +4047,7 @@ function MessageItem({ message, isStreaming = false, editable, onEditSubmit, reg
       regeneratable
     } : {},
     ...onRegenerate ? {
-      onRegenerate: /* @__PURE__ */ __name(() => onRegenerate(), "onRegenerate")
+      onRegenerate
     } : {},
     ...usage != null ? {
       getUsage: /* @__PURE__ */ __name(() => usage, "getUsage")
@@ -4699,7 +4752,7 @@ function useToolCatalog(options = {}) {
     setLoading(true);
     load(client, agent).then((loaded) => {
       if (cancelled) return;
-      setEntries(loaded);
+      setEntries(Array.isArray(loaded) ? loaded : []);
       setError(null);
       setLoading(false);
     }, (failure) => {
@@ -4927,14 +4980,27 @@ function storedMessageToUiMessage(message) {
     });
     parts.push(...pushedByCall.get(call.id) ?? []);
   }
+  const metadata = {
+    ...message.feedback !== void 0 ? {
+      feedback: message.feedback
+    } : {},
+    ...message.createdAt ? {
+      createdAt: message.createdAt
+    } : {},
+    ...message.usage !== void 0 ? {
+      usage: {
+        inputTokens: message.usage.inputTokens,
+        outputTokens: message.usage.outputTokens,
+        costUsd: message.usage.costUsd ?? null
+      }
+    } : {}
+  };
   return {
     id: message.id,
     role: message.role,
     parts,
-    ...message.feedback !== void 0 ? {
-      metadata: {
-        feedback: message.feedback
-      }
+    ...Object.keys(metadata).length > 0 ? {
+      metadata
     } : {}
   };
 }
@@ -4972,12 +5038,16 @@ function mergeTurn(rows) {
   const parts = rows.flatMap((row) => storedMessageToUiMessage(row).parts);
   const usage = sumUsage(rows);
   const feedback = lastRow.feedback;
+  const createdAt = rows[0]?.createdAt;
   const metadata = {
     ...usage !== void 0 ? {
       usage
     } : {},
     ...feedback !== void 0 ? {
       feedback
+    } : {},
+    ...createdAt ? {
+      createdAt
     } : {}
   };
   return {
@@ -5007,50 +5077,61 @@ __name(sumUsage, "sumUsage");
 // src/use-agent-chat.ts
 import { useChat } from "@ai-sdk/react";
 import { useCallback as useCallback11, useEffect as useEffect14, useMemo as useMemo11, useRef as useRef12, useState as useState14 } from "react";
+var localChatSequence = 0;
+function localChatId() {
+  localChatSequence += 1;
+  return `local-chat-${localChatSequence}`;
+}
+__name(localChatId, "localChatId");
 function useAgentChat(options = {}) {
   const latest = useRef12(options);
   latest.current = options;
+  const resolved = useAgentBackend(options.backend);
+  const client = useRef12(resolved).current;
+  const createdThreadId = useRef12(void 0);
+  const chatIdRef = useRef12(options.threadId ?? localChatId());
+  const boundThreadRef = useRef12(options.threadId);
+  if (options.threadId !== boundThreadRef.current) {
+    boundThreadRef.current = options.threadId;
+    const adopting = options.threadId !== void 0 && options.threadId === createdThreadId.current;
+    if (!adopting) {
+      chatIdRef.current = options.threadId ?? localChatId();
+      createdThreadId.current = void 0;
+    }
+  }
+  const chatId = chatIdRef.current;
   const [runId, setRunId] = useState14(options.resumeRunId);
   const runIdRef = useRef12(runId);
   runIdRef.current = runId;
   const settlingRunIdRef = useRef12(void 0);
   const autoResumeRunIdRef = useRef12(void 0);
-  const [autoResume, setAutoResume] = useState14(false);
   const [activeRunId, setActiveRunId] = useState14(null);
+  const [isLoadingHistory, setIsLoadingHistory] = useState14(false);
+  const [historyError, setHistoryError] = useState14(null);
+  const [threadModel, setThreadModel] = useState14(null);
+  const [pickedModel, setPickedModel] = useState14(void 0);
+  const pickedModelRef = useRef12(pickedModel);
+  pickedModelRef.current = pickedModel;
+  const pendingPin = useRef12(void 0);
   const regenerateNext = useRef12(false);
-  const createdThreadId = useRef12(void 0);
-  const resolved = useAgentBackend(options.backend);
-  const client = useRef12(resolved).current;
+  const currentThreadId = useCallback11(() => latest.current.threadId ?? createdThreadId.current, []);
   const [connection, setConnection] = useState14({
     status: "live"
   });
   const resyncAfterSettle = useRef12(false);
-  useEffect14(() => {
-    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 = useMemo11(() => {
     function onMeta(meta) {
       settlingRunIdRef.current = meta.runId;
       setRunId(meta.runId);
       if (latest.current.threadId === void 0 && meta.threadId && createdThreadId.current !== meta.threadId) {
         createdThreadId.current = meta.threadId;
+        const pin = pendingPin.current;
+        if (pin !== void 0) {
+          pendingPin.current = void 0;
+          void client.updateThread(meta.threadId, {
+            model: pin.model
+          }).catch(() => void 0);
+        }
         latest.current.onThreadCreated?.(meta.threadId);
         notifyThreads(client, {
           type: "changed"
@@ -5077,13 +5158,14 @@ function useAgentChat(options = {}) {
         const pageContext = current.getPageContext?.() ?? null;
         const regenerate2 = regenerateNext.current;
         regenerateNext.current = false;
-        const threadId = current.threadId ?? createdThreadId.current;
+        const threadId = currentThreadId();
+        const model = current.model ?? pickedModelRef.current;
         return {
           ...threadId !== void 0 ? {
             threadId
           } : {},
-          ...current.model !== void 0 ? {
-            model: current.model
+          ...model !== void 0 ? {
+            model
           } : {},
           ...pageContext ? {
             pageContext
@@ -5103,10 +5185,8 @@ function useAgentChat(options = {}) {
   const backgroundRef = useRef12(() => Promise.resolve());
   const chat = useChat({
     transport,
-    resume: options.resumeRunId !== void 0 || autoResume,
-    ...options.threadId !== void 0 ? {
-      id: options.threadId
-    } : {},
+    id: chatId,
+    resume: options.resumeRunId !== void 0,
     ...options.initialMessages !== void 0 ? {
       messages: options.initialMessages
     } : {},
@@ -5116,7 +5196,7 @@ function useAgentChat(options = {}) {
         const title = part.data?.title;
         if (typeof title === "string") {
           latest.current.onTitle?.(title);
-          const threadId = latest.current.threadId ?? createdThreadId.current;
+          const threadId = currentThreadId();
           if (threadId !== void 0) notifyThreads(client, {
             type: "title",
             threadId,
@@ -5152,7 +5232,7 @@ function useAgentChat(options = {}) {
   const chatRef = useRef12(chat);
   chatRef.current = chat;
   async function resyncFromThread() {
-    const threadId = latest.current.threadId ?? createdThreadId.current;
+    const threadId = currentThreadId();
     if (threadId === void 0) return;
     try {
       const thread = await client.getThread(threadId);
@@ -5161,13 +5241,75 @@ function useAgentChat(options = {}) {
     }
   }
   __name(resyncFromThread, "resyncFromThread");
+  const firstChatId = useRef12(chatId);
+  useEffect14(() => {
+    if (chatId === firstChatId.current) return;
+    firstChatId.current = chatId;
+    setRunId(void 0);
+    setActiveRunId(null);
+    setThreadModel(null);
+    setBackgroundRuns([]);
+    setHistoryError(null);
+    autoResumeRunIdRef.current = void 0;
+    pendingPin.current = void 0;
+  }, [
+    chatId
+  ]);
+  useEffect14(() => {
+    const threadId = options.threadId;
+    if (threadId === void 0) return;
+    if (threadId === createdThreadId.current) return;
+    const current = latest.current;
+    const wantHistory = current.history !== false && current.initialMessages === void 0;
+    const wantResume = current.resume !== false && current.resumeRunId === void 0;
+    if (!wantHistory && !wantResume) return;
+    let cancelled = false;
+    if (wantHistory) setIsLoadingHistory(true);
+    client.getThread(threadId).then((thread) => {
+      if (cancelled || thread == null) return;
+      const active = thread.activeRunId ?? null;
+      const stored = Array.isArray(thread.messages) ? thread.messages : [];
+      setActiveRunId(active);
+      setThreadModel(thread.model ?? null);
+      setHistoryError(null);
+      const resuming = wantResume && active !== null;
+      if (wantHistory && chatRef.current.messages.length === 0) {
+        const rows = resuming ? stored.filter((message) => !(message.role === "assistant" && message.runId === active)) : stored;
+        chatRef.current.setMessages(storedThreadToUiMessages(rows));
+      }
+      if (resuming) {
+        autoResumeRunIdRef.current = active;
+        void chatRef.current.resumeStream();
+      }
+    }, (error) => {
+      if (cancelled) return;
+      setHistoryError(error instanceof Error ? error : new Error(String(error)));
+    }).finally(() => {
+      if (!cancelled) setIsLoadingHistory(false);
+    });
+    return () => {
+      cancelled = true;
+      setIsLoadingHistory(false);
+    };
+  }, [
+    client,
+    chatId,
+    options.threadId
+  ]);
   const turnInFlight = useRef12(false);
   const isTurnInFlight = useCallback11(() => turnInFlight.current || transport.isAttemptLive, [
     transport
   ]);
+  const quota = useQuota({
+    backend: client,
+    enabled: options.quota !== false && typeof client.getQuota === "function"
+  });
+  const blocked = options.blocked !== void 0 ? options.blocked : quota.blocked;
+  const blockedRef = useRef12(blocked);
+  blockedRef.current = blocked;
   const sendMessage = useCallback11(async (...args) => {
-    const blocked = latest.current.blocked;
-    if (blocked != null) throw new QuotaBlockedError(blocked);
+    const block = blockedRef.current;
+    if (block != null) throw new QuotaBlockedError(block);
     if (isTurnInFlight()) return;
     turnInFlight.current = true;
     try {
@@ -5183,11 +5325,9 @@ function useAgentChat(options = {}) {
     toolCallId,
     output
   }), []);
-  const [threads, setThreads] = useState14([]);
-  const [quota, setQuota] = useState14(null);
   const [backgroundRuns, setBackgroundRuns] = useState14([]);
   const refreshBackground = useCallback11(async () => {
-    const threadId = latest.current.threadId ?? createdThreadId.current;
+    const threadId = currentThreadId();
     if (threadId === void 0) {
       return;
     }
@@ -5207,7 +5347,8 @@ function useAgentChat(options = {}) {
       ];
     });
   }, [
-    client
+    client,
+    currentThreadId
   ]);
   backgroundRef.current = refreshBackground;
   const isWorking = backgroundRuns.some((run) => run.status === "running");
@@ -5219,6 +5360,7 @@ function useAgentChat(options = {}) {
   }, [
     options.background,
     options.threadId,
+    chatId,
     refreshBackground
   ]);
   useEffect14(() => {
@@ -5232,59 +5374,12 @@ function useAgentChat(options = {}) {
     isWorking,
     refreshBackground
   ]);
-  const loadThreads = useCallback11(async () => {
-    const list = await client.listThreads();
-    setThreads(list);
-    return list;
-  }, [
-    client
-  ]);
-  const loadThread = useCallback11((id) => client.getThread(id), [
-    client
-  ]);
-  const deleteThread = useCallback11(async (id) => {
-    await client.deleteThread(id);
-    setThreads((current) => current.filter((thread) => thread.id !== id));
-  }, [
-    client
-  ]);
-  const forkThread = useCallback11((threadId, messageId) => requireBackendMethod(client, "forkFromMessage")(threadId, messageId), [
-    client
-  ]);
-  const renameThread = useCallback11(async (id, title) => {
-    await client.updateThread(id, {
-      title
-    });
-    setThreads((current) => current.map((thread) => thread.id === id ? {
-      ...thread,
-      title
-    } : thread));
-  }, [
-    client
-  ]);
-  const promoteThread = useCallback11(async (id) => {
-    await requireBackendMethod(client, "promoteThread")(id);
-    await loadThreads();
-  }, [
-    client,
-    loadThreads
-  ]);
-  const truncateFromMessage = useCallback11((threadId, messageId) => requireBackendMethod(client, "truncateFromMessage")(threadId, messageId).then(() => void 0), [
-    client
-  ]);
-  const loadQuota = useCallback11(async () => {
-    const today = await requireBackendMethod(client, "getQuotaToday")();
-    setQuota(today);
-    return today;
-  }, [
-    client
-  ]);
   const cancel = useCallback11(async () => {
     chatRef.current.stop();
-    const activeRunId2 = runIdRef.current;
-    if (activeRunId2) {
+    const active = runIdRef.current;
+    if (active) {
       try {
-        await client.cancelStream(activeRunId2);
+        await client.cancelStream(active);
       } catch {
       }
     }
@@ -5334,9 +5429,9 @@ function useAgentChat(options = {}) {
   }, [
     client
   ]);
-  const regenerate = useCallback11(() => {
-    const blocked = latest.current.blocked;
-    if (blocked != null) throw new QuotaBlockedError(blocked);
+  const regenerate = useCallback11((_input) => {
+    const block = blockedRef.current;
+    if (block != null) throw new QuotaBlockedError(block);
     if (isTurnInFlight()) return;
     regenerateNext.current = true;
     turnInFlight.current = true;
@@ -5346,15 +5441,78 @@ function useAgentChat(options = {}) {
   }, [
     isTurnInFlight
   ]);
-  const background = {
-    runs: backgroundRuns,
-    isWorking,
-    refresh: refreshBackground
-  };
-  const setThreadModel = useCallback11(async (model) => {
-    const threadId = latest.current.threadId ?? createdThreadId.current;
+  const storedIdOf = useCallback11(async (messageId, threadId) => {
+    const message = chatRef.current.messages.find((candidate) => candidate.id === messageId);
+    const runOf = message?.metadata?.runId;
+    if (runOf === void 0) return messageId;
+    const thread = await client.getThread(threadId);
+    const row = [
+      ...thread.messages
+    ].reverse().find((candidate) => candidate.role === "assistant" && candidate.runId === runOf);
+    return row?.id ?? messageId;
+  }, [
+    client
+  ]);
+  const fork = useCallback11(async ({ messageId, threadId }) => {
+    const source = threadId ?? currentThreadId();
+    if (source === void 0) throw new Error("fork: this chat has no thread yet");
+    const stored = await storedIdOf(messageId, source);
+    const forked = await requireBackendMethod(client, "forkFromMessage")(source, stored);
+    notifyThreads(client, {
+      type: "changed"
+    });
+    latest.current.onThreadCreated?.(forked.id);
+    return forked;
+  }, [
+    client,
+    currentThreadId,
+    storedIdOf
+  ]);
+  const truncateFrom = useCallback11(async ({ messageId, threadId }) => {
+    const target = threadId ?? currentThreadId();
+    if (target === void 0) throw new Error("truncateFrom: this chat has no thread yet");
+    const stored = await storedIdOf(messageId, target);
+    await requireBackendMethod(client, "truncateFromMessage")(target, stored);
+  }, [
+    client,
+    currentThreadId,
+    storedIdOf
+  ]);
+  const promote = useCallback11(async ({ threadId } = {}) => {
+    const target = threadId ?? currentThreadId();
+    if (target === void 0) throw new Error("promote: this chat has no thread yet");
+    await requireBackendMethod(client, "promoteThread")(target);
+    notifyThreads(client, {
+      type: "changed"
+    });
+  }, [
+    client,
+    currentThreadId
+  ]);
+  const [modelsWanted, setModelsWanted] = useState14(false);
+  const modelsWantedRef = useRef12(modelsWanted);
+  modelsWantedRef.current = modelsWanted;
+  const catalog = useModels({
+    backend: client,
+    ...options.agent !== void 0 ? {
+      agent: options.agent
+    } : {},
+    enabled: modelsWanted && typeof client.listModels === "function"
+  });
+  const wantModels = useCallback11(() => {
+    if (modelsWantedRef.current) return;
+    modelsWantedRef.current = true;
+    queueMicrotask(() => setModelsWanted(true));
+  }, []);
+  const selectModel = useCallback11((id) => setPickedModel(id), []);
+  const pinToThread = useCallback11(async (model) => {
+    const threadId = currentThreadId();
+    setThreadModel(model);
     if (threadId === void 0) {
-      throw new Error("setThreadModel: this chat has no thread yet");
+      pendingPin.current = {
+        model
+      };
+      return;
     }
     await client.updateThread(threadId, {
       model
@@ -5363,10 +5521,99 @@ function useAgentChat(options = {}) {
       type: "changed"
     });
   }, [
-    client
+    client,
+    currentThreadId
   ]);
-  const getThreadId = useCallback11(() => latest.current.threadId ?? createdThreadId.current, []);
+  const models = {
+    get list() {
+      wantModels();
+      return catalog.models;
+    },
+    get providers() {
+      wantModels();
+      return catalog.providers;
+    },
+    selected: options.model ?? pickedModel ?? threadModel ?? catalog.defaultModel ?? null,
+    select: selectModel,
+    pinToThread,
+    isLoading: modelsWanted && catalog.isLoading,
+    error: catalog.error
+  };
   const status = connection.status === "reconnecting" ? "reconnecting" : chat.status;
+  const isBusy = status === "submitted" || status === "streaming" || status === "reconnecting";
+  const files = useAttachments({
+    ...options.composer,
+    backend: client
+  });
+  const [text, setText] = useState14("");
+  const blockedBy = blocked != null ? "quota" : files.isUploading ? "uploading" : isBusy ? "busy" : text.trim().length === 0 && files.attachments.length === 0 ? "empty" : null;
+  const composerRef = useRef12({
+    text,
+    files,
+    blockedBy
+  });
+  composerRef.current = {
+    text,
+    files,
+    blockedBy
+  };
+  const submit = useCallback11(async () => {
+    const current = composerRef.current;
+    if (current.blockedBy !== null) return;
+    const refs = current.files.refs;
+    const draft = current.text.trim();
+    setText("");
+    current.files.clear();
+    await sendMessage({
+      text: draft
+    }, refs.length > 0 ? {
+      body: {
+        attachments: refs
+      }
+    } : void 0);
+  }, [
+    sendMessage
+  ]);
+  const composer = {
+    text,
+    setText,
+    files,
+    canSend: blockedBy === null,
+    blockedBy,
+    submit
+  };
+  const ownCatalog = options.transcript?.toolCatalog;
+  const tools = useToolCatalog({
+    backend: client,
+    ...options.agent !== void 0 ? {
+      agent: options.agent
+    } : {},
+    enabled: ownCatalog === void 0 && typeof client.listTools === "function"
+  });
+  const canFork = typeof client.forkFromMessage === "function";
+  const transcript = useChatTranscript({
+    messages: chat.messages,
+    status,
+    onStop: cancel,
+    onApprove: approve,
+    onReject: reject,
+    onAnswer: answer,
+    onSkip: skip,
+    regeneratable: true,
+    onRegenerate: regenerate,
+    ...canFork ? {
+      onFork: /* @__PURE__ */ __name((input) => fork(input).then(() => void 0), "onFork")
+    } : {},
+    ...ownCatalog === void 0 ? {
+      toolCatalog: tools.catalog
+    } : {},
+    ...options.transcript
+  });
+  const background = {
+    runs: backgroundRuns,
+    isWorking,
+    refresh: refreshBackground
+  };
   return {
     ...chat,
     status,
@@ -5377,32 +5624,38 @@ function useAgentChat(options = {}) {
     /** Sub-agents this conversation started and did not wait for. */
     background,
     runId,
-    /** The `resume`-fetched thread's active run id, or `null` once resolved with none. */
+    /** The loaded thread's running turn, or `null` once read with none. */
     activeRunId,
+    /** The thread's history is being read. */
+    isLoadingHistory,
+    /** Reading the thread's history failed. */
+    historyError,
     /**
     * The thread this chat is on right now: the `threadId` option, else the one the backend created
     * on the first send. A getter, because the created id is learned mid-stream.
     */
-    getThreadId,
-    setThreadModel,
+    getThreadId: currentThreadId,
     /** The backend this chat talks to — the same one every other hook under the provider uses. */
     backend: client,
-    threads,
-    loadThreads,
-    loadThread,
-    deleteThread,
-    forkThread,
-    renameThread,
-    promoteThread,
-    truncateFromMessage,
+    /** The transcript model, with every action already bound to this chat. */
+    transcript,
+    /** A headless composer: draft, files, send gate, `submit()`. */
+    composer,
+    /** The model picker: `list`, `selected`, `select(id)`, `pinToThread(id)`. */
+    models,
+    /** The caller's budget (`GET <base>/quota`); `quota.blocked` gates sends. */
     quota,
-    loadQuota,
+    /** The window blocking sends right now (the `blocked` option, else the quota report's). */
+    blocked,
     cancel,
     approve,
     reject,
     answer,
     skip,
-    regenerate
+    regenerate,
+    fork,
+    truncateFrom,
+    promote
   };
 }
 __name(useAgentChat, "useAgentChat");