@dudousxd/nestjs-agent-react 0.31.4 → 0.32.0

package/dist/index.js

@@ -527,6 +527,7 @@ var AgentChatTransport = class {
       const message = lastMessage ? extractText(lastMessage) : "";
       const body = {
         ...this.options.agent !== void 0 ? { agent: this.options.agent } : {},
+        ...this.options.persona !== void 0 ? { persona: this.options.persona } : {},
         ...this.options.getBody?.() ?? {},
         ...options.body ?? {},
         message
@@ -2155,7 +2156,7 @@ function applyPatch(target, patch) {
 }
 
 // src/catalog/use-agents.ts
-import { useMemo as useMemo5 } from "react";
+import { useCallback as useCallback4, useMemo as useMemo5 } from "react";
 
 // src/catalog/use-resource.ts
 import { useCallback as useCallback3, useEffect as useEffect5, useRef as useRef4, useState as useState5 } from "react";
@@ -2197,16 +2198,24 @@ function useAgents(options = {}) {
     "",
     enabled
   );
+  const find = useCallback4(
+    (name) => (data ?? []).find(
+      (agent) => name === void 0 ? agent.isDefault === true : agent.name === name
+    ),
+    [data]
+  );
   return useMemo5(() => {
     const agents = data ?? [];
     return {
       agents,
       defaultAgent: agents.find((agent) => agent.isDefault === true)?.name ?? null,
+      personasOf: (agent) => find(agent)?.personas ?? [],
+      defaultPersonaOf: (agent) => find(agent)?.defaultPersona ?? null,
       isLoading,
       error,
       refresh
     };
-  }, [data, isLoading, error, refresh]);
+  }, [data, find, isLoading, error, refresh]);
 }
 
 // src/catalog/use-models.ts
@@ -2304,7 +2313,7 @@ function useQuota(options = {}) {
 }
 
 // src/feedback/use-message-feedback.ts
-import { useCallback as useCallback4, useRef as useRef5, useState as useState6 } from "react";
+import { useCallback as useCallback5, useRef as useRef5, useState as useState6 } from "react";
 function useMessageFeedback(options = {}) {
   const backend = useAgentBackend(options.backend);
   const latest = useRef5({ ...options, backend });
@@ -2315,7 +2324,7 @@ function useMessageFeedback(options = {}) {
   const localRef = useRef5(local);
   localRef.current = local;
   const resolved = useRef5(/* @__PURE__ */ new Map());
-  const feedbackOf = useCallback4(
+  const feedbackOf = useCallback5(
     (message) => {
       const mine = local.get(message.id);
       if (mine !== void 0) return mine.feedback;
@@ -2323,8 +2332,8 @@ function useMessageFeedback(options = {}) {
     },
     [local]
   );
-  const isPending = useCallback4((message) => pending.has(message.id), [pending]);
-  const storedIdFor = useCallback4(async (message) => {
+  const isPending = useCallback5((message) => pending.has(message.id), [pending]);
+  const storedIdFor = useCallback5(async (message) => {
     const runId = metadataOf(message).runId;
     if (runId === void 0) return message.id;
     const known = resolved.current.get(message.id);
@@ -2342,7 +2351,7 @@ function useMessageFeedback(options = {}) {
     resolved.current.set(message.id, row.id);
     return row.id;
   }, []);
-  const rate = useCallback4(
+  const rate = useCallback5(
     async (message, value, comment) => {
       const setFeedback = requireBackendMethod(latest.current.backend, "setMessageFeedback");
       const had = localRef.current.get(message.id);
@@ -2381,7 +2390,7 @@ function useMessageFeedback(options = {}) {
     },
     [storedIdFor]
   );
-  const toggle = useCallback4(
+  const toggle = useCallback5(
     (message, value) => {
       const mine = localRef.current.get(message.id);
       const current = mine !== void 0 ? mine.feedback : metadataOf(message).feedback ?? null;
@@ -2397,7 +2406,7 @@ function metadataOf(message) {
 }
 
 // src/threads/use-threads.ts
-import { useCallback as useCallback5, useEffect as useEffect7, useRef as useRef6, useState as useState7 } from "react";
+import { useCallback as useCallback6, useEffect as useEffect7, useRef as useRef6, useState as useState7 } from "react";
 function useThreads(options = {}) {
   const { enabled = true } = options;
   const backend = useAgentBackend(options.backend);
@@ -2407,7 +2416,7 @@ function useThreads(options = {}) {
   const threadsRef = useRef6(threads);
   threadsRef.current = threads;
   const generation = useRef6(0);
-  const refresh = useCallback5(async () => {
+  const refresh = useCallback6(async () => {
     const mine = ++generation.current;
     setIsLoading(true);
     try {
@@ -2439,7 +2448,7 @@ function useThreads(options = {}) {
       }
     });
   }, [backend, enabled, refresh]);
-  const rename = useCallback5(
+  const rename = useCallback6(
     async (id, title) => {
       const before = threadsRef.current;
       setThreads(
@@ -2455,7 +2464,7 @@ function useThreads(options = {}) {
     },
     [backend]
   );
-  const remove = useCallback5(
+  const remove = useCallback6(
     async (id) => {
       const before = threadsRef.current;
       setThreads((current) => current.filter((thread) => thread.id !== id));
@@ -2514,7 +2523,7 @@ function backgroundRunsFromThread(messages) {
 import { useEffect as useEffect9, useState as useState9 } from "react";
 
 // src/components/use-speech-recognition.ts
-import { useCallback as useCallback6, useEffect as useEffect8, useMemo as useMemo8, useRef as useRef7, useState as useState8 } from "react";
+import { useCallback as useCallback7, useEffect as useEffect8, useMemo as useMemo8, useRef as useRef7, useState as useState8 } from "react";
 function getRecognitionCtor() {
   if (typeof window === "undefined") return null;
   const scope = window;
@@ -2569,7 +2578,7 @@ function useSpeechRecognition({
       recognitionRef.current = null;
     };
   }, [ctor, lang]);
-  const start = useCallback6(() => {
+  const start = useCallback7(() => {
     const recognition = recognitionRef.current;
     if (!recognition) return;
     try {
@@ -2579,7 +2588,7 @@ function useSpeechRecognition({
       console.warn("SpeechRecognition start failed", error);
     }
   }, []);
-  const stop = useCallback6(() => {
+  const stop = useCallback7(() => {
     const recognition = recognitionRef.current;
     if (!recognition) return;
     try {
@@ -2699,7 +2708,7 @@ function ChatInput({
 import React2 from "react";
 
 // src/transcript/use-chat-transcript.ts
-import { useCallback as useCallback8, useEffect as useEffect11, useRef as useRef9, useState as useState11 } from "react";
+import { useCallback as useCallback9, useEffect as useEffect11, useRef as useRef9, useState as useState11 } from "react";
 
 // src/transcript/model.ts
 import {
@@ -3572,14 +3581,14 @@ function formatCostUsd(cost) {
 }
 
 // src/transcript/use-stick-to-bottom.ts
-import { useCallback as useCallback7, useEffect as useEffect10, useRef as useRef8, useState as useState10 } from "react";
+import { useCallback as useCallback8, useEffect as useEffect10, useRef as useRef8, useState as useState10 } from "react";
 function useStickToBottom({
   contentKey,
   threshold = 32
 }) {
   const containerRef = useRef8(null);
   const [isAtBottom, setIsAtBottom] = useState10(true);
-  const measure = useCallback7(() => {
+  const measure = useCallback8(() => {
     const element = containerRef.current;
     if (!element) {
       return;
@@ -3587,7 +3596,7 @@ function useStickToBottom({
     const distance = element.scrollHeight - element.scrollTop - element.clientHeight;
     setIsAtBottom(distance <= threshold);
   }, [threshold]);
-  const scrollToBottom = useCallback7(() => {
+  const scrollToBottom = useCallback8(() => {
     const element = containerRef.current;
     if (!element) {
       return;
@@ -3595,7 +3604,7 @@ function useStickToBottom({
     element.scrollTop = element.scrollHeight;
     setIsAtBottom(true);
   }, []);
-  const setContainer = useCallback7(
+  const setContainer = useCallback8(
     (element) => {
       containerRef.current = element;
       if (element) {
@@ -3609,7 +3618,7 @@ function useStickToBottom({
       scrollToBottom();
     }
   }, [contentKey, isAtBottom, scrollToBottom]);
-  const getContainerProps = useCallback7(
+  const getContainerProps = useCallback8(
     () => ({ ref: setContainer, onScroll: measure }),
     [setContainer, measure]
   );
@@ -3656,7 +3665,7 @@ function useChatTranscript(options) {
     streamingMessageId,
     options
   });
-  const stop = useCallback8(() => {
+  const stop = useCallback9(() => {
     const current = latest.current;
     if (current.status !== "submitted" && current.status !== "streaming" && current.status !== "reconnecting") {
       return;
@@ -3664,13 +3673,13 @@ function useChatTranscript(options) {
     setStopRequested(true);
     void current.onStop?.();
   }, []);
-  const loadEarlier = useCallback8(
+  const loadEarlier = useCallback9(
     () => setVisibleCount(
       (count) => count + (latest.current.loadEarlierStep ?? DEFAULT_LOAD_EARLIER_STEP)
     ),
     []
   );
-  const showAll = useCallback8(() => setVisibleCount(latest.current.messages.length), []);
+  const showAll = useCallback9(() => setVisibleCount(latest.current.messages.length), []);
   const scroll = useStickToBottom({
     contentKey: contentSignature(messages),
     ...stickToBottomThreshold !== void 0 ? { threshold: stickToBottomThreshold } : {}
@@ -3708,7 +3717,7 @@ function useQueuedItems(queue, readOnly) {
   const latestQueue = useRef9(queue);
   latestQueue.current = queue;
   const removers = useRef9(/* @__PURE__ */ new Map());
-  const removerFor = useCallback8((id) => {
+  const removerFor = useCallback9((id) => {
     let remover = removers.current.get(id);
     if (remover === void 0) {
       remover = () => {
@@ -3784,14 +3793,14 @@ function useTranscriptItems({
   );
   const callbackCache = useRef9(/* @__PURE__ */ new Map());
   const reasoningToggleCache = useRef9(/* @__PURE__ */ new Map());
-  const toggleReasoning = useCallback8((key, open) => {
+  const toggleReasoning = useCallback9((key, open) => {
     setOpenReasoning((current) => {
       const next = new Map(current);
       next.set(key, open ?? !(current.get(key) ?? false));
       return next;
     });
   }, []);
-  const stableToggle = useCallback8(
+  const stableToggle = useCallback9(
     (key) => {
       let cached = reasoningToggleCache.current.get(key);
       if (!cached) {
@@ -3802,10 +3811,10 @@ function useTranscriptItems({
     },
     [toggleReasoning]
   );
-  const pick = useCallback8((toolCallId, questionId, values) => {
+  const pick = useCallback9((toolCallId, questionId, values) => {
     setPicks((current) => new Map(current).set(pickKey(toolCallId, questionId), values));
   }, []);
-  const settle = useCallback8(
+  const settle = useCallback9(
     (toolCallId, action, send) => {
       setSettleErrors((current) => {
         if (!current.has(toolCallId)) {
@@ -3837,7 +3846,7 @@ function useTranscriptItems({
     },
     []
   );
-  const answer = useCallback8(
+  const answer = useCallback9(
     (toolCallId) => {
       const current = latest.current;
       const onAnswer = current.handlers.onAnswer;
@@ -3852,7 +3861,7 @@ function useTranscriptItems({
     },
     [settle]
   );
-  const skip = useCallback8(
+  const skip = useCallback9(
     (toolCallId) => {
       const onSkip = latest.current.handlers.onSkip;
       if (onSkip) {
@@ -3861,7 +3870,7 @@ function useTranscriptItems({
     },
     [settle]
   );
-  const approve = useCallback8(
+  const approve = useCallback9(
     (toolCallId, options2) => {
       const onApprove = latest.current.handlers.onApprove;
       if (onApprove) {
@@ -3874,7 +3883,7 @@ function useTranscriptItems({
     },
     [settle]
   );
-  const reject = useCallback8(
+  const reject = useCallback9(
     (toolCallId) => {
       const onReject = latest.current.handlers.onReject;
       if (onReject) {
@@ -3883,7 +3892,7 @@ function useTranscriptItems({
     },
     [settle]
   );
-  const callbacksFor = useCallback8((id) => {
+  const callbacksFor = useCallback9((id) => {
     const cached = callbackCache.current.get(id);
     if (cached) {
       return cached;
@@ -4608,7 +4617,7 @@ function toItem(entry) {
 }
 
 // src/composer/use-composer-autocomplete.ts
-import { useCallback as useCallback9, useEffect as useEffect12, useId, useLayoutEffect, useMemo as useMemo9, useRef as useRef10, useState as useState12 } from "react";
+import { useCallback as useCallback10, useEffect as useEffect12, useId, useLayoutEffect, useMemo as useMemo9, useRef as useRef10, useState as useState12 } from "react";
 function useComposerAutocomplete(options) {
   const { value, sources, acceptOnTab = true } = options;
   const latest = useRef10(options);
@@ -4683,22 +4692,22 @@ function useComposerAutocomplete(options) {
   const activeItem = isOpen ? items[activeIndex] ?? null : null;
   const reactId = useId();
   const listboxId = options.id ?? `agent-autocomplete-${reactId}`;
-  const optionId = useCallback9((index) => `${listboxId}-option-${index}`, [listboxId]);
-  const highlight = useCallback9((index) => {
+  const optionId = useCallback10((index) => `${listboxId}-option-${index}`, [listboxId]);
+  const highlight = useCallback10((index) => {
     const total = itemsRef.current.length;
     if (total === 0) return;
     setActiveIndex((index % total + total) % total);
   }, []);
-  const moveHighlight = useCallback9(
+  const moveHighlight = useCallback10(
     (delta) => highlight(activeIndexRef.current + delta),
     [highlight]
   );
-  const dismiss = useCallback9(() => {
+  const dismiss = useCallback10(() => {
     const current = matchRef.current;
     if (current) setDismissedIndex(current.index);
   }, []);
   const pendingCaret = useRef10(null);
-  const accept = useCallback9((item) => {
+  const accept = useCallback10((item) => {
     const current = matchRef.current;
     if (!current) return;
     const chosen = item ?? itemsRef.current[activeIndexRef.current];
@@ -4715,10 +4724,10 @@ function useComposerAutocomplete(options) {
     pendingCaret.current = null;
     inputRef.current?.setSelectionRange(position, position);
   });
-  const readCaret = useCallback9((element) => {
+  const readCaret = useCallback10((element) => {
     setCaret(element.selectionStart ?? element.value.length);
   }, []);
-  const onKeyDown = useCallback9(
+  const onKeyDown = useCallback10(
     (event) => {
       if (!isOpen) return;
       const hasItems = itemsRef.current.length > 0;
@@ -4753,7 +4762,7 @@ function useComposerAutocomplete(options) {
     },
     [isOpen, acceptOnTab, accept, dismiss, moveHighlight]
   );
-  const onChange = useCallback9(
+  const onChange = useCallback10(
     (event) => {
       readCaret(event.target);
       const next = findActiveTrigger(
@@ -4767,18 +4776,18 @@ function useComposerAutocomplete(options) {
     },
     [readCaret]
   );
-  const onSelect = useCallback9(
+  const onSelect = useCallback10(
     (event) => readCaret(event.currentTarget),
     [readCaret]
   );
-  const onClick = useCallback9(
+  const onClick = useCallback10(
     (event) => readCaret(event.currentTarget),
     [readCaret]
   );
-  const setInput = useCallback9((element) => {
+  const setInput = useCallback10((element) => {
     inputRef.current = element;
   }, []);
-  const getInputProps = useCallback9(
+  const getInputProps = useCallback10(
     () => ({
       ref: setInput,
       onChange,
@@ -4805,7 +4814,7 @@ function useComposerAutocomplete(options) {
       optionId
     ]
   );
-  const getListboxProps = useCallback9(
+  const getListboxProps = useCallback10(
     () => ({
       id: listboxId,
       role: "listbox",
@@ -4813,7 +4822,7 @@ function useComposerAutocomplete(options) {
     }),
     [listboxId, match]
   );
-  const getOptionProps = useCallback9(
+  const getOptionProps = useCallback10(
     (index) => ({
       id: optionId(index),
       role: "option",
@@ -4846,7 +4855,7 @@ function isPromise(value) {
 
 // src/presentation/use-tool-catalog.ts
 import { ALL_AGENTS } from "@dudousxd/nestjs-agent-core";
-import { useCallback as useCallback10, useEffect as useEffect13, useMemo as useMemo10, useState as useState13 } from "react";
+import { useCallback as useCallback11, useEffect as useEffect13, useMemo as useMemo10, useState as useState13 } from "react";
 var shared2 = /* @__PURE__ */ new WeakMap();
 function load2(client, agent) {
   let byAgent = shared2.get(client);
@@ -4898,7 +4907,7 @@ function useToolCatalog(options = {}) {
       cancelled = true;
     };
   }, [client, agent, enabled, generation]);
-  const refresh = useCallback10(() => {
+  const refresh = useCallback11(() => {
     shared2.get(client)?.delete(agent ?? "");
     setGeneration((current) => current + 1);
   }, [client, agent]);
@@ -5065,6 +5074,8 @@ function storedMessageToUiMessage(message) {
     ...message.metadata,
     ...message.feedback !== void 0 ? { feedback: message.feedback } : {},
     ...message.createdAt ? { createdAt: message.createdAt } : {},
+    ...message.agentName !== void 0 ? { agentName: message.agentName } : {},
+    ...message.persona !== void 0 ? { persona: message.persona } : {},
     ...message.usage !== void 0 ? {
       usage: {
         inputTokens: message.usage.inputTokens,
@@ -5115,7 +5126,9 @@ function mergeTurn(rows) {
     ...Object.assign({}, ...rows.map((row) => row.metadata ?? {})),
     ...usage !== void 0 ? { usage } : {},
     ...feedback !== void 0 ? { feedback } : {},
-    ...createdAt ? { createdAt } : {}
+    ...createdAt ? { createdAt } : {},
+    ...lastRow.agentName !== void 0 ? { agentName: lastRow.agentName } : {},
+    ...lastRow.persona !== void 0 ? { persona: lastRow.persona } : {}
   };
   return {
     id: lastRow.id,
@@ -5141,7 +5154,7 @@ function sumUsage(rows) {
 
 // src/use-agent-chat.ts
 import { useChat } from "@ai-sdk/react";
-import { useCallback as useCallback11, useEffect as useEffect15, useMemo as useMemo11, useRef as useRef12, useState as useState15 } from "react";
+import { useCallback as useCallback12, useEffect as useEffect15, useMemo as useMemo11, useRef as useRef12, useState as useState15 } from "react";
 var EMPTY_QUEUE = { items: [], paused: null };
 var localQueueSequence = 0;
 function queuedUserMessage(turn) {
@@ -5222,19 +5235,20 @@ function useAgentChat(options = {}) {
   const [historyError, setHistoryError] = useState15(null);
   const [runError, setRunError] = useState15(null);
   const [threadModel, setThreadModel] = useState15(null);
+  const [threadPersona, setThreadPersona] = useState15(null);
   const [pickedModel, setPickedModel] = useState15(void 0);
   const pickedModelRef = useRef12(pickedModel);
   pickedModelRef.current = pickedModel;
   const lockedRef = useRef12(false);
   const pendingPin = useRef12(void 0);
   const regenerateNext = useRef12(false);
-  const currentThreadId = useCallback11(
+  const currentThreadId = useCallback12(
     () => latest.current.threadId ?? createdThreadId.current,
     []
   );
   const [queueState, setQueueState] = useState15(EMPTY_QUEUE);
   const queueStateRef = useRef12(queueState);
-  const applyQueue = useCallback11((next) => {
+  const applyQueue = useCallback12((next) => {
     queueStateRef.current = next;
     setQueueState(next);
   }, []);
@@ -5243,8 +5257,9 @@ function useAgentChat(options = {}) {
   const handoff = useRef12(void 0);
   const queuedSend = useRef12(void 0);
   const threadWaiters = useRef12([]);
-  const turnBody = useCallback11(() => {
+  const turnBody = useCallback12(() => {
     const current = latest.current;
+    if (current.persona !== void 0) setThreadPersona(current.persona);
     const pageContext = current.getPageContext?.() ?? null;
     const threadId = currentThreadId();
     const model = current.model ?? (lockedRef.current ? void 0 : pickedModelRef.current);
@@ -5252,6 +5267,7 @@ function useAgentChat(options = {}) {
       // Read per send: a host that switches agents before the first message (a picker on a new
       // chat) sends the one picked now, not the one this chat mounted with.
       ...current.agent !== void 0 ? { agent: current.agent } : {},
+      ...current.persona !== void 0 ? { persona: current.persona } : {},
       ...threadId !== void 0 ? { threadId } : {},
       ...model !== void 0 ? { model } : {},
       ...pageContext ? { pageContext } : {}
@@ -5420,6 +5436,7 @@ function useAgentChat(options = {}) {
     setRunId(void 0);
     setActiveRunId(null);
     setThreadModel(null);
+    setThreadPersona(null);
     setPickedModel(void 0);
     setBackgroundRuns([]);
     setHistoryError(null);
@@ -5448,6 +5465,7 @@ function useAgentChat(options = {}) {
         const stored = Array.isArray(thread.messages) ? thread.messages : [];
         setActiveRunId(active);
         setThreadModel(thread.model ?? null);
+        setThreadPersona(thread.persona ?? null);
         setHistoryError(null);
         const queue2 = thread.queue ?? EMPTY_QUEUE;
         applyQueue(queue2);
@@ -5479,7 +5497,7 @@ function useAgentChat(options = {}) {
   }, [client, chatId, options.threadId]);
   const isLoadingHistory = options.threadId !== void 0 && options.threadId !== createdThreadId.current && options.history !== false && options.initialMessages === void 0 && historyFor !== options.threadId;
   const turnInFlight = useRef12(false);
-  const isTurnInFlight = useCallback11(
+  const isTurnInFlight = useCallback12(
     () => turnInFlight.current || transport.isAttemptLive,
     [transport]
   );
@@ -5495,13 +5513,13 @@ function useAgentChat(options = {}) {
   whileRunningRef.current = whileRunning;
   const canQueueRef = useRef12(false);
   canQueueRef.current = typeof client.enqueueMessage === "function";
-  const threadForQueue = useCallback11(async () => {
+  const threadForQueue = useCallback12(async () => {
     const known = currentThreadId();
     if (known !== void 0) return known;
     if (!isTurnInFlight()) throw new Error("queue: this chat has no thread yet");
     return new Promise((resolve) => threadWaiters.current.push(resolve));
   }, [currentThreadId, isTurnInFlight]);
-  const queueCall = useCallback11(async (run) => {
+  const queueCall = useCallback12(async (run) => {
     try {
       const result = await run();
       setQueueError(null);
@@ -5511,7 +5529,7 @@ function useAgentChat(options = {}) {
       throw error;
     }
   }, []);
-  const enqueue = useCallback11(
+  const enqueue = useCallback12(
     async (text2, {
       attachments = [],
       mode = "queue"
@@ -5559,7 +5577,7 @@ function useAgentChat(options = {}) {
     },
     [client, queueCall, threadForQueue, turnBody, applyQueue, isTurnInFlight]
   );
-  const sendMessage = useCallback11(
+  const sendMessage = useCallback12(
     async (message, options2) => {
       const block = blockedRef.current;
       if (block != null) throw new QuotaBlockedError(block);
@@ -5583,7 +5601,7 @@ function useAgentChat(options = {}) {
     },
     [isTurnInFlight, enqueue]
   );
-  const removeQueued = useCallback11(
+  const removeQueued = useCallback12(
     async (id) => {
       const previous = queueStateRef.current;
       applyQueue({ ...previous, items: previous.items.filter((item) => item.id !== id) });
@@ -5596,7 +5614,7 @@ function useAgentChat(options = {}) {
     },
     [client, queueCall, applyQueue]
   );
-  const interruptQueued = useCallback11(
+  const interruptQueued = useCallback12(
     async (id) => {
       const previous = queueStateRef.current;
       const moving = previous.items.find((item) => item.id === id);
@@ -5631,7 +5649,7 @@ function useAgentChat(options = {}) {
     },
     [client, queueCall, applyQueue, isTurnInFlight]
   );
-  const editQueued = useCallback11(
+  const editQueued = useCallback12(
     async (id, text2) => {
       applyQueue(
         await queueCall(
@@ -5641,7 +5659,7 @@ function useAgentChat(options = {}) {
     },
     [client, queueCall, applyQueue]
   );
-  const moveQueued = useCallback11(
+  const moveQueued = useCallback12(
     async (id, index) => {
       const previous = queueStateRef.current;
       const moving = previous.items.find((item) => item.id === id);
@@ -5663,12 +5681,12 @@ function useAgentChat(options = {}) {
     },
     [client, queueCall, applyQueue]
   );
-  const clearQueue = useCallback11(async () => {
+  const clearQueue = useCallback12(async () => {
     const threadId = currentThreadId();
     if (threadId === void 0) return;
     applyQueue(await queueCall(() => requireBackendMethod(client, "clearQueue")(threadId)));
   }, [client, queueCall, currentThreadId, applyQueue]);
-  const resumeQueue = useCallback11(async () => {
+  const resumeQueue = useCallback12(async () => {
     const threadId = currentThreadId();
     if (threadId === void 0) return;
     const before = queueStateRef.current;
@@ -5716,7 +5734,7 @@ function useAgentChat(options = {}) {
     resume: resumeQueue,
     error: queueError
   };
-  const addToolResult = useCallback11(
+  const addToolResult = useCallback12(
     ({ tool, toolCallId, output }) => chatRef.current.addToolResult({
       tool,
       toolCallId,
@@ -5725,7 +5743,7 @@ function useAgentChat(options = {}) {
     []
   );
   const [backgroundRuns, setBackgroundRuns] = useState15([]);
-  const refreshBackground = useCallback11(async () => {
+  const refreshBackground = useCallback12(async () => {
     const threadId = currentThreadId();
     if (threadId === void 0) {
       return;
@@ -5759,7 +5777,7 @@ function useAgentChat(options = {}) {
     const timer = setInterval(() => void refreshBackground(), every);
     return () => clearInterval(timer);
   }, [isWorking, refreshBackground]);
-  const cancel = useCallback11(async () => {
+  const cancel = useCallback12(async () => {
     chatRef.current.stop();
     const active = runIdRef.current;
     if (active) {
@@ -5776,7 +5794,7 @@ function useAgentChat(options = {}) {
       }
     }
   }, [client, currentThreadId, applyQueue]);
-  const approve = useCallback11(
+  const approve = useCallback12(
     async ({ toolCallId, remember, via }) => {
       await requireBackendMethod(
         client,
@@ -5789,7 +5807,7 @@ function useAgentChat(options = {}) {
     },
     [client]
   );
-  const reject = useCallback11(
+  const reject = useCallback12(
     async ({ toolCallId, reason, via }) => {
       await requireBackendMethod(
         client,
@@ -5802,7 +5820,7 @@ function useAgentChat(options = {}) {
     },
     [client]
   );
-  const answer = useCallback11(
+  const answer = useCallback12(
     async ({ toolCallId, answers, via }) => {
       await requireBackendMethod(
         client,
@@ -5815,7 +5833,7 @@ function useAgentChat(options = {}) {
     },
     [client]
   );
-  const skip = useCallback11(
+  const skip = useCallback12(
     async ({ toolCallId, via }) => {
       await requireBackendMethod(
         client,
@@ -5824,7 +5842,7 @@ function useAgentChat(options = {}) {
     },
     [client]
   );
-  const regenerate = useCallback11(
+  const regenerate = useCallback12(
     (_input) => {
       const block = blockedRef.current;
       if (block != null) throw new QuotaBlockedError(block);
@@ -5837,7 +5855,7 @@ function useAgentChat(options = {}) {
     },
     [isTurnInFlight]
   );
-  const storedIdOf = useCallback11(
+  const storedIdOf = useCallback12(
     async (messageId, threadId) => {
       const message = chatRef.current.messages.find((candidate) => candidate.id === messageId);
       const runOf = message?.metadata?.runId;
@@ -5848,7 +5866,7 @@ function useAgentChat(options = {}) {
     },
     [client]
   );
-  const fork = useCallback11(
+  const fork = useCallback12(
     async ({
       messageId,
       threadId
@@ -5863,7 +5881,7 @@ function useAgentChat(options = {}) {
     },
     [client, currentThreadId, storedIdOf]
   );
-  const truncateFrom = useCallback11(
+  const truncateFrom = useCallback12(
     async ({ messageId, threadId }) => {
       const target = threadId ?? currentThreadId();
       if (target === void 0) throw new Error("truncateFrom: this chat has no thread yet");
@@ -5872,7 +5890,7 @@ function useAgentChat(options = {}) {
     },
     [client, currentThreadId, storedIdOf]
   );
-  const promote = useCallback11(
+  const promote = useCallback12(
     async ({ threadId } = {}) => {
       const target = threadId ?? currentThreadId();
       if (target === void 0) throw new Error("promote: this chat has no thread yet");
@@ -5889,16 +5907,16 @@ function useAgentChat(options = {}) {
     ...options.agent !== void 0 ? { agent: options.agent } : {},
     enabled: modelsWanted && typeof client.listModels === "function"
   });
-  const wantModels = useCallback11(() => {
+  const wantModels = useCallback12(() => {
     if (modelsWantedRef.current) return;
     modelsWantedRef.current = true;
     queueMicrotask(() => setModelsWanted(true));
   }, []);
   lockedRef.current = catalog.locked !== null;
-  const selectModel = useCallback11((id) => {
+  const selectModel = useCallback12((id) => {
     if (!lockedRef.current) setPickedModel(id);
   }, []);
-  const pinToThread = useCallback11(
+  const pinToThread = useCallback12(
     async (model) => {
       const threadId = currentThreadId();
       setThreadModel(model);
@@ -5945,7 +5963,7 @@ function useAgentChat(options = {}) {
   const blockedBy = blocked != null ? "quota" : files.isUploading ? "uploading" : isBusy && whileRunning === "block" ? "busy" : text.trim().length === 0 && files.refs.length === 0 ? "empty" : null;
   const composerRef = useRef12({ text, files, blockedBy });
   composerRef.current = { text, files, blockedBy };
-  const submit = useCallback11(
+  const submit = useCallback12(
     async (options2) => {
       const current = composerRef.current;
       const asked = canQueueRef.current ? options2?.mode : void 0;
@@ -6059,6 +6077,11 @@ function useAgentChat(options = {}) {
     queue,
     /** The model picker: `list`, `selected`, `select(id)`, `pinToThread(id)`. */
     models,
+    /**
+     * The persona pinned on this thread (`ThreadSummary.persona`), or `null` when none is — what a
+     * persona picker on a reopened thread starts from (`?? agent.defaultPersona`).
+     */
+    threadPersona,
     /** The caller's budget (`GET <base>/quota`); `quota.blocked` gates sends. */
     quota,
     /** The window blocking sends right now (the `blocked` option, else the quota report's). */