//! Shared services bundle — common state threaded through HTTP handlers and chat transports.
//!
//! `Services` bundles the fields that every transport (Matrix, Slack, Discord,
//! WhatsApp) and the HTTP/MCP layer need. A single `Arc<Services>` is
//! constructed once in `main.rs` and cloned into `AppContext` and each
//! transport's context struct.

use crate::agents::AgentPool;
use crate::http::context::{PermissionDecision, PermissionForward};
use std::collections::{HashMap, HashSet};
use std::path::PathBuf;
use std::sync::Arc;
use tokio::sync::{Mutex as TokioMutex, mpsc, oneshot};

/// Shared state bundle constructed once at startup and cloned (via `Arc`) into
/// every context that needs access to the project root, agent pool, bot
/// identity, ambient-room set, or permission plumbing.
pub struct Services {
    /// Absolute path to the project root directory.
    pub project_root: PathBuf,
    /// Agent pool for starting, stopping, and querying coding agents.
    pub agents: Arc<AgentPool>,
    /// Display name the bot uses to identify itself (from `bot.toml`).
    pub bot_name: String,
    /// String representation of the bot's user ID (e.g. `"@timmy:hs.local"`
    /// for Matrix, `"slack-bot"` for Slack).
    pub bot_user_id: String,
    /// Set of room/channel IDs where ambient mode is active.
    pub ambient_rooms: Arc<std::sync::Mutex<HashSet<String>>>,
    /// Receiver for permission requests from the MCP `prompt_permission` tool.
    pub perm_rx: Arc<TokioMutex<mpsc::UnboundedReceiver<PermissionForward>>>,
    /// Per-room pending permission reply senders, keyed by room/channel ID
    /// as a plain string.
    pub pending_perm_replies: Arc<TokioMutex<HashMap<String, oneshot::Sender<PermissionDecision>>>>,
    /// Seconds to wait for a user to respond to a permission prompt before
    /// auto-denying (fail-closed).
    pub permission_timeout_secs: u64,
}