@astralyn/pi 0.82.2 → 0.82.4

package/CHANGELOG.md

@@ -2,6 +2,48 @@
 
 ## [Unreleased]
 
+## [0.82.4] - 2026-07-26
+
+### Added
+
+- Added a bundled `plan` extension: `/plan` (or `--plan`) enters a read-only planning mode that disables `edit`, `write`, `bash`, and `subagent`, interviews via the `question` tool, and exits through a user-approved `exit_plan` tool call. Approval saves the plan to `<agentDir>/plans/<sessionId>/NN-<slug>.md` and either continues in place or compacts the context first, restarting execution with the plan embedded in the kickoff message. See [plan](docs/bundled/extensions/plan.md).
+- Added subagent recovery from transient provider failures: the worker session's auto-retry backoff is now visible in the run status (`Retrying (n/m) in Xs…`), and a failure that produced no turns or tool uses — such as a preflight auth throw, which bypasses session-level retry entirely — is rerun at the task level with exponential backoff. Runs with partial work behind them are never rerun. See [subagent](docs/bundled/extensions/subagent.md).
+
+### Changed
+
+- Reworked the subagent transcript views. Call headers drop the mode wording: a single delegation renders as `General Agent · <description>` with the profile name title-cased for display (`code-reviewer` → `Code Reviewer`), and a batch renders as `Multi-Agent · N tasks`. While running, the collapsed view leads with a tool-derived intent line (`Applying changes`, `Verifying changes`, `Exploring code` — now also covering inspection commands like `git status` and `rg`, `Investigating a failure`) over the raw tool summary, and shows live elapsed time plus a `ctx:` context watermark that tracks the worker's latest request size. Completed excerpts cut at sentence boundaries, and the expanded activity history grows from 4 to 12 entries.
+- Retired the subagent renderer's own `●` status dots in favor of the tool shell's call-level dot: `›` now marks the current position (the running task in a batch, the running tool elsewhere), `○`/`✓`/`×`/`■` cover queued and terminal states, and progress headers omit zero counts. Expanded batches gain a numbered contents list matched to `──` section headers, activity rows show durations of a second or longer and color failed result excerpts, the expanded view keeps the streaming tail visible while a run is in flight, and run metadata names the working directory when it differs from the parent's.
+- Raised the subagent concurrency gate from three to five workers, and re-headed parallel result sections as `### <description> (<agent>) — <status>` so repeated profile names stay distinguishable.
+- Removed the subagent `chain` mode along with `{previous}` substitution: later steps had to be written before earlier results existed, so chains could only hand off blindly. Sequential work is now driven by the parent, which reads each report before writing the next single-mode briefing and can adapt or stop between steps. See [subagent](docs/bundled/extensions/subagent.md).
+- Changed mid-turn auto-compaction to distinguish an extension's voluntary `session_before_compact` cancel from a failure: a cancel now lets the run continue (skipping further mid-turn checks for that run) instead of failing closed, and the event carries a new `timing` field (`"manual" | "midTurn" | "postRun" | "prePrompt"`) so extensions can tell the contexts apart. The "nothing to compact" error now includes the same remediation guidance as the retained-context warning. See [Compaction](docs/compaction.md).
+
+### Fixed
+
+- Fixed auto-compaction to also check the context before continuing a run with queued steering or follow-up messages; previously a turn without tool results skipped the mid-turn check and long follow-up chains could only recover via overflow.
+- Fixed the IME candidate window jumping between the caret and the end of the input line while typing with a CJK input method in Windows Terminal and other terminals that anchor the candidate window to the hardware cursor. Each TUI render pass is now flushed to stdout as one atomic write instead of separate frame, cursor-reposition, and cursor-visibility writes, so the terminal never observes the intermediate cursor position (upstream [#6289](https://github.com/earendil-works/pi/issues/6289), [#5200](https://github.com/earendil-works/pi/issues/5200)).
+- Fixed the terminal viewport jumping to the top of the buffer when scrolling up through history while a response is streaming, most visibly in Windows Terminal. Content-driven full redraws (triggered whenever a line above the viewport changes during streaming markdown reflow) previously cleared the terminal scrollback with `ESC[3J` and replayed the entire transcript; such frames are now rewritten to overwrite the visible screen in place (avoiding `ESC[2J`, which conhost implements by pushing the screen into scrollback), preserving scrollback, the reading position, and pre-session shell history without accumulating duplicate screen copies. Width-change redraws still clear scrollback since re-wrapped content invalidates it (upstream [#6502](https://github.com/earendil-works/pi/issues/6502), [#5576](https://github.com/earendil-works/pi/issues/5576), [#6050](https://github.com/earendil-works/pi/issues/6050)).
+- Fixed the rewind extension's `/tree` restore semantics. Snapshots now anchor to the first user entry of a run (steering/follow-up messages no longer shift the anchor onto a mid-run message), and the restore target mirrors `/tree`'s leaf rules: user-message targets restore to the state before that turn, other targets to the state after it, and navigation is silent instead of rolling back the target turn's own edits when nothing was recorded afterwards. Also fixed resume/fork backup migration to link only retained frames (removing a race with over-cap blob pruning), made restore-side change detection immune to mtime-preserving content swaps, deduplicated case-insensitive tracking keys on Windows, and taught the storage menu's "remove all" to keep backups recently written by other running sessions. See [rewind](docs/bundled/extensions/rewind.md).
+- Fixed subagent working-directory resolution under a symlinked parent directory (macOS `/tmp`, Windows junctions): the containment check compared the real parent path against the unresolved candidate, so every call — including the default inherit-cwd case — was rejected as an escape. Traversal and symlink escapes are still blocked.
+- Fixed the subagent tool staying broken for the rest of the session after a transient `ModelRuntime` creation failure; the rejected promise is no longer cached, so the next invocation retries.
+- Fixed subagent progress updates firing after the tool result had settled (a throttled emitter leaked its timer), and skipped redundant progress serialization when consecutive events change nothing user-visible.
+
+## [0.82.3] - 2026-07-26
+
+### Added
+
+- Exposed the `outputPad` setting to custom message renderers. See [Extensions](docs/extensions.md) ([#7045](https://github.com/earendil-works/pi/pull/7045) by [@xl0](https://github.com/xl0)).
+
+### Changed
+
+- Changed pi.dev model catalog refreshes to revalidate with `If-None-Match`, so unchanged provider catalogs answer with an empty `304` instead of a full download.
+- Reworked the package documentation as distribution-owned `@astralyn/pi` user and API guidance, with dedicated bundled-feature pages, standalone examples, complete navigation, and automated checks for broken package links or monorepo-only paths. Repository architecture, upstream synchronization, development, and release procedures now live separately under `maintainers/` and are excluded from npm packages.
+
+### Fixed
+
+- Fixed unavailable scoped models being hidden from `/models`, allowing them to be removed without editing settings manually ([#6949](https://github.com/earendil-works/pi/issues/6949), [#7032](https://github.com/earendil-works/pi/pull/7032) by [@christianklotz](https://github.com/christianklotz)).
+- Fixed startup context file discovery to skip directories that match context file names such as `AGENTS.md`, which produced `EISDIR` warnings ([#7106](https://github.com/earendil-works/pi/pull/7106) by [@mrexodia](https://github.com/mrexodia)).
+- Fixed the llama.cpp extension to persist its model catalog, so llama.cpp models stay listed before the first successful refresh. See [llama.cpp](docs/llama-cpp.md) ([#7072](https://github.com/earendil-works/pi/pull/7072) by [@davidbrai](https://github.com/davidbrai)).
+
 ## [0.82.2] - 2026-07-26
 
 ### Fixed