Struct AgentLoop 

pub struct AgentLoop { /* private fields */ }

High-level agent orchestration loop.

Wraps an AgentRuntime with slash command routing, tape recording, and optional system prompt overrides.

Construction

let agent_loop = AgentLoop::new(runtime, tools)
    .with_tape(tape_store)
    .with_system_prompt("You are a helpful assistant.".to_string());

Implementations

impl AgentLoop

pub fn new(runtime: Arc<dyn AgentRuntime>, tools: Arc<dyn ToolPort>) -> Self

Create a new agent loop wrapping the given runtime and tool port.

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

Attach a session store for slash commands that inspect persisted state.

pub fn with_tape(self, tape: Arc<dyn TapeStorePort>) -> Self

Attach a tape store for persistent conversation recording.

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

Attach an event sink for observability.

pub fn with_system_prompt(self, prompt: String) -> Self

Set a system prompt that overrides the default runtime prompt.

This is typically loaded from a workspace file (e.g. .agent/system-prompt.md) at the composition root. The content is passed as a pre-loaded string to keep the runtime free from filesystem dependencies.

pub async fn handle_input( &self, input: &str, session_id: &str, ) -> Result<AgentLoopOutput, AgentError>

Process a single user input and return the appropriate output.

Slash commands are handled deterministically. Natural language input is forwarded to the LLM pipeline.

pub async fn handle_input_with_context( &self, input: &str, session_id: &str, context: RequestContext, ) -> Result<AgentLoopOutput, AgentError>

Process a single user input using an explicit request context.

Trait Implementations

impl Debug for AgentLoop

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

Formats the value using the given formatter.