2.6 KiB
status, parent, claimed-by, claimed-at, resolved-at, blocked-by, tags
| status | parent | claimed-by | claimed-at | resolved-at | blocked-by | tags | ||
|---|---|---|---|---|---|---|---|---|
| resolved | 094-pi-subagent-result-delivery-spec-task | 019fc04b-8b68-74cc-835c-da630d49fb38 | 2026-08-01T22:26:56-04:00 | 2026-08-01T22:33:51-04:00 |
|
|
Pi subagent clearable terminal work
Question
Implement current-session terminal subagent visibility so completed, failed, cancelled, and timed-out children stay visible and retrievable until explicitly cleared.
What to build
Terminal children should remain visible in the current-session subagent work set until the parent or human explicitly clears them. Terminal result retrieval should keep working until clear. Completion awareness should be non-blocking and should identify the child label and terminal outcome. Clearing should remove terminal children from the visible work set without implying workflow-specific reconciliation.
Acceptance criteria
- Terminal children no longer disappear from the visible current-session list because of a TTL.
- A clear or dismiss command or tool removes terminal children from the visible work set.
- Terminal results remain retrievable until cleared.
- Completion notices include the child label and terminal state.
- Multiple terminal transitions can be noticed without requiring
subagent_wait. - Tests cover terminal retention, result retrieval before clear, and removal after clear.
Implementation Notes
Current-session reliability is sufficient. Do not add cross-restart result persistence.
Implemented on branch subagent-labels in commit 8c85c00 feat(pi): retain terminal subagent work.
Terminal records now stay in subagent_list and the widget until subagent_clear, /subagent-clear, or Supervisor.clearTerminal() removes terminal records.
Result and status retrieval remain available until clear, after which cleared ids are unknown.
Verification passed with nix shell nixpkgs#nodejs_24 nixpkgs#tsx -c tsx --test modules/agents/pi/extensions/subagents/supervisor.test.ts modules/agents/pi/extensions/subagents/runner.test.ts modules/agents/pi/extensions/subagents/config.test.ts.
Review found no blocking findings after updating the current-extension inventory artifact.
Accepted non-blocking evidence limitations: the clear tool and command are not covered by an extension-level fake Pi registration test, and multiple terminal notice wiring remains covered through supervisor milestone behavior plus notification formatting rather than a multi-child notification integration test.