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

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## [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
 
@@ -31,6 +48,10 @@
 
 - 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
@@ -78,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
@@ -151,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
 
@@ -9238,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

@@ -2299,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;

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/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/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/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/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";

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

@@ -17,7 +17,7 @@ export declare class Theme {
     #private;
     private readonly mode;
     private readonly symbolPreset;
-    constructor(fgColors: Record<ThemeColor, string | number>, bgColors: Record<ThemeBg, string | number>, mode: ColorMode, symbolPreset: SymbolPreset, symbolOverrides: Partial<Record<SymbolKey, string>>);
+    constructor(fgColors: Record<ThemeColor, string | number>, bgColors: Record<ThemeBg, string | number>, mode: ColorMode, symbolPreset: SymbolPreset, symbolOverrides: Partial<Record<SymbolKey, string>>, spinnerFramesOverrides?: Partial<Record<SpinnerType, string[]>>);
     fg(color: ThemeColor, text: string): string;
     bg(color: ThemeBg, text: string): string;
     bold(text: string): string;

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

@@ -4,7 +4,7 @@ import type { AssistantMessage, ImageContent, Message, UsageReport } from "@oh-m
 import type { Component, Container, EditorTheme, Loader, Spacer, Text, TUI } from "@oh-my-pi/pi-tui";
 import type { KeybindingsManager } from "../config/keybindings";
 import type { 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 { MCPManager } from "../mcp";
 import type { PlanApprovalDetails } from "../plan-mode/approved-plan";
@@ -264,7 +264,7 @@ export interface 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): Promise<string | undefined>;
+    showHookSelector(title: string, options: ExtensionUISelectItem[], dialogOptions?: ExtensionUIDialogOptions): Promise<string | undefined>;
     hideHookSelector(): void;
     showHookInput(title: string, placeholder?: string): Promise<string | undefined>;
     hideHookInput(): void;

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

@@ -438,8 +438,15 @@ export declare class AgentSession {
     /**
      * Replace MCP tools in the registry and recompute the visible MCP tool set immediately.
      * This allows /mcp add/remove/reauth to take effect without restarting the session.
+     *
+     * @param mcpTools The new MCP tools to register.
+     * @param options.activateAll When true, force-activates every newly registered MCP tool
+     *   regardless of prior selection state. Used when an ACP client provisions MCP servers
+     *   for a session where MCP discovery is disabled.
      */
-    refreshMCPTools(mcpTools: CustomTool[]): Promise<void>;
+    refreshMCPTools(mcpTools: CustomTool[], options?: {
+        activateAll?: boolean;
+    }): Promise<void>;
     /**
      * Replace RPC host-owned tools and refresh the active tool set before the next model call.
      */

package/dist/types/tools/ask.d.ts

@@ -26,6 +26,7 @@ declare const askSchema: z.ZodObject<{
         question: z.ZodString;
         options: z.ZodArray<z.ZodObject<{
             label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         multi: z.ZodOptional<z.ZodBoolean>;
         recommended: z.ZodOptional<z.ZodNumber>;
@@ -71,6 +72,7 @@ export declare class AskTool implements AgentTool<typeof askSchema, AskToolDetai
             question: z.ZodString;
             options: z.ZodArray<z.ZodObject<{
                 label: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             multi: z.ZodOptional<z.ZodBoolean>;
             recommended: z.ZodOptional<z.ZodNumber>;
@@ -82,18 +84,18 @@ export declare class AskTool implements AgentTool<typeof askSchema, AskToolDetai
     static createIf(session: ToolSession): AskTool | null;
     execute(_toolCallId: string, params: AskParams, signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<AskToolDetails>, context?: AgentToolContext): Promise<AgentToolResult<AskToolDetails>>;
 }
+interface AskRenderOption {
+    label: string;
+    description?: string;
+}
 interface AskRenderArgs {
     question?: string;
-    options?: Array<{
-        label: string;
-    }>;
+    options?: AskRenderOption[];
     multi?: boolean;
     questions?: Array<{
         id: string;
         question: string;
-        options: Array<{
-            label: string;
-        }>;
+        options: AskRenderOption[];
         multi?: boolean;
     }>;
 }

package/dist/types/tools/eval-backends.d.ts

@@ -0,0 +1,12 @@
+import type { ToolSession } from ".";
+export interface EvalBackendsAllowance {
+    python: boolean;
+    js: boolean;
+}
+/** Read per-backend allowance from settings (defaults true). */
+export declare function readEvalBackendsAllowance(session: ToolSession): EvalBackendsAllowance;
+/**
+ * Materialize the active eval backend allowance: PI_PY / PI_JS env flags
+ * override the per-key settings; otherwise settings (defaults true) win.
+ */
+export declare function resolveEvalBackends(session: ToolSession): EvalBackendsAllowance;

package/dist/types/tools/eval-render.d.ts

@@ -0,0 +1,52 @@
+/**
+ * TUI rendering for the eval tool.
+ *
+ * Split out from `eval.ts` so the renderer can be imported by `renderers.ts`
+ * without dragging the eval *runtime* (JS/Python backends -> agent bridge ->
+ * task executor -> sdk -> extension loader -> root barrel) into the renderer
+ * module graph. That transitive chain re-enters `renderers.ts` while `eval.ts`
+ * is still initializing, which previously crashed module load with a TDZ
+ * `Cannot access 'evalToolRenderer' before initialization`.
+ */
+import type { Component } from "@oh-my-pi/pi-tui";
+import type { EvalStatusEvent, EvalToolDetails } from "../eval/types";
+import type { RenderResultOptions } from "../extensibility/custom-tools/types";
+import { type Theme } from "../modes/theme/theme";
+export declare const EVAL_DEFAULT_PREVIEW_LINES = 10;
+interface EvalRenderCellArg {
+    language?: string;
+    code?: string;
+    title?: string;
+}
+interface EvalRenderArgs {
+    cells?: EvalRenderCellArg[];
+    __partialJson?: string;
+}
+interface EvalRenderContext {
+    output?: string;
+    expanded?: boolean;
+    previewLines?: number;
+    timeout?: number;
+}
+/**
+ * Append or replace a status event. `agent` events are progress snapshots keyed
+ * by `id`, so they coalesce in place (preserving first-seen order); every other
+ * op is a discrete action and simply appends. Keeps the persisted event list
+ * bounded even when a subagent emits hundreds of throttled progress ticks.
+ */
+export declare function upsertStatusEvent(events: EvalStatusEvent[], event: EvalStatusEvent): void;
+export declare const evalToolRenderer: {
+    renderCall(args: EvalRenderArgs, options: RenderResultOptions, uiTheme: Theme): Component;
+    renderResult(result: {
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+        details?: EvalToolDetails;
+    }, options: RenderResultOptions & {
+        renderContext?: EvalRenderContext;
+    }, uiTheme: Theme, _args?: EvalRenderArgs): Component;
+    mergeCallAndResult: boolean;
+    inline: boolean;
+};
+export {};

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

@@ -1,11 +1,8 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
-import type { Component } from "@oh-my-pi/pi-tui";
 import * as z from "zod/v4";
 import type { EvalToolDetails } from "../eval/types";
-import type { RenderResultOptions } from "../extensibility/custom-tools/types";
-import { type Theme } from "../modes/theme/theme";
-import { type ToolSession } from ".";
-export declare const EVAL_DEFAULT_PREVIEW_LINES = 10;
+import type { ToolSession } from ".";
+export { EVAL_DEFAULT_PREVIEW_LINES, evalToolRenderer } from "./eval-render";
 /**
  * Per-cell input. Each cell runs in order; state persists within a language
  * across cells and across tool calls.
@@ -78,33 +75,3 @@ export declare class EvalTool implements AgentTool<typeof evalSchema> {
     constructor(session: ToolSession | null, options?: EvalToolOptions);
     execute(_toolCallId: string, params: z.infer<typeof evalSchema>, signal?: AbortSignal, onUpdate?: AgentToolUpdateCallback, _ctx?: AgentToolContext): Promise<AgentToolResult<EvalToolDetails | undefined>>;
 }
-interface EvalRenderCellArg {
-    language?: string;
-    code?: string;
-    title?: string;
-}
-interface EvalRenderArgs {
-    cells?: EvalRenderCellArg[];
-    __partialJson?: string;
-}
-interface EvalRenderContext {
-    output?: string;
-    expanded?: boolean;
-    previewLines?: number;
-    timeout?: number;
-}
-export declare const evalToolRenderer: {
-    renderCall(args: EvalRenderArgs, options: RenderResultOptions, uiTheme: Theme): Component;
-    renderResult(result: {
-        content: Array<{
-            type: string;
-            text?: string;
-        }>;
-        details?: EvalToolDetails;
-    }, options: RenderResultOptions & {
-        renderContext?: EvalRenderContext;
-    }, uiTheme: Theme, _args?: EvalRenderArgs): Component;
-    mergeCallAndResult: boolean;
-    inline: boolean;
-};
-export {};

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

@@ -37,6 +37,7 @@ export * from "./browser";
 export * from "./checkpoint";
 export * from "./debug";
 export * from "./eval";
+export * from "./eval-backends";
 export * from "./find";
 export * from "./gh";
 export * from "./image-gen";
@@ -218,6 +219,9 @@ export interface ToolSession {
      *  to splice the recorded region with replacement content. Lazily initialized
      *  by `getConflictHistory`. */
     conflictHistory?: import("./conflict-detect").ConflictHistory;
+    /** Per-session ledger of post-edit LSP diagnostics already surfaced to the
+     *  model for each file. Lazily initialized by `getDiagnosticsLedger`. */
+    diagnosticsLedger?: import("../lsp/diagnostics-ledger").DiagnosticsLedger;
     /** Queue a hidden message to be injected at the next agent turn. */
     queueDeferredMessage?(message: CustomMessage): void;
     /** Get the active OpenTelemetry config so subagent dispatch can forward
@@ -241,17 +245,6 @@ export declare function computeEssentialBuiltinNames(settings: Settings): string
 export declare const BUILTIN_TOOLS: Record<string, ToolFactory>;
 export declare const HIDDEN_TOOLS: Record<string, ToolFactory>;
 export type ToolName = keyof typeof BUILTIN_TOOLS;
-export interface EvalBackendsAllowance {
-    python: boolean;
-    js: boolean;
-}
-/** Read per-backend allowance from settings (defaults true). */
-export declare function readEvalBackendsAllowance(session: ToolSession): EvalBackendsAllowance;
-/**
- * Materialize the active eval backend allowance: PI_PY / PI_JS env flags
- * override the per-key settings; otherwise settings (defaults true) win.
- */
-export declare function resolveEvalBackends(session: ToolSession): EvalBackendsAllowance;
 /**
  * Create tools from BUILTIN_TOOLS registry.
  */