@oh-my-pi/pi-coding-agent 17.1.5 → 17.1.6

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

@@ -11,7 +11,7 @@ export declare function registerProvider<T>(capabilityId: string, provider: Prov
 /**
  * Load a capability by ID.
  */
-export declare function loadCapability<T>(capabilityId: string, options?: LoadOptions): Promise<CapabilityResult<T>>;
+export declare function loadCapability<T>(capabilityId: string, options?: LoadOptions<T>): Promise<CapabilityResult<T>>;
 /**
  * Initialize capability system with settings manager for persistence.
  * Call this once on startup to enable persistent provider state.

package/dist/types/capability/types.d.ts

@@ -51,7 +51,7 @@ export interface Provider<T> {
 /**
  * Options for loading a capability.
  */
-export interface LoadOptions {
+export interface LoadOptions<T = unknown> {
     /** Only use these providers (by ID). Default: all registered */
     providers?: string[];
     /** Exclude these providers (by ID). Default: none */
@@ -64,6 +64,26 @@ export interface LoadOptions {
     includeDisabled?: boolean;
     /** Explicit disabled extension IDs to apply instead of settings. */
     disabledExtensions?: string[];
+    /**
+     * Drop items before deduplication as if they never existed (e.g. scope
+     * exclusions). A dropped item neither survives nor claims its dedupe key,
+     * so it cannot shadow anything. Receives the item with its attached
+     * `_source`.
+     */
+    filter?(item: T & {
+        _source: SourceMeta;
+    }): boolean;
+    /**
+     * Exclude items from the results while letting them claim their dedupe key.
+     * A suppressed higher-priority item still shadows same-key lower-priority
+     * items (a disabled project server keeps the same-named user server off),
+     * but never equivalence-shadows a differently-keyed survivor — so a
+     * suppressed alias cannot starve an enabled equivalent connection.
+     * Return `true` to suppress. Receives the item with its attached `_source`.
+     */
+    suppress?(item: T & {
+        _source: SourceMeta;
+    }): boolean;
 }
 /**
  * Source metadata attached to every loaded item.
@@ -112,6 +132,8 @@ export interface Capability<T> {
      * Return undefined to never deduplicate (all items kept).
      */
     key(item: T): string | undefined;
+    /** Treat items with different keys as aliases; the first equivalent item wins. */
+    equivalent?(left: T, right: T): boolean;
     /**
      * Optional validation. Return error message if invalid, undefined if valid.
      */

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

@@ -846,7 +846,7 @@ export declare const SETTINGS_SCHEMA: {
             readonly tab: "appearance";
             readonly group: "Display";
             readonly label: "Terminal Title Run State";
-            readonly description: "Show the agent run state in the terminal title's separator — an animated spinner while working, '>' when it's your turn, '!' when the agent is waiting on you";
+            readonly description: "Show the agent run state in the terminal title's separator — an animated spinner while working (a static ':' on Windows), '>' when it's your turn, '!' when the agent is waiting on you";
         };
     };
     readonly "tui.hyperlinks": {
@@ -4577,6 +4577,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Switch the task tool to its batch shape: one call carries { context, tasks[] } — one subagent per item, with an optional per-item agent (defaulting to the session spawn-policy agent), per-item isolation, and a required shared context prepended to every assignment. With async.enabled=true, each spawn runs as an independent background agent with the normal idle/parked lifecycle; otherwise the call blocks for merged results. Disable to restore the flat single-spawn schema.";
         };
     };
+    readonly "task.enableEffort": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "tasks";
+            readonly group: "Subagents";
+            readonly label: "Per-Task Effort";
+            readonly description: "Expose the optional effort parameter on task spawns, allowing callers to override each subagent's thinking level";
+        };
+    };
     readonly "task.maxConcurrency": {
         readonly type: "number";
         readonly default: 32;
@@ -4719,6 +4729,18 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Inject one steering notice when a subagent crosses its soft request budget, asking it to wrap up before the 1.5x forced-yield stop.";
         };
     };
+    readonly "task.maxEffort": {
+        readonly type: "enum";
+        readonly values: readonly import("@oh-my-pi/pi-catalog").Effort[];
+        readonly default: "max";
+        readonly ui: {
+            readonly tab: "tasks";
+            readonly group: "Subagents";
+            readonly label: "Maximum Per-Spawn Effort";
+            readonly description: "Maximum reasoning effort allowed for the task tool's per-spawn effort hint. Lower values prevent callers from escalating subagents above this ceiling; the default preserves the model's full range.";
+            readonly options: import("../thinking.js").ThinkingLevelMetadata[];
+        };
+    };
     readonly "task.disabledAgents": {
         readonly type: "array";
         readonly default: string[];

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

@@ -1,9 +1,10 @@
 import type { InternalResource, InternalUrl, ProtocolHandler } from "./types.js";
 /**
- * Protocol handler for mcp:// URLs.
+ * Protocol handler for MCP resources.
  *
- * URL form:
+ * URL forms:
  * - mcp://<resource-uri> (e.g. mcp://test://notes, mcp://ibkr://portfolio/positions)
+ * - A resource's native URI when its scheme has no OMP handler (e.g. ags://capabilities/current-host)
  */
 export declare class McpProtocolHandler implements ProtocolHandler {
     readonly scheme = "mcp";

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

@@ -10,6 +10,18 @@
  * MUST use this function instead of calling `new URL()` directly.
  */
 import type { InternalUrl } from "./types.js";
+/**
+ * Extract the lowercased scheme from a URI-shaped input, or `undefined` when
+ * the input does not look like a URI.
+ *
+ * Accepts both hierarchical (`scheme://…`) and opaque (`scheme:rest`) forms —
+ * MCP resource URIs may be opaque (`urn:example:document`, `custom:item`).
+ * The opaque form is guarded against path-like false positives:
+ * - Windows drive paths (`C:\…`, `C:/…`, `C:foo`) — single-letter scheme.
+ * - Filenames with extensions (`foo.ts:50`) — dot in the scheme segment.
+ * - Read-tool selector tails (`Makefile:12`, `README:raw:1-20`).
+ */
+export declare function extractUriScheme(input: string): string | undefined;
 /**
  * Parse an internal URL into an InternalUrl.
  *

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

@@ -10,6 +10,12 @@ export declare class InternalUrlRouter {
     unregister(scheme: string): boolean;
     getHandler(scheme: string): ProtocolHandler | undefined;
     canHandle(input: string): boolean;
+    /**
+     * Whether read can resolve this URL through either a native handler or the
+     * MCP resource fallback. MCP resources may use arbitrary custom schemes and
+     * may be opaque (`urn:example:document`) rather than hierarchical.
+     */
+    canResolve(input: string): boolean;
     /** Schemes whose handler supports host/path autocomplete. */
     completionSchemes(): string[];
     /**

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

@@ -66,6 +66,12 @@ export interface InternalUrl extends URL {
      * Raw pathname extracted from input, preserving traversal markers before URL normalization.
      */
     rawPathname?: string;
+    /**
+     * Exact input string this URL was parsed from, before any normalization.
+     * Set by `parseInternalUrl`; used where byte-exact URI matching matters
+     * (e.g. MCP resource URIs compared by string equality).
+     */
+    rawHref?: string;
 }
 /**
  * Caller-supplied context that the router threads into protocol handlers.

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

@@ -52,6 +52,7 @@ export declare function resolveCommand(command: string, cwd: string, options?: R
  *       "command": "/path/to/server",
  *       "args": ["--stdio"],
  *       "fileTypes": [".xyz"],
+ *       "languageId": "xyz",
  *       "rootMarkers": [".xyz-project"]
  *     }
  *   }

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

@@ -200,6 +200,8 @@ export interface ServerConfig {
     command: string;
     args?: string[];
     fileTypes: string[];
+    /** LSP language identifier sent in didOpen; inferred from the file path when omitted. */
+    languageId?: string;
     rootMarkers: string[];
     initOptions?: Record<string, unknown>;
     settings?: Record<string, unknown>;

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

@@ -174,6 +174,11 @@ export declare class MCPManager {
      * Refresh resources from a specific server.
      */
     refreshServerResources(name: string): Promise<void>;
+    /**
+     * Wait until a connected server's resource catalog has been loaded.
+     * Coalesces with initial loading and notification-driven refreshes.
+     */
+    ensureServerResources(name: string): Promise<void>;
     /**
      * Refresh prompts from a specific server.
      */

package/dist/types/mcp/tool-bridge.d.ts

@@ -35,6 +35,19 @@ export interface MCPToolDetails {
     meta?: OutputMeta;
 }
 export declare function createMCPToolName(serverName: string, toolName: string): string;
+/**
+ * Keeps one MCP tool per minted name and logs collisions between distinct MCP
+ * origins. The winner is chosen by a stable origin key (server name + original
+ * tool name), NOT array order: MCPManager re-appends a reconnecting server's
+ * tools, so insertion order is mutable across reconnects and first-wins would
+ * silently flip ownership of the minted name. Non-MCP tools pass through
+ * unchanged.
+ */
+export declare function deduplicateMCPToolsByName<T extends {
+    name: string;
+    mcpServerName?: unknown;
+    mcpToolName?: unknown;
+}>(tools: readonly T[]): T[];
 /**
  * Parse an MCP tool name back to server and tool components.
  *

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

@@ -54,7 +54,7 @@ export declare class ExtensionUiController {
     /**
      * Show a confirmation dialog for hooks.
      */
-    showHookConfirm(title: string, message: string): Promise<boolean>;
+    showHookConfirm(title: string, message: string, dialogOptions?: ExtensionUIDialogOptions): Promise<boolean>;
     /**
      * Show a text input for hooks.
      */

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

@@ -158,6 +158,8 @@ export declare function handleRpcSessionChange(session: RpcSessionChangeSession,
 export declare function requestRpcEditor(pendingRequests: Map<string, PendingExtensionRequest>, output: RpcOutput, title: string, prefill?: string, dialogOptions?: ExtensionUIDialogOptions, editorOptions?: {
     promptStyle?: boolean;
 }): Promise<string | undefined>;
+/** Sends an RPC extension dialog and cancels the remote presentation when its signal aborts. */
+export declare function requestRpcDialog<T>(pendingRequests: Map<string, PendingExtensionRequest>, output: RpcOutput, opts: ExtensionUIDialogOptions | undefined, defaultValue: T, request: Record<string, unknown>, parseResponse: (response: RpcExtensionUIResponse) => T): Promise<T>;
 /**
  * Run in RPC mode.
  * Listens for JSON commands on stdin, outputs events and responses on stdout.

package/dist/types/sdk.d.ts

@@ -1,5 +1,5 @@
 import { Agent, type AgentOptions, type AgentTelemetryConfig, type AgentTool, type ThinkingLevel } from "@oh-my-pi/pi-agent-core";
-import type { Model, SimpleStreamOptions } from "@oh-my-pi/pi-ai";
+import type { Effort, Model, SimpleStreamOptions } from "@oh-my-pi/pi-ai";
 import type { Dialect } from "@oh-my-pi/pi-ai/dialect";
 import { type Rule } from "./capability/rule.js";
 import { ModelRegistry } from "./config/model-registry.js";
@@ -52,6 +52,8 @@ export interface CreateAgentSessionOptions {
     modelPatternDefaultFallbackChain?: string[];
     /** Thinking selector. Default: from settings, else unset */
     thinkingLevel?: ConfiguredThinkingLevel;
+    /** Hard ceiling on the session's thinking effort (e.g. a task spawn's `task.maxEffort`-capped hint); retry-fallback recovery re-clamps to it. */
+    thinkingLevelCeiling?: Effort;
     /** Models available for cycling (Ctrl+P in interactive mode) */
     scopedModels?: Array<{
         model: Model;

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

@@ -1,5 +1,5 @@
 import type { Agent, AgentMessage, AgentTool, StreamFn, ThinkingLevel } from "@oh-my-pi/pi-agent-core";
-import type { Context, ImageContent, Message, MessageAttribution, Model, OAuthAccountSummary, ServiceTierByFamily, SimpleStreamOptions, ToolChoice } from "@oh-my-pi/pi-ai";
+import type { Context, Effort, ImageContent, Message, MessageAttribution, Model, OAuthAccountSummary, ServiceTierByFamily, SimpleStreamOptions, ToolChoice } from "@oh-my-pi/pi-ai";
 import type { postmortem } from "@oh-my-pi/pi-utils";
 import type { AdvisorConfig } from "../advisor/index.js";
 import type { AsyncJob, AsyncJobDeliveryState, AsyncJobManager } from "../async/index.js";
@@ -88,6 +88,8 @@ export interface AgentSessionConfig {
     }>;
     /** Initial session thinking selector. */
     thinkingLevel?: ConfiguredThinkingLevel;
+    /** Hard ceiling on the session's thinking effort (e.g. a task spawn's `task.maxEffort`-capped hint); every later change, including retry-fallback recovery, is re-clamped to it. */
+    thinkingLevelCeiling?: Effort;
     /** Retry chain ownership when startup selected one of its fallback entries. */
     initialRetryFallback?: InitialRetryFallbackState;
     /** Prewalk from the starting model to a fast/cheap target after implementation begins. */

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

@@ -1011,6 +1011,8 @@ export declare class AgentSession {
             status: AdvisorRuntimeStatus;
         }[];
     };
+    /** Return cumulative cost recorded for the current session's advisor activity. */
+    getAdvisorCost(): number;
     /**
      * Return structured advisor stats for the status command and TUI panel.
      */

package/dist/types/session/model-controls.d.ts

@@ -38,10 +38,13 @@ export declare class ModelControls {
             thinkingLevel?: ThinkingLevel;
         }>;
         thinkingLevel?: ConfiguredThinkingLevel;
+        thinkingLevelCeiling?: Effort;
         serviceTierByFamily?: ServiceTierByFamily;
     });
     /** Effective metadata-clamped thinking level applied to the agent. */
     get thinkingLevel(): ThinkingLevel | undefined;
+    /** Hard per-session effort ceiling every thinking-level change is clamped to. */
+    get thinkingLevelCeiling(): Effort | undefined;
     /** Configured selector, preserving `auto` while classification is active. */
     configuredThinkingLevel(): ConfiguredThinkingLevel | undefined;
     /** Whether per-turn automatic thinking classification is enabled. */

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

@@ -121,7 +121,11 @@ export declare class SessionAdvisors {
     /** Detaches and drains recorder feeds before transcript artifacts are removed. */
     detachAndCloseRecorders(): Promise<void>;
     /** Re-primes advisor transcript views across a conversation boundary. */
-    resetSessionState(): void;
+    resetSessionState(options?: {
+        preserveCost?: boolean;
+    }): void;
+    /** Drop the recorded spend once a conversation boundary has committed. */
+    clearCost(): void;
     /**
      * Rebind every live advisor to the active primary conversation's provider
      * identity (session id, prompt-cache key, credential + metadata resolvers,
@@ -216,6 +220,8 @@ export declare class SessionAdvisors {
             status: AdvisorRuntimeStatus;
         }[];
     };
+    /** Return cumulative advisor cost recorded for the current session. */
+    getAdvisorCost(): number;
     /**
      * Return structured advisor stats for the status command and TUI panel.
      */

package/dist/types/session/tool-choice-queue.d.ts

@@ -8,14 +8,14 @@ export interface RejectInfo {
     choice: ToolChoice;
     reason: "aborted" | "error" | "cleared" | "removed" | "unavailable" | "not_invoked";
 }
-/** "requeue" replays the lost yield next turn; "drop" (or void/undefined) discards it. */
-export type RejectOutcome = "requeue" | "drop";
+/** Controls whether rejection replays a yield, drops it, or drops its remaining sequence. */
+export type RejectOutcome = "requeue" | "drop" | "drop_sequence";
 export interface DirectiveCallbacks {
     /** Fires when the yield completed; onInvoked directives require the requested tool to run first. */
     onResolved?: (info: ResolveInfo) => void;
     /**
-     * Fires when the yield is being discarded. Return "requeue" to replay the
-     * same value at the head of the queue for the next turn. Default: "drop".
+     * Return "requeue" to replay the same value, or "drop_sequence" to discard
+     * its directive including later yields. Default: drop the rejected yield.
      */
     onRejected?: (info: RejectInfo) => RejectOutcome | undefined;
     /**
@@ -30,6 +30,8 @@ export interface ToolChoiceDirective {
     /** Stable label for targeted removal and debugging (e.g. "user-force"). */
     label: string;
     callbacks: DirectiveCallbacks;
+    /** Original multi-yield directive retained across one-yield replays. */
+    sequenceRoot?: ToolChoiceDirective;
 }
 export interface PushOptions {
     /** Prepend to head instead of appending to tail. Default: false. */

package/dist/types/session/turn-recovery.d.ts

@@ -1,8 +1,8 @@
 import { type Agent, type AgentMessage, type ThinkingLevel } from "@oh-my-pi/pi-agent-core";
-import type { AssistantMessage, CodexCompactionContext, Model, ToolChoice } from "@oh-my-pi/pi-ai";
+import type { AssistantMessage, CodexCompactionContext, Effort, Model, ToolChoice } from "@oh-my-pi/pi-ai";
 import type { ModelRegistry } from "../config/model-registry.js";
 import type { Settings } from "../config/settings.js";
-import type { ConfiguredThinkingLevel } from "../thinking.js";
+import { type ConfiguredThinkingLevel } from "../thinking.js";
 import type { AgentSessionEvent } from "./agent-session-events.js";
 import type { InitialRetryFallbackState } from "./agent-session-types.js";
 import { type RetryFallbackSelector } from "./retry-fallback-chains.js";
@@ -25,6 +25,8 @@ export interface TurnRecoveryHost {
     thinkingLevel(): ThinkingLevel | undefined;
     configuredThinkingLevel(): ConfiguredThinkingLevel | undefined;
     setThinkingLevel(level: ConfiguredThinkingLevel | undefined): void;
+    /** Hard per-session effort ceiling; fallback recovery must never raise thinking above it. */
+    thinkingLevelCeiling(): Effort | undefined;
     isDisposed(): boolean;
     isStreaming(): boolean;
     isCompacting(): boolean;

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

@@ -71,7 +71,7 @@ export declare class TaskTool implements AgentTool<TaskToolSchemaInstance, TaskT
     readonly mergeCallAndResult = true;
     get parameters(): TaskToolSchemaInstance;
     renderCall(args: unknown, options: Parameters<typeof renderTaskCall>[1], theme: Theme): import("@oh-my-pi/pi-tui").Component;
-    /** Dynamic description that reflects current disabled-agent settings */
+    /** Dynamic description that reflects current task settings. */
     get description(): string;
     private constructor();
     /**

package/dist/types/task/types.d.ts

@@ -83,7 +83,6 @@ export declare const taskItemSchema: import("arktype/internal/variants/object.ts
     name?: string | undefined;
     agent: import("arktype/internal/attributes.ts").Default<string, "task">;
     task: string;
-    effort?: "hi" | "lo" | "med" | undefined;
     outputSchema?: string | boolean | object | null | undefined;
     schemaMode?: "permissive" | "strict" | undefined;
 }, {}>;
@@ -108,7 +107,6 @@ export declare const taskSchema: import("arktype/internal/variants/object.ts").O
     name?: string | undefined;
     agent: import("arktype/internal/attributes.ts").Default<string, "task">;
     task: string;
-    effort?: "hi" | "lo" | "med" | undefined;
     outputSchema?: string | boolean | object | null | undefined;
     schemaMode?: "permissive" | "strict" | undefined;
     isolated?: boolean | undefined;
@@ -117,7 +115,6 @@ declare const ALL_TASK_SCHEMAS: readonly [import("arktype/internal/variants/obje
     name?: string | undefined;
     agent: import("arktype/internal/attributes.ts").Default<string, "task">;
     task: string;
-    effort?: "hi" | "lo" | "med" | undefined;
     outputSchema?: string | boolean | object | null | undefined;
     schemaMode?: "permissive" | "strict" | undefined;
     isolated?: boolean | undefined;
@@ -125,7 +122,6 @@ declare const ALL_TASK_SCHEMAS: readonly [import("arktype/internal/variants/obje
     name?: string | undefined;
     agent: import("arktype/internal/attributes.ts").Default<string, "task">;
     task: string;
-    effort?: "hi" | "lo" | "med" | undefined;
     outputSchema?: string | boolean | object | null | undefined;
     schemaMode?: "permissive" | "strict" | undefined;
 }, {}>, import("arktype/internal/variants/object.ts").ObjectType<{
@@ -134,7 +130,6 @@ declare const ALL_TASK_SCHEMAS: readonly [import("arktype/internal/variants/obje
         name?: string | undefined;
         agent: import("arktype/internal/attributes.ts").Default<string, "task">;
         task: string;
-        effort?: "hi" | "lo" | "med" | undefined;
         outputSchema?: string | boolean | object | null | undefined;
         schemaMode?: "permissive" | "strict" | undefined;
         isolated?: boolean | undefined;
@@ -145,7 +140,6 @@ declare const ALL_TASK_SCHEMAS: readonly [import("arktype/internal/variants/obje
         name?: string | undefined;
         agent: import("arktype/internal/attributes.ts").Default<string, "task">;
         task: string;
-        effort?: "hi" | "lo" | "med" | undefined;
         outputSchema?: string | boolean | object | null | undefined;
         schemaMode?: "permissive" | "strict" | undefined;
     }[];
@@ -154,14 +148,12 @@ type DynamicTaskSchema = (typeof ALL_TASK_SCHEMAS)[number];
 export type TaskSchema = typeof taskSchema;
 /** Active task tool parameter schema for the current isolation / batch flags */
 export type TaskToolSchemaInstance = DynamicTaskSchema | BaseType;
+/** Build the task wire schema for the current settings and spawn policy. */
 export declare function getTaskSchema(options: {
     isolationEnabled: boolean;
     batchEnabled: boolean;
-}): DynamicTaskSchema;
-export declare function getTaskSchema(options: {
-    isolationEnabled: boolean;
-    batchEnabled: boolean;
-    defaultAgent: string;
+    effortEnabled?: boolean;
+    defaultAgent?: string;
 }): TaskToolSchemaInstance;
 /**
  * Runtime params union over both wire shapes. The model sees exactly one shape

package/dist/types/thinking.d.ts

@@ -122,9 +122,28 @@ export type TaskEffort = (typeof TASK_EFFORTS)[number];
  * at — high, xhigh, or max), `med` = the middle (lower of the two middles for
  * an even-sized range). Without a model, maps over the full canonical range.
  * Returns `undefined` when the model has no controllable effort surface, so
- * callers fall back to their default selector (e.g. `auto`).
+ * callers fall back to their default selector (e.g. `auto`). Throws when the
+ * configured ceiling is below the model's lowest supported effort.
  */
-export declare function resolveTaskEffortLevel(model: Model | undefined, effort: TaskEffort): Effort | undefined;
+export declare function resolveTaskEffortLevel(model: Model | undefined, effort: TaskEffort, maxEffort?: Effort): Effort | undefined;
+/**
+ * Clamps a concrete thinking selector to a per-session effort ceiling (e.g. a
+ * task spawn's `task.maxEffort`-capped effort hint). `off`/`inherit`/
+ * `undefined` pass through, as do levels already at or below the ceiling.
+ * Levels above it snap to the highest model-supported effort at or below the
+ * ceiling. A model whose floor exceeds the ceiling has nothing valid to snap
+ * to; the requested level is returned unchanged and the caller is responsible
+ * for rejecting or skipping such models (see {@link modelSupportsEffortCeiling}).
+ */
+export declare function clampThinkingLevelToCeiling(model: Model | undefined, level: Effort | undefined, ceiling: Effort | undefined): Effort | undefined;
+export declare function clampThinkingLevelToCeiling(model: Model | undefined, level: ThinkingLevel | undefined, ceiling: Effort | undefined): ThinkingLevel | undefined;
+/**
+ * True when `model` can honor a thinking-effort ceiling: it either has no
+ * controllable effort surface (nothing to cap) or supports at least one effort
+ * at or below the ceiling. Retry-fallback candidate filtering uses this to
+ * skip models whose floor would force the session above the ceiling.
+ */
+export declare function modelSupportsEffortCeiling(model: Model, ceiling: Effort): boolean;
 /**
  * The provisional concrete level shown while `auto` is configured but before a
  * turn has been classified. Prefers the model's `defaultLevel`, otherwise High,

package/dist/types/utils/title-generator.d.ts

@@ -20,39 +20,40 @@ export declare function generateSessionTitle(firstMessage: string, registry: Mod
 export declare function generateTitleOnline(firstMessage: string, registry: ModelRegistry, settings: Settings, sessionId?: string, currentModel?: Model<Api>, metadataResolver?: (provider: string) => Record<string, unknown> | undefined, signal?: AbortSignal, customSystemPrompt?: string): Promise<string | null>;
 export declare function formatSessionTerminalTitle(sessionName: string | undefined, cwd?: string): string;
 /**
- * Set the terminal title using OSC 0 (sets both tab and window title). Unsupported terminals ignore it.
+ * Set the terminal title through the native Win32 API or OSC 0.
+ *
+ * Repeating the same sanitized title is a no-op on every platform.
  */
 export declare function setTerminalTitle(title: string): void;
 export declare function setSessionTerminalTitle(sessionName: string | undefined, cwd?: string): void;
 /**
  * Set a terminal title from an extension's `setTitle()`. Unlike the session base
- * title, this owns the terminal verbatim: the run-state separator will not rewrite
- * it on the next spinner tick or state change. Cleared when the app next sets an
- * authoritative session title via {@link setSessionTerminalTitle}.
+ * title, this owns the terminal verbatim: periodic and run-state updates will not
+ * rewrite it. Cleared when the app next sets an authoritative session title via
+ * {@link setSessionTerminalTitle}.
  */
 export declare function setExtensionTerminalTitle(title: string): void;
 export type TerminalTitleState = "idle" | "working" | "attention";
 /**
- * Compose the terminal title from the `π` brand, a state-carrying SEPARATOR, and
- * the session label. The brand never gains a prefix glyph — the separator slot
- * expresses the run state instead. Pure (no I/O) so the state→separator contract
- * is unit-testable:
- *   - `idle` (user's turn):  `π > label`  — reads like a prompt awaiting input;
- *   - `working`:             `π ⠋ label`  — spinner frames animate the separator;
- *   - `attention`:           `π ! label`  — agent blocked on the user;
- *   - disabled:              `π: label`   — the pre-state layout.
+ * Compose the terminal title from the `π` brand, a state-carrying separator, and
+ * the session label. Pure (no I/O) so the state→separator contract is testable:
+ *   - `idle` (user's turn):  `π > label`;
+ *   - `working`:             `π ⠋ label` (`π : label` on Windows);
+ *   - `attention`:           `π ! label`;
+ *   - disabled:              `π: label`.
  * Without a label the separator trails the brand (`π >`) so the state stays visible.
  */
-export declare function buildTerminalTitleWithState(label: string | undefined, state: TerminalTitleState, frame: number, enabled: boolean): string;
+export declare function buildTerminalTitleWithState(label: string | undefined, state: TerminalTitleState, frame: number, enabled: boolean, platform?: NodeJS.Platform): string;
 /**
  * Reflect the agent run state in the terminal title's separator: `working`
- * animates spinner frames in the separator slot, `idle` shows `>` (your turn),
- * `attention` shows `!` (agent blocked on you). Gated off by `tui.titleState`.
+ * animates outside Windows and stays `:` on Windows, `idle` shows `>` (your
+ * turn), and `attention` shows `!` (agent blocked on you). Gated off by
+ * `tui.titleState`.
  */
 export declare function setTerminalTitleState(state: TerminalTitleState): void;
 /** Enable/disable the run-state separator (driven by the `tui.titleState` setting). */
 export declare function setTerminalTitleStateEnabled(enabled: boolean): void;
-/** Stop the spinner timer; call on session/UI teardown. */
+/** Release terminal-title runtime resources. */
 export declare function disposeTerminalTitleState(): void;
 /**
  * Save the current terminal title on terminals that support xterm window ops.

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "17.1.5",
+	"version": "17.1.6",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -52,17 +52,17 @@
 		"@agentclientprotocol/sdk": "1.2.1",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "17.1.5",
-		"@oh-my-pi/omp-stats": "17.1.5",
-		"@oh-my-pi/pi-agent-core": "17.1.5",
-		"@oh-my-pi/pi-ai": "17.1.5",
-		"@oh-my-pi/pi-catalog": "17.1.5",
-		"@oh-my-pi/pi-mnemopi": "17.1.5",
-		"@oh-my-pi/pi-natives": "17.1.5",
-		"@oh-my-pi/pi-tui": "17.1.5",
-		"@oh-my-pi/pi-utils": "17.1.5",
-		"@oh-my-pi/pi-wire": "17.1.5",
-		"@oh-my-pi/snapcompact": "17.1.5",
+		"@oh-my-pi/hashline": "17.1.6",
+		"@oh-my-pi/omp-stats": "17.1.6",
+		"@oh-my-pi/pi-agent-core": "17.1.6",
+		"@oh-my-pi/pi-ai": "17.1.6",
+		"@oh-my-pi/pi-catalog": "17.1.6",
+		"@oh-my-pi/pi-mnemopi": "17.1.6",
+		"@oh-my-pi/pi-natives": "17.1.6",
+		"@oh-my-pi/pi-tui": "17.1.6",
+		"@oh-my-pi/pi-utils": "17.1.6",
+		"@oh-my-pi/pi-wire": "17.1.6",
+		"@oh-my-pi/snapcompact": "17.1.6",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/api-logs": "^0.220.0",
 		"@opentelemetry/context-async-hooks": "^2.9.0",