@whiteroom-ai/cli 1.1.0 → 2.0.1

package/dist/sandbox/listen.js

@@ -0,0 +1,299 @@
+// `whiteroom sandbox listen --adapter "<cmd>"`: the connected helper behind
+// the Sandbox page's Run agent button. It claims a one-time helper code, then
+// waits for tasks the owner queues there and runs each through the user's
+// adapter (the practice tests' NDJSON contract), with the agent's calls going
+// to the Sandbox URL. WhiteRoom sends task data only (a prompt); the command
+// that runs is the one typed here, never anything from WhiteRoom.
+import { hostname } from "node:os";
+import { runAdapter } from "../practice/adapter.js";
+import { CATALOG } from "../practice/catalog.js";
+import { Engine, OFFLINE_MS, REDIRECTED, Stopped, Unreachable } from "../practice/engine.js";
+import { adapterProblem, chatCompletions, firstLineOfStdin, hiddenPrompt, Interrupted, isProvider, nodeTooOld, targetOrigin } from "../practice/preflight.js";
+import { clean, hideSecret, say, warn } from "../practice/text.js";
+export const HELPER_CODE = /^wrhc_[A-Za-z0-9_-]{43}$/;
+/** A Sandbox URL as the Sandbox page shows it: WhiteRoom's address, then the Sandbox key. */
+const SANDBOX_URL = /^(https?:\/\/[^/\s?#@]+)\/(sk-wr-[0-9a-f]{40})(?:[/?#]\S*)?$/;
+/** How long one task may run before its adapter is stopped. */
+export const TASK_MS = 10 * 60_000;
+/** While a task runs the helper doesn't poll, so it tells WhiteRoom it's still there. */
+const HEARTBEAT_MS = 20_000;
+/** Tests shorten the task deadline, heartbeat and offline wait (internal, not a user setting; WHITEROOM_* never reaches the adapter). */
+const testMs = (name, fallback) => {
+    const v = Number(process.env[name]);
+    return Number.isInteger(v) && v > 0 ? v : fallback;
+};
+const SUMMARY_MAX = 2000;
+const SANDBOX_PAGE = "https://app.whiteroom.tech/sandbox";
+const NEW_CODE = `In the Sandbox page (${SANDBOX_PAGE}), click Run agent to get a new code, then start the helper again.`;
+export const sandboxCopy = {
+    connected: "Helper connected · waiting for tasks from the Sandbox page (Ctrl+C to stop)",
+    needCode: "Paste the helper code from the Sandbox page (it won't show): ",
+    badCode: "That isn't a helper code. Copy it again from the Sandbox page (it starts with wrhc_).",
+    noTerminal: "No terminal to ask for the helper code. Pass it on stdin with --code-stdin.",
+    noSandboxUrl: "Point your agent at your Sandbox first: set its base URL to the Sandbox URL from the Sandbox page (for example export ANTHROPIC_BASE_URL=<Sandbox URL>), then run the command again. Nothing was sent.",
+    severalSandboxUrls: (vars) => `More than one Sandbox URL is set (${vars.join(", ")}). Keep the one your agent uses, then run the command again. Nothing was sent.`,
+    otherSandboxHost: (urlHost, host) => `Your Sandbox URL is on ${urlHost}, but the helper connects to ${host}. Use the Sandbox URL and command from the same Sandbox page. Nothing was sent.`,
+    badUrl: "--url must be a WhiteRoom address (https://….whiteroom.tech) or http://localhost for local testing.",
+    adapterMissing: (cmd, why) => `Couldn't start the adapter \`${cmd}\`: ${why}. Nothing was sent, and your helper code still works.`,
+    windows: "The helper runs on macOS and Linux for now. Run the command there, or in WSL.",
+    codeInvalid: `This helper code doesn't work any more. ${NEW_CODE}`,
+    keyMismatch: (left) => left > 0
+        ? `Your agent's Sandbox URL isn't this Sandbox's current one (was the key rotated?). Copy the Sandbox URL from the Sandbox page, set it again, then run the same command (${left} ${left === 1 ? "try" : "tries"} left on this code).`
+        : `Your agent's Sandbox URL isn't this Sandbox's current one, and this code has no tries left. Copy the Sandbox URL from the Sandbox page, set it again, then get a new code.`,
+    notConnected: "This Sandbox has no key yet. Connect a provider key in the Sandbox page first.",
+    unavailable: "The Sandbox helper isn't available yet. Try again later.",
+    unreachable: "Couldn't reach WhiteRoom. Check your connection, then start the helper again.",
+    redirected: "WhiteRoom's server tried to send the helper to another address, so it stopped. Nothing was sent anywhere else.",
+    outdated: "WhiteRoom sent something this CLI doesn't understand. Update the CLI, then start the helper again.",
+    otherHost: "WhiteRoom named another host for your Sandbox, so the helper stopped before running your agent.",
+    sessionEnded: {
+        session_lost: `This helper's session has ended (WhiteRoom restarted, or it expired). ${NEW_CODE}`,
+        replaced: "Another helper connected to this Sandbox, so this one stopped.",
+        disconnected: "The helper was disconnected from the Sandbox page.",
+        lost_contact: `WhiteRoom didn't hear from this helper for a while, so its session ended. ${NEW_CODE}`,
+    },
+    stopped: "Helper stopped. The Sandbox page shows it disconnected.",
+    cancelled: "Stopped before the helper connected. Your code still works until it expires.",
+    task: (n, prompt) => `Task ${n}: ${prompt.replace(/\s+/g, " ").slice(0, 80)}${prompt.length > 80 ? "…" : ""}`,
+    taskDone: (n) => `Task ${n} finished. The result is on the Sandbox page.`,
+    taskFailed: (n, why) => `Task ${n} didn't finish: ${why}`,
+    resultNotSent: (n) => `Task ${n} ran, but its result couldn't be sent to WhiteRoom. If the Sandbox page hands it out again, the helper sends it again.`,
+    noTools: "No tools are available in Sandbox tasks.",
+};
+/** The Sandbox URL the user's agent points at, found in its environment: the variable, WhiteRoom's origin and the Sandbox key. */
+export function findSandboxUrl(env) {
+    const found = new Map();
+    for (const [variable, value] of Object.entries(env)) {
+        const m = value?.trim().match(SANDBOX_URL);
+        if (m && !found.has(m[2]))
+            found.set(m[2], { variable, origin: new URL(m[1]).origin, key: m[2] });
+    }
+    return [...found.values()];
+}
+/** The adapter's environment: the user's own (their agent's settings and keys), without WhiteRoom's. */
+export function helperEnv(parent) {
+    const env = {};
+    for (const [k, v] of Object.entries(parent))
+        if (!/^WHITEROOM_/i.test(k))
+            env[k] = v;
+    return env;
+}
+/** This computer's name as the Sandbox page shows it ("Helper connected · <host>"). */
+export function helperHost(name = hostname()) {
+    return name.replace(/[^A-Za-z0-9._-]/g, "-").slice(0, 64) || "computer";
+}
+/** How long a deadline is, in plain words ("10 minutes", "1 second"). */
+const duration = (ms) => {
+    const [n, unit] = ms >= 60_000 && ms % 60_000 === 0 ? [ms / 60_000, "minute"] : [Math.max(1, Math.round(ms / 1000)), "second"];
+    return `${n} ${unit}${n === 1 ? "" : "s"}`;
+};
+/**
+ * What a task's adapter run reports back: ok and a summary of at most 2,000
+ * characters. Everything sent to WhiteRoom goes through clean(), so a provider
+ * key, the Sandbox key, the helper code or session the adapter echoes is never sent.
+ */
+export function taskResult(out, taskMs = TASK_MS) {
+    const cut = (s) => clean(s).slice(0, SUMMARY_MAX);
+    switch (out.kind) {
+        case "final": return { ok: true, summary: cut(out.output) };
+        case "exited": return { ok: false, summary: cut(`Your adapter exited (${out.how}) before finishing.${out.tail.length ? ` Last output: ${out.tail.join(" / ")}` : ""}`) };
+        case "broke": return { ok: false, summary: cut(`Your adapter ${out.why}.`) };
+        case "deadline": return { ok: false, summary: cut(`Your agent didn't finish within ${duration(taskMs)}, so it was stopped.`) };
+        default: return { ok: false, summary: cut("Stopped on the helper's computer.") };
+    }
+}
+const fail = (code, line) => (warn(line), code);
+/** A session refusal, in plain words. */
+const sessionOver = (r) => fail(3, sandboxCopy.sessionEnded[r.body?.reason] ?? sandboxCopy.sessionEnded.session_lost);
+/** A reply that ends listening: the session refused (401), or a redirect. */
+const ends = (r) => r.status === 401 || r.status === REDIRECTED;
+const endListening = (r) => (r.status === REDIRECTED ? fail(3, sandboxCopy.redirected) : sessionOver(r));
+export async function listen(a) {
+    // ── Preflight: nothing is sent until every check passes ──
+    const old = nodeTooOld();
+    if (old)
+        return fail(2, old);
+    if (process.platform === "win32")
+        return fail(2, sandboxCopy.windows);
+    const origin = targetOrigin(a.url);
+    if (!origin)
+        return fail(2, sandboxCopy.badUrl);
+    const why = adapterProblem(a.adapter);
+    if (why)
+        return fail(2, sandboxCopy.adapterMissing(a.adapter, why));
+    // The user's own command runs through their shell as typed; nothing from WhiteRoom is ever put into it.
+    const launch = { shell: a.adapter };
+    // Provider keys in the environment are never printed, even in the adapter's output.
+    for (const p of Object.values(CATALOG.providers)) {
+        const v = process.env[p.keyVar];
+        if (v)
+            hideSecret(v.trim());
+    }
+    const urls = findSandboxUrl(process.env);
+    if (!urls.length)
+        return fail(2, sandboxCopy.noSandboxUrl);
+    if (urls.length > 1)
+        return fail(2, sandboxCopy.severalSandboxUrls(urls.map((u) => u.variable)));
+    const sandbox = urls[0];
+    hideSecret(sandbox.key);
+    if (sandbox.origin !== origin)
+        return fail(2, sandboxCopy.otherSandboxHost(new URL(sandbox.origin).host, new URL(origin).host));
+    let code = "";
+    try {
+        if (a.codeStdin)
+            code = await firstLineOfStdin();
+        else {
+            if (!process.stdin.isTTY)
+                return fail(2, sandboxCopy.noTerminal);
+            for (let i = 0; i < 3 && !HELPER_CODE.test(code); i++) {
+                if (i)
+                    warn(sandboxCopy.badCode);
+                code = await hiddenPrompt(sandboxCopy.needCode);
+            }
+        }
+    }
+    catch (err) {
+        // Cancelled at the prompt: no session existed, so this is a plain stop (0), not an ended session (3).
+        if (err instanceof Interrupted)
+            return fail(0, sandboxCopy.cancelled);
+        throw err;
+    }
+    if (!HELPER_CODE.test(code))
+        return fail(2, sandboxCopy.badCode);
+    hideSecret(code);
+    // ── Claim: the code, and which Sandbox key this computer's agent uses (its non-secret prefix, never the key) ──
+    const engine = new Engine(origin, testMs("WHITEROOM_TEST_OFFLINE_MS", OFFLINE_MS));
+    let claim;
+    try {
+        claim = await engine.post("/api/sandbox-helper/claim", { code, keyPrefix: sandbox.key.slice(0, 22), host: helperHost() });
+    }
+    catch (err) {
+        // No session yet: a setup problem (2); the code is still unused.
+        if (err instanceof Unreachable)
+            return fail(2, sandboxCopy.unreachable);
+        throw err;
+    }
+    if (claim.status === 401 && claim.body?.reason === "key_mismatch")
+        return fail(2, sandboxCopy.keyMismatch(Number(claim.body.triesLeft) || 0));
+    if (claim.status === 410)
+        return fail(2, sandboxCopy.codeInvalid);
+    if (claim.status === 409 && claim.body?.reason === "not_connected")
+        return fail(2, sandboxCopy.notConnected);
+    if (claim.status === REDIRECTED)
+        return fail(2, sandboxCopy.redirected);
+    if (claim.status === 404)
+        return fail(2, sandboxCopy.unavailable);
+    const { session, proxyUrl, provider } = claim.body ?? {};
+    if (claim.status !== 200 || typeof session !== "string" || !isProvider(provider))
+        return fail(2, sandboxCopy.outdated);
+    engine.session = session;
+    hideSecret(session);
+    // The agent's calls go to this Sandbox's URL, on the host the helper claimed on, never one WhiteRoom names elsewhere.
+    if (proxyUrl !== sandbox.origin) {
+        await engine.once("/api/sandbox-helper/disconnect", {});
+        return fail(3, sandboxCopy.otherHost);
+    }
+    // As practice tests pass it: Azure OpenAI under /openai; OpenAI SDKs want a base URL that ends in /v1.
+    const sandboxBase = `${sandbox.origin}/${sandbox.key}${provider === "azure-openai" ? "/openai" : ""}`;
+    const baseUrl = chatCompletions(provider) ? `${sandboxBase}/v1` : sandboxBase;
+    say(sandboxCopy.connected);
+    // ── Listening: Ctrl+C (or a signal) disconnects; WhiteRoom can end the session ──
+    const stop = new AbortController();
+    engine.signal = stop.signal;
+    const onStop = () => stop.abort();
+    process.on("SIGINT", onStop);
+    process.on("SIGTERM", onStop);
+    process.on("SIGHUP", onStop);
+    /** Results by task: a task handed out again gets its result (re)sent, not a second run. */
+    const done = new Map();
+    const taskMs = testMs("WHITEROOM_TEST_TASK_MS", TASK_MS);
+    const heartbeatMs = testMs("WHITEROOM_TEST_HEARTBEAT_MS", HEARTBEAT_MS);
+    let n = 0;
+    /** Posts a task's result; announces it only once WhiteRoom has it. Returns a reply that ends listening, else null. */
+    const sendResult = async (taskId, entry) => {
+        const r = await engine.post("/api/sandbox-helper/result", { taskId, ...entry.result }, { retryNetwork: true });
+        if (ends(r))
+            return r;
+        const ok = r.status >= 200 && r.status < 300;
+        if (ok && !entry.sent)
+            say(entry.result.ok ? sandboxCopy.taskDone(entry.n) : sandboxCopy.taskFailed(entry.n, clean(entry.result.summary)));
+        else if (!ok)
+            warn(sandboxCopy.resultNotSent(entry.n));
+        entry.sent ||= ok;
+        return null;
+    };
+    let ended = null;
+    const runTask = async (task) => {
+        say(sandboxCopy.task(++n, task.prompt));
+        const taskStop = new AbortController();
+        const abort = () => taskStop.abort();
+        stop.signal.addEventListener("abort", abort, { once: true });
+        const beat = setInterval(() => {
+            void engine.once("/api/sandbox-helper/heartbeat", {}).then((r) => {
+                if (r?.status === 401)
+                    (ended = r), taskStop.abort();
+            });
+        }, heartbeatMs);
+        beat.unref();
+        let out;
+        try {
+            out = await runAdapter({
+                launch, env: helperEnv(process.env), deadline: Date.now() + taskMs, signal: taskStop.signal,
+                message: { type: "task", task: task.prompt, tools: [], headers: {}, model: null, base_url: baseUrl },
+                tool: async () => ({ result: { error: sandboxCopy.noTools } }),
+            });
+        }
+        finally {
+            clearInterval(beat);
+            stop.signal.removeEventListener("abort", abort);
+        }
+        // Stopped here: disconnecting closes the task on the Sandbox page.
+        if (out.kind === "stopped" || ended)
+            return null;
+        const entry = { n, result: taskResult(out, taskMs), sent: false };
+        done.set(task.taskId, entry);
+        return sendResult(task.taskId, entry);
+    };
+    try {
+        for (;;) {
+            // Every request to WhiteRoom in this loop ends the same way: Ctrl+C stops (0), unreachable ends (3).
+            try {
+                const next = await engine.post("/api/sandbox-helper/next", {}, { retryNetwork: true });
+                if (ends(next))
+                    return endListening(next);
+                if (next.status !== 200)
+                    return fail(3, sandboxCopy.outdated);
+                if (next.body?.idle)
+                    continue;
+                const task = next.body?.task;
+                if (!task || typeof task.taskId !== "string" || task.kind !== "prompt" || typeof task.prompt !== "string")
+                    return fail(3, sandboxCopy.outdated);
+                // A task handed out again (WhiteRoom didn't get the result): send the result again, don't run it twice.
+                const sent = done.get(task.taskId);
+                const refused = sent ? await sendResult(task.taskId, sent) : await runTask(task);
+                if (refused)
+                    return endListening(refused);
+            }
+            catch (err) {
+                if (err instanceof Stopped)
+                    break;
+                if (err instanceof Unreachable)
+                    return fail(3, sandboxCopy.unreachable);
+                throw err;
+            }
+            if (ended)
+                return sessionOver(ended);
+            if (stop.signal.aborted)
+                break;
+        }
+        await engine.once("/api/sandbox-helper/disconnect", {});
+        say(sandboxCopy.stopped);
+        return 0;
+    }
+    finally {
+        process.off("SIGINT", onStop);
+        process.off("SIGTERM", onStop);
+        process.off("SIGHUP", onStop);
+    }
+}
+//# sourceMappingURL=listen.js.map

package/dist/sandbox/listen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listen.js","sourceRoot":"","sources":["../../src/sandbox/listen.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,22 +1,29 @@
 {
   "name": "@whiteroom-ai/cli",
-  "version": "1.1.0",
+  "version": "2.0.1",
   "description": "CLI for WhiteRoom — manage AI agent fleets from the terminal",
   "type": "module",
   "bin": {
     "whiteroom": "dist/index.js"
   },
+  "files": ["dist", "starters", "contract/catalog.json"],
+  "engines": {
+    "node": ">=20"
+  },
   "scripts": {
     "build": "tsc",
     "typecheck": "tsc --noEmit",
-    "dev": "tsx src/index.ts"
+    "test": "node --import tsx --test test/*.test.ts",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
   },
   "license": "Apache-2.0",
   "dependencies": {
     "@whiteroom-ai/sdk": "^1.1.0"
   },
   "devDependencies": {
-    "typescript": "^5.6.0",
+    "@types/node": "^26.6.2",
+    "typescript": "^7.0.2",
     "tsx": "^4.19.0"
   }
 }

package/starters/wr-adapter.mjs

@@ -0,0 +1,104 @@
+// WhiteRoom practice test adapter (JavaScript starter, Node 20+, no dependencies).
+// Run it with: whiteroom practice run --adapter "node wr-adapter.mjs"
+// The CLI sends one practice task as a JSON line on stdin. You answer with
+// {"type":"tool_call",...} lines (each gets a {"type":"tool_result",...} line
+// back) and finish with one {"type":"final","output":"..."} line. Print your
+// own logs to stderr: stdout is only for these JSON lines.
+import { createInterface } from "node:readline";
+
+const lines = createInterface({ input: process.stdin })[Symbol.asyncIterator]();
+const receive = async () => JSON.parse((await lines.next()).value ?? "null");
+const send = (msg) => process.stdout.write(JSON.stringify(msg) + "\n");
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+let calls = 0;
+async function callTool(name, input) {
+  const id = `call-${++calls}`;
+  send({ type: "tool_call", id, name, input });
+  return (await receive()).result;
+}
+
+// The CLI sets only the variable of the provider the practice test uses.
+// It decides the API: chat completions for OpenAI and Azure OpenAI (where the
+// model is your deployment name), Anthropic's Messages API for Anthropic,
+// Claude on Azure (Foundry) and AWS Bedrock. And the header the key goes in.
+const KEYS = {
+  ANTHROPIC_API_KEY: (k) => ({ "x-api-key": k }),
+  ANTHROPIC_FOUNDRY_API_KEY: (k) => ({ "x-api-key": k }),
+  AWS_BEARER_TOKEN_BEDROCK: (k) => ({ authorization: `Bearer ${k}` }),
+  OPENAI_API_KEY: (k) => ({ authorization: `Bearer ${k}` }),
+  AZURE_OPENAI_API_KEY: (k) => ({ "api-key": k }),
+};
+const KEY_VAR = Object.keys(KEYS).find((v) => process.env[v]) ?? "ANTHROPIC_API_KEY";
+const anthropic = !["OPENAI_API_KEY", "AZURE_OPENAI_API_KEY"].includes(KEY_VAR);
+// The model to use when the practice task doesn't name one (cloud providers always name one).
+const DEFAULT_MODEL = anthropic ? "claude-haiku-4-5" : "gpt-4o-mini";
+const BLOCKED = "Stopped: one of my WhiteRoom controls blocked the model call.";
+const GONE = "Stopped: WhiteRoom closed this practice task.";
+
+// One model call through WhiteRoom; a final answer (text) if WhiteRoom stopped it.
+// Never follows a redirect, so the key only goes to WhiteRoom.
+// Waits and tries again when WhiteRoom or the provider asks it to, saying each reason once per practice task.
+// Each practice task runs in its own adapter process, so this is per task.
+const said = new Set();
+async function model(base_url, headers, body) {
+  const url = anthropic ? `${base_url}/v1/messages` : `${base_url}/chat/completions`;
+  const auth = { ...KEYS[KEY_VAR](process.env[KEY_VAR] ?? ""), ...(anthropic && { "anthropic-version": "2023-06-01" }) };
+  for (let tries = 1; ; tries++) {
+    const res = await fetch(url, { method: "POST", headers: { "content-type": "application/json", ...headers, ...auth },
+      body: JSON.stringify(body), redirect: "error", signal: AbortSignal.timeout(180_000) });
+    if (res.ok) return res.json();
+    const wr = (await res.json().catch(() => null))?.whiteroom;
+    const wait = res.status === 503 && wr ? ["WhiteRoom is switching servers. Waiting, then trying again.", Number(res.headers.get("retry-after") || 1)]
+      : res.status === 429 && wr ? ["WhiteRoom is saving a summary of your agent's memory. Waiting until it's saved.", 2]
+      : res.status === 403 && wr?.retryable ? ["One of your WhiteRoom controls is limiting calls. Waiting, then trying again.", 10]
+      : [429, 500, 502, 503, 529].includes(res.status) && !wr && tries < 5 ? ["Your model provider is busy. Waiting, then trying again.", 5 * tries] : null;
+    if (res.status === 403 && wr && !wait) return BLOCKED; // Blocked by one of the fleet's controls.
+    if (res.status === 410) return GONE; // The practice task's fleet is gone: WhiteRoom reran or ended it.
+    if (!wait || tries > 150) throw new Error(`The model call failed (HTTP ${res.status}).`);
+    if (!said.has(wait[0])) { said.add(wait[0]); console.error(wait[0]); }
+    await sleep(wait[1] * 1000);
+  }
+}
+
+// ── Replace this function with a call to your own agent. ────────────────
+// It gets the task, the test tools, WhiteRoom's address and the model your
+// dashboard chose (null: use your own); it calls tools with
+// callTool(name, input) and returns its final answer as text.
+async function runAgent({ task, tools, base_url, headers, model: chosen }) {
+  const MODEL = chosen || DEFAULT_MODEL;
+  const messages = [{ role: "user", content: task }];
+  const fns = tools.map((t) => ({ type: "function", function: { name: t.name, description: t.description, parameters: t.input_schema } }));
+  for (let turn = 0; turn < 40; turn++) {
+    if (anthropic) {
+      const r = await model(base_url, headers, { model: MODEL, max_tokens: 1024, tools, messages });
+      if (typeof r === "string") return r;
+      messages.push({ role: "assistant", content: r.content });
+      const uses = r.content.filter((b) => b.type === "tool_use");
+      if (!uses.length) return r.content.filter((b) => b.type === "text").map((b) => b.text).join("\n");
+      const results = [];
+      for (const u of uses) results.push({ type: "tool_result", tool_use_id: u.id, content: JSON.stringify(await callTool(u.name, u.input)) });
+      messages.push({ role: "user", content: results });
+    } else {
+      const r = await model(base_url, headers, { model: MODEL, tools: fns, messages });
+      if (typeof r === "string") return r;
+      const m = r.choices[0].message;
+      messages.push(m);
+      if (!m.tool_calls?.length) return m.content ?? "";
+      for (const c of m.tool_calls) {
+        const result = await callTool(c.function.name, JSON.parse(c.function.arguments || "{}"));
+        messages.push({ role: "tool", tool_call_id: c.id, content: JSON.stringify(result) });
+      }
+    }
+  }
+  return "Stopped: too many turns.";
+}
+
+try {
+  const msg = await receive();
+  if (msg?.type !== "task") throw new Error("Expected a task from the WhiteRoom CLI.");
+  send({ type: "final", output: await runAgent(msg) });
+  process.exit(0);
+} catch (err) {
+  console.error(err.message);
+  process.exit(1);
+}

package/starters/wr_adapter.py

@@ -0,0 +1,136 @@
+# WhiteRoom practice test adapter (Python starter, Python 3.9+, standard library only).
+# Run it with: whiteroom practice run --adapter "python3 wr_adapter.py"
+# The CLI sends one practice task as a JSON line on stdin. You answer with
+# {"type":"tool_call",...} lines (each gets a {"type":"tool_result",...} line
+# back) and finish with one {"type":"final","output":"..."} line. Print your
+# own logs to stderr: stdout is only for these JSON lines.
+import json, os, sys, time, urllib.error, urllib.request
+
+# The CLI sets only the variable of the provider the practice test uses.
+# It decides the API: chat completions for OpenAI and Azure OpenAI (where the
+# model is your deployment name), Anthropic's Messages API for Anthropic,
+# Claude on Azure (Foundry) and AWS Bedrock. And the header the key goes in.
+KEYS = {
+    "ANTHROPIC_API_KEY": lambda k: {"x-api-key": k},
+    "ANTHROPIC_FOUNDRY_API_KEY": lambda k: {"x-api-key": k},
+    "AWS_BEARER_TOKEN_BEDROCK": lambda k: {"authorization": "Bearer " + k},
+    "OPENAI_API_KEY": lambda k: {"authorization": "Bearer " + k},
+    "AZURE_OPENAI_API_KEY": lambda k: {"api-key": k},
+}
+KEY_VAR = next((v for v in KEYS if os.environ.get(v)), "ANTHROPIC_API_KEY")
+ANTHROPIC = KEY_VAR not in ("OPENAI_API_KEY", "AZURE_OPENAI_API_KEY")
+# The model to use when the practice task doesn't name one (cloud providers always name one).
+DEFAULT_MODEL = "claude-haiku-4-5" if ANTHROPIC else "gpt-4o-mini"
+BLOCKED = "Stopped: one of my WhiteRoom controls blocked the model call."
+GONE = "Stopped: WhiteRoom closed this practice task."
+calls = 0
+
+
+class NoRedirects(urllib.request.HTTPRedirectHandler):
+    # A redirect is an error, never followed, so the key only goes to WhiteRoom.
+    def redirect_request(self, *args):
+        return None
+
+
+open_url = urllib.request.build_opener(NoRedirects).open
+
+
+def receive():
+    line = sys.stdin.readline()
+    return json.loads(line) if line else None
+
+
+def send(msg):
+    sys.stdout.write(json.dumps(msg) + "\n")
+    sys.stdout.flush()
+
+
+def call_tool(name, args):
+    global calls
+    calls += 1
+    send({"type": "tool_call", "id": f"call-{calls}", "name": name, "input": args})
+    return receive()["result"]
+
+
+# Each practice task runs in its own adapter process, so this is per task.
+SAID = set()
+
+
+def model(base_url, headers, body):
+    """One model call through WhiteRoom; a final answer (text) if WhiteRoom stopped it.
+    Waits and tries again when WhiteRoom or the provider asks it to, saying each reason once per practice task."""
+    url = f"{base_url}/v1/messages" if ANTHROPIC else f"{base_url}/chat/completions"
+    auth = {**KEYS[KEY_VAR](os.environ.get(KEY_VAR, "")), **({"anthropic-version": "2023-06-01"} if ANTHROPIC else {})}
+    for tries in range(1, 152):
+        req = urllib.request.Request(url, json.dumps(body).encode(), {"content-type": "application/json", **headers, **auth})
+        try:
+            with open_url(req, timeout=180) as res:
+                return json.load(res)
+        except urllib.error.HTTPError as err:
+            try:
+                wr = json.load(err).get("whiteroom")
+            except Exception:
+                wr = None
+            if err.code == 503 and wr:
+                wait = ("WhiteRoom is switching servers. Waiting, then trying again.", float(err.headers.get("retry-after") or 1))
+            elif err.code == 429 and wr:
+                wait = ("WhiteRoom is saving a summary of your agent's memory. Waiting until it's saved.", 2)
+            elif err.code == 403 and wr and wr.get("retryable"):
+                wait = ("One of your WhiteRoom controls is limiting calls. Waiting, then trying again.", 10)
+            elif err.code == 403 and wr:
+                return BLOCKED  # Blocked by one of the fleet's controls.
+            elif err.code == 410:
+                return GONE  # The practice task's fleet is gone: WhiteRoom reran or ended it.
+            elif err.code in (429, 500, 502, 503, 529) and not wr and tries < 5:
+                wait = ("Your model provider is busy. Waiting, then trying again.", 5 * tries)
+            else:
+                raise RuntimeError(f"The model call failed (HTTP {err.code}).") from None
+            if wait[0] not in SAID:
+                SAID.add(wait[0])
+                print(wait[0], file=sys.stderr)
+            time.sleep(wait[1])
+    raise RuntimeError("The model call kept failing.")
+
+
+# ── Replace this function with a call to your own agent. ────────────────
+# It gets the task, the test tools, WhiteRoom's address and the model your
+# dashboard chose (None: use your own); it calls tools with
+# call_tool(name, input) and returns its final answer as text.
+def run_agent(task, tools, base_url, headers, chosen_model=None):
+    MODEL = chosen_model or DEFAULT_MODEL
+    messages = [{"role": "user", "content": task}]
+    fns = [{"type": "function", "function": {"name": t["name"], "description": t["description"], "parameters": t["input_schema"]}} for t in tools]
+    for _ in range(40):
+        if ANTHROPIC:
+            r = model(base_url, headers, {"model": MODEL, "max_tokens": 1024, "tools": tools, "messages": messages})
+            if isinstance(r, str):
+                return r
+            messages.append({"role": "assistant", "content": r["content"]})
+            uses = [b for b in r["content"] if b["type"] == "tool_use"]
+            if not uses:
+                return "\n".join(b["text"] for b in r["content"] if b["type"] == "text")
+            messages.append({"role": "user", "content": [
+                {"type": "tool_result", "tool_use_id": u["id"], "content": json.dumps(call_tool(u["name"], u["input"]))} for u in uses]})
+        else:
+            r = model(base_url, headers, {"model": MODEL, "tools": fns, "messages": messages})
+            if isinstance(r, str):
+                return r
+            m = r["choices"][0]["message"]
+            messages.append(m)
+            if not m.get("tool_calls"):
+                return m.get("content") or ""
+            for c in m["tool_calls"]:
+                result = call_tool(c["function"]["name"], json.loads(c["function"]["arguments"] or "{}"))
+                messages.append({"role": "tool", "tool_call_id": c["id"], "content": json.dumps(result)})
+    return "Stopped: too many turns."
+
+
+if __name__ == "__main__":
+    try:
+        msg = receive()
+        if not msg or msg.get("type") != "task":
+            raise RuntimeError("Expected a task from the WhiteRoom CLI.")
+        send({"type": "final", "output": run_agent(msg["task"], msg["tools"], msg["base_url"], msg["headers"], msg.get("model"))})
+    except Exception as err:
+        print(err, file=sys.stderr)
+        sys.exit(1)