Struct AgentRuntimeBuilder 

pub struct AgentRuntimeBuilder {
    pub parent_agent_last_uuid: Option<String>,
    /* private fields */
}

Builder for AgentRuntime.

Required

• llm(...) — The LLM provider.

All other methods are optional with sensible defaults.

Fields

parent_agent_last_uuid: Option<String>

UUID of the parent agent’s last message. When set, the first MessageAppended event will carry this as parent_uuid, branching the subagent’s messages off that point in the conversation tree (g155). Stored here for future multi-agent orchestration; not yet wired to the actual event emission path.

Implementations

impl AgentRuntimeBuilder

pub fn new() -> Self

Create a new builder with default values.

pub fn parent_agent_last_uuid(self, uuid: impl Into<String>) -> Self

Set the UUID of the parent agent’s last message.

When set, this runtime’s messages will be stamped with this UUID as parent_uuid on their first MessageAppended event, branching the subagent chain off the given point in the parent’s conversation tree (g155). Currently stored for future multi-agent orchestration.

pub fn llm(self, llm: Arc<dyn LlmProvider>) -> Self

Set the LLM provider (required).

pub fn tools(self, tools: ToolRegistry) -> Self

Set the tool registry (optional, defaults to a local empty registry).

pub fn system_prompt(self, prompt: impl Into<String>) -> Self

Set an initial system prompt (optional).

This is prepended to the transcript as the first message.

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

Set the maximum number of LLM calls per turn (optional, default 32).

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

Set a transcript character limit (optional, default unlimited).

pub fn compactor(self, compactor: Compactor) -> Self

Set an optional compactor for summarising old messages.

pub fn streaming(self, enabled: bool) -> Self

Enable or disable streaming of partial tokens (optional, default false).

pub fn planning_mode(self, mode: PlanningMode) -> Self

Set the planning mode (optional, defaults to PlanningMode::Immediate).

pub fn hooks(self, hooks: HookRegistry) -> Self

Set the hook registry (optional).

pub fn seed_transcript(self, messages: Vec<Message>) -> Self

Seed the transcript with messages from a previous session.

These messages are placed after any system prompt, before the first user turn. Use this to resume an existing conversation.

pub fn permission_hook(self, hook: Arc<dyn PermissionHook>) -> Self

Set an optional permission hook for tool-call interception.

pub fn event_sink(self, sink: Arc<dyn EventSink>) -> Self

Set the event sink for streaming events (optional, defaults to NullSink).

pub fn shutdown_token(self, token: CancellationToken) -> Self

Set the cancellation token for graceful shutdown. When the token is cancelled, the runtime’s underlying kernel terminates the step loop with FinishReason::Cancelled at the next step boundary.

pub fn build(self) -> Result<AgentRuntime>

Build the AgentRuntime.

Returns an error if the LLM provider is missing.

Trait Implementations

impl Debug for AgentRuntimeBuilder

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

Formats the value using the given formatter.

impl Default for AgentRuntimeBuilder

fn default() -> Self

Returns the “default value” for a type.