@oh-my-pi/pi-coding-agent 15.11.6 → 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/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/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

@@ -1771,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;

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/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

@@ -74,15 +74,19 @@ export declare class ToolExecutionComponent extends Container {
     isTranscriptBlockFinalized(): boolean;
     /**
      * Whether this still-live block's settled rows may enter native scrollback
-     * (see `FinalizableBlock.isTranscriptBlockCommitStable`). A pending
-     * collapsed preview is provisional: the tail-window streaming views
-     * (edit/bash/eval caps) 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.
-     * Expanded pending blocks stream top-anchored append-shaped content whose
-     * rows the result render preserves byte-stable (the over-tall write/eval
-     * scrollback contract), so they stay commit-eligible. Displaceable waiting
+     * (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;

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/session/snapcompact-inline.d.ts

@@ -19,6 +19,8 @@ export type SnapcompactSystemPromptMode = "none" | "agents-md" | "all";
 export interface SnapcompactInlineOptions {
     renderSystemPrompt: SnapcompactSystemPromptMode;
     renderToolResults: boolean;
+    /** Frame variant override; `"auto"`/omitted picks the provider's eval winner. */
+    shape?: snapcompact.ShapeVariantName | "auto";
 }
 /** Tool-result swap candidate, in context order. */
 export interface InlineToolResultCandidate {

package/dist/types/tools/bash.d.ts

@@ -124,6 +124,7 @@ export declare function createShellRenderer<TArgs>(config: ShellRendererConfig<T
     }, uiTheme: Theme, args?: TArgs): Component;
     mergeCallAndResult: boolean;
     inline: boolean;
+    provisionalPendingPreview: boolean;
 };
 export declare const bashToolRenderer: {
     renderCall(args: BashRenderArgs, options: RenderResultOptions, uiTheme: Theme): Component;
@@ -139,5 +140,6 @@ export declare const bashToolRenderer: {
     }, uiTheme: Theme, args?: BashRenderArgs | undefined): Component;
     mergeCallAndResult: boolean;
     inline: boolean;
+    provisionalPendingPreview: boolean;
 };
 export {};

package/dist/types/tools/eval-render.d.ts

@@ -48,5 +48,6 @@ export declare const evalToolRenderer: {
     }, uiTheme: Theme, _args?: EvalRenderArgs): Component;
     mergeCallAndResult: boolean;
     inline: boolean;
+    provisionalPendingPreview: boolean;
 };
 export {};

package/dist/types/tools/renderers.d.ts

@@ -21,5 +21,18 @@ export type ToolRenderer = {
     mergeCallAndResult?: boolean;
     /** Render without background box, inline in the response flow */
     inline?: boolean;
+    /**
+     * Collapsed pending preview is provisional — a tail-window or otherwise
+     * re-anchored view the result render replaces wholesale (an edit's
+     * streamed-diff tail, bash/ssh command caps, eval cells whose outputs
+     * interleave under each cell). Its rows must never commit to native
+     * scrollback mid-run; see
+     * `ToolExecutionComponent.isTranscriptBlockCommitStable`. Absent = the
+     * pending preview streams top-anchored append-shaped rows the result
+     * render preserves (task context/assignment, write content), which stay
+     * commit-eligible so a call taller than the viewport scrolls into history
+     * instead of reading as cut off.
+     */
+    provisionalPendingPreview?: boolean;
 };
 export declare const toolRenderers: Record<string, ToolRenderer>;

package/dist/types/tools/ssh.d.ts

@@ -65,5 +65,6 @@ export declare const sshToolRenderer: {
         renderContext?: SshRenderContext;
     }, uiTheme: Theme, args?: SshRenderArgs): Component;
     mergeCallAndResult: boolean;
+    provisionalPendingPreview: boolean;
 };
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "15.11.6",
+	"version": "15.11.7",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -47,16 +47,16 @@
 		"@agentclientprotocol/sdk": "0.22.1",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "15.11.6",
-		"@oh-my-pi/omp-stats": "15.11.6",
-		"@oh-my-pi/pi-agent-core": "15.11.6",
-		"@oh-my-pi/pi-ai": "15.11.6",
-		"@oh-my-pi/pi-catalog": "15.11.6",
-		"@oh-my-pi/pi-mnemopi": "15.11.6",
-		"@oh-my-pi/pi-natives": "15.11.6",
-		"@oh-my-pi/pi-tui": "15.11.6",
-		"@oh-my-pi/pi-utils": "15.11.6",
-		"@oh-my-pi/snapcompact": "15.11.6",
+		"@oh-my-pi/hashline": "15.11.7",
+		"@oh-my-pi/omp-stats": "15.11.7",
+		"@oh-my-pi/pi-agent-core": "15.11.7",
+		"@oh-my-pi/pi-ai": "15.11.7",
+		"@oh-my-pi/pi-catalog": "15.11.7",
+		"@oh-my-pi/pi-mnemopi": "15.11.7",
+		"@oh-my-pi/pi-natives": "15.11.7",
+		"@oh-my-pi/pi-tui": "15.11.7",
+		"@oh-my-pi/pi-utils": "15.11.7",
+		"@oh-my-pi/snapcompact": "15.11.7",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/context-async-hooks": "^2.7.1",
 		"@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",