@oh-my-pi/pi-coding-agent 15.9.0 → 15.9.1

package/CHANGELOG.md

@@ -2,6 +2,45 @@
 
 ## [Unreleased]
 
+## [15.9.1] - 2026-06-04
+
+### Added
+
+- Added deferred session-title generation so greetings no longer become the session title. A first user message that is only a greeting / acknowledgement / filler ("hi", "thanks", "ok", a bare number, emoji-only, etc.) is now detected deterministically and skips titling entirely — no title model is invoked. Title generation then retries on each subsequent user message while the session stays unnamed, so the title is deduced from the first message that actually describes work. A capable online title model may additionally answer `none` to decline a non-greeting taskless message (normalized to "no title").
+
+### Changed
+
+- Changed mid-turn user steers to reach the model inside a wire-only interjection envelope, while transcripts and persisted session history keep the user's original text.
+- Changed the system prompt to treat user requests for parallel work as `task` subagent fan-out rather than parallel tool calls.
+- Changed the Agent Control Center's new-agent description field to use the multiline TUI editor, with Enter inserting lines and Ctrl+Enter generating the spec.
+- Changed the Agent Control Center and Extension Control Center to accept Left/Right arrow keys for switching tabs (source / provider), in addition to Tab / Shift+Tab — matching the model and settings selectors, whose `TabBar` already supported arrow navigation.
+- Refreshed the Ctrl+R history search overlay: the selected row now renders as a full-width `selectedBg` highlight bar, matched query tokens are highlighted in the accent color, each result shows a right-aligned relative timestamp, and the panel gained an icon'd accent title plus a two-tone keyhint footer. The selector also gained PageUp/PageDown (via the configurable `tui.select.pageUp`/`pageDown` keybindings) and Home/End navigation.
+- Changed Perplexity API-key web search to return more comprehensive results: `web_search_options.search_context_size` is now `high` (was `medium`) for maximum retrieval grounding, the default `num_search_results` is `20` (was `10`) so twice as many sources are surfaced, and `return_related_questions` is enabled with the response's `related_questions` now parsed into `relatedQuestions` (previously dropped). On an identical query this lifted the result from 10 sources / ~410 output tokens to 20 sources / ~1900 output tokens with a structured, multi-section answer; latency tracks model output length, not context size, so the 60s hard timeout headroom is unchanged.
+
+### Fixed
+
+- Fixed a streamed assistant message freezing at a partial prefix (e.g. only "Nat" of "Natives built, now…") on ED3-risk terminals (Ghostty/kitty/iTerm2/Alacritty), with the final text appearing only after a resize. `TranscriptContainer` freezes each non-live block by replaying its last live render, but render coalescing can finalize a block's content and append the next block within the same throttled frame — so the block was sealed at its stale mid-stream snapshot and never repainted until the next `thaw`. The block that was live on the previous render is now recomputed once on the live→frozen transition, sealing it at its final content.
+
+- Fixed ACP/RPC stdio startup so protocol frames are no longer consumed as one-shot piped prompt input before the JSON-RPC transport starts.
+- Fixed `omp completions` to await the completion script write before exiting.
+- Fixed `AssistantMessageComponent` exposing its stable-prefix completion API again so streamed assistant messages remain unstable until explicitly completed.
+- Fixed session restoration to ignore transient fallback model switches (such as automatic context-promotion or retry fallback) so resumed or resumed-switch sessions revert to the configured default model unless the last change was a user-selected temporary model
+- Fixed in-session `/resume` to restore both the last user-selected temporary model and persisted plan/goal mode state instead of falling back to the default model with plan mode off.
+- Fixed the `/resume` session picker overflowing short viewports: the visible window was hardcoded to 5 entries (and assumed 3 lines each), but titled sessions render 4 lines, so on a typical-height terminal the picker's header and search box scrolled off the top and the first entry was hidden until you scrolled the terminal up. The visible-entry count is now derived from the live terminal height (budgeting the worst-case 4-line titled entry plus the picker's chrome), so the whole picker fits the viewport and grows on taller terminals.
+- Fixed the Agent Control Center and Extension Control Center dashboards overflowing the terminal: they were mounted inline below the chat transcript, so the combined height exceeded the viewport — the tab bar and controls scrolled off the top into native scrollback, and every state change yanked the view back to the bottom. Both dashboards now render as full-screen overlays sized to the live terminal height (`process.stdout.rows`), re-fit on resize, fill the viewport, and reserve space for the footer keyhints so the controls stay visible.
+- Fixed Ctrl+R history search results to remain globally sorted by prompt recency after merging FTS prefix matches with substring fallback matches.
+- Fixed Exa web search with no stored or environment credential to use the public Exa MCP fallback again, preserving the auth storage → `EXA_API_KEY` → `mcp.exa.ai` resolution order ([#1860](https://github.com/can1357/oh-my-pi/issues/1860)).
+- Fixed ACP plan-mode writes to `local://PLAN.md` so session-local plan artifacts are written to OMP's local artifact root instead of being routed through the editor `writeTextFile` bridge, avoiding Zen's `Internal error` and making the plan readable after creation ([#1863](https://github.com/can1357/oh-my-pi/issues/1863)).
+- Fixed ACP plan mode stranding the agent at plan approval: entering `mode: "plan"` now registers a standing `resolve` handler so the agent's `resolve { action: "apply" }` no longer fails with `No pending action to resolve. Nothing to apply or discard.` The handler validates the plan file, asks the ACP client to confirm via `unstable_createElicitation` when the client supports forms, renames the approved plan to `local://<title>.md`, and exits plan mode so the agent regains write tools for execution ([#1869](https://github.com/can1357/oh-my-pi/issues/1869)).
+
+- Fixed `provider.appendOnlyContext: "auto"` staying inactive for Xiaomi Token Plan/SGLang endpoints, preserving prefix-cache hits without forcing append-only mode globally ([#1851](https://github.com/can1357/oh-my-pi/issues/1851)).
+- Fixed `models.yml` compatibility parsing to preserve `compat.cacheControlFormat: "anthropic"` for custom OpenAI-compatible Claude proxies. ([#1845](https://github.com/can1357/oh-my-pi/issues/1845))
+- Fixed the TUI's `Settings → Plugins` panel reporting "No plugins installed" when only marketplace plugins were installed. The panel now merges `PluginManager.list()` with `MarketplaceManager.listInstalledPlugins()` — the same data source the `/plugins list` slash command and `omp plugin list` CLI already used — and tags each row with an `[npm]` / `[marketplace]` kind badge, a scope tag, and a shadow indicator for project-shadowed user installs. Selecting a marketplace row opens a new `MarketplacePluginDetailComponent` whose single `Enabled` toggle calls `MarketplaceManager.setPluginEnabled(pluginId, enabled, scope)`, with read-only metadata (version, install path, installed-at, last-updated, git commit SHA) listed below the toggle. The empty-state now lists both install commands (`omp plugin install <package>` and `omp plugin install <name>@<marketplace>`) ([#1842](https://github.com/can1357/oh-my-pi/issues/1842)).
+- Fixed scoped mnemopi recall in `MnemopiSessionState.collectScopedRecallResults`/`recallResultsScoped` to await the async `Mnemopi.recallEnhanced` so the new auto-derived `queryEmbedding` flows through. Without this, the embedding-enabled mnemopi backend silently kept running FTS-only on every recall. ([#1832](https://github.com/can1357/oh-my-pi/issues/1832))
+- Fixed the SSH tool renderer inlining multiline remote commands into its single-line status header, which produced a malformed cell where the bordered output block opened mid-command. The renderer now drops the command from the header (which keeps only `[host]`) and renders the full command in a framed section above `Output`, mirroring the bash renderer. `renderStatusLine` also flattens any embedded CR/LF in `description`, `meta`, and `title` so no tool can accidentally expand the header into multiple rows ([#1828](https://github.com/can1357/oh-my-pi/issues/1828)).
+- Fixed `tsc --noEmit` against `packages/coding-agent/tsconfig.json` reporting 56 errors under TypeScript 5.x (`builtin-registry.ts` × 46, `agent-session-openai-responses-replay.test.ts` × 10). The repo's own gate (`tsgo` / TypeScript 6.x) already accepted the `() => void` slash-command handlers, but 5.x rejects them because it does not coerce a `void`-returning function value into a `() => T | undefined` slot. The `SlashCommandSpec.handle` / `handleTui` signatures and the test's `createPersistedSession` `populate` callback are now expressed as a union of two function types (one returning a `SlashCommandResult` / target, one returning `void`), so the existing handler bodies typecheck on both compilers ([#1821](https://github.com/can1357/oh-my-pi/issues/1821)).
+- Fixed `omp update` leaving `@oh-my-pi/pi-natives` and the platform-specific `@oh-my-pi/pi-natives-<tag>` leaf at the previous version on `bun install -g` updates, so the next launch loaded a stale `.node` file and aborted at `validateLoadedBindings` with `The .node file on disk is from a different release than this loader`. `omp update` now pins the native addon core and the platform leaf to the same version it installs for `@oh-my-pi/pi-coding-agent` ([#1824](https://github.com/can1357/oh-my-pi/issues/1824)).
+
 ## [15.9.0] - 2026-06-04
 
 ### Breaking Changes

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

@@ -40,8 +40,22 @@ export declare function replaceBinaryForUpdate(options: BinaryReplacementOptions
  *
  * Together these two flags make `omp update` produce exactly the registry
  * lookup the version check just performed. See #1686.
+ *
+ * Also pins {@link NATIVES_PACKAGE} and the platform-specific
+ * `@oh-my-pi/pi-natives-<tag>` leaf to `expectedVersion`. `bun install -g`
+ * does not reliably refresh transitive `optionalDependencies` when the
+ * top-level package is the only one bumped, so the native addon and its
+ * version sentinel can drift out of sync with the freshly installed
+ * `@oh-my-pi/pi-coding-agent` and the loader aborts at
+ * `validateLoadedBindings` on the next launch
+ * (`The .node file on disk is from a different release than this loader`).
+ * Listing the natives explicitly forces bun to replace them in lock-step.
+ * The leaf is added only on tags the release pipeline actually publishes
+ * ({@link SUPPORTED_NATIVE_TAGS}) so unsupported platforms still fail with
+ * the original "no matching version" message instead of `EBADPLATFORM`.
+ * See #1824.
  */
-export declare function buildBunInstallArgs(expectedVersion: string): string[];
+export declare function buildBunInstallArgs(expectedVersion: string, nativeTag?: string): string[];
 /**
  * Run the update command.
  */

package/dist/types/config/append-only-context-mode.d.ts

@@ -0,0 +1,8 @@
+/** Provider metadata needed to resolve append-only context mode. */
+export interface AppendOnlyContextModel {
+    provider: string;
+    baseUrl: string;
+    compat?: object;
+}
+/** Resolves whether append-only context should be active for a model and setting. */
+export declare function shouldEnableAppendOnlyContext(setting: "auto" | "on" | "off" | undefined, model: AppendOnlyContextModel | null | undefined): boolean;

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

@@ -72,6 +72,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                 order?: string[] | undefined;
             } | undefined;
             extraBody?: Record<string, unknown> | undefined;
+            cacheControlFormat?: "anthropic" | undefined;
             supportsStrictMode?: boolean | undefined;
             toolStrictMode?: "all_strict" | "none" | undefined;
         } | undefined;
@@ -139,6 +140,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                     order?: string[] | undefined;
                 } | undefined;
                 extraBody?: Record<string, unknown> | undefined;
+                cacheControlFormat?: "anthropic" | undefined;
                 supportsStrictMode?: boolean | undefined;
                 toolStrictMode?: "all_strict" | "none" | undefined;
             } | undefined;
@@ -200,6 +202,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                     order?: string[] | undefined;
                 } | undefined;
                 extraBody?: Record<string, unknown> | undefined;
+                cacheControlFormat?: "anthropic" | undefined;
                 supportsStrictMode?: boolean | undefined;
                 toolStrictMode?: "all_strict" | "none" | undefined;
             } | undefined;

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

@@ -47,6 +47,9 @@ export declare const OpenAICompatSchema: z.ZodObject<{
         order: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
     extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    cacheControlFormat: z.ZodOptional<z.ZodEnum<{
+        anthropic: "anthropic";
+    }>>;
     supportsStrictMode: z.ZodOptional<z.ZodBoolean>;
     toolStrictMode: z.ZodOptional<z.ZodEnum<{
         all_strict: "all_strict";
@@ -155,6 +158,9 @@ export declare const ModelOverrideSchema: z.ZodObject<{
             order: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>;
         extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        cacheControlFormat: z.ZodOptional<z.ZodEnum<{
+            anthropic: "anthropic";
+        }>>;
         supportsStrictMode: z.ZodOptional<z.ZodBoolean>;
         toolStrictMode: z.ZodOptional<z.ZodEnum<{
             all_strict: "all_strict";
@@ -242,6 +248,9 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 order: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>>;
             extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            cacheControlFormat: z.ZodOptional<z.ZodEnum<{
+                anthropic: "anthropic";
+            }>>;
             supportsStrictMode: z.ZodOptional<z.ZodBoolean>;
             toolStrictMode: z.ZodOptional<z.ZodEnum<{
                 all_strict: "all_strict";
@@ -376,6 +385,9 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                     order: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 }, z.core.$strip>>;
                 extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                cacheControlFormat: z.ZodOptional<z.ZodEnum<{
+                    anthropic: "anthropic";
+                }>>;
                 supportsStrictMode: z.ZodOptional<z.ZodBoolean>;
                 toolStrictMode: z.ZodOptional<z.ZodEnum<{
                     all_strict: "all_strict";
@@ -486,6 +498,9 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                     order: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 }, z.core.$strip>>;
                 extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                cacheControlFormat: z.ZodOptional<z.ZodEnum<{
+                    anthropic: "anthropic";
+                }>>;
                 supportsStrictMode: z.ZodOptional<z.ZodBoolean>;
                 toolStrictMode: z.ZodOptional<z.ZodEnum<{
                     all_strict: "all_strict";

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

@@ -3331,7 +3331,7 @@ export declare const SETTINGS_SCHEMA: {
             }, {
                 readonly value: "exa";
                 readonly label: "Exa";
-                readonly description: "Requires EXA_API_KEY";
+                readonly description: "Uses Exa API when EXA_API_KEY is set; falls back to Exa MCP";
             }, {
                 readonly value: "parallel";
                 readonly label: "Parallel";
@@ -3668,11 +3668,11 @@ export declare const SETTINGS_SCHEMA: {
         readonly ui: {
             readonly tab: "providers";
             readonly label: "Append-Only Context";
-            readonly description: "Cache system prompt + tool specs and keep an append-only message log so provider prefix caches (DeepSeek, Anthropic) hit at maximum rate. Auto enables for DeepSeek.";
+            readonly description: "Cache system prompt + tool specs and keep an append-only message log so provider prefix caches (DeepSeek, Xiaomi/SGLang, Anthropic) hit at maximum rate. Auto enables for known prefix-cache providers.";
             readonly options: readonly [{
                 readonly value: "auto";
                 readonly label: "Auto";
-                readonly description: "Enable for DeepSeek (recommended)";
+                readonly description: "Enable for known prefix-cache providers (recommended)";
             }, {
                 readonly value: "on";
                 readonly label: "On";

package/dist/types/exa/mcp-client.d.ts

@@ -1,5 +1,6 @@
 import type { TSchema } from "@oh-my-pi/pi-ai";
 import type { CustomTool, CustomToolResult } from "../extensibility/custom-tools/types";
+import { type CallMcpOptions } from "../mcp/json-rpc";
 import type { ExaRenderDetails, ExaSearchResponse, MCPTool, MCPToolWrapperConfig } from "./types";
 /** Find EXA_API_KEY from Bun.env or .env files */
 export declare function findApiKey(): string | null;
@@ -8,7 +9,7 @@ export declare function fetchExaTools(apiKey: string | null, toolNames: string[]
 /** Fetch available tools from Websets MCP */
 export declare function fetchWebsetsTools(apiKey: string): Promise<MCPTool[]>;
 /** Call a tool on Exa MCP (simplified: toolName as first arg for easier use) */
-export declare function callExaTool(toolName: string, args: Record<string, unknown>, apiKey: string | null): Promise<unknown>;
+export declare function callExaTool(toolName: string, args: Record<string, unknown>, apiKey: string | null, options?: CallMcpOptions): Promise<unknown>;
 /** Call a tool on Websets MCP */
 export declare function callWebsetsTool(apiKey: string, toolName: string, args: Record<string, unknown>): Promise<unknown>;
 /** Format search results for LLM */

package/dist/types/mcp/json-rpc.d.ts

@@ -11,12 +11,17 @@ export interface JsonRpcResponse<T = unknown> {
         data?: unknown;
     };
 }
+/** Options controlling a single MCP JSON-RPC HTTP request. */
+export interface CallMcpOptions {
+    signal?: AbortSignal;
+}
 /**
  * Call an MCP server with JSON-RPC 2.0 over HTTPS.
  *
  * @param url - Full MCP server URL (including any query parameters)
  * @param method - JSON-RPC method name (e.g., "tools/list", "tools/call")
  * @param params - Method parameters
+ * @param options - Optional transport controls such as cancellation.
  * @returns Parsed JSON-RPC response
  */
-export declare function callMCP<T = unknown>(url: string, method: string, params?: Record<string, unknown>): Promise<JsonRpcResponse<T>>;
+export declare function callMCP<T = unknown>(url: string, method: string, params?: Record<string, unknown>, options?: CallMcpOptions): Promise<JsonRpcResponse<T>>;

package/dist/types/mcp/tool-bridge.d.ts

@@ -53,6 +53,8 @@ export declare class MCPTool implements CustomTool<TSchema, MCPToolDetails> {
     readonly mcpToolName: string;
     /** Server name */
     readonly mcpServerName: string;
+    /** Render completed MCP calls with the result header replacing the pending call header. */
+    readonly mergeCallAndResult = true;
     /** Create MCPTool instances for all tools from an MCP server connection */
     static fromTools(connection: MCPServerConnection, tools: MCPToolDefinition[], reconnect?: MCPReconnect): MCPTool[];
     constructor(connection: MCPServerConnection, tool: MCPToolDefinition, reconnect?: MCPReconnect | undefined);
@@ -77,6 +79,8 @@ export declare class DeferredMCPTool implements CustomTool<TSchema, MCPToolDetai
     readonly mcpToolName: string;
     /** Server name */
     readonly mcpServerName: string;
+    /** Render completed MCP calls with the result header replacing the pending call header. */
+    readonly mergeCallAndResult = true;
     /** Create DeferredMCPTool instances for all tools from an MCP server */
     static fromTools(serverName: string, tools: MCPToolDefinition[], getConnection: () => Promise<MCPServerConnection>, source?: SourceMeta, reconnect?: MCPReconnect): DeferredMCPTool[];
     constructor(serverName: string, tool: MCPToolDefinition, getConnection: () => Promise<MCPServerConnection>, source?: SourceMeta, reconnect?: MCPReconnect | undefined);

package/dist/types/mnemopi/state.d.ts

@@ -48,8 +48,8 @@ export declare class MnemopiSessionState {
     getScopedRetainTarget(): MnemopiScopedMemory;
     editScopedMemory(op: MnemopiMemoryEditOperation, id: string, options?: MnemopiMemoryEditOptions): MnemopiMemoryEditResult;
     formatScopedRecallWithIds(results: readonly RecallResult[]): string;
-    collectScopedRecallResults(query: string): RecallResult[];
-    recallResultsScoped(query: string): RecallResult[];
+    collectScopedRecallResults(query: string): Promise<RecallResult[]>;
+    recallResultsScoped(query: string): Promise<RecallResult[]>;
     formatScopedRecallContext(results: readonly RecallResult[], format?: "bullet" | "json"): string | undefined;
     formatContextScoped(results: readonly RecallResult[], format?: "bullet" | "json"): string;
     rememberInScope(memory: MnemopiRememberInput, options?: MnemopiRememberOptions): string | undefined;

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

@@ -16,6 +16,7 @@ export declare class AgentDashboard extends Container {
     onRequestRender?: () => void;
     private constructor();
     static create(cwd: string, settings?: Settings | null, terminalHeight?: number, modelContext?: AgentDashboardModelContext): Promise<AgentDashboard>;
+    render(width: number): string[];
     handleInput(data: string): void;
 }
 export {};

package/dist/types/modes/components/extensions/extension-dashboard.d.ts

@@ -22,5 +22,6 @@ export declare class ExtensionDashboard extends Container {
     onRequestRender?: () => void;
     private constructor();
     static create(cwd: string, settings?: Settings | null, terminalHeight?: number): Promise<ExtensionDashboard>;
+    render(width: number): string[];
     handleInput(data: string): void;
 }

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

@@ -2,13 +2,15 @@
  * Plugin settings UI components.
  *
  * Provides a hierarchical settings interface:
- * - Plugin list (shows all installed plugins)
- *   - Plugin detail (enable/disable, features, config)
+ * - Plugin list (npm plugins + marketplace plugins)
+ *   - npm plugin detail (enable/disable, features, config)
+ *   - Marketplace plugin detail (enable/disable + read-only metadata)
  *     - Feature toggles
  *     - Config value editor
  */
 import { Container } from "@oh-my-pi/pi-tui";
 import { PluginManager } from "../../extensibility/plugins/manager";
+import type { InstalledPluginSummary } from "../../extensibility/plugins/marketplace";
 import type { InstalledPlugin } from "../../extensibility/plugins/types";
 /**
  * Forwards a keystroke to `input`, but cancels via `onCancel` when the user presses Escape.
@@ -16,18 +18,32 @@ import type { InstalledPlugin } from "../../extensibility/plugins/types";
 export declare function handleInputOrEscape(data: string, input: {
     handleInput(data: string): void;
 }, onCancel: () => void): void;
+/**
+ * One row in the unified plugin list. npm and marketplace plugins live in
+ * separate registries with different shapes, so a tagged union keeps both
+ * paths type-safe end-to-end (list rendering, value lookup, detail callback).
+ */
+export type PluginListEntry = {
+    kind: "npm";
+    plugin: InstalledPlugin;
+} | {
+    kind: "marketplace";
+    plugin: InstalledPluginSummary;
+};
 export interface PluginListCallbacks {
-    onPluginSelect: (plugin: InstalledPlugin) => void;
+    onNpmSelect: (plugin: InstalledPlugin) => void;
+    onMarketplaceSelect: (plugin: InstalledPluginSummary) => void;
     onCancel: () => void;
 }
 /**
- * Shows list of installed plugins with enable/disable status.
- * Selecting a plugin opens its detail view.
+ * Shows installed plugins from both registries (npm + marketplace) with
+ * enable/disable status, scope tag, and shadow indicator. Selecting an entry
+ * fans out to the kind-specific detail callback.
  */
 export declare class PluginListComponent extends Container {
     #private;
-    private readonly plugins;
-    constructor(plugins: InstalledPlugin[], callbacks: PluginListCallbacks);
+    private readonly entries;
+    constructor(entries: ReadonlyArray<PluginListEntry>, callbacks: PluginListCallbacks);
     handleInput(data: string): void;
 }
 export interface PluginDetailCallbacks {
@@ -50,9 +66,25 @@ export declare class PluginDetailComponent extends Container {
     constructor(plugin: InstalledPlugin, manager: PluginManager, callbacks: PluginDetailCallbacks);
     handleInput(data: string): void;
 }
+export interface MarketplacePluginDetailCallbacks {
+    onEnabledChange: (enabled: boolean) => void;
+    onBack: () => void;
+}
+/**
+ * Detail view for a marketplace plugin. Marketplace plugins do not declare
+ * features or settings, so the panel exposes a single enable/disable toggle
+ * plus the read-only metadata from the installed-plugins registry.
+ */
+export declare class MarketplacePluginDetailComponent extends Container {
+    #private;
+    private plugin;
+    private readonly callbacks;
+    constructor(plugin: InstalledPluginSummary, callbacks: MarketplacePluginDetailCallbacks);
+    handleInput(data: string): void;
+}
 export interface PluginSettingsCallbacks {
     onClose: () => void;
-    onPluginChanged: () => void;
+    onPluginChanged: () => void | Promise<void>;
 }
 /**
  * Top-level plugin settings component.

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

@@ -8,10 +8,10 @@ export type SessionHistoryMatcher = (query: string) => string[];
  *
  * - `fuzzy` is the ordered fuzzy-filter result over session metadata (best first).
  * - `historyIds` are session IDs whose recorded prompts matched the query,
- *   ordered by history relevance (best first); duplicates are tolerated.
+ *   ordered by prompt-history rank (typically newest matching prompt first); duplicates are tolerated.
  *
  * Ranking: sessions matched by **both** signals lead (keeping fuzzy order), then
- * fuzzy-only matches, then history-only matches (by history order). A fuzzy match
+ * fuzzy-only matches, then history-only matches (by prompt-history order). A fuzzy match
  * is never dropped, and history matches not present in `allSessions` (e.g. deleted
  * or out-of-scope sessions) are ignored since they cannot be resumed from here.
  */
@@ -26,7 +26,7 @@ declare class SessionList implements Component {
     onExit: () => void;
     onToggleScope?: () => void;
     onDeleteRequest?: (session: SessionInfo) => void;
-    constructor(sessions: SessionInfo[], showCwd?: boolean, historyMatcher?: SessionHistoryMatcher);
+    constructor(sessions: SessionInfo[], showCwd?: boolean, historyMatcher?: SessionHistoryMatcher, getTerminalRows?: () => number);
     /** Replace the visible dataset, e.g. when toggling folder/all-projects scope. */
     setSessions(sessions: SessionInfo[], showCwd: boolean): void;
     removeSession(sessionPath: string): void;
@@ -43,6 +43,11 @@ export interface SessionSelectorOptions {
     allSessions?: SessionInfo[];
     /** Open directly in all-projects scope (e.g. the current folder has no sessions). */
     startInAllScope?: boolean;
+    /**
+     * Reads the live terminal height so the visible window fits the viewport.
+     * Omitted only in tests; defaults to a conservative 24 rows.
+     */
+    getTerminalRows?: () => number;
 }
 /**
  * Component that renders a session selector with optional confirmation dialog

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

@@ -36,7 +36,7 @@ export interface SettingsCallbacks {
     /** Get current rendered status line for inline preview */
     getStatusLinePreview?: () => string;
     /** Called when plugins change */
-    onPluginsChanged?: () => void;
+    onPluginsChanged?: () => void | Promise<void>;
     /** Called when settings panel is closed */
     onCancel: () => void;
 }

package/dist/types/modes/utils/keybinding-matchers.d.ts

@@ -12,4 +12,8 @@ export declare function matchesSelectCancel(data: string): boolean;
 export declare function matchesSelectUp(data: string): boolean;
 /** Match the generic selector down-navigation keybinding. */
 export declare function matchesSelectDown(data: string): boolean;
+/** Match the generic selector page-up keybinding. */
+export declare function matchesSelectPageUp(data: string): boolean;
+/** Match the generic selector page-down keybinding. */
+export declare function matchesSelectPageDown(data: string): boolean;
 export declare function matchesAppExternalEditor(data: string): boolean;

package/dist/types/session/agent-session.d.ts

@@ -313,6 +313,7 @@ export declare class AgentSession {
     peekQueueInvoker(): ((input: unknown) => Promise<unknown> | unknown) | undefined;
     peekStandingResolveHandler(): ((input: unknown) => Promise<unknown> | unknown) | undefined;
     setStandingResolveHandler(handler: ((input: unknown) => Promise<unknown> | unknown) | null): void;
+    setSessionSwitchReconciler(reconciler: (() => Promise<void>) | null): void;
     /** Provider-scoped mutable state store for transport/session caches. */
     get providerSessionState(): Map<string, ProviderSessionState>;
     getHindsightSessionState(): HindsightSessionState | undefined;
@@ -637,7 +638,9 @@ export declare class AgentSession {
      * Validates API key, saves to session log but NOT to settings.
      * @throws Error if no API key available for the model
      */
-    setModelTemporary(model: Model, thinkingLevel?: ThinkingLevel): Promise<void>;
+    setModelTemporary(model: Model, thinkingLevel?: ThinkingLevel, options?: {
+        ephemeral?: boolean;
+    }): Promise<void>;
     /**
      * Cycle to next/previous model.
      * Uses scoped models (from --models flag) if available, otherwise all available models.

package/dist/types/session/history-storage.d.ts

@@ -22,10 +22,9 @@ export declare class HistoryStorage {
     getRecent(limit: number): HistoryEntry[];
     search(query: string, limit: number): HistoryEntry[];
     /**
-     * IDs of the sessions whose stored prompts match `query`, ordered by match
-     * relevance (most relevant/recent first) and de-duplicated. Prompts with no
-     * recorded session are skipped. Used to augment session ranking in the
-     * resume picker with prompts that the 4KB session-list prefix never sees.
+     * IDs of the sessions whose stored prompts match `query`, ordered by prompt
+     * recency and de-duplicated. Used to augment session ranking in the resume
+     * picker with prompts that the 4KB session-list prefix never sees.
      */
     matchingSessionIds(query: string, limit?: number): string[];
 }

package/dist/types/session/messages.d.ts

@@ -55,6 +55,7 @@ export declare const INTERNAL_DETAILS_FIELDS: readonly ["__pendingDisplayTag"];
  *  (null/non-object, or no listed fields present) so callers don't pay a
  *  clone cost on the common path. */
 export declare function stripInternalDetailsFields<T>(details: T | undefined): T | undefined;
+export declare function wrapSteeringForModel(messages: AgentMessage[]): AgentMessage[];
 /**
  * Strip image content blocks from `message` in place. Returns the count of
  * images removed across `content` (every role that carries `ImageContent`) and

package/dist/types/session/session-manager.d.ts

@@ -169,6 +169,7 @@ export interface SessionContext {
     /** Mode-specific data from the last mode_change entry */
     modeData?: Record<string, unknown>;
 }
+export declare const EPHEMERAL_MODEL_CHANGE_ROLE = "fallback";
 /** Lists session model strings to try when restoring, in fallback order. */
 export declare function getRestorableSessionModels(models: Readonly<Record<string, string>>, lastModelChangeRole: string | undefined): string[];
 /**

package/dist/types/slash-commands/types.d.ts

@@ -27,7 +27,11 @@ export interface ParsedSlashCommand {
 /**
  * Result returned by a slash-command handler.
  *
- * - `void` / `undefined` — command was handled and consumed; no further input.
+ * - `undefined` (and the implicit `void` return) — command was handled and
+ *   consumed; no further input. Handlers may simply omit a `return` rather than
+ *   building `{ consumed: true }`; `void` is accepted in the handler signatures
+ *   below so the contract typechecks under TypeScript 5.x (which does not
+ *   coerce `() => void` to `() => T | undefined`) as well as 6.x / tsgo.
  * - `{ consumed: true }` — explicit equivalent of the above (ACP shape).
  * - `{ prompt: string }` — command handled, pass `prompt` through as the new
  *   user input (e.g. `/force <tool> <prompt>` keeps `<prompt>` as the message).
@@ -97,14 +101,23 @@ export interface SlashCommandSpec extends BuiltinSlashCommand {
     /**
      * Text/ACP-mode handler. The same body is invoked from the ACP dispatcher
      * and, via the TUI adapter, when no `handleTui` override is provided.
+     *
+     * Expressed as a union of two function types — one returning a
+     * `SlashCommandResult`, one returning `void` — so handlers that simply
+     * `return` (or omit the return) typecheck under TypeScript 5.x as well as
+     * 6.x / tsgo. TS 5.x does not coerce a `() => void` value into a
+     * `() => T | undefined` slot, so the two return shapes must be siblings
+     * rather than a `T | void` union inside one function type (which Biome's
+     * `noConfusingVoidType` also rejects).
      */
-    handle?: (command: ParsedSlashCommand, runtime: SlashCommandRuntime) => Promise<SlashCommandResult> | SlashCommandResult;
+    handle?: ((command: ParsedSlashCommand, runtime: SlashCommandRuntime) => SlashCommandResult | Promise<SlashCommandResult>) | ((command: ParsedSlashCommand, runtime: SlashCommandRuntime) => void | Promise<void>);
     /**
      * TUI-only handler that supersedes `handle` when both are present. Use for
      * selectors, wizards, dashboards, and anything else that requires
-     * `InteractiveModeContext`.
+     * `InteractiveModeContext`. See `handle` for the rationale behind the
+     * function-type union shape.
      */
-    handleTui?: (command: ParsedSlashCommand, runtime: TuiSlashCommandRuntime) => Promise<SlashCommandResult> | SlashCommandResult;
+    handleTui?: ((command: ParsedSlashCommand, runtime: TuiSlashCommandRuntime) => SlashCommandResult | Promise<SlashCommandResult>) | ((command: ParsedSlashCommand, runtime: TuiSlashCommandRuntime) => void | Promise<void>);
 }
 /** Result returned by `executeAcpBuiltinSlashCommand`. */
 export type AcpBuiltinSlashCommandResult = false | {

package/dist/types/tiny/text.d.ts

@@ -16,4 +16,21 @@ export declare function stripCodeBlocks(message: string): string;
 /** Prepare a raw user message for titling: drop code blocks, then bound length. */
 export declare function prepareTitleInput(message: string): string;
 export declare function formatTitleUserMessage(message: string): string;
+/**
+ * True when a first user message is too low-signal to title (greeting, ack,
+ * bare number, or empty once code/punctuation/emoji are stripped).
+ *
+ * Deterministic pre-filter: the default tiny title model (~350M local) cannot
+ * reliably follow a "respond with none" instruction and tends to hallucinate a
+ * title for trivial input, so we never ask it — the caller defers titling to
+ * the next message instead.
+ */
+export declare function isLowSignalTitleInput(message: string): boolean;
+/**
+ * Sentinel a capable title model may emit when a message carries no concrete
+ * task. Treated as "no title yet" so the caller can defer titling. Backstop for
+ * the deterministic {@link isLowSignalTitleInput} filter; kept in sync with the
+ * `none` instruction in `prompts/system/title-system.md`.
+ */
+export declare const NO_TITLE_SENTINEL = "none";
 export declare function normalizeGeneratedTitle(value: string | null | undefined): string | null;

package/dist/types/web/search/providers/base.d.ts

@@ -58,8 +58,22 @@ export declare abstract class SearchProvider {
      * Indicates whether this provider has the credentials/config it needs to
      * service a request right now. Implementations consult the passed
      * {@link AuthStorage} — never a sibling store.
+     *
+     * Drives auto-chain admission: providers that return `false` are skipped
+     * when {@link resolveProviderChain} walks the order. Explicit selection
+     * uses {@link isExplicitlyAvailable} instead.
      */
     abstract isAvailable(authStorage: AuthStorage): Promise<boolean> | boolean;
+    /**
+     * Returns `true` when this provider should run when the user explicitly
+     * selects it, even if {@link isAvailable} would reject it for the auto
+     * chain. Providers that ship an unauthenticated fallback (e.g. Exa's
+     * public MCP) override this so explicit selection still routes through
+     * the fallback rather than silently falling back to another provider.
+     *
+     * Defaults to mirroring {@link isAvailable}.
+     */
+    isExplicitlyAvailable(authStorage: AuthStorage): Promise<boolean> | boolean;
     /**
      * Execute a search. Credentials MUST be resolved through `params.authStorage`.
      */

package/dist/types/web/search/providers/exa.d.ts

@@ -50,9 +50,18 @@ export declare function buildExaRequestBody(params: ExaSearchParams): Record<str
 export declare function searchExa(params: ExaSearchParams): Promise<SearchResponse>;
 /** Search provider for Exa. */
 export declare class ExaProvider extends SearchProvider {
+    #private;
     readonly id = "exa";
     readonly label = "Exa";
     isAvailable(authStorage: AuthStorage): boolean;
+    /**
+     * Exa ships an unauthenticated public MCP fallback, so an explicit
+     * selection (programmatic or via `providers.webSearch: exa`) routes
+     * through MCP even when no credential is configured. The auto chain
+     * still uses {@link isAvailable} so an unrelated configured provider
+     * keeps priority over the public fallback.
+     */
+    isExplicitlyAvailable(_authStorage: AuthStorage): boolean;
     search(params: SearchParams): Promise<SearchResponse>;
 }
 export {};

package/dist/types/web/search/providers/perplexity.d.ts

@@ -16,11 +16,11 @@ export interface PerplexitySearchParams {
     system_prompt?: string;
     search_recency_filter?: "hour" | "day" | "week" | "month" | "year";
     num_results?: number;
-    /** Maximum output tokens. Defaults to 4096. */
+    /** Maximum output tokens. Defaults to 8192. */
     max_tokens?: number;
     /** Sampling temperature (0–1). Lower = more focused/factual. Defaults to 0.2. */
     temperature?: number;
-    /** Number of search results to retrieve. Defaults to 10. */
+    /** Number of search results to retrieve. Defaults to 20. */
     num_search_results?: number;
     authStorage: AuthStorage;
     sessionId?: string;

package/dist/types/web/search/types.d.ts

@@ -50,7 +50,7 @@ export declare const SEARCH_PROVIDER_OPTIONS: readonly [{
 }, {
     readonly value: "exa";
     readonly label: "Exa";
-    readonly description: "Requires EXA_API_KEY";
+    readonly description: "Uses Exa API when EXA_API_KEY is set; falls back to Exa MCP";
 }, {
     readonly value: "parallel";
     readonly label: "Parallel";
@@ -403,6 +403,7 @@ export interface PerplexityResponse {
     choices: PerplexityChoice[];
     citations?: string[] | null;
     search_results?: PerplexitySearchResult[] | null;
+    related_questions?: string[] | null;
     type?: PerplexityCompletionResponseType | null;
     status?: PerplexityCompletionResponseStatus | null;
 }