@north-light/crouter 0.3.169 → 0.3.171

package/dist/clients/attach/session/layout.js

@@ -1,28 +1,25 @@
-// session/layout.ts — the viewer's visual skeleton: the TUI, the nine
-// containers it paints into, and the editor.
+// session/layout.ts — the viewer's visual skeleton: its containers, editor,
+// and one full-pane frame.
 //
 // Pure construction. Nothing here reads session state, talks to the socket, or
 // handles a key — a reader chasing behavior can skip this file entirely, and a
 // reader asking "where does this line get painted?" needs only this one.
 //
-// The render order is the whole point of the file, and it is asserted in ONE
-// place (`mount`). Top to bottom: chat · rule · queued · above-editor extension
-// widgets · editor · picker panel · below-editor extension widgets · roster ·
-// status bar. pi-tui anchors the viewport to the cursor at the BOTTOM, so
-// everything except the scrolling chat lives in the bottom-anchored chrome
-// stack — a "topmost" badge would scroll off into scrollback the instant the
-// transcript exceeded one screen, which is why the mode badge and the two
-// canvas panels sit directly above the queued panel rather than at the top.
-import { Container, ProcessTerminal, TUI } from '@earendil-works/pi-tui';
+// The render order is asserted in ONE place (`ViewerFrame`'s bottom list).
+// Top to bottom: pinned recap header · virtualized chat · rule · queued ·
+// above-editor extension widgets · editor · picker panel · below-editor
+// extension widgets · roster · status bar. The frame owns the pane rectangle,
+// so every region remains on screen and none can enter terminal scrollback.
+import { Container } from '@earendil-works/pi-tui';
 import { DynamicBorder, getSelectListTheme } from '@earendil-works/pi-coding-agent';
 import { TitledEditor } from '../input/titled-editor.js';
-/** Build the TUI, its containers, and the editor. No behavior is wired here;
- *  the orchestrator owns every callback. */
-export function createLayout(pal, km) {
-    const procTerminal = new ProcessTerminal();
-    const tui = new TUI(procTerminal);
+import { ViewerFrame } from './frame.js';
+/** Build the layout around the transcript viewport. The viewer creates the
+ * terminal and chat first because the viewport measures that chat source. */
+export function createLayout(procTerminal, tui, chat, pal, km, viewport) {
     const containers = {
-        chat: new Container(),
+        chat,
+        header: new Container(),
         chrome: new Container(),
         aboveWidgets: new Container(),
         reports: new Container(),
@@ -31,26 +28,30 @@ export function createLayout(pal, km) {
         belowWidgets: new Container(),
         footer: new Container(),
     };
-    // The themed rule dividing the scrolling chat from the fixed chrome below it.
-    // `renderExtensionWidgets` re-derives this container's contents on every
-    // widget change (the passive recap replaces the rule), so this is the seed,
-    // not the sole writer.
+    // The themed rule dividing the transcript from the fixed cockpit below.
+    // `renderExtensionWidgets` re-derives this container on every widget change.
     containers.chrome.addChild(new DynamicBorder(pal.border));
     const editorTheme = { borderColor: pal.border, selectList: getSelectListTheme() };
     // TitledEditor paints the session name into its top border (solid-background
     // chip) and tracks a thinking-level border color, both set from live state.
     const editor = new TitledEditor(tui, editorTheme, km, { paddingX: 1 });
+    const frame = new ViewerFrame(procTerminal, {
+        header: containers.header,
+        viewport,
+        bottom: [
+            { slot: 'chrome', component: containers.chrome },
+            { slot: 'queued', component: containers.queued },
+            { slot: 'aboveWidgets', component: containers.aboveWidgets },
+            { slot: 'editor', component: editor },
+            { slot: 'pickerPanel', component: containers.pickerPanel },
+            { slot: 'belowWidgets', component: containers.belowWidgets },
+            { slot: 'reports', component: containers.reports },
+            { slot: 'footer', component: containers.footer },
+        ],
+    });
     const mount = () => {
-        tui.addChild(containers.chat);
-        tui.addChild(containers.chrome);
-        tui.addChild(containers.queued);
-        tui.addChild(containers.aboveWidgets);
-        tui.addChild(editor);
-        tui.addChild(containers.pickerPanel);
-        tui.addChild(containers.belowWidgets);
-        tui.addChild(containers.reports);
-        tui.addChild(containers.footer);
+        tui.addChild(frame);
         tui.setFocus(editor);
     };
-    return { procTerminal, tui, containers, editor, mount };
+    return { procTerminal, tui, containers, editor, frame, mount };
 }

package/dist/clients/attach/session/mouse.d.ts

@@ -0,0 +1,15 @@
+import type { TUI } from '@earendil-works/pi-tui';
+/** Lines moved for one terminal wheel notch. */
+export declare const WHEEL_LINES = 3;
+export interface MouseReporting {
+    /** Reporting currently on. */
+    enabled(): boolean;
+    /** Flip, write the DECSET/DECRST, return the new state. */
+    toggle(): boolean;
+    /** Turn off unconditionally — teardown and process exit. */
+    disable(): void;
+    /** Install the SGR listener; returns the remover. */
+    install(tui: TUI, onWheel: (direction: 'up' | 'down', lines: number) => void): () => void;
+}
+/** Create per-viewer mouse reporting, seeded from tmux's current mouse option. */
+export declare function createMouseReporting(write: (data: string) => void): MouseReporting;

package/dist/clients/attach/session/mouse.js

@@ -0,0 +1,61 @@
+// session/mouse.ts — terminal mouse reporting for the attach viewport.
+//
+// Mouse reporting is enabled only when tmux already has mouse on. Outside tmux
+// we leave native terminal selection alone; inside, every mouse sequence is
+// consumed so clicks and drags can never become editor input.
+import { spawnSync } from 'node:child_process';
+import { inTmux } from '../../../core/runtime/placement-tmux.js';
+const MOUSE_REPORTING_ON = '\x1b[?1002h\x1b[?1006h';
+const MOUSE_REPORTING_OFF = '\x1b[?1002l\x1b[?1006l';
+/** Lines moved for one terminal wheel notch. */
+export const WHEEL_LINES = 3;
+function detectMouseDefault() {
+    if (!inTmux())
+        return false;
+    const result = spawnSync('tmux', ['show-options', '-gv', 'mouse'], { encoding: 'utf8' });
+    return result.status === 0 && result.stdout?.trim() === 'on';
+}
+/** Create per-viewer mouse reporting, seeded from tmux's current mouse option. */
+export function createMouseReporting(write) {
+    let isEnabled = detectMouseDefault();
+    if (isEnabled)
+        write(MOUSE_REPORTING_ON);
+    const disable = () => {
+        isEnabled = false;
+        try {
+            write(MOUSE_REPORTING_OFF);
+        }
+        catch {
+            // Terminal restoration is best-effort, including during process exit.
+        }
+    };
+    process.once('exit', disable);
+    return {
+        enabled: () => isEnabled,
+        toggle: () => {
+            isEnabled = !isEnabled;
+            write(isEnabled ? MOUSE_REPORTING_ON : MOUSE_REPORTING_OFF);
+            return isEnabled;
+        },
+        disable,
+        install: (tui, onWheel) => tui.addInputListener((data) => {
+            let consumed = false;
+            const withoutSgr = data.replace(/\x1b\[<(\d+);\d+;\d+[Mm]/g, (_match, buttons) => {
+                consumed = true;
+                const button = Number(buttons) & ~(4 | 8 | 16);
+                if (button === 64)
+                    onWheel('up', WHEEL_LINES);
+                if (button === 65)
+                    onWheel('down', WHEEL_LINES);
+                return '';
+            });
+            const withoutMouse = withoutSgr.replace(/\x1b\[M[\s\S]{3}/g, () => {
+                consumed = true;
+                return '';
+            });
+            if (!consumed)
+                return undefined;
+            return withoutMouse.length > 0 ? { data: withoutMouse } : { consume: true };
+        }),
+    };
+}

package/dist/clients/attach/slash/dispatch.d.ts

@@ -1,4 +1,5 @@
 import type { AutocompleteItem, SlashCommand } from '@earendil-works/pi-tui';
+import type { CopyTarget } from '../render/transcript-copy.js';
 import type { BrokerSnapshot, ClientRole, ClientToBroker } from '../../../core/runtime/broker-protocol.js';
 /** Everything a slash handler needs: the frame sink, a notice sink, the latest
  *  engine state (for read-only commands like `/session`), and the cwd (for the
@@ -38,6 +39,8 @@ export interface SlashContext {
      *  registers `/graph` as a stub that calls this hook. Unit C/Q owns the overlay
      *  itself and populates this; when absent `/graph` notifies it isn't wired yet. */
     onGraph?: () => void;
+    /** Toggle the in-process Help overlay from `/hotkeys`. */
+    onHelp?: () => void;
     /** Detach this viewer (`/quit`). A viewer quit DETACHES — it tears down the
      *  local TUI/socket and leaves the shared engine running. Wired by viewer.ts to
      *  `teardown('detach')`; without it `/quit` cannot actually exit (just sending
@@ -47,6 +50,8 @@ export interface SlashContext {
     /** Copy the last assistant message to the clipboard (`/copy`). Wired by
      *  viewer.ts (it owns the ChatView that holds the text + the clipboard writer). */
     onCopy?: () => void;
+    /** Copy one viewer-local transcript target. */
+    onCopyTarget?: (target: CopyTarget) => void;
     /** OPTIONAL native-picker openers — the InputController fills these from its
      *  read-op request channel. When absent (channel unwired) the value-picker
      *  builtins fall back to the text-arg notice. */
@@ -75,6 +80,11 @@ export interface SlashContext {
      *  viewer-local render state (ChatView owns it), so it is safe for an observer
      *  and for a remote attach. Absent → the command notifies it is unwired. */
     onFoldTools?: () => void;
+    /** Toggle mouse wheel scrolling reporting on/off. Viewer-local render state
+     *  (MouseReporting owns the reporting state and the hardware toggle), so it is
+     *  safe for an observer and for a remote attach. Absent → the command notifies
+     *  it is unwired. */
+    onToggleMouse?: () => void;
 }
 /** Canvas slash-commands — implemented NATIVE in the viewer, the ONLY live host:
  *  the broker binds mode:'rpc', so broker pi-extensions never run their

package/dist/clients/attach/slash/dispatch.js

@@ -42,6 +42,10 @@ export const CANVAS_SLASH_COMMANDS = [
     { name: 'mcp', description: 'MCP servers — status from the adapter’s config/cache; Enter (or /mcp <server>) connects, reconnects, or re-auths' },
     { name: 'rename', description: 'Rename this node everywhere — node row, viewer window, session chip, tmux pane: /rename <name>' },
     { name: 'color', description: 'Color this node — tmux pane outline + name chip: /color <color> (red, blue, #rrggbb, …) or /color none' },
+    { name: 'mouse', description: 'Toggle mouse wheel scrolling — off restores tmux drag-select and copy-mode mouse' },
+    { name: 'copy-message', description: 'Copy the newest message visible in the transcript viewport' },
+    { name: 'copy-tool', description: 'Copy the newest tool call output' },
+    { name: 'copy-transcript', description: 'Copy every copyable transcript block' },
     { name: 'fold-tools', description: 'View setting — fold every FINISHED tool call to its single call line (Alt+C → w → f)' },
 ];
 const CANVAS_NAMES = new Set(CANVAS_SLASH_COMMANDS.map((c) => c.name));
@@ -301,10 +305,14 @@ export function dispatchSlashCommand(text, ctx) {
         case 'changelog':
             ctx.notify('/changelog: see https://github.com/earendil-works/pi for release notes (no bundled changelog in this build)');
             return true;
-        // --- recognized builtins with no Phase-4 wire path --------------------
         case 'hotkeys':
-            ctx.notify(`/${name} is not available in attach (Phase 4)`);
+            if (ctx.onHelp) {
+                ctx.onHelp();
+                return true;
+            }
+            ctx.notify('/hotkeys is not available in this viewer');
             return true;
+        // --- recognized builtins with no Phase-4 wire path --------------------
         default:
             // A builtin we listed but didn't special-case: treat as unsupported
             // rather than leak it to the LLM as literal text.
@@ -402,6 +410,31 @@ function dispatchCanvasCommand(name, arg, ctx) {
             else
                 ctx.notify('The fold-tools view setting is not wired into this viewer');
             return true;
+        case 'mouse':
+            // Viewer-local render state only — no frame, no CLI, no node mutation.
+            if (ctx.onToggleMouse)
+                ctx.onToggleMouse();
+            else
+                ctx.notify('Mouse reporting is not wired into this viewer');
+            return true;
+        case 'copy-message':
+            if (ctx.onCopyTarget)
+                ctx.onCopyTarget('message');
+            else
+                ctx.notify('/copy-message is not available in this viewer');
+            return true;
+        case 'copy-tool':
+            if (ctx.onCopyTarget)
+                ctx.onCopyTarget('tool');
+            else
+                ctx.notify('/copy-tool is not available in this viewer');
+            return true;
+        case 'copy-transcript':
+            if (ctx.onCopyTarget)
+                ctx.onCopyTarget('transcript');
+            else
+                ctx.notify('/copy-transcript is not available in this viewer');
+            return true;
         default:
             ctx.notify(`/${name} is not available in attach`);
             return true;