@elizaos/agent 2.0.0-alpha.520 → 2.0.0-alpha.521

package/packages/app-core/src/state/useChatCallbacks.js

@@ -1,773 +0,0 @@
-/**
- * Chat callbacks — extracted from AppContext.
- *
- * Assembler hook: composes useChatLifecycle + useChatSend and owns the
- * greeting / conversation-management callbacks that depend on both.
- */
-import { useCallback, useEffect, useRef } from "react";
-import { client, } from "../api";
-import { tabFromPath } from "../navigation";
-import { isTtsDebugEnabled } from "../utils/tts-debug";
-import { isConversationRecord, normalizeConversationList, } from "./chat-conversation-guards";
-import { loadActiveConversationId, } from "./internal";
-import { useChatLifecycle } from "./useChatLifecycle";
-import { useChatSend } from "./useChatSend";
-// ── Helpers (file-local) ────────────────────────────────────────────
-function shouldKeepConversationMessage(message) {
-    if (message.role !== "assistant")
-        return true;
-    if (message.text.trim().length > 0)
-        return true;
-    return Boolean(message.blocks?.length);
-}
-function filterRenderableConversationMessages(messages) {
-    return messages.filter((message) => shouldKeepConversationMessage(message));
-}
-function hasConversationBootstrapMessage(messages) {
-    return messages.some((message) => message.role === "assistant" && shouldKeepConversationMessage(message));
-}
-/** Enable with `ELIZA_TTS_DEBUG=1` or `localStorage.setItem("elizaos:debug:greeting", "1")`. */
-function greetingDebugEnabled() {
-    if (isTtsDebugEnabled())
-        return true;
-    try {
-        return (typeof localStorage !== "undefined" &&
-            localStorage.getItem("elizaos:debug:greeting") === "1");
-    }
-    catch {
-        return false;
-    }
-}
-function traceGreeting(phase, detail) {
-    if (!greetingDebugEnabled())
-        return;
-    if (detail && Object.keys(detail).length > 0) {
-        console.info(`[eliza][greeting] ${phase}`, detail);
-    }
-    else {
-        console.info(`[eliza][greeting] ${phase}`);
-    }
-}
-import { isRoutineCodingAgentMessage } from "../chat";
-const COMPANION_STALE_THREAD_MAX_AGE_MS = 30 * 60 * 1000;
-const COMPANION_STALE_THREAD_VISIBLE_MESSAGE_LIMIT = 2;
-function isPersistedGreetingMessage(message) {
-    return (message.role === "assistant" &&
-        message.source === "agent_greeting" &&
-        message.text.trim().length > 0);
-}
-function shouldStartFreshCompanionConversation(messages, now = Date.now()) {
-    const visibleMessages = messages
-        .filter((message) => shouldKeepConversationMessage(message))
-        .filter((message) => !isRoutineCodingAgentMessage(message))
-        .slice(-COMPANION_STALE_THREAD_VISIBLE_MESSAGE_LIMIT);
-    if (visibleMessages.length === 0) {
-        return false;
-    }
-    if (visibleMessages.length === 1 &&
-        isPersistedGreetingMessage(visibleMessages[0])) {
-        return false;
-    }
-    return visibleMessages.every((message) => {
-        if (!Number.isFinite(message.timestamp)) {
-            return false;
-        }
-        return now - message.timestamp > COMPANION_STALE_THREAD_MAX_AGE_MS;
-    });
-}
-function getNavigationPathFromWindow() {
-    if (typeof window === "undefined")
-        return "/";
-    if (window.location.protocol === "file:") {
-        return window.location.hash.replace(/^#/, "") || "/";
-    }
-    return window.location.pathname || "/";
-}
-function shouldAutoCreateInitialConversation() {
-    return tabFromPath(getNavigationPathFromWindow()) === "chat";
-}
-// ── Hook ────────────────────────────────────────────────────────────
-export function useChatCallbacks(deps) {
-    const { t, uiLanguage, uiShellMode, tab, agentStatus, chatMode, conversations, activeConversationId, companionMessageCutoffTs, conversationMessages, ptySessions, setChatInput, setChatSending, setChatFirstTokenReceived, setChatLastUsage, setChatPendingImages, setConversations, setActiveConversationId, setCompanionMessageCutoffTs, setConversationMessages, setUnreadConversations, resetConversationDraftState, activeConversationIdRef, chatInputRef, chatPendingImagesRef, conversationMessagesRef, conversationHydrationEpochRef, chatAbortRef, chatSendBusyRef, chatSendNonceRef, greetingFiredRef, greetingInFlightConversationRef, companionStaleConversationRefreshRef, lifecycleAction, beginLifecycleAction, finishLifecycleAction, lifecycleBusyRef, lifecycleActionRef, setAgentStatus, setActionNotice, pendingRestart, pendingRestartReasons, setPendingRestart, setPendingRestartReasons, setBackendDisconnectedBannerDismissed, resetBackendConnection, loadConversations, loadConversationMessages, loadPlugins, elizaCloudEnabled, elizaCloudConnected, pollCloudCredits, elizaCloudPreferDisconnectedUntilLoginRef, setElizaCloudEnabled, setElizaCloudConnected, setElizaCloudVoiceProxyAvailable, setElizaCloudHasPersistedKey, setElizaCloudCredits, setElizaCloudCreditsLow, setElizaCloudCreditsCritical, setElizaCloudAuthRejected, setElizaCloudCreditsError, setElizaCloudTopUpUrl, setElizaCloudUserId, setElizaCloudStatusReason, setElizaCloudLoginError, onboardingCompletionCommittedRef, setOnboardingUiRevealNonce, setOnboardingLoading, setOnboardingComplete, setOnboardingStep, setOnboardingMode, setOnboardingActiveGuide, setOnboardingDeferredTasks, setPostOnboardingChecklistDismissed, setOnboardingName, setOnboardingStyle, setOnboardingServerTarget, setOnboardingProvider, setOnboardingApiKey, setOnboardingVoiceProvider, setOnboardingVoiceApiKey, setOnboardingPrimaryModel, setOnboardingOpenRouterModel, setOnboardingRemoteConnected, setOnboardingRemoteApiBase, setOnboardingRemoteToken, setOnboardingSmallModel, setOnboardingLargeModel, setOnboardingOptions, setSelectedVrmIndex, setCustomVrmUrl, setCustomBackgroundUrl, setPlugins, setSkills, setLogs, coordinatorResetRef, } = deps;
-    // ── Greeting / hydration (defined here; passed into lifecycle) ──────
-    const fetchGreeting = useCallback(async (convId) => {
-        if (greetingInFlightConversationRef.current === convId) {
-            traceGreeting("fetchGreeting:skip_duplicate_in_flight", {
-                convId,
-            });
-            return false;
-        }
-        greetingInFlightConversationRef.current = convId;
-        traceGreeting("fetchGreeting:request", { convId });
-        try {
-            const data = await client.requestGreeting(convId, uiLanguage);
-            if (data.text) {
-                const stillActive = activeConversationIdRef.current === convId;
-                traceGreeting("fetchGreeting:response", {
-                    convId,
-                    stillActive,
-                    textLength: data.text.length,
-                    persisted: data.persisted === true,
-                });
-                if (stillActive) {
-                    setConversationMessages((prev) => {
-                        if (prev.some((message) => message.role === "assistant" &&
-                            message.source === "agent_greeting" &&
-                            message.text === data.text)) {
-                            return prev;
-                        }
-                        return [
-                            ...prev,
-                            {
-                                id: `greeting-${Date.now()}`,
-                                role: "assistant",
-                                text: data.text,
-                                timestamp: Date.now(),
-                                source: "agent_greeting",
-                            },
-                        ];
-                    });
-                    greetingFiredRef.current = true;
-                }
-                return stillActive;
-            }
-            traceGreeting("fetchGreeting:empty_or_whitespace", { convId });
-            greetingFiredRef.current = false;
-        }
-        catch (err) {
-            traceGreeting("fetchGreeting:request_failed", {
-                convId,
-                error: err instanceof Error ? err.message : String(err),
-            });
-            greetingFiredRef.current = false;
-            /* greeting failed silently — user can still chat */
-        }
-        finally {
-            if (greetingInFlightConversationRef.current === convId) {
-                greetingInFlightConversationRef.current = null;
-            }
-        }
-        return false;
-    }, [
-        uiLanguage,
-        activeConversationIdRef,
-        greetingFiredRef,
-        greetingInFlightConversationRef,
-        setConversationMessages,
-    ]);
-    // biome-ignore lint/correctness/useExhaustiveDependencies: greetingFiredRef is intentionally read from the ref at call time
-    const requestGreetingWhenRunning = useCallback(async (convId) => {
-        if (!convId || greetingFiredRef.current) {
-            traceGreeting("requestGreetingWhenRunning:skip", {
-                convId: convId ?? null,
-                greetingFired: greetingFiredRef.current,
-            });
-            return;
-        }
-        try {
-            const status = await client.getStatus();
-            traceGreeting("requestGreetingWhenRunning:status", {
-                convId,
-                state: status.state,
-            });
-            if (status.state === "running" && !greetingFiredRef.current) {
-                await fetchGreeting(convId);
-            }
-        }
-        catch (err) {
-            console.warn("[eliza][chat:init] failed to confirm runtime state for greeting", err);
-        }
-    }, [fetchGreeting]);
-    const hydrateInitialConversationState = useCallback(async () => {
-        const hydrationEpoch = ++conversationHydrationEpochRef.current;
-        const isCurrentHydration = () => conversationHydrationEpochRef.current === hydrationEpoch;
-        try {
-            const { conversations: rawConversations } = await client.listConversations();
-            const conversations = normalizeConversationList(rawConversations);
-            traceGreeting("hydrate:listConversations", {
-                count: conversations.length,
-            });
-            if (!isCurrentHydration()) {
-                return null;
-            }
-            setConversations(conversations);
-            if (conversations.length > 0) {
-                const savedConversationId = loadActiveConversationId();
-                const restoredConversation = conversations.find((conversation) => conversation.id === savedConversationId) ?? conversations[0];
-                if (!isCurrentHydration()) {
-                    return null;
-                }
-                setActiveConversationId(restoredConversation.id);
-                activeConversationIdRef.current = restoredConversation.id;
-                client.sendWsMessage({
-                    type: "active-conversation",
-                    conversationId: restoredConversation.id,
-                });
-                try {
-                    const { messages } = await client.getConversationMessages(restoredConversation.id);
-                    if (!isCurrentHydration()) {
-                        return null;
-                    }
-                    const nextMessages = filterRenderableConversationMessages(messages);
-                    greetingFiredRef.current =
-                        hasConversationBootstrapMessage(nextMessages);
-                    conversationMessagesRef.current = nextMessages;
-                    setConversationMessages(nextMessages);
-                    return nextMessages.length === 0 ? restoredConversation.id : null;
-                }
-                catch (err) {
-                    if (!isCurrentHydration()) {
-                        return null;
-                    }
-                    console.warn("[eliza][chat:init] failed to load restored conversation messages", err);
-                    greetingFiredRef.current = false;
-                    conversationMessagesRef.current = [];
-                    setConversationMessages([]);
-                    return restoredConversation.id;
-                }
-            }
-            if (!isCurrentHydration()) {
-                return null;
-            }
-            traceGreeting("hydrate:no_conversations_on_server");
-            greetingFiredRef.current = false;
-            conversationMessagesRef.current = [];
-            setConversationMessages([]);
-            setActiveConversationId(null);
-            activeConversationIdRef.current = null;
-            setConversations([]);
-            if (!shouldAutoCreateInitialConversation()) {
-                return null;
-            }
-            traceGreeting("hydrate:auto_create_initial_conversation");
-            try {
-                const { conversation: rawConversation, greeting: inlineGreeting } = await client.createConversation(undefined, {
-                    bootstrapGreeting: true,
-                    lang: uiLanguage,
-                });
-                if (!isConversationRecord(rawConversation)) {
-                    throw new Error("Conversation creation returned an invalid payload.");
-                }
-                const conversation = rawConversation;
-                if (!isCurrentHydration()) {
-                    return null;
-                }
-                setConversations([conversation]);
-                setActiveConversationId(conversation.id);
-                activeConversationIdRef.current = conversation.id;
-                client.sendWsMessage({
-                    type: "active-conversation",
-                    conversationId: conversation.id,
-                });
-                const greetingText = inlineGreeting?.text?.trim() || "";
-                if (greetingText) {
-                    const nextMessages = [
-                        {
-                            id: `greeting-${Date.now()}`,
-                            role: "assistant",
-                            text: greetingText,
-                            timestamp: Date.now(),
-                            source: "agent_greeting",
-                        },
-                    ];
-                    greetingFiredRef.current = true;
-                    conversationMessagesRef.current = nextMessages;
-                    setConversationMessages(nextMessages);
-                    return null;
-                }
-                return conversation.id;
-            }
-            catch (err) {
-                if (!isCurrentHydration()) {
-                    return null;
-                }
-                console.warn("[eliza][chat:init] failed to create initial conversation", err);
-                return null;
-            }
-        }
-        catch (err) {
-            console.warn("[eliza][chat:init] failed to hydrate conversations", err);
-            return null;
-        }
-    }, [
-        activeConversationIdRef,
-        conversationHydrationEpochRef,
-        conversationMessagesRef,
-        greetingFiredRef,
-        uiLanguage,
-        setActiveConversationId,
-        setConversationMessages,
-        setConversations,
-    ]);
-    // ── Send sub-hook ───────────────────────────────────────────────────
-    // Stable ref so handleChatStop doesn't get a new reference on every 5-second
-    // ptySessions poll. The ref is updated here (synchronously, before useChatSend
-    // runs) so it always reflects the latest sessions at call-time.
-    const ptySessionsRef = useRef(ptySessions);
-    ptySessionsRef.current = ptySessions;
-    const send = useChatSend({
-        t,
-        uiLanguage,
-        tab,
-        chatMode,
-        conversations,
-        activeConversationId,
-        ptySessionsRef,
-        setChatInput,
-        setChatSending,
-        setChatFirstTokenReceived,
-        setChatLastUsage,
-        setChatPendingImages,
-        setConversations,
-        setActiveConversationId,
-        setCompanionMessageCutoffTs,
-        setConversationMessages,
-        setUnreadConversations,
-        setActionNotice,
-        activeConversationIdRef,
-        chatInputRef,
-        chatPendingImagesRef,
-        conversationMessagesRef,
-        chatAbortRef,
-        chatSendBusyRef,
-        chatSendNonceRef,
-        loadConversations,
-        loadConversationMessages,
-        elizaCloudEnabled,
-        elizaCloudConnected,
-        pollCloudCredits,
-    });
-    // ── Lifecycle sub-hook ──────────────────────────────────────────────
-    const lifecycle = useChatLifecycle({
-        agentStatus,
-        setAgentStatus,
-        lifecycleAction,
-        beginLifecycleAction,
-        finishLifecycleAction,
-        lifecycleBusyRef,
-        lifecycleActionRef,
-        setActionNotice,
-        pendingRestart,
-        pendingRestartReasons,
-        setPendingRestart,
-        setPendingRestartReasons,
-        setBackendDisconnectedBannerDismissed,
-        resetBackendConnection,
-        loadConversations,
-        loadPlugins,
-        hydrateInitialConversationState,
-        requestGreetingWhenRunning,
-        interruptActiveChatPipeline: send.interruptActiveChatPipeline,
-        resetConversationDraftState,
-        setActiveConversationId,
-        setConversationMessages,
-        setConversations,
-        activeConversationIdRef,
-        elizaCloudPreferDisconnectedUntilLoginRef,
-        setElizaCloudEnabled,
-        setElizaCloudConnected,
-        setElizaCloudVoiceProxyAvailable,
-        setElizaCloudHasPersistedKey,
-        setElizaCloudCredits,
-        setElizaCloudCreditsLow,
-        setElizaCloudCreditsCritical,
-        setElizaCloudAuthRejected,
-        setElizaCloudCreditsError,
-        setElizaCloudTopUpUrl,
-        setElizaCloudUserId,
-        setElizaCloudStatusReason,
-        setElizaCloudLoginError,
-        onboardingCompletionCommittedRef,
-        setOnboardingUiRevealNonce,
-        setOnboardingLoading,
-        setOnboardingComplete,
-        setOnboardingStep,
-        setOnboardingMode,
-        setOnboardingActiveGuide,
-        setOnboardingDeferredTasks,
-        setPostOnboardingChecklistDismissed,
-        setOnboardingName,
-        setOnboardingStyle,
-        setOnboardingServerTarget,
-        setOnboardingProvider,
-        setOnboardingApiKey,
-        setOnboardingVoiceProvider,
-        setOnboardingVoiceApiKey,
-        setOnboardingPrimaryModel,
-        setOnboardingOpenRouterModel,
-        setOnboardingRemoteConnected,
-        setOnboardingRemoteApiBase,
-        setOnboardingRemoteToken,
-        setOnboardingSmallModel,
-        setOnboardingLargeModel,
-        setOnboardingOptions,
-        setSelectedVrmIndex,
-        setCustomVrmUrl,
-        setCustomBackgroundUrl,
-        setPlugins,
-        setSkills,
-        setLogs,
-        coordinatorResetRef,
-    });
-    // ── Conversation management ─────────────────────────────────────────
-    const handleNewConversation = useCallback(async (title) => {
-        const previousConversationId = activeConversationIdRef.current;
-        const previousMessages = conversationMessagesRef.current;
-        const previousCutoffTs = companionMessageCutoffTs;
-        const hasUserMessage = previousMessages.some((message) => message.role === "user");
-        const shouldReplacePreviousDraftConversation = !title &&
-            Boolean(previousConversationId) &&
-            !hasUserMessage &&
-            previousMessages.length <= 1;
-        send.interruptActiveChatPipeline();
-        resetConversationDraftState();
-        try {
-            const { conversation: rawConversation, greeting: inlineGreeting } = await client.createConversation(title, {
-                bootstrapGreeting: true,
-                lang: uiLanguage,
-            });
-            if (!isConversationRecord(rawConversation)) {
-                throw new Error("Conversation creation returned an invalid payload.");
-            }
-            const conversation = rawConversation;
-            const nextCutoffTs = Date.now();
-            setConversations((prev) => {
-                const next = shouldReplacePreviousDraftConversation
-                    ? prev.filter((existing) => existing.id !== previousConversationId)
-                    : prev;
-                return [conversation, ...next];
-            });
-            setActiveConversationId(conversation.id);
-            activeConversationIdRef.current = conversation.id;
-            setCompanionMessageCutoffTs(nextCutoffTs);
-            // Try inline greeting first; fall back to dedicated greeting endpoint
-            let greetingText = inlineGreeting?.text?.trim() || "";
-            if (!greetingText) {
-                try {
-                    const resp = await client.requestGreeting(conversation.id, uiLanguage);
-                    greetingText = resp.text?.trim() || "";
-                }
-                catch {
-                    // Greeting generation failed — continue without greeting
-                }
-            }
-            if (greetingText) {
-                greetingFiredRef.current = true;
-                const initMessages = [
-                    {
-                        id: `greeting-${Date.now()}`,
-                        role: "assistant",
-                        text: greetingText,
-                        timestamp: Date.now(),
-                        source: "agent_greeting",
-                    },
-                ];
-                conversationMessagesRef.current = initMessages;
-                setConversationMessages(initMessages);
-            }
-            else {
-                greetingFiredRef.current = false;
-                conversationMessagesRef.current = [];
-                setConversationMessages([]);
-                // Fallback: if inline greeting wasn't returned (e.g. old server),
-                // request one via the dedicated /greeting endpoint.
-                void fetchGreeting(conversation.id);
-            }
-            client.sendWsMessage({
-                type: "active-conversation",
-                conversationId: conversation.id,
-            });
-            if (shouldReplacePreviousDraftConversation &&
-                previousConversationId &&
-                previousConversationId !== conversation.id) {
-                setUnreadConversations((prev) => {
-                    const next = new Set(prev);
-                    next.delete(previousConversationId);
-                    return next;
-                });
-                void client
-                    .deleteConversation(previousConversationId)
-                    .catch(() => { });
-            }
-            void client
-                .cleanupEmptyConversations({ keepId: conversation.id })
-                .then((result) => {
-                if (result.deleted.length === 0)
-                    return;
-                const deletedSet = new Set(result.deleted);
-                setConversations((prev) => prev.filter((existing) => !deletedSet.has(existing.id)));
-                setUnreadConversations((prev) => {
-                    const next = new Set(prev);
-                    for (const id of deletedSet)
-                        next.delete(id);
-                    return next;
-                });
-            })
-                .catch(() => { });
-        }
-        catch {
-            setActiveConversationId(previousConversationId);
-            activeConversationIdRef.current = previousConversationId;
-            setConversationMessages(previousMessages);
-            setCompanionMessageCutoffTs(previousCutoffTs);
-            greetingFiredRef.current =
-                hasConversationBootstrapMessage(previousMessages);
-            if (previousConversationId) {
-                client.sendWsMessage({
-                    type: "active-conversation",
-                    conversationId: previousConversationId,
-                });
-            }
-        }
-    }, [
-        companionMessageCutoffTs,
-        fetchGreeting,
-        resetConversationDraftState,
-        uiLanguage,
-        activeConversationIdRef,
-        conversationMessagesRef,
-        greetingFiredRef,
-        send.interruptActiveChatPipeline,
-        setActiveConversationId,
-        setCompanionMessageCutoffTs,
-        setConversationMessages,
-        setConversations,
-        setUnreadConversations,
-    ]);
-    useEffect(() => {
-        if (uiShellMode !== "companion" || tab !== "companion") {
-            companionStaleConversationRefreshRef.current = null;
-            return;
-        }
-        if (!activeConversationId) {
-            return;
-        }
-        if (!shouldStartFreshCompanionConversation(conversationMessages)) {
-            companionStaleConversationRefreshRef.current = null;
-            return;
-        }
-        if (companionStaleConversationRefreshRef.current === activeConversationId) {
-            return;
-        }
-        companionStaleConversationRefreshRef.current = activeConversationId;
-        void handleNewConversation();
-    }, [
-        activeConversationId,
-        conversationMessages,
-        handleNewConversation,
-        tab,
-        uiShellMode,
-        companionStaleConversationRefreshRef,
-    ]);
-    const handleSelectConversation = useCallback(async (id) => {
-        conversationHydrationEpochRef.current += 1;
-        if (id === activeConversationId &&
-            conversationMessagesRef.current.length > 0)
-            return;
-        send.interruptActiveChatPipeline();
-        // Clean up empty conversations: if the previous conversation has only
-        // system/greeting messages and no user messages, delete it silently.
-        const prevId = activeConversationId;
-        if (prevId && prevId !== id) {
-            const prevMessages = conversationMessagesRef.current;
-            const hasUserMessage = prevMessages.some((m) => m.role === "user");
-            if (!hasUserMessage && prevMessages.length <= 1) {
-                void client.deleteConversation(prevId).catch(() => { });
-                setConversations((prev) => prev.filter((c) => c.id !== prevId));
-                setUnreadConversations((prev) => {
-                    const next = new Set(prev);
-                    next.delete(prevId);
-                    return next;
-                });
-            }
-        }
-        const previousActive = activeConversationId;
-        setActiveConversationId(id);
-        activeConversationIdRef.current = id;
-        client.sendWsMessage({ type: "active-conversation", conversationId: id });
-        setUnreadConversations((prev) => {
-            const next = new Set(prev);
-            next.delete(id);
-            return next;
-        });
-        const loaded = await loadConversationMessages(id);
-        if (loaded.ok === true)
-            return;
-        const loadedMessage = loaded.message;
-        if (loaded.ok === false && loaded.status === 404) {
-            const refreshed = await loadConversations();
-            const fallbackId = refreshed?.[0]?.id ?? null;
-            if (fallbackId) {
-                setActiveConversationId(fallbackId);
-                activeConversationIdRef.current = fallbackId;
-                client.sendWsMessage({
-                    type: "active-conversation",
-                    conversationId: fallbackId,
-                });
-                const fallbackLoaded = await loadConversationMessages(fallbackId);
-                if (fallbackLoaded.ok === false) {
-                    setActionNotice(`Failed to load fallback conversation: ${fallbackLoaded.message}`, "error", 4200);
-                }
-            }
-            else {
-                setActiveConversationId(null);
-                activeConversationIdRef.current = null;
-                setConversationMessages([]);
-            }
-            setActionNotice("Conversation was not found. Refreshed the conversation list.", "info", 3200);
-            return;
-        }
-        setActiveConversationId(previousActive);
-        activeConversationIdRef.current = previousActive;
-        if (previousActive) {
-            client.sendWsMessage({
-                type: "active-conversation",
-                conversationId: previousActive,
-            });
-            const restored = await loadConversationMessages(previousActive);
-            if (restored.ok === false) {
-                setActionNotice(`Failed to restore previous conversation: ${restored.message}`, "error", 4200);
-            }
-        }
-        else {
-            setConversationMessages([]);
-        }
-        setActionNotice(`Failed to load conversation: ${loadedMessage}`, "error", 4200);
-    }, [
-        activeConversationId,
-        loadConversationMessages,
-        loadConversations,
-        setActionNotice,
-        activeConversationIdRef,
-        conversationHydrationEpochRef,
-        conversationMessagesRef.current,
-        send.interruptActiveChatPipeline,
-        setActiveConversationId,
-        setConversationMessages,
-        setConversations,
-        setUnreadConversations,
-    ]);
-    const handleDeleteConversation = useCallback(async (id) => {
-        const deletingActive = activeConversationId === id;
-        if (deletingActive) {
-            send.interruptActiveChatPipeline();
-        }
-        try {
-            await client.deleteConversation(id);
-            setConversations((prev) => prev.filter((conversation) => conversation.id !== id));
-            setUnreadConversations((prev) => {
-                const next = new Set(prev);
-                next.delete(id);
-                return next;
-            });
-            if (deletingActive) {
-                setActiveConversationId(null);
-                activeConversationIdRef.current = null;
-                setConversationMessages([]);
-            }
-            const refreshed = await loadConversations();
-            if (deletingActive) {
-                const fallbackId = refreshed?.[0]?.id ?? null;
-                if (fallbackId) {
-                    setActiveConversationId(fallbackId);
-                    activeConversationIdRef.current = fallbackId;
-                    client.sendWsMessage({
-                        type: "active-conversation",
-                        conversationId: fallbackId,
-                    });
-                    const fallbackLoaded = await loadConversationMessages(fallbackId);
-                    if (fallbackLoaded.ok === false) {
-                        setActionNotice(`Failed to load fallback conversation: ${fallbackLoaded.message}`, "error", 4200);
-                    }
-                }
-            }
-        }
-        catch (err) {
-            const status = err.status;
-            if (status === 404) {
-                setConversations((prev) => prev.filter((conversation) => conversation.id !== id));
-                setUnreadConversations((prev) => {
-                    const next = new Set(prev);
-                    next.delete(id);
-                    return next;
-                });
-                if (deletingActive) {
-                    setActiveConversationId(null);
-                    activeConversationIdRef.current = null;
-                    setConversationMessages([]);
-                }
-                await loadConversations();
-                setActionNotice("Conversation was already deleted. Refreshed the conversation list.", "info", 3200);
-                return;
-            }
-            setActionNotice(`Failed to delete conversation: ${err instanceof Error ? err.message : "network error"}`, "error", 4200);
-        }
-    }, [
-        activeConversationId,
-        send.interruptActiveChatPipeline,
-        loadConversationMessages,
-        loadConversations,
-        setActionNotice,
-        activeConversationIdRef,
-        setActiveConversationId,
-        setConversationMessages,
-        setConversations,
-        setUnreadConversations,
-    ]);
-    const handleRenameConversation = useCallback(async (id, title) => {
-        const trimmed = title.trim();
-        if (!trimmed) {
-            setActionNotice("Conversation title cannot be empty.", "error", 2800);
-            return;
-        }
-        try {
-            const { conversation } = await client.renameConversation(id, trimmed);
-            setConversations((prev) => prev.map((existing) => existing.id === id ? conversation : existing));
-        }
-        catch (err) {
-            const status = err.status;
-            if (status === 404) {
-                await loadConversations();
-                setActionNotice("Conversation was not found. Refreshed the conversation list.", "info", 3200);
-                return;
-            }
-            setActionNotice(`Failed to rename conversation: ${err instanceof Error ? err.message : "network error"}`, "error", 4200);
-        }
-    }, [loadConversations, setActionNotice, setConversations]);
-    const suggestConversationTitle = useCallback(async (id) => {
-        try {
-            const { conversation } = await client.renameConversation(id, "", {
-                generate: true,
-            });
-            setConversations((prev) => prev.map((existing) => existing.id === id ? conversation : existing));
-            const next = conversation.title?.trim();
-            return next && next.length > 0 ? next : null;
-        }
-        catch (err) {
-            const status = err.status;
-            if (status === 404) {
-                await loadConversations();
-                setActionNotice("Conversation was not found. Refreshed the conversation list.", "info", 3200);
-                return null;
-            }
-            setActionNotice(`Failed to suggest conversation title: ${err instanceof Error ? err.message : "network error"}`, "error", 4200);
-            return null;
-        }
-    }, [loadConversations, setActionNotice, setConversations]);
-    return {
-        // Greeting / hydration
-        fetchGreeting,
-        requestGreetingWhenRunning,
-        hydrateInitialConversationState,
-        // Conversation management
-        handleNewConversation,
-        handleSelectConversation,
-        handleDeleteConversation,
-        handleRenameConversation,
-        suggestConversationTitle,
-        // Lifecycle (from useChatLifecycle)
-        ...lifecycle,
-        // Send (from useChatSend)
-        ...send,
-    };
-}