Struct AgentBuilder 

pub struct AgentBuilder { /* private fields */ }

Builder for configuring and creating an Agent

Example

use elo::Agent;

let agent = Agent::builder()
    .storage_path("/var/lib/loa")
    .identity_path("/etc/loa/agent_id.key")
    .dashboard_port(3000)
    .build()
    .await?;

Implementations

impl AgentBuilder

pub fn storage_path<P: AsRef<Path>>(self, path: P) -> Self

Set the storage path for databases and persistent data

This is required. If not set, build() will return an error.

Example

use elo::Agent;

let agent = Agent::builder()
    .storage_path("/var/lib/loa")
    .build()
    .await?;

pub fn identity_path<P: AsRef<Path>>(self, path: P) -> Self

Set the identity path for agent identity key

If not specified, defaults to {storage_path}/agent_id.key

Example

use elo::Agent;

let agent = Agent::builder()
    .storage_path("/var/lib/loa")
    .identity_path("/etc/loa/agent_id.key")
    .build()
    .await?;

pub fn dashboard_port(self, port: u16) -> Self

Set the dashboard port

Optional. If set, a dashboard will be served on this port (future feature).

Example

use elo::Agent;

let agent = Agent::builder()
    .storage_path("/var/lib/loa")
    .dashboard_port(3000)
    .build()
    .await?;

pub fn claim<S: Into<String>>(self, claim_token_id: S) -> Self

Claim this agent for a workspace using a claim token

This allows immediate agent claiming during startup. The claim_token_id is sent with the heartbeat for self-registration, linking the agent to a workspace.

Example

use elo::Agent;

let agent = Agent::builder()
    .storage_path("/var/lib/loa")
    .claim("550e8400-e29b-41d4-a716-446655440000")
    .build()
    .await?;

pub async fn build(self) -> Result<Agent>

Build the agent and spawn all internal actors

This will:

1. Validate configuration
2. Create storage directories if needed
3. Spawn the root supervisor
4. Spawn all core actors (currently empty)
5. Return an Agent handle

Errors

Returns an error if:

• storage_path is not set
• storage directories cannot be created
• supervisor fails to spawn

Example

use elo::Agent;

let agent = Agent::builder()
    .storage_path("/var/lib/loa")
    .build()
    .await?;

agent.run().await?;