@pellux/goodvibes-tui 0.18.4

package/src/panels/remote-panel.ts

@@ -0,0 +1,449 @@
+import type { Line } from '@pellux/goodvibes-sdk/platform/types/grid';
+import { createEmptyLine } from '@pellux/goodvibes-sdk/platform/types/grid';
+import { BasePanel } from './base-panel.ts';
+import type { UiReadModel, UiRemoteSnapshot } from '../runtime/ui-read-models.ts';
+import {
+  buildDetailBlock,
+  buildEmptyState,
+  buildGuidanceLine,
+  buildPanelListRow,
+  buildPanelLine,
+  buildSummaryBlock,
+  buildPanelWorkspace,
+  DEFAULT_PANEL_PALETTE,
+  resolvePrimaryScrollableSection,
+  type PanelWorkspaceSection,
+} from './polish.ts';
+import { truncateDisplay } from '@pellux/goodvibes-sdk/platform/utils/terminal-width';
+import { getTrackedVisibleWindow } from '../renderer/surface-layout.ts';
+
+const C = {
+  ...DEFAULT_PANEL_PALETTE,
+  header: '#94a3b8',
+  headerBg: '#1e293b',
+  dim: '#475569',
+  ok: '#22c55e',
+  warn: '#eab308',
+  error: '#ef4444',
+} as const;
+
+function stateColor(state: string): string {
+  switch (state) {
+    case 'connected':
+    case 'syncing':
+      return C.ok;
+    case 'degraded':
+    case 'reconnecting':
+    case 'authenticating':
+    case 'initializing':
+      return C.warn;
+    case 'terminal_failure':
+      return C.error;
+    default:
+      return C.dim;
+  }
+}
+
+function formatTimestamp(value?: number): string {
+  return value ? new Date(value).toLocaleTimeString() : 'n/a';
+}
+
+function truncate(text: string, width: number): string {
+  return truncateDisplay(text, width);
+}
+
+export class RemotePanel extends BasePanel {
+  private readonly readModel?: UiReadModel<UiRemoteSnapshot>;
+  private readonly unsub: (() => void) | null;
+  private selectedIndex = 0;
+  private scrollOffset = 0;
+  private browseMode: 'connections' | 'contracts' = 'connections';
+
+  public constructor(readModel?: UiReadModel<UiRemoteSnapshot>) {
+    super('remote', 'Remote', 'R', 'monitoring');
+    this.readModel = readModel;
+    this.unsub = readModel ? readModel.subscribe(() => this.markDirty()) : null;
+  }
+
+  public override onDestroy(): void {
+    this.unsub?.();
+  }
+
+  public handleInput(key: string): boolean {
+    const activeConnections = this.getActiveConnections();
+    const contracts = this.readModel?.getSnapshot().contracts ?? [];
+    const browseCount = this.browseMode === 'connections' && activeConnections.length > 0
+      ? activeConnections.length
+      : contracts.length;
+    if (key === 'tab' && contracts.length > 0) {
+      this.browseMode = this.browseMode === 'connections' ? 'contracts' : 'connections';
+      this.selectedIndex = 0;
+      this.markDirty();
+      return true;
+    }
+    if (browseCount === 0) return false;
+    if (key === 'up' || key === 'k') {
+      this.selectedIndex = Math.max(0, this.selectedIndex - 1);
+      this.markDirty();
+      return true;
+    }
+    if (key === 'down' || key === 'j') {
+      this.selectedIndex = Math.min(browseCount - 1, this.selectedIndex + 1);
+      this.markDirty();
+      return true;
+    }
+    if (key === 'home') {
+      this.selectedIndex = 0;
+      this.markDirty();
+      return true;
+    }
+    if (key === 'end') {
+      this.selectedIndex = Math.max(0, browseCount - 1);
+      this.markDirty();
+      return true;
+    }
+    return false;
+  }
+
+  private getActiveConnections() {
+    return this.readModel?.getSnapshot().acp.activeConnections ?? [];
+  }
+
+  public render(width: number, height: number): Line[] {
+    this.needsRender = false;
+    const intro = 'Bridge, ACP, runner-contract, and artifact posture for self-hosted remote work.';
+
+    if (!this.readModel) {
+      const sectionLines = buildEmptyState(
+        width,
+        ' Runtime store not wired into this panel yet.',
+        'The remote control room needs the shell read model so it can display ACP state, runner contracts, and replay artifacts.',
+        [
+          { command: '/remote setup', summary: 'review bootstrap, env, tunnel, and bridge guidance' },
+          { command: '/remote panel', summary: 'reopen the panel from the shell-owned runtime' },
+        ],
+        C,
+      );
+      const lines = buildPanelWorkspace(width, height, {
+        title: 'Remote Control Room',
+        intro,
+        sections: [{ lines: sectionLines }],
+        palette: C,
+      });
+      while (lines.length < height) lines.push(createEmptyLine(width));
+      return lines;
+    }
+
+    const snapshot = this.readModel.getSnapshot();
+    const daemon = snapshot.daemon;
+    const acp = snapshot.acp;
+    const activeConnections = this.getActiveConnections();
+    const artifactCount = snapshot.artifacts.length;
+    const pools = snapshot.pools;
+    const contracts = snapshot.contracts;
+    const supervisor = snapshot.supervisor;
+    const distributed = {
+      pairRequests: { pending: snapshot.distributed.pairRequests.length },
+      peers: {
+        total: snapshot.distributed.peers.length,
+        connected: snapshot.distributed.peers.filter((peer) => peer.status === 'connected').length,
+        nodes: snapshot.distributed.peers.filter((peer) => peer.kind === 'node').length,
+        devices: snapshot.distributed.peers.filter((peer) => peer.kind === 'device').length,
+      },
+      work: {
+        queued: snapshot.distributed.work.filter((item) => item.status === 'queued').length,
+        claimed: snapshot.distributed.work.filter((item) => item.status === 'claimed').length,
+      },
+    };
+
+    const postureLines: Line[] = [
+      buildPanelLine(width, [
+        [' daemon ', C.label],
+        [daemon.transportState.toUpperCase(), stateColor(daemon.transportState)],
+        ['  running ', C.label],
+        [daemon.isRunning ? 'yes' : 'no', daemon.isRunning ? C.ok : C.dim],
+        ['  reconnects ', C.label],
+        [String(daemon.reconnectAttempts), daemon.reconnectAttempts > 0 ? C.warn : C.ok],
+        ['  jobs ', C.label],
+        [String(daemon.runningJobCount), daemon.runningJobCount > 0 ? C.info : C.dim],
+      ]),
+      buildPanelLine(width, [
+        [' ACP manager ', C.label],
+        [acp.transportState.toUpperCase(), stateColor(acp.transportState)],
+        ['  active connections ', C.label],
+        [String(acp.activeConnections.length), acp.activeConnections.length > 0 ? C.info : C.dim],
+        ['  total messages ', C.label],
+        [String(acp.totalMessages), acp.totalMessages > 0 ? C.value : C.dim],
+      ]),
+      buildPanelLine(width, [
+        [' runner contracts ', C.label],
+        [String(contracts.length), C.info],
+        ['  pools ', C.label],
+        [String(pools.length), pools.length > 0 ? C.info : C.dim],
+        ['  review artifacts ', C.label],
+        [String(artifactCount), artifactCount > 0 ? C.ok : C.dim],
+      ]),
+      buildPanelLine(width, [
+        [' supervisor ', C.label],
+        [String(supervisor.sessions.length), C.info],
+        ['  degraded ', C.label],
+        [String(supervisor.degradedConnections), supervisor.degradedConnections > 0 ? C.warn : C.ok],
+        [' distributed peers ', C.label],
+        [String(distributed.peers?.total ?? 0), C.info],
+        ['  connected ', C.label],
+        [String(distributed.peers?.connected ?? 0), (distributed.peers?.connected ?? 0) > 0 ? C.ok : C.dim],
+        ['  queued work ', C.label],
+        [String(distributed.work?.queued ?? 0), (distributed.work?.queued ?? 0) > 0 ? C.info : C.dim],
+      ]),
+    ];
+
+    if (daemon.lastError) {
+      postureLines.push(buildPanelLine(width, [
+        [' daemon error ', C.label],
+        [daemon.lastError.slice(0, Math.max(0, width - 14)), C.error],
+      ]));
+    }
+    postureLines.push(
+      buildGuidanceLine(width, '/remote recover', 'resume remote state with runner, capability, and disconnect recovery hints', C),
+      buildGuidanceLine(width, '/remote capabilities', 'inspect transport support before routing remote work or reattaching a session', C),
+    );
+
+    const footerLines = [
+      buildGuidanceLine(width, '/remote setup', 'review bridge, tunnel, env, and bootstrap flows for self-hosted remote work', C),
+      buildPanelLine(width, [[`  focus=${this.browseMode}  Up/Down move  Tab switch connections/contracts`, C.dim]]),
+    ] as const;
+
+    if (activeConnections.length === 0 && contracts.length === 0) {
+      const idleLines = [
+        ...postureLines,
+        ...buildEmptyState(
+          width,
+          ' No active ACP or remote subagent connections.',
+          'The remote control room is healthy but idle. Runner contracts, session bundles, and bridge pools will appear here once remote work starts.',
+          [
+            { command: '/remote setup', summary: 'review remote bootstrap and environment export' },
+            { command: '/remote env', summary: 'emit a reusable remote shell snippet' },
+            { command: '/bridge status', summary: 'inspect runner pools and existing remote artifacts' },
+          ],
+          C,
+        ),
+      ];
+      const lines = buildPanelWorkspace(width, height, {
+        title: 'Remote Control Room',
+        intro,
+        sections: [{ lines: buildSummaryBlock(width, 'Remote posture', idleLines, C) }],
+        footerLines,
+        palette: C,
+      });
+      while (lines.length < height) lines.push(createEmptyLine(width));
+      return lines.slice(0, height);
+    }
+
+    const viewingConnections = this.browseMode === 'connections' && activeConnections.length > 0;
+    this.selectedIndex = Math.min(
+      this.selectedIndex,
+      Math.max(0, (viewingConnections ? activeConnections.length : contracts.length) - 1),
+    );
+    const browseCount = viewingConnections ? activeConnections.length : contracts.length;
+    const selected = viewingConnections ? activeConnections[this.selectedIndex] ?? null : null;
+    const selectedContract = !viewingConnections ? contracts[this.selectedIndex] ?? null : null;
+    const detailRows: Line[] = [];
+
+    if (selected) {
+      detailRows.push(buildPanelLine(width, [
+        ['  Agent: ', C.label],
+        [selected.agentId, C.value],
+        ['  State: ', C.label],
+        [selected.transportState, stateColor(selected.transportState)],
+        ['  Completing: ', C.label],
+        [selected.completing ? 'yes' : 'no', selected.completing ? C.warn : C.dim],
+      ]));
+      detailRows.push(buildPanelLine(width, [
+        ['  Connected: ', C.label],
+        [formatTimestamp(selected.connectedAt), C.dim],
+        ['  Messages: ', C.label],
+        [String(selected.messageCount), selected.messageCount > 0 ? C.info : C.dim],
+        ['  Errors: ', C.label],
+        [String(selected.errorCount), selected.errorCount > 0 ? C.warn : C.dim],
+      ]));
+      if (selected.lastError) {
+        detailRows.push(buildPanelLine(width, [
+          ['  Last error: ', C.label],
+          [selected.lastError.slice(0, Math.max(0, width - 13)), C.error],
+        ]));
+      }
+
+      const contract = contracts.find((entry) => entry.runnerId === selected.agentId);
+      if (contract) {
+        detailRows.push(buildPanelLine(width, [
+          ['  Contract: ', C.label],
+          [`${contract.template} / ${contract.trustClass}`, C.info],
+          ['  Pool: ', C.label],
+          [contract.poolId ?? '(none)', contract.poolId ? C.info : C.dim],
+        ]));
+        detailRows.push(buildPanelLine(width, [
+          ['  Depth: ', C.label],
+          [String(contract.capabilityCeiling.orchestrationDepth), C.value],
+          ['  Pools: ', C.label],
+          [String(pools.length), pools.length > 0 ? C.info : C.dim],
+        ]));
+        detailRows.push(buildPanelLine(width, [
+          ['  Protocol: ', C.label],
+          [contract.capabilityCeiling.executionProtocol, C.value],
+          ['  Review: ', C.label],
+          [contract.capabilityCeiling.reviewMode, C.value],
+          ['  Lane: ', C.label],
+          [contract.capabilityCeiling.communicationLane, C.value],
+        ]));
+        detailRows.push(buildPanelLine(width, [
+          ['  Tools: ', C.label],
+          [truncate(contract.capabilityCeiling.allowedTools.join(', ') || '(none)', Math.max(0, width - 10)), C.dim],
+        ]));
+      }
+
+      if (selected.taskId) {
+        detailRows.push(buildPanelLine(width, [
+          ['  Task: ', C.label],
+          [selected.taskId, C.value],
+        ]));
+      }
+
+      const supervisorEntry = supervisor.sessions.find((entry) => entry.runnerId === selected.agentId);
+      if (supervisorEntry) {
+        detailRows.push(buildPanelLine(width, [
+          ['  Heartbeat: ', C.label],
+          [supervisorEntry.heartbeat.status, supervisorEntry.heartbeat.status === 'fresh' ? C.ok : supervisorEntry.heartbeat.status === 'stale' ? C.warn : C.error],
+          ['  Protocol: ', C.label],
+          [supervisorEntry.negotiation.executionProtocol, C.value],
+          ['  Review: ', C.label],
+          [supervisorEntry.negotiation.reviewMode, supervisorEntry.negotiation.reviewMode === 'wrfc' ? C.ok : C.dim],
+        ]));
+        detailRows.push(buildPanelLine(width, [[`  ${supervisorEntry.heartbeat.detail}`.slice(0, width), C.dim]]));
+      }
+
+      const recentArtifact = snapshot.artifacts.find((artifact) => artifact.runnerId === selected.agentId);
+      if (recentArtifact) {
+        detailRows.push(buildPanelLine(width, [[' Recent Review Artifact', C.label]]));
+        detailRows.push(buildPanelLine(width, [
+          ['  Artifact: ', C.label],
+          [recentArtifact.id, C.value],
+          ['  Status: ', C.label],
+          [recentArtifact.task.status, stateColor(recentArtifact.evidence.transportState)],
+        ]));
+        detailRows.push(buildPanelLine(width, [
+          ['  Summary: ', C.label],
+          [truncate(recentArtifact.task.summary, Math.max(0, width - 12)), C.dim],
+        ]));
+      }
+      detailRows.push(buildPanelLine(width, [
+        ['  Tip: ', C.label],
+        ['Use Up/Down or j/k to inspect another connection.', C.dim],
+      ]));
+    } else if (selectedContract) {
+      detailRows.push(buildPanelLine(width, [
+        ['  Runner: ', C.label],
+        [selectedContract.runnerId, C.value],
+        ['  Template: ', C.label],
+        [selectedContract.template, C.info],
+        ['  Trust: ', C.label],
+        [selectedContract.trustClass, C.value],
+      ]));
+      detailRows.push(buildPanelLine(width, [
+        ['  Pool: ', C.label],
+        [selectedContract.poolId ?? '(none)', selectedContract.poolId ? C.info : C.dim],
+        ['  Transport: ', C.label],
+        [selectedContract.transport.state, stateColor(selectedContract.transport.state)],
+      ]));
+      detailRows.push(buildPanelLine(width, [
+        ['  Protocol: ', C.label],
+        [selectedContract.capabilityCeiling.executionProtocol, C.value],
+        ['  Review: ', C.label],
+        [selectedContract.capabilityCeiling.reviewMode, C.value],
+        ['  Lane: ', C.label],
+        [selectedContract.capabilityCeiling.communicationLane, C.value],
+      ]));
+      detailRows.push(buildPanelLine(width, [
+        ['  Tools: ', C.label],
+        [truncate(selectedContract.capabilityCeiling.allowedTools.join(', ') || '(none)', Math.max(0, width - 10)), C.dim],
+      ]));
+      const supervisorEntry = supervisor.sessions.find((entry) => entry.runnerId === selectedContract.runnerId);
+      if (supervisorEntry) {
+        detailRows.push(buildPanelLine(width, [
+          ['  Heartbeat: ', C.label],
+          [supervisorEntry.heartbeat.status, supervisorEntry.heartbeat.status === 'fresh' ? C.ok : supervisorEntry.heartbeat.status === 'stale' ? C.warn : C.error],
+          ['  Lane: ', C.label],
+          [supervisorEntry.negotiation.communicationLane, C.info],
+        ]));
+        for (const action of supervisorEntry.recovery.slice(0, 2)) {
+          detailRows.push(buildGuidanceLine(width, action.command, action.reason, C));
+        }
+      }
+      const recentArtifact = snapshot.artifacts.find((artifact) => artifact.runnerId === selectedContract.runnerId);
+      if (recentArtifact) {
+        detailRows.push(buildPanelLine(width, [
+          ['  Recent artifact: ', C.label],
+          [recentArtifact.id, C.ok],
+          ['  Status: ', C.label],
+          [recentArtifact.task.status, stateColor(recentArtifact.evidence.transportState)],
+        ]));
+      }
+    }
+    const postureSection: PanelWorkspaceSection = { lines: buildSummaryBlock(width, 'Remote posture', postureLines, C) };
+    const detailSection: PanelWorkspaceSection = {
+      lines: buildDetailBlock(width, selected ? 'Selected connection' : 'Selected contract', detailRows, C),
+    };
+    const browseTitle = viewingConnections ? 'Active Connections' : 'Registered Remote Runner Contracts';
+    const rawBrowseLines: Line[] = viewingConnections
+      ? activeConnections.map((connection, absolute) => {
+          return buildPanelListRow(width, [
+            { text: connection.agentId.padEnd(18), fg: C.value },
+            { text: ` ${connection.transportState.padEnd(18)}`, fg: stateColor(connection.transportState) },
+            { text: ` msgs=${String(connection.messageCount).padEnd(6)}`, fg: C.info },
+            { text: ` errs=${String(connection.errorCount).padEnd(4)}`, fg: connection.errorCount > 0 ? C.warn : C.dim },
+            { text: ` ${connection.label}`.slice(0, Math.max(0, width - 56)), fg: C.dim },
+          ], C, { selected: absolute === this.selectedIndex, selectedBg: C.headerBg });
+        })
+      : [
+          ...contracts.map((contract, absolute) => {
+            return buildPanelListRow(width, [
+              { text: contract.runnerId.padEnd(18), fg: C.value },
+              { text: ` ${contract.transport.state.padEnd(18)}`, fg: stateColor(contract.transport.state) },
+              { text: ` ${contract.template}`.slice(0, Math.max(0, width - 42)), fg: C.dim },
+            ], C, { selected: absolute === this.selectedIndex, selectedBg: C.headerBg });
+          }),
+          buildPanelLine(width, [[' No active connection is currently attached to these contracts.', C.dim]]),
+        ];
+    const resolvedBrowseSection = resolvePrimaryScrollableSection(width, height, {
+      intro,
+      footerLines,
+      palette: C,
+      beforeSections: [postureSection],
+      section: {
+        title: browseTitle,
+        scrollableLines: rawBrowseLines,
+        selectedIndex: this.selectedIndex,
+        scrollOffset: this.scrollOffset,
+        guardRows: 1,
+        minRows: 4,
+        appendWindowSummary: viewingConnections ? { dimColor: C.dim } : undefined,
+      },
+      afterSections: [detailSection],
+    });
+    this.scrollOffset = resolvedBrowseSection.scrollOffset;
+
+    const sections: PanelWorkspaceSection[] = [
+      postureSection,
+      resolvedBrowseSection.section,
+      detailSection,
+    ];
+    const lines = buildPanelWorkspace(width, height, {
+      title: 'Remote Control Room',
+      intro,
+      sections,
+      footerLines,
+      palette: C,
+    });
+    while (lines.length < height) lines.push(createEmptyLine(width));
+    return lines.slice(0, height);
+  }
+}

package/src/panels/routes-panel.ts

@@ -0,0 +1,228 @@
+import type { Line } from '@pellux/goodvibes-sdk/platform/types/grid';
+import { createEmptyLine } from '@pellux/goodvibes-sdk/platform/types/grid';
+import { BasePanel } from './base-panel.ts';
+import type { UiReadModel, UiRoutesSnapshot } from '../runtime/ui-read-models.ts';
+import { truncateDisplay } from '@pellux/goodvibes-sdk/platform/utils/terminal-width';
+import {
+  buildEmptyState,
+  buildGuidanceLine,
+  buildKeyValueLine,
+  buildPanelLine,
+  buildPanelWorkspace,
+  DEFAULT_PANEL_PALETTE,
+  resolvePrimaryScrollableSection,
+  type PanelWorkspaceSection,
+} from './polish.ts';
+
+const C = {
+  ...DEFAULT_PANEL_PALETTE,
+  header: '#94a3b8',
+  headerBg: '#1e293b',
+  ok: '#22c55e',
+  warn: '#eab308',
+  error: '#ef4444',
+  info: '#38bdf8',
+  selectBg: '#0f172a',
+} as const;
+
+function formatTime(value?: number): string {
+  if (!value) return 'n/a';
+  return new Date(value).toLocaleString();
+}
+
+export class RoutesPanel extends BasePanel {
+  private readonly readModel?: UiReadModel<UiRoutesSnapshot>;
+  private readonly unsub: (() => void) | null;
+  private selectedIndex = 0;
+  private scrollOffset = 0;
+
+  public constructor(readModel?: UiReadModel<UiRoutesSnapshot>) {
+    super('routes', 'Routes', 'R', 'monitoring');
+    this.readModel = readModel;
+    this.unsub = readModel ? readModel.subscribe(() => this.markDirty()) : null;
+  }
+
+  public override onDestroy(): void {
+    this.unsub?.();
+  }
+
+  public handleInput(key: string): boolean {
+    const bindings = this.bindings();
+    if (bindings.length === 0) return false;
+    if (key === 'up' || key === 'k') {
+      this.selectedIndex = Math.max(0, this.selectedIndex - 1);
+      this.markDirty();
+      return true;
+    }
+    if (key === 'down' || key === 'j') {
+      this.selectedIndex = Math.min(bindings.length - 1, this.selectedIndex + 1);
+      this.markDirty();
+      return true;
+    }
+    return false;
+  }
+
+  private bindings() {
+    if (!this.readModel) return [];
+    return [...this.readModel.getSnapshot().bindings];
+  }
+
+  public render(width: number, height: number): Line[] {
+    this.needsRender = false;
+    const intro = 'External route bindings that preserve thread, session, and reply context across Slack, Discord, ntfy, webhook, web, and TUI surfaces.';
+
+    if (!this.readModel) {
+      const workspace = buildPanelWorkspace(width, height, {
+        title: 'Route Bindings',
+        intro,
+        sections: [{
+          lines: buildEmptyState(
+            width,
+            ' Runtime store not wired.',
+            'This panel needs the shared runtime store to inspect omnichannel route bindings.',
+            [{ command: '/communication', summary: 'review communication posture while route state is unavailable' }],
+            C,
+          ),
+        }],
+        palette: C,
+      });
+      while (workspace.length < height) workspace.push(createEmptyLine(width));
+      return workspace;
+    }
+
+    const snapshot = this.readModel.getSnapshot();
+    const bindings = this.bindings();
+    const surfaceEntries = Object.entries(snapshot.bindingIdsBySurface)
+      .filter(([, ids]) => ids.length > 0)
+      .sort((a, b) => b[1].length - a[1].length || a[0].localeCompare(b[0]));
+
+    const summarySection: PanelWorkspaceSection = {
+      title: 'Posture',
+      lines: [
+        buildKeyValueLine(width, [
+          { label: 'bindings', value: String(snapshot.totalBindings), valueColor: snapshot.totalBindings > 0 ? C.info : C.dim },
+          { label: 'active', value: String(snapshot.activeBindingIds.length), valueColor: snapshot.activeBindingIds.length > 0 ? C.ok : C.dim },
+          { label: 'resolved', value: String(snapshot.totalResolved), valueColor: snapshot.totalResolved > 0 ? C.ok : C.dim },
+          { label: 'failures', value: String(snapshot.totalFailures), valueColor: snapshot.totalFailures > 0 ? C.error : C.dim },
+        ], C),
+        buildGuidanceLine(width, '/communication', 'inspect routed message flow and delivery behavior across bound surfaces', C),
+      ],
+    };
+
+    if (bindings.length === 0) {
+      const workspace = buildPanelWorkspace(width, height, {
+        title: 'Route Bindings',
+        intro,
+        sections: [
+          summarySection,
+          {
+            lines: buildEmptyState(
+              width,
+              ' No route bindings recorded.',
+              'Bindings appear when the daemon links an external surface, thread, or remote client to a shared session or automation run.',
+              [
+                { command: '/schedule list', summary: 'run jobs and triggers that create route bindings' },
+                { command: '/communication', summary: 'inspect routed communication once a surface is active' },
+              ],
+              C,
+            ),
+          },
+        ],
+        palette: C,
+      });
+      while (workspace.length < height) workspace.push(createEmptyLine(width));
+      return workspace;
+    }
+
+    this.selectedIndex = Math.min(this.selectedIndex, Math.max(0, bindings.length - 1));
+    const selected = bindings[this.selectedIndex]!;
+
+    const surfaceSection: PanelWorkspaceSection = {
+      title: 'Surfaces',
+      lines: surfaceEntries.length > 0
+        ? surfaceEntries.slice(0, 6).map(([surface, ids]) => buildPanelLine(width, [
+            [' ', C.label],
+            [surface.padEnd(10), C.info],
+            [` ${String(ids.length)} binding(s)`, C.value],
+          ]))
+        : [buildPanelLine(width, [['  No surface counts recorded.', C.dim]])],
+    };
+
+    const detailSection: PanelWorkspaceSection = {
+      title: 'Selected Binding',
+      lines: [
+        buildPanelLine(width, [
+          ['  Binding: ', C.label],
+          [selected.id, C.value],
+          ['  Surface: ', C.label],
+          [selected.surfaceKind, C.info],
+        ]),
+        buildPanelLine(width, [
+          ['  External: ', C.label],
+          [truncateDisplay(selected.externalId, 28), C.value],
+          ['  Kind: ', C.label],
+          [selected.kind, C.dim],
+        ]),
+        buildPanelLine(width, [
+          ['  Session: ', C.label],
+          [selected.sessionId ?? 'n/a', C.value],
+          ['  Run: ', C.label],
+          [selected.runId ?? 'n/a', C.dim],
+        ]),
+        buildPanelLine(width, [
+          ['  Channel: ', C.label],
+          [selected.channelId ?? 'n/a', C.dim],
+          ['  Thread: ', C.label],
+          [selected.threadId ?? 'n/a', C.dim],
+        ]),
+        buildPanelLine(width, [
+          ['  Last seen: ', C.label],
+          [formatTime(selected.lastSeenAt), C.dim],
+        ]),
+      ],
+    };
+
+    const resolvedBindings = resolvePrimaryScrollableSection(width, height, {
+      intro,
+      footerLines: [buildPanelLine(width, [['  Up/Down move through route bindings', C.dim]])],
+      palette: C,
+      beforeSections: [summarySection],
+      section: {
+        title: 'Bindings',
+        scrollableLines: bindings.map((binding, absolute) => {
+          const bg = absolute === this.selectedIndex ? C.selectBg : undefined;
+          return buildPanelLine(width, [
+            [' ', C.label, bg],
+            [binding.surfaceKind.padEnd(9), C.info, bg],
+            [` ${truncateDisplay(binding.title ?? binding.externalId, 22).padEnd(22)}`, C.value, bg],
+            [` ${truncateDisplay(binding.sessionId ?? binding.runId ?? 'unbound', 18).padEnd(18)}`, binding.sessionId ? C.ok : C.warn, bg],
+            [` ${truncateDisplay(formatTime(binding.lastSeenAt), Math.max(0, width - 54))}`, C.dim, bg],
+          ]);
+        }),
+        selectedIndex: this.selectedIndex,
+        scrollOffset: this.scrollOffset,
+        guardRows: 1,
+        minRows: 5,
+        appendWindowSummary: { dimColor: C.dim },
+      },
+      afterSections: [detailSection, surfaceSection],
+    });
+    this.scrollOffset = resolvedBindings.scrollOffset;
+
+    const sections: PanelWorkspaceSection[] = [
+      summarySection,
+      resolvedBindings.section,
+      detailSection,
+      surfaceSection,
+    ];
+    const lines = buildPanelWorkspace(width, height, {
+      title: 'Route Bindings',
+      intro,
+      sections,
+      footerLines: [buildPanelLine(width, [['  Up/Down move through route bindings', C.dim]])],
+      palette: C,
+    });
+    while (lines.length < height) lines.push(createEmptyLine(width));
+    return lines.slice(0, height);
+  }
+}