poly-weaver 0.5.0 → 0.6.0

package/dist/status-bar.js

@@ -31,15 +31,30 @@ export class StatusBar {
     gitInfo = null;
     flashTimer;
     flashMessage;
-    constructor(out) {
+    hostManaged;
+    onChange;
+    constructor(out, options) {
         this.out = out ?? process.stdout;
-        this.enabled =
-            this.out.isTTY === true && (this.out.rows ?? 0) >= 5;
+        this.hostManaged = options?.hostManaged ?? false;
+        this.onChange = options?.onChange;
+        // Host-managed mode does not gate on terminal height — the host's
+        // layout module handles the small-terminal policy (1-row terminal
+        // gets no status row; 2-4 row terminals get a compact status row).
+        // Legacy mode still requires >= 5 rows because its scroll-region
+        // approach needs at least one row above the bar.
+        this.enabled = this.hostManaged
+            ? this.out.isTTY === true
+            : this.out.isTTY === true && (this.out.rows ?? 0) >= 5;
         this.barRow = this.out.rows ?? 0;
     }
     init() {
         if (!this.enabled)
             return;
+        if (this.hostManaged) {
+            // Host owns the screen; just notify so it can paint the bar.
+            this.notify();
+            return;
+        }
         this.barRow = this.out.rows;
         // Set scroll region with cursor save/restore (no cursor homing)
         this.out.write(`\x1b7\x1b[1;${this.barRow - 1}r\x1b8`);
@@ -62,6 +77,11 @@ export class StatusBar {
         if (!this.enabled)
             return;
         this.lastCtx = ctx;
+        if (this.hostManaged) {
+            if (!this.flashMessage)
+                this.notify();
+            return;
+        }
         if (!this.flashMessage)
             this.drawBar();
     }
@@ -78,18 +98,33 @@ export class StatusBar {
         }
         this.flashMessage = message;
         this.lastDrawnOutput = undefined;
-        this.drawBar();
+        if (this.hostManaged) {
+            this.notify();
+        }
+        else {
+            this.drawBar();
+        }
         this.flashTimer = setTimeout(() => {
             this.flashTimer = undefined;
             this.flashMessage = undefined;
             this.lastDrawnOutput = undefined;
-            this.drawBar();
+            if (this.hostManaged) {
+                this.notify();
+            }
+            else {
+                this.drawBar();
+            }
         }, durationMs);
     }
     setGitInfo(info) {
         this.gitInfo = info;
-        if (this.enabled)
-            this.drawBar();
+        if (!this.enabled)
+            return;
+        if (this.hostManaged) {
+            this.notify();
+            return;
+        }
+        this.drawBar();
     }
     destroy() {
         if (!this.enabled)
@@ -107,12 +142,49 @@ export class StatusBar {
             this.out.removeListener("resize", this.resizeHandler);
             this.resizeHandler = undefined;
         }
+        if (this.hostManaged) {
+            // Host owns cleanup of the alternate screen; nothing to write here.
+            return;
+        }
         // Clear bar and reset scroll region (cursor-safe)
         this.out.write(`\x1b7\x1b[${this.barRow};1H\x1b[2K\x1b[r\x1b8`);
     }
     get reservedRows() {
         return this.enabled ? 1 : 0;
     }
+    /**
+     * Pure rendering: return the bar content padded/clipped to `columns`,
+     * including reverse-video on/off. Used by the orchestration host to
+     * paint the status row over the child viewport.
+     */
+    render(columns) {
+        const content = this.formatContent();
+        const padded = padOrClip(content, columns);
+        return `\x1b[0m\x1b[7m${padded}\x1b[27m\x1b[0m`;
+    }
+    /** Plain content used both by host render() and legacy drawBar(). */
+    formatContent() {
+        if (this.flashMessage) {
+            return ` ${this.flashMessage}`;
+        }
+        const gitSeg = this.formatGitSegment();
+        if (!this.lastCtx) {
+            return gitSeg
+                ? ` poly-weaver v${APP_VERSION} │ ${gitSeg}`
+                : ` poly-weaver v${APP_VERSION}`;
+        }
+        const phaseLabel = this.lastCtx.phase;
+        const ctx = formatContext(this.lastCtx);
+        const segments = [` poly-weaver v${APP_VERSION}`];
+        if (gitSeg)
+            segments.push(gitSeg);
+        segments.push(phaseLabel);
+        if (this.lastCtx.agent)
+            segments.push(this.lastCtx.agent);
+        if (ctx)
+            segments.push(ctx);
+        return segments.join(" │ ");
+    }
     formatGitSegment() {
         if (!this.gitInfo)
             return null;
@@ -120,36 +192,14 @@ export class StatusBar {
         const wt = this.gitInfo.isWorktree ? " \u{1F332}" : "";
         return `${animal} ${this.gitInfo.branch}${wt}`;
     }
+    notify() {
+        this.onChange?.();
+    }
     drawBar() {
         const columns = this.out.columns ?? 80;
-        let content;
-        if (this.flashMessage) {
-            content = ` ${this.flashMessage}`;
-        }
-        else {
-            const gitSeg = this.formatGitSegment();
-            if (!this.lastCtx) {
-                content = gitSeg
-                    ? ` poly-weaver v${APP_VERSION} \u2502 ${gitSeg}`
-                    : ` poly-weaver v${APP_VERSION}`;
-            }
-            else {
-                const phaseLabel = this.lastCtx.phase;
-                const ctx = formatContext(this.lastCtx);
-                const segments = [` poly-weaver v${APP_VERSION}`];
-                if (gitSeg)
-                    segments.push(gitSeg);
-                segments.push(phaseLabel);
-                if (this.lastCtx.agent)
-                    segments.push(this.lastCtx.agent);
-                if (ctx)
-                    segments.push(ctx);
-                content = segments.join(" \u2502 ");
-            }
-        }
+        const content = this.formatContent();
         // Pad visible content to full terminal width
-        const pad = columns - visibleLength(content);
-        const padded = pad > 0 ? content + " ".repeat(pad) : content;
+        const padded = padOrClip(content, columns);
         // Atomic write: save cursor, re-establish scroll region, draw bar, restore cursor
         const output = `\x1b7` +
             `\x1b[1;${this.barRow - 1}r` +
@@ -166,4 +216,29 @@ export class StatusBar {
         this.out.write(output);
     }
 }
+function padOrClip(content, columns) {
+    const vis = visibleLength(content);
+    if (vis === columns)
+        return content;
+    if (vis < columns)
+        return content + " ".repeat(columns - vis);
+    // Clip on visible characters; preserve any inline ANSI escape sequences.
+    let out = "";
+    let count = 0;
+    let i = 0;
+    while (i < content.length && count < columns) {
+        if (content[i] === "\x1b" && content[i + 1] === "[") {
+            const m = content.slice(i).match(/^\x1b\[[0-9;]*m/);
+            if (m) {
+                out += m[0];
+                i += m[0].length;
+                continue;
+            }
+        }
+        out += content[i];
+        count += 1;
+        i += 1;
+    }
+    return out;
+}
 //# sourceMappingURL=status-bar.js.map

package/dist/status-bar.js.map

@@ -1 +1 @@
-{"version":3,"file":"status-bar.js","sourceRoot":"","sources":["../src/status-bar.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"status-bar.js","sourceRoot":"","sources":["../src/status-bar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAW3C,SAAS,aAAa,CAAC,GAAkB;IACvC,IAAI,GAAG,CAAC,SAAS,IAAI,IAAI,IAAI,GAAG,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;QACvD,OAAO,aAAa,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,aAAa,GAAG;IACpB,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9C,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9C,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9C,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CAC/C,CAAC;AAEF,gEAAgE;AAChE,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,IAAI,CAAC,GAAG,IAAI,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAC3D,CAAC;AAYD,MAAM,OAAO,SAAS;IACZ,OAAO,CAAU;IACjB,MAAM,CAAS;IACf,OAAO,CAA4B;IACnC,GAAG,CAAqB;IACxB,aAAa,CAA2B;IACxC,WAAW,CAA6C;IACxD,eAAe,CAAqB;IACpC,OAAO,GAAmB,IAAI,CAAC;IAC/B,UAAU,CAA4C;IACtD,YAAY,CAAqB;IACjC,WAAW,CAAU;IACrB,QAAQ,CAAc;IAE9B,YAAY,GAAwB,EAAE,OAA0B;QAC9D,IAAI,CAAC,GAAG,GAAG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,KAAK,CAAC;QACjD,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;QAClC,kEAAkE;QAClE,kEAAkE;QAClE,mEAAmE;QACnE,iEAAiE;QACjE,iDAAiD;QACjD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,WAAW;YAC7B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,IAAI;YACzB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,6DAA6D;YAC7D,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAK,CAAC;QAE7B,gEAAgE;QAChE,IAAI,CAAC,GAAG,CAAC,KAAK,CACZ,eAAe,IAAI,CAAC,MAAM,GAAG,CAAC,QAAQ,CACvC,CAAC;QAEF,mBAAmB;QACnB,IAAI,CAAC,OAAO,EAAE,CAAC;QAEf,yBAAyB;QACzB,IAAI,CAAC,aAAa,GAAG,GAAG,EAAE;YACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAK,CAAC;YAC7B,IAAI,CAAC,GAAG,CAAC,KAAK,CACZ,eAAe,IAAI,CAAC,MAAM,GAAG,CAAC,QAAQ,CACvC,CAAC;YACF,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAE1C,qDAAqD;QACrD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;YAClC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;YACjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC,EAAE,IAAI,CAAC,CAAC;IACX,CAAC;IAED,MAAM,CAAC,GAAkB;QACvB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;QACnB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,IAAI,CAAC,YAAY;gBAAE,IAAI,CAAC,MAAM,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAe,EAAE,UAAU,GAAG,IAAI;QACtC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;YAC5B,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QAC5B,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACjC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;YAC5B,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;YAC9B,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;YACjC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,CAAC;QACH,CAAC,EAAE,UAAU,CAAC,CAAC;IACjB,CAAC;IAED,UAAU,CAAC,IAAa;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QAErB,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;YAC5B,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC9B,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;YAC7B,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAChC,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC/B,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YACtD,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;QACjC,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,oEAAoE;YACpE,OAAO;QACT,CAAC;QAED,kDAAkD;QAClD,IAAI,CAAC,GAAG,CAAC,KAAK,CACZ,aAAa,IAAI,CAAC,MAAM,uBAAuB,CAChD,CAAC;IACJ,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAe;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3C,OAAO,iBAAiB,MAAM,iBAAiB,CAAC;IAClD,CAAC;IAED,qEAAqE;IAC7D,aAAa;QACnB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACjC,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,MAAM;gBACX,CAAC,CAAC,iBAAiB,WAAW,MAAM,MAAM,EAAE;gBAC5C,CAAC,CAAC,iBAAiB,WAAW,EAAE,CAAC;QACrC,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QACtC,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAa,CAAC,iBAAiB,WAAW,EAAE,CAAC,CAAC;QAC5D,IAAI,MAAM;YAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1B,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1D,IAAI,GAAG;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAEO,gBAAgB;QACtB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC/B,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;IACjD,CAAC;IAEO,MAAM;QACZ,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;IACpB,CAAC;IAEO,OAAO;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QAErC,6CAA6C;QAC7C,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAE3C,kFAAkF;QAClF,MAAM,MAAM,GACV,OAAO;YACP,UAAU,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG;YAC5B,QAAQ,IAAI,CAAC,MAAM,KAAK;YACxB,SAAS;YACT,SAAS;YACT,SAAS;YACT,MAAM;YACN,UAAU;YACV,OAAO,CAAC;QAEV,IAAI,MAAM,KAAK,IAAI,CAAC,eAAe;YAAE,OAAO;QAC5C,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;CACF;AAED,SAAS,SAAS,CAAC,OAAe,EAAE,OAAe;IACjD,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,GAAG,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACpC,IAAI,GAAG,GAAG,OAAO;QAAE,OAAO,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC;IAC9D,yEAAyE;IACzE,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,GAAG,OAAO,EAAE,CAAC;QAC7C,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACpD,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACpD,IAAI,CAAC,EAAE,CAAC;gBACN,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBACZ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBACjB,SAAS;YACX,CAAC;QACH,CAAC;QACD,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;QAClB,KAAK,IAAI,CAAC,CAAC;QACX,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/terminal/cleanup.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Best-effort terminal cleanup payload written by the abrupt-exit
+ * fallback in `src/cli.ts`. The host's `TerminalHost.stop()` performs
+ * the equivalent set of writes during normal shutdown; this constant
+ * covers the abrupt path (SIGINT, unhandled exception, or a
+ * `process.exit()` from outside the orchestration `finally` block).
+ *
+ * Order:
+ *   1. RESET_SCROLL_REGION — undo any legacy StatusBar scroll region.
+ *   2. CLEAR_SCREEN — wipe the visible buffer.
+ *   3. CURSOR_HOME — move the cursor home so the user does not see a
+ *      stale prompt at row N.
+ *   4. ALT_SCREEN_OFF — leave the alternate screen so the user lands
+ *      back on their original terminal contents.
+ *   5. SHOW_CURSOR — undo the host's `HIDE_CURSOR`.
+ *
+ * Exported as a constant so tests can verify the sequence without
+ * importing `src/cli.ts` (which has top-level side effects).
+ */
+export declare const ABRUPT_EXIT_CLEANUP: string;
+//# sourceMappingURL=cleanup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/terminal/cleanup.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,QACiD,CAAC"}

package/dist/terminal/cleanup.js

@@ -0,0 +1,22 @@
+import { ALT_SCREEN_OFF, CLEAR_SCREEN, CURSOR_HOME, RESET_SCROLL_REGION, SHOW_CURSOR, } from "../ansi.js";
+/**
+ * Best-effort terminal cleanup payload written by the abrupt-exit
+ * fallback in `src/cli.ts`. The host's `TerminalHost.stop()` performs
+ * the equivalent set of writes during normal shutdown; this constant
+ * covers the abrupt path (SIGINT, unhandled exception, or a
+ * `process.exit()` from outside the orchestration `finally` block).
+ *
+ * Order:
+ *   1. RESET_SCROLL_REGION — undo any legacy StatusBar scroll region.
+ *   2. CLEAR_SCREEN — wipe the visible buffer.
+ *   3. CURSOR_HOME — move the cursor home so the user does not see a
+ *      stale prompt at row N.
+ *   4. ALT_SCREEN_OFF — leave the alternate screen so the user lands
+ *      back on their original terminal contents.
+ *   5. SHOW_CURSOR — undo the host's `HIDE_CURSOR`.
+ *
+ * Exported as a constant so tests can verify the sequence without
+ * importing `src/cli.ts` (which has top-level side effects).
+ */
+export const ABRUPT_EXIT_CLEANUP = RESET_SCROLL_REGION + CLEAR_SCREEN + CURSOR_HOME + ALT_SCREEN_OFF + SHOW_CURSOR;
+//# sourceMappingURL=cleanup.js.map

package/dist/terminal/cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../src/terminal/cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,mBAAmB,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,WAAW,CAAC"}

package/dist/terminal/host.d.ts

@@ -0,0 +1,244 @@
+import { type TerminalLayout } from "./layout.js";
+import { BufferOrchestrationOutput, type OrchestrationOutput } from "./output.js";
+import { type ParentUiMode } from "./input-router.js";
+import type { PtyHandle } from "../pty/types.js";
+import type { StatusBar } from "../status-bar.js";
+export interface TerminalHostOptions {
+    stdin?: NodeJS.ReadStream;
+    stdout?: NodeJS.WriteStream;
+    /** Status model (host-managed). */
+    statusBar?: StatusBar;
+    /** Override host-managed output sink. Defaults to a fresh BufferOrchestrationOutput. */
+    output?: BufferOrchestrationOutput;
+    /** Trigger to capture a debug dump (e.g. wire to DumpService). */
+    onDump?: () => void;
+}
+/**
+ * I/O surface handed to a callback running inside `runIsolatedAltScreen`.
+ * The callback owns the alternate screen for its duration; the host has
+ * left its own alt screen and removed its stdin listener.
+ */
+export interface IsolatedAltScreenIo {
+    stdin: NodeJS.ReadStream;
+    stdout: NodeJS.WriteStream;
+    /** Current terminal columns. */
+    columns: number;
+    /** Current terminal rows. */
+    rows: number;
+    /** Trigger the host's configured dump callback. No-op when none. */
+    triggerDump(): void;
+}
+/**
+ * A parent UI mode that contributes display lines and an optional cursor
+ * placement to the host's frame. The host renders these lines in the area
+ * between the child viewport and the status bar.
+ */
+export interface HostUiSurface {
+    /** Lines (top-to-bottom) to render inside the host-controlled UI area. */
+    lines: string[];
+    /**
+     * Cursor placement relative to `lines`. `row` is 0-based row index into
+     * `lines`. `col` is the visible column (0-based). When undefined, the
+     * host hides the cursor.
+     */
+    cursor?: {
+        row: number;
+        col: number;
+    };
+}
+/**
+ * Host-backed parent UI mode. Combines `ParentUiMode.onInput` (input)
+ * with a `getSurface()` query that contributes rendered content. The host
+ * calls `getSurface()` on every frame.
+ */
+export interface HostParentUiMode extends ParentUiMode {
+    getSurface(): HostUiSurface;
+}
+/**
+ * Parent-owned orchestration terminal host.
+ *
+ * While `started`, the host:
+ *   - Owns the alternate screen, raw stdin mode, and `process.stdout` writes
+ *     for the orchestration phase.
+ *   - Maintains a `@xterm/headless` virtual terminal sized from the host
+ *     layout. PTY data passes through the virtual terminal before display.
+ *   - Schedules coalesced repaints so bursty PTY output renders as one frame.
+ *   - Renders, in order: child viewport, parent UI / message area,
+ *     and finally the status bar on `layout.statusRow`.
+ *   - Routes stdin through global shortcuts (dump hotkey, host scrollback,
+ *     host interrupt), then the active parent UI mode (review prompts,
+ *     etc.), then the attached child.
+ *   - Enables SGR mouse reporting on the real terminal so wheel events
+ *     drive the host-managed scrollback viewport, and disables it on
+ *     teardown / suspension so foreign UIs and the post-host shell are
+ *     not left with mouse mode turned on.
+ */
+export declare class TerminalHost {
+    private readonly stdin;
+    private readonly stdout;
+    private readonly router;
+    private readonly bufferOutput;
+    private readonly onDump;
+    private readonly interruptListeners;
+    private statusBar;
+    private childHandle;
+    private vt;
+    private layout;
+    private started;
+    private stopped;
+    private suspended;
+    private prevRawMode;
+    private resizeListener;
+    private renderScheduled;
+    private pendingFlush;
+    /**
+     * Set whenever any caller requests a full repaint (PTY output, resize,
+     * output buffer changes, status updates, attach/detach). When false at
+     * flush time AND a parent UI is attached with a full-height surface,
+     * the host can skip the child viewport render and only repaint the
+     * parent UI surface + status row. Any subsequent full request before
+     * flush flips it back to true.
+     */
+    private pendingFullRender;
+    private stdinListener;
+    private parentUi;
+    constructor(opts?: TerminalHostOptions);
+    /** True only when the host has entered the alternate screen. */
+    get isActive(): boolean;
+    /**
+     * True when the host's configured stdin is a TTY. Host-backed prompts
+     * gate interactivity on this — never on `process.stdin.isTTY` — so an
+     * embedded host with a non-default stdin still drives prompt I/O off
+     * the host-owned stream.
+     */
+    get isInteractive(): boolean;
+    /** Public output sink — orchestration code writes here. */
+    get output(): OrchestrationOutput;
+    /** Current layout snapshot. Computed on demand when not yet started. */
+    getLayout(): TerminalLayout;
+    /** Replace the status model after construction. */
+    attachStatusBar(bar: StatusBar): void;
+    /**
+     * Subscribe to host interrupt events (raw Ctrl+C while no parent UI
+     * consumes the byte). Returns an idempotent unsubscribe function.
+     *
+     * The host does not rely on process-level `SIGINT` — raw mode prevents
+     * the parent process from receiving SIGINT normally. Listeners are
+     * cleared on `stop()` so stale callbacks cannot fire after teardown.
+     */
+    onInterrupt(callback: () => void): () => void;
+    start(): void;
+    stop(): void;
+    /**
+     * Attach a PTY handle to the host. The host begins routing PTY data
+     * through the virtual terminal and displays it on the next render tick.
+     *
+     * The closure-bound handle is captured inside the data callback. After
+     * `detachChild()`, late `onData` events for the previously attached
+     * handle no longer feed the virtual terminal — so provider exit chatter
+     * cannot leak onto the screen even though node-pty does not expose an
+     * `off` for the listener.
+     *
+     * The returned function detaches the child idempotently.
+     */
+    attachChild(handle: PtyHandle): () => void;
+    detachChild(handle?: PtyHandle): void;
+    /**
+     * Discard the current child surface (VT screen + scrollback) and
+     * schedule a render. Use this after a provider run completes so the
+     * next host frame is blank instead of showing the finished agent's
+     * trailing output.
+     */
+    clearChildSurface(): void;
+    /** Dispose the current `VirtualTerminal` and create a fresh one sized to the current layout. */
+    private resetVirtualTerminal;
+    /**
+     * Attach a parent UI mode. The host routes stdin through the mode's
+     * `onInput` and queries `getSurface()` (when present) on every frame.
+     * Returns a detach function.
+     */
+    attachParentUi(mode: ParentUiMode): () => void;
+    detachParentUi(mode?: ParentUiMode): void;
+    /**
+     * Suspend the host and run `run` while a foreign UI owns the terminal.
+     *
+     * The host:
+     *   - leaves its own alternate screen,
+     *   - disables mouse reporting so the foreign UI is not flooded with
+     *     SGR mouse sequences,
+     *   - removes its stdin data listener,
+     *   - restores the prior raw-mode state,
+     *   - blocks `scheduleRender()`/`renderNow()` until resume,
+     *   - keeps the virtual terminal, output buffer, router, and status bar
+     *     intact so any data buffered during suspension is preserved for
+     *     repaint after resume.
+     *
+     * On resume the host re-enters its alt screen, re-enables mouse
+     * reporting, re-installs its raw-mode stdin listener, recomputes
+     * layout, resizes the attached child if any, and schedules a repaint.
+     *
+     * Throws when the host is not active. The `finally` clause always
+     * restores host ownership, even when `run` throws.
+     */
+    runIsolatedAltScreen<T>(run: (io: IsolatedAltScreenIo) => Promise<T>): Promise<T>;
+    /** Force an immediate render (synchronously composes one frame). */
+    renderNow(): void;
+    /**
+     * Schedule a coalesced full render; multiple events in the same tick
+     * produce one frame. Use this for any change that can affect the child
+     * viewport, output buffer, status content, or layout.
+     */
+    scheduleRender(): void;
+    /**
+     * Schedule a coalesced parent-UI-only render. Used by host-backed
+     * prompts when only their own state changed (typing, scroll, cursor
+     * move). Skips the child viewport pass so prompt keystrokes do not
+     * cause a visible repaint of the unchanged child area.
+     *
+     * If any other request in the same tick demands a full render, the
+     * coalesced flush upgrades to a full render automatically.
+     *
+     * If the parent UI surface is shorter than `layout.childRows` at flush
+     * time, the host falls back to a full render — correctness must not
+     * depend on the prompt always producing a full-height surface.
+     */
+    scheduleParentUiRender(): void;
+    private scheduleFlush;
+    private fireInterrupt;
+    private handleScrollBackLines;
+    private handleScrollForwardLines;
+    private handleScrollPages;
+    private handleScrollToTop;
+    private handleScrollToBottom;
+    private renderUiSurface;
+    private renderMessages;
+    private handleResize;
+    private computeLayout;
+    /**
+     * Buffer-change hook. Recomputes layout — the warning strip grows or
+     * shrinks with buffered message count — and propagates child-viewport
+     * size changes to the virtual terminal and the attached child PTY
+     * before scheduling a coalesced repaint.
+     */
+    private handleOutputChange;
+}
+/**
+ * Map a surface-relative cursor position to a 1-based screen position.
+ *
+ * When the surface fits inside the child rows, the entire surface paints
+ * starting at row `childRows - lines.length + 1` (1-based) and the cursor
+ * row maps directly. When the surface overflows, the host paints only the
+ * trailing window — `lines.slice(-childRows)` — at the top of the host
+ * region. The cursor row is meaningful only when it falls inside that
+ * window; otherwise the visible position is undefined and the host hides
+ * the cursor instead of clamping to a wrong row.
+ *
+ * Returns 1-based `{ row, col }` (so callers can paste into `\x1b[r;cH`)
+ * when the cursor is visible, or `undefined` when it's outside the
+ * visible window.
+ */
+export declare function mapSurfaceCursorToScreen(layout: TerminalLayout, surface: HostUiSurface): {
+    row: number;
+    col: number;
+} | undefined;
+//# sourceMappingURL=host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/terminal/host.ts"],"names":[],"mappings":"AAYA,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,EACL,yBAAyB,EAEzB,KAAK,mBAAmB,EACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC5B,mCAAmC;IACnC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,wFAAwF;IACxF,MAAM,CAAC,EAAE,yBAAyB,CAAC;IACnC,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC;IAC3B,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,WAAW,IAAI,IAAI,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,UAAU,IAAI,aAAa,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAyB;IAC5D,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,EAAE,CAA8B;IACxC,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,YAAY,CAAS;IAC7B;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,QAAQ,CAA2B;gBAE/B,IAAI,GAAE,mBAAwB;IAyB1C,gEAAgE;IAChE,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;OAKG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,2DAA2D;IAC3D,IAAI,MAAM,IAAI,mBAAmB,CAEhC;IAED,wEAAwE;IACxE,SAAS,IAAI,cAAc;IAO3B,mDAAmD;IACnD,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAMrC;;;;;;;OAOG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAU7C,KAAK,IAAI,IAAI;IAwBb,IAAI,IAAI,IAAI;IAiCZ;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,IAAI;IAwD1C,WAAW,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI;IAUrC;;;;;OAKG;IACH,iBAAiB,IAAI,IAAI;IAKzB,gGAAgG;IAChG,OAAO,CAAC,oBAAoB;IAQ5B;;;;OAIG;IACH,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,IAAI;IAO9C,cAAc,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,IAAI;IAOzC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,oBAAoB,CAAC,CAAC,EAC1B,GAAG,EAAE,CAAC,EAAE,EAAE,mBAAmB,KAAK,OAAO,CAAC,CAAC,CAAC,GAC3C,OAAO,CAAC,CAAC,CAAC;IAiDb,oEAAoE;IACpE,SAAS,IAAI,IAAI;IAgEjB;;;;OAIG;IACH,cAAc,IAAI,IAAI;IAMtB;;;;;;;;;;;;OAYG;IACH,sBAAsB,IAAI,IAAI;IAK9B,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,wBAAwB;IAMhC,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,aAAa;IAarB;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;CAa3B;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,aAAa,GACrB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAsB1C"}