@oh-my-pi/pi-coding-agent 16.3.14 → 16.4.0

package/dist/types/advisor/config.d.ts

@@ -29,6 +29,13 @@ export interface DiscoveredAdvisors {
  * survives; callers dedupe collisions.
  */
 export declare function slugifyAdvisorName(name: string): string;
+/**
+ * Returns a stable provider-facing UUIDv7 for one advisor within one primary session.
+ *
+ * Codex treats `session_id`/`conversation_id` as a UUID-shaped routing identity,
+ * so advisor labels such as `-advisor` stay local-only.
+ */
+export declare function getOrCreateAdvisorProviderSessionId(ids: Map<string, string>, primarySessionId: string | undefined, slug: string, randomSessionId?: () => string): string | undefined;
 /**
  * Discover advisor configs from `WATCHDOG.yml`/`WATCHDOG.yaml` files on the same
  * user + project search path as `WATCHDOG.md`. Advisors are keyed by slug; a

package/dist/types/cli/args.d.ts

@@ -26,6 +26,7 @@ export interface Args {
     noSession?: boolean;
     sessionDir?: string;
     providerSessionId?: string;
+    providerPromptCacheKey?: string;
     fork?: string;
     /** Collab link to join at startup (set by the `join` subcommand; no CLI flag). */
     join?: string;

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

@@ -34,7 +34,7 @@ export interface ScopedModel {
     explicitThinkingLevel: boolean;
 }
 interface ThinkingSuffixOptions {
-    allowMaxAlias?: boolean;
+    allowMaxSuffix?: boolean;
     allowAutoAlias?: boolean;
 }
 interface ModelStringParseOptions extends ThinkingSuffixOptions {

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

@@ -9,6 +9,7 @@ export declare const OpenAICompatSchema: import("arktype/internal/variants/objec
         medium?: string | undefined;
         high?: string | undefined;
         xhigh?: string | undefined;
+        max?: string | undefined;
     } | undefined;
     maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
     supportsUsageInStreaming?: boolean | undefined;
@@ -58,6 +59,7 @@ export declare const OpenAICompatSchema: import("arktype/internal/variants/objec
             medium?: string | undefined;
             high?: string | undefined;
             xhigh?: string | undefined;
+            max?: string | undefined;
         } | undefined;
         maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
         supportsUsageInStreaming?: boolean | undefined;
@@ -103,19 +105,20 @@ export declare const ModelOverrideSchema: import("arktype/internal/variants/obje
     reasoning?: boolean | undefined;
     thinking?: ((In: {
         mode: "anthropic-adaptive" | "anthropic-budget-effort" | "budget" | "effort" | "google-level";
-        efforts?: ("high" | "low" | "medium" | "minimal" | "xhigh")[] | undefined;
-        defaultLevel?: "high" | "low" | "medium" | "minimal" | "xhigh" | undefined;
+        efforts?: ("high" | "low" | "max" | "medium" | "minimal" | "xhigh")[] | undefined;
+        defaultLevel?: "high" | "low" | "max" | "medium" | "minimal" | "xhigh" | undefined;
         effortMap?: {
             minimal?: string | undefined;
             low?: string | undefined;
             medium?: string | undefined;
             high?: string | undefined;
             xhigh?: string | undefined;
+            max?: string | undefined;
         } | undefined;
         supportsDisplay?: boolean | undefined;
-        minLevel?: "high" | "low" | "medium" | "minimal" | "xhigh" | undefined;
-        maxLevel?: "high" | "low" | "medium" | "minimal" | "xhigh" | undefined;
-        levels?: ("high" | "low" | "medium" | "minimal" | "xhigh")[] | undefined;
+        minLevel?: "high" | "low" | "max" | "medium" | "minimal" | "xhigh" | undefined;
+        maxLevel?: "high" | "low" | "max" | "medium" | "minimal" | "xhigh" | undefined;
+        levels?: ("high" | "low" | "max" | "medium" | "minimal" | "xhigh")[] | undefined;
     }) => import("arktype").Out<{
         mode: any;
         efforts: any;
@@ -149,6 +152,7 @@ export declare const ModelOverrideSchema: import("arktype/internal/variants/obje
             medium?: string | undefined;
             high?: string | undefined;
             xhigh?: string | undefined;
+            max?: string | undefined;
         } | undefined;
         maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
         supportsUsageInStreaming?: boolean | undefined;
@@ -198,6 +202,7 @@ export declare const ModelOverrideSchema: import("arktype/internal/variants/obje
                 medium?: string | undefined;
                 high?: string | undefined;
                 xhigh?: string | undefined;
+                max?: string | undefined;
             } | undefined;
             maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
             supportsUsageInStreaming?: boolean | undefined;
@@ -277,6 +282,7 @@ export declare const ModelsConfigSchema: import("arktype/internal/variants/objec
                     medium?: string | undefined;
                     high?: string | undefined;
                     xhigh?: string | undefined;
+                    max?: string | undefined;
                 } | undefined;
                 maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
                 supportsUsageInStreaming?: boolean | undefined;
@@ -326,6 +332,7 @@ export declare const ModelsConfigSchema: import("arktype/internal/variants/objec
                         medium?: string | undefined;
                         high?: string | undefined;
                         xhigh?: string | undefined;
+                        max?: string | undefined;
                     } | undefined;
                     maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
                     supportsUsageInStreaming?: boolean | undefined;
@@ -388,19 +395,20 @@ export declare const ModelsConfigSchema: import("arktype/internal/variants/objec
                 reasoning?: boolean | undefined;
                 thinking?: ((In: {
                     mode: "anthropic-adaptive" | "anthropic-budget-effort" | "budget" | "effort" | "google-level";
-                    efforts?: ("high" | "low" | "medium" | "minimal" | "xhigh")[] | undefined;
-                    defaultLevel?: "high" | "low" | "medium" | "minimal" | "xhigh" | undefined;
+                    efforts?: ("high" | "low" | "max" | "medium" | "minimal" | "xhigh")[] | undefined;
+                    defaultLevel?: "high" | "low" | "max" | "medium" | "minimal" | "xhigh" | undefined;
                     effortMap?: {
                         minimal?: string | undefined;
                         low?: string | undefined;
                         medium?: string | undefined;
                         high?: string | undefined;
                         xhigh?: string | undefined;
+                        max?: string | undefined;
                     } | undefined;
                     supportsDisplay?: boolean | undefined;
-                    minLevel?: "high" | "low" | "medium" | "minimal" | "xhigh" | undefined;
-                    maxLevel?: "high" | "low" | "medium" | "minimal" | "xhigh" | undefined;
-                    levels?: ("high" | "low" | "medium" | "minimal" | "xhigh")[] | undefined;
+                    minLevel?: "high" | "low" | "max" | "medium" | "minimal" | "xhigh" | undefined;
+                    maxLevel?: "high" | "low" | "max" | "medium" | "minimal" | "xhigh" | undefined;
+                    levels?: ("high" | "low" | "max" | "medium" | "minimal" | "xhigh")[] | undefined;
                 }) => import("arktype").Out<{
                     mode: any;
                     efforts: any;
@@ -434,6 +442,7 @@ export declare const ModelsConfigSchema: import("arktype/internal/variants/objec
                         medium?: string | undefined;
                         high?: string | undefined;
                         xhigh?: string | undefined;
+                        max?: string | undefined;
                     } | undefined;
                     maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
                     supportsUsageInStreaming?: boolean | undefined;
@@ -483,6 +492,7 @@ export declare const ModelsConfigSchema: import("arktype/internal/variants/objec
                             medium?: string | undefined;
                             high?: string | undefined;
                             xhigh?: string | undefined;
+                            max?: string | undefined;
                         } | undefined;
                         maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
                         supportsUsageInStreaming?: boolean | undefined;
@@ -541,19 +551,20 @@ export declare const ModelsConfigSchema: import("arktype/internal/variants/objec
                     reasoning?: boolean | undefined;
                     thinking?: ((In: {
                         mode: "anthropic-adaptive" | "anthropic-budget-effort" | "budget" | "effort" | "google-level";
-                        efforts?: ("high" | "low" | "medium" | "minimal" | "xhigh")[] | undefined;
-                        defaultLevel?: "high" | "low" | "medium" | "minimal" | "xhigh" | undefined;
+                        efforts?: ("high" | "low" | "max" | "medium" | "minimal" | "xhigh")[] | undefined;
+                        defaultLevel?: "high" | "low" | "max" | "medium" | "minimal" | "xhigh" | undefined;
                         effortMap?: {
                             minimal?: string | undefined;
                             low?: string | undefined;
                             medium?: string | undefined;
                             high?: string | undefined;
                             xhigh?: string | undefined;
+                            max?: string | undefined;
                         } | undefined;
                         supportsDisplay?: boolean | undefined;
-                        minLevel?: "high" | "low" | "medium" | "minimal" | "xhigh" | undefined;
-                        maxLevel?: "high" | "low" | "medium" | "minimal" | "xhigh" | undefined;
-                        levels?: ("high" | "low" | "medium" | "minimal" | "xhigh")[] | undefined;
+                        minLevel?: "high" | "low" | "max" | "medium" | "minimal" | "xhigh" | undefined;
+                        maxLevel?: "high" | "low" | "max" | "medium" | "minimal" | "xhigh" | undefined;
+                        levels?: ("high" | "low" | "max" | "medium" | "minimal" | "xhigh")[] | undefined;
                     }) => import("arktype").Out<{
                         mode: any;
                         efforts: any;
@@ -587,6 +598,7 @@ export declare const ModelsConfigSchema: import("arktype/internal/variants/objec
                             medium?: string | undefined;
                             high?: string | undefined;
                             xhigh?: string | undefined;
+                            max?: string | undefined;
                         } | undefined;
                         maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
                         supportsUsageInStreaming?: boolean | undefined;
@@ -636,6 +648,7 @@ export declare const ModelsConfigSchema: import("arktype/internal/variants/objec
                                 medium?: string | undefined;
                                 high?: string | undefined;
                                 xhigh?: string | undefined;
+                                max?: string | undefined;
                             } | undefined;
                             maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
                             supportsUsageInStreaming?: boolean | undefined;

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

@@ -47,6 +47,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                     medium?: string | undefined;
                     high?: string | undefined;
                     xhigh?: string | undefined;
+                    max?: string | undefined;
                 } | undefined;
                 maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
                 supportsUsageInStreaming?: boolean | undefined;
@@ -96,6 +97,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                         medium?: string | undefined;
                         high?: string | undefined;
                         xhigh?: string | undefined;
+                        max?: string | undefined;
                     } | undefined;
                     maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
                     supportsUsageInStreaming?: boolean | undefined;
@@ -189,6 +191,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                         medium?: string | undefined;
                         high?: string | undefined;
                         xhigh?: string | undefined;
+                        max?: string | undefined;
                     } | undefined;
                     maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
                     supportsUsageInStreaming?: boolean | undefined;
@@ -238,6 +241,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                             medium?: string | undefined;
                             high?: string | undefined;
                             xhigh?: string | undefined;
+                            max?: string | undefined;
                         } | undefined;
                         maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
                         supportsUsageInStreaming?: boolean | undefined;
@@ -327,6 +331,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                             medium?: string | undefined;
                             high?: string | undefined;
                             xhigh?: string | undefined;
+                            max?: string | undefined;
                         } | undefined;
                         maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
                         supportsUsageInStreaming?: boolean | undefined;
@@ -376,6 +381,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                                 medium?: string | undefined;
                                 high?: string | undefined;
                                 xhigh?: string | undefined;
+                                max?: string | undefined;
                             } | undefined;
                             maxTokensField?: "max_completion_tokens" | "max_tokens" | undefined;
                             supportsUsageInStreaming?: boolean | undefined;

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

@@ -872,7 +872,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly defaultThinkingLevel: {
         readonly type: "enum";
-        readonly values: readonly [...import("@oh-my-pi/pi-catalog").Effort[], "auto", "max"];
+        readonly values: readonly [...import("@oh-my-pi/pi-catalog").Effort[], "auto"];
         readonly default: "high";
         readonly ui: {
             readonly tab: "model";
@@ -4296,7 +4296,7 @@ export declare const SETTINGS_SCHEMA: {
             readonly tab: "tasks";
             readonly group: "Subagents";
             readonly label: "Soft Subagent Request Budget";
-            readonly description: "Soft per-subagent request budget (assistant requests per run). Crossing it can inject a steering notice when task.softRequestBudgetNotice is enabled; at 1.5x the budget the run is aborted gracefully, salvaging partial output. 0 disables the guard. Bundled explore/sonic agents use a lower built-in budget.";
+            readonly description: "Soft per-subagent request budget (assistant requests per run). Crossing it can inject a steering notice when task.softRequestBudgetNotice is enabled; at 1.5x the budget the run is aborted gracefully, salvaging partial output. 0 disables the guard. Bundled scout/sonic agents use a lower built-in budget.";
             readonly options: readonly [{
                 readonly value: "0";
                 readonly label: "Disabled";
@@ -5440,6 +5440,10 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "number";
         readonly default: 32768;
     };
+    readonly "thinkingBudgets.max": {
+        readonly type: "number";
+        readonly default: 32768;
+    };
 };
 type Schema = typeof SETTINGS_SCHEMA;
 /** All valid setting paths */
@@ -5604,6 +5608,7 @@ export interface ThinkingBudgetsSettings {
     medium: number;
     high: number;
     xhigh: number;
+    max: number;
 }
 export interface SttSettings {
     enabled: boolean;

package/dist/types/dap/config.d.ts

@@ -2,7 +2,19 @@ import type { DapAdapterConfig, DapResolvedAdapter } from "./types.js";
 export declare function getAdapterConfigs(cwd?: string): Record<string, DapAdapterConfig>;
 export declare function resolveAdapter(adapterName: string, cwd: string): DapResolvedAdapter | null;
 export declare function getAvailableAdapters(cwd: string): DapResolvedAdapter[];
-export declare function selectLaunchAdapter(program: string, cwd: string, adapterName?: string, programKind?: LaunchProgramKind): DapResolvedAdapter | null;
+/** Launch adapter selection, including a configured adapter whose command is unavailable. */
+export type LaunchAdapterSelection = {
+    kind: "adapter";
+    adapter: DapResolvedAdapter;
+} | {
+    kind: "unavailable";
+    adapterName: string;
+    command: string;
+} | {
+    kind: "none";
+};
+/** Selects a launch adapter or reports why matching configuration cannot run. */
+export declare function selectLaunchAdapter(program: string, cwd: string, adapterName?: string, programKind?: LaunchProgramKind): LaunchAdapterSelection;
 export declare function selectAttachAdapter(cwd: string, adapterName?: string, port?: number): DapResolvedAdapter | null;
 /** How the launch `program` resolves on disk. `"missing"` is reserved for
  *  programs the adapter creates on demand (rare); we treat them like files. */

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

@@ -51,6 +51,10 @@ export interface ExtensionUIDialogOptions {
     timeout?: number;
     /** Invoked when the UI times out while waiting for a selection/input */
     onTimeout?: () => void;
+    /** Invoked when the UI-managed timeout countdown starts */
+    onTimeoutStart?: () => void;
+    /** Invoked when user input resets a UI-managed timeout countdown */
+    onTimeoutReset?: () => void;
     /** Initial cursor position for select dialogs (0-indexed) */
     initialIndex?: number;
     /** Render an outlined list for select dialogs */
@@ -96,6 +100,8 @@ export type AutocompleteProviderFactory = (current: AutocompleteProvider) => Aut
  * Each mode (interactive, RPC, print) provides its own implementation.
  */
 export interface ExtensionUIContext {
+    /** True when selector timeouts start only after the dialog is presented. */
+    timeoutStartsOnPresentation?: boolean;
     /** 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. */

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

@@ -1,3 +1,4 @@
+import { type WhichOptions } from "@oh-my-pi/pi-utils";
 import type { ServerConfig } from "./types.js";
 export interface LspConfig {
     servers: Record<string, ServerConfig>;
@@ -12,6 +13,11 @@ export declare function hasRootMarkers(cwd: string, markers: string[]): boolean;
  * Check whether any ancestor directory of a file is an LSP project root.
  */
 export declare function hasRootMarkerAncestor(filePath: string, markers: string[]): boolean;
+/** Controls project-local and PATH executable lookup. */
+export interface ResolveCommandOptions extends Pick<WhichOptions, "cache" | "PATH"> {
+    /** Ordered project roots checked before PATH; defaults to the command cwd. */
+    localRoots?: readonly string[];
+}
 /**
  * Resolve a command to an executable path.
  * Checks project-local bin directories first, then falls back to $PATH.
@@ -20,7 +26,7 @@ export declare function hasRootMarkerAncestor(filePath: string, markers: string[
  * @param cwd - Working directory to search from
  * @returns Absolute path to the executable, or null if not found
  */
-export declare function resolveCommand(command: string, cwd: string): string | null;
+export declare function resolveCommand(command: string, cwd: string, options?: ResolveCommandOptions): string | null;
 /**
  * Load LSP configuration.
  *

package/dist/types/main.d.ts

@@ -57,6 +57,8 @@ export declare class SessionResolutionError extends Error {
 export declare function createSessionManager(parsed: Args, cwd: string, activeSettings?: Settings, askToForkSession?: SessionPrompt, askToMoveSession?: SessionPrompt): Promise<SessionManager | undefined>;
 /** Apply resolved CLI/discovered prompt files without bypassing system prompt templates. */
 export declare function applyResolvedSystemPromptInputs(options: CreateAgentSessionOptions, resolvedSystemPrompt: string | undefined, resolvedAppendPrompt: string | undefined): void;
+/** Builds startup session options from parsed CLI flags, scoped models, and resolved session lineage. */
+export declare function buildSessionOptions(parsed: Args, scopedModels: ScopedModel[], sessionManager: SessionManager | undefined, modelRegistry: ModelRegistry, activeSettings: Settings): Promise<CreateAgentSessionOptions>;
 interface RunRootCommandDependencies {
     createAgentSession?: typeof createAgentSession;
     discoverAuthStorage?: typeof discoverAuthStorage;

package/dist/types/mcp/transports/stdio.d.ts

@@ -20,13 +20,18 @@ export interface StdioSpawnCommand {
      */
     windowsHide?: boolean;
     /**
-     * Run the subprocess in its own session.
+     * Run the subprocess in its own session when the platform can safely do so.
      *
-     * POSIX: `true`. Detach → `setsid`, so the MCP process tree has no
-     * controlling terminal and terminal job-control signals (Ctrl+Z SIGTSTP,
+     * Linux/other POSIX: `true`. Detach → `setsid`, so the MCP process tree has
+     * no controlling terminal and terminal job-control signals (Ctrl+Z SIGTSTP,
      * background-read SIGTTIN) cannot stop stdio servers such as
      * `chrome-devtools-mcp` and leave our read loop blocked on silent pipes.
      *
+     * macOS: `false`. LaunchServices/TCC attributes Apple Events automation to
+     * the responsible terminal process only while the child stays in the
+     * inherited session; detaching via `setsid` prevents the permission prompt
+     * for servers such as `xcrun mcpbridge` (#4987).
+     *
      * Windows: `false`. There is no SIGTSTP/SIGTTIN to escape, and Windows
      * wrapper chains must stay in the OMP console session so nested console
      * grandchildren keep stdout routed through our pipe (#3544).

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

@@ -31,6 +31,8 @@ export interface HookSelectorOptions {
     tui?: TUI;
     timeout?: number;
     onTimeout?: () => void;
+    onTimeoutStart?: () => void;
+    onTimeoutReset?: () => void;
     initialIndex?: number;
     outline?: boolean;
     maxVisible?: number;

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

@@ -2917,6 +2917,7 @@ export declare const defaultThemes: {
                 "thinking.medium": string;
                 "thinking.high": string;
                 "thinking.xhigh": string;
+                "thinking.max": string;
                 "icon.model": string;
                 "icon.plan": string;
                 "icon.goal": string;
@@ -7435,6 +7436,7 @@ export declare const defaultThemes: {
                 "thinking.medium": string;
                 "thinking.high": string;
                 "thinking.xhigh": string;
+                "thinking.max": string;
                 "icon.model": string;
                 "icon.plan": string;
                 "icon.goal": string;

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

@@ -6,9 +6,9 @@ export type SymbolPreset = "unicode" | "nerd" | "ascii";
 /**
  * All available symbol keys organized by category.
  */
-export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "icon.input" | "icon.output" | "icon.throughput" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "advisor.rail" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.julia" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.inspectImage" | "tool.goal" | "tool.irc" | "tool.delete" | "tool.move";
+export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "icon.input" | "icon.output" | "icon.throughput" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "advisor.rail" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.julia" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.inspectImage" | "tool.goal" | "tool.irc" | "tool.delete" | "tool.move";
 export type SpinnerType = "status" | "activity";
-export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";
+export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "thinkingMax" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";
 /** Check if a string is a valid ThemeColor value */
 export declare function isValidThemeColor(color: string): color is ThemeColor;
 export type ThemeBg = "selectedBg" | "userMessageBg" | "customMessageBg" | "toolPendingBg" | "toolSuccessBg" | "toolErrorBg" | "statusLineBg";
@@ -208,6 +208,7 @@ export declare class Theme {
         medium: string;
         high: string;
         xhigh: string;
+        max: string;
         autoPending: string;
     };
     get checkbox(): {

package/dist/types/sdk.d.ts

@@ -72,6 +72,8 @@ export interface CreateAgentSessionOptions {
     providerSessionId?: string;
     /** Optional provider-facing prompt cache key, distinct from request lineage. */
     providerPromptCacheKey?: string;
+    /** Whether `providerPromptCacheKey` is caller-pinned or inherited from a full fork. */
+    providerPromptCacheKeySource?: "explicit" | "fork";
     /** Absolute wall-clock deadline in Unix epoch milliseconds. */
     deadline?: number;
     /** Custom tools to register (in addition to built-in tools). Accepts both CustomTool and ToolDefinition. */

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

@@ -284,6 +284,8 @@ export interface AgentSessionConfig {
      * so that credential sticky selection is consistent with the session's streaming calls.
      */
     providerSessionId?: string;
+    /** Marks `agent.promptCacheKey` as fork-inherited so incompatible route changes can clear it. */
+    providerPromptCacheKeySource?: "explicit" | "fork";
     /**
      * Full advisor toolset, pre-built in `createAgentSession` against a distinct,
      * advisor-scoped `ToolSession` (its own `-advisor` session/agent id) so the
@@ -662,8 +664,8 @@ export declare class AgentSession {
      *
      * @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.
+     *   regardless of prior selection state. Used when MCP discovery is disabled and tools
+     *   arrive after initial session activation.
      */
     refreshMCPTools(mcpTools: CustomTool[], options?: {
         activateAll?: boolean;
@@ -969,7 +971,7 @@ export declare class AgentSession {
      */
     setThinkingLevel(level: ConfiguredThinkingLevel | undefined, persist?: boolean): void;
     /**
-     * Cycle to next thinking level: off → auto → minimal..xhigh → off.
+     * Cycle to next thinking level: off → auto → minimal..max → off.
      * @returns New selector, or undefined if model doesn't support thinking
      */
     cycleThinkingLevel(): ConfiguredThinkingLevel | undefined;

package/dist/types/session/session-context.test.d.ts

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

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

@@ -24,9 +24,13 @@ export interface SessionHeader {
     timestamp: string;
     cwd: string;
     parentSession?: string;
+    /** Provider prompt-cache identity inherited by exact-route full forks. */
+    providerPromptCacheKey?: string;
 }
 export interface NewSessionOptions {
     parentSession?: string;
+    /** Provider prompt-cache identity to seed on the new session header. */
+    providerPromptCacheKey?: string;
     /** Skip flushing the current session and delete it instead of saving. */
     drop?: boolean;
 }

package/dist/types/thinking.d.ts

@@ -59,14 +59,14 @@ export declare function parseConfiguredThinkingLevel(value: string | null | unde
 export declare function getConfiguredThinkingLevelMetadata(level: ConfiguredThinkingLevel): ConfiguredThinkingLevelMetadata;
 /**
  * Thinking selectors accepted by the `--thinking` CLI flag, in display order:
- * `off`, every concrete effort (`minimal`..`xhigh`), then `auto`. Single source
+ * `off`, every concrete effort (`minimal`..`max`), then `auto`. Single source
  * for the flag's `options` list, shell completions, and the "invalid level"
  * warning so all three stay in sync.
  */
 export declare const CLI_THINKING_LEVELS: readonly string[];
 /**
  * Parses a `--thinking` CLI value. Accepts every {@link parseConfiguredThinkingLevel}
- * selector (`off`, `auto`, `minimal`..`xhigh`, plus the `max` alias) but rejects
+ * selector (`off`, `auto`, `minimal`..`max`) but rejects
  * `inherit`: an explicit `inherit` on the command line would suppress the
  * settings/scoped-model fallback during startup resolution only to resolve back
  * to the provider default, which is never what the user means.
@@ -91,6 +91,9 @@ export declare function clampAutoThinkingEffort(model: Model | undefined, effort
 /**
  * The provisional concrete level shown while `auto` is configured but before a
  * turn has been classified. Prefers the model's `defaultLevel`, otherwise High,
- * clamped into the auto range. Returns `undefined` for non-reasoning models.
+ * clamped into the auto range. Auto never provisions {@link Effort.Max} (the
+ * classifier ceiling is XHigh; only an explicit user request reaches Max), so a
+ * `defaultLevel` of `max` is capped at XHigh before clamping. Returns
+ * `undefined` for non-reasoning models.
  */
 export declare function resolveProvisionalAutoLevel(model: Model | undefined): Effort | undefined;

package/dist/types/utils/file-display-mode.d.ts

@@ -16,7 +16,7 @@ export interface FileDisplayModeSession {
 /**
  * Computes effective line display mode from session settings/env.
  * Hashline mode takes precedence and implies line-addressed output everywhere.
- * Hashlines are suppressed when the edit tool is not available (e.g. explore agents),
+ * Hashlines are suppressed when the edit tool is not available (e.g. scout agents),
  * when the caller signals a `raw` read, and when the source is `immutable`
  * (e.g. internal URLs like artifact://, agent://, memory:// — there is no edit
  * path that could consume the anchors). Raw output is returned as-is.

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "16.3.14",
+	"version": "16.4.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -56,17 +56,17 @@
 		"@agentclientprotocol/sdk": "0.25.0",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "16.3.14",
-		"@oh-my-pi/omp-stats": "16.3.14",
-		"@oh-my-pi/pi-agent-core": "16.3.14",
-		"@oh-my-pi/pi-ai": "16.3.14",
-		"@oh-my-pi/pi-catalog": "16.3.14",
-		"@oh-my-pi/pi-mnemopi": "16.3.14",
-		"@oh-my-pi/pi-natives": "16.3.14",
-		"@oh-my-pi/pi-tui": "16.3.14",
-		"@oh-my-pi/pi-utils": "16.3.14",
-		"@oh-my-pi/pi-wire": "16.3.14",
-		"@oh-my-pi/snapcompact": "16.3.14",
+		"@oh-my-pi/hashline": "16.4.0",
+		"@oh-my-pi/omp-stats": "16.4.0",
+		"@oh-my-pi/pi-agent-core": "16.4.0",
+		"@oh-my-pi/pi-ai": "16.4.0",
+		"@oh-my-pi/pi-catalog": "16.4.0",
+		"@oh-my-pi/pi-mnemopi": "16.4.0",
+		"@oh-my-pi/pi-natives": "16.4.0",
+		"@oh-my-pi/pi-tui": "16.4.0",
+		"@oh-my-pi/pi-utils": "16.4.0",
+		"@oh-my-pi/pi-wire": "16.4.0",
+		"@oh-my-pi/snapcompact": "16.4.0",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/context-async-hooks": "^2.7.1",
 		"@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",