use crate::agents_md::LoadedAgentsMd; use crate::agents_md::load_project_instructions; use crate::config::Config; use crate::environment_selection::TurnEnvironmentSnapshot; use codex_extension_api::Instructions; use codex_protocol::config_types::TrustLevel; use codex_protocol::protocol::TurnEnvironmentSelection; use std::io; use std::sync::Arc; use tokio::sync::Mutex; /// Owns the inputs and cached result of AGENTS.md discovery for a session. pub(crate) struct AgentsMdManager { user_instructions: Option, cache: Mutex, } #[derive(Default)] struct AgentsMdCache { selections: Option>, active_project_trust_level: Option, loaded: Option>, } impl AgentsMdManager { pub(crate) fn new(user_instructions: Option) -> Self { Self { user_instructions: user_instructions .filter(|instructions| !instructions.text.trim().is_empty()), cache: Mutex::new(AgentsMdCache::default()), } } #[tracing::instrument(name = "agents_md.refresh", skip_all)] pub(crate) async fn refresh( &self, config: &Config, environments: &TurnEnvironmentSnapshot, ) -> io::Result<()> { let selections = environments .turn_environments() .map(|environment| environment.selection.clone()) .collect::>(); let active_project_trust_level = config.active_project.trust_level; { let mut cache = self.cache.lock().await; if cache.selections.as_ref() == Some(&selections) && cache.active_project_trust_level == active_project_trust_level { return Ok(()); } cache.selections = None; cache.active_project_trust_level = None; cache.loaded = None; } let loaded = load_project_instructions(config, self.user_instructions.clone(), environments) .await? .map(Arc::new); let mut cache = self.cache.lock().await; cache.selections = Some(selections); cache.active_project_trust_level = active_project_trust_level; cache.loaded = loaded; Ok(()) } pub(crate) async fn get_loaded(&self) -> Option> { self.cache.lock().await.loaded.clone() } pub(crate) fn user_instructions(&self) -> Option { self.user_instructions.clone() } }