pi-subagents 0.79.2 → 0.81.0

package/CHANGELOG.md

@@ -2,6 +2,62 @@
 
 ## [Unreleased]
 
+## [0.81.0] - 2026-10-22
+
+### Highlights
+
+- Pi starts faster on Windows. pi-subagents now loads from about 30 files instead of about 240, which cut its load time from about 2.0 s to about 1.1 s on a Windows machine with Defender.
+- Pi no longer freezes for about 8 seconds on every Windows start when the subagent temp folder has broken permissions.
+- A child with an `outputSchema` that forgets to call `structured_output` gets one more turn to call it instead of failing and losing its work.
+- The parent model can tell subagent notices apart from text you typed.
+- In fullscreen FleetView you can click a child to select it and scroll its output with the mouse wheel or trackpad.
+
+### Added
+
+- In fullscreen mode, the FleetView inspector now selects a child when you click its roster row and scrolls the output pane with the mouse wheel or trackpad, without scrolling the conversation behind it. Keyboard controls are unchanged. Thanks to [@IdrisGit](https://github.com/IdrisGit) for #2992.
+- Structured delegation `:update` and `:response` events now carry an optional `providerDiagnostics` field, so a host extension can tell a child stuck in provider retry backoff (for example HTTP 429) from a long model turn. It reports the count and kind of failed requests and Pi's current retry phase, never the raw provider error. See [docs/extension-api.md](docs/extension-api.md). Thanks to [@IdrisGit](https://github.com/IdrisGit) for #2999 and [@legendtang](https://github.com/legendtang) for [#2991](https://github.com/nicobailon/pi-subagents/issues/2991).
+
+### Changed
+
+- A native Pi child with an `outputSchema` that ends its run without calling `structured_output` now gets one follow-up turn in the same session asking it to call `structured_output` without repeating the work. Before, the run failed at once with "Missing structured_output call" and all of the child's work was lost. If the child still does not call it, the run fails with the same error as before. The extra turn counts toward the run's usage and is still bounded by the run's timeout. A call that `structured_output` rejects does not get this turn, because the tool already returns the validation error to the child. Thanks to [@legendtang](https://github.com/legendtang) for [#2997](https://github.com/nicobailon/pi-subagents/issues/2997).
+- When the `parallel` workflow's args or tasks, a `tasks` item, or a chain step include `worktree` or another setting that only works for the whole call, the error now says to put it on the `subagent` call itself, where it applies to every child. The tool description is unchanged, so ordinary requests use no extra tokens. Thanks to [@jinglebiscuits](https://github.com/jinglebiscuits) for [#3009](https://github.com/nicobailon/pi-subagents/issues/3009) and #3010.
+
+### Fixed
+
+- Loading pi-subagents at Pi startup took 0.3 to 2.7 s on Windows, because Pi loaded about 240 separate files and Windows security software scanned each one. The npm package now ships the extension and its subpath exports as a bundle of about 30 files. On a Windows machine with Defender, loading drops from about 2.0 s to about 1.1 s; on macOS it is about 8% faster. Child processes still run from the unbundled files, and the subagent executor still loads after startup. The unpacked package grows from 6.9 MB to 10.8 MB. Thanks to [@kiote](https://github.com/kiote) for #3006, and to [@tututuhehehe](https://github.com/tututuhehehe) and [@localhedge](https://github.com/localhedge) for the measurements in [#2980](https://github.com/nicobailon/pi-subagents/issues/2980).
+- On Windows, Pi could freeze for about 8 seconds on every start when the subagent temp results folder had broken permissions (`EPERM`/`EACCES`), because the startup check kept retrying before it switched to a fallback folder. The startup check now gives up after at most 85 ms per operation; result writes and other file operations keep their full retries. Thanks to [@821869798](https://github.com/821869798) for [#2998](https://github.com/nicobailon/pi-subagents/issues/2998).
+- The parent model can now tell subagent notices from text you typed. Pi sends extension messages to the model as ordinary user messages, so a completion notice that started a turn on its own looked like a user request. pi-subagents notices the model sees, including completion and supervisor notices, wait results and `/run` results, are now wrapped in a `<pi_subagents_notice>` tag that names the message type and says it is an automated message from pi-subagents. Only the model request changes; the stored transcript and the chat view stay the same. Thanks to [@ktheunlikedoll](https://github.com/ktheunlikedoll) for [#2994](https://github.com/nicobailon/pi-subagents/issues/2994) and [@isjiajia01](https://github.com/isjiajia01) for the context-hook approach.
+- YAML comments in agent frontmatter lists changed the parsed values. An indented `# note` in a `tools:` list became a tool name, a column-zero comment dropped every item after it, and a trailing `# why` stayed on a `- item` line. Comments are now ignored in frontmatter lists; `#` inside quoted values and `|`/`>` block scalars is kept. Thanks to [@builtroller](https://github.com/builtroller) for [#2995](https://github.com/nicobailon/pi-subagents/issues/2995).
+- When a workflow child's process died without writing a result, `mission.show` listed that child as failed in the mission's runs but still running in its workflow children. The failed result recorded for the dead child now keeps its workflow id and key, so the mission marks it failed in both places. Thanks to [@isjiajia01](https://github.com/isjiajia01) for [#3005](https://github.com/nicobailon/pi-subagents/issues/3005).
+
+## [0.80.0] - 2026-10-21
+
+### Highlights
+
+- pi-subagents now needs Pi 1.2.0 or newer. In return, waking an idle parent no longer adds an "Inspect subagent updates above" line to your transcript: the subagent's own notice starts the turn.
+- `parallel`, `tasks` and `chain` children can each set their own `cwd` and `model`, so one call can fan out across repositories or worktrees, or mix models, without writing a workflow script.
+- `enableSlashCommands: false` keeps the `subagent` tool and drops every pi-subagents slash command, for setups that delegate only through the model.
+- The folded widget line shows how long the current batch of work has been running, for example `subagents (1/1 running 13s)`.
+- Windows: Pi no longer exits at startup when security software blocks `git`. DeepSeek and other providers that reuse the Codex Responses wire no longer fail on a child's second tool call.
+
+### Added
+
+- Children of the built-in `parallel` workflow (`args.tasks`), and `tasks` items and `chain` steps and group members when workflow scripts are disabled, accept optional `cwd` and `model`. One call can now fan out across several repositories or worktrees, or mix models, without writing a script. Before, these fields were rejected with "accepts only agent and task". Thanks to [@andresutre](https://github.com/andresutre) for [#2985](https://github.com/nicobailon/pi-subagents/pull/2985).
+- The folded async widget line now shows how long the current stretch of running work has lasted, for example `subagents (1/1 running 13s)`. It counts from the oldest running job, so it stays right after a session resume, and it disappears once nothing is running. Thanks to [@summer-tt](https://github.com/summer-tt) for [#2979](https://github.com/nicobailon/pi-subagents/pull/2979).
+- `enableSlashCommands: false` in the extension config keeps the `subagent` tool and drops every pi-subagents slash command and the foreground-detach shortcut, for setups that delegate only through the model or want fewer global commands. Prompt shortcuts such as `/parallel-review` are Pi prompt templates, and Pi's package filter (`"prompts": []`) already removes them. See [configuration](docs/configuration.md#enableslashcommands). Thanks to [@khavronin-artem](https://github.com/khavronin-artem) for requesting it in [#2977](https://github.com/nicobailon/pi-subagents/issues/2977).
+
+### Changed
+
+- pi-subagents now needs Pi 1.2.0 or newer; Pi 0.86.1 and 1.0.0 are no longer supported. The supported standalone target is now the official Pi 1.2.0 Linux x64 release. Pi 1.2.0 lets an extension message start a turn with the full system prompt, so an idle parent is now woken by the subagent notice itself, and the transcript no longer gets a separate "Inspect subagent updates above" line on every wake. Each notice says what the parent should do next. Thanks to [@summer-tt](https://github.com/summer-tt) for [#2976](https://github.com/nicobailon/pi-subagents/issues/2976).
+- The npm package no longer ships source maps. They pointed at TypeScript sources the package does not include, so nothing could use them, and they were almost half its files: the unpacked install drops from 12.1 MB to 6.8 MB and the download from 2.5 MB to 1.6 MB. Thanks to [@tututuhehehe](https://github.com/tututuhehehe) for reporting it in [#2980](https://github.com/nicobailon/pi-subagents/issues/2980).
+
+### Fixed
+
+- Pi could exit at session start on Windows when security software stopped it from launching `git` (`spawn EPERM`). The watchdog now starts without its diff baseline in that case, as it already did when `git` was missing. Thanks to [@advaitpaliwal](https://github.com/advaitpaliwal) for reporting [#2978](https://github.com/nicobailon/pi-subagents/issues/2978).
+- Children on a custom provider that speaks the Codex Responses wire under its own api id, such as `pi-cliproxyapi`'s `cliproxyapi-codex-responses`, had their tool-call ids rewritten, and DeepSeek rejected the second tool turn with a misleading "`reasoning_text` ... must be passed back" error. Any `*-codex-responses` api now keeps its ids the way `openai-codex-responses` does. Thanks to [@xspeed1989](https://github.com/xspeed1989) for reporting [#2981](https://github.com/nicobailon/pi-subagents/issues/2981).
+- Subagent cards said "Configure the expand key for live detail" when Pi's keybindings were not loaded, for example in an HTML session export, although the key was bound (`ctrl+o` by default). They now say "Press the expand key for live detail", and in RPC mode the status line of slash-command launches such as `/run` no longer shows an empty key (`3 tools |  live detail`). Thanks to [@JohannesBertens](https://github.com/JohannesBertens) for [#2983](https://github.com/nicobailon/pi-subagents/pull/2983) ([#2982](https://github.com/nicobailon/pi-subagents/issues/2982)).
+- On Pi 1.2, a child's bash command that exited non-zero showed as `completed` in `subagent_command` status. It now shows as `failed`.
+
 ## [0.79.2] - 2026-10-20
 
 ### Highlights

package/README.md

@@ -14,7 +14,7 @@
 pi install npm:pi-subagents
 ```
 
-That is the only required step. Background children use the host's SDK: npm Pi keeps its detached Node runner; the official Pi 0.86.1 Linux x64 standalone release loads the same runner through Pi's embedded SDK, without a separate SDK install. See [Standalone background execution](docs/standalone-background.md) for the supported boundary and validation gate.
+That is the only required step. pi-subagents needs Pi 1.2.0 or newer. Background children use the host's SDK: npm Pi keeps its detached Node runner; the official Pi 1.2.0 Linux x64 standalone release loads the same runner through Pi's embedded SDK, without a separate SDK install. See [Standalone background execution](docs/standalone-background.md) for the supported boundary and validation gate.
 
 ## Try this first
 

package/bundle/agents.js

@@ -0,0 +1,18 @@
+import {
+  RUNTIME_AGENT_REGISTER_EVENT,
+  RUNTIME_AGENT_REGISTER_VERSION,
+  registerAgentViaEvents
+} from "./chunk-LSRUTHT7.js";
+import {
+  registerRuntimeAgent
+} from "./chunk-3IF2PGW7.js";
+import "./chunk-ZBC44JJ3.js";
+import "./chunk-5LFLVSTM.js";
+import "./chunk-YFCK7H2S.js";
+import "./chunk-Z7KVHQHL.js";
+export {
+  RUNTIME_AGENT_REGISTER_EVENT,
+  RUNTIME_AGENT_REGISTER_VERSION,
+  registerRuntimeAgent as registerAgent,
+  registerAgentViaEvents
+};

package/bundle/background-work.js

@@ -0,0 +1,16 @@
+import {
+  BACKGROUND_WORK_PROTOCOL_VERSION,
+  BACKGROUND_WORK_REGISTRY_KEY,
+  listBackgroundWorkProviders,
+  listBackgroundWorkWakeChannels,
+  registerBackgroundWorkProvider,
+  snapshotBackgroundWork
+} from "./chunk-N2BN7BF5.js";
+export {
+  BACKGROUND_WORK_PROTOCOL_VERSION,
+  BACKGROUND_WORK_REGISTRY_KEY,
+  listBackgroundWorkProviders,
+  listBackgroundWorkWakeChannels,
+  registerBackgroundWorkProvider,
+  snapshotBackgroundWork
+};

package/bundle/capability-ceiling.js

@@ -0,0 +1,22 @@
+import {
+  SUBAGENT_CAPABILITY_CEILING_REGISTRY_KEY,
+  SUBAGENT_CAPABILITY_CEILING_VERSION,
+  decodeSubagentCapabilityCeiling,
+  encodeSubagentCapabilityCeiling,
+  intersectSubagentCapabilityCeilings,
+  parseSubagentCapabilityCeiling,
+  registerSubagentCapabilityCeiling,
+  resolveCurrentSubagentCapabilityCeiling,
+  resolveSubagentCapabilityCeiling
+} from "./chunk-Z7KVHQHL.js";
+export {
+  SUBAGENT_CAPABILITY_CEILING_REGISTRY_KEY,
+  SUBAGENT_CAPABILITY_CEILING_VERSION,
+  decodeSubagentCapabilityCeiling,
+  encodeSubagentCapabilityCeiling,
+  intersectSubagentCapabilityCeilings,
+  parseSubagentCapabilityCeiling,
+  registerSubagentCapabilityCeiling,
+  resolveCurrentSubagentCapabilityCeiling,
+  resolveSubagentCapabilityCeiling
+};

package/bundle/child-tool-plan.js

@@ -0,0 +1,11 @@
+import {
+  resolvePiLaunchToolPlan
+} from "./chunk-G5DKFLLI.js";
+import "./chunk-CTPAE36Y.js";
+import "./chunk-ZBC44JJ3.js";
+import "./chunk-5LFLVSTM.js";
+import "./chunk-YFCK7H2S.js";
+import "./chunk-Z7KVHQHL.js";
+export {
+  resolvePiLaunchToolPlan
+};