paladin_battalion/lib.rs
1//! # paladin-battalion
2//!
3//! Multi-agent orchestration runtime for the Paladin framework.
4//!
5//! This crate provides all eight Battalion execution patterns and the Commander
6//! strategy router. It depends only on `paladin-core` (domain types) and
7//! `paladin-ports` (port trait contracts) — never on infrastructure SDKs,
8//! database drivers, or LLM provider libraries.
9//!
10//! ## Patterns
11//!
12//! - [`formation_service`] — Sequential execution: output of agent N feeds input of agent N+1
13//! - [`phalanx_service`] — Concurrent execution: all agents run in parallel
14//! - [`campaign_service`] — DAG/graph execution: topologically sorted dependency graph
15//! - [`chain_of_command_service`] — Hierarchical delegation: commander delegates to sub-agents
16//! - [`conclave_execution_service`] — Mixture-of-experts synthesis
17//! - [`council_service`] — Multi-agent discussion and consensus
18//! - [`grove_service`] — Intelligent semantic routing
19//! - [`maneuver`] — Flow DSL execution (domain types, parser, service, visualizer)
20//! - [`commander`] — Strategy auto-detection router
21//!
22//! ## Utilities
23//!
24//! - [`error_aggregation`] — Collect and summarise errors across parallel agent runs
25//! - [`retry`] — Exponential back-off retry helper
26
27#![warn(missing_docs)]
28
29// Execution services
30pub mod campaign_service;
31pub mod chain_of_command_service;
32pub mod commander;
33pub mod conclave_execution_service;
34pub mod council_service;
35pub mod error_aggregation;
36pub mod formation_service;
37pub mod grove_service;
38pub mod maneuver;
39pub mod phalanx_service;
40pub mod retry;
41
42// Internal helpers
43pub(crate) mod in_memory_registry;