@wrongstack/tui 1.0.4 → 1.0.6

package/dist/app-action-type.d.ts

@@ -781,6 +781,9 @@ export type Action = {
     info: State['confirmQueue'][0];
 } | {
     type: 'confirmClose';
+} | {
+    type: 'confirmResolved';
+    toolUseId: string;
 } | {
     type: 'confirmClearAll';
 } | {
@@ -1195,6 +1198,17 @@ export type Action = {
 /** Reset sidebar scroll offset to 0. */
  | {
     type: 'sidebarScrollReset';
+}
+/** Jump the sidebar scroll to an absolute offset (scrollbar press/drag). */
+ | {
+    type: 'sidebarScrollSet';
+    /** Absolute offset in rows from the content top; clamped to [0, max]. */
+    offset: number;
+    viewportHeight?: number | undefined;
+    /** See the `sidebarScroll` twin field — identical clamp semantics. */
+    sidebarTwinRowCount?: number | undefined;
+    /** See the `sidebarScroll` twin field — identical clamp semantics. */
+    effectiveSwarmOnSidebar?: boolean | undefined;
 } | {
     type: 'toggleKanbanPanel';
 } | {

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

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

package/dist/app-view-contract.d.ts

@@ -61,6 +61,8 @@ interface AppViewRuntime {
     statusBarRows: number;
     /** Chip click map published by StatusBar; consumed by the mouse hit-test. */
     statusBarClickMapRef: MutableRefObject<import('./components/status-bar-types.js').StatusBarClickMap | null>;
+    /** Actual inspect-modal title row used for Copy/Close hit-testing. */
+    inspectOverlayHeaderRef: MutableRefObject<DOMElement | null>;
     stableOnKey: (input: string, key: KeyEvent) => void;
     liveTodos: ReturnType<typeof useLiveTodos>;
     liveSettings: ReturnType<NonNullable<AppProps['getSettings']>> | undefined;
@@ -82,6 +84,7 @@ interface AppViewRuntime {
     enhanceCountdown: number | null;
     nextStepsAutoSubmitCountdown: number | null;
     nextStepsAutoSubmitLabel: string | null;
+    nextStepsAutoSubmitDeadlineMs: number | null;
     setDraft: (buffer: string, cursor: number) => void;
     focusedBoardId: string | null;
     getCronJobs: () => Promise<CronListResult>;

package/dist/app-view-sidebar.d.ts

@@ -8,6 +8,14 @@ interface AppViewSidebarProps {
     runtime: AppViewProps['runtime'];
     sidebarWidth: number;
     sidebarContentWidth: number;
+    /** Current sidebar scroll offset (rows) — positions the scrollbar thumb. */
+    sidebarScrollOffset: number;
+    /**
+     * Estimated scrollable overflow (rows) from `estimateSidebarMaxScroll`,
+     * computed by `app-view.tsx` with the same inputs the wheel/press
+     * dispatchers thread. > 0 shows the one-column scrollbar in the rail.
+     */
+    sidebarMaxScroll: number;
     sidebarSlotVisible: (id: PanelId) => boolean;
     hiddenSidebarPanelCount: number;
     sidebarProcessData: ReturnType<typeof useSidebarProcessList>;
@@ -23,6 +31,6 @@ interface AppViewSidebarProps {
      *  is bootstrapping or the daemon URL hasn't produced a response yet. */
     sidebarWrongProxyData: ReturnType<typeof useSidebarWrongProxy>;
 }
-export declare function AppViewSidebar({ host, runtime, sidebarWidth, sidebarContentWidth, sidebarSlotVisible, hiddenSidebarPanelCount, sidebarProcessData, sidebarConnectionsData, sidebarKanbanData, sidebarPlanData, sidebarWrongProxyEnabled, sidebarWrongProxyData, }: AppViewSidebarProps): React.ReactElement | null;
+export declare function AppViewSidebar({ host, runtime, sidebarWidth, sidebarContentWidth, sidebarScrollOffset, sidebarMaxScroll, sidebarSlotVisible, hiddenSidebarPanelCount, sidebarProcessData, sidebarConnectionsData, sidebarKanbanData, sidebarPlanData, sidebarWrongProxyEnabled, sidebarWrongProxyData, }: AppViewSidebarProps): React.ReactElement | null;
 export {};
 //# sourceMappingURL=app-view-sidebar.d.ts.map

package/dist/app.d.ts

@@ -1,10 +1,10 @@
-import React from 'react';
+import type React from 'react';
+export { buildGoalPreamble } from '@wrongstack/core/execution';
+export type { AppProps } from './app-props.js';
 export { type Action, type FleetEntry, type QueueItem, type ResumeSessionEntry, reducer, type Settings, type SlashCommandMatch, type State, } from './app-reducer.js';
 export { nextInputWordStart, previousInputWordStart } from './input-editing.js';
 export { renderRunningTools } from './running-tools.js';
 export { selectedSlashCommandLine } from './slash-command-search.js';
-export { buildGoalPreamble } from '@wrongstack/core/execution';
-export type { AppProps } from './app-props.js';
 export { buildSteeringPreamble } from './steering-preamble.js';
 import type { AppProps } from './app-props.js';
 export declare function App(props: AppProps): React.ReactElement;

package/dist/components/confirm-prompt.d.ts

@@ -5,7 +5,7 @@ interface ConfirmPromptProps {
     input: unknown;
     suggestedPattern: string;
     onDecision: (decision: ConfirmDecision) => void;
-    /** Enable YOLO mode (capital Y). Approves the current call. */
+    /** Enable YOLO mode (capital Y). Destructive current calls remain pending. */
     onEnableYolo: () => void;
     /** Whether this call was classified destructive. */
     destructive?: boolean;

package/dist/components/history/entry.d.ts

@@ -3,7 +3,17 @@ import React from 'react';
 import type { ToolResultViewMode } from '../../tool-result-view-mode.js';
 import type { HistoryEntry } from './types.js';
 export { councilHeadline, councilSeatLine } from './entry-helpers.js';
-export declare const Entry: React.MemoExoticComponent<({ entry, termWidth, termHeight, setSuggestions, autonomyMode, multiDiffSummaryThreshold, todos, showModelReasoning, showSageMemoryInject, toolResultViewMode, }: {
+export declare const NEXT_STEP_SWEEP_DURATION_MS = 10000;
+/** Number of completed glyphs in the final ten-second auto-submit sweep. */
+export declare function nextStepSweepGlyphCount(glyphCount: number, deadlineMs: number, nowMs: number): number;
+export declare function nextStepSweepParts(text: string, deadlineMs: number, nowMs: number): {
+    lit: string;
+    cursor: string;
+    pending: string;
+};
+/** Find the newest rendered panel that owns the armed suggestion label. */
+export declare function findArmedNextStepsEntryId(entries: readonly HistoryEntry[], label: string | null | undefined): number | null;
+export declare const Entry: React.MemoExoticComponent<({ entry, termWidth, termHeight, setSuggestions, autonomyMode, nextStepsAutoSubmitLabel, nextStepsAutoSubmitDeadlineMs, multiDiffSummaryThreshold, todos, showModelReasoning, showSageMemoryInject, toolResultViewMode, }: {
     entry: HistoryEntry;
     termWidth: number;
     /** Available managed-history rows; used by height-aware entries such as the banner. */
@@ -12,6 +22,10 @@ export declare const Entry: React.MemoExoticComponent<({ entry, termWidth, termH
     setSuggestions?: ((steps: string[]) => void) | undefined;
     /** Current autonomy mode — when 'auto', first step shows an auto marker. */
     autonomyMode?: string | undefined;
+    /** Exact armed suggestion label; identifies the row that will be submitted. */
+    nextStepsAutoSubmitLabel?: string | null | undefined;
+    /** Exact deadline; drives a character-by-character sweep during its final 10 seconds. */
+    nextStepsAutoSubmitDeadlineMs?: number | null | undefined;
     /** User-tunable cutoff for the multi-file diff summary footer. Passes
      *  through to `formatMultiDiffSummary`; `undefined` means "use default". */
     multiDiffSummaryThreshold?: number | undefined;

package/dist/components/history/index.d.ts

@@ -16,5 +16,5 @@ export { AssistantStreamBox, assistantStreamBoxHeight, countLines, firstNonEmpty
  * primitives or stable reducer references, so default shallow
  * comparison is sufficient.
  */
-export declare const History: React.MemoExoticComponent<({ entries, generation, toolStream, setSuggestions, autonomyMode, multiDiffSummaryThreshold, todos, showModelReasoning, showSageMemoryInject, toolResultViewMode, toolResultViewOverrides, }: HistoryProps) => React.ReactElement>;
+export declare const History: React.MemoExoticComponent<({ entries, generation, toolStream, setSuggestions, autonomyMode, nextStepsAutoSubmitLabel, nextStepsAutoSubmitDeadlineMs, multiDiffSummaryThreshold, todos, showModelReasoning, showSageMemoryInject, toolResultViewMode, toolResultViewOverrides, }: HistoryProps) => React.ReactElement>;
 //# sourceMappingURL=index.d.ts.map

package/dist/components/history/tool-visual-types.d.ts

@@ -1,4 +1,4 @@
-export type ToolVisualLineKind = 'ok' | 'warn' | 'error' | 'meta' | 'path' | 'match' | 'code' | 'stdout' | 'stderr';
+export type ToolVisualLineKind = 'ok' | 'warn' | 'error' | 'meta' | 'path' | 'match' | 'context' | 'code' | 'stdout' | 'stderr';
 export interface ToolVisualLine {
     kind: ToolVisualLineKind;
     text: string;

package/dist/components/history/types.d.ts

@@ -15,6 +15,10 @@ export interface HistoryProps {
      * next-step suggestion indicating it will be auto-submitted.
      */
     autonomyMode?: string | undefined;
+    /** Label of the next step currently armed for automatic submission. */
+    nextStepsAutoSubmitLabel?: string | null | undefined;
+    /** Exact automatic-submit deadline used by the final 10-second text sweep. */
+    nextStepsAutoSubmitDeadlineMs?: number | null | undefined;
     /**
      * Generation counter for wholesale history replacements (session resume).
      * Keys the internal <Static> so a replacement remounts it — Ink's Static

package/dist/components/inspect-overlay.d.ts

@@ -1,6 +1,9 @@
 import type React from 'react';
+import type { MutableRefObject } from 'react';
+import { type DOMElement } from '../ink.js';
 import type { HistoryEntry } from './history/types.js';
 export declare const INSPECT_OVERLAY_MIN_ROWS = 15;
+export type InspectOverlayHeaderAction = 'copy' | 'close';
 export declare function resolveInspectOverlayContent(overlay: {
     entryId: number;
     entryIds?: readonly number[] | undefined;
@@ -16,6 +19,23 @@ export declare function inspectOverlaySize(termCols: number, viewportRows: numbe
     width: number;
     height: number;
 };
+/**
+ * Resolve a terminal click against the two fixed-width controls rendered at
+ * the right edge of the centered inspect-overlay title row. Mouse coordinates
+ * are the terminal protocol's one-based cells.
+ */
+export declare function inspectOverlayHeaderActionAt(header: DOMElement | null, x: number, y: number): InspectOverlayHeaderAction | null;
+/**
+ * Thumb geometry for the overlay's vertical scrollbar. The track is
+ * `visibleRows` tall; when the wrapped body fits, the thumb covers the whole
+ * (dim) track. Otherwise the thumb length is proportional to the visible
+ * fraction and travels from the top (offset 0) to flush bottom
+ * (offset = totalRows - visibleRows).
+ */
+export declare function scrollbarThumbGeometry(totalRows: number, visibleRows: number, offset: number): {
+    thumbStart: number;
+    thumbLength: number;
+};
 interface InspectOverlayProps {
     title: string;
     body: string;
@@ -24,7 +44,9 @@ interface InspectOverlayProps {
     viewportRows: number;
     onScroll: (delta: number) => void;
     onClose: () => void;
+    copied?: boolean | undefined;
+    headerRef?: MutableRefObject<DOMElement | null> | undefined;
 }
-export declare function InspectOverlay({ title, body, scroll, termCols, viewportRows, onScroll, onClose, }: InspectOverlayProps): React.ReactElement;
+export declare function InspectOverlay({ title, body, scroll, termCols, viewportRows, onScroll, onClose, copied, headerRef, }: InspectOverlayProps): React.ReactElement;
 export {};
 //# sourceMappingURL=inspect-overlay.d.ts.map

package/dist/components/powerline-rail.d.ts

@@ -62,9 +62,6 @@ interface PowerlineRailProps {
     /** Chips in render order. Plain elements are treated as single-level chips. */
     segments: Array<React.ReactElement | RailSpanEntry>;
     budget: number;
-    monochrome?: boolean | undefined;
-    /** Override the filler background for per-line tonal layering. */
-    fillBg?: string | undefined;
     /**
      * Optional right-anchored segment. When provided, the rail reserves
      * space for this segment at the right edge of the budget so its
@@ -74,10 +71,10 @@ interface PowerlineRailProps {
     rightAnchor?: React.ReactElement | null | undefined;
 }
 /**
- * Full-width status segments with a single uniform background.
- * No per-chip backgrounds, no transition glyphs, no segment caps —
- * just clean chips separated by a single space.
+ * Status segments on the terminal's natural background.
+ * No per-chip backgrounds, transition glyphs, or segment caps — just clean
+ * chips separated by whitespace. The caller owns any outer side inset.
  */
-export declare function PowerlineRail({ segments, budget, monochrome, fillBg, rightAnchor, }: PowerlineRailProps): React.ReactElement;
+export declare function PowerlineRail({ segments, budget, rightAnchor, }: PowerlineRailProps): React.ReactElement;
 export {};
 //# sourceMappingURL=powerline-rail.d.ts.map

package/dist/components/scrollable-history.d.ts

@@ -9,6 +9,6 @@ import type { ScrollableHistoryProps } from './history/scroll-controller-types.j
 /**
  * Bounded history viewport with stable-anchor virtual scrolling.
  */
-export declare const ScrollableHistory: React.MemoExoticComponent<({ entries, toolStream, streamingText, viewportRows, controllerRef, onScrollInfo, maxWidth, setSuggestions, autonomyMode, multiDiffSummaryThreshold, todos, showModelReasoning, showSageMemoryInject, layoutStore, copiedEntryId, onRequestOlderEntries, toolResultViewMode, toolResultViewOverrides, onToolResultViewChange, }: ScrollableHistoryProps) => React.ReactElement>;
+export declare const ScrollableHistory: React.MemoExoticComponent<({ entries, toolStream, streamingText, viewportRows, controllerRef, onScrollInfo, maxWidth, setSuggestions, autonomyMode, nextStepsAutoSubmitLabel, nextStepsAutoSubmitDeadlineMs, multiDiffSummaryThreshold, todos, showModelReasoning, showSageMemoryInject, layoutStore, copiedEntryId, onRequestOlderEntries, toolResultViewMode, toolResultViewOverrides, onToolResultViewChange, }: ScrollableHistoryProps) => React.ReactElement>;
 export type { HistoryEntry };
 //# sourceMappingURL=scrollable-history.d.ts.map

package/dist/components/sidebar-panel-frame.d.ts

@@ -129,6 +129,37 @@ export declare function SidebarPanelCard(props: CardProps): React.ReactElement;
  * "framed" look on rails wide enough to afford them.
  */
 export declare function SidebarPanelFrame({ accent, icon, title, width, kicker, right, pillLabel, pillColor, footer, children, }: SidebarPanelFrameProps): React.ReactElement;
+/**
+ * A fixed-width progress meter row: `▮▮▮▮▮░░░░░` filling exactly
+ * `innerWidth` columns (no label — pair it with a `SidebarSectionHeader`
+ * badge for the numeric readout). Replaces the hand-rolled bar pairs that
+ * Plan / Goal / Connections used to render inline so every sidebar panel
+ * shows the same meter texture. Pure display — clamps the ratio to [0, 1].
+ */
+export declare function SidebarMeter({ ratio, innerWidth, color, trackColor, marginTop, }: {
+    /** Fill ratio 0..1 (values outside are clamped). */
+    ratio: number;
+    innerWidth: number;
+    color: string;
+    trackColor?: string | undefined;
+    marginTop?: number | undefined;
+}): React.ReactElement;
+/**
+ * A single row of colored count chips — `●2 ◐1 ✓4 !1` — the shared idiom
+ * for "state distribution" summaries (fleet statuses, worktree states,
+ * connection health). Chips whose count is 0 are omitted so the row stays
+ * quiet on idle rails; render nothing at all when every count is 0.
+ */
+export declare function SidebarCountsRow({ counts, innerWidth, marginTop, }: {
+    /** Chip order is render order; zero-count chips are dropped. */
+    counts: readonly {
+        label: string;
+        count: number;
+        color: string;
+    }[];
+    innerWidth: number;
+    marginTop?: number | undefined;
+}): React.ReactElement | null;
 /**
  * useSidebarPanelSize — returns a sensible default width / height for a
  * sidebar panel given the terminal dimensions. Width mirrors

package/dist/components/sidebar-panels-workspace.d.ts

@@ -14,10 +14,17 @@ export interface ProjectPickerSidebarProps {
 export declare function ProjectPickerSidebar({ items, selected, filter, hint, currentProject, width, }: ProjectPickerSidebarProps): React.ReactElement;
 export interface FleetPanelSidebarProps {
     entries: Record<string, FleetEntry>;
+    /**
+     * Pre-computed running count from the caller. Retained for interface
+     * compatibility; the panel derives every displayed count (pill + chips)
+     * from `entries` so leader and subagents can never diverge.
+     */
     runningCount: number;
+    /** Live tick (ms) — drives per-agent elapsed labels. Defaults to Date.now(). */
+    nowTick?: number | undefined;
     width: number;
 }
-export declare function FleetPanelSidebar({ entries, runningCount, width, }: FleetPanelSidebarProps): React.ReactElement;
+export declare function FleetPanelSidebar({ entries, nowTick, width, }: FleetPanelSidebarProps): React.ReactElement;
 export interface AgentsPanelSidebarProps {
     entries: Record<string, FleetEntry>;
     totalCost: number;
@@ -27,9 +34,11 @@ export interface AgentsPanelSidebarProps {
 export declare function AgentsPanelSidebar({ entries, totalCost, nowTick, width, }: AgentsPanelSidebarProps): React.ReactElement;
 export interface WorktreePanelSidebarProps {
     worktrees: Record<string, WorktreeRow>;
+    /** Live tick (ms) — drives per-worktree age labels. Defaults to Date.now(). */
+    nowTick?: number | undefined;
     width: number;
 }
-export declare function WorktreePanelSidebar({ worktrees, width, }: WorktreePanelSidebarProps): React.ReactElement;
+export declare function WorktreePanelSidebar({ worktrees, nowTick, width, }: WorktreePanelSidebarProps): React.ReactElement;
 export interface CoordinatorPanelSidebarProps {
     running: boolean;
     activePhases: number;

package/dist/components/sidebar-scrollbar.d.ts

@@ -0,0 +1,36 @@
+import type React from 'react';
+/** Thumb geometry for a given scroll state. Pure — unit-tested. */
+export declare function sidebarScrollbarThumb(viewportRows: number, maxScroll: number, offset: number): {
+    size: number;
+    top: number;
+};
+/**
+ * Inverse mapping: a 0-based track cell (mouse row − 1 over the rail)
+ * becomes the absolute scroll offset at that track position — top of track
+ * = 0, bottom of track = maxScroll. Pure — unit-tested and shared with the
+ * press/drag dispatcher in `app-key-handler.ts` so click-scrubbing reaches
+ * the exact extremes the wheel can reach.
+ */
+export declare function sidebarOffsetForCell(cell: number, viewportRows: number, maxScroll: number): number;
+export interface SidebarScrollbarProps {
+    /** Visible content rows — the track height (RightSidebar's innerHeight). */
+    viewportRows: number;
+    /** Current scroll offset in rows. */
+    offset: number;
+    /**
+     * Estimated overflow beyond the viewport; ≤ 0 renders a dimmed,
+     * thumb-less track — the rail column itself stays visible.
+     */
+    maxScroll: number;
+    /** When true the thumb reads in the accent color (keyboard focus). */
+    focused?: boolean | undefined;
+}
+/**
+ * The rail itself: one column of `░` track cells with a `▉` thumb segment.
+ * Persistent by design: when there is nothing to scroll it renders a dimmed
+ * thumb-less track (not null) so the rail never pops in and out of existence
+ * as the content-height estimate fluctuates. Returns null only when there is
+ * no room to draw a track at all (< 1 viewport row).
+ */
+export declare function SidebarScrollbar({ viewportRows, offset, maxScroll, focused, }: SidebarScrollbarProps): React.ReactElement | null;
+//# sourceMappingURL=sidebar-scrollbar.d.ts.map

package/dist/components/sidebar.d.ts

@@ -39,12 +39,24 @@ interface RightSidebarProps {
      * When true, the sidebar border is highlighted to indicate keyboard focus.
      */
     focused?: boolean | undefined;
+    /**
+     * Current sidebar scroll offset in rows. Positions the scrollbar thumb.
+     */
+    scrollOffset?: number | undefined;
+    /**
+     * Estimated scrollable overflow in rows (from
+     * `estimateSidebarMaxScroll`). > 0 draws a one-column scrollbar with a
+     * thumb in the rail's right padding column; ≤ 0 keeps the rail visible
+     * as a dimmed, thumb-less track (persistent rail — no bottom-right
+     * flicker). Content columns are untouched either way.
+     */
+    maxScroll?: number | undefined;
     /**
      * Content to render inside the sidebar. When omitted, a dimmed placeholder
      * label is shown so the reserved region is visually self-documenting.
      */
     children?: React.ReactNode | undefined;
 }
-export declare function RightSidebar({ width, maxHeight, focused, children, }: RightSidebarProps): React.ReactElement | null;
+export declare function RightSidebar({ width, maxHeight, focused, scrollOffset, maxScroll, children, }: RightSidebarProps): React.ReactElement | null;
 export {};
 //# sourceMappingURL=sidebar.d.ts.map

package/dist/components/status-bar-icons.d.ts

@@ -44,13 +44,6 @@ export declare const STATUSLINE_ICONS: {
 export declare const COMPACT_THRESHOLD = 50;
 export declare function chipColor(color: string, isNoColor: boolean): string | undefined;
 export declare const STACK_ORANGE = "#FD9F02";
-/**
- * Per-rail background tone. Read through a function (not a frozen array) so
- * it follows a live `/theme` switch, and genuinely alternated so the four
- * rails read as four bands instead of one block: identity/safety sit on the
- * base surface, vitals/async on the raised one.
- */
-export declare function lineBackground(logical: 0 | 1 | 2 | 3): string;
 export declare const SPINNER_FRAMES: string[];
 export declare const SPINNER_INTERVAL_MS = 1000;
 //# sourceMappingURL=status-bar-icons.d.ts.map

package/dist/hooks/tui-slash-command-options.d.ts

@@ -0,0 +1,30 @@
+import type { Dispatch, MutableRefObject, SetStateAction } from 'react';
+import type { Action } from '../app-action-type.js';
+import type { AppProps } from '../app-props.js';
+import type { State } from '../app-state.js';
+import type { StatuslineItem } from '../components/statusline-picker.js';
+/** Registration options shared by the parent and its domain slice hooks. */
+export interface TuiSlashCommandOptions {
+    slashRegistry: AppProps['slashRegistry'];
+    skillLoader: AppProps['skillLoader'];
+    getResourceMenu: AppProps['getResourceMenu'];
+    getPickableProviders: AppProps['getPickableProviders'];
+    switchProviderAndModel: AppProps['switchProviderAndModel'];
+    openModelPicker: () => Promise<void>;
+    openFKeyPicker: () => void;
+    projectRoot: string;
+    agent: AppProps['agent'];
+    dispatch: Dispatch<Action>;
+    getSettings: AppProps['getSettings'];
+    saveSettings: AppProps['saveSettings'];
+    openSettings: () => void;
+    state: State;
+    openStatuslinePicker: () => void;
+    setHiddenItems: (items: StatuslineItem[]) => void;
+    hiddenItemsRef: MutableRefObject<StatuslineItem[]>;
+    setMailboxPanelOpen: Dispatch<SetStateAction<boolean>>;
+    switchAutonomy: AppProps['switchAutonomy'];
+    listSessions: AppProps['listSessions'];
+    openPromptPicker: () => Promise<void>;
+}
+//# sourceMappingURL=tui-slash-command-options.d.ts.map