oharness 0.1.0

package/dist/ui/tui/keys.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Turning raw terminal bytes into keys.
+ *
+ * A single read can carry several keystrokes, one keystroke split across two
+ * reads, or a whole pasted document. Anything that assumes "one read is one
+ * key" mangles fast typing and pasted text, so this parser consumes a buffer
+ * and reports what it could resolve, keeping the remainder for next time.
+ */
+export interface Key {
+    name: string;
+    /** The literal characters, for printable input. */
+    text?: string;
+    ctrl?: boolean;
+    alt?: boolean;
+    shift?: boolean;
+}
+/** Bracketed paste: the terminal brackets pasted text so it is not typed. */
+export declare const PASTE_START = "\u001B[200~";
+export declare const PASTE_END = "\u001B[201~";
+export interface ParseResult {
+    keys: Key[];
+    /** Bytes that may be the start of a longer sequence; feed them back in. */
+    rest: string;
+}
+export declare function parseKeys(input: string): ParseResult;

package/dist/ui/tui/keys.js

@@ -0,0 +1,133 @@
+/**
+ * Turning raw terminal bytes into keys.
+ *
+ * A single read can carry several keystrokes, one keystroke split across two
+ * reads, or a whole pasted document. Anything that assumes "one read is one
+ * key" mangles fast typing and pasted text, so this parser consumes a buffer
+ * and reports what it could resolve, keeping the remainder for next time.
+ */
+const ESC = "\u001b";
+/** Bracketed paste: the terminal brackets pasted text so it is not typed. */
+export const PASTE_START = `${ESC}[200~`;
+export const PASTE_END = `${ESC}[201~`;
+const CSI_KEYS = {
+    A: "up",
+    B: "down",
+    C: "right",
+    D: "left",
+    H: "home",
+    F: "end",
+    Z: "backtab",
+};
+const TILDE_KEYS = {
+    "1": "home",
+    "2": "insert",
+    "3": "delete",
+    "4": "end",
+    "5": "pageup",
+    "6": "pagedown",
+    "7": "home",
+    "8": "end",
+};
+export function parseKeys(input) {
+    const keys = [];
+    let i = 0;
+    while (i < input.length) {
+        const char = input[i];
+        if (char === ESC) {
+            const consumed = parseEscape(input, i, keys);
+            if (consumed === -1) {
+                // An incomplete sequence: keep it rather than reporting a bare Escape,
+                // which would move the cursor or cancel a dialog by accident.
+                return { keys, rest: input.slice(i) };
+            }
+            i += consumed;
+            continue;
+        }
+        if (char === "\r" || char === "\n") {
+            keys.push({ name: "enter" });
+            i++;
+            continue;
+        }
+        if (char === "\t") {
+            keys.push({ name: "tab" });
+            i++;
+            continue;
+        }
+        if (char === "\u007f" || char === "\b") {
+            keys.push({ name: "backspace" });
+            i++;
+            continue;
+        }
+        const code = char.charCodeAt(0);
+        if (code < 32) {
+            // Ctrl-A is 1, Ctrl-B is 2, and so on.
+            keys.push({ name: String.fromCharCode(code + 96), ctrl: true });
+            i++;
+            continue;
+        }
+        // Printable: take the whole run at once so pasted or fast-typed text does
+        // not become one event per character.
+        let run = "";
+        while (i < input.length) {
+            const next = input[i];
+            if (next === ESC || next.charCodeAt(0) < 32 || next === "\u007f")
+                break;
+            run += next;
+            i++;
+        }
+        keys.push({ name: "text", text: run });
+    }
+    return { keys, rest: "" };
+}
+/** Returns how many characters were consumed, or -1 if the sequence is partial. */
+function parseEscape(input, start, keys) {
+    const rest = input.slice(start);
+    // A lone Escape at the end of the buffer is ambiguous: it may be the start of
+    // a sequence whose remainder has not arrived. Callers resolve this with a
+    // timeout; here it is reported as incomplete.
+    if (rest.length === 1)
+        return -1;
+    if (rest.startsWith(PASTE_START)) {
+        const end = rest.indexOf(PASTE_END);
+        if (end === -1)
+            return -1; // paste still arriving
+        keys.push({ name: "paste", text: rest.slice(PASTE_START.length, end) });
+        return end + PASTE_END.length;
+    }
+    if (rest[1] === "[" || rest[1] === "O") {
+        const match = /^\u001b[[O]([0-9;]*)([A-Za-z~])/.exec(rest);
+        if (!match)
+            return rest.length > 12 ? rest.length : -1;
+        const [full, params = "", final = ""] = match;
+        const modifiers = modifierBits(params);
+        if (final === "~") {
+            const name = TILDE_KEYS[params.split(";")[0] ?? ""];
+            if (name)
+                keys.push({ name, ...modifiers });
+            return full.length;
+        }
+        const name = CSI_KEYS[final];
+        if (name)
+            keys.push({ name, ...modifiers });
+        return full.length;
+    }
+    // Alt-<key>: the terminal sends Escape followed by the key itself.
+    const following = parseKeys(rest.slice(1));
+    const first = following.keys[0];
+    if (first) {
+        keys.push({ ...first, alt: true });
+        return rest.length - following.rest.length;
+    }
+    return -1;
+}
+/** xterm encodes modifiers as a trailing `;N` parameter. */
+function modifierBits(params) {
+    const modifier = Number.parseInt(params.split(";")[1] ?? "1", 10) - 1;
+    return {
+        shift: (modifier & 1) !== 0,
+        alt: (modifier & 2) !== 0,
+        ctrl: (modifier & 4) !== 0,
+    };
+}
+//# sourceMappingURL=keys.js.map

package/dist/ui/tui/keys.js.map

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

package/dist/ui/tui/layout.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Turning application state into the exact rows the screen should show.
+ *
+ * Kept apart from the screen and the event loop so it is a pure function of
+ * state: a layout bug can be reproduced by calling `composeFrame` with the
+ * state that triggered it, rather than by driving a terminal.
+ */
+export interface Block {
+    kind: "logo" | "user" | "assistant" | "thinking" | "tool" | "notice" | "log" | "error" | "artifact";
+    text: string;
+    /** Shown dimmed after the title, e.g. a tool's arguments or duration. */
+    detail?: string;
+    done?: boolean;
+    /** Centred in the frame rather than set flush left. Used by the opening screen. */
+    center?: boolean;
+    /**
+     * Second dimmed line, on its own row rather than appended to the first.
+     * An artifact the terminal cannot render says so here, and the sentence is
+     * long enough that truncating it onto the title line would eat the title.
+     */
+    note?: string;
+}
+export interface StatusInfo {
+    model: string;
+    mode: string;
+    /** Fraction of the context window in use, 0–1. */
+    contextUsed?: number;
+    costUsd?: number;
+    busy?: boolean;
+    /** Turns the spinner; the caller advances it. */
+    tick?: number;
+}
+export interface Overlay {
+    title: string;
+    detail?: string[];
+    choices: {
+        label: string;
+        hint?: string;
+        current?: boolean;
+    }[];
+    selected: number;
+}
+export interface FrameState {
+    blocks: Block[];
+    input: string;
+    /** Caret offset in columns from the start of the input text. */
+    cursorColumns: number;
+    status: StatusInfo;
+    /** Rows scrolled back from the bottom; 0 means pinned to the latest. */
+    scroll: number;
+    overlay?: Overlay;
+    hint?: string;
+}
+export interface Frame {
+    lines: string[];
+    cursor?: {
+        row: number;
+        column: number;
+    };
+    /** Rows of history that exist above the viewport, for the scroll indicator. */
+    hiddenAbove: number;
+}
+export declare function composeFrame(state: FrameState, rows: number, columns: number): Frame;

package/dist/ui/tui/layout.js

@@ -0,0 +1,202 @@
+import { c } from "../render.js";
+import { logoRows } from "./logo.js";
+import { truncate, visibleWidth, wrap } from "./width.js";
+const SPINNER = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+const MIN_COLUMNS = 24;
+const MIN_ROWS = 8;
+export function composeFrame(state, rows, columns) {
+    if (columns < MIN_COLUMNS || rows < MIN_ROWS) {
+        // Still a full-height frame: a short one leaves whatever the last frame
+        // drew below it on screen, which looks like a half-crashed program.
+        return { lines: padTo(tooSmall(rows, columns), rows), hiddenAbove: 0 };
+    }
+    const inputRows = renderInput(state, columns);
+    const statusRow = renderStatus(state.status, columns);
+    const historyHeight = Math.max(1, rows - inputRows.length - 1);
+    const history = state.blocks.flatMap((block) => renderBlock(block, columns));
+    // Scrolling is measured from the bottom, so new output does not yank the
+    // view when the user has deliberately scrolled back.
+    const maxScroll = Math.max(0, history.length - historyHeight);
+    const scroll = Math.min(state.scroll, maxScroll);
+    const end = history.length - scroll;
+    const start = Math.max(0, end - historyHeight);
+    const visible = history.slice(start, end);
+    const lines = [
+        ...(isIntro(state.blocks) ? centreIn(visible, historyHeight) : padTo(visible, historyHeight)),
+        ...inputRows,
+        statusRow,
+    ];
+    if (state.overlay) {
+        return { lines: applyOverlay(lines, state.overlay, rows, columns), hiddenAbove: start };
+    }
+    // The caret sits inside the input box: one row down for the top border, two
+    // columns in for the border and the prompt marker.
+    const promptWidth = 4;
+    const inner = Math.max(1, columns - promptWidth - 2);
+    const cursorRow = historyHeight + 2 + Math.floor(state.cursorColumns / inner);
+    const cursorColumn = promptWidth + 1 + (state.cursorColumns % inner);
+    return {
+        lines,
+        cursor: { row: Math.min(cursorRow, rows), column: Math.min(cursorColumn, columns) },
+        hiddenAbove: start,
+    };
+}
+function tooSmall(rows, columns) {
+    // Drawing a layout that does not fit produces garbage that looks like a
+    // crash. Saying so is more useful — wrapped rather than truncated, because
+    // at these widths a truncated message loses the part that explains itself.
+    const message = `too small: ${columns}x${rows}, need ${MIN_COLUMNS}x${MIN_ROWS}`;
+    return wrap(message, Math.max(1, columns)).slice(0, Math.max(1, rows));
+}
+/** Kinds that are the program talking about itself rather than a conversation. */
+const CHROME = new Set(["logo", "notice", "log"]);
+/**
+ * Whether the transcript is still only the opening screen.
+ *
+ * History grows from the bottom, which is right once there is a conversation
+ * to follow — but it makes the opening screen sit in the last few rows with
+ * the whole terminal empty above it, reading as something that already
+ * scrolled past. Until the first turn there is nothing to anchor, so it is
+ * centred instead.
+ *
+ * A background diagnostic does not end that state. A sync that cannot reach
+ * its endpoint retries on a timer, and letting the first of those warnings
+ * slam the opening screen to the bottom of the terminal makes an idle prompt
+ * look like it has already been used.
+ */
+function isIntro(blocks) {
+    return blocks.every((block) => CHROME.has(block.kind));
+}
+function centreIn(lines, height) {
+    if (lines.length >= height)
+        return padTo(lines, height);
+    const top = Math.floor((height - lines.length) / 2);
+    return [...Array(top).fill(""), ...lines, ...Array(height - top - lines.length).fill("")];
+}
+function padTo(lines, height) {
+    const padded = [...lines];
+    while (padded.length < height)
+        padded.unshift("");
+    return padded.slice(-height);
+}
+function renderBlock(block, columns) {
+    switch (block.kind) {
+        // The mark carries no text of its own: it is drawn from the width it is
+        // handed, so a resize re-centres it rather than stranding it left.
+        case "logo":
+            return logoRows(columns);
+        case "user":
+            return wrap(block.text, columns - 2).map((line, i) => i === 0 ? `${c.cyan("›")} ${c.bold(line)}` : `  ${line}`);
+        case "assistant":
+            return wrap(block.text, columns);
+        case "thinking":
+            return wrap(block.text, columns - 2).map((line) => c.gray(`  ${line}`));
+        case "tool": {
+            const mark = block.done === false ? c.yellow("◐") : c.green("●");
+            const head = `${mark} ${c.bold(block.text)}`;
+            const detail = block.detail ? c.gray(` ${truncate(block.detail, columns - visibleWidth(block.text) - 4)}`) : "";
+            return [truncate(head + detail, columns)];
+        }
+        case "artifact": {
+            // `text` already carries its own colour from artifactSummary, so it is
+            // wrapped rather than re-coloured — nesting the codes would leave the
+            // reset from the inner one turning the outer colour off mid-line.
+            const head = `${c.magenta("◆")} ${block.text}`;
+            const rows = [truncate(head, columns)];
+            if (block.note)
+                rows.push(...wrap(c.gray(`  ${block.note}`), columns));
+            return rows;
+        }
+        // Yellow-green, not magenta: the banner and the compaction notes are the
+        // program talking about itself, and sharing a hue with `error` red made
+        // an ordinary startup read as something having gone wrong.
+        case "notice": {
+            const rows = wrap(c.lime(block.text), columns);
+            // Only a line that fits is centred. Centring the fragments of a wrapped
+            // one staggers them around the middle, which reads as damage rather
+            // than as layout.
+            return block.center && rows.length === 1 ? [centreRow(rows[0], columns)] : rows;
+        }
+        case "log":
+            return wrap(c.gray(block.text), columns);
+        case "error":
+            return wrap(c.red(`✗ ${block.text}`), columns);
+    }
+}
+/** Indent a row so its printed width sits in the middle of the frame. */
+function centreRow(line, columns) {
+    const indent = Math.floor((columns - visibleWidth(line)) / 2);
+    return indent > 0 ? `${" ".repeat(indent)}${line}` : line;
+}
+function renderInput(state, columns) {
+    const inner = Math.max(1, columns - 6);
+    const textRows = state.input === "" ? [""] : wrap(state.input, inner);
+    // Cap the box so a long paste cannot push the history off the screen.
+    const shown = textRows.slice(-6);
+    const top = c.gray(`╭${"─".repeat(Math.max(0, columns - 2))}╮`);
+    const bottom = c.gray(`╰${"─".repeat(Math.max(0, columns - 2))}╯`);
+    const body = shown.map((line, i) => {
+        const marker = i === 0 ? c.cyan(" › ") : "   ";
+        const padding = " ".repeat(Math.max(0, inner - visibleWidth(line)));
+        return `${c.gray("│")}${marker}${line}${padding} ${c.gray("│")}`;
+    });
+    return [top, ...body, bottom];
+}
+function renderStatus(status, columns) {
+    const parts = [];
+    if (status.busy)
+        parts.push(c.yellow(SPINNER[(status.tick ?? 0) % SPINNER.length]));
+    parts.push(c.bold(status.model));
+    parts.push(c.magenta(status.mode));
+    if (status.contextUsed !== undefined) {
+        const percent = Math.round(status.contextUsed * 100);
+        // Colour the number rather than hiding it: knowing compaction is close
+        // explains why the next reply may lose earlier detail.
+        const paint = percent >= 90 ? c.red : percent >= 70 ? c.yellow : c.gray;
+        parts.push(paint(`ctx ${percent}%`));
+    }
+    if (status.costUsd !== undefined && status.costUsd > 0) {
+        parts.push(c.gray(`$${status.costUsd.toFixed(4)}`));
+    }
+    const left = parts.join(c.gray(" · "));
+    const right = c.gray("/help");
+    const gap = Math.max(1, columns - visibleWidth(left) - visibleWidth(right));
+    return truncate(`${left}${" ".repeat(gap)}${right}`, columns);
+}
+/** Draw a centred box over the frame, for permission prompts and pickers. */
+function applyOverlay(lines, overlay, rows, columns) {
+    const width = Math.min(columns - 4, 72);
+    const inner = width - 4;
+    const body = [];
+    body.push(c.bold(truncate(overlay.title, inner)));
+    for (const line of overlay.detail ?? []) {
+        for (const wrapped of wrap(line, inner))
+            body.push(c.gray(wrapped));
+    }
+    body.push("");
+    overlay.choices.forEach((choice, i) => {
+        const active = i === overlay.selected;
+        const mark = choice.current ? c.green("✓") : " ";
+        const label = active ? c.cyan(`❯ ${choice.label}`) : `  ${choice.label}`;
+        const hint = choice.hint ? c.gray(` — ${choice.hint}`) : "";
+        body.push(truncate(`${mark} ${c.gray(String(i + 1))} ${label}${hint}`, inner));
+    });
+    const boxed = [
+        c.gray(`╭${"─".repeat(width - 2)}╮`),
+        ...body.map((line) => {
+            const padding = " ".repeat(Math.max(0, inner - visibleWidth(line)));
+            return `${c.gray("│")} ${line}${padding} ${c.gray("│")}`;
+        }),
+        c.gray(`╰${"─".repeat(width - 2)}╯`),
+    ];
+    const top = Math.max(0, Math.floor((rows - boxed.length) / 2));
+    const left = Math.max(0, Math.floor((columns - width) / 2));
+    const out = [...lines];
+    boxed.forEach((line, i) => {
+        const row = top + i;
+        if (row < out.length)
+            out[row] = " ".repeat(left) + line;
+    });
+    return out;
+}
+//# sourceMappingURL=layout.js.map

package/dist/ui/tui/layout.js.map

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

package/dist/ui/tui/logo.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The mark and the name as frame rows, centred for the width they are given.
+ *
+ * Computed per frame rather than stored on the block, so narrowing the window
+ * swaps in the plain name instead of leaving the fragments a wrap would make
+ * of a letterform.
+ *
+ * The logo takes no colour of its own. The SVG is drawn in `currentColor` and
+ * the favicon flips between near-black and near-white with the scheme, so the
+ * mark is monochrome by design — in a terminal that means the default
+ * foreground, which is already the right one on a light or a dark theme, and
+ * is the only choice that survives `NO_COLOR`.
+ *
+ * A blank row trails the logo so the banner beneath it is not welded to the
+ * letterform — as a row of the block rather than a separate one, because an
+ * empty `notice` would still carry its colour codes into the frame.
+ */
+export declare function logoRows(columns: number): string[];

package/dist/ui/tui/logo.js

@@ -0,0 +1,33 @@
+import { c } from "../render.js";
+import { MARK, MARK_GAP, NAME, wordmark } from "../wordmark.js";
+/**
+ * The mark and the name as frame rows, centred for the width they are given.
+ *
+ * Computed per frame rather than stored on the block, so narrowing the window
+ * swaps in the plain name instead of leaving the fragments a wrap would make
+ * of a letterform.
+ *
+ * The logo takes no colour of its own. The SVG is drawn in `currentColor` and
+ * the favicon flips between near-black and near-white with the scheme, so the
+ * mark is monochrome by design — in a terminal that means the default
+ * foreground, which is already the right one on a light or a dark theme, and
+ * is the only choice that survives `NO_COLOR`.
+ *
+ * A blank row trails the logo so the banner beneath it is not welded to the
+ * letterform — as a row of the block rather than a separate one, because an
+ * empty `notice` would still carry its colour codes into the frame.
+ */
+export function logoRows(columns) {
+    const { rows, width } = wordmark();
+    // Too narrow for the letterform: the mark collapses to the one part of it
+    // that survives at a single row, and the name is set in ordinary type.
+    if (columns < width + 4) {
+        const compact = c.bold(`● ${NAME}`);
+        const indent = Math.max(0, Math.floor((columns - NAME.length - 2) / 2));
+        return [`${" ".repeat(indent)}${compact}`, ""];
+    }
+    const pad = " ".repeat(Math.floor((columns - width) / 2));
+    const gap = " ".repeat(MARK_GAP);
+    return [...rows.map((row, i) => c.bold(`${pad}${MARK[i]}${gap}${row}`)), ""];
+}
+//# sourceMappingURL=logo.js.map

package/dist/ui/tui/logo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logo.js","sourceRoot":"","sources":["../../../src/ui/tui/logo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,cAAc,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEhE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,CAAC;IAEnC,0EAA0E;IAC1E,uEAAuE;IACvE,IAAI,OAAO,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChF,CAAC"}

package/dist/ui/tui/screen.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Terminal ownership: the alternate buffer, raw mode, and getting out again.
+ *
+ * The failure that matters here is not a misdrawn frame. It is exiting without
+ * restoring: the user is left in raw mode with no echo and no cursor, facing a
+ * terminal that appears frozen, and their only recovery is to type `reset`
+ * blind. So restoration is wired to every exit path there is — normal return,
+ * thrown exception, unhandled rejection, and the signals a terminal or a
+ * supervisor can deliver — and it is idempotent, because several of those can
+ * fire together.
+ */
+export interface Screen {
+    readonly rows: number;
+    readonly columns: number;
+    /** Draw a whole frame. `cursor` is a 1-based row/column to leave it at. */
+    render(lines: string[], cursor?: {
+        row: number;
+        column: number;
+    }): void;
+    onKey(handler: (key: string) => void): void;
+    onResize(handler: () => void): void;
+    /** Restore the terminal. Safe to call more than once. */
+    close(): void;
+}
+export interface ScreenOptions {
+    /**
+     * Work to finish before a signal ends the process.
+     *
+     * The screen has no idea what this does — it only guarantees the promise
+     * gets a bounded chance to settle. The app uses it to stop an in-flight turn
+     * and let the agent write its tool results, which otherwise die with the
+     * process and leave an unanswered tool call on disk.
+     */
+    beforeExit?: () => Promise<void>;
+}
+/** The parts of the terminal streams a screen actually uses. */
+export interface ScreenStreams {
+    out: Pick<NodeJS.WriteStream, "write" | "rows" | "columns" | "on" | "off">;
+    input: Pick<NodeJS.ReadStream, "setRawMode" | "isRaw" | "isTTY" | "resume" | "pause" | "on" | "off">;
+}
+/**
+ * Streams are injectable so the restore path can be tested.
+ *
+ * Not a general-purpose seam: it exists because "does this leave the terminal
+ * usable" is the one behaviour here worth proving, and proving it against the
+ * real process streams would wreck the terminal running the tests.
+ */
+export declare function openScreen(streams?: Partial<ScreenStreams>, opts?: ScreenOptions): Screen;