import { act, cleanup, render, screen, waitFor } from "@testing-library/react"; import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; import type { RawSessionEvent } from "@/lib/ws/client"; import type { PluginSessionMessagesState } from "./types"; import { PluginConversationScopeProvider, pluginConversationApi } from "./conversation-host"; const transport = vi.hoisted(() => ({ request: vi.fn(), listener: null as ((event: RawSessionEvent) => void) | null, })); vi.mock("@/lib/config", () => ({ getBackendConfig: () => ({ apiBaseUrl: "http://host" }) })); vi.mock("@/lib/ws/connection", () => ({ getWebSocketClient: () => ({ request: transport.request, onRawSessionEvent(listener: (event: RawSessionEvent) => void) { transport.listener = listener; return () => { if (transport.listener === listener) transport.listener = null; }; }, onConnectionStatus(_listener: (status: "connected" | "disconnected") => void) { return () => undefined; }, }), })); const BINDING_PATH_SUFFIX = "/conversation/binding"; const FAR_FUTURE = "2099-01-01T00:00:00Z"; const SNAPSHOT_CREATED_AT = "2026-09-07T12:00:00Z"; function ScopedHarness({ sessionId, testId }: { sessionId: string; testId: string }) { const state = pluginConversationApi.useSessionMessages({ sessionId }); return {String(state.hydrated)}; } let userQueryState: PluginSessionMessagesState | null = null; let agentQueryState: PluginSessionMessagesState | null = null; let ascendingState: PluginSessionMessagesState | null = null; function AscendingHarness() { ascendingState = pluginConversationApi.useSessionMessages({ sessionId: "session-1", authorTypes: ["agent"], sort: "asc", pageSize: 1, }); return ( {ascendingState.messages.map((item) => item.content).join("|")} ); } function TwoQueryHarness() { userQueryState = pluginConversationApi.useSessionMessages({ sessionId: "session-1", authorTypes: ["user"], sort: "desc", pageSize: 1, }); agentQueryState = pluginConversationApi.useSessionMessages({ sessionId: "session-1", authorTypes: ["agent"], sort: "asc", pageSize: 2, }); return ( <> {userQueryState.messages.map((message) => message.content).join("|")} {agentQueryState.messages.map((message) => message.content).join("|")} ); } function deferred() { let resolve!: (value: T) => void; const promise = new Promise((resolvePromise) => { resolve = resolvePromise; }); return { promise, resolve }; } function message(id: string, content: string, createdAt: string, authorType: "user" | "agent") { return { id, taskId: "task-1", sessionId: "session-1", authorType, type: "message", content, createdAt, updatedAt: createdAt, }; } function liveAgentEvent(sequence: number): RawSessionEvent { return { type: "session.event", protocol_version: 1, event_type: "message.added", session_id: "session-1", task_id: "task-1", sequence, event_id: `event-${sequence}`, payload: { type: "message.added", session_id: "session-1", task_id: "task-1", message_id: "message-live", author_type: "agent", content: "live", message_type: "message", created_at: "2026-09-07T12:02:00Z", }, }; } function liveMessageDeletedEvent(sequence: number, messageId: string): RawSessionEvent { return { type: "session.event", protocol_version: 1, event_type: "message.deleted", session_id: "session-1", task_id: "task-1", sequence, event_id: `event-${sequence}`, payload: { type: "message.deleted", session_id: "session-1", task_id: "task-1", message_id: messageId, }, }; } function response(body: unknown): Response { return new Response(JSON.stringify(body), { status: 200, headers: { "Content-Type": "application/json" }, }); } function renderScope(taskId: string, sessionId: string, testId: string) { return ( ); } function resetHarness() { transport.request.mockReset(); transport.listener = null; userQueryState = null; agentQueryState = null; ascendingState = null; transport.request.mockResolvedValue({ success: true, snapshot_token: "snapshot-1", resume_token: "resume-1", consumer_id: "consumer-1", event_watermark: 0, expires_at: FAR_FUTURE, result: "fresh", }); vi.stubGlobal( "fetch", vi.fn((input: RequestInfo | URL) => { if (String(input).endsWith(BINDING_PATH_SUFFIX)) { return Promise.resolve( response({ bindingToken: "binding-1", generation: 7, expiresAt: FAR_FUTURE, }), ); } return Promise.resolve(response({ messages: [], hasMore: false, cursor: null })); }), ); } function registerIsolationLifecycle() { beforeEach(resetHarness); afterEach(() => { cleanup(); vi.unstubAllGlobals(); }); } describe("plugin conversation panel isolation", () => { registerIsolationLifecycle(); it("gives concurrent panels independent consumer identities and snapshots", async () => { render( <> {renderScope("task-1", "session-1", "panel-one")} {renderScope("task-2", "session-2", "panel-two")} , ); await waitFor(() => expect(screen.getByTestId("panel-one").textContent).toBe("true")); await waitFor(() => expect(screen.getByTestId("panel-two").textContent).toBe("true")); const subscriptions = transport.request.mock.calls.filter( ([action]) => action === "session.subscribe", ); expect(subscriptions).toHaveLength(2); expect(subscriptions[0][1].consumer_id).not.toBe(subscriptions[1][1].consumer_id); const fetchMock = vi.mocked(fetch); expect(fetchMock.mock.calls.some(([input]) => String(input).includes("session-1"))).toBe(true); expect(fetchMock.mock.calls.some(([input]) => String(input).includes("session-2"))).toBe(true); }); }); describe("message query snapshot isolation", () => { registerIsolationLifecycle(); it("buffers live events until every distinct message query commits its snapshot", async () => { const userPage = deferred(); const agentPage = deferred(); vi.stubGlobal( "fetch", vi.fn((input: RequestInfo | URL) => { const url = String(input); if (url.endsWith(BINDING_PATH_SUFFIX)) { return Promise.resolve( response({ bindingToken: "binding-1", generation: 7, expiresAt: FAR_FUTURE, }), ); } return url.includes("author_type=user") ? userPage.promise : agentPage.promise; }), ); render( , ); await waitFor(() => expect(vi.mocked(fetch)).toHaveBeenCalledTimes(3)); await act(async () => { userPage.resolve( response({ messages: [message("message-user", "user snapshot", SNAPSHOT_CREATED_AT, "user")], hasMore: false, cursor: null, }), ); await userPage.promise; }); act(() => transport.listener?.(liveAgentEvent(1))); expect(screen.getByTestId("agent-query").textContent).toBe(""); expect(transport.request.mock.calls.filter(([action]) => action === "session.ack")).toEqual([]); await act(async () => { agentPage.resolve( response({ messages: [message("message-agent", "agent snapshot", "2026-09-07T12:01:00Z", "agent")], hasMore: false, cursor: null, }), ); await agentPage.promise; }); expect(screen.getByTestId("agent-query").textContent).toBe("agent snapshot|live"); await waitFor(() => expect(transport.request.mock.calls.some(([action]) => action === "session.ack")).toBe(true), ); }); }); // eslint-disable-next-line max-lines-per-function -- This describe block keeps concurrent query recovery fixtures together. describe("message continuation isolation", () => { registerIsolationLifecycle(); // eslint-disable-next-line max-lines-per-function -- This scenario covers concurrent queries across the complete expiry rebind. it("renews concurrent continuations independently for distinct message queries", async () => { transport.request.mockImplementation((action: string) => Promise.resolve( action === "session.subscribe" ? { success: true, snapshot_token: "snapshot-expiring", resume_token: "resume-1", consumer_id: "consumer-1", event_watermark: 0, expires_at: new Date(Date.now() + 30_000).toISOString(), result: "fresh", } : { success: true }, ), ); const renewalCursors: string[] = []; const requestedPageCursors: string[] = []; vi.stubGlobal( "fetch", vi.fn((input: RequestInfo | URL, init?: RequestInit) => { const url = String(input); if (url.endsWith(BINDING_PATH_SUFFIX)) { return Promise.resolve( response({ bindingToken: "binding-1", generation: 7, expiresAt: FAR_FUTURE, }), ); } if (url.endsWith("/conversation/continuation/renew")) { const body = JSON.parse(String(init?.body)) as { cursor: string }; renewalCursors.push(body.cursor); return Promise.resolve( response({ cursor: `renewed-${body.cursor}`, snapshot_token: `snapshot-${body.cursor}`, expires_at: FAR_FUTURE, }), ); } const parsed = new URL(url); const author = parsed.searchParams.get("author_type"); const cursor = parsed.searchParams.get("cursor"); if (cursor) requestedPageCursors.push(cursor); return Promise.resolve( response({ messages: cursor ? [] : [ message( `message-${author}`, `${author} snapshot`, SNAPSHOT_CREATED_AT, author === "agent" ? "agent" : "user", ), ], hasMore: !cursor, cursor: cursor ? null : `cursor-${author}`, }), ); }), ); render( , ); await waitFor(() => { expect(userQueryState?.hasMore).toBe(true); expect(agentQueryState?.hasMore).toBe(true); }); await act(async () => { await Promise.all([userQueryState!.loadMore(), agentQueryState!.loadMore()]); }); expect(renewalCursors.sort()).toEqual(["cursor-agent", "cursor-user"]); expect(requestedPageCursors.sort()).toEqual(["renewed-cursor-agent", "renewed-cursor-user"]); }); it("joins expiry recovery while preserving each query's continuation", async () => { let subscribeCount = 0; transport.request.mockImplementation((action: string) => { if (action === "session.subscribe") { subscribeCount += 1; return Promise.resolve({ success: true, snapshot_token: `snapshot-${subscribeCount}`, resume_token: `resume-${subscribeCount}`, consumer_id: `consumer-${subscribeCount}`, event_watermark: 0, expires_at: subscribeCount === 1 ? "2020-01-01T00:00:00Z" : FAR_FUTURE, result: "fresh", }); } return Promise.resolve({ success: true }); }); const pageCount = new Map(); const continuationCursors: string[] = []; const fetchMock = vi.fn((input: RequestInfo | URL) => { const url = String(input); if (url.endsWith(BINDING_PATH_SUFFIX)) { return Promise.resolve( response({ bindingToken: "binding-1", generation: 7, expiresAt: FAR_FUTURE }), ); } const parsed = new URL(url); const author = parsed.searchParams.get("author_type") ?? "none"; const cursor = parsed.searchParams.get("cursor"); if (cursor) continuationCursors.push(cursor); const count = (pageCount.get(author) ?? 0) + 1; pageCount.set(author, count); if (cursor) { return Promise.resolve( response({ messages: [ message( `older-${author}`, `${author} older`, SNAPSHOT_CREATED_AT, author === "agent" ? "agent" : "user", ), ], hasMore: false, cursor: null, }), ); } return Promise.resolve( response({ messages: [ message( `current-${author}`, `${author} current ${count}`, SNAPSHOT_CREATED_AT, author === "agent" ? "agent" : "user", ), ], hasMore: true, cursor: `${author}-cursor-${count === 1 ? "expired" : "fresh"}`, }), ); }); vi.stubGlobal("fetch", fetchMock); render( , ); await waitFor(() => { expect(userQueryState?.hasMore).toBe(true); expect(agentQueryState?.hasMore).toBe(true); }); await act(async () => { await Promise.all([userQueryState!.loadMore(), agentQueryState!.loadMore()]); }); expect(subscribeCount).toBe(2); expect(continuationCursors.sort()).toEqual(["agent-cursor-fresh", "user-cursor-fresh"]); expect(screen.getByTestId("user-query").textContent).toContain("user older"); expect(screen.getByTestId("agent-query").textContent).toContain("agent older"); expect( fetchMock.mock.calls.some(([input]) => String(input).includes("continuation/renew")), ).toBe(false); }); }); describe("ascending message pagination", () => { registerIsolationLifecycle(); it("deduplicates and re-sorts an ascending list after live delivery then loadMore", async () => { let messagePage = 0; vi.stubGlobal( "fetch", vi.fn((input: RequestInfo | URL) => { const url = String(input); if (url.endsWith(BINDING_PATH_SUFFIX)) { return Promise.resolve( response({ bindingToken: "binding-1", generation: 7, expiresAt: FAR_FUTURE, }), ); } messagePage += 1; return Promise.resolve( response( messagePage === 1 ? { messages: [message("message-base", "base", SNAPSHOT_CREATED_AT, "agent")], hasMore: true, cursor: "cursor-1", } : { messages: [ message("message-live", "stale page", "2026-09-07T12:02:00Z", "agent"), message("message-middle", "middle", "2026-09-07T12:01:00Z", "agent"), ], hasMore: false, cursor: null, }, ), ); }), ); render( , ); await waitFor(() => expect(ascendingState?.hasMore).toBe(true)); act(() => transport.listener?.(liveAgentEvent(1))); expect(screen.getByTestId("ascending-query").textContent).toBe("base|live"); await act(async () => { await ascendingState!.loadMore(); }); expect(screen.getByTestId("ascending-query").textContent).toBe("base|middle|live"); }); }); describe("message continuation deletion isolation", () => { registerIsolationLifecycle(); it("replays deletions received during continuation before committing the page", async () => { const continuationPage = deferred(); let messagePage = 0; vi.stubGlobal( "fetch", vi.fn((input: RequestInfo | URL) => { const url = String(input); if (url.endsWith(BINDING_PATH_SUFFIX)) { return Promise.resolve( response({ bindingToken: "binding-1", generation: 7, expiresAt: FAR_FUTURE, }), ); } messagePage += 1; if (messagePage === 1) { return Promise.resolve( response({ messages: [message("message-base", "base", SNAPSHOT_CREATED_AT, "agent")], hasMore: true, cursor: "cursor-1", }), ); } return continuationPage.promise; }), ); render( , ); await waitFor(() => expect(ascendingState?.hasMore).toBe(true)); let loadMore!: Promise; await act(async () => { loadMore = ascendingState!.loadMore(); await waitFor(() => expect(messagePage).toBe(2)); }); act(() => transport.listener?.(liveMessageDeletedEvent(1, "message-page"))); continuationPage.resolve( response({ messages: [message("message-page", "deleted page row", "2026-09-07T12:01:00Z", "agent")], hasMore: false, cursor: null, }), ); await act(async () => { await loadMore; }); expect(screen.getByTestId("ascending-query").textContent).toBe("base"); }); });