@whiteroom-ai/cli 1.1.0 → 2.0.0

package/dist/practice/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/practice/text.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.0",
   "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)

package/src/index.ts

@@ -1,144 +0,0 @@
-#!/usr/bin/env node
-import { WhiteRoomClient, WhiteRoomError } from "@whiteroom-ai/sdk";
-
-const USAGE = `whiteroom — CLI for WhiteRoom agent governance
-
-Usage:
-  whiteroom health
-  whiteroom register <agent_id> [--fleet <id>] [--role <role>]
-  whiteroom pair <agent_a> <agent_b> [--fleet <id>]
-  whiteroom auto-pair [--fleet <id>]
-  whiteroom start <agent_id> [--fleet <id>]
-  whiteroom task <agent_id> <task_name> [--minutes <n>] [--tokens <n>] [--fleet <id>]
-  whiteroom check <agent_id> [--fleet <id>]
-  whiteroom handover <from_agent> <to_agent> [--fleet <id>]
-  whiteroom alarm <agent_id> [--fleet <id>]
-  whiteroom report [--fleet <id>]
-  whiteroom fleets
-  whiteroom login <fleet_token>
-
-Options:
-  --url <base_url>   Server URL (default: WHITEROOM_URL or http://localhost:3000)
-  --key <api_key>    API key (default: WHITEROOM_API_KEY)
-`;
-
-function parseArgs(argv: string[]) {
-  const args: string[] = [];
-  const flags: Record<string, string> = {};
-  for (let i = 0; i < argv.length; i++) {
-    if (argv[i].startsWith("--") && i + 1 < argv.length) {
-      flags[argv[i].slice(2)] = argv[++i];
-    } else {
-      args.push(argv[i]);
-    }
-  }
-  return { args, flags };
-}
-
-async function main() {
-  const { args, flags } = parseArgs(process.argv.slice(2));
-  const command = args[0];
-
-  if (!command || command === "help" || command === "--help") {
-    console.log(USAGE);
-    process.exit(0);
-  }
-
-  const client = new WhiteRoomClient({
-    baseUrl: flags.url ?? process.env.WHITEROOM_URL ?? "http://localhost:3000",
-    apiKey: flags.key ?? process.env.WHITEROOM_API_KEY,
-  });
-
-  try {
-    switch (command) {
-      case "health":
-        print(await client.health());
-        break;
-
-      case "register":
-        requireArg(args[1], "agent_id");
-        print(await client.registerAgent(args[1], { fleetId: flags.fleet, role: flags.role }));
-        break;
-
-      case "pair":
-        requireArg(args[1], "agent_a");
-        requireArg(args[2], "agent_b");
-        print(await client.pairAgents(args[1], args[2], flags.fleet));
-        break;
-
-      case "auto-pair":
-        print(await client.autoPair(flags.fleet));
-        break;
-
-      case "start":
-        requireArg(args[1], "agent_id");
-        print(await client.startWatch(args[1], flags.fleet));
-        break;
-
-      case "task":
-        requireArg(args[1], "agent_id");
-        requireArg(args[2], "task_name");
-        print(
-          await client.completeTask(args[1], args[2], {
-            fleetId: flags.fleet,
-            minutesSpent: flags.minutes ? Number(flags.minutes) : undefined,
-            tokensUsed: flags.tokens ? Number(flags.tokens) : undefined,
-          })
-        );
-        break;
-
-      case "check":
-        requireArg(args[1], "agent_id");
-        print(await client.checkWatch(args[1], flags.fleet));
-        break;
-
-      case "handover":
-        requireArg(args[1], "from_agent");
-        requireArg(args[2], "to_agent");
-        print(await client.initiateHandover(args[1], args[2], { fleetId: flags.fleet }));
-        break;
-
-      case "alarm":
-        requireArg(args[1], "agent_id");
-        print(await client.fireAlarm(args[1], flags.fleet));
-        break;
-
-      case "report":
-        print(await client.fleetReport(flags.fleet));
-        break;
-
-      case "fleets":
-        print(await client.listFleets());
-        break;
-
-      case "login":
-        requireArg(args[1], "fleet_token");
-        print(await client.tokenLogin(args[1]));
-        break;
-
-      default:
-        console.error(`Unknown command: ${command}\n`);
-        console.log(USAGE);
-        process.exit(1);
-    }
-  } catch (e) {
-    if (e instanceof WhiteRoomError) {
-      console.error(`Error ${(e as WhiteRoomError).status}: ${(e as WhiteRoomError).message}`);
-      process.exit(1);
-    }
-    throw e;
-  }
-}
-
-function requireArg(value: string | undefined, name: string): asserts value is string {
-  if (!value) {
-    console.error(`Missing required argument: <${name}>`);
-    process.exit(1);
-  }
-}
-
-function print(data: unknown) {
-  console.log(JSON.stringify(data, null, 2));
-}
-
-main();

package/tsconfig.json

@@ -1,16 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "declaration": true,
-    "sourceMap": true
-  },
-  "include": ["src"],
-  "exclude": ["node_modules", "dist"]
-}