@oh-my-pi/pi-coding-agent 17.0.0 → 17.0.1

package/dist/types/advisor/advise-tool.d.ts

@@ -59,8 +59,11 @@ export declare function isAdvisorInterruptImmuneTurnActive(opts: {
  *   the live turn while one is streaming, or (when idle) a triggered turn so the
  *   advice is acted on immediately.
  * - If the primary tail is already a terminal text answer and there is no queued
- *   work, late interrupting advice is preserved as a visible card instead of
- *   waking the primary to restate completion.
+ *   work, a late `concern` is preserved as a visible card instead of waking the
+ *   primary to restate completion. A `blocker` is the exception: it means the
+ *   agent handed off broken or unexercised work, so it still steers a triggered
+ *   turn to force the primary to acknowledge and continue before the turn is
+ *   considered done (#5628) — deferring it to the next user turn is the bug.
  * - After a deliberate user interrupt (`autoResumeSuppressed`) the advisor must
  *   not auto-resume the stopped run. While the agent is idle — or still tearing
  *   the interrupted turn down (`aborting`) — the note is preserved as a visible

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

@@ -10,7 +10,20 @@
  */
 import type { CommandEntry } from "@oh-my-pi/pi-utils/cli";
 export declare const commands: CommandEntry[];
-export declare function reservedTopLevelWordMessage(first: string | undefined, argc?: number): string | undefined;
+/**
+ * Hint for a reserved plugin/marketplace verb used as a top-level command, or
+ * `undefined` when the argv should fall through to `launch`.
+ *
+ * A bare verb (`omp marketplace`) always hints. A multi-word invocation only
+ * hints when the arguments follow the documented plugin grammar — a marketplace
+ * sub-action (`omp marketplace add …`) or a `name@marketplace` plugin id
+ * (`omp uninstall foo@bar`) — so genuine prompts that merely begin with one of
+ * these words (`omp list all my files`, `omp upgrade the deps`) still launch.
+ *
+ * Flags (`-…`) and `@file` arguments in the verb slot are never management
+ * commands; those fall through to the default `launch` command.
+ */
+export declare function reservedTopLevelWordMessage(argv: readonly string[]): string | undefined;
 /**
  * Return true when `first` matches a registered subcommand name or alias.
  *

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

@@ -134,6 +134,10 @@ export declare class ModelRegistry {
      * Get the base URL associated with a provider, if any model defines one.
      */
     getProviderBaseUrl(provider: string): string | undefined;
+    /**
+     * Get provider-level headers without including per-model overrides.
+     */
+    getProviderHeaders(provider: string): Record<string, string> | undefined;
     /**
      * Get API key for a model.
      */

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

@@ -46,6 +46,7 @@ export declare const OpenAICompatSchema: import("arktype/internal/variants/objec
     alwaysSendMaxTokens?: boolean | undefined;
     strictResponsesPairing?: boolean | undefined;
     supportsImageDetailOriginal?: boolean | undefined;
+    supportsEagerToolInputStreaming?: boolean | undefined;
     requiresToolResultId?: boolean | undefined;
     replayUnsignedThinking?: boolean | undefined;
     whenThinking?: {
@@ -96,6 +97,7 @@ export declare const OpenAICompatSchema: import("arktype/internal/variants/objec
         alwaysSendMaxTokens?: boolean | undefined;
         strictResponsesPairing?: boolean | undefined;
         supportsImageDetailOriginal?: boolean | undefined;
+        supportsEagerToolInputStreaming?: boolean | undefined;
         requiresToolResultId?: boolean | undefined;
         replayUnsignedThinking?: boolean | undefined;
     } | undefined;
@@ -189,6 +191,7 @@ export declare const ModelOverrideSchema: import("arktype/internal/variants/obje
         alwaysSendMaxTokens?: boolean | undefined;
         strictResponsesPairing?: boolean | undefined;
         supportsImageDetailOriginal?: boolean | undefined;
+        supportsEagerToolInputStreaming?: boolean | undefined;
         requiresToolResultId?: boolean | undefined;
         replayUnsignedThinking?: boolean | undefined;
         whenThinking?: {
@@ -239,6 +242,7 @@ export declare const ModelOverrideSchema: import("arktype/internal/variants/obje
             alwaysSendMaxTokens?: boolean | undefined;
             strictResponsesPairing?: boolean | undefined;
             supportsImageDetailOriginal?: boolean | undefined;
+            supportsEagerToolInputStreaming?: boolean | undefined;
             requiresToolResultId?: boolean | undefined;
             replayUnsignedThinking?: boolean | undefined;
         } | undefined;
@@ -319,6 +323,7 @@ export declare const ModelsConfigSchema: import("arktype/internal/variants/objec
                 alwaysSendMaxTokens?: boolean | undefined;
                 strictResponsesPairing?: boolean | undefined;
                 supportsImageDetailOriginal?: boolean | undefined;
+                supportsEagerToolInputStreaming?: boolean | undefined;
                 requiresToolResultId?: boolean | undefined;
                 replayUnsignedThinking?: boolean | undefined;
                 whenThinking?: {
@@ -369,6 +374,7 @@ export declare const ModelsConfigSchema: import("arktype/internal/variants/objec
                     alwaysSendMaxTokens?: boolean | undefined;
                     strictResponsesPairing?: boolean | undefined;
                     supportsImageDetailOriginal?: boolean | undefined;
+                    supportsEagerToolInputStreaming?: boolean | undefined;
                     requiresToolResultId?: boolean | undefined;
                     replayUnsignedThinking?: boolean | undefined;
                 } | undefined;
@@ -479,6 +485,7 @@ export declare const ModelsConfigSchema: import("arktype/internal/variants/objec
                     alwaysSendMaxTokens?: boolean | undefined;
                     strictResponsesPairing?: boolean | undefined;
                     supportsImageDetailOriginal?: boolean | undefined;
+                    supportsEagerToolInputStreaming?: boolean | undefined;
                     requiresToolResultId?: boolean | undefined;
                     replayUnsignedThinking?: boolean | undefined;
                     whenThinking?: {
@@ -529,6 +536,7 @@ export declare const ModelsConfigSchema: import("arktype/internal/variants/objec
                         alwaysSendMaxTokens?: boolean | undefined;
                         strictResponsesPairing?: boolean | undefined;
                         supportsImageDetailOriginal?: boolean | undefined;
+                        supportsEagerToolInputStreaming?: boolean | undefined;
                         requiresToolResultId?: boolean | undefined;
                         replayUnsignedThinking?: boolean | undefined;
                     } | undefined;
@@ -635,6 +643,7 @@ export declare const ModelsConfigSchema: import("arktype/internal/variants/objec
                         alwaysSendMaxTokens?: boolean | undefined;
                         strictResponsesPairing?: boolean | undefined;
                         supportsImageDetailOriginal?: boolean | undefined;
+                        supportsEagerToolInputStreaming?: boolean | undefined;
                         requiresToolResultId?: boolean | undefined;
                         replayUnsignedThinking?: boolean | undefined;
                         whenThinking?: {
@@ -685,6 +694,7 @@ export declare const ModelsConfigSchema: import("arktype/internal/variants/objec
                             alwaysSendMaxTokens?: boolean | undefined;
                             strictResponsesPairing?: boolean | undefined;
                             supportsImageDetailOriginal?: boolean | undefined;
+                            supportsEagerToolInputStreaming?: boolean | undefined;
                             requiresToolResultId?: boolean | undefined;
                             replayUnsignedThinking?: boolean | undefined;
                         } | undefined;

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

@@ -84,6 +84,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                 alwaysSendMaxTokens?: boolean | undefined;
                 strictResponsesPairing?: boolean | undefined;
                 supportsImageDetailOriginal?: boolean | undefined;
+                supportsEagerToolInputStreaming?: boolean | undefined;
                 requiresToolResultId?: boolean | undefined;
                 replayUnsignedThinking?: boolean | undefined;
                 whenThinking?: {
@@ -134,6 +135,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                     alwaysSendMaxTokens?: boolean | undefined;
                     strictResponsesPairing?: boolean | undefined;
                     supportsImageDetailOriginal?: boolean | undefined;
+                    supportsEagerToolInputStreaming?: boolean | undefined;
                     requiresToolResultId?: boolean | undefined;
                     replayUnsignedThinking?: boolean | undefined;
                 } | undefined;
@@ -228,6 +230,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                     alwaysSendMaxTokens?: boolean | undefined;
                     strictResponsesPairing?: boolean | undefined;
                     supportsImageDetailOriginal?: boolean | undefined;
+                    supportsEagerToolInputStreaming?: boolean | undefined;
                     requiresToolResultId?: boolean | undefined;
                     replayUnsignedThinking?: boolean | undefined;
                     whenThinking?: {
@@ -278,6 +281,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                         alwaysSendMaxTokens?: boolean | undefined;
                         strictResponsesPairing?: boolean | undefined;
                         supportsImageDetailOriginal?: boolean | undefined;
+                        supportsEagerToolInputStreaming?: boolean | undefined;
                         requiresToolResultId?: boolean | undefined;
                         replayUnsignedThinking?: boolean | undefined;
                     } | undefined;
@@ -368,6 +372,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                         alwaysSendMaxTokens?: boolean | undefined;
                         strictResponsesPairing?: boolean | undefined;
                         supportsImageDetailOriginal?: boolean | undefined;
+                        supportsEagerToolInputStreaming?: boolean | undefined;
                         requiresToolResultId?: boolean | undefined;
                         replayUnsignedThinking?: boolean | undefined;
                         whenThinking?: {
@@ -418,6 +423,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                             alwaysSendMaxTokens?: boolean | undefined;
                             strictResponsesPairing?: boolean | undefined;
                             supportsImageDetailOriginal?: boolean | undefined;
+                            supportsEagerToolInputStreaming?: boolean | undefined;
                             requiresToolResultId?: boolean | undefined;
                             replayUnsignedThinking?: boolean | undefined;
                         } | undefined;

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

@@ -4715,7 +4715,7 @@ export declare const SETTINGS_SCHEMA: {
             readonly options: readonly [{
                 readonly value: "auto";
                 readonly label: "Auto";
-                readonly description: "Priority: GPT model image tool > Antigravity > xAI > OpenRouter > Gemini";
+                readonly description: "Priority: active session provider > GPT model image tool > Antigravity > xAI > OpenRouter > Gemini";
             }, {
                 readonly value: "openai";
                 readonly label: "OpenAI";

package/dist/types/discovery/substitute-plugin-root.d.ts

@@ -1,23 +1,36 @@
 export declare function substitutePluginRoot<T>(value: T, rootPath: string): T;
 /**
- * Rebase relative filesystem values in a discovered plugin stdio config against
- * the directory of the `.mcp.json` that declared them.
+ * Where a relative, path-like `command` is rooted by {@link resolvePluginStdioPaths}.
  *
- * External plugin configs (bundled ChatGPT/Codex plugins, Claude marketplace
- * plugins) express `command`/`cwd` relative to their own config file, but MCP
- * stdio spawning roots relative values at the session cwd — so a plugin shipping
+ * - `"config-dir"` (default): the directory of the config file that declared the
+ *   server — the plugin package root for `.mcp.json`. A plugin can ship its
+ *   executable at the package root (`command: "./bin/server"`) yet run from a
+ *   data subdir (`cwd: "work"`); the command stays `<pkg>/bin/server`.
+ * - `"cwd"`: the rooted `cwd`, falling back to the config dir when no `cwd` is
+ *   set. This matches how the OS resolves a relative command against the
+ *   subprocess's working directory, which is the Codex `config.toml` contract:
+ *   `cwd = "server"`, `command = "./bin/mcp"` → `<configDir>/server/bin/mcp`.
+ */
+export type StdioCommandBase = "config-dir" | "cwd";
+/**
+ * Rebase relative filesystem values in a discovered stdio server config against
+ * the directory of the config file (`.mcp.json`/`config.toml`) that declared them.
+ *
+ * External configs (bundled ChatGPT/Codex plugins, Claude marketplace plugins)
+ * express `command`/`cwd` relative to their own config file, but MCP stdio
+ * spawning roots relative values at the session cwd — so a server shipping
  * `command: "./bin/server"`, `cwd: "."` launches from the wrong directory and
  * fails with ENOENT. This resolves those against `configDir` instead:
  *
  * - relative `cwd` → resolved against `configDir`;
  * - path-like `command` (`./`, `../`, or the Windows `.\`/`..\` forms) →
- *   resolved against `configDir`;
+ *   resolved against the base selected by `commandBase` (see {@link StdioCommandBase});
  * - bare executables (`npx`, `uvx`, …) and absolute paths are left untouched.
  */
 export declare function resolvePluginStdioPaths(config: {
     command?: string;
     cwd?: string;
-}, configDir: string): {
+}, configDir: string, commandBase?: StdioCommandBase): {
     command?: string;
     cwd?: string;
 };

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

@@ -6,6 +6,7 @@ import type { InternalResource, InternalUrl, ProtocolHandler, UrlCompletion } fr
  * with optional JSON extraction.
  */
 export declare class AgentProtocolHandler implements ProtocolHandler {
+    #private;
     readonly scheme = "agent";
     readonly immutable = true;
     resolve(url: InternalUrl): Promise<InternalResource>;

package/dist/types/lib/xai-http.d.ts

@@ -5,6 +5,17 @@ interface XAICredentials {
     baseURL: string;
 }
 export declare function ohMyPiXAIUserAgent(): string;
+/** xAI provider ids supported by shared HTTP tool transport resolution. */
+export type XAIHttpProvider = "xai-oauth" | "xai";
+/** Resolved endpoint and configured headers for an xAI HTTP tool request. */
+export interface XAIHttpTransport {
+    baseURL: string;
+    headers?: Record<string, string>;
+}
+/**
+ * Resolve an xAI tool endpoint and its provider/model header overrides.
+ */
+export declare function resolveXAIHttpTransport(modelRegistry: ModelRegistry, provider: XAIHttpProvider, modelId?: string): XAIHttpTransport;
 /**
  * Resolve xAI credentials for HTTP tool calls.
  *

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

@@ -1,4 +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 SetSessionModeRequest, type SetSessionModeResponse } from "@agentclientprotocol/sdk";
+import { type postmortem } from "@oh-my-pi/pi-utils";
 import { type ExtensionUIContext } from "../../extensibility/extensions/index.js";
 import type { AgentSession } from "../../session/agent-session.js";
 /**
@@ -56,5 +57,7 @@ export declare class AcpAgent implements Agent {
     }): Promise<void>;
     get signal(): AbortSignal;
     get closed(): Promise<void>;
+    /** Dispose every session owned by this ACP connection and await persisted teardown. */
+    dispose(reason?: postmortem.Reason): Promise<void>;
 }
 export {};

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

@@ -1,5 +1,9 @@
 import { AgentSideConnection, type Stream } from "@agentclientprotocol/sdk";
 import type { AgentSession } from "../../session/agent-session.js";
+import { AcpAgent } from "./acp-agent.js";
+/** Creates sessions requested by an ACP client. */
 export type AcpSessionFactory = (cwd: string) => Promise<AgentSession>;
-export declare function createAcpConnection(transport: Stream, createSession: AcpSessionFactory, initialSession?: AgentSession): AgentSideConnection;
-export declare function runAcpMode(createSession: AcpSessionFactory, initialSession?: AgentSession): Promise<never>;
+/** Creates an ACP connection and exposes its agent when process-level teardown must own it. */
+export declare function createAcpConnection(transport: Stream, createSession: AcpSessionFactory, initialSession?: AgentSession, onAgent?: (agent: AcpAgent) => void): AgentSideConnection;
+/** Serves ACP over stdio until the peer disconnects, then awaits session teardown before exit. */
+export declare function runAcpMode(createSession: AcpSessionFactory, initialSession?: AgentSession): Promise<void>;

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

@@ -51,6 +51,8 @@ export declare class AssistantMessageComponent extends Container {
     markTranscriptBlockFinalized(): void;
     applyRetryRecovery(retryRecovery: AssistantMessage["retryRecovery"]): void;
     messagePersistenceKey(): string | undefined;
+    /** Toggle rendering for assistant-native and tool-result images. */
+    setImagesVisible(visible: boolean): void;
     setToolResultImages(toolCallId: string, images: ImageContent[]): void;
     updateContent(message: AssistantMessage, opts?: {
         transient?: boolean;

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

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

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

@@ -1,5 +1,5 @@
 import type { ImageContent } from "@oh-my-pi/pi-ai";
-import { Editor, type KeyId } from "@oh-my-pi/pi-tui";
+import { Editor, type KeyId, TUI } from "@oh-my-pi/pi-tui";
 import type { AppKeybinding } from "../../config/keybindings.js";
 type ConfigurableEditorAction = Extract<AppKeybinding, "app.interrupt" | "app.clear" | "app.exit" | "app.suspend" | "app.display.reset" | "app.thinking.cycle" | "app.model.cycleForward" | "app.model.cycleBackward" | "app.model.select" | "app.model.selectTemporary" | "app.tools.expand" | "app.thinking.toggle" | "app.editor.external" | "app.history.search" | "app.message.dequeue" | "app.retry" | "app.clipboard.pasteImage" | "app.clipboard.pasteTextRaw" | "app.clipboard.copyPrompt">;
 /** Max gap (ms) between two spaces for the later one to count as OS key auto-repeat rather than a
@@ -73,6 +73,28 @@ export declare class CustomEditor extends Editor {
     /** Per-image source links (file:// targets) parallel to {@link pendingImages};
      *  `undefined` entries are images without a backing reference yet. */
     pendingImageLinks: (string | undefined)[];
+    /**
+     * The host {@link TUI}, captured when a plugin constructs this editor through
+     * the upstream-pi `(tui, theme, keybindings)` convention. Undefined for omp's
+     * own `new CustomEditor(theme)` callers (they drive repaints through the
+     * interactive-mode wiring instead). Plugins that call `this.tui.requestRender()`
+     * in their overrides read it here (issue #4766).
+     */
+    tui?: TUI;
+    /**
+     * Accept both the omp constructor convention — `new CustomEditor(theme)` —
+     * and the upstream-pi `Editor` convention — `new Editor(tui, theme, keybindings)`
+     * — that {@link ExtensionUIContext.setEditorComponent}'s factory contract
+     * advertises `(tui, theme, keybindings)`. Plugins written against upstream pi
+     * subclass `CustomEditor`/`Editor` and forward `super(tui, theme, keybindings)`;
+     * without this shim the `TUI` lands in the `theme` slot and every render throws
+     * `undefined is not an object (evaluating 'this.#theme.symbols.boxRound')`
+     * (issue #4766). We locate the real {@link EditorTheme} among the args by shape
+     * (it carries `symbols`/`borderColor`) rather than by position, and capture a
+     * leading {@link TUI} so plugin overrides calling `this.tui.requestRender()`
+     * keep working.
+     */
+    constructor(...args: readonly unknown[]);
     /** Clear the composer draft: optionally commit `historyText` to history, then
      *  reset the editor text and all pending draft-image state. The shared tail of
      *  every "message submitted" path; pass no argument for a plain discard. */

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

@@ -7,14 +7,21 @@
  *   (Ctrl+Q / Ctrl+Enter) submits, bordered popup
  * - Prompt-style (ask): Enter submits, Shift+Enter inserts newline, legacy ask chrome
  */
-import { Container, type TUI } from "@oh-my-pi/pi-tui";
+import { Container, type Focusable, type TUI } from "@oh-my-pi/pi-tui";
 export interface HookEditorOptions {
     /** When true, use prompt-style keybindings with the legacy ask prompt chrome. */
     promptStyle?: boolean;
 }
-export declare class HookEditorComponent extends Container {
+/** Interactive multiline dialog used by hooks and the ask tool's Other response. */
+export declare class HookEditorComponent extends Container implements Focusable {
     #private;
+    /** Focus state mirrored to the nested editor during rendering. */
+    focused: boolean;
     constructor(tui: TUI, title: string, prefill: string | undefined, onSubmit: (value: string) => void, onCancel: () => void, options?: HookEditorOptions);
+    /** Keep the nested editor's software/hardware cursor mode aligned with the dialog focus target. */
+    setUseTerminalCursor(useTerminalCursor: boolean): void;
+    /** Render the dialog after forwarding its focus state to the nested editor. */
+    render(width: number): readonly string[];
     handleInput(keyData: string): void;
     /** Route non-bracketed paste transports (e.g. kitty's OSC 5522 enhanced clipboard)
      *  into the inner editor, mirroring bracketed-paste semantics. Without this hook,

package/dist/types/modes/components/login-dialog.test.d.ts

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

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

@@ -83,6 +83,8 @@ export declare class SessionSelectorComponent extends Container {
     #private;
     constructor(sessions: SessionInfo[], onSelect: (session: SessionInfo) => void, onCancel: () => void, onExit: () => void, options?: SessionSelectorOptions);
     setOnRequestRender(callback: () => void): void;
+    /** Ignore input after selection while the host resumes the session. */
+    lockInput(): void;
     /**
      * Dispose the session list explicitly: while the delete-confirmation dialog
      * is mounted the list is detached from the child tree, so Container's

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

@@ -9,6 +9,13 @@ import { type Component, Container, type NativeScrollbackLiveRegion, type TUI }
 export interface TranscriptLiveRegionProbe {
     isBlockInLiveRegion(component: Component): boolean;
 }
+/** Minimal TUI surface ToolExecutionComponent uses to schedule repaints and share image budget. */
+export interface ToolExecutionUi {
+    requestRender(): void;
+    requestComponentRender(component: Component): void;
+    resetDisplay(): void;
+    imageBudget?: TUI["imageBudget"];
+}
 export interface ToolExecutionOptions {
     snapshots?: SnapshotStore;
     showImages?: boolean;
@@ -52,7 +59,7 @@ export declare function sharedSpinnerFrame(frameCount: number, now?: number): nu
  */
 export declare class ToolExecutionComponent extends Container implements NativeScrollbackLiveRegion {
     #private;
-    constructor(toolName: string, args: any, options: ToolExecutionOptions | undefined, tool: AgentTool | undefined, ui: TUI, cwd?: string, _toolCallId?: string);
+    constructor(toolName: string, args: any, options: ToolExecutionOptions | undefined, tool: AgentTool | undefined, ui: ToolExecutionUi, cwd?: string, _toolCallId?: string);
     updateArgs(args: any, _toolCallId?: string): void;
     /**
      * Signal that args are complete (tool is about to execute).

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

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

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

@@ -180,6 +180,8 @@ export declare class InteractiveMode implements InteractiveModeContext {
      *  ({@link AgentSession.#refreshTitleAfterReplan}) share one source
      *  ({@link discoverTitleSystemPromptFile}; issue #3734). */
     refreshTitleSystemPrompt(cwd?: string): Promise<void>;
+    /** Reload session skills and the `/skill:<name>` command list. */
+    refreshSkillState(): Promise<void>;
     /** Reload slash commands and autocomplete for the provided working directory. */
     refreshSlashCommandState(cwd?: string): Promise<void>;
     /** Stack extension autocomplete behavior on top of the built-in editor provider (#4919). */
@@ -270,6 +272,10 @@ export declare class InteractiveMode implements InteractiveModeContext {
     initializeHookRunner(uiContext: ExtensionUIContext, hasUI: boolean): void;
     setEditorComponent(factory: ((tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) => CustomEditor) | undefined): void;
     present(content: Component | readonly Component[]): void;
+    /** Defer transcript command panels until the active turn can no longer grow above them. */
+    presentCommandOutput(content: Component | readonly Component[]): void;
+    /** Mount every command panel queued for the current session while the agent was streaming. */
+    flushPendingCommandOutput(): void;
     resetTranscript(): void;
     showStatus(message: string, options?: {
         dim?: boolean;

package/dist/types/modes/noninteractive-dispose.test.d.ts

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

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

@@ -209,6 +209,14 @@ export interface InteractiveModeContext {
      * runs) so their timers/subscriptions start.
      */
     present(content: Component | readonly Component[]): void;
+    /**
+     * Mount command output immediately while idle, or defer it until the active
+     * agent turn ends so a growing live block cannot push duplicate rows into
+     * native scrollback.
+     */
+    presentCommandOutput(content: Component | readonly Component[]): void;
+    /** Mount command output deferred by {@link presentCommandOutput}. */
+    flushPendingCommandOutput(): void;
     /**
      * Dispose every live block in the transcript (stopping timers/subscriptions)
      * and clear it. Used before a full rebuild so animated/streaming blocks do not
@@ -322,6 +330,8 @@ export interface InteractiveModeContext {
     executeCompaction(customInstructionsOrOptions?: string | CompactOptions, isAuto?: boolean): Promise<CompactionOutcome>;
     openInBrowser(urlOrPath: string): void;
     refreshSlashCommandState(cwd?: string): Promise<void>;
+    /** Reload session skills and derived `/skill:<name>` commands. */
+    refreshSkillState(): Promise<void>;
     applyCwdChange(newCwd: string): Promise<void>;
     showSettingsSelector(): void;
     showAdvisorConfigure(): void;

package/dist/types/modes/utils/transcript-render-helpers.d.ts

@@ -34,8 +34,8 @@ export declare function buildIrcMessageCard(message: CustomOrHookMessage, getExp
  */
 export declare function buildFileMentionBlock(files: FileMentionMessage["files"], indent: number): TranscriptBlock;
 /**
- * Whether an assistant turn has visible text or thinking content (after
- * canonicalization) — i.e. content that closes the current read-tool run.
+ * Whether an assistant turn has visible text, thinking, or image content — i.e.
+ * content that closes the current read-tool run.
  */
 export declare function assistantHasVisibleContent(message: AssistantAgentMessage): boolean;
 /**

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

@@ -34,7 +34,7 @@ import type { CustomTool } from "../extensibility/custom-tools/types.js";
 import type { ExtensionRunner } from "../extensibility/extensions/index.js";
 import type { CompactOptions, ContextUsage } from "../extensibility/extensions/types.js";
 import type { RecoveredRetryError } from "../extensibility/shared-events.js";
-import type { Skill, SkillWarning } from "../extensibility/skills.js";
+import { type Skill, type SkillWarning } from "../extensibility/skills.js";
 import { type FileSlashCommand } from "../extensibility/slash-commands.js";
 import { GoalRuntime } from "../goals/runtime.js";
 import type { Goal, GoalModeState } from "../goals/state.js";
@@ -209,6 +209,8 @@ export interface AgentSessionConfig {
     skills?: Skill[];
     /** Skill loading warnings (already captured by SDK) */
     skillWarnings?: SkillWarning[];
+    /** Whether runtime reloads may rediscover disk-backed skills for this session. */
+    skillsReloadable?: boolean;
     /** Custom commands (TypeScript slash commands) */
     customCommands?: LoadedCustomCommand[];
     skillsSettings?: SkillsSettings;
@@ -689,6 +691,12 @@ export declare class AgentSession {
     /** Removes tools installed by {@link activateVibeTools} and activates `nextToolNames`. */
     deactivateVibeTools(nextToolNames: string[]): Promise<void>;
     getSelectedMCPToolNames(): string[];
+    /**
+     * Rediscover disk-backed skills and rebuild prompt-facing state without
+     * recreating the session. Explicit skill snapshots (`--no-skills`,
+     * SDK-provided `skills`) remain fixed for the lifetime of the session.
+     */
+    refreshSkills(): Promise<void>;
     /**
      * Set active tools by name.
      * Only tools in the registry can be enabled. Unknown tool names are ignored.

package/dist/types/session/streaming-output.d.ts

@@ -26,6 +26,8 @@ export interface OutputSummary {
     columnDroppedBytes?: number;
     /** Number of distinct lines that hit the per-line column cap. */
     columnTruncatedLines?: number;
+    /** Configured per-line column cap in effect (chars), when > 0. */
+    columnMax?: number;
     /** Artifact ID for internal URL access (artifact://<id>) when truncated */
     artifactId?: string;
 }

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

@@ -63,10 +63,10 @@ export interface SlashCommandRuntime {
     /** Re-advertise the available command list (no-op outside ACP). */
     refreshCommands: () => Promise<void> | void;
     /**
-     * Reload plugin state (caches, slash command registry, project registries)
-     * and re-emit available commands. Used by `/reload-plugins`, `/move`, and
-     * `/marketplace`/`/plugins` mutations so the session sees a consistent view
-     * after plugin or project-scope changes.
+     * Reload plugin state (caches, skills, slash command registry, project
+     * registries) and re-emit available commands. Used by `/reload-plugins`,
+     * `/move`, and `/marketplace`/`/plugins` mutations so the session sees a
+     * consistent view after plugin or project-scope changes.
      */
     reloadPlugins: () => Promise<void>;
     notifyTitleChanged?: () => Promise<void> | void;

package/dist/types/system-prompt.d.ts

@@ -79,7 +79,7 @@ export interface BuildSystemPromptOptions {
         depth?: number;
     }>;
     /** Skills provided directly to system prompt construction. */
-    skills?: Skill[];
+    skills?: readonly Skill[];
     /** Pre-loaded rulebook rules (descriptions, excluding TTSR and always-apply). */
     rules?: Array<{
         name: string;

package/dist/types/tools/browser/registry.d.ts

@@ -37,6 +37,12 @@ export interface CmuxBrowserHandle extends BrowserHandleCommon {
     surface?: string;
 }
 export type BrowserHandle = PuppeteerBrowserHandle | CmuxBrowserHandle;
+/** Controls bounded browser-handle teardown and identifies the owning resource in timeout diagnostics. */
+export interface ReleaseBrowserOptions {
+    kill: boolean;
+    timeoutMs?: number;
+    resource?: string;
+}
 export interface AcquireBrowserOptions {
     cwd: string;
     viewport?: {
@@ -50,9 +56,7 @@ export interface AcquireBrowserOptions {
 export declare function acquireBrowser(kind: BrowserKind, opts: AcquireBrowserOptions): Promise<BrowserHandle>;
 export declare function normalizeConnectedCdpUrl(rawCdpUrl: string): string;
 export declare function holdBrowser(handle: BrowserHandle): void;
-export declare function releaseBrowser(handle: BrowserHandle, opts: {
-    kill: boolean;
-}): Promise<void>;
+export declare function releaseBrowser(handle: BrowserHandle, opts: ReleaseBrowserOptions): Promise<void>;
 /** Test-only accessor for the module-global browsers map. */
 export declare function getBrowsersMapForTest(): ReadonlyMap<string, BrowserHandle>;
 export {};

package/dist/types/tools/browser/tab-supervisor.d.ts

@@ -87,6 +87,8 @@ export interface RunInTabOptions {
 }
 export interface ReleaseTabOptions {
     kill?: boolean;
+    /** Maximum time for each asynchronous cleanup resource before close fails with diagnostics. */
+    timeoutMs?: number;
 }
 export declare function getTab(name: string): TabSession | undefined;
 export declare function acquireTab(name: string, browser: BrowserHandle, opts: AcquireTabOptions): Promise<AcquireTabResult>;

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

@@ -121,7 +121,9 @@ export interface ToolSession {
     /** Pre-loaded workspace tree (forwarded to subagents to skip re-scanning) */
     workspaceTree?: WorkspaceTree;
     /** Pre-loaded skills */
-    skills?: Skill[];
+    skills?: readonly Skill[];
+    /** Rediscover live session skills after a tool mutates their backing files. */
+    refreshSkills?: () => Promise<void>;
     /** Pre-loaded prompt templates */
     promptTemplates?: PromptTemplate[];
     /** Pre-loaded rules (forwarded to subagents to skip re-discovery). */

package/dist/types/tools/manage-skill.d.ts

@@ -12,6 +12,7 @@ export type ManageSkillParams = typeof manageSkillSchema.infer;
  * `autolearn.enabled`; backend-independent (the skill side is standalone).
  */
 export declare class ManageSkillTool implements AgentTool<typeof manageSkillSchema> {
+    private readonly refreshSkills?;
     readonly name = "manage_skill";
     readonly approval: "write";
     readonly label = "Manage Skill";
@@ -25,6 +26,7 @@ export declare class ManageSkillTool implements AgentTool<typeof manageSkillSche
     readonly strict = true;
     readonly loadMode: "essential";
     readonly summary = "Create, update, or delete an isolated managed skill";
+    constructor(refreshSkills?: (() => Promise<void>) | undefined);
     static createIf(session: ToolSession): ManageSkillTool | null;
     execute(_id: string, params: ManageSkillParams): Promise<AgentToolResult>;
 }

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

@@ -6,6 +6,7 @@
  */
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
 import type { AuthStorage } from "@oh-my-pi/pi-ai";
+import { ModelRegistry } from "../../config/model-registry.js";
 import type { CustomTool } from "../../extensibility/custom-tools/types.js";
 import type { ToolSession } from "../../tools/index.js";
 import { type SearchRenderDetails } from "./render.js";
@@ -32,6 +33,7 @@ export interface SearchQueryParams extends SearchToolParams {
  */
 export declare function runSearchQuery(params: SearchQueryParams, options?: {
     authStorage?: AuthStorage;
+    modelRegistry?: ModelRegistry;
     sessionId?: string;
     signal?: AbortSignal;
 }): Promise<{

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

@@ -1,4 +1,5 @@
 import type { AuthStorage, FetchImpl } from "@oh-my-pi/pi-ai";
+import type { ModelRegistry } from "../../../config/model-registry.js";
 import type { SearchProviderId, SearchResponse } from "../types.js";
 /**
  * Shared web search parameters passed to providers.
@@ -44,6 +45,8 @@ export interface SearchParams {
      * the per-credential single-flight refresh.
      */
     authStorage: AuthStorage;
+    /** Provider/model transport settings used by native search endpoints. */
+    modelRegistry?: ModelRegistry;
     /**
      * Optional session id used as the round-robin / sticky key when selecting
      * among multiple credentials for the same provider. Pass through from the