poly-weaver 0.10.6 → 0.11.0

package/dist/terminal/host.d.ts

@@ -2,8 +2,9 @@ import { type TerminalLayout } from "./layout.js";
 import { BufferOrchestrationOutput, type OrchestrationOutput } from "./output.js";
 import { type ParentUiMode } from "./input-router.js";
 import { type KeyEventSource } from "./key-event-source.js";
+import { type MouseMode } from "./mouse-mode-tracker.js";
 import type { PtyHandle } from "../pty/types.js";
-import type { StatusBar } from "../status-bar.js";
+import type { StatusBar, StatusChildState } from "../status-bar.js";
 export interface TerminalHostOptions {
     stdin?: NodeJS.ReadStream;
     stdout?: NodeJS.WriteStream;
@@ -83,10 +84,10 @@ export interface HostParentUiMode extends ParentUiMode {
  *   - 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.
+ *   - Keeps host-owned mouse capture active for wheel input in normal-buffer
+ *     host UI, mirrors mouse-reporting modes requested by child PTYs, and
+ *     disables reflected modes 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;
@@ -107,12 +108,15 @@ export declare class TerminalHost {
     private readonly injectedSource;
     private sourceUnsubscribe;
     private sourceResizeUnsubscribe;
+    private readonly kittyNegotiator;
+    private readonly childMouseTracker;
+    private readonly mouseModes;
     /**
      * Authoritative terminal size as observed by the host. Updated by both
-     * source-driven (FFI `WINDOW_BUFFER_SIZE_RECORD`) and stdout-driven
-     * (libuv `process.stdout.emit("resize")`) resize signals. Read by
-     * `computeLayout()`. Undefined until the first resize observation, in
-     * which case `computeLayout()` falls back to `stdout.columns`/`rows`.
+     * source-driven and stdout-driven (`process.stdout.emit("resize")`)
+     * resize signals. Read by `computeLayout()`. Undefined until the first
+     * resize observation, in which case `computeLayout()` falls back to
+     * `stdout.columns`/`rows`.
      */
     private lastSize;
     private renderScheduled;
@@ -127,6 +131,10 @@ export declare class TerminalHost {
      */
     private pendingFullRender;
     private parentUi;
+    private mainChildStatus;
+    private externalChildStatus;
+    private syncOutputSupported;
+    private lastFrameRows;
     constructor(opts?: TerminalHostOptions);
     /** True only when the host has entered the alternate screen. */
     get isActive(): boolean;
@@ -177,8 +185,21 @@ export declare class TerminalHost {
      * trailing output.
      */
     clearChildSurface(): void;
+    setActiveChildStatus(state: StatusChildState | undefined): void;
+    setMouseModeSource(source: string, modes: Iterable<MouseMode>): void;
+    clearMouseModeSource(source: string): void;
     /** Dispose the current `VirtualTerminal` and create a fresh one sized to the current layout. */
     private resetVirtualTerminal;
+    /**
+     * Reset the per-child negotiation trackers (kitty keyboard + mouse modes)
+     * and re-derive the host's mouse capture from the now-empty child mode set.
+     * Shared by child attach / detach / surface-clear.
+     */
+    private resetChildNegotiationState;
+    private handleOscClipboard;
+    private reflectMainChildMouseModes;
+    private reconcileHostMouseCapture;
+    private writeMouseDelta;
     /**
      * Attach a parent UI mode. The host routes stdin through the mode's
      * `onInput` and queries `getSurface()` (when present) on every frame.
@@ -191,8 +212,8 @@ export declare class TerminalHost {
      *
      * The host:
      *   - leaves its own alternate screen,
-     *   - disables mouse reporting so the foreign UI is not flooded with
-     *     SGR mouse sequences,
+     *   - disables reflected child mouse reporting so the foreign UI is not
+     *     flooded with mouse sequences,
      *   - removes its stdin data listener,
      *   - restores the prior raw-mode state,
      *   - blocks `scheduleRender()`/`renderNow()` until resume,
@@ -200,14 +221,16 @@ export declare class TerminalHost {
      *     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.
+     * On resume the host re-enters its alt screen, re-applies still-active
+     * child-requested mouse modes, 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>;
+    private invalidateFrameCache;
     /** Force an immediate render (synchronously composes one frame). */
     renderNow(): void;
     /**
@@ -237,8 +260,8 @@ export declare class TerminalHost {
     private handleScrollPages;
     private handleScrollToTop;
     private handleScrollToBottom;
-    private renderUiSurface;
-    private renderMessages;
+    private renderUiSurfaceRows;
+    private renderMessageRows;
     private handleResize;
     private notifyParentUiResize;
     private computeLayout;
@@ -249,6 +272,8 @@ export declare class TerminalHost {
      * before scheduling a coalesced repaint.
      */
     private handleOutputChange;
+    private publishChildStatus;
+    private updateChildStatus;
 }
 /**
  * Map a surface-relative cursor position to a 1-based screen position.

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

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

package/dist/terminal/host.js

@@ -1,10 +1,16 @@
-import { ALT_SCREEN_OFF, ALT_SCREEN_ON, CLEAR_SCREEN, CURSOR_HOME, HIDE_CURSOR, MOUSE_OFF, MOUSE_ON, RESET_SCROLL_REGION, SHOW_CURSOR, padOrClip, } from "../ansi.js";
+import { ALT_SCREEN_OFF, ALT_SCREEN_ON, BEGIN_SYNC_UPDATE, CLEAR_SCREEN, CURSOR_HOME, END_SYNC_UPDATE, HIDE_CURSOR, MOUSE_OFF, QUERY_SYNC_UPDATE, RESET_SCROLL_REGION, SHOW_CURSOR, padOrClip, } from "../ansi.js";
 import { computeTerminalLayout } from "./layout.js";
 import { VirtualTerminal } from "./virtual-terminal.js";
-import { renderChildViewport, renderStatusLine } from "./render.js";
+import { renderChildViewportRows, renderStatusRowBody, shouldShowVtCursor, } from "./render.js";
 import { BufferOrchestrationOutput, formatOrchestrationMessage, } from "./output.js";
 import { InputRouter } from "./input-router.js";
 import { createKeyEventSource } from "./key-event-source.js";
+import { ChildKittyNegotiator } from "./kitty-negotiator.js";
+import { MouseModeReconciler, MouseModeTracker, } from "./mouse-mode-tracker.js";
+import { buildOsc52Forward } from "./osc52.js";
+const MAIN_CHILD_MOUSE_SOURCE = "main-child";
+const HOST_MOUSE_SOURCE = "host-owned";
+const HOST_MOUSE_CAPTURE_MODES = [1000, 1006];
 /**
  * Parent-owned orchestration terminal host.
  *
@@ -19,10 +25,10 @@ import { createKeyEventSource } from "./key-event-source.js";
  *   - 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.
+ *   - Keeps host-owned mouse capture active for wheel input in normal-buffer
+ *     host UI, mirrors mouse-reporting modes requested by child PTYs, and
+ *     disables reflected modes on teardown / suspension so foreign UIs and
+ *     the post-host shell are not left with mouse mode turned on.
  */
 export class TerminalHost {
     stdin;
@@ -43,12 +49,15 @@ export class TerminalHost {
     injectedSource;
     sourceUnsubscribe;
     sourceResizeUnsubscribe;
+    kittyNegotiator = new ChildKittyNegotiator();
+    childMouseTracker = new MouseModeTracker();
+    mouseModes = new MouseModeReconciler();
     /**
      * Authoritative terminal size as observed by the host. Updated by both
-     * source-driven (FFI `WINDOW_BUFFER_SIZE_RECORD`) and stdout-driven
-     * (libuv `process.stdout.emit("resize")`) resize signals. Read by
-     * `computeLayout()`. Undefined until the first resize observation, in
-     * which case `computeLayout()` falls back to `stdout.columns`/`rows`.
+     * source-driven and stdout-driven (`process.stdout.emit("resize")`)
+     * resize signals. Read by `computeLayout()`. Undefined until the first
+     * resize observation, in which case `computeLayout()` falls back to
+     * `stdout.columns`/`rows`.
      */
     lastSize;
     renderScheduled = false;
@@ -63,6 +72,10 @@ export class TerminalHost {
      */
     pendingFullRender = false;
     parentUi;
+    mainChildStatus;
+    externalChildStatus;
+    syncOutputSupported = false;
+    lastFrameRows = null;
     constructor(opts = {}) {
         this.stdin = opts.stdin ?? process.stdin;
         this.stdout = opts.stdout ?? process.stdout;
@@ -84,6 +97,12 @@ export class TerminalHost {
             onScrollToTop: () => this.handleScrollToTop(),
             onScrollToBottom: () => this.handleScrollToBottom(),
             isChildAlternate: () => this.vt?.isAlternate === true,
+            isChildMouseActive: () => this.childMouseTracker.hasActiveReportingMode(),
+            getChildKittyFlags: () => this.kittyNegotiator.activeFlags,
+            getChildBracketedPaste: () => this.vt?.bracketedPaste === true,
+            onSyncOutputReport: (supported) => {
+                this.syncOutputSupported = supported;
+            },
         });
         if (this.statusBar) {
             this.attachStatusBar(this.statusBar);
@@ -144,17 +163,20 @@ export class TerminalHost {
         this.started = true;
         this.stopped = false;
         this.layout = this.computeLayout();
-        this.vt = new VirtualTerminal(this.layout.childCols, this.layout.childRows);
-        this.stdout.write(ALT_SCREEN_ON + CLEAR_SCREEN + CURSOR_HOME + HIDE_CURSOR + MOUSE_ON);
+        this.resetVirtualTerminal();
+        this.stdout.write(ALT_SCREEN_ON + CLEAR_SCREEN + CURSOR_HOME + HIDE_CURSOR);
+        this.reconcileHostMouseCapture();
         if (this.stdin.isTTY) {
             this.startSource();
+            this.stdout.write(QUERY_SYNC_UPDATE);
         }
         this.resizeListener = () => this.handleResize();
         this.stdout.on("resize", this.resizeListener);
         this.scheduleRender();
     }
     startSource() {
-        this.source = this.injectedSource ?? createKeyEventSource({ stdin: this.stdin });
+        this.source = this.injectedSource
+            ?? createKeyEventSource({ stdin: this.stdin, stdout: this.stdout });
         this.source.start();
         this.sourceUnsubscribe = this.source.onEvents((events) => {
             this.router.handleEvents(events);
@@ -182,6 +204,7 @@ export class TerminalHost {
         this.router.destroy();
         this.vt?.dispose();
         this.vt = undefined;
+        this.mouseModes.clearAll();
         this.stdout.write(MOUSE_OFF + RESET_SCROLL_REGION + CLEAR_SCREEN + CURSOR_HOME + ALT_SCREEN_OFF + SHOW_CURSOR);
         // Drop any lingering subscribers — once the host has stopped, late
         // interrupt callbacks would see torn-down state.
@@ -204,9 +227,12 @@ export class TerminalHost {
         // Each agent run starts with a fresh VT and empty scrollback so prior
         // child output cannot remain visible or be reached via PageUp.
         this.resetVirtualTerminal();
+        this.resetChildNegotiationState();
         this.childHandle = handle;
+        this.updateChildStatus();
         this.router.attachChild(handle);
         const boundHandle = handle;
+        let lastChildAlternate = this.vt?.isAlternate === true;
         handle.onData((data) => {
             // Skip render writes if a different child has been attached or the
             // host has detached this child entirely.
@@ -218,6 +244,13 @@ export class TerminalHost {
                 return;
             if (!this.vt)
                 return;
+            const reply = this.kittyNegotiator.processChunk(data);
+            if (reply.length > 0)
+                boundHandle.write(reply);
+            if (this.childMouseTracker.processChunk(data)) {
+                this.reflectMainChildMouseModes();
+                this.updateChildStatus();
+            }
             // Capture the user's viewport position BEFORE the write. Two cases:
             //
             //   stickyBottom=true:   user is at the tail → keep them there.
@@ -252,6 +285,12 @@ export class TerminalHost {
                     else if (delta > 0)
                         this.vt.scrollForward(delta);
                 }
+                const nextChildAlternate = this.vt.isAlternate === true;
+                if (nextChildAlternate !== lastChildAlternate) {
+                    lastChildAlternate = nextChildAlternate;
+                    this.invalidateFrameCache();
+                    this.updateChildStatus();
+                }
                 this.scheduleRender();
             });
         });
@@ -271,6 +310,9 @@ export class TerminalHost {
         this.childHandle.suppressOutput();
         this.router.detachChild(this.childHandle);
         this.childHandle = undefined;
+        this.invalidateFrameCache();
+        this.resetChildNegotiationState();
+        this.updateChildStatus();
     }
     /**
      * Discard the current child surface (VT screen + scrollback) and
@@ -280,15 +322,62 @@ export class TerminalHost {
      */
     clearChildSurface() {
         this.resetVirtualTerminal();
+        this.resetChildNegotiationState();
+        this.updateChildStatus();
         this.scheduleRender();
     }
+    setActiveChildStatus(state) {
+        this.externalChildStatus = state;
+        this.publishChildStatus();
+    }
+    setMouseModeSource(source, modes) {
+        this.writeMouseDelta(this.mouseModes.setSource(source, modes));
+    }
+    clearMouseModeSource(source) {
+        this.writeMouseDelta(this.mouseModes.clearSource(source));
+    }
     /** Dispose the current `VirtualTerminal` and create a fresh one sized to the current layout. */
     resetVirtualTerminal() {
         if (!this.layout) {
             this.layout = this.computeLayout();
         }
         this.vt?.dispose();
-        this.vt = new VirtualTerminal(this.layout.childCols, this.layout.childRows);
+        this.vt = new VirtualTerminal(this.layout.childCols, this.layout.childRows, {
+            onOscClipboard: (data) => this.handleOscClipboard(data),
+        });
+        // A fresh VT means the cached frame no longer reflects the screen.
+        this.invalidateFrameCache();
+    }
+    /**
+     * Reset the per-child negotiation trackers (kitty keyboard + mouse modes)
+     * and re-derive the host's mouse capture from the now-empty child mode set.
+     * Shared by child attach / detach / surface-clear.
+     */
+    resetChildNegotiationState() {
+        this.kittyNegotiator.reset();
+        this.childMouseTracker.reset();
+        this.reflectMainChildMouseModes();
+    }
+    handleOscClipboard(data) {
+        this.stdout.write(buildOsc52Forward(data));
+    }
+    reflectMainChildMouseModes() {
+        this.setMouseModeSource(MAIN_CHILD_MOUSE_SOURCE, this.childMouseTracker.snapshot());
+    }
+    reconcileHostMouseCapture() {
+        const ownsNormalBuffer = this.started
+            && !this.stopped
+            && this.mainChildStatus?.isAlternate !== true
+            && this.externalChildStatus?.isAlternate !== true;
+        const sequence = ownsNormalBuffer
+            ? this.mouseModes.setSource(HOST_MOUSE_SOURCE, HOST_MOUSE_CAPTURE_MODES)
+            : this.mouseModes.clearSource(HOST_MOUSE_SOURCE);
+        this.writeMouseDelta(sequence);
+    }
+    writeMouseDelta(sequence) {
+        if (sequence.length === 0 || this.suspended || this.stopped)
+            return;
+        this.stdout.write(sequence);
     }
     /**
      * Attach a parent UI mode. The host routes stdin through the mode's
@@ -298,6 +387,7 @@ export class TerminalHost {
     attachParentUi(mode) {
         this.parentUi = mode;
         this.router.attachParentUi(mode);
+        this.invalidateFrameCache();
         this.scheduleRender();
         return () => this.detachParentUi(mode);
     }
@@ -306,6 +396,7 @@ export class TerminalHost {
             return;
         this.router.detachParentUi(this.parentUi);
         this.parentUi = undefined;
+        this.invalidateFrameCache();
         this.scheduleRender();
     }
     /**
@@ -313,8 +404,8 @@ export class TerminalHost {
      *
      * The host:
      *   - leaves its own alternate screen,
-     *   - disables mouse reporting so the foreign UI is not flooded with
-     *     SGR mouse sequences,
+     *   - disables reflected child mouse reporting so the foreign UI is not
+     *     flooded with mouse sequences,
      *   - removes its stdin data listener,
      *   - restores the prior raw-mode state,
      *   - blocks `scheduleRender()`/`renderNow()` until resume,
@@ -322,9 +413,10 @@ export class TerminalHost {
      *     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.
+     * On resume the host re-enters its alt screen, re-applies still-active
+     * child-requested mouse modes, 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.
@@ -338,6 +430,8 @@ export class TerminalHost {
         }
         this.suspended = true;
         this.stopSource();
+        this.reconcileHostMouseCapture();
+        this.mouseModes.setReflectionEnabled(false);
         this.stdout.write(MOUSE_OFF + RESET_SCROLL_REGION + CLEAR_SCREEN + CURSOR_HOME + ALT_SCREEN_OFF + SHOW_CURSOR);
         const layoutSnapshot = this.layout ?? this.computeLayout();
         const io = {
@@ -351,7 +445,12 @@ export class TerminalHost {
             return await run(io);
         }
         finally {
-            this.stdout.write(ALT_SCREEN_ON + CLEAR_SCREEN + CURSOR_HOME + HIDE_CURSOR + MOUSE_ON);
+            this.reconcileHostMouseCapture();
+            this.stdout.write(ALT_SCREEN_ON
+                + CLEAR_SCREEN
+                + CURSOR_HOME
+                + HIDE_CURSOR
+                + this.mouseModes.setReflectionEnabled(true));
             if (this.stdin.isTTY) {
                 this.startSource();
             }
@@ -362,10 +461,14 @@ export class TerminalHost {
             if (this.childHandle) {
                 this.childHandle.resize(this.layout.childCols, this.layout.childRows);
             }
+            this.invalidateFrameCache();
             this.notifyParentUiResize();
             this.scheduleRender();
         }
     }
+    invalidateFrameCache() {
+        this.lastFrameRows = null;
+    }
     /** Force an immediate render (synchronously composes one frame). */
     renderNow() {
         this.pendingFlush = false;
@@ -385,46 +488,70 @@ export class TerminalHost {
         const parentOnly = !fullRender
             && surface !== undefined
             && surface.lines.length >= this.layout.childRows;
-        let frame = "";
+        const next = new Array(this.layout.rows).fill(null);
         if (!parentOnly) {
-            frame += renderChildViewport(this.vt, this.layout);
+            const childRows = renderChildViewportRows(this.vt, this.layout);
+            for (let i = 0; i < childRows.length; i++) {
+                next[i] = childRows[i];
+            }
         }
         if (surface) {
-            frame += this.renderUiSurface(this.layout, surface);
+            this.renderUiSurfaceRows(next, this.layout, surface);
         }
         // Warning strip is host-owned and lives in its own dedicated rows
         // (between the child viewport and the status bar), so it is rendered
         // independently of the parent UI surface and the child viewport.
-        frame += this.renderMessages(this.layout);
-        if (this.statusBar) {
+        this.renderMessageRows(next, this.layout);
+        if (this.statusBar && this.layout.statusRow !== undefined) {
             const text = this.statusBar.render(this.layout.columns);
-            frame += renderStatusLine(this.layout, text);
+            next[this.layout.statusRow - 1] = renderStatusRowBody(this.layout, text);
         }
-        // Move the real cursor to a sensible position for terminal-state
-        // consistency. Host-rendered frames normally end with HIDE_CURSOR:
-        // the visible blink/flicker the hardware cursor would otherwise
-        // produce during provider streaming, host-managed warning rows, and
-        // host-backed prompts is not desired. A surface can opt in to
-        // SHOW_CURSOR only for frames where a visible hardware cursor is part
-        // of its contract.
+        // Move the real cursor to the active owner of the frame. Host-owned
+        // surfaces keep the historic hidden default unless they opt in; child-owned
+        // frames mirror the child's own DECTCEM visibility.
         const surfaceCursorPlacement = surface?.cursor
             ? mapSurfaceCursorToScreen(this.layout, surface)
             : undefined;
-        if (surface?.showCursor && surfaceCursorPlacement) {
-            frame += SHOW_CURSOR;
-            frame += `\x1b[${surfaceCursorPlacement.row};${surfaceCursorPlacement.col}H`;
-        }
-        else {
+        let cursorPlacement = "";
+        if (surface) {
+            // Position and visibility are independent: emit the move whenever a
+            // placement exists, then decide show/hide separately.
             if (surfaceCursorPlacement) {
-                frame += `\x1b[${surfaceCursorPlacement.row};${surfaceCursorPlacement.col}H`;
+                cursorPlacement += `\x1b[${surfaceCursorPlacement.row};${surfaceCursorPlacement.col}H`;
             }
-            else if (!parentOnly && this.layout.statusRow !== undefined) {
+            cursorPlacement += surface.showCursor && surfaceCursorPlacement ? SHOW_CURSOR : HIDE_CURSOR;
+        }
+        else {
+            const hasRoom = this.layout.childRows > 0;
+            if (hasRoom) {
                 const cy = Math.min(Math.max(0, this.vt.cursorY), this.layout.childRows - 1);
                 const cx = Math.min(Math.max(0, this.vt.cursorX), this.layout.columns - 1);
-                frame += `\x1b[${cy + 1};${cx + 1}H`;
+                cursorPlacement += `\x1b[${cy + 1};${cx + 1}H`;
+            }
+            const showChildCursor = hasRoom
+                && this.childHandle !== undefined
+                && shouldShowVtCursor(this.vt);
+            cursorPlacement += showChildCursor ? SHOW_CURSOR : HIDE_CURSOR;
+        }
+        const prev = this.lastFrameRows;
+        let diffBody = HIDE_CURSOR;
+        for (let i = 0; i < next.length; i++) {
+            if (next[i] !== null) {
+                if (prev === null || prev[i] !== next[i]) {
+                    diffBody += `\x1b[${i + 1};1H${next[i]}`;
+                }
+            }
+            else {
+                // Nothing painted this row this frame: carry the prior row forward
+                // so `next` doubles as the cache for the following frame.
+                next[i] = prev?.[i] ?? null;
             }
-            frame += HIDE_CURSOR;
         }
+        this.lastFrameRows = next;
+        diffBody += cursorPlacement;
+        const frame = this.syncOutputSupported
+            ? BEGIN_SYNC_UPDATE + diffBody + END_SYNC_UPDATE
+            : diffBody;
         this.stdout.write(frame);
     }
     /**
@@ -512,62 +639,53 @@ export class TerminalHost {
         this.vt.scrollToBottom();
         this.scheduleRender();
     }
-    renderUiSurface(layout, surface) {
+    renderUiSurfaceRows(rows, layout, surface) {
         if (surface.lines.length === 0)
-            return "";
+            return;
         const maxLines = Math.min(surface.lines.length, layout.childRows);
         const baseRow = Math.max(0, layout.childRows - maxLines);
-        let out = "";
         for (let i = 0; i < maxLines; i++) {
             const text = surface.lines[surface.lines.length - maxLines + i];
             const padded = padOrClip(text, layout.columns);
-            out += `\x1b[${baseRow + i + 1};1H\x1b[2K\x1b[0m${padded}`;
+            rows[baseRow + i] = `\x1b[2K\x1b[0m${padded}`;
         }
-        return out;
     }
-    renderMessages(layout) {
+    renderMessageRows(rows, layout) {
         if (layout.warningRows === 0 || layout.warningStartRow === undefined)
-            return "";
+            return;
         const messages = this.bufferOutput.snapshot();
         if (messages.length === 0)
-            return "";
+            return;
         // Show the newest messages when the buffer has more than the strip
         // can hold. The strip is sized to `layout.warningRows`, capped at 3
         // by `computeTerminalLayout`.
         const slice = messages.slice(-layout.warningRows);
-        let out = "";
         for (let i = 0; i < slice.length; i++) {
             const text = formatOrchestrationMessage(slice[i]);
             const padded = padOrClip(text, layout.columns);
-            out += `\x1b[${layout.warningStartRow + i};1H\x1b[2K\x1b[0m${padded}`;
+            rows[layout.warningStartRow - 1 + i] = `\x1b[2K\x1b[0m${padded}`;
         }
-        return out;
     }
     handleResize(size) {
         if (!this.isActive)
             return;
         let next;
         if (size) {
-            // FFI path: WINDOW_BUFFER_SIZE_RECORD dims are authoritative because
-            // libuv never saw the record and `stdout.columns`/`rows` stay stale.
+            // Source-provided dimensions are already post-resize and may be
+            // fresher than stdout.columns/stdout.rows.
             next = size;
         }
         else {
-            // Byte path / stdout.on("resize") path: libuv just refreshed
-            // `stdout.columns`/`rows`, so they are the authoritative dims.
-            // Overwrite `lastSize` — any stale FFI value from before the last
-            // `source.stop()` (e.g. during runIsolatedAltScreen suspension)
-            // would otherwise mask the new size on resume.
+            // stdout.on("resize") path: libuv just refreshed stdout columns/rows,
+            // so overwrite `lastSize` with those dimensions.
             const c = this.stdout.columns;
             const r = this.stdout.rows;
             if (typeof c === "number" && typeof r === "number") {
                 next = { columns: c, rows: r };
             }
         }
-        // De-dupe redundant resize cascades. On Windows with the FFI source
-        // both `source.onResize` (from `WINDOW_BUFFER_SIZE_RECORD`) and
-        // `stdout.on("resize")` fire for the same physical resize; without
-        // this guard, layout/vt/child resizes and a render would run twice.
+        // De-dupe redundant resize cascades from source-driven and stdout-driven
+        // notifications for the same physical resize.
         if (next !== undefined
             && this.lastSize !== undefined
             && next.columns === this.lastSize.columns
@@ -576,6 +694,7 @@ export class TerminalHost {
         }
         this.lastSize = next;
         this.layout = this.computeLayout();
+        this.invalidateFrameCache();
         if (this.vt)
             this.vt.resize(this.layout.childCols, this.layout.childRows);
         if (this.childHandle) {
@@ -613,12 +732,26 @@ export class TerminalHost {
         this.layout = next;
         if (prev !== undefined
             && (prev.childCols !== next.childCols || prev.childRows !== next.childRows)) {
+            this.invalidateFrameCache();
             this.vt?.resize(next.childCols, next.childRows);
             this.childHandle?.resize(next.childCols, next.childRows);
             this.notifyParentUiResize();
         }
         this.scheduleRender();
     }
+    publishChildStatus() {
+        this.statusBar?.setChildState(this.externalChildStatus ?? this.mainChildStatus);
+        this.reconcileHostMouseCapture();
+    }
+    updateChildStatus() {
+        const hasChild = this.childHandle !== undefined;
+        const isAlternate = hasChild && this.vt?.isAlternate === true;
+        const mouseActive = hasChild && this.childMouseTracker.hasActiveReportingMode();
+        this.mainChildStatus = isAlternate || mouseActive
+            ? { isAlternate, mouseActive }
+            : undefined;
+        this.publishChildStatus();
+    }
 }
 function isHostParentUiMode(mode) {
     return typeof mode.getSurface === "function";