@wrongstack/tui 0.298.2 → 0.299.0

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

@@ -940,6 +940,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-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/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/components/sidebar-panel-frame.d.ts

@@ -1,15 +1,15 @@
 import type React from 'react';
 export interface SidebarPanelFrameProps {
-    /** Accent color for border + title (mirrors `theme.monitor.*` on bottom panels). */
+    /** Accent color for the rail, title, and separator. */
     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 allocated to this routed panel inside RightSidebar. The outer shell
+     * owns the border and padding; this frame spends the full content width on
+     * hierarchy and data.
      */
     width: number;
     /** Optional quiet subtitle hidden on narrow terminals. */
@@ -18,14 +18,8 @@ export interface SidebarPanelFrameProps {
     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. */
+    /** Body content. The outer RightSidebar owns viewport clipping. */
     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.
@@ -47,8 +41,9 @@ export declare function SidebarSectionHeader({ glyph, label, color, badge, badge
     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. */
+/** A raised content band sized for a narrow rail. Section headers provide the
+ * accent, while the lifted surface groups related data without spending any
+ * horizontal columns on nested chrome. */
 export declare function SidebarPanelCard({ innerWidth, marginBottom, children, }: {
     innerWidth: number;
     marginBottom?: number | undefined;
@@ -56,17 +51,12 @@ export declare function SidebarPanelCard({ innerWidth, marginBottom, children, }
 }): 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.
+ * panel variant. It renders an accent-led title and telemetry strip inside the
+ * existing RightSidebar shell, followed by a natural-height body and optional
+ * footer. Avoiding a second border preserves scarce horizontal space; the
+ * outer shell clips the combined routed-panel and persistent-content stack.
  */
-export declare function SidebarPanelFrame({ accent, icon, title, width, kicker, right, footer, children, bodyScrollOffset, }: SidebarPanelFrameProps): React.ReactElement;
+export declare function SidebarPanelFrame({ accent, icon, title, width, kicker, right, footer, children, }: SidebarPanelFrameProps): React.ReactElement;
 /**
  * useSidebarPanelSize — returns a sensible default width / height for a
  * sidebar panel given the terminal dimensions. Width mirrors

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';