@oh-my-pi/pi-coding-agent 15.2.3 → 15.3.0

package/CHANGELOG.md

@@ -2,6 +2,39 @@
 
 ## [Unreleased]
 
+## [15.3.0] - 2026-05-25
+
+### Added
+
+- Added `OMP_NO_WEBP` environment variable to disable WebP encoding in image resize, fixing HTTP 400 errors when attaching browser snapshots to vision models running on local llama.cpp (which uses STB library that lacks WebP support)
+- Fixed loop mode submitting the next prompt while a background async-job delivery turn (idle flush) was still pending, which could cause the job result to be silently dropped and make the session appear to keep firing while work was ongoing ([#1294](https://github.com/can1357/oh-my-pi/issues/1294))
+- Fixed clipboard image paste (Ctrl+V) silently failing on WSL2 by routing image reads through a `powershell.exe` bridge when WSL interop is detected, since `arboard` returns `ContentNotAvailable` under WSLg ([#1280](https://github.com/can1357/oh-my-pi/issues/1280))
+- Fixed extension `ctx.ui.notify()` messages emitted during `session_start` being cleared before the first interactive render ([#1316](https://github.com/can1357/oh-my-pi/issues/1316)).
+- Fixed append-only context mode not being recomputed after model switches — the mode was frozen at session construction time using the initial model's provider, so `provider.appendOnlyContext=auto` left append-only enabled after switching away from DeepSeek (or disabled after switching to DeepSeek) for the rest of the session
+
+### Fixed
+- Fixed clipboard image paste (Ctrl+V) silently failing on WSL2 by routing image reads through a `powershell.exe` bridge when WSL interop is detected, since `arboard` returns `ContentNotAvailable` under WSLg ([#1280](https://github.com/can1357/oh-my-pi/issues/1280))
+## [15.2.4] - 2026-05-22
+### Breaking Changes
+
+- Replaced the legacy `@@` header and `+`/`<`/`=`/`-` hashline syntax with the new `§PATH` header and `«`/`»`/`≔` operation format, so existing hashline scripts and prompts using old symbols must be updated
+
+### Added
+
+- Added one-anchor `≔ANCHOR` shorthand equivalent to `≔ANCHOR..ANCHOR` for single-line replace/delete
+
+### Changed
+
+- Changed `≔A..B` so an omitted payload now deletes the range, and added an explicit empty payload line to keep a literal blank replacement line
+
+### Removed
+
+- Removed the `hsep` prompt helper and `PI_HL_SEP` payload-prefix configuration because hashline payloads are no longer line-prefixed
+
+### Fixed
+
+- Fixed hashline payload handling in parser and streaming preview to preserve blank lines as actual payload text until the next op, file header, or envelope marker
+
 ## [15.2.3] - 2026-05-22
 ### Breaking Changes
 
@@ -93,6 +126,10 @@
 - Fixed streaming edit previews for `apply_patch` and `hashline` jittering as the model typed `+added` lines. Two root causes addressed: (1) the trailing partial line of the streaming text input is now trimmed at each tick so a half-typed `+added` line no longer flickers; (2) the preview is rendered in the model's input order during streaming instead of re-deriving a unified diff via `Diff.structuredPatch`, whose coalescing previously reshuffled existing `+added` lines downward each time a new `-removed` line arrived. Existing additions now stay put and the preview only grows at the bottom while streaming. A residual trailing `-removed`/hunk-header block whose matching `+added` companion has not yet arrived is also suppressed until the additions land.
 - Fixed Perplexity web search appearing "logged out" roughly an hour after `omp auth login perplexity`. The search provider's `findOAuthToken` was honoring the bogus `expires = login_time + 1h` written by older logins (Perplexity JWTs typically omit `exp` because sessions are server-side) and silently dropping the credential. The loader now decodes the JWT's `exp` claim directly and only skips when the JWT itself is expired; tokens without an `exp` claim are treated as non-expiring.
 
+### Fixed
+
+- Fixed `legacy-pi-compat` failing to load plugin extensions (e.g. `pi-schedule-prompt@0.3.0`) that import `@mariozechner/pi-ai` when running from a compiled binary. `getResolvedSpecifier` called `Bun.resolveSync` against `import.meta.dir` inside `/$bunfs/root`, where the virtual FS exposes no resolvable `node_modules` tree at runtime; the throw silently dropped the plugin. The fix lets `rewriteLegacyPiImports` fall back gracefully on resolution failure so that `rewriteBareImportsForLegacyExtension` — which already runs immediately after — can resolve the original specifier against the plugin's own installed peer deps instead. The same fallback is applied to `resolveLegacyPiSpecifier` (the Bun plugin shim's `onResolve` handler) for tool/hook files loaded directly via Bun's import system. ([#1215](https://github.com/can1357/oh-my-pi/issues/1215))
+
 ## [15.1.7] - 2026-05-19
 
 ### Fixed
@@ -101,6 +138,9 @@
 - Fixed hashline edit payloads that use a readability space after `~` by warning on separator-padding-shaped payload blocks and tightening the model prompt. ([#1166](https://github.com/can1357/oh-my-pi/issues/1166))
 - Fixed ACP bash permission requests to include execute tool metadata and command content so clients can render command approval prompts consistently. ([#1189](https://github.com/can1357/oh-my-pi/issues/1189))
 - Fixed the status-line fast-mode indicator (`⚡`) rendering for scoped service tiers (`openai-only`, `claude-only`) even when the active model's provider didn't realize them — e.g. `serviceTier: "openai-only"` would still show the indicator next to a Claude model the wire request couldn't apply fast mode to. The indicator now consults a new `AgentSession.isFastModeActive()` predicate that runs the configured tier through `resolveServiceTier(tier, model.provider)` and only lights up when the result is `"priority"` for the current model. `isFastModeEnabled()` keeps its scope-aware semantics so `/fast on|off|toggle` and `/fast status` continue to reflect the user's configured intent.
+### Fixed
+
+- Fixed status-line context% computation freezing the UI for ~1.1 s every 2 s on long sessions (2,000+ messages). The earlier alignment fix (which uses `computeContextBreakdown` to match the `/context` slash command) was running on every agent event via `updateEditorTopBorder()` (event-controller.ts:163), and `computeContextBreakdown` walks every message through the native `countTokens` tokenizer (~0.5 ms each) — for the user's 2,312-message session this was ~1,120 ms synchronous blocking per cache miss, producing the user-visible "jittery rendering" and "status bar disappearing during streaming". `StatusLineComponent.getCachedContextBreakdown()` now uses an incremental per-message token cache: messages are walked ONCE during warm-up, and subsequent refreshes only compute tokens for the NEW messages appended since last call (typically 0–1 per refresh during streaming). The LAST message is always recomputed because its content may still be growing mid-stream; all prior messages are immutable once a newer message exists. Compaction (messages array shrinks) resets the cache. Non-message tokens (system prompt + tools + skills) are cached separately and invalidated via a cheap identity fingerprint. Result: 2,300-message warm refresh drops from ~1,120 ms to ~0.04 ms — 28,000× faster. Functional parity with the prior `computeContextBreakdown` path is preserved.
 
 ### Added
 
@@ -135,6 +175,7 @@
 - Fixed `deferAgentInitiatedTurns` handling during ACP async-job draining so background completion follow-up turns are delivered even when agent-initiated turns are deferred
 - Fixed ACP ordinary file-editing calls (`edit`, `write`, `ast_edit`) incorrectly requesting `session/request_permission` before every call, while keeping permission prompts for edit operations that delete or move files; permission requests now report the gated tool call as `pending` so clients can render the approval UI instead of returning `Permission request cancelled` without a visible prompt. ([#1134](https://github.com/can1357/oh-my-pi/pull/1134) by [@jiwangyihao](https://github.com/jiwangyihao))
 - Fixed the session tree selector to preserve a readable message column when deeply nested branch gutters would otherwise consume the viewport. ([#1144](https://github.com/can1357/oh-my-pi/issues/1144))
+- Fixed the TUI model selector to keep provider tab labels separate from provider ids, so the human-readable Ollama Cloud tab refreshes and filters `ollama-cloud` models correctly. ([#1153](https://github.com/can1357/oh-my-pi/issues/1153))
 
 ## [15.1.3] - 2026-05-17
 ### Breaking Changes

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

@@ -23,7 +23,7 @@ export declare const TAB_METADATA: Record<SettingTab, {
     icon: `tab.${string}`;
 }>;
 /** Status line segment identifiers */
-export type StatusLineSegmentId = "pi" | "model" | "mode" | "path" | "git" | "pr" | "subagents" | "token_in" | "token_out" | "token_total" | "token_rate" | "cost" | "context_pct" | "context_total" | "time_spent" | "time" | "session" | "hostname" | "cache_read" | "cache_write" | "session_name";
+export type StatusLineSegmentId = "pi" | "model" | "mode" | "path" | "git" | "pr" | "subagents" | "token_in" | "token_out" | "token_total" | "token_rate" | "cost" | "context_pct" | "context_total" | "time_spent" | "time" | "session" | "hostname" | "cache_read" | "cache_write" | "session_name" | "usage";
 /** Submenu choice metadata. */
 export type SubmenuOption<V extends string = string> = {
     value: V;
@@ -991,6 +991,15 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "number";
         readonly default: 2000;
     };
+    readonly "retry.maxDelayMs": {
+        readonly type: "number";
+        readonly default: number;
+        readonly ui: {
+            readonly tab: "model";
+            readonly label: "Max Retry Delay";
+            readonly description: "Maximum wait between retries, in ms. When the provider asks us to wait longer than this and no credential or model fallback succeeds, the request fails fast instead of sleeping (e.g. 3-hour Anthropic rate-limit windows).";
+        };
+    };
     readonly "retry.fallbackChains": {
         readonly type: "record";
         readonly default: Record<string, string[]>;
@@ -3075,6 +3084,29 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Use Parallel extract API for URL fetching when credentials are available";
         };
     };
+    readonly "provider.appendOnlyContext": {
+        readonly type: "enum";
+        readonly values: readonly ["auto", "on", "off"];
+        readonly default: "auto";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly label: "Append-Only Context";
+            readonly description: "Cache system prompt + tool specs and keep an append-only message log so provider prefix caches (DeepSeek, Anthropic) hit at maximum rate. Auto enables for DeepSeek.";
+            readonly options: readonly [{
+                readonly value: "auto";
+                readonly label: "Auto";
+                readonly description: "Enable for DeepSeek (recommended)";
+            }, {
+                readonly value: "on";
+                readonly label: "On";
+                readonly description: "Always enable append-only context";
+            }, {
+                readonly value: "off";
+                readonly label: "Off";
+                readonly description: "Disable append-only context";
+            }];
+        };
+    };
     readonly "exa.enabled": {
         readonly type: "boolean";
         readonly default: true;
@@ -3283,6 +3315,7 @@ export interface RetrySettings {
     enabled: boolean;
     maxRetries: number;
     baseDelayMs: number;
+    maxDelayMs: number;
 }
 export interface MemoriesSettings {
     enabled: boolean;

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

@@ -113,6 +113,12 @@ export declare class Settings {
      */
     setDisabledProviders(ids: string[]): void;
 }
+/**
+ * Subscribe to append-only mode setting changes.
+ * Returns an unsubscribe function. Multiple sessions (main + subagents)
+ * can register independently without overwriting each other.
+ */
+export declare function onAppendOnlyModeChanged(cb: (value: string) => void): () => void;
 export declare function isSettingsInitialized(): boolean;
 /**
  * Reset the global singleton for testing.

package/dist/types/discovery/helpers.d.ts

@@ -101,6 +101,7 @@ export interface ParsedAgentFields {
     model?: string[];
     output?: unknown;
     thinkingLevel?: ThinkingLevel;
+    autoloadSkills?: string[];
     blocking?: boolean;
 }
 /**

package/dist/types/goals/runtime.d.ts

@@ -54,6 +54,10 @@ export declare class GoalRuntime {
         objective: string;
         tokenBudget?: number;
     }): Promise<GoalModeState>;
+    replaceGoal(input: {
+        objective: string;
+        tokenBudget?: number;
+    }): Promise<GoalModeState>;
     resumeGoal(): Promise<GoalModeState>;
     pauseGoal(): Promise<GoalModeState | undefined>;
     dropGoal(): Promise<Goal | undefined>;

package/dist/types/hashline/constants.d.ts

@@ -2,8 +2,6 @@
 export declare const MISMATCH_CONTEXT = 2;
 /** Filler hash used for the interior of a multi-line range; not validated. */
 export declare const RANGE_INTERIOR_HASH = "**";
-/** Header marker introducing a new file section in multi-section input. */
-export declare const FILE_HEADER_PREFIX = "@";
 /** Optional patch envelope start marker; silently consumed when present. */
 export declare const BEGIN_PATCH_MARKER = "*** Begin Patch";
 /** Optional patch envelope end marker; terminates parsing when encountered. */

package/dist/types/hashline/hash.d.ts

@@ -64,47 +64,21 @@ export declare function resolveHashlineGrammarPlaceholders(grammar: string): str
 /** @deprecated Use {@link resolveHashlineGrammarPlaceholders}. */
 export declare const resolveLarkLidPlaceholders: typeof resolveHashlineGrammarPlaceholders;
 /**
- * Single source of truth for the hashline edit payload separator. This is the
- * configured separator that starts inserted/replacement payload lines in
- * hashline edit input (`<separator>TEXT`) and separates inline modify ops from
- * their appended/prepended text.
+ * Hashline edit input markers. File section headers start with {@link HL_FILE_PREFIX};
+ * op lines start with a direction/action sigil: {@link HL_OP_INSERT_BEFORE},
+ * {@link HL_OP_INSERT_AFTER}, or {@link HL_OP_REPLACE}. Payload lines are
+ * verbatim file content and have no per-line marker.
  *
- * Override at runtime with the `PI_HL_SEP` env var (e.g.
- * `PI_HL_SEP=">"`, `PI_HL_SEP="\\"`). The value is read once at module load;
- * the edit grammar, prompt helper, and edit parser derive from it.
- *
- * Default is `~`, chosen empirically. Benchmark across 8 candidate separators
- * x 3 models (glm-4.7:nitro, gpt-5.4-nano, claude-sonnet-4-6), 24-48 runs per
- * cell, hashline variant, 12 sampled tasks per run:
- *
- *   sep | task ✓ | edit ✓ | patch fail      | tok/run
- *   ----|--------|--------|-----------------|--------
- *    +  | 70.8%  | 78.0%  | 27/125 (21.6%)  | 32,127
- *    ÷  | 70.7%  | 90.6%  | 22/211 (10.4%)  | 31,666
- *    ~  | 69.4%  | 94.9%  |  6/107 ( 5.6%)  | 30,529   <-- default
- *    >  | 69.2%  | 91.5%  | 21/219 ( 9.6%)  | 30,777
- *    :  | 66.7%  | 86.4%  | 20/126 (15.9%)  | 33,900
- *    |  | 65.9%  | 86.9%  | 20/127 (15.7%)  | 34,589
- *    \  | 65.5%  | 89.8%  | 16/124 (12.9%)  | 36,010
- *    %  | 63.9%  | 92.8%  | 11/125 ( 8.8%)  | 36,530
- *
- * `~` wins because:
- *   - highest edit-tool success rate (94.9%) of any tested separator
- *   - lowest patch-failure rate (5.6%) — model rarely emits a malformed payload
- *   - cheapest in tokens alongside `>` (no retry overhead from format collisions)
- *   - no line-leading role in any mainstream language, markdown, diff, regex,
- *     or shell, so payload lines are unambiguous to both the parser and models
- *   - task-success is statistically tied with `>` and `÷` (within run-to-run
- *     noise), so the edit-reliability win is free
- *
- * `+` and `÷` lead on raw task-success but at the cost of ~2-4x more patch
- * failures (the model retries until it lands a valid edit). `:`, `|`, `\`
- * collide with line-leading syntax (label/object-key, body separator, escape)
- * and degrade both edit reliability and intent-match.
+ * These constants are the single source of truth for the edit parser, grammar,
+ * renderer, and prompt.
  */
-export declare const HL_EDIT_SEP: string;
-/** Regex-escaped form of {@link HL_EDIT_SEP}, safe for regexes. */
-export declare const HL_EDIT_SEP_RE_RAW: string;
+export declare const HL_OP_INSERT_BEFORE = "\u00AB";
+export declare const HL_OP_INSERT_AFTER = "\u00BB";
+export declare const HL_OP_REPLACE = "\u2254";
+/** All hashline edit op sigils, concatenated for fast membership tests. */
+export declare const HL_OP_CHARS = "\u00AB\u00BB\u2254";
+/** Hashline edit file section header marker. */
+export declare const HL_FILE_PREFIX = "\u00A7";
 /** Stable separator for read/search/hashline display output. Intentionally not configurable. */
 export declare const HL_BODY_SEP = "|";
 /** Regex-escaped form of {@link HL_BODY_SEP}, safe for embedding inside a regex. */

package/dist/types/hashline/parser.d.ts

@@ -1,11 +1,7 @@
 import type { HashlineCursor, HashlineEdit } from "./types";
 export declare function cloneCursor(cursor: HashlineCursor): HashlineCursor;
-export declare function parseHashline(diff: string, opts?: ParseHashlineOptions): HashlineEdit[];
-export interface ParseHashlineOptions {
-    /** File path the diff targets. Used to suppress indent-sensitive false-positive warnings. */
-    path?: string;
-}
-export declare function parseHashlineWithWarnings(diff: string, opts?: ParseHashlineOptions): {
+export declare function parseHashline(diff: string): HashlineEdit[];
+export declare function parseHashlineWithWarnings(diff: string): {
     edits: HashlineEdit[];
     warnings: string[];
 };

package/dist/types/modes/components/status-line/types.d.ts

@@ -44,6 +44,16 @@ export interface SegmentContext {
             url: string;
         } | null;
     };
+    usage: {
+        fiveHour?: {
+            percent: number;
+            resetMinutes?: number;
+        };
+        sevenDay?: {
+            percent: number;
+            resetHours?: number;
+        };
+    } | null;
 }
 export interface RenderedSegment {
     content: string;

package/dist/types/modes/components/status-line.d.ts

@@ -53,6 +53,16 @@ export declare class StatusLineComponent implements Component {
     watchBranch(onBranchChange: () => void): void;
     dispose(): void;
     invalidate(): void;
+    /**
+     * Compute the (cached) used-tokens / context-window totals for the
+     * status-line context% segment. Exposed (non-private) so unit tests can
+     * verify the incremental-cache invariants; not part of any external
+     * API.
+     */
+    getCachedContextBreakdown(): {
+        usedTokens: number;
+        contextWindow: number;
+    };
     getTopBorder(width: number): {
         content: string;
         width: number;

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

@@ -171,7 +171,9 @@ export declare class InteractiveMode implements InteractiveModeContext {
         updateFooter?: boolean;
         populateHistory?: boolean;
     }): void;
-    renderInitialMessages(prebuiltContext?: SessionContext): void;
+    renderInitialMessages(prebuiltContext?: SessionContext, options?: {
+        preserveExistingChat?: boolean;
+    }): void;
     getUserMessageText(message: Message): string;
     findLastAssistantMessage(): AssistantMessage | undefined;
     extractAssistantText(message: AssistantMessage): string;

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

@@ -3,4 +3,13 @@ import type { TabBarTheme } from "@oh-my-pi/pi-tui";
 export declare function sanitizeStatusText(text: string): string;
 /** Shared tab bar theme used by model-selector and settings-selector. */
 export declare function getTabBarTheme(): TabBarTheme;
+/**
+ * Suffix appended to the loader's working message to remind users they can
+ * abort with Esc. Rendered with the active theme's bracket glyphs so it stays
+ * visually consistent with badges and other bracketed UI affordances.
+ *
+ * The leading space separates the hint from the message body and is consumed
+ * by `endsWith`/`slice` matching in the loader renderer.
+ */
+export declare function interruptHint(): string;
 export { parseCommandArgs } from "../utils/command-args";

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

@@ -1,13 +1,16 @@
 import type { Theme, ThemeColor } from "./theme";
 type ShimmerTheme = Pick<Theme, "bold" | "fg" | "getFgAnsi">;
+type ShimmerPaletteTier = ThemeColor | {
+    ansi: string;
+};
 /** Three-tier color stack a shimmer character cycles through as the band sweeps. */
 export interface ShimmerPalette {
     /** Color for chars outside / at the edge of the band (intensity < ~0.22). */
-    low: ThemeColor;
+    low: ShimmerPaletteTier;
     /** Color for chars approaching the crest (~0.22 ≤ intensity < ~0.65). */
-    mid: ThemeColor;
+    mid: ShimmerPaletteTier;
     /** Color at the band's crest (intensity ≥ ~0.65). */
-    high: ThemeColor;
+    high: ShimmerPaletteTier;
     /** Whether to bold the crest tier. Default `false`. */
     bold?: boolean;
 }

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

@@ -168,7 +168,9 @@ export interface InteractiveModeContext {
         updateFooter?: boolean;
         populateHistory?: boolean;
     }): void;
-    renderInitialMessages(prebuiltContext?: SessionContext): void;
+    renderInitialMessages(prebuiltContext?: SessionContext, options?: {
+        preserveExistingChat?: boolean;
+    }): void;
     getUserMessageText(message: Message): string;
     findLastAssistantMessage(): AssistantMessage | undefined;
     extractAssistantText(message: AssistantMessage): string;

package/dist/types/modes/utils/context-usage.d.ts

@@ -1,5 +1,7 @@
 import type { Model } from "@oh-my-pi/pi-ai";
+import type { Skill } from "../../extensibility/skills";
 import type { AgentSession } from "../../session/agent-session";
+import type { Tool } from "../../tools";
 import type { theme as Theme } from "../theme/theme";
 type CategoryId = "systemPrompt" | "systemContext" | "systemTools" | "skills" | "messages";
 interface CategoryInfo {
@@ -17,6 +19,21 @@ export interface ContextBreakdown {
     autoCompactBufferTokens: number;
     freeTokens: number;
 }
+export declare function estimateSkillsTokens(skills: readonly Skill[]): number;
+export declare function estimateToolSchemaTokens(tools: ReadonlyArray<Pick<Tool, "name" | "description" | "parameters">>): number;
+/**
+ * Compute just the NON-MESSAGE token total: system prompt (with its skills
+ * section subtracted, since skills are tokenized separately) + system context
+ * (the rest of the system-prompt array) + tools + skills.
+ *
+ * Exposed so callers like `StatusLineComponent` can cache the non-message
+ * total separately from the message total. Non-message inputs (skills,
+ * tools, system prompt) change rarely; the message list grows on every
+ * streaming turn. Splitting the two lets the caller refresh each on its own
+ * cadence — non-message recomputed only when the inputs identity changes,
+ * messages walked incrementally as new entries append.
+ */
+export declare function computeNonMessageTokens(session: AgentSession): number;
 /**
  * Compute a breakdown of estimated context usage by category for the active
  * session and model.

package/dist/types/modes/utils/ui-helpers.d.ts

@@ -3,6 +3,9 @@ import type { AssistantMessage, Message } from "@oh-my-pi/pi-ai";
 import { type Component } from "@oh-my-pi/pi-tui";
 import type { InteractiveModeContext } from "../../modes/types";
 import type { SessionContext } from "../../session/session-manager";
+interface RenderInitialMessagesOptions {
+    preserveExistingChat?: boolean;
+}
 export declare class UiHelpers {
     #private;
     private ctx;
@@ -31,7 +34,7 @@ export declare class UiHelpers {
         updateFooter?: boolean;
         populateHistory?: boolean;
     }): void;
-    renderInitialMessages(prebuiltContext?: SessionContext): void;
+    renderInitialMessages(prebuiltContext?: SessionContext, options?: RenderInitialMessagesOptions): void;
     clearEditor(): void;
     showError(errorMessage: string): void;
     showWarning(warningMessage: string): void;
@@ -47,3 +50,4 @@ export declare class UiHelpers {
     findLastAssistantMessage(): AssistantMessage | undefined;
     extractAssistantText(message: AssistantMessage): string;
 }
+export {};

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

@@ -417,6 +417,15 @@ export declare class AgentSession {
     refreshRpcHostTools(rpcTools: AgentTool[]): Promise<void>;
     /** Whether auto-compaction is currently running */
     get isCompacting(): boolean;
+    /**
+     * Whether idle-flush tasks, auto-continuations, or other short-lived
+     * post-prompt work are pending.  True in the brief window after
+     * `session.prompt()` returns but before a scheduled background delivery
+     * (e.g. an async-job result) has finished its own streaming turn.
+     * Loop-mode and similar auto-submit paths should treat this as a block
+     * to avoid racing against the delivery turn.
+     */
+    get hasPostPromptWork(): boolean;
     /** All messages including custom types like BashExecutionMessage */
     get messages(): AgentMessage[];
     buildDisplaySessionContext(): SessionContext;

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

@@ -7,7 +7,7 @@ import type { AgentTelemetryConfig, ThinkingLevel } from "@oh-my-pi/pi-agent-cor
 import { ModelRegistry } from "../config/model-registry";
 import type { PromptTemplate } from "../config/prompt-templates";
 import { Settings } from "../config/settings";
-import type { Skill } from "../extensibility/skills";
+import { type Skill } from "../extensibility/skills";
 import type { HindsightSessionState } from "../hindsight/state";
 import type { LocalProtocolOptions } from "../internal-urls";
 import type { MCPManager } from "../mcp/manager";
@@ -73,6 +73,8 @@ export interface ExecutorOptions {
      * transition explicitly.
      */
     parentTelemetry?: AgentTelemetryConfig;
+    /** Skills to autoload via sendCustomMessage before the first prompt */
+    autoloadSkills?: Skill[];
 }
 export interface YieldItem {
     data?: unknown;

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

@@ -148,6 +148,7 @@ export interface AgentDefinition {
     thinkingLevel?: ThinkingLevel;
     output?: unknown;
     blocking?: boolean;
+    autoloadSkills?: string[];
     source: AgentSource;
     filePath?: string;
 }
@@ -189,6 +190,30 @@ export interface AgentProgress {
     modelOverride?: string | string[];
     /** Data extracted by registered subprocess tool handlers (keyed by tool name) */
     extractedToolData?: Record<string, unknown[]>;
+    /**
+     * Auto-retry state when the subagent is sleeping between provider retries
+     * (e.g. 429 rate-limit with retry-after). Cleared when the retry resolves
+     * or fails. Surfacing this to the parent prevents the task tool from
+     * looking indefinitely "in progress" when a child is actually blocked on
+     * provider quota.
+     */
+    retryState?: {
+        attempt: number;
+        maxAttempts: number;
+        delayMs: number;
+        errorMessage: string;
+        startedAtMs: number;
+    };
+    /**
+     * Terminal retry failure surfaced once the subagent gave up retrying
+     * (e.g. retry-after exceeded the cap, or all attempts exhausted). Carries
+     * the final error so the parent UI can render "blocked: rate-limited"
+     * instead of waiting for a status that never arrives.
+     */
+    retryFailure?: {
+        attempt: number;
+        errorMessage: string;
+    };
 }
 /** Result from a single agent execution */
 export interface SingleResult {
@@ -227,6 +252,16 @@ export interface SingleResult {
     nestedPatches?: NestedRepoPatch[];
     /** Data extracted by registered subprocess tool handlers (keyed by tool name) */
     extractedToolData?: Record<string, unknown[]>;
+    /**
+     * Terminal retry failure, when the subagent exited because the auto-retry
+     * loop gave up (retry-after exceeded the cap, or all attempts exhausted).
+     * Lets the parent task tool surface a "blocked: rate-limited" outcome
+     * instead of a generic failure.
+     */
+    retryFailure?: {
+        attempt: number;
+        errorMessage: string;
+    };
     /** Output metadata for agent:// URL integration */
     outputMeta?: {
         lineCount: number;

package/dist/types/tools/bash-command-fixup.d.ts

@@ -9,8 +9,3 @@ export interface BashFixupResult {
  * or no-op transform, returns the input verbatim with `stripped: []`.
  */
 export declare function applyBashFixups(command: string): BashFixupResult;
-/**
- * Human-readable notice for the fixups that fired. Mirrors the shape of
- * `formatTimeoutClampNotice` so it can ride alongside the other bash notices.
- */
-export declare function formatBashFixupNotice(stripped: readonly string[]): string | undefined;

package/dist/types/utils/clipboard.d.ts

@@ -13,7 +13,9 @@ export declare function copyToClipboard(text: string): Promise<void>;
  * Read an image from the system clipboard.
  *
  * Returns null on Termux (no image clipboard support) or when no display
- * server is available (headless/SSH without forwarding).
+ * server is available (headless/SSH without forwarding). Under WSL the
+ * Windows clipboard is reached through `powershell.exe`, since WSLg's
+ * Wayland clipboard does not carry image payloads through to `arboard`.
  *
  * @returns PNG payload or null when no image is available.
  */

package/dist/types/utils/image-resize.d.ts

@@ -4,6 +4,7 @@ export interface ImageResizeOptions {
     maxHeight?: number;
     maxBytes?: number;
     jpegQuality?: number;
+    excludeWebP?: boolean;
 }
 export interface ResizedImage {
     buffer: Uint8Array;
@@ -20,11 +21,13 @@ export interface ResizedImage {
  *
  * Strategy:
  *  1. Probe metadata. If already within all limits, return original.
- *  2. Resize to fit max dimensions and encode at high quality across PNG/JPEG/WebP — return smallest.
+ *  2. Resize to fit max dimensions and encode at high quality across PNG/JPEG (+ WebP) — return smallest.
  *  3. If still too large, walk a lossy JPEG/WebP quality ladder.
  *  4. If still too large, walk a dimension-scale ladder × quality ladder.
  *  5. If still too large, return the smallest variant produced.
  *
+ * Set OMP_NO_WEBP to exclude WebP from encoding (llama.cpp STB doesn't decode it).
+ *
  * Backed by `Bun.Image`: a chainable native pipeline that runs decode/transform/encode
  * off the JS thread when the terminal (`.bytes()`) is awaited.
  */

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "15.2.3",
+	"version": "15.3.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -47,12 +47,12 @@
 		"@agentclientprotocol/sdk": "0.21.0",
 		"@babel/parser": "^7.29.3",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/omp-stats": "15.2.3",
-		"@oh-my-pi/pi-agent-core": "15.2.3",
-		"@oh-my-pi/pi-ai": "15.2.3",
-		"@oh-my-pi/pi-natives": "15.2.3",
-		"@oh-my-pi/pi-tui": "15.2.3",
-		"@oh-my-pi/pi-utils": "15.2.3",
+		"@oh-my-pi/omp-stats": "15.3.0",
+		"@oh-my-pi/pi-agent-core": "15.3.0",
+		"@oh-my-pi/pi-ai": "15.3.0",
+		"@oh-my-pi/pi-natives": "15.3.0",
+		"@oh-my-pi/pi-tui": "15.3.0",
+		"@oh-my-pi/pi-utils": "15.3.0",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",

package/src/config/prompt-templates.ts

@@ -8,7 +8,7 @@ import {
 	parseFrontmatter,
 	prompt,
 } from "@oh-my-pi/pi-utils";
-import { computeLineHash, HL_BODY_SEP, HL_EDIT_SEP } from "../hashline/hash";
+import { computeLineHash, HL_BODY_SEP } from "../hashline/hash";
 import { jtdToTypeScript } from "../tools/jtd-to-typescript";
 import { parseCommandArgs, substituteArgs } from "../utils/command-args";
 
@@ -154,13 +154,6 @@ prompt.registerHelper("hline", function (this: unknown, ...args: unknown[]): str
 	return `${ref}${HL_BODY_SEP}${text}`;
 });
 
-/**
- * {{hsep}} — emit the configured hashline payload separator character.
- * Stays in sync with {@link HL_EDIT_SEP} so edit prompt templates
- * never have to hardcode the payload separator.
- */
-prompt.registerHelper("hsep", (): string => HL_EDIT_SEP);
-
 const INLINE_ARG_SHELL_PATTERN = /\$(?:ARGUMENTS|@(?:\[\d+(?::\d*)?\])?|\d+)/;
 const INLINE_ARG_TEMPLATE_PATTERN = /\{\{[\s\S]*?(?:\b(?:arguments|ARGUMENTS|args)\b|\barg\s+[^}]+)[\s\S]*?\}\}/;