Open-source AI coworkers that each get a computer of their own: a browser, files and tools, with every action decided before it happens and recorded after. Bring any AG-UI agent.
import { afterAll, beforeAll, describe, expect, test } from "bun:test";
import { mkdir, mkdtemp, rm } from "node:fs/promises";
import { createServer } from "node:net";
import { tmpdir } from "node:os";
import { join } from "node:path";
/**
* The optional full browser, driven as the container drives it.
*
* Asked for explicitly because it needs a virtual display and a real Chromium:
*
* OPENBOT_HEADED_BROWSER=1 bun test tests/headed-browser.test.ts
*
* The computer starts and owns Xvfb itself. Wrapping this command in xvfb-run would hide display
* allocation bugs by giving Chromium a second display it does not own.
*/
const asked = process.env.OPENBOT_HEADED_BROWSER === "1";
const TOKEN = "headed-browser-test-token";
const BOT = "headed-browser";
async function freePort(): Promise<number> {
return new Promise((resolve, reject) => {
const probe = createServer();
probe.on("error", reject);
probe.listen(0, "127.0.0.1", () => {
const address = probe.address();
if (!address || typeof address === "string") {
reject(new Error("The port probe did not return a TCP address."));
return;
}
probe.close(() => resolve(address.port));
});
});
}
let base = "";
let root = "";
let site: ReturnType<typeof Bun.serve> | undefined;
function api(path: string, init?: RequestInit) {
return fetch(`${base}${path}`, {
...init,
headers: {
"content-type": "application/json",
"x-openbot-bot-id": BOT,
"x-openbot-computer-token": TOKEN,
...(init?.headers ?? {}),
},
});
}
beforeAll(async () => {
if (!asked) return;
root = await mkdtemp(join(tmpdir(), "agent-computer-headed-"));
const port = await freePort();
base = `http://127.0.0.1:${port}`;
process.env.COMPUTER_TOKEN = TOKEN;
// Linux is where hosted computers run and headed is their default, so it is left to the default
// there; anywhere else it has to be asked for.
if (process.platform === "linux") delete process.env.COMPUTER_BROWSER_MODE;
else process.env.COMPUTER_BROWSER_MODE = "headed";
process.env.PORT = String(port);
// No API server pushes this computer a network policy, so it browses before one arrives, as in
// person-browser-computer.test.ts. The page is served over http because `/navigate` refuses data: URLs.
process.env.EGRESS_POLICY_REQUIRED = "0";
site = Bun.serve({
hostname: "127.0.0.1",
port: 0,
fetch: () =>
new Response(
"<!doctype html><body></body><script>document.body.textContent=navigator.userAgent+'\\nwebdriver='+navigator.webdriver</script>",
{ headers: { "content-type": "text/html; charset=utf-8" } },
),
});
process.env.PROFILES_DIR = join(root, "profiles");
process.env.WORKSPACE_DIR = join(root, "workspace");
await mkdir(process.env.PROFILES_DIR, { recursive: true });
await import(`../src/index?headed=${Date.now()}`);
});
afterAll(async () => {
if (!asked) return;
await api("/computers/stop", { method: "POST" }).catch(() => undefined);
site?.stop(true);
await rm(root, { recursive: true, force: true });
}, 30_000);
describe.skipIf(!asked)("a browser a person can take over", () => {
test("is full Chromium rather than the headless shell", async () => {
const page = `http://127.0.0.1:${site?.port}/`;
const navigated = await api("/navigate", {
method: "POST",
body: JSON.stringify({ url: page }),
});
expect(navigated.status).toBe(200);
const read = await api("/read");
const body = (await read.json()) as { text?: string };
expect(body.text).not.toContain("HeadlessChrome");
expect(body.text).toContain("webdriver=false");
}, 30_000);
});