fix: headed

Author: skoshx

packages/browser/src/mcp-server.ts

@@ -5,7 +5,7 @@ import { z } from "zod/v4";
 import { Config, Effect, Layer, Option, Schema, ServiceMap } from "effect";
 import { BrowserJson } from "@expect/cookies";
 import type { ConsoleLog, NetworkRequest } from "@expect/shared/models";
-import { EXPECT_BROWSER_PROFILE_ENV_NAME } from "./mcp/constants";
+import { EXPECT_BROWSER_PROFILE_ENV_NAME, EXPECT_HEADED_ENV_NAME } from "./mcp/constants";
 
 import { Playwright, PlaywrightSession } from "./playwright";
 import { Artifacts } from "./artifacts";
@@ -90,6 +90,10 @@ export const layerMcpServer = Layer.effectDiscard(
       onSome: (json) => decodeBrowserProfile(json).pipe(Effect.map(Option.some), Effect.orDie),
     });
 
+    const forceHeaded = yield* Config.boolean(EXPECT_HEADED_ENV_NAME).pipe(
+      Config.withDefault(false),
+    );
+
     const server = new McpServer({ name: "expect", version: "0.0.1" });
 
     let lastSnapshot: SnapshotResult | undefined;
@@ -132,7 +136,7 @@ export const layerMcpServer = Layer.effectDiscard(
           }
 
           yield* pw.open({
-            headless: !headed,
+            headless: forceHeaded ? false : !headed,
             browserOverride,
             browserProfile,
             initialNavigation: Option.some({

packages/browser/src/mcp/constants.ts

@@ -1,5 +1,6 @@
 export const EXPECT_REPLAY_OUTPUT_ENV_NAME = "EXPECT_REPLAY_OUTPUT_PATH";
 export const EXPECT_BROWSER_PROFILE_ENV_NAME = "EXPECT_BROWSER_PROFILE";
 export const EXPECT_CDP_URL_ENV_NAME = "EXPECT_CDP_URL";
+export const EXPECT_HEADED_ENV_NAME = "EXPECT_HEADED";
 export const LIVE_VIEW_PAGE_POLL_INTERVAL_MS = 500;
 export const DUPLICATE_REQUEST_WINDOW_MS = 500;

packages/browser/src/mcp/index.ts

@@ -1,3 +1,7 @@
 export { layerMcpServer, McpTransport } from "../mcp-server";
-export { EXPECT_BROWSER_PROFILE_ENV_NAME, EXPECT_REPLAY_OUTPUT_ENV_NAME } from "./constants";
+export {
+  EXPECT_BROWSER_PROFILE_ENV_NAME,
+  EXPECT_HEADED_ENV_NAME,
+  EXPECT_REPLAY_OUTPUT_ENV_NAME,
+} from "./constants";
 export type { ViewerRunState, ViewerStepEvent } from "./viewer-events";

packages/supervisor/src/executor.ts

@@ -31,7 +31,7 @@ import {
 import * as NodeServices from "@effect/platform-node/NodeServices";
 import { Git } from "./git/git";
 import { BrowserJson, type Browser } from "@expect/cookies";
-import { EXPECT_BROWSER_PROFILE_ENV_NAME } from "@expect/browser/mcp";
+import { EXPECT_BROWSER_PROFILE_ENV_NAME, EXPECT_HEADED_ENV_NAME } from "@expect/browser/mcp";
 import {
   ALL_STEPS_TERMINAL_GRACE_MS,
   EXECUTION_CONTEXT_FILE_LIMIT,
@@ -187,6 +187,9 @@ export class Executor extends ServiceMap.Service<Executor>()("@supervisor/Execut
       });
 
       const mcpEnv: Array<{ name: string; value: string }> = [];
+      if (!options.isHeadless) {
+        mcpEnv.push({ name: EXPECT_HEADED_ENV_NAME, value: "true" });
+      }
       if (options.cookieImportProfiles.length > 0) {
         const profileJson = yield* encodeBrowserProfile(options.cookieImportProfiles[0]).pipe(
           Effect.orDie,