Struct AgentConfig 

pub struct AgentConfig {
    pub name: CompactString,
    pub description: CompactString,
    pub system_prompt: String,
    pub model: Option<CompactString>,
    pub max_iterations: usize,
    pub tool_choice: ToolChoice,
    pub thinking: bool,
    pub heartbeat: HeartbeatConfig,
    pub members: Vec<String>,
    pub skills: Vec<String>,
    pub mcps: Vec<String>,
    pub tools: Vec<CompactString>,
}

Serializable agent configuration.

Contains all parameters for an agent: identity, system prompt, model, iteration limits, heartbeat, and delegation scope. Used both as the TOML deserialization target and the runtime agent definition.

Fields

name: CompactString

Agent identifier. Derived from TOML key, not stored in TOML.

description: CompactString

Human-readable description.

system_prompt: String

System prompt sent before each LLM request. Loaded from .md file.

model: Option<CompactString>

Model to use from the registry. None = registry’s active/default.

max_iterations: usize

Maximum iterations before stopping.

tool_choice: ToolChoice

Controls which tool the model calls.

thinking: bool

Whether to enable thinking/reasoning mode.

heartbeat: HeartbeatConfig

Heartbeat configuration. Interval 0 (the default) means no heartbeat.

members: Vec<String>

Agents this agent can delegate to via spawn_task. Empty = no delegation.

skills: Vec<String>

Skill names this agent can access. Empty = all skills (walrus default).

mcps: Vec<String>

MCP server names this agent can access. Empty = all MCPs (walrus default).

tools: Vec<CompactString>

Computed tool whitelist. Empty = all tools. Not serialized.

Implementations

impl AgentConfig

pub fn new(name: impl Into<CompactString>) -> AgentConfig

Create a new config with the given name and defaults for everything else.

pub fn system_prompt(self, prompt: impl Into<String>) -> AgentConfig

Set the system prompt.

pub fn description(self, desc: impl Into<CompactString>) -> AgentConfig

Set the description.

pub fn model(self, name: impl Into<CompactString>) -> AgentConfig

Set the model to use from the registry.

pub fn thinking(self, enabled: bool) -> AgentConfig

Enable or disable thinking/reasoning mode.

Trait Implementations

impl Clone for AgentConfig

fn clone(&self) -> AgentConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AgentConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for AgentConfig

fn default() -> AgentConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AgentConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<AgentConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.