@wrongstack/tui 1.0.4 → 1.0.6

package/dist/input-validation/action-types.d.ts

@@ -1,4 +1,4 @@
 /** Known reducer action types — exact, compile-time checked allow-list. */
-export declare const ALLOWED_ACTION_TYPES: readonly ["addEntry", "archiveLoaded", "startArchiveLoad", "authBusy", "authCatalog", "authClose", "authConfirmEnd", "authConfirmStart", "authFormCancel", "authFormChange", "authFormStart", "authFilter", "authFlowDone", "authFlowLog", "authFlowStart", "authHint", "authMove", "authOpen", "authPromptChange", "authPromptEnd", "authPromptStart", "authProviders", "authView", "autonomyPickerClose", "autonomyPickerHint", "autonomyPickerMove", "autonomyPickerOpen", "brainBusy", "brainClose", "brainHint", "brainMove", "brainOpen", "brainPromptClear", "brainPromptSet", "brainRiskChange", "brainRowMove", "brainSetLog", "brainSettingsLoaded", "brainStatus", "brainView", "checkpointReceived", "clearConfirmClose", "clearConfirmOpen", "clearConfirmSetValue", "clearHistory", "clearInput", "clearInputHistory", "closeAllPanels", "collabBugFound", "collabEvalComplete", "sidebarScroll", "sidebarScrollReset", "toggleSidebarFocus", "skillPickerClose", "skillPickerHint", "skillPickerMove", "skillPickerOpen", "resourceMenuClose", "resourceMenuConfirm", "resourceMenuFilter", "resourceMenuHint", "resourceMenuMove", "resourceMenuOpen", "collabPlanEmitted", "collabSessionDone", "collabSubagentSpawned", "compactHistory", "confirmClearAll", "confirmClose", "confirmOpen", "continueConfirmClose", "continueConfirmOpen", "bugHuntContinueClose", "bugHuntContinueOpen", "bugHuntRunningClose", "bugHuntRunningOpen", "copiedNotice", "coordinatorEvent", "countdownEnded", "countdownTick", "debugStreamStats", "debugStreamStatsClear", "dequeueFirst", "designPickerClose", "designPickerMove", "designPickerOpen", "designPickerStack", "enhanceBusy", "enhanceClose", "enhanceOpen", "enhanceSet", "enqueue", "escConfirmClose", "escConfirmOpen", "fallbackOverlayClose", "fallbackOverlayMove", "fallbackOverlayOpen", "inspectOverlayClose", "inspectOverlayOpen", "inspectOverlayScroll", "eternalStage", "exitConfirmClose", "exitConfirmOpen", "fKeyPickerClose", "fKeyPickerMove", "fKeyPickerOpen", "fleetBatch", "fleetBudgetExtended", "fleetBudgetWarning", "fleetConcurrency", "fleetCost", "fleetCtxPct", "fleetDelta", "fleetDone", "fleetMessage", "fleetRemove", "fleetSeed", "fleetSpawn", "fleetStart", "fleetTool", "fleetToolEnd", "fleetToolStart", "fleetUsage", "goalRunElapsed", "goalRunInit", "goalRunMonitorToggle", "goalRunPhaseUpdate", "goalRunReset", "goalRunRunningPhases", "goalRunTaskActive", "goalSummary", "helpClose", "helpFilter", "helpHint", "helpMove", "helpOpen", "hint", "historyDown", "historyPush", "historyUp", "interrupt", "leaderCtxPct", "leaderIterEnd", "leaderIterStart", "leaderToolEnd", "leaderToolStart", "mcpPickerBusy", "mcpPickerClose", "mcpPickerHint", "mcpPickerMove", "mcpPickerOpen", "mcpPickerSetItems", "modePickerClose", "modePickerHint", "modePickerMove", "modePickerOpen", "modelPickerBack", "modelPickerClose", "modelPickerHint", "modelPickerMove", "modelPickerOpen", "modelPickerPickProvider", "modelPickerSearch", "pickerClose", "pickerMove", "pickerOpen", "pickerSetMatches", "pluginPickerBusy", "pluginPickerClose", "pluginPickerHint", "pluginPickerMove", "pluginPickerOpen", "pluginPickerSetItems", "projectPickerClose", "projectPickerFilter", "projectPickerHint", "projectPickerMove", "projectPickerOpen", "promptPickerCategory", "promptPickerClose", "promptPickerMove", "promptPickerOpen", "queueClear", "queueDelete", "queueToggleRefine", "refineCountdownClose", "refineCountdownOpen", "refineFailureClose", "refineFailureOpen", "replaceHistory", "autoProceedRelease", "bashModeEnter", "bashModeExit", "resumeLoadStart", "resumeLoadTick", "resumeStreamChunk", "resumeLoadAbort", "resetContextChip", "resetInterrupts", "resumePickerBusy", "resumePickerClose", "resumePickerError", "resumePickerHint", "resumePickerMove", "resumePickerOpen", "rewindOverlayClose", "rewindOverlayMove", "rewindOverlayOpen", "sddBoardSnapshot", "sddBoardFocusNext", "sddBoardFocusPrev", "sendModePickerClose", "sendModePickerMove", "sendModePickerOpen", "sessionResumeConfirmClear", "sessionResumeConfirmSet", "sessionRewound", "sessionsPanelBusy", "sessionsPanelMove", "sessionsPanelSet", "setBuffer", "setFleetChat", "setHistoryScrolled", "setInputHistory", "setViewportRows", "settingsClose", "settingsFieldMove", "settingsFieldSet", "settingsFilterSet", "settingsHint", "settingsOpen", "settingsThinkingEditCancel", "settingsThinkingEditChange", "settingsThinkingEditCommit", "settingsThinkingEditStart", "settingsWrongProxyUrlEditCancel", "settingsWrongProxyUrlEditChange", "settingsWrongProxyUrlEditCommit", "settingsWrongProxyUrlEditStart", "settingsValueChange", "settingsValueSet", "shadowClose", "shadowHint", "shadowOpen", "shadowUpdate", "shellCommandWarningClose", "shellCommandWarningOpen", "slashConfirmClose", "slashConfirmOpen", "slashPickerClose", "slashPickerMove", "slashPickerOpen", "status", "statuslineChipExpire", "statuslineChipShow", "statuslineClose", "statuslineFieldMove", "statuslineFieldSet", "statuslineFilter", "statuslineHint", "statuslineMoveLine", "statuslineOpen", "statuslineResetLayout", "statuslineSetDensity", "statuslineSetLine", "statuslineToggle", "statuslineToggleLine", "statuslineVisibleChipsSync", "steerConsume", "steerStart", "streamDelta", "streamReset", "themePickerClose", "themePickerHint", "themePickerMove", "themePickerOpen", "toggleAgentsMonitor", "toggleAuditPanel", "toggleContextPanel", "toggleConnectionsPanel", "toggleCoordinatorMonitor", "toggleCronMonitor", "toggleGoalKanbanPanel", "toggleGoalPanel", "toggleHelp", "toggleKanbanPanel", "toggleMonitor", "togglePlanPanel", "toggleProcessList", "toggleQueuePanel", "toggleSddBoardMonitor", "toggleSessionsPanel", "toggleTodosMonitor", "toggleWorktreeMonitor", "toolEnded", "toolStarted", "toolStreamAppend", "toolStreamClear", "toolResultViewSet", "topicCheckBusy", "toolsPickerBusy", "toolsPickerClose", "toolsPickerFilter", "toolsPickerHint", "toolsPickerMove", "toolsPickerOpen", "toolsPickerSetItems", "toolsPickerToggle", "worktreeRemove", "worktreeUpsert"];
+export declare const ALLOWED_ACTION_TYPES: readonly ["addEntry", "archiveLoaded", "startArchiveLoad", "authBusy", "authCatalog", "authClose", "authConfirmEnd", "authConfirmStart", "authFormCancel", "authFormChange", "authFormStart", "authFilter", "authFlowDone", "authFlowLog", "authFlowStart", "authHint", "authMove", "authOpen", "authPromptChange", "authPromptEnd", "authPromptStart", "authProviders", "authView", "autonomyPickerClose", "autonomyPickerHint", "autonomyPickerMove", "autonomyPickerOpen", "brainBusy", "brainClose", "brainHint", "brainMove", "brainOpen", "brainPromptClear", "brainPromptSet", "brainRiskChange", "brainRowMove", "brainSetLog", "brainSettingsLoaded", "brainStatus", "brainView", "checkpointReceived", "clearConfirmClose", "clearConfirmOpen", "clearConfirmSetValue", "clearHistory", "clearInput", "clearInputHistory", "closeAllPanels", "collabBugFound", "collabEvalComplete", "sidebarScroll", "sidebarScrollSet", "sidebarScrollReset", "toggleSidebarFocus", "skillPickerClose", "skillPickerHint", "skillPickerMove", "skillPickerOpen", "resourceMenuClose", "resourceMenuConfirm", "resourceMenuFilter", "resourceMenuHint", "resourceMenuMove", "resourceMenuOpen", "collabPlanEmitted", "collabSessionDone", "collabSubagentSpawned", "compactHistory", "confirmClearAll", "confirmClose", "confirmResolved", "confirmOpen", "continueConfirmClose", "continueConfirmOpen", "bugHuntContinueClose", "bugHuntContinueOpen", "bugHuntRunningClose", "bugHuntRunningOpen", "copiedNotice", "coordinatorEvent", "countdownEnded", "countdownTick", "debugStreamStats", "debugStreamStatsClear", "dequeueFirst", "designPickerClose", "designPickerMove", "designPickerOpen", "designPickerStack", "enhanceBusy", "enhanceClose", "enhanceOpen", "enhanceSet", "enqueue", "escConfirmClose", "escConfirmOpen", "fallbackOverlayClose", "fallbackOverlayMove", "fallbackOverlayOpen", "inspectOverlayClose", "inspectOverlayOpen", "inspectOverlayScroll", "eternalStage", "exitConfirmClose", "exitConfirmOpen", "fKeyPickerClose", "fKeyPickerMove", "fKeyPickerOpen", "fleetBatch", "fleetBudgetExtended", "fleetBudgetWarning", "fleetConcurrency", "fleetCost", "fleetCtxPct", "fleetDelta", "fleetDone", "fleetMessage", "fleetRemove", "fleetSeed", "fleetSpawn", "fleetStart", "fleetTool", "fleetToolEnd", "fleetToolStart", "fleetUsage", "goalRunElapsed", "goalRunInit", "goalRunMonitorToggle", "goalRunPhaseUpdate", "goalRunReset", "goalRunRunningPhases", "goalRunTaskActive", "goalSummary", "helpClose", "helpFilter", "helpHint", "helpMove", "helpOpen", "hint", "historyDown", "historyPush", "historyUp", "interrupt", "leaderCtxPct", "leaderIterEnd", "leaderIterStart", "leaderToolEnd", "leaderToolStart", "mcpPickerBusy", "mcpPickerClose", "mcpPickerHint", "mcpPickerMove", "mcpPickerOpen", "mcpPickerSetItems", "modePickerClose", "modePickerHint", "modePickerMove", "modePickerOpen", "modelPickerBack", "modelPickerClose", "modelPickerHint", "modelPickerMove", "modelPickerOpen", "modelPickerPickProvider", "modelPickerSearch", "pickerClose", "pickerMove", "pickerOpen", "pickerSetMatches", "pluginPickerBusy", "pluginPickerClose", "pluginPickerHint", "pluginPickerMove", "pluginPickerOpen", "pluginPickerSetItems", "projectPickerClose", "projectPickerFilter", "projectPickerHint", "projectPickerMove", "projectPickerOpen", "promptPickerCategory", "promptPickerClose", "promptPickerMove", "promptPickerOpen", "queueClear", "queueDelete", "queueToggleRefine", "refineCountdownClose", "refineCountdownOpen", "refineFailureClose", "refineFailureOpen", "replaceHistory", "autoProceedRelease", "bashModeEnter", "bashModeExit", "resumeLoadStart", "resumeLoadTick", "resumeStreamChunk", "resumeLoadAbort", "resetContextChip", "resetInterrupts", "resumePickerBusy", "resumePickerClose", "resumePickerError", "resumePickerHint", "resumePickerMove", "resumePickerOpen", "rewindOverlayClose", "rewindOverlayMove", "rewindOverlayOpen", "sddBoardSnapshot", "sddBoardFocusNext", "sddBoardFocusPrev", "sendModePickerClose", "sendModePickerMove", "sendModePickerOpen", "sessionResumeConfirmClear", "sessionResumeConfirmSet", "sessionRewound", "sessionsPanelBusy", "sessionsPanelMove", "sessionsPanelSet", "setBuffer", "setFleetChat", "setHistoryScrolled", "setInputHistory", "setViewportRows", "settingsClose", "settingsFieldMove", "settingsFieldSet", "settingsFilterSet", "settingsHint", "settingsOpen", "settingsThinkingEditCancel", "settingsThinkingEditChange", "settingsThinkingEditCommit", "settingsThinkingEditStart", "settingsWrongProxyUrlEditCancel", "settingsWrongProxyUrlEditChange", "settingsWrongProxyUrlEditCommit", "settingsWrongProxyUrlEditStart", "settingsValueChange", "settingsValueSet", "shadowClose", "shadowHint", "shadowOpen", "shadowUpdate", "shellCommandWarningClose", "shellCommandWarningOpen", "slashConfirmClose", "slashConfirmOpen", "slashPickerClose", "slashPickerMove", "slashPickerOpen", "status", "statuslineChipExpire", "statuslineChipShow", "statuslineClose", "statuslineFieldMove", "statuslineFieldSet", "statuslineFilter", "statuslineHint", "statuslineMoveLine", "statuslineOpen", "statuslineResetLayout", "statuslineSetDensity", "statuslineSetLine", "statuslineToggle", "statuslineToggleLine", "statuslineVisibleChipsSync", "steerConsume", "steerStart", "streamDelta", "streamReset", "themePickerClose", "themePickerHint", "themePickerMove", "themePickerOpen", "toggleAgentsMonitor", "toggleAuditPanel", "toggleContextPanel", "toggleConnectionsPanel", "toggleCoordinatorMonitor", "toggleCronMonitor", "toggleGoalKanbanPanel", "toggleGoalPanel", "toggleHelp", "toggleKanbanPanel", "toggleMonitor", "togglePlanPanel", "toggleProcessList", "toggleQueuePanel", "toggleSddBoardMonitor", "toggleSessionsPanel", "toggleTodosMonitor", "toggleWorktreeMonitor", "toolEnded", "toolStarted", "toolStreamAppend", "toolStreamClear", "toolResultViewSet", "topicCheckBusy", "toolsPickerBusy", "toolsPickerClose", "toolsPickerFilter", "toolsPickerHint", "toolsPickerMove", "toolsPickerOpen", "toolsPickerSetItems", "toolsPickerToggle", "worktreeRemove", "worktreeUpsert"];
 export type AllowedActionType = (typeof ALLOWED_ACTION_TYPES)[number];
 //# sourceMappingURL=action-types.d.ts.map

package/dist/key-handler-context.d.ts

@@ -0,0 +1,142 @@
+import type { Director } from '@wrongstack/core/coordination';
+import type { Dispatch, MutableRefObject, SetStateAction } from 'react';
+import type { Action } from './app-action-type.js';
+import type { AppProps } from './app-props.js';
+import type { State } from './app-state.js';
+import type { KeyEvent } from './components/input.js';
+import type { HistoryScrollController } from './components/scrollable-history.js';
+import type { StatusBarClickMap } from './components/status-bar-types.js';
+import type { StatuslineItem } from './components/statusline-picker.js';
+import type { DOMElement } from './ink.js';
+import type { PasteAccumState } from './paste-accumulator.js';
+export interface AppKeyHandlerOptions {
+    state: State;
+    dispatch: Dispatch<Action>;
+    historyScrollRef: MutableRefObject<HistoryScrollController | null>;
+    /** Resets the live-tail timeout after a user-driven history navigation. */
+    onHistoryScrollActivity?: (() => void) | undefined;
+    runInterruptLadder: () => void;
+    enhanceCancelledRef: MutableRefObject<boolean>;
+    enhanceAbortRef: MutableRefObject<AbortController | null>;
+    inputGateRef: MutableRefObject<boolean>;
+    lastEscAtRef: MutableRefObject<number>;
+    pasteAccumRef: MutableRefObject<PasteAccumState>;
+    pasteFlushTimerRef: MutableRefObject<ReturnType<typeof setTimeout> | null>;
+    commitPaste: (full: string) => Promise<void>;
+    tryPickerKey: (input: string, key: KeyEvent, isEnter: boolean) => boolean;
+    dismissedEscAtRef: MutableRefObject<number>;
+    streamingTextRef: MutableRefObject<string>;
+    confirmExitRef: MutableRefObject<boolean>;
+    activeCtrlRef: MutableRefObject<AbortController | null>;
+    clearPendingConfirms: () => void;
+    liveDirector: () => Director | null;
+    openProjectPicker: () => Promise<void>;
+    loadLiveSessions: () => Promise<void>;
+    openStatuslinePicker: (field?: number) => void;
+    statuslineHiddenItems: StatuslineItem[];
+    getSddRun: AppProps['getSddRun'];
+    onSddLifecycle: AppProps['onSddLifecycle'];
+    getSettings: AppProps['getSettings'];
+    saveSettings: AppProps['saveSettings'];
+    lastEnterAtRef: MutableRefObject<number>;
+    draftRef: MutableRefObject<{
+        buffer: string;
+        cursor: number;
+    }>;
+    setDraft: (buffer: string, cursor: number) => void;
+    /** Submits the composer. `overrideRaw` bypasses the buffer (bash mode
+     *  forwards its draft through the `!` shell path this way). */
+    submit: (overrideRaw?: string) => void;
+    mouseMode: boolean;
+    termRows: number;
+    terminalColumns: number;
+    terminalRows: number;
+    /** Width of the main column (terminal width minus sidebar). When > 0,
+     *  scrollbar hit-tests use this instead of terminalColumns so the scrollbar
+     *  track is correctly positioned to the left of the sidebar. */
+    mainColumnWidth: number;
+    /**
+     * Whether a full-width overlay owns the screen.
+     *
+     * Passed in rather than derived. The old proxy —
+     * `mainColumnWidth >= stdout.columns` — is true whenever the sidebar is
+     * ZERO wide, and `computeSidebarWidth` returns 0 for any terminal under
+     * `SIDEBAR_MIN_TERMINAL` (64 columns). So on a narrow terminal the flag was
+     * permanently true with nothing open, and the whole `if (!overlayOpen)`
+     * block below — wheel scrolling, scrollbar drag, drag-select, copy icons,
+     * every status-bar chip click, PageUp/PageDown — silently stopped working,
+     * along with Shift+Tab, `?` help, and (via `routeInputKey`) up/down input
+     * history. `app.tsx` already hands the real value to `useMouseTracking`.
+     */
+    overlayOpen: boolean;
+    /**
+     * Effective swarm-on-sidebar read: `panelPositions.fleet === 'sidebar'`
+     * OR the legacy `showAgentSwarmPanel === 'sidebar'` flag from
+     * `liveSettings`. The renderer at `app-view.tsx:897-899` reads
+     * ONLY the legacy `showAgentSwarmPanel` field (not the panel-
+     * position map) to decide whether to show the mission card; the
+     * scroll-clamp reservation must match that source or a config-only
+     * legacy 'sidebar' swarm mode (no recent picker open) will render
+     * the mission card but the clamp will under-reserve, hiding the
+     * bottom mission rows behind `RightSidebar`'s `overflowY="hidden"`
+     * viewport. The OR with `panelPositions.fleet` is directionally
+     * safe (over-reservation is harmless) and aligns with the field
+     * that gates whether the swarm twin is mounted. See
+     * {@link SidebarLayoutState.effectiveSwarmOnSidebar}. Threaded into
+     * `sidebarScroll` dispatches so the reducer's mission-queue
+     * reservation matches the actual render.
+     */
+    effectiveSwarmOnSidebar: boolean;
+    /**
+     * Approximate row count for routed sidebar twin panels mounted above
+     * `SidebarContent`. Subtracted from `viewportHeight` by the reducer's
+     * scroll clamp so the user can't scroll past the end into blank space.
+     * See {@link SidebarLayoutState.sidebarTwinRowCount}.
+     */
+    sidebarTwinRowCount: number;
+    statusBarWrapRef: MutableRefObject<DOMElement | null>;
+    belowStatusBarRef: MutableRefObject<DOMElement | null>;
+    /** Chip click map published by StatusBar on every render. */
+    statusBarClickMapRef: MutableRefObject<StatusBarClickMap | null>;
+    /** Actual rendered title row for inspect-modal Copy/Close hit-testing. */
+    inspectOverlayHeaderRef: MutableRefObject<DOMElement | null>;
+    openModelPicker: () => Promise<void>;
+    nextStepsAutoSubmitTimerRef: MutableRefObject<ReturnType<typeof setInterval> | undefined>;
+    nextStepsAutoSubmitSuggestionRef: MutableRefObject<string | null>;
+    nextStepsAutoSubmitLabel: string | null;
+    setNextStepsAutoSubmitCountdown: Dispatch<SetStateAction<number | null>>;
+    setNextStepsAutoSubmitLabel: Dispatch<SetStateAction<string | null>>;
+    cancelNextStepsCountdown: () => void;
+    pasteClipboardText: () => Promise<void>;
+    pasteClipboardImage: () => Promise<void>;
+    slashRegistry: AppProps['slashRegistry'];
+    agent: AppProps['agent'];
+    /**
+     * Called with the copied entry's id after a chat card's copy icon is clicked
+     * and its content was successfully written to the clipboard. Lets the host
+     * surface a transient "Copied" confirmation and flash that card's icon. Not
+     * called when the click missed or the write failed.
+     */
+    onHistoryCopy?: ((entryId: number) => void) | undefined;
+}
+/**
+ * The shared view of the key-handler wiring that the ordered route modules
+ * (decomposition Phase 3 — docs/decomposition-plan.md) receive. It is the
+ * factory's full `AppKeyHandlerOptions` plus the three values the factory
+ * derives once per session: the resolved stdout shape, the effective history
+ * width (terminal minus sidebar), and the `detach` helper that runs route
+ * promises without risking the process.
+ */
+export interface KeyRouteContext extends AppKeyHandlerOptions {
+    stdout: {
+        columns: number;
+        rows: number;
+    };
+    /** Effective width of the history area (terminal minus sidebar). */
+    historyWidth: number;
+    /** Runs a detached promise from a route; failures surface as error entries. */
+    detach: (work: Promise<unknown> | undefined, what: string) => void;
+}
+/** Re-exported for route modules that need the ref/callback shapes. */
+export type { Action, AppProps, Director, Dispatch, DOMElement, HistoryScrollController, MutableRefObject, PasteAccumState, SetStateAction, StatusBarClickMap, StatuslineItem, };
+//# sourceMappingURL=key-handler-context.d.ts.map

package/dist/key-routes/key-route-busy.d.ts

@@ -0,0 +1,23 @@
+import type { KeyEvent } from '../components/input.js';
+import type { KeyRouteContext } from '../key-handler-context.js';
+/**
+ * Busy-interrupt routes (Ctrl+C escalation + the busy-state interrupt
+ * router), moved verbatim from handleKey (decomposition Phase 3 —
+ * docs/decomposition-plan.md). Called by the orchestrator at their pinned
+ * positions: Ctrl+C before every modal/status guard, the busy router after
+ * the panel-close routes.
+ */
+/**
+ * Ctrl+C: THE unconditional escape hatch. Raw-mode terminals
+ * (ConPTY/Windows, and any tty in raw mode) deliver Ctrl+C as KEY DATA — no
+ * SIGINT is ever generated — so it must be routed into the escalation ladder
+ * from here. This check runs BEFORE every modal/status guard on purpose:
+ * Ctrl+C has to work precisely when everything else is wedged ('aborting'
+ * block, pending confirm panel, enhance overlay, …). The ladder itself is
+ * state-aware (cancels open pickers on the first press, aborts + kills the
+ * fleet, then exits on the second press, hard-exits on the third).
+ */
+export declare function routeCtrlCEscalation(ctx: KeyRouteContext, input: string, key: KeyEvent): boolean;
+/** Busy-state interrupts: abort confirmation ladder while streaming. */
+export declare function routeBusyInterrupt(ctx: KeyRouteContext, key: KeyEvent): boolean;
+//# sourceMappingURL=key-route-busy.d.ts.map

package/dist/key-routes/key-route-composer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Composer routes for the TUI key handler — decomposition Phase 3 route 6
+ * (final route; R5 picker was already a single delegation and needed no
+ * module — see docs/decomposition-plan.md execution log).
+ *
+ * Moved verbatim from `createAppKeyHandler`/`handleKey`
+ * (docs/decomposition-plan.md, Phase 3). `routeComposer` owns the
+ * empty-draft `?`/`!` shortcuts and the Enter pipeline (Shift+Enter
+ * newline, bash-mode run through `/dev`, the 50ms `\r\n` dedupe window,
+ * the intentionally-not-awaited detached submit). `routeComposerTail`
+ * owns the `routeInputKey` delegation (args bag built from ctx) and the
+ * Ctrl+P → PhaseMonitor / `/goal` alias.
+ *
+ * Call-order contract (pinned by tests/key-handler-replay-corpus.test.ts):
+ * routeComposer runs after the panel/picker routes; routeComposerTail runs
+ * after the pointer route, as the last content routes before handleKey ends.
+ */
+import type { KeyEvent } from '../components/input.js';
+import type { KeyRouteContext } from '../key-handler-context.js';
+/**
+ * Empty-draft `?`/`!` shortcuts plus the Enter pipeline. `isEnter` is
+ * derived in the orchestrator (the picker delegation consumes it too) and
+ * passed in. Returns true when the key was consumed.
+ */
+export declare function routeComposer(ctx: KeyRouteContext, input: string, key: KeyEvent, isEnter: boolean): boolean;
+/**
+ * The composer tail: the `routeInputKey` delegation (text insertion,
+ * cursor movement, input history, autocomplete — the router owns the
+ * full contract) followed by the Ctrl+P → PhaseMonitor / `/goal`
+ * alias. Returns true when the key was consumed.
+ */
+export declare function routeComposerTail(ctx: KeyRouteContext, input: string, key: KeyEvent): Promise<boolean>;
+//# sourceMappingURL=key-route-composer.d.ts.map

package/dist/key-routes/key-route-overlay.d.ts

@@ -0,0 +1,65 @@
+import type { KeyEvent } from '../components/input.js';
+import type { KeyRouteContext } from '../key-handler-context.js';
+/**
+ * Overlay/panel routes, moved verbatim from handleKey (decomposition Phase 3
+ * — docs/decomposition-plan.md). Membership delta recorded per D2: the
+ * chord (Ctrl+B/Y) and F-key panel toggles, and the SDD board drill-down
+ * ride with this route as the panel family (no dedicated slice among the
+ * approved route names).
+ *
+ * Orchestrator call order (pinned): routeModalOverlay → routeDoubleEsc →
+ * routeEscClosePanels → routeChordPanels → routeFKeyPanels → routeSddBoard →
+ * routeSettingsOverlay → routePanelEscapeRouter.
+ */
+/** Modal overlays with their own dedicated UI (confirmQueue, enhance,
+ * modelPicker, autonomyPicker, settingsPicker, rewindOverlay, helpOpen). */
+export declare function routeModalOverlay(ctx: KeyRouteContext, input: string, key: KeyEvent): boolean;
+/**
+ * Double-Esc clears the input buffer. When the user presses Esc twice
+ * within ESC_DOUBLE_PRESS_MS ms while the buffer is non-empty, clear it.
+ * This mirrors the behaviour of bash's Ctrl+C double-press clearing the
+ * line, adapted for Esc (no Ctrl needed).
+ */
+export declare function routeDoubleEsc(ctx: KeyRouteContext, key: KeyEvent): boolean;
+/**
+ * Esc closes the topmost panel BEFORE the busy-interrupt ladder. Pressing
+ * Esc with a monitor/panel open means "close this panel", not "abort the
+ * run and drop the queue" — even mid-stream. Panels whose own useInput owns
+ * Esc (kanban's inline prompt, worktree, goal kanban, phase monitor) are
+ * only CONSUMED here: the broadcast useInput model delivers the same
+ * keypress to their handler, which performs the close/cancel itself. Either
+ * way the double-Esc clear-input timer is disarmed — an Esc spent on a panel
+ * must not count toward the buffer-wipe double-press. Bash mode owns Esc
+ * too — but only after the panel router above, so an open monitor still
+ * closes first; exiting the shell composer must NOT read as a
+ * busy-interrupt.
+ */
+export declare function routeEscClosePanels(ctx: KeyRouteContext, key: KeyEvent): boolean;
+/**
+ * Monitor-overlay chords. Ctrl+F/G/T are the primary chords; F2/F3/F4 are
+ * terminal-safe aliases because some terminals intercept the chord before it
+ * reaches the app (notably Windows Terminal eats Ctrl+F for "Find"). Ctrl+B
+ * opens the SDD board, Ctrl+Y the project kanban (chord-only — no F-key
+ * alias; Ctrl+J is unsuitable because Ink 7 special-cases 0x0A as Enter).
+ */
+export declare function routeChordPanels(ctx: KeyRouteContext, input: string, key: KeyEvent): boolean;
+/**
+ * F-key / Ctrl-alias dispatch — table-driven via fKeyEntryFor. Entries with
+ * hostAction need host-side work; the rest dispatch directly via
+ * actionForFKeyPanel.
+ */
+export declare function routeFKeyPanels(ctx: KeyRouteContext, input: string, key: KeyEvent): boolean;
+/**
+ * SDD board drill-down. While the SDD board overlay is open, ←/→ drive the
+ * per-phase drill-down and `c`/`z`/`x` drive run lifecycle — clean
+ * worktrees / rollback commits / destroy. The lifecycle shortcuts MUST be
+ * gated on an empty input draft (and bash mode opts out entirely):
+ * otherwise typing literal letters in chat would silently fire destructive
+ * lifecycle ops.
+ */
+export declare function routeSddBoard(ctx: KeyRouteContext, input: string, key: KeyEvent): boolean;
+/** The settings overlay owns keys while open (routed before panels). */
+export declare function routeSettingsOverlay(ctx: KeyRouteContext, input: string, key: KeyEvent, isEnter: boolean): boolean;
+/** Panel Escape router (bottom-routed process list etc.). */
+export declare function routePanelEscapeRouter(ctx: KeyRouteContext, key: KeyEvent): boolean;
+//# sourceMappingURL=key-route-overlay.d.ts.map

package/dist/key-routes/key-route-paste.d.ts

@@ -0,0 +1,17 @@
+import type { KeyRouteContext } from '../key-handler-context.js';
+/**
+ * Bracketed-paste accumulation — moved verbatim from handleKey
+ * (decomposition Phase 3 — docs/decomposition-plan.md).
+ *
+ * Must run before the Enter/key handling below: a paste split across
+ * events can land a fragment that is exactly "\n", which would
+ * otherwise be read as Enter and submit mid-paste. The begin marker
+ * (`\x1b[200~`, or a bare [200~ when Ink ate the ESC) opens accumulation;
+ * we swallow every fragment until the end marker (`\x1b[201~` / [201~),
+ * then finalize the whole payload at once.
+ *
+ * Returns true when the key was consumed by the paste pipeline; false
+ * falls through to the later routes.
+ */
+export declare function routePastePipeline(ctx: KeyRouteContext, input: string): Promise<boolean>;
+//# sourceMappingURL=key-route-paste.d.ts.map

package/dist/key-routes/key-route-pointer.d.ts

@@ -0,0 +1,18 @@
+import type { KeyEvent } from '../components/input.js';
+import type { KeyRouteContext } from '../key-handler-context.js';
+/**
+ * Sidebar focus + scroll. Shift+Tab on an empty draft toggles keyboard focus
+ * between the chat input and the right sidebar. When sidebar-focused, ↑/↓
+ * scroll the sidebar content. Esc or typing unfocuses automatically.
+ */
+export declare function routeSidebarFocusScroll(ctx: KeyRouteContext, input: string, key: KeyEvent): boolean;
+/**
+ * Full mouse block: right-press copy fallback, wheel split (sidebar band vs
+ * history viewport), sidebar rail press/drag scrub, history scrollbar
+ * click/drag with inspect/copy/tool-control icons, drag-to-select,
+ * release-commits-copy, clickable status-bar chips (mouseMode-gated), and
+ * PageUp/PageDown/Ctrl+U/D history paging. Returns true when the event was
+ * consumed.
+ */
+export declare function routePointerEvents(ctx: KeyRouteContext, input: string, key: KeyEvent): Promise<boolean>;
+//# sourceMappingURL=key-route-pointer.d.ts.map

package/dist/overlay-key-router.d.ts

@@ -41,7 +41,9 @@ interface ModalOverlayKeyHost {
     readonly state: State;
     readonly enhanceCancelled: MutableCell<boolean>;
     readonly enhanceController: MutableCell<AbortController | null>;
+    readonly inspectPointerAction?: 'copy' | 'close' | null | undefined;
     dispatch(action: Action): void;
+    copyInspectOverlay?(): void;
 }
 /** Route the modal overlay ladder that has precedence over every composer key. */
 export declare function routeModalOverlayKey(host: ModalOverlayKeyHost, input: string, key: KeyEvent): boolean;

package/dist/reducers/dialogs.d.ts

@@ -1,6 +1,6 @@
 import type { Action } from '../app-action-type.js';
 import type { State } from '../app-state.js';
-declare const dialogActionTypes: readonly ["authOpen", "authClose", "authProviders", "authCatalog", "authView", "authMove", "authBusy", "authHint", "authFilter", "authFlowStart", "authFlowLog", "authFlowDone", "authPromptStart", "authPromptChange", "authPromptEnd", "authConfirmStart", "authConfirmEnd", "authFormStart", "authFormChange", "authFormCancel", "projectPickerOpen", "projectPickerClose", "projectPickerMove", "projectPickerFilter", "projectPickerHint", "fKeyPickerOpen", "fKeyPickerClose", "fKeyPickerMove", "confirmOpen", "confirmClose", "confirmClearAll", "shellCommandWarningOpen", "shellCommandWarningClose", "enhanceOpen", "enhanceClose", "enhanceSet", "enhanceBusy", "topicCheckBusy", "refineCountdownOpen", "refineCountdownClose", "refineFailureOpen", "refineFailureClose", "continueConfirmOpen", "continueConfirmClose", "bugHuntContinueOpen", "bugHuntContinueClose", "bugHuntRunningOpen", "bugHuntRunningClose", "clearConfirmOpen", "clearConfirmSetValue", "clearConfirmClose", "exitConfirmOpen", "exitConfirmClose", "slashConfirmOpen", "slashConfirmClose", "escConfirmOpen", "escConfirmClose", "fallbackOverlayOpen", "fallbackOverlayMove", "fallbackOverlayClose", "inspectOverlayOpen", "inspectOverlayClose", "inspectOverlayScroll", "sendModePickerOpen", "sendModePickerMove", "sendModePickerClose", "resetContextChip"];
+declare const dialogActionTypes: readonly ["authOpen", "authClose", "authProviders", "authCatalog", "authView", "authMove", "authBusy", "authHint", "authFilter", "authFlowStart", "authFlowLog", "authFlowDone", "authPromptStart", "authPromptChange", "authPromptEnd", "authConfirmStart", "authConfirmEnd", "authFormStart", "authFormChange", "authFormCancel", "projectPickerOpen", "projectPickerClose", "projectPickerMove", "projectPickerFilter", "projectPickerHint", "fKeyPickerOpen", "fKeyPickerClose", "fKeyPickerMove", "confirmOpen", "confirmClose", "confirmResolved", "confirmClearAll", "shellCommandWarningOpen", "shellCommandWarningClose", "enhanceOpen", "enhanceClose", "enhanceSet", "enhanceBusy", "topicCheckBusy", "refineCountdownOpen", "refineCountdownClose", "refineFailureOpen", "refineFailureClose", "continueConfirmOpen", "continueConfirmClose", "bugHuntContinueOpen", "bugHuntContinueClose", "bugHuntRunningOpen", "bugHuntRunningClose", "clearConfirmOpen", "clearConfirmSetValue", "clearConfirmClose", "exitConfirmOpen", "exitConfirmClose", "slashConfirmOpen", "slashConfirmClose", "escConfirmOpen", "escConfirmClose", "fallbackOverlayOpen", "fallbackOverlayMove", "fallbackOverlayClose", "inspectOverlayOpen", "inspectOverlayClose", "inspectOverlayScroll", "sendModePickerOpen", "sendModePickerMove", "sendModePickerClose", "resetContextChip"];
 type DialogAction = Extract<Action, {
     type: (typeof dialogActionTypes)[number];
 }>;

package/dist/reducers/workspace-panels.d.ts

@@ -1,6 +1,16 @@
 import type { Action } from '../app-action-type.js';
 import type { State } from '../app-state.js';
-declare const workspacePanelActionTypes: readonly ["toggleMonitor", "toggleAgentsMonitor", "toggleHelp", "toggleTodosMonitor", "toggleQueuePanel", "toggleProcessList", "toggleCronMonitor", "togglePlanPanel", "closeAllPanels", "toggleSidebarFocus", "sidebarScroll", "sidebarScrollReset", "toggleKanbanPanel", "toggleGoalPanel", "toggleGoalKanbanPanel", "toggleContextPanel", "toggleConnectionsPanel", "checkpointReceived", "rewindOverlayOpen", "rewindOverlayClose", "rewindOverlayMove", "sessionRewound", "eternalStage", "goalSummary", "goalRunInit", "goalRunPhaseUpdate", "goalRunTaskActive", "goalRunRunningPhases", "goalRunElapsed", "goalRunMonitorToggle", "goalRunReset", "sddBoardSnapshot", "toggleSddBoardMonitor", "sddBoardFocusNext", "sddBoardFocusPrev", "worktreeUpsert", "worktreeRemove", "toggleWorktreeMonitor"];
+/**
+ * Estimate the sidebar's maximum useful scroll offset — the exact number
+ * the `sidebarScroll` / `sidebarScrollSet` reducer clamp computes. Exported
+ * so the scrollbar thumb math (`components/sidebar-scrollbar.tsx`) and the
+ * wheel/press dispatchers in `app-key-handler.ts` share one source of truth
+ * instead of re-deriving the row budget (drift here would desynchronize
+ * the thumb from the real clamp). Mirrors the private
+ * {@link computeMaxSidebarScroll}; see its doc for the layout budget.
+ */
+export declare function estimateSidebarMaxScroll(state: State, viewportHeight?: number, effectiveSwarmOnSidebar?: boolean | undefined): number;
+declare const workspacePanelActionTypes: readonly ["toggleMonitor", "toggleAgentsMonitor", "toggleHelp", "toggleTodosMonitor", "toggleQueuePanel", "toggleProcessList", "toggleCronMonitor", "togglePlanPanel", "closeAllPanels", "toggleSidebarFocus", "sidebarScroll", "sidebarScrollSet", "sidebarScrollReset", "toggleKanbanPanel", "toggleGoalPanel", "toggleGoalKanbanPanel", "toggleContextPanel", "toggleConnectionsPanel", "checkpointReceived", "rewindOverlayOpen", "rewindOverlayClose", "rewindOverlayMove", "sessionRewound", "eternalStage", "goalSummary", "goalRunInit", "goalRunPhaseUpdate", "goalRunTaskActive", "goalRunRunningPhases", "goalRunElapsed", "goalRunMonitorToggle", "goalRunReset", "sddBoardSnapshot", "toggleSddBoardMonitor", "sddBoardFocusNext", "sddBoardFocusPrev", "worktreeUpsert", "worktreeRemove", "toggleWorktreeMonitor"];
 type WorkspacePanelAction = Extract<Action, {
     type: (typeof workspacePanelActionTypes)[number];
 }>;

package/dist/run-tui-exits.d.ts

@@ -0,0 +1,46 @@
+import type { TerminalLifecycle } from '@wrongstack/core/utils';
+import type { RunTuiOptions } from './run-tui-options.js';
+/** Everything runTui needs from the exit wiring after handing it over. */
+export interface ExitOrchestrator {
+    /** Resolves the run promise through the durable-close budget. */
+    settle: (code: number) => void;
+    /** Clean project-switch exit: unmount, then a 5s hard-exit fallback. */
+    requestExit: (code: number) => void;
+    /** Raw-stdin Ctrl+C watcher — pass to mountInkApp (armed after render). */
+    onRawCtrlC: (data: Buffer | string) => void;
+    /** Exit code last recorded by a signal/exit path (0 until then). */
+    getRunExitCode: () => number;
+    /** Records an exit code reported outside the orchestrator (App prop). */
+    recordExitCode: (code: number) => void;
+    /** Signal handlers unmount through this — set after mountInkApp returns. */
+    setInkInstance: (instance: {
+        unmount: () => void;
+    }) => void;
+    /** Called by runTui's executor: wires the deferred run promise resolve. */
+    attachResolve: (resolve: (code: number) => void) => void;
+    /** The render try flips this when the alternate buffer is entered. */
+    markAlternateScreenActive: () => void;
+}
+export interface ExitOrchestratorDeps {
+    opts: RunTuiOptions;
+    stdout: NodeJS.WriteStream;
+    inkStdin: NodeJS.ReadStream;
+    lifecycle: TerminalLifecycle;
+    stopTitle: () => void;
+    /** No-op-when-null wrapper over runTui's trace-tee restore handle. */
+    restoreTrace: () => void;
+}
+/**
+ * Single owner for the six exit paths through idempotent cleanup — moved
+ * verbatim from runTui() (decomposition Phase 1 R4, docs/decomposition-plan.md):
+ * natural settle, SIGTERM/SIGHUP/SIGBREAK, SIGINT rapid-press, the raw-stdin
+ * Ctrl+C watcher, the process 'exit' listener, and requestExit. Builds on
+ * createDurableTeardown (salvage + bounded close on every path) and composes
+ * setupTuiSession for the client registration lifecycle.
+ *
+ * Ownership transferred from runTui: the `cleaned` and alternate-screen flags,
+ * the client registration handle, the ink instance reference, and the deferred
+ * resolve (attachResolve from the run promise's executor).
+ */
+export declare function createExitOrchestrator(deps: ExitOrchestratorDeps): ExitOrchestrator;
+//# sourceMappingURL=run-tui-exits.d.ts.map

package/dist/run-tui-launch.d.ts

@@ -0,0 +1,23 @@
+import { detectTerminal } from '@wrongstack/core/utils';
+import type { RunTuiOptions } from './run-tui-options.js';
+/** Capability profile + pointer-mode decision, resolved before Ink mounts. */
+export interface TuiLaunchPlan {
+    capability: ReturnType<typeof detectTerminal>;
+    mouseEnabled: boolean;
+}
+/**
+ * Everything that must be decided before Ink takes over the screen — moved
+ * verbatim from runTui() (decomposition Phase 1 R1, docs/decomposition-plan.md):
+ * the interactive-TTY guard, the one-time capability probe, the pointer-mode
+ * opt-in, and the terminal-silence call.
+ *
+ * On a non-TTY invocation this writes the user-facing explanation and returns
+ * `{ ok: false, exitCode: 2 }`; runTui() returns that code untouched.
+ */
+export declare function resolveTuiLaunchPlan(opts: RunTuiOptions): {
+    ok: false;
+    exitCode: number;
+} | ({
+    ok: true;
+} & TuiLaunchPlan);
+//# sourceMappingURL=run-tui-launch.d.ts.map

package/dist/run-tui-mount.d.ts

@@ -0,0 +1,28 @@
+import type React from 'react';
+/** Ink mount handle: the instance signal handlers unmount, plus the resize unsubscription. */
+export interface MountInkAppResult {
+    instance: {
+        unmount: () => void;
+        waitUntilExit(): Promise<unknown>;
+    };
+    detachResize: () => void;
+}
+/**
+ * Ink mount — moved verbatim from runTui() (decomposition Phase 1 R3,
+ * docs/decomposition-plan.md): render() with exitOnCtrlC disabled and fps
+ * bounding, the raw-Ctrl+C stdin watcher arming (only AFTER Ink owns stdin —
+ * attaching earlier would flip the stream into flowing mode and drop
+ * boot-time keystrokes), and the resize erase handler.
+ *
+ * Any mount failure is reported through onStartupFailure and returns null;
+ * runTui then returns without wiring waitUntilExit — same as the original
+ * catch-and-return.
+ */
+export declare function mountInkApp(deps: {
+    appElement: React.ReactElement;
+    inkStdin: NodeJS.ReadStream;
+    stdout: NodeJS.WriteStream;
+    onRawCtrlC: (data: Buffer | string) => void;
+    onStartupFailure: (err: unknown) => void;
+}): MountInkAppResult | null;
+//# sourceMappingURL=run-tui-mount.d.ts.map

package/dist/run-tui-session.d.ts

@@ -0,0 +1,13 @@
+import { createRunTuiClientRegistration } from './run-tui-client-registration.js';
+import type { RunTuiOptions } from './run-tui-options.js';
+/**
+ * Session/client bootstrap — moved verbatim from runTui() (decomposition
+ * Phase 1 R2, docs/decomposition-plan.md): registers this TUI client with
+ * the shared registry, heartbeats, and telemetry bridges, returning the
+ * handle whose unregister() every exit path calls.
+ *
+ * `isCleaned` backs the registry's heartbeat/sync guards; it must be wired
+ * to runTui's `cleaned` flag so registration activity stops on cleanup.
+ */
+export declare function setupTuiSession(opts: RunTuiOptions, isCleaned: () => boolean): ReturnType<typeof createRunTuiClientRegistration>;
+//# sourceMappingURL=run-tui-session.d.ts.map

package/dist/run-tui.d.ts

@@ -1,7 +1,6 @@
 import type { RunTuiOptions } from './run-tui-options.js';
-import { silenceTerminal, unsilenceTerminal } from './terminal-silence.js';
 export type { AutonomyStage } from '@wrongstack/core/types';
 export type { RunTuiOptions } from './run-tui-options.js';
-export { silenceTerminal, unsilenceTerminal };
+export { silenceTerminal, unsilenceTerminal } from './terminal-silence.js';
 export declare function runTui(opts: RunTuiOptions): Promise<number>;
 //# sourceMappingURL=run-tui.d.ts.map

package/dist/sidebar-sizing.d.ts

@@ -21,7 +21,8 @@ import type { PanelId } from './ui-contracts.js';
 /**
  * Natural-height budget for each routed sidebar panel at the minimum
  * 16-column content width. Worklist panels reserve their maximum item count
- * × the bounded wrap ceiling; connections reserve two rows per service.
+ * × the bounded wrap ceiling; connections reserve a summary block (counts
+ * chips + health meter) plus one row per service.
  */
 export declare const SIDEBAR_TWIN_HEIGHT_BY_PANEL: Readonly<Record<PanelId, number>>;
 /**

package/dist/ui-contracts.d.ts

@@ -88,6 +88,21 @@ export declare const DEFAULT_PANEL_POSITIONS: PanelPositionMap;
  * rather than re-implementing the mapping to avoid divergent defaults.
  */
 export declare function coercePanelPositionMap(v: Partial<Record<PanelId, PanelPosition>> | undefined): PanelPositionMap;
+/**
+ * True when the right sidebar is "pinned on": at least one F-key panel is
+ * routed to the sidebar slot (per {@link coercePanelPositionMap}-coerced
+ * positions), or the legacy tri-state agent-swarm mode is 'sidebar' (which
+ * mounts the AGENT SWARM + MISSIONS cards on the rail). While pinned, the
+ * master `showSidebar` switch must not resolve to off — a routed panel's
+ * only home is the sidebar, so hiding the rail would orphan it.
+ *
+ * Lives beside {@link coercePanelPositionMap} because every guard site (the
+ * settings picker, the settings reducer, the /lite and /settings slash
+ * commands, and the layout resolver) already depends on this module, and
+ * routing it through app-ui-state.ts would close a type-inclusive import
+ * cycle back into the reducer chain.
+ */
+export declare function hasPanelRoutedToSidebar(panelPositions: Partial<Record<PanelId, 'bottom' | 'sidebar'>> | undefined, legacySwarmOnSidebar?: boolean | undefined): boolean;
 export interface AgentTranscriptReader {
     getTranscript(subagentId: string, limit?: number): AgentTimelineEntry[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrongstack/tui",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "license": "MIT",
   "description": "WrongStack terminal UI: Ink-based interactive renderer with history, pickers, and slash menus.",
   "repository": {
@@ -26,12 +26,12 @@
     "!dist/**/*.map"
   ],
   "dependencies": {
-    "@wrongstack/core": "1.0.4",
-    "@wrongstack/kanban": "1.0.4",
-    "@wrongstack/runtime": "1.0.4",
-    "@wrongstack/sage": "1.0.4",
-    "@wrongstack/sdd": "1.0.4",
-    "@wrongstack/tools": "1.0.4",
+    "@wrongstack/core": "1.0.6",
+    "@wrongstack/kanban": "1.0.6",
+    "@wrongstack/runtime": "1.0.6",
+    "@wrongstack/sage": "1.0.6",
+    "@wrongstack/sdd": "1.0.6",
+    "@wrongstack/tools": "1.0.6",
     "ink": "7.1.1",
     "react": "^19.2.8",
     "string-width": "8.2.2",