pi-subagents 0.82.0 → 0.83.0

package/CHANGELOG.md

@@ -2,6 +2,52 @@
 
 ## [Unreleased]
 
+## [0.83.0] - 2026-10-25
+
+### Highlights
+
+- Subagents no longer break your session's prompt cache on models that take system messages mid-conversation, so each turn after a subagent returns is cheaper and faster. A child that runs its own subagents keeps its cache too.
+- Subagents that finished their work always report it: background runs no longer end as "exited with code 0 before writing a result", and foreground calls no longer hang when the child stops after its final reply.
+- Children placed on another machine (a Rex tab, Rex over SSH, or a Herdr pane) launch instead of being refused, and workflows no longer crash on Windows standalone Pi builds.
+- Extensions and editors that show subagent activity can refresh on a new event instead of polling, and `bg_wait` now waits for background jobs that other extensions report, such as surf-cli's.
+- A typo in an agent override in settings, such as `modle` or a thinking level like `hgih`, now fails with a "Did you mean" hint instead of being ignored.
+
+### Added
+
+- Extensions and editor integrations that show background subagent activity no longer need to poll for changes. A new `subagent:jobs-changed` event tells them to read `status` again whenever a background run starts, moves to its next step, reports progress, or finishes, including chain and parallel step changes that no event reported before. The RPC `ping` reply now lists it, along with the existing `subagent:async-started` event, and [extension-api.md](docs/extension-api.md#refresh-a-host-view-without-polling) shows how to use them. Thanks to [@raviy06](https://github.com/raviy06) for the proposal. (#3068)
+
+### Fixed
+
+- On models that take system messages mid-conversation, the first request of every new turn after the first subagent notice missed the prompt cache, so most of the context was sent uncached again each turn. A child that had called `subagent` missed it on every later request. The way pi-subagents marked its notices and removed parent-only subagent history made Pi move every mid-conversation system message to the start of the prompt; both now leave those messages where they are. Thanks to [@adameq](https://github.com/adameq) for the report. (#3058, #3063)
+- Background subagents that finished their work no longer end as "exited with code 0 before writing a result". When a child stopped after its final reply without reporting that it had settled, or when one of its extensions hung on shutdown, the background runner process exited with the result still unwritten. It now ends the child after its final reply, waits for any compaction that runs after that reply, and waits at most 5 seconds for shutdown handlers. A foreground subagent whose child stops the same way now returns its reply too, instead of the call never returning. Thanks to [@perriea](https://github.com/perriea). (#3051)
+- Background jobs that other extensions report to `bg_wait`, such as surf-cli's or pi-agent-wait's, are now waited for in saved sessions. Before, `bg_wait` and the wait at the end of a `pi -p` run matched a job only when the extension named the session by its file path, so a job named by the session id was ignored and they returned while it was still running. Both forms are now accepted. Thanks to [@cad0p](https://github.com/cad0p) for the report. (#3071)
+- With features turned off in `disabledFeatures`, every `guide` topic now starts with a notice listing what is disabled, and every section with a one-line pointer to that list, not only the `tool-reference` topic. Before, an agent reading the workflow guide with `workflow-scripts` disabled was taught `workflow: true` and `args`, and its call was rejected. With workflow scripts disabled, the notice also says to use the top-level `tasks` or `chain` fields instead. Thanks to [@jefftheai](https://github.com/jefftheai) for the report. (#3057)
+- When text written after a tool call reaches Pi only as a summary, as happens through the Claude Agent SDK used by pi-claude-bridge, a lost ```` ```js workflow ```` block no longer means writing the script to a file first. The error now says to resend the source as `options: { script: "..." }`, which runs it directly. (#3056)
+- A fresh child placed on a machine (a Rex tab, a Rex machine over SSH, or a Herdr pane) launches. Every such launch was refused with "does not support fork, resume, or revival" because each child is handed a local session file path, which placement read as a request to restore a transcript. Builtin agents with a tools list, such as `scout`, can be placed too: their required tools are checked against the tools the remote Pi activates. Forked context is still refused on a machine, and so is a resume that would place the child again, since a placed child's transcript stays on that machine. Thanks to [@honbolau](https://github.com/honbolau) for the report and [@isjiajia01](https://github.com/isjiajia01) for tracing it. (#3043)
+- A misspelled field in a `subagents.agentOverrides` or `agentOverridesByProvider` entry, such as `modle`, was ignored; loading now fails with the settings file, the field, and the nearest known name (`Did you mean 'model'?`). An override's `thinking` must now be a known level (`off` through `max`) or `false`; a typo such as `hgih` used to be appended to the child's model id. Creating or updating an agent with the `subagent` tool now rejects such a level too, instead of writing it into the agent file. Thanks to [@isjiajia01](https://github.com/isjiajia01) for the report. (#3050)
+- Creating an agent with `thinking: off`, or updating one to ` off ` with spaces, now saves `thinking: off` in the agent file. Before, the line was left out, so the agent used the default thinking level instead of none.
+- `extensionBindings` now reach foreground children. Before, an extension in a foreground child saw no `PI_SUBAGENT_EXTENSION_BINDINGS`, or the bindings of the background child that launched it. A foreground child now gets its own bindings while its extensions load and run `session_start`, and the parent's environment is restored afterwards. Thanks to [@crisboarna](https://github.com/crisboarna). (#3049)
+- Workflows no longer crash on Windows standalone Pi builds (Bun 1.3.14) once Bun's transpiler cache is warm. The workflow worker now starts from a file in the package. Thanks to [@temoc](https://github.com/temoc). (#3055)
+- `subagent` calls from providers that send nested tool values as strings, such as `options: { capabilities: "true", timeoutMs: "120000" }`, no longer fail with "must be boolean" or "must be integer". Values inside `options` now get the same type conversion Pi already applies to top-level parameters. Thanks to [@5hiri](https://github.com/5hiri) for the report and [@isjiajia01](https://github.com/isjiajia01) for narrowing it down. (#3048)
+- Child transcripts in `/subagents-fleet`, `subagent` status and inspect replies show each tool call's input (`[tool: bash {"command":"ls"}]`) instead of only the tool name. Thanks to [@kunkun9527](https://github.com/kunkun9527) for the report. (#3053)
+
+## [0.82.1] - 2026-10-24
+
+### Highlights
+
+- A run with a damaged status file no longer hides your other runs from `/subagents-fleet` and status listings.
+- The bundled skill costs about 3k tokens per use instead of 10.6k, and agents following it block on a child less often.
+- On Opus 5.5, Sonnet 5.5 and Fable 5.1, a workflow launch that loses its script recovers on the next try instead of failing again.
+
+### Changed
+
+- The bundled `pi-subagents` skill is about a quarter of its old size: about 3k tokens per use instead of 10.6k. It keeps the common calls, the workflow and resume examples, and the rules for when and how to delegate, and points to the `guide` sections for everything else instead of copying the reference docs. In testing, agents using it blocked on a child with `async: false` 2 times in 39 tasks instead of 10. `/council` no longer loads an extra 11k-token reference.
+- On Claude 5.x models (Opus 5.5, Sonnet 5.5, Fable 5.1), text written after a tool call reaches Pi only as a short summary without code blocks, so a ```` ```js workflow ```` block written at that point is lost and `subagent({ workflow: true })` can't find it. The error now explains this and tells the agent to pass the script as a file for the rest of the turn, and the bundled skill tells these models to use a file from the start once the turn has made a tool call.
+
+### Fixed
+
+- A recent background run whose `status.json` no longer parses, for example a file filled with NUL bytes, no longer stops `/subagents-fleet` and status listings from showing your other runs. The run is skipped with one warning, shown as a notice while `/subagents-fleet` is open, which repeats only if the file changes. Its files are left as they are, and asking for that run by id still reports the parse error. Thanks to [@ozand](https://github.com/ozand) for #3040 and #3041.
+
 ## [0.82.0] - 2026-10-24
 
 ### Highlights

package/README.md

@@ -62,7 +62,7 @@ The extension ships with agents you can use immediately:
 | `researcher` | Web/docs research with sources and a concise research brief. Requires [pi-web-access in the child](docs/agents.md#web-research-prerequisites). |
 | `evidence-auditor` | Independently checks whether important research claims are supported by their sources. Requires [pi-web-access in the child](docs/agents.md#web-research-prerequisites). |
 | `worker` | Implementation work. Edits files, validates, escalates unapproved decisions instead of guessing. |
-| `reviewer` | Code review and small fixes against the task/plan, tests, edge cases, and simplicity. |
+| `reviewer` | Read-only code review against the task/plan, tests, edge cases, and simplicity. |
 | `oracle` | A second opinion before acting. Challenges assumptions without editing. |
 | `delegate` | A lightweight general delegate that behaves close to the parent session. |
 

package/bundle/agents.js

@@ -2,12 +2,12 @@ import {
   RUNTIME_AGENT_REGISTER_EVENT,
   RUNTIME_AGENT_REGISTER_VERSION,
   registerAgentViaEvents
-} from "./chunk-43SCHIMD.js";
+} from "./chunk-MBDOYZ2V.js";
 import {
   registerRuntimeAgent
-} from "./chunk-YKEWIB4M.js";
-import "./chunk-CIZQXJ5Q.js";
-import "./chunk-5LFLVSTM.js";
+} from "./chunk-JHZ6DZ5M.js";
+import "./chunk-7F5SK2U3.js";
+import "./chunk-JEZOSEWG.js";
 import "./chunk-YFCK7H2S.js";
 import "./chunk-Z7KVHQHL.js";
 export {

package/bundle/background-work.js

@@ -5,7 +5,7 @@ import {
   listBackgroundWorkWakeChannels,
   registerBackgroundWorkProvider,
   snapshotBackgroundWork
-} from "./chunk-N2BN7BF5.js";
+} from "./chunk-XA3DY6UG.js";
 export {
   BACKGROUND_WORK_PROTOCOL_VERSION,
   BACKGROUND_WORK_REGISTRY_KEY,

package/bundle/child-tool-plan.js

@@ -1,9 +1,9 @@
 import {
   resolvePiLaunchToolPlan
-} from "./chunk-4SDU2BZX.js";
+} from "./chunk-CSSZRTKY.js";
 import "./chunk-CTPAE36Y.js";
-import "./chunk-CIZQXJ5Q.js";
-import "./chunk-5LFLVSTM.js";
+import "./chunk-7F5SK2U3.js";
+import "./chunk-JEZOSEWG.js";
 import "./chunk-YFCK7H2S.js";
 import "./chunk-Z7KVHQHL.js";
 export {

package/bundle/{chunk-7PCKZHR5.js → chunk-4BW55BTL.js}

@@ -13,7 +13,7 @@ import {
   summarizeContextModes,
   utf8Tail,
   workflowPreflightLaneForRuntimeKey
-} from "./chunk-VH5OAWVG.js";
+} from "./chunk-OOFW75PV.js";
 import {
   assertSafeNestedId,
   checkRecordedPidLiveness,
@@ -32,11 +32,11 @@ import {
   updateActiveRunIndex,
   validateModelResponseAliases,
   writeAsyncResultFile
-} from "./chunk-NRQ75MGH.js";
+} from "./chunk-5ESXK62X.js";
 import {
   deliverStopRequest,
   stopInboxClosedPath
-} from "./chunk-OYF6AFDY.js";
+} from "./chunk-BKFWQ642.js";
 import {
   SUBAGENT_STOPPED_MESSAGE,
   formatDuration,
@@ -47,10 +47,10 @@ import {
   validateAcceptanceInput,
   writeAtomicJson,
   writePrivateAtomicJson
-} from "./chunk-CIZQXJ5Q.js";
+} from "./chunk-7F5SK2U3.js";
 import {
   DIRS
-} from "./chunk-5LFLVSTM.js";
+} from "./chunk-JEZOSEWG.js";
 import {
   safeTerminalText,
   truncateDisplayText
@@ -292,7 +292,7 @@ function sessionMessageParts(record) {
     }
     if (entry.type === "toolCall" || entry.type === "tool_call") {
       const name = typeof entry.name === "string" ? entry.name : typeof entry.toolName === "string" ? entry.toolName : "tool";
-      parts.push({ role, kind: "toolCall", name, text: `[tool: ${name}${entry.args === void 0 ? "" : ` ${stringifyJsonPreview(entry.args)}`}]` });
+      parts.push({ role, kind: "toolCall", name, text: `[tool: ${name}${entry.arguments === void 0 ? "" : ` ${stringifyJsonPreview(entry.arguments)}`}]` });
       continue;
     }
     if (entry.type === "toolResult" || entry.type === "tool_result") {

package/bundle/{chunk-7IVSUMQQ.js → chunk-527E3D2J.js}

@@ -1,13 +1,13 @@
 import {
   isTrustedRecordedSessionFile,
   resolveSubagentRunId
-} from "./chunk-7PCKZHR5.js";
+} from "./chunk-4BW55BTL.js";
 import {
   agentStreamOptions,
   opencodeSessionHeaders,
   ownsRun,
   resolveAsyncResumeTarget
-} from "./chunk-VH5OAWVG.js";
+} from "./chunk-OOFW75PV.js";
 import {
   currentCompletionOwnerId,
   listMissions,
@@ -16,12 +16,12 @@ import {
   reconcileAsyncRun,
   resolveAuthorityDecision,
   resolveMissionStoreLocation
-} from "./chunk-NRQ75MGH.js";
+} from "./chunk-5ESXK62X.js";
 import {
   deliverInterruptRequest,
   queueRevivalBrief,
   requestAsyncSteer
-} from "./chunk-OYF6AFDY.js";
+} from "./chunk-BKFWQ642.js";
 import {
   formatShellCommand
 } from "./chunk-7J4ZXMY7.js";
@@ -32,10 +32,10 @@ import {
   tryLease,
   writeAtomicJson,
   writePrivateAtomicJson
-} from "./chunk-CIZQXJ5Q.js";
+} from "./chunk-7F5SK2U3.js";
 import {
   DIRS
-} from "./chunk-5LFLVSTM.js";
+} from "./chunk-JEZOSEWG.js";
 import {
   previewDisplayText,
   safeTerminalText