elanous 0.2.0 → 0.2.4

package/src/dashboard/hud-mirror.ts

@@ -1,207 +0,0 @@
-// PLAN-chat-hud-multi-surface-port-2026-05-13 §4 M3 — Dashboard HUD
-// segment → daemon mirror.
-//
-// Bridges the dashboard process's local HudState (`src/panes/hud.ts`,
-// populated by 11 setSegment call-sites in `src/dashboard/index.ts`)
-// to the daemon's HudStore via `POST /v1/hud-segment`. After the
-// daemon receives the segment it fans out as a `hud.segment`
-// NexusEvent on `/v1/events`, so PWA `<ChatHud>` (M4) hydrates from
-// dashboard-only writers.
-//
-// Mirrors `src/agent-status/daemon-mirror.ts` 1:1 — same probe-once +
-// fire-and-forget POST pattern. Best-effort observer: probe failures
-// or POST errors never break the dashboard primary path, they only
-// log + skip.
-//
-// Two filters live here (not on the daemon):
-//  - **TUI-only segments**: chord · mode · chat-mode · conv-hover ·
-//    tr-pane-modal · copied · voice-state — semantically nonsensical
-//    on PWA (mouse hover labels · keyboard chord progress · already
-//    covered by VoiceOverlay). Source-side drop saves wire bytes.
-//  - **ANSI codes**: HUD values may carry ANSI color escapes (`C.muted`
-//    etc.). PWA renders via the `tone` enum, not raw ANSI — strip
-//    before POST so the browser never sees `\x1b[31m...\x1b[0m`.
-
-import { existsSync, readFileSync } from 'node:fs';
-import { join as joinPath } from 'node:path';
-
-import { elanousDaemonDir, readElanousDaemonRuntime } from '../elanous-daemon.js';
-import type { HudState, HudSubscriber } from '../panes/hud.js';
-import { subscribe as subscribeHud } from '../panes/hud.js';
-
-export interface HudMirrorActivation {
-  /** Stop forwarding HUD segments to the daemon. Idempotent. */
-  deactivate(): void;
-  /** True after a successful daemon probe; false when probe failed
-   *  or activation was never called. Diagnostic-only. */
-  active: boolean;
-  /** Resolved daemon http base URL or null when not active. */
-  baseUrl: string | null;
-}
-
-export interface HudMirrorOpts {
-  /** HudState to subscribe (typically the dashboard's). */
-  hud: HudState;
-  /** Override fetch for tests. */
-  fetchImpl?: typeof fetch;
-  /** Override discovery — tests inject `{ baseUrl, token? }` to skip
-   *  the runtime.json + acp-token files. */
-  discover?: () => { baseUrl: string; token?: string } | null;
-  /** Optional logger. */
-  log?: (msg: string) => void;
-  /** Optional segment-key drop list override. Default = TUI-only
-   *  segments (see DEFAULT_DROPPED_SEGMENT_KEYS). Tests can pass an
-   *  empty set to assert every segment forwards. */
-  droppedKeys?: ReadonlySet<string>;
-}
-
-/** TUI-only segments that have no PWA equivalent or duplicate an
- *  existing PWA primitive. Forwarding them costs wire bytes without
- *  user-visible value. */
-export const DEFAULT_DROPPED_SEGMENT_KEYS: ReadonlySet<string> = new Set([
-  'chord', // keyboard chord progress — TUI input only
-  'mode', // chat-only mode toggle — PWA is always chat-only
-  'chat-mode', // CONTROL vs NORMAL — TUI keyboard mode
-  'conv-hover', // mouse hover label — TUI mouse only
-  'tr-pane-modal', // TUI modal hint
-  'copied', // clipboard toast — PWA owns its own clipboard UX
-  'voice-state', // listening/speaking phase — covered by VoiceOverlay
-]);
-
-const ANSI_PATTERN = /\x1b\[[0-9;]*m/g;
-
-function stripAnsi(s: string): string {
-  return s.replace(ANSI_PATTERN, '');
-}
-
-function readAcpToken(): string | null {
-  const path = joinPath(elanousDaemonDir(), 'acp-token');
-  if (!existsSync(path)) return null;
-  try {
-    return readFileSync(path, 'utf8').trim() || null;
-  } catch {
-    return null;
-  }
-}
-
-function defaultDiscover(): { baseUrl: string; token?: string } | null {
-  const runtime = readElanousDaemonRuntime();
-  if (!runtime || !runtime.httpPort) return null;
-  const host = runtime.httpHost ?? '127.0.0.1';
-  const baseUrl = `http://${host}:${runtime.httpPort}`;
-  const token = runtime.httpAuth === 'on' ? readAcpToken() ?? undefined : undefined;
-  if (token === undefined) return { baseUrl };
-  return { baseUrl, token };
-}
-
-async function probeDaemon(
-  baseUrl: string,
-  token: string | undefined,
-  fetchImpl: typeof fetch,
-  timeoutMs = 1500,
-): Promise<boolean> {
-  try {
-    const ctrl = new AbortController();
-    const timer = setTimeout(() => ctrl.abort(), timeoutMs);
-    try {
-      const headers: Record<string, string> = {};
-      if (token) headers.authorization = `Bearer ${token}`;
-      const r = await fetchImpl(`${baseUrl}/v1/health`, {
-        signal: ctrl.signal,
-        headers,
-      });
-      return r.ok;
-    } finally {
-      clearTimeout(timer);
-    }
-  } catch {
-    return false;
-  }
-}
-
-interface UpsertBody {
-  key: string;
-  value: string;
-  priority?: number;
-}
-
-interface ClearBody {
-  key: string;
-  clear: true;
-}
-
-function postHudSegment(
-  baseUrl: string,
-  token: string | undefined,
-  body: UpsertBody | ClearBody,
-  fetchImpl: typeof fetch,
-  log: (msg: string) => void,
-): void {
-  const headers: Record<string, string> = { 'content-type': 'application/json' };
-  if (token) headers.authorization = `Bearer ${token}`;
-  fetchImpl(`${baseUrl}/v1/hud-segment`, {
-    method: 'POST',
-    headers,
-    body: JSON.stringify(body),
-  })
-    .then(async (r) => {
-      if (!r.ok) {
-        const text = await r.text().catch(() => '');
-        log(`hud-mirror: ${r.status} ${r.statusText} ${text}`);
-      }
-    })
-    .catch((e) => {
-      log(`hud-mirror: fetch failed: ${String(e)}`);
-    });
-}
-
-const DEACTIVATED: HudMirrorActivation = {
-  deactivate: () => { /* no-op */ },
-  active: false,
-  baseUrl: null,
-};
-
-export async function activateHudMirrorIfReachable(
-  opts: HudMirrorOpts,
-): Promise<HudMirrorActivation> {
-  const fetchImpl = opts.fetchImpl ?? fetch;
-  const discoverFn = opts.discover ?? defaultDiscover;
-  const log = opts.log ?? ((m: string) => console.warn(m));
-  const dropped = opts.droppedKeys ?? DEFAULT_DROPPED_SEGMENT_KEYS;
-  const discovery = discoverFn();
-  if (!discovery) return DEACTIVATED;
-  const reachable = await probeDaemon(discovery.baseUrl, discovery.token, fetchImpl);
-  if (!reachable) {
-    log(`hud-mirror: daemon at ${discovery.baseUrl} unreachable — skipping mirror`);
-    return { deactivate: () => { /* probe failed */ }, active: false, baseUrl: discovery.baseUrl };
-  }
-  const handler: HudSubscriber = (event) => {
-    if (dropped.has(event.key)) return;
-    if (event.kind === 'set') {
-      const value = stripAnsi(event.segment.value);
-      const body: UpsertBody = { key: event.key, value };
-      if (event.segment.priority !== undefined) body.priority = event.segment.priority;
-      postHudSegment(discovery.baseUrl, discovery.token, body, fetchImpl, log);
-    } else {
-      const body: ClearBody = { key: event.key, clear: true };
-      postHudSegment(discovery.baseUrl, discovery.token, body, fetchImpl, log);
-    }
-  };
-  const unsubscribe = subscribeHud(opts.hud, handler);
-  let active = true;
-  return {
-    deactivate() {
-      if (!active) return;
-      active = false;
-      try {
-        unsubscribe();
-      } catch {
-        /* swallow */
-      }
-    },
-    get active() {
-      return active;
-    },
-    baseUrl: discovery.baseUrl,
-  };
-}

package/src/dashboard/input/mouse-dock-runtime.ts

@@ -1,156 +0,0 @@
-import {
-  buildDashboardDockWindowTargets,
-  buildDashboardVirtualWindowEntries,
-  type DashboardVirtualWindowSeed,
-} from '../dock-picker-inventory.js';
-import type { CompactSurfaceHost } from '../compact-surface-host.js';
-import type { PaneFocus } from '../../workspace-types.js';
-
-export interface MouseDockRuntimeDeps {
-  listDockWindowPanes: () => PaneFocus[];
-  paneLabel: (pane: PaneFocus) => string;
-  openDockWindow: (pane: PaneFocus) => void;
-  compactSurfaceHost: CompactSurfaceHost;
-  listVirtualWindows: () => DashboardVirtualWindowSeed[];
-  getCurrentVirtualWindowId: () => number | null;
-  switchToVirtualWindow: (windowId: number) => void;
-  focusDashboardMain: () => void;
-  redraw: () => void;
-}
-
-export interface DashboardVirtualWindowMoverState {
-  canMoveLeft: boolean;
-  canMoveRight: boolean;
-  leftLabel: string;
-  rightLabel: string;
-}
-
-export interface MouseDockRuntime {
-  getDockMenuWindowTargets: () => ReturnType<typeof buildDashboardDockWindowTargets>;
-  onOpenDockWindow: (paneId: string) => Promise<void>;
-  getDockMenuSurfaceTargets: () => ReturnType<CompactSurfaceHost['getDockMenuSurfaceTargets']>;
-  onOpenDockSurface: (surfaceId: string) => Promise<void>;
-  onToggleChatOnly: () => Promise<void>;
-  getDashboardViews: () => ReturnType<CompactSurfaceHost['getDashboardViews']>;
-  onApplyDashboardView: (viewId: string) => Promise<void>;
-  getVirtualWindows: () => ReturnType<typeof buildDashboardVirtualWindowEntries>;
-  onSwitchVirtualWindow: (windowId: number) => Promise<void>;
-  getVirtualWindowMover: () => DashboardVirtualWindowMoverState;
-  onMoveVirtualWindow: (direction: 'left' | 'right') => Promise<boolean>;
-}
-
-export function createMouseDockRuntime(
-  deps: MouseDockRuntimeDeps,
-): MouseDockRuntime {
-  const sortedWindows = (): DashboardVirtualWindowSeed[] =>
-    deps.listVirtualWindows().slice().sort((a, b) => a.id - b.id);
-  const windowLabel = (window: DashboardVirtualWindowSeed): string =>
-    window.title.trim() ? window.title : `VW#${window.id}`;
-  const moverTargetLabel = (window: DashboardVirtualWindowSeed): string => {
-    const label = windowLabel(window);
-    return label.length > 5 ? `${label.slice(0, 5)}…` : label;
-  };
-
-  const switchVirtualWindowThroughRegistry = (windowId: number): void => {
-    deps.switchToVirtualWindow(windowId);
-    deps.redraw();
-  };
-
-  const moverState = (): DashboardVirtualWindowMoverState => {
-    const windows = sortedWindows();
-    const current = deps.getCurrentVirtualWindowId();
-    if (windows.length === 0) {
-      return {
-        canMoveLeft: false,
-        canMoveRight: false,
-        leftLabel: '⏹️',
-        rightLabel: '⏹️',
-      };
-    }
-    if (current === null) {
-      return {
-        canMoveLeft: false,
-        canMoveRight: true,
-        leftLabel: '⏹️',
-        rightLabel: `${moverTargetLabel(windows[0]!)} ➡️`,
-      };
-    }
-    const idx = windows.findIndex((window) => window.id === current);
-    if (idx < 0) {
-      return {
-        canMoveLeft: false,
-        canMoveRight: true,
-        leftLabel: '⏹️',
-        rightLabel: `${moverTargetLabel(windows[0]!)} ➡️`,
-      };
-    }
-    return {
-      canMoveLeft: true,
-      canMoveRight: idx < windows.length - 1,
-      leftLabel: idx === 0 ? '⬅️ Main' : `⬅️ ${moverTargetLabel(windows[idx - 1]!)}`,
-      rightLabel: idx < windows.length - 1 ? `${moverTargetLabel(windows[idx + 1]!)} ➡️` : '⏹️',
-    };
-  };
-
-  return {
-    getDockMenuWindowTargets: () =>
-      buildDashboardDockWindowTargets(
-        deps.listDockWindowPanes().map((pane) => ({
-          pane,
-          label: deps.paneLabel(pane),
-        })),
-      ),
-    onOpenDockWindow: async (paneId) => {
-      deps.openDockWindow(paneId as PaneFocus);
-      deps.redraw();
-    },
-    getDockMenuSurfaceTargets: () => deps.compactSurfaceHost.getDockMenuSurfaceTargets(),
-    onOpenDockSurface: async (surfaceId) => {
-      deps.compactSurfaceHost.openDockSurface(surfaceId);
-      deps.redraw();
-    },
-    onToggleChatOnly: async () => {
-      deps.compactSurfaceHost.toggleChatOnly();
-    },
-    getDashboardViews: () => deps.compactSurfaceHost.getDashboardViews(),
-    onApplyDashboardView: async (viewId) => {
-      deps.compactSurfaceHost.applyDashboardView(viewId);
-      deps.redraw();
-    },
-    getVirtualWindows: () =>
-      buildDashboardVirtualWindowEntries(
-        deps.listVirtualWindows(),
-        deps.getCurrentVirtualWindowId(),
-      ),
-    onSwitchVirtualWindow: async (windowId) => {
-      switchVirtualWindowThroughRegistry(windowId);
-    },
-    getVirtualWindowMover: () => moverState(),
-    onMoveVirtualWindow: async (direction) => {
-      const windows = sortedWindows();
-      const current = deps.getCurrentVirtualWindowId();
-      if (windows.length === 0) return false;
-      if (direction === 'right') {
-        if (current === null) {
-          deps.switchToVirtualWindow(windows[0]!.id);
-          return true;
-        }
-        const idx = windows.findIndex((window) => window.id === current);
-        if (idx >= 0 && idx < windows.length - 1) {
-          deps.switchToVirtualWindow(windows[idx + 1]!.id);
-          return true;
-        }
-        return false;
-      }
-      if (current === null) return false;
-      const idx = windows.findIndex((window) => window.id === current);
-      if (idx < 0) return false;
-      if (idx === 0) {
-        deps.focusDashboardMain();
-        return true;
-      }
-      deps.switchToVirtualWindow(windows[idx - 1]!.id);
-      return true;
-    },
-  };
-}

package/src/dashboard/input/mouse-hover-runtime.ts

@@ -1,46 +0,0 @@
-import type { DashboardMouseWiringDeps } from './mouse-wiring.js';
-
-export interface MouseHoverRuntimeDeps {
-  dispatchHoverToWidget: (
-    paneId: string,
-    event: import('../../widgets/types.js').WidgetHoverEvent,
-  ) => void;
-  setConversationHoverLabel: (label: string) => void;
-  clearConversationHoverLabel: () => void;
-  conversationHoverHudLabel: (
-    hit: Extract<
-      NonNullable<
-        NonNullable<
-          Parameters<NonNullable<DashboardMouseWiringDeps['onPaneHoverEvent']>>[0]['target']
-        >['hit']
-      >,
-      { kind: 'conversation-message' }
-    >,
-  ) => string;
-}
-
-export interface MouseHoverRuntime
-  extends Pick<DashboardMouseWiringDeps, 'dispatchHoverToWidget' | 'onPaneHoverEvent'> {}
-
-export function createMouseHoverRuntime(
-  deps: MouseHoverRuntimeDeps,
-): MouseHoverRuntime {
-  return {
-    dispatchHoverToWidget: (paneId, event) => {
-      deps.dispatchHoverToWidget(
-        paneId,
-        event as import('../../widgets/types.js').WidgetHoverEvent,
-      );
-    },
-    onPaneHoverEvent: (event) => {
-      const hit = event.target.hit;
-      if (hit?.kind === 'conversation-message') {
-        deps.setConversationHoverLabel(
-          deps.conversationHoverHudLabel(hit),
-        );
-        return;
-      }
-      deps.clearConversationHoverLabel();
-    },
-  };
-}

package/src/dashboard/input/mouse-pill-context-runtime.ts

@@ -1,74 +0,0 @@
-import { debug } from '../../debug/log.js';
-import type { DashboardMouseWiringDeps } from './mouse-wiring.js';
-
-export interface MousePillContextRuntimeDeps {
-  handleForPill: (name: string) => unknown;
-  showMenu: (
-    handle: unknown,
-    pos: { x: number; y: number },
-  ) => Promise<{ value: unknown; reason: string } | void>;
-  /** 2026-05-05 — pill context-menu 결과 dispatcher. value 는 buildPillMenu
-   *  의 command id (`pill.switch` · `pill.remove` · `pill.settings`).
-   *  reason 이 'selected' 일 때만 호출됨 (escape · outside-click ·
-   *  disposed 는 skip). 미지정 시 결과 무시 (legacy). pos = 우클릭이
-   *  발생한 (x,y) — 핸들러가 confirm popup 등을 같은 위치 anchor 로
-   *  띄울 때 사용. */
-  onPillMenuPick?: (
-    name: string,
-    value: string,
-    pos: { x: number; y: number },
-  ) => void | Promise<void>;
-}
-
-export interface MousePillContextRuntime
-  extends Pick<DashboardMouseWiringDeps, 'onPillRightClick'> {}
-
-export function createMousePillContextRuntime(
-  deps: MousePillContextRuntimeDeps,
-): MousePillContextRuntime {
-  return {
-    onPillRightClick: (name, pos) => {
-      const handle = deps.handleForPill(name);
-      if (debug.enabled) {
-        debug.log('mouse.pill.context', 'right-click', {
-          name,
-          hasHandle: !!handle,
-          pos,
-        });
-      }
-      if (!handle) return;
-      void Promise.resolve(deps.showMenu(handle, pos))
-        .then((result) => {
-          if (debug.enabled) {
-            debug.log('mouse.pill.context', 'showMenu.resolved', {
-              name,
-              reason: result?.reason ?? '(no result)',
-              value: typeof result?.value === 'string' ? result.value : '(non-string)',
-            });
-          }
-          if (!deps.onPillMenuPick) return;
-          if (!result) return;
-          // MenuCloseReason 의 canonical 값은 'selected' (context-menu-
-          // registry.ts:119). 직전 PR 에서 'select' 로 잘못 비교해 마우스
-          // 선택이 항상 skip 되던 버그 — 로그 trail (showMenu.resolved
-          // reason='selected') 로 발견.
-          if (result.reason !== 'selected') return;
-          if (typeof result.value !== 'string') return;
-          try {
-            void deps.onPillMenuPick(name, result.value, pos);
-          } catch {
-            /* host owns its error surface */
-          }
-        })
-        .catch((err) => {
-          if (debug.enabled) {
-            debug.log('mouse.pill.context', 'showMenu.rejected', {
-              name,
-              err: err instanceof Error ? err.message : String(err),
-            });
-          }
-          /* presenter failures are already surfaced elsewhere */
-        });
-    },
-  };
-}

package/src/dashboard/input/mouse-workspace-restore-runtime.ts

@@ -1,64 +0,0 @@
-import { parseCompanionSurfaceId } from '../companion-surface-address.js';
-import type { DashboardMouseWiringDeps } from './mouse-wiring.js';
-
-interface WorkspaceHostLike {
-  restoreMember(ownerId: string, surfaceId: string): void;
-}
-
-interface CompanionPopupHostLike {
-  ownerId: string;
-  includes(key: string): boolean;
-  markOpen(key: string): void;
-}
-
-export interface MouseWorkspaceRestoreRuntimeDeps {
-  workspaceHost: WorkspaceHostLike;
-  companionPopupHost: CompanionPopupHostLike;
-  openDebugWindow: () => void;
-  openDebugWorkbenchModal: () => void;
-  syncCompanionPopups: () => void;
-  openConversationModal: (sessionId: string) => Promise<boolean>;
-  redraw: () => void;
-}
-
-export interface MouseWorkspaceRestoreRuntime
-  extends Pick<DashboardMouseWiringDeps, 'onWorkspaceRestore'> {}
-
-export function createMouseWorkspaceRestoreRuntime(
-  deps: MouseWorkspaceRestoreRuntimeDeps,
-): MouseWorkspaceRestoreRuntime {
-  return {
-    onWorkspaceRestore: async (surfaceId) => {
-      if (surfaceId === 'debug-window') {
-        deps.workspaceHost.restoreMember('dashboard-main', surfaceId);
-        deps.openDebugWindow();
-        deps.redraw();
-        return;
-      }
-      if (surfaceId === 'debug-workbench') {
-        deps.workspaceHost.restoreMember('dashboard-main', surfaceId);
-        deps.openDebugWorkbenchModal();
-        deps.redraw();
-        return;
-      }
-      const companionAddress = parseCompanionSurfaceId(surfaceId);
-      if (companionAddress && companionAddress.ownerId === deps.companionPopupHost.ownerId) {
-        const key = companionAddress.key;
-        if (deps.companionPopupHost.includes(key)) {
-          deps.companionPopupHost.markOpen(key);
-          deps.syncCompanionPopups();
-          deps.redraw();
-          return;
-        }
-      }
-      if (surfaceId.startsWith('conversation-modal:')) {
-        const sessionId = surfaceId.slice('conversation-modal:'.length);
-        await deps.openConversationModal(sessionId);
-        deps.redraw();
-        return;
-      }
-      deps.workspaceHost.restoreMember('dashboard-main', surfaceId);
-      deps.redraw();
-    },
-  };
-}

package/src/dashboard/input/scratch-actions.ts

@@ -1,36 +0,0 @@
-import type { Key } from '../../tui.js';
-
-export interface ScratchListNavigationResult {
-  handled: boolean;
-  cursor: number;
-}
-
-export function runScratchListNavigation(
-  key: Key,
-  cursor: number,
-  length: number,
-): ScratchListNavigationResult {
-  if (length <= 0) {
-    if (key.name === 'g' || key.name === 'home') {
-      return { handled: true, cursor: 0 };
-    }
-    return { handled: false, cursor };
-  }
-
-  switch (key.name) {
-    case 'j':
-    case 'down':
-      return { handled: true, cursor: Math.min(cursor + 1, length - 1) };
-    case 'k':
-    case 'up':
-      return { handled: true, cursor: Math.max(0, cursor - 1) };
-    case 'g':
-    case 'home':
-      return { handled: true, cursor: 0 };
-    case 'G':
-    case 'end':
-      return { handled: true, cursor: length - 1 };
-    default:
-      return { handled: false, cursor };
-  }
-}

package/src/dashboard/input/virtual-window-key-router.ts

@@ -1,24 +0,0 @@
-import type { DashboardVirtualWindows } from '../windowing/virtual-windows.js';
-import { toDashboardKeyEvent, type DashboardKeyRouteResult } from './key-types.js';
-import type { Key } from '../../tui.js';
-
-/** KX4b — chord-only dispatcher for the VW navigation chord (^B 0..9
- *  etc.). The active VW surface is pushed as a ModalSurface via
- *  WindowRegistry.switchTo → coordinator.pushModal, so its onKey is
- *  reached through coordinator.routeKey naturally. Only the chord
- *  (a stateful multi-key interceptor, not a modal surface) stays in
- *  the dispatcher chain. Returns 'passthrough' when the chord isn't
- *  armed so keys fall through to coordinator.routeKey below. */
-export function routeVirtualWindowKey(
-  key: Key,
-  virtualWindows: DashboardVirtualWindows,
-): DashboardKeyRouteResult {
-  if (!virtualWindows.router.isArmed()) return 'passthrough';
-
-  const ev = toDashboardKeyEvent(key);
-  const navResult = virtualWindows.router.handleKey(ev);
-  if (navResult === 'armed' || navResult === 'consumed' || navResult === 'cancelled') {
-    return 'consumed';
-  }
-  return 'passthrough';
-}

package/src/dashboard/rich-scratch-viewers.ts

@@ -1,77 +0,0 @@
-import { readFileSync } from 'fs';
-import type { Attachment } from '../context.js';
-import { renderImagePreview } from '../image/preview.js';
-import { colorLine } from '../panes/syntax-color.js';
-import { C } from '../tui.js';
-import { scratchImageSize } from '../views/ui-mode.js';
-
-export interface RichScratchViewersDeps {
-  setDetailViewer: (title: string, lines: string[]) => void;
-  termSize: () => { rows: number; cols: number };
-  fmtBytes: (n: number) => string;
-}
-
-export interface RichScratchViewers {
-  setScratchImage: (sourcePath: string, filename: string) => Promise<void>;
-  setScratchFile: (attachment: Attachment) => void;
-}
-
-/** Rich-only scratch image/file preview. Callers pass the three closed-over
- *  values; this module does not read `showDashboard` state. */
-export function createRichScratchViewers(deps: RichScratchViewersDeps): RichScratchViewers {
-  const { setDetailViewer, termSize, fmtBytes } = deps;
-
-  /** Render `absPath` via chafa and drop the ANSI block into the
-   *  detail viewer with the filename as the title. Fire-and-forget
-   *  so the caller (image-attach paths) doesn't pay the subprocess
-   *  latency. */
-  const setScratchImage = async (absPath: string, label: string): Promise<void> => {
-    const { rows: tr, cols: tc } = termSize();
-    // Scratchpad shares the top half of the screen with browser +
-    // preview, so size the chafa render against the scratchpad's
-    // approximate column allocation, not the whole terminal.
-    const { rows: scratchRows, cols: scratchCols } = scratchImageSize(tr, tc);
-    let lines: string[] | null = null;
-    try { lines = await renderImagePreview(absPath, { cols: scratchCols, rows: scratchRows }); }
-    catch { lines = null; }
-    if (!lines || lines.length === 0) {
-      setDetailViewer(label, [C.muted('(image render failed — install chafa to preview)')]);
-      return;
-    }
-    setDetailViewer(label, lines);
-  };
-
-  /** Drop a text-file preview into the detail viewer — same shape the
-   *  preview pane uses for files (line-numbered, syntax-colored).
-   *  Used for non-image attachments and other read-only inspect flows. */
-  const setScratchFile = (a: Attachment): void => {
-    const lines: string[] = [];
-    if (a.kind === 'pdf' || a.kind === 'docx' || a.kind === 'xlsx') {
-      lines.push(C.muted(`  (${a.kind.toUpperCase()} \u2014 ${fmtBytes(a.sizeBytes)})`));
-      lines.push('');
-      lines.push(C.muted('  Body extracted at submit; preview not available here.'));
-      setDetailViewer(a.filename, lines);
-      return;
-    }
-    // Plain text / markdown — read + colorize like preview does.
-    let raw: string;
-    try { raw = readFileSync(a.sourcePath, 'utf-8'); }
-    catch { setDetailViewer(a.filename, [C.muted('  (unable to read)')]); return; }
-    // Attachment carries no ext field, so peel it off the filename
-    // (matching the regex tokenizer's view of the path).
-    const dot = a.filename.lastIndexOf('.');
-    const ext = dot > 0 ? a.filename.slice(dot) : '';
-    const body = raw.split('\n').slice(0, 200);
-    for (let i = 0; i < body.length; i++) {
-      const ln = C.muted(String(i + 1).padStart(4) + ' \u2502 ');
-      lines.push(`${ln}${colorLine(body[i]!, ext)}`);
-    }
-    const total = raw.split('\n').length;
-    if (total > body.length) {
-      lines.push(C.muted(`  ... +${total - body.length} more lines`));
-    }
-    setDetailViewer(a.filename, lines);
-  };
-
-  return { setScratchImage, setScratchFile };
-}