feat(subagents): complete queue, budgets, audit, and inspection controls

This commit is contained in:
William Valentin
2026-02-26 13:28:10 -08:00
parent b679261683
commit 3cc9e16ef5
23 changed files with 741 additions and 51 deletions
+16 -13
View File
@@ -1,7 +1,7 @@
# Subagents Support Plan (Flynn)
Date: 2026-02-26
Status: phase 1 implemented, phase 2 partially implemented
Status: phases 1-3 implemented
Scope: add OpenClaw-style multi-turn subagent session support in Flynn without changing channel surface scope (Telegram-first)
## Constraints
@@ -30,22 +30,25 @@ Scope: add OpenClaw-style multi-turn subagent session support in Flynn without c
- `max_active_sessions`
5. Added policy/profile support so `subagent.*` is controlled through `group:agents` and tool profiles.
## Phase 2 (Next)
## Phase 2 (Implemented)
1. Add per-subagent TTL/idle eviction and auto-cleanup metrics. (implemented: TTL eviction)
2. Add optional transcript export/summarization (`subagent.summary`). (implemented)
3. Add per-subagent tool-profile override (read-only by default for risky workloads). (pending)
4. Add parent-child trace IDs in audit events for easier debugging. (pending)
1. Added idle TTL eviction plus audit lifecycle events for cleanup visibility.
2. Added transcript export/summarization via `subagent.summary`.
3. Added per-subagent tool-profile override (`queue_mode`, `tool_profile` on spawn).
4. Added parent-child trace IDs and subagent lifecycle/turn audit events.
## Phase 3 (Stretch)
## Phase 3 (Implemented)
1. Add queue semantics for child sessions (`followup` vs `interrupt` per subagent).
2. Add explicit resource budgets (token/time) per child session.
3. Add UI affordances in gateway chat for subagent session inspection.
1. Added queue semantics per child session (`followup` FIFO, `interrupt` latest-wins).
2. Added explicit resource budgets (max turns, max total tokens, per-turn timeout).
3. Added operator/UI affordances:
- `/subagents` command (list/summary/cancel/delete),
- gateway chat slash suggestion for `/subagents`.
## Acceptance Criteria (Phase 1)
## Final Acceptance Criteria
1. Parent agent can spawn and continue a child subagent across multiple turns.
1. Parent agent can spawn and continue child subagents across multiple turns.
2. Child session state is isolated and delete clears history.
3. Recursion tooling (`agent.delegate`, `council.run`, `subagent.*`) is removed from child registries.
4. Tests cover manager lifecycle, tool behavior, config parsing, and policy profile inclusion.
4. Child sessions support queue policy + budget guardrails + transcript inspection.
5. Tests cover manager lifecycle, tool behavior, config parsing, routing command wiring, and audit event logging.