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 { afterEach, beforeEach, expect, test } from "bun:test";
import { mkdtemp, realpath, rm, writeFile } from "node:fs/promises";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { seatIdFor, UnusableBotIdError } from "../src/bot-id";
import { createWorkspaces, workspaceDirectoryFor } from "../src/workspaces";
let root: string;
beforeEach(async () => {
root = await mkdtemp(join(tmpdir(), "workspaces-"));
});
afterEach(async () => {
await rm(root, { recursive: true, force: true });
});
test("a computer serving many Bots gives each its own files", async () => {
const workspaces = createWorkspaces(root, true);
const sales = await workspaces.for("sales");
const support = await workspaces.for("support");
await sales.files.write("notes.md", "sales only");
expect((await sales.files.read("notes.md")).text).toBe("sales only");
await expect(support.files.read("notes.md")).rejects.toThrow();
expect((await support.files.list()).entries).toEqual([]);
});
test("a command starts in its Bot's folder, with HOME there too", async () => {
const workspaces = createWorkspaces(root, true, { PATH: process.env.PATH });
const { shell } = await workspaces.for("sales");
const result = await shell.run({ command: 'pwd; echo "$HOME"' });
// pwd reports the real path, which differs where the temporary directory is a symlink (macOS).
const folder = await realpath(join(root, "computers", "sales"));
const [cwd, home] = result.stdout.trim().split("\n");
expect(cwd).toBe(folder);
expect(await realpath(home ?? "")).toBe(folder);
});
test("a computer serving one Bot keeps its files where they were", async () => {
await writeFile(join(root, "notes.md"), "from before");
const workspaces = createWorkspaces(root, false);
const { files } = await workspaces.for("sales");
expect((await files.read("notes.md")).text).toBe("from before");
});
test("an id that is not a plain name never becomes a folder", () => {
expect(() => workspaceDirectoryFor(root, "../etc", true)).toThrow(
UnusableBotIdError,
);
expect(workspaceDirectoryFor(root, "../etc", false)).toBe(root);
});
test("two people on one Bot, on a computer they share, each get their own files", async () => {
// The shared computer names the person as well as the Bot, so the folder is the pair's. Keyed by
// the Bot alone, a note one person's Bot saved was a file the next person's could read.
const workspaces = createWorkspaces(root, true);
const ada = await workspaces.for(seatIdFor("sales", "ada"));
const bo = await workspaces.for(seatIdFor("sales", "bo"));
await ada.files.write("notes.md", "ada only");
expect((await ada.files.read("notes.md")).text).toBe("ada only");
await expect(bo.files.read("notes.md")).rejects.toThrow();
expect(workspaceDirectoryFor(root, seatIdFor("sales", "ada"), true)).toBe(
join(root, "computers", "ada~sales"),
);
});
test("one person's two Bots on that person's computer each get their own files", async () => {
// A computer of one person's own is sent the Bot alone, so each of their Bots is its own seat.
const workspaces = createWorkspaces(root, true);
const sales = await workspaces.for(seatIdFor("sales"));
const support = await workspaces.for(seatIdFor("support"));
await sales.files.write("notes.md", "sales only");
await expect(support.files.read("notes.md")).rejects.toThrow();
});