mod.rs

//! Background agent execution system.
//!
//! This module provides infrastructure for running agents in the background
//! with async communication, event broadcasting, and lifecycle management.
//!
//! # Architecture
//!
//! ```text
//! BackgroundAgentManager
//!     ├── BackgroundAgent (tokio task)
//!     │   ├── status channel (mpsc)
//!     │   ├── cancel channel (oneshot)
//!     │   └── mailbox (AgentMailbox)
//!     ├── Event broadcaster (broadcast)
//!     └── Agent registry (HashMap)
//! ```
//!
//! # Example
//!
//! ```rust,ignore
//! use cortex_agents::background::{
//!     BackgroundAgentManager, AgentConfig, AgentEvent
//! };
//!
//! // Create manager
//! let mut manager = BackgroundAgentManager::new(5);
//!
//! // Subscribe to events
//! let mut events = manager.subscribe();
//!
//! // Spawn a background agent
//! let id = manager.spawn(AgentConfig::new("Search for patterns")).await?;
//!
//! // Monitor events
//! while let Ok(event) = events.recv().await {
//!     match event {
//!         AgentEvent::Progress { id, message } => println!("{}: {}", id, message),
//!         AgentEvent::Completed { id, result } => {
//!             println!("Agent {} completed: {:?}", id, result);
//!             break;
//!         }
//!         _ => {}
//!     }
//! }
//! ```
//!
//! # Safety & Limits
//!
//! - Maximum concurrent agents: configurable (default 5)
//! - Automatic timeout: 30 minutes per agent
//! - RAII cleanup: agents are cancelled when manager is dropped
//! - Isolated contexts: agents don't share credentials

pub mod events;
pub mod executor;
pub mod messaging;

pub use events::{AgentEvent, Notification, NotificationLevel, NotificationManager};
pub use executor::{
    AgentConfig, AgentResult, AgentStatus, BackgroundAgent, BackgroundAgentError,
    BackgroundAgentManager,
};
pub use messaging::{AgentMailbox, AgentMessage, MessageContent, MessageRouter};