@wrongstack/tui 0.298.3 → 0.300.0

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

@@ -648,6 +648,20 @@ export type Action = {
  | {
     type: 'escConfirmClose';
 }
+/** Open the fallback model overlay (provider.fallback_pending received). */
+ | {
+    type: 'fallbackOverlayOpen';
+    info: NonNullable<State['fallbackOverlay']>;
+}
+/** Move the fallback overlay selection (wraps). */
+ | {
+    type: 'fallbackOverlayMove';
+    delta: number;
+}
+/** Close the fallback overlay (choice made or auto-switched). */
+ | {
+    type: 'fallbackOverlayClose';
+}
 /** Open the mid-run send-mode picker with the resolved message + resolver. */
  | {
     type: 'sendModePickerOpen';
@@ -940,6 +954,24 @@ export type Action = {
     type: 'sidebarScroll';
     delta: number;
     viewportHeight?: number | undefined;
+    /**
+     * Rows occupied by routed twin panels (Todos / Plan / Kanban / …)
+     * mounted above `SidebarContent` inside `RightSidebar`. Subtracted
+     * from `viewportHeight` so the scroll clamp matches the actual
+     * viewport the user can scroll through. Defaults to 0 (no twins
+     * mounted) when omitted so existing call sites stay correct.
+     */
+    sidebarTwinRowCount?: number | undefined;
+    /**
+     * Whether the swarm panel is on the sidebar using the effective
+     * source (picker draft when the picker is open, persisted
+     * `liveSettings` otherwise — see `app-view.tsx`). Drives the
+     * mission-queue reservation in `computeMaxSidebarScroll`; without
+     * this field the reducer only sees the picker draft and under-
+     * reserves the mission card when a config-only 'sidebar' swarm
+     * mode is persisted but the picker has never been opened.
+     */
+    effectiveSwarmOnSidebar?: boolean | undefined;
 }
 /** Reset sidebar scroll offset to 0. */
  | {

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

@@ -51,6 +51,31 @@ interface AppKeyHandlerOptions {
      *  scrollbar hit-tests use this instead of terminalColumns so the scrollbar
      *  track is correctly positioned to the left of the sidebar. */
     mainColumnWidth: number;
+    /**
+     * 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>;
     liveStatuslineMode: string;

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

@@ -1,10 +1,9 @@
 import type { FleetChatVerbosity, TokenSavingTier } from '@wrongstack/core/types';
-import type { CacheTtl, ContextMode, ReasoningEffort, StatuslineMode } from './settings-contracts.js';
+import type { AgentSwarmPanelMode, CacheTtl, ContextMode, ReasoningEffort, StatuslineMode } from './settings-contracts.js';
 export type { PanelId, PanelPosition, PanelPositionMap } from './ui-contracts.js';
 export { coercePanelPositionMap, DEFAULT_PANEL_POSITIONS, PANEL_IDS, } from './ui-contracts.js';
 import type { PanelPositionMap } from './ui-contracts.js';
-/** Where to render the agent swarm panel: lower region, sidebar, or hidden. */
-export type AgentSwarmPanelMode = 'bottom' | 'sidebar' | 'off';
+export type { AgentSwarmPanelMode } from './settings-contracts.js';
 /**
  * Coerce a persisted showAgentSwarmPanel value (which may be a legacy boolean
  * or the new tri-state string) into a valid AgentSwarmPanelMode.

package/dist/app-state.d.ts

@@ -527,6 +527,26 @@ export type State = {
     escConfirm: {
         snapshot: NonNullable<State['steerSnapshot']>;
     } | null;
+    /**
+     * Fallback model overlay — shown when `provider.fallback_pending` fires.
+     * The overlay displays a countdown and the candidate model list, letting
+     * the user manually pick a model or wait for auto-switch. Null when no
+     * fallback gate is pending.
+     */
+    fallbackOverlay: {
+        requestId: string;
+        from: {
+            providerId: string;
+            model: string;
+        };
+        status: number;
+        candidates: Array<{
+            providerId: string;
+            model: string;
+        }>;
+        autoSwitchSeconds: number;
+        selected: number;
+    } | null;
     /**
      * Mid-run send-mode picker. Set when the user submits a plain message while
      * the agent is busy and `midRunSendPicker` is enabled — the picker asks how

package/dist/app-ui-state.d.ts

@@ -18,6 +18,25 @@ export interface SidebarLayoutState {
     /** Width AppView must pass to nested routed sidebar panel frames. */
     sidebarContentWidth: number;
     mainColumnWidth: number;
+    /**
+     * Whether the swarm panel (`AgentSwarmPanelMode === 'sidebar'`) is
+     * effective on the right sidebar using the dual source: picker draft
+     * when `state.settingsPicker.open`, persisted `liveSettings.panelPositions`
+     * otherwise. Mirrors the renderer-side read in `app-view.tsx` so the
+     * scroll-clamp reducer can reserve the mission-queue rows even when
+     * the persisted config never went through the picker UI.
+     */
+    effectiveSwarmOnSidebar: boolean;
+    /**
+     * Approximate row count for routed sidebar twin panels mounted above
+     * `SidebarContent` inside `RightSidebar`. The reducer subtracts this
+     * from `viewportHeight` when computing the sidebar scroll clamp so the
+     * user can't scroll past the end into blank space when one or more
+     * routed twins are mounted. Each twin contributes a per-panel
+     * `ESTIMATED_HEIGHT` constant; over-estimation is safe (existing
+     * convention — see `SIDEBAR_MISSION_MAX_WRAP_LINES` docstring).
+     */
+    sidebarTwinRowCount: number;
 }
 /**
  * Resolve the TUI's right-sidebar layout once from the open-panel flags and
@@ -25,5 +44,38 @@ export interface SidebarLayoutState {
  * this so a sidebar-routed panel narrows history consistently instead of
  * being treated as a full-width overlay by one surface.
  */
-export declare function resolveSidebarLayout(state: State, termCols: number, panelPositionsInput: Partial<Record<PanelId, 'bottom' | 'sidebar'>> | undefined, mailboxPanelOpen: boolean): SidebarLayoutState;
+export declare function resolveSidebarLayout(state: State, termCols: number, panelPositionsInput: Partial<Record<PanelId, 'bottom' | 'sidebar'>> | undefined, mailboxPanelOpen: boolean, 
+/**
+ * Open flags for each routable panel, used to compute the visible-twin
+ * row count for the scroll-clamp reservation. Panels not listed
+ * (or `undefined`) are treated as closed. Should mirror the same
+ * `sidebarPanelOpenFlags` map built in `app-view.tsx` so the
+ * dispatcher and the renderer agree on which twins are mounted.
+ */
+sidebarOpenFlags?: Partial<Record<PanelId, boolean>> | undefined, 
+/**
+ * Legacy `showAgentSwarmPanel === 'sidebar'` flag from the persisted
+ * `liveSettings` config — the same field the renderer at
+ * `app-view.tsx:897-899` reads (picker draft when open, persisted
+ * `liveSettings.showAgentSwarmPanel` when closed) to decide whether
+ * the mission card renders on the sidebar. The scroll-clamp
+ * reservation must match this source or a config-only 'sidebar'
+ * swarm mode (no recent picker open) renders the mission card but
+ * the clamp under-reserves, hiding the bottom mission rows behind
+ * `RightSidebar`'s `overflowY="hidden"` viewport. OR'd with
+ * `panelPositions.fleet === 'sidebar'` for safety (over-reservation
+ * is harmless). Defaults to `false` when omitted so existing call
+ * sites stay correct.
+ */
+legacySwarmOnSidebar?: boolean | undefined): SidebarLayoutState;
+/**
+ * Conservative row-height estimate for any routed sidebar twin panel.
+ * Each twin renders a 1-row header + a 1-row separator + variable content +
+ * optional 1-row footer. 8 rows covers the natural height of the
+ * content-rich twins (Todos / Plan / Kanban / Goal / Sessions /
+ * Coordinator) without overshooting the simpler ones (Fleet / Worktree /
+ * etc.). Over-estimation is safe; the scroll-clamp subtracts this from
+ * `viewportHeight`.
+ */
+export declare const ESTIMATED_TWIN_HEIGHT = 8;
 //# sourceMappingURL=app-ui-state.d.ts.map

package/dist/brain-panel-model.d.ts

@@ -7,6 +7,14 @@
  * persist to the global config).
  */
 import type { BrainRiskLevel } from './brain-contracts.js';
+/** One selectable Council decision lens, as published by the host. */
+export interface BrainPanelPersona {
+    id: string;
+    name: string;
+    description: string;
+    /** Seats using this lens get veto power unless the seat overrides it. */
+    defaultVeto?: boolean | undefined;
+}
 /** One configured pool entry / council voter, display-mapped. */
 export interface BrainPanelVoter {
     label: string;
@@ -43,8 +51,26 @@ export interface BrainPanelSettings {
     usingSessionModel: boolean;
     councilEnabled: boolean;
     councilMinRisk: 'medium' | 'high' | 'critical';
+    /** Fraction of seats that must return a valid vote (undefined = default 0.5). */
+    councilQuorum?: number | undefined;
+    /** Fraction of cast weight the winner must exceed (undefined = default 0.5). */
+    councilApproval?: number | undefined;
+    /** Panel-diversity warning policy. A same-model panel agrees with itself. */
+    councilDistinctness: 'none' | 'model' | 'provider';
+    /** Per-seat completion timeout (undefined = inherit the decision timeout). */
+    councilPerCallTimeoutMs?: number | undefined;
+    /** Seats polled concurrently, 1..8 (undefined = default 3). */
+    councilMaxConcurrency?: number | undefined;
+    /** Output budget for the judge call (undefined = follows the seat budget). */
+    councilJudgeMaxTokens?: number | undefined;
     /** Explicitly configured voters (empty = seats derive from the pool). */
     voters: BrainPanelVoter[];
+    /**
+     * Selectable decision lenses, published by the host from the Council persona
+     * registry. Absent on hosts that predate the catalog — `personaCycle()` then
+     * falls back to the three lenses the panel used to hard-code.
+     */
+    personaCatalog?: BrainPanelPersona[] | undefined;
     /** Effective council seat labels (empty = council disabled). */
     councilSeats: string[];
     /**
@@ -110,6 +136,17 @@ export interface BrainPanelHost {
     toggleVoterVeto(index: number): Promise<string | null>;
     setJudge(providerId: string, model: string): Promise<string | null>;
     clearJudge(): Promise<string | null>;
+    setCouncilQuorum(fraction: number): Promise<string | null>;
+    setCouncilApproval(fraction: number): Promise<string | null>;
+    setCouncilDistinctness(mode: 'none' | 'model' | 'provider'): Promise<string | null>;
+    /**
+     * The three positive-integer council knobs. `undefined` clears back to the
+     * default — unlike the LLM/cache ladders, `BrainCouncilPatch` accepts `null`
+     * for these, so a "default" rung is reachable here.
+     */
+    setCouncilPerCallTimeout(ms: number | undefined): Promise<string | null>;
+    setCouncilMaxConcurrency(count: number | undefined): Promise<string | null>;
+    setCouncilJudgeMaxTokens(tokens: number | undefined): Promise<string | null>;
     setLedgerEnabled(on: boolean): Promise<string | null>;
     setAutoDeny(count: number | undefined): Promise<string | null>;
     setTerminalPolicy(policy: BrainTerminalPolicyValue): Promise<string | null>;
@@ -157,6 +194,18 @@ export type BrainPanelRow = {
     kind: 'voterAdd';
 } | {
     kind: 'judge';
+} | {
+    kind: 'councilQuorum';
+} | {
+    kind: 'councilApproval';
+} | {
+    kind: 'councilDistinctness';
+} | {
+    kind: 'councilTimeout';
+} | {
+    kind: 'councilConcurrency';
+} | {
+    kind: 'councilJudgeMaxTokens';
 } | {
     kind: 'ledgerToggle';
 } | {
@@ -224,7 +273,25 @@ export declare const LLM_MAX_TOKENS_PRESETS: readonly number[];
 export declare const LLM_MIN_CONFIDENCE_PRESETS: readonly number[];
 export declare const CACHE_TTL_PRESETS: readonly number[];
 export declare const CACHE_MAX_ENTRIES_PRESETS: readonly number[];
+/**
+ * Council ladders. `undefined` is the "default" rung — `BrainCouncilPatch`
+ * accepts `null` for these three, unlike the LLM/cache knobs.
+ */
+export declare const COUNCIL_FRACTION_PRESETS: readonly number[];
+export declare const COUNCIL_DISTINCTNESS_PRESETS: ReadonlyArray<'none' | 'model' | 'provider'>;
+export declare const COUNCIL_TIMEOUT_PRESETS: ReadonlyArray<number | undefined>;
+export declare const COUNCIL_CONCURRENCY_PRESETS: ReadonlyArray<number | undefined>;
+export declare const COUNCIL_JUDGE_MAX_TOKENS_PRESETS: ReadonlyArray<number | undefined>;
+/**
+ * Fallback lens cycle for hosts that publish no `personaCatalog`. Prefer
+ * {@link personaCycle}, which uses the host's catalog when it is available —
+ * the registry ships six lenses, not these three.
+ */
 export declare const PERSONA_CYCLE: readonly ['executor', 'skeptic', 'auditor'];
+/** Lens ids the panel may cycle through for the given settings snapshot. */
+export declare function personaCycle(settings: BrainPanelSettings): readonly string[];
+/** Human-readable lens name for a persona id, falling back to the id itself. */
+export declare function personaLabel(settings: BrainPanelSettings, id: string | undefined): string;
 /** Cycle helper: step through a preset ladder from the current value. */
 export declare function cyclePreset<T>(presets: ReadonlyArray<T>, current: T, delta: number): T;
 //# sourceMappingURL=brain-panel-model.d.ts.map

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

@@ -0,0 +1,38 @@
+import type React from 'react';
+export interface FallbackCandidate {
+    providerId: string;
+    model: string;
+}
+export interface FallbackOverlayProps {
+    requestId: string;
+    from: {
+        providerId: string;
+        model: string;
+    };
+    status: number;
+    candidates: FallbackCandidate[];
+    autoSwitchSeconds: number;
+    selected: number;
+    /** Called when the user manually picks a model (Enter or countdown expiry on selected). */
+    onChoose: (choice: {
+        providerId: string;
+        model: string;
+    } | null) => void;
+    /** Called when the selection should move (up/down arrows). */
+    onMove: (delta: number) => void;
+}
+/**
+ * Fallback model overlay — shown when `provider.fallback_pending` fires.
+ *
+ * Displays the failed model, a list of fallback candidates, and a countdown.
+ * The user can:
+ * - Use ↑/↓ to highlight a candidate and press Enter to pick it.
+ * - Press Esc to accept the auto-switch (null → chain head).
+ * - Wait for the countdown to expire → auto-switch to the highlighted entry.
+ *
+ * The overlay always appears on top of whatever else is rendered, ensuring
+ * the user is notified on every model switch — even when a fallback list
+ * is already visible elsewhere.
+ */
+export declare function FallbackOverlay({ from, status, candidates, autoSwitchSeconds, selected, onChoose, onMove, }: FallbackOverlayProps): React.ReactElement;
+//# sourceMappingURL=fallback-overlay.d.ts.map

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

@@ -1,6 +1,21 @@
 import type { TodoItem } from '@wrongstack/core/agent';
 import React from 'react';
 import type { HistoryEntry } from './types.js';
+/**
+ * One-line summary of how a council resolved.
+ *
+ * `distinctTargetCount` is on the headline on purpose: a panel where several
+ * seats resolved to the SAME model produces a perfectly normal-looking verdict
+ * while adding cost without adding independence, and that is invisible unless
+ * the count is shown next to the seat count.
+ */
+export declare function councilHeadline(council: NonNullable<Extract<HistoryEntry, {
+    kind: 'brain';
+}>['council']>): string;
+/** One seat's line under the council headline. */
+export declare function councilSeatLine(seat: NonNullable<Extract<HistoryEntry, {
+    kind: 'brain';
+}>['council']>['seats'][number]): string;
 export declare const Entry: React.MemoExoticComponent<({ entry, termWidth, termHeight, setSuggestions, autonomyMode, multiDiffSummaryThreshold, todos, showModelReasoning, showSageMemoryInject, }: {
     entry: HistoryEntry;
     termWidth: number;

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

@@ -1,4 +1,4 @@
-import { SettingsPickerPatch } from '../settings-contracts.js';
+import type { 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[];

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

@@ -43,5 +43,21 @@ export interface SidebarContentProps {
     /** The current session ID — used to highlight the active session row. */
     currentSessionId?: string | undefined;
 }
+/**
+ * Normalized "is this session row the current session?" predicate used by
+ * both the `SidebarContent` SESSIONS card (live + resume rows) and the
+ * `SessionsPanelSidebar` (sidebar twin). The runtime `currentSessionId`
+ * is the authoritative source — when defined, the row whose id matches
+ * is the current row. When undefined (e.g. before the host registers a
+ * session), the per-row `isCurrent` flag is the fallback (carried over
+ * from the resume-picker domain for the case where the picker marks
+ * the current session as non-resumable but the host hasn't published
+ * the runtime id yet). A row without an id can never be the current
+ * row, regardless of what its fallback flag says. The two SESSIONS
+ * rows used to disagree on which key to read (live used strict id
+ * compare, resume used `rs.isCurrent` first); this helper is the
+ * single source of truth.
+ */
+export declare function isCurrentSession(rowId: string | undefined, currentSessionId: string | undefined, fallbackIsCurrent?: boolean | undefined): boolean;
 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/history-entry.d.ts

@@ -1,4 +1,37 @@
 /** Render-neutral conversation entry contracts retained by TUI state. */
+/** One seat's observable vote. No hidden chain-of-thought is retained. */
+export interface BrainCouncilSeatTrace {
+    seatId: string;
+    persona: string;
+    status: 'valid' | 'invalid' | 'failed' | 'cancelled';
+    /** The option the seat voted for, when the question was option-bearing. */
+    optionId?: string | undefined;
+    model?: string | undefined;
+    veto?: boolean | undefined;
+    durationMs?: number | undefined;
+    error?: string | undefined;
+}
+/**
+ * Panel summary attached to a council-tier Brain entry.
+ *
+ * The council is by far the most expensive tier — N provider calls per
+ * decision — and used to be entirely invisible: the votes were emitted onto
+ * the bus but no surface consumed them, so a slow, costly decision looked
+ * identical to a free policy one.
+ */
+export interface BrainCouncilTrace {
+    resolution: string;
+    configuredSeatCount: number;
+    validVoteCount: number;
+    /** Distinct provider/model targets that served the valid votes. */
+    distinctTargetCount: number;
+    judgeUsed: boolean;
+    totalTokens?: number | undefined;
+    durationMs?: number | undefined;
+    /** Structural warnings — most importantly a CORRELATED (non-diverse) panel. */
+    warnings?: string[] | undefined;
+    seats: BrainCouncilSeatTrace[];
+}
 export interface AutonomyAgentStatus {
     /** Short display name (e.g. "Brain", "Shadow", "Kanban", "Mailbox", "Memory"). */
     name: string;
@@ -185,6 +218,12 @@ export type HistoryEntry = {
     rationale?: string | undefined;
     outcome?: string | undefined;
     interventionKind?: string | undefined;
+    /**
+     * How the multi-LLM council reached this verdict, when a council decided
+     * it. Present only for council-tier decisions; the single-LLM and policy
+     * tiers leave it undefined.
+     */
+    council?: BrainCouncilTrace | undefined;
 } | {
     id: number;
     kind: 'banner';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export type { Settings } from './app.js';
 export { buildGoalPreamble } from './app.js';
 export type { AuthCatalogRow, AuthFlowIo, AuthFlowResult, AuthKeyRow, AuthLocalPresetRow, AuthOAuthKind, AuthPanelHost, AuthProviderRow, } from './auth-panel-model.js';
-export type { BrainDenyIsTerminal, BrainHeuristicKey, BrainPanelHeuristics, BrainPanelHost, BrainPanelSettings, BrainPanelVoter, BrainTerminalPolicyValue, BrainTraceContent, } from './brain-panel-model.js';
+export type { BrainDenyIsTerminal, BrainHeuristicKey, BrainPanelHeuristics, BrainPanelHost, BrainPanelPersona, BrainPanelSettings, BrainPanelVoter, BrainTerminalPolicyValue, BrainTraceContent, } from './brain-panel-model.js';
 export { replaySessionMessages } from './components/history/replay.js';
 export type { PluginPickerItem } from './components/plugin-picker.js';
 export type { ParsedNextStep, ParseNextStepsResult } from './components/suggestions.js';