@oh-my-pi/pi-coding-agent 15.9.67 → 15.10.0

package/CHANGELOG.md

@@ -2,7 +2,69 @@
 
 ## [Unreleased]
 
+## [15.10.0] - 2026-06-06
+
+### Breaking Changes
+
+- Replaced the `providers.parallelFetch` boolean setting with the `providers.fetch` enum (`auto` / `native` / `trafilatura` / `lynx` / `parallel` / `jina`) that selects the URL reader-backend priority for the `read`/`fetch` tool, mirroring `providers.image`/`providers.webSearch`. Existing configs are migrated automatically: the legacy key is dropped and the new `auto` default applies.
+
+### Added
+
+- Added a GitHub Actions read handler to the `read`/web-fetch GitHub scraper. Fetching `github.com/{owner}/{repo}/actions/runs/{id}` renders the run metadata plus a per-job breakdown (steps listed for any job that did not succeed), and `…/actions/runs/{id}/job/{id}` (also the API-style `…/jobs/{id}`) renders a single job's metadata, step table, and full plain-text logs. Logs are fetched via the `actions/jobs/{id}/logs` redirect using `GITHUB_TOKEN`/`GH_TOKEN` when present, with the per-line ISO timestamp prefix and leading BOM stripped; the section degrades to an explicit notice when logs are unavailable (no token, private repo, or expired/unfinalized run).
+
+### Changed
+
+- Changed eval `agent()` subagents so they are never subject to the `task.maxRuntimeMs` wall-clock cap. The parent cell's idle watchdog is already suspended for the entire bridge call (`withBridgeTimeoutPause`), so a long-running fan-out/recovery workflow must not be killed by a per-subagent runtime limit. `runEvalAgent` now passes `maxRuntimeMs: 0` to `runSubprocess`, which honors an explicit `ExecutorOptions.maxRuntimeMs` override over the inherited setting.
+- Changed interactive timing behavior so `PI_TIMING=x pi` preloads the module timer before the CLI graph loads and includes the `(modules)` report. `PI_TIMING=full` now also exits after printing, matching `PI_TIMING=x`, so full module reports are usable for cold-start measurement without launching the TUI. Added the root `dev:timing` script for the same profiled startup path.
+- Changed coding-agent startup imports so normal TUI launch imports `InteractiveMode` directly, keeps print/RPC/ACP runners on their branch-only paths, and moves marketplace auto-update work behind a lightweight deferred starter.
+- Changed cold-launch setup gating so the full setup wizard (every scene plus the overlay and their TUI/OAuth/web-search/theme dependencies) is no longer statically imported by `main.ts`. The current setup version now lives in a tiny dependency-free `modes/setup-version` module, and the wizard barrel is lazy-loaded only when the stored setup version is stale or the wizard is forced — the common up-to-date launch skips loading it entirely.
+- Changed cold-launch startup imports so the hot-path CLI files no longer pull the full `@oh-my-pi/pi-ai` barrel: `commands/launch.ts` and `cli/args.ts` import `THINKING_EFFORTS`/`Effort` from the tiny `@oh-my-pi/pi-ai/effort` module, and `config/model-registry.ts` now imports its ~20 symbols from narrow subpaths (`api-registry`, `model-cache`, `model-manager`, `model-thinking`, `models`, `provider-models`, `types`, `utils/event-stream`) instead of the barrel — so launching no longer eagerly loads every provider, auth, OAuth, and usage module re-exported by the barrel.
+- Changed the `read`/`fetch` HTML reader-backend priority to `native > trafilatura > lynx > parallel > jina` (was `parallel > jina > trafilatura > lynx > native`). The in-process native `htmlToMarkdown` runs first — instant, no network, full-fidelity — so the common case no longer depends on a remote service, and a stalled remote backend can no longer mask it. Selecting a specific backend via `providers.fetch` tries it first, then the rest fall back. The low-quality gate (`>100` chars and not `isLowQualityOutput`) now applies uniformly to every backend; when none clears it, the highest-priority substantial-but-low-quality output is still surfaced so the `llms.txt` / document-extraction fallbacks keep running.
+
+### Fixed
+
+- Fixed eval `agent()` failures surfacing as an opaque `RuntimeError: bridge call '__agent__' failed` with no reason. When a subagent aborted, `runEvalAgent` built its failure message with `result.error ?? result.stderr ?? result.abortReason ?? …`, but `result.stderr` is the empty string on a clean abort (and `result.error` is gated on a non-empty `stderr`), so the nullish chain stopped at `""` and never reached `abortReason`. The empty string propagated through the loopback bridge and the Python prelude's `RuntimeError(msg or "bridge call … failed")`, discarding the real reason. The chain now uses `||` so an empty `stderr` falls through to `abortReason`.
+- Fixed subagent aborts being mislabeled as the generic "Cancelled by caller" when the abort originated inside the subagent's own turn (`stopReason: "aborted"` with no caller signal and no runtime-limit timer). `runSubprocess` now prefers the aborted assistant message's `errorMessage` (e.g. "Request was aborted" or a specific stream error) for that case, while a real caller signal or wall-clock abort still reports its precise reason.
+- Fixed a long streaming tool preview that alone overflows the viewport dropping its scrolled-off head on ED3-risk terminals (ghostty/kitty/iTerm2/…). When expanded with `Ctrl+O`, a streaming `write` (content streaming in) and a streaming `eval` (stdout streaming below its fixed code cell) render top-anchored and grow append-only, but the tool block never reported itself append-only to the transcript, so the renderer's commit-as-you-go boundary stopped at the block start and the earlier rows that scrolled above the viewport were committed nowhere — they vanished, leaving the preview looking like a viewport-tall circular buffer. `ToolExecutionComponent` now implements `isTranscriptBlockAppendOnly()` (gated on `isTranscriptBlockFinalized()`, so it also covers partial-result streams like `eval`), delegating to a renderer-declared `isStreamingPreviewAppendOnly` predicate so the expanded stream commits its head exactly like a streamed assistant reply. Collapsed previews (bounded sliding tail windows) and finalized/result previews (which can collapse to a capped view) stay deferred.
+- Fixed `read`/`fetch` silently dropping whole list sections on pages with malformed list markup — stray `<img>`, text, or `<video>` nodes as direct children of `<ul>` (e.g. the Alacritty changelog). The Jina reader (previously tried before the local renderers) mis-extracts such lists, returning empty `Added`/`Changed` sections; the native in-process renderer now runs first and preserves the full content.
+- Fixed `/usage` aggregate amount fallback using raw `limits.length` as account count — now counts unique `accountId` values from limit scopes, so N limits from a single account no longer display as "N accts".
+- Fixed `/usage` account labeling falling back to "account N" for providers that use `projectId` as their primary identity (e.g. Google Antigravity, Gemini CLI) — `projectId` from report metadata is now considered before the generic fallback.
+- Fixed the `todo` tool's TUI renderer crashing with `TypeError: args?.ops?.map is not a function` when a streaming tool-call delta surfaced a non-array `ops` field (mid-stream `parseStreamingJson` shapes like `{ ops: "[{" }`, or `[null]` entries before fields arrive). The renderer now treats non-array `ops`, non-object entries, and non-array `items` as missing structure instead of crashing, which also stops the spam-warn cascade that followed each malformed delta. Paired with the Anthropic-side reasoning-replay fix in `packages/ai` ([#2005](https://github.com/can1357/oh-my-pi/issues/2005)).
+- Fixed Python eval `agent()` collapsing subagent runtime-limit aborts (and other empty-stderr aborts) into a generic `RuntimeError: bridge call '__agent__' failed`. `runEvalAgent` coalesced the failure message with `??`, which stopped at the empty `stderr` and never reached `abortReason`, shipping an empty error through the loopback bridge. The bridge now prefers `abortReason` for aborts and trims empty `stderr`/`error` out of the fallback chain, so Python surfaces the actionable reason (e.g. `Subagent runtime limit exceeded (task.maxRuntimeMs=900000)`) ([#2006](https://github.com/can1357/oh-my-pi/issues/2006)).
+
+## [15.9.69] - 2026-06-06
+
+### Added
+
+- Added anonymous fallback for Perplexity web search, allowing `web_search` and explicit Perplexity provider usage when no Perplexity credentials are configured
+- Added `gallery` CLI command to render built-in tool renderer output across streaming, in-progress, success, and failure states
+- Added `omp gallery` filtering and rendering options (`--tool`, `--state`, `--width`, `--expanded`, and `--plain`) for focused renderer previews and plain-text output
+- Added `omp gallery` fidelity for tools whose renderers are attached on the tool instance (`lsp`, `task`): the gallery now drives them through the same custom-tool render branch production uses, so regressions in that path surface in the gallery rather than only in a live session.
+- Added `omp gallery --screenshot`, which renders the gallery through a real virtual terminal (VHS) and writes PNG screenshot(s) instead of ANSI, so agents (and anything that can only read raw bytes) can actually see the rendered output. The capture forces truecolor and matches the active theme/symbol preset; tall galleries split across multiple images (whole renderers are never cut). Tune with `--out`, `--font`, and `--font-size`; requires `vhs` on `PATH` and fails with install guidance when absent.
+- Added `app.display.reset`, bound to `Ctrl+L` by default, to force an immediate terminal display reset/redraw without resizing the window.
+
+### Changed
+
+- Changed authenticated Perplexity ask requests to default to the `experimental` model preference, matching the anonymous fallback.
+- Changed Perplexity explicit provider availability checks so the setup wizard can mark `perplexity` as available for manual selection without credentials, while auto provider discovery still requires auth
+- Changed the default persistent model selector shortcut from `Ctrl+L` to `Alt+M`, leaving `Ctrl+L` for display reset. Existing user remaps in `keybindings.yml` are preserved.
+- Changed the edit tool result header to carry the diff change stats (`+N / -M / K hunks`) inline next to the file path, and removed the redundant lone language-icon metadata row and the blank line between the header and the diff body, so a single-hunk edit renders as `✔ Edit: <icon> path:LINE ⟨+3 / 1 hunk⟩` immediately followed by the diff.
+- Changed the `web_search` tool result rendering: the answer text now shows in full instead of being truncated to a "… N more lines" preview (the `omp q` CLI still caps its compact output), each source renders as a single `title (domain) · age` line with the URL linked on the title (dropping the snippet and bare-URL rows), and the metadata block collapses to one `Provider: <model> @ <provider> (<auth>)` line plus `Usage:` (removing the redundant Sources/Citations/Request/Queries rows).
+
+### Fixed
+
+- Fixed Perplexity `perplexity_ask` response parsing so OAuth, cookie, and anonymous searches correctly extract answer text and sources from JSON payloads
+- Fixed framed read results rendering with an extra blank row above and below the output block.
+- Fixed collapsed search result previews that could show only "… N more matches" when the first grouped section exceeded the preview budget. Collapsed search output now compacts to match rows, fills the budget with visible hits before the summary, and keeps truncation details out of the bottom user-visible notice.
+- Fixed the expanded search result view dumping every match when all hits live in one file. A single file's matches collapse into one blank-line group, and the expanded tree list ignored the line budget, so a hot file whose matches span its whole length rendered every row (e.g. lines 374–2858). Expanded search output is now bounded by a larger-than-collapsed budget (`EXPANDED_LINES × 2`), keeps surrounding context rows, and appends a `… N more matches` summary when truncated.
+- Fixed boolean environment flag overrides that were ORed with settings, so `PI_INTENT_TRACING=0`, `PI_AUTO_QA=0`, and per-backend eval flags now take precedence when present while falling back to config when unset.
+- Fixed custom-rendered tools that set `mergeCallAndResult` (e.g. `lsp`) rendering a redundant tool-name line above the framed result once a result arrived. `ToolExecutionComponent`'s custom-tool branch now emits the fallback label only when the tool has no `renderCall` and the call is not suppressed by an existing result, matching the built-in renderer branch.
+- Fixed the `write` tool result rendering with a green success checkmark even when the write failed. `writeToolRenderer.renderResult` now branches on `result.isError`, rendering the error status icon plus the failure message instead of the success header and content preview.
+- Fixed Perplexity OAuth/cookie web search returning a refusal answer ("I don't currently have access to the web-search tools in this turn") despite returning real sources. `callPerplexityOAuth` was prepending the API-style `web-search` system prompt to the query (`query_str = systemPrompt + "\n\n" + query`), but the consumer `www.perplexity.ai/rest/sse/perplexity_ask` endpoint has no system-message slot and reads the prepended instruction as a meta-prompt, making the model decline. The OAuth/cookie path now sends the bare query; the API-key path still passes the system prompt as a proper `system` message.
+- Fixed Perplexity OAuth web search always returning the free `turbo` model instead of the account's Pro model (e.g. `pplx_pro_upgraded`/Sonar). The `www.perplexity.ai/rest/sse/perplexity_ask` endpoint authenticates via the `__Secure-next-auth.session-token` cookie and ignores the `Authorization: Bearer` header entirely — so sending the OAuth session token as a bearer was treated as an anonymous request, which silently downgrades to `turbo` regardless of `model_preference`. The stored Perplexity OAuth token is itself the next-auth session JWT (the macOS app injects the same value as that cookie), so `callPerplexityAsk` now sends it as the `__Secure-next-auth.session-token` cookie, unlocking Pro model selection.
+
 ## [15.9.67] - 2026-06-06
+
 ### Added
 
 - Added `timeout-pause` and `timeout-resume` eval bridge status events emitted around `agent()`/`llm()` operations
@@ -9434,4 +9496,4 @@ Initial public release.
 - Git branch display in footer
 - Message queueing during streaming responses
 - OAuth integration for Gmail and Google Calendar access
-- HTML export with syntax highlighting and collapsible sections
+- HTML export with syntax highlighting and collapsible sections

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

@@ -1,7 +1,7 @@
 /**
  * CLI argument parsing and help display
  */
-import { type Effort } from "@oh-my-pi/pi-ai";
+import { type Effort } from "@oh-my-pi/pi-ai/effort";
 export type Mode = "text" | "json" | "rpc" | "acp" | "rpc-ui";
 export interface Args {
     cwd?: string;

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

@@ -0,0 +1,43 @@
+import { type GalleryFixture } from "./gallery-fixtures";
+/** Lifecycle states the gallery renders, in display order. */
+export declare const GALLERY_STATES: readonly ["streaming", "progress", "success", "error"];
+export type GalleryState = (typeof GALLERY_STATES)[number];
+export interface GalleryCommandArgs {
+    /** Render width in columns (defaults to terminal width, clamped). */
+    width?: number;
+    /** Restrict to a single tool name. */
+    tool?: string;
+    /** Restrict to specific lifecycle states. */
+    states?: GalleryState[];
+    /** Render the expanded variant of each renderer. */
+    expanded?: boolean;
+    /** Strip ANSI styling from the output (useful when redirecting to a file). */
+    plain?: boolean;
+    /** Capture the rendered gallery as PNG screenshot(s) via VHS instead of printing ANSI. */
+    screenshot?: boolean;
+    /** Screenshot output path (single image) or base path (suffixed when split across images). */
+    out?: string;
+    /** Font family for screenshots (must be installed; Nerd Font recommended for icon glyphs). */
+    font?: string;
+    /** Font size in points for screenshots. */
+    fontSize?: number;
+}
+/** One tool's rendered lifecycle, as ANSI lines: a leading blank, the section rule, then each state. */
+export interface GallerySection {
+    heading: string;
+    lines: string[];
+}
+/** The curated fixture for a tool, or a generic one for registry tools lacking sample data. */
+export declare function resolveFixture(name: string): GalleryFixture;
+/**
+ * Render a single tool/state pair to lines. Builds a fresh component, drives it
+ * to the requested state, settles any async edit preview, then snapshots the
+ * render and stops all animation timers.
+ */
+export declare function renderGalleryState(name: string, fixture: GalleryFixture, state: GalleryState, width: number, expanded?: boolean): Promise<string[]>;
+/**
+ * Render the gallery. Iterates the renderer registry (or a single tool),
+ * printing each requested lifecycle state under a labeled section — or, with
+ * `screenshot`, capturing the rendered output as PNG(s) via VHS.
+ */
+export declare function runGalleryCommand(args: GalleryCommandArgs): Promise<void>;

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

@@ -0,0 +1,2 @@
+import type { GalleryFixture } from "./types";
+export declare const agenticFixtures: Record<string, GalleryFixture>;

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

@@ -0,0 +1,3 @@
+/** Gallery fixtures for the code-intelligence tools (lsp, debug). */
+import type { GalleryFixture } from "./types";
+export declare const codeintelFixtures: Record<string, GalleryFixture>;

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

@@ -0,0 +1,3 @@
+/** Gallery fixtures for the edit tools (edit, apply_patch, ast_edit). */
+import type { GalleryFixture } from "./types";
+export declare const editFixtures: Record<string, GalleryFixture>;

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

@@ -0,0 +1,2 @@
+import type { GalleryFixture } from "./types";
+export declare const fsFixtures: Record<string, GalleryFixture>;

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

@@ -0,0 +1,4 @@
+export * from "./types";
+export declare const galleryFixtures: {
+    [x: string]: import("./types").GalleryFixture;
+};

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

@@ -0,0 +1,3 @@
+/** Gallery fixtures for the todo / ask / resolve interaction tools. */
+import type { GalleryFixture } from "./types";
+export declare const interactionFixtures: Record<string, GalleryFixture>;

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

@@ -0,0 +1,2 @@
+import type { GalleryFixture } from "./types";
+export declare const memoryFixtures: Record<string, GalleryFixture>;

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

@@ -0,0 +1,3 @@
+/** Gallery fixtures for the ask / resolve / ssh / github / inspect_image tools. */
+import type { GalleryFixture } from "./types";
+export declare const miscFixtures: Record<string, GalleryFixture>;

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

@@ -0,0 +1,3 @@
+/** Gallery fixtures for the search tools (search, search_tool_bm25, ast_grep). */
+import type { GalleryFixture } from "./types";
+export declare const searchFixtures: Record<string, GalleryFixture>;

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

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

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

@@ -0,0 +1,44 @@
+/**
+ * Types for `omp gallery` sample data. See {@link ./index} for the aggregated
+ * fixture registry and the contract each fixture must satisfy.
+ */
+import type { EditMode } from "../../edit";
+/** A tool result snapshot, matching the shape `ToolExecutionComponent` consumes. */
+export interface GalleryResult {
+    content: Array<{
+        type: string;
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+    details?: unknown;
+    isError?: boolean;
+}
+export interface GalleryFixture {
+    /** Display label for the tool header (defaults to the tool name). */
+    label?: string;
+    /** Edit mode for edit-like tools so the streaming preview dispatches correctly. */
+    editMode?: EditMode;
+    /**
+     * Set for tools whose real `AgentTool` attaches `renderCall`/`renderResult`
+     * directly on the instance (e.g. `lsp`, `task`). The harness then attaches
+     * the registry renderer onto the fake tool so the component routes through
+     * the custom-tool branch — the same path production takes — instead of the
+     * built-in registry branch. The two branches can diverge, so exercising the
+     * real one keeps the gallery honest for these tools.
+     */
+    customRendered?: boolean;
+    /**
+     * Arguments shown during the streaming state — a partial view of {@link args}
+     * as if the tool-call JSON were still arriving. May include `__partialJson`
+     * for renderers (bash, edit) that surface fields before the object closes.
+     * Defaults to {@link args} when omitted.
+     */
+    streamingArgs?: unknown;
+    /** Complete arguments shown for the in-progress, success, and error states. */
+    args: unknown;
+    /** Successful result. */
+    result: GalleryResult;
+    /** Failed result. Falls back to a generic error when omitted. */
+    errorResult?: GalleryResult;
+}

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

@@ -0,0 +1,2 @@
+import type { GalleryFixture } from "./types";
+export declare const webFixtures: Record<string, GalleryFixture>;

package/dist/types/cli/gallery-screenshot.d.ts

@@ -0,0 +1,35 @@
+import type { GallerySection } from "./gallery-cli";
+/** Nerd Font family so the gallery's icon glyphs (PUA) render instead of tofu. */
+export declare const DEFAULT_SCREENSHOT_FONT = "JetBrainsMono Nerd Font";
+export declare const DEFAULT_SCREENSHOT_FONT_SIZE = 18;
+export interface GalleryScreenshotOptions {
+    /** Gallery render width in columns (matches the ANSI line width). */
+    width: number;
+    /** VHS `FontFamily`. */
+    font?: string;
+    /** VHS `FontSize`. */
+    fontSize?: number;
+    /**
+     * Output destination. When omitted, PNGs land in a fresh temp directory.
+     * With multiple images the path is suffixed (`name-01.png`, `name-02.png`).
+     */
+    out?: string;
+}
+/**
+ * Capture the gallery sections as one or more PNGs and return their absolute
+ * paths. Tall galleries are split across images so no single capture exceeds
+ * the terminal-canvas height limit.
+ */
+export declare function captureGalleryScreenshots(sections: GallerySection[], options: GalleryScreenshotOptions): Promise<string[]>;
+/**
+ * Resolve a chunk's PNG path. A single image keeps the bare name (or the exact
+ * `out`); multiple images gain a zero-padded `-NN` suffix so they sort and never
+ * collide.
+ */
+export declare function resolveScreenshotOutputPath(out: string | undefined, baseDir: string, index: number, total: number): string;
+/**
+ * Group whole tool sections into chunks that stay under `rowBudget` rows. A
+ * single section larger than the budget gets its own (taller) image rather than
+ * being split mid-renderer.
+ */
+export declare function chunkGallerySections(sections: GallerySection[], rowBudget: number): GallerySection[][];

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

@@ -0,0 +1,47 @@
+/**
+ * Render every built-in tool's renderer across its lifecycle states.
+ */
+import { Command } from "@oh-my-pi/pi-utils/cli";
+export default class Gallery extends Command {
+    static description: string;
+    static flags: {
+        tool: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            char: string;
+            description: string;
+        };
+        state: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            char: string;
+            description: string;
+            options: ("error" | "progress" | "streaming" | "success")[];
+            multiple: true;
+        };
+        width: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"integer"> & {
+            char: string;
+            description: string;
+        };
+        expanded: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            char: string;
+            description: string;
+            default: boolean;
+        };
+        plain: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+            default: boolean;
+        };
+        screenshot: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+            default: boolean;
+        };
+        out: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            char: string;
+            description: string;
+        };
+        font: import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "font-size": import("@oh-my-pi/pi-utils/cli").FlagDescriptor<"integer"> & {
+            description: string;
+        };
+    };
+    run(): Promise<void>;
+}

package/dist/types/config/keybindings.d.ts

@@ -8,6 +8,7 @@ interface AppKeybindings {
     "app.clear": true;
     "app.exit": true;
     "app.suspend": true;
+    "app.display.reset": true;
     "app.thinking.cycle": true;
     "app.thinking.toggle": true;
     "app.model.cycleForward": true;
@@ -191,6 +192,10 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "ctrl+z";
         readonly description: "Suspend application";
     };
+    readonly "app.display.reset": {
+        readonly defaultKeys: "ctrl+l";
+        readonly description: "Reset terminal display";
+    };
     readonly "app.thinking.cycle": {
         readonly defaultKeys: "shift+tab";
         readonly description: "Cycle thinking level";
@@ -208,7 +213,7 @@ export declare const KEYBINDINGS: {
         readonly description: "Cycle to previous model";
     };
     readonly "app.model.select": {
-        readonly defaultKeys: "ctrl+l";
+        readonly defaultKeys: "alt+m";
         readonly description: "Select model";
     };
     readonly "app.model.selectTemporary": {

package/dist/types/config/model-id-affixes.d.ts

@@ -5,6 +5,8 @@ export declare function getLongestModelLikeIdSegment(modelId: string): string |
  * upstream model id, e.g.
  *   "[Kiro] claude-opus-4-8"                -> "claude-opus-4-8"
  *   "[gcli转] gemini-3.1-pro-preview [假流]" -> "gemini-3.1-pro-preview"
+ *
+ * Candidates are returned most-stripped first: both ends, then leading-only, then trailing-only.
  */
 export declare function getBracketStrippedModelIdCandidates(modelId: string): string[];
 export declare function stripBracketedModelIdAffixes(modelId: string): string | undefined;

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

@@ -1,4 +1,6 @@
-import { type Api, type AssistantMessageEventStream, type Context, type Model, type ModelRefreshStrategy, type SimpleStreamOptions, type ThinkingConfig } from "@oh-my-pi/pi-ai";
+import { type ModelRefreshStrategy } from "@oh-my-pi/pi-ai/model-manager";
+import type { Api, Context, Model, SimpleStreamOptions, ThinkingConfig } from "@oh-my-pi/pi-ai/types";
+import type { AssistantMessageEventStream } from "@oh-my-pi/pi-ai/utils/event-stream";
 import type { OAuthCredentials, OAuthLoginCallbacks } from "@oh-my-pi/pi-ai/utils/oauth/types";
 import { type ThemeColor } from "../modes/theme/theme";
 import type { AuthStorage } from "../session/auth-storage";
@@ -355,6 +357,11 @@ export declare class ModelRegistry {
      * Check if a model selector is currently suppressed due to rate limits.
      */
     isSelectorSuppressed(selector: string): boolean;
+    /**
+     * Clear all cooldown suppressions recorded via {@link suppressSelector}.
+     * Used to reset retry-fallback cooldown state without a full {@link refresh}.
+     */
+    clearSuppressedSelectors(): void;
 }
 /**
  * Input type for registerProvider API (from extensions).

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

@@ -3317,7 +3317,7 @@ export declare const SETTINGS_SCHEMA: {
             }, {
                 readonly value: "perplexity";
                 readonly label: "Perplexity";
-                readonly description: "Requires PERPLEXITY_COOKIES or PERPLEXITY_API_KEY";
+                readonly description: "Uses auth when configured; explicit selection falls back to anonymous search";
             }, {
                 readonly value: "brave";
                 readonly label: "Brave";
@@ -3670,13 +3670,39 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
-    readonly "providers.parallelFetch": {
-        readonly type: "boolean";
-        readonly default: true;
+    readonly "providers.fetch": {
+        readonly type: "enum";
+        readonly values: readonly ["auto", "native", "trafilatura", "lynx", "parallel", "jina"];
+        readonly default: "auto";
         readonly ui: {
             readonly tab: "providers";
-            readonly label: "Parallel Fetch";
-            readonly description: "Use Parallel extract API for URL fetching when credentials are available";
+            readonly label: "Fetch Provider";
+            readonly description: "Reader backend priority for the fetch/read URL tool";
+            readonly options: readonly [{
+                readonly value: "auto";
+                readonly label: "Auto";
+                readonly description: "Priority: native > trafilatura > lynx > parallel > jina";
+            }, {
+                readonly value: "native";
+                readonly label: "Native";
+                readonly description: "In-process HTML→Markdown converter (always available)";
+            }, {
+                readonly value: "trafilatura";
+                readonly label: "Trafilatura";
+                readonly description: "Auto-installs via uv/pip";
+            }, {
+                readonly value: "lynx";
+                readonly label: "Lynx";
+                readonly description: "Requires lynx system package";
+            }, {
+                readonly value: "parallel";
+                readonly label: "Parallel";
+                readonly description: "Requires PARALLEL_API_KEY";
+            }, {
+                readonly value: "jina";
+                readonly label: "Jina";
+                readonly description: "Uses r.jina.ai reader (JINA_API_KEY optional)";
+            }];
         };
     };
     readonly "provider.appendOnlyContext": {

package/dist/types/extensibility/plugins/marketplace-auto-update.d.ts

@@ -0,0 +1,8 @@
+type MarketplaceAutoUpdateMode = "off" | "notify" | "auto";
+interface MarketplaceAutoUpdateOptions {
+    autoUpdate: MarketplaceAutoUpdateMode;
+    resolveActiveProjectRegistryPath: (cwd: string) => Promise<string | null>;
+    clearPluginRootsCache: () => void;
+}
+export declare function scheduleMarketplaceAutoUpdate(options: MarketplaceAutoUpdateOptions): void;
+export {};

package/dist/types/lsp/types.d.ts

@@ -222,6 +222,16 @@ export interface ServerConfig {
     disabled?: boolean;
     /** Per-server warmup timeout in milliseconds. Overrides the global WARMUP_TIMEOUT_MS for this server during startup. */
     warmupTimeoutMs?: number;
+    /**
+     * Per-server overrides for rust-analyzer workspace-ready polling. When omitted, the module
+     * defaults are used. Primarily a tuning/test seam to bound the multi-second settle window.
+     */
+    workspaceReadyTimings?: {
+        timeoutMs?: number;
+        pollMs?: number;
+        settleMs?: number;
+        statusRequestTimeoutMs?: number;
+    };
     capabilities?: ServerCapabilities;
     /** If true, this is a linter/formatter server (e.g., Biome) - used only for diagnostics/actions, not type intelligence */
     isLinter?: boolean;

package/dist/types/main.d.ts

@@ -7,12 +7,13 @@
 import type { Args } from "./cli/args";
 import { ModelRegistry } from "./config/model-registry";
 import { Settings } from "./config/settings";
-import { InteractiveMode, runAcpMode } from "./modes";
+import { InteractiveMode } from "./modes/interactive-mode";
 import type { SubmittedUserInput } from "./modes/types";
 import { type CreateAgentSessionOptions, type CreateAgentSessionResult, createAgentSession, discoverAuthStorage } from "./sdk";
 import type { AgentSession } from "./session/agent-session";
 import type { AuthStorage } from "./session/auth-storage";
 import { type SessionInfo, SessionManager } from "./session/session-manager";
+type RunAcpMode = (createSession: AcpSessionFactory) => Promise<never>;
 export interface InteractiveModeNotify {
     kind: "warn" | "error" | "info";
     message: string;
@@ -47,7 +48,7 @@ export declare function createSessionManager(parsed: Args, cwd: string, activeSe
 interface RunRootCommandDependencies {
     createAgentSession?: typeof createAgentSession;
     discoverAuthStorage?: typeof discoverAuthStorage;
-    runAcpMode?: typeof runAcpMode;
+    runAcpMode?: RunAcpMode;
     settings?: Settings;
     forceSetupWizard?: boolean;
 }

package/dist/types/memory-backend/index.d.ts

@@ -1,4 +1,5 @@
-export * from "../mnemopi";
+export type { MnemopiBackendConfig, MnemopiLlmMode, MnemopiProviderOptions, MnemopiScoping, } from "../mnemopi/config";
+export type { MnemopiMemoryEditOperation, MnemopiMemoryEditOptions, MnemopiMemoryEditResult, MnemopiSessionState, MnemopiSessionStateOptions, } from "../mnemopi/state";
 export * from "./local-backend";
 export * from "./off-backend";
 export * from "./resolve";

package/dist/types/memory-backend/resolve.d.ts

@@ -13,4 +13,4 @@ import type { MemoryBackend } from "./types";
  * `memories.enabled` remains accepted only as a legacy migration input. Once
  * a config is loaded, `memory.backend` is the sole runtime selector.
  */
-export declare function resolveMemoryBackend(settings: Settings): MemoryBackend;
+export declare function resolveMemoryBackend(settings: Settings): Promise<MemoryBackend>;

package/dist/types/memory-backend/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * Memory backend abstraction.
  *
- * Backends are mutually exclusive — `resolveMemoryBackend(settings)` returns
+ * Backends are mutually exclusive — `await resolveMemoryBackend(settings)` resolves
  * exactly one. Implementations MUST be self-contained: they own the per-session
  * state they create in `start()` and tear it down on `clear()`.
  */

package/dist/types/modes/components/custom-editor.d.ts

@@ -1,6 +1,6 @@
 import { Editor, type KeyId } from "@oh-my-pi/pi-tui";
 import type { AppKeybinding } from "../../config/keybindings";
-type ConfigurableEditorAction = Extract<AppKeybinding, "app.interrupt" | "app.clear" | "app.exit" | "app.suspend" | "app.thinking.cycle" | "app.model.cycleForward" | "app.model.cycleBackward" | "app.model.select" | "app.model.selectTemporary" | "app.tools.expand" | "app.thinking.toggle" | "app.editor.external" | "app.history.search" | "app.message.dequeue" | "app.clipboard.pasteImage" | "app.clipboard.pasteTextRaw" | "app.clipboard.copyPrompt">;
+type ConfigurableEditorAction = Extract<AppKeybinding, "app.interrupt" | "app.clear" | "app.exit" | "app.suspend" | "app.display.reset" | "app.thinking.cycle" | "app.model.cycleForward" | "app.model.cycleBackward" | "app.model.select" | "app.model.selectTemporary" | "app.tools.expand" | "app.thinking.toggle" | "app.editor.external" | "app.history.search" | "app.message.dequeue" | "app.clipboard.pasteImage" | "app.clipboard.pasteTextRaw" | "app.clipboard.copyPrompt">;
 /**
  * Custom editor that handles configurable app-level shortcuts for coding-agent.
  */
@@ -14,6 +14,7 @@ export declare class CustomEditor extends Editor {
     onEscape?: () => void;
     onClear?: () => void;
     onExit?: () => void;
+    onDisplayReset?: () => void;
     onCycleThinkingLevel?: () => void;
     onCycleModelForward?: () => void;
     onCycleModelBackward?: () => void;

package/dist/types/modes/components/tool-execution.d.ts

@@ -61,6 +61,24 @@ export declare class ToolExecutionComponent extends Container {
      * past, or an explicit {@link seal} flips it to `true`.
      */
     isTranscriptBlockFinalized(): boolean;
+    /**
+     * While a tool's preview is still streaming, a block whose preview is
+     * append-only (rows only grow at the bottom, never re-layout) lets the
+     * renderer commit the scrolled-off head of an over-tall preview to native
+     * scrollback instead of dropping it — the same anti-yank path a streaming
+     * assistant reply uses (see {@link TranscriptContainer} +
+     * `NativeScrollbackLiveRegion`). Covers both phases: a pre-result call preview
+     * (a `write` whose content streams in) and a partial-result preview that
+     * streams output below fixed input (an `eval`/`bash` whose stdout grows under
+     * its code cell). Gated on {@link isTranscriptBlockFinalized} so the boundary
+     * closes the instant the block reaches a terminal state — a final result that
+     * may collapse to a compact view, a backgrounded async tool, or a seal — and
+     * the renderer decides whether its current preview shape qualifies via
+     * `isStreamingPreviewAppendOnly` (typically: only the expanded full view,
+     * which is top-anchored; the collapsed tail window re-layouts but is bounded
+     * so it never overflows anyway).
+     */
+    isTranscriptBlockAppendOnly(): 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,6 @@ export declare class SelectorController {
     handleResumeSession(sessionPath: string): Promise<void>;
     handleSessionDeleteCommand(): Promise<void>;
     showOAuthSelector(mode: "login" | "logout", providerId?: string): Promise<void>;
-    showDebugSelector(): void;
+    showDebugSelector(): Promise<void>;
     showSessionObserver(registry: SessionObserverRegistry): void;
 }

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

@@ -1,9 +1,10 @@
 /**
- * Run modes for the coding agent.
+ * Interactive mode and embeddable RPC client exports for the coding agent.
+ *
+ * Branch-specific runners live in their concrete modules so importing this
+ * barrel does not pull print, RPC server, or ACP server mode into the normal
+ * TUI graph.
  */
-export { runAcpMode } from "./acp";
 export { InteractiveMode, type InteractiveModeOptions } from "./interactive-mode";
-export { type PrintModeOptions, runPrintMode } from "./print-mode";
 export { defineRpcClientTool, type ModelInfo, RpcClient, type RpcClientCustomTool, type RpcClientOptions, type RpcClientToolContext, type RpcClientToolResult, type RpcEventListener, } from "./rpc/rpc-client";
-export { runRpcMode } from "./rpc/rpc-mode";
 export type { RpcCommand, RpcHostToolCallRequest, RpcHostToolCancelRequest, RpcHostToolDefinition, RpcHostToolResult, RpcHostToolUpdate, RpcResponse, RpcSessionState, } from "./rpc/rpc-types";

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

@@ -214,7 +214,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     handleRenameCommand(title: string): Promise<void>;
     handleMemoryCommand(text: string): Promise<void>;
     handleSTTToggle(): Promise<void>;
-    showDebugSelector(): void;
+    showDebugSelector(): Promise<void>;
     showSessionObserver(): void;
     resetObserverRegistry(): void;
     handleBashCommand(command: string, excludeFromContext?: boolean): Promise<void>;

package/dist/types/modes/setup-version.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Setup version the wizard advances a fresh install to. Bump it whenever a new
+ * setup scene lands (or an existing scene raises its `minVersion`).
+ *
+ * Kept in its own dependency-free module so the cold-launch gate in `main.ts`
+ * can answer "is the stored setup version stale?" without statically importing
+ * the full wizard — every scene (sign-in/OAuth, web search, theme previews) plus
+ * the overlay component and their TUI deps. MUST equal `max(scene.minVersion)`
+ * across `ALL_SCENES`; the `setup-wizard` barrel and test suite guard it.
+ */
+export declare const CURRENT_SETUP_VERSION = 1;

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

@@ -1,9 +1,10 @@
 import type { Settings } from "../../config/settings";
+import { CURRENT_SETUP_VERSION } from "../setup-version";
 import type { InteractiveModeContext } from "../types";
 import type { SetupScene } from "./scenes/types";
 export type { SetupScene, SetupSceneController, SetupSceneHost, SetupSceneResult } from "./scenes/types";
+export { CURRENT_SETUP_VERSION };
 export declare const ALL_SCENES: readonly [SetupScene, SetupScene, SetupScene];
-export declare const CURRENT_SETUP_VERSION: number;
 export interface SetupSceneSelectionOptions {
     resuming?: boolean;
     isTTY?: boolean;