Struct Agent 

pub struct Agent {
    pub info: AgentInfo,
    pub provider: Arc<dyn Provider>,
    pub tools: ToolRegistry,
    pub permissions: HashMap<String, PermissionAction>,
    pub metadata: HashMap<String, ToolMetadata>,
    /* private fields */
}

Stateful runtime for executing prompts with tools and a provider.

An Agent owns the provider, tool registry, and permission metadata used while serving a session.

Examples

let agent = Agent::new(info, provider, tools, "system".into());

Fields

info: AgentInfo

Static metadata describing the agent.

provider: Arc<dyn Provider>

Provider used for model completions.

tools: ToolRegistry

Tool registry available to the agent.

permissions: HashMap<String, PermissionAction>

Per-tool permission policy for audit and enforcement.

metadata: HashMap<String, ToolMetadata>

Metadata for registered tools.

Implementations

impl Agent

pub fn new( info: AgentInfo, provider: Arc<dyn Provider>, tools: ToolRegistry, system_prompt: String, ) -> Self

Constructs a new agent from provider, tool, and prompt state.

The agent starts with empty permission and metadata maps so callers can customize them after construction.

Examples

let agent = Agent::new(info, provider, tools, "system".into());

impl Agent

pub async fn execute( &self, session: &mut Session, prompt: &str, ) -> Result<AgentResponse>

Executes a prompt against the agent until the run completes or max-steps is hit.

The agent appends the prompt to the session, loops through tool calls, and returns the final assistant text plus recorded usage data.

Examples

let response = agent.execute(&mut session, "review this file").await?;

impl Agent

pub fn get_tool(&self, name: &str) -> Option<Arc<dyn Tool>>

Returns a registered tool by name when it exists.

Examples

let bash = agent.get_tool("bash");

pub fn register_tool(&mut self, tool: Arc<dyn Tool>)

Registers a tool with the agent’s tool registry.

Examples

agent.register_tool(tool);

pub fn list_tools(&self) -> Vec<&str>

Lists all tool identifiers currently available to the agent.

Examples

let ids = agent.list_tools();

pub fn has_tool(&self, name: &str) -> bool

Returns whether a tool id is available to the agent.

Examples

assert!(agent.has_tool("bash") || !agent.has_tool("bash"));

Trait Implementations

impl Actor for Agent

fn actor_id(&self) -> &str

Get the unique identifier for this actor

fn actor_status(&self) -> ActorStatus

Get the actor’s current status

fn initialize<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Initialize the actor for swarm participation

fn shutdown<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Shutdown the actor gracefully

impl Handler<SwarmMessage> for Agent

type Response = SwarmMessage

The response type for this handler

fn handle<'life0, 'async_trait>( &'life0 mut self, message: SwarmMessage, ) -> Pin<Box<dyn Future<Output = Result<Self::Response>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Handle a message and return a response