@xzzpig/pi-subagents 0.25.0 → 0.25.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +186 -327
- package/FORK-CHANGELOG.md +456 -0
- package/README.md +5 -0
- package/bundle/{chunk-YWXILP5N.js → chunk-6F3YET5B.js} +3 -1
- package/bundle/{chunk-IJWITCC6.js → chunk-6FREVFTI.js} +1 -1
- package/bundle/{chunk-OSVXFWPG.js → chunk-E3EQ7USM.js} +1 -1
- package/bundle/{chunk-IKFKH5EL.js → chunk-FQPV4O6C.js} +25 -189
- package/bundle/{chunk-IUDEI6FJ.js → chunk-MMJQMPOK.js} +37 -0
- package/bundle/{chunk-KCJFGKVK.js → chunk-MQ5X2OJ2.js} +6 -6
- package/bundle/{chunk-6MNRKUHY.js → chunk-VRG6TEPW.js} +1 -1
- package/bundle/{chunk-5YEOWNSD.js → chunk-YDZFAQAV.js} +307 -273
- package/bundle/index.js +1 -1
- package/node_modules/@xzzpig/pi-components/CHANGELOG.md +4 -0
- package/node_modules/@xzzpig/pi-components/README.md +22 -0
- package/node_modules/@xzzpig/pi-components/dist/src/diff.d.ts +74 -0
- package/node_modules/@xzzpig/pi-components/dist/src/diff.js +355 -0
- package/node_modules/@xzzpig/pi-components/package.json +4 -0
- package/package.json +2 -1
- package/src/runs/foreground/execution.js +21 -69
- package/src/runs/foreground/fork-tool-result-handler.d.ts +60 -0
- package/src/runs/foreground/fork-tool-result-handler.js +83 -0
- package/src/shared/fleet-transcript-reader.d.ts +13 -0
- package/src/shared/fleet-transcript-reader.js +43 -0
- package/src/tui/fleet-native-transcript.js +1 -1
- package/src/tui/fleet-transcript.d.ts +1 -57
- package/src/tui/fleet-transcript.js +4 -370
|
@@ -0,0 +1,456 @@
|
|
|
1
|
+
# Fork Changelog
|
|
2
|
+
|
|
3
|
+
Release history for `@xzzpig/pi-subagents`; version headings refer only to this fork.
|
|
4
|
+
Upstream history: [CHANGELOG.md](./CHANGELOG.md).
|
|
5
|
+
Current upstream baseline (not a claim about older releases): [v0.88.0 / c99503aed6d6](https://github.com/nicobailon/pi-subagents/tree/c99503aed6d6b20d2397a1767f7d60730efe3963).
|
|
6
|
+
|
|
7
|
+
Historical entries below were migrated from the repository's existing changelogs; missing dates and historical baselines have not been invented.
|
|
8
|
+
|
|
9
|
+
### Undated historical fork changes
|
|
10
|
+
|
|
11
|
+
These notes were already present without a release version; they are not new unreleased changes.
|
|
12
|
+
|
|
13
|
+
#### Previous fork changes
|
|
14
|
+
|
|
15
|
+
### Changed
|
|
16
|
+
|
|
17
|
+
- **Synced upstream `v0.74.0` → `v0.75.0`**: background subagents work on Pi 1.0.0
|
|
18
|
+
again (upstream's own fix for the dropped `@earendil-works/pi-agent-core/node`;
|
|
19
|
+
the fork's best-effort `resolveHostPeerAliases` already covered this), per-launch
|
|
20
|
+
Claude Code `model`/`thinking` (`:level`/`--effort`, enforced by
|
|
21
|
+
`subagents.maxThinking`/`modelScope`), `registerRequiredChildExtensions`
|
|
22
|
+
`requireForAllRunners`, child launches on extension-registered virtual models with
|
|
23
|
+
corrected verification (`session?.virtualModelId`), failing config load on invalid
|
|
24
|
+
`authorityPolicy`/`permissions`/`toolBudget` values, async runs recorded in
|
|
25
|
+
`run-history.jsonl`, MCP tool-name `-`→`_` conversion, parent-side bash
|
|
26
|
+
`command.status`/`yield`/`cancel` for native children, and Windows npm-installed
|
|
27
|
+
external CLIs. The fork's projectTrusted threading, `hostAvailableBuiltins`
|
|
28
|
+
(`getHostBuiltinToolNames`), `sandbox`/`permission-profile` agent fields,
|
|
29
|
+
env-capture restore, `.then(() => undefined)` steer/followUp wrappers, and the
|
|
30
|
+
`projectScopedProfileTrustError` import were re-applied beside upstream's changes.
|
|
31
|
+
|
|
32
|
+
- **Synced upstream `v0.72.0` → `v0.74.0`**: fenced ```` ```js workflow ```` blocks
|
|
33
|
+
replacing `workflowScript`/`workflowScriptPath` (`workflow: true`), `toolActivation`
|
|
34
|
+
(eager/dynamic/auto) and `disabledFeatures` config, Pi built-in MCP selections
|
|
35
|
+
(`mcp:` tools, codemode in children), `subagents.modelScope` `scoped` token,
|
|
36
|
+
`agentOverrides.<name>.advertise`, untrusted-project respect for children,
|
|
37
|
+
`/reload` no longer killing background workflows, and the undici 8.10.2 security
|
|
38
|
+
bump. The fork's projectTrusted/sandbox/permissionProfile threading, native
|
|
39
|
+
fleet transcript, context injection, and `as StreamFn` casts were re-applied;
|
|
40
|
+
upstream's duplicate `sessionProjectTrust` fields were dropped in favor of the
|
|
41
|
+
fork's `currentProjectTrusted`/`trustedProjectCwd`. The shim fixture gains the
|
|
42
|
+
Pi 1.0.0 normalized `systemPromptOptions` shape.
|
|
43
|
+
- Peer range follows the workspace Pi 1.0.0 baseline (`>=1.0.0 <2` for pi-ai);
|
|
44
|
+
devDeps pin pi-agent-core/pi-ai/pi-tui at exact `1.0.0` per the fork manifest
|
|
45
|
+
invariant.
|
|
46
|
+
- Synced upstream `v0.71.0` → `v0.72.0`: lazy subagent executor/Fleet loading,
|
|
47
|
+
global npm root discovery for package agents, external inspector
|
|
48
|
+
registration (`pi-subagents/inspectors` API, lazy `openSubagentFleet`
|
|
49
|
+
loading with the `getInspectorPlugins` getter), fast-mode accepting any
|
|
50
|
+
native `openai-codex/*` model via provider-prefix matching, watchdog helper
|
|
51
|
+
model calls routed through `modelRegistry.streamSimple`, `typebox` moved to
|
|
52
|
+
an optional peer dependency, and the `before_agent_start` advertised-agent
|
|
53
|
+
wait. The fork's `events`/inspector wiring, context injection,
|
|
54
|
+
sandbox/permission-profile threading, and the eject delegation were
|
|
55
|
+
re-applied on top; SDK pins stay at pi `0.87.0` (upstream pairing) with the
|
|
56
|
+
fork's `as StreamFn` casts extended to the three retargeted watchdog/audit
|
|
57
|
+
stream call sites.
|
|
58
|
+
- Synced upstream `v0.68.0` → `v0.71.0`: workflow terminal proof and readable
|
|
59
|
+
child session names, runner-side stripping of inherited Git routing
|
|
60
|
+
environment, symlinked prompt workflow file discovery, runner exit
|
|
61
|
+
code/signal reporting for dead runners, structured-only child terminal
|
|
62
|
+
settlement, compiled Bun host package root discovery, and the
|
|
63
|
+
`subagent-runner-bootstrap` entry with tool-activation smoke coverage.
|
|
64
|
+
- SDK baseline raised to pi `0.87.0` (devDependencies); the
|
|
65
|
+
`pi-coding-agent` type/runtime shim gains the `streamSimple` registry
|
|
66
|
+
member.
|
|
67
|
+
- Fork `sandbox` / `permissionProfile` / `hostAvailableBuiltins` threading
|
|
68
|
+
and the fleet-native transcript renderer were re-applied on top of the
|
|
69
|
+
upstream runner refactor; upstream's removal of `completionGuard` was
|
|
70
|
+
adopted.
|
|
71
|
+
|
|
72
|
+
## [0.25.2] - 2026-11-20
|
|
73
|
+
|
|
74
|
+
### Fixed
|
|
75
|
+
|
|
76
|
+
- Pi now reads the fork changelog instead of the upstream release history, so
|
|
77
|
+
startup no longer repeatedly renders unrelated upstream updates. Both histories
|
|
78
|
+
remain available in the package.
|
|
79
|
+
|
|
80
|
+
## [0.25.1] - 2026-11-15 (fork)
|
|
81
|
+
|
|
82
|
+
### Changed
|
|
83
|
+
|
|
84
|
+
- **Conflict-surface refactor, no behavior change.** Fleet transcript reading now
|
|
85
|
+
lives in one shared reader (`shared/fleet-transcript-reader.ts`); the TUI fleet
|
|
86
|
+
pane only keeps its renderer, so both the run-status and transcript views parse
|
|
87
|
+
child sessions through the same code.
|
|
88
|
+
- The fork's tool-result handler moved out of the upstream run closure into
|
|
89
|
+
fork-only `src/runs/foreground/fork-tool-result-handler.ts` (budget blocking,
|
|
90
|
+
mutating-failure escalation, supervisor progress publication, bounded
|
|
91
|
+
call-id de-duplication unchanged); `execution.ts` keeps one factory call.
|
|
92
|
+
- Packaging identity (repository URL, files allowlist, lockfile policy) is
|
|
93
|
+
enforced by `scripts/check-fork-identity.mjs` instead of per-package replay prose.
|
|
94
|
+
|
|
95
|
+
## [0.25.0] - 2026-11-13 (fork)
|
|
96
|
+
|
|
97
|
+
### Changed
|
|
98
|
+
|
|
99
|
+
- **Synced upstream `v0.84.0` → `v0.88.0`**: latest child progress in the
|
|
100
|
+
widget, paused `timeoutMs` while a child waits for a supervisor answer,
|
|
101
|
+
monotonic run clocks, truncated-reply detection, `list` search filter,
|
|
102
|
+
forked-session cleanup, workflow child-launch approval through `tool_call`
|
|
103
|
+
handlers, editor-hint API, and Pi Desktop / Windows / MCP fixes.
|
|
104
|
+
- Re-applied every fork seam on the new upstream shapes: supervisor responder
|
|
105
|
+
side channel (with upstream's `endedRequests` lifecycle), context injection,
|
|
106
|
+
sandbox/permission profiles, goal auto-continuation gate, native Fleet
|
|
107
|
+
transcripts, host-available builtins, tool-budget blocked detection, and the
|
|
108
|
+
`@xzzpig` package identity.
|
|
109
|
+
- Extended the lightweight SDK shim with the Pi 1.2 `ExtensionToolContext` /
|
|
110
|
+
`ToolDefinition.exposure` surface used by the new deferred
|
|
111
|
+
`subagent_launch` tool, and registered the new upstream real-SDK test in
|
|
112
|
+
`fork-test-environment.mjs`.
|
|
113
|
+
- Kept the fork's shared `handleToolResult` dedup path for tool results while
|
|
114
|
+
adopting upstream's `progressText` propagation so the widget shows the
|
|
115
|
+
latest successful child progress.
|
|
116
|
+
|
|
117
|
+
### Upstream provenance
|
|
118
|
+
|
|
119
|
+
- Upstream v0.84.0: [source 0398b9e8d6f0](https://github.com/nicobailon/pi-subagents/tree/0398b9e8d6f03dc6054dbf13dfe851c7a20bff3a); [recorded sync metadata](https://github.com/xzzpig/pi-extensions/blob/f9e51d2d2c3116fd3ae63ed4e19d0ea1eeb1bf82/subtrees/pi-subagents.json).
|
|
120
|
+
- Upstream v0.88.0: [source c99503aed6d6](https://github.com/nicobailon/pi-subagents/tree/c99503aed6d6b20d2397a1767f7d60730efe3963); [recorded sync metadata](https://github.com/xzzpig/pi-extensions/blob/49ccf05e5135153bb7c3cb4e47e408b84cd38374/subtrees/pi-subagents.json).
|
|
121
|
+
|
|
122
|
+
## [0.24.2] - 2026-11-01 (fork)
|
|
123
|
+
|
|
124
|
+
### 维护
|
|
125
|
+
|
|
126
|
+
- 同步内嵌共享库依赖至 pi-components 0.5.0;fleet 继续使用既有无状态渲染入口,不隐式启用新的有状态展示策略。
|
|
127
|
+
|
|
128
|
+
## [0.24.1] - 2026-10-31 (fork)
|
|
129
|
+
|
|
130
|
+
### Fixed
|
|
131
|
+
|
|
132
|
+
- Coordinate goal auto-continuation with current-session async, workflow and
|
|
133
|
+
detached foreground runs while their native parent wake or result handoff is
|
|
134
|
+
pending. Preserve completion ownership and scheduled wake policy through
|
|
135
|
+
live and restored job projections without intercepting native notifications.
|
|
136
|
+
|
|
137
|
+
## [0.24.0] - 2026-10-30 (fork)
|
|
138
|
+
|
|
139
|
+
### Security
|
|
140
|
+
|
|
141
|
+
- Sync upstream `v0.83.1` → `v0.84.0`, including the workflow-script sandbox
|
|
142
|
+
hardening for GHSA-6v8j-6w28-2w8r and the corresponding regression tests.
|
|
143
|
+
|
|
144
|
+
### Changed
|
|
145
|
+
|
|
146
|
+
- Adopt upstream's 90-day retention window for resumable background runs and
|
|
147
|
+
results, while retaining its existing reference and active-run protections.
|
|
148
|
+
- Explain when a background child cannot load an extension-provided model while
|
|
149
|
+
preserving the fork's trust, sandbox, and permission-profile launch seams.
|
|
150
|
+
|
|
151
|
+
### Upstream provenance
|
|
152
|
+
|
|
153
|
+
- Upstream v0.83.1: [source 312082429bda](https://github.com/nicobailon/pi-subagents/tree/312082429bda07714fe0fe7729fe8d4935de4c5a); [recorded sync metadata](https://github.com/xzzpig/pi-extensions/blob/ba8b518d6237d5ce6b43353dc2f735832d743ecb/subtrees/pi-subagents.json).
|
|
154
|
+
- Upstream v0.84.0: [source 0398b9e8d6f0](https://github.com/nicobailon/pi-subagents/tree/0398b9e8d6f03dc6054dbf13dfe851c7a20bff3a); [recorded sync metadata](https://github.com/xzzpig/pi-extensions/blob/f9e51d2d2c3116fd3ae63ed4e19d0ea1eeb1bf82/subtrees/pi-subagents.json).
|
|
155
|
+
|
|
156
|
+
## [0.23.0] - 2026-10-29 (fork)
|
|
157
|
+
|
|
158
|
+
### Changed
|
|
159
|
+
|
|
160
|
+
- Sync upstream `v0.77.0` → `v0.83.1`, including session-scoped background
|
|
161
|
+
lifecycle, held wakes and notification recovery, Rex placement, and the
|
|
162
|
+
`undici` 8.12.3 security update. The minimum supported Pi version is 1.2.
|
|
163
|
+
- Publish the compiled, bundled `dist-pkg` artifact while retaining the fork's
|
|
164
|
+
public subpaths, supervisor routing, native Fleet transcript, and bundled
|
|
165
|
+
`pi-components` dependency.
|
|
166
|
+
- Foreground children receive their own extension bindings without inheriting
|
|
167
|
+
the parent's bindings; permission profiles remain pinned and the parent
|
|
168
|
+
process environment is restored after startup.
|
|
169
|
+
- Failed child commands return Pi's error result with a failed command status
|
|
170
|
+
instead of throwing, so later commands can still run.
|
|
171
|
+
|
|
172
|
+
### Upstream provenance
|
|
173
|
+
|
|
174
|
+
- Upstream v0.77.0: [source 1ac9b964eb9c](https://github.com/nicobailon/pi-subagents/tree/1ac9b964eb9cda1662507c52f5277764637daccc); [recorded sync metadata](https://github.com/xzzpig/pi-extensions/blob/7ecf2299f09844d1730e6b86af8d791a6453e899/subtrees/pi-subagents.json).
|
|
175
|
+
- Upstream v0.83.1: [source 312082429bda](https://github.com/nicobailon/pi-subagents/tree/312082429bda07714fe0fe7729fe8d4935de4c5a); [recorded sync metadata](https://github.com/xzzpig/pi-extensions/blob/ba8b518d6237d5ce6b43353dc2f735832d743ecb/subtrees/pi-subagents.json).
|
|
176
|
+
|
|
177
|
+
## [0.22.0]
|
|
178
|
+
|
|
179
|
+
### Added
|
|
180
|
+
|
|
181
|
+
- 新增 `@xzzpig/pi-subagents/supervisor-routing` 导出:版本化的父会话内 supervisor 响应器注册
|
|
182
|
+
(`registerSupervisorResponderViaEvents`),作用域为 sessionId + delegation requestId + ownerRunId + nodeId + agent。
|
|
183
|
+
- 结构化委派执行器新增内部 launch hooks:在真实 foreground runId 分配、canonical agent 解析之后、
|
|
184
|
+
任何 child prompt 之前触发 `beforeNativeChildLaunch`,不改变模型可见的 request schema 或子进程环境。
|
|
185
|
+
- 原生 supervisor 通道支持独占接管:被接管的提问不再唤醒主模型、不再触发 detach,回复仍走文件权威写入。
|
|
186
|
+
|
|
187
|
+
## [0.21.0] - 2026-10-10 (fork)
|
|
188
|
+
|
|
189
|
+
### Changed
|
|
190
|
+
|
|
191
|
+
- Sync upstream `v0.75.0` → `v0.77.0`: slimmer tool declarations, bounded inline
|
|
192
|
+
result previews, opt-in native runner launchers, calendar schedules, reviewed
|
|
193
|
+
worktree cleanup, reliable parent wakes, and canonical mission storage paths.
|
|
194
|
+
- Context injection now excludes untrusted project contributions and refreshes
|
|
195
|
+
across trust changes without retaining a stale project advertisement.
|
|
196
|
+
- Preserve sandbox/permission profiles, context injection, native Fleet transcripts,
|
|
197
|
+
and the Pi 1.0.0 baseline; align the test fixture with the SDK APIs used upstream.
|
|
198
|
+
|
|
199
|
+
### Fixed
|
|
200
|
+
|
|
201
|
+
- Read each tool result's own tool name before the pending-call fallback, so an
|
|
202
|
+
overlapping blocked bash call is not attributed to an unfinished read.
|
|
203
|
+
- Retry failed native Fleet transcript reads without caching the failure.
|
|
204
|
+
- Preserve permission-profile enforcement when native launchers route children to
|
|
205
|
+
background runners, including explicit empty extension lists.
|
|
206
|
+
- Treat Pi 1 command `isError` results as failures while retaining targeted
|
|
207
|
+
cancellation and run-abort semantics.
|
|
208
|
+
|
|
209
|
+
### Upstream provenance
|
|
210
|
+
|
|
211
|
+
- Upstream v0.75.0: [source ad56bf92fe01](https://github.com/nicobailon/pi-subagents/tree/ad56bf92fe01a2a5abd962938c619eb2a22ca47d); [recorded sync metadata](https://github.com/xzzpig/pi-extensions/blob/c34d3358f81d7fabbe7b0b337be406d2d1739eb0/subtrees/pi-subagents.json).
|
|
212
|
+
- Upstream v0.77.0: [source 1ac9b964eb9c](https://github.com/nicobailon/pi-subagents/tree/1ac9b964eb9cda1662507c52f5277764637daccc); [recorded sync metadata](https://github.com/xzzpig/pi-extensions/blob/7ecf2299f09844d1730e6b86af8d791a6453e899/subtrees/pi-subagents.json).
|
|
213
|
+
|
|
214
|
+
## [0.16.0] - 2026-09-22
|
|
215
|
+
|
|
216
|
+
### Changed
|
|
217
|
+
|
|
218
|
+
- **A child in a subdirectory of a trusted project inherits the sandbox trust
|
|
219
|
+
stamp** (OpenSpec change `add-project-scoped-profiles`). The launcher's
|
|
220
|
+
`PI_SUBAGENT_SANDBOX_PROJECT_TRUSTED` emission (`hasTrustedProfileProjectCwd`)
|
|
221
|
+
now treats a child cwd equal to or a descendant of the parent session's
|
|
222
|
+
trusted project cwd as trusted, matching the platform's
|
|
223
|
+
`findNearestTrustEntry` ancestor semantics, so a project's sandbox-profile
|
|
224
|
+
definitions apply from any subdirectory of a trusted project root instead of
|
|
225
|
+
only from the exact root cwd. The selection-side `projectScopedProfileTrustError`
|
|
226
|
+
guard keeps its exact-cwd matching unchanged.
|
|
227
|
+
|
|
228
|
+
## [0.15.1] - 2026-09-19
|
|
229
|
+
|
|
230
|
+
### Changed
|
|
231
|
+
|
|
232
|
+
- **Conflict-surface refactor, no behavior change.** The agent-eject implementation moved to fork-only `src/agents/agent-eject.ts`; the sandbox/permission-profile resolution and launch-env construction moved to fork-only `src/runs/shared/profile-extensions.ts` and `profile-launch-env.ts` (all error messages byte-identical); profile-name validation and project-trust error copies were deduplicated into the fork-only shared modules; fork test blocks moved out of five upstream test files (now byte-identical to upstream) into `test/unit/fork-*.test.ts`; fork documentation chapters moved to `docs/fork-extensions.md`.
|
|
233
|
+
|
|
234
|
+
## [0.15.0] - 2026-09-17
|
|
235
|
+
|
|
236
|
+
### Changed
|
|
237
|
+
|
|
238
|
+
- **Synced to upstream v0.68.0 (adopted upstream removal of automatic model switching).** The upstream architecture no longer retries a different model within the same launch (`fallbackModels`), continues read-only HTTP 429 work on a different model, or persists model exclusions; each launch now resolves exactly one model and retries that same model at most twice. The fork adopts that removal wholesale while keeping its sandbox-profile, permission-profile, context-injection, silent-span, ejectable-agent, and fleet-native-transcript features on top.
|
|
239
|
+
- **Pane-native remote Pi placement (Herdr) is now part of the fork.** Upstream v0.68.0 adds running subagents on saved remote machines via Herdr panes, consolidates `src/inspectors/herdr/` into `src/inspectors/`, and splits the async execution tests into part files; the fork keeps its own `openSubagentFleetFromStatus` wrapper with an `inspectorPlugins` passthrough.
|
|
240
|
+
- Test fixtures were adapted for the fork's own version number (the bridge identity check compares `packageVersion` to the fork's package version) and for NixOS hosts where `/usr/bin`/`/bin` are not FHS-populated (mock `mktemp`/`rm`/`cat` are supplied in the deterministic remote PATH and the deterministic-PATH assertion tolerates host-injected suffixes).
|
|
241
|
+
|
|
242
|
+
### Upstream provenance
|
|
243
|
+
|
|
244
|
+
- Upstream v0.68.0: [source f3ccf47dc236](https://github.com/nicobailon/pi-subagents/tree/f3ccf47dc236b6c0fcc0d897cec4a9e6da3e916d); [recorded sync metadata](https://github.com/xzzpig/pi-extensions/blob/9aea4eef84c30f5c049acd6b688f309bb4d14abc/subtrees/pi-subagents.json).
|
|
245
|
+
|
|
246
|
+
## [0.14.0] - 2026-09-13
|
|
247
|
+
|
|
248
|
+
### Fixed
|
|
249
|
+
|
|
250
|
+
- **The fleet inspector no longer drops replayed thinking and assistant messages.** The structured transcript view upserted thinking and assistant text per turn (`upsertText`, whose contract is latest-wins), so a whole child turn collapsed into its last thinking block and last answer — measured on real transcripts, 38 thinking blocks became 1 entry, and it rendered at the very top of the panel while the view auto-followed the bottom. Replay now appends one entry per persisted assistant message, opens a new turn after a finished answer (so the reader's tail window no longer needs the original user record to separate turns), and reads a 600-record window instead of 240 (still capped by the 2 MiB byte limit).
|
|
251
|
+
|
|
252
|
+
### Added
|
|
253
|
+
|
|
254
|
+
- **Thinking expansion in the fleet inspector.** Replayed thinking blocks are collapsed by default to a `Thinking (t/T to expand)` label; the new `toggleThinking` Fleet binding (`t`/`T`) expands and collapses them. The plain-text view (`v`) carries no thinking entries, so the toggle stays inert there.
|
|
255
|
+
|
|
256
|
+
## [0.13.0] - 2026-09-11
|
|
257
|
+
|
|
258
|
+
### Changed
|
|
259
|
+
|
|
260
|
+
- **Sandbox profile env is pinned per child launch.** Every child launch now writes `PI_SUBAGENT_PERMISSION_PROFILE` explicitly (cleared when the child declares no profile) and drops launcher-owned `PI_SUBAGENT_*PROFILE*` keys from the runner's inherited environment, so a spawned child can neither inherit a host-session role selection nor override its own. The launch also sets `PI_SUBAGENT_PERMISSION_PROFILE_PINNED=1` to tell the permission system that this process owns a launched selection.
|
|
261
|
+
|
|
262
|
+
### Added
|
|
263
|
+
|
|
264
|
+
- **Public agent discovery API.** `pi-subagents/agents` now exports `discoverAgentsWithRuntime(pi, cwd, scope, preferredModelProvider?)` alongside the existing registration surface, plus the `AgentConfig`, `AgentDiscoveryDiagnostic`, `AgentDiscoveryResult`, and `AgentScope` types. It returns the same merged view the subagent executor uses — builtin, package, user, and project agent files combined with agents registered at runtime — so an independent extension can offer the launcher's agent list instead of re-implementing discovery. The extension's own runtime discovery now calls the same function.
|
|
265
|
+
|
|
266
|
+
## [0.12.0] - 2026-09-11
|
|
267
|
+
|
|
268
|
+
### Added
|
|
269
|
+
|
|
270
|
+
- **`permission-profile` agent frontmatter.** A custom agent can select a named `pi-permission-system` permission profile (global-only `profiles` registry) with `permission-profile: <name>` — a validated scalar selector, never an inline policy. The field is serialized, round-tripped through eject/settings overrides, and propagated through foreground/background/async/workflow launches, recovery descriptors, and status projections alongside the sandbox profile.
|
|
271
|
+
- **Transient profile channel.** When the field is set, the child receives the bare validated name via the transient `PI_SUBAGENT_PERMISSION_PROFILE` env var and `pi-subagents` injects the installed `pi-permission-system` extension into the child launch even under an explicit `extensions` allowlist, so the child's permission system applies the selected profile. Launch fails closed when the package is missing, a capability ceiling denies child extensions, or the runner is not a native Pi child (`external-cli`/`external-job` reject the field).
|
|
272
|
+
|
|
273
|
+
## [0.11.0] - 2026-09-11
|
|
274
|
+
|
|
275
|
+
### Added
|
|
276
|
+
|
|
277
|
+
- **Silent span marker for user-initiated dialogs (pi-notify protocol).**
|
|
278
|
+
The fleet inspector and the `/subagents admin` management dialogs emit the
|
|
279
|
+
literal `pi-notify:ui_span_silent` bus event (payload `{ reason: "fleet" |
|
|
280
|
+
"admin" }`) synchronously before opening their `ctx.ui.*` dialog, so the
|
|
281
|
+
pi-notify generic UI-prompt adapter produces no notification and no Herdr
|
|
282
|
+
wait entry for them. Emission is observational (bare try/catch) and uses the
|
|
283
|
+
literal event name with no dependency on the `@xzzpig/pi-notify` package, so
|
|
284
|
+
installs without pi-notify are unaffected. Both fleet open paths are wired
|
|
285
|
+
— the `/subagents-fleet` command and the fleet status widget — via the new
|
|
286
|
+
optional `FleetViewOptions.events` field; the subagent-executor agent-waiting
|
|
287
|
+
confirmations (worktree cleanup, authority confirmation) deliberately do not
|
|
288
|
+
emit the marker.
|
|
289
|
+
|
|
290
|
+
## [0.10.0] - 2026-09-10 (fork release)
|
|
291
|
+
|
|
292
|
+
### Added
|
|
293
|
+
|
|
294
|
+
- **`sandbox: <profile-name>` for native agents.** Agent frontmatter (or a
|
|
295
|
+
builtin override) may select one named `pi-sandbox` profile from the user's
|
|
296
|
+
global `<agentDir>/sandbox.json`. The selector is a scalar name only: objects,
|
|
297
|
+
empty values, path-like names, and the literal `false` are rejected, and the
|
|
298
|
+
field is refused for `external-cli` and `external-job` runners. The launcher
|
|
299
|
+
resolves and injects the installed `pi-sandbox` extension plus a startup guard
|
|
300
|
+
even when `extensions` is an explicit allowlist; a missing package, unreadable
|
|
301
|
+
manifest, capability-ceiling denial, unknown profile, or failed sandbox
|
|
302
|
+
initialization fails the launch before the child's first model turn.
|
|
303
|
+
- **Startup acknowledgement is verified before the first turn.** The guard
|
|
304
|
+
blocks the child when the profile never acknowledged successful startup, and
|
|
305
|
+
only the validated profile identity is persisted in async status, nested-event,
|
|
306
|
+
and intercom projections. The project trust decision travels with the child as
|
|
307
|
+
a boolean; a project-scoped selector is rejected unless the project is trusted
|
|
308
|
+
and the child cwd matches the trusted project root exactly.
|
|
309
|
+
- **A blocked child reports its real reason.** A startup block publishes its
|
|
310
|
+
failure through the child startup diagnostics channel (including the available
|
|
311
|
+
profile names), so callers see the profile error instead of "Subagent produced
|
|
312
|
+
no output (possible model cold-start or empty response)", and the failure is
|
|
313
|
+
classified as `startupBlocked` rather than a retryable model failure — it no
|
|
314
|
+
longer records a 24-hour model exclusion or triggers pointless model fallback.
|
|
315
|
+
|
|
316
|
+
### Changed
|
|
317
|
+
|
|
318
|
+
- **Sandbox configuration is never injected into the child.** Only the selected
|
|
319
|
+
profile name, the trust snapshot, the startup acknowledgement channel, and the
|
|
320
|
+
diagnostics path cross the launch boundary, and those keys are restored on the
|
|
321
|
+
host immediately after the child session is created. Launches without a
|
|
322
|
+
`sandbox` selector keep the previous behavior unchanged.
|
|
323
|
+
|
|
324
|
+
## [0.9.0] - 2026-09-05 (fork release)
|
|
325
|
+
|
|
326
|
+
### Changed
|
|
327
|
+
|
|
328
|
+
- **Synced upstream v0.56.0 → v0.65.0.** Highlights: subagents now run as
|
|
329
|
+
native Pi `AgentSession`s instead of spawned `pi` CLI processes (#1844),
|
|
330
|
+
managed worktrees gain validated `baseRef` and per-project nesting,
|
|
331
|
+
compact workflow lane summaries, fail-closed model selection, agent scan
|
|
332
|
+
dirs (`subagents.agentScanDirs`), a file-watched agent discovery cache,
|
|
333
|
+
and the `pi-subagents/pi-args` subpath rename to `pi-subagents/child-tool-plan`.
|
|
334
|
+
Upstream's own tests now cover `resolvePermissionSystemExtension()`
|
|
335
|
+
(child-tool-plan-permission-system.test.ts); the fork's `@xzzpig`
|
|
336
|
+
candidate-priority test merged into that suite.
|
|
337
|
+
- Dropped the fork's Pi SDK `streamFn` option-naming divergence: upstream
|
|
338
|
+
ships `agentStreamOptions()` (dual `streamFn`/`streamFunction`) at every
|
|
339
|
+
call site, which is strictly more compatible than the fork's single-name form.
|
|
340
|
+
- Raised dev-dependency SDK baseline stays at 0.84.2 while adopting
|
|
341
|
+
upstream's oxlint tooling.
|
|
342
|
+
|
|
343
|
+
### Preserved fork features across the merge
|
|
344
|
+
|
|
345
|
+
- `@xzzpig/pi-permission-system` priority in `resolvePermissionSystemExtension()`
|
|
346
|
+
(re-applied to the new `src/runs/shared/child-tool-plan.ts`).
|
|
347
|
+
- Context injection: `injectToContext` frontmatter, `subagents.injectAgents`
|
|
348
|
+
setting, session snapshot + `before_agent_start` injection, and
|
|
349
|
+
`/subagents-doctor` reporting, re-woven into upstream's
|
|
350
|
+
`discoverAgentSnapshot` discovery architecture.
|
|
351
|
+
- Fleet native transcript rendering (`v` key renderer toggle, native module
|
|
352
|
+
loader, mode-aware transcript cache) plus mouse-wheel scrolling, extended
|
|
353
|
+
to upstream's new `trustedFiles`/`trustedFileRoot` transcript read options.
|
|
354
|
+
- Foreground tool-result normalization with bounded `toolCallId` de-duplication
|
|
355
|
+
for mixed Pi host event shapes, ported to upstream's `processEvent`
|
|
356
|
+
child-session event architecture (shared `handleToolResult` path).
|
|
357
|
+
- The shared agent-eject API (`src/api/agent-management.ts`,
|
|
358
|
+
`ejectAgentDefinition`) used by pi-goal-x, adapted to upstream's renamed
|
|
359
|
+
imports (`resolveEffectiveThinking`, `child-tool-plan`).
|
|
360
|
+
- Fork package naming (`@xzzpig/pi-subagents`), env-isolated test scripts,
|
|
361
|
+
`prepack` bundle build, and `@xzzpig/pi-components` bundledDependencies.
|
|
362
|
+
|
|
363
|
+
### Upstream provenance
|
|
364
|
+
|
|
365
|
+
- Upstream v0.56.0: [source a0e2b9e31de5](https://github.com/nicobailon/pi-subagents/tree/a0e2b9e31de5970215a567e20e2d781bbbddf235); [recorded sync metadata](https://github.com/xzzpig/pi-extensions/blob/b2de5e5a8f4c9de10d2e04e21982d2e9841484ad/subtrees/pi-subagents.json).
|
|
366
|
+
- Upstream v0.65.0: [source 9300403c7408](https://github.com/nicobailon/pi-subagents/tree/9300403c7408800a9436ba8ca1b854f8ca96a991); [recorded sync metadata](https://github.com/xzzpig/pi-extensions/blob/c06f620f42aaec6b7f1685823232b84637b8d50f/subtrees/pi-subagents.json).
|
|
367
|
+
|
|
368
|
+
## [0.8.0] - 2026-08-24 (fork release)
|
|
369
|
+
|
|
370
|
+
### Changed
|
|
371
|
+
|
|
372
|
+
- **Synced upstream v0.53.0 → v0.56.0.** Highlights: opt-in `fast` mode for
|
|
373
|
+
allowlisted OpenAI-Codex subagents, bounded extension launch bindings,
|
|
374
|
+
max thinking ceiling, default provider setting, external job follow-ups,
|
|
375
|
+
safer completion-guard evidence, and workflow output/artifact routing —
|
|
376
|
+
merged on top of the fork's permission-system priority, SDK streamFn
|
|
377
|
+
naming, and fleet-native-transcript adaptations.
|
|
378
|
+
|
|
379
|
+
### Added
|
|
380
|
+
|
|
381
|
+
- **Fleet inspector native transcript rendering.** `/subagents-fleet` now
|
|
382
|
+
renders structured session transcripts through `@xzzpig/pi-components`
|
|
383
|
+
native components (tool calls via `ToolExecutionComponent`, messages via the
|
|
384
|
+
native message components). A new adapter (`src/tui/fleet-native-transcript.ts`)
|
|
385
|
+
converts persisted child-transcript JSONL records into library entries,
|
|
386
|
+
fills the tool-component registry per cache generation, synthesizes results
|
|
387
|
+
for calls without a result record, and degrades truncated (>32KB) argument
|
|
388
|
+
payloads to renderable entries with a truncation preview + result notice.
|
|
389
|
+
- **`v` key toggles the renderer.** Switches the inspector between the native
|
|
390
|
+
transcript and the legacy rail renderer (rebindable via
|
|
391
|
+
`FLEET_KEYBINDING_ACTIONS`; session-scoped state; inactive in Prompt Audit
|
|
392
|
+
mode). When the native module is missing or fails to load, the legacy
|
|
393
|
+
renderer is used automatically.
|
|
394
|
+
|
|
395
|
+
### Changed
|
|
396
|
+
|
|
397
|
+
- `@xzzpig/pi-components@0.3.0` is bundled via `bundledDependencies` (private,
|
|
398
|
+
never published to npm); `prepack` rebuilds it so the bundle always carries
|
|
399
|
+
fresh `dist`.
|
|
400
|
+
- Tool-call theming follows the host's global theme: the shared library never
|
|
401
|
+
re-initializes an already-active theme (fixes dark-theme tool backgrounds in
|
|
402
|
+
the main session after opening the inspector).
|
|
403
|
+
|
|
404
|
+
### Fixed
|
|
405
|
+
|
|
406
|
+
- Truncated or corrupt `argsPayload` records no longer produce empty tool
|
|
407
|
+
entries; they degrade with the recorded preview and outcome visible.
|
|
408
|
+
|
|
409
|
+
### Upstream provenance
|
|
410
|
+
|
|
411
|
+
- Upstream v0.53.0: [source c91f4de5ea95](https://github.com/nicobailon/pi-subagents/tree/c91f4de5ea956f0d1fcab9e44eba079fa2f917dd); [recorded sync metadata](https://github.com/xzzpig/pi-extensions/blob/89ba2222123e6cdf051ddd51684314953975f2fe/subtrees/pi-subagents.json).
|
|
412
|
+
- Upstream v0.56.0: [source a0e2b9e31de5](https://github.com/nicobailon/pi-subagents/tree/a0e2b9e31de5970215a567e20e2d781bbbddf235); [recorded sync metadata](https://github.com/xzzpig/pi-extensions/blob/b2de5e5a8f4c9de10d2e04e21982d2e9841484ad/subtrees/pi-subagents.json).
|
|
413
|
+
|
|
414
|
+
## [0.7.0] - 2026-08-24
|
|
415
|
+
|
|
416
|
+
## [0.6.0] - 2026-08-23
|
|
417
|
+
|
|
418
|
+
### Added
|
|
419
|
+
- Context injection: agents that opt in with `injectToContext: true` frontmatter, plus names listed under the new `subagents.injectAgents` setting, are pre-declared to the parent agent in a compact `<available_subagents>` system-prompt block. The union resolves once per session (canonical names or aliases; builtins allowed), stays byte-identical across turns to preserve provider prompt caching, skips disabled and capability-ceiling-restricted agents and spawned child sessions, ignores unknown setting names (reported by `/subagents-doctor`), and never duplicates itself on forked or resumed sessions.
|
|
420
|
+
|
|
421
|
+
## [0.5.0] - 2026-08-22
|
|
422
|
+
|
|
423
|
+
### Changed
|
|
424
|
+
- Synced the fork with upstream pi-subagents v0.53.0 (runtime agent registration API, keyed workflow receipts, TTL-based model-fallback exclusion, RPC schedule management, council mode; legacy chain workflow internals removed upstream in #1166).
|
|
425
|
+
|
|
426
|
+
### Fixed
|
|
427
|
+
- Preserved local compatibility fixes across the merge: `@xzzpig/pi-permission-system` priority in `resolvePermissionSystemExtension()`, foreground tool-result normalization for mixed Pi host event shapes, and the shared `ejectAgentDefinition` helper (adapted to upstream's `availableAgentNames` rename).
|
|
428
|
+
|
|
429
|
+
### Upstream provenance
|
|
430
|
+
|
|
431
|
+
- Upstream v0.53.0: [source c91f4de5ea95](https://github.com/nicobailon/pi-subagents/tree/c91f4de5ea956f0d1fcab9e44eba079fa2f917dd); [recorded sync metadata](https://github.com/xzzpig/pi-extensions/blob/89ba2222123e6cdf051ddd51684314953975f2fe/subtrees/pi-subagents.json).
|
|
432
|
+
|
|
433
|
+
## [0.4.2] - 2026-08-20
|
|
434
|
+
|
|
435
|
+
### Fixed
|
|
436
|
+
|
|
437
|
+
- Normalize native `message_end` tool-result events into the foreground progress snapshot, alongside `tool_result_end`, with `toolCallId` de-duplication. This keeps bounded tool-result records available to structured delegation consumers across Pi host event shapes.
|
|
438
|
+
- Verify an ejected agent's copied skills and launch tool plan before reporting success; failed verification removes only the file created by that eject attempt.
|
|
439
|
+
|
|
440
|
+
## [0.4.0] - 2026-08-16
|
|
441
|
+
|
|
442
|
+
### Changed
|
|
443
|
+
- Synced the fork with upstream pi-subagents v0.50.0 while preserving local compatibility fixes (@xzzpig/pi-permission-system priority in resolvePermissionSystemExtension(), Pi SDK 0.83 streamFn option naming).
|
|
444
|
+
|
|
445
|
+
### Upstream provenance
|
|
446
|
+
|
|
447
|
+
- Upstream v0.50.0: [source c091da1d9b66](https://github.com/nicobailon/pi-subagents/tree/c091da1d9b660c1940ef5dc78cfeeace1aecd435); [recorded sync metadata](https://github.com/xzzpig/pi-extensions/blob/9b9d7d621a821612db7e230f5d6f4980e6d28b69/subtrees/pi-subagents.json).
|
|
448
|
+
|
|
449
|
+
## [0.3.0] - 2026-08-14
|
|
450
|
+
|
|
451
|
+
### Changed
|
|
452
|
+
- Synced the fork with upstream pi-subagents v0.49.0 while preserving local compatibility fixes.
|
|
453
|
+
|
|
454
|
+
### Upstream provenance
|
|
455
|
+
|
|
456
|
+
- Upstream v0.49.0: [source 9752fdfd5de0](https://github.com/nicobailon/pi-subagents/tree/9752fdfd5de0d63cb0ac1036b76988691694e866); [recorded sync metadata](https://github.com/xzzpig/pi-extensions/blob/50019ff639b2f3119b73be6fd614a5f37b40c084/subtrees/pi-subagents.json).
|
package/README.md
CHANGED
|
@@ -131,3 +131,8 @@ The full reference lives in `docs/`:
|
|
|
131
131
|
| [Missions and schedules](https://github.com/nicobailon/pi-subagents/blob/main/docs/missions.md) | Durable mission records, delivery receipts, timed and recurring runs. |
|
|
132
132
|
| [Configuration](https://github.com/nicobailon/pi-subagents/blob/main/docs/configuration.md) | Every `config.json` key and environment variable. |
|
|
133
133
|
| [Extension API](https://github.com/nicobailon/pi-subagents/blob/main/docs/extension-api.md) | The RPC, delegation API, preflight, capability ceilings, [trusted workflow resources](docs/extension-api.md#trusted-workflow-resources), background-work providers, Herdr integration. |
|
|
134
|
+
|
|
135
|
+
## Fork and upstream release history
|
|
136
|
+
|
|
137
|
+
- Fork releases: [FORK-CHANGELOG.md](./FORK-CHANGELOG.md). Pi startup updates use this version sequence.
|
|
138
|
+
- Upstream releases: [CHANGELOG.md](./CHANGELOG.md), retained from upstream without fork entries.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
// package.json
|
|
2
2
|
var package_default = {
|
|
3
3
|
name: "@xzzpig/pi-subagents",
|
|
4
|
-
version: "0.25.
|
|
4
|
+
version: "0.25.2",
|
|
5
5
|
description: "Pi extension for single-agent delegation and scripted multi-agent workflows",
|
|
6
6
|
author: "Nico Bailon",
|
|
7
7
|
license: "MIT",
|
|
@@ -48,6 +48,7 @@ var package_default = {
|
|
|
48
48
|
"pi-subagents": "install.mjs"
|
|
49
49
|
},
|
|
50
50
|
files: [
|
|
51
|
+
"FORK-CHANGELOG.md",
|
|
51
52
|
"index.ts",
|
|
52
53
|
"src/**/*.ts",
|
|
53
54
|
"*.mjs",
|
|
@@ -72,6 +73,7 @@ var package_default = {
|
|
|
72
73
|
prepack: "pnpm --filter @xzzpig/pi-components run build && pnpm run build:pkg"
|
|
73
74
|
},
|
|
74
75
|
pi: {
|
|
76
|
+
changelogPath: "./FORK-CHANGELOG.md",
|
|
75
77
|
extensions: [
|
|
76
78
|
"./index.ts"
|
|
77
79
|
],
|
|
@@ -6468,7 +6468,7 @@ function childSessionFactory() {
|
|
|
6468
6468
|
}
|
|
6469
6469
|
function createLazyPlacementFactory(local) {
|
|
6470
6470
|
let placed;
|
|
6471
|
-
const factory = async () => placed ??= (await import("./chunk-
|
|
6471
|
+
const factory = async () => placed ??= (await import("./chunk-E3EQ7USM.js")).createPlacementAwareChildSessionFactory(local);
|
|
6472
6472
|
return {
|
|
6473
6473
|
async create(launch) {
|
|
6474
6474
|
return launch.machine ? (await factory()).create(launch) : local.create(launch);
|