Module agent 

Agent infrastructure and configuration. Agent Infrastructure

Core infrastructure for building LLM-powered agents.

This module provides:

• AgentCore - Complete working agent infrastructure
• Message types for Frontend-Controller communication
• Input routing between Frontend and controller
• Logging infrastructure
• Configuration management with trait-based customization

Quick Start (Headless)

use agent_core_runtime::agent::{AgentConfig, AgentCore};

struct MyConfig;
impl AgentConfig for MyConfig {
    fn config_path(&self) -> &str { ".myagent/config.yaml" }
    fn default_system_prompt(&self) -> &str { "You are helpful." }
    fn log_prefix(&self) -> &str { "myagent" }
    fn name(&self) -> &str { "MyAgent" }
}

fn main() -> std::io::Result<()> {
    let mut core = AgentCore::new(&MyConfig)?;
    core.start_background_tasks();

    // Get channels for custom frontend integration
    let tx = core.to_controller_tx();
    let rx = core.take_from_controller_rx();

    // Create a session and interact programmatically
    let (session_id, model, _) = core.create_initial_session()?;
    // ... implement your own event loop

    core.shutdown();
    Ok(())
}

Re-exports

pub use crate::controller::ControllerEvent;

pub use crate::controller::ControllerInputPayload;

pub use crate::controller::LLMController;

pub use crate::controller::LLMSessionConfig;

pub use crate::controller::PermissionRegistry;

pub use crate::controller::ToolResultStatus;

pub use crate::controller::TurnId;

pub use crate::controller::UserInteractionRegistry;

Structs

AgentCore

AgentCore - Core runtime infrastructure for LLM-powered agents.

ConfigFile

Root configuration structure from YAML

EnvironmentContext

Environment context information.

InputRouter

Routes messages from the TUI to the controller.

LLMRegistry

LLM Registry - stores loaded provider configurations

Logger

Tracing-based logger that writes to daily log files.

ProviderConfig

Provider configuration from YAML

ProviderInfo

Information about a known OpenAI-compatible provider.

Enums

AgentError

Error type for agent operations.

ConfigError

Configuration errors

UiMessage

Messages sent from the controller to the TUI for display

Constants

DEFAULT_CHANNEL_SIZE

Default channel buffer size for internal communication. This applies to all async channels: LLM responses, tool results, UI events, etc. Can be overridden via AgentConfig::channel_buffer_size().

Traits

AgentConfig

Trait for agent-specific configuration.

Functions

convert_controller_event_to_ui_message

Converts a ControllerEvent to a UiMessage for the frontend.

create_channels

Creates a pair of channels for TUI-Controller communication

get_provider_info

Returns provider info for a known provider name.

is_known_provider

Returns true if this is a known OpenAI-compatible provider.

list_providers

Returns a list of all known provider names.

load_config

Load config for an agent using its AgentConfig trait implementation.

Type Aliases

FromControllerRx

Receiver for messages from controller to frontend

FromControllerTx

Sender for messages from controller to frontend

ToControllerRx

Receiver for messages from frontend to controller

ToControllerTx

Sender for messages from frontend to controller