{"uuid": "166ece62-aa3e-4bef-bd50-989c6b1796f2", "vulnerability_lookup_origin": "1a89b78e-f703-45f3-bb86-59eb712668bd", "author": "9f56dd64-161d-43a6-b9c3-555944290a09", "vulnerability": "CVE-2024-24576", "type": "seen", "source": "https://gist.github.com/pedropaulovc/e894c4438b84a9c5c01927f012837b39", "content": "# Changelog\n\n## [Unreleased]\n\n### Added\n\n- Added bounded ambient or wake progress for asynchronous Bash jobs and supervised Hub processes. Bash `async: \"auto\"` keeps quick commands inline, agents can attach to existing processes without polling, rate-limited previews retain complete artifacts and expand with Ctrl+O, and completion notices surface failure and exit status ([#2762](https://github.com/can1357/oh-my-pi/issues/2762)).\n\n### Fixed\n\n- Fixed daemon broker idle shutdown closing newly accepted clients before their authentication request could be processed under load.\n- Fixed supervised image tunnels rejecting a published URL when the child exited between the startup poll's log read and exit check.\n\n## [17.4.2] - 2026-08-21\n\n### Added\n\n- Added an opt-in image URL broker (`images.urls.enabled`) that publishes outgoing images through an ordered chain of backends instead of sending inline base64 to URL-fetching providers\n- Composer attachment chips (ported from omp2): pasted images and large text pastes stage as rounded preview cards above the prompt \u2014 image cards show a live thumbnail (Kitty Unicode placeholders) with pixel dimensions, text cards a snippet with `+N lines`/`N chars` \u2014 while the editor buffer holds a compact ` #N` token in the card's identity color.\n\n### Changed\n\n- Pasted images now insert only the `[Image #N, WxH]` marker; the redundant trailing `attachment://N` URI is no longer added to the composer.\n- Added a consolidated CLI reference (`docs/cli-reference.md`) documenting every top-level subcommand and launch flag, including headless print mode (`--print`/`-p`, `--print-thoughts`) ([#9252](https://github.com/can1357/oh-my-pi/issues/9252))\n\n### Fixed\n\n- Fixed unreadable colors in macOS Terminal.app by using its supported 256-color mode ([#9162](https://github.com/can1357/oh-my-pi/issues/9162)).\n- Fixed Esc after a fast `/mcp test` result aborting the active agent turn instead of consuming the advertised cancellation input ([#9173](https://github.com/can1357/oh-my-pi/issues/9173)).\n- Fixed task spawns crashing when legacy boolean per-agent prewalk or advisor overrides are present in `config.yml`.\n- Fixed ACP `session/prompt` requests hanging forever when a builtin slash command's residual prompt (e.g. `/force: /some-command`) resolved locally, which also wedged all subsequent prompts on the session ([#9206](https://github.com/can1357/oh-my-pi/issues/9206)).\n- Fixed eval-spawned subagent output being omitted from per-turn output-token budgets, including failed and isolated runs ([#9187](https://github.com/can1357/oh-my-pi/issues/9187)).\n- Fixed `/compact` over RPC blocking the serialized command queue for the full summarization round-trip, so a follow-up `abort` could not interrupt it ([#9200](https://github.com/can1357/oh-my-pi/issues/9200)).\n- Fixed RPC UI select requests dropping option descriptions, allowing hosts to render described choices ([#9175](https://github.com/can1357/oh-my-pi/issues/9175)).\n- Fixed `/todo edit` failing with \"Could not parse Markdown\" when checklist items had backslash-escaped brackets (`- \\[x\\]`), which editors and markdown renderers commonly emit ([#9188](https://github.com/can1357/oh-my-pi/issues/9188)).\n- Fixed `omp setup --check`/`--json` with no component printing usage text to stdout and exiting 0; it now errors on stderr and exits non-zero so scripted JSON health checks fail loudly ([#9221](https://github.com/can1357/oh-my-pi/issues/9221)).\n- Fixed an aggressive `task.maxRuntimeMs` mislabeling committed subagent outcomes: a budget-killed run is no longer reported as a runtime-limit timeout, and a subagent that yielded a complete result before the deadline is no longer reported as aborted when teardown crosses the deadline ([#9191](https://github.com/can1357/oh-my-pi/issues/9191)).\n- Fixed startup fallback-chain warnings for discovered OpenCode Zen, OpenCode Go, and GitHub Copilot models cached under credential-scoped IDs ([#9205](https://github.com/can1357/oh-my-pi/issues/9205)).\n- Fixed interactive `/models` and Ctrl+P cycling omitting an `enabledModels`/`--models` model discovered by a background provider refresh (e.g. `opencode-go/ox-alpha-free`) after startup, by rebuilding the scoped list once discovery completes ([#9220](https://github.com/can1357/oh-my-pi/issues/9220)).\n- Documented how to enable, trigger, target, and manually re-arm prewalk ([#9179](https://github.com/can1357/oh-my-pi/issues/9179)).\n- Pasted images and large text pastes appear in the composer as compact icon tokens instead of bracketed markers; the bracketed form remains the outgoing/stored format, and the transcript renders it back as the compact chip.\n- Deleting an attachment's inline token now removes the attachment from the submission (surviving image markers are renumbered).\n- Restored prompts (esc-esc, `/tree`, branch, queued-message dequeue, failed-submit recovery) collapse image markers back into clickable atomic chip tokens and re-materialize their file links instead of degrading to dead text.\n\n## [17.4.1] - 2026-08-21\n\n### Added\n\n- Added `PERSONALITY.md` support: `~/.omp/agent/PERSONALITY.md` (profile/XDG-aware agent dir) replaces the system prompt's personality block text; `personality: none` still omits the block ([#8528](https://github.com/can1357/oh-my-pi/issues/8528))\n- Sloppy edits now support inline replacements with `\u27eaold\u2502new\u27eb` syntax (`\u27eaold\u2502\u27eb` for deletions and `\u27ea\u2502new\u27eb` for insertions), alongside automatic recovery for common formatting mistakes without needing a retry.\n- Sloppy edits now recover operations that mix `\u27eaold\u2502new\u27eb` inline replacements with a `\u00bb` REWRITE instead of failing the payload: a redundant REWRITE is dropped, a diverging one is applied as the final text, and a note explains the interpretation.\n- Expanded archive support in `read` and `write` tools: `read` can now inspect and extract members from `.rar`, `.7z`, `.iso`, `.cab`, `.deb`, `.rpm`, `.cpio`, `.ar`/`.a`, `.lzh`, `.arj`, compressed tar files (`.tar.bz2`, `.tar.xz`, `.tar.zst`), package formats (`.whl`, `.ipa`, `.xpi`, `.vsix`, `.nupkg`, `.cbz`, `.cbr`), `.asar` archives, and single-file compressed streams; `write` can create `.tar.zst` and update `.asar` archives.\n- Added Code Mode for Codex `code_mode_only` models via `providers.openai-codex.codeMode` (`off`/`on`/`auto`), demoting non-essential tools into an eval bridge with generated TypeScript definitions.\n- MCP tool names longer than 64 characters are now automatically truncated with a deterministic hash suffix to comply with strict provider validators.\n- Marketplace-installed plugins with manifest settings can now be configured through `omp plugin config` and Settings \u2192 Plugins.\n- Configured discovery providers with `authHeader` now preserve cached models across application restarts.\n- Added repeat read warning hints when identical file content is read multiple times.\n- Explicit DAP adapters can now attach without a PID or port when `attachDefaults` provide the target arguments.\n- Added `isProjectTrusted()` compatibility shim to `ExtensionContext` for extensions targeting upstream per-directory trust gates.\n\n### Changed\n\n- Added `compaction.asyncEnabled` (default: on) to speculatively summarize context in the background before hitting threshold limits, avoiding blocking summarization pauses.\n- Replaced `compaction.strategy` and `compaction.remoteEnabled` with an ordered `compaction.methodOrder` preference list.\n- Handoff maintenance (`/handoff` and automatic handoff compaction) now commits generated summaries directly to the active session instead of starting a new session.\n- Added `extendedContext` setting (`/settings` \u2192 Context \u2192 General, default: on) to optionally clamp models with premium long-context pricing tiers (such as OpenAI GPT-5.6 Sol/Terra/Luna) to standard-pricing token limits before compaction triggers.\n- Token counting and token estimations are now dynamically scoped to each specific model tokenizer rather than using a single process-global tokenizer.\n- `omp cleanse` and `/cleanse` now feature a live interactive status board displaying active checkers, repair subagents, tool metrics, and token/cost totals in real time.\n- Eval-bridge nested `tool.()` calls now enforce ACP permission gates and tool allowlists identically to direct tool calls.\n- Added `tokenizer` option to custom models and `modelOverrides` to allow overriding the local tokenizer family for proxied model endpoints.\n- Added `qwenTemplateReasoningEffort` to the `models.yml` `compat` schema to configure or disable reasoning effort flags for strict local inference servers.\n- Settings menus now support click-to-toggle and drag-to-reorder for list items, as well as warning indicators and risk notes on sensitive options such as External Thinking.\n- Supervised process completion notices now render as compact single-line entries.\n- The todo HUD header now displays a consolidated progress bar showing task completion across all stages.\n- `/settings` rows can now carry a risk note: a warning glyph on the row plus a warning-colored line above the description. `External Thinking` (`externalThinking`, `--external-thinking`) is the first user \u2014 providers have flagged the request shape it produces as abuse, up to account-level enforcement, so both the settings entry and `--help` now say so.\n\n### Fixed\n\n- Fixed SDK sessions with a custom agent directory inheriting process-global model overrides instead of loading that directory's own `models.yml`.\n- Fixed regional HTTP 401 data-residency errors during Codex chat, web search, and image generation requests by passing token residency metadata on requests.\n- Fixed macOS SSH ControlMaster socket creation failures caused by `sun_path` length limits when using named profiles.\n- Fixed an issue where Nix-packaged builds failed to load on-demand native addons (`onnxruntime-node`/`sherpa-onnx`) due to missing shared C++ runtime library paths.\n- Fixed external editor spawning (Ctrl+G, plan review, `/todo edit`) failing to attach to visible terminals for editors like `emacsclient`.\n- Fixed `omp --resume` spinning at 100% CPU when new session entries arrived during initial transcript rendering.\n- Fixed session resume hints and fatal exit messages omitting the active `--profile` argument.\n- Fixed MCP OAuth authorization requests failing on pre-registered clients with restricted scopes by using RFC 9728 `scopes_supported`.\n- Fixed isolated task subagents causing out-of-memory crashes on repositories with large uncommitted binary files by pre-sizing diffs and enforcing snapshot limits.\n- Fixed LM Studio and lazy-loaded local models retaining uninitialized context lengths by re-probing loaded context lengths after initial inference.\n- Fixed project-scoped Claude Code marketplace plugins incorrectly loading into sessions in other projects.\n- Fixed configured advisors backed by discoverable providers remaining inactive on initial session startup until manually toggled.\n- Fixed resolving `--model @` failing for roles backed by discovery providers like oMLX, Ollama, and llama-swap.\n- Fixed retry fallback chains stopping prematurely when encountering nested fallback configurations, and fixed session role priority during fallback chain selection.\n- Fixed cancelled prompts disappearing upon abort during turn setup, properly restoring user text and attachments to the input editor.\n- Fixed built-in shell utilities (`grep`, `rg`, `diff`, `find`, `timeout`, `top`, `date`, `head`, `tail`, `stat`, `truncate`, `kill`) across numerous POSIX/GNU/BSD compatibility edge cases and early-pipeline SIGPIPE handling.\n- Fixed Cursor sessions missing standard string-replacement edit tooling after server tool injection.\n- Fixed `hub wait` duplicating frozen rows into native scrollback during viewport overflow.\n- Fixed dark-theme contrast issues on markdown code-fence headers.\n- Fixed prompt guidance and descriptions for Task tools and SSH usage.\n- ACP editor clients that support elicitation forms (Zed) can now use `ask`, so the agent can pose single-choice, multi-select, and free-text questions inline instead of guessing.\n- `/retry` and `/handoff` now work over ACP, so editor clients (Zed) list them and can run them instead of sending the text to the model.\n- Added `qwenTemplateReasoningEffort` to the `models.yml` `compat` schema, so the auto-enabled Qwen 3.8+ template effort dialect (`chat_template_kwargs.reasoning_effort`) can be switched off per provider/model for strict local servers that reject unknown `chat_template_kwargs`.\n- Extensions can provide a normalized `usage` provider through `pi.registerProvider()`. Its reports now flow through AuthStorage caching, history, and usage displays, and the override is removed when the extension provider is unregistered.\n\n## [17.4.0] - 2026-08-20\n\n### Added\n\n- `/cleanse` (and `omp cleanse`) \u2014 run the checker/repair loop in-session, with a live status board of running checkers, repair subagents, and token/cost totals.\n- `omp ps` \u2014 interactive monitor for daemon-supervised background processes.\n- Composer layouts \u2014 `composer.shape` picks the editor frame (rounded box, Claude Code rules, upstream-pi rules, borderless), with live previews in `/settings` and the setup wizard.\n- Context line \u2014 `statusLine.contextLine` gauge (`percentage`, `annotated`, `embedded`) showing context usage and compaction boundaries.\n- Backgroundable Python \u2014 `eval` cells can run async and auto-background like `bash`, with configurable thresholds.\n- Local Claude token counting \u2014 Anthropic-family tokens now count via a native local tokenizer, and every counter (session maintenance, advisor, stats, context tools) uses the active model's own tokenizer.\n- `extendedContext` setting \u2014 pick whether models with premium long-context pricing (272K/1M tiers on Codex-class models) use the extended window or compact early and stay on standard pricing.\n- `/extended-context` \u2014 toggle premium long-context windows without leaving the session.\n- Speculative compaction \u2014 with `compaction.asyncEnabled`, all compaction modes compact in parallel while the session continues, then splice the result in instantly.\n- `tokenizer` property on custom models and `modelOverrides` to pin the tokenizer family for proxy models.\n- `qwenTemplateReasoningEffort` in `models.yml` `compat` to disable the Qwen 3.8+ reasoning-effort template parameter for strict local servers.\n- Click-to-toggle and drag-to-reorder for list-valued editors in `/settings`.\n- `icon.subscription` and `icon.advisor` symbol-theme tokens (Nerd Font, Unicode, ASCII).\n\n### Changed\n\n- Typing anywhere in the /models UI now immediately focuses the model list for instant search and arrow navigation.\n- Revamped the todo HUD \u2014 overall progress renders along the tree-spine connector with smooth completion transitions.\n- Compaction divider now names the maintenance method that fired (`remote-compacted`, `soft-compacted`, `handed-off`, `snap-compacted`) and shows the before \u2192 after context size (e.g. `256K\u219220K`).\n- `/handoff` (and automatic handoff compaction) now compacts in place, replacing the session context instead of forking a new session.\n- Compaction method priorities \u2014 `compaction.methodOrder` takes an ordered preference list (e.g. `[remote, snap]` uses remote compaction where the provider supports it, such as OpenAI, and snap everywhere else), replacing `compaction.strategy`/`compaction.remoteEnabled`.\n- Unified inline overlays and selectors (model picker, settings, `/cleanse`) into one titled rounded-box panel style.\n- Risk badges and warnings on `/settings` rows, starting with External Thinking.\n- Faster CLI Startup\n\n### Fixed\n\n- `/models` keeps `auto` thinking on non-default roles such as `task` instead of changing the active model and displaying the role as `max`.\n- Subagent `yield` structured results no longer get corrupted by lossy argument repairs; prompt guidance improved for weak callers.\n- GitHub `file_read` returns proper image blocks and direct view URLs for image/binary files.\n- Cancelled prompts during pre-stream turn setup restore the text and image attachments to the editor.\n- `top` builtin accepts single-dash macOS flags such as `-pid` and `-stats`.\n- GNU/BSD compat sweep across built-in shell utilities (`timeout`, `diff`, `find`, `date`, `tail`, `head`, `rg`, `stat`, `truncate`, `cksum`, `sleep`, `which`, `nohup`, `kill`).\n\n## [17.3.8] - 2026-08-19\n\n- Fixed unquoted internal URLs in `bash` commands consuming adjacent shell operators into the resolved filesystem path.\n\n### Added\n\n- Added `providers.cacheRetention` setting (`/settings` \u2192 Providers \u2192 Protocol) to control prompt-cache retention per request: `auto` keeps the provider default (Anthropic: 5m entries with idle keep-alive refreshes), `short` forces 5m, `long` restores 1h TTLs where supported and disables the keep-alive refresh loop, `none` disables prompt caching.\n\n### Changed\n\n- The `read` tool now materializes a local text file once per invocation instead of once per consumer. A ranged read of a file within the snapshot cap previously cost four opens and three UTF-8 decodes \u2014 an 8KiB binary sniff, a streaming scan for the rendered window, a whole-file read for bracket context, and another whole-file read to hash the snapshot \u2014 with two of those readers separately normalizing line endings; whole-file reads under the structural summarizer paid a fifth read. Byte counts and truncation boundaries are now measured on the buffered bytes, so they stay exact for content that is not valid UTF-8. Files above the snapshot cap keep streaming, since nothing on that path wants the whole file. Raw reads, which skip the tree-sitter parse that documented the old cost, no longer pay for it.\n- Documented that `bash.patterns` gates the `bash` tool only and does not cover a shell that `eval` can spawn via subprocess, and that closing that path needs a `tools.approval.eval` policy \u2014 noted in `docs/bash-tool-runtime.md`, `docs/approval-mode.md`, and `docs/settings.md` ([#8838](https://github.com/can1357/oh-my-pi/issues/8838)).\n\n### Fixed\n\n- Fixed the `/btw` panel re-committing its frame to native scrollback on every update while the primary turn is still streaming: a live region that pins itself (an anchored HUD/panel such as `/btw`) no longer leaks its scrolled-off rows just because an unpinned transcript seam sits above it in the same frame ([#8793](https://github.com/can1357/oh-my-pi/issues/8793)).\n- Fixed a submitted `/skill:` command staying invisible in the transcript until its awaited preflight (memory recall, `before_agent_start` hooks, auto-thinking classification, pre-prompt compaction) finished, so a slow step such as a Hindsight auto-recall timeout made the command look unaccepted. Idle skill submissions now paint an optimistic row immediately \u2014 like a normal prompt \u2014 and reconcile it in place when the canonical `message_start` lands ([#8895](https://github.com/can1357/oh-my-pi/issues/8895)).\n- Fixed broker-backed MCP OAuth credentials never refreshing, so remote OAuth MCP servers dropped out of `/mcp` once their access token expired under `omp auth-broker serve`. The client threw on the broker-redacted refresh sentinel instead of asking the broker to refresh, and the broker had no `mcp_oauth:*` refresh path (`POST /v1/credential/:id/refresh` answered `Unknown OAuth provider`). The client now routes redacted MCP refreshes through the broker, and the broker refreshes MCP credentials with a generic `refresh_token` grant from the credential's embedded token endpoint and client id \u2014 so the background refresher also keeps MCP tokens live ([#8933](https://github.com/can1357/oh-my-pi/issues/8933)).\n- Fixed `omp commit` split-commit failing with `corrupt binary patch` when a split commit contains a binary file. `parseFileDiffs` split the captured diff on `\"\\ndiff --git \"`, consuming the `\\n` that terminates each block, and `patch.join` stripped trailing newlines \u2014 both dropped the blank line that terminates a `GIT binary patch` block, so the rebuilt patch was rejected by `git apply --binary`. Both trailing and mid-diff binary blocks now survive the parse/rebuild round-trip byte-exact ([#8899](https://github.com/can1357/oh-my-pi/issues/8899)).\n- Fixed `omp update` (and other non-launch subcommands) crashing with `error: Unknown option '--cwd'` when a leading global launch flag preceded the subcommand \u2014 e.g. a shell alias/wrapper that runs `omp --cwd  update`. `resolveCliArgv` hoisted the subcommand to the front but forwarded the launch-only flag into `update`'s strict `node:util.parseArgs` parser, which rejected it. Launch-global flags before a launch-shaped command (`acp`/`launch`) are still forwarded; before any other subcommand they are now stripped as inapplicable ([#8891](https://github.com/can1357/oh-my-pi/issues/8891)).\n- Fixed Claude Code marketplace plugins ignoring the `enabledPlugins` switch in `~/.claude/settings.json` and `.claude/settings(.local).json`: a plugin turned off for a project no longer loads there, and a local-scope install enabled for a project loads even when its recorded `projectPath` is a different directory\n- Fixed revived subagents (warm lifecycle reviver and cold persisted reviver) rebuilding the session without initializing the extension runtime, leaving every runtime action throwing `ExtensionRuntimeNotInitializedError`. An extension with a `tool_call` handler that touched a runtime action (e.g. `appendEntry`) then tripped the fail-closed gate in `emitToolCall` and blocked every tool \u2014 including the hidden `yield` \u2014 so the revived agent could neither finish nor exit and looped until killed. Both revivers now call the shared `initializeExtensions` helper, restoring runtime actions, `onError`, and the `session_start` event ([#8824](https://github.com/can1357/oh-my-pi/issues/8824)).\n- Fixed `omp commit` split-commit crashing with a misleading `No diff found for ` when a staged binary (or any payload) pushed `git diff --cached --binary` past the 8 MiB subprocess output cap. The capture is truncated silently, so files sorting after the binary vanished from the parsed diff; the split flow now requests a complete diff and fails fast naming the real cause instead ([#8897](https://github.com/can1357/oh-my-pi/issues/8897)).\n- Fixed a mid-run compaction being misread as a phantom overflow: after a compaction rebased the in-flight context snapshot, `getContextBreakdown` used message position (`anchorIndex >= cutoffCount`) as a freshness proxy, so an in-flight provider response whose request predated the compaction out-ranked the rebased estimate and reported the pre-compaction token count (~2.6x the real one). This tripped the \"Compaction freed too little context to make progress\" guard and drove the frame-rescue path on a byte-identical `tokensBefore`. Assistant context snapshots now carry a monotonic compaction epoch, and a post-cutoff anchor whose epoch predates the last compaction is no longer trusted over the rebased estimate ([#8887](https://github.com/can1357/oh-my-pi/issues/8887)).\n- Fixed `after_provider_response` extension handlers receiving the primary session model in `ctx.model` and `ctx.models.current()` for cross-provider side requests. `ExtensionRunner.emitAfterProviderResponse` accepted the response model but discarded it, so a handler revoking a credential on an HTTP 402 could target the wrong provider. It now threads the response model into the context, matching `emitBeforeProviderRequest` ([#8955](https://github.com/can1357/oh-my-pi/issues/8955)).\n- Fixed the TinyFish web search provider ignoring the `lang:`/`language:` query directive, so every request fell back to the API's US/English geolocation. `parsed.lang` now maps onto TinyFish's `location`/`language` parameters (e.g. `lang:it-it` \u2192 `location=IT&language=it`), matching the DuckDuckGo, Perplexity, and SearXNG providers ([#8913](https://github.com/can1357/oh-my-pi/issues/8913)).\n- Fixed the `/model` Roles panel silently dropping roles and model-keyed fallback chains that fell past the visible panel height: the list had no scroll window, so entries below the cutoff were unreachable with no indication anything was missing. The panel now windows around the cursor like the provider list and shows an `\u2191/\u2193 N more` hint when rows are clipped ([#8817](https://github.com/can1357/oh-my-pi/issues/8817)).\n- Fixed task and eval subagents discovering newly added agent definitions while resolving their role aliases from stale startup settings. Subagent preflight now atomically reloads persisted settings before agent discovery while preserving live runtime overrides.\n- Fixed images returned by tools mounted under `xd://` rendering only as file links instead of inline terminal graphics.\n- Resume Cursor idle-stall turns after completed MCP/todo tool results. The watchdog already closes the Connect stream, so unmarked blocks no longer need the `exec-resolved` marker to continue.\n- Fixed the Web Search Provider Order settings summary showing providers excluded from web search ([#8884](https://github.com/can1357/oh-my-pi/issues/8884)).\n- Fixed subagents aborting when external thinking exposes `think` as the required prelude before their remaining tools become callable ([#8909](https://github.com/can1357/oh-my-pi/pull/8909) by [@olegpulatov](https://github.com/olegpulatov)).\n- Fixed session-title generation ignoring user `/skill:` invocations, so titles now see the skill name and args instead of only later assistant text.\n- Fixed destructive `rm` escaping the critical-pattern approval check when anything separates the flags from the target, so `rm -rf -- /`, `rm --recursive --force /` and `rm -rf --no-preserve-root /` are now classified critical like `rm -rf /`. `--no-preserve-root` is treated as critical wherever it appears, since it is what defeats coreutils' own refusal to recurse on `/`.\n- Fixed thinking-loop aborts (`AIError.Flag.ThinkingLoop`) walking `retry.fallbackChains` and switching to another model family on attempt 1, so a healthy planning turn on Grok 4.6 (SuperGrok / Cursor OAuth) no longer gets replaced by whatever the chain lists next. The loop guard now re-samples the same model with its `thinking-loop-redirect` notice, and no longer parks the model selector on a fallback cooldown. ([#8760](https://github.com/can1357/oh-my-pi/issues/8760))\n- Fixed the clipboard image-paste keybind attaching Finder's generated file icon instead of the copied image on macOS. Current Finder `Cmd+C` pasteboards advertise both a `public.file-url` and a generated 1024x1024 icon bitmap, so `arboard::get_image()` succeeded with the icon and `InputController.handleImagePaste` attached it before the file-URL branch was ever reached. The handler now probes `readMacFileUrlsFromClipboard()` before the bitmap representation, so an image file URL wins over the co-advertised icon; pure bitmap pasteboards (screenshots, browser copies) and non-image file URLs still fall through to the image/text paths ([#8769](https://github.com/can1357/oh-my-pi/issues/8769)).\n- Fixed the Home Manager module (`programs.omp.settings`) breaking every launch on macOS with `Failed to acquire native file lock \u2026 Permission denied (os error 13)`. The declared config is now copied into `~/.omp/agent/config.yml` as a writable file via `home.activation` instead of a read-only `/nix/store` symlink, so OMP can acquire its config lock and persist runtime changes; `home-manager switch` still reapplies the declared settings ([#8775](https://github.com/can1357/oh-my-pi/issues/8775)).\n- Fixed OpenCode MCP servers 401ing when config used OpenCode's `{env:VAR}`/`{file:path}` substitution (e.g. `Bearer {env:MCP_KEY}` headers); the OpenCode loader now expands those tokens the way OpenCode does instead of only `${VAR}` ([#8778](https://github.com/can1357/oh-my-pi/issues/8778)).\n- Fixed `omp update` leaking Bun's raw `fetch()` error (\"pass `verbose: true` in the second argument to fetch()\") when a proxy environment variable (`HTTPS_PROXY`, `ALL_PROXY`, \u2026) uses an unsupported scheme such as SOCKS; the update check now reports an actionable message naming the offending variable and the http/https proxy requirement ([#8784](https://github.com/can1357/oh-my-pi/issues/8784)).\n- Fixed worker subprocesses (memory embeddings, tiny-model titles, TTS/STT, JS eval, browser relay, LSP mux, daemon broker) running with their cwd pinned to the CLI install directory. They share the agent's foreground process group, and terminal cwd heuristics such as kitty's `new_tab_with_cwd` pick the newest process in that group, so new terminal tabs opened in `~/.bun/install/global/node_modules/@oh-my-pi/pi-coding-agent/dist` while any worker was alive. Workers now spawn with the absolute host entry and inherit the agent's cwd.\n- Preserved MCP `ImageContent` tool-result blocks so vision-capable models and the TUI can inspect returned images instead of receiving only a text placeholder ([#8687](https://github.com/can1357/oh-my-pi/issues/8687)).\n- Fixed a whole-file `read` of a file with a UTF-8 BOM minting a hashline tag hashed from BOM-bearing text. Because the patcher's live read strips the BOM, the next edit to that file only applied through stale-hash recovery and reported that the file had changed externally when it had not.\n- Extension bare imports of workspace members now resolve inside installed git-dependency monorepo plugins (the walk recognizes `workspaces` roots; installed node_modules copies still shadow members)\n- Fixed `omp completions ` hanging after writing shell completion scripts to stdout by invoking `postmortem.quit(0)` upon completion. Prevents lingering event loop handles (such as background timers or sockets loaded when inspecting command metadata) from pinning the process and blocking tools like `chezmoi`.\n- Fixed `omp --smoke-test` recursively deleting unrelated directories in `os.tmpdir()` (tmux/ssh sockets, editor state, build trees). The smoke broker now keeps its runtime dir under a private parent, and the dead-scope reclaim refuses any root that is not the `daemons` container and only prunes entries named like a 16-hex daemon scope key ([#8721](https://github.com/can1357/oh-my-pi/issues/8721)).\n- Fixed high CPU during multi-subagent / workflowz / orchestrate sessions: each live tool block (streaming args, a running partial tool, or a `task` subagent) armed its own 80ms spinner `setInterval` driving `requestComponentRender`, so N concurrent live blocks created N unsynchronized repaint timers that kept the render scheduler awake near-continuously. The per-block timers are now consolidated into a single shared spinner ticker that repaints every live block in one coalesced frame per glyph step, independent of block count ([#8731](https://github.com/can1357/oh-my-pi/issues/8731)).\n- Fixed `omp update` writing to the PATH launcher instead of the running binary on binary-only releases (major bumps or `omp.dist: \"binary\"`): a foreign symlink \u2014 e.g. an admin symlink into a shared install \u2014 now resolves to its real binary in every distribution channel, avoiding an `EACCES` on a root-owned link directory or a split-brain copy that shadows the shared install. Package-manager launchers keep their deliberate in-place takeover. ([#8732](https://github.com/can1357/oh-my-pi/issues/8732))\n- Added `.css` to the built-in Biome server `fileTypes` so CSS files route through Biome's linter/asserter by default instead of requiring a full per-project `fileTypes` override. ([#8741](https://github.com/can1357/oh-my-pi/pull/8741))\n- Fixed memory extraction sending its instructions, few-shot examples, and the user's message as a single user turn, which caused small local models to echo the examples instead of extracting facts; instructions now travel as a system turn and the raw text as the user turn\n- Fixed local title generation stopping on a stop string that appeared in the prompt instead of the generated tokens\n- Fixed the Subagents HUD role display and restored generated task labels by keeping spawn handles separate from UI descriptions.\n- Fixed `models.yml` custom-model providers declaring `auth: oauth` being rejected by validation with \"apiKey is required\", which forced a dummy `apiKey` that then shadowed the broker's OAuth tokens ([#8937](https://github.com/can1357/oh-my-pi/pull/8937) by [@usr-bin-roygbiv](https://github.com/usr-bin-roygbiv)).\n- Provider-qualified model selectors (e.g. `anthropic/claude-opus-5`) now fail closed when the named provider is unavailable instead of silently re-binding to OpenRouter's same-named flat id and billing the aggregator ([#8832](https://github.com/can1357/oh-my-pi/issues/8832)).\n- Fixed PlanYolo plan approval dropping all MCP tools: the post-handoff tool restore now accounts for MCP discovery that completed while planning instead of restoring a pre-discovery snapshot.\n- Fixed parallel `web_search` calls hanging forever past the 60s timeout when the shared headless-browser daemon or page died mid-setup; browser fallback setup and teardown are now abort-protected ([#8865](https://github.com/can1357/oh-my-pi/issues/8865)).\n- Fixed extension-package `.mcp.json` `${VAR}` env placeholders (stdio env/command/args/cwd, HTTP url/headers/oauth) reaching MCP servers unexpanded.\n- Advisor blocker advisories raised inside the post-interrupt immune window now wake a new turn instead of parking as asides until the next user prompt.\n- The exit banner only advertises `omp --resume ` when the session was actually written to disk, so the printed command no longer fails for sessions that ended before persistence ([#8860](https://github.com/can1357/oh-my-pi/issues/8860)).\n- Fixed terminals that deliver Shift+Enter as a bare LF (or the legacy CSI `13;2~` form) getting a plain switch instead of summarize-and-switch in the `/tree` selector ([#8821](https://github.com/can1357/oh-my-pi/issues/8821)).\n- Fixed OMP panicking at startup when the host environment contains a non-UTF-8 variable value; such entries are now skipped when copying the host environment into the shell ([#8925](https://github.com/can1357/oh-my-pi/issues/8925)).\n- Fixed `/mcp reauth` refusing to run the OAuth flow for HTTP MCP servers that allow unauthenticated `initialize` but require auth for `tools/call`; endpoint discovery now runs against the server URL before giving up ([#8922](https://github.com/can1357/oh-my-pi/issues/8922)).\n\n## [17.3.7] - 2026-08-17\n\n### Changed\n\n- Send the `omp/` User-Agent on xAI chat (`xai` and `xai-oauth`) unless the request already set its own ([#8840](https://github.com/can1357/oh-my-pi/pull/8840) by [@Jaaneek](https://github.com/Jaaneek)).\n\n## [17.3.6] - 2026-08-17\n\n### Added\n\n- Added `ExtensionAPI.registerFileWriteFallback(handler)` and `ExtensionAPI.registerFileDeleteFallback(handler)`, letting an extension supply a fallback writer or deleter that is consulted when a native `write`, `edit`, or `apply_patch` byte-write or unlink is denied with a permission error (`EPERM`/`EACCES`/`EROFS`) \u2014 for hosts that embed the agent inside a sandbox that denies direct filesystem access but exposes a privileged channel. The brokered path is symlink-resolved so a handler's allowlist sees the real destination, a destination that cannot be resolved is not brokered at all, and `req.sessionId` names the session that issued the mutation so a handler sharing the process-wide registry can enforce policy per session. See [`docs/extensions.md`](../../docs/extensions.md).\n\n### Changed\n\n- Updated the default model for XAI_API_KEY (xai) and SuperGrok OAuth (xai-oauth) to grok-4.6. Automatic model selection continues to prefer paid xai/grok-4.6 when only XAI_API_KEY is set, with xai-oauth/grok-4.6 still available explicitly.\n\n### Fixed\n\n- Fixed `omp stats` and `/stats` dashboards being unreachable from container hosts by accepting an explicit `--host` bind address while preserving the `127.0.0.1` default.\n\n## [17.3.5] - 2026-08-16\n\n### Added\n\n- Added Extensions tab group to settings schema\n\n### Changed\n\n- Routed paid xAI models (XAI_API_KEY / xai/\u2026) through the Responses API used by SuperGrok OAuth instead of Chat Completions, including reliable replay of encrypted reasoning content on follow-up turns.\n- Updated the default model for XAI_API_KEY (xai) to grok-4.5, and the default SuperGrok OAuth (xai-oauth) model to grok-4.5. Automatic model selection continues to prefer paid xai/grok-4.5 when only XAI_API_KEY is set, with xai-oauth/grok-4.5 still available explicitly.\n- Stopped sending presence/frequency penalties and stop sequences to xAI reasoning models such as grok-4.5, which reject them.\n\n### Fixed\n\n- Fixed `hub` job and wait lists hiding stale running subagent registrations that have no turn in flight, ensuring they remain visible so operators can cancel them\n- Fixed external thinking scratchpads running alongside native reasoning on xAI Grok 4 and other reasoning-only Responses models that reject `reasoning.effort`\n- Fixed llama.cpp model discovery producing a baseUrl without the /v1 prefix for non-Qwen models, causing 404 errors on OpenAI-compatible endpoints.\n- Fixed prompt caching on open-weight providers (DeepSeek, Qwen, GLM, \u2026) so tool schemas stay cached across directory changes and midnight rollovers.\n- Fixed omp --fork omitting the source session's artifact directory, so CLI-created forks now preserve artifact:// references like interactive /fork.\n- Fixed long ask option labels being hard-truncated at the terminal width; labels now wrap onto indented continuation lines.\n- Fixed toggling display.showTokenUsage from /settings leaving existing token-usage rows stale until the transcript was rebuilt.\n- Fixed mid-run auto-compaction blocking the live loop while waiting on extension handlers, which could hang after a snapcompact or context-full pass.\n- Reduced peak memory for persisted subagent revival probes by streaming large file-backed session journals instead of loading them fully.\n- Improved responsiveness of streaming edit previews for large diffs by rendering only the visible tail.\n- Fixed repeated /btw panels committing transient frames to native scrollback and replaying conversation history after dismissal.\n- Clarified that closing browser tool sessions releases managed handles without closing pages in spawned, CDP-connected, or relay browsers.\n- Fixed interrupted vibe_wait calls being reported as elapsed timeout windows.\n- Improved checkpoint/rewind prompt rendering to stay accurate after a rewind and be more concise.\n- Fixed Cursor turns dying with HTTP/2 stream errors (NGHTTP2_INTERNAL_ERROR / NGHTTP2_REFUSED_STREAM) after tool calls already had results, instead of leaving the agent idle until the user typed \"continue\".\n- Fixed mixed-case plugin tool names being lowercased during tool-set refresh, which unmounted them from xd:// whenever MCP tools connected.\n- Fixed Exa MCP servers being unmounted when their config explicitly requests tools the native Exa integration does not provide, breaking /mcp reconnect exa.\n- Fixed Claude Code custom tool discovery attempting to import non-module files from .claude/tools.\n- Fixed Agent Hub parking a mid-spawn child session so subsequent task calls failed with an ownership error and the row could never be revived.\n- Fixed the welcome banner displaying a stale model name when the session's active model changes after startup (e.g. after a delayed config load or an explicit /model switch).\n- Fixed Nix standalone binaries retaining Bun's build-time package in their runtime closure.\n- Fixed birch user/custom message card contrast on dark terminals, where chat bubbles could render light-on-light.\n- Fixed hidden tool snapshots preventing long streamed assistant responses from entering terminal scrollback.\n- Prevented omp models from loading ambient hook factories while preserving extension-contributed providers.\n- Fixed the ask dialog's multi-select mode dead-ending on Enter; Space now toggles options and Enter submits the current selection.\n- Fixed workspace diagnostics reporting a clean workspace when its checker crashed without producing output.\n- Fixed manual /compact failing outright when a summarization request hit a transient provider overload.\n- Fixed transient Anthropic failures (overloaded_error, rate_limit_error, 429/500/502/503/529) aborting or silently degrading side-effect-free background LLM calls such as session title generation, TTS speech enhancement, commit-message generation, thinking/stop classifiers, memory extraction/consolidation, and commit analysis/summary/changelog passes; these now retry with backoff honoring retry-after instead of failing or returning an indistinguishable empty result.\n- Fixed the shared headless browser daemon launching from the macOS system Google Chrome bundle, which could cause macOS to route the user's link clicks to the automation daemon and silently swallow them; the daemon now prefers an isolated Chrome for Testing binary on macOS.\n- Reclaimed abandoned daemon runtime directories under ~/.omp/run/daemons/, preventing unbounded growth of leftover Chromium profiles and broker state.\n- Kept the welcome screen's Tips, LSP Servers, and Recent sessions visible when a long model name still leaves enough terminal width for both columns.\n- Fixed focused shimmer animation frames (ultrathink, orchestrate, workflowz) repainting the full TUI too frequently, causing high CPU usage while composing prompts on WSL2.\n- Fixed the /debug report bundle including unrelated historic sessions, leaking other sessions' files and bloating archives.\n- Fixed adopted keep-alive agents remaining stuck in a running state in the registry after deferred turn settlement, and prevented stale refs from sustaining bare hub wait calls indefinitely.\n- Fixed home-relative marketplace catalog paths not being expanded before cache access, preventing updates from writing into a literal ~ directory.\n- Fixed broker-owned headless Chromium opening and retaining an unowned blank foreground window on Windows.\n- Fixed the auto thinking classifier failing every turn on Anthropic models served through LiteLLM/Vertex due to a thinking-budget mismatch.\n- Fixed always-ask approval prompts bypassing edit preview readiness when a built-in tool executes under its wire-level alias, such as edit running as apply_patch.\n- Fixed lsp reload crashing non-rust-analyzer language servers by sending them a rust-analyzer-specific request; that request is now gated to rust-analyzer only.\n- Fixed browser open failing with \"Shared browser daemon unavailable\" when HTTP_PROXY/HTTPS_PROXY is set, because liveness probes were incorrectly routed through the proxy.\n- Fixed defaultThinkingLevel: auto skipping classification for user-invoked /skill: turns, leaving the effort stuck on pending auto.\n- Fixed custom-tool directory discovery recursing into subtrees despite a non-recursive default, which could crash startup when scanning large dependency directories such as Python venvs.\n- Repaired torn session JSONL appends after disk-write failures, rewrote malformed resumed files before their next append, retried transient persistence failures, and surfaced failures in the TUI.\n- Prevented Anthropic model fallback from replaying model-bound thinking blocks across models, and surfaced immutable-thinking errors without retrying the unchanged invalid turn.\n- Fixed empty-stop failure messages always suggesting a context problem even when the provider billed output tokens; the message now reports the billed token count and points at a provider-side filter/translation issue when appropriate.\n- Fixed a parked, session-less agent-registry entry with no reviver permanently poisoning its agent id, preventing fresh subagent spawns from reusing that id.\n- Made extension tool-call timeouts configurable and paused them during user dialogs.\n- Fixed /vibe cancellation leaving an in-flight model turn unaware that Vibe mode and its tools were removed.\n- Fixed empty local-model stops lingering on the persisted active branch after retries, preventing them from resurfacing after reload or a mid-retry process kill.\n- Fixed the Biome linter client silently dropping every diagnostic due to an outdated JSON output schema; it now supports Biome 2.x's diagnostic format.\n- Fixed `hub jobs` and empty `hub wait` snapshots hiding running subagents that have no live turn, which removed the only way to discover and `hub cancel` a stale registration; such agents are listed again and flagged as having no turn in flight.\n- Fixed external thinking being offered on xAI reasoning-only Responses models (grok-4 family) that reject `reasoning.effort`, where the private scratchpad ran alongside native reasoning instead of replacing it.\n- Fixed the extension tool-call handler timeout rendering outside a titled section in `/settings` by registering its Extensions group on the Tools tab.\n\n## [17.3.4] - 2026-08-14\n\n### Changed\n\n- Replaced the MuPDF-WASM PDF document backend with `pdf-inspector` through `@oh-my-pi/pi-natives`, preserving cached text conversion and PDF line selectors while reporting pages that need OCR.\n- Restored `read :` and `read :.png` page rendering by automatically capturing PDF pages through the headless Chromium browser tool.\n\n### Fixed\n\n- Fixed Streamable HTTP MCP sessions being invalidated by opening the optional GET SSE stream before sending `notifications/initialized`, which prevented Figma Dev Mode MCP from connecting ([#8514](https://github.com/can1357/oh-my-pi/issues/8514)).\n- Fixed the `/hotkeys` table describing Ctrl+D (`app.exit`) as \"Exit (when editor is empty)\" when it actually exits unconditionally and saves the current prompt as a resumable draft ([#8530](https://github.com/can1357/oh-my-pi/issues/8530)).\n- Fixed Ctrl+G external editors failing to launch on Windows because Bun re-quoted the embedded `cmd.exe /c` command line ([#8544](https://github.com/can1357/oh-my-pi/issues/8544)).\n\n## [17.3.3] - 2026-08-14\n\n### Fixed\n\n- Automatically continued Gemini turns that stopped after thinking without final output, using a bounded final-answer reminder instead of exhausting generic retries.\n- Retried Gemini `MALFORMED_FUNCTION_CALL` failures when every emitted tool call was proven unexecuted, while preserving real tool-result and visible-output replay guards.\n- Kept current terminal retry errors in one pinned banner with attempt context while surfacing local continuation failures instead of stale provider errors.\n\n## [17.3.2] - 2026-08-13\n\n### Fixed\n\n- Fixed the parent TUI stalling after a subagent submits its result until terminal focus or resize wakes the event loop ([#8462](https://github.com/can1357/oh-my-pi/issues/8462)).\n- Fixed `omp update` misclassifying foreign npm/bun bin aliases while preserving package-manager ownership for globally linked checkouts ([#8468](https://github.com/can1357/oh-my-pi/issues/8468)).\n- Fixed `read` hashline headers collapsing nested in-workspace paths to the bare basename, which let a same-basename file at the session cwd capture a verbatim follow-up `edit` and deterministically reject it with `hash is not from this session`. Headers now retain the workspace-relative path (e.g. `[src/settings.json#0063]`) ([#8482](https://github.com/can1357/oh-my-pi/issues/8482)).\n\n## [17.3.1] - 2026-08-13\n\n### Fixed\n\n- Fixed Claude Code user discovery ignoring CLAUDE_CONFIG_DIR for configuration, plugins, MCP servers, and imported sessions.\n- Fixed the status-line git branch display freezing after switching branches.\n- Fixed Pi extension contexts omitting the runtime mode, which caused TUI guards to silently disable extension UI.\n- Fixed extension-registered tool names being rejected by the --tools flag before extension discovery, which prevented least-privilege sessions from allowlisting plugin tools.\n- Fixed omp plugin install failing with cloning errors for legacy Pi extensions whose tool schemas use legacy-typebox builders.\n- Fixed omp update aborting with chmod ENOENT when concurrent update runs overlapped by using unique download temporary paths.\n- Fixed the browser tool executable probe launching the user's installed GUI Chromium on Windows: the `--version` version probe from ecb22957 was Linux-scoped but ran for every platform candidate, so on Windows it could hand off to a running `chrome.exe`, open a normal browser window, then reject the candidate and fall back to cached Chrome for Testing. The probe is now confined to Linux ([#8445](https://github.com/can1357/oh-my-pi/issues/8445)).\n\n## [17.3.0] - 2026-08-13\n\n### Breaking Changes\n\n- Removed the global `advisor.subagents` setting. Subagent advisors are now configured per agent via frontmatter or `task.agentAdvisor`. Existing configurations of `advisor.subagents: true` will automatically migrate to `task.agentAdvisor: { task: \"on\" }`.\n\n### Added\n\n- Added Astral `ty` as a built-in fallback Python LSP server (`ty server`), ordered behind `pyright`, `basedpyright`, and `pylsp`.\n- Added first-party Nix support, including reproducible source builds for Linux and macOS, a pinned development shell, NixOS and Home Manager modules, and offline Bun dependency support.\n- Added support for per-agent advisors configured via the `advisor` frontmatter field or the `task.agentAdvisor` settings, allowing different agents to be advised by different models.\n- Redesigned the `/agents` interface as a fullscreen hub featuring a scope sidebar, type-to-filter search, a pinned detail pane, mouse support, and interactive property chips for configuring agent settings.\n- Prepared for the upcoming npm package rename by updating `omp update` and startup version checks to follow the `omp.rename` pointer in the published manifest.\n\n### Changed\n\n- Updated `/usage`, `omp usage`, and the status line to display authoritative OpenCode Go quota usage directly from the official endpoint, replacing estimated costs with actual usage across three time windows (5h, 7d, and monthly).\n- Documented the source-available local protocol relay and clarified that production collaboration relay binaries are not currently published.\n- Enabled bounded Anthropic prompt-cache refreshes for the main agent loop while isolating advisor and side-channel requests from the shared refresh timer.\n\n### Fixed\n\n- Fixed multiple Language Server Protocol (LSP) issues, including concurrent sessions sharing backend overlays, stale document overlays after workspace edits, incorrect transactional edit advertisements, unhandled snippet placeholders in rust-analyzer, and failing to restore overwritten targets during failed file renames.\n- Fixed LSP `diagnostics` incorrectly reporting success when all language servers failed.\n- Fixed Hindsight memory scoping splitting repositories across multiple scopes on case-sensitive filesystems by lowercasing the project label.\n- Fixed the CLI crashing at startup with a raw `AuthBrokerError` when the configured auth broker is unreachable, replacing it with an actionable error message.\n- Fixed various resource and process leaks, including idle launch brokers staying alive indefinitely, stale MCP connections leaving child processes open, and undrained stdout in DAP `runInTerminal` requests.\n- Fixed custom STB-backed vision providers failing to decode WebP images by automatically detecting image formats from bytes and normalizing WebP blocks.\n- Fixed command-backed provider API keys (`!command`) staying pinned to cached values after receiving an HTTP 401 error.\n- Fixed the `/agents` Control Center failing to open when model overrides are configured as YAML arrays.\n- Fixed session-title generation regressions by restoring plain-sentence phrasing and name-fidelity instructions.\n- Fixed agent-facing prompts and system instructions mentioning tools that are absent from the current session catalog.\n- Fixed manual `/shake` discarding all tool results; it now retains a small recent tail of results to preserve active working context.\n- Fixed `omp install` failing validation for extensions importing legacy `isToolResult` event guards.\n- Fixed profile aliases generated by standalone binaries invoking Bun's embedded virtual script instead of the installed `omp` command.\n- Fixed `/skill:` tokens in `/plan` or `/vibe` inline prompts being treated as literal text instead of executing the skill.\n- Fixed long streaming `write` previews stalling the TUI by optimizing file scanning and splitting.\n- Fixed the Windows console disappearing when running commands like `/stats`.\n- Fixed retry-fallback selection switching to a fallback model with a context window too small to hold the current session context.\n- Fixed OpenCode discovery ignoring `opencode.jsonc` files and rejecting comments in `opencode.json`.\n- Fixed WSL2 startup hanging forever when the Windows interop pipe is wedged: the WSL host-home discovery probes (`cmd.exe`, `wslpath`) now run under a 500ms hard timeout and fall back to the Linux `$HOME`/`~/.omp` candidates ([#8402](https://github.com/can1357/oh-my-pi/issues/8402)).\n\n## [17.2.15] - 2026-08-12\n\n### Added\n\n- Added `--external-thinking` CLI flag to force external thinking tool activation.\n- Added `omp compress` command, which uses an isolated, two-tool agent loop to rewrite single or multiple text files (supporting glob patterns and concurrent processing) into dense prompt registers.\n- Expanded tool discovery in `omp cleanse` to support `staticcheck` and `golangci-lint` (Go); `mypy`, `pylint`, `flake8`, `ty`, and `basedpyright` (Python); `oxlint`, `deno lint`, `stylelint`, and `vue-tsc` (JS/TS); and `actionlint` (GitHub Workflows).\n- Added support for natural language requests in `omp cleanse \"\"`, which launches a discovery subagent to automatically inspect the project, determine the correct commands, and map outputs.\n- Added an interactive picker to `omp cleanse` when run without arguments on a TTY, allowing users to run all checkers, select a specific checker, or describe what to fix.\n\n### Changed\n\n- Restricted the `think` tool to GPT, Claude, and Gemini transports that support native reasoning replacement.\n- Increased the default subagent cap for `omp cleanse` from 8 to 32.\n\n### Fixed\n\n- Fixed a hang in headless `omp -p` runs when `plan.defaultOnStartup: true` is enabled by disabling the startup default in print mode.\n- Fixed `display.hideToolActivity` failing to hide certain activity blocks, such as reminders, diagnostics, and completions.\n- Fixed several issues in the MCP Streamable HTTP transport, including updating the negotiated protocol version to `2025-11-25`, resolving connection drops and SSE resumption gaps, and preventing double-execution of tools during auth refreshes.\n- Fixed `/handoff` losing local artifacts (plans, scratch files, research notes) by copying them across the handoff session boundary.\n- Replaced libarchive-based tar parsing with a hardened, in-process tar reader to prevent crashes and safely handle complex archive structures, symlinks, and sparse metadata.\n- Fixed `Ctrl+O` tool-output expansion failing to reach launch-completion messages wrapped in the hidden tool activity container.\n\n## [17.2.14] - 2026-08-11\n\n### Added\n\n- Added `externalThinking` setting for private scratchpad reasoning via the new `think` tool\n\n## [17.2.13] - 2026-08-11\n\n### Added\n\n- Added `searxng.safesearch` setting option for SearXNG searches\n- `omp update` now honors an `omp.dist` distribution field published in the release's npm manifest and treats major-version bumps without one as binary-only: bun/npm-managed installs are migrated to the standalone GitHub release binary in place instead of running a package-manager install that a non-npm release (e.g. a runtime change) would break. Windows script-shim installs (npm's `omp.cmd`/`omp.ps1`) are taken over seamlessly by installing `omp.exe` beside the shims and retiring them.\n- Added support for Cloudflare AI Gateway routing for Gemini search\n- Added support for Exa MCP search provider\n- Added domain inclusion/exclusion filtering and URL deduplication for TinyFish search\n- Fixed `/vibe` mode losing the pre-vibe toolset when a session already in vibe mode switches into another session that is also in vibe mode, which left `bash`, `edit`, `write`, `grep`, `glob`, `task`, and `hub` silently unavailable after exiting the mode; the pre-vibe toolset is now recorded on the `mode_change` entry and restored from there.\n- Preserved extension-filtered pasted image payloads and source links when `/goal`, `/plan`, or `/vibe` submits the composer draft.\n- Fixed Agent Hub lineage registration timestamps displaying in UTC instead of the user's local timezone.\n- Fixed Python/Julia/Ruby eval kernels failing to start after their staged runner script was cleared mid-session (e.g. a macOS tmpdir sweep): the memoized runner path is now re-validated so a long-lived process self-heals instead of only recovering on restart ([#8140](https://github.com/can1357/oh-my-pi/issues/8140)).\n- Fixed session resume fully reading and parsing the journal twice by reusing the entries already loaded by `SessionManager.open()` ([#8117](https://github.com/can1357/oh-my-pi/issues/8117)).\n- Fixed RPC `message_end` frames being serialized more than once before output while preserving v1 and v2 wire bytes ([#8118](https://github.com/can1357/oh-my-pi/issues/8118)).\n- Fixed message conversion caching strongly retaining the last session transcript and converted output after session disposal ([#8119](https://github.com/can1357/oh-my-pi/issues/8119)).\n- Fixed timed-out LSP requests continuing to consume server CPU and block queued requests by sending `$/cancelRequest` ([#8116](https://github.com/can1357/oh-my-pi/issues/8116)).\n- Fixed `shutdownAll()` leaving the configured LSP idle checker alive and preventing short-lived SDK hosts from exiting ([#8115](https://github.com/can1357/oh-my-pi/issues/8115)).\n- Fixed terminal Mermaid borders and junctions using low-contrast UI chrome colors instead of the active theme's readable content color.\n- Fixed Cursor provider sessions flooding bash/grep validation errors (`cwd`/`case`/`skip` \"was undefined\") when Cursor omitted optional exec-frame fields; the exec bridge now omits unset optional kwargs before tool execution and transcript synthesis.\n- Added structured reset-reason logging to advisor context re-primes (issue #7226): every history-rewrite trigger (compact, auto-compaction, compaction-rescue, shake, drop-images, prune-tool-outputs, prune-stale-tool-results, conversation-boundary, context-maintenance) now emits an `advisor context reset` debug event with its reason, so full-transcript replays can be attributed to a concrete path.\n- Added `quarantine-recovery` and `quarantine-retry-exhausted` reset reasons to advisor context-reset debug logs, so advisor full re-primes after quarantined output remain attributable without changing quarantine retry semantics (issue #7226).\n\n### Changed\n\n- Standardized first-party outbound User-Agent headers on `omp/` via the shared `USER_AGENT` utility.\n\n### Fixed\n\n- Fixed `/usage`, `/advisor status`, and every other panel command answering only after the agent stopped working. Since `17.0.1` their output was queued until the turn settled (to stop mid-turn transcript mounts duplicating rows in native scrollback, issues #4806/#6767), and the deferral was silent, so on a long turn the command was indistinguishable from a dead one. The panel now renders immediately above the editor in an anchored container that is cleared and rebuilt in place, never entering the transcript, and the full output still lands in the transcript at the next settle. The preview is capped to 40% of the viewport (minimum 6 rows) so a tall report cannot push the prompt off screen.\n- Fixed the todo panel showing no progress while the agent worked through a plan: every sub-todo read as unchecked no matter how far along the run was. Three causes, all in the collapsed (default) view \u2014 the walking viewport dropped *every* closed row, so a completion only ever removed a line and the card's strike-reveal animation ran against a row nobody rendered; the phase the agent was actually in was the one phase header rendered without a `done/total` count; and the 60s todo auto-clear deleted closed tasks from an unfinished plan, resetting the phase counter to `0/n` and renumbering the stages until the next `todo` call restored the real snapshot. The viewport now keeps the newest closed task as a checked lead row (additive to the open-task cap), every phase header carries its progress, counts include abandoned tasks, and auto-clear only fires once the whole list is settled.\n- Status-line `usage` now renders monthly Cursor quotas (`mo N%`) in addition to the existing `5h` / `7d` windows ([#7998](https://github.com/can1357/oh-my-pi/pull/7998) by [@dnth](https://github.com/dnth)).\n- Restored the `ctx.ui.custom()` overlay API that regressed after v0.45.6: `overlayOptions` (anchor/width/maxHeight/margin positioning and sizing) is now forwarded to `showOverlay` instead of a hardcoded full-cover geometry, `onHandle` receives the resulting `OverlayHandle`, and `OverlayHandle`/`OverlayOptions` are exported from the extension API types again.\n- Fixed a content refusal that arrives after the model already emitted a tool call ending the turn outright instead of consulting the model fallback chain. When the refused turn produced nothing visible and every emitted tool call provably never executed (each paired with a synthetic `executed: false` result), the turn is now retryable and the configured `retry.fallbackChains` entry gets its chance, matching how a refusal with no tool calls already behaves.\n- Fixed proxy discovery preferring the bundled catalog name over the proxy-reported name, so `omp models refresh` now updates stale display names (e.g. a proxy serving `longcat-2.0` as `\"LongCat\"` no longer shows the raw id).\n- Fixed the compiled binary build on Windows: `Bun.Glob.scan` yields backslash-separated paths, which the legacy Pi virtual module used verbatim for export keys and generated identifiers, producing invalid JavaScript.\n- Fixed Ctrl+O (`app.tools.expand`) not expanding truncated tool output while a tool-approval prompt or other selection dialog held keyboard focus, by promoting the shortcut to a global input listener that fires regardless of focus (it still defers to fullscreen overlays and the tree selector's own Ctrl+O filter cycle) ([#7837](https://github.com/can1357/oh-my-pi/issues/7837)).\n- Fixed `omp commit` printing a wall of bundled source when a `pre-commit`/`commit-msg` hook refuses a commit: hook failures are now reported with the hook's own message, split plans report how far they got, and the command exits non-zero cleanly ([#7834](https://github.com/can1357/oh-my-pi/issues/7834)).\n- Fixed `omp commit --push` exiting 0 without pushing when the working tree is already clean; it now pushes the existing commits (or fails non-zero if the push is refused) ([#7834](https://github.com/can1357/oh-my-pi/issues/7834)).\n- Subagents spawned through a model-role alias now inherit that role's `retry.fallbackChains` entry instead of the `default` chain. Both spawn paths (`task` and vibe workers) expand the alias \u2014 the bundled `task` agent's `@task`, `sonic`/`scout`'s `@smol` \u2014 before it reaches the executor, so the role identity was lost and every child was pinned to the `default` chain, routing retries onto models the operator had deliberately kept out of the role's chain. Completes [#7694](https://github.com/can1357/oh-my-pi/pull/7694), which only covered agents whose unexpanded alias reached the executor ([#7910](https://github.com/can1357/oh-my-pi/pull/7910) by [@enieuwy](https://github.com/enieuwy)).\n- Fixed standalone `AGENTS.md` discovery stopping at nested Git repository roots, so enclosing workspace instructions are loaded while home-level instructions remain scoped correctly.\n- Split the advisor Session update delivery into per-source-message user messages (single `Agent.prompt(AgentMessage[])` call) so provider prompt caches grow with the session instead of staying pinned at the instructions/tools boundary; rendering stays byte-identical to the old single-block update.\n- Restore the advisor primary-context dedup map when a failed advisor turn is rolled back, so retried batches re-deliver first-time plan/goal context in full instead of collapsing it to \"(unchanged \u2014 still in effect)\".\n- Include all renderer-read fields (excludeFromContext, bashExecution command, pythonExecution code, branch/compaction summary + fromId, fileMention files) in advisor prefix fingerprints so clones changing only those fields correctly trigger a re-render.\n- Fixed Gemini advisors treating a valid silent review as an empty-response failure, repeatedly retrying the turn and eventually dropping the advisor backlog. ([#8223](https://github.com/can1357/oh-my-pi/issues/8223))\n- Fixed bash-tool commands receiving an unguarded `CI=1`, which broke clap-based CLIs (e.g. `tauri android build`) that parse `CI` as a strict boolean, and ignored the documented `PI_BASH_NO_CI` opt-out. The per-command env now injects clap-compatible `CI=true` and honors `PI_BASH_NO_CI`/`CLAUDE_BASH_NO_CI` ([#8229](https://github.com/can1357/oh-my-pi/issues/8229)).\n- Fixed macOS key hints rendering the Linux/Windows modifier names `Alt` and `Super` across every hint surface (`/hotkeys`, status bar, autocomplete, pending-message bar, copy selector, ask dialog): `alt` now renders as `Option` and `super` as `Cmd` on darwin, and the static `/hotkeys` navigation rows are platform-aware instead of hardcoding macOS `Option`/`Cmd` names on every platform ([#8235](https://github.com/can1357/oh-my-pi/issues/8235)).\n- Fixed `omp plugin uninstall  --dry-run` actually removing the plugin on both the npm and marketplace routes; dry-run now reports what would be removed and leaves installed plugin state unchanged ([#8178](https://github.com/can1357/oh-my-pi/issues/8178)).\n- Fixed handled OMP shutdown persisting running subagents as terminally aborted instead of restoring their transcripts as parked and revivable. ([#8216](https://github.com/can1357/oh-my-pi/issues/8216))\n- Fixed `always-ask` approval prompts opening before large edit previews finish rendering, preventing blind approvals ([#7957](https://github.com/can1357/oh-my-pi/issues/7957)).\n- Fixed Pi-compatible extensions registering tools during asynchronous session startup being omitted from the live model tool registry.\n\n### Removed\n\n- Removed the `resolveAgentModelSource` model-resolver export, whose only use was being fed to `resolveExplicitModelRole`. Replaced by `resolveAgentModelSelection`, which returns the expanded `patterns` and the pre-expansion `role` together so a spawn path cannot derive one without the other ([#7910](https://github.com/can1357/oh-my-pi/pull/7910) by [@enieuwy](https://github.com/enieuwy)).\n- A run is now attributed to the model that actually produced its output, not whichever model the session was last pointed at. A retry fallback that errored on its first request \u2014 an exhausted quota, a hard provider error \u2014 was credited with the whole run in the Agent Hub row and the settled task result, even when the previous model did every turn. Sessions expose the serving model directly, holding the last model that produced output while a candidate is armed but unproven, and transcript-derived history stops at the newest turn that produced output.\n\n## [17.2.12] - 2026-08-08\n\n### Fixed\n\n- Fixed shell minimization replacing meaningful `rustc --print` output with `OK`.\n- Fixed shell minimization altering outputs shorter than 1,000 characters; these now pass through unchanged.\n- Fixed primary and advisor Codex sessions falling back to another provider before trying sibling accounts when an account lacks Trusted Access for Cyber approval.\n- Fixed task subagent assistant turns being omitted from the per-model TPS/TTFT aggregates shown by `/models`. ([#8022](https://github.com/can1357/oh-my-pi/issues/8022))\n- Fixed terminal-title spinner writes consuming CPU during WSL/ConPTY agent waits by using the same static working separator as native Windows ([#8012](https://github.com/can1357/oh-my-pi/issues/8012)).\n- Fixed long-running sessions leaking memory for every completed keep-alive `task`/scout subagent: a disposed (parked) subagent's `AgentSession` stayed pinned through the lifecycle adoption record's reviver closure, and `dispose()` never released the message array, append-only provider transcript, session-manager entries, or the raw-SSE debug buffer, so heavy transcripts and captured provider wire frames accumulated for the process lifetime ([#8003](https://github.com/can1357/oh-my-pi/issues/8003)).\n- Fixed Z.AI web search dropping sources and exposing raw JSON when MCP responses double-encode content text ([#8000](https://github.com/can1357/oh-my-pi/issues/8000)).\n- Fixed `/handoff` masking empty/whitespace-only generation and harness-initiated aborts as \"Handoff cancelled\"; manual empty generation now surfaces a logged failure, harness aborts preserve their reason (or report \"Handoff aborted by session\"), and auto-handoff still falls back to context-full compaction ([#7993](https://github.com/can1357/oh-my-pi/issues/7993)).\n\n## [17.2.11] - 2026-08-07\n\n### Added\n\n- Added support for the Agent Plugins 1.0.0 standard, enabling automatic discovery, validation, and secure execution of compliant plugin packages.\n- Added the `omp share ` command to share saved sessions by ID prefix or file path without launching the agent.\n- Added the `AGENT=1` environment variable to child processes spawned by `coding-agent` to allow downstream tools to detect agent-driven execution.\n\n### Changed\n\n- Consolidated Exa web-search configuration under `exa.enabled`, automatically migrating legacy `exa.enableSearch` values and removing obsolete Researcher and Websets settings.\n- Removed stale `computer.backend` values during configuration migration.\n- Updated documentation and error messages for the JavaScript/TypeScript debug adapter (`js-debug-adapter`) to clarify supported installation paths (Mason, standalone tarball, or `JS_DEBUG_DAP_SERVER`).\n\n### Fixed\n\n- Fixed an issue where `/reload-plugins` and the Agent Control Center failed to propagate updated agent definitions to existing tools without a restart.\n- Fixed legacy Pi extensions failing to load when calling `pi.unregisterProvider()`, ensuring provider replacements take effect immediately.\n- Fixed zero-width daemon readiness and wait regex matches being rejected by the hub wire decoder.\n- Fixed proxy model discovery preferring bundled catalog names over proxy-reported names, allowing `omp models refresh` to correctly update display names.\n- Fixed Windows compiled binary builds failing due to backslash-separated paths in `Bun.Glob.scan` producing invalid JavaScript in virtual modules.\n- Fixed the Ctrl+O (`app.tools.expand`) shortcut not expanding truncated tool output when a tool-approval prompt or selection dialog had keyboard focus.\n- Improved `omp commit` error reporting when pre-commit or commit-msg hooks fail, displaying the hook's own message and exiting non-zero cleanly instead of printing bundled source code.\n- Fixed `omp commit --push` exiting with code 0 without pushing when the working tree is already clean; it now correctly pushes existing commits.\n- Fixed `omp commit` exiting with code 0 when the commit agent failed and fell back to a mechanical commit; it now exits non-zero to indicate the fallback was used.\n- Fixed strict output schemas being rejected when native JSON Schema definition maps contain `ref` or applicator branches use `properties` without `type`.\n- Fixed shell syntax extraction in `cd  && ...` commands to prevent redirects, extra arguments, or shell expansions from being incorrectly absorbed into the structured working directory path.\n- Applied reason-specific backoff to transient rate-limit retries and consolidated exhausted retry errors.\n- Fixed session-tree rows rendering as empty bullets for bookkeeping entries (such as title changes, credential pins, and mode changes); these are now hidden by default and properly labeled in `all` mode.\n- Fixed extension and custom tools inheriting same-named built-in TUI renderers, which could overwrite successful results with incorrect status text.\n- Fixed prewalk lifecycle handling to prevent plan injection on rejected same-model/same-effort arms, ensure consumed plan nudges do not return after context rebuilds, and prevent settings-enabled prewalk from implicitly re-arming restored sessions.\n- Fixed the todo completion reminder interrupting pauses when waiting for non-English questions (such as Chinese, Japanese, Korean, or Spanish prompts ending in `\uff1f` or `?`).\n- Normalized resolved file paths in read summaries, PDF image handles, and notebook errors to prevent agents from learning malformed paths.\n- Fixed a bug where a per-turn `before_agent_start` system prompt override was silently dropped during base-prompt rebuilds.\n- Fixed ACP `session/load` and `session/resume` failing with `ACP session not found` for sessions created under the legacy hashed project-directory scheme by falling back to a global ID scan.\n- Fixed `vault://?op=...` commands targeting the active vault instead of the named vault in Obsidian CLI queries.\n- Fixed the status-line `session_name` segment to honor the `statusLine.sessionAccent` setting, falling back to the theme's accent color when disabled.\n- Fixed automatic `agent.continue()` paths failing to run context-fit maintenance when reverting to a smaller-context model after a cooldown expiry.\n- Fixed `/handoff` reporting \"Handoff cancelled\" for actual generation or stream timeout errors, ensuring the real error is surfaced.\n\n## [17.2.10] - 2026-08-06\n\n### Breaking Changes\n\n- Replaced the re-exported `zod` API with an `omptype`-backed compatibility facade (`@oh-my-pi/omptype/zod`). Plugins retain the standard Zod-style builder interface, but real Zod-specific APIs are no longer available.\n\n### Added\n\n- Added a `--trusted-extension ` CLI flag to load an exact extension-module allowlist, bypassing ambient extension discovery.\n- Added resumable session details to fatal crash outputs, including a suggested `omp --resume ` command to quickly resume persisted live agent sessions.\n\n### Changed\n\n- Reworked the Ctrl+S Agent Hub into a responsive fullscreen roster and selected-agent inspector, featuring aggregate status/usage metrics, detailed per-agent views (task, model, activity, usage, lineage), roster and spawn-tree views, stable ordering, asynchronous persisted-session discovery, restored historical metadata, and improved keyboard and mouse navigation.\n- Replaced `arktype` with `@oh-my-pi/omptype` for all tool parameter and configuration schemas, resulting in significantly faster startup times. Configuration schema errors are now reported via `OmpErrors` entries using the standard `path`/`problem` format.\n\n### Fixed\n\n- Fixed panel commands (such as `/usage` and `/advisor status`) appearing unresponsive during active turns by flushing the deferred-panel queue at every settle, terminal or not. The deferral itself stays silent: mounting a status line into the transcript mid-turn re-renders rows below the live block and duplicates them in native scrollback (issues #4806/#6767).\n- Fixed the bundled `ts-no-tiny-functions` rule failing to match one-line arrow functions in files with trailing newlines.\n- Fixed advisor refusals skipping the model fallback chain, and bounded refusal recovery to a single attempt per model to prevent infinite fallback loops.\n- Fixed repeated `/mcp reauth` commands getting stuck by ensuring new reauthorization requests cancel and clean up any pending MCP OAuth login flows.\n- Fixed WSL host-home resolution to build `/mnt//...` fallback paths using POSIX semantics regardless of the host platform.\n- Fixed Python evaluation shell helpers (`!cmd`, `%%bash`, `%pip`) letting child processes inherit the runner's stdin, which previously caused deadlocks on Windows. Additionally, `%%bash` now correctly resolves Git Bash on Windows.\n- Fixed subagents spawned via model-role aliases incorrectly falling back to the `default` role's retry chain instead of their own configured role chain.\n- Fixed Linux/X11 clipboard reads failing when `xclip` is missing but `xsel` is available.\n- Hardened Linux Chromium executable detection to filter out non-executable files, invalid wrappers, and candidates that hang during version probes.\n- Fixed Bash command preview crashes caused by malformed tool arguments containing non-string environment values.\n- Fixed UI rendering in the model browser and model hub where `nerd`-preset role chips would overlap and obscure the first character of labels.\n- Fixed Codex web search sending incompatible request shapes to certain models, which caused the hosted `web_search` tool to ignore them.\n- Fixed resumed or rebuilt sessions incorrectly applying stale rewind reports from previous checkpoint cycles to new checkpoints.\n- Fixed the `read` tool incorrectly parsing semicolon-delimited internal URLs (such as batched `skill://` resources) as a single invalid resource.\n- Fixed `pi.getAllTools()` returning bare strings instead of `ToolInfo[]` objects, restoring compatibility with extensions built against the upstream contract.\n- Fixed legacy extensions failing to load in compiled binaries when resolving bundled dependencies via dynamic `createRequire` factories.\n- Fixed Wayland window activation and native input handling by correctly reporting them as unavailable rather than attempting unsupported foreground-delivery paths.\n- Fixed live execution progress being hidden in the conversation view after approving a plan in the fullscreen Plan Review.\n- Fixed `omp -r` failing to discover sessions created under the temporary hashed project-directory scheme by adding a one-way migration back to legacy path-based names.\n- Prevented the `read` tool from advertising or resolving `memory://` URIs when the memory backend is disabled.\n- Fixed the Shift-Tab thinking mode UI rendering the `off` state as a blank label, which made it appear that reasoning could not be disabled.\n- Fixed parsing of POSIX `$EDITOR` commands that contain quoted arguments or executable paths with spaces.\n- Fixed persisted Agent Hub rows losing the explicit caller model role when a subagent used a model override, preserving role provenance across restarts.\n- Fixed unobserved promise rejections in browser helpers (such as `tab.waitForResponse()`) causing tab workers to hang or crash.\n\n## [17.2.9] - 2026-08-05\n\n### Breaking Changes\n\n- Renamed `compareVersions` to `compareChangelogEntries` in `@oh-my-pi/pi-coding-agent/utils/changelog`. The function signature and behavior are unchanged; update imports to use the new name.\n\n### Added\n\n- Added automatic detection of common Ungoogled Chromium Linux installations for the browser tool.\n\n### Changed\n\n- Restored the legacy project-scoped session directory naming scheme and removed its automatic migration ([#7646](https://github.com/can1357/oh-my-pi/issues/7646)).\n- Routed Bun install-cache pruning in `update-cli` through the shared `compareVersions` utility (`@oh-my-pi/pi-utils`), removing a duplicate local comparator that rounded large numeric version identifiers via `Number`.\n\n### Fixed\n\n- Retried concurrent-request caps with a short backoff without deleting valid Copilot credentials or rotating through sibling accounts.\n- Fixed the default `textVerbosity` setting being forwarded to OpenAI Codex requests unless the user explicitly configures it, preserving Codex's native response-control defaults. ([#4949](https://github.com/can1357/oh-my-pi/issues/4949))\n- Reduced streaming CPU usage by coalescing the cumulative `message_update` deltas of a turn at the event-controller dispatch boundary: at most one streaming-state rebuild runs per ~33ms window instead of one per token, cutting the per-token handler work that dominated the CPU profile of streaming sessions (especially at high token rates) while preserving per-delta speech output. Subscriber dispatch is serialized so a rapid stream tail (`message_update` \u2192 `message_end` \u2192 `agent_end`) cannot overtake the coalesced flush. ([#7443](https://github.com/can1357/oh-my-pi/issues/7443))\n- Fixed translated MCP importers (Claude Code, Cursor, Gemini CLI, Windsurf, VS Code) silently dropping a server's `enabled: false` flag, so a server disabled at the source config stayed mounted; the flag is now propagated and honored like Codex, OpenCode, and native `mcp.json`. These importers now also load project entries before same-named user entries (matching native/Codex) so a project `enabled: false` suppresses a same-named user server ([#7652](https://github.com/can1357/oh-my-pi/issues/7652)).\n- Removed the per-call `model` override from the eval `agent()` helper (all runtimes), completing the earlier task-tool removal (`9f8aa87dbf`). Subagents always use their selected agent's frontmatter model and settings; a legacy `model` argument is silently ignored, so an explicit `model: \"default\"` can no longer route children onto the parent session model ([#6438](https://github.com/can1357/oh-my-pi/issues/6438)).\n- Fixed legacy Pi extension validation rejecting plugins such as `remote-pi` that import the package-root `convertToPng` image helper. ([#7610](https://github.com/can1357/oh-my-pi/issues/7610))\n- Fixed the legacy session-directory migration silently deleting a live session's transcript when its filename collided with an existing entry in the destination: colliding entries are now preserved in place, the legacy directory is only removed when empty, and collisions/migration failures are logged ([#7593](https://github.com/can1357/oh-my-pi/issues/7593)).\n- Fixed `PUPPETEER_EXECUTABLE_PATH` being ignored when a system Chrome installation was detected, preventing Windows users from selecting a compatible headless browser for the shared browser daemon ([#7601](https://github.com/can1357/oh-my-pi/issues/7601)).\n- Fixed `openai-models-list` discovery ignoring server-advertised input modalities, so custom virtual tier IDs absent from the bundled catalog showed `images: no` even when the `/v1/models` response reported `input: [\"text\",\"image\"]` ([#7583](https://github.com/can1357/oh-my-pi/issues/7583)).\n- Exposed exact source line counts in read results when selector-based reads reach EOF, allowing protocol bridges to distinguish a returned slice from the complete file ([#7590](https://github.com/can1357/oh-my-pi/issues/7590)).\n- Fixed `grep`/`glob` silently collapsing a semicolon-delimited `path` list to one literal path when the joined string was too long for the OS to name (`ENAMETOOLONG`) \u2014 a list of bare filenames past `NAME_MAX` or absolute paths past `PATH_MAX` failed with `Path not found: ` even though every entry existed. The multipath probe now treats `ENAMETOOLONG` as a definitively non-existent single path so the split proceeds, and `glob` surfaces a clean `Path not found` instead of leaking the raw errno ([#7597](https://github.com/can1357/oh-my-pi/issues/7597)).\n- Fixed `--mode json` (and text) print mode truncating a large final record (e.g. a multi-MB `agent_end`) when the process exited before stdout drained, while still exiting 0. Per-event writes are now serialized on their own completion callbacks and shutdown blocks on the last one, so the terminal record is delivered in full ([#7635](https://github.com/can1357/oh-my-pi/issues/7635)).\n- Fixed text print mode treating buffered partial responses as replay-unsafe, allowing transient mid-stream connection failures to retry without exposing duplicated output ([#7625](https://github.com/can1357/oh-my-pi/issues/7625)).\n- Fixed Hindsight `autoRecall` intermittently not reaching the model: two recall paths shared the `hasRecalledForFirstTurn` flag, and the `agent_start` event path could consume it first and inject only via an unawaited background prompt rebuild that a fast turn outran. `beforeAgentStartPrompt` (awaited before the turn builds) is now the sole injection path ([#7568](https://github.com/can1357/oh-my-pi/issues/7568)).\n- Fixed `read memory://` returning a confusing \"Unknown memory namespace\" error under `memory.backend=hindsight` (Hindsight stores memories server-side and has no `memory://` addressing); the handler now returns a corrective pointer to `recall`/`reflect` so a stray read \u2014 steered by the shared `recall` tool description \u2014 self-corrects in one turn ([#7587](https://github.com/can1357/oh-my-pi/issues/7587)).\n- Fixed extension/custom/hook tool wrappers stripping schema methods off `parameters`: `applyToolProxy` bound every callable property, and binding a schema (a plain function carrying `toJsonSchema`/`assert`) dropped those properties, breaking wire-schema detection and crashing the status-line token estimator with `JSON.stringify(schema) === undefined`. Prototype methods are still bound; own data properties and schema callables now pass through untouched.\n- Fixed bug where `agent()` calls in eval cells ignored turn cancellation and continued running indefinitely\n- Fixed the built-in `tail` printing `tail: Broken pipe` and failing when a downstream pipeline reader exited early (e.g. `tail -c N file.jsonl | jq \u2026` with jq aborting on a parse error); it now exits silently with 141 (128+SIGPIPE) like a real tail, in every output path including `--follow`.\n- Fixed the in-process ps shell builtin rejecting common procps/BSD format specifiers (`ps -o tpgid,...` failed with `unknown output format specifier`); added `tpgid`, `pri`, `flags`, real/effective user and group columns, `wchan`, fault counters, `sz`, and the STAT `+` foreground flag.\n- Fixed Herdr rejecting the macOS development launcher because its foreground process was reported as `bun` instead of `omp`.\n- Completed usage-aware model fallback across startup, queued turns, same-turn tool continuations, ACP/TUI confirmation cancellation, eligible account reselection, cooldown restoration, and isolated subagent settings so low-usage handoffs remain lossless and cannot consume cancelled queued work.\n- Fixed Agent Hub opening and selection becoming O(all rows) on large rosters: row rendering is now lazy around the selected viewport, and observer lookup is O(1) by id instead of copy-sorting every session per row.\n- Fixed the bash interceptor blocking `grep`/`cat`/`find` used as a downstream pipeline stage (e.g. `printf 'x\\n' | grep x`); a stage consuming piped stdin cannot be replaced by a path-based dedicated tool, so it is no longer matched, while standalone and first-stage searches stay intercepted ([#7496](https://github.com/can1357/oh-my-pi/issues/7496)).\n- Fixed floating rejections from cmux browser guest JavaScript terminating the main process and every active session; attributable rejections now fail the browser run as tool errors while unrelated process rejections retain the fatal path ([#7365](https://github.com/can1357/oh-my-pi/issues/7365)).\n- Fixed the Windows bash tool silently taking down the whole omp process when a command blocked until its timeout: cancelling a timed-out run walked the spawned child's descendant tree from raw `th32ParentProcessID` links, and a recycled pid matching the harness's stale recorded parent pid could enumerate omp as a false descendant and `TerminateProcess` it, killing the session with no `session_exit` record. Run-cancellation sweeps now refuse to signal the harness or any process collected beneath it, while still reaping the timed-out target when it owns a recycled ancestor pid ([#7452](https://github.com/can1357/oh-my-pi/issues/7452)).\n- Fixed the unexpected-stop guard (`features.unexpectedStopDetection`) never firing for thinking-only stops: `isUnexpectedStopCandidate` only counted non-whitespace `text` blocks, so a `stopReason: \"stop\"` turn whose sole content was a signed `thinking` block (a trapped response or a truncated reasoning fragment from reasoning models) bypassed classification and silently ended the turn mid-task. Such stops are now candidates and are classified on their thinking text ([#7499](https://github.com/can1357/oh-my-pi/issues/7499)).\n- Fixed Task cancellation hanging forever when a child ignored abort or stalled during cleanup ([#7483](https://github.com/can1357/oh-my-pi/issues/7483)).\n- Fixed LSP diagnostics being dropped when servers normalize file URI percent-encoding or Windows path casing.\n- Fixed WSL sessions missing Agent Skills stored in the Windows host profile's `.agents/skills` directory. ([#3779](https://github.com/can1357/oh-my-pi/issues/3779))\n- Fixed `omp setup python` to validate the same configured or discovered interpreter used by the Python eval runtime.\n- Fixed self-update misclassifying glibc Linux hosts with an installed musl loader as musl hosts, which could download an unusable musl binary instead of the glibc release.\n- Fixed a crash where opening the Agent Hub after a resume and moving the selection triggered an unbounded `ExtensionExitError` unhandled-rejection storm and exit 129. The postmortem module bound the native hard-exit at first evaluation; when the bundler deferred that evaluation into a `withHostGuard` window it froze the guard's throwing replacement, poisoning every later signal/fatal exit. The native exit is now resolved per call, and the guard stamps its replacement with the native primitive it shadows so mid-guard signals still exit ([#7393](https://github.com/can1357/oh-my-pi/issues/7393)).\n\n## [17.2.8] - 2026-08-04\n\n### Changed\n\n- Upgraded the bundled omptype schema engine: intersection and pipe operators, bigint and RegExp literals in the string DSL, Standard Schema V1 interop, JSON Schema import via fromJsonSchema(), and richer union/collection error reporting.\n\n## [17.2.7] - 2026-08-03\n\n### Changed\n\n- Replaced arktype with @oh-my-pi/omptype for tool parameter and config schemas, significantly improving startup performance with ~100x faster schema construction. Config schema errors are now reported via OmpErrors using the same path/problem structure.\n\n### Fixed\n\n- Fixed an issue where custom, extension, or hook tool wrappers stripped schema methods off parameters, causing wire-schema detection failures and status-line token estimator crashes.\n- Fixed a bug where agent() calls in evaluation cells ignored turn cancellation and continued running indefinitely.\n- Fixed the built-in tail command to exit silently with code 141 (SIGPIPE) instead of failing with a \"Broken pipe\" error when a downstream pipeline reader exits early.\n- Fixed the in-process ps shell builtin to support common procps/BSD format specifiers, including tpgid, pri, flags, real/effective user/group columns, wchan, fault counters, sz, and the STAT + foreground flag.\n- Fixed install.sh falsely reporting success on musl-based systems (such as Alpine Linux) when the binary fails to start; the installer now smoke-tests the binary, exits non-zero on failure, and provides remediation steps.\n- Fixed Codex config.toml discovery incorrectly importing MCP servers that are configured with enabled = false.\n- Fixed bash.patterns allow rules rejecting valid commands when quoted arguments contained shell metacharacters (such as Cargo benchmark regex filters).\n\n## [17.2.6] - 2026-08-03\n\n### Added\n\n- Added the `/reset` slash command to reset the conversation context in place: it drops the live messages, queued turns, and pending tool calls (and cancels the turn's async jobs, post-prompt continuations, and checkpoint/plan runtime state) while keeping the session id, title, cwd, model, and on-disk transcript. It records a durable reset boundary so the live transcript stays cleared across rebuilds (theme change, focus attach, `/shake`, resume) instead of resurrecting the pre-reset messages, while the full pre-reset history stays on disk ([#3580](https://github.com/can1357/oh-my-pi/issues/3580)).\n\n### Fixed\n\n- Fixed extension slash commands appearing as user prompts after being handled locally.\n- Preserved explicit session titles when branching from an earlier conversation turn.\n- Fixed an issue where unhandled JavaScript rejections in the browser guest could crash the main process and active sessions, converting them into tool errors instead.\n- Fixed a critical issue on Windows where cancelling a timed-out bash tool command could mistakenly terminate the main process due to PID recycling.\n- Fixed an issue where supervised processes reaching a terminal state failed to notify their launching session, requiring polling; the broker now actively notifies the session upon process completion.\n- Fixed crashes on macOS when using PCRE2-only grep patterns with Bun by defaulting to the interpreted PCRE2 engine instead of JIT, and introduced the `OMP_PCRE2_JIT` environment variable to manually control JIT compilation.\n- Fixed issues with `/btw` branch promotion where branches could park behind active turns, cut from outdated session leaves, or leave rejected branch keys indistinguishable from composer input.\n- Fixed database bloat by ensuring archived main and nested session rows are properly cleaned up from `stats.db` during garbage collection.\n- Fixed startup hanging during local model discovery when a timed-out transport left its request pending, which blocked the CLI before OAuth login could finish ([#7482](https://github.com/can1357/oh-my-pi/issues/7482)).\n\n## [17.2.5] - 2026-08-03\n\n### Breaking Changes\n\n- Replaced the computer tool's coordinate-batch schema with persistent JavaScript runs, and removed computer.backend and model-specific controller switching.\n- Changed the edit tool's replace mode from a multi-edit batch schema to a single-edit schema ({ path, old_string, new_string, replace_all? }).\n\n### Added\n\n- Added a relay browser mode to drive local Chrome tabs via the OMP Browser Relay extension, supporting automatic daemon startup and tab grouping.\n- Added a scriptable desktop session featuring window-targeted capture and input, native accessibility trees, clipboard access, and streamed screenshots.\n- Added broker-shared language servers (controlled by the lsp.shared setting) to multiplex LSP servers across multiple instances in a project, reducing cold-start times and resource usage.\n- Added optional timeoutMs to discovery configuration in provider options to configure custom HTTP probe timeouts for llama.cpp, Ollama, and OpenAI-compatible endpoints.\n- Added a cross-platform, in-process ps shell builtin with custom columns, sorting, and process metrics.\n- Added the --service-tier flag to override the OpenAI service tier for a session.\n- Added a configurable per-request web search timeout via providers.webSearchTimeoutSeconds.\n- Added turn-aware /tree navigation shortcuts (Alt+Up/Alt+Down, Home/End, PageUp/PageDown) to traverse user and assistant turns.\n- Added display.hideToolActivity and a Ctrl+Shift+O shortcut to toggle the visibility of model-initiated tool calls and results.\n\n### Changed\n\n- Exposed the script-driven computer schema to all models, including those with provider-native Computer Use support.\n- Reduced omp --help cold-start latency and memory usage by rendering lightweight command metadata.\n\n### Fixed\n\n- Fixed durability of session transcripts to prevent data loss on process crashes.\n- Fixed a bug on Windows where a timed-out bash command could terminate the main omp process.\n- Fixed headless runs hanging or leaving background workers alive after completion.\n- Fixed a crash when opening the Agent Hub after resuming a session.\n- Fixed /mcp reauth environment variable expansion and token validation.\n- Fixed fuzzy replace-all edits re-matching replacement text indefinitely, which could freeze the TUI.\n- Fixed inspect_image ignoring configured thinking effort for vision models.\n- Fixed compiled binaries dropping certain extensions with complex CommonJS/ESM dependency graphs.\n- Fixed template argument substitution executing recursive placeholder expansion when positional arguments contain literal $@ or $ARGUMENTS tokens.\n- Fixed project-scoped session directories using leading-hyphen names and collapsing distinct paths.\n- Fixed manual /shake leaving the context budget anchored to stale pre-shake token counts.\n- Fixed Mnemopi scoped recall reporting \"No relevant memories found\" when individual targets fail internally.\n- Fixed skill:// resolution ignoring custom directories when a same-named skill exists in a default path.\n- Fixed image paste failing on Wayland-only Linux sessions.\n- Fixed prewalk switching to the fast model during read-only investigations.\n- Fixed self-update misclassifying glibc Linux hosts with an installed musl loader as musl hosts.\n- Fixed omp setup python to validate the correct interpreter used by the Python eval runtime.\n- Fixed the terminal-tab title dropping to idle while an unsuppressed async job was still running.\n- Fixed redirected stdin being ignored when Bun reports a pipe with an undefined isTTY.\n- Fixed a literal API key configured via /login being hijacked on Windows by case-differing system environment variables.\n- Fixed Esc during a streaming /loop iteration pausing the loop instead of aborting the current turn.\n- Fixed heavily branched conversation trees shifting linear continuations into disconnected columns.\n- Fixed plugin installation validation failures for legacy compatibility shims.\n- Removed hard-coded references to disabled or absent agents in system and tool prompts.\n\n## [17.2.4] - 2026-08-01\n\n### Added\n\n- Added `requestIdFormat` (`\"string\"` | `\"number\"`, default `\"number\"`) to MCP server config, honored by the stdio, HTTP, and SSE transports. JSON-RPC 2.0 permits both id shapes, but Apple's `xcrun mcpbridge` decodes `id` as an integer only and silently drops string ids (`mcpbridge.DecodeError Code=1`), hanging every request until it times out. The option is OMP-specific, so set it in an OMP-owned config (`.omp/mcp.json`, `~/.omp/agent/mcp.json`, a project `mcp.json`/`.mcp.json`, or an OMP plugin); servers imported from another tool's config ignore it ([#7053](https://github.com/can1357/oh-my-pi/issues/7053)).\n- Fixed Anthropic web search sending unsupported temperature parameters to sampling-restricted Claude models ([#7195](https://github.com/can1357/oh-my-pi/pull/7195) by [@will-bogusz](https://github.com/will-bogusz)).\n- Fixed mid-turn steering/peer-interrupt tool skips rendering as errors (red \u2718, red border/text) in the TUI; pending and in-flight interrupt placeholders now render as neutral info cards while preserving whether `tool.execute` started ([#7199](https://github.com/can1357/oh-my-pi/issues/7199)).\n- Added `Shift+Up` as a second default for the message dequeue, so the shortcut is reachable in macOS Terminal.app where Option is consumed for character composition.\n- Added in-process `pgrep`, `pkill`, `pidwait`, and `top` shell builtins with cross-platform process discovery, BSD/procps-style filters, pidfile handling, signal selection, waiting, and snapshots.\n\n### Changed\n\n- Headless hosts (print/RPC/ACP/eval/SDK) now use a 1s SQLite `busy_timeout` for the session-critical databases (agent.db, history.db, stats.db), so lock contention no longer freezes the protocol loop for the full interactive 5s timeout; interactive hosts keep the 5s timeout. The interactive-host flag is now declared before settings load so the first database opens see the correct timeout.\n- The model picker (`/switch`, alt+p) no longer blocks models whose context window is smaller than the live session: over-context rows stay grayed but selectable, and picking one compacts with the current model first, then switches. A cancelled or failed compaction keeps the current model.\n- MCP JSON-RPC request ids now default to per-connection sequential integers instead of snowflake strings, matching the wider MCP ecosystem and making integer-only decoders like Apple's `xcrun mcpbridge` work without configuration; set `requestIdFormat: \"string\"` per server to restore collision-resistant string ids ([#7053](https://github.com/can1357/oh-my-pi/issues/7053)).\n- `secret-placeholder.key` now resolves under XDG state (`$XDG_STATE_HOME/omp/secret-placeholder.key`) instead of the agent config directory, so it follows the same XDG layout as other state files.\n- Daemon runtime directories (`run/daemons/`) and provider in-flight tracking (`run/provider-inflight`) now resolve under XDG state (`$XDG_STATE_HOME/omp/run/`) instead of the config root, keeping ephemeral runtime state out of `~/.config`.\n- `marketplaces.json` now resolves under XDG data (`$XDG_DATA_HOME/omp/marketplaces.json`) instead of the config root, aligning with the XDG data category for user-scoped registry files.\n- Existing XDG installs keep their placeholder key and marketplace registry: the legacy `~/.omp/agent/secret-placeholder.key` and `~/.omp/marketplaces.json` are copied to their XDG locations on first resolution.\n\n### Fixed\n\n- Fixed sessions without a granted `write` tool hiding discoverable and MCP tools behind the unusable `xd://` transport; those sessions now disable device mounting and expose the tools directly without gaining write access.\n- Fixed collab guest prompts being sent to models as unframed developer context, so guest messages now retain their transcript attribution while reaching the model as prioritized user interjections ([#7288](https://github.com/can1357/oh-my-pi/issues/7288)).\n- Fixed `/memory stats` and `/memory diagnose` showing \"Memory stats is not available for the off backend\" when memory is off, in both the TUI and ACP/RPC slash-command handlers; the off backend now says memory is off directly instead of naming itself as an unsupported backend ([#7251](https://github.com/can1357/oh-my-pi/pull/7251) by [@KennethHoff](https://github.com/KennethHoff)).\n- Fixed `/reload-plugins` retaining stale context-file contents and activation state in the current system prompt ([#7258](https://github.com/can1357/oh-my-pi/issues/7258)).\n- Fixed compiled binaries failing to import nested wildcard export subpaths such as `@oh-my-pi/pi-coding-agent/slash-commands/helpers/active-oauth-account`. Node matches `*` in an `exports` pattern across `/`, but the bundled registry enumerated only the top level and skipped any key containing a slash, so such an import resolved from source and died under bunfs \u2014 reproducible on the published 17.2.1 binary.\n- Fixed concurrent session appends during `/move` recreating an orphaned `.jsonl` fragment in the old session directory ([#7270](https://github.com/can1357/oh-my-pi/issues/7270)).\n- Fixed interactive launches hanging silently when a host project or its `.env` sets `NODE_ENV=test` or `BUN_ENV=test` ([#7261](https://github.com/can1357/oh-my-pi/issues/7261)).\n- Fixed a subagent killed from the Agent Hub (`x`) reappearing as a `parked` row after closing and reopening the hub in a local session; the kill now leaves the ref registered as terminal `aborted` instead of unregistering it, so the persisted-subagent rescan no longer re-adopts the surviving transcript ([#7250](https://github.com/can1357/oh-my-pi/issues/7250)).\n- Fixed manual and automatic Codex compaction dropping the configured OpenAI WebSocket preference ([#7198](https://github.com/can1357/oh-my-pi/issues/7198)).\n- Fixed two remaining tool-card double renders: a superseded assistant turn no longer leaves its never-run cards above the re-run's fresh cards (a TTSR rewind retracts them immediately; an auto-retry removes the synthetic-settled failure cards when it supersedes the turn \u2014 while a genuinely terminal failure keeps its card visible), and a successful read whose persisted result wins a transcript-rebuild race no longer creates a fallback read group when its delayed live completion arrives ([#6879](https://github.com/can1357/oh-my-pi/issues/6879)).\n- Fixed a tool card rendering twice when the provider rewrites a streamed tool call's id mid-stream \u2014 GitHub Copilot's `call_id|id` transport, or any stream that delivers the tool name/arguments before the id \u2014 so the block appears first with an empty or partial id and is populated in a later delta. The transcript keyed the live card by that mutable id, so the changed id spawned a second card: the old-id card orphaned as a blue pending preview while the new-id card took the result. Streamed tool cards are now re-keyed in place when their id changes, using the block's position in the streaming message as a stable identity ([#6879](https://github.com/can1357/oh-my-pi/issues/6879)).\n- Withheld advisor nits and concerns while the primary turn is explicitly marked in progress, while still allowing blockers for unrecoverable active side effects.\n- Preserved explicit `-e`/`--extension` and `--hook` packages under\n  `--no-extensions` while excluding ambient extension factories and sibling\n  capabilities from settings or installed OMP packages.\n- Fixed explicit `thinking` metadata in `models.yml` custom definitions and `modelOverrides` being replaced by canonical catalog policy during model rebuilding. ([#7307](https://github.com/can1357/oh-my-pi/issues/7307))\n- Fixed the auto-titler installing a model's whole answer as the session title when the tiny title model ignored the titling task and answered the first user message instead. `normalizeGeneratedTitle` now rejects overlong output (>80 chars or >12 words) so the caller defers titling to the next user turn rather than accepting a full sentence ([#7303](https://github.com/can1357/oh-my-pi/issues/7303)).\n- Fixed the in-process `kill` builtin to validate signals, preserve negative PID operands, signal every process in pipeline jobs, continue after bad targets, and refuse non-probe signals aimed at the host process or process group.\n\n## [17.2.3] - 2026-08-01\n\n### Changed\n\n- Tightened the system prompt notation: the legend now defines `\u27fa`, `\u2260`, `\u2209`/`\u220c`, and operator binding order; replaced undefined symbols (`\u22ad`, `\u2262`) in prompt bodies; removed delegation guidance duplicated between the eager-tasks preamble and the delegation gates.\n\n### Fixed\n\n- Fixed headless browser launch storms and orphaned Chromium process trees: omp processes now attach to one project-shared Chromium owned by the daemon broker (tabs per session; Chrome dies with the last omp client in the project), concurrent browser opens in one process share a single launch, and concurrent daemon `start` requests for one name can no longer spawn duplicate untracked processes.\n- Fixed Bash auto-background leaving a live `Bun.sleep` threshold timer scheduled after a command completes (or abort/steering wins) first, which could keep the event loop alive and delay SDK/headless shutdown until the threshold expired ([#7235](https://github.com/can1357/oh-my-pi/issues/7235)).\n- Fixed ephemeral side turns and native compaction bypassing an explicit or fork-inherited prompt cache key ([#7218](https://github.com/can1357/oh-my-pi/issues/7218)).\n- Fixed the live Ask dialog crashing the whole session with a `replaceTabs` TypeError when a question reached `AskDialogComponent` without a string `question` field; questions are now normalized at dialog entry, mirroring the transcript renderer ([#7211](https://github.com/can1357/oh-my-pi/issues/7211)).\n- Fixed Codex web search collapsing backend errors to `Codex error (): Unknown error`; the SSE error parser now preserves the backend code and message from top-level, nested `error`, and `response.error` envelopes ([#7200](https://github.com/can1357/oh-my-pi/issues/7200)).\n\n## [17.2.2] - 2026-07-31\n\n### Added\n\n- Added an app.live.toggle keybinding (default Ctrl+L) to start or stop live voice mode.\n- Added ctx.invokeTool(params, options?) to extension contexts, allowing wrappers to run native tools while inheriting context, abort signals, and progress updates.\n\n### Changed\n\n- Moved the display-reset default keybinding (app.display.reset) from Ctrl+L to Alt+L to accommodate the new live-mode toggle.\n- Updated the hashline edit tool, streaming preview, and plan-mode guidance to support the unified PUT/CUT grammar, .= ranges, and named registers.\n- Improved startup performance by moving subagent model-registry refresh and session-file opening off the launch critical path.\n- Optimized session file writing performance by batching same-turn file-session appends.\n- Rewrote the Codex saved-reset auto-redeem algorithm to be pool-wide, window-exact, and expiry-aware, ensuring banked resets are automatically and reliably redeemed across multi-account setups before they expire.\n\n### Fixed\n\n- Fixed a crash in Kitty terminals when rendering non-PNG tool-result images if PNG conversion fails.\n- Fixed subagent evaluation resets (reset: true) wiping the shared kernel inherited from the parent session; resets from non-exclusive owners now fork into a private per-owner kernel.\n- Fixed the copy selector and ask dialog rendering raw key IDs instead of human-readable keybinding labels.\n- Fixed CLI positional initial messages bypassing automatic session-title generation.\n- Fixed the environment-variable reference omitting Kitty Unicode placeholder controls and tmux placement caveats.\n- Fixed extension validation failures during omp plugin install for extensions importing compact from @earendil-works/pi-coding-agent by adding the missing re-export.\n- Fixed Bash interceptor rules to inspect unquoted/unescaped compound command fragments (e.g., &&, ||, ;, |, &, and newlines) instead of only matching the complete command input.\n- Fixed ExtensionContext.cwd staying pinned to the initial session directory; it now dynamically tracks the active session's current working directory.\n- Fixed the web-search provider picker description for xAI/Grok to clarify that it supports SuperGrok/X Premium+ OAuth sign-ins.\n- Fixed /reload-plugins failing to reconnect MCP servers or refresh MCP tool and prompt-command registries.\n- Enforced the centralized artifact spill threshold on oversized read results, persisting them as recoverable session artifacts.\n- Fixed DuckDuckGo web search under-returning results above the first-page limit by automatically submitting continuation forms.\n- Fixed DuckDuckGo web search ignoring after: and before: date bounds by correctly parsing and filtering result timestamps.\n- Fixed env-driven OTLP trace export ignoring OTEL_RESOURCE_ATTRIBUTES.\n- Fixed a fresh session with deferred MCP discovery injecting the newly mounted xd:// tool catalog twice into the first model request.\n- Fixed the bash tool failing with EACCES permission errors on multi-user machines by scoping the snapshot directory per user ID.\n- Fixed LSP write batching replaying stale whole-file snapshots over newer external changes made before the batch flushed.\n- Fixed ctx.ui.editor() in ACP mode always resolving to undefined by routing it through the elicitation bridge.\n- Fixed omp commit failing to resolve extension-provided models in both agentic and legacy pipelines.\n- Fixed RPC hosts receiving no subagent lifecycle or progress frames when an IRC message revives an idle or parked keep-alive subagent.\n- Fixed copied fenced-code body rows in assistant messages retaining component and container margins.\n- Fixed mid-turn auto-compaction repeating dead-end rescue work and warnings at every tool boundary within a single oversized turn.\n- Fixed automatic terminal appearance changes clearing native scrollback and snapping readers away from their current scroll position.\n- Fixed exact-match edits failing on files containing credential-shaped tokens when secrets.enabled is active by using reversible placeholders instead of irreversible redactions.\n- Fixed context usage collapsing to the latest response size for Cursor models that omit prompt-token usage.\n- Fixed the browser tool crashing with EBUSY errors on Windows when a headless Chromium profile is locked during cleanup.\n- Fixed the Python RPC client dropping context, compaction, OAuth URL, and terminal-settlement fields.\n- Fixed the browser tool ignoring the url parameter when opening a new tab on an attached browser.\n- Fixed browser automation disrupting attached browsers by adopting the active foreground tab and avoiding raising new tabs during screenshots.\n\n## [17.2.1] - 2026-07-30\n\n### Added\n\n- Added `--from-claude` and `--from-codex` session imports, also available from `/resume @claude` and `/resume @codex`.\n- Added an opt-in OMP-native software-security workflow (`security.enabled`, default off) with immutable scan plans, exact-account Codex subscription affinity, native task-worker review, canonical findings/coverage/SARIF publication, project-scoped history, explicit dispositions, producer-differential comparison, and the read-only `security://` resource namespace. Generic SARIF and official Codex Security bundles normalize into the same OMP-owned store.\n- Added explicit Codex Security cloud operations to the opt-in security workflow: list and start account-pinned cloud scans, inspect their progress, and import current findings into OMP's canonical store and `security://` namespace without changing the native scan engine or spoofing official runtime attribution.\n\n### Changed\n\n- Reserved `security://` from RPC host URI shadowing so vendor adapters cannot replace OMP's canonical security-analysis namespace.\n\n### Fixed\n\n- Fixed remote or LAN local-engine endpoints being ignored during model discovery: the llama.cpp and Ollama probes used timeouts tuned for loopback, so a host reached over the network could exceed them and return no models, while changing `OLLAMA_BASE_URL`/`OLLAMA_HOST` could keep reusing a fresh cache from the previous endpoint. Non-loopback hosts now get a generous discovery timeout, and Ollama cache rows are scoped to the normalized endpoint ([#7087](https://github.com/can1357/oh-my-pi/issues/7087)).\n- Fixed `omp install` failing extension validation for pi extensions that import `createEditTool` or `createWriteTool` (e.g. gentle-pi) \u2014 the legacy `@oh-my-pi/pi-coding-agent` shim exported the read/bash/grep/find/ls tool factories but omitted the edit and write ones, so a named import threw Bun's static \"Export named X not found\" error. Added `createEditTool`/`createEditToolDefinition` and `createWriteTool`/`createWriteToolDefinition` to match the upstream pi surface ([#7094](https://github.com/can1357/oh-my-pi/issues/7094)).\n- Fixed Python eval's loopback tool bridge being routed through macOS system HTTP proxies, which caused `parallel()` tool reads to fail with `ConnectionRefusedError` after a local proxy stopped.\n\n## [17.2.0] - 2026-07-30\n\n### Breaking Changes\n\n- Removed the `DEL`, `DEL.BLK`, `COPY`, and `COPY.BLK` hashline edit operations. Use `CUT` / `CUT.BLK` for deletion; removed content remains available to `PASTE`.\n\n### Added\n\n- Added server-name autocomplete for `/mcp` commands (`enable`, `disable`, `test`, `remove`, `reconnect`, `reauth`, `unauth`) using configured and runtime-discovered MCP servers.\n- Added `CUT` and `PASTE` ops to the hashline edit tool for moving code without retyping it: `CUT N.=M` (and `.BLK` block forms) capture lines into a clipboard register, and `PASTE` operations insert them. The register flows across sections within a patch (cross-file moves) and persists across edit calls per session.\n- Added `--from-claude` and `--from-codex` session imports (including compaction state for Codex), also available from `/resume @claude` and `/resume @codex`.\n- Added interactive Exa API-key onboarding through `/login exa`, opening the official key dashboard and saving pasted keys for authenticated web search while preserving `EXA_API_KEY` and explicit-selection public MCP fallback behavior ([#1798](https://github.com/can1357/oh-my-pi/issues/1798)).\n- Added `ExtensionContext.getAsyncJobSnapshot()` so extensions can read the owning session's async-job state without relying on process-global job-manager identity\n- Added opt-in `tui.codexResetFireworks` celebrations for unscheduled Codex weekly usage resets and newly banked saved resets, shown in a theme-aware top-third modal until Escape ([#6858](https://github.com/can1357/oh-my-pi/pull/6858) by [@joshrzemien](https://github.com/joshrzemien)).\n- The Cursor exec bridge serves the seven modern Pi tool frames, mapping each to its local equivalent: `pi_read`/`pi_ls` \u2192 `read`, `pi_bash` \u2192 `bash`, `pi_edit` \u2192 `edit`, `pi_write` \u2192 `write`, `pi_grep` \u2192 `grep`, and `pi_find` \u2192 `glob`. The frames are a separate wire family from the legacy args, not aliases, so each mapping is a real translation \u2014 `pi_grep`'s `ignore_case` is the inverse of the local tool's case-sensitivity flag, `pi_find` searches filenames rather than contents, and `pi_edit`'s replacements are renamed to the local snake_case pairs.\n- `providers.autoThinkingMaxEffort` (`xhigh` | `max`, default `xhigh`) raises the ceiling of the `auto` thinking classifier. `max` became a first-class effort tier after the classifier prompt was written, so `auto` could never reach it on models that expose the tier \u2014 only the `ultrathink` keyword could. Opting in adds `max` to the classifier's vocabulary, gated on the target model actually supporting it; the default keeps today's prompt byte-for-byte. The ceiling is enforced inside the effort clamp rather than on the classifier's answer, so a sparse ladder cannot snap an excluded request back up, and the Low floor is still resolved against the model's own ladder. The on-device 3-bucket classifier stays capped at `xhigh` regardless of the setting. The ceiling governs what `auto` resolves: a ladder with nothing underneath it yields no auto level, and a `thinking.requiresEffort` model still gets its lowest supported effort from the transport.\n\n### Changed\n\n- Improved grouped read-call layout by nesting each request's usage metrics beneath its final path.\n- Improved turn recovery to prevent duplicate output streaming during credential rotation or model fallback when visible text has already been streamed.\n- Optimized tool guidance for bash, grep, and glob to be more concise while clarifying shell boundaries and search timeouts.\n- Optimized models configuration resource probing to run in a single child process, reducing startup contention.\n- Startup release notes now default to a compact change-count summary. Use `startup.changelogMode` (`summary` | `expanded` | `hidden`) to control them; legacy `collapseChangelog` choices migrate automatically ([#6771](https://github.com/can1357/oh-my-pi/issues/6771)).\n\n### Fixed\n\n- Fixed Anthropic prompt-cache cold misses on session resume with multiple OAuth accounts: the account that served a session is now recorded in the session file (as a `credential_pin` sha-256 of the account + org/project scope, so exports carry no plaintext identity) and re-pinned on resume with the session's effective last-use time, so a fresh process no longer re-ranks accounts by usage headroom \u2014 which systematically routed away from the just-used account and cold-missed the entire account-scoped cache prefix. Sticky routing was previously stored only in the auth store's KV cache, which is in-memory when a remote auth broker is configured.\n- Fixed Anthropic prompt-cache cold misses on session resume with multiple OAuth accounts: the account that served a session is now recorded in the session file (as a PII-free `credential_pin` hash) and re-pinned on resume, so a fresh process no longer re-ranks accounts by usage headroom \u2014 which systematically routed away from the just-used account and cold-missed the entire account-scoped cache prefix. Sticky routing was previously stored only in the auth store's KV cache, which is in-memory when a remote auth broker is configured.\n- Fixed concurrent `createAgentSession` calls with the default agent id failing initialization with `Agent \"Main\" was replaced during session initialization` \u2014 each in-process embedder (e.g. the edit benchmark runner) can now pass a private registry via the newly exported `AgentRegistry`, keeping every top-level session's \"Main\" out of the process-global roster race.\n- Fixed task tool blocks duplicating their per-agent progress rows into terminal scrollback on every update: live task frames now pin the transcript live region so mid-run rows are never recorded as frozen snapshots, and a detached background task freezes its progress the moment any of its rows commit to scrollback instead of mutating committed history.\n- Fixed Codex reset fireworks comparing different quota tiers or plans, preventing false celebrations when usage reports switch between Spark and base weekly limits.\n- Fixed Cursor ranged-read results losing the full file byte size after applying the requested window.\n- Fixed empty Codex final-stop recovery discarding an earlier commentary message when both messages shared response metadata.\n- Fixed Advisor availability with providers that refuse echoed reasoning by retrying once with primary thinking stripped and surfacing persistent refusals immediately.\n- Fixed `/tan` agents being unable to read parent-session `local://` attachments by correctly resolving local protocol options against the parent session's artifacts.\n- Fixed Codex web search silently returning plain completions when the hosted web search tool was skipped.\n- Fixed TUI collaboration guest loader not starting when joining or reconnecting mid-turn.\n- Fixed multi-second TUI freezes in reftable-format repositories by moving branch resolution off the render path and adding a timeout to synchronous git spawns.\n- Fixed `xd://` device summaries containing control characters and exceeding size budgets by stripping control characters and bounding summaries by UTF-8 bytes.\n- Fixed `task.softRequestBudget` configuration having no effect on bundled scout and sonic subagents.\n- Fixed quick LSP server exits being misreported as reader failures and resolved an issue where explicit reloads were blocked by initialization backoff.\n- Forced Git subprocesses to use the stable `C` locale to ensure predictable, non-interactive command output.\n- Fixed compatibility replay issues for pre-upgrade launch brokers evaluating xterm inside the client process.\n- Fixed Advisor cost tracking in the status line across conversation boundaries, ensuring session transitions, forks, and resumes correctly restore or isolate conversation spend.\n- Fixed validation failures for legacy extensions importing from the package root, which previously blocked installations.\n- Fixed ACP clients (such as Zed), TUI status lines, and collaboration guests not updating when model changes occur dynamically within the agent loop.\n- Fixed assistant-facing resource summaries omitting parameterized MCP resource templates, ensuring failed reads list templates alongside concrete resources.\n- Fixed redundant `xd://` mount notices and prompt-cache invalidation when resuming sessions or reconnecting devices.\n- Fixed the model picker displaying placeholder model lists instead of the actual credential-aware catalog resolved at registration.\n- Fixed file corruption and snapshot mismatches when writing files through the ACP client bridge by verifying the final on-disk content after client-side post-save formatting.\n- Fixed `omp ttsr test` silently evaluating source files as prose when their extensions were missing from the allowlist, and expanded the allowlist to support .NET, Shell, SQL, Zig, Dart, Scala, Elixir, and Protobuf files.\n- Fixed automatic light/dark theme switching in direct WezTerm sessions on macOS when DEC Mode 2031 is unsupported, and improved theme-change color responsiveness.\n- Fixed configured `retry.maxDelayMs` not being forwarded into Anthropic retry handling, so over-budget server retry delays fail fast.\n- Added tokens-per-second throughput to RPC `get_state` responses for non-TUI clients.\n- Added the RPC `set_fast_mode` command and typed TypeScript/Python client methods for live fast-mode control.\n- Added `fastModeEnabled` and `fastModeActive` to RPC `get_state` responses.\n- Fixed RPC fast-mode state reporting after direct Anthropic rejects `speed: \"fast\"`, while allowing explicit re-enable requests to retry priority service.\n- Added opt-in subagent access to `checkpoint`, `rewind`, `learn`, and `manage_skill` when explicitly listed in an agent definition's `tools:` frontmatter. Listing one of `checkpoint`/`rewind` auto-includes the other. Settings (`checkpoint.enabled`, `autolearn.enabled`) remain master toggles.\n- Added a `browser.cdpUrl` setting that points browser automation at an already-running CDP endpoint by default, so `app.cdp_url` no longer has to be repeated on every call. Explicit `app` options still take precedence.\n- Native compaction preserves provider-native success and non-authentication failure semantics while retaining authenticated cross-provider fallback when the native provider rejects credentials.\n- Fixed the Cursor Pi exec bridge silently dropping frame arguments. `pi_read`'s `offset`/`limit` were ignored, so a ranged read returned the whole file; `pi_grep`'s `literal` was ignored, so a fixed-string search ran as a regex and matched the wrong lines; and the path/glob join produced a `./`-prefixed spec. Ranges are now composed onto `read`'s `:N+K` inline selector, literal patterns are escaped, and the join uses `node:path`. These are `optional int32` fields, so a present `0` is honored rather than folded into a default: `pi_read` with `limit: 0` answers with empty output instead of the entire file, and `pi_find` with `limit: 0` clamps to 1 the way the reference client does.\n- `pi_grep`'s `context` and `limit` are honored. Neither is expressible in the model-facing `grep` schema \u2014 context width comes from `grep.contextBefore`/`grep.contextAfter` fixed at tool construction \u2014 so the bridge builds a per-call `grep` for frames that supply them. `GrepTool` accepts these as constructor options; the model-facing schema is unchanged, and a frame that supplies neither keeps the shared instance and the session's defaults.\n- `pi_ls`'s `limit` is still not mapped, now deliberately: it caps directory *entries*, while the local `read` tool renders a depth-2 tree with per-directory caps and elision rows and applies a selector as a *rendered line* slice. Mapping it to `:1+K` would cap a different unit while appearing honored.\n- The legacy pi shim's regex-literal escaper and path/glob join were verbatim copies of the modern bridge's. Both paths now call the shared helpers, so the two Pi translations cannot drift.\n- Fixed every Cursor `pi_edit` frame failing instead of editing. Two independent causes: the session drops `edit` from the tool registry for Cursor so the model uses full-file `write`, but that registry is also the exec bridge's tool source, so the native frame \u2014 which the server sends regardless of the advertised catalog \u2014 found no tool; and the retained instance followed the session's configured edit mode, while `PiEditExecArgs` carries `old_text`/`new_text` pairs that only `replace` accepts (the default `hashline` takes a single `input` string). The bridge now resolves a `replace`-mode instance through its fallback resolver, still wrapped for approval.\n- Fixed a `pi_grep` frame carrying `context` or `limit` escaping the approval gate. Honoring those fields needs a per-call `grep`, and the per-call instance was built raw while every registry tool is wrapped, so such calls bypassed `tools.approval.grep` and the exec-tier check for SSH-targeted paths. Both bridge callsites now build it through one shared factory that applies the same wrapper.\n- Fixed Cursor advisors ignoring `pi_grep`'s `context` and `limit`. Only the primary session supplied the per-call `grep` factory, so advisor frames silently fell back to session defaults. Advisors now receive the same factory, gated on the advisor actually having been granted `grep`.\n- Fixed Cursor advisors failing every `pi_edit`. The advisor roster handed the bridge the `edit` instance built for the advisor's own loop, which follows the configured `edit.mode` (`hashline` by default) and rejects the frame's `old_text`/`new_text` pairs \u2014 the same mode mismatch the primary bridge already fixed, on the path it missed. The exec map now substitutes a `replace`-mode instance, gated on the advisor actually having been granted `edit`, while the advisor's own loop keeps the tool it was given.\n- Fixed `pi_bash` killing commands that explicitly asked for no deadline. `timeout` is `optional int32` and `bash` documents `0` as \"disables the command deadline\", but a truthiness check folded a supplied `0` into unset, applying the 300s default instead. A present `0` now passes through; negatives, which have no local meaning and would otherwise clamp to the 1s floor, still fall back to the default.\n- Fixed the Cursor exec bridge granting `edit` and `grep` to sessions that withheld them. Both bridge-only tools are constructed rather than looked up, and `executeTool` prefers a constructed override over the registry, so a restricted tool set (`toolNames` without them, or `restrictToolNames`) still got a working `pi_edit`/`pi_grep` \u2014 native frames arrive regardless of the advertised catalog. Both are now gated on the session having actually granted the tool, matching the `delete` frame's existing check (issue #5680).\n- Fixed Cursor advisor bridge tools bypassing approval settings. The advisor's `pi_edit`/`pi_grep` instances are approval-wrapped, but the wrapper reads `tools.approvalMode`, per-tool `tools.approval.` policies and `autoApprove` only from the execute-time tool context \u2014 which the advisor bridge never supplied, so every native advisor frame resolved as `yolo` with empty policies and ran past a configured `ask` or `deny`. Advisors now receive the same context store as the primary bridge.\n- Fixed Cursor's `list_mcp_resources`/`read_mcp_resource` frames answering as though the client hosted no MCP servers. The bridge hardcoded an empty catalog and `not_found`, so resources from servers the session held live connections to were invisible to the model even while the same session read them through `mcp://`. Both frames now answer from the session's `MCPManager` \u2014 awaiting a server's background resource discovery rather than reading the not-yet-populated cache and reporting \"advertises nothing\" \u2014 and a lookup failure surfaces as an error rather than an empty catalog, which would read as \"asked, none exist\". A read carrying `download_path` writes the resource to that path and answers with the path alone, per the wire contract, instead of putting the payload back in the model's context. That path arrives from the server while the general-purpose resolver deliberately honors absolute paths and `..`, so downloads are confined to the workspace: the resolved target and its deepest existing ancestor must stay inside it, and a target that is itself a symlink is refused. The write then opens `O_NOFOLLOW` and refuses a non-regular or hard-linked file before truncating, so the final component cannot be swapped for a link or an inode shared outside after the check. A parent directory replaced by a symlink mid-write is still followed; closing that needs `openat`/dirfd walking, which this does not attempt.\n- Fixed the Cursor native `delete` frame bypassing approval settings. Unlike every other frame it removes the file directly instead of running a registry tool, so no approval wrapper sat in front of it \u2014 the bridge's `allowDirectFileMutation` grant answers whether a mutating tool was granted, which is a different question from whether the user's policy allows the call. A configured `tools.approval.delete: deny`, or an `always-ask` session that this channel cannot prompt in, now refuses the frame and keeps the file.\n- Fixed Cursor download-mode resource reads bypassing the session's mutation restrictions. A `read_mcp_resource` frame carrying `download_path` creates and overwrites workspace files without running a registry tool \u2014 the same hole the native `delete` frame had \u2014 so a session that withheld `write`/`edit`, or one whose `write` tier is `deny`/`always-ask`, still had files written. Both frames now share one grant (`allowDirectFileMutation`, renamed from `allowNativeDelete` now that it gates more than deletion) and one `write`-tier policy check, and the download refuses before the read so a blocked call does not fetch the resource either. The primary session derives that grant before it rewrites its registry: Cursor moves `edit` out of the tool map and `write` may be auto-registered later, so reading the map at bridge-construction time would have misjudged both.\n- Fixed `pi_ls` never reporting that a listing was clipped. The bridge read the entry cap from a flat `details.resultLimitReached`, which `glob` sets but `read` \u2014 the tool serving `pi_ls` \u2014 does not: it records the cap through `OutputMeta` at `details.meta.limits.resultLimit.reached`. Every capped listing therefore reached Cursor with `entry_limit_reached` unset, reading as complete. Both shapes are now checked, the same way the truncation translation already handles its two producers.\n- Fixed a mixed-content MCP resource read reaching Cursor mislabelled. The mime type was taken from the first content item while the payload came from whichever item supplied it, so an image blob followed by a text note sent the text as `image/png`. Each branch now reports the type of the part it actually sends.\n- Fixed `pi_read`'s `offset`/`limit` returning more lines than the frame asked for. The range is composed onto the local `read` tool's inline selector, and a plain `:N+K` deliberately pads with one leading and three trailing context lines \u2014 helpful when a human reads a snippet, wrong for a caller that named an exact range: offset 5/limit 20 handed Cursor lines 4-27. Ranged Pi reads now compose `:raw:N+K`, which slices exactly the requested lines.\n- Fixed `pi_grep` returning fewer matches than it asked for when they spread across many files. The local `grep` windows results to the first 20 files and tells the caller to paginate with `skip`, but `PiGrepExecArgs` has no `skip` field \u2014 so a frame asking for 100 matches over 25 one-match files got 20, `match_limit_reached` unset, and advice it could not act on: output silently short and labelled complete. A search carrying a total match cap now reads enough files to satisfy it (cap+1, so a result landing exactly on the cap is distinguishable from a clipped one) and reports the cap when it actually bites.\n- Fixed every native `pi_edit` failing after a session switched onto Cursor. The replace-mode `edit` instance the frame needs was built only for sessions *created* on Cursor, and the tool roster is not rebuilt on a model switch \u2014 so a session that started elsewhere kept its configured-mode `edit` in the registry, which the bridge resolves before its fallback, and the frame's `old_text`/`new_text` pairs failed validation against a `hashline` schema. The instance is now built from the `edit` grant regardless of the session's initial provider (lazily, so a session that never reaches Cursor never constructs one) and `pi_edit` asks for it explicitly through a dedicated accessor. A session that was never granted `edit` is still refused.\n- Fixed the Cursor bridge's tool resolver being able to execute an unadvertised `edit`. That resolver doubles as the agent loop's fallback for any call outside the advertised set, so serving `edit` from it meant a hallucinated call \u2014 or one naming a tool the session deselected after startup \u2014 could run a replace-mode edit the model was never offered. It is device-only again; `pi_edit` uses its own accessor.\n- Fixed the legacy Cursor `read` frame ignoring the `offset`/`limit` modern builds paginate with. Only the Pi variant composed a range, so every page of a legacy read returned the whole file (or its own truncation) and a model walking a large file never advanced past the first window. Both frames now translate a range through the same helper, and the answer sets `range_applied` to describe whether a window was actually composed.\n- Fixed the legacy Cursor `grep` frame ignoring its pagination `offset`. The local `grep` paginates by file through `skip` and advertises exactly that in its own \"use skip=N\" advice, so an unforwarded offset re-ran the identical search and answered page one for every page. The answer now reports the offset it applied in `offset_applied`.\n- Fixed a paginated Cursor `read` or `grep` frame being recorded as an unpaginated one. The executed call and the transcript block are built separately, so forwarding the frame's range and page fixed only the execution: the block still showed a bare path and an unskipped search, which is what a reloaded session replays and what the next turn reasons from \u2014 a slice of a file presented as the whole thing, and results from a later window presented as page one. Both are now synthesized from the same translation that runs them, including a `limit: 0` read, which is recorded as the zero lines it returns rather than a whole-file read.\n- Fixed Cursor advisors answering every MCP resource frame as though the client hosted no servers. Only the primary bridge received the `MCPManager`-backed resource adapter, so an advisor's `list_mcp_resources` reported an empty catalog and its `read_mcp_resource` a `not_found` even though the advisor shares the session's live connections. Advisors now receive the same adapter; it is not gated on a tool grant, since reading what a server advertises is a different permission from calling one of its tools.\n- Fixed advisor tools bypassing the approval gate. They are built straight from the builtin table, outside the loop that wraps every registry tool, and both the advisor's own agent loop and its Cursor exec bridge (`pi_write`, `pi_bash`) run those instances directly \u2014 so an advisor granted `write` or `bash` executed them regardless of a configured `ask` or `deny`. They now carry the same `ExtensionToolWrapper` as every other tool.\n- Added `mcp_notification` extension event and multi-listener `MCPManager.addNotificationListener` API. The runtime already received MCP server-initiated JSON-RPC notifications at the transport layer but had no path to forward them to extensions; every notification (including server-custom methods) is now delivered as `{ server, method, params }` after the manager's own list/update handling. For known list-change methods (`notifications/tools/list_changed`, `notifications/resources/list_changed`, `notifications/prompts/list_changed`) the internal refresh promise is awaited before fanout, so a listener acting on `tools/list_changed` sees fresh `getTools()`. Notifications received before any listener attaches are buffered (bounded FIFO, cap 100, drop-oldest \u2014 matches `IrcBus`'s `MAILBOX_CAP`) and drained into the first subscriber, so startup-time frames aren't lost even if the extension binds after MCP discovery. Extensions can use this to bridge push-capable MCP servers (e.g. peer messaging) into session behavior by injecting a mid-turn steer via `pi.sendMessage` / `pi.sendUserMessage`.\n\n### Removed\n\n- Removed the dangling `MCPManager.setOnNotification` single-slot setter, which had no callers in the runtime. Replaced by `MCPManager.addNotificationListener` \u2014 multi-listener, per-listener error isolation, returns an unsubscribe function.\n\n## [17.1.8] - 2026-07-28\n\n### Breaking Changes\n\n- Changed tab.screenshot() to no longer accept a per-call save path; it now saves screenshots under browser.screenshotDir (or the OS temp directory if unset) and returns the saved path.\n\n### Added\n\n- Added omp cleanse, a new command that automatically detects language-ecosystem checkers, parses diagnostics (such as Cargo Clippy JSON), distributes repair workloads across concurrent subagents, and runs verification checks with a live progress bar.\n\n### Changed\n\n- Reworked the /guided-goal command from a modal-based popup flow into a natural, conversational chat interface where the agent asks follow-up questions directly in the session.\n- Reduced startup memory usage by lazy-loading HTML session export assets only on their first use.\n\n### Fixed\n\n- Fixed Advisor notes appending stale-review-window warnings when newer primary turns are queued during a review.\n- Fixed layout padding alignment issues in bordered output blocks and web-search result panels.\n- Fixed excluded web search providers remaining visible in the Web Search Provider Order settings list.\n- Fixed internal Hub peer messages being exposed as ordinary tool-call updates in clients like Paseo.\n- Fixed compatibility issues when installing legacy pi extensions by updating the legacy shim to correctly bridge missing runtime symbols and exports (such as isContextOverflow, isRetryableAssistantError, and JSON parsing utilities).\n- Fixed an issue where routine daemon operations (like list, logs, stop, or describe) could inadvertently trigger a restart loop for detached daemons in a backoff window.\n- Fixed marketplace plugin MCP discovery to correctly honor the mcpServers manifest field in plugin configuration files.\n- Fixed user-initiated shell executions (! and $) being misattributed as agent actions in advisor transcripts.\n- Fixed unnecessary prompt-cache invalidations by preserving the active auto-thinking effort level when per-turn classification fails.\n- Fixed the omp process name showing up as bun in Linux process managers (like ps and top).\n- Fixed agent shell commands inheriting environment variables from the launch directory's .env file, ensuring they only receive the parent environment and explicit tool overrides.\n- Fixed the /new command retaining completed or failed async jobs from the previous session.\n- Improved error handling in omp update to display a friendly timeout message if the download times out while streaming the binary.\n- Fixed the write tool incorrectly treating semicolon-joined read selectors as filesystem paths and creating unintended directory structures.\n- Fixed omp worktree clear prematurely deleting active task-isolation sandboxes owned by running subagents.\n- Fixed /vibe mode preventing the director from completing parent tasks after verifying worker results by keeping the built-in todo tool active.\n- Fixed numeric GitHub issue and pull request autocomplete being suppressed inside skill slash-command arguments.\n\n## [17.1.7] - 2026-07-27\n\n### Fixed\n\n- Restoring a prompt with image attachments via esc-esc branch or `/tree` now re-attaches the images to the composer draft: previously only the text (with its `[Image #N]` markers) was restored, so resubmitting sent the literal marker with no image.\n- Fixed large bash/eval/ssh output citing two different artifact ids in one result \u2014 the truncation notice said `Read artifact://N for full output` while the footer said `Artifact: N+1`. The streaming sink's head and tail windows each had a full budget, so a middle-elided inline body could reach `headBytes + spillThreshold` and always re-tripped the final-defense inline byte cap, which truncated a second time (two elision markers), saved a duplicate already-truncated artifact, and left the notice's line ranges stale. The head and tail windows now share the spill-threshold budget (head clamped to half), the cap budget derives from the configured threshold plus notice slack, and when the cap does fire on a sink-spilled result it references the existing raw artifact instead of saving a copy.\n\n### Added\n\n- Added the bundled `ts-no-local-is-record` TTSR rule, which catches local `isRecord` function and lambda definitions and directs agents to shared guards plus explicit shape validation.\n- A `tool_call` handler (extension or hook) can now return `input` to revise the arguments a tool executes with, not just `block` it. The returned object is the raw execution input passed to the tool (ignored when `block` is set, and not applied to `computer` tool calls), enabling wrappers that normalize or rewrite a built-in's arguments without reimplementing the tool. For model-issued calls the event fires at arg-prep time in the agent loop, so a revision is revalidated against the tool schema and is what concurrency scheduling, `tool_execution_start`/transcripts, the persisted assistant message, and the approval gate all observe \u2014 the user approves exactly what runs, and a revision that changes a tool's functional concurrency (e.g. bash `pty`) schedules correctly. A revised nested `write xd://` device dispatch forfeits the outer write gate's approval and faces the full prompt again ([#6681](https://github.com/can1357/oh-my-pi/pull/6681) by [@psyrendust](https://github.com/psyrendust)).\n- Added a parser for macOS `sample`(1) call-tree reports to the read tool: `*.sample.txt` reads now return a compact bottleneck summary \u2014 per-thread hot paths with on-CPU sample counts (blocked syscall time excluded), demangled Rust v0/legacy symbols, flattened direct recursion, merged call-site siblings, idle-thread classification, and a process-wide top-functions-by-self-samples table. `:raw` still reads the original report, and files that merely carry the extension fall back to plain text.\n- Added V8 `.cpuprofile` support to the read tool (Node/Bun `--cpu-prof`, Chrome DevTools, CDP `Profiler.stop` output): reads now return a compact bottleneck summary \u2014 hot-path call tree with on-CPU milliseconds (`(idle)` time excluded), collapsed pass-through chains, flattened direct recursion, shortened file URLs, and a top-functions-by-self-time table. `:raw` still reads the original JSON, and files that merely carry the extension fall back to plain text.\n\n### Changed\n\n- Direct and `xd://` dispatch now share one canonical tool map: `write xd://` executes any enabled top-level or mounted tool, and `read xd://` returns its docs, instead of failing when the name was exposed through the other layer. Mounted names are presentation metadata only, so tool replacement and disconnection cannot leave stale device instances; disabled tools remain unreachable, and both `xd://` and Cursor/top-level fallback execution retain the tool's approval and ACP permission gates.\n- Session listing now caches parsed headers keyed on file stat identity (mtime + size), so repeated resume-picker opens and startup scans re-read only changed session files\n- Reduced per-keystroke editor dispatch overhead: keybinding resolution happens once per input chunk and the per-action interception chain is gated behind a single canonical-key set probe\n- `xd://` device docs now render the parameter schema as a comment-annotated TypeScript type (via `jsonSchemaToTypeScript`, the same renderer the in-band tool inventory uses) instead of a raw JSON Schema dump, shrinking system-prompt device sections while keeping descriptions inline.\n- Added a `/vision [on|off|auto|status]` slash command for session-scoped control of the `inspect_image` vision-delegation tool, modeled on `/computer`: `on`/`off` force the tool for the current session only, `auto` returns to the persisted setting, and `status` reports the effective mode, session override, tool state, and active-model image capability.\n- Replaced the `inspect_image.enabled` boolean with the tri-state `inspect_image.mode` (`auto`|`on`|`off`, default `auto`). In `auto` the tool is registered only when the active model lacks native image input, so vision-capable models (e.g. `kimi-code/k3`) read images inline with their own capabilities instead of delegating to a separate vision model; the tool set is re-evaluated on every model switch with a status notice when it flips. The `read` tool now follows the effective state dynamically rather than the raw setting, so it returns decoded image blocks again whenever `inspect_image` is hidden. Existing `inspect_image.enabled: true/false` configs migrate to `inspect_image.mode: on/off`.\n\n## [17.1.6] - 2026-07-27\n\n### Added\n\n- Added separate Advisor cost visibility to the status line, rendering primary and Advisor spend as `$2.67 (sub) + $0.41 (adv)` while keeping already-incurred Advisor cost across runtime disablement and same-session history rewrites.\n\n### Changed\n\n- Made the task tool's per-spawn `effort` parameter opt-in through `task.enableEffort`, which defaults to false and omits the field from flat and batch schemas and tool guidance until enabled.\n- Reduced terminal-title update overhead by deduplicating unchanged titles on every platform and using `SetConsoleTitleW` through `bun:ffi` instead of OSC writes on Windows. Windows working titles now keep a static `:` separator instead of scheduling spinner updates; other platforms retain the animated separator.\n- Added `task.maxEffort` to cap the task tool's optional per-spawn effort hint after model-specific resolution, so operators can enable effort hints without allowing them to exceed a configured ceiling; the ceiling now also rides into the spawned session so retry-fallback model swaps re-clamp to it instead of escalating past the cap ([#6580](https://github.com/can1357/oh-my-pi/issues/6580), [#6794](https://github.com/can1357/oh-my-pi/pull/6794) by [@wolfiesch](https://github.com/wolfiesch)).\n- Restructured the steering/interjection envelope sent to the model: the injected `.........` wrapper around user text is now a `` explaining the interjection followed by the user's raw message unwrapped, matching the existing ``/`` convention instead of nesting the literal message inside its own tag pair, which some models found confusing.\n\n### Fixed\n\n- Fixed a disabled higher-priority MCP server no longer disabling a same-named lower-priority one: disabled servers are now suppressed after key-level dedupe instead of dropped before it, so a project `foo` with `enabled: false` keeps the user-level `foo` off while still not starving a differently-named equivalent connection.\n- Fixed the MCP tool-name collision winner flipping when the current owner reconnects: the winner is now chosen by a stable server+tool key instead of tool-array insertion order, which reconnects reorder.\n- Fixed MCP resources with custom URI schemes being treated as missing filesystem paths. `read` and `omp read` now resolve server-advertised native resource URIs such as `ags://capabilities/current-host`, while preserving the existing `mcp://` form.\n- Fixed three gaps in native MCP resource URI resolution: server-advertised URIs whose path is exactly `/` (e.g. `catalog://root/`) are now preserved byte-for-byte instead of losing the trailing slash to reconstruction; opaque resource URIs (`urn:example:document`, `custom:item`) are recognized by the `read` and `omp read` resolver gates instead of falling through to filesystem handling; and a failing `resources/templates/list` no longer discards a successful `resources/list`, which previously produced a false missing-resource error.\n- Fixed custom LSP servers sending `languageId: \"plaintext\"` for extensions outside the built-in language map by honoring an optional per-server `languageId` in `lsp.json` for disk and in-memory document opens ([#6800](https://github.com/can1357/oh-my-pi/issues/6800)).\n- Fixed interactive extension confirmations ignoring `dialogOptions`, and cancelled handler-owned dialogs when the extension watchdog times out so stale approval UI cannot outlive a blocked tool call ([#6805](https://github.com/can1357/oh-my-pi/issues/6805)).\n- Fixed the per-handler extension context snapshotting the live `ctx.model` getter, so a handler calling `pi.setModel()` and then reading `ctx.model` saw the stale model; the scoped context now delegates to the base context instead of spreading it.\n- Fixed Python cell errors (`$` commands and the eval tool) leaking runner-internal traceback frames. Cell syntax errors now render as the bare caret display with a `` filename instead of a `_handle_request_async`/`ast.parse` stack dump, and runtime tracebacks start at user code, matching the Ruby runner's user-frame filtering.\n- Dropped unavailable forced tool choices through the queue rejection lifecycle and discarded their remaining sequence yields so a skipped force cannot disable tools on the next request ([#6543](https://github.com/can1357/oh-my-pi/pull/6543) by [@paralin](https://github.com/paralin)).\n- Fixed identical MCP server connections discovered under direct and marketplace-plugin names spawning twice and duplicating mounted tool routes; distinct tools whose server names sanitize to the same route now keep the first registration and log both origins ([#6786](https://github.com/can1357/oh-my-pi/issues/6786)).\n- Fixed `/usage` and the other large transcript command panels (`/session`, `/advisor status`, `/jobs`, `/changelog`, `/context`, `/memory view`) duplicating in native scrollback when invoked while an agent turn is streaming. These callsites mounted their finalized panel immediately via `present()` instead of deferring it until the turn ends via `presentCommandOutput()` (the path added in #5427 for `/tools`/`/mcp`), so the panel landed above a still-growing live block and was recommitted lower down ([#6767](https://github.com/can1357/oh-my-pi/issues/6767)).\n- Fixed plan-mode task subagents unregistering extension-provided models, credentials, managers, and custom APIs from the shared parent `ModelRegistry` when restricted sessions intentionally skip extension loading ([#6783](https://github.com/can1357/oh-my-pi/issues/6783)).\n- Fixed `/live` sideband WebSockets ignoring standard proxy environment variables and `NO_PROXY`, which left proxied sessions stuck while the rest of the Codex connection succeeded ([#6770](https://github.com/can1357/oh-my-pi/issues/6770)).\n- Fixed the bash tool's `kill` builtin rejecting numeric signals and multiple process operands, stopping after the first failed target, and defaulting to `SIGKILL` instead of the standard `SIGTERM`. Negative PID operands (process groups per `kill(2)`) and the `--` end-of-options marker are now handled instead of being misparsed as signals ([#6779](https://github.com/can1357/oh-my-pi/issues/6779)).\n- Fixed `learned.md` saves growing a blank line on every write (trailing-newline split artifact) and hoisting all headings/prose above all bullets, which re-scoped lessons under the wrong heading in hand-organized files. Saves are now byte-idempotent and preserve mixed Markdown ordering: non-list lines keep their positions, new lessons insert newest-first at the head of the first bullet run, and dedupe/cap operate on bullet lines in place.\n\n## [17.1.5] - 2026-07-27\n\n### Added\n\n- Added a configurable per-request timeout for the `inspect_image` tool (`inspect_image.timeoutMs`, default 5 minutes; set to 0 to disable) so a stalled vision-model provider fails fast with a clear error instead of blocking until manual abort ([#4165](https://github.com/can1357/oh-my-pi/issues/4165)).\n\n### Changed\n\n- Reduced default startup resident memory by constructing the default-off ComputerTool ArkType schema only on first parameter access, then reusing it across tool instances without changing validation or tool behavior ([#6742](https://github.com/can1357/oh-my-pi/pull/6742) by [@usr-bin-roygbiv](https://github.com/usr-bin-roygbiv)).\n- Reduced startup CPU and memory by loading the bundled changelog only when needed, while preserving source, npm bundle, standalone binary, and native absolute-path fallback resolution.\n- Moved PTY log replay into the shared project launch broker, so normal CLI and Hub startup no longer load the xterm runtime while launch logs return validated rendered terminal rows.\n\n### Fixed\n\n- Fixed DeepSeek V4 Flash and Step 3.7 Flash models using hashline edit mode by default despite repeatedly misreading its range grammar; both now use the simpler replace-mode fallback unless explicitly overridden ([#6671](https://github.com/can1357/oh-my-pi/issues/6671)).\n- Fixed an Ask form appearing while the main prompt contains a draft hiding that text and consuming the next in-flight keystroke. The draft now remains visible and keeps receiving input until it is submitted or cleared; only then do form controls activate ([#6737](https://github.com/can1357/oh-my-pi/issues/6737)).\n- Fixed `glob` rejecting safe `memory://root//**` patterns. Memory globs now resolve their directory prefix inside the project memory root while rejecting traversal and percent-encoded path separators across the complete glob path.\n- Fixed `omp --resume ` prompting to fork sessions from another existing directory instead of switching the process and cwd-scoped settings into the resumed session's recorded directory ([#6752](https://github.com/can1357/oh-my-pi/issues/6752)).\n- Fixed deferred CLI model roles resolving ambiguous bare model IDs to a preferred but unauthenticated provider instead of the authenticated provider selected by the eager path ([#6727](https://github.com/can1357/oh-my-pi/issues/6727)).\n- Fixed Windows sessions crashing with an unhandled `EPIPE: broken pipe, write` when an LSP server closed its stdin between filesystem mutations; LSP writes now observe asynchronous `FileSink.write()` failures and route them through the existing request/notification failure path.\n- Fixed the bash tool's `stat` builtin failing on native Windows with `stat: unsupported on this platform` (exit 1) for every invocation. The vendored `uu-stat` now ships a Windows-native backend that maps the GNU format directives onto `std::fs::Metadata`, the `windows_by_handle` metadata extensions (inode, hard-link count, and device via `GetFileInformationByHandle`), and the Win32 volume APIs for `--file-system` mode; Unix behavior is unchanged ([#6723](https://github.com/can1357/oh-my-pi/issues/6723)).\n- Fixed auto-retry wedging the session after an assistant-tail removal miss: when a context rebuild recreated the failed turn's message object, the identity-keyed cleanup logged `assistant removal missed` but the retry still scheduled `continue()`, which rejected the terminal assistant error message locally (`Cannot continue from message role: assistant`) before any provider request \u2014 `auto_retry_end` never fired, the TUI kept showing retry progress, and the in-flight `prompt()` hung until a manual follow-up. The retry path now strips a still-failed assistant tail positionally after the backoff, and a continuation that still fails locally closes the retry saga with a failed `auto_retry_end` ([#5382](https://github.com/can1357/oh-my-pi/issues/5382)).\n- Fixed native Anthropic web-search history being recursively truncated during session persistence or retained under a different user turn, preserving opaque replay bytes across reload and stripping them on reparent ([#6703](https://github.com/can1357/oh-my-pi/issues/6703)).\n- Fixed malformed or temporarily unreadable `config.yml` files being treated as empty settings and then overwritten by the next setting change, which could permanently erase broker tokens, model roles, and provider configuration. Invalid YAML is now moved to a timestamped `.broken-*` backup, read failures abort without touching the source, pending changes remain retryable with the last successfully loaded settings, atomic writes preserve symlink targets and handle Windows `EPERM` replacement, concurrent startup failures are fully observed and quarantine races fail closed, and `omp config set/reset` waits for persistence before reporting success.\n- Fixed mounted MCP tools being hard to invoke when server or plugin guidance names their original calls: sessions now include one bounded, exact original-name-to-`xd://` route map for every live mounted MCP tool\u2014including servers without initialize instructions\u2014and refresh it as catalogs change without disabling schema virtualization.\n- Fixed `inspect_image` blocking indefinitely when the vision-model API stalls by combining the caller's abort signal with an `AbortSignal.timeout()` and surfacing a distinct timeout `ToolError` (separate from user-triggered abort) ([#4165](https://github.com/can1357/oh-my-pi/issues/4165)).\n- Fixed MiMo models using hashline edit mode by default despite needing the same replace-mode fallback as Kimi. ([#3772](https://github.com/can1357/oh-my-pi/issues/3772))\n- Fixed `omp` refusing to start on Windows when no `bash.exe` is discoverable \u2014 most visibly with scoop-installed Git, whose manifest shims `sh.exe`/`git.exe` but never `bash.exe`, so PATH lookup missed it. Startup threw `No bash shell found` while merely building the bash tool description, even though bash tool commands always execute in the embedded brush-core shell and need no host bash. Shell discovery now also checks `GIT_INSTALL_ROOT`, scoop and per-user Git for Windows install roots, and `sh.exe` on PATH, then falls back to `cmd.exe` for the spawn-only paths (interactive PTY, ACP client terminals) instead of failing; the cmd fallback is never used to wrap user-shell commands \u2014 brush runs the POSIX line directly.\n- Added a selectable voice setting for `/live` realtime sessions ([#6566](https://github.com/can1357/oh-my-pi/issues/6566)).\n\n## [17.1.4] - 2026-07-26\n\n### Added\n\n- `omp usage` now surfaces auto-disabled credentials as red `\u2717` tombstone rows (identity, how long ago, the shortened upstream cause \u2014 e.g. `Refresh token expired` \u2014 and a re-login hint), including a provider section when no active credential remains. User-driven tombstones (`replaced by newer credential`, `deleted by user`) and API-key rows stay hidden. Requires a broker with `GET /v1/credentials/disabled`; older brokers degrade to no tombstone rows.\n- `omp usage` warns about Anthropic's ~30-day OAuth grant lifetime: accounts whose interactive login (`authorizedAt`) is within a week of the deadline get a yellow `\u26a0 re-login within ` line, and past-deadline accounts a red one. Grants die server-side exactly ~30 days after login regardless of refresh rotation, so this is the only warning before the broker auto-disables the row.\n\n### Changed\n\n- Enabled Computer Use sessions now state the desktop-routing contract in the compact system prompt, retain their controller across model switches, expose effective native/function routing through `/computer status`, and emit structured lifecycle diagnostics without logging captured content.\n\n### Fixed\n\n- Fixed dragging an image whose path contains unescaped spaces (e.g. macOS screenshot names like `Screenshot 2026-07-24 at 1.55.12 PM.png`) into the terminal \u2014 the bracketed-paste image extraction route now has the same whole-text-as-path fallback as the clipboard keybind route, so both routes share identical detection and attach the image instead of inserting the raw path as literal text ([#6578](https://github.com/can1357/oh-my-pi/issues/6578)). The shared fallback only claims payloads that hold a single path: one carrying a second absolute-path anchor after unescaped whitespace (`/tmp/a.png /tmp/b shot.png` \u2014 dragging two files at once when either name has spaces) now pastes as text on both routes instead of being fused into one unresolvable path, which on the clipboard route previously attached nothing and swallowed the text behind an \"Image not found\" status.\n- Fixed transient reasonless request aborts that arrived after a tool call finished streaming ending the turn instead of entering recovery, which left edit calls and task subagents dead until the user manually resumed. The session now continues from the synthetic unexecuted tool result under the normal retry policy without replaying completed side effects ([#6668](https://github.com/can1357/oh-my-pi/issues/6668)).\n- Fixed prewalk silently dropping a same-model hand-off that only lowers the thinking level: the arm/switch guard compared model identity alone and discarded the resolved `thinkingLevel`, so a legal effort-downgrade target (e.g. `prewalk: \"@task\"` resolving to the same model at a cheaper effort) never applied and the session paid the plan/continue nudges for nothing. Prewalk now compares `(provider, id, effective thinking level)`, applies effort-only hand-offs, and emits a notice on a genuine no-op instead of returning silently ([#6659](https://github.com/can1357/oh-my-pi/issues/6659)).\n- Fixed `@czottmann/pi-automode` failing legacy extension validation because the pi-ai compatibility shim omitted `clampThinkingLevel`, then failing every classified tool call because `ctx.modelRegistry` omitted `getApiKeyAndHeaders`. ([#6648](https://github.com/can1357/oh-my-pi/issues/6648))\n- Fixed hide-secrets placeholders conflicting with hashline edit headers by replacing hash-delimited tokens with the unambiguous `$$HASH$$` format ([#6631](https://github.com/can1357/oh-my-pi/issues/6631)).\n- Fixed the advisor silently swallowing its own quarantined turns: when an advisor called an ungranted tool (e.g. `bash`) its whole turn was discarded before dispatch, so its advice never reached the primary agent and the failure surfaced only in advisor diagnostics \u2014 every other non-recovering failure branch notifies the host UI, but quarantine re-primed silently with no bound. A persistently-quarantining advisor now surfaces a `notifyFailure` warning in the main UI (deduped, cleared on the next successful turn) and stops the unbounded silent re-prime loop ([#6661](https://github.com/can1357/oh-my-pi/issues/6661)).\n- Fixed the Docker `natives-builder` stage failing to build releases \u2265 17.1.1: the native audio stack added bindgen (miniaudio needs libclang) and a bundled-opus CMake build (needs cmake + make), none of which were installed in the slim builder image.\n- Fixed a configured `modelRoles.default` naming an extension-registered model (listed in `enabledModels`) silently running on a different in-scope provider's model. The startup model scope is resolved before extensions call `registerProvider()`, so the default role dropped out of scope and `buildSessionOptions` pinned `options.model` to the first scoped model \u2014 which marked the model \"explicit\" and suppressed the post-extension default-role re-resolution. A configured default that can't be found in the startup scope is now deferred so it re-resolves against the fully registered, still `enabledModels`-scoped catalog once extensions load ([#6694](https://github.com/can1357/oh-my-pi/issues/6694)).\n- Fixed Parakeet speech-to-text failing to load `sherpa-onnx-node` from Windows source workspaces when Bun installed the wrapper under `packages/coding-agent/node_modules` but hoisted its native platform package to the repository root ([#6690](https://github.com/can1357/oh-my-pi/issues/6690)).\n- Fixed `omp usage` duplicating org-less legacy accounts as \"no usage data\" rows whenever any sibling report carried an organization (mixed pools of pre-org-capture rows and fresh org-scoped logins): an org-less account is now covered by its own org-less report, while org-attributed sibling reports still never count as its coverage.\n- `omp usage` revalidates the broker credential snapshot before rendering: live usage reports were previously paired with a disk-cached account list up to an hour old, so a just-completed re-login (org-less row upserted to org-scoped) rendered as a phantom duplicate until the cache expired.\n- Fixed Advisor requests reaching Anthropic-compatible endpoints without a provider-facing session identity: the separately constructed advisor `Agent` never had a metadata resolver installed, so its outbound requests omitted the `metadata.user_id` session id that the main and subagent agents carry. Each advisor now emits its own `advisorProviderSessionId` via `metadata.user_id`, resolved live so a token refresh surfaces the current `account_uuid`, giving Main, subagent, and Advisor traffic distinct, stable session ids for proxy routing and attribution ([#6625](https://github.com/can1357/oh-my-pi/issues/6625)).\n- Todo progress now stays in sync when using Cursor models: the Cursor exec bridge mirrors the provider's server-owned todo list into session state, refreshes the interactive todo panel, and persists each snapshot to the session branch so the list survives reloads, rewinds, compaction, and session switches. Existing phase grouping is preserved for tasks the session already knows. Previously the list was in-memory only and the panel stayed stale, because Cursor resolves the todo tool remotely and never emits the local `todo` tool result that both paths key off.\n- Cursor todo calls the server refuses or rejects no longer leave the todo card spinning: the bridge settles every completed native todo call, not just the ones carrying a list. Local phases and the session branch are left untouched in that case, and the settling result deliberately carries no `details.phases` \u2014 echoing the current list back would let a call that changed nothing overwrite live panel state.\n- Fixed the todo renderer emitting mirrored label text verbatim. A Cursor snapshot carries provider-authored task content, phase names, and summary text, and the renderer interpolated all of it straight into terminal output, so a label holding ANSI/C0 sequences rewrote the terminal every time the list rendered or replayed. Every display path now goes through one sanitize-and-flatten-tabs helper \u2014 task labels, blocker notes, phase headers, the zero-task fallback, and the streaming call preview \u2014 while the raw values stay untouched as the lookup keys they are.\n- Fixed a server-resolved Cursor todo card animating for the rest of the session when the server packed the call's start and completion into one HTTP/2 chunk. The bridge's `tool_execution_end` is a synchronous callback fired mid-parse, while the streamed `toolcall_start` that creates the visible card is queued on the event stream and delivered a microtask later \u2014 the interactive controller handled the completion first, found no pending card, and dropped it, leaving the card that appeared moments later with nothing to settle it. An early completion is now held and attached the moment the streamed block creates its card, settling it without repeating the panel refresh or failure warning that already fired on first arrival. Card creation from cumulative `message_update` frames is also guarded by the turn's timeline map, so a call settled mid-stream can no longer be recreated as a second, permanently pending card by the next update re-listing the same block.\n- Cursor todo failures no longer render unsanitized provider text into the status line. The bridge forwards the server's error string verbatim, so an ANSI escape or other C0/C1 control reached the terminal intact and could repaint outside the row, tabs punched holes in the single-line warning, and a long message overflowed it. The detail is now stripped of control sequences, collapsed, and truncated at the render boundary; the persisted result keeps the full-fidelity error for the transcript.\n- Fixed disabling the Advisor from `/settings` updating the persisted setting without stopping the live Advisor runtime until the session restarted: `SelectorController.handleSettingChange` had no case for `advisor.enabled`, unlike other session-managed toggles (`autoCompact`, `steeringMode`, ...), so the change never reached `session.setAdvisorEnabled`.\n- Fixed `bash.patterns` `deny`/`prompt` rules matching only against the whole command string, so a dangerous command in any non-leading position of a compound line (e.g. `cd /tmp && rm -rf /tmp/x`, `sleep 1 & rm -rf /tmp/x`) silently bypassed a `deny` rule and, under `approvalMode: yolo`, executed with no prompt. `deny`/`prompt` rules now also match each command segment, split with a shell-aware tokenizer that honors every command boundary (`&&`, `||`, `;`, `|`, single `&`, subshells, newlines) and quoting; `allow` rules still require the whole command to match and never apply to compound lines ([#6695](https://github.com/can1357/oh-my-pi/issues/6695)).\n- Fixed `omp config list` printing credential settings in plain text. `auth.broker.token`, `searxng.token`, `searxng.basicPassword` and `dev.autoqaPush.token` were disclosed in both the human and `--json` output of a command that dumps every value without anyone asking for a specific credential. Credentials are now marked in the schema with a top-level `credential` flag, which also covers settings that have no settings-panel entry and so cannot use `ui.secret`. Human output shows dots; JSON omits `value` and marks the entry `redacted` rather than substituting a placeholder a consumer could write back. `omp config get ` is unchanged, since that is an explicit request for one value. The settings panel now derives masking from the same flag, so a credential cannot render as plain text on one surface and dots on the other. Only a credential that is actually set is redacted, so a fresh configuration still reports unset credentials as unset rather than implying every one of them is configured.\n- Fixed `/new`, `/drop`, `/fork`, and `/move` crashing or doing unnecessary work when invoked during vibe mode; interactive session transitions now show the existing exit-vibe warning and leave the session unchanged, and reset loops disable themselves instead of resubmitting into that unchanged session ([#6607](https://github.com/can1357/oh-my-pi/issues/6607)).\n- Fixed legacy pi extensions failing extension validation when importing `estimateTokens` from `@earendil-works/pi-coding-agent` (aliased to the legacy shim). Legacy pi re-exported `estimateTokens` from its coding-agent package root; in omp it lives in `@oh-my-pi/pi-agent-core/compaction` and the coding-agent barrel does not forward it, so the shim's `export * from \"../index\"` left it off the surface and a named import threw Bun's static \"Export named 'estimateTokens' not found\" error (e.g. `omp plugin install pi-blackhole`). The shim now re-exports it ([#6583](https://github.com/can1357/oh-my-pi/issues/6583)).\n- Fixed plan approval presenting a completed plan instead of the newest draft when the submitted title did not match the draft filename ([#6569](https://github.com/can1357/oh-my-pi/issues/6569)).\n- Fixed `omp auth-gateway serve` advertising only the compiled-in bundled catalog, so every model omp reaches through provider discovery (e.g. ids released after the build date) was invisible on `/v1/models` and returned `Unknown model` through `/v1/chat/completions` even though the same broker credential answered it in the TUI. The gateway now sources its catalog from `ModelRegistry` \u2014 the same component the TUI/CLI use (bundled + cached + discovered) \u2014 keeping the credential scoping and qualified/bare-id registration, and rebuilds it periodically so a long-lived `serve` tracks newly discovered models without a restart ([#6615](https://github.com/can1357/oh-my-pi/issues/6615)).\n- Fixed screenshot-relative pointer actions missing their visible targets when image transports that cannot preserve original detail silently downscaled a large computer screenshot; affected transports now establish the native coordinate frame below the verified image-resize threshold without changing the public capture defaults for other models ([#6596](https://github.com/can1357/oh-my-pi/pull/6596) by [@wolfiesch](https://github.com/wolfiesch)).\n- Corrected Windows shell resolution errors to identify the active global, project, overlay, or runtime source for `shellPath`, including profile and custom configuration directories, instead of directing every user to the retired `settings.json` file ([#6579](https://github.com/can1357/oh-my-pi/issues/6579)).\n- Fixed `debug` (js-debug/`pwa-node`) stateful commands misrouting after launch: a lazily-attached `[worker N]` child session (or the threadless root launcher) would steal the active-session focus from the stopped script child, so `threads` listed only the worker thread, post-launch breakpoints read back as pending/unbound, and there was no way to step/continue/evaluate the script's thread. Focus now follows stops rather than registrations, and `threads` aggregates every live thread across the session tree ([#6663](https://github.com/can1357/oh-my-pi/issues/6663)).\n- Fixed a turn-ending provider error being truncated to 8 lines in the transcript with no way to reveal the rest: `AssistantMessageComponent` now implements `setExpanded`, so Ctrl+O (tool-output expansion) reveals the full error body and the collapsed view shows a `\u2026 +N more lines (Ctrl+O to expand)` hint ([#6555](https://github.com/can1357/oh-my-pi/issues/6555)).\n- Fixed direct binary updates trusting an executable that only reported the expected version. The updater now selects one exact asset from the tagged GitHub release, requires its published SHA-256 digest and size, and verifies both while streaming the download before installation. GitHub release metadata requests use `GITHUB_TOKEN` or `GH_TOKEN` when available, allowing users behind an exhausted anonymous rate limit to authenticate.\n- Documented that the non-PTY shell's bundled `jq` command is backed by jaq, including its null-indexing divergence and portable filter syntax ([#6614](https://github.com/can1357/oh-my-pi/issues/6614)).\n- Fixed `omp://tools/task.md` and `omp://tools/eval.md` drifting from the 17.1.3 runtime: `task.md` claimed subagents force-disable `async.enabled`/`bash.autoBackground.enabled` (both are inherited from the parent since 17.1.0) and omitted the `task` tool's `effort` parameter, and `eval.md` omitted the still-working eval `agent(model=\u2026)` per-call model selector ([#6594](https://github.com/can1357/oh-my-pi/issues/6594)).\n- Fixed advisor retry amplification after transient Codex SSE socket closures by limiting each advisor-level try to one provider transport attempt.\n- Fixed `omp update` aborting with `npm error EEXIST` on standalone binary installs whose directory coincides with the global npm/bun bin dir (for example `npm prefix -g` set to `~/.local`, which the installer also targets). The install-target resolver classified the binary as npm/bun-managed from directory containment alone, so `npm install -g` tried to replace a regular file its symlink step would clobber; it now treats a plain executable (not a symlink) in a package-manager bin dir as the standalone binary and self-updates it in place ([#6527](https://github.com/can1357/oh-my-pi/pull/6527) by [@am423](https://github.com/am423)).\n- Fixed Codex subscription and proxy models being sent the unsupported native `{ type: \"computer\" }` declaration based only on model ID. They now receive the callable function-tool fallback, including after switching from native OpenAI Responses history, while explicit endpoint metadata can still opt into the GA contract. Explicit native Codex replays preserve `computer_call`/`computer_call_output` pairing, normal CLI startup keeps the native desktop worker graph lazy, and packaged workers re-enter the single CLI host without the computer module claiming non-computer selectors.\n- Fixed isolated JavaScript eval subprocesses letting the global fatal-rejection handler race the cell rejection interceptor. A floated promise rejection is now folded into the owning cell result without killing its reusable worker process.\n- Fixed `/context` counting hidden, explicit-only skills (`hide: true` / `disable-model-invocation`) in the Skills category and subtracting that inflated estimate from the first system-prompt block, which reported `System prompt: 0 tokens` and inflated Skills usage. Accounting now counts only the skills actually rendered into the system prompt \u2014 mirroring `buildSystemPrompt`'s filter, so hidden skills and all skills when the `read` tool is unavailable contribute zero ([#6498](https://github.com/can1357/oh-my-pi/issues/6498)).\n- Fixed `pi-sprite` failing plugin validation because the legacy Pi compatibility shims omitted `createExtensionRuntime` and terminal capability/image-deletion helpers used by the extension ([#6506](https://github.com/can1357/oh-my-pi/issues/6506)).\n- Fixed Escape waiting for an in-flight `session_stop` extension handler to exhaust its timeout; abort now cancels the active stop pass without reporting a false timeout or applying stale continuation context ([#6489](https://github.com/can1357/oh-my-pi/issues/6489)).\n- Fixed the agent not resuming after re-answering a past `ask` from the session tree. Committing a new answer via `/tree` branched a fresh sibling `toolResult` and rebuilt context, but nothing ever continued the agent \u2014 unlike a live `ask`, whose continuation is intrinsic to the streaming run loop \u2014 so the model never consumed the new answer and the session sat idle until a manual prompt. `navigateTree` now reports the commit (`askReanswerCommitted`) and the interactive `/tree` handler resumes the agent via `resumeAfterAskReanswer()` *after* its transcript rebuild, so the resumed turn never renders against the stale pre-rebuild UI. Plain leaf moves and the read-only `reopenAsk` probe stay idle ([#6483](https://github.com/can1357/oh-my-pi/issues/6483)).\n- Fixed Ctrl+C and fatal shutdown entering an `ExtensionExitError` rejection loop while an extension or hook was still loading ([#6488](https://github.com/can1357/oh-my-pi/issues/6488)).\n\n## [17.1.3] - 2026-07-24\n\n### Fixed\n\n- Fixed the in-process `find` builtin's `-exec`/`-execdir` children inheriting the omp process's real stdout/stderr, so commands like `find \u2026 -exec ls -ld {} \\;` spammed their output straight into the terminal (corrupting the TUI) instead of the tool's captured output, and bypassed shell redirects. Exec children now stream stdout/stderr back through the shell's scope streams (matching `xargs`/`ifne`) and run with the shell's exported environment (`env_clear` + scope snapshot) instead of the host process environment.\n- Fixed `ast_edit` erroring with \"`lang` is required\" \u2014 an argument that no longer exists in the tool schema \u2014 when `paths` resolved to files of multiple languages (e.g. a crate directory with `.rs` + `.toml`). Mixed-language paths now rewrite per file: each file is parsed in its own inferred language, patterns are compiled per language, and a pattern that doesn't parse in some matched language simply skips those files.\n- Fixed the `retain` tool's TUI renderer crashing when streaming arguments temporarily expose a non-array `items` value ([#6528](https://github.com/can1357/oh-my-pi/issues/6528)).\n- Fixed Edit and Write tools failing with `Settings not initialized` in isolated sessions by using each tool session's settings for generated-file guards, with safe schema defaults for standalone guards and inline-image rendering ([#6549](https://github.com/can1357/oh-my-pi/issues/6549)).\n\n## [17.1.2] - 2026-07-24\n\n### Added\n\n- Added in-process moreutils-style shell builtins to the bash tool's embedded shell: `ts` (timestamp lines; `-i`/`-s` elapsed modes, `-m` monotonic clock, `-r` relative rewriting of RFC3339/syslog timestamps, `%.S`/`%.s`/`%.T` subsecond extensions), `sponge` (soak stdin fully before atomically writing the target, so `foo file | ... | sponge file` works; `-a` appends), `ifne` (run a command only when stdin is non-empty; `-n` inverts and passes non-empty stdin through), `isutf8` (streaming UTF-8 validation with line/char/byte diagnostics; `-q`, `-l`, `-i`), `combine` (boolean `and`/`not`/`or`/`xor` on the lines of two files, `-` for stdin), and `errno` (errno name/number/description lookup with `-l` list and `-s` search; unix only). Like the uutils-backed builtins, they run in-process against the command's own stdio, resolve paths against the shell working directory, honor cancellation, and are disabled by `PI_DISABLE_UUTILS_BUILTINS`.\n- The bash tool prompt now lists the available shell builtins (`mkdir` through `jq`, `rm`/`mv`/`ln`, and the moreutils set) so the model relies on them without existence checks; the line is dropped when `PI_DISABLE_UUTILS_BUILTINS` disables the builtins and omits unix-only `errno` on Windows.\n- Sessions using a broker-backed auth store now report each completed request's token usage and cost to the auth broker (batched, 10s cadence) so the broker can track actual token burn per client install\n- Added a per-spawn `effort` parameter to the `task` tool (`\"lo\"` | `\"med\"` | `\"hi\"`): each selector maps onto the resolved model's supported thinking range (lowest, middle, and highest level \u2014 whatever the model tops out at, e.g. `high`, `xhigh`, or `max`) and overrides the agent's default selector, including `auto`. Omitting `effort` keeps the existing automatic per-prompt thinking classification.\n- Added `searxng.engines` setting for the SearXNG web search provider: a comma-separated list of engine names or bang shortcuts (e.g. `ddg, br, startpage`) sent as the API's `engines=` parameter. Shortcuts are resolved to canonical engine names via the instance's `/config` endpoint (cached per endpoint; entries pass through verbatim if `/config` is unreachable). Bang syntax in queries (`!ddg foo`) continues to pass through to the instance, and external bangs (`!!g`) are now stripped client-side since SearXNG answers them with an HTTP redirect even for JSON requests.\n- Web search queries now understand Google-style directives on every provider: `site:`/`-site:` (plus `domain:`/`host:` aliases), `after:`/`before:`/`since:`/`until:` date bounds, `inurl:`/`intitle:`/`intext:`/`allin*:`, `filetype:`/`ext:`, `lang:`, quoted phrases (including smart quotes), `+term`, `-`/`NOT` exclusions, and `OR`/`|` groups. A shared parser (`web/search/query.ts`) structures the query once per request; each provider maps constraints onto native API filters where the upstream supports them (Perplexity domain/date/language filters on both the API-key and ask paths, Tavily `include_domains`/`exclude_domains` + `start_date`/`end_date`, Exa domain lists + published-date bounds on API and MCP paths, Anthropic `allowed_domains`/`blocked_domains`, xAI `filters.allowed_domains`/`excluded_domains`, Parallel `source_policy`, Brave absolute `freshness` ranges, Firecrawl `tbs=cdr` date ranges, Jina `X-Site`, SearXNG `language`) and otherwise re-emits only the operator syntax its engine parses (full Google syntax for Gemini grounding, OpenAI, Kagi, and the credential-free scrapers \u2014 with scraper-hostile path-`site:`/`inurl:` operators demoted to plain keywords; conservative subsets for DuckDuckGo, Mojeek, Kimi, Z.AI, TinyFish, and Synthetic). The pipeline then applies a lenient post-filter to every response: constraints the engine ignored are enforced on the returned sources, and any constraint dimension that would eliminate every result is relaxed and reported to the model (`Note: no results matched \\`site:...\\`; the constraint was relaxed`) instead of returning nothing. Directive-free queries are passed through byte-identical everywhere.\n- Eval and browser `run` code previews are now prettified for display: minified/compact agent-written cells are expanded by conservative streaming formatters (Python, JavaScript, Ruby, Julia) that indent block structure, split statements, normalize operator spacing (JS), and expand object literals wider than 100 columns onto one property per line \u2014 purely for rendering, the executed source is untouched. The formatters handle in-flight prefixes (unterminated strings/comments/blocks) without inventing closers, and layout decisions are prefix-stable so already-rendered lines never reflow while a call streams.\n\n### Changed\n\n- Large pastes saved via the large-paste menu now insert `local://paste-N.md` references (previously `local://attachment-N`), so the saved paste carries a markdown extension and a clearer name.\n- Raw SSE debug capture now trims over-budget events smartly instead of chopping off the tail: tool definitions inside `data:` payloads are compacted first (name kept, schema/description elided \u2014 often enough to keep the whole payload as valid JSON), and anything still over the 64k cap keeps its head and tail with a `: omp-debug-elided chars=N` comment marking the removed middle, so trailing fields like `usage` stay visible.\n- The `web_search` tool prompt now tells the model to never search for content that is programmatically accessible or has a known URL (GitHub, known arXiv papers, Wikipedia pages, official docs) and to `read` the URL directly instead.\n\n### Fixed\n\n- Fixed `todo` calls that omit `op` hard-failing validation (\"op must be operation to apply (was missing)\"): the tool now validates leniently and infers the op for unambiguous payloads (`list` \u2192 `init`, `phase`+`items` \u2192 `append`, bare `items` on an empty list \u2192 `init`); `op` stays required in the schema, and ambiguous op-less calls surface the schema error as a retryable tool error.\n- Fixed credential-free web search engines (SearXNG, DuckDuckGo, Google, Startpage, Ecosia, Mojeek, and the Public Web fan-out) returning zero results for queries with `site:` paths (e.g. `site:github.com/owner/repo`) or `inurl:` operators: scraper engines only match `site:` against a bare domain and DuckDuckGo ignores `inurl:` entirely, so such queries silently emptied the result set and fell through to the next provider in the chain. A shared `formatScraperQuery` formatter now structurally demotes path-carrying `site:` and all `inurl:` values to plain search terms (covering OR-grouped and quoted directives) while preserving bare-domain `site:` filters, negated operators, and each engine's supported syntax; the pipeline post-filter still enforces the demoted constraints on returned sources.\n- Fixed `ast_edit` previews reading like applied edits to the model: the `\u27e8proposed\u27e9` badge was TUI-only, so the model-visible result (hashline header + `-`/`+` rows, identical to applied edit output) carried no staged-proposal signal. The preview result now leads with a \"Staged as a proposal \u2014 files NOT modified yet\" notice naming `xd://resolve`/`xd://reject`, the injected resolve reminder names the source tool, and the `ast_edit` tool prompt documents the two-phase flow.\n- Fixed the `hub` launch `ps`/`list` response burying the active process behind every exited one and growing without bound in long-lived projects: the broker now lists non-terminal daemons first (oldest to newest) and caps exited/failed history at the 10 most recently exited, so the active launch is immediately visible and the response stays bounded. Broker recovery also preserves each already-terminal daemon's real exit time instead of overwriting it with the restart timestamp, so the history cap keeps the genuinely most-recently-exited processes after an idle-broker restart ([#6517](https://github.com/can1357/oh-my-pi/issues/6517)).\n- Fixed a tool call rendering twice in the transcript. A mid-stream `rebuildChatFromMessages` (from `/shake`, auto-compaction, or a settings toggle) preserves the live `pendingTools` components across the clear+replay, but that preservation assumed every pending-tool component was still dangling. When a tool's result had already landed in the session entries while its component still lingered in `pendingTools`, the replay reconstructed the completed block *and* the preserved live component was re-appended, so the same block appeared twice; resolved components are now dropped from preservation and owned by the replay ([#6516](https://github.com/can1357/oh-my-pi/issues/6516)).\n- Fixed `--model default` (and other bare role names) resolving to the bundled `cursor/default` catalog model instead of the configured `modelRoles.default` role. `resolveCliModel`'s exact-match phase ran its unauthenticated catalog fallback before role resolution, so a bundled id colliding with a reserved role name shadowed a configured, runnable role \u2014 failing with `No API key found for cursor` on machines without Cursor credentials. The catalog fallback is now deferred so an authenticated exact model still wins, a configured role beats an unauthenticated catalog-only id, and the catalog id is still recovered when no role matches ([#6508](https://github.com/can1357/oh-my-pi/issues/6508)).\n\n### Removed\n\n- Removed the `model` parameter from `task` and `agent()`: explicit per-spawn model selectors and fallback chains are no longer supported; spawns always use the agent's configured model\n\n## [17.1.1] - 2026-07-24\n\n### Added\n\n- Added the `/session pin` subcommand and account picker to pin provider OAuth accounts for the current session\n- Added the disabled-by-default `computer` essential tool with configurable enablement, backend, display, and maximum width/height settings. Native desktop execution runs through a `DesktopSession` worker; observation uses read approval, input uses exec approval, and provider checks always prompt and fail closed.\n- Added the `/computer` slash command (`on`/`off`/`status`/toggle) to enable or disable the computer tool for the current session without persisting settings.\n- Exposed `computer` to models without native OpenAI computer-use support as a regular function tool with a typed GA action schema; the same native desktop backend and approval policy apply on both paths.\n- Hardened computer action ingress: action-specific fields, modifier/key arrays, coordinates, drag points, and scroll deltas fail closed before native input; numeric fields must be signed 32-bit integers and coordinates must be non-negative.\n\n### Changed\n\n- Replaced Chromium-backed `/live` media and external speech recorder/player subprocesses with the cross-platform native microphone, speaker, Opus, and WebRTC stack from `@oh-my-pi/pi-natives`.\n\n### Fixed\n\n- Fixed live-call attestation depending on the ChatGPT desktop app being installed: `generateLiveAttestation` now mints DeviceCheck tokens in-process through the `@oh-my-pi/pi-natives` `deviceCheckGenerateToken` binding instead of probing `/Applications` for the app's `devicecheck.node` addon, so the `x-oai-attestation` header works on hosts without the desktop app and drops the `createRequire` addon probing; the attestation provider is now wired up to `@oh-my-pi/pi-ai` for ChatGPT-OAuth Codex requests.\n- Fixed `xd://` device execution failures rendering as `write` errors instead of using the mounted tool's own error renderer.\n- Fixed custom tools without bespoke renderers losing the default state-tinted card when mounted under `xd://`; dispatched calls now keep their label, arguments, status, output preview, and expansion affordance instead of dumping a bare result line into the transcript.\n- Fixed the clipboard image-paste keybind mangling copied URL text into a bogus path error on macOS (e.g. `Image not found at /https/::i.can.ac:CE4Ek3.png` for a copied `https://i.can.ac/CE4Ek3.png`). AppleScript's `the clipboard as \u00abclass furl\u00bb` coerces plain *text* into a file URL by treating the string as an HFS path (`:`\u2194`/` swap), so `readMacFileUrlsFromClipboard` returned a garbage path that dead-ended in `handleImagePathPaste` instead of falling through to the text paste. The script now bails early via `clipboard info for \u00abclass furl\u00bb` unless the pasteboard actually carries a `public.file-url` representation, so URL/text clipboards paste as text.\n- Fixed spilled tool-output artifact descriptors leaking on error/abort paths. `OutputSink.dump()` was the only path that closed the spill `Bun.FileSink`, but the bash and Python executors re-throw on failure and their `finally` blocks never closed the sink, so a large-output command that errored leaked the artifact descriptor until an unrelated read (e.g. a `SKILL.md` load) hit `EMFILE`. `OutputSink` now exposes an idempotent `dispose()` that closes the sink exactly once, wired into every executor's `finally` ([#6463](https://github.com/can1357/oh-my-pi/issues/6463)).\n- Fixed the first submitted prompt stalling while the local tiny-title worker started: the interactive submit handler now paints the pending user row before starting title generation, and startup prewarms an idle, unref'd worker so the first submit reuses a live subprocess instead of paying spawn latency ahead of the first frame ([#6462](https://github.com/can1357/oh-my-pi/issues/6462)).\n- Fixed legacy Pi extensions failing validation when importing the upstream `keyText` keybinding helper ([#6470](https://github.com/can1357/oh-my-pi/issues/6470)).\n\n## [17.1.0] - 2026-07-24\n\n### Breaking Changes\n\n- Replaced the `providers.webSearch` and `providers.image` single-preference configuration options with `providers.webSearchOrder` and `providers.imageOrder` priority lists. Existing configurations migrate automatically on startup.\n\n### Added\n\n- Added dynamic multi-root workspace context support, allowing users to manage multiple workspace directories mid-session via `/add-dir`, `/remove-dir`, and `/dirs` slash commands, or seed them at launch using the `--add-dir` CLI flag.\n- Added `/live`, a Codex-authenticated real-time voice interface that streams microphone audio over WebRTC and routes coding tasks through the active agent session.\n- Added opt-in usage-aware model fallback for rationed coding plans, including a `/usage` command to view live quantitative usage data and automatic fallback chain traversal.\n- Added `error.notify` configuration to allow failed model turns to trigger distinct terminal or desktop notifications.\n- Added auto-following light and dark themes to HTML session exports, with a `/export --themes` option to bundle selected TUI themes.\n- Added owner-routed asynchronous job delivery, ensuring background bash and task results are injected directly into the owning subagent or agent session rather than the top-level session.\n- Added background-on-steer capability for auto-backgrounded bash commands, allowing incoming user or peer messages to immediately background running commands.\n- Added `friendlyName` support for hidden secrets, allowing model-visible placeholders to carry sanitized semantic labels, hashes, and case hints.\n- Added support for Jujutsu (`jj`) repositories in the statusline `git` segment, displaying the nearest bookmark or change ID and retrieving working-copy change counts.\n- Added `block` and `unblock` operations for tasks, introducing a `blocked` status for tasks waiting on external input to exclude them from incomplete-todo reminders.\n- Added a toggle-list editor in `/settings` for managing array-of-enum settings like search and image provider orders.\n- Added `models.yml` Bedrock Converse prompt-cache capability overrides for bundled and opaque inference profiles.\n- Added `getServiceTiers()` and `setServiceTier()` extension APIs to read and modify the live per-family service tier for session requests.\n- Added opt-in `omp bench --cache` for independent cold/warm prompt-cache benchmarking with stable-prefix controls.\n- Added `tools.xdevDocs` prompt-doc modes and the `tools.xdevInlineDevices` glob allowlist to control which mounted device documentation is inlined into the system prompt.\n- Added the opt-in `read.renderMarkdown` setting for formatted Markdown read previews.\n\n### Changed\n\n- Updated subagent behavior to inherit `async.enabled` and `bash.autoBackground.enabled` from parent sessions, and refined subagent run completion to wait for background jobs to settle.\n- Added ordered `bash.patterns` command approval rules to allow, prompt, or deny bash commands by pattern.\n- Updated Markdown file handling so all Markdown flavors (`.markdown`, `.mdx`, `.mdc`, etc.) respect the `read.summarize.prose` setting.\n- Upgraded xAI web search to use `grok-4.5` at low reasoning effort instead of `grok-4.3`.\n- Improved search provider resilience by cascading and falling back through other configured search providers when the preferred provider fails.\n- Extended the bash tool's `direnv` and `devenv` auto-loading to all backends (including the ACP client terminal and interactive PTY) while honoring `direnv`'s local allow list.\n\n### Fixed\n\n- Fixed a path traversal vulnerability in blob reference resolution by rejecting non-canonical hashes in `parseBlobRef`.\n- Fixed multiple edge cases in the secret obfuscation and redaction engine, including handling of context-sensitive regexes, placeholder key requirements in unwritable directories, friendly-name forgery vulnerabilities, and regex match boundaries straddling existing placeholders.\n- Fixed a first-use race condition in `ArtifactManager` where concurrent callers could allocate duplicate artifact IDs.\n- Fixed Vibe-mode session stability, resolving issues with workers disappearing across restarts, hanging during teardown, clobbering target tools during session switches, and resolving against incorrect models.\n- Fixed concurrent MCP configuration mutations losing updates by serializing read-modify-write operations under a per-file lock with atomic writes.\n- Fixed legacy extensions failing to load on npm/source-link installs due to transitive CommonJS dependency graph clobbering.\n- Fixed `omp auth-gateway` commands bypassing the process-scoped OAuth account pool configured via environment variables.\n- Fixed terminal transcript rendering issues where displaceable snapshots (like waiting polls and todo lists) spammed native scrollback.\n- Fixed the terminal title to reflect the active agent run state (working, waiting, or blocked) when `tui.titleState` is enabled.\n- Fixed the `browser` tool's `open` action ignoring timeouts during browser acquisition and leaking orphaned browser instances.\n- Fixed the `write` tool silently creating empty files when a read-tool selector was mis-dispatched as a write.\n- Fixed snapcompact archiving reproducing assistant reasoning (`\u00b6think:` sections) into replayed frames for Anthropic-dialect models.\n- Fixed Linux socket-mode DAP launches hanging indefinitely on connection failures.\n- Fixed Plan Review annotations being discarded on dismissal and limited to headings.\n- Fixed Assistant-mode TTS playback aborting prematurely when an agent continued after a tool call.\n- Fixed absolute usage amounts rendering inconsistently across CLI, TUI, and ACP output surfaces.\n- Fixed MCP sessions dropping tools from servers that finished connecting after the initial startup window.\n\n## [17.0.9] - 2026-07-23\n\n### Added\n\n- Added per-call `model` selection to the `task` tool, including per-item batch selectors, fallback chains, and explicit reasoning suffixes.\n- Added Firecrawl keyless mode: explicitly selecting `firecrawl` as the web-search provider now works without `FIRECRAWL_API_KEY` by calling the Firecrawl REST API without an `Authorization` header; the automatic provider chain remains credential-gated (#4332).\n- Added `mcp.renderMarkdownResults` (enabled by default): non-JSON MCP text results render as Markdown in the terminal transcript; set it to `false` to keep raw text.\n\n### Changed\n\n- Adjusted retry fallback handling to recognize discovery-only and runtime extension providers, preventing spurious unknown-provider warnings.\n- Restored Auto QA's ask-the-user default: `dev.autoqa` defaults to `true` again, so the first `xd://report_issue` write pops the consent dialog instead of the feature being silently off. Denying consent (or `dev.autoqa: false` / `PI_AUTO_QA=0`) fully disables prompt injection; an explicitly configured `dev.autoqa: true` overrides a past denial. Also restored the #1224 guarantee lost in the xd:// device consolidation: the grievance row is inserted only after consent resolves to granted (or `PI_AUTO_QA_PUSH=1`), so nothing touches the local database while consent is unset or denied.\n\n### Fixed\n\n- Fixed Auto QA grievance recording silently dropping every report since the xd:// device consolidation: `openAutoQaDb` treated the database file path (`~/.omp/autoqa.db`) as a directory and tried to open `autoqa.db/autoqa.db` inside it, which fails on legacy installs (the flat file blocks the directory) and fresh ones alike (SQLite does not create parent directories). Also restored the `busy_timeout` pragma dropped in the same refactor (#2421). Renamed `getAutoQaDbDir` to `getAutoQaDbPath` to match what it returns.\n- Fixed the setup wizard hiding the selected row on short terminals (e.g. 24x80): the provider sign-in, theme, and web-search lists now fit their windows to the visible height, and decorative chrome (sign-in hint, theme mock preview) yields to the list when space is tight.\n- Fixed restored sessions replaying terminal aborted or errored assistant turns, which could repeatedly fail continuation from an assistant role; `/retry` now consults the persisted transcript so the failed turn remains retryable without re-entering provider context.\n- Fixed `get_available_models` and `set_model` RPCs racing background model discovery on cold start by awaiting the in-flight refresh before reading the registry. RPC/ACP clients that query the catalog or select a model immediately after session ready previously saw only statically-bundled models until discovery completed seconds later.\n- Fixed deferred `--model /` CLI resolution failing on cold start with \"Model not found\" when the selector pointed at a discovery-backed provider (proxy / ollama / lm-studio / llama.cpp / litellm). The deferred retry now runs a cache-aware discovery pass before resolving, mirroring the default-role fallback's cold-cache race fix (issues #6114, #6162).\n- Fixed MCP tool calls that return a `WWW-Authenticate` challenge by preserving the structured metadata, completing the configured OAuth flow, and retrying the call once on the refreshed connection.\n- Fixed the Hindsight API token setting being absent from the Memory tab, so authenticated servers can be configured entirely in the TUI.\n- Fixed aborted-task follow-up hints pointing at `history://` transcripts that cannot resolve: the hint now reports the transcript as unavailable when the agent ref retains no session file, while still-resumable agents keep their `hub` resume hint.\n- Fixed compiled binaries failing to load legacy Pi extensions with minified imports, `pi-ai/compat`, or transitive runtime dependencies. The compatibility loader now follows compact static imports, resolves transitive on-disk ESM imports and CommonJS requires with package conditions, and restores the legacy `copyToClipboard` and `decodeKittyPrintable` root exports used by `pi-vimmode` and `pi-web-access`.\n- Fixed a budget-aborted keep-alive subagent becoming an unkillable registration with no `hub`-level stop. A subagent force-stopped for exceeding its soft request budget is kept resumable (status `idle`, adopted by the lifecycle) so its context can be salvaged, but its async job row settles and is reaped after ~5 min \u2014 after which `hub cancel ` could only report `Background job not found` because it consulted the job manager alone. `hub cancel` now falls through to the agent registration: for an id the caller spawned that has no live job, it aborts any in-flight turn, disposes the session, and drops the registration (the interactive Agent Hub `x` and collab `kill` already did this; the model-facing `hub` did not). Cross-agent kills stay impossible and Main/advisor refs are never targeted ([#6315](https://github.com/can1357/oh-my-pi/issues/6315)).\n- Fixed Agent Hub fallback rows hiding routing provenance and the resolved provider/model ([#6316](https://github.com/can1357/oh-my-pi/issues/6316)).\n- Reduced format-on-write latency by avoiding cold language-server startup when diagnostics are disabled.\n- Rewrote the `/guided-goal` interviewer rubric around loop-engineering: deterministic success criteria, verification commands, attempt caps, scope boundaries, and stop conditions. Ready objectives must use the five-section structured markdown form.\n- Added `task.isolation.apply` (default `true`) to choose whether successful isolated `task` runs automatically apply their changes to the parent checkout or retain patch/branch artifacts for later integration.\n- Added opt-in RPC protocol v2 negotiation with bounded, lossless chunking for stdout objects up to 64 MiB, plus stable cursor-based message pages for histories that should not travel as one response. Legacy JSONL clients remain on protocol v1, while the bundled TypeScript and Python RPC clients negotiate, reassemble, and drain message pages automatically.\n- Fixed protocol v2 chunked framing materializing the whole base64 transport in memory: near-limit logical frames (~63 MiB) peaked around 686 MB RSS and over-ceiling frames allocated the full payload buffer before rejection. Chunk lines are now produced lazily from a single serialization, the 64 MiB ceiling is checked before any full-payload allocation, and RPC stdout writes honor backpressure line by line.\n- Fixed the bundled TypeScript and Python RPC clients throwing when a `get_messages_page` cursor went stale mid-walk (e.g. a background bash appending a message between pages): the high-level `getMessages()` drains now discard partial pages and fall back to the legacy snapshot on both `session_busy` and `stale_cursor`, driven by a new machine-readable `code` field on RPC error responses. Direct page calls remain strict.\n\n## [17.0.8] - 2026-07-22\n\n### Added\n\n- Added a `/tree` re-answer option for past `ask` tool results, allowing users to re-open the picker with original questions and branch the new answer as a sibling while keeping the original branch reachable.\n- Added configurable Hindsight client request deadlines via `hindsight.requestTimeoutMs`, `reflectTimeoutMs`, `recallTimeoutMs`, and `retainTimeoutMs` settings (and matching `HINDSIGHT_*_TIMEOUT_MS` environment variables).\n- Added `omp-linux-musl-x64` and `omp-linux-musl-arm64` release binaries for Alpine and other musl-based Linux distributions, with automatic musl selection in the installer and self-updater.\n\n### Changed\n\n- Optimized edit-tool previews, diff components, and intra-line word highlighting to compute line and word diffs natively, reducing synchronous diff times by 2-10x on large inputs.\n- Updated diff generation and rendering components to rely exclusively on native UTF-16 diff bindings, removing `isWellFormed()` guards and JS fallback code paths.\n\n### Removed\n\n- Removed npm `diff` dependency.\n- Fixed an issue where `Ctrl+V` clipboard paste was ignored while API-key and other modal prompts had focus.\n- Fixed `scripts/install.sh` incorrectly installing an x86_64 build on Apple Silicon when running under Rosetta.\n- Fixed the model picker hiding Codex models available through secondary configured ChatGPT/Codex OAuth accounts by unioning catalogs across all stored accounts.\n- Fixed GitHub Copilot 1M-context models disappearing from the model picker on restart with a \"Could not restore model\" warning.\n- Fixed `--model ` startup selection skipping configured fallback chains when the primary model is unavailable.\n- Fixed global model role updates clobbering concurrent or external edits to `config.yml` by merging only the changed role instead of persisting a stale in-memory snapshot.\n- Fixed terminal provider errors on continuation turns after failed tool results silently ending runs without persisting the error diagnostics.\n- Fixed repeated OpenRouter Gemini stream closures consuming the full retry budget by limiting recovery attempts before surfacing the error.\n- Fixed Agent Hub performance freezes when opening large read-only Advisor transcripts by collapsing synthetic inputs into compact summary rows and rendering Markdown lazily on expansion.\n- Fixed `/agents` incorrectly showing prewalk as disabled for the bundled `task` agent when enabled by its runtime default.\n- Fixed `hub start` waiting for the full timeout when a launched process exited or became ready quickly.\n- Fixed `tools.maxTimeout` failing to clamp default tool timeouts when no explicit timeout was provided by the agent.\n- Fixed MCP argument-shaping parity between direct and subagent tool calls, ensuring strict servers do not reject proxied calls with unrecognized keys.\n- Fixed a crash in extensions like `pi-mcp-adapter` caused by the TypeBox compatibility shim omitting `Type.Unsafe`.\n- Fixed `omp models` hanging after output by properly clearing managed extension timers and shutting down sessions before returning.\n- Fixed HTML session exports causing browser call stack overflows when rendering deeply nested conversation trees.\n- Fixed task agents ending prematurely on connection errors instead of entering the auto-retry path.\n- Fixed a startup race condition where the default model role was incorrectly overridden by an unrelated provider's default on a cold cache.\n- Fixed unqualified `--model` startup selection preferring unauthenticated provider catalog entries over configured providers.\n- Fixed provider stream failures being invisible in the main log by logging a warning with error details when a turn ends in a provider error.\n- Fixed parallel `todo done` calls losing completions due to asynchronous session events overwriting newer tool states.\n- Fixed `omp` crashing when `git` is not installed or missing from the system `PATH`.\n- Fixed `/changelog` commands reporting no entries in standalone binaries by embedding the release history as a fallback.\n- Fixed isolated branch merge-backs rejecting committed agent edits when the parent branch had unrelated uncommitted changes in the same file.\n- Fixed the 30-second Hindsight client timeout aborting healthy `reflect` operations by applying dedicated, longer deadlines.\n- Fixed Mnemopi consolidation redundantly re-storing cumulative session transcripts after incremental auto-retain.\n- Fixed turn-ending Codex rate-limit errors being hidden behind the Plan Review overlay.\n- Fixed prewalked subagents continuing to display their starting model after switching to the target model.\n- Fixed the Escape key aborting an ongoing agent turn instead of stopping text-to-speech playback.\n- Fixed project system prompts shortening working directories to `~`, which could cause models to generate incorrect absolute paths for tool calls.\n- Fixed the TUI `/usage` matrix misaligning multi-account columns across quota windows.\n- Fixed near-miss `xd://` write targets silently creating filesystem paths instead of throwing a corrective URI error.\n- Fixed the `task` tool rejecting valid batch calls with misleading validation errors when batching is disabled.\n- Fixed JS/TS `debug` launches timing out on WSL2 with mirrored networking by waiting for the adapter's listening banner and handling transport closures immediately.\n- Fixed post-compaction transcript rebuilds blocking the main thread by reusing settled message components and layout caches.\n- Fixed the fullscreen Plan Review overlay remaining interactive and appearing frozen during slow asynchronous operations by locking input and showing a submitting indicator.\n- Fixed dynamic model discovery refreshes dropping provider-level compatibility overrides from `models.yml`.\n- Fixed a startup crash that locked users out of the app when `prewalk.enabled` was set but the prewalk hand-off target had no configured API key.\n- Fixed in-progress aborts awaiting `session_stop` extension handlers whose results would be discarded.\n- Fixed `/retry` reporting \"Nothing to retry\" after a stream stalled or aborted mid-tool-call.\n- Fixed locally consumed extension commands triggering automatic title generation and exposing their command text to the title model.\n\n## [17.0.7] - 2026-07-21\n\n### Fixed\n\n- Fixed Portkey/gateway custom models whose ids start with `@` (e.g. `@modal/GLM-5-2-FP8`) being rewritten to unrelated bundled wire ids (e.g. `glm-5-2`), which caused `400` responses requiring `x-portkey-config` or `x-portkey-provider`.\n\n## [17.0.6] - 2026-07-20\n\n- Fixed failed plan-mode exits leaving the session on the restored execution model while plan mode remained active and silently changing ambient `xd://` tool presentation; rollback now restores the plan model, thinking level, and exact top-level-versus-mounted tool partition so exit can be retried safely ([#6013](https://github.com/can1357/oh-my-pi/pull/6013)).\n\n### Added\n\n- Added native Warp CLI-agent events for rich session status, tool approvals, and completion notifications ([#5592](https://github.com/can1357/oh-my-pi/pull/5592) by [@metaphorics](https://github.com/metaphorics)).\n- Added Codex (ChatGPT subscription) support to `generate_image`. The tool now resolves a connected `openai-codex` OAuth credential and drives OpenAI's hosted `image_generation` tool through the ChatGPT backend (`chatgpt.com/backend-api/codex/responses`, `chatgpt-account-id` header) **independent of the active chat model** \u2014 so image generation works on a ChatGPT/Codex subscription with no metered `OPENAI_API_KEY`, even when the active model is Claude/Gemini/etc. A new `providers.image: \"openai-codex\"` option forces it; `auto` now auto-detects a connected subscription (priority: active GPT image tool > Codex subscription > Antigravity > xAI > OpenRouter > Gemini), and the `openai` preference falls back to it when no `OPENAI_API_KEY`/active GPT model is present.\n- Added an optional `provider` parameter to `generate_image` (`auto` | `openai` | `openai-codex` | `antigravity` | `xai` | `gemini` | `openrouter`) that overrides the `providers.image` setting **for a single request** \u2014 so \"generate this using gemini / codex / xai\" routes per-call without changing the global setting. Absent \u2192 the `providers.image` setting applies, unchanged; the named provider uses the same resolution semantics (falls back to auto-detect if it has no credentials). File: `tools/image-gen.ts` (`imageProviderSchema`, `findImageApiKey` `preference` arg).\n- Added OpenTelemetry log and metric export alongside the existing trace export. When `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT` (or the shared `OTEL_EXPORTER_OTLP_ENDPOINT`) is set, `omp` registers a `LoggerProvider` and forwards every centralized-logger event as an OTLP log record (severity + attributes + active span context for log\u2194trace correlation, min level via `OTEL_LOG_LEVEL`, plus a structured `agent run completed` summary event). When `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT` (or the shared endpoint) is set, it registers a `MeterProvider` with a `PeriodicExportingMetricReader` and records GenAI-semconv `gen_ai.client.token.usage` plus `pi.omp.agent.*` counters/histograms (runs, steps, chat/tool calls by name+status+finish reason, latencies, estimated cost, errors) from the agent run summary and per-chat usage hooks. Each signal honors its own `OTEL_*_EXPORTER=none` kill switch, the global `OTEL_SDK_DISABLED`, and declines non-`http/protobuf` protocols independently ([#4604](https://github.com/can1357/oh-my-pi/issues/4604)).\n- `retry.fallbackChains` wildcards now support id-prefixed targets and keys: a chain entry like `\"openrouter/google/*\"` re-prefixes the failing model's bare id (`google-antigravity/gemini-x` \u2192 `openrouter/google/gemini-x`), a plain `\"provider/*\"` entry falling back *from* an aggregator strips the vendor prefix when the target provider only knows the bare id (`openrouter/google/x` \u2192 `google-vertex/x`), and an id-prefixed key (`\"openrouter/google/*\"`) scopes a chain to that provider's ids under the prefix.\n- The session tree selector (`/tree`, `/branch`) now supports Shift+Enter to summarize-and-switch in one step: it forks from the selected entry with a branch summary, with no extra prompt and regardless of `branchSummary.enabled`. Plain Enter keeps the current behavior (direct switch by default; the summary prompt only when `branchSummary.enabled` is on). ([#5152](https://github.com/can1357/oh-my-pi/issues/5152))\n- Added the turn's local timestamp (`YYYY-MM-DD HH:mm:ss`, down to the second) to the per-turn token-usage row shown under assistant messages when `display.showTokenUsage` is enabled.\n\n### Changed\n\n- Reduced concurrent subagent update CPU by reconstructing recent output only at progress emission boundaries. ([#5936](https://github.com/can1357/oh-my-pi/issues/5936))\n- Fixed `docs/advisor-watchdog.md` overstating advisor delivery for a normal yield: the severity table listed `concern` as unconditionally interrupting and the prose promised a self-ended run could always be steered/resumed. Documented the #4840 terminal-answer exception (`concern` becomes a passive card while `blocker` normally steers, #5628) plus the plan-mode and deferred-ACP constraints that preserve would-be steers until the user resumes ([#5913](https://github.com/can1357/oh-my-pi/issues/5913)).\n- Fixed subagent (task) sessions triggering an unnecessary tiny-model session-title generation call on `todo init`. Subagent sessions in a non-interactive host (print/RPC/ACP/eval/SDK/CI) have no operator-visible title and now skip the replan title refresh; interactive hosts keep it, since a live subagent focused from the Agent Hub renders its session name in the status line ([#5910](https://github.com/can1357/oh-my-pi/issues/5910)).\n- Fixed `tab.scroll()` timing out after a queued wheel event waits too long for a busy renderer's acknowledgement ([#5905](https://github.com/can1357/oh-my-pi/issues/5905)).\n- Made the hashline seen-line guard opt-in and off by default (see `edit.enforceSeenLines`), and stopped excluding column-clipped (>512-char) lines from a snapshot's seen set: a displayed line now counts as seen even when its display was column-truncated, so single-line edits on long lines found via `read`/`grep` apply without a separate full-width re-read.\n- Changed the default `astGrep.enabled` setting to `false`\n- Batched todo operations with real tool calls to prevent solo todo turns and extra round trips\n- Changed every bundled TTSR rule to warn without interrupting generation.\n- Renamed the system prompt's project-context section wrapper from `` to `` to stop it colliding with the `task` tool's `context` parameter under in-band XML tool dialects: models were closing `` with a stray `` (primed by the ambient section tag) and emitting sibling params as bare `` elements, so `tasks` arrived missing.\n- Rendered `read xd://` calls in the compact grouped read view instead of a full tool-execution card; other internal URLs (`skill://`, `agent://`, \u2026) still render full so their resolved content stays visible.\n\n### Fixed\n\n- Fixed the interactive `!`/`!!` shell shortcut spawning fish as a login shell (`fish -l -c \u2026`), which fired `status is-login` blocks in user config (agent/keychain setup, PATH mutation) on every command. fish is now started with `-i` instead \u2014 interactive shells source the same `config.fish`/`conf.d` files (so aliases and functions from #1816 keep working) without login-shell side effects. zsh behavior (`-l -i`) is unchanged.\n- Fixed the status-line `tok/s` badge ignoring vibe worker sessions: in `/vibe` mode the director is often idle while workers stream, so the badge showed a stale/zero rate while parallel work was actively generating tokens. The rate now aggregates the main session's live tok/s with every live vibe worker's tok/s, and falls back to the main session's own cached rate when no workers are streaming.\n- Fixed `plan.defaultOnStartup` being ignored by headless `omp -p` sessions, so the initial prompt now runs in plan mode and the persisted session remains in plan mode for later review ([#6017](https://github.com/can1357/oh-my-pi/issues/6017)).\n- Fixed resuming an active plan session replacing its journal-restored model with the current `modelRoles.plan` setting ([#6015](https://github.com/can1357/oh-my-pi/issues/6015)).\n- Fixed `--model ` resolving a bare configured `modelRoles` key.\n- Browser tool selectors now accept bare snapshot refs (`tab.click(\"e501\")`, `@e501`) everywhere `aria-ref=e501` works \u2014 previously the tab-worker backend fell through to a CSS tag selector that could never match, burning the 2s zero-match watchdog with a misleading \"matches no elements\" hint. `tab.select`, `tab.uploadFile`, `tab.press({ selector })`, `tab.screenshot({ selector })`, and `tab.drag` now resolve refs too. Unknown/stale refs fail immediately with the \"refresh refs\" error.\n- `tab.select` no longer double-reports the previously selected option of a single ``: the returned selection is read back after the full assignment pass instead of mid-loop.\n- Fixed transcript blocks being visibly duplicated during streaming (whole tool boxes and assistant paragraphs recommitted below their first copy on the terminal tape) by removing transcript committed-prefix compaction entirely. Dropping committed rows from the transcript's local frame shifted the frame under the engine's committed-prefix ledger, so the audit re-anchored and recommitted rows the tape already held. The transcript now always keeps its full local frame; committed finalized blocks still skip `render()` via the segment reuse bypass. Reverts the compaction half of [#5930](https://github.com/can1357/oh-my-pi/issues/5930)'s fix (compose keeps the render bypass; the local frame is no longer truncated).\n- Fixed tmux pane growth during a live response blanking finalized chat history re-exposed from native scrollback by rebasing the in-place repaint's commit seam to the resized viewport tail ([#6011](https://github.com/can1357/oh-my-pi/issues/6011)).\n- Fixed classifier refusals (e.g. Anthropic `stop_reason: \"refusal\"`) ending the turn with no visible error. Two independent regressions: (1) session events reached subscribers out of order when a turn's provider events landed in one tick \u2014 extension emits only await for event types with registered handlers, so the assistant `message_end` overtook its own `message_start` and the TUI skipped the error render entirely (no pinned banner, no inline `Error:` line); subscriber fan-out is now serialized in emission order. (2) Refusal turns are pruned from active context at settle (#3591), which also erased them from `state.messages` before `prompt()` resolved \u2014 print mode printed nothing and exited 0, and the task executor's `getLastAssistantMessage()` saw the previous turn. The pruned refusal is now retained until the next run starts, `getLastAssistantMessage()` reports it, and print mode reads the settled assistant via that accessor (exit 1 + refusal message on stderr). Additionally, `#lastAssistantMessage` is now set synchronously on `message_end` to prevent `agent_end` maintenance from reading a stale assistant turn when tool results and stops land in the same tick.\n- Fixed `before_provider_request` extension contexts exposing the primary session model for cross-provider Advisor requests instead of the request model ([#6006](https://github.com/can1357/oh-my-pi/issues/6006)).\n- Fixed isolated `task` subagents mutating the parent checkout and stacking parallel task branches. Copy isolation backends (reflink/apfs/btrfs/zfs/block-clone/rcopy) materialise the worktree by duplicating its `.git` verbatim; when the parent is a linked git worktree its `.git` is a pointer file, so the isolation shared the parent's HEAD/index/ref namespace and a task's `git checkout`/`commit` moved the parent's branch (and the rcopy `git worktree add` path leaked task branches into the shared namespace so a second task committed on top of the first). `ensureIsolation` now runs a new `git.detachGitDir` after `isoStart`: each isolation becomes a standalone repo with a frozen HEAD/refs/index snapshot that borrows the source object database through `objects/info/alternates`, so isolated git operations stay private, every task branch is parented on the requested base, and patch/branch capture (`git fetch `) still resolves objects. ([#6003](https://github.com/can1357/oh-my-pi/issues/6003))\n- Fixed `browser.run` leaving Puppeteer request handlers and interception state with divergent lifetimes by removing run-scoped handlers, disabling interception, and releasing held requests on every exit path ([#6004](https://github.com/can1357/oh-my-pi/issues/6004)).\n- Fixed Codex web search to honor configured `openai-codex` base URLs, API keys, and headers without leaking official OAuth credentials to custom endpoints; explicitly selected providers now fail closed instead of silently falling back ([#6001](https://github.com/can1357/oh-my-pi/issues/6001)).\n- Fixed `launch start` waiting for a finite PTY command to exit when the broker's PID-file handoff was unavailable; PTY startup now reports the spawned PID directly and returns an authoritative running or exited snapshot promptly ([#5996](https://github.com/can1357/oh-my-pi/issues/5996)).\n- Fixed queued user steering aborting side-effecting `hub start` calls after the broker request may already have been written; only passive hub waits and followed logs are now interruptible ([#5995](https://github.com/can1357/oh-my-pi/issues/5995)).\n- Fixed JavaScript/TypeScript debugging by launching vscode-js-debug over TCP, handling recursive `startDebugging` child sessions, synchronizing breakpoints across the session tree, and terminating every child connection ([#5984](https://github.com/can1357/oh-my-pi/issues/5984)).\n- Fixed rich ask options showing preview content only for the highlighted choice; every option now renders its preview inline, with pageable long content and accurate configured paging and cancel hints ([#5988](https://github.com/can1357/oh-my-pi/pull/5988) by [@metaphorics](https://github.com/metaphorics)).\n- Fixed legacy pi extensions failing extension validation when importing `getPackageDir` or `getProjectDir` from `@earendil-works/pi-coding-agent` (aliased to the legacy shim). The shim only re-exported `getAgentDir`; the two missing path helpers now resolve \u2014 `getProjectDir` from `@oh-my-pi/pi-utils`, and `getPackageDir` as a string-valued wrapper over omp's canonical package-root helper that falls back to the executable's directory inside `bun --compile` binaries (where the canonical helper returns `undefined`), matching pi's string contract. Extensions like `@gotgenes/pi-permission-system` install and load, and `path.join(getPackageDir(), \u2026)` no longer crashes in the shipped binary ([#5968](https://github.com/can1357/oh-my-pi/issues/5968)).\n- Fixed headless print mode disposing the session before a final advisor review completed, which could drop the advisor transcript and usage ([#5942](https://github.com/can1357/oh-my-pi/pull/5942)).\n- Fixed capped zero-block assistant stops remaining in active/session history with the full failed-request usage, causing the next post-snapcompact `continue` to re-enter context maintenance at the same boundary; capped empty turns are now discarded and the failure names model switching or `/shake images` as recovery options ([#5959](https://github.com/can1357/oh-my-pi/issues/5959)).\n- Long sessions no longer re-run `convertToLlm` over settled history every turn. Conversion is memoized per message identity (plus the assistant `interruptedNext` neighbor flag): an exact re-convert of the same array reuses the outer `Message[]`, append-only growth reuses the converted prefix via slice-on-growth, and the prune/shake/strip-images/prewalk-scrub rewrite seams invalidate the affected message before the next pass. On the `llm-assembly` bench (N=5000) steady/append convert and repeat estimate are all >10x faster with robust MAD-noise well under 20% ([#5934](https://github.com/can1357/oh-my-pi/issues/5934)).\n- Fixed `/exit` hanging on post-prompt work and stacking independent subsystem teardown delays by bounding the aborted-work drain, disposing independent session resources concurrently, and keeping long shutdown waits visible ([#5932](https://github.com/can1357/oh-my-pi/issues/5932)).\n- Fixed queued-message display updates being skipped by focused-editor keystroke frames by explicitly repainting the pending-message container ([#5928](https://github.com/can1357/oh-my-pi/issues/5928)).\n- Fixed RPC and RPC-UI startup crashes when an in-process extension claimed Bun's singleton stdin stream before the protocol reader ([#5898](https://github.com/can1357/oh-my-pi/issues/5898)).\n- Bash command timeouts now render with a warning (yellow) border instead of an error (red) border, reflecting that the timeout ran its course rather than the command failed. `isError` remains `true` on the result so the model still knows the command did not complete normally. The `timedOut` flag is now propagated from the bash executor to distinguish timeouts from user aborts.\n- Fixed Cursor responses streams stalling after an exec-channel tool completed without automatically recovering. The session now continues from the already-buffered tool result instead of replaying the side-effecting request. ([#5790](https://github.com/can1357/oh-my-pi/issues/5790))\n- Fixed linked legacy pi extensions failing to load when they import `DefaultPackageManager` or linkedom: the coding-agent compatibility shim now enumerates OMP extension paths with plugin metadata, and extension-graph CommonJS modules load through synchronous default-export bridges with linkedom's bundled canvas fallback. ([#5658](https://github.com/can1357/oh-my-pi/issues/5658))\n- Fixed the advisor retrying terminal, non-retriable provider failures (e.g. blocked prompts) three times before giving up; such failures now drop the bounded batch after a single attempt while transient failures keep the 3-attempt retry path ([#5468](https://github.com/can1357/oh-my-pi/pull/5468)).\n- Fixed reassigning the `plan` role model mid-planning not taking effect on the active planning turn; the change now applies at the next turn boundary instead of only the next plan-mode entry ([#5657](https://github.com/can1357/oh-my-pi/issues/5657)).\n- Added managed `ctx.setInterval` / `ctx.setTimeout` / `ctx.clearTimer` helpers on the extension context. Callbacks scheduled through them run with the same isolation as handler dispatch \u2014 a throw or rejected promise is logged and reported through the extension error channel instead of escaping as a process-fatal `uncaughtException` \u2014 and every outstanding timer is `unref`'d and cleared automatically on `session_shutdown` ([#5664](https://github.com/can1357/oh-my-pi/issues/5664)).\n- Fixed an extension's self-scheduled `setInterval`/`setTimeout` callback throwing being able to tear down the whole session. Such callbacks ran outside the handler-dispatch try/catch, surfaced as a process-level `uncaughtException`, and the global postmortem handler treated them as fatal; extension authors now have sanctioned managed timers (see Added), and the constraint is documented in `docs/extensions.md` / `docs/skills/authoring-extensions.md` ([#5664](https://github.com/can1357/oh-my-pi/issues/5664)).\n- Fixed `/quit` and `/exit` leaving failed or stalled automatic title-generation requests alive during session teardown; disposal now aborts both online provider and local tiny-model title requests ([#5666](https://github.com/can1357/oh-my-pi/issues/5666)).\n- Fixed `startup.quiet` still rendering the `xdev: xd://: mounted \u2026` status line when MCP tools connect; quiet startup now suppresses only the user-visible mount notice while retaining the hidden model-facing device update ([#5670](https://github.com/can1357/oh-my-pi/issues/5670)).\n- Fixed command error in `hub` tool with a non-POSIX shell ([#5682](https://github.com/can1357/oh-my-pi/pull/5682))\n- Fixed xdev-routed checkpoint and rewind writes not tracking checkpoint state and leaving rewinding results in rebuilt provider and session context.\n- Fixed the built-in advisor silently doing nothing when its model routes through the `cursor` provider: the advisor runs in its own `Agent` that was constructed without `cursorExecHandlers`, so on Cursor \u2014 where every tool executes server-side and is dispatched back through the client's exec handlers \u2014 each advisor tool call (including the MCP `advise` tool) came back `toolNotFound`/\"tool not available\" and no advice was ever routed. The advisor `Agent` now gets a Cursor exec bridge scoped to its own granted tool set, mirroring the primary agent. The bridge's native `delete` frame is gated so a read-only advisor cannot delete workspace files it was never granted a mutating tool for ([#5680](https://github.com/can1357/oh-my-pi/issues/5680)).\n- Fixed the fullscreen plan-review overlay staying visible until the approved execution turn finished, so after picking \"Approve and keep context\" (or any approve option) work proceeded underneath while the operator was stuck on the plan-review screen. The overlay is now hidden once execution begins \u2014 after the async transcript rebuild, before the blocking synthetic prompt is dispatched \u2014 instead of only after the whole turn returns ([#5688](https://github.com/can1357/oh-my-pi/issues/5688)).\n- Fixed MCP tools repeatedly unmounting and remounting mid-session when server names have overlapping sanitized prefixes (e.g. `atlassian` alongside an imported `atlassian:atlassian`), and stale tools remaining registered after disconnecting a server with special characters in its name.\n- Fixed the `/usage show` `in use by this session:` marker showing only the login email, so two same-email Anthropic credentials in different orgs (a Team seat and a personal Max plan) were indistinguishable. The marker now suffixes the active organization (`email (OrgName)`) via a shared `formatActiveAccountLabel`, matching the account list and login-success surfaces ([#5691](https://github.com/can1357/oh-my-pi/issues/5691)).\n- Fixed Windows stdio MCP servers launched through `.cmd`/`.bat` shims failing with `Transport closed`; the launch now builds a `cmd.exe /d /e:ON /v:OFF /c` command line escaped for `cmd.exe`'s parser and spawned with `windowsVerbatimArguments`, so the resolved command path and arguments (including `%VAR%`, quotes, and shell metacharacters) reach the server intact and cannot inject commands (BatBadBut / CVE-2024-24576) ([#5696](https://github.com/can1357/oh-my-pi/issues/5696)).\n- Fixed the TUI usage panel truncating organization suffixes from same-email account labels even when the terminal has enough width ([#5701](https://github.com/can1357/oh-my-pi/issues/5701)).\n- Fixed a startup crash on Windows when running from a drive root (e.g. `R:\\`): `fs.realpath` throws `EISDIR` there, but `canonicalProjectDir` in `launch/presence.ts` and `launch/client.ts` only recovered `ENOENT`. It now also falls back to `path.resolve()` on `EISDIR` ([#5708](https://github.com/can1357/oh-my-pi/issues/5708) by [@ve3xone](https://github.com/ve3xone)).\n- Fixed unknown `__omp_worker_*` CLI selectors exiting 0 with empty output instead of erroring; an unrecognized worker-host selector now writes `Error: unknown worker selector: \u2026` to stderr and exits nonzero, so a stale or mistyped selector can no longer look healthy to a parent process or install smoke path ([#5712](https://github.com/can1357/oh-my-pi/issues/5712)).\n- Fixed Plan Review capturing mouse drags as pointer events, preventing native terminal text selection ([#5711](https://github.com/can1357/oh-my-pi/issues/5711)).\n- Fixed orphaned TUI processes with revoked terminal descriptors remaining alive after a fatal error and amplifying shared log-rotation races into runaway memory, file-descriptor, swap, and disk consumption ([#5716](https://github.com/can1357/oh-my-pi/issues/5716)).\n- Fixed approved-plan execution looping through filesystem searches when a model rewrites the required `local://-plan.md` read as a same-basename working-directory path; a missing cwd-root alias now recovers the active session-local plan while preserving any real working-tree file ([#5704](https://github.com/can1357/oh-my-pi/issues/5704)).\n- Fixed Ask dialogs immediately accepting their highlighted single-select answer when they appear while the user is typing a space in the prompt editor ([#5717](https://github.com/can1357/oh-my-pi/issues/5717)).\n- Stopped post-compaction auto-continue from opening another primary turn after a terminal text answer with no queued work, and moved automatic auto-learn capture into an abortable private agent with only `manage_skill` and `learn` tools ([#5715](https://github.com/can1357/oh-my-pi/issues/5715)).\n- Fixed the `write` approval gate misclassifying `xd://` device writes as `exec` when the mounted tool declared a function-valued (argument-dependent) `approval`: the gate discarded the function and never decoded the device JSON payload, so read/write device operations prompted in non-yolo modes their approval mode permits. It now parses valid object payloads and evaluates the mounted tool's normal approval decision, while malformed JSON, non-object payloads, and unknown devices still fall back to `exec` and prompt ([#5727](https://github.com/can1357/oh-my-pi/issues/5727)).\n- Fixed custom LSP servers such as `roslyn-language-server` crashing after initialization when they request unconfigured `workspace/configuration` sections; missing settings now receive the spec-required `null` instead of `{}` ([#5745](https://github.com/can1357/oh-my-pi/issues/5745)).\n- Fixed late user-initiated bash results and minimized-output artifacts being recorded in whichever session or branch was active when execution finished; bash now retains its originating transcript across `new_session`/`switch_session`/`branch`/tree navigation, and an intentionally dropped session stays deleted instead of being recreated by a straggling result ([#5743](https://github.com/can1357/oh-my-pi/issues/5743)).\n- Fixed Claude Code marketplace plugins with `scope: \"local\"` leaking skills, hooks, tools, commands, and MCP servers into unrelated projects ([#5750](https://github.com/can1357/oh-my-pi/issues/5750)).\n- Fixed headless `omp -p` waiting indefinitely after a completed turn when final mnemopi consolidation stalls; print mode now applies the same bounded consolidation shutdown budget as interactive exit and reaps the embed worker ([#5753](https://github.com/can1357/oh-my-pi/issues/5753)).\n- Fixed explicit-tool sessions bypassing `xd://` presentation for ambient discoverable custom and MCP tools, which sent their schemas top-level and could exceed provider tool limits or trigger schema-compatibility errors.\n- Fixed `providers.webSearch: kimi` sending a Moonshot Open Platform credential (`MOONSHOT_API_KEY` / stored `moonshot` auth) to the Kimi Code search endpoint (`api.kimi.com/coding/v1/search`), which rejects it with `401` and silently falls back to another provider. Kimi web search now resolves and advertises Kimi Code credentials only \u2014 a Kimi Code Console key via `KIMI_SEARCH_API_KEY` / `MOONSHOT_SEARCH_API_KEY` or `omp /login kimi-code` ([#5762](https://github.com/can1357/oh-my-pi/issues/5762)).\n- Fixed extension/SDK/RPC `registerTool` demoting essential built-ins (`read`/`write`/`bash`/`edit`/`glob`/\u2026) to `discoverable` when a re-registration omitted `loadMode`, which \u2014 with `tools.xdev` on \u2014 unmounted them from the top-level schema and broke the `xd://` transport (`read xd://`/`write xd://`), leaving the model with no callable coding essentials. Omitted `loadMode` now defaults to `\"essential\"` for known essential built-in names at every adapter boundary, and `read`/`write` (the transport itself) are never mounted under xdev regardless of `loadMode` ([#5764](https://github.com/can1357/oh-my-pi/issues/5764)).\n- Fixed the advisor skipping the next real user instruction after auto-learn accepted and pruned a terminal empty assistant stop; advisor transcript cursors now detect rewritten prefixes and re-prime before slicing the next update ([#5731](https://github.com/can1357/oh-my-pi/issues/5731)).\n- Fixed built-in advisors retrying a quota- or rate-limited provider until becoming unavailable instead of applying the matching `retry.fallbackChains` model chain; advisor fallbacks now emit the same applied and succeeded lifecycle events as primary-agent fallbacks ([#5740](https://github.com/can1357/oh-my-pi/issues/5740)).\n- Made the model selector status messages use the role tag (`SMOL`, `SLOW`) instead of the display name (`Fast`, `Thinking`), matching the rest of the TUI and CLI/env role terminology ([#5585](https://github.com/can1357/oh-my-pi/issues/5585)).\n- Fixed Cursor models receiving only top-level tools by forwarding mounted `xd://` devices, including user-configured MCP servers, through Cursor's request-context MCP catalog and execution bridge ([#5650](https://github.com/can1357/oh-my-pi/issues/5650)).\n- Fixed Windows bash crashes when a piped command times out while flushing output; explicit-timeout watchdogs now wait for bounded native teardown instead of returning mid-drain. ([#5316](https://github.com/can1357/oh-my-pi/issues/5316))\n- Fixed a race where hub/IRC `send` and `ensureLive` could hand out or inject into a subagent session mid-`park` dispose: park now detaches and flips status to `parked` before `session.dispose()`, concurrent `ensureLive` cancels a pre-detach park or waits then revives, and IRC delivery always gates through `ensureLive` so receipts/unread counts stay truthful ([#5633](https://github.com/can1357/oh-my-pi/issues/5633)).\n- Migrated legacy `dev.autoqa.consent` \u2192 `dev.autoqaConsent` and `todo.reminders.max` \u2192 `todo.remindersMax` on settings load so pre-v17 nested or quoted-dotted config no longer leaves the parent path as an object (which made `dev.autoqa` truthy and enabled Auto QA, and discarded the reminder limit). Explicit new keys win, a separately configured parent boolean is preserved, an irrecoverable object parent falls back to the schema default, and only the new keys persist on save ([#5632](https://github.com/can1357/oh-my-pi/issues/5632)).\n- Fixed all keyboard input dying after the first keypress when a `~/.claude/tools` (or `.omp/tools`) module attaches a stdin consumer at import time \u2014 e.g. an MCP `StdioServerTransport` constructed at module top level, or a bare `process.stdin.resume()`. The custom-tool/extension/hook/plugin loader guard now snapshots and restores `process.stdin` (listeners, paused state, raw mode) around third-party module evaluation, so a hijacked stdin reader can no longer starve the TUI's own listener ([#5618](https://github.com/can1357/oh-my-pi/issues/5618)).\n- Fixed the ask tool's \"Other\" custom-input dialog rendering the title, options, and hint one column to the right of the `> ` input gutter; the prompt-style editor chrome now aligns to column 0 ([#5313](https://github.com/can1357/oh-my-pi/issues/5313))\n- Fixed advisor context maintenance undercounting the provider context: the compaction decision now anchors on the advisor's provider-reported context usage (cached input + generated output) floored by a full local estimate that includes the advisor system prompt and tool schemas, rejects stale provider usage retained across advisor compaction, and recovers a provider overflow by clearing only the advisor's own context at the current primary cursor \u2014 retrying the bounded failing batch once against a fresh context without replaying old primary history and keeping later updates eligible ([#5282](https://github.com/can1357/oh-my-pi/issues/5282))\n- Fixed RPC mode (`--mode rpc`) crashing the whole process with an uncaught `SyntaxError: Failed to parse JSONL` on any non-JSON stdin line. Malformed lines are now reported via a `Failed to parse command` error frame and the frame loop keeps running. ([#5194](https://github.com/can1357/oh-my-pi/issues/5194))\n- Fixed the status line loop indicator to distinguish waiting, running, and paused states and show the remaining loop budget ([#5832](https://github.com/can1357/oh-my-pi/pull/5832) by [@wolfiesch](https://github.com/wolfiesch)).\n- Fixed single-model task agents ignoring an explicitly configured default retry fallback chain, which left subagents failed after their selected provider became unreachable instead of advancing to the configured fallback model.\n- Fixed the `/extensions` dashboard tab labeled \"Agents (standard)\" being confused with the `/agents` subagents feature \u2014 the `.agent`/`.agents` config-standard provider now presents as \"Agent Dirs (.agent/.agents)\" since it lists skills, rules, prompts, commands, and context/system files, never subagents ([#5821](https://github.com/can1357/oh-my-pi/issues/5821)).\n- Fixed non-raw `read` line selectors returning context outside the requested inclusive range ([#5802](https://github.com/can1357/oh-my-pi/issues/5802)).\n- Fixed LSP requests silently clamping explicit timeouts above 60 seconds by supporting documented budgets up to 300 seconds ([#5804](https://github.com/can1357/oh-my-pi/issues/5804)).\n- Clarified async task and hub guidance: inspecting a settled job consumes its automatic delivery, job IDs expire from process memory after roughly five minutes, and completion does not verify claimed artifacts ([#5869](https://github.com/can1357/oh-my-pi/issues/5869)).\n- Fixed `vibe_wait` TV-wall panels stacking duplicate frozen frames in native scrollback while two or more workers were live ([#5777](https://github.com/can1357/oh-my-pi/issues/5777)).\n- Fixed async task job rows omitting resolved subagent model and reasoning badges when `task.showResolvedModelBadge` is enabled. ([#5060](https://github.com/can1357/oh-my-pi/issues/5060))\n- Fixed raw Puppeteer `page`/`browser` promises from crashing inline browser workers or killing dedicated workers when a target closed before the caller awaited the promise.\n- Fixed auto-compaction dead-ending in a warning loop (\"Compaction freed too little context to make progress\") when the single most-recent turn is itself over budget so `prepareCompaction` has nothing to summarize (`findCutPoint` never cuts inside a tool result). This `!preparation` short-circuit never ran the artifact-backed `shake` elide rescue that #3786 added to the post-maintenance guard, so snapcompact/context-full maintenance paused with no attempt to shrink the oversized tail. The dead-end now runs the same elide pass, re-prepares on the shrunken branch, and falls through to a normal compaction when the tail became summarizable \u2014 only pausing (single warning) when nothing is elide-eligible. ([#4786](https://github.com/can1357/oh-my-pi/issues/4786))\n- Fixed GitHub-hosted repository file reads falling back to `curl` by adding a dedicated `github` file-read operation and explicit tool-routing guidance ([#4805](https://github.com/can1357/oh-my-pi/issues/4805)).\n- Bounded RPC JSONL frames to 1 MiB, compacted oversized `agent_end` frames without losing complete Python prompt results, and guaranteed worker reaping plus pending-request rejection after output-reader failures or explicit stops ([#5405](https://github.com/can1357/oh-my-pi/issues/5405)).\n- Fixed `web_search` being unreachable under default config: with `tools.xdev: true`, the discoverable `web_search` tool was mounted under `xd://` and dropped from the top-level toolset, so models calling it directly got \"Tool web_search not found\". It is now pinned top-level via `XDEV_KEEP_TOP_LEVEL` while other discoverable tools keep mounting under `xd://` ([#5973](https://github.com/can1357/oh-my-pi/issues/5973)).\n- Fixed onboarding omitting model selection by adding a persisted default-model step (fresh installs only \u2014 the setup version is not bumped, so existing installs are not re-prompted), and documented custom `models.yml` provider configuration and default-role selection ([#5979](https://github.com/can1357/oh-my-pi/issues/5979)).\n- Fixed `autoResume` crossing an explicit `/new` boundary: after `/new` a new session's JSONL is created lazily (only once assistant output exists), so exiting before any assistant message left the per-terminal breadcrumb pointing at a not-yet-materialized file. `readTerminalBreadcrumbEntry` rejected the missing target and `continueRecent()` fell back to the most-recent session \u2014 the pre-`/new` transcript \u2014 processing the next prompt with stale context. `/new` now records a durable `fresh` breadcrumb boundary that `continueRecent()` honors (starting fresh) even when the target is absent, while a genuinely stale/deleted breadcrumb still falls back to the most-recent session ([#5730](https://github.com/can1357/oh-my-pi/issues/5730)).\n- Fixed subagents that repeatedly submit malformed `yield` results from leaving the parent waiting forever; malformed submissions now repeat the required response format, and repeated invalid submissions fail the child with a clear error. ([#4957](https://github.com/can1357/oh-my-pi/issues/4957))\n- Fixed configured or `-e` extensions in compiled binaries failing to resolve bundled `@oh-my-pi/*` value imports through the `omp-legacy-pi-bundled:` registry, and surfaced extension load failures during interactive and `-p` session startup. ([#4954](https://github.com/can1357/oh-my-pi/issues/4954))\n\n### Removed\n\n- Fixed the Cursor-backed advisor losing entire turns when it selected server-native tools (`bash`, `grep`, etc.) outside its grant: exec-resolved native blocks are already rejected in-band by the advisor-scoped bridge, so they no longer trip the unavailable-tool quarantine and discard the `advise` emitted in the same turn ([#5900](https://github.com/can1357/oh-my-pi/issues/5900)).\n- Fixed custom `anthropic-messages` OAuth providers being unable to opt into configured Claude Code fingerprint header overrides. ([#5888](https://github.com/can1357/oh-my-pi/issues/5888))\n- Fixed authoritative providers (e.g. `openai-codex`) keeping unsupported bundled models selectable when a fresh model cache and an expired OAuth token coincided: built-in discovery now forces the OAuth refresh so the provider's model manager is constructed and prunes stale bundled entries (e.g. `gpt-5.4-nano`) instead of waiting out the cache TTL. ([#5364](https://github.com/can1357/oh-my-pi/issues/5364))\n\n## [17.0.5] - 2026-07-18\n\n### Added\n\n- Added support for Codex (ChatGPT subscription) in `generate_image` via the `providers.image: \"openai-codex\"` option, including automatic subscription detection and fallback logic.\n- Added an optional `provider` parameter to `generate_image` to override the global image provider setting for a single request.\n- Added OpenTelemetry log and metric export capabilities alongside existing trace exports, supporting standard OTLP environment variables.\n- Added support for id-prefixed targets and keys in `retry.fallbackChains` wildcards (e.g., `\"openrouter/google/*\"`).\n- Added support for `Shift+Enter` in the session tree selector (`/tree`, `/branch`) to summarize and switch branches in a single step.\n- Added the `PI_CONFIG_FILES` environment variable to load settings overlays before `--config` overlays.\n\n### Changed\n\n- Changed bundled TTSR rules to warn instead of interrupting generation.\n- Renamed the system prompt's project-context section wrapper from `` to `` to prevent XML tag collisions with in-band tool dialects.\n- Renamed the `/extensions` dashboard tab \"Agents (standard)\" to \"Agent Dirs (.agent/.agents)\" to clarify its purpose.\n- Optimized performance by reducing concurrent subagent update CPU usage, skipping unnecessary title generation in non-interactive hosts, and memoizing `convertToLlm` conversions over settled history.\n- Improved the display of `read xd://` calls by rendering them in a compact grouped view instead of full tool-execution cards.\n- Made the hashline seen-line guard opt-in and off by default via `edit.enforceSeenLines`.\n\n### Fixed\n\n- Fixed isolated `task` subagents mutating the parent git checkout and stacking parallel task branches by detaching the git directory.\n- Fixed Windows compatibility issues, including `launch start` daemons opening visible console windows, startup crashes when running from a drive root, and command errors in the `hub` tool with non-POSIX shells.\n- Fixed Windows stdio MCP servers launched through `.cmd`/`.bat` shims failing with `Transport closed` by escaping arguments properly.\n- Fixed browser tool selectors (`tab.click`, `tab.select`, etc.) to accept bare snapshot refs (e.g., `tab.click(\"e501\")`, `@e501`) and resolved crashes when handed `ElementHandle` objects.\n- Fixed classifier refusals (e.g., Anthropic `stop_reason: \"refusal\"`) ending turns with no visible error or exiting 0 in print mode.\n- Fixed transcript blocks being duplicated during streaming and tmux pane growth blanking finalized chat history.\n- Fixed JS/TS debugging by launching vscode-js-debug over TCP and synchronizing breakpoints across the session tree.\n- Fixed legacy pi extensions failing validation or loading when importing path helpers or package managers.\n- Fixed `/login` and `/logout` failing to refresh model discovery with fresh credentials due to stale cached data.\n- Fixed Cursor models and advisors failing to receive or execute mounted `xd://` devices and MCP tools.\n- Fixed MCP tools repeatedly unmounting/remounting with overlapping sanitized prefixes, and stale tools remaining after disconnecting.\n- Fixed custom LSP servers crashing when requesting unconfigured `workspace/configuration` sections.\n- Fixed keyboard input dying after the first keypress when custom tools or modules hijack stdin at import time.\n- Fixed auto-compaction dead-ending in a warning loop when the most recent turn is over budget.\n- Fixed GitHub-hosted repository file reads falling back to `curl` by adding a dedicated `github` file-read operation.\n- Fixed active session markers and TUI usage panels truncating organization suffixes from same-email account labels.\n- Fixed `write` approval gates misclassifying `xd://` device writes as `exec`.\n- Fixed bash command timeouts rendering with an incorrect error border, and resolved Windows bash crashes when piped commands time out.\n- Migrated legacy nested/quoted-dotted config keys (e.g., `dev.autoqa.consent` -> `dev.autoqaConsent`) on settings load.\n- Added managed `ctx.setInterval` / `ctx.setTimeout` / `ctx.clearTimer` helpers on extension contexts to prevent uncaught exceptions from crashing sessions.\n\n## [17.0.4] - 2026-07-18\n\n### Fixed\n\n- Fixed bundled Linux ffmpeg recording by selecting its available ALSA input when PulseAudio support is absent, and surfaced recorder stderr when capture fails ([#5907](https://github.com/can1357/oh-my-pi/issues/5907)).\n- Session load now skips the recursive async blob-ref resolver for entries with no `blob:sha256:` references. A cheap synchronous precheck gates the walk per entry (preserving the previous per-entry initiation order under synchronous store mutation), so text-heavy histories no longer pay the `Promise.all` tree descent for every non-session entry ([#5922](https://github.com/can1357/oh-my-pi/issues/5922)).\n- Fixed `task` tool schemas emitting boolean subschemas that llama.cpp grammar generation cannot parse ([#5957](https://github.com/can1357/oh-my-pi/issues/5957)).\n- Fixed the transcript keeping finalized assistant blocks in the live compose walk after their rows entered native terminal scrollback, making each stream tick's `TranscriptContainer.render` depth-linear in session length. Fully committed finalized blocks are now compacted out of the local frame regardless of post-finalize version tracking; a later mutation no longer recommits on ordinary frames (no duplication) and rehydrates on the next destructive full replay (no loss). Compose cost for a live tail tick is now flat as depth grows (`bench/transcript-compose.bench.ts`: ratio(N5000/N500) 2.30 \u2192 0.90) ([#5930](https://github.com/can1357/oh-my-pi/issues/5930)).\n- Fixed `/quit` and `/exit` hanging during interactive shutdown by making the mnemopi dispose path retain the current session and flush in-flight extractions without sleeping the bank; the `/memory enqueue` path and end-of-session backend enqueue still perform full cross-session consolidation. ([#3641](https://github.com/can1357/oh-my-pi/issues/3641))\n- Fixed interactive bash shortcut `cd` commands leaving the OMP session and status-line working directory unchanged.\n\n## [17.0.3] - 2026-07-17\n\n### Changed\n\n- `omp usage` and the in-session `/usage` view now show the Anthropic organization next to the account for org-scoped credentials (with `--redact` masking applied per part in the CLI, falling back to the org id when no display name is available), attribute \"no usage data\" rows per organization, and match the \"in use by this session\" marker by organization so only the active subscription is flagged. The OAuth login success message names the account and organization that was stored \u2014 a login landing on an unintended subscription is visible immediately.\n- `/logout` labels Anthropic accounts with their organization and marks only the credential of the active organization as active; `omp token --list` shows the organization next to each account. Two subscriptions sharing one email are distinguishable when selecting which to remove or mint a token for.\n- `omp auth-broker migrate --from-local` dedupes Anthropic OAuth identities per organization, so a Team seat already on the broker no longer blocks uploading the personal plan under the same email.\n- The status line invalidates its cached usage when the session rotates to a different Anthropic organization (previously the old subscription's quota could linger for the cache TTL), and `omp auth-gateway check` labels each credential with its organization so a failing row says which subscription needs re-login.\n- `omp usage` \"no usage data\" attribution is org-decisive whenever either the stored account or a report carries an organization: an org-less legacy credential whose own fetch failed is no longer hidden by an org-attributed sibling report sharing the same email.\n- Active-account matching for `/usage`, `/logout`, and `omp token --list` now treats a shared organization as a qualifier rather than a match: two Anthropic Team seats in one org (same org id, per-user pools) no longer flag each other's rows or reports as \"in use by this session\" \u2014 the base identity (account/email/project) is still required, with org-only sessions matching on the org alone.\n- `omp usage` \"no usage data\" coverage now requires the member's own identity within a shared organization: a sibling Team member's same-org report no longer counts as coverage for an account whose own report is missing, while an org-only account remains covered by any same-org report.\n- `omp auth-broker migrate --from-local` reruns now recognize an already-migrated org-only Anthropic row (login recovered neither email nor account) by its organization id instead of re-uploading it, which could overwrite the broker's newer refresh token with the stale local one.\n- Updated tangential agent forks to ignore parent session history and focus exclusively on the new request\n- Hardened `/tan` fork isolation: the clone's inherited todo list is cleared at fork (parent todo reminders no longer drag the tan back onto the parent's task), the fork notice warns that the parent is concurrently editing the same working directory, and the notice is re-injected after each compaction so the fork boundary survives summarization\n- Added visual markers in the transcript for elided tool calls that have no corresponding result\n- Updated status event log to prioritize the most recent entries in the display window\n- Updated the snapcompact shape preview transcript to use the compact scope format shown to models during compaction.\n\n### Fixed\n\n- Fixed `xd://` mount notices triggering unsolicited model turns by deferring hidden notices until the next user prompt.\n- Fixed `xd://` device tools appearing in the direct tool inventory and prompting invalid function calls ([#5797](https://github.com/can1357/oh-my-pi/issues/5797)).\n- Fixed `history://` read selectors being treated as part of the agent id instead of paging the transcript ([#5806](https://github.com/can1357/oh-my-pi/issues/5806)).\n- Narrowed the `history://` contract in the system prompt to match the implementation: it serves registered agents process-wide plus persisted subagents discoverable from their artifact trees, but does not discover unregistered top-level sessions solely from persisted session files ([#5839](https://github.com/can1357/oh-my-pi/issues/5839)).\n- Fixed expanded `!` bash and `eval` output keeping a stale `\u2026 N more lines (ctrl+o to expand)` footer after Ctrl+O revealed every line ([#5842](https://github.com/can1357/oh-my-pi/issues/5842)).\n- Fixed MCP reauthentication continuing to an authorization URL without `client_id` after dynamic client registration fails; the registration error now blocks the flow with the provider response details ([#5852](https://github.com/can1357/oh-my-pi/issues/5852)).\n- Fixed collapsed todo views hiding the in-progress task in large phases. Both the transient `Todo` tool result and the sticky `Todos` HUD now share one walking-viewport policy: completed/abandoned tasks are omitted, every active task (the in-progress one, or a pending task a live subagent is executing) is pulled to the head in todo order, remaining rows fill with the following pending tasks, and an explicit `\u2026 N more active todos` summary is shown when active work alone exceeds the preview cap ([#5873](https://github.com/can1357/oh-my-pi/issues/5873)).\n- Fixed legacy provider extensions failing to load when they use the historical synchronous auth-storage surface ([#5879](https://github.com/can1357/oh-my-pi/issues/5879)).\n- Fixed orphaned detached MCP stdio server process trees surviving session dispose by escalating stdin-EOF \u2192 group SIGTERM \u2192 group SIGKILL on close() (#5578)\n- Fixed `/new` starting an unsolicited old-context provider turn when a hidden steer (e.g. an `xd://` mount notice) was queued: the session transition is now an atomic boundary, so a queued steer/follow-up can no longer auto-resume against the pre-`/new` context while the session is disconnected mid-transition. `/compact` still resumes a steer/follow-up that arrives while it runs, draining the queue once it reconnects ([#5800](https://github.com/can1357/oh-my-pi/issues/5800)).\n- Fixed signed thinking-only Claude stops being discarded and retried as empty responses ([#5881](https://github.com/can1357/oh-my-pi/issues/5881)).\n- Fixed repeated URL reads and URL-backed searches returning stale same-session responses instead of refetching the resource ([#5803](https://github.com/can1357/oh-my-pi/issues/5803)).\n- Fixed `read`/`write` not recognizing ZIP-based `.jar`/`.war`/`.ear`/`.apk` files as archives, so `read lib.jar:META-INF/MANIFEST.MF` failed with path-not-found ([#5808](https://github.com/can1357/oh-my-pi/issues/5808)).\n- Fixed legacy binary `.doc`/`.ppt`/`.xls`/`.rtf` being advertised as convertible in `read`, `fetch`, and CLI `@file` handling despite having no markit converter, which surfaced an `Unsupported format` error instead of falling through to normal file handling ([#5808](https://github.com/can1357/oh-my-pi/issues/5808)).\n- Fixed Kimi Code transport selection to follow live per-model protocol metadata by default while preserving explicit OpenAI and Anthropic overrides ([#5893](https://github.com/can1357/oh-my-pi/issues/5893)).\n- Fixed repeated edit-tool rejections from local models by recovering comma-separated ranges and malformed trailers, while clarifying canonical string input and `.=` syntax ([#5805](https://github.com/can1357/oh-my-pi/issues/5805)).\n- Fixed LSP diagnostics and edit-time diagnostics writethrough for pull-only servers that advertise `textDocument/diagnostic` statically or through dynamic registration ([#5825](https://github.com/can1357/oh-my-pi/issues/5825)).\n- Fixed local `!` command output concatenating carriage-return progress updates by preserving them as readable line boundaries ([#5845](https://github.com/can1357/oh-my-pi/issues/5845)).\n- Fixed `hub`/`irc` peer discovery after process-crash resume by restoring persisted subagents as parked peers before listing the roster ([#5864](https://github.com/can1357/oh-my-pi/issues/5864)).\n\n### Removed\n\n- Removed the unreliable Bing and Yahoo HTML-scraping web search providers\n\n## [17.0.2] - 2026-07-17\n\n### Added\n\n- Added native Warp CLI-agent events for rich session status, tool approvals, and completion notifications.\n- Added support for ChatGPT/Codex subscriptions in the `generate_image` tool, allowing image generation without a metered `OPENAI_API_KEY` even when using other active models.\n- Added an optional `provider` parameter to `generate_image` to override the global `providers.image` setting for a single request.\n- Added OpenTelemetry log and metric export support alongside existing trace exports, enabling forwarding of centralized-logger events and GenAI-semconv metrics when configured.\n- Enhanced `retry.fallbackChains` wildcards to support id-prefixed targets and keys, allowing more flexible model fallback routing across different providers.\n- Added an opt-in per-project model role storage mode with global fallback from the model selector.\n- Added per-advisor on/off toggle (`enabled: false` in `WATCHDOG.yml`): advisors stay in the roster but their runtime is never built \u2014 they show `\u25cb` in `/advisor status` rather than disappearing. Existing configs are backward-compatible (defaults to `true` when absent).\n- Colored the status line's advisor `++` badge by roster health (green all running, yellow quota-exhausted, red failed, dim paused); per-advisor glyphs (`\u25cf`/`\u25cb`/`\u2715`) show in `/advisor status`.\n- Added real provider quota display (usage percent, window, reset timer) to `/advisor status` and the `/advisor configure` preview.\n\n### Changed\n\n- Changed Bash command timeouts to render with a warning (yellow) border instead of an error (red) border, while still indicating to the model that the command did not complete normally.\n- Made the hashline seen-line guard opt-in and off by default via `edit.enforceSeenLines`, and improved handling of column-clipped lines so single-line edits on long lines apply without a full-width re-read.\n- Changed bundled TTSR rules to warn without interrupting generation.\n- Renamed the system prompt's project-context section wrapper from `` to `` to prevent collisions with the `task` tool's `context` parameter.\n- Enriched `/advisor status` to show per-advisor status glyphs, model, spend breakdown, and quota window for every configured advisor (including disabled ones), replacing the previous single-advisor-only summary.\n\n### Fixed\n\n- Fixed loading issues for linked legacy extensions importing `DefaultPackageManager` or `linkedom`.\n- Fixed the advisor retrying terminal, non-retriable provider failures (e.g., blocked prompts), ensuring they fail immediately while transient failures still retry.\n- Fixed an issue where reassigning the `plan` role model mid-planning did not take effect until the next plan-mode entry; it now applies at the next turn boundary.\n- Added managed timer helpers (`ctx.setInterval`, `ctx.setTimeout`, `ctx.clearTimer`) to the extension context to prevent self-scheduled callbacks from throwing uncaught exceptions and crashing the session.\n- Fixed `/quit` and `/exit` leaving stalled automatic title-generation requests alive during session teardown.\n- Fixed `startup.quiet` still rendering the `xdev: xd://: mounted` status line when MCP tools connect.\n- Fixed command errors in the `hub` tool when using a non-POSIX shell.\n- Fixed xdev-routed checkpoint and rewind writes not tracking checkpoint state.\n- Fixed the built-in advisor silently failing when its model routes through the Cursor provider by adding a Cursor execution bridge scoped to its granted tool set.\n- Fixed the fullscreen plan-review overlay staying visible until the approved execution turn finished; it is now hidden as soon as execution begins.\n- Fixed MCP tools repeatedly unmounting and remounting mid-session due to overlapping sanitized prefixes, and resolved stale tools remaining registered after disconnecting a server with special characters.\n- Fixed the `/usage show` marker and TUI usage panel to display and preserve the active organization suffix (`email (OrgName)`) to distinguish between multiple credentials with the same email.\n- Fixed Windows stdio MCP servers launched through `.cmd` or `.bat` shims failing with `Transport closed` by properly escaping arguments and spawning with `windowsVerbatimArguments`.\n- Fixed a startup crash on Windows when running from a drive root (e.g., `R:\\`).\n- Fixed unknown `__omp_worker_*` CLI selectors exiting with code 0 instead of throwing an error.\n- Fixed Plan Review capturing mouse drags as pointer events, which prevented native terminal text selection.\n- Fixed orphaned TUI processes remaining alive after a fatal error and causing high resource consumption.\n- Fixed approved-plan execution looping through filesystem searches when a model rewrites the required plan read path.\n- Fixed Ask dialogs immediately accepting highlighted answers when they appear while the user is typing a space.\n- Stopped post-compaction auto-continue from opening another primary turn after a terminal text answer with no queued work.\n- Fixed the `write` approval gate misclassifying `xd://` device writes as `exec` when the mounted tool declared a function-valued approval.\n- Fixed custom LSP servers (such as `roslyn-language-server`) crashing when requesting unconfigured workspace configuration sections.\n- Fixed late user-initiated bash results being recorded in whichever session or branch was active when execution finished; they now retain their originating transcript.\n- Fixed Claude Code marketplace plugins with `scope: \"local\"` leaking skills, hooks, tools, commands, and MCP servers into unrelated projects.\n- Fixed headless `omp -p` waiting indefinitely after a completed turn when final consolidation stalls.\n- Fixed explicit-tool sessions bypassing `xd://` presentation for ambient discoverable custom and MCP tools.\n- Fixed `providers.webSearch: kimi` incorrectly sending Moonshot credentials instead of Kimi Code credentials.\n- Fixed `registerTool` demoting essential built-in tools to `discoverable` when a re-registration omitted `loadMode`.\n- Fixed the advisor skipping the next user instruction after auto-learn accepted and pruned a terminal empty assistant stop.\n- Fixed built-in advisors retrying quota- or rate-limited providers instead of applying the matching `retry.fallbackChains` model chain.\n- Updated model selector status messages to use role tags (`SMOL`, `SLOW`) instead of display names (`Fast`, `Thinking`) for consistency.\n- Fixed Cursor models receiving only top-level tools by forwarding mounted `xd://` devices through Cursor's request-context MCP catalog.\n- Fixed Windows bash crashes when a piped command times out while flushing output.\n- Fixed a race condition where hub/IRC `send` and `ensureLive` could inject into a subagent session during disposal.\n- Migrated legacy nested/dotted configuration keys (`dev.autoqa.consent` and `todo.reminders.max`) to flat keys (`dev.autoqaConsent` and `todo.remindersMax`) on settings load.\n- Fixed keyboard input dying after the first keypress when a custom tool module attaches a stdin consumer at import time.\n- Fixed the alignment of the ask tool's custom-input dialog to start at column 0.\n- Fixed advisor context maintenance undercounting the provider context by anchoring compaction decisions on provider-reported context usage.\n- Fixed RPC mode (`--mode rpc`) crashing on non-JSON stdin lines; malformed lines are now reported as errors while the frame loop continues.\n- Fixed local llama.cpp Qwen-family models not honoring the `--thinking off` flag.\n- Documented the `ultrathink`, `orchestrate`, and `workflowz` magic keywords, including their effects, matching rules, and settings.\n- Fixed `/clear` autocomplete selecting `/autoresearch` and updated `/clear` to start a new session as an alias for `/new`.\n- Fixed `/review` aborting entirely when GitHub rejects a pull request's aggregate diff for exceeding the line limit by falling back to the paginated per-file endpoint.\n- Fixed `/q` + Enter running `/queue` instead of `/quit` by adding an explicit `q` alias to `/quit`.\n- Fixed Ctrl+L (`app.display.reset`) not refreshing the dark/light theme on certain terminals by issuing a background re-query before repainting.\n- Fixed a failing advisor stalling the primary agent: the per-turn catch-up gate parked the primary for up to its full 30s budget while a broken advisor (unsupported model, dead endpoint, render bug) retried \u2014 and an advisor exception could abort the primary's turn-end outright. A failing advisor now releases parked waiters the moment its turn fails (before any async hook), refuses new parks until a turn succeeds, and the turn-end boundary isolates advisor exceptions completely; a failed render restores the delta cursor so nothing is lost when the advisor recovers.\n- Fixed advisors retrying a permanently rejected request forever (e.g. `invalid_request_error: model not supported with this account`): unlike quota exhaustion \u2014 which pauses with a notice until an explicit reset \u2014 this class notified once and silently kept re-attempting every turn, re-building heavy context in a shared daemon. The runtime now hard-stops after a permanent rejection or three consecutive backlog-drop cycles, with a visible notice; an explicit reset (`/new`, config rebuild, restart) re-enables it. `waitForCatchup` resolves immediately while halted so the primary agent is never parked on a runtime that cannot drain.\n\n## [17.0.1] - 2026-07-16\n\n### Changed\n\n- `omp usage` and the in-session `/usage` view now show the Anthropic organization next to the account for org-scoped credentials (with `--redact` masking applied per part in the CLI, falling back to the org id when no display name is available), attribute \"no usage data\" rows per organization, and match the \"in use by this session\" marker by organization so only the active subscription is flagged. The OAuth login success message names the account and organization that was stored \u2014 a login landing on an unintended subscription is visible immediately.\n- `/logout` labels Anthropic accounts with their organization and marks only the credential of the active organization as active; `omp token --list` shows the organization next to each account. Two subscriptions sharing one email are distinguishable when selecting which to remove or mint a token for.\n- `omp auth-broker migrate --from-local` dedupes Anthropic OAuth identities per organization, so a Team seat already on the broker no longer blocks uploading the personal plan under the same email.\n- The status line invalidates its cached usage when the session rotates to a different Anthropic organization (previously the old subscription's quota could linger for the cache TTL), and `omp auth-gateway check` labels each credential with its organization so a failing row says which subscription needs re-login.\n- `omp usage` \"no usage data\" attribution is org-decisive whenever either the stored account or a report carries an organization: an org-less legacy credential whose own fetch failed is no longer hidden by an org-attributed sibling report sharing the same email.\n- Active-account matching for `/usage`, `/logout`, and `omp token --list` now treats a shared organization as a qualifier rather than a match: two Anthropic Team seats in one org (same org id, per-user pools) no longer flag each other's rows or reports as \"in use by this session\" \u2014 the base identity (account/email/project) is still required, with org-only sessions matching on the org alone.\n- `omp usage` \"no usage data\" coverage now requires the member's own identity within a shared organization: a sibling Team member's same-org report no longer counts as coverage for an account whose own report is missing, while an org-only account remains covered by any same-org report.\n- `omp auth-broker migrate --from-local` reruns now recognize an already-migrated org-only Anthropic row (login recovered neither email nor account) by its organization id instead of re-uploading it, which could overwrite the broker's newer refresh token with the stale local one.\n- Updated tangential agent forks to ignore parent session history and focus exclusively on the new request\n- Hardened `/tan` fork isolation: the clone's inherited todo list is cleared at fork (parent todo reminders no longer drag the tan back onto the parent's task), the fork notice warns that the parent is concurrently editing the same working directory, and the notice is re-injected after each compaction so the fork boundary survives summarization\n- Added visual markers in the transcript for elided tool calls that have no corresponding result\n- Updated status event log to prioritize the most recent entries in the display window\n- Updated the snapcompact shape preview transcript to use the compact scope format shown to models during compaction.\n\n### Fixed\n\n- Fixed `xd://` mount notices triggering unsolicited model turns by deferring hidden notices until the next user prompt.\n- Fixed `xd://` device tools appearing in the direct tool inventory and prompting invalid function calls ([#5797](https://github.com/can1357/oh-my-pi/issues/5797)).\n- Fixed `history://` read selectors being treated as part of the agent id instead of paging the transcript ([#5806](https://github.com/can1357/oh-my-pi/issues/5806)).\n- Narrowed the `history://` contract in the system prompt to match the implementation: it serves registered agents process-wide plus persisted subagents discoverable from their artifact trees, but does not discover unregistered top-level sessions solely from persisted session files ([#5839](https://github.com/can1357/oh-my-pi/issues/5839)).\n- Fixed expanded `!` bash and `eval` output keeping a stale `\u2026 N more lines (ctrl+o to expand)` footer after Ctrl+O revealed every line ([#5842](https://github.com/can1357/oh-my-pi/issues/5842)).\n- Fixed MCP reauthentication continuing to an authorization URL without `client_id` after dynamic client registration fails; the registration error now blocks the flow with the provider response details ([#5852](https://github.com/can1357/oh-my-pi/issues/5852)).\n- Fixed collapsed todo views hiding the in-progress task in large phases. Both the transient `Todo` tool result and the sticky `Todos` HUD now share one walking-viewport policy: completed/abandoned tasks are omitted, every active task (the in-progress one, or a pending task a live subagent is executing) is pulled to the head in todo order, remaining rows fill with the following pending tasks, and an explicit `\u2026 N more active todos` summary is shown when active work alone exceeds the preview cap ([#5873](https://github.com/can1357/oh-my-pi/issues/5873)).\n- Fixed legacy provider extensions failing to load when they use the historical synchronous auth-storage surface ([#5879](https://github.com/can1357/oh-my-pi/issues/5879)).\n- Fixed orphaned detached MCP stdio server process trees surviving session dispose by escalating stdin-EOF \u2192 group SIGTERM \u2192 group SIGKILL on close() (#5578)\n- Fixed `/new` starting an unsolicited old-context provider turn when a hidden steer (e.g. an `xd://` mount notice) was queued: the session transition is now an atomic boundary, so a queued steer/follow-up can no longer auto-resume against the pre-`/new` context while the session is disconnected mid-transition. `/compact` still resumes a steer/follow-up that arrives while it runs, draining the queue once it reconnects ([#5800](https://github.com/can1357/oh-my-pi/issues/5800)).\n- Fixed signed thinking-only Claude stops being discarded and retried as empty responses ([#5881](https://github.com/can1357/oh-my-pi/issues/5881)).\n- Fixed repeated URL reads and URL-backed searches returning stale same-session responses instead of refetching the resource ([#5803](https://github.com/can1357/oh-my-pi/issues/5803)).\n- Fixed `read`/`write` not recognizing ZIP-based `.jar`/`.war`/`.ear`/`.apk` files as archives, so `read lib.jar:META-INF/MANIFEST.MF` failed with path-not-found ([#5808](https://github.com/can1357/oh-my-pi/issues/5808)).\n- Fixed legacy binary `.doc`/`.ppt`/`.xls`/`.rtf` being advertised as convertible in `read`, `fetch`, and CLI `@file` handling despite having no markit converter, which surfaced an `Unsupported format` error instead of falling through to normal file handling ([#5808](https://github.com/can1357/oh-my-pi/issues/5808)).\n- Fixed Kimi Code transport selection to follow live per-model protocol metadata by default while preserving explicit OpenAI and Anthropic overrides ([#5893](https://github.com/can1357/oh-my-pi/issues/5893)).\n- Fixed repeated edit-tool rejections from local models by recovering comma-separated ranges and malformed trailers, while clarifying canonical string input and `.=` syntax ([#5805](https://github.com/can1357/oh-my-pi/issues/5805)).\n- Fixed LSP diagnostics and edit-time diagnostics writethrough for pull-only servers that advertise `textDocument/diagnostic` statically or through dynamic registration ([#5825](https://github.com/can1357/oh-my-pi/issues/5825)).\n- Fixed local `!` command output concatenating carriage-return progress updates by preserving them as readable line boundaries ([#5845](https://github.com/can1357/oh-my-pi/issues/5845)).\n- Fixed `hub`/`irc` peer discovery after process-crash resume by restoring persisted subagents as parked peers before listing the roster ([#5864](https://github.com/can1357/oh-my-pi/issues/5864)).\n\n### Removed\n\n- Removed the unreliable Bing and Yahoo HTML-scraping web search providers\n\n## [17.0.1] - 2026-07-16\n\n### Removed\n\n- Fixed a crash when a plugin/custom tool renderer returns a component that throws during its later `render()` pass (e.g. `TypeError: th.bold is not a function` from a plugin that styles its header off an object without a `bold` method). `ToolExecutionComponent` now wraps every renderer-returned call/result component so a throwing `render()` degrades to the safe fallback (tool label or raw result text) instead of taking down the transcript ([#4978](https://github.com/can1357/oh-my-pi/issues/4978)).\n- Fixed `/login` for paste-code providers (Codex, Anthropic, Gemini CLI, GitLab Duo, Antigravity, Devin) dropping the pasted fallback redirect URL: the login dialog captured focus but never mounted an input, and the \"complete pairing with `/login `\" tip pointed at the hidden, unfocused editor. The dialog now mounts a focused input for the manual code/URL paste ([#5339](https://github.com/can1357/oh-my-pi/issues/5339)).\n- Fixed `/tan` and `/fork` clones cold-missing the provider prompt cache: the per-turn supersede/useless-result prune rewrote the live context without persisting it, so file-based forks and resume rebuilt a divergent (un-pruned) prefix and re-wrote the entire cache\n- Fixed `/tan` pinning the clone's prompt-cache key to the parent's session id instead of the parent's effective cache key, dropping shard affinity when the parent was itself a fork or tan\n- Fixed `/resume` and plan approval exposing the previous session while their asynchronous session replacement was still loading by keeping fullscreen overlays mounted until the rebuilt transcript is ready ([#5319](https://github.com/can1357/oh-my-pi/issues/5319)).\n- Fixed inconsistent history rendering when toggling the display setting for compacted items\n- Fixed configured `retry.fallbackChains` never engaging on non-retryable provider errors (e.g. \"Cloud Code Assist API returned an empty response\"): a hard error on a model covered by a fallback chain now switches to the next candidate instead of failing the turn, while still never backoff-retrying the failing model itself\n- Fixed transcript rebuilds (compaction, `/compact`, and toggling history display) repainting content below stale scrollback when collapsing history; rebuilds now correctly clear the scrollback buffer when history is collapsed\n- Improved auto-compaction to automatically drop images and elide content when context is tight, and added persistent warning badges to the compaction divider when manual intervention is required\n- Fixed backgrounded Bash blocks continuing to repaint with live and final job output; they now freeze with a compact job notice while completion is delivered separately\n- Fixed the downshift plan nudge silently ending the run with no code written when the model answered with a text-only reply (no tool call): the agent loop treats a tool-call-free turn as a natural stop and never prompts again, which the nudge's own \"write the plan in your next reply\" instruction makes common. The nudge now explicitly tells the model this is a checkpoint, not a final answer, and the session forces one more turn whenever a post-nudge reply lands with zero tool calls\n- Fixed launch tool rendering stacking a stale pending header over a bare `\u2713 Launch` line and raw text: the tool now uses a merged registry renderer with one per-op status header (op, target, `state \u00b7 pid \u00b7 uptime` meta), stripped log cursor suffixes, capped collapsed log/list previews, and a launch tool glyph\n- Fixed confusing launch start/wait results when readiness timed out with the log pattern already matched (readiness needs log AND port): the result printed a contradictory `Ready: ` next to `Readiness timed out` without naming the failing condition. Daemon snapshots now carry the unmet conditions (`readyPending`), and start/wait results state exactly what never happened (e.g. `port 3100 on 127.0.0.1 never accepted connections`); the TUI shows a `waiting on port` badge on starting daemons\n- Fixed the in-process `stat` builtin mangling BSD-style invocations like `stat -f \"%Sm %N\" file` (macOS muscle memory): GNU `-f` means `--file-system`, so the format string was treated as a file operand \u2014 printing filesystem info for the real operands and erroring with `cannot read file system information for '%Sm %N'`. A `-f` whose format value contains `%` is now detected as BSD syntax and translated to the GNU equivalent (`%Sm`\u2192`%y`, `%N`\u2192`%n`, `%z`\u2192`%s`, epoch/`S`-form times, owner/group/permission and `H`/`L` sub-field directives, `-L`/`-n`/`-q`/`-F` flag clusters, with `%n`/`%t` as literal newline/tab); directives with no GNU counterpart fail with a clear `unsupported BSD format directive` error\n- Fixed the remaining GNU-flavored shell builtins that broke under macOS/BSD muscle memory, using the same unambiguous-detection approach as the `stat` fix (only invocations that are invalid or nonsensical under GNU semantics are reinterpreted; unsupported BSD forms fail loudly instead of producing wrong output): `date -r ` formats the epoch when no such file exists (GNU `-r FILE` mtime preserved), signed `date -v\u00b1N` adjustments translate to `-d` relative dates and `-j` is accepted (`-j -f` strptime parse mode and field-set `-v` error clearly); `sed -i '' 's/\u2026/\u2026/' file` drops the BSD empty backup-suffix token instead of treating it as the script; `mktemp -t prefix` without X's creates `$TMPDIR/prefix.XXXXXXXXXX` (the GNU `too few X's` error path); `tail -r` reverses input by delegating to `tac` (with `-n`/`-c`/`-f` combinations erroring clearly); `find -E` maps to `-regextype posix-extended` ahead of the expression; `base64 -D` decodes as an alias of `-d`; and `ln -sfh` works via a `-h` alias of `--no-dereference` (clap's `-h` help short is dropped to match real GNU/BSD ln; `--help` unchanged)\n- Fixed the browser tool crashing the whole process (parent session and every subagent) when a CDP world re-acquire failed mid-navigation: the stealth `puppeteer-core` patch called the bare `debugError` logger, which is `undefined` while the `puppeteer:error` debug channel is disabled (the default), turning a transient acquire failure into a fatal `TypeError` unhandled rejection. The patched `FrameManager`/`WebWorker` acquire paths now use `debugCatchError` ([#5296](https://github.com/can1357/oh-my-pi/issues/5296))\n- Fixed a role with a `:high` thinking suffix resolving to a longer sibling model whose id embeds the tier name (e.g. `kimi-for-coding:high` \u2192 `kimi-for-coding-highspeed`). The thinking suffix is now stripped before any fuzzy match, so `provider/model:high` keeps the exact model at high effort ([#5151](https://github.com/can1357/oh-my-pi/issues/5151)).\n\n### Fixed\n\n- Fixed the `omp grep` CLI subcommand failing on paths with a stray leading colon (e.g. `:/abs/path`); it now routes the path argument through `expandPath` like `read`/`edit`/in-agent `grep`. Broadened `expandPath`'s leading-colon strip to also recover Windows-style shapes (`:C:\\repo\\file`, `:.\\src`, `:..\\rel`, `:\\\\server\\share`) ([#5624](https://github.com/can1357/oh-my-pi/issues/5624)).\n- Fixed the `tail` builtin exiting the entire omp process with code 13 on Windows when its output pipe broke (e.g. `seq ... | tail -n 3 | head -n 0`); a broken pipe now surfaces as a normal error instead of calling `std::process::exit` ([#5609](https://github.com/can1357/oh-my-pi/issues/5609)).\n- Fixed a late advisor `blocker` after a terminal primary answer being deferred to the next user turn instead of continuing the current turn: `resolveAdvisorDeliveryChannel` preserved every interrupting severity as a passive card once the primary ended with a terminal text answer and no queued work remained, so a `blocker` flagging a mistake in the final output sat idle until the next prompt. A `blocker` now steers a triggered turn so the primary acknowledges and continues before the turn is considered done; a late `concern` still preserves as a visible card ([#5628](https://github.com/can1357/oh-my-pi/issues/5628)).\n- Fixed independently keyed extension hook statuses sharing one truncated line; each status now renders on its own deterministic line ([#5617](https://github.com/can1357/oh-my-pi/issues/5617)).\n- Fixed xAI web search bypassing configured `xai` / `xai-oauth` proxy endpoints and headers, while preventing official OAuth tokens from being sent to custom endpoints ([#5599](https://github.com/can1357/oh-my-pi/issues/5599)).\n- Fixed `models.yml` rejecting the Anthropic `compat.supportsEagerToolInputStreaming` override for custom endpoints ([#5572](https://github.com/can1357/oh-my-pi/issues/5572)).\n- Fixed long streamed table responses duplicating in terminal scrollback when later rows widened an earlier column.\n- Fixed Bash internal URLs remaining unresolved when used as unquoted arguments inside command substitutions ([#5535](https://github.com/can1357/oh-my-pi/issues/5535)).\n- Fixed the built-in `fd` printing `fd: Broken pipe (os error 32)` when a downstream pipeline reader exited early (e.g. `fd \u2026 | head`); it now exits silently with 141 (128+SIGPIPE), matching real fd.\n- Fixed prewalk repeatedly continuing after a bash-only task such as `commit` had already completed ([#5551](https://github.com/can1357/oh-my-pi/issues/5551)).\n\n### Added\n\n- Fixed the Codex `config.toml` MCP importer dropping `cwd` and leaving relative `command` values unrooted, which broke the bundled Codex Computer Use server (`ENOENT` on spawn); relative `command`/`cwd` now resolve against the Codex config directory like the claude-plugins/omp-plugins providers ([#5561](https://github.com/can1357/oh-my-pi/issues/5561)).\n- Fixed streamed replace-mode edits with `ssh://` paths terminating the active prompt before normal tool dispatch ([#5552](https://github.com/can1357/oh-my-pi/issues/5552)).\n- Fixed concurrent provider OAuth refreshes from invalidating Anthropic's rotating refresh token, and prevented background usage probes from permanently disabling credentials after refresh failures ([#5396](https://github.com/can1357/oh-my-pi/issues/5396)).\n- Restored the regression test guarding compiled-binary web-search header generation: `browser-headers.ts` lazily constructs `header-generator` and falls back to a static Chrome profile when its `data_files` are absent, but the test defending that contract had been removed. Without the guard, a compiled binary threw `ENOENT` at import time, breaking the Bing `web_search` provider (`undefined is not a constructor`) and extension loading / `omp plugin install`. ([#5256](https://github.com/can1357/oh-my-pi/issues/5256))\n- Fixed browser tabs hanging indefinitely at `Closing ` when a worker, CDP target, browser process, or cmux surface stalls during teardown; close deadlines now release the operation with backend, tab, and pending-resource diagnostics. ([#5259](https://github.com/can1357/oh-my-pi/issues/5259))\n- Fixed the `agent:///` slash form failing to resolve a nested subagent's output: the path segment was always treated as a jq JSON-extraction key against `.md`, so a precise-planner reading its own scout child (`agent://Plan/Scout`) got `Not found`. The slash is now a hierarchy separator first (`agent://Parent/Child` \u2192 `Parent.Child.md`), falling back to JSON extraction only when no nested output matches the path. ([#5238](https://github.com/can1357/oh-my-pi/issues/5238))\n- Fixed fullscreen Plan Review jumping to the top while scrolling when a transient terminal resize or Markdown reflow made the body temporarily non-scrollable. ([#5232](https://github.com/can1357/oh-my-pi/issues/5232))\n- Fixed `generate_image` preferring Antigravity over the active session provider and stopping instead of trying the next credentialed provider after an image HTTP failure. ([#5218](https://github.com/can1357/oh-my-pi/issues/5218))\n- Fixed `/reload-plugins`, plugin setting changes, and `manage_skill` writes leaving runtime skills and `skill://` resolution stale until restart; sessions now rediscover enabled skills and rebuild `/skill:` commands before the next prompt ([#4996](https://github.com/can1357/oh-my-pi/issues/4996)).\n- Fixed documented `omp marketplace`/`discover`/`upgrade`/`uninstall`/`enable`/`disable` CLI verbs silently leaking to the model as a launch prompt instead of managing plugins. `omp marketplace add xyz` (and similar multi-word invocations following the documented `omp plugin ` grammar) now surface a hint pointing at the real `omp plugin ` command, while genuine prose prompts beginning with these words still route to `launch` ([#4845](https://github.com/can1357/oh-my-pi/issues/4845)).\n- Fixed `/mcp`, `/mcp list`, and `/tools` output duplicating in terminal scrollback when invoked during agent streaming by deferring command panels until the active turn ends ([#4806](https://github.com/can1357/oh-my-pi/issues/4806)).\n- Fixed bash/eval/ssh output that was only per-line column-capped being misreported as byte-window truncation, which appended a bogus `Showing lines X-Y of Z (\u2026B limit). Read artifact://N for full output` footer even though every line was shown. Column-cap trimming now surfaces solely as the `Some lines truncated to N chars` notice ([#4735](https://github.com/can1357/oh-my-pi/issues/4735)).\n- Fixed the `nerd` status-line preset's session icon using a removed Nerd Fonts v2 codepoint instead of the current Nerd Fonts v3 mapping ([#4795](https://github.com/can1357/oh-my-pi/issues/4795)).\n- Fixed omp crashing at startup (`TypeError: undefined is not an object (evaluating 'this.#theme.symbols.boxRound')`) after installing a plugin whose custom editor subclasses `CustomEditor`/`Editor` and forwards the upstream-pi `super(tui, theme, keybindings)` constructor \u2014 the arg order that `setEditorComponent`'s factory contract advertises. `CustomEditor` now resolves the real `EditorTheme` by shape rather than position and captures a leading `TUI` for plugin overrides ([#4766](https://github.com/can1357/oh-my-pi/issues/4766)).\n- Fixed `Other` response editors leaving Windows Terminal IME candidate windows at the terminal edge by forwarding dialog focus to the nested editor ([#4760](https://github.com/can1357/oh-my-pi/issues/4760)).\n- Rendered and persisted native OpenAI Responses `image_generation_call` results as session images ([#4768](https://github.com/can1357/oh-my-pi/issues/4768)).\n- Fixed ACP stdio EOF/EPIPE disconnects bypassing awaited session teardown and leaving in-flight tool calls pending in persisted rollouts ([#4788](https://github.com/can1357/oh-my-pi/issues/4788)).\n- Routed the print-mode assistant-error/aborted exit, RPC `pi.shutdown()` and stdin-EOF shutdowns, and the extension command-context `shutdown()` through the awaited, idempotent `session.dispose()` before `process.exit()`, so the bounded browser reaper (`releaseTabsForOwner`) always runs and OMP-owned Chromium no longer outlives the process ([#5643](https://github.com/can1357/oh-my-pi/issues/5643)).\n\n## [17.0.0] - 2026-07-15\n\n### Breaking Changes\n\n- Merged the `irc`, `job`, and `launch` tools into a single unified `hub` tool (`loadMode: \"essential\"`). Messaging, job control, and process supervision operations are now routed through this single tool. SDK: `IrcTool`, `JobTool`, `LaunchTool`, `IrcDetails`, and `JobToolDetails` have been removed in favor of `HubTool`, `CoordinationDetails`, `LaunchToolDetails`, and `hubToolRenderer` from `tools/hub`.\n- Removed the hidden `resolve` tool. Staged actions are now finalized through three plain-text resolution devices: `xd://resolve` (apply preview), `xd://reject` (discard preview), and `xd://propose` (submit a plan slug/title for approval). The `write` tool is now auto-included whenever a deferrable tool is present or plan mode is enabled. SDK: `ResolveTool` and `HIDDEN_TOOLS.resolve` have been removed in favor of `dispatchResolutionDevice()` and `queueResolveHandler()`.\n- Unified tool presentation on `loadMode` (`essential` | `discoverable`), replacing the custom-tool `xdev?: boolean` opt-out. Custom, extension, MCP, RPC host, image-generation, and TTS tools now default to `discoverable` and mount under `xd://` when enabled. `generate_image`, `tts`, and MCP tools are now exposed as `xd://` devices in default sessions instead of shipping their schemas top-level.\n- Removed the BM25 tool-discovery system, including the `search_tool_bm25` tool, the `tools.discoveryMode`, `mcp.discoveryMode`, and `mcp.discoveryDefaultServers` settings, and per-tool MCP selection. All connected MCP tools are now enabled and mounted under the `xd://` transport. SDK: `search_tool_bm25`, the `tool-discovery` module, and associated `AgentSession` discovery/MCP-selection methods have been removed.\n- Removed the legacy `report_finding` tool. Reviewer agents now record findings through incremental `yield` sections. SDK: `reportFindingTool` and `HIDDEN_TOOLS.report_finding` have been removed.\n- Removed the `ssh` agent tool (remote command execution). The `ssh://` read/write/search protocol, the `omp ssh` host-management CLI, and SSH host discovery are retained. SDK: `SshTool`, `loadSshTool`, the `ssh/ssh-executor` module, and `AgentSession.refreshSshTool` have been removed.\n- Removed the `tools.essentialOverride` setting, the `mcp_tool_selection` session message type, and the `xdev` `--tools` token.\n\n### Added\n\n- Added `xd://` virtual tool devices (controlled by the `tools.xdev` setting, default on), allowing mounted tools to be discovered via `read xd://`, documented via `read xd://`, and executed via `write xd://`.\n- Added the `edit.enforceSeenLines` setting (default off) to gate the hashline seen-line guard. When enabled, edits anchored on lines that a prior `read` or `grep` never displayed are rejected.\n- Added per-agent prewalk for subagents, featuring a `prewalk` frontmatter field, a `task.agentPrewalk` settings override toggled from the `/agents` dashboard, and a `task.prewalk` boolean (default off) to arm the bundled generic `task` agent.\n\n### Changed\n\n- Renamed `\"dev.autoqa.consent\"` to `\"dev.autoqaConsent\"` and `\"todo.reminders.max\"` to `\"todo.remindersMax\"` to eliminate nested configuration prefix collisions in standard JSON/YAML.\n- Made the hashline seen-line guard opt-in and off by default, and stopped excluding column-clipped (>512-char) lines from a snapshot's seen set, allowing single-line edits on long lines to apply without a full-width re-read.\n- Changed the default `astGrep.enabled` setting to `false`.\n- Batched todo operations with real tool calls to prevent solo todo turns and extra round trips.\n- Changed all bundled TTSR rules to warn instead of interrupting generation.\n- Renamed the system prompt's project-context section wrapper from `` to `` to prevent collisions with the `task` tool's `context` parameter under in-band XML tool dialects.\n- Rendered `read xd://` calls in a compact grouped read view instead of a full tool-execution card.\n- Updated `--tools` to reject unknown tool names with a usage error instead of silently narrowing the toolset.\n- Capped the `xd://` device docs inlined into the system prompt to a 48k-char budget (10k per device) to prevent large MCP catalogs from bloating requests; devices past the cap are listed by name and summary and fetched on demand. External (dynamic-mount) tool descriptions embed at most 200 chars \u2014 schemas stay intact, full text via `read xd://`.\n- Dead BM25-discovery settings keys (`tools.discoveryMode`, `tools.essentialOverride`, `mcp.discoveryMode`, `mcp.discoveryDefaultServers`) are cleaned from configs on load; `tools.xdev` keeps its default (`true`).\n- Mid-session `xd://` mount changes (e.g. MCP connect/disconnect) no longer rewrite the system prompt: the delta is announced to the model as a steered system notice (\"these tools became available\" / \"no longer mounted\"), so the provider prompt cache stays intact; device docs join the prompt on the next unrelated rebuild.\n\n### Fixed\n\n- Fixed a bug where a nested configuration value (like `dev.autoqa.consent` / `dev.autoqaConsent`) would incorrectly satisfy a parent key lookup (like `dev.autoqa`), causing Auto QA to be enabled and prompt for consent by default when it should have been disabled.\n- Fixed compiled appserver startup deadlocking before socket creation when user extensions were present.\n- Fixed Bash internal URLs remaining unresolved when used as unquoted arguments inside command substitutions.\n- Fixed `--tools` silently dropping hidden tool names like `xdev` and `yield`.\n- Fixed the built-in `fd` printing broken pipe errors when a downstream pipeline reader exited early; it now exits silently with status 141.\n- Fixed prewalk repeatedly continuing after a bash-only task (such as `commit`) had already completed.\n- Fixed the Bash tool hanging when in-process commands read process substitution operands.\n- Fixed `/share` and `/export` web views rendering inline Markdown inside list items as literal text.\n- Fixed plan-mode re-entry dropping a new plan request when a prior plan artifact existed; re-entry now anchors on the new request and folds old-plan corrections into it.\n- Fixed ACP clients rendering `xd://` device dispatches as file edits; they now map to an `execute`-kind tool call titled with the device URL.\n- Fixed non-yolo approval modes double-prompting for `xd://` device dispatches.\n- Fixed TTSR rules with leading inline regex flags failing to compile and being silently dropped in Bun/JS environments, and recovered scope tokens and sibling values from malformed frontmatter.\n\n## [16.5.2] - 2026-07-14\n\n### Breaking Changes\n\n- Removed the separate `selector` parameters from `read` and `grep`; line ranges and read modes must now be appended to `path`.\n\n### Added\n\n- Added a `generate_image.enabled` setting (Settings \u203a Tools \u203a Generate Image) to allow toggling the image generation tool.\n\n### Changed\n\n- Expanded provider rate-limit response header ingestion to all supported providers with header parsers (previously Anthropic-only), enabling proactive account rotation for multi-account sessions before hitting 429 errors.\n- Restored CPU model metadata in workstation prompts on non-Linux hosts.\n\n### Fixed\n\n- Fixed `omp config list --json` output truncation at 64 KiB when stdout is piped.\n- Fixed vim-style navigation (`h`/`j`/`k`/`l`) under the Kitty keyboard protocol.\n- Fixed `/guided-goal` throwing `Model not found` errors on websocket-only Codex models by routing the interview through the session's provider transport and reusing a single isolated side session.\n- Fixed `tool_result` extension handlers being unable to rewrite the model-visible content of a thrown tool failure.\n- Fixed intermittent Perplexity OAuth web search failures (401 errors) caused by transient transport drops on the ask endpoint.\n- Fixed the `generate_image` tool ignoring `--no-tools` and explicit tool whitelists.\n- Fixed markerless prose thinking preambles incorrectly becoming session titles when title models omit the `` marker.\n- Fixed the agent recreating a todo list immediately after a user clears it with `/todo rm`.\n- Fixed internal-URL autocomplete (`agent://`, `skill://`, `omp://`, etc.) not triggering inside slash command arguments.\n- Fixed the browser tool hanging indefinitely during tab closure when the headless Chromium process is wedged on Windows.\n- Fixed `history://` URLs failing to resolve for unregistered, released, or resumed subagents by falling back to scanning artifacts directories on disk.\n- Fixed eval cells treating `timeout: 0` as a one-second deadline and reporting session-deadline cancellations as user aborts.\n- Fixed MCP OAuth dynamic client registration for pathful authorization-server issuers by preserving the discovered registration endpoint.\n- Fixed the `launch` tool failing to start Windows executables due to double-escaped PTY commands and arguments.\n- Fixed the built-in advisor warning `Advisor unavailable` for silent reviews: a content-less stop is a valid \"nothing to add\" outcome and is never retried or warned about, regardless of reported token usage ([#5212](https://github.com/can1357/oh-my-pi/issues/5212) follow-up).\n- Fixed `read`, `edit`, and `grep` tools failing on paths with a stray leading colon emitted by some models.\n- Fixed git plugin re-installs retaining stale commits by fetching Bun's cached clone before updating the lockfile pin.\n- Fixed overlapping Bash timeout and interrupt cleanup to explicitly abort isolated shells instead of leaving child processes running.\n- Fixed a bug where generic provider aborts arriving as `stopReason: \"error\"` were not auto-retried.\n- Fixed switching from a vision model to a text-only model mid-session sending historical image blocks to the new provider.\n- Fixed inline images in Agent Hub transcripts by routing replayed images through the shared image budget and Kitty placeholder renderer.\n- Fixed OSC 5522 paste in direct API-key login prompts being routed to the hidden main chat editor instead of the focused credential field.\n- Fixed plugin installation failures when an ES module extension synchronously requires CommonJS helpers.\n- Fixed GitHub code search rejecting empty optional date placeholders.\n- Fixed `/tree` navigation onto a `/skill:` injection node landing on the incorrect entry.\n- Fixed interactive TUI sessions crashing with concurrent JS runtime errors when the JS eval worker falls back to the in-process inline path.\n- Fixed compaction aborting instead of trying an authenticated fallback model when Amazon Bedrock credential resolution fails.\n- Fixed full-context forks and `/tan` clones cold-missing OpenAI prompt caches by properly persisting and inheriting provider prompt-cache keys.\n- Fixed Codex advisor requests using local session labels as provider session IDs.\n- Fixed macOS stdio MCP servers launching in a detached session, allowing the TCC Apple Events permission prompt to trigger.\n- Fixed the ask tool timeout to auto-select the recommended option when the UI selector does not settle.\n- Fixed LSP workspace diagnostics for Go workspaces to correctly recognize `go.work` roots and include all used modules.\n- Fixed interactive OAuth login success messages waiting on background model discovery.\n- Fixed Windows bash tool crashes when an explicit timeout fires while a piped command is still streaming.\n- Fixed subagent `yield` tool calls being discarded when the soft request budget hard-aborted the same assistant turn.\n- Fixed `--tools` filtering in interactive sessions disabling deferred MCP tools.\n- Fixed kept-alive task subagents entering repeated provider-call loops after an IRC wake and terminal yield.\n- Fixed manual `/compact` with the snapcompact strategy hard-failing on text-only active models.\n- Fixed the empty-editor `\u2190\u2190` gesture trapping input when opening the Agent Hub from persisted/parked subagents.\n- Fixed eval `read()` URI handling in Python and JS runtimes to correctly delegate URI reads and pass pagination arguments.\n- Fixed discovered plugin `.mcp.json` stdio servers launching relative `command` or `cwd` values against the session cwd instead of the plugin's config directory.\n- Fixed Model Hub DEFAULT role assignments with `auto` retaining a stale concrete reasoning suffix after restart.\n- Fixed configured `retry.fallbackChains` failing to engage on non-retryable provider errors.\n- Fixed backgrounded Bash blocks continuing to repaint with live output after completion.\n- Fixed `--reasoning-slide-plan` silently ending the run with no code written when the model answered with a text-only reply.\n- Fixed launch tool rendering issues, including stacked pending headers and confusing start/wait results when readiness timed out.\n- Fixed the in-process `stat` and other GNU-flavored shell builtins (such as `date`, `sed`, `mktemp`, `tail`, `find`, `base64`, and `ln`) mangling or failing on macOS/BSD-style invocations.\n\n## [16.5.1] - 2026-07-14\n\n### Changed\n\n- Enhanced Anthropic credential and usage management to support organization-scoped accounts, including displaying organization names in /usage, /logout, omp token --list, and OAuth login success messages, resolving active-account matching for shared organizations, and deduplicating identities during migration.\n\n## [16.5.0] - 2026-07-13\n\n### Breaking Changes\n\n- Replaced the `--reasoning-slide-*` flag family with a unified `--prewalk` mechanism (`--prewalk`, `--prewalk-into `, and `--no-prewalk`) to manage model handoffs during execution.\n\n### Added\n\n- Added a new `--prewalk` execution flow (with `--prewalk-into ` and `--no-prewalk` overrides) that starts tasks on a strong model for planning and todo initialization before handing off to a faster, cheaper model for implementation.\n - Added a status line annotation for the active prewalk phase (armed or active).\n - Added the `tui.scrollbackRebuild` setting to gate the erase-and-replay native scrollback rebuild mechanism (defaults to off).\n- Added a display setting to toggle between collapsing or keeping compacted history inline in live session displays.\n- Added a compact session-only model picker (Alt+P) for quick model switching, featuring `@` search to quickly list and apply configured quick roles.\n- Redesigned Agent Hub entries into a cleaner two-line card layout showing identity, active model, reasoning level, age, and task description.\n- Added a project-scoped `launch` tool (gated by `launch.enabled`) for managing shared long-running services and debuggers, featuring readiness probes, bounded logs, PTY input, restart policies, and automatic teardown.\n- Added support for `detached` launches, allowing standalone services to survive broker shutdowns and reconnect to subsequent sessions.\n\n### Changed\n\n- Updated JSON logs (`--mode json`) to include provider payloads in auto-compaction events.\n- Updated tangential agent forks (`/tan`) to ignore parent session history and focus exclusively on the new request, hardening isolation with cleared todo lists and concurrent editing warnings.\n- Added visual markers in the transcript for elided tool calls that have no corresponding result.\n- Updated the status event log to prioritize the most recent entries in the display window.\n- Upgraded `@agentclientprotocol/sdk` to version 1.2.1.\n\n### Fixed\n\n- Fixed terminal scrollback duplication issues with expanded streaming edit previews (Ctrl+O) by using a viewport-sized tail window.\n- Fixed custom model role resolution and alias parsing, ensuring canonical role selectors (`@role`) and thinking suffixes resolve correctly across all configuration surfaces.\n- Fixed quadratic growth in JSON logs by eliding redundant message snapshots and payloads.\n- Fixed prompt cache misses and incorrect cache key pinning for `/tan` and `/fork` clones.\n- Fixed inconsistent history rendering and scrollback repainting when toggling the display setting for compacted items.\n- Fixed `retry.fallbackChains` failing to engage on non-retryable provider errors, ensuring the agent correctly falls back to the next candidate model.\n- Improved auto-compaction to automatically drop images and elide content when context is tight, and added persistent warning badges when manual intervention is required.\n- Fixed backgrounded Bash blocks continuing to repaint with live output; they now freeze with a compact job notice while completion is delivered separately.\n- Fixed rendering, status display, and PTY control sequence formatting issues in the `launch` tool.\n- Fixed in-process shell builtins (including `stat`, `date`, `sed`, `mktemp`, `tail`, `find`, `base64`, and `ln`) to correctly detect and translate macOS/BSD-style arguments and flags, preventing failures caused by GNU-only assumptions.\n\n### Removed\n\n- Removed the `--prewalk-boomerang` feature and its associated configuration setting.\n- Removed the unreliable Bing and Yahoo HTML-scraping web search providers.\n\n## [16.4.8] - 2026-07-12\n\n### Added\n\n- Added invocation-specific schemas to task subagents and unified task/eval agent execution, including host-enforced read-only plan-mode agents ([#5279](https://github.com/can1357/oh-my-pi/issues/5279))\n\n### Fixed\n\n- Fixed compatibility of GNU-flavored shell builtins (such as stat, date, sed, mktemp, tail, find, base64, and ln) when invoked with macOS/BSD-style arguments.\n- Fixed subagent model and thinking level resolution to correctly respect the configured modelRoles.task selector instead of intermittently falling back to the parent session's model.\n- Fixed TUI rendering issues, including preventing macOS runtime diagnostics from painting into the viewport, bounding transcript retention in long sessions, and fixing scrollback repainting when collapsing history.\n- Fixed /tan and /fork clones failing to inherit or persist the parent session's prompt cache keys.\n- Fixed Python and JavaScript evaluation kernels suspending the CLI on subprocess foregrounding, deadlocking on non-serializable values, or losing in-flight subagent work during external aborts.\n- Fixed configured retry.fallbackChains failing to engage when encountering non-retryable provider errors.\n- Improved auto-compaction to automatically drop images and elide content when context is tight, and added persistent warning badges to the compaction divider when manual intervention is required.\n- Fixed the downshift plan nudge silently ending runs with no code written when the model answered with a text-only reply.\n- Fixed launch tool rendering and status reporting, including resolving contradictory readiness timeout messages and preventing backgrounded Bash blocks from continuing to repaint.\n- Fixed Advisor containment and timing issues, preventing hallucinated tool calls from contaminating later advice and ensuring late-arriving transcript deltas are coalesced before advisor calls.\n- Fixed omp update on npm-managed Windows installations to prevent downloaded release binaries from overwriting npm launchers.\n- Fixed --max-time duration values (e.g., 5s, 10m, 1h) being ignored instead of setting a session deadline.\n- Fixed omp plugin install --force failing with a dependency loop when replacing an existing pinned Git plugin source.\n- Fixed MCP tools receiving session image attachments as raw local:// URIs instead of resolving them to local filesystem paths.\n- Fixed Pyright LSP semantic requests hanging during startup.\n- Fixed Codex web search requests for GPT-5.6 Responses-Lite models.\n- Fixed custom model/provider configuration discovery to correctly load ~/.omp/agent/models.yaml when models.yml is absent.\n\n## [16.4.8] - 2026-07-12\n\n### Added\n\n- Added a predicate form to the browser run's `wait()` helper: `wait(fn, { timeout?, interval? })` polls the function (sync or async) until truthy and resolves with that value, failing with a named timeout error (deadline clamped under the cell budget so it always beats the opaque whole-cell timeout) instead of Bun's `sleep expects a number` or a whole-cell stall from in-page polling Promises; both `wait` forms now register in the stall diagnosis of cell timeouts\n- Added `--reasoning-slide-model` and `--reasoning-slide-turns` to switch a running agent from its initial model after a fixed number of completed assistant turns\n- Added `--reasoning-slide-plan` (with `--reasoning-slide-plan-at`) to steer a hidden deep-planning nudge into the run before the reasoning slide; the switch is held until a substantial plan turn actually lands (bounded by a grace window) and the nudge is scrubbed from the LLM context at the switch so the fast model inherits only the produced plan\n- Added `--reasoning-slide-on-action` to trigger the reasoning slide at the first completed turn that ran an edit/write tool instead of a fixed turn count (bash is excluded \u2014 it doubles as exploration)\n\n### Changed\n\n- Replaced the Alt+P / `/switch` temporary model selector's fullscreen /models hub with a compact full-width floating overlay anchored above the editor (~40% of the terminal height): just the searchable model list \u2014 no provider sidebar or role management \u2014 with the session's active model highlighted and preselected\n- Improved tab recovery after timeouts by automatically clearing pending navigation and JS dialogs\n- Made `tab.goto` navigation failures catchable with a named error instead of triggering a whole-cell timeout\n- Made `tab.evaluate` run in the page's main JavaScript world so page-defined globals are available without a directive\n- Enhanced cell timeout messages to include identification of stalled operations and blocking JS dialogs\n- Browser `run` on a tab the supervisor force-killed now reports the kill reason instead of a bare \"not alive\"\n- Refined agent workflow to prioritize smoke testing and reduce mandatory upfront test generation\n\n### Fixed\n\n- Fixed the eval tool's status-event tree truncating from the bottom: the newest `log()` progress lines were hidden behind an `\u2026 N more` marker while the oldest stayed visible; the tree now shows a tail window behind an `\u2026 N earlier` marker, and the expanded view widens to the viewport instead of a fixed 10 events\n- Fixed the `//!world=main` directive being silently ignored for string expressions passed to raw Puppeteer evaluation APIs\n- Fixed tab reuse issues where hung navigation or unhandled modals would cause initialization to stall and trigger a force-kill\n- Improved search reliability for Perplexity provider by forcing retrieval for all queries\n- Fixed JS eval cells losing top-level `function` and `var` declarations across cells when the defining cell contained top-level `await` \u2014 the async wrapper scoped them to the cell's IIFE instead of publishing them to the worker global\n\n## [16.4.7] - 2026-07-12\n\n### Added\n\n- Enabled Home and End keyboard navigation in the model browser\n- Added a `c` hotkey in the plan-review overlay that copies the current reviewed plan markdown to the system clipboard, including in-overlay edits.\n\n### Changed\n\n- Streamlined list view styling by removing inline model role chips from row entries\n- Reworked /models hub selection visuals: the background highlight band is reserved for mouse hover, the keyboard position is a cursor glyph drawn only in the pane that owns the arrow keys, and the sidebar's active scope renders as a bold accent label\n- Removed the redundant \"login\" label from inactive (locked) provider entries in the Model Hub sidebar\n\n### Fixed\n\n- Fixed PageUp/PageDown in the model browser wrapping past the list edges instead of clamping\n- Fixed the hover highlight sticking to the last hovered model row when the pointer moved into the provider sidebar\n\n## [16.4.6] - 2026-07-12\n\n### Added\n\n- Added `invalidate` action to the usage command to clear cached usage reports\n- Added model-oriented keys and wildcard entries to `retry.fallbackChains`: a `provider/model-id` key attaches a fallback chain to that exact model, a `provider/*` key covers every current or future model of a provider, and a `provider/*` chain entry keeps the failing model's id while swapping the provider (`google-antigravity/x` \u2192 `google/x`) \u2014 so fallbacks survive role and model reassignments without config edits. Keys resolve by specificity: exact model, then provider wildcard, then role, then `default`.\n- Added fallback-chain editing to the /models Roles view: each role's `retry.fallbackChains` entries render as indented rows beneath it, `f` picks a fallback model to append, Enter on an entry replaces it, `x`/backspace removes it, and `[`/`]` (or shift+\u2191/\u2193) reorder the chain.\n- Added model-keyed fallback management to the /models Roles view: model and `provider/*` chains render as a separate section below the roles (divider + \"+ New fallback\u2026\" row for creating one by picking the protected model, then keying it by model or provider), with the same replace/remove/reorder editing as role chains; the model strip gains `fallbacks:` and `fallbacks:/*` chips as shortcuts.\n- Added `/queue ` plus `->` / `=>` composer shorthand for follow-up messages that wait until the agent yields. The shorthand opens a dim `Queueing` header and splits sequential numeric, Roman-numeral, or alphabetic lists into separately highlighted queue entries.\n- Added per-model TPS/TTFT tracking: every completed assistant turn folds its timing into recency-weighted aggregates in `~/.omp/agent.db`, and the /models browser shows measured speed \u2014 a right-aligned `118t/s` column on wide terminals (plus TTFT, e.g. `0.9s 118t/s`, when wider) and `~118t/s \u00b7 0.9s ttft` facts in the selection detail line \u2014 with no dependency on the `omp stats` session scan.\n\n### Changed\n\n- Retain completed and abandoned tasks in session history for improved context on resume\n- Changed the Model Hub `retry-fallback` strip chip to append the model to the default fallback chain instead of prepending it, matching the chain-building order of the Roles view (already-registered models are a no-op).\n- Changed per-model perf recording (`recordModelPerf`) to be deferred like prompt history: samples are batched and written to `agent.db` in one transaction ~100ms later, keeping SQLite writes off the turn-completion hot path.\n\n### Fixed\n\n- Fixed failure to trigger model fallback when the retry budget is exhausted by credential rotation\n- Fixed uncontrollable mouse-wheel scrolling in the /models hub: the wheel moved the selection (one step per wheel event, so a single trackpad flick skipped many rows) and wrapped from the bottom back to the top. Wheel scrolling now pans the list viewport only, clamps at the ends, and leaves the selection where it is; keyboard navigation still scrolls the selection into view. Likewise, the wheel over the provider sidebar no longer switches the active scope (or triggers provider refreshes) \u2014 it just scrolls the sidebar.\n- Fixed TPS being inflated several-fold when a provider hides reasoning tokens until late in the stream (e.g. `google/gemini-3.5` vs `google-vertex/gemini-3.5` reporting 648 vs 186 TPS for identical durations): `omp bench`, the per-turn usage row, and the /models perf aggregates now measure tokens/sec over the total request duration instead of the post-TTFT decode window, matching `omp stats`. Stored perf aggregates are purged and re-backfilled from stats history with the corrected math on first launch.\n- Fixed the model-perf stats.db backfill freezing the TUI (~30s on multi-million-row stats databases) when /models triggered it: the import is now fire-and-forget, walks the newest rows in small chunks with event-loop yields between them, and is bounded to 90 days / 256 newest samples per model \u2014 beyond either bound the recency decay would erase the contribution anyway.\n- Fixed compiled release binaries bundling `fastembed` and baking the build-machine `@anush008/tokenizers` path; native runtime dependencies now stay external for every compiled build path so Mnemopi resolves its on-demand install instead. ([#5195](https://github.com/can1357/oh-my-pi/issues/5195))\n- Fixed `/btw` side-channel turns on Codex models such as `gpt-5.6-luna` by preserving the session websocket preference instead of forcing SSE, and made Esc dismiss the active `/btw` panel before interrupting loop/maintenance work. ([#5213](https://github.com/can1357/oh-my-pi/issues/5213))\n- Fixed the Model Hub role-assignment strip hiding the selected chip once the row overflowed; the strip now scrolls horizontally, truncating passed chips behind a leading ellipsis so the selection (plus one chip of lookahead) stays visible.\n- Fixed mouse hover and clicks in the /models Roles view landing one row above the pointer (the row mapping subtracted the status row twice).\n- Fixed model search keeping the most-recently-used model on top of the results: match quality now ranks first (an exact `gpt-5.5` beats the active `gpt-5.6-sol`), with MRU order only breaking ties between equally good matches.\n\n## [16.4.5] - 2026-07-11\n\n### Breaking Changes\n\n- Reworked the task tool wire schema: moved the top-level agent field into individual task items, renamed assignment to task and id to name, and removed the role and description fields. UI labels are now automatically generated from the task text.\n\n### Added\n\n- Introduced a fullscreen, mouse-supported Model Hub (via /model) featuring a sidebar of scopes, metadata-aligned model tables, inline role/thinking assignment strips, custom role creation, quick-switch cycle editing, and manual provider refreshing.\n- Added a /pause command to freeze all active agents (main, subagents, and advisor) at their next safe step, allowing manual repository edits mid-run before resuming.\n- Added support for per-ID bulk conflict directives via write({ path: \"conflict://*\", content: \"...\" }) to resolve multiple conflicts in a single call.\n- Added auto as a valid thinking-level in agent frontmatter, which is now the default for the bundled task subagent.\n- Added rich, interactive, fixed-height ask dialogs featuring question tabs, option previews, notes, and multi-select toggles.\n\n### Changed\n\n- Redesigned OAuth logins to run inside a cancellable dialog (aborted via Esc) rather than an inescapable pairing prompt.\n- Reworked the subagent soft request budget to gracefully steer child agents to wrap up and yield partial findings instead of silently terminating them, and raised the default budget to 200 requests.\n- Updated task rendering to retain the agent type badge on live progress and finished result rows.\n\n### Fixed\n\n- Fixed issues where in-flight tool calls or task blocks would disappear from the chat during mid-turn transcript rebuilds or when background jobs settled.\n- Fixed mixed blocking and non-blocking task batches degrading all spawns to synchronous execution; execution mode is now correctly handled per item.\n- Fixed budget-stopped subagents becoming unreachable, allowing them to remain adopted and resumable via irc with full context.\n- Fixed code duplication in write conflict:// when models pasted lines adjacent to the marker block.\n- Fixed visible per-keystroke lag when searching in the /resume session picker by caching search targets and debouncing SQLite lookups.\n- Fixed compiled Linux binary extension loading failures related to bundled web-search header generation data paths.\n- Fixed job list and empty-poll snapshots returning empty output, ensuring running subagents without backing jobs are properly listed.\n- Fixed agents getting stuck waiting for messages from peers that have already stopped running.\n- Fixed compiled Linux binary extension loading when bundled web-search header generation cannot read `header-generator` data files from the build-time path. ([#5178](https://github.com/can1357/oh-my-pi/issues/5178))\n- Fixed plugin custom tool loading to skip and report invalid feature entries instead of crashing startup when a plugin dependency tree leaves one feature unresolved. ([#5189](https://github.com/can1357/oh-my-pi/issues/5189))\n\n## [16.4.4] - 2026-07-11\n\n### Changed\n\n- Optimized session title generation and auto-thinking classification for sub-billion-parameter tiny models (such as LFM2) by rewriting system prompts, improving input truncation to preserve message context, and unifying preprocessing to filter out noise like ANSI codes, XML tags, and long commit hashes.\n\n### Fixed\n\n- Fixed an issue where the Windows binary exited silently without running the CLI, which also caused `omp update` to roll back.\n- Fixed native Windows binary compatibility on older Windows 10 CPUs by building the `omp-windows-x64.exe` release asset with a baseline x64 runtime instead of AVX2. (#5172)\n- Fixed `GenerateImage` rejecting OpenAI Codex-compatible proxy bearer keys when the token does not expose a `chatgpt-account-id`. (#5174)\n- Fixed context promotion documentation to accurately reflect the `contextPromotionTarget` runtime behavior and `contextPromotion.enabled` default. (#5163)\n\n## [16.4.3] - 2026-07-11\n\n### Added\n\n- Added /vibe mode, allowing the model to act as a director driving persistent background worker sessions (fast and good tiers) with dedicated session tools (vibe_spawn, vibe_send, vibe_wait, vibe_kill, vibe_list) and a live TUI \"TV wall\" showing active worker activity, tool traces, and streamed output.\n- Added multiple credential-free web search providers (Google, Bing, Yahoo, Startpage, Ecosia, Mojeek) with stealth-browser escalation, bot challenge detection, and recency filters, alongside a parallel public (\"Public Web\") provider that aggregates and deduplicates results across all engines.\n- Added PCRE2 fallback support for grep lookaround and backreferences when the default Rust regex engine rejects a pattern.\n- Added a helpful stderr hint when launching omp acp from an interactive terminal to clarify that the command communicates via JSON-RPC over stdout.\n\n### Changed\n\n- Reduced browser action timeout from 15s to 8s to improve agent iteration speed.\n- Refined agent delegation logic to prioritize top-level planning by the primary agent, discourage single-agent delegation, and handle prerequisite work inline.\n- Optimized credential-free web search engine ordering and routing, prioritizing Startpage and Ecosia, and using randomized desktop Chrome profiles with stealth-browser escalation for blocked requests.\n\n### Fixed\n\n- Fixed advisor config preserving an explicit empty tool list so `/advisor config` can disable all advisor tools. ([#5155](https://github.com/can1357/oh-my-pi/issues/5155))\n- Fixed npm bundle generation failing on Linux with E2BIG by building dist/cli.js in-process via Bun.build instead of passing the embedded docs payload as a CLI --define argument.\n- Fixed compiled-binary extensions failing to load native .node FFI dependencies by resolving platform-specific packages against the extension's own node_modules.\n- Fixed a hang in omp search and omp q CLI commands by ensuring the AuthStorage connection is properly closed upon completion.\n- Fixed write blocking for the full LSP diagnostics poll by deferring slow diagnostics to a late-diagnostics channel.\n- Fixed multiple browser and puppeteer tool issues, including locator action timeouts, missing console/print output buffering, missing fill() method on element handles, and incorrect viewport screenshots on multi-tab setups.\n- Improved browser selector error diagnostics to report match counts and abort early on empty matches instead of waiting for the full timeout.\n- Fixed silent failures, duplicate error messages, and unhandled provider errors in ACP mode when errors occurred before streaming assistant text.\n- Fixed glob reporting contradictory \"no files found\" messages on timeout by explicitly stating the scan was incomplete.\n- Fixed read adding unwanted context padding to raw range selectors (e.g., raw:31-31).\n- Fixed first-run interactive startup rendering the entire changelog when the last-seen marker is missing or unreadable (#5135).\n- Fixed empty local-model stop responses exhausting retries without displaying a user-visible error (#5128).\n- Fixed serialization of BigInt values in tool arguments during session compaction.\n- Fixed GPT-5.6 over-delegating work by centralizing task fan-out and concurrency policy in the system prompt.\n- Fixed session title generation including leaked thinking markup from OpenAI-compatible endpoints (#5122).\n- Fixed bare skill:// path-only resolution for bash, grep, and glob to resolve to the skill directory instead of SKILL.md (#5087).\n- Fixed macOS stdio MCP servers missing Apple Events TCC prompts by spawning MCP children via the correct Bun.spawn overload (#5085).\n- Fixed the /move directory picker drawing a narrow 68-column frame inside wider overlays (#5067).\n- Fixed snapcompact inline imaging for GitHub Copilot Business and Enterprise models (#4779).\n- Fixed omp commit agent sessions to ensure valid proposals are committed before teardown, handle missing host outputs with non-zero exits, and prevent forcing GPG_TTY on signing-enabled repositories (#4794).\n\n### Removed\n\n- Removed the bundled plan subagent from available task agents.\n\n## [16.4.2] - 2026-07-10\n\n### Fixed\n\n- Fixed an issue where BigInt values in tool arguments failed to serialize during session compaction.\n- Resolved an issue where GPT-5.6 over-delegated tasks by refining task fan-out and concurrency policies in the system prompt.\n- Fixed a race condition in concurrent MCP OAuth token refreshes across processes, ensuring rotating refresh tokens are only refreshed once and preventing stale token errors from clearing valid credentials.\n\n## [16.4.1] - 2026-07-10\n\n### Changed\n\n- Reduced agent bias against large diffs and refactors in advisor prompts\n- Updated advisor blocker criteria to prioritize explicit user instructions over plan size\n\n### Fixed\n\n- Fixed MCP OAuth dynamic client registration omitting discovered scopes on the RFC 7591 registration body. Providers such as Clerk bind DCR-created clients to only the scopes declared at registration, then reject the subsequent authorize request when it asks for `openid` (from `scopes_supported`). Registration now includes `config.scopes` when present, matching Claude Code and the scopes already sent on authorize.\n\n## [16.4.0] - 2026-07-10\n\n### Breaking Changes\n\n- Renamed the bundled agent explore to scout, including its configuration keys, prompt files, and task definitions. Any configurations, allowlists, or invocations referencing explore must now use scout.\n- Changed the public `selectLaunchAdapter()` result from `DapResolvedAdapter | null` to `LaunchAdapterSelection`; callers must handle `adapter`, `unavailable`, and `none` outcomes.\n\n### Added\n\n- Added a native, first-class max thinking tier for supported models, including a new thinkingBudgets.max configuration setting, support in CLI flags (--thinking, :max model suffixes), and terminal theme customization (thinkingMax border color and icons).\n\n### Fixed\n\n- Fixed Go debug launches falling back to native debuggers when Delve is unavailable; nested modules and `go.work` workspaces now resolve local Delve adapters before PATH, newly installed adapters are detected without restart, and missing adapter errors include install or configuration guidance. ([#5037](https://github.com/can1357/oh-my-pi/issues/5037))\n- Fixed a memory leak (large retained JavaScriptCore heaps) in the TUI during session transcript rebuilds and refreshes by properly handling snapcompact archive image frames.\n- Fixed a crash in interactive TUI sessions (Cannot set cwd while another same-realm JS runtime is running) when the JS evaluation worker falls back to the in-process inline path.\n- Fixed compaction aborting when Amazon Bedrock credential resolution fails, ensuring it now falls back to trying an authenticated model.\n- Improved OpenAI prompt cache hit rates for full-context forks by persisting inherited provider prompt-cache keys separately from session IDs, and added a --prompt-cache-key flag for explicit cache affinity.\n- Fixed Codex advisor requests incorrectly using local session labels as provider session IDs, switching to stable UUIDv7 provider identities.\n- Fixed macOS stdio MCP servers launching in detached sessions, allowing tools like xcrun mcpbridge to successfully trigger TCC Apple Events permission prompts.\n- Fixed the ask tool timeout behavior to automatically select the recommended option if the UI selector does not settle.\n- Fixed LSP workspace diagnostics for Go workspaces to correctly recognize go.work roots and include all specified modules in go build package patterns.\n- Fixed interactive OAuth login (/login xai-oauth) delaying success messages; credentials are now reported immediately while model metadata refreshes in the background.\n- Fixed a crash in the Windows bash tool when a timeout occurs while a piped command is streaming output.\n- Fixed subagent yield tool calls being discarded when a soft request budget aborts the assistant turn before the yield event completes.\n- Fixed --tools filtering in interactive sessions incorrectly disabling deferred MCP tools from configured servers.\n- Fixed kept-alive task subagents entering infinite provider-call loops after an IRC wake and terminal yield.\n\n## [16.3.15] - 2026-07-09\n\n### Changed\n\n- Integrated testing guidance directly into the main system prompt for improved workflow cohesion\n- Moved testing guidance into the main system prompt and removed the bundled Tester subagent.\n\n## [16.3.14] - 2026-07-09\n\n### Fixed\n\n- Fixed issue where unfinalized tool blocks could incorrectly pin the live-region scroll seam\n- Improved rendering of raw thinking blocks by stripping empty HTML comment noise\n- Fixed display of thinking blocks consisting entirely of hidden comment noise\n- Fixed gpt-5.6 reasoning summaries rendering literal `` sentinel lines in thinking blocks; empty HTML comments (and the unterminated `` placeholders with clickable `read :.png` handles, including line-range and multi-range reads\n- Changed the built-in `ts-no-any` rule to recommend a schema parse at trust boundaries and `in`-narrowing (instead of an inline `as`-cast) when reading fields off `unknown`\n\n### Fixed\n\n- Fixed legacy plugin validation for extensions that import `defineTool`, `StringEnum`, frontmatter helpers, `SettingsManager`, `createCodingTools`, or the bare `typebox` package through the hosted Pi compatibility shims ([#2858](https://github.com/can1357/oh-my-pi/issues/2858)).\n- Fixed edit seen-line guard mismatch assertion message formatting to report the actual state instead of generic failure notices\n- Fixed hashline edit mode rendering in the TUI when `setIgnoreTight` triggers synchronous display rebuilds in the constructor before `#editMode` is assigned, which previously caused the tool envelope target path to display as `\u2026` instead of the parsed hashline filename.\n- Fixed `omp ttsr scan` to discover files with gitignore-aware native globbing, skip binary/oversized files before text decoding, use a scan-specific matcher, keep default output summary-only, and avoid retaining per-file AST snapshots during scans\n- Fixed Perplexity web search to use shared OpenAI streaming transports while preserving streamed sources, citations, and related questions\n- Fixed `StatusLineComponent` fire-and-forget async callbacks (`#isDefaultBranch`, `#lookupPr`, `fs.watch`) firing `#onBranchChange` after `dispose()`, which reached the global `settings` proxy after tests called `resetSettingsForTest()` and threw \"Settings not initialized\" between test files; `dispose()` now sets a disposed flag, clears `#onBranchChange`, and every post-await continuation checks the flag before touching settings or the callback\n- Fixed `read :` errors for unknown PDF images to surface available extracted image names\n- Fixed puppeteer stealth scripts to use cached Reflect methods (`Reflect_get`, `Reflect_apply`) and `Reflect.apply` instead of live `Reflect`/`Function.prototype.apply` calls, preventing page tampering from leaking through proxy traps.\n- Fixed Perplexity API-key web search to use shared OpenAI streaming transports while preserving streamed sources and OpenRouter fallback.\n- Fixed subagents reporting success after a provider-error turn by preserving real run failures over earlier successful `yield` payloads, and retried bare OpenAI-compatible `finish_reason: \"error\"` provider failures after partial text instead of stopping immediately\n- Fixed MCP servers that do not implement `resources/templates/list` (JSON-RPC -32601) discarding their concrete resources; templates now fall back to an empty list ([#2838](https://github.com/can1357/oh-my-pi/pull/2838) by [@jms830](https://github.com/jms830))\n- Fixed provider setup sign-in URLs to attempt clipboard/OSC 52 copy and expose an Alt+C retry shortcut, so authentication is not blocked when TUI selection is unavailable ([#2908](https://github.com/can1357/oh-my-pi/issues/2908)).\n- Fixed ACP approval-mode documentation to describe config inheritance, `omp acp --yolo`/`--auto-approve` runtime overrides, client permission precedence, and headless prompt behavior ([#2900](https://github.com/can1357/oh-my-pi/issues/2900)).\n- Fixed `/guided-goal` to fall back to the current session model when neither the `plan` nor `slow` role resolves, instead of aborting during setup ([#2855](https://github.com/can1357/oh-my-pi/issues/2855)).\n- Fixed auto context-full maintenance to stop retrying the same summarization timeout before falling back to the next compaction model ([#2913](https://github.com/can1357/oh-my-pi/issues/2913)).\n- Fixed `/plan ` and `/goal ` to preserve the typed slash-command line in TUI input history when entering those modes from off ([#2887](https://github.com/can1357/oh-my-pi/issues/2887)).\n- Fixed `/model` in the TUI to open the active-session model switcher instead of the role-assignment picker ([#2846](https://github.com/can1357/oh-my-pi/issues/2846)).\n- Fixed Perplexity web search collapsing every upstream failure to a generic `401 No authentication method available` once all auth methods failed: the fallback loop now rethrows the last classified provider error (`402`/credits-exhausted, `429`, `5xx`), so quota and rate-limit failures are no longer mis-reported as authorization errors. The generic 401 is now only a defensive fallback for the no-method-ran case.\n\n### Security\n\n- Secured PDF image reads by validating requested image members against the extracted member list before opening files and refusing traversal-style names\n\n## [16.0.5] - 2026-06-17\n\n### Added\n\n- Added `tui.tight` setting (default `false`) to enable tight layout by removing the 1-character horizontal padding from terminal output.\n- Added a `providers.antigravityEndpoint` setting (`auto`, `production`, `sandbox`) to control google-antigravity routing for chat, search, image, and discovery calls\n- Added automatic endpoint-mode support for google-antigravity provider calls so users can force production-only or sandbox-only usage\n- Added `images.describeForTextModels` option (default `true`) to control automatic image description for attachments sent to models without vision input\n- Added automatic vision fallback prompts to describe images for text-only models\n- Added `advisor.immuneTurns` setting (default `1`) to limit how often advisor `concern`/`blocker` notes can interrupt the primary agent.\n- Added a main-session `session_stop` extension event with continuation feedback and an 8-continuation loop cap ([#2834](https://github.com/can1357/oh-my-pi/issues/2834)).\n- Added `--max-time ` so CLI sessions can stop after a wall-clock deadline.\n\n### Changed\n\n- Changed google-antigravity usage report lookups to honor the selected antigravity endpoint mode when resolving the reporting base URL\n- Changed context usage reporting to always return numeric token counts and percentages, so status-line and footer now show estimated values instead of `?` immediately after compaction\n- Changed context usage reporting to use anchored snapshots and pending-prompts estimates, which now keeps `/context`, status line, and model selector token counts in sync\n\n### Fixed\n\n- Fixed Matplotlib figure display to emit PNG output immediately when `display(fig)` is called, even if the figure is closed before the end-of-cell flush\n- Fixed persisted tool-result image payloads in `details.images` to externalize and resolve through the session blob store, so generated-image details survive resume without stale blob refs or truncation\n- Fixed duplicate Matplotlib image output by skipping the automatic end-of-request figure flush for figures that were already displayed through `display(fig)`\n- Fixed google-antigravity image generation and web search requests to fail over to the alternate antigravity endpoint on 429/server/network failures instead of stopping at the first endpoint\n- Fixed context usage breakdown to use a completed assistant usage anchor from the current turn instead of a pending prompt snapshot so totals no longer overcount when a large in-turn tool step returns usage\n- Fixed side-channel turns and advisor requests to keep using credential resolvers during retries, so Google `Resource exhausted` 429s can rotate to the next account instead of surfacing a terminal error banner\n- Fixed context token accounting to keep branch-local anchors during branching so sibling-branch messages no longer pollute context estimates\n- Fixed context usage consistency so `/context`, status line, and idle compaction logic now report the same used-token totals\n- Fixed status-line context cache invalidation when assistant reasoning signature data grows so displayed context usage updates accurately\n- Fixed the status-line context% reading inflated during long tool turns and then dropping sharply on the next message even though no compaction ran. While a request was in flight `getContextBreakdown` summed a cl100k estimate of the entire tail on top of the stale turn-start prompt and never re-anchored to completed in-turn steps; it now prefers the real provider prompt-token count of any step that resolves at or after the pending cutoff. The status-line memo also keys on a `contextUsageRevision` that bumps when the in-flight snapshot is set/cleared, so a mid-turn estimate is invalidated on turn end/abort instead of surviving into idle until the next message\n- Fixed image attachment handling for text-only models by saving attachments to `local://` and injecting generated descriptions so they are no longer lost when the target model cannot process images\n- Fixed the ssh tool rejecting valid Windows identity files before invoking OpenSSH by skipping Unix mode-bit key validation on native Windows ([#2850](https://github.com/can1357/oh-my-pi/issues/2850)).\n- Fixed `web_search`/`omp q` aborting before any provider ran when the global Settings singleton was not initialized; `executeSearch` now reads `providers.antigravityEndpoint` once and tolerates an uninitialized settings store instead of throwing\n- Fixed the new `git.enabled` and `images.describeForTextModels` settings declaring section groups (`Git`, `Vision`) that were not registered in `TAB_GROUPS`, so they now render in their intended settings-panel sections\n- Fixed Python `display(fig)` for Matplotlib figures to emit PNG output immediately, even when user code closes the figure before the end-of-cell flush.\n- Fixed persisted tool-result image payloads stored in `details.images` to externalize and resolve through the session blob store, so generated-image details survive resume without stale blob refs or truncation.\n- Fixed the `tools.format` setting schema so `minimax` can be selected as an owned tool-calling dialect, and taught auto mode to route tool-less MiniMax-family models to the MiniMax owned dialect. ([#2759](https://github.com/can1357/oh-my-pi/issues/2759))\n- Fixed WSL2 TUI stutter by adding a `git.enabled` setting and skipping footer/status-line git probes when disabled or when no git-backed status segment is visible ([#2847](https://github.com/can1357/oh-my-pi/issues/2847)).\n- Fixed JSON-mode startup notices (export/resume/session-picker messages) writing to stdout before the JSON event stream; they now route to stderr so stdout remains newline-delimited JSON.\n\n## [16.0.4] - 2026-06-17\n\n### Fixed\n\n- Fixed RPC/ACP startup forcing todo settings back to host defaults, so project-level `todo.enabled`, `todo.reminders`, and `todo.eager` opt-outs now suppress protocol-mode todo prompt injection; enabled todo reminders are now persisted to the JSONL transcript so the log matches the model-visible context ([#2824](https://github.com/can1357/oh-my-pi/issues/2824)).\n- Fixed default prompts to instruct the agent to read applicable `skill://` content before starting work, so discovered skills influence broad task requests like frontend generation ([#2829](https://github.com/can1357/oh-my-pi/issues/2829)).\n- Fixed hashline visible-line validation for ACP editor reads so `INS.POST` anchors displayed by bridge-backed range and multi-range `read` output are merged into the session snapshot before `edit` validates them ([#2773](https://github.com/can1357/oh-my-pi/issues/2773)).\n\n## [16.0.3] - 2026-06-16\n\n### Added\n\n- Added support for LaTeX color commands (`\\textcolor`, `\\colorbox`, and `\\fcolorbox`) in user-visible terminal prose and final chat to colorize output\n\n### Changed\n\n- Changed STT dependency setup to validate recorder and model assets per `stt.modelName`, so switching speech models re-runs dependency checks and downloads for the new model\n- Changed STT startup with cached models to warm the speech model in the background and defer full model loading until transcription begins, reducing push-to-talk start latency\n- Allowed user-visible terminal and final-chat responses to include LaTeX math delimiters/commands and Mermaid ` ```mermaid ` diagrams\n- Changed the hold-`Space` push-to-talk gesture to recognize a held bar from the *regularity* of the OS key auto-repeat rather than a raw space count or speed alone, so it no longer spams the editor, no longer eats deliberate space taps, and no longer triggers when the bar is smashed. Recording starts only after two consecutive inter-space deltas are \"mechanical\" \u2014 both fast (within ~120 ms) and near-identical, the metronomic signature of auto-repeat; the few pre-burst spaces typed are then tracked back out. Smashing (fast but jittery) and deliberate spacing (steady but slow) both keep typing real spaces and never start recording.\n- Updated markdown Mermaid rendering to color ASCII diagrams with the active theme and automatically choose a narrower layout that better fits the terminal width\n- Made the watched-session transcript sent to the advisor (and shown by `/advisor dump`) clearer: each turn now opens with a `### Session update` heading; watched-agent roles render as inline `**agent**:` / `**user**:` labels instead of level-2 headings that collided with the advisor's own turns; consecutive same-role messages collapse under one label (the watched agent emits one assistant message per tool call); and batched updates are joined by a blank line rather than a `---` rule.\n- Changed the compact transcript tool-intent prefix (`history://`, `/advisor dump`) from `# ` to `// ` so intent lines read as comments instead of rendering as Markdown H1 headings.\n- Changed the advisor advice injected into the primary transcript from a `Advisor (...): - [severity] note` prose block to one `\u2026` element per note, with XML-escaped bodies. (Relocated the shared `escapeXmlText` helper to `@oh-my-pi/pi-utils`.)\n- Reverted `/dump` and `/advisor dump raw` to the pre-16.x full verbose dump: system prompt, model/thinking config, tool inventory with parameters, and the message transcript rendered with markdown role headings (`## User`, `## Assistant`, `### Tool Call: ` with the call's `_i` intent as a `//` comment under the heading and the remaining arguments as a fenced YAML block, `### Tool Result: `, plus `## Bash Execution`/`## File Mention`/summary sections) instead of the model's native-dialect turn envelopes and ``/`` XML tool calls. Dropped the compact default and the `[raw]` flag on `/dump`; the compact `\u2192 tool(...) \u21d2 ok` history format is no longer reachable from `/dump`. `/advisor dump` still defaults to compact, and `/advisor dump raw` now renders the same markdown dump (previously the model's native-dialect envelopes).\n\n### Fixed\n\n- Fixed Whisper STT cache detection to require both encoder and decoder `.onnx` files, so partial model downloads now trigger a proper foreground download instead of being treated as fully cached\n- Fixed same-process `JsRuntime` cleanup so disposing an older inline/direct runtime no longer deletes a newer runtime's JS helper globals; inactive cmux/direct runtimes now re-activate their globals before sequential use while overlapping cross-runtime runs fail explicitly.\n- Fixed magic-keyword steering notices (`ultrathink-notice`, `orchestrate-notice`, `workflow-notice`) to be prepended before the related user message so they influence that same turn\n- Fixed dequeuing or popping queued user messages to remove their preceding hidden magic-keyword notice companions, preventing orphaned queued notices\n- Fixed queued user steers to auto-resume after interrupts even when the transcript tail is a preserved advisor card or other non-conversational custom message\n- Fixed queued user follow-up messages to remain queued after an interrupt and only run on explicit resume, even when an IRC wake leaves a provider-valid tail\n- Fixed stranded IRC asides to wake a response turn after interruption instead of remaining pending\n- Fixed accepted IRC asides to be flushed into the transcript during disposal instead of being discarded\n- Fixed interactive submissions made while the TUI had no active input waiter: they now start a real prompt directly, with steer fallback if a background turn races in, instead of queueing behind a non-resumable idle transcript and appearing to do nothing.\n- Fixed pressing Esc (or Alt+Up dequeue) while agent-authored messages were queued \u2014 advisor concern/blocker notes, hidden goal/plan/budget steers, IRC/extension asides \u2014 dumping their text into the user's editor. Editor restoration (`clearQueue()`), pending chips (`getQueuedMessages()`), and `popLastQueuedMessage()` now surface only genuinely user-authored queued messages (plain user turns and `attribution: \"user\"` custom messages like `/skill`). Plain Alt+Up dequeue leaves all other queued messages in place for the continuing stream; only the Esc interrupt path keeps just advisor cards (so abort's preservation still re-records them as visible advice) and drops other internal steers, so a user interrupt can't be silently undone by an auto-resume on leftover internal context. `queuedMessageCount` still reflects all actual queued work (advisor cards included) so `hasPendingMessages()`/RPC and the empty-submit abort gate stay accurate.\n- Fixed advisor `concern`/`blocker` advice being withheld from the running agent and then dumped as one burst at the next user prompt after a deliberate interrupt. A user interrupt latches advisor auto-resume suppression, but a non-user resume (synthetic/auto-continue, or a queued steer draining after the abort) leaves the run streaming with that latch still set, so every interrupting note was parked hidden in the next-turn queue instead of steered into the live turn \u2014 the agent never heard the advisor mid-run and the backlog flushed all at once on the next prompt. Suppression now only withholds interrupting advice while the agent is idle (or still tearing the interrupted turn down); once a turn is streaming again the note is steered in live, since steering an active run never auto-resumes a stopped one. A concern that strands in the steer queue past the resumed turn's final poll is reclaimed as visible advice when the agent settles (mirroring abort), so it neither auto-resumes the stopped run nor lingers to flush at the next prompt.\n- Fixed `omp --continue`/`-c` sometimes resuming into a subagent transcript instead of the interactive session. Subagent (and HTML-export) `SessionManager.open()` calls run in the parent's terminal and were clobbering the per-TTY `--continue` breadcrumb with their own artifact-dir session file; these headless opens now suppress the breadcrumb. `continueRecent()` also recovers already-poisoned breadcrumbs by resolving any session file inside a parent's artifacts dir (`/.jsonl`) back up to the top-level session.\n- Fixed the Agent Hub stacking duplicate `Agent Hub \u00b7 N running` frames and stranding garbage rows in scrollback while navigating with subagents still streaming. The hub was a non-fullscreen overlay composited over a live transcript, so each time a running subagent's progress grew the frame and scrolled the window the previously-painted hub copy was pushed permanently into the terminal's native scrollback (which the engine can't rewrite). It now renders inline in the editor slot \u2014 the same anchored region every other selector and the `ask` tool use \u2014 riding the normal append-only commit path, so the transcript commits above it exactly once and the hub repaints in place instead of leaking copies. (Avoids borrowing the alternate screen.)\n- Fixed every subagent registering itself as its own parent in the agent registry (`parentId === id`), so the Agent Hub rendered each agent as `sub \u00b7 of ` and the \u2190\u2190 parent-navigation gesture looped on the same agent. The SDK was reusing `parentTaskPrefix` \u2014 the agent's own artifact/output-id prefix \u2014 as the registry parent link; spawns now pass a separate `parentAgentId` (the spawning agent's id: `Main` for top-level `task` spawns, the parent subagent for nested spawns and eval `agent()`, the focused agent for `/tan`) and the registry records that as the parent.\n- Fixed messaging a `parked` subagent that was restored from disk (Agent Hub scan, or a resumed/restarted session) failing with `cannot be revived (no reviver registered)` even though its transcript was intact. Such refs carry a session file but no in-memory reviver \u2014 the executor's live reviver closure dies with the spawning turn/process \u2014 so IRC sends and Agent Hub focus refused them. `AgentLifecycleManager.ensureLive` now cold-revives them through a persisted-subagent reviver factory (installed by the top-level interactive/RPC session) that rebuilds the subagent from its JSONL the way `--resume` rebuilds a session: it reopens the file and replays it through `createAgentSession`, but sources the runtime contract from a now-readable `session_init` record (`SessionManager.peekSessionInit`) so tools, system prompt, output schema, and kind are restored rather than resurrected as a default top-level session. `session_init` now also persists the effective `spawns` allowlist and read-summarization flag so a cold revive keeps the original capability surface (old files without them deny re-spawning rather than defaulting to wildcard). Isolated runs and pre-`session_init` files whose recorded workspace no longer exists stay transcript-only (`history://`).\n- Fixed the terminal window-title OSC writes (`setTerminalTitle`/`pushTerminalTitle`/`popTerminalTitle`) leaking escape sequences to a developer's terminal during `bun test`; they now skip when the terminal is headless (the test-runtime default), matching the `ProcessTerminal` render/probe suppression so interactive-mode tests no longer paint to the real terminal\n- Fixed empty CLI sessions being retained after opening `omp` and exiting without a prompt ([#2800](https://github.com/can1357/oh-my-pi/issues/2800)).\n- Fixed `hooks/pre/*.ts` and `hooks/post/*.ts` files discovered through `hookCapability` being registered in discovery but never loaded into the extension runner, so their `tool_call` handlers now run without a manual `settings.json` `extensions` entry ([#2796](https://github.com/can1357/oh-my-pi/issues/2796)).\n- Fixed startup model fallback choosing the plain OpenAI `gpt-5.5` provider before the Codex OAuth provider when both shared the same default model id, which could surface a misleading OpenAI 401 despite valid Codex credentials ([#2807](https://github.com/can1357/oh-my-pi/issues/2807)).\n- Fixed local auto-thinking classification for reasoning-capable tiny models by giving them the same safe answer budget as online reasoning classifiers, with a larger local floor for non-reasoning tiny models ([#2808](https://github.com/can1357/oh-my-pi/issues/2808)).\n\n### Removed\n\n- Removed the built-in `render_mermaid` tool and its `renderMermaid.enabled` setting, so it can no longer be invoked directly\n\n## [16.0.2] - 2026-06-16\n\n### Added\n\n- Added the `UMANS_WEBSEARCH_PROVIDER` environment variable to CLI help for Umans gateway web search backend selection.\n\n### Changed\n\n- The eager `task` (`task.eager: always`) and eager `todo` (`todo.eager: preferred`/`always`) hidden reminders now re-fire on the auto-continuation turn after a compaction (context-full / snapcompact / handoff / shake). Compaction summarizes away the first-message prelude, so the agent would otherwise silently lose the delegate-via-tasks / phased-todo guidance mid-work; the post-compaction todo nudge is reminder-only and never forces the `todo` tool onto the resumed turn.\n\n### Fixed\n\n- Fixed edit-tool block operations on Emacs Lisp files: `.el` and `.emacs` paths now resolve top-level forms for `SWAP.BLK`, `DEL.BLK`, and `INS.BLK.POST` instead of reporting an unsupported-language block-resolution error.\n- Fixed PDF reads leaking recoverable MuPDF WASM warnings into the terminal TUI by routing MuPDF output through the file logger before `markit-ai` loads it ([#2766](https://github.com/can1357/oh-my-pi/issues/2766)).\n- Fixed `/exit` and `/quit` waiting one shutdown timeout per hanging extension by running `session_shutdown` handlers within a shared shutdown window ([#2736](https://github.com/can1357/oh-my-pi/issues/2736)).\n- Fixed GitHub Copilot `.github/instructions/*.instructions.md` discovery by loading those files as rules that honor `applyTo` scoping, including always-apply `**` files and `rule://` access for glob-scoped entries ([#2731](https://github.com/can1357/oh-my-pi/issues/2731)).\n- Fixed Windows bash-tool child processes defaulting interpreter pipe I/O to the ANSI codepage by adding UTF-8 encoding defaults when the inherited environment is unset ([#2701](https://github.com/can1357/oh-my-pi/issues/2701)).\n- Fixed `/advisor dump raw` so Opus 4.5 thinking content that already includes literal `` tags is not rendered with nested thinking tags ([#2700](https://github.com/can1357/oh-my-pi/issues/2700)).\n- The `plugin-extensions-discovery` test suite no longer writes fixtures into \u2014 and `rm -rf`s the `node_modules` of \u2014 the developer's real `~/.omp/plugins`. Its `XDG_DATA_HOME` isolation was a no-op on Windows (XDG is gated to Linux/macOS) and was bypassed in XDG-migrated Linux/macOS environments, so a local run could delete installed plugins. The suite now isolates the whole config root via an `os.homedir()` mock plus cleared `XDG_*` vars, with a pre-write guard that fails if resolution escapes the temp home ([#2721](https://github.com/can1357/oh-my-pi/issues/2721)).\n- Installed plugins whose `extensions` manifest entry points at a directory of sub-extensions (the standard pi `extensions//index.ts` layout, e.g. `pi.extensions: [\"./extensions\"]`) are no longer rejected at install (`declared extension entry not found on disk`) or silently dropped at load. The plugin manifest resolver now resolves a directory the same way as the configured-directory (`-e`) extension loader: the directory's own `package.json` `omp`/`pi` `extensions` (authoritative \u2014 a missing declared entry is reported instead of falling back to a decoy `index`), then a direct `index.{ts,js,mjs,cjs}`, then a one-level scan of sub-extensions ([#2713](https://github.com/can1357/oh-my-pi/issues/2713)).\n- Fixed OpenRouter `@upstream` routing selectors whose upstream slug also appears in the model id, so `openrouter/...@deepseek:high` keeps `openRouterRouting.only` instead of being consumed by provider-scoped fuzzy matching ([#2708](https://github.com/can1357/oh-my-pi/issues/2708)).\n- Fixed `omp plugin list --json` omitting locally linked plugins that exist only in `omp-plugins.lock.json` and `node_modules` symlinks. ([#2742](https://github.com/can1357/oh-my-pi/issues/2742))\n- Fixed task subagents to install their configured ordered model candidates as child-session retry fallback chains, so retryable provider failures can advance to the next subagent model instead of failing the worker ([#2750](https://github.com/can1357/oh-my-pi/issues/2750)).\n- Fixed empty reasonless aborted assistant turns to auto-retry without switching model fallback, so transient provider-side aborts after tool results do not end headless sessions ([#2685](https://github.com/can1357/oh-my-pi/issues/2685)).\n\n## [16.0.1] - 2026-06-15\n\n### Breaking Changes\n\n- **Settings:** `hooks` and `customTools` arrays replaced with single `extensions` array\n- **CLI:** `--hook` and `--tool` flags replaced with `--extension` / `-e`\n- **Directories:** `hooks/`, `tools/` \u2192 `extensions/`; `commands/` \u2192 `prompts/`\n- **Types:** See type renames above\n- **SDK:** See SDK migration above\n- **Key detection functions removed from `@mariozechner/pi-tui`**: All `isXxx()` key detection functions (`isEnter()`, `isEscape()`, `isCtrlC()`, etc.) have been removed. Use `matchesKey(data, keyId)` instead (e.g., `matchesKey(data, \"enter\")`, `matchesKey(data, \"ctrl+c\")`). This affects hooks and custom tools that use `ctx.ui.custom()` with keyboard input handling. ([#405](https://github.com/badlogic/pi-mono/pull/405))\n\n### Added\n\n- Added GitHub Copilot user-global discovery to the `github` provider: it now loads user-global instructions from `~/.copilot/copilot-instructions.md`, honors the `COPILOT_HOME` relocation override, reads each directory listed in `COPILOT_CUSTOM_INSTRUCTIONS_DIRS` for an `AGENTS.md` and `.github/instructions/**/*.instructions.md` (matching Copilot CLI), scans the project `.github/instructions/` tree recursively, and surfaces VS Code Copilot prompt files (`*.prompt.md`) from `.github/prompts/` as slash commands. Previously only the project `.github/` tree was scanned, so Copilot CLI users' cross-repo config was silently ignored. Closes #1913, #1915, #1916.\n- Added web search provider exclusions so `web_search` can skip configured providers without disabling them for model use ([#2608](https://github.com/can1357/oh-my-pi/issues/2608)).\n- Added an optional `role` field to `task` spawns that gives each subagent a tailored specialist identity: the role is injected as a system-prompt specialization preamble and becomes the subagent's display name and telemetry identity in the registry, IRC roster, and Agent Hub, so delegated trees are no longer clones of one generic worker ([#2467](https://github.com/can1357/oh-my-pi/issues/2467))\n- Added a non-blocking specialization advisory to the `task` tool: when a spawner with remaining depth capacity spawns generic role-less workers (a `task`/`quick_task` spawn without a `role`, or the same agent cloned \u22652\u00d7 all without roles), the result steers it toward tailored specialists. Gated so a leaf at max recursion depth is never nudged; the task-tool depth gate is extracted into a shared `canSpawnAtDepth` helper ([#2469](https://github.com/can1357/oh-my-pi/issues/2469))\n- Added a work-aware IRC roster: `irc list` and the subagent peer roster now show each peer's current activity (a short gist of its latest intent/tool) alongside its role-derived display name, so a tree of tailored specialists is legible enough to coordinate. Backed by a new display-only `activity` field on the agent registry ([#2470](https://github.com/can1357/oh-my-pi/issues/2470))\n- Added proactive IRC coordination: when one `task` call spawns \u22652 live siblings with spawn capacity remaining, the result suggests coordinating overlapping work via `irc` (composed onto the specialization advisory), and the subagent COOP/`irc` prompts now actively steer discovery (`list`), coordination (message before overlapping edits), and follow-up (`replyTo`/`await`) instead of only assuming agents resolve collisions on their own ([#2471](https://github.com/can1357/oh-my-pi/issues/2471))\n- Added `/review` support for explicit GitHub pull request URLs and detected PR URLs from recent conversation context ([#1743](https://github.com/can1357/oh-my-pi/issues/1743)).\n- Added a `plan.defaultOnStartup` setting (Tasks tab, default off) that automatically enters plan mode at the start of a new interactive session. It applies to any session that opens with no prior history \u2014 including a `--continue`/auto-resume that finds no recent session and starts fresh \u2014 while sessions with restored history keep the mode reconciled from that history. It is a silent no-op when plan mode is globally disabled (`plan.enabled`), and the setting is hidden from the settings UI unless plan mode is enabled.\n- Added `UMANS_AI_CODING_PLAN_API_KEY` to the CLI environment help ([#2636](https://github.com/can1357/oh-my-pi/pull/2636) by [@oldschoola](https://github.com/oldschoola)).\n- Added `WebSearchProviderError` class with HTTP status for actionable provider error messages\n- `$ARGUMENTS` syntax for custom slash commands as alternative to `$@` for all arguments joined. Aligns with patterns used by Claude, Codex, and OpenCode. Both syntaxes remain fully supported. ([#418](https://github.com/badlogic/pi-mono/pull/418) by [@skuridin](https://github.com/skuridin))\n- Configurable double-escape action: choose whether double-escape with empty editor opens `/tree` (default) or `/branch`. Configure via `/settings` or `doubleEscapeAction` in settings.json ([#404](https://github.com/badlogic/pi-mono/issues/404))\n- Vertex AI provider (`google-vertex`): access Gemini models via Google Cloud Vertex AI using Application Default Credentials ([#300](https://github.com/badlogic/pi-mono/pull/300) by [@default-anton](https://github.com/default-anton))\n- Built-in provider overrides in `models.json`: override just `baseUrl` to route a built-in provider through a proxy while keeping all its models, or define `models` to fully replace the provider ([#406](https://github.com/badlogic/pi-mono/pull/406) by [@yevhen](https://github.com/yevhen))\n- Automatic image resizing: images larger than 2000x2000 are resized for better model compatibility. Original dimensions are injected into the prompt. Controlled via `/settings` or `images.autoResize` in settings.json. ([#402](https://github.com/badlogic/pi-mono/pull/402) by [@mitsuhiko](https://github.com/mitsuhiko))\n- Alt+Enter keybind to queue follow-up messages while agent is streaming\n- `Theme` and `ThemeColor` types now exported for hooks using `ctx.ui.custom()`\n- Terminal window title now displays \"pi - dirname\" to identify which project session you're in ([#407](https://github.com/badlogic/pi-mono/pull/407) by [@kaofelix](https://github.com/kaofelix))\n- Hook API: `ctx.ui.setTitle(title)` allows hooks to set the terminal window/tab title ([#446](https://github.com/badlogic/pi-mono/pull/446) by [@aliou](https://github.com/aliou))\n- Hook API: `before_agent_start` handlers can now return `systemPromptAppend` to dynamically append text to the system prompt for that turn. Multiple hooks' appends are concatenated.\n- Hook API: `before_agent_start` handlers can now return multiple messages (all are injected, not just the first)\n- New example hook: `tools.ts` - Interactive `/tools` command to enable/disable tools with session persistence\n- New example hook: `pirate.ts` - Demonstrates `systemPromptAppend` to make the agent speak like a pirate\n- Tool registry now contains all built-in tools (read, bash, edit, write, grep, find, ls) even when `--tools` limits the initially active set. Hooks can enable any tool from the registry via `pi.setActiveTools()`.\n- System prompt now automatically rebuilds when tools change via `setActiveTools()`, updating tool descriptions and guidelines to match the new tool set\n- Hook errors now display full stack traces for easier debugging\n- Clipboard image paste support via `Ctrl+V`. Images are saved to a temp file and attached to the message. Works on macOS, Windows, and Linux (X11). ([#419](https://github.com/badlogic/pi-mono/issues/419))\n- Configurable keybindings via `~/.pi/agent/keybindings.json`. All keyboard shortcuts (editor navigation, deletion, app actions like model cycling, etc.) can now be customized. Supports multiple bindings per action. ([#405](https://github.com/badlogic/pi-mono/pull/405) by [@hjanuschka](https://github.com/hjanuschka))\n- `/quit` and `/exit` slash commands to gracefully exit the application. Unlike double Ctrl+C, these properly await hook and custom tool cleanup handlers before exiting. ([#426](https://github.com/badlogic/pi-mono/pull/426) by [@ben-vargas](https://github.com/ben-vargas))\n\n### Changed\n\n- Enriched the bundled `designer`, `reviewer`, and `task` agent prompts: `designer` gains a token-first four-phase design-system workflow (analyze \u2192 build-if-missing \u2192 compose-with-tokens \u2192 verify), `reviewer` gains an evidence standard (a finding is not real until you can name the triggering input; passing tests are not proof of correctness), and `task` gains an evidence-bound completion requirement.\n- Updated the session-continuation tip to mention Zellij and WezTerm panes.\n- Documented the `role` task parameter in the task-tool description (both the batch and single-spawn shapes) and made tailored specialists the default delegation guidance, so the model gives each spawn a specialist identity instead of cloning generic workers ([#2468](https://github.com/can1357/oh-my-pi/issues/2468))\n- Changed the `eval` `agent()` helper to accept `return_handle` (Python) / `returnHandle` (JS): instead of bare text it returns a DAG node dict `{ text, output, handle, id, agent }` whose `handle` is the spawned agent's recoverable `agent://` URI, so a downstream `pipeline`/`parallel` stage can wire a large transcript by reference instead of re-inlining it. The default path is unchanged (bare text, or the parsed object under `schema`).\n- Changed `isAutoresearchShCommand()` to use proper command-line argument parsing instead of regex, improving accuracy for complex shell invocations\n- Changed autoresearch initialization prompt to display collected tradeoff metrics in the setup summary\n- Changed `command-initialize.md` template to include guidance on preflight requirements, comparability invariants, and marking measurement-critical files as off-limits\n- Changed `command-initialize.md` to instruct users to write or update `autoresearch.program.md` with durable heuristics and repo-specific strategy\n- Changed autoresearch resume guidance to emphasize continuing on the current protected branch rather than switching branches\n- Changed autoresearch prompt to clarify that `autoresearch.md` holds durable conclusions while `autoresearch.ideas.md` is the scratch backlog\n- Changed autoresearch prompt guidance to require stable measurement harness and fixed benchmark inputs unless intentionally starting a new segment\n- Changed autoresearch prompt to recommend keeping equal or near-equal results when they materially simplify implementation\n- Changed `init_experiment` to reset pending run state (checks, duration, ASI, artifact directory) when initializing a new segment\n- Changed `log_experiment` to set `autoResumeArmed` flag after successfully logging a run to enable auto-resume on next agent turn\n- Changed `run_experiment` to set `autoResumeArmed` flag and update dashboard after completing a run\n- Changed auto-resume logic to only prompt when a new pending run exists or when `autoResumeArmed` is explicitly set, preventing duplicate prompts\n- Changed path normalization in contract validation to use `path.posix.normalize()` for consistent path handling\n- Extended extension `registerProvider()` typing with OAuth provider support and source-aware registration metadata.\n- **Slash commands and hook commands now work during streaming**: Previously, using a slash command or hook command while the agent was streaming would crash with \"Agent is already processing\". Now:\n  - Hook commands execute immediately (they manage their own LLM interaction via `pi.sendMessage()`)\n  - File-based slash commands are expanded and queued via steer/followUp\n  - `steer()` and `followUp()` now expand file-based slash commands and error on hook commands (hook commands cannot be queued)\n  - `prompt()` accepts new `streamingBehavior` option (`\"steer\"` or `\"followUp\"`) to specify queueing behavior during streaming\n  - RPC `prompt` command now accepts optional `streamingBehavior` field\n  ([#420](https://github.com/badlogic/pi-mono/issues/420))\n- Editor component now uses word wrapping instead of character-level wrapping for better readability ([#382](https://github.com/badlogic/pi-mono/pull/382) by [@nickseelert](https://github.com/nickseelert))\n- Extensions can have their own `package.json` with dependencies (resolved via jiti)\n- Documentation: `docs/hooks.md` and `docs/custom-tools.md` merged into `docs/extensions.md`\n- Examples: `examples/hooks/` and `examples/custom-tools/` merged into `examples/extensions/`\n- README: Extensions section expanded with custom tools, commands, events, state persistence, shortcuts, flags, and UI examples\n- SDK: `customTools` option now accepts `ToolDefinition[]` directly (simplified from `Array<{ path?, tool }>`)\n- SDK: `extensions` option accepts `ExtensionFactory[]` for inline extensions\n- SDK: `additionalExtensionPaths` replaces both `additionalHookPaths` and `additionalCustomToolPaths`\n- Removed image placeholders after copy & paste, replaced with inserting image file paths directly. ([#442](https://github.com/badlogic/pi-mono/pull/442) by [@mitsuhiko](https://github.com/mitsuhiko))\n\n### Fixed\n\n- Fixed the advisor auto-resuming a run after the user deliberately interrupts it (Esc, or a cancel from collab/ACP/RPC/SDK/extension). A user interrupt now suppresses advisor `concern`/`blocker` auto-resume until the user next resumes (a typed message, `.`/`c` continue, or a steer/follow-up); the concern is still recorded as a visible, persisted advisor card \u2014 including one already steered into the run or arriving mid-abort \u2014 so it re-enters context on resume instead of being discarded. Natural yields are unchanged: the advisor can still steer and resume a stalled run.\n- Fixed `/advisor on|off` not being session-local by overriding the setting instead of modifying global configuration, and fixed changes not updating the TUI status line immediately.\n- Fixed `plan.defaultOnStartup` setting schema configuration missing the required `ui.group` property.\n- Fixed `web_search` using stale or missing provider exclusions after `/move` or resuming a session from another project. Provider preferences (`providers.webSearchExclude`, `providers.webSearch`, `providers.image`) are now reapplied when project settings reload on cwd change ([#2611](https://github.com/can1357/oh-my-pi/pull/2611)).\n- Fixed isolated task subagents with persisted transcripts resolving file tools against the parent repository instead of the isolated worktree, which made `rcopy` patch capture report no changes after tool-based edits.\n- Fixed plugin config writes against older `omp-plugins.lock.json` files that did not have a top-level `settings` object, which crashed `omp plugin config set` before persisting the option ([#2236](https://github.com/can1357/oh-my-pi/issues/2236)).\n- Fixed auto-retry regenerating a large `write` call after the provider stream timed out mid-tool-call ([#2683](https://github.com/can1357/oh-my-pi/issues/2683)).\n- Fixed soft-expired `issue://` and `pr://` reads to refresh live before returning stale state, with an explicit stale warning when the live refresh fails ([#2684](https://github.com/can1357/oh-my-pi/issues/2684)).\n- Fixed Claude marketplace plugin skills appearing as bare slash commands while keeping real plugin `commands/` entries available ([#2645](https://github.com/can1357/oh-my-pi/issues/2645)).\n- Fixed boundary duplication warnings to always display when replacement lines match the next surviving line, even when auto-correction is disabled\n- Fixed secondary metrics validation to properly reject missing configured metrics and new metrics without force flag\n- Fixed ASI data cloning to prevent prototype pollution attacks by filtering reserved property names\n- Fixed CLI `--api-key` handling for deferred model resolution by applying runtime API key overrides after extension model selection.\n- Fixed extension provider registration cleanup to remove stale source-scoped custom API/OAuth providers across extension reloads.\n- `--list-models` no longer shows Google Vertex AI models without explicit authentication configured\n- JPEG/GIF/WebP images not displaying in terminals using Kitty graphics protocol (Kitty, Ghostty, WezTerm). The protocol requires PNG format, so non-PNG images are now converted before display.\n- Version check URL typo preventing update notifications from working ([#423](https://github.com/badlogic/pi-mono/pull/423) by [@skuridin](https://github.com/skuridin))\n- Large images exceeding Anthropic's 5MB limit now retry with progressive quality/size reduction ([#424](https://github.com/badlogic/pi-mono/pull/424) by [@mitsuhiko](https://github.com/mitsuhiko))\n- Slash command argument substitution now processes positional arguments (`$1`, `$2`, etc.) before all-arguments (`$@`, `$ARGUMENTS`) to prevent recursive substitution when argument values contain dollar-digit patterns like `$100`. ([#418](https://github.com/badlogic/pi-mono/pull/418) by [@skuridin](https://github.com/skuridin))\n- Edit tool diff not displaying in TUI due to race condition between async preview computation and tool execution\n- `/model` selector now opens instantly instead of waiting for OAuth token refresh. Token refresh is deferred until a model is actually used.\n- Shift+Space, Shift+Backspace, and Shift+Delete now work correctly in Kitty-protocol terminals (Kitty, WezTerm, etc.) instead of being silently ignored ([#411](https://github.com/badlogic/pi-mono/pull/411) by [@nathyong](https://github.com/nathyong))\n- `AgentSession.prompt()` now throws if called while the agent is already streaming, preventing race conditions. Use `steer()` or `followUp()` to queue messages during streaming.\n- Ctrl+C now works like Escape in selector components, so mashing Ctrl+C will eventually close the program ([#400](https://github.com/badlogic/pi-mono/pull/400) by [@mitsuhiko](https://github.com/mitsuhiko))\n- External editor (Ctrl-G) now shows full pasted content instead of `[paste #N ...]` placeholders ([#444](https://github.com/badlogic/pi-mono/pull/444) by [@aliou](https://github.com/aliou))\n- Subagent example README referenced incorrect filename `subagent.ts` instead of `index.ts` ([#427](https://github.com/badlogic/pi-mono/pull/427) by [@Whamp](https://github.com/Whamp))\n\n## [16.0.0] - 2026-06-15\n\n### Breaking Changes\n\n- Renamed the SDK tool format type and resolver from `ToolCallFormat`/`resolveToolCallSyntax` to `DialectFormat`/`resolveDialect`, and the agent option from `toolCallSyntax` to `dialect`.\n- Changed `/dump` transcript output to render messages with the selected model's native dialect turn and thinking envelopes instead of markdown role headings.\n\n### Added\n\n- Added `advisor.syncBacklog` setting (`off`, `1`, `3`, `5`) to pause turn completion until advisor review backlog drops below the threshold, with a maximum 30-second wait\n- Added advisor backlog synchronization at turn end when enabled so the main session stays aligned with the advisor's pending review turns\n- Added automatic discovery of WATCHDOG.md files from user and project locations so advisor guidance from local watchdog instructions is appended to its system prompt\n- Added `/advisor on`, `/advisor off`, `/advisor status`, and `/advisor dump [raw]` slash-command subcommands to manage the advisor at runtime\n- Added `advisor.enabled` and `advisor.subagents` settings to enable the advisor and extend it to spawned task/eval subagents\n- Added advisor status badge (`++` in success color) to the status line when an advisor is active\n- Added `/dump [raw]` flag to toggle between compact and legacy uncompact transcript output formats\n- Added `/advisor on`, `/advisor off`, and `/advisor status` slash-command subcommands to enable or disable the advisor at runtime and view advisor status metrics\n- Added a passive advisor: assign a second model to the `advisor` role and enable `advisor.enabled` to have it silently review each primary turn and inject severity-tagged advice notes via the `advise` tool. A `nit` rides the non-interrupting aside queue (batched into one card at the next step boundary), while a `concern` or `blocker` interrupts the running agent through the steering channel \u2014 aborting in-flight tools, or resuming the agent when it has already yielded \u2014 so high-severity advice is acted on immediately. Advice renders in the primary transcript as a distinct `Advisor` card, and the advisor gets hard-isolated read-only `read`/`search`/`find` access \u2014 bound to its own `ToolSession` so its reads never touch the primary's snapshot/seen-lines caches \u2014 to investigate the workspace before weighing in. The status line shows a `++` badge (in the success color, kept distinct from the model name) after the model name while an advisor is active, and `/advisor dump` copies the advisor's own transcript to the clipboard. Advisors are created only for the top-level session by default; enable `advisor.subagents` to extend them to spawned task/eval subagents.\n- Animated \"thinking\" pulse (`\u00b7\u2025\u2026\u2025`) shown in place of a hidden thinking block while the model is actively reasoning, so streaming progress is visible even with `hideThinkingBlock` enabled.\n\n### Changed\n\n- Changed advisor prompting guidance to emit at most one `advise` per update and to prefer silence when the agent is on track\n- Changed `/dump` default output to compact markdown format; use `/dump raw` for the legacy uncompact format\n- Changed `/dump` and `/advisor dump` to default to compact transcript output and accept an optional `raw` flag for the legacy uncompact format\n- Session dump output now renders message history using the model's native dialect turn envelope instead of markdown role headings\n- Changed RPC, RPC-UI, and ACP hosts to default the advisor settings off instead of inheriting a user's interactive-session advisor preference.\n\n### Fixed\n\n- Fixed advisor backlog tracking so failed advice prompts do not stall catch-up indefinitely by dropping pending backlog after repeated consecutive failures\n- Fixed backlog accounting to decrement only after successful advisor prompts so sync waits correctly reflect advisor progress\n- Fixed advisor context batching to still send pending review updates when context maintenance fails instead of dropping the batch\n- Fixed explicit advisor enablement to clear protocol-default overrides so enabling the advisor applies immediately\n- Fixed advisor message card notes getting truncated to two lines when the card is collapsed.\n- Fixed advisor context handling to maintain its token budget by promoting or compacting/restarting advisor context while preserving advisor reasoning-off settings.\n- Fixed `startup.quiet` leaving MCP and LSP startup status events visible during launch ([#2639](https://github.com/can1357/oh-my-pi/issues/2639)).\n- Registered the `Advisor` group in the `model` settings tab so advisor settings render correctly in the settings panel.\n- Fixed Windows bash path handling so MSYS/Git-Bash drive aliases like `/d/project` and WSL-style `/mnt/d/project` normalize to native drive paths consistently across the bash tool cwd validation and brush filesystem builtins ([#2634](https://github.com/can1357/oh-my-pi/issues/2634)).\n\n## [15.13.3] - 2026-06-15\n\n### Added\n\n- Unexpected stop detection: optional tiny/smol classifier that continues the turn when the assistant says it will act but emits no tool calls.\n- Settings `features.unexpectedStopDetection` and `providers.unexpectedStopModel`.\n\n### Changed\n\n- Changed the `job` poll to return early when a steering message is queued, draining the steer immediately instead of waiting out the poll window.\n- Capped unexpected-stop auto-continuation to three retry attempts before giving up on repeated stops\n- Updated the `edit` tool's hashline prompt, grammar, and docs to recommend the `.=` inclusive range separator (`SWAP 1.=3:`); the legacy `..` form still parses.\n- Normalized all internal worker argv selectors under the `__omp_worker_` prefix, skipping the async worker dispatch check during normal CLI startup.\n\n### Fixed\n\n- Filtered out whitespace-only and dot-only (`.` or `\u2026`) assistant blocks so they are treated as empty and no longer appear as visible content in message rendering, streaming reveal counts, or session export output\n- Filtered placeholder-only thinking content from ACP notifications and message visibility checks so dot-only `reasoning_content` no longer triggers turn completion or read/run updates\n- Fixed ModelRegistry tests making outbound network calls by automatically stubbing fetch during test execution.\n- Fixed `eval` JS cells (and browser-tab worker startup) always stalling for the full init timeout \u2014 typically the cell's whole 30s budget \u2014 before silently falling back to the slower inline worker. The self-dispatching CLI host imports the worker module dynamically from its argv dispatch, so the worker's own `parentPort.on(\"message\")` attached only after Bun flushed the messages the parent posted before spawn; the synchronously-posted `init` handshake was dropped and never answered with `ready`. The host now installs a buffering `parentPort` inbox synchronously in the entry's sync prefix (before importing the worker module) and the worker binds it on load, replaying the buffered handshake. `omp --smoke-test` now also spawns the JS eval worker through the host entry and asserts it handshakes on a real worker thread.\n- Fixed pre-prompt context-full compaction on OpenAI Responses sessions to use provider-anchored context usage when available, so large encrypted reasoning signatures no longer trigger automatic maintenance while the visible context percentage remains below threshold ([#2628](https://github.com/can1357/oh-my-pi/issues/2628)).\n\n## [15.13.2] - 2026-06-15\n\n### Added\n\n- Added tool examples data to exported RPC session tool metadata, so tool dumps and other clients can receive model-call examples\n- Added `supportsTools` to model definitions and overrides so custom model configs can declare whether a model supports native tool calls\n- Added `tools.format` for choosing native tool calling or a specific owned in-band format (`glm`, `hermes`, `kimi`, `xml`), with `auto` falling back to GLM only for models marked as not supporting native tools.\n- Added a conditional easter-egg tip recommending nerd fonts when using the unicode symbol preset.\n- Added the `tools.abortOnFabricatedResult` setting (default on): with in-band tool calls, stop the model the moment it starts hallucinating a tool result mid-turn, or disable it to let the model finish and discard the fabricated continuation instead.\n\n### Changed\n\n- Changed `/dump` tool catalog output to render tools through the shared inventory renderer with readable TypeScript-style signatures and native-syntax `` blocks\n- Changed todo tool result rendering so that collapsed phases truncate from the beginning, showing the latest/active tasks and displaying the \"more todos\" summary at the top.\n- Expanded `tools.format` to support additional in-band tool-call syntaxes, including `anthropic`, `deepseek`, `harmony`, `pi`, and `qwen3`\n- Changed the 13 tools that documented hand-written `` blocks (`eval`, `browser`, `todo`, `irc`, `ssh`, `ast_edit`, `ast_grep`, `debug`, `find`, `inspect_image`, `ask`, plus the `patch`/`apply_patch` edit modes) to define examples as typed `examples` data on the tool (`ToolExample>`); the AI layer now renders them in the model's native tool-call syntax and the markdown `` blocks were removed.\n- Changed the experimental owned tool-calling prompt from a GLM-only toggle to syntax-specific grammar prompts and result formats. `PI_OWNED_TOOLS=1` still forces GLM; `PI_OWNED_TOOLS=` forces that syntax.\n- Changed the large-paste menu to offer attachment XML blocks (``), local-file attachments, or inline paste as explicit actions.\n- Changed the system-prompt tool inventory: moved the `# Inventory` block to the bottom of the TOOLS section, and it now renders a compact tool-name list only when native tool calling is active and tool descriptions are not repeated; otherwise it emits full `# Tool: ` sections.\n\n### Fixed\n\n- Fixed Auto-Promote Context being pre-empted by compaction: the pre-prompt context check ran compaction directly, so snapcompact (or any strategy) fired before promotion ever got a chance. It now tries promotion to a larger-context model first \u2014 mirroring the post-turn threshold path \u2014 and only compacts when no larger-context target is available. Snapcompact (auto and manual) also falls back to a context-full LLM summary when its frame archive plus kept history would still overflow the model's usable window, instead of leaving the session over the limit.\n- Fixed `eval` JS cells intermittently failing after ~15s with exit code 1 under load (e.g. `bun test --parallel`, where each file runs in a worker subprocess and the eval worker is nested). The host swallowed asynchronous worker spawn/load/crash failures \u2014 `new Worker` reports module-load errors via an async `error` event, not a synchronous throw, so the spawn `try/catch` (and its inline-worker fallback) never fired, and no `error`/`messageerror` listener was wired \u2014 leaving a dead worker indistinguishable from a slow one and blocking the full worker-init timeout. The init handshake now rejects immediately on a worker `error`/`messageerror` event and falls back to the inline worker, and the `ready` listener is attached synchronously after `new Worker` (Bun does not buffer messages posted before a listener exists) so a fast worker's `ready` can no longer be dropped.\n\n## [15.13.1] - 2026-06-15\n\n### Added\n\n- Added isolated profile support via `--profile ` / `OMP_PROFILE` and shell alias bootstrap via `--alias `, including launch/ACP bootstrap handling, extension-flag-safe parsing, profile-scoped user config discovery, and symlinked extension-directory discovery.\n- Fixed paste and image placeholders crashing when the editor renders before theme initialization.\n\n### Changed\n\n- Replaced the `omp bench` default prompt with a concrete query-planning trace that requires deriving selectivities, cardinalities, and I/O/CPU costs from given schema and data. The old prompt was open-ended prose recall, which rewarded not-thinking: adaptive-thinking models (Opus 4.6+/Sonnet 4.6+) minimized reasoning on the trivial task and streamed faster, skewing throughput comparisons. The new task forces multi-step reasoning so adaptive thinking engages and the benchmark measures generation under real cognitive load. The prompt also demands explicit upfront deliberation and exhaustive enumeration/costing of every join order, so adaptive-thinking models cannot short-circuit to a quick answer and each model is measured over a sustained generation up to the token cap.\n\n### Fixed\n\n- Fixed hashline edits from `read`, `search`, and `ast-grep` so replacements are rejected when they target lines not shown in the tool output\n- Fixed `/tan` refusing to launch while the main response was still streaming. The command exists to fork tangential work *alongside* an active session, so it now dispatches mid-stream and queues its handoff breadcrumb for the next turn instead of steering the in-flight one.\n- Fixed `/tan` background agents never staying in the Agent Hub. The forked clone now uses an `.jsonl` session file (so the persisted-subagent scan keys it by the same id the live ref uses) and is parked rather than unregistered on completion, so it stays listed and its transcript stays readable.\n- Fixed the `/tan` dispatch breadcrumb rendering its full raw `` block in the transcript. It now shows a single compact line (`Tangent dispatched [task]  \u2014 `), styled as a sibling of the \"Background job completed\" line.\n- Fixed profile bootstrap parsing so built-in string flags like `--plan` no longer consume the profile-boundary marker and drop the trailing user message\n- Fixed a bug where goal mode was incorrectly deactivated/set to 'none' on every wall-clock-only update (when tokenDelta <= 0) during tool execution flushes, preventing OMP from writing a mode change to 'none' in the session history database while keeping in-memory/UI state fresh.\n- Fixed a bug where Gemini MALFORMED_FUNCTION_CALL tool-generation errors (which are transient) surfaced as terminal error blocks. Added \"malformed function call\" to the transient transport error classifier so the session automatically retries the turn.\n- Fixed Ctrl+C teardown waiting up to 30s when an extension's `session_shutdown` handler hung \u2014 observed on Windows with `omp-discord-presence` 0.1.2 stuck on a stale Discord IPC pipe. `ExtensionRunner.emit` previously shared the generic 30s `EXTENSION_HANDLER_TIMEOUT_MS` budget for every event, including the fire-and-forget teardown event extensions cannot observe. `session_shutdown` now uses a dedicated 2s `SESSION_SHUTDOWN_HANDLER_TIMEOUT_MS` cap routed through a per-event `handlerTimeoutForEvent()` lookup, so a hung third-party handler can no longer hold dispose hostage. As a defence-in-depth ladder, a Ctrl+C arriving while interactive shutdown is already running now hard-exits with code 130 (the session JSONL has already been sync-flushed by the first press), surfaced via a new read-only `InteractiveModeContext.isShuttingDown` ([#2600](https://github.com/can1357/oh-my-pi/issues/2600)).\n- Fixed the external editor flow (Ctrl+G, plan editor, `/todo edit`) warning `No editor configured` on Windows even when the user expected the system's native editor. `getEditorCommand()` now falls back to `notepad` on `win32` after consulting `$VISUAL`/`$EDITOR` (and trims those values so accidental whitespace is ignored), so Windows users get a working editor out of the box while POSIX still warns to nudge configuration ([#2604](https://github.com/can1357/oh-my-pi/issues/2604)).\n- Fixed Kokoro TTS setup loading the workspace/global `@huggingface/transformers` runtime before the side-installed Kokoro runtime, which could leave `onnxruntime-node@1.26.0` bound to an older `libonnxruntime.so.1` and fail with `VERS_1.26.0` missing ([#2591](https://github.com/can1357/oh-my-pi/issues/2591)).\n- Fixed `scripts/ci-release-notes.ts` stranding curated changelog entries from intervening *silent* tags (a `vX.Y.Z` tag pushed without a GitHub Release, e.g. the `v15.12.5`/`v15.12.6` casualties of the pre-#2564 release-cancellation bug). The generator now walks `(latest-published-release, target]` \u2014 resolved via `gh release list` from the `release_github` CI job \u2014 and merges every in-range `## [X.Y.Z]` section per package, grouped by `### ` with bullet-level dedupe so post-release changelog flattening cannot duplicate entries. Falls back to the legacy single-version extraction when no prior published release resolves, and `OMP_RELEASE_NOTES_FLOOR=v15.12.4` overrides the lookup for manual rebuilds ([#2596](https://github.com/can1357/oh-my-pi/issues/2596)).\n- Fixed `Test & smoke (TS)` CI timeouts caused by parallel test files racing on the process-global Settings singleton. `CustomEditor` now accepts a `magicKeywordsEnabledOverride` injection point so the shimmer-gate test can assert behaviour without calling `resetSettingsForTest()` / `Settings.init()`; the \"streaming tool call preview height\" describe drops its gratuitous Settings reset+init. Production wiring is unchanged ([#2582](https://github.com/can1357/oh-my-pi/issues/2582))\n- Fixed a collapsed, still-streaming tool preview (an `eval`/`bash`/`ssh` box with output streaming in) reading as \"weirdly truncated\" \u2014 top border and head rows missing \u2014 once its box outgrew the viewport, snapping back to whole only while expanded with `ctrl+o` and breaking again when collapsed. A streaming preview was classified commit-unstable whenever collapsed, so the transcript offered none of its rows to native scrollback; once the box outgrew the window its head fell into the gap between the commit boundary and the window top, committed nowhere and repainted nowhere. The `provisionalPendingPreview` flag now applies only to the pending call preview (before any result) \u2014 once a streaming result exists the result renderer is the live, top-anchored shape and the block is commit-stable in both collapsed and expanded states, so its durable head always reaches scrollback.\n- Fixed a crash in subagent task execution and extensions when a string (instead of a string array) was returned or set for the system prompt. Gracefully wrap string values in arrays.\n- Fixed the todo completion reminder escalating 1/3 \u2192 2/3 \u2192 3/3 within a single user pause: `#checkTodoCompletion` appended a `` and then scheduled `agent.continue()`, so a text-only acknowledgement (\"paused at your instruction\") triggered another `agent_end` that re-ran the same check and fired the next reminder \u2014 no user input required. `AgentSession` now tracks `#todoReminderAwaitingProgress`: a reminder sets it, any `toolResult` (real progress) or a new user prompt clears it, and `#checkTodoCompletion` stays silent while it is set. Escalation through `todo.reminders.max` still works when the agent makes tool-level progress between stops ([#2590](https://github.com/can1357/oh-my-pi/issues/2590)).\n- Fixed profile bootstrap so an extension-shadowed `--plan` flag no longer swallows a following global `--profile`.\n- Fixed MCP OAuth URL-keyed credentials to stay profile-scoped under shared auth-broker storage and to clear discovered definition-only server auth during `/mcp unauth`.\n- Fixed `/mcp unauth` deleting another profile's MCP OAuth credential row under broker-backed auth storage: when a shared `mcp.json` pins an explicit `auth.credentialId` scoped to a different profile (`mcp_oauth:profile::`), removal now skips ids scoped to a non-active profile, mirroring the read path that already refuses to *use* a foreign profile's id. Legacy url-keyed (`mcp_oauth:`) and active-profile ids are still cleared.\n- Fixed auto-learn managed skills to use the active profile's agent directory, so authored profile skills keep priority over managed fallbacks.\n\n## [15.13.0] - 2026-06-14\n\n### Breaking Changes\n\n- Replaced the `omp setup stt` command with `omp setup speech`. The old `stt` setup component is gone (no alias); `omp setup speech` now provisions the full speech stack \u2014 audio recorder, speech-to-text model, and text-to-speech model.\n- Renamed the `tts.enabled` setting to `speechgen.enabled` (same boolean, default off; no alias). It still gates the on-demand `tts` speech-generation tool, now labelled \"Speech Generation\" in the settings panel.\n\n### Added\n\n- Added `paste.largeMenuThreshold` setting (0/100/250/500/1000, default 100) to control when large pasted content triggers the large-paste menu or stays as a normal `[Paste]` marker\n- Added a large-paste editor menu for pasted text over the threshold that lets users choose to wrap the paste in a fenced code block, wrap it in `` XML tags, or save it as `local://attachment-N` for on-demand reading\n- Added `snapcompact-savings.jsonl` journaling for snapcompact tool-result compaction, recording session, provider, model, tool call, and estimated token savings whenever tool output is rendered as image frames\n- Added `subagent:` loop-phase breadcrumbs around in-process subagent event dispatch and finalization so the TUI event-loop watchdog can attribute a main-thread stall to subagent execution ([#2485](https://github.com/can1357/oh-my-pi/issues/2485))\n- `highlightMagicKeywords(text, resetTo?, phase?)` now accepts an optional `phase` \u2208 [0, 1) that rotates the gradient cyclically; sent bubbles omit it (static palette unchanged). `hasMagicKeyword(text)` exported from `modes/magic-keywords` is the cheap shimmer-gate the editor uses on every render.\n- Added a `fastModeScope` setting (`both` | `openai` | `claude`, default `both`) controlling which providers `/fast on` (and the fast-mode toggle) target. `both` keeps the prior unscoped priority behavior; `openai`/`claude` scope fast mode to one family. `/fast status` now reports the active scope.\n- Added the `mnemopi.embeddingVariant` setting (`en` | `multilingual`) selecting a stronger SOTA local embedding model \u2014 `en` \u2192 `BAAI/bge-base-en-v1.5` (768d), `multilingual` \u2192 `intfloat/multilingual-e5-large` (1024d). Resolution precedence is `mnemopi.embeddingModel` setting > `MNEMOPI_EMBEDDING_MODEL` env > variant default, so the documented env override is still honored. Changing the active model wipes and rebuilds stored embeddings on the next writable start ([#2476](https://github.com/can1357/oh-my-pi/issues/2476))\n- Added a `/guided-goal` slash command that interviews you to refine an objective before enabling goal mode, then seeds goal mode with the agreed objective. The bounded interview (up to six turns) runs on the plan or slow model and falls back with a hint when the goal is still too vague ([#2502](https://github.com/can1357/oh-my-pi/issues/2502)).\n- Added a large-paste menu: when a paste reaches `paste.largeMenuThreshold` lines (default 100; `0` disables), the editor offers to wrap it in a code block, wrap it in `` XML tags (both collapse to a `[Paste]` marker that expands on submit), or save it to the session's `local://` store and insert a clean `local://attachment-N` reference the agent can `read` on demand. Esc keeps the previous inline-paste behavior, so the content is never lost.\n- Added `8on22-bw` (leading) and `11on16-bw` (tracking) options to the `snapcompact.shape` setting, the spacing-tuned cells that are now the per-provider defaults (Anthropic \u2192 tracking, OpenAI/Google \u2192 leading)\n- Added a local on-device neural TTS backend for the `tts` tool and a `providers.tts` switch (`auto` | `local` | `xai`, default `auto`). `local` synthesizes speech with Kokoro-82M \u2014 SoTA on-device TTS quality \u2014 via `kokoro-js` on the shared ONNX runtime (`@huggingface/transformers` + `onnxruntime-node`) in a subprocess worker (mirroring the tiny-model worker), keeping the model warm across calls and emitting 24 kHz WAV/PCM16 with no network call; `xai` keeps the existing Grok Voice cloud path; `auto` prefers local but routes `.mp3` requests to xAI when credentials exist (no local MP3 encoder is bundled, so a local `.mp3` request is written as a sibling `.wav`). `kokoro-js` is never a hard dependency: it is lazily `bun install`ed into a version-keyed runtime dir on first use (with `onnxruntime-node` force-pinned to a Bun-safe version), so its transformers@3.x graph never pollutes the main tree. New `tts.localModel` (default `kokoro`) and `tts.localVoice` (default `af_heart`; American/British, female/male voices) settings select the on-device voice.\n- Added a unified, interactive `omp setup speech` command that walks one reusable flow across all three speech dependencies: it lets you pick and persist the speech-to-text (`stt.modelName`) and text-to-speech (`tts.localModel`) models from a TUI list, then downloads both models plus an audio recorder with live progress. The recorder is now auto-provisioned cross-platform (a static `ffmpeg` binary is fetched via the shared tools-manager when no SoX/FFmpeg/arecord is present, with the PowerShell fallback on Windows) instead of dead-ending with \"install sox manually\". `--check` and `--json` report recorder + STT-model + TTS-model readiness without installing.\n- Added `omp say `, which synthesizes text with the local on-device TTS engine and plays it through the speakers (cross-platform: `afplay` on macOS, `paplay`/`aplay`/bundled `ffmpeg` on Linux, PowerShell `Media.SoundPlayer` on Windows). `--out ` writes a WAV instead of playing, `--voice`/`--model` override the `tts.localVoice`/`tts.localModel` settings, and an uninstalled model prints an actionable `omp setup speech` hint.\n- Added streaming speech vocalization: with `speech.enabled` on, the assistant speaks its reply through the speakers as it streams. Assistant text deltas are fed *directly into the engine's incremental text input* (Kokoro's `TextSplitterStream` via the worker) as they arrive, rather than pre-chunked in JS and synthesized one batch call per sentence \u2014 the engine owns sentence segmentation and emits one audio chunk per sentence. A single persistent player (`StreamingAudioPlayer`) drains those chunks **gaplessly** (raw 32-bit-float PCM piped to one `ffmpeg`\u2192PulseAudio/ALSA process on Linux; interruptible per-file `afplay`/PowerShell `SoundPlayer` on macOS/Windows), replacing the spawn-a-player-per-sentence path that added latency and audible gaps. Overspeech is handled end to end: a new turn, a sent message, or an Esc/Ctrl+C interrupt stops playback **instantly** (the player process is killed rather than letting the current sentence finish); holding the push-to-talk key **ducks** the volume while you speak and restores it when you stop; and sequential utterances queue and drain in order instead of overlapping. `speech.mode` (`all` | `assistant` | `yield`, default `assistant`) picks what is spoken \u2014 `all` adds thinking, `yield` speaks only the final message at turn end \u2014 and `speech.voice` selects the Kokoro voice. `ask`-tool questions are spoken in every mode. Synthesis reuses the local Kokoro engine (`tts.localModel`) through a new streaming synthesis path (`TtsClient.synthesizeStream`) that pushes text in and streams audio chunks back over the worker protocol.\n- Added live (streaming) speech-to-text: with `stt.enabled` on, transcription now appears in the composer *as you speak* instead of all at once after you stop. The recorder streams raw 16 kHz mono PCM from sox/ffmpeg/arecord stdout to the warm STT worker, where an energy-based endpointer (no extra model) splits speech into segments at natural pauses; each finalized segment is committed into the editor while the in-progress segment shows a live volatile preview that refreshes in place and is kept out of the undo history. Works with both the default Parakeet (sherpa-onnx) and the Whisper (transformers.js) tiers. Recorders that cannot stream to a pipe (the Windows PowerShell mci fallback) transparently fall back to single-shot transcription.\n- Added `skills.enableAgentsUser` and `skills.enableAgentsProject` settings (default on) so the canonical OMP-native `~/.agent[s]/skills` and project-walkup `.agent[s]/skills` are configurable independently from the third-party Claude/Codex/Pi toggles.\n- Added a read-only `ctx.models` facade for extensions: `list()` (authenticated models), `current()` (live session model), `resolve(spec)` (a model string or role alias \u2192 `Model`, using the same settings-backed aliases and match preferences as core selection), and `family(model)` (opaque canonical-identity lineage token for cross-family comparisons). Lets extension tools select models the way core does without reaching into the mutable registry ([#2406](https://github.com/can1357/oh-my-pi/issues/2406))\n- Added RPC prompt lifecycle hints so hosts can distinguish scheduled agent turns from local-only slash commands via `data.agentInvoked` and `prompt_result`.\n- Added extension lifecycle events for tool approval prompts: `tool_approval_requested` before the approval wait and `tool_approval_resolved` after approve, deny, or approval prompt failure.\n\n### Changed\n\n- Changed `handoff` custom messages (`customType: \"handoff\"`) to render in the transcript as a compaction-style expandable divider in both the main session and Agent Hub views, and expanded handoff details now show the handoff context body without `` tags\n- Changed the double-tap-\u2190 gesture (empty editor, main session) to stay inert when there are no subagents to show, instead of opening an empty Agent Hub roster. The explicit Agent Hub / observe keybindings still open the empty roster. The gating reuses the hub's own row count (after its persisted-subagent scan), so it matches exactly what the hub would display.\n- Changed the `job` tool's `async.pollWaitDuration` setting (relabeled **Max Poll Time**) to add a `smart` value, now the default. A fixed value (`5s`\u2013`5m`) still blocks for exactly that long; `smart` adapts: a blocking poll starts at a 5s floor and climbs a ladder (5s \u2192 10s \u2192 30s \u2192 1m \u2192 5m) with each back-to-back poll, so a tight poll loop backs off and stops spending turns on \"still running\" frames, then resets to the 5s floor after ~1 minute without polling (i.e. when the agent steps away to do real work). Escalation is tracked per agent (owner-scoped on `AsyncJobManager`).\n- Added the `compat.supportsForcedToolChoice` custom-model flag for OpenAI-compatible models whose endpoints accept tools but reject forced `tool_choice` values ([#2546](https://github.com/can1357/oh-my-pi/issues/2546)).\n- Changed speech-to-text to run fully local on-device with a tiered, multi-engine model picker. Transcription runs in a subprocess worker (mirroring the tiny-model worker; the native ONNX addons are hard-killed on shutdown to dodge the Bun NAPI-finalizer segfault) instead of shelling out to Python `openai-whisper`, keeps the model warm across recordings, and decodes WAV to 16 kHz mono float32 in-process. `stt.modelName` now selects on-device tiers across two engines: `parakeet` (default) \u2014 NVIDIA Parakeet TDT 0.6B v3 (25 languages) via the native `sherpa-onnx-node`, the Open ASR Leaderboard accuracy + throughput leader (lower WER than, and ~20\u00d7 faster decoding than, Whisper large-v3) \u2014 plus `fast`/`balanced`/`turbo` mapping to Whisper base/small/large-v3-turbo (multilingual, up to 99 languages) via `@huggingface/transformers`. `omp setup speech` no longer mentions pip/python-whisper and reports recorder + model-cache readiness.\n- Changed the speech-to-text trigger from the `Alt+H` keybinding to a hold-`Space` push-to-talk gesture. Holding the space bar emits an OS auto-repeat burst; once more than 5 spaces land in the editor it recognizes the hold, deletes (tracks back) those inserted spaces, and starts recording, then stops and transcribes when the repeats stop (the space bar is released). `app.stt.toggle` is now unbound by default but can be rebound to a chord for press-to-toggle; the gesture is gated on `stt.enabled`, and `Shift+Space` still inserts a literal space.\n- `task.eager` (\"Prefer Task Delegation\") and `todo.eager` (\"Create Todos Automatically\") are now three-level enums (`default` / `preferred` / `always`) instead of booleans. For `todo.eager`, `preferred` renders a soft first-message reminder while `always` forces the `todo` tool (the previous \"on\" behavior); for `task.eager`, `preferred` adds a soft (SHOULD) delegation nudge to the system prompt while `always` uses hard (MUST/ONLY) wording plus a first-turn delegation reminder. Existing boolean configs migrate automatically (`true \u2192 always`, `false \u2192 default`). On models that cannot be forced to call `todo`, `todo.eager: \"always\"` now emits the first-turn reminder without forcing the call (previously such models received nothing) ([#2539](https://github.com/can1357/oh-my-pi/issues/2539), [#2540](https://github.com/can1357/oh-my-pi/pull/2540) by [@metaphorics](https://github.com/metaphorics)).\n- Fixed `/model`-switching to a non-default OpenRouter model returning `404 No route: POST /chat/completions` when the provider is routed through the auth-gateway broker. The background catalog refresh re-ran `mergeDiscoveredModel` on every openrouter entry; for models whose bundled record already existed, the merge re-applied `baseUrl`, `headers`, and `compat` but dropped `transport: pi-native` because the raw `/v1/models` payload carries no transport hint. The next `/model` switch then picked the now-transport-less entry and routed through the default openai-completions client to `${baseUrl}/chat/completions` \u2014 a path the auth-gateway never serves. `mergeDiscoveredModel` now propagates the override/existing transport on the rediscovery branch ([#2555](https://github.com/can1357/oh-my-pi/issues/2555)).\n\n### Fixed\n\n- Fixed npm plugin installs to reject packages whose declared extension entry points cannot load because imports or nested dependencies are unresolved ([#2312](https://github.com/can1357/oh-my-pi/issues/2312)).\n- Fixed the deferred MCP discovery banner (`Connecting to MCP servers: \u2026`) overdrawing the chat input bar. `onMCPConnecting` wrote the banner straight to `process.stderr` while the TUI owned the terminal; it now emits on an `mcp:connecting` event channel that `InteractiveMode` renders through `showStatus` (the status container), mirroring the existing LSP-startup pattern so the banner can never paint over the input box border ([#2483](https://github.com/can1357/oh-my-pi/issues/2483))\n- Fixed Win+Shift+S screenshot paste on Windows dead-ending on `Image not found`: Windows Terminal forwards a bracketed paste of the Snipping Tool's transient `\u2026\\MicrosoftWindows.Client.Core_*\\TempState\\\u2026` file path, which is already gone (or never materialized) by the time omp reads it, so `handleImagePathPaste` failed with ENOENT even though the screenshot bitmap was still on the clipboard. The handler now falls back to the clipboard image across every local read failure (missing file, undecodable file, or generic error) before degrading, and the fallback is skipped over SSH where the clipboard lives on the remote host rather than the terminal holding the screenshot.\n- Fixed npm prebuilt extension compatibility shims deriving their own package root through bare `@oh-my-pi/pi-coding-agent` resolution, which could select an older Bun cache copy in global installs and reintroduce mixed-runtime plugin loading stack overflows.\n- Honor the `context_length` reported by OpenAI-compatible `/v1/models` discovery (`discovery: { type: \"proxy\" }` and `discovery: { type: \"openai-models-list\" }`) when present, so aggregator-reported windows override the stale bundled reference; the value is validated through the positive-number guard so a `0`/negative/stringly-typed upstream value cleanly falls back to the bundled reference (then `128000`) instead of pinning a broken window ([#2466](https://github.com/can1357/oh-my-pi/pull/2466) by [@androw](https://github.com/androw)).\n- Fixed `web_search` SearXNG fallback when HTTP 200 responses contain no usable results plus `unresponsive_engines`; SearXNG now raises a transient provider error, and the fallback loop rejects any provider response with no renderable content before formatting an invisible success ([#2571](https://github.com/can1357/oh-my-pi/issues/2571)).\n- Fixed `read` on a GitHub commit URL (`github.com///commit/`) returning the raw commit HTML page instead of structured content. `parseGitHubUrl` had no `commit` case, so commit URLs fell through to generic HTML rendering; they now resolve via the commits API and render as markdown (subject, author, stats, parents, full commit message, and a per-file unified diff), matching the existing blob/tree/issue/PR handling.\n- Fixed release runs being silently cancelled by a later `main` push, which left tagged versions (`v15.12.6` in the wild) without a GitHub Release or npm publish. The CI workflow's `concurrency` group was `${{ github.workflow }}-${{ github.ref }}`, and since the release-script commit + `v*` tag are pushed atomically to `refs/heads/main`, the release run shared the `CI-refs/heads/main` group with every subsequent push; `cancel-in-progress: true` then killed it before `release_binary` / `release_github` / `release_npm` could run, and no future run carried the release tag at HEAD. The group now resolves to a per-sha `release-` slot with `cancel-in-progress: false` whenever the push subject matches `chore: bump version to ` (the release-script convention) or `github.ref` is a `v*` tag (`workflow_dispatch` recovery), so release runs are isolated from PR/main churn ([#2564](https://github.com/can1357/oh-my-pi/issues/2564)).\n- Allowed `compat.streamIdleTimeoutMs: 0` in `models.yml`. The schema was `.positive()`, so the documented \"set to 0 to disable\" escape hatch was only reachable via the global env var ([#2422](https://github.com/can1357/oh-my-pi/issues/2422))\n- Fixed LaTeX math delimiters (`$`/`$$`) and commands (such as `\\text`, `\\times`) rendering raw in the terminal by instructing the model to write equations as plain text / Unicode in its replies. The instruction is scoped to conversational output, so it does not constrain LaTeX or Markdown/KaTeX content the agent is asked to write to files ([#2550](https://github.com/can1357/oh-my-pi/pull/2550) by [@usr-bin-roygbiv](https://github.com/usr-bin-roygbiv)).\n- Fixed the MCP stdio transport `close()` potentially hanging while awaiting a read loop that can block indefinitely; teardown now detaches the read loop instead of awaiting it ([#2550](https://github.com/can1357/oh-my-pi/pull/2550) by [@usr-bin-roygbiv](https://github.com/usr-bin-roygbiv)).\n- Fixed per-project memory isolation pulling other projects' memories into recall. Legacy (pre-#2412) mnemopi banks were rescued into recall when *any* working-memory row tagged the active cwd, but recall reads a bank wholesale and cannot filter rows by cwd, so a mixed-cwd bank leaked unrelated projects' memories. A legacy bank is now rescued only when *every* row tags the active cwd ([#2412](https://github.com/can1357/oh-my-pi/issues/2412)).\n- Fixed a prompt template whose name collides with a builtin slash-command *alias* (e.g. a `models` template beside the builtin `/model`, which owns the `models` alias) appearing as a duplicate entry in the slash-command autocomplete picker. The picker's reserved-name filter now also excludes command aliases, matching runtime resolution (slash commands expand before prompt templates, so the template was already unreachable).\n- Fixed the tool-result renderer re-shaping on every `invalidate()` (spinner tick, stream chunk, resize, keystroke), which made large grep/find/read results block the main thread for seconds and made typing sluggish. `ToolExecutionComponent.#updateDisplay()` now memoizes on a dirty key (result version, expand state, partial flag, spinner frame, image visibility, theme epoch, background-task freeze state, the resolved terminal image protocol, and a display-input version that covers streamed call args, the async edit-diff preview, and Kitty image conversions) and a `#displayBuilt` guard that also fast-paths the `#contentText` fallback, so the O(result-size) shaping runs once per change instead of every frame without freezing streamed args, previews, converted images, a backgrounded task settling to its static form, or images that arrive before the async image-protocol probe resolves. Image-bearing results also re-shape on terminal resize (keyed on the resolved image dimensions only when images are present) so inline images rescale, while image-free results never re-shape on resize ([#2484](https://github.com/can1357/oh-my-pi/issues/2484))\n- Fixed `setTheme()` not bumping the theme epoch on its invalid-theme fallback path: a failed theme load swaps the active theme to the dark fallback, so memoized renderers (the tool-result renderer above) must re-shape \u2014 previously they kept the failed theme's stale colors until some other state changed ([#2484](https://github.com/can1357/oh-my-pi/issues/2484))\n- Fixed tool-call spinners animating out of phase across parallel tool calls \u2014 each live tool block advanced its glyph from its own per-instance start time, so concurrent spinners showed different frames. Glyphs now derive from a single shared monotonic clock (`sharedSpinnerFrame`), keeping every live block in lockstep.\n- Fixed the per-turn token-usage row (`display.showTokenUsage`) churning and duplicating in scrollback, most visibly with parallel tool calls. The row was rendered inside the assistant block above the turn's tool blocks, so finalizing the block was deferred and late appends recommitted the already-committed tool rows. The assistant block now always finalizes as soon as a tool-call appears, and the usage row is emitted as a standalone finalized block below the turn's tool blocks across all three render paths (live, transcript rebuild, agent-hub).\n- Fixed the editor input box claiming a disproportionate share of small terminals (<=18 rows): the editor max-height floor (6 rows) ignored the available space. The height now yields to terminal size (`EDITOR_MIN_CHROME_ROWS`), reserving rows for the transcript and status line whenever the terminal can host both; on terminals too small for both, the editor collapses to its real bordered minimum instead of overshooting a fictitious cap.\n- Fixed `ultrathink` / `orchestrate` / `workflowz` keywords not glowing while typing \u2014 the editor appended a CURSOR_MARKER (ESC-prefixed) after each render, so the magic-keyword regex's right-boundary `(?!\\S)` tripped on ESC and dropped the gradient until a trailing character was typed. The marker-aware editor decorate (`packages/tui`) plus a phase-aware `highlightMagicKeywords` overload restore the live glow and add a Claude-Code-style shimmer while the prompt is focused, gated on `magicKeywords.enabled` ([#2475](https://github.com/can1357/oh-my-pi/issues/2475)).\n- Fixed the compaction flow (`/compact` and plan-mode \"Approve and compact context\") leaving UI artifacts. `executeCompaction` added a `Spacer(1)` to the transcript that the sibling handoff path never adds and that leaked as an orphan blank line whenever compaction was cancelled or failed; that spacer is removed. On success the compaction loader is now stopped and the status container cleared *before* the transcript is rebuilt, so the live loader row no longer flickers over the reconciled transcript near the status seam (the idempotent `finally` still covers the cancel/fail paths) ([#2486](https://github.com/can1357/oh-my-pi/issues/2486))\n- Fixed plan approval's \"Approve and compact context\" running the compaction summarizer on the pre-plan model instead of the plan model, cold-missing the plan model's prompt cache. Compaction now runs on the plan model (warm cache); the switch to the execution/pre-plan model happens only after a successful compaction and before any input queued during compaction is dispatched, so the queued turn runs on the post-compaction model. A cancelled compaction now also restores the pre-plan model (it previously stranded the session on the plan model), while a failed compaction stays on the plan model with its context intact.\n- Fixed `Alt+Up` (dequeue) reporting \"No queued messages to restore\" for messages \u2014 including skills \u2014 typed while the session was compacting. `restoreQueuedMessagesToEditor` now drains `compactionQueuedMessages` alongside the agent queue, so the `Alt+Up to edit` hint restores every pending message it advertises.\n- Fixed `restoreQueuedMessagesToEditor` (Alt+Up dequeue and Esc-abort) producing colliding `[Image #N]` markers when the editor draft already held pending image(s): queued text was prepended but queued images were appended, so positional marker \u2192 image lookup at submit time resolved to the wrong image. Each queued message's image markers are now renumbered by the running pending-image count before merge so the combined text stays aligned with the merged `pendingImages` order ([#2531](https://github.com/can1357/oh-my-pi/issues/2531)).\n- Fixed `AgentBusyError` (\"Agent is already processing. Use steer() or followUp()...\") surfacing on mode transitions \u2014 as `Failed to finalize approved plan: ...` when a plan was approved while the agent was still streaming the post-`resolve` continuation (or a turn started by the approve-time compaction/clear), and as an error toast when a loop auto-submit or goal continuation fired during a streaming/compaction race. Plan approval now aborts any in-flight turn before dispatching the executor's first prompt, and `submitInteractiveInput` routes streaming-time loop, goal-continuation, and manual submissions through the follow-up queue (`streamingBehavior: \"followUp\"`) instead of throwing (synthetic continue-shortcuts stay developer-attributed and keep their prior behavior). Extends the manual-`/goal` fix in [#2454](https://github.com/can1357/oh-my-pi/issues/2454) to the continuation and plan-approval paths.\n- Fixed `/plan` cycling between `plan` and `plan_paused` with no path back to mode `none`. `handlePlanModeCommand` had branches for entering and pausing but fell through to `#enterPlanMode()` when invoked from the paused state, so once a session entered plan mode the only operator-visible toggle re-entered it. The handler now matches `planModePaused` and fully exits \u2014 clearing `planModeHasEntered` and appending a `mode_change` to `\"none\"` \u2014 so `/goal` (and any other mode gated on `planModeEnabled || planModePaused`) can run again after a third `/plan` ([#2510](https://github.com/can1357/oh-my-pi/issues/2510)).\n- Fixed HTML session export rendering empty text tokens (`text`, `userMessageText`, `customMessageText`, `toolTitle`) as the dark-theme grey `#e5e5e7` on every theme not literally named `light`, making transcripts illegible on custom light themes like `sandstone`, `limestone`, and `porcelain`. `getResolvedThemeColors` and the standalone `isLightTheme` helper now classify against the resolved `statusLineBg` luminance (the same surface `Theme.isLight` uses), so the HTML `defaultText` falls back to `#000000` on light themes and the standalone helper stays in lockstep with `Theme.isLight` ([#2516](https://github.com/can1357/oh-my-pi/issues/2516)).\n- Fixed the Agent Hub opening on its own from a stray mouse click. The double-tap-\u2190 gesture (empty editor) fired on any two `left` keys within 500ms, but terminals with \"click to move cursor\" / pointer features (iTerm2 option-click, WezTerm, kitty, tmux) synthesize a burst of arrow keys on click \u2014 delivered sub-millisecond apart in one stdin read \u2014 so a single click could pop the hub with no key ever pressed. The gesture now requires the second tap to land a human-plausible interval after the first (\u226540ms, <500ms) and ignores any third-or-later rapid tap, so synthesized bursts are rejected while a deliberate double-tap still works. The same hardening applies to the focused-subagent \u2190\u2190 \"return to main\" gesture.\n- Fixed the `ctrl+p` model-role cycle indicator (the `default / gpt / fable / \u2026` chip track) stacking duplicate copies in the scrollback when other chat activity landed between two cycles. The track was emitted through `showStatus`, whose back-to-back coalescing only merges when the previous status is still the last transcript child; any interleaved append broke that identity check and appended a second track. It now renders into a dedicated anchored container above the editor (cleared and rebuilt in place each cycle, like the Todos HUD) and auto-clears after a short linger, so rapid presses or concurrent activity can never duplicate it.\n- Fixed the `Working\u2026` loader vanishing for the rest of a turn after an auto-compaction (context-overflow recovery) or auto-retry. Those overlays took over the shared status container with a bare `statusContainer.clear()`, which detached the working loader but left `loadingAnimation` set; the resumed turn's `agent_start` \u2192 `ensureLoadingAnimation()` is guarded by `if (!this.loadingAnimation)`, so it skipped re-attaching the loader and the spinner stayed gone while the agent kept streaming. The overlay handlers now fully tear the working loader down (stop + dereference) via `#stopWorkingLoader()`, so the next `agent_start` recreates and re-attaches it.\n- Fixed JS eval helper optional arguments rejecting Python-style positional calls. `read(path, offset, limit)` now works alongside `read(path, { offset, limit })`, `null`/`undefined` skip optional positional slots, and non-local URI reads such as `artifact://...` delegate through the read tool so line slicing works on spilled artifacts.\n- Fixed legacy extension compatibility remapping for `@*-pi-ai/utils/oauth` imports so background workers load the relocated `@oh-my-pi/pi-ai/oauth` exports instead of resolving missing `src/utils/oauth/*` files ([#2566](https://github.com/can1357/oh-my-pi/issues/2566)).\n- Fixed eager todo initialization prompting GPT-5.5 to emit unsupported task metadata fields, which could leave fresh sessions stuck on the forced first `todo` call ([#2561](https://github.com/can1357/oh-my-pi/issues/2561)).\n- Fixed Windows plan-mode task fan-out crashing the TUI when nested async task progress formed a cycle; task rendering now cuts recursive snapshots and long Windows `local://` roots are shortened under temp storage ([#2551](https://github.com/can1357/oh-my-pi/issues/2551)).\n- Fixed a band of streaming assistant output being lost from native scrollback \u2014 committed nowhere, repainted nowhere \u2014 once a reply grew taller than the viewport. Markdown whose layout keeps changing above the streaming tail (most visibly a table whose columns re-align as rows arrive) never earns a byte-stable commit-safe end, so as its head scrolled above the window the rows fell into the gap between the commit boundary and the window top and vanished. `TranscriptContainer` now reports a `getNativeScrollbackSnapshotSafeEnd()` for commit-stable live blocks (their whole body is durable content), and the renderer commits those scrolled-off rows audit-exempt \u2014 a later layout change of an already-committed row freezes a slightly-stale row in scrollback (duplication never loss) instead of dropping it. Provisional blocks (collapsing tool/edit previews) are unaffected.\n- Fixed unknown `--`-prefixed flags being silently consumed as prompt text, which let a stale or typoed flag start a real agent session (connecting to MCP servers, waiting on the model) instead of failing fast. `parseArgs` now tracks unrecognized flag-shaped tokens and `runRootCommand` calls `reportUnrecognizedFlags` immediately after the post-extension reparse, exiting `2` with `Error: unknown flag: --\u2026` before any session, MCP, or initial-message work runs. Extension-registered flags still pass cleanly since the validation runs after the extension-aware reparse, and `--` is honored as a POSIX positional separator so flag-shaped prompts (`omp -p -- --explain-this`) survive the new guard ([#2459](https://github.com/can1357/oh-my-pi/issues/2459)).\n- Fixed `/goal ` and `/goal set ` during streaming so goal context is steered immediately but objective submission waits for the active turn to finish instead of spamming `AgentBusyError`. The interactive goal-continuation timer is now streaming-aware too: if a turn starts inside the 800 ms idle window the timer was scheduled in, it drops the tick instead of submitting a stale `goal-continuation` that would resurface the same `AgentBusyError`; the next `agent_end` reschedules ([#2454](https://github.com/can1357/oh-my-pi/issues/2454)).\n- Fixed `~/.agent[s]/skills` not appearing as `/skill:` commands when every named source toggle (`skills.enableCodexUser`, `skills.enableClaudeUser`, `skills.enableClaudeProject`, `skills.enablePiUser`, `skills.enablePiProject`) was off: `loadSkills` gated the `agents` provider on `anyBuiltInSkillSourceEnabled`, so a user who turned off the Claude/Codex/Pi sources to clean noise also lost their own canonical OMP-native skills. The `agents` provider now reads the dedicated `enableAgentsUser`/`enableAgentsProject` toggles, and the unknown-third-party fall-through gate is restricted to the named third-party toggles so keeping the default agents toggles on no longer silently re-enables `opencode`/`github`/`claude-plugins`/`gemini` skill sources ([#2401](https://github.com/can1357/oh-my-pi/issues/2401)).\n- Fixed Claude Code marketplace plugin skills installed under `skills//SKILL.md` to also appear as bare slash commands such as `/understand`, matching Claude-native plugin docs. The slash command name is taken from the skill directory basename so display-style frontmatter names like `name: Understand Anything` still resolve to `/understand` ([#2415](https://github.com/can1357/oh-my-pi/issues/2415)).\n- Fixed ACP `/move` builtin test expectations to compare the resolved destination path so the test is portable on Windows and Unix ([#2381](https://github.com/can1357/oh-my-pi/pull/2381) by [@oldschoola](https://github.com/oldschoola)).\n- Fixed vLLM discovery so `providers.vllm.baseUrl` drives the built-in endpoint, additional OpenAI-compatible vLLM provider IDs work through `openai-models-list`, and discovered `max_model_len` or fallback `context_length` values set context windows instead of falling back to 128k.\n- Fixed extension discovery ignoring package directories symlinked into an `extensions/` directory.\n\n### Removed\n\n- Removed the Python `openai-whisper` dependency and `pip` install path from speech-to-text \u2014 the bundled `transcribe.py` and all Python/whisper probes in `omp setup speech` are gone; the recorder (SoX/FFmpeg/arecord) remains the only external tool.\n- Changed the speech-to-text trigger from the `Alt+H` keybinding to a hold-`Space` push-to-talk gesture. Holding the space bar emits an OS auto-repeat burst; once more than 10 spaces land in the editor it recognizes the hold, deletes (tracks back) those inserted spaces, and starts recording, then stops and transcribes when the repeats stop (the space bar is released). `app.stt.toggle` is now unbound by default but can be rebound to a chord for press-to-toggle; the gesture is gated on `stt.enabled`, and `Shift+Space` still inserts a literal space.\n- Added an experimental, opt-in **auto-learn** loop (default off, `autolearn.enabled`). When enabled, after the agent stops it is nudged to capture reusable lessons: durable facts go to long-term memory and repeatable procedures become **managed skills** \u2014 `SKILL.md` files written to an isolated `~/.omp/agent/managed-skills` directory that is discovered and surfaced like authored skills but never overwrites user-authored skills (authored names always win). Two tools back this: `manage_skill` (create/update/delete managed skills) and `learn` (record a lesson, optionally minting a managed skill in the same call). `learn` works with the `hindsight`, `mnemopi`, or file-based `local` memory backend; under `local`, lessons append to a `learned.md` in the project's memory root (kept separate from the consolidation artifacts so they survive a consolidation pass) and are injected into future sessions. The nudge is passive by default (a hidden reminder rides the next turn); `autolearn.autoContinue` instead auto-runs one capture turn at stop, and `autolearn.minToolCalls` (default 5) gates trivial turns. Plan/goal-mode turns and subagents are never nudged.\n- Fixed `/plan` cycling between `plan` and `plan_paused` with no path back to mode `none`, while preserving prompted paused-mode requests. The no-arg third toggle now fully exits \u2014 clearing `planModeHasEntered` and appending a `mode_change` to `\"none\"` \u2014 and `/plan ` from `plan_paused` re-enters plan mode and submits the prompt as the first turn ([#2510](https://github.com/can1357/oh-my-pi/issues/2510)).\n- Fixed HTML session export rendering empty text tokens (`text`, `userMessageText`, `customMessageText`, `toolTitle`) as the dark-theme grey `#e5e5e7` on every theme not literally named `light`, making transcripts illegible on custom light themes like `sandstone`, `limestone`, and `porcelain`. `isLightTheme` now classifies against the resolved `statusLineBg` luminance (the same surface `Theme.isLight` uses), while HTML `defaultText` contrasts the actual export surface (`export.cardBg` / `export.pageBg` / derived `userMessageBg`) so light-status themes with dark export cards keep light transcript text ([#2516](https://github.com/can1357/oh-my-pi/issues/2516)).\n\n## [15.12.6] - 2026-06-14\n\n### Breaking Changes\n\n- Removed the `writeLine` and `writeLineSync` methods from the public `SessionStorageWriter` contract, requiring custom `SessionStorage` backends to switch to the `append` API\n\n### Added\n\n- Added package-level exports for `SessionContext`, session entry types, session listing/loader helpers, and migration APIs via `session/session-context`, `session/session-entries`, `session/session-listing`, `session/session-loader`, and `session/session-migrations`\n- Added asynchronous session-write `append(...)`-based persistence API in session storage implementations so callers can stream writes without sync line-appending methods\n\n### Changed\n\n- Changed session persistence internals to expose `writeTextAtomic(...)` on session storage writers for atomic whole-file replacements\n- Changed online session-title generation to support tool-choice-less title models. Providers/models that cannot be forced to call a tool (chat-completions hosts without `tool_choice` support such as DeepSeek V4, and Claude Fable/Mythos) are now prompted to wrap the title in `...` markers instead of the `set_title` tool call; extraction is lenient, accepting a plain sentence or a truncated/unclosed tag. A `TITLE_SYSTEM.md` override is reused in this mode with the marker instruction appended.\n\n### Fixed\n\n- Fixed session JSONL persistence so the first assistant turn materializes the file synchronously, leaves the append writer open, and writes later entries with a sync append writer even during writer-close races instead of waiting on a queued rewrite.\n- Fixed submitted user messages emitting OSC 133 command-start markers without a matching command-finished marker, which made some terminals group later transcript output under the first prompt instead of appending it normally.\n- Fixed queued forced tool choices being rejected and requeued or dropped when their named tool is no longer active for the upcoming turn, preventing eager todo and pending-action reminders from forcing unavailable tools. ([#1701](https://github.com/can1357/oh-my-pi/issues/1701))\n\n### Removed\n\n- Removed the `re-roots past a cwd-less legacy session in a shared explicit sessionDir` relocation test case and the `stores symlink-equivalent home cwd sessions under home-relative directories` file-operations test case.\n\n## [15.12.5] - 2026-06-13\n\n### Changed\n\n- Terminal resize now repaints only the viewport while a drag is in flight and defers the full transcript replay until the drag settles. Outside a multiplexer, every SIGWINCH used to erase and replay the entire transcript at the new width \u2014 re-laying-out (and, for markdown, re-lexing) all of history on each event, work thrown away the instant the next event arrived and re-done dozens of times a second during a drag. The TUI now composes and paints only the visible tail mid-drag \u2014 a new `ViewportTailProvider` fast path that the transcript implements by rendering blocks bottom-up and skipping everything above the fold, touching no commit/scrollback state \u2014 then runs the single authoritative rewrap + native-scrollback rebuild ~120 ms after the last resize event.\n\n### Fixed\n\n- Updated `docs/models.md` and `docs/providers.md` to reference the `omp models` subcommand (and `omp models canonical` / `omp models find`) instead of the removed top-level `--list-models` flag ([#2458](https://github.com/can1357/oh-my-pi/issues/2458))\n- Fixed unknown `--`-prefixed flags being silently consumed as prompt text, which let a stale or typoed flag start a real agent session (connecting to MCP servers, waiting on the model) instead of failing fast. `parseArgs` now tracks unrecognized flag-shaped tokens and `runRootCommand` calls `reportUnrecognizedFlags` immediately after the post-extension reparse, exiting `2` with `Error: unknown flag: --\u2026` before any session, MCP, or initial-message work runs. Extension-registered flags still pass cleanly since the validation runs after the extension-aware reparse ([#2459](https://github.com/can1357/oh-my-pi/issues/2459)).\n- Fixed prompt templates discovered from `cwd/.omp/prompts/` and the agent prompts directory not appearing in the slash-command autocomplete picker. `InteractiveMode.refreshSlashCommandState()` now feeds `session.promptTemplates` into the autocomplete provider alongside builtins and file-based slash commands; templates whose names collide with an existing command are skipped to mirror the runtime expansion order (`expandSlashCommand` precedes `expandPromptTemplate`) ([#2462](https://github.com/can1357/oh-my-pi/issues/2462)).\n- Fixed empty-Enter steering interrupts leaving the newest queued steer visible after aborting an auto-continued queued turn; queued turns now re-drain after every abort/settle cycle.\n- Added an agent-visible notice when the write tool auto-marks shebang files executable, so agents do not redundantly run `chmod +x`.\n\n## [15.12.4] - 2026-06-13\n\n### Breaking Changes\n\n- Removed the top-level `--list-models` flag path and migrated model listing to the new `omp models` command\n\n### Added\n\n- Added `omp models` command to list and manage models with `ls`, `find`, `canonical`, and `refresh` actions\n- Added `--json` output plus `-e/--extension`, `--no-extensions`, and `--config` controls to `omp models` listings\n- Added `skills.enableAgentsUser` and `skills.enableAgentsProject` settings (default on) so the canonical OMP-native `~/.agent[s]/skills` and project-walkup `.agent[s]/skills` are configurable independently from the third-party Claude/Codex/Pi toggles.\n\n### Changed\n\n- Model registry merge and `omp models` / model picker handle unknown context/output limits (`null`) \u2014 unknown limits render as `-` instead of a fake `222K`/`8.9K`.\n- Changed `omp models` to use cached provider data by default and require `omp models refresh` for a forced online re-fetch\n- Updated model-resolution errors to point to `omp models` when a provider or model is not found\n- Upgraded workspace catalog packages to their latest versions as of 3 days ago, and refactored the ACP agent implementation to be compatible with `@agentclientprotocol/sdk` version `0.25.0`.\n- Made the `zod` version requirement in the workspace catalog more tolerant (`^4.0.0` instead of `4.4.3`), and aligned type definitions in coding-agent extensibility modules.\n- Changed `/logout` to pick a stored account after the provider, so multi-account OAuth providers can remove one credential without logging out every account.\n- Changed the status-line context% to report the provider's real prompt-token count \u2014 anchored on the last assistant response, matching the `/context` panel and the collab host broadcast \u2014 instead of an independent cl100k estimate of the whole conversation. The estimate could read several points high and climb past 100% on subscription/Codex models (whose advertised window, e.g. `272K`, is already the input budget after reserving max output) while the request was still well within the real limit. Right after compaction the segment now shows `?` until the next response re-establishes the true count, and the redundant per-message estimate cache was dropped in favor of memoizing `getContextUsage()`.\n\n### Fixed\n\n- Fixed ACP thinking-delta mapping to tolerate live chunks that only carry delta text.\n- Fixed image input to Ollama (local `ollama`, `ollama-cloud`, and any `ollama-chat` model) failing with an opaque HTTP 400 when an attached image was encoded as WebP. Ollama decodes images through llama.cpp / `stb_image`, which is built without WebP support, so the resize pipeline now auto-excludes WebP for those models \u2014 the automatic equivalent of `OMP_NO_WEBP=1`, applied across every image path (`@file` mentions and prompt/paste/CLI attachments, the `read`/`inspect_image` tools, `eval` display images, `fetch`ed images, and browser screenshots). Other providers are unaffected and still honor `OMP_NO_WEBP`.\n- Fixed queued steering/follow-up display to derive from the agent-core queue, so queued chips clear when the core dequeues them and no longer strand after empty-Enter aborts.\n- Fixed model auth gateway probing to avoid skipping candidates with unknown `maxTokens` limits (`null`)\n- Fixed model listings so providers registered via extensions are now included from `-e` and configured `extensions` sources\n- Fixed `/mcp reauth`, `/mcp test`, and `/mcp unauth` to find and operate on MCP servers reported by `/mcp list` even when they are only runtime-discovered and not stored in writable config, including namespaced plugin servers like `cloudflare:cloudflare-api`\n- Fixed MCP server name validation so colon-namespaced server IDs are accepted when persisting reauth overrides so namespaced OAuth MCP servers can be stored in user config as `server:subserver` entries\n- Retried assistant turns that stop with reasoning/thinking only and no final text or tool call, so Gemini/Antigravity thought-only `STOP` responses continue instead of silently ending the session.\n- Fixed `~/.agent[s]/skills` not appearing as `/skill:` commands when every named source toggle (`skills.enableCodexUser`, `skills.enableClaudeUser`, `skills.enableClaudeProject`, `skills.enablePiUser`, `skills.enablePiProject`) was off: `loadSkills` gated the `agents` provider on `anyBuiltInSkillSourceEnabled`, so a user who turned off the Claude/Codex/Pi sources to clean noise also lost their own canonical OMP-native skills. The `agents` provider now reads the dedicated `enableAgentsUser`/`enableAgentsProject` toggles, decoupled from the third-party fall-through ([#2401](https://github.com/can1357/oh-my-pi/issues/2401)).\n- Fixed Windows PowerShell image paste so Ctrl+V can fall back to the PowerShell clipboard bridge when the native clipboard reader reports no image ([#2429](https://github.com/can1357/oh-my-pi/issues/2429)).\n- Fixed misaligned box borders in Mermaid ASCII rendering for CJK (Korean/Japanese/Chinese) and emoji labels \u2014 affects both fenced `mermaid` code blocks in assistant messages and the `render_mermaid` tool. `beautiful-mermaid@1.1.3` measures label width in UTF-16 code units while terminals render East Asian characters 2 columns wide; a `patchedDependencies` entry rebuilds its ASCII renderer to measure terminal display columns (grapheme-cluster aware, wcwidth-style policy). The patch mirrors the upstream PR (lukilabs/beautiful-mermaid#128) and should be dropped once it ships in a release.\n- Fixed interrupt loader state getting stuck after queued-message aborts by removing the session-layer flush/latch path; empty Enter now aborts the active turn and lets the existing post-unwind queue drain resume normally.\n- Fixed `/goal ` and `/goal set ` during streaming so goal context is steered immediately but objective submission waits for the active turn to finish instead of spamming `AgentBusyError` ([#2454](https://github.com/can1357/oh-my-pi/issues/2454)).\n- Fixed concurrent `omp --session` startups (e.g. cmux pane restore after an unclean shutdown) crashing with `SQLITE_BUSY_RECOVERY` while the agent SQLite databases were still under WAL recovery. The auth credential store and `AgentStorage.open()` retry the `SQLITE_BUSY` family with bounded backoff, and every shared SQLite open path (`AgentStorage`, history, autoresearch, memories, github cache, auto-QA grievances, catalog model cache, stats) now installs the busy handler before the first lock-taking statement so transient WAL recovery contention waits instead of crashing ([#2421](https://github.com/can1357/oh-my-pi/issues/2421)).\n- Mnemopi `per-project` / `per-project-tagged` bank derivation is now stable for one cwd, ignoring the surrounding git layout. Previously the bank id was hashed from `git.repo.resolveSync(cwd)?.repoRoot ?? path.resolve(cwd)`, so adding or removing a `.git` anywhere above the working directory silently repointed the same conversation to a new bank and stranded its memories (e.g. `/home/x/projects/repo` flipping between `projects-\u2026` and `repo-\u2026`). The derivation in `packages/coding-agent/src/mnemopi/config.ts` now hashes `path.resolve(cwd)` directly, and session startup widens the recall set with any sibling bank under `/banks/` whose `working_memory` rows already carry the active cwd in `metadata_json.$.cwd`, so memories stranded by the old, less-stable derivation become visible again on the next session without manual migration ([#2412](https://github.com/can1357/oh-my-pi/issues/2412)).\n- Fixed model switching (Ctrl+P role cycling and the alt+p / `/switch` / `/models` selector) intermittently freezing the UI for several seconds. `AgentSession.setModel`/`setModelTemporary` ran an eager `await modelRegistry.getApiKey(model)` purely as an existence pre-flight and discarded the value \u2014 but `getApiKey` does real work: it synchronously executes command-backed key programs (`apiKey: \"!cmd\"`, `execSync` with a 10s timeout, blocking the event loop) and refreshes OAuth tokens over the network when one crosses the expiry window (the \"fine for a few switches, then a multi-second stall\" symptom). Switching now uses the synchronous, side-effect-free `ModelRegistry.hasConfiguredAuth` check; the concrete key (command execution + OAuth refresh) is still resolved lazily per request via the existing resolver, so an unconfigured provider still fails fast with `No API key` while a healthy switch never touches the network or spawns a subprocess. `hasConfiguredAuth` no longer runs the command program or refreshes tokens either, matching its documented \"probe without resolving an API key\" contract.\n- Fixed session resume (`pi -c` / `--continue` / `--session`) hanging for ~10s at startup \u2014 surfaced by the watchdog as `Still starting \u2026 phase: createAgentSession > restoreSessionModel` \u2014 when an OAuth token needed refreshing or the auth broker (`OMP_AUTH_BROKER_URL`) was unreachable. Picking which saved model to restore is a pure *selection* that only needs to know whether auth is configured, but `restoreSessionModel` probed each candidate with the async `getApiKey`, which refreshes OAuth tokens over the network, executes command-backed key programs, and issues auth-broker requests \u2014 so a slow or unreachable endpoint stalled resume for the full refresh timeout per candidate. Startup model selection now uses the synchronous, side-effect-free `ModelRegistry.hasConfiguredAuth` probe (the same fix already applied to interactive model switching); the concrete key is still resolved lazily on the first request via the resolver.\n\n## [15.12.3] - 2026-06-12\n\n### Fixed\n\n- Restored the intended double-Esc default to `/tree` and fixed the Esc-opened selector path to reset the terminal display instead of preserving stale scrollback when the selector opens.\n\n## [15.12.2] - 2026-06-12\n\n### Fixed\n\n- Collab links now dot-join the room secret (`.`, `host/r/.`) instead of using a second `#`: RFC 3986 forbids a raw `#` inside a URL fragment, so macOS Foundation (behind terminal click-to-open) percent-encoded the browser deep link's second `#` to `%23` and the web client rejected the session. `/join`, `omp join`, and the web client still accept legacy `#`-joined links and leniently decode `%23`-mangled ones\n- Fixed `brew install can1357/tap/omp` failing on macOS with `sandbox-exec \u2026 exited with 1`: the generated `Formula/omp.rb` (rendered by `scripts/ci-update-brew-formula.ts`) now stamps `using: :nounzip` on every per-platform `url` so Homebrew leaves the bare Mach-O/ELF asset in the staging CWD (the previous `Dir[\"omp-*\"].first` returned `nil` because `UnpackStrategy::Uncompressed#extract_nestedly` nested the file outside it), and wraps `generate_completions_from_executable` in `with_env(HOME: buildpath)` so the popened binary's `~/.omp` lookup goes to the writable staging dir instead of the sandbox-denied real home ([#2398](https://github.com/can1357/oh-my-pi/issues/2398))\n\n## [15.12.1] - 2026-06-12\n\n### Added\n\n- Added the `compaction.dropUseless` setting (default on): tool results flagged contextually useless are elided by the per-turn cache-aware prune pass and the pre-compaction threshold prune, replaced with `[Uneventful result elided]`. Built-in tools flag their uneventful outcomes \u2014 zero-match/zero-result `search`/`find`/`ast_grep`/`recall` (warnings included; the follow-up call has already corrected course), empty LSP lookups, `job` polls where everything is still running (plus nothing-to-wait-for and unknown-id polls), `irc` wait timeouts and empty inbox drains, and zero-result `github` searches / run-watch give-ups\n\n### Fixed\n\n- Restored the default double-Esc behavior to open the editable message-history selector instead of `/tree` so pressing Esc twice can edit a previous message again ([#2396](https://github.com/can1357/oh-my-pi/issues/2396)).\n\n## [15.12.0] - 2026-06-12\n\n### Added\n\n- Added `/collab view` command to create a read-only spectator join link\n- Added read-only hints and status text for guest-only participation in collab sessions\n- Added `share.serverUrl` and `share.redactSecrets` settings: the share server/viewer base for `/share` links (default `https://my.omp.sh/s`) and a toggle (default on) that runs the secret obfuscator over the shared snapshot before upload\n- HTML session exports now embed subagent transcripts: sub-session files stored next to the session (`/.jsonl`, recursively) ride along in the export payload, agent ids in task tool cards become drill-down links, and a breadcrumbed overlay renders each subagent's full transcript \u2014 including its own tool cards and deeper nested agents \u2014 with Esc/backdrop navigation\n- Added Agent Hub focus mode: Enter on a local agent now retargets the main view to that live subagent session with regular transcript rendering, steering, Esc-to-main return, \u2190\u2190 parent navigation, and a ghost status-line badge.\n\n### Changed\n\n- Blocked cycling model and thinking presets while a focused subagent session is active and now prompts users to return to the main session first\n- Changed `codexResets.autoRedeem` from a boolean to `unset`/`yes`/`no`: unset runs the eligibility check and asks before spending a saved Codex reset, yes redeems without prompting, and no skips the check entirely\n- Changed collab links so full links with a write token grant mutation rights while links without a token now join as read-only\n- `/share` no longer uploads a plaintext HTML export to a gist for gistpreview. It now snapshots the session JSON, gzips and seals it with a fresh AES-256-GCM key, and pushes the blob to a secret gist (when `gh` is authenticated) or to the share server (capped at 1 MB; oversized sessions are trimmed \u2014 images first, then long strings, then oldest entries). The share link is `https://my.omp.sh/s/#`: the viewer fetches the blob (hex ids from the gist API, others from the relay store) and decrypts it in-browser, so the key never leaves the client. Configured secrets are additionally redacted from the snapshot unless `share.redactSecrets` is off. Custom `~/.omp/agent/share.{ts,js,mjs}` handlers keep the legacy HTML-file contract; `/share` also works for in-memory (`--no-session`) sessions now\n- `/collab` now prints a join hint with both link forms: the compact `omp join` link for terminals and a click-to-join browser deep link (`https:///#`, displayed scheme-less, OSC 8-linked) \u2014 the relay serves the collab web client at `/`, and the room id + key ride in the URL fragment, so they never appear in any HTTP request. `/join`, `omp join`, and the web connect screen accept either form\n- npm installs no longer download fastembed's ~270MB ONNX native dependency tree eagerly: `fastembed` and `onnxruntime-node` are external to the bundle and optional peers of `@oh-my-pi/pi-mnemopi`, fetched on demand only when Mnemopi local embeddings are first used\n- The `job` tool prompt now documents that omitting `poll` waits on all running jobs, so agents stop enumerating every job id to poll everything\n- Collapsed task tool blocks now cap the per-agent list at 4 rows: the live progress view keeps the running/pending tail visible behind a `\u2026 N more agents (\u2026)` summary line with per-status counts, finalized batches keep failed/aborted rows visible while folding the slowest successes, and the streaming call preview caps at the same 4 (expand shows the full list)\n- The anchored Subagents HUD above the editor now lists only detached background spawns: sync task calls (the parent turn is blocked and the inline tool block already renders live progress) and eval `agent()` helpers (rendered by their eval cell's own progress tree) no longer appear in the list\n- Completed rows in the `job` tool output now show the standard done checkmark instead of the watch glyph that replaced the spinner\n- HTML session exports render tool calls through the same React tool renderers the collab web client uses: per-tool views for all built-in tools (bash, edit diffs, todo boards, eval cells, task batches, LSP, search, browser screenshots, \u2026) are bundled as an `` web component into the export instead of the previous string-built dummy renderers\n- Modernized the HTML export page chrome to match the tool-card design language: hairline borders, dense mono typography, compact role-tinted message cards, refined tree sidebar and filter controls, themed scrollbars, collapsed-by-default thinking blocks, and mobile sidebar drawer \u2014 derived from the active theme's variables so light and dark themes both render correctly\n- Agent Hub's embedded chat overlay is now reserved for collab guest viewing; local agents open in the main session renderer instead.\n\n### Fixed\n\n- Filtered silent abort markers from Agent Hub assistant output so failed turns now render as normal error text\n- Reset focus-session state when switching transcript rendering between the main session and a focused subagent so streaming/progress context no longer leaks across sessions\n- Fixed read-only collab sessions so prompting, interrupts, and other write actions are blocked with a read-only warning instead of being applied\n- Fixed Mnemopi local embeddings in bundled and compiled installs failing with `Cannot find module '../bin/napi-v3/.../onnxruntime_binding.node'`: the Bun bundle inlined fastembed's loader so its relative native require resolved against `dist/cli.js`. `fastembed`/`onnxruntime-node` are no longer bundled; on first use Mnemopi `bun install`s the pinned pair into `~/.omp/cache/fastembed-runtime/` and loads the binding from there ([#2389](https://github.com/can1357/oh-my-pi/issues/2389))\n- Fixed the interactive Model scope startup banner so models without an explicit thinking level do not show `:undefined`, and entries that were scoped without a `:level` are no longer rendered with the global default thinking level (which `applyRootSessionOptions` pre-fills on the cycling array for Ctrl+P) ([#2385](https://github.com/can1357/oh-my-pi/issues/2385)).\n\n## [15.11.8] - 2026-06-12\n\n### Added\n\n- Updated collab link handling to accept compact `roomId#key` links and relay hosts without explicit scheme when joining or starting sessions\n- Added `/collab stop` and `/collab status` options to control and inspect active shared sessions\n- Added `/collab`, `/join`, and `/leave` for live session sharing: the host shares an end-to-end encrypted link (AES-256-GCM key only in the link fragment; the relay sees opaque bytes) and guests render the session natively in their own TUI \u2014 streaming text, tool cards, footer state, ctrl+o expansion, `/dump` \u2014 and can prompt or interrupt the host's agent. Guest prompts render with an author badge; session-mutating commands stay host-only. Defaults to the public `relay.omp.sh` relay (`collab.relayUrl`); a self-hostable Go relay lives in the pi-www repo as `omp-collab-relay`\n- Added `collab.relayUrl` and `collab.displayName` settings plus a `collab` status-line segment showing the participant count (host) or guest role. Guests mirror the host's real model/thinking state into their replica agent and the host's subagent ecosystem end-to-end: the live subagent HUD, the Agent Hub table with live progress, hub chat/kill/revive (routed to the host), and on-demand subagent transcript viewing\n- Added `omp join ` subcommand that launches the interactive TUI and immediately runs `/join `\n\n### Changed\n\n- Moved collab live-session wire contracts into `@oh-my-pi/pi-wire` and stopped broadcasting unsupported session events or entries to collab guests.\n- The Ctrl+P role-cycle track and the plan-approval model slider now color segments by track position from the theme's own palette (accent/success/warning/error + markdown/syntax hues, deduplicated per theme since many themes alias them) instead of role-keyed colors with a gray fallback for custom roles\n- Interactive boot no longer blocks first paint on MCP server discovery. For UI sessions, `createAgentSession` returns immediately and connects to configured MCP servers in the background; their tools and slash commands stream in through the existing live-refresh channel once connected. An explicitly requested MCP tool whose server has not finished connecting resolves to a deterministic \"still connecting\" placeholder instead of an \"unknown tool\" error, and each server's instructions join the system prompt once its background connection completes \u2014 carried in on the same live-refresh that registers its tools \u2014 so server-provided instructions are preserved, not dropped. `tools.discoveryMode: \"auto\"` is re-resolved once the background connect reports the real MCP tool count, so a toolset large enough to cross the threshold flips discovery on (registering `search_tool_bm25`) instead of force-activating every tool, and a session disposed while servers are still connecting disconnects them instead of resurrecting their tools onto the dead session. Non-UI modes (`print`/`rpc`/`acp`) keep the blocking discovery path. Measured ~290 ms (\u224824% of cold boot) off the first-paint critical path with MCP servers configured.\n- Assistant-message streaming is cheaper per token. During a stream the component now reuses its `Markdown` subtree across reveal ticks \u2014 only the growing block is re-rendered \u2014 instead of tearing down and re-lexing every block on each ~30 fps tick, and grapheme counting in the reveal controller is memoized. A completed thinking block that precedes a still-streaming answer is no longer re-highlighted every frame (~66% less render work on think-then-answer streams in benchmarks; single-block streams are unchanged).\n- Cold boot no longer builds the model catalog's canonical-equivalence index on the first-paint critical path. The `ModelRegistry` constructor built `buildCanonicalModelIndex` over the entire ~3,200-model catalog synchronously (~210 ms); it is now built lazily on first read (`getCanonicalModels`/`getCanonicalVariants`/`getCanonicalId`, reached by the model picker and by `enabledModels`/default-role pattern resolution), which a default interactive launch never touches before paint. Measured ~244 ms (\u224816% of cold-boot wall) off first paint; the picker pays the one-time build on first open.\n- Repeat `read` summaries of an unchanged file no longer re-run the tree-sitter parse. The per-session summary is memoized on the content hash of the freshly-read bytes \u2014 the file is still read fresh on every call, so results stay correct without a staleness window \u2014 dropping a repeated same-file summary read from ~17 ms to ~2.5 ms.\n- Attributed the previously-unlabeled synchronous boot region in the `PI_TIMING` startup table with `modelRegistry:init`, `buildCanonicalModelIndex`, and `initTelemetryExport` spans.\n\n### Fixed\n\n- Fixed remote (SSH) image attachment silently inserting the local-machine path as plain text: when omp runs over SSH and the terminal forwards a bracketed-paste image path, the path is unreachable from the remote host. The path-as-text fallback is gone for unreachable paths and the status now points the user at the clipboard image-paste shortcut so the bytes actually cross the connection ([#2375](https://github.com/can1357/oh-my-pi/issues/2375)).\n\n### Security\n\n- Rejected non-local `ws://` relay URLs and invalid room keys when parsing collab links to prevent insecure or malformed session joins\n\n## [15.11.7] - 2026-06-12\n\n### Added\n\n- Added mouse support to the setup wizard, including hover, wheel scrolling, and click-to-select for provider sign-in, web-search provider, glyph, and theme option lists\n- Added pointer support for the providers tab bar so tabs can be selected by click and wheel scrolling works inside the active panel\n- Added left-click navigation in setup wizard splash/outro screens to advance or exit without pressing Enter\n- Added `bench` CLI command to benchmark model selectors with a shared prompt and report time-to-first-token and throughput\n- Added `omp bench` options `--runs`, `--max-tokens`, `--prompt`, and `--json` to control run count, response length, prompt text, and machine-readable output\n- Added benchmark failure reporting that shows per-run errors, flags failed runs in the summary, and exits with a non-zero status when any model benchmark fails\n- Added `snapcompact.shape` setting to pick the frame variant snapcompact prints text with \u2014 `auto` (each provider's eval winner) or any research-eval variant: the square grids (`8x8r`/`8x8u`/`6x6u`/`5x8` \u00d7 sentence-hue/black ink) and the per-model winners (`6x12-dim`, `8x13-bw`, `8on16-bw`, `doc-8on16-bw`, `doc-8on16-sent`, `doc-8on16-sent-dim`); applies to both the compaction archive and inline system-prompt/tool-result imaging\n\n### Changed\n\n- Updated `snapcompact.shape` option help text so the `auto` mode and `8on16-bw` descriptions now reflect OpenAI\u2019s current default and GPT winner variants\n- Model selectors keyed by retired effort-tier variant ids keep resolving after catalog collapsing: reference resolution and bare-id matching consult the hand-table aliases (`gemini-3.5-flash-low`, `gemini-pro-agent`, recycled `gemini-3-flash`) plus the `X-thinking` \u2192 `X` grammar for auto-collapsed pairs, with exact matches always winning while a raw id is live; explicit `:effort` suffixes transfer unchanged. models.yml `modelOverrides` and rate-limit selector suppressions keyed by raw member ids re-key onto the collapsed model\n- Custom/config provider model lists now collapse `X`/`X-thinking` twins at registry rebuild (`collapseBuiltModelVariants`), folding config-defined twins into one entry whose thinking toggle routes to the `-thinking` backing id\n\n### Fixed\n\n- Fixed Ctrl+T thinking-block toggles clearing the pending user message and loader before the assistant stream starts ([#2370](https://github.com/can1357/oh-my-pi/issues/2370)).\n- Fixed Windows CodeGraph MCP launches from npm `.cmd` shims by resolving the shim's Node entry point and spawning it directly, keeping stdio attached to CodeGraph instead of the transient `cmd.exe` wrapper ([#2367](https://github.com/can1357/oh-my-pi/issues/2367)).\n- Fixed snapcompact archives going partially unreadable on OpenRouter, which hard-caps requests at 8 images and silently drops the excess: compaction now passes a provider-aware frame budget (`providerFrameBudget`) so the archive never exceeds the cap (unknown providers get a safe floor of 5), with overflow kept as a text tail on the summary instead of rendering frames the gateway would drop; inline system-prompt/tool-result imaging shares the same per-provider budget (`providerImageBudget`), so once existing images exhaust it (e.g. 8 archive frames on OpenRouter) tool results ship verbatim as text\n- Fixed Hindsight retains to send offset-aware local timestamps instead of UTC `Z` strings so extraction prompts keep the user's local time-of-day context ([#2363](https://github.com/can1357/oh-my-pi/issues/2363)).\n- Fixed tool calls taller than the viewport reading as cut off while streaming (the head reappeared only once the result landed): the 15.11.6 stranded-preview fix marked every collapsed pending tool preview commit-unstable, which also blocked durable top-anchored streams \u2014 e.g. a task call's context/assignment markdown \u2014 from reaching native scrollback mid-run. Commit stability is now classified per renderer (`ToolRenderer.provisionalPendingPreview`): only the tail-window previews the result render re-anchors (edit/apply_patch streamed-diff tails, bash/ssh command caps, eval cells with interleaved outputs) stay provisional; every other pending preview commits its settled head mid-stream again\n- Fixed `omp bench` reporting \"tokens 0, TPS 0.0\" successes on repeated OpenRouter runs: pi-ai opts every OpenRouter request into response caching, so bench's byte-identical request replayed a cached generation with zeroed usage at edge speed. Bench now sends `X-OpenRouter-Cache: false` so every run measures a fresh generation\n- Fixed `omp bench` failing with HTTP 400 `{\"detail\":\"Instructions are required\"}` against `openai-codex` models: bench requests now carry a minimal default system prompt (same guard as eval's completion bridge)\n- Fixed pressing `Ctrl+T` (toggle thinking blocks) \u2014 or hitting any other rebuild path such as the theme/preset selector \u2014 during the pre-streaming window after a submission erasing the just-submitted user message until the first assistant token arrived: the user message is rendered optimistically before `session.prompt(...)` lands it in session entries, so `rebuildChatFromMessages()` had no record of it; it now replays an in-flight optimistic submission after rebuilding the transcript, gated on `optimisticUserMessageSignature` (cleared by `EventController` once the real `message_start` lands) so it cannot duplicate post-streaming ([#2372](https://github.com/can1357/oh-my-pi/issues/2372)).\n\n## [15.11.6] - 2026-06-12\n\n### Changed\n\n- Renamed the saved Codex reset command from `/reset-usage` to `/usage reset` and added `/usage show` as an explicit alias for plain `/usage`.\n\n### Fixed\n\n- Fixed the Subagents HUD order so progress updates no longer move active rows; batched subagents keep their task order.\n- Fixed `/settings` dirty-value highlighting so changed values stay orange while the row has keyboard focus.\n\n## [15.11.5] - 2026-06-12\n\n### Added\n\n- Added `codexResets.autoRedeem`, `codexResets.minBlockedMinutes`, and `codexResets.keepCredits` settings so Codex users can opt in to automatic spending of saved rate-limit resets\n- Added automatic Codex reset redemption flow so a blocked weekly usage-limit request can be retried immediately after consuming a saved reset when auto-redeem is enabled\n- Added `--history` mode to `omp usage` to show recorded usage-limit history instead of a single live snapshot\n- Added `--days` (`-d`) support for `omp usage --history` to control the history window (default 7 days)\n- Added historical usage output for `omp usage --history`, including per-limit sparklines with latest and peak percentages\n- Added `--json` support in `omp usage --history` to emit timestamped usage-history snapshot data\n- Added guidance and exit code 1 when no usage history is available for the selected window\n- Added an anchored Subagents HUD above the editor (next to the Todos block) listing every running subagent as `Id: description`; rows appear on spawn and the block clears itself when the last subagent finishes\n- Added `/reset-usage` command to spend a saved Codex rate-limit reset by running `/reset-usage `, with a TUI selector flow for interactive reset redemption\n- Added `snapcompact.systemPrompt` enum modes `none`, `agents-md`, and `all`, so users can disable system-prompt imaging, image only loaded AGENTS.md/context-file instruction sections, or image the full system prompt\n- Added `agents-md` snapcompact mode that rasterizes AGENTS.md-style context sections from the system prompt into frames and appends them to the first user message\n- `/context` (TUI panel and ACP report) now shows estimated snapcompact wire savings when `snapcompact.systemPrompt` or `snapcompact.toolResults` is enabled \u2014 per-feature text \u2192 frames token deltas, the reason a swap does not apply (savings margin, image budget, or text-only model), and the estimated size of the next request. The estimate and the live provider-request transform share one planner (`planInlineSwaps`) so displayed numbers cannot drift from wire behavior.\n- Added `/debug dump-request` and `/debug next-request` as aliases for `/debug dump-next-request` when arming a one-shot AI provider request dump\n- Added `/debug dump-next-request ` to dump the next AI provider HTTP request JSON to a chosen file.\n\n### Changed\n\n- Changed usage views (`/usage` reports, status summaries, and account headers) to show available saved Codex rate-limit resets and point to `/reset-usage` for spending them\n- Changed `/context` system-prompt savings lines to show the scope as `AGENTS.md` or `all`, so savings estimates now indicate whether imaging applied only to context-file instructions or the entire prompt\n- Changed `/debug` handling in interactive mode so `/debug` with arguments now executes the requested debug subcommand instead of always opening the debug selector\n- Changed `/debug dump-next-request` path handling to expand `~` and resolve relative paths against the current working directory\n- Changed the task tool's TUI block: the header now shows the task dispatch glyph (`tool.task`) while agents are in flight instead of a spinner (async spawns return immediately, so a spinner misread the call as blocking), and per-agent rows use one static dot for every state \u2014 completed rows keep the same dot and settle from accent to the plain foreground color instead of switching to a different status glyph\n- Compressed the `eval`, `browser`, `read`, and `irc` tool prompts (6156 \u2192 4932 tokens o200k, \u221220%): deduplicated claims across sections, tightened helper reference descriptions, trimmed redundant examples; input grammar, examples, and template conditionals (`py`/`js`/`spawns`, read display modes) unchanged\n- Changed the Nerd Font `tool.task` icon to the Octicons tasklist glyph.\n\n### Fixed\n\n- Fixed settings search to rank matching tabs by relevance so exact matches appear before incidental matches\n- Fixed the `/settings` search bar ignoring regular editor hotkeys: the query is now a real single-line input with cursor movement (`\u2190/\u2192`, word jumps, Home/End), word deletion (`Alt+Backspace`, `Ctrl+W`), kill/yank, undo, and paste support\n- Fixed snapcompact `toolResults` imaging confusing models into reporting tool malfunctions: the note prepended to rasterized tool results now tells the model the result is in the PNG frame(s) below and that the image delivery is deliberate, not a tool error, instead of the bare `[Rasterized]` marker\n- Fixed tool-call boxes rendering \"inside themselves\" after slow tool runs: a pending collapsed preview that sat byte-static past the stable-prefix window (e.g. an edit's tail-window diff while the apply + LSP pass ran) had its settled head committed to native scrollback, and the result render then stranded that stale call-box fragment above the final block. Pending collapsed tool previews are now provisional (`isTranscriptBlockCommitStable`) and never enter scrollback mid-run; expanded top-anchored streams keep committing mid-stream\n- Fixed the higher-level Responses retry classifier to recognize OpenAI Zero Data Retention rejections (`Previous response cannot be used for this organization due to Zero Data Retention`) as stale-replay errors. The provider-level fix in `@oh-my-pi/pi-ai` covers the common case in a single turn; this layer additionally guarantees that any ZDR error that still bubbles up resets the Responses session and retries at zero backoff instead of falling back to a different model ([#2341](https://github.com/can1357/oh-my-pi/issues/2341)).\n\n### Removed\n\n- Removed the todo task notes feature: `op: \"note\"`, the `text` payload, task `notes` state, markdown note blocks, and note rendering are no longer supported.\n\n## [15.11.4] - 2026-06-12\n\n### Added\n\n- Added mouse-driven interaction to `/settings`, including tab and setting row hover highlighting, wheel scrolling, and left-click activation for entries and submenus\n- Added fullscreen `/settings` mouse-event handling so scrolling and clicks work in an alternate-screen overlay\n- `ModelRegistry.resolver` now accepts a model directly \u2014 `resolver(model, sessionId)` \u2014 deriving `provider`, `baseUrl`, and `modelId` from it; all model-scoped call sites migrated from the verbose `resolver(model.provider, { sessionId, baseUrl, modelId })` form.\n- Added experimental `snapcompact.systemPrompt` and `snapcompact.toolResults` settings (off by default, `/settings` \u2192 Context \u2192 Experimental) that render the system prompt and large historical tool results as dense snapcompact PNG frames on vision-capable models to cut token cost. Frames are built per-request in the provider-context transform, cached across turns, capped by a per-provider image budget, and gated on a token-savings estimate \u2014 they never reach `session.jsonl`.\n- Added a Personality selector to `/settings` (Model \u2192 Prompt): `default` (the previous built-in reply style), `friendly`, `pragmatic`, or `none`. The selected spec renders into a dedicated `` system-prompt block (extracted from the former `` section) and applies to the live session immediately; subagents always omit the block.\n- Added `mnemopi.polyphonicRecall` and `mnemopi.enhancedRecall` config.yml settings (off by default, `/settings` \u2192 Memory \u2192 Mnemopi) that enable the mnemopi 4-voice polyphonic recall engine and the tiered query result cache without environment variables; `MNEMOPI_POLYPHONIC_RECALL` / `MNEMOPI_ENHANCED_RECALL` still override the configured values when set ([#2323](https://github.com/can1357/oh-my-pi/issues/2323)).\n\n### Changed\n\n- Changed `/settings` keyboard navigation so `Tab` and `Shift+Tab` toggle focus between section headings and setting rows in sectioned lists, with `\u2191/\u2193` jumping sections, `\u2190/\u2192` switching tabs, and status text reflecting the active controls\n- The `task` tool description now mandates batching parallel spawns into one call's `tasks[]` (sharing `context` once) instead of presenting multiple `task` calls per message as an equal alternative; separate calls are reserved for different agent types or unrelated context\n- Updated `/settings` on-screen navigation hints to match the new section-focus behavior (`\u2191/\u2193` and `Tab/Enter`) and tab-switching arrows\n- Changed `/settings` to open as a full-screen overlay on the alternate screen so it no longer shares space with the underlying transcript\n- Codex, Gemini, and Perplexity web search now route their OAuth bearers through the new `withOAuthAccess` driver: a 401 or usage-limit force-refreshes the same account and then rotates to a sibling instead of failing the search, while identity metadata (`chatgpt-account-id`, Google `projectId`) is re-derived from the refreshed credential on every retry.\n- Kagi web search, the xAI TTS tool, and model-discovery list fetches now resolve their bearers through `withAuth` with an auth-storage resolver instead of a one-shot key snapshot, gaining the same force-refresh + rotate retry on 401.\n- Compaction, handoff, and branch-summarization call sites now hand the compactor a per-candidate API-key resolver (availability still gated on a key snapshot), so credential refresh happens before the #986 fallback-model loop advances.\n- The mnemopi backend now passes an OpenRouter resolver for default embedding/extraction setups (AuthStorage-stored keys included), keeping pinned literal keys and custom endpoints unchanged.\n- Reorganized the `/settings` panel for findability: every tab now has titled sections backed by a per-tab layout contract (`TAB_GROUPS`); on wide terminals the panel renders a section sidebar with the active section's settings beside it (narrow terminals keep a flat list with inline headings), and PgUp/PgDn jump section-to-section. The Editing tab became Files (edit/read/LSP) and a new Shell tab hosts bash, eval, and Python settings. Misplaced settings were rehomed: bash toggles united under Shell, tool approval mode and policies together under Interaction \u2192 Approvals, marketplace auto-update next to startup update checks, and the todo auto-clear delay beside the other todo settings.\n- Restyled the `/settings` chrome: the tab strip moved below the content as a label-less footer, the panel keeps one constant height across navigation, value changes, and submenus (no more viewport jumps after each change), and typing now runs a global cross-tab search \u2014 results group under per-tab headings, the footer shows live match counts with non-matching tabs muted, Tab hops between matching tabs, and Esc exits search landing on the selected result's tab.\n- Normalized `/settings` labels and descriptions: consistent Title Case labels (e.g. \"Todo Auto-Clear Delay\", \"GitHub View Cache\"), uniform unit placement, articles and verb-first phrasing in descriptions (\"If false\u2026\"/\"Whether to\u2026\" rewritten), and a stale browser-tool description (Ulixee Hero) corrected to the actual puppeteer/Chromium implementation.\n- `/settings` section headings are now underlined \u2014 the active section's heading stays bold, and headings outside the active section render dim with the same underline \u2014 so section boundaries read at a glance.\n- `/settings`: Tab now toggles keyboard focus between section headings and the setting rows \u2014 while headings are focused, \u2191/\u2193 jump whole sections and Enter/Esc drop back into the rows \u2014 instead of cycling tabs. \u2190/\u2192 still switch tabs everywhere, tabs without sections (e.g. Plugins) keep Tab as tab-switching, and the footer hint follows the focus state.\n- Image-generation (Antigravity, xAI, OpenRouter, Gemini) and xAI TTS request failures now throw pi-ai's typed `ProviderHttpError` carrying status and response headers instead of `Object.assign`-patched `Error`s.\n- Collapsed bash, ssh, and eval previews now cap the command/code section to a viewport-sized tail window (terminal rows minus a chrome reserve) that renders identically while streaming and after completion, with `ctrl+o` as the only way to uncap. Previously bash/ssh capped the command only while streaming and snapped it fully open the moment the tool finished, and eval never capped cell code at all.\n- The `job` renderer now shimmers running-job labels while the poll block is live, freezing to static once the block seals, and drops the id column when the label repeats it \u2014 task jobs label themselves with their agent id, so rows read `\u27e8task\u27e9 SessionTree` instead of `SessionTree \u27e8task\u27e9 SessionTree`.\n- Task progress rows now render static text with the task icon instead of shimmering the description or showing the pending/hourglass status glyph.\n- `app.clipboard.pasteImage` (`Ctrl+V`) now falls back to pasting clipboard text when no image is present, so hosts that deliver only that chord (VS Code's integrated terminal forwarding `Ctrl+V`, Windows clipboard history via `Win+V`) cover both payload kinds; WSL text reads now reach the Windows clipboard through host PowerShell like image reads already did ([#1628](https://github.com/can1357/oh-my-pi/issues/1628)).\n- Changed `/usage` to show the OAuth account currently selected for the active model provider when usage reports include multiple accounts, making multi-account sessions easier to verify without marking unrelated providers.\n\n### Fixed\n\n- Fixed session tree connector rendering in `/tree` and the HTML export: flattened chain rows under a last-sibling (`\u2514\u2500`) branch drew a dangling `\u2502` in the corner column itself and shifted columns once the chain branched deeper; the chain anchor now sits one level right, below the branch head's content, so connectors terminate at `\u2514\u2500` and indentation stays stable ([#2325](https://github.com/can1357/oh-my-pi/issues/2325)).\n- Fixed prompt and image input typed while the agent is idle between turns from being dropped so steering now queues and auto-resumes processing once the session is ready\n- Fixed image-bearing prompts queued during compaction registering their local-submission signature without the image count, so the delivery event treated them as foreign messages \u2014 clearing any draft typed since queuing and leaking the stale signature.\n- Fixed Esc/Alt+Up queue restoration dropping attached images: `clearQueue()` and `popLastQueuedMessage()` now hand queued images back alongside the text, and the restore paths return them to the pending-image buffer instead of silently discarding them.\n- Fixed a failed steer submission in the no-input-waiter path discarding the message: the text and images are restored to the editor for retry instead of being lost to history-only recovery.\n- Fixed local memory consolidation on Responses-style models that reject user-only requests by sending a dedicated stage-two system prompt.\n- Fixed the settings sidebar divider alignment in `/settings` by locking sidebar width to the widest group name so switching tabs no longer shifts the layout\n- Fixed plan-review overlay mouse hit-testing so wheel, hover, TOC, and body clicks map to the intended regions\n- Fixed `lsp.formatOnWrite` sending a hardcoded `tabSize: 3, insertSpaces: true` on every `textDocument/formatting` request, which silently re-indented 2-space YAML (and any LSP-formatted file) to 3-space on every write/edit through formatter-aware servers like `yaml-language-server`. Format options are now resolved per-file from `.editorconfig` (`indent_size`, `indent_style`, `tab_width`), falling back to the indent sniffed from the in-memory content the agent is about to write, then to a 2-space default. The duplicate `DEFAULT_FORMAT_OPTIONS` constant in `lsp/index.ts` and `lsp/clients/lsp-linter-client.ts` is replaced with a single shared `resolveFormatOptions` helper ([#2329](https://github.com/can1357/oh-my-pi/issues/2329)).\n- Fixed stale OpenAI Responses replay failures such as `Item with id 'rs_...' not found.` by resetting the provider session and retrying without advancing fallback chains.\n- Fixed `/settings` Escape handling so an open submenu receives Esc and returns to the settings list before a second Esc closes the panel ([#2331](https://github.com/can1357/oh-my-pi/issues/2331)).\n- Fixed Escape not closing `/settings` on the Plugins tab while the async plugin list is still loading: `PluginSettingsComponent` now closes on Esc while no child view is mounted, and an npm plugin registry listing failure is caught (like marketplace failures) so a bad registry no longer leaves the tab permanently blank ([#2331](https://github.com/can1357/oh-my-pi/issues/2331)).\n- Fixed unconfigured `pi/smol`, `pi/slow`, and `pi/designer` agent model roles using cloud-priority defaults before the user's configured `modelRoles.default`, which could route local-default setups to authenticated paid providers ([#2336](https://github.com/can1357/oh-my-pi/issues/2336)).\n- Fixed `issue://` reads failing on older GitHub CLI releases that reject the optional `stateReason` issue JSON field; single issue reads now retry without it and issue listings no longer request it ([#2333](https://github.com/can1357/oh-my-pi/issues/2333)).\n- Fixed image generation ignoring `/login`-stored OpenRouter and Google API keys: provider selection and requests now resolve through the model registry (with env-var fallback) instead of environment variables only.\n- Fixed detached (`task` async spawn) progress snapshots repainting commit-eligible rows after the block leaves the live transcript region; later partial snapshots are dropped while the final completion snapshot still applies.\n- Fixed five consumers treating Zod tool-parameter schemas as plain JSON Schema objects, leaking schema-instance internals (`def`, `shape`, methods stringified as `undefined`) or silently reading nothing: `/dump` and the RPC `get_state` `dumpTools` payload now convert parameters through the same wire-schema conversion providers receive; context-usage token estimation no longer stringifies the Zod `def` tree (overcounting tool schema tokens in the status line); tool-discovery search indexing recovers `schemaKeys` from Zod tools (previously empty, weakening BM25 ranking); and the extension inspector panel renders Zod tool arguments instead of \"(no arguments)\".\n\n## [15.11.3] - 2026-06-11\n\n### Fixed\n\n- Fixed stale `Working\u2026` loader rows being committed to native scrollback above the live loader: the interactive status container now reports a live-region seam while it has mounted content ([#2328](https://github.com/can1357/oh-my-pi/pull/2328) by [@35844493](https://github.com/35844493)).\n- Fixed Mnemopi memory consolidation never running on session shutdown: `MnemopiSessionState.dispose()` now drains pending fact extractions and runs `sleepAllSessions` on every owned bank before closing handles (and `AgentSession.dispose()` awaits the result), matching the `/memory enqueue` slash command. `mnemopiBackend.clear` opts out via `dispose({ consolidate: false })` so the destructive `/memory clear` path does not spend tokens consolidating memories that are wiped on the next line. `consolidate()` deliberately keeps no `aliasOf` short-circuit so `/memory enqueue` from a subagent still flushes and sleeps the parent's shared banks (the alias guard lives in `dispose` for lifecycle, not in `consolidate` for content). Without this, `episodic_memory`, `gists`, `consolidation_log`, `graph_edges`, and `triples` stayed empty for every deployment because the SHMR/beam pipeline only ran when a user typed `/memory enqueue|rebuild` ([#2320](https://github.com/can1357/oh-my-pi/issues/2320)).\n- Fixed multi-path `search` collapsing distinct scopes into one walk rooted at their unrequested common ancestor: `paths: [\".\", \"~/.gitconfig\"]` scanned the entire home directory (typically until the 30s grep timeout), and explicit file entries inside walker-pruned directories (e.g. `.git/config`, gitignored files) silently never matched because they were folded into the directory walk's glob union. Multi-path scopes now fan out into per-target scans when the common ancestor is not itself a requested path, plain-file entries are read directly as their own targets, and matches from overlapping targets are deduplicated.\n- Fixed `lsp.formatOnWrite` sending a hardcoded `tabSize: 3, insertSpaces: true` on every `textDocument/formatting` request, which silently re-indented 2-space YAML (and any LSP-formatted file) to 3-space on every write/edit through formatter-aware servers like `yaml-language-server`. Format options are now resolved per-file from `.editorconfig` (`indent_size`, `indent_style`, `tab_width`), falling back to the indent sniffed from the in-memory content the agent is about to write, then to a 2-space default. The duplicate `DEFAULT_FORMAT_OPTIONS` constant in `lsp/index.ts` and `lsp/clients/lsp-linter-client.ts` is replaced with a single shared `resolveFormatOptions` helper ([#2329](https://github.com/can1357/oh-my-pi/issues/2329)).\n\n## [15.11.2] - 2026-06-11\n\n### Added\n\n- Added the Expert Elixir language server (`expert`, invoked as `expert --stdio`) to the built-in LSP server list, auto-detected for Mix projects (`mix.exs`/`mix.lock`). When both are installed, `elixir-ls` remains the primary navigation server (Expert is ordered after it).\n- Added `magicKeywords.enabled` and per-keyword `magicKeywords.ultrathink`, `magicKeywords.orchestrate`, and `magicKeywords.workflow` settings to disable hidden magic-keyword notices and ultrathink auto-thinking escalation ([#1796](https://github.com/can1357/oh-my-pi/issues/1796)).\n- Added external-editor support for Plan Review section annotations, preserving multiline feedback for Refine plan ([#2305](https://github.com/can1357/oh-my-pi/issues/2305)).\n- Added plain-RPC slash command discovery with command source metadata and startup/update notifications ([#2261](https://github.com/can1357/oh-my-pi/issues/2261)).\n\n### Changed\n\n- Bash tool calls in one assistant message now run in parallel instead of serializing the batch: non-pty `bash` is scheduled as a shared tool (`pty: true` stays exclusive), and overlapping calls on the same shell session key degrade to isolated one-shot shells so they cannot queue behind or abort each other\n\n### Fixed\n\n- Fixed CDP attach target selection for Chromium/Edge endpoints that expose page targets through discovery before `browser.pages()` is populated, and improved `ws://` `app.cdp_url` diagnostics ([#2246](https://github.com/can1357/oh-my-pi/issues/2246)).\n- Fixed local memory consolidation on Responses-style models that reject user-only requests by sending a dedicated stage-two system prompt.\n- Fixed extension, custom-tool, custom-command, and hook loaders injecting `pi` through bare `@oh-my-pi/pi-coding-agent` self-imports, which could pull a different cached package version into global installs during plugin load and trigger mixed-runtime stack overflows.\n- Marked unsmoothed assistant streaming renders as transient so streamed code blocks can avoid synchronous syntax highlighting until the message finalizes.\n- Routed LSP hover code rendering through the shared cached highlighter instead of calling the native highlighter directly on each render.\n- Kept smooth assistant streaming renders transient until `message_end` so catch-up frames do not synchronously re-highlight still-growing code blocks.\n- Fixed the `job` tool's poll header repeating the running count (\"waiting on 19 of 19 19 running\"): the title now reads \"waiting on N jobs\" (or \"waiting on N of M jobs\" when some settled) and the dim meta lists only settled categories (done/failed/cancelled)\n- Fixed `irc` `send await:true` to a busy peer stranding the sender until timeout when async execution is disabled: the recipient (e.g. Main blocked in a synchronous task spawn awaiting the sender's own batch) can never reach a step boundary to reply, so it now generates an ephemeral side-channel auto-reply from its context (the pre-mailbox `respondAsBackground` behavior), records it as an `irc:autoreply` aside in its own history, and delivers it back over the bus with `replyTo` threading\n- Fixed Windows-style backslash paths and globs being parsed as literal POSIX path segments by search/find tools ([#2245](https://github.com/can1357/oh-my-pi/issues/2245)).\n\n## [15.11.1] - 2026-06-11\n\n### Added\n\n- Added the `statusLine.transparent` appearance setting (default off): when enabled, the status line skips the theme's `statusLineBg` fill and powerline end caps so the bar inherits the terminal's default background \u2014 useful in Ghostty and other terminals whose theme background does not match the theme's hardcoded status-line color ([#2306](https://github.com/can1357/oh-my-pi/issues/2306))\n\n### Changed\n\n- Changed `display.smoothStreaming` to animate streamed tool-call arguments (including write/edit/bash previews) at the smooth streaming cadence so partial tool input now appears progressively instead of in large jumps\n- Changed streamed updates for custom wire tools to render incremental raw input as `{ input }` prefixes for preview\n- `async.enabled` now defaults to `true`, keeping background task execution and async bash available out of the box; disable it to force blocking subtasks ([#2301](https://github.com/can1357/oh-my-pi/issues/2301)).\n- Shortened the status line's background-job indicator to a dedicated gear icon plus count (e.g. `\u2699 1` instead of `\ud83d\udc65 1 job running`) and moved it left of the session name in the right segment group\n\n### Fixed\n\n- Fixed the task tool's streaming call preview rendering the per-agent list above the shared context/assignment briefs: agent rows now render below them, matching the result layout, so the list no longer pushes the brief down as items stream in and then jumps below it once the first progress snapshot arrives\n- Fixed interrupted or ending tool calls to flush streamed argument previews to the full received payload instead of freezing on a partial reveal chunk\n- Fixed tool-argument reveal to avoid splitting UTF-16 surrogate pairs at frame boundaries\n- Fixed input lag in long sessions whenever a spinner was visible: loader ticks forced a full TUI re-compose (re-walking every transcript block) 12.5 times per second. Animations that only change their own rows (status loaders, welcome intro, voice mic glyph, `/btw` streaming panel) now use the new component-scoped render path (`TUI.requestComponentRender`), which reuses every other root subtree's rows; resize, overlays, inline images, forced repaints, root-list changes, or any concurrent full request still compose the full frame\n- Fixed transcript rendering so blocks with rows committed to scrollback while still streaming rerender on the first finalized frame, so the final committed output is visible instead of stale in-flight lines\n- Fixed committed transcript bypass logic to re-render finalized blocks when their version changes, so post-finalization updates like restored inline errors and late tool-result content now appear in scrollback\n- Cached stable edit/write preview highlighting inside each tool component so steady-state frame renders do not re-enter the native syntax highlighter.\n- Skipped rendering finalized transcript blocks whose rows are already committed to native scrollback, keeping long restored sessions from re-rendering historical tool blocks every frame.\n- Fixed MCP OAuth authorization and token requests to include the required `resource` indicator for the target MCP server.\n- Restored `async.enabled=false` as the task tool's blocking mode, so subagents no longer become background jobs when async execution is disabled ([#2301](https://github.com/can1357/oh-my-pi/issues/2301)).\n- Fixed the `/tree` selector and HTML session export dropping the inherited `\u2502` gutter for chain rows under a last-sibling branch, so the conversation flow under a `\u2514\u2500` branch stays visually anchored to its parent message ([#2298](https://github.com/can1357/oh-my-pi/issues/2298)).\n- Fixed Anthropic web search requests to include `metadata.user_id`, matching the main Messages path: API-key requests forward the active session id verbatim, OAuth requests build the Claude-Code-shaped `{session_id, account_uuid?, device_id}` JSON envelope so gateways see consistent attribution ([#2295](https://github.com/can1357/oh-my-pi/issues/2295)).\n- Fixed Anthropic classifier refusals to switch through configured retry fallback chains without same-model retries, and to keep the fallback pinned for the conversation. ([#2290](https://github.com/can1357/oh-my-pi/issues/2290))\n- Fixed the edit-tool hashline prompt to stop steering agents toward `insert after block N:` on closing delimiter lines; opener-only block anchors now point visible closing-line insertions to plain `insert after M:`. ([#2292](https://github.com/can1357/oh-my-pi/issues/2292))\n\n## [15.11.0] - 2026-06-10\n\n### Breaking Changes\n\n- Removed the `resume` option from the `task` tool API and its resume execution path; continue work on finished subagents by sending follow-up messages via `irc` instead\n- Removed the `irc.enabled` setting: irc availability is now derived \u2014 the tool exists exactly when there is someone to message (the session can spawn subagents through `task`, or it is a subagent itself). A stale `irc.enabled` key in config is ignored\n- The `task` tool was reworked to always run spawns in the background as independent, persistent agents: results arrive as async job deliveries (block with `job poll` only when genuinely needed). The wire schema is now shape-swapped by the new `task.batch` setting (default on): `{ agent, context, tasks[] }` \u2014 one subagent per task item, per-item `isolated`, and a required shared `context` \u2014 or, when disabled, a flat single-spawn shape `{ agent, id?, description?, assignment, isolated? }` with shared background passed via `local://` files instead\n- Removed the `task.simple` setting and the task tool's per-call `schema` parameter outright: structured subagent output now comes only from the agent definition's `output` frontmatter or the inherited session schema, and ad-hoc structured workflows use eval `agent(prompt, schema)`. A stale `task.simple` key in config is migrated away\n- Reworked `irc` to `send`/`wait`/`inbox`/`list` ops over a per-agent mailbox bus: the blocking `awaitReply` auto-reply turn is removed \u2014 `send` is fire-and-forget with delivery receipts, and replies are real turns by the recipient observed via `wait` (or the `send` `await: true` sugar)\n- Removed the `context` argument from eval `agent()` in both the JS and Python preludes: pass shared background via a `local://` file referenced in the prompt\n- Replaced the standalone session-observer overlay with the Agent Hub: `app.session.observe` (`ctrl+s`) now opens the hub, whose chat view absorbed the observer's transcript renderer\n\n### Added\n\n- Snapcompact compaction now passes the session model so frames render in the provider-optimal shape (unscii `8x8r-bw` for Anthropic-family/unknown APIs, `8x8r-sent` for Google, Lanczos-stretched `6x6u-sent` with `detail: \"original\"` for OpenAI), per the snapcompact 200k-token evals\n- Added per-turn supersede pruning of stale `read` results: when a file is re-read, older copies of the same path/selector are pruned from context at cache-favorable moments (small suffix, idle gap, or alongside overflow pruning). Gated by the new `compaction.supersedeReads` setting (default on)\n- Added soft request budgets for task subagents (explore/quick_task 40, others 90, configurable via `task.softRequestBudget`, 0 disables): crossing the budget injects a one-time wrap-up steer into the child; crossing 1.5\u00d7 aborts the run gracefully\n- Added cancelled/aborted subagent salvage: instead of `(no output)`, merged task results now carry the child's last activity snippet plus request/token stats, and per-child stats lines include request counts\n- Added a repeat-read notice to the `read` tool: the third and later reads of the same file in a session append a one-line note suggesting range re-reads or the context echoed in edit results\n- Added a hard inline byte cap (~50KB) at the bash and browser tool-result boundaries with head/tail elision and an `artifact://` footer for the full output, closing paths that previously let 100KB+ results land inline\n- Added the Agent Hub overlay (`ctrl+s`, `alt+a`, or double-tap left arrow on an empty editor): a live table of registered subagents (status, unread IRC count, current task, last activity) with per-agent chat \u2014 Enter opens a transcript + input line that steers a running agent, prompts an idle one, and revives a parked one; `r` revives and `x` aborts/releases the selected agent\n- Added the `snapcompact` compaction strategy (`compaction.strategy: \"snapcompact\"`): history is archived onto dense bitmap \"snapcompact\" frames a vision model reads back directly, instead of an LLM-generated summary \u2014 instant, free, and verbatim. Auto compaction (including overflow recovery) and manual `/compact` both honor it; falls back to context-full with a visible warning notice when the current model is text-only (e.g. Codex API surfaces) or when `/compact` is given custom instructions. Frames survive context rebuilds and later compactions (budget eviction is middle-out: the session-head frame is pinned); the expanded compaction message notes the attached frame count\n- Added a persistent subagent lifecycle: finished subagents stay live as `idle`, are parked to disk after `task.agentIdleTtlMs` (default 7 minutes; `0` keeps them live until exit), and are revived automatically when messaged or prompted from the Agent Hub\n- Added the `history://` protocol: `history://` lists every registered agent and `history://` renders a concise markdown transcript (tool calls collapsed to one line each, thinking elided) for live and parked agents alike\n- Added an IRC mailbox bus with bounded per-agent inboxes: `irc` `wait` blocks until a matching message arrives, `inbox` drains or peeks pending messages, and sending to an idle or parked agent wakes or revives it for a real turn\n- Added a dedicated TUI renderer for the `irc` tool: directional send/receive headers with delivery-outcome coloring, quoted message bodies with expand-aware truncation, per-recipient receipt trees for broadcasts and failures, and status-badged peer listings with unread counts\n- Added the `task.batch` setting (default on): the task tool's batch shape `{ agent, context, tasks[] }` spawns one subagent per item \u2014 each its own independent background job with the normal idle/parked lifecycle and optional per-item isolation \u2014 and prepends the required shared `context` to every spawned subagent's system prompt; disabling it restores the flat single-spawn schema\n\n### Changed\n\n- Changed task-tool sync execution to fan out multiple `tasks[]` items in parallel and return a merged result payload when no async job manager is available\n- Changed the compaction UX so the conversation no longer visually restarts: the TUI renders the full-history display transcript (`buildSessionContext({ transcript: true })`), with each compaction shown as a slim inline divider \u2014 `\u2500\u2500 \ud83d\udcf7 compacted \u00b7 ctrl+o \u2500\u2500` \u2014 at the point it fired; expanding (ctrl+o) reveals the summary and snapcompact frame count. Applies to live compaction, `/compact`, `/tree` navigation, and session resume\n- Changed `async.enabled` to gate async bash commands only \u2014 the `task` tool now runs asynchronously regardless of the setting\n- Changed `irc.timeoutMs` to be the default timeout for `irc` `wait` and `send` with `await: true`\n- Moved the grouped path-tree helpers (`buildPathTree`, `walkPathTree`, find's grouped output formatter \u2014 now `formatGroupedPaths`) to `@oh-my-pi/pi-utils` so compaction summaries can render file lists with the same prefix-folded tree as find/search; `tools/find` no longer exports `formatFindGroupedOutput`\n- Changed TTSR rule notifications to combine rules into one block: a multi-rule match renders `name: description` rows (collapsed view caps at 4 rules with a `+N more` hint, ctrl+o expands), and consecutive notifications merge into the previous block while it is still the live transcript tail\n\n### Removed\n\n- Removed the pre-initialization startup splash and input buffer, so commands typed during launch are no longer queued and are handled only after the interactive TUI initializes\n\n### Fixed\n\n- Fixed `irc` live message delivery so successfully handed-off messages are no longer enqueued as mailbox mail, so they do not inflate unread `irc` counts\n- Fixed `irc send` with `await: true` to wait for a fresh reply to the current call instead of consuming previously buffered messages\n- Fixed main-session chat output to stop duplicating outbound `irc` sends from the main agent as relay cards\n- Fixed task-tool runtime compatibility so legacy flat `task` calls (`agent`, `assignment`) still execute under `task.batch` even though the wire schema is batch-first\n- Fixed the `job` tool's TUI preview leaking the model-facing `` envelope for settled task jobs \u2014 the preview now shows the inner output body, and pretty-printed JSON bodies are flattened onto one line instead of previewing a lone `{`\n- Fixed npm CLI distribution bundles by embedding the stats dashboard client bundle so dashboard assets are served in prebuilt installs\n- Fixed the `resolve` tool's result block turning white after the leading icon: the accent-styled symbol embedded a foreground reset inside the inverse-rendered line, dropping the block color for the rest of the row\n- Fixed the CLI smoke-test command to start the stats server and verify dashboard HTML is served, catching bundled-asset regressions\n- Added verification of a `\n` and `index.js` in smoke-test dashboard responses\n- Restored the checkmark glyph on ask-tool custom answers and the multi-select \"Done selecting\" option, which a status-glyph sweep had swapped for the ask tool icon\n- Fixed the `thinking.autoPending` statusbar indicator using question-mark glyphs (`\u25a3?`, nf-md-help_box, `[?]`) in every symbol preset, which made the auto-thinking pending state indistinguishable from a terminal missing-glyph fallback. Replaced with clear loading indicators (`\u27f3`, fa-circle-o-notch, `[~]`) ([#2267](https://github.com/can1357/oh-my-pi/issues/2267)).\n- Fixed `tab.screenshot({ save })` ignoring the save path's extension: an explicit `.webp`/`.jpg` destination received hardcoded PNG bytes behind a mismatched name. The full-res capture format is now derived from the save path (`png`/`jpeg`/`webp`, puppeteer-native), and the reported mime type follows the bytes actually written; unknown or missing extensions still capture PNG\n- Fixed an infinite `compaction.strategy: shake` auto-continue loop in thinking-heavy sessions: the post-shake check now uses the provider-anchored trigger metric (instead of a local estimate that undercounts `thinkingSignature` payloads) and only treats pressure as resolved when residual context lands inside an 80% recovery band, so shake reliably falls back to context-full compaction when it cannot create real headroom ([#2275](https://github.com/can1357/oh-my-pi/issues/2275)).\n\n## [15.10.12] - 2026-06-10\n\n### Added\n\n- Added RPC subagent subscription frames, snapshots, and transcript catch-up APIs for desktop clients embedding `omp --mode rpc`.\n- Added opt-in `shellMinimizer.sourceOutlineLevel` and `shellMinimizer.legacyFilters` settings so shell minimization can tune source outlining and selectively fall back to conservative legacy routing.\n- Added repeatable `--config ` CLI overlays for temporary `config.yml`-style settings without editing the persistent global config ([#1733](https://github.com/can1357/oh-my-pi/issues/1733)).\n- Added `python.interpreter` to pin eval's Python backend to an explicit interpreter and skip automatic runtime discovery ([#1802](https://github.com/can1357/oh-my-pi/issues/1802)).\n- Added `!command` resolution for `models.yml` provider `apiKey` values and provider/model headers ([#1888](https://github.com/can1357/oh-my-pi/issues/1888)).\n- Documented the oMLX setup path through existing OpenAI-compatible local discovery ([#1957](https://github.com/can1357/oh-my-pi/issues/1957)).\n- Added `TITLE_SYSTEM.md` discovery so users can override the automatic session-title generation prompt for online and local tiny title models without patching installed prompt files. The override is re-discovered when the session working directory changes via `/cwd`.\n- Added a structured memory runtime surface for extensions and UI integrations to query backend status, search memories, and save explicit memories across the configured memory backend.\n- Added support for Git repositories using the `reftable` storage format by detecting `extensions.refStorage = reftable` in the repository configuration and falling back to shelling out to Git commands (`git symbolic-ref`, `git rev-parse`) for reference and HEAD resolution.\n- Added `/setup providers` (also available as `/setup` or `/providers`) to reopen the interactive provider setup scene from an active TUI session, letting users sign in and choose a web search provider without rerunning the full onboarding flow.\n\n### Changed\n\n- Bash execution now preserves minimized shell output inline while saving the untouched capture as an `artifact://\u2026` footer when shell minimization rewrites a command's output.\n- Task tool live progress now renders finished subagents first and keeps unfinished (pending/running) ones pinned at the bottom of the list.\n- `OutputSink` artifact files (`~/.omp/agent/artifacts/..log`) are unbounded by default again, so `artifact://` references preserve the complete raw stream. The head + rolling-tail capping machinery from [#2081](https://github.com/can1357/oh-my-pi/issues/2081) (with its `[ARTIFACT TRUNCATED: \u2026]` close notice) remains available as an opt-in via `artifactMaxBytes`, and the head window now closes permanently on first overflow so later small chunks cannot be written out of order before the tail replay.\n\n### Fixed\n\n- Fixed Ollama chat turns using the `:off` thinking selector so requests explicitly send reasoning disablement instead of falling back to the provider default ([#2239](https://github.com/can1357/oh-my-pi/issues/2239)).\n- Fixed long-running sessions becoming sluggish because the status line recomputed context usage by walking the full message history on every refresh. Message-token totals are now cached incrementally, and status lines that do not render context segments skip context accounting entirely. ([#2089](https://github.com/can1357/oh-my-pi/issues/2089))\n- Fixed extension-registered slash commands being allowed to shadow builtin command names in the ACP/RPC command list: both the TUI and `getSessionSlashCommands()` now filter against the shared builtin reserved-name registry.\n- Fixed ACP turns for extension slash commands finishing before nested `pi.sendUserMessage()` prompts ran: the turn now drains scheduled extension prompts and prompt-event handlers before reporting `end_turn`, and prompts queued on a closed or disposed session fail fast with an `ACP_SESSION_CLOSED` error instead of running against a dead session.\n- Fixed hide-secrets placeholders leaking into ephemeral side-channel turns (IRC replies, summary prompts): streamed text deltas are now deobfuscated before emission (withheld while a partial placeholder is still streaming) and the final assistant message is deobfuscated before reuse. Provider-context obfuscation moved into the agent loop's `transformProviderContext` hook so request telemetry also captures the redacted context ([#2146](https://github.com/can1357/oh-my-pi/issues/2146)).\n- Fixed a failed `Settings.init()` permanently poisoning subsequent initialization: the cached init promise is now cleared on error so a retry can succeed.\n- Fixed exiting plan mode without confirmation only when neither the default plan file nor slug-named local plan files contain draft content ([#2024](https://github.com/can1357/oh-my-pi/issues/2024)).\n- Fixed `enabledModels` being ignored by the ACP model picker (Zed and other ACP clients) \u2014 `AgentSession.getAvailableModels()` now applies the configured allow-list, so only the models listed in `enabledModels` appear in the UI. Also applies consistently to the RPC `get_available_models` endpoint and the `/model` slash command. Glob selectors (`anthropic/*`), provider-scoped fuzzy patterns, and substring selectors now resolve in this synchronous path too, using the same scope semantics as startup resolution instead of being skipped with a warning.\n- ACP sessions now skip the client permission gate for bash/edit/delete/move when the user explicitly opts into yolo approval mode (`--yolo`/`--auto-approve` or a configured `tools.approvalMode: yolo`) and the effective per-tool policy is \"allow\"; default-config sessions keep the gate ([#2097](https://github.com/can1357/oh-my-pi/pull/2097) by [@Mokto](https://github.com/Mokto))\n- Fixed hidden thinking blocks leaving placeholder `Thinking...` lines in the transcript ([#2068](https://github.com/can1357/oh-my-pi/issues/2068)).\n- Fixed Hindsight `per-project-tagged` scoping siloing retains/recalls per linked git worktree: `projectLabel()` now resolves the primary checkout root (or shared bare-repo common dir) via the new sync `git.repo.primaryRootSync` helper, so every worktree of one repo shares the same `project:` tag and `per-project` bank id ([#2232](https://github.com/can1357/oh-my-pi/issues/2232)).\n- Fixed MCP OAuth flows accepting pasted redirect URLs or authorization codes through `/login` in headless environments ([#2122](https://github.com/can1357/oh-my-pi/issues/2122)).\n- Forwarded model ids through `ModelRegistry` API-key resolvers and Antigravity usage-limit rotation so `pi-ai` can apply model-family-scoped OAuth quota backoff instead of treating all `google-antigravity` counters as credential-wide. ([#2198](https://github.com/can1357/oh-my-pi/issues/2198))\n- Fixed bare `omp extensions` being treated as a chat prompt instead of returning an actionable plugin-command error ([#2089](https://github.com/can1357/oh-my-pi/issues/2089)).\n- Fixed hide-secrets redaction so configured secrets are scrubbed from provider-facing system prompts, tool definitions, developer/system-reminder messages, and assistant tool-call arguments before model requests ([#2146](https://github.com/can1357/oh-my-pi/issues/2146)).\n- Fixed subagents looping indefinitely on byte-identical no-op `edit` calls. The hashline executor previously surfaced a soft \"your body row(s) are byte-identical to the file\" hint that some models ignored; one captured session emitted 182 such repeats in 205 calls over 16 minutes before the user aborted. A new per-`ToolSession` `noopLoopGuard` now tracks consecutive identical no-op payloads per canonical path and escalates to a thrown `ToolError` after `NOOP_HARD_LIMIT` (3) repeats, so the agent loop sees a tool *failure* and breaks the cycle ([#2081](https://github.com/can1357/oh-my-pi/issues/2081)).\n- Fixed the bash result renderer recomputing styled output (`split` / `replaceTabs` / `truncateToVisualLines`) on every TUI repaint, which scaled with both transcript length and per-row output size. With a long captured session every keystroke walked hundreds of bash rows; the reporter on issue #2081 observed Ctrl+X/Ctrl+C feeling unresponsive because the main thread was pinned re-styling scrollback. The result renderer now caches its produced lines keyed by `(width, previewLines, expanded, rawOutput, isPartial)`, mirroring the existing eval-renderer cache; `invalidate()` clears the cache as before. Hot-path repaints with unchanged inputs are now O(1) ([#2081](https://github.com/can1357/oh-my-pi/issues/2081)).\n- Fixed ACP `available_commands_update` to include extension-registered slash commands so clients like Zed surface them in the slash-command palette.\n- Fixed ACP cancel button leaving the session in a stuck state \u2014 a new prompt sent while a turn is still in-flight (e.g. immediately after pressing Stop in Zed before `session/cancel` is processed) now implicitly cancels the running turn and queues the new message, instead of throwing an error that blocks further interaction.\n- Fixed interactive `!`/`!!` shell shortcuts to run non-bash commands through the configured user shell, including interactive startup for zsh/fish aliases and functions ([#1816](https://github.com/can1357/oh-my-pi/issues/1816)).\n\n## [15.10.11] - 2026-06-10\n\n### Added\n\n- Added `supportsReasoningParams`, `alwaysSendMaxTokens`, `strictResponsesPairing`, and a recursive `whenThinking` overlay (alongside `streamIdleTimeoutMs`/`supportsLongPromptCacheRetention`/`requiresToolResultId`/`replayUnsignedThinking`) to the OpenAI/Anthropic `compat` schema so custom model entries can configure those provider-specific capabilities\n- Custom model `thinking` config now uses the catalog's explicit vocabulary: `efforts` (ordered list) plus optional `defaultLevel`, `effortMap`, and `supportsDisplay` overrides; the legacy `minLevel`/`maxLevel`/`levels` range shape is still accepted and normalized at parse time. Wire facts (`effortMap`/`supportsDisplay`) are backfilled from model identity when not set, so existing claude-proxy configs keep the 5-tier adaptive scale and summarized display without changes.\n- New `omp usage` command: a detailed per-account breakdown of provider usage limits (bars, windows, reset times, plan metadata) covering every stored credential \u2014 accounts with no usage endpoint are listed as \"no usage data\" rows. Each provider section ends with per-window capacity stats (\"capacity: 5h \u2192 2.40/5 accounts used (2.60\u00d7 quota left)\"). Flags: `--provider` to filter, `--json` for the broker-shaped report payload, and `--redact` to mask account emails/ids down to a two-char anchor plus a minimal middle-out differentiator (`ca*9*`) for screenshot-safe sharing.\n- Startup hangs are now self-diagnosing (speculative fix for the \"zero output, hangs even on `omp -h`\" report class): a watchdog prints a stderr line every 10s naming the deepest in-flight startup phase (via `logger.openSpanPath()`) until a mode runner takes over, pausing around legitimate interactive waits (fork/move prompts, the `--resume` session picker); `PI_DEBUG_STARTUP` is restored as streaming synchronous `[startup]` phase markers covering command-module imports and the native addon load, which the post-startup `PI_TIMING` tree structurally cannot show for a hang; and waiting on piped-stdin EOF announces itself after 1s instead of blocking silently.\n- npm installs now execute a prebundled single-file entry: the published `bin.omp` points at `dist/cli.js` (built by `scripts/bundle-dist.ts` during `prepack`, ~18MB minified, natives/transformers/mupdf external), cutting npm-install cold start by roughly 3x versus transpiling the raw TypeScript graph per launch; `src/**` stays published for SDK consumers and worker fallbacks. The on-repo manifest keeps `bin.omp` at `src/cli.ts` \u2014 release rewrites it via the `publishBin` override in `scripts/ci-release-publish.ts` \u2014 so source installs (`bun link`, `install.sh --source`) keep working without a build step\n- Plain interactive TTY launches render the full welcome box (logo held on the intro's first frame, model, tips, LSP servers, recent-sessions loading placeholder) before session construction, clearing the screen so the TUI's first paint replaces it in place; the welcome box now reserves fixed slot counts (4 recent sessions, 4 LSP servers) so its height no longer shifts between the splash, loading, and loaded states. First-run launches keep the dim two-line splash (`omp ` / `Initializing session\u2026`); resume/fork/continue flows, quiet mode, `PI_TIMING`, and non-TTY stdio still skip it\n- Added `/stats` to launch the local stats dashboard from an active session, syncing session files first and opening the same browser dashboard as `omp stats`.\n- `/settings` now supports type-to-search filtering on setting labels, paths, descriptions, and values; Escape clears an active search before closing the panel.\n- Added a read-only `view` op to the `todo` tool that echoes the current list without mutating state, so the agent can recover exact task text instead of guessing it from memory.\n\n### Changed\n\n- Centralized model-identity logic in the new `@oh-my-pi/pi-catalog` package: `config/model-equivalence.ts`, `config/model-id-affixes.ts`, and `config/model-provider-priority.ts` were removed in favor of `@oh-my-pi/pi-catalog/identity`, and the registry's proxy-reference lookup now shares the catalog's single lazily-built bundled-model walk (`@oh-my-pi/pi-catalog/identity` bundled accessors) with the canonical-equivalence index instead of walking the ~12K bundled models twice into duplicate maps\n- Split the configured/implicit provider discovery protocols (Ollama, llama.cpp, LM Studio, openai-models-list, proxy) out of `config/model-registry.ts` into `config/model-discovery.ts`; the registry keeps orchestration (caching, status tracking, merging) while the protocol clients take an injected fetch/auth context\n- Catalog *values* (bundled models, `modelsAreEqual`, `clampThinkingLevelForModel`, `getSupportedEfforts`, `DEFAULT_MODEL_PER_PROVIDER`, Gemini/Antigravity wire headers) are now imported from `@oh-my-pi/pi-catalog/` instead of the `@oh-my-pi/pi-ai` barrel, which no longer re-exports them; the resolver's `defaultModelPerProvider` alias was removed and its duplicated default-model fallback / scoped-model dedupe blocks were factored into `pickDefaultAvailableModel` and a shared `addScopedModel` helper\n- Cached custom model alias maps and built them lazily on first custom model reference lookup, avoiding unnecessary startup model-registry initialization\n- Cached resolved auth broker configuration and snapshot reads for the process lifetime so repeated startup paths reuse the same `OMP_AUTH_BROKER_*` resolution instead of re-running config/token discovery\n- Reused task-agent discovery results for repeated `TaskTool.create` calls in the same working directory to avoid repeated plugin scans during subagent startup\n- SSH tool creation now formats host descriptions from synchronous host-info cache reads (memory hit or cached JSON) instead of per-host async reads \u2014 hosts without cached info render the existing placeholder; warm-cache descriptions are byte-identical\n- Deferred heavy dependencies off the startup import graph to first feature use: `linkedom` (web fetch feed parsing and scrapers), `puppeteer-core`/`@puppeteer/browsers` (browser launch), `@mozilla/readability` (page extraction), `@xterm/headless` (interactive bash PTY), `@babel/parser` (JS eval import rewriting), and the mnemopi memory engine (backend/state construction)\n- Renamed the `PI_TIMING` startup phase `discoverModels` to `discoverAuthStorage` \u2014 the timer only ever wrapped auth storage discovery\n- Worker threads (stats sync, browser tab, JS eval) and the tiny-model subprocess now re-enter the CLI entrypoint with hidden argv selectors (`__omp_*`, `--tiny-worker`) via the declared worker-host entry (`workerHostEntry()`), collapsing the per-distribution spawn branches; outside a CLI host (bun test, SDK embedding) spawn sites fall back to loading the worker module directly, and both binary build scripts dropped their per-worker `--compile` entrypoint lists\n- The CLI entry no longer top-level-awaits `runCli` \u2014 the floating call reports rejections to stderr and exits 1, keeping the entry module CJS-lowerable and the bundle parse-friendly\n- Tightened the system prompt and tool prompts: deduped restated warnings (bash \"catch yourself\" list, search/find shell-fallback recaps, read instruction/critical overlap, the AST metavariable primer duplicated across both ast tool descriptions), factored the repeated repo-default clause in the `gh` search ops, dropped a dead `rsed` reference and an internal `tool-timeouts.ts` pointer, and pruned internal mechanism the agent can't act on (screenshot temp-file/downscaling pipeline, browser spawn lifecycle, `gh` \"replaces former op\" history and run-watch grace period, output-minimizer heuristics, BM25 ranking name, `task.maxConcurrency` pointer)\n- Extended the prompt-efficiency pass to the full prompt surface (subagent/plan-mode/notice/title/commit system prompts, agent definitions, goals, memories, review and autoresearch prompts): RFC-keyed prescriptive prose, fixed garbled grammar and a stale `` placeholder in the plan-approval reminder, deduped intra-file restatements, and corrected the `todo` op table's claim that `rm` requires a `task`/`phase` (bare `rm` clears the whole list)\n- Replace tool prompt no longer recommends `sed -i`/`cat`-heredoc commands that the bash interceptor blocks; its bash-alternatives table now only lists non-intercepted commands\n- Capped concurrent IRC cards in the transcript's live region at 4: cards landing below a still-running tool cannot commit to native scrollback, so an unbounded burst pushed the live block's uncommitted rows above the window top (content read as cut off until the cards expired). The oldest live-region card now retires as soon as a new one would exceed the cap.\n- Interactive PTY mode (`pty: true`) no longer injects the non-interactive environment (`TERM=dumb`, `GIT_EDITOR=true`, `PAGER=cat`, `NO_COLOR=1`) that defeated its purpose \u2014 the PTY child now gets a real `TERM=xterm-256color`; and when a PTY is requested but unavailable (headless/RPC), the result now carries an explicit downgrade notice instead of silently running through a dumb pipe.\n- Raw sqlite `?q=` queries are now capped at 1000 rows with an \"add a LIMIT clause\" notice \u2014 `statement.all()` on a multi-million-row table previously materialized every row, blocking the process for minutes.\n- Plain-file range reads no longer scan to EOF on files over 4MB just to count total lines (the count is reported as approximate), and multi-range reads slice from a single pass instead of re-streaming the file once per range.\n- `gh run_watch` now polls adaptively (3s for the first minute, then 15s), survives rate-limit errors with backoff instead of dying and discarding accumulated context, reuses job data for completed runs, and gives up with a clear message after ~90s when a commit has no workflow runs at all (previously an infinite 3-second poll loop).\n- The legacy patch-mode fuzzy matcher pre-normalizes file and pattern lines once per seek with a Levenshtein lower-bound bail, replacing the per-position re-normalization that made a single mismatched hunk against a 10k-line file cost multi-second synchronous stalls; the streaming hashline preview also caches file text and tree-sitter block resolution across ticks instead of re-reading and re-parsing every target file per streamed chunk.\n- The DAP client reader now uses chunk-list buffering and the output buffer is a chunk deque with a running byte count \u2014 debugging a chatty program previously cost O(n\u00b2) `Buffer.concat` per chunk plus whole-buffer byte-scans per 1KB trim, freezing the session.\n- GitHub caching: the per-lookup auth key is memoized against `hosts.yml` mtime (was a blocking `readFileSync` on every `issue://`/`pr://` read including cache hits), background refreshes are deduped by row identity, and PR diffs are stored once per row instead of twice (unified + rendered copies).\n- Task progress snapshots shallow-copy per-agent progress instead of `structuredClone`-ing nested tool payloads (up to 500KB) on every progress event; streaming assistant-message reveal caches per-block grapheme counts and skips the markdown render LRU for in-flight partials, eliminating 2-3 full Intl.Segmenter walks per 33ms tick and tens of MB of retained stale partial snapshots on long replies.\n- Python eval cells: the availability probe is cached per cwd (was two interpreter spawns per cell even with a hot kernel), and stdout frames coalesce per write instead of one locked+flushed JSON frame each.\n- Multi-entry edits now stop at the first failing entry and report exactly which entries were applied and which were not \u2014 continuing after a failure applied later entries authored against line numbers that assumed the failed entry succeeded, and a retry of the whole batch then double-applied the survivors.\n- Decomposed `config/model-registry.ts` further: model roles (`MODEL_ROLES`, `getRoleInfo`, `getKnownRoleIds`) moved to `config/model-roles.ts`, the `models.json` config handle and provider validation moved to `config/models-config.ts`, the two provider+id merge scaffolds collapsed into one `mergeByModelKey` helper, the four ~15-field override/overlay enumerations now share a `ModelPatch` type applied by a single `applyModelPatch(base, patch, transport)` core (the `merge` vs `replace` transport policies preserve the same-id custom-definition replacement semantics), and canonical-variant selection delegates to `@oh-my-pi/pi-catalog/identity`'s new `resolveCanonicalVariant`\n- Resolver cleanup: five duplicated trailing-`:level` suffix parses collapsed into `splitThinkingSuffix`, the matching engine is now the documented `matchModel` core with the selector grammar and entry points layered on top, and `resolveCliModel`'s hand-rolled decomposed provider/id lookup reuses `findExactModelReferenceMatch`; runtime discovery tests split out of `test/model-registry.test.ts` into `test/model-discovery.test.ts`\n- `TranscriptContainer` assembles the transcript incrementally: each block's render is reference-compared and its stripped contribution, separator, and row placement are reused when unchanged, with the persistent row array truncated and re-pushed only from the first divergent block; the leading byte-identical row count is reported to the renderer through pi-tui's new `RenderStablePrefix` seam so off-screen transcript rows are no longer re-rendered, re-prepared, or re-audited every frame. Block components became reference-stable to make this effective: `UserMessageComponent` memoizes its OSC 133 zone wrapping, `WelcomeComponent` and `DynamicBorder` cache their renders, and dashboards copy before padding (render results are `readonly` under the new pi-tui contract)\n- A live block whose trailing row grows in place as a visible prefix (token streaming into the cursor line) is now commit-safe through its full body instead of being held back by the volatile-tail margin \u2014 the growing row itself is the block's last and can never commit while it remains last, so a streaming reply's scrolled-off head reaches native scrollback (tmux pane history) mid-stream\n- Rewrote the bash tool's coreutils guidance (tool prompt and system prompt) around an explicit litmus: pipelines that compute a new fact (`wc -l`, `sort | uniq -c`, `comm`, `diff`) are legitimate bash, while commands that merely move, page, or trim bytes a dedicated tool can fetch remain banned \u2014 output trimming destroys data the `artifact://` capture would have saved.\n- Default API auto-retries now use 10 attempts with a 500ms Anthropic-style exponential backoff capped at 8s with jitter, so transient 502/gateway failures get a longer retry budget without multi-minute local sleeps.\n\n### Fixed\n\n- Fixed `ask` question/result renders so option and answer rows are no longer duplicated when the component is re-rendered\n- Fixed streaming `write`/`diff` previews to keep line-number gutter widths stable while content grows, preventing already-rendered preview rows from being reflowed mid-stream\n- Fixed the welcome screen showing \"No LSP servers\" when `lsp.lazy` is enabled: recognized servers are now still discovered at startup and listed with a dim \"available\" dot (no warmup), and `/status` reports them as `available` instead of omitting the section\n- Fixed edit-tool diffs stacking adjacent `...` markers around inserted block-context rows (each row added its own gap markers from a snapshot of the diff, so neighboring insertions doubled them, and a marker could be left stranded between contiguous lines): non-contiguous regions are now separated by a single blank row, normalized after insertion, and rendered as one dim `\u2026` in the TUI and HTML export\n- Fixed an uncaught `questions.map is not a function` TUI crash in the ask tool's call renderer when a model double-encoded the `questions` array as a JSON string (a bare string passes a truthy `.length` check but has no `.map`): the renderer now normalizes untrusted call args \u2014 parsing double-encoded `questions`, dropping malformed entries/options, and falling back to the \"No question provided\" frame instead of throwing\n- Fixed direct `modelRoles` consumers so comma-separated fallback chains are split before model parsing, preserving explicit thinking selectors instead of treating the comma tail as an invalid suffix.\n- Fixed model-provider detection for append-only mode, authoritative Vertex endpoint checks, and upstream-routing selection by switching from URL substring checks to catalog host-matching helpers\n- Fixed pasting into the ask tool's \"Other (type your own)\" text box (and hook input/editor dialogs) on terminals with OSC 5522 enhanced paste (kitty protocol): the enhanced-paste focus routing only targets components exposing a `pasteText` hook, and the dialog wrappers had none, so the payload was stuffed into the main prompt editor hidden behind the dialog. `HookEditorComponent` and `HookInputComponent` now forward `pasteText` to their inner editor/input (pasting also resets the input dialog's timeout countdown like any keystroke).\n- Fixed auto-retry giving up after one attempt (\"Provider requested Xms wait, exceeds retry.maxDelayMs\") on a usage-limit 429 when every sibling account was only momentarily blocked: the retry delay now waits for the earliest sibling unblock when that comes sooner than the provider's multi-hour retry-after, so the next attempt picks up the recovered account instead of failing fast.\n- Fixed Hindsight `per-project-tagged` mental-model seeding so each project gets its own conventions/decisions models and session context only injects active-project or untagged models ([#2218](https://github.com/can1357/oh-my-pi/issues/2218)).\n- Fixed Windows stdio MCP `.cmd` commands by wrapping batch shims with `cmd.exe /d /s /c` using the outer command quotes required by `cmd /s`, while preserving literal `%` and quoted JSON arguments for Codegraph MCP ([#2220](https://github.com/can1357/oh-my-pi/issues/2220)).\n- Fixed the bundled `explore` agent's `thinking-level: med` frontmatter \u2014 not a valid effort (`minimal`/`low`/`medium`/`high`/`xhigh`), so it silently parsed to undefined and the agent ran without its intended thinking level\n- Discovery context-file reads (`~/.claude`, `~/.cursor`, project trees, `@`-imports) now stat-gate to regular files before reading: a FIFO/socket/char device dropped where a context file is expected previously blocked startup forever on a read that can never see EOF.\n- Fixed the read tool's provider-visible `path` schema and docs so web URLs and internal URI targets (`omp://`, `issue://`, `pr://`, etc.) are advertised alongside local files ([#2215](https://github.com/can1357/oh-my-pi/issues/2215)).\n- Kept IRC cards from being removed after their TTL once everything above them finalized: their rows may already be committed to native scrollback, and removing them was an interior deletion of the committed prefix that the engine could only repair by recommitting everything below the gap (duplicated blocks). Such cards now stay in the transcript as durable history.\n- Fixed the recommit storm that sprayed stale snapshots of a running task's progress tree into native scrollback. The stable-prefix ratchet promoted any row quiet for one 30-frame window, so slowly ticking rows (per-agent tool/cost counters updating every few seconds) were repeatedly promoted, committed, rewritten, and recommitted by the engine audit for the whole run. The ratchet now floors itself permanently at the first row that mutates after being promoted \u2014 settled heads (a task's prompt/context) still reach scrollback, genuine tickers never re-promote.\n- **Fixed the artifact spill dropping the first ~20KB of output**: head-retained bytes were never written to the artifact file, so for every bash/eval/ssh command exceeding the 50KB spill threshold, the `artifact://` advertised as the \"full capture\" was permanently missing its head \u2014 the agent re-reading it got truncated data presented as lossless.\n- Fixed streaming-output chunk throttling dropping chunks instead of coalescing them: streaming previews and the auto-background \"output so far\" text the model reasons over contained output with arbitrary middles silently spliced out.\n- **Fixed `vault://` writes bypassing both the approval ladder and plan mode**: internal-URL writes were uniformly rated tier `read` (auto-allowed even in always-ask) and the internal-router branch returned before the plan-mode guard, so the model could silently overwrite real Obsidian notes; writes through schemes with a mutating handler are now tier `write` and plan-mode-enforced.\n- Fixed writes into `.tar.gz`/`.tgz` archives silently stripping gzip compression (the rewritten archive was a bare tar under the `.gz` name \u2014 masked on re-read because Bun auto-detects, broken for `tar xzf`/CI consumers), and made archive rewrites atomic via temp-file + rename so a crash mid-write can no longer destroy every other member; symlinked archive paths resolve to their target before the swap so the rename writes through instead of replacing the link with a regular file.\n- Fixed merge-conflict detection being completely inert on CRLF files: the scanner split on `\\n` and compared `=== \"=======\"`, so `=======\\r` never matched and the agent edited around live conflict markers without warning; CRLF files now detect, splice, and round-trip their line endings correctly.\n- Fixed cross-line search (`\\n` in the pattern) silently returning zero matches: the native searcher was never switched to multi-line mode (only the regex flag was set), so the advertised feature matched nothing on real files while reporting a confident \"No matches found\".\n- Fixed search results lying about completeness: one hot file could consume the entire 2000-match global budget in path order making later files unreachable by any `skip` (now capped per file with the footer hedging `of N+` when truncated), paginating past the last page returned \"No matches found\" instead of \"No more results\", directory scans now report how many >4MB files were skipped instead of silently excluding them, adjacent matches in virtual resources no longer emit duplicated backwards-numbered context lines, and patterns are no longer `trim()`ed (only all-whitespace is rejected \u2014 leading/trailing whitespace is meaningful regex).\n- Fixed the search tool's native grep being uncancellable: neither the abort signal nor any timeout was threaded through, so Esc on a huge-tree search left the native walk burning CPU to completion; both now propagate (30s default timeout).\n- Fixed archive and sqlite reads that could OOM or hang the process: tar/tgz archives are stat-gated at 256MB before being loaded, zip members reject attacker-declared uncompressed sizes over 64MB before allocation, and binary plain files now return a NUL-sniff notice instead of filling the line budget with mojibake.\n- Fixed malformed internal-URL selectors (`artifact://3:-100`) silently dumping the whole resource instead of erroring, selectors directly on an archive root (`a.zip:500`, `a.zip:raw`) being misparsed as member names, archive members minting editable hashline tags keyed to the archive path (they are immutable resources), URL selector tokens being case-sensitive (`:RAW` 404ed), `artifact://N` resolving into another session's artifacts in multi-session hosts, and not-found paths with archive/sqlite extensions stacking multiple 5s workspace-wide suffix globs (now shared per read, with glob metachars escaped so `foo[1].ts` can match itself).\n- Fixed leading `cd X &&` extraction breaking shell-expanded paths \u2014 `cd \"$(git rev-parse --show-toplevel)\" && make` failed with \"Working directory does not exist\" because the captured path was resolved literally; extraction now defers to the shell when the path contains `$`, backticks, or `(`.\n- Fixed the echo/printf write-redirect interceptor rule blocking legitimate commands containing `>` inside quotes (`echo \"a -> b\"`, `printf 'use 2>&1'`); the rule is now quote-aware, and also catches `>|` clobber redirects and `$VAR` targets it previously missed.\n- Fixed every completed auto-backgrounded bash invocation leaking its persistent native `Shell` in the process-global session map, and the running-job cap failing all bash commands outright \u2014 at capacity, commands now degrade to direct foreground execution (explicit `async: true` still errors).\n- Fixed a duplicate-delivery race where a bash job completing just inside the auto-background threshold could be returned as the tool result and re-injected as a completion notification, and fixed auto-background silently preempting the ACP client-terminal route when an editor advertises terminal capability.\n- Fixed timed-out/cancelled PTY and client-bridge commands surfacing raw output with no annotation (the model couldn't distinguish timeout from failure and retried identically); the timeout/abort notice is now always appended.\n- Fixed `ask` reporting timeout auto-selection as \"User selected: X\" \u2014 fabricated consent for consequential questions; the result now says \"(auto-selected after timeout)\" with a `timedOut` detail flag, the transcript card marks the auto-selection distinctly, and a deliberate Esc seconds past the deadline is treated as a cancel instead of being reclassified as a timeout.\n- Fixed `todo` accepting duplicate task content/phase names in `init` (duplicates were permanently unaddressable \u2014 every targeting op hit the first match while auto-promotion kept resurrecting the twin) and persisting half-applied batches on error; failed batches no longer mutate state.\n- Fixed the auto-generated-file guard caching markers by path alone with no invalidation \u2014 a file regenerated after first check stayed editable (and vice versa); entries are now validated against mtime+size.\n- Fixed editor-bridged (ACP) writes skipping the post-write bookkeeping the direct path performs (`bumpFileMutationVersion`, shebang chmod), so mutation-version consumers saw stale state depending on whether an editor was attached.\n- Fixed `conflict://*` resolution failing spuriously when an out-of-band edit shifted a conflict block (stale duplicate registrations are now tolerated as already-resolved \u2014 but a DISTINCT conflict block that is merely byte-identical and still present in the file stays addressable), and partial conflict-resolution failures now set `isError` instead of burying failed files mid-text in a success result.\n- Fixed patch-mode prefix/substring matches silently truncating line content the model never saw: every non-exact match strategy now emits a warning with strategy + similarity, and prefix/substring matches are rejected unless the discarded fragment survives in the replacement lines.\n- Fixed ast-edit and file-mention snapshots being recorded under non-canonical paths (invisible to stale-tag recovery under symlinked cwds), and the ast-edit apply step leaving every just-issued preview tag stale \u2014 post-apply snapshots are re-recorded and fresh tags surfaced in the result.\n- Fixed notebook cells containing literal `# %% [markdown]` marker text being silently split into extra cells on any edit; marker-shaped source lines are now escaped on render and restored on parse.\n- Fixed the LSP client being published before `initialize` completed (concurrent callers hit \"server not initialized\" flakes on first use), reader-loop death leaving a permanent zombie client where every request times out at 30s forever (bad messages are now isolated per-message and a dead reader tears the client down for respawn), framing stalls on header blocks without `Content-Length` (now resynced past the junk in both LSP and DAP), `lsp status` hardcoding `ready` for every client including wedged ones, and shutdown skipping clients still mid-initialize (their server processes outlived exit).\n- Fixed numeric LSP code-action selectors being shadowed by substring title matches \u2014 `query: \"2\"` could apply a *different* quickfix whose title contained \"2\"; numeric queries now select strictly by index.\n- Fixed `file://` URIs built without percent-encoding: a `%` in a path threw `URIError` on round-trip and a `#` truncated the server-side path, desynchronizing diagnostics and workspace edits; URIs from lax servers carrying a raw `#`/`?` now route to the lenient parser instead of parsing \"successfully\" as fragment/query and misrouting edits.\n- Fixed multiple LSP inserts at the same position applying in reverse of spec order (transposed import/reference insertions), and `applyWorkspaceEdit` now overlap-validates every file before writing any, so a conflicting rename no longer leaves the workspace half-renamed.\n- Fixed `lsp reload` hanging for the whole tool timeout (`didChangeConfiguration` was sent as a request; it is a notification), biome failures being silently reported as \"no diagnostics\", a hung language server adding up to 30s to every edit (writethrough init is now deadline-bounded at 5s with deterministic spawn failures negative-cached for 3 minutes), and DAP `pause()` burning its full timeout when the stopped event raced the subscription; concurrent DAP breakpoint mutations are also serialized per session (last-writer no longer silently drops the other's breakpoints), queued mutations honor the caller's abort at dequeue, and the DAP output buffer retains a full 128KB tail instead of dropping whole chunks below the cap.\n- **Fixed concurrent isolated background tasks interleaving `git stash push/pop` + cherry-pick on the shared repository** \u2014 the merge sequence now runs under the repo lock, eliminating a lost-uncommitted-changes race; a stash-pop failure after successful cherry-picks also no longer reports merged branches as \"unmerged\" (the duplicate-commit trap) and instead tells the user to pop the stash manually.\n- Fixed async task batches getting stuck \"running\" forever (unscheduled/failed-to-register tasks never counted toward completion), error-result jobs being marked `completed`, semaphore-queued tasks counting against the 15-job global cap (batches >15 dropped the remainder and starved other async work), duplicate task ids skipping validation on the async path, and an abort racing subagent session startup leaking the late-created session's LSP/MCP processes.\n- Fixed task fail-fast abandoning in-flight siblings uncancelled (the worker signal now propagates), patch-mode merges blocking ALL successful siblings' patches when one task failed, and `$@` command expansion interpreting `$`-replacement patterns in user input.\n- Fixed eval cells double-writing artifacts (the tool and the per-cell executor each opened a sink on the same artifact path, corrupting >50KB outputs), JS `parallel()` early-rejecting in violation of its documented barrier (orphaning in-flight `agent()` thunks with worker-side promises hung forever), Python child subprocesses inheriting the NDJSON frame pipe (their stdout was dropped and could corrupt protocol frames \u2014 it is now captured and forwarded), JS cell timeouts silently wiping persistent VM state without annotation, and the JS console bridge throwing on `console.dir`/`time`/`group`/`assert`/`trace`.\n- Fixed `pr_push` never invalidating the PR/diff cache (the canonical push-then-verify flow read a pre-push diff for up to 5 minutes), current-branch `gh pr merge`/`close` with no positional never invalidating at all (exactly the staleness the cache layer claims to eliminate; numeric flag values like `--milestone 3` also no longer steal the positional), multi-PR checkouts discarding successful checkouts and racing in-flight git mutations on first failure (`allSettled` with per-PR reporting), run-watch ending with a failure result and zero logs when an auto-retry raced the grace-period refetch, the per-watch completed-run job cache serving a rerun's FIRST-attempt jobs after the rerun completed (entries are evicted whenever a run is observed non-completed), pagination terminating on post-filter page length, millisecond precision leaking into GitHub search date qualifiers, leading-dash PR identifiers reaching `gh` as flags, and `issue://?state=` typos silently coercing to the open list.\n- **Fixed the Exa API key being written to the log file** on every failed MCP request (the key rode the query string of logged URLs; key/token/secret/auth params are now redacted), and **removed the web-search query rewrite that replaced every `202x` substring with the current year** \u2014 it corrupted CVE identifiers and made historical-year searches silently impossible.\n- Fixed reopening the sole browser tab with a different `dialogs` policy disposing Chromium and then using the dead handle, a stale tab release evicting a live replacement browser from the registry (spawning duplicate Chromium processes), and concurrent same-name `open` calls leaking a worker + refcount via a check-then-set race (acquisitions are now single-flight per name); queued opens honor an abort at dequeue, and an init-payload failure releases the temporary browser hold instead of pinning the refcount forever.\n- Fixed fetch decoding every response as UTF-8 regardless of declared charset (Shift_JIS/EUC-KR/GBK pages rendered as mojibake through the whole reader pipeline; `Content-Type` and `` are now honored via `TextDecoder`), binary URLs being downloaded twice (body skipped on the first pass for convertible types), >50MB truncation being silent (now flagged in notes), all transport error detail being swallowed into a bare \"Failed to fetch URL\" (the cause is surfaced and 429s get one `Retry-After`-honoring, abort-aware retry), MCP SSE keep-alive lines escaping as raw `SyntaxError`s, MCP calls having no default timeout (now 60s), and a YouTube fetch budget expiry being misreported as a user abort that also skipped temp-file cleanup.\n- Fixed archive directory listings silently ignoring the selector offset \u2014 `a.zip:dir:50` now starts the listing at the 50th entry instead of relisting from the top.\n- Fixed the model selector dropping an immediate Enter when cached models were available but the selector's offline refresh was still pending.\n- Fixed dynamic `import(...)` inside functions passed to the browser tool's `tab.evaluate`/`page.evaluate` failing with `__omp_import__ is not defined`. The eval/browser JS runtime rewrites dynamic-import callees to the worker-injected `__omp_import__` helper, but puppeteer serializes evaluate callbacks with `Function.prototype.toString()` and re-runs them inside the page, where the helper does not exist. The rewriter now substitutes a guarded shim that falls back to native dynamic import when the helper is absent, so serialized code works in the page realm while in-worker imports keep resolving against the session cwd.\n- Transcript block freezing is now unconditional instead of gated on ED3-risk terminal detection: every finalized block replays its frozen snapshot once it crosses out of the live region, on all terminals including Windows, because the rewritten renderer's committed scrollback is immutable everywhere. Still-mutating blocks (pending tools, streaming messages, async thinking renderers) anchor the live region and keep repainting until they finalize, which structurally fixes stale/duplicated output from late async expansions ([#1823](https://github.com/can1357/oh-my-pi/issues/1823)).\n- Fixed the edit tool's post-edit diff preview occasionally echoing a context line twice with out-of-order numbering. Block-boundary context injection classified space-prefixed diff rows as old-file-only, so an unchanged line sitting in a net-offset region (old N / new N+k) was missing from the new file's visibility window; `findBlockContextLines` then re-surfaced it under its post-edit number and the row was spliced in after the adjacent change run. New-file boundary lines are now translated back to pre-edit numbers (the compact-preview renumbering contract) and merged into a single old-numbered insertion pass \u2014 also fixing closers below a net-offset edit being dropped or renumbered incorrectly.\n- Fixed the Anthropic web-search provider claiming the Claude Code identity on API-key requests: the CC billing header + system instruction were injected whenever the model wasn't Haiku 3.5, regardless of auth mode. Injection is now OAuth-gated like the streaming path, and OAuth search requests patch the billing header's `cch` attestation (via `wrapFetchForCch`) instead of shipping the `cch=00000` placeholder.\n- Fixed long streamed content appearing cut off mid-run: scrolled-off rows were erased from the viewport without ever being appended to terminal history. The transcript's commit boundary (`deriveLiveCommitState`) was all-or-nothing per block \u2014 one perpetually rewriting row (a task tool's ticking progress tree, per-agent cost/tool counters, spinner stats) suspended scrollback commits for the entire block, so once the block outgrew the viewport its static head (e.g. a task's prompt/context markdown) was neither committed nor on screen until the tool sealed, and was lost outright if the session ended mid-run. A stable-prefix ratchet now promotes leading rows that stayed visibly identical for a full 30-frame window as commit-safe, so the settled head reaches native scrollback while only the genuinely volatile tail stays deferred; a rewrite above the promoted run retreats the boundary and the engine audit recommits (duplication, never loss).\n- Fixed local tiny-title worker stdout/stderr leaking raw native model output such as `` and cache/status lines into the interactive TUI scrollback ([#2206](https://github.com/can1357/oh-my-pi/issues/2206)).\n- Fixed task-agent discovery advertising Claude Code custom agents from `.claude/agents/*.md` as OMP subagents; direct task-agent discovery now only loads OMP-native `.omp` agent roots, while Claude marketplace plugin agents keep their existing provider path ([#2209](https://github.com/can1357/oh-my-pi/issues/2209)).\n\n### Removed\n\n- Removed the `clearOnShrink` setting and its `PI_CLEAR_ON_SHRINK` environment variable: the rewritten renderer always clears shrunken rows exactly, so the flicker/perf tradeoff the setting controlled no longer exists. Existing config entries are ignored.\n- Removed the prompt-submit native-scrollback reconciliation checkpoint and the eager streaming render mode from the interactive controllers \u2014 the renderer's append-only contract made both obsolete.\n\n## [15.10.10] - 2026-06-09\n\n### Added\n\n- Added a read-only `view` op to the `todo` tool that echoes the current list without mutating state, so the agent can recover exact task text instead of guessing it from memory.\n\n### Changed\n\n- Rewrote the bash tool's coreutils guidance (tool prompt and system prompt) around an explicit litmus: pipelines that compute a new fact (`wc -l`, `sort | uniq -c`, `comm`, `diff`) are legitimate bash, while commands that merely move, page, or trim bytes a dedicated tool can fetch remain banned \u2014 output trimming destroys data the `artifact://` capture would have saved.\n\n### Fixed\n\n- Fixed the model selector dropping an immediate Enter when cached models were available but the selector's offline refresh was still pending.\n- Fixed dynamic `import(...)` inside functions passed to the browser tool's `tab.evaluate`/`page.evaluate` failing with `__omp_import__ is not defined`. The eval/browser JS runtime rewrites dynamic-import callees to the worker-injected `__omp_import__` helper, but puppeteer serializes evaluate callbacks with `Function.prototype.toString()` and re-runs them inside the page, where the helper does not exist. The rewriter now substitutes a guarded shim that falls back to native dynamic import when the helper is absent, so serialized code works in the page realm while in-worker imports keep resolving against the session cwd.\n- Transcript block freezing is now unconditional instead of gated on ED3-risk terminal detection: every finalized block replays its frozen snapshot once it crosses out of the live region, on all terminals including Windows, because the rewritten renderer's committed scrollback is immutable everywhere. Still-mutating blocks (pending tools, streaming messages, async thinking renderers) anchor the live region and keep repainting until they finalize, which structurally fixes stale/duplicated output from late async expansions ([#1823](https://github.com/can1357/oh-my-pi/issues/1823)).\n- Fixed the edit tool's post-edit diff preview occasionally echoing a context line twice with out-of-order numbering. Block-boundary context injection classified space-prefixed diff rows as old-file-only, so an unchanged line sitting in a net-offset region (old N / new N+k) was missing from the new file's visibility window; `findBlockContextLines` then re-surfaced it under its post-edit number and the row was spliced in after the adjacent change run. New-file boundary lines are now translated back to pre-edit numbers (the compact-preview renumbering contract) and merged into a single old-numbered insertion pass \u2014 also fixing closers below a net-offset edit being dropped or renumbered incorrectly.\n- Fixed the Anthropic web-search provider claiming the Claude Code identity on API-key requests: the CC billing header + system instruction were injected whenever the model wasn't Haiku 3.5, regardless of auth mode. Injection is now OAuth-gated like the streaming path, and OAuth search requests patch the billing header's `cch` attestation (via `wrapFetchForCch`) instead of shipping the `cch=00000` placeholder.\n- Fixed long streamed content appearing cut off mid-run: scrolled-off rows were erased from the viewport without ever being appended to terminal history. The transcript's commit boundary (`deriveLiveCommitState`) was all-or-nothing per block \u2014 one perpetually rewriting row (a task tool's ticking progress tree, per-agent cost/tool counters, spinner stats) suspended scrollback commits for the entire block, so once the block outgrew the viewport its static head (e.g. a task's prompt/context markdown) was neither committed nor on screen until the tool sealed, and was lost outright if the session ended mid-run. A stable-prefix ratchet now promotes leading rows that stayed visibly identical for a full 30-frame window as commit-safe, so the settled head reaches native scrollback while only the genuinely volatile tail stays deferred; a rewrite above the promoted run retreats the boundary and the engine audit recommits (duplication, never loss).\n- Fixed local tiny-title worker stdout/stderr leaking raw native model output such as `` and cache/status lines into the interactive TUI scrollback ([#2206](https://github.com/can1357/oh-my-pi/issues/2206)).\n- Fixed task-agent discovery advertising Claude Code custom agents from `.claude/agents/*.md` as OMP subagents; direct task-agent discovery now only loads OMP-native `.omp` agent roots, while Claude marketplace plugin agents keep their existing provider path ([#2209](https://github.com/can1357/oh-my-pi/issues/2209)).\n\n### Removed\n\n- Removed the `clearOnShrink` setting and its `PI_CLEAR_ON_SHRINK` environment variable: the rewritten renderer always clears shrunken rows exactly, so the flicker/perf tradeoff the setting controlled no longer exists. Existing config entries are ignored.\n- Removed the prompt-submit native-scrollback reconciliation checkpoint and the eager streaming render mode from the interactive controllers \u2014 the renderer's append-only contract made both obsolete.\n\n## [15.10.9] - 2026-06-09\n\n### Fixed\n\n- Fixed streaming thinking (and other styled assistant content) vanishing from native scrollback once it scrolled past the viewport top during a foreground turn. The transcript's append-only commit detector compared raw row bytes, so a styled paragraph wrapping onto a new row (the span-closing SGR and width padding move while the visible cells stay identical) or a streamed token pushing the last word down a line flagged the block as permanently volatile \u2014 the commit boundary froze and every later row that crossed the viewport top was committed nowhere. Rows are now compared by visible content, a wrap-shrink of the in-flight bottom line counts as append-only, and a genuine one-off interior rewrite only suspends commits until the block re-earns append-only (30 clean frames), after which the pinned emitter backfills the stalled gap contiguously. Periodically rewriting blocks (spinners, collapsing tool previews) never re-earn and stay deferred.\n- Fixed bracketed pastes containing multiple image file paths so each image is attached in order instead of treating the whole paste as one unreadable path.\n- Fixed MCP OAuth fallback prompts so the \"Click here to authorize\" label emits an auth-safe terminal hyperlink even when hyperlink auto-detection is unavailable, keeping non-browser MCP setup usable ([#2196](https://github.com/can1357/oh-my-pi/issues/2196)).\n- Fixed `task`-spawned subagents repeating filesystem scans the parent had already completed. `ExecutorOptions` and the `createAgentSession()` call inside `runSubprocess()` did not forward `rules`, the discovered extension paths, or the discovered `.omp/tools/` paths, so each subagent re-ran `loadCapability()`, `discoverAndLoadExtensions()`, and the full `.omp/tools/` walk. The toolsession now caches `session.rules`, `session.extensionPaths`, and `session.customToolPaths`; `runSubprocess()` threads them through; and `createAgentSession()` accepts new `preloadedExtensionPaths` and `preloadedCustomToolPaths` options backed by new exported `discoverExtensionPaths()` and `discoverCustomToolPaths()` helpers. Crucially, only path lists are forwarded \u2014 never loaded instances. Each session rebuilds its own `Extension` and `LoadedCustomTool` objects so the per-session `ExtensionAPI`/`CustomToolAPI` (cwd, eventBus, runtime, exec, pushPendingAction, UI) targets the right session; forwarding loaded instances would have routed extension handlers and custom-tool execution back through the parent. The CLI's `preloadedExtensions` short-circuit is preserved for same-process reuse and now shallow-clones the caller's `extensions` array so inline-extension augmentation (autoresearch + custom-tools wrapper) cannot bleed back into it ([#2190](https://github.com/can1357/oh-my-pi/issues/2190)).\n- Fixed SSH tool cancellation hanging behind OpenSSH ControlMaster streams that stayed open after an Esc/user interrupt ([#2180](https://github.com/can1357/oh-my-pi/issues/2180)).\n- Fixed Windows stdio MCP servers launched through PATH shims such as `codegraph.cmd` so bare commands like `codegraph` resolve via `PATHEXT` before spawn ([#2174](https://github.com/can1357/oh-my-pi/issues/2174)).\n- Fixed compiled-binary extensions failing to load `@oh-my-pi/pi-*` packages when `bun --compile` quietly dropped one of the extra entrypoints (observed on macOS arm64 release builds): the legacy-pi compat shim's package-root override branch returned the bunfs path without checking the target was present, so the rewrite emitted a `file://` URL to a missing module and the #1216 fallback (scoped to the throwing `getResolvedSpecifier` path) never ran. Override targets are now validated against the on-disk filesystem at module init, missing entries are dropped, and resolution falls through to canonical lookup so Bun resolves the import from the extension's own `node_modules` ([#2168](https://github.com/can1357/oh-my-pi/issues/2168)).\n\n## [15.10.8] - 2026-06-09\n\n### Added\n\n- Added an optional `fetch` option to `CustomToolContext` so custom tools can use a caller-provided HTTP implementation\n- Added optional `fetch` overrides to `ModelRegistry` construction and MCP/web search/tool network calls, enabling callers to inject custom HTTP clients instead of relying on global `fetch`\n- Added a `bash.enabled` setting to disable the model-facing bash tool while leaving user-initiated bang/RPC bash commands available.\n- Added an `@` model-selector suffix to pin an aggregator model to a single upstream provider per invocation, e.g. `--model openrouter/z-ai/glm-4.7@cerebras` (sets OpenRouter `provider.only`; Vercel AI Gateway models map to `vercelGatewayRouting.only`). Resolved through `parseModelPattern`, so it works for `--model`/`--smol`, model roles, and the SDK, and composes with a trailing thinking level (`...@cerebras:high`). The base must resolve to an aggregator (`openrouter.ai` / `ai-gateway.vercel.sh`); otherwise the `@` stays part of the id, so ids that legitimately contain `@` (`claude-opus-4-8@default`, `workers-ai/@cf/...`) are unaffected.\n\n### Fixed\n\n- Fixed a turn-ending provider error (e.g. a 502 whose body is the proxy's full HTML page) flooding the transcript: `AnthropicApiError` folds the entire response body into `errorMessage`, and the inline transcript render reprinted it verbatim \u2014 every embedded blank line included \u2014 leaving a tall mostly-empty block ending in ``. The inline error now drops blank lines, clamps to 8 lines, and width-truncates each line via `getPreviewLines`, matching the pinned error banner.\n\n## [15.10.7] - 2026-06-08\n\n### Fixed\n\n- Fixed MCP OAuth fallback rendering to show a short terminal hyperlink and keep the raw authorization URL on one unwrapped copy line ([#2121](https://github.com/can1357/oh-my-pi/issues/2121)).\n- Fixed `omp` startup blocking 25\u201330 s on a single unresponsive MCP server when no cached tools were available for it. `MCPManager.connectServers` used to fall through to an unbounded `Promise.allSettled` over every still-pending server without a cached tool list, so one server stuck waiting on the per-request MCP timeout (`OMP_MCP_TIMEOUT_MS`, default 30 000 ms) gated the entire UI ready signal. Pending-without-cache servers are now left in flight: their tools surface via the existing background `#onToolsChanged` \u2192 `refreshMCPTools` path the moment the connect completes, and failures continue to log through the background catch handler ([#2100](https://github.com/can1357/oh-my-pi/issues/2100)).\n\n## [15.10.6] - 2026-06-08\n\n### Added\n\n- Added a `/plan-review` command that manually (re-)opens the plan-review overlay while plan mode is active. Since there is no fixed plan filename, it reviews the newest `local://-plan.md` the agent wrote \u2014 useful for pulling the review back up after dismissing it, or reviewing a plan the agent wrote without calling `resolve`.\n\n### Changed\n\n- Reverted the `task` tool's result-header glyph from the `\u21f6` signature icon back to the quiet `status.done` bullet (`\u2022`): white while a subagent is running, accent once it finishes. The reviewer verdict line and per-agent result lines use the same bullet.\n\n### Fixed\n\n- Fixed `/login` API-key prompts (OpenCode Zen, Perplexity OTP, GitHub Enterprise URL, manual OAuth redirect URL, \u2026) silently dropping pasted content on kitty/Linux/Wayland \u2014 and any other terminal supporting OSC 5522 enhanced paste. `InputController` enables kitty's enhanced clipboard protocol on TUI start and consumes the resulting OSC 5522 packets in an `addInputListener` that runs before focus dispatch, so the paste never reached the modal `Input`'s bracketed-paste handler; the routing then stuffed the text into the main `CustomEditor` unconditionally, even when `selector-controller` had detached the editor and focused a temporary OAuth input. The pasted API key accumulated in the hidden editor and only resurfaced in the main prompt when the user dismissed the modal with Enter or Esc. The enhanced-paste callback now consults `ui.getFocused()` and routes the text to the focused component when it exposes a `pasteText` hook, falling back to the editor only when no modal target is in focus; image pastes refuse with a status message instead of stuffing a binary blob into the hidden editor. ([#2127](https://github.com/can1357/oh-my-pi/issues/2127))\n- Fixed an auto-compaction dead loop when `compaction.strategy` was `shake` and the configured threshold was low enough that a single shake pass could not bring the context below it (e.g. a 50K-token threshold on a session well above it). Each pass auto-continued, the next agent turn re-triggered the threshold check, and the second shake had nothing new to drop, so the session spun forever. The shake recovery path now estimates post-shake context and, when it is still above the threshold (or shake reclaimed nothing on overflow recovery), surfaces a one-shot warning and falls back to the summarization-driven `context-full` compaction so progress actually resumes ([#2119](https://github.com/can1357/oh-my-pi/issues/2119)).\n- Fixed `/skill:` prompts so magic keywords and turn-budget directives in skill args inject the same hidden notices as normal user prompts, matching the editor highlight behavior ([#2128](https://github.com/can1357/oh-my-pi/issues/2128)).\n- Fixed MCP OAuth fallback rendering to show a short terminal hyperlink and keep the raw authorization URL on one unwrapped copy line ([#2121](https://github.com/can1357/oh-my-pi/issues/2121)).\n- Fixed the `task` tool rendering a success bullet and a `success` frame state for detail-less error results (e.g. an argument-validation failure that never executes): the header now shows the error glyph with an error border and `error` state, and surfaces the dispatched agent name.\n- Fixed Agent Control Center new-agent creation so Windows Ctrl+Enter sequences submitted as a single LF generate the agent instead of inserting a newline ([#2118](https://github.com/can1357/oh-my-pi/issues/2118)).\n- Fixed plan-mode subagents preserving read-only specialty tools such as `report_finding` while still stripping mutating tools ([#1998](https://github.com/can1357/oh-my-pi/issues/1998)).\n- Removed unreachable standalone Exa tool-suite exports and stale tool-count barrel exposure while keeping the live Exa `web_search` provider helpers ([#2093](https://github.com/can1357/oh-my-pi/issues/2093)).\n- Fixed `omp commit` split plans accepting hunk selectors that resolve to no parsed hunks, which crashed the apply step after the index reset and left the working tree fully unstaged ([#2098](https://github.com/can1357/oh-my-pi/issues/2098)).\n\n## [15.10.5] - 2026-06-08\n\n### Added\n\n- Added Homebrew and mise package-manager update paths to the self-update command so installations launched from those tools are updated through their native workflows\n- Added detection of Homebrew and mise install locations so self-update chooses the manager-specific updater when the active `omp` binary comes from a package-manager-managed path\n- Added `astCondition` to TTSR rule frontmatter as a syntax-aware alternative to regex `condition`, enabling AST-based matching for edit/write tool snapshots\n- Added a built-in `ts-redundant-clear-guard` rule that flags redundant guards around `clearTimeout`, `clearInterval`, and `clearImmediate` calls\n- Added a built-in `ts-no-test-timers` rule that flags real timers (`Bun.sleep`, `setTimeout`, `setInterval`) in `*.test.ts` files, steering toward fake timers (`vi.useFakeTimers()` / `vi.advanceTimersByTime()`)\n- Added support for paste marker highlighting with accent styling (`[Paste #N, +X lines]`/`[Paste #N, Y chars]`) in the prompt editor, matching the visual treatment of image references\n- Added pixel dimensions to pasted/loaded image placeholders in the prompt \u2014 the marker now reads `[Image #N, WxH]` (falling back to `[Image #N]` when the header can't be decoded).\n- The bundled shell now treats `nohup` as a builtin: `nohup \u2026 &` runs the command without masking `SIGHUP` or detaching it, so agent-started daemons stay tied to this agent's lifetime instead of leaking as orphans when the agent exits. Updated the bash tool prompt's daemon guidance to match (dropped the `nohup \u2026 & / setsid \u2026 & / disown` detach recommendation in favor of a large `timeout` plus the persistent session).\n- Added per-tool `tool.*` theme symbol keys (nerd/unicode/ascii presets) plus a quiet `status.done` glyph, so each tool's result header can carry a signature icon instead of a generic status mark\n\n### Changed\n\n- Updated pi-ai OAuth imports to the renamed `@oh-my-pi/pi-ai/oauth` subpath (was `@oh-my-pi/pi-ai/utils/oauth`) across the login UI, MCP OAuth flow, model registry, setup wizard, and web-search Codex auth. The legacy-plugin specifier shim drops its `pi-ai/oauth` \u2192 `pi-ai/utils/oauth` subpath rewrite, since the canonical `@oh-my-pi/pi-ai/oauth` export now resolves directly.\n- Changed forced self-updates for Homebrew installs to run `brew reinstall` and for mise installs to run `mise install --force` after `mise upgrade` when `--force` is requested\n- Changed TTSR rule bucketing and matching so rules with only `astCondition` are treated as TTSR rules and evaluated in the interrupt flow using reconstructed edit/write source snapshots\n- Normalized image content before it enters model context so attached images are downscaled and preprocessed for prompts, steering messages, follow-ups, and custom agent messages\n- Changed image marker format to include pixel dimensions when available (`[Image #N, WxH]`), falling back to bare `[Image #N]` when header cannot be decoded\n- Changed the prompt editor to highlight large-paste placeholders (`[Paste #N, +X lines]`/`[Paste #N, Y chars]`) with the same accent styling as image references (bold, no hyperlink), and to delete image/paste markers atomically: a single backspace or forward-delete removes the whole marker instead of leaving a broken `[Paste #N, +X lines` behind.\n- Browser tool helpers (`tab.*`) are now individually tracked and time-bounded: when a `run` cell hits its budget, the timeout error names the still-running helper(s) and how long each has been stalled (e.g. `... (stalled on tab.screenshot({ selector: \".x\" }) (29.9s))`) instead of the opaque `Browser code execution timed out after 30000ms`. Page-coupled helpers that should resolve quickly (`observe`, `screenshot`, `extract`) also fail fast with a named per-op error at `min(cellBudget, 20s)`, leaving budget for the rest of the cell, rather than silently consuming the whole budget.\n- Derived the auth-broker OAuth callback ports (`CALLBACK_PORTS`) and the paste-code login-provider set from the `@oh-my-pi/pi-ai` provider registry, removing the duplicated `CALLBACK_SERVER_PROVIDERS` tables in the model selector and the setup-wizard sign-in scene.\n- Raised the `eval` tool's per-cell `timeout` ceiling from 600s to 3600s (matching `bash`), in both the Zod schema and the `TOOL_TIMEOUTS.eval` runtime clamp, so heavy local-compute cells can request budgets above 10 minutes.\n- Derived the auth-broker OAuth callback ports (`CALLBACK_PORTS`) and the paste-code login-provider set from the `@oh-my-pi/pi-ai` provider registry, removing the duplicated `CALLBACK_SERVER_PROVIDERS` tables in the model selector and the setup-wizard sign-in scene.\n- Reworked tool result-header glyphs to cut the overused success checkmark/dot: each tool now shows its own signature icon on success (terminal for bash, pencil for edit, magnifier/globe for search, plug for MCP, etc.; read keeps the read-group status dot), tools without a custom renderer fall back to a quiet `status.done` dot, and error/warning/pending states keep the universal cross/warning/spinner\n- Changed steady-state health indicators (LSP server ready, OAuth logged-in, plugin-doctor checks) from a success checkmark to a colored `status.enabled` dot, so failures stand out instead of every line reading as a check\n- Changed one-shot MCP/SSH/debug confirmation messages from a generic checkmark to contextual action glyphs (add/remove, connect/enable/disable toggles, reload, job-completed), reflecting what happened rather than just \"success\"\n- Derived the auth-broker OAuth callback ports (`CALLBACK_PORTS`) and the paste-code login-provider set from the `@oh-my-pi/pi-ai` provider registry, removing the duplicated `CALLBACK_SERVER_PROVIDERS` tables in the model selector and the setup-wizard sign-in scene.\n\n### Fixed\n\n- Fixed package subpath exports for status-line, setup-wizard, tool-discovery, and gallery fixture modules so rewritten test imports resolve through `@oh-my-pi/pi-coding-agent`.\n- Fixed runtime model provider discovery so extension-registered providers are now refreshed after extension load and extension-supplied models appear without restarting\n- Fixed task-row shimmer timing so every running description starts its highlight on the first character together and reaches the last character together, regardless of text length.\n- Fixed the `eval` tool's `read`/`write`/`append` helpers (both Python and JS backends) treating `local://` (and other internal-URL) paths as plain filesystem paths. `pathlib.Path`/`path.resolve` collapse `local://x.md` to `local:/x.md`, so `write(\"local://x.md\", \u2026)` created a junk `local:` directory under the cwd instead of writing where `read local://x.md` resolves. The helpers now substitute injected on-disk roots for known schemes (currently `local://`, pinned to the session's own `local://` root), reject path traversal and unknown `scheme://` paths, and leave plain paths resolving against the cwd.\n- Fixed read and edit previews to surface the enclosing syntactic block's off-window boundary line (behind an ellipsis) when a shown line opens or closes a block whose other end falls outside the displayed range. Powered by a new tree-sitter `enclosingBlockBoundaries` native, so it covers brace languages and indentation languages (Python) using real syntactic spans, with a lexical bracket scan as fallback for unparseable sources.\n- Fixed `tab.screenshot({ selector })` hanging for the entire cell budget on continuously-animating pages (WebGL / `backdrop-filter` \"glass\" effects). The element-screenshot path no longer routes through puppeteer's `scrollIntoViewIfNeeded()`, whose `IntersectionObserver` promise can stall indefinitely under heavy rendering; it now does a single instant `scrollIntoView` and captures with `scrollIntoView: false` (relying on `captureBeyondViewport`), so off-screen elements are still captured without the stall.\n- Fixed follow-up message submissions to forward pending clipboard-pasted images to `session.prompt` in both streaming and non-streaming flows\n- Fixed follow-up handling to clear consumed clipboard image state after submission so pasted images are not silently carried into later messages\n- Fixed clipboard-pasted images being rejected when steering or following up during compaction. Instead of bailing with \"Retry after it completes to send images\", the message and its images are now queued via `queueCompactionMessage` and forwarded to the session (steer/follow-up/prompt) when the compaction queue flushes.\n- Fixed edit tool result previews to show only current-file lines and collapse long inserted blocks instead of echoing removed content.\n- Fixed `generateDiffString` to omit the mid-skip `...` placeholder between two nearby edits, conveying the elided gap via the jump in line numbers instead (consistent with how leading/trailing context skips already render). The placeholder row was indistinguishable from a genuine `...` context line and wasted a row in compact previews.\n- Fixed concurrent interactive dialogs clobbering each other on the shared editor surface. `ExtensionUiController` presents the selector / input / editor modals by swapping a component into the single `editorContainer` and stealing focus, with no serialization \u2014 so a second `select`/`input`/`editor` request (from a hook, extension, the `ask` tool, or an internal flow) opened while one was already up would clear the container and re-focus, orphaning the first dialog. Its promise then hung until the caller's signal aborted (surfacing a stray `Ask input was cancelled` on top of the answered call). These modals are now serialized through `#presentDialog`: at most one shows at a time and the rest queue (FIFO); a queued request whose signal aborts before its turn resolves `undefined` and is never shown. The first dialog is still presented synchronously, so single-dialog timing is unchanged.\n- Fixed the `ask` tool potentially hanging when the model emitted two `ask` calls in one tool batch. `ask` now declares `concurrency: \"exclusive\"`, so the agent loop serializes the batch and each question's selector runs to completion before the next starts, instead of racing for the shared selector surface.\n- Expanded `@path/to/file` import references in CLAUDE.md / AGENTS.md / GEMINI.md (and the other discovered context-file flavors) when loading them into the system prompt, matching the convention used by Claude Code, Goose, and other agents. Imports resolve relative to the importing file's directory, support `~/...`, recurse up to 5 hops, and are skipped inside fenced code blocks and inline code spans so technical examples like `npm install @types/node` survive intact ([#2111](https://github.com/can1357/oh-my-pi/issues/2111)).\n\n### Removed\n\n- Removed the special Anthropic `claude-opus-4-8` tool-call batch cap; sessions no longer abort an in-flight provider stream after a fixed number of completed tool calls.\n\n## [15.10.4] - 2026-06-08\n\n### Added\n\n- macOS release binaries are now signed with a Developer ID Application identity (hardened runtime + secure timestamp + JIT/library-validation entitlements) and notarized in CI when the `APPLE_*` signing secrets are configured; releases auto-fall back to ad-hoc signing until then. This makes the shipped binaries Gatekeeper-acceptable, unblocking an official Homebrew submission ([#776](https://github.com/can1357/oh-my-pi/issues/776)). See `docs/macos-signing-notarization.md`.\n- Added a Homebrew install path: `brew install can1357/tap/omp`. The [can1357/homebrew-tap](https://github.com/can1357/homebrew-tap) formula installs the prebuilt release binary, and a `release_brew` CI job regenerates it (version + per-asset sha256) from each published release via `scripts/ci-update-brew-formula.ts` ([#776](https://github.com/can1357/oh-my-pi/issues/776)).\n\n### Changed\n\n- Adjusted `completion()` model resolution so the `default` tier now prefers the session\u2019s active model and falls back to the configured default role when needed\n- Rewrote the session auto-title prompt (`prompts/system/title-system.md`) and the `set_title` tool description to ask for a concise, sentence-case title (3-7 words) that captures the session's topic/goal, with good/bad examples and explicit guidance to treat the first message as data (no following embedded links/instructions, no refusals, describe URL/reference asks). The local on-device title prompt (`tiny-title-system.md`) was aligned to the same 3-7 word, sentence-case convention. The deterministic greeting/low-signal filter and the `none` deferral sentinel are unchanged.\n- Renamed the eval oneshot helper from `llm()` to `completion()` in both JavaScript and Python preludes, including status events, prompt docs, and runtime tests.\n\n### Fixed\n\n- Fixed `completion()` to always send a non-empty default system prompt when `system` is omitted so providers that require instructions no longer reject requests\n- Fixed structured `completion()` mode to return parsed JSON from plain text output when the model skips the forced `respond` tool call\n- Fixed slow-tier `completion()` reasoning requests to avoid unsupported effort settings by only enabling reasoning on reasoning-capable models and capping effort to supported levels\n- Fixed JS eval worker reset/dispose to close workers gracefully before forced termination, avoiding Bun 1.3.14 N-API teardown crashes with native modules such as `canvas`.\n\n## [15.10.3] - 2026-06-08\n\n### Added\n\n- Added clickable file path hyperlinks to read tool outputs (read-call rows, grouped summaries, and inline previews) using resolved or absolute file targets with selector-based line anchors for quick navigation\n- Added a resolved-span echo to `replace block`/`delete block` edits: a successful block op now prints `replace block N \u2192 resolved lines A-B (K lines)` between the section header and the diff preview, so the model can confirm tree-sitter matched the construct it intended (e.g. catch a decorator left outside the block) instead of inferring the span from the diff after the fact.\n\n### Changed\n\n- Changed the `find` tool to process each explicit multi-path target separately before merging results so searches stay scoped to the requested paths\n- Changed multi-path `find` handling so invalid extra targets no longer fail the whole query and now return matches from valid targets only\n- Changed background-job completion and late LSP diagnostic delivery to inject at the next agent step boundary (mid-run), via the new non-interrupting \"aside\" channel, instead of only when the agent reaches a yield/follow-up point. The model now sees these notifications between its own requests without the turn having to end first, and in-flight tools are never interrupted; `job`-poll acknowledgement still suppresses results the agent already saw.\n- Changed late LSP diagnostics after edit or write to surface in the chat transcript as `Late diagnostics` entries rendered through the same grouped tree renderer the `edit`/`write` tools use (per-file nodes, severity icons, `:line:col` locations), and to honor the global tool-output expand toggle (collapsed entries cap at 5 diagnostics with a `\u2026 N more` hint)\n- Changed delayed diagnostics delivery to batch late results in one message per flush instead of a raw hidden custom payload\n- Changed hidden custom messages and file-mention context to reach providers as `developer` messages instead of user-authored turns, so system reminders no longer pollute compacted user history.\n- Rewrote the plan-mode active prompt (`prompts/system/plan-mode-active.md`) from scratch to stop producing shallow plans. Reframed the artifact as an **execution spec** a fresh agent runs after the planning conversation is cleared/compacted (zero design decisions for the implementer) rather than a brevity-capped summary. Folded high-consensus requirements into the existing sections as inline, conditional rules \u2014 no new boilerplate sections: ordered Approach steps that keep the build/tests green after each step (sequencing); exact signatures/literals for new or load-bearing symbols (contracts); full callsite list + clean cutover for renames/signature-changes/removals; Verification that must exercise the new behavior (input \u2192 observable output) with run preconditions, not just build/typecheck; Assumptions restricted to user-overridable choices plus pre-decided fallbacks for load-bearing assumptions; a provenance rule (plan facts must come from a read this session; unverified claims flagged inline); and bans on conversation back-references and decision-free sections (Non-Goals/Alternatives/Risks/Future Work). Kept the decision-complete self-check and the brevity-vs-completeness tiebreak (completeness wins). Render contract (Handlebars vars/conditionals) unchanged; verified across all `planExists`/`reentry`/`iterative` branch combinations.\n\n### Fixed\n\n- Fixed duplicate `find` matches in multi-target queries by deduplicating overlapping paths in merged results\n- Fixed `find` partial updates to avoid repeated streamed rows while scans are still running\n- Fixed stale late diagnostics from older edits being shown after a file was edited again\n- Fixed read output paths so selector suffixes are preserved when corrected paths were returned without selectors\n- Fixed `read` surfacing a misleading red \"Operation aborted\" on a plain-file or directory read when a turn was interrupted mid-read. Those reads are deterministic and fast, so `execute` now runs them to completion instead of cancelling them; slower/non-deterministic reads (archive, sqlite, document, image, summary, conflict scan, URL) stay cancellable.\n- Fixed edit tool headers to hide first-change line suffixes, middle-elide long paths only when the header width needs it, show compact change stats, and target encoded `file://` hyperlinks.\n- Fixed Esc interrupts rendering a redundant `Interrupted by user` assistant transcript line while preserving the interrupt reason for tool-result placeholders and continuation logic.\n- LSP writethrough no longer burns the full diagnostics poll on every edit/write. `typescript-language-server` never echoes the document version in `publishDiagnostics` ([upstream #983](https://github.com/typescript-language-server/typescript-language-server/issues/983)), so the exact-version gate never passed; `waitForDiagnostics` now accepts an exact version match instantly and otherwise settles on the latest publish after a short quiescence window, dropping superseded in-flight diagnostics.\n- LSP writethrough no longer blocks the whole edit/write on slow diagnostics: it now waits only a short inline window (~500ms) for a settled result, then hands the in-flight fetch to the deferred channel so a slow or cold language server (e.g. a large-project `tsserver`) delivers its diagnostics as a follow-up message instead of stalling the tool 3\u20135s on every edit. The background fetch also gets a longer budget so slow servers still surface late rather than being dropped.\n- Fixed the `c`/`.` continue shortcut making the agent second-guess itself after an Esc interrupt. Continuing used to submit an *empty* user turn, which left the model with only the aborted-turn context \u2014 so it tended to restate the halted state and ask whether to proceed rather than just continuing. The shortcut now resumes with a hidden agent-authored `developer` directive (\"keep going \u2014 don't stop to summarize or re-confirm the plan\") instead of an empty turn. It still produces no visible transcript entry, same as before.\n- Fixed native scrollback commit boundaries to be computed generically from finalized transcript blocks and observed append-only live growth, so tall final tool results and streaming previews keep their scrolled-off heads on ED3-risk terminals without per-tool append-only predicates; live blocks that re-layout remain deferred until finalization or the next checkpoint.\n- Fixed read-group summaries for multi-path `read` results to use result-provided display targets so each resolved path is shown as its own row\n- Fixed read-group range summaries to abbreviate long merged selectors with ellipsis to keep repeated-file range rows readable\n- Fixed read-group TUI summaries so a single delimited `read` call renders as separate read rows, and repeated reads of the same file collapse under one file with full-file/range children.\n- Fixed grouped `read` rows freezing on their pending \"\u23f3 Read \" preview on ED3-risk terminals (ghostty/kitty/iTerm2/\u2026) when a parallel sibling tool closed the read run and appended a block below the group before the read's result arrived. The read-group block now stays in the repaintable live region until its entries settle, so the late success result repaints instead of being stranded; a `seal()` escape hatch (turn end / transcript rebuild) still lets a never-delivered read freeze rather than pinning the live region.\n- Fixed session search to return all sessions unchanged when the query is blank\n- Fixed duplicate session suggestions by deduplicating history matches by session path when merging metadata and prompt-history results\n- Fixed `/resume` search ranking so sessions whose prompts or metadata match the query now prefer prompt recency and recent literal matches instead of letting older earlier-title fuzzy matches outrank a just-used session.\n- Fixed `omp --resume ` / `--fork ` crashing with `[Uncaught Exception]` when the id did not match a known session. `createSessionManager` now throws a dedicated `SessionResolutionError`, which `runRootCommand` catches to print `Error: Session \"...\" not found.` plus a hint to stderr and exit with code 1. The same path covers `--fork` combined with `--no-session` and the non-interactive cross-project / moved-cwd prompts that previously surfaced raw stack traces ([#2084](https://github.com/can1357/oh-my-pi/issues/2084)).\n\n### Removed\n\n- Removed the animated pending border (\"shimmer\") on running `bash`, `eval`, and `ssh` execution blocks. While pending, a block now shows a static accent border instead of sweeping a dark segment around its bottom edge; `display.shimmer` still governs the working-status line and `task` row animations.\n- Removed the tool-level `nonAbortable` bypass so `write` and `edit` honor the active turn `AbortSignal`. `read` is abortable for everything that is slow or non-deterministic (URL/internal-URL reads, archive, sqlite, document conversion, image decode, structural summary, conflict scan, suffix glob); only the deterministic plain-file line/range reads and directory listings run to completion.\n\n## [15.10.2] - 2026-06-08\n\n### Added\n\n- Added `raw-sse.txt` to debug report bundles, exporting recent raw provider SSE diagnostics when captured\n- Added `/model` visibility for auto-selected role defaults: inferred `pi/smol`/`pi/slow`/designer choices now show as compact `[ROLE auto]` badges, while explicitly configured roles keep the existing solid badges and thinking labels.\n- Added credential provenance to the `/login` and `/logout` provider picker: each authenticated provider now shows where its credential comes from \u2014 `(login)`, `(api key)`, `(env: VAR_NAME)`, `(config)`, `(--api-key)`, or `(custom provider)` \u2014 so a real OAuth login is distinguishable from an env var that merely aliases the provider (e.g. `COPILOT_GITHUB_TOKEN`). The origin is also matched by the picker's type-to-search filter.\n\n### Changed\n\n- Changed raw SSE debug export output to prepend dropped-record metadata so truncated sessions in debug bundles now report dropped record and character counts\n- Changed settings reads to cache pre-split schema paths and resolved values, with coarse invalidation on source/cwd changes.\n- Changed status-line rendering to cache merged effective settings until `updateSettings()` changes the configuration.\n- Changed `CustomEditor` app shortcut dispatch to parse each input packet once and match against precomputed canonical key sets, preserving the existing shortcut precedence while avoiding repeated key reparses.\n- Changed `lsp references` to retry only when no references or only the queried declaration are returned, using two fixed 250ms retries for project-aware servers\n- Changed `read` handling of `https://github.com//:raw` to use raw page rendering only, removing the GitHub API README fallback\n- Changed model resolution to apply provider-priority ordering when selecting models for roles and ambiguous patterns, using `modelProviderOrder` settings and built-in provider priority so first-party providers are preferred over relays in tie cases\n- Changed model canonical variant selection to use the same provider-priority ordering instead of candidate order when deduplicating equivalent upstream models\n- Changed the working-message shimmer to sweep at a fixed velocity (cells/second) instead of a fixed sweep duration divided by the message length. The band now advances \u22641 cell per 30fps redraw frame and stays equally smooth on short and long messages \u2014 previously a longer message swept proportionally faster and stepped visibly because it outran the redraw cadence. Sweep/round-trip duration now scales with length. Additionally, when `display.shimmer = disabled` the working line is static, so the loader no longer schedules 30fps redraws for it and falls back to the spinner-only ~12.5fps cadence.\n- Changed the eval fan-out trigger keyword from `workflow`/`workflows` to `workflowz`.\n\n### Fixed\n\n- Fixed working-message loader session accents so spinner/message color math is cached per session name, session-accent setting, and theme luminance while still updating immediately on renames, setting toggles, and theme changes.\n- Fixed startup model fallback selection so sessions now prefer each provider\u2019s configured default model before choosing the first available authenticated model\n- Fixed implicit model selection path for tools and sessions by honoring persisted model-provider order when no explicit pattern is provided\n- Fixed the working spinner appearing to ignore Esc for 2-3 seconds when an interrupt lands mid-tool. Esc fires the abort synchronously, but the agent loop only stops the loader at `agent_end`, which it cannot reach until every in-flight tool settles in `executeToolCalls`' `await Promise.allSettled(...)` \u2014 and process/subagent/kernel-owning tools tear down gracefully (SIGTERM, 2-3s grace, SIGKILL), so the loader kept showing the unchanged \"Working\u2026/\" line and read as a dropped keypress. The loader now switches to \"Interrupting\u2026\" the instant Esc requests the abort and freezes intent-driven label updates until the turn unwinds (`EventController.notifyInterrupting`), so the interrupt is acknowledged immediately even while teardown completes.\n- Fixed a flaky JS eval worker startup that intermittently failed unrelated CI runs. The worker-ready wait reused Bun's 5s default per-test timeout as its floor, so a slow cold-start under `--isolate` + high concurrency was aborted mid-init; terminating a still-initializing Bun worker is the documented SIGILL/SIGTRAP crash trigger, which took down the whole test file. Worker init now floors at a fixed 15s infrastructure budget (independent of, and still dominated by, a larger per-cell `timeout`), and the JS eval test suites set a 20s file-local timeout so cold starts complete instead of being torn down.\n- Fixed reviewer-style subagent yields crashing the calling eval cell when a caller-supplied output schema declares `additionalProperties: false` without a `findings` property. `normalizeCompleteData` now consults the active validator before splicing collected `report_finding` entries onto the yielded payload, so injection is suppressed when the schema would reject it \u2014 keeping the executor's post-mortem validation in lockstep with the in-tool `yield` validation that already accepted the same raw payload ([#2070](https://github.com/can1357/oh-my-pi/issues/2070))\n- Fixed Anthropic empty `toolUse` stops without tool calls corrupting session history by retrying them and removing orphaned turns even at the retry cap.\n- Fixed MCP tools hanging in non-yolo modes by declaring `approval = \"write\"` on `MCPTool` and `DeferredMCPTool`, and propagating the `approval` property through `customToolToDefinition()` in `sdk.ts`\n- Fixed session resumption after a working directory is moved/renamed (e.g. `git worktree move`): `--continue` now re-roots the terminal's last session into the new directory when its original directory no longer exists, explicit `--resume  --session-dir ` local matches re-root instead of reopening with the stale cwd, and cross-project `--resume ` offers to move (re-root) the session rather than only forking a duplicate copy when the source directory is gone\n- Fixed Kitty OSC 5522 paste rejecting plain text as \"no supported text or image data\": the listing parser now decodes the `mime=\".\"` DATA payload (whitespace-separated MIME list) Kitty actually sends, in addition to the per-type DATA packets described by the ancillary 5522-mode spec, and per-type spec listings now request the selected payload with `type=read:mime=...` instead of Kitty's dot-payload request shape ([#2051](https://github.com/can1357/oh-my-pi/issues/2051))\n- Fixed follow-up shortcut submission of builtin slash commands so `/goal set ...` applies goal mode instead of queueing as plain text.\n- Fixed Ctrl+Z crashing the agent on Windows with `TypeError: Unknown signal: SIGTSTP`. `InputController.handleCtrlZ` called `process.kill(0, \"SIGTSTP\")` unconditionally, but `SIGTSTP` is POSIX job-control and Bun/Node on Windows rejects the signal name from the JS side; the throw propagated out of the TUI input dispatcher as an uncaught exception. The handler now no-ops with a \"Suspend (Ctrl+Z) is not supported on this platform\" status on Windows, and on POSIX wraps `process.kill` in a try/catch that detaches the registered SIGCONT resume hook and re-`start()`s the TUI on failure so a rejected signal can never leave the UI stranded with a leaked listener ([#2036](https://github.com/can1357/oh-my-pi/issues/2036)).\n- Fixed a relative `--cwd` target (e.g. `omp --cwd repo` launched from `/tmp`) leaking the raw relative string into the session config. `applyStartupCwd` chdired into the resolved directory via `setProjectDir` but left `parsed.cwd` as `\"repo\"`, so `buildSessionOptions` (which prefers `parsed.cwd` over `getProjectDir()`) handed downstream settings/discovery/session creation a value that re-resolved against the new process cwd (`/tmp/repo/repo`) or persisted a relative session cwd. `parsed.cwd` is now re-synced to the resolved absolute project dir after the chdir.\n- Fixed the `--cwd` launch flag so it is parsed and can override the startup directory instead of always falling back to the current process directory or home auto-switch target.\n- Fixed session auto-retry for generic `upstream_error: Upstream request failed` gateway failures.\n- Stripped read-output line-number prefixes (`N:`) from auto-piped bare body rows in the hashline edit parser, so pasting `3:text` without a `+` prefix no longer injects `3:` as literal content. Uses single-pass stripping to avoid corrupting content whose own text starts with `digits:` ([#1492](https://github.com/can1357/oh-my-pi/issues/1492)).\n- Fixed `eval` `llm()` returning HTTP 400 \"Instructions are required\" when called without a `system` prompt against providers (notably `openai-codex`) whose Responses transformer drops the `instructions` field on an empty system prompt. `runEvalLlm` now sends a minimal default system prompt (\"You are a helpful assistant.\") when no `system` is supplied, so `llm(\"question\")` works against every provider; an explicit `system=` still wins.\n- Fixed the Python `read(path, offset, limit)` prelude helper rejecting documented positional arguments with `TypeError: read() takes 1 positional argument but 3 were given`. The signature was keyword-only (`def read(path, *, offset=1, limit=None)`) while the eval helper table advertises positional optional args; agents that called `read(\"file.py\", 10, 20)` literally crashed. The `*` is removed so both `read(\"f\", 10, 20)` and `read(\"f\", offset=10, limit=20)` work.\n- Fixed `eval` reset cells failing with `\"Python kernel reset already in progress\"` / `\"JS context reset already in progress\"` when two cells happened to overlap on the same session (e.g. a rapid resubmit, or a parallel-cell race). The executor now coalesces concurrent resets \u2014 additional callers wait for the in-flight reset to finish and then run on the freshly restarted kernel \u2014 instead of throwing a user-visible error for what is purely an internal coordination state.\n- Fixed the `eval` tool description advertising the `agent()` helper unconditionally even in subagent sessions whose parent forbids spawning. When `getSessionSpawns()` returns `\"\"`, the prelude doc now omits `agent()` so the model is not promised a helper that can only ever throw \"Cannot spawn 'task'. Allowed: none (spawns disabled for this agent)\".\n- Fixed plan mode rejecting `local://` plan-artifact edits when addressed via the absolute path the `read` tool echoes back in the `[path#tag]` header. `enforcePlanModeWrite` previously only matched the literal `local://` scheme; it now also accepts any absolute path whose realpath resolves inside the session's local sandbox root, so the absolute spelling and the `local://` spelling are interchangeable in plan mode.\n- Fixed snapshot tags freshly minted by `read` being rejected as stale by a subsequent `edit` against the same file when the two sides reached the file via symlink-equivalent spellings (e.g. macOS `/tmp/\u2026` vs `/private/tmp/\u2026`, or `read local://foo.md` recording under the file's `fs.realpath` while `edit local://foo.md` looked up under the raw `path.resolve(localRoot, \u2026)` form). The file snapshot store now keys every record/lookup through a `realpath`-canonicalized key (`canonicalSnapshotKey`), fusing all spellings of the same on-disk file onto one snapshot entry.\n- Fixed `read` of a `github.com//` URL with `:raw` returning the full JS-rendered HTML shell. Repo roots now resolve to the decoded README via the GitHub API (`/repos///readme`), falling back to the raw HTML only when the API returns no usable payload.\n- Fixed `issue://` and `pr://` reads returning stale OPEN/CLOSED state after a successful `gh issue close` / `gh pr merge` (or any other state-changing `gh` invocation) in the same session. The `bash` tool now invalidates the matching `github-cache` rows before executing any `gh (issue|pr) ` command.\n- Fixed line-range selectors on PDF/DOCX/PPTX/XLSX/RTF/EPUB reads being ignored. The markit-converted markdown body now flows through the same in-memory range slicer used for plain text, so `file.pdf:50-100` and `file.pdf:5-16,40-80` slice the converted body instead of returning the whole document.\n- Fixed the `read` selector cheatsheet incorrectly promising \"exactly one line\" for `:N+1` while the implementation pads single-line reads with \u22641 leading and \u22643 trailing context; documented that multi-range selectors do not pad, giving callers a way to request exact bounds.\n- Documented the `bash.autoBackground.enabled` behavior in the `bash` tool prompt so the `Background job  started: \u2026` notice for foreground commands that exceed `autoBackgroundThresholdSeconds` no longer reads as a tool malfunction.\n- Fixed `task` subagents whose in-tool `yield` validator had already accepted a payload after exhausting `MAX_SCHEMA_RETRIES` being rejected a second time by the post-mortem executor validator. The override now propagates through the yield tool's `details.schemaOverridden` flag, and the executor surfaces a `SUBAGENT_WARNING_SCHEMA_OVERRIDDEN` stderr line instead of re-emitting `schema_violation` for data the subagent already had to ship. Finalize also degrades to no validation (matching the yield tool's `looseRecordSchema` fallback) when the caller-supplied output schema fails to normalize.\n- Fixed the `web_search` `codex` provider returning `(see attached image)` / `[Attached image]` / `See image above` and similar non-informational image-placeholder strings as the answer. Detection broadened to a small regex set, and when annotations did produce sources we now drop the placeholder prose from `answer` (returning sources only); when neither annotations nor a real answer materialize, we throw 502 to advance the provider chain.\n- Fixed `search`, `find`, `ast_grep`, and `ast_edit` rejecting bracket-containing file paths (Next.js routes like `apps/[id]/page.tsx`) as glob patterns when the literal path exists on disk. `parseSearchPathPreferringLiteral` now prefers the literal interpretation for paths that resolve on disk and only falls back to glob expansion when the literal does not exist.\n- Fixed `search` with an external `http(s)/ftp/ws/file://` URL in `paths` surfacing a misleading \"Path not found\" error. The tool now rejects external URLs with a clear \"use `read` for URLs\" message.\n- Fixed `search` rejecting `skip: null` at the schema layer; `null` now normalizes to `0` alongside the omitted case, matching how callers serialize default pagination state.\n- Fixed `search` returning zero matches with no explanation when explicit file targets exceed the native grep cap (4 MB). The tool now surfaces a `Skipped oversized files (>4MB grep limit; \u2026)` notice listing the truncated paths.\n- Fixed the archive-extraction error message in `search` recommending `grep` \u2014 which the system prompt forbids \u2014 instead of pointing to `read :`.\n- Fixed `browser` `tab.open(name, { viewport })` on an existing tab not applying the new viewport: `acquireTab`'s reuse path now resizes the page in addition to navigating.\n- Fixed `browser` tab metadata leaking `user:pass@` basic-auth credentials in the URL surfaced to transcripts and observe snapshots; URLs are now redacted via `redactUrlCredentials()`.\n- Fixed `browser` `tab.extract(format)` returning a `ReadableResult | null` shape that the tool prompt advertised as plain content. The helper now returns the markdown/text string directly (or throws a clear `ToolError` when extraction is empty), and the prompt matches.\n- Fixed `lsp` requests timing out at a hard-coded 30 s ceiling when the caller supplied an explicit abort signal (e.g. the tool wall-clock). The signal is now the deadline; the 30 s default still applies when neither a signal nor an explicit `timeoutMs` is provided.\n- Fixed `lsp status` reporting servers as `Active language servers: \u2026` when the binary resolves on PATH but never spawns (rustup wrapper, missing toolchain component, etc.). Status now labels each entry as `(ready)` or `(configured, not started)`.\n- Fixed `lsp rename_file` fanning `willRenameFiles` requests across every configured server (including ones with no jurisdiction over the file type) and burning the wall-clock timeout. The action now pre-filters configured LSPs to those whose `fileTypes` cover the source or destination path, falling back to a plain filesystem rename when no server claims the type.\n- Fixed `lsp references` returning only the queried declaration (or only in-file results) on project-aware servers that had not finished indexing. The retry budget is raised from 2 \u2192 3 with 250 / 500 / 1000 ms backoff, and the retry trigger now also fires when all results live in the queried file.\n- Fixed `lsp config` accepting `fileTypes` entries with or without a leading dot inconsistently across actions; both `.ts` and `ts` are now normalized so a missing-dot entry no longer silently excludes a server from extension-based routing.\n- Fixed `lsp request` error path swallowing the params that were sent, making shape/coercion bugs on raw LSP calls impossible to diagnose in one round-trip; the error now echoes a truncated copy of the request params.\n- Fixed `find` with a single-star segment like `dir/*` recursing into subdirectories and returning nested matches. `parseFindPattern` already prepends `**/` for top-level globs (`*.ts` \u2192 `**/*.ts`), so anything reaching native without `**/` was deliberately scoped by the user; `recursive: false` is now passed to `natives.glob` to honor that scope.\n\n## [15.10.1] - 2026-06-07\n\n### Added\n\n- Added `display.smoothStreaming` setting (default `true`) to let users enable or disable smooth assistant-stream text reveal\n- Added `/tan ` slash command to fork the current conversation into a background agent so tangential work can continue asynchronously while your main session stays active\n- Added a background `/tan` dispatch message that records the handoff in the transcript and marks the delegated work as non-blocking\n- Added `providerPromptCacheKey` support to `CreateAgentSessionOptions` so `/tan` background sessions can reuse the parent session\u2019s prompt-cache lineage\n- Added session cloning for `/tan` runs with copied artifacts and shared MCP proxy tools\n- Added `SessionManager.forkFrom`\u2019s optional `suppressBreadcrumb` mode to avoid breadcrumb updates when forking background `/tan` sessions\n- Added OSC 5522 enhanced paste handling in `InputController`, so terminal clipboard events are decoded as image or text payloads and inserted without passing raw paste sequences to the editor\n- Added bracketed image-path paste support in `CustomEditor` so a single pasted image file path (PNG/JPEG/GIF/WEBP) is loaded from disk and inserted as an image candidate\n- Added direct support for `Image #N` insertion from pasted local image paths by routing successful image-path pastes through the same image normalization and resize flow as clipboard image pastes\n- Added `/fresh` to rotate the provider-facing session id and clear in-memory provider stream/cache state without changing the local session file.\n- Added a `ChatBlock` transcript primitive (`modes/components/chat-block.ts`) and a single `ctx.present(...)` sink (with `ctx.resetTranscript()`) so chat output is mounted in one place instead of the repeated `chatContainer.addChild(...)` + `ui.requestRender()` pattern scattered across controllers. `ChatBlock` carries a React/Svelte-style lifecycle \u2014 `onMount` starts effects, `onCleanup` registers teardown, `finish()` self-completes (stops timers and freezes the block at its final content), and `dispose()`/`resetTranscript()` tears everything down \u2014 so animated blocks own their own resources instead of leaking `setInterval`/`requestRender` bookkeeping into callers. The MCP \"Connecting\u2026\" spinner is now such a block.\n- Added a `framedBlock` output-block helper (`tui/output-block.ts`) plus a `borderColor` override and `applyBg: false` (no background fill) on output blocks, a `renderStatusLine` `iconOverride`, and an `icon.search` (magnifier) theme symbol \u2014 so tool renderers can draw self-contained muted-outline frames and search-family tools can show a magnifier instead of a checkmark.\n\n### Changed\n\n- Changed the bash tool frame to use a plain top rule instead of repeating \"Bash\" in the title bar, and folded minimizer raw-output artifact links into the status footer as `Artifact: `.\n- Changed grouped `read` output to use a white filled-circle mark for the group/single-read success state and omit duplicate per-file success marks inside multi-read groups.\n- Changed assistant streaming output to reveal text incrementally at 30 FPS with grapheme-safe adaptive catch-up, instead of replacing the whole message chunk-by-chunk\n- Changed shimmer-driven TUI animations (working text, pending bash/eval borders, and theme activity-spinner documentation) to render at 30fps instead of 60fps.\n- Changed running `task` tool agent rows to use a static `\u2022` marker and shimmer only the subagent name, leaving descriptions, stats, and nested tool detail text solid while removing the rotating status glyph from those rows.\n- Changed settings singleton method access to reuse bound methods for the active instance instead of allocating a new bound function on every `settings.get` lookup.\n- Changed plan-mode approval to keep the drafted `local://-plan.md` file at its original name as the canonical plan path, so approved plans are no longer renamed when leaving plan mode\n- Changed plan-mode write enforcement so only `local://` artifact files are writable during planning, blocking working-tree edits and allowing scratch or draft plan files in the local artifact area\n- Changed the `todo` tool result renderer to stop redrawing every phase's full task list on each update: when a multi-phase list is rendered collapsed (the default, not manually expanded), only phases the latest update touched \u2014 the phase holding the in_progress task, any phase with a just-completed task, and phases named by the ops that ran (`init` counts as touching all) \u2014 render their tasks; untouched phases collapse to a one-line `N. Name  done/total` summary. When call args are unavailable (e.g. transcript rebuilds) it falls back to the in_progress/completed-transition signals, and the manual expand toggle still shows every task. Also dropped the blank separator line previously inserted between phases.\n- Changed non-agent API operations (title and commit-message generation, image generation, web search, eval `llm()`, auto-thinking classifier, memory consolidation) to use session-aware API key resolution with auth retries via `registry.resolver()` / `authStorage.resolver()`, refreshing the active credential before rotating to another account\n- Changed image generation to wrap every provider fetch branch in `withAuth`, so 401 / usage-limit errors trigger credential force-refresh and rotation for authStorage-backed providers (OpenAI-hosted, antigravity, xai-oauth) while env-only providers (openrouter, gemini) stay single-attempt\n- Changed web-search providers using `authStorage.getApiKey` (anthropic, exa, tavily, parallel, synthetic, zai, kimi) to wrap HTTP calls in `withAuth` for automatic credential rotation on 401 / usage-limit errors\n- Changed the directory grouping for `find`, `search`, `ast_grep`, `ast_edit`, and `lsp` diagnostics from a single flat `# dir/` heading per immediate directory to a multi-level tree that folds the common path prefix into one heading. Previously every group repeated the full directory path \u2014 so results rooted outside cwd printed the absolute prefix (e.g. `/Users/me/proj/`) on every heading and nested directories were never collapsed. Now a single-child directory chain folds into one heading (`# packages/pkg/src/`, including an absolute root for out-of-cwd results), subdirectories nest one `#` deeper (`## nested/` \u2192 `### child.ts`), and each directory's own files are listed before its subdirectories. TUI hyperlink reconstruction tracks the nested directory stack across the whole output so file and code-frame links keep resolving to the correct absolute paths.\n- Changed the plan-mode approval surface from an inline transcript block plus a separate bottom selector into a single fullscreen overlay (like `/copy`) and overhauled its navigation. The overlay now renders the plan per-section through `ScrollView` (line-level \u2191/\u2193 scroll, Shift+\u2191/\u2193 to scroll faster, PgUp/PgDn, g/G) with no stray per-line `\u2026`, and \u2014 when the terminal is wide enough and the plan has \u22652 headings \u2014 shows a compact VS Code-style section sidebar (the redundant plan-title heading and any \"Contents\" label are omitted). Focus moves between regions with Tab/Shift+Tab (and flows at the edges: Down past the last section or the bottom of the body drops into the approval options; Up steps back), while the sidebar glows to track the scrolled section. The sidebar can fast-jump between sections, delete a section (with `u` undo), and annotate sections with feedback (`a`); deletions and annotations are collected into refinement feedback that is submitted back to the model when the operator picks \"Refine plan\". Mouse works too: clicking an approval option activates it, clicking a sidebar section jumps to it, and the wheel scrolls the plan. \u2190/\u2192 always drive the model-tier slider, Enter confirms, the external-editor key opens the plan, and Esc cancels. The overlay borrows the terminal's alternate screen buffer for its lifetime (`fullscreen` overlay), so the transcript stays put on the normal screen instead of bleeding through scrollback behind the modal.\n- Changed the interactive controllers (command, MCP, selector, extension-UI, event), debug panels, and the status/error/warning helpers to render chat output through `ctx.present(...)` instead of appending to `chatContainer` and calling `ui.requestRender()` directly; transcript rebuilds dispose live blocks via `ctx.resetTranscript()` so animated blocks' timers stop on reset.\n- Changed tool-execution block rendering so the container (`ToolExecutionComponent`) is a transparent passthrough \u2014 it no longer inserts a top/bottom blank line, adds left/right padding, or paints a state-colored background behind tool output. Tools with substantial body now self-frame with a muted outline and the tool title in the frame's top bar (`edit`/`apply_patch`, `write`, `ask`, `todo`, `github`, `goal`, `inspect_image`, `search_tool_bm25`, `task`), matching the already-framed `bash`/`read`/`eval`/`debug`/`web_search`/`lsp` blocks, while streaming/in-progress and trivial results collapse to a clean status line. The search-family list tools (`find`, `search`, `ast_grep`) and `job` render frameless/minimal; `find`/`search`/`ast_grep` show a magnifier on success instead of a checkmark, and `job` drops its `Job:` label prefix (the per-job rows are self-describing). The `search_tool_bm25`, `github`, and `inspect_image` frames draw with no background fill, and `inspect_image`'s label was shortened to `Inspect`.\n- Changed the plan-mode active prompt (`prompts/system/plan-mode-active.md`) to make plans decision-complete and cut filler. Added an Objective framing (\"another engineer can execute end-to-end without making a single design decision\"), a shared \"Resolving Unknowns\" section (explore discoverable facts before asking; reserve `ask` for non-derivable preferences/tradeoffs with 2\u20134 options + a recommended default), and a single shared \"The Plan\" structure (Context / Approach grouped by behavior not file-by-file / \u22645 Critical files / Verification / Assumptions) that replaces the per-branch structure guidance previously duplicated across the iterative and parallel workflows. Added explicit prohibitions on sections that decide nothing (Non-Goals, Out of Scope, Alternatives Considered, Risks/Mitigations boilerplate, Future Work), on enumerating every file/line, and on inventing schema/validation/precedence policy the request never established.\n- Changed completion notifications (`completion.notify`) to fire whenever the agent yields its turn, including in the foreground. The `agent_end` notification was previously gated behind background mode (`isBackgrounded`), so an ordinary foreground turn never emitted one; the gate is gone and the desktop toast now fires on every normal turn completion (still skipped for aborted/error turns and when `completion.notify` is `off`).\n- Changed the in-progress `task` tool block to keep the shared `context` brief (`# Goal` / `# Constraints` background) visible after the first progress snapshot arrives, instead of dropping it the moment the streaming call view was replaced by the result frame, and to stop animating a spinner/clock next to the `Task` frame header while running \u2014 the per-agent body lines already carry their own running spinner, so the header now shows a static state icon (matching the completed/failed header icons). The context is rendered through a shared `buildContextSection` helper that also undoes per-field double-encoding, so the brief reads cleanly in the result frame even though `renderResult` receives the raw (un-repaired) tool args.\n- Changed the messaging shown when you press Esc to interrupt a streaming turn from the ambiguous `Operation aborted` / `Tool execution was aborted: Request was aborted` to `Interrupted by user`, so a deliberate user interrupt no longer reads like an internal failure. Every Esc/flush interrupt path (`onEscape` while streaming, the queued-message restore-and-abort path, and the empty-submit queue flush) threads the reason through `AgentSession.abort({ reason })` \u2192 `Agent.abort(reason)` so it rides the `AbortController` onto the aborted assistant message's `errorMessage`; the turn label renders it verbatim on both the live and replay paths, and the synthetic placeholder results paired with in-flight tool calls now read `Tool execution was aborted: Interrupted by user`. Aborts that carry no reason still fall back to the retry-aware `Operation aborted` generic. Transcript label resolution is centralized in `resolveAbortLabel` (`session/messages.ts`).\n\n### Removed\n\n- Removed the `/background` (and `/bg`) slash command and the background-mode subsystem it was the sole entry point for \u2014 `InteractiveMode.isBackgrounded`, `createBackgroundUiContext`, `handleBackgroundEvent`, and every `isBackgrounded` guard across the input/event/extension-UI controllers and UI helpers. The command suspended the whole process group via `SIGTSTP` (a leftover testing shortcut) instead of detaching the running agent, which is not the expected workflow \u2014 use terminal panes or a multiplexer instead.\n\n### Fixed\n\n- Fixed inline `find` and `search` result blocks to align with grouped `read` output and render their success headers with the normal tool-title color instead of accent blue.\n- Fixed the working-status shimmer to opt into the loader's 30fps animated-message repaint path while keeping both the status spinner and pending bash/eval tool spinners on their normal 80 ms glyph cadence.\n- Fixed consecutive `read` tool calls failing to collapse into a single grouped block when a reasoning model emits one read per completion (`[thinking, read]`). The read group was reset on every assistant `message_start`, so each read rendered as its own one-entry `Read \u2026` line; now a read run accretes across completions and is broken only by a rendered non-empty text/thinking block, a non-read tool, or a user/IRC message \u2014 matching the transcript-rebuild path. `ReadToolGroupComponent` now reports its live/finalized state so the growing `Read (N)` header repaints correctly on native-scrollback (risk) terminals.\n- Fixed the `task` tool shared-context brief rendering raw Markdown headings (`# Goal`, `# Constraints`) inside framed call/result blocks instead of using the normal Markdown renderer.\n- Fixed the animated pending border on `bash`/`eval` blocks leaving a frozen dark \"bar\" segment behind after a backgrounded command finalized through the async update path. Once a command is auto-backgrounded (`details.async.state === \"running\"`) the block stays \"partial\" in the TUI until the async job-manager delivers the final result, but it also gets committed to native scrollback \u2014 so a mid-sweep shimmer frame baked a stray darkened border segment into the committed copy. The border now stops animating (and the 60fps redraw loop stops) the moment a block enters the backgrounded state, so the committed frame is a clean static border.\n- Fixed cold `omp` launch to clear native terminal history on the first paint, avoiding a once-per-launch duplicate welcome/transcript copy before the normal session replay.\n- Fixed plan approval resolution so `resolve` with `action: \"apply\"` can still find the plan file when `extra.title` is missing or stale by falling back to the current plan path and most-recent local plan artifacts\n- Fixed the search-family tool magnifier glyph (`find`, `search`, `ast_grep`, `search_tool_bm25`) to use the `accent` title color instead of `success` green, so the icon matches the tool title in the status header instead of standing out\n- Fixed TTSR stream interrupts to pass the matched rule name through the abort reason, so aborted in-flight tool placeholders say why they were stopped instead of `Request was aborted`.\n- Fixed URL reads for binary/special payloads to reuse local readers: remote archives list their root entries, SQLite databases show their table overview, notebooks render as editable cells, and unrenderable binary returns a metadata notice instead of decoded byte garbage.\n- Fixed pasted image-file paths that cannot be loaded to fall back to normal text paste with status feedback instead of disappearing.\n- Fixed tool-output file paths not being clickable OSC 8 `file://` hyperlinks in several renderers. `read` titles for plain text and image files (the common case) emitted no link at all because the renderer only linked when a `resolvedPath` was recorded \u2014 which the ordinary file/image read paths never set, keeping the absolute path only in `meta.source`; the renderer now falls back to that source path. `write` headers were never wrapped in a hyperlink and now link to the absolute path written (file, archive entry, SQLite, and conflict resolutions). `edit`/`apply_patch` headers wrapped the model-supplied (often cwd-relative) argument path, producing a root-anchored `file:///rel/path` URI; they now link the absolute `details.path` instead. Finally, `search`, `ast_grep`, and `ast_edit` produced doubled link targets (`/proj/src/src/file.ts`) for searches scoped to a subdirectory, because the renderer resolved the cwd-relative display paths against the scope directory rather than cwd \u2014 the scoped-search base is now the session cwd (with the scoped file's absolute path still seeding single-file body lines).\n- Fixed `omp dry-balance --bench` to recover from 401 token failures by re-minting the failing OAuth credential in place before switching accounts\n- Fixed the bash tool corrupting commands that embed multi-byte UTF-8 (e.g. `\u2713`/`\u00d7` inside a `grep -E` pattern) ahead of a trailing `| head`/`| tail`. The `bash.stripTrailingHeadTail` rewrite cut at char-offset positions reported by `brush-parser` while slicing the command by byte offset, so the trailing-pipe strip landed mid-pattern and dropped the closing quote \u2014 turning `\u2026 |\u2713|\u00d7|XCTAssert\" | tail -80` into `\u2026 |\u2713|\u00d7-80` and making execution fail with `pi-natives:command: unterminated double quote`. Fixed in `pi_shell::fixup` (`@oh-my-pi/pi-natives`).\n- Fixed `omp dry-balance --bench` to recover from 401 token failures by re-minting the failing OAuth credential in place before switching accounts\n- Fixed duplicate file entries in grouped outputs for `find`, `search`, `ast_grep`, `ast_edit`, and `lsp` diagnostics when the same path appeared multiple times\n- Fixed search, grep, and edit output rendering so repeated directory group blank-line boundaries no longer break nested path/link reconstruction\n- Fixed `omp dry-balance --bench` flooding the terminal with staircased, duplicated spinner/status lines (and an indented summary) when the tty has ONLCR/OPOST disabled (raw mode). The interactive progress region separated rows with a bare LF and repositioned with a column-preserving `\\x1b[A` cursor-up, both of which only land at column 0 when the terminal translates LF\u2192CRLF; with that translation off, every 80 ms redraw cascaded down and to the right into scrollback. The live region now carriage-returns before every cleared row, terminates each row with CRLF, and caps each row to the terminal width so a wrapped line cannot desync the cursor-up from the logical line count.\n- Fixed inconsistent vertical spacing between transcript blocks: some blocks (tool results from `search`/`find` and other renderer-backed tools) rendered with a doubled gap (a leading `Spacer` plus the content box's own `paddingY`), while others (the grouped `read` card, file-mention lists, IRC cards) rendered with no gap at all. Vertical spacing is now owned entirely by the chat renderer: `TranscriptContainer` strips each block's plain-blank top/bottom edges and inserts exactly one blank line between consecutive blocks, so every block is separated by a single consistent gap regardless of which component produced it. Individual components (assistant/user/tool/read-group/bash/eval/skill/custom/hook/compaction/branch/todo-reminder/plan-review messages) no longer emit their own leading `Spacer`/`paddingY` for separation, and multi-row groups (IRC cards, file-mention lists, completed-job batches, and the bordered command/`/changelog`/`/context`/version/OAuth/debug panels) are wrapped as single `TranscriptBlock` children so the renderer spaces them as one unit. Background-colored box padding is preserved as block-internal design.\n- Fixed `resolve` with `action: \"discard\"` surfacing a hard `isError` \"No pending action to resolve\" failure to the model when the agent asked to cancel a staged action (e.g. an `ast_edit` preview) but nothing was pending. A discard is a request to reach the \"no staged change\" end-state, which already holds in that case, so it is now honored as a successful cancellation (`\"Nothing to discard; no pending action remains.\"` with `details.action: \"discard\"`) instead of an error. `action: \"apply\"` with no pending action still errors.\n- Fixed the collapsed tool-output expand hint rendering double brackets (e.g. `((Ctrl+O for more))`) \u2014 the `EXPAND_HINT` text already carried its own parentheses and then `formatExpandHint` wrapped it again with the theme's bracket glyphs. The hint now resolves the key actually bound to `app.tools.expand` at render time and reads `\u27e8: Expand\u27e9` (e.g. `\u27e8Ctrl+O: Expand\u27e9`), so a single bracket pair surrounds it and a user remap of the expand keybinding is reflected instead of a hard-coded `Ctrl+O`.\n- Fixed the `edit`/`apply_patch` tool dropping its outlined frame while streaming/in-progress (only the final result was framed); the in-progress diff preview now renders inside the same muted frame as the completed result.\n- Fixed the `todo` and `job` tools rendering a success icon and success styling on a failed/error result; error results now show the error icon and a red frame border.\n- Fixed `debug` tool refusing every `dlv` launch on Go modules. The launch handler ran `validateLaunchProgram` before adapter selection and rejected any directory program with `launch program resolves to a directory`, while dlv's default `mode=debug` requires a Go package path (a directory or `.go` source file). Adapter resolution now precedes validation, directory programs prefer adapters that advertise `acceptsDirectoryProgram` before falling back to native extensionless debuggers, the rejection only fires when the resolved adapter does not advertise that flag (set on `dlv` in `dap/defaults.json`), and dlv's `mode` is derived from the program shape \u2014 directories and `.go` files launch as `mode=debug`, other files as `mode=exec` \u2014 so `omp` can debug both Go packages and pre-built binaries ([#2020](https://github.com/can1357/oh-my-pi/issues/2020)).\n\n## [15.10.0] - 2026-06-06\n\n### Breaking Changes\n\n- Replaced the `providers.parallelFetch` boolean setting with the `providers.fetch` enum (`auto` / `native` / `trafilatura` / `lynx` / `parallel` / `jina`) that selects the URL reader-backend priority for the `read`/`fetch` tool, mirroring `providers.image`/`providers.webSearch`. Existing configs are migrated automatically: the legacy key is dropped and the new `auto` default applies.\n\n### Added\n\n- Added a GitHub Actions read handler to the `read`/web-fetch GitHub scraper. Fetching `github.com/{owner}/{repo}/actions/runs/{id}` renders the run metadata plus a per-job breakdown (steps listed for any job that did not succeed), and `\u2026/actions/runs/{id}/job/{id}` (also the API-style `\u2026/jobs/{id}`) renders a single job's metadata, step table, and full plain-text logs. Logs are fetched via the `actions/jobs/{id}/logs` redirect using `GITHUB_TOKEN`/`GH_TOKEN` when present, with the per-line ISO timestamp prefix and leading BOM stripped; the section degrades to an explicit notice when logs are unavailable (no token, private repo, or expired/unfinalized run).\n\n### Changed\n\n- Changed eval `agent()` subagents so they are never subject to the `task.maxRuntimeMs` wall-clock cap. The parent cell's idle watchdog is already suspended for the entire bridge call (`withBridgeTimeoutPause`), so a long-running fan-out/recovery workflow must not be killed by a per-subagent runtime limit. `runEvalAgent` now passes `maxRuntimeMs: 0` to `runSubprocess`, which honors an explicit `ExecutorOptions.maxRuntimeMs` override over the inherited setting.\n- Changed interactive timing behavior so `PI_TIMING=x pi` preloads the module timer before the CLI graph loads and includes the `(modules)` report. `PI_TIMING=full` now also exits after printing, matching `PI_TIMING=x`, so full module reports are usable for cold-start measurement without launching the TUI. Added the root `dev:timing` script for the same profiled startup path.\n- Changed coding-agent startup imports so normal TUI launch imports `InteractiveMode` directly, keeps print/RPC/ACP runners on their branch-only paths, and moves marketplace auto-update work behind a lightweight deferred starter.\n- Changed cold-launch setup gating so the full setup wizard (every scene plus the overlay and their TUI/OAuth/web-search/theme dependencies) is no longer statically imported by `main.ts`. The current setup version now lives in a tiny dependency-free `modes/setup-version` module, and the wizard barrel is lazy-loaded only when the stored setup version is stale or the wizard is forced \u2014 the common up-to-date launch skips loading it entirely.\n- Changed cold-launch startup imports so the hot-path CLI files no longer pull the full `@oh-my-pi/pi-ai` barrel: `commands/launch.ts` and `cli/args.ts` import `THINKING_EFFORTS`/`Effort` from the tiny `@oh-my-pi/pi-ai/effort` module, and `config/model-registry.ts` now imports its ~20 symbols from narrow subpaths (`api-registry`, `model-cache`, `model-manager`, `model-thinking`, `models`, `provider-models`, `types`, `utils/event-stream`) instead of the barrel \u2014 so launching no longer eagerly loads every provider, auth, OAuth, and usage module re-exported by the barrel.\n- Changed the `read`/`fetch` HTML reader-backend priority to `native > trafilatura > lynx > parallel > jina` (was `parallel > jina > trafilatura > lynx > native`). The in-process native `htmlToMarkdown` runs first \u2014 instant, no network, full-fidelity \u2014 so the common case no longer depends on a remote service, and a stalled remote backend can no longer mask it. Selecting a specific backend via `providers.fetch` tries it first, then the rest fall back. The low-quality gate (`>100` chars and not `isLowQualityOutput`) now applies uniformly to every backend; when none clears it, the highest-priority substantial-but-low-quality output is still surfaced so the `llms.txt` / document-extraction fallbacks keep running.\n\n### Fixed\n\n- Fixed eval `agent()` failures surfacing as an opaque `RuntimeError: bridge call '__agent__' failed` with no reason. When a subagent aborted, `runEvalAgent` built its failure message with `result.error ?? result.stderr ?? result.abortReason ?? \u2026`, but `result.stderr` is the empty string on a clean abort (and `result.error` is gated on a non-empty `stderr`), so the nullish chain stopped at `\"\"` and never reached `abortReason`. The empty string propagated through the loopback bridge and the Python prelude's `RuntimeError(msg or \"bridge call \u2026 failed\")`, discarding the real reason. The chain now uses `||` so an empty `stderr` falls through to `abortReason`.\n- Fixed subagent aborts being mislabeled as the generic \"Cancelled by caller\" when the abort originated inside the subagent's own turn (`stopReason: \"aborted\"` with no caller signal and no runtime-limit timer). `runSubprocess` now prefers the aborted assistant message's `errorMessage` (e.g. \"Request was aborted\" or a specific stream error) for that case, while a real caller signal or wall-clock abort still reports its precise reason.\n- Fixed a long streaming tool preview that alone overflows the viewport dropping its scrolled-off head on ED3-risk terminals (ghostty/kitty/iTerm2/\u2026). When expanded with `Ctrl+O`, a streaming `write` (content streaming in) and a streaming `eval` (stdout streaming below its fixed code cell) render top-anchored and grow append-only, but the tool block never reported itself append-only to the transcript, so the renderer's commit-as-you-go boundary stopped at the block start and the earlier rows that scrolled above the viewport were committed nowhere \u2014 they vanished, leaving the preview looking like a viewport-tall circular buffer. `ToolExecutionComponent` now implements `isTranscriptBlockAppendOnly()` (gated on `isTranscriptBlockFinalized()`, so it also covers partial-result streams like `eval`), delegating to a renderer-declared `isStreamingPreviewAppendOnly` predicate so the expanded stream commits its head exactly like a streamed assistant reply. Collapsed previews (bounded sliding tail windows) and finalized/result previews (which can collapse to a capped view) stay deferred.\n- Fixed `read`/`fetch` silently dropping whole list sections on pages with malformed list markup \u2014 stray ``, text, or `` nodes as direct children of `\n` (e.g. the Alacritty changelog). The Jina reader (previously tried before the local renderers) mis-extracts such lists, returning empty `Added`/`Changed` sections; the native in-process renderer now runs first and preserves the full content.\n- Fixed `/usage` aggregate amount fallback using raw `limits.length` as account count \u2014 now counts unique `accountId` values from limit scopes, so N limits from a single account no longer display as \"N accts\".\n- Fixed `/usage` account labeling falling back to \"account N\" for providers that use `projectId` as their primary identity (e.g. Google Antigravity, Gemini CLI) \u2014 `projectId` from report metadata is now considered before the generic fallback.\n- Fixed the `todo` tool's TUI renderer crashing with `TypeError: args?.ops?.map is not a function` when a streaming tool-call delta surfaced a non-array `ops` field (mid-stream `parseStreamingJson` shapes like `{ ops: \"[{\" }`, or `[null]` entries before fields arrive). The renderer now treats non-array `ops`, non-object entries, and non-array `items` as missing structure instead of crashing, which also stops the spam-warn cascade that followed each malformed delta. Paired with the Anthropic-side reasoning-replay fix in `packages/ai` ([#2005](https://github.com/can1357/oh-my-pi/issues/2005)).\n- Fixed Python eval `agent()` collapsing subagent runtime-limit aborts (and other empty-stderr aborts) into a generic `RuntimeError: bridge call '__agent__' failed`. `runEvalAgent` coalesced the failure message with `??`, which stopped at the empty `stderr` and never reached `abortReason`, shipping an empty error through the loopback bridge. The bridge now prefers `abortReason` for aborts and trims empty `stderr`/`error` out of the fallback chain, so Python surfaces the actionable reason (e.g. `Subagent runtime limit exceeded (task.maxRuntimeMs=900000)`) ([#2006](https://github.com/can1357/oh-my-pi/issues/2006)).\n\n## [15.9.69] - 2026-06-06\n\n### Added\n\n- Added anonymous fallback for Perplexity web search, allowing `web_search` and explicit Perplexity provider usage when no Perplexity credentials are configured\n- Added `gallery` CLI command to render built-in tool renderer output across streaming, in-progress, success, and failure states\n- Added `omp gallery` filtering and rendering options (`--tool`, `--state`, `--width`, `--expanded`, and `--plain`) for focused renderer previews and plain-text output\n- Added `omp gallery` fidelity for tools whose renderers are attached on the tool instance (`lsp`, `task`): the gallery now drives them through the same custom-tool render branch production uses, so regressions in that path surface in the gallery rather than only in a live session.\n- Added `omp gallery --screenshot`, which renders the gallery through a real virtual terminal (VHS) and writes PNG screenshot(s) instead of ANSI, so agents (and anything that can only read raw bytes) can actually see the rendered output. The capture forces truecolor and matches the active theme/symbol preset; tall galleries split across multiple images (whole renderers are never cut). Tune with `--out`, `--font`, and `--font-size`; requires `vhs` on `PATH` and fails with install guidance when absent.\n- Added `app.display.reset`, bound to `Ctrl+L` by default, to force an immediate terminal display reset/redraw without resizing the window.\n\n### Changed\n\n- Changed authenticated Perplexity ask requests to default to the `experimental` model preference, matching the anonymous fallback.\n- Changed Perplexity explicit provider availability checks so the setup wizard can mark `perplexity` as available for manual selection without credentials, while auto provider discovery still requires auth\n- Changed the default persistent model selector shortcut from `Ctrl+L` to `Alt+M`, leaving `Ctrl+L` for display reset. Existing user remaps in `keybindings.yml` are preserved.\n- Changed the edit tool result header to carry the diff change stats (`+N / -M / K hunks`) inline next to the file path, and removed the redundant lone language-icon metadata row and the blank line between the header and the diff body, so a single-hunk edit renders as `\u2714 Edit:  path:LINE \u27e8+3 / 1 hunk\u27e9` immediately followed by the diff.\n- Changed the `web_search` tool result rendering: the answer text now shows in full instead of being truncated to a \"\u2026 N more lines\" preview (the `omp q` CLI still caps its compact output), each source renders as a single `title (domain) \u00b7 age` line with the URL linked on the title (dropping the snippet and bare-URL rows), and the metadata block collapses to one `Provider:  @  ()` line plus `Usage:` (removing the redundant Sources/Citations/Request/Queries rows).\n\n### Fixed\n\n- Fixed Perplexity `perplexity_ask` response parsing so OAuth, cookie, and anonymous searches correctly extract answer text and sources from JSON payloads\n- Fixed framed read results rendering with an extra blank row above and below the output block.\n- Fixed collapsed search result previews that could show only \"\u2026 N more matches\" when the first grouped section exceeded the preview budget. Collapsed search output now compacts to match rows, fills the budget with visible hits before the summary, and keeps truncation details out of the bottom user-visible notice.\n- Fixed the expanded search result view dumping every match when all hits live in one file. A single file's matches collapse into one blank-line group, and the expanded tree list ignored the line budget, so a hot file whose matches span its whole length rendered every row (e.g. lines 374\u20132858). Expanded search output is now bounded by a larger-than-collapsed budget (`EXPANDED_LINES \u00d7 2`), keeps surrounding context rows, and appends a `\u2026 N more matches` summary when truncated.\n- Fixed boolean environment flag overrides that were ORed with settings, so `PI_INTENT_TRACING=0`, `PI_AUTO_QA=0`, and per-backend eval flags now take precedence when present while falling back to config when unset.\n- Fixed custom-rendered tools that set `mergeCallAndResult` (e.g. `lsp`) rendering a redundant tool-name line above the framed result once a result arrived. `ToolExecutionComponent`'s custom-tool branch now emits the fallback label only when the tool has no `renderCall` and the call is not suppressed by an existing result, matching the built-in renderer branch.\n- Fixed the `write` tool result rendering with a green success checkmark even when the write failed. `writeToolRenderer.renderResult` now branches on `result.isError`, rendering the error status icon plus the failure message instead of the success header and content preview.\n- Fixed Perplexity OAuth/cookie web search returning a refusal answer (\"I don't currently have access to the web-search tools in this turn\") despite returning real sources. `callPerplexityOAuth` was prepending the API-style `web-search` system prompt to the query (`query_str = systemPrompt + \"\\n\\n\" + query`), but the consumer `www.perplexity.ai/rest/sse/perplexity_ask` endpoint has no system-message slot and reads the prepended instruction as a meta-prompt, making the model decline. The OAuth/cookie path now sends the bare query; the API-key path still passes the system prompt as a proper `system` message.\n- Fixed Perplexity OAuth web search always returning the free `turbo` model instead of the account's Pro model (e.g. `pplx_pro_upgraded`/Sonar). The `www.perplexity.ai/rest/sse/perplexity_ask` endpoint authenticates via the `__Secure-next-auth.session-token` cookie and ignores the `Authorization: Bearer` header entirely \u2014 so sending the OAuth session token as a bearer was treated as an anonymous request, which silently downgrades to `turbo` regardless of `model_preference`. The stored Perplexity OAuth token is itself the next-auth session JWT (the macOS app injects the same value as that cookie), so `callPerplexityAsk` now sends it as the `__Secure-next-auth.session-token` cookie, unlocking Pro model selection.\n\n## [15.9.67] - 2026-06-06\n\n### Added\n\n- Added `timeout-pause` and `timeout-resume` eval bridge status events emitted around `agent()`/`llm()` operations\n- Added a `/copy` picker: `/copy` now opens a fullscreen, outlined tree of recent assistant messages with their code blocks nested beneath (like `/tree`). Navigate with \u2191\u2193, and Enter copies the highlighted node \u2014 a whole message, an individual code block, \"All N blocks\", or a bash/eval command interleaved with the assistant turn that issued it. A live preview pane shows the selected target, wrapping prose and syntax-highlighting code/commands.\n\n### Changed\n\n- Changed eval timeout accounting so delegated bridge calls now suspend the cell watchdog and start a fresh timeout window when runtime control returns\n- Changed `IdleTimeout` to support reference-counted pauses so overlapping delegated bridge calls keep timeout paused until all calls complete\n- Changed the default `app.message.followUp` binding from `Ctrl+Enter` alone to `[Ctrl+Q, Ctrl+Enter]` so the follow-up shortcut works in Windows Terminal, which does not deliver a distinct `Ctrl+Enter` event to console apps. `Ctrl+Q` mirrors the GitHub Copilot CLI default for the same action; existing remaps in `~/.omp/agent/keybindings.yml` are untouched, and if another user-remapped action already claims `Ctrl+Q`, that user binding wins while follow-up keeps `Ctrl+Enter`. `Ctrl+Q` is also reserved by `ExtensionRunner` so an extension cannot register that chord and be silently overwritten by the built-in follow-up handler ([#1903](https://github.com/can1357/oh-my-pi/issues/1903)).\n- Changed all scrollable TUI pickers and viewports to render through the shared `ScrollView` right-edge scrollbar for a uniform look, replacing their ad-hoc `(N/M)` / `[a-b/total]` text indicators (search hints and the tree filter-mode label are preserved). Covers the session/resume picker, model selector, OAuth provider selector, history search, session tree selector, agent dashboard list, extension list, user-message selector, the raw SSE debug viewer, the autoresearch dashboard overlay, and the session observer overlay.\n- Changed the `/model` and `/switch` selectors to dim and skip models whose context windows are smaller than the current chat context.\n- Changed `/copy` command targets to appear inline with recent assistant messages instead of as a separate \"Last bash command\" row at the end of the picker.\n\n### Fixed\n\n- Fixed the idle `Working...` loader freezing on ED3-risk terminals with unobservable native scrollback by keeping foreground live-region rendering enabled from `agent_start` until `agent_end`, before the first assistant or tool event arrives.\n- Fixed framed tool output blocks rendering one column inset inside tool boxes; modern bordered blocks now span the same width as legacy background-filled tool boxes.\n- Fixed potential `TimeoutError` aborts for short `timeout` eval cells during long bridged `agent()`/`llm()` work where no progress events are emitted until completion\n- Fixed retry recovery to allow automatic retries without switching models when `retry.modelFallback` is disabled.\n- Fixed `ttsr.enabled: false` being ignored at runtime. TTSR rules were still being registered with `TtsrManager.addRule` and matched against stream deltas even when the global toggle was off, so disabling TTSR did not suppress rule injection or stream abort. The manager now gates `addRule`, `hasRules`, and `#matchBuffer` on the enabled flag, so disabling fully short-circuits the TTSR path. Condition rules fall through to the rulebook bucket instead of being silently swallowed. ([#1767](https://github.com/can1357/oh-my-pi/issues/1767))\n- Fixed the Python eval kernel hanging on Windows during `import pandas` / `import numpy`, with SIGINT unable to recover the cell. `PythonKernel.start()` spawned the runner with `windowsHide: true`, which in Bun maps to the Win32 `CREATE_NO_WINDOW` flag and detaches the long-lived child from any inherited console \u2014 so native extensions like `numpy/_core/_multiarray_umath.pyd` (and its bundled OpenBLAS/SLEEF thread-pool init) could deadlock inside `LoadLibraryExW`, and `GenerateConsoleCtrlEvent`-based SIGINT delivery silently became a no-op. The kernel now hides its window only when the host itself has no console to share (service / piped launch); an interactive TUI launch lets the kernel inherit the parent's console, matching the behavior of `python.exe` invoked from `cmd.exe` ([#1960](https://github.com/can1357/oh-my-pi/issues/1960)).\n- Fixed `task` renderer crashing the TUI with `TypeError: completeData?.map is not a function` when a subagent's `extractedToolData.yield` slot held a non-array value. `renderAgentResult` (and the live-progress sibling) cast the slot to `Array<{ data }>` and called `?.map`, but optional chaining short-circuits only on `null`/`undefined`, so a plain object made `.map` `undefined` and threw \u2014 taking down every `review` task render. Both sites now go through `normalizeYieldData`, which wraps a single object as a 1-element array and drops primitives ([#1987](https://github.com/can1357/oh-my-pi/issues/1987))\n- Fixed `sdk-async-job-manager-singleton` tests flaking under the full parallel suite. The four `createAgentSession`-based cases ran on the default 5000ms per-test timeout, which two real session startups can exceed when `test:ts` saturates the machine across packages; on timeout the still-running test body and `afterEach` reset raced, surfacing a spurious \"Unhandled error between tests\" on the `AsyncJobManager.instance()` assertion. They now carry an explicit 60000ms timeout, matching the convention used by the other session-creating tests in this suite.\n- Fixed streaming `eval`, `bash`, `ssh`, and `task` call previews overflowing the live transcript viewport and cutting off their top while pending. A volatile tool block taller than the viewport could strand its scrolled-off head out of native scrollback on ED3-risk terminals (committed nowhere, repainted nowhere) until the result landed. The pending `eval` source preview now follows the streaming edge in a bounded 12-line tail window (newest lines pinned to the bottom, \"\u2026 N earlier lines\" on top) so you can watch the code being written without the box overflowing; `bash`/`ssh` commands and `task` context use a bounded head+tail window. `Ctrl+O` still lifts the cap for a full view.\n- Fixed the streaming `write` call preview ignoring `Ctrl+O` so the expand toggle was a no-op while a file was being written. Unlike the `eval`/`bash`/`ssh`/`task` streaming previews, `formatStreamingContent` never received the `expanded` flag, leaving the preview pinned to a bounded 12-line tail window even after pressing `Ctrl+O` \u2014 so on a large write you could not widen past the streaming edge until the tool result landed. The preview now lifts the cap to the full file (head through tail) when expanded, matching the documented streaming-preview behavior of the other tools.\n- Fixed turn-ending provider errors rendering twice \u2014 once as the transcript's inline `Error: \u2026` line and again in the pinned banner above the editor (added in 15.9.5). The inline line is now suppressed while the same error is mirrored in the banner and restored to the transcript when the banner clears at the next turn, so the error stays in history without the duplicate render at the error moment.\n\n### Removed\n\n- Removed the `/copy last|code|all|cmd` subcommands; every copy target is now reachable by picking it in the `/copy` tree.\n\n## [15.9.5] - 2026-06-05\n\n### Added\n\n- Added a persistent error banner pinned above the editor when an assistant turn ends on a provider error (e.g. Anthropic's \"Output blocked by content filtering policy\"). The transcript `Error: \u2026` line scrolls away as the conversation grows, so terminal turns that ended on a stream error could pass unnoticed; the banner stays in the fixed region above the input and is cleared when the next turn starts.\n- Added bold, underlined, clickable `[Image #N]` placeholders in the draft editor and sent user-message bubbles, backed by extension-bearing blob-store sidecar files so terminal `file://` links open in image viewers.\n- Added the active model identifier (`provider/id`) to the system prompt's `` block so the agent knows which model it is running as. Gated by the new `includeModelInPrompt` setting (default on); the base prompt is rebuilt on a mid-session model switch so the surfaced identifier stays current.\n- Added `OLLAMA_HOST` support for implicit local Ollama discovery when `OLLAMA_BASE_URL` is unset, so OMP picks up the same host setting used by Ollama.\n- Added `OLLAMA_CONTEXT_LENGTH` as a positive-integer context-window override for implicit local Ollama discovery, so users can correct OMP context budgeting without writing per-model overrides.\n\n### Changed\n\n- Changed `tools.discoveryMode` to default to `auto`, which keeps discovery off for small tool sets and automatically switches to MCP-only tool discovery when more than 40 tools are registered.\n\n### Fixed\n\n- Fixed user-message rendering to materialize image links from embedded image blocks when rebuilding chat output, so image placeholders remain clickable after replayed or restored messages\n- Fixed queued/steering user messages carrying a pasted image rendering out of order \u2014 sometimes dropping the user bubble *below* the very tool output it was sent to steer. `EventController.#handleMessageStart` awaited async image-link materialization between the user `message_start` and `addMessageToChat`; since `AgentSession.#emit` dispatches TUI listeners fire-and-forget, that mid-handler yield let the next synchronously-handled events (assistant `message_start`, tool execution start/end) append their components first, scrambling transcript order and live-region block boundaries. The bubble is now appended synchronously, with clickable image links still materialized via the synchronous blob-store fallback.\n- Fixed tool execution cards to finalize promptly when a turn is abandoned or completed so stale streaming previews and frozen spinner frames no longer keep transcript rows in the live region\n- Fixed `read` and `search` TUI rendering to emit OSC 8 hyperlinks for HTTP URLs, `local://` resources backed by files, and filesystem search targets, including line-specific links for search match rows.\n- Fixed aborted streaming assistant messages staying frozen before their red \"Operation aborted\" label when status rows were appended underneath on ED3-risk terminals.\n- Fixed `omp` / `omp -c` stacking a fresh welcome screen and transcript on top of the previous run's leftover terminal scrollback. The cold-launch transcript render was the only session-load path that did not pass `clearTerminalHistory`, so the TUI's scrollback-preserving initial paint left the prior run's welcome + conversation above the new one; the cold launch now clears native scrollback before painting, matching every in-process session switch.\n- Fixed a long streamed assistant reply dropping its earlier lines on ED3-risk terminals (Ghostty/kitty/iTerm2) once it grew past the viewport \u2014 the head scrolled off the top and never reached scrollback, so the reply rendered as a ~viewport-tall circular buffer of only its latest lines. `AssistantMessageComponent` now reports itself as an append-only transcript block and `TranscriptContainer` surfaces the resulting commit-safe boundary, so the renderer commits the scrolled-off head to native scrollback instead of discarding it (volatile tool previews stay deferred as before).\n\n### Security\n\n- Blocked OSC 8 hyperlink wrapping for URI targets containing terminal control bytes to avoid rendering malformed control-sequence links\n\n## [15.9.4] - 2026-06-05\n\n### Fixed\n\n- Fixed chat transcript updates after submitting input so frozen scrollback is only thawed when native scrollback replay succeeds, preventing misplaced or duplicated rows when the viewport is not at the tail\n- Fixed `read` of `.zip` archives to list the central directory without inflating every member, so large or corrupt zip payloads no longer freeze directory reads; member contents are inflated only when a specific entry is read.\n- Fixed the Python `eval` kernel being hard-killed (and its persistent session state lost) when a cell blocked in `parallel()` / `agent()` was interrupted. Each `agent()`/`tool.*` call blocks a kernel worker thread in a synchronous `urllib` request to the host bridge, and `parallel()`'s `ThreadPoolExecutor` exit joins those threads \u2014 so the kernel cannot unwind a `KeyboardInterrupt` until every in-flight bridge call returns. A wide subagent fan-out's teardown routinely outlasted the kernel's 5s SIGINT-escalation window, so the kernel was force-killed (surfacing `[kernel] Python kernel shutdown`) while the subagents were still winding down. The host bridge now resolves an in-flight call the instant the cell's signal aborts, so the kernel unwinds cleanly and keeps its state; the already-signaled subagent continues tearing down in the background.\n- Fixed `github` tool `run_watch` op ignoring the explicit `repo` argument and silently watching the cwd-inferred repository in nested/umbrella workspaces. `executeRunWatch` passed `undefined` for the user-supplied `repo` to `resolveGitHubRepo`, so a call like `{op: \"run_watch\", repo: \"owner/cxf\", branch: \"main\"}` fell back to `gh repo view` in cwd and streamed `watching  on ` against the wrong repository. The explicit `repo` now takes precedence over the cwd inference, and the no-`branch`/no-`run` path refuses to derive the watched commit from `git HEAD` unless the cwd actually points at the resolved repo \u2014 otherwise it raises a `ToolError` telling the caller to pass `branch` or `run` instead of silently rebinding to an unrelated commit ([#1949](https://github.com/can1357/oh-my-pi/issues/1949)).\n- Fixed `omp plugin install ` failing with `Invalid package name: .` (and similar) for cwd-relative (`.`, `./pkg`), absolute (`/abs`, `C:\\\u2026`, `\\\\unc`), and tilde-prefixed (`~/pkg`) specs. `classifyInstallTarget` now returns a `local` arm in addition to `marketplace`/`npm`, and `plugin install` routes those specs to `PluginManager.link()` \u2014 the same code path as `omp plugin link`. ([#1945](https://github.com/can1357/oh-my-pi/issues/1945))\n- Fixed the `web_search` result renderer capping the synthesized answer at 12 lines even when expanded, while the Sources list expanded in full \u2014 so a long answer stayed truncated (\"\u2026 N more lines\") after `Ctrl+O`, making the expand toggle look like a no-op and dwarfing the answer next to its sources. The answer now renders the full text (markdown-formatted) when expanded and a short markdown preview when collapsed, matching the sources' collapse/expand behavior. The answer is also rendered through the Markdown component instead of dimmed raw lines, so headings, bold, lists, and code in the answer display formatted.\n\n## [15.9.3] - 2026-06-05\n\n### Fixed\n\n- Fixed `@`-mention auto-read injecting an unrelated, same-named file when a mention did not point at a real path \u2014 e.g. an npm scope like `@scope/`, a partial path, or a bare token. `generateFileMentionMessages` resolution previously fell back to prefix and repo-wide fuzzy matching (globbing the whole project on every such mention) and auto-read the single \"best\" guess. Resolution is now exact-only: a mention is auto-read only when it resolves to an existing file or directory; otherwise it is left as prose. The TUI `@`-selector already inserts the real, complete path before send, so post-send guessing was both unnecessary and the source of the wrong-file reads. Directories still resolve and are listed. Removes the per-mention `**/*` project scan.\n\n## [15.9.2] - 2026-06-05\n\n### Added\n\n- Added an encrypted local auth-broker snapshot cache for `discoverAuthStorage`, with `OMP_AUTH_BROKER_SNAPSHOT_TTL_MS` and `OMP_AUTH_BROKER_SNAPSHOT_CACHE`, so fresh cached broker credentials can boot without a blocking `/v1/snapshot` fetch and survive broker-down startup windows.\n- Added `dry-balance` CLI command to perform a dry-run OAuth account balancing check across configurable random session IDs, with sample and concurrency options, JSON output, and success/failure summary reporting\n- Added `--json` output mode and machine-readable result format to `omp dry-balance` for automated use\n- Added `omitMaxOutputTokens` to `models.yml` model definitions and `modelOverrides`, so users can opt a model out of the on-the-wire `max_output_tokens` / `max_tokens` cap while keeping the catalog `maxTokens` for local budgeting. Intended for Ollama-style proxies whose upstream output limit OMP cannot discover. ([#1881](https://github.com/can1357/oh-my-pi/issues/1881))\n\n### Fixed\n\n- Fixed TTSR rule-violation injections leaking the absolute home directory to the model: the `ttsr-interrupt` / `ttsr-tool-reminder` blocks rendered the matched rule's `path` as its absolute on-disk path (e.g. `/Users/me/Projects/app/.omp/rules/no-any.md`). The path is now relativized to the session cwd when the rule lives in the project (`.omp/rules/no-any.md`), or `~`-relative when it lives under home, so no absolute path is fed into the agent's context outside the system prompt.\n- Fixed `AsyncJobManager.instance()` being cleared while the owning top-level session was still live, which broke the `task` async path with \"Async execution is enabled but no async job manager is available\" until process restart. Any in-process secondary top-level `createAgentSession()` call (e.g. the Agent Control Center's create flow in `agent-dashboard.ts`) constructed a fresh `AsyncJobManager`, overwrote the singleton, and then cleared it on its own dispose. Secondary sessions now leave the live singleton untouched, and their dispose-time cleanup is scoped so it can no longer cancel the primary session's running bash/task jobs. `bash` / `task` / `job` tools and session job snapshots now resolve the manager through session-scoped async manager wiring rather than `AsyncJobManager.instance()`, so a secondary in-process top-level session cannot accidentally register background work on the owning session's manager or report the owning session's jobs; subagents still inherit the parent's manager via their scoped async manager. Startup failures after a top-level session installs its manager now clear and dispose that manager before the next session decides whether it can create its own ([#1923](https://github.com/can1357/oh-my-pi/issues/1923)).\n- Fixed the `task` tool returning a hard `Async execution is enabled but no async job manager is available.` error when `async.enabled` was true but `AsyncJobManager.instance()` returned `undefined`, leaving `task` non-functional for the rest of the session. The tool now falls back to the existing synchronous execution path (which still runs subagents concurrently via `mapWithConcurrencyLimit`), and logs a warning so the missing-manager state stays diagnosable ([#1922](https://github.com/can1357/oh-my-pi/issues/1922)).\n- Fixed Hindsight retain/recall/reflect calls staying pinned to the bank that was selected when the session started after the operator edited `hindsight.bankId`, `hindsight.bankIdPrefix`, or `hindsight.scoping` mid-session. The backend now subscribes to those settings via `onHindsightScopeChanged` and rebuilds the active `HindsightSessionState` against the recomputed scope, disposing the old state after flushing its queue so in-flight tool-initiated retains still land in the bank they were enqueued for. Also renamed `ensureBankMission` to `ensureBankExists` so a blank `bankMission` no longer skips bank creation entirely, and called it before mental-model bootstrap so `createMentalModel` is never the first POST against a missing bank. `AgentSession.dispose` now flushes the retain queue before clearing `#hindsightSessionState`, since the queue's identity guard would otherwise drop the spliced batch ([#1902](https://github.com/can1357/oh-my-pi/issues/1902)).\n- Fixed `/tree` rendering a bare \"No entries found\" line on a fresh session where the only persisted entries are the `model_change` + `thinking_level_change` written by `sdk.ts` at startup \u2014 both are hidden by the tree-selector's default filter, so `#filteredNodes.length === 0` while `tree.length === 2` and the controller's `tree.length === 0` short-circuit never fired. The selector now splits the empty-state into three distinct shapes \u2014 truly empty tree, search query with no matches, and filter mode rejecting every entry \u2014 surfacing the cause and the recovery key (`Alt+A` to show all, `Backspace` to clear a stale search) so users on a fresh session can see immediately that the panel isn't broken ([#1909](https://github.com/can1357/oh-my-pi/issues/1909)).\n- Fixed remote MCP OAuth refresh failures leaving stale credentials in `agent.db`: when the token endpoint returns a definitive failure (`invalid_grant`, `invalid_token`, `revoked`, plain 401/403 not classified as transient), `MCPManager#resolveAuthConfig` now drops the credential via `AuthStorage.remove(credentialId)` and skips re-attaching the dead `Authorization: Bearer \u2026` header. Previously a revoked refresh token kept producing `401 invalid_token` on every MCP request and survived restarts, so users had to hand-clear the credential row to recover; the next connect now surfaces a clean auth error and `/mcp reauth ` (or `/mcp unauth`) recovers without restarting. Transient refresh failures (network/`fetch failed`/`ECONNREFUSED`) still fall back to the existing access token ([#1908](https://github.com/can1357/oh-my-pi/issues/1908)).\n- Fixed `omp://docs` and `omp://docs/...` internal documentation URLs in the distributed package to resolve through the embedded documentation index instead of failing with `Documentation file not found` ([#1898](https://github.com/can1357/oh-my-pi/issues/1898)).\n- Fixed the `github` discovery provider silently ignoring `.github/skills//SKILL.md`, GitHub's documented Agent Skills layout. The provider now registers a `skills` capability (priority 30, project-only) that scans `.github/skills/` non-recursively via `scanSkillsFromDir` with `requireDescription: true`, matching the Agent Skills spec and the sibling `native`/`omp-plugins` providers ([#1906](https://github.com/can1357/oh-my-pi/issues/1906)).\n- Fixed inline images rendering as a wall of empty PUA box glyphs with laggy scrolling on Kitty-protocol terminals that do not honor Unicode placeholders (most notably WezTerm and tmux/screen passthrough to a non-Kitty outer terminal). The 15.9 placeholder rollout enabled the `U=1`/U+10EEEE grid for every Kitty-protocol path; it now defaults on only for `kitty` and `ghostty`, with `PI_NO_KITTY_PLACEHOLDERS=1` as a hard opt-out and `PI_KITTY_PLACEHOLDERS=1` as opt-in for terminals (e.g. wezterm nightlies) that have since added support ([#1877](https://github.com/can1357/oh-my-pi/issues/1877)).\n- Fixed auto session-title generation failures being swallowed without an actionable diagnostic. Title generation now logs structured start, missing-model/API-key, provider-error, empty-result, and exception outcomes with the session id and resolved title model; the interactive auto-title caller also logs uncaught persistence/generation errors instead of dropping them. ([#1892](https://github.com/can1357/oh-my-pi/issues/1892))\n- Fixed `TranscriptContainer` reporting the live block boundary to the TUI again, so ED3-risk foreground streaming can append newly sealed transcript blocks to native scrollback once while deferring only the active live block.\n\n## [15.9.1] - 2026-06-04\n\n### Added\n\n- Added deferred session-title generation so greetings no longer become the session title. A first user message that is only a greeting / acknowledgement / filler (\"hi\", \"thanks\", \"ok\", a bare number, emoji-only, etc.) is now detected deterministically and skips titling entirely \u2014 no title model is invoked. Title generation then retries on each subsequent user message while the session stays unnamed, so the title is deduced from the first message that actually describes work. A capable online title model may additionally answer `none` to decline a non-greeting taskless message (normalized to \"no title\").\n\n### Changed\n\n- Changed mid-turn user steers to reach the model inside a wire-only interjection envelope, while transcripts and persisted session history keep the user's original text.\n- Changed the system prompt to treat user requests for parallel work as `task` subagent fan-out rather than parallel tool calls.\n- Changed the Agent Control Center's new-agent description field to use the multiline TUI editor, with Enter inserting lines and Ctrl+Enter generating the spec.\n- Changed the Agent Control Center and Extension Control Center to accept Left/Right arrow keys for switching tabs (source / provider), in addition to Tab / Shift+Tab \u2014 matching the model and settings selectors, whose `TabBar` already supported arrow navigation.\n- Refreshed the Ctrl+R history search overlay: the selected row now renders as a full-width `selectedBg` highlight bar, matched query tokens are highlighted in the accent color, each result shows a right-aligned relative timestamp, and the panel gained an icon'd accent title plus a two-tone keyhint footer. The selector also gained PageUp/PageDown (via the configurable `tui.select.pageUp`/`pageDown` keybindings) and Home/End navigation.\n- Changed Perplexity API-key web search to return more comprehensive results: `web_search_options.search_context_size` is now `high` (was `medium`) for maximum retrieval grounding, the default `num_search_results` is `20` (was `10`) so twice as many sources are surfaced, and `return_related_questions` is enabled with the response's `related_questions` now parsed into `relatedQuestions` (previously dropped). On an identical query this lifted the result from 10 sources / ~410 output tokens to 20 sources / ~1900 output tokens with a structured, multi-section answer; latency tracks model output length, not context size, so the 60s hard timeout headroom is unchanged.\n\n### Fixed\n\n- Fixed a streamed assistant message freezing at a partial prefix (e.g. only \"Nat\" of \"Natives built, now\u2026\") on ED3-risk terminals (Ghostty/kitty/iTerm2/Alacritty), with the final text appearing only after a resize. `TranscriptContainer` freezes each non-live block by replaying its last live render, but render coalescing can finalize a block's content and append the next block within the same throttled frame \u2014 so the block was sealed at its stale mid-stream snapshot and never repainted until the next `thaw`. The block that was live on the previous render is now recomputed once on the live\u2192frozen transition, sealing it at its final content.\n- Fixed ACP/RPC stdio startup so protocol frames are no longer consumed as one-shot piped prompt input before the JSON-RPC transport starts.\n- Fixed `omp completions` to await the completion script write before exiting.\n- Fixed `AssistantMessageComponent` exposing its stable-prefix completion API again so streamed assistant messages remain unstable until explicitly completed.\n- Fixed session restoration to ignore transient fallback model switches (such as automatic context-promotion or retry fallback) so resumed or resumed-switch sessions revert to the configured default model unless the last change was a user-selected temporary model\n- Fixed in-session `/resume` to restore both the last user-selected temporary model and persisted plan/goal mode state instead of falling back to the default model with plan mode off.\n- Fixed the `/resume` session picker overflowing short viewports: the visible window was hardcoded to 5 entries (and assumed 3 lines each), but titled sessions render 4 lines, so on a typical-height terminal the picker's header and search box scrolled off the top and the first entry was hidden until you scrolled the terminal up. The visible-entry count is now derived from the live terminal height (budgeting the worst-case 4-line titled entry plus the picker's chrome), so the whole picker fits the viewport and grows on taller terminals.\n- Fixed the Agent Control Center and Extension Control Center dashboards overflowing the terminal: they were mounted inline below the chat transcript, so the combined height exceeded the viewport \u2014 the tab bar and controls scrolled off the top into native scrollback, and every state change yanked the view back to the bottom. Both dashboards now render as full-screen overlays sized to the live terminal height (`process.stdout.rows`), re-fit on resize, fill the viewport, and reserve space for the footer keyhints so the controls stay visible.\n- Fixed Ctrl+R history search results to remain globally sorted by prompt recency after merging FTS prefix matches with substring fallback matches.\n- Fixed Exa web search with no stored or environment credential to use the public Exa MCP fallback again, preserving the auth storage \u2192 `EXA_API_KEY` \u2192 `mcp.exa.ai` resolution order ([#1860](https://github.com/can1357/oh-my-pi/issues/1860)).\n- Fixed ACP plan-mode writes to `local://PLAN.md` so session-local plan artifacts are written to OMP's local artifact root instead of being routed through the editor `writeTextFile` bridge, avoiding Zen's `Internal error` and making the plan readable after creation ([#1863](https://github.com/can1357/oh-my-pi/issues/1863)).\n- Fixed ACP plan mode stranding the agent at plan approval: entering `mode: \"plan\"` now registers a standing `resolve` handler so the agent's `resolve { action: \"apply\" }` no longer fails with `No pending action to resolve. Nothing to apply or discard.` The handler validates the plan file, asks the ACP client to confirm via `unstable_createElicitation` when the client supports forms, renames the approved plan to `local://.md`, and exits plan mode so the agent regains write tools for execution ([#1869](https://github.com/can1357/oh-my-pi/issues/1869)).\n- Fixed `provider.appendOnlyContext: \"auto\"` staying inactive for Xiaomi Token Plan/SGLang endpoints, preserving prefix-cache hits without forcing append-only mode globally ([#1851](https://github.com/can1357/oh-my-pi/issues/1851)).\n- Fixed `models.yml` compatibility parsing to preserve `compat.cacheControlFormat: \"anthropic\"` for custom OpenAI-compatible Claude proxies. ([#1845](https://github.com/can1357/oh-my-pi/issues/1845))\n- Fixed the TUI's `Settings \u2192 Plugins` panel reporting \"No plugins installed\" when only marketplace plugins were installed. The panel now merges `PluginManager.list()` with `MarketplaceManager.listInstalledPlugins()` \u2014 the same data source the `/plugins list` slash command and `omp plugin list` CLI already used \u2014 and tags each row with an `[npm]` / `[marketplace]` kind badge, a scope tag, and a shadow indicator for project-shadowed user installs. Selecting a marketplace row opens a new `MarketplacePluginDetailComponent` whose single `Enabled` toggle calls `MarketplaceManager.setPluginEnabled(pluginId, enabled, scope)`, with read-only metadata (version, install path, installed-at, last-updated, git commit SHA) listed below the toggle. The empty-state now lists both install commands (`omp plugin install ` and `omp plugin install @`) ([#1842](https://github.com/can1357/oh-my-pi/issues/1842)).\n- Fixed scoped mnemopi recall in `MnemopiSessionState.collectScopedRecallResults`/`recallResultsScoped` to await the async `Mnemopi.recallEnhanced` so the new auto-derived `queryEmbedding` flows through. Without this, the embedding-enabled mnemopi backend silently kept running FTS-only on every recall. ([#1832](https://github.com/can1357/oh-my-pi/issues/1832))\n- Fixed the SSH tool renderer inlining multiline remote commands into its single-line status header, which produced a malformed cell where the bordered output block opened mid-command. The renderer now drops the command from the header (which keeps only `[host]`) and renders the full command in a framed section above `Output`, mirroring the bash renderer. `renderStatusLine` also flattens any embedded CR/LF in `description`, `meta`, and `title` so no tool can accidentally expand the header into multiple rows ([#1828](https://github.com/can1357/oh-my-pi/issues/1828)).\n- Fixed `tsc --noEmit` against `packages/coding-agent/tsconfig.json` reporting 56 errors under TypeScript 5.x (`builtin-registry.ts` \u00d7 46, `agent-session-openai-responses-replay.test.ts` \u00d7 10). The repo's own gate (`tsgo` / TypeScript 6.x) already accepted the `() => void` slash-command handlers, but 5.x rejects them because it does not coerce a `void`-returning function value into a `() => T | undefined` slot. The `SlashCommandSpec.handle` / `handleTui` signatures and the test's `createPersistedSession` `populate` callback are now expressed as a union of two function types (one returning a `SlashCommandResult` / target, one returning `void`), so the existing handler bodies typecheck on both compilers ([#1821](https://github.com/can1357/oh-my-pi/issues/1821)).\n- Fixed `omp update` leaving `@oh-my-pi/pi-natives` and the platform-specific `@oh-my-pi/pi-natives-` leaf at the previous version on `bun install -g` updates, so the next launch loaded a stale `.node` file and aborted at `validateLoadedBindings` with `The .node file on disk is from a different release than this loader`. `omp update` now pins the native addon core and the platform leaf to the same version it installs for `@oh-my-pi/pi-coding-agent` ([#1824](https://github.com/can1357/oh-my-pi/issues/1824)).\n\n## [15.9.0] - 2026-06-04\n\n### Breaking Changes\n\n- Removed synchronous `readTextSync` from `SessionStorage` and core implementations (`MemorySessionStorage`, `FileSessionStorage`, `RedisSessionStorage`, `SqlSessionStorage`), requiring callers to use async text reads\n- Replaced the public `SessionStorage` `readTextPrefix(path, maxBytes)` and `readTextSuffix(path, maxBytes)` methods with `readTextSlices(path, prefixBytes, suffixBytes): Promise<[string, string]>`; custom session storage backends must implement the new combined slice API.\n\n### Added\n\n- Added env-driven OpenTelemetry trace export. When `OTEL_EXPORTER_OTLP_ENDPOINT` (or `OTEL_EXPORTER_OTLP_TRACES_ENDPOINT`) is set, `omp` registers a global OTLP/proto trace exporter and switches on the agent loop's telemetry, so the `invoke_agent` / `chat` / `execute_tool` spans actually reach a collector instead of a no-op tracer. Honors the standard `OTEL_*` env contract (endpoint, headers, `OTEL_SERVICE_NAME`, `OTEL_SDK_DISABLED` and `OTEL_TRACES_EXPORTER=none` parsed case-insensitively) and the `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT` capture toggle; it is a no-op when no endpoint is configured. Only the `http/protobuf` transport is supported \u2014 a `grpc` or `http/json` `OTEL_EXPORTER_OTLP*_PROTOCOL` declines rather than misrouting spans. This makes the existing telemetry usable from headless hosts that run `omp` as a spawned child process, where an in-process `TracerProvider` registered by the parent can't reach the child. Uses the `@opentelemetry/exporter-trace-otlp-proto` 2.x line, which exports cleanly under Bun.\n## Fixed\n- Fixed the status line session name (and the editor border / status-line gap fill) being nearly illegible on light themes.\n- Added `IndexedSessionStorage` and `SessionStorageBackend` exports to support shared metadata-indexed session backends\n- Added the `tui.maxInlineImages` setting (default `8`) capping how many inline images render as live terminal graphics. Once a new image pushes the count past the cap, the oldest images are hidden via a full redraw \u2014 replaced by their `[Image: \u2026]` text placeholder and purged from the terminal's graphics store \u2014 so long sessions with many screenshots/diagrams stop piling up images (and, on Kitty, stop leaving scrollback ghosts). Set to `0` to keep every image inline.\n- Added a \"View: terminal state\" item to the `/debug` menu that prints the detected terminal, live geometry and cell size, multiplexer, and the negotiated subprotocols actually in use \u2014 graphics (Kitty/iTerm2/Sixel), desktop notifications (BEL/OSC 9/OSC 99, plus whether OSC 99 was confirmed via a device-attributes probe), OSC 8 hyperlinks, 24-bit color, DECCARA rectangular-SGR background fills, and DEC 2026 synchronized output \u2014 alongside the scrollback-clear strategy (`CSI 22 J` vs `CSI 2 J` redraw / ED3 eager-erase risk) and the raw `TERM`/`TERM_PROGRAM`/`COLORTERM` detection signals.\n- Added a \"Test: terminal protocols\" item to the `/debug` menu that renders one live sample of every special escape protocol the renderer can emit \u2014 SGR text attributes (bold/italic/underline/strikethrough/inverse/dim), themed and 24-bit truecolor, OSC 8 hyperlinks, OSC 66 text sizing (large text), and an inline graphics swatch via the active image protocol (Kitty/iTerm2/Sixel, with a text fallback) \u2014 and fires a desktop notification, so you can eyeball which protocols the current terminal actually honors. The sample image is a gradient PNG generated in-process, so the graphics test needs no asset on disk.\n- Added the `tui.textSizing` setting (default off) that renders Markdown H1 headings at 2x scale via Kitty's OSC 66 text-sizing protocol. It replaces the undocumented `PI_TUI_TEXT_SIZING` env var with a real setting, and only takes effect on Kitty terminals (where OSC 66 is implemented) \u2014 it is ignored everywhere else so headings never emit raw escape bytes.\n- Added a lifecycle status to the `/resume` session picker. Each session's tail (last 32 KiB) is now read alongside the existing header window in a single pass, and its final message classified as `done` (the agent ended its turn and yielded control back), `interrupted` (a trailing tool call or tool result the loop never continued from), `aborted`, `error`, or `pending` (a trailing user message with no reply). The status renders as a colored segment on each session's metadata line. When the final message is larger than the tail window the status is omitted rather than guessed.\n- Added support for `disable-model-invocation: true` frontmatter field from the [Agent Skills standard](https://agentskills.io/specification). Skills using this field are now hidden from the system prompt listing, matching the behavior of `hide: true`.\n\n### Changed\n\n- Changed the `task` tool description to tag read-only agents and explicitly forbid assigning them file edits/commands or offloading reasoning to `quick_task`/`explore`.\n- Changed Redis and SQL session storage initialization to load only indexed metadata (`size`, `mtimeMs`) instead of full session content\n- Changed `SessionStorage` read paths to rely on backend-backed metadata/indexed storage, so session content is fetched on demand rather than cached as full in-memory mirrors\n- Changed session-list slice reads to go through `SessionStorage.readTextSlices` across all backends, removing the file-only single-open branch and caller-managed buffers. `FileSessionStorage` now reads both windows via `peekFileEnds`, while Redis and SQL backends encode session content once per combined read.\n- Changed the `ask` tool transcript renderer to mark single-choice questions with circular radio glyphs (`\u25cb`/`\u25c9`) instead of the rectangular checkbox glyphs (`\u2610`/`\u2611`) it shares with multi-select questions, so a \"pick one\" combo box visually reads as a radio group rather than a checklist. Multi-select questions keep checkboxes. Added a `radio.selected`/`radio.unselected` symbol pair across the unicode, nerd-font, and ASCII presets.\n- Changed the `ask` tool transcript renderer to mark the chosen answer inside the question form rather than re-listing the questions in a detached summary block below it. Once a question is answered, the standalone prompt preview is dropped and the result redraws the same form \u2014 every offered option still shown, with the selected one(s) filled in (`\u25c9`/`\u2611`, highlighted) and the rest dimmed (`\u25cb`/`\u2610`); custom free-text answers and cancellations render in place as the final entry. This removes the duplicate question/option listing that previously appeared once as the call preview and again as the result.\n- Changed task-completion and `ask` desktop notifications to structured terminal notifications (title, body, type, and a focus-on-click action). On Kitty these render through OSC 99 as a proper title/body with click-to-focus; terminals without confirmed OSC 99 support collapse them to the previous single-line message (BEL/OSC 9).\n- Updated the \"each kitty/tmux split\" tip to include cmux.\n\n### Fixed\n\n- Fixed tiny-model startup in compiled binaries by resolving `@huggingface/transformers` and its runtime dependencies from the installed cache using `package.json` `exports`/`main` metadata, preventing module-resolution failures when launching models\n- Fixed tiny runtime installation flow in compiled binaries by using the build-time resolved `@huggingface/transformers` version and ensuring the runtime lock directory\u2019s parent exists before acquiring the install lock, preventing mismatch and setup failures on fresh installs\n- Fixed the terminal protocol debug probe reusing one stable Kitty graphics id across repeated panels, which could move/replace an earlier swatch instead of rendering a new one.\n- Fixed selector dialogs (the `ask` tool, hook prompts) collapsing to a single visible option on shorter terminals when options carried long descriptions: the highlighted option's wrapped description consumed the entire row budget, hiding every other option and making the menu feel unnavigable (down moved the lone visible entry, left/right did nothing). When the fully-expanded list overflows, `HookSelectorComponent` now renders a compact list \u2014 every option label stays on screen and only the highlighted option expands its description, truncated to the remaining rows \u2014 so the whole menu is always visible and the detail pane follows the cursor.\n- Fixed `read` failing with \"Path not found\" on web URLs whose scheme `//` collapsed to a single `/` (e.g. `https:/github.com/...`), which happens when a URL is routed through Node's `path.normalize`/`path.resolve`. The fetch URL recognizer now accepts a single-slash scheme and repairs it back to `//` before fetching, so collapsed URLs resolve instead of falling through to filesystem lookup.\n- Fixed subagent slow-model priority falling through to older Claude Opus aliases when Opus 4.8 is available by adding Opus 4.8 and 4.7 aliases ahead of older Opus fallbacks ([#1753](https://github.com/can1357/oh-my-pi/issues/1753)).\n- Fixed the web-search provider selectors in TUI settings/setup to derive from the shared provider metadata, so newly added providers cannot be omitted from the preference list.\n\n## [15.8.3] - 2026-06-03\n\n### Fixed\n\n- Fixed Jujutsu workspace detection failing in non-default workspaces created by `jj workspace add`, whose `.jj/repo` is a FILE pointing at the shared repo dir rather than a directory. Detection now matches jj's own criterion (`.jj/repo` present, file or dir) instead of requiring a `.jj/repo/store` directory, and `jj.repo.resolve`'s `storeDir` follows the file indirection to the shared store.\n\n### Changed\n\n- Changed the `todo-write` prompt to require initializing every item from a user-supplied multi-step plan as an individual todo task before execution\n- Changed context compaction (prune/shake) to protect reads of the active plan file the same way it already protects `skill://` reads, so the plan stays intact through automatic and manual compaction. Both the canonical `local://PLAN.md` alias and the session's current plan reference path (e.g. a titled `local://.md` after approval) are kept, tolerating read selectors and `local:/` scheme spelling.\n\n## [15.8.2] - 2026-06-03\n\n### Added\n\n- Added a bundled TypeScript rule that warns against leaving `@deprecated` compatibility shims behind instead of finishing a refactor.\n\n### Fixed\n\n- Fixed `/review`'s uncommitted-change mode in Jujutsu repositories to read `jj diff --git` from the current workspace, so non-default JJ workspaces include their working-copy changes instead of falling back to the colocated Git checkout.\n- Fixed empty assistant stop retry continuations preserving auto-retry state until a non-empty assistant turn completes or recovery reaches its retry cap.\n- Fixed TTSR rule conditions never matching streamed `edit`/`write` tool calls whose wire format obscures the real content (hashline `+` body rows, apply_patch envelopes, JSON-escaped `write` content). The edit and write tools now expose a `matcherDigest` normalization and TTSR matches against the introduced source text, so rule regexes stay universal regardless of the active edit mode.\n\n### Changed\n\n- Changed the JJ utility API to mirror Git's scoped helpers: repository operations now live under `jj.repo` (`root`, `resolve`, `is`, `clearRootCache`), and diff file listing is available as `jj.diff.changedFiles`.\n- Changed the `search_tool_bm25` tool description to name the hidden discoverable built-in tools (e.g. `write`, `find`, `search`, `lsp`, `task`) when `tools.discoveryMode: \"all\"` is active, so a model can form a targeted discovery query by name instead of guessing or falling back to shell. `mcp-only` mode is unchanged (no built-ins are advertised) and the `Total discoverable tools available: N` count still includes them.\n\n## [15.8.1] - 2026-06-02\n\n### Fixed\n\n- Fixed an unhandled `EPIPE` rejection when an MCP stdio server exits between returning the `initialize` response and the client's `notifications/initialized` send. `StdioTransport.notify()` and `#sendResponse()` now route stdin writes through a shared helper that catches synchronous sink failures: `notify()` tears the transport down (firing `onClose`) and surfaces a `Transport closed while sending notification` rejection so `connectToServer()` treats the handshake as a failed connection instead of returning a \"connected\" handle wrapping a dead transport; `#sendResponse()` stays silent because a dead subprocess has no use for the response. `StdioTransport.close()` is now the authoritative resource teardown \u2014 it no longer early-returns when `#handleClose()` has already flipped `#connected`, so the subprocess and read loop are always cleaned up (including in the `connectToServer()` failure path) ([#1710](https://github.com/can1357/oh-my-pi/issues/1710)).\n- Fixed startup model resolution ignoring cached discovery rows for special built-in providers (`google-antigravity`, `google-gemini-cli`, `openai-codex`) until the background refresh completed ([#1721](https://github.com/can1357/oh-my-pi/issues/1721)).\n- Fixed Windows clipboard-image paste keeping `Ctrl+V` unregistered by default. The TUI now registers `Ctrl+V` plus the Windows Terminal-safe `Alt+V` fallback, and the keybinding docs call out when to use the fallback ([#1708](https://github.com/can1357/oh-my-pi/issues/1708)).\n\n## [15.8.0] - 2026-06-02\n\n### Added\n\n- Added an all-projects scope to the session picker (`pi --resume` / `/resume`). Press `Tab` to toggle between the current folder's sessions and every session across all projects; the all-projects list is loaded lazily and shows each session's directory. When the current folder has no sessions the picker now opens straight into all-projects scope instead of printing \"No sessions found\".\n- Migrated the Kagi web search provider to Kagi's V1 Search API (`POST /api/v1/search`), replacing the sunset V0 endpoint while keeping the `kagi` provider id, `KAGI_API_KEY` credential, and `/login kagi` flow unchanged ([#1272](https://github.com/can1357/oh-my-pi/pull/1272) by [@thismat](https://github.com/thismat))\n- Added Anthropic `anthropic-ratelimit-unified-*` response-header warming for `/usage` and the status-line usage segment, throttled to reduce direct OAuth `/usage` probes during active use.\n\n### Changed\n\n- Changed Anthropic API request metadata `user_id.device_id` to be derived from the persistent install ID so it remains stable across Anthropic account changes on the same install\n- Changed the eval `parallel()` / `pipeline()` helpers to drop their `concurrency` argument and run as wide as a `task` tool batch. The worker-pool ceiling now tracks the `task.maxConcurrency` setting (default 32; `0` = run every item at once) resolved live from the host via a new `__concurrency__` bridge, instead of the old per-call `concurrency` option that defaulted to 4 and capped at 16. This stops eval fan-outs from under-using the parallelism the session is configured for.\n- Changed subagent / `agent://` output ids from a numeric prefix scheme (`0-Anna`, `1-Bob`, nested `0-Anna.1-Bob`) to a name-first scheme: the requested name is used verbatim and a `-2`/`-3`/\u2026 suffix is added only when the same name recurs within a session (`Anna`, `Anna-2`, `Anna-3`). Nested ids stay grouped under the parent (`Anna.Bob`) and the live task widget renders them as `Anna>Bob`. The main agent's IRC id is now `Main` (was `0-Main`). `AgentOutputManager` still scans existing `.md` outputs on resume so it never reuses a name that would clobber a prior output.\n- Changed resuming a session that belongs to a different project to switch the process into that project's working directory. `pi --resume` and the in-session `/resume` picker now `chdir` into the resumed session's `cwd` and re-scope every cwd-derived input \u2014 project dir, **project settings** (`.claude/settings.yml`, `.omp/settings.json`, path-scoped `enabledModels`/`disabledProviders`), plugin roots, capabilities, slash commands, and the ssh tool \u2014 so tools, discovery, configuration, and commands all follow the resumed project. The `SessionManager` adopts the resumed session's own `cwd`/session directory on load (rolled back if the switch fails).\n- Documented `ANTHROPIC_SEARCH_API_KEY` and `ANTHROPIC_SEARCH_BASE_URL` more thoroughly in `docs/environment-variables.md`, surfaced them in `docs/tools/web_search.md`'s Anthropic provider section, and added `ANTHROPIC_SEARCH_BASE_URL` to `omp --help`'s env-var summary so the search-only overrides are discoverable alongside `ANTHROPIC_SEARCH_API_KEY` ([#1694](https://github.com/can1357/oh-my-pi/issues/1694)).\n- Migrated the Kagi web search provider to Kagi's V1 Search API (`POST /api/v1/search`), replacing the sunset V0 endpoint while keeping the `kagi` provider id, `KAGI_API_KEY` credential, and `/login kagi` flow unchanged ([#1272](https://github.com/can1357/oh-my-pi/pull/1272) by [@thismat](https://github.com/thismat))\n\n### Fixed\n\n- Fixed `read`, `search`, `find`, `ast_grep`, and `ast_edit` recovering when a model flattens multiple existing paths into one comma-, semicolon-, or space-delimited string while preserving real paths that contain delimiters.\n- Fixed Exa web search reporting available without Exa credentials, which could route searches into the unauthenticated public MCP fallback and stall before trying the next provider. Availability and `searchExa()` now resolve through the standard `AuthStorage` cascade (`EXA_API_KEY` env or stored credential) ([#1695](https://github.com/can1357/oh-my-pi/issues/1695)).\n- Fixed Anthropic web search ignoring `ANTHROPIC_SEARCH_BASE_URL` when credentials came from stored Anthropic auth or generic Anthropic env fallback rather than `ANTHROPIC_SEARCH_API_KEY` ([#1694](https://github.com/can1357/oh-my-pi/issues/1694)).\n- Fixed `web_search` returning 401 from corporate Anthropic API gateways. `ANTHROPIC_CUSTOM_HEADERS` is now forwarded to web-search requests whenever `ANTHROPIC_BASE_URL` points to a non-Anthropic host, not only in Foundry mode ([#1693](https://github.com/can1357/oh-my-pi/issues/1693)).\n- Fixed opening exported local files from WSL by sending existing paths through `wslpath -w` and launching `wslview` directly when available, avoiding `xdg-open`'s broken file-handler path translation ([#950](https://github.com/can1357/oh-my-pi/pull/950) by [@rxreyn3](https://github.com/rxreyn3)).\n- Fixed `/move` (and cross-project resume) not re-scoping the live project settings to the destination directory. Changing a session's working directory now reloads the project settings layer in place (via `Settings.reloadForCwd`) so project-scoped configuration and path-scoped `enabledModels`/`disabledProviders` follow the move instead of remaining pinned to the launch directory.\n- Fixed `read ` freezing the TUI on large databases. Listing tables ran an unbounded `SELECT COUNT(*)` per table, and since `bun:sqlite` executes synchronously on the same JS thread that drives rendering and input, a multi-GB database's full-table scans blocked the UI for seconds. The listing now reads the planner's `sqlite_stat1` estimate for tables above a scan cap (shown as `~N rows`) and only counts exactly when a table is provably small, reading at most `cap + 1` rows (a capped table shows `N+ rows`). On an 8.4 GB stats database the listing dropped from multi-second full scans to ~2 ms.\n- Fixed a module-load crash (`ReferenceError: Cannot access 'evalToolRenderer' before initialization`) triggered whenever `tools/eval` was imported before `tools/renderers`. The eval JS backend statically pulls the agent/task/sdk/extension chain, which re-enters the root barrel \u2192 `modes/components` \u2192 `tool-execution` \u2192 `renderers` while `eval.ts` was still initializing, so `renderers.ts` read `evalToolRenderer` in its TDZ. The eval TUI renderer is now split into a dependency-light `tools/eval-render.ts` that `renderers.ts` imports directly (decoupling pure rendering from the eval runtime); `eval.ts` re-exports `evalToolRenderer`/`EVAL_DEFAULT_PREVIEW_LINES` for compatibility.\n- Fixed `/logout` offering providers that were only authenticated by env/config fallbacks, which made OpenCode Go/Zen appear to remain logged in after their stored credentials were removed ([#1658](https://github.com/can1357/oh-my-pi/issues/1658)).\n- Fixed `omp --resume ` crashing with an uncaught exception when an interactive user declined the cross-project fork prompt. `createSessionManager` now returns `undefined` for that cancellation, while non-interactive invocations still fail with a diagnostic when they cannot answer the fork prompt ([#1668](https://github.com/can1357/oh-my-pi/issues/1668)).\n- Fixed `history.db` never recording the originating session id: the `session_id` column documented for 15.6.0 was missing from the shipped storage layer, so the column was never created/populated on the write path and every prompt row had `session_id` `NULL`. Restored the `session_id` column, schema migration (`ALTER TABLE history ADD COLUMN session_id` for pre-existing databases), and `HistoryEntry.sessionId`; wired interactive mode to register `setSessionResolver(...)` so prompts are stamped with the session active at submission time (tracking fork/resume switches); and re-enabled prompt-history ranking in the `--resume` and in-session session pickers via `HistoryStorage.matchingSessionIds()`.\n- Fixed `/quit` shutdown leaving the parent shell prompt at the top of the viewport after the final TUI teardown render on Linux terminals ([#1620](https://github.com/can1357/oh-my-pi/issues/1620)).\n- Fixed `omp update` failing with `No version matching \"X\" found for specifier \"@oh-my-pi/pi-coding-agent\" (but package exists)` when bun saw an older catalog than the update check did. The version is resolved by querying `https://registry.npmjs.org/` directly, but `bun install -g` would then consult its on-disk manifest snapshot or a configured npm mirror (corporate proxy, Taobao, \u2026) that hadn't replicated the release. The bun install step now runs with `--no-cache --registry=https://registry.npmjs.org/` so it hits exactly the registry the version check used ([#1686](https://github.com/can1357/oh-my-pi/issues/1686)).\n- Fixed ACP mode resetting configured async/background job settings to disabled RPC defaults, so explicit ACP background-job opt-ins are preserved during startup ([#1324](https://github.com/can1357/oh-my-pi/issues/1324)).\n- Fixed legacy Pi extensions loading their `__dirname`-relative assets as empty \u2014 e.g. `@plannotator/pi-extension` reading `plannotator.html`/`review-editor.html` via `readFileSync(join(__dirname, \u2026))`, which left `planHtmlContent` empty and dropped the plugin into its \"no UI support\" auto-approve path. The compat layer previously mirrored every extension module into a flat temp directory, so `import.meta.url` (and thus `__dirname`) pointed at the mirror root and sibling asset reads `ENOENT`ed. Extensions now load in place from their real on-disk location \u2014 `import.meta.url` is the real source file, so asset reads resolve exactly as under the original Pi runtime. A `Bun.plugin()` `onLoad` hook scoped to the entry's relative-import graph (the exact set of source modules, never the host, other extensions, `node_modules` deps, or unrelated project files) rewrites only the legacy `@(scope)/pi-*` and `@sinclair/typebox` imports; relative siblings, the extension's own `node_modules` deps, and bundled assets all resolve natively, with no temp-directory mirroring and no asset copying ([#1674](https://github.com/can1357/oh-my-pi/issues/1674)).\n- Fixed plan approval keep-context usage to use the execution model context window, avoid zero-usage aborted turns, and disable keeping context when preserved context exceeds 95%.\n\n## [15.7.6] - 2026-06-01\n\n### Added\n\n- Added `ask` option descriptions so agents can keep short labels and render explanatory text as separate muted rows in the selector.\n- Added an extension API for rendering supplemental UI below visible assistant thinking blocks.\n- Added default-on `lsp.diagnosticsDeduplicate` support so post-edit LSP diagnostics already shown for a file are suppressed within the session and only new or changed diagnostics are surfaced.\n\n### Fixed\n\n- Fixed a single ESC press both dismissing the @/slash autocomplete popup and aborting the running agent operation. ESC now drains the popup first; only when no popup is visible does it route to the global interrupt handler (matching the standard TUI/IDE pattern). The `shouldBypassAutocompleteOnEscape` editor hook is removed \u2014 it had become the trigger for this bug ([#1655](https://github.com/can1357/oh-my-pi/issues/1655)).\n- Fixed Claude Code slash command discovery to load subdirectory commands recursively while preserving basename commands (e.g. `/apply`) and adding namespace aliases (e.g. `/opsx:apply`) for tools that install colon-namespaced workflows ([#1523](https://github.com/can1357/oh-my-pi/issues/1523)).\n- Fixed the `eval` tool's per-cell `timeout` killing cells that were not stalled. The timeout is now a plain wall-clock budget on the cell's **own** work that is **paused only while a host-side `agent()`/`parallel()`/`llm()` bridge call is in flight** \u2014 those calls pump a heartbeat that re-arms the watchdog, so a long fanout or a slow (e.g. reasoning-tier) completion runs to completion instead of being aborted mid-flight (a subagent's time-to-first-token, a long quiet nested tool, or an entire oneshot `llm()` request no longer trip it). Nothing else re-arms the budget: ordinary compute, `print`/stdout, `log()`/`phase()`, and non-agent tool calls all count against it, so a cell that is not delegating to an agent/llm is bounded by the regular wall-clock timeout (and the timeout message no longer says \"of inactivity\"). The heartbeat is a pure keepalive \u2014 never persisted or rendered.\n\n## [15.7.5] - 2026-06-01\n\n### Fixed\n\n- Fixed streaming assistant responses leaving duplicated tail rows in WSL/Windows Terminal scrollback by enabling eager native-scrollback rebuilds while assistant text is actively streaming ([#1615](https://github.com/can1357/oh-my-pi/issues/1615)).\n- Fixed the `task` tool mangling subagent prompts when a model double-JSON-encodes a string argument: `context` and each task's `assignment`/`description` are now repaired when they arrive uniformly double-escaped (literal `\\n`, `\\\"`, `\\uXXXX`), so the subagent receives the intended prose and the call preview renders real newlines. The repair is guarded by a JSON-string round-trip and a double-encode signature, so legitimate backslashes/quotes (Windows paths, regexes, embedded quotes) are left untouched, and it is scoped to these natural-language fields only (never code-bearing tools).\n- Fixed `pr://` PR views omitting formal review submissions and approvals when comments are enabled ([#1600](https://github.com/can1357/oh-my-pi/issues/1600)).\n- Fixed subagent yield-reminder loop logging benign user/compaction aborts as `ERROR`. The catch around `session.prompt`/`waitForIdle` in `task/executor.ts` now demotes `ToolAbortError` and signal-aborted exits to `debug` and keeps `ERROR` for genuine prompt failures only ([#1623](https://github.com/can1357/oh-my-pi/issues/1623)).\n- Fixed `read local://` resolving to the wrong session's artifacts directory in multi-session ACP hosts (e.g. cmux). `LocalProtocolHandler.resolve` now honors `context.localProtocolOptions` supplied by the calling tool before falling back to the process-wide override or the first `main`-kind session in the global `AgentRegistry`; `read`, `find`, `search`, `ast_grep`, and `ast_edit` thread their session's options through so a `local://PLAN.md` lookup hits the calling session's `local` root instead of a sibling session's ([#1608](https://github.com/can1357/oh-my-pi/issues/1608)).\n- Fixed `omp` segfaulting on exit on Windows after the tiny title/memory model loaded `onnxruntime-node` (issue [#1606](https://github.com/can1357/oh-my-pi/issues/1606)). The tiny model now runs in a Bun subprocess instead of a Worker thread, so the NAPI finalizer that crashes during shutdown never executes in the agent's address space; the subprocess is `SIGKILL`'d on dispose to skip every native destructor on every platform.\n- Fixed unbounded MCP reconnect loop that could fork-bomb the host when a stdio MCP server completes the `initialize`/`tools/list` handshake and then exits. `MCPManager` now enforces a per-server crash circuit breaker (5 reconnects per 30 s window) on the automatic `transport.onClose` path; manual `/mcp reconnect` resets the window so users can recover after fixing the misconfiguration ([#1592](https://github.com/can1357/oh-my-pi/issues/1592)).\n\n## [15.7.4] - 2026-05-31\n\n### Removed\n\n- Removed `/shake summary`, the `shake-summary` auto-compaction strategy, and the `providers.shakeSummaryModel` setting. Use `/shake` or `compaction.strategy: shake` for mechanical artifact-backed elision without local-model CPU.\n\n### Fixed\n\n- Fixed plugin install failing for sources pinned to a SHA: `git.clone()` no longer adds `--depth 1` when `options.sha` is set, so the checkout of arbitrary commits succeeds instead of bailing out with \"shallow clone may not contain this commit\" ([#1589](https://github.com/can1357/oh-my-pi/issues/1589)).\n\n## [15.7.3] - 2026-05-31\n\n### Added\n\n- Added support for decimal and `k`/`m` suffix turn-budget directives, enabling budgets like `+1.5k` and `+2m` in eval message parsing\n- Changed eval budget resolution to honor a user `+Nk` directive over an active Goal Mode limit while falling back to Goal Mode when no per-turn ceiling is set\n- Added `agent()` eval options `agent_type`/`agentType`, `model`, `context`, and `label`, and returned structured JSON when `schema` is provided in JS and Python eval cells\n- Added a live, Task-tool-style progress tree for eval `agent()` calls, drawn below the notebook (code cell) box. Each subagent surfaces as a status line (icon \u00b7 id \u00b7 tool count \u00b7 context \u00b7 cost, plus duration on completion) with its current tool/intent while running, and updates mid-execution rather than only at the cell's final result. Progress events coalesce per subagent id so the persisted event list stays bounded across many throttled ticks.\n- Added `agent()` to the `eval` runtime so JS and Python cells can spawn one subagent through the existing task executor; JS eval also gained bounded `parallel()` and `pipeline()` helpers for orchestrating subagent calls.\n- Added a `workflow` magic keyword (mirrors `orchestrate`/`ultrathink`): the standalone word glows amber\u2192green in the editor and appends a hidden notice steering the model to author deterministic multi-subagent fan-outs in `eval` (agent/parallel/pipeline). Matching is whitespace-delimited and case-sensitive (lowercase only); the singular and plural both trigger, but capitalized forms, inflections like `workflowed`, and path-embedded occurrences like `workflow.ts` do not.\n- Added `parallel()` and `pipeline()` to the Python `eval` runtime (thread-pool over the synchronous `agent()` bridge), mirroring the JS helpers: bounded pool (default 4, max 16), input-order preservation, a barrier between every `pipeline` stage, and contextvar propagation so `agent()` works inside worker threads.\n- Added `log()`, `phase()`, and a `budget` object to both `eval` runtimes (Python and JS). `log`/`phase` emit progress/phase status lines; `budget.total`/`budget.spent()`/`budget.remaining()`/`budget.hard` expose a real per-turn output-token budget. A `+Nk` directive in the user's message sets an advisory budget (the model self-limits via `budget.remaining()`); `+Nk!` (or an active Goal Mode budget) makes it a hard ceiling that blocks further eval `agent()` spawns once reached. `budget.spent()` counts output tokens spent this turn across the main loop and all eval-spawned subagents.\n- Added search support for virtual internal URLs (including `omp://` roots) by resolving and scanning in-memory internal resources as search targets alongside filesystem paths\n- Added expansion of virtual internal URL search targets so `search` can match multiple internal documents when given `omp://`\n- Added `/omfg ` slash command that drafts a TTSR rule from a complaint, validates it against the current conversation, saves it to project or `~/.omp/agent/rules`, and registers it live.\n- Added `/shake` slash command and the `shake` / `shake-summary` compaction strategies that reduce context by mechanically dropping heavy content instead of LLM summarization. `/shake` (alias `/shake elide`) strips heavy tool-call results and large fenced/XML blocks, offloads the originals to one session artifact, and leaves a recoverable `artifact://` placeholder; `/shake summary` compresses the same regions with a local on-device model (`providers.shakeSummaryModel`, default `qwen3-1.7b`) and falls back to elide per region when the model is unavailable; `/shake images` strips image blocks. Auto-maintenance honors the `shake` / `shake-summary` strategies (16k protect window); on context overflow a shake that reclaims nothing falls back to context-full summarization.\n- Added `providers.shakeSummaryModel` setting selecting the local on-device model used by `/shake summary` and the `shake-summary` compaction strategy. Runs entirely on-device (downloads on first use) and never calls a remote/cloud LLM.\n\n### Changed\n\n- Changed the eval cell `timeout` from a hard wall-clock deadline to an inactivity (idle) budget: a cell is now interrupted only after going the full window with no progress signal, and every status event \u2014 `agent()` progress snapshots, `log()`/`phase()`, and tool-bridge activity \u2014 re-arms the watchdog. Long `agent()`/`parallel()` fanouts that keep reporting progress no longer time out mid-run (previously the kernel was killed at the fixed deadline even while subagents were actively progressing). Raw `print`/stdout does not reset the watchdog, so pure-compute runaway loops stay bounded; the timeout is driven entirely by the abort signal, so neither runtime arms a competing fixed timer.\n- Fixed turn-budget parsing to match `+Nk` directives only at token boundaries, preventing values like `version 1.2.3`, `c++`, and `+500kfoo` from triggering a budget rule\n- Changed overflowing provider, hook-option, branch-message, agent, extension, and session-tree pickers to support fuzzy type-to-filter search.\n- Changed Shift+Ctrl+P to cycle role models backward instead of cycling forward without persisting.\n- Changed empty prompt input so `?` inserts a literal question mark instead of opening `/hotkeys`; use `/hotkeys` explicitly for the shortcut reference.\n- Changed `search` output to preserve full virtual and internal URL paths in grouped results and `details.files` instead of collapsing them to file basenames\n- Changed `/omfg` to run up to three generation attempts with validation feedback and only prompt saving when no draft matches assistant history\n- Changed `/omfg` to show a live draft panel with generation/validation/saving status and allow canceling an active rule request with `Esc`\n- Changed keybindings config to use `~/.omp/agent/keybindings.yml`, with automatic migration from legacy `keybindings.json` and continued support for `keybindings.yaml`.\n- Changed the local SQLite memory backend identifier from `mnemosyne` to `mnemopi`. Existing configs are migrated automatically on load: `memory.backend: mnemosyne` becomes `mnemopi` and the `mnemosyne.*` settings block is renamed to `mnemopi.*` (skipped when an explicit `mnemopi` block already exists).\n- Changed the `ultrathink`/`orchestrate`/`workflow` magic keywords to be markdown-aware: the standalone word now also glows in the rendered user message bubble (matching the live editor), and neither the glow nor the hidden steering notice triggers when the keyword sits inside a fenced code block, an inline `` `code` `` span, or an XML/HTML section.\n\n### Fixed\n\n- Fixed Ctrl+O tool-result expansion on POSIX terminals so offscreen tool blocks rebuild native scrollback instead of leaving stale collapsed rows above the viewport.\n- Fixed final `agent()` completion status emissions in eval cells so the last live progress snapshot now preserves accumulated subagent metrics such as tool count and cost\n- Fixed `agent()` in eval to enforce plan-mode, spawn allowlist, and disabled-agent checks before launching subagents\n- Fixed recursive `agent()` calls from eval by enforcing the existing max subagent depth limit\n- Fixed runtime model switches (Ctrl+P cycling, `--model`, `/model`, model picker selections, and programmatic changes) so they no longer overwrite the persisted `modelRoles.default`; only the model picker's explicit \"Set as default\" action and settings changes persist the default.\n- Fixed `search` to honor line-range suffixes on virtual internal URL targets so matches outside the requested ranges are no longer returned\n- Fixed `search` to handle internal URLs without source files without incorrectly reporting `Path not found`, returning matches from virtual content instead\n- Fixed `/omfg` parsing to tolerate fenced or noisy model output, normalize generated rule names, and reject invalid regex conditions before saving\n- Fixed auto-thinking sessions to persist the concrete resolved effort after classification, so resuming the session restores that level instead of returning to pending `auto`.\n- Fixed extension-registered CLI flags (e.g. `--spawn-peer `) leaking into the initial prompt: argv is re-parsed once the extension flag set is known so flag values are consumed instead of becoming messages or being misread as `@file` arguments. Registered flags shadow same-named built-ins, so a colliding flag (e.g. plan-mode's `--plan`) is parsed with the extension's semantics rather than being consumed by the built-in branch (which would otherwise eat the following message and corrupt the built-in field). Extension flags and `@file` arguments are now resolved before the session is created, so an unreadable initial `@file` exits without leaving a junk session/terminal breadcrumb behind. ([#1503](https://github.com/can1357/oh-my-pi/pull/1503))\n- Fixed footer status-line truncation: the left stats and right model segments now truncate by terminal cell width (via `truncateToWidth`) and strip all VT/ANSI escapes (via `stripVTControlCharacters`) instead of a SGR-only regex plus code-point `substring`, so wide glyphs, OSC hyperlinks, and non-SGR sequences can no longer overflow the line.\n- Fixed the streaming edit diff preview rendering a tall, half-empty box (and the earlier \"box grows and shrinks repeatedly\" stutter). A whole-file Myers re-diff is recomputed on every streamed chunk and its alignment is not monotonic in payload length, so a hunk-aware window that kept whole change segments gained and lost rows tick to tick; the prior high-water row reservation hid that stutter but padded the reserved height with blank rows, leaving a large empty rectangle whenever the diff shrank below its peak. The preview now pins a fixed-height trailing window to the bottom of the diff (\"accept from the back\"), so the box stays a steady, full window of real diff context instead of blank padding.\n- Fixed duplicated/stale scrollback above a streaming tool result on POSIX terminals (macOS/Linux). A tool whose output grows and re-lays-out (e.g. an edit diff gaining hunks) re-renders rows that already scrolled into native scrollback; the unknown-viewport anti-yank deferral left the old copy in place while the new one rendered below, showing the block twice. The event controller now enables the TUI's eager native-scrollback rebuild while a foreground tool is executing (`setEagerNativeScrollbackRebuild`), so those offscreen re-renders rebuild history cleanly \u2014 a snap to the tail is acceptable mid-tool. Background-running tools and plain assistant-text streaming keep the no-yank deferral; the mode resets at each turn start.\n\n### Removed\n\n- Removed the `/drop-images` slash command; use `/shake images`, which strips every image from the session through the same `dropImages()` path.\n\n## [15.7.2] - 2026-05-31\n\n### Added\n\n- Added `providers.autoThinkingModel` setting so users can choose the `auto` thinking classifier backend (online smol or local tiny-memory model)\n- Added an `auto` thinking level that classifies each real user turn and resolves to a concrete low-through-xhigh effort, with online smol classification by default and an opt-in local on-device classifier.\n\n### Changed\n\n- Updated the interactive thinking selectors in model/model-role pickers and ACP thinking options to include `auto` as a selectable level\n- Updated footer and status-line rendering to show `auto` while auto-thinking is being resolved and `auto \u2192 ` once it resolves\n- Changed the local tiny-model device default to CPU on every platform; explicit `providers.tinyModelDevice` / `PI_TINY_DEVICE` values still opt into accelerated ONNX providers.\n\n### Fixed\n\n- Prevented auto-thinking classification from running on non-user synthetic turns and non-reasoning models, keeping the session on its provisional concrete effort\n- Added a bounded auto-thinking classification path that falls back to the provisional effort on failures/timeouts so prompts continue without interruption\n- Bypassed auto classifier for `ultrathink` prompts and resolved directly to the highest supported auto effort\n- Fixed the JavaScript `eval` kernel crashing the whole process with a segfault (`SIGTRAP`, `getImportedModule` on a null record) when imported code reached a local module whose relative-import graph contains a cycle \u2014 e.g. `await import(\"\u2026/edit/streaming.ts\")`, or any workspace path with cyclic re-exports. The `LocalModuleLoader` linked and evaluated each local module individually inside the recursive `vm.SourceTextModule` linker callback, which re-entered Bun's `node:vm` module linker mid-instantiation and detonated JSC on the first cycle. The loader now constructs the entire local module graph first and drives a single `link()` + `evaluate()` from the graph root, so cyclic graphs instantiate in one pass; external (`node_modules`) modules stay eagerly loaded since they carry no imports and cannot form a cycle.\n- Fixed the streaming `edit` preview rendering a blank box for hashline edits whose payload sits on the trailing in-flight line (the common single-op `replace`/`insert` case). The preview path trimmed that still-typing line before diffing, so a single-payload op collapsed to a \"No changes\" result \u2014 shown as an empty box \u2014 for almost the entire stream. Hashline previews now feed the raw in-flight text through `applyPartialTo`, whose streaming-tolerant parser drops a payload-less trailing op and projects a partially-typed payload line as it grows, so the diff appears and fills in live. Transient errors from the actively-typed trailing section are also suppressed while streaming (regardless of section count) so a mid-typed op can't wipe an already-good preview frame; real errors still surface once args are complete.\n\n## [15.7.0] - 2026-05-31\n\n### Added\n\n- Added a `Web search` setup tab that lets users choose the preferred `providers.webSearch` provider during onboarding\n- Added manual authorization-code/redirect URL prompts for OAuth providers that require non-callback login in the setup wizard\n- Added an `omp completions ` command that prints a shell completion script generated from the live command/flag metadata, so completions never drift from the actual CLI. Subcommands, flags, and enum values complete statically; `--model`/`--smol`/`--slow`/`--plan` resolve against the bundled model catalog and `--resume` against on-disk sessions via a hidden `__complete` helper.\n- Added a `/switch` slash command that opens the temporary model selector for the current session, mirroring the `alt+p` keybinding.\n- Added `replace block N:` and `delete block N` operators to the `edit` tool: they resolve the syntactic block beginning on line N via tree-sitter (native `blockRangeAt`) and replace or delete its full line span, so a construct can be rewritten or removed without counting its closing line. Unresolvable blocks (unsupported language, blank/closing-delimiter line, or a parse error) are rejected with guidance to use an explicit `replace N..M:` / `delete N..M` range.\n- Added an animated pending border for `bash` and `eval` execution blocks: while a command/cell is running, a single dark segment glides clockwise around the block's outer edge (top \u2192 right \u2192 bottom \u2192 left), replacing the previous static accent border. Motion is eased per edge (decelerating into each corner) and timed against a fixed lap duration mapped onto the live perimeter, so streaming a new output line or resizing the terminal nudges the segment proportionally instead of resetting its position. Driven by the existing spinner cadence and gated on the `display.shimmer` setting (no motion when `disabled`).\n- Added `providers.tinyModelDevice` and `providers.tinyModelDtype` settings (Providers tab) controlling local tiny-model acceleration for session titles and Mnemosyne memory tasks. `providers.tinyModelDevice` selects the ONNX execution provider (`default` keeps the platform pick \u2014 DirectML on Windows, CUDA on Linux x64, CPU elsewhere); `providers.tinyModelDtype` selects quantization/precision (`default` keeps each model's shipped `q4`, e.g. `fp16` trades speed for fidelity). The `PI_TINY_DEVICE` / `PI_TINY_DTYPE` env vars override the matching setting. Also added `PI_TINY_DTYPE` as the env counterpart to `PI_TINY_DEVICE`; an unrecognized device/precision fails loudly at worker startup instead of silently loading a different one.\n- Added a bundled set of default rules shipped with the agent (TypeScript/Rust convention rules registered as TTSR conditions). They load via the new lowest-priority `builtin-defaults` discovery provider, so any user/project/tool rule of the same name overrides the bundled copy. Disable the whole set with `ttsr.builtinRules: false`, or drop individual rules (bundled or your own) by name via `ttsr.disabledRules`.\n\n### Changed\n\n- Changed setup onboarding to a tabbed `Set up your providers` scene with dedicated `Sign in` and `Web search` panels\n- Changed the glyph mode picker to preselect the currently configured symbol preset instead of always defaulting to Unicode and to show live glyph samples in the picker rows\n- Changed OAuth sign-in flow in the setup wizard so users can authenticate multiple providers before leaving with Escape\n- Changed the plan-approval model-tier slider and the `ctrl+p`/`alt+p` role-cycle status to share one status-line-style chip track: each tier renders in its own role color and the active tier is filled as a powerline chip with a luminance-matched label. The role-cycle status now shows only the chip track \u2014 the resolved model and thinking level already live on the status line \u2014 instead of the verbose `Switched to :  (cycle: \u2026)` line.\n- Changed the in-flight `bash` tool-call preview to render as a full bordered block as soon as the call appears, instead of a one-line `Bash: $ \u2026` status that only expanded into a block once the command produced its first output chunk. Silent commands (e.g. `sleep 30`) now show the framed command block \u2014 with the animated pending border \u2014 for their whole runtime.\n- Changed local tiny-model inference to request a worker-safe accelerated ONNX execution provider where available (DirectML on Windows, CUDA on Linux x64), with CPU retry if acceleration cannot initialize. `PI_TINY_DEVICE=cpu` restores CPU-only behavior; `PI_TINY_DEVICE=metal` is accepted as a WebGPU alias but guarded back to CPU in the production macOS worker because WebGPU currently hard-crashes Bun on worker teardown.\n\n### Fixed\n\n- Used the native block resolver for hashline operations so `replace block` edits now derive block ranges from file-aware parsing\n- Fixed OAuth login handling to cancel cleanly when users press Esc or Ctrl+C during authentication\n- Fixed the `read` tool description advertising `inspect_image` (\"for visual analysis, call `inspect_image`\") even when the `inspect_image` tool was disabled, which left the model hunting for a tool absent from its function list. The image section is now gated on `inspect_image.enabled`: when disabled it instead states that reading an image path returns the decoded image inline.\n- Fixed session-title generation latching onto literal text inside fenced code blocks \u2014 a pasted UI mockup containing \"Welcome to Claude Code v2.1.158\" titled the session \"Setup Screen for Claude Code v2.1.158\" instead of capturing the actual request. The first user message now has fenced code blocks stripped before titling (both the online `pi/smol` and local on-device model paths share the same preprocessing), with a fallback to the original message when stripping would leave too little to title from (e.g. a message that is essentially just a code block).\n- Fixed slash-command autocomplete repaint requests so Windows Terminal sessions with unknown native viewport state keep updating the input box and candidate list. ([#1550](https://github.com/can1357/oh-my-pi/issues/1550))\n- Fixed Python `eval` failing the whole session when the managed `~/.omp/python-env` interpreter exists on disk but no longer runs (e.g. a stale `uv`-managed Python that was removed or upgraded). Availability resolution now enumerates every candidate \u2014 active/project venv, the managed env, then the system interpreter \u2014 and probes each in priority order, falling through to the first that actually executes instead of failing fast on the first resolved path. The kernel spawns whichever interpreter the probe selected, so a working system Python takes over transparently.\n\n### Removed\n\n- Removed the `recipe` tool and its `recipe.enabled` setting. Task-runner targets (just/package.json/Cargo/make/Taskfile) are invoked directly through `bash`.\n\n## [15.6.0] - 2026-05-30\n\n### Added\n\n- Added prompt-mode autocomplete for supported internal URL schemes (`skill://`, `rule://`, `agent://`, `artifact://`, `local://`, `memory://`, and `omp://`) so typing those tokens now suggests existing resources as completion candidates\n- Added fuzzy matching and ranked suggestion ordering for internal URL completion, including rule and skill descriptions, with accepted completion replacing just the typed token and inserting the chosen URL followed by a space\n- Changed internal URL completions now include nested `local://` path suggestions from the configured local workspace\n- Added Mnemosyne memory inference model selection with an online mode or local transformers.js options (`qwen3-1.7b`, `gemma-3-1b`, `qwen2.5-1.5b`, `lfm2-1.2b`) so memory extraction and consolidation can run via the shared tiny-model worker\n- Changed memory tiny-model handling to route local memory prompts through the same queueed tiny-model worker pipeline with bounded completion output\n- Added a Providers \u2192 Tiny Model setting for session titles, defaulting to the online `pi/smol` path with five optional local CPU transformers.js models. A local model \u2014 and the one-time `@huggingface/transformers` runtime install in compiled binaries \u2014 is downloaded and loaded only when explicitly selected (or via `omp tiny-models download`); the default online path never spawns the title worker for inference. Selecting a local model adds a delayed `pi/smol` fallback so titles never block, plus in-chat download progress.\n- Added a persistent live agent roster pinned below the editor (focus it with `Ctrl+S` or `Alt+Down`), including view-as switching into delegated agent sessions with human-readable delegate names and UI pinning to suppress idle reaping while viewed. The roster stays hidden until at least one delegated agent exists and releases focus back to the editor once the last one is gone.\n- Recorded the originating session ID alongside each prompt in `history.db` (new `session_id` column, surfaced as `HistoryEntry.sessionId`), so recalled prompts can be traced back to the session they came from. Existing history databases gain the column automatically on next launch.\n- Added compact inline TUI renderers for the `retain`, `recall`, and `reflect` memory tools. `retain` now shows one themed bullet line per stored item (truncated to width) under a status header with the stored/queued count, and `recall`/`reflect` collapse to a single query header (recall reports the match count and hides recalled memories until expanded) instead of dumping the raw JSON argument tree.\n- Added a randomly picked tip beneath the welcome screen, sourced from an embedded `tips.txt` (one tip per line). The line is italicized with a purple `Tip:` label and a dimmed light-blue body, and the tip is chosen once per welcome instance so intro-animation and LSP re-renders don't shuffle it.\n- Added a Mnemosyne-only `memory_edit` agent tool for updating, forgetting, or invalidating recalled memories by id, and added `/memory stats` plus `/memory diagnose` slash commands for backend maintenance visibility.\n- Added an `orchestrate` magic keyword that mirrors `ultrathink`: dropping the standalone word in a message paints it with a cool teal\u2192violet gradient in the editor and appends a hidden system notice that switches the model into the multi-phase, parallel-subagent orchestration contract. Matching is word-bounded and case-insensitive, so `orchestrated`/`orchestrating` never trigger it.\n- Added a model-tier slider to the plan-approval prompt (\"Plan mode - next step\"). Left/right arrows move it from any list position to pick which configured role model (`cycleOrder`, e.g. `smol \u203a default \u203a slow`) executes the approved plan, with each tier colored by its role and the resolved model name shown beneath the track. The chosen tier is applied before dispatch and carries through the fresh/compacted execution session; the slider is hidden when fewer than two role models resolve.\n\n### Changed\n\n- Changed `irc` to treat the attached human as a first-class `User` peer, merging human prompts into `irc call User` with optional structured question payloads and adding `/dm  ` for user-to-agent routing without switching views.\n- Changed the `--resume` session picker (and the in-session resume selector) to also rank sessions by prompt-history matches from `history.db`, not just the session-list metadata. Because the session list only indexes the first 4KB of each file, this surfaces sessions by prompts typed deep into long conversations. Sessions matched by both signals lead, then metadata-only matches, then history-only matches \u2014 no metadata match is dropped.\n- Changed the `task` tool's streaming call preview to list each dispatched agent's `id` and UI description as a tree instead of a bare `N agents` count, so the individual agents are visible while the tool-call arguments are still streaming. The collapsed view caps at 12 entries (`\u2026 N more agents`); the expanded view shows all.\n- Changed Mnemosyne `recall` tool output to include memory ids for explicit recall results so agents can target `memory_edit`; auto-injected memory context and `reflect` remain id-free.\n- Changed the system prompt to advertise `memory://root` only when the local memory backend is active.\n- Changed `todo_write` result rendering to animate completed items in place: the checkbox flips checked first, then the strikethrough reveals across the task text.\n\n### Removed\n\n- Removed the standalone `ask`, `task`, and `yield` tools along with their obsolete prompts, docs, and tests; delegation now routes through persistent `delegate` agents plus IRC coordination.\n- Removed the `/orchestrate` slash command; orchestration is now triggered by the `orchestrate` keyword (see Added) so the contract rides alongside the user's own prompt instead of replacing it.\n- Removed the sticky Todos panel all-done drop/collapse animation; completed todo state now stays visible until the next explicit todo update changes it.\n\n### Fixed\n\n- Fixed Mnemosyne session shutdown to flush queued memory extractions before exit so the last turn\u2019s facts are not lost\n- Fixed a native crash (`malloc: pointer being freed was not allocated` / `NAPI FATAL ERROR`) when quitting after the local transformers.js title model had run. The tiny-title worker no longer calls `pipeline.dispose()` on shutdown \u2014 disposing the onnxruntime session freed native memory that Bun's worker/NAPI teardown then freed again. The worker is torn down immediately after, so the OS reclaims the model memory regardless.\n- Fixed the tiny-title download progress bar flashing on every first message even when the local model was already downloaded. A cached model emits the same `download`/`progress` events as a real download, so the bar is now revealed only when in-flight progress events keep arriving past a short grace window \u2014 cache hits finish (or fall silent during onnxruntime init) before then and never show the bar.\n- Fixed the Mnemosyne memory backend lifecycle so auto-retain counts the full session transcript, delegated agents inherit the parent Mnemosyne state, `/memory clear` removes scoped project-bank databases, session disposal closes Mnemosyne SQLite handles, session switches rekey/reset Mnemosyne tracking, and project bank names include an absolute-root hash with safe bank-name sanitization.\n- Fixed the streaming edit preview showing no diff for single-line hashline edits. The preview-diff coalescing keyed only on the arg text, so the final (args-complete) pass \u2014 which computes an untrimmed diff \u2014 was skipped because the payload was byte-identical to the last streamed chunk whose trailing line had been trimmed. The dedup key now pairs the streaming state with a content hash.\n- Fixed `Esc` in a delegated agent view returning to the main session instead of aborting the delegated agent's active turn.\n- Fixed the subagent stats line to separate the cost with the theme dot separator (was a stray literal `.`) and to render context usage as `%/` (e.g. `21.3%/272K`) matching the status line gauge, via a shared `formatContextUsage` helper now used by the footer, status-line segment, session observer overlay, and `task` renderer.\n- Fixed the agent roster staying pinned under the editor when all delegated agents are idle or dormant; it now reappears when explicitly focused with `Alt+Down` / session observe.\n- Fixed selector-style UI components to honor `tui.select.up` and `tui.select.down` keybindings instead of hard-coding raw Up/Down arrow bytes ([#1535](https://github.com/can1357/oh-my-pi/issues/1535)).\n- Fixed the bash (and `recipe`) tool result footer not rendering for failed commands. A non-zero exit threw a `ToolError`, which dropped the result details, so the styled `\u27e8Wall \u2026 | Timeout \u2026\u27e9` footer was replaced by the raw `Wall time: \u2026 seconds` / `Command exited with code N` lines. Non-zero exits now resolve as a non-throwing error result that keeps `wallTimeMs`/`timeoutSeconds`/`exitCode`, and the footer shows `\u27e8Wall \u2026 | Timeout \u2026 | Exit: N\u27e9` with the textual notices folded out of the output pane. Aborts, timeouts, and missing-exit-status still throw as before.\n- Fixed selector-style UI components to honor `tui.select.up` and `tui.select.down` keybindings instead of hard-coding raw Up/Down arrow bytes ([#1535](https://github.com/can1357/oh-my-pi/issues/1535)).\n\n## [15.5.15] - 2026-05-30\n\n### Changed\n\n- Enabled the agent loop's tool-call batch cap for Anthropic Claude sessions, cutting oversized streamed tool-use bursts into runnable batches before continuing the conversation.\n\n### Removed\n\n- Removed the `calc` tool (deterministic arithmetic evaluator) and its `calc.enabled` setting. The model can compute via `eval` instead.\n\n### Fixed\n\n- Fixed Anthropic Claude tool-call batching to clear and reapply the Claude-specific batch cap whenever the session model changes\n\n## [15.5.14] - 2026-05-29\n\n### Added\n\n- Added progress status output for `llm()` calls in `eval`, including the resolved model, tier, and returned character count\n- Added an `llm(prompt, opts)` helper to both `eval` runtimes (JavaScript and Python) for oneshot, stateless LLM calls. `opts.model` selects a tier \u2014 `\"smol\"` (`pi/smol`), `\"default\"` (the session's active model, falling back to `pi/default`), or `\"slow\"` (`pi/slow`, with high reasoning effort on reasoning-capable models). Pass `system` for a system prompt and a plain JSON-Schema `schema` to force a structured response (the helper returns the parsed object instead of the completion string). Calls carry no conversation history and expose no agent-visible tools; they route host-side through the existing tool bridge under the reserved name `__llm__` (`packages/coding-agent/src/eval/llm-bridge.ts`).\n\n### Fixed\n\n- Fixed a rewind/restore loop when the session leaf lands on an assistant turn that emitted tool calls (e.g. selecting such a turn in `/tree`, or restoring a session whose head is a mid-batch turn). That turn's tool results are persisted as its children \u2014 *below* the leaf \u2014 so they fall off the leaf\u2192root path that `buildSessionContext` walks, leaving the assistant turn's `tool_use` blocks dangling as the final message. `transformMessages` then fabricated one synthetic `\"aborted\"`/`\"No result provided\"` result per call plus a `` developer note, which both rendered as phantom failed calls on a turn that \"hadn't run anything yet\" and re-injected the whole failed batch into the model's context, prompting it to re-issue the batch (the spiral). `buildSessionContext` now strips dangling `tool_use` blocks from a trailing assistant turn (dropping the turn entirely if nothing else remains), so a rewound turn resumes cleanly from its reasoning/text. Live turns are unaffected \u2014 their results persist and the leaf advances past the assistant before any rebuild.\n- Fixed external extension loading on Windows compiled binaries: bare `@oh-my-pi/pi-*` value imports (e.g. `import { AssistantMessageEventStream } from \"@oh-my-pi/pi-ai\"`) failed with `Cannot find package '\\$bunfs\\root\\packages\\\u2026'` because `legacy-pi-compat.ts` built shim override paths from a hardcoded POSIX `/$bunfs/root/packages` literal. Win32 normalised the leading slash to a backslash and the resulting path never resolved against the real bunfs mount (`:\\~BUN\\root\\\u2026`). The bunfs package root is now derived from `import.meta.dir`, so override paths stay platform-native on Windows, Linux, and macOS ([#1514](https://github.com/can1357/oh-my-pi/issues/1514)).\n- Fixed the interactive prompt showing no cursor in Ghostty. A prior change wired the editor's cursor mode to a new `getUseTerminalCursorMarker()` (which always reported the *requested* preference) instead of the resolved hardware-cursor visibility, so when Ghostty force-hid the hardware cursor the editor stayed in terminal-cursor (marker-only) mode and drew no glyph \u2014 leaving no visible caret with either `showHardwareCursor`/`PI_HARDWARE_CURSOR` value. The editor now follows `ui.getShowHardwareCursor()`: a hidden hardware cursor falls back to the steady software-cursor glyph (which still emits `CURSOR_MARKER` for IME positioning).\n\n### Changed\n\n- Changed the `eval` tool's `display()` JSON tree in the transcript to use the shared `renderJsonTreeLines` renderer (the same one behind tool args, MCP results, and subagent output) instead of its own format. This drops the redundant `Object(N)` / `Array(N)` type labels and the per-output `JSON output N` header in favor of type icons plus bare keys; the `display[N]` header is now shown only when a cell emits more than one `display()` value.\n- Removed the animated spinner from the sticky `Todos` panel. In-progress tasks and pending tasks with a matching in-flight subagent still highlight (accent colour + the static `theme.status.running` glyph), but no longer tick through `theme.spinnerFrames`, so the panel paints once per state change instead of on an 80 ms timer. Subagent auto-checkmarking, the advancing window (`selectStickyTodoWindow`), `todoMatchesAnyDescription` highlighting, and the all-done close animation are unchanged.\n\n## [15.5.13] - 2026-05-29\n\n### Breaking Changes\n\n- Changed hashline edit syntax to verb-based v4: body-bearing ops are `replace N..M:`, `insert before N:`, `insert after N:`, `insert head:`, and `insert tail:`, while bodyless `delete N..M` handles deletion. Removed `>A..B` repeat rows and the old `prepend:` / `append:` virtual insert headers; `-` rows remain rejected with a teaching error.\n\n### Changed\n\n- Changed hashline tag generation to use full-file snapshots for read/search/ast-grep and related outputs, so hashline anchors now validate only when the complete file matches\n- Changed hashline tagging to omit file headers for files over 4 MiB or that cannot be snapshotted, so those files are returned without editable hashline anchors\n- Changed hashline context generation for line edits from partial/sparse snippets to complete-file fingerprints, reducing stale anchors for partially read files\n\n### Fixed\n\n- Restored automatic repair of `edit` range hunks that break bracket balance \u2014 the failure class that previously left a duplicated closing line (a `` / `);` / `}` echoed just below the range) or dropped one (the range swallowed a `});` the payload never restated), leaving the file syntactically broken until a follow-up edit. The hashline applier now normalizes each replacement so its payload preserves the deleted region's delimiter balance, dropping a duplicated bordering closer or sparing a deleted one, and surfaces a warning on the tool result. Always on and balance-validated (no `edit.hashlineAutoDropPureInsertDuplicates` setting); see `@oh-my-pi/hashline` for the contract.\n\n## [15.5.12] - 2026-05-29\n\n### Added\n\n- Added the `omp-plugins` discovery provider, which scans every extension package directory configured via `extensions:` (in `~/.omp/agent/settings.json` or `/.omp/settings.json`) or `--extension`/`-e` on the CLI for `skills/`, `hooks/pre|post/`, `tools/`, `commands/`, `rules/`, `prompts/`, and `.mcp.json`. Prior to this, only the extension's TypeScript factory module ran; every sibling capability the docs (https://omp.sh/docs/extension-authoring) advertised was silently ignored ([#1496](https://github.com/can1357/oh-my-pi/issues/1496)).\n- Added the top-level `omp install ` subcommand documented at https://omp.sh/docs/extension-authoring. Local paths route to `omp plugin link` (so the directory is symlinked into the plugin set), and npm/marketplace specs route to `omp plugin install`. Before this, `install` was not a registered subcommand and the CLI runner silently forwarded `install ./my-extension` to `launch` as an initial LLM prompt ([#1496](https://github.com/can1357/oh-my-pi/issues/1496)).\n\n### Changed\n\n- Changed the sticky `Todos` panel above the editor to advance as tasks close, instead of pinning to the first 5 tasks of the active phase. `selectStickyTodoWindow` now shows up to 5 open (pending / in_progress) tasks in original phase order and reports the count of remaining open tasks for the `+N more` hint, so every `todo_write` flip produces a visible row shift. Closed-phase tail falls back to the last 5 tasks (with the `+N more` line suppressed) until `getActivePhase` walks to the next phase.\n- Linked the sticky `Todos` panel to the live `SessionObserverRegistry` so pending todos that have an in-flight subagent doing their work light up green with an animated spinner \u2014 the same `theme.spinnerFrames` (\"status\" preset) the `task` tool uses for its agent rows \u2014 instead of staying greyed out as if nothing is happening. A new exported `todoMatchesAnyDescription(content, descriptions)` does case- and whitespace-insensitive equality first with a 6-char minimum-overlap substring fallback in either direction, so \"Sonnet #2: shallow bug scan\" and a subagent description of \"Sonnet #2\" still link up. Completed todos now render with `theme.status.success` (\u2714 / `\\uf00c` / `[ok]` per symbol preset, still wrapped in the `success` colour so themed palettes can keep their purple/green/whatever) and in_progress rows render with `theme.status.running`, matching the `task` tool's icon vocabulary. The spinner interval only ticks while at least one visible open todo has a matched active subagent, and self-stops once subagents finish, so plain in_progress todos do not animate forever in the absence of subagent activity.\n- Extracted the top-level CLI command table from `src/cli.ts` into a side-effect-free `src/cli-commands.ts` so test code can introspect the registered subcommands without triggering the entrypoint's top-level await.\n\n## [15.5.11] - 2026-05-29\n\n### Added\n\n- Added `SqlSessionStorage`, a `bun:sql`-backed implementation of `SessionStorage` that persists session JSONL into PostgreSQL, MySQL/MariaDB, or SQLite. Pass a connected `Bun.SQL` instance (the constructor accepts `postgres://`, `mysql://`, or `sqlite:` URLs) to `SqlSessionStorage.create({ client, table?, adapter?, createTable? })` and hand the returned storage to any `SessionManager` factory. The dialect is auto-detected from `client.options.adapter` and used to pick the correct DDL plus upsert-with-append syntax (`ON CONFLICT \u2026 DO UPDATE` for PG/SQLite, `ON DUPLICATE KEY UPDATE` for MySQL), so the agent's append-only persist pattern works in a single round-trip per line. Same in-memory mirror and `drain()` semantics as the Redis backend; blobs and tool artifacts still live on disk via `ArtifactManager`/`BlobStore`.\n- Added `RedisSessionStorage`, a `bun:redis`-backed implementation of the `SessionStorage` interface that lets API consumers route session JSONL through Redis instead of local disk. Pass a connected `Bun.RedisClient` (or any compatible adapter) to `RedisSessionStorage.create({ client, prefix? })` and hand the returned storage to `SessionManager.create(cwd, sessionDir, storage)` (or any other static factory that accepts a storage argument). An in-memory mirror is loaded on creation so the interface's synchronous methods (`existsSync`, `statSync`, `listFilesSync`, \u2026) keep their contracts; `drain()` waits for queued background writes. Tool artifacts and image blobs still live on disk via `ArtifactManager`/`BlobStore` \u2014 Redis only owns the session JSONL keyspace under the configured prefix.\n- Exported the `SessionStorage` / `SessionStorageWriter` / `FileSessionStorage` / `MemorySessionStorage` symbols (already reachable via the `./session/session-storage` subpath) from the package root so SDK consumers can construct alternative storage backends without deep-importing.\n- Added a fresh `\u00b6#TAG` snapshot header to the `write` tool's success text in hashline display mode, covering plain disk writes, ACP-bridge writes, and conflict resolutions (bulk resolutions emit a trailing `Snapshots:` block with one header per successfully written file). The header records a current snapshot in the file-snapshot store so the next `edit` can land without an extra `read` round-trip. Suppressed when the session is not in hashline mode and skipped for archive/SQLite writes and host-managed internal URL targets where hashline anchors do not apply.\n\n### Changed\n\n- The `edit` tool's stale-snapshot rejection message now distinguishes \"file changed between read and edit\" (the section's hash was recorded in this session but the file has since drifted \u2014 a prior in-session edit advanced it, or an external write changed it) from \"hash #X is not from this session\" (a fabricated or carried-over cross-session tag), the latter carrying explicit \"never invent the tag\" guidance. Both messages include the current file hash plus 2 lines of context around each anchor so the next attempt has everything it needs. Snapshot-based recovery still runs first; the sharper diagnostics only surface when recovery cannot reconcile the edit.\n\n### Fixed\n\n- Fixed Autonomous Memory phase 1/phase 2 failing with `Thinking effort low is not supported by /` on models whose supported reasoning efforts exclude `low`/`medium` (e.g. `deepseek/deepseek-v4-pro`). Both stage1 (`Effort.Low`) and consolidation (`Effort.Medium`) call sites in `packages/coding-agent/src/memories/index.ts` now route through `clampThinkingLevelForModel`, lifting the requested effort to the model's lowest supported level instead of letting `requireSupportedEffort` throw ([#1480](https://github.com/can1357/oh-my-pi/issues/1480)).\n\n## [15.5.10] - 2026-05-28\n\n### Added\n\n- Added `/drop-images` slash command that strips every `ImageContent` block from the current session's branch \u2014 `user`/`developer`/`custom`/`hookMessage`/`toolResult` content arrays plus `toolResult.details.images` and `fileMention.files[].image` \u2014 rewrites the session JSONL, rebuilds the agent's in-memory message list, tears down Codex Responses provider sessions, and rebuilds the TUI chat container so the change is visible immediately. ACP clients receive the same handler (returns `\"Dropped N images \u2026\"` / `\"No images found \u2026\"` through `runtime.output`). Stripping content that would leave a `toolResult` or `user` message with zero blocks inserts a single `[image removed]` placeholder so providers do not reject empty content arrays.\n\n### Fixed\n\n- Fixed compaction surfacing raw HTTP 401/403 envelopes (e.g. `Compaction failed: 401 {\"type\":\"error\",\"error\":{\"type\":\"authentication_error\",\u2026}}`) instead of routing to an authenticated fallback model. The compaction layer now attaches the provider-reported HTTP status onto the thrown error, and `AgentSession`'s auth-failure detector branches on `error.status === 401 || 403` in addition to the existing `auth_unavailable` regex. When a fallback model role (e.g. `modelRoles.smol`) is configured, compaction retries it transparently; otherwise the user sees the actionable \"Compaction requires usable credentials for \u2026\" hint instead of the raw provider envelope.\n\n## [15.5.8] - 2026-05-28\n\n### Breaking Changes\n\n- Changed hashline edit parsing to require wrapped hunk headers such as `@@ A..B @@` (including `@@ BOF @@` and `@@ EOF @@`), with empty `@@ A..B @@` blocks deleting the anchored range and legacy inline payload forms treated as malformed\n\n### Added\n\n- Added `vault.enabled` setting (Tools \u2192 Obsidian Vault, default `false`) gating the `vault://` internal URL. When disabled, `VaultProtocolHandler.resolve` / `write`, `resolveVaultUrlToPath`, and `hasObsidian()` all refuse \u2014 the latter hides the `vault://` entry from the system prompt's Handlebars `{{#if hasObsidian}}` block. Tests can opt in via `vi.spyOn(vaultProtocol, \"isVaultEnabled\").mockReturnValue(true)`.\n- Added support for `vault://` URLs in path resolution utilities, including plan mode and internal selector parsing so `read` and edit paths can target Obsidian vault files directly\n- Added `vault://` internal URLs for editable Obsidian vault files, with filesystem-backed read/write/listing and CLI-backed vault index operations.\n- Added strict-mode indicators to `omp auth-gateway check` output by appending `[strict]` to strict-mode text headers and adding a top-level `strict` field in `--json` output\n- `omp auth-gateway check --strict` exercises each broker-supplied credential against its provider's chat-completion endpoint (cheapest bundled chat model per provider, with 15s/attempt timeout and up to 4 catalog fall-throughs on \"model not found / invalid model\" errors). Surfaces failures where the usage endpoint reports 200 but the chat endpoint 401s the same bearer (revoked OAuth scope, mislabeled provider row, \u2026). Output gains a `[chat: ok|FAIL|skip]` column in text mode and a `completion` field on each credential in `--json` mode; the chat-failed count contributes to the non-zero exit code.\n\n### Changed\n\n- Changed hashline apply behavior to preserve duplicated boundary and context lines in replacement and insert payloads instead of auto-absorbing or dropping them\n- Updated hashline syntax: replaced `\u2191`/`\u2193` payload sigils with `^` repeat syntax and `|` literal rows for clearer edit semantics\n- Changed hashline delete syntax from bare `A:` or `A-B:` to explicit `A-B:-` inline delete marker\n- Modified hashline anchor syntax to require explicit range notation `A-B:` instead of shorthand `A:` for single-line operations\n- Updated hashline description in settings to clarify pure insert context behavior without arrow notation\n\n### Removed\n\n- Removed the `edit.hashlineAutoDropPureInsertDuplicates` setting\n- Removed the `edit.hashlineAutoDropPureInsertDuplicates` setting from configuration and execution paths\n- Removed the `edit.hashlineAutoDropPureInsertDuplicates` setting\n- Removed the `edit.hashlineAutoDropPureInsertDuplicates` setting from configuration and execution paths\n\n### Fixed\n\n- Fixed agent yielding silently on `response.incomplete` (OpenAI Responses / Codex `stopReason: \"length\"`). The agent now treats output-side incompletion as a recovery case: drops the truncated/reasoning-only assistant turn, attempts context promotion to a larger model, and falls back to compaction or handoff. `AutoCompactionStartEvent.reason` and the custom-tool `auto_compaction_start.trigger` discriminator gain an `\"incomplete\"` value. The handoff strategy is honored for `\"incomplete\"` (unlike `\"overflow\"`, where the input is broken and handoff would hit the same wall).\n- Fixed `eval` tool to resize large displayed images and append dimension notes to text output\n- Fixed `write` tool to strip malformed or loose hashline section headers before writing file content\n- Fixed `eval` tool image rendering to resize displayed images before returning them and append image-dimension notes to text output\n- Fixed `write` tool output sanitation to strip malformed or loose hashline section headers before writing file content\n- Fixed `omp auth-broker serve` crashing at startup with `logger.setTransports is not a function` \u2014 switched the call site to `import { setTransports } from \"@oh-my-pi/pi-utils/logger\"`, bypassing the `logger` namespace re-export that some Bun versions failed to expose at runtime\n- Fixed `omp auth-gateway` returning `502 upstream_error` and refusing to rotate credentials when a provider responded with a non-401 usage-limit error (Codex `usage_limit_reached`, Anthropic `usage_limit_reached`, Google `resource_exhausted`). `classifyGatewayError` now reuses `pi-ai`'s central `isUsageLimitError` heuristic and reports those failures as `429 rate_limit_error`. `streamSimple`'s pre-emit retry hook fires on usage-limit phrasing in addition to HTTP 401; the gateway's refresh callback branches on the error type and calls `AuthStorage.markUsageLimitReached(provider, sessionId, { retryAfterMs })` \u2014 temporarily blocking just the exhausted credential and surfacing the next sibling \u2014 instead of `invalidateCredentialMatching`, which would have suspect/deleted the row. The same branching is wired into the coding-agent `streamFn` callback so subscription multi-account rotation works the same on both surfaces.\n- Fixed `extractRetryHint` not recognising Codex's `Try again in ~N min.` / `\u2026 hour` / `\u2026 hours` phrasing, which left the gateway and TUI without a server-suggested retry window when an upstream account hit its usage cap. The shared `try again in` pattern now accepts `min`, `minutes`, `mins`, `h`, `hr`, `hour`, `hours` units in addition to `ms` / `s` / `sec`, and tolerates a leading `~` and embedded whitespace.\n- Fixed the auth-gateway threading `sessionId: undefined` into `AuthStorage.getApiKey`, which left `#sessionLastCredential` empty and made `markUsageLimitReached` a no-op for gateway-mediated requests. Both `/v1/chat/completions`-style endpoints and the `/v1/pi/stream` fast path now derive a stable `sessionId` from the client's `prompt_cache_key` (or the existing model+system+tools+first-message hash when absent) and reuse the same identity for credential-stickiness and prefix-cache routing.\n- Fixed `eval` tool to resize large displayed images and append dimension notes to text output\n- Fixed `write` tool to strip malformed or loose hashline section headers before writing file content\n- Fixed `eval` tool image rendering to resize displayed images before returning them and append image-dimension notes to text output\n- Fixed `write` tool output sanitation to strip malformed or loose hashline section headers before writing file content\n- Fixed `omp auth-broker serve` crashing at startup with `logger.setTransports is not a function` \u2014 switched the call site to `import { setTransports } from \"@oh-my-pi/pi-utils/logger\"`, bypassing the `logger` namespace re-export that some Bun versions failed to expose at runtime\n- Fixed user shortcut Python execution to namespace session IDs like eval, so both paths share one kernel\n\n### Security\n\n- Secured `vault://` reads and writes by validating URL paths and blocking traversal, absolute paths, and symlink escapes outside the selected vault root\n\n## [15.5.7] - 2026-05-27\n\n### Added\n\n- `providers.openrouterVariant` setting (Settings \u2192 Providers \u2192 \"OpenRouter Routing\") to default OpenRouter requests to a routing-variant suffix (`:nitro`, `:floor`, `:online`, `:exacto`). Selectors that already name a variant (e.g. `openrouter/anthropic/claude-haiku:nitro`) keep precedence.\n- `generate_image` supports xAI Grok Imagine via `providers.image=xai`. Supports `grok-imagine-image` (default) and `grok-imagine-image-quality` at aspect ratios `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`. Uses the xAI Grok OAuth credential when available, otherwise `XAI_API_KEY`.\n- New `tts` tool synthesises speech via xAI Grok Voice behind the disabled-by-default `tts.enabled` setting. Built-in voices `ara`, `eve` (default), `leo`, `rex`, `sal`; custom voice IDs also accepted. Output codec inferred from the `output_path` suffix (`.wav` \u2192 `wav`, else `mp3`). Up to 15,000 characters per request.\n\n### Fixed\n\n- Fixed plan-mode re-entry after approval reopening a fresh `local://PLAN.md` instead of the approved titled plan artifact, which could duplicate plan content and fail approval on an existing destination.\n- Fixed `read` URL reader mode aborting after a stalled Jina request instead of falling back to trafilatura/lynx/native: Jina (and Parallel extract) now have their own per-attempt sub-budget capped at 10s, the catch handler honours only real user cancellation, and the in-process native renderer is always attempted on already-loaded HTML ([#1449](https://github.com/can1357/oh-my-pi/issues/1449))\n\n## [15.5.6] - 2026-05-27\n\n### Added\n\n- Support for multi-range line selectors on URLs (e.g., `:5-10,20-30`) to fetch and display multiple non-contiguous sections\n- Support for combining `:raw` mode with line range selectors on URLs (e.g., `:raw:1-120` or `:1-120:raw`)\n- Support for line range selectors on directory listings (e.g., `:30-40` to view lines 30\u201340 of a directory tree)\n- Clear error message when requesting a line offset beyond the end of a directory listing\n\n### Changed\n\n- URL selector parsing now supports multiple trailing selector tokens (e.g., `:raw:N-M`), applying them left-to-right\n\n### Fixed\n\n- Fixed `:raw` selector being ignored for JSON and feed URLs, causing them to be pretty-printed or converted to markdown instead of returning raw content\n- Fixed directory listing line selectors silently dropping the offset parameter and only applying the limit\n\n## [15.5.5] - 2026-05-27\n\n### Changed\n\n- Removed the model-facing `path` property from hashline edit tool parameters; hashline edit targets now come from `\u00b6PATH` headers in `input`.\n\n### Fixed\n\n- Fixed legacy pi-* extension loading regression where `import { Type } from \"@(scope)/pi-ai\"` (e.g. `@earendil-works/pi-ai` used by `@plannotator/pi-extension`) failed with `Export named 'Type' not found` after pi-ai 15.1.0 removed the root `Type` runtime export; the legacy-pi compat layer now redirects bare `@oh-my-pi/pi-ai` root imports through a sibling shim that re-exports the canonical pi-ai surface plus the Zod-backed `Type` runtime from the same TypeBox shim served to `@sinclair/typebox` imports ([#1437](https://github.com/can1357/oh-my-pi/issues/1437))\n\n## [15.5.4] - 2026-05-27\n\n### Breaking Changes\n\n- Removed the package root `hashline` export so imports from the top-level entrypoint can no longer access `hashline` helpers directly\n\n### Added\n\n- Added `read.summarize.minTotalLines` setting (default 100) to set the minimum file length that triggers read summarization\n- Added `:` support to `search` `paths`, allowing file-scoped constraints such as `:N-M`, `:N+K`, and comma-separated ranges\n\n### Changed\n\n- Changed multi-section hashline `edit` execution to defer LSP diagnostics flushing until the final section is written\n- Changed read to return verbatim contents for files shorter than `read.summarize.minTotalLines` instead of summarizing them\n- Changed `search` path line-range filtering to include only matches and context lines that fall inside the requested ranges\n\n### Fixed\n\n- Fixed multi-section hashline edits to reject duplicate canonical targets and preflight write guards before any section is committed\n- Fixed `createAgentSession()` dropping the hidden `resolve` tool from the registry when no active tool sets `deferrable: true`, even though plan mode dispatches the plan-approval `resolve { action: \"apply\", ... }` call through a standing handler. Read-only plan-mode toolsets (e.g. `read`, `search`, `find`, `web_search`) silently activated plan mode without `resolve`, leaving the agent unable to submit the finalized plan and forcing the user to exit plan mode manually. `resolve` is now kept whenever `plan.enabled` is true, so the standing handler always has a callable tool ([#1428](https://github.com/can1357/oh-my-pi/issues/1428))\n- Fixed `omp` startup and `/changelog` reading the host project's `CHANGELOG.md` as omp's \u2014 `getPackageDir()` no longer falls back to the user's `cwd` when no owning `package.json` is locatable, preventing spurious `lastChangelogVersion` writes ([#1423](https://github.com/can1357/oh-my-pi/issues/1423))\n\n## [15.5.3] - 2026-05-27\n\n### Breaking Changes\n\n- Disallowed inline payload on hashline `\u2191`, `\u2193`, and `:` operations (including BOF/EOF inserts), requiring payload text to be supplied on standalone `+` continuation rows\n\n### Changed\n\n- Warned when legacy inline `LINE:TEXT` lines are accepted as payload continuations only when inside a pending multi-line `A-B:` replacement\n\n## [15.5.2] - 2026-05-26\n\n### Breaking Changes\n\n- Changed the hashline patch format so payload continuation lines now require a leading `+`, rejecting unprefixed multiline payload rows that were previously accepted as fallback payload text\n\n### Changed\n\n- Changed hashline payload parsing so blank lines are only preserved when prefixed with `+`, so blank separator lines between operations are ignored unless explicitly marked\n- Changed payload escaping so a line beginning with `+` is now represented as `++...` while the leading marker is stripped before writing\n- Changed the default `task.simple` mode from `default` to `schema-free`, so task-call `schema` inputs are disabled by default while shared `context` and user prompt/session-defined output schemas remain available\n- Changed `tools.approvalMode: yolo` to auto-approve tool calls even when a tool marks `override: true`; user `tools.approval.` policies (`allow`/`prompt`/`deny`) now remain the only controls for yolo mode.\n- Changed the hashline edit executor to coalesce two consecutive `A-B:` ops on the identical range last-wins (the model painted a before/after pair) and append a warning, instead of throwing `anchor line X is already targeted by the :/! op on line Y`. Other overlap shapes (different ranges, `A-B:`+`!`, `!`+`!`) still throw.\n\n### Fixed\n\n- Fixed nested replace parsing so line-anchored `N:` rows inside a pending `A-B:` replacement now trigger overlap errors instead of being silently folded into the replacement payload\n\n## [15.5.1] - 2026-05-26\n\n### Breaking Changes\n\n- Removed the `href`, `hrefr`, and `hline` Handlebars prompt helpers along with the shared hashline anchor state; none were referenced by any built-in or user prompt template\n\n## [15.5.0] - 2026-05-26\n\n### Added\n\n- Added per-tool approval declarations so each built-in, custom, or extension tool can declare its capability tier and approval prompt details.\n- Added `OMP_MCP_TIMEOUT_MS` environment variable to override MCP client request timeout for every server (in milliseconds); set to `0` to disable client-side timeouts. Invalid (negative or non-numeric) values are ignored with a warning and fall back to the per-server timeout or default 30s ([#1415](https://github.com/can1357/oh-my-pi/pull/1415)).\n- Added `omp auth-broker list` (with `--json` for machine-readable output) to enumerate supported OAuth providers, replacing `bunx @oh-my-pi/pi-ai list`.\n- Added interactive provider selection to `omp auth-broker login` and `omp auth-broker logout` when invoked without a provider argument (replacing the equivalent `bunx @oh-my-pi/pi-ai login`/`logout` flows). The logout picker is sourced from stored credentials so it only lists providers the user is actually signed in to.\n- Added directory matches to the `find` tool: glob searches now return directories alongside files, with directory hits emitted with a trailing `/` marker. `find` for `**/tests` no longer requires a follow-up `read` to surface a directory hit; tool prompt and output docs were updated to reflect that paths may be either kind.\n- Added the RFC 8414 \u00a73.1 path-ful issuer form (`/.well-known/oauth-authorization-server`) as a third candidate in MCP OAuth discovery, after origin-root and path-prefixed well-known URLs, so deployments that publish authorization-server metadata at the path-ful location resolve correctly. Single-segment authorization URLs (e.g. `https://gateway/my-service`) are now treated as the gateway prefix instead of being dropped back to the origin root.\n\n### Changed\n\n- Changed tool-approval prompts to use an explicit `Approve`/`Deny` selector and surface the denial reason as contextual help text instead of a bare confirm/cancel toggle.\n- Changed approval safety overrides to prompt even in `yolo` / `--auto-approve` sessions, so critical tool-declared patterns no longer run unattended.\n- Changed `omp auth-broker login` to drive the per-provider OAuth/API-key flow in-process via `AuthStorage.login()` instead of spawning the `pi-ai` CLI subprocess. The `pi-ai` bin is being removed; the same login surface now lives entirely inside `omp`.\n- Changed the default per-line truncation cap for search/grep output (`DEFAULT_MAX_COLUMN`) from `1024` to `512` characters to keep wide minified single-line bundles from blowing out the model's context.\n- Changed `edit.hashlineAutoDropPureInsertDuplicates` to also fire on `A-B:payload` replacement ops when a single non-structural boundary payload line duplicates the line immediately above the deleted range (prefix) or immediately below it (suffix). Catches the common mistake of `A-B:foo` where the user meant `A-B!` but typed a payload that happens to match adjacent context. The existing 2+-line block absorb and balance-validated structural single-line absorb already covered the multi-line and structural-delimiter cases; this closes the single-line non-structural gap.\n\n### Fixed\n\n- Fixed the agent loop and bash executor busy-spinning when scheduler waits returned early. napi `uv_async_send` callbacks can wake the event loop after only ~1\u20132 ms even when the caller asked for a longer sleep, so `yieldIfDue()` now compensates by retrying `Bun.sleep()` until the requested wall-clock duration has elapsed, and the bash executor wraps its `runPromise`/timeout/abort race in an `ExponentialYield` (20 ms \u2192 10 s) so long-running commands stop hot-looping on the race. Yields are additionally throttled by a module-level 50 ms gate, and losing timers in the race are aborted via `AbortSignal` so they don't keep firing after a winner is selected ([#1396](https://github.com/can1357/oh-my-pi/pull/1396) by [@hezhiyang2000](https://github.com/hezhiyang2000), closes [#1384](https://github.com/can1357/oh-my-pi/issues/1384)).\n- Fixed streaming edit previews going blank for inline-payload ops. `LINE\u2193payload` / `A-B:payload` are valid single-line writes, but the natural-order preview was skipping the entire op token until a newline arrived \u2014 so the first character the model typed after the sigil only appeared after the next line ended, and the renderer would fall back to rendering the raw `A-B: bla bla bla` input. Inline-body content on `op-insert` and `op-replace` tokens is now emitted as a `+payload` line on the same op tick.\n- Fixed `/usage` and the status-line reset countdown rendering stale negative deltas after a Codex window had elapsed: Codex keeps reporting the prior window's `reset_at` until a new request opens a fresh window, which turned the `resets in \u2026` suffix into a meaningless negative duration. `formatDuration` now clamps non-positive, NaN, and infinite inputs to `0ms`, and both renderers suppress the `resets in \u2026` suffix entirely once `resetsAt <= now`.\n- Fixed auto-handoff race at the context threshold: when `compaction.strategy = handoff` fired at `agent_end` with an active checkpoint or incomplete todos, the deferred handoff post-prompt task and the rewind/todo-completion path both scheduled work concurrently, so a fresh `agent.continue()` streamed a new assistant turn alongside the handoff LLM call (visible as the \"Auto-handoff\" loader plus an assistant message still streaming, with the chat container then rebuilt mid-stream). `#checkCompaction` now reports whether it deferred a handoff and the `agent_end` handler short-circuits the rewind/todo passes; `#scheduleAgentContinue` also skips when `isCompacting || isGeneratingHandoff`. The pre-prompt `#checkCompaction` call now forces inline execution (`allowDefer = false`) so the new turn cannot begin until the maintenance settles.\n- Fixed `/exit` and Ctrl+C-double-tap hanging when a deferred handoff was mid-flight: `AgentSession.dispose()` now aborts retry/compaction (auto-compaction + handoff) and the agent stream before draining `#cancelPostPromptTasks`, so the post-prompt task awaiting `generateHandoff` rejects and `Promise.allSettled` can resolve. Tool work (bash/eval/python) is intentionally still left for the existing dispose paths so shared kernels continue to survive across session dispose.\n\n## [15.4.3] - 2026-05-26\n\n### Fixed\n\n- Fixed Google Vertex cached project discovery replacing the bundled fallback catalog so `/models` does not keep showing outdated Gemini entries after authoritative Vertex discovery ([#1412](https://github.com/can1357/oh-my-pi/issues/1412)).\n\n## [15.4.2] - 2026-05-26\n\n### Fixed\n\n- Fixed plan-mode subagents being unable to terminate because `yield` was registered but missing from the active tool set when `requireYieldTool` was combined with an explicit `toolNames` list ([#1408](https://github.com/can1357/oh-my-pi/issues/1408))\n\n## [15.4.1] - 2026-05-26\n\n### Breaking Changes\n\n- The `vim` edit mode option is no longer available; configurations using `edit.mode: vim` will be automatically mapped to `hashline` mode\n- Hashline payload semantics are now strictly inline-first: the first payload line is whatever follows the sigil on the op line itself, and subsequent lines append after it. A newline immediately after `\u2191`/`\u2193`/`:` is no longer a free separator \u2014 it produces a blank first payload line. Use `LINE\u2193content` for a one-line insert, `LINE\u2193firstline\\nsecondline` for two lines; bare `LINE\u2193` / `LINE\u2191` / `LINE:` (no inline payload) still insert/replace with one blank line as before.\n\n### Added\n\n- Added `irc.timeoutMs` setting to configure IRC message timeout duration with a default of 120 seconds\n- Added timeout enforcement for IRC send operations to prevent indefinite hangs when recipients are unresponsive\n- Added evaluator state inheritance for `task`-spawned subagents so JavaScript and Python variables are visible between a parent agent and its child sessions\n- Added `hashline-per` edit mode to restore the legacy per-line hashline dialect alongside the default file-hash dialect\n- Added file-hash computation and validation for hashline sections to detect stale edits\n- Added file-read snapshot caching with multi-snapshot ring per path for recovery from agent's own writes\n- Added delete operation (`!`) support to hashline grammar for explicit line deletion\n- Added structural bracket/brace balance warnings when deleting lines with unclosed constructs\n- Added file-hash computation and validation for hashline sections to detect stale edits\n- Added file-read snapshot caching with multi-snapshot ring per path for recovery from agent's own writes\n- Added delete operation (`!`) support to hashline grammar for explicit line deletion\n- Added structural bracket/brace balance warnings when deleting lines with unclosed constructs\n\n### Changed\n\n- Changed Python shared eval sessions to be keyed by `sessionId` and `cwd` so code state no longer leaks across different directories when reusing a session\n- Changed shared JavaScript and Python startup to deduplicate concurrent first-time session initialization so parallel first calls share one warm session\n- Changed shared JavaScript and Python execution output handling so interleaved async runs keep their `display` output scoped to the originating run\n- Changed Python tool bridge to use per-run identifiers alongside session IDs for correct routing of tool responses and output in concurrent evaluations\n- Changed JavaScript and Python `eval` execution to allow overlapping asynchronous cells on the same session ID to run concurrently instead of being strictly queued\n- Updated the edit mode option set to support `replace`, `patch`, `hashline`, and `apply_patch` variants\n- Bare `A:` / `A-B:` (no payload, no inline body) now replaces the line/range with a single blank line, symmetric with bare `A\u2191` / `A\u2193` inserting a blank line; previously rejected as ambiguous\n- Simplified hashline anchor format from `LINE+HASH` to bare `LINE` numbers in edit operations\n- Updated hashline file headers to include 4-hex file hash: `\u00b6PATH#HASH` format for anchored edits\n- Changed hashline line separator from `|` to `:` in editable output (e.g., `42:content` instead of `42ab|content`)\n- Removed per-line hash validation; file-level hash now validates entire section integrity\n- Updated read/search output to emit file-hash headers (`\u00b6PATH#HASH`) followed by numbered lines for hashline mode\n- Modified hashline grammar to accept optional file hash in headers and removed hash requirements from line anchors\n- Changed hashline diff preview format to use `LINE:content` instead of `LINE+HASH|content`\n- Updated prompt documentation to reflect new `\u00b6PATH#HASH` header and bare line-number syntax\n- Bare `A:` / `A-B:` (no payload, no inline body) now replaces the line/range with a single blank line, symmetric with bare `A\u2191` / `A\u2193` inserting a blank line; previously rejected as ambiguous\n- Simplified hashline anchor format from `LINE+HASH` to bare `LINE` numbers in edit operations\n- Updated hashline file headers to include 4-hex file hash: `\u00b6PATH#HASH` format for anchored edits\n- Changed hashline line separator from `|` to `:` in editable output (e.g., `42:content` instead of `42ab|content`)\n- Removed per-line hash validation; file-level hash now validates entire section integrity\n- Updated read/search output to emit file-hash headers (`\u00b6PATH#HASH`) followed by numbered lines for hashline mode\n- Modified hashline grammar to accept optional file hash in headers and removed hash requirements from line anchors\n- Changed hashline diff preview format to use `LINE:content` instead of `LINE+HASH|content`\n- Updated prompt documentation to reflect new `\u00b6PATH#HASH` header and bare line-number syntax\n\n### Removed\n\n- Removed the `installH2Fetch()` activation from CLI startup; HTTPS fetches now use Bun's default transport\n- Removed the `vim` edit mode along with the `VimTool` module, prompt, and supporting buffer/engine/renderer stack\n- Removed per-line hash anchors (2-letter bigram hashes) from hashline format\n- Removed `RANGE_INTERIOR_HASH` constant; multi-line ranges no longer use `**` filler\n- Removed `HashMismatch` type and hash mismatch error reporting; replaced with file-level validation\n- Removed per-line hash anchors (2-letter bigram hashes) from hashline format\n- Removed `RANGE_INTERIOR_HASH` constant; multi-line ranges no longer use `**` filler\n- Removed `HashMismatch` type and hash mismatch error reporting; replaced with file-level validation\n\n### Fixed\n\n- Fixed JavaScript module reloading to refresh local re-exports when transitive dependency files are edited\n- Fixed Python tool calls in warm kernels to initialize once bridge environment variables appear after startup and to return a clear `tool bridge is unavailable` error when missing\n- Fixed IRC `send` handling to preserve recipient incoming messages when auto-reply timeouts instead of dropping them\n- Fixed Python session disposal to cancel all concurrent active executions in a shared kernel\n- Fixed JavaScript `eval` imports to preserve module-level singletons across re-imports of unchanged local files and reload them only after edits\n- Fixed concurrent Python evaluator tool calls to use per-run identifiers so tool responses and output are routed to the correct execution\n- Fixed the `search` tool argument validation to accept a single string `paths` value as a one-path search.\n\n## [15.4.0] - 2026-05-26\n\n### Breaking Changes\n\n- Replaced the hashline patch format from `\u00a7`, `\u00ab`, `\u00bb`, `\u2254`, and `..` to `\u00b6`, `\u2191`, `\u2193`, `\u2192` with range separators written as `A-B`, requiring users to migrate hashline edit inputs\n\n### Added\n\n- Added `codex` and `gemini` to the web search provider settings so users can configure OpenAI and Gemini web search directly from provider selection\n- Added OpenAI (`codex`) and Gemini web search options with updated setup descriptions for `omp /login openai-codex` and Gemini OAuth login\n- Added pretty-printing for wide JSON `data:` payloads in the raw provider-stream debug viewer so streamed event bodies expand across multiple `data:` lines instead of getting clipped by the per-line truncator, and updated the viewer header to read `raw provider stream (SSE + WS)` now that Codex WebSocket frames also flow through the buffer\n\n### Changed\n\n- Updated hashline operation syntax to support inline payload text on the same op line for insert and replace (`ANCHOR\u2191/\u2193/...\u2192`) while still accepting payload lines that follow\n- Updated hashline anchor parsing so copied `|TEXT` decorations remain cosmetic and payload must be provided on or after the operator\n- Unified subagent output-schema validation into a single shared module (`tools/output-schema-validator.ts`) used by both the in-process `yield` tool (validates before the subagent yields) and the executor's post-mortem `finalizeSubprocessOutput` path (validates after subprocess exit). Previously each side ran its own `normalizeSchema` \u2192 `jtdToJsonSchema` \u2192 `validateJsonSchemaValue` chain in parallel, which was semantically equivalent but invited drift: a future tweak on one side could silently disagree with the other and cause yields that pass in-tool to fail post-mortem (or vice versa). The unification preserves both call sites' existing behavior (yield throws an actionable per-issue error for the model; executor produces a `schema_violation` outcome with the first issue and missing-required fields) by exposing two output formatters (`formatAllValidationIssues` for retries, `formatValidationIssueHeadline` for headlines).\n- Changed web search provider credential lookup to use the shared `AuthStorage` pipeline (`getApiKey`/`getOAuthAccess`) for API-key and OAuth auth instead of direct `AgentStorage` access\n- Changed the `codex` web search provider display label from `Codex` to `OpenAI`\n- Updated `anthropic` and `openai`/`gemini` web search option descriptions to reflect their native `web_search`/OAuth requirements\n\n### Fixed\n\n- Fixed hashline inline payload parsing so same-line payloads containing whitespace, including tab-indented text, are preserved instead of being rejected\n- Fixed Bun HTTP/2 transport errors (`HTTP2StreamReset`, `HTTP2RefusedStream`, and `HTTP2EnhanceYourCalm`) to be treated as transient so the assistant now retries automatically instead of stopping on these recoverable failures\n- Fixed web search OAuth-backed providers (including Codex and Gemini) to use broker-managed token retrieval and account metadata, avoiding direct token-store refresh behavior that could cause search authentication failures\n- Updated Tavily missing-credential feedback to prompt users to configure an API-key provider setting instead of referencing `agent.db` directly\n- Refreshed expired OpenAI Codex OAuth tokens during `web_search` execution and persisted the updated credentials so searches continue working after token expiry\n- Fixed built-in `explore` agent failing every invocation with `schema_violation: files.0.ref: must not be present` on releases prior to 15.3.2 by renaming the `files[].ref` property to `files[].path` in the agent's output schema; `ref` is a JTD-reserved keyword (RFC 8927) and collides with JSON Type Definition's schema-reference form, so the converter previously dropped it from the generated JSON Schema. Defense-in-depth alongside the 15.3.2 converter fix ([#1379](https://github.com/can1357/oh-my-pi/issues/1379)).\n- Increased the `yield` tool's schema-validation retry budget from 1 to 3 so subagents whose first structured-output attempt mismatches the declared output schema get up to three retries before the parent's post-mortem `schema_violation` check hard-fails the task. The tool now also surfaces remaining retry attempts and an explicit \"call yield again with the corrected shape\" directive in each rejection message, giving the model the context it needs to converge \u2014 particularly helpful for models like GLM that tend to invent per-element field names instead of following the declared schema.\n\n## [15.3.2] - 2026-05-25\n\n### Added\n\n- Added inline `|TEXT` payload support to `\u00bb` and `\u00ab` hashline insert operations, allowing single-line inserts on the op line and still supporting additional payload lines\n- Added support for using inline payloads with BOF/EOF inserts so `|TEXT` is treated as inserted content at file boundaries\n- Added live nested-`task` rendering: while a subagent is mid-flight, the parent UI now surfaces both completed nested `task` sub-calls and the in-flight nested snapshot (forwarded from `tool_execution_update`), matching the finished-result tree\n- Added `omp auth-gateway check` (and matching `GET /v1/credentials/check` endpoint) \u2014 probes each broker-supplied credential against its provider's auth-verifying usage endpoint and prints per-credential health, so when a multi-account pool starts returning 401s you can identify which row in the broker is the bad one. The existing `/v1/usage` endpoint silently drops failed credentials, which is the wrong shape for diagnosing auth \u2014 the new endpoint captures errors and surfaces the credential's id, provider, type, email/accountId, and the upstream error string. CLI groups results per-provider, exits non-zero when any credential failed, and supports `--json` for scripting. The probe also exercises OAuth refresh on expired tokens, so a working refresh + working access reports as `ok` and a revoked refresh token reports as `oauth refresh failed: \u2026` instead of being masked by the cached expired access token.\n\n### Fixed\n\n- Fixed parsing of inline `|TEXT` payloads containing whitespace on `\u00bb` and `\u00ab` inserts, which previously failed with unrecognized-op errors\n- Fixed anchored insert handling so an inline `|TEXT` body matching the anchor line is treated as anchor decoration and no longer inserted as a duplicate\n\n## [15.3.0] - 2026-05-25\n\n### Added\n\n- 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)\n- 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))\n- 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))\n- 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)).\n- Fixed append-only context mode not being recomputed after model switches \u2014 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\n\n### Fixed\n\n- 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))\n\n## [15.2.4] - 2026-05-22\n\n### Breaking Changes\n\n- Replaced the legacy `@@` header and `+`/`<`/`=`/`-` hashline syntax with the new `\u00a7PATH` header and `\u00ab`/`\u00bb`/`\u2254` operation format, so existing hashline scripts and prompts using old symbols must be updated\n\n### Added\n\n- Added one-anchor `\u2254ANCHOR` shorthand equivalent to `\u2254ANCHOR..ANCHOR` for single-line replace/delete\n\n### Changed\n\n- Changed `\u2254A..B` so an omitted payload now deletes the range, and added an explicit empty payload line to keep a literal blank replacement line\n\n### Removed\n\n- Removed the `hsep` prompt helper and `PI_HL_SEP` payload-prefix configuration because hashline payloads are no longer line-prefixed\n\n### Fixed\n\n- 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\n\n## [15.2.3] - 2026-05-22\n\n### Breaking Changes\n\n- Changed PR and task-isolation worktree directory layout to hash-based `~/.omp/wt/-` style paths, replacing the previous nested encoded-repo layout\n\n### Added\n\n- Added `omp worktree` command (alias `wt`) to list and manage agent-managed worktrees under `~/.omp/wt`\n- Added `omp worktree clear` to remove orphaned worktree directories, with `--all` to include live PR-checkouts, `--dry-run` for preview, and `--json` reporting\n- Added machine-readable JSON output to `omp worktree list` for scripted inspection\n- Added `display.shimmer` appearance setting with `classic`, `kitt` (Knight Rider K.I.T.T. scanner), and `disabled` modes\n\n### Changed\n\n- Changed the welcome intro animation to a 3-second eased gradient sweep with a diagonal shine highlight across the logo\n- Changed background job completion follow-ups to batch multiple finished jobs into a single `async-result` message, showing each completed job and its result in one place\n- Changed MCP notification follow-ups to combine multiple resource updates into a single consolidated message and suppress duplicate server/uri entries\n- Updated PR checkout to reuse `hashPath`-based worktree roots when creating and scanning worktrees for cleanup\n- Updated `worktree` cleanup logic to gracefully prune parent git metadata after removing worktree directories\n- Reworked working-message shimmer animation for 60fps rendering: ANSI sequences are coalesced per same-tier run instead of emitted per code point, palettes compile once and cache per active theme, and the band position is now fractional so motion is smooth at any frame rate\n- Switched MCP health-check and \"Connecting to\u2026\" spinners from hard-coded ASCII (`|/-\\`) to `theme.spinnerFrames` so they pick up the active symbol preset (braille on unicode/nerd, ASCII when explicitly themed)\n\n### Fixed\n\n- Fixed PR checkout failures when the default worktree path was already registered or occupied by stale leftovers by automatically selecting suffixed alternatives (`-2`, `-3`, etc.)\n- Fixed Memory tab in the settings UI not revealing or hiding the Hindsight-only rows (`Hindsight API URL`, `Hindsight Bank ID`, `Hindsight Scoping`, etc.) when `Memory Backend` was switched via the inline submenu. The selector now rebuilds its item list after every change so condition-gated rows appear/disappear immediately instead of requiring a tab switch\n\n## [15.2.2] - 2026-05-22\n\n### Fixed\n\n- Fixed `RULES.md` not being injected. The documented sticky-rules file at `~/.omp/agent/RULES.md` and `/.omp/RULES.md` was never read by any discovery provider; only `.omp/rules/*.md` was scanned. The native provider now loads both as always-apply rules so they re-attach every turn as documented ([#1266](https://github.com/can1357/oh-my-pi/issues/1266)).\n\n## [15.2.1] - 2026-05-21\n\n### Fixed\n\n- Fixed compaction routing to the wrong provider when `modelRoles.default` is set to a different model than the active chat. Auto- and manual compaction now prefer the active session's model and only fall back to role-based candidates when the current model has no usable credentials. Previously, an Anthropic chat with `modelRoles.default = openai/gpt-5` would compact through OpenAI (including the remote-compaction endpoint), even though the live conversation never used OpenAI.\n- Fixed context overflow not being detected when the session's model (e.g. `hf:zai-org/GLM-5.1` via `synthetic` provider) returns a 400 with the upstream \"400 status code (no body)\" message wrapped inside a JSON envelope. The `isContextOverflow` check now matches the no-body status phrase anywhere in the error string rather than requiring it at the very start, so auto-compaction fires correctly instead of leaving the session silently stuck ([#1251](https://github.com/can1357/oh-my-pi/issues/1251)).\n- Fixed `formatCapturedHttpError` not extracting the error text from `{\"error\":\"string\"}` response bodies (only object-valued `error` fields were previously handled), resulting in raw JSON in error messages instead of the human-readable string.\n\n## [15.2.0] - 2026-05-21\n\n### Changed\n\n- Changed the interactive working loader and slash-command progress bars to use the active theme's accent shimmer instead of static muted text.\n\n### Fixed\n\n- Fixed false-positive hashline `~ TEXT` separator-padding warning firing on YAML, JSON, Python, Markdown, TOML, and other indent-sensitive file edits. The padding check is now skipped entirely for indentation-sensitive extensions (`.py`, `.yml`/`.yaml`, `.md`/`.mdx`, `.json`/`.jsonc`/`.json5`, `.toml`, `.rst`, `.tf`, `.nix`, `.coffee`, `.haml`/`.slim`/`.pug`, `.sass`/`.styl`, `.nim`, `.cr`, `.elm`, `.fs`, \u2026), and tightened on every other extension to flag only the `~ beta` typo shape (exactly one leading space before non-space content) rather than any leading-space payload.\n- Fixed goal state machine: `get` now returns paused goals (was returning null for `enabled=false`), `complete` now works on paused goals after interrupts, `create` is allowed after a previous goal reaches `complete` status, and the goal tool is re-added to the active tool set on session reload when a paused goal is persisted. Added `resume` and `drop` ops to the goal tool so the agent can re-engage or discard a paused goal without requiring user slash commands. ([#1249](https://github.com/can1357/oh-my-pi/issues/1249))\n\n## [15.1.9] - 2026-05-21\n\n### Fixed\n\n- Fixed `disabledProviders` still probing local discovery endpoints for Ollama, llama.cpp, and LM Studio during background model refresh. Disabled providers are now excluded before implicit and built-in discovery managers are created. ([#1232](https://github.com/can1357/oh-my-pi/issues/1232))\n- Fixed `omp acp` auto-discovering host `.mcp.json` servers in parallel with the ACP client's `session/new.mcpServers`, which shadowed client-supplied MCP tools in `search_tool_bm25` and the session tool registry. The ACP session factory now forces `enableMCP: false`, so MCP ownership stays with `AcpAgent#configureMcpServers`. Non-ACP modes keep on-disk discovery. ([#1234](https://github.com/can1357/oh-my-pi/issues/1234))\n- Fixed binary `omp update` rollbacks so a downloaded replacement that fails post-install version verification no longer remains installed over the previous working binary. ([#1240](https://github.com/can1357/oh-my-pi/issues/1240))\n- Fixed `/force ` rejecting Ollama/local models before the requested tool could run; Ollama now receives a named forced choice that the provider transport narrows to the selected tool. ([#1236](https://github.com/can1357/oh-my-pi/issues/1236))\n- Fixed `web_search` freezing the session when an upstream provider stalled. Bun's WinHTTP backend on Windows can silently drop `AbortSignal` once a TCP/TLS connection hangs (oven-sh/bun#15275, oven-sh/bun#18536), so Esc never reached the in-flight fetch and the only recovery was Ctrl+C + `omp --resume`. Every web-search provider's outbound `fetch` (anthropic, brave, codex, exa, gemini, jina, kagi, kimi, parallel, perplexity, searxng, synthetic, tavily, z.ai) now composes the caller signal with a 60s hard timeout via a shared `withHardTimeout` helper, guaranteeing the request settles within a minute even when Bun's abort fails to propagate. Independently, `executeSearch`'s provider-fallback loop was masking real cancellations as ordinary provider errors and returning \"All web search providers failed\"; it now re-throws as `ToolAbortError` the moment the caller's signal aborts, so the session sees a clean cancel on every platform. ([#1221](https://github.com/can1357/oh-my-pi/issues/1221))\n\n## [15.1.8] - 2026-05-20\n\n### Fixed\n\n- 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.\n- 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.\n\n## [15.1.7] - 2026-05-19\n\n### Fixed\n\n- Fixed `debug` launch/attach failures so `configurationDone` no longer masks the underlying DAP launch error, early stop-outcome watchers cannot emit unhandled rejections, and directory-valued launch programs are rejected before adapter selection. ([#1187](https://github.com/can1357/oh-my-pi/issues/1187))\n- 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))\n- 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))\n- Fixed the status-line fast-mode indicator (`\u26a1`) rendering for scoped service tiers (`openai-only`, `claude-only`) even when the active model's provider didn't realize them \u2014 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.\n\n### Added\n\n- Added scoped service tier values to the `serviceTier` setting: `priority (OpenAI only)` and `priority (Claude only)`. They let you opt into premium processing on one provider family without paying premium costs on the other when switching models mid-session. `/fast on` continues to set the unscoped `\"priority\"` (active everywhere supported); `/fast status` and `isFastModeEnabled()` now report `on` for any scoped value too.\n\n### Changed\n\n- Changed `/fast` to be a single provider-agnostic toggle: enabling the command sets `serviceTier: \"priority\"` for every provider, and the anthropic-messages provider translates `priority` into `speed: \"fast\"` plus the `fast-mode-2026-02-01` beta. Anthropic fast mode is currently supported on Claude Opus 4.6 and 4.7; the server rejects other models, which triggers the provider's auto-fallback (request retried without the priority signal, `providerSessionState.fastModeDisabled` persisted for the rest of the session). The session listens for the `\"priority\"` marker in `AssistantMessage.disabledFeatures`, syncs `/fast` off, and emits a warning notice. Re-running `/fast on` clears the per-session disable so the next request actually re-tries priority.\n\n## [15.1.6] - 2026-05-19\n\n### Fixed\n\n- Fixed plan-mode `resolve` looping when grammar-constrained models (e.g. Qwen3.6-35B-MTP via llama.cpp) emit `extra: { title: {} }` instead of a string \u2014 the open `Record` schema for `extra` lets such models drop in an empty object, and the apply guard then hard-threw on every retry. Plan approval now derives the title from `extra.title` when usable, falling back to the plan's first `# Heading`, then the plan filename stem (`local://PLAN.md` \u2192 `PLAN`), then the literal `\"plan\"`. Prompt language relaxed from \"MUST\" to \"SHOULD\" for `extra.title`. ([#1179](https://github.com/can1357/oh-my-pi/issues/1179))\n\n## [15.1.5] - 2026-05-19\n\n### Fixed\n\n- Fixed `ast_grep` and `ast_edit` tool details retaining every per-file parse error \u2014 a scan over hundreds of files with syntax-error nodes inflated `details.parseErrors` to one entry per file, leaking into traces and the renderer's \"X more\" overflow. Errors are now capped at `PARSE_ERRORS_LIMIT` (20) at the source, with the original total preserved in a new `parseErrorsTotal` field for accurate count labels.\n\n## [15.1.4] - 2026-05-19\n\n### Fixed\n\n- Fixed `normalizePlanTitle` rejecting plan titles that contain spaces or common punctuation (e.g. \"My Feature Plan\") \u2014 spaces are now converted to hyphens and other invalid characters are dropped, so models that produce natural-language plan titles no longer loop forever trying to call `resolve`. ([#1176](https://github.com/can1357/oh-my-pi/issues/1176))\n- Fixed `ask` tool prompt example showing the legacy `question`/`options` top-level format instead of the current `questions: [{id, question, options}]` array format; models that closely followed the example generated calls that always failed schema validation. ([#1176](https://github.com/can1357/oh-my-pi/issues/1176))\n- Fixed ACP command and custom tool-call notifications to carry the original tool arguments in replayed and final updates, so command text is preserved and raw input is no longer wrapped\n- Fixed ACP async-job draining to be scoped by session owner so `getAsyncJobSnapshot` and `drainAsyncJobDeliveriesForAcp` no longer consume or expose jobs from other sessions\n- Fixed async job status reporting to include in-flight completions so queued/delivering indicators remain accurate while callbacks are still running\n- Fixed `deferAgentInitiatedTurns` handling during ACP async-job draining so background completion follow-up turns are delivered even when agent-initiated turns are deferred\n- 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))\n- 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))\n\n## [15.1.3] - 2026-05-17\n\n### Breaking Changes\n\n- Renamed the embedded-documentation internal URL scheme from `pi://` to `omp://`. `OmpProtocolHandler` replaces `PiProtocolHandler`; update any external references accordingly.\n- Removed the `StringEnum` re-export from `@oh-my-pi/pi-coding-agent`. Custom tools and extensions should use `z.enum([...])` directly via the injected `pi.zod`.\n- Replaced the `eval` tool's LARK-grammar `input` string with a structured `cells` array. Each cell is `{ language: \"py\" | \"js\", code, title?, timeout?, reset? }`. Removed the implicit/sniffed language path, the `*** Cell` / `*** End` / `*** Abort` markers, and the per-cell `t:` unit suffixes \u2014 `timeout` is now seconds (1-600).\n\n### Added\n\n- Added `providers..transport: \"pi-native\"` to `models.yml`. When set, every model under that provider routes its streaming dispatch through the auth-gateway's `POST /v1/pi/stream` endpoint instead of the per-provider SDK. The provider's `baseUrl` must point at a compatible `omp auth-gateway` and `apiKey` must carry the gateway bearer. The slot's `models.json` still resolves locally for pricing/capabilities/thinking config; only the wire dispatch is redirected. Use case: containerized omp installs (robomp slots, swarm extension) where the slot must stay credential-free and a sidecar gateway holds the real provider tokens. Also surfaced as `transport` on `ProviderConfigInput` for extension-registered providers.\n- Added optional backend push for the auto-QA grievance database (`dev.autoqaPush.enabled`, `dev.autoqaPush.endpoint`, `dev.autoqaPush.token`; env overrides `PI_AUTO_QA_PUSH`, `PI_AUTO_QA_PUSH_URL`, `PI_AUTO_QA_PUSH_TOKEN`). When enabled, every `report_tool_issue` call schedules a background flush that `POST`s pending rows to the configured endpoint and deletes them on HTTP 2xx. Each push carries a stable per-install UUID (`installId`) generated on first use and persisted at `~/.omp/install-id` via `getInstallId()` (new export from `@oh-my-pi/pi-utils`), so the receiver can dedup retries across host renames and `autoqa.db` wipes. Single-flight, 5s request timeout, 30s in-memory cooldown after failure, and a row-id watermark so rows inserted during an in-flight push survive and ship next time. Tool execution remains non-blocking and never throws.\n- `ModelRegistry` now promotes `models.yml` `providers..apiKey` entries to `AuthStorage`'s new config-override tier (above OAuth, below `--api-key`). Pinning a bearer in `models.yml` was previously a no-op when the broker had an OAuth credential for the same provider \u2014 the OAuth access token won and got sent unmodified to whatever `baseUrl` you redirected to, which an auth-gateway in front of that endpoint rightly rejected with 401. The override is now honored, and is cleared/repopulated atomically on `models.yml` reload (`#reloadStaticModels` calls `clearConfigApiKeys` before re-parsing). Use case: route `anthropic` / `openai-codex` to `http://llm-gateway.internal:4000` with the gateway's own bearer.\n- Added `omp auth-broker` subcommand for running and consuming a hosted credential vault.\n- `serve [--bind=host:port]` \u2014 boots a local broker against the SQLite store at `$AGENT_DB_PATH`.\n- `token [--regenerate]` \u2014 prints (and rotates) the bearer token stored at `~/.omp/auth-broker.token`.\n- `login  [--via=user@host] [--dry-run]` \u2014 drives the OAuth flow locally or via SSH `-L` tunnel into a remote broker (callback ports pinned per provider).\n- `logout ` \u2014 disables every credential for the given provider in the local SQLite store.\n- `import  [--provider=] [--include-disabled] [--dry-run]` \u2014 imports CLIProxyAPI-style JSON credential dumps (`~/.cliproxy/auth/*.json`). When `OMP_AUTH_BROKER_URL` is configured, credentials are uploaded to the remote broker via `POST /v1/credential`; otherwise they go into the local SQLite store. JSON `type` is mapped to omp providers (`claude` \u2192 `anthropic`, `codex` \u2192 `openai-codex`, `gemini[-cli]` \u2192 `google-gemini-cli`, `antigravity` \u2192 `google-antigravity`); `--provider` overrides the mapping for unrecognized types.\n- `status` \u2014 pings the configured remote broker (`OMP_AUTH_BROKER_URL`).\n- Added remote credential vault support to `discoverAuthStorage`. Configure via env (`OMP_AUTH_BROKER_URL` / `OMP_AUTH_BROKER_TOKEN`) or by setting `auth.broker.url` and `auth.broker.token` in `~/.omp/agent/config.yml` (hidden from the settings UI; supports `!command` resolution). Falls back to `~/.omp/auth-broker.token` when no token is provided inline. Otherwise behavior is unchanged.\n- Added `omp auth-broker migrate --from-local [--include-env] [--include-oauth] [--dry-run]` \u2014 uploads local SQLite credentials (and optionally env-var API keys) to the configured broker. Skips anything already on the broker via identity-key matching. OAuth is skipped by default (handled via `cliproxy` import). Idempotent on re-runs.\n- Added `omp auth-gateway` subcommand for running a forward-proxy that hides access tokens from less-trusted clients:\n- `serve [--bind=\u2026]` \u2014 boots the gateway against the configured broker. Listens on `127.0.0.1:4000` by default.\n- `token [--regenerate]` \u2014 manages the gateway bearer token at `~/.omp/auth-gateway.token` (separate from the broker bearer).\n- `status` \u2014 verifies gateway config and authenticated broker readiness.\n- One wire surface: `POST /v1/chat/completions` (OpenAI chat-completions), `POST /v1/messages` (Anthropic messages), `POST /v1/responses` (OpenAI Responses), `GET /v1/usage` (aggregated, 5-min per-credential cache), `GET /v1/models` (catalog). Model id in the request body selects which omp provider/model services it; the gateway translates wire format \u2194 omp canonical `Context` and dispatches through `pi-ai` `streamSimple()`. Container deployments (robomp, etc.) get inference auth without ever holding access tokens or the broker bearer.\n\n### Changed\n\n- Changed TTSR `interruptMode` semantics so a non-interrupting decision on a tool-source match now folds the rule reminder into that specific tool's `toolResult` content instead of queuing a loop-wide deferred follow-up turn. Text/thinking matches keep the previous deferred-injection behavior.\n\n### Fixed\n\n- Fixed streaming API requests to recover from provider auth errors by invalidating stale credentials and retrying with a fresh key\n- Fixed `auth-broker` migration, `auth-gateway` startup, and `discoverAuthStorage` to fail fast with a clear error when the broker snapshot endpoint returns a non-200 response\n- Fixed `omp auth-broker migrate` to skip local placeholder `` API credentials (not real keys) when exporting to a remote broker\n- Fixed `auth-gateway` token initialization to avoid clobbering an existing token when multiple processes initialize it concurrently\n- Fixed `omp auth-gateway` request handling to reject unsupported OpenAI/Anthropic protocol controls with 400 instead of accepting and ignoring them, propagate upstream error/abort terminal states as failures, preserve Responses reasoning and completed text items, accept string/system Responses messages, and keep Anthropic tool-result ordering valid.\n- Fixed gateway usage reporting to include cached-token totals for OpenAI Chat/Responses and to serve the last good cached report during transient upstream usage fetch failures.\n- Fixed auth-gateway request cancellation for requests that are already aborted before dispatch.\n- Fixed `/login` and `/logout` provider selector overflowing tall provider lists off-screen on small terminals. The selector now scrolls a 10-item window centered on the highlighted entry, shows a `(n/total)` indicator when windowed, and accepts PageUp/PageDown for faster navigation.\n\n## [15.1.2] - 2026-05-15\n\n### Fixed\n\n- Fixed SSH host additions/removals made inside a running session not refreshing the live `ssh` tool. `/ssh add` and `/ssh remove` now update the model-visible host list immediately, while `/reload-plugins` and `/move` refresh SSH discovery for external or project-scope config changes without restart.\n- Fixed loose object output schemas in `YieldTool` so non-strict schemas (for example `additionalProperties: true`) are preserved and accepted instead of being forced into strict mode\n- Fixed unconstrained output schema modes (`outputSchema: true` or absent/non-strict schemas) to run in loose mode for successful results\n- Fixed bash tool calls with `pty: true` hanging indefinitely on Windows by falling back to the non-PTY executor instead of entering the ConPTY-backed interactive path. ([#1103](https://github.com/can1357/oh-my-pi/issues/1103))\n\n### Changed\n\n- Updated MCP and theme schema metadata to reference JSON Schema draft-2020-12\n\n## [15.1.0] - 2026-05-15\n\n### Breaking Changes\n\n- Changed the extension and hook runtime API by moving schema typing from direct TypeBox imports to `TSchema` from `@oh-my-pi/pi-ai`, requiring callers who use TypeScript imports of `Type` to migrate via provided injected modules\n\n### Added\n\n- Added a cancellable handoff progress indicator in `/handoff` that displays while handoff generation runs and can be aborted with `Esc`\n- Added `apiKey` as a supported provider override field in model config, allowing API-key-only overrides to provide fallback credentials for built-in models\n- Added `supportsMultipleSystemMessages`, `allowsSyntheticReasoningContentForToolCalls`, `disableReasoningOnToolChoice`, and `levels` model-thinking compatibility fields to model configuration schemas\n- Added `zod` to the Extension, Custom Tool, Hook, and Custom Command APIs as `pi.zod` so extension and plugin authors can define tool schemas with Zod without separate imports\n- Added `pi.zod` as a canonical schema API for examples and extension plugins while keeping `typebox` available as legacy compatibility\n- Added a `telemetry` option to `createAgentSession` for passing OpenTelemetry configuration through to the underlying Agent\n\n### Changed\n\n- Changed handoff generation to run as a one-shot handoff request and switch to the new session only after it completes, avoiding an extra assistant handoff turn in chat history\n- Changed `pi.typebox.Type.Composite` to merge all object schemas in the provided list, enabling more than two object inputs\n- Changed `pi.typebox.Type.Record` to validate record keys against the provided key schema instead of forcing string keys\n- Changed `pi.typebox.Type.Array` with `uniqueItems: true` to reject duplicate items while preserving the constraint in wire schemas\n- Changed `pi.typebox.Type.Object` with `additionalProperties: false` to reject unknown properties during parsing\n- Changed `pi.typebox.Type.Enum` in the compatibility shim to preserve numeric TypeScript enum values\n- Changed tool parameter schemas across the agent to use the shared Pi schema pipeline (`TSchema` plus Zod/JSON Schema validation) instead of direct AJV/TypeBox compilation for stricter schema validation compatibility\n- Changed GitHub tool input schema shape to expose operation fields in a flat schema form without legacy `run_watch`-style nesting\n- Changed Python session pooling to remove the previous 4-session retention cap and 5-minute idle-session eviction, so kernels now stay alive for a session until explicitly disposed via `disposeKernelSessionsByOwner` or `disposeAllKernelSessions`\n- Changed kernel cleanup behavior to avoid automatic eviction by idle timeout and capacity pressure, so additional Python sessions are not queued behind retained-session shutdown retries\n- Replaced the bundled `@sinclair/typebox` runtime dependency with an in-repo Zod-backed shim exposed through `pi.typebox.Type.*`. Common builders (`Object`, `String`, `Number`, `Integer`, `Boolean`, `Array`, `Tuple`, `Union`, `Intersect`, `Literal`, `Enum`, `Optional`, `Nullable`, `Record`, `Partial`, `Required`, `Pick`, `Omit`, `Composite`, \u2026) keep their existing call signatures but now return Zod schemas that flow through the same validation/wire pipeline as `pi.zod`. Bare `@sinclair/typebox` imports inside extensions are transparently remapped to the same shim by the runtime plugin shim, so plugins that authored against `import { Type } from \"@sinclair/typebox\"` keep working unchanged. Plugins that relied on TypeBox-only submodule APIs (`@sinclair/typebox/compiler`, `@sinclair/typebox/value`, `TypeRegistry`, the `Symbol(TypeBox.Kind)` marker) must vendor `@sinclair/typebox` in their own package \u2014 only the root import is remapped.\n\n### Deprecated\n\n- Deprecated direct TypeBox-only examples for plugin schemas by updating example documentation to prefer `pi.zod`\n\n### Fixed\n\n- Fixed auto-triggered handoff flow to perform only a single handoff-generation model call instead of an extra prompt cycle\n- Fixed handoff cancellation behavior so a pre-cancelled signal returns `Handoff cancelled` without starting generation and aborting handoff now propagates through the handoff request signal\n- Fixed `create_conventional_analysis` parsing to ignore harmless extra fields and still parse the required conventional fields\n- Fixed BashTool async request validation flow so async execution remains disabled and returns the explicit `Async bash execution is disabled` error\n- Fixed `task.simple` invalid `schema` and `context` argument handling to still reject unsupported fields after tool-argument validation\n- Fixed subagent execution hangs by enforcing `task.maxRuntimeMs` as a wall-clock limit even when inference streaming stalls, so stuck subagents now abort and report runtime-limit exceeded\n- Fixed tool schema compatibility validation by routing TypeBox schemas through shared conversion and Zod-based validation to avoid strict-schema provider mismatches\n- Fixed Python execution cancellation and timeouts by escalating to kernel shutdown if `SIGINT` did not terminate a running cell within 2 seconds, preventing indefinite hangs in queued or stuck sessions\n- Fixed cleanup blocking during long-running executions by forcing a kernel shutdown path when interrupt-based cancellation is ignored\n- Fixed bash output emitting a spurious `[\u2026 0 lines elided (NB) \u2026]` marker (and reordering the artifact link before the command output) when the shell minimizer rewrote a small command's output. After `OutputSink.replace()` swapped the minimized text into the buffer, the subsequent `sink.push(\"[raw output: artifact://N]\\n\")` chunk was funneled back into the (now empty) head-retention window while the pre-replace `#totalBytes` still tracked the original raw stream \u2014 so `dump()` composed ` +  + ` instead of ` + `. `replace()` now realigns `#totalBytes`/`#totalLines`/`#sawData`/`#truncated` to the authoritative buffer and disables head retention for the lifetime of the sink, so further pushes append to the tail buffer in order. The bash executor also drops the leading `\\n` on the artifact-link push when the minimized text already ends with one so the separator stays single-newline.\n- Fixed legacy plugin extensions failing to load on Windows when they import a bare-specifier dependency from their own `node_modules` (e.g. `import YAML from \"yaml\"` in `supipowers`). The legacy-pi mirror resolved the dependency to its absolute path and then ran the path through `isUrlLikeSpecifier`, whose `^[A-Za-z][A-Za-z\\d+.-]*:` regex matched the Windows drive letter (`C:`) and short-circuited the `pathToFileURL` conversion. The raw path was emitted into the mirrored TS source as `import x from \"C:\\\\Users\\\\...\\\\dep\\\\dist\\\\index.js\"`, where `\\n`, `\\U`, `\\y` and other backslash sequences were eaten by the TS string-literal parser, producing nonsense package specifiers like `C:Usersjames.ompagentextensionssupipowers\\node_modulesyamldistindex.js` that Bun's resolver rejected with `Cannot find package \u2026`. `isUrlLikeSpecifier` now rejects `^[A-Za-z]:[\\\\/]` first, so Windows absolute paths flow through `pathToFileURL` like every other absolute path and reach the mirror as proper `file:///C:/...` URLs.\n- Fixed Python session queued executions silently resurrecting kernels after `disposeAllKernelSessions` or `disposeKernelSessionsByOwner` removed the session: queued work now checks the session is still registered before replacing or executing on a kernel and rejects with cancellation otherwise\n- Fixed Python session disposal treating an unconfirmed `PythonKernel.shutdown()` result as success: sessions whose kernel shutdown returns `{ confirmed: false }` (or rejects) are now retained in the registry and a `warn` is logged so a later dispose can retry instead of orphaning the subprocess\n- Fixed `task.maxRuntimeMs` losing wall-clock aborts that fired during pre-prompt session setup by re-checking the abort signal immediately before issuing the model prompt, so a stalled subagent now exits with the runtime-limit reason instead of hanging through setup races\n- Fixed late `yield` events landing after a wall-clock timeout from flipping a timed-out subagent to a successful exit, so the reported `aborted` flag and exit code now always reflect the runtime-limit breach while yield payloads remain in `extractedToolData`\n- Fixed async-task progress consumer to copy `contextTokens` and `contextWindow` from the completed `SingleResult` onto `AgentProgress`, so UI gauges keep showing per-turn context after a backgrounded task finishes\n- Fixed the status-line `path` segment ignoring `stripWorkPrefix: false` when selecting the folder icon for scratch directories. The icon selection now respects the same gate as the scratch path stripping, so disabling `stripWorkPrefix` keeps the regular `folder` icon even when the project directory is inside a scratch root.\n- Fixed `YieldTool` constructor to fall back to the loose record schema when the session `outputSchema` contains unresolved `$ref` strings (e.g. external or cyclic references that survive dereferencing), instead of installing a validator that would reject every payload with an unresolved-reference error\n- Fixed `pi.typebox.Type.String` dropping `minLength`/`maxLength`/`pattern` constraints when a `format` (e.g. `email`, `url`, `uuid`) was also supplied; length and pattern checks are now applied to the format-specific schema instead of being gated on an `instanceof z.ZodString` check that never matched the format subclasses.\n- Fixed `pi.typebox.Type.Object` stripping unknown properties when constructed without explicit `additionalProperties`. TypeBox preserves extras by default, so the shim now installs `.loose()` for the omitted/`true` cases while keeping `.strict()` for `additionalProperties: false` and `.catchall(schema)` for a schema value.\n\n## [15.0.2] - 2026-05-15\n\n### Added\n\n- Added the `set_host_uri_schemes` RPC command so hosts can register and replace writable/read-only internal URI schemes with scheme metadata (`writable`, `immutable`) at runtime\n- Enabled the `write` tool to dispatch `write(url, content)` to registered internal URL handlers, allowing edits to non-filesystem resources via host-managed URI schemes\n- Added host-owned internal URI read/write over RPC, including abort support, so URI operations are resolved by the host transport for `read` and `write` requests\n- Added handling of host URI request results in RPC mode so host services can stream completion frames for internal URI operations\n- Added scratch-directory awareness to the status-line `path` segment. When the project directory is inside an OS-level scratch root (the platform `os.tmpdir()`, `/tmp` and `/var/tmp` plus their macOS `/private/...` aliases, `~/tmp`, or \u2014 on Windows \u2014 `%TEMP%` / `%TMP%` / `%SystemRoot%\\Temp`), the segment now (1) renders the new `icon.scratchFolder` symbol instead of `icon.folder`, and (2) strips the scratch root from the displayed path so only the trailing folder (and any subpath beneath it) is shown \u2014 mirroring how `/work` and `~/Projects` are already abbreviated. Both behaviors honor the existing `stripWorkPrefix` option. Icon defaults: \ud83d\uddd1 (emoji), `` (nf-fa-trash) for Nerd Font, `[T]` for ASCII, `\u25cc` in the poimandres themes; themes can override `icon.scratchFolder` independently of `icon.folder`.\n\n### Changed\n\n- Changed the `github` tool's search ops (`search_issues`, `search_prs`, `search_code`, `search_commits`) to default the `repo` scope to the current checkout's `owner/repo` when `repo` is omitted. The auto-scope is skipped when the query already carries an explicit `repo:`/`org:`/`user:`/`owner:` qualifier or when `gh repo view` cannot resolve a github remote (in which case the search proceeds across all of GitHub as before). `search_repos` is unchanged \u2014 repository-scoping there must live in the query.\n- Changed bash command preprocessing to strip trailing `| head` and `| tail` pipelines (including `|&`) from each top-level segment in command chains separated by `;`, `&&`, `||`, or `&`\n- Changed bash fixup notices to state that stderr is already merged into stdout and to reflect that fixes were applied for multiple stripped segments when several transforms fire\n- Changed shell-minimizer per-line truncation marker from a bare `\u2026` to `\u2026[+N]`, where `N` is the count of dropped Unicode scalars. The bracketed tally disambiguates minimizer-driven cuts from genuine `\u2026` characters in the source (paths, JSON, stack traces, etc.) and gives the agent an exact count so it can decide whether the missing tail is recoverable inline or warrants reading the `[raw output: artifact://]` footer the bash wrapper already emits when the minimizer rewrites output. Affects pipeline Stage 5 (`truncate_lines_at` in `defs/*.toml`) and the internal callers in `filters/git.rs`, `filters/listing.rs`, and `filters/lint.rs`. ([#1046](https://github.com/can1357/oh-my-pi/issues/1046))\n- Changed bash command preprocessing to use the real `brush-parser` AST via `pi-natives` `applyBashFixups` instead of a hand-rolled top-level mask scanner. The previous regex/character-walking implementation reimplemented quote/heredoc/`$(...)` tracking with conservative bail-outs (notably refusing to fixup commands containing here-strings); the AST-driven version inherits the full shell parser, so semantics-preserving rewrites like stripping `| head -5` off `cat <<<'content' | head -5` now succeed instead of being skipped. No public API change \u2014 `applyBashFixups(command)` returns the same `{ command, stripped }` shape.\n\n### Fixed\n\n- Fixed bash command fixups to remove a redundant standalone trailing `2>&1` redirect when no other pipe or redirection remains\n- Fixed command-fixup notices to list all stripped segments instead of reporting only one\n- Fixed summarized `read` output stalling agents on elided regions by appending an explicit footer like `[NN lines across MM elided regions; read :raw or a line range like :1-9999 for verbatim content]`. The footer fires whenever the structural summarizer elided at least one span, so the model gets a concrete recovery selector instead of having to guess from a bare `...` / `{ .. }` marker. Surfaces `elidedLines` on `ReadToolDetails.summary` alongside the existing `elidedSpans`. ([#1046](https://github.com/can1357/oh-my-pi/issues/1046))\n- Updated the `read` tool prompt to describe the new elision footer and instruct the model to follow `:raw` (or an explicit line range) when the elided body is actually needed, rather than guessing.\n- Fixed plugin extensions failing to load when their `peerDependencies` reference internal `pi-*` packages under any scope other than `@mariozechner` (e.g. `Cannot find module '@earendil-works/pi-tui'` from `@juicesharp/rpiv-ask-user-question`). The legacy-pi specifier shim now treats `@mariozechner`, `@earendil-works`, **and** the canonical `@oh-my-pi` itself as aliases for the same set of bundled in-process packages (`pi-agent-core`, `pi-ai`, `pi-coding-agent`, `pi-natives`, `pi-tui`, `pi-utils`), and additionally rewrites the upstream-only `pi-ai/oauth` subpath onto our `pi-ai/utils/oauth` layout. Restored the `Key` runtime helper export on `@oh-my-pi/pi-tui` to match upstream \u2026\n- Fixed `omp commit` hanging after a successful commit instead of returning to the shell. The command now mirrors the `runPrintMode` exit pattern and calls `postmortem.quit(0)` once the pipeline resolves so lingering HTTP/2 keep-alive sockets, the Settings autosave timer, and other AgentSession background handles don't keep the event loop pinned. ([#1041](https://github.com/can1357/oh-my-pi/issues/1041))\n- Fixed hashline payload parsing to silently treat truly-blank lines as empty `~`-prefixed payload lines when more payload follows in the same run. The previous behavior broke at the blank (\"payload line has no preceding +, <, or = operation.\") even though the intent is obvious \u2014 the only ambiguity is between in-payload blanks and end-of-section blanks, and a one-line lookahead resolves it: blanks that precede a non-payload op still end the run cleanly as section separators. Recovers the common case of forgetting the leading separator on a blank inserted line without changing how trailing blanks between ops behave.\n- Rewrote the hashline edit prompt examples to use an ASCII-only `TITLE = \"Mr\"` \u2192 `\"Mrs\"` / `\"Dr\"` motif instead of the previous `\" \u2022 \"` and `\"\u00b7\"` separators. Some agents had been copying the middle-dot literal characters into real edits as if they were format scaffolding (e.g. emitting payload lines like `~\t\u00b7`), since the demo inserts were near-twins of the existing string. The new example keeps every original op shape (single-line replace, multiline replace, insert AFTER/BEFORE, append, delete, blank, plus both anti-patterns) but uses content that is obviously domain-specific and clearly distinct from any payload separator. Pure prompt change; no parser, schema, or runtime behavior is affected.\n- Fixed startup fallback-chain validation to recognize cached runtime-discovered standard provider models, including Ollama Cloud models listed by `--list-models`, so `retry.fallbackChains` no longer warns that valid `ollama-cloud/` selectors are unknown. ([#1052](https://github.com/can1357/oh-my-pi/issues/1052))\n- Fixed `discoverAgents()` ignoring `disabledProviders` for the `claude-plugins` provider. Plugin roots from `~/.claude/plugins/` were scanned unconditionally, so agents from Claude Code marketplace plugins continued to appear in `/agents` and the Agent Control Center even when `disabledProviders: [claude-plugins]` was set. The discovery path now checks `isProviderEnabled(\"claude-plugins\")` before calling `listClaudePluginRoots()`, matching how every other capability respects the disabled-providers set. ([#1075](https://github.com/can1357/oh-my-pi/issues/1075))\n- Fixed `$env:VAR` PowerShell variables being mangled on Windows when commands invoked PowerShell as a subprocess (e.g. `powershell -Command \"Write-Host $env:SystemRoot\"`). Brush-core applied POSIX parameter expansion to `$env` before spawning the child, leaving a dangling `:NAME`. The fix lives in `pi-shell` at env-var application time: every brush session now defines `env=$env` as an internal shell variable so `$env:NAME` expands to the literal `$env:NAME` token that PowerShell expects. The fallback is not exported, only influences brush's own expansion, and is shadowed by any user assignment to `env` (e.g. `env=prod; echo \"$env:8080\"` still prints `prod:8080`), so the POSIX bash contract is preserved. ([#1079](https://github.com/can1357/oh-my-pi/issues/1079))\n\n## [15.0.1] - 2026-05-14\n\n### Breaking Changes\n\n- Removed the dedicated `exit_plan_mode` tool and its prompt, requiring plan-mode completion to use the existing `resolve` tool path instead\n\n### Added\n\n- Added optional `extra` metadata object to the `resolve` tool so callers can pass context-specific payloads, including plan approval titles\n- Added `hide: true` frontmatter option for skill `SKILL.md` files. Hidden skills are still loaded and remain reachable via `skill://` URLs and (when enabled) `/skill:` slash commands, but are omitted from the rendered system prompt's `` listing so the model won't auto-discover them. Use for skills the user opts into explicitly rather than ones the model should pick up from descriptions.\n- Added middle elision for streaming tool outputs (bash, ssh, python, js eval) and post-execution tool result spill. When `tools.artifactHeadBytes` is set (default 20 KB), large outputs now keep both the first N KB and the last N KB with an inline `[\u2026 N lines elided (M KB) \u2026]` marker between them, instead of dropping everything before the trailing tail. Setting `tools.artifactHeadBytes = 0` reverts to the previous tail-only behavior. The full output is still mirrored to the session artifact (`artifact://`) regardless of elision mode. Exposes `truncateMiddle` and `formatMiddleElisionMarker` from `@oh-my-pi/pi-coding-agent/session/streaming-output`, extends `OutputSinkOptions` with `headBytes`, and adds `direction: \"middle\"` plus `headRange` / `tailRange` / `elidedLines` / `elidedBytes` to `TruncationMeta`.\n- Added per-line column cap shared across streaming tool outputs (`bash`, `ssh`, `python`, `js eval`) and the `read` tool. Lines wider than `tools.outputMaxColumns` bytes (default **768**) are ellipsis-truncated at write time and remaining bytes up to the next `\\n` are dropped \u2014 bounded memory even on multi-MB single-line outputs (e.g. `cat /dev/urandom`). The cap lives on `OutputSink` as the new `maxColumns` option, persists state across chunk boundaries so split-mid-line writes still respect the budget, and exposes `columnDroppedBytes` / `columnTruncatedLines` on `OutputSummary`. Middle-elision byte math subtracts column drops so the \"elided from middle\" count stays honest. `read` reuses the same setting but trims its already-collected lines via `truncateLine`. Skipped when the read selector is `:raw`. The artifact file (`artifact://`) keeps the full uncapped stream. Set `tools.outputMaxColumns = 0` to disable.\n- Added Bun HTTP/2 fetch opt-in. Dev scripts (`bun run dev`, `bun run stats`) now pass `bun --experimental-http2-fetch` so every `fetch()` advertises `h2` in the TLS ALPN list and falls back to HTTP/1.1 when the server doesn't select it. Multiplexing collapses parallel requests to the same origin onto one TLS connection. For the installed `omp` binary, export `BUN_FEATURE_FLAG_EXPERIMENTAL_HTTP2_CLIENT=1` in your shell to enable the same behavior (the flag has to be set before Bun starts; `process.env` from inside JS is too late). Requires Bun **1.3.14**.\n- Added per-subagent cost display (`$X.XX` in the task progress tree and the session-observer stats line). Cost is accumulated incrementally from `message_end` events and shown only when non-zero, using the `statusLineCost` theme color. Providers that do not report per-turn cost data (e.g. subscription/OAuth usage) continue to show nothing.\n\n### Changed\n\n- Changed plan-mode completion to use `resolve { action: \"apply\", reason, extra: { title } }` to request plan approval rather than calling `exit_plan_mode`\n- Changed resolve pending-action previews to trim and truncate long `reason` text for cleaner status-line rendering\n- Raised the image downscaling default JPEG quality from 75 to 80 in `resizeImage` output generation\n- Changed image resize metadata notes from coordinate-scale hints to a simple `Image resized from  to ` message and hide the note when the resized dimensions are unchanged\n- Removed `utils/image-convert.ts` and its `convertToPng` helper; callers now inline `new Bun.Image(bytes).png().toBase64()` from [`Bun.Image`](https://bun.com/docs/runtime/image) (Bun 1.3.14+).\n- Changed image decode/resize/encode in `utils/image-resize.ts` from the native `PhotonImage` binding to [`Bun.Image`](https://bun.com/docs/runtime/image). Same PNG/JPEG/WebP quality+dimension ladder, but pipelines run off-thread on Bun's statically-linked codecs with no native-addon round-trip. Bumped the minimum Bun runtime requirement to **1.3.14**.\n- Changed `search` pagination in multi-file scopes so `skip` now skips entire files and pages results in groups of up to 20 files, with output guiding the next `skip` value via `Showing files X-Y of N`\n- Changed multi-file search result selection to cap each file at 20 matches and round-robin across files, so one noisy file no longer suppresses visibility of hits in other files and truncation now reports per-file limits\n- Changed search truncation metadata/renderer output from match/result-based limits to file-based limits (`fileLimitReached`, `perFileLimitReached`) and updated truncation labels accordingly\n- Lowered `read.defaultLimit` default from `500` to `300` lines, and split the per-range context padding into asymmetric `RANGE_LEADING_CONTEXT_LINES = 1` / `RANGE_TRAILING_CONTEXT_LINES = 3` (was symmetric `RANGE_CONTEXT_LINES = 3`). Replay analysis over post-summarizer sessions (`scripts/session-stats/optimize_read_config.py`) showed that bare-path reads are over-provisioned at the median (file p50 = 220 lines) and that most follow-up reads are disjoint hops rather than adjacent extensions \u2014 so a smaller default plus narrower leading context reclaims tokens without measurably changing first-cover rate. Trailing context stays at 3 lines to keep anchor-stale recovery on narrow reads. Explicit `read.defaultLimit` overrides in settings are honoured unchanged.\n\n### Fixed\n\n- Fixed abrupt process termination data loss during session persistence by moving steady-state session writes to a synchronous path that writes each entry to the kernel page cache before returning\n- Fixed `--help` startup to avoid a config/model-registry load cycle so the root CLI help command now exits successfully in a clean environment\n- Queued `/skill: [args]` invocations now show as compact `Steer: /skill: [args]` / `Follow-up: /skill: [args]` chips in the pending-messages bar and disappear when the agent consumes the queued message (parity with plain-text steer/follow-up). Previously the queued skill was invisible while queued and rendered as a full skill block at consumption with no chip ever appearing.\n- Plan-mode \"Approve and compact context\" no longer surfaces a red \"Operation aborted\" line on the plan-mode assistant message; the silent transition into compaction now renders cleanly on both live and replay paths. Real user-cancel aborts on unrelated turns and the existing \"Compaction cancelled\" path are unchanged.\n- Auto-recover conflict-resolution `write`/`read` paths that the agent malformed as `:conflict://` (or `:conflict://*`) by mixing the `:conflicts` read selector with the `conflict://` scheme. The stripped `:` prefix is stored on `ParsedConflictUri.recoveredPrefix` and, for writes, surfaces as a trailing note in the result text so the agent learns the correct shape. Clean `conflict://\u2026` URIs are unchanged.\n- Fixed hashline edit renderer leaving a stray `@` in the displayed file path when the agent emitted a canonical `@@ PATH` header (or any `@`-run longer than one). Titles like `Edit: @ packages/foo.ts` now render as `Edit: packages/foo.ts`, matching the actual parser in `hashline/input.ts` which already strips every leading `@` before resolving the path. Purely cosmetic \u2014 the edit itself was always routed to the correct file.\n- Fixed model contextWindow and maxTokens defaulting to `UNK_CONTEXT_WINDOW` (222222) / `UNK_MAX_TOKENS` (8888) when cached or freshly-discovered provider models replace bundled models through `ModelRegistry.#mergeResolvedModels`. The merge now preserves the bundled model's values when the replacement only has sentinel fallbacks.\n- Fixed headless `browser.open` tab startup on slow Chromium target enumeration by making worker-side stealth user-agent target setup selective, bounded, and best-effort for non-active targets. Worker startup errors are now surfaced directly instead of degrading into the generic tab worker initialization timeout.\n- Fixed token display for sessions and subagents inflating far beyond the context window. `token_total` status-line segment and the subagent overlay token counter now show `input + output + cacheWrite` instead of `input + output + cacheRead + cacheWrite`. With prompt caching, `cacheRead` per turn equals the full cached context \u2014 summing it across all turns produces a cumulative total that is N\u00d7context_size (e.g. a 5-turn session with a 1 M-token context reported ~5 M tokens). Cache activity is still visible via the dedicated `cache_read`/`cache_write` status-line segments; billing cost is unaffected.\n- Fixed ACP clients missing `config_option_update` notifications when the thinking level changed via any path other than the client's own `session/set_session_config_option` call (slash commands, model auto-adjust, extension UI). `AgentSession` now emits a `thinking_level_changed` event from `setThinkingLevel`, and `AcpAgent` subscribes to each managed session for the session's lifetime and pushes a fresh `config_option_update` whenever the effective level changes \u2014 independent of any active prompt turn. The subscription is installed inside `#scheduleBootstrapUpdates`'s 50 ms timer so it shares the same race guard that prevents Zed's `Received session notification for unknown session` drop when notifications fire before `session/new` (or fork) returns; the pre-bootstrap thinking level is reported in the response's `configOptions`. The `session/set_session_config_option` handler keeps its own push only when the subscription has not yet been installed, so client-driven thinking changes still notify pre-bootstrap, post-bootstrap they flow through the subscription exactly once. Subscriptions are released in `#disposeSessionRecord`.\n- Fixed MCP OAuth refresh failing with `HTTP 401 invalid_client` for servers that require Dynamic Client Registration (RFC 7591) and have no `oauth.clientId` configured (e.g. `mcp.linear.app`). `MCPOAuthFlow` registered a fresh public PKCE client on each authorize and discarded the issued `client_id` once the flow object went out of scope; refresh then called the provider's `/token` endpoint without a `client_id`. The flow now exposes `resolvedClientId` / `registeredClientSecret` getters, `MCPCommandController#handleOAuthFlow` returns them alongside `credentialId`, and both the initial-connect and `/mcp reauth` paths persist them into `auth.{clientId,clientSecret}` (used at refresh) and `oauth.{clientId,clientSecret}` (used by subsequent `/mcp reauth` to skip re-registration). The `MCPAddWizard` `onOAuth` callback type is now `Promise` and `#launchOAuthFlow` folds the registered credentials into wizard state. Servers with a statically-configured `oauth.clientId` (Notion, Slack, Datadog) are unaffected \u2014 `#tryRegisterClient` short-circuits and the write-back is a no-op. ([#1061](https://github.com/can1357/oh-my-pi/pull/1061) by [@ldx](https://github.com/ldx)).\n\n## [15.0.0] - 2026-05-13\n\n### Breaking Changes\n\n- Removed `op: issue_view` and `op: pr_view` from the `github` tool. Read single issues/PRs via the `read` tool against `issue://` / `pr://` (or the long form `issue:////` / `pr:////`); append `?comments=0` to drop the comments section. The `issue` and `comments` parameters were removed from the tool schema since no remaining op consumes them. Mutating ops (`pr_create`, `pr_checkout`, `pr_push`), `repo_view`, `search_*`, and `run_watch` are unchanged.\n- Removed `op: pr_diff` (along with the `nameOnly` and `exclude` schema fields) from the `github` tool. Read PR diffs through the new `pr://` URL family: `pr:///diff` for the changed-file listing, `pr:///diff/` for a single file slice (1-indexed), and `pr:///diff/all` for the verbatim unified diff. Long-form `pr://///diff[/\u2026]` works the same way. All three variants share one `gh pr diff` invocation through a new `pr-diff` cache row, so the listing and per-file slices reconstruct from cached bytes without re-shelling. Diff content is served as `text/plain` so the `read` tool's line selectors (e.g. `pr:///diff/all:200-400`) page the cached output without falsely advertising hashline anchors.\n- Renamed ACP custom extension methods from `omp/*` to `_omp/*` to comply with the ACP spec's `_`-prefix requirement for non-spec methods; existing callers must update method names\n\n### Added\n\n- Added markdown rendering for `read` results when content type is `text/markdown`, so GitHub internal-URL outputs are shown as formatted markdown instead of plain code blocks\n- Added `pr:///diff`, `pr:///diff/`, and `pr:///diff/all` internal-URL shapes covering changed-file listings, per-file slices, and the full unified diff. They share one `pr-diff` SQLite cache row with the same TTL knobs as `pr://` views (`github.cache.softTtlSec` / `github.cache.hardTtlSec` / `github.cache.enabled`). Single PR views now advertise the diff entry point via a `Diff: pr://///diff` note. Cache schema bumped to `user_version = 3`; older rows are dropped on first open to add credential-scoped keys and relax the `kind` CHECK constraint.\n- Added `issue://` / `pr://` internal-URL schemes that share a SQLite-backed cache with the rest of the `github` tool. Single-item reads (`issue://`, `issue:////`) return rendered markdown and within `github.cache.softTtlSec` (default 5 minutes) skip the `gh` round-trip entirely; within `github.cache.hardTtlSec` (default 7 days) the cached row is returned and a background refresh is scheduled. Root and repo-scoped reads (`issue://`, `pr://owner/repo`) issue a live `gh issue list` / `gh pr list` for browsing, supporting `?state=open|closed|all` for issues, `?state=open|closed|merged|all` for PRs, and `?limit=`, `?author=`, `?label=` query params. Rendered output lands in `~/.omp/cache/github-cache.db` (override via `OMP_GITHUB_CACHE_DB`); disable the cache entirely with `github.cache.enabled = false`. Cwd\u2192default-repo lookups (`gh repo view`) are memoized per-process.\n- Added new `Approve and compact context` choice to the ExitPlanMode approval selector. Sits between `Approve and execute` (purge session) and `Approve and keep context` (full transcript) \u2014 runs `/compact` on the plan-mode transcript with a planning-specific summarization hint, then dispatches the plan-approved execution turn so it lands on a fresh cache anchor with the summarized rationale carried over. Cancelling the compaction (Esc or any other abort source) defers the execution dispatch and surfaces a warning so the operator can resubmit manually; non-abort failures proceed best-effort.\n- Added `CompactionCancelledError` typed sentinel and `CompactionOutcome` (`\"ok\" | \"cancelled\" | \"failed\"`) return type to `@oh-my-pi/pi-coding-agent/session/compaction`. `CommandController.executeCompaction` and `handleCompactCommand` now return the outcome instead of `void` so callers can discriminate user-driven aborts from generic failures without inspecting error messages.\n- Added a `credential_disabled` extension event so extensions can subscribe via `pi.on(\"credential_disabled\", handler)` and react when `AuthStorage` automatically soft-disables a credential (e.g. OAuth `invalid_grant`). Replaces the current `agent_end` errorMessage regex pattern downstream extensions have to match against. Handler payload is `{ type, provider, disabledCause }`. `createAgentSession()` subscribes the per-session extension runner to the shared `AuthStorage` via `authStorage.onCredentialDisabled(...)` at the very top of session creation \u2014 before any startup model probes run \u2014 so events fire on every disable regardless of whether the embedder also has a constructor `onCredentialDisabled` handler attached. The SDK forwards through `ExtensionRunner.emitCredentialDisabled(event)`, which buffers events until `runner.initialize(...)` runs in the mode controller and then flushes them through `emit()` so extension handlers see populated UI/runtime context (rather than the constructor's no-op default with `hasUI=false`, an unset model, and no-op runtime actions). On `session.dispose()` the subscription is unsubscribed; the embedder's constructor-attached listener keeps firing through its own permanent subscription. The outer `createAgentSession()` catch also releases the subscription if startup throws before the dispose-wrap is wired, so repeated retries don't accumulate dead listeners.\n- Added `omp acp` subcommand for launching as an ACP (Agent Client Protocol) server over stdio\n- Added explicit `type` discriminators to ACP `initialize` auth methods, including a `terminal` setup method gated on `clientCapabilities.auth.terminal`\n- Added ACP equivalents for the remaining TUI slash commands (`/jobs`, `/changelog`, `/dump`, `/copy`, `/hotkeys`, `/extensions`, `/agents`, `/model`, `/plan`, `/loop`, `/btw`, `/login`, `/logout`, `/resume`, `/tree`, `/branch`, `/new`, `/drop`, `/handoff`, `/fork`, `/session delete`, `/export`, `/share`, `/todo`, `/memory`, `/move`, `/mcp`, `/ssh`, `/marketplace`, `/plugins`) so ACP clients reach feature parity with the TUI for non-interactive flows\n- Added ACP `plan` mode: when `plan.enabled` setting is on, ACP `session/new`/`load`/`resume`/`fork` advertise a `plan` mode alongside `default`; `session/set_mode` toggles plan-mode state so the next agent turn injects the plan-mode system prompt\n- Added ACP `ClientBridge` abstraction (`packages/coding-agent/src/session/client-bridge.ts`) that routes tool I/O through the connected client when capabilities are advertised at `initialize`; populated from `AgentSideConnection` in ACP mode\n- Added ACP `terminal/*` routing for `bash`: when the client advertises `terminal: true`, the tool creates a client-side terminal, embeds its `terminalId` on the live tool card, polls output, and releases the handle on exit or abort\n- Added ACP `fs/read_text_file` and `fs/write_text_file` routing for the `read` and `write` tools: when the client advertises `fs.readTextFile` / `fs.writeTextFile`, plain-text reads/writes go through the editor (surfacing unsaved buffer content and letting the editor track agent writes); falls back to disk only for reads, throws on bridge write failures\n- Added ACP `session/request_permission` gate around `bash`, `edit`, `write`, and `ast_edit` when an ACP client is connected; remembers `allow_always` / `reject_always` decisions per tool for the session lifetime\n- Added `diff` `ToolCallContent` emission for edit tool results: per-file `oldText`/`newText` is threaded through `EditToolPerFileResult` / `EditToolDetails` so ACP clients can render inline diffs\n- Added richer ACP `StopReason` mapping (`max_tokens`, `refusal`, `cancelled`) derived from the last assistant message's internal stop reason; previously only `end_turn`/`cancelled` were emitted\n- Added `_meta.messageCount` and `_meta.size` on `session/list` `SessionInfo` entries\n- Added ACP `tool_call_update` `locations` refresh from in-flight tool args and final result details so clients can \"follow along\" multi-file edits in real time\n\n### Changed\n\n- Changed issue and pull-request list entries to link to repository-qualified URLs (for example `issue://owner/repo/`) so list items open correctly outside the default repo\n- Aligned prompt instruction language by defining `NEVER` and `AVOID` as strict aliases for `MUST NOT` and `SHOULD NOT` in the system prompt, and standardized agent, tool, and system prompt templates to use those terms consistently\n- Changed `--mode acp` to apply the same stdout-quiet overrides as `--mode rpc` so no banner or status text leaks into the JSON-RPC channel\n- Changed ACP startup to no longer require a configured model so registry validators and clients can complete `initialize` and `authenticate` before any model is selected\n\n### Fixed\n\n- Deferred flushing of buffered `credential_disabled` events during extension runner initialization to a microtask so handler failures are now routed through `onError()` registrations made immediately after `initialize()`, preserving extension error reporting\n- Fixed `eval` tool dynamic `await import(\"./relative.ts\")` calls failing with `Cannot find module ... from .../eval/js/shared/runtime.ts`. The static-import rewriter only handled `ImportDeclaration` nodes, so dynamic-import call expressions resolved their specifier against the worker module's URL instead of the session cwd. The rewriter now walks the full AST and additionally swaps `import` callees in `CallExpression` nodes for `__omp_import__`, which forwards the optional options bag verbatim to native `import()` so `{ with: { type: \"json\" } }` round-trips. Renamed `rewriteStaticImports` \u2192 `rewriteImports`.\n- Fixed `pr:////diff` URLs for repositories named `diff` to continue resolving to PR list lookups instead of being parsed as short-form diff links\n- Fixed `issue:///diff` short form previously misparsing as a repo named `/diff` and surfacing a confusing GraphQL \"Could not resolve to a Repository\" error. The numeric-host disambiguation that already routed `pr:///diff` through the diff path now applies to both schemes, so `issue:///diff[/\u2026]` falls through to the existing \"Issue views do not have a diff; use pr://///diff for pull requests.\" rejection \u2014 matching the long-form `issue://///diff` behavior. `:///diff` listings for a repo literally named `diff` are unchanged.\n- Fixed PR unified diff parsing so changed-file headers with quoted paths (such as paths containing spaces) are now detected correctly and hunk content lines beginning with `---`/`+++` are counted in additions/deletions\n- Fixed GitHub view caching to account for active credential identity and avoid serving cached issue/PR data across different account/token contexts\n- Fixed `read` call tracking so calls without an explicit path or URL target no longer appear as regular file reads in the execution tracker\n- Fixed `createAgentSession()` subscribing the `credential_disabled` bridge to a freshly discovered `AuthStorage` orphan when an embedder supplied only `options.modelRegistry` (no `options.authStorage`). Refresh failures emitted by `modelRegistry.getApiKey()` flow through `modelRegistry.authStorage`, so a divergent local instance silently swallowed every disable event and also leaked into the `mcpManager` and session result. The SDK now reconciles `authStorage` to `modelRegistry.authStorage` up front and rejects mismatched `options.authStorage`/`options.modelRegistry.authStorage` pairs at session construction.\n- Fixed `runSubagent` (subagent task executor) carrying the same latent `AuthStorage`/`ModelRegistry` divergence as `createAgentSession()`: when only `options.modelRegistry` was supplied, the executor previously fell through to a fresh `discoverAuthStorage()` and handed that orphan into `createAgentSession()` alongside a registry whose `.authStorage` was a different instance. The executor now reconciles to `modelRegistry.authStorage` before any further work and rejects mismatched `options.authStorage`/`options.modelRegistry.authStorage` pairs the same way the SDK does, so subagents can no longer silently observe a different storage view than their parent.\n- Fixed `github` tool's `search_issues`/`search_prs`/`search_code`/`search_commits`/`search_repos` ops always returning 0 results when the query contained more than one qualifier (e.g. `is:merged is:pr`, `is:open author:foo`). `gh search \u2026` since the `advanced_search=true` rollout in gh 2.92 silently wraps multi-token positional queries in parentheses and quotes everything after the first qualifier as that qualifier's value (`is:\"merged is:pr\"`), which GitHub then matches as a literal state filter that no PR can satisfy. The tool now calls `gh api -X GET /search/ -f q=\u2026 -F per_page=\u2026` directly so the qualifiers reach GitHub's search API verbatim. `is:issue`/`is:pr` and `repo:/` are appended internally to preserve the previous CLI-flag behavior; the user-facing query string in the formatted output is unchanged. `state` for merged PRs is derived from `pull_request.merged_at` so the rendered `State:` line stays `merged`/`closed`/`open` as before.\n- Fixed `read` tool renderer rendering failed reads with a success check (`\u2713`) and styling the error message as file content while the surrounding box was red. The renderer now branches on `isError` for both file and URL paths: header shows `\u2718 Read ` with a proper error icon and the underlying message is rendered as an error line. `renderReadUrlResult` got the same treatment so failed URL reads also get the cross icon instead of falling through to the `\"No response data\"` Text fallback. Mirrors the `bash`/`find` renderer error pattern.\n- Fixed ACP mode to advertise and handle non-TUI builtin slash commands and `/skill:` commands\n- Fixed ACP `session/resume` and `session/close` to dispatch correctly under SDK 0.21 by renaming `unstable_resumeSession` / `unstable_closeSession` to the stable `resumeSession` / `closeSession` method names the SDK now routes to\n- Fixed ACP `tool_call` / `tool_call_update` `locations` to always emit absolute paths (resolved against the session cwd) so editor clients can reliably open or focus the referenced file\n- Fixed ACP edit `diff` metadata for moves to point at the destination path rather than the now-deleted source so post-edit \"open file\" actions land on the new file\n- Fixed ACP `session/request_permission` `locations` to be absolute and to honor the `requestPermission` capability bit instead of only checking for the method, matching the read/write/bash capability gating\n- Fixed ACP `authenticate` to reject `methodId` values that were not advertised by `initialize` so malformed clients fail fast instead of being treated as authenticated\n- Fixed ACP mode changes made via `session/set_session_config_option` (`MODE_CONFIG_ID`) to also emit a `current_mode_update` notification, matching `session/set_mode` so clients tracking `modes.currentModeId` stay in sync\n- Fixed `/model` ACP builtin to emit a `config_option_update` after switching models so clients show the new model in config selectors immediately\n- Fixed `/mcp list` (ACP) to redact query strings and userinfo from server URLs before emitting them, so API keys embedded in URLs (e.g. `?exaApiKey=\u2026`) are not leaked to clients\n- Fixed `/mcp test|resources|prompts` (ACP) to wire the auth storage before `prepareConfig` so OAuth-backed MCP servers can refresh tokens and inject `Authorization` headers\n- Fixed `/mcp list`, `/mcp test`, `/mcp resources`, `/mcp prompts`, `/mcp enable`, and `/mcp disable` (ACP) to preserve project-over-user precedence when the same server name is defined in both scopes, matching the runtime capability merge so toggling the duplicated name flips the effective entry\n- Fixed `/ssh add --port` parsing to reject non-integer values (e.g. `22oops`) instead of silently coercing them via `Number.parseInt`\n- Fixed `/ssh list` to deduplicate hosts shared between project and user scopes, listing project entries first to match capability-loader precedence\n- Fixed `/export` (ACP) to reject clipboard aliases (`--copy`, `clipboard`, `copy`) instead of using them as the output filename\n- Fixed ACP builtin commands (`/compact`, `/force`, `/move`, `/browser`) to surface underlying failures via `output()` instead of swallowing them\n- Fixed `/session save|delete` (ACP) to route through the active `SessionManager` so the persist writer is consulted and stale storage references are removed\n- Fixed `/reload-plugins`, `/marketplace install|uninstall|upgrade`, and `/plugins enable|disable` (ACP) to refresh slash command registries and emit `available_commands_update` after plugin state changes\n- Fixed ACP `usage()` text emission to be awaited so help and error output is not dropped or reordered when commands return immediately\n- Fixed ACP `bash` tool to release the client terminal handle on `terminal/output` or `waitForExit` failures, and to race output polling against abort so a stuck RPC cannot delay cancellation\n- Fixed ACP `resource` content blocks with `image/*` MIME types to be routed into the LLM `images` array instead of being dropped as opaque blobs\n- Fixed `pr://` and `issue://` URLs accepting empty, `.`, or `..` path segments. `pr://owner//77`, `pr://owner/repo/77/diff//2`, and `pr://owner/../77/diff` previously slipped past the `.filter(Boolean)` split and were forwarded to `gh`; now they throw `Invalid :// URL: empty or unsafe path segment` before any subprocess work.\n- Fixed `read` of `issue://` / `pr://` URLs ignoring the read tool's `AbortSignal`. Aborting a long `pr:///diff/all` or stale issue fetch now propagates into the resolver and short-circuits at the handler entry; previously the `gh` round-trip and cache write ran to completion.\n- Fixed `read :raw` (and the `raw: true` arg) still rendering markdown internal-URL content through the formatted markdown renderer. The TUI now respects the raw selector and falls back to the code-cell renderer so verbatim bytes are shown when requested.\n- Fixed `eval` tool JS cells crashing with a `structuredClone` error when an awaited final expression returned a non-cloneable value (module namespace, function, symbol, etc.). `displayValue` now falls back to a text representation and logs at debug instead of throwing.\n- Fixed `eval` tool JS rewriter missing the final expression when followed by trailing empty statements (e.g. `await Promise.resolve(1);;`). `returnFinalExpression` now scans backward past `EmptyStatement` nodes before deciding there is no final expression.\n- Fixed `github` view cache evicting valid rows on open whenever a longer-than-default `github.cache.hardTtlSec` was configured. `openDb()` no longer sweeps with the 7-day default before settings load; the per-lookup `sweepIfDue()` enforces the configured retention exclusively.\n- Fixed extension `ctx.shutdown()` being a no-op in the primary interactive path. The handler in `initHooksAndCustomTools` now sets `shutdownRequested` (mirroring the backgrounded-reinit path), and the main REPL loop drains the flag at the post-stream idle boundary so queued steering messages still flush before teardown.\n- Fixed plan-mode \"Approve and compact context\" dispatching queued user input against the stale plan-mode reference path. `setPlanReferencePath(finalPlanFilePath)` now runs before `handleCompactCommand` flushes the compaction queue, so any message typed during compaction is delivered with the approved plan context attached.\n- Fixed `.omp/commands/fix-issues.md` and `.omp/commands/review-prs.md` still instructing agents to call the removed `github issue_view` / `pr_view` / `pr_diff` ops; they now reference `read issue://` and `read pr://[/diff[/all|]]`.\n- Fixed `ExtensionRunner.initialize()` flushing buffered `credential_disabled` events before mode controllers had a chance to register their `onError` listener. Mode controllers call `runner.initialize(...)` immediately followed by `runner.onError(...)` synchronously; the flush now runs in a microtask after splicing the buffer, so a synchronously throwing `credential_disabled` handler is routed through the registered error listener instead of being silently dropped.\n\n### Security\n\n- Secured the GitHub cache store with strict file permissions (`0600` files) and private permissions for newly created cache directories (`0700`) to reduce local cache exposure\n\n## [14.9.9] - 2026-05-12\n\n### Added\n\n- Added new `task.isolation.mode` values `auto`, `apfs`, `btrfs`, `zfs`, `reflink`, `overlayfs`, `projfs`, `block-clone`, and `rcopy` for native PAL-backed task isolation backends\n- Added automatic PAL-backed isolation backend selection so `task.isolation.mode` uses the host's best-available backend\n- Added input-token and output-token totals to `omp stats --summary`.\n\n### Changed\n\n- Changed `task.isolation.enabled=true` migration to map to `task.isolation.mode = \"auto\"` instead of legacy `worktree` isolation\n- Updated isolation configuration UI labels and descriptions to expose new back-end names (`overlayfs`, `projfs`, etc.) and removed references to deprecated values in guidance text\n\n### Fixed\n\n- Fixed worktree delta capture to include previously untracked file state by baselining untracked patches for both snapshots\n- Fixed task isolation startup to try alternate PAL backends when the preferred one is unavailable, allowing successful fallback instead of immediate failure\n- Mapped legacy `task.isolation.mode` values `worktree`, `fuse-overlay`, and `fuse-projfs` to their new equivalents during settings migration to preserve behavior with older configs\n\n## [14.9.8] - 2026-05-12\n\n### Breaking Changes\n\n- Changed the `eval` tool input format to a single-line `*** Cell :\"\" [t:] [rst]` header per cell, replacing the `*** Begin ` / `*** End ` envelope and the standalone `*** Title:` / `*** Timeout:` / `*** Reset` directives. The lark grammar enforces a fixed attribute order; the runtime parser remains lenient (alias keys, bare positional tokens, single-quoted titles).\n\n### Added\n\n- Added `:conflicts` read selector (`read :conflicts`) to return a one-line index of all unresolved merge conflicts with stable `#N` IDs for quick inspection\n- Added bulk conflict resolution with `write({ path: \"conflict://*\", content })` to resolve all currently registered conflicts across files in one call, expanding `@ours`/`@theirs`/`@base`/`@both` per conflict and returning per-file counts\n- Added `read` support for `conflict://` and `read conflict:///` to inspect unresolved conflict regions captured by a prior read, including `ours`, `theirs`, and `base` side views with original file line alignment\n- Added shorthand content tokens `@ours`, `@theirs`, `@both`, and `@base` to conflict-resolution writes using `path: \"conflict://\"` so replacement content can be composed from recorded conflict sections\n- Added conflict count metadata to read results so conflict files now show a warning badge (`\u26a0 N`) in the read tool UI\n- Added support for explicit boolean `rst` values (`rst:true`, `rst:false`, `rst:1`, `rst:0`, `rst:yes`, `rst:no`, `rst:on`, `rst:off`) in `*** Cell` headers\n- Added detection of unresolved git merge conflicts in `read` output: each marker block is registered with a session-stable id and surfaced in a footer with `ours`/`theirs` previews. Resolve a block by calling `write({ path: \"conflict://\", content })` \u2014 the tool splices the recorded marker region (markers and all sides) with the supplied content and routes through the normal writethrough (LSP format/diagnostics, fs-cache invalidation).\n\n### Changed\n\n- Changed `read` conflict warning footers to show `X of Y` unresolved conflicts when a range only captures part of a file and provide a `read :conflicts` hint for the full list\n- Changed conflict scanning in conflict read paths to inspect the whole file (with a 10 MB cap) so totals better reflect hidden conflicts and truncated scans are called out\n- Changed conflict marker scanning during `read` to only register fully formed, column-0 merge-marker blocks, so indented or malformed marker-like lines are no longer treated as conflicts\n- Changed `write` conflict resolution to validate `conflict://` IDs and report clear errors for malformed or unknown conflict URIs\n- Changed the HTML transcript renderer to parse the new `*** Cell` headers while keeping the older `*** Begin ` and `===== ... =====` formats renderable for historical sessions.\n- Changed the `eval` tool parser so a stray non-marker line between cells no longer crashes with `null is not an object (evaluating 'BEGIN_RE.exec(lines[i])[1]')`; stray content is consumed without aborting parsing.\n- Changed `*** End` to be an optional, undocumented per-cell terminator (kept in the lark to satisfy GPT-trained models' natural terminator habit during constrained sampling).\n\n### Fixed\n\n- Fixed single-conflict `write` retries to re-locate the recorded conflict block by exact marker content so shifted line numbers from out-of-band edits no longer prevent resolution\n- Fixed `read conflict://*` handling by rejecting wildcard reads with a clear write-only guidance error\n- Fixed conflict resolution to verify the live file still contains recorded `<<<<<<<` and `>>>>>>>` markers before splicing, preventing stale conflict IDs from silently corrupting out-of-band-edited files\n- Fixed `@base` token handling so two-way conflicts without a base section now return a clear error\n- Improved `*** Cell` header parsing to reject invalid `rst` values with a clear `invalid rst value` error\n\n## [14.9.7] - 2026-05-12\n\n### Breaking Changes\n\n- Changed the `timeoutMs` execution option to no longer be enforced during worker-based JS runs, so callers must rely on external cancellation signals for time limits\n- Replaced the Jupyter kernel gateway + WebSocket protocol behind the Python `eval` backend with a subprocess-backed runner that speaks NDJSON over stdin/stdout; removed the `jupyter_kernel_gateway`/`ipykernel` pip dependencies, the `python.sharedGateway` setting, the `omp jupyter` CLI command, and the `PI_PYTHON_GATEWAY_URL` / `PI_PYTHON_GATEWAY_TOKEN` environment variables\n\n### Added\n\n- Added Python `tool.(args)` support to `executePython` sessions so evaluated Python code can invoke session tools through the prelude `tool` proxy\n- Added per-execution Python tool bridge session registration and loopback endpoint wiring so Python tool calls resolve to host tools and return tool results\n- Added status-event forwarding for Python tool bridge calls so `tool` invocations can emit execution status updates\n- Added browser-tab JavaScript execution through the shared runtime so tab runs now expose the standard helper globals (`read`, `write`, `sort`, `uniq`, `counter`, `diff`, `tree`, `env`, `output`, `display`, and `tool`)\n- Added static ESM `import` support to browser-tab JavaScript by rewriting top-level imports and resolving them against the tab session context\n- Added substring fallback matching to `HistoryStorage.search` so infix and short-token queries that FTS5 prefix matching misses are still returned\n- Added a live single-line sync progress display to the stats command showing current/total sessions while syncing\n- Added automatic inline JS evaluation fallback when worker creation failed so script execution still works in environments without worker support\n\n### Changed\n\n- Changed `setup python` to only verify a reachable Python 3 interpreter instead of installing Jupyter dependencies\n- Changed `info` output to remove the obsolete Python Gateway status block now that shared gateway management is no longer available\n- Changed JavaScript execution in `executeJs` to expose the worker\\u2019s real `process` object instead of a restricted, frozen subset\n- Changed JavaScript evaluation to run per session in a worker-backed runner with explicit initialization and teardown handling\n- Changed the Python backend to launch one `python -u runner.py` subprocess per kernel; cancellation now sends `SIGINT` which raises a real `KeyboardInterrupt` in user code, and the same subprocess is reused across cells in session mode\n- Changed Python magic handling so `%pip`, `%cd`, `%env`, `%pwd`, `%ls`, `%time`, `%timeit`, `%who`, `%reset`, `%load`, `%run`, `%%bash`, `%%capture`, `%%timeit`, `%%writefile`, and `!shell` work without depending on IPython\n\n### Fixed\n\n- Fixed Python output rendering so `text/markdown` takes precedence over `text/plain` and status bundles are emitted as status updates rather than plain text\n- Fixed query tokenization in `HistoryStorage.search` so punctuation-delimited terms like `git-commit` are aligned with indexing and matched correctly\n- Fixed history search result merging to de-duplicate matches and return full-text matches before substring-only matches while still respecting the requested limit\n- Fixed JS run cancellation so aborting a run now also cancels in-flight tool calls and terminates the active worker session\n- Fixed top-level `const`, `let`, and `class` declarations in evaluated JavaScript to persist across subsequent runs by rewriting top-level declarations\n\n## [14.9.5] - 2026-05-12\n\n### Breaking Changes\n\n- Removed the `jobs://` internal URL protocol; inspect background jobs via the `job` tool's `list: true` operation instead\n\n### Added\n\n- Added `since` and `until` date-range filters to `search_issues`, `search_prs`, `search_commits`, and `search_repos`, accepting relative durations (`m`/`h`/`d`/`w`/`mo`/`y`), ISO dates, and ISO datetimes\n- Added `dateField` support for date filtering (`created` or `updated`) so search results can be constrained by creation, update, pushed (for repos), or committer date (for commits)\n- Added owner-based scoping to async job registration and queries so background jobs can be registered with an `ownerId` and filtered per agent in `getRunningJobs`, `getRecentJobs`, `getAllJobs`, and `cancelAll`\n- Added agent ownership metadata to async jobs started by `task` and `bash` tools so their lifecycle and cancellation is attributed to the creating agent\n- Added `list: true` operation to the `job` tool, returning an immediate snapshot of every job spawned by the calling agent without waiting (replaces the deleted `jobs://` URL)\n- Added per-agent visibility scoping to the `job` tool so `list`, `poll`, and `cancel` only see and act on jobs owned by the calling agent; cross-agent operations now return `not_found`\n\n### Changed\n\n- Changed `search_issues`, `search_prs`, `search_commits`, and `search_repos` to allow date-only queries where `query` is omitted if `since`/`until` is provided\n- Changed `search_code` to return a validation error when `since`/`until` is supplied because GitHub code search does not support date qualifiers\n- Changed async job manager ownership so subagents inherit the parent session\u2019s global `AsyncJobManager` instead of creating and owning separate instances\n- Changed session lifecycle cleanup so the global async-job manager is disposed only by the owning top-level session\n- Changed subagent session switches and handoff paths to stop global async-job cancellation and cancel only jobs owned by that session\n- Changed `agent://` and `artifact://` URL resolution to search artifact outputs across all active sessions instead of only the current session, allowing parent and subagent sessions to read each other\u2019s generated outputs by ID\n- Changed `memory://` URL resolution to walk all active sessions\u2019 memory roots and return the first matching file, so worktree-based subagents can access their own memory views as well as shared roots\n- Changed internal URL routing to use a shared process-global `InternalUrlRouter` and protocol handlers, so built-in tools resolve `agent://`, `artifact://`, `memory://`, `skill://`, `rule://`, `mcp://`, and `local://` URLs without requiring session-specific router wiring\n- Changed `mcp://` handler to use the globally registered MCP manager so MCP resource links work for agents sharing session context\n- Changed the `ask.timeout` default from `30` (seconds) to `0` (wait indefinitely). Auto-selecting the recommended option after a fixed delay was surprising users mid-deliberation; the timer is now strictly opt-in. The legacy auto-select behavior is preserved when `ask.timeout` is set to a non-zero value, and the `ask` tool's prompt has been updated so the model expects unlimited reply time by default.\n\n### Fixed\n\n- Added `ModelRegistry.hasConfiguredAuth(model)` to mirror the upstream `@mariozechner/pi-coding-agent` API surface; external plugins and downstream wrappers that pre-flight auth before launching a subagent no longer crash with `this._modelRegistry.hasConfiguredAuth is not a function` on the direct agent-launch path. ([#993](https://github.com/can1357/oh-my-pi/issues/993))\n- Fixed an ESM circular-import TDZ that crashed test suites when modules from the `task/` and `tools/` graphs were evaluated together (e.g. `executor-warnings.test.ts` + `task-simple-mode.test.ts`) by deferring `BUILTIN_TOOLS.task`'s `TaskTool.create` dereference to factory-call time and sourcing `truncateTail` from `session/streaming-output` instead of the `tools/` barrel\n- Treat keyless-by-design providers (llama.cpp, ollama, lm-studio) as authenticated in subagent model resolution; fixes silent fallback to parent remote model when a local model is configured. ([#1008](https://github.com/can1357/oh-my-pi/issues/1008))\n- Fixed subagent disposal and session transitions that previously canceled all running async jobs, preventing inadvertent termination of a parent agent\u2019s background work\n- Fixed multi-entry edits silently rendering a fake success when every entry failed (e.g. all hit the auto-generated guard), by surfacing `isError: true` from the single-path edit orchestrator so the renderer takes the error branch instead of falling through to the streaming-preview fallback that displays the *proposed* diff\n- Fixed the auto-generated streaming guard being gated behind `edit.streamingAbort` (default false), so it now pre-empts streaming edit tool calls targeting auto-generated files regardless of that setting\n- Fixed subagents launched in the same parallel batch not seeing each other in their initial `# IRC Peers` system-prompt block by pre-registering the agent in the global `AgentRegistry` before `rebuildSystemPrompt` runs and attaching the live session afterwards\n- Fixed plugin manifest extensions whose entry points at a directory (e.g. `pi-goal`'s `\"pi\": { \"extensions\": [\".pi/extensions/pi-goal\"] }`) failing to load with `Failed to load extension: Directories cannot be read like files`. The plugin path resolver now resolves directory entries to their `index.{ts,js,mjs,cjs}` file, matching the behavior of native auto-discovery via `resolveExtensionEntries`.\n- Fixed the SSH tool on native Windows by avoiding OpenSSH ControlMaster multiplexing, which Win32-OpenSSH does not support and reports as `getsockname failed` ([#154](https://github.com/can1357/oh-my-pi/issues/154)).\n- Fixed `/export` and `/tree` not showing developer-role messages (including the plan content injected after `/plan` approval) so the HTML export and TUI session tree now render developer messages dimmed with their actual content instead of hiding them entirely ([#753](https://github.com/can1357/oh-my-pi/issues/753))\n- Fixed `Timed out initializing browser tab worker` on prebuilt binaries by rewriting `spawnTabWorker` to import the worker entry with `with { type: \"file\" }` so Bun's `--compile` bundler statically discovers and embeds `tab-worker-entry.ts` in the single-file binary ([#1011](https://github.com/can1357/oh-my-pi/issues/1011))\n\n## [14.9.3] - 2026-05-10\n\n### Breaking Changes\n\n- Changed the `eval` tool input format to canonical `*** Begin ` ... `*** End ` cells with `*** Title`, `*** Timeout`, and `*** Reset` directives, so legacy `===== ... =====` eval inputs are no longer accepted for execution\n- Removed the `sectionSeparator` re-export from `config/prompt-templates`, so existing imports from `@oh-my-pi/pi-coding-agent/config/prompt-templates` now need to resolve `sectionSeparator` from its utility package\n\n### Added\n\n- Added support for the `*** Abort` recovery marker in eval and hashline parsing to terminate processing safely when stream corruption is detected\n- Added support for wrapping hashline edits in `*** Begin Patch` and `*** End Patch` markers so patch input with these envelopes is parsed and applied\n- Added support in the HTML export renderer for the new `*** Begin`/`*** End` eval cell format\n- Added a dedicated `[now]` prompt block to `buildSystemPrompt` output containing current date, current working directory, and required end-of-turn continuation/verification guidance\n- Added a new `[project]` prompt block wrapper around workstation and workspace context and ensured it is emitted as a separate system prompt segment\n- Added dedicated HTML rendering for `eval` tool calls, including cell-by-cell parsing of `===== ... =====` blocks with inferred Python/JS/TypeScript highlighting\n- Added dedicated rendering support for `search`, `recipe`, and `irc` tool calls in transcript exports\n- Added a collapsible `Available Tools` section with a tool count and chip-style compact tool names\n- Added macOS power assertion settings `power.preventIdleSleep`, `power.preventSystemSleep`, `power.declareUserActive`, and `power.preventDisplaySleep` so users can control what types of sleep are blocked during sessions\n\n### Changed\n\n- Kept legacy `===== ... =====` eval transcripts renderable in HTML while adding parsing for the new `*** Begin` format for newer transcripts\n- Changed the system prompt\u2019s Bash usage guidance to explicitly forbid specific anti-patterns (`sed`/`awk` line-range reads, stderr redirects, and `| head|tail` pagination) and require using dedicated tools for those operations\n- Changed delegated subagent prompts so shared task context is now rendered only in the system-level `[context]` block, while the user-facing task message now contains only the assignment prompt text\n- Changed system prompt rendering to use block markers such as `[env]`, `[contract]`, `[role]`, `[coop]`, and `[closure]` for more explicit structural instructions\n- Changed the working-directory value in rendered prompts to use `shortenPath` before interpolation\n- Updated subagent prompt assembly to compose prompt blocks and place the `[now]` block after the subagent-specific instructions\n- Changed GitHub (`gh`) tool cards to include operation, PR, branch, and truncated query/title/body details\n- Changed tool-call output to display internal `_i` intent separately and hide it from rendered argument JSON\n- Changed `ast_edit` and `find`/`search` rendering to show resolved path values and option flags such as `limit`, `no-hidden`, and `no-reply`\n- Changed power assertion behavior to take effect only while a prompt is in flight, replacing session-level persistent assertions\n\n### Removed\n\n- Removed the unused `head` and `tail` parameters from the `bash` tool schema, along with the dead `normalizeBashCommand` / `applyHeadTail` post-processing module \u2014 output truncation is already handled by the harness's streaming tail buffer and artifact spillover, so the agent should rely on `read` (or the artifact link) instead of inline truncation pipes.\n\n### Fixed\n\n- Fixed eval tool outputs to append a truncation warning and ask users to re-issue remaining work when parsing is aborted by `*** Abort`\n- Fixed hashline parsing and input splitting to stop at `*** Abort` and ignore trailing edits after the marker\n- Fixed subagent task prompt construction so a trailing `[now]` block in the base prompts is preserved and not swallowed when rendering `subagent-system-prompt`\n- Fixed edit rendering so provided `input` text is shown in the export even without a file path\n- Fixed `args.paths` handling in `ast_edit` and `find` so multiple paths are shown as a comma-separated list\n- Fixed power assertion state handling so subsequent prompts are no longer blocked after an aborted or canceled prompt\n- Fixed IRC background exchange poll loop leaking after session disposal: `#scheduleBackgroundExchangeFlush` now stops immediately when `dispose()` is called, preventing stale `setTimeout` callbacks from firing against a torn-down agent\n\n## [14.9.2] - 2026-05-10\n\n### Added\n\n- Added `agentsMdFiles` to `WorkspaceTree` so AGENTS.md discovery results are returned with the workspace scan output\n\n### Changed\n\n- Changed startup workspace discovery to use one native `listWorkspace` walk for both the rendered tree and AGENTS.md directory-context candidates, removing the layered `git ls-files` orchestration and secondary AGENTS.md glob.\n\n### Fixed\n\n- Fixed AGENTS.md context discovery to include AGENTS.md files that are explicitly gitignored while still excluding AGENTS.md files under ignored directories\n- Fixed task tool renderer spamming `Tool renderer failed: undefined is not an object (evaluating 'args.tasks.length')` warnings while a `task` call was streaming in (the `tasks` array is undefined until the partial JSON parser closes it); the renderer now tolerates an absent `tasks` field and shows `0 agents` until the array arrives ([#985](https://github.com/can1357/oh-my-pi/issues/985)).\n- Fixed MCP HTTP streamable transport spamming `HTTP SSE stream error: ReadableStream already has a controller` after every JSON-RPC request whose response was returned as `text/event-stream`. The transport used to break out of the SSE iterator once the matching response was captured and then re-open `response.body` for a background drain, but the body had already been piped through a `TransformStream` and could not be re-read. The drain now runs from a single iterator that resolves the response promise inline and continues to dispatch piggybacked notifications on the same stream.\n\n## [14.9.0] - 2026-05-10\n\n### Breaking Changes\n\n- Moved hashline APIs to the dedicated `@oh-my-pi/pi-coding-agent/hashline` module, moved hash helpers to `@oh-my-pi/pi-coding-agent/hashline/hash`, and removed the legacy `edit/modes/hashline` and `edit/line-hash` source subpaths.\n\n### Removed\n\n- Removed hashline auto-rebase. Anchor mismatches now reject immediately so the model re-reads instead of silently relocating an edit to a hash-collision within \u00b15 lines, which could otherwise apply the change to the wrong region. Stale-anchor recovery via the cached read snapshot is unaffected.\n\n### Fixed\n\n- Fixed compaction crashing with `auth_unavailable` when the current model's provider has no credentials configured; compaction now falls back to an available model role (or fails fast with a clear error) instead of attempting a doomed provider call ([#986](https://github.com/can1357/oh-my-pi/issues/986)).\n- Fixed top-level static import rewriting in JS evaluation to use parser-based detection so only real import declarations are rewritten and `import` text inside strings, comments, or template literals is preserved\n- Fixed `import ... with` attribute handling in rewritten ESM imports so static imports with module attributes now become dynamic imports with matching `with` options\n- Fixed model resolution silently falling back to a different provider (e.g. Amazon Bedrock) when `modelRoles` specified a fully-qualified `/` whose exact pair was not in the bundled catalog. Explicit provider prefixes are now honored or surface a clear error ([#980](https://github.com/can1357/oh-my-pi/issues/980)).\n- Fixed session count inflation on Anthropic backend caused by a fresh random `metadata.user_id` being generated on every API request; all requests within one conversation now share a stable `metadata.user_id` derived from the session ID, matching the expected one-session-per-conversation counting\n- Fixed plan mode review resubmits to append each refreshed `local://PLAN.md` preview to the chat history, preserving the full refined plan in terminal scrollback.\n- Fixed compaction requests (manual and auto) not carrying `metadata.user_id`, leaving them unattributed on the backend\n- Fixed direct session-bound LLM calls (`/btw` ephemeral turns via `runEphemeralTurn`, branch summarization, session title generation) bypassing the agent and emitting a fresh random `metadata.user_id` per request on Anthropic OAuth: the session-level `prepareSimpleStreamOptions` helper now stamps the agent's session metadata onto direct calls, and `generateBranchSummary` plus `generateSessionTitle` accept and forward an explicit `metadata` option from the call site\n- Fixed `metadata.user_id` lacking the authenticated `account_uuid` on Anthropic OAuth requests; sessions now install a dynamic resolver via `Agent#setMetadataResolver` that builds `{ session_id, account_uuid? }` per request, looking the live OAuth account UUID up from `AuthStorage` so it stays in sync with token refreshes and login/logout transitions instead of stranding a stale value\n- Fixed multi-file legacy Pi extensions failing to load when sibling `.ts` files import each other via relative paths ([#983](https://github.com/can1357/oh-my-pi/issues/983)).\n- Fixed sub-agent dispatch silently routing to a model whose provider has no working credentials (e.g. an unqualified `modelRoles.task` id like `qwen3.6-plus-free` resolving to a provider the user is not authenticated against). Task dispatch now falls back to the parent session's active model \u2014 which by definition has working auth \u2014 when the resolved subagent model has none ([#985](https://github.com/can1357/oh-my-pi/issues/985)).\n- Fixed legacy Pi plugin extensions failing to load on Windows when their entry path contains a drive letter ([#990](https://github.com/can1357/oh-my-pi/pull/990) by [@jiwangyihao](https://github.com/jiwangyihao)).\n\n### Added\n\n- Added a debug-panel raw SSE stream viewer so stuck model/tool-call streams can be inspected live from the TUI.\n- Added `get_login_providers` RPC command to list registered OAuth providers with their current authentication status (`id`, `name`, `available`, `authenticated`)\n- Added `login` RPC command to trigger OAuth login for a given provider; emits an `open_url` extension UI event (fire-and-forget) carrying the auth URL and optional instructions so headless clients can open the browser, then resolves when the callback-server flow completes\n- Added `open_url` variant to `RpcExtensionUIRequest` for the above\n- Added `getLoginProviders()` and `login(providerId)` methods to `RpcClient`\n\n## [14.8.0] - 2026-05-09\n\n### Added\n\n- Added hashline stale-anchor recovery by replaying edits against a session-scoped `read`/`search` snapshot and 3-way-merging them onto the current file when anchors no longer match\n\n### Fixed\n\n- Fixed legacy pi extensions failing to import their own bare-specifier dependencies (e.g. `import x from \"pkg\"`): files loaded via the `omp-legacy-pi-file:` namespace now pre-resolve bare imports against the extension's directory so the extension's own `node_modules` is honored.\n\n### Changed\n\n- Changed hashline success output to include a warning when stale-anchor recovery is used\n\n## [14.7.8] - 2026-05-08\n\n### Fixed\n\n- Fixed indefinite startup hang on large repos introduced in 14.7.6 ([#975](https://github.com/can1357/oh-my-pi/issues/975)) on two fronts: (1) `createAgentSession` was awaiting `buildAgentsMdSearch` and `buildWorkspaceTree` directly in its blocking `Promise.all`, bypassing the existing 5s preparation deadline that previously protected startup \u2014 both scans are now raced against a 5s deadline and fall back to the system-prompt fallback path on timeout; (2) `buildWorkspaceTree` now derives its listing from `git ls-files --cached --others --exclude-standard` when the workspace is a git worktree, which is O(index size) and avoids the per-call full-tree gitignore-aware native scan that the previous implementation triggered. Repos without git, or where the call fails / times out, transparently fall back to the previous native-glob path.\n\n## [14.7.6] - 2026-05-07\n\n### Changed\n\n- Changed the \"Hide Thinking Blocks\" setting (Ctrl+T) to also instruct the provider to omit thinking/reasoning summaries from responses, instead of just hiding them client-side. Anthropic sees `thinking.display = \"omitted\"` (where supported); OpenAI Responses / Azure / Codex requests drop `reasoning.summary` entirely.\n\n### Fixed\n\n- Fixed the `Hide Thinking Blocks` toggle so changing it updates the active session\u2019s request settings immediately, ensuring new responses reflect the current hide-thinking preference\n- Fixed system prompt preparation to keep successful context data and only fall back to minimal defaults for preparation steps that fail\n- Fixed system prompt preparation timeout to apply per-step instead of all-or-nothing: a single slow step (e.g. `buildAgentsMdSearch` on a huge directory tree, `buildWorkspaceTree`, `loadProjectContextFiles`) now falls back to its own minimal default while the other steps still populate, and the warning names which steps timed out.\n- Fixed subagents re-running expensive workspace scans (`buildAgentsMdSearch`, `buildWorkspaceTree`) on every spawn: parents now forward their already-resolved `AGENTS.md` search and workspace tree to subagents through `createAgentSession`, matching how `contextFiles`, `skills`, and `promptTemplates` are already inherited. On large monorepos this removes seconds of redundant work per `task` invocation and prevents the per-subagent system-prompt timeout warnings.\n\n## [14.7.5] - 2026-05-07\n\n### Added\n\n- Added optional `/loop` limits: `/loop 10` stops after 10 auto-iterations, while duration forms such as `/loop 10m` and `/loop 10min` stop after the time limit.\n\n### Changed\n\n- Changed `/loop` to include the configured limit and remaining budget in the enabled status message\n\n### Fixed\n\n- Fixed `/loop` handling of malformed count or duration arguments by showing usage errors instead of enabling unbounded loop mode\n- Fixed inherited disabled macOS malloc stack logging variables leaking into shell sessions and spamming Bun subprocess output with `MallocStackLogging` warnings.\n\n## [14.7.4] - 2026-05-07\n\n### Breaking Changes\n\n- Removed the dedicated `notebook` tool; `.ipynb` reads and edits now go through `read` and `edit`.\n\n### Changed\n\n- Changed diff previews to syntax-highlight contiguous context lines in the unchanged sections when file language can be detected\n- Changed `read` tool behavior for `.ipynb:raw` requests to return raw notebook content instead of converting via markit\n- Changed `.ipynb` edit and read handling to route through notebook serialization helpers\n- Changed `.ipynb` reads to return an editable cell text representation and apply edits back to notebook JSON while preserving cell metadata and outputs where possible.\n\n### Removed\n\n- Removed the `notebook.enabled` configuration option from tool settings\n\n### Fixed\n\n- Fixed hashline edit streaming preview collapsing to a header-only \"opaque box\" when a second `@PATH` section header arrived mid-stream \u2014 earlier completed sections now stay rendered while the trailing section is still being typed.\n\n## [14.7.2] - 2026-05-06\n\n### Breaking Changes\n\n- Removed the exported `BUILTIN_TOOL_METADATA` API, including `BuiltinEntry`-style metadata exports and discoverable-built-in helper exports, which will break consumers relying on those symbols\n\n### Changed\n\n- Updated discoverable tool search (`search_tool_bm25` and related discovery metadata) to read each tool\u2019s own `summary` field when present, improving discoverability descriptions for built-in tools\n\n### Fixed\n\n- Fixed SearXNG web search Basic Auth validation to reject RFC 7617 control characters and clarified the equivalent `config.yml` and environment variable settings.\n- Fixed extension commands that return without starting a model turn leaving the interactive `Working\u2026` spinner active indefinitely. (#927)\n- Fixed `authHeader: true` provider overrides without custom `models` so built-in model transport headers receive `Authorization: Bearer ` (#929).\n\n## [14.7.1] - 2026-05-06\n\n### Added\n\n- Added `pr_create` operation to the GitHub tool to create pull requests with title/body (or `fill`), base/head branch, draft, reviewer, assignee, and label options and return a summarized result including the new PR URL\n- Added `read.summarize.prose` setting to keep Markdown and plain-text reads out of the structural summarizer by default.\n\n### Changed\n\n- Changed the `PI_GREP_WORKERS` environment variable help text to state that it sets filesystem walker workers, defaults to 4, and uses `0` for automatic worker selection\n- Changed hashline replacement and pure-insert auto-absorb to also drop a single duplicated structural-closing line (`}`, `);`, `]`, etc.) on either boundary when keeping it would unbalance brackets. The pure-insert variant fires regardless of `edit.hashlineAutoDropPureInsertDuplicates`, while the existing 2+ line generic absorb stays gated on that setting.\n\n## [14.7.0] - 2026-05-04\n\n### Breaking Changes\n\n- Changed session system-prompt APIs to use ordered string block arrays by requiring `buildSystemPrompt`, `CreateAgentSessionOptions.systemPrompt`, `Session.rebuildSystemPrompt`, and extension `before_agent_start`/`getSystemPrompt` hooks to accept and return `systemPrompt: string[]` instead of a plain system-prompt string or separate `projectPrompt` field\n- Changed `buildSystemPrompt` and session `rebuildSystemPrompt` APIs to return `{ systemPrompt, projectPrompt }`, requiring callers expecting a plain system prompt string to update to the new shape\n- Removed the top-level `sel` parameter from the `read` tool schema, requiring callers to migrate to `path`-embedded selectors (for example `path:50-100`, `path:raw`, or `https://...:L1-L40`)\n\n### Added\n\n- Added a separate `projectPrompt` artifact containing per-session project context (workstation, context files, AGENTS.md rules, workspace tree, and append prompt) so dynamic context is decoupled from the static system prompt\n- Added `Project prompt` token accounting to context-usage breakdowns and charts\n- Added `tools.elideFileMutationInputs` setting to optionally elide large `write`, `edit`, and `apply_patch` payloads in history after successful mutations\n- Added hashline-style return data for elided `write` calls so tools can include the resulting file content without leaking full input text\n- Added `buildDirectoryTree` and `DirectoryTree` exports to generate configurable directory trees with options for depth, entry limits, hidden-file handling, and truncation caps\n- Added `buildWorkspaceTree` and `WorkspaceTree` exports so callers can precompute and pass a workspace context to prompt generation\n- Added `workspaceTree` support to `buildSystemPrompt` options to reuse a prebuilt directory snapshot\n- Added `read.summarize.enabled`, `read.summarize.minBodyLines`, and `read.summarize.minCommentLines` settings to control whether `read` returns structural summaries and how many multiline body/comment lines are collapsed\n- Added `edit.hashlineAutoDropPureInsertDuplicates` setting to opt into dropping 2+ pure-insert hashline payload lines that duplicate adjacent file context; default is `false`.\n\n### Changed\n\n- Updated session dump and HTML export output to serialize ordered system-prompt blocks (including project context) and removed the dedicated project-prompt dump section\n- Renamed context-usage system-prompt accounting from a separate `projectPrompt` bucket to `systemContext` to match the new multi-block prompt structure\n- Changed prompt delivery to inject non-empty `projectPrompt` as a leading `developer` message before conversation messages instead of merging it into the base system prompt\n- Added `projectPrompt` to session dumps to expose the injected per-session project context separately\n- Changed write success output and preview rendering to display hashline-formatted written content from captured file text when mutation inputs are elided\n- Changed `read` directory rendering to return a two-level recency-sorted directory tree (including nested folders) instead of a flat alphabetical entry list, while still applying configurable truncation\n- Changed generated system prompts to include a working-directory tree block after directory context, showing recent files/directories (depth \u2264 3) and truncation notices when entries are elided\n- Changed `read` summary rendering to merge opening- and closing-brace boundaries around elided sections into a single `..` line (including closers like `};` or `})`), reducing those segments to one concise anchored summary line\n- Changed default `read` output for parseable code files without an explicit selector to return a structural summary instead of full verbatim lines, while still supporting full output for `:raw` and explicit ranges\n- Changed truncation/pagination hints in read, archive, and SQLite outputs to use colon syntax (`Use :`) when continuing reads\n- Changed the read tool UI preview title to include summary elision counts when a summary is returned\n- Changed hashline pure-insert duplicate auto-drop to be opt-in through `edit.hashlineAutoDropPureInsertDuplicates` instead of always enabled.\n\n### Fixed\n\n- Fixed selector parsing for colon-containing paths by only splitting `:` when the suffix matches a valid line-range or `raw` pattern, preventing paths like `db.sqlite:users:42` from being misread as selectors\n\n## [14.6.6] - 2026-05-04\n\n### Added\n\n- Added Ctrl+D draft persistence: pressing Ctrl+D with text in the editor now exits the app and saves the unsent text as a per-session draft. Resuming the same session (e.g. via `--resume`) restores the draft into the editor (one-shot, removed after restore).\n\n## [14.6.4] - 2026-05-03\n\n### Added\n\n- Added `hindsight.mentalModelsEnabled`, `hindsight.mentalModelAutoSeed`, `hindsight.mentalModelRefreshIntervalMs`, and `hindsight.mentalModelMaxRenderChars` settings to control curated Hindsight mental-model activation, seeding, refresh cadence, and prompt render budget\n- Added `` injection to developer instructions, loading bank-level curated summaries as stable background context\n- Added built-in `/memory mm` commands (`list`, `show`, `refresh`, `history`, `seed`, `reload`, `delete`) to inspect and manage mental models on the active bank\n- Added scope-aware mental-model seeding for `global`, `per-project`, and `per-project-tagged` banks, including built-in seed models like user preferences, project conventions, and project decisions\n- Added warning output when hashline block replacements auto-absorbed duplicate boundary lines\n\n### Changed\n\n- Changed `/memory clear` and `/memory enqueue` to apply only to the current agent session\u2019s Hindsight cache instead of all live Hindsight sessions\n- Changed the prompt assembly order so `` blocks are appended before `` recall blocks in developer instructions\n\n### Fixed\n\n- Fixed Hindsight memory prompt injection and recall/retain tool execution to resolve against the active session state, preventing context from an unrelated session from being used\n- Fixed subagent `/task` sessions to persist memories into the parent agent\u2019s Hindsight bank by explicit parent state wiring\n- Fixed per-session memory retention behavior when switching or resuming sessions by rekeying Hindsight state and resetting conversation-tracking counters so first-turn recall and nth-turn retain cadence no longer leak across conversations\n- Fixed the first-turn startup race so `` appears in the opening system prompt when mental-model loading is enabled\n- Fixed retention hygiene by stripping `` blocks from retained content to prevent curated summaries from feeding back into future memory writes\n- Fixed `` rendering to honor the configured character budget and truncate with an explicit truncation marker when the snapshot exceeds limits\n- Fixed hashline replacements so duplicated payload boundary lines adjacent to a replaced block are absorbed into the replacement range instead of being duplicated\n\n## [14.6.3] - 2026-05-03\n\n### Breaking Changes\n\n- Renamed hashline separator configuration from `PI_HASHLINE_SEP` to `PI_HL_SEP` and changed the default payload separator from `\\\\` to `>`\n\n### Added\n\n- Added inline hashline edit syntax so `< ANCHOR${sep}TEXT` prepended text to an anchored line and `+ ANCHOR${sep}TEXT` appended text to it without requiring a multi-line payload block\n- Added a `memory.backend` setting (off, local, hindsight) under a new Memory settings tab to control which memory subsystem is active\n- Added Hindsight memory settings (`hindsight.*`) for API connection, bank identification, and recall/retain policy\n- Added `retain`, `recall`, and `reflect` tools for direct long-term memory search, retention, and reflection when using the Hindsight backend\n- Added `hindsight.scoping` setting (`global`, `per-project`, `per-project-tagged`) that controls whether memories are shared across projects, isolated per cwd, or tagged so global + project memories merge on recall (default: `per-project-tagged`)\n- Added `search_code`, `search_commits`, and `search_repos` ops to the `github` tool so the search surface mirrors `gh search`'s subcommands\n\n### Changed\n\n- Changed `hindsight` tool retains to enqueue memory writes and return `Memory queued.` immediately instead of waiting on a network request\n- Changed `hindsight` tool memory writes to use automatic background batching (up to 16 items or 5 seconds) so tool calls do not block\n- Changed failed `hindsight` queue flushes to be surfaced as UI warning notices rather than failing the foreground `hindsight` tool call\n- Changed hashline read/search previews and diff output to keep `|` as the anchor-to-text separator while using the separate configured edit payload separator\n- Mapped invalid `hindsight.scoping` settings back to the default `per-project-tagged` behavior with a warning\n- Changed `/memory view`, `/memory clear`, and `/memory enqueue` to route through the selected memory backend instead of being hardcoded to local memories\n- Changed compaction context assembly to include backend-provided recall context when available\n- Updated multi-path `search`, `find`, `ast-edit`, and `ast-grep` calls to skip missing base paths, returning matches from remaining paths and reporting skipped paths in output\n- Replaced `hindsight.dynamicBankId` (boolean) with the explicit `hindsight.scoping` enum; legacy values are migrated automatically (`dynamicBankId=true` \u2192 `scoping=\"per-project\"`)\n- Changed `search_repos` to run as a global repository search using query qualifiers without applying the `repo` filter\n\n### Deprecated\n\n- Set explicit `hindsight.scoping` now takes precedence over legacy `hindsight.dynamicBankId` when migrating old settings\n\n### Removed\n\n- Removed legacy `hindsight.dynamicBankId` and `hindsight.agentName` fields from the active settings model\n- Removed `hindsight.agentName` and the `HINDSIGHT_AGENT_NAME` / `HINDSIGHT_CHANNEL_ID` / `HINDSIGHT_USER_ID` env vars; the legacy `agent::project::channel::user` bank tuple is gone. A user-set `agentName` is migrated onto `hindsight.bankId`.\n\n### Fixed\n\n- Fixed pending `hindsight` queued memory writes to flush on agent end, clear, and enqueue operations so tool-invoked facts are not dropped when sessions transition\n- Fixed retained memory writes from the `hindsight` tool to include session context and tags consistently in background batches\n- Fixed inline hashline modify operations to fail fast when combined with a delete or replace on the same target line\n- Fixed hashline parsing of payload blocks to handle a shared extra leading symbol prefix (such as markdown `>>`) on all payload lines by stripping it as an auto-correction instead of rejecting the edit\n- Forwarded project scoping tags to `hindsight` retain, recall, and reflect operations so manual memory commands honor the active tagging mode\n- Fixed legacy migrations by mapping existing `memories.enabled` values to `memory.backend` on load to preserve prior enable/disable behavior\n- Fixed memory retention so recalled `` blocks and legacy `` / `` blocks are stripped before storing transcripts and do not feed back as new memory\n- Fixed `search_code` output to include each match path, repository, shortened SHA, and a one-line matching fragment\n- Fixed `search_commits` output to show shortened SHAs with commit message first lines\n- Fixed `search_repos` output formatting to return repository summaries including language, stars, forks, issues, visibility, and key status fields\n\n## [14.6.2] - 2026-05-03\n\n### Added\n\n- Added `statusLine.sessionAccent` to disable session-name accent coloring for the editor border and status line gap ([#918](https://github.com/can1357/oh-my-pi/issues/918))\n\n### Fixed\n\n- Disabled repeated OSC 11 background-color polling under WSL to avoid Windows terminal tab crashes while keeping initial and event-driven appearance detection ([#914](https://github.com/can1357/oh-my-pi/issues/914))\n- Fixed SSH ControlMaster socket paths to use OpenSSH's connection hash (`%C`) so connections to the same host with different users, ports, or jump hosts do not share a master session.\n\n## [14.6.1] - 2026-05-02\n\n### Changed\n\n- Updated GitHub call headers to display operation-specific titles and contextual metadata such as repository, branch, issue/PR IDs, and search query snippets for supported operations\n- Changed non-run-watch result rendering to honor terminal width, truncate long lines, and show a `+N more lines` expansion hint when output exceeds the preview limit\n\n### Fixed\n\n- Fixed GitHub tool output fallbacks that previously always showed a GitHub Run Watch heading so they now show the actual operation and clear `no output`/`request failed` status messaging\n\n## [14.6.0] - 2026-05-02\n\n### Breaking Changes\n\n- Reworked autoresearch storage and protocol. State now lives in `~/.omp/autoresearch/.db` (SQLite) and per-run logs in `~/.omp/autoresearch//runs//benchmark.log`. The repo-side artifacts `autoresearch.md`, `autoresearch.sh`, `autoresearch.checks.sh`, `autoresearch.program.md`, `autoresearch.ideas.md`, `autoresearch.jsonl`, `.autoresearch/`, and `autoresearch.config.json` are no longer read or written; they are deleted by `/autoresearch clear`. Any existing data is not migrated.\n- Removed the autoresearch edit guard. `write`/`edit`/`ast_edit` are no longer blocked based on scope. Scope/off-limits are now post-hoc accountability fields on `log_experiment`.\n- Replaced rigid `init_experiment` contract validation with a simpler schema: `name`, `goal`, `primary_metric`, `metric_unit`, `direction`, `secondary_metrics`, `scope_paths`, `off_limits`, `constraints`, `max_iterations`, `new_segment`. Removed `from_autoresearch_md`, `abandon_unlogged_runs`, `force`, and `preferred_command` flags \u2014 the harness `./autoresearch.sh` is the canonical workload, edit it and bump segment when you need to change it.\n- `run_experiment` no longer accepts a `command` parameter. The tool always runs `bash autoresearch.sh`. To change the workload, edit the harness and call `init_experiment new_segment: true`. Removed `force`, `checks_timeout_seconds`, and the legacy `autoresearch.checks.sh` auto-execution; run validation through the regular `bash` tool.\n- Replaced `log_experiment` ASI requirements and `force`/`skip_restore` flags with `justification` (post-hoc explanation for scope deviations) and `flag_runs` (mark earlier runs suspect to exclude them from baseline math). ASI is now opaque metadata.\n- `/autoresearch clear` now resets the worktree to the session's recorded baseline commit (when on an `autoresearch/*` branch or with `--reset-tree`), closes the active session, and deletes any leftover legacy autoresearch repo artifacts.\n- `/autoresearch` now refuses on a dirty worktree with an explicit error instead of silently continuing on the current branch. Commit or stash before invoking \u2014 the session needs a clean baseline on a dedicated `autoresearch/*` branch.\n- Split `/autoresearch` into a two-phase protocol. Phase 1 (no session) prompts the agent to build the benchmark harness as `./autoresearch.sh` (must exit 0 and print `METRIC =`). Calling `init_experiment` ends Phase 1: it requires `./autoresearch.sh` to exist, auto-commits any pending harness changes on an `autoresearch/*` branch, then records that commit as the baseline. Phase 2 is the existing iteration loop.\n- Autoresearch sessions are now scoped to the git branch they were created on. Switching off the `autoresearch/*` branch hides the dashboard widget, detaches the experiment tools, and skips the autoresearch system prompt; switching back resumes seamlessly. `/autoresearch` on a fresh branch starts a fresh session instead of resurrecting a session bound to a different branch.\n- `log_experiment discard` no longer rewinds prior `keep` commits. On an `autoresearch/*` branch it now resets the worktree to `HEAD` (and `git clean`s untracked) instead of `git reset --hard $baseline_commit`. Discard reverts only the current iteration's uncommitted edits; previously kept improvements stay on the branch. `/autoresearch clear` continues to reset to the recorded baseline commit when explicitly requested.\n- Autoresearch SQLite storage is now created lazily on first `init_experiment`. Running `omp` in a project that never invokes `/autoresearch` no longer creates a per-folder DB.\n- Changed `search`, `find`, `ast_grep`, and `ast_edit` to accept `paths: string[]` instead of comma- or whitespace-delimited path strings.\n\n### Added\n\n- Added `update_notes` tool with `body` (replace) and `append_idea` (append a bullet under an `## Ideas` section). Notes are injected into the system prompt every iteration and replace the file-based `autoresearch.md` / `.program.md` / `.ideas.md` ecosystem.\n\n### Changed\n\n- Updated `log_experiment` summary output to include the count of scope deviations detected for a run\n- Used the active session context in autoresearch resume instructions instead of referencing deleted repo-side files\n- Removed `PI_STRICT_EDIT_MODE`; model-specific edit mode fallbacks are no longer disableable by environment flag.\n\n### Fixed\n\n- Atom edit auto-rebase warning now dedupes by `(originalLid, rebasedLine)` pair. Previously, `@Lid` followed by N `+TEXT` lines emitted N identical \"Auto-rebased anchor\" warnings (one per cloned cursor anchor); now emits exactly one per distinct rebase.\n- Atom/hashline diff preview no longer renders deleted lines with a 2-space hash placeholder (`-20  |old`) that visually mimicked a Lid. Removed lines now use `--` as the placeholder (`-20--|old`), making them unambiguously non-Lid.\n- Atom/hashline diff preview no longer folds size-mismatched `-`/`+` runs into a confusing mix of `*` (paired modification) lines plus surplus `-`/`+` lines. The `*` collapse now applies only to clean 1:1 line replacements (same number of dels and adds); range replaces with N\u2192M (N\u2260M) render as plain unified-diff `-` then `+` runs.\n- Atom edits now warn when `@Lid` lands on a brace-opening line and the inserted content is at sibling indent (\u2264 anchor indent) \u2014 a foot-gun where the agent meant `^` but the inserts ended up as the first body element of the `{...}` block.\n- Atom auto-fix warning for adjacent-duplicate cleanup is now formatted as `AUTO-FIX applied \u2014 verify the result. Removed ...` instead of the easier-to-miss `Auto-fixed: removed ...`, and explains that `{}/()/[]` balance was the trigger.\n- Fixed multi-target `search`, `ast-grep`, and `ast-edit` path handling by running each resolved target separately under root-level path resolution\n- Fixed pagination and match/replacement summaries for multi-target AST and text searches so totals and affected file counts include all targets\n- Fixed returned file paths for multi-target `search` and `ast-grep` results by normalizing them to the original search scope\n- Fixed `log_experiment keep` silently dropping the iteration's diff on an autoresearch branch. The previous logic filtered out every path that was already dirty when `run_experiment` ran \u2014 but in the iteration cycle the agent's edits always land before `run_experiment`, so the entire iteration was filtered away and nothing was committed. On an autoresearch branch, `keep` now treats every currently-dirty path as the iteration's change and commits it.\n\n## [14.5.14] - 2026-05-01\n\n### Changed\n\n- Changed markdown conversion and archive tooling to defer loading heavy dependencies (Turndown, fflate, and browser agent content) until first use, reducing startup overhead for CLI startup and command initialization\n\n### Fixed\n\n- Fixed changelog state tracking by flushing `lastChangelogVersion` to settings immediately when showing new entries, so the updated version is persisted across restarts\n\n## [14.5.13] - 2026-05-01\n\n### Breaking Changes\n\n- Removed the built-in `python` tool in favor of `eval`, so tool allowlists and tool-call handlers referencing `python` need to migrate\n- Removed the `python.toolMode` setting and replaced mode control with separate `eval.py` and `eval.js` toggles\n- Changed the tool runtime config surface by migrating `python` execution timeout/export behavior to `eval` and replacing `./ipy/*` internal exports with `./eval/*` paths\n- Changed the `eval` tool wire format to a single `input` string composed of markdown fenced code blocks (with per-fence language, timeout, title, and reset metadata in the info string) instead of top-level `cells`, `language`, `timeout`, and `reset` fields\n\n### Added\n\n- Added a JavaScript backend to the `eval` tool with an in-process VM runtime and JS helper bridge (`read`, `write`, `glob`, etc.)\n- Added `eval.py` and `eval.js` settings so Python and JavaScript `eval` backends can be enabled or disabled independently\n- Added `rename_file` action to the Lsp tool to rename files and directories with LSP `workspace/willRenameFiles` and `workspace/didRenameFiles` flow, applying returned workspace edits before moving files\n- Added `apply: false` preview mode for `rename_file` so users can see planned LSP edits without performing filesystem changes\n- Added `request` action to invoke arbitrary LSP methods, with automatic `textDocument`/`position` parameter construction from `file`/`line`/`symbol` and support for explicit JSON `payload`\n- Added `capabilities` action to display language server capabilities (for a file or all configured servers) through the LSP tool\n\n### Changed\n\n- Changed AGENTS.md discovery to respect `.gitignore` files during project context collection so ignored context files are no longer loaded\n- Changed eval tool initialization to skip Python kernel preflight when the JavaScript backend is enabled, avoiding unnecessary startup checks\n- Changed model registry refresh flow to defer rebuilding the canonical model index until refresh operations complete, reducing refresh churn\n- Changed execution/tool discovery flow so `exec` maps to `eval` when any `eval` backend is enabled, while `bash` stays independently available\n- Changed `eval` dispatch to automatically fall back to JavaScript when Python is unavailable and JavaScript backend is enabled\n- Parallelized plugin root preloading with other startup initialization in `runRootCommand` to reduce startup latency\n- Parallelized session bootstrap work in `createAgentSession`, including AGENTS.md scanning, context discovery, prompt template loading, slash command loading, and skill discovery, to reduce time to first available session\n\n### Fixed\n\n- Fixed eval startup messaging to report `eval` as unavailable when Python is unreachable and JavaScript backend is disabled\n\n## [14.5.12] - 2026-04-30\n\n### Breaking Changes\n\n- Removed the legacy browser action verbs (`goto`, `observe`, `click`, `type`, `fill`, `press`, `scroll`, `drag`, `wait_for_selector`, `extract_readable`, and `screenshot`) in favor of invoking those workflows through `run`\n\n### Added\n\n- Added a `browser` tool `open`/`run`/`close` flow with a `run` action that executes async JavaScript and provides `page`, `browser`, `tab`, `display`, `assert`, and `wait` in scope\n- Added named tabs on `open` with default name `main` so browser state can be reused across `run` calls and subagents\n- Added support for `app.path` and `app.cdp_url` on `open` to launch/connect to CDP-capable desktop apps\n\n### Changed\n\n- Changed browser tool output rendering to display `run` calls as JavaScript code cells with status and output previews while showing `open`/`close` as compact status lines\n- Changed `open` to open or reuse named tabs and `close` to support `all: true` and `kill`-based process termination behavior\n- Changed app attachment behavior to reuse an existing CDP endpoint when available and avoid unnecessary respawn of matching app processes\n- Changed tab closing so closing a tab no longer implicitly affects unnamed sessions when multiple tabs are used\n- Changed browser export rendering to label outputs under the `browser` tool and include app metadata badges\n\n### Fixed\n\n- Fixed Electron/CDP attachment target selection to skip helper windows and pick the most likely user-visible page target\n- Fixed connection startup by waiting for the CDP endpoint and surfacing a timeout error when it does not become available\n- Fixed plan mode to auto-redirect `write` and `edit` calls targeting a bare `PLAN.md` (or any same-basename cwd-relative path) to the canonical `local://PLAN.md` plan artifact instead of rejecting them\n\n## [14.5.11] - 2026-04-30\n\n### Breaking Changes\n\n- `todo_write`: renamed `replace` op to `init` and reshaped its input to `list: [{phase: string, items: string[]}]`. Tasks no longer accept a `status` field; all start `pending` and the first auto-promotes to `in_progress`. The `append` op's `items` is now `string[]` (was `{id, label}[]`)\n- `todo_write`: removed the synthetic `task-N` / `phase-N` ids \u2014 task identity is now its `content` and phase identity is its `name`. The `task` field on `start`/`done`/`drop`/`note` and the `phase` field on `done`/`drop`/`rm`/`append` take those values directly\n- `todo_write`: phase names no longer accept a numeric/roman prefix (`I.`, `1.`, `Phase 1:`, \u2026). The renderer numbers phases visually (\u2160. \u2161. \u2162. \u2026) and the model-facing state stores the bare noun phrase\n\n### Changed\n\n- Changed `/todo` task and phase operations to target items by fuzzy content or phase name matching instead of numeric IDs\n- Changed initial todo markdown export template heading from `# I. Todos` to `# Todos`\n\n### Fixed\n\n- Fixed todo auto-clear scheduling to identify completed tasks by phase and content so only the matching task is cleared after delays\n\n## [14.5.10] - 2026-04-30\n\n### Breaking Changes\n\n- Removed the `worktree` parameter from `github` `pr_checkout`. Worktrees are now always written to `~/.omp/wt//pr-/`, derived from the primary repository path\n- Stopped reading the `branch` parameter for `github` `pr_checkout`. The local branch is now always `pr-`; the `branch` schema field is still accepted by `pr_push`, `repo_view`, and `run_watch`\n\n### Added\n\n- Added `checkouts` summary entries to `pr_checkout` results, including each checkout's branch, worktree path, remote, and reuse status\n- Added combined summaries for `pr_view` and `pr_diff` when `pr` is an array, so multi-request responses now include all requested pull requests in one return\n- Added array support to the `pr` parameter on `github` `pr_view`, `pr_diff`, and `pr_checkout` so a single call can fetch, diff, or check out multiple pull requests in one batch\n- Added a per-repo serialization lock (`withRepoLock`) so concurrent `pr_checkout` calls against the same repository no longer race on git's internal `.git/config.lock`, commit-graph, and worktree lock files\n\n### Changed\n\n- Changed the diff preview shown after edits so changed lines are never collapsed: removed runs and the global preview budget no longer truncate, only unchanged context still collapses\n- Changed adjacent `-`/`+` pairs in edit previews to fold into a single `*|` modification line so 1:1 line replacements stay compact\n- Changed `git.remote.add` to be idempotent when the remote already exists with the same URL (instead of failing with `remote ... already exists`), and to surface a clear error when the existing URL differs\n- Changed `pr_checkout` to run `gh pr view` calls in parallel for batch invocations while serializing the in-repo git mutations to keep the operation race-free\n- Changed `pr_checkout` to auto-derive the worktree location and local branch name (see Breaking Changes), removing the per-call overrides that previously let callers pin a worktree path or local branch\n\n### Removed\n\n- Removed the `./hooks` and `./hooks/*` package export entries\n- Removed the `Suspicious duplicate` warning emitted after edits \u2014 it produced too many false positives (e.g. legitimate adjacent `\\t});\\n\\t});`); the auto-fix path that uses bracket balance to safely de-duplicate is unchanged\n\n### Fixed\n\n- Fixed bash interceptor rules to also check the original command before `cd` normalization, so leading `cd ... &&` wrappers no longer bypass interception\n- Fixed LSP client shutdown to properly await the language server's exit instead of fire-and-forget, preventing premature process termination on SIGINT and SIGTERM\n- Fixed concurrent bash commands being tracked independently so aborting one no longer silently drops tracking of others\n\n## [14.5.9] - 2026-04-30\n\n### Added\n\n- Added the `/context` slash command to display an estimated context-usage breakdown panel for the current session\n- Added `-LidA..LidB` syntax to delete inclusive line ranges in a single atom operation\n- Added `LidA..LidB=TEXT` range-replace syntax with `\\TEXT` and `\\` continuation lines for multi-line replacement blocks\n- Added shorthand cursor+insert operations in atom edits, including `^Lid` (insert before anchor), `^+TEXT`, `$+TEXT`, and `Lid+TEXT`/`@Lid+TEXT`\n- Added standalone file-op fallback so `!rm` and `!mv DEST` inputs can be normalized into sections when using split input parsing\n\n### Changed\n\n- Changed token counting to use tokenizer-based estimates instead of a character-per-4 heuristic for context and compaction calculations\n- Changed hashline anchor auto-rebase tolerance from \u00b12 lines to \u00b15 lines for stale Lid recovery\n- Changed atom input handling so `#`-prefixed lines are treated as comments and ignored\n- Changed execution when all edits are no-op `Lid=TEXT` replacements to return success with a no-change explanation instead of throwing\n\n### Fixed\n\n- Fixed malformed range and unified-diff-like atom syntax by rejecting reversed ranges, mismatched range endpoint hashes, and forms like `+Lid|TEXT`, `+Lid=TEXT`, and `-LidA..LidB|TEXT` with explicit actionable errors\n- Fixed hash mismatch errors to include likely-shifted anchor hints when a unique matching line is found elsewhere in the file\n\n## [14.5.8] - 2026-04-29\n\n### Breaking Changes\n\n- Changed the task runner toggle from `just.enabled` to `runCommand.enabled`, so existing configurations using `just.enabled` must be migrated\n- Removed the legacy `just` tool and replaced it with `run_command`\n- Renamed the built-in tool API from `just` to `run_command`, so clients requesting/handling the old tool name must update\n\n### Added\n\n- Added a new `run_command` tool that runs project tasks via a single `op` argument, auto-detecting and supporting recipes from justfiles, `package.json` scripts (including workspace packages), Cargo bin/example/test targets, Makefiles, and Taskfiles\n- Added support for explicit runner-qualified tasks via `run_command` with `runnerId:task` syntax in the prompt guidance\n\n### Changed\n\n- Changed automatic tool availability so requesting `bash` can now auto-include `run_command` when a supported task runner manifest is detected in the working directory\n- Changed task resolution to disambiguate identical task names across multiple runners and show runner-aware command execution errors\n\n### Fixed\n\n- Fixed editor draft being erased when a user message queued during streaming was eventually submitted; the queue/steer path now preserves any new prompt the user has typed since queuing, matching the existing optimistic-send protection.\n\n## [14.5.7] - 2026-04-29\n\n### Fixed\n\n- Fixed hook editors to recognize Ctrl+Enter when terminals include NumLock or keypad Enter metadata.\n\n## [14.5.6] - 2026-04-29\n\n### Changed\n\n- Removed the atom edit mode's multi-anchor auto-rebase rejection so stale-but-uniquely-rebasable block edits apply with warnings instead of failing.\n\n## [14.5.5] - 2026-04-29\n\n### Breaking Changes\n\n- Rejected atom diffs with unrecognized operations (including lone '-' lines) by throwing parse errors instead of treating them as inserts\n\n### Added\n\n- Added duplicate-line post-edit detection that warns on newly introduced adjacent identical lines and auto-removes one duplicate when bracket-balance is restored\n- Added a warning when suspicious adjacent duplicates are introduced after edits so users can review potential stale-line issues\n\n### Changed\n\n- Changed anchor rebase handling to fail when multiple mutating anchors would need auto-rebase, preventing silent misapplied contiguous block rewrites\n\n### Fixed\n\n- Fixed bracket-corruption caused by botched block rewrites by automatically removing a newly introduced duplicate adjacent line when removing it restores the original `{}`, `()`, and `[]` balance and by warning when automatic removal is unsafe\n\n## [14.5.4] - 2026-04-28\n\n### Breaking Changes\n\n- Changed the `atom` edit mode from JSON `{ path, edits }` calls to the compact file-oriented `input` patch language that was previously exposed as `atomd`; `atomd` is no longer a separate edit variant\n- Renamed MCP tool identifiers from the `mcp__` format to `mcp___` so custom tool names, active tool lists, and persisted MCP selections must be updated to the new prefix\n- Renamed the built-in content-search tool from `grep` to `search`, including SDK/tool event names and settings keys (`search.enabled`, `search.contextBefore`, `search.contextAfter`), so integrations using `grep` and `grep.*` references must be updated\n\n### Added\n\n- Added internal URL support to the `search` tool, allowing `artifact://`-style paths that resolve to local files to be searched directly\n- Added IRC relay observation in the main agent UI so every IRC exchange between agents is rendered in the main transcript, even when the main agent is not a direct participant\n- Added stateful `href`/`hrefr` prompt helpers that can reuse anchors remembered from prior `hline` helper calls\n\n### Changed\n\n- Changed file-path rendering across search, find, AST, LSP, and related edit outputs to display targets as cwd-relative paths when they resolve inside the working directory and keep absolute paths for files outside the cwd\n- Changed system prompt guidance so in-cwd tool paths must be passed as cwd-relative paths and absolute paths only for out-of-cwd targets or `~` expansion\n- Updated `edit` streaming diff previews for `patch`, `replace`, and `hashline` to produce a single request-level preview for the new single-file `path` mode\n- Bumped default `read.defaultLimit` from 300 to 500 lines, and scaled the read tool's byte budget with the line limit (`max(50KB, lines * 512)`) so the configured line count is no longer truncated by the shared 50KB cap\n\n### Fixed\n\n- Fixed atom edit streaming previews to use atom headers for file names instead of apply_patch parsing errors.\n- Fixed collapsed search result rendering so summary and truncation rows stay within the collapsed output budget\n- Updated search path handling to support path lists and internal file paths while preserving previous search behavior\n\n## [14.5.3] - 2026-04-27\n\n### Added\n\n- Added bracketed `loc` forms `(anchor)`, `[anchor]`, `[anchor`, `(anchor`, `anchor]`, and `anchor)` to `atom` `splice` editing so a single anchor can target a block body, whole node, or partial node region\n- Added automatic block-delimiter inference for block splices using file extension, defaulting to `{` and using `(` for Lisp-family files\n- Added optional `pre`/`post` arguments to the `href` prompt helper so hashline references can be wrapped as bracketed or parenthesized anchors\n- Added destination-aware indent handling for block replacements by detecting file indent style and reapplying tabs/spaces to spliced body text\n\n### Changed\n\n- Changed bracketed atom locators to be `splice`-only and reject `pre`, `post`, or `sed` on region locators\n- Changed `applyAtomEdits` to forbid mixing `splice_block` with other anchor-scoped edit verbs in one call\n- Changed `splice_block` resolution behavior to include selected block range and enclosing-count context in warning output\n- Changed balanced-block parsing to support `kind` selection (`{`, `(`, `[`), nesting depth, and safer same-line enclosing selection\n\n### Removed\n\n- Removed the `sed` `F` option for literal matching; `sed` now accepts only `pat`, `rep`, and optional `g`, with `F`-style literal matching no longer supported\n\n### Fixed\n\n- Fixed `splice_block` multi-line replacements to replace the exact target region and avoid duplicate braces or duplicated signature lines from bare-anchor `splice` attempts\n- Fixed false-positive \u201cunbalanced\u201d replacement-body warnings caused by braces in regex/string/comment text by skipping those constructs during block scanning\n- Fixed `splice_block` for same-line `(` bodies so inline call sites like `int(port)` can be replaced correctly\n\n## [14.5.2] - 2026-04-26\n\n### Breaking Changes\n\n- Removed support for sed-style string expressions and required `sed` to be specified as an object with `pat` and `rep` (and optional `g`, `F`, `i` flags)\n\n### Changed\n\n- Changed atom `sed` replacements to be global by default and require `g:false` for first-match-only replacements\n- Changed anchor validation so multiple `sed` operations can target the same line and run sequentially\n- Changed cross-entry conflict resolution so `del` edits on an anchor are ignored when that line is also replaced by `sed` or `splice` in another edit entry\n\n### Fixed\n\n- Fixed zero-length regex `sed` patterns (for example `()`, `^`, `$`) to fall back to literal substring matching instead of producing insertion-like replacements\n- Fixed `sed` chaining so each edit on the same anchor applies to the latest line state from prior replacements\n\n## [14.5.1] - 2026-04-26\n\n### Removed\n\n- Removed `\\t` escaped-tab indentation autocorrect from hashline and atom edit modes (and the `PI_HASHLINE_AUTOCORRECT_ESCAPED_TABS` environment toggle); literal `\\t` in edit content is now preserved verbatim\n- Removed the suspicious-`\\uDDDD` warning preflight from hashline edits\n- Removed the hand-rolled JSON unescape fallback in the streaming edit-arg renderer; partial fragments that fail `JSON.parse` are now surfaced raw rather than partially decoded with a non-spec-compliant unescaper that mishandled lone surrogates\n\n## [14.4.3] - 2026-04-26\n\n### Added\n\n- Added `irc` tool for agent-to-agent messaging with `list` and `send` operations, including optional broadcast to `all` and optional suppression of reply waits\n- Added `irc.enabled` tool setting (default `true`) to toggle agent-to-agent messaging\n- Added live in-chat rendering of IRC incoming and auto-reply messages so peer messages now appear in the session transcript\n\n### Changed\n\n- Changed peer-aware prompts for subagents to include currently live agent peers and IRC usage guidance when available\n- Changed the `/btw` helper to use a session-side ephemeral turn path that preserves streaming-context handling and updates the existing request handling behavior\n- Merged the `poll` and `cancel_job` tools into a single `job` tool that accepts `poll` and `cancel` arrays; the renamed tool reuses the richer poll renderer for both polling and cancellation calls\n\n### Fixed\n\n- Fixed IRC messaging to use a background ephemeral turn path so a recipient can reply even while its main loop is busy\n- Fixed `/btw` handling of empty prompts and missing model configuration by rejecting invalid requests before starting a stream\n- Fixed `/btw` request replacement so issuing a new query cleanly aborts the previous active request\n\n## [14.4.2] - 2026-04-26\n\n### Breaking Changes\n\n- Changed `/todo append` from JSON payload input to `/todo append [] ` with optional quoted tokens and automatic phase creation\n\n### Added\n\n- Added `note` to todo-write operations so you can append follow-up text notes to a task via `op: \"note\"` and `text`\n- Added markdown note-block support to `/todo export` and `/todo import` so task notes are written as blockquote lines and reloaded with the todo list\n- Added `/todo export ` to write the current todo list as Markdown to a file, defaulting to `TODO.md` when no path is provided\n- Added `/todo import ` to replace the current todo list from a Markdown file, defaulting to `TODO.md` when no path is provided\n- Added live poll progress updates so the UI now emits intermediate job state while waiting for jobs to finish\n- Added a dedicated TUI renderer for the `poll` tool that displays job status, counts, duration, and result/error previews\n- Added a `/todo` slash command to view and modify todos with `edit`, `copy`, `start`, `done`, `drop`, `rm`, `append`, and `replace` operations\n- Added `/todo edit` to open the current todo list in `$EDITOR` as Markdown and sync the edited checklist back into the session\n- Added `/todo copy` to copy the rendered Markdown todo list to the clipboard\n\n### Changed\n\n- Changed todo list rendering and summaries to show a `+N` note marker on task lines and display attached notes for tasks in progress\n- Changed `/todo start`, `/todo done`, `/todo drop`, and `/todo rm` to resolve task/phase targets by fuzzy id/name matching instead of strict identifiers\n- Removed `/todo replace` from supported slash commands\n- Changed todo list restoration to include user todo-edit custom session entries so slash-command and editor-based todo updates persist after reload\n- Restored sensible defaults for `grep.contextBefore` (1) and `grep.contextAfter` (3) so grep matches show context lines by default after the `pre`/`post` parameters were folded into settings\n\n### Removed\n\n- Removed the `chunk` edit mode, chunk-aware `read` selectors, chunk-aware `grep` rendering, and the `omp read` chunk CLI subcommand\n- Removed the `read.prosechunks`, `read.explorechunks`, and `read.anchorstyle` settings\n- Removed the underlying `chunk` native module and AST-based chunk schema generation from `pi-natives`\n\n### Fixed\n\n- Fixed poll final output to reflect live job data from the async job manager, improving status and result visibility\n- Fixed job duration and output reporting to use current job snapshots instead of initial poll input metadata\n- Fixed `poll` wait duration parsing to fall back to `30s` when the provided value is an empty string\n\n## [14.4.1] - 2026-04-26\n\n### Breaking Changes\n\n- Replaced the legacy `gh_repo_view`, `gh_issue_view`, `gh_pr_view`, `gh_pr_diff`, `gh_pr_checkout`, `gh_pr_push`, `gh_run_watch`, `gh_search_issues`, and `gh_search_prs` tool names with only `github`, which requires updating existing callers that invoked the old `gh_*` tools\n\n### Added\n\n- Added a `sed` verb to the `atom` edit tool for line-local substitutions using sed-style syntax (`s/pattern/replacement/`) with `g`, `i`, and `F` flags and model-tolerant delimiter choices\n- Added the unified `github` tool with op-based dispatch for repository, issue, pull request, search, checkout, push, and Actions watch workflows\n- Added `op` routing so callers can select `repo_view`, `issue_view`, `pr_view`, `pr_diff`, `pr_checkout`, `pr_push`, `search_issues`, `search_prs`, or `run_watch` through a single tool entry point\n\n### Changed\n\n- Changed hashline-based read and match output formatting to use `LINE+ID|content` as the anchor/content separator, and updated match/context markers to `>` for matches and `:` for context\n- Updated GitHub CLI render output to show `GitHub ` for tool calls dispatched through `github` operations\n\n### Removed\n\n- Removed the built-in `taplo` Language Server entry from default LSP settings, so TOML files no longer have default TOML server startup\n\n### Fixed\n\n- Fixed `atom` `loc` parsing so path-qualified anchors like `path:263ti| ...` and single-anchor locs containing hyphens no longer mis-parse as ranges\n- Fixed hashline anchor handling in `atom` edits so a provided content hint after the anchor (`|` or `:` suffix) can rebond a stale hash to the intended line\n- Fixed `atom` `sed` execution to tolerate common model-emitted forms such as `/pat/rep/`, and to apply safe literal fallbacks for regex failures or metacharacter-heavy patterns while still erroring when no match is possible\n\n## [14.4.0] - 2026-04-26\n\n### Breaking Changes\n\n- Removed multi-pattern array input from `ast_grep` by changing `pat` to a single pattern string, so call sites using `pat: [...]` must be updated to send one query per invocation\n- Removed `lang`, `glob`, and `sel` options from `ast_edit` and `ast_grep`, and moved those behaviors into the required `path` argument\n- Required `path` for `ast_edit` and `ast_grep`, so invocations that relied on implicit repo-root searching are no longer valid\n- Changed `todo_write` from multi-field verb payloads to an ordered array of flat operations, while retaining `replace` for harness bootstrap compatibility\n- Renamed atom edit operations from `before` and `after` to `pre` and `post`, so existing `atom` payloads using the old operation keys must be updated\n- Changed the hashline anchor format from `LINE#ID:content` to `LINEID:content` (no `#` separator, colon between anchor and content, no padding on line numbers); expanded the bigram alphabet from 40 hand-picked English bigrams to the full 647 single-token 2-letter bigrams \u2014 invalidates every previously captured `LINE#ID` reference\n- Renamed the subagent completion contract from `submit_result` to `yield`, so subagent sessions must now finish with the `yield` tool and the `requireYieldTool` option; `submit_result`/`requireSubmitResultTool` and old completion calls are no longer recognized\n- Changed the hashline and chunk anchor ID format from the prior hex-like tokens to two-letter BPE bigrams (for example `#th`), which invalidates previously captured `LINE#ID`/chunk selectors and requires re-reading to refresh anchors\n\n### Added\n\n- Added inline file overrides in atom locators (`loc: \"a.ts:160sr\"`) so cross-file edits can be written without a separate per-entry `path` field\n- Added `openai` to the `providers.image` options, allowing image generation to be explicitly routed through the active GPT Responses/Codex model\n- Added `between` atom edit operation to replace only the lines between two surviving anchors while preserving the boundary anchors\n- Added conflict detection for `between` atom edits to require non-overlapping regions and forbid edits targeting lines strictly inside those regions\n- Added `atom` edit mode to `edit` with single-anchor operations (`set`, `before`, `after`, `del`, `sub`, `ins`) for hashline-anchored line edits\n- Added support for request-level `path` defaults in patch, replace, and chunk edits so shared file paths no longer need to be repeated in every entry\n\n### Changed\n\n- Updated `atom` and `hashline` edit anchor validation to auto-rebase a stale anchor within \u00b12 lines when the same hash matches a unique nearby line, continuing the edit with a warning instead of immediate failure\n- Changed bash command output labels from `[full result: artifact://\u2026]` to `[raw output: artifact://\u2026]` for artifact references produced from large command output\n- Changed `todo_write` `done`, `rm`, and `drop` operations to target all tasks when neither `task` nor `phase` is provided, and made `append` create the target phase automatically when missing\n- Updated `ast_edit` and `ast_grep` to pass file-selection intent through `path` (including inline globs and comma/space-separated path lists) instead of separate `glob` filters\n- Changed `ast_grep` pagination API from `offset` to `skip`\n- Flattened `todo_write` operation arguments to `{ op, task?, phase?, items? }[]` and removed task details from the persisted todo shape\n- Changed `grep` truncation output to report `Result limit reached; narrow path.` and label match/result caps as `first N`\n- Changed JSON tree output to truncate inline argument pairs by available width and add an ellipsis when values no longer fit in the display\n- Changed JSON tree rendering to hide harness-internal `intent` and `__partialJson` fields from top-level tool output\n- Simplified the `grep` tool schema by requiring `path`, folding glob and type filtering into path globs, auto-detecting multiline patterns, removing model-controlled context and limit options, and renaming result skipping to `skip`.\n- Changed atom edit request format to use a shared `loc` selector, including range (`\"160sr-9ab\"`) and boundary (`\"^\"`, `\"$\"`) forms instead of per-operation anchor fields\n- Changed atom edit payload fields so `set`, `pre`, and `post` now require line-array values and `sub` now takes a `[find, replace]` tuple, with boundary deletion now expressed as `set: []`\n- Changed edit diff wrapping to preserve the active line-prefix separator (`|` or `\u2502`) while keeping continuation lines aligned by line-number width\n- Changed Vim focus and viewport rendering to align cursor/selection markers and line numbers in a single gutter format\n- Changed auto image provider selection for `providers.image=auto` to try active GPT image generation before Antigravity, OpenRouter, and Gemini\n- Updated atom and hashline anchor validation to require the full `line+suffix` anchor format and report missing-line-number errors more clearly, including guidance when only a 2-letter suffix is provided\n- Changed read, grep, and ast-edit line-prefixed output to drop fixed-width line number padding, so anchors render in natural width without leading spaces\n- Updated terminal diff rendering to use a continuous `\u2502` gutter and hide repeated line numbers on adjacent diff lines\n- Updated subagent reminders, prompts, and rendered subagent output to reference `yield` completion and report missing/final results from `yield` tool data\n- Updated the `edit` workflow to treat `atom` mode like hashline mode for read output, so hashline anchors are shown when `atom` is selected\n- Adjusted patch/replace/chunk tooling to accept optional entry paths and to apply a top-level path default\n- Updated hashline/chunk selector parsing to the new stable bigram token set used for checksums\n- Renamed the image generation implementation module to `image-gen` and routed active GPT Responses/Codex models through OpenAI's hosted `image_generation` tool with WebP output\n\n### Removed\n\n- Removed line-range support from `atom` mode selectors, including `loc` values like `160sr-170ab`, so edits must target a single anchor (`160sr`, `^`, or `$`) per entry\n- Removed the atom `del` verb and now require anchored-line deletion to be requested with `set: []`\n- Removed `todo_write` task details and the `add_notes` operation\n\n### Fixed\n\n- Improved no-op edit diagnostics for `atom` and `hashline` operations so edits that leave content unchanged now fail with contextual details (edit index, locator, and reason), including guidance for `replace_range` no-op cases\n- Wrapped `todo_write` operations in an `ops` object so Codex/OpenAI function schemas always use a JSON Schema object.\n- Fixed JSON tree rendering for tool arguments by excluding injected internal keys from displayed root records\n- Printed assistant `errorMessage` text in print mode output to stderr so message-level errors are visible during non-interactive runs\n- Displayed assistant `errorMessage` text in the assistant message component for completed tool responses with non-terminal stop reasons\n- Fixed atom input handling to ignore null optional verb fields so entries with `pre`, `set`, `post`, or `sub` set to `null` remain valid\n- Fixed status-line Git branch rendering to degrade gracefully when the process hits `ENFILE`/`EMFILE` while reading optional Git refs\n- Changed hashline mismatch failure output to show a clean numbered context block with numbered gutter and full-anchor alignment guidance when edits are rejected after the file changed\n- Fixed `atom` mode to apply multiple edits on the same anchor line without index-shift artifacts, so mixed operations like `before`, `after`, `set`, `sub`, `ins`, and `del` now resolve consistently\n- Fixed `atom` mode `append_file` insertion to preserve a file\u2019s trailing newline sentinel when appending content\n- Fixed `read` output for raw archive entries so hashline anchors, line numbers, and chunked formatting are not injected into raw content\n- Fixed hashline parsing so lines like `# Note:` or `# TODO:` are no longer misinterpreted and stripped as hashline prefixes\n- Adjusted patch and replace validation to report a clear missing-path error when neither an entry path nor a top-level path is provided\n\n## [14.3.0] - 2026-04-25\n\n### Added\n\n- Added Markdown pipe-table `row_N` chunk selectors for row-level table edits.\n- Added `resolveToolAlias` export so tool names in CLI and session setup are normalized to canonical names, including mapping legacy `read` references to `open`\n- Added new `open` and `open-chunk` tool prompt documentation pages to describe canonical `open` usage for local files/directories, chunk reads, and URLs\n- Added full-output retrieval metadata to minimized shell command output by appending an `artifact://` footer with byte counts, allowing users to open the original unminimized command output\n- Added streaming preview API exports from the package (`resolveEditMode`, `EDIT_MODE_STRATEGIES`, and chunk preview helpers) so editors can reuse mode-aware edit preview logic programmatically\n- Added `shellMinimizer` configuration options (`enabled`, `settingsPath`, `only`, `except`, and `maxCaptureBytes`) so users can control shell output minimization behavior\n\n### Changed\n\n- Changed the canonical file/URL reader tool from `read` to `open` across default tool lists and routing, including system prompts, plan mode, cursor handlers, and runtime tool registration\n- Changed runtime and UI handling to render and track `open` tool calls as first-class (with `read` accepted as legacy alias), including ACP mapping, session observers, and streaming message groups\n- Changed chunk edit guidance to document parser-specific region behavior, including TypeScript decorator/JSDoc sibling chunks, Python docstrings as body content, Python opaque nested chunks, Markdown whole-chunk fallbacks, ID volatility, and indentation display differences\n- Changed chunk deletion in chunk edit mode to require explicit `delete: true`; `write: null` and bare `{ path }` entries now fail with guidance instead of deleting content.\n- Changed chunk edit validation to reject entries with multiple operation fields instead of choosing one and ignoring the rest.\n- Changed chunk edit validation to reject `write: \"\"` as an accidental destructive empty replacement; use the open tool for inspection or `delete: true` for deletion.\n- Changed chunk edit responses to warn when appending or prepending to a container without `~`, since that inserts outside the container rather than inside its body.\n- Changed fetch output logging so URL-fetch artifacts now use `.open.log` naming instead of `.read.log`\n- Changed Bash interception guidance and errors to recommend `open` in place of `read` for cat/head/tail-style commands\n- Changed exported SDK tool surface to expose `OpenTool` as canonical and keep `ReadTool` as a compatibility alias\n- Changed session list loading to use parallel workers and fixed-size prefix reads per session file, reducing latency when loading many or large sessions\n- Changed edit call rendering to use mode-aware streaming diff previews, including multi-file chunk edit previews grouped by file path while arguments are still streaming\n- Changed shell execution in both interactive and non-interactive modes to route command output through the configured shell output minimizer\n- Changed default behavior so shell output minimization can now be toggled from settings without code changes\n- Changed shell output minimization to leave compound and piped commands unchanged; only a single eligible whole command is captured and minimized after it exits\n\n### Removed\n\n- Removed the chunk edit `read: true` operation; use the open tool to inspect chunks without modifying files.\n- Removed the `replace: { old, new }` chunk edit operation. Use `write` or `insert` for chunk edits instead.\n\n### Fixed\n\n- Fixed startup crashes on Linux systems where Bun's `os.cpus()` fails on non-contiguous CPU numbering ([#779](https://github.com/can1357/oh-my-pi/issues/779))\n- Fixed `gh_pr_push` so branches without `gh_pr_checkout` metadata fail instead of falling back to the tracked merge branch, and updated the GitHub tool setting copy to stop calling the tool group read-only ([#778](https://github.com/can1357/oh-my-pi/issues/778))\n- Fixed session list metadata extraction to better populate session titles and first-user summaries from partial session data when full JSONL parsing is unavailable\n- Fixed shell execution output to replace raw streamed bash output with the minimizer\u2019s rewritten text before final output while still preserving the full original output as artifact metadata\n- Fixed bash command minimization to save the full unminimized output as a `bash-original` artifact during AgentSession shell execution, enabling `artifact://` access to complete command output\n- Fixed streaming chunk previews that could display an incomplete trailing edit as a deletion when partial JSON temporarily converted in-flight values to `null`\n- Fixed edit streaming preview updates to cancel obsolete in-flight computations and avoid rendering stale previews as args change\n- Fixed chunk edits to reject unsafe `^`/`~` writes on code leaf chunks instead of falling back to whole-chunk replacement and risking structural indentation corruption\n- Fixed chunk `replace` operations to dedent multiline replacement snippets before reapplying the matched source indentation, preventing Python nested replacements from compounding indentation on repeated edits.\n- Fixed Go chunk trees to classify `package` clauses separately from imports and to avoid duplicating method receivers in method summaries.\n- Fixed chunk path-not-found guidance so it recommends `sel=\"?\"` without claiming the already-shown listing must be re-read.\n- Fixed Markdown chunk appends to preserve blank-line separators after line-oriented inserts such as table rows\n- Fixed Markdown section region-fallback warnings to call out child chunks that will be replaced by whole-section edits.\n- Fixed rejected chunk-edit errors to distinguish current file content from hypothetical post-edit parse-error previews and to state when a same-file batch was rolled back.\n- Fixed unsafe Python head-region edits by rejecting decorated Python `^` writes and Python `^` deletes that can orphan indented bodies while still parsing.\n- Fixed Markdown table-row appends so row-shaped content lands inside the table block instead of after the trailing blank-line separator.\n- Fixed Markdown root writes to preserve fenced-code indentation verbatim.\n- Fixed Rust enum-variant replacement matching so trailing commas are included consistently with whole-variant writes.\n- Fixed streaming edit call headers to keep showing the target file path while the edit arguments are still arriving\n- Fixed Mermaid fenced markdown rendering in assistant messages on terminals without image protocol support ([#650](https://github.com/can1357/oh-my-pi/issues/650))\n- Fixed chunk edit path parsing so plan-mode edits to section-addressed `local://PLAN.md:` paths are classified as writes to the plan file\n- Fixed SQLite `read` helper queries to reject `where=` clauses with SQL control syntax that could override the structured selector's pagination; raw SQL remains available through `q=SELECT ...`\n\n## [14.2.0] - 2026-04-23\n\n### Added\n\n- Added an `apply_patch` edit mode that accepts Codex `*** Begin Patch` envelopes, shares patch-mode execution and diagnostics, and renders streaming per-file diffs in the TUI.\n\n### Changed\n\n- Changed Spark models to default to `apply_patch` edit mode instead of `replace`.\n- Tightened the contract for `SearchParams.recency` in `web/search/providers/base.ts`: providers MUST interpret recency as a pure time filter and MUST NOT use it as an implicit signal to change topic scope, content domain, or ranking strategy.\n- Inline read tool previews are now optional via `read.toolResultPreview` and default to off\n\n### Fixed\n\n- Fixed `apply_patch` streaming previews to avoid showing the missing `*** End Patch` parse error while the patch body is still arriving.\n- Fixed diagnostics rendering to replace tabs before TUI output, preventing compiler messages from breaking tree alignment.\n- Fixed compiled `omp` binaries to ignore project-local `bunfig.toml` and `.env` autoloading at startup, preventing unrelated project config from crashing or preloading code into the CLI\n- Fixed edit tool diff and replace operations to report missing-file failures as `File not found: ` errors instead of raw filesystem ENOENT errors\n- Fixed `local://` URL path leak on Linux where `//` collapsing to `/` produced `local:/path` forms that bypassed the internal protocol handler and leaked as filesystem paths, breaking plan mode file resolution\n- Fixed Darwin compiled binaries failing to start under Bun 1.3.12 by ad-hoc signing local and release binary builds after applying Bun's no-codesign workaround ([#754](https://github.com/can1357/oh-my-pi/issues/754))\n- Fixed Tavily web search silently returning off-topic news articles when `--recency` was set. The provider was unconditionally coupling `topic: \"news\"` to recency, which scoped Tavily's index to news publications and excluded documentation, release notes, GitHub, and all non-news technical content. Technical queries with `--recency` now return the correct corpus.\n- Fixed status-line sanitization to strip OSC, DCS, PM, APC, and 8-bit CSI escape sequences instead of leaving payload fragments in the UI\n- Fixed inline read tool previews to avoid rendering duplicate summary rows above the same code cell\n\n## [14.1.3] - 2026-04-17\n\n### Breaking Changes\n\n- Replaced the legacy `todo_write` `ops`-based API (`replace`, `update`, `add_task`, and `remove_task`) with direct top-level fields, requiring migration of any callers using the old request shape\n- Removed in-place updates to existing task `content`, `details`, and `notes` via `todo_write`; note changes now append through `add_notes`\n- Phased task definitions in `todo_write` now reject `notes` on initial creation, so notes must be added later with `add_notes`\n\n### Added\n\n- Added `complete`, `start`, `abandon`, `remove`, `add_notes`, and `add_tasks` parameters to `todo_write` so callers can complete, jump to, drop, and annotate tasks without op wrappers\n- Added direct `add_phase` support as a top-level argument for inserting a new phase in `todo_write`\n- Added `task.simple` with `default`, `schema-free`, and `independent` modes so the task tool can disable task-call `schema` and shared `context` inputs while preserving agent-defined and inherited subagent schemas\n\n### Changed\n\n- Changed `add_tasks` to insert tasks by phase name or ID and allow multiple tasks to be added in one call\n\n### Fixed\n\n- Fixed task calls in `schema-free` and `independent` modes to return clear mode-specific errors when disallowed `context` or `schema` inputs are provided\n- Fixed newly generated session IDs to use UUIDv7 for new, forked, and branched sessions while preserving resumed session IDs\n\n## [14.1.1] - 2026-04-14\n\n### Breaking Changes\n\n- Removed the standalone `vim` tool from built-in tool lists, so vim-style editing is now invoked through `edit` in `vim` mode\n- Removed the `searchDb` field from session and extension tool contexts, so custom tools and extensions no longer receive a shared native search DB handle from `ToolSession`, `CustomToolContext`, `ExtensionContext`, and `CreateAgentSessionOptions`\n- Changed the `vim` tool API to require either `open: \"path\"` or `kbd: [...]` per call and removed direct `line`/`col` cursor parameters from `open`, so callers must position the cursor via key sequences after opening\n- Changed the `edit` schemas for patch, replace, hashline, and chunk modes from top-level request fields to `edits` array entries, requiring path/mode details on each edit and breaking callers that send legacy top-level `path`, `old_text`, `new_text`, `op`, `move`, or `delete` payloads\n\n### Added\n\n- Added Vim ex aliases `:del`, `:ya`, `:co`, and `:mo` as shorthand for existing delete, yank, copy, and move commands\n- Added support for additional Vim ex command aliases `:write`/`write!`, `:edit`/`edit!`, and `:update`/`:up` in command parsing\n- Added support for vim `:global` and `:vglobal`/`/` variants as `:g/pattern/d` and `:v/pattern/d` parsing and execution\n- Added support for extra Vim operations by treating `x`, `X`, `s`, `S`, `C`, and `D` as delete/change operator aliases\n- Added support for new Vim motions `gE`/`ge`, `g_`, `g*`, `g#`, and `|`\n- Added support for `C-f` and `C-b` page motions in vim mode\n- Added `C-u` and `C-o` in vim insert mode to clear to line start and execute a one-off normal-mode command before returning to insert\n- Added insert-mode visual operators `J`, `u`, `U`, `p`, and `P` to join lines, convert case, and replace the selected region with register content\n- Added normal-mode line motions `+`, `-`, and `_` to move to line offsets at the first non-blank character\n- Added `*` and `#` normal-mode commands to search forward or backward for the word under the cursor\n- Added `gJ` to join a line range, `gv` to restore the last visual selection, and `ZZ`/`ZQ` shortcuts for save-and-exit or exit-without-save in vim mode\n- Added paragraph text object `p` for `ip`/`ap`-style paragraph selection\n- Added support for Vim ex line-address forms like `.`, `$`, `+N`/`-N`, destination addresses such as `:t$`, and ranged `:global` commands\n- Added Vim ex `:join`/`:j` and `:join!`/`:j!` support to join addressed lines with or without whitespace normalization\n- Added a warning when chunk edits write to the `~` selector with body lines that appear over-indented, instructing users to start top-level body text at column 0\n- Added validation feedback for suspect indentation in chunk-mode `~` body writes so users can align content with the tool's automatic base indentation\n- Added support for multi-file `edit` calls across replace, patch, hashline, and chunk modes by grouping `edits` entries by file path and returning combined per-file results\n- Added per-edit `path` support in chunk entries so each operation can target explicit files when submitting mixed edits in a single request\n- Added support for `computeHashlineDiff` to accept hashline edits with `loc` and `content` payloads without requiring pre-resolved `op` fields\n- Added `/rename ` slash command to set an explicit session name, updating the session header and terminal tab title ([#658](https://github.com/can1357/oh-my-pi/issues/658))\n- Added `session_name` status line segment: displays the session name in the status bar right side with a stable hash-derived accent color unique to each name; shown in all presets when a name is set\n\n### Changed\n\n- Changed vim path normalization to accept colon-prefixed `path` values instead of rejecting them as Vim commands\n- Changed default `providers.openaiWebsockets` setting to `off` when unset, so OpenAI websocket transport is now disabled unless explicitly enabled\n- Changed Vim ex `:update`/`:up` execution to skip writing unchanged buffers and report buffer unchanged status\n- Changed Vim page-scroll commands `C-f`, `C-b`, `C-u`, and `C-d` to move in viewport-height based increments instead of fixed constants\n- Changed `z` command behavior so `zt`, `zb`, and `z.` now align cursor movement to first non-blank in the line\n- Changed `:g`/`:v` global command handling to process matching lines safely by working in reverse order and preserving file structure\n- Changed vim tab breadcrumb rendering from ` \u2192 ` to `\u2192` in the editor view\n- Changed custom tool and task execution contexts to no longer expose a shared `searchDb` accessor, removing direct access to native grep/glob/fuzzyFind search backends from extension callbacks\n- Changed the `task` tool `schema` field to require JSON-encoded JTD schema text instead of a schema object, matching prompt guidance and task-subagent invocation\n- Changed chunk edit payloads to encode selectors as `path: \"file:selector\"` and updated chunk tool guidance and examples to match\n- Updated `edit` call/result rendering to show per-file diff sections and append a `(+N more)` hint when edits target multiple files\n- Grouped chunk-mode `grep` results by directory, file, and chunk so directory searches now render as hierarchical sections (`#`/`##`) with per-chunk anchor lines\n- Updated chunk-mode `grep` output to include match lines under their containing chunk entries with consistent line-number alignment based on file length\n- Changed eager todo enforcement to only apply on the first user message of a conversation, skipping subsequent user turns that may correct, clarify, or redirect the prior task\n\n### Removed\n\n- Removed live in-progress Vim tool previews during streaming call execution, so the TUI now shows only the last completed file viewport until the call finishes\n\n### Fixed\n\n- Fixed vim-mode multi-step line edits by auto-reordering ascending line-positioned commands to descending order before execution\n- Fixed Vim viewport rendering to display the inline highlighted cursor character and keep long cursor lines centered around the cursor in tool previews\n- Fixed Vim `:global` command defaults to handle only supported subcommands and report unsupported ones explicitly\n- Fixed Vim ex execution so parsed `:update`, `:yank`, and `:put` commands now run instead of falling through\n- Fixed vim tool rendering so streamed calls preview the live target viewport and large insert payloads update incrementally instead of popping in all at once\n- Fixed session event delivery so streaming `message_update`/tool-call previews reach the TUI immediately instead of waiting for extension handlers to finish\n- Fixed HTML session export rendering so background-job wait calls render as `poll` instead of stale `await`, while still recognizing legacy exported sessions\n- Fixed OpenRouter model resolution to accept dated routed selectors such as `openrouter/z-ai/glm-4.7-20251222:nitro`, inheriting metadata from the base catalog model when the exact variant is not listed yet\n- Fixed pre-execution edit preview routing so replace/patch/hashline mode diffs are computed from the new structured edit entries\n- Adjusted chunk/hashline/prompt guidance and validation to align with the refactored per-entry schema\n- Fixed chunk streaming output detection to verify chunk edits with `chunkToolEditSchema`, preventing non-chunk edit payloads from being rendered as chunk diffs\n- Fixed tool execution output to return the original `toolResult` text content from tools instead of sanitizing it before sending completion messages\n- Fixed session accent rendering in the status line and editor to reset only foreground color (`\\x1b[39m`) so applying a session color no longer clears other ANSI styles\n- Session name sanitization: strip C0/C1 control characters (including ANSI ESC) from session names at storage time and in status line rendering, preventing escape sequence injection into TUI output\n- Auto-generated session titles no longer overwrite a name set via `/rename`: `setSessionName` now tracks whether the name was set by the user or auto-generated and silently ignores auto titles once a user name is in place; terminal title follows the same guard\n- Session accent border color now applied on session resume and after auto-title generation, not only after an explicit `/rename`\n- Fixed retained Python kernel ownership so `AgentSession.dispose()` only shuts down kernels owned by that session, including warmup-created kernels\n\n## [14.1.0] - 2026-04-11\n\n### Added\n\n- Added richer tool rendering details in session export HTML, including metadata badges, argument formatting, and todo task tree styling for exported tool and workflow messages\n- Added a persistent `js` tool backed by `node:vm`, with cross-session `highway` KV/pubsub, tool calls from inside JS cells, and `$` / `$$` interactive JavaScript execution\n- Added SQLite database read support to the `read` tool for `.sqlite`, `.sqlite3`, `.db`, and `.db3` files with table listing, schema + sample output, row lookup, paginated query filtering, and read-only `q=SELECT` mode\n- Added SQLite mutation support to the `write` tool so `db.sqlite:table` inserts JSON5 rows and `db.sqlite:table:key` updates or deletes rows via row key\n- Added rendering of usage report entries for accounts with no usage limits, including account label and optional plan type with a `-- no limits` indicator\n- Updated account label resolution to fall back to email or accountId so unlabeled unlimited-plan accounts display a meaningful name\n- Added canonical model equivalence and provider coalescing across `models.yml`, `enabledModels`, `--models`, `/model`, and `--list-models`\n- Added `equivalence` overrides/exclusions to `models.yml` and `modelProviderOrder` to `config.yml` for global canonical-provider preference\n\n### Changed\n\n- Enabled `await` and `cancel_job` to be available when `bash.autoBackground.enabled` is set, so auto-backgrounded bash jobs can be awaited or cancelled without enabling `async.enabled`\n- Updated bash auto-background behavior so short commands returned inline output when they completed before the configured threshold, while longer runs moved to background jobs automatically\n- Replaced the LLM-callable Python execution path with JavaScript execution in the shared VM context, including updated renderers, prompts, session messages, and extension events\n- Updated interactive and CLI model listings/selectors to work with canonical model ids while resolving them to concrete provider variants for actual execution\n- Updated role assignment persistence so selected model settings now store the selector used by users, including thinking-level suffixes, while runtime continues to run against the resolved concrete provider model\n- Updated model scope resolution to expand exact canonical model ids into all matching provider variants when filtering supported model sets\n- Changed the agent to avoid giving time estimates or task-duration predictions in user responses, focusing on required work instead\n- Changed generated code guidance to avoid speculative abstractions and extra compatibility scaffolding, favoring direct implementations that match current needs\n- Changed model role resolution so roles can store either canonical model ids or explicit `provider/model` selectors while sessions continue to record the concrete model actually used\n- Updated bash execution to optionally auto-background long-running commands through the existing background-job pipeline, with dedicated settings for enabling the behavior and adjusting the delay\n\n### Fixed\n\n- Fixed session export rendering so JavaScript execution messages now use `jsExecution` labels and content instead of `pythonExecution`, matching current tool behavior\n- Fixed JavaScript cell execution to auto-display returned values once and preserve persistent VM bindings across calls until reset\n- Fixed `.db`/`.db3` reads to verify SQLite file headers and fall back to normal file reading when the extension matches but the content is not a SQLite database\n- Fixed SQLite selector parsing and resolution to correctly route requests to database operations at the file-extension boundary instead of misrouting through plain file/archive handlers\n- Fixed unsupported or unsafe selectors by rejecting missing tables, composite primary keys for row lookups, unknown query parameters, and row operations on non-existent tables\n- Fixed model resolution for commit message generation, title generation, memory consolidation, and image inspection when role strings use canonical ids instead of raw provider/model values\n- Fixed default-model updates so previously configured thinking levels were preserved when reassigning a role\n- Fixed model scope and selection handling in CLI/session startup paths that previously failed to resolve aliases consistently across features\n- Fixed short-lived git subprocesses to disable `core.fsmonitor` and `core.untrackedCache`, avoiding unnecessary repository watchers and cache work during agent git operations\n\n### Security\n\n- Blocked destructive SQL execution in read-mode SQLite access by using read-only connections and rejecting bound-parameter raw SQL\n\n## [14.0.5] - 2026-04-11\n\n### Added\n\n- Added `designer` model role for UI/UX design tasks with Gemini 3.1 Pro as default model\n- Added support for model role fallback lists \u2014 roles can now resolve to multiple model patterns with automatic fallback to next available model\n- Added `extractReadableFromHtml` utility function to extract readable content from HTML with Readability article extraction and CSS selector fallback\n- Added support for GFM (GitHub Flavored Markdown) features including tables, strikethrough, and task lists in HTML-to-markdown conversion\n- Added `resolveDiagnosticTargets` utility function to handle glob pattern resolution with fallback to literal file paths for bracket-style paths\n\n### Changed\n\n- Clarified fenced code block editing behavior in markdown \u2014 the tool now preserves literal indentation inside fenced blocks, with content written verbatim as supplied\n- Updated guidance for inserting content after markdown section headings to use `after` on the heading chunk rather than `before`/`prepend` on the section itself\n- Reduced default image resize limits to 1568px (from 2000px) and 500KB (from 4.5MB) to match Anthropic's internal downscaling threshold and reduce payload sizes in tool calls\n- Adjusted screenshot compression to use 1024px max dimensions and 150KB budget for more aggressive optimization of browser screenshots in LLM requests\n- Updated JPEG quality defaults from 80 to 75 and refined quality ladder steps (70, 60, 50, 40) for tighter byte budgets\n- Improved image resize fast-path to skip re-encoding when images are already within dimensions and at \u226425% of byte budget, avoiding unnecessary processing of small icons and diagrams\n- Clarified that chunk names are truncated and must be copied from `read` or `?` output rather than constructed from source identifiers\n- Enhanced guidance for editing fenced code blocks in markdown to preserve exact whitespace using `raw` reads, as the tool normalizes tabs to spaces which can damage indentation-sensitive content\n- Updated designer agent to use `pi/designer` role alias instead of explicit model list\n- Refactored model role resolution to support multiple fallback patterns per role, improving model availability handling\n- Replaced regex-based HTML-to-markdown conversion with Turndown library and GFM plugin for more accurate formatting of complex HTML structures\n- Simplified no-changes response to omit redundant response text when chunk content already matches\n- Clarified region suffix behavior on leaf and compound statement chunks \u2014 `~` and `^` now fall back to whole-chunk replacement with explicit guidance to supply complete structural content\n- Updated CRC refresh guidance to direct users to use CRCs from edit responses or run `read(path=\"file\", sel=\"?\")`\n- Added clarification that region suffixes fall back to whole-chunk replacement for prose and data formats (markdown, YAML, JSON, fenced code blocks, frontmatter)\n- Documented `L20` shorthand syntax for single-line reads extending to end-of-file, with `L20-L20` for one-line windows\n- Refactored diagnostic target resolution to use new `resolveDiagnosticTargets` function, consolidating glob pattern detection and file matching logic\n- Updated chunk selector syntax from `@region` format to `~` (body) and `^` (head) suffixes for more concise region targeting\n- Simplified chunk edit documentation to use new `~` and `^` region syntax instead of `@head`, `@body`, `@tail`, `@decl` keywords\n- Replaced internal `raceAbort` function with imported `raceWithAbort` utility from pi-utils\n- Refactored cleanup timer to use async iterator pattern with `timers.setInterval` instead of `setInterval`\n- Made `#cleanupIdleSessions` synchronous and moved async cleanup loop logic to new `#runCleanupLoop` method\n- Replaced regex-based `htmlToBasicMarkdown` with a Turndown + GFM plugin pipeline (tables, strikethrough, task lists, nested lists now convert correctly). Added direct `turndown` and `turndown-plugin-gfm` dependencies\n\n### Fixed\n\n- Fixed chunk edit tool to report file-not-found error distinctly when attempting to use chunk selectors on non-existent files, with guidance to use write tool or verify the path\n- Fixed stale child selector reuse to correctly match chunks by checksum when multiple sibling chunks with the same name exist under the same parent\n- Fixed stale diagnostics being reused after unrelated file publishes by clearing cached diagnostics before refreshing file state\n- Fixed Codex search to use streamed answer text when final answer is an image placeholder or empty\n\n## [14.0.4] - 2026-04-10\n\n### Added\n\n- Added `PI_CHUNK_AUTOINDENT` environment variable to control whether chunk read/edit tools normalize indentation to canonical tabs or preserve literal file whitespace\n- Added dynamic chunk tool prompts that automatically adjust guidance based on `PI_CHUNK_AUTOINDENT` setting without exposing a tool parameter\n- Added ``, ``, ``, ``, and `` sections to system prompt for improved long-horizon agent workflows\n\n### Changed\n\n- Updated chunk edit tool to apply `normalizeIndent` setting during edit operations, enabling literal whitespace preservation when `PI_CHUNK_AUTOINDENT=0`\n- Refactored environment variable parsing to use `$flag()` and `$envpos()` utilities from pi-utils for consistent boolean and integer handling across codebase\n- Updated system prompt communication guidelines to emphasize conciseness and information density, and added guidance on avoiding repetition of user requests\n- Enhanced system prompt with explicit rules for design integrity, verification before yielding, and handling of missing context via tool-based retrieval\n- Added `PI_CHUNK_AUTOINDENT` to control whether chunk read/edit tools normalize indentation, and updated chunk prompts to switch guidance automatically based on that setting\n- Refined the default system prompt with explicit instruction-priority, output-contract, tool-persistence, completeness, and verification rules for long-horizon GPT-5.4-style agent workflows\n\n### Fixed\n\n- Fixed typo in system prompt: 'backwards compatibiltity' \u2192 'backwards compatibility'\n\n## [14.0.3] - 2026-04-09\n\n### Fixed\n\n- Fixed cached Ollama discovery rows so upgraded installs switch to the OpenAI Responses transport instead of staying on the old completions transport\n\n## [14.0.2] - 2026-04-09\n\n### Added\n\n- Added `/force` slash command to force the next agent turn to use a specific tool\n- Added `ToolChoiceQueue` for managing tool-choice directives with lifecycle callbacks and requeue semantics\n- Added `setForcedToolChoice()` method to AgentSession to programmatically force tool invocations\n- Added `toolChoiceQueue` property to AgentSession for direct queue access\n- Added `peekQueueInvoker()` method to AgentSession to retrieve in-flight tool invocation handlers\n- Added `queueResolveHandler()` function as the canonical entry point for preview/apply workflows\n- Added `buildToolChoice()` and `steer()` methods to ToolSession for tool-choice queue integration\n- Added `getToolChoiceQueue()` method to ToolSession for accessing the tool-choice queue\n- Added support for embedded URL selectors (`:raw` and `:L#-L#` line ranges) in read command paths\n- Added `parseReadUrlTarget` function to parse and validate URL read targets with line range support\n- Added `decl` region to chunk selector for targeting declarations without leading trivia\n- Exported `hooks` subpath for extensibility API access\n- Added `build` script for compiling binary artifacts\n\n### Changed\n\n- Refactored pending action handling from `PendingActionStore` to `ToolChoiceQueue` with generator-based directives\n- Changed tool-choice override mechanism from simple override to a queue-based system with callbacks\n- Updated `ResolveTool` to dispatch to in-flight queue invokers instead of popping from a pending action store\n- Updated custom tool loader to accept `pushPendingAction` callback instead of `PendingActionStore` instance\n- Updated `AstEditTool` to use `queueResolveHandler()` for preview/apply semantics\n- Changed eager-todo prelude to use the tool-choice queue instead of simple override\n- Updated todo reminder suppression to check for user-forced directives via `consumeLastServedLabel()`\n- Made model-specific edit mode defaults conditional on `PI_STRICT_EDIT_MODE` environment variable for greater flexibility in edit mode selection\n- Updated slash command handlers to support returning remaining text as prompt input instead of consuming input entirely\n- Enhanced slash command parser to recognize both whitespace and colon (`:`) as command argument separators\n- Updated indentation guidance for chunk edit content to use single leading spaces per indent level instead of tabs\n- Updated read CLI to delegate URL inputs through the read tool pipeline instead of treating them as local file paths\n- Updated chunk edit documentation to clarify region semantics and emphasize using the narrowest region for edits\n- Improved chunk selector guidance with visual diagram showing region boundaries\n- Renamed `build:binary` script to `build`\n- Refactored `check` script to include linting via Biome and type checking\n- Added `check:types`, `lint`, `fmt`, and `fix` scripts for improved developer workflow\n- Simplified TypeScript configuration by extending workspace-level config\n\n### Removed\n\n- Removed `PendingActionStore` class and related pending-action module\n- Removed `pendingActionStore` parameter from AgentSession config\n- Removed `pendingActionStore` from ToolSession interface\n- Removed `consumeNextToolChoiceOverride()` method from AgentSession (replaced by `nextToolChoice()`)\n\n### Fixed\n\n- Fixed tool-choice queue cleanup on agent loop abort to prevent orphaned in-flight directives\n- Fixed requeue semantics to preserve `onInvoked` and `onRejected` callbacks across multiple abort cycles\n\n## [14.0.1] - 2026-04-08\n\n### Changed\n\n- Improved auto-generated file detection to gracefully handle ENOENT errors when peeking file content, preventing unnecessary abort failures\n- Optimized context emission by skipping message cloning when no extensions have context handlers\n- Improved message cloning resilience by falling back to shallow array clone when structured cloning fails due to non-cloneable objects\n- Made `assertEditableFileContent` synchronous instead of async for improved performance in streaming edit checks\n- Enhanced streaming edit abort detection to check for auto-generated files as soon as the file path is available, rather than waiting for the full diff\n- Improved file prefix reading in session storage to use `peekFile` utility from @oh-my-pi/pi-utils for better efficiency\n- Moved image metadata detection to @oh-my-pi/pi-utils package for shared use across projects\n- Simplified image loading API by removing redundant metadata parameters and consolidating image utilities\n- Updated imports to use readImageMetadata and parseImageMetadata from @oh-my-pi/pi-utils instead of local implementations\n\n### Removed\n\n- Removed image-input.ts utility module; functionality consolidated into image-loading.ts\n- Removed mime.ts utility module; MIME detection moved to @oh-my-pi/pi-utils\n- Removed ImageMetadata interface and ReadImageMetadataOptions from local codebase\n\n### Fixed\n\n- Fixed streaming edit abort for auto-generated files by adding LRU caching and early path-based detection to prevent unnecessary edits\n\n## [14.0.0] - 2026-04-08\n\n### Breaking Changes\n\n- Simplified chunk edit operations: removed `append_child`, `prepend_child`, `append_sibling`, `prepend_sibling`, and `replace_body` ops in favor of unified `replace`, `before`, `after`, `prepend`, and `append` with region targeting (`@head`, `@body`, `@tail`)\n- Chunk edit `target` format changed: now accepts `selector#CRC@region` for mutations and `selector@region` for insertions; removed separate `crc` and `anchor` fields from edit operations\n- Removed checksum requirement from insert operations (`before`, `after`, `prepend`, `append`); only `replace` requires `#CRC` suffix\n\n### Added\n\n- Auto QA tool (`report_tool_issue`) for automated tracking of unexpected tool behavior; enabled via `PI_AUTO_QA=1` environment variable or `dev.autoqa` setting\n- `dev.autoqa` setting to enable automated tool issue reporting for all agents\n- System prompt guidance when `report_tool_issue` tool is available, encouraging agents to report tool behavior discrepancies\n- LSP server discovery at startup via `discoverStartupLspServers()` to detect configured language servers without blocking initialization\n- LSP startup event channel (`lsp:startup`) for asynchronous server warmup notifications with completion or failure status\n- `LspStartupServerInfo` type for tracking LSP server status including connecting, ready, and error states\n- LSP server status display in `/info` command showing connecting, ready, and error states with color-coded indicators\n- Multi-session support in ACP mode: agents can now manage multiple concurrent sessions with independent state, models, and configurations\n- Session forking in ACP mode: `unstable_forkSession` creates a new session from an existing one's history\n- Session resumption in ACP mode: `unstable_resumeSession` reloads a previously saved session\n- Session closure in ACP mode: `unstable_closeSession` cleanly shuts down a session and releases resources\n- Model state reporting in ACP mode: `SessionModelState` with available models and current selection in session responses\n- Direct model setting in ACP mode: `unstable_setSessionModel` RPC command for changing the active model\n- Turn-level usage tracking in ACP mode: prompt responses now include `usage` with input/output/cached token counts\n- Message ID tracking in ACP mode: stable message IDs for assistant chunks enabling client-side message correlation\n- Settings cloning: `Settings.cloneForCwd()` method to create isolated settings instances for different working directories\n- Extension flag value retrieval: `ExtensionRunner.getFlagValues()` to inspect current flag state\n- Exported autoresearch module and submodules via `./autoresearch` and `./autoresearch/*` package paths\n- Exported autoresearch tools via `./autoresearch/tools/*` package path\n- Exported CLI commands via `./cli/commands/*` package path\n- Exported DAP module and submodules via `./dap` and `./dap/*` package paths\n- Exported edit module and submodules via `./edit`, `./edit/*`, and `./edit/modes/*` package paths\n- Exported bundled ci-green custom command via `./extensibility/custom-commands/bundled/ci-green` package path\n- Exported extensibility plugins marketplace via `./extensibility/plugins/marketplace` and `./extensibility/plugins/marketplace/*` package paths\n- Exported ACP mode via `./modes/acp` and `./modes/acp/*` package paths\n- Exported web utilities via `./web/*` package path\n- Exported line-hash utilities from edit module via `./edit/line-hash`\n- Host-owned custom tools support: RPC clients can now register custom tools via `setCustomTools()` and the RPC server will invoke them over the transport with `host_tool_call` requests\n- RPC host tool framework: `RpcHostToolBridge` for managing host tool execution, `RpcHostToolDefinition` for tool metadata, and bidirectional `host_tool_call`, `host_tool_cancel`, `host_tool_update`, and `host_tool_result` frames\n- RPC client tool API: `defineRpcClientTool()` helper, `RpcClientCustomTool` interface, and `RpcClientToolContext` for implementing host-side tool execution with update streaming and abort support\n- `set_host_tools` RPC command to replace the active set of host-owned tools before the next model call\n- `refreshRpcHostTools()` method on `AgentSession` to integrate host tools into the active tool registry with conflict detection and auto-activation of non-hidden tools\n- Instruction breakpoints support: `set_instruction_breakpoint` and `remove_instruction_breakpoint` debug actions for setting breakpoints at specific instruction addresses\n- Data breakpoints support: `data_breakpoint_info`, `set_data_breakpoint`, and `remove_data_breakpoint` debug actions for monitoring variable/memory access\n- Memory introspection: `read_memory` and `write_memory` debug actions for inspecting and modifying debugger memory\n- Disassembly support: `disassemble` debug action for viewing assembly instructions with symbol resolution\n- Module and source introspection: `modules` and `loaded_sources` debug actions for querying loaded modules and source files\n- Custom DAP requests: `custom_request` debug action for sending arbitrary Debug Adapter Protocol commands\n- Reverse request handling in DAP client: `onReverseRequest()` method for responding to adapter-initiated requests like `runInTerminal` and `startDebugging`\n- DAP reverse request support: adapters can now request terminal spawning and child debug sessions via `runInTerminal` and `startDebugging` reverse requests\n- Instruction pointer reference in debug snapshots: `instructionPointerReference` field in session summaries for low-level debugging\n- Hit condition support for instruction and data breakpoints: `hit_condition` parameter for conditional breakpoint triggering\n- RPC `set_todos` command and `todoPhases` in `get_state`, allowing hosts to pre-seed and inspect session todo state over the protocol\n- Deferred diagnostics support in LSP writethrough: `onDeferredDiagnostics` callback and `deferredSignal` in `WritethroughOptions` allow callers to receive diagnostics that arrive after the main 5-second timeout\n- Language detection for `.pm` (Perl modules), `.astro` (Astro framework), and special filenames `containerfile` and `justfile`\n- Workspace-scoped diagnostics and reload actions via `*` file parameter; `diagnostics` action now supports `*` for workspace-wide diagnostics across all configured servers\n- Socket-mode DAP adapter support for debuggers like dlv that communicate via network sockets instead of stdio; Linux uses unix domain sockets, macOS/other platforms use TCP with client-addr dialing\n- Improved extensionless binary debugging: native debuggers (gdb, lldb-dap) and adapters with root markers are now preferred over unrelated adapters like debugpy\n- Debug tool with DAP (Debug Adapter Protocol) support for launching and attaching debuggers, setting breakpoints, stepping through execution, inspecting threads/stack/variables, and evaluating expressions\n- Debug adapter configuration for gdb, lldb-dap, debugpy, and dlv with language/file-type matching and root marker detection\n- Debug session management with support for source and function breakpoints, conditional breakpoints, stack trace inspection, scope/variable exploration, and program output capture\n- `debug.enabled` setting to control debug tool availability\n- Chunk read formatting: `anchorStyle` (full / kind / bare), `read.anchorstyle` setting, and `chunked` flag on file display mode\n- `read.prosechunks` and `read.explorechunks` settings for prose chunk trees and checksum-free explore trees\n- Handlebars helpers `anchor` and `sel` (with template `anchorStyle` context) for chunk examples in prompts\n- Chunk-mode grep lines as `path:selector>LINE|content`; unified grep tool template behind `IS_CHUNK_MODE`\n- `lru-cache` for chunk tree caching\n- Chunk-mode `read` output: recursive rendering with `$XXXX` checksum suffixes, inline large-chunk previews, and normalized `#path$XXXX` selectors between read and edit\n- Autoresearch: `init_experiment` options `new_segment`, `from_autoresearch_md`, `abandon_unlogged_runs`; `log_experiment` options `skip_restore` and broader `force`; `run_experiment` `force` (with warnings); pre-run dirty-path tracking; `abandonUnloggedAutoresearchRuns` and `abandonedAt` on runs\n- LSP: diagnostic versioning (`versionSupport`, stored document version per diagnostic set), and `waitForDiagnostics` / `getDiagnosticsForFile` options (`expectedDocumentVersion`, `allowUnversioned`)\n\n### Changed\n\n- Extracted working directory formatting logic into `formatToolWorkingDirectory()` utility for consistent path display across tools\n- Bash command rendering now sanitizes tabs and shortens home directory paths in command previews\n- Chunk edit tool schema: renamed `target` parameter to `sel` for consistency with read tool terminology\n- Chunk edit tool: `op` parameter is now required (previously optional with `replace` default)\n- Chunk edit documentation: updated all region references from `@inner` to `@body` for clearer semantics\n- Chunk edit documentation: expanded with comprehensive real-world examples showing full read output, operation effects, and indentation rules\n- Chunk edit documentation: simplified indentation guidance to write content at indent-level 0 with automatic re-indentation by the tool\n- Chunk edit documentation: clarified that `@region` only works on container chunks, not leaf chunks\n- Chunk edit documentation: emphasized that CRCs change after every edit and must be refreshed from latest responses\n- Read chunk tool documentation: updated selector examples to use `@body` instead of `@inner`\n- Chunk edit region terminology updated: `@inner` renamed to `@body` for clearer semantics in container chunks\n- Chunk edit documentation restructured with comprehensive examples showing full read output, operation effects, and indentation rules\n- Chunk edit indentation guidance simplified: content should be written at indent-level 0 and the tool automatically applies correct base indentation\n- Chunk edit examples expanded with realistic TypeScript code samples demonstrating replace, insert, prepend, append, and delete operations\n- Python tool description now dynamically reflects prelude documentation availability instead of static text\n- Python tool now automatically warms the environment on first execution if prelude helpers are unavailable, ensuring documentation is loaded before use\n- Tool creation now auto-injects `report_tool_issue` when auto QA is enabled, regardless of requested tool list\n- Chunk edit region names standardized to `@head`, `@body`, and `@tail` for clearer semantics\n- Chunk edit documentation clarified: region defaults to full chunk when omitted; leaf chunks no longer support region targeting\n- Chunk read documentation updated: selector examples now use region-specific selectors based on `@head`, `@body`, and `@tail`\n- LSP server connecting status in welcome banner now uses muted pending symbol instead of warning symbol for clearer visual distinction\n- Codex websocket prewarm now runs asynchronously in the background instead of blocking session creation, allowing faster startup\n- Codex websocket status updates now display in interactive mode when prewarm completes or fails\n- LSP server warmup now runs asynchronously in the background instead of blocking session creation, allowing faster startup\n- LSP servers returned from `createAgentSession()` now include `connecting` status during initial warmup phase\n- Interactive mode now subscribes to LSP startup events and displays status updates and error messages to the user\n- LSP server status in `/info` command now distinguishes between connecting (yellow), ready (green), and error (red) states\n- ACP agent now manages multiple sessions instead of a single session; session lifecycle and configuration are now per-session\n- ACP session creation now uses a factory function to support creating new sessions for different working directories\n- ACP event mapping now accepts optional `getMessageId` callback for stable message ID assignment to assistant chunks\n\n### Removed\n\n- Deleted `src/utils/prompt-format.ts` module; prompt formatting logic moved to `pi-utils`\n- Deleted `src/utils/frontmatter.ts` module; frontmatter parsing logic moved to `pi-utils`\n- Removed `waitForChildProcess` utility (child process termination now handled by native `killTree` from pi-natives)\n- `grep-chunk.md` (folded into unified grep template)\n- `startMacAppearanceObserver` export (use `MacAppearanceObserver.start()`)\n- `copyToClipboard` export from pi-natives\n- `PI_CHUNK_SPLICES` env and `chunkSplicesEnabled()`\n- Autoresearch `segmentFingerprint` and related config hashing\n\n### Fixed\n\n- Chunk edit parameter validation: corrected detection of chunk edit operations to check for `sel` field instead of `target`\n- Chunk edit streaming previews: updated to reference `sel` parameter instead of `target`\n- Python prelude introspection now respects execution timeout and signal options, preventing hangs during environment warmup\n- Welcome banner LSP server status now updates in real-time when background startup warmup completes, eliminating stale connecting status displays\n- Welcome banner LSP startup rows now re-render when background warmup finishes, use the pending status symbol while servers are still connecting, and no longer add a redundant `LSP ready` status line on successful startup\n- ACP session initialization now registers connection cleanup handlers to dispose all sessions on disconnect\n- Reorganized package.json exports: moved `./edit` exports before `./plan-mode` for better logical grouping\n- Notebook conversion logic now checks for raw read mode or non-chunk mode before converting via markit, allowing chunk-mode reads of `.ipynb` files to use chunk parsing instead of conversion\n- Go receiver methods now render as top-level siblings instead of nested under their receiver type in chunk read output\n- Moved prompt formatting and rendering utilities from `coding-agent` to `pi-utils` package; `renderPromptTemplate()` and `formatPromptContent()` now accessed via `prompt.render()` and `prompt.format()` from `@oh-my-pi/pi-utils`\n- Moved `parseFrontmatter()` utility from `coding-agent` to `pi-utils` package; now imported from `@oh-my-pi/pi-utils` instead of local utils\n- Consolidated prompt template handling: `TemplateContext` type now available as `prompt.TemplateContext` from `@oh-my-pi/pi-utils`\n- DAP initialization now advertises support for `runInTerminal` and `startDebugging` reverse requests, and memory references\n- Debug tool schema expanded with new parameters for instruction/data breakpoints, memory operations, and custom requests\n- DAP session state now tracks instruction and data breakpoints separately from source breakpoints\n- Replaced `Bun.which()` with `$which()` from pi-utils for command resolution\n- Chunk edit tool documentation restructured: replaced operation-specific examples with region-based guidance and canonical indentation rules\n- Chunk read documentation updated: selectors now support region syntax (e.g., `class_Foo.fn_bar#ABCD@body`) and canonical target listings show supported regions per chunk\n- Chunk edit schema simplified: `target` description now documents region format; `op` and `content` descriptions clarified for region-aware operations\n- Chunk edit streaming previews updated: labels now reflect region-aware operations (e.g., `append` instead of `append child`, `insert after` without anchor reference)\n- Removed CRC parsing from `parseChunkSelector()` and `parseChunkReadPath()`: selectors no longer extract embedded checksums\n- Chunk edit normalization simplified: no longer requires async checksum resolution or context-dependent operation mapping\n- RPC mode now automatically disables session title generation by default; hosts can opt in with `PI_RPC_EMIT_TITLE=1` environment variable to receive title updates\n- RPC mode now resets workflow-altering `todo.*`, `task.*`, and `async.*` settings to built-in defaults instead of inheriting user overrides\n- RPC mode now disables automatic session title generation by default and suppresses `setTitle` extension UI requests unless hosts opt in with `PI_RPC_EMIT_TITLE=1`\n- Reorganized edit tool implementation from `patch/` to `edit/` directory structure with dedicated mode subdirectories (`edit/modes/chunk.ts`, `edit/modes/hashline.ts`, `edit/modes/patch.ts`, `edit/modes/replace.ts`)\n- Updated package.json exports to use `./edit` path instead of `./patch` for edit tool and related utilities\n- Chunk edit tool documentation simplified: removed line-based edit examples, clarified `target` format with full path and CRC suffix, added guidance for `replace_body` operation to preserve declarations\n- LSP diagnostics timeout reduced from 10 seconds to 5 seconds for faster feedback; slow diagnostics now fetch in background via deferred mechanism\n- Diagnostics action error messaging clarified: requires `file` parameter or `*` for workspace scope; improved guidance in error responses\n- Workspace symbols and reload actions now accept `*` to operate across all configured servers instead of requiring a file path\n- DAP session initialization now subscribes to stop events before launching/attaching to avoid missing stopOnEntry events\n- Stack frame fetching moved outside the event dispatch loop to prevent deadlocks and improve responsiveness\n- Evaluate requests now default to the top stopped frame when frameId is not explicitly provided\n- Eager todo enforcement now skips prompts ending with question marks or exclamation marks, treating them as queries or commands rather than statements requiring task planning\n- Chunk read output now displays fully-qualified anchor paths (e.g., `[class_Worker.fn_run#CRC]`) instead of bare names, making targets unambiguous for edits\n- Chunk edit tool documentation clarified: `target` must be the fully-qualified path with `#CRC` suffix; added guidance to run `read(path=\"file\", sel=\"?\")` for canonical target listings when anchor style is unclear\n- Chunk read tool documentation updated: `sel` parameter now documents the `?` selector for canonical target listings, and clarifies that default output shows full paths\n- Chunk edit schema and tool contract: explicit `op` (`replace`, `append`, `prepend`, `after`, `before`); use `replace` with empty `content` to remove a chunk (no separate `delete` op); sibling inserts use `anchor` instead of separate after/before target fields; insert ops omit CRC where appropriate, mutations require checksum on target\n- Chunk path handling: parse selector and CRC separately, sanitize selectors (strip filename prefixes, uppercase checksums), accept embedded `#CRC` on targets, auto-accept stale CRC for later ops in the same batch on the same chunk\n- Chunk UX: streaming and final edit previews show chunk edits next to hashline edits with op-specific labels; prompt docs shortened with rules table, `\u2026` in examples, and helper-based path/anchor samples\n- `log_experiment` only reverts files modified by the run; prompts and errors document that pre-existing dirty files are preserved; richer pending-run error context; `init_experiment` no-ops when the contract matches unless `new_segment`; secondary metrics informational only (no `force` for drift)\n- Autoresearch: `log_experiment` reloads benchmark/scope/constraints from `autoresearch.md` after resolving a pending run; `/autoresearch` without `autoresearch.md` follows `/plan`-style toggle and message flow; setup moved into autoresearch system prompt (removed `command-initialize.md`)\n- Native/shell alignment: `GrepOutputMode` from pi-natives; shell and `getDiagnosticsForFile` callbacks use error-first `(err, chunk)`; `getDiagnosticsForFile` takes an options object\n- Clipboard: `copyToClipboard` / `readImageFromClipboard` live in `utils/clipboard.ts` (OSC 52 and Termux)\n- macOS: session-wide power assertion while the agent runs; `MacAppearanceObserver.start()` with error-first callback; `detectMacOSAppearance()` returns enum values\n- ACP session cleanup now properly cancels in-flight prompts and disposes resources when sessions are closed or connection aborts\n- Removed unused `_createErrorToolResult` helper function from RPC host-tools module\n- Fixed Go receiver method indentation in append operations to preserve relative indentation from the anchor chunk\n- Fixed Go type chunk line counts to report only the type body lines instead of including grouped receiver methods\n- Fixed enum variant insertion to avoid adding extra blank lines between variants\n- Chunk read output now correctly preserves embedded CRC in selectors (e.g., `class_Foo.fn_bar#ZZPM`) instead of stripping them during path parsing\n- Chunk edit error messages now consistently report checksum mismatches with format `Checksum mismatch` instead of variable phrasing\n- Chunk-mode read output now correctly displays scoped response trees showing only touched chunks and adjacent siblings, preventing unrelated distant chunks from appearing in responses\n- DAP stopped event handling no longer blocks the message reader, preventing potential deadlocks during rapid event sequences\n- Chunk-mode whole-chunk replaces now preserve attached leading comments and docblocks when replacement content starts at the declaration, preventing accidental comment loss during agent edits\n- Chunk edit error messages now consistently report checksum mismatches with the format `did not match checksum \"XXXX\"` instead of variable phrasing\n- Chunk selector validation for edits now rejects non-canonical selectors (suffix-only like `fn_run` or prefix-stripped like `run`), requiring fully-qualified paths to prevent ambiguity\n- Plan review previews now re-append at the chat tail on refresh, keeping them adjacent to the active selector instead of updating off-screen\n- `log_experiment` validates and reverts run-scoped file changes without clobbering unrelated dirty worktree state\n- Chunk edit targets that embed CRC in the selector (e.g. `fn_foo#ABCD`) parse correctly\n- Shell paths check errors before consuming chunk output (bash executor, config resolution)\n- `/autoresearch` toggles like `/plan` when empty; slash completion no longer suggests `off`/`clear` on an empty prefix after the command\n- Chunk-mode read/edit edge cases (zero-width gap replaces, stale batch diagnostics, grouped Go receivers, line-count headers, parse error locations)\n\n## [13.19.0] - 2026-04-05\n\n### Added\n\n- Added idle auto-compaction settings and scheduling so sessions can compact after inactive turns without auto-continuing.\n- Added `onExternalEditor` callback to extension UI dialog options for handling external editor shortcut in select dialogs\n- Added external editor shortcut support in plan review selector, allowing users to open and edit the plan in their configured editor\n- Added `matchesAppExternalEditor` keybinding matcher to detect external editor shortcut (Ctrl+G or configured binding)\n- Added `trimTrailingNewline` option to `openInEditor` function to preserve trailing newlines when editing files\n- Added GitHub CLI utilities to git module (`utils/git.github`) with `available()`, `run()`, `json()`, and `text()` methods for GitHub CLI operations\n- Exported git utilities from main package entry point for use by extensions\n- Added comprehensive git utility module (`utils/git`) with organized namespaces for common git operations (branch, commit, diff, log, patch, ref, stage, status, head, repository)\n\n### Changed\n\n- Changed idle compaction settings (`compaction.idleThresholdTokens` and `compaction.idleTimeoutSeconds`) from enum to numeric type for flexible configuration\n- Modified secret obfuscation to deobfuscate restored session messages for local display while keeping outbound LLM messages obfuscated\n- Updated stash pop operation to preserve staged changes with `--index` flag when restoring after task branch merges\n- Changed secret placeholders to deterministic hash-style redaction tokens and deobfuscated assistant output for local display.\n- Updated hook editor and hook selector components to use `matchesAppExternalEditor` matcher for consistent external editor keybinding detection\n- Modified plan review flow to read the latest plan content from disk before approval, allowing changes made in external editor to be reflected\n- Enhanced plan review help text to dynamically display the configured external editor keybinding\n- Refactored git operations to use centralized utility module instead of `ControlledGit` class throughout codebase\n- Replaced `ControlledGit` dependency injection pattern with direct `cwd` parameter in commit agent tools\n- Migrated git HEAD resolution in footer and status-line components to use new synchronous and asynchronous utilities\n- Updated git status summary calculation in status-line component to use new git utility API\n- Simplified git branch operations in task execution and cleanup to use new utility functions\n- Refactored patch application logic in task worktree to use new git patch utilities\n\n### Removed\n\n- Removed `gh-cli.ts` module; GitHub CLI functionality now available via `utils/git.github`\n- Removed `ControlledGit` class and associated git wrapper infrastructure from `commit/git` module\n- Removed `mergeStdoutStderr` helper function from autoresearch git utilities\n- Removed `findGitHeadPathAsync` and `findGitHeadPathSync` from modes/shared module (replaced by git utilities)\n- Removed `./commit/git` export from package.json (internal diff parsing still available via `./commit/git/*`)\n\n### Fixed\n\n- Fixed idle compaction timer to properly cancel when event controller is disposed, preventing memory leaks\n- Fixed session resumption to preserve the last non-empty session when starting a fresh session\n- Fixed stash detection to use git ref resolution instead of output parsing for reliable stash state tracking\n- Fixed isolated task merge-back to preserve task outputs on merge failure and stash dirty worktrees before cherry-pick.\n- Fixed web search source rendering to truncate long title, metadata, and URL lines before they overflow the UI.\n- Fixed PR checkout tool to resolve symlinks in worktree paths, ensuring consistent path references in results and metadata\n- Fixed `read` output for file-backed internal URLs like `local://...` to include hashline prefixes in hashline edit mode, preserving usable line refs for follow-up edits\n- Fixed the plan review selector to support the external editor shortcut for opening and updating the current plan from the approval screen\n\n## [13.18.0] - 2026-04-02\n\n### Breaking Changes\n\n- Removed standalone `fetch` tool; URL fetching is now integrated into the `read` tool\n\n### Added\n\n- Added URL reading capability to `read` tool with support for web pages, GitHub issues, Stack Overflow, Wikipedia, Reddit, NPM, arXiv, technical blogs, RSS/Atom feeds, and JSON endpoints\n- Added `offset` and `limit` parameter support for paginating cached URL fetch results\n- Added URL caching mechanism to avoid redundant network requests when reading the same URL multiple times\n\n### Changed\n\n- Renamed `fetch.enabled` setting to `Read URLs` with updated description to reflect integration with read tool\n- Updated `read` tool to accept `timeout` and `raw` parameters for URL handling\n- Updated `read` tool to support `file://` URLs for local file paths\n- Removed `fetch` tool from agent tool lists (explore, librarian, oracle, plan, reviewer agents)\n\n### Fixed\n\n- Fixed `read` tool to properly handle `file://` URL scheme by converting to filesystem paths\n\n## [13.17.5] - 2026-04-01\n\n### Added\n\n- Added support for writing to ZIP archives using fflate library for cross-platform compatibility\n\n### Changed\n\n- Modified archive writing to detect and handle ZIP files separately from Bun archives\n\n### Removed\n\n- Removed GhPrPushTool test case\n\n## [13.17.4] - 2026-04-01\n\n### Added\n\n- Support for writing to archive entries in `.tar`, `.tar.gz`, `.tgz`, and `.zip` files using `archive.ext:path/inside/archive` syntax\n- Ability to create new archives when writing to archive subpaths that don't yet exist\n\n## [13.17.3] - 2026-04-01\n\n### Added\n\n- Added support for converting Jupyter notebooks (`.ipynb`) to markdown via markit\n- Added `markit-ai` npm package for native document and notebook conversion\n- Added support for reading files from `.tar`, `.tar.gz`, `.tgz`, and `.zip` archives using virtual subpaths like `archive.ext:path/to/file`\n- Added ability to list archive contents and navigate subdirectories within supported archive formats\n- Added archive-aware `read` support for `.tar`, `.tar.gz`, `.tgz`, and `.zip`, including virtual subpaths like `archive.ext:path/to/file`\n- Added `/tools` slash command to show the tools currently visible to the agent in the interactive session\n\n### Changed\n\n- Replaced Python-based markitdown CLI tool with native `markit-ai` library for document conversion\n- Updated document conversion to use markit library instead of external markitdown command\n- Removed markitdown from Python tools manager (no longer needed as external dependency)\n- Updated `read` tool documentation to reflect archive support and usage patterns\n\n## [13.17.2] - 2026-04-01\n\n### Added\n\n- Added `/marketplace help` command to display usage guide for all marketplace operations\n- Added dedicated `gh-renderer.ts` module for rich terminal rendering of GitHub Actions workflow runs with live status snapshots and job details\n- Added `gh_pr_checkout` tool to check out GitHub pull requests into dedicated git worktrees with contributor push metadata\n- Added `gh_pr_push` tool to push checked-out pull request branches back to their source branches\n- Added `gh_repo_view` tool to read GitHub repository metadata using the local GitHub CLI\n- Added `gh_issue_view` tool to read GitHub issues with optional comment context\n- Added `gh_pr_view` tool to read GitHub pull requests with optional comment context\n- Added `gh_pr_diff` tool to read GitHub pull request diffs with optional file filtering\n- Added `gh_search_issues` tool to search GitHub issues with repository scoping\n- Added `gh_search_prs` tool to search GitHub pull requests with repository scoping\n- Added `gh_run_watch` tool to watch GitHub Actions workflow runs, fast-fail on job failures, and stream tailed logs for failed jobs\n- Added `github.enabled` setting to enable read-only `gh_*` GitHub CLI tools for repository, issue, pull request, diff, and search workflows\n- Added bundled `/green` command to generate iterative CI fix prompts with optional tag instructions when HEAD is tagged\n- Added `github.enabled` setting to enable read-only `gh_*` GitHub CLI tools for repository, issue, pull request, diff, and search workflows\n- Added `gh_repo_view` tool to read GitHub repository metadata using the local GitHub CLI\n- Added `gh_issue_view` tool to read GitHub issues with optional comment context\n- Added `gh_pr_view` tool to read GitHub pull requests with optional comment context\n- Added `gh_pr_diff` tool to read GitHub pull request diffs with optional file filtering\n- Added `gh_search_issues` tool to search GitHub issues with repository scoping\n- Added `gh_search_prs` tool to search GitHub pull requests with repository scoping\n- Added `gh_run_watch` tool to watch GitHub Actions workflow runs, fast-fail on job failures, and stream tailed logs for failed jobs\n- Added bundled `/green` command to generate iterative CI fix prompts with optional tag instructions when HEAD is tagged\n- Project-scoped marketplace plugin installs: `omp plugin install --scope project name@marketplace` and `/marketplace install --scope project name@marketplace` install plugins into the nearest `.omp/` or `.git`-rooted project directory instead of the user directory ([#581](https://github.com/can1357/oh-my-pi/issues/581))\n- `--scope user|project` flag added to `/marketplace uninstall`, `/marketplace upgrade`, `/plugins enable`, and `/plugins disable` to disambiguate when a plugin is installed in both scopes\n- `omp plugin upgrade --scope project` with no plugin ID warns that `--scope` is ignored for bulk upgrades\n- Added opt-in `gh_*` GitHub CLI tools behind the `github.enabled` setting for repository, issue, pull request, diff, and search workflows\n- Added opt-in `gh_run_watch` to fast-fail GitHub Actions runs, stream job status snapshots, and return tailed logs for failed jobs\n- Added bundled `/green` command to generate the iterative \u201cfix CI until green\u201d prompt, with final tag instructions included only when `HEAD` already has a tag\n\n### Changed\n\n- Improved marketplace catalog parsing to skip invalid plugin entries with warnings instead of failing the entire catalog load\n- Enhanced `/marketplace discover` command to suggest adding the official marketplace when no plugins are available\n- Improved `/marketplace` command messaging with clearer guidance for first-time setup and available commands\n- Enhanced `gh_run_watch` tool call rendering to display animated spinner status and target description (run ID, branch, or current HEAD) with improved visual hierarchy\n- Enhanced `gh_pr_view` tool to include inline review comments alongside pull request reviews for improved discussion context\n- Improved `gh_run_watch` tool output rendering with dedicated visual component for streaming run snapshots and job status updates\n\n### Fixed\n\n- Fixed marketplace error messages to display error details instead of object stringification\n- Fixed artifact storage for non-persistent sessions to use in-memory fallback instead of returning undefined, enabling proper spill truncation for all session types\n- Fixed prompt file formatting to include trailing newlines at EOF for consistency across all prompt markdown files\n- Fixed `gh_pr_diff` to preserve raw patch content instead of normalizing tabs and whitespace\n- Fixed `gh_pr_view` to include inline review comments alongside pull request reviews and issue-style comments for discussion context\n- Fixed `gh_run_watch` to resolve explicit branch watches against the selected branch head instead of local `HEAD`\n- Fixed `gh_run_watch` to hide repo and polling internals from the tool schema and save full failed-job logs as session artifacts alongside the inline tailed output\n- Fixed `gh_*` tool outputs to spill full large results to artifacts instead of pre-truncating the head with unusable `offset=` guidance\n- Fixed bundled `/green` to watch the workflow runs for the current `HEAD` commit instead of whichever branch run was newest\n- Fixed OpenAI Responses session rehydration to strip stale assistant replay payloads before resumed requests ([#594](https://github.com/can1357/oh-my-pi/pull/594) by [@daandden](https://github.com/daandden))\n- Fixed inline image rendering to cap image height and preserve multiplexer scrollback during terminal resizes ([#587](https://github.com/can1357/oh-my-pi/pull/587) by [@smileynet](https://github.com/smileynet))\n\n## [13.17.1] - 2026-04-01\n\n### Removed\n\n- Removed `code_search` tool for code snippet and documentation search\n\n### Fixed\n\n- Fixed edit tool diff rendering to wrap long diff lines with continuation gutters instead of truncating them at terminal width ([#578](https://github.com/can1357/oh-my-pi/issues/578))\n- Fixed `--list-models` and `/model` provider filtering to hide models from disabled providers ([#588](https://github.com/can1357/oh-my-pi/issues/588))\n- Fixed edit tool diffstats to use diff-specific add/remove theme colors instead of success/error status colors ([#589](https://github.com/can1357/oh-my-pi/issues/589))\n\n## [13.17.0] - 2026-03-30\n\n### Added\n\n- Added `marketplace.autoUpdate` setting (`off`/`notify`/`auto`, default `notify`) for automatic plugin update checking on startup\n- Added background marketplace catalog refresh on startup when catalogs are stale (>24h)\n- Added `/marketplace upgrade [name@marketplace]` slash command to upgrade outdated plugins\n- Added `omp plugin upgrade [name@marketplace]` CLI command for plugin upgrades\n- Added `checkForUpdates()`, `upgradePlugin()`, `upgradeAllPlugins()`, and `refreshStaleMarketplaces()` to MarketplaceManager\n- Added marketplace plugin system: registry types, ID helpers, atomic read/write for `marketplaces.json` and `installed_plugins.json` (Claude Code-compatible format)\n- Added `MarketplaceManager` orchestrator for marketplace and plugin lifecycle (add/remove/update marketplaces, install/uninstall/enable plugins)\n- Added marketplace fetcher with source classification (GitHub, git, URL, local) and catalog validation\n- Added plugin source resolver with `pathIsWithin` containment checks and versioned cache manager\n- Added CLI commands: `omp plugin marketplace add|remove|update|list`, `omp plugin discover [marketplace]`\n- Added `classifyInstallTarget()` to distinguish `name@marketplace` from npm install targets\n- Extended `listClaudePluginRoots()` to read OMP's installed plugins registry alongside Claude Code's, with OMP as authoritative for duplicate plugin IDs\n- Added `--plugin-dir ` repeatable CLI flag for loading plugins from local directories\n- Added `/reload-plugins` slash command that invalidates fs content cache and plugin roots cache\n- Added `printPluginHelp()` entries for marketplace and discover commands\n- Added MCP server loading from marketplace plugin `.mcp.json` files with `${CLAUDE_PLUGIN_ROOT}` variable substitution\n- Added skill and command namespacing for marketplace plugins (`plugin-name:skill-name`)\n- Added LSP config loading from marketplace plugin roots via `getPreloadedPluginRoots()`\n- Wired `--plugin-dir` runtime injection into plugin roots at session startup with highest precedence\n- Added git (GitHub, SSH, HTTPS) and HTTP URL marketplace source fetching\n- Added `/marketplace` TUI slash command with subcommands: add, remove, update, list, discover, install, uninstall, installed\n- Added `/plugins` TUI slash command to view all installed plugins (npm + marketplace) and enable/disable marketplace plugins\n\n### Changed\n\n- Changed marketplace clone promotion to occur after duplicate and drift checks, improving safety of concurrent marketplace operations\n\n### Removed\n\n- Removed grep.app code search provider support; code search now uses Exa exclusively\n- Removed `providers.codeSearch` setting and related configuration options\n\n### Fixed\n\n- Fixed git-subdir plugin source resolution to properly clean up temporary clone directories on path validation errors\n- Fixed LSP config loading to use correct filenames variable when scanning plugin roots\n- Fixed plugin selector UI to request render on cancel, preventing stale display state\n- Fixed marketplace install command error handling to display user-friendly error messages instead of crashing\n- Fixed MCP tools from newly added servers not being activated after `/mcp add` \u2014 `refreshMCPTools` preserves prior MCP tool selections, so brand-new servers had their tools registered in the registry but never passed to the agent; tools are now explicitly activated on successful connection\n- Fixed `skill://` URI resolver to handle namespaced skills via longest-prefix matching against registered skill names\n\n## [13.16.5] - 2026-03-29\n\n### Fixed\n\n- Fixed `--model provider/id` resolving to wrong provider when model ID exists in multiple catalogs ([#560](https://github.com/can1357/oh-my-pi/issues/560))\n\n## [13.16.4] - 2026-03-28\n\n### Changed\n\n- Renamed hashline helper functions from `hlineref`/`hlinefull` to `href`/`hline` for brevity\n- Simplified hashline edit location API: replaced separate `line` and `block` properties with unified `range` property accepting `{ pos, end }` for all range-based edits\n- Updated hashline prompt documentation to reflect new `range` syntax and clarified editing guidelines\n\n### Fixed\n\n- Added detection for `kysely-codegen` generated files in auto-generated file guard\n\n## [13.16.1] - 2026-03-27\n\n### Added\n\n- Added `searchDb` parameter to `PromptActionAutocompleteProvider` constructor for native search database integration in autocomplete workflows\n- Added `searchDb` parameter to enable native search database integration for grep and find operations\n- Exported `SearchDb` type from tools module for type-safe search database usage\n\n### Changed\n\n- Updated grep tool to accept and utilize `searchDb` parameter for improved search performance\n- Updated find tool to pass `searchDb` parameter to underlying search operations\n- Updated grep tool description to remove ripgrep-specific implementation detail\n\n## [13.16.0] - 2026-03-27\n\n### Added\n\n- Implemented root path alias: bare `/` in tool inputs now resolves to the session working directory instead of the filesystem root\n- Added `browser.screenshotDir` setting to configure screenshot save directory with path expansion\n\n### Changed\n\n- Improved hashline tool documentation with clearer guidance on block boundary handling and closing delimiter duplication prevention\n- Updated screenshot path resolution to use `resolveToCwd` for consistent workspace-relative path handling\n- Updated hook editor hint text to include `ctrl+g external editor` option when using prompt style\n- Refactored question result formatting to consistently include question ID in output\n\n## [13.15.3] - 2026-03-26\n\n### Added\n\n- Added configurable `app.model.selectTemporary` keybinding for temporary model selection.\n\n## [13.15.0] - 2026-03-23\n\n### Breaking Changes\n\n- Changed hashline edit schema from flat `op`/`pos`/`end`/`lines` fields to structured `loc`/`content` format with location-specific objects\n- Renamed hashline edit operations: `replace_line` \u2192 `{ line: anchor }`, `replace_range` \u2192 `{ block: { pos, end } }`, `append_at` \u2192 `{ append: anchor }`, `prepend_at` \u2192 `{ prepend: anchor }`, `append_file` \u2192 `\"append\"`, `prepend_file` \u2192 `\"prepend\"`\n- Changed `lines` parameter to `content` in hashline edit entries\n- Renamed hashline edit operation types: `append` \u2192 `append_at`, `prepend` \u2192 `prepend_at`, `append_eof` \u2192 `append_file`, `prepend_bof` \u2192 `prepend_file`\n- Changed hashline edit operation types from `replace` (with optional `end`) to explicit `replace_line` and `replace_range` operations\n- Added required `append_eof` and `prepend_bof` operations for file-level edits; `append` and `prepend` now require an anchor position\n- Made `pos` parameter required for `replace_line`, `append`, and `prepend` operations; `append_eof` and `prepend_bof` no longer accept anchors\n\n### Added\n\n- Added prompt for tradeoff metrics during autoresearch setup to collect secondary metrics alongside primary metric\n- Added validation of contract path specifications to reject absolute paths and parent directory references\n- Added stricter benchmark command validation in `isAutoresearchShCommand()` to reject chained commands, pipes, and redirects\n- Added protection against prototype pollution in ASI data and metric cloning by filtering `__proto__`, `constructor`, and `prototype` keys\n- Added `autoResumeArmed` flag to track when autoresearch should automatically resume pending runs\n- Added `lastAutoResumePendingRunNumber` to prevent duplicate auto-resume prompts for the same pending run\n- Added `git clean -X` invocation during failed experiment rollback to remove ignored build artifacts\n- Added validation to reject `init_experiment` when a previous run is still pending and unlogged\n- Added autoresearch contract system for validating benchmark commands, metrics, scope paths, off-limits paths, and constraints with fingerprint tracking to detect configuration drift\n- Added `autoresearch.program.md` support for repo-local playbook overlays that guide session strategy while preserving `autoresearch.md` as source of truth\n- Added pending run artifact tracking and recovery to resume incomplete experiments from `.autoresearch/runs/` directory with run numbers and benchmark logs\n- Added run directory organization with numbered run artifacts, benchmark logs, and optional checks logs for experiment traceability\n- Added segment fingerprinting to detect when benchmark configuration changes between runs and warn about potential incomparability\n- Added support for secondary metrics tracking alongside primary metric with configurable direction (lower/higher is better)\n- Added `getCurrentAutoresearchBranch()` helper to detect and validate existing autoresearch branches for session resumption\n- Added `PendingRunSummary` type to track unlogged run state including parsed metrics, ASI data, and pass/fail status\n- Added hidden next-turn message delivery via `deliverAs: 'nextTurn'` with optional `triggerTurn` to queue context for next LLM call without exposing in editable queue\n- Added `#queueHiddenNextTurnMessage()` and `#promptQueuedHiddenNextTurnMessages()` to AgentSession for autonomous tool reactions\n- Added resume context support in `command-resume.md` template for user-provided guidance when resuming sessions\n- Added current segment snapshot display in autoresearch prompt showing recent runs, baseline metrics, and best results\n- Added pending run indicator in autoresearch prompt to guide users to complete unlogged experiments before starting new benchmarks\n- Added local playbook section in autoresearch prompt when `autoresearch.program.md` exists\n- Added tab replacement in dashboard and tool output rendering to prevent display corruption from shell commands with tabs\n- Added boundary duplication warning when replace_range or replace_line operations include a last inserted line that matches the next surviving line, helping detect off-by-one range errors\n- Added git branch isolation for autoresearch sessions via `ensureAutoresearchBranch()` to safely revert failed experiments\n- Added branch status line to autoresearch initialization and resume prompts showing created or reused branch name\n- Added `Files in Scope`, `Off Limits`, and `Constraints` sections to autoresearch.md template for explicit scope definition\n- Added validation of ASI metadata requirements in `log_experiment` tool, requiring hypothesis for all runs and rollback context for failed runs\n- Added keybinding matcher utilities `matchesAppInterrupt()` and `matchesSelectCancel()` for consistent escape key handling across components\n- Added support for customizable `app.interrupt` and `tui.select.cancel` keybindings in interactive components\n- Added `defaultInactive` property to `ToolDefinition` to allow tools to be registered but excluded from the initial active set, with extension responsibility for activation/deactivation\n- Added dynamic tool activation/deactivation in autoresearch mode via `setActiveTools()` API\n- Added separate initialization and resume workflows for autoresearch with `command-initialize.md` and `command-resume.md` prompts\n- Added intent dialog to prompt users for autoresearch optimization goals when starting fresh\n- Added automatic detection of existing `autoresearch.md` to resume from previous sessions without re-prompting for intent\n- Added autoresearch extension with autonomous experiment loop capabilities\n- Added `init_experiment` tool to initialize and reset autoresearch sessions with configurable metrics\n- Added `log_experiment` tool to record experiment results with metric parsing and confidence tracking\n- Added `run_experiment` tool to execute commands and capture metrics with timeout and crash detection\n- Added autoresearch dashboard controller for displaying experiment results and optimization progress\n- Added support for secondary metrics tracking alongside primary metric\n- Added `ExtensionWidgetContent` and `ExtensionUiComponentFactory` types for flexible widget configuration\n- Added `ExtensionWidgetOptions` interface with `placement` parameter to position widgets above or below editor\n- Added `WidgetPlacement` type supporting 'aboveEditor' and 'belowEditor' placement options\n- Added `hookWidgetContainerAbove` and `hookWidgetContainerBelow` containers to InteractiveMode for separate widget management\n- Added autoresearch mode for autonomous experiment loops with init_experiment, log_experiment, and run_experiment tools\n- Added autoresearch dashboard widget displaying experiment results, metrics, and optimization progress\n- Added support for metric tracking with configurable direction (lower/higher is better) and secondary metrics\n- Added widget placement options to position extensions above or below the editor via `placement` parameter\n- Added `ExtensionWidgetContent` and `ExtensionWidgetOptions` types for flexible widget configuration\n- Added ACP (Agent Client Protocol) mode for headless agent operation via `--mode acp`\n- Added support for Agent Client Protocol SDK integration with session management, MCP server configuration, and streaming communication\n- Added `ensureOnDisk()` method to SessionManager to persist sessions immediately for ACP discovery\n\n### Changed\n\n- Changed autoresearch initialization to collect and validate benchmark command, metric definition, scope paths, off-limits list, and constraints before `init_experiment`\n- Changed `init_experiment` to require exact benchmark command, metric definition, scope, off-limits, and constraints matching collected contract\n- Changed `log_experiment` to record run number, benchmark command, scope paths, off-limits list, constraints, and segment fingerprint with each result\n- Changed `run_experiment` to organize output in numbered run directories with separate benchmark and checks logs for artifact preservation\n- Changed autoresearch dashboard to show pending run indicator when unlogged experiment exists\n- Changed autoresearch resume workflow to detect and offer recovery of pending run artifacts before continuing experiment loop\n- Changed `ExperimentResult` to include `runNumber`, `benchmarkCommand`, `scopePaths`, `offLimits`, `constraints`, and `segmentFingerprint` fields\n- Changed `RunningExperiment` to track `runDirectory` and `runNumber` for artifact organization\n- Changed `AutoresearchRuntime` to include `lastRunArtifactDir`, `lastRunNumber`, `lastRunSummary`, `benchmarkCommand`, `secondaryMetrics`, `scopePaths`, `offLimits`, `constraints`, and `segmentFingerprint`\n- Changed autoresearch prompts to emphasize `autoresearch.md` as source of truth for benchmark, scope, and constraints\n- Changed `command-initialize.md` to display collected setup (benchmark command, metric, direction, scope, off-limits, constraints) before initialization\n- Changed `resume-message.md` to reference pending run artifacts and guide completion of unlogged experiments\n- Changed `sendMessage()` API documentation to clarify `deliverAs: 'nextTurn'` behavior for hidden context delivery\n- Changed `SendMessageHandler` type documentation to explain hidden next-turn message queuing during prompt teardown\n- Changed autoresearch startup to create or reuse a dedicated `autoresearch/...` git branch before enabling the experiment loop\n- Changed autoresearch to refuse startup when unrelated worktree changes would make auto-reverts unsafe\n- Changed autoresearch prompts to emphasize scope and constraints as source of truth for session direction\n- Changed component escape key handling to use keybinding manager for `app.interrupt` and `tui.select.cancel` with fallback to raw Escape matching\n- Updated autoresearch prompt guidance to require explicit files in scope, off-limits paths, and session constraints\n- Changed autoresearch command to use intent-based initialization instead of goal parameter, with user input dialog for new sessions\n- Changed autoresearch startup to create or reuse a dedicated `autoresearch/...` git branch before enabling the experiment loop, and to refuse startup when unrelated worktree changes would make auto-reverts unsafe\n- Changed autoresearch startup to activate experiment tools (`init_experiment`, `run_experiment`, `log_experiment`) only when autoresearch mode is enabled\n- Changed autoresearch shutdown to deactivate experiment tools when mode is disabled or cleared\n- Changed autoresearch session rehydration to dynamically manage experiment tool activation based on session state\n- Changed autoresearch prompts and notes guidance to require explicit files in scope, off-limits paths, and session constraints\n- Refactored hashline edit validation to enforce stricter anchor requirements per operation type\n- Updated edit application logic to handle explicit file-level operations (`append_eof`, `prepend_bof`) separately from anchor-based operations\n- Changed `setWidget` API to accept `ExtensionWidgetOptions` parameter for placement control\n- Changed widget placement logic to manage widgets above and below editor separately\n- Changed hashline edit application to preserve duplicated boundary lines exactly as provided instead of auto-correcting them\n- Updated RPC mode to support widget placement option in `setWidget` requests\n- Changed hashline edit application to preserve duplicated boundary lines exactly as provided instead of auto-correcting them\n- Changed widget API to support placement options and component factories in addition to string arrays\n- Updated extension UI controller to manage widgets above and below the editor separately\n- Updated ask tool rendering to support markdown formatting in questions and option labels\n- Refactored hook input and selector components to render titles as markdown for richer text formatting\n- Changed session collection to include sessions with zero messages, enabling ACP mode to create discoverable sessions immediately\n- Changed session persistence logic to use atomic file rewrite when flushing unflushed sessions to prevent duplication\n- Removed hashline edit autocorrection for duplicated boundary lines; escaped-tab autocorrection remains available for leading `\\\\t` sequences\n\n### Removed\n\n- Removed `command-start.md` prompt template in favor of separate initialize and resume workflows\n- Removed auto-correction of off-by-one range edits that duplicated closing braces or boundary lines\n- Removed `shouldAutocorrect` function and related boundary line deduplication logic from hashline editor\n- Removed auto-correction of off-by-one range edits that duplicated closing braces or boundary lines\n\n### Fixed\n\n- Fixed autoresearch resume to detect and recover pending run artifacts that were left unlogged from previous sessions\n- Fixed dashboard overlay to display when running experiment even with zero completed results\n- Fixed tab character rendering in dashboard command display and tool output summaries\n- Fixed autoresearch logging to require durable ASI metadata (hypothesis, rollback_reason, next_action_hint) for every run including rollback context for discarded, crashed, and checks-failed experiments\n- Fixed autoresearch logging to require durable ASI metadata for every run, including rollback context for discarded, crashed, and checks-failed experiments\n\n## [13.14.0] - 2026-03-20\n\n### Added\n\n- Auto-reconnect MCP servers on connection loss with proactive SSE stream monitoring and retry backoff\n- Tool-level reconnect: retriable connection errors (ECONNREFUSED, ECONNRESET, stale session 404/502/503) trigger automatic reconnection and single retry\n- `/mcp reconnect ` command for manual server recovery after extended outages\n\n### Changed\n\n- Extended transport reconnect handling to all transport types (not just HTTP/SSE), ensuring stdio and other transports trigger automatic reconnection on connection loss\n- Improved reconnect robustness by aborting retry attempts when MCP server configuration changes during reconnection sequence\n- Updated explore agent thinking level from off to med for improved reasoning\n- Simplified explore agent output schema: consolidated file references into single `ref` field with optional line ranges instead of separate `path`, `line_start`, `line_end` fields\n- Removed `code` section from explore agent output (critical code excerpts no longer extracted)\n- Removed `dependencies` section from explore agent output\n- Removed `risks` section from explore agent output\n- Removed `start_here` section from explore agent output\n\n### Fixed\n\n- Fixed reconnect retry loop continuing after configuration changes by checking epoch before each reconnection attempt\n- `roots/list` timeout on MCP server initialization: `connectToServer` now always installs a default handler for `ping` and `roots/list`\n- Fixed resumed GitHub Copilot conversations that could fail with `401 input item does not belong to this connection` on the first follow-up after process restart ([#488](https://github.com/can1357/oh-my-pi/issues/488))\n- Fixed STT Alt+H mic cursor rendering to measure the actual microphone glyph width, preventing one-column TUI overflow crashes when the active symbol preset uses a wide icon ([#484](https://github.com/can1357/oh-my-pi/issues/484))\n\n## [13.13.2] - 2026-03-18\n\n### Added\n\n- Added automatic stripping of hashline display prefixes (LINE#ID:) from write tool content when hashline edit mode is enabled, preventing the model from accidentally copying display markers into files\n- Added `mcpServerName` and `mcpToolName` optional properties to custom tools for MCP server discovery and search metadata\n\n## [13.13.1] - 2026-03-18\n\n### Added\n\n- Automatic deduplication of identical context files by content, keeping the closest (lowest depth) copy when duplicates are discovered\n\n## [13.13.0] - 2026-03-18\n\n### Added\n\n- Added `edit.blockAutoGenerated` setting to control whether auto-generated file detection is enforced (enabled by default)\n- Improved auto-generated file detection to use language-specific comment parsing instead of broad regex patterns, reducing false positives\n- Added auto-generated file detection to prevent accidental modification of generated code (protoc, sqlc, buf, swagger, etc.)\n- Added validation in Edit and Write tools to block modifications to files with auto-generated markers or naming patterns\n\n### Changed\n\n- Enhanced auto-generated marker detection to only scan leading header comments rather than entire file prefix, improving accuracy for files with generated markers in code\n\n## [13.12.10] - 2026-03-17\n\n### Added\n\n- Added `args` field to ShellResult to capture the executed command\n- Added `exit_code` property to ShellResult as an alias for `returncode`\n- Added `check_returncode()` method to ShellResult to raise CalledProcessError on non-zero exit codes\n\n### Changed\n\n- Renamed `code` field to `returncode` in ShellResult (accessible via `code` property for backward compatibility)\n- Updated `run()` command documentation to clarify available ShellResult fields\n\n## [13.12.9] - 2026-03-17\n\n### Added\n\n- Added `/session delete` command to delete current session with confirmation and return to session selector\n- Added session deletion in session selector via Delete key with confirmation dialog\n\n### Changed\n\n- Changed session deletion callback to return a boolean indicating success, allowing callers to distinguish between failed deletions and upstream cancellations\n\n### Fixed\n\n- Fixed OAuth redirect URI validation to preserve exact configured values without adding trailing slashes\n- Fixed session deletion error handling to display error messages in the session selector UI instead of silently failing\n- Added `oauth.redirectUri`, `oauth.clientSecret`, and `oauth.callbackPath` support for MCP server OAuth config so providers can use exact registered redirect URIs while preserving local callback listener settings ([#445](https://github.com/can1357/oh-my-pi/issues/445))\n\n## [13.12.8] - 2026-03-16\n\n### Breaking Changes\n\n- Changed `SessionManager.create()` to require explicit `sessionDir` parameter instead of optional\u2014callers must now pass `SessionManager.getDefaultSessionDir(cwd)` to use default behavior\n- Changed `SessionManager.continueRecent()` to require explicit `sessionDir` parameter instead of optional\u2014callers must now pass `SessionManager.getDefaultSessionDir(cwd)` to use default behavior\n- Changed `SessionManager.forkFrom()` to require explicit `sessionDir` parameter instead of optional\u2014callers must now pass `SessionManager.getDefaultSessionDir(cwd)` to use default behavior\n- Changed `SessionManager.list()` signature to accept only `sessionDir` parameter instead of `cwd` and optional `sessionDir`\u2014callers must now compute and pass the session directory explicitly\n\n### Added\n\n- Added `SessionManager.getDefaultSessionDir()` static method to explicitly resolve the canonical default session directory for a working directory\n- Added support for quoted paths in grep, ast_grep, and find tools to handle directory names with spaces\n- Added `normalizePathLikeInput` utility function to consistently handle quoted and whitespace-trimmed path inputs\n\n### Changed\n\n- Made `sessionDir` parameter optional in `SessionManager.create()`, `SessionManager.continueRecent()`, and `SessionManager.forkFrom()`\u2014callers can now omit it to use the default session directory\n- Changed `SessionManager.list()` signature to accept `cwd` as the first parameter instead of requiring an explicit `sessionDir`\u2014callers can now omit `sessionDir` to use the default for the given working directory\n- Updated `SessionManager.getDefaultSessionDir()` to accept optional `agentDir` parameter for computing session directories within a custom agent root\n- Improved status line path display to strip display roots using canonical path resolution, correctly handling symlink aliases to home and Projects directories\n- Improved error messaging in ast_grep when no matches are found with parse errors, now suggests narrowing `path`/`glob` or setting `lang` to resolve mis-scoped queries\n\n### Fixed\n\n- Fixed SDK-created default sessions to honor the configured `agentDir` for session storage, preventing tests from writing stray session directories into the real `~/.omp/agent/sessions` root\n- Fixed session directory resolution to correctly handle symlink-equivalent paths, ensuring aliased home and temp directories resolve to the same session storage location as their real targets\n\n## [13.12.7] - 2026-03-16\n\n### Changed\n\n- Modified `getSelectedMCPToolNames()` to return only active MCP tools in non-discovery sessions, filtering by tool registry availability\n- Updated `search_tool_bm25` tool instantiation to conditionally create the tool only when MCP discovery mode is enabled and execution hooks are available\n- Changed search results to exclude already-selected MCP tools before applying the limit parameter, allowing discovery of additional tools in subsequent searches\n\n### Fixed\n\n- Fixed MCP tool selection tracking to properly distinguish between discovery-enabled and non-discovery sessions, preventing orphaned tool selections after manual deactivation\n\n## [13.12.6] - 2026-03-15\n\n### Changed\n\n- Updated llama.cpp model discovery to read context window from the `/props` endpoint's `default_generation_settings.n_ctx` field instead of using hardcoded 128000 default\n- Updated llama.cpp model discovery to detect vision capabilities from the `/props` endpoint's `modalities.vision` field instead of defaulting to text-only input\n- Changed llama.cpp `maxTokens` calculation to respect discovered context window limits, capping at 8192 or the server's context window, whichever is smaller\n\n### Fixed\n\n- Fixed llama.cpp auto-discovery to read context window and vision support from the native `/props` endpoint instead of relying on hardcoded defaults\n\n## [13.12.5] - 2026-03-15\n\n### Added\n\n- Automatic discovery of Ollama model context window from model metadata, enabling accurate token limit configuration\n- Added `attribution` option to `PromptOptions` to explicitly control billing/initiator attribution for prompts\n- Added automatic clearing of completed and abandoned todo tasks after ~1 minute\n\n### Changed\n\n- Ollama model registration now uses discovered context window instead of hardcoded 128000 token default\n- Ollama model maxTokens now respects discovered context window constraints\n- Improved session directory migration to handle legacy absolute paths with double-dash format, automatically relocating them to new canonical locations\n- Enhanced session directory encoding to use `-tmp-` prefix for temporary directories instead of legacy double-dash format for better clarity\n- Updated `SessionManager.create()` to require both `cwd` and `sessionDir` parameters for explicit session directory control\n- Improved session directory naming for temporary working directories using `-tmp-` prefix instead of legacy `--` format\n- Made `cwd` and `sessionDir` fields mutable in SessionManager to support session relocation without type casting\n- Changed subagent prompts to explicitly set `attribution: \"agent\"` for accurate billing attribution\n- Strip already-completed tasks when restoring session from branch history\n\n### Fixed\n\n- Fixed automatic migration of legacy session directories to new `-tmp-` prefixed naming scheme for temp-root sessions\n\n## [13.12.4] - 2026-03-15\n\n### Added\n\n- Exposed `settings` instance in `CustomToolContext` for session-specific configuration access\n\n### Changed\n\n- Improved artifact spill configuration to use session settings with schema defaults as fallback\n- Refactored type annotations for better type safety in tool result handling\n\n## [13.12.2] - 2026-03-15\n\n### Added\n\n- Added `compaction.thresholdTokens` setting as a fixed token limit alternative to percentage-based compaction threshold\n- Added more artifact spill threshold options (1 KB to 1 MB) with size descriptions\n- Added more artifact tail bytes and tail lines options with descriptions\n- Added `toExtensionId` capability method to enable granular disabling of individual capabilities by ID\n- Added support for disabling specific capabilities (skills, tools, hooks, rules, prompts, instructions, slash commands, MCP servers, extension modules, and context files) via `disabledExtensions` setting\n- Added `includeDisabled` and `disabledExtensions` options to `LoadOptions` for capability loading\n- Added plugin manifest support for `extensions` entry points to allow plugins to contribute extension modules\n- Added `extensions` field to plugin features for feature-specific extension entry points\n- Added automatic discovery of extension modules from installed plugins during extension loading\n- Added `disabledExtensions` setting to allow disabling specific extensions and skills by ID\n- Added support for filtering skills by disabled extension IDs with `skill:` prefix\n\n### Changed\n\n- Changed capability loading to filter out disabled items based on extension IDs before returning results\n- Changed plugin loader to support `extensions` as a manifest entry type alongside tools, hooks, and commands\n- Changed extension discovery to include extension entry points from all enabled plugins\n- Changed context file path handling to use `path.basename()` for consistent cross-platform filename extraction\n\n### Fixed\n\n- Fixed skill loading to properly respect disabled skill names when loading from custom directories\n\n## [13.12.1] - 2026-03-15\n\n### Added\n\n- Support for move-only operations that preserve exact bytes including binary files\n\n### Fixed\n\n- Fixed handling of file moves when no edits are specified, now correctly preserves binary content\n- Fixed validation to reject move operations where source and destination paths are identical\n\n## [13.12.0] - 2026-03-14\n\n### Added\n\n- Added per-rule TTSR interrupt mode override via `interruptMode` field in rule frontmatter to allow fine-grained control over when TTSR interrupts stream processing\n- Added `task` model role to allow configuring a dedicated model for subtask execution via `modelRoles.task` setting\n- Added `moveCursorToMessageEnd` and `moveCursorToMessageStart` prompt actions to navigate to the beginning and end of the entire message\n- Added support for provider-level `compat` configuration to apply OpenAI compatibility settings across all models from a provider\n- Added `reasoningEffortMap` configuration option to map reasoning effort levels to provider-specific values\n- Added support for `supportsUsageInStreaming`, `requiresToolResultName`, `requiresAssistantAfterToolResult`, `requiresThinkingAsText`, `thinkingFormat`, and `supportsStrictMode` OpenAI compatibility options\n- Added support for provider-configurable `OpenAICompat.extraBody` to inject request-body fields for custom gateway/proxy routing\n- Added `close()` method to SessionManager for properly closing persistent writers after flushing pending data\n- Added `omp config init-xdg` command to initialize XDG Base Directory structure on Linux\n- Added `getHistoryDbPath()`, `getModelDbPath()`, `getMemoriesDir()`, `getTerminalSessionsDir()` path helpers\n\n### Changed\n\n- Path resolution on Linux redirects to XDG locations when `XDG_DATA_HOME` / `XDG_STATE_HOME` / `XDG_CACHE_HOME` environment variables are set\n- Changed TTSR interrupt logic to respect per-rule `interruptMode` settings, falling back to global `ttsr.interruptMode` when rule-level override is not specified\n- Reorganized settings tabs from 12 tabs (display, agent, input, tools, config, services, bash, lsp, ttsr, status) to 8 focused tabs (appearance, model, interaction, context, editing, tools, tasks, providers) for improved discoverability\n- Consolidated status line settings into the Appearance tab instead of a separate Status tab\n- Reorganized sampling parameters (temperature, topP, topK, minP, presencePenalty, repetitionPenalty) into the Model tab\n- Moved edit tool settings (mode, fuzzyMatch, fuzzyThreshold, streamingAbort) to the Editing tab\n- Moved read tool settings (readLineNumbers, readHashLines, read.defaultLimit) to the Editing tab\n- Moved LSP settings (lsp.enabled, lsp.formatOnWrite, lsp.diagnosticsOnWrite, lsp.diagnosticsOnEdit) to the Editing tab\n- Moved bash interceptor settings to the Editing tab\n- Moved Python settings (python.toolMode, python.kernelMode, python.sharedGateway) to the Editing tab\n- Moved task delegation settings (task.isolation.*, task.eager, task.maxConcurrency, task.maxRecursionDepth) to the Tasks tab\n- Moved skill and command settings to the Tasks tab\n- Moved provider selection settings (providers.webSearch, providers.codeSearch, providers.image, etc.) to the Providers tab\n- Moved Exa settings to the Providers tab\n- Moved secret handling settings to the Providers tab\n- Moved speech-to-text settings to the Interaction tab\n- Moved context promotion, compaction, branch summary, memories, and TTSR settings to the Context tab\n- Updated tab icon symbols across unicode, nerd, and ASCII presets to match new tab structure\n- Changed default agent model from `default` to `pi/task` to enable independent model configuration for subtasks\n- Changed agent model resolution to support single-pattern inheritance fallback, allowing `pi/task` agents to inherit the active session model when the task role is unconfigured\n- Changed system prompt to use ISO 8601 date format (YYYY-MM-DD) instead of locale-specific formatting\n- Changed system prompt template to use `{{date}}` instead of `{{dateTime}}` for current date display\n- Changed tool download timeout from 15 seconds to 120 seconds to accommodate slower network conditions\n- Changed working directory paths in system prompt to use forward slashes for consistency across platforms\n- Modified bash executor to fall back to one-shot shell execution after a persistent session hard timeout, preventing subsequent commands from hanging\n\n### Removed\n\n- Removed bash executor hard timeout recovery test file (functionality already documented in existing entries)\n\n### Fixed\n\n- Fixed bash execution to fall back to one-shot shell runs after a persistent session hard timeout, preventing later commands from hanging until restart\n- Fixed timeout handling in RpcClient to properly clear timeouts and prevent resource leaks\n- Fixed AgentSession disposal to call SessionManager's `close()` method when available, ensuring proper cleanup of persistent writers\n- Removed redundant `path.join()` call wrapping `getHistoryDbPath()` in history-storage.ts\n\n## [13.11.1] - 2026-03-13\n\n### Added\n\n- Added `llama.cpp` as local provider\n- Added `code_search` tool supporting both Exa and grep.app providers for code snippet and documentation search\n- Added `providers.codeSearch` setting to configure code search provider (exa or grep)\n- Added grep.app integration for public code search with result ranking by context relevance\n\n### Changed\n\n- Updated compact diff preview to include line hashes for visibility and integrity verification of unchanged and added lines\n- Modified compact diff preview to track line number synchronization between old and new files when processing insertions and deletions\n- Simplified web search tools: removed `web_search_deep`, `web_search_crawl`, `web_search_linkedin`, and `web_search_company` tools\n- Removed `exa.enableLinkedin` and `exa.enableCompany` settings; LinkedIn and company research are no longer available\n- Refactored code search to use pluggable provider system instead of Exa-only implementation\n\n### Removed\n\n- Removed Exa LinkedIn search tool (`exa_linkedin`)\n- Removed Exa company research tool (`exa_company`)\n- Removed Exa deep search tool (`exa_search_deep`)\n- Removed Exa URL crawl tool (`exa_crawl`)\n\n### Fixed\n\n- Fixed line number parsing in compact diff preview to handle variable-width line number fields with leading whitespace\n\n## [13.11.0] - 2026-03-12\n\n### Added\n\n- Added Parallel as a web search provider with support for fast and research modes\n- Added Parallel extract API integration for URL content fetching and YouTube video extraction\n- Added `providers.parallelFetch` setting to enable/disable Parallel extract for URL fetching\n- Added `/login parallel` command support for Parallel API authentication\n- Added subcommands to `/copy` command: `code` (copy last code block), `all` (copy all code blocks), `cmd` (copy last bash/python command), and `last` (copy full message)\n- Added support for copying last executed bash or python command via `/copy cmd` subcommand\n- Added `assignment` field to task progress and result objects to track the raw per-task assignment text separately from the full templated task\n- Added `details` field to todo items for storing implementation specifics, file paths, and edge cases (shown only when task is active)\n- Added support for multi-line details in todo items with automatic indentation in interactive and reminder displays\n- Added `todo.eager` setting to automatically create a comprehensive todo list after the first user message\n- Added `buildNamedToolChoice` utility function to build provider-aware tool choice constraints for named tools\n- Support for comma/space-separated path lists in `find`, `grep`, `ast_grep`, and `ast_edit` tools (e.g., `apps/,packages/,phases/` or `apps/ packages/ phases/`)\n- New `resolveMultiSearchPath` and `resolveMultiFindPattern` functions to handle multi-path search inputs with automatic common base path detection\n\n### Changed\n\n- Updated HTML-to-text rendering to prefer Parallel extract when credentials are available, before falling back to jina, trafilatura, or lynx\n- Updated YouTube scraper to prefer Parallel extract when credentials are available, before falling back to yt-dlp\n- Updated web search provider priority order to include Parallel between Exa and Kagi\n- Updated hashline tool documentation with explicit guidance on `replace` operation semantics, clarifying that `lines` must not extend past `end` to avoid unintended line duplication\n- Improved diagnostic message formatting to group errors by file path with indented details for better readability\n- Modified eager todo prelude to use hidden custom message type instead of visible developer message, preventing duplicate prompt text in session history\n- Updated eager todo prompt to remove dynamic user request injection, simplifying the template and preventing request repetition in displayed messages\n- Modified eager todo enforcement to prepend the todo reminder to the first user turn instead of executing it as a separate synthetic turn, reducing unnecessary prompt calls\n- Updated task rendering to display assignment text instead of full task template when available, reducing noise in progress and result displays\n- Modified task section rendering to show trimmed assignment text without stripping context blocks, simplifying the display logic\n- Updated todo item display to show `details` field indented below active tasks in both interactive mode and todo reminder component\n- Modified tool choice resolution to support per-turn tool choice overrides via `consumeNextToolChoiceOverride()`\n- Updated tool documentation to clarify that `path` parameter accepts files, directories, glob patterns, or comma/space-separated path lists\n- Refactored path resolution logic in `find`, `grep`, `ast_grep`, and `ast_edit` tools to use unified multi-path handling\n\n### Fixed\n\n- Fixed hashline line normalization to trim trailing whitespace and strip carriage returns instead of removing all whitespace, preserving intentional spacing in code\n- Fixed noop detection in hashline replace operations to check array length equality before comparing lines, preventing false noop classification when single-line replacements expand to multiple lines\n- Fixed path resolution to accept bare directory names without trailing slashes in comma/space-separated path lists (e.g., `apps packages phases`)\n- Per-role `modelRoles` thinking selectors now propagate through commit/title helper model selection, legacy commit analysis, and agentic commit sessions while preserving default thinking inheritance when no role override is configured\n\n## [13.10.1] - 2026-03-10\n\n### Added\n\n- Exported `submitInteractiveInput()` function for programmatic submission of user input in interactive mode\n- Added proactive OAuth token refresh for MCP server connections with 5-minute expiry buffer\n- Added reactive 401/403 retry with automatic token refresh on HTTP MCP transports\n- Added `refreshMCPOAuthToken()` for standard OAuth 2.0 refresh_token grants\n- Persisted `tokenUrl`, `clientId`, and `clientSecret` in MCP auth config for cross-session token refresh\n\n## [13.10.0] - 2026-03-10\n\n### Fixed\n\n- Preserved text signature metadata (id and phase) when building OpenAI native history during session compaction\n\n## [13.9.16] - 2026-03-10\n\n### Breaking Changes\n\n- Web search tool no longer accepts `provider` parameter in tool calls; use internal provider resolution instead\n- Removed `no_fallback` option from search parameters\n\n### Added\n\n- Added `before_provider_request` extension event to intercept and modify provider request payloads before sending\n- Added `emitBeforeProviderRequest()` method to ExtensionRunner for chaining payload transformations across extensions\n- Added `refreshInBackground()` method to ModelRegistry for non-blocking model discovery\n- Added `refreshProvider()` method to refresh models for a specific provider on demand\n- Added `getDiscoverableProviders()` method to list all configured discoverable providers\n- Added `getProviderDiscoveryState()` method to inspect provider discovery status, cache age, and errors\n- Added provider discovery state tracking with status indicators (idle, ok, cached, unavailable, unauthenticated)\n- Added model caching with 24-hour TTL to preserve discovered models across sessions\n- Added provider-specific empty state messages in model selector showing cache age and discovery status\n- Added live provider refresh when switching provider tabs in model selector\n\n### Changed\n\n- Changed model discovery to load cached models immediately before attempting live refresh, improving startup performance\n- Changed model selector to refresh offline by default when reloading config, deferring live discovery to background\n- Changed model discovery timeout from 3000ms to 250ms for faster failure detection\n- Changed model discovery error handling to preserve cached models when live refresh fails\n- Changed `refresh()` strategy parameter to support 'offline' mode for config-only reloads\n- Changed main.ts to defer model refresh until needed (--list-models or background refresh)\n- Changed SDK session creation to use background refresh instead of blocking on model discovery\n- Removed `provider` parameter from web search tool schema; provider selection now handled internally\n- Removed `no_fallback` parameter from web search parameters; fallback behavior now automatic based on provider availability\n- Renamed `SearchParams` type to `SearchToolParams` for tool execution; introduced `SearchQueryParams` for CLI queries with optional provider selection\n\n### Fixed\n\n- Fixed model discovery to continue using cached models when provider is temporarily unavailable\n- Fixed unauthenticated provider discovery to preserve cached models instead of discarding them\n- Fixed model selector to show discovery status messages when provider has no models\n\n## [13.9.15] - 2026-03-10\n\n### Added\n\n- Added `ensureLoadingAnimation()` method to manage loading animation lifecycle and prevent duplicate spinners\n\n### Changed\n\n- Refactored loading animation initialization to use centralized `ensureLoadingAnimation()` method in event and input controllers\n- Updated `showError()` to properly clean up loading animation state when errors occur\n\n## [13.9.12] - 2026-03-09\n\n### Added\n\n- Added Tavily as a supported web search provider with `TAVILY_API_KEY` credential discovery and provider fallback support\n- Added `#`-triggered prompt action suggestions in the editor, with keybinding hints for line navigation and prompt copy actions\n- Added Tavily as a supported web search provider with `TAVILY_API_KEY` credential discovery and provider fallback support ([#313](https://github.com/can1357/oh-my-pi/issues/313))\n\n### Removed\n\n- Removed Kagi Universal Summarizer integration from fetch tool\u2014HTML rendering now uses jina, trafilatura, and lynx only\n- Removed `fetch.useKagiSummarizer` setting\n- Removed Kagi summarization from YouTube video handling\n\n### Fixed\n\n- Canonicalized bash executor working directories before handing them to brush so `pwd` stays aligned with canonical Git worktree paths in symlinked workspaces\n\n## [13.9.10] - 2026-03-08\n\n### Added\n\n- Added `env` parameter to bash tool to pass environment variables safely without shell re-parsing, preventing quote and special character bugs with multiline or untrusted values\n- Added support for rendering partial `env` assignments in command preview while tool arguments are still streaming\n- Added `env` support to the bash tool so commands can reference safe shell variables without inline quoting bugs for multiline or quote-heavy values\n\n### Changed\n\n- Changed bash tool to display environment variable assignments in command preview when `env` parameter is used\n\n## [13.9.8] - 2026-03-08\n\n### Added\n\n- Added docs.rs scraper for extracting Rust crate documentation from rustdoc JSON, including support for modules, functions, structs, traits, enums, and other Rust items with caching\n\n## [13.9.7] - 2026-03-08\n\n### Added\n\n- Added `skipPostPromptRecoveryWait` option to handoff operations to defer recovery work until after handoff completion\n- Added deferred auto-compaction scheduling to allow threshold-triggered handoffs to complete while the original prompt is still unwinding\n\n### Changed\n\n- Extracted handoff document template to dedicated prompt file for improved maintainability and template variable support\n- Changed handoff prompt generation to use template rendering with support for custom focus instructions\n- Refactored internal prompt-in-flight tracking from boolean flag to counter to properly handle nested prompt operations\n- Moved llms.txt endpoint discovery to fallback strategy when rendered page content is low quality, prioritizing page-specific content over site-wide files\n- Enhanced llms.txt endpoint detection to scope candidates to the requested URL path, searching section-specific files before site-wide ones\n\n## [13.9.6] - 2026-03-08\n\n### Added\n\n- Added `glob` parameter to `ast_grep` and `ast_edit` tools for additional glob filtering relative to the `path` parameter\n- Added `combineSearchGlobs` utility function to merge glob patterns from `path` and `glob` parameters\n\n### Changed\n\n- Renamed `patterns` parameter to `pat` in `ast_grep` tool for consistency\n- Renamed `selector` parameter to `sel` in `ast_grep` and `ast_edit` tools for brevity\n- Updated tool documentation with expanded guidance on AST pattern syntax, metavariable usage, and contextual matching strategies\n- Updated `grep` tool to combine glob patterns from `path` and `glob` parameters instead of throwing an error when both are provided\n\n## [13.9.4] - 2026-03-07\n\n### Added\n\n- Automatic detection of Ollama model capabilities including reasoning/thinking support and vision input via the `/api/show` endpoint\n- Improved Kagi API error handling with extraction of detailed error messages from JSON and plain text responses\n\n### Changed\n\n- Updated Kagi provider description to clarify requirement for Kagi Search API beta access\n\n## [13.9.3] - 2026-03-07\n\n### Breaking Changes\n\n- Changed `ThinkingLevel` type to be imported from `@oh-my-pi/pi-agent-core` instead of `@oh-my-pi/pi-ai`\n- Changed thinking level representation from string literals to `Effort` enum values (e.g., `Effort.High` instead of `\"high\"`)\n- Changed `getThinkingLevel()` return type to `ThinkingLevel | undefined` to support models without thinking support\n- Changed model `reasoning` property to `thinking` property with `ThinkingConfig` for explicit effort level configuration\n- Changed `thinkingLevel` in session context to be optional (`ThinkingLevel | undefined`) instead of always present\n\n### Added\n\n- Added `thinking.ts` module with `getThinkingLevelMetadata()` and `resolveThinkingLevelForModel()` utilities for thinking level handling\n- Added `ThinkingConfig` support to model definitions for specifying supported thinking effort levels per model\n- Added `enrichModelThinking()` function to apply thinking configuration to models during registry initialization\n- Added `clampThinkingLevelForModel()` function to constrain thinking levels to model-supported ranges\n- Added `getSupportedEfforts()` function to retrieve available thinking efforts for a model\n- Added `Effort` enum import from `@oh-my-pi/pi-ai` for type-safe thinking level representation\n- Added `/fast` slash command to toggle OpenAI service tier priority mode for faster response processing\n- Added `serviceTier` setting to control OpenAI processing priority (none, auto, default, flex, scale, priority)\n- Added `compaction.remoteEnabled` setting to control use of remote compaction endpoints\n- Added remote compaction support for OpenAI and OpenAI Codex models with encrypted reasoning preservation\n- Added fast mode indicator (\u26a1) to model segment in status line when priority service tier is active\n- Added context usage threshold levels (normal, warning, purple, error) with token-aware thresholds for better context awareness\n- Added `isFastModeEnabled()`, `setFastMode()`, and `toggleFastMode()` methods to AgentSession for fast mode control\n\n### Changed\n\n- Changed credential deletion to disable credentials with persisted cause instead of permanent deletion\n- Added `disabledCause` parameter to credential deletion methods to track reason for disabling\n- Changed thinking level parsing to use `parseEffort()` from local thinking module instead of `parseThinkingLevel()` from pi-ai\n- Changed model list display to show supported thinking efforts (e.g., \"low,medium,high\") instead of yes/no reasoning indicator\n- Changed footer and status line to check `model.thinking` instead of `model.reasoning` for thinking level display\n- Changed thinking selector to work with `Effort` type instead of `ThinkingLevel` for available levels\n- Changed model resolver to return `undefined` for thinking level instead of `\"off\"` when no thinking is specified\n- Changed compaction reasoning parameters to use `Effort` enum values instead of string literals\n- Changed RPC types to use `Effort` for cycling thinking levels and `ThinkingLevel | undefined` for session state\n- Changed theme thinking border color function to accept both `ThinkingLevel` and `Effort` types\n- Changed context usage coloring in footer and status line to use token-aware thresholds instead of fixed percentages\n- Changed compaction to preserve OpenAI remote compaction state and encrypted reasoning across sessions\n- Changed compaction to skip emitting kept messages when using OpenAI remote compaction with preserved history\n- Changed session context to include `serviceTier` field for tracking active service tier across session branches\n- Changed `compact()` function to accept `remoteInstructions` option for custom remote compaction prompts\n- Changed model registry to apply hardcoded policies (gpt-5.4 context window) consistently across all model loading paths\n\n### Fixed\n\n- Fixed OpenAI remote compaction to correctly append incremental responses instead of replacing entire history\n- Fixed thinking level display logic in main.ts to correctly check for undefined instead of \"off\"\n- Fixed model registry to preserve explicit thinking configuration on runtime-registered models\n- Fixed usage limit reset time calculation to use absolute `resetsAt` timestamps instead of deprecated `resetInMs` field\n- Fixed compaction summary message creation to no longer be automatically added to chat during compaction (now handled by session manager)\n\n## [13.9.2] - 2026-03-05\n\n### Added\n\n- Support for Python code execution messages with output display and error handling\n- Support for mode change entries in session exports\n- Support for TTSR injection and session initialization entries in tree filtering\n\n### Changed\n\n- Updated label lookup to use `targetId` field instead of `parentId` for label references\n- Changed model change entry display to use `model` field instead of separate `provider` and `modelId` fields\n- Simplified model change rendering by removing OpenAI Codex bridge prompt display\n- Updated searchable text extraction to include Python code from `pythonExecution` messages\n\n### Removed\n\n- Removed `codexInjectionInfo` from session data destructuring\n- Removed OpenAI Codex-specific bridge prompt UI from model change entries\n\n### Fixed\n\n- Auto-corrected off-by-one range start errors in hashline edits that would duplicate preceding lines\n\n## [13.9.0] - 2026-03-05\n\n### Added\n\n- Added `read.defaultLimit` setting to configure default number of lines returned by read tool when no limit is specified (default: 300 lines)\n- Added preset options for read default limit (200, 300, 500, 1000, 5000 lines) in settings UI\n\n### Changed\n\n- Updated read tool prompt to distinguish between default limit and maximum limit per call\n- Moved `ThinkingLevel` type from `@oh-my-pi/pi-agent-core` to `@oh-my-pi/pi-ai` for centralized thinking level definitions\n- Replaced local thinking level validation with `parseThinkingLevel()` and `ALL_THINKING_LEVELS` from `@oh-my-pi/pi-ai`\n- Updated thinking level option providers to use `THINKING_MODE_DESCRIPTIONS` from `@oh-my-pi/pi-ai` for consistent descriptions\n- Renamed `RoleThinkingMode` type to `ThinkingMode` and changed default value from `'default'` to `'inherit'` for clarity\n- Replaced `formatThinkingEffortLabel()` utility with `formatThinking()` from `@oh-my-pi/pi-ai`\n- Renamed `extractExplicitThinkingLevel()` to `extractExplicitThinkingSelector()` in model resolver\n- Updated thinking level clamping to use `getAvailableThinkingLevel()` from `@oh-my-pi/pi-ai`\n\n### Removed\n\n- Removed `thinking-effort-label.ts` utility file (functionality moved to `@oh-my-pi/pi-ai`)\n- Removed local `VALID_THINKING_LEVELS` constant definitions across multiple files\n- Removed `isValidThinkingLevel()` function (replaced by `parseThinkingLevel()` from `@oh-my-pi/pi-ai`)\n- Removed `parseThinkingLevel()` helper from discovery module (now uses centralized version from `@oh-my-pi/pi-ai`)\n\n### Fixed\n\n- Fixed provider session state not being cleared when branching or navigating tree history, preventing resource leaks with codex provider sessions\n\n## [13.8.0] - 2026-03-04\n\n### Added\n\n- Added `buildCompactHashlineDiffPreview()` function to generate compact diff previews for model-visible tool responses, collapsing long unchanged runs and consecutive additions/removals to show edit shape without full file content\n- Added project-level discovery for `.agent/` and `.agents/` directories, walking up from cwd to repo root (matching behavior of other providers like `.omp`, `.claude`, `.codex`). Applies to skills, rules, prompts, commands, context files (AGENTS.md), and system prompts (SYSTEM.md)\n\n### Changed\n\n- Changed edit tool response to include diff summary with line counts (+added -removed) and a compact diff preview instead of warnings-only output\n- Limited auto context promotion to models with explicit `contextPromotionTarget`; models without a configured target now compact on overflow instead of switching to arbitrary larger models ([#282](https://github.com/can1357/oh-my-pi/issues/282))\n\n### Fixed\n\n- Fixed `:thinking` suffix in `modelRoles` config values silently breaking model resolution (e.g., `slow: anthropic/claude-opus-4-6:high`) and being stripped on Ctrl+P role cycling\n\n## [13.7.6] - 2026-03-04\n\n### Added\n\n- Exported `dedupeParseErrors` utility function to deduplicate parse error messages while preserving order\n\n### Fixed\n\n- Reduced duplicate parse error messages when multiple patterns fail on the same file\n- Normalized parse error output in ast-grep to remove pattern-specific prefixes and show only file-level errors\n\n## [13.7.4] - 2026-03-04\n\n### Added\n\n- Added `fetch.useKagiSummarizer` setting to toggle Kagi Universal Summarizer usage in the fetch tool.\n\n### Fixed\n\n- Fixed incorrect message history reference in session title generation that could cause missing or stale titles on first message\n- Added startup check requiring Bun 1.3.7+ for JSONL session parsing (`Bun.JSONL.parseChunk`) and clear upgrade guidance so `/resume` and `--resume` do not silently report missing sessions on older Bun runtimes\n\n## [13.7.3] - 2026-03-04\n\n### Added\n\n- Added Kagi Universal Summarizer integration for URL summarization, now prioritized before Jina and other methods\n- Added Kagi Universal Summarizer support for YouTube video summaries when credentials are available\n- Exported `searchWithKagi` and `summarizeUrlWithKagi` functions from new `web/kagi` module for direct API access\n- Added `KagiApiError` exception class for Kagi API-specific error handling\n\n### Changed\n\n- Updated hashline prompt documentation with clearer operation syntax and improved examples showing full edit structure with path and edits array\n- Refactored `hlineref` Handlebars helper to return JSON-quoted strings for safer embedding in JSON blocks within prompts\n- Improved `hashlineParseText` to correctly preserve blank lines and trailing empty strings in array input while stripping trailing newlines from string input\n- Optimized duplicate line detection in range replacements to use trimmed comparison, reducing false positives from whitespace differences\n- Refactored Kagi search provider to use shared Kagi API utilities from `web/kagi` module\n- Changed HTML-to-text rendering priority order to try Kagi first, then Jina, Trafilatura, and Lynx\n\n### Fixed\n\n- Fixed `isEscapedTabAutocorrectEnabled` environment variable parsing to use switch statement for clearer logic and consistent default behavior\n\n## [13.7.2] - 2026-03-04\n\n### Added\n\n- Added support for direct OAuth provider login via `/login ` command (e.g., `/login kagi`)\n- Added optional `providerId` parameter to `showOAuthSelector()` to enable direct provider selection without UI selector\n\n### Changed\n\n- Simplified web search result formatting to omit empty sections and metadata when not present\n\n## [13.7.0] - 2026-03-03\n\n### Fixed\n\n- Fixed `ask` timeout handling to auto-select the recommended option instead of aborting the turn, while preserving explicit user-cancel abort behavior ([#266](https://github.com/can1357/oh-my-pi/issues/266))\n\n## [13.6.2] - 2026-03-03\n\n### Fixed\n\n- Fixed LM Studio API key retrieval to use configured provider name instead of hardcoded 'lm-studio'\n- Fixed resource content handling to properly check for empty text values (null/undefined)\n- Fixed resource refresh tracking to prevent stale promise reuse when server connection changes\n- Fixed update target resolution to properly handle cases where binary path cannot be resolved\n\n## [13.6.1] - 2026-03-03\n\n### Fixed\n\n- Fixed `omp update` silently succeeding without actually updating the binary when the update channel (bun global vs compiled binary) doesn't match the installation method ([#247](https://github.com/can1357/oh-my-pi/issues/247))\n- Added post-update verification that checks the resolved `omp` binary reports the expected version, with actionable warnings on mismatch\n- `omp update` now detects when the `omp` in PATH is not managed by bun and falls back to binary replacement instead of updating the wrong location\n\n## [13.6.0] - 2026-03-03\n\n### Added\n\n- Added `mcp://` internal URL protocol for reading MCP server resources directly via the read tool (e.g., `read(path=\"mcp://resource-uri\")`)\n- Added LM Studio integration to the model registry and discovery flow.\n- Added support for authenticating with LM Studio using the `/login lm-studio` command.\n- Added `fuse-projfs` task isolation mode for Windows ProjFS-backed overlays.\n- Added `/mcp registry search ` integration with Smithery, including interactive result selection, editable server naming before deploy, Smithery `configSchema` prompts, and immediate runtime reload so selected MCP tools are available without restarting\n- Added OAuth failure fallback in `/mcp registry search` deploy flow to prompt for manual bearer tokens and validate them before saving configuration\n- Added Smithery auth support for `/mcp registry search` with cached API key login (`/mcp registry login`, `/mcp registry logout`) and automatic login prompt/retry on auth or rate-limit responses\n\n### Changed\n\n- Updated MCP resource update notifications to recommend using `read(path=\"mcp://\")` instead of the deprecated `read_resource` tool\n- Updated Anthropic Foundry environment variable documentation and CLI help text to the canonical names: `CLAUDE_CODE_USE_FOUNDRY`, `CLAUDE_CODE_CLIENT_CERT`, and `CLAUDE_CODE_CLIENT_KEY`\n- Documented Foundry-specific Anthropic runtime configuration (`FOUNDRY_BASE_URL`, `ANTHROPIC_FOUNDRY_API_KEY`, `ANTHROPIC_CUSTOM_HEADERS`, `NODE_EXTRA_CA_CERTS`) in environment variable reference docs\n- `fuse-overlay` task isolation now targets `fuse-overlayfs` on Unix hosts only; on Windows it falls back to `worktree` with a `` suggesting `fuse-projfs`.\n- `fuse-projfs` now performs Windows ProjFS preflight checks and falls back to `worktree` when host or repository prerequisites are unavailable.\n- Cross-repo patch capture now uses the platform null device (`NUL` on Windows, `/dev/null` elsewhere) for `git diff --no-index`.\n\n### Removed\n\n- Removed `read_resource` tool; MCP resource reading is now integrated into the `read` tool via `mcp://` URLs\n\n### Fixed\n\n- Fixed MCP resource subscription handling to prevent unsubscribing when notifications are re-enabled after being disabled\n- Fixed LM Studio base URL validation to preserve invalid configured URLs instead of silently falling back to localhost\n- Fixed URI template matching to correctly handle expressions that expand to empty strings\n\n## [13.5.6] - 2026-03-01\n\n### Changed\n\n- Updated OAuth client name from 'oh-my-pi MCP' to 'Codex' for dynamic client registration\n\n### Fixed\n\n- Fixed exit_plan_mode handler to abort active agent turn before opening plan approval selector, ensuring proper session cleanup\n\n## [13.5.5] - 2026-03-01\n\n### Added\n\n- Added Kagi web search provider (Search API v0) with related searches support and automatic `KAGI_API_KEY` detection\n\n## [13.5.4] - 2026-03-01\n\n### Added\n\n- Added `authServerUrl` field to `AuthDetectionResult` to capture OAuth server metadata from `Mcp-Auth-Server` headers\n- Added `extractMcpAuthServerUrl()` function to parse and validate `Mcp-Auth-Server` URLs from error messages\n- Added support for `/.well-known/oauth-protected-resource` discovery endpoint to resolve authorization servers\n- Added recursive auth server discovery to follow `authorization_servers` references when discovering OAuth endpoints\n- Added `omp agents unpack` CLI subcommand to export bundled subagent definitions to `~/.omp/agent/agents` by default, with `--project` support for `./.omp/agents`\n\n### Changed\n\n- Enhanced `discoverOAuthEndpoints()` to accept optional `authServerUrl` parameter and query both auth server and resource server for OAuth metadata\n- Improved OAuth metadata extraction to handle additional field name variations (`clientId`, `default_client_id`, `public_client_id`)\n- Refactored OAuth endpoint discovery logic into reusable `findEndpoints()` helper for consistent metadata parsing across multiple sources\n- Task subagents now strip inherited `AGENTS.md` context files and the task tool prompt no longer warns against repeating AGENTS guidance, aligning subagent context with explicit task inputs ([#233](https://github.com/can1357/oh-my-pi/issues/233))\n\n### Fixed\n\n- Fixed MCP OAuth discovery to honor `Mcp-Auth-Server` metadata and resolve authorization endpoints from the declared auth server, restoring Figma MCP login URLs with `client_id` ([#235](https://github.com/can1357/oh-my-pi/issues/235))\n\n## [13.5.3] - 2026-03-01\n\n### Added\n\n- Auto-include `ast_grep` and `ast_edit` tools when their text-based counterparts (`grep`, `edit`) are requested and the AST tools are enabled\n- Enforced tool decision in plan mode\u2014agent now requires calling either `ask` or `exit_plan_mode` when a turn ends without a required tool call\n- Auto-correction of escaped tab indentation in edits (enabled by default, controllable via `PI_HASHLINE_AUTOCORRECT_ESCAPED_TABS` environment variable)\n- Warning when suspicious Unicode escape placeholder `\\uDDDD` is detected in edit content\n\n### Changed\n\n- Updated bash tool description to conditionally show `ast_grep` and `ast_edit` guidance based on tool availability in the session\n- Replaced timeout-based cancellation with AbortSignal-based cancellation in the `ask` tool for more reliable user interaction handling\n- Updated `ask` tool to distinguish between user-initiated cancellation and timeout-driven auto-selection, with only user cancellation aborting the turn\n- Updated hashline documentation to clarify that `\\t` in JSON represents a real tab character, not a literal backslash-t sequence\n\n### Fixed\n\n- Fixed race condition in dialog overlay handling where multiple concurrent resolutions could occur\n- Cancelling the `ask` tool now aborts the current turn instead of returning a normal cancelled selection, while timeout-driven auto-cancel still returns without aborting\n\n## [13.5.2] - 2026-03-01\n\n### Added\n\n- Added `checkpoint` tool to create context checkpoints before exploratory work, allowing you to investigate with many intermediate tool calls and minimize context cost afterward\n- Added `rewind` tool to end an active checkpoint and replace intermediate exploration messages with a concise investigation report\n- Added `checkpoint.enabled` setting to control availability of the checkpoint and rewind tools\n- Added `render_mermaid` tool to convert Mermaid graph source into ASCII diagram output\n- Added `renderMermaid.enabled` setting to control availability of the render_mermaid tool\n\n### Changed\n\n- Changed Mermaid rendering from PNG images to ASCII diagrams in theme rendering\n- Changed `prerenderMermaid()` function to synchronously render ASCII instead of asynchronously rendering PNG\n\n## [13.5.0] - 2026-03-01\n\n### Added\n\n- Added `hlinejsonref` Handlebars helper for embedding hashline references inside JSON blocks in prompts\n- Added `librarian` agent for researching external libraries and APIs by reading source code\n- Added `oracle` agent for deep reasoning on debugging, architecture decisions, and technical advice\n- Added `dependencies` and `risks` output fields to explore agent for better context handoff\n- Added support for `lsp`, `fetch`, `web_search`, and `ast_grep` tools to explore, plan, and reviewer agents\n\n### Changed\n\n- Enhanced hashline tool documentation with explicit prohibition on formatting-only edits\n- Added mandatory rule requiring indentation in `lines` to match surrounding context exactly from `read` output\n- Changed explore agent output field `query` to `summary` with expanded description for findings and conclusions\n\n## [13.4.1] - 2026-03-01\n\n### Fixed\n\n- Pending resolve reminders now trigger as soon as a preview action is queued, before the next assistant turn, with regression coverage in `agent-session-resolve-reminder` tests\n\n## [13.4.0] - 2026-03-01\n\n### Breaking Changes\n\n- `ast_grep` parameter `pattern` (string) replaced by `patterns` (string[])\n- `ast_edit` parameters `pattern` + `rewrite` replaced by `ops: Array<{ pat: string; out: string }>`\n\n### Added\n\n- Added `resolve` tool to apply or discard pending preview actions with required reasoning\n- AST edit now registers pending actions after preview, allowing explicit apply/discard workflow via `resolve` tool\n- Custom tools can register pending actions via `pushPendingAction(action)` in `CustomToolAPI`, enabling the `resolve` workflow for custom preview-apply flows\n- `deferrable?: boolean` field added to `AgentTool`, `CustomTool`, and `ToolDefinition` interfaces; tools that set it signal they may stage pending actions\n- `HIDDEN_TOOLS` and `ResolveTool` exported from `@oh-my-pi/pi-coding-agent` SDK for manual tool composition\n- `PendingActionStore` now uses a LIFO stack (`push`/`peek`/`pop`); multiple deferrable tools can stage actions that resolve in reverse order of registration\n- Added `gemini`, `codex`, and `synthetic` as supported values for the `providers.webSearch` setting\n- `ast_grep` tool now accepts a `patterns` array (replaces single `pattern`); multiple patterns run in one native pass and results are merged before offset/limit\n- `ast_edit` tool now accepts an `ops` array of `{ pat, out }` entries (replaces `pattern` + `rewrite`); duplicate patterns are rejected upfront\n- AST find output now uses `>>` prefix on match-start lines and pads line numbers; directory-tree grouping with `# dir` / `## \u2514\u2500 file` headers for directory-scoped searches\n- AST replace output now renders diff-style (`-before` / `+after`) change previews grouped by directory\n- Both AST tools now report `scopePath`, `files`, and per-file match/replacement counts in tool details\n- Task item `id` max length raised from 32 to 48 characters\n- Anthropic web search provider now uses `buildAnthropicSearchHeaders` (dedicated search header builder separate from inference headers)\n- Gemini web search provider: endpoint fallback (daily \u2192 sandbox) with retry on 429/5xx\n- Gemini web search now injects Antigravity system instruction and aligned request metadata (`requestType`, `userAgent`, `requestId`) for Antigravity credentials\n- `buildGeminiRequestTools()` helper for composable Gemini tool configuration (googleSearch, codeExecution, urlContext)\n- Web search schema exposes `max_tokens`, `temperature`, and `num_search_results` as tool parameters\n- Web search provider fallback: when an explicit provider is unavailable, resolves the auto chain instead of returning empty results\n\n### Changed\n\n- Simplified `resolve` tool output rendering to use inline highlighted format instead of boxed layout\n- Updated `resolve` tool to parse source tool name from label using colon separator for cleaner display\n- `resolve` tool is now conditionally injected: included only when at least one active tool has `deferrable: true` (previously always included)\n- `discoverAndLoadCustomTools` / `loadCustomTools` accept an optional `pendingActionStore` parameter to wire `pushPendingAction` for custom tools\n- AST edit tool no longer accepts `preview` parameter; all AST edit calls now return previews by default\n- AST edit workflow changed: preview is always shown, then use `resolve` tool to apply or discard changes\n- Agent now suggests calling `resolve` tool after AST edit preview with system reminder\n- `ast_grep`: `include_meta` parameter removed; metavariable captures are now always included in output\n- `ast_edit`: `dry_run` renamed to `preview`; `max_files` removed from schema and capped globally via `$PI_MAX_AST_FILES` (default 1000); `max_replacements` renamed to `limit`\n- `ast_grep` and `ast_edit`: parse errors in tool output are now capped at `PARSE_ERRORS_LIMIT` (20); excess errors are summarised as `N / total parse issues` rather than flooding the context\n- Updated `ast_grep` and `ast_edit` tool prompt examples to use concise, idiomatic patterns\n\n### Removed\n\n- Removed `normativeRewrite` setting that rewrote tool call arguments to normalized format in session history\n- Removed `buildNormativeUpdateInput()` helper and normative patch transformation logic\n\n### Fixed\n\n- `ast_edit` no longer rejects empty `out` values; an empty string now deletes matched nodes\n- `ast_edit` no longer trims `pat` and `out` values, preserving intentional whitespace\n- `gemini_image` tool: corrected `responseModalities` values from `'Image'`/`'Text'` to uppercase `'IMAGE'`/`'TEXT'` matching the API enum\n\n## [13.3.14] - 2026-02-28\n\n### Added\n\n- Expanded AST tool language support from 7 to all 25 ast-grep tree-sitter languages (Bash, C, C++, C#, CSS, Elixir, Go, Haskell, HCL, HTML, Java, JavaScript, JSON, Kotlin, Lua, Nix, PHP, Python, Ruby, Rust, Scala, Solidity, Swift, TSX, TypeScript, YAML)\n- AST find now emits all lines of multiline matches with hashline tags (LINE#HASH:content) consistent with read/grep output\n- Added AST pattern syntax reference (metavariables, wildcards, variadics) to system prompt\n- Added examples and scoping guidance to ast-find and ast-replace tool prompts\n- Added `provider-schema-compatibility.test.ts`: integration test that instantiates every builtin and hidden tool, runs their parameter schemas through `adaptSchemaForStrict`, `sanitizeSchemaForGoogle`, and `prepareSchemaForCCA`, and asserts zero violations against each provider's compatibility rules\n\n### Fixed\n\n- Non-code files (.md, .zip, .bin, .gitignore, etc.) are now silently skipped by AST tools instead of producing misleading parse errors\n- Fixed `grep` path wildcard handling so file patterns passed via `path` (for example `schema-review-*.test.ts`) are resolved as glob filters instead of failing path existence checks\n\n## [13.3.11] - 2026-02-28\n\n### Fixed\n\n- Restored inline rendering for `read` tool image results in assistant transcript components, including streaming and rebuilt session history paths.\n- Fixed shell-escaped read paths (for example, pasted `\\ `-escaped screenshot filenames) by resolving unescaped fallback candidates before macOS filename normalization variants.\n\n## [13.3.8] - 2026-02-28\n\n### Added\n\n- Added `ast_find` tool for structural code search using AST matching via ast-grep, enabling syntax-aware pattern discovery across codebases\n- Added `ast_replace` tool for structural AST-aware rewrites via ast-grep, enabling safe syntax-level codemods without text-based fragility\n- Added `astFind.enabled` and `astReplace.enabled` settings to control availability of AST tools\n- Added system prompt guidance to prefer AST tools over bash text manipulation (grep/sed/awk/perl) for syntax-aware operations\n- Extracted prompt formatting logic into reusable `formatPromptContent()` utility with configurable render phases and formatting options\n- Added `type_definition` action to navigate to symbol type definitions with source context\n- Added `implementation` action to find concrete implementations of symbols with source context\n- Added `code_actions` action to list and apply language server code fixes, refactors, and import suggestions\n- Added `symbol` parameter to automatically resolve column position by searching for substring on target line\n- Added `occurrence` parameter to disambiguate repeated `symbol` matches on the same line\n- Added source code context display (3 lines) for definition, type definition, and implementation results\n- Added context display for first 50 references with remaining references shown location-only to balance detail and performance\n- Added support for glob patterns in `file` parameter for diagnostics action (e.g., `src/**/*.ts`)\n- Added `waitForIdle()` method to ensure prompt completion waits for all deferred recovery work (TTSR continuations, context promotions, compaction retries) to fully settle\n- Added `getLastAssistantMessage()` method to retrieve the most recent assistant message from session state without manual array indexing\n- Implemented TTSR resume gate to ensure `prompt()` blocks until TTSR interrupt continuations complete, preventing race conditions between TTSR injections and subsequent prompts\n- Added `tools.maxTimeout` setting to enforce a global timeout ceiling across all tool calls\n\n### Changed\n\n- Replaced `globSync` from `glob` package with native `Bun.Glob` API for glob pattern matching\n- Replaced `fileTypeFromBuffer` from `file-type` package with inline MIME type detection for JPEG, PNG, GIF, and WebP formats\n- Reduced MIME type sniffing buffer size from 4100 bytes to 12 bytes for improved performance\n- Changed mermaid cache key type from `string` to `bigint` for more efficient hashing\n- Replaced `smol-toml` dependency with native `Bun.TOML.parse()` for TOML parsing, reducing external dependencies\n- Replaced `node-html-parser` dependency with `linkedom` for HTML parsing, improving performance and reducing bundle size\n- Updated HTML parsing API calls from `node-html-parser` to `linkedom` across all web scrapers (arXiv, IACR, Go pkg, Read the Docs, Twitter, Wikipedia)\n- Changed element text extraction from `.text` property to `.textContent` property for compatibility with linkedom DOM API\n- Optimized document link extraction to use regex-based parsing with deduplication and a 20-link limit instead of full DOM traversal\n- Unified `path` parameter in ast_find and ast_replace tools to accept files, directories, or glob patterns directly, eliminating the separate `glob` parameter\n- Removed `strictness` parameter from ast_find and ast_replace tools\n- Removed `fail_on_parse_error` parameter from ast_replace tool (now always false)\n- Updated ast_find and ast_replace prompt guidance to clarify that `path` accepts glob patterns and no longer requires separate glob specification\n- Refactored prompt template rendering to use unified `formatPromptContent()` function with phase-aware formatting (pre-render vs post-render)\n- Updated `format-prompts.ts` script to use centralized prompt formatting utility instead of inline implementation\n- Replaced `column` parameter with `symbol` parameter for more intuitive position specification\n- Removed `files` parameter; use glob patterns in `file` parameter instead\n- Removed `end_line` and `end_character` parameters; range operations now use single position\n- Changed `include_declaration` parameter to always be true for references (removed from API)\n- Updated LSP client capabilities to advertise support for `typeDefinition` and `implementation` requests\n- Improved definition results to include source context alongside location information\n- Refactored deferred continuation scheduling to use centralized post-prompt task tracking instead of raw `setTimeout()` calls, improving reliability of concurrent recovery operations\n- Updated subagent executor to explicitly await `waitForIdle()` after each prompt and reminder, ensuring terminal assistant state is determined only after all background work completes\n- Replaced `#waitForRetry()` with `#waitForPostPromptRecovery()` to handle both retry and TTSR resume gates, ensuring prompt completion waits for all post-prompt recovery operations\n- Introduced structured post-prompt recovery task tracking in `AgentSession` and added explicit session completion APIs (`waitForIdle()`, `getLastAssistantMessage()`) for callers that need deterministic turn finalization\n- Updated intent field parameter name from `agent__intent` to `_i` for cleaner tool call contracts\n- Refined intent parameter guidance to require concise 2-6 word sentences in present participle form\n- Centralized per-tool timeout constants and clamping into `tool-timeouts.ts`\n\n### Removed\n\n- Removed `file-type` dependency, reducing external dependencies\n- Removed `glob` dependency in favor of native `Bun.Glob` API\n- Removed `ignore` dependency and ignore file handling utilities\n- Removed `marked` dependency\n- Removed `zod` dependency\n- Removed `ms` and `@types/ms` dev dependencies\n- Removed `rootDir` and `ignoreMatcher` parameters from `loadFilesFromDir()` (kept for API compatibility)\n- Removed `smol-toml` dependency from package.json\n- Removed `node-html-parser` dependency from package.json\n- Removed `files` array parameter for batch file operations\n- Removed `column`, `end_line`, and `end_character` parameters in favor of symbol-based positioning\n- Removed `include_declaration` parameter from references action\n\n### Fixed\n\n- Fixed TTSR violations during subagent execution aborting the entire subagent run; `#waitForPostPromptRecovery()` now also awaits agent idle after TTSR/retry gates resolve, preventing `prompt()` from returning while a fire-and-forget `agent.continue()` is still streaming\n- Fixed deferred TTSR/context-promotion continuations still racing `prompt()` completion by tracking compaction checks and deferred `agent.continue()` tasks under a shared post-prompt recovery orchestrator\n- Fixed subagent reminder/finalization sequencing to await session-level idle recovery between prompts before determining terminal assistant stop state\n- Fixed `code_actions` apply mode to execute command-based actions via `workspace/executeCommand`\n- Fixed diagnostics glob detection to recognize bracket character class patterns (e.g., `src/[ab].ts`)\n- Fixed LSP render metadata sanitization for `symbol` values to prevent tab/newline layout breakage\n- Fixed LSP diagnostics glob requests that appeared stuck by capping glob expansion and shortening per-file diagnostic waits in batch mode\n- Fixed workspace symbol search to query all configured LSP servers and filter out non-matching results\n- Fixed `references`/`rename`/`hover` symbol targeting to error when `symbol` is missing on the line or `occurrence` is out of bounds\n- Fixed `reload` without a file to reload all active configured language servers instead of only the first server\n- Fixed `todo_write` task normalization to auto-activate the first remaining task and include explicit remaining-items output in tool results, removing the need for an immediate follow-up start update\n\n## [13.3.7] - 2026-02-27\n\n### Breaking Changes\n\n- Removed `preloadedSkills` option from `CreateAgentSessionOptions`; skills are no longer inlined into system prompts\n- Removed `skills` field from Task schema; subagents now always inherit the session skill set instead of per-task skill selection\n- Removed Task tool per-task `tasks[].skills` support; subagents now always inherit the session skill set\n- Removed `preloadedSkills` system prompt plumbing and template sections; skills are no longer inlined as a separate preloaded block\n\n### Changed\n\n- Refactored schema reference resolution to inline all `$ref` definitions instead of preserving them at the root level, eliminating unresolved references in tool parameters\n- Added `lenientArgValidation` flag to SubmitResultTool to allow the agent loop to bypass strict argument validation errors\n- Modified schema validation to allow non-conforming output on second validation failure, enabling recovery from strict schema constraints after initial rejection\n- Updated JTD-to-TypeScript conversion to gracefully fall back to 'unknown' type when conversion fails, preventing template rendering errors\n- Changed JTD-to-JSON Schema conversion to normalize nested JTD fragments within JSON Schema nodes, enabling mixed schema definitions\n- Changed output schema validation to gracefully fall back to unconstrained object when schema is invalid, instead of rejecting submissions\n- Changed schema sanitization to remove strict-mode incompatible constraints (minLength, pattern, etc.) from tool parameters while preserving them for runtime validation\n- Simplified task execution to always pass available session skills to subagents instead of resolving per-task skill lists\n- Added `KILO_API_KEY` to CLI environment variable help text for Kilo Gateway provider setup ([#193](https://github.com/can1357/oh-my-pi/issues/193))\n\n### Removed\n\n- Removed preloaded skills section from system prompt templates; skills are now referenced only as available resources\n\n### Fixed\n\n- Fixed schema compilation validation by adding explicit AJV compilation check to catch unresolved `$ref` references and other schema errors before tool execution\n- Fixed handling of circular and deeply nested output schemas to prevent stack overflow and enable successful result submission with fallback unconstrained schema\n- Fixed processing of non-object output schemas (arrays, primitives, booleans) to accept valid result submissions without blocking\n- Fixed handling of mixed JTD and JSON Schema output definitions to properly convert all nested JTD elements (e.g., `elements` \u2192 `items`, `int32` \u2192 `integer`)\n- Fixed strict schema generation for output schemas with only required fields, enabling proper Claude API compatibility\n- Fixed handling of union type schemas (e.g., object|null) to normalize them into strict-mode compatible variants\n\n## [13.3.6] - 2026-02-26\n\n### Breaking Changes\n\n- Changed `submit_result` tool parameter structure from top-level `data` or `error` fields to nested `result` object containing either `result.data` or `result.error`\n\n## [13.3.5] - 2026-02-26\n\n### Added\n\n- Added support for setting array and record configuration values using JSON syntax\n\n### Changed\n\n- Increased default async max jobs limit from 15 to 100 for improved concurrent task handling\n\n### Fixed\n\n- Improved config display formatting to properly render arrays and objects as JSON instead of `[object Object]`\n- Enhanced type display in config list output to show correct type indicators for number, array, and record settings\n\n## [13.3.3] - 2026-02-26\n\n### Added\n\n- Support for `move` parameter in `computeHashlineDiff` to enable file move operations alongside content edits\n\n### Changed\n\n- Modified no-op detection logic to allow move-only operations when file content remains unchanged\n\n## [13.3.1] - 2026-02-26\n\n### Added\n\n- Added `topP` setting to control nucleus sampling cutoff for model output diversity\n- Added `topK` setting to sample from top-K tokens for controlled generation\n- Added `minP` setting to enforce minimum probability threshold for token selection\n- Added `presencePenalty` setting to penalize introduction of already-present tokens\n- Added `repetitionPenalty` setting to penalize repeated tokens in model output\n\n### Fixed\n\n- Fixed skill discovery to continue loading project skills when user skills directory is missing\n\n## [13.3.0] - 2026-02-26\n\n### Breaking Changes\n\n- Renamed `task.isolation.enabled` (boolean) setting to `task.isolation.mode` (enum: `none`, `worktree`, `fuse-overlay`). Existing `true`/`false` values are auto-migrated to `worktree`/`none`.\n\n### Added\n\n- Added `PERPLEXITY_COOKIES` env var for Perplexity web search via session cookies extracted from desktop app\n- Added `fuse-overlay` isolation mode for subagents using `fuse-overlayfs` (copy-on-write overlay, no baseline patch apply needed)\n- Added `task.isolation.merge` setting (`patch` or `branch`) to control how isolated task changes are integrated back. `branch` mode commits each task to a temp branch and cherry-picks for clean commit history\n- Added `task.isolation.commits` setting (`generic` or `ai`) for commit messages on isolated task branches and nested repos. `ai` mode uses a smol model to generate conventional commit messages from diffs\n- Nested non-submodule git repos are now discovered and handled during task isolation (changes captured and applied independently from parent repo)\n- Added `task.eager` setting to encourage the agent to delegate work to subagents by default\n- Added manual OAuth login flow that lets users paste redirect URLs with /login for callback-server providers and prevents overlapping logins\n\n### Fixed\n\n- Fixed nested repo changes being lost when tasks commit inside the isolation (baseline state is now committed before task runs, so delta correctly excludes it)\n- Fixed nested repo patches conflicting when multiple tasks contribute to the same repo (baseline untracked files no longer leak into patches)\n- Nested repo changes are now committed after patch application (previously left as untracked files)\n- Failed tasks no longer create stale branches or capture garbage patches (gated on exit code)\n- Merge failures (e.g. conflicting patches) are now non-fatal \u2014 agent output is preserved with `merge failed` status instead of `failed`\n- Stale branches are cleaned up when `commitToBranch` fails\n- Commit message generator filters lock files from diffs before AI summarization\n\n## [13.2.1] - 2026-02-24\n\n### Fixed\n\n- Fixed changelog tools to enforce category-specific arrays and reuse the shared category list for generation\n- Non-interactive environment variables (pager, editor, prompt suppression) were not applied to non-PTY bash execution, causing commands to potentially block on pagers or prompts\n\n### Changed\n\n- Extracted non-interactive environment config from `bash-interactive.ts` into shared `non-interactive-env.ts` module, applied consistently to all bash execution paths\n\n## [13.2.0] - 2026-02-23\n\n### Breaking Changes\n\n- Made `description` field required in CustomTool interface\n\n## [13.1.2] - 2026-02-23\n\n### Breaking Changes\n\n- Removed `timeout` parameter from await tool\u2014tool now waits indefinitely until jobs complete or the call is aborted\n- Renamed `job_ids` parameter to `jobs` in await tool schema\n- Removed `timedOut` field from await tool result details\n\n## [13.1.1] - 2026-02-23\n\n### Fixed\n\n- Fixed bash internal URL expansion to resolve `local://` targets to concrete filesystem paths, including newly created destination files for commands like `mv src.json local://dest.json`\n- Fixed bash local URL resolution to create missing parent directories under the session local root before command execution, preventing `mv` destination failures for new paths\n\n## [13.1.0] - 2026-02-23\n\n### Breaking Changes\n\n- Renamed `file` parameter to `path` in replace, patch, and hashline edit operations\n\n### Added\n\n- Added clarification in hashline edit documentation that the `end` tag must include closing braces/brackets when replacing blocks to prevent syntax errors\n\n### Changed\n\n- Restructured task tool documentation for clarity, moving parameter definitions into a dedicated section and consolidating guidance on context, assignments, and parallelization\n- Reformatted system prompt template to use markdown headings instead of XML tags for skills, preloaded skills, and rules sections\n- Renamed `deviceScaleFactor` parameter to `device_scale_factor` in browser viewport configuration for consistency with snake_case naming convention\n- Moved intent field documentation from per-tool JSON schema descriptions into a single system prompt block, reducing token overhead proportional to tool count\n\n## [13.0.1] - 2026-02-22\n\n### Changed\n\n- Simplified hashline edit schema to use unified `first`/`last` anchor fields instead of operation-specific field names (`tag`, `before`, `after`)\n- Improved resilience of anchor resolution to degrade gracefully when anchors are missing or invalid, allowing edits to proceed with available anchors\n- Updated hashline tool documentation to reflect new unified anchor syntax across all operations (replace, append, prepend, insert)\n\n## [13.0.0] - 2026-02-22\n\n### Added\n\n- Added `getTodoPhases()` and `setTodoPhases()` methods to ToolSession API for managing todo state programmatically\n- Added `getLatestTodoPhasesFromEntries()` export to retrieve todo phases from session history\n- Added `local://` protocol for session-scoped scratch space to store large intermediate artifacts, subagent handoffs, and reusable planning artifacts\n- Added `title` parameter to `exit_plan_mode` tool to specify the final plan artifact name when approving a plan\n- Added `LocalProtocolHandler` for resolving `local://` URLs to session-scoped file storage\n- Added `renameApprovedPlanFile` function to finalize approved plans with user-specified titles\n\n### Changed\n\n- Changed todo state management from file-based (`todos.json`) to in-memory session cache for improved performance and consistency\n- Changed todo phases to sync from session branch history when branching or rewriting entries\n- Changed `TodoWriteTool` to update session cache instead of writing to disk, with automatic persistence through session entries\n- Changed XML tag from `` to `` in subagent prompts and task rendering\n- Changed system reminder XML tags from underscore to kebab-case format (``)\n- Changed plan storage from `plan://` protocol to `local://PLAN.md` for draft plans and `local://.md` for finalized approved plans\n- Changed plan mode to use session artifacts directory for plan storage instead of separate plans directory\n- Updated system prompt to document `local://` protocol and internal URL expansion behavior\n- Updated `exit_plan_mode` tool documentation to require `title` parameter and explain plan finalization workflow\n- Updated `write` tool documentation to recommend `local://` for large temporary artifacts and subagent handoffs\n- Updated `task` tool documentation to recommend using `local://` for large intermediate outputs in subagent context\n- Replaced `docs://` protocol with `pi://` for accessing embedded documentation files\n- Renamed `DocsProtocolHandler` to `PiProtocolHandler` for internal documentation URL resolution\n- Removed `artifactsDir` parameter from Python executor options; artifact storage now uses `artifactPath` only\n- Renamed prompt file from `read_path.md` to `read-path.md` for consistency\n- Updated system prompt XML tags to use kebab-case (e.g., `system-reminder`, `system-interrupt`) for consistency\n- Refactored bash tool to use `NO_PAGER_ENV` constant for environment variable management\n- Updated internal URL expansion to support optional `noEscape` parameter for unescaped path resolution\n\n### Removed\n\n- Removed `plan://` protocol handler and related plan directory resolution logic\n- Removed `PlanProtocolHandler` and `resolvePlanUrlToPath` exports from internal URLs module\n\n### Fixed\n\n- Fixed todo reminder XML tags from underscore to kebab-case format (`system-reminder`)\n\n## [12.19.3] - 2026-02-22\n\n### Added\n\n- Added `pty` parameter to bash tool to enable PTY mode for commands requiring a real terminal (e.g., sudo, ssh, top, less)\n\n### Changed\n\n- Changed bash tool to use per-command PTY control instead of global virtual terminal setting\n\n### Removed\n\n- Removed `bash.virtualTerminal` setting; use the `pty` parameter on individual bash commands instead\n\n## [12.19.1] - 2026-02-22\n\n### Removed\n\n- Removed `replaceText` edit operation from hashline mode (substring-based text replacement)\n- Removed autocorrect heuristics that attempted to detect and fix line merges and formatting rewrites in hashline edits\n\n## [12.19.0] - 2026-02-22\n\n### Added\n\n- Added `poll_jobs` tool to block until background jobs complete, providing an alternative to polling `read jobs://` in loops\n- Added `task.maxConcurrency` setting to limit the number of concurrently executing subagent tasks\n- Added support for rendering markdown output from Python cells with proper formatting and theme styling\n- Added async background job execution for bash commands and tasks with `async: true` parameter\n- Added `cancel_job` tool to cancel running background jobs\n- Added `jobs://` internal protocol to inspect background job status and results\n- Added `/jobs` slash command to display running and recent background jobs in interactive mode\n- Added `async.enabled` and `async.maxJobs` settings to control background job execution\n- Added background job status indicator in status line showing count of running jobs\n- Added support for GitLab Duo authentication provider\n- Added clearer truncation notices across tools with consistent line/size context and continuation hints\n\n### Changed\n\n- Updated bash and task tool guidance to recommend `poll_jobs` instead of polling `read jobs://` in loops when waiting for async results\n- Improved parallel task execution to schedule multiple background jobs independently instead of batching all tasks into a single job, enabling true concurrent execution\n- Enhanced task progress tracking to report per-task status (pending, running, completed, failed, aborted) with individual timing and token metrics for each background task\n- Updated background task messaging to provide real-time progress counts (e.g., '2/5 finished') and distinguish between single and multiple task jobs\n- Hid internal `agent__intent` parameter from tool argument displays in UI and logs to reduce visual clutter\n- Updated Python tool to detect and handle markdown display output separately from plain text\n- Updated bash tool to support async execution mode with streaming progress updates\n- Updated task tool to support async execution mode for parallel subagent execution\n- Modified subagent settings to disable async execution in child agents to prevent nesting\n- Updated tool execution component to handle background async task state without spinner animation\n- Changed event controller to keep background tool calls pending until async completion\n- Updated status line width calculation to accommodate background job indicator\n- Updated the system prompt pipeline to reduce injected environment noise and make instructions more focused on execution quality\n- Updated system prompt/workflow guidance to emphasize root-cause fixes, code quality, and explicit handoff/testing expectations\n- Changed default value of `todo.reminders` setting from false to true to enable todo reminders by default\n- Improved truncation/output handling for large command results to reduce memory pressure and keep previews responsive\n- Updated internal artifact handling so tool output artifacts stay consistent across session switches and resumes\n\n### Removed\n\n- Removed git context (branch, status, commit history) from system prompt \u2014 version control information is no longer injected into agent instructions\n\n### Fixed\n\n- Fixed task progress display to hide tool count and token metrics when zero, reducing visual clutter in status output\n- Fixed Lobsters scraper to correctly parse API responses where user fields are strings instead of objects, resolving undefined user display in story listings\n- Fixed artifact manager caching to properly invalidate when session file changes, preventing stale artifact references\n- Fixed truncation behavior around UTF-8 boundaries and chunked output accounting\n- Fixed `submit_result` schema generation to use valid JSON Schema when no explicit output schema is provided\n\n## [12.18.1] - 2026-02-21\n\n### Added\n\n- Added Buffer.toBase64() polyfill for Bun compatibility to enable base64 encoding of buffers\n\n## [12.18.0] - 2026-02-21\n\n### Added\n\n- Added `overlay` option to custom UI hooks to display components as bottom-centered overlays instead of replacing the editor\n- Added automatic chat transcript rebuild when returning from custom or debug UI to prevent message duplication\n\n### Changed\n\n- Changed custom UI hook cleanup to conditionally restore editor state only when not using overlay mode\n- Extracted environment variable configuration for non-interactive bash execution into reusable `NO_PAGER_ENV` constant\n- Replaced custom timing instrumentation with logger.timeAsync() and logger.time() from pi-utils for consistent startup profiling\n- Removed PI_DEBUG_STARTUP environment variable in favor of logger.debug() for conditional debug output\n- Consolidated timing calls throughout initialization pipeline to use unified logger-based timing system\n\n### Removed\n\n- Deleted utils/timings.ts module - timing functionality now provided by pi-utils logger\n\n### Fixed\n\n- Fixed potential race condition in bash interactive component where output could be appended after the component was closed\n\n## [12.17.2] - 2026-02-21\n\n### Changed\n\n- Modified bash command normalization to only apply explicit head/tail parameters from tool input, removing automatic extraction from command pipes\n- Updated shell snapshot creation to use explicit timeout and kill signal configuration for more reliable process termination\n\n### Fixed\n\n- Fixed persistent shell session state not being reset after command abort or hard timeout, preventing stale environment variables from affecting subsequent commands\n- Fixed hard timeout handling to properly interrupt long-running commands that exceed the grace period beyond the configured timeout\n\n## [12.17.1] - 2026-02-21\n\n### Added\n\n- Added `filterBrowser` option to filter out browser automation MCP servers when builtin browser tool is enabled\n- Added `isBrowserMCPServer()` function to detect browser automation MCP servers by name, URL, or command patterns\n- Added `filterBrowserMCPServers()` function to remove browser MCP servers from loaded configurations\n- Added `BrowserFilterResult` type for browser MCP server filtering results\n\n## [12.17.0] - 2026-02-21\n\n### Added\n\n- Added timeout protection (5 seconds) for system prompt preparation with graceful fallback to minimal context on timeout\n\n### Changed\n\n- Replaced glob-based AGENTS.md discovery with depth-limited directory traversal (depth 1-4) for improved performance and control\n- Refactored system prompt preparation to parallelize file loading operations with a 5-second timeout to prevent startup hangs\n- Unified `renderCall` signatures to `(args, options, theme)` across all tool renderers and extension types\n\n## [12.16.0] - 2026-02-21\n\n### Added\n\n- Added `peekApiKey` method to AuthStorage for non-blocking API key retrieval during model discovery without triggering OAuth token refresh\n- Exported `finalizeSubprocessOutput` function to handle subprocess output finalization with submit_result validation\n- Exported `SubmitResultItem` interface for type-safe submit_result tool data extraction\n- Added automatic reminders when subagent stops without calling submit_result tool (up to 3 reminders before aborting)\n- Added system warnings when subagent calls submit_result with null/undefined data or exits without calling submit_result after reminders\n\n### Changed\n\n- Changed model refresh behavior to support configurable strategies: uses 'online' mode when listing models and 'online-if-uncached' mode otherwise for improved performance\n- Changed default thinking level from 'off' to 'high' for improved reasoning and planning\n- Changed model discovery to use non-blocking API key peek instead of full key retrieval, improving performance by avoiding unnecessary OAuth token refreshes\n- Simplified submit_result termination logic to immediately abort on successful tool execution instead of waiting for message_end event\n- Updated submit_result tool to only terminate on successful execution (when isError is false), allowing retries on tool errors\n- Refactored subprocess output finalization logic into dedicated `finalizeSubprocessOutput` function for better testability and maintainability\n- Improved handling of missing submit_result calls by automatically aborting with exit code 1 after 3 reminder prompts\n\n### Fixed\n\n- Fixed submit_result retry behavior to properly handle tool execution errors and allow the subagent to retry before aborting\n- Fixed submit_result tool extraction to properly validate status field and only accept 'success' or 'aborted' results\n\n## [12.15.1] - 2026-02-20\n\n### Changed\n\n- Replaced nerd font pie-chart spinner with clock-outline icons for smoother looping\n- Moved status icon to front of code-cell headers in formatHeader\n\n### Fixed\n\n- Fixed ReadToolGroupComponent to show status icon before title instead of trailing\n- Fixed bash-interactive status badge to dim only bracket characters, not the enclosed text\n\n## [12.15.0] - 2026-02-20\n\n### Added\n\n- Added `includeDisabled` parameter to `listAuthCredentials()` to optionally retrieve disabled credentials\n- Added `disableAuthCredential()` method for soft-deleting auth credentials while preserving database records\n\n### Changed\n\n- Changed auth credential removal to use soft-delete (disable) instead of hard-delete when OAuth refresh fails, keeping credentials in database for audit purposes\n- Changed default value of `tools.intentTracing` setting from false to true\n\n## [12.14.1] - 2026-02-19\n\n### Fixed\n\n- Fixed `omp stats` failing on npm/bun installs by including required stats build files in published `@oh-my-pi/omp-stats` package ([#113](https://github.com/can1357/oh-my-pi/pull/113) by [@masonc15](https://github.com/masonc15))\n\n## [12.14.0] - 2026-02-19\n\n### Added\n\n- Support for `docs://` internal URL protocol to access embedded documentation files (e.g., `docs://sdk.md`)\n- Added `generate-docs-index` npm script to automatically index and embed documentation files at build time\n- Support for executable tool files (.ts, .js, .sh, .bash, .py) in custom tools discovery alongside markdown files\n- Display streamed tool intent in working message during agent execution\n- Added `tools.intentTracing` setting to enable intent tracing, which asks the agent to describe the intent of each tool call before executing it\n- Support for file deletion in hashline edit mode via `delete: true` parameter\n- Support for file renaming/moving in hashline edit mode via `rename` parameter\n- Optional content-replace edit variant in hashline mode (enabled via `PI_HL_REPLACETXT=1` environment variable)\n- Support for grepping internal URLs (artifact://) by resolving them to their backing files\n\n### Changed\n\n- System prompt now identifies agent as operating inside Oh My Pi harness and instructs reading docs:// URLs for omp/pi topics\n- Tool discovery now accepts executable script extensions (.ts, .js, .sh, .bash, .py) in addition to .json and .md files\n- Updated bash and read tool documentation to reference `docs://` URL support\n- Hashline format separator changed from pipe (`|`) to colon (`:`) for improved readability (e.g., `LINE#ID:content` instead of `LINE#ID|content`)\n- Hashline hash representation changed from 4-character base36 to 2-character hexadecimal for more compact line references\n- Hashline edit API: renamed `delete` parameter to `rm` for consistency with standard file operations\n- Hashline edit API: renamed `rename` parameter to `mv` for consistency with standard file operations\n- Hashline edit API: content-replace operations now require explicit `op: \"replaceText\"` field to distinguish from other edit types\n- Hashline documentation terminology updated: references to 'anchors' replaced with 'tags' for clearer semantics\n- Intent tracing now uses `_intent` field name in tool schemas\n- Hashline edit API: renamed `set` operation to `target`/`new_content` for clearer semantics\n- Hashline edit API: renamed `set_range` operation to `first`/`last`/`new_content`\n- Hashline edit API: renamed `insert` operation fields from `body` to `inserted_lines` and made `inserted_lines` required non-empty\n- Hashline edit API: flattened `replace` operation to top-level fields (`old_text`, `new_text`, `all`) when enabled\n- Hashline edit validation now provides more specific error messages indicating which variant is expected\n\n### Fixed\n\n- Grep tool now properly handles internal URL resolution when searching artifact paths\n- Working message intent updates now fall back to tool execution events when streamed tool arguments omit the intent field\n\n## [12.13.0] - 2026-02-19\n\n### Breaking Changes\n\n- Removed automatic line relocation when hash references become stale; edits with mismatched line hashes now fail with an error instead of silently relocating to matching lines elsewhere in the file\n\n### Added\n\n- Added `ssh` command for managing SSH host configurations (add, list, remove)\n- Added `/ssh` slash command in interactive mode to manage SSH hosts with subcommands\n- Added support for SSH host configuration at project and user scopes (.omp/ssh.json and ~/.omp/agent/ssh.json)\n- Added `--host`, `--user`, `--port`, `--key`, `--desc`, `--compat`, and `--scope` flags for SSH host configuration\n- Added discovery of SSH hosts from project configuration files alongside manually configured hosts\n- Added NanoGPT as a login provider (`/login nanogpt`) with API key prompt flow linking to `https://nano-gpt.com/api` ([#111](https://github.com/can1357/oh-my-pi/issues/111))\n\n### Changed\n\n- Updated hashline reference format from `LINE:HASH` to `LINE#ID` throughout the codebase for improved clarity\n- Renamed hashline edit operations: `set_line` \u2192 `set`, `replace_lines` \u2192 `set_range`, `insert_after` \u2192 `insert` with support for `before` and `between` anchors\n- Changed hashline edit `body` field from string to array of strings for clearer multiline handling\n- Updated handlebars helpers: renamed `hashline` to `hlineref` and added `hlinefull` for formatted line output\n- Improved insert operation to support `before`, `after`, and `between` (both anchors) positioning modes\n- Made autocorrect heuristics (boundary echo stripping, indent restoration) conditional on `PI_HL_AUTOCORRECT` environment variable\n- Updated SSH host discovery to load from managed omp config paths (.omp/ssh.json and ~/.omp/agent/ssh.json) in addition to legacy root-level ssh.json and .ssh.json files\n- Improved terminal output handling in interactive bash sessions to ensure all queued writes complete before returning results\n\n### Fixed\n\n- Fixed insert-between operation to properly validate adjacent anchor lines and strip boundary echoes from both sides\n- Fixed terminal output handling to properly queue and serialize writes, preventing dropped or corrupted output in interactive bash sessions\n\n## [12.12.1] - 2026-02-19\n\n### Added\n\n- Added Kimi (Moonshot) as a web search provider with OAuth and API key support ([#110](https://github.com/can1357/oh-my-pi/pull/110) by [@oglassdev](https://github.com/oglassdev))\n\n### Changed\n\n- Changed web search auto-resolve priority to prefer Perplexity first\n\n### Fixed\n\n- Fixed Mermaid pre-render failures from repeatedly re-triggering background renders (freeze loop) and restored resilient rendering when diagram conversion/callbacks fail ([#109](https://github.com/can1357/oh-my-pi/issues/109)).\n\n## [12.12.0] - 2026-02-19\n\n### Added\n\n- Display streaming text preview during agent specification generation to show real-time progress\n- Added `onRequestRender` callback to agent dashboard for triggering UI updates during async operations\n- Added agent creation flow (press N in dashboard) to generate custom agents from natural language descriptions\n- Added ability to save generated agents to project or user scope with automatic identifier and system prompt generation\n- Added scope toggle (Tab) during agent creation to choose between project-level and user-level agent storage\n- Added agent regeneration (R key) to refine generated specifications without restarting the creation flow\n- Added model suggestions in model override editor to help users discover available models\n- Added success notices to confirm agent creation and model override updates\n\n### Changed\n\n- Updated agent creation flow to show review screen before generation completes, improving UX feedback\n- Changed generation status hint to display \"Generating...\" while specification is being created\n- Improved system prompt preview formatting with text wrapping and line truncation indicators\n\n### Fixed\n\n- Fixed interactive-mode editor height to stay bounded and resize-aware, preventing off-screen cursor drift during long prompt/history navigation ([#99](https://github.com/can1357/oh-my-pi/issues/99)).\n\n## [12.11.3] - 2026-02-19\n\n### Fixed\n\n- Fixed model selector search initialization to apply the latest live query after asynchronous model loading.\n- Fixed Codex provider session lifecycle on model switches and history rewrites to clear stale session metadata before continuing the conversation.\n\n## [12.11.0] - 2026-02-19\n\n### Added\n\n- Support for Synthetic model provider in web search command\n- Model sorting by priority field and version number in model selector for improved model ranking\n- Support for Synthetic model provider with API key authentication\n- Support for Hugging Face model provider with API key authentication\n- Support for NVIDIA model provider with API key authentication\n- Support for Ollama model provider with optional API key authentication\n- Support for Cloudflare AI Gateway model provider with API key authentication\n- Support for Qwen Portal model provider with API key authentication\n- Support for LiteLLM model provider with API key authentication\n- Support for Moonshot model provider with API key authentication\n- Support for Qianfan model provider with API key authentication\n- Support for Together model provider with API key authentication\n- Support for Venice model provider with API key authentication\n- Support for vLLM model provider with API key authentication\n- Support for Xiaomi model provider with API key authentication\n\n### Changed\n\n- Refactored custom model building logic into reusable `buildCustomModel` function for consistency across provider configurations\n- Replaced generic error with AgentBusyError when attempting to send messages while agent is processing\n- Added automatic retry logic with idle waiting when agent is busy during prompt operations, with 30-second timeout\n\n### Fixed\n\n- Fixed model discovery to use default refresh mode instead of explicit 'online' parameter\n\n## [12.10.1] - 2026-02-18\n\n### Added\n\n- Added `/login` support for Cerebras and Synthetic API-key providers\n\n## [12.10.0] - 2026-02-18\n\n### Breaking Changes\n\n- Changed keyless provider auth sentinel from `\"\"` to `kNoAuth` (`\"N/A\"`) for `ModelRegistry.getApiKey()` and `ModelRegistry.getApiKeyForProvider()`\n\n### Added\n\n- Added `--no-rules` CLI flag to disable rules discovery and loading\n- Added `sessionDir` option to RpcClientOptions for specifying agent session directory\n- Added `Symbol.dispose` method to RpcClient for resource cleanup support\n- Added `rules` option to CreateAgentSessionOptions for explicit rule configuration\n- Added `sessionDir` option to RpcClientOptions for specifying agent session directory\n- Added `Symbol.dispose` method to RpcClient for resource cleanup support\n- Added `condition` and `scope` fields to rule frontmatter for advanced TTSR matching and stream filtering\n- Added `ttsr.interruptMode` setting to control when TTSR rules interrupt mid-stream vs inject warnings after completion\n- Added support for loading rules, prompts, commands, context files (AGENTS.md), and system prompts (SYSTEM.md) from ~/.agent/ directory (with fallback to ~/.agents/)\n- Added scoped stream buffering for TTSR matching to isolate prose, thinking, and tool argument streams\n- Added file-path-aware TTSR scope matching for tool calls with glob patterns (e.g., `tool:edit(*.ts)`)\n- Added legacy field support: `ttsr_trigger` and `ttsrTrigger` are accepted as fallback for `condition`\n\n### Changed\n\n- Changed TTSR injection tracking to record all turns where rules were injected (instead of only the last turn) to support repeat-after-gap mode across resumed sessions\n- Changed TTSR injection messages to use custom message type with metadata instead of synthetic user messages for better session tracking\n- Changed TTSR rule injection to persist injected rule names in session state for restoration when resuming sessions\n- Changed model discovery to automatically discover built-in provider models (Anthropic, OpenAI, Groq, Cerebras, Xai, Mistral, OpenCode, OpenRouter, Vercel AI Gateway, Kimi Code, GitHub Copilot, Google, Cursor, Google Antigravity, Google Gemini CLI, OpenAI Codex) when credentials are configured\n- Changed `getModel()` and `getModels()` imports to `getBundledModel()` and `getBundledModels()` across test utilities\n- Changed TTSR rule matching from single `ttsrTrigger` regex to multiple `condition` patterns with scope filtering\n- Changed TTSR buffer management to use per-stream-key buffers instead of a single global buffer\n- Changed rule discovery to use unified `buildRuleFromMarkdown` helper across all providers (builtin, cline, cursor, windsurf, agents)\n- Changed TTSR injection to defer warnings until stream completion when `interruptMode` is not `always`\n- Changed `TtsrManager.addRule()` to return boolean indicating successful registration instead of void\n\n### Fixed\n\n- Fixed TTSR repeat-after-gap mode to correctly calculate gaps when rules are restored from previous sessions\n- Fixed TTSR matching to respect tool-specific scope filters, preventing cross-tool rule contamination\n- Fixed path normalization in TTSR glob matching to handle both relative and absolute path variants\n\n## [12.9.0] - 2026-02-17\n\n### Added\n\n- Added OpenCode discovery provider to load configuration from ~/.config/opencode/ and .opencode/ directories\n- Added support for loading MCP servers from opencode.json mcp key\n- Added support for loading skills from ~/.config/opencode/skills/ and .opencode/skills/\n- Added support for loading slash commands from ~/.config/opencode/commands/ and .opencode/commands/\n- Added support for loading extension modules (plugins) from ~/.config/opencode/plugins/ and .opencode/plugins/\n- Added support for loading context files (AGENTS.md) from ~/.config/opencode/\n- Added support for loading settings from opencode.json configuration files\n\n### Changed\n\n- Improved path display in status line to strip both `/work/` and `~/Projects/` prefixes when abbreviating paths\n- Refactored session directory naming to use single-dash format for home-relative paths and double-dash format for absolute paths, with automatic migration of legacy session directories on first access\n\n## [12.8.2] - 2026-02-17\n\n### Changed\n\n- Changed system environment context to use built-in `os` values for distro, kernel, and CPU model instead of native system-info data\n- Changed environment info generation to stop including unavailable native system detail fallbacks\n\n### Removed\n\n- Removed the `Disk` field from generated environment information\n\n## [12.8.0] - 2026-02-16\n\n### Changed\n\n- Improved `/changelog` performance by displaying only the most recent 3 versions by default, with a `--full` flag for the complete history ([#85](https://github.com/can1357/oh-my-pi/pull/85) by [@tctev](https://github.com/tctev))\n- Centralized builtin slash command definitions and handlers into a shared registry, replacing the large input-controller if-chain dispatch\n\n## [12.7.5] - 2026-02-16\n\n### Changed\n\n- Updated SMOL_MODEL_PRIORITY to include additional model variants (gpt-5.3-spark, cerebras/zai-glm-4.7, haiku-4-5, haiku-4.5) for improved fast model discovery\n- Updated SLOW_MODEL_PRIORITY to include additional model variants (gpt-5.3-codex, gpt-5.3, gpt-5.1-codex, gpt-5.1, opus-4.6, opus-4-6, opus-4.5, opus-4-5, opus-4.1, opus-4-1) for improved comprehensive model discovery\n\n## [12.7.3] - 2026-02-16\n\n### Fixed\n\n- Suppressed hashline output for subagents without the edit tool (e.g. explore agents)\n\n## [12.7.1] - 2026-02-16\n\n### Changed\n\n- Restructured execution procedure guidance to emphasize scope assessment and continuous tool-driven progress over planning-first approach\n- Updated task tracking instructions to prohibit metadata-only turns and require immediate completion marking of todo items\n- Clarified parallel execution guidance to distinguish between genuine parallelization and sequential work, with explicit criteria for Task tool usage\n- Modified output style requirements to mandate stating intent before tool calls and reordered style constraints for clarity\n- Reinforced requirement that every turn must include at least one tool call advancing the deliverable, with explicit failure condition for planning-only turns\n\n## [12.7.0] - 2026-02-16\n\n### Added\n\n- Added Z.AI web search provider support via remote MCP endpoint (webSearchPrime)\n- Added `zai` as a selectable web search provider option in settings\n- Added Z.AI to automatic provider fallback chain for web search\n\n## [12.6.0] - 2026-02-16\n\n### Added\n\n- Added runtime tests covering extension provider registration and deferred model pattern resolution behavior.\n\n### Changed\n\n- Improved welcome screen responsiveness to dynamically show or hide the right column based on available terminal width\n\n### Fixed\n\n- Fixed welcome screen layout to gracefully handle small terminal widths and prevent rendering errors on narrow displays\n- Fixed welcome screen title truncation to prevent overflow when content exceeds available width\n- Fixed deferred `--model` resolution so extension-provided models are matched before fallback selection and unresolved explicit patterns no longer silently fallback.\n\n## [12.5.1] - 2026-02-15\n\n### Added\n\n- Added `repeatToolDescriptions` setting to render full tool descriptions in the system prompt instead of a tool name list\n\n## [12.5.0] - 2026-02-15\n\n### Breaking Changes\n\n- Replaced `theme` setting with `theme.dark` and `theme.light` (auto-migrated)\n\n### Added\n\n- Added `previewTheme()` function for non-destructive theme preview during settings browsing\n- Added animated microphone icon with color cycling during voice recording\n- Added support for discovering skills via symbolic links in skill directories\n- Added `abort_and_prompt` RPC command for atomic abort-and-reprompt without race conditions ([#357](https://github.com/can1357/oh-my-pi/pull/357))\n- Added automatic dark/light theme switching via SIGWINCH with separate `theme.dark`/`theme.light` settings, replacing the single `theme` setting ([#65](https://github.com/can1357/oh-my-pi/issues/65))\n- Added speech-to-text (STT) feature with `Alt+H` keybinding and `/stt` slash command\n- Added cross-platform audio recording: SoX, FFmpeg, arecord (Linux), PowerShell mciSendString (Windows fallback)\n- Added recording tool fallback chain \u2014 automatically tries each available tool in order\n- Added Python openai-whisper integration for transcription with automatic `pip install`\n- Added custom WAV-to-numpy pipeline in `transcribe.py` bypassing ffmpeg dependency\n- Added STT settings: `stt.enabled`, `stt.language`, `stt.modelName`\n- Added STT status line segment showing recording/transcribing state\n- Added `/stt` command with `on`, `off`, `status`, `setup` subcommands\n- Added auto-download of recording tools (best-effort FFmpeg via winget on Windows)\n- Added interactive debug log viewer with selection, copy, and expand/collapse controls\n- Added inline filtering and count display to the debug log viewer\n- Added pid filter toggle and load-older pagination controls to the debug log viewer\n- Enabled loading older debug logs from archived files in viewer\n- Added file hyperlinks for debug report paths in viewer\n\n### Changed\n\n- Changed theme preview to support asynchronous theme loading with request deduplication to prevent race conditions\n- Enhanced theme preview cancellation to restore the previously active theme instead of the last selected value\n- Refactored file discovery to use native glob with gitignore support instead of manual directory traversal, improving performance and consistency\n- Updated dependencies: glob to ^13.0.3, marked to ^17.0.2, puppeteer to ^24.37.3\n- Optimized skill and file discovery using native glob (Rust ignore crate) \u2014 reduces startup time by ~80% (1254ms \u2192 6ms for skills)\n- Enhanced hashline reference parsing to handle prefixes like `>>>` and `>>` in line references\n- Strengthened type safety in hashline edit formatting with defensive null checks for incomplete edits\n- Changed STT status messages to display via state change callbacks instead of explicit status calls\n- Changed cursor visibility behavior during voice recording to hide hardware and terminal cursors\n\n### Removed\n\n- Removed dedicated STT status line segment in favor of animated cursor-based feedback\n\n### Fixed\n\n- Fixed theme preview updates being applied out-of-order when rapidly browsing theme options\n- Fixed skill discovery to correctly extract skill names from directory paths when frontmatter name is missing\n- Fixed `session.abort()` not clearing `promptInFlight` flag due to microtask ordering, which blocked subsequent prompts\n- Sanitized debug log display to strip control codes, normalize tabs, and trim width\n\n## [12.4.0] - 2026-02-14\n\n### Changed\n\n- Moved `sanitizeText` function from `@oh-my-pi/pi-utils` to `@oh-my-pi/pi-natives` for better code organization\n- Replaced internal `#normalizeOutput` methods with `sanitizeText` utility function in bash and Python execution components\n- Added line length clamping (4000 characters) to bash and Python execution output to prevent display of excessively long lines\n- Modified memory storage to isolate memories by project working directory, preventing cross-project memory contamination\n\n### Fixed\n\n- Fixed bash interactive tool to gracefully handle malformed output chunks by normalizing them before display\n- Fixed fetch tool incorrectly treating HTML content as plain text or markdown\n- Fixed output truncation notice displaying incorrect byte limit when maxBytes differs from outputBytes\n- Fixed Cloudflare returning corrupted bytes when compression is negotiated in web scraper requests\n\n## [12.3.0] - 2026-02-14\n\n### Added\n\n- Added autonomous memory extraction and consolidation system with configurable settings\n- Added `/memory` slash command with subcommands: `view`, `clear`, `reset`, `enqueue`, `rebuild`\n- Added memory injection payload that automatically includes learned context in system prompts\n- Added two-phase memory pipeline: Stage 1 extracts durable knowledge from session history, Phase 2 consolidates into reusable skills and guidance\n- Added memory storage layer with SQLite-backed job queue for distributed memory processing\n- Added configurable memory settings: concurrency limits, lease timeouts, token budgets, and rollout age constraints\n\n### Changed\n\n- Modified system prompt building to inject memory guidance when memories are enabled\n- Changed `resolvePromptInput` to handle multiline input and improve error handling for file reads\n\n## [12.2.0] - 2026-02-13\n\n### Added\n\n- Added `providerSessionState` property to AgentSession for managing provider-scoped transport and session caches\n- Added automatic cleanup of provider session state resources on session disposal\n- Added `providers.openaiWebsockets` setting to prefer websocket transport for OpenAI Codex models\n- Added provider details display in session info showing authentication mode, transport, and connection settings\n- Added automatic prewarm of OpenAI Codex websocket connections on session creation for improved performance\n- Added real-time authentication validation in OAuth provider selector with visual status indicators (checking, valid, invalid)\n- Added `validateAuth` and `requestRender` options to OAuthSelectorComponent for custom authentication validation and UI refresh callbacks\n\n### Changed\n\n- Changed `providers.openaiWebsockets` setting from boolean to enum with values \"auto\", \"off\", \"on\" for more granular websocket policy control (auto uses model defaults, on forces websocket, off disables it)\n- Enhanced provider details display to include live provider session state information\n- Enhanced session info output to display active provider configuration and authentication details\n- Replaced `process.cwd()` with `getProjectDir()` throughout codebase for improved project directory detection and handling\n- Made `SessionManager.list()` async to support asynchronous session discovery operations\n- Preserved internal whitespace and indentation in bash command normalization to support heredocs and indentation-sensitive scripts\n- Improved git context loading performance with configurable timeouts and parallel status/commit queries\n- Enhanced git context reliability with better error handling for timeout and command failures\n- Changed OAuth provider selector to display live authentication status instead of static login state\n- Changed logout flow to refresh OAuth provider authentication state before showing selector\n\n### Fixed\n\n- Improved error reporting in fetch tool to include HTTP status codes when URL fetching fails\n- Fixed fetch tool to preserve actual response metadata (finalUrl, contentType) instead of defaults when requests fail\n\n## [12.1.0] - 2026-02-13\n\n### Added\n\n- Filesystem scan cache invalidation helpers (`invalidateFsScanAfterWrite`, `invalidateFsScanAfterDelete`, `invalidateFsScanAfterRename`) to properly invalidate shared caches after file mutations\n- Named discovery profile for file mention candidates to standardize cache visibility and ignore semantics across callers\n- Comprehensive `models.yml` provider integration guide documenting custom model registration, provider overrides, API adapters, merge behavior, and practical integration patterns for Ollama, vLLM, LM Studio, and proxy endpoints\n- Claude Code marketplace plugin discovery: automatically loads skills, commands, hooks, tools, and agents from `~/.claude/plugins/cache/` based on `installed_plugins.json` registry ([#48](https://github.com/can1357/oh-my-pi/issues/48))\n\n### Changed\n\n- Moved directory path utilities from `src/config.ts` to `@oh-my-pi/pi-utils/dirs` for shared use across packages\n- Updated imports throughout codebase to use centralized directory path functions from `@oh-my-pi/pi-utils/dirs`\n- Updated interactive bash terminal UI label from 'InteractiveTerm' to 'Console' for clarity\n- Enhanced bash execution environment with comprehensive non-interactive defaults for pagers, editors, and package managers to prevent command blocking and interactive prompts\n- Updated custom models configuration to use `~/.omp/agent/models.yml` (YAML format) while maintaining backward compatibility with legacy `models.json`\n\n## [12.0.0] - 2026-02-12\n\n### Added\n\n- Added `getAllServerNames()` method to MCPManager for enumerating all known servers\n\n### Changed\n\n- Changed default edit mode from `patch` to `hashline` for more precise code modifications\n- Changed `readHashLines` setting default from false to true to enable hash line reading by default\n\n### Fixed\n\n- Fixed `omp setup` crashing with uncaught exception when no component argument provided; now shows help ([#35](https://github.com/can1357/oh-my-pi/issues/35))\n- Fixed `/mcp list` showing \"No MCP servers configured\" when servers are loaded from discovery sources like `.claude.json`, `.cursor/mcp.json`, `.vscode/mcp.json` ([#34](https://github.com/can1357/oh-my-pi/issues/34))\n- Fixed model selector sorting to show newest models first within each provider instead of alphabetical; `-latest` aliases now appear before dated versions ([#37](https://github.com/can1357/oh-my-pi/issues/37))\n\n## [11.14.4] - 2026-02-12\n\n### Added\n\n- Exported `renderPromptTemplate` function for programmatic prompt template rendering\n- Exported `computeLineHash` function from patch utilities\n- Added `./cli` export path for direct CLI module access\n\n### Changed\n\n- Replaced jsdom with linkedom for improved HTML parsing performance and reduced memory footprint\n\n### Removed\n\n- Removed @types/jsdom dependency\n\n## [11.14.1] - 2026-02-12\n\n### Changed\n\n- Improved Bun binary detection to check `Bun.env.PI_COMPILED` environment variable\n- Enhanced Bun package manager update to install specific version instead of latest\n- Added post-update verification for Bun installations to warn if expected version was not installed\n\n### Fixed\n\n- Fixed Bun update process to properly handle version pinning and report installation mismatches\n\n## [11.14.0] - 2026-02-12\n\n### Added\n\n- Added SwiftLint linter client with JSON reporter support for Swift file linting\n- Added `--no-pty` flag to disable PTY-based interactive bash execution\n- Added `PI_NO_PTY` environment variable to disable PTY-based interactive bash execution\n- Added `bash.virtualTerminal` setting to control PTY-backed interactive execution for bash commands\n- Added interactive PTY-based bash execution with real-time terminal rendering and input forwarding\n- Added sourcekit-lsp language server support for Swift files\n\n### Changed\n\n- Changed `bash.virtualTerminal` default from `on` to `off` for standard non-interactive bash execution\n- Changed SwiftLint configuration to use `lint` command with JSON reporter instead of `analyze` for improved diagnostic parsing\n- Changed diff line format from space-separated (`+123 content`) to pipe-delimited (`+123|content`) for improved parsing reliability\n- Changed bash tool to use interactive PTY execution by default when UI is available, falling back to standard execution when disabled\n\n## [11.13.1] - 2026-02-12\n\n### Added\n\n- Added `/move` slash command to move session to a different working directory\n- Added `moveTo()` method to SessionManager for relocating sessions with file migration and header updates\n- Added `refreshSlashCommandState()` method to reload slash commands and autocomplete when working directory changes\n- Added `setSlashCommands()` method to AgentSession for updating file-based slash commands\n- Added OAuth authentication support for Perplexity web search via `www.perplexity.ai/rest/sse/perplexity_ask` endpoint\n- Added automatic OAuth token refresh with 5-minute expiry buffer for Perplexity authentication\n- Added `authMode` field to search responses to indicate authentication method used (oauth or api_key)\n- Added display of authentication mode in search result output\n- Added support for streaming SSE responses from Perplexity OAuth API with proper event merging\n\n### Changed\n\n- Changed Perplexity provider to support both API key and OAuth authentication methods\n- Changed `isAvailable()` method to async to check for both API key and OAuth token availability\n- Changed error message to guide users to set PERPLEXITY_API_KEY or login via OAuth\n- Changed `callPerplexity` to `callPerplexityApi` to clarify it uses the API key endpoint\n\n## [11.13.0] - 2026-02-12\n\n### Breaking Changes\n\n- Removed support for `.pi` configuration directory alias; use `.omp` instead\n\n### Added\n\n- Added `openPath` utility function to centralize cross-platform URL and file path opening\n\n### Changed\n\n- Refactored browser/file opening across multiple modules to use unified `openPath` utility for improved maintainability\n\n## [11.12.0] - 2026-02-11\n\n### Added\n\n- Added `resolveFileDisplayMode` utility to centralize file display mode resolution across tools (read, grep, file mentions)\n- Added automatic hashline formatting to @file mentions when hashline mode is active\n- Added `replace` hashline edit operation for substr-style fuzzy text replacement without line references, with optional `all` flag for replace-all behavior\n- Added `noopEdits` array to `applyHashlineEdits` return value to report edits that produced no changes, including edit index, location, and current content for diagnostics\n- Added validation to detect and reject hashline edits using wrong-format fields (`old_text`/`new_text` from replace mode, `diff` from patch mode) with helpful error messages\n- Added `additionalProperties: true` to all hashline edit schemas (`single`, `range`, `insertAfter`, and root) to tolerate extra fields from models\n- Added whitespace normalization in line reference parsing to tolerate spaces around colons (e.g., `5 : ab` now parses as `5:ab`)\n- Added `remaps` property to `HashlineMismatchError` providing quick-fix mapping of stale line references to corrected hashes\n- Added warnings detection in `applyHashlineEdits` to alert users when edits affect significantly more lines than expected, indicating possible unintended reformatting\n- Added diagnostic output showing target line content when an edit produces no changes, helping users identify hash mismatches or incorrect replacement content\n- Added `{{hashline}}` Handlebars helper to compute accurate `LINE:HASH` references for prompt examples and documentation\n- Added deduplication of identical hashline edits targeting the same line(s) in a single call\n- Added `replacement` as accepted alias for `content` in `insertAfter` operations\n- Added graceful degradation of `range` edits with missing `end` field to single-line edits\n- Added `additionalProperties: true` to hashline edit schemas to tolerate extra fields from models\n\n### Changed\n\n- Reverted hashline display format from `LINE:HASH  content` (two spaces) back to `LINE:HASH|content` (pipe separator) for consistency with legacy format\n- Changed hashline display format from `LINE:HASH| content` to `LINE:HASH  content` (two spaces instead of pipe separator) for improved readability\n- Removed `lines` and `hashes` parameters from `read` tool\u2014file display mode (line numbers, hashlines) now determined automatically by settings and edit mode\n- Simplified `read` tool prompt to reflect automatic display mode detection based on configuration\n- Updated `grep` tool to respect file display mode settings, showing hashline-prefixed output when hashline mode is active\n- Renamed hashline edit operation keys from `single`/`range`/`insertAfter` to `set_line`/`replace_lines`/`insert_after` for clearer semantics\n- Renamed hashline edit fields: `loc` \u2192 `anchor`, `replacement` \u2192 `new_text`, `content` \u2192 `text` for consistency across all operation types\n- Separated hashline anchor-based edits (`set_line`, `replace_lines`, `insert_after`) from content-replace edits (`replace`) in application pipeline\n- Improved no-op edit diagnostics to use `noopEdits` array from `applyHashlineEdits`, providing precise line-by-line comparison when replacements match current content\n- Enhanced error messages for wrong-format hashline edits to guide users toward correct operation syntax\n- Strengthened hashline prompt guidance to emphasize that `replacement` must differ from current line content and clarify no-op error recovery procedures\n- Improved hashline prompt to clarify atomicity: all edits in one call are validated against the original file state, with line numbers and hashes referring to the pre-edit state\n- Added explicit instruction in hashline prompt to preserve exact whitespace and formatting when replacing lines, changing only the targeted token/expression\n- Added guidance in hashline prompt for swap operations: use two `single` operations in one call rather than attempting to account for line number shifts\n- Strengthened anti-reformatting instructions in hashline prompt to reduce formatting-only failures\n- Improved no-op error recovery guidance in hashline prompt to prevent infinite retry loops\n- Renamed hashline edit operation keys from `replaceLine`/`replaceLines` to `single`/`range` for clearer semantics\n- Renamed hashline edit field `content` to `replacement` in `single` and `range` operations to distinguish from `insertAfter.content`\n- Improved no-op edit diagnostics to show specific line-by-line comparisons when replacements match current content, helping users identify hash mismatches or formatting issues\n- Enhanced no-op error messages to distinguish between literally identical replacements and content normalized back by heuristics\n- Reverted hash algorithm from 3-character base-36 back to 2-character hexadecimal for line references\n- Enhanced range validation during hashline edits to detect and reject relocations that change the scope of affected lines\n- Improved wrapped-line restoration logic to only attempt merging when source lines exhibit continuation patterns\n- Updated hashline tool documentation to emphasize direction-locking mutations and clarify recovery procedures for hash mismatches\n- Changed `applyHashlineEdits` return type to include optional `warnings` array for reporting suspicious edit patterns\n- Improved hash relocation logic to recompute touched lines after hash-based line number adjustments, preventing incorrect merge heuristics\n- Enhanced error messages for no-op edits to include preview of target lines with their current hashes and content\n- Changed hashline edit format from `src`/`dst` object structure to direct operation schemas (`replaceLine`, `replaceLines`, `insertAfter`)\n- Changed hash algorithm from 2-character hexadecimal to 3-character base-36 alphanumeric for improved readability and collision resistance\n- Improved hash mismatch handling to automatically relocate stale line references when the hash uniquely identifies a moved line\n- Changed `HashlineEdit` from `src`/`dst` format to direct operation schemas: `replaceLine`, `replaceLines`, `insertAfter`\n- Changed hash algorithm from hexadecimal (base-16) to base-36 alphanumeric for shorter, more readable line references\n- Increased maximum wrapped-line restoration from 6 to 10 lines to handle longer reflowed statements\n- Updated prompt examples to use `{{hashline}}` Handlebars helper for generating correct line references in tool instructions\n\n### Removed\n\n- Removed `insertBefore` hashline edit operation for inserting content before a line\n- Removed `substr` hashline edit operation for substring-based line replacement\n- Removed `insertBefore` and `substr` hashline edit variants\n\n### Fixed\n\n- Fixed `parseLineRef` to handle both legacy pipe-separator format (`LINE:HASH| content`) and new two-space format (`LINE:HASH  content`) for backward compatibility\n- Fixed resource leak in browser query handler by properly disposing owned proxy elements for non-winning candidates\n- Fixed script evaluation to support async functions and await expressions in browser evaluate operations\n- Fixed `range` edits with missing `end` field to gracefully degrade to single-line edits instead of crashing\n- Fixed `insertAfter` operations to accept both `content` and `replacement` field names for consistency with other edit types\n- Fixed deduplication logic to correctly identify and remove identical hashline edits targeting the same line(s) in a single call\n- Fixed range-based edits to prevent invalid mutations when hash relocation changes the number of lines in the target range\n- Fixed multi-edit application to use original file state for all anchor references, preventing incorrect line numbers when earlier edits change file length\n\n## [11.10.4] - 2026-02-10\n\n### Added\n\n- Hashline diff computation with `computeHashlineDiff` function for preview rendering of hashline-mode edits\n- Streaming preview display for hashline edits in tool execution UI showing edit sources and destinations\n- Streaming hash line computation with progress updates via `onUpdate` callback in read tool\n- Optional `onCollectedLine` callback parameter to `streamLinesFromFile` for line collection tracking\n\n### Changed\n\n- Edit tool renderer now displays computed preview diffs for hashline operations before execution\n- Read tool now streams hash lines incrementally instead of computing them all at once, improving responsiveness for large files\n- Refactored hash line formatting to use async `streamHashLinesFromLines` for better performance\n\n## [11.10.3] - 2026-02-10\n\n### Added\n\n- Exported `./patch/*` subpath for direct access to patch utilities\n\n## [11.10.2] - 2026-02-10\n\n### Added\n\n- Exported `streamHashLinesFromUtf8` and `streamHashLinesFromLines` functions for streaming hashline-formatted output with configurable chunking\n- Added `HashlineStreamOptions` interface to control streaming behavior (startLine, maxChunkLines, maxChunkBytes)\n- Added `streamHashLinesFromUtf8` function to incrementally format content with hash lines from a UTF-8 byte stream\n- Added `streamHashLinesFromLines` function to incrementally format content with hash lines from an iterable of lines\n\n### Changed\n\n- Updated hashline format to use 2-character hex hashes instead of 4-character hashes for more compact line references\n- Modified `computeLineHash` to normalize whitespace in line content and removed line number from hash seed for consistency\n- Improved CLI argument parsing to explicitly handle `--help`, `--version`, and subcommand detection instead of prefix-based routing\n\n### Removed\n\n- Removed `@types/diff` dev dependency\n- Removed AggregateError unwrapping from console.warn in CLI initialization\n\n## [11.10.1] - 2026-02-10\n\n### Changed\n\n- Migrated CLI framework from oclif to lightweight pi-utils CLI runner\n- Replaced oclif command registration with explicit command entries in cli.ts\n- Changed default root command name from 'index' to 'launch'\n- Updated all command imports to use @oh-my-pi/pi-utils/cli instead of @oclif/core\n\n### Removed\n\n- Removed @oclif/core and @oclif/plugin-autocomplete dependencies\n- Removed oclif configuration from package.json\n- Removed custom oclif help renderer (oclif-help.ts)\n\n## [11.10.0] - 2026-02-10\n\n### Breaking Changes\n\n- Changed `HashlineEdit.src` from string format (e.g., `\"5:ab\"`, `\"5:ab..9:ef\"`) to structured `SrcSpec` object with discriminated union types (`{ kind: \"single\", ref: \"...\" }`, `{ kind: \"range\", start: \"...\", end: \"...\" }`, etc.)\n- Changed `HashlineEdit` API from `old: string | string[]` / `new: string | string[]` to `src: string` / `dst: string`; src uses range syntax `\"5:ab\"` (single), `\"5:ab..9:ef\"` (range), `\"5:ab..\"` (insert after), or `\"..5:ab\"` (insert before)\n- Removed support for comma and newline-separated line reference lists in hashline edits; use range syntax instead\n- Removed `after` field from `HashlineEdit`; insert-after is now expressed via open range syntax `src: \"5:ab..\"`\n- Changed `HashlineEdit` API from `old: string | string[]` / `new: string | string[]` to `src: string` / `dst: string`; multi-line content uses `\\n`-separated strings, empty string `\"\"` for insert/delete operations\n- Replaced `edit.patchMode` boolean setting with `edit.mode` enum; existing `edit.patchMode: true` configurations should use `edit.mode: patch`\n- Changed `getEditModelVariants()` return type from `Record` to `Record`\n- Removed `after` field from `HashlineEdit`; insert-after is now expressed via open range syntax `src: \"5:ab..\"`\n- Changed `HashlineEdit.src` from newline-separated line ref lists to range syntax: `\"5:ab\"` (single), `\"5:ab..9:ef\"` (range), `\"5:ab..\"` (insert after); comma and newline-separated lists are no longer supported\n\n### Added\n\n- Added substring-based source matching for hashline edits when line reference format is invalid, allowing fallback to unique substring search within the file\n- Added automatic detection and repair of single-line merges where models absorb adjacent lines, preventing content duplication\n- Added normalization of unicode-confusable hyphens (en-dash, em-dash, etc.) to ASCII hyphens when edits would otherwise be no-ops\n- Added heuristics to restore original indentation and preserve wrapped line formatting in hashline edits\n- Added abort signal support to MCP server connection and tool listing operations, allowing requests to be cancelled via Escape key during testing\n- Added `MCPRequestOptions` interface with `signal` property to support request cancellation via AbortSignal\n- Added abort signal support to MCP tool execution, allowing requests to be cancelled via Escape-to-interrupt or other abort mechanisms\n- Added `HashlineMismatchError` class that displays grep-style output with `>>>` markers showing correct `LINE:HASH` references when hash validation fails\n- Added `HashMismatch` type to represent individual hash mismatches with line number, expected hash, and actual hash\n- Added hashline edit mode for line-addressed edits using content hashes (LINE:HASH format) with integrity verification\n- Added `readHashLines` setting to include line hashes in read output for hashline edit mode\n- Added `edit.mode` setting (enum: replace, patch, hashline) to select edit tool variant, replacing `edit.patchMode` boolean\n- Added `hashes` parameter to read tool to output line hashes in format `LINE:HASH| content`\n- Added automatic hash line output when using hashline edit mode or `readHashLines` setting is enabled\n- Added `computeLineHash`, `formatHashLines`, `parseLineRef`, `validateLineRef`, and `applyHashlineEdits` functions for hashline operations\n- Added `HashlineEdit` and `HashlineInput` types for structured hashline edit operations\n- Added `normalizeEditMode` function to validate and normalize edit mode strings\n- Added subcommand definitions for `/mcp` command with 10 subcommands (add, list, remove, test, reauth, unauth, enable, disable, reload, help) including usage hints for argument completion\n- Added inline hint support for slash commands with simple arguments (`/export [path]`, `/compact [focus instructions]`, `/handoff [focus instructions]`)\n- Added subcommand dropdown completion for `/browser` command (headless, visible modes)\n- Added `SubcommandDef` interface for declarative subcommand definitions with name, description, and usage hints\n- Added `subcommands` and `inlineHint` properties to `BuiltinSlashCommand` interface for enhanced command metadata\n- Added `getArgumentCompletions` and `getInlineHint` functions to materialized slash commands for autocomplete and ghost text hints\n- Added `temperature` setting to control sampling temperature (0 = deterministic, 1 = creative, -1 = provider default)\n- Added temperature option selector in settings UI with preset values (Default, 0, 0.2, 0.5, 0.7, 1)\n\n### Changed\n\n- Relaxed comma validation in `src` to allow trailing content after line references (e.g., `14:abexport function foo()`), while still rejecting inputs that appear to contain multiple line refs\n- Improved `parseLineRef` to accept hash prefixes shorter than the full hash length, allowing partial hash matches\n- Enhanced error message for hash mismatches to guide users toward re-reading the file and using updated LINE:HASH references\n- Updated hashline tool documentation to clarify that accidental trailing text after LINE:HASH will be extracted, and to discourage merging multiple lines into single-line replacements\n- Treated same-line ranges (e.g., `5:ab..5:cd`) as single-line replacements instead of range operations\n- Enhanced hashline edit robustness with heuristics to strip anchor line echoes and range boundary echoes that models may copy into replacement content\n- Improved whitespace preservation in hashline edits to handle mismatched line counts using loose matching strategy\n- Strengthened hashline edit validation to reject malformed src specs (embedded newlines, commas, invalid ranges)\n- Enhanced MCP connection timeout handling to properly respect abort signals and distinguish between timeout and user-initiated cancellation\n- Improved MCP test command UI to show cancellation hint (esc to cancel) and handle graceful cancellation without blocking cleanup\n- Updated HTTP transport session termination to use AbortSignal.timeout() for reliable cleanup with timeout protection\n- Enhanced bash executor to properly handle abort signals by registering abort event listeners and cleaning up resources in finally block\n- Improved bash tool error handling to distinguish between user-initiated aborts (via AbortSignal) and other cancellations, throwing ToolAbortError for aborted requests\n- Enhanced MCP request handling to propagate abort signals through HTTP, SSE, and stdio transports with proper cleanup\n- Improved stdio transport request handling to use Promise.withResolvers for cleaner async flow and better abort signal integration\n- Updated HTTP transport to combine operation abort signals with timeout signals using AbortSignal.any() for unified cancellation\n- Modified SSE response parsing to support abort signals and distinguish between timeout and user-initiated cancellation\n- Improved hashline edit robustness by automatically stripping `LINE:HASH|` display prefixes and unified-diff `+` markers that models may copy into replacement content\n- Enhanced replace edits to preserve original whitespace on lines where only whitespace differs, preventing spurious formatting diffs when models reformat code\n- Enhanced system prompt to display tool descriptions alongside tool names for improved clarity on available capabilities\n- Reduced hash length from 4 to 2 hex characters (16-bit hashes) for more concise line references\n- Updated `HashlineEdit` type to accept `string | string[]` for `old` and `new` fields, allowing single-line edits without array wrapping\n- Enhanced `parseLineRef` to strip display-format suffix (e.g., `5:ab| content` \u2192 `5:ab`), allowing models to copy full read output format\n- Improved `validateLineRef` to throw `HashlineMismatchError` with context lines instead of generic error, providing grep-style output with correct hashes\n- Modified hash computation to strip trailing carriage returns before hashing for consistent line hash values\n- Renamed `HashlineEdit` fields from `src`/`dst` to `old`/`new` for clarity in replace, delete, and insert operations\n- Enhanced hash validation in `applyHashlineEdits` to collect all mismatches before throwing, providing comprehensive error reporting with context lines\n- Changed `edit.patchMode` boolean setting to `edit.mode` enum (replace, patch, hashline) with default value patch\n- Changed edit tool to support three modes (replace, patch, hashline) instead of two, with dynamic mode selection based on model and settings\n- Changed read tool to prioritize hash lines over line numbers when both are requested\n- Changed `getEditVariantForModel` to return `EditMode | null` and removed hardcoded Kimi model detection\n- Renamed `settingsInstance` parameter to `settings` in `CreateAgentSessionOptions` for consistency\n- Updated all internal references from `settingsInstance` to `settings` throughout SDK and components\n\n### Fixed\n\n- Fixed substring source matching to reject ambiguous matches and provide helpful error messages showing all occurrences\n- Fixed substring source matching to require exactly one matching line in the file\n- Fixed MCP test command to properly clean up connections even when cancelled or aborted, preventing resource leaks\n\n## [11.9.0] - 2026-02-10\n\n### Added\n\n- Added `/mcp` slash command for runtime MCP server management (add, list, remove, enable, disable, test, reauth)\n- Added interactive multi-step wizard for adding MCP servers with transport auto-detection\n- Added OAuth auto-discovery and authentication flow for MCP servers requiring authorization\n- Added MCP config file writer for persisting server configurations at user and project level\n- Added `enabled` and `timeout` fields to MCP server configuration\n- Added runtime MCP manager reload and active tool registry rebind without restart\n- Added MCP command guide documentation\n\n### Changed\n\n- Replaced `setTimeout` with `Bun.sleep()` for improved performance in file lock retry logic\n- Refactored component invalidation handling to use dedicated helper function for cleaner code\n- Improved error handling in worktree baseline application to use `isEnoent()` utility instead of file existence checks\n- Updated bash tool to use standard Node.js `fs.promises.stat()` with `isEnoent()` error handling\n- Replaced `tmpdir()` named import with `os` namespace import for consistency\n- Migrated logging from `chalk` and `console.error` to structured logger from `@oh-my-pi/pi-utils`\n\n### Fixed\n\n- Improved browser script evaluation to handle both expression and statement forms, fixing evaluation failures for certain script types\n- Fixed unsafe OAuth endpoint extraction that could redirect token exchange to attacker-controlled URLs\n- Fixed PKCE code verifier stored via untyped property; now uses typed private field\n- Fixed refresh token fallback incorrectly using access token when no refresh token provided\n- Fixed MCP config files written with default permissions; now enforces 0o700/0o600 for secret protection\n- Fixed add wizard ignoring user-chosen environment variable name and auth header name\n- Fixed reauth endpoint discovery misclassifying non-OAuth servers as discovery failures\n- Fixed resolved OAuth tokens leaking into connection config, causing cache churn on token rotation\n- Fixed unvalidated type assertions for `enabled`/`timeout` config fields from user-controlled JSON\n- Fixed uncaught exceptions in `/mcp add` quick-add flow crashing the interactive loop\n- Fixed greedy `/mcp` prefix match routing `/mcpfoo` to MCP controller\n- Fixed stdio transport timeout timer leak keeping process alive after request completion\n\n### Removed\n\n- Removed `GrepOperations` interface from public API exports\n- Removed `GrepToolOptions` interface from public API exports\n- Removed unused `_options` parameter from `GrepTool` constructor\n\n## [11.8.1] - 2026-02-10\n\n### Added\n\n- Added current date to system prompt context in YYYY-MM-DD format for date-aware agent reasoning\n- Added file size display in UI when files are skipped due to size limits\n- Added support for gigabyte (GB) file size formatting in truncate utility\n\n### Changed\n\n- Changed skipped file messages to include file size information for better visibility into why files were excluded\n- Changed file processing to skip reading files exceeding 5MB (text) or 25MB (images) and include them as path-only references instead\n- Changed @mention auto-reading to skip files exceeding 5MB (text) or 25MB (images) to prevent out-of-memory issues with large files\n- Clarified that subagents automatically inherit full system prompt including AGENTS.md, context files, and skills \u2014 do not repeat project rules or conventions in task context\n- Updated task context guidance to focus on session-specific information subagents lack, eliminating redundant documentation of project constraints already available to them\n- Refined constraints template to emphasize task-specific rules and session decisions rather than global project conventions\n- Expanded anti-patterns section to explicitly flag redundant context that wastes tokens by repeating AGENTS.md rules, project constraints, and tool preferences\n\n### Fixed\n\n- Fixed bash tool hanging when commands spawn background jobs by properly detecting foreground process completion\n- Fixed bash tool occasionally hanging after command completion when background jobs keep stdout/stderr open\n- Fixed crash when auto-reading @mentions for very large files by skipping content injection with an explicit \"skipped\" note\n- Improved bash tool output draining after foreground completion to reduce tail output truncation\n\n## [11.8.0] - 2026-02-10\n\n### Added\n\n- Added `ctx.reload()` method to extension command context to reload extensions, skills, prompts, and themes from disk\n- Added `ctx.ui.pasteToEditor()` method to paste text into the editor with proper handling (e.g., large paste markers in interactive mode)\n- Added extension UI sub-protocol for RPC mode enabling dialog methods (`select`, `confirm`, `input`, `editor`) and fire-and-forget UI methods via client communication\n- Added support for tilde (`~`) expansion in custom skill directory paths\n- Added example extension demonstrating `ctx.reload()` usage with both command and LLM-callable tool patterns\n\n### Changed\n\n- Changed `ctx.hasUI` behavior: now `true` in RPC mode (previously `false`), with dialog methods working via extension UI sub-protocol\n- Changed warning output for invalid CLI arguments to use structured logging instead of console.error\n- Changed help text to indicate command-specific help is available via ` --help`\n- Changed tool result event handlers to chain like middleware, allowing each handler to see and modify results from previous handlers with partial patch support\n\n### Fixed\n\n- Fixed archive extraction security vulnerability by validating that extracted paths do not escape the extraction directory\n- Fixed archive format validation to reject unsupported formats before extraction attempt\n- Fixed archive extraction error handling to provide clear error messages on failure\n\n## [11.7.0] - 2026-02-07\n\n### Changed\n\n- Enhanced error messages for failed Python cells to include full combined output context instead of just the error message\n- Updated error cell output styling to use error color theme instead of standard tool output color for better visual distinction\n\n### Fixed\n\n- Improved error handling in Python cell execution to preserve and display combined output from previous cells when an error occurs\n- Fixed tab character rendering in Python tool output display to properly format whitespace in cell output and status events\n\n## [11.6.1] - 2026-02-07\n\n### Fixed\n\n- Fixed potential crash when rendering results with undefined details.results\n\n## [11.6.0] - 2026-02-07\n\n### Fixed\n\n- Fixed task tool renderer not sanitizing tabs, causing visual holes in TUI output\n- Fixed task tool expanded view showing redundant `` block that is shared across all tasks\n- Fixed assistant message spacer appearing before tool executions when no visible content follows thinking block\n- Fixed extension runner `emit()` type safety with narrowed event/result types\n- Fixed extension runner `tool_result` event chaining across multiple extensions via dedicated `emitToolResult()`\n- Fixed queued messages not delivered after auto-compaction completes\n\n### Added\n\n- Added `/quit` slash command as alias for `/exit`\n- Added per-model overrides (`modelOverrides`) in `models.json` for customizing built-in model properties\n- Added `mergeCustomModels` to merge custom models with built-ins by provider+id instead of replacing\n\n## [11.5.2] - 2026-02-07\n\n### Fixed\n\n- Fixed TUI crash when ask tool renders long user input exceeding terminal width by using Text component for word wrapping instead of raw line output\n\n## [11.5.0] - 2026-02-06\n\n### Added\n\n- Added terminal breadcrumb tracking to remember the last session per terminal, enabling `--continue` to work correctly with concurrent sessions in different terminals\n\n### Changed\n\n- Changed screenshot format to always use PNG instead of supporting JPEG with quality parameter\n- Changed default extract_readable format from text to markdown\n- Changed screenshot storage to use temporary directory with Snowflake IDs instead of artifacts directory\n- Changed ResizedImage interface to return buffer as Uint8Array with lazy-loaded base64 data getter for improved memory efficiency\n\n### Removed\n\n- Removed JPEG quality parameter from screenshot options\n- Removed format selection for screenshots (now PNG only)\n- Removed ability to save screenshots to custom paths or artifacts directory\n\n## [11.4.1] - 2026-02-06\n\n### Fixed\n\n- Fixed tab character display in error messages and bash tool output by properly replacing tabs with spaces\n\n## [11.4.0] - 2026-02-06\n\n### Added\n\n- Visualize leading whitespace (indentation) in diff output with dim glyphs\u2014tabs display as `\u2192` and spaces as `\u00b7` for improved readability\n\n### Fixed\n\n- Fixed patch applicator to correctly handle context-only hunks (pure context lines between @@ markers) without altering indentation in tab-indented files\n- Fixed indentation conversion logic to infer tab width from space-to-tab patterns using linear regression (ax+b model) when pattern uses spaces and actual file uses tabs\n- Fixed tab character rendering in tool output previews and code cell displays, ensuring tabs are properly converted to spaces for consistent terminal display\n- Fixed `newSession()` to properly await session manager operations, ensuring new session is fully initialized before returning\n- Fixed session formatting to use XML structure for tools and tool invocations instead of YAML, improving compatibility with structured output parsing\n\n## [11.3.0] - 2026-02-06\n\n### Added\n\n- Added resumption hint printed to stderr on session exit showing command to resume the session (e.g., `Resume this session with claude --resume `)\n- New `BlobStore` class for content-addressed storage of large binary data (images) externalized from session files\n- New `getBlobsDir()` function to get path to blob store directory\n- Support for externalizing large images to blob store during session persistence, reducing JSONL file size\n- New blob reference format (`blob:sha256:`) for tracking externalized image data in sessions\n- Exported `ModeChangeEntry` type for tracking agent mode transitions\n- Support for restoring plan mode state when resuming sessions\n- New `appendModeChange()` method in SessionManager to record mode transitions\n- New `mode` and `modeData` fields in SessionContext to track active agent mode\n- Support for `PI_PACKAGE_DIR` environment variable to override package directory (useful for Nix/Guix store paths)\n- New keybindings for session management: `toggleSessionNamedFilter` (Ctrl+N), `newSession`, `tree`, `fork`, and `resume` actions\n- Support for shell command execution in configuration values (API keys, headers) using `!` prefix, with result caching\n- New `clearOnShrink` display setting to control whether empty rows are cleared when content shrinks\n- New `SlashCommandInfo`, `SlashCommandLocation`, and `SlashCommandSource` types for extension slash command discovery\n- New `getCommands()` method in ExtensionAPI to retrieve available slash commands\n- New `switchSession()` action in ExtensionCommandContext to switch between sessions\n- New `SwitchSessionHandler` type for extension session switching handlers\n- New `getSystemPrompt()` method in ExtensionUIContext to access current system prompt\n- New `getToolsExpanded()` and `setToolsExpanded()` methods in ExtensionUIContext for tool output expansion control\n- New `WriteToolCallEvent` type for write tool call events\n- New `isToolCallEventType()` type guard for tool call events\n- Support for image content in RPC `steer` and `followUp` commands\n- New `GitSource` type and `parseGitUrl()` function for parsing git URLs in plugin system\n- Tool input types exported: `BashToolInput`, `FindToolInput`, `GrepToolInput`, `ReadToolInput`, `WriteToolInput`\n- Support for `@` prefix normalization in file paths (strips leading `@` character)\n- New `parentSessionPath` field in SessionInfo to track forked session origins\n- Skill file relative path resolution against skill directory in system prompt\n- Support for Termux/Android package installation guidance for missing tools\n- Support for puppeteer query handlers (aria/, text/, xpath/, pierce/) in selector parameters across all browser actions\n- Automatic normalization of legacy p- prefixed selectors (p-aria/, p-text/, p-xpath/, p-pierce/) to modern puppeteer query handler syntax\n- Improved click action with intelligent element selection that prioritizes visible, actionable candidates and retries until timeout\n- Enhanced actionability checking for click operations, validating visibility, pointer events, opacity, viewport intersection, and element occlusion\n\n### Changed\n\n- Modified `--resume` flag to accept optional session ID or path (e.g., `--resume abc123` or `--resume /path/to/session.jsonl`), with session picker shown when no value provided\n- Consolidated `--session` flag as an alias for `--resume` with value for improved CLI consistency\n- Removed read tool grouping reset logic that was breaking grouping when text or thinking blocks appeared between tool calls\n- Image persistence now externalizes images \u22651KB to content-addressed blob store instead of compressing inline\n- Session loading now automatically resolves blob references back to base64 image data\n- Session forking now resolves blob references in copied entries to ensure data integrity\n- Screenshot tool now automatically compresses images for API content using the same resizing logic as pasted images, reducing payload size while maintaining quality\n- Improved text truncation across tool renderers to respect terminal width constraints and prevent output overflow\n- Enhanced render caching to include width parameter for accurate cache invalidation when terminal width changes\n- HTML export filter now treats `mode_change` entries as settings entries alongside model changes and thinking level changes\n- Replaced ellipsis string (`...`) with Unicode ellipsis character (`\u2026`) throughout UI text and truncation logic for improved typography\n- Improved render performance by introducing caching for tool output blocks and search results to avoid redundant text width and padding computations\n- Enhanced read tool grouping to reset when non-tool content (text/thinking blocks) appears between read calls, preventing unintended coalescing\n- Improved string preview formatting in scalar values to show line counts and truncation indicators for multi-line strings\n- Refactored tool execution component to use shared mutable render state for spinner frames and expansion state, reducing closure overhead\n- Enhanced error handling in tool renderers with logging for renderer failures instead of silent fallbacks\n- Made shell command execution in configuration values asynchronous to prevent blocking the TUI\n- Improved `@` prefix normalization to only strip leading `@` for well-known path syntaxes (absolute paths, home directory, internal URL shorthands) to avoid mangling literal paths\n- Enhanced git URL parsing to strip credentials from repository URLs and validate URL-encoded hash fragments\n- Improved null data handling in task submission to preserve agent output when `submit_result` is called with null/undefined data, enabling fallback text extraction instead of discarding output\n- Updated default model IDs across providers: Claude Sonnet 4.5 \u2192 Claude Opus 4.6, Gemini 2.5 Pro \u2192 Gemini 3 Pro variants, and others\n- Made model definition fields optional with sensible defaults for local models (Ollama, LM Studio, etc.)\n- Modified custom tool execute signature to reorder parameters: `(toolCallId, params, signal, onUpdate, ctx)` instead of `(toolCallId, params, onUpdate, ctx, signal)`\n- Changed `--version` and `--list-models` flags to exit with `process.exit(0)` instead of returning\n- Improved `--export` flag to exit with `process.exit(0)` on success\n- Enhanced tree selector to preserve last selected ID across filter changes\n- Modified tree navigation to use real leaf ID instead of skipping metadata entries\n- Improved footer path truncation logic to prevent invalid truncation at boundary\n- Enhanced model selector to display selected model name when no matches found\n- Improved RPC client `steer()` and `followUp()` methods to accept optional image content\n- Updated extension loader to check for explicit extension entries in root directory before discovering subdirectories\n- Removed line limiting in custom message component when collapsed\n- Improved API key resolution to support shell command execution via `resolveConfigValue()`\n- Enhanced session branching to preserve parent session path reference\n- Updated selector parameter descriptions to document support for CSS selectors and puppeteer query handlers\n- Modified viewport handling in headless mode to respect custom viewport parameters while disabling viewport in headed mode for better window management\n- Improved click action to use specialized text query handler logic with retry mechanism for better reliability with dynamic content\n\n### Fixed\n\n- Fixed background color stability in output blocks when inner content contains SGR reset sequences, preventing background color from being cleared mid-line\n- Fixed spurious ellipsis appended to output lines that were already padded to terminal width by trimming trailing spaces before truncation check\n- Fixed config file parsing to properly handle missing files instead of treating them as errors\n- Fixed truncation indicator in truncate tool to use ellipsis character (\u2026) instead of verbose '[truncated]' suffix\n- Fixed concurrent shell command execution by de-duplicating in-flight requests for the same command\n- Fixed git URL parsing to properly handle URL-encoded characters in hash fragments and reject invalid encodings\n- Fixed task executor to properly handle agents calling `submit_result` with null data by treating it as missing and attempting to extract output from conversation text rather than silently failing\n- Fixed HTML export template to safely handle invalid argument types in tool rendering\n- Fixed path shortening in HTML export to handle non-string paths\n- Fixed custom message rendering to properly display full content without artificial line limits\n- Fixed tree navigation to only restore editor text when editor is empty\n- Fixed session creation to properly track parent session when forking\n- Fixed thinking level initialization to only append change entry for new sessions without existing thinking entries\n- Fixed tool expansion state management to properly propagate through UI context\n- Fixed click action to properly handle text/ query handlers with timeout and retry logic instead of failing immediately\n- Fixed viewport application to only apply when in headless mode or when explicitly requested, preventing conflicts in headed browser mode\n\n### Security\n\n- Added support for shell command execution in configuration values with caching to enable secure credential resolution patterns\n\n## [11.2.1] - 2026-02-05\n\n### Fixed\n\n- Fixed CLI invocation with flags only (e.g. `pi --model=codex`) to route to the default command instead of erroring\n\n## [11.2.0] - 2026-02-05\n\n### Added\n\n- Added `omp commit` command to generate commit messages and update changelogs with `--push`, `--dry-run`, `--no-changelog`, and model override flags\n- Added `omp config` command to manage configuration settings with actions: list, get, set, reset, path\n- Added `omp grep` command to test grep tool with pattern matching, glob filtering, context lines, and output modes\n- Added `omp jupyter` command to manage the shared Jupyter gateway with status and kill actions\n- Added `omp plugin` command to manage plugins with install, uninstall, list, link, doctor, features, config, enable, and disable actions\n- Added `omp setup` command to install dependencies for optional features like Python\n- Added `omp shell` command for interactive shell console with working directory and timeout configuration\n- Added `omp stats` command to view usage statistics with dashboard server, JSON output, and summary options\n- Added `omp update` command to check for and install updates with force and check-only modes\n- Added `omp web-search` command (alias `omp q`) to test web search providers with provider selection, recency filtering, and result limits\n- Migrated CLI from custom argument parser to oclif framework for improved command structure and help system\n- Added `omp q` CLI subcommand for testing web search providers with query, provider, recency, and limit options\n- Added web search provider information API with authentication requirements and provider metadata\n- Added support for `hour` recency filter option in Perplexity web search\n- Support for image file mentions\u2014images are now automatically detected, resized, and attached when referenced with @filepath syntax\n- Image dimension information displayed in file mention UI to show image properties alongside text files\n\n### Changed\n\n- Refactored web search provider system to use individual provider classes in separate files for improved maintainability\n- Moved `SearchProvider` base class and `SearchParams` interface to dedicated `providers/base.ts` module\n- Updated web search execution to pass `maxOutputTokens`, `numSearchResults`, and `temperature` parameters to providers\n- Changed Perplexity search context size from 'high' to 'medium' and added search classifier, reasoning effort, and language preference settings\n- Increased Perplexity default max tokens from 4096 to 8192 for more comprehensive responses\n- Updated Anthropic and Gemini search providers to support `max_tokens` and `temperature` parameters for finer control over response generation\n- Simplified `AuthStorage.create()` to accept direct agent.db path\n- Renamed web search types and exports for consistency: `WebSearchProvider` \u2192 `SearchProviderId`, `WebSearchResponse` \u2192 `SearchResponse`, `WebSearchTool` \u2192 `SearchTool`, and related functions\n- Refactored web search provider system to use centralized provider registry with `getSearchProvider()` and `resolveProviderChain()` for improved provider management\n- Updated web search system prompt to emphasize comprehensive, detailed answers with concrete data and specific examples over brevity\n- Simplified Exa API key discovery to check environment variables only, removing .env file fallback logic\n- Refactored `ModelRegistry` instantiation to use direct constructor instead of `discoverModels()` helper function across codebase\n- Refactored CLI entry point to use oclif command framework instead of custom subcommand routing\n- Reorganized subcommands into individual command files under `src/commands/` directory for better maintainability\n- Updated extension flag handling to parse raw arguments directly instead of using custom flag definitions\n- Refactored web search provider definitions into centralized provider-info module for better maintainability\n- Updated web search result rendering to support long-form answers with text wrapping in CLI mode\n- Removed related questions section from web search result rendering\n- Updated Perplexity API types to support extended message content formats including images, files, and PDFs\n- Updated Perplexity search to use 'pro' search type for improved search quality and relevance\n- File mention messages now support both text content and image attachments, with optional line count for text files\n- Updated file mention processing to respect image auto-resize settings\n\n### Removed\n\n- Removed legacy auth.json file\u2014credentials are stored exclusively in agent.db\n\n### Fixed\n\n- Fixed type handling in model selector error message display to properly convert error objects to strings\n- Fixed web search to use search results when Perplexity API returns no citations, ensuring search results are always available to users\n- Fixed model switches deferred during streaming to apply correctly when the stream completes, preventing model changes from being lost\n- Fixed plan mode toggles during streaming to inject plan-mode context immediately, preventing file edits while in plan mode\n- Fixed plan mode model switches during streaming to defer model changes until the current turn completes\n\n## [11.1.0] - 2026-02-05\n\n### Added\n\n- Added `sortDiagnostics()` utility function to sort diagnostics by severity, location, and message for consistent output ordering\n- Added `task.isolation.enabled` setting to control whether subagents run in isolated git worktrees\n- Added dynamic task schema that conditionally includes `isolated` parameter based on isolation setting\n- Added `openInEditor()` utility function to centralize external editor handling with support for custom file extensions and stdio configuration\n- Added `getEditorCommand()` utility function to retrieve the user's preferred editor from $VISUAL or $EDITOR environment variables\n\n### Changed\n\n- Changed diagnostic output to sort results by severity (errors first), then by file location and message for improved readability\n- Changed task tool to validate isolation setting and reject `isolated` parameter when isolation is disabled\n- Changed task API to use `assignment` field instead of `args` for per-task instructions, with shared `context` prepended to every task\n- Changed task template rendering to use structured context/assignment separation with `` wrapper instead of placeholder-based substitution\n- Changed task item schema to require `assignment` string (complete per-task instructions) instead of optional `args` object\n- Changed `TaskItem` to remove `args` field and add `assignment` field for clearer per-task instruction semantics\n- Changed agent frontmatter to use `thinking-level` field name instead of `thinkingLevel` for consistency\n- Refactored task rendering to display full task text instead of args in progress and result views\n- Changed `SubmenuSettingDef.getOptions()` method to `options` getter property for cleaner API access\n- Converted static option providers from functions to direct array definitions for improved performance\n- Added `createSubmenuSettingDef()` helper function to support both static and dynamic option providers\n- Modified `setThinkingLevel()` API to accept optional `persist` parameter (defaults to false) for controlling whether thinking level changes are saved to settings\n- Refactored hook editor and input controller to use shared external editor utilities, reducing code duplication\n\n### Removed\n\n- Removed `context` parameter from `ExecutorOptions` \u2014 context now prepended at template level before task execution\n- Removed `args` field from `AgentProgress` and `SingleResult` interfaces\n- Removed placeholder-based template rendering in favor of structured context/assignment model\n\n## [11.0.3] - 2026-02-05\n\n### Added\n\n- Added new subcommands to help text: `commit` for AI-assisted git commits, `stats` for AI usage statistics dashboard, and `jupyter` for managing the shared Jupyter gateway\n- Added `grep` subcommand to help text for testing the grep tool\n- Added `browser` tool documentation for browser automation using Puppeteer\n- Added `todo_write` tool documentation for managing todo and task lists\n- Added documentation for additional LLM provider API keys (Groq, Cerebras, xAI, OpenRouter, Mistral, z.ai, MiniMax, OpenCode, Cursor, Vercel AI Gateway) in environment variables reference\n- Added documentation for cloud provider configuration (AWS Bedrock, Google Vertex AI) in environment variables reference\n- Added documentation for search provider API keys (Perplexity, Anthropic Search) in environment variables reference\n- Added documentation for model override environment variables (`PI_SMOL_MODEL`, `PI_SLOW_MODEL`, `PI_PLAN_MODEL`) in CLI help text\n- Added comprehensive environment variables reference documentation at `docs/environment-variables.md` covering API keys, configuration, debugging, and testing variables\n- Added theme system with 44 customizable color tokens, two built-in themes (dark/light), and auto-detection based on terminal background\n- Added `/theme` command to interactively select and switch between themes\n- Added support for custom themes in `~/.pi/agent/themes/*.json` with live editing - changes apply immediately when files are saved\n- Added `userMessageText` theme token for customizing user message text color\n- Added `toolTitle` and `toolOutput` theme tokens for separate coloring of tool execution box titles and output\n\n### Changed\n\n- Updated help text to reflect expanded tool availability - default now enables all tools instead of just read, bash, edit, write\n- Updated available tools list in help documentation to include python, notebook, task, fetch, web_search, browser, and ask\n- Simplified main description in help text from 'AI coding assistant with read, bash, edit, write tools' to 'AI coding assistant'\n- Updated `--tools` option documentation to clarify default behavior and list all available tools\n- Changed all environment variable access from `process.env` to `Bun.env` throughout the codebase for Bun runtime compatibility\n- Updated documentation to reference `Bun.env` instead of `process.env` in examples and comments\n\n### Fixed\n\n- Fixed `Text` component to properly implement `invalidate()` method, ensuring theme changes apply correctly to all UI elements\n- Fixed `TruncatedText` component to properly pad all lines to exactly match the specified width, preventing rendering artifacts\n- Fixed `TruncatedText` component to stop at the first newline and only display the first line\n- Fixed invalid or malformed themes to fall back gracefully to dark theme instead of crashing the application\n\n## [11.0.2] - 2026-02-05\n\n### Fixed\n\n- Fixed role model cycling to expand role aliases (e.g., roles pointing at `pi/plan`) so slow/default/smol cycles resolve correctly\n\n## [11.0.0] - 2026-02-05\n\n### Added\n\n- Added UI dropdown options for `task.maxRecursion Depth` setting with presets (Unlimited, None, Single, Double, Triple)\n- Added UI dropdown options for `grep.contextBefore` setting with presets (0-5 lines)\n- Added UI dropdown options for `grep.contextAfter` setting with presets (0-10 lines)\n- Added `task.maxRecursionDepth` setting to control how many levels deep subagents can spawn their own subagents (0=none, 1=one level, 2=two levels, -1=unlimited)\n- Added support for nested task artifact naming with parent task prefixes (e.g., \"0-Auth.1-Subtask\") to organize hierarchical task outputs\n- Added `taskDepth` and `parentTaskPrefix` options to `CreateAgentSessionOptions` for tracking subagent recursion depth and organizing nested artifacts\n- Added `task.maxConcurrency` setting to control concurrent limit for subagents (default: 32)\n- Added UI options for task concurrency configuration with presets from unlimited to 64 tasks\n- Added support for loading skills from `~/.agents/skills`\n\n### Changed\n\n- Simplified `task.maxRecursionDepth` description in settings UI to remove specific value examples\n- Made thinking level persistence optional via `persist` parameter in `setThinkingLevel()` method, allowing temporary thinking level changes without saving to settings\n- Updated thinking level cycling to no longer persist changes to settings, enabling quick iteration through thinking levels without modifying user preferences\n- Replaced nanoid with Snowflake for ID generation throughout codebase for improved performance and collision resistance\n- Updated session ID format in documentation from nanoid to snowflake hex string (e.g., \"a1b2c3d4e5f60001\")\n- Renamed environment variable prefix from `OMP_` to `PI_` throughout codebase (e.g., `OMP_DEBUG_STARTUP` \u2192 `PI_DEBUG_STARTUP`, `OMP_PYTHON_GATEWAY_URL` \u2192 `PI_PYTHON_GATEWAY_URL`)\n- Removed `env` setting from configuration schema; environment variables are no longer automatically applied from settings\n- Changed `venvPath` property in PythonRuntime from nullable to optional (returns `undefined` instead of `null`)\n- Simplified notification settings from protocol-specific options (bell, osc99, osc9) to simple on/off toggle for `completion.notify` and `ask.notify`\n- Moved notification protocol detection and sending to `TERMINAL` API from local utility functions\n- Changed task tool spawns configuration from \"explore\" to \"*\" to allow subagents to spawn any agent type\n- Changed system prompt to enable parallel delegation guidance for all agents (removed coordinator-only restriction)\n- Changed task tool to automatically disable itself when maximum recursion depth is reached, preventing infinite nesting\n- Changed task concurrency from hardcoded constant to configurable setting via `task.maxConcurrency`\n- Changed concurrency limit calculation to support unlimited concurrency when set to 0\n\n### Removed\n\n- Removed nanoid dependency from package.json\n- Removed `terminal-notify.ts` utility module with `detectNotificationProtocol()`, `sendNotification()`, and `isNotificationSuppressed()` functions\n- Removed `MAX_PARALLEL_TASKS` constant and associated task count validation limit\n\n### Fixed\n\n- Fixed MCP tool name generation to properly sanitize server and tool names, preventing invalid characters and duplicate prefixes in tool identifiers\n- Fixed task ID display formatting to show hierarchical structure for nested tasks (e.g., \"0.1 Auth>Subtask\" instead of \"0-Auth.1-Subtask\")\n- Improved frontmatter parsing error messages to include source context for better debugging\n\n## [10.6.1] - 2026-02-04\n\n### Added\n\n- Added `commit` model role for dedicated commit message generation\n- Exported `resolveModelOverride` function from model resolver for external use\n\n### Changed\n\n- Updated model role resolution to accept optional `roleOrder` parameter for custom role priority\n- Made `tag` and `color` properties optional in `ModelRoleInfo` interface\n- Updated model selector to safely handle roles without tag or color definitions\n- Refactored role label display to use centralized `MODEL_ROLES` registry instead of hardcoded strings\n- Refactored model role system to use centralized `MODEL_ROLES` registry with consistent tag, name, and color definitions\n- Simplified model role resolution to use `MODEL_ROLE_IDS` array instead of hardcoded role checks\n- Updated model selector to dynamically generate menu actions from `MODEL_ROLES` registry\n\n### Removed\n\n- Removed support for `omp/` model role prefix; use `pi/` prefix instead\n\n## [10.6.0] - 2026-02-04\n\n### Breaking Changes\n\n- Removed `output_mode` parameter from grep tool\u2014results now always use content mode with formatted match output\n- Renamed grep context parameters from `context_pre`/`context_post` to `pre`/`post`\n- Removed `n` (show line numbers) parameter\u2014line numbers are now always displayed in grep results\n\n### Added\n\n- Added Jina as a web search provider option alongside Exa, Perplexity, and Anthropic\n- Added support for Jina Reader API integration with automatic provider detection when JINA_API_KEY is configured\n\n### Changed\n\n- Reformatted grep output to display matches grouped by file with numbered match headers and aligned context lines\n- Updated grep output to use `>>` prefix for match lines and aligned spacing for context lines for improved readability\n- Changed multiline matching to automatically enable when pattern contains literal newlines (`\n`)\n- Split grep context parameter into separate `context_pre` and `context_post` options for independent control of lines before and after matches\n- Updated grep tool to use configurable default context settings from `grep.contextBefore` and `grep.contextAfter` configuration\n- Added configurable grep context defaults and reduced the default to 1 line before, 3 lines after\n- Enabled the browser tool by default\n\n### Removed\n\n- Removed `filesWithMatches` and `count` output modes from grep tool\n\n## [10.5.0] - 2026-02-04\n\n### Breaking Changes\n\n- Changed `ask` tool to require `questions` array parameter; single-question mode with `question`, `options`, `multi`, and `recommended` parameters is no longer supported\n- Removed support for local Python kernel gateway startup; shared gateway is now required\n\n### Added\n\n- Added browser tool powered by Ulixee Hero with support for navigation, DOM interaction, screenshots, and readable content extraction\n- Added `/browser` command to toggle browser headless vs visible mode in interactive sessions\n- Added `browser.enabled` and `browser.headless` settings to control browser automation behavior\n- Added Python prelude caching to improve startup performance by storing compiled prelude helpers and module metadata\n- Added `OMP_DEBUG_STARTUP` environment variable for conditional startup performance debugging output\n- Added autonomous memory system with storage, memory tools, and context injection\n\n### Changed\n\n- Updated task tool guidance to enforce small, well-defined task scope with maximum 3-5 files per task to prevent timeouts and improve parallel execution\n- Updated browser viewport to use 1.25x device scale factor for improved rendering on high-DPI displays\n- Modified device pixel ratio detection to respect actual screen capabilities instead of forcing 1x ratio\n- Updated system prompt guidance to state assumptions and proceed without asking for confirmation, reducing unnecessary round-trips\n- Tightened `ask` tool conditions to require multiple approaches with significantly different tradeoffs before prompting user\n- Strengthened `ask` tool guidance to default to action and only ask when genuinely blocked by decisions with materially different outcomes\n- Changed refactor workflow to automatically remove now-unused elements and note removals instead of asking for confirmation\n- Enforced exclusive concurrency mode for all file-modifying tools (edit, write, bash, python, ssh, todo-write) to prevent concurrent execution conflicts\n- Updated `ask` tool guidance to prioritize proactive problem-solving and default to action, asking only when truly blocked by decisions that materially change scope or behavior\n- Changed Python kernel initialization to require shared gateway mode; local gateway startup has been removed\n- Changed shared gateway error handling to retry on server errors (5xx status codes) before failing\n\n### Fixed\n\n- Fixed glob search returning no results when all files are ignored by gitignore by automatically retrying without gitignore filtering\n\n## [10.3.2] - 2026-02-03\n\n### Added\n\n- Added `renderCall` and `renderResult` methods to MCP tools for structured TUI display of tool calls and results\n- Added new `mcp/render.ts` module providing JSON tree rendering for MCP tool output with collapsible/expandable views\n\n### Changed\n\n- Updated `renderResult` signature in custom tools and extensions to accept optional `args` parameter for context-aware rendering\n- Changed environment variable from `ENV_AGENT_DIR` constant to hardcoded `OMP_CODING_AGENT_DIR` string in config and CLI help text\n- Fixed method binding in extension and hook tool wrappers to preserve `this` context for `renderCall` and `renderResult` methods\n\n## [10.3.1] - 2026-02-03\n\n### Fixed\n\n- Fixed timeout handling in LSP write-through operations to properly clear formatter and diagnostics results when operations exceed the 10-second timeout\n\n## [10.3.0] - 2026-02-03\n\n### Removed\n\n- Removed `shellForceBasic` setting that forced bash/sh shell selection\n- Removed `bash.persistentShell` experimental setting for shell session reuse\n\n## [10.2.3] - 2026-02-02\n\n### Added\n\n- Added `find.enabled`, `grep.enabled`, `ls.enabled`, `notebook.enabled`, `fetch.enabled`, `web_search.enabled`, `lsp.enabled`, and `calc.enabled` settings to control availability of individual tools\n- Added conditional tool documentation in system prompt that dynamically lists only enabled specialized tools\n- Added `todos.enabled` setting to control availability of the todo_write tool for task tracking\n- Added `tools` field to agent frontmatter for declaring agent-specific tool capabilities\n\n### Changed\n\n- Consolidated `symbols` action to handle both file-based document symbols and workspace symbol search (query-based)\n- Consolidated `diagnostics` action to handle both single-file and workspace-wide diagnostics (no file = workspace)\n- Simplified `reload` action to gracefully reload language server with fallback to kill\n- Updated LSP tool documentation to reflect simplified operation set and consolidated actions\n- Reorganized settings tabs from 8 to 9 tabs with clearer categorization: Display, Agent, Input, Tools, Config, Services, Bash, LSP, and TTSR\n- Moved behavior-related settings to new Agent tab for better organization\n- Moved input/interaction settings to new Input tab\n- Moved tool configuration settings to new Config tab\n- Moved provider and service settings to new Services tab\n- Added visual icons to settings tabs using theme symbols for improved UI clarity\n- Changed default settings tab from Behavior to Display on startup\n- Updated `read` tool to handle directory paths by returning formatted listings with modification times instead of redirecting to `ls`\n- Updated tool documentation to reflect that `read` now handles both files and directories\n- Updated system prompt tool precedence section to conditionally display only available specialized tools based on enabled settings\n- Renamed todo completion settings from `todoCompletion.*` to `todos.reminders.*` and `todos.enabled` for clearer organization\n- Updated todo reminder logic to check both `todos.reminders` and `todos.enabled` settings independently\n\n### Removed\n\n- Removed Rust-analyzer specific LSP operations: `flycheck`, `expand_macro`, `ssr`, `runnables`, `related_tests`, and `reload_workspace`\n- Removed `workspace_diagnostics` action; use `diagnostics` without file parameter instead\n- Removed `workspace_symbols` action; use `symbols` with query parameter and no file instead\n- Removed `actions`, `incoming_calls`, and `outgoing_calls` LSP operations\n- Removed `replacement`, `kind`, `action_index`, `end_line`, and `end_character` parameters from LSP tool\n- Removed Python prelude helper functions: `pwd()`, `mkdir()`, `ls()`, `head()`, `tail()`, `sh()`, `cat()`, `touch()`, `wc()`, `basenames()`, and `batch()`\n- Removed type guard functions (`isBashToolResult`, `isReadToolResult`, `isEditToolResult`, `isWriteToolResult`, `isGrepToolResult`, `isFindToolResult`, `isLsToolResult`) from public API exports\n- Removed `ls` tool\u2014directory listing is now handled by the `read` tool\n- Removed `ls.enabled` setting and related configuration options\n- Removed `bashInterceptor.simpleLs` setting that redirected simple `ls` commands to the dedicated tool\n- Removed project tree snapshot generation from system prompt (unused feature)\n\n### Fixed\n\n- Fixed tool parameter schemas displaying internal TypeBox metadata fields in system prompt\n\n## [10.2.1] - 2026-02-02\n\n### Breaking Changes\n\n- Removed `strippedRedirect` field from `NormalizedCommand` interface returned by `normalizeBashCommand()`\n- Removed automatic stripping of `2>&1` stderr redirections from bash command normalization\n\n## [10.1.0] - 2026-02-01\n\n### Added\n\n- Added work scheduling profiler to debug menu for analyzing CPU scheduling patterns over the last 30 seconds\n- Added support for work profile data in report bundles including folded stacks, summary, and flamegraph visualization\n\n## [10.0.0] - 2026-02-01\n\n### Added\n\n- Added `shell` subcommand for interactive shell console testing with brush-core\n- Added `--cwd` / `-C` option to set working directory for shell commands\n- Added `--timeout` / `-t` option to configure per-command timeout in milliseconds\n- Added `--no-snapshot` option to skip sourcing snapshot from user shell\n\n### Fixed\n\n- `find` now returns a single match when given a file path instead of failing with \"not a directory\"\n\n## [9.8.0] - 2026-02-01\n\n### Breaking Changes\n\n- Removed persistent shell session support; bash execution now uses native bindings via brush-core for improved reliability\n\n### Added\n\n- Added `sessionKey` option to bash executor to isolate shell sessions per agent instance\n- Added shell snapshot support for bash execution to preserve shell state across commands\n- Added `onChunk` callback support for streaming command output in real-time\n\n### Changed\n\n- Refactored bash executor to queue output chunks asynchronously for improved reliability\n- Updated bash executor to pass environment variables separately as `sessionEnv` to native bindings\n- Migrated system information collection to use native bindings from brush-core instead of shell command execution\n- Updated CPU information to report core count alongside model name\n- Simplified OS version reporting to use Node.js built-in APIs\n- Migrated bash command execution from ptree-based persistent sessions to native shell bindings with streaming support\n- Simplified bash executor to use brush-core native API instead of managing long-lived shell processes\n- Routed clipboard copy and image paste through native arboard bindings instead of shell commands\n- Embedded native addon payload for compiled binaries and extract to `~/.omp/natives/` on first run\n\n### Removed\n\n- Removed shell configuration from environment information display\n- Removed `shell-session.ts` module providing persistent shell session management\n- Removed shell session test suite for persistent execution patterns\n\n## [9.6.2] - 2026-02-01\n\n### Changed\n\n- Replaced hardcoded ellipsis strings with Unicode ellipsis character (\u2026) throughout rendering code\n- Removed `format.ellipsis` symbol from theme configuration; ellipsis now uses literal Unicode character\n- Updated `truncate()` function to `truncateToWidth()` with simplified API accepting default ellipsis parameter\n- Simplified `formatMoreItems()` function signature by removing theme parameter dependency\n\n### Removed\n\n- Removed `format.ellipsis` symbol key from theme symbol maps (Unicode, Nerd, and ASCII presets)\n- Removed `ellipsis` property from `SymbolTheme` type\n\n## [9.6.1] - 2026-02-01\n\n### Fixed\n\n- Fixed output handling to prioritize text/markdown over text/plain when both are available, ensuring Markdown content is displayed correctly\n- Fixed bash command normalization to preserve newlines in heredocs and multiline commands\n\n## [9.6.0] - 2026-02-01\n\n### Breaking Changes\n\n- Replaced `SettingsManager` class with new `Settings` singleton providing sync get/set API with background persistence\n- Changed settings access from method calls (e.g., `getTheme()`) to path-based access (e.g., `settings.get(\"theme\")`)\n- Removed `settingsManager` parameter from `CreateAgentSessionOptions` in favor of `settingsInstance`\n- Removed `loadSettings()` export from public API\n- Removed example file `examples/sdk/10-settings.ts` demonstrating old SettingsManager API\n\n### Added\n\n- New `Settings` singleton class with sync get/set operations and background persistence\n- Added `Settings.isolated()` factory for creating isolated settings instances in tests\n- Added `Settings.init()` for initializing global settings instance\n- Added `settings` global export for convenient access to settings singleton\n- New `settings-schema.ts` providing unified, type-safe settings definitions with UI metadata\n- Added \"none\" option to `doubleEscapeAction` setting to disable double-escape behavior entirely ([#973](https://github.com/badlogic/pi-mono/issues/973) by [@juanibiapina](https://github.com/juanibiapina))\n\n### Changed\n\n- Unified settings schema into single source of truth with `settings-schema.ts` replacing scattered definitions\n- Refactored settings CLI to use new schema-based path resolution instead of SETTINGS_DEFS\n- Updated config command examples to use new nested path syntax (e.g., `compaction.enabled` instead of `autoCompact`)\n- Changed `InteractiveModeContext.settingsManager` to `InteractiveModeContext.settings`\n- Updated all internal settings access throughout codebase to use new `settings.get()` and `settings.set()` API\n- Moved `DEFAULT_BASH_INTERCEPTOR_RULES` from settings-manager to bash-interceptor module\n\n### Removed\n\n- Deleted `settings-manager.ts` (2035 lines) - functionality replaced by new Settings singleton\n- Removed `SettingsManager.create()`, `SettingsManager.acquire()`, and `SettingsManager.inMemory()` factory methods\n- Removed individual getter/setter methods from settings API (e.g., `getTheme()`, `setTheme()`, `getCompactionSettings()`)\n\n### Fixed\n\n- Respect .gitignore, .ignore, and .fdignore files when scanning package resources for skills, prompts, themes, and extensions\n\n## [9.5.1] - 2026-02-01\n\n### Changed\n\n- Changed persistent shell from opt-out to opt-in (default: off) for improved reliability; enable via Settings > Bash > Persistent shell or `OMP_SHELL_PERSIST=1`\n- Added new \"Bash\" settings tab grouping shell-related settings (force basic shell, persistent shell, interceptor, intercept ls)\n\n## [9.5.0] - 2026-02-01\n\n### Added\n\n- Added `head` and `tail` parameters to bash tool to limit output lines without breaking streaming\n- Added automatic normalization of bash commands to extract `| head -n N` and `| tail -n N` patterns into native parameters\n- Added `maxResults` parameter to find tool to limit result set at the native layer\n- Added context-structure template showing required sections (Goal, Constraints, Existing Code, API Contract) with examples of good vs bad context\n- Added explicit dependency test: 'Can agent B write correct code without seeing agent A's output?' to determine sequencing\n- Added detailed phased execution pattern with four phases (Foundation, Parallel Implementation, Integration, Dependent Layer) and WASM-to-N-API migration example\n- Added table of dependency patterns that must be sequential (API creation before bindings, interface definition before implementation, etc.)\n- Added phased execution guidance for migrations and refactors to prevent parallel work on dependent layers\n- Added example demonstrating phased execution pattern for porting WASM to N-API with sequential foundation, parallel implementation, integration, and dependent layer phases\n\n### Changed\n\n- Improved find tool performance by delegating mtime-based sorting to native layer instead of post-processing results in JavaScript\n- Simplified find tool result processing by removing redundant filesystem stat calls when native metadata is available\n- Updated bash tool documentation to recommend using `head` and `tail` parameters instead of piping through head/tail commands\n- Updated binary build process to exclude worker files from compilation, reducing binary size\n- Modified update mechanism to download and install native addon alongside CLI binary for platform-specific functionality\n- Updated find tool to emit streaming match updates via callback, allowing real-time progress feedback during file searches\n- Modified find tool to use native match metadata (mtime, fileType) from WASM layer instead of redundant filesystem stats, improving performance\n- Restructured Task tool documentation to emphasize context quality and explicit API contracts for subagent success\n- Updated task execution guidance to require structured context with Goal, Constraints, Existing Code, and API Contract sections\n- Reorganized parallelization rules with explicit dependency patterns and phased execution guidance for migrations\n- Clarified that response format requirements must go in schema parameter, never in context descriptions\n- Centralized Python runtime resolution into shared `ipy/runtime.ts` module, removing duplicate code from kernel and gateway coordinator\n\n### Removed\n\n- Removed Nushell language server configuration from LSP defaults\n\n### Fixed\n\n- Fixed race condition in shell session where command completion could occur before stream data was fully processed\n- Fixed Python gateway spawning console window on Windows by using windowless Python interpreter (pythonw.exe)\n\n## [9.4.0] - 2026-01-31\n\n### Changed\n\n- Migrated environment variable handling to use centralized `getEnv()` and `getEnvApiKey()` utilities from pi-ai package for consistent API key resolution across web search providers and image tools\n- Simplified web search error messages to remove provider-specific configuration hints\n- Replaced manual space padding with `padding()` utility function from pi-tui across UI components for consistent whitespace handling\n- Improved rendering performance for Python cell output by implementing caching in the table and cell results renderers\n- Updated task tool documentation to clarify that subagents can access parent conversation context via a searchable file, reducing need to repeat information in context parameter\n- Updated plan mode prompt to guide model toward using `edit` tool for incremental plan updates instead of defaulting to `write`\n\n### Removed\n\n- Removed environment variable denylist that blocked API keys from being passed to subprocesses; API keys are now controlled via allowlist only\n\n## [9.3.1] - 2026-01-31\n\n### Added\n\n- Added `getCompactContext()` API to retrieve parent conversation context for subagents, excluding system prompts and tool results\n- Added automatic `submit_result` tool injection for subagents with explicit tool lists\n- Added `contextFile` parameter to pass parent conversation context to subagent sessions\n\n### Changed\n\n- Updated subagent system prompt to reference parent conversation context file when available\n- Enhanced subagent system prompt formatting with clearer backtick notation for tool and parameter names\n\n### Removed\n\n- Removed schema override notification from task summary prompt\n\n## [9.2.5] - 2026-01-31\n\n### Changed\n\n- Clarified that user instructions about delegation override tool-use defaults\n- Updated coordinator guidance to emphasize Task tool preference for substantial work with improved emphasis on context window limitations\n- Enhanced `context` parameter documentation to require self-contained information for subagents, including file contents and user requirements\n\n## [9.2.4] - 2026-01-31\n\n### Fixed\n\n- Prevented interactive commands from blocking on stdin by redirecting from /dev/null in POSIX and Fish shell sessions\n\n## [9.2.3] - 2026-01-31\n\n### Added\n\n- Persistent shell session support for bash tool with environment variable preservation across commands\n- New `shellForceBasic` setting to force bash/sh even if user's default shell is different (default: true)\n- New `OMP_SHELL_PERSIST` environment variable to control persistent shell behavior (set to 0 to disable)\n\n### Changed\n\n- Bash tool now reuses a persistent shell session by default on Unix systems for improved performance and state preservation\n- Replaced Bun file APIs with Node.js `fs` module for better cross-runtime compatibility\n- LSP configuration loading is now synchronous instead of async\n- Shell snapshot generation now sanitizes `BASH_ENV` and `ENV` variables to prevent shell exit issues\n- Shell snapshot caching now per-shell-binary instead of global to avoid cross-shell contamination\n- System prompt restructured with coordinator-specific guidance for parallel task delegation\n- Bash tool now reuses a persistent shell session by default on Unix. Set `OMP_SHELL_PERSIST=0` to disable or fall back to per-command execution on Windows/unsupported shells.\n- Added a shellForceBasic setting to force bash/sh and keep environment changes across bash commands (default: true).\n\n### Fixed\n\n- Shell snapshots now filter unsafe bash options (onecmd, monitor, restricted) to prevent session exits\n- Git branch detection in status line now works synchronously without race conditions\n- Shell session initialization properly restores trap handlers and shell functions after command execution\n- Sanitized `BASH_ENV`/`ENV` during persistent shell startup and snapshot creation to prevent basic shells from exiting immediately.\n- Cached shell snapshots per shell binary to avoid sourcing zsh snapshots in bash sessions.\n- Filtered unsafe bash options (onecmd/monitor/restricted) out of shell snapshots to prevent session exits.\n\n## [9.2.2] - 2026-01-31\n\n### Added\n\n- Added grep CLI subcommand (`omp grep`) for testing pattern matching\n- Added fuzzy matching for model resolution with scoring and ranking fallback\n- Added 'Open: artifact folder' menu option to debug selector for quick access to session artifacts\n- Added Kimi API format setting for selecting between OpenAI and Anthropic formats\n- Added Codex and Gemini web search providers with OAuth and grounding support\n- Added /debug command with interactive menu for profiling, heap snapshots, session dumps, and diagnostics\n- Added configurable ask timeout and notification settings\n- Added gitignore-aware project tree scanning with ripgrep integration\n- Added project tree visualization to system prompts with configurable depth and entry limits\n- Added reset() method to CountdownTimer with integration into HookSelectorComponent\n- Added custom message support to AgentSession via promptCustomMessage() method\n- Added skill message component for rendering /skill command messages as compact entries\n- Added model preference matching system for intelligent model selection based on usage history\n- Added designer agent with UI/UX review and accessibility audit capabilities\n- Added model-specific edit variant configuration for patch/replace modes\n- Added automatic browser opening when stats dashboard starts\n- Added model statistics table and TTFT/throughput metrics to stats dashboard\n- Added artifact allocation for truncated fetch responses to preserve full content\n- Added 30-second timeout to ask tool with auto-selection of recommended option\n- Added recommended parameter (0-indexed) to ask tool for specifying default option\n- Added JTD to TypeScript converter for rendering schemas in system prompts\n- Added tools list to system prompt for better agent awareness\n- Added synthetic message flag for system-injected prompts\n- Added session compaction enhancements with auto-continue, tool pruning, and remote endpoint support\n- Added detection and rendering of missing complete tool warning in subagent output\n- Added outline UI components for bordered list containers\n- Added macOS NFD normalization and curly quote variant resolution for file paths\n- Enhanced session compaction with dynamic token ratio adjustment and improved summary preservation\n\n### Changed\n\n- Simplified find tool API by consolidating path and pattern parameters\n- Replaced bulk file loading with streaming for read tool to reduce memory overhead\n- Migrated grep and find tools to WASM-based implementation\n- Replaced ripgrep-based file listing with glob-based file discovery for project scans\n- Updated minimum Bun runtime requirement to >=1.3.7\n- Renamed task parameter from output to schema\n- Renamed complete tool to submit_result for clarity and consistency\n- Improved output preview logic: shows full output for \u226430 lines, truncates to 10 lines for larger output\n\n### Fixed\n\n- Enhanced error reporting with debug stack trace when DEBUG env is set\n- Improved OAuth token refresh error handling to distinguish transient vs definitive failures\n- Added windowsHide option to child process spawn calls to prevent console windows on Windows\n- External edits to config.yml are now preserved when omp reloads or saves settings\n- Exposed LSP server startup errors in session display and logs\n- Improved error handling and security in agent storage initialization with restrictive file permissions\n- Fixed LSP server display showing unknown when server warmup fails\n- Preserved null timeout when user disables ask timeout setting\n- Removed incorrect timeout unit conversion logic in cursor, fetch, gemini-image, and ssh tools\n- Blocked /fork command while streaming to prevent split session logs\n\n## [9.0.0] - 2026-01-29\n\n### Fixed\n\n- External edits to `config.yml` are now preserved when omp reloads or saves unrelated settings. Previously, editing config.yml directly (e.g., removing a package from `packages` array) would be silently reverted on next omp startup when automatic setters like `setLastChangelogVersion()` triggered a save. ([#1046](https://github.com/badlogic/pi-mono/pull/1046) by [@nicobailonMD](https://github.com/nicobailonMD))\n\n## [8.13.0] - 2026-01-29\n\n### Added\n\n- Added `/debug` command with interactive menu for bug report generation:\n  - `Report: performance issue` - CPU profiling with reproduction flow\n  - `Report: dump session` - Immediate session bundle creation\n  - `Report: memory issue` - Heap snapshot with bundle\n  - `View: recent logs` - Display last 50 log entries\n  - `View: system info` - Show environment details\n  - `Clear: artifact cache` - Remove old session artifacts\n\n### Fixed\n\n- Fixed LSP server errors not being visible in `/session` output or logs when startup fails\n\n## [8.12.7] - 2026-01-29\n\n### Fixed\n\n- Fixed LSP servers showing as \"unknown\" in status display when server warmup fails\n- Fixed Read tool loading entire file into memory when offset/limit was specified\n\n## [8.12.2] - 2026-01-28\n\n### Changed\n\n- Replaced ripgrep-based file listing with fs.glob for project scans and find/read tooling\n\n## [8.11.14] - 2026-01-28\n\n### Changed\n\n- Rendered /skill command messages as compact skill entries instead of full prompt text\n\n## [8.8.8] - 2026-01-28\n\n### Added\n\n- Added `/fork` command to create a new session with the exact same state (entries and artifacts) as the current session\n\n### Changed\n\n- Renamed the `complete` tool to `submit_result` for subagent result submission\n\n## [8.6.0] - 2026-01-27\n\n### Added\n\n- Added `plan` model role for specifying the model used by the plan agent\n- Added `--plan` CLI flag and `OMP_PLAN_MODEL` environment variable for ephemeral plan model override\n- Added plan model selection in model selector UI with PLAN badge\n\n### Changed\n\n- Task tool subagents now execute in-process instead of using worker threads\n\n### Fixed\n\n- Queued skill commands as follow-ups when the agent is already streaming to avoid load failures\n- Deduplicated repeated review findings in subagent progress rendering\n- Restored MCP proxy tool timeout handling to prevent subagent hangs\n\n## [8.5.0] - 2026-01-27\n\n### Added\n\n- Added subagent support for preloading skill contents into the system prompt instead of listing available skills\n- Added session init entries to capture system prompt, task, tools, and output schema for subagent session logs\n\n### Fixed\n\n- Reduced Task tool progress update overhead to keep the UI responsive during high-volume streaming output\n- Fixed subagent session logs dropping pre-assistant entries (user/task metadata) before the first assistant response\n\n### Removed\n\n- Removed enter-plan-mode tool\n\n## [8.4.5] - 2026-01-26\n\n### Added\n\n- Model usage tracking to record and retrieve most recently used models\n- Model sorting in selector based on usage history\n\n### Changed\n\n- Renamed `head_limit` parameter to `limit` in grep and find tools for consistency\n- Added `context` as an alias for the `c` context parameter in grep tool\n- Made hidden files inclusion configurable in find tool via `hidden` parameter (defaults to true)\n- Added support for reading ignore patterns from .gitignore and .ignore files in find tool\n\n### Fixed\n\n- Respected .gitignore rules when filtering find tool results by glob pattern\n\n## [8.4.2] - 2026-01-25\n\n### Changed\n\n- Clarified and condensed plan mode prompts for improved clarity and consistency\n\n## [8.4.1] - 2026-01-25\n\n### Added\n\n- Added core plan mode with plan file approval workflow and tool gating\n- Added plan:// internal URLs for plan file access and subagent plan-mode system prompt\n- Added plan mode toggle shortcut with paused status indicator\n\n### Fixed\n\n- Fixed plan reference injection and workflow prompt parameters for plan mode\n- Fixed tool downloads hanging on slow/blocked GitHub by adding timeouts and zip extraction fallback\n- Fixed missing UI notification when tools are downloaded or installed on demand\n\n## [8.4.0] - 2026-01-25\n\n### Added\n\n- Added extension API to set working/loading messages during streaming\n- Added task worker propagation of context files, skills, and prompt templates\n- Added subagent option to skip Python preflight checks when Python tooling is unused\n- Model field now accepts string arrays for fallback model prioritization\n\n### Changed\n\n- Merged patch application warnings into edit tool diagnostics output\n- Cached Python prelude docs for subagent workers to avoid repeated warmups\n- Simplified image placeholders inserted on paste to match Claude-style markers\n\n### Fixed\n\n- Rewrote empty or corrupted session files to restore valid headers\n- Improved patch applicator ambiguity errors with match previews and overlap detection\n- Fixed Task tool agent model resolution to honor comma-separated model lists\n\n## [8.3.0] - 2026-01-25\n\n### Changed\n\n- Added request parameter tracking to LSP tool rendering for better diagnostics visibility\n- Added async diff computation and Kitty protocol support to tool execution rendering\n- Refactored patch applicator with improved fuzzy matching (7-pass sequence matching with Levenshtein distance) and indentation adjustment\n- Added inline rendering flag to bash and fetch tool renderers\n- Extracted constants for preview formatting to improve code maintainability\n- Exposed mergeCallAndResult and inline rendering options from tools to their wrappers\n- Added timeout validation and normalization for tool timeout parameters\n\n### Fixed\n\n- Fixed output block border rendering (bottom-right corner was missing)\n- Added background control parameter to output block rendering\n\n## [8.2.2] - 2026-01-24\n\n### Removed\n\n- Removed git utility functions (_git, git_status, git_diff, git_log, git_show, git_file_at, git_branch, git_has_changes) from IPython prelude\n\n## [8.2.0] - 2026-01-24\n\n### Added\n\n- Added `omp commit` command to generate conventional commits with changelog updates\n- Added agentic commit mode with commit-specific tools and `--legacy` fallback\n- Added configurable settings for map-reduce analysis including concurrency, timeout, file thresholds, and token limits\n- Added support for excluding YAML lock files (`.lock.yml`, `.lock.yaml`, `-lock.yml`, `-lock.yaml`) from commit analysis\n- Added new TUI component library with reusable rendering utilities including code cells, file lists, tree lists, status lines, and output blocks\n- Added renderCodeCell component for displaying code with optional output sections, supporting syntax highlighting and status indicators\n- Added renderFileList component for rendering file/directory listings with language icons and metadata\n- Added renderTreeList component for hierarchical tree-based item rendering with expand/collapse support\n- Added renderStatusLine component for standardized tool status headers with icons, descriptions, and metadata\n- Added renderOutputBlock component for bordered output containers with structured sections\n- Added renderOutputBlock to Bash tool for improved output formatting with status indicators\n- Added `--legacy` flag to `omp commit` for using the deterministic pipeline instead of agentic mode\n- Added split commit support to automatically create multiple atomic commits for unrelated changes\n- Added git hunk inspection tools for fine-grained diff analysis in commit generation\n- Added commit message validation with filler word and meta phrase detection\n- Added automatic unicode normalization in commit summaries\n- Added real-time progress output to agentic commit mode showing thinking status, tool calls, and completion summary\n- Added hunk-level staging support in split commits allowing partial file changes per commit\n- Added dependency ordering for split commits ensuring commits are applied in correct sequence\n- Added circular dependency detection with validation errors for split commit plans\n- Added parallel file analysis with cross-file context awareness via `analyze_files` tool\n- Added AGENTS.md context file discovery for commit generation\n- Added progress indicators during changelog generation and model resolution\n- Added propose_changelog tool for agent-provided changelog entries in agentic commit workflow\n- Added fallback commit generation when agentic mode fails, using file pattern analysis and heuristic-based type inference\n- Added trivial change detection to automatically classify whitespace-only and import-reorganization commits\n- Added support for pre-computed file observations in commit agent to skip redundant analyze_files calls\n- Added diff content caching with smart file prioritization to optimize token usage in large changesets\n- Added lock file filtering (17 patterns including Cargo.lock, package-lock.json, bun.lock) from commit analysis\n- Added changelog deletion support to remove outdated entries via the changelog proposal interface\n- Added support for pre-computed changelog entries in commit agent to display existing unreleased sections for potential deletion\n- Added `ExistingChangelogEntries` interface to track changelog sections by path for changelog proposal context\n- Added conditional `analyze_files` skipping in commit agent when pre-analyzed observations are provided\n- Added guidance to commit agent prompts instructing subagents to write files directly instead of returning changes for manual application\n- Added mermaid diagram rendering with terminal graphics support (Kitty/iTerm2) for markdown output\n- Added renderMermaidToPng utility for converting mermaid code blocks to terminal-displayable PNG images via mmdc CLI\n- Added mermaid block extraction with content-addressed hashing for deduplication and cache lookup\n- Added background mermaid pre-rendering in assistant messages for responsive diagram display\n- Added two-level mermaid caching with pending deduplication to prevent redundant renders\n- Added Python kernel session pooling with MAX_KERNEL_SESSIONS limit and automatic eviction of oldest sessions\n- Added automatic idle kernel session cleanup timer (5-minute timeout, 30-second interval)\n- Added types/assets/index.d.ts for global TypeScript module declarations supporting `.md`, `.py`, and `.wasm?raw` imports\n- Added bunfig.toml loader configuration for importing markdown, Python, and WASM files as text modules\n- Added color manipulation utilities (hexToHsv, hsvToHex, shiftHue) to pi-utils for accessible theme adjustments\n- Added color-blind mode setting for improved accessibility\n- Added filesystem error type guards (isEnoent, isEacces, isPerm, isEnotempty, isFsError, hasFsCode) to pi-utils for safe error handling\n- Added tarball installation test Dockerfile to validate npm publish/install flow\n\n### Changed\n\n- Changed changelog diff truncation limit to be configurable via settings\n- Changed tool result rendering to use new TUI component library across multiple tools (bash, calculator, fetch, find, grep, ls, notebook, python, read, ssh, write, lsp, web search) for consistent output formatting\n- Changed Bash tool output rendering to use renderOutputBlock with proper section handling and width-aware truncation\n- Changed Python tool output rendering to use renderCodeCell component for code cell display with status indicators\n- Changed Read tool output rendering to use renderCodeCell with syntax highlighting and warnings display\n- Changed Write tool output rendering to use renderCodeCell for code display with streaming preview support\n- Changed Fetch tool output rendering to use renderOutputBlock with metadata and content preview sections\n- Changed LSP tool output rendering to use renderStatusLine and renderOutputBlock for structured output display\n- Changed Web Search result rendering to use renderOutputBlock with answer, sources, related questions, and metadata sections\n- Changed Find, Grep, and Ls tools to use renderFileList and renderTreeList for consistent file/item listing\n- Changed Calculator tool result rendering to use renderTreeList for result item display\n- Changed Notebook and TodoWrite tools to use new TUI rendering components for consistent output format\n- Refactored render-utils to move tree-related utilities to TUI module (getTreeBranch, getTreeContinuePrefix)\n- Changed import organization in sdk.ts for consistency\n- Changed tool result rendering to merge call and result displays, showing tool arguments (command, pattern, query, path) in result headers for Bash, Calculator, Fetch, Find, Grep, Ls, LSP, Notebook, Read, SSH, TodoWrite, Web Search, and Write tools\n- Changed Read tool title to display line range when offset or limit arguments are provided\n- Changed worker instantiation to use direct URL import instead of pre-bundled worker files\n- Changed `omp commit` to use agentic mode by default with tool-based git inspection\n- Changed agentic commit progress output to show real-time thinking previews and structured tool argument details\n- Changed agentic commit progress output to display full multi-line assistant messages and render tool arguments with tree-style formatting for improved readability\n- Changed agentic commit progress output to render assistant messages as formatted Markdown with proper word wrapping\n- Changed output block border color to reflect state (error, success, warning) for improved visual feedback\n- Changed LSP hover rendering to display documentation text before code blocks in both collapsed and expanded views\n- Changed Write tool to show streaming preview of content being written with syntax highlighting\n- Changed Read tool to display resolved path information when reading from URLs or symlinks\n- Changed Calculator tool result display to show both expression and output (e.g., `2+2 = 4`) instead of just the result\n- Changed Python tool output to group status information under a labeled section for clearer organization\n- Changed SSH tool output to apply consistent styling to non-ANSI output lines\n- Changed Todo Write tool to respect expanded/collapsed state and use standard preview limits\n- Changed Web Search related questions to respect expanded/collapsed state instead of always showing all items\n- Changed empty and error state rendering across multiple tools (Find, Grep, Ls, Notebook, Calculator, Ask) to include consistent status headers\n- Changed split commit to support hunk selectors (all, indices, or line ranges) instead of whole-file staging\n- Changed `analyze_file` tool to `analyze_files` for batch parallel analysis of multiple files\n- Switched agentic commit from auto-generated changelogs to agent-proposed entries with validation and retry logic\n- Commit agent now resolves a separate smaller model for commit generation instead of reusing the primary model\n- Normalized code formatting and indentation across tool renderers and UI components\n- Changed git-file-diff tool to prioritize files by type and respect token budget limits with intelligent truncation\n- Changed git-overview tool to filter and report excluded lock files separately from staged files\n- Changed analyze-file tool to include file type inference and enriched related files with line counts\n- Changed propose-changelog tool to support optional deletion entries for removing existing changelog items\n- Changed commit agent to accept pre-computed file observations and format them into session prompts\n- Changed changelog skip condition in `applyChangelogProposals` to also check for empty deletions object\n- Changed `createCommitTools()` to build tools array incrementally with conditional `analyze_files` inclusion based on `enableAnalyzeFiles` flag\n- Changed system prompt guidance to clarify that pre-computed observations prevent redundant `analyze_files` calls\n- Removed map-reduce preprocessing phase from commit agent for faster iteration\n- Changed commit agent to process full diff text directly instead of pre-computed file observations\n- Changed commit agent initialization to load settingsManager, authStorage, modelRegistry, and stagedFiles in parallel\n- Changed commit agent prompt to remove pre-computed observations guidance and encourage direct analyze_files usage\n- Changed AuthStorage from constructor-based instantiation to async factory method (AuthStorage.create())\n- Changed Python kernel resource management with gateway shutdown on session disposal\n- Updated TypeScript configuration for better publish-time configuration handling with tsconfig.publish.json\n- Updated TypeScript and Bun configuration for monorepo-wide build consistency and reduced boilerplate\n- Removed WASM base64 encoding build script; imports now use Bun loader with `wasm?raw` query parameter\n- Unified TypeScript checking pipeline with tsgo-based configuration instead of per-package tsconfig.publish.json boilerplate\n- Refactored scanDirectoryForSkills to use async/await with concurrent directory scanning via Promise.all\n- Improved error logging in settings manager for config file access failures\n- Migrated node module imports from named to namespace imports across all packages for consistency with project guidelines\n- Improved filesystem error handling in extension loader with additional type guards (isEacces, hasFsCode) for permission and EPERM errors\n- Changed model discovery to synchronous file operations for more immediate initialization\n\n### Fixed\n\n- Fixed database busy errors during concurrent access by adding retry logic with exponential backoff when opening storage\n- Find tool now rejects searches from root directory and enforces a 5-second timeout on fd operations\n- Commit command now exits cleanly with exit code 0 on success\n- Handle undefined code parameter in code cell renderer\n- Fixed indentation formatting in split-commit tool function signature\n- Fixed changelog application to process proposals containing only deletion entries without additions\n- Fixed indentation formatting in Python tool output renderer\n- Fixed Python kernel resource management with proper timing instrumentation for performance monitoring\n- Fixed model discovery to re-check file existence after JSON to YAML migration\n- Fixed branch change callbacks in footer component to properly update state after git resolution\n- Added guard clause in plugin-settings to prevent null reference when settings list is undefined\n- Fixed agent task discovery to support symlinks and improved error handling for file access failures\n\n## [8.0.0] - 2026-01-23\n\n### Added\n\n- Added antigravity provider support for image generation with Google Cloud authentication\n- Added support for google-antigravity API credentials in model registry\n- Added antigravity-specific request handling with SSE streaming\n- Added projectId parameter to antigravity credentials parsing\n- Added antigravity provider to preferred image provider selection\n- Added list-limit utility for consistent result limiting across tools\n- Added output-utils module with tail buffer and artifact allocation helpers\n- Added tool-result module for standardized tool result construction\n- Added truncation summary options to OutputMetaBuilder for better output tracking\n- Added artifact storage system for truncated tool outputs with artifact:// URL protocol\n- Added structured output metadata system with fluent OutputMetaBuilder for consistent notices\n- Added standardized tool error types (ToolError, MultiError, ToolAbortError) for better error handling\n- Added internal URL routing system with protocol handlers:\n- `agent://` - access agent output artifacts\n- `agent:///` and `agent://?q=` - JSON extraction from agent outputs\n- `skill://` and `skill:///` - read skill files and relative paths\n- `rule://` - read rule content\n- URL resolution includes filesystem path in output for bash/python interop\n- Added fetch tool for URL content retrieval with enhanced processing capabilities\n- Added `isolated` option to task tool for git worktree execution with automatic patch generation and application\n- Added format-prompts script to standardize prompt file formatting\n\n### Changed\n\n- Updated default line limit from 4000 to 3000 lines for output truncation\n- Reordered truncation notice to show offset continuation before artifact reference\n- Applied meta notice wrapper to all tools in createTools function\n- Updated test expectations to reflect new 3000 line limit\n- Removed output tool from schema validation test list\n- Replaced inline output truncation notices with structured metadata system across all tools\n- Updated bash, python, and ssh executors to track detailed output statistics (total lines/bytes vs output lines/bytes)\n- Modified artifact storage to use pre-allocated paths instead of inline file writing\n- Changed message format to use meta field instead of fullOutputPath for truncation information\n- Updated interactive components to display truncation metadata from structured format\n- Standardized tool result building with new ToolResultBuilder for consistent metadata handling\n- Simplified Python gateway coordination by removing reference counting and client tracking\n- Updated Python gateway to use global shared instance instead of per-process coordination\n- Modified Python kernel initialization to set working directory and environment per kernel\n- Updated interactive status display to show Python and venv paths instead of client count\n- Changed system prompt to clarify CHECKPOINT step 0 timing\n- Updated Python environment warming to use await instead of void for proper error handling\n- Updated interactive mode shutdown to use postmortem.quit instead of process.exit\n- Updated bash tool documentation to clarify specialized tool usage\n- Updated task tool documentation to escape placeholder syntax in examples\n- Updated Python environment warming to use await instead of void for proper error handling\n- Updated interactive mode shutdown to use postmortem.quit instead of process.exit\n- Updated bash tool documentation to clarify specialized tool usage\n- Updated task tool documentation to escape placeholder syntax in examples\n- Updated all tools to use structured metadata instead of inline notices for truncation, limits, and diagnostics\n- Replaced manual error formatting with ToolError.render() and standardized error handling\n- Enhanced bash and python executors to save full output as artifacts when truncated\n- Improved abort signal handling across all tools with consistent ToolAbortError\n- Renamed task parameter from `vars` to `args` throughout task tool interface and updated template rendering to support built-in `{{id}}` and `{{description}}` placeholders\n- Simplified todo-write tool by removing active_form parameter, using single content field for task descriptions\n- Updated system prompt structure with `` and `` tags, clearer critical sections, and standardized whitespace handling\n- Renamed web_fetch tool to fetch and removed internal URL handling (use read tool instead)\n- Standardized tool parameter names from camelCase to snake_case across edit, grep, python, and todo-write tools\n- Unified timeout parameters across all tools with auto-conversion from milliseconds and reasonable clamping (1s-3600s for bash/ssh, 1s-600s for python/gemini-image)\n- Simplified web-search tool by removing advanced parameters (`max_tokens`, `model`, `search_domain_filter`, `search_context_size`, `return_related_questions`) and using `recency` instead of `search_recency_filter`\n- Restructured tool documentation with standardized ``, ``, ``, and `` sections across all 18 tools\n- Updated find tool to always sort results by modification time\n- Updated bash prompt to use `cwd` parameter instead of `workdir`\n- Improved output truncation limits: bash to 50KB/2000 lines, python to 100KB\n- Removed model parameter from task and gemini-image tools to use session/provider defaults\n- Improved MCP tool name handling with explicit server and tool name properties\n- Marked read tool as non-abortable to improve performance\n- Converted dynamic imports to static imports in installer and exa tools\n\n### Removed\n\n- Removed output tool (replaced by `agent://` URLs via read tool)\n- Removed web_fetch tool (replaced by fetch tool)\n\n### Fixed\n\n- Fixed Python kernel environment initialization for external and shared gateways\n- Fixed gateway status reporting to include Python and virtual environment paths\n- Fixed inconsistent error formatting across tools by standardizing on ToolError types\n- Fixed timeout parameter handling to auto-convert milliseconds to seconds and clamp to reasonable ranges\n- Fixed whitespace formatting in json-query.ts comment\n- Fixed interactive shutdown to await postmortem cleanup so Python kernel gateways are terminated\n- Fixed shared Python gateway reuse across working directories by initializing kernel cwd and env per kernel\n- Fixed Python gateway coordination to use a single global gateway without ref counting\n\n## [7.0.0] - 2026-01-21\n\n### Added\n\n- Added usage report deduplication to prevent duplicate account entries\n- Added debug logging for usage fetch operations to aid diagnostics\n- Added provider sorting in usage display by total usage amount\n- Added `isolated` parameter to task tool for running each task in separate git worktrees\n- Added git worktree management for isolated task execution with patch generation\n- Added patch application system that applies changes only when all patches are valid\n- Added working directory information to environment info display\n- Added `/usage` command to display provider usage and limits\n- Added support for multiple usage providers beyond Codex\n- Added usage report caching with configurable TTL\n- Added visual usage bars and account aggregation in usage display\n- Added `fetchUsageReports()` method to agent session\n- Added `output()` function to read task/agent outputs by ID with support for multiple formats and queries\n- Added session file support to Python executor for accessing task outputs\n- Added support for jq-like queries when reading JSON outputs\n- Added offset and limit parameters for reading specific line ranges from outputs\n- Added \".\" and \"c\" shortcuts to continue agent without sending visible message\n- Added debug logging for usage fetch results to aid /usage diagnostics\n\n### Changed\n\n- Updated discoverSkills function to return object with skills property\n- Enhanced usage report merging to combine limits and metadata from duplicate accounts\n- Improved OAuth credential handling to preserve existing fields when updating\n- Removed cd function from Python prelude to encourage using cwd parameter\n- Updated task tool to generate and apply patches when running in isolated mode\n- Enhanced task tool rendering to display isolated execution status and patch paths\n- Updated system prompt structure and formatting for better readability\n- Reorganized tool hierarchy and discipline sections\n- Added parallel work guidance for task-based workflows\n- Enhanced verification and integration methodology sections\n- Updated skills and rules formatting for cleaner presentation\n- Added stronger emphasis on completeness and quality standards\n- Refactored usage tracking from Codex-specific to generic provider system\n- Updated usage limit detection to work with multiple provider APIs\n- Changed usage cache to use persistent storage instead of in-memory only\n- Limited diagnostic messages to 50 items to prevent overwhelming output when processing files with many issues\n- Changed `/dump` command to include complete agent context: system prompt, model config, available tools with schemas, and all message types (bash/python executions, custom messages, branch summaries, compaction summaries, file mentions)\n- Changed `/dump` format to use YAML instead of JSON for tool schemas and arguments (more readable)\n\n### Fixed\n\n- Fixed TypeScript error in bash executor by properly typing caught exception\n- Fixed usage display ordering to show providers with lowest usage first\n- Fixed task tool result rendering to show fallback text when no results are available\n- Fixed external editor to work properly on Unix systems by correctly handling terminal I/O\n- Fixed external editor to show warning message when it fails to open instead of silently failing\n- Fixed find tool to properly handle no matches case without treating as error\n- Fixed find tool to wait for fd exit so error messages no longer report exit null\n- Fixed read tool to properly handle no matches case without treating as error\n- Fixed orphaned Python kernel gateway processes not being killed on process exit\n- Fixed /usage provider ordering to sort by aggregate usage (most used last)\n- Fixed /usage account dedupe to collapse identical accounts using usage metadata\n\n## [6.9.69] - 2026-01-21\n\n### Added\n\n- Added cell-by-cell status tracking with duration and exit code for Python execution\n- Added syntax highlighting for Python code in execution display\n- Added template system with {{placeholders}} for task tool context\n- Added task variables support for filling context placeholders\n- Added enhanced task progress display with variable values\n- Added concurrent work handling guidance in system prompt\n- Added extension system support for user Python execution events\n- Added Python mode border color theming across all themes\n- Added Python execution indicator to welcome screen help text\n- Added `omp stats` command for viewing AI usage statistics dashboard\n- Added support for JSON output and console summary of usage statistics\n- Added configurable port option for stats dashboard server\n- Added multi-cell Python execution with sequential processing in persistent kernel\n- Added cell titles for better Python code organization and debugging\n- Added `$` command prefix for user-initiated Python execution in shared kernel\n- Added `$$` prefix variant for Python execution excluded from LLM context\n\n### Changed\n\n- Updated Python execution to display cells in bordered blocks with status indicators\n- Changed task tool to use template-based context instead of simple concatenation\n- Enhanced Python execution component with proper syntax highlighting\n- Improved patch applicator to preserve exact indentation when intended\n- Updated task tool schema to require vars instead of task field\n- Updated Python execution component to use pythonMode theming instead of bashMode\n- Enhanced UI helpers to handle pending Python components properly\n- Changed Python tool to use `cells` array instead of single `code` parameter\n- Renamed `workdir` parameter to `cwd` in Bash and Python tools for consistency\n- Updated Python tool to display cell-by-cell output when multiple cells are provided\n\n### Fixed\n\n- Fixed indentation preservation for exact matches and indentation-only patches\n- Fixed Python execution status updates to show real-time cell progress\n- Fixed indentation adjustment logic to handle edge cases with mixed indentation levels\n- Fixed patch indentation normalization for fuzzy matches, tab/space diffs, and ambiguous context alignment\n\n## [6.9.0] - 2026-01-21\n\n### Removed\n\n- Removed Git tool and all related functionality\n- Removed voice control and TTS features\n- Removed worktree management system\n- Removed bundled wt custom command\n- Removed voice-related settings and configuration options\n- Removed @oh-my-pi/pi-git-tool dependency\n\n## [6.8.5] - 2026-01-21\n\n### Breaking Changes\n\n- Changed timeout parameter from seconds to milliseconds in Python tool\n- Updated PythonExecutorOptions interface to use timeoutMs instead of timeout\n\n### Changed\n\n- Updated default timeout to 30000ms (30 seconds) for Python tool\n- Improved streaming output handling and buffer management\n\n## [6.8.4] - 2026-01-21\n\n### Changed\n\n- Updated output sink to properly handle large outputs\n- Improved error message formatting in SSH executor\n- Updated web fetch timeout bounds and conversion\n\n### Fixed\n\n- Fixed output truncation handling in streaming output\n- Fixed timeout handling in web fetch tool\n- Fixed async stream dumping in executors\n\n## [6.8.3] - 2026-01-21\n\n### Changed\n\n- Updated keybinding system to normalize key IDs to lowercase\n- Changed label edit shortcut from 'l' to 'Shift+L' in tree selector\n- Changed output file extension from `.out.md` to `.md` for artifacts\n\n### Removed\n\n- Removed bundled worktree command from custom commands loader\n\n### Fixed\n\n- Fixed keybinding case sensitivity issues by normalizing all key IDs\n- Fixed task artifact path handling and simplified file structure\n\n## [6.8.2] - 2026-01-21\n\n### Fixed\n\n- Improved error messages when multiple text occurrences are found by showing line previews and context\n- Enhanced patch application to better handle duplicate content in context lines\n- Added occurrence previews to help users disambiguate between multiple matches\n- Fixed cache invalidation for streaming edits to prevent stale data\n- Fixed file existence check for prompt templates directory\n- Fixed bash output streaming to prevent premature stream closure\n- Fixed LSP client request handling when signal is already aborted\n- Fixed git apply operations with stdin input handling\n\n### Security\n\n- Updated Anthropic authentication to handle manual code input securely\n\n## [6.8.1] - 2026-01-20\n\n### Fixed\n\n- Fixed unhandled promise rejection when tool execution fails by adding missing `.catch()` to floating `.finally()` chain in `createAbortablePromise`\n\n## [6.8.0] - 2026-01-20\n\n### Added\n\n- Added streaming abort setting to control edit tool behavior when patch preview fails\n\n### Changed\n\n- Replaced internal logger with @oh-my-pi/pi-utils logger across all modules\n- Updated process spawning to use cspawn and ptree utilities from pi-utils\n- Migrated file operations to use async fs/promises and Bun file APIs\n- Refactored promise handling to use Promise.withResolvers and utility functions\n- Updated timeout and abort handling to use standardized utility functions\n- Refactored authentication login method to use OAuthController interface instead of individual callbacks\n\n### Fixed\n\n- Fixed Python package installation to handle async operations properly\n- Fixed streaming output truncation to use consistent column limits\n- Fixed shell command execution to properly handle process cleanup and timeouts\n- Fixed SSH connection management to properly await async operations\n- Fixed voice supervisor process cleanup to use proper async handling\n- Added automatic regex pattern validation in grep tool to handle invalid patterns by switching to literal mode\n\n### Security\n\n- Updated temporary file cleanup to use secure async removal methods\n\n## [6.7.67] - 2026-01-19\n\n### Added\n\n- Added normative rewrite setting to control tool call argument normalization in session history\n- Added read line numbers setting to prepend line numbers to read tool output by default\n- Added streaming preview for edit and write tools with spinner animation\n- Added automatic anchor derivation for normative patches when anchors not specified\n\n### Changed\n\n- Enhanced edit and write tool renderers to show streaming content preview\n- Updated read tool to respect default line numbers setting\n- Improved normative patch anchor handling to support undefined anchors\n\n## [6.7.0] - 2026-01-19\n\n### Added\n\n- Normative patch generation to canonicalize edit tool output with tool call argument rewriting for session history\n- Patch matching fallback variants: trimmed context, collapsed duplicates, single-line reduction, comment-prefix normalization\n- Extended anchor syntax: ellipsis placeholders, `top of file`/`start of file`, `@@ line N`, nested `@@` anchors, space-separated hierarchical contexts\n- Relaxed fuzzy threshold fallback and unique substring acceptance for context matching\n- Added `--no-title` flag to disable automatic session title generation\n- Environment variables for edit tool configuration (OMP_EDIT_VARIANT, OMP_EDIT_FUZZY, OMP_EDIT_FUZZY_THRESHOLD)\n- Configurable fuzzy matching threshold setting (0.85 lenient to 0.98 strict)\n- Apply-patch mode for edit tool (`edit.patchMode` setting) with create, update, delete, and rename operations\n- Added MCP tool caching for faster startup with cached tool definitions\n\n### Changed\n\n- Patch applicator now supports normalized input, implicit context lines, and improved indentation adjustment\n- Patch operation schema uses 'op' instead of 'operation' and 'rename' instead of 'moveTo'\n- Fuzzy matching tries comment-prefix normalized matches before unicode normalization\n- Updated patch prompts with clearer anchor selection rules and verbatim context requirements\n- Changed default behavior of read tool to omit line numbers by default\n- Changed default edit tool mode to use apply-patch format instead of oldText/newText\n- Converted tool implementations from factory functions to class-based architecture\n- Refactored edit tool with modular patch architecture (moved from `edit/` to `patch/` module)\n- Enhanced patch parsing: unified diff format, Codex-style patches, nested anchors, multi-file markers\n- Improved fuzzy matching with multiple match tracking, ambiguity detection, and out-of-order hunk processing\n- Better diff rendering: smarter truncation, optional line numbers, trailing newline preservation\n- Improved error messages with hierarchical context display using `>` separator\n- Centralized output sanitization in streaming-output module\n- Enhanced MCP startup with deferred tool loading and cached fallback\n\n### Fixed\n\n- Patch application handles repeated context blocks, preserves original indentation on fuzzy match\n- Ambiguous context matching resolves duplicates using adjacent @@ anchor positioning\n- Patch parser handles bare *** terminators, model hallucination markers, line hint ranges\n- Function context matching handles signatures with and without empty parentheses\n- Fixed session title generation to respect OMP_NO_TITLE environment variable\n- Fixed Python module discovery to use import.meta.dir for ES module compatibility\n- Fixed LSP writethrough batching to flush when delete operations complete a batch\n- Fixed line number validation, BOM detection, and trailing newline preservation in patches\n- Fixed hierarchical context matching and space-separated anchor parsing\n- Fixed fuzzy matching to avoid infinite loops when `allowFuzzy` is disabled\n- Fixed tool completion logic to only mark tools as complete when streaming is not aborted or in error state\n- Fixed MCP tool path formatting to correctly display provider information\n\n## [6.2.0] - 2026-01-19\n\n### Changed\n\n- Improved LSP batching to coalesce formatting and diagnostics for parallel edits\n- Updated edit and write tools to support batched LSP operations\n\n### Fixed\n\n- Coalesced LSP formatting/diagnostics for parallel edits so only the final write triggers LSP across touched files\n\n## [6.1.0] - 2026-01-19\n\n### Added\n\n- Added lspmux integration for LSP server multiplexing to reduce startup time and memory usage\n- Added LSP tool proxy support for subagent workers\n- Updated LSP status command to show lspmux connection state\n- Added maxdepth and mindepth parameters to find function for depth-controlled file search\n- Added counter function to count occurrences and sort by frequency\n- Added basenames function to extract base names from paths\n\n### Changed\n\n- Simplified rust-analyzer default configuration by removing custom initOptions and settings\n\n## [6.0.0] - 2026-01-19\n\n### Added\n\n- Added Cursor and OpenAI Codex OAuth providers\n- Added Windows installer bash shell auto-configuration\n- Added dedicated TTSR settings tab (separated from Voice/TTS)\n\n### Fixed\n\n- Fixed TTSR abbreviation expansion from TTSR to Time Traveling Stream Rules\n\n## [5.8.0] - 2026-01-19\n\n### Changed\n\n- Updated WASM loading to use streaming for development environments with base64 fallback\n- Added scripts directory to published package files\n\n## [5.7.68] - 2026-01-18\n\n### Changed\n\n- Updated WASM loading to use base64-encoded WASM for better compatibility with compiled binaries\n\n### Fixed\n\n- Fixed WASM loading issues in compiled binary builds\n\n## [5.7.67] - 2026-01-18\n\n### Changed\n\n- Replaced external photon-node dependency with vendored WebAssembly implementation\n- Updated image processing to use local photon library for better performance\n\n## [5.6.70] - 2026-01-18\n\n### Added\n\n- Added support for loading Python prelude extension modules from user and project directories\n- Added automatic discovery of Python modules from `.omp/modules` and `.pi/modules` directories\n- Added prioritized module loading with project-level modules overriding user-level modules\n\n## [5.6.7] - 2026-01-18\n\n### Added\n\n- Added Python shared gateway setting to enable resource-efficient kernel reuse across sessions\n- Added Python tool cancellation support with proper timeout and cleanup handling\n- Added enhanced Python prelude helpers including file operations, text processing, and Git utilities\n- Added Python tool documentation rendering with categorized helper functions\n- Added session-scoped Python kernel isolation with workdir-aware session IDs\n- Added structured status events for Python prelude functions with TUI rendering\n- Added status event display system with operation icons and formatted descriptions\n- Added support for rich output using IPython.display.display() in Python tool\n- Added setup subcommand to install dependencies for optional features\n- Added Python setup component to install Jupyter kernel dependencies\n- Added setup command help with component and option documentation\n- Added Python tool dependency check in help output\n- Added file locking mechanism for shared Python gateway to prevent race conditions\n- Added Python gateway status monitoring with URL, PID, client count, and uptime information\n- Added comprehensive Git helpers to Python prelude including status, diff, log, show, branch, and file operations\n- Added line-based operations to Python prelude including line extraction, deletion, insertion, and pattern matching\n- Added automatic categorization system for Python prelude functions with discoverable documentation\n- Added enhanced `/status` command display showing Python gateway, LSP servers, and MCP server connections\n- Added shared Python gateway coordinator for resource-efficient kernel management across sessions\n- Added Python shared gateway setting with session-scoped kernel reuse and fallback behavior\n- Added automatic idle shutdown for shared Python gateway after 30 seconds of inactivity\n- Added environment filtering for shared Python gateway to exclude sensitive API keys\n- Added virtual environment detection and automatic PATH configuration for Python gateway\n- Added IPython-backed Python tool with streaming output, image/JSON rendering, and Jupyter kernel gateway integration\n- Added Python prelude with 30+ shell-like utility functions for file operations\n- Added Python tool exposure settings with session-scoped kernel reuse and fallback behavior\n- Added streaming output system with automatic spill-to-disk for large outputs\n- Added extension input interception with source metadata and command argument completion\n- Added extension command context `compact()` helper plus context usage accessors\n- Added ExtensionAPI `setLabel()` for extension and entry labels\n- Added startup quiet setting to suppress welcome screen and startup messages\n- Added support for auto-discovering APPEND_SYSTEM.md files\n- Added support for piped input in non-interactive mode (auto-print mode)\n- Added global session listing across all project directories with enhanced search metadata\n- Added session fork prompt when resolving sessions from other projects\n- Added key hint formatting utilities plus public exports for getShellConfig/getAgentDir/VERSION\n- Added bash tool timeout display in tool output\n- Added fuzzy text normalization for improved edit diff matching\n- Added $@ argument slicing syntax in prompt templates\n- Added configurable keybindings for expand tools and dequeue actions\n- Added process title update on CLI startup\n\n### Changed\n\n- Updated Python tool description to display categorized helper functions with improved formatting\n- Enhanced Python kernel startup to use shared gateway by default for better resource utilization\n- Improved Python prelude functions to emit structured status events instead of text output\n- Updated agent prompts to use bash tool instead of exec for git operations\n- Changed default Python tool mode from ipy-only to both to enable shell execution\n- Enhanced Python gateway coordination with Windows environment support and stale process cleanup\n- Updated Python prelude functions to emit structured status events instead of text output\n- Enhanced Python tool renderer to display status events alongside output\n- Improved Python tool output formatting with status event integration\n- Improved shared Python gateway coordination with environment validation and stale process cleanup\n- Updated Python prelude to rename `bash()` function to `sh()` for consistency\n- Changed default Python tool mode from \"ipy-only\" to \"both\" to enable both IPython and shell execution\n- Enhanced Python gateway metadata tracking to include Python path and virtual environment information\n- Improved Python kernel startup to use shared gateway by default for better resource utilization\n- Updated Python tool to support proxy execution mode for worker processes\n- Enhanced Python kernel availability checking with faster validation\n- Optimized Python environment warming to avoid blocking during tool initialization\n- Reorganized settings interface into behavior, tools, display, voice, status, lsp, and exa tabs\n- Migrated environment variables from PI_ to OMP_ prefix with automatic migration\n- Updated model selector to use TabBar component for provider navigation\n- Changed role badges to inverted style with colored backgrounds\n- Added support for /models command alias in addition to /model\n- Improved error retry detection to include fetch failures\n- Enhanced session selector search and overflow handling\n- Updated skill command execution to include skill path metadata\n- Surfaced loaded prompt templates during initialization\n- Updated compaction summarization to use serialized prompt text\n- Cleaned up Python prelude `sh()` and `run()` output to only show stdout/stderr without noisy metadata\n\n### Fixed\n\n- Fixed Python kernel cancellation handling and WebSocket cleanup for in-flight executions\n- Fixed Python tool session scoping to include workdir and honor sharedGateway settings\n- Fixed gist sharing output draining to avoid truncated URLs\n- Fixed streaming output byte accounting and UTF-8 decoder flushing\n- Fixed Python prelude integration tests to detect virtual environments and cover helper exports\n- Fixed Python kernel cancellation/timeout handling and WebSocket close cleanup for in-flight executions\n- Fixed Python output byte accounting and UTF-8 decoder flushing in streaming output\n- Fixed shared Python gateway coordination (Windows env allowlist, lock staleness, refcount recovery)\n- Fixed Python tool session scoping to include workdir and honor sharedGateway settings\n- Fixed subagent Python proxy session isolation and cancellation/timeout propagation\n- Fixed print-mode cleanup to dispose Python sessions before exit\n- Fixed gist share output draining to avoid truncated URLs\n- Fixed explore agent tool list to use bash for git operations\n- Fixed Python prelude integration tests to detect venv-only Python and cover helper exports\n\n### Security\n\n- Enhanced Python gateway environment filtering to exclude sensitive API keys and Windows system paths\n\n## [5.5.0] - 2026-01-18\n\n### Changed\n\n- Updated task execution guidelines to improve prompt framing and parallelization instructions\n\n## [5.4.2] - 2026-01-16\n\n### Changed\n\n- Updated model resolution to accept pre-serialized settings for better performance\n- Improved system prompt guidance for position-addressed vs content-addressed file edits\n- Enhanced edit tool documentation with clear use cases for bash alternatives\n\n## [5.3.0] - 2026-01-15\n\n### Changed\n\n- Expanded bash tool guidance to explicitly list appropriate use cases including file operations, build commands, and process management\n\n## [5.2.1] - 2026-01-14\n\n### Fixed\n\n- Fixed stale diagnostic results by tracking diagnostic versions before file sync operations\n- Fixed race condition where LSP diagnostics could return outdated results after file modifications\n\n## [5.2.0] - 2026-01-14\n\n### Added\n\n- Added `withLines` parameter to read tool for optional line number output (default: true, cat -n format)\n\n### Changed\n\n- Changed find/grep/ls tool output to render inline without background box for cleaner visual flow\n\n### Fixed\n\n- Fixed task tool abort to return partial results instead of failing (completed tasks preserved, cancelled tasks shown as skipped)\n- Fixed TUI crash when bash output metadata lines exceed terminal width on narrow terminals\n- Fixed find tool not matching `**/filename` patterns (was incorrectly using `--full-path` for glob depth wildcards)\n\n## [5.1.1] - 2026-01-14\n\n### Fixed\n\n- Fixed clipboard image paste getting stuck on Wayland when no image is present (was falling back to X11 and timing out)\n\n## [5.1.0] - 2026-01-14\n\n### Changed\n\n- Updated light theme colors for WCAG AA compliance (4.5:1 contrast against white background)\n- Changed dequeue hint text from \"restore\" to \"edit all queued messages\"\n\n### Fixed\n\n- Fixed session selector staying open when current folder has no sessions (shows hint to press Tab)\n- Fixed print mode JSON output to emit session header at start\n- Fixed \"database is locked\" SQLite errors when running subagents by serializing settings to workers instead of opening the database\n- Fixed `/new` command to create a new session file (previously reused the same file when `--session` was specified)\n- Fixed session selector page up/down navigation\n\n## [5.0.1] - 2026-01-12\n\n### Changed\n\n- Replaced wasm-vips with Photon for more stable WASM image processing\n- Added graceful fallback to original images when image resizing fails\n- Added error handling for image conversion failures in interactive mode to prevent crashes\n- Replace wasm-vips with Photon for more stable WASM image processing (fixes worker thread crashes)\n\n## [5.0.0] - 2026-01-12\n\n### Added\n\n- Implemented `xhigh` thinking level for Anthropic models with increased reasoning limits\n\n## [4.8.3] - 2026-01-12\n\n### Changed\n\n- Replace sharp with wasm-vips for cross-platform image processing without native dependencies\n\n## [4.8.1] - 2026-01-12\n\n### Fixed\n\n- Prevent bun from statically resolving sharp import to fix runtime errors on arm64\n\n## [4.8.0] - 2026-01-12\n\n### Fixed\n\n- Move `sharp` to optional dependencies with all platform binaries to fix arm64 runtime errors\n\n## [4.7.0] - 2026-01-12\n\n### Added\n\n- Add `omp config` subcommand for managing settings (`list`, `get`, `set`, `reset`, `path`)\n- Add `todoCompletion` setting to warn agent when it stops with incomplete todos (up to 3 reminders)\n- Add multi-part questions support to `ask` tool via `questions` array parameter\n\n### Changed\n\n- Updated multi-select cursor behavior in `ask` tool to stay on the toggled option instead of jumping to top\n- Single-file reads now render inline (e.g., `Read AGENTS.md:23`) instead of tree structure\n\n### Fixed\n\n- Subagent model resolution now respects explicit provider prefix (e.g., `zai/glm-4.7` no longer matches `cerebras/zai-glm-4.7`)\n- Auto-compaction now skips to next model candidate when retry delay exceeds 30 seconds\n\n## [4.6.0] - 2026-01-12\n\n### Added\n\n- Add `/skill:name` slash commands for quick skill access (toggle via `skills.enableSkillCommands` setting)\n- Add `cwd` to SessionInfo for session list display\n- Add custom summarization instructions option in tree selector\n- Add Alt+Up (dequeue) to restore all queued messages at once\n- Add `shutdownRequested` and `checkShutdownRequested()` for extension-initiated shutdown\n\n### Fixed\n\n- Component `invalidate()` now properly rebuilds content on theme changes\n- Force full re-render after returning from external editor\n\n## [4.4.8] - 2026-01-12\n\n### Changed\n\n- Changed review finding priority format from numeric (0-3) to string labels (P0-P3) for clearer severity indication\n- Replaced Type.Union with Type.Literal patterns with StringEnum helper across tool schemas for cleaner enum definitions\n\n## [4.4.5] - 2026-01-11\n\n### Changed\n\n- Removed `format: \"date-time\"` from timestamp type conversion in JTD to JSON Schema transformation\n- Reorganized system prompt to display context, environment, and tools sections before discipline guidelines\n- Updated system prompt to show file paths more clearly in output\n- Improved YAML frontmatter parsing with better error messages including source file information\n\n### Fixed\n\n- Fixed frontmatter parsing to properly report source location when YAML parsing fails\n\n## [4.4.4] - 2026-01-11\n\n### Added\n\n- Added `todo_write` tool for creating and managing structured task lists during coding sessions\n- Added persistent todo panel above the editor that displays task progress\n- Added `Ctrl+T` keybinding to toggle todo list expansion\n- Added grouped display for consecutive Read tool calls, showing multiple file reads in a compact tree view\n- Added `todo_write` tool and persistent todo panel above the editor\n\n### Changed\n\n- Changed `Ctrl+Enter` to insert a newline when not streaming (previously `Alt+Enter`)\n- Changed `Ctrl+T` from toggling thinking block visibility to toggling todo list expansion\n- Changed system prompt to use more direct, field-oriented language with emphasis on verification and assumptions\n- Changed temporary model selector keybinding from Ctrl+Y to Alt+P\n- Changed expand hint text from \"Ctrl+O to expand\" to \"Ctrl+O for more\"\n- Changed Read tool result display to hide content by default, showing only file path and status\n- Changed `Ctrl+T` to toggle todo panel expansion\n\n### Removed\n\n- Removed `yaml` package dependency in favor of Bun's built-in YAML parser\n\n### Fixed\n\n- Fixed Alt+Enter to insert a newline when not streaming, instead of submitting the message\n- Fixed Alt+Enter inserting a new line when not streaming instead of submitting a message\n- Fixed Cursor provider to avoid advertising the Edit tool, relying on full-file Write operations instead\n- Fixed prompt template loading to strip leading HTML comment metadata blocks\n\n## [4.3.2] - 2026-01-11\n\n### Changed\n\n- Increased default bash output preview from 5 to 10 lines when collapsed\n- Updated expanded bash output view to show full untruncated output when available\n\n## [4.3.1] - 2026-01-11\n\n### Changed\n\n- Expanded system prompt with defensive reasoning guidance and assumption checks\n- Allowed agent frontmatter to override subagent thinking level, clamped to model capabilities\n\n### Fixed\n\n- Ensured reviewer agents use structured output schemas and include reported findings in task outputs\n\n## [4.3.0] - 2026-01-11\n\n### Added\n\n- Added Cursor provider support with browser-based OAuth authentication\n- Added default model configuration for Cursor provider (claude-sonnet-4-5)\n- Added execution bridge for Cursor tool calls including read, ls, grep, write, delete, shell, diagnostics, and MCP operations\n\n### Fixed\n\n- Improved fuzzy matching accuracy for edit operations when file and target have inconsistent indentation patterns\n\n## [4.2.3] - 2026-01-11\n\n### Changed\n\n- Changed default for `hidden` option in find tool from `false` to `true`, now including hidden files by default\n\n### Fixed\n\n- Fixed serialized auth storage initialization so OAuth refreshes in subagents don't crash\n\n## [4.2.2] - 2026-01-11\n\n### Added\n\n- Added persistent cache storage for Codex usage data that survives application restarts\n- Added `--no-lsp` to disable LSP tools, formatting, diagnostics, and warmup for a session\n\n### Changed\n\n- Changed `SettingsManager.create()` to be async, requiring `await` when creating settings managers\n- Changed `loadSettings()` to be async, requiring `await` when loading settings\n- Changed `discoverSkills()` to be async, requiring `await` when discovering skills\n- Changed `loadSlashCommands()` to be async, requiring `await` when loading slash commands\n- Changed `buildSystemPrompt()` to be async, requiring `await` when building system prompts\n- Changed `loadSkills()` to be async, requiring `await` when loading skills\n- Changed `loadProjectContextFiles()` to be async, requiring `await` when loading context files\n- Changed `getShellConfig()` to be async, requiring `await` when getting shell configuration\n- Changed capability provider `load()` methods to be async-only, removing synchronous `loadSync` API\n- Updated `plan` agent with enhanced structured planning process, parallel exploration via `explore` agent spawning, and improved output format with examples\n- Removed `planner` agent command template, consolidating planning functionality into the `plan` agent\n\n## [4.2.1] - 2026-01-11\n\n### Added\n\n- Added automatic discovery and listing of AGENTS.md files in the system prompt, providing agents with an authoritative list of project-specific instruction files without runtime searching\n- Added `planner` built-in agent for comprehensive implementation planning with slow model\n\n### Changed\n\n- Refactored skill discovery to use unified `loadSkillsFromDir` helper across all providers, reducing code duplication\n- Updated skill discovery to scan only `skills/*/SKILL.md` entries instead of recursive walks in Codex provider\n- Added guidance to Task tool documentation to isolate file scopes when assigning tasks to prevent agent conflicts\n- Updated Task tool documentation to emphasize that subagents have no access to conversation history and require all relevant context to be explicitly passed\n- Revised task agent prompt to clarify that subagents have full tool access and can make file edits, run commands, and create files\n- OpenAI Codex: updated to use bundled system prompt from upstream\n- Changed `complete` tool to make `data` parameter optional when aborting, while still requiring it for successful completions\n- Skills discovery now scans only `skills/*/SKILL.md` entries instead of recursive walks\n\n### Removed\n\n- Removed `architect-plan`, `implement`, and `implement-with-critic` built-in agent commands\n\n### Fixed\n\n- Fixed editor border rendering glitch after canceling slash command autocomplete\n- Fixed login/logout credential path message to reference agent.db\n\n## [4.2.0] - 2026-01-10\n\n### Added\n\n- Added `/dump` slash command to copy the full session transcript to the clipboard\n- Added automatic Nerd Fonts detection for terminals like iTerm, WezTerm, Kitty, Ghostty, and Alacritty to set appropriate symbol preset\n- Added `NERD_FONTS` environment variable override (`1` or `0`) to manually control Nerd Fonts symbol preset\n- Added Handlebars templating engine for prompt template rendering with `{{arg}}` helper for positional arguments\n- Added support for custom share scripts at ~/.omp/agent/share.ts to replace default GitHub Gist sharing\n\n### Changed\n\n- Changed rules system to use `read` tool for loading rule content instead of dedicated `rulebook` tool\n- Separated `/export` and `/dump` commands\u2014`/export` now only exports to HTML file, while `/dump` copies session transcript to clipboard\n- Updated `/export` command to no longer accept `--copy` flag (use `/dump` instead)\n- Changed prompt template rendering to use Handlebars instead of simple string replacement\n- Updated prompt layout optimization to normalize indentation and collapse excessive blank lines\n- Changed auth migration to merge credentials per-provider instead of skipping when any credentials exist in database\n- Migrated settings and auth credential storage from JSON files to SQLite database (agent.db)\n- Updated credential migration message to reference agent.db instead of auth.json\n- Renamed Glob tool references to Find tool throughout prompts and documentation\n- Updated project context formatting to use XML-style tags for clearer structure\n- Refined bash tool guidance to prefer dedicated tools (read/grep/find/ls) over bash for file operations\n- Updated system prompt with clearer tone guidelines emphasizing directness and conciseness\n- Revised workflow instructions to require explicit planning for non-trivial tasks\n- Enhanced verification guidance to prefer external feedback loops like tests and linters\n- Added explicit alignment and prohibited behavior sections to improve response quality\n\n### Removed\n\n- Removed `rulebook` tool - rules are now loaded via the `read` tool instead of a dedicated tool\n\n### Fixed\n\n- Fixed message submission lag caused by synchronous history database writes by deferring DB operations with setImmediate\n\n### Security\n\n- Hardened file permissions on agent database directory (700) and database file (600) to restrict access\n\n## [4.1.0] - 2026-01-10\n\n### Added\n\n- Added persistent prompt history with SQLite-backed storage and Ctrl+R search\n\n### Fixed\n\n- Fixed credential blocking logic to correctly check for remaining available credentials instead of always returning true\n\n## [4.0.1] - 2026-01-10\n\n### Added\n\n- Added usage limit error detection to enable automatic credential switching when Codex accounts hit rate limits\n- Added Codex usage API integration to proactively check account limits before credential selection\n- Added credential backoff tracking to temporarily skip rate-limited accounts during selection\n- Multi-credential usage-aware selection for OpenAI Codex OAuth accounts with automatic fallback when rate limits are reached\n- Consistent session-to-credential hashing (FNV-1a) for stable credential assignment across sessions\n- Codex usage API integration to detect and cache rate limit status per account\n- Automatic mid-session credential switching when usage limits are hit\n\n### Changed\n\n- Changed credential selection to use deterministic FNV-1a hashing for consistent session-to-credential mapping\n- Changed OAuth credential resolution to try credentials in priority order, skipping blocked ones\n\n## [4.0.0] - 2026-01-10\n\n### Added\n\n- Exported `InteractiveModeOptions` type for programmatic SDK usage\n- Exported additional UI components for extensions: `ArminComponent`, `AssistantMessageComponent`, `BashExecutionComponent`, `BranchSummaryMessageComponent`, `CompactionSummaryMessageComponent`, `CustomEditor`, `CustomMessageComponent`, `FooterComponent`, `ExtensionEditorComponent`, `ExtensionInputComponent`, `ExtensionSelectorComponent`, `LoginDialogComponent`, `ModelSelectorComponent`, `OAuthSelectorComponent`, `SessionSelectorComponent`, `SettingsSelectorComponent`, `ShowImagesSelectorComponent`, `ThemeSelectorComponent`, `ThinkingSelectorComponent`, `ToolExecutionComponent`, `TreeSelectorComponent`, `UserMessageComponent`, `UserMessageSelectorComponent`\n- Exported `renderDiff`, `truncateToVisualLines`, and related types for extension use\n- `setFooter()` and `setHeader()` methods on `ExtensionUIContext` for custom footer/header components\n- `setEditorComponent()` method on `ExtensionUIContext` for custom editor components\n- `supportsUsageInStreaming` model config option to control `stream_options: { include_usage: true }` behavior\n- Terminal setup documentation for Kitty keyboard protocol configuration (Ghostty, wezterm, Windows Terminal)\n- Documentation for paid Cloud Code Assist subscriptions via `GOOGLE_CLOUD_PROJECT` env var\n- Environment variables reference section in README\n- `--no-tools` flag to disable all built-in tools, enabling extension-only setups\n- `--no-extensions` flag to disable extension discovery while still allowing explicit `-e` paths\n- `blockImages` setting to prevent images from being sent to LLM providers\n- `thinkingBudgets` setting to customize token budgets per thinking level\n- `PI_SKIP_VERSION_CHECK` environment variable to disable new version notifications at startup\n- Anthropic OAuth support via `/login` to authenticate with Claude Pro/Max subscription\n- OpenCode Zen provider support via `OPENCODE_API_KEY` env var and `opencode/` syntax\n- Session picker (`pi -r`) and `--session` flag support searching/resuming by session ID (UUID prefix)\n- Session ID forwarding to LLM providers for session-based caching (used by OpenAI Codex for prompt caching)\n- `dequeue` keybinding (`Alt+Up`) to restore queued steering/follow-up messages back into the editor\n- Pluggable operations for built-in tools enabling remote execution via SSH or other transports (`ReadOperations`, `WriteOperations`, `EditOperations`, `BashOperations`, `LsOperations`, `GrepOperations`, `FindOperations`)\n- `/model ` pre-filters the model selector or auto-selects on exact match; use `provider/model` syntax to disambiguate\n- Managed binaries directory (`~/.omp/bin/`) for fd and rg tools\n- `FooterDataProvider` for custom footers with `getGitBranch()`, `getExtensionStatuses()`, and `onBranchChange()`\n- `ctx.ui.custom()` accepts `{ overlay: true }` option for floating modal components\n- `ctx.ui.getAllThemes()`, `ctx.ui.getTheme(name)`, `ctx.ui.setTheme(name | Theme)` for theme management\n- `setActiveTools()` for dynamic tool management\n- `setModel()`, `getThinkingLevel()`, `setThinkingLevel()` methods for runtime model and thinking level changes\n- `ctx.shutdown()` for requesting graceful shutdown\n- `pi.sendUserMessage()` for sending user messages from extensions\n- Extension UI dialogs (`select`, `confirm`, `input`) support `timeout` option with live countdown display\n- Extension UI dialogs accept optional `AbortSignal` to programmatically dismiss dialogs\n- Async extension factories for dynamic imports and lazy-loaded dependencies\n- `user_bash` event for intercepting user `!`/`!!` commands\n- Built-in renderers used automatically for tool overrides without custom `renderCall`/`renderResult`\n- `InteractiveMode`, `runPrintMode()`, `runRpcMode()` exported for building custom run modes\n- Copy link button on messages for deep linking to specific entries\n- Codex injection info display showing system prompt modifications\n- URL parameter support for `leafId` and `targetId` deep linking\n- Wayland clipboard support for `/copy` command using wl-copy with xclip/xsel fallback\n\n### Changed\n\n- Bash tool output truncation now recalculates on terminal resize instead of using cached width\n- Web search tool headers updated to match Claude Code client format for better compatibility\n- `discoverSkills()` return type documented as `{ skills: Skill[], warnings: SkillWarning[] }` in SDK docs\n- Default model for OpenCode provider changed from `claude-sonnet-4-5` to `claude-opus-4-5`\n- Terminal color mode detection defaults to truecolor for modern terminals instead of 256color\n- System prompt restructured with XML tags and clearer instructions format\n- `before_agent_start` event receives `systemPrompt` in the event object and returns `systemPrompt` (full replacement) instead of `systemPromptAppend`\n- `discoverSkills()` returns `{ skills: Skill[], warnings: SkillWarning[] }` instead of `Skill[]`\n- `ctx.ui.custom()` factory signature changed from `(tui, theme, done)` to `(tui, theme, keybindings, done)`\n- `ExtensionRunner.initialize()` signature changed from options object to positional params `(actions, contextActions, commandContextActions?, uiContext?)`\n\n### Fixed\n\n- Wayland clipboard copy (`wl-copy`) no longer blocks when the process doesn't exit promptly\n- Empty `--tools` flag now correctly enables all built-in tools instead of disabling them\n- Bash tool handles spawn errors gracefully instead of crashing the agent\n- Components properly rebuild their content on theme change via `invalidate()` override\n- `setTheme()` triggers a full rerender so previously rendered components update with new theme colors\n- Session ID updates correctly when branching sessions\n- External edits to `settings.json` while pi is running are preserved when pi saves settings\n- Default thinking level from settings applies correctly when `enabledModels` is configured\n- LM Studio compatibility for OpenAI Responses tool strict mapping\n- Symlinked directories in `prompts/` folders are followed when loading prompt templates\n- String `systemPrompt` in `createAgentSession()` works as a full replacement instead of having context files and skills appended\n- Update notification for bun binary installs shows release download URL instead of npm command\n- ESC key works during \"Working...\" state after auto-retry\n- Abort messages show correct retry attempt count\n- Antigravity provider returning 429 errors despite available quota\n- Malformed thinking text in Gemini/Antigravity responses where thinking content appeared as regular text\n- `--no-skills` flag correctly prevents skills from loading in interactive mode\n- Overflow-based compaction skips if error came from a different model or was already handled\n- OpenAI Codex context window reduced from 400k to 272k tokens to match Codex CLI defaults\n- Context overflow detection recognizes `context_length_exceeded` errors\n- Key presses no longer dropped when input is batched over SSH\n- Clipboard image support works on Alpine Linux and other musl-based distros\n- Queued steering/follow-up messages no longer wipe unsent editor input\n- OAuth token refresh failure no longer crashes app at startup\n- Status bar shows correct git branch when running in a git worktree\n- Ctrl+V clipboard image paste works on Wayland sessions\n- Extension directories in `settings.json` respect `package.json` manifests\n\n## [3.37.0] - 2026-01-10\n\n### Changed\n\n- Improved bash command display to show relative paths for working directories within the current directory, and hide redundant `cd` prefix when working directory matches current directory\n\n## [3.36.0] - 2026-01-10\n\n### Added\n\n- Added `calc` tool for basic mathematical calculations with support for arithmetic operators, parentheses, and hex/binary/octal literals\n- Added support for multiple API credentials per provider with round-robin distribution across sessions\n- Added file locking for auth.json to prevent concurrent write corruption\n- Added clickable OAuth login URL display in terminal\n- Added `workdir` parameter to bash tool to execute commands in a specific directory without requiring `cd` commands\n\n### Changed\n\n- Updated bash tool rendering to display working directory context when `workdir` parameter is used\n\n### Fixed\n\n- Fixed completion notification to only send when interactive mode is in foreground\n- Improved completion notification message to include session title when available\n\n## [3.35.0] - 2026-01-09\n\n### Added\n\n- Added retry logic with exponential backoff for auto-compaction failures\n- Added fallback to alternative models when auto-compaction fails with the primary model\n- Added support for `pi/` model aliases in task tool (e.g., `pi/slow`, `pi/default`)\n- Added visual cycle indicator when switching between role models showing available roles\n- Added automatic model inheritance for subtasks when parent uses default model\n- Added `--` separator in grep tool to prevent pattern interpretation as flags\n\n### Changed\n\n- Changed role model cycling to remember last selected role instead of matching current model\n- Changed edit tool to merge call and result displays into single block\n- Changed model override behavior to persist in settings when explicitly set via CLI\n\n### Fixed\n\n- Fixed retry-after parsing from error messages supporting multiple header formats (retry-after, retry-after-ms, x-ratelimit-reset)\n- Fixed image attachments being dropped when steering/follow-up messages are queued during streaming\n- Fixed image auto-resize not applying to clipboard images before sending\n- Fixed clipboard image attachments being dropped when steering/follow-up messages are queued while streaming\n- Fixed clipboard image attachments ignoring the auto-resize setting before sending\n\n## [3.34.0] - 2026-01-09\n\n### Added\n\n- Added caching for system environment detection to improve startup performance\n- Added disk usage information to automatic environment detection in system prompt\n- Added `compat` option for SSH hosts to wrap commands in a POSIX shell on Windows systems\n- Added automatic working directory handling for PowerShell and cmd.exe on Windows SSH hosts\n- Added automatic environment detection to system prompt including OS, distro, kernel, CPU, GPU, shell, terminal, desktop environment, and window manager information\n- Added SSH tool with project ssh.json/.ssh.json discovery, persistent connections, and optional sshfs mounts\n- Added SSH host OS/shell detection with compat mode and persistent host info cache\n\n### Changed\n\n- Changed GPU detection on Linux to prioritize discrete GPUs (NVIDIA, AMD) over integrated graphics and skip server management adapters\n- Changed SSH host info cache to use versioned format for automatic refresh on schema changes\n- Changed SSH compat shell detection to actively probe for bash/sh availability on Windows hosts\n- Changed SSH tool description to show detected shell type and available commands per host\n\n## [3.33.0] - 2026-01-08\n\n### Added\n\n- Added `env` support in `settings.json` for automatically setting environment variables on startup\n- Added environment variable management methods to SettingsManager (get/set/clear)\n\n### Fixed\n\n- Fixed bash output previews to recompute on resize, preventing TUI line width overflow crashes\n- Fixed session title generation to retry alternate smol models when the primary model errors or is rate-limited\n- Fixed file mentions to resolve extensionless paths and directories, using read tool truncation limits for injected content\n- Fixed interactive UI to show auto-read file mention indicators\n- Fixed task tool tree rendering to use consistent tree connectors for progress, findings, and results\n- Fixed last-branch tree connector symbol in the TUI\n- Fixed output tool previews to use compact JSON when outputs are formatted with leading braces\n\n## [3.32.0] - 2026-01-08\n\n### Added\n\n- Added progress indicator when starting LSP servers at session startup\n- Added bundled `/init` slash command available by default\n\n### Changed\n\n- Changed LSP server warmup to use a 5-second timeout, falling back to lazy initialization for slow servers\n\n### Fixed\n\n- Fixed Task tool subagent model selection to inherit explicit CLI `--model` overrides\n\n## [3.31.0] - 2026-01-08\n\n### Added\n\n- Added temporary model selection: `Ctrl+Y` opens model selector for session-only model switching (not persisted to settings)\n- Added `setModelTemporary()` method to AgentSession for ephemeral model changes\n- Added empty Enter to flush queued messages: pressing Enter with empty editor while streaming aborts current stream\n- Added auto-chdir to temp directories when starting in home unless `--allow-home` is set\n- Added upfront diff parsing and filtering for code review command to exclude lock files, generated code, and binary assets\n\n### Fixed\n\n- Fixed auto-chdir to only use existing directories and fall back to `tmpdir()`\n- Added automatic reviewer agent count recommendation based on diff weight and file count\n- Added file grouping guidance for parallel review distribution across multiple agents\n- Added diff preview mode for large changesets that exceed size thresholds\n- Added in-memory session storage implementation for testing and ephemeral sessions\n- Added `createToolUIKit` helper to consolidate common UI formatting utilities across tool renderers\n- Added configurable bash interceptor rules via `bashInterceptor.patterns` setting for custom command blocking\n- Added `bashInterceptor.simpleLs` setting to control interception of bare ls commands\n- Added LSP server configuration via external JSON defaults file for easier customization\n- Added abort signal propagation to web scrapers for improved cancellation handling\n- Added `diagnosticsVersion` tracking to LSP client for more reliable diagnostic polling\n- Added 80+ specialized web scrapers for structured content extraction from popular sites including GitHub, GitLab, npm, PyPI, crates.io, Wikipedia, YouTube, Stack Overflow, Hacker News, Reddit, arXiv, PubMed, and many more\n- Added site-specific API integrations for package registries (npm, PyPI, crates.io, Hex, Hackage, NuGet, Maven, RubyGems, Packagist, pub.dev, Go packages)\n- Added scrapers for social platforms (Mastodon, Bluesky, Lemmy, Lobsters, Dev.to, Discourse)\n- Added scrapers for academic sources (arXiv, bioRxiv, PubMed, Semantic Scholar, ORCID, CrossRef, IACR)\n- Added scrapers for security databases (NVD, OSV, CISA KEV)\n- Added scrapers for documentation sites (MDN, Read the Docs, RFC Editor, W3C, SPDX, tldr, cheat.sh)\n- Added scrapers for media platforms (YouTube, Vimeo, Spotify, Discogs, MusicBrainz)\n- Added scrapers for AI/ML platforms (Hugging Face, Ollama)\n- Added scrapers for app stores and marketplaces (VS Code Marketplace, JetBrains Marketplace, Firefox Add-ons, Open VSX, Flathub, F-Droid, Snapcraft)\n- Added scrapers for business data (SEC EDGAR, OpenCorporates, CoinGecko)\n- Added scrapers for reference sources (Wikipedia, Wikidata, OpenLibrary, Choose a License)\n- Fixed session persistence to call fsync before renaming temp file for durability\n- Fixed duplicate persistence error logging by tracking whether error was already reported\n- Fixed byte counting in task output truncation to correctly handle multi-byte Unicode characters\n- Fixed parallel task execution to propagate abort signals and fail fast on first error\n- Fixed task worker abort handling to properly clean up on cancellation\n- Fixed parallel task execution to fail fast on first error instead of waiting for all workers\n- Fixed byte counting in task output truncation to handle multi-byte Unicode characters correctly\n\n### Changed\n\n- Changed `Ctrl+P` to cycle through role models (slow \u2192 default \u2192 smol) instead of all available models\n- Changed `Shift+Ctrl+P` to cycle role models temporarily (not persisted)\n- Changed Extension Control Center to scale with terminal height instead of fixed 25-line limit\n- Changed review command to parse git diff upfront and provide structured context to reviewer agents\n- Changed session persistence to use structured logging instead of console.error for persistence failures\n- Changed find tool to use fd command for .gitignore discovery instead of Bun.Glob for better abort handling\n- Changed LSP config loading to only mark overrides when servers are actually defined\n- Changed task tool to require explicit task `id` field instead of auto-generating names from agent type\n- Changed grep and find tools to use native Bun file APIs instead of Node.js fs module for improved performance\n- Changed YouTube scraper to use async command execution with proper stream handling\n- Improved rust-analyzer diagnostic polling to use version-based stability detection instead of time-based delays\n- Changed theme icons for extension types to use Unicode symbols (\u2727, \u2692) instead of text abbreviations (SK, TL, MCP)\n- Changed task tool to use short CamelCase task IDs instead of agent-based naming (e.g., 'SessionStore' instead of 'explore_0')\n- Changed task tool to accept single `agent` parameter at top level instead of per-task agent specification\n- Changed reviewer agent to use `complete` tool instead of `submit_review` for finishing reviews\n- Changed theme icons for extensions to use Unicode symbols instead of text abbreviations\n- Changed LSP file type matching to support exact filename matches in addition to extensions\n- Improved rust-analyzer diagnostic polling to use version-based stability detection\n- Refactored web-fetch tool to use modular scraper architecture for improved maintainability\n\n### Removed\n\n- Removed `submit_review` tool - reviewers now finish via `complete` tool with structured output\n\n## [3.30.0] - 2026-01-07\n\n### Added\n\n- Added environment variable configuration for task limits: `OMP_TASK_MAX_PARALLEL`, `OMP_TASK_MAX_CONCURRENCY`, `OMP_TASK_MAX_OUTPUT_BYTES`, `OMP_TASK_MAX_OUTPUT_LINES`, and `OMP_TASK_MAX_AGENTS_IN_DESCRIPTION`\n- Added specialized web-fetch handlers for 50+ platforms including GitHub, GitLab, npm, PyPI, crates.io, Stack Overflow, Wikipedia, arXiv, PubMed, Hacker News, Reddit, Mastodon, Bluesky, and many more\n- Added automatic yt-dlp installation for YouTube transcript extraction\n- Added YouTube video support with automatic transcript extraction via yt-dlp\n\n### Changed\n\n- Changed task executor to gracefully handle worker termination with proper cleanup and timeout handling\n\n### Fixed\n\n- Fixed Lobsters front page handler to use correct API endpoint (`/hottest.json` instead of invalid `.json`)\n- Fixed task worker error handling to prevent hanging on worker crashes, uncaught errors, and unhandled rejections\n- Fixed double-stringified JSON output from subagents being returned as escaped strings instead of parsed objects\n- Fixed markitdown tool installation to use automatic tool installer instead of requiring manual installation\n\n## [3.25.0] - 2026-01-07\n\n### Added\n\n- Added `complete` tool for structured subagent output with JSON schema validation\n- Added `query` parameter to output tool for jq-like JSON querying\n- Added `output_schema` parameter to task tool for structured subagent completion\n- Added JTD (JSON Type Definition) to JSON Schema converter for schema flexibility\n- Added memorable two-word task identifiers (e.g., SwiftFalcon) for better task tracking\n\n### Changed\n\n- Changed task output IDs from `agent_index` format to memorable names for easier reference\n- Changed subagent completion flow to require explicit `complete` tool call with retry reminders\n- Simplified worker agent system prompt to be more concise and focused\n\n## [3.24.0] - 2026-01-07\n\n### Added\n\n- Added `ToolSession` interface to unify tool creation with session context including cwd, UI availability, and rulebook rules\n- Added Bun Worker-based execution for subagent tasks, replacing subprocess spawning for improved performance and event streaming\n- Added `toolNames` option to filter which built-in tools are included in agent sessions\n- Added `BUILTIN_TOOLS` registry constant for programmatic access to available tool factories\n- Added unit tests for `createTools` function covering tool filtering and conditional tool creation\n\n### Changed\n\n- Changed subagent execution from spawning separate `omp` processes to running in Bun Workers with direct event streaming\n- Changed tool factories to accept `ToolSession` parameter instead of separate cwd and options arguments\n- Changed `createTools` to return tools as a Map and support conditional tool creation based on session context\n- Changed system prompt builder to dynamically generate tool descriptions from the tool registry\n- Changed task tool description to be generated from a template with dynamic agent list injection\n- Changed tool creation to use a unified `ToolSession` interface instead of separate parameters for cwd, options, and callbacks\n- Changed `createTools` to return tools as a Map instead of an array for consistent tool registry access\n- Changed system prompt builder to receive tool registry Map for dynamic tool description generation\n- Changed subprocess usage tracking to accumulate incrementally from message_end events rather than parsing stored events after completion\n\n### Removed\n\n- Removed `browser` embedded agent from task tool agent discovery\n- Removed `recursive` property from agent definitions\n- Removed environment variables `OMP_NO_SUBAGENTS`, `OMP_BLOCKED_AGENT`, and `OMP_SPAWNS` for subagent control\n- Removed pre-instantiated tool exports (`readTool`, `bashTool`, `editTool`, `writeTool`, `grepTool`, `findTool`, `lsTool`) in favor of factory functions\n- Removed `createCodingTools` and `createReadOnlyTools` helper functions\n- Removed `codingTools` and `readOnlyTools` convenience exports\n- Removed `wrapToolsWithExtensions` function from extensions API\n- Removed `hidden` property support from custom tools\n- Removed subagent and question custom tool examples\n\n### Fixed\n\n- Fixed memory accumulation in task subprocess by streaming events directly to disk instead of storing in memory\n- Fixed session persistence to exclude transient streaming data (partialJson, jsonlEvents) that was causing unnecessary storage bloat\n- Fixed createTools respecting explicit tool lists instead of returning all non-hidden tools\n\n## [3.21.0] - 2026-01-06\n\n### Changed\n\n- Switched from local `@oh-my-pi/pi-ai` to upstream `@mariozechner/pi-ai` package\n- Refactored tool renderers to be co-located with their respective tool implementations for improved code organization\n- Changed web search to try all configured providers in sequence with fallback before reporting errors\n- Changed default Anthropic web search model from `claude-sonnet-4-5-20250514` to `claude-haiku-4-5`\n- Changed read tool to show first 50KB of oversized lines instead of directing users to bash sed\n- Changed web_fetch to use `Bun.which()` instead of spawning `which`/`where` for command detection\n- Changed web_fetch to check Content-Length header before downloading to reject oversized files early\n- Changed generate_image tool to save images to temp files and report paths instead of inline base64\n- Changed system prompt with tool usage guidance (ground answers with tools, minimize context, iterate on results)\n- Changed Task tool prompt with plan-then-execute guidance and output tool hints\n- Changed edit tool success message to report count when replacing multiple occurrences with `all: true`\n- Changed default image generation model to `gemini-3-pro-image-preview`\n- Changed error message for multiple occurrences to suggest using `all: true` option\n- Changed web_fetch tool label from `web_fetch` to `Web Fetch` for improved display\n- Changed argument substitution order in slash commands to process positional args ($1, $2) before wildcards ($@, $ARGUMENTS) to prevent re-substitution issues\n- Changed image tool name from `gemini_image` to `generate_image` with label `GenerateImage`\n\n### Added\n\n- Added `webSearchProvider` setting to override auto-detection priority (Exa > Perplexity > Anthropic)\n- Added `imageProvider` setting to override auto-detection priority (OpenRouter > Gemini)\n- Added `git.enabled` setting to enable/disable the structured git tool\n- Added `offset` and `limit` parameters to Output tool for paginated reading of large outputs\n- Added provider fallback chain for web search that tries all configured providers before failing\n- Added bash interceptor rule to block git commands when structured git tool is enabled\n- Added validation requiring `message` parameter for git commit operations (prevents interactive editor)\n- Added output ID hints in multi-agent Task results pointing to Output tool for full logs\n- Added fuzzy matching support for `all: true` mode in edit tool, enabling replacement of similar text blocks with whitespace differences\n- Added `all` parameter to edit tool for replacing all occurrences instead of requiring unique matches\n- Added OpenRouter support for image generation when `OPENROUTER_API_KEY` is set\n- Added ImageMagick fallback for image processing when sharp module is unavailable\n- Added slash commands to the extensions inspector panel for visibility and management\n- Added support for file-based slash commands from `commands/` directories\n- Added `$ARGUMENTS` placeholder for slash command argument substitution, aligning with Claude and Codex conventions\n\n### Fixed\n\n- Fixed read tool markitdown truncation message using broken template string (missing `${` around format call)\n- Fixed web_fetch URL normalization order to run before special handlers\n- Fixed TUI image display for generate_image tool by sourcing images from details.images in addition to content blocks\n- Fixed context file preview in inspector panel to display content correctly instead of attempting async file reads\n- Fixed Linux ARM64 installs failing on fresh Debian when the `sharp` module is unavailable during session image compression\n\n## [3.20.1] - 2026-01-06\n\n### Fixed\n\n- Fixed find tool failing to match patterns with path separators (e.g., `reports/**`) by enabling full-path matching in fd\n\n### Changed\n\n- Changed multi-task display to show task descriptions instead of agent names when available\n- Changed ls tool to show relative modification times (e.g., \"2d ago\", \"just now\") for each entry\n\n## [3.20.0] - 2026-01-06\n\n### Added\n\n- Added extensions API with auto-discovery (`.omp/extensions`) and `--extension`/`-e` loading for custom tools, commands, and lifecycle hooks\n- Added prompt templates loaded from global and project `.omp/prompts` directories with `/template` expansion in the input box\n- Built-in provider overrides in `models.json`: override just `baseUrl` to route a built-in provider through a proxy while keeping all its models, or define `models` to fully replace the provider\n- Shell commands without context contribution: use `!!command` to execute a bash command that is shown in the TUI and saved to session history but excluded from LLM context. Useful for running commands you don't want the AI to see\n- Added VoiceSupervisor class for realtime voice mode using OpenAI Realtime API with continuous mic streaming and semantic VAD turn detection\n- Added VoiceController class for steering user input and deciding presentation of assistant responses\n- Added echo suppression and noise floor filtering for microphone input during voice playback\n- Added fallback transcript handling when realtime assistant produces no tool call or audio output\n- Added voice progress notifications that speak partial results after 15 seconds of streaming\n- Added platform-specific audio tool detection with helpful installation instructions for missing tools\n- Added realtime voice mode using OpenAI gpt-5-realtime with continuous mic streaming, interruptible input, and supervisor-controlled spoken updates\n- Added `gemini_image` tool for Gemini Nano Banana image generation when `GEMINI_API_KEY` (or `GOOGLE_API_KEY`) is set\n- Added `description` field to task tool for displaying short user-facing summaries in progress output\n- Added `getApiKeyForProvider()` method to ModelRegistry for retrieving API keys by provider name\n- Added voice settings configuration for transcription model, TTS model, voice, and audio format\n- Added shared render utilities module with standardized formatting functions for truncation, byte/token/duration display, and tree rendering\n- Added `resolveOmpCommand()` helper to resolve subprocess command from environment or entry point\n- Added `/background` (or `/bg`) command to detach UI and continue agent execution in the background\n- Added completion notification system with configurable methods (bell, osc99, osc9, auto, off) when agent finishes\n- Added `completionNotification` setting to configure how the agent notifies on completion\n- Added `OMP_NOTIFICATIONS` environment variable to suppress notifications globally\n- Added `/wt` slash command for git worktree management with create, list, merge, remove, status, spawn, and parallel operations\n- Added worktree library with collapse strategies (simple, merge-base, rebase) for merging changes between worktrees\n- Added worktree session tracking for managing agent tasks across isolated worktrees\n- Added structured git tool with safety guards, caching, and GitHub operations\n- Added `cycleRoleModels()` method to cycle through configured role-based models in a fixed order with deduplication\n- Added language-specific file icons to LSP diagnostics output showing file locations\n- Added language-specific file icon to edit tool header display\n\n### Changed\n\n- Changed voice mode toggle from Caps Lock to Ctrl+Y with auto-send on silence behavior\n- Changed default TTS model from gpt-4o-mini-tts to tts-1\n- Changed voice mode description to reflect realtime input/output with auto-send on silence\n- Updated hotkeys help to show Ctrl+Y for voice mode toggle instead of Caps Lock\n- Voice mode now uses OpenAI Realtime (gpt-5-realtime) with Ctrl+Y toggle and auto-send on silence\n- Updated web search tool to support `auto` as explicit provider option for auto-detection\n- Standardized tool result rendering across grep, find, ls, notebook, ask, output, and web search tools with consistent tree formatting and expand hints\n- Updated grep and find tool output to display language-specific icons for files and folder icons for directories\n- Updated file listing to display language-specific icons based on file extension instead of generic file icons\n\n### Fixed\n\n- Fixed task tool race condition where subprocess stdout events were skipped due to `resolved` flag being set before stream readers finished, causing completed tasks to display \"0 tools \u00b7 0 tokens\"\n- `/model` selector now opens instantly instead of waiting for OAuth token refresh. Token refresh is deferred until a model is actually used\n- Fixed cross-platform browser opening to work on Windows (via cmd /c start) and fail gracefully when unavailable\n\n## [3.15.1] - 2026-01-05\n\n### Added\n\n- Added 65 new built-in color themes including dark variants (abyss, aurora, cavern, copper, cosmos, eclipse, ember, equinox, lavender, lunar, midnight, nebula, rainforest, reef, sakura, slate, solstice, starfall, swamp, taiga, terminal, tundra, twilight, volcanic), light variants (aurora-day, canyon, cirrus, coral, dawn, dunes, eucalyptus, frost, glacier, haze, honeycomb, lagoon, lavender, meadow, mint, opal, orchard, paper, prism, sand, savanna, soleil, wetland, zenith), and material themes (alabaster, amethyst, anthracite, basalt, birch, graphite, limestone, mahogany, marble, obsidian, onyx, pearl, porcelain, quartz, sandstone, titanium)\n\n### Fixed\n\n- Fixed status line end cap rendering to properly apply background colors and use correct powerline separator characters\n\n## [3.15.0] - 2026-01-05\n\n### Added\n\n- Added spinner type variants (status and activity) with distinct animation frames per symbol preset\n- Added animated spinner for task tool progress display during subagent execution\n- Added language/file type icons for read tool output with support for 35+ file types\n- Added async cleanup registry for graceful session flush on SIGINT, SIGTERM, and SIGHUP signals\n- Added subagent token usage aggregation to session statistics and task tool results\n- Added streaming NDJSON writer for session persistence with proper backpressure handling\n- Added `flush()` method to SessionManager for explicit control over pending write completion\n- Added `/exit` slash command to exit the application from interactive mode\n- Added fuzzy path matching suggestions when read tool encounters file-not-found errors, showing closest matches using Levenshtein distance\n- Added `status.shadowed` symbol for theme customization to properly indicate shadowed extension state\n- Added Biome CLI-based linter client as alternative to LSP for more reliable diagnostics\n- Added LinterClient interface for pluggable formatter/linter implementations\n- Added status line segment editor for arranging and toggling status line components\n- Added status line presets (default, minimal, compact, developer, balanced) for quick configuration\n- Added status line separator styles (powerline, powerline-thin, arrow, slash, pipe, space)\n- Added configurable status line segments including time, hostname, and subagent count\n- Added symbol customization via theme overrides for icons, separators, and glyphs\n- Added 30+ built-in color themes including Catppuccin, Dracula, Nord, Gruvbox, Tokyo Night, and more\n- Added configurable status line with customizable segments, presets, and separators\n- Added status line segment editor for arranging and toggling status line components\n- Added symbol preset setting to switch between Unicode, Nerd Font, and ASCII glyphs\n- Added file size limit (20MB) for image files to prevent memory issues during serialization\n\n### Changed\n\n- Changed `isError` property in tool result events to be optional instead of required\n- Changed `SessionManager.open()` and `SessionManager.continueRecent()` to async methods for proper initialization\n- Changed session file writes to use atomic rename pattern with fsync for crash-safe persistence\n- Changed read tool display to show file type icons and metadata inline with path\n- Changed `AgentSession.dispose()` to async method that flushes pending writes before cleanup\n- Changed read tool result display to hide content by default with expand hint, showing only metadata until expanded\n- Changed diagnostics display to group messages by file with tree structure and severity icons\n- Changed diff stats formatting to use colored +/- indicators with slash separators\n- Changed session persistence to use streaming writes instead of synchronous file appends for better performance\n- Changed read tool to automatically redirect to ls when given a directory path instead of a file\n- Changed tool description prompts to be more concise with clearer usage guidelines and structured formatting\n- Moved tool description prompts from inline strings to external markdown files in `src/prompts/tools/` directory for better maintainability\n- Changed Exa web search provider from MCP protocol to direct REST API for simpler integration\n- Changed web search result rendering to handle malformed response data with fallback text display\n- Changed compaction prompts to preserve tool outputs, command results, and repository state in context summaries\n- Changed init prompt to include runtime/tooling preferences section and improved formatting guidelines\n- Changed reviewer prompt to require evidence-backed findings anchored to diff hunks with stricter suggestion block formatting\n- Changed system prompt to include explicit core behavior guidelines for task completion and progress updates\n- Changed task prompt to emphasize end-to-end task completion and tool verification\n- Moved all prompt templates from inline strings to external markdown files in `src/prompts/` directory for better maintainability\n- Changed tool result renderers to use structured tree layouts with consistent expand hints and truncation indicators\n- Changed grep, find, and ls tools to show scope path and detailed truncation reasons in output\n- Changed web search and web fetch result rendering to display structured metadata sections with bounded content previews\n- Changed task/subagent progress rendering to use badge-style status labels and structured output sections\n- Changed notebook tool to display cell content preview with line counts\n- Changed ask tool result to show checkbox-style selection indicators\n- Changed output tool to include provenance metadata and content previews for retrieved outputs\n- Changed collapsed tool views to show consistent \"Ctrl+O to expand\" hints with remaining item counts\n- Changed Biome integration to use CLI instead of LSP to avoid stale diagnostics issues\n- Changed hardcoded UI symbols throughout codebase to use theme-configurable glyphs\n- Changed tree drawing characters to use theme-defined box-drawing symbols\n- Changed status line rendering to support left/right segment positioning with separators\n- Changed hardcoded UI symbols to use theme-configurable glyphs throughout the interface\n- Changed tree drawing characters to use theme-defined box-drawing symbols\n- Changed CLI image attachments to resize if larger than 2048px (fit within 1920x1080) and convert >2MB images to JPEG\n\n### Removed\n\n- Removed custom renderers for ls, find, and grep tools in favor of generic tool display\n\n### Fixed\n\n- Fixed spinner animation crash when spinner frames array is empty by adding length check\n- Fixed session persistence to properly await all queued writes before closing or switching sessions\n- Fixed session persistence to truncate oversized content blocks before writing to prevent memory exhaustion\n- Fixed extension list and inspector panel to use correct symbols for disabled and shadowed states instead of reusing unrelated status icons\n- Fixed token counting for subagent progress to handle different usage object formats (camelCase and snake_case)\n- Fixed image file handling by adding 20MB size limit to prevent memory issues during serialization\n- Fixed session persistence to truncate oversized entries before writing JSONL to prevent out-of-memory errors\n\n## [3.14.0] - 2026-01-04\n\n### Added\n\n- Added `getUsageStatistics()` method to SessionManager for tracking cumulative token usage and costs across session messages\n\n### Changed\n\n- Changed status line to display usage statistics more efficiently by using centralized session statistics instead of recalculating from entries\n\n## [3.9.1337] - 2026-01-04\n\n### Changed\n\n- Changed default for `lsp.formatOnWrite` setting from `true` to `false`\n- Updated status line thinking level display to use emoji icons instead of abbreviated text\n- Changed auto-compact indicator from \"(auto)\" text to icon\n\n### Fixed\n\n- Fixed status line not updating token counts and cost after starting a new session\n- Fixed stale diagnostics persisting after file content changes in LSP client\n\n## [3.8.1337] - 2026-01-04\n\n### Added\n\n- Added automatic browser opening after exporting session to HTML\n- Added automatic browser opening after sharing session as a Gist\n\n### Fixed\n\n- Fixed session titles not persisting to file when set before first flush\n\n## [3.7.1337] - 2026-01-04\n\n### Added\n\n- Added `EditMatchError` class for structured error handling in edit operations\n- Added `utils` module export with `once` and `untilAborted` helper functions\n- Added in-memory LSP content sync via `syncContent` and `notifySaved` client methods\n\n### Changed\n\n- Refactored LSP integration to use writethrough callbacks for edit and write tools, improving performance by syncing content in-memory before disk writes\n- Simplified FileDiagnosticsResult interface with renamed fields: `diagnostics` \u2192 `messages`, `hasErrors` \u2192 `errored`, `serverName` \u2192 `server`\n- Session title generation now triggers before sending the first message rather than after agent work begins\n\n### Fixed\n\n- Fixed potential text decoding issues in bash executor by using streaming TextDecoder instead of Buffer.toString()\n\n## [3.5.1337] - 2026-01-03\n\n### Added\n\n- Added session header and footer output in text mode showing version, model, provider, thinking level, and session ID\n- Added Extension Control Center dashboard accessible via `/extensions` command for unified management of all providers and extensions\n- Added ability to enable/disable individual extensions with persistent settings\n- Added three-column dashboard layout with sidebar tree, extension list, and inspector panel\n- Added fuzzy search filtering for extensions in the dashboard\n- Added keyboard navigation with Tab to cycle panes, j/k for navigation, Space to toggle, Enter to expand/collapse\n\n### Changed\n\n- Redesigned Extension Control Center from 3-column layout to tabbed interface with horizontal provider tabs and 2-column grid\n- Replaced sidebar tree navigation with provider tabs using TAB/Shift+TAB cycling\n\n### Fixed\n\n- Fixed title generation flag not resetting when starting a new session\n\n## [3.4.1337] - 2026-01-03\n\n### Added\n\n- Added Time Traveling Stream Rules (TTSR) feature that monitors agent output for pattern matches and injects rule reminders mid-stream\n- Added `ttsr_trigger` frontmatter field for rules to define regex patterns that trigger mid-stream injection\n- Added TTSR settings for enabled state, context mode (keep/discard partial output), and repeat mode (once/after-gap)\n\n### Fixed\n\n- Fixed excessive subprocess spawns by caching git status for 1 second in the footer component\n\n## [3.3.1337] - 2026-01-03\n\n### Changed\n\n- Improved `/status` command output formatting to use consistent column alignment across all sections\n- Updated version update notification to suggest `omp update` instead of manual npm install command\n\n## [3.1.1337] - 2026-01-03\n\n### Added\n\n- Added `spawns` frontmatter field for agent definitions to control which sub-agents can be spawned\n- Added spawn restriction enforcement preventing agents from spawning unauthorized sub-agents\n\n### Fixed\n\n- Fixed duplicate skill loading when the same SKILL.md file was discovered through multiple paths\n\n## [3.0.1337] - 2026-01-03\n\n### Added\n\n- Added unified capability-based discovery system for loading configuration from multiple AI coding tools (Claude Code, Cursor, Windsurf, Gemini, Codex, Cline, GitHub Copilot, VS Code)\n- Added support for discovering MCP servers, rules, skills, hooks, tools, slash commands, prompts, and context files from tool-specific config directories\n- Added Discovery settings tab in interactive mode to enable/disable individual configuration providers\n- Added provider source attribution showing which tool contributed each configuration item\n- Added support for Cursor MDC rule format with frontmatter (description, globs, alwaysApply)\n- Added support for Windsurf rules from .windsurf/rules/*.md and global_rules.md\n- Added support for Cline rules from .clinerules file or directory\n- Added support for GitHub Copilot instructions with applyTo glob patterns\n- Added support for Gemini extensions and system.md customization files\n- Added support for Codex AGENTS.md and config.toml settings\n- Added automatic migration of `PI_*` environment variables to `OMP_*` equivalents for backwards compatibility\n- Added multi-path config discovery supporting `.omp`, `.pi`, and `.claude` directories with priority ordering\n- Added `getConfigDirPaths()`, `findConfigFile()`, and `readConfigFile()` functions for unified config resolution\n- Added documentation for config module usage patterns\n\n### Changed\n\n- Changed MCP tool name parsing to use last underscore separator for better server name handling\n- Changed /config output to show provider attribution for discovered items\n- Renamed CLI binary from `pi` to `omp` and updated all command references\n- Changed config directory from `.pi` to `.omp` with fallback support for legacy paths\n- Renamed environment variables from `PI_*` to `OMP_*` prefix (e.g., `OMP_SMOL_MODEL`, `OMP_SLOW_MODEL`)\n- Changed model role alias prefix from `pi/` to `omp/` (e.g., `omp/slow` instead of `pi/slow`)\n\n## [2.1.1337] - 2026-01-03\n\n### Added\n\n- Added `pi update` command to check for and install updates from GitHub releases or via bun\n\n### Changed\n\n- Changed HTML export to use compile-time bundled templates via Bun macros for improved performance\n- Changed `exportToHtml` and `exportFromFile` functions to be async\n- Simplified build process by embedding assets (themes, templates, agents, commands) directly into the binary at compile time\n- Removed separate asset copying steps from build scripts\n\n## [2.0.1337] - 2026-01-03\n\n### Added\n\n- Added shell environment snapshot to preserve user aliases, functions, and shell options when executing bash commands\n- Added support for `PI_BASH_NO_CI`, `PI_BASH_NO_LOGIN`, and `PI_SHELL_PREFIX` environment variables for shell customization\n- Added zsh support alongside bash for shell detection and configuration\n\n### Changed\n\n- Changed shell detection to prefer user's `$SHELL` when it's bash or zsh, with improved fallback path resolution\n- Changed Edit tool to reject `.ipynb` files with guidance to use NotebookEdit tool instead\n\n## [1.500.0] - 2026-01-03\n\n### Added\n\n- Added provider tabs to model selector with Tab/Arrow navigation for filtering models by provider\n- Added context menu to model selector for choosing model role (Default, Smol, Slow) instead of keyboard shortcuts\n- Added LSP diagnostics display in tool execution output showing errors and warnings after file edits\n- Added centralized file logger with daily rotation to `~/.pi/logs/` for debugging production issues\n- Added `logger` property to hook and custom tool APIs for error/warning/debug logging\n- Added `output` tool to read full agent/task outputs by ID when truncated previews are insufficient\n- Added `task` tool to reviewer agent, enabling parallel exploration of large codebases during reviews\n- Added subprocess tool registry for extracting and rendering tool data from subprocess agents in real-time\n- Added combined review result rendering showing verdict and findings in a tree structure\n- Auto-read file mentions: Reference files with `@path/to/file.ext` syntax in prompts to automatically inject their contents, eliminating manual Read tool calls\n- Added `hidden` property for custom tools to exclude them from default tool list unless explicitly requested\n- Added `explicitTools` option to `createAgentSession` for enabling hidden tools by name\n- Added example review tools (`report_finding`, `submit_review`) with structured findings accumulation and verdict rendering\n- Added `/review` example command for interactive code review with branch comparison, uncommitted changes, and commit review modes\n- Custom TypeScript slash commands: Create programmable commands at `~/.pi/agent/commands/[name]/index.ts` or `.pi/commands/[name]/index.ts`. Commands export a factory returning `{ name, description, execute(args, ctx) }`. Return a string to send as LLM prompt, or void for fire-and-forget actions. Full access to `HookCommandContext` for UI dialogs, session control, and shell execution.\n- Claude command directories: Markdown slash commands now also load from `~/.claude/commands/` and `.claude/commands/` (parallel to existing `.pi/commands/` support)\n- `commands.enableClaudeUser` and `commands.enableClaudeProject` settings to disable Claude command directory loading\n- `/export --copy` option to copy entire session as formatted text to clipboard\n\n### Changed\n\n- Changed model selector keyboard shortcuts from S/L keys to a context menu opened with Enter\n- Changed model role indicators from symbols (\u2713 \u26a1 \ud83e\udde0) to labeled badges ([ DEFAULT ] [ SMOL ] [ SLOW ])\n- Changed model list sorting to include secondary sort by model ID within each provider\n- Changed silent error suppression to log warnings and debug info for tool errors, theme loading, and command loading failures\n- Changed Task tool progress display to show agent index (e.g., `reviewer(0)`) for easier Output tool ID derivation\n- Changed Task tool output to only include file paths when Output tool is unavailable, providing Read tool fallback\n- Changed Task tool output references to use simpler ID format (e.g., `reviewer_0`) with line/char counts for Output tool integration\n- Changed subagent recursion prevention from blanket blocking to same-agent blocking. Non-recursive agents can now spawn other agent types (e.g., reviewer can spawn explore agents) but cannot spawn themselves.\n- Changed `/review` command from markdown to interactive TypeScript with mode selection menu (branch comparison, uncommitted changes, commit review, custom)\n- Changed bundled commands to be overridable by user/project commands with same name\n- Changed subprocess termination to wait for message_end event to capture accurate token counts\n- Changed token counting in subprocess to accumulate across messages instead of overwriting\n- Updated bundled `reviewer` agent to use structured review tools with priority-based findings (P0-P3) and formal verdict submission\n- Task tool now streams artifacts in real-time: input written before spawn, session jsonl written by subprocess, output written at completion\n\n### Removed\n\n- Removed separate Exa error logger in favor of centralized logging system\n- Removed `findings_count` parameter from `submit_review` tool - findings are now counted automatically\n- Removed artifacts location display from task tool output\n\n### Fixed\n\n- Fixed race condition in event listener iteration by copying array before iteration to prevent mutation during callbacks\n- Fixed potential memory leak from orphaned abort controllers by properly aborting existing controllers before replacement\n- Fixed stream reader resource leak by adding proper `releaseLock()` calls in finally blocks\n- Fixed hook API methods throwing clear errors when handlers are not initialized instead of silently failing\n- Fixed LSP client race conditions with concurrent client creation and file operations using proper locking\n- Fixed Task tool progress display showing stale data by cloning progress objects before passing to callbacks\n- Fixed Task tool missing final progress events by waiting for readline to close before resolving\n- Fixed RPC mode race condition with concurrent prompt commands by serializing execution\n- Fixed pre-commit hook race condition causing `index.lock` errors when GitKraken/IDE git integrations detect file changes during formatting\n- Fixed Task tool output artifacts (`out.md`) containing duplicated text from streaming updates\n- Fixed Task tool progress display showing repeated nearly-identical lines during streaming\n- Fixed Task tool subprocess model selection ignoring agent's configured model and falling back to settings default. The `--model` flag now accepts `provider/model` format directly.\n- Fixed Task tool showing \"done + succeeded\" when aborted; now correctly displays \"\u2298 aborted\" status\n\n## [1.341.0] - 2026-01-03\n\n### Added\n\n- Added interruptMode setting to control when queued messages are processed during tool execution.\n- Implemented getter and setter methods in SettingsManager for interrupt mode persistence.\n- Exposed interruptMode configuration in interactive settings UI with immediate/wait options.\n- Wired interrupt mode through AgentSession and SDK to enable runtime configuration.\n- Model roles: Configure different models for different purposes (default, smol, slow) via `/model` selector\n- Model selector key bindings: Enter sets default, S sets smol, L sets slow, Escape closes\n- Model selector shows role markers: \u2713 for default, \u26a1 for smol, \ud83e\udde0 for slow\n- `pi/` model aliases in Task tool agent definitions (e.g., `model: pi/smol, haiku, flash, mini`)\n- Smol model auto-discovery using priority chain: haiku > flash > mini\n- Slow model auto-discovery using priority chain: gpt-5.2-codex > codex > gpt > opus > pro\n- CLI args for model roles: `--smol ` and `--slow ` (ephemeral, not persisted)\n- Env var overrides: `PI_SMOL_MODEL` and `PI_SLOW_MODEL`\n- Title generation now uses configured smol model from settings\n- LSP diagnostics on edit: Edit tool can now return LSP diagnostics after editing code files. Disabled by default to avoid noise during multi-edit sequences. Enable via `lsp.diagnosticsOnEdit` setting.\n- LSP workspace diagnostics: New `lsp action=workspace_diagnostics` command checks the entire project for errors. Auto-detects project type and uses appropriate checker (rust-analyzer/cargo for Rust, tsc for TypeScript, go build for Go, pyright for Python).\n- LSP local binary resolution: LSP servers installed in project-local directories are now discovered automatically. Checks `node_modules/.bin/` for Node.js projects, `.venv/bin/`/`venv/bin/` for Python projects, and `vendor/bundle/bin/` for Ruby projects before falling back to `$PATH`.\n- LSP format on write: Write tool now automatically formats code files using LSP after writing. Uses the language server's built-in formatter (e.g., rustfmt for Rust, gofmt for Go). Controlled via `lsp.formatOnWrite` setting (enabled by default).\n- LSP diagnostics on write: Write tool now returns LSP diagnostics (errors/warnings) after writing code files. This gives immediate feedback on syntax errors and type issues. Controlled via `lsp.diagnosticsOnWrite` setting (enabled by default).\n- LSP server warmup at startup: LSP servers are now started at launch to avoid cold-start delays when first writing files.\n- LSP server status in welcome banner: Shows which language servers are active and ready.\n- Edit fuzzy match setting: Added `edit.fuzzyMatch` setting (enabled by default) to control whether the edit tool accepts high-confidence fuzzy matches for whitespace/indentation differences. Toggle via `/settings`.\n- Multi-server LSP diagnostics: Diagnostics now query all applicable language servers for a file type. For TypeScript/JavaScript projects with Biome, this means both type errors (from tsserver) and lint errors (from Biome) are reported together.\n- Comprehensive LSP server configurations for 40+ languages including Rust, Go, Python, Java, Kotlin, Scala, Haskell, OCaml, Elixir, Ruby, PHP, C#, Lua, Nix, and many more. Each server includes sensible defaults for args, settings, and init options.\n- Extended LSP config file search paths: Now searches for `lsp.json`, `.lsp.json` in project root and `.pi/` subdirectory, plus user-level configs in `~/.pi/` and home directory.\n\n### Changed\n\n- LSP settings moved to dedicated \"LSP\" tab in `/settings` for better organization\n- Improved grep tool description to document pagination options (`headLimit`, `offset`) and clarify recursive search behavior\n- LSP idle timeout now disabled by default. Configure via `idleTimeoutMs` in lsp.json to auto-shutdown inactive servers.\n- Model settings now use role-based storage (`modelRoles` map) instead of single `defaultProvider`/`defaultModel` fields. Supports multiple model roles (default, small, etc.)\n- Session model persistence now uses `\"provider/modelId\"` string format with optional role field\n\n### Fixed\n\n- Recent sessions now show in welcome banner (was never wired up).\n- Auto-generated session titles: Sessions are now automatically titled based on the first message using a small model (Haiku/GPT-4o-mini/Flash). Titles are shown in the terminal window title, recent sessions list, and --resume picker. The resume picker shows title with dimmed first message preview below.\n\n## [1.340.0] - 2026-01-03\n\n### Changed\n\n- Replaced vendored highlight.js and marked.js with CDN-hosted versions for smaller exports\n- Added runtime minification for HTML, CSS, and JS in session exports\n- Session share URL now uses gistpreview.github.io instead of shittycodingagent.ai\n\n## [1.339.0] - 2026-01-03\n\n### Added\n\n- MCP project config setting to disable loading `.mcp.json`/`mcp.json` from project root\n- Support for both `mcp.json` and `.mcp.json` filenames (prefers `mcp.json` if both exist)\n- Automatic Exa MCP server filtering with API key extraction for native integration\n\n## [1.338.0] - 2026-01-03\n\n### Added\n\n- Bash interceptor setting to block shell commands that have dedicated tools (disabled by default, enable via `/settings`)\n\n### Changed\n\n- Refactored settings UI to declarative definitions for easier maintenance\n- Shell detection now respects `$SHELL` environment variable before falling back to bash/sh\n- Tool binary detection now uses `Bun.which()` instead of spawning processes\n\n### Fixed\n\n- CLI help text now accurately lists all default tools\n\n## [1.337.1] - 2026-01-02\n\n### Added\n\n- MCP support and plugin system for external tool integration\n- Git context to system prompt for repo awareness\n- Bash interception to guide tool selection\n- Fuzzy matching to handle indentation variance in edit tool\n- Specialized Exa tools with granular toggles\n- `/share` command for exporting conversations to HTML\n- Edit diff preview before tool execution\n\n### Changed\n\n- Renamed package scope to @oh-my-pi for consistent branding\n- Simplified toolset and enhanced navigation\n- Improved process cleanup with tree kill\n- Updated CI/CD workflows for GitHub Actions with provenance-signed npm publishing\n\n### Fixed\n\n- Template string interpolation in image read output\n- Prevented full re-renders during write tool streaming\n- Edit tool failing on files with UTF-8 BOM\n\n## [1.337.0] - 2026-01-02\n\nInitial release under @oh-my-pi scope. See previous releases at [badlogic/pi-mono](https://github.com/badlogic/pi-mono).\n\n## [1.5.1] - 2026-01-03\n\n### Added\n\n- Added shell environment snapshot to preserve user aliases, functions, and shell options when executing bash commands\n- Added support for `PI_BASH_NO_CI`, `PI_BASH_NO_LOGIN`, and `PI_SHELL_PREFIX` environment variables for shell customization\n- Added zsh support alongside bash for shell detection and configuration\n\n### Changed\n\n- Changed shell detection to prefer user's `$SHELL` when it's bash or zsh, with improved fallback path resolution\n- Changed Edit tool to reject `.ipynb` files with guidance to use NotebookEdit tool instead\n\n## [1.5.0] - 2026-01-03\n\n### Added\n\n- Added provider tabs to model selector with Tab/Arrow navigation for filtering models by provider\n- Added context menu to model selector for choosing model role (Default, Smol, Slow) instead of keyboard shortcuts\n- Added LSP diagnostics display in tool execution output showing errors and warnings after file edits\n- Added centralized file logger with daily rotation to `~/.pi/logs/` for debugging production issues\n- Added `logger` property to hook and custom tool APIs for error/warning/debug logging\n- Added `output` tool to read full agent/task outputs by ID when truncated previews are insufficient\n- Added `task` tool to reviewer agent, enabling parallel exploration of large codebases during reviews\n- Added subprocess tool registry for extracting and rendering tool data from subprocess agents in real-time\n- Added combined review result rendering showing verdict and findings in a tree structure\n- Auto-read file mentions: Reference files with `@path/to/file.ext` syntax in prompts to automatically inject their contents, eliminating manual Read tool calls\n- Added `hidden` property for custom tools to exclude them from default tool list unless explicitly requested\n- Added `explicitTools` option to `createAgentSession` for enabling hidden tools by name\n- Added example review tools (`report_finding`, `submit_review`) with structured findings accumulation and verdict rendering\n- Added `/review` example command for interactive code review with branch comparison, uncommitted changes, and commit review modes\n- Custom TypeScript slash commands: Create programmable commands at `~/.pi/agent/commands/[name]/index.ts` or `.pi/commands/[name]/index.ts`. Commands export a factory returning `{ name, description, execute(args, ctx) }`. Return a string to send as LLM prompt, or void for fire-and-forget actions. Full access to `HookCommandContext` for UI dialogs, session control, and shell execution.\n- Claude command directories: Markdown slash commands now also load from `~/.claude/commands/` and `.claude/commands/` (parallel to existing `.pi/commands/` support)\n- `commands.enableClaudeUser` and `commands.enableClaudeProject` settings to disable Claude command directory loading\n- `/export --copy` option to copy entire session as formatted text to clipboard\n\n### Changed\n\n- Changed model selector keyboard shortcuts from S/L keys to a context menu opened with Enter\n- Changed model role indicators from symbols (\u2713 \u26a1 \ud83e\udde0) to labeled badges ([ DEFAULT ] [ SMOL ] [ SLOW ])\n- Changed model list sorting to include secondary sort by model ID within each provider\n- Changed silent error suppression to log warnings and debug info for tool errors, theme loading, and command loading failures\n- Changed Task tool progress display to show agent index (e.g., `reviewer(0)`) for easier Output tool ID derivation\n- Changed Task tool output to only include file paths when Output tool is unavailable, providing Read tool fallback\n- Changed Task tool output references to use simpler ID format (e.g., `reviewer_0`) with line/char counts for Output tool integration\n- Changed subagent recursion prevention from blanket blocking to same-agent blocking. Non-recursive agents can now spawn other agent types (e.g., reviewer can spawn explore agents) but cannot spawn themselves.\n- Changed `/review` command from markdown to interactive TypeScript with mode selection menu (branch comparison, uncommitted changes, commit review, custom)\n- Changed bundled commands to be overridable by user/project commands with same name\n- Changed subprocess termination to wait for message_end event to capture accurate token counts\n- Changed token counting in subprocess to accumulate across messages instead of overwriting\n- Updated bundled `reviewer` agent to use structured review tools with priority-based findings (P0-P3) and formal verdict submission\n- Task tool now streams artifacts in real-time: input written before spawn, session jsonl written by subprocess, output written at completion\n\n### Removed\n\n- Removed separate Exa error logger in favor of centralized logging system\n- Removed `findings_count` parameter from `submit_review` tool - findings are now counted automatically\n- Removed artifacts location display from task tool output\n\n### Fixed\n\n- Fixed race condition in event listener iteration by copying array before iteration to prevent mutation during callbacks\n- Fixed potential memory leak from orphaned abort controllers by properly aborting existing controllers before replacement\n- Fixed stream reader resource leak by adding proper `releaseLock()` calls in finally blocks\n- Fixed hook API methods throwing clear errors when handlers are not initialized instead of silently failing\n- Fixed LSP client race conditions with concurrent client creation and file operations using proper locking\n- Fixed Task tool progress display showing stale data by cloning progress objects before passing to callbacks\n- Fixed Task tool missing final progress events by waiting for readline to close before resolving\n- Fixed RPC mode race condition with concurrent prompt commands by serializing execution\n- Fixed pre-commit hook race condition causing `index.lock` errors when GitKraken/IDE git integrations detect file changes during formatting\n- Fixed Task tool output artifacts (`out.md`) containing duplicated text from streaming updates\n- Fixed Task tool progress display showing repeated nearly-identical lines during streaming\n- Fixed Task tool subprocess model selection ignoring agent's configured model and falling back to settings default. The `--model` flag now accepts `provider/model` format directly.\n- Fixed Task tool showing \"done + succeeded\" when aborted; now correctly displays \"\u2298 aborted\" status\n\n## [0.50.1] - 2026-01-26\n\n### Fixed\n\n- Git extension updates now handle force-pushed remotes gracefully instead of failing ([#961](https://github.com/badlogic/pi-mono/pull/961) by [@aliou](https://github.com/aliou))\n- Extension `ctx.newSession({ setup })` now properly syncs agent state and renders messages after setup callback runs ([#968](https://github.com/badlogic/pi-mono/issues/968))\n- Fixed extension UI bindings not initializing when starting with no extensions, which broke UI methods after `/reload`\n- Fixed `/hotkeys` output to title-case extension hotkeys ([#969](https://github.com/badlogic/pi-mono/pull/969) by [@Perlence](https://github.com/Perlence))\n- Fixed model catalog generation to exclude deprecated OpenCode Zen models ([#970](https://github.com/badlogic/pi-mono/pull/970) by [@DanielTatarkin](https://github.com/DanielTatarkin))\n- Fixed git extension removal to prune empty directories\n\n## [0.50.0] - 2026-01-26\n\n### New Features\n\n- Pi packages for bundling and installing extensions, skills, prompts, and themes. See [docs/packages.md](docs/packages.md).\n- Hot reload (`/reload`) of resources including AGENTS.md, SYSTEM.md, APPEND_SYSTEM.md, prompt templates, skills, themes, and extensions. See [README.md#commands](README.md#commands) and [README.md#context-files](README.md#context-files).\n- Custom providers via `pi.registerProvider()` for proxies, custom endpoints, OAuth or SSO flows, and non-standard streaming APIs. See [docs/custom-provider.md](docs/custom-provider.md).\n- Azure OpenAI Responses provider support with deployment-aware model mapping. See [docs/providers.md#azure-openai](docs/providers.md#azure-openai).\n- OpenRouter routing support for custom models via `openRouterRouting`. See [docs/providers.md#api-keys](docs/providers.md#api-keys) and [docs/models.md](docs/models.md).\n- Skill invocation messages are now collapsible and skills can opt out of model invocation via `disable-model-invocation`. See [docs/skills.md#frontmatter](docs/skills.md#frontmatter).\n- Session selector renaming and configurable keybindings. See [README.md#commands](README.md#commands) and [docs/keybindings.md](docs/keybindings.md).\n- `models.json` headers can resolve environment variables and shell commands. See [docs/models.md#value-resolution](docs/models.md#value-resolution).\n- `--verbose` CLI flag to override quiet startup. See [README.md#cli-reference](README.md#cli-reference).\n\nRead the fully revamped docs in `README.md`, or have your clanker read them for you.\n\n### SDK Migration Guide\n\nThere are multiple SDK breaking changes since v0.49.3. For the quickest migration, point your agent at `packages/coding-agent/docs/sdk.md`, the SDK examples in `packages/coding-agent/examples/sdk`, and the SDK source in `packages/coding-agent/src/core/sdk.ts` and related modules.\n\n### Breaking Changes\n\n- Header values in `models.json` now resolve environment variables (if a header value matches an env var name, the env var value is used). This may change behavior if a literal header value accidentally matches an env var name. ([#909](https://github.com/badlogic/pi-mono/issues/909))\n- External packages (npm/git) are now configured via `packages` array in settings.json instead of `extensions`. Existing npm:/git: entries in `extensions` are auto-migrated. ([#645](https://github.com/badlogic/pi-mono/issues/645))\n- Resource loading now uses `ResourceLoader` only and settings.json uses arrays for extensions, skills, prompts, and themes ([#645](https://github.com/badlogic/pi-mono/issues/645))\n- Removed `discoverAuthStorage` and `discoverModels` from the SDK. `AuthStorage` and `ModelRegistry` now default to `~/.pi/agent` paths unless you pass an `agentDir` ([#645](https://github.com/badlogic/pi-mono/issues/645))\n\n### Added\n\n- Session renaming in `/resume` picker via `Ctrl+R` without opening the session ([#863](https://github.com/badlogic/pi-mono/pull/863) by [@svkozak](https://github.com/svkozak))\n- Session selector keybindings are now configurable ([#948](https://github.com/badlogic/pi-mono/pull/948) by [@aos](https://github.com/aos))\n- `disable-model-invocation` frontmatter field for skills to prevent agentic invocation while still allowing explicit `/skill:name` commands ([#927](https://github.com/badlogic/pi-mono/issues/927))\n- Exposed `copyToClipboard` utility for extensions ([#926](https://github.com/badlogic/pi-mono/issues/926) by [@mitsuhiko](https://github.com/mitsuhiko))\n- Skill invocation messages are now collapsible in chat output, showing collapsed by default with skill name and expand hint ([#894](https://github.com/badlogic/pi-mono/issues/894))\n- Header values in `models.json` now support environment variables and shell commands, matching `apiKey` resolution ([#909](https://github.com/badlogic/pi-mono/issues/909))\n- Added HTTP proxy environment variable support for API requests ([#942](https://github.com/badlogic/pi-mono/pull/942) by [@haoqixu](https://github.com/haoqixu))\n- Added OpenRouter provider routing support for custom models via `openRouterRouting` compat field ([#859](https://github.com/badlogic/pi-mono/pull/859) by [@v01dpr1mr0s3](https://github.com/v01dpr1mr0s3))\n- Added `azure-openai-responses` provider support for Azure OpenAI Responses API. ([#890](https://github.com/badlogic/pi-mono/pull/890) by [@markusylisiurunen](https://github.com/markusylisiurunen))\n- Added changelog link to update notifications ([#925](https://github.com/badlogic/pi-mono/pull/925) by [@dannote](https://github.com/dannote))\n- Added `--verbose` CLI flag to override quietStartup setting ([#906](https://github.com/badlogic/pi-mono/pull/906) by [@Perlence](https://github.com/Perlence))\n- `markdown.codeBlockIndent` setting to customize code block indentation in rendered output\n- Extension package management with `pi install`, `pi remove`, `pi update`, and `pi list` commands ([#645](https://github.com/badlogic/pi-mono/issues/645))\n- Package filtering: selectively load resources from packages using object form in `packages` array ([#645](https://github.com/badlogic/pi-mono/issues/645))\n- Glob pattern support with minimatch in package filters, top-level settings arrays, and pi manifest (e.g., `\"!funky.json\"`, `\"*.ts\"`) ([#645](https://github.com/badlogic/pi-mono/issues/645))\n- `/reload` command to reload extensions, skills, prompts, and themes ([#645](https://github.com/badlogic/pi-mono/issues/645))\n- `pi config` command with TUI to enable/disable package and top-level resources via patterns ([#938](https://github.com/badlogic/pi-mono/issues/938))\n- CLI flags for `--skill`, `--prompt-template`, `--theme`, `--no-prompt-templates`, and `--no-themes` ([#645](https://github.com/badlogic/pi-mono/issues/645))\n- Package deduplication: if same package appears in global and project settings, project wins ([#645](https://github.com/badlogic/pi-mono/issues/645))\n- Unified collision reporting with `ResourceDiagnostic` type for all resource types ([#645](https://github.com/badlogic/pi-mono/issues/645))\n- Show provider alongside the model in the footer if multiple providers are available\n- Custom provider support via `pi.registerProvider()` with `streamSimple` for custom API implementations\n- Added `custom-provider.ts` example extension demonstrating custom Anthropic provider with OAuth\n\n### Changed\n\n- `/resume` picker sort toggle moved to `Ctrl+S` to free `Ctrl+R` for rename ([#863](https://github.com/badlogic/pi-mono/pull/863) by [@svkozak](https://github.com/svkozak))\n- HTML export: clicking a sidebar message now navigates to its newest leaf and scrolls to it, instead of truncating the branch ([#853](https://github.com/badlogic/pi-mono/pull/853) by [@mitsuhiko](https://github.com/mitsuhiko))\n- HTML export: active path is now visually highlighted with dimmed off-path nodes ([#929](https://github.com/badlogic/pi-mono/pull/929) by [@hewliyang](https://github.com/hewliyang))\n- Azure OpenAI Responses provider now uses base URL configuration with deployment-aware model mapping and no longer includes service tier handling\n- `/reload` now re-renders the entire scrollback so updated extension components are visible immediately ([#928](https://github.com/badlogic/pi-mono/pull/928) by [@ferologics](https://github.com/ferologics))\n- Skill, prompt template, and theme discovery now use settings and CLI path arrays instead of legacy filters ([#645](https://github.com/badlogic/pi-mono/issues/645))\n\n### Fixed\n\n- Extension `setWorkingMessage()` calls in `agent_start` handlers now work correctly; previously the message was silently ignored because the loading animation didn't exist yet ([#935](https://github.com/badlogic/pi-mono/issues/935))\n- Fixed package auto-discovery to respect loader rules, config overrides, and force-exclude patterns\n- Fixed /reload restoring the correct editor after reload ([#949](https://github.com/badlogic/pi-mono/pull/949) by [@Perlence](https://github.com/Perlence))\n- Fixed distributed themes breaking `/export` ([#946](https://github.com/badlogic/pi-mono/pull/946) by [@mitsuhiko](https://github.com/mitsuhiko))\n- Fixed startup hints to clarify thinking level selection and expanded thinking guidance\n- Fixed SDK initial model resolution to use `findInitialModel` and default to Claude Opus 4.5 for Anthropic models\n- Fixed no-models warning to include the `/model` instruction\n- Fixed authentication error messages to point to the authentication documentation\n- Fixed bash output hint lines to truncate to terminal width\n- Fixed custom editors to honor the `paddingX` setting ([#936](https://github.com/badlogic/pi-mono/pull/936) by [@Perlence](https://github.com/Perlence))\n- Fixed system prompt tool list to show only built-in tools\n- Fixed package manager to check npm package versions before using cached copies\n- Fixed package manager to run `npm install` after cloning git repositories with a package.json\n- Fixed extension provider registrations to apply before model resolution\n- Fixed editor multi-line insertion handling and lastAction tracking ([#945](https://github.com/badlogic/pi-mono/pull/945) by [@Perlence](https://github.com/Perlence))\n- Fixed editor word wrapping to reserve a cursor column ([#934](https://github.com/badlogic/pi-mono/pull/934) by [@Perlence](https://github.com/Perlence))\n- Fixed editor word wrapping to use single-pass backtracking for whitespace handling ([#924](https://github.com/badlogic/pi-mono/pull/924) by [@Perlence](https://github.com/Perlence))\n- Fixed Kitty image ID allocation and cleanup to prevent image ID collisions\n- Fixed overlays staying centered after terminal resizes ([#950](https://github.com/badlogic/pi-mono/pull/950) by [@nicobailon](https://github.com/nicobailon))\n- Fixed streaming dispatch to use the model api type instead of hardcoded API defaults\n- Fixed Google providers to default tool call arguments to an empty object when omitted\n- Fixed OpenAI Responses streaming to handle `arguments.done` events on OpenAI-compatible endpoints ([#917](https://github.com/badlogic/pi-mono/pull/917) by [@williballenthin](https://github.com/williballenthin))\n- Fixed OpenAI Codex Responses tool strictness handling after the shared responses refactor\n- Fixed Azure OpenAI Responses streaming to guard deltas before content parts and correct metadata and handoff gating\n- Fixed OpenAI completions tool-result image batching after consecutive tool results ([#902](https://github.com/badlogic/pi-mono/pull/902) by [@terrorobe](https://github.com/terrorobe))\n- Off-by-one error in bash output \"earlier lines\" count caused by counting spacing newline as hidden content ([#921](https://github.com/badlogic/pi-mono/issues/921))\n- User package filters now layer on top of manifest filters instead of replacing them ([#645](https://github.com/badlogic/pi-mono/issues/645))\n- Auto-retry now handles \"terminated\" errors from Codex API mid-stream failures\n- Follow-up queue (Alt+Enter) now sends full paste content instead of `[paste #N ...]` markers ([#912](https://github.com/badlogic/pi-mono/issues/912))\n- Fixed Alt-Up not restoring messages queued during compaction ([#923](https://github.com/badlogic/pi-mono/pull/923) by [@aliou](https://github.com/aliou))\n- Fixed session corruption when loading empty or invalid session files via `--session` flag ([#932](https://github.com/badlogic/pi-mono/issues/932) by [@armanddp](https://github.com/armanddp))\n- Fixed extension shortcuts not firing when extension also uses `setEditorComponent()` ([#947](https://github.com/badlogic/pi-mono/pull/947) by [@Perlence](https://github.com/Perlence))\n- Session \"modified\" time now uses last message timestamp instead of file mtime, so renaming doesn't reorder the recent list ([#863](https://github.com/badlogic/pi-mono/pull/863) by [@svkozak](https://github.com/svkozak))\n\n## [0.49.3] - 2026-01-22\n\n### Added\n\n- `markdown.codeBlockIndent` setting to customize code block indentation in rendered output ([#855](https://github.com/badlogic/pi-mono/pull/855) by [@terrorobe](https://github.com/terrorobe))\n- Added `inline-bash.ts` example extension for expanding `!{command}` patterns in prompts ([#881](https://github.com/badlogic/pi-mono/pull/881) by [@scutifer](https://github.com/scutifer))\n- Added `antigravity-image-gen.ts` example extension for AI image generation via Google Antigravity ([#893](https://github.com/badlogic/pi-mono/pull/893) by [@benvargas](https://github.com/benvargas))\n- Added `PI_SHARE_VIEWER_URL` environment variable for custom share viewer URLs ([#889](https://github.com/badlogic/pi-mono/pull/889) by [@andresaraujo](https://github.com/andresaraujo))\n- Added Alt+Delete as hotkey for delete word forwards ([#878](https://github.com/badlogic/pi-mono/pull/878) by [@Perlence](https://github.com/Perlence))\n\n### Changed\n\n- Tree selector: changed label filter shortcut from `l` to `Shift+L` so users can search for entries containing \"l\" ([#861](https://github.com/badlogic/pi-mono/pull/861) by [@mitsuhiko](https://github.com/mitsuhiko))\n- Fuzzy matching now scores consecutive matches higher for better search relevance ([#860](https://github.com/badlogic/pi-mono/pull/860) by [@mitsuhiko](https://github.com/mitsuhiko))\n\n### Fixed\n\n- Fixed error messages showing hardcoded `~/.pi/agent/` paths instead of respecting `PI_CODING_AGENT_DIR` ([#887](https://github.com/badlogic/pi-mono/pull/887) by [@aliou](https://github.com/aliou))\n- Fixed `write` tool not displaying errors in the UI when execution fails ([#856](https://github.com/badlogic/pi-mono/issues/856))\n- Fixed HTML export using default theme instead of user's active theme ([#870](https://github.com/badlogic/pi-mono/pull/870) by [@scutifer](https://github.com/scutifer))\n- Show session name in the footer and terminal / tab title ([#876](https://github.com/badlogic/pi-mono/pull/876) by [@scutifer](https://github.com/scutifer))\n- Fixed 256color fallback in Terminal.app to prevent color rendering issues ([#869](https://github.com/badlogic/pi-mono/pull/869) by [@Perlence](https://github.com/Perlence))\n- Fixed viewport tracking and cursor positioning for overlays and content shrink scenarios\n- Fixed autocomplete to allow searches with `/` characters (e.g., `folder1/folder2`) ([#882](https://github.com/badlogic/pi-mono/pull/882) by [@richardgill](https://github.com/richardgill))\n- Fixed autolinked emails displaying redundant `(mailto:...)` suffix ([#888](https://github.com/badlogic/pi-mono/pull/888) by [@terrorobe](https://github.com/terrorobe))\n- Fixed `@` file autocomplete adding space after directories, breaking continued autocomplete into subdirectories\n\n## [0.49.2] - 2026-01-19\n\n### Added\n\n- Added widget placement option for extension widgets via `widgetPlacement` in `pi.addWidget()` ([#850](https://github.com/badlogic/pi-mono/pull/850) by [@marckrenn](https://github.com/marckrenn))\n- Added AWS credential detection for ECS/Kubernetes environments: `AWS_CONTAINER_CREDENTIALS_RELATIVE_URI`, `AWS_CONTAINER_CREDENTIALS_FULL_URI`, `AWS_WEB_IDENTITY_TOKEN_FILE` ([#848](https://github.com/badlogic/pi-mono/issues/848))\n- Add \"quiet startup\" setting to `/settings` ([#847](https://github.com/badlogic/pi-mono/pull/847) by [@unexge](https://github.com/unexge))\n\n### Changed\n\n- HTML export now includes JSONL download button, jump-to-last-message on click, and fixed missing labels ([#853](https://github.com/badlogic/pi-mono/pull/853) by [@mitsuhiko](https://github.com/mitsuhiko))\n- Improved error message for OAuth authentication failures (expired credentials, offline) instead of generic 'No API key found' ([#849](https://github.com/badlogic/pi-mono/pull/849) by [@zedrdave](https://github.com/zedrdave))\n\n### Fixed\n\n- Fixed `/model` selector scope toggle so you can switch between all and scoped models when scoped models are saved ([#844](https://github.com/badlogic/pi-mono/issues/844))\n- Fixed OpenAI Responses 400 error \"reasoning without following item\" when replaying aborted turns ([#838](https://github.com/badlogic/pi-mono/pull/838))\n- Fixed pi exiting with code 0 when cancelling resume session selection\n\n### Removed\n\n- Removed `strictResponsesPairing` compat option from models.json schema (no longer needed)\n\n## [0.49.1] - 2026-01-18\n\n### Added\n\n- Added `strictResponsesPairing` compat option for custom OpenAI Responses models on Azure ([#768](https://github.com/badlogic/pi-mono/pull/768) by [@nicobako](https://github.com/nicobako))\n- Session selector (`/resume`) now supports path display toggle (`Ctrl+P`) and session deletion (`Ctrl+D`) with inline confirmation ([#816](https://github.com/badlogic/pi-mono/pull/816) by [@w-winter](https://github.com/w-winter))\n- Added undo support in interactive mode with Ctrl+- hotkey. ([#831](https://github.com/badlogic/pi-mono/pull/831) by [@Perlence](https://github.com/Perlence))\n\n### Changed\n\n- Share URLs now use hash fragments (`#`) instead of query strings (`?`) to prevent session IDs from being sent to buildwithpi.ai ([#829](https://github.com/badlogic/pi-mono/pull/829) by [@terrorobe](https://github.com/terrorobe))\n- API keys in `models.json` can now be retrieved via shell command using `!` prefix (e.g., `\"apiKey\": \"!security find-generic-password -ws 'anthropic'\"` for macOS Keychain) ([#762](https://github.com/badlogic/pi-mono/pull/762) by [@cv](https://github.com/cv))\n\n### Fixed\n\n- Fixed IME candidate window appearing in wrong position when filtering menus with Input Method Editor (e.g., Chinese IME). Components with search inputs now properly propagate focus state for cursor positioning. ([#827](https://github.com/badlogic/pi-mono/issues/827))\n- Fixed extension shortcut conflicts to respect user keybindings when built-in actions are remapped. ([#826](https://github.com/badlogic/pi-mono/pull/826) by [@richardgill](https://github.com/richardgill))\n- Fixed photon WASM loading in standalone compiled binaries.\n- Fixed tool call ID normalization for cross-provider handoffs (e.g., Codex to Antigravity Claude) ([#821](https://github.com/badlogic/pi-mono/issues/821))\n\n## [0.49.0] - 2026-01-17\n\n### Added\n\n- `pi.setLabel(entryId, label)` in ExtensionAPI for setting per-entry labels from extensions ([#806](https://github.com/badlogic/pi-mono/issues/806))\n- Export `keyHint`, `appKeyHint`, `editorKey`, `appKey`, `rawKeyHint` for extensions to format keybinding hints consistently ([#802](https://github.com/badlogic/pi-mono/pull/802) by [@dannote](https://github.com/dannote))\n- Exported `VERSION` from the package index and updated the custom-header example. ([#798](https://github.com/badlogic/pi-mono/pull/798) by [@tallshort](https://github.com/tallshort))\n- Added `showHardwareCursor` setting to control cursor visibility while still positioning it for IME support. ([#800](https://github.com/badlogic/pi-mono/pull/800) by [@ghoulr](https://github.com/ghoulr))\n- Added Emacs-style kill ring editing with yank and yank-pop keybindings, plus legacy Alt+letter handling and Alt+D delete word forward support in the interactive editor. ([#810](https://github.com/badlogic/pi-mono/pull/810) by [@Perlence](https://github.com/Perlence))\n- Added `ctx.compact()` and `ctx.getContextUsage()` to extension contexts for programmatic compaction and context usage checks.\n- Added documentation for delete word forward and kill ring keybindings in interactive mode. ([#810](https://github.com/badlogic/pi-mono/pull/810) by [@Perlence](https://github.com/Perlence))\n\n### Changed\n\n- Updated the default system prompt wording to clarify the pi harness and documentation scope.\n- Simplified Codex system prompt handling to use the default system prompt directly for Codex instructions.\n\n### Fixed\n\n- Fixed photon module failing to load in ESM context with \"require is not defined\" error ([#795](https://github.com/badlogic/pi-mono/pull/795) by [@dannote](https://github.com/dannote))\n- Fixed compaction UI not showing when extensions trigger compaction.\n- Fixed orphaned tool results after errored assistant messages causing Codex API errors. When an assistant message has `stopReason: \"error\"`, its tool calls are now excluded from pending tool tracking, preventing synthetic tool results from being generated for calls that will be dropped by provider-specific converters. ([#812](https://github.com/badlogic/pi-mono/issues/812))\n- Fixed Bedrock Claude max_tokens handling to always exceed thinking budget tokens, preventing compaction failures. ([#797](https://github.com/badlogic/pi-mono/pull/797) by [@pjtf93](https://github.com/pjtf93))\n- Fixed Claude Code tool name normalization to match the Claude Code tool list case-insensitively and remove invalid mappings.\n\n### Removed\n\n- Removed `pi-internal://` path resolution from the read tool.\n\n## [0.48.0] - 2026-01-16\n\n### Added\n\n- Added `quietStartup` setting to silence startup output (version header, loaded context info, model scope line). Changelog notifications are still shown. ([#777](https://github.com/badlogic/pi-mono/pull/777) by [@ribelo](https://github.com/ribelo))\n- Added `editorPaddingX` setting for horizontal padding in input editor (0-3, default: 0)\n- Added `shellCommandPrefix` setting to prepend commands to every bash execution, enabling alias expansion in non-interactive shells (e.g., `\"shellCommandPrefix\": \"shopt -s expand_aliases\"`) ([#790](https://github.com/badlogic/pi-mono/pull/790) by [@richardgill](https://github.com/richardgill))\n- Added bash-style argument slicing for prompt templates ([#770](https://github.com/badlogic/pi-mono/pull/770) by [@airtonix](https://github.com/airtonix))\n- Extension commands can provide argument auto-completions via `getArgumentCompletions` in `pi.registerCommand()` ([#775](https://github.com/badlogic/pi-mono/pull/775) by [@ribelo](https://github.com/ribelo))\n- Bash tool now displays the timeout value in the UI when a timeout is set ([#780](https://github.com/badlogic/pi-mono/pull/780) by [@dannote](https://github.com/dannote))\n- Export `getShellConfig` for extensions to detect user's shell environment ([#766](https://github.com/badlogic/pi-mono/pull/766) by [@dannote](https://github.com/dannote))\n- Added `thinkingText` and `selectedBg` to theme schema ([#763](https://github.com/badlogic/pi-mono/pull/763) by [@scutifer](https://github.com/scutifer))\n- `navigateTree()` now supports `replaceInstructions` option to replace the default summarization prompt entirely, and `label` option to attach a label to the branch summary entry ([#787](https://github.com/badlogic/pi-mono/pull/787) by [@mitsuhiko](https://github.com/mitsuhiko))\n\n### Fixed\n\n- Fixed crash during auto-compaction when summarization fails (e.g., quota exceeded). Now displays error message instead of crashing ([#792](https://github.com/badlogic/pi-mono/issues/792))\n- Fixed `--session ` to search globally across projects if not found locally, with option to fork sessions from other projects ([#785](https://github.com/badlogic/pi-mono/pull/785) by [@ribelo](https://github.com/ribelo))\n- Fixed standalone binary WASM loading on Linux ([#784](https://github.com/badlogic/pi-mono/issues/784))\n- Fixed string numbers in tool arguments not being coerced to numbers during validation ([#786](https://github.com/badlogic/pi-mono/pull/786) by [@dannote](https://github.com/dannote))\n- Fixed `--no-extensions` flag not preventing extension discovery ([#776](https://github.com/badlogic/pi-mono/issues/776))\n- Fixed extension messages rendering twice on startup when `pi.sendMessage({ display: true })` is called during `session_start` ([#765](https://github.com/badlogic/pi-mono/pull/765) by [@dannote](https://github.com/dannote))\n- Fixed `PI_CODING_AGENT_DIR` env var not expanding tilde (`~`) to home directory ([#778](https://github.com/badlogic/pi-mono/pull/778) by [@aliou](https://github.com/aliou))\n- Fixed session picker hint text overflow ([#764](https://github.com/badlogic/pi-mono/issues/764))\n- Fixed Kitty keyboard protocol shifted symbol keys (e.g., `@`, `?`) not working in editor ([#779](https://github.com/badlogic/pi-mono/pull/779) by [@iamd3vil](https://github.com/iamd3vil))\n- Fixed Bedrock tool call IDs causing API errors from invalid characters ([#781](https://github.com/badlogic/pi-mono/pull/781) by [@pjtf93](https://github.com/pjtf93))\n\n### Changed\n\n- Hardware cursor is now disabled by default for better terminal compatibility. Set `PI_HARDWARE_CURSOR=1` to enable (replaces `PI_NO_HARDWARE_CURSOR=1` which disabled it).\n\n## [0.47.0] - 2026-01-16\n\n### Breaking Changes\n\n- Extensions using `Editor` directly must now pass `TUI` as the first constructor argument: `new Editor(tui, theme)`. The `tui` parameter is available in extension factory functions. ([#732](https://github.com/badlogic/pi-mono/issues/732))\n\n### Added\n\n- **OpenAI Codex official support**: Full compatibility with OpenAI's Codex CLI models (`gpt-5.1`, `gpt-5.2`, `gpt-5.1-codex-mini`, `gpt-5.2-codex`). Features include static system prompt for OpenAI allowlisting, prompt caching via session ID, and reasoning signature retention across turns. Set `OPENAI_API_KEY` and use `--provider openai-codex` or select a Codex model. ([#737](https://github.com/badlogic/pi-mono/pull/737))\n- `pi-internal://` URL scheme in read tool for accessing internal documentation. The model can read files from the coding-agent package (README, docs, examples) to learn about extending pi.\n- New `input` event in extension system for intercepting, transforming, or handling user input before the agent processes it. Supports three result types: `continue` (pass through), `transform` (modify text/images), `handled` (respond without LLM). Handlers chain transforms and short-circuit on handled. ([#761](https://github.com/badlogic/pi-mono/pull/761) by [@nicobailon](https://github.com/nicobailon))\n- Extension example: `input-transform.ts` demonstrating input interception patterns (quick mode, instant commands, source routing) ([#761](https://github.com/badlogic/pi-mono/pull/761) by [@nicobailon](https://github.com/nicobailon))\n- Custom tool HTML export: extensions with `renderCall`/`renderResult` now render in `/share` and `/export` output with ANSI-to-HTML color conversion ([#702](https://github.com/badlogic/pi-mono/pull/702) by [@aliou](https://github.com/aliou))\n- Direct filter shortcuts in Tree mode: Ctrl+D (default), Ctrl+T (no-tools), Ctrl+U (user-only), Ctrl+L (labeled-only), Ctrl+A (all) ([#747](https://github.com/badlogic/pi-mono/pull/747) by [@kaofelix](https://github.com/kaofelix))\n\n### Changed\n\n- Skill commands (`/skill:name`) are now expanded in AgentSession instead of interactive mode. This enables skill commands in RPC and print modes, and allows the `input` event to intercept `/skill:name` before expansion.\n\n### Fixed\n\n- Editor no longer corrupts terminal display when loading large prompts via `setEditorText`. Content now scrolls vertically with indicators showing lines above/below the viewport. ([#732](https://github.com/badlogic/pi-mono/issues/732))\n- Piped stdin now works correctly: `echo foo | pi` is equivalent to `pi -p foo`. When stdin is piped, print mode is automatically enabled since interactive mode requires a TTY ([#708](https://github.com/badlogic/pi-mono/issues/708))\n- Session tree now preserves branch connectors and indentation when filters hide intermediate entries so descendants attach to the nearest visible ancestor and sibling branches align. Fixed in both TUI and HTML export ([#739](https://github.com/badlogic/pi-mono/pull/739) by [@w-winter](https://github.com/w-winter))\n- Added `upstream connect`, `connection refused`, and `reset before headers` patterns to auto-retry error detection ([#733](https://github.com/badlogic/pi-mono/issues/733))\n- Multi-line YAML frontmatter in skills and prompt templates now parses correctly. Centralized frontmatter parsing using the `yaml` library. ([#728](https://github.com/badlogic/pi-mono/pull/728) by [@richardgill](https://github.com/richardgill))\n- `ctx.shutdown()` now waits for pending UI renders to complete before exiting, ensuring notifications and final output are visible ([#756](https://github.com/badlogic/pi-mono/issues/756))\n- OpenAI Codex provider now retries on transient errors (429, 5xx, connection failures) with exponential backoff ([#733](https://github.com/badlogic/pi-mono/issues/733))\n\n## [0.46.0] - 2026-01-15\n\n### Fixed\n\n- Scoped models (`--models` or `enabledModels`) now remember the last selected model across sessions instead of always starting with the first model in the scope ([#736](https://github.com/badlogic/pi-mono/pull/736) by [@ogulcancelik](https://github.com/ogulcancelik))\n- Show `bun install` instead of `npm install` in update notification when running under Bun ([#714](https://github.com/badlogic/pi-mono/pull/714) by [@dannote](https://github.com/dannote))\n- `/skill` prompts now include the skill path ([#711](https://github.com/badlogic/pi-mono/pull/711) by [@jblwilliams](https://github.com/jblwilliams))\n- Use configurable `expandTools` keybinding instead of hardcoded Ctrl+O ([#717](https://github.com/badlogic/pi-mono/pull/717) by [@dannote](https://github.com/dannote))\n- Compaction turn prefix summaries now merge correctly ([#738](https://github.com/badlogic/pi-mono/pull/738) by [@vsabavat](https://github.com/vsabavat))\n- Avoid unsigned Gemini 3 tool calls ([#741](https://github.com/badlogic/pi-mono/pull/741) by [@roshanasingh4](https://github.com/roshanasingh4))\n- Fixed signature support for non-Anthropic models in Amazon Bedrock provider ([#727](https://github.com/badlogic/pi-mono/pull/727) by [@unexge](https://github.com/unexge))\n- Keyboard shortcuts (Ctrl+C, Ctrl+D, etc.) now work on non-Latin keyboard layouts (Russian, Ukrainian, Bulgarian, etc.) in terminals supporting Kitty keyboard protocol with alternate key reporting ([#718](https://github.com/badlogic/pi-mono/pull/718) by [@dannote](https://github.com/dannote))\n\n### Added\n\n- Edit tool now uses fuzzy matching as fallback when exact match fails, tolerating trailing whitespace, smart quotes, Unicode dashes, and special spaces ([#713](https://github.com/badlogic/pi-mono/pull/713) by [@dannote](https://github.com/dannote))\n- Support `APPEND_SYSTEM.md` to append instructions to the system prompt ([#716](https://github.com/badlogic/pi-mono/pull/716) by [@tallshort](https://github.com/tallshort))\n- Session picker search: Ctrl+R toggles sorting between fuzzy match (default) and most recent; supports quoted phrase matching and `re:` regex mode ([#731](https://github.com/badlogic/pi-mono/pull/731) by [@ogulcancelik](https://github.com/ogulcancelik))\n- Export `getAgentDir` for extensions ([#749](https://github.com/badlogic/pi-mono/pull/749) by [@dannote](https://github.com/dannote))\n- Show loaded prompt templates on startup ([#743](https://github.com/badlogic/pi-mono/pull/743) by [@tallshort](https://github.com/tallshort))\n- MiniMax China (`minimax-cn`) provider support ([#725](https://github.com/badlogic/pi-mono/pull/725) by [@tallshort](https://github.com/tallshort))\n- `gpt-5.2-codex` models for GitHub Copilot and OpenCode Zen providers ([#734](https://github.com/badlogic/pi-mono/pull/734) by [@aadishv](https://github.com/aadishv))\n\n### Changed\n\n- Replaced `wasm-vips` with `@silvia-odwyer/photon-node` for image processing ([#710](https://github.com/badlogic/pi-mono/pull/710) by [@can1357](https://github.com/can1357))\n- Extension example: `plan-mode/` shortcut changed from Shift+P to Ctrl+Alt+P to avoid conflict with typing capital P ([#746](https://github.com/badlogic/pi-mono/pull/746) by [@ferologics](https://github.com/ferologics))\n- UI keybinding hints now respect configured keybindings across components ([#724](https://github.com/badlogic/pi-mono/pull/724) by [@dannote](https://github.com/dannote))\n- CLI process title is now set to `pi` for easier process identification ([#742](https://github.com/badlogic/pi-mono/pull/742) by [@richardgill](https://github.com/richardgill))\n\n## [0.45.7] - 2026-01-13\n\n### Added\n\n- Exported `highlightCode` and `getLanguageFromPath` for extensions ([#703](https://github.com/badlogic/pi-mono/pull/703) by [@dannote](https://github.com/dannote))\n\n## [0.45.6] - 2026-01-13\n\n### Added\n\n- `ctx.ui.custom()` now accepts `overlayOptions` for overlay positioning and sizing (anchor, margins, offsets, percentages, absolute positioning) ([#667](https://github.com/badlogic/pi-mono/pull/667) by [@nicobailon](https://github.com/nicobailon))\n- `ctx.ui.custom()` now accepts `onHandle` callback to receive the `OverlayHandle` for controlling overlay visibility ([#667](https://github.com/badlogic/pi-mono/pull/667) by [@nicobailon](https://github.com/nicobailon))\n- Extension example: `overlay-qa-tests.ts` with 10 commands for testing overlay positioning, animation, and toggle scenarios ([#667](https://github.com/badlogic/pi-mono/pull/667) by [@nicobailon](https://github.com/nicobailon))\n- Extension example: `doom-overlay/` - DOOM game running as an overlay at 35 FPS (auto-downloads WAD on first run) ([#667](https://github.com/badlogic/pi-mono/pull/667) by [@nicobailon](https://github.com/nicobailon))\n\n## [0.45.5] - 2026-01-13\n\n### Fixed\n\n- Skip changelog display on fresh install (only show on upgrades)\n\n## [0.45.4] - 2026-01-13\n\n### Changed\n\n- Light theme colors adjusted for WCAG AA compliance (4.5:1 contrast ratio against white backgrounds)\n- Replaced `sharp` with `wasm-vips` for image processing (resize, PNG conversion). Eliminates native build requirements that caused installation failures on some systems. ([#696](https://github.com/badlogic/pi-mono/issues/696))\n\n### Added\n\n- Extension example: `summarize.ts` for summarizing conversations using custom UI and an external model ([#684](https://github.com/badlogic/pi-mono/pull/684) by [@scutifer](https://github.com/scutifer))\n- Extension example: `question.ts` enhanced with custom UI for asking user questions ([#693](https://github.com/badlogic/pi-mono/pull/693) by [@ferologics](https://github.com/ferologics))\n- Extension example: `plan-mode/` enhanced with explicit step tracking and progress widget ([#694](https://github.com/badlogic/pi-mono/pull/694) by [@ferologics](https://github.com/ferologics))\n- Extension example: `questionnaire.ts` for multi-question input with tab bar navigation ([#695](https://github.com/badlogic/pi-mono/pull/695) by [@ferologics](https://github.com/ferologics))\n- Experimental Vercel AI Gateway provider support: set `AI_GATEWAY_API_KEY` and use `--provider vercel-ai-gateway`. Token usage is currently reported incorrectly by Anthropic Messages compatible endpoint. ([#689](https://github.com/badlogic/pi-mono/pull/689) by [@timolins](https://github.com/timolins))\n\n### Fixed\n\n- Fix API key resolution after model switches by using provider argument ([#691](https://github.com/badlogic/pi-mono/pull/691) by [@joshp123](https://github.com/joshp123))\n- Fixed z.ai thinking/reasoning: thinking toggle now correctly enables/disables thinking for z.ai models ([#688](https://github.com/badlogic/pi-mono/issues/688))\n- Fixed extension loading in compiled Bun binary: extensions with local file imports now work correctly. Updated `@mariozechner/jiti` to v2.6.5 which bundles babel for Bun binary compatibility. ([#681](https://github.com/badlogic/pi-mono/issues/681))\n- Fixed theme loading when installed via mise: use wrapper directory in release tarballs for compatibility with mise's `strip_components=1` extraction. ([#681](https://github.com/badlogic/pi-mono/issues/681))\n\n## [0.45.2] - 2026-01-13\n\n### Fixed\n\n- Extensions now load correctly in compiled Bun binary by using jiti for module resolution with proper alias handling\n\n## [0.45.1] - 2026-01-13\n\n### Changed\n\n- `/share` now outputs `buildwithpi.ai` session preview URLs instead of `shittycodingagent.ai`\n\n## [0.45.0] - 2026-01-13\n\n### Added\n\n- MiniMax provider support: set `MINIMAX_API_KEY` and use `minimax/MiniMax-M2.1` ([#656](https://github.com/badlogic/pi-mono/pull/656) by [@dannote](https://github.com/dannote))\n- `/scoped-models`: Alt+Up/Down to reorder enabled models. Order is preserved when saving with Ctrl+S and determines Ctrl+P cycling order. ([#676](https://github.com/badlogic/pi-mono/pull/676) by [@thomasmhr](https://github.com/thomasmhr))\n- Amazon Bedrock provider support (experimental, tested with Anthropic Claude models only) ([#494](https://github.com/badlogic/pi-mono/pull/494) by [@unexge](https://github.com/unexge))\n- Extension example: `sandbox/` for OS-level bash sandboxing using `@anthropic-ai/sandbox-runtime` with per-project config ([#673](https://github.com/badlogic/pi-mono/pull/673) by [@dannote](https://github.com/dannote))\n\n## [0.44.0] - 2026-01-12\n\n### Breaking Changes\n\n- `pi.getAllTools()` now returns `ToolInfo[]` (with `name` and `description`) instead of `string[]`. Extensions that only need names can use `.map(t => t.name)`. ([#648](https://github.com/badlogic/pi-mono/pull/648) by [@carsonfarmer](https://github.com/carsonfarmer))\n\n### Added\n\n- Session naming: `/name ` command sets a display name shown in the session selector instead of the first message. Useful for distinguishing forked sessions. Extensions can use `pi.setSessionName()` and `pi.getSessionName()`. ([#650](https://github.com/badlogic/pi-mono/pull/650) by [@scutifer](https://github.com/scutifer))\n- Extension example: `notify.ts` for desktop notifications via OSC 777 escape sequence ([#658](https://github.com/badlogic/pi-mono/pull/658) by [@ferologics](https://github.com/ferologics))\n- Inline hint for queued messages showing the `Alt+Up` restore shortcut ([#657](https://github.com/badlogic/pi-mono/pull/657) by [@tmustier](https://github.com/tmustier))\n- Page-up/down navigation in `/resume` session selector to jump by 5 items ([#662](https://github.com/badlogic/pi-mono/pull/662) by [@aliou](https://github.com/aliou))\n- Fuzzy search in `/settings` menu: type to filter settings by label ([#643](https://github.com/badlogic/pi-mono/pull/643) by [@ninlds](https://github.com/ninlds))\n\n### Fixed\n\n- Session selector now stays open when current folder has no sessions, allowing Tab to switch to \"all\" scope ([#661](https://github.com/badlogic/pi-mono/pull/661) by [@aliou](https://github.com/aliou))\n- Extensions using theme utilities like `getSettingsListTheme()` now work in dev mode with tsx\n\n## [0.43.0] - 2026-01-11\n\n### Breaking Changes\n\n- Extension editor (`ctx.ui.editor()`) now uses Enter to submit and Shift+Enter for newlines, matching the main editor. Previously used Ctrl+Enter to submit. Extensions with hardcoded \"ctrl+enter\" hints need updating. ([#642](https://github.com/badlogic/pi-mono/pull/642) by [@mitsuhiko](https://github.com/mitsuhiko))\n- Renamed `/branch` command to `/fork` ([#641](https://github.com/badlogic/pi-mono/issues/641))\n  - RPC: `branch` \u2192 `fork`, `get_branch_messages` \u2192 `get_fork_messages`\n  - SDK: `branch()` \u2192 `fork()`, `getBranchMessages()` \u2192 `getForkMessages()`\n  - AgentSession: `branch()` \u2192 `fork()`, `getUserMessagesForBranching()` \u2192 `getUserMessagesForForking()`\n  - Extension events: `session_before_branch` \u2192 `session_before_fork`, `session_branch` \u2192 `session_fork`\n  - Settings: `doubleEscapeAction: \"branch\" | \"tree\"` \u2192 `\"fork\" | \"tree\"`\n- `SessionManager.list()` and `SessionManager.listAll()` are now async, returning `Promise`. Callers must await them. ([#620](https://github.com/badlogic/pi-mono/pull/620) by [@tmustier](https://github.com/tmustier))\n\n### Added\n\n- `/resume` selector now toggles between current-folder and all sessions with Tab, showing the session cwd in the All view and loading progress. ([#620](https://github.com/badlogic/pi-mono/pull/620) by [@tmustier](https://github.com/tmustier))\n- `SessionManager.list()` and `SessionManager.listAll()` accept optional `onProgress` callback for progress updates\n- `SessionInfo.cwd` field containing the session's working directory (empty string for old sessions)\n- `SessionListProgress` type export for progress callbacks\n- `/scoped-models` command to enable/disable models for Ctrl+P cycling. Changes are session-only by default; press Ctrl+S to persist to settings.json. ([#626](https://github.com/badlogic/pi-mono/pull/626) by [@CarlosGtrz](https://github.com/CarlosGtrz))\n- `model_select` extension hook fires when model changes via `/model`, model cycling, or session restore with `source` field and `previousModel` ([#628](https://github.com/badlogic/pi-mono/pull/628) by [@marckrenn](https://github.com/marckrenn))\n- `ctx.ui.setWorkingMessage()` extension API to customize the \"Working...\" message during streaming ([#625](https://github.com/badlogic/pi-mono/pull/625) by [@nicobailon](https://github.com/nicobailon))\n- Skill slash commands: loaded skills are registered as `/skill:name` commands for quick access. Toggle via `/settings` or `skills.enableSkillCommands` in settings.json. ([#630](https://github.com/badlogic/pi-mono/pull/630) by [@Dwsy](https://github.com/Dwsy))\n- Slash command autocomplete now uses fuzzy matching (type `/skbra` to match `/skill:brave-search`)\n- `/tree` branch summarization now offers three options: \"No summary\", \"Summarize\", and \"Summarize with custom prompt\". Custom prompts are appended as additional focus to the default summarization instructions. ([#642](https://github.com/badlogic/pi-mono/pull/642) by [@mitsuhiko](https://github.com/mitsuhiko))\n\n### Fixed\n\n- Session picker respects custom keybindings when using `--resume` ([#633](https://github.com/badlogic/pi-mono/pull/633) by [@aos](https://github.com/aos))\n- Custom footer extensions now see model changes: `ctx.model` is now a getter that returns the current model instead of a snapshot from when the context was created ([#634](https://github.com/badlogic/pi-mono/pull/634) by [@ogulcancelik](https://github.com/ogulcancelik))\n- Footer git branch not updating after external branch switches. Git uses atomic writes (temp file + rename), which changes the inode and breaks `fs.watch` on the file. Now watches the directory instead.\n- Extension loading errors are now displayed to the user instead of being silently ignored ([#639](https://github.com/badlogic/pi-mono/pull/639) by [@aliou](https://github.com/aliou))\n\n## [0.42.5] - 2026-01-11\n\n### Fixed\n\n- Reduced flicker by only re-rendering changed lines ([#617](https://github.com/badlogic/pi-mono/pull/617) by [@ogulcancelik](https://github.com/ogulcancelik)). No worries tho, there's still a little flicker in the VS Code Terminal. Praise the flicker.\n- Cursor position tracking when content shrinks with unchanged remaining lines\n- TUI renders with wrong dimensions after suspend/resume if terminal was resized while suspended ([#599](https://github.com/badlogic/pi-mono/issues/599))\n- Pasted content containing Kitty key release patterns (e.g., `:3F` in MAC addresses) was incorrectly filtered out ([#623](https://github.com/badlogic/pi-mono/pull/623) by [@ogulcancelik](https://github.com/ogulcancelik))\n\n## [0.42.4] - 2026-01-10\n\n### Fixed\n\n- Bash output expanded hint now says \"(ctrl+o to collapse)\" ([#610](https://github.com/badlogic/pi-mono/pull/610) by [@tallshort](https://github.com/tallshort))\n- Fixed UTF-8 text corruption in remote bash execution (SSH, containers) by using streaming TextDecoder ([#608](https://github.com/badlogic/pi-mono/issues/608))\n\n## [0.42.3] - 2026-01-10\n\n### Changed\n\n- OpenAI Codex: updated to use bundled system prompt from upstream\n\n## [0.42.2] - 2026-01-10\n\n### Added\n\n- `/model ` now pre-filters the model selector or auto-selects on exact match. Use `provider/model` syntax to disambiguate (e.g., `/model openai/gpt-4`). ([#587](https://github.com/badlogic/pi-mono/pull/587) by [@zedrdave](https://github.com/zedrdave))\n- `FooterDataProvider` for custom footers: `ctx.ui.setFooter()` now receives a third `footerData` parameter providing `getGitBranch()`, `getExtensionStatuses()`, and `onBranchChange()` for reactive updates ([#600](https://github.com/badlogic/pi-mono/pull/600) by [@nicobailon](https://github.com/nicobailon))\n- `Alt+Up` hotkey to restore queued steering/follow-up messages back into the editor without aborting the current run ([#604](https://github.com/badlogic/pi-mono/pull/604) by [@tmustier](https://github.com/tmustier))\n\n### Fixed\n\n- Fixed LM Studio compatibility for OpenAI Responses tool strict mapping in the ai provider ([#598](https://github.com/badlogic/pi-mono/pull/598) by [@gnattu](https://github.com/gnattu))\n\n## [0.42.1] - 2026-01-09\n\n### Fixed\n\n- Symlinked directories in `prompts/` folders are now followed when loading prompt templates ([#601](https://github.com/badlogic/pi-mono/pull/601) by [@aliou](https://github.com/aliou))\n\n## [0.42.0] - 2026-01-09\n\n### Added\n\n- Added OpenCode Zen provider support. Set `OPENCODE_API_KEY` env var and use `opencode/` (e.g., `opencode/claude-opus-4-5`).\n\n## [0.41.0] - 2026-01-09\n\n### Added\n\n- Anthropic OAuth support is back! Use `/login` to authenticate with your Claude Pro/Max subscription.\n\n## [0.40.1] - 2026-01-09\n\n### Removed\n\n- Anthropic OAuth support (`/login`). Use API keys instead.\n\n## [0.40.0] - 2026-01-08\n\n### Added\n\n- Documentation on component invalidation and theme changes in `docs/tui.md`\n\n### Fixed\n\n- Components now properly rebuild their content on theme change (tool executions, assistant messages, bash executions, custom messages, branch/compaction summaries)\n\n## [0.39.1] - 2026-01-08\n\n### Fixed\n\n- `setTheme()` now triggers a full rerender so previously rendered components update with the new theme colors\n- `mac-system-theme.ts` example now polls every 2 seconds and uses `osascript` for real-time macOS appearance detection\n\n## [0.39.0] - 2026-01-08\n\n### Breaking Changes\n\n- `before_agent_start` event now receives `systemPrompt` in the event object and returns `systemPrompt` (full replacement) instead of `systemPromptAppend`. Extensions that were appending must now use `event.systemPrompt + extra` pattern. ([#575](https://github.com/badlogic/pi-mono/issues/575))\n- `discoverSkills()` now returns `{ skills: Skill[], warnings: SkillWarning[] }` instead of `Skill[]`. This allows callers to handle skill loading warnings. ([#577](https://github.com/badlogic/pi-mono/pull/577) by [@cv](https://github.com/cv))\n\n### Added\n\n- `ctx.ui.getAllThemes()`, `ctx.ui.getTheme(name)`, and `ctx.ui.setTheme(name | Theme)` methods for extensions to list, load, and switch themes at runtime ([#576](https://github.com/badlogic/pi-mono/pull/576))\n- `--no-tools` flag to disable all built-in tools, allowing extension-only tool setups ([#557](https://github.com/badlogic/pi-mono/pull/557) by [@cv](https://github.com/cv))\n- Pluggable operations for built-in tools enabling remote execution via SSH or other transports ([#564](https://github.com/badlogic/pi-mono/issues/564)). Interfaces: `ReadOperations`, `WriteOperations`, `EditOperations`, `BashOperations`, `LsOperations`, `GrepOperations`, `FindOperations`\n- `user_bash` event for intercepting user `!`/`!!` commands, allowing extensions to redirect to remote systems ([#528](https://github.com/badlogic/pi-mono/issues/528))\n- `setActiveTools()` in ExtensionAPI for dynamic tool management\n- Built-in renderers used automatically for tool overrides without custom `renderCall`/`renderResult`\n- `ssh.ts` example: remote tool execution via `--ssh user@host:/path`\n- `interactive-shell.ts` example: run interactive commands (vim, git rebase, htop) with full terminal access via `!i` prefix or auto-detection\n- Wayland clipboard support for `/copy` command using wl-copy with xclip/xsel fallback ([#570](https://github.com/badlogic/pi-mono/pull/570) by [@OgulcanCelik](https://github.com/OgulcanCelik))\n- **Experimental:** `ctx.ui.custom()` now accepts `{ overlay: true }` option for floating modal components that composite over existing content without clearing the screen ([#558](https://github.com/badlogic/pi-mono/pull/558) by [@nicobailon](https://github.com/nicobailon))\n- `AgentSession.skills` and `AgentSession.skillWarnings` properties to access loaded skills without rediscovery ([#577](https://github.com/badlogic/pi-mono/pull/577) by [@cv](https://github.com/cv))\n\n### Fixed\n\n- String `systemPrompt` in `createAgentSession()` now works as a full replacement instead of having context files and skills appended, matching documented behavior ([#543](https://github.com/badlogic/pi-mono/issues/543))\n- Update notification for bun binary installs now shows release download URL instead of npm command ([#567](https://github.com/badlogic/pi-mono/pull/567) by [@ferologics](https://github.com/ferologics))\n- ESC key now works during \"Working...\" state after auto-retry ([#568](https://github.com/badlogic/pi-mono/pull/568) by [@tmustier](https://github.com/tmustier))\n- Abort messages now show correct retry attempt count (e.g., \"Aborted after 2 retry attempts\") ([#568](https://github.com/badlogic/pi-mono/pull/568) by [@tmustier](https://github.com/tmustier))\n- Fixed Antigravity provider returning 429 errors despite available quota ([#571](https://github.com/badlogic/pi-mono/pull/571) by [@ben-vargas](https://github.com/ben-vargas))\n- Fixed malformed thinking text in Gemini/Antigravity responses where thinking content appeared as regular text or vice versa. Cross-model conversations now properly convert thinking blocks to plain text. ([#561](https://github.com/badlogic/pi-mono/issues/561))\n- `--no-skills` flag now correctly prevents skills from loading in interactive mode ([#577](https://github.com/badlogic/pi-mono/pull/577) by [@cv](https://github.com/cv))\n\n## [0.38.0] - 2026-01-08\n\n### Breaking Changes\n\n- `ctx.ui.custom()` factory signature changed from `(tui, theme, done)` to `(tui, theme, keybindings, done)` for keybinding access in custom components\n- `LoadedExtension` type renamed to `Extension`\n- `LoadExtensionsResult.setUIContext()` removed, replaced with `runtime: ExtensionRuntime`\n- `ExtensionRunner` constructor now requires `runtime: ExtensionRuntime` as second parameter\n- `ExtensionRunner.initialize()` signature changed from options object to positional params `(actions, contextActions, commandContextActions?, uiContext?)`\n- `ExtensionRunner.getHasUI()` renamed to `hasUI()`\n- OpenAI Codex model aliases removed (`gpt-5`, `gpt-5-mini`, `gpt-5-nano`, `codex-mini-latest`). Use canonical IDs: `gpt-5.1`, `gpt-5.1-codex-mini`, `gpt-5.2`, `gpt-5.2-codex`. ([#536](https://github.com/badlogic/pi-mono/pull/536) by [@ghoulr](https://github.com/ghoulr))\n\n### Added\n\n- `--no-extensions` flag to disable extension discovery while still allowing explicit `-e` paths ([#524](https://github.com/badlogic/pi-mono/pull/524) by [@cv](https://github.com/cv))\n- SDK: `InteractiveMode`, `runPrintMode()`, `runRpcMode()` exported for building custom run modes. See `docs/sdk.md`.\n- `PI_SKIP_VERSION_CHECK` environment variable to disable new version notifications at startup ([#549](https://github.com/badlogic/pi-mono/pull/549) by [@aos](https://github.com/aos))\n- `thinkingBudgets` setting to customize token budgets per thinking level for token-based providers ([#529](https://github.com/badlogic/pi-mono/pull/529) by [@melihmucuk](https://github.com/melihmucuk))\n- Extension UI dialogs (`ctx.ui.select()`, `ctx.ui.confirm()`, `ctx.ui.input()`) now support a `timeout` option with live countdown display ([#522](https://github.com/badlogic/pi-mono/pull/522) by [@nicobailon](https://github.com/nicobailon))\n- Extensions can now provide custom editor components via `ctx.ui.setEditorComponent()`. See `examples/extensions/modal-editor.ts` and `docs/tui.md` Pattern 7.\n- Extension factories can now be async, enabling dynamic imports and lazy-loaded dependencies ([#513](https://github.com/badlogic/pi-mono/pull/513) by [@austinm911](https://github.com/austinm911))\n- `ctx.shutdown()` is now available in extension contexts for requesting a graceful shutdown. In interactive mode, shutdown is deferred until the agent becomes idle (after processing all queued steering and follow-up messages). In RPC mode, shutdown is deferred until after completing the current command response. In print mode, shutdown is a no-op as the process exits automatically when prompts complete. ([#542](https://github.com/badlogic/pi-mono/pull/542) by [@kaofelix](https://github.com/kaofelix))\n\n### Fixed\n\n- Default thinking level from settings now applies correctly when `enabledModels` is configured ([#540](https://github.com/badlogic/pi-mono/pull/540) by [@ferologics](https://github.com/ferologics))\n- External edits to `settings.json` while pi is running are now preserved when pi saves settings ([#527](https://github.com/badlogic/pi-mono/pull/527) by [@ferologics](https://github.com/ferologics))\n- Overflow-based compaction now skips if error came from a different model or was already handled by a previous compaction ([#535](https://github.com/badlogic/pi-mono/pull/535) by [@mitsuhiko](https://github.com/mitsuhiko))\n- OpenAI Codex context window reduced from 400k to 272k tokens to match Codex CLI defaults and prevent 400 errors ([#536](https://github.com/badlogic/pi-mono/pull/536) by [@ghoulr](https://github.com/ghoulr))\n- Context overflow detection now recognizes `context_length_exceeded` errors.\n- Key presses no longer dropped when input is batched over SSH ([#538](https://github.com/badlogic/pi-mono/issues/538))\n- Clipboard image support now works on Alpine Linux and other musl-based distros ([#533](https://github.com/badlogic/pi-mono/issues/533))\n\n## [0.37.6] - 2026-01-06\n\n### Added\n\n- Extension UI dialogs (`ctx.ui.select()`, `ctx.ui.confirm()`, `ctx.ui.input()`) now accept an optional `AbortSignal` to programmatically dismiss dialogs. Useful for implementing timeouts. See `examples/extensions/timed-confirm.ts`. ([#474](https://github.com/badlogic/pi-mono/issues/474))\n- HTML export now shows bridge prompts in model change messages for Codex sessions ([#510](https://github.com/badlogic/pi-mono/pull/510) by [@mitsuhiko](https://github.com/mitsuhiko))\n\n## [0.37.5] - 2026-01-06\n\n### Added\n\n- ExtensionAPI: `setModel()`, `getThinkingLevel()`, `setThinkingLevel()` methods for extensions to change model and thinking level at runtime ([#509](https://github.com/badlogic/pi-mono/issues/509))\n- Exported truncation utilities for custom tools: `truncateHead`, `truncateTail`, `truncateLine`, `formatSize`, `DEFAULT_MAX_BYTES`, `DEFAULT_MAX_LINES`, `TruncationOptions`, `TruncationResult`\n- New example `truncated-tool.ts` demonstrating proper output truncation with custom rendering for extensions\n- New example `preset.ts` demonstrating preset configurations with model/thinking/tools switching ([#347](https://github.com/badlogic/pi-mono/issues/347))\n- Documentation for output truncation best practices in `docs/extensions.md`\n- Exported all UI components for extensions: `ArminComponent`, `AssistantMessageComponent`, `BashExecutionComponent`, `BorderedLoader`, `BranchSummaryMessageComponent`, `CompactionSummaryMessageComponent`, `CustomEditor`, `CustomMessageComponent`, `DynamicBorder`, `ExtensionEditorComponent`, `ExtensionInputComponent`, `ExtensionSelectorComponent`, `FooterComponent`, `LoginDialogComponent`, `ModelSelectorComponent`, `OAuthSelectorComponent`, `SessionSelectorComponent`, `SettingsSelectorComponent`, `ShowImagesSelectorComponent`, `ThemeSelectorComponent`, `ThinkingSelectorComponent`, `ToolExecutionComponent`, `TreeSelectorComponent`, `UserMessageComponent`, `UserMessageSelectorComponent`, plus utilities `renderDiff`, `truncateToVisualLines`\n- `docs/tui.md`: Common Patterns section with copy-paste code for SelectList, BorderedLoader, SettingsList, setStatus, setWidget, setFooter\n- `docs/tui.md`: Key Rules section documenting critical patterns for extension UI development\n- `docs/extensions.md`: Exhaustive example links for all ExtensionAPI methods and events\n- System prompt now references `docs/tui.md` for TUI component development\n\n## [0.37.4] - 2026-01-06\n\n### Added\n\n- Session picker (`pi -r`) and `--session` flag now support searching/resuming by session ID (UUID prefix) ([#495](https://github.com/badlogic/pi-mono/issues/495) by [@arunsathiya](https://github.com/arunsathiya))\n- Extensions can now replace the startup header with `ctx.ui.setHeader()`, see `examples/extensions/custom-header.ts` ([#500](https://github.com/badlogic/pi-mono/pull/500) by [@tudoroancea](https://github.com/tudoroancea))\n\n### Changed\n\n- Startup help text: fixed misleading \"ctrl+k to delete line\" to \"ctrl+k to delete to end\"\n- Startup help text and `/hotkeys`: added `!!` shortcut for running bash without adding output to context\n\n### Fixed\n\n- Queued steering/follow-up messages no longer wipe unsent editor input ([#503](https://github.com/badlogic/pi-mono/pull/503) by [@tmustier](https://github.com/tmustier))\n- OAuth token refresh failure no longer crashes app at startup, allowing user to `/login` to re-authenticate ([#498](https://github.com/badlogic/pi-mono/issues/498))\n\n## [0.37.3] - 2026-01-06\n\n### Added\n\n- Extensions can now replace the footer with `ctx.ui.setFooter()`, see `examples/extensions/custom-footer.ts` ([#481](https://github.com/badlogic/pi-mono/issues/481))\n- Session ID is now forwarded to LLM providers for session-based caching (used by OpenAI Codex for prompt caching).\n- Added `blockImages` setting to prevent images from being sent to LLM providers ([#492](https://github.com/badlogic/pi-mono/pull/492) by [@jsinge97](https://github.com/jsinge97))\n- Extensions can now send user messages via `pi.sendUserMessage()` ([#483](https://github.com/badlogic/pi-mono/issues/483))\n\n### Fixed\n\n- Add `minimatch` as a direct dependency for explicit imports.\n- Status bar now shows correct git branch when running in a git worktree ([#490](https://github.com/badlogic/pi-mono/pull/490) by [@kcosr](https://github.com/kcosr))\n- Interactive mode: Ctrl+V clipboard image paste now works on Wayland sessions by using `wl-paste` with `xclip` fallback ([#488](https://github.com/badlogic/pi-mono/pull/488) by [@ghoulr](https://github.com/ghoulr))\n\n## [0.37.2] - 2026-01-05\n\n### Fixed\n\n- Extension directories in `settings.json` now respect `package.json` manifests, matching global extension behavior ([#480](https://github.com/badlogic/pi-mono/pull/480) by [@prateekmedia](https://github.com/prateekmedia))\n- Share viewer: deep links now scroll to the target message when opened via `/share`\n- Bash tool now handles spawn errors gracefully instead of crashing the agent (missing cwd, invalid shell path) ([#479](https://github.com/badlogic/pi-mono/pull/479) by [@robinwander](https://github.com/robinwander))\n\n## [0.37.1] - 2026-01-05\n\n### Fixed\n\n- Share viewer: copy-link buttons now generate correct URLs when session is viewed via `/share` (iframe context)\n\n## [0.37.0] - 2026-01-05\n\n### Added\n\n- Share viewer: copy-link button on messages to share URLs that navigate directly to a specific message ([#477](https://github.com/badlogic/pi-mono/pull/477) by [@lockmeister](https://github.com/lockmeister))\n- Extension example: add `claude-rules` to load `.claude/rules/` entries into the system prompt ([#461](https://github.com/badlogic/pi-mono/pull/461) by [@vaayne](https://github.com/vaayne))\n- Headless OAuth login: all providers now show paste input for manual URL/code entry, works over SSH without DISPLAY ([#428](https://github.com/badlogic/pi-mono/pull/428) by [@ben-vargas](https://github.com/ben-vargas), [#468](https://github.com/badlogic/pi-mono/pull/468) by [@crcatala](https://github.com/crcatala))\n\n### Changed\n\n- OAuth login UI now uses dedicated dialog component with consistent borders\n- Assume truecolor support for all terminals except `dumb`, empty, or `linux` (fixes colors over SSH)\n- OpenAI Codex clean-up: removed per-thinking-level model variants, thinking level is now set separately and the provider clamps to what each model supports internally (initial implementation in [#472](https://github.com/badlogic/pi-mono/pull/472) by [@ben-vargas](https://github.com/ben-vargas))\n\n### Fixed\n\n- Messages submitted during compaction are queued and delivered after compaction completes, preserving steering and follow-up behavior. Extension commands execute immediately during compaction. ([#476](https://github.com/badlogic/pi-mono/pull/476) by [@tmustier](https://github.com/tmustier))\n- Managed binaries (`fd`, `rg`) now stored in `~/.pi/agent/bin/` instead of `tools/`, eliminating false deprecation warnings ([#470](https://github.com/badlogic/pi-mono/pull/470) by [@mcinteerj](https://github.com/mcinteerj))\n- Extensions defined in `settings.json` were not loaded ([#463](https://github.com/badlogic/pi-mono/pull/463) by [@melihmucuk](https://github.com/melihmucuk))\n- OAuth refresh no longer logs users out when multiple pi instances are running ([#466](https://github.com/badlogic/pi-mono/pull/466) by [@Cursivez](https://github.com/Cursivez))\n- Migration warnings now ignore `fd.exe` and `rg.exe` in `tools/` on Windows ([#458](https://github.com/badlogic/pi-mono/pull/458) by [@carlosgtrz](https://github.com/carlosgtrz))\n- CI: add `examples/extensions/with-deps` to workspaces to fix typecheck ([#467](https://github.com/badlogic/pi-mono/pull/467) by [@aliou](https://github.com/aliou))\n- SDK: passing `extensions: []` now disables extension discovery as documented ([#465](https://github.com/badlogic/pi-mono/pull/465) by [@aliou](https://github.com/aliou))\n\n## [0.36.0] - 2026-01-05\n\n### Added\n\n- Experimental: OpenAI Codex OAuth provider support: access Codex models via ChatGPT Plus/Pro subscription using `/login openai-codex` ([#451](https://github.com/badlogic/pi-mono/pull/451) by [@kim0](https://github.com/kim0))\n\n## [0.35.0] - 2026-01-05\n\nThis release unifies hooks and custom tools into a single \"extensions\" system and renames \"slash commands\" to \"prompt templates\". ([#454](https://github.com/badlogic/pi-mono/issues/454))\n\n**Before migrating, read:**\n- [docs/extensions.md](docs/extensions.md) - Full API reference\n- [README.md](README.md) - Extensions section with examples\n- [examples/extensions/](examples/extensions/) - Working examples\n\n### Extensions Migration\n\nHooks and custom tools are now unified as **extensions**. Both were TypeScript modules exporting a factory function that receives an API object. Now there's one concept, one discovery location, one CLI flag, one settings.json entry.\n\n**Automatic migration:**\n- `commands/` directories are automatically renamed to `prompts/` on startup (both `~/.pi/agent/commands/` and `.pi/commands/`)\n\n**Manual migration required:**\n1. Move files from `hooks/` and `tools/` directories to `extensions/` (deprecation warnings shown on startup)\n2. Update imports and type names in your extension code\n3. Update `settings.json` if you have explicit hook and custom tool paths configured\n\n**Directory changes:**\n```\n# Before\n~/.pi/agent/hooks/*.ts       \u2192  ~/.pi/agent/extensions/*.ts\n~/.pi/agent/tools/*.ts       \u2192  ~/.pi/agent/extensions/*.ts\n.pi/hooks/*.ts               \u2192  .pi/extensions/*.ts\n.pi/tools/*.ts               \u2192  .pi/extensions/*.ts\n```\n\n**Extension discovery rules** (in `extensions/` directories):\n1. **Direct files:** `extensions/*.ts` or `*.js` \u2192 loaded directly\n2. **Subdirectory with index:** `extensions/myext/index.ts` \u2192 loaded as single extension\n3. **Subdirectory with package.json:** `extensions/myext/package.json` with `\"pi\"` field \u2192 loads declared paths\n\n```json\n// extensions/my-package/package.json\n{\n  \"name\": \"my-extension-package\",\n  \"dependencies\": { \"zod\": \"^3.0.0\" },\n  \"pi\": {\n    \"extensions\": [\"./src/main.ts\", \"./src/tools.ts\"]\n  }\n}\n```\n\nNo recursion beyond one level. Complex packages must use the `package.json` manifest. Dependencies are resolved via jiti, and extensions can be published to and installed from npm.\n\n**Type renames:**\n- `HookAPI` \u2192 `ExtensionAPI`\n- `HookContext` \u2192 `ExtensionContext`\n- `HookCommandContext` \u2192 `ExtensionCommandContext`\n- `HookUIContext` \u2192 `ExtensionUIContext`\n- `CustomToolAPI` \u2192 `ExtensionAPI` (merged)\n- `CustomToolContext` \u2192 `ExtensionContext` (merged)\n- `CustomToolUIContext` \u2192 `ExtensionUIContext`\n- `CustomTool` \u2192 `ToolDefinition`\n- `CustomToolFactory` \u2192 `ExtensionFactory`\n- `HookMessage` \u2192 `CustomMessage`\n\n**Import changes:**\n```typescript\n// Before (hook)\nimport type { HookAPI, HookContext } from \"@mariozechner/pi-coding-agent\";\nexport default function (pi: HookAPI) { ... }\n\n// Before (custom tool)\nimport type { CustomToolFactory } from \"@mariozechner/pi-coding-agent\";\nconst factory: CustomToolFactory = (pi) => ({ name: \"my_tool\", ... });\nexport default factory;\n\n// After (both are now extensions)\nimport type { ExtensionAPI } from \"@mariozechner/pi-coding-agent\";\nexport default function (pi: ExtensionAPI) {\n  pi.on(\"tool_call\", async (event, ctx) => { ... });\n  pi.registerTool({ name: \"my_tool\", ... });\n}\n```\n\n**Custom tools now have full context access.** Tools registered via `pi.registerTool()` now receive the same `ctx` object that event handlers receive. Previously, custom tools had limited context. Now all extension code shares the same capabilities:\n\n- `pi.registerTool()` - Register tools the LLM can call\n- `pi.registerCommand()` - Register commands like `/mycommand`\n- `pi.registerShortcut()` - Register keyboard shortcuts (shown in `/hotkeys`)\n- `pi.registerFlag()` - Register CLI flags (shown in `--help`)\n- `pi.registerMessageRenderer()` - Custom TUI rendering for message types\n- `pi.on()` - Subscribe to lifecycle events (tool_call, session_start, etc.)\n- `pi.sendMessage()` - Inject messages into the conversation\n- `pi.appendEntry()` - Persist custom data in session (survives restart/branch)\n- `pi.exec()` - Run shell commands\n- `pi.getActiveTools()` / `pi.setActiveTools()` - Dynamic tool enable/disable\n- `pi.getAllTools()` - List all available tools\n- `pi.events` - Event bus for cross-extension communication\n- `ctx.ui.confirm()` / `select()` / `input()` - User prompts\n- `ctx.ui.notify()` - Toast notifications\n- `ctx.ui.setStatus()` - Persistent status in footer (multiple extensions can set their own)\n- `ctx.ui.setWidget()` - Widget display above editor\n- `ctx.ui.setTitle()` - Set terminal window title\n- `ctx.ui.custom()` - Full TUI component with keyboard handling\n- `ctx.ui.editor()` - Multi-line text editor with external editor support\n- `ctx.sessionManager` - Read session entries, get branch history\n\n**Settings changes:**\n```json\n// Before\n{\n  \"hooks\": [\"./my-hook.ts\"],\n  \"customTools\": [\"./my-tool.ts\"]\n}\n\n// After\n{\n  \"extensions\": [\"./my-extension.ts\"]\n}\n```\n\n**CLI changes:**\n```bash\n# Before\npi --hook ./safety.ts --tool ./todo.ts\n\n# After\npi --extension ./safety.ts -e ./todo.ts\n```\n\n### Prompt Templates Migration\n\n\"Slash commands\" (markdown files defining reusable prompts invoked via `/name`) are renamed to \"prompt templates\" to avoid confusion with extension-registered commands.\n\n**Automatic migration:** The `commands/` directory is automatically renamed to `prompts/` on startup (if `prompts/` doesn't exist). Works for both regular directories and symlinks.\n\n**Directory changes:**\n```\n~/.pi/agent/commands/*.md    \u2192  ~/.pi/agent/prompts/*.md\n.pi/commands/*.md            \u2192  .pi/prompts/*.md\n```\n\n**SDK type renames:**\n- `FileSlashCommand` \u2192 `PromptTemplate`\n- `LoadSlashCommandsOptions` \u2192 `LoadPromptTemplatesOptions`\n\n**SDK function renames:**\n- `discoverSlashCommands()` \u2192 `discoverPromptTemplates()`\n- `loadSlashCommands()` \u2192 `loadPromptTemplates()`\n- `expandSlashCommand()` \u2192 `expandPromptTemplate()`\n- `getCommandsDir()` \u2192 `getPromptsDir()`\n\n**SDK option renames:**\n- `CreateAgentSessionOptions.slashCommands` \u2192 `.promptTemplates`\n- `AgentSession.fileCommands` \u2192 `.promptTemplates`\n- `PromptOptions.expandSlashCommands` \u2192 `.expandPromptTemplates`\n\n### SDK Migration\n\n**Discovery functions:**\n- `discoverAndLoadHooks()` \u2192 `discoverAndLoadExtensions()`\n- `discoverAndLoadCustomTools()` \u2192 merged into `discoverAndLoadExtensions()`\n- `loadHooks()` \u2192 `loadExtensions()`\n- `loadCustomTools()` \u2192 merged into `loadExtensions()`\n\n**Runner and wrapper:**\n- `HookRunner` \u2192 `ExtensionRunner`\n- `wrapToolsWithHooks()` \u2192 `wrapToolsWithExtensions()`\n- `wrapToolWithHooks()` \u2192 `wrapToolWithExtensions()`\n\n**CreateAgentSessionOptions:**\n- `.hooks` \u2192 removed (use `.additionalExtensionPaths` for paths)\n- `.additionalHookPaths` \u2192 `.additionalExtensionPaths`\n- `.preloadedHooks` \u2192 `.preloadedExtensions`\n- `.customTools` type changed: `Array<{ path?; tool: CustomTool }>` \u2192 `ToolDefinition[]`\n- `.additionalCustomToolPaths` \u2192 merged into `.additionalExtensionPaths`\n- `.slashCommands` \u2192 `.promptTemplates`\n\n**AgentSession:**\n- `.hookRunner` \u2192 `.extensionRunner`\n- `.fileCommands` \u2192 `.promptTemplates`\n- `.sendHookMessage()` \u2192 `.sendCustomMessage()`\n\n### Session Migration\n\n**Automatic.** Session version bumped from 2 to 3. Existing sessions are migrated on first load:\n- Message role `\"hookMessage\"` \u2192 `\"custom\"`\n\n## [0.34.1] - 2026-01-04\n\n### Changed\n\n- Expanded keybinding documentation to list all 32 supported symbol keys with notes on ctrl+symbol behavior ([#450](https://github.com/badlogic/pi-mono/pull/450) by [@kaofelix](https://github.com/kaofelix))\n\n## [0.34.0] - 2026-01-04\n\n### Added\n\n- Hook API: `before_agent_start` handlers can now return `systemPromptAppend` to dynamically append text to the system prompt for that turn. Multiple hooks' appends are concatenated.\n- Hook API: `before_agent_start` handlers can now return multiple messages (all are injected, not just the first)\n- New example hook: `tools.ts` - Interactive `/tools` command to enable/disable tools with session persistence\n- New example hook: `pirate.ts` - Demonstrates `systemPromptAppend` to make the agent speak like a pirate\n- Tool registry now contains all built-in tools (read, bash, edit, write, grep, find, ls) even when `--tools` limits the initially active set. Hooks can enable any tool from the registry via `pi.setActiveTools()`.\n- System prompt now automatically rebuilds when tools change via `setActiveTools()`, updating tool descriptions and guidelines to match the new tool set\n- Hook errors now display full stack traces for easier debugging\n\n### Changed\n\n- Removed image placeholders after copy & paste, replaced with inserting image file paths directly. ([#442](https://github.com/badlogic/pi-mono/pull/442) by [@mitsuhiko](https://github.com/mitsuhiko))\n\n### Fixed\n\n- Fixed potential text decoding issues in bash executor by using streaming TextDecoder instead of Buffer.toString()\n- External editor (Ctrl-G) now shows full pasted content instead of `[paste #N ...]` placeholders ([#444](https://github.com/badlogic/pi-mono/pull/444) by [@aliou](https://github.com/aliou))\n\n## [0.33.0] - 2026-01-04\n\n### Breaking Changes\n\n- **Key detection functions removed from `@mariozechner/pi-tui`**: All `isXxx()` key detection functions (`isEnter()`, `isEscape()`, `isCtrlC()`, etc.) have been removed. Use `matchesKey(data, keyId)` instead (e.g., `matchesKey(data, \"enter\")`, `matchesKey(data, \"ctrl+c\")`). This affects hooks and custom tools that use `ctx.ui.custom()` with keyboard input handling. ([#405](https://github.com/badlogic/pi-mono/pull/405))\n\n### Added\n\n- Clipboard image paste support via `Ctrl+V`. Images are saved to a temp file and attached to the message. Works on macOS, Windows, and Linux (X11). ([#419](https://github.com/badlogic/pi-mono/issues/419))\n- Configurable keybindings via `~/.pi/agent/keybindings.json`. All keyboard shortcuts (editor navigation, deletion, app actions like model cycling, etc.) can now be customized. Supports multiple bindings per action. ([#405](https://github.com/badlogic/pi-mono/pull/405) by [@hjanuschka](https://github.com/hjanuschka))\n- `/quit` and `/exit` slash commands to gracefully exit the application. Unlike double Ctrl+C, these properly await hook and custom tool cleanup handlers before exiting. ([#426](https://github.com/badlogic/pi-mono/pull/426) by [@ben-vargas](https://github.com/ben-vargas))\n\n### Fixed\n\n- Subagent example README referenced incorrect filename `subagent.ts` instead of `index.ts` ([#427](https://github.com/badlogic/pi-mono/pull/427) by [@Whamp](https://github.com/Whamp))\n\n## [0.32.3] - 2026-01-03\n\n### Fixed\n\n- `--list-models` no longer shows Google Vertex AI models without explicit authentication configured\n- JPEG/GIF/WebP images not displaying in terminals using Kitty graphics protocol (Kitty, Ghostty, WezTerm). The protocol requires PNG format, so non-PNG images are now converted before display.\n- Version check URL typo preventing update notifications from working ([#423](https://github.com/badlogic/pi-mono/pull/423) by [@skuridin](https://github.com/skuridin))\n- Large images exceeding Anthropic's 5MB limit now retry with progressive quality/size reduction ([#424](https://github.com/badlogic/pi-mono/pull/424) by [@mitsuhiko](https://github.com/mitsuhiko))\n\n## [0.32.2] - 2026-01-03\n\n### Added\n\n- `$ARGUMENTS` syntax for custom slash commands as alternative to `$@` for all arguments joined. Aligns with patterns used by Claude, Codex, and OpenCode. Both syntaxes remain fully supported. ([#418](https://github.com/badlogic/pi-mono/pull/418) by [@skuridin](https://github.com/skuridin))\n\n### Changed\n\n- **Slash commands and hook commands now work during streaming**: Previously, using a slash command or hook command while the agent was streaming would crash with \"Agent is already processing\". Now:\n  - Hook commands execute immediately (they manage their own LLM interaction via `pi.sendMessage()`)\n  - File-based slash commands are expanded and queued via steer/followUp\n  - `steer()` and `followUp()` now expand file-based slash commands and error on hook commands (hook commands cannot be queued)\n  - `prompt()` accepts new `streamingBehavior` option (`\"steer\"` or `\"followUp\"`) to specify queueing behavior during streaming\n  - RPC `prompt` command now accepts optional `streamingBehavior` field\n  ([#420](https://github.com/badlogic/pi-mono/issues/420))\n\n### Fixed\n\n- Slash command argument substitution now processes positional arguments (`$1`, `$2`, etc.) before all-arguments (`$@`, `$ARGUMENTS`) to prevent recursive substitution when argument values contain dollar-digit patterns like `$100`. ([#418](https://github.com/badlogic/pi-mono/pull/418) by [@skuridin](https://github.com/skuridin))\n\n## [0.32.1] - 2026-01-03\n\n### Added\n\n- Shell commands without context contribution: use `!!command` to execute a bash command that is shown in the TUI and saved to session history but excluded from LLM context. Useful for running commands you don't want the AI to see. ([#414](https://github.com/badlogic/pi-mono/issues/414))\n\n## [0.32.0] - 2026-01-03\n\n### Breaking Changes\n\n- **Queue API replaced with steer/followUp**: The `queueMessage()` method has been split into two methods with different delivery semantics ([#403](https://github.com/badlogic/pi-mono/issues/403)):\n  - `steer(text)`: Interrupts the agent mid-run (Enter while streaming). Delivered after current tool execution.\n  - `followUp(text)`: Waits until the agent finishes (Alt+Enter while streaming). Delivered only when agent stops.\n- **Settings renamed**: `queueMode` setting renamed to `steeringMode`. Added new `followUpMode` setting. Old settings.json files are migrated automatically.\n- **AgentSession methods renamed**:\n  - `queueMessage()` \u2192 `steer()` and `followUp()`\n  - `queueMode` getter \u2192 `steeringMode` and `followUpMode` getters\n  - `setQueueMode()` \u2192 `setSteeringMode()` and `setFollowUpMode()`\n  - `queuedMessageCount` \u2192 `pendingMessageCount`\n  - `getQueuedMessages()` \u2192 `getSteeringMessages()` and `getFollowUpMessages()`\n  - `clearQueue()` now returns `{ steering: string[], followUp: string[] }`\n  - `hasQueuedMessages()` \u2192 `hasPendingMessages()`\n- **Hook API signature changed**: `pi.sendMessage()` second parameter changed from `triggerTurn?: boolean` to `options?: { triggerTurn?, deliverAs? }`. Use `deliverAs: \"followUp\"` for follow-up delivery. Affects both hooks and internal `sendHookMessage()` method.\n- **RPC API changes**:\n  - `queue_message` command \u2192 `steer` and `follow_up` commands\n  - `set_queue_mode` command \u2192 `set_steering_mode` and `set_follow_up_mode` commands\n  - `RpcSessionState.queueMode` \u2192 `steeringMode` and `followUpMode`\n- **Settings UI**: \"Queue mode\" setting split into \"Steering mode\" and \"Follow-up mode\"\n\n## [0.31.1] - 2026-01-02\n\n### Fixed\n\n- Model selector no longer allows negative index when pressing arrow keys before models finish loading ([#398](https://github.com/badlogic/pi-mono/pull/398) by [@mitsuhiko](https://github.com/mitsuhiko))\n- Type guard functions (`isBashToolResult`, etc.) now exported at runtime, not just in type declarations ([#397](https://github.com/badlogic/pi-mono/issues/397))\n\n## [0.31.0] - 2026-01-02\n\nThis release introduces session trees for in-place branching, major API changes to hooks and custom tools, and structured compaction with file tracking.\n\n### Session Tree\n\nSessions now use a tree structure with `id`/`parentId` fields. This enables in-place branching: navigate to any previous point with `/tree`, continue from there, and switch between branches while preserving all history in a single file.\n\n**Existing sessions are automatically migrated** (v1 \u2192 v2) on first load. No manual action required.\n\nNew entry types: `BranchSummaryEntry` (context from abandoned branches), `CustomEntry` (hook state), `CustomMessageEntry` (hook-injected messages), `LabelEntry` (bookmarks).\n\nSee [docs/session.md](docs/session.md) for the file format and `SessionManager` API.\n\n### Hooks Migration\n\nThe hooks API has been restructured with more granular events and better session access.\n\n**Type renames:**\n\n- `HookEventContext` \u2192 `HookContext`\n- `HookCommandContext` is now a new interface extending `HookContext` with session control methods\n\n**Event changes:**\n\n- The monolithic `session` event is now split into granular events: `session_start`, `session_before_switch`, `session_switch`, `session_before_branch`, `session_branch`, `session_before_compact`, `session_compact`, `session_shutdown`\n- `session_before_switch` and `session_switch` events now include `reason: \"new\" | \"resume\"` to distinguish between `/new` and `/resume`\n- New `session_before_tree` and `session_tree` events for `/tree` navigation (hook can provide custom branch summary)\n- New `before_agent_start` event: inject messages before the agent loop starts\n- New `context` event: modify messages non-destructively before each LLM call\n- Session entries are no longer passed in events. Use `ctx.sessionManager.getEntries()` or `ctx.sessionManager.getBranch()` instead\n\n**API changes:**\n\n- `pi.send(text, attachments?)` \u2192 `pi.sendMessage(message, triggerTurn?)` (creates `CustomMessageEntry`)\n- New `pi.appendEntry(customType, data?)` for hook state persistence (not in LLM context)\n- New `pi.registerCommand(name, options)` for custom slash commands (handler receives `HookCommandContext`)\n- New `pi.registerMessageRenderer(customType, renderer)` for custom TUI rendering\n- New `ctx.isIdle()`, `ctx.abort()`, `ctx.hasQueuedMessages()` for agent state (available in all events)\n- New `ctx.ui.editor(title, prefill?)` for multi-line text editing with Ctrl+G external editor support\n- New `ctx.ui.custom(component)` for full TUI component rendering with keyboard focus\n- New `ctx.ui.setStatus(key, text)` for persistent status text in footer (multiple hooks can set their own)\n- New `ctx.ui.theme` getter for styling text with theme colors\n- `ctx.exec()` moved to `pi.exec()`\n- `ctx.sessionFile` \u2192 `ctx.sessionManager.getSessionFile()`\n- New `ctx.modelRegistry` and `ctx.model` for API key resolution\n\n**HookCommandContext (slash commands only):**\n\n- `ctx.waitForIdle()` - wait for agent to finish streaming\n- `ctx.newSession(options?)` - create new sessions with optional setup callback\n- `ctx.branch(entryId)` - branch from a specific entry\n- `ctx.navigateTree(targetId, options?)` - navigate the session tree\n\nThese methods are only on `HookCommandContext` (not `HookContext`) because they can deadlock if called from event handlers that run inside the agent loop.\n\n**Removed:**\n\n- `hookTimeout` setting (hooks no longer have timeouts; use Ctrl+C to abort)\n- `resolveApiKey` parameter (use `ctx.modelRegistry.getApiKey(model)`)\n\nSee [docs/hooks.md](docs/hooks.md) and [examples/hooks/](examples/hooks/) for the current API.\n\n### Custom Tools Migration\n\nThe custom tools API has been restructured to mirror the hooks pattern with a context object.\n\n**Type renames:**\n\n- `CustomAgentTool` \u2192 `CustomTool`\n- `ToolAPI` \u2192 `CustomToolAPI`\n- `ToolContext` \u2192 `CustomToolContext`\n- `ToolSessionEvent` \u2192 `CustomToolSessionEvent`\n\n**Execute signature changed:**\n\n```typescript\n// Before (v0.30.2)\nexecute(toolCallId, params, signal, onUpdate)\n\n// After\nexecute(toolCallId, params, onUpdate, ctx, signal?)\n```\n\nThe new `ctx: CustomToolContext` provides `sessionManager`, `modelRegistry`, `model`, and agent state methods:\n\n- `ctx.isIdle()` - check if agent is streaming\n- `ctx.hasQueuedMessages()` - check if user has queued messages (skip interactive prompts)\n- `ctx.abort()` - abort current operation (fire-and-forget)\n\n**Session event changes:**\n\n- `CustomToolSessionEvent` now only has `reason` and `previousSessionFile`\n- Session entries are no longer in the event. Use `ctx.sessionManager.getBranch()` or `ctx.sessionManager.getEntries()` to reconstruct state\n- Reasons: `\"start\" | \"switch\" | \"branch\" | \"tree\" | \"shutdown\"` (no separate `\"new\"` reason; `/new` triggers `\"switch\"`)\n- `dispose()` method removed. Use `onSession` with `reason: \"shutdown\"` for cleanup\n\nSee [docs/custom-tools.md](docs/custom-tools.md) and [examples/custom-tools/](examples/custom-tools/) for the current API.\n\n### SDK Migration\n\n**Type changes:**\n\n- `CustomAgentTool` \u2192 `CustomTool`\n- `AppMessage` \u2192 `AgentMessage`\n- `sessionFile` returns `string | undefined` (was `string | null`)\n- `model` returns `Model | undefined` (was `Model | null`)\n- `Attachment` type removed. Use `ImageContent` from `@oh-my-pi/pi-ai` instead. Add images directly to message content arrays.\n\n**AgentSession API:**\n\n- `branch(entryIndex: number)` \u2192 `branch(entryId: string)`\n- `getUserMessagesForBranching()` returns `{ entryId, text }` instead of `{ entryIndex, text }`\n- `reset()` \u2192 `newSession(options?)` where options has optional `parentSession` for lineage tracking\n- `newSession()` and `switchSession()` now return `Promise` (false if cancelled by hook)\n- New `navigateTree(targetId, options?)` for in-place tree navigation\n\n**Hook integration:**\n\n- New `sendHookMessage(message, triggerTurn?)` for hook message injection\n\n**SessionManager API:**\n\n- Method renames: `saveXXX()` \u2192 `appendXXX()` (e.g., `appendMessage`, `appendCompaction`)\n- `branchInPlace()` \u2192 `branch()`\n- `reset()` \u2192 `newSession(options?)` with optional `parentSession` for lineage tracking\n- `createBranchedSessionFromEntries(entries, index)` \u2192 `createBranchedSession(leafId)`\n- `SessionHeader.branchedFrom` \u2192 `SessionHeader.parentSession`\n- `saveCompaction(entry)` \u2192 `appendCompaction(summary, firstKeptEntryId, tokensBefore, details?)`\n- `getEntries()` now excludes the session header (use `getHeader()` separately)\n- `getSessionFile()` returns `string | undefined` (undefined for in-memory sessions)\n- New tree methods: `getTree()`, `getBranch()`, `getLeafId()`, `getLeafEntry()`, `getEntry()`, `getChildren()`, `getLabel()`\n- New append methods: `appendCustomEntry()`, `appendCustomMessageEntry()`, `appendLabelChange()`\n- New branch methods: `branch(entryId)`, `branchWithSummary()`\n\n**ModelRegistry (new):**\n\n`ModelRegistry` is a new class that manages model discovery and API key resolution. It combines built-in models with custom models from `models.json` and resolves API keys via `AuthStorage`.\n\n```typescript\nimport { discoverAuthStorage, discoverModels } from \"@oh-my-pi/pi-coding-agent\";\n\nconst authStorage = discoverAuthStorage(); // ~/.pi/agent/auth.json\nconst modelRegistry = discoverModels(authStorage); // + ~/.pi/agent/models.json\n\n// Get all models (built-in + custom)\nconst allModels = modelRegistry.getAll();\n\n// Get only models with valid API keys\nconst available = await modelRegistry.getAvailable();\n\n// Find specific model\nconst model = modelRegistry.find(\"anthropic\", \"claude-sonnet-4-20250514\");\n\n// Get API key for a model\nconst apiKey = await modelRegistry.getApiKey(model);\n```\n\nThis replaces the old `resolveApiKey` callback pattern. Hooks and custom tools access it via `ctx.modelRegistry`.\n\n**Renamed exports:**\n\n- `messageTransformer` \u2192 `convertToLlm`\n- `SessionContext` alias `LoadedSession` removed\n\nSee [docs/sdk.md](docs/sdk.md) and [examples/sdk/](examples/sdk/) for the current API.\n\n### RPC Migration\n\n**Session commands:**\n\n- `reset` command \u2192 `new_session` command with optional `parentSession` field\n\n**Branching commands:**\n\n- `branch` command: `entryIndex` \u2192 `entryId`\n- `get_branch_messages` response: `entryIndex` \u2192 `entryId`\n\n**Type changes:**\n\n- Messages are now `AgentMessage` (was `AppMessage`)\n- `prompt` command: `attachments` field replaced with `images` field using `ImageContent` format\n\n**Compaction events:**\n\n- `auto_compaction_start` now includes `reason` field (`\"threshold\"` or `\"overflow\"`)\n- `auto_compaction_end` now includes `willRetry` field\n- `compact` response includes full `CompactionResult` (`summary`, `firstKeptEntryId`, `tokensBefore`, `details`)\n\nSee [docs/rpc.md](docs/rpc.md) for the current protocol.\n\n### Structured Compaction\n\nCompaction and branch summarization now use a structured output format:\n\n- Clear sections: Goal, Progress, Key Information, File Operations\n- File tracking: `readFiles` and `modifiedFiles` arrays in `details`, accumulated across compactions\n- Conversations are serialized to text before summarization to prevent the model from \"continuing\" them\n\nThe `before_compact` and `before_tree` hook events allow custom compaction implementations. See [docs/compaction.md](docs/compaction.md).\n\n### Interactive Mode\n\n**`/tree` command:**\n\n- Navigate the full session tree in-place\n- Search by typing, page with \u2190/\u2192\n- Filter modes (Ctrl+O): default \u2192 no-tools \u2192 user-only \u2192 labeled-only \u2192 all\n- Press `l` to label entries as bookmarks\n- Selecting a branch switches context and optionally injects a summary of the abandoned branch\n\n**Entry labels:**\n\n- Bookmark any entry via `/tree` \u2192 select \u2192 `l`\n- Labels appear in tree view and persist as `LabelEntry`\n\n**Theme changes (breaking for custom themes):**\n\nCustom themes must add these new color tokens or they will fail to load:\n\n- `selectedBg`: background for selected/highlighted items in tree selector and other components\n- `customMessageBg`: background for hook-injected messages (`CustomMessageEntry`)\n- `customMessageText`: text color for hook messages\n- `customMessageLabel`: label color for hook messages (the `[customType]` prefix)\n\nTotal color count increased from 46 to 50. See [docs/theme.md](docs/theme.md) for the full color list and copy values from the built-in dark/light themes.\n\n**Settings:**\n\n- `enabledModels`: allowlist models in `settings.json` (same format as `--models` CLI)\n\n### Added\n\n- `ctx.ui.setStatus(key, text)` for hooks to display persistent status text in the footer ([#385](https://github.com/badlogic/pi-mono/pull/385) by [@prateekmedia](https://github.com/prateekmedia))\n- `ctx.ui.theme` getter for styling status text and other output with theme colors\n- `/share` command to upload session as a secret GitHub gist and get a shareable URL via shittycodingagent.ai ([#380](https://github.com/badlogic/pi-mono/issues/380))\n- HTML export now includes a tree visualization sidebar for navigating session branches ([#375](https://github.com/badlogic/pi-mono/issues/375))\n- HTML export supports keyboard shortcuts: Ctrl+T to toggle thinking blocks, Ctrl+O to toggle tool outputs\n- HTML export supports theme-configurable background colors via optional `export` section in theme JSON ([#387](https://github.com/badlogic/pi-mono/pull/387) by [@mitsuhiko](https://github.com/mitsuhiko))\n- HTML export syntax highlighting now uses theme colors and matches TUI rendering\n- **Snake game example hook**: Demonstrates `ui.custom()`, `registerCommand()`, and session persistence. See [examples/hooks/snake.ts](examples/hooks/snake.ts).\n- **`thinkingText` theme token**: Configurable color for thinking block text. ([#366](https://github.com/badlogic/pi-mono/pull/366) by [@paulbettner](https://github.com/paulbettner))\n\n### Changed\n\n- **Entry IDs**: Session entries now use short 8-character hex IDs instead of full UUIDs\n- **API key priority**: `ANTHROPIC_OAUTH_TOKEN` now takes precedence over `ANTHROPIC_API_KEY`\n- HTML export template split into separate files (template.html, template.css, template.js) for easier maintenance\n\n### Fixed\n\n- HTML export now properly sanitizes user messages containing HTML tags like `` that could break DOM rendering\n- Crash when displaying bash output containing Unicode format characters like U+0600-U+0604 ([#372](https://github.com/badlogic/pi-mono/pull/372) by [@HACKE-RC](https://github.com/HACKE-RC))\n- **Footer shows full session stats**: Token usage and cost now include all messages, not just those after compaction. ([#322](https://github.com/badlogic/pi-mono/issues/322))\n- **Status messages spam chat log**: Rapidly changing settings (e.g., thinking level via Shift+Tab) would add multiple status lines. Sequential status updates now coalesce into a single line. ([#365](https://github.com/badlogic/pi-mono/pull/365) by [@paulbettner](https://github.com/paulbettner))\n- **Toggling thinking blocks during streaming shows nothing**: Pressing Ctrl+T while streaming would hide the current message until streaming completed.\n- **Resuming session resets thinking level to off**: Initial model and thinking level were not saved to session file, causing `--resume`/`--continue` to default to `off`. ([#342](https://github.com/badlogic/pi-mono/issues/342) by [@aliou](https://github.com/aliou))\n- **Hook `tool_result` event ignores errors from custom tools**: The `tool_result` hook event was never emitted when tools threw errors, and always had `isError: false` for successful executions. Now emits the event with correct `isError` value in both success and error cases. ([#374](https://github.com/badlogic/pi-mono/issues/374) by [@nicobailon](https://github.com/nicobailon))\n- **Edit tool fails on Windows due to CRLF line endings**: Files with CRLF line endings now match correctly when LLMs send LF-only text. Line endings are normalized before matching and restored to original style on write. ([#355](https://github.com/badlogic/pi-mono/issues/355) by [@Pratham-Dubey](https://github.com/Pratham-Dubey))\n- **Edit tool fails on files with UTF-8 BOM**: Files with UTF-8 BOM marker could cause \"text not found\" errors since the LLM doesn't include the invisible BOM character. BOM is now stripped before matching and restored on write. ([#394](https://github.com/badlogic/pi-mono/pull/394) by [@prathamdby](https://github.com/prathamdby))\n- **Use bash instead of sh on Unix**: Fixed shell commands using `/bin/sh` instead of `/bin/bash` on Unix systems. ([#328](https://github.com/badlogic/pi-mono/pull/328) by [@dnouri](https://github.com/dnouri))\n- **OAuth login URL clickable**: Made OAuth login URLs clickable in terminal. ([#349](https://github.com/badlogic/pi-mono/pull/349) by [@Cursivez](https://github.com/Cursivez))\n- **Improved error messages**: Better error messages when `apiKey` or `model` are missing. ([#346](https://github.com/badlogic/pi-mono/pull/346) by [@ronyrus](https://github.com/ronyrus))\n- **Session file validation**: `findMostRecentSession()` now validates session headers before returning, preventing non-session JSONL files from being loaded\n- **Compaction error handling**: `generateSummary()` and `generateTurnPrefixSummary()` now throw on LLM errors instead of returning empty strings\n- **Compaction with branched sessions**: Fixed compaction incorrectly including entries from abandoned branches, causing token overflow errors. Compaction now uses `sessionManager.getPath()` to work only on the current branch path, eliminating 80+ lines of duplicate entry collection logic between `prepareCompaction()` and `compact()`\n- **enabledModels glob patterns**: `--models` and `enabledModels` now support glob patterns like `github-copilot/*` or `*sonnet*`. Previously, patterns were only matched literally or via substring search. ([#337](https://github.com/badlogic/pi-mono/issues/337))\n\n## [0.30.2] - 2025-12-26\n\n### Changed\n\n- **Consolidated migrations**: Moved auth migration from `AuthStorage.migrateLegacy()` to new `migrations.ts` module.\n\n## [0.30.1] - 2025-12-26\n\n### Fixed\n\n- **Sessions saved to wrong directory**: In v0.30.0, sessions were being saved to `~/.pi/agent/` instead of `~/.pi/agent/sessions//`, breaking `--resume` and `/resume`. Misplaced sessions are automatically migrated on startup. ([#320](https://github.com/badlogic/pi-mono/issues/320) by [@aliou](https://github.com/aliou))\n- **Custom system prompts missing context**: When using a custom system prompt string, project context files (AGENTS.md), skills, date/time, and working directory were not appended. ([#321](https://github.com/badlogic/pi-mono/issues/321))\n\n## [0.30.0] - 2025-12-25\n\n### Breaking Changes\n\n- **SessionManager API**: The second parameter of `create()`, `continueRecent()`, and `list()` changed from `agentDir` to `sessionDir`. When provided, it specifies the session directory directly (no cwd encoding). When omitted, uses default (`~/.pi/agent/sessions//`). `open()` no longer takes `agentDir`. ([#313](https://github.com/badlogic/pi-mono/pull/313))\n\n### Added\n\n- **`--session-dir` flag**: Use a custom directory for sessions instead of the default `~/.pi/agent/sessions//`. Works with `-c` (continue) and `-r` (resume) flags. ([#313](https://github.com/badlogic/pi-mono/pull/313) by [@scutifer](https://github.com/scutifer))\n- **Reverse model cycling and model selector**: Shift+Ctrl+P cycles models backward, Ctrl+L opens model selector (retaining text in editor). ([#315](https://github.com/badlogic/pi-mono/pull/315) by [@mitsuhiko](https://github.com/mitsuhiko))\n\n## [0.29.1] - 2025-12-25\n\n### Added\n\n- **Automatic custom system prompt loading**: Pi now auto-loads `SYSTEM.md` files to replace the default system prompt. Project-local `.pi/SYSTEM.md` takes precedence over global `~/.pi/agent/SYSTEM.md`. CLI `--system-prompt` flag overrides both. ([#309](https://github.com/badlogic/pi-mono/issues/309))\n- **Unified `/settings` command**: New settings menu consolidating thinking level, theme, queue mode, auto-compact, show images, hide thinking, and collapse changelog. Replaces individual `/thinking`, `/queue`, `/theme`, `/autocompact`, and `/show-images` commands. ([#310](https://github.com/badlogic/pi-mono/issues/310))\n\n### Fixed\n\n- **Custom tools/hooks with typebox subpath imports**: Fixed jiti alias for `@sinclair/typebox` to point to package root instead of entry file, allowing imports like `@sinclair/typebox/compiler` to resolve correctly. ([#311](https://github.com/badlogic/pi-mono/issues/311) by [@kim0](https://github.com/kim0))\n\n## [0.29.0] - 2025-12-25\n\n### Breaking Changes\n\n- **Renamed `/clear` to `/new`**: The command to start a fresh session is now `/new`. Hook event reasons `before_clear`/`clear` are now `before_new`/`new`. Merry Christmas [@mitsuhiko](https://github.com/mitsuhiko)! ([#305](https://github.com/badlogic/pi-mono/pull/305))\n\n### Added\n\n- **Auto-space before pasted file paths**: When pasting a file path (starting with `/`, `~`, or `.`) after a word character, a space is automatically prepended. ([#307](https://github.com/badlogic/pi-mono/pull/307) by [@mitsuhiko](https://github.com/mitsuhiko))\n- **Word navigation in input fields**: Added Ctrl+Left/Right and Alt+Left/Right for word-by-word cursor movement. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))\n- **Full Unicode input**: Input fields now accept Unicode characters beyond ASCII. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))\n\n### Fixed\n\n- **Readline-style Ctrl+W**: Now skips trailing whitespace before deleting the preceding word, matching standard readline behavior. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))\n\n## [0.28.0] - 2025-12-25\n\n### Changed\n\n- **Credential storage refactored**: API keys and OAuth tokens are now stored in `~/.pi/agent/auth.json` instead of `oauth.json` and `settings.json`. Existing credentials are automatically migrated on first run. ([#296](https://github.com/badlogic/pi-mono/issues/296))\n- **SDK API changes** ([#296](https://github.com/badlogic/pi-mono/issues/296)):\n  - Added `AuthStorage` class for credential management (API keys and OAuth tokens)\n  - Added `ModelRegistry` class for model discovery and API key resolution\n  - Added `discoverAuthStorage()` and `discoverModels()` discovery functions\n  - `createAgentSession()` now accepts `authStorage` and `modelRegistry` options\n  - Removed `configureOAuthStorage()`, `defaultGetApiKey()`, `findModel()`, `discoverAvailableModels()`\n  - Removed `getApiKey` callback option (use `AuthStorage.setRuntimeApiKey()` for runtime overrides)\n  - Use `getModel()` from `@oh-my-pi/pi-ai` for built-in models, `modelRegistry.find()` for custom models + built-in models\n  - See updated [SDK documentation](docs/sdk.md) and [README](README.md)\n- **Settings changes**: Removed `apiKeys` from `settings.json`. Use `auth.json` instead. ([#296](https://github.com/badlogic/pi-mono/issues/296))\n\n### Fixed\n\n- **Duplicate skill warnings for symlinks**: Skills loaded via symlinks pointing to the same file are now silently deduplicated instead of showing name collision warnings. ([#304](https://github.com/badlogic/pi-mono/pull/304) by [@mitsuhiko](https://github.com/mitsuhiko))\n\n## [0.27.9] - 2025-12-24\n\n### Fixed\n\n- **Model selector and --list-models with settings.json API keys**: Models with API keys configured in settings.json (but not in environment variables) now properly appear in the /model selector and `--list-models` output. ([#295](https://github.com/badlogic/pi-mono/issues/295))\n\n## [0.27.8] - 2025-12-24\n\n### Fixed\n\n- **API key priority**: OAuth tokens now take priority over settings.json API keys. Previously, an API key in settings.json would trump OAuth, causing users logged in with a plan (unlimited tokens) to be billed via PAYG instead.\n\n## [0.27.7] - 2025-12-24\n\n### Fixed\n\n- **Thinking tag leakage**: Fixed Claude mimicking literal `` tags in responses. Unsigned thinking blocks (from aborted streams) are now converted to plain text without `` tags. The TUI still displays them as thinking blocks. ([#302](https://github.com/badlogic/pi-mono/pull/302) by [@nicobailon](https://github.com/nicobailon))\n\n## [0.27.6] - 2025-12-24\n\n### Added\n\n- **Compaction hook improvements**: The `before_compact` session event now includes:\n  - `previousSummary`: Summary from the last compaction (if any), so hooks can preserve accumulated context\n  - `messagesToKeep`: Messages that will be kept after the summary (recent turns), in addition to `messagesToSummarize`\n  - `resolveApiKey`: Function to resolve API keys for any model (checks settings, OAuth, env vars)\n  - Removed `apiKey` string in favor of `resolveApiKey` for more flexibility\n- **SessionManager API cleanup**:\n  - Renamed `loadSessionFromEntries()` to `buildSessionContext()` (builds LLM context from entries, handling compaction)\n  - Renamed `loadEntries()` to `getEntries()` (returns defensive copy of all session entries)\n  - Added `buildSessionContext()` method to SessionManager\n\n## [0.27.5] - 2025-12-24\n\n### Added\n\n- **HTML export syntax highlighting**: Code blocks in markdown and tool outputs (read, write) now have syntax highlighting using highlight.js with theme-aware colors matching the TUI.\n- **HTML export improvements**: Render markdown server-side using marked (tables, headings, code blocks, etc.), honor user's chosen theme (light/dark), add image rendering for user messages, and style code blocks with TUI-like language markers. ([@scutifer](https://github.com/scutifer))\n\n### Fixed\n\n- **Ghostty inline images in tmux**: Fixed terminal detection for Ghostty when running inside tmux by checking `GHOSTTY_RESOURCES_DIR` env var. ([#299](https://github.com/badlogic/pi-mono/pull/299) by [@nicobailon](https://github.com/nicobailon))\n\n## [0.27.4] - 2025-12-24\n\n### Fixed\n\n- **Symlinked skill directories**: Skills in symlinked directories (e.g., `~/.pi/agent/skills/my-skills -> /path/to/skills`) are now correctly discovered and loaded.\n\n## [0.27.3] - 2025-12-24\n\n### Added\n\n- **API keys in settings.json**: Store API keys in `~/.pi/agent/settings.json` under the `apiKeys` field (e.g., `{ \"apiKeys\": { \"anthropic\": \"sk-...\" } }`). Settings keys take priority over environment variables. ([#295](https://github.com/badlogic/pi-mono/issues/295))\n\n### Fixed\n\n- **Allow startup without API keys**: Interactive mode no longer throws when no API keys are configured. Users can now start the agent and use `/login` to authenticate. ([#288](https://github.com/badlogic/pi-mono/issues/288))\n- **`--system-prompt` file path support**: The `--system-prompt` argument now correctly resolves file paths (like `--append-system-prompt` already did). ([#287](https://github.com/badlogic/pi-mono/pull/287) by [@scutifer](https://github.com/scutifer))\n\n## [0.27.2] - 2025-12-23\n\n### Added\n\n- **Skip conversation restore on branch**: Hooks can return `{ skipConversationRestore: true }` from `before_branch` to create the branched session file without restoring conversation messages. Useful for checkpoint hooks that restore files separately. ([#286](https://github.com/badlogic/pi-mono/pull/286) by [@nicobarray](https://github.com/nicobarray))\n\n## [0.27.1] - 2025-12-22\n\n### Fixed\n\n- **Skill discovery performance**: Skip `node_modules` directories when recursively scanning for skills. Fixes ~60ms startup delay when skill directories contain npm dependencies.\n\n### Added\n\n- **Startup timing instrumentation**: Set `PI_TIMING=1` to see startup performance breakdown (interactive mode only).\n\n## [0.27.0] - 2025-12-22\n\n### Breaking\n\n- **Session hooks API redesign**: Merged `branch` event into `session` event. `BranchEvent`, `BranchEventResult` types and `pi.on(\"branch\", ...)` removed. Use `pi.on(\"session\", ...)` with `reason: \"before_branch\" | \"branch\"` instead. `AgentSession.branch()` returns `{ cancelled }` instead of `{ skipped }`. `AgentSession.reset()` and `switchSession()` now return `boolean` (false if cancelled by hook). RPC commands `reset`, `switch_session`, and `branch` now include `cancelled` in response data. ([#278](https://github.com/badlogic/pi-mono/issues/278))\n\n### Added\n\n- **Session lifecycle hooks**: Added `before_*` variants (`before_switch`, `before_clear`, `before_branch`) that fire before actions and can be cancelled with `{ cancel: true }`. Added `shutdown` reason for graceful exit handling. ([#278](https://github.com/badlogic/pi-mono/issues/278))\n\n### Fixed\n\n- **File tab completion display**: File paths no longer get cut off early. Folders now show trailing `/` and removed redundant \"directory\"/\"file\" labels to maximize horizontal space. ([#280](https://github.com/badlogic/pi-mono/issues/280))\n- **Bash tool visual line truncation**: Fixed bash tool output in collapsed mode to use visual line counting (accounting for line wrapping) instead of logical line counting. Now consistent with bash-execution.ts behavior. Extracted shared `truncateToVisualLines` utility. ([#275](https://github.com/badlogic/pi-mono/issues/275))\n\n## [0.26.1] - 2025-12-22\n\n### Fixed\n\n- **SDK tools respect cwd**: Core tools (bash, read, edit, write, grep, find, ls) now properly use the `cwd` option from `createAgentSession()`. Added tool factory functions (`createBashTool`, `createReadTool`, etc.) for SDK users who specify custom `cwd` with explicit tools. ([#279](https://github.com/badlogic/pi-mono/issues/279))\n\n## [0.26.0] - 2025-12-22\n\n### Added\n\n- **SDK for programmatic usage**: New `createAgentSession()` factory with full control over model, tools, hooks, skills, session persistence, and settings. Philosophy: \"omit to discover, provide to override\". Includes 12 examples and comprehensive documentation. ([#272](https://github.com/badlogic/pi-mono/issues/272))\n- **Project-specific settings**: Settings now load from both `~/.pi/agent/settings.json` (global) and `/.pi/settings.json` (project). Project settings override global with deep merge for nested objects. Project settings are read-only (for version control). ([#276](https://github.com/badlogic/pi-mono/pull/276))\n- **SettingsManager static factories**: `SettingsManager.create(cwd?, agentDir?)` for file-based settings, `SettingsManager.inMemory(settings?)` for testing. Added `applyOverrides()` for programmatic overrides.\n- **SessionManager static factories**: `SessionManager.create()`, `SessionManager.open()`, `SessionManager.continueRecent()`, `SessionManager.inMemory()`, `SessionManager.list()` for flexible session management.\n\n## [0.25.4] - 2025-12-22\n\n### Fixed\n\n- **Syntax highlighting stderr spam**: Fixed cli-highlight logging errors to stderr when markdown contains malformed code fences (e.g., missing newlines around closing backticks). Now validates language identifiers before highlighting and falls back silently to plain text. ([#274](https://github.com/badlogic/pi-mono/issues/274))\n\n## [0.25.3] - 2025-12-21\n\n### Added\n\n- **Gemini 3 preview models**: Added `gemini-3-pro-preview` and `gemini-3-flash-preview` to the google-gemini-cli provider. ([#264](https://github.com/badlogic/pi-mono/pull/264) by [@LukeFost](https://github.com/LukeFost))\n- **External editor support**: Press `Ctrl+G` to edit your message in an external editor. Uses `$VISUAL` or `$EDITOR` environment variable. On successful save, the message is replaced; on cancel, the original is kept. ([#266](https://github.com/badlogic/pi-mono/pull/266) by [@aliou](https://github.com/aliou))\n- **Process suspension**: Press `Ctrl+Z` to suspend pi and return to the shell. Resume with `fg` as usual. ([#267](https://github.com/badlogic/pi-mono/pull/267) by [@aliou](https://github.com/aliou))\n- **Configurable skills directories**: Added granular control over skill sources with `enableCodexUser`, `enableClaudeUser`, `enableClaudeProject`, `enablePiUser`, `enablePiProject` toggles, plus `customDirectories` and `ignoredSkills` settings. ([#269](https://github.com/badlogic/pi-mono/pull/269) by [@nicobailon](https://github.com/nicobailon))\n- **Skills CLI filtering**: Added `--skills ` flag for filtering skills with glob patterns. Also added `includeSkills` setting and glob pattern support for `ignoredSkills`. ([#268](https://github.com/badlogic/pi-mono/issues/268))\n\n## [0.25.2] - 2025-12-21\n\n### Fixed\n\n- **Image shifting in tool output**: Fixed an issue where images in tool output would shift down (due to accumulating spacers) each time the tool output was expanded or collapsed via Ctrl+O.\n\n## [0.25.1] - 2025-12-21\n\n### Fixed\n\n- **Gemini image reading broken**: Fixed the `read` tool returning images causing flaky/broken responses with Gemini models. Images in tool results are now properly formatted per the Gemini API spec.\n- **Tab completion for absolute paths**: Fixed tab completion producing `//tmp` instead of `/tmp/`. Also fixed symlinks to directories (like `/tmp`) not getting a trailing slash, which prevented continuing to tab through subdirectories.\n\n## [0.25.0] - 2025-12-20\n\n### Added\n\n- **Interruptible tool execution**: Queuing a message while tools are executing now interrupts the current tool batch. Remaining tools are skipped with an error result, and your queued message is processed immediately. Useful for redirecting the agent mid-task. ([#259](https://github.com/badlogic/pi-mono/pull/259) by [@steipete](https://github.com/steipete))\n- **Google Gemini CLI OAuth provider**: Access Gemini 2.0/2.5 models for free via Google Cloud Code Assist. Login with `/login` and select \"Google Gemini CLI\". Uses your Google account with rate limits.\n- **Google Antigravity OAuth provider**: Access Gemini 3, Claude (sonnet/opus thinking models), and GPT-OSS models for free via Google's Antigravity sandbox. Login with `/login` and select \"Antigravity\". Uses your Google account with rate limits.\n\n### Changed\n\n- **Model selector respects --models scope**: The `/model` command now only shows models specified via `--models` flag when that flag is used, instead of showing all available models. This prevents accidentally selecting models from unintended providers. ([#255](https://github.com/badlogic/pi-mono/issues/255))\n\n### Fixed\n\n- **Connection errors not retried**: Added \"connection error\" to the list of retryable errors so Anthropic connection drops trigger auto-retry instead of silently failing. ([#252](https://github.com/badlogic/pi-mono/issues/252))\n- **Thinking level not clamped on model switch**: Fixed TUI showing xhigh thinking level after switching to a model that doesn't support it. Thinking level is now automatically clamped to model capabilities. ([#253](https://github.com/badlogic/pi-mono/issues/253))\n- **Cross-model thinking handoff**: Fixed error when switching between models with different thinking signature formats (e.g., GPT-OSS to Claude thinking models via Antigravity). Thinking blocks without signatures are now converted to text with `` delimiters.\n\n## [0.24.5] - 2025-12-20\n\n### Fixed\n\n- **Input buffering in iTerm2**: Fixed Ctrl+C, Ctrl+D, and other keys requiring multiple presses in iTerm2. The cell size query response parser was incorrectly holding back keyboard input.\n\n## [0.24.4] - 2025-12-20\n\n### Fixed\n\n- **Arrow keys and Enter in selector components**: Fixed arrow keys and Enter not working in model selector, session selector, OAuth selector, and other selector components when Caps Lock or Num Lock is enabled. ([#243](https://github.com/badlogic/pi-mono/issues/243))\n\n## [0.24.3] - 2025-12-19\n\n### Fixed\n\n- **Footer overflow on narrow terminals**: Fixed footer path display exceeding terminal width when resizing to very narrow widths, causing rendering crashes. /arminsayshi\n\n## [0.24.2] - 2025-12-20\n\n### Fixed\n\n- **More Kitty keyboard protocol fixes**: Fixed Backspace, Enter, Home, End, and Delete keys not working with Caps Lock enabled. The initial fix in 0.24.1 missed several key handlers that were still using raw byte detection. Now all key handlers use the helper functions that properly mask out lock key bits. ([#243](https://github.com/badlogic/pi-mono/issues/243))\n\n## [0.24.1] - 2025-12-19\n\n### Added\n\n- **OAuth and model config exports**: Scripts using `AgentSession` directly can now import `getAvailableModels`, `getApiKeyForModel`, `findModel`, `login`, `logout`, and `getOAuthProviders` from `@oh-my-pi/pi-coding-agent` to reuse OAuth token storage and model resolution. ([#245](https://github.com/badlogic/pi-mono/issues/245))\n- **xhigh thinking level for gpt-5.2 models**: The thinking level selector and shift+tab cycling now show xhigh option for gpt-5.2 and gpt-5.2-codex models (in addition to gpt-5.1-codex-max). ([#236](https://github.com/badlogic/pi-mono/pull/236) by [@theBucky](https://github.com/theBucky))\n\n### Fixed\n\n- **Hooks wrap custom tools**: Custom tools are now executed through the hook wrapper, so `tool_call`/`tool_result` hooks can observe, block, and modify custom tool executions (consistent with hook type docs). ([#248](https://github.com/badlogic/pi-mono/pull/248) by [@nicobailon](https://github.com/nicobailon))\n- **Hook onUpdate callback forwarding**: The `onUpdate` callback is now correctly forwarded through the hook wrapper, fixing custom tool progress updates. ([#238](https://github.com/badlogic/pi-mono/pull/238) by [@nicobailon](https://github.com/nicobailon))\n- **Terminal cleanup on Ctrl+C in session selector**: Fixed terminal not being properly restored when pressing Ctrl+C in the session selector. ([#247](https://github.com/badlogic/pi-mono/pull/247) by [@aliou](https://github.com/aliou))\n- **OpenRouter models with colons in IDs**: Fixed parsing of OpenRouter model IDs that contain colons (e.g., `openrouter:meta-llama/llama-4-scout:free`). ([#242](https://github.com/badlogic/pi-mono/pull/242) by [@aliou](https://github.com/aliou))\n- **Global AGENTS.md loaded twice**: Fixed global AGENTS.md being loaded twice when present in both `~/.pi/agent/` and the current directory. ([#239](https://github.com/badlogic/pi-mono/pull/239) by [@aliou](https://github.com/aliou))\n- **Kitty keyboard protocol on Linux**: Fixed keyboard input not working in Ghostty on Linux when Num Lock is enabled. The Kitty protocol includes Caps Lock and Num Lock state in modifier values, which broke key detection. Now correctly masks out lock key bits when matching keyboard shortcuts. ([#243](https://github.com/badlogic/pi-mono/issues/243))\n- **Emoji deletion and cursor movement**: Backspace, Delete, and arrow keys now correctly handle multi-codepoint characters like emojis. Previously, deleting an emoji would leave partial bytes, corrupting the editor state. ([#240](https://github.com/badlogic/pi-mono/issues/240))\n\n## [0.24.0] - 2025-12-19\n\n### Added\n\n- **Subagent orchestration example**: Added comprehensive custom tool example for spawning and orchestrating sub-agents with isolated context windows. Includes scout/planner/reviewer/worker agents and workflow commands for multi-agent pipelines. ([#215](https://github.com/badlogic/pi-mono/pull/215) by [@nicobailon](https://github.com/nicobailon))\n- **`getMarkdownTheme()` export**: Custom tools can now import `getMarkdownTheme()` from `@oh-my-pi/pi-coding-agent` to use the same markdown styling as the main UI.\n- **`pi.exec()` signal and timeout support**: Custom tools and hooks can now pass `{ signal, timeout }` options to `pi.exec()` for cancellation and timeout handling. The result includes a `killed` flag when the process was terminated.\n- **Kitty keyboard protocol support**: Shift+Enter, Alt+Enter, Shift+Tab, Ctrl+D, and all Ctrl+key combinations now work in Ghostty, Kitty, WezTerm, and other modern terminals. ([#225](https://github.com/badlogic/pi-mono/pull/225) by [@kim0](https://github.com/kim0))\n- **Dynamic API key refresh**: OAuth tokens (GitHub Copilot, Anthropic OAuth) are now refreshed before each LLM call, preventing failures in long-running agent loops where tokens expire mid-session. ([#223](https://github.com/badlogic/pi-mono/pull/223) by [@kim0](https://github.com/kim0))\n- **`/hotkeys` command**: Shows all keyboard shortcuts in a formatted table.\n- **Markdown table borders**: Tables now render with proper top and bottom borders.\n\n### Changed\n\n- **Subagent example improvements**: Parallel mode now streams updates from all tasks. Chain mode shows all completed steps during streaming. Expanded view uses proper markdown rendering with syntax highlighting. Usage footer shows turn count.\n- **Skills standard compliance**: Skills now adhere to the [Agent Skills standard](https://agentskills.io/specification). Validates name (must match parent directory, lowercase, max 64 chars), description (required, max 1024 chars), and frontmatter fields. Warns on violations but remains lenient. Prompt format changed to XML structure. Removed `{baseDir}` placeholder in favor of relative paths. ([#231](https://github.com/badlogic/pi-mono/issues/231))\n\n### Fixed\n\n- **JSON mode stdout flush**: Fixed race condition where `pi --mode json` could exit before all output was written to stdout, causing consumers to miss final events.\n- **Symlinked tools, hooks, and slash commands**: Discovery now correctly follows symlinks when scanning for custom tools, hooks, and slash commands. ([#219](https://github.com/badlogic/pi-mono/pull/219), [#232](https://github.com/badlogic/pi-mono/pull/232) by [@aliou](https://github.com/aliou))\n\n### Breaking Changes\n\n- **Custom tools now require `index.ts` entry point**: Auto-discovered custom tools must be in a subdirectory with an `index.ts` file. The old pattern `~/.pi/agent/tools/mytool.ts` must become `~/.pi/agent/tools/mytool/index.ts`. This allows multi-file tools to import helper modules. Explicit paths via `--tool` or `settings.json` still work with any `.ts` file.\n- **Hook `tool_result` event restructured**: The `ToolResultEvent` now exposes full tool result data instead of just text. ([#233](https://github.com/badlogic/pi-mono/pull/233))\n  - Removed: `result: string` field\n  - Added: `content: (TextContent | ImageContent)[]` - full content array\n  - Added: `details: unknown` - tool-specific details (typed per tool via discriminated union on `toolName`)\n  - `ToolResultEventResult.result` renamed to `ToolResultEventResult.text` (removed), use `content` instead\n  - Hook handlers returning `{ result: \"...\" }` must change to `{ content: [{ type: \"text\", text: \"...\" }] }`\n  - Built-in tool details types exported: `BashToolDetails`, `ReadToolDetails`, `GrepToolDetails`, `FindToolDetails`, `LsToolDetails`, `TruncationResult`\n  - Type guards exported for narrowing: `isBashToolResult`, `isReadToolResult`, `isEditToolResult`, `isWriteToolResult`, `isGrepToolResult`, `isFindToolResult`, `isLsToolResult`\n\n## [0.23.4] - 2025-12-18\n\n### Added\n\n- **Syntax highlighting**: Added syntax highlighting for markdown code blocks, read tool output, and write tool content. Uses cli-highlight with theme-aware color mapping and VS Code-style syntax colors. ([#214](https://github.com/badlogic/pi-mono/pull/214) by [@svkozak](https://github.com/svkozak))\n- **Intra-line diff highlighting**: Edit tool now shows word-level changes with inverse highlighting when a single line is modified. Multi-line changes show all removed lines first, then all added lines.\n\n### Fixed\n\n- **Gemini tool result format**: Fixed tool result format for Gemini 3 Flash Preview which strictly requires `{ output: value }` for success and `{ error: value }` for errors. Previous format using `{ result, isError }` was rejected by newer Gemini models. ([#213](https://github.com/badlogic/pi-mono/issues/213), [#220](https://github.com/badlogic/pi-mono/pull/220))\n- **Google baseUrl configuration**: Google provider now respects `baseUrl` configuration for custom endpoints or API proxies. ([#216](https://github.com/badlogic/pi-mono/issues/216), [#221](https://github.com/badlogic/pi-mono/pull/221) by [@theBucky](https://github.com/theBucky))\n- **Google provider FinishReason**: Added handling for new `IMAGE_RECITATION` and `IMAGE_OTHER` finish reasons. Upgraded @google/genai to 1.34.0.\n\n## [0.23.3] - 2025-12-17\n\n### Fixed\n\n- Check for compaction before submitting user prompt, not just after agent turn ends. This catches cases where user aborts mid-response and context is already near the limit.\n\n### Changed\n\n- Improved system prompt documentation section with clearer pointers to specific doc files for custom models, themes, skills, hooks, custom tools, and RPC.\n- Cleaned up documentation:\n  - `theme.md`: Added missing color tokens (`thinkingXhigh`, `bashMode`)\n  - `skills.md`: Rewrote with better framing and examples\n  - `hooks.md`: Fixed timeout/error handling docs, added import aliases section\n  - `custom-tools.md`: Added intro with use cases and comparison table\n  - `rpc.md`: Added missing `hook_error` event documentation\n  - `README.md`: Complete settings table, condensed philosophy section, standardized OAuth docs\n- Hooks loader now supports same import aliases as custom tools (`@sinclair/typebox`, `@oh-my-pi/pi-ai`, `@oh-my-pi/pi-tui`, `@oh-my-pi/pi-coding-agent`).\n\n### Breaking Changes\n\n- **Hooks**: `turn_end` event's `toolResults` type changed from `AppMessage[]` to `ToolResultMessage[]`. If you have hooks that handle `turn_end` events and explicitly type the results, update your type annotations.\n\n## [0.23.2] - 2025-12-17\n\n### Fixed\n\n- Fixed Claude models via GitHub Copilot re-answering all previous prompts in multi-turn conversations. The issue was that assistant message content was sent as an array instead of a string, which Copilot's Claude adapter misinterpreted. Also added missing `Openai-Intent: conversation-edits` header and fixed `X-Initiator` logic to check for any assistant/tool message in history. ([#209](https://github.com/badlogic/pi-mono/issues/209))\n- Detect image MIME type via file magic (read tool and `@file` attachments), not filename extension.\n- Fixed markdown tables overflowing terminal width. Tables now wrap cell contents to fit available width instead of breaking borders mid-row. ([#206](https://github.com/badlogic/pi-mono/pull/206) by [@kim0](https://github.com/kim0))\n\n## [0.23.1] - 2025-12-17\n\n### Fixed\n\n- Fixed TUI performance regression caused by Box component lacking render caching. Built-in tools now use Text directly (like v0.22.5), and Box has proper caching for custom tool rendering.\n- Fixed custom tools failing to load from `~/.pi/agent/tools/` when pi is installed globally. Module imports (`@sinclair/typebox`, `@oh-my-pi/pi-tui`, `@oh-my-pi/pi-ai`) are now resolved via aliases.\n\n## [0.23.0] - 2025-12-17\n\n### Added\n\n- **Custom tools**: Extend pi with custom tools written in TypeScript. Tools can provide custom TUI rendering, interact with users via `pi.ui` (select, confirm, input, notify), and maintain state across sessions via `onSession` callback. See [docs/custom-tools.md](docs/custom-tools.md) and [examples/custom-tools/](examples/custom-tools/). ([#190](https://github.com/badlogic/pi-mono/issues/190))\n- **Hook and tool examples**: Added `examples/hooks/` and `examples/custom-tools/` with working examples. Examples are now bundled in npm and binary releases.\n\n### Breaking Changes\n\n- **Hooks**: Replaced `session_start` and `session_switch` events with unified `session` event. Use `event.reason` (`\"start\" | \"switch\" | \"clear\"`) to distinguish. Event now includes `entries` array for state reconstruction.\n\n## [0.22.5] - 2025-12-17\n\n### Fixed\n\n- Fixed `--session` flag not saving sessions in print mode (`-p`). The session manager was never receiving events because no subscriber was attached.\n\n## [0.22.4] - 2025-12-17\n\n### Added\n\n- `--list-models [search]` CLI flag to list available models with optional fuzzy search. Shows provider, model ID, context window, max output, thinking support, and image support. Only lists models with configured API keys. ([#203](https://github.com/badlogic/pi-mono/issues/203))\n\n### Fixed\n\n- Fixed tool execution showing green (success) background while still running. Now correctly shows gray (pending) background until the tool completes.\n\n## [0.22.3] - 2025-12-16\n\n### Added\n\n- **Streaming bash output**: Bash tool now streams output in real-time during execution. The TUI displays live progress with the last 5 lines visible (expandable with ctrl+o). ([#44](https://github.com/badlogic/pi-mono/issues/44))\n\n### Changed\n\n- **Tool output display**: When collapsed, tool output now shows the last N lines instead of the first N lines, making streaming output more useful.\n- Updated `@oh-my-pi/pi-ai` with X-Initiator header support for GitHub Copilot, ensuring agent calls are not deducted from quota. ([#200](https://github.com/badlogic/pi-mono/pull/200) by [@kim0](https://github.com/kim0))\n\n### Fixed\n\n- Fixed editor text being cleared during compaction. Text typed while compaction is running is now preserved. ([#179](https://github.com/badlogic/pi-mono/issues/179))\n- Improved RGB to 256-color mapping for terminals without truecolor support. Now correctly uses grayscale ramp for neutral colors and preserves semantic tints (green for success, red for error, blue for pending) instead of mapping everything to wrong cube colors.\n- `/think off` now actually disables thinking for all providers. Previously, providers like Gemini with \"dynamic thinking\" enabled by default would still use thinking even when turned off. ([#180](https://github.com/badlogic/pi-mono/pull/180) by [@markusylisiurunen](https://github.com/markusylisiurunen))\n\n## [0.22.2] - 2025-12-15\n\n### Changed\n\n- Updated `@oh-my-pi/pi-ai` with interleaved thinking enabled by default for Anthropic Claude 4 models.\n\n## [0.22.1] - 2025-12-15\n\n_Dedicated to Peter's shoulder ([@steipete](https://twitter.com/steipete))_\n\n### Changed\n\n- Updated `@oh-my-pi/pi-ai` with interleaved thinking support for Anthropic models.\n\n## [0.22.0] - 2025-12-15\n\n### Added\n\n- **GitHub Copilot support**: Use GitHub Copilot models via OAuth login (`/login` -> \"GitHub Copilot\"). Supports both github.com and GitHub Enterprise. Models are sourced from models.dev and include Claude, GPT, Gemini, Grok, and more. All models are automatically enabled after login. ([#191](https://github.com/badlogic/pi-mono/pull/191) by [@cau1k](https://github.com/cau1k))\n\n### Fixed\n\n- Model selector fuzzy search now matches against provider name (not just model ID) and supports space-separated tokens where all tokens must match\n\n## [0.21.0] - 2025-12-14\n\n### Added\n\n- **Inline image rendering**: Terminals supporting Kitty graphics protocol (Kitty, Ghostty, WezTerm) or iTerm2 inline images now render images inline in tool output. Aspect ratio is preserved by querying terminal cell dimensions on startup. Toggle with `/show-images` command or `terminal.showImages` setting. Falls back to text placeholder on unsupported terminals or when disabled. ([#177](https://github.com/badlogic/pi-mono/pull/177) by [@nicobailon](https://github.com/nicobailon))\n- **Gemini 3 Pro thinking levels**: Thinking level selector now works with Gemini 3 Pro models. Minimal/low map to Google's LOW, medium/high map to Google's HIGH. ([#176](https://github.com/badlogic/pi-mono/pull/176) by [@markusylisiurunen](https://github.com/markusylisiurunen))\n\n### Fixed\n\n- Fixed read tool failing on macOS screenshot filenames due to Unicode Narrow No-Break Space (U+202F) in timestamp. Added fallback to try macOS variant paths and consolidated duplicate expandPath functions into shared path-utils.ts. ([#181](https://github.com/badlogic/pi-mono/pull/181) by [@nicobailon](https://github.com/nicobailon))\n- Fixed double blank lines rendering after markdown code blocks ([#173](https://github.com/badlogic/pi-mono/pull/173) by [@markusylisiurunen](https://github.com/markusylisiurunen))\n\n## [0.20.1] - 2025-12-13\n\n### Added\n\n- **Exported skills API**: `loadSkillsFromDir`, `formatSkillsForPrompt`, and related types are now exported for use by other packages (e.g., mom).\n\n## [0.20.0] - 2025-12-13\n\n### Breaking Changes\n\n- **Pi skills now use `SKILL.md` convention**: Pi skills must now be named `SKILL.md` inside a directory, matching Codex CLI format. Previously any `*.md` file was treated as a skill. Migrate by renaming `~/.pi/agent/skills/foo.md` to `~/.pi/agent/skills/foo/SKILL.md`.\n\n### Added\n\n- Display loaded skills on startup in interactive mode\n\n## [0.19.1] - 2025-12-12\n\n### Fixed\n\n- Documentation: Added skills system documentation to README (setup, usage, CLI flags, settings)\n\n## [0.19.0] - 2025-12-12\n\n### Added\n\n- **Skills system**: Auto-discover and load instruction files on-demand. Supports Claude Code (`~/.claude/skills/*/SKILL.md`), Codex CLI (`~/.codex/skills/`), and Pi-native formats (`~/.pi/agent/skills/`, `.pi/skills/`). Skills are listed in system prompt with descriptions, agent loads them via read tool when needed. Supports `{baseDir}` placeholder. Disable with `--no-skills` or `skills.enabled: false` in settings. ([#169](https://github.com/badlogic/pi-mono/issues/169))\n- **Version flag**: Added `--version` / `-v` flag to display the current version and exit. ([#170](https://github.com/badlogic/pi-mono/pull/170))\n\n## [0.18.2] - 2025-12-11\n\n### Added\n\n- **Auto-retry on transient errors**: Automatically retries requests when providers return overloaded, rate limit, or server errors (429, 500, 502, 503, 504). Uses exponential backoff (2s, 4s, 8s). Shows retry status in TUI with option to cancel via Escape. Configurable in `settings.json` via `retry.enabled`, `retry.maxRetries`, `retry.baseDelayMs`. RPC mode emits `auto_retry_start` and `auto_retry_end` events. ([#157](https://github.com/badlogic/pi-mono/issues/157))\n- **HTML export line numbers**: Read tool calls in HTML exports now display line number ranges (e.g., `file.txt:10-20`) when offset/limit parameters are used, matching the TUI display format. Line numbers appear in yellow color for better visibility. ([#166](https://github.com/badlogic/pi-mono/issues/166))\n\n### Fixed\n\n- **Branch selector now works with single message**: Previously the branch selector would not open when there was only one user message. Now it correctly allows branching from any message, including the first one. This is needed for checkpoint hooks to restore state from before the first message. ([#163](https://github.com/badlogic/pi-mono/issues/163))\n- **In-memory branching for `--no-session` mode**: Branching now works correctly in `--no-session` mode without creating any session files. The conversation is truncated in memory.\n- **Git branch indicator now works in subdirectories**: The footer's git branch detection now walks up the directory hierarchy to find the git root, so it works when running pi from a subdirectory of a repository. ([#156](https://github.com/badlogic/pi-mono/issues/156))\n\n## [0.18.1] - 2025-12-10\n\n### Added\n\n- **Mistral provider**: Added support for Mistral AI models. Set `MISTRAL_API_KEY` environment variable to use.\n\n### Fixed\n\n- Fixed print mode (`-p`) not exiting after output when custom themes are present (theme watcher now properly stops in print mode) ([#161](https://github.com/badlogic/pi-mono/issues/161))\n\n## [0.18.0] - 2025-12-10\n\n### Added\n\n- **Hooks system**: TypeScript modules that extend agent behavior by subscribing to lifecycle events. Hooks can intercept tool calls, prompt for confirmation, modify results, and inject messages from external sources. Auto-discovered from `~/.pi/agent/hooks/*.ts` and `.pi/hooks/*.ts`. Thanks to [@nicobailon](https://github.com/nicobailon) for the collaboration on the design and implementation. ([#145](https://github.com/badlogic/pi-mono/issues/145), supersedes [#158](https://github.com/badlogic/pi-mono/pull/158))\n- **`pi.send()` API**: Hooks can inject messages into the agent session from external sources (file watchers, webhooks, CI systems). If streaming, messages are queued; otherwise a new agent loop starts immediately.\n- **`--hook ` CLI flag**: Load hook files directly for testing without modifying settings.\n- **Hook events**: `session_start`, `session_switch`, `agent_start`, `agent_end`, `turn_start`, `turn_end`, `tool_call` (can block), `tool_result` (can modify), `branch`.\n- **Hook UI primitives**: `ctx.ui.select()`, `ctx.ui.confirm()`, `ctx.ui.input()`, `ctx.ui.notify()` for interactive prompts from hooks.\n- **Hooks documentation**: Full API reference at `docs/hooks.md`, shipped with npm package.\n\n## [0.17.0] - 2025-12-09\n\n### Changed\n\n- **Simplified compaction flow**: Removed proactive compaction (aborting mid-turn when threshold approached). Compaction now triggers in two cases only: (1) overflow error from LLM, which compacts and auto-retries, or (2) threshold crossed after a successful turn, which compacts without retry.\n- **Compaction retry uses `Agent.continue()`**: Auto-retry after overflow now uses the new `continue()` API instead of re-sending the user message, preserving exact context state.\n- **Merged turn prefix summary**: When a turn is split during compaction, the turn prefix summary is now merged into the main history summary instead of being stored separately.\n\n### Added\n\n- **`isCompacting` property on AgentSession**: Check if auto-compaction is currently running.\n- **Session compaction indicator**: When resuming a compacted session, displays \"Session compacted N times\" status message.\n\n### Fixed\n\n- **Block input during compaction**: User input is now blocked while auto-compaction is running to prevent race conditions.\n- **Skip error messages in usage calculation**: Context size estimation now skips both aborted and error messages, as neither have valid usage data.\n\n## [0.16.0] - 2025-12-09\n\n### Breaking Changes\n\n- **New RPC protocol**: The RPC mode (`--mode rpc`) has been completely redesigned with a new JSON protocol. The old protocol is no longer supported. See [`docs/rpc.md`](docs/rpc.md) for the new protocol documentation and [`test/rpc-example.ts`](test/rpc-example.ts) for a working example. Includes `RpcClient` TypeScript class for easy integration. ([#91](https://github.com/badlogic/pi-mono/issues/91))\n\n### Changed\n\n- **README restructured**: Reorganized documentation from 30+ flat sections into 10 logical groups. Converted verbose subsections to scannable tables. Consolidated philosophy sections. Reduced size by ~60% while preserving all information.\n\n## [0.15.0] - 2025-12-09\n\n### Changed\n\n- **Major code refactoring**: Restructured codebase for better maintainability and separation of concerns. Moved files into organized directories (`core/`, `modes/`, `utils/`, `cli/`). Extracted `AgentSession` class as central session management abstraction. Split `main.ts` and `tui-renderer.ts` into focused modules. See `DEVELOPMENT.md` for the new code map. ([#153](https://github.com/badlogic/pi-mono/issues/153))\n\n## [0.14.2] - 2025-12-08\n\n### Added\n\n- `/debug` command now includes agent messages as JSONL in the output\n\n### Fixed\n\n- Fix crash when bash command outputs binary data (e.g., `curl` downloading a video file)\n\n## [0.14.1] - 2025-12-08\n\n### Fixed\n\n- Fix build errors with tsgo 7.0.0-dev.20251208.1 by properly importing `ReasoningEffort` type\n\n## [0.14.0] - 2025-12-08\n\n### Breaking Changes\n\n- **Custom themes require new color tokens**: Themes must now include `thinkingXhigh` and `bashMode` color tokens. The theme loader provides helpful error messages listing missing tokens. See built-in themes (dark.json, light.json) for reference values.\n\n### Added\n\n- **OpenAI compatibility overrides in models.json**: Custom models using `openai-completions` API can now specify a `compat` object to override provider quirks (`supportsStore`, `supportsDeveloperRole`, `supportsReasoningEffort`, `maxTokensField`). Useful for LiteLLM, custom proxies, and other non-standard endpoints. ([#133](https://github.com/badlogic/pi-mono/issues/133), thanks @fink-andreas for the initial idea and PR)\n- **xhigh thinking level**: Added `xhigh` thinking level for OpenAI codex-max models. Cycle through thinking levels with Shift+Tab; `xhigh` appears only when using a codex-max model. ([#143](https://github.com/badlogic/pi-mono/issues/143))\n- **Collapse changelog setting**: Add `\"collapseChangelog\": true` to `~/.pi/agent/settings.json` to show a condensed \"Updated to vX.Y.Z\" message instead of the full changelog after updates. Use `/changelog` to view the full changelog. ([#148](https://github.com/badlogic/pi-mono/issues/148))\n- **Bash mode**: Execute shell commands directly from the editor by prefixing with `!` (e.g., `!ls -la`). Output streams in real-time, is added to the LLM context, and persists in session history. Supports multiline commands, cancellation (Escape), truncation for large outputs, and preview/expand toggle (Ctrl+O). Also available in RPC mode via `{\"type\":\"bash\",\"command\":\"...\"}`. ([#112](https://github.com/badlogic/pi-mono/pull/112), original implementation by [@markusylisiurunen](https://github.com/markusylisiurunen))\n\n## [0.13.2] - 2025-12-07\n\n### Changed\n\n- **Tool output truncation**: All tools now enforce consistent truncation limits with actionable notices for the LLM. ([#134](https://github.com/badlogic/pi-mono/issues/134))\n  - **Limits**: 2000 lines OR 50KB (whichever hits first), never partial lines\n  - **read**: Shows `[Showing lines X-Y of Z. Use offset=N to continue]`. If first line exceeds 50KB, suggests bash command\n  - **bash**: Tail truncation with temp file. Shows `[Showing lines X-Y of Z. Full output: /tmp/...]`\n  - **grep**: Pre-truncates match lines to 500 chars. Shows match limit and line truncation notices\n  - **find/ls**: Shows result/entry limit notices\n  - TUI displays truncation warnings in yellow at bottom of tool output (visible even when collapsed)\n\n## [0.13.1] - 2025-12-06\n\n### Added\n\n- **Flexible Windows shell configuration**: The bash tool now supports multiple shell sources beyond Git Bash. Resolution order: (1) custom `shellPath` in settings.json, (2) Git Bash in standard locations, (3) any bash.exe on PATH. This enables Cygwin, MSYS2, and other bash environments. Configure with `~/.pi/agent/settings.json`: `{\"shellPath\": \"C:\\\\cygwin64\\\\bin\\\\bash.exe\"}`.\n\n### Fixed\n\n- **Windows binary detection**: Fixed Bun compiled binary detection on Windows by checking for URL-encoded `%7EBUN` in addition to `$bunfs` and `~BUN` in `import.meta.url`. This ensures the binary correctly locates supporting files (package.json, themes, etc.) next to the executable.\n\n## [0.12.15] - 2025-12-06\n\n### Fixed\n\n- **Editor crash with emojis/CJK characters**: Fixed crash when pasting or typing text containing wide characters (emojis like \u2705, CJK characters) that caused line width to exceed terminal width. The editor now uses grapheme-aware text wrapping with proper visible width calculation.\n\n## [0.12.14] - 2025-12-06\n\n### Added\n\n- **Double-Escape Branch Shortcut**: Press Escape twice with an empty editor to quickly open the `/branch` selector for conversation branching.\n\n## [0.12.13] - 2025-12-05\n\n### Changed\n\n- **Faster startup**: Version check now runs in parallel with TUI initialization instead of blocking startup for up to 1 second. Update notifications appear in chat when the check completes.\n\n## [0.12.12] - 2025-12-05\n\n### Changed\n\n- **Footer display**: Token counts now use M suffix for millions (e.g., `10.2M` instead of `10184k`). Context display shortened from `61.3% of 200k` to `61.3%/200k`.\n\n### Fixed\n\n- **Multi-key sequences in inputs**: Inputs like model search now handle multi-key sequences identically to the main prompt editor. ([#122](https://github.com/badlogic/pi-mono/pull/122) by [@markusylisiurunen](https://github.com/markusylisiurunen))\n- **Line wrapping escape codes**: Fixed underline style bleeding into padding when wrapping long URLs. ANSI codes now attach to the correct content, and line-end resets only turn off underline (preserving background colors). ([#109](https://github.com/badlogic/pi-mono/issues/109))\n\n### Added\n\n- **Fuzzy search models and sessions**: Implemented a simple fuzzy search for models and sessions (e.g., `codexmax` now finds `gpt-5.1-codex-max`). ([#122](https://github.com/badlogic/pi-mono/pull/122) by [@markusylisiurunen](https://github.com/markusylisiurunen))\n- **Prompt History Navigation**: Browse previously submitted prompts using Up/Down arrow keys when the editor is empty. Press Up to cycle through older prompts, Down to return to newer ones or clear the editor. Similar to shell history and Claude Code's prompt history feature. History is session-scoped and stores up to 100 entries. ([#121](https://github.com/badlogic/pi-mono/pull/121) by [@nicobailon](https://github.com/nicobailon))\n- **`/resume` Command**: Switch to a different session mid-conversation. Opens an interactive selector showing all available sessions. Equivalent to the `--resume` CLI flag but can be used without restarting the agent. ([#117](https://github.com/badlogic/pi-mono/pull/117) by [@hewliyang](https://github.com/hewliyang))\n\n## [0.12.11] - 2025-12-05\n\n### Changed\n\n- **Compaction UI**: Simplified collapsed compaction indicator to show warning-colored text with token count instead of styled banner. Removed redundant success message after compaction. ([#108](https://github.com/badlogic/pi-mono/issues/108))\n\n### Fixed\n\n- **Print mode error handling**: `-p` flag now outputs error messages and exits with code 1 when requests fail, instead of silently producing no output.\n- **Branch selector crash**: Fixed TUI crash when user messages contained Unicode characters (like `\u2714` or `\u203a`) that caused line width to exceed terminal width. Now uses proper `truncateToWidth` instead of `substring`.\n- **Bash output escape sequences**: Fixed incomplete stripping of terminal escape sequences in bash tool output. `stripAnsi` misses some sequences like standalone String Terminator (`ESC \\`), which could cause rendering issues when displaying captured TUI output.\n- **Footer overflow crash**: Fixed TUI crash when terminal width is too narrow for the footer stats line. The footer now truncates gracefully instead of overflowing.\n\n### Added\n\n- **`authHeader` option in models.json**: Custom providers can set `\"authHeader\": true` to automatically add `Authorization: Bearer ` header. Useful for providers that require explicit auth headers. ([#81](https://github.com/badlogic/pi-mono/issues/81))\n- **`--append-system-prompt` Flag**: Append additional text or file contents to the system prompt. Supports both inline text and file paths. Complements `--system-prompt` for layering custom instructions without replacing the base system prompt. ([#114](https://github.com/badlogic/pi-mono/pull/114) by [@markusylisiurunen](https://github.com/markusylisiurunen))\n- **Thinking Block Toggle**: Added `Ctrl+T` shortcut to toggle visibility of LLM thinking blocks. When toggled off, shows a static \"Thinking...\" label instead of full content. Useful for reducing visual clutter during long conversations. ([#113](https://github.com/badlogic/pi-mono/pull/113) by [@markusylisiurunen](https://github.com/markusylisiurunen))\n\n## [0.12.10] - 2025-12-04\n\n### Added\n\n- Added `gpt-5.1-codex-max` model support\n\n## [0.12.9] - 2025-12-04\n\n### Added\n\n- **`/copy` Command**: Copy the last agent message to clipboard. Works cross-platform (macOS, Windows, Linux). Useful for extracting text from rendered Markdown output. ([#105](https://github.com/badlogic/pi-mono/pull/105) by [@markusylisiurunen](https://github.com/markusylisiurunen))\n\n## [0.12.8] - 2025-12-04\n\n- Fix: Use CTRL+O consistently for compaction expand shortcut (not CMD+O on Mac)\n\n## [0.12.7] - 2025-12-04\n\n### Added\n\n- **Context Compaction**: Long sessions can now be compacted to reduce context usage while preserving recent conversation history. ([#92](https://github.com/badlogic/pi-mono/issues/92), [docs](https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/README.md#context-compaction))\n  - `/compact [instructions]`: Manually compact context with optional custom instructions for the summary\n  - `/autocompact`: Toggle automatic compaction when context exceeds threshold\n  - Compaction summarizes older messages while keeping recent messages (default 20k tokens) verbatim\n  - Auto-compaction triggers when context reaches `contextWindow - reserveTokens` (default 16k reserve)\n  - Compacted sessions show a collapsible summary in the TUI (toggle with `o` key)\n  - HTML exports include compaction summaries as collapsible sections\n  - RPC mode supports `{\"type\":\"compact\"}` command and auto-compaction (emits compaction events)\n- **Branch Source Tracking**: Branched sessions now store `branchedFrom` in the session header, containing the path to the original session file. Useful for tracing session lineage.\n\n## [0.12.5] - 2025-12-03\n\n### Added\n\n- **Forking/Rebranding Support**: All branding (app name, config directory, environment variable names) is now configurable via `piConfig` in `package.json`. Forks can change `piConfig.name` and `piConfig.configDir` to rebrand the CLI without code changes. Affects CLI banner, help text, config paths, and error messages. ([#95](https://github.com/badlogic/pi-mono/pull/95))\n\n### Fixed\n\n- **Bun Binary Detection**: Fixed Bun compiled binary failing to start after Bun updated its virtual filesystem path format from `%7EBUN` to `$bunfs`. ([#95](https://github.com/badlogic/pi-mono/pull/95))\n\n## [0.12.4] - 2025-12-02\n\n### Added\n\n- **RPC Termination Safeguard**: When running as an RPC worker (stdin pipe detected), the CLI now exits immediately if the parent process terminates unexpectedly. Prevents orphaned RPC workers from persisting indefinitely and consuming system resources.\n\n## [0.12.3] - 2025-12-02\n\n### Fixed\n\n- **Rate limit handling**: Anthropic rate limit errors now trigger automatic retry with exponential backoff (base 10s, max 5 retries). Previously these errors would abort the request immediately.\n- **Usage tracking during retries**: Retried requests now correctly accumulate token usage from all attempts, not just the final successful one. Fixes artificially low token counts when requests were retried.\n\n## [0.12.2] - 2025-12-02\n\n### Changed\n\n- Removed support for gpt-4.5-preview and o3 models (not yet available)\n\n## [0.12.1] - 2025-12-02\n\n### Added\n\n- **Models**: Added support for OpenAI's new models:\n  - `gpt-4.1` (128K context)\n  - `gpt-4.1-mini` (128K context)\n  - `gpt-4.1-nano` (128K context)\n  - `o3` (200K context, reasoning model)\n  - `o4-mini` (200K context, reasoning model)\n\n## [0.12.0] - 2025-12-02\n\n### Added\n\n- **`-p, --print` Flag**: Run in non-interactive batch mode. Processes input message or piped stdin without TUI, prints agent response directly to stdout. Ideal for scripting, piping, and CI/CD integration. Exits after first response.\n- **`-P, --print-streaming` Flag**: Like `-p`, but streams response tokens as they arrive. Use `--print-streaming --no-markdown` for raw unformatted output.\n- **`--print-turn` Flag**: Continue processing tool calls and agent turns until the agent naturally finishes or requires user input. Combine with `-p` for complete multi-turn conversations.\n- **`--no-markdown` Flag**: Output raw text without Markdown formatting. Useful when piping output to tools that expect plain text.\n- **Streaming Print Mode**: Added internal `printStreaming` option for streaming output in non-TUI mode.\n- **RPC Mode `print` Command**: Send `{\"type\":\"print\",\"content\":\"text\"}` to get formatted print output via `print_output` events.\n- **Auto-Save in Print Mode**: Print mode conversations are automatically saved to the session directory, allowing later resumption with `--continue`.\n- **Thinking level options**: Added `--thinking-off`, `--thinking-minimal`, `--thinking-low`, `--thinking-medium`, `--thinking-high` flags for directly specifying thinking level without the selector UI.\n\n### Changed\n\n- **Simplified RPC Protocol**: Replaced the `prompt` wrapper command with direct message objects. Send `{\"role\":\"user\",\"content\":\"text\"}` instead of `{\"type\":\"prompt\",\"message\":\"text\"}`. Better aligns with message format throughout the codebase.\n- **RPC Message Handling**: Agent now processes raw message objects directly, with `timestamp` auto-populated if missing.\n\n## [0.11.9] - 2025-12-02\n\n### Changed\n\n- Change Ctrl+I to Ctrl+P for model cycling shortcut to avoid collision with Tab key in some terminals\n\n## [0.11.8] - 2025-12-01\n\n### Fixed\n\n- Absolute glob patterns (e.g., `/Users/foo/**/*.ts`) are now handled correctly. Previously the leading `/` was being stripped, causing the pattern to be interpreted relative to the current directory.\n\n## [0.11.7] - 2025-12-01\n\n### Fixed\n\n- Fix read path traversal vulnerability. Paths are now validated to prevent reading outside the working directory or its parents. The `read` tool can read from `cwd`, its ancestors (for config files), and all descendants. Symlinks are resolved before validation.\n\n## [0.11.6] - 2025-12-01\n\n### Fixed\n\n- Fix `--system-prompt ` allowing the path argument to be captured by the message collection, causing \"file not found\" errors.\n\n## [0.11.5] - 2025-11-30\n\n### Fixed\n\n- Fixed fatal error \"Cannot set properties of undefined (setting '0')\" when editing empty files in the `edit` tool.\n- Simplified `edit` tool output: Shows only \"Edited file.txt\" for successful edits instead of verbose search/replace details.\n- Fixed fatal error in footer rendering when token counts contain NaN values due to missing usage data.\n\n## [0.11.4] - 2025-11-30\n\n### Fixed\n\n- Fixed chat rendering crash when messages contain preformatted/styled text (e.g., thinking traces with gray italic styling). The markdown renderer now preserves existing ANSI escape codes when they appear before inline elements.\n\n## [0.11.3] - 2025-11-29\n\n### Fixed\n\n- Fix file drop functionality for absolute paths\n\n## [0.11.2] - 2025-11-29\n\n### Fixed\n\n- Fixed TUI crash when pasting content containing tab characters. Tabs are now converted to 4 spaces before insertion.\n- Fixed terminal corruption after exit when shell integration sequences (OSC 133) appeared in bash output. These sequences are now stripped along with other ANSI codes.\n\n## [0.11.1] - 2025-11-29\n\n### Added\n\n- Added `fd` integration for file path autocompletion. Now uses `fd` for faster fuzzy file search\n\n### Fixed\n\n- Fixed keyboard shortcuts Ctrl+A, Ctrl+E, Ctrl+K, Ctrl+U, Ctrl+W, and word navigation (Option+Arrow) not working in VS Code integrated terminal and some other terminal emulators\n\n## [0.11.0] - 2025-11-29\n\n### Added\n\n- **File-based Slash Commands**: Create custom reusable prompts as `.txt` files in `~/.pi/slash-commands/`. Files become `/filename` commands with first-line descriptions. Supports `{{selection}}` placeholder for referencing selected/attached content.\n- **`/branch` Command**: Create conversation branches from any previous user message. Opens a selector to pick a message, then creates a new session file starting from that point. Original message text is placed in the editor for modification.\n- **Unified Content References**: Both `@path` in messages and `--file path` CLI arguments now use the same attachment system with consistent MIME type detection.\n- **Drag & Drop Files**: Drop files onto the terminal to attach them to your message. Supports multiple files and both text and image content.\n\n### Changed\n\n- **Model Selector with Search**: The `/model` command now opens a searchable list. Type to filter models by name, use arrows to navigate, Enter to select.\n- **Improved File Autocomplete**: File path completion after `@` now supports fuzzy matching and shows file/directory indicators.\n- **Session Selector with Search**: The `--resume` and `--session` flags now open a searchable session list with fuzzy filtering.\n- **Attachment Display**: Files added via `@path` are now shown as \"Attached: filename\" in the user message, separate from the prompt text.\n- **Tab Completion**: Tab key now triggers file path autocompletion anywhere in the editor, not just after `@` symbol.\n\n### Fixed\n\n- Fixed autocomplete z-order issue where dropdown could appear behind chat messages\n- Fixed cursor position when navigating through wrapped lines in the editor\n- Fixed attachment handling for continued sessions to preserve file references\n\n## [0.10.6] - 2025-11-28\n\n### Changed\n\n- Show base64-truncated indicator for large images in tool output\n\n### Fixed\n\n- Fixed image dimensions not being read correctly from PNG/JPEG/GIF files\n- Fixed PDF images being incorrectly base64-truncated in display\n- Allow reading files from ancestor directories (needed for monorepo configs)\n\n## [0.10.5] - 2025-11-28\n\n### Added\n\n- Full multimodal support: attach images (PNG, JPEG, GIF, WebP) and PDFs to prompts using `@path` syntax or `--file` flag\n\n### Fixed\n\n- `@`-references now handle special characters in file names (spaces, quotes, unicode)\n- Fixed cursor positioning issues with multi-byte unicode characters in editor\n\n## [0.10.4] - 2025-11-28\n\n### Fixed\n\n- Removed padding on first user message in TUI to improve visual consistency.\n\n## [0.10.3] - 2025-11-28\n\n### Added\n\n- Added RPC mode (`--rpc`) for programmatic integration. Accepts JSON commands on stdin, emits JSON events on stdout. See [RPC mode documentation](https://github.com/nicobailon/pi-mono/blob/main/packages/coding-agent/README.md#rpc-mode) for protocol details.\n\n### Changed\n\n- Refactored internal architecture to support multiple frontends (TUI, RPC) with shared agent logic.\n\n## [0.10.2] - 2025-11-26\n\n### Added\n\n- Added thinking level persistence. Default level stored in `~/.pi/settings.json`, restored on startup. Per-session overrides saved in session files.\n- Added model cycling shortcut: `Ctrl+I` cycles through available models (or scoped models with `-m` flag).\n- Added automatic retry with exponential backoff for transient API errors (network issues, 500s, overload).\n- Cumulative token usage now shown in footer (total tokens used across all messages in session).\n- Added `--system-prompt` flag to override default system prompt with custom text or file contents.\n- Footer now shows estimated total cost in USD based on model pricing.\n\n### Changed\n\n- Replaced `--models` flag with `-m/--model` supporting multiple values. Specify models as `provider/model@thinking` (e.g., `anthropic/claude-sonnet-4-20250514@high`). Multiple `-m` flags scope available models for the session.\n- Thinking level border now persists visually after selector closes.\n- Improved tool result display with collapsible output (default collapsed, expand with `Ctrl+O`).\n\n## [0.10.1] - 2025-11-25\n\n### Added\n\n- Add custom model configuration via `~/.pi/models.json`\n\n## [0.10.0] - 2025-11-25\n\nInitial public release.\n\n### Added\n\n- Interactive TUI with streaming responses\n- Conversation session management with `--continue`, `--resume`, and `--session` flags\n- Multi-line input support (Shift+Enter or Option+Enter for new lines)\n- Tool execution: `read`, `write`, `edit`, `bash`, `glob`, `grep`, `think`\n- Thinking mode support for Claude with visual indicator and `/thinking` selector\n- File path autocompletion with `@` prefix\n- Slash command autocompletion\n- `/export` command for HTML session export\n- `/model` command for runtime model switching\n- `/session` command for session statistics\n- Model provider support: Anthropic (Claude), OpenAI, Google (Gemini)\n- Git branch display in footer\n- Message queueing during streaming responses\n- OAuth integration for Gmail and Google Calendar access\n- HTML export with syntax highlighting and collapsible sections\n\n## [0.9.3] - 2025-11-24\n\n### Added\n\n- Added Anthropic Claude Opus 4.5 support\n\n## [0.9.2] - 2025-11-24\n\n### Fixed\n\n- **Edit Tool Dollar Sign Bug**: Fixed critical bug in the `edit` tool where `String.replace()` was interpreting `$` as a special replacement pattern (e.g., `$$`, `$&`, `$'`). When trying to insert `$` into code (like adding a dollar sign to a template literal), the replacement would silently fail and produce unchanged content, but the tool would incorrectly report success. Now uses `indexOf` + `substring` for raw string replacement without special character interpretation. Also added verification that content actually changed, rejecting with a clear error if the replacement produces identical content. ([#53](https://github.com/badlogic/pi-mono/issues/53))\n\n## [0.9.0] - 2025-11-21\n\n### Added\n\n- **`/clear` Command**: New slash command to reset the conversation context and start a fresh session. Aborts any in-flight agent work, clears all messages, and creates a new session file. ([#48](https://github.com/badlogic/pi-mono/pull/48))\n- **Model Cycling with Thinking Levels**: The `--models` flag now supports thinking level syntax (e.g., `--models sonnet:high,haiku:low`). When cycling models with `Ctrl+P`, the associated thinking level is automatically applied. The first model in the scope is used as the initial model when starting a new session. Both model and thinking level changes are now saved to session and settings for persistence. ([#47](https://github.com/badlogic/pi-mono/pull/47))\n- **`--thinking` Flag**: New CLI flag to set thinking level directly (e.g., `--thinking high`). Valid values: `off`, `minimal`, `low`, `medium`, `high`. Takes highest priority over all other thinking level sources. ([#45](https://github.com/badlogic/pi-mono/issues/45))\n\n### Breaking\n\n- **Interactive Mode with Initial Prompt**: Passing a prompt on the command line (e.g., `pi \"List files\"`) now starts interactive mode with the prompt pre-submitted, instead of exiting after completion. Use `--print` or `-p` to get the previous non-interactive behavior (e.g., `pi -p \"List files\"`). This matches Claude CLI (`-p`) and Codex (`exec`) behavior. ([#46](https://github.com/badlogic/pi-mono/issues/46))\n\n### Fixed\n\n- **Slash Command Autocomplete**: Fixed issue where pressing Enter on a highlighted slash command suggestion (e.g., typing `/mod` with `/model` highlighted) would submit the partial text instead of executing the selected command. Now Enter applies the completion and submits in one action. ([#49](https://github.com/badlogic/pi-mono/issues/49))\n- **Model Matching Priority**: The `--models` flag now prioritizes exact matches over partial matches. Supports `provider/modelId` format (e.g., `openrouter/openai/gpt-5.1-codex`) for precise selection. Exact ID matches are tried before partial matching, so `--models gpt-5.1-codex` correctly selects `gpt-5.1-codex` instead of `openai/gpt-5.1-codex-mini`.\n- **Markdown Link Rendering**: Fixed links with identical text and href (e.g., `https://github.com/badlogic/pi-mono/pull/48/files`) being rendered twice. Now correctly compares raw text instead of styled text (which contains ANSI codes) when determining if link text matches href.\n\n## [0.8.5] - 2025-11-21\n\n### Fixed\n\n- **Path Completion Hanging**: Fixed catastrophic regex backtracking in path completion that caused the terminal to hang when text contained many `/` characters (e.g., URLs). Replaced complex regex with simple string operations. ([#18](https://github.com/badlogic/pi-mono/issues/18))\n- **Autocomplete Arrow Keys**: Fixed issue where arrow keys would move both the autocomplete selection and the editor cursor simultaneously when the file selector list was shown.\n\n## [0.8.4] - 2025-11-21\n\n### Fixed\n\n- **Read Tool Error Handling**: Fixed issue where the `read` tool would return errors as successful text content instead of throwing. Now properly throws errors for file not found and offset out of bounds conditions.\n\n## [0.8.3] - 2025-11-21\n\n### Improved\n\n- **Export HTML**: Limited container width to 700px for better readability. Fixed message statistics to match `/session` command output with proper breakdown of User/Assistant/Tool Calls/Tool Results/Total messages.\n- **Dark Theme**: Increased visibility of editor border (darkGray from #303030 to #505050) and thinking minimal indicator (from #4e4e4e to #6e6e6e).\n\n## [0.8.0] - 2025-11-21\n\n### Added\n\n- **Theme System**: Full theming support with 44 customizable color tokens. Two built-in themes (`dark`, `light`) with auto-detection based on terminal background. Use `/theme` command to select themes interactively. Custom themes in `~/.pi/agent/themes/*.json` support live editing - changes apply immediately when the file is saved. Themes use RGB hex values for consistent rendering across terminals. VS Code users: set `terminal.integrated.minimumContrastRatio` to `1` for proper color rendering. See [Theme Documentation](docs/theme.md) for details.\n\n## [0.7.29] - 2025-11-20\n\n### Improved\n\n- **Read Tool Display**: When the `read` tool is called with offset/limit parameters, the tool execution now displays the line range in a compact format (e.g., `read src/main.ts:100-200` for offset=100, limit=100).\n\n## [0.7.28] - 2025-11-20\n\n### Added\n\n- **Message Queuing**: You can now send multiple messages while the agent is processing without waiting for the previous response to complete. Messages submitted during streaming are queued and processed based on your queue mode setting. Queued messages are shown in a pending area below the chat. Press Escape to abort and restore all queued messages to the editor. Use `/queue` to select between \"one-at-a-time\" (process queued messages sequentially, recommended) or \"all\" (process all queued messages at once). The queue mode setting is saved and persists across sessions. ([#15](https://github.com/badlogic/pi-mono/issues/15))\n\n## [0.7.27] - 2025-11-20\n\n### Fixed\n\n- **Slash Command Submission**: Fixed issue where slash commands required two Enter presses to execute. Now pressing Enter on a slash command autocomplete suggestion immediately submits the command, while Tab still applies the completion for adding arguments. ([#30](https://github.com/badlogic/pi-mono/issues/30))\n- **Slash Command Autocomplete**: Fixed issue where typing a typo then correcting it would not show autocomplete suggestions. Autocomplete now re-triggers when typing or backspacing in a slash command context. ([#29](https://github.com/badlogic/pi-mono/issues/29))\n\n## [0.7.26] - 2025-11-20\n\n### Added\n\n- **Tool Output Expansion**: Press `Ctrl+O` to toggle between collapsed and expanded tool output display. Expands all tool call outputs (bash, read, write, etc.) to show full content instead of truncated previews. ([#31](https://github.com/badlogic/pi-mono/issues/31))\n- **Custom Headers**: Added support for custom HTTP headers in `models.json` configuration. Headers can be specified at both provider and model level, with model-level headers overriding provider-level ones. This enables bypassing Cloudflare bot detection and other proxy requirements. ([#39](https://github.com/badlogic/pi-mono/issues/39))\n\n### Fixed\n\n- **Chutes AI Provider**: Fixed 400 errors when using Chutes AI provider. Added compatibility fixes for `store` field exclusion, `max_tokens` parameter usage, and system prompt role handling. ([#42](https://github.com/badlogic/pi-mono/pull/42) by [@butelo](https://github.com/butelo))\n- **Mistral/Chutes Syntax Error**: Fixed syntax error in merged PR that used `iif` instead of `if`.\n- **Anthropic OAuth Bug**: Fixed bug where `process.env.ANTHROPIC_API_KEY = undefined` set the env var to string \"undefined\" instead of deleting it. Now uses `delete` operator.\n\n## [0.7.25] - 2025-11-20\n\n### Added\n\n- **Model Cycling**: Press `Ctrl+P` to quickly cycle through models. Use `--models` CLI argument to scope to specific models (e.g., `--models claude-sonnet,gpt-4o`). Supports pattern matching and smart version selection (prefers aliases over dated versions). ([#37](https://github.com/badlogic/pi-mono/pull/37) by [@fightbulc](https://github.com/fightbulc))\n\n## [0.7.24] - 2025-11-20\n\n### Added\n\n- **Thinking Level Cycling**: Press `Shift+Tab` to cycle through thinking levels (off \u2192 minimal \u2192 low \u2192 medium \u2192 high) for reasoning-capable models. Editor border color changes to indicate current level (gray \u2192 blue \u2192 cyan \u2192 magenta).\n\n## [0.7.23] - 2025-11-20\n\n### Added\n\n- **Update Notifications**: Interactive mode now checks for new versions on startup and displays a notification if an update is available.\n\n### Changed\n\n- **System Prompt**: Updated system prompt to instruct agent to output plain text summaries directly instead of using cat or bash commands to display what it did.\n\n### Fixed\n\n- **File Path Completion**: Removed 10-file limit in tab completion selector. All matching files and directories now appear in the completion list.\n- **Absolute Path Completion**: Fixed tab completion for absolute paths (e.g., `/Applications`). Absolute paths in the middle of text (like \"hey /\") now complete correctly. Also fixed crashes when trying to stat inaccessible files (like macOS `.VolumeIcon.icns`) during directory traversal.\n\n## [0.7.22] - 2025-11-19\n\n### Fixed\n\n- **Long Line Wrapping**: Fixed crash when rendering long lines without spaces (e.g., file paths). Long words now break character-by-character to fit within terminal width.\n\n## [0.7.21] - 2025-11-19\n\n### Fixed\n\n- **Terminal Flicker**: Fixed flicker at bottom of viewport (especially editor component) in xterm.js-based terminals (VS Code, etc.) by using per-line clear instead of clear-to-end sequence.\n- **Background Color Rendering**: Fixed black cells appearing at end of wrapped lines when using background colors. Completely rewrote text wrapping and background application to properly handle ANSI reset codes.\n- **Tool Output**: Strip ANSI codes from bash/tool output before rendering to prevent conflicts with TUI styling.\n\n## [0.7.20] - 2025-11-18\n\n### Fixed\n\n- **Message Wrapping**: Fixed word-based text wrapping for long lines in chat messages. Text now properly wraps at word boundaries while preserving ANSI styling (colors, bold, italic, etc.) across wrapped lines. Background colors now extend to the full width of each line. Empty lines in messages now render correctly with full-width background.\n\n## [0.7.18] - 2025-11-18\n\n### Fixed\n\n- **Bash Tool Error Handling**: Bash tool now properly throws errors for failed commands (non-zero exit codes), timeouts, and aborted executions. This ensures tool execution components display with red background when bash commands fail.\n- **Thinking Traces Styling**: Thinking traces now maintain gray italic styling throughout, even when containing inline code blocks, bold text, or other inline formatting\n\n## [0.7.17] - 2025-11-18\n\n### Added\n\n- **New Model**: Added `gemini-3-pro-preview` to Google provider.\n- **OAuth Authentication**: Added `/login` and `/logout` commands for OAuth-based authentication with Claude Pro/Max subscriptions. Tokens are stored in `~/.pi/agent/oauth.json` with 0600 permissions and automatically refreshed when expired. OAuth tokens take priority over API keys for Anthropic models.\n\n### Fixed\n\n- **Anthropic Aborted Thinking**: Fixed error when resubmitting assistant messages with incomplete thinking blocks (from aborted streams). Thinking blocks without valid signatures are now converted to text blocks with `` delimiters, preventing API rejection.\n- **Model Selector Loading**: Fixed models not appearing in `/model` selector until user started typing. Models now load asynchronously and re-render when available.\n- **Input Paste Support**: Added bracketed paste mode support to `Input` component, enabling paste of long OAuth authorization codes.\n\n## [0.7.16] - 2025-11-17\n\n### Fixed\n\n- **Tool Error Display**: Fixed edit tool (and all other tools) not showing error state correctly in TUI. Failed tool executions now properly display with red background and show the error message. Previously, the `isError` flag from tool execution events was not being passed to the UI component, causing all tool results to show with green (success) background regardless of whether they succeeded or failed.\n\n## [0.7.15] - 2025-11-17\n\n### Fixed\n\n- **Anthropic OAuth Support**: Added support for `ANTHROPIC_OAUTH_TOKEN` environment variable. The agent now checks for OAuth tokens before falling back to API keys for Anthropic models, enabling OAuth-based authentication.\n\n## [0.7.14] - 2025-11-17\n\n### Fixed\n\n- **Mistral API Compatibility**: Fixed compatibility with Mistral API by excluding the `store` field and using `max_tokens` instead of `max_completion_tokens`, and avoiding the `developer` role in system prompts.\n- **Error Display**: Fixed error message display in assistant messages to include proper spacing before the error text.\n- **Message Streaming**: Fixed missing `message_start` event when no partial message chunks were received during streaming.\n\n## [0.7.13] - 2025-11-16\n\n### Fixed\n\n- **TUI Editor**: Fixed unicode input support for umlauts (\u00e4\u00f6\u00fc), emojis (\ud83d\ude00), and other extended characters. Previously the editor only accepted ASCII characters (32-126). Now properly handles all printable unicode while still filtering out control characters. ([#20](https://github.com/badlogic/pi-mono/pull/20))\n\n## [0.7.12] - 2025-11-16\n\n### Added\n\n- **Custom Models and Providers**: Support for custom models and providers via `~/.pi/agent/models.json` configuration file. Add local models (Ollama, vLLM, LM Studio) or any OpenAI-compatible, Anthropic-compatible, or Google-compatible API. File is reloaded on every `/model` selector open, allowing live updates without restart. ([#21](https://github.com/badlogic/pi-mono/issues/21))\n- Added `gpt-5.1-codex` model to OpenAI provider (400k context, 128k max output, reasoning-capable).\n\n### Changed\n\n- **Breaking**: No longer hardcodes Anthropic/Claude as default provider/model. Now prefers sensible defaults per provider (e.g., `claude-sonnet-4-5` for Anthropic, `gpt-5.1-codex` for OpenAI), or requires explicit selection in interactive mode.\n- Interactive mode now allows starting without a model, showing helpful error on message submission instead of failing at startup.\n- Non-interactive mode (CLI messages, JSON, RPC) still fails early if no model or API key is available.\n- Model selector now saves selected model as default in settings.json.\n- `models.json` validation errors (syntax + schema) now surface with precise file/field info in both CLI and `/model` selector.\n- Agent system prompt now includes absolute path to its own README.md for self-documentation.\n\n### Fixed\n\n- Fixed crash when restoring a session with a custom model that no longer exists or lost credentials. Now gracefully falls back to default model, logs the reason, and appends a warning message to the restored chat.\n- Footer no longer crashes when no model is selected.\n\n## [0.7.11] - 2025-11-16\n\n### Changed\n\n- The `/model` selector now filters models based on available API keys. Only models for which API keys are configured in environment variables are shown. This prevents selecting models that would fail due to missing credentials. A yellow hint is displayed at the top of the selector explaining this behavior. ([#19](https://github.com/badlogic/pi-mono/pull/19))\n\n## [0.7.10] - 2025-11-14\n\n### Added\n\n- `/branch` command for creating conversation branches. Opens a selector showing all user messages in chronological order. Selecting a message creates a new session with all messages before the selected one, and places the selected message in the editor for modification or resubmission. This allows exploring alternative conversation paths without losing the current session. (fixes [#16](https://github.com/badlogic/pi-mono/issues/16))\n\n## [0.7.9] - 2025-11-14\n\n### Changed\n\n- Editor: updated keyboard shortcuts to follow Unix conventions:\n  - **Ctrl+W** deletes the previous word (stopping at whitespace or punctuation)\n  - **Ctrl+U** deletes from cursor to start of line (at line start, merges with previous line)\n  - **Ctrl+K** deletes from cursor to end of line (at line end, merges with next line)\n  - **Option+Backspace** in Ghostty now behaves like **Ctrl+W** (delete word backwards)\n  - **Cmd+Backspace** in Ghostty now behaves like **Ctrl+U** (delete to start of line)\n\n## [0.7.8] - 2025-11-13\n\n### Changed\n\n- Updated README.md with `/changelog` slash command documentation\n\n## [0.7.7] - 2025-11-13\n\n### Added\n\n- Automatic changelog display on startup in interactive mode. When starting a new session (not continuing/resuming), the agent will display all changelog entries since the last version you used. The last shown version is tracked in `~/.pi/agent/settings.json`.\n- `/changelog` command to display the changelog in the TUI\n- OpenRouter Auto Router model support ([#5](https://github.com/badlogic/pi-mono/pull/5))\n- Windows Git Bash support with automatic detection and process tree termination ([#1](https://github.com/badlogic/pi-mono/pull/1))\n\n### Changed\n\n- **BREAKING**: Renamed project context file from `AGENT.md` to `AGENTS.md`. The system now looks for `AGENTS.md` or `CLAUDE.md` (with `AGENTS.md` preferred). Existing `AGENT.md` files will need to be renamed to `AGENTS.md` to continue working. (fixes [#9](https://github.com/badlogic/pi-mono/pull/9))\n- **BREAKING**: Session file format changed to store provider and model ID separately instead of as a single `provider/modelId` string. Existing sessions will not restore the model correctly when resumed - you'll need to manually set the model again using `/model`. (fixes [#4](https://github.com/badlogic/pi-mono/pull/4))\n- Improved Windows Git Bash detection logic with better error messages showing actual paths searched ([#13](https://github.com/badlogic/pi-mono/pull/13))\n\n### Fixed\n\n- Fixed markdown list rendering bug where bullets were not displayed when list items contained inline code with cyan color formatting\n- Fixed context percentage showing 0% in footer when last assistant message was aborted ([#12](https://github.com/badlogic/pi-mono/issues/12))\n- Fixed error message loss when `turn_end` event contains an error. Previously, errors in `turn_end` events (e.g., \"Provider returned error\" from OpenRouter Auto Router) were not captured in `agent.state.error`, making it appear as if the agent completed successfully. ([#6](https://github.com/badlogic/pi-mono/issues/6))\n\n## [0.7.6] - 2025-11-13\n\nPrevious releases did not maintain a changelog.\n", "creation_timestamp": "2026-08-22T01:33:47.478132Z"}