@wrongstack/tui 1.0.24 → 1.0.26

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", "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/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", "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/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/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;

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

@@ -131,7 +131,7 @@ export declare function useAppController(props: AppProps): {
     liveStatuslineMode: import("./settings-contracts.js").StatuslineMode;
     projectName: string | undefined;
     workingDirChip: string | undefined;
-    handleRewindTo: (checkpointIndex: number) => Promise<void>;
+    handleRewindTo: (checkpointIndex: number) => Promise<import("./hooks/use-session-rewind.js").RewindOutcome>;
     activeCtrlRef: import("react").RefObject<AbortController | null>;
     clearPendingConfirms: () => void;
     liveDirector: () => Director | null;