@oh-my-pi/pi-coding-agent 16.4.6 → 16.5.0

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

@@ -11,6 +11,11 @@ export interface Args {
     smol?: string;
     slow?: string;
     plan?: string;
+    prewalk?: boolean;
+    noPrewalk?: boolean;
+    prewalkInto?: string;
+    planYolo?: boolean;
+    planYoloInto?: string;
     maxTime?: number;
     apiKey?: string;
     systemPrompt?: string;

package/dist/types/cli/gallery-fixtures/shell.d.ts

@@ -1,3 +1,3 @@
-/** Gallery fixtures for the shell tools (bash, eval). */
+/** Gallery fixtures for the shell tools (bash, eval, launch). */
 import type { GalleryFixture } from "./types.js";
 export declare const shellFixtures: Record<string, GalleryFixture>;

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

@@ -25,6 +25,21 @@ export default class Index extends Command {
         plan: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
             description: string;
         };
+        prewalk: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "no-prewalk": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "prewalk-into": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "plan-yolo": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "plan-yolo-into": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
         provider: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
             description: string;
         };

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

@@ -95,7 +95,7 @@ export declare function parseModelPattern(pattern: string, availableModels: Mode
     allowInvalidThinkingSelectorFallback?: boolean;
 }): ParsedModelResult;
 /**
- * Expand a role alias like "pi/smol" to the configured model string.
+ * Expand a role alias like "@smol" to the configured model string.
  */
 export declare function expandRoleAlias(value: string, settings?: Settings): string;
 export declare function resolveConfiguredModelPatterns(value: string | string[] | undefined, settings?: Settings): string[];
@@ -202,7 +202,7 @@ export declare function resolveAdvisorRoleSelection(settings: Settings, availabl
  * The algorithm tries to match the full pattern first, then progressively
  * strips colon-suffixes to find a match.
  */
-export declare function resolveModelScope(patterns: string[], modelRegistry: Pick<ModelRegistry, "getAvailable">, preferences?: ModelMatchPreferences): Promise<ScopedModel[]>;
+export declare function resolveModelScope(patterns: string[], modelRegistry: Pick<ModelRegistry, "getAvailable">, preferences?: ModelMatchPreferences, settings?: Settings): Promise<ScopedModel[]>;
 /**
  * Resolve the set of models a session is allowed to use, given the active
  * settings. Starts from `modelRegistry.getAvailable()` (so disabled providers
@@ -232,7 +232,7 @@ export declare function resolveAllowedModels(modelRegistry: Pick<ModelRegistry,
  * a UI picker should treat an empty list as "hide the picker entry", matching how the SDK
  * surfaces the same misconfiguration during session initialization.
  */
-export declare function filterAvailableModelsByEnabledPatterns(available: Model<Api>[], patterns: readonly string[]): Model<Api>[];
+export declare function filterAvailableModelsByEnabledPatterns(available: Model<Api>[], patterns: readonly string[], settings?: Settings): Model<Api>[];
 export interface ResolveCliModelResult {
     model: Model<Api> | undefined;
     selector?: string;
@@ -247,6 +247,7 @@ export declare function resolveCliModel(options: {
     cliProvider?: string;
     cliModel?: string;
     modelRegistry: CliModelRegistry;
+    settings?: Settings;
     preferences?: ModelMatchPreferences;
 }): ResolveCliModelResult;
 export interface InitialModelResult {

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

@@ -3,6 +3,14 @@
  */
 import { type ThemeColor } from "../modes/theme/theme.js";
 import type { Settings } from "./settings.js";
+/** Canonical prefix for a configured model role selector. */
+export declare const MODEL_ROLE_ALIAS_PREFIX = "@";
+/** Legacy prefix accepted for backwards-compatible role selectors. */
+export declare const LEGACY_MODEL_ROLE_ALIAS_PREFIX = "pi/";
+/** Shorthand selector for the default model role. */
+export declare const DEFAULT_MODEL_ROLE_ALIAS = "*";
+/** Format a model role as its canonical selector. */
+export declare function formatModelRoleAlias(role: string): string;
 export type ModelRole = "default" | "smol" | "slow" | "vision" | "plan" | "designer" | "commit" | "tiny" | "task" | "advisor";
 export interface ModelRoleInfo {
     tag?: string;

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

@@ -176,6 +176,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Pair a second model (assigned to the 'advisor' role) that passively reviews each turn and injects notes.";
         };
     };
+    readonly "prewalk.enabled": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Prewalk";
+            readonly label: "Enable Prewalk";
+            readonly description: "Start on the active model, then switch to a fast/cheap model (default the 'smol' role) at the first edit/write after the plan nudge's todo list exists — the strong model plans, commits the todos, and starts the implementation before handing off. Overridable per session with --prewalk / --no-prewalk.";
+        };
+    };
     readonly "advisor.subagents": {
         readonly type: "boolean";
         readonly default: false;
@@ -806,6 +816,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Remove the 1-character horizontal padding from the left and right of the terminal output";
         };
     };
+    readonly "tui.scrollbackRebuild": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "appearance";
+            readonly group: "Display";
+            readonly label: "Rewrite Scrollback";
+            readonly description: "Erase and replay terminal scrollback when a block's final form replaces its live preview. When off (default), stale preview copies remain in history and the final content is appended below.";
+        };
+    };
     readonly "display.shimmer": {
         readonly type: "enum";
         readonly values: readonly ["classic", "kitt", "disabled"];
@@ -860,6 +880,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Show a divider above an assistant turn whose request lost (missed) the prompt cache";
         };
     };
+    readonly "display.collapseCompacted": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "appearance";
+            readonly group: "Display";
+            readonly label: "Collapse Compacted History";
+            readonly description: "Collapse pre-compaction history behind the summary divider on the live transcript; disable to keep the full transcript inline with dividers at each compaction point";
+        };
+    };
     readonly showHardwareCursor: {
         readonly type: "boolean";
         readonly default: true;
@@ -1241,7 +1271,7 @@ export declare const SETTINGS_SCHEMA: {
     readonly textVerbosity: {
         readonly type: "enum";
         readonly values: readonly ["low", "medium", "high"];
-        readonly default: "high";
+        readonly default: "medium";
         readonly ui: {
             readonly tab: "model";
             readonly group: "Sampling";
@@ -1254,11 +1284,11 @@ export declare const SETTINGS_SCHEMA: {
             }, {
                 readonly value: "medium";
                 readonly label: "Medium";
-                readonly description: "Balance brevity and detail";
+                readonly description: "Balance brevity and detail (default)";
             }, {
                 readonly value: "high";
                 readonly label: "High";
-                readonly description: "Prefer detailed responses (default)";
+                readonly description: "Prefer detailed responses";
             }];
         };
     };
@@ -2690,7 +2720,7 @@ export declare const SETTINGS_SCHEMA: {
             readonly tab: "memory";
             readonly group: "Mnemopi";
             readonly label: "Mnemopi LLM Mode";
-            readonly description: "Use no LLM, the online tiny model (the TINY role from /models, else pi/smol), or a remote OpenAI-compatible endpoint";
+            readonly description: "Use no LLM, the online tiny model (the TINY role from /models, else @smol), or a remote OpenAI-compatible endpoint";
             readonly condition: "mnemopiActive";
             readonly options: readonly [{
                 readonly value: "none";
@@ -2699,7 +2729,7 @@ export declare const SETTINGS_SCHEMA: {
             }, {
                 readonly value: "smol";
                 readonly label: "Online (tiny)";
-                readonly description: "Use the online tiny model (the TINY role from /models, else pi/smol)";
+                readonly description: "Use the online tiny model (the TINY role from /models, else @smol)";
             }, {
                 readonly value: "remote";
                 readonly label: "Remote";
@@ -3649,6 +3679,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Enable the debug tool for DAP-based debugging";
         };
     };
+    readonly "launch.enabled": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly group: "Available Tools";
+            readonly label: "Launch";
+            readonly description: "Enable the launch tool for supervising shared long-running project processes";
+        };
+    };
     readonly "speechgen.enabled": {
         readonly type: "boolean";
         readonly default: false;
@@ -4587,14 +4627,6 @@ export declare const SETTINGS_SCHEMA: {
                 readonly value: "duckduckgo";
                 readonly label: "DuckDuckGo";
                 readonly description: "Credential-free best-effort fallback; may be bot-challenged on datacenter/shared-egress IPs";
-            }, {
-                readonly value: "bing";
-                readonly label: "Bing";
-                readonly description: "Credential-free HTML scrape of Bing results; may be bot-challenged";
-            }, {
-                readonly value: "yahoo";
-                readonly label: "Yahoo";
-                readonly description: "Credential-free HTML scrape of Yahoo (Bing-backed) results";
             }, {
                 readonly value: "ecosia";
                 readonly label: "Ecosia";
@@ -4833,7 +4865,7 @@ export declare const SETTINGS_SCHEMA: {
             readonly tab: "providers";
             readonly group: "Tiny Model";
             readonly label: "Tiny Model";
-            readonly description: "Session-title model: online (the TINY role from /models, else pi/smol) by default, or a local on-device model";
+            readonly description: "Session-title model: online (the TINY role from /models, else @smol) by default, or a local on-device model";
             readonly options: ({
                 value: "online";
                 label: string;

package/dist/types/extensibility/extensions/types.d.ts

@@ -257,7 +257,7 @@ export interface ExtensionModelQuery {
     /** The current session model, if one is set. */
     current(): Model | undefined;
     /**
-     * Resolve a model string (`provider/id`, bare id) or role alias (`pi/slow`, a
+     * Resolve a model string (`provider/id`, bare id) or role alias (`@slow`, a
      * configured role) to a Model, using the same settings-backed aliases and match
      * preferences as core selection. Thinking/routing suffixes are accepted and resolved
      * to the base model (pass effort separately). Returns undefined when nothing matches.

package/dist/types/launch/broker.d.ts

@@ -0,0 +1,2 @@
+/** Start the detached per-project daemon broker selected by the CLI worker host. */
+export declare function startDaemonBrokerFromEnvironment(): Promise<void>;

package/dist/types/launch/client.d.ts

@@ -0,0 +1,22 @@
+import { type DaemonOperation, type DaemonRpcResult } from "./protocol.js";
+/** Broker location and lifecycle overrides used by smoke tests and isolated consumers. */
+export interface DaemonBrokerClientOptions {
+    /** Runtime directory override; defaults to the project-scoped config path. */
+    runtimeDir?: string;
+    /** Last-client shutdown grace override in milliseconds. */
+    idleGraceMs?: number;
+}
+/** Persistent per-process connection to one project's daemon broker. */
+export interface DaemonBrokerClient {
+    readonly projectDir: string;
+    request(operation: DaemonOperation, signal?: AbortSignal): Promise<DaemonRpcResult>;
+    close(): void;
+}
+/** Create an independent socket connection to one project's shared daemon broker. */
+export declare function createDaemonBrokerClient(projectDir: string, options?: DaemonBrokerClientOptions): Promise<DaemonBrokerClient>;
+/** Get the process-shared daemon broker client for one canonical project directory. */
+export declare function daemonClientForProject(projectDir: string): Promise<DaemonBrokerClient>;
+/** Close every project broker connection held by this omp process. */
+export declare function closeDaemonClients(): Promise<void>;
+/** Exercise worker-host broker startup and authenticated RPC for distribution smoke tests. */
+export declare function smokeTestDaemonBroker(): Promise<void>;

package/dist/types/launch/paths.d.ts

@@ -0,0 +1,4 @@
+/** Resolve the private runtime directory shared by omp processes in one project directory. */
+export declare function daemonRuntimeDir(projectDir: string, configRoot?: string): string;
+/** Resolve the Unix socket or Windows named pipe used by one project broker. */
+export declare function daemonBrokerEndpoint(projectDir: string, runtimeDir: string): string;

package/dist/types/launch/presence.d.ts

@@ -0,0 +1,8 @@
+/** Handle keeping one omp process registered in a project daemon scope. */
+export interface DaemonProjectPresence {
+    close(): Promise<void>;
+}
+/** Register this omp process so project daemons survive while it remains alive. */
+export declare function registerDaemonProjectPresence(projectDir: string, runtimeOverride?: string): Promise<DaemonProjectPresence>;
+/** Return whether a registered omp process in this runtime directory is still alive. */
+export declare function hasLiveDaemonProjectPresence(runtimeDir: string): Promise<boolean>;

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

@@ -0,0 +1,170 @@
+/**
+ * Cross-process daemon broker protocol shared by the tool, client, and broker.
+ */
+/** Hidden CLI selector used to re-enter the daemon broker worker. */
+export declare const DAEMON_BROKER_WORKER_ARG = "__omp_worker_daemon_broker";
+/** Fixed dimensions negotiated with every supervised PTY. */
+export declare const DAEMON_PTY_COLUMNS = 120;
+export declare const DAEMON_PTY_ROWS = 40;
+/** Environment key carrying the broker's canonical project directory. */
+export declare const DAEMON_PROJECT_DIR_ENV = "OMP_DAEMON_PROJECT_DIR";
+/** Environment key carrying the broker's private runtime directory. */
+export declare const DAEMON_RUNTIME_DIR_ENV = "OMP_DAEMON_RUNTIME_DIR";
+/** Optional environment key overriding last-client shutdown grace. */
+export declare const DAEMON_IDLE_GRACE_ENV = "OMP_DAEMON_IDLE_GRACE_MS";
+/** Stable lifecycle states exposed by the launch tool. */
+export type DaemonState = "starting" | "running" | "ready" | "restarting" | "stopping" | "exited" | "failed";
+/** Restart behavior applied after an unexpected daemon exit. */
+export type DaemonRestartPolicy = "no" | "on-failure" | "always";
+/** Readiness conditions; every configured condition must pass. */
+export interface DaemonReadySpec {
+    log?: string;
+    port?: number;
+    host?: string;
+    timeoutMs: number;
+}
+/** Immutable launch specification retained for restart and inspection. */
+export interface DaemonSpec {
+    name: string;
+    application: string;
+    args: string[];
+    env: Record<string, string>;
+    cwd: string;
+    pty: boolean;
+    ready?: DaemonReadySpec;
+    restart: DaemonRestartPolicy;
+    persist: boolean;
+    detached: boolean;
+}
+/** Serializable daemon state visible to every client in one project directory. */
+export interface DaemonSnapshot {
+    name: string;
+    id: string;
+    state: DaemonState;
+    pid?: number;
+    createdAt: number;
+    startedAt: number;
+    readyAt?: number;
+    exitedAt?: number;
+    exitCode?: number;
+    exitReason?: string;
+    restartCount: number;
+    outputBytes: number;
+    owner?: string;
+    readyMatch?: string;
+    /** Readiness conditions still unmet while `state` is `starting`; absent once ready or without a ready spec. */
+    readyPending?: ("log" | "port")[];
+    persist: boolean;
+    detached: boolean;
+}
+/** Signals accepted by daemon input operations. */
+export type DaemonSignal = "SIGINT" | "SIGTERM" | "SIGHUP" | "SIGQUIT" | "SIGKILL";
+/** Typed broker operation sent over the authenticated socket. */
+export type DaemonOperation = {
+    op: "ping";
+} | {
+    op: "start";
+    spec: DaemonSpec;
+    owner?: string;
+} | {
+    op: "list";
+} | {
+    op: "logs";
+    name: string;
+    lines: number;
+    head: boolean;
+    grep?: string;
+    follow: boolean;
+    cursor?: number;
+    timeoutMs: number;
+} | {
+    op: "wait";
+    name: string;
+    for: "ready" | "exit";
+    pattern?: string;
+    timeoutMs: number;
+} | {
+    op: "send";
+    name: string;
+    data?: string;
+    signal?: DaemonSignal;
+} | {
+    op: "stop";
+    name: string;
+    timeoutMs: number;
+} | {
+    op: "restart";
+    name: string;
+} | {
+    op: "describe";
+    name: string;
+} | {
+    op: "shutdown";
+};
+/** Typed broker result decoded before it reaches tool code. */
+export type DaemonRpcResult = {
+    op: "ping";
+    projectDir: string;
+} | {
+    op: "start";
+    daemon: DaemonSnapshot;
+    readyTimedOut: boolean;
+} | {
+    op: "list";
+    daemons: DaemonSnapshot[];
+} | {
+    op: "logs";
+    name: string;
+    text: string;
+    /** Raw PTY byte stream used only to reconstruct the terminal screen. */
+    terminalText?: string;
+    cursor: number;
+    timedOut: boolean;
+    state: DaemonState;
+} | {
+    op: "wait";
+    daemon: DaemonSnapshot;
+    matched?: string;
+    timedOut: boolean;
+} | {
+    op: "send";
+    daemon: DaemonSnapshot;
+} | {
+    op: "stop";
+    daemon: DaemonSnapshot;
+} | {
+    op: "restart";
+    daemon: DaemonSnapshot;
+} | {
+    op: "describe";
+    daemon: DaemonSnapshot;
+    spec: DaemonSpec;
+} | {
+    op: "shutdown";
+};
+/** Authenticated request envelope used by socket clients. */
+export interface DaemonWireRequest {
+    id: string;
+    token: string;
+    operation: DaemonOperation;
+}
+/** Response envelope kept raw until matched with its pending operation. */
+export type DaemonWireResponse = {
+    id: string;
+    ok: true;
+    result: unknown;
+} | {
+    id: string;
+    ok: false;
+    error: string;
+};
+/** Decode and validate a daemon launch specification. */
+export declare function parseDaemonSpec(value: unknown): DaemonSpec;
+/** Decode and validate one daemon snapshot. */
+export declare function parseDaemonSnapshot(value: unknown): DaemonSnapshot;
+/** Decode a socket request before the broker acts on it. */
+export declare function parseDaemonWireRequest(value: unknown): DaemonWireRequest;
+/** Decode a socket response envelope before resolving a pending call. */
+export declare function parseDaemonWireResponse(value: unknown): DaemonWireResponse;
+/** Decode a broker result using its pending operation as the discriminator. */
+export declare function parseDaemonRpcResult(operation: DaemonOperation, value: unknown): DaemonRpcResult;

package/dist/types/launch/terminal-output.d.ts

@@ -0,0 +1,7 @@
+/** Controls which virtual terminal rows a launch log exposes. */
+export interface TerminalOutputOptions {
+    head: boolean;
+    maxRows: number;
+}
+/** Replays daemon bytes with the same xterm screen renderer used by PTY mode. */
+export declare function renderTerminalOutput(output: string, options: TerminalOutputOptions): Promise<string[] | undefined>;

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

@@ -1,4 +1,4 @@
-import type { AgentTool } from "@oh-my-pi/pi-agent-core";
+import { type AgentTool } from "@oh-my-pi/pi-agent-core";
 import { Container, type TUI } from "@oh-my-pi/pi-tui";
 import type { KeyId } from "../../config/keybindings.js";
 import type { MessageRenderer } from "../../extensibility/extensions/types.js";

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

@@ -18,6 +18,7 @@ export * from "./login-dialog.js";
 export * from "./logout-account-selector.js";
 export * from "./model-browser.js";
 export * from "./model-hub.js";
+export * from "./model-picker.js";
 export * from "./oauth-selector.js";
 export * from "./queue-mode-selector.js";
 export * from "./read-tool-group.js";

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

@@ -3,12 +3,15 @@ import { type Component, type SgrMouseEvent } from "@oh-my-pi/pi-tui";
 import type { Settings } from "../../config/settings.js";
 import type { ModelPerfStats } from "../../session/agent-storage.js";
 import { type ConfiguredThinkingLevel } from "../../thinking.js";
-/** One selectable model row. `selector` is the canonical `provider/id` key. */
+import { type ThemeColor } from "../theme/theme.js";
+/** One selectable row. `selector` is a canonical model key or host-specific virtual key. */
 export interface ModelBrowserItem {
     provider: string;
     id: string;
     model: Model;
     selector: string;
+    /** Optional foreground color for the row label. */
+    labelColor?: ThemeColor;
 }
 /** Resolved role assignment as displayed by the browser and the hub. */
 export interface RoleAssignment {
@@ -19,6 +22,13 @@ export interface RoleAssignment {
 }
 /** Map of role id to its resolved assignment (absent roles are unresolved). */
 export type RoleAssignments = Record<string, RoleAssignment | undefined>;
+/**
+ * Resolve every known role to its display assignment: configured role values
+ * resolve against `allModels`; unconfigured roles fall back to auto-selection
+ * over `autoCandidates` (skipped when empty). Shared by the /models hub and
+ * the alt+p session picker.
+ */
+export declare function resolveRoleAssignments(settings: Settings, allModels: ReadonlyArray<Model>, autoCandidates: ReadonlyArray<Model>): RoleAssignments;
 /** Wrap raw models into browser items. */
 export declare function buildBrowserItems(models: ReadonlyArray<Model>): ModelBrowserItem[];
 /** Options for {@link sortModelItems}. */
@@ -54,7 +64,6 @@ export interface ModelBrowserOptions {
     disableOverContext?: boolean;
     /** Host-provided empty-state text (e.g. provider discovery status). */
     emptyText?: () => string | undefined;
-    initialQuery?: string;
 }
 /**
  * The reusable browser component. Renders a fixed-height block
@@ -70,6 +79,8 @@ export declare class ModelBrowser implements Component {
     /** Cancel key with an empty query (a non-empty query is cleared first). */
     onCancel?: () => void;
     constructor(settings: Settings, options?: ModelBrowserOptions);
+    /** Mark `selector` as the session's active model (undefined clears the mark). */
+    setCurrentSelector(selector: string | undefined): void;
     /** Replace the scope's base items; the live query re-applies and selection is pinned by selector. */
     setItems(items: ModelBrowserItem[]): void;
     setRoles(roles: RoleAssignments): void;
@@ -78,6 +89,12 @@ export declare class ModelBrowser implements Component {
     setPerfStats(perf: ReadonlyMap<string, ModelPerfStats>): void;
     setMaxVisible(rows: number): void;
     setShowProvider(show: boolean): void;
+    /** Keep the source order after fuzzy filtering instead of applying model-specific ranking. */
+    setPreserveQueryOrder(preserve: boolean): void;
+    /** Allow hosts to toggle context-window eligibility between browser modes. */
+    setDisableOverContext(disable: boolean): void;
+    /** Focused: accent cursor + selected-row background band. Unfocused: dim cursor, no band. */
+    setFocused(focused: boolean): void;
     /** Total rendered height for the current `maxVisible` (host layout budgeting). */
     get renderedRows(): number;
     get query(): string;
@@ -86,7 +103,13 @@ export declare class ModelBrowser implements Component {
     get visibleCount(): number;
     /** Move selection to `selector`; false when it is not in the current view. */
     selectSelector(selector: string): boolean;
-    moveSelection(delta: number): void;
+    /**
+     * Move the selection by `delta` rows, skipping disabled rows. Single steps
+     * wrap at the ends; `wrap: false` (page/home/end jumps) clamps instead.
+     */
+    moveSelection(delta: number, options?: {
+        wrap?: boolean;
+    }): void;
     handleInput(data: string): void;
     /** Cancel-key ladder: clear a non-empty query first, then bubble to the host. */
     handleCancel(): void;
@@ -95,6 +118,8 @@ export declare class ModelBrowser implements Component {
      * row (the search row).
      */
     routeMouse(event: SgrMouseEvent, line: number): void;
+    /** Drop the hover band. Hosts call this when the pointer leaves the browser pane. */
+    clearHover(): void;
     render(width: number): string[];
     invalidate(): void;
 }

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

@@ -3,8 +3,6 @@ import { type Component, type TUI } from "@oh-my-pi/pi-tui";
 import type { ModelRegistry } from "../../config/model-registry.js";
 import type { Settings } from "../../config/settings.js";
 import { type ConfiguredThinkingLevel } from "../../thinking.js";
-/** `roles` is the full /models hub; `pick` is a one-shot session/embedded picker. */
-export type ModelHubMode = "roles" | "pick";
 /** A `--models` scope entry (mirrors the session's scoped model list). */
 export interface ScopedModelItem {
     model: Model;
@@ -17,8 +15,6 @@ export interface ModelHubCallbacks {
     onUnassign: (role: string) => void;
     /** Persist a `retry.fallbackChains` entry — keyed by a role, `provider/model-id`, or `provider/*`; an empty chain clears the key. */
     onFallbackChainChange?: (role: string, chain: string[]) => void;
-    /** Pick-mode activation: session-only switch or embedded pick. */
-    onPick?: (model: Model, selector: string) => void;
     /** Locked provider activation: forward to the /login flow. */
     onLoginRequest?: (providerId: string) => void;
     /** Persist a new quick-switch cycle order (the ctrl+p role cycle). */
@@ -26,14 +22,8 @@ export interface ModelHubCallbacks {
     onCancel: () => void;
 }
 export interface ModelHubOptions {
-    mode?: ModelHubMode;
-    /** Session token count; in pick mode, models with smaller context windows are disabled. */
-    currentContextTokens?: number;
     /** Preselect this provider's sidebar entry (e.g. when reopening after /login). */
     initialProviderId?: string;
-    /** Status-row hint shown in pick mode. */
-    pickerHint?: string;
-    initialQuery?: string;
 }
 /** Test hook: forget which providers were auto-refreshed this process. */
 export declare function resetProviderAutoRefreshGuard(): void;

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

@@ -0,0 +1,44 @@
+/**
+ * Compact session-model picker (alt+p / `/switch`): a bottom-anchored
+ * floating overlay hosting just a {@link ModelBrowser} — no provider sidebar.
+ * Model entries switch the current session only; a search beginning with `@`
+ * exposes the configured ctrl+p quick roles.
+ */
+import type { Model } from "@oh-my-pi/pi-ai";
+import type { Component, TUI } from "@oh-my-pi/pi-tui";
+import type { ModelRegistry } from "../../config/model-registry.js";
+import type { Settings } from "../../config/settings.js";
+import type { ResolvedRoleModel } from "../../session/agent-session.js";
+import type { ScopedModelItem } from "./model-hub.js";
+export interface ModelPickerCallbacks {
+    /** A model was chosen for a session-only switch. `selector` is `provider/id`. */
+    onPick: (model: Model, selector: string) => void;
+    /** A configured ctrl+p quick role was chosen. */
+    onPickRole?: (entry: ResolvedRoleModel) => void;
+    /** The picker was dismissed. */
+    onCancel: () => void;
+}
+export interface ModelPickerOptions {
+    /** Session token count; models with smaller context windows are disabled. */
+    currentContextTokens?: number;
+    /** `provider/id` of the session's active model; highlighted and preselected. */
+    currentSelector?: string;
+    /** Resolved role models in the same order used by the ctrl+p quick-role cycle. */
+    quickRoles?: ReadonlyArray<ResolvedRoleModel>;
+    /** Complete ctrl+p order, including unavailable roles, to preserve segment colors. */
+    quickRoleOrder?: ReadonlyArray<string>;
+    /** Active quick role, highlighted when the search begins with `@`. */
+    currentQuickRole?: string;
+}
+/**
+ * The alt+p picker component. Hosted as a non-fullscreen bottom-anchored
+ * overlay (`ui.showOverlay(..., { anchor: "bottom-center" })`); keyboard-only,
+ * since mouse tracking is reserved for fullscreen overlays.
+ */
+export declare class ModelPickerComponent implements Component {
+    #private;
+    constructor(tui: TUI, settings: Settings, registry: ModelRegistry, scopedModels: ReadonlyArray<ScopedModelItem>, callbacks: ModelPickerCallbacks, options?: ModelPickerOptions);
+    invalidate(): void;
+    handleInput(data: string): void;
+    render(width: number): string[];
+}

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

@@ -23,6 +23,8 @@ export interface PlanReviewOverlayCallbacks {
     onPick: (label: string) => void;
     /** Invoked on Esc / cancel. */
     onCancel: () => void;
+    /** Invoked with the current full plan text when the copy hotkey is pressed. */
+    onCopyPlan?: (content: string) => void | Promise<void>;
     /** Invoked when the external-editor key is pressed (overlay stays open). */
     onExternalEditor?: () => void;
     /** Invoked when the external-editor key edits the active annotation draft. */

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

@@ -60,6 +60,9 @@ export interface SegmentContext {
         enabled: boolean;
         paused: boolean;
     } | null;
+    prewalk: {
+        enabled: boolean;
+    } | null;
     loopMode: {
         enabled: boolean;
     } | null;