Struct TypedRuntimeBuilder 

pub struct TypedRuntimeBuilder<S = Empty> { /* private fields */ }

Type-state builder that enforces required fields at compile time.

S tracks which required fields have been set:

• Empty: No required fields set
• HasLlm: LLM port set, default model not set
• Ready: All required fields set, build() available

Implementations

impl TypedRuntimeBuilder<Empty>

pub fn new() -> Self

Create a new empty builder.

pub fn with_llm(self, llm: Arc<dyn LlmPort>) -> TypedRuntimeBuilder<HasLlm>

Set the LLM port. Transitions to HasLlm state.

impl TypedRuntimeBuilder<HasLlm>

pub fn with_default_model( self, model: impl Into<String>, ) -> TypedRuntimeBuilder<Ready>

Set the default model. Transitions to Ready state.

pub fn with_store(self, store: Arc<dyn SessionStore>) -> Self

Set the session store. (Stays in HasLlm state.)

pub fn with_events(self, events: Arc<dyn EventSink>) -> Self

Set the event sink. (Stays in HasLlm state.)

pub fn with_tools(self, tools: Arc<dyn ToolPort>) -> Self

Set the tools port.

pub fn with_policy(self, policy: TurnPolicy) -> Self

Set the turn policy.

pub fn with_dispatch_mode(self, mode: DispatchMode) -> Self

Set the dispatch mode.

pub fn add_tool_layer(self, layer: Arc<dyn ToolLayer>) -> Self

Add a tool layer.

pub fn with_tool_policy(self, policy: Arc<dyn ToolPolicyPort>) -> Self

Set the tool policy port.

pub fn with_approval(self, approval: Arc<dyn ApprovalPort>) -> Self

Set the approval port.

pub fn with_checkpoint_store( self, store: Arc<dyn TurnCheckpointStorePort>, ) -> Self

Set the checkpoint store.

pub fn with_artifact_store(self, store: Arc<dyn ArtifactStorePort>) -> Self

Set the artifact store.

pub fn with_cost_meter(self, meter: Arc<dyn CostMeterPort>) -> Self

Set the cost meter.

pub fn with_context_compactor( self, compactor: Arc<dyn ContextCompactorPort>, ) -> Self

Set the context compactor.

pub fn with_journal(self, journal: Arc<dyn ToolJournalPort>) -> Self

Set the tool journal.

impl TypedRuntimeBuilder<Ready>

pub fn build(self) -> Result<Arc<dyn AgentRuntime>, AgentError>

Build the runtime. Only available when all required fields are set.

impl TypedRuntimeBuilder<Ready>

pub fn with_store(self, store: Arc<dyn SessionStore>) -> Self

Set the session store. (On Ready, overrides any previous value.)

pub fn with_events(self, events: Arc<dyn EventSink>) -> Self

Set the event sink. (On Ready, overrides any previous value.)

pub fn with_tools(self, tools: Arc<dyn ToolPort>) -> Self

Set the tools port.

pub fn with_policy(self, policy: TurnPolicy) -> Self

Set the turn policy.

Trait Implementations

impl<S> Debug for TypedRuntimeBuilder<S>

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

Formats the value using the given formatter.

impl<S: Default> Default for TypedRuntimeBuilder<S>

fn default() -> TypedRuntimeBuilder<S>

Returns the “default value” for a type.