@astralyn/pi 1.4.5 → 1.4.7

package/CHANGELOG.md

@@ -4,6 +4,48 @@ This file records `@astralyn/pi` releases beginning with the first Fork-owned re
 
 ## [Unreleased]
 
+## [1.4.7] - 2026-10-31
+
+### Added
+
+- `TaskReadOptions` is exported from the SDK and extension API as the named shape of `TasksContext.read()` options (`mode`, `bytes`, `sinceBytes`); the `read` options of `wait()` and `waitAny()` are subsets of it.
+- `pi config` now cycles skills through On, User only, and Off, with project-local inheritance and explicit overrides. User-only skills stay available through `/skill:name` without being advertised to the model; the same policy is available through `skillInvocationOverrides` in global, project, and package settings.
+
+### Changed
+
+- Refined Agent delegation prompts to keep design and substantial coding in the main session while giving Agents clearer guidance for independent research, verification, bounded implementation, parallel writes, and self-contained final reports.
+- **Breaking (extension and SDK API):** `TasksContext.wait()` and `waitAny()` now take an options object and return a typed result. `wait(id, { timeoutMs?, signal?, toolCallId?, read? })` returns `{ outcome, waitedMs, task, read? }`; `waitAny({ timeoutMs?, signal?, toolCallId?, read? })` returns `{ outcome, waitedMs, task?, read?, running }`. `outcome` is `settled`, `timed_out`, `interrupted`, or `closed`, plus `no_tasks` for an empty `waitAny` cohort. The runtime now owns the whole `tasks wait` delivery protocol: it holds delivery before the wait, reads, registers the persisted-result receipt for the given `toolCallId`, and then releases, and it applies steering interruption itself. `interruptSignal` parameters, `TasksContext.holdDelivery()`, `TasksSessionContext.waitInterruptSignal`, and `TasksSessionContext.prepareWait()` are removed; `TasksSessionContext` keeps only `stoppedByTreeNavigation()`. Hosts embedding a `TaskRuntime` can supply `TaskRuntimeOptions.waits` for the same behavior. `holdDelivery()` remains on `TaskRuntime` for host delivery code.
+- **Breaking (SDK):** `TaskRuntime.pause()` is removed; delivery pausing has one owner, `session.pauseTaskNotifications()`. `TaskRuntime.pendingNotifications()` and `claimNotification()` no longer return nothing while delivery is paused.
+- **Breaking (SDK):** `AgentSession.tasksStoppedByTreeNavigation()` is removed; use `session.tasks.session?.stoppedByTreeNavigation(targetId)`.
+- DeepWiki's transport now reuses the shared layers instead of its own copies: requests go through the management HTTP retry helper, the body is read with the shared bounded reader, and the response envelope is validated with `@earendil-works/pi-mcp`'s JSON-RPC parser. Behavior is unchanged except for retries: DeepWiki now retries network failures and HTTP 408, 425, 429, 500, 502, 503, and 504 (it previously retried every 5xx and 429), retries immediately instead of waiting 1s then 2s, and no longer retries a connection that drops while the body is being read. The 45-second limit is now one budget for the whole call, retries included. Timeouts and caller cancellation still are not retried.
+- The cached-compaction card is now a one-line footnote under the compaction summary, `From cache · CH 98.8% · ↓2.8k · 18s`, in the footer's `↑ ↓ R W CH` units, with the cache hit rate colored by how well the cache was reused. It no longer has its own title, labels only automatic compaction (`auto`), and expands with the summary (Ctrl+O) to show the reason and the prompt split into cached, written and uncached tokens.
+- Shell tools called without an extension context now run as a foreground task, matching the session path: an already aborted signal rejects with the signal's reason, an invalid `timeout` is rejected before the command starts, and an output-capture failure cancels the command and reports its error.
+
+### Fixed
+
+- The `/tasks` footer now advertises the background key only when the task can move right now. It no longer offers it while every background slot is taken; pressing the key then still explains the limit.
+- Entries an extension appends in a `session_compact` handler now appear after the compaction summary in the live transcript, as they already did after resuming the session. The cached-compaction card uses this and is saved with the compaction itself instead of on a later tick, so closing the session right after compacting no longer drops it.
+
+## [1.4.6] - 2026-10-30
+
+### Added
+
+- Task executors can declare a concurrency lane (`{ key, limit }`). Work beyond the limit waits as a visible queued task that can be moved to the background or cancelled before it starts; Agent uses a four-slot lane, so a queued background Agent now returns its Task ID immediately instead of blocking the parent.
+
+### Changed
+
+- Running `tasks read` now returns a one-line Agent status, such as `Agent running · 3 tool calls · latest: bash npm test`, instead of the Tool-call list. Tool calls stay in `/tasks` Output as human-only display text, and the final report remains the only content the parent model receives from an Agent.
+- **Breaking (extension API):** Task executors now declare their presentation as data: `label`, `input`, `facts`, and an `output` kind of `log` or `report`. These replace `command`, `cwd`, `info`, and `exitCode`. `TaskControl` gains `publish({ result, display?, usage? })`, `attachOutput`, and `cancel`. `TaskExecutionError` and `TaskCompletionSnapshot` are removed. The `/tasks` panel and completion cards render every executor the same way, and the shell reports its exit code as an `Exit` fact.
+- A background Agent's completion now delivers its report from the beginning, whole when it fits the 48 KiB notification budget, as its foreground result would. Previously only an 8 KiB tail reached the model, which could drop the report's summary.
+- Each task settlement now appends one version-3 `task-record` entry holding the terminal snapshot and its usage, replacing the separate `task-result` and `task-usage` entries. Completion message details are `{ version: 3, task }`. Older result records are not restored as history, but usage from released sessions still counts toward session totals.
+- The `/tasks` panel now uses one row per task: a status glyph, the source such as Bash or Agent, the title, and right-aligned elapsed time. The inspector opens with a `Bash · Running · 12s` header beside its Output/Details tabs, and Details starts with Source, Task ID and Status. Enter opens the selected task. The stop question moves to the footer, so the list and output stay visible. Reopening the panel selects the newest task started since it last closed. Grouped help lists each key once, and single-letter keys display as typed (`k`, not `K`).
+- Agent Output in `/tasks` updates as soon as the Agent publishes, rather than on the next one-second poll. Its Tool calls use the Transcript form, `✓ read README.md · 4ms`, instead of raw JSON arguments.
+- Refined `/agent` into a compact, aligned Model/Effort panel with inline inheritance markers, requested-to-effective effort conversions, and an always-visible action that resets both overrides together. Agent now reuses the searchable native model and thinking pickers without changing the parent session or global defaults.
+
+### Fixed
+
+- Selection-only native pickers show working confirmation and cancellation hints without advertising unavailable global-default saving or main-session thinking controls.
+
 ## [1.4.5] - 2026-10-30
 
 ### Added