import { expect, onTestFinished } from "vitest"; import { z } from "zod"; import { webObservationSessionSchema } from "../../src/domain/browserSession.js"; import { toolContract } from "../../src/contracts/toolContracts.js"; import { connectLocalToolsMcp } from "../fixtures/localToolsMcp.js"; import { startFakeCdpBrowser } from "../fixtures/fakeCdpBrowser.js"; import { cliTest } from "../support/cli/cliFixture.js"; const startLifecycleBrowser = () => startFakeCdpBrowser({ eventsBeforeReply: [ "Performance.getMetrics", "Page.setLifecycleEventsEnabled", ], commandResult: ({ method }) => { if (method === "Performance.enable") return {}; if (method === "Performance.getMetrics") return { metrics: [{ name: "Timestamp", value: 20 }] }; return undefined; }, commandEvents: ({ method, sessionId }, origin) => { const milestone = (loaderId: string, timestamp: number | string) => ({ method: "Page.lifecycleEvent", sessionId, params: { frameId: "frame-main", loaderId, name: "load", timestamp }, }); if (method === "Performance.getMetrics") return [ milestone("loader-before-window", 19), { method: "Page.navigatedWithinDocument", sessionId, params: { frameId: "frame-main", url: `${origin}#during-clock-response`, navigationType: "historyApi", }, }, ]; if (method === "Page.setLifecycleEventsEnabled") return [ milestone("loader-before-window-replayed-after-arm", 19), milestone("loader-current-window", 21), milestone("loader-malformed-clock", "21"), { method: "Page.frameNavigated", sessionId, params: { type: "BackForwardCacheRestore", frame: { id: "frame-main", loaderId: "restored-loader", url: `${origin}/app`, urlFragment: "#restored", }, }, }, ]; return undefined; }, }); cliTest.for(["CLI", "stdio MCP"] as const)( "retains in-window navigation and lifecycle evidence through %s", async (surface, { cli }) => { const browser = await startLifecycleBrowser(); onTestFinished(() => browser.close()); let evidence: unknown; if (surface === "CLI") { const response = await cli.run({ arguments: [ "observe-web-session", browser.endpoint, "allowed-page", "--allowed-origins", browser.allowedOrigin, "--observation-ms", "5", "--json", ], }); expect(response.exitCode, response.stderr).toBe(0); evidence = response.json; } else { const { call } = await connectLocalToolsMcp(); const response = await call("observe_web_session", { cdp_endpoint: browser.endpoint, allowed_origins: [browser.allowedOrigin], target_id: "allowed-page", observation_ms: 5, }); expect(response.isError, JSON.stringify(response)).not.toBe(true); evidence = response.structuredContent; } const contract = toolContract("observe_web_session"); const sourceEvidence = contract.outputSchema.parse(evidence); const normalized = z .object({ normalized_result: webObservationSessionSchema }) .parse(sourceEvidence).normalized_result; expect( normalized.timeline.filter(({ type }) => type === "lifecycle"), ).toEqual([ expect.objectContaining({ loader_id: "loader-current-window", timestamp: 21, }), ]); expect(normalized.timeline).toContainEqual( expect.objectContaining({ type: "same_document_navigation", url: `${browser.allowedOrigin}#during-clock-response`, timestamp: null, }), ); expect(normalized.completeness.excluded).toContainEqual({ section: "timeline", reason: "invalid_protocol_value", count: 1, }); expect(normalized.timeline).toContainEqual( expect.objectContaining({ type: "navigation_committed", frame_id: "frame-main", loader_id: "restored-loader", url: `${browser.allowedOrigin}/app#restored`, detail: "backforwardcacherestore", }), ); expect(normalized.limitations).toContainEqual( expect.stringMatching( /Buffered events.*unknown timing.*context only.*do not establish.*observation window/iu, ), ); expect(browser.commands).toContainEqual( expect.objectContaining({ method: "Performance.enable", params: { timeDomain: "timeTicks" }, }), ); }, );