// Shared helper for the `local` e2e project: boot a real `executor web` in a// recorded terminal, parse its printed one-time `?_token=` URL, and run a body// against it. Each scenario boots its OWN server (own throwaway data dir,// `--port 0`) so files can run in parallel without colliding. The terminal// stays up until the body settles, then Ctrl-C gives a graceful shutdown (so// the vite child dies and the PTY closes).import { mkdtempSync, rmSync } from "node:fs";import { tmpdir } from "node:os";import { join } from "node:path";import { fileURLToPath } from "node:url"; import { Effect } from "effect"; import type { CliSurface } from "../src/surfaces/cli";import { markFocus, markRecordingStart } from "../src/timeline"; const repoRoot = fileURLToPath(new URL("../../", import.meta.url)); /** The `Open: …/?_token=<token>` URL the CLI prints once the server is up. */export const TOKEN_URL = /http:\/\/127\.0\.0\.1:\d+\/\?_token=[A-Za-z0-9_-]+/; export interface ServerHandle { /** The full `?_token=` bootstrap URL (origin + token). */ readonly url: string; /** The server origin, e.g. `http://127.0.0.1:54321`. */ readonly origin: string; /** The bearer token (the `_token` query param), in plaintext. */ readonly token: string;} /** * Boot `executor web` and run `body` against the resulting {@link ServerHandle}. * Keeps the server up until the body settles, then Ctrl-C for a graceful * shutdown. Cleans up the throwaway data dir. The body may drive the browser, * a typed API client, an MCP client — anything that needs the live server. */export const withLocalServer = ( cli: CliSurface, runDir: string, body: (server: ServerHandle) => Effect.Effect<void>,): Effect.Effect<void> => Effect.gen(function* () { const dataDir = mkdtempSync(join(tmpdir(), "executor-local-e2e-")); let publishUrl!: (url: string) => void; const urlReady = new Promise<string>((res) => { publishUrl = res; }); let signalBodyDone!: () => void; const bodyDone = new Promise<void>((res) => { signalBodyDone = res; }); yield* Effect.all( [ cli.session( ["bun", "run", "dev:cli", "web", "--port", "0"], async (term) => { markRecordingStart(runDir, "terminal"); markFocus(runDir, "terminal"); const snapshot = await term.screen.waitUntil( (current) => TOKEN_URL.test(current.text), { timeoutMs: 120_000 }, ); const url = TOKEN_URL.exec(snapshot.text)?.[0]; if (!url) { throw new Error(`executor web printed no ?_token URL:\n${snapshot.text.slice(-600)}`); } publishUrl(url); await bodyDone; // Graceful shutdown so the vite child is killed and the PTY closes; // otherwise the orphaned child wedges the terminal teardown. markFocus(runDir, "terminal"); await term.keyboard.press("Control+C"); }, { cwd: repoRoot, env: { EXECUTOR_DATA_DIR: dataDir, EXECUTOR_SCOPE_DIR: dataDir }, record: join(runDir, "terminal.cast"), viewport: { cols: 120, rows: 40 }, }, ), Effect.gen(function* () { const url = yield* Effect.promise(() => urlReady); const parsed = new URL(url); yield* body({ url, origin: parsed.origin, token: parsed.searchParams.get("_token")!, }).pipe(Effect.ensuring(Effect.sync(() => signalBodyDone()))); }), ], { concurrency: "unbounded" }, ).pipe(Effect.ensuring(Effect.sync(() => rmSync(dataDir, { recursive: true, force: true })))); });
// Shared helper for the `local` e2e project: boot a real `executor web` in a
// recorded terminal, parse its printed one-time `?_token=` URL, and run a body
// against it. Each scenario boots its OWN server (own throwaway data dir,
// `--port 0`) so files can run in parallel without colliding. The terminal
// stays up until the body settles, then Ctrl-C gives a graceful shutdown (so
// the vite child dies and the PTY closes).
import { mkdtempSync, rmSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { fileURLToPath } from "node:url";
import { Effect } from "effect";
import type { CliSurface } from "../src/surfaces/cli";
import { markFocus, markRecordingStart } from "../src/timeline";
const repoRoot = fileURLToPath(new URL("../../", import.meta.url));
/** The `Open: …/?_token=<token>` URL the CLI prints once the server is up. */
export const TOKEN_URL = /http:\/\/127\.0\.0\.1:\d+\/\?_token=[A-Za-z0-9_-]+/;
export interface ServerHandle {
/** The full `?_token=` bootstrap URL (origin + token). */
readonly url: string;
/** The server origin, e.g. `http://127.0.0.1:54321`. */
readonly origin: string;
/** The bearer token (the `_token` query param), in plaintext. */
readonly token: string;
}
/**
* Boot `executor web` and run `body` against the resulting {@link ServerHandle}.
* Keeps the server up until the body settles, then Ctrl-C for a graceful
* shutdown. Cleans up the throwaway data dir. The body may drive the browser,
* a typed API client, an MCP client — anything that needs the live server.
*/
export const withLocalServer = (
cli: CliSurface,
runDir: string,
body: (server: ServerHandle) => Effect.Effect<void>,
): Effect.Effect<void> =>
Effect.gen(function* () {
const dataDir = mkdtempSync(join(tmpdir(), "executor-local-e2e-"));
let publishUrl!: (url: string) => void;
const urlReady = new Promise<string>((res) => {
publishUrl = res;
});
let signalBodyDone!: () => void;
const bodyDone = new Promise<void>((res) => {
signalBodyDone = res;
});
yield* Effect.all(
[
cli.session(
["bun", "run", "dev:cli", "web", "--port", "0"],
async (term) => {
markRecordingStart(runDir, "terminal");
markFocus(runDir, "terminal");
const snapshot = await term.screen.waitUntil(
(current) => TOKEN_URL.test(current.text),
{ timeoutMs: 120_000 },
);
const url = TOKEN_URL.exec(snapshot.text)?.[0];
if (!url) {
throw new Error(`executor web printed no ?_token URL:\n${snapshot.text.slice(-600)}`);
}
publishUrl(url);
await bodyDone;
// Graceful shutdown so the vite child is killed and the PTY closes;
// otherwise the orphaned child wedges the terminal teardown.
markFocus(runDir, "terminal");
await term.keyboard.press("Control+C");
},
{
cwd: repoRoot,
env: { EXECUTOR_DATA_DIR: dataDir, EXECUTOR_SCOPE_DIR: dataDir },
record: join(runDir, "terminal.cast"),
viewport: { cols: 120, rows: 40 },
},
),
Effect.gen(function* () {
const url = yield* Effect.promise(() => urlReady);
const parsed = new URL(url);
yield* body({
url,
origin: parsed.origin,
token: parsed.searchParams.get("_token")!,
}).pipe(Effect.ensuring(Effect.sync(() => signalBodyDone())));
}),
],
{ concurrency: "unbounded" },
).pipe(Effect.ensuring(Effect.sync(() => rmSync(dataDir, { recursive: true, force: true }))));
});