From 78f68dbbb92cb3b361b85f0b819caf021c0c647b Mon Sep 17 00:00:00 2001
From: Tianyi Cui <53024+tianyicui@users.noreply.github.com>
Date: Sat, 18 Jul 2026 20:35:58 +0800
Subject: [PATCH] docs(agent-loop): track scheduler drain follow-up

---
 packages/core/agent-loop/src/tool-calls.ts | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/core/agent-loop/src/tool-calls.ts b/packages/core/agent-loop/src/tool-calls.ts
index a8b7186223..3f3581c70a 100644
--- a/packages/core/agent-loop/src/tool-calls.ts
+++ b/packages/core/agent-loop/src/tool-calls.ts
@@ -176,6 +176,8 @@ async function runGroup(
   }
 
   // Ordered pre-execute may await; only dispatch/body overlaps.
+  // TODO: Drain every started call before rethrowing a scheduler error; tool
+  // bodies must not outlive the failed turn.
   await fillPool()
   while (inFlight.size > 0) {
     const settledIndex = await Promise.race(inFlight.values())