@oh-my-pi/pi-coding-agent 15.11.6 → 15.11.8

package/dist/types/cli/args.d.ts

@@ -26,6 +26,8 @@ export interface Args {
     sessionDir?: string;
     providerSessionId?: string;
     fork?: string;
+    /** Collab link to join at startup (set by the `join` subcommand; no CLI flag). */
+    join?: string;
     models?: string[];
     tools?: string[];
     noTools?: boolean;

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/collab/crypto.d.ts

@@ -0,0 +1,12 @@
+/**
+ * AES-256-GCM sealing for collab frames.
+ *
+ * The room key lives only in the link fragment; the relay sees opaque bytes.
+ * Sealed layout: `[12B IV][ciphertext+tag]`.
+ */
+import type { CollabFrame } from "./protocol";
+export declare function generateRoomKey(): Uint8Array;
+export declare function importRoomKey(raw: Uint8Array): Promise<CryptoKey>;
+export declare function seal(key: CryptoKey, frame: CollabFrame): Promise<Uint8Array>;
+/** Inverse of {@link seal}. Throws on auth failure or malformed input. */
+export declare function open(key: CryptoKey, data: Uint8Array): Promise<CollabFrame>;

package/dist/types/collab/guest.d.ts

@@ -0,0 +1,21 @@
+import type { ImageContent } from "@oh-my-pi/pi-ai";
+import type { AgentHubRemote } from "../modes/components/agent-hub";
+import type { InteractiveModeContext } from "../modes/types";
+import { AgentRegistry } from "../registry/agent-registry";
+import { type CollabSessionState } from "./protocol";
+/** Commands a guest may run locally; everything else is host-only. */
+export declare const COLLAB_GUEST_ALLOWED_COMMANDS: Record<string, true>;
+export declare class CollabGuestLink {
+    #private;
+    state: CollabSessionState | null;
+    /** Local mirror of the host's agent ecosystem (refs carry `session: null`). */
+    readonly agentRegistry: AgentRegistry;
+    /** Agent Hub actions routed to the host over the wire. */
+    get hubRemote(): AgentHubRemote;
+    constructor(ctx: InteractiveModeContext);
+    join(link: string): Promise<void>;
+    /** User-initiated leave (or post-disconnect cleanup): restore the previous session. */
+    leave(_reason: string): Promise<void>;
+    sendPrompt(text: string, images?: ImageContent[]): void;
+    sendAbort(): void;
+}

package/dist/types/collab/host.d.ts

@@ -0,0 +1,13 @@
+import type { InteractiveModeContext } from "../modes/types";
+import { type CollabParticipant } from "./protocol";
+/** Display name for this process's user in collab sessions. */
+export declare function collabDisplayName(ctx: InteractiveModeContext): string;
+export declare class CollabHost {
+    #private;
+    constructor(ctx: InteractiveModeContext);
+    get link(): string;
+    get participants(): CollabParticipant[];
+    start(relayUrl: string): Promise<void>;
+    /** Broadcast a goodbye, detach all taps, and close the socket. */
+    stop(reason: string): Promise<void>;
+}

package/dist/types/collab/protocol.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Collab live-session wire protocol.
+ *
+ * Hub topology: the host is authoritative, guests never peer. All session
+ * payloads (`CollabFrame`) travel AES-256-GCM sealed; the relay only sees the
+ * plaintext envelope (`[4B uint32 BE peerId][sealed payload]`) plus TEXT JSON
+ * control messages that carry no session data.
+ */
+import type { ImageContent, Model } from "@oh-my-pi/pi-ai";
+import type { BusChannel, GuestFrame, ParsedCollabLink, Participant, SessionState, AgentSnapshot as WireAgentSnapshot } from "@oh-my-pi/pi-wire";
+import { DEFAULT_RELAY_URL, ENVELOPE_HEADER_LENGTH, ROOM_ID_BYTES } from "@oh-my-pi/pi-wire";
+import type { ContextUsage } from "../extensibility/extensions/types";
+import type { AgentSessionEvent } from "../session/agent-session";
+import type { SessionEntry, SessionHeader } from "../session/session-manager";
+export type { CollabPromptDetails, ParsedCollabLink, RelayControlMessage, RelayControlToGuest, RelayControlToHost, } from "@oh-my-pi/pi-wire";
+export { COLLAB_PROMPT_MESSAGE_TYPE, COLLAB_PROTO } from "@oh-my-pi/pi-wire";
+export { DEFAULT_RELAY_URL, ENVELOPE_HEADER_LENGTH, ROOM_ID_BYTES };
+export type CollabParticipant = Participant;
+export type AgentSnapshot = WireAgentSnapshot;
+/** Debounced footer snapshot broadcast by the host. */
+export type CollabSessionState = SessionState & {
+    /**
+     * Host model (full catalog object). Guests apply it to their replica
+     * agent state so model display and context-window math are native.
+     */
+    model?: Model;
+    /** Host status-line context numbers (guest system prompt/tools differ, so local estimates drift). */
+    contextUsage?: ContextUsage;
+};
+/**
+ * Encrypted payload frames (inside AES-GCM, JSON). The wire package pins the
+ * JSON skeleton (`WireFrame`); host-side frames carry the rich session types
+ * that serialize into those shapes.
+ */
+export type CollabFrame = Exclude<GuestFrame, {
+    t: "prompt";
+}> | {
+    t: "prompt";
+    text: string;
+    images?: ImageContent[];
+} | {
+    t: "welcome";
+    proto: number;
+    header: SessionHeader;
+    entries: SessionEntry[];
+    state: CollabSessionState;
+    agents: AgentSnapshot[];
+} | {
+    t: "entry";
+    entry: SessionEntry;
+} | {
+    t: "event";
+    event: AgentSessionEvent;
+} | {
+    t: "state";
+    state: CollabSessionState;
+}
+/** Mirrored EventBus traffic (task subagent lifecycle/progress channels only). */
+ | {
+    t: "bus";
+    channel: BusChannel;
+    data: unknown;
+}
+/** Full agent-registry snapshot (debounced on registry change). */
+ | {
+    t: "agents";
+    agents: AgentSnapshot[];
+}
+/** Targeted reply to fetch-transcript; `text` is decoded JSONL from `fromByte`, `newSize` the next offset base. */
+ | {
+    t: "transcript";
+    reqId: number;
+    text: string;
+    newSize: number;
+    error?: string;
+} | {
+    t: "bye";
+    reason: string;
+} | {
+    t: "error";
+    message: string;
+};
+export declare function packEnvelope(peerId: number, sealed: Uint8Array): Uint8Array;
+export declare function unpackEnvelope(data: Uint8Array): {
+    peerId: number;
+    payload: Uint8Array;
+} | null;
+/** Rewrite the peerId in place without copying the payload. */
+export declare function rewriteEnvelopePeer(data: Uint8Array, peerId: number): void;
+export declare function generateRoomId(): string;
+/**
+ * Render the shareable link. Compact forms: the default relay collapses to
+ * `<roomId>#<key>`, other wss relays drop the scheme (`host[:port]/r/…`);
+ * only localhost ws:// links keep their full URL so parsing cannot
+ * mis-infer wss.
+ */
+export declare function formatCollabLink(relayUrl: string, roomId: string, key: Uint8Array): string;
+export declare function parseCollabLink(link: string): ParsedCollabLink | {
+    error: string;
+};

package/dist/types/collab/relay-client.d.ts

@@ -0,0 +1,22 @@
+import type { CollabFrame, RelayControlMessage } from "./protocol";
+export interface CollabSocketOptions {
+    /** wss://host[:port]/r/<roomId> — no query string. */
+    wsUrl: string;
+    role: "host" | "guest";
+    key: CryptoKey;
+}
+export declare class CollabSocket {
+    #private;
+    /** Fires after every successful (re)connect. */
+    onOpen?: () => void;
+    onFrame?: (frame: CollabFrame, fromPeer: number) => void;
+    onControl?: (msg: RelayControlMessage) => void;
+    /** Fires once per terminal close (intentional, fatal code, or bad key). willReconnect=true for transient drops that will retry. */
+    onClose?: (reason: string, willReconnect: boolean) => void;
+    constructor(opts: CollabSocketOptions);
+    get isOpen(): boolean;
+    connect(): void;
+    send(frame: CollabFrame, targetPeer?: number): void;
+    /** Intentional close: clears any retry timer, suppresses reconnect. A later connect() starts fresh. */
+    close(): 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/join.d.ts

@@ -0,0 +1,12 @@
+import { Command } from "@oh-my-pi/pi-utils/cli";
+export default class Join extends Command {
+    static description: string;
+    static args: {
+        link: import("@oh-my-pi/pi-utils/cli").ArgDescriptor & {
+            description: string;
+            required: true;
+        };
+    };
+    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

@@ -33,7 +33,7 @@ export declare const TAB_METADATA: Record<SettingTab, {
  */
 export declare const TAB_GROUPS: Record<SettingTab, readonly string[]>;
 /** Status line segment identifiers */
-export type StatusLineSegmentId = "pi" | "model" | "mode" | "path" | "git" | "pr" | "subagents" | "token_in" | "token_out" | "token_total" | "token_rate" | "cost" | "context_pct" | "context_total" | "time_spent" | "time" | "session" | "hostname" | "cache_read" | "cache_write" | "cache_hit" | "session_name" | "usage";
+export type StatusLineSegmentId = "pi" | "model" | "mode" | "path" | "git" | "pr" | "subagents" | "token_in" | "token_out" | "token_total" | "token_rate" | "cost" | "context_pct" | "context_total" | "time_spent" | "time" | "session" | "hostname" | "cache_read" | "cache_write" | "cache_hit" | "session_name" | "usage" | "collab";
 /** Submenu choice metadata. */
 export type SubmenuOption<V extends string = string> = {
     value: V;
@@ -1394,6 +1394,26 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Notify when the ask tool is waiting for input";
         };
     };
+    readonly "collab.relayUrl": {
+        readonly type: "string";
+        readonly default: "wss://relay.omp.sh";
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Collab";
+            readonly label: "Relay URL";
+            readonly description: "Relay used by /collab (wss://host[:port]; self-host with the omp-collab-relay service)";
+        };
+    };
+    readonly "collab.displayName": {
+        readonly type: "string";
+        readonly default: "";
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Collab";
+            readonly label: "Display Name";
+            readonly description: "Name shown to other collab participants (default: OS username)";
+        };
+    };
     readonly "stt.enabled": {
         readonly type: "boolean";
         readonly default: false;
@@ -1771,6 +1791,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/extensibility/slash-commands.d.ts

@@ -1,5 +1,3 @@
-import type { AutocompleteItem } from "@oh-my-pi/pi-tui";
-import { type BuiltinSlashCommand } from "../slash-commands/builtin-registry";
 export type SlashCommandSource = "extension" | "prompt" | "skill";
 export type SlashCommandLocation = "user" | "project" | "path";
 export interface SlashCommandInfo {
@@ -9,15 +7,7 @@ export interface SlashCommandInfo {
     location?: SlashCommandLocation;
     path?: string;
 }
-export type { BuiltinSlashCommand, SubcommandDef } from "../slash-commands/builtin-registry";
-/**
- * Materialized builtin slash commands with completion functions derived from
- * declarative subcommand/hint definitions.
- */
-export declare const BUILTIN_SLASH_COMMANDS: ReadonlyArray<BuiltinSlashCommand & {
-    getArgumentCompletions?: (prefix: string) => AutocompleteItem[] | null;
-    getInlineHint?: (argumentText: string) => string | null;
-}>;
+export type { BuiltinSlashCommand, SubcommandDef } from "../slash-commands/types";
 /**
  * Represents a custom slash command loaded from a file
  */

package/dist/types/modes/components/agent-hub.d.ts

@@ -4,6 +4,17 @@ import { IrcBus } from "../../irc/bus";
 import { AgentLifecycleManager } from "../../registry/agent-lifecycle";
 import { AgentRegistry } from "../../registry/agent-registry";
 import type { SessionObserverRegistry } from "../session-observer-registry";
+/** Guest-side proxy for hub actions executed on the collab host. */
+export interface AgentHubRemote {
+    chat(id: string, text: string): void;
+    kill(id: string): void;
+    revive(id: string): void;
+    /** Mirrors readFileIncremental: text from fromByte (complete JSONL lines), newSize = next fromByte base; null = unavailable. */
+    readTranscript(id: string, fromByte: number): Promise<{
+        text: string;
+        newSize: number;
+    } | null>;
+}
 export interface AgentHubDeps {
     /** Progress/status snapshot source (task lifecycle + progress channels). */
     observers: SessionObserverRegistry;
@@ -17,6 +28,8 @@ export interface AgentHubDeps {
     lifecycle?: AgentLifecycleManager;
     /** Injectable for tests; defaults to the process-global bus. */
     irc?: IrcBus;
+    /** Collab guest: route actions/transcripts to the host instead of local sessions. */
+    remote?: AgentHubRemote;
 }
 export declare class AgentHubOverlayComponent extends Container {
     #private;

package/dist/types/modes/components/collab-prompt-message.d.ts

@@ -0,0 +1,10 @@
+import { Container } from "@oh-my-pi/pi-tui";
+import type { CollabPromptDetails } from "../../collab/protocol";
+import type { CustomMessage } from "../../session/messages";
+/**
+ * Renders a collab guest prompt on every participant's transcript: a
+ * user-message-styled bubble prefixed with the author's name.
+ */
+export declare class CollabPromptMessageComponent extends Container {
+    constructor(message: CustomMessage<CollabPromptDetails>);
+}

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 "@oh-my-pi/pi-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;
 }

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/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/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[];
+}