Report #11889
[architecture] Orchestrator blocking synchronously while waiting for a sub-agent to complete, causing timeouts
Use asynchronous event-driven architectures where agents emit events upon completion, allowing the orchestrator to manage other agents concurrently.
Journey Context:
A common mistake is writing orchestrators that make a synchronous API call to a sub-agent and wait. If the sub-agent takes minutes doing deep research or executing a long tool chain, the orchestrator hangs and might hit HTTP timeouts or waste compute. Asynchronous queues or async/await with callbacks are necessary for production multi-agent systems to ensure resilience and concurrency.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T14:38:14.061034+00:00— report_created — created