poly-weaver 0.5.0 → 0.6.0

package/dist/terminal/input-router.d.ts

@@ -0,0 +1,146 @@
+import type { PtyHandle } from "../pty/types.js";
+/**
+ * Active parent UI mode (e.g. user-review prompt). When attached, raw
+ * stdin chunks are routed to it BEFORE host shortcuts / mouse / interrupt
+ * (but AFTER the global Ctrl+] dump detector). A host-backed prompt that
+ * wants to own wheel/mouse input simply consumes the chunk by returning
+ * `true` (the default).
+ */
+export interface ParentUiMode {
+    /** Receive a chunk of raw input. Return true if consumed (don't forward). */
+    onInput(chunk: Buffer): boolean | void;
+}
+/**
+ * Number of lines to scroll for a single mouse-wheel event. Small enough
+ * to feel precise while still moving meaningfully on every notch.
+ */
+export declare const WHEEL_LINES_PER_EVENT = 3;
+export interface InputRouterOptions {
+    /** Trigger a dump capture when Ctrl+] is observed. */
+    onDump?: () => void;
+    /** Host interrupt: invoked when raw Ctrl+C (byte 0x03) is observed and no parent UI consumes it. */
+    onInterrupt?: () => void;
+    /** Scroll back by N lines (older content). */
+    onScrollBackLines?: (lines: number) => void;
+    /** Scroll forward by N lines (newer content). */
+    onScrollForwardLines?: (lines: number) => void;
+    /** Scroll by N pages. Positive = forward (newer), negative = back (older). */
+    onScrollPages?: (pages: number) => void;
+    /** Jump to the top of scrollback. */
+    onScrollToTop?: () => void;
+    /** Jump to the live tail (bottom). */
+    onScrollToBottom?: () => void;
+}
+/**
+ * Centralizes stdin ownership while the orchestration host is active.
+ *
+ * Routing order on each chunk:
+ *
+ *   1. Dump hotkey detector (Ctrl+]) — strips dump bytes from forward.
+ *      The detector also reassembles split CSI sequences for kitty /
+ *      win32 dump variants, so when configured, downstream stages see
+ *      whole sequences for those paths.
+ *   2. Active parent UI mode (if attached) — fully consumes by default.
+ *      Parent UI receives Ctrl+C, mouse, and nav keys first and may
+ *      handle them. Only when there is no parent UI, or it returns
+ *      `false`, does routing fall through to the host's own handlers.
+ *   3. SGR mouse-wheel parsing — consumes `CSI < 64/65 ; … M` for
+ *      vertical wheel events and dispatches scroll callbacks. Non-wheel
+ *      SGR mouse events flow through unchanged. A small first-class
+ *      buffer reassembles SGR mouse sequences split across chunks so
+ *      the routing works regardless of whether the dump detector is
+ *      configured.
+ *   4. Host shortcut routing on remaining bytes:
+ *        - Ctrl+C (0x03)        → `onInterrupt()`
+ *        - PageUp  (CSI 5~)     → `onScrollPages(-1)`
+ *        - PageDown (CSI 6~)    → `onScrollPages(+1)`
+ *        - Home    (CSI 1~/H)   → `onScrollToTop()`
+ *        - End     (CSI 4~/F)   → `onScrollToBottom()`
+ *   5. Attached child PTY when `gateOpen` is true — `handle.write(forward)`.
+ *   6. Otherwise the chunk is dropped.
+ */
+export declare class InputRouter {
+    private readonly options;
+    private parentUiMode;
+    private childHandle;
+    private dumpDetector;
+    /** Buffered head of a split SGR mouse sequence (`ESC [ < … `). */
+    private sgrPartial;
+    private sgrPartialTimer;
+    constructor(options?: InputRouterOptions);
+    attachChild(handle: PtyHandle): void;
+    detachChild(handle?: PtyHandle): void;
+    attachParentUi(mode: ParentUiMode): void;
+    detachParentUi(mode?: ParentUiMode): void;
+    /** Process a stdin chunk. Returns true when at least one byte was consumed. */
+    handleChunk(chunk: Buffer): boolean;
+    private forwardToChild;
+    /**
+     * Strip SGR mouse wheel events (`CSI < 64;…M` and `CSI < 65;…M`) from
+     * the chunk, dispatching scrollback callbacks. Non-wheel SGR mouse
+     * events (clicks, motion, releases) and other CSI sequences (Home,
+     * PageUp, etc.) are left in the chunk so callers can still forward
+     * them or run them through host shortcut routing.
+     *
+     * Sequences split across chunk boundaries are first-class. The buffer
+     * holds any incomplete CSI prefix — bare ESC, ESC `[`, ESC `[ < …` —
+     * and prepends it to the next chunk. This works even when the dump
+     * detector is not configured (the detector reassembles split CSI for
+     * its own purposes when it is configured, but mouse-wheel scrollback
+     * MUST NOT depend on it). A 50 ms safety timer flushes a stale
+     * partial through `consumeHostShortcuts` and the child gate so a
+     * bare Esc keypress eventually reaches the child even when there is
+     * no continuation, and so a stray ESC byte cannot permanently block
+     * future input.
+     */
+    private consumeSgrMouseWheel;
+    private savePartialSgr;
+    /**
+     * Stale-partial flush. Two distinct cases:
+     *
+     * - Bare `ESC` (1 byte): flush through host shortcuts and the child
+     *   gate. The user pressed Esc and there is no continuation; the
+     *   child must still receive the byte after the safety window
+     *   (matching the dump detector's bare-Esc deferred-flush).
+     *
+     * - Truncated CSI (`ESC [ …`, 2+ bytes): drop. The user pressed
+     *   Home/PageUp/wheel/etc. and the terminal failed to deliver the
+     *   rest within the window. Forwarding raw `ESC [ < 6 4 ;` would
+     *   inject random bytes into the child agent — much worse than
+     *   losing one stray nav event.
+     */
+    private flushPartialSgr;
+    private resetSgrPartialTimer;
+    private resetSgrPartial;
+    /**
+     * Consume host scrollback / interrupt shortcuts from the chunk. Returns
+     * the chunk with any consumed bytes removed.
+     *
+     * Recognized sequences (single-chunk only — split CSI across two
+     * chunks falls through to the child unchanged, which is acceptable
+     * because real terminals deliver these in one chunk):
+     *
+     * - 0x03                 Ctrl+C            → onInterrupt()
+     * - ESC [ 5 ~            PageUp            → onScrollPages(-1)
+     * - ESC [ 6 ~            PageDown          → onScrollPages(+1)
+     * - ESC [ 1 ~ / ESC [ H  Home              → onScrollToTop()
+     * - ESC [ 4 ~ / ESC [ F  End               → onScrollToBottom()
+     *
+     * Modifier-prefixed variants (e.g. `ESC [ 1;5 H` for Ctrl+Home) match
+     * the same callback as their unmodified form.
+     */
+    private consumeHostShortcuts;
+    private dispatchCsi;
+    /**
+     * Route a deferred buffer (produced by `DumpHotkeyDetector` when a
+     * pending escape sequence times out). The deferred bytes have already
+     * been screened for the dump hotkey — they must NOT pass through the
+     * detector again. They DO continue through the parent UI mode, the
+     * SGR mouse parser, host shortcuts, and the child gate so a bare Esc
+     * reaches host-backed prompts and a deferred mouse sequence is still
+     * correctly classified.
+     */
+    private routeDeferred;
+    destroy(): void;
+}
+//# sourceMappingURL=input-router.d.ts.map

package/dist/terminal/input-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-router.d.ts","sourceRoot":"","sources":["../../src/terminal/input-router.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CACxC;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,oGAAoG;IACpG,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,iDAAiD;IACjD,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,8EAA8E;IAC9E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,WAAW;IAQV,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,YAAY,CAAiC;IACrD,kEAAkE;IAClE,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,eAAe,CAA4C;gBAEtC,OAAO,GAAE,kBAAuB;IAmB7D,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAIpC,WAAW,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI;IAKrC,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAIxC,cAAc,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,IAAI;IAKzC,+EAA+E;IAC/E,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAmCnC,OAAO,CAAC,cAAc;IAOtB;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,oBAAoB;IAsF5B,OAAO,CAAC,cAAc;IAMtB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,eAAe;IAOvB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,oBAAoB;IAmD5B,OAAO,CAAC,WAAW;IAqDnB;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IAgBrB,OAAO,IAAI,IAAI;CAOhB"}

package/dist/terminal/input-router.js

@@ -0,0 +1,426 @@
+import { DumpHotkeyDetector } from "../dump/hotkey.js";
+/**
+ * Number of lines to scroll for a single mouse-wheel event. Small enough
+ * to feel precise while still moving meaningfully on every notch.
+ */
+export const WHEEL_LINES_PER_EVENT = 3;
+const ETX = 0x03; // Ctrl+C
+const ESC = 0x1b;
+const LBRACKET = 0x5b; // '['
+const LT = 0x3c; // '<'
+const TILDE = 0x7e; // '~'
+/** Maximum dwell for a buffered partial SGR mouse sequence before we drop it. */
+const SGR_MOUSE_PARTIAL_TIMEOUT_MS = 50;
+/**
+ * Centralizes stdin ownership while the orchestration host is active.
+ *
+ * Routing order on each chunk:
+ *
+ *   1. Dump hotkey detector (Ctrl+]) — strips dump bytes from forward.
+ *      The detector also reassembles split CSI sequences for kitty /
+ *      win32 dump variants, so when configured, downstream stages see
+ *      whole sequences for those paths.
+ *   2. Active parent UI mode (if attached) — fully consumes by default.
+ *      Parent UI receives Ctrl+C, mouse, and nav keys first and may
+ *      handle them. Only when there is no parent UI, or it returns
+ *      `false`, does routing fall through to the host's own handlers.
+ *   3. SGR mouse-wheel parsing — consumes `CSI < 64/65 ; … M` for
+ *      vertical wheel events and dispatches scroll callbacks. Non-wheel
+ *      SGR mouse events flow through unchanged. A small first-class
+ *      buffer reassembles SGR mouse sequences split across chunks so
+ *      the routing works regardless of whether the dump detector is
+ *      configured.
+ *   4. Host shortcut routing on remaining bytes:
+ *        - Ctrl+C (0x03)        → `onInterrupt()`
+ *        - PageUp  (CSI 5~)     → `onScrollPages(-1)`
+ *        - PageDown (CSI 6~)    → `onScrollPages(+1)`
+ *        - Home    (CSI 1~/H)   → `onScrollToTop()`
+ *        - End     (CSI 4~/F)   → `onScrollToBottom()`
+ *   5. Attached child PTY when `gateOpen` is true — `handle.write(forward)`.
+ *   6. Otherwise the chunk is dropped.
+ */
+export class InputRouter {
+    options;
+    parentUiMode;
+    childHandle;
+    dumpDetector;
+    /** Buffered head of a split SGR mouse sequence (`ESC [ < … `). */
+    sgrPartial = [];
+    sgrPartialTimer;
+    constructor(options = {}) {
+        this.options = options;
+        if (this.options.onDump) {
+            const onDump = this.options.onDump;
+            this.dumpDetector = new DumpHotkeyDetector(() => onDump(), (deferred) => {
+                // Deferred flush — fires when DumpHotkeyDetector buffered an
+                // ESC (or partial CSI) and the timeout expired without a final
+                // byte arriving. Re-enter the routing pipeline so a bare ESC
+                // reaches an active parent UI mode (HostBackedCuratePrompt
+                // uses Esc to cancel comment editing). Only when there is no
+                // parent UI and the child gate is open does the bytes reach
+                // the child.
+                this.routeDeferred(deferred);
+            });
+        }
+    }
+    attachChild(handle) {
+        this.childHandle = handle;
+    }
+    detachChild(handle) {
+        if (handle && this.childHandle !== handle)
+            return;
+        this.childHandle = undefined;
+    }
+    attachParentUi(mode) {
+        this.parentUiMode = mode;
+    }
+    detachParentUi(mode) {
+        if (mode && this.parentUiMode !== mode)
+            return;
+        this.parentUiMode = undefined;
+    }
+    /** Process a stdin chunk. Returns true when at least one byte was consumed. */
+    handleChunk(chunk) {
+        // Global parent shortcuts run FIRST so Ctrl+] reliably triggers a
+        // dump regardless of which UI mode currently owns input. The detector
+        // strips the hotkey bytes from the forward buffer; everything else
+        // continues down the routing pipeline.
+        let forward = chunk;
+        if (this.dumpDetector) {
+            forward = this.dumpDetector.process(chunk);
+        }
+        if (forward.length === 0)
+            return true;
+        // Parent UI gets first crack at every byte that isn't the dump
+        // hotkey — including mouse events and nav keys. A host-backed
+        // prompt that wants to own wheel input simply consumes the chunk.
+        if (this.parentUiMode) {
+            const consumed = this.parentUiMode.onInput(forward);
+            // Default behaviour: parent UI swallows everything until detached.
+            if (consumed !== false) {
+                // The parent UI took ownership. Any partial SGR mouse sequence
+                // we previously buffered no longer applies — clear the buffer.
+                this.resetSgrPartial();
+                return true;
+            }
+        }
+        // Host owns the bytes. SGR mouse-wheel parsing comes BEFORE host
+        // shortcuts so wheel events don't accidentally match nav keys.
+        forward = this.consumeSgrMouseWheel(forward);
+        if (forward.length === 0)
+            return true;
+        const afterShortcuts = this.consumeHostShortcuts(forward);
+        if (afterShortcuts.length === 0)
+            return true;
+        return this.forwardToChild(afterShortcuts);
+    }
+    forwardToChild(buf) {
+        const child = this.childHandle;
+        if (!child || !child.gateOpen)
+            return false;
+        child.write(buf.toString());
+        return true;
+    }
+    /**
+     * Strip SGR mouse wheel events (`CSI < 64;…M` and `CSI < 65;…M`) from
+     * the chunk, dispatching scrollback callbacks. Non-wheel SGR mouse
+     * events (clicks, motion, releases) and other CSI sequences (Home,
+     * PageUp, etc.) are left in the chunk so callers can still forward
+     * them or run them through host shortcut routing.
+     *
+     * Sequences split across chunk boundaries are first-class. The buffer
+     * holds any incomplete CSI prefix — bare ESC, ESC `[`, ESC `[ < …` —
+     * and prepends it to the next chunk. This works even when the dump
+     * detector is not configured (the detector reassembles split CSI for
+     * its own purposes when it is configured, but mouse-wheel scrollback
+     * MUST NOT depend on it). A 50 ms safety timer flushes a stale
+     * partial through `consumeHostShortcuts` and the child gate so a
+     * bare Esc keypress eventually reaches the child even when there is
+     * no continuation, and so a stray ESC byte cannot permanently block
+     * future input.
+     */
+    consumeSgrMouseWheel(buf) {
+        // Prepend any buffered partial to this chunk before parsing.
+        if (this.sgrPartial.length > 0) {
+            const merged = Buffer.allocUnsafe(this.sgrPartial.length + buf.length);
+            for (let k = 0; k < this.sgrPartial.length; k++)
+                merged[k] = this.sgrPartial[k];
+            buf.copy(merged, this.sgrPartial.length);
+            buf = merged;
+            this.resetSgrPartialTimer();
+            this.sgrPartial = [];
+        }
+        if (buf.length === 0)
+            return buf;
+        const out = [];
+        let i = 0;
+        while (i < buf.length) {
+            const b = buf[i];
+            if (b !== ESC) {
+                out.push(b);
+                i++;
+                continue;
+            }
+            // ESC byte. The chunk ends here, after `[`, or after `[ < …`
+            // — buffer the partial in every case so a split mouse sequence
+            // never leaks to the child as half-bytes.
+            if (i + 1 >= buf.length) {
+                // Bare ESC at end-of-chunk. Could be (a) the Esc key, (b) the
+                // start of an Alt+key combo, or (c) the start of any CSI
+                // including SGR mouse. Buffering all three for 50 ms costs a
+                // small delay on the Esc key (matching the dump detector's
+                // own delay) but is the price of not forwarding partial mouse
+                // sequences to the child.
+                this.savePartialSgr(buf.subarray(i));
+                return Buffer.from(out);
+            }
+            if (buf[i + 1] !== LBRACKET) {
+                // ESC + non-`[` — Alt+key or another ESC-prefixed combo. Emit
+                // both bytes immediately so Alt+key combos are not delayed.
+                out.push(b);
+                i++;
+                continue;
+            }
+            // We have ESC `[`. Find the CSI final byte in the range 0x40-0x7e.
+            let j = i + 2;
+            while (j < buf.length) {
+                const t = buf[j];
+                if (t >= 0x40 && t <= 0x7e)
+                    break;
+                j++;
+            }
+            if (j >= buf.length) {
+                // Unterminated CSI — buffer the partial for the next chunk to
+                // complete. This covers all reviewer-flagged splits: ESC alone,
+                // `ESC [`, `ESC [ <`, `ESC [ < 64 ;`, etc.
+                this.savePartialSgr(buf.subarray(i));
+                return Buffer.from(out);
+            }
+            const params = buf.subarray(i + 2, j).toString("ascii");
+            const final = buf[j];
+            // SGR mouse-wheel sequence: ESC `[ < cb ; cx ; cy M` where
+            // cb=64 (wheel up) or cb=65 (wheel down). Anything else (clicks,
+            // releases, non-mouse CSI) is passed through unchanged.
+            if (params.startsWith("<") && final === 0x4d /* M */) {
+                const cb = parseInt(params.slice(1).split(";")[0] ?? "", 10);
+                if (cb === 64) {
+                    this.options.onScrollBackLines?.(WHEEL_LINES_PER_EVENT);
+                    i = j + 1;
+                    continue;
+                }
+                if (cb === 65) {
+                    this.options.onScrollForwardLines?.(WHEEL_LINES_PER_EVENT);
+                    i = j + 1;
+                    continue;
+                }
+            }
+            // Not a mouse wheel — emit the entire CSI sequence intact.
+            for (let k = i; k <= j; k++)
+                out.push(buf[k]);
+            i = j + 1;
+        }
+        return Buffer.from(out);
+    }
+    savePartialSgr(partial) {
+        this.sgrPartial = Array.from(partial);
+        if (this.sgrPartialTimer)
+            clearTimeout(this.sgrPartialTimer);
+        this.sgrPartialTimer = setTimeout(() => this.flushPartialSgr(), SGR_MOUSE_PARTIAL_TIMEOUT_MS);
+    }
+    /**
+     * Stale-partial flush. Two distinct cases:
+     *
+     * - Bare `ESC` (1 byte): flush through host shortcuts and the child
+     *   gate. The user pressed Esc and there is no continuation; the
+     *   child must still receive the byte after the safety window
+     *   (matching the dump detector's bare-Esc deferred-flush).
+     *
+     * - Truncated CSI (`ESC [ …`, 2+ bytes): drop. The user pressed
+     *   Home/PageUp/wheel/etc. and the terminal failed to deliver the
+     *   rest within the window. Forwarding raw `ESC [ < 6 4 ;` would
+     *   inject random bytes into the child agent — much worse than
+     *   losing one stray nav event.
+     */
+    flushPartialSgr() {
+        if (this.sgrPartial.length === 0) {
+            this.sgrPartialTimer = undefined;
+            return;
+        }
+        const buf = Buffer.from(this.sgrPartial);
+        this.sgrPartial = [];
+        this.sgrPartialTimer = undefined;
+        if (buf.length === 1 && buf[0] === ESC) {
+            const afterShortcuts = this.consumeHostShortcuts(buf);
+            if (afterShortcuts.length > 0)
+                this.forwardToChild(afterShortcuts);
+        }
+        // Else: drop the truncated CSI prefix.
+    }
+    resetSgrPartialTimer() {
+        if (this.sgrPartialTimer) {
+            clearTimeout(this.sgrPartialTimer);
+            this.sgrPartialTimer = undefined;
+        }
+    }
+    resetSgrPartial() {
+        this.resetSgrPartialTimer();
+        if (this.sgrPartial.length > 0) {
+            this.sgrPartial = [];
+        }
+    }
+    /**
+     * Consume host scrollback / interrupt shortcuts from the chunk. Returns
+     * the chunk with any consumed bytes removed.
+     *
+     * Recognized sequences (single-chunk only — split CSI across two
+     * chunks falls through to the child unchanged, which is acceptable
+     * because real terminals deliver these in one chunk):
+     *
+     * - 0x03                 Ctrl+C            → onInterrupt()
+     * - ESC [ 5 ~            PageUp            → onScrollPages(-1)
+     * - ESC [ 6 ~            PageDown          → onScrollPages(+1)
+     * - ESC [ 1 ~ / ESC [ H  Home              → onScrollToTop()
+     * - ESC [ 4 ~ / ESC [ F  End               → onScrollToBottom()
+     *
+     * Modifier-prefixed variants (e.g. `ESC [ 1;5 H` for Ctrl+Home) match
+     * the same callback as their unmodified form.
+     */
+    consumeHostShortcuts(buf) {
+        if (buf.length === 0)
+            return buf;
+        const out = [];
+        let i = 0;
+        while (i < buf.length) {
+            const b = buf[i];
+            if (b === ETX) {
+                if (this.options.onInterrupt) {
+                    this.options.onInterrupt();
+                    i++;
+                    continue;
+                }
+                // No interrupt handler — fall through to child.
+                out.push(b);
+                i++;
+                continue;
+            }
+            if (b === ESC && i + 1 < buf.length && buf[i + 1] === LBRACKET) {
+                // Find the CSI final byte.
+                let j = i + 2;
+                while (j < buf.length) {
+                    const t = buf[j];
+                    if (t >= 0x40 && t <= 0x7e)
+                        break;
+                    j++;
+                }
+                if (j >= buf.length) {
+                    // Unterminated — emit remainder unchanged.
+                    for (let k = i; k < buf.length; k++)
+                        out.push(buf[k]);
+                    return Buffer.from(out);
+                }
+                const params = buf.subarray(i + 2, j).toString("ascii");
+                const final = buf[j];
+                const handled = this.dispatchCsi(params, final);
+                if (handled) {
+                    i = j + 1;
+                    continue;
+                }
+                // Not a host shortcut — pass through unchanged.
+                for (let k = i; k <= j; k++)
+                    out.push(buf[k]);
+                i = j + 1;
+                continue;
+            }
+            out.push(b);
+            i++;
+        }
+        return Buffer.from(out);
+    }
+    dispatchCsi(params, final) {
+        // PageUp = ESC [ 5 ~ ; PageDown = ESC [ 6 ~ ; Home = ESC [ 1 ~ or H ;
+        // End = ESC [ 4 ~ or F. Modifier params (e.g. "1;5") are accepted so
+        // Ctrl/Shift+nav routes through the same scroll callback.
+        if (final === TILDE) {
+            const code = parseInt(params.split(";")[0] ?? "", 10);
+            if (code === 5) {
+                if (this.options.onScrollPages) {
+                    this.options.onScrollPages(-1);
+                    return true;
+                }
+                return false;
+            }
+            if (code === 6) {
+                if (this.options.onScrollPages) {
+                    this.options.onScrollPages(1);
+                    return true;
+                }
+                return false;
+            }
+            if (code === 1 || code === 7) {
+                if (this.options.onScrollToTop) {
+                    this.options.onScrollToTop();
+                    return true;
+                }
+                return false;
+            }
+            if (code === 4 || code === 8) {
+                if (this.options.onScrollToBottom) {
+                    this.options.onScrollToBottom();
+                    return true;
+                }
+                return false;
+            }
+            return false;
+        }
+        if (final === 0x48 /* H */) {
+            if (this.options.onScrollToTop) {
+                this.options.onScrollToTop();
+                return true;
+            }
+            return false;
+        }
+        if (final === 0x46 /* F */) {
+            if (this.options.onScrollToBottom) {
+                this.options.onScrollToBottom();
+                return true;
+            }
+            return false;
+        }
+        return false;
+    }
+    /**
+     * Route a deferred buffer (produced by `DumpHotkeyDetector` when a
+     * pending escape sequence times out). The deferred bytes have already
+     * been screened for the dump hotkey — they must NOT pass through the
+     * detector again. They DO continue through the parent UI mode, the
+     * SGR mouse parser, host shortcuts, and the child gate so a bare Esc
+     * reaches host-backed prompts and a deferred mouse sequence is still
+     * correctly classified.
+     */
+    routeDeferred(buf) {
+        if (buf.length === 0)
+            return false;
+        if (this.parentUiMode) {
+            const consumed = this.parentUiMode.onInput(buf);
+            if (consumed !== false) {
+                this.resetSgrPartial();
+                return true;
+            }
+        }
+        const afterMouse = this.consumeSgrMouseWheel(buf);
+        if (afterMouse.length === 0)
+            return true;
+        const afterShortcuts = this.consumeHostShortcuts(afterMouse);
+        if (afterShortcuts.length === 0)
+            return true;
+        return this.forwardToChild(afterShortcuts);
+    }
+    destroy() {
+        this.dumpDetector?.destroy();
+        this.dumpDetector = undefined;
+        this.resetSgrPartial();
+        this.childHandle = undefined;
+        this.parentUiMode = undefined;
+    }
+}
+//# sourceMappingURL=input-router.js.map

package/dist/terminal/input-router.js.map

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

package/dist/terminal/layout.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Pure layout computation for the orchestration terminal host.
+ *
+ * The host owns the real terminal during orchestration. The single
+ * source of truth for "how big is the child viewport", "where does the
+ * warning strip go", and "where does the status row go" is
+ * `computeTerminalLayout()`. PTY spawn, virtual-terminal sizing, child
+ * rendering, warning rendering, and status-bar rendering all read from
+ * the same layout object.
+ *
+ * Policy:
+ * - When status is enabled and rows >= 2, reserve exactly 1 status row.
+ * - When rows === 1, reserve 0 status rows; the child gets the only row.
+ * - When status is disabled (non-host or non-TTY), reserve 0 status rows.
+ * - `warningRows` is the host-owned warning strip immediately above the
+ *   status row. It is clamped to 0..3 and capped further so the child
+ *   viewport always keeps at least 1 row.
+ */
+export interface TerminalLayout {
+    /** Total visible columns. */
+    columns: number;
+    /** Total visible rows. */
+    rows: number;
+    /** Number of bottom rows reserved for the status bar (0 or 1). */
+    statusRows: 0 | 1;
+    /** Number of rows reserved for the host-owned warning strip (0..3). */
+    warningRows: number;
+    /** Child viewport columns — currently equals `columns`. */
+    childCols: number;
+    /** Child viewport rows = max(1, rows - statusRows - warningRows). */
+    childRows: number;
+    /** 1-based row index of the first warning row, or undefined when warningRows === 0. */
+    warningStartRow: number | undefined;
+    /** 1-based row index of the status line, or undefined when statusRows === 0. */
+    statusRow: number | undefined;
+}
+export interface LayoutInput {
+    columns: number;
+    rows: number;
+    statusEnabled: boolean;
+    /** Requested warning strip height. Clamped to 0..3 and to available height. */
+    warningRows?: number;
+}
+/**
+ * Compute the host layout. Pure: no side effects.
+ *
+ * - `columns` and `rows` are clamped to >= 1 even if the input is 0/negative.
+ * - `statusRows` is 1 only when `statusEnabled` AND `rows >= 2`.
+ * - `warningRows` is clamped to 0..3, then capped so `childRows >= 1`.
+ * - `childRows` is always >= 1.
+ * - `warningStartRow` is the first warning row (1-based) when `warningRows > 0`, else undefined.
+ * - `statusRow` is the 1-based bottom row when reserved, otherwise undefined.
+ */
+export declare function computeTerminalLayout(input: LayoutInput): TerminalLayout;
+//# sourceMappingURL=layout.d.ts.map

package/dist/terminal/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/terminal/layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;IAClB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,gFAAgF;IAChF,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CAqBxE"}