Struct AgentDefinition 

pub struct AgentDefinition {

    pub id: AgentId,
    pub name: String,
    pub display_name: Option<String>,
    pub description: Option<String>,
    pub system_prompt: String,
    pub default_model_id: Option<ModelId>,
    pub capabilities: Vec<CapabilityRef>,
    pub initial_files: Vec<InitialFile>,
    pub network_access: Option<NetworkAccessList>,
    pub max_iterations: Option<usize>,
    pub parallel_tool_calls: Option<bool>,
    pub tools: Vec<ToolDefinition>,
    pub mcp_servers: ScopedMcpServers,
}

Portable authored execution configuration for an agent.

Carries exactly what turn execution consumes: the agent’s identity for correlation plus the authored configuration layer merged between the harness chain and the session overlay. It is not a persistence record — stored lifecycle/versioning metadata stays in everruns-platform.

Fields

id: AgentId

Public agent identifier (agent_<32-hex>), used for correlation and session/agent mismatch validation during snapshot projection.

name: String

Addressable name, unique per org (e.g. “customer-support”).

display_name: Option<String>

Human-readable display name; falls back to name when absent.

description: Option<String>

Human-readable description of what the agent does.

system_prompt: String

System prompt contributed by the agent layer.

default_model_id: Option<ModelId>

Default LLM model; overridable at the session layer.

capabilities: Vec<CapabilityRef>

Capabilities enabled for this agent with per-agent configuration.

initial_files: Vec<InitialFile>

Starter files copied into each new session for this agent.

network_access: Option<NetworkAccessList>

Network access list merged with harness and session layers.

max_iterations: Option<usize>

Maximum number of LLM iterations per turn for this agent.

parallel_tool_calls: Option<bool>

Request-level parallel tool calling preference (EVE-598).

tools: Vec<ToolDefinition>

Client-side tools registered for this agent.

mcp_servers: ScopedMcpServers

Remote MCP servers scoped to this agent and inherited by its sessions.

Implementations

impl AgentDefinition

pub fn new( id: AgentId, name: impl Into<String>, system_prompt: impl Into<String>, ) -> Self

Create a definition with the given identity and prompt; all other configuration starts empty.

Trait Implementations

impl Clone for AgentDefinition

fn clone(&self) -> AgentDefinition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentDefinition

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentDefinition

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&AgentDefinition> for AgentConfigOverlay

fn from(a: &AgentDefinition) -> Self

Converts to this type from the input type.

impl Serialize for AgentDefinition

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

where __S: Serializer,

Serialize this value into the given Serde serializer.