Multiplayer agent harness for work.
import assert from "node:assert/strict";
import test from "node:test";
import { readFileSync } from "node:fs";
import { buildSync } from "esbuild";
import { JSDOM } from "jsdom";
const bundle = buildSync({
entryPoints: [new URL("../ui/settings.ts", import.meta.url).pathname],
bundle: true,
write: false,
format: "iife",
globalName: "settingsUI",
platform: "browser",
}).outputFiles[0]!.text;
function setup() {
const dom = new JSDOM(readFileSync(new URL("../public/index.html", import.meta.url), "utf8"), {
runScripts: "outside-only",
});
dom.window.structuredClone = structuredClone;
dom.window.eval(bundle + "; window.settingsUI=settingsUI; settingsUI.mountCards();");
return dom;
}
const models = {
baseModelDefault: "a",
baseModelOptions: [{ id: "a", name: "Alpha" }],
harnessDefault: "pi",
harnessOptions: ["pi", "claude"],
modelsByHarness: { pi: [{ id: "a", name: "Alpha" }], claude: [{ id: "b", name: "Beta" }] },
runtime: { harnessId: "pi", modelId: "a", effortLevel: "high", fastMode: true },
fastModeModelIds: ["a"],
webuiModels: [],
};
test("model chips add and remove with stable keyed rendering", () => {
const dom = setup();
try {
dom.window.eval("settingsUI.load(" + JSON.stringify(models) + ',"org:test","webui-models")');
const doc = dom.window.document;
const input = doc.getElementById("webui-models-add") as HTMLInputElement;
const options = () => [...doc.querySelectorAll("#webui-models-options option")].map((o) => o.textContent);
assert.deepEqual(options(), ["Alpha (a)", "Beta (b)"]);
input.value = "Bet";
input.dispatchEvent(new dom.window.Event("input"));
assert.equal((doc.getElementById("webui-models-add-button") as HTMLButtonElement).disabled, true);
input.value = "b";
input.dispatchEvent(new dom.window.Event("input"));
input.dispatchEvent(new dom.window.KeyboardEvent("keydown", { key: "Enter" }));
assert.deepEqual(options(), ["Alpha (a)"]);
assert.equal(dom.window.eval('settingsUI.collect("webui-models").ids.join()'), "b");
dom.window.document.querySelector<HTMLButtonElement>('[aria-label="Remove b"]')!.click();
assert.equal(dom.window.eval('settingsUI.states.get("webui-models").dirty'), false);
} finally {
dom.window.close();
}
});
test("feature flag entries use a compact row that cannot inherit the card grid", async () => {
const dom = setup();
try {
dom.window.eval(`settingsUI.configureFlags({
loadChoices: async () => [],
buildSelector: () => document.createElement("button"),
save: async () => ({ ok: true }),
})`);
await dom.window.eval(`settingsUI.loadFlags(
{ featureFlags: [{ featureName: "persistent_subagents", enabledScopes: ["personal:[email protected]"] }] },
"org:test",
)`);
await new Promise((resolve) => dom.window.setTimeout(resolve, 0));
const list = dom.window.document.getElementById("feature-flag-list")!;
assert.equal(list.querySelectorAll(".feature-flag-row").length, 1);
assert.equal(list.querySelector(".setting-row"), null);
assert.equal(dom.window.getComputedStyle(list.querySelector(".feature-flag-row")!).display, "grid");
const editor = dom.window.document.querySelector("#card-feature-flags .feature-flag-editor")!;
assert.ok(editor);
assert.equal(editor.classList.contains("editor-grid"), false);
} finally {
dom.window.close();
}
});
test("feature flag picker offers every server feature and limits personal-only features to people", async () => {
const dom = setup();
try {
dom.window.eval(`settingsUI.configureFlags({
loadChoices: async () => [{ scopeId: "personal:ada" }, { scopeId: "channel:C1" }],
buildSelector: (choices) => Object.assign(document.createElement("ul"), { id: "offered", textContent: choices.map((c) => c.scopeId).join() }),
save: async () => ({ ok: true }),
})`);
await dom.window.eval(`settingsUI.loadFlags(
{ featureFlags: [
{ featureName: "persistent_subagents", label: "Persistent subagents", personalOnly: true, hint: "People only.", enabledScopes: [] },
{ featureName: "swarms", label: "Swarms", personalOnly: true, enabledScopes: [] },
{ featureName: "team_scopes", label: "Team scopes", enabledScopes: [] },
] },
"org:test",
)`);
await new Promise((resolve) => dom.window.setTimeout(resolve, 0));
const doc = dom.window.document;
const select = doc.getElementById("feature-flag-name") as HTMLSelectElement;
assert.deepEqual(
[...select.options].map((option) => option.textContent),
["Persistent subagents", "Swarms", "Team scopes"],
);
assert.equal(select.value, "persistent_subagents");
assert.equal(doc.getElementById("offered")!.textContent, "personal:ada");
assert.equal(doc.querySelector("#card-feature-flags .hint:not(#feature-flag-list)")!.textContent, "People only.");
select.value = "team_scopes";
select.dispatchEvent(new dom.window.Event("change"));
assert.equal(doc.getElementById("offered")!.textContent, "personal:ada,channel:C1");
} finally {
dom.window.close();
}
});
test("SOUL conflict keeps draft while replacing saved revision and version", () => {
const dom = setup();
try {
dom.window.eval('settingsUI.load({soul:"old",soulVersion:1},"org:test","soul")');
dom.window.document.getElementById("soul-edit")!.click();
const input = dom.window.document.getElementById("soul") as HTMLTextAreaElement;
input.value = "draft <img src=x>";
input.dispatchEvent(new dom.window.Event("input"));
dom.window.eval('settingsUI.refreshSoul({soul:"other",soulVersion:2})');
assert.equal(input.value, "draft <img src=x>");
assert.equal(dom.window.document.getElementById("soul-saved")!.textContent, "other");
assert.equal(dom.window.eval('settingsUI.collect("soul").expectedVersion'), 2);
assert.equal(dom.window.document.querySelector("#card-soul img"), null);
} finally {
dom.window.close();
}
});
test("credential editor derives broker capabilities and preserves write-only secrets", () => {
const dom = setup();
try {
dom.window.eval(
'settingsUI.configureCredentials({label: id => id,formatTime:String,edit(){},remove(){}}); settingsUI.loadCredentials([],[],[],[],"org:test"); settingsUI.credentialState.begin({slug:"service",name:"Service",host:"api.example.com",updatedAt:10,hasSecret:true,injection:{actor:true},grantees:["org:test"]})',
);
const doc = dom.window.document;
const secret = doc.getElementById("sc-secret") as HTMLInputElement;
assert.equal(secret.value, "");
assert.equal(dom.window.eval('"secret" in settingsUI.credentialState.collect()'), false);
assert.equal(dom.window.eval("settingsUI.credentialState.collect().injection.actor"), true);
const host = doc.getElementById("sc-host") as HTMLInputElement;
host.value = "changed.example.com";
host.dispatchEvent(new dom.window.Event("input"));
assert.equal(doc.getElementById("sc-cap-host")!.textContent, "changed.example.com and its subdomains");
assert.equal((doc.getElementById("sc-save") as HTMLButtonElement).disabled, false);
assert.equal(dom.window.eval("settingsUI.credentialState.collect().expectedUpdatedAt"), 10);
} finally {
dom.window.close();
}
});
test("credential delivery transitions exclude narrower broker grants from env payloads", () => {
const dom = setup();
try {
dom.window.eval(
'settingsUI.loadCredentials([],[],[],[],"org:test"); settingsUI.credentialState.begin(null); settingsUI.credentialState.change("name","Example");settingsUI.credentialState.change("slug","example");settingsUI.credentialState.change("org",false);settingsUI.credentialState.change("people","[email protected]");settingsUI.credentialState.change("delivery","env");settingsUI.credentialState.change("envkey","EXAMPLE_KEY")',
);
assert.equal(dom.window.eval("settingsUI.credentialState.collect().grantees.join()"), "org:test");
assert.equal(dom.window.eval("settingsUI.credentialState.collect().host"), "");
assert.equal(dom.window.eval("settingsUI.credentialState.validate(settingsUI.credentialState.collect())"), "");
dom.window.eval('settingsUI.credentialState.change("envkey","AGENT_SECRET")');
assert.match(
String(dom.window.eval("settingsUI.credentialState.validate(settingsUI.credentialState.collect())")),
/reserved/,
);
} finally {
dom.window.close();
}
});
test("credential save acknowledges its submitted snapshot and retains newer edits", () => {
const dom = setup();
try {
dom.window.eval(
'settingsUI.loadCredentials([],[],[],[],"org:test"); settingsUI.credentialState.begin({slug:"test",name:"Old",host:"example.com",updatedAt:1,grantees:["org:test"]});settingsUI.credentialState.change("name","Submitted");window.submitted=settingsUI.credentialState.collect();settingsUI.credentialState.change("name","Newer draft");settingsUI.loadCredentials([{slug:"test",updatedAt:2}],[],[],[],"org:test");settingsUI.credentialState.commit(submitted)',
);
assert.equal(dom.window.eval("settingsUI.credentialState.collect().name"), "Newer draft");
assert.equal(dom.window.eval("settingsUI.credentialState.collect().expectedUpdatedAt"), 2);
assert.equal(dom.window.eval("settingsUI.credentialState.dirty"), true);
} finally {
dom.window.close();
}
});