@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.
@@ -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.0",
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-OSVXFWPG.js")).createPlacementAwareChildSessionFactory(local);
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);
@@ -7,7 +7,7 @@ import {
7
7
  } from "./chunk-JWFLPSTP.js";
8
8
  import {
9
9
  package_default
10
- } from "./chunk-YWXILP5N.js";
10
+ } from "./chunk-6F3YET5B.js";
11
11
  import {
12
12
  ensureSupervisorChannelDir
13
13
  } from "./chunk-34TUUBRN.js";