Struct AgentWorldBuilder 

pub struct AgentWorldBuilder { /* private fields */ }

Builds an AgentWorld from plain values - no config file, no daemon.

let world = AgentWorld::builder()
    .provider(ProviderCreds::anthropic(api_key))
    .build()?;

Implementations

impl AgentWorldBuilder

pub fn provider(self, creds: ProviderCreds) -> Self

Add a provider from credentials (repeatable). See ProviderCreds for the supported providers.

pub fn register_provider( self, name: impl Into<String>, provider: Arc<dyn Provider>, ) -> Self

Register a custom Provider implementation under name (repeatable). Wins over a credentials entry with the same name.

pub fn default_model( self, provider: impl Into<String>, model: impl Into<String>, ) -> Self

The user-default provider/model, the fallback when none of a stage’s listed models has a registered provider.

pub fn fallback_model( self, provider: impl Into<String>, model: impl Into<String>, ) -> Self

Append a host-wide failover target, tried after a stage’s own entries and the default model when the provider in use stops answering.

Call it once per target, best first. This is what keeps a blueprint that names exactly one model running when that provider runs out of credits (issue #201).

pub fn tool_service(self, service: Arc<dyn ToolService>) -> Self

Replace the default BasicToolService with a custom tool service. The embed spawner then skips per-agent tool registration; the custom service sees agents through its own exec_for.

pub fn state_dir(self, dir: impl Into<PathBuf>) -> Self

Persist run state on disk under dir, in the daemon’s layout (<dir>/runs/<run_id>/, machine id at <dir>/machine-id). Without this the world runs entirely in memory and never touches disk.

pub fn inference_pool(self, config: InferencePoolConfig) -> Self

Per-model inference concurrency limits.

pub fn tool_concurrency(self, n: usize) -> Self

How many tool batches may execute concurrently (default 4).

pub fn prompt_hints(self, hints: PromptHints) -> Self

Opt in to the framework-authored system-prompt hints, off by default on this path. shell is worth turning on for a blueprint that grants the shell tool and may run on Windows: it tells the model that commands go through cmd.exe rather than a POSIX shell. A blueprint’s [agent] or [stages.<name>] batch_tool_hint / shell_hint still overrides this.

pub fn runtime(self, handle: Handle) -> Self

Run the world on handle instead of the ambient Tokio runtime.

pub fn build(self) -> Result<AgentWorld, EmbedError>

Assemble the world and start its serve loop on the Tokio runtime.