@wrongstack/tui 1.0.19 → 1.0.26

package/dist/reducers/composer.d.ts

@@ -1,11 +1,7 @@
 import type { Action } from '../app-action-type.js';
 import type { State } from '../app-state.js';
-declare const composerActionTypes: readonly ["brainPromptSet", "brainPromptClear", "pickerOpen", "pickerClose", "pickerSetMatches", "pickerMove", "toolStarted", "toolEnded", "toolStreamAppend", "toolStreamClear", "enqueue", "dequeueFirst", "queueClear", "queueDelete", "queueToggleRefine", "bashModeEnter", "bashModeExit", "slashPickerOpen", "slashPickerClose", "slashPickerMove", "historyPush", "historyUp", "historyDown", "setInputHistory", "clearInputHistory", "modelPickerOpen", "modelPickerClose", "modelPickerMove", "modelPickerPickProvider", "modelPickerBack", "modelPickerSearch", "modelPickerEffort", "modelPickerHint", "autonomyPickerOpen", "autonomyPickerClose", "autonomyPickerMove", "autonomyPickerHint", "themePickerOpen", "themePickerClose", "themePickerMove", "themePickerHint", "modePickerOpen", "modePickerClose", "modePickerMove", "modePickerHint", "skillPickerOpen", "skillPickerClose", "skillPickerMove", "skillPickerHint", "resourceMenuOpen", "resourceMenuClose", "resourceMenuMove", "resourceMenuHint", "resourceMenuFilter", "resourceMenuConfirm", "designPickerOpen", "designPickerClose", "designPickerMove", "designPickerStack", "promptPickerOpen", "promptPickerClose", "promptPickerMove", "promptPickerCategory", "resumePickerOpen", "resumePickerClose", "resumePickerMove", "resumePickerBusy", "resumePickerHint", "resumePickerError", "replaceHistory", "resumeLoadStart", "resumeLoadTick", "resumeStreamChunk", "resumeLoadAbort"];
-type ComposerAction = Extract<Action, {
-    type: (typeof composerActionTypes)[number];
-}>;
+import { type ComposerAction } from './composer-action-types.js';
 export declare function isComposerAction(action: Action): action is ComposerAction;
 /** Reduces composer tools, queues, history navigation, and session/model pickers. */
 export declare function reduceComposer(state: State, action: ComposerAction): State;
-export {};
 //# sourceMappingURL=composer.d.ts.map

package/dist/reducers/message-jump.d.ts

@@ -0,0 +1,16 @@
+import type { Action } from '../app-action-type.js';
+import type { State } from '../app-state.js';
+type MessageJumpAction = Extract<Action, {
+    type: 'messageJump';
+}>;
+/**
+ * Alt+↑ / Alt+↓: step through the user's own messages in the transcript.
+ * The first Alt+↑ lands on the newest one; further steps stop at either end.
+ * `seq` increments on every step so the view scrolls even when the target
+ * entry is the same one (the user may have scrolled away since).
+ */
+export declare function reduceMessageJump(state: State, action: MessageJumpAction): State;
+/** Drop the marked message (Esc, or any key that goes on to the composer). */
+export declare function clearMessageJump(state: State): State;
+export {};
+//# sourceMappingURL=message-jump.d.ts.map

package/dist/reducers/panel-pickers.d.ts

@@ -1,6 +1,6 @@
 import type { Action } from '../app-action-type.js';
 import type { State } from '../app-state.js';
-declare const panelPickerActionTypes: readonly ["statuslineOpen", "statuslineClose", "statuslineFieldMove", "statuslineFieldSet", "statuslineToggle", "statuslineSetLine", "statuslineMoveLine", "statuslineMoveOrder", "statuslineSetDensity", "statuslineToggleLine", "statuslineResetLayout", "statuslineFilter", "statuslineHint", "statuslineChipShow", "statuslineChipExpire", "statuslineVisibleChipsSync", "pluginPickerOpen", "pluginPickerClose", "pluginPickerMove", "pluginPickerSetItems", "pluginPickerBusy", "pluginPickerHint", "mcpPickerOpen", "mcpPickerClose", "mcpPickerMove", "mcpPickerSetItems", "mcpPickerBusy", "mcpPickerHint", "toolsPickerOpen", "toolsPickerClose", "toolsPickerMove", "toolsPickerSetItems", "toolsPickerToggle", "toolsPickerBusy", "toolsPickerHint", "toolsPickerFilter", "brainOpen", "brainClose", "brainMove", "brainRiskChange", "brainSetLog", "brainHint", "brainSettingsLoaded", "brainView", "brainRowMove", "brainBusy", "helpOpen", "helpClose", "helpMove", "helpFilter", "helpHint", "shadowOpen", "shadowClose", "shadowUpdate", "shadowHint", "subagentModelsOpen", "subagentModelsClose", "subagentModelsMove", "subagentModelsUpdate", "subagentModelsHint"];
+declare const panelPickerActionTypes: readonly ["statuslineOpen", "statuslineClose", "statuslineFieldMove", "statuslineFieldSet", "statuslineToggle", "statuslineSetLine", "statuslineMoveLine", "statuslineMoveOrder", "statuslineSetDensity", "statuslineToggleLine", "statuslineResetLayout", "statuslineFilter", "statuslineHint", "statuslineChipShow", "statuslineChipExpire", "statuslineVisibleChipsSync", "pluginPickerOpen", "pluginPickerClose", "pluginPickerMove", "pluginPickerSetItems", "pluginPickerBusy", "pluginPickerHint", "mcpPickerOpen", "mcpPickerClose", "mcpPickerMove", "mcpPickerSetItems", "mcpPickerBusy", "mcpPickerHint", "toolsPickerOpen", "toolsPickerClose", "toolsPickerMove", "toolsPickerSetItems", "toolsPickerToggle", "toolsPickerBusy", "toolsPickerHint", "toolsPickerFilter", "brainOpen", "brainClose", "brainMove", "brainRiskChange", "brainSetLog", "brainHint", "brainSettingsLoaded", "brainView", "brainRowMove", "brainBusy", "helpOpen", "helpClose", "helpScrollDetail", "helpMove", "helpFilter", "helpHint", "helpScrollDetail", "shadowOpen", "shadowClose", "shadowUpdate", "shadowHint", "subagentModelsOpen", "subagentModelsClose", "subagentModelsMove", "subagentModelsUpdate", "subagentModelsHint"];
 type PanelPickerAction = Extract<Action, {
     type: (typeof panelPickerActionTypes)[number];
 }>;

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

@@ -10,7 +10,7 @@ import type { State } from '../app-state.js';
  * {@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"];
+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", "checkpointFork", "forkRequestDone", "sessionRewound", "eternalStage", "goalSummary", "goalRunInit", "goalRunPhaseUpdate", "goalRunTaskActive", "goalRunTaskAgent", "goalRunTaskCompleted", "goalRunRunningPhases", "goalRunElapsed", "goalRunMonitorToggle", "goalRunReset", "sddBoardSnapshot", "toggleSddBoardMonitor", "sddBoardFocusNext", "sddBoardFocusPrev", "worktreeUpsert", "worktreeRemove", "toggleWorktreeMonitor"];
 type WorkspacePanelAction = Extract<Action, {
     type: (typeof workspacePanelActionTypes)[number];
 }>;

package/dist/resume-session-tree.d.ts

@@ -0,0 +1,8 @@
+import type { ResumeSessionEntry } from './app-state-core-types.js';
+/**
+ * Picker order for `/resume`: this worktree's sessions first, then each other
+ * worktree of the repository in the host's order. Inside each group, forks
+ * sit under their parent (see `orderSessionTree`) with a tree connector.
+ */
+export declare function orderResumeEntries(entries: readonly ResumeSessionEntry[]): ResumeSessionEntry[];
+//# sourceMappingURL=resume-session-tree.d.ts.map

package/dist/rewind-prompt.d.ts

@@ -0,0 +1,24 @@
+import type { RewoundConversation } from '@wrongstack/core/storage';
+import type { Action } from './app-action-type.js';
+/**
+ * After a rewind or a fork, hand the prompt that was taken back to the user
+ * to edit and send again.
+ *
+ * Both wipe the composer (a rewind clears the transcript view, a fork
+ * resumes another session), so the draft from before is passed in. A draft
+ * wins over the prompt: it is what the user was typing, and losing it to a
+ * rewind was a bug of its own. The prompt is then shown as a note instead.
+ */
+export declare function restoreRewoundPrompt(dispatch: (action: Action) => void, draftBefore: string, promptText: string | undefined): void;
+/**
+ * Redraw the transcript from the conversation a rewind or redo left. The
+ * rewind event clears the screen; without this the turns that survived the
+ * rewind vanished from view while the model still had them.
+ */
+export declare function showConversation(dispatch: (action: Action) => void, conversation: RewoundConversation): void;
+/** After a rewind: the surviving turns on screen, the prompt back in the composer. */
+export declare function showRewind(dispatch: (action: Action) => void, draftBefore: string, outcome: {
+    promptText?: string | undefined;
+    conversation?: RewoundConversation | undefined;
+}): void;
+//# sourceMappingURL=rewind-prompt.d.ts.map

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

@@ -34,6 +34,12 @@ export interface RunTuiOptions {
     banner?: boolean | undefined;
     /** Persists the input queue across crashes; if omitted, the queue is in-memory only. */
     queueStore?: QueueStore | undefined;
+    /**
+     * The queue store of another session. With it, `/resume` brings that
+     * session's queue along (the WebUI keeps its queue in the same file) and
+     * leaves the previous session's on disk.
+     */
+    queueStoreFor?: ((sessionId: string) => QueueStore | undefined) | undefined;
     /**
      * Called with the queue's display texts (head first) on EVERY queue change
      * — enqueue, /queue delete, /queue clear, dequeue-for-delivery. The CLI
@@ -118,6 +124,12 @@ export interface RunTuiOptions {
      *  the version chip when this is true, so users notice without having
      *  to read the stderr notice. */
     updateAvailable?: boolean | undefined;
+    /**
+     * The standalone executable's background update: called with the version
+     * once it is downloaded, verified and waiting to be swapped in when this
+     * session exits. The status bar's version chip then says so.
+     */
+    subscribeUpdateReady?: ((listener: (version: string) => void) => () => void) | undefined;
     /** Snapshot of keyed providers + their model lists for the `/model` picker. Async — the catalog fetch may need to hit disk/network. */
     getPickableProviders?: (() => Promise<import('./components/model-picker.js').ProviderOption[]>) | undefined;
     /** Apply a (provider, model) pair after the picker confirms. Returns an error string on failure. */
@@ -126,10 +138,9 @@ export interface RunTuiOptions {
     switchAutonomy?: ((mode: 'off' | 'suggest' | 'auto' | 'eternal' | 'eternal-parallel') => string | null) | undefined;
     /**
      * Model-specific maxContext (tokens), resolved by the CLI via the
-     * ModelsRegistry. When omitted, the TUI falls back to the provider
-     * family's baseline (e.g. anthropic = 200_000), which can be wrong
-     * for variants like the 1M-context Opus build. The status bar's
-     * context chip uses this for its progress denominator.
+     * ModelsRegistry. When omitted, the TUI falls back to the provider's
+     * reported window, which is 0 (unknown) until the catalog resolves one.
+     * The status bar's context chip uses this for its progress denominator.
      */
     effectiveMaxContext?: number | undefined;
     /** Absolute project root for goal.json loading. */
@@ -520,6 +531,14 @@ export interface RunTuiOptions {
      * from the session store and returns ResumeSessionEntry-shaped data.
      */
     listSessions?: ((limit?: number) => Promise<import('./app-state.js').ResumeSessionEntry[]>) | undefined;
+    /**
+     * Branch a session at a checkpoint (the conversation before that prompt)
+     * into a new session, leaving the original as it is. Returns the new id;
+     * the TUI then resumes it. The working tree is shared, not copied.
+     */
+    forkSession?: ((sessionId: string, checkpointPromptIndex: number) => Promise<{
+        id: string;
+    }>) | undefined;
     /**
      * Resume a session by id: load JSONL events, replay history entries,
      * rebuild agent context, and return hydrated entries for the TUI to
@@ -559,7 +578,7 @@ export interface RunTuiOptions {
         nextSteps?: string[] | undefined;
     } | null>) | undefined;
     getProjectPickerItems?: (() => Promise<import('./components/project-picker.js').ProjectPickerItem[]>) | undefined;
-    onProjectSelect?: ((key: string, kind: 'project' | 'action') => void) | undefined;
+    onProjectSelect?: ((key: string, kind: 'project' | 'action') => void | string | null | Promise<void | string | null>) | undefined;
     /**
      * Request the TUI to exit with a specific code. Used by the project picker
      * to trigger a clean exit before spawning a new wstack process in a different

package/dist/scroll-anchor.d.ts

@@ -59,6 +59,12 @@ export declare function anchorAtTopRow(geometry: ScrollGeometry, topRow: number)
  * bottom returns `null` (re-pin).
  */
 export declare function scrollAnchorBy(geometry: ScrollGeometry, current: ScrollAnchor | null, deltaUp: number): ScrollAnchor | null;
+/**
+ * Anchor that puts the start of render group `index` at the viewport top.
+ * Groups too close to the bottom to reach the top re-pin (`null`), which
+ * still shows them. Out-of-range indexes return `undefined` (no move).
+ */
+export declare function anchorForGroupIndex(geometry: ScrollGeometry, index: number): ScrollAnchor | null | undefined;
 /** Anchor for the very top of the transcript (or `null` when it all fits). */
 export declare function scrollAnchorToTop(geometry: ScrollGeometry): ScrollAnchor | null;
 /** Rows moved by one PageUp/PageDown press. */

package/dist/statusline-palette.d.ts

@@ -0,0 +1,4 @@
+import type { Theme } from './theme-types.js';
+/** Preserve the preset's five hues while keeping small status text at 4.5:1. */
+export declare function statuslineBackgrounds(palette: Theme): string[];
+//# sourceMappingURL=statusline-palette.d.ts.map

package/dist/submit-controller.d.ts

@@ -2,7 +2,7 @@ import { type InputBuilder } from '@wrongstack/core/agent';
 import type { Director } from '@wrongstack/core/coordination';
 import type { AttachmentStore, ContentBlock } from '@wrongstack/core/types';
 import type { Action, State } from './app-reducer.js';
-import { emptyMemoryContextMonitor } from './memory-context-monitor.js';
+import type { emptyMemoryContextMonitor } from './memory-context-monitor.js';
 import type { MutableCell } from './shared-types.js';
 import { type TokenPreviewStore } from './token-previews.js';
 import type { SubmitCapabilities } from './tui-host-capabilities.js';

package/dist/submit-slash-command.d.ts

@@ -0,0 +1,67 @@
+export declare function submitSlashCommand({ trimmed, sessionGenerationRef, attachments, tokenPreviewsRef, isAutomaticBugHuntReplay, dispatch, pushSubmittedHistory, clearDraft, slashRegistry, agent, refreshGoalSummary, onBugHuntStarted, mouseMode, nativeMouse, setNativeMouse, setMouseMode, getSettings, saveSettings, liveModel, setLiveModel, liveProvider, setLiveProvider, activeMaxContext, setActiveMaxContext, getYolo, yoloLive, setYoloLive, getAutonomy, autonomyLive, setAutonomyLive, getEternalEngine, runEternalLoopRef, getParallelEngine, runParallelLoopRef, getModeLabel, liveModeLabel, setLiveModeLabel, getToolsItems, setLiveToolCount, exit, onExit, builderRef, waitForIdleSettle, stateRef, runBlocks, liveDirector, clearTerminal, onClearHistory, setMemoryContextMonitor, tokenCounter, enhanceAbortRef, enhanceCancelledRef, enhanceOriginalRef, nextStepsAutoSubmitTimerRef, autoSubmitStreakRef, autoSubmitCapWarnedRef, autoSubmitLoopGuardRef, onAfterClear, }: {
+    trimmed: string;
+    sessionGenerationRef: import('./shared-types.js').MutableCell<number>;
+    attachments: import('@wrongstack/core/types').AttachmentStore;
+    tokenPreviewsRef: import('./shared-types.js').MutableCell<import('./token-previews.js').TokenPreviewStore>;
+    isAutomaticBugHuntReplay: boolean;
+    dispatch: (action: import('./app-action-type.js').Action) => void;
+    pushSubmittedHistory: () => void;
+    clearDraft: () => void;
+    slashRegistry: import('@wrongstack/core/registry').SlashCommandRegistry;
+    agent: import('@wrongstack/core/agent').Agent;
+    refreshGoalSummary: () => void;
+    onBugHuntStarted: (command: string, totalRounds?: number | undefined) => void;
+    mouseMode: boolean;
+    nativeMouse: boolean;
+    setNativeMouse: (value: boolean) => void;
+    setMouseMode: (value: boolean) => void;
+    getSettings: (() => import('./app-settings-type.js').Settings) | undefined;
+    saveSettings: ((settings: import('./app-settings-type.js').Settings) => string | Promise<string | null> | null) | undefined;
+    liveModel: string;
+    setLiveModel: (value: string) => void;
+    liveProvider: string;
+    setLiveProvider: (value: string) => void;
+    activeMaxContext: number | undefined;
+    setActiveMaxContext: (value: number) => void;
+    getYolo: (() => boolean) | undefined;
+    yoloLive: boolean;
+    setYoloLive: (value: boolean) => void;
+    getAutonomy: (() => 'off' | 'suggest' | 'auto' | 'eternal' | 'eternal-parallel') | undefined;
+    autonomyLive: 'off' | 'suggest' | 'auto' | 'eternal' | 'eternal-parallel';
+    setAutonomyLive: (value: 'off' | 'suggest' | 'auto' | 'eternal' | 'eternal-parallel') => void;
+    getEternalEngine: (() => unknown) | undefined;
+    runEternalLoopRef: import('./shared-types.js').MutableCell<() => Promise<void>>;
+    getParallelEngine: (() => unknown) | undefined;
+    runParallelLoopRef: import('./shared-types.js').MutableCell<() => Promise<void>>;
+    getModeLabel: (() => string) | undefined;
+    liveModeLabel: string | undefined;
+    setLiveModeLabel: (value: string) => void;
+    getToolsItems: (() => {
+        enabled: boolean;
+    }[]) | undefined;
+    setLiveToolCount: (value: number) => void;
+    exit: () => void;
+    onExit: (code: number) => void;
+    builderRef: import('./shared-types.js').MutableCell<import('@wrongstack/core/agent').InputBuilder | null>;
+    waitForIdleSettle: (isIdle: () => boolean, deadlineMs: number, opts?: {
+        maxPollMs?: number;
+    }) => Promise<boolean>;
+    stateRef: import('./shared-types.js').MutableCell<import('./app-state.js').State>;
+    runBlocks: (blocks: import('@wrongstack/core/types').ContentBlock[]) => Promise<void>;
+    liveDirector: () => import('@wrongstack/core/coordination').Director | null;
+    clearTerminal: (() => void) | undefined;
+    onClearHistory: import('./tui-host-capabilities.js').SubmitCapabilities['onClearHistory'];
+    setMemoryContextMonitor: (value: import('./memory-context-monitor.js').MemoryContextMonitorState) => void;
+    tokenCounter: import('@wrongstack/core/types').TokenCounter | undefined;
+    enhanceAbortRef: import('./shared-types.js').MutableCell<AbortController | null>;
+    enhanceCancelledRef: import('./shared-types.js').MutableCell<boolean>;
+    enhanceOriginalRef: import('./shared-types.js').MutableCell<string>;
+    nextStepsAutoSubmitTimerRef: import('./shared-types.js').MutableCell<NodeJS.Timeout | undefined>;
+    autoSubmitStreakRef: import('./shared-types.js').MutableCell<number>;
+    autoSubmitCapWarnedRef: import('./shared-types.js').MutableCell<boolean>;
+    autoSubmitLoopGuardRef: import('./shared-types.js').MutableCell<{
+        reset(): void;
+    }>;
+    onAfterClear: (() => void) | undefined;
+}): Promise<void>;
+//# sourceMappingURL=submit-slash-command.d.ts.map

package/dist/theme-utils.d.ts

@@ -60,7 +60,7 @@ export declare function resolveSyntaxColor(role: SyntaxRole, palette: Theme): st
 export declare function resolveSyntaxPalette(palette: Theme): SyntaxPalette;
 export declare function softColorWithTheme(color: string | undefined, currentTheme: Theme): string | undefined;
 /**
- * Mix two hex colors in linear-light sRGB. `weight` is the fraction of
+ * Mix two hex colors in encoded sRGB. `weight` is the fraction of
  * `colorA` (0..1) — at 0 the result is `colorB`, at 1 it is `colorA`. Used
  * by the sidebar's card tints to derive per-card "raised" surfaces from
  * the theme's accent + surface tokens, so each panel feels color-coded

package/dist/transcript-search.d.ts

@@ -0,0 +1,38 @@
+import type { HistoryEntry } from './history-entry.js';
+/** One match per entry: the first hit inside that entry's text. */
+export interface TranscriptMatch {
+    entryId: number;
+    /** The line containing the first hit, untrimmed. */
+    line: string;
+    /** Code-unit offset of the hit inside {@link line}. */
+    column: number;
+    /** Code-unit length of the hit. */
+    length: number;
+}
+export interface TranscriptSearchOptions {
+    /** Thinking cards are hidden unless model reasoning is shown. */
+    includeReasoning: boolean;
+}
+/** Per-entry text is capped so one huge tool result cannot stall a keystroke. */
+export declare const MAX_SEARCH_CHARS_PER_ENTRY = 200000;
+/** Matches in transcript order (oldest first), at most one per entry. */
+export declare function findTranscriptMatches(entries: readonly HistoryEntry[], query: string, options: TranscriptSearchOptions): TranscriptMatch[];
+/**
+ * Next selected entry after moving `delta` matches: -1 = older, +1 = newer.
+ * Wraps at both ends. A selection that is no longer a match (retention
+ * evicted it, or the query changed) restarts from the newest match.
+ */
+export declare function stepTranscriptMatch(matches: readonly TranscriptMatch[], selectedEntryId: number | null, delta: -1 | 1): number | null;
+/**
+ * Fit a match line into `width` columns, keeping the hit visible. Returns the
+ * three display segments; an ellipsis marks each trimmed side. Widths are
+ * counted in code units, which is exact for the ASCII-dominant transcript
+ * text and conservative (never overflowing) for wide glyphs after the
+ * caller's own display-width truncation.
+ */
+export declare function transcriptMatchSnippet(match: Pick<TranscriptMatch, 'line' | 'column' | 'length'>, width: number): {
+    before: string;
+    hit: string;
+    after: string;
+};
+//# sourceMappingURL=transcript-search.d.ts.map

package/dist/ui-contracts.d.ts

@@ -22,7 +22,7 @@ export declare const PILL_MIN_INNER_WIDTH = 22;
  * starts rendering per-row "metric" columns (latency, diff, elapsed, agent
  * count, relative time). Below this threshold the row keeps its identity
  * label only; the secondary metric is dropped to preserve the title.
- * Centralized so the F twins in `sidebar-panels-workspace.tsx` and
+ * Centralized so the F twins in `sidebar-panel-*.tsx` and
  * `sidebar-panels-task.tsx` stop hand-rolling the literal `24`.
  */
 export declare const METRIC_MIN_BODY_WIDTH = 24;
@@ -142,6 +142,7 @@ export interface HelpEntry {
     category: string;
     aliases?: string[] | undefined;
     argsHint?: string | undefined;
+    help?: string | undefined;
 }
 export interface McpPickerItem {
     name: string;

package/dist/use-app-controller.d.ts

@@ -0,0 +1,157 @@
+import type { Director } from '@wrongstack/core/coordination';
+import type { AppProps } from './app-props.js';
+import type { StatuslineItem } from './components/statusline-picker.js';
+export declare function useAppController(props: AppProps): {
+    pendingUserInput: import("./components/user-input-prompt.js").PendingUserInput | null;
+    runInterruptLadder: () => void;
+    props: AppProps;
+    state: import("./app-state.js").State;
+    dispatch: import("react").ActionDispatch<[action: import("./app-action-type.js").Action]>;
+    historyScrollRef: import("react").RefObject<import("./key-handler-context.js").HistoryScrollController | null>;
+    onScrollInfo: (info: {
+        scrolled: boolean;
+    }) => void;
+    onRequestOlderEntries: () => void;
+    activity: {
+        displayThinkingWord: string;
+        startedAt: number;
+        nowTick: number;
+        setNowTick: import("react").Dispatch<import("react").SetStateAction<number>>;
+        workingTimeMs: number;
+        fleetWorkingTimeMs: number;
+        processMemory: import("@wrongstack/core/utils").HeapSample;
+        cpuPercent: number | undefined;
+        cpuHistory: number[];
+        rssHistory: number[];
+        heapHistory: number[];
+        totalMem: number;
+        enhanceDots: number;
+        refreshGoalSummary: () => void;
+    };
+    environment: {
+        liveModel: string;
+        setLiveModel: (v: string) => void;
+        liveProvider: string;
+        setLiveProvider: (v: string) => void;
+        activeMaxContext: number | undefined;
+        setActiveMaxContext: (v: number | undefined) => void;
+        yoloLive: boolean;
+        setYoloLive: (v: boolean) => void;
+        autonomyLive: import("./hooks/use-statusline-state.js").AutonomyStage;
+        setAutonomyLive: (v: import("./hooks/use-statusline-state.js").AutonomyStage) => void;
+        liveModeLabel: string;
+        setLiveModeLabel: (v: string) => void;
+        hiddenItems: StatuslineItem[];
+        setHiddenItems: (v: StatuslineItem[]) => void;
+        lines: import("@wrongstack/core/statusline").StatuslineLines;
+        setLines: (v: import("@wrongstack/core/statusline").StatuslineLines) => void;
+        densities: import("@wrongstack/core/statusline").StatuslineDensities;
+        setDensities: (v: import("@wrongstack/core/statusline").StatuslineDensities) => void;
+        order: import("@wrongstack/core/statusline").StatuslineOrder;
+        setOrder: (v: import("@wrongstack/core/statusline").StatuslineOrder) => void;
+        sessionCount: number;
+        setSessionCount: (v: number) => void;
+        hiddenItemsRef: import("react").RefObject<StatuslineItem[]>;
+        memoryContextMonitor: import("./memory-context-monitor.js").MemoryContextMonitorState;
+        setMemoryContextMonitor: import("react").Dispatch<import("react").SetStateAction<import("./memory-context-monitor.js").MemoryContextMonitorState>>;
+        memoryRecordTotal: number | undefined;
+        memoryContextMonitorRef: import("react").RefObject<import("./memory-context-monitor.js").MemoryContextMonitorState>;
+        memoryRecordTotalRef: import("react").RefObject<number | undefined>;
+        activeMemoryInContext: number;
+        liveToolCount: number | undefined;
+        setLiveToolCount: import("react").Dispatch<import("react").SetStateAction<number | undefined>>;
+        indexState: {
+            ready: boolean;
+            indexing: boolean;
+            currentFile: number;
+            totalFiles: number;
+            lastError: string | null;
+            server: import("@wrongstack/tools").ProjectIndexServerConnectionState;
+            circuit: import("@wrongstack/tools").CircuitSnapshot;
+        };
+        breakerCountdown: import("@wrongstack/tools").BreakerCountdown | null;
+    };
+    statusbar: {
+        contextBreakdown: import("@wrongstack/core/utils").ContextBreakdown | undefined;
+        currentContextTokens: number;
+        contextWindow: {
+            used: number;
+            max: number;
+        } | undefined;
+        cacheStats: import("@wrongstack/core/types").CacheStats;
+        cacheCoverageTokens: number;
+        todos: {
+            pending: number;
+            inProgress: number;
+            completed: number;
+        };
+        fleetCounts: {
+            running: number;
+            idle: number;
+            pending: number;
+            completed: number;
+        } | undefined;
+        visibleSubagentCount: number;
+        hasVisibleFleetPanel: boolean;
+        entriesWithLeader: Record<string, import("./app-state-fleet.js").FleetEntry>;
+        planCounts: import("./hooks/use-statusbar-view-model.js").PlanCounts | null;
+        taskCounts: import("./hooks/use-statusbar-view-model.js").TaskCounts | null;
+        droppedTools: number;
+    };
+    mailbox: {
+        mailboxStatus: import("./components/status-bar-types.js").MailboxStatus;
+        mailboxPanelOpen: boolean;
+        setMailboxPanelOpen: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+        mailboxMessages: import("./components/mailbox-panel.js").MailboxMessageEntry[];
+        mailboxAgents: import("./components/mailbox-panel.js").MailboxAgentEntry[];
+    };
+    gitInfo: import("./git-info.js").GitInfo | null;
+    viewState: {
+        inputHint: string;
+        composerStatus: import("./components/composer-status-chip.js").ComposerStatus;
+        composerAnimationStyle: "breathe" | "cycle" | "dots" | "pulse" | "rainbow" | "static" | "wave";
+        inputHeight: number;
+        hideInput: boolean;
+        lowerFunctionPanelOpen: boolean;
+        functionPanel: number | null;
+        panelOwnsInput: boolean;
+    };
+    mouseMode: boolean;
+    termRows: number;
+    statusBarRows: number;
+    bottomRegionRef: import("react").RefObject<import("./ink.js").DOMElement | null>;
+    statusBarWrapRef: import("react").RefObject<import("./ink.js").DOMElement | null>;
+    belowStatusBarRef: import("react").RefObject<import("./ink.js").DOMElement | null>;
+    statusBarClickMapRef: import("react").RefObject<import("./key-handler-context.js").StatusBarClickMap | null>;
+    inspectOverlayHeaderRef: import("react").RefObject<import("./ink.js").DOMElement | null>;
+    stableOnKey: (input: string, key: import("./components/input.js").KeyEvent) => Promise<void>;
+    liveTodos: import("@wrongstack/core/agent").TodoItem[];
+    liveSettings: import("./app-settings-type.js").Settings | undefined;
+    liveAnimationStyle: "breathe" | "cycle" | "dots" | "pulse" | "rainbow" | "static" | "wave";
+    liveStatuslineMode: import("./settings-contracts.js").StatuslineMode;
+    projectName: string | undefined;
+    workingDirChip: string | undefined;
+    handleRewindTo: (checkpointIndex: number) => Promise<import("./hooks/use-session-rewind.js").RewindOutcome>;
+    activeCtrlRef: import("react").RefObject<AbortController | null>;
+    clearPendingConfirms: () => void;
+    liveDirector: () => Director | null;
+    dismissedEscAtRef: import("react").RefObject<number>;
+    enhanceOriginalRef: import("react").MutableRefObject<string>;
+    enhanceStartedAt: number | null;
+    enhanceDurationMs: number | null;
+    refineProviderId: string | null;
+    refineModel: string | null;
+    setEnhanceCountdown: import("react").Dispatch<import("react").SetStateAction<number | null>>;
+    enhanceCountdown: number | null;
+    nextStepsAutoSubmitCountdown: number | null;
+    nextStepsAutoSubmitLabel: string | null;
+    nextStepsAutoSubmitDeadlineMs: number | null;
+    setDraft: (buffer: string, cursor: number) => void;
+    focusedBoardId: string | null;
+    getCronJobs: () => Promise<import("./cron-slash.js").CronListResult>;
+    getLeaderTranscript: () => import("@wrongstack/core/coordination").AgentTimelineEntry[];
+    coordinatorRunning: boolean;
+    enhanceDelayMs: number;
+    layoutStore: import("./layout-store.js").LayoutStore;
+};
+//# sourceMappingURL=use-app-controller.d.ts.map