@oh-my-pi/pi-coding-agent 15.7.3 → 15.7.6

package/CHANGELOG.md

@@ -2,6 +2,66 @@
 
 ## [Unreleased]
 
+### Fixed
+
+- Fixed a module-load crash (`ReferenceError: Cannot access 'evalToolRenderer' before initialization`) triggered whenever `tools/eval` was imported before `tools/renderers`. The eval JS backend statically pulls the agent/task/sdk/extension chain, which re-enters the root barrel → `modes/components` → `tool-execution` → `renderers` while `eval.ts` was still initializing, so `renderers.ts` read `evalToolRenderer` in its TDZ. The eval TUI renderer is now split into a dependency-light `tools/eval-render.ts` that `renderers.ts` imports directly (decoupling pure rendering from the eval runtime); `eval.ts` re-exports `evalToolRenderer`/`EVAL_DEFAULT_PREVIEW_LINES` for compatibility.
+
+## [15.7.6] - 2026-06-01
+### Added
+
+- Added `ask` option descriptions so agents can keep short labels and render explanatory text as separate muted rows in the selector.
+- Added an extension API for rendering supplemental UI below visible assistant thinking blocks.
+- Added default-on `lsp.diagnosticsDeduplicate` support so post-edit LSP diagnostics already shown for a file are suppressed within the session and only new or changed diagnostics are surfaced.
+ 
+### Fixed
+
+- Fixed a single ESC press both dismissing the @/slash autocomplete popup and aborting the running agent operation. ESC now drains the popup first; only when no popup is visible does it route to the global interrupt handler (matching the standard TUI/IDE pattern). The `shouldBypassAutocompleteOnEscape` editor hook is removed — it had become the trigger for this bug ([#1655](https://github.com/can1357/oh-my-pi/issues/1655)).
+- Fixed Claude Code slash command discovery to load subdirectory commands recursively while preserving basename commands (e.g. `/apply`) and adding namespace aliases (e.g. `/opsx:apply`) for tools that install colon-namespaced workflows ([#1523](https://github.com/can1357/oh-my-pi/issues/1523)).
+- Fixed the `eval` tool's per-cell `timeout` killing cells that were not stalled. The timeout is now a plain wall-clock budget on the cell's **own** work that is **paused only while a host-side `agent()`/`parallel()`/`llm()` bridge call is in flight** — those calls pump a heartbeat that re-arms the watchdog, so a long fanout or a slow (e.g. reasoning-tier) completion runs to completion instead of being aborted mid-flight (a subagent's time-to-first-token, a long quiet nested tool, or an entire oneshot `llm()` request no longer trip it). Nothing else re-arms the budget: ordinary compute, `print`/stdout, `log()`/`phase()`, and non-agent tool calls all count against it, so a cell that is not delegating to an agent/llm is bounded by the regular wall-clock timeout (and the timeout message no longer says "of inactivity"). The heartbeat is a pure keepalive — never persisted or rendered.
+
+## [15.7.5] - 2026-06-01
+### Fixed
+
+- Fixed streaming assistant responses leaving duplicated tail rows in WSL/Windows Terminal scrollback by enabling eager native-scrollback rebuilds while assistant text is actively streaming ([#1615](https://github.com/can1357/oh-my-pi/issues/1615)).
+
+### Fixed
+
+- Fixed the `task` tool mangling subagent prompts when a model double-JSON-encodes a string argument: `context` and each task's `assignment`/`description` are now repaired when they arrive uniformly double-escaped (literal `\n`, `\"`, `\uXXXX`), so the subagent receives the intended prose and the call preview renders real newlines. The repair is guarded by a JSON-string round-trip and a double-encode signature, so legitimate backslashes/quotes (Windows paths, regexes, embedded quotes) are left untouched, and it is scoped to these natural-language fields only (never code-bearing tools).
+
+### Fixed
+
+- Fixed `pr://` PR views omitting formal review submissions and approvals when comments are enabled ([#1600](https://github.com/can1357/oh-my-pi/issues/1600)).
+
+### Fixed
+
+- Fixed subagent yield-reminder loop logging benign user/compaction aborts as `ERROR`. The catch around `session.prompt`/`waitForIdle` in `task/executor.ts` now demotes `ToolAbortError` and signal-aborted exits to `debug` and keeps `ERROR` for genuine prompt failures only ([#1623](https://github.com/can1357/oh-my-pi/issues/1623)).
+
+### Fixed
+
+- Fixed `read local://<file>` resolving to the wrong session's artifacts directory in multi-session ACP hosts (e.g. cmux). `LocalProtocolHandler.resolve` now honors `context.localProtocolOptions` supplied by the calling tool before falling back to the process-wide override or the first `main`-kind session in the global `AgentRegistry`; `read`, `find`, `search`, `ast_grep`, and `ast_edit` thread their session's options through so a `local://PLAN.md` lookup hits the calling session's `local` root instead of a sibling session's ([#1608](https://github.com/can1357/oh-my-pi/issues/1608)).
+
+### Fixed
+
+- Fixed `omp` segfaulting on exit on Windows after the tiny title/memory model loaded `onnxruntime-node` (issue [#1606](https://github.com/can1357/oh-my-pi/issues/1606)). The tiny model now runs in a Bun subprocess instead of a Worker thread, so the NAPI finalizer that crashes during shutdown never executes in the agent's address space; the subprocess is `SIGKILL`'d on dispose to skip every native destructor on every platform.
+
+### Fixed
+
+- Fixed unbounded MCP reconnect loop that could fork-bomb the host when a stdio MCP server completes the `initialize`/`tools/list` handshake and then exits. `MCPManager` now enforces a per-server crash circuit breaker (5 reconnects per 30 s window) on the automatic `transport.onClose` path; manual `/mcp reconnect` resets the window so users can recover after fixing the misconfiguration ([#1592](https://github.com/can1357/oh-my-pi/issues/1592)).
+
+### Fixed
+
+- Fixed auto context maintenance to include the pending prompt in the pre-send token estimate, so large user turns compact history before the provider rejects an over-limit request ([#1618](https://github.com/can1357/oh-my-pi/issues/1618)).
+
+## [15.7.4] - 2026-05-31
+
+### Removed
+
+- Removed `/shake summary`, the `shake-summary` auto-compaction strategy, and the `providers.shakeSummaryModel` setting. Use `/shake` or `compaction.strategy: shake` for mechanical artifact-backed elision without local-model CPU.
+
+### Fixed
+
+- Fixed plugin install failing for sources pinned to a SHA: `git.clone()` no longer adds `--depth 1` when `options.sha` is set, so the checkout of arbitrary commits succeeds instead of bailing out with "shallow clone may not contain this commit" ([#1589](https://github.com/can1357/oh-my-pi/issues/1589)).
+
 ## [15.7.3] - 2026-05-31
 ### Added
 
@@ -39,6 +99,10 @@
 
 ### Removed
 
+### Fixed
+
+- Fixed auto-discovered OpenAI-compatible / Ollama / llama.cpp / new-api proxy models defaulting to `maxTokens: 8192`, which made providers drop the streaming connection mid-response on large `write`/`edit` tool calls and surfaced as Bun's opaque `socket connection was closed unexpectedly`. The discovery cap is now `32_768` (`DISCOVERY_DEFAULT_MAX_TOKENS` in `packages/coding-agent/src/config/model-registry.ts`) and `min(contextWindow, …)` still honors smaller advertised context windows ([#1528](https://github.com/can1357/oh-my-pi/issues/1528)).
+
 - Removed the `/drop-images` slash command; use `/shake images`, which strips every image from the session through the same `dropImages()` path.
 
 ### Fixed
@@ -112,6 +176,10 @@
 
 - Removed the `recipe` tool and its `recipe.enabled` setting. Task-runner targets (just/package.json/Cargo/make/Taskfile) are invoked directly through `bash`.
 
+### Added
+
+- Added a `symbols.spinnerFrames` field to custom theme JSON so themes can override the loader/tool-execution spinner. Accepts either a flat `string[]` (used for both spinner types) or `{ "status"?: string[], "activity"?: string[] }` to override each independently; anything not specified falls back to the symbol preset. Documented in `docs/theme.md` and validated by `theme-schema.json`. ([#1553](https://github.com/can1357/oh-my-pi/issues/1553))
+
 ## [15.6.0] - 2026-05-30
 ### Added
 
@@ -9199,4 +9267,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/config/settings-schema.d.ts

@@ -1298,12 +1298,12 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "compaction.strategy": {
         readonly type: "enum";
-        readonly values: readonly ["context-full", "handoff", "shake", "shake-summary", "off"];
+        readonly values: readonly ["context-full", "handoff", "shake", "off"];
         readonly default: "context-full";
         readonly ui: {
             readonly tab: "context";
             readonly label: "Compaction Strategy";
-            readonly description: "Choose in-place context-full maintenance, auto-handoff, surgical shake (drop heavy content), shake with local-model summaries, or disable auto maintenance (off)";
+            readonly description: "Choose in-place context-full maintenance, auto-handoff, surgical shake (drop heavy content), or disable auto maintenance (off)";
             readonly options: readonly [{
                 readonly value: "context-full";
                 readonly label: "Context-full";
@@ -1316,10 +1316,6 @@ export declare const SETTINGS_SCHEMA: {
                 readonly value: "shake";
                 readonly label: "Shake";
                 readonly description: "Drop heavy content (tool results + large blocks) in place; recover via artifact";
-            }, {
-                readonly value: "shake-summary";
-                readonly label: "Shake (summary)";
-                readonly description: "Shake, but compress heavy regions with a local on-device model instead of dropping";
             }, {
                 readonly value: "off";
                 readonly label: "Off";
@@ -2303,6 +2299,15 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Return LSP diagnostics after editing code files";
         };
     };
+    readonly "lsp.diagnosticsDeduplicate": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "editing";
+            readonly label: "Deduplicate Diagnostics";
+            readonly description: "Suppress post-edit LSP diagnostics already shown for a file; only surface new or changed ones";
+        };
+    };
     readonly "bashInterceptor.enabled": {
         readonly type: "boolean";
         readonly default: false;
@@ -3560,21 +3565,6 @@ export declare const SETTINGS_SCHEMA: {
             })[];
         };
     };
-    readonly "providers.shakeSummaryModel": {
-        readonly type: "enum";
-        readonly values: readonly ["qwen3-1.7b", "gemma-3-1b", "qwen2.5-1.5b", "lfm2-1.2b"];
-        readonly default: "gemma-3-1b" | "lfm2-1.2b" | "qwen2.5-1.5b" | "qwen3-1.7b";
-        readonly ui: {
-            readonly tab: "context";
-            readonly label: "Shake Summary Model";
-            readonly description: "Local on-device model used by /shake summary and the shake-summary compaction strategy to compress heavy regions. Runs entirely on-device; downloads on first use. Falls back to plain elide when unavailable.";
-            readonly options: {
-                value: "gemma-3-1b" | "lfm2-1.2b" | "qwen2.5-1.5b" | "qwen3-1.7b";
-                label: "Gemma 3 1B" | "LFM2 1.2B" | "Qwen2.5 1.5B" | "Qwen3 1.7B";
-                description: "Best consolidation/dedup; lighter footprint, but leaks small talk during extraction." | "Best extraction granularity (atomic facts); weaker consolidation." | "Fastest load; solid all-rounder, slightly noisier extraction labels." | "Recommended; most disciplined extraction (ignores chit-chat), good consolidation, about 1.1 GB cached.";
-            }[];
-        };
-    };
     readonly "providers.kimiApiFormat": {
         readonly type: "enum";
         readonly values: readonly ["openai", "anthropic"];
@@ -3868,7 +3858,7 @@ export type StatusLineSeparatorStyle = SettingValue<"statusLine.separator">;
 export type TreeFilterMode = SettingValue<"treeFilterMode">;
 export interface CompactionSettings {
     enabled: boolean;
-    strategy: "context-full" | "handoff" | "shake" | "shake-summary" | "off";
+    strategy: "context-full" | "handoff" | "shake" | "off";
     thresholdPercent: number;
     thresholdTokens: number;
     reserveTokens: number;

package/dist/types/eval/__tests__/heartbeat.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/eval/heartbeat.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Keepalive for in-flight host-side eval bridge calls.
+ *
+ * The eval watchdog ({@link ../tools/eval IdleTimeout}) caps a cell's `timeout`
+ * as a wall-clock budget on the cell's *own* work, but pauses that budget while
+ * a host-side `agent()`/`parallel()` (via `runSubprocess`) or `llm()` (a single
+ * completion) call is in flight. Those calls are the only thing that re-arms the
+ * watchdog — and they can run for long stretches with **no** status of their own
+ * (a subagent's time-to-first-token on a reasoning model, a long quiet nested
+ * tool, or the entire body of a oneshot `llm()` call). Without a keepalive the
+ * watchdog would mistake that delegated work for the cell stalling and abort it
+ * mid-flight, killing the subagent.
+ *
+ * {@link withBridgeHeartbeat} bridges that gap by emitting a synthetic
+ * {@link EVAL_HEARTBEAT_OP} status event immediately when the call begins and
+ * then on a fixed cadence until it settles. The event rides the same
+ * `emitStatus → onStatus` channel both runtimes already forward, so it re-arms
+ * the watchdog without any new plumbing. The heartbeat is the *sole* signal that
+ * extends the budget: consumers MUST treat it as a pure keepalive — bump the
+ * watchdog and drop it (never persist or render it) — see the executor display
+ * sinks and the eval tool's `onStatus` handler. Every other status event
+ * (compute helpers, `log()`/`phase()`, tool results) counts against the budget.
+ */
+import type { JsStatusEvent } from "./js/shared/types";
+/**
+ * Synthetic status op emitted purely to keep the eval idle watchdog alive while
+ * a host-side bridge call is in flight. Carries no payload.
+ */
+export declare const EVAL_HEARTBEAT_OP = "heartbeat";
+/**
+ * Test seam: override the heartbeat cadence so integration tests can exercise
+ * the keepalive within a sub-second idle budget. Pass no value to restore the
+ * production default.
+ */
+export declare function setBridgeHeartbeatIntervalMs(ms?: number): void;
+/**
+ * Run {@link operation}, pumping {@link EVAL_HEARTBEAT_OP} status events through
+ * {@link emitStatus} — one immediately, then on a fixed cadence — until it
+ * settles. The immediate beat pauses the watchdog the instant the call begins,
+ * so a bridge call that starts close to the budget edge (after the cell already
+ * spent most of it computing) is not aborted before the first interval tick. A
+ * no-op wrapper when no `emitStatus` sink is wired (the heartbeat would reach
+ * nobody).
+ */
+export declare function withBridgeHeartbeat<T>(emitStatus: ((event: JsStatusEvent) => void) | undefined, operation: () => Promise<T>): Promise<T>;

package/dist/types/extensibility/custom-tools/types.d.ts

@@ -86,10 +86,10 @@ export type CustomToolSessionEvent = {
 } | {
     reason: "auto_compaction_start";
     trigger: "threshold" | "overflow" | "idle" | "incomplete";
-    action: "context-full" | "handoff" | "shake" | "shake-summary";
+    action: "context-full" | "handoff" | "shake";
 } | {
     reason: "auto_compaction_end";
-    action: "context-full" | "handoff" | "shake" | "shake-summary";
+    action: "context-full" | "handoff" | "shake";
     result: CompactionResult | undefined;
     aborted: boolean;
     willRetry: boolean;

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

@@ -1,6 +1,6 @@
 import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import { EventBus } from "../../utils/event-bus";
-import type { Extension, ExtensionFactory, ExtensionRuntime as IExtensionRuntime, LoadExtensionsResult } from "./types";
+import type { Extension, ExtensionFactory, ExtensionRuntime as IExtensionRuntime, LoadExtensionsResult, ProviderConfig } from "./types";
 export declare class ExtensionRuntimeNotInitializedError extends Error {
     constructor();
 }
@@ -12,7 +12,7 @@ export declare class ExtensionRuntime implements IExtensionRuntime {
     flagValues: Map<string, string | boolean>;
     pendingProviderRegistrations: Array<{
         name: string;
-        config: import("./types").ProviderConfig;
+        config: ProviderConfig;
         sourceId: string;
     }>;
     sendMessage(): void;

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

@@ -6,7 +6,7 @@ import type { CredentialDisabledEvent, ImageContent, Model, ProviderResponseMeta
 import type { KeyId } from "@oh-my-pi/pi-tui";
 import type { ModelRegistry } from "../../config/model-registry";
 import type { SessionManager } from "../../session/session-manager";
-import type { AfterProviderResponseEvent, BeforeAgentStartEvent, BeforeAgentStartEventResult, BeforeProviderRequestEvent, BeforeProviderRequestEventResult, ContextEvent, Extension, ExtensionActions, ExtensionCommandContext, ExtensionCommandContextActions, ExtensionContext, ExtensionContextActions, ExtensionError, ExtensionEvent, ExtensionFlag, ExtensionRuntime, ExtensionShortcut, ExtensionUIContext, InputEvent, InputEventResult, MessageRenderer, RegisteredCommand, RegisteredTool, ResourcesDiscoverEvent, SessionBeforeBranchResult, SessionBeforeCompactResult, SessionBeforeSwitchResult, SessionBeforeTreeResult, SessionCompactingResult, ToolCallEvent, ToolCallEventResult, ToolResultEvent, ToolResultEventResult, UserBashEvent, UserBashEventResult, UserPythonEvent, UserPythonEventResult } from "./types";
+import type { AfterProviderResponseEvent, AssistantThinkingRenderer, BeforeAgentStartEvent, BeforeAgentStartEventResult, BeforeProviderRequestEvent, BeforeProviderRequestEventResult, ContextEvent, Extension, ExtensionActions, ExtensionCommandContext, ExtensionCommandContextActions, ExtensionContext, ExtensionContextActions, ExtensionError, ExtensionEvent, ExtensionFlag, ExtensionRuntime, ExtensionShortcut, ExtensionUIContext, InputEvent, InputEventResult, MessageRenderer, RegisteredCommand, RegisteredTool, ResourcesDiscoverEvent, SessionBeforeBranchResult, SessionBeforeCompactResult, SessionBeforeSwitchResult, SessionBeforeTreeResult, SessionCompactingResult, ToolCallEvent, ToolCallEventResult, ToolResultEvent, ToolResultEventResult, UserBashEvent, UserBashEventResult, UserPythonEvent, UserPythonEventResult } from "./types";
 /** Combined result from all before_agent_start handlers */
 interface BeforeAgentStartCombinedResult {
     messages?: NonNullable<BeforeAgentStartEventResult["message"]>[];
@@ -98,6 +98,7 @@ export declare class ExtensionRunner {
     emitError(error: ExtensionError): void;
     hasHandlers(eventType: string): boolean;
     getMessageRenderer(customType: string): MessageRenderer | undefined;
+    getAssistantThinkingRenderers(): AssistantThinkingRenderer[];
     getRegisteredCommands(reserved?: Set<string>): RegisteredCommand[];
     getCommandDiagnostics(): Array<{
         type: string;

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

@@ -13,6 +13,8 @@ import type { Api, AssistantMessageEvent, AssistantMessageEventStream, Context,
 import type { OAuthCredentials, OAuthLoginCallbacks } from "@oh-my-pi/pi-ai/utils/oauth/types";
 import type * as piCodingAgent from "@oh-my-pi/pi-coding-agent";
 import type { AutocompleteItem, Component, EditorTheme, KeyId, TUI } from "@oh-my-pi/pi-tui";
+import type { logger as PiLogger } from "@oh-my-pi/pi-utils";
+import type * as Zod from "zod/v4";
 import type { KeybindingsManager } from "../../config/keybindings";
 import type { ModelRegistry } from "../../config/model-registry";
 import type { EditToolDetails } from "../../edit";
@@ -27,9 +29,16 @@ import type { BashToolDetails, BashToolInput, FindToolDetails, FindToolInput, Re
 import type { EventBus } from "../../utils/event-bus";
 import type { AgentEndEvent, AgentStartEvent, AutoCompactionEndEvent, AutoCompactionStartEvent, AutoRetryEndEvent, AutoRetryStartEvent, ContextEvent, GoalUpdatedEvent, SessionBeforeBranchEvent, SessionBeforeBranchResult, SessionBeforeCompactEvent, SessionBeforeCompactResult, SessionBeforeSwitchEvent, SessionBeforeSwitchResult, SessionBeforeTreeEvent, SessionBeforeTreeResult, SessionBranchEvent, SessionCompactEvent, SessionCompactingEvent, SessionCompactingResult, SessionEvent, SessionShutdownEvent, SessionStartEvent, SessionSwitchEvent, SessionTreeEvent, TodoReminderEvent, ToolCallEventResult, ToolResultEventResult, TtsrTriggeredEvent, TurnEndEvent, TurnStartEvent } from "../shared-events";
 import type { SlashCommandInfo } from "../slash-commands";
+import type * as TypeBox from "../typebox";
 export type { AppKeybinding, KeybindingsManager } from "../../config/keybindings";
 export type { ExecOptions, ExecResult } from "../../exec/exec";
 export type { AgentToolResult, AgentToolUpdateCallback };
+export interface ExtensionUISelectOption {
+    label: string;
+    description?: string;
+}
+export type ExtensionUISelectItem = string | ExtensionUISelectOption;
+export declare function getExtensionUISelectOptionLabel(option: ExtensionUISelectItem): string;
 /**
  * UI dialog options for extensions.
  */
@@ -70,8 +79,8 @@ export type ExtensionWidgetContent = string[] | ExtensionUiComponentFactory | un
  * Each mode (interactive, RPC, print) provides its own implementation.
  */
 export interface ExtensionUIContext {
-    /** Show a selector and return the user's choice. */
-    select(title: string, options: string[], dialogOptions?: ExtensionUIDialogOptions): Promise<string | undefined>;
+    /** Show a selector and return the selected label, even when an option also includes a description. */
+    select(title: string, options: ExtensionUISelectItem[], dialogOptions?: ExtensionUIDialogOptions): Promise<string | undefined>;
     /** Show a confirmation dialog. */
     confirm(title: string, message: string, dialogOptions?: ExtensionUIDialogOptions): Promise<boolean>;
     /** Show a text input dialog. */
@@ -508,6 +517,13 @@ export interface MessageRenderOptions {
     expanded: boolean;
 }
 export type MessageRenderer<T = unknown> = (message: CustomMessage<T>, options: MessageRenderOptions, theme: Theme) => Component | undefined;
+export interface AssistantThinkingRenderContext {
+    contentIndex: number;
+    thinkingIndex: number;
+    text: string;
+    requestRender(): void;
+}
+export type AssistantThinkingRenderer = (context: AssistantThinkingRenderContext, theme: Theme) => Component | undefined;
 export interface RegisteredCommand {
     name: string;
     description?: string;
@@ -521,11 +537,11 @@ export type ExtensionHandler<E, R = undefined> = (event: E, ctx: ExtensionContex
  */
 export interface ExtensionAPI {
     /** File logger for error/warning/debug messages */
-    logger: typeof import("@oh-my-pi/pi-utils").logger;
+    logger: typeof PiLogger;
     /** Injected zod-backed typebox shim for legacy `Type.Object(...)` parameter authoring. */
-    typebox: typeof import("../typebox");
+    typebox: typeof TypeBox;
     /** Injected zod module for Zod-authored extension tools (canonical going forward). */
-    zod: typeof import("zod/v4");
+    zod: typeof Zod;
     /** Injected pi-coding-agent exports for accessing SDK utilities */
     pi: typeof piCodingAgent;
     on(event: "resources_discover", handler: ExtensionHandler<ResourcesDiscoverEvent, ResourcesDiscoverResult>): void;
@@ -592,6 +608,8 @@ export interface ExtensionAPI {
     getFlag(name: string): boolean | string | undefined;
     /** Register a custom renderer for CustomMessageEntry. */
     registerMessageRenderer<T = unknown>(customType: string, renderer: MessageRenderer<T>): void;
+    /** Register a renderer for assistant thinking blocks. Rendered after the original thinking text. */
+    registerAssistantThinkingRenderer(renderer: AssistantThinkingRenderer): void;
     /**
      * Send a custom message to the session.
      *
@@ -840,6 +858,7 @@ export interface Extension {
     label?: string;
     handlers: Map<string, HandlerFn[]>;
     tools: Map<string, RegisteredTool<any, any>>;
+    assistantThinkingRenderers: AssistantThinkingRenderer[];
     messageRenderers: Map<string, MessageRenderer>;
     commands: Map<string, RegisteredCommand>;
     flags: Map<string, ExtensionFlag>;

package/dist/types/extensibility/shared-events.d.ts

@@ -160,12 +160,12 @@ export interface TurnEndEvent {
 export interface AutoCompactionStartEvent {
     type: "auto_compaction_start";
     reason: "threshold" | "overflow" | "idle" | "incomplete";
-    action: "context-full" | "handoff" | "shake" | "shake-summary";
+    action: "context-full" | "handoff" | "shake";
 }
 /** Fired when auto-compaction ends */
 export interface AutoCompactionEndEvent {
     type: "auto_compaction_end";
-    action: "context-full" | "handoff" | "shake" | "shake-summary";
+    action: "context-full" | "handoff" | "shake";
     result: CompactionResult | undefined;
     aborted: boolean;
     willRetry: boolean;

package/dist/types/internal-urls/local-protocol.d.ts

@@ -1,4 +1,4 @@
-import type { InternalResource, InternalUrl, ProtocolHandler, UrlCompletion } from "./types";
+import type { InternalResource, InternalUrl, ProtocolHandler, ResolveContext, UrlCompletion } from "./types";
 export interface LocalProtocolOptions {
     getArtifactsDir?: () => string | null;
     getSessionId?: () => string | null;
@@ -28,13 +28,23 @@ export declare class LocalProtocolHandler implements ProtocolHandler {
      * Returns the active local-protocol options.
      *
      * Resolution order:
-     * 1. Explicit override installed via {@link setOverride} (used by subagents
-     *    that share their parent's root and by SDK consumers with a custom
-     *    artifacts/session id mapping).
-     * 2. The main session in `AgentRegistry.global()`. Its `SessionManager`
-     *    supplies both `getArtifactsDir` and `getSessionId`.
+     * 1. **Caller-supplied** `context.localProtocolOptions` (the actual session
+     *    that initiated the `read`/`find`/`search`/`router.resolve` call). This
+     *    is what keeps `local://` reads pinned to the calling session in
+     *    multi-session hosts (cmux/ACP, embedded SDK consumers) where every
+     *    session registers as `kind: "main"` and "first one wins" would route
+     *    to the wrong artifacts directory.
+     * 2. Explicit process-global override installed via {@link setOverride}
+     *    (used by SDK consumers with a custom artifacts/session-id mapping and
+     *    by code paths that do not have a calling session, e.g. TUI hyperlink
+     *    resolution).
+     * 3. The first `main`-kind session in `AgentRegistry.global()`. Its
+     *    `SessionManager` supplies both `getArtifactsDir` and `getSessionId`.
+     *    Last-resort fallback — every caller that has a session reference
+     *    SHOULD thread it through `context` so this branch is never taken in
+     *    multi-session setups.
      */
-    static resolveOptions(): LocalProtocolOptions | undefined;
-    resolve(url: InternalUrl): Promise<InternalResource>;
-    complete(): Promise<UrlCompletion[]>;
+    static resolveOptions(context?: ResolveContext): LocalProtocolOptions | undefined;
+    resolve(url: InternalUrl, context?: ResolveContext): Promise<InternalResource>;
+    complete(_query?: string, context?: ResolveContext): Promise<UrlCompletion[]>;
 }

package/dist/types/internal-urls/types.d.ts

@@ -4,6 +4,7 @@
  * Internal URLs (agent://, artifact://, memory://, skill://, rule://, mcp://, omp://, local://) are resolved by tools like read,
  * providing access to agent outputs and server resources without exposing filesystem paths.
  */
+import type { LocalProtocolOptions } from "./local-protocol";
 /**
  * Raw resource payload returned by protocol handlers. The `immutable` flag is
  * applied by the router from {@link ProtocolHandler.immutable}, so handlers do
@@ -73,6 +74,17 @@ export interface ResolveContext {
     settings?: unknown;
     /** Caller's abort signal. */
     signal?: AbortSignal;
+    /**
+     * Calling session's `local://` root mapping. When present, the local-protocol
+     * handler resolves the URL against THIS session's artifacts dir instead of
+     * picking the first `main`-kind session from the global `AgentRegistry`.
+     *
+     * Required for correctness in multi-session hosts (cmux/ACP, embedded SDK
+     * consumers) where multiple sessions are registered as `main` and the
+     * "first one wins" lookup picks the wrong artifacts directory — see
+     * [#1608](https://github.com/can1357/oh-my-pi/issues/1608).
+     */
+    localProtocolOptions?: LocalProtocolOptions;
 }
 /**
  * Caller context for write operations dispatched to host-owned URI handlers.
@@ -84,6 +96,8 @@ export interface WriteContext {
     cwd?: string;
     /** Caller's abort signal. */
     signal?: AbortSignal;
+    /** Calling session's `local://` root mapping — see {@link ResolveContext.localProtocolOptions}. */
+    localProtocolOptions?: LocalProtocolOptions;
 }
 /**
  * Handler for a specific internal URL scheme (e.g., agent://, memory://, skill://, mcp://).

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

@@ -39,6 +39,9 @@ export declare function notifySaved(client: LspClient, filePath: string, signal?
  * Increments version, sends didChange and didSave notifications.
  */
 export declare function refreshFile(client: LspClient, filePath: string, signal?: AbortSignal): Promise<void>;
+/**
+ * Shutdown a specific client by key.
+ */
 export declare function shutdownClient(key: string): Promise<void>;
 /**
  * Send an LSP request and wait for response.

package/dist/types/lsp/diagnostics-ledger.d.ts

@@ -0,0 +1,10 @@
+import type { FileDiagnosticsResult } from "./index";
+export declare function diagnosticIdentity(message: string): string;
+export declare class DiagnosticsLedger {
+    #private;
+    reduce(absPath: string, result: FileDiagnosticsResult): FileDiagnosticsResult;
+}
+export interface DiagnosticsLedgerOwner {
+    diagnosticsLedger?: DiagnosticsLedger;
+}
+export declare function getDiagnosticsLedger(owner: DiagnosticsLedgerOwner): DiagnosticsLedger;

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

@@ -71,6 +71,8 @@ export interface WritethroughOptions {
     onDeferredDiagnostics?: (diagnostics: FileDiagnosticsResult) => void;
     /** Signal to cancel a pending deferred diagnostics fetch. */
     deferredSignal?: AbortSignal;
+    /** Transform diagnostics before surfacing them after a successful fetch. */
+    transformDiagnostics?: (absPath: string, result: FileDiagnosticsResult) => FileDiagnosticsResult;
 }
 /** Per-file deferred LSP diagnostics wiring for {@link WritethroughCallback}. */
 export type WritethroughDeferredHandle = {

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

@@ -39,6 +39,10 @@ export declare function formatGroupedDiagnosticMessages(messages: string[]): str
  * Format diagnostics grouped by severity.
  */
 export declare function formatDiagnosticsSummary(diagnostics: Diagnostic[]): string;
+export declare function summarizeDiagnosticMessages(messages: string[]): {
+    summary: string;
+    errored: boolean;
+};
 /**
  * Format a location as file:line:col relative to cwd.
  */

package/dist/types/mcp/manager.d.ts

@@ -130,12 +130,21 @@ export declare class MCPManager {
     disconnectAll(): Promise<void>;
     /**
      * Reconnect to a server after a connection failure.
+     *
      * Tears down the stale connection, re-resolves auth, establishes a new
-     * connection, reloads tools, and notifies consumers.
-     * Concurrent calls for the same server share one reconnection attempt.
-     * Returns the new connection, or null if reconnection failed.
-     */
-    reconnectServer(name: string): Promise<MCPServerConnection | null>;
+     * connection, reloads tools, and notifies consumers. Concurrent calls for
+     * the same server share one reconnection attempt. Returns the new
+     * connection, or `null` if reconnection failed or the per-server crash
+     * burst limit (see {@link RECONNECT_BURST_LIMIT}) is exceeded.
+     *
+     * @param options.manual - When `true`, resets the crash-burst window so a
+     *   user-driven retry (e.g. `/mcp reconnect`) is never blocked by an
+     *   earlier storm. Defaults to `false`; the transport `onClose` callback
+     *   and the per-tool-call retry path in `tool-bridge` MUST NOT set it.
+     */
+    reconnectServer(name: string, options?: {
+        manual?: boolean;
+    }): Promise<MCPServerConnection | null>;
     /**
      * Refresh tools from a specific server.
      */

package/dist/types/modes/acp/acp-agent.d.ts

@@ -1,5 +1,5 @@
 import { type Agent, type AgentSideConnection, type AuthenticateRequest, type AuthenticateResponse, type ClientCapabilities, type CloseSessionRequest, type CloseSessionResponse, type ForkSessionRequest, type ForkSessionResponse, type InitializeRequest, type InitializeResponse, type ListSessionsRequest, type ListSessionsResponse, type LoadSessionRequest, type LoadSessionResponse, type NewSessionRequest, type NewSessionResponse, type PromptRequest, type PromptResponse, type ResumeSessionRequest, type ResumeSessionResponse, type SetSessionConfigOptionRequest, type SetSessionConfigOptionResponse, type SetSessionModelRequest, type SetSessionModelResponse, type SetSessionModeRequest, type SetSessionModeResponse } from "@agentclientprotocol/sdk";
-import type { ExtensionUIContext } from "../../extensibility/extensions";
+import { type ExtensionUIContext } from "../../extensibility/extensions";
 import type { AgentSession } from "../../session/agent-session";
 /**
  * Delay between `session/new` (or `session/load` / `session/resume` /

package/dist/types/modes/components/assistant-message.d.ts

@@ -1,5 +1,6 @@
 import type { AssistantMessage, ImageContent, Usage } from "@oh-my-pi/pi-ai";
 import { Container } from "@oh-my-pi/pi-tui";
+import type { AssistantThinkingRenderer } from "../../extensibility/extensions/types";
 /**
  * Component that renders a complete assistant message
  */
@@ -7,7 +8,8 @@ export declare class AssistantMessageComponent extends Container {
     #private;
     private hideThinkingBlock;
     private readonly onImageUpdate?;
-    constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: (() => void) | undefined);
+    private readonly thinkingRenderers;
+    constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: (() => void) | undefined, thinkingRenderers?: readonly AssistantThinkingRenderer[]);
     invalidate(): void;
     setHideThinkingBlock(hide: boolean): void;
     setToolResultImages(toolCallId: string, images: ImageContent[]): void;

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

@@ -10,7 +10,6 @@ export declare class CustomEditor extends Editor {
      *  them, skipping any occurrence inside code spans, fenced blocks, or XML sections. */
     decorateText: (text: string) => string;
     onEscape?: () => void;
-    shouldBypassAutocompleteOnEscape?: () => boolean;
     onClear?: () => void;
     onExit?: () => void;
     onCycleThinkingLevel?: () => void;

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

@@ -42,9 +42,15 @@ export interface HookSelectorOptions {
     helpText?: string;
     slider?: HookSelectorSlider;
 }
+export interface HookSelectorOption {
+    label: string;
+    description?: string;
+}
+export type HookSelectorOptionInput = string | HookSelectorOption;
 export declare class HookSelectorComponent extends Container {
     #private;
-    constructor(title: string, options: string[], onSelect: (option: string) => void, onCancel: () => void, opts?: HookSelectorOptions);
+    constructor(title: string, options: HookSelectorOptionInput[], onSelect: (option: string) => void, onCancel: () => void, opts?: HookSelectorOptions);
     handleInput(keyData: string): void;
+    render(width: number): string[];
     dispose(): void;
 }

package/dist/types/modes/controllers/command-controller.d.ts

@@ -31,9 +31,8 @@ export declare class CommandController {
     handlePythonCommand(code: string, excludeFromContext?: boolean): Promise<void>;
     handleCompactCommand(customInstructions?: string): Promise<CompactionOutcome>;
     /**
-     * TUI handler for `/shake`. `elide`/`images` are instant structural drops;
-     * `summary` runs the local on-device compressor behind a cancelable loader
-     * (Esc aborts via `abortCompaction`). Rebuilds the chat and reports counts.
+     * TUI handler for `/shake`. `elide` drops heavy structural content and
+     * `images` strips image blocks. Rebuilds the chat and reports counts.
      */
     handleShakeCommand(mode: ShakeMode): Promise<void>;
     handleSkillCommand(skillPath: string, args: string): Promise<void>;

package/dist/types/modes/controllers/extension-ui-controller.d.ts

@@ -1,6 +1,6 @@
 import type { Component, TUI } from "@oh-my-pi/pi-tui";
 import { KeybindingsManager } from "../../config/keybindings";
-import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionWidgetContent, ExtensionWidgetOptions, TerminalInputHandler } from "../../extensibility/extensions";
+import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions, TerminalInputHandler } from "../../extensibility/extensions";
 import { type HookSelectorSlider } from "../../modes/components/hook-selector";
 import { type Theme } from "../../modes/theme/theme";
 import type { InteractiveModeContext } from "../../modes/types";
@@ -30,7 +30,7 @@ export declare class ExtensionUiController {
     /**
      * Show a selector for hooks.
      */
-    showHookSelector(title: string, options: string[], dialogOptions?: ExtensionUIDialogOptions, extra?: {
+    showHookSelector(title: string, options: ExtensionUISelectItem[], dialogOptions?: ExtensionUIDialogOptions, extra?: {
         slider?: HookSelectorSlider;
     }): Promise<string | undefined>;
     /**

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

@@ -5,7 +5,7 @@ import type { Component, EditorTheme } from "@oh-my-pi/pi-tui";
 import { Container, Loader, Spacer, Text, TUI } from "@oh-my-pi/pi-tui";
 import { KeybindingsManager } from "../config/keybindings";
 import { Settings } from "../config/settings";
-import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
+import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
 import type { CompactOptions } from "../extensibility/extensions/types";
 import { type PlanApprovalDetails } from "../plan-mode/approved-plan";
 import type { AgentSession, AgentSessionEvent } from "../session/agent-session";
@@ -253,7 +253,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     emitCustomToolSessionEvent(reason: "start" | "switch" | "branch" | "tree" | "shutdown", previousSessionFile?: string): Promise<void>;
     setHookWidget(key: string, content: ExtensionWidgetContent, options?: ExtensionWidgetOptions): void;
     setHookStatus(key: string, text: string | undefined): void;
-    showHookSelector(title: string, options: string[], dialogOptions?: ExtensionUIDialogOptions, extra?: {
+    showHookSelector(title: string, options: ExtensionUISelectItem[], dialogOptions?: ExtensionUIDialogOptions, extra?: {
         slider?: HookSelectorSlider;
     }): Promise<string | undefined>;
     hideHookSelector(): void;

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

@@ -1,4 +1,4 @@
-import type { ExtensionUIContext, ExtensionUIDialogOptions } from "../../extensibility/extensions";
+import { type ExtensionUIContext, type ExtensionUIDialogOptions } from "../../extensibility/extensions";
 import type { AgentSession } from "../../session/agent-session";
 import type { RpcExtensionUIRequest, RpcExtensionUIResponse, RpcHostToolCallRequest, RpcHostToolCancelRequest, RpcHostUriCancelRequest, RpcHostUriRequest, RpcResponse } from "./rpc-types";
 export type * from "./rpc-types";