Runtype
Changelog
FeatureJuly 13, 20261 min read

Run subagents in the background

Detached subagent runs return a durable run ID immediately, keep working after the parent request ends, and report completion or approval needs back to the parent conversation.

agentssubagentsdurable-executionapprovals

Long-running subagent work no longer has to hold the parent agent's turn open. Enable detached execution for a subagent tool and the parent receives a stable runId immediately, then continues independent work or returns control to the user.

  • Durable lifecycle. The child keeps its own checkpoints and event history across request boundaries and Worker restarts.
  • Inspect and control it. Use the existing agent-execution routes to inspect, list, replay events from, or cancel a detached run.
  • Return to the right conversation. Completion is delivered back to the parent conversation as a provenance-bearing status event.
  • Pause safely for approval. A child that needs approval pauses durably, notifies the parent conversation, and resumes the same run after approval or denial.

Attached execution remains the default for work whose result the parent needs immediately. Detached mode is an explicit authoring choice, and existing subagent tools keep their current behavior.