"use client"; /** * THE SESSION HOOK (Wave D, owner-approved 2026-09-26): the React adapter * over the pure SessionModel (components/session-core.ts — the state * machine, testable without a renderer). All mechanics live in the model; * this hook re-renders on change and derives the view (core/view.ts * projectView — the golden-master grouping, client-side). * * Every turn is a server-side background process (owner ruling * 2026-09-25); the hook is a view. Sends are ONE explicit input event * each ({chatId, input}); the turn stream is the VERBATIM AgentEvent * passthrough. Status vocabulary (pre-Wave-D parity): ready | submitted * | streaming | error. */ import { useCallback, useEffect, useMemo, useReducer, useRef } from "react"; import type { ChatInput, LhMessage, QuestionAnswerData } from "@/src/core"; import { SessionModel, type SessionState } from "@/components/session-core"; export interface UseChatSessionOptions { chatId: string; /** The native record seed (server-rendered page or a full sync). */ initialMessages: LhMessage[]; /** Reattach on mount: a turn is running server-side with no live view. */ initiallyInFlight?: boolean; } export function useChatSession({ chatId, initialMessages, initiallyInFlight }: UseChatSessionOptions) { // The model is per-mount (chatId-keyed component); onChange forces the // re-render. The ref pattern keeps it stable across renders. const modelRef = useRef(null); if (modelRef.current === null) { modelRef.current = new SessionModel({ chatId, initialMessages }); } const model = modelRef.current; // The render VERSION — bumped by every model change, so the state memo // below recomputes exactly when the model actually changed. (Using the // reducer's dispatch as the memo dep was a freeze bug: dispatch is // STABLE by contract, so the memo computed once per mount and the view // never saw a single model update — no optimistic bubble, no stream, no // error banner. The empty-session bug, 2026-09-26.) const [version, bump] = useReducer((n: number) => n + 1, 0); useEffect(() => { model.onChange = bump; return () => { model.onChange = undefined; }; }, [model, bump]); // Reattach on mount (StrictMode-safe: a newer resume cancels the older). // ATTACH-FIRST (owner, reattach round 2026-10-02): the page render just // read the record — the blocking record refetch only added handshake // latency before the instant replay, so a fresh mount attaches // directly. This hook's effect is the SINGLE mount-reattach owner // (chat.tsx's duplicate was deleted with the same round). useEffect(() => { if (initiallyInFlight) void model.resumeStream(false); }, [initiallyInFlight, model]); // The view + state, derived per model change from the model. const state = useMemo(() => model.getState(), [model, version] as const); // THE TURN-STATE BROADCAST (owner, sidebar round 2026-10-02): the same // optimistic machine, propagated — the instant a turn starts locally // (submitted: send, answer, session start, reattach, wake attach) the // sidebar learns it without waiting for its 2.5s poll; at settle the // event clears the row and triggers one immediate refetch. The model // stays pure; this adapter owns the window seam (the lh:chat-renamed // pattern). const prevStatusRef = useRef(state.status); useEffect(() => { const was = prevStatusRef.current; prevStatusRef.current = state.status; if (was === state.status) return; const running = state.status === "submitted" || state.status === "streaming"; const wasRunning = was === "submitted" || was === "streaming"; if (running === wasRunning) return; // submitted→streaming: still running; error↔ready: not window.dispatchEvent(new CustomEvent("lh:turn-state", { detail: { id: chatId, running } })); }, [state.status, chatId]); // The reattach settled terminal → the sync-and-continue seam (chat.tsx). const setReattachSettled = useCallback( (fn: () => void) => { model.setReattachSettled(fn); }, [model], ); const send = useCallback((input: ChatInput) => void model.send(input), [model]); const submitAnswer = useCallback( (tool: string, toolCallId: string, output: QuestionAnswerData) => void model.submitAnswer(tool, toolCallId, output), [model], ); const setMessages = useCallback((record: LhMessage[]) => model.setMessages(record), [model]); const adoptRecord = useCallback((record: LhMessage[]) => model.adoptRecord(record), [model]); const stop = useCallback(() => model.stop(), [model]); const clearError = useCallback(() => model.clearError(), [model]); const resumeStream = useCallback(() => void model.resumeStream(), [model]); return { messages: state.messages, nativeMessages: state.nativeMessages, status: state.status, error: state.error, send, submitAnswer, setMessages, adoptRecord, stop, clearError, resumeStream, setReattachSettled, }; }