Function spawnOpencode

packages/e2e-tests/src/opencode-runner/spawn.ts:220–307

(opts: SpawnOptions)

}

export async function spawnOpencode(opts: SpawnOptions): Promise<SpawnedOpencode> {
    const env = createIsolatedEnv();
    const port = opts.port ?? (await pickFreePort());

    writeConfigs(env, opts.mockProviderURL, opts);

    // Explicitly strip any inherited OPENCODE_SERVER_PASSWORD from the parent shell —
    // our tests run unsecured on a random localhost port, and inherited auth would
    // force every SDK request to carry Basic auth headers we don't set.
    // Also strip NODE_ENV=test: Bun's test runner sets it automatically and the
    // plugin's logger (src/shared/logger.ts) silences all output when NODE_ENV=test.
    // We want the subprocess to behave like a real install, so the log file gets
    // populated normally for diagnostics.
    const childEnv: Record<string, string> = {};
    for (const [key, value] of Object.entries(process.env)) {
        if (value === undefined) continue;
        if (key === "OPENCODE_SERVER_PASSWORD") continue;
        if (key === "OPENCODE_SERVER_USERNAME") continue;
        if (key === "NODE_ENV") continue;
        childEnv[key] = value;
    }
    childEnv.OPENCODE_CONFIG_DIR = env.configDir;
    childEnv.XDG_CONFIG_HOME = env.configDir;
    childEnv.XDG_DATA_HOME = env.dataDir;
    childEnv.XDG_CACHE_HOME = env.cacheDir;
    // Ensure anthropic doesn't bail for missing env vars — we use a fake key.
    childEnv.ANTHROPIC_API_KEY = "test-key-not-real";

    // Bind to 0.0.0.0 (all interfaces) instead of 127.0.0.1 — empirically on
    // GitHub-hosted runners, opencode binding to 127.0.0.1 sometimes results
    // in Bun's `fetch()` timing out even though `curl` succeeds. Binding all
    // interfaces removes any loopback-specific stack-resolution edge case
    // (IPv4-only AF_INET vs IPv4-mapped IPv6, AF_UNSPEC name resolution, etc.).
    // Clients still connect to `127.0.0.1:${port}` — only the listen socket
    // changes. Safe locally too: process is short-lived, port is random.
    const child: ChildProcess = spawn(
        "opencode",
        ["serve", "--port", String(port), "--hostname", "0.0.0.0"],
        {
            cwd: env.workdir,
            env: childEnv,
            stdio: ["ignore", "pipe", "pipe"],
        },
    );

    let stdoutBuf = "";
    let stderrBuf = "";
    child.stdout?.on("data", (chunk: Buffer) => {
        stdoutBuf += chunk.toString();
    });
    child.stderr?.on("data", (chunk: Buffer) => {
        stderrBuf += chunk.toString();
    });

    const url = `http://127.0.0.1:${port}`;
    try {
        await waitForReady(url);
    } catch (err) {