Struct AgentRuntimeBuilder 

pub struct AgentRuntimeBuilder<S = NeedsConfig> { /* private fields */ }

Builder for AgentRuntime.

Uses a typestate parameter S to enforce that with_agent_config is called before build(). Calling build() on a AgentRuntimeBuilder<NeedsConfig> is a compile-time error.

Typical usage:

let runtime = AgentRuntime::builder()      // AgentRuntimeBuilder<NeedsConfig>
    .with_memory(store)
    .with_agent_config(cfg)                // → AgentRuntimeBuilder<HasConfig>
    .build();                              // → AgentRuntime (infallible)

Builder for AgentRuntime.

Implementations

impl<S> AgentRuntimeBuilder<S>

pub fn with_memory(self, store: EpisodicStore) -> Self

Attach an episodic memory store.

pub fn with_working_memory(self, wm: WorkingMemory) -> Self

Attach a working memory store.

pub fn with_graph(self, graph: GraphStore) -> Self

Attach a graph store.

pub fn with_backpressure(self, guard: BackpressureGuard) -> Self

Attach a backpressure guard.

pub fn register_tool(self, spec: ToolSpec) -> Self

Register a tool available to the agent loop.

pub fn register_tools(self, specs: impl IntoIterator<Item = ToolSpec>) -> Self

Register multiple tools at once.

Equivalent to calling register_tool for each spec.

pub fn with_metrics(self, metrics: Arc<RuntimeMetrics>) -> Self

Attach a shared RuntimeMetrics instance.

pub fn with_token_estimator(self, estimator: Arc<dyn TokenEstimator>) -> Self

Provide a custom TokenEstimator for memory budget calculations.

Replaces the default len / 4 byte-counting heuristic. Use this to plug in a model-specific tokenizer (e.g. tiktoken, sentencepiece) so that AgentConfig::max_memory_tokens is respected accurately.

impl AgentRuntimeBuilder<NeedsConfig>

pub fn new() -> Self

Create a new builder (equivalent to Default::default()).

pub fn with_agent_config( self, config: AgentConfig, ) -> AgentRuntimeBuilder<HasConfig>

Set the agent loop configuration.

After this call the builder transitions to AgentRuntimeBuilder<HasConfig>, making build() available.

impl AgentRuntimeBuilder<HasConfig>

pub fn build(self) -> AgentRuntime

Build the AgentRuntime.

This is infallible: the typestate guarantees agent_config is present.

Trait Implementations

impl<S: DebugBuilderState> Debug for AgentRuntimeBuilder<S>

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

Formats the value using the given formatter.

impl Default for AgentRuntimeBuilder<NeedsConfig>

fn default() -> Self

Returns the “default value” for a type.