@whiteroom-ai/cli 1.1.0 → 2.0.1

package/dist/practice/text.d.ts

@@ -0,0 +1,107 @@
+export declare const DASHBOARD = "https://app.whiteroom.tech/sandbox";
+/** Remembers a secret (provider key, run code, session) so `clean` never prints it. */
+export declare function hideSecret(s: string): void;
+/** Text safe to print: no terminal control characters, no known secret. */
+export declare function clean(s: string): string;
+export declare const say: (s: string) => boolean;
+export declare const warn: (s: string) => boolean;
+export declare const plural: (n: number, one: string, many?: string) => string;
+/** A way the command ends: the exit code (§8) and what to print. */
+export interface Ending {
+    code: 0 | 1 | 2 | 3;
+    lines: string[];
+    /** The test's result (printed on stdout), not a refusal. */
+    result?: true;
+    /** The run finished, but the reply didn't carry its result: ask tasks/next for it. */
+    replay?: true;
+}
+export declare const ending: (code: Ending["code"], ...lines: string[]) => Ending;
+export declare const copy: {
+    ignoringUrl: string;
+    keyInUse: (v: string, key: string) => string;
+    host: (host: string) => string;
+    /** `tasks`: the practice tasks over all runs; `controls`: whether a control check makes calls. */
+    started: (tasks: number, runs: number, controls: boolean) => string;
+    restart: string;
+    lostTask: string;
+    offline: string;
+    deadline: string;
+    pressAgain: string;
+    badCode: string;
+    needCode: string;
+    needKey: string;
+    bothKeys: (vars: string[]) => string;
+    noKey: (keyEnv?: string) => string;
+    badKeyEnv: (v: string) => string;
+    shortTermKey: string;
+    keyTwice: (from: string | null, length: number) => string;
+    keySpaces: (from: string | null) => string;
+    node: (v: string) => string;
+    windows: string;
+    badUrl: string;
+    adapterMissing: (cmd: string, why: string) => string;
+    keyMismatch: (v: string, left: number, fleet?: string | null) => string;
+    /** §17: a run on a Fleet key provider key names that key as Fleet key does; a new test is the way to pick another. */
+    providerKeyMismatch: (from: string | null, key: string, provider: string, hint: string | null) => string;
+    lastTry: string;
+    codeInvalid: string;
+    busy: string;
+    unavailable: string;
+    unreachable: string;
+    cliOutdated: string;
+    redirected: string;
+    refused: string;
+    otherHost: string;
+    engineUpdate: (kept: number) => string;
+    endedByOwner: string;
+    endedBeforeStart: string;
+    expired: string;
+    callCap: string;
+    noModelCalls: string;
+    engineError: string;
+    finished: (verdict: unknown) => string;
+    sessionGone: string;
+    cancelled: string;
+    adapterCrashed: (code: string, tail: string[]) => string[];
+    adapterBroke: (why: string) => string;
+    keptResults: string;
+    keptUnconfirmed: string;
+    tooManyTools: string;
+    badTool: string;
+    noTerminal: string;
+    stoppedEarly: string;
+};
+export interface Check {
+    id: string;
+    label: string;
+    scenario?: string;
+    status: "passed" | "failed" | "not_tested" | "unsupported" | "error";
+    required: boolean;
+    testProblem?: boolean;
+    summary?: string | null;
+    fix?: string | null;
+    mode?: string | null;
+    /** Control checks: whether the rule is set up for the agent under test ("off": Off in Controls; "not_set_up": it doesn't cover the agent). */
+    setup?: "ok" | "not_set_up" | "off";
+    notCoveredAgent?: string;
+}
+export interface Report {
+    verdict: "passed" | "not_passed" | "incomplete";
+    runs: number;
+    sample: boolean;
+    scope: string[] | null;
+    checks: Check[];
+}
+/** --require's comma list as row ids, or the usage problem (an unknown id, or none). */
+export declare function parseRequire(value: string): string[] | {
+    problem: string;
+};
+/**
+ * Why a required row doesn't count as passed, or null when it does: Passed
+ * in Enforce. A row passes when every check of a rule set up for the agent
+ * passed and none failed; a guardrail must also be in Enforce on every rule
+ * that counted (Watch, Not checked and Not set up all fail, D6).
+ */
+export declare function requiredRowProblem(r: Report, rowId: string): string | null;
+/** The results screen in the terminal, and its exit code: 0 Passed, 1 Didn't pass, 3 Didn't finish. With --require, a required row not Passed in Enforce turns a pass into 1. */
+export declare function results(r: Report, require?: readonly string[]): Ending;

package/dist/practice/text.js

@@ -0,0 +1,185 @@
+// What the practice commands print (spec §8, §10, Appendix D). Plain words
+// only: no internal names, no engine reason codes. Every way a run ends
+// names the dashboard and the button to click there. Task, status, provider
+// and refusal words are the engine's catalog's.
+import { CATALOG } from "./catalog.js";
+export const DASHBOARD = "https://app.whiteroom.tech/sandbox";
+const KEY_VARS = Object.values(CATALOG.providers).map((p) => p.keyVar);
+/** Control, C1 and bidi characters, which could rewrite what the terminal shows. Tabs and newlines stay. */
+const UNSAFE = /[\u0000-\u0008\u000b-\u001f\u007f-\u009f\u061c\u200e\u200f\u202a-\u202e\u2066-\u2069]/g;
+const secrets = new Set();
+/** Remembers a secret (provider key, run code, session) so `clean` never prints it. */
+export function hideSecret(s) {
+    if (s.length >= 8)
+        secrets.add(s);
+}
+/** Text safe to print: no terminal control characters, no known secret. */
+export function clean(s) {
+    let out = s.replace(UNSAFE, "");
+    for (const x of secrets)
+        out = out.split(x).join("[hidden]");
+    return out;
+}
+export const say = (s) => process.stdout.write(clean(s) + "\n");
+export const warn = (s) => process.stderr.write(clean(s) + "\n");
+export const plural = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
+/** "A, B and C". */
+const list = (xs, and = "and") => (xs.length > 1 ? `${xs.slice(0, -1).join(", ")} ${and} ${xs[xs.length - 1]}` : xs.join(""));
+const button = (name) => `In the dashboard (${DASHBOARD}), click ${name}`;
+export const ending = (code, ...lines) => ({ code, lines });
+export const copy = {
+    ignoringUrl: "Ignoring WHITEROOM_URL: practice tests always run on WhiteRoom.",
+    keyInUse: (v, key) => `Using the key in ${v} (ends ${key.slice(-4)}).`,
+    host: (host) => `Sending your key to ${host} to start the practice test.`,
+    /** `tasks`: the practice tasks over all runs; `controls`: whether a control check makes calls. */
+    started: (tasks, runs, controls) => {
+        const perRun = Math.round(tasks / runs);
+        const run = [perRun > 0 && plural(perRun, "practice task"), controls && "a check of your controls"].filter(Boolean).join(" and ");
+        return `Practice test started: ${runs > 1 ? `${runs} runs, each ${run}` : run}. Keep this terminal open and your computer awake.`;
+    },
+    restart: "WhiteRoom restarted this practice task, so it starts again. This doesn't count against your agent.",
+    lostTask: "Lost contact with WhiteRoom during this practice task, so it starts again. This doesn't count against your agent.",
+    offline: "Lost connection to WhiteRoom. Trying again for up to 5 minutes.",
+    deadline: "Your agent didn't finish this practice task in time, so it was stopped.",
+    pressAgain: "Press Ctrl+C again to end the practice test. Finished practice tasks are kept.",
+    badCode: "That isn't a run code. Copy it again from the dashboard (it starts with wrrt_).",
+    needCode: "Paste the run code from the dashboard (it won't show): ",
+    needKey: "Paste the model provider key your agent uses (it won't show): ",
+    bothKeys: (vars) => `${vars.length === 2 ? `Both ${vars[0]} and ${vars[1]} are` : `${list(vars)} are all`} set. Add --key-env with the one your agent uses (for example --key-env ${vars[0]}), then run the command again. Nothing was sent.`,
+    noKey: (keyEnv) => `Set the key your agent uses (${keyEnv ?? list(KEY_VARS, "or")}), then run the command again.`,
+    badKeyEnv: (v) => `--key-env must name a provider key variable (${list(KEY_VARS, "or")}), not ${v}.`,
+    shortTermKey: CATALOG.keyRefusals.short_term_key,
+    keyTwice: (from, length) => `${from ? `The key in ${from}` : "The key"} looks pasted twice (${length} characters, the same key two times). Nothing was sent. Set it again with a single paste.`,
+    keySpaces: (from) => `${from ? `The key in ${from}` : "The key"} has spaces or line breaks inside it. Nothing was sent. Copy it again in one piece.`,
+    node: (v) => `Needs Node 20 or later (you have ${v}).`,
+    windows: "Practice tests run on macOS and Linux for now. Run the command there, or in WSL.",
+    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 or charged, and your run code still works.`,
+    keyMismatch: (v, left, fleet = null) => `This key isn't the one your agent uses with ${fleet ?? "this fleet"}. Nothing was charged, and your run code still works (${plural(left, "more try", "more tries")}). Set ${v} to the right key, then run the same command again.`,
+    /** §17: a run on a Fleet key provider key names that key as Fleet key does; a new test is the way to pick another. */
+    providerKeyMismatch: (from, key, provider, hint) => `${from ? `The key in ${from}` : "The key you pasted"} (ends ${key.slice(-4)}) isn't the ${provider} key saved on Fleet key${hint ? ` (key ending ${hint})` : ""}. Nothing was charged. If you've changed keys, add the new one on Fleet key, then start a new test in the dashboard and pick that key.`,
+    lastTry: `That was the last try, so this run code no longer works. Nothing was charged. ${button("Get a new run code")}, then set the right key and run the command again.`,
+    codeInvalid: `This run code doesn't work any more: it expired or was already used. ${button("Get a new run code")}, then run the command again.`,
+    busy: "Practice tests are busy right now. Try again in a few minutes. Your run code still works.",
+    unavailable: "Practice tests aren't available yet. Try again later.",
+    unreachable: "Couldn't reach WhiteRoom. Check your connection, then run the command again.",
+    cliOutdated: "WhiteRoom sent something this CLI doesn't understand. Update the CLI, then run the test again.",
+    redirected: "WhiteRoom's server tried to send the CLI to another address, so it stopped there. Nothing was sent anywhere else. Try again in a few minutes.",
+    refused: `WhiteRoom refused the CLI's request. ${button("Start test")} to run it again.`,
+    otherHost: "WhiteRoom sent an address on another host, so the CLI stopped before sending your key there.",
+    engineUpdate: (kept) => `WhiteRoom was updated during your practice test, so it stopped. ${kept ? `${plural(kept, "finished practice task")} kept. ` : ""}${button("Start test")} to run it again.`,
+    endedByOwner: `The practice test was ended from the dashboard. Finished practice tasks were kept. ${button("Start test")} to test again.`,
+    endedBeforeStart: `The practice test was ended from the dashboard before it started. ${button("Start test")} to test again.`,
+    expired: `This practice test has ended: it lost contact with this computer or ran out of time. ${button("Start test")} to run it again.`,
+    callCap: `Stopped at this test's model-call limit after WhiteRoom had to rerun a task (not your agent). ${button("Start test")} to run it again.`,
+    noModelCalls: `Stopped: your agent didn't make any model calls through WhiteRoom in 2 practice tasks in a row. Check your adapter sends its calls to the base_url the CLI gives it. ${button("Start test")} to run it again.`,
+    engineError: `WhiteRoom couldn't finish working out the result (not your agent). ${button("Start test")} to run a new test.`,
+    finished: (verdict) => {
+        const label = typeof verdict === "string" && Object.hasOwn(CATALOG.verdictLabels, verdict) ? `: ${CATALOG.verdictLabels[verdict]}` : "";
+        return `The practice test finished${label}. See the results in the dashboard (${DASHBOARD}), under Past tests.`;
+    },
+    sessionGone: `WhiteRoom no longer knows this practice test. ${button("Start test")} to run it again.`,
+    cancelled: `Practice test ended. Finished practice tasks were kept. ${button("Start test")} to run it again.`,
+    adapterCrashed: (code, tail) => [
+        `Your adapter stopped before it finished the practice task (${code}).`,
+        ...(tail.length ? ["Its last lines:", ...tail.map((l) => `  ${l}`)] : []),
+        "Run the adapter on its own to see why.",
+    ],
+    adapterBroke: (why) => `Your adapter ${why}, so it was stopped.`,
+    keptResults: `The test ended early. The practice tasks your agent finished are in the results: see the dashboard (${DASHBOARD}), under Past tests.`,
+    keptUnconfirmed: `The test ended early. WhiteRoom didn't confirm it kept the results: check Past tests in the dashboard (${DASHBOARD}).`,
+    tooManyTools: "made more test-tool calls than a practice task allows",
+    badTool: "sent a tool call WhiteRoom couldn't accept",
+    noTerminal: "There's no terminal to paste the run code into. Pipe it in with --code-stdin instead.",
+    stoppedEarly: "Stopped before the practice test started.",
+};
+const STATUS = CATALOG.statusLabels;
+// ── --require (pre-flight D6): rows CI insists on ────────────────────────
+const ROW_IDS = CATALOG.rows.map((x) => x.id);
+/** --require's comma list as row ids, or the usage problem (an unknown id, or none). */
+export function parseRequire(value) {
+    const ids = [...new Set(value.split(",").map((s) => s.trim()).filter(Boolean))];
+    const unknown = ids.filter((id) => !ROW_IDS.includes(id));
+    if (!ids.length || unknown.length) {
+        return { problem: `${unknown.length ? `Unknown check for --require: ${unknown.join(", ")}.` : "--require needs at least one check."} Use any of: ${ROW_IDS.join(", ")}.` };
+    }
+    return ids;
+}
+const isMember = (id, prefix) => (prefix.endsWith(".") ? id.startsWith(prefix) : id === prefix || id.startsWith(`${prefix}.`));
+const setUp = (c) => (c.setup ?? "ok") === "ok" && !c.notCoveredAgent;
+/**
+ * Why a required row doesn't count as passed, or null when it does: Passed
+ * in Enforce. A row passes when every check of a rule set up for the agent
+ * passed and none failed; a guardrail must also be in Enforce on every rule
+ * that counted (Watch, Not checked and Not set up all fail, D6).
+ */
+export function requiredRowProblem(r, rowId) {
+    const row = CATALOG.rows.find((x) => x.id === rowId);
+    const members = r.checks.filter((c) => row.members.some((m) => isMember(c.id, m)));
+    if (members.some((c) => c.status === "failed"))
+        return CATALOG.rowStatusLabels.failed;
+    const live = members.filter(setUp);
+    if (!live.length) {
+        // No rule (Pause and Stop need none), or its rules are Off or don't cover the agent.
+        const noRule = !members.length && row.members.every((m) => m.startsWith("ctl.")) && row.id !== "pause_stop";
+        return members.length || noRule ? CATALOG.rowStatusLabels.not_set_up : CATALOG.rowStatusLabels.not_checked;
+    }
+    if (!live.every((c) => c.status === "passed"))
+        return CATALOG.rowStatusLabels.not_checked;
+    const notEnforced = live.some((c) => c.mode != null && c.mode !== CATALOG.controls.modes.enforce);
+    return notEnforced ? `${CATALOG.rowStatusLabels.passed} in ${CATALOG.controls.modes.watch}, not ${CATALOG.controls.modes.enforce}` : null;
+}
+/** The results screen in the terminal, and its exit code: 0 Passed, 1 Didn't pass, 3 Didn't finish. With --require, a required row not Passed in Enforce turns a pass into 1. */
+export function results(r, require = []) {
+    const required = r.checks.filter((c) => c.required);
+    const runs = plural(r.runs, "run");
+    const failed = required.filter((c) => c.status === "failed");
+    const open = required.filter((c) => c.status !== "passed");
+    const scope = r.scope && [...new Set(required.map((c) => c.scenario).filter(Boolean))].join(", ");
+    const lines = [""];
+    let code;
+    if (r.verdict === "passed") {
+        code = 0;
+        lines.push(`${CATALOG.verdictLabels.passed} · ${scope ? `${scope} only` : `all ${plural(required.length, "check")}`} · ${runs}`);
+    }
+    else if (r.verdict === "not_passed") {
+        code = 1;
+        lines.push(`${CATALOG.verdictLabels.not_passed} · ${plural(failed.length, "check")} failed`);
+    }
+    else {
+        code = 3;
+        const ours = open.length > 0 && open.every((c) => c.testProblem);
+        lines.push(`${CATALOG.verdictLabels.incomplete} · ${open.length ? `${plural(open.length, "check")} couldn't run` : "no checks could run"}${ours ? " (not your agent)" : ""}`);
+    }
+    if (r.sample)
+        lines.push("This was WhiteRoom's sample agent: it checks your controls and this setup, not your own agent.");
+    else if (r.runs === 1 && code === 0)
+        lines.push("One run shows your agent can pass. Run it 3 times to see that it passes every time.");
+    lines.push("");
+    for (const c of r.checks) {
+        const name = c.mode ? `${c.label} · ${c.mode}` : c.label;
+        // A control row says what happened; a row that wasn't checked says why instead of a status.
+        if (c.status === "unsupported" && c.summary)
+            lines.push(`  ${name}: ${c.summary}`);
+        else
+            lines.push(`  ${STATUS[c.status]}: ${name}${c.id.startsWith("ctl") && c.summary ? ` (${c.summary})` : ""}`);
+    }
+    const fixes = (code === 1 ? failed : code === 3 ? open : []).filter((c) => c.fix);
+    if (fixes.length) {
+        lines.push("", code === 3 ? "What stopped the test" : "What to fix");
+        for (const c of fixes)
+            lines.push(`  ${c.label}: ${c.fix}`);
+    }
+    const next = code === 1 ? "Rerun failed checks" : code === 3 ? "Rerun checks that didn't run" : !r.sample && r.runs === 1 ? "Run it 3 times" : "Past tests";
+    const missed = require.map((id) => ({ id, why: requiredRowProblem(r, id) })).filter((x) => x.why);
+    if (missed.length) {
+        lines.push("", "Required checks (--require) that didn't pass");
+        for (const m of missed)
+            lines.push(`  ${CATALOG.rows.find((x) => x.id === m.id).name}: ${m.why}`);
+        if (code === 0)
+            code = 1;
+    }
+    lines.push("", CATALOG.disclaimer, next === "Past tests" ? `See the full result in the dashboard (${DASHBOARD}), under Past tests.` : `${button(next)}.`);
+    return { code, lines, result: true };
+}
+//# sourceMappingURL=text.js.map

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/dist/sandbox/index.d.ts

@@ -0,0 +1,2 @@
+export declare const SANDBOX_USAGE = "whiteroom sandbox \u2014 run your agent from the Sandbox page\n\nUsage:\n  whiteroom sandbox listen --adapter \"<command>\" [--code-stdin] [--url <https url>]\n\n  listen    Connects this computer to your Sandbox with the helper code from\n            the Sandbox page (Run agent), then runs each task sent from that\n            page through your adapter until you press Ctrl+C. Your agent's\n            calls go to your Sandbox URL: set its base URL first, for example\n            export ANTHROPIC_BASE_URL=<Sandbox URL>.\n\nOptions:\n  --adapter \"<command>\"  The command that starts your agent's adapter, e.g. \"node wr-adapter.mjs\"\n                         (the same JSON-lines contract as practice tests: whiteroom practice adapter --lang js)\n  --code-stdin           Read the helper code from stdin instead of asking for it\n  --url <https url>      Only for testing WhiteRoom itself (a whiteroom.tech address or localhost)\n\nExit codes: 0 stopped with Ctrl+C, 2 a setup or usage problem, 3 the session ended (get a new code).\n";
+export declare function sandbox(argv: string[]): Promise<number>;

package/dist/sandbox/index.js

@@ -0,0 +1,62 @@
+// `whiteroom sandbox`: the helper behind the Sandbox page's Run agent button.
+// Usage problems exit 2; so does anything unexpected.
+import { parseArgs } from "node:util";
+import { listen } from "./listen.js";
+import { warn } from "../practice/text.js";
+export const SANDBOX_USAGE = `whiteroom sandbox — run your agent from the Sandbox page
+
+Usage:
+  whiteroom sandbox listen --adapter "<command>" [--code-stdin] [--url <https url>]
+
+  listen    Connects this computer to your Sandbox with the helper code from
+            the Sandbox page (Run agent), then runs each task sent from that
+            page through your adapter until you press Ctrl+C. Your agent's
+            calls go to your Sandbox URL: set its base URL first, for example
+            export ANTHROPIC_BASE_URL=<Sandbox URL>.
+
+Options:
+  --adapter "<command>"  The command that starts your agent's adapter, e.g. "node wr-adapter.mjs"
+                         (the same JSON-lines contract as practice tests: whiteroom practice adapter --lang js)
+  --code-stdin           Read the helper code from stdin instead of asking for it
+  --url <https url>      Only for testing WhiteRoom itself (a whiteroom.tech address or localhost)
+
+Exit codes: 0 stopped with Ctrl+C, 2 a setup or usage problem, 3 the session ended (get a new code).
+`;
+function usage(problem) {
+    if (!problem)
+        return process.stdout.write(SANDBOX_USAGE), 0;
+    warn(`${problem}\nRun whiteroom sandbox --help to see the commands.`);
+    return 2;
+}
+export async function sandbox(argv) {
+    const [sub, ...rest] = argv;
+    if (!sub || sub === "--help" || sub === "-h" || sub === "help")
+        return usage();
+    if (sub !== "listen")
+        return usage(`Unknown sandbox command: ${sub}`);
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args: rest,
+            strict: true,
+            allowPositionals: false,
+            options: { adapter: { type: "string" }, "code-stdin": { type: "boolean" }, url: { type: "string" }, help: { type: "boolean", short: "h" } },
+        }));
+    }
+    catch (err) {
+        return usage(err.message);
+    }
+    if (values.help)
+        return usage();
+    if (!values.adapter?.trim())
+        return usage("--adapter needs the command that starts your adapter.");
+    try {
+        return await listen({ adapter: values.adapter, codeStdin: !!values["code-stdin"], url: values.url });
+    }
+    catch (err) {
+        // Any adapter still running is killed as the process exits (adapter.ts).
+        warn(`Something went wrong in the CLI: ${err?.message ?? String(err)}`);
+        return 2;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/sandbox/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sDAAsD;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;CAkB5B,CAAC;AAEF,SAAS,KAAK,CAAC,OAAgB;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IAC5D,IAAI,CAAC,GAAG,OAAO,qDAAqD,CAAC,CAAC;IACtE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAc;IAC1C,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,KAAK,EAAE,CAAC;IAC/E,IAAI,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC;IACtE,IAAI,MAAkF,CAAC;IACvF,IAAI,CAAC;QACH,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;YACtB,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,IAAI;YACZ,gBAAgB,EAAE,KAAK;YACvB,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;SAC5I,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI;QAAE,OAAO,KAAK,EAAE,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC,uDAAuD,CAAC,CAAC;IACnG,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IACvG,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,yEAAyE;QACzE,IAAI,CAAC,oCAAqC,GAAa,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnF,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/sandbox/listen.d.ts

@@ -0,0 +1,57 @@
+import { type Outcome } from "../practice/adapter.js";
+export declare const HELPER_CODE: RegExp;
+/** How long one task may run before its adapter is stopped. */
+export declare const TASK_MS: number;
+export declare const sandboxCopy: {
+    connected: string;
+    needCode: string;
+    badCode: string;
+    noTerminal: string;
+    noSandboxUrl: string;
+    severalSandboxUrls: (vars: string[]) => string;
+    otherSandboxHost: (urlHost: string, host: string) => string;
+    badUrl: string;
+    adapterMissing: (cmd: string, why: string) => string;
+    windows: string;
+    codeInvalid: string;
+    keyMismatch: (left: number) => string;
+    notConnected: string;
+    unavailable: string;
+    unreachable: string;
+    redirected: string;
+    outdated: string;
+    otherHost: string;
+    sessionEnded: Record<string, string>;
+    stopped: string;
+    cancelled: string;
+    task: (n: number, prompt: string) => string;
+    taskDone: (n: number) => string;
+    taskFailed: (n: number, why: string) => string;
+    resultNotSent: (n: number) => string;
+    noTools: string;
+};
+export interface ListenArgs {
+    adapter: string;
+    codeStdin: boolean;
+    url?: string;
+}
+/** The Sandbox URL the user's agent points at, found in its environment: the variable, WhiteRoom's origin and the Sandbox key. */
+export declare function findSandboxUrl(env: NodeJS.ProcessEnv): Array<{
+    variable: string;
+    origin: string;
+    key: string;
+}>;
+/** The adapter's environment: the user's own (their agent's settings and keys), without WhiteRoom's. */
+export declare function helperEnv(parent: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/** This computer's name as the Sandbox page shows it ("Helper connected · <host>"). */
+export declare function helperHost(name?: string): string;
+/**
+ * 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 declare function taskResult(out: Outcome, taskMs?: number): {
+    ok: boolean;
+    summary: string;
+};
+export declare function listen(a: ListenArgs): Promise<number>;