Struct Agent 

pub struct Agent { /* private fields */ }

Main agent orchestrator

Implementations

impl Agent

pub async fn new(config: AgentConfig) -> Result<Self>

Create a new agent instance

pub fn with_components( config: AgentConfig, components: AgentComponentSet, ) -> Self

Construct an agent from explicit components.

This helper enables embedding scenarios where callers manage dependencies (for example in open-source integrations or when providing custom tool registries).

pub fn with_components_and_optimization( config: AgentConfig, components: AgentComponentSet, optimization_config: OptimizationConfig, ) -> Self

Construct an agent with optimization configuration from VTCodeConfig.

This method provides full integration with the VT Code configuration system, enabling optimizations based on user settings in vtcode.toml.

pub fn component_builder(config: &AgentConfig) -> AgentComponentBuilder<'_>

Convenience constructor for customizing agent components via the builder pattern without manually importing the bootstrap module.

pub async fn initialize(&mut self) -> Result<()>

Initialize the agent with system setup

pub fn config(&self) -> &AgentConfig

Get the agent’s current configuration

pub fn session_info(&self) -> &SessionInfo

Get session information

pub fn optimization_config(&self) -> &OptimizationConfig

Get the optimization configuration

pub fn tool_registry_ref(&self) -> &ToolRegistry

Borrow the tool registry (now with integrated optimizations).

pub fn tool_registry(&self) -> &Arc<ToolRegistry>

Get the shared tool registry handle for callers that need to clone it.

pub fn has_optimizations_enabled(&self) -> bool

Check if optimizations are enabled in the tool registry

pub fn performance_metrics(&self) -> PerformanceMetrics

Get performance metrics

pub fn decision_tracker(&self) -> &DecisionTracker

Get decision tracker reference

pub fn decision_tracker_mut(&mut self) -> &mut DecisionTracker

Get mutable decision tracker reference

pub fn error_recovery(&self) -> &ErrorRecoveryManager

Get error recovery manager reference

pub fn error_recovery_mut(&mut self) -> &mut ErrorRecoveryManager

Get mutable error recovery manager reference

pub fn tool_registry_clone(&self) -> Arc<ToolRegistry>

Get tool registry reference

pub fn tool_registry_mut(&mut self) -> Result<&mut ToolRegistry>

Get mutable tool registry reference

Errors

Returns an error if the Arc has outstanding references (another clone exists).

pub fn llm(&self) -> &AnyClient

Get model-agnostic client reference

pub fn update_session_stats( &mut self, turns: usize, decisions: usize, errors: usize, )

Update session statistics

pub fn generate_context_plan( &self, context_size: usize, ) -> ContextPreservationPlan

Generate context preservation plan

pub fn detect_error_pattern( &self, error_type: &ErrorType, time_window_seconds: u64, ) -> bool

Check for error patterns

pub fn show_transparency_report(&self, detailed: bool)

Show transparency report

pub async fn shutdown(&mut self) -> Result<()>

Shutdown the agent and cleanup resources