Skip to content

v0.26.2

Latest

Choose a tag to compare

@tintinweb tintinweb released this 20 Nov 11:06

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, with parentAgentId or workflowId set. Ignore events where either field is set to keep the old behavior.

⚠️ Behavior change — the subagents:rpc:stop reply 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 smaller settleTimeoutMs.

⭐ New — set the prompt cache retention for subagents (#464). Short-lived subagents can skip the main session's long cache tier: set cacheRetention, or cache_retention: per agent.

Added

  • Lifecycle events carry the validated report and the session file (#415). Events now include structuredJson and sessionFile, so a bus caller no longer needs the manager registry to read them.
  • subagents:rpc:get and subagents:rpc:list return agent state (#442). For extensions that loaded after the events fired; records stay readable 10 min after finish, and ping now advertises a features list.
  • get/list flag a finished agent whose completion message is undelivered (#103). notificationPending: true covers the window before the message starts a parent turn.
  • Observe SubagentWorkflow runs on the bus (superseding #460). Runs bracket themselves with subagents:workflow_started / workflow_settled; workflow_get / workflow_list pull live per-agent detail, and workflow_settled carries the script's untruncated result (#417).
  • Set the prompt cache retention for subagents (#464, superseding #456). New cacheRetention setting and per-agent cache_retention: frontmatter; the default inherit changes nothing.

Changed

  • Lifecycle events cover nested and workflow agents (#442). A new ownUsage field holds each agent's own spend, since usage includes the agents below it.

Fixed

  • subagents:rpc:stop replies only once the stopped agent and every agent below it have finished (#443). The reply waits up to 5 s, or settleTimeoutMs, and returns { settled }.

Thanks @BenedictP, @ramhaidar, @simenM84, @0oAstro, @sergio-agosti, @VolodymyrMachekhin.

Full detail in CHANGELOG.md.