@oh-my-pi/pi-coding-agent 15.11.4 → 15.11.7

package/dist/types/cli/bench-cli.d.ts

@@ -0,0 +1,78 @@
+import type { ResolvedThinkingLevel } from "@oh-my-pi/pi-agent-core";
+import type { Api, ApiKeyResolver, AssistantMessageEventStream, Context, Model, SimpleStreamOptions } from "@oh-my-pi/pi-ai";
+import type { CanonicalModelVariant } from "@oh-my-pi/pi-catalog/identity";
+import type { ApiKeyResolverModel } from "../config/api-key-resolver";
+import { type CanonicalModelQueryOptions } from "../config/model-registry";
+import { Settings } from "../config/settings";
+export interface BenchCommandArgs {
+    models: string[];
+    flags: {
+        runs?: number;
+        maxTokens?: number;
+        prompt?: string;
+        json?: boolean;
+    };
+}
+export interface BenchModelRegistry {
+    getAll(): Model<Api>[];
+    getApiKey(model: Model<Api>, sessionId?: string): Promise<string | undefined>;
+    resolver(model: ApiKeyResolverModel, sessionId?: string): ApiKeyResolver;
+    resolveCanonicalModel?(canonicalId: string, options?: CanonicalModelQueryOptions): Model<Api> | undefined;
+    getCanonicalVariants?(canonicalId: string, options?: CanonicalModelQueryOptions): CanonicalModelVariant[];
+    getCanonicalId?(model: Model<Api>): string | undefined;
+}
+export interface BenchRuntime {
+    modelRegistry: BenchModelRegistry;
+    settings?: Settings;
+    close?: () => void;
+}
+export interface BenchRunSuccess {
+    ok: true;
+    ttftMs: number;
+    durationMs: number;
+    outputTokens: number;
+    /** Generation throughput measured over the post-first-token window. */
+    tokensPerSecond: number;
+}
+export interface BenchRunFailure {
+    ok: false;
+    error: string;
+}
+export type BenchRunResult = BenchRunSuccess | BenchRunFailure;
+export interface BenchAverages {
+    ttftMs: number;
+    durationMs: number;
+    outputTokens: number;
+    tokensPerSecond: number;
+}
+export interface BenchModelReport {
+    /** Selector as the user typed it (e.g. "opus" or "gemini-3.5:low"). */
+    selector: string;
+    /** Resolved `provider/id`. */
+    model: string;
+    /** Explicit thinking level from a `:level` selector suffix; undefined = provider default. */
+    thinking?: ResolvedThinkingLevel;
+    results: BenchRunResult[];
+    /** Averages over successful runs; null when every run failed. */
+    average: BenchAverages | null;
+}
+export interface BenchSummary {
+    runs: number;
+    maxTokens: number;
+    models: BenchModelReport[];
+    failures: number;
+}
+type BenchStreamSimple = (model: Model<Api>, context: Context, options?: SimpleStreamOptions) => AssistantMessageEventStream;
+export interface BenchDependencies {
+    createRuntime?: () => Promise<BenchRuntime>;
+    randomSessionId?: () => string;
+    writeStdout?: (text: string) => void;
+    writeStderr?: (text: string) => void;
+    setExitCode?: (code: number) => void;
+    streamSimple?: BenchStreamSimple;
+    now?: () => number;
+    stdoutIsTTY?: boolean;
+}
+export declare function formatBenchTable(summary: BenchSummary): string;
+export declare function runBenchCommand(command: BenchCommandArgs, deps?: BenchDependencies): Promise<BenchSummary>;
+export {};

package/dist/types/cli/usage-cli.d.ts

@@ -7,11 +7,15 @@
  * credentials produced no usage report are listed too, so the output
  * always covers the full credential pool.
  */
-import type { UsageReport } from "@oh-my-pi/pi-ai";
+import { type UsageHistoryEntry, type UsageReport } from "@oh-my-pi/pi-ai";
 export interface UsageCommandArgs {
     json?: boolean;
     provider?: string;
     redact?: boolean;
+    /** Show recorded usage-limit history instead of a live snapshot. */
+    history?: boolean;
+    /** History window in days (with `history`). */
+    days?: number;
 }
 /** Identity slice of a stored credential, for "every account" coverage. */
 export interface UsageAccountIdentity {
@@ -69,4 +73,9 @@ export declare function computeProviderWindowStats(reports: UsageReport[]): Prov
  * each provider section as "no usage data" rows.
  */
 export declare function formatUsageBreakdown(reports: UsageReport[], accounts: UsageAccountIdentity[], nowMs: number, redaction?: Map<string, string>): string;
+/**
+ * Render recorded usage-limit history: per provider, per account, one
+ * peak-per-bucket sparkline per limit window plus latest/peak percentages.
+ */
+export declare function formatUsageHistory(entries: UsageHistoryEntry[], sinceMs: number, nowMs: number, redaction?: Map<string, string>): string;
 export declare function runUsageCommand(cmd: UsageCommandArgs): Promise<void>;

package/dist/types/commands/bench.d.ts

@@ -0,0 +1,29 @@
+import { Command } from "@oh-my-pi/pi-utils/cli";
+export default class Bench extends Command {
+    static description: string;
+    static args: {
+        models: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: true;
+            multiple: true;
+        };
+    };
+    static flags: {
+        runs: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"integer"> & {
+            description: string;
+            default: number;
+        };
+        "max-tokens": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"integer"> & {
+            description: string;
+            default: number;
+        };
+        prompt: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        json: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+    };
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/types/commands/usage.d.ts

@@ -19,6 +19,15 @@ export default class Usage extends Command {
             description: string;
             default: boolean;
         };
+        history: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+            default: boolean;
+        };
+        days: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"integer"> & {
+            char: string;
+            description: string;
+            default: number;
+        };
     };
     static examples: string[];
     run(): Promise<void>;

package/dist/types/config/model-resolver.d.ts

@@ -3,8 +3,9 @@
  *
  * Layering:
  * - `matchModel` is the single matching engine. Order: exact `provider/id`
- *   reference (with OpenRouter routed/date fallbacks) → exact canonical id →
- *   exact bare id → provider-scoped fuzzy → substring with alias-vs-dated pick.
+ *   reference (with variant-alias and OpenRouter routed/date fallbacks) →
+ *   exact canonical id → exact bare id → retired variant alias →
+ *   provider-scoped fuzzy → substring with alias-vs-dated pick.
  * - `parseModelPatternWithContext`/`parseModelPattern` layer the selector
  *   grammar on top: trailing `:level` thinking suffixes (`splitThinkingSuffix`)
  *   and `@upstream` provider routing (`splitUpstreamRouting`).

package/dist/types/config/settings-schema.d.ts

@@ -1738,13 +1738,27 @@ export declare const SETTINGS_SCHEMA: {
         };
     };
     readonly "snapcompact.systemPrompt": {
-        readonly type: "boolean";
-        readonly default: false;
+        readonly type: "enum";
+        readonly values: readonly ["none", "agents-md", "all"];
+        readonly default: "none";
         readonly ui: {
             readonly tab: "context";
             readonly group: "Experimental";
             readonly label: "Snapcompact System Prompt";
-            readonly description: "Experimental: render the system prompt as dense PNG image(s) and attach to the first user message (vision models only). Saves tokens; loses system-prompt prompt caching.";
+            readonly description: "Experimental: render selected system prompt text as dense PNG image(s) and attach to the first user message (vision models only). Saves tokens; loses prompt caching for imaged text.";
+            readonly options: readonly [{
+                readonly value: "none";
+                readonly label: "None";
+                readonly description: "Keep the system prompt as text.";
+            }, {
+                readonly value: "agents-md";
+                readonly label: "AGENTS.md";
+                readonly description: "Only move loaded context-file instructions to images, when that saves tokens.";
+            }, {
+                readonly value: "all";
+                readonly label: "All";
+                readonly description: "Move the full system prompt to images, when that saves tokens.";
+            }];
         };
     };
     readonly "snapcompact.toolResults": {
@@ -1757,6 +1771,78 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Experimental: render large historical tool results as dense PNG image(s) instead of text (vision models only). Saves tokens on accumulated read/search output.";
         };
     };
+    readonly "snapcompact.shape": {
+        readonly type: "enum";
+        readonly values: readonly ["auto", ...("5x8-bw" | "5x8-sent" | "6x12-dim" | "6x6u-bw" | "6x6u-sent" | "8on16-bw" | "8x13-bw" | "8x8r-bw" | "8x8r-sent" | "8x8u-bw" | "8x8u-sent" | "doc-8on16-bw" | "doc-8on16-sent" | "doc-8on16-sent-dim")[]];
+        readonly default: "auto";
+        readonly ui: {
+            readonly tab: "context";
+            readonly group: "Experimental";
+            readonly label: "Snapcompact Shape";
+            readonly description: "Frame shape snapcompact prints text with (compaction archive and inline imaging). Auto picks a shape tuned for the current model.";
+            readonly options: readonly [{
+                readonly value: "auto";
+                readonly label: "Auto";
+                readonly description: "Picks a shape tuned for the current model, falling back to its provider family.";
+            }, {
+                readonly value: "8x8r-bw";
+                readonly label: "8x8 repeated, black";
+                readonly description: "unscii square cell, black ink, every line printed twice with the copy on a pale highlight band.";
+            }, {
+                readonly value: "8x8r-sent";
+                readonly label: "8x8 repeated, sentence hues";
+                readonly description: "Repeated grid with ink cycling six hues at sentence boundaries.";
+            }, {
+                readonly value: "8x8u-bw";
+                readonly label: "8x8, black";
+                readonly description: "Plain unscii square cell, single-printed lines, black ink.";
+            }, {
+                readonly value: "8x8u-sent";
+                readonly label: "8x8, sentence hues";
+                readonly description: "Plain unscii square cell with sentence-hue ink.";
+            }, {
+                readonly value: "6x6u-bw";
+                readonly label: "6x6 dense, black";
+                readonly description: "unscii squeezed to 6x6 — densest readable cell, fewest frames — in black ink.";
+            }, {
+                readonly value: "6x6u-sent";
+                readonly label: "6x6 dense, sentence hues";
+                readonly description: "Densest cell with sentence-hue ink.";
+            }, {
+                readonly value: "5x8-bw";
+                readonly label: "5x8 legacy, black";
+                readonly description: "Original X.org 5x8 glyphs on the 2576px frame, black ink.";
+            }, {
+                readonly value: "5x8-sent";
+                readonly label: "5x8 legacy, sentence hues";
+                readonly description: "The original snapcompact shape (pre-shape-table sessions rendered this).";
+            }, {
+                readonly value: "6x12-dim";
+                readonly label: "6x12, dimmed stopwords";
+                readonly description: "X.org 6x12 glyphs, black ink, function words dimmed gray.";
+            }, {
+                readonly value: "8x13-bw";
+                readonly label: "8x13, black";
+                readonly description: "X.org 8x13 glyphs, black ink.";
+            }, {
+                readonly value: "8on16-bw";
+                readonly label: "8x13 on 16px pitch, black";
+                readonly description: "8x13 glyphs on an 8x16 cell (extra leading), black ink.";
+            }, {
+                readonly value: "doc-8on16-bw";
+                readonly label: "Doc 8on16, black";
+                readonly description: "Two word-wrapped newspaper columns of 8x13 glyphs on a 16px pitch, black ink.";
+            }, {
+                readonly value: "doc-8on16-sent";
+                readonly label: "Doc 8on16, sentence hues";
+                readonly description: "Two-column doc layout with sentence-hue ink.";
+            }, {
+                readonly value: "doc-8on16-sent-dim";
+                readonly label: "Doc 8on16, sentence hues + dimmed stopwords";
+                readonly description: "Two-column doc layout, sentence-hue ink, function words dimmed gray.";
+            }];
+        };
+    };
     readonly "branchSummary.enabled": {
         readonly type: "boolean";
         readonly default: false;
@@ -4102,6 +4188,36 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "codexResets.autoRedeem": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Codex Auto-Redeem Saved Resets";
+            readonly description: "When a turn is blocked by the Codex weekly limit on the active account and no other account is available, automatically spend one saved rate-limit reset (ChatGPT 'save rate limit resets'). Conservative: never fires for 5-hour-only or Spark limits, near a natural reset, or twice for the same block. Requires retries enabled.";
+        };
+    };
+    readonly "codexResets.minBlockedMinutes": {
+        readonly type: "number";
+        readonly default: 60;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Codex Auto-Redeem Min Block";
+            readonly description: "Only auto-redeem when the natural weekly reset is at least this many minutes away (don't spend a ~30-day credit to save a short wait).";
+        };
+    };
+    readonly "codexResets.keepCredits": {
+        readonly type: "number";
+        readonly default: 0;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Codex Auto-Redeem Reserve";
+            readonly description: "Never auto-spend below this many saved resets (0 = the last credit may be spent automatically).";
+        };
+    };
     readonly "provider.appendOnlyContext": {
         readonly type: "enum";
         readonly values: readonly ["auto", "on", "off"];
@@ -4451,6 +4567,11 @@ export interface ShellMinimizerSettings {
     sourceOutlineLevel: "default" | "aggressive";
     legacyFilters: boolean | undefined;
 }
+export interface CodexResetsSettings {
+    autoRedeem: boolean;
+    minBlockedMinutes: number;
+    keepCredits: number;
+}
 /** Map group prefix -> typed settings interface */
 export interface GroupTypeMap {
     compaction: CompactionSettings;
@@ -4469,6 +4590,7 @@ export interface GroupTypeMap {
     modelTags: ModelTagsSettings;
     cycleOrder: string[];
     shellMinimizer: ShellMinimizerSettings;
+    codexResets: CodexResetsSettings;
 }
 export type GroupPrefix = keyof GroupTypeMap;
 export {};

package/dist/types/edit/renderer.d.ts

@@ -93,6 +93,7 @@ export interface EditRenderContext {
 }
 export declare const editToolRenderer: {
     mergeCallAndResult: boolean;
+    provisionalPendingPreview: boolean;
     renderCall(args: EditRenderArgs, options: RenderResultOptions & {
         renderContext?: EditRenderContext;
     }, uiTheme: Theme): Component;

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

@@ -1,4 +1,4 @@
-import { Container } from "@oh-my-pi/pi-tui";
+import { Container, type SgrMouseEvent } from "@oh-my-pi/pi-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/reset-usage-selector.d.ts

@@ -0,0 +1,12 @@
+import { Container } from "@oh-my-pi/pi-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/session-selector.d.ts

@@ -8,7 +8,7 @@ export type SessionHistoryMatcher = (query: string) => string[];
  * 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.
+ * literal matches, but weak pure fuzzy tokens are dropped as noise.
  */
 export declare function rankSessionSearchMatches(allSessions: SessionInfo[], query: string): SessionInfo[];
 /**

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

@@ -1,6 +1,7 @@
 import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import type { Effort } from "@oh-my-pi/pi-ai";
-import { type Component } from "@oh-my-pi/pi-tui";
+import { type Component, type ImageBudget } from "@oh-my-pi/pi-tui";
+import type { ShapeTarget } from "@oh-my-pi/snapcompact";
 import { type SettingPath } from "../../config/settings";
 import type { StatusLinePreset, StatusLineSegmentId, StatusLineSeparatorStyle } from "../../config/settings-schema";
 /**
@@ -16,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 {

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 Component, type ImageBudget } from "@oh-my-pi/pi-tui";
+import { type ShapeTarget } from "@oh-my-pi/snapcompact";
+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/tool-execution.d.ts

@@ -72,6 +72,24 @@ export declare class ToolExecutionComponent extends Container {
      * past, or an explicit {@link seal} flips it to `true`.
      */
     isTranscriptBlockFinalized(): boolean;
+    /**
+     * Whether this still-live block's settled rows may enter native scrollback
+     * (see `FinalizableBlock.isTranscriptBlockCommitStable`). Classification is
+     * per renderer (`ToolRenderer.provisionalPendingPreview`): tail-window
+     * streaming views (edit's streamed-diff tail, bash/ssh command caps, eval
+     * cells) are re-anchored top-first by the result render, so promoting
+     * their visually static head — e.g. an edit preview idling on its last
+     * frame while the apply + LSP pass runs — would strand a stale copy of
+     * the call box above the final block the moment the result lands. Every
+     * other pending preview streams top-anchored append-shaped rows the
+     * result render preserves (a task call's context/assignment markdown, a
+     * write's content), so it stays commit-eligible — a call taller than the
+     * viewport scrolls into native history mid-stream instead of reading as
+     * cut off until the result. Expanded blocks always stream top-anchored
+     * (the over-tall write/eval scrollback contract). Displaceable waiting
+     * polls are removed wholesale by the next poll and must never commit.
+     */
+    isTranscriptBlockCommitStable(): boolean;
     /**
      * Mark the tool terminal even though no result arrived (the turn aborted or
      * abandoned it) and stop animating, so it can freeze and stops pinning the

package/dist/types/modes/controllers/selector-controller.d.ts

@@ -41,6 +41,7 @@ export declare class SelectorController {
     handleResumeSession(sessionPath: string): Promise<void>;
     handleSessionDeleteCommand(): Promise<void>;
     showOAuthSelector(mode: "login" | "logout", providerId?: string): Promise<void>;
+    showResetUsageSelector(): Promise<void>;
     showDebugSelector(): Promise<void>;
     showAgentHub(observers: SessionObserverRegistry): void;
 }

package/dist/types/modes/interactive-mode.d.ts

@@ -27,6 +27,7 @@ import type { ToolExecutionHandle } from "./components/tool-execution";
 import { TranscriptContainer } from "./components/transcript-container";
 import { type LoopLimitRuntime } from "./loop-limit";
 import { OAuthManualInputManager } from "./oauth-manual-input";
+import type { ObservableSession } from "./session-observer-registry";
 import type { Theme } from "./theme/theme";
 import type { CompactionQueuedMessage, InteractiveModeContext, InteractiveModeInitOptions, InteractiveSelectorDialogOptions, SubmittedUserInput, TodoItem, TodoPhase } from "./types";
 /** Options for creating an InteractiveMode instance (for future API use) */
@@ -42,6 +43,13 @@ export interface InteractiveModeOptions {
     /** Additional initial messages to queue */
     initialMessages?: string[];
 }
+/**
+ * Build the anchored subagent HUD block: a bold accent "Subagents" header plus
+ * one hooked row per running agent in the same `Id: description` shape the
+ * inline task rows use (muted task preview when no description was given).
+ * Returns an empty array when nothing is running so the container can clear.
+ */
+export declare function renderSubagentHudLines(sessions: ObservableSession[], columns: number): string[];
 export declare class InteractiveMode implements InteractiveModeContext {
     #private;
     session: AgentSession;
@@ -56,6 +64,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     pendingMessagesContainer: Container;
     statusContainer: Container;
     todoContainer: Container;
+    subagentContainer: Container;
     btwContainer: Container;
     omfgContainer: Container;
     errorBannerContainer: Container;
@@ -265,6 +274,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     handleResumeSession(sessionPath: string): Promise<void>;
     handleSessionDeleteCommand(): Promise<void>;
     showOAuthSelector(mode: "login" | "logout", providerId?: string): Promise<void>;
+    showResetUsageSelector(): Promise<void>;
     showProviderSetup(): Promise<void>;
     showHookConfirm(title: string, message: string): Promise<boolean>;
     handleCtrlC(): void;

package/dist/types/modes/session-observer-registry.d.ts

@@ -8,6 +8,8 @@ export interface ObservableSession {
     description?: string;
     status: "active" | "completed" | "failed" | "aborted";
     sessionFile?: string;
+    parentToolCallId?: string;
+    index?: number;
     lastUpdate: number;
     /** Latest progress snapshot from the subagent executor */
     progress?: AgentProgress;

package/dist/types/modes/setup-wizard/scenes/sign-in.d.ts

@@ -1,3 +1,4 @@
+import { type SgrMouseEvent } from "@oh-my-pi/pi-tui";
 import type { SetupSceneHost, SetupTab } from "./types";
 /**
  * "Sign in" panel: lets the user authenticate one or more model providers via
@@ -15,5 +16,7 @@ export declare class SignInTab implements SetupTab {
     dispose(): void;
     invalidate(): void;
     handleInput(data: string): void;
+    /** Forward mouse to the provider selector; pointer is inert during an active login or code prompt. */
+    routeMouse(event: SgrMouseEvent, line: number, col: number): void;
     render(width: number): readonly string[];
 }

package/dist/types/modes/setup-wizard/scenes/types.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from "@oh-my-pi/pi-tui";
+import type { Component, SgrMouseEvent } from "@oh-my-pi/pi-tui";
 import type { InteractiveModeContext } from "../../types";
 export type SetupSceneResult = "done" | "skipped";
 export interface SetupSceneHost {
@@ -14,6 +14,13 @@ export interface SetupSceneController extends Component {
     onMount?(): void | Promise<void>;
     onUnmount?(): void;
     dispose?(): void;
+    /**
+     * Route an SGR mouse report (tracking is on while the wizard holds the
+     * alternate screen). `line`/`col` are 0-based within this controller's
+     * last rendered output. When absent, the wizard falls back to synthesizing
+     * arrow keys from wheel notches.
+     */
+    routeMouse?(event: SgrMouseEvent, line: number, col: number): void;
 }
 /**
  * A single panel inside a tabbed setup scene. The host scene owns the tab bar
@@ -32,6 +39,8 @@ export interface SetupTab {
     invalidate(): void;
     /** Called when the tab becomes active (including initial mount). */
     onActivate?(): void;
+    /** Mouse routing at tab-local coordinates; see {@link SetupSceneController.routeMouse}. */
+    routeMouse?(event: SgrMouseEvent, line: number, col: number): void;
     dispose(): void;
 }
 export interface SetupScene {

package/dist/types/modes/setup-wizard/scenes/web-search.d.ts

@@ -1,3 +1,4 @@
+import { type SgrMouseEvent } from "@oh-my-pi/pi-tui";
 import type { SetupSceneHost, SetupTab } from "./types";
 /**
  * "Web search" panel: picks the provider the web_search tool should prefer and
@@ -14,6 +15,8 @@ export declare class WebSearchTab implements SetupTab {
     constructor(host: SetupSceneHost);
     onActivate(): void;
     handleInput(data: string): void;
+    /** Wheel moves the highlight; hover lights the row under the pointer; click confirms it. */
+    routeMouse(event: SgrMouseEvent, line: number, _col: number): void;
     invalidate(): void;
     dispose(): void;
     render(width: number): readonly string[];

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

@@ -66,6 +66,7 @@ export interface InteractiveModeContext {
     pendingMessagesContainer: Container;
     statusContainer: Container;
     todoContainer: Container;
+    subagentContainer: Container;
     btwContainer: Container;
     omfgContainer: Container;
     errorBannerContainer: Container;
@@ -264,6 +265,7 @@ export interface InteractiveModeContext {
     handleResumeSession(sessionPath: string): Promise<void>;
     handleSessionDeleteCommand(): Promise<void>;
     showOAuthSelector(mode: "login" | "logout", providerId?: string): Promise<void>;
+    showResetUsageSelector(): Promise<void>;
     showProviderSetup(): Promise<void>;
     showHookConfirm(title: string, message: string): Promise<boolean>;
     showDebugSelector(): Promise<void>;

package/dist/types/modes/utils/context-usage.d.ts

@@ -1,6 +1,7 @@
 import type { Model } from "@oh-my-pi/pi-ai";
 import type { Skill } from "../../extensibility/skills";
 import type { AgentSession } from "../../session/agent-session";
+import { type SnapcompactSavingsEstimate } from "../../session/snapcompact-inline";
 import type { Tool } from "../../tools";
 import type { theme as Theme } from "../theme/theme";
 type CategoryId = "systemPrompt" | "systemContext" | "systemTools" | "skills" | "messages";
@@ -18,6 +19,8 @@ export interface ContextBreakdown {
     usedTokens: number;
     autoCompactBufferTokens: number;
     freeTokens: number;
+    /** Estimated snapcompact wire savings; set when requested and a snapcompact.* setting is enabled. */
+    snapcompact?: SnapcompactSavingsEstimate;
 }
 export declare function estimateSkillsTokens(skills: readonly Skill[]): number;
 export declare function estimateToolSchemaTokens(tools: ReadonlyArray<Pick<Tool, "name" | "description" | "parameters">>): number;
@@ -38,7 +41,9 @@ export declare function computeNonMessageTokens(session: AgentSession): number;
  * Compute a breakdown of estimated context usage by category for the active
  * session and model.
  */
-export declare function computeContextBreakdown(session: AgentSession): ContextBreakdown;
+export declare function computeContextBreakdown(session: AgentSession, options?: {
+    snapcompactSavings?: boolean;
+}): ContextBreakdown;
 /**
  * Render a colorful context-usage panel as ANSI text. Output is a series of
  * lines pairing the grid (left) with the legend (right).