use super::*; use crate::{client::Model, function::Functions}; use anyhow::{Context, Result}; use inquire::{validator::Validation, Text}; use std::{fs::read_to_string, path::Path}; use serde::{Deserialize, Serialize}; #[derive(Debug, Clone, Serialize)] pub struct Agent { name: String, config: AgentConfig, definition: AgentDefinition, #[serde(skip)] functions: Functions, #[serde(skip)] rag: Option>, #[serde(skip)] model: Model, } impl Agent { pub async fn init( config: &GlobalConfig, name: &str, abort_signal: AbortSignal, ) -> Result { let functions_dir = Config::agent_functions_dir(name)?; let definition_file_path = functions_dir.join("index.yaml"); if !definition_file_path.exists() { bail!("Unknown agent `{name}`"); } let functions_file_path = functions_dir.join("functions.json"); let rag_path = Config::agent_rag_file(name, "rag")?; let config_path = Config::agent_config_file(name)?; let agent_config = if config_path.exists() { AgentConfig::load(&config_path)? } else { AgentConfig::new(&config.read()) }; let mut definition = AgentDefinition::load(&definition_file_path)?; init_variables(&mut definition.variables, &agent_config.variables) .context("Failed to init variables")?; let functions = if functions_file_path.exists() { Functions::init(&functions_file_path)? } else { Functions::default() }; definition.replace_tools_placeholder(&functions); let model = { let config = config.read(); match agent_config.model_id.as_ref() { Some(model_id) => Model::retrieve_chat(&config, model_id)?, None => config.current_model().clone(), } }; let rag = if rag_path.exists() { Some(Arc::new(Rag::load(config, "rag", &rag_path)?)) } else if !definition.documents.is_empty() { let mut ans = false; if *IS_STDOUT_TERMINAL { ans = Confirm::new("The agent has the documents, init RAG?") .with_default(true) .prompt()?; } if ans { let mut document_paths = vec![]; for path in &definition.documents { if is_url(path) { document_paths.push(path.to_string()); } else { let new_path = safe_join_path(&functions_dir, path) .ok_or_else(|| anyhow!("Invalid document path: '{path}'"))?; document_paths.push(new_path.display().to_string()) } } let rag = Rag::init(config, "rag", &rag_path, &document_paths, abort_signal).await?; Some(Arc::new(rag)) } else { None } } else { None }; Ok(Self { name: name.to_string(), config: agent_config, definition, functions, rag, model, }) } pub fn export(&self) -> Result { let mut agent = self.clone(); agent.definition.instructions = self.interpolated_instructions(); let mut value = serde_json::json!(agent); value["functions_dir"] = Config::agent_functions_dir(&self.name)? .display() .to_string() .into(); value["data_dir"] = Config::agent_data_dir(&self.name)? .display() .to_string() .into(); value["config_file"] = Config::agent_config_file(&self.name)? .display() .to_string() .into(); let data = serde_yaml::to_string(&value)?; Ok(data) } pub fn banner(&self) -> String { self.definition.banner() } pub fn name(&self) -> &str { &self.name } pub fn functions(&self) -> &Functions { &self.functions } pub fn rag(&self) -> Option> { self.rag.clone() } pub fn conversation_staters(&self) -> &[String] { &self.definition.conversation_starters } pub fn interpolated_instructions(&self) -> String { self.definition.interpolated_instructions() } pub fn agent_prelude(&self) -> Option<&str> { self.config.agent_prelude.as_deref() } pub fn set_agent_prelude(&mut self, value: Option) { self.config.agent_prelude = value; } pub fn variables(&self) -> &[AgentVariable] { &self.definition.variables } pub fn set_variable(&mut self, key: &str, value: &str) -> Result<()> { match self.definition.variables.iter_mut().find(|v| v.name == key) { Some(variable) => { variable.value = value.to_string(); Ok(()) } None => bail!("Unknown variable '{key}'"), } } } impl RoleLike for Agent { fn to_role(&self) -> Role { let prompt = self.interpolated_instructions(); let mut role = Role::new("", &prompt); role.sync(self); role } fn model(&self) -> &Model { &self.model } fn model_mut(&mut self) -> &mut Model { &mut self.model } fn temperature(&self) -> Option { self.config.temperature } fn top_p(&self) -> Option { self.config.top_p } fn use_tools(&self) -> Option { self.config.use_tools.clone() } fn set_model(&mut self, model: &Model) { self.config.model_id = Some(model.id()); self.model = model.clone(); } fn set_temperature(&mut self, value: Option) { self.config.temperature = value; } fn set_top_p(&mut self, value: Option) { self.config.top_p = value; } fn set_use_tools(&mut self, value: Option) { self.config.use_tools = value; } } #[derive(Debug, Clone, Default, Deserialize, Serialize)] pub struct AgentConfig { #[serde(rename(serialize = "model", deserialize = "model"))] pub model_id: Option, pub temperature: Option, pub top_p: Option, pub use_tools: Option, pub agent_prelude: Option, #[serde(default)] pub variables: IndexMap, } impl AgentConfig { pub fn new(config: &Config) -> Self { Self { use_tools: config.use_tools.clone(), agent_prelude: config.agent_prelude.clone(), ..Default::default() } } pub fn load(path: &Path) -> Result { let contents = read_to_string(path) .with_context(|| format!("Failed to read agent config file at '{}'", path.display()))?; let config: Self = serde_yaml::from_str(&contents) .with_context(|| format!("Failed to load agent config at '{}'", path.display()))?; Ok(config) } } #[derive(Debug, Clone, Default, Deserialize, Serialize)] pub struct AgentDefinition { pub name: String, #[serde(default)] pub description: String, #[serde(default)] pub version: String, pub instructions: String, #[serde(default)] pub variables: Vec, #[serde(default)] pub conversation_starters: Vec, #[serde(default)] pub documents: Vec, } impl AgentDefinition { pub fn load(path: &Path) -> Result { let contents = read_to_string(path) .with_context(|| format!("Failed to read agent index file at '{}'", path.display()))?; let definition: Self = serde_yaml::from_str(&contents) .with_context(|| format!("Failed to load agent index at '{}'", path.display()))?; Ok(definition) } fn banner(&self) -> String { let AgentDefinition { name, description, version, conversation_starters, .. } = self; let starters = if conversation_starters.is_empty() { String::new() } else { let starters = conversation_starters .iter() .map(|v| format!("- {v}")) .collect::>() .join("\n"); format!( r#" ## Conversation Starters {starters}"# ) }; format!( r#"# {name} {version} {description}{starters}"# ) } fn interpolated_instructions(&self) -> String { let mut output = self.instructions.clone(); for variable in &self.variables { output = output.replace(&format!("{{{{{}}}}}", variable.name), &variable.value) } interpolate_variables(&mut output); output } fn replace_tools_placeholder(&mut self, functions: &Functions) { let tools_placeholder: &str = "{{__tools__}}"; if self.instructions.contains(tools_placeholder) { let tools = functions .declarations() .iter() .enumerate() .map(|(i, v)| { let description = match v.description.split_once('\n') { Some((v, _)) => v, None => &v.description, }; format!("{}. {}: {description}", i + 1, v.name) }) .collect::>() .join("\n"); self.instructions = self.instructions.replace(tools_placeholder, &tools); } } } #[derive(Debug, Clone, Default, Deserialize, Serialize)] pub struct AgentVariable { pub name: String, pub description: String, #[serde(skip_serializing_if = "Option::is_none")] pub default: Option, #[serde(skip_deserializing, default)] pub value: String, } pub fn list_agents() -> Vec { list_agents_impl().unwrap_or_default() } fn list_agents_impl() -> Result> { let base_dir = Config::functions_dir()?; let contents = read_to_string(base_dir.join("agents.txt"))?; let agents = contents .split('\n') .filter_map(|line| { let line = line.trim(); if line.is_empty() || line.starts_with('#') { None } else { Some(line.to_string()) } }) .collect(); Ok(agents) } fn init_variables( variables: &mut [AgentVariable], config_variable: &IndexMap, ) -> Result<()> { if variables.is_empty() { return Ok(()); } for variable in variables.iter_mut() { match config_variable.get(&variable.name) { Some(value) => variable.value = value.to_string(), None => { if let Some(value) = variable.default.clone() { variable.value = value; continue; } if *IS_STDOUT_TERMINAL { let value = Text::new(&variable.description) .with_validator(|input: &str| { if input.trim().is_empty() { Ok(Validation::Invalid("This field is required".into())) } else { Ok(Validation::Valid) } }) .prompt()?; variable.value = value; } else { bail!("Failed to init agent variables in non-interactive mode"); } } } } Ok(()) }