Async Generator Query Architecture

• Entity ID: ent-20260419-a76eebe71f47
• Type: concept
• Scope: shared
• Status: active
• Aliases: submitMessage AsyncGenerator, yield* chain

Description

QueryEngine.submitMessage() returns an AsyncGenerator rather than a Promise; the yield* chain preserves state at every step so that Ctrl+C interrupts do not discard partial context.

Key claims

• submitMessage returns AsyncGenerator, not Promise
• All entry surfaces converge on the same shared queryLoop()
• The query loop is an AsyncGenerator yielding multiple event types to the UI
• The loop terminates on five distinct conditions
• Claude Code uses mode-independent execution, not surface-specific engines

Relations

• Async Generator Query Architecture --[implements]--> QueryEngine.ts
• QueryEngine.ts --[implements]--> Async Generator Query Architecture
• query.ts --[implements]--> Async Generator Query Architecture
• Gather-Act-Verify Loop --[implemented_by]--> Async Generator Query Architecture
• Nine-Step Per-Turn Pipeline --[describes]--> Async Generator Query Architecture

Sources

src-20260419-f46b0a2fccd9