import { rm } from "node:fs/promises"; import path from "node:path"; import { test as base, expect, type Route } from "@playwright/test"; import type { ModelCatalogEntry, ModelCatalogResponse } from "../src/core/contracts/models"; import type { UserSettings } from "../src/core/settings"; import type { ChatGPTStatus } from "../src/core/contracts/chatgpt"; import type { NativeSubscriptionStatus } from "../src/core/contracts/subscriptions"; import type { ProviderKeyInfo } from "../components/settings/keys-section"; /** Setup/teardown owns only the UUID run directory beneath this worktree. */ export default function setup() { const root = process.env.LH_E2E_RUN_DIR; if (!root || path.dirname(root) !== path.resolve(".playwright-data") || !/^run-[a-f0-9-]{36}$/.test(path.basename(root))) { throw new Error("Unsafe/missing Playwright data directory; refusing to run or clean up."); } return async () => { await rm(root, { recursive: true, force: true }); }; } export const syntheticModel: ModelCatalogEntry = { id: "synthetic-smoke-model", name: "Synthetic smoke model", provider: "openai", reasoning: false, input: ["text", "image"], contextWindow: 8192, maxTokens: 1024, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, supportedLevels: ["off"], }; const provider: ProviderKeyInfo = { id: "openai", envVar: "OPENAI_API_KEY", label: "OpenAI", }; export interface HarnessState { keyPresent: boolean; settings: UserSettings | null; writes: { path: string; body: unknown }[]; blocked: string[]; generation: string[]; catalogFailure: boolean; } const json = (route: Route, body: unknown, status = 200) => route.fulfill({ status, json: body }); export const test = base.extend<{ harness: HarnessState }>({ harness: async ({ context }, use) => { const state: HarnessState = { keyPresent: false, settings: null, writes: [], blocked: [], generation: [], catalogFailure: false, }; await context.routeWebSocket("**/*", (socket) => { const url = new URL(socket.url()); if (url.origin === "ws://127.0.0.1:3005" && url.pathname.startsWith("/_next/")) { socket.connectToServer(); // Next dev HMR only; no provider sockets. return; } state.blocked.push(`WS ${url.origin}${url.pathname}`); socket.close({ code: 1008, reason: "Offline test boundary" }); }); // Installed on the CONTEXT before a page navigates, including popups. // Never let a missed provider fixture fall through to a live endpoint. await context.route("**/*", async (route) => { const request = route.request(); const url = new URL(request.url()); const method = request.method(); const p = url.pathname; const block = async () => { state.blocked.push(`${method} ${url.origin}${p}`); // no query strings/payloads in diagnostics await route.abort("blockedbyclient"); }; if (url.origin !== "http://127.0.0.1:3005") return block(); if (!p.startsWith("/api/")) { if (method === "GET" || method === "HEAD") return route.continue(); return block(); } if (/\/(turn|generate|transcribe)(\/|$)/.test(p) || (p.startsWith("/api/chats") && method !== "GET")) { state.generation.push(`${method} ${p}`); return block(); } if (p === "/api/keys" && method === "GET") return json(route, { keys: state.keyPresent ? [{ id: provider.envVar, info: null, present: true, source: "file", masked: "synthetic…only (41 chars)", shadowedByEnv: false }] : [], providers: [provider], }); if (p === "/api/keys/OPENAI_API_KEY" && method === "PUT") { const body: unknown = request.postDataJSON(); state.writes.push({ path: p, body }); if (JSON.stringify(body) !== JSON.stringify({ value: "synthetic-smoke-key-not-a-credential" })) return json(route, { error: "Only the synthetic fixture key is accepted" }, 400); state.keyPresent = true; return json(route, { status: { id: provider.envVar, info: null, present: true, source: "file", masked: "synthetic…only (41 chars)", shadowedByEnv: false } }); } if (p === "/api/models" && method === "GET") { if (state.catalogFailure) return json(route, { error: "Synthetic catalog unavailable" }, 503); const slots = { strong: state.settings?.models?.strong?.model ? { ...state.settings.models.strong, model: state.settings.models.strong.model } : null, cheap: state.settings?.models?.cheap?.model ? { ...state.settings.models.cheap, model: state.settings.models.cheap.model } : null, vision: state.settings?.models?.vision?.model ? { ...state.settings.models.vision, model: state.settings.models.vision.model } : null, }; const catalog: ModelCatalogResponse = { models: state.keyPresent ? [syntheticModel] : [], defaults: slots.strong, slots, rolePins: { researcher: slots.cheap, demoBuilder: slots.cheap, visualMaker: slots.vision, extractor: slots.cheap, auditor: slots.cheap }, providers: [{ id: "openai", envVar: provider.envVar, keyPresent: state.keyPresent }], }; return json(route, catalog); } if (p === "/api/settings" && method === "GET") return json(route, { settings: state.settings }); if (p === "/api/settings/models" && method === "PUT") { const body = request.postDataJSON() as NonNullable; state.writes.push({ path: p, body }); state.settings = { ...state.settings, version: 1, models: body }; return json(route, { settings: state.settings }); } if (p === "/api/subscriptions" && method === "GET") { const chatgpt: ChatGPTStatus = { available: false, pending: false, allowBackgroundUse: false, activeId: null, accounts: [], error: null }; const native: NativeSubscriptionStatus[] = ["github-copilot", "xai"].map((providerId) => ({ providerId: providerId as NativeSubscriptionStatus["providerId"], available: false, connected: false, pending: false, allowBackgroundUse: false, connectionId: null, epoch: 0, authorityRevision: 0, revision: 0, })); return json(route, { chatgpt, native }); } if (p === "/api/custom-provider" && method === "GET") return json(route, { baseUrl: "", authMode: "keyless", models: [], overrides: {}, manualModels: [], keyPresent: false, keySource: "none", keyReuseRequired: false, }); if (p === "/api/stt/token" && method === "GET") return json(route, { message: "No DEEPGRAM_API_KEY — synthetic offline fixture." }, 503); // Real, read-only application contracts against empty fixture-owned data. if (method === "GET" && ["/api/activity", "/api/chats", "/api/events", "/api/graph", "/api/graph/status", "/api/graph/costs", "/api/graph/render-settings"].includes(p)) return route.continue(); return block(); }); await use(state); expect(state.blocked, "Unexpected network request (blocked before dispatch)").toEqual([]); expect(state.generation, "Setup/settings must not generate or send").toEqual([]); }, page: async ({ page, harness }, use) => { void harness; // force interception before the test receives its page await use(page); }, }); export { expect };