1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
//! Multi-Agent Research Coordination
//!
//! This module provides infrastructure for coordinating multiple agents
//! to perform complex research tasks that require gathering information
//! from multiple sources, synthesizing findings, and producing comprehensive reports.
//!
//! # Architecture
//!
//! The research system uses a coordinator pattern:
//! - [`research::coordinator::ResearchCoordinator`](crate::research::coordinator::ResearchCoordinator) - Orchestrates research tasks
//! - Spawns specialized sub-agents for different research aspects
//! - Aggregates and synthesizes results from multiple agents
//!
//! # Usage
//!
//! ```ignore
//! use ares::research::coordinator::ResearchCoordinator;
//!
//! let coordinator = ResearchCoordinator::new(agent_registry, config);
//!
//! let report = coordinator
//! .research("What are the latest developments in quantum computing?")
//! .await?;
//!
//! println!("Research Report:\n{}", report.summary);
//! for source in report.sources {
//! println!("- {}", source.url);
//! }
//! ```
//!
//! # Research Workflow
//!
//! 1. **Query Analysis** - Break down the research question
//! 2. **Information Gathering** - Dispatch agents to search and retrieve
//! 3. **Fact Extraction** - Extract key facts from gathered information
//! 4. **Synthesis** - Combine findings into a coherent report
//! 5. **Citation** - Track and attribute sources
/// Research task coordination and multi-source aggregation.