@whiteroom-ai/cli 1.1.0 → 2.0.0

package/dist/practice/engine.d.ts

@@ -0,0 +1,50 @@
+/** How long the CLI keeps retrying while WhiteRoom can't be reached or asks it to wait. */
+export declare const OFFLINE_MS: number;
+export declare const sleep: (ms: number, signal?: AbortSignal) => Promise<void>;
+/** Waits until one more request keeps the last minute at or under PER_MINUTE. */
+export declare function pace(): Promise<void>;
+/** A reply from WhiteRoom; `body` is null when it wasn't JSON. */
+export interface Reply {
+    status: number;
+    /** The route's JSON, read field by field by the caller. */
+    body: any;
+}
+/**
+ * A reply that tried to send the CLI somewhere else. Requests that carry the
+ * key or the session never follow a redirect (`redirect: "error"`): nothing is
+ * resent, and the caller stops with plain copy.
+ */
+export declare const REDIRECTED = 0;
+export declare const isRedirectError: (err: unknown) => boolean;
+/** WhiteRoom couldn't be reached (or kept asking the CLI to wait) for OFFLINE_MS. */
+export declare class Unreachable extends Error {
+}
+/** The session's stop signal fired (Ctrl+C, or WhiteRoom ended the test). */
+export declare class Stopped extends Error {
+}
+export declare class Engine {
+    readonly origin: string;
+    private readonly offlineMs;
+    private readonly timeoutMs;
+    session: string | null;
+    /** Aborts any request in flight when the session stops. */
+    signal: AbortSignal | null;
+    /** `offlineMs`: how long to keep retrying; `timeoutMs`: one request, body included (tests shorten both). */
+    constructor(origin: string, offlineMs?: number, timeoutMs?: number);
+    /** One request, its body read inside the same timeout: a server that stalls mid-body fails like one that never answers. */
+    private send;
+    /**
+     * Ends the run (best effort, one try, not paced): after Ctrl+C, or a crashed adapter
+     * (`keepResults`: with a result over the tasks done). Null if WhiteRoom didn't answer.
+     */
+    cancel(keepResults?: boolean): Promise<Reply | null>;
+    /**
+     * POSTs to a route. WhiteRoom's waits (503, a 429 that isn't an answer) are
+     * retried as Retry-After says. `retryNetwork`: also retry a network error or
+     * another 5xx, for requests that are safe to repeat; otherwise those throw
+     * Unreachable. A redirect is returned as status REDIRECTED, never followed.
+     */
+    post(path: string, body: unknown, o?: {
+        retryNetwork?: boolean;
+    }): Promise<Reply>;
+}

package/dist/practice/engine.js

@@ -0,0 +1,147 @@
+// The CLI's requests to WhiteRoom's /api/readiness routes (spec §4, §7):
+// plain fetch, paced to 60 a minute (§4 Run), with WhiteRoom's own waits
+// (an IP-limit 429, a 503 while it switches servers) retried.
+import { copy, warn } from "./text.js";
+/** The CLI's own requests stay at or under this many a minute; WhiteRoom allows 120 per IP. */
+const PER_MINUTE = 60;
+/** How long the CLI keeps retrying while WhiteRoom can't be reached or asks it to wait. */
+export const OFFLINE_MS = 5 * 60_000;
+const REQUEST_TIMEOUT_MS = 90_000;
+const sent = [];
+export const sleep = (ms, signal) => new Promise((resolve) => {
+    const done = () => {
+        clearTimeout(t);
+        signal?.removeEventListener("abort", done);
+        resolve();
+    };
+    const t = setTimeout(done, ms);
+    signal?.addEventListener("abort", done, { once: true });
+});
+/** Waits until one more request keeps the last minute at or under PER_MINUTE. */
+export async function pace() {
+    for (;;) {
+        const now = Date.now();
+        while (sent.length && sent[0] <= now - 60_000)
+            sent.shift();
+        if (sent.length < PER_MINUTE) {
+            sent.push(now);
+            return;
+        }
+        await sleep(sent[0] + 60_000 - now);
+    }
+}
+/**
+ * A reply that tried to send the CLI somewhere else. Requests that carry the
+ * key or the session never follow a redirect (`redirect: "error"`): nothing is
+ * resent, and the caller stops with plain copy.
+ */
+export const REDIRECTED = 0;
+export const isRedirectError = (err) => /redirect/i.test(String(err?.cause?.message ?? ""));
+/** WhiteRoom couldn't be reached (or kept asking the CLI to wait) for OFFLINE_MS. */
+export class Unreachable extends Error {
+}
+/** The session's stop signal fired (Ctrl+C, or WhiteRoom ended the test). */
+export class Stopped extends Error {
+}
+/** 429s that are answers, not a request to wait. */
+const ANSWERS_429 = new Set(["busy", "tool_limit", "starts_today", "owner_busy"]);
+export class Engine {
+    origin;
+    offlineMs;
+    timeoutMs;
+    session = null;
+    /** Aborts any request in flight when the session stops. */
+    signal = null;
+    /** `offlineMs`: how long to keep retrying; `timeoutMs`: one request, body included (tests shorten both). */
+    constructor(origin, offlineMs = OFFLINE_MS, timeoutMs = REQUEST_TIMEOUT_MS) {
+        this.origin = origin;
+        this.offlineMs = offlineMs;
+        this.timeoutMs = timeoutMs;
+    }
+    /** One request, its body read inside the same timeout: a server that stalls mid-body fails like one that never answers. */
+    async send(path, body, timeoutMs, signal) {
+        const ac = new AbortController();
+        const abort = () => ac.abort();
+        const timer = setTimeout(abort, timeoutMs);
+        signal?.addEventListener("abort", abort, { once: true });
+        try {
+            const res = await fetch(this.origin + path, {
+                method: "POST",
+                headers: { "content-type": "application/json", ...(this.session && { authorization: `Bearer ${this.session}` }) },
+                body: JSON.stringify(body),
+                redirect: "error",
+                signal: ac.signal,
+            });
+            const text = await res.text();
+            let json = null;
+            try {
+                json = JSON.parse(text);
+            }
+            catch {
+                // Not JSON: the caller reads a null body.
+            }
+            return { status: res.status, retryAfter: res.headers.get("retry-after"), json };
+        }
+        finally {
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", abort);
+        }
+    }
+    /**
+     * Ends the run (best effort, one try, not paced): after Ctrl+C, or a crashed adapter
+     * (`keepResults`: with a result over the tasks done). Null if WhiteRoom didn't answer.
+     */
+    async cancel(keepResults = false) {
+        return this.send("/api/readiness/cancel", keepResults ? { keepResults } : {}, 5_000, null).then((r) => ({ status: r.status, body: r.json }), () => null);
+    }
+    /**
+     * POSTs to a route. WhiteRoom's waits (503, a 429 that isn't an answer) are
+     * retried as Retry-After says. `retryNetwork`: also retry a network error or
+     * another 5xx, for requests that are safe to repeat; otherwise those throw
+     * Unreachable. A redirect is returned as status REDIRECTED, never followed.
+     */
+    async post(path, body, o = {}) {
+        const started = Date.now();
+        let warned = false;
+        for (;;) {
+            await pace();
+            if (this.signal?.aborted)
+                throw new Stopped();
+            let res;
+            try {
+                res = await this.send(path, body, this.timeoutMs, this.signal);
+            }
+            catch (err) {
+                if (this.signal?.aborted)
+                    throw new Stopped();
+                if (isRedirectError(err))
+                    return { status: REDIRECTED, body: { reason: "redirected" } };
+                if (!o.retryNetwork || Date.now() - started > this.offlineMs)
+                    throw new Unreachable();
+                if (!warned)
+                    warn(copy.offline);
+                warned = true;
+                await sleep(Math.min(5_000, this.offlineMs), this.signal ?? undefined);
+                continue;
+            }
+            const { json } = res;
+            if (res.status >= 500 && res.status !== 503) {
+                // It may have been handled: only a request that is safe to repeat is sent again.
+                if (!o.retryNetwork || Date.now() - started > this.offlineMs)
+                    throw new Unreachable();
+                await sleep(Math.min(5_000, this.offlineMs), this.signal ?? undefined);
+                continue;
+            }
+            const wait = res.status === 503 || (res.status === 429 && !ANSWERS_429.has(json?.reason));
+            if (wait) {
+                if (Date.now() - started > this.offlineMs)
+                    throw new Unreachable();
+                const after = res.retryAfter;
+                await sleep(after === null ? 5_000 : Math.min(Math.max(Number(after) || 0, 1), 60) * 1000, this.signal ?? undefined);
+                continue;
+            }
+            return { status: res.status, body: json };
+        }
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/practice/engine.js.map

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

package/dist/practice/index.d.ts

@@ -0,0 +1,2 @@
+export declare const PRACTICE_USAGE = "whiteroom practice \u2014 run a WhiteRoom practice test on your agent\n\nUsage:\n  whiteroom practice run [--adapter \"<command>\"] [--key-env <VAR>] [--code-stdin] [--url <https url>]\n  whiteroom practice adapter --lang js|python\n\n  run       Starts the practice test from the run code shown in the dashboard.\n            Without --adapter, WhiteRoom's sample agent runs the practice tasks.\n  adapter   Prints a starter adapter to connect your own agent, for example:\n            whiteroom practice adapter --lang js > wr-adapter.mjs\n\nOptions:\n  --adapter \"<command>\"  The command that starts your agent's adapter, e.g. \"node wr-adapter.mjs\"\n  --key-env <VAR>        The variable your agent's key is in, e.g. ANTHROPIC_API_KEY, when several are set\n  --code-stdin           Read the run code from stdin instead of asking for it\n  --url <https url>      Only for testing WhiteRoom itself (a whiteroom.tech address or localhost)\n";
+export declare function practice(argv: string[]): Promise<number>;

package/dist/practice/index.js

@@ -0,0 +1,72 @@
+// `whiteroom practice` (hidden alias `readiness`), spec §10 CLI. Usage
+// problems exit 2, never 1 (§8); so does anything unexpected.
+import { readFileSync } from "node:fs";
+import { parseArgs } from "node:util";
+import { practiceRun, STARTERS_DIR } from "./run.js";
+import { warn } from "./text.js";
+export const PRACTICE_USAGE = `whiteroom practice — run a WhiteRoom practice test on your agent
+
+Usage:
+  whiteroom practice run [--adapter "<command>"] [--key-env <VAR>] [--code-stdin] [--url <https url>]
+  whiteroom practice adapter --lang js|python
+
+  run       Starts the practice test from the run code shown in the dashboard.
+            Without --adapter, WhiteRoom's sample agent runs the practice tasks.
+  adapter   Prints a starter adapter to connect your own agent, for example:
+            whiteroom practice adapter --lang js > wr-adapter.mjs
+
+Options:
+  --adapter "<command>"  The command that starts your agent's adapter, e.g. "node wr-adapter.mjs"
+  --key-env <VAR>        The variable your agent's key is in, e.g. ANTHROPIC_API_KEY, when several are set
+  --code-stdin           Read the run code from stdin instead of asking for it
+  --url <https url>      Only for testing WhiteRoom itself (a whiteroom.tech address or localhost)
+`;
+const STARTERS = { js: "wr-adapter.mjs", python: "wr_adapter.py" };
+function usage(problem) {
+    if (!problem)
+        return process.stdout.write(PRACTICE_USAGE), 0;
+    warn(`${problem}\nRun whiteroom practice --help to see the commands.`);
+    return 2;
+}
+export async function practice(argv) {
+    const [sub, ...rest] = argv;
+    if (!sub || sub === "--help" || sub === "-h" || sub === "help")
+        return usage();
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args: rest,
+            strict: true,
+            allowPositionals: false,
+            options: sub === "run"
+                ? { adapter: { type: "string" }, "key-env": { type: "string" }, "code-stdin": { type: "boolean" }, url: { type: "string" }, help: { type: "boolean", short: "h" } }
+                : { lang: { type: "string" }, help: { type: "boolean", short: "h" } },
+        }));
+    }
+    catch (err) {
+        return usage(err.message);
+    }
+    if (values.help)
+        return usage();
+    try {
+        if (sub === "run") {
+            if (values.adapter !== undefined && !values.adapter.trim())
+                return usage("--adapter needs the command that starts your adapter.");
+            return await practiceRun({ adapter: values.adapter, codeStdin: !!values["code-stdin"], url: values.url, keyEnv: values["key-env"] });
+        }
+        if (sub === "adapter") {
+            const file = STARTERS[values.lang];
+            if (!file)
+                return usage("Choose a starter with --lang js or --lang python.");
+            process.stdout.write(readFileSync(new URL(file, STARTERS_DIR), "utf8"));
+            return 0;
+        }
+        return usage(`Unknown practice command: ${sub}`);
+    }
+    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/practice/index.js.map

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

package/dist/practice/preflight.d.ts

@@ -0,0 +1,58 @@
+export declare const PRODUCTION = "https://proxy.whiteroom.tech";
+export declare const RUN_CODE: RegExp;
+/**
+ * The origin practice commands talk to: production, or `--url` if it is
+ * WhiteRoom's own (https on whiteroom.tech) or loopback, since the provider
+ * key goes there. Any other https host only with WHITEROOM_PRACTICE_DEV=1
+ * (testing WhiteRoom itself). Null if `--url` isn't allowed.
+ */
+export declare function targetOrigin(url: string | undefined, env?: NodeJS.ProcessEnv): string | null;
+/** Splits a command line into words as a POSIX shell would for plain words and quotes (enough to find files). */
+export declare function words(cmd: string): string[];
+/**
+ * Why `--adapter` can't start, or null: its program is on PATH (or a file), and
+ * script files it names (by extension) exist. Commands with shell syntax or a
+ * builtin first word are left to the shell.
+ */
+export declare function adapterProblem(cmd: string, cwd?: string, path?: string): string | null;
+/**
+ * The adapter as reported to WhiteRoom (§7 "What was tested"): only the
+ * program's name and its script file's name, e.g. "python3 wr_adapter.py".
+ * Never environment assignments, flags, flag values or directories.
+ */
+export declare function adapterLabel(cmd: string): string;
+/** Where a practice test's model calls go, as the claim names it: one of the catalog's providers. */
+export type Provider = string;
+export declare const isProvider: (v: unknown) => v is Provider;
+/** The variable a provider's key is read from, and the adapter gets it in. */
+export declare const keyVarOf: (p: Provider) => string;
+export declare const isKeyVar: (v: string) => boolean;
+/** OpenAI and Azure OpenAI take chat completions (their SDKs want a base URL ending in /v1); the others Anthropic's Messages API. */
+export declare const chatCompletions: (p: Provider) => boolean;
+/** The header a provider's key travels in, as the catalog says: Azure's api-key, a Bearer token, or x-api-key. */
+export declare function keyHeader(p: Provider, key: string): Record<string, string>;
+/** A direct key's provider, by its shape: what an older WhiteRoom that names no provider means. */
+export declare const providerByShape: (key: string) => Provider;
+/** Short-term Bedrock keys can expire during a test; WhiteRoom refuses them without using a try. */
+export declare const isShortTermBedrockKey: (key: string) => boolean;
+export interface KeyChoice {
+    /** The variable the key came from; null when it was pasted. */
+    from: string | null;
+    key: string;
+}
+/**
+ * The key from `keyEnv` (`--key-env`, the variable the dashboard's command
+ * names), else from the one provider variable that is set; null to prompt.
+ * When more than one is set, the variables: before the claim the CLI can't
+ * tell which provider the run uses, and a guess could use a try.
+ */
+export declare function keyFromEnv(env: NodeJS.ProcessEnv, keyEnv?: string): KeyChoice | string[] | null;
+export declare class Interrupted extends Error {
+}
+type Terminal = Pick<NodeJS.ReadStream, "setRawMode" | "setEncoding" | "resume" | "pause" | "on" | "off">;
+/** Reads a line from the terminal without echoing it. Ctrl+C rejects with Interrupted. */
+export declare function hiddenPrompt(question: string, stdin?: Terminal): Promise<string>;
+/** The first line of stdin (`--code-stdin`). */
+export declare function firstLineOfStdin(): Promise<string>;
+export declare const nodeTooOld: (version?: string) => string | null;
+export {};

package/dist/practice/preflight.js

@@ -0,0 +1,185 @@
+// Checks that run before anything is sent (spec §10 CLI, §9.3): the target,
+// the adapter command, the provider key and the run code's shape.
+import { accessSync, constants, statSync } from "node:fs";
+import { basename, delimiter, isAbsolute, join, resolve } from "node:path";
+import { CATALOG } from "./catalog.js";
+import { copy } from "./text.js";
+export const PRODUCTION = "https://proxy.whiteroom.tech";
+const LOOPBACK = new Set(["localhost", "127.0.0.1", "[::1]"]);
+export const RUN_CODE = /^wrrt_[A-Za-z0-9_-]{43}$/;
+/**
+ * The origin practice commands talk to: production, or `--url` if it is
+ * WhiteRoom's own (https on whiteroom.tech) or loopback, since the provider
+ * key goes there. Any other https host only with WHITEROOM_PRACTICE_DEV=1
+ * (testing WhiteRoom itself). Null if `--url` isn't allowed.
+ */
+export function targetOrigin(url, env = process.env) {
+    if (url === undefined)
+        return PRODUCTION;
+    let u;
+    try {
+        u = new URL(url);
+    }
+    catch {
+        return null;
+    }
+    if (u.username || u.password)
+        return null;
+    if (u.protocol === "http:")
+        return LOOPBACK.has(u.hostname) ? u.origin : null;
+    if (u.protocol !== "https:")
+        return null;
+    const ours = u.hostname === "whiteroom.tech" || u.hostname.endsWith(".whiteroom.tech") || LOOPBACK.has(u.hostname);
+    return ours || env.WHITEROOM_PRACTICE_DEV === "1" ? u.origin : null;
+}
+/** Splits a command line into words as a POSIX shell would for plain words and quotes (enough to find files). */
+export function words(cmd) {
+    const out = [];
+    const re = /"((?:[^"\\]|\\.)*)"|'([^']*)'|((?:[^\s"'\\]|\\.)+)|(\s+)/g;
+    let cur = null;
+    for (const m of cmd.matchAll(re)) {
+        if (m[4] !== undefined) {
+            if (cur !== null)
+                out.push(cur);
+            cur = null;
+            continue;
+        }
+        const part = m[1] !== undefined ? m[1].replace(/\\(.)/g, "$1") : m[2] ?? m[3].replace(/\\(.)/g, "$1");
+        cur = (cur ?? "") + part;
+    }
+    if (cur !== null)
+        out.push(cur);
+    return out;
+}
+const isFile = (p) => {
+    try {
+        return statSync(p).isFile();
+    }
+    catch {
+        return false;
+    }
+};
+const isExecutable = (p) => {
+    try {
+        accessSync(p, constants.X_OK);
+        return isFile(p);
+    }
+    catch {
+        return false;
+    }
+};
+const SCRIPT = /\.(m?js|cjs|ts|mts|py|rb|php|pl|sh|jar|exe)$/i;
+/** Shell syntax and builtins this check can't follow: the user's shell runs the command, so it isn't second-guessed. */
+const SHELL_SYNTAX = /[&|;<>$`(){}*?~\n]/;
+const BUILTINS = new Set(["cd", "source", ".", "export", "exec", "eval", "set", "alias", "command", "builtin", "time", "nohup", "env"]);
+/**
+ * Why `--adapter` can't start, or null: its program is on PATH (or a file), and
+ * script files it names (by extension) exist. Commands with shell syntax or a
+ * builtin first word are left to the shell.
+ */
+export function adapterProblem(cmd, cwd = process.cwd(), path = process.env.PATH ?? "") {
+    if (!cmd.trim())
+        return "the command is empty";
+    if (SHELL_SYNTAX.test(cmd))
+        return null;
+    const w = words(cmd);
+    while (w.length && /^[A-Za-z_][A-Za-z0-9_]*=/.test(w[0]))
+        w.shift(); // FOO=1 node agent.js
+    const [program, ...args] = w;
+    if (!program || BUILTINS.has(program))
+        return null;
+    if (program.includes("/")) {
+        if (!isExecutable(resolve(cwd, program)))
+            return `${program} isn't a file you can run`;
+    }
+    else if (!path.split(delimiter).some((dir) => dir && isExecutable(join(isAbsolute(dir) ? dir : resolve(cwd, dir), program)))) {
+        return `${program} isn't on your PATH`;
+    }
+    const missing = args.find((a) => !a.startsWith("-") && SCRIPT.test(a) && !/^[a-z][a-z0-9+.-]*:\/\//i.test(a) && !isFile(resolve(cwd, a)));
+    return missing ? `${missing} doesn't exist` : null;
+}
+/**
+ * The adapter as reported to WhiteRoom (§7 "What was tested"): only the
+ * program's name and its script file's name, e.g. "python3 wr_adapter.py".
+ * Never environment assignments, flags, flag values or directories.
+ */
+export function adapterLabel(cmd) {
+    const w = words(cmd).filter((x) => !/^[A-Za-z_][A-Za-z0-9_]*=/.test(x));
+    const safe = (p) => basename(p).replace(/[^\w.+-]/g, "").slice(0, 64);
+    const script = w.slice(1).find((a) => !a.startsWith("-") && SCRIPT.test(a));
+    return [w[0] && safe(w[0]), script && safe(script)].filter(Boolean).join(" ") || "adapter";
+}
+export const isProvider = (v) => typeof v === "string" && Object.hasOwn(CATALOG.providers, v);
+/** The variable a provider's key is read from, and the adapter gets it in. */
+export const keyVarOf = (p) => CATALOG.providers[p].keyVar;
+const ALL_KEY_VARS = Object.values(CATALOG.providers).map((p) => p.keyVar);
+export const isKeyVar = (v) => ALL_KEY_VARS.includes(v);
+/** OpenAI and Azure OpenAI take chat completions (their SDKs want a base URL ending in /v1); the others Anthropic's Messages API. */
+export const chatCompletions = (p) => CATALOG.providers[p].api === "chat_completions";
+/** The header a provider's key travels in, as the catalog says: Azure's api-key, a Bearer token, or x-api-key. */
+export function keyHeader(p, key) {
+    const h = CATALOG.providers[p].header;
+    return h === "bearer" ? { authorization: `Bearer ${key}` } : { [h]: key };
+}
+/** A direct key's provider, by its shape: what an older WhiteRoom that names no provider means. */
+export const providerByShape = (key) => (key.startsWith("sk-ant-") ? "anthropic" : "openai");
+/** Short-term Bedrock keys can expire during a test; WhiteRoom refuses them without using a try. */
+export const isShortTermBedrockKey = (key) => key.startsWith("bedrock-api-key-");
+/**
+ * The key from `keyEnv` (`--key-env`, the variable the dashboard's command
+ * names), else from the one provider variable that is set; null to prompt.
+ * When more than one is set, the variables: before the claim the CLI can't
+ * tell which provider the run uses, and a guess could use a try.
+ */
+export function keyFromEnv(env, keyEnv) {
+    const set = keyEnv ? [keyEnv].filter((v) => env[v]?.trim()) : ALL_KEY_VARS.filter((v) => env[v]?.trim());
+    if (set.length > 1)
+        return set;
+    return set.length ? { from: set[0], key: env[set[0]].trim() } : null;
+}
+export class Interrupted extends Error {
+}
+/** Reads a line from the terminal without echoing it. Ctrl+C rejects with Interrupted. */
+export function hiddenPrompt(question, stdin = process.stdin) {
+    const { stderr } = process;
+    stderr.write(question);
+    stdin.setRawMode(true);
+    stdin.setEncoding("utf8");
+    stdin.resume();
+    return new Promise((resolvePrompt, reject) => {
+        let s = "";
+        const done = () => {
+            stdin.off("data", onData);
+            stdin.setRawMode(false);
+            stdin.pause();
+            stderr.write("\n");
+        };
+        const onData = (chunk) => {
+            // A terminal with bracketed paste wraps a paste in ESC[200~ … ESC[201~.
+            for (const ch of chunk.replace(/\x1b\[20[01]~/g, "")) {
+                if (ch === "\r" || ch === "\n")
+                    return done(), resolvePrompt(s.trim());
+                if (ch === "\u0003")
+                    return done(), reject(new Interrupted());
+                if (ch === "\u007f" || ch === "\b")
+                    s = s.slice(0, -1);
+                else if (ch >= " ")
+                    s += ch;
+            }
+        };
+        stdin.on("data", onData);
+    });
+}
+/** The first line of stdin (`--code-stdin`). */
+export async function firstLineOfStdin() {
+    let data = "";
+    process.stdin.setEncoding("utf8");
+    for await (const chunk of process.stdin) {
+        data += chunk;
+        if (data.includes("\n") || data.length > 4096)
+            break;
+    }
+    return data.split("\n")[0].trim();
+}
+export const nodeTooOld = (version = process.versions.node) => (Number(version.split(".")[0]) < 20 ? copy.node(version) : null);
+//# sourceMappingURL=preflight.js.map

package/dist/practice/preflight.js.map

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

package/dist/practice/run.d.ts

@@ -0,0 +1,11 @@
+/** The final answer WhiteRoom takes: 32 Ki characters, inside its 64 KiB body limit. */
+export declare function finalText(s: string): string;
+export declare const STARTERS_DIR: URL;
+export interface RunArgs {
+    adapter?: string;
+    codeStdin: boolean;
+    url?: string;
+    /** --key-env: the variable the run's key is read from, when several are set. */
+    keyEnv?: string;
+}
+export declare function practiceRun(a: RunArgs): Promise<number>;