@wrongstack/tui 1.0.24 → 1.0.27

package/dist/ink.d.ts

@@ -11,7 +11,7 @@ type BoxOwnProps = Omit<ComponentProps<typeof InkBox>, 'ref' | 'borderColor' | '
 export type { DOMElement, Key } from 'ink';
 export { measureElement, Static, useAnimation, useApp, useInput, useStdin, useStdout, } from 'ink';
 /** Ink `Text` with named colors resolved against the active theme. */
-export declare function Text({ color, backgroundColor, ...rest }: TextOwnProps): ReactElement;
+export declare function Text({ color, backgroundColor, children, ...rest }: TextOwnProps): ReactElement;
 /**
  * Ink `Box` with named border/background colors resolved against the theme. Forwards
  * `ref` so `measureElement` (used by the scrollable history) keeps working.

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", "sidebarScrollSet", "sidebarScrollReset", "toggleSidebarFocus", "skillMentionResults", "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", "goalRunTaskAgent", "goalRunTaskCompleted", "goalSummary", "helpClose", "helpFilter", "helpHint", "helpMove", "helpOpen", "helpScrollDetail", "hint", "historyDown", "historyPush", "historyUp", "interrupt", "leaderCtxPct", "leaderIterEnd", "leaderIterStart", "leaderToolEnd", "leaderToolStart", "mcpPickerBusy", "mcpPickerClose", "mcpPickerHint", "mcpPickerMove", "mcpPickerOpen", "mcpPickerSetItems", "modePickerClose", "modePickerHint", "modePickerMove", "modePickerOpen", "modelPickerBack", "modelPickerClose", "modelPickerEffort", "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", "statuslineMoveOrder", "statuslineOpen", "statuslineResetLayout", "statuslineSetDensity", "statuslineSetLine", "statuslineToggle", "statuslineToggleLine", "statuslineVisibleChipsSync", "subagentModelsClose", "subagentModelsHint", "subagentModelsMove", "subagentModelsOpen", "subagentModelsUpdate", "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", "skillMentionResults", "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", "chatSearchClose", "chatSearchOpen", "chatSearchSetQuery", "chatSearchStep", "messageJump", "messageJumpClear", "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", "goalRunTaskAgent", "goalRunTaskCompleted", "goalSummary", "helpClose", "helpFilter", "helpHint", "helpMove", "helpOpen", "helpScrollDetail", "hint", "historyDown", "historyPush", "historyUp", "interrupt", "leaderCtxPct", "leaderIterEnd", "leaderIterStart", "leaderToolEnd", "leaderToolStart", "mcpPickerBusy", "mcpPickerClose", "mcpPickerHint", "mcpPickerMove", "mcpPickerOpen", "mcpPickerSetItems", "modePickerClose", "modePickerHint", "modePickerMove", "modePickerOpen", "modelPickerBack", "modelPickerClose", "modelPickerEffort", "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", "checkpointFork", "forkRequestDone", "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", "statuslineMoveOrder", "statuslineOpen", "statuslineResetLayout", "statuslineSetDensity", "statuslineSetLine", "statuslineToggle", "statuslineToggleLine", "statuslineVisibleChipsSync", "subagentModelsClose", "subagentModelsHint", "subagentModelsMove", "subagentModelsOpen", "subagentModelsUpdate", "steerConsume", "steerStart", "streamDelta", "streamReset", "themePickerClose", "themePickerHint", "themePickerFilter", "themePickerFilterMode", "themePickerPreview", "themePickerMove", "themePickerOpen", "themePickerUndo", "themePickerSwapPrevious", "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/input-validation/limits.d.ts

@@ -24,4 +24,6 @@ export declare const MAX_PASTE_FRAGMENT_CHARS = 100000;
 export declare const MAX_HOST_STRING_FIELD = 500;
 /** Maximum entries in a picker matches list. */
 export declare const MAX_PICKER_MATCHES = 500;
+/** Transcript search query cap (Alt+F / `/chat-search`). */
+export declare const MAX_CHAT_SEARCH_QUERY_CHARS = 1000;
 //# sourceMappingURL=limits.d.ts.map

package/dist/input-validation-display.d.ts

@@ -0,0 +1,9 @@
+import type { ValidationResult } from './input-validation/result.js';
+export declare function validateDisplayAction(action: {
+    type: string;
+    [key: string]: unknown;
+}, type: string, normalized: string, payload: {
+    type: string;
+    [key: string]: unknown;
+}): ValidationResult<Record<string, unknown>>;
+//# sourceMappingURL=input-validation-display.d.ts.map

package/dist/input-validation.d.ts

@@ -1,55 +1,3 @@
-/**
- * Central input validation for the TUI.
- *
- * EVERY external data source that crosses a trust boundary passes through
- * this module. Uses an **allow-list** approach: define the exact allowed
- * shape, types, ranges, and formats for each input; reject everything else.
- *
- * ── Trust boundaries ─────────────────────────────────────────────────
- *
- *   Boundary          | Source              | Validator
- *   ------------------|---------------------|--------------------------
- *   stdin             | terminal emulator   | validateStdinFragment()
- *   paste             | bracketed-paste     | validatePasteContent()
- *   AppProps          | CLI host            | validateAppProps()
- *   Reducer Action    | handleKey dispatch  | validateAction()
- *   Host callbacks    | CLI/plugin return   | validateCallbackReturn()
- *   Mouse events      | SGR protocol        | validateMouseEvent()
- *   Fleet telemetry   | Director/FleetBus   | validateFleetEntry()
- *   Restore data      | session JSONL       | validateRestoreEntry()
- *
- * ── Rejection over coercion ──────────────────────────────────────────
- *
- * This module **rejects** invalid input rather than coercing it, for
- * three reasons:
- *
- * 1. **Coercion masks injection.** Trimming whitespace from a string
- *    that contains an ANSI escape sequence leaves the sequence intact.
- * 2. **Semantic gap.** Coercing a value (e.g. clamping a PID to a valid
- *    range) creates a gap between what was validated and what the
- *    application actually uses — a future code path may use the raw
- *    value, not the clamped one.
- * 3. **Predictable failure.** Silent data transformation makes security
- *    debugging harder — rejection produces a clear error at the point
- *    of violation; coercion produces subtly wrong behavior downstream.
- *
- * The single exception is **normalization before comparison**: trimming
- * whitespace from an enum label before comparing it to the allow-list
- * prevents trivial bypasses (e.g. `"  off  "` vs `"off"`). This is
- * NOT the same as coercing the input — the normalized comparison only
- * determines allow/deny; the caller receives the original value.
- *
- * ── Conventions ──────────────────────────────────────────────────────
- *
- * - Every `validate*` function returns `ValidationResult<T>`:
- *     `{ valid: true; value: T }` — the validated, ready-to-use value
- *     `{ valid: false; error: string }` — a specific, actionable message
- * - Every error message follows the pattern:
- *     `"{path}": {what went wrong} ({detail}).`
- * - Size limits are defined as module-level constants with doc comments.
- * - Enum/union allow-lists are defined as `const` arrays and kept in
- *   ONE place so the allowed set is auditable.
- */
 import type { ValidationResult } from './input-validation/result.js';
 export { ALLOWED_ACTION_TYPES } from './input-validation/action-types.js';
 export { ALLOWED_ENTRY_KINDS, ALLOWED_FLEET_STATUSES, ALLOWED_KEY_EVENT_FIELDS, ALLOWED_MOUSE_BUTTONS, ALLOWED_MOUSE_KINDS, TEXT_BEARING_ENTRY_KINDS, } from './input-validation/allow-lists.js';

package/dist/key-routes/key-route-background-strip.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Background strip keys (Alt+B). While the strip is focused, ←/→ pick a chip,
+ * Enter shows or hides its output, `x` asks to stop a background shell and
+ * `y` (or Enter) confirms, Esc or Alt+B leaves. Typing text leaves the strip
+ * and goes to the composer, as the sidebar focus does. Scrolling, function
+ * keys and Ctrl+C keep their normal routes.
+ */
+import type { KeyEvent } from '../components/input.js';
+/**
+ * Returns true when the key was consumed. `stop` ends a background shell by
+ * PID; it is the process registry's kill in the TUI.
+ */
+export declare function routeBackgroundStrip(input: string, key: KeyEvent, stop: (pid: number) => void): boolean;
+//# sourceMappingURL=key-route-background-strip.d.ts.map

package/dist/key-routes/key-route-chat-search.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Transcript search bar keys (Alt+F / `/chat-search`).
+ *
+ * While the bar is open it owns text entry: typing edits the query and never
+ * reaches the composer draft. Scrolling (wheel, mouse, PgUp/PgDn), function
+ * keys and Ctrl+C keep their normal routes, so the user can still page
+ * around the transcript or open a panel with the bar visible.
+ */
+import type { KeyEvent } from '../components/input.js';
+import type { KeyRouteContext } from '../key-handler-context.js';
+/** Thinking cards are only searchable while they are shown. */
+export declare function chatSearchIncludesReasoning(ctx: Pick<KeyRouteContext, 'getSettings'>): boolean;
+/** Returns true when the key was consumed by the search bar (or opened it). */
+export declare function routeChatSearch(ctx: KeyRouteContext, input: string, key: KeyEvent): boolean;
+/**
+ * Alt+↑ / Alt+↓: jump to the previous / next message the user sent.
+ *
+ * The marked message then takes one key: Enter on an empty composer opens
+ * the rewind timeline at that message's checkpoint (Enter rewinds, `f`
+ * forks), Esc lets go of it. Any other key lets go of it too and does its
+ * usual job, so a mark left behind never captures a later Enter.
+ */
+export declare function routeMessageJump(ctx: KeyRouteContext, _input: string, key: KeyEvent): boolean;
+//# sourceMappingURL=key-route-chat-search.d.ts.map

package/dist/layout-store.d.ts

@@ -72,8 +72,8 @@ export declare class LayoutStore {
      * Remove entries no longer in the active set (after history retention).
      */
     retain(entryIds: Set<number>): void;
-    /** Reset all in-memory state (on /clear). */
-    clear(): void;
+    /** Reset all in-memory state (on /clear) and persist the empty snapshot. */
+    clear(): Promise<void>;
     /**
      * Load layout data from disk. Returns the number of entries restored, or 0
      * when no data exists or the version has changed (caller should regenerate).

package/dist/memory-slash-render.d.ts

@@ -1,4 +1,4 @@
-import type { MemoryEntry, MemoryScope, MemoryType, MemoryPriority } from '@wrongstack/core/types';
+import type { MemoryEntry, MemoryPriority, MemoryScope, MemoryType } from '@wrongstack/core/types';
 export interface SageLike {
     id: string;
     kind: string;

package/dist/message-checkpoint.d.ts

@@ -0,0 +1,19 @@
+import type { HistoryEntry } from './history-entry.js';
+interface CheckpointLike {
+    promptIndex: number;
+    promptPreview: string;
+}
+/**
+ * The position in `checkpoints` of the checkpoint the user message
+ * `entryId` was sent under, or `undefined` when none can be told.
+ *
+ * Checkpoints carry only an 80-character preview of the prompt the agent
+ * received, so messages and checkpoints are paired in order by the start of
+ * their text. A message whose screen text differs from what was sent (a
+ * pasted block shows as a placeholder) matches nothing; then, when every
+ * message has a checkpoint, the n-th message is paired with the n-th.
+ * Steering notes (`↯ …`) are folded into a running turn and have none.
+ */
+export declare function checkpointForMessage(entries: readonly HistoryEntry[], checkpoints: readonly CheckpointLike[], entryId: number): number | undefined;
+export {};
+//# sourceMappingURL=message-checkpoint.d.ts.map

package/dist/motion.d.ts

@@ -0,0 +1,16 @@
+export declare function reducedMotionFromEnv(env?: NodeJS.ProcessEnv): boolean;
+/** The style actually rendered: the environment override wins over settings. */
+export declare function effectiveAnimationStyle<S extends string>(style: S): S | 'static';
+/** Whether the animated terminal title may run. */
+export declare function titleAnimationAllowed(setting: boolean | undefined): boolean;
+/** Styles whose label colors move and therefore need the fast color clock. */
+export declare function animatesColor(style: string): boolean;
+/**
+ * Publish the effective style so leaves without a style prop (tool stream
+ * spinner, composer activity icon) follow it.
+ */
+export declare function setMotionStatic(value: boolean): void;
+export declare function isMotionStatic(): boolean;
+/** True while decorative motion is off. */
+export declare function useMotionStatic(): boolean;
+//# sourceMappingURL=motion.d.ts.map

package/dist/reducers/chat-search.d.ts

@@ -0,0 +1,11 @@
+import type { Action } from '../app-action-type.js';
+import type { State } from '../app-state.js';
+declare const chatSearchActionTypes: readonly ["chatSearchOpen", "chatSearchSetQuery", "chatSearchStep", "chatSearchClose"];
+type ChatSearchAction = Extract<Action, {
+    type: (typeof chatSearchActionTypes)[number];
+}>;
+export declare function isChatSearchAction(action: Action): action is ChatSearchAction;
+/** Transcript search bar (Alt+F / `/chat-search`). */
+export declare function reduceChatSearch(state: State, action: ChatSearchAction): State;
+export {};
+//# sourceMappingURL=chat-search.d.ts.map

package/dist/reducers/composer-action-types.d.ts

@@ -0,0 +1,6 @@
+import type { Action } from '../app-action-type.js';
+export 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", "themePickerFilter", "themePickerFilterMode", "themePickerPreview", "themePickerUndo", "themePickerSwapPrevious", "modePickerOpen", "modePickerClose", "modePickerMove", "modePickerHint", "skillPickerOpen", "skillMentionResults", "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"];
+export type ComposerAction = Extract<Action, {
+    type: (typeof composerActionTypes)[number];
+}>;
+//# sourceMappingURL=composer-action-types.d.ts.map

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

@@ -0,0 +1,4 @@
+import type { State } from '../app-state.js';
+export declare function reduceComposerPickers(state: State, action: ComposerAction): State;
+import type { ComposerAction } from './composer-action-types.js';
+//# sourceMappingURL=composer-pickers.d.ts.map

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", "skillMentionResults", "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/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", "goalRunTaskAgent", "goalRunTaskCompleted", "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

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/settings-contracts.d.ts

@@ -38,6 +38,7 @@ export type SettingsPickerPatch = Partial<{
     featureMemory: boolean;
     featureSkills: boolean;
     featureModelsRegistry: boolean;
+    featureToolCoach: boolean;
     tokenSavingTier: TokenSavingTierTui;
     allowOutsideProjectRoot: boolean;
     contextAutoCompact: boolean;

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-picker-rows.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Pure selection/windowing logic behind the `/theme` picker.
+ *
+ * The picker used to window a flat list of 64 rows. Three additions made that
+ * arithmetic wrong on its own:
+ *
+ *   - **Filtering.** Type-to-filter narrows the list, so the focused index is
+ *     an index into the FILTERED list, not the full catalogue.
+ *   - **Family grouping.** Headers are real rows now, and they differ in cost
+ *     from option rows — a uniform `rowSpan` can no longer describe the list.
+ *   - **The row budget.** `maxRows` is a hard contract the existing tests
+ *     assert; adding header rows must not silently overflow it.
+ *
+ * So the picker now operates on a *row model* (headers + options interleaved)
+ * and windows over rows rather than over option indices. Everything here is a
+ * pure function of its arguments — no React, no Ink, no `useTerminalSize` — so
+ * the budget and windowing rules are unit-testable without rendering a frame.
+ */
+import type { ThemePickerOption } from './theme-types.js';
+/** One rendered line: either a family header or a selectable preset row. */
+export type ThemeRow = {
+    kind: 'header';
+    family: string;
+} | {
+    kind: 'option';
+    option: ThemePickerOption;
+    index: number;
+};
+/**
+ * Narrow presets by a free-text query, matching name, id, and description.
+ *
+ * An empty or whitespace-only query returns the input unchanged so the common
+ * "filter cleared" case is free and the caller keeps a stable array identity.
+ * Matching is case-insensitive and substring-based; every whitespace-separated
+ * term must match somewhere (AND), so `tokyo storm` narrows to the Storm
+ * variant rather than the union of both words.
+ */
+export declare function filterThemeOptions(options: readonly ThemePickerOption[], query: string): readonly ThemePickerOption[];
+/**
+ * Interleave family headers with option rows.
+ *
+ * A header is emitted before the first row of each family, so contiguous
+ * same-family presets share one header. `index` is each option's position in
+ * the *filtered* list, which is what `selected` refers to.
+ */
+export declare function buildThemeRows(options: readonly ThemePickerOption[]): ThemeRow[];
+export interface ThemeWindow {
+    /** Rows to render, header rows included. */
+    rows: ThemeRow[];
+    hasAbove: boolean;
+    hasBelow: boolean;
+}
+/**
+ * Window the row model so it fits `budget` terminal rows.
+ *
+ * `budget` is the number of rows available for headers + options combined
+ * (the caller subtracts its own chrome). Two rules the flat list did not need:
+ *
+ *   - A family header is pulled in whenever its first option is in the window,
+ *     even if that header sits above the window's nominal start — otherwise the
+ *     top visible option would appear to belong to the family above it.
+ *   - Expansion alternates downward first, then upward, so a long family does
+ *     not push every visible row below the focused one off the screen.
+ *
+ * The focused row is always included, even when `budget` is smaller than the
+ * two rows a focused option plus its header need — the caller's own
+ * lower-bound guarantee wins over a strict budget.
+ */
+export declare function windowThemeRows(rows: readonly ThemeRow[], selected: number, budget: number): ThemeWindow;
+//# sourceMappingURL=theme-picker-rows.d.ts.map

package/dist/theme-presets/options.d.ts

@@ -1,4 +1,16 @@
 import type { ThemePickerOption } from '../theme-types.js';
-/** Picker rows in canonical THEME_PRESET_IDS order. */
+/**
+ * Picker rows in canonical {@link THEME_PRESET_IDS} order.
+ *
+ * Name/description/family are NOT written here: they come from
+ * `THEME_PRESET_META` in `@wrongstack/core/types`, the single table the CLI
+ * `/theme` command reads too. This file used to hand-write a 64-row literal
+ * that duplicated the CLI's own table, so a reworded or renamed preset could
+ * drift between the two pickers with nothing failing to compile — only the
+ * id set was ever linked.
+ *
+ * Deriving from the shared record also means the family grouping the picker
+ * renders and the CLI's list are guaranteed to describe the same presets.
+ */
 export declare const THEME_OPTIONS: readonly ThemePickerOption[];
 //# sourceMappingURL=options.d.ts.map

package/dist/theme-presets/rose-pine.d.ts

@@ -15,7 +15,7 @@ export declare const rosePinePresets: {
         user: "#f6c177";
         assistant: "#c4a7e7";
         tool: "#9ccfd8";
-        success: "#31748f";
+        success: "#3e8fb0";
         warn: "#f6c177";
         error: "#eb6f92";
         borderDefault: "#524f67";

package/dist/theme-types.d.ts

@@ -6,6 +6,12 @@ export interface ThemePickerOption {
     id: ThemeName;
     name: string;
     description: string;
+    /**
+     * Palette family (Catppuccin, Tokyo Night, Gruvbox, …) used to group
+     * related rows in the picker. Sourced from `THEME_PRESET_META` in
+     * `@wrongstack/core/types`, the same table the CLI reads.
+     */
+    family: string;
 }
 export interface Theme {
     textPrimary: string;