Skip to content

ToolExecutorStrategy

type ToolExecutorStrategy = "sequential" | "concurrent";

Defined in: src/agent/agent.ts:99

Strategy for executing tool calls that the model emits in a single assistant turn.

  • 'sequential' (default) — runs tool calls one at a time
  • 'concurrent' — runs all tool calls from a single turn in parallel. Per-tool event order (BeforeToolCallEventToolStreamUpdateEvent*AfterToolCallEventToolResultEvent) is preserved, while cross-tool events may interleave.

Cancellation works identically in both modes: Agent.cancel flips Agent.cancelSignal and tools must observe it cooperatively to stop early. In concurrent mode, prompt batch-wide cancellation requires every in-flight tool to honor the signal.