"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). useEffect(() => { if (initiallyInFlight) void model.resumeStream(); }, [initiallyInFlight, model]); // The view + state, derived per model change from the model. const state = useMemo(() => model.getState(), [model, version] as const); // 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, }; }