@north-light/crouter 0.3.170 → 0.3.172

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

@@ -0,0 +1,17 @@
+import { type Component, type TUI } from '@earendil-works/pi-tui';
+import type { AttachPalette } from '../config.js';
+/** A random line, never the one the previous whip used. */
+export declare function randomWhipMessage(messages: readonly string[]): string;
+/** A 20-frame, 12-row header animation that gives the focused agent a playful nudge. */
+export declare class WhipAnimation implements Component {
+    private readonly tui;
+    private readonly pal;
+    private frame;
+    private timer;
+    constructor(tui: TUI, pal: Pick<AttachPalette, 'accent'>);
+    play(): void;
+    dispose(): void;
+    render(width: number): string[];
+    invalidate(): void;
+    private stop;
+}

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

@@ -0,0 +1,334 @@
+// session/whip.ts — viewer-local Sisyphus whip animation and steering cues.
+import { truncateToWidth } from '@earendil-works/pi-tui';
+const FRAME_MS = 40;
+const WHIP_FRAMES = [
+    [
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "\u001b[1m⡄\u001b[22m",
+        "\u001b[1m⠃\u001b[22m",
+        "\u001b[1m⢀\u001b[22m\u001b[1m⡠\u001b[22m/⢤⡀",
+        "\u001b[1m⠋\u001b[22m   ⠑⠦⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠄",
+        ""
+    ],
+    [
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "\u001b[1m⡄\u001b[22m",
+        "\u001b[1m⠃\u001b[22m",
+        "\u001b[1m⢀\u001b[22m\u001b[1m⡠\u001b[22m/⠔⠒⠦⠤⣄⣀",
+        "\u001b[1m⠋\u001b[22m       ⠈⠉⠓⠒⠦⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠄",
+        ""
+    ],
+    [
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "\u001b[1m⣦\u001b[22m",
+        "\u001b[1m⡟\u001b[22m\u001b[1m⢀\u001b[22m/⠔⠒⠦⠤⣄⣀⡀",
+        "\u001b[1m⣧\u001b[22m\u001b[1m⠎\u001b[22m       ⠉⠙⠒⠦⠤⣄⣀",
+        "\u001b[1m⠏\u001b[22m               ⠉⠙⠒⠒⠦⠤⠤⠤⠤⠤⠤⠤⠄",
+        ""
+    ],
+    [
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "\u001b[1m⣦\u001b[22m   ⡤⠤⠤⢤⣀⡀",
+        "\u001b[1m⡟\u001b[22m\u001b[1m⢀\u001b[22m/⠜     ⠉⠙⠒⠦⠤⢄⣀⡀",
+        "\u001b[1m⣧\u001b[22m\u001b[1m⠎\u001b[22m              ⠉⠉⠑⠒⠦⠤⢄⣀⡀",
+        "\u001b[1m⠏\u001b[22m                       ⠈⠉⠑⠒⠆",
+        ""
+    ],
+    [
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "    ⡤⠤⠤⠤⣄⣀",
+        "\u001b[1m⣴\u001b[22m\u001b[1m⢰\u001b[22m/⠜     ⠈⠉⠓⠦⢤⣀",
+        "\u001b[1m⢿\u001b[22m\u001b[1m⣼\u001b[22m\u001b[1m⡇\u001b[22m           ⠈⠑⠦⣄⡀",
+        "\u001b[1m⢸\u001b[22m\u001b[1m⣿\u001b[22m\u001b[1m⠃\u001b[22m               ⠉⠓⠦⠤⣀⣀",
+        "\u001b[1m⢸\u001b[22m\u001b[1m⣿\u001b[22m                     ⠈⠉⠉⠓⠒⠆",
+        " \u001b[1m⠛\u001b[22m"
+    ],
+    [
+        "",
+        "",
+        "",
+        "",
+        "",
+        "    ⡤⠤⠤⠤⣄⣀",
+        " \u001b[1m⠠\u001b[22m/⠜     ⠈⠉⠓⠦⢤⣀",
+        "\u001b[1m⢤\u001b[22m \u001b[1m⣿\u001b[22m           ⠈⠙⠲⢤⡀",
+        " \u001b[1m⢣\u001b[22m\u001b[1m⢻\u001b[22m\u001b[1m⡆\u001b[22m              ⠈⠑⠦⢄⡀",
+        "  \u001b[1m⢻\u001b[22m\u001b[1m⡇\u001b[22m                  ⠈⠑⠢⢄⡀",
+        "  \u001b[1m⠈\u001b[22m\u001b[1m⠛\u001b[22m                      ⠈⠑⠆",
+        ""
+    ],
+    [
+        "",
+        "",
+        "",
+        "",
+        "    ⡤⠤⠤⠤⣄⣀",
+        "  /⠜     ⠈⠉⠓⠦⢤⣀",
+        "  \u001b[1m⢸\u001b[22m\u001b[1m⡀\u001b[22m          ⠈⠙⠲⢤⡀",
+        "\u001b[1m⠤\u001b[22m\u001b[1m⣄\u001b[22m \u001b[1m⢇\u001b[22m              ⠈⠑⠦⢄⡀",
+        " \u001b[1m⠈\u001b[22m\u001b[1m⠓\u001b[22m\u001b[1m⢼\u001b[22m\u001b[1m⡄\u001b[22m                 ⠈⠑⠢⢄⡀",
+        "                          ⠈⠑⠆",
+        "",
+        ""
+    ],
+    [
+        "",
+        "",
+        "",
+        "        ⣀⡠⠤⠤⠤⠤⠤⠤⣄⣀",
+        "    ⣠⠔⠚⠉         ⠈⠉⠓⠦⢤⣀",
+        "  /⠜⠁                 ⠈⠙⠦⣀",
+        "  \u001b[1m⢸\u001b[22m\u001b[1m⡀\u001b[22m                     ⠈⢧",
+        "\u001b[1m⠤\u001b[22m\u001b[1m⣄\u001b[22m \u001b[1m⢇\u001b[22m                       ⡇",
+        " \u001b[1m⠈\u001b[22m\u001b[1m⠓\u001b[22m\u001b[1m⢼\u001b[22m\u001b[1m⡄\u001b[22m                      ⡇",
+        "                           ⠇",
+        "",
+        ""
+    ],
+    [
+        "",
+        "            ⢀⣠⠤⠤⠤⠤⠤⣄⣀",
+        "         ⣠⠔⠊⠁       ⠈⠙⠦⣄",
+        "      ⢀⡴⠋              ⠈⢳⡀",
+        "    ⣠⠔⠋                  ⢧",
+        "  /⠜⠁                    ⡎",
+        "  \u001b[1m⢸\u001b[22m\u001b[1m⡀\u001b[22m                    ⢠⠃",
+        "\u001b[1m⠤\u001b[22m\u001b[1m⣄\u001b[22m \u001b[1m⢇\u001b[22m                    ⠜",
+        " \u001b[1m⠈\u001b[22m\u001b[1m⠓\u001b[22m\u001b[1m⢼\u001b[22m\u001b[1m⡄\u001b[22m",
+        "",
+        "",
+        ""
+    ],
+    [
+        "                ⣀⡤⠤⢤⡀",
+        "            ⣀⡤⠔⠋⠁   ⢧",
+        "         ⣠⠔⠋⠁       ⢸",
+        "       ⣠⠞⠁          ⡜",
+        "     ⢀⠜⠁           ⡼⠁",
+        "  \u001b[1m⠠\u001b[22m/⠔⠁            ⠜⠁",
+        "   \u001b[1m⣿\u001b[22m",
+        "\u001b[1m⢤\u001b[22m\u001b[1m⡀\u001b[22m \u001b[1m⣿\u001b[22m",
+        " \u001b[1m⠙\u001b[22m\u001b[1m⢦\u001b[22m\u001b[1m⣹\u001b[22m\u001b[1m⡇\u001b[22m",
+        "   \u001b[1m⠙\u001b[22m\u001b[1m⠃\u001b[22m",
+        "",
+        ""
+    ],
+    [
+        "                ⣀⡤⠤⢤⡀",
+        "            ⣀⡤⠔⠋⠁   ⡇",
+        "         ⣠⣴⠯⠕⠒⠒⠲⠤⠤⠔⠚⠁",
+        " ⢠⠔⠒⠦⠤⠔⣲⠟⠁",
+        " ⠜   ⢀⠜⠁",
+        "  \u001b[1m⠠\u001b[22m/⠔⠁",
+        "   \u001b[1m⣿\u001b[22m",
+        "\u001b[1m⢤\u001b[22m\u001b[1m⡀\u001b[22m \u001b[1m⣿\u001b[22m",
+        " \u001b[1m⠙\u001b[22m\u001b[1m⢦\u001b[22m\u001b[1m⣹\u001b[22m\u001b[1m⡇\u001b[22m",
+        "   \u001b[1m⠙\u001b[22m\u001b[1m⠃\u001b[22m",
+        "",
+        ""
+    ],
+    [
+        "                ⣀⡤⠤⢤⡀",
+        "            ⣀⡤⠔⠋⠁   ⡇",
+        "         ⣠⣴⠯⠕⠒⠒⠲⠤⠤⠔⠚⠁",
+        " ⢠⠔⠒⠦⠤⠔⣲⠟⠁",
+        " ⠜   ⢀⠜⠁",
+        "  \u001b[1m⠠\u001b[22m/⠔⠁",
+        "   \u001b[1m⣿\u001b[22m",
+        "\u001b[1m⢤\u001b[22m\u001b[1m⡀\u001b[22m \u001b[1m⣿\u001b[22m",
+        " \u001b[1m⠙\u001b[22m\u001b[1m⢦\u001b[22m\u001b[1m⣹\u001b[22m\u001b[1m⡇\u001b[22m",
+        "   \u001b[1m⠙\u001b[22m\u001b[1m⠃\u001b[22m",
+        "",
+        ""
+    ],
+    [
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "\u001b[1m⠤\u001b[22m\u001b[1m⣄\u001b[22m         ⢀⣠⠤⠔⠒⠒⠒⠒⠒⠒⠒⠦⠤⠤⠤⠤⠤⠤⠤⠄",
+        " \u001b[1m⠈\u001b[22m\u001b[1m⠓\u001b[22m\u001b[1m⢤\u001b[22m\u001b[1m⣀\u001b[22m\u001b[1m⣀\u001b[22m\u001b[1m⠤\u001b[22m\u001b[1m⠤\u001b[22m/⠔⠊⠁",
+        "",
+        "",
+        ""
+    ],
+    [
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "                           \\\\|/",
+        "\u001b[1m⠤\u001b[22m\u001b[1m⣄\u001b[22m         ⢀⣠⠤⠔⠒⠒⠒⠒⠒⠒⠒⠦⠤⠤⠤⠤-*-",
+        " \u001b[1m⠈\u001b[22m\u001b[1m⠓\u001b[22m\u001b[1m⢤\u001b[22m\u001b[1m⣀\u001b[22m\u001b[1m⣀\u001b[22m\u001b[1m⠤\u001b[22m\u001b[1m⠤\u001b[22m/⠔⠊⠁               /|\\\\",
+        "",
+        "",
+        ""
+    ],
+    [
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "\u001b[1m⢤\u001b[22m\u001b[1m⡀\u001b[22m",
+        " \u001b[1m⠳\u001b[22m\u001b[1m⡀\u001b[22m   \u001b[1m⣠\u001b[22m/⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠄  ',.",
+        "  \u001b[1m⠹\u001b[22m\u001b[1m⣄\u001b[22m\u001b[1m⡤\u001b[22m\u001b[1m⠋\u001b[22m                     . .",
+        "   \u001b[1m⠉\u001b[22m",
+        ""
+    ],
+    [
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "\u001b[1m⣴\u001b[22m",
+        "\u001b[1m⢻\u001b[22m\u001b[1m⡆\u001b[22m",
+        "\u001b[1m⢸\u001b[22m\u001b[1m⡇\u001b[22m  \u001b[1m⣠\u001b[22m/⠔⠒⠒⠦⠤⣄⣀",
+        " \u001b[1m⣿\u001b[22m\u001b[1m⣠\u001b[22m\u001b[1m⠞\u001b[22m\u001b[1m⠁\u001b[22m       ⠈⠉⠓⠒⠦⠤⠤⠤⠤⠤⠤⠤⠤⠤⠄ . .",
+        " \u001b[1m⠛\u001b[22m\u001b[1m⠁\u001b[22m"
+    ],
+    [
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "\u001b[1m⣦\u001b[22m",
+        "\u001b[1m⡿\u001b[22m",
+        "\u001b[1m⡇\u001b[22m \u001b[1m⣠\u001b[22m/⢤⡀",
+        "\u001b[1m⣧\u001b[22m\u001b[1m⠞\u001b[22m\u001b[1m⠁\u001b[22m  ⠉⠓⠦⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠄",
+        "\u001b[1m⠁\u001b[22m"
+    ],
+    [
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "\u001b[1m⡄\u001b[22m",
+        "\u001b[1m⠃\u001b[22m",
+        "\u001b[1m⢀\u001b[22m\u001b[1m⡠\u001b[22m/⢤",
+        "\u001b[1m⠋\u001b[22m  ⠈⠓⠦⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠄",
+        ""
+    ],
+    [
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "\u001b[1m⡄\u001b[22m",
+        "\u001b[1m⠃\u001b[22m",
+        "\u001b[1m⢀\u001b[22m\u001b[1m⡠\u001b[22m/⢤⡀",
+        "\u001b[1m⠋\u001b[22m   ⠑⠦⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠄",
+        ""
+    ],
+    [
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "",
+        "\u001b[1m⡄\u001b[22m",
+        "\u001b[1m⠃\u001b[22m",
+        "\u001b[1m⢀\u001b[22m\u001b[1m⡠\u001b[22m/⢤⡀",
+        "\u001b[1m⠋\u001b[22m   ⠑⠦⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠤⠄",
+        ""
+    ]
+];
+let lastMessage;
+/** A random line, never the one the previous whip used. */
+export function randomWhipMessage(messages) {
+    const choices = messages.filter((message) => message !== lastMessage);
+    const message = choices[Math.floor(Math.random() * choices.length)];
+    lastMessage = message;
+    return message;
+}
+/** A 20-frame, 12-row header animation that gives the focused agent a playful nudge. */
+export class WhipAnimation {
+    tui;
+    pal;
+    frame = -1;
+    timer;
+    constructor(tui, pal) {
+        this.tui = tui;
+        this.pal = pal;
+    }
+    play() {
+        this.stop();
+        this.frame = 0;
+        this.tui.requestRender();
+        this.timer = setInterval(() => {
+            this.frame++;
+            if (this.frame < WHIP_FRAMES.length) {
+                this.tui.requestRender();
+                return;
+            }
+            this.stop();
+        }, FRAME_MS);
+    }
+    dispose() {
+        this.stop();
+    }
+    render(width) {
+        if (this.frame < 0)
+            return [];
+        const span = Math.max(0, width);
+        return WHIP_FRAMES[this.frame].map((line) => truncateToWidth(this.pal.accent(line), span, '', true));
+    }
+    invalidate() { }
+    stop() {
+        if (this.timer !== undefined)
+            clearInterval(this.timer);
+        this.timer = undefined;
+        this.frame = -1;
+        this.tui.requestRender();
+    }
+}

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,10 @@ 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 human inbox surface from `/inbox`. */
+    onInbox?: () => 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 +52,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,11 +82,16 @@ 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
  *  interactive (mode==='tui') paths. `/promote` triggers a turn after shelling
- *  `crtr node promote`; `/resume-node`, `/view`, `/context` each shell a `crtr`
+ *  `crtr node promote`; `/resume-node` and `/context` each shell a `crtr`
  *  subcommand via `tmux display-popup` (the viewer runs inside a tmux pane);
  *  `/graph` toggles the in-process overlay. Exported so the editor folds these
  *  into the slash autocomplete list. */

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

@@ -27,32 +27,35 @@ import { surfaceTmuxStyleArgs } from '../../../core/runtime/surface-bg.js';
 /** Canvas slash-commands — implemented NATIVE in the viewer, the ONLY live host:
  *  the broker binds mode:'rpc', so broker pi-extensions never run their
  *  interactive (mode==='tui') paths. `/promote` triggers a turn after shelling
- *  `crtr node promote`; `/resume-node`, `/view`, `/context` each shell a `crtr`
+ *  `crtr node promote`; `/resume-node` and `/context` each shell a `crtr`
  *  subcommand via `tmux display-popup` (the viewer runs inside a tmux pane);
  *  `/graph` toggles the in-process overlay. Exported so the editor folds these
  *  into the slash autocomplete list. */
 export const CANVAS_SLASH_COMMANDS = [
     { name: 'clear', description: 'Clear the conversation and free context — a fresh, empty session (like /new)' },
     { name: 'graph', description: 'Toggle the canvas GRAPH view (your local subscription tree)' },
+    { name: 'inbox', description: 'Toggle the human inbox — pending asks and reviews for you' },
     { name: 'promote', description: 'Promote this node to an orchestrator — /promote, or /promote <kind> to specialize' },
     { name: 'resume-node', description: 'Open the canvas navigator (search/scope/sort/tree) and resume the chosen node' },
-    { name: 'view', description: 'Open a view in a popup — bare for the picker, or /view <name> to open that view directly' },
     { name: 'context', description: 'Browse this node + its subscriptions’ context dirs in a read-only nvim popup' },
     { name: 'node-metadata', description: 'Inspect this node — identity, lifecycle, runtime, graph, artifacts, paths, and agent surfaces' },
     { 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: 'fold-tools', description: 'View setting — fold every FINISHED tool call to its single call line (Alt+C → w → f)' },
+    { 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 → z → f)' },
 ];
 const CANVAS_NAMES = new Set(CANVAS_SLASH_COMMANDS.map((c) => c.name));
 /** Native canvas commands that shell a LOCAL `crtr` mutation or read against
- *  `ctx.nodeId` — unsafe for a remote attach (Phase 3 review 2, findings-fix-
- *  review.md §1): `/promote` shells `crtr node promote --node` locally,
- *  `/resume-node` opens local `crtr canvas browse` whose Enter path focuses a
- *  local node, `/context` opens local `crtr node inspect context`. `/graph`
- *  (the in-process GRAPH overlay, already remote-safe — see overlays/graph.ts)
- *  and `/view` (a self-contained popup unrelated to `nodeId`) stay available. */
-const REMOTE_UNSAFE_CANVAS_NAMES = new Set(['promote', 'resume-node', 'context', 'node-metadata', 'rename', 'clear', 'mcp']);
+ *  `ctx.nodeId` — unsafe for a remote attach: `/promote` shells `crtr node
+ *  promote --node` locally, `/resume-node` opens local `crtr canvas browse`
+ *  whose Enter path focuses a local node, and `/context` opens local `crtr node
+ *  inspect context`. `/graph` stays available because its in-process overlay
+ *  handles remote canvases directly. */
+const REMOTE_UNSAFE_CANVAS_NAMES = new Set(['promote', 'resume-node', 'context', 'node-metadata', 'rename', 'clear', 'mcp', 'inbox']);
 /** Native canvas commands an OBSERVER may not run — the ones that drive the
  *  engine or mutate the node, whether by frame or by shelling the crtr CLI:
  *  `/clear` sends `new_session`; `/promote` shells `crtr node promote` and then
@@ -63,7 +66,7 @@ const REMOTE_UNSAFE_CANVAS_NAMES = new Set(['promote', 'resume-node', 'context',
  *  `/graph` (in-process overlay), `/context` and `/node-metadata` (read-only
  *  inspection popups), `/color` (this pane's tmux border + this viewer's name
  *  chip). */
-const OBSERVER_UNSAFE_CANVAS_NAMES = new Set(['clear', 'promote', 'rename', 'resume-node', 'view', 'mcp']);
+const OBSERVER_UNSAFE_CANVAS_NAMES = new Set(['clear', 'promote', 'rename', 'resume-node', 'mcp']);
 /** tmux named colours accepted by `/color` (plus `colourN`/`#rrggbb`, validated
  *  by pattern). Mirrors tmux's colour-name table so a typo is rejected with the
  *  options rather than silently ignored by tmux. */
@@ -301,10 +304,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.
@@ -359,6 +366,12 @@ function dispatchCanvasCommand(name, arg, ctx) {
             else
                 ctx.notify('The GRAPH overlay is not wired into the viewer yet');
             return true;
+        case 'inbox':
+            if (ctx.onInbox)
+                ctx.onInbox();
+            else
+                ctx.notify('The inbox surface is not wired into the viewer yet');
+            return true;
         case 'promote':
             promoteNode(arg, ctx);
             return true;
@@ -366,10 +379,6 @@ function dispatchCanvasCommand(name, arg, ctx) {
             // Open the full-screen canvas navigator as a popup; on Enter it focuses the
             // chosen node back into THIS pane via `crtr surface node focus`.
             return resumeNode(ctx);
-        case 'view':
-            // Bare `/view` opens the picker, `/view <name>` opens that view directly —
-            // each as a self-contained popup (no node-focus, no return-pane).
-            return openView(arg, ctx);
         case 'mcp':
             // MCP server status panel — viewer-local reads of the adapter's on-disk
             // config sources/cache (see overlays/mcp.ts); the actions (connect /
@@ -402,6 +411,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;
@@ -587,18 +621,6 @@ function resumeNode(ctx) {
     popup(cmd);
     return true;
 }
-/** `/view [name]`. Bare opens the picker; with a name it opens that view directly. Self-contained
- *  popup — no node-focus, no return-pane. */
-function openView(arg, ctx) {
-    if (process.env['TMUX'] === undefined) {
-        ctx.notify('/view needs tmux');
-        return true;
-    }
-    const name = arg.trim();
-    const cmd = name === '' ? 'crtr surface view pick' : `crtr surface view run ${shellQuote(name)}`;
-    popup(cmd);
-    return true;
-}
 /** `/context`. Opens `crtr node inspect context` as a popup — a
  *  read-only nvim explorer over this node's + its subscriptions' context dirs.
  *  Self-contained popup — no node-focus, no return-pane. */