@oh-my-pi/pi-coding-agent 15.12.4 → 15.13.0

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

@@ -1046,6 +1046,30 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly fastModeScope: {
+        readonly type: "enum";
+        readonly values: readonly ["both", "openai", "claude"];
+        readonly default: "both";
+        readonly ui: {
+            readonly tab: "model";
+            readonly group: "Sampling";
+            readonly label: "Fast Mode Scope";
+            readonly description: 'Which providers `/fast on` (and the fast-mode toggle) target. "both" = priority on every supported provider; "openai"/"claude" scope it to one family (mirrors serviceTier openai-only/claude-only).';
+            readonly options: readonly [{
+                readonly value: "both";
+                readonly label: "Both";
+                readonly description: "Priority on every supported provider";
+            }, {
+                readonly value: "openai";
+                readonly label: "OpenAI only";
+                readonly description: "Priority on OpenAI/OpenAI-Codex requests; ignored elsewhere";
+            }, {
+                readonly value: "claude";
+                readonly label: "Claude only";
+                readonly description: "Anthropic fast mode on direct Claude requests; ignored elsewhere";
+            }];
+        };
+    };
     readonly "retry.enabled": {
         readonly type: "boolean";
         readonly default: true;
@@ -1242,6 +1266,32 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Suggest emojis from `:name:` shortcodes and expand text emoticons like `:D` or `:-)`";
         };
     };
+    readonly "paste.largeMenuThreshold": {
+        readonly type: "number";
+        readonly default: 100;
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Input";
+            readonly label: "Large Paste Menu";
+            readonly description: "When a paste reaches this many lines, offer a menu to wrap it in a code block, wrap it in XML tags, or save it to a file. 0 disables the menu (large pastes still collapse to a [Paste] marker).";
+            readonly options: readonly [{
+                readonly value: "0";
+                readonly label: "Off";
+            }, {
+                readonly value: "100";
+                readonly label: "100 lines";
+            }, {
+                readonly value: "250";
+                readonly label: "250 lines";
+            }, {
+                readonly value: "500";
+                readonly label: "500 lines";
+            }, {
+                readonly value: "1000";
+                readonly label: "1000 lines";
+            }];
+        };
+    };
     readonly "startup.quiet": {
         readonly type: "boolean";
         readonly default: false;
@@ -1450,50 +1500,18 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "stt.modelName": {
         readonly type: "enum";
-        readonly values: readonly ["tiny", "tiny.en", "base", "base.en", "small", "small.en", "medium", "medium.en", "large"];
-        readonly default: "base.en";
+        readonly values: readonly ["fast", "balanced", "turbo", "parakeet"];
+        readonly default: "parakeet";
         readonly ui: {
             readonly tab: "interaction";
             readonly group: "Speech";
             readonly label: "Speech Model";
-            readonly description: "Whisper model size (larger = more accurate but slower)";
-            readonly options: readonly [{
-                readonly value: "tiny";
-                readonly label: "tiny";
-                readonly description: "Multilingual; fastest, lowest accuracy";
-            }, {
-                readonly value: "tiny.en";
-                readonly label: "tiny.en";
-                readonly description: "English-only; fastest";
-            }, {
-                readonly value: "base";
-                readonly label: "base";
-                readonly description: "Multilingual; small and fast";
-            }, {
-                readonly value: "base.en";
-                readonly label: "base.en";
-                readonly description: "English-only; default";
-            }, {
-                readonly value: "small";
-                readonly label: "small";
-                readonly description: "Multilingual; balanced";
-            }, {
-                readonly value: "small.en";
-                readonly label: "small.en";
-                readonly description: "English-only; balanced";
-            }, {
-                readonly value: "medium";
-                readonly label: "medium";
-                readonly description: "Multilingual; accurate but slower";
-            }, {
-                readonly value: "medium.en";
-                readonly label: "medium.en";
-                readonly description: "English-only; accurate but slower";
-            }, {
-                readonly value: "large";
-                readonly label: "large";
-                readonly description: "Multilingual; most accurate";
-            }];
+            readonly description: "Local on-device speech model. Parakeet TDT v3 (sherpa-onnx) is the SoTA default; Whisper base/small/large-v3-turbo tiers (transformers.js) trade size for multilingual coverage. Downloaded on first use.";
+            readonly options: {
+                value: "balanced" | "fast" | "parakeet" | "turbo";
+                label: "Balanced (Whisper small)" | "Fast (Whisper base)" | "Parakeet TDT v3 (SoTA)" | "Turbo (Whisper large-v3)";
+                description: "NVIDIA Parakeet TDT 0.6B v3, 25 languages. Open ASR Leaderboard leader — best accuracy and far fastest decoding. Default." | "Whisper base, multilingual. Smallest + fastest; lowest accuracy. Best for low-resource machines." | "Whisper large-v3-turbo, 99 languages. Widest language coverage; large download, slower." | "Whisper small, multilingual. More accurate than Fast, still light on CPU/RAM.";
+            }[];
         };
     };
     readonly "contextPromotion.enabled": {
@@ -1823,7 +1841,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "snapcompact.shape": {
         readonly type: "enum";
-        readonly values: readonly ["auto", ...("5x8-bw" | "5x8-sent" | "6x12-dim" | "6x6u-bw" | "6x6u-sent" | "8on16-bw" | "8x13-bw" | "8x8r-bw" | "8x8r-sent" | "8x8u-bw" | "8x8u-sent" | "doc-8on16-bw" | "doc-8on16-sent" | "doc-8on16-sent-dim")[]];
+        readonly values: readonly ["auto", ...("11on16-bw" | "5x8-bw" | "5x8-sent" | "6x12-dim" | "6x6u-bw" | "6x6u-sent" | "8on16-bw" | "8on22-bw" | "8x13-bw" | "8x8r-bw" | "8x8r-sent" | "8x8u-bw" | "8x8u-sent" | "doc-8on16-bw" | "doc-8on16-sent" | "doc-8on16-sent-dim")[]];
         readonly default: "auto";
         readonly ui: {
             readonly tab: "context";
@@ -1878,6 +1896,14 @@ export declare const SETTINGS_SCHEMA: {
                 readonly value: "8on16-bw";
                 readonly label: "8x13 on 16px pitch, black";
                 readonly description: "8x13 glyphs on an 8x16 cell (extra leading), black ink.";
+            }, {
+                readonly value: "8on22-bw";
+                readonly label: "8x13 on 22px pitch (leading), black";
+                readonly description: "8x13 glyphs on an 8x22 cell — extra line spacing so rows don't crowd. Default for OpenAI/Google.";
+            }, {
+                readonly value: "11on16-bw";
+                readonly label: "8x13 on 11px advance (tracking), black";
+                readonly description: "8x13 glyphs on an 11x16 cell — extra letter spacing so characters don't merge. Default for Anthropic.";
             }, {
                 readonly value: "doc-8on16-bw";
                 readonly label: "Doc 8on16, black";
@@ -1999,6 +2025,31 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "autolearn.enabled": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly group: "Auto-Learn";
+            readonly label: "Auto-Learn (experimental)";
+            readonly description: "After the agent stops, nudge it to capture lessons to memory and create/enhance isolated managed skills";
+        };
+    };
+    readonly "autolearn.autoContinue": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly group: "Auto-Learn";
+            readonly label: "Auto-run capture at stop";
+            readonly description: "When on, auto-run one capture turn at stop (uses extra tokens). Off = passive reminder on your next turn.";
+            readonly condition: "autolearnActive";
+        };
+    };
+    readonly "autolearn.minToolCalls": {
+        readonly type: "number";
+        readonly default: 5;
+    };
     readonly "mnemopi.dbPath": {
         readonly type: "string";
         readonly default: undefined;
@@ -2046,6 +2097,27 @@ export declare const SETTINGS_SCHEMA: {
             readonly condition: "mnemopiActive";
         };
     };
+    readonly "mnemopi.embeddingVariant": {
+        readonly type: "enum";
+        readonly values: readonly ["en", "multilingual"];
+        readonly default: "en";
+        readonly ui: {
+            readonly tab: "memory";
+            readonly group: "Mnemopi";
+            readonly label: "Embedding variant";
+            readonly description: "Local embedding model family. en = stronger English model; multilingual = cross-language model. Changing this rebuilds existing memory embeddings on next start.";
+            readonly options: readonly [{
+                readonly value: "en";
+                readonly label: "English (bge-base-en-v1.5)";
+                readonly description: "BAAI/bge-base-en-v1.5 (768d), English-only";
+            }, {
+                readonly value: "multilingual";
+                readonly label: "Multilingual (multilingual-e5-large)";
+                readonly description: "intfloat/multilingual-e5-large (1024d), cross-language recall";
+            }];
+            readonly condition: "mnemopiActive";
+        };
+    };
     readonly "mnemopi.autoRecall": {
         readonly type: "boolean";
         readonly default: true;
@@ -2108,7 +2180,7 @@ export declare const SETTINGS_SCHEMA: {
             readonly tab: "memory";
             readonly group: "Mnemopi";
             readonly label: "Mnemopi Embedding Model";
-            readonly description: "Optional embedding model override passed to Mnemopi";
+            readonly description: "Advanced: explicit embedding model id that overrides the variant. Leave empty to use mnemopi.embeddingVariant.";
             readonly condition: "mnemopiActive";
         };
     };
@@ -2953,13 +3025,27 @@ export declare const SETTINGS_SCHEMA: {
         };
     };
     readonly "todo.eager": {
-        readonly type: "boolean";
-        readonly default: false;
+        readonly type: "enum";
+        readonly values: readonly ["default", "preferred", "always"];
+        readonly default: "default";
         readonly ui: {
             readonly tab: "tools";
             readonly group: "Todos";
             readonly label: "Create Todos Automatically";
-            readonly description: "Automatically create a comprehensive todo list after the first message";
+            readonly description: "How strongly to push automatic todo-list creation after the first message";
+            readonly options: readonly [{
+                readonly value: "default";
+                readonly label: "Default";
+                readonly description: "Model decides; no automatic todo list";
+            }, {
+                readonly value: "preferred";
+                readonly label: "Preferred";
+                readonly description: "Suggests a todo list on the first message (reminder, not forced)";
+            }, {
+                readonly value: "always";
+                readonly label: "Always";
+                readonly description: "Forces a comprehensive todo list on the first message";
+            }];
         };
     };
     readonly "find.enabled": {
@@ -3077,14 +3163,14 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Enable the debug tool for DAP-based debugging";
         };
     };
-    readonly "tts.enabled": {
+    readonly "speechgen.enabled": {
         readonly type: "boolean";
         readonly default: false;
         readonly ui: {
             readonly tab: "tools";
             readonly group: "Available Tools";
-            readonly label: "Text-to-Speech";
-            readonly description: "Enable the tts tool for xAI Grok Voice speech synthesis";
+            readonly label: "Speech Generation";
+            readonly description: "Enable the tts tool for on-device (Kokoro) or xAI Grok Voice speech-file synthesis";
         };
     };
     readonly "inspect_image.enabled": {
@@ -3272,13 +3358,13 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "async.pollWaitDuration": {
         readonly type: "enum";
-        readonly values: readonly ["5s", "10s", "30s", "1m", "5m"];
-        readonly default: "30s";
+        readonly values: readonly ["5s", "10s", "30s", "1m", "5m", "smart"];
+        readonly default: "smart";
         readonly ui: {
             readonly tab: "tools";
             readonly group: "Execution";
-            readonly label: "Poll Wait Duration";
-            readonly description: "How long the poll tool waits for background job updates before returning the current state";
+            readonly label: "Max Poll Time";
+            readonly description: "How long the poll tool waits for background job updates before returning the current state. A fixed value waits that exact duration every time. `smart` adapts: it starts at 5s and lengthens with each back-to-back poll (up to 5m), then resets to 5s after about a minute without polling.";
             readonly options: readonly [{
                 readonly value: "5s";
                 readonly label: "5 seconds";
@@ -3288,13 +3374,16 @@ export declare const SETTINGS_SCHEMA: {
             }, {
                 readonly value: "30s";
                 readonly label: "30 seconds";
-                readonly description: "Default";
             }, {
                 readonly value: "1m";
                 readonly label: "1 minute";
             }, {
                 readonly value: "5m";
                 readonly label: "5 minutes";
+            }, {
+                readonly value: "smart";
+                readonly label: "Smart";
+                readonly description: "Default — adaptive 5s→5m, resets when you stop polling";
             }];
         };
     };
@@ -3532,13 +3621,27 @@ export declare const SETTINGS_SCHEMA: {
         };
     };
     readonly "task.eager": {
-        readonly type: "boolean";
-        readonly default: false;
+        readonly type: "enum";
+        readonly values: readonly ["default", "preferred", "always"];
+        readonly default: "default";
         readonly ui: {
             readonly tab: "tasks";
             readonly group: "Subagents";
             readonly label: "Prefer Task Delegation";
-            readonly description: "Encourage the agent to delegate work to subagents unless changes are trivial";
+            readonly description: "How strongly to push delegating work to subagents";
+            readonly options: readonly [{
+                readonly value: "default";
+                readonly label: "Default";
+                readonly description: "Model decides when to delegate";
+            }, {
+                readonly value: "preferred";
+                readonly label: "Preferred";
+                readonly description: "Adds delegation guidance to the system prompt";
+            }, {
+                readonly value: "always";
+                readonly label: "Always";
+                readonly description: "Prompt guidance plus a first-turn delegation reminder";
+            }];
         };
     };
     readonly "task.batch": {
@@ -3946,6 +4049,107 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "providers.tts": {
+        readonly type: "enum";
+        readonly values: readonly ["auto", "local", "xai"];
+        readonly default: "auto";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Text-to-Speech Provider";
+            readonly description: "Backend for the tts tool: local on-device neural TTS (Kokoro-82M) or xAI Grok Voice";
+            readonly options: readonly [{
+                readonly value: "auto";
+                readonly label: "Auto";
+                readonly description: "Prefer local on-device TTS; route .mp3 output to xAI when credentials exist";
+            }, {
+                readonly value: "local";
+                readonly label: "Local";
+                readonly description: "On-device neural TTS (Kokoro-82M); output is WAV/PCM16";
+            }, {
+                readonly value: "xai";
+                readonly label: "xAI Grok Voice";
+                readonly description: "Requires xAI Grok OAuth or XAI_API_KEY; MP3 or WAV";
+            }];
+        };
+    };
+    readonly "tts.localModel": {
+        readonly type: "enum";
+        readonly values: readonly ["kokoro"];
+        readonly default: "kokoro";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Local TTS Model";
+            readonly description: "On-device neural TTS model (Kokoro-82M) used by the local TTS backend";
+            readonly options: readonly [{
+                readonly value: "kokoro";
+                readonly label: "Kokoro-82M";
+                readonly description: "Kokoro-82M neural TTS — SoTA on-device quality, multi-voice, fully local";
+            }];
+        };
+    };
+    readonly "tts.localVoice": {
+        readonly type: "enum";
+        readonly values: readonly string[];
+        readonly default: "af_heart";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Local TTS Voice";
+            readonly description: "Kokoro voice used by the local TTS backend (American/British, female/male)";
+            readonly options: readonly {
+                value: string;
+                label: string;
+            }[];
+        };
+    };
+    readonly "speech.enabled": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Speech Vocalization";
+            readonly description: "Speak the assistant's output aloud through the speakers as it streams";
+        };
+    };
+    readonly "speech.mode": {
+        readonly type: "enum";
+        readonly values: readonly ["all", "assistant", "yield"];
+        readonly default: "assistant";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Speech Vocalization Mode";
+            readonly description: "What to speak: all = assistant messages + thinking; assistant = messages only; yield = only the final message at turn end";
+            readonly options: readonly [{
+                readonly value: "all";
+                readonly label: "All (messages + thinking)";
+            }, {
+                readonly value: "assistant";
+                readonly label: "Assistant messages";
+            }, {
+                readonly value: "yield";
+                readonly label: "Final message only";
+            }];
+        };
+    };
+    readonly "speech.voice": {
+        readonly type: "enum";
+        readonly values: readonly string[];
+        readonly default: "af_heart";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Services";
+            readonly label: "Speech Vocalization Voice";
+            readonly description: "Kokoro voice used when speaking the assistant's output aloud";
+            readonly options: readonly {
+                value: string;
+                label: string;
+            }[];
+        };
+    };
     readonly "providers.tinyModel": {
         readonly type: "enum";
         readonly values: readonly ["online", "lfm2-350m", "qwen3-0.6b", "gemma-270m", "qwen2.5-0.5b", "lfm2-700m"];
@@ -4633,8 +4837,7 @@ export interface SttSettings {
     enabled: boolean;
     language: string | undefined;
     modelName: string;
-    whisperPath: string | undefined;
-    modelPath: string | undefined;
+    streaming: boolean;
 }
 export interface BashInterceptorRule {
     pattern: string;

package/dist/types/export/html/index.d.ts

@@ -1,5 +1,6 @@
 import type { AgentState } from "@oh-my-pi/pi-agent-core";
-import { type SessionEntry, type SessionHeader, SessionManager } from "../../session/session-manager";
+import type { SessionEntry, SessionHeader } from "../../session/session-entries";
+import { SessionManager } from "../../session/session-manager";
 /** Compose the standalone export template: minified CSS, tool renderers, and viewer JS inlined. */
 export declare function getTemplate(): string;
 export interface ExportOptions {

package/dist/types/extensibility/extensions/model-api.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Model query facade exposed to extensions as `ctx.models`.
+ *
+ * Read-only: lets an extension select a model the same way core does — list
+ * authenticated models, read the session model, resolve a model string or role
+ * alias, and compare model families — without touching the mutable registry or
+ * duplicating resolution/family heuristics.
+ */
+import type { Model } from "@oh-my-pi/pi-ai";
+import type { ModelRegistry } from "../../config/model-registry";
+import type { Settings } from "../../config/settings";
+import type { ExtensionModelQuery } from "./types";
+/**
+ * Build the `ctx.models` facade. `getModel` is read lazily so `current()` always
+ * reflects the live session model (it can change mid-session via `/model`).
+ */
+export declare function createExtensionModelQuery(modelRegistry: ModelRegistry, settings: Settings | undefined, getModel: () => Model | undefined): ExtensionModelQuery;

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

@@ -5,6 +5,7 @@ import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
 import type { CredentialDisabledEvent, ImageContent, Model, ProviderResponseMetadata } from "@oh-my-pi/pi-ai";
 import type { KeyId } from "@oh-my-pi/pi-tui";
 import type { ModelRegistry } from "../../config/model-registry";
+import type { Settings } from "../../config/settings";
 import type { MemoryRuntimeContext } from "../../memory-backend";
 import type { SessionManager } from "../../session/session-manager";
 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";
@@ -62,7 +63,8 @@ export declare class ExtensionRunner {
     private readonly cwd;
     private readonly sessionManager;
     private readonly modelRegistry;
-    constructor(extensions: Extension[], runtime: ExtensionRuntime, cwd: string, sessionManager: SessionManager, modelRegistry: ModelRegistry, getMemory?: () => MemoryRuntimeContext | undefined);
+    private readonly settings?;
+    constructor(extensions: Extension[], runtime: ExtensionRuntime, cwd: string, sessionManager: SessionManager, modelRegistry: ModelRegistry, getMemory?: () => MemoryRuntimeContext | undefined, settings?: Settings | undefined);
     initialize(actions: ExtensionActions, contextActions: ExtensionContextActions, commandContextActions?: ExtensionCommandContextActions, uiContext?: ExtensionUIContext): void;
     /**
      * Forward a `credential_disabled` event from `AuthStorage` to extension handlers.

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

@@ -27,6 +27,7 @@ import type { Theme } from "../../modes/theme/theme";
 import type { CustomMessage } from "../../session/messages";
 import type { ReadonlySessionManager, SessionManager } from "../../session/session-manager";
 import type { BashToolDetails, BashToolInput, FindToolDetails, FindToolInput, ReadToolDetails, ReadToolInput, SearchToolDetails, SearchToolInput, WriteToolInput } from "../../tools";
+import type { ApprovalMode } from "../../tools/approval";
 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";
@@ -173,6 +174,31 @@ export interface CompactOptions {
 /**
  * Context passed to extension event handlers.
  */
+/**
+ * Read-only model query facade exposed at `ctx.models`. Lets an extension select a
+ * model the same way core does — list authenticated models, read the session model,
+ * resolve a model string or role alias, and compare model families — without reaching
+ * into the mutable registry or re-implementing matching/family heuristics.
+ */
+export interface ExtensionModelQuery {
+    /** Authenticated models available this session (the same set `--model` selection sees). */
+    list(): Model[];
+    /** The current session model, if one is set. */
+    current(): Model | undefined;
+    /**
+     * Resolve a model string (`provider/id`, bare id) or role alias (`pi/slow`, a
+     * configured role) to a Model, using the same settings-backed aliases and match
+     * preferences as core selection. Thinking/routing suffixes are accepted and resolved
+     * to the base model (pass effort separately). Returns undefined when nothing matches.
+     */
+    resolve(spec: string): Model | undefined;
+    /**
+     * Opaque lineage token for "are these the same family?" comparisons — every Claude
+     * point release shares a token, Claude and GPT differ. Backed by catalog canonical
+     * identity. Compare it; do not persist it (the vocabulary tracks new releases).
+     */
+    family(model: Model): string;
+}
 export interface ExtensionContext {
     /** UI methods for user interaction */
     ui: ExtensionUIContext;
@@ -190,6 +216,8 @@ export interface ExtensionContext {
     modelRegistry: ModelRegistry;
     /** Current model (may be undefined) */
     model: Model | undefined;
+    /** Read-only model query facade: list / current / resolve / family. */
+    models: ExtensionModelQuery;
     /** Whether the agent is idle (not streaming) */
     isIdle(): boolean;
     /** Abort the current agent operation */
@@ -396,6 +424,22 @@ export interface InputEvent {
     images?: ImageContent[];
     source: "interactive" | "rpc" | "extension";
 }
+export interface ToolApprovalRequestedEvent {
+    type: "tool_approval_requested";
+    sessionId: string;
+    toolCallId: string;
+    toolName: string;
+    reason?: string;
+    approvalMode: ApprovalMode;
+}
+export interface ToolApprovalResolvedEvent {
+    type: "tool_approval_resolved";
+    sessionId: string;
+    toolCallId: string;
+    toolName: string;
+    approved: boolean;
+    reason?: string;
+}
 interface ToolCallEventBase {
     type: "tool_call";
     toolCallId: string;
@@ -498,7 +542,7 @@ export declare function isToolCallEventType<TName extends string, TInput extends
     input: TInput;
 };
 /** Union of all event types */
-export type ExtensionEvent = ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | AfterProviderResponseEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | AutoCompactionStartEvent | AutoCompactionEndEvent | AutoRetryStartEvent | AutoRetryEndEvent | TtsrTriggeredEvent | TodoReminderEvent | GoalUpdatedEvent | CredentialDisabledEvent | UserBashEvent | UserPythonEvent | InputEvent | ToolCallEvent | ToolResultEvent;
+export type ExtensionEvent = ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | AfterProviderResponseEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | AutoCompactionStartEvent | AutoCompactionEndEvent | AutoRetryStartEvent | AutoRetryEndEvent | TtsrTriggeredEvent | TodoReminderEvent | GoalUpdatedEvent | CredentialDisabledEvent | UserBashEvent | UserPythonEvent | InputEvent | ToolCallEvent | ToolResultEvent | ToolApprovalRequestedEvent | ToolApprovalResolvedEvent;
 export interface ContextEventResult {
     messages?: AgentMessage[];
 }
@@ -596,6 +640,8 @@ export interface ExtensionAPI {
     on(event: "goal_updated", handler: ExtensionHandler<GoalUpdatedEvent>): void;
     on(event: "credential_disabled", handler: ExtensionHandler<CredentialDisabledEvent>): void;
     on(event: "input", handler: ExtensionHandler<InputEvent, InputEventResult>): void;
+    on(event: "tool_approval_requested", handler: ExtensionHandler<ToolApprovalRequestedEvent>): void;
+    on(event: "tool_approval_resolved", handler: ExtensionHandler<ToolApprovalResolvedEvent>): void;
     on(event: "tool_call", handler: ExtensionHandler<ToolCallEvent, ToolCallEventResult>): void;
     on(event: "tool_result", handler: ExtensionHandler<ToolResultEvent, ToolResultEventResult>): void;
     on(event: "user_bash", handler: ExtensionHandler<UserBashEvent, UserBashEventResult>): void;

package/dist/types/extensibility/hooks/index.d.ts

@@ -1,4 +1,5 @@
-export type { ReadonlySessionManager, UsageStatistics } from "../../session/session-manager";
+export type { UsageStatistics } from "../../session/session-entries";
+export type { ReadonlySessionManager } from "../../session/session-manager";
 export * from "./loader";
 export * from "./runner";
 export * from "./tool-wrapper";

package/dist/types/extensibility/plugins/legacy-pi-compat.d.ts

@@ -13,6 +13,15 @@ import * as path from "node:path";
  * Exported for tests; production callers use `BUNFS_PACKAGE_ROOT` below.
  */
 export declare function __computeBunfsPackageRoot(metaDir: string, pathImpl?: typeof path): string;
+/**
+ * Compute the package root for the npm prebuilt `dist/cli.js` bundle.
+ *
+ * `bundle-dist.ts` defines `process.env.PI_BUNDLED="true"`; after bundling,
+ * `import.meta.dir` points at `<package>/dist`. Do not resolve the package via
+ * bare `@oh-my-pi/pi-coding-agent` here: from a global install Bun can pick an
+ * older cache entry, recreating mixed-runtime plugin loading.
+ */
+export declare function __computeBundledSelfPackageRoot(metaDir: string, pathImpl?: typeof path): string;
 /**
  * Drop overrides whose targets are missing on disk so they can fall through to
  * the canonical-resolution path. Exported for the test seam in #2168.

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

@@ -14,6 +14,17 @@ import type { InstalledPlugin } from "./types";
 export declare function getEnabledPlugins(cwd: string, opts?: {
     home?: string;
 }): Promise<InstalledPlugin[]>;
+/**
+ * Declared manifest entries paired with their resolved file path. Returns one
+ * record per declared entry — base entries first, then enabled-feature entries
+ * — so callers (e.g. install-time validation) can detect manifest entries that
+ * point at missing files instead of silently skipping them like
+ * {@link resolvePluginPaths} does.
+ */
+export declare function resolvePluginManifestEntries(plugin: InstalledPlugin, key: "tools" | "hooks" | "commands" | "extensions"): Array<{
+    entry: string;
+    resolvedPath: string | null;
+}>;
 export declare function resolvePluginToolPaths(plugin: InstalledPlugin): string[];
 export declare function resolvePluginHookPaths(plugin: InstalledPlugin): string[];
 export declare function resolvePluginCommandPaths(plugin: InstalledPlugin): string[];

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

@@ -17,7 +17,7 @@ import type { CompactionPreparation, CompactionResult } from "@oh-my-pi/pi-agent
 import type { ImageContent, TextContent, ToolResultMessage } from "@oh-my-pi/pi-ai";
 import type { Rule } from "../capability/rule";
 import type { Goal, GoalModeState } from "../goals/state";
-import type { BranchSummaryEntry, CompactionEntry, SessionEntry } from "../session/session-manager";
+import type { BranchSummaryEntry, CompactionEntry, SessionEntry } from "../session/session-entries";
 import type { TodoItem } from "../tools/todo";
 /** Fired on initial session load */
 export interface SessionStartEvent {

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

@@ -33,6 +33,16 @@ export declare function getActiveSkills(): readonly Skill[];
 export declare function setActiveSkills(value: readonly Skill[]): void;
 /** Reset the active skill snapshot. Test-only. */
 export declare function resetActiveSkillsForTests(): void;
+/**
+ * Whether `name` is already claimed by an active authored (non-managed) skill.
+ *
+ * Managed (auto-learn) skills resolve dead-last in discovery, so an authored
+ * skill of the same name always wins (see `loadSkills`) and a managed skill
+ * written under an authored name is silently dropped — it never surfaces.
+ * `manage_skill` create consults this to refuse the write up front instead of
+ * reporting a false "Created" for a skill that can never appear.
+ */
+export declare function isNameClaimedByAuthoredSkill(name: string): boolean;
 export interface LoadSkillsFromDirOptions {
     /** Directory to scan for skills */
     dir: string;