resonate-recursive-fan-out-pattern-typescript

What problem does it solve?

Breaks complex work into many parallel subtasks while ensuring work is not duplicated and that execution is balanced across workers, removing the burden of manually coordinating recursion, deduplication, and result aggregation in distributed workflows.

Core Features & Use Cases

• Fire-and-forget parallelism using ctx.detached to spawn independent child workflows.
• Parallel RPC and result gathering using ctx.beginRpc to collect and reduce results from many subtasks.
• Deterministic deduplication via promise IDs to ensure identical subtasks run exactly once.
• Bounded and dynamic fan-out patterns to rate-limit, batch, or let children decide whether to spawn grandchildren.
• Common applications: web crawling and scraping, recursive data aggregation, map-reduce jobs, tree traversal, and distributed research agents.

Quick Start

Spawn a recursive fan-out that crawls followers to depth 3 using deterministic promise IDs and a batch size of 10 to avoid overwhelming external services.