@prometheus-ai/agent 0.5.3 → 0.5.8

package/dist/types/modes/components/hook-selector.d.ts

@@ -3,14 +3,12 @@
  * Displays a list of string options with keyboard navigation.
  */
 import { Container, type TUI } from "@prometheus-ai/tui";
-import { type ThemeColor } from "../../modes/theme/theme";
-/** One segment of a {@link HookSelectorSlider} — a label, its accent color, and
- *  an optional detail line (e.g. the resolved model name) shown beneath the
- *  track while the segment is active. */
+/** One segment of a {@link HookSelectorSlider} — a label and an optional
+ *  detail line (e.g. the resolved model name) shown beneath the track while
+ *  the segment is active. Segment colors come from the track's theme palette,
+ *  assigned by position. */
 export interface HookSelectorSliderSegment {
     label: string;
-    /** Theme color for the segment label; defaults to `accent`. */
-    color?: ThemeColor;
     /** Secondary line rendered under the track when this segment is selected. */
     detail?: string;
 }
@@ -65,6 +63,6 @@ export declare class HookSelectorComponent extends Container {
     #private;
     constructor(title: string, options: HookSelectorOptionInput[], onSelect: (option: string) => void, onCancel: () => void, opts?: HookSelectorOptions);
     handleInput(keyData: string): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
     dispose(): void;
 }

package/dist/types/modes/components/index.d.ts

@@ -15,6 +15,7 @@ export * from "./hook-message";
 export * from "./hook-selector";
 export * from "./keybinding-hints";
 export * from "./login-dialog";
+export * from "./logout-account-selector";
 export * from "./model-selector";
 export * from "./oauth-selector";
 export * from "./queue-mode-selector";

package/dist/types/modes/components/late-diagnostics-message.d.ts

@@ -0,0 +1,20 @@
+import { Container } from "@prometheus-ai/tui";
+/** One file's worth of late LSP diagnostics, as carried on the transcript message. */
+export interface LateDiagnosticsFile {
+    path?: string;
+    summary?: string;
+    errored?: boolean;
+    messages?: string[];
+}
+/**
+ * Renders late LSP diagnostics (arrived after edit/write returned) in the
+ * transcript, reusing the same tree renderer the edit/write tools use so the
+ * styling stays consistent. Supports the global tool-output expand toggle.
+ */
+export declare class LateDiagnosticsMessageComponent extends Container {
+    #private;
+    private readonly files;
+    constructor(files: LateDiagnosticsFile[]);
+    setExpanded(expanded: boolean): void;
+    invalidate(): void;
+}

package/dist/types/modes/components/logout-account-selector.d.ts

@@ -0,0 +1,8 @@
+import { Container } from "@prometheus-ai/tui";
+import type { LogoutAccount } from "../../slash-commands/helpers/logout";
+/** Account picker for `/logout` after the provider has been selected. */
+export declare class LogoutAccountSelectorComponent extends Container {
+    #private;
+    constructor(providerName: string, accounts: LogoutAccount[], onSelect: (account: LogoutAccount) => void, onCancel: () => void);
+    handleInput(keyData: string): void;
+}

package/dist/types/modes/components/mcp-add-wizard.d.ts

@@ -16,10 +16,11 @@ export interface MCPAddWizardOAuthResult {
     credentialId: string;
     clientId?: string;
     clientSecret?: string;
+    resource?: string;
 }
 export declare class MCPAddWizard extends Container {
     #private;
-    constructor(onComplete: (name: string, config: MCPServerConfig, scope: Scope) => void, onCancel: () => void, onOAuth?: (authUrl: string, tokenUrl: string, clientId: string, clientSecret: string, scopes: string) => Promise<MCPAddWizardOAuthResult>, onTestConnection?: (config: MCPServerConfig) => Promise<void>, onRender?: () => void, initialName?: string);
+    constructor(onComplete: (name: string, config: MCPServerConfig, scope: Scope) => void, onCancel: () => void, onOAuth?: (authUrl: string, tokenUrl: string, clientId: string, clientSecret: string, scopes: string, resource?: string) => Promise<MCPAddWizardOAuthResult>, onTestConnection?: (config: MCPServerConfig) => Promise<void>, onRender?: () => void, initialName?: string);
     handleInput(keyData: string): void;
 }
 export {};

package/dist/types/modes/components/model-selector.d.ts

@@ -1,4 +1,4 @@
-import { type Model } from "@prometheus-ai/ai";
+import type { Model } from "@prometheus-ai/ai";
 import { Container, Input, type TUI } from "@prometheus-ai/tui";
 import type { ModelRegistry } from "../../config/model-registry";
 import type { Settings } from "../../config/settings";

package/dist/types/modes/components/oauth-selector.d.ts

@@ -1,4 +1,4 @@
-import { Container } from "@prometheus-ai/tui";
+import { Container, type SgrMouseEvent } from "@prometheus-ai/tui";
 import type { AuthStorage } from "../../session/auth-storage";
 /**
  * Component that renders an OAuth provider selector.
@@ -11,4 +11,13 @@ export declare class OAuthSelectorComponent extends Container {
     });
     stopValidation(): void;
     handleInput(keyData: string): void;
+    /** Move the selection one step for a wheel notch (clamped, no wrap). */
+    handleWheel(delta: -1 | 1): void;
+    /**
+     * Route an SGR mouse report at component-local coordinates. Provider rows
+     * start LIST_ROW_OFFSET lines into the render; the ScrollView window shows
+     * #visibleCount rows from #scrollStart. Wheel moves the selection, motion
+     * drives the hover band, and a left click selects and confirms like Enter.
+     */
+    routeMouse(event: SgrMouseEvent, line: number, _col: number): void;
 }

package/dist/types/modes/components/overlay-box.d.ts

@@ -0,0 +1,17 @@
+/** Pad or truncate a (possibly ANSI-styled) string to exactly `width` columns. */
+export declare function fit(text: string, width: number): string;
+/** Top border with an optional accent-colored title inset into the rule. */
+export declare function topBorder(width: number, title: string): string;
+/** A horizontal rule with left/right tees, splitting overlay sections. */
+export declare function divider(width: number): string;
+export declare function bottomBorder(width: number): string;
+/** Wrap pre-styled content in vertical borders with single-column insets. */
+export declare function row(content: string, width: number): string;
+/** Body content width for a two-column overlay of total `width`. */
+export declare function splitBodyWidth(width: number, sidebarWidth: number): number;
+/** Top border carrying the title, split by a `┬` over the column divider. */
+export declare function topBorderSplit(width: number, title: string, sidebarWidth: number): string;
+/** Section rule that closes the sidebar column with a `┴` over the divider. */
+export declare function dividerSplit(width: number, sidebarWidth: number): string;
+/** A two-column content row: `│ sidebar │ body │`, each inset by one column. */
+export declare function splitRow(sidebar: string, body: string, width: number, sidebarWidth: number): string;

package/dist/types/modes/components/plan-review-overlay.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Fullscreen plan-review overlay. The overlay owns its entire content: the plan
+ * is split into sections (preamble + one per heading), each rendered through its
+ * own {@link Markdown} and windowed by a {@link ScrollView}, while the approval
+ * options (plus the optional model-tier slider) sit beneath inside the same
+ * outlined box — one self-contained surface in the spirit of the `/copy` picker.
+ *
+ * When the terminal is wide enough and the plan has ≥2 headings, a Contents
+ * sidebar appears: it tracks the scrolled section with an accent "glow", and —
+ * when focused — lets the operator jump between sections, delete a section
+ * (with undo), and annotate sections with feedback that feeds the Refine loop.
+ *
+ * Focus regions (`toc`/`body`/`actions`) cycle with Tab/Shift+Tab; arrows move
+ * within the focused region and step left into the sidebar. The default focus is
+ * `actions`, so the muscle memory of the old single-target overlay carries over:
+ * ↑/↓ select options, Enter confirms, ←/→ drives the slider when there is no
+ * sidebar, g/G + PgUp/PgDn scroll, and the external-editor key opens the plan.
+ */
+import { type Component } from "@prometheus-ai/tui";
+import type { HookSelectorSlider } from "./hook-selector";
+export interface PlanReviewOverlayCallbacks {
+    /** Invoked with the chosen option label (never a disabled one). */
+    onPick: (label: string) => void;
+    /** Invoked on Esc / cancel. */
+    onCancel: () => void;
+    /** Invoked when the external-editor key is pressed (overlay stays open). */
+    onExternalEditor?: () => void | Promise<void>;
+    /** Invoked when the external-editor key edits the active annotation draft. */
+    onAnnotationExternalEditor?: (draft: string, commit: (text: string | null) => void) => void | Promise<void>;
+    /** Invoked with the new full plan text after an in-overlay delete/undo. */
+    onPlanEdited?: (content: string) => void;
+    /** Invoked with the Refine feedback markdown whenever annotations change. */
+    onFeedbackChange?: (feedback: string) => void;
+}
+export interface PlanReviewOverlayOptions {
+    /** Prompt rendered above the options (e.g. "Plan mode - next step"). */
+    promptTitle?: string;
+    options: string[];
+    /** Indices into `options` that render dimmed and cannot be selected. */
+    disabledIndices?: number[];
+    /** Trailing footer hint (cancel hint); the overlay prepends dynamic help. */
+    helpText?: string;
+    /** Initially highlighted option index. */
+    initialIndex?: number;
+    /** Optional model-tier slider rendered between the plan body and options. */
+    slider?: HookSelectorSlider;
+    /** Display label for the external-editor key, surfaced in the footer help. */
+    externalEditorLabel?: string;
+}
+export declare class PlanReviewOverlay implements Component {
+    #private;
+    private readonly callbacks;
+    constructor(planContent: string, options: PlanReviewOverlayOptions, callbacks: PlanReviewOverlayCallbacks);
+    invalidate(): void;
+    /** Swap the displayed plan (e.g. after an external-editor round-trip) and
+     *  reset scroll/focus so the operator starts at the top. Does not emit
+     *  `onPlanEdited` (the editor round-trip already persisted the file). */
+    setPlanContent(planContent: string): void;
+    handleInput(keyData: string): void | Promise<void>;
+    render(width: number): readonly string[];
+}

package/dist/types/modes/components/plan-toc.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Pure heading/section parser for the plan-review overlay. It splits a plan's
+ * markdown into a flat list of sections — a leading preamble (text before the
+ * first heading) followed by one entry per ATX heading — preserving the exact
+ * source bytes of each section so the overlay can render, reorder-free delete,
+ * and round-trip the document without a full markdown re-render.
+ *
+ * No TUI dependencies: this module is unit-tested in isolation.
+ */
+export interface PlanSection {
+    /** `0` = preamble (no heading, no ToC entry); `1..6` = heading depth. */
+    level: number;
+    /** Plain-text heading label with inline markdown lightly stripped. */
+    title: string;
+    /** Exact source slice for this section, including its trailing newline(s). */
+    raw: string;
+}
+/**
+ * Collapse inline markdown emphasis/link/code syntax to readable text. This is
+ * a deliberately light strip (not a full markdown render) just so ToC entries
+ * read cleanly — `**Goal** & [docs](x)` becomes `Goal & docs`.
+ */
+export declare function stripInlineMarkdown(text: string): string;
+/**
+ * Split `text` into preamble + heading sections. `#` characters inside fenced
+ * code blocks are never treated as headings. Concatenating every section's
+ * `raw` reproduces the original text exactly.
+ */
+export declare function parsePlanSections(text: string): PlanSection[];
+/**
+ * Concatenate every section's `raw` back into a single document and guarantee a
+ * single trailing newline. Inverse of {@link parsePlanSections} for any input
+ * that already ends with a newline.
+ */
+export declare function joinPlanSections(sections: readonly PlanSection[]): string;
+/**
+ * Indices to remove when deleting `sections[index]`: the heading itself plus
+ * every following section nested deeper than it (its sub-headings). The
+ * preamble (level 0) is never a deletion target and yields an empty span.
+ */
+export declare function sectionDeletionSpan(sections: readonly PlanSection[], index: number): number[];

package/dist/types/modes/components/read-tool-group.d.ts

@@ -14,6 +14,14 @@ type ReadToolGroupOptions = {
 export declare class ReadToolGroupComponent extends Container implements ToolExecutionHandle {
     #private;
     constructor(options?: ReadToolGroupOptions);
+    isTranscriptBlockFinalized(): boolean;
+    finalize(): void;
+    /**
+     * Force the group terminal even if an entry never received its result (the
+     * turn aborted or ended). Lets it freeze and stop pinning the transcript live
+     * region instead of lingering on a pending preview until the next thaw.
+     */
+    seal(): void;
     updateArgs(args: ReadRenderArgs, toolCallId?: string): void;
     updateResult(result: {
         content: Array<{

package/dist/types/modes/components/reset-usage-selector.d.ts

@@ -0,0 +1,12 @@
+import { Container } from "@prometheus-ai/tui";
+import type { ResetUsageAccount } from "../../slash-commands/helpers/reset-usage";
+/**
+ * Account picker for `/usage reset`. Lists Codex accounts with their saved
+ * rate-limit reset counts; selecting one redeems a reset. Because a reset is a
+ * scarce, irreversible credit, Enter requires a second press to confirm.
+ */
+export declare class ResetUsageSelectorComponent extends Container {
+    #private;
+    constructor(accounts: ResetUsageAccount[], onSelect: (account: ResetUsageAccount) => void, onCancel: () => void);
+    handleInput(keyData: string): void;
+}

package/dist/types/modes/components/segment-track.d.ts

@@ -1,9 +1,9 @@
 /**
  * Shared renderer for a horizontal row of colored "segments" styled after the
- * status line: each segment shows in its own accent, the active one is filled
- * as a powerline chip (its accent as the background, a luminance-matched label,
- * flanked by triangle caps) and the rest are plain colored labels joined by a
- * thin separator.
+ * status line: each segment is colored by its track position from the theme's
+ * own palette, the active one is filled as a powerline chip (its color as the
+ * background, a luminance-matched label, flanked by triangle caps) and the
+ * rest are plain colored labels joined by a thin separator.
  *
  * Used by the plan-mode model-tier slider ({@link HookSelectorComponent}) and
  * the ctrl+p role-cycle status so both surfaces read identically.
@@ -11,9 +11,14 @@
 import { type ThemeColor } from "../theme/theme";
 export interface TrackSegment {
     label: string;
-    /** Theme color for the segment; defaults to `accent`. */
-    color?: ThemeColor;
 }
+/**
+ * Resolve up to `count` theme colors that render distinctly under the active
+ * theme, in candidate preference order. May return fewer than `count` when the
+ * theme has fewer distinct hues (e.g. monochrome themes) — callers wrap with
+ * modulo. Never returns an empty array: `accent` always resolves.
+ */
+export declare function resolveSegmentPalette(count: number): ThemeColor[];
 /**
  * Render `segments` as a colored chip track with `activeIndex` filled. Returns
  * a single line of styled text with no surrounding caption or arrows — callers

package/dist/types/modes/components/session-selector.d.ts

@@ -1,19 +1,28 @@
 import { type Component, Container } from "@prometheus-ai/tui";
-import type { SessionInfo } from "../../session/session-manager";
+import type { SessionInfo } from "../../session/session-listing";
 /** Returns the IDs of sessions whose recorded prompts match a query, best first. */
 export type SessionHistoryMatcher = (query: string) => string[];
 /**
- * Combine fuzzy session matches with prompt-history matches for ranking, using
- * both signals rather than replacing one with the other.
+ * Filter and rank session picker search results.
  *
- * - `fuzzy` is the ordered fuzzy-filter result over session metadata (best first).
+ * Resume search narrows a recency-sorted list: once every query token appears
+ * as a literal substring, newer sessions should beat a slightly better fuzzy
+ * position match. Pure fuzzy/acronym matches still sort by fuzzy score after
+ * literal matches, but weak pure fuzzy tokens are dropped as noise.
+ */
+export declare function rankSessionSearchMatches(allSessions: SessionInfo[], query: string): SessionInfo[];
+/**
+ * Combine metadata matches with prompt-history matches for ranking, using both
+ * signals rather than replacing one with the other.
+ *
+ * - `fuzzy` is the ordered metadata/session-text result.
  * - `historyIds` are session IDs whose recorded prompts matched the query,
  *   ordered by prompt-history rank (typically newest matching prompt first); duplicates are tolerated.
  *
- * Ranking: sessions matched by **both** signals lead (keeping fuzzy order), then
- * fuzzy-only matches, then history-only matches (by prompt-history order). A fuzzy match
- * is never dropped, and history matches not present in `allSessions` (e.g. deleted
- * or out-of-scope sessions) are ignored since they cannot be resumed from here.
+ * Ranking: prompt-history matches lead in history order, then remaining
+ * metadata matches keep their existing order. A metadata match is never dropped,
+ * and history matches not present in `allSessions` (e.g. deleted or out-of-scope
+ * sessions) are ignored since they cannot be resumed from here.
  */
 export declare function mergeSessionRanking(allSessions: SessionInfo[], fuzzy: SessionInfo[], historyIds: string[]): SessionInfo[];
 /**
@@ -31,7 +40,7 @@ declare class SessionList implements Component {
     setSessions(sessions: SessionInfo[], showCwd: boolean): void;
     removeSession(sessionPath: string): void;
     invalidate(): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
     handleInput(keyData: string): void;
 }
 export interface SessionSelectorOptions {

package/dist/types/modes/components/settings-defs.d.ts

@@ -4,7 +4,8 @@
  * settings selector.
  *
  * To add a new setting to the UI: declare it in `settings-schema.ts`
- * with a `ui` block. If it needs a submenu, include `options: [...]`
+ * with a `ui` block carrying `tab` and `group` (the group must be listed
+ * in `TAB_GROUPS[tab]`). If it needs a submenu, include `options: [...]`
  * (or `options: "runtime"` for runtime-injected lists like themes).
  */
 import { type SettingPath, type SettingTab, type SubmenuOption } from "../../config/settings-schema";
@@ -14,6 +15,8 @@ interface BaseSettingDef {
     label: string;
     description: string;
     tab: SettingTab;
+    /** Section within the tab; items are ordered by TAB_GROUPS[tab] and rendered under a heading row. */
+    group?: string;
     /**
      * Optional visibility predicate. When supplied and returning false, the
      * setting is hidden from the UI. Applies to every variant — booleans,
@@ -41,7 +44,11 @@ export interface TextInputSettingDef extends BaseSettingDef {
 export type SettingDef = BooleanSettingDef | EnumSettingDef | SubmenuSettingDef | TextInputSettingDef;
 /** Get all setting definitions with UI */
 export declare function getAllSettingDefs(): SettingDef[];
-/** Get settings for a specific tab */
+/**
+ * Get settings for a specific tab, ordered by the tab's group layout
+ * (TAB_GROUPS). Ungrouped settings sort first; within a group, schema
+ * declaration order is preserved.
+ */
 export declare function getSettingsForTab(tab: SettingTab): SettingDef[];
 /** Get a setting definition by path */
 export declare function getSettingDef(path: SettingPath): SettingDef | undefined;

package/dist/types/modes/components/settings-selector.d.ts

@@ -1,9 +1,9 @@
 import type { ThinkingLevel } from "@prometheus-ai/agent-core";
 import type { Effort } from "@prometheus-ai/ai";
-import { Container, SettingsList } from "@prometheus-ai/tui";
+import type { ShapeTarget } from "@prometheus-ai/snapcompact";
+import { type Component, type ImageBudget } from "@prometheus-ai/tui";
 import { type SettingPath } from "../../config/settings";
 import type { StatusLinePreset, StatusLineSegmentId, StatusLineSeparatorStyle } from "../../config/settings-schema";
-import { PluginSettingsComponent } from "./plugin-settings";
 /**
  * Dynamic context for settings that need runtime data.
  * Some settings (like thinking level) are managed by the session, not Settings.
@@ -17,6 +17,12 @@ export interface SettingsRuntimeContext {
     availableThemes: string[];
     /** Working directory for plugins tab */
     cwd: string;
+    /** Active model (api + id); resolves what the snapcompact `auto` shape maps to. */
+    model?: ShapeTarget;
+    /** Shared TUI image budget (graphics ids + transmit-once) for image previews. */
+    imageBudget?: ImageBudget;
+    /** Schedules a re-render after async preview work completes. */
+    requestRender?: () => void;
 }
 /** Status line settings subset for preview */
 export interface StatusLinePreviewSettings {
@@ -25,6 +31,7 @@ export interface StatusLinePreviewSettings {
     rightSegments?: StatusLineSegmentId[];
     separator?: StatusLineSeparatorStyle;
     sessionAccent?: boolean;
+    transparent?: boolean;
 }
 export interface SettingsCallbacks {
     /** Called when any setting value changes */
@@ -44,11 +51,17 @@ export interface SettingsCallbacks {
  * Main tabbed settings selector component.
  * Uses declarative settings definitions from settings-defs.ts.
  */
-export declare class SettingsSelectorComponent extends Container {
+export declare class SettingsSelectorComponent implements Component {
     #private;
     private readonly context;
     private readonly callbacks;
     constructor(context: SettingsRuntimeContext, callbacks: SettingsCallbacks);
-    getFocusComponent(): SettingsList | PluginSettingsComponent;
+    invalidate(): void;
+    /**
+     * Fullscreen frame: title border, tab row, divider, optional search banner,
+     * the active content sized to fill the terminal, the appearance preview,
+     * then a footer hint pinned above the bottom border.
+     */
+    render(width: number): readonly string[];
     handleInput(data: string): void;
 }

package/dist/types/modes/components/snapcompact-shape-preview.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Live preview for the `snapcompact.shape` setting: renders a sample session
+ * transcript through the real snapcompact rasterizer as a miniature page and
+ * shows it zoomed, so cell size, ink hues, highlight bands, and dim tool-result
+ * spans are legible at terminal scale.
+ *
+ * The mini-frame (a {@link SRC_FRAME_PX}px page) is upscaled with
+ * nearest-neighbor so the glyph pixels stay crisp when the terminal scales the
+ * placement box. Graphics display requires the Kitty unicode-placeholder path —
+ * `renderImage` returning `lines` is the gate — because the bordered settings
+ * frame re-fits every row, which direct cursor-positioned placements (iTerm2,
+ * Sixel, Kitty `a=p`) do not survive. Everything else falls back to the stats
+ * line plus a dim notice.
+ */
+import { type ShapeTarget } from "@prometheus-ai/snapcompact";
+import { type Component, type ImageBudget } from "@prometheus-ai/tui";
+export interface SnapcompactShapePreviewOptions {
+    /** Active model (api + id); resolves what `auto` maps to for this reader. */
+    model?: ShapeTarget;
+    /** Shared TUI image budget: stable graphics ids, transmit-once, exit cleanup. */
+    imageBudget?: ImageBudget;
+    /** Schedules a re-render once an async sample render completes. */
+    requestRender?: () => void;
+}
+export declare class SnapcompactShapePreview implements Component {
+    #private;
+    constructor(currentValue: string, options?: SnapcompactShapePreviewOptions);
+    /** Track the highlighted option; the next render reflects it. */
+    setValue(value: string): void;
+    render(width: number): readonly string[];
+}

package/dist/types/modes/components/status-line/component.d.ts

@@ -0,0 +1,61 @@
+import { type Component } from "@prometheus-ai/tui";
+import type { AgentSession } from "../../../session/agent-session";
+import type { CollabStatus, EffectiveStatusLineSettings, StatusLineSettings } from "./types";
+export declare class StatusLineComponent implements Component {
+    #private;
+    private session;
+    constructor(session: AgentSession);
+    /**
+     * Re-point the status line at another session (focus proxy). Invalidate: model/context/usage all derive
+     * from it. `focusedAgentId` is the focused subagent id while the view is proxied, undefined for main.
+     */
+    setSession(session: AgentSession, focusedAgentId?: string): void;
+    updateSettings(settings: StatusLineSettings): void;
+    getEffectiveSettingsForTest(): EffectiveStatusLineSettings;
+    setAutoCompactEnabled(enabled: boolean): void;
+    setSubagentCount(count: number): void;
+    /** Active subagent count as currently displayed (collab state mirroring). */
+    get subagentCount(): number;
+    setSessionStartTime(time: number): void;
+    setPlanModeStatus(status: {
+        enabled: boolean;
+        paused: boolean;
+    } | undefined): void;
+    setLoopModeStatus(status: {
+        enabled: boolean;
+    } | undefined): void;
+    setGoalModeStatus(status: {
+        enabled: boolean;
+        paused: boolean;
+    } | undefined): void;
+    setCollabStatus(status: CollabStatus | null): void;
+    setHookStatus(key: string, text: string | undefined): void;
+    watchBranch(onBranchChange: () => void): void;
+    dispose(): void;
+    invalidate(): void;
+    /**
+     * Background-refresh the Anthropic OAuth quota report. Guarded by a 5-min
+     * TTL on both success (cache lifetime) and error (backoff). Exposed
+     * (non-private) so unit tests can verify the backoff invariant.
+     */
+    refreshUsageInBackground(): void;
+    /**
+     * Used-tokens / context-window totals for the status-line context% segment,
+     * memoized so the per-event redraw stays O(1) when nothing changed.
+     *
+     * The numerator comes from `session.getContextUsage()`, which anchors on the
+     * last assistant's real prompt-token count — so the bar matches the provider
+     * and the `/context` panel — and reports `null` while that count is unknown
+     * (right after compaction, before the next response). Exposed (non-private)
+     * for unit tests and the collab host's state broadcast.
+     */
+    getCachedContextBreakdown(): {
+        usedTokens: number | null;
+        contextWindow: number;
+    };
+    getTopBorder(width: number): {
+        content: string;
+        width: number;
+    };
+    render(width: number): readonly string[];
+}

package/dist/types/modes/components/status-line/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./component";
 export * from "./presets";
 export * from "./segments";
 export * from "./separators";

package/dist/types/modes/components/status-line/types.d.ts

@@ -1,10 +1,52 @@
+import type { CollabSessionState } from "../../../collab/protocol";
 import type { StatusLinePreset, StatusLineSegmentId, StatusLineSeparatorStyle } from "../../../config/settings-schema";
 import type { AgentSession } from "../../../session/agent-session";
-import type { StatusLineSegmentOptions, StatusLineSettings } from "../status-line";
-export type { StatusLinePreset, StatusLineSegmentId, StatusLineSegmentOptions, StatusLineSeparatorStyle, StatusLineSettings, };
+export type { StatusLinePreset, StatusLineSegmentId, StatusLineSeparatorStyle };
+/** Collab session indicator + (guest-only) host-state override for segments. */
+export interface CollabStatus {
+    role: "host" | "guest";
+    participantCount: number;
+    /** Guest only: host footer snapshot that overrides locally computed values. */
+    stateOverride?: CollabSessionState | null;
+}
+export interface StatusLineSegmentOptions {
+    model?: {
+        showThinkingLevel?: boolean;
+    };
+    path?: {
+        abbreviate?: boolean;
+        maxLength?: number;
+        stripWorkPrefix?: boolean;
+    };
+    git?: {
+        showBranch?: boolean;
+        showStaged?: boolean;
+        showUnstaged?: boolean;
+        showUntracked?: boolean;
+    };
+    time?: {
+        format?: "12h" | "24h";
+        showSeconds?: boolean;
+    };
+}
+export interface StatusLineSettings {
+    preset?: StatusLinePreset;
+    leftSegments?: StatusLineSegmentId[];
+    rightSegments?: StatusLineSegmentId[];
+    separator?: StatusLineSeparatorStyle;
+    segmentOptions?: StatusLineSegmentOptions;
+    showHookStatus?: boolean;
+    sessionAccent?: boolean;
+    /** Drop the theme's `statusLineBg` fill and powerline caps so the bar
+     *  inherits the terminal's default background. */
+    transparent?: boolean;
+}
+export type EffectiveStatusLineSettings = Required<Pick<StatusLineSettings, "leftSegments" | "rightSegments" | "separator" | "segmentOptions">> & StatusLineSettings;
 export type RGB = readonly [number, number, number];
 export interface SegmentContext {
     session: AgentSession;
+    /** Focused subagent id while the view is proxied at its session, undefined otherwise. */
+    focusedAgentId?: string | undefined;
     width: number;
     options: StatusLineSegmentOptions;
     planMode: {
@@ -18,6 +60,7 @@ export interface SegmentContext {
         enabled: boolean;
         paused: boolean;
     } | null;
+    collab: CollabStatus | null;
     usageStats: {
         input: number;
         output: number;
@@ -27,7 +70,8 @@ export interface SegmentContext {
         cost: number;
         tokensPerSecond: number | null;
     };
-    contextPercent: number;
+    /** Context usage percent, or null when unknown (e.g. right after compaction). */
+    contextPercent: number | null;
     contextWindow: number;
     autoCompactEnabled: boolean;
     subagentCount: number;

package/dist/types/modes/components/tiny-title-download-progress.d.ts

@@ -7,5 +7,5 @@ export declare class TinyTitleDownloadProgressComponent implements Component {
     update(event: TinyTitleProgressEvent): void;
     isComplete(): boolean;
     invalidate(): void;
-    render(width: number): string[];
+    render(width: number): readonly string[];
 }