Repository navigation
Patch release — bus/RPC observability for nested and workflow agents, plus per-subagent prompt cache retention.
⚠️ Behavior change — lifecycle events now fire for nested and workflow agents (#442). They used to cover only the session's own agents; nested and workflow agents now emit them too, withparentAgentIdorworkflowIdset. Ignore events where either field is set to keep the old behavior.
⚠️ Behavior change — thesubagents:rpc:stopreply can arrive up to 5 s later (#443). It now waits until the stopped agent and every agent below it have finished. Raise a sub-5 s stop timeout, or pass a smallersettleTimeoutMs.
⭐ New — set the prompt cache retention for subagents (#464). Short-lived subagents can skip the main session's long cache tier: set
cacheRetention, orcache_retention:per agent.
Added
- Lifecycle events carry the validated report and the session file (#415). Events now include
structuredJsonandsessionFile, so a bus caller no longer needs the manager registry to read them. subagents:rpc:getandsubagents:rpc:listreturn agent state (#442). For extensions that loaded after the events fired; records stay readable 10 min after finish, andpingnow advertises afeatureslist.get/listflag a finished agent whose completion message is undelivered (#103).notificationPending: truecovers the window before the message starts a parent turn.- Observe
SubagentWorkflowruns on the bus (superseding #460). Runs bracket themselves withsubagents:workflow_started/workflow_settled;workflow_get/workflow_listpull live per-agent detail, andworkflow_settledcarries the script's untruncatedresult(#417). - Set the prompt cache retention for subagents (#464, superseding #456). New
cacheRetentionsetting and per-agentcache_retention:frontmatter; the defaultinheritchanges nothing.
Changed
- Lifecycle events cover nested and workflow agents (#442). A new
ownUsagefield holds each agent's own spend, sinceusageincludes the agents below it.
Fixed
subagents:rpc:stopreplies only once the stopped agent and every agent below it have finished (#443). The reply waits up to 5 s, orsettleTimeoutMs, and returns{ settled }.
Thanks @BenedictP, @ramhaidar, @simenM84, @0oAstro, @sergio-agosti, @VolodymyrMachekhin.
Full detail in CHANGELOG.md.