@wrongstack/tui 0.298.0 → 0.298.2

package/dist/components/input.d.ts

@@ -42,6 +42,13 @@ export interface InputProps {
     /** Row count for the hidden placeholder so the bottom region never resizes. */
     placeholderHeight?: number | undefined;
     onKey: (input: string, key: KeyEvent) => void;
+    /**
+     * Optional cap on the column width used for wrapping and frame sizing.
+     * When set, the input area treats this as its effective terminal width
+     * instead of `stdout.columns` — needed when the input sits in a column
+     * narrower than the full terminal (e.g. beside a sidebar).
+     */
+    maxWidth?: number | undefined;
 }
 export interface KeyEvent {
     upArrow: boolean;
@@ -76,5 +83,5 @@ export interface KeyEvent {
     fn?: number | undefined;
 }
 export declare const EMPTY_KEY: KeyEvent;
-export declare const Input: React.MemoExoticComponent<({ prompt, value, cursor, disabled, hint, title, status, animationStyle, workingTime, footerHint, hidden, placeholderHeight, onKey, }: InputProps) => React.ReactElement>;
+export declare const Input: React.MemoExoticComponent<({ prompt, value, cursor, disabled, hint, title, status, animationStyle, workingTime, footerHint, hidden, placeholderHeight, onKey, maxWidth, }: InputProps) => React.ReactElement>;
 //# sourceMappingURL=input.d.ts.map

package/dist/components/plan-panel.d.ts

@@ -1,4 +1,22 @@
 import type React from 'react';
+export interface PlanItem {
+    id: string;
+    title: string;
+    details?: string;
+    status: 'open' | 'in_progress' | 'done';
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PlanPanelData {
+    items: PlanItem[];
+    title?: string | undefined;
+    scope: 'session' | 'project';
+    loading: boolean;
+    error: string | null;
+    updatedAt?: string | undefined;
+    setScope: (scope: 'session' | 'project') => void;
+    load: (scope: 'session' | 'project', quiet?: boolean) => Promise<void>;
+}
 export interface PlanPanelProps {
     /** Absolute path to the project root. */
     projectRoot: string;
@@ -8,10 +26,19 @@ export interface PlanPanelProps {
     onClose: () => void;
 }
 /**
- * Full-screen plan panel (F5 in TUI).
+ * Plan panel data hook (F5 in TUI).
+ *
+ * Reads the active plan JSON file from disk and renders plan items grouped
+ * by status. Shows the current scope and a hint for switching scopes via
+ * the /plan tool.
  *
- * Reads the active plan JSON file from disk and renders plan items grouped by status.
- * Shows the current scope and a hint for switching scopes via the /plan tool.
+ * Each consumer gets its own polling interval, gated by `enabled` (default
+ * true). Consumers pass `enabled` reflecting whether their panel surface is
+ * actually mounted — e.g. app-view gates the sidebar twin on its slot
+ * visibility — so a closed or bottom-routed plan panel does not keep a
+ * second 3s file-read poll alive for the whole session (the bottom PlanPanel
+ * mounts its own instance of this hook while open).
  */
+export declare function usePlanPanelData(projectRoot: string, sessionId: string | null, enabled?: boolean): PlanPanelData;
 export declare function PlanPanel({ projectRoot, sessionId, onClose: _onClose, }: PlanPanelProps): React.ReactElement;
 //# sourceMappingURL=plan-panel.d.ts.map

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

@@ -1,339 +1,11 @@
 import type React from 'react';
-import { type MutableRefObject } from 'react';
-import { EntryHeightCache } from '../height-cache.js';
-import { type RenderGroup } from './history/tool-group.js';
-import { type HistoryEntry, type HistoryProps } from './history.js';
-/**
- * Imperative scroll surface owned by the ScrollableHistory component. The app
- * key/mouse handlers call these instead of dispatching reducer actions: all
- * scroll math needs the live height cache, which lives here, and routing it
- * through app state previously forced totals and offsets to travel through
- * separate commits — the root cause of an entire family of jump bugs.
- */
-export interface HistoryScrollController {
-    /** Scroll by `deltaUp` rows: positive = older content, negative = newer. */
-    scrollBy(deltaUp: number): void;
-    /** Scroll by one viewport page. */
-    scrollPage(dir: 'up' | 'down'): void;
-    /** Jump to the oldest retained entry. */
-    scrollToTop(): void;
-    /** Re-pin to the newest output. */
-    scrollToBottom(): void;
-    /** Jump to a 0-based cell clicked/dragged on the scrollbar track. */
-    scrollToTrackCell(cell: number): void;
-    /** True while the viewport is scrolled away from the newest output. */
-    isScrolled(): boolean;
-    /**
-     * True when the viewport cell lands on a copyable card's copy icon. Lets the
-     * mouse handler decide synchronously whether to consume the click before
-     * firing the async copy. See {@link copyAtViewportCell} for the `row`/`col`
-     * coordinate contract.
-     */
-    hasCopyTargetAt(row: number, col: number): boolean;
-    /**
-     * Handle a left-click inside the history viewport. `row` is 0-based from the
-     * viewport top; `col` is 0-based from the LEFT EDGE OF THE HISTORY BAND, not
-     * the raw terminal column. In the interactive mount the band renders flush at
-     * terminal column 0 (the scrollbar occupies the rightmost columns), so the
-     * caller passes the terminal column directly; a band that is inset from the
-     * left must subtract its left offset first. When the cell lands on a copyable
-     * card's copy icon, its content is written to the system clipboard and the
-     * entry id is returned; otherwise returns null.
-     */
-    copyAtViewportCell(row: number, col: number): Promise<number | null>;
-    /**
-     * Begin a drag-to-select gesture at `row`,`col` (history-band viewport cell).
-     * The cell must be inside a card's row range and inside the rendered band
-     * (`0 <= col < termWidth`); the mouse handler has already excluded the rail.
-     * Calls that don't satisfy that contract are silently ignored. Existing
-     * scrollbar/copy-icon/wheel paths remain intact because they call their own
-     * handlers; this only kicks in when the mouse layer explicitly routes a
-     * left-press into the card band.
-     */
-    beginSelection(row: number, col: number): void;
-    /**
-     * Extend an active selection to `row`,`col`. If no selection is in progress,
-     * the call is a no-op. Crossing into the gutter or below the viewport cancels
-     * the drag internally — leaving stale viewport-relative coords around after
-     * a mid-drag escape would let the next right-click paste from the wrong
-     * card, which is the worse failure mode than the selection disappearing.
-     */
-    extendSelection(row: number, col: number): void;
-    /**
-     * End an active drag (left-release). Does NOT write to the clipboard — the
-     * copy is performed by {@link commitSelection}, which is triggered by a
-     * separate right-click in the history band (per the drag-select-then-commit
-     * contract). If no selection is in progress, the call is a no-op.
-     */
-    endSelection(): void;
-    /** Drop any in-progress or committed selection without copying. */
-    clearSelection(): void;
-    /**
-     * Commit the active selection to the system clipboard. Returns true if a
-     * non-empty selection was resolved and the write succeeded. Returns false
-     * silently when there is no selection, the selection is empty (e.g. the drag
-     * never moved), or the write fails — the caller can show a transient notice
-     * on the truthy branch and stay silent on the falsy branch.
-     */
-    commitSelection(): Promise<boolean>;
-}
-/**
- * A clickable copy-icon target resolved in viewport coordinates during the
- * post-render measurement pass. `entryId` identifies a single card or the first
- * member of a compact tool group; `entryIds` contains every group member when
- * present. `startRow`/`endRow` bound the box's visible rows (0-based from the
- * viewport top, `endRow` exclusive); `iconCol` is the 0-based terminal column
- * the icon renders at on the box's first visible row.
- */
-export interface CopyHit {
-    entryId: number;
-    entryIds?: readonly number[] | undefined;
-    startRow: number;
-    endRow: number;
-    iconCol: number;
-}
-/** Sentinel returned after copying the active, non-retained tool-stream box. */
-export declare const LIVE_TOOL_STREAM_COPY_ID = -1;
-/** Sentinel returned after copying a drag-select-then-right-click selection.
- *  Distinct from any retained entry id so the host can render a different
- *  status-line notice ("Selected range copied") without flashing a specific
- *  card's copy icon (which only makes sense when a single entry was copied). */
-export declare const SELECTION_COPY_ID = -2;
-/**
- * Resolve the copy target under a viewport cell, or null. A cell matches when
- * its `row` is within the card's visible rows and its `col` is within the
- * icon's cell span. Iterates newest-first so overlapping row estimates favor
- * the most recently rendered card. Exported-shape pure helper for unit tests.
- */
-export declare function findCopyHit(hits: readonly CopyHit[], row: number, col: number): CopyHit | null;
-/** Resolve a hit to the complete current clipboard payload without performing I/O. */
-export declare function resolveCopyPayload(hit: CopyHit, entriesById: ReadonlyMap<number, HistoryEntry>, liveToolText?: string | undefined): {
-    entryId: number;
-    text: string;
-} | null;
-/**
- * Rows clipped from the top of the mounted history stack before it appears in
- * the viewport. Scrolled frames clip by the anchor's row offset; pinned frames
- * rely on Ink flex-end clipping, which hides top overflow from mounted groups
- * plus the live tool tail.
- */
-export declare function copyRegistryVisibleClip(opts: {
-    scrolled: boolean;
-    clip: number;
-    mountedRows: number;
-    tailRows: number;
-    viewportRows: number;
-}): number;
-/** Build the live tool-stream header hit, accounting for ToolStreamBox's top margin.
- *  The `pinnedSlack` offset must match {@link buildCopyRegistry}'s card-hit math so
- *  the live-stream icon stays visually aligned with its header row in underfilled
- *  pinned frames (flex-end parks the mounted stack at the bottom of the viewport). */
-export declare function liveToolStreamCopyHit(opts: {
-    visible: boolean;
-    mountedRows: number;
-    visibleClip: number;
-    viewportRows: number;
-    iconCol: number;
-    pinnedSlack?: number;
-}): CopyHit | null;
-/**
- * Selection rectangle in viewport cell coordinates, normalized so
- * `topLeft.row <= bottomRight.row` and the column pairs are likewise ordered.
- * Both endpoints are inclusive — the cell at `bottomRight` is selected.
- */
-export interface SelectionRect {
-    topLeft: {
-        row: number;
-        col: number;
-    };
-    bottomRight: {
-        row: number;
-        col: number;
-    };
-    /** True while the user is still dragging; false after left-release but
-     *  before either clearSelection or commitSelection runs. */
-    inProgress: boolean;
-}
-/** Canonicalize two viewport cells into a SelectionRect. Pure. */
-export declare function normalizeSelection(a: {
-    row: number;
-    col: number;
-}, b: {
-    row: number;
-    col: number;
-}, inProgress: boolean): SelectionRect;
-/** True when the column lies outside the rendered card band. Inside the band
- *  the layout reserves `SCROLLBAR_HIT_WIDTH` columns for the rail AFTER the
- *  band, so `0..termWidth-1` is always in-band and nothing inside needs to be
- *  excluded. The mouse handler must already have excluded the rail before
- *  calling into the controller — we only check the band bounds here. */
-export declare function isOutOfBand(col: number, termWidth: number): boolean;
-/**
- * One entry's contribution to a drag-selected range. Returned in document
- * (row-index-in-card) coordinates so the caller decides how to slice into
- * the entry's source text. `start` is the column inside the card (0-based
- * from the left edge of the card's visible rectangle, NOT the terminal
- * column — the gutter is excluded by the caller before reaching here).
- * `end` is inclusive. When `startRow === endRow`, the slice is one row; the
- * caller is responsible for translating text columns into source offsets.
- */
-export interface SelectionSlice {
-    entryId: number;
-    /** Inclusive row-in-card for the start of the slice. */
-    startRow: number;
-    /** Inclusive column, 0-based, inside the card's text area (gutter excluded). */
-    startCol: number;
-    /** Inclusive end row. */
-    endRow: number;
-    /** Inclusive end column, 0-based. */
-    endCol: number;
-}
-/**
- * Translate a viewport-cell selection into per-entry row/col slices, walking
- * the same mounted-group geometry the copy-hit registry uses so the two
- * systems share one row index. Entries wholly outside the selection return
- * nothing. Entries whose vertical span is wholly inside the selection are
- * returned as a single row-range; entries the selection clips at the top or
- * bottom are returned with row bounds matching the clip.
- *
- * `cardVisibleCols` is the number of columns inside the card the user can
- * see — the band width minus the right gutter (`viewportWidth - SCROLLBAR_HIT_WIDTH`).
- * Slices never include the gutter or any column to its right; the caller has
- * already validated that.
- *
- * Returned slices are in document (entry-local) coordinates: `startRow`/`endRow`
- * are rows inside the entry's own geometry, NOT viewport cells. This is what
- * the assembler needs to recover text — slicing into the raw entry text uses
- * per-row layout, which the caller resolves via the layout store.
- */
-export declare function selectionToSlices(opts: {
-    selection: SelectionRect;
-    cards: ReadonlyArray<{
-        entryId: number;
-        /** 0-based viewport row of the card's first visible row. */
-        viewportStartRow: number;
-        /** 0-based viewport row just past the card's last visible row. */
-        viewportEndRow: number;
-    }>;
-    cardVisibleCols: number;
-}): SelectionSlice[];
-export interface ScrollableHistoryProps extends HistoryProps {
-    /** Height of the viewport in rows, computed by App from the bottom region. */
-    viewportRows: number;
-    /** Receives the imperative scroll controller. The component assigns on
-     *  mount and clears on unmount. Optional for isolated renderers. */
-    controllerRef?: MutableRefObject<HistoryScrollController | null> | undefined;
-    /** Reports scroll-state transitions (scrolled away from / re-pinned to the
-     *  newest output) so the host can adjust key hints. */
-    onScrollInfo?: ((info: {
-        scrolled: boolean;
-    }) => void) | undefined;
-    /** Optional cap on the width used for entry wrapping (right panel mode). */
-    maxWidth?: number | undefined;
-    /** Layout store for persisting entry height data across renders and sessions.
-     *  When provided, the ScrollableHistory seeds its height cache from the
-     *  store's persisted measurements and marks entries as measured after render,
-     *  eliminating estimate-vs-actual scroll jumps on re-render. */
-    layoutStore?: import('../layout-store.js').LayoutStore | undefined;
-    /**
-     * Entry id of the card whose copy icon was just clicked. That card's icon
-     * renders in the success color for the brief window the host keeps this set,
-     * giving per-card visual feedback alongside the status-line "Copied" notice.
-     * `null` / undefined = no card highlighted.
-     */
-    copiedEntryId?: number | null | undefined;
-    /**
-     * Called when the user scrolls near the top of the currently loaded
-     * entries. The host should respond by loading older entries from the
-     * history archive and dispatching `archiveLoaded` to prepend them.
-     */
-    onRequestOlderEntries?: (() => void) | undefined;
-}
-/** Pure thumb geometry for the scrollbar: where the thumb starts and how many
- *  cells it spans, given the track height, scroll offset, and total content
- *  height. Exported for testing. */
-export declare function scrollbarThumb(rows: number, offset: number, total: number): {
-    top: number;
-    size: number;
-    scrollable: boolean;
-};
-/** Inverse of {@link scrollbarThumb}: given a clicked/dragged 0-based cell on a
- *  track of `rows` height, return the scroll offset (rows up from the bottom)
- *  that lands the visible window there. Cell 0 (top) → oldest content (max
- *  offset); cell rows-1 (bottom) → newest (offset 0). Exported for testing. */
-export declare function scrollOffsetForTrackRow(rows: number, total: number, cell: number): number;
-/**
- * Per-card viewport span for the currently-mounted groups. Mirrors
- * {@link buildCopyRegistry}'s visibleClip math so the drag-select gesture asks
- * the same geometry question the copy-hit registry already answers.
- */
-export interface MountedCardSpan {
-    entryId: number;
-    /** 0-based viewport row of the first VISIBLE row of the card. */
-    viewportStartRow: number;
-    /** 0-based viewport row one past the last VISIBLE row of the card. */
-    viewportEndRow: number;
-    /** Card's geometry in rows; visibleClip + scrolled-clip aware. */
-    totalRows: number;
-    entryIds?: readonly number[];
-}
-/**
- * Build per-card viewport spans for every mounted render group. Pure — given
- * the same render-group list, height cache, scroll state, and viewport size,
- * the result is deterministic and matches the copy-hit registry. Exported so
- * tests can verify the span map without mounting the full component.
- */
-export declare function buildMountedCardSpans(opts: {
-    renderGroups: readonly RenderGroup[];
-    heightCache: EntryHeightCache;
-    scrolled: boolean;
-    clip: number;
-    tailRows: number;
-    viewportRows: number;
-    showModelReasoning?: boolean | undefined;
-}): MountedCardSpan[];
-/**
- * Find the card whose viewport row range contains `row`. Pure.
- * Returns null when the row is in a blank gap or outside the viewport.
- */
-export declare function selectionHitAt(row: number, spans: readonly MountedCardSpan[]): {
-    entryId: number;
-    entryIds?: readonly number[];
-} | null;
-/**
- * Build the clipboard payload for a selection by slicing into each affected
- * entry's full renderable text. The v1 contract is line-then-column on the
- * entry's source text: each slice exposes `startRow`/`endRow` and
- * `startCol`/`endCol` in card-local coordinates; we split the entry's
- * text on `\n`, keep only the rows inside the row range, and within those
- * rows apply the column range. The matrix matches what the source line
- * index would be when no wrapping occurs — i.e. one card row maps to one
- * source line. Wrap-geometry translation is intentionally absent in v1
- * because the layout store does not yet expose per-card-row wrap segments;
- * it returns when those segments exist and a v1.1 test demands it.
- *
- * `toolGroupsByHeadId` lets a multi-member tool-group expand: when the
- * head id appears with `entryIds.length > 1`, the assembler copies via
- * `copyableTextForEntries` (raw ordered JSON of every member, matching
- * the existing copy-icon contract). A single-entry head falls through
- * to `copyableTextForEntry`.
- *
- * Multi-entry selections are joined with `\n---\n` so the user can see
- * where one card ends and the next begins. Empty selections and
- * selections that resolve to no text return `""` so the caller can fall
- * through silently.
- */
-export declare function assembleSelectionText(opts: {
-    slices: readonly SelectionSlice[];
-    entriesById: ReadonlyMap<number, HistoryEntry>;
-    /**
-     * For each tool-group head id present in `slices`, the ordered member list.
-     * When a head has a multi-member group, the assembler slices into the
-     * group's combined text via `copyableTextForEntries`. A single-entry
-     * head falls through to `copyableTextForEntry`.
-     */
-    toolGroupsByHeadId?: ReadonlyMap<number, readonly number[]> | undefined;
-}): string;
+import { type HistoryEntry } from './history.js';
+export type { HistoryScrollController, ScrollableHistoryProps, } from './history/scroll-controller-types.js';
+export { type CopyHit, LIVE_TOOL_STREAM_COPY_ID, SELECTION_COPY_ID, findCopyHit, resolveCopyPayload, copyRegistryVisibleClip, liveToolStreamCopyHit, } from './history/copy-geometry.js';
+export { type SelectionRect, type SelectionSlice, normalizeSelection, isOutOfBand, selectionToSlices, assembleSelectionText, } from './history/selection-helpers.js';
+export { type MountedCardSpan, scrollbarThumb, scrollOffsetForTrackRow, buildMountedCardSpans, selectionHitAt, } from './history/scrollbar-geometry.js';
+export { Scrollbar } from './history/scrollbar-rail.js';
+import type { ScrollableHistoryProps } from './history/scroll-controller-types.js';
 /**
  * Bounded history viewport with stable-anchor virtual scrolling.
  *

package/dist/components/settings-picker-model.d.ts

@@ -1,3 +1,4 @@
+import { SettingsPickerPatch } from '../settings-contracts.js';
 /** Selectable presets for the auto-proceed delay, so the field is fully
  *  keyboard-cyclable (←/→) instead of needing typed numeric input. */
 export declare const DELAY_PRESETS_MS: number[];
@@ -81,8 +82,13 @@ export type AnimationStyleChoice = (typeof ANIMATION_STYLE_CHOICES)[number];
 /** Human-readable label for an animation style choice (including cycle). */
 export declare function formatAnimationStyle(style: AnimationStyleChoice): string;
 export declare const MODE_DESC: Record<SettingsMode, string>;
-/** Total number of settings rows (used for wrap-around navigation). */
-export declare const SETTINGS_FIELD_COUNT = 45;
+/** Total number of settings rows (used for wrap-around navigation).
+ *  Indices 0–44 are the legacy auto-rebuilt Settings surface; 45..44+PANEL_IDS.length
+ *  are the per-panel position rows (one per PanelId in PANEL_IDS order)
+ *  added when the showAgentSwarmPanel tri-state was generalized into the
+ *  per-panel PanelPositionMap. Derived from PANEL_IDS.length so adding
+ *  a new panel id automatically extends the surface. */
+export declare const SETTINGS_FIELD_COUNT: number;
 /**
  * Field index of the "Thinking word" row. The reducer's per-field switch and
  * the app.tsx key handler both branch on this, so it lives next to the row
@@ -134,57 +140,12 @@ export declare const THINKING_WORD_PRESETS: readonly ['thinking', 'random', 'wor
 export declare const CONFIG_SCOPES: readonly ['global', 'project'];
 export type ConfigScope = (typeof CONFIG_SCOPES)[number];
 /**
- * Partial patch for the configurable keys of the settings-picker state.
- * Excludes non-configurable keys (open, field, lastSettingsField, filter,
- * hint, thinkingWordEditing, thinkingWordDraft).
+ * Re-export of the canonical `SettingsPickerPatch` from `settings-contracts.ts`.
+ * That module is the single source of truth so that `Action['patch']` (in
+ * app-action-type.ts) and the helpers below stay in lock-step. Adding a new
+ * key here requires adding it there too — keep them in sync.
  */
-export type SettingsPickerPatch = Partial<{
-    mode: SettingsMode;
-    delayMs: number;
-    titleAnimation: boolean;
-    yolo: boolean;
-    fleetChat: FleetChatVerbosityTui;
-    chime: boolean;
-    confirmExit: boolean;
-    nextPrediction: boolean;
-    featureMcp: boolean;
-    featurePlugins: boolean;
-    featureMemory: boolean;
-    featureSkills: boolean;
-    featureModelsRegistry: boolean;
-    tokenSavingTier: TokenSavingTierTui;
-    allowOutsideProjectRoot: boolean;
-    contextAutoCompact: boolean;
-    contextStrategy: CompactorStrategy;
-    contextMode: ContextMode;
-    maxConcurrent: number;
-    logLevel: LogLevel;
-    auditLevel: AuditLevel;
-    indexOnStart: boolean;
-    multiDiffSummaryThreshold: number;
-    maxIterations: number;
-    autoProceedMaxIterations: number;
-    enhanceDelayMs: number;
-    preRefineSeconds: number;
-    enhanceEnabled: boolean;
-    enhanceLanguage: EnhanceLanguage;
-    debugStream: boolean;
-    statuslineMode: StatuslineMode;
-    reasoningMode: ReasoningMode;
-    reasoningEffort: ReasoningEffort;
-    reasoningPreserve: boolean;
-    thinkingWord: string;
-    cacheTtl: CacheTtl;
-    configScope: ConfigScope;
-    animationStyle: AnimationStyleChoice;
-    breakerEnabled: boolean;
-    breakerAutoKillResetMs: number;
-    showModelReasoning: boolean;
-    showAgentSwarmPanel: boolean;
-    readSymbols: boolean;
-    showSageMemoryInject: boolean;
-    sageMemoryInjectThreshold: number;
-}>;
+export type { SettingsPickerPatch };
 /**
  * Human-readable labels for all settings fields (0–SETTINGS_FIELD_COUNT-1),
  * in picker row order. Used by `resolveSettingsFieldValue` for confirmation

package/dist/components/settings-picker.d.ts

@@ -64,17 +64,22 @@ export interface SettingsPickerProps {
     /** Show the "Model Reasoning" blocks in chat history. Default: true. */
     showModelReasoning: boolean;
     /**
-     * Show the persistent FleetPanel below the status bar, including AGENT SWARM
-     * activity and its todo mission queue. Full-screen agent/queue/goal overlays
-     * remain independently available through their panel shortcuts. Default: true.
+     * Show the Mission Queue section (todo items) in the right sidebar. The
+     * lower-region FleetPanel is always visible when there is fleet activity;
+     * this toggle controls only the sidebar mission queue. Default: 'bottom'.
      */
-    showAgentSwarmPanel: boolean;
+    showAgentSwarmPanel: import('../app-settings-type.js').AgentSwarmPanelMode;
     /** Show SAGE Memory Inject blocks in tool results. Default: false. */
     showSageMemoryInject: boolean;
     /** Minimum relation strength for SAGE memory injection. Default: 0.85. */
     sageMemoryInjectThreshold: number;
     /** When true, read tool includes codebase-index symbols alongside file content. */
     readSymbols: boolean;
+    /**
+     * Per-panel placement map (F-key bottom vs right sidebar). One picker row
+     * per PanelId in PANEL_IDS order; each row cycles 'bottom' ↔ 'sidebar'.
+     */
+    panelPositions: import('../ui-contracts.js').PanelPositionMap;
     /** Raw SSE stream debugging toggle — hex-dump every byte received from providers. */
     debugStream: boolean;
     /** Statusline density: minimum single-line or detailed multi-line. */
@@ -97,5 +102,5 @@ export interface SettingsPickerProps {
     filter?: string | undefined;
     hint?: string | undefined;
 }
-export declare function SettingsPicker({ field, filter, mode, delayMs, titleAnimation, yolo, fleetChat, chime, confirmExit, nextPrediction, featureMcp, featurePlugins, featureMemory, featureSkills, featureModelsRegistry, tokenSavingTier, allowOutsideProjectRoot, maxIterations, autoProceedMaxIterations, enhanceDelayMs, enhanceEnabled, enhanceLanguage, preRefineSeconds, indexOnStart, multiDiffSummaryThreshold, thinkingWord, thinkingWordEditing, thinkingWordDraft, reasoningMode, reasoningEffort, reasoningPreserve, cacheTtl, contextAutoCompact, contextStrategy, contextMode, maxConcurrent, logLevel, auditLevel, debugStream, statuslineMode, configScope, profileConfigPath, animationStyle, breakerEnabled, breakerAutoKillResetMs, showModelReasoning, showAgentSwarmPanel, showSageMemoryInject, sageMemoryInjectThreshold, readSymbols, hint, }: SettingsPickerProps): React.ReactElement;
+export declare function SettingsPicker({ field, filter, mode, delayMs, titleAnimation, yolo, fleetChat, chime, confirmExit, nextPrediction, featureMcp, featurePlugins, featureMemory, featureSkills, featureModelsRegistry, tokenSavingTier, allowOutsideProjectRoot, maxIterations, autoProceedMaxIterations, enhanceDelayMs, enhanceEnabled, enhanceLanguage, preRefineSeconds, indexOnStart, multiDiffSummaryThreshold, thinkingWord, thinkingWordEditing, thinkingWordDraft, reasoningMode, reasoningEffort, reasoningPreserve, cacheTtl, contextAutoCompact, contextStrategy, contextMode, maxConcurrent, logLevel, auditLevel, debugStream, statuslineMode, configScope, profileConfigPath, animationStyle, breakerEnabled, breakerAutoKillResetMs, showModelReasoning, showAgentSwarmPanel, showSageMemoryInject, sageMemoryInjectThreshold, readSymbols, panelPositions, hint, }: SettingsPickerProps): React.ReactElement;
 //# sourceMappingURL=settings-picker.d.ts.map

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

@@ -0,0 +1,47 @@
+import type { ResumeSessionEntry } from '../app-state.js';
+import type { FleetEntry } from '../app-state-fleet.js';
+import type { TodoItem } from '@wrongstack/core/agent';
+import type React from 'react';
+import type { LiveSessionEntry } from './sessions-panel.js';
+export interface SidebarContentProps {
+    /** Live context window data from useStatusbarViewModel. */
+    contextWindow: {
+        used: number;
+        max: number;
+    } | undefined;
+    /** Fleet entries (leader + subagents) from useStatusbarViewModel. */
+    entries: Record<string, FleetEntry>;
+    /** Fleet counts summary. */
+    fleetCounts: {
+        running: number;
+        idle: number;
+        pending: number;
+        completed: number;
+    } | undefined;
+    /** Current provider label for display. */
+    provider?: string | undefined;
+    /** Current model label for display. */
+    model?: string | undefined;
+    /** Actual sidebar width in columns (including border+padding chrome).
+     *  Used to size the content area and truncate text appropriately. */
+    width: number;
+    /** Vertical scroll offset — number of rows scrolled from the top. */
+    scrollOffset?: number | undefined;
+    /** When true, the sidebar has keyboard focus (↑↓ scroll). */
+    focused?: boolean | undefined;
+    /** Live leader todo board — rendered as a compact mission queue. */
+    todos?: readonly TodoItem[] | undefined;
+    /** When true, show the agent-swarm + mission-queue section. Gated by the
+     *  effective agent-swarm panel mode being 'sidebar' (see app-view.tsx). */
+    showSwarmSection?: boolean | undefined;
+    /** Live sessions from the SessionRegistry — same data as the F10 panel.
+     *  Shown as compact "live" rows with project name + status + agent count. */
+    liveSessions?: readonly LiveSessionEntry[] | undefined;
+    /** Recent stored sessions for the `/resume` picker. Shown as compact rows
+     *  with title + last-activity + outcome badge. */
+    resumeSessions?: readonly ResumeSessionEntry[] | undefined;
+    /** The current session ID — used to highlight the active session row. */
+    currentSessionId?: string | undefined;
+}
+export declare function SidebarContent({ contextWindow, entries, fleetCounts, provider, model, width, scrollOffset, focused, todos, showSwarmSection, liveSessions, resumeSessions, currentSessionId, }: SidebarContentProps): React.ReactElement;
+//# sourceMappingURL=sidebar-content.d.ts.map

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

@@ -0,0 +1,80 @@
+import type React from 'react';
+export interface SidebarPanelFrameProps {
+    /** Accent color for border + title (mirrors `theme.monitor.*` on bottom panels). */
+    accent: string;
+    /** Header glyph, e.g. `glyphs.fleet` or `glyphs.sessions`. */
+    icon: string;
+    /** Uppercase title (e.g. "FLEET", "PLAN", "AGENTS"). */
+    title: string;
+    /**
+     * Width allocated to this panel frame, including the frame's own border and
+     * padding. When nested in RightSidebar, pass that shell's content width —
+     * not the outer sidebar width — so both chrome layers remain in bounds.
+     */
+    width: number;
+    /** Optional quiet subtitle hidden on narrow terminals. */
+    kicker?: string | undefined;
+    /** Optional right-aligned header content (status badge, counts, etc.). */
+    right?: React.ReactNode | undefined;
+    /** Footer content (key hints, footer note). Renders under the body. */
+    footer?: React.ReactNode | undefined;
+    /** Body content. Renders inside the scrollable region. */
+    children?: React.ReactNode | undefined;
+    /**
+     * Body scroll offset (in rows). When the body exceeds the visible window,
+     * older rows are clipped from the top and a "↑ N earlier" marker is shown.
+     * Pass `0` when no scrolling is needed (single panel fits in viewport).
+     */
+    bodyScrollOffset?: number | undefined;
+}
+/**
+ * Truncate a string to fit within `max` display columns, adding an ellipsis.
+ * Exported so sibling sidebar panel files can use the same string-fitting
+ * helper without pulling in sidebar-content.tsx's full implementation.
+ */
+export declare function trunc(s: string, max: number): string;
+/**
+ * A section header: colored glyph + bold uppercase label, a dotted leader
+ * filling the remaining width, and an optional right-aligned badge. Always
+ * renders exactly one row of exactly `innerWidth` columns — the badge is
+ * dropped gracefully when there is no room (narrow terminals).
+ */
+export declare function SidebarSectionHeader({ glyph, label, color, badge, badgeColor, innerWidth, }: {
+    glyph: string;
+    label: string;
+    color: string;
+    badge?: string | undefined;
+    badgeColor?: string | undefined;
+    innerWidth: number;
+}): React.ReactElement;
+/** A raised "card" wrapper. On truecolor terminals it gets a subtle lifted
+ *  surface so sections read as stacked panels; otherwise it is a plain box. */
+export declare function SidebarPanelCard({ innerWidth, marginBottom, children, }: {
+    innerWidth: number;
+    marginBottom?: number | undefined;
+    children: React.ReactNode;
+}): React.ReactElement;
+/**
+ * SidebarPanelFrame — the standard chrome wrapper used by every sidebar
+ * panel variant. Renders a round border in the panel's accent color with a
+ * glyph + title header, optional kicker + right-aligned badge, a scrollable
+ * body region, and an optional footer.
+ *
+ * Scrolling: the body itself doesn't scroll. The host (app-view / SidebarContent)
+ * computes scroll offsets from the focused panel index. We accept a
+ * `bodyScrollOffset` and a fixed body height so panels that exceed their
+ * viewport can be paged with Shift+Tab + ↑↓ while focused. When the body
+ * scrolls, a "↑ N earlier" indicator is shown at the top of the body region.
+ */
+export declare function SidebarPanelFrame({ accent, icon, title, width, kicker, right, footer, children, bodyScrollOffset, }: SidebarPanelFrameProps): React.ReactElement;
+/**
+ * useSidebarPanelSize — returns a sensible default width / height for a
+ * sidebar panel given the terminal dimensions. Width mirrors
+ * `computeSidebarWidth` from `sidebar.tsx`; height is the full terminal
+ * minus a small safety margin for the focus indicator row.
+ */
+export declare function useSidebarPanelSize(): {
+    width: number;
+    height: number;
+};
+//# sourceMappingURL=sidebar-panel-frame.d.ts.map