Struct AgentRunner 

pub struct AgentRunner { /* private fields */ }

Individual agent runner for executing specialized agent tasks

Implementations

impl AgentRunner

pub async fn execute_task( &mut self, task: &Task, contexts: &[ContextItem], ) -> Result<TaskResults>

Execute a task with this agent

impl AgentRunner

pub async fn execute_task_with_retry( &mut self, task: &Task, contexts: &[ContextItem], max_retries: u32, ) -> VtCodeResult<TaskResults>

Execute a task with automatic retry on transient failures

Wraps execute_task with retry logic using exponential backoff. Retries only occur for transient errors (timeouts, network issues, 5xx errors). Non-retryable errors (auth failures, invalid requests) fail immediately.

impl AgentRunner

pub async fn new( agent_type: AgentType, model: ModelId, api_key: String, workspace: PathBuf, session_id: String, settings: RunnerSettings, steering_receiver: Option<UnboundedReceiver<SteeringMessage>>, ) -> Result<Self>

Create a new agent runner.

pub async fn new_with_bootstrap( agent_type: AgentType, model: ModelId, api_key: String, workspace: PathBuf, session_id: String, settings: RunnerSettings, steering_receiver: Option<UnboundedReceiver<SteeringMessage>>, bootstrap: ThreadBootstrap, vt_cfg: Option<VTCodeConfig>, openai_chatgpt_auth: Option<OpenAIChatGptAuthHandle>, ) -> Result<Self>

Create an agent runner with prebuilt thread bootstrap, config, and auth.

pub fn set_quiet(&mut self, quiet: bool)

Enable or disable console output for this runner.

pub fn session_messages(&self) -> Vec<Message>

Snapshot the runner-owned conversation messages for archive persistence.

pub fn thread_handle(&self) -> ThreadRuntimeHandle

Clone the underlying thread handle so callers can capture snapshots.

pub fn enable_plan_mode(&self)

Enable read-only plan mode for the underlying tool registry.

pub fn disable_plan_mode(&self)

pub fn set_event_handler<F>(&mut self, handler: F)

where F: FnMut(&ThreadEvent) + Send + 'static,

Attach a callback that will be invoked for each structured event as it is recorded.

pub fn clear_event_handler(&mut self)

Remove any previously registered structured event callback.

pub fn set_system_prompt(&mut self, system_prompt: impl Into<String>)

Override the composed system prompt for downstream embedders.

pub fn tool_registry(&self) -> ToolRegistry

Clone the underlying tool registry so embedders can register custom tools.

pub fn set_tool_definitions_override( &mut self, definitions: Vec<ToolDefinition>, )

pub fn clear_tool_definitions_override(&mut self)

pub fn set_tool_arg_transform( &mut self, transform: Arc<dyn Fn(&str, Value) -> Value + Send + Sync>, )

pub fn clear_tool_arg_transform(&mut self)

pub async fn enable_full_auto(&mut self, allowed_tools: &[String])

Enable full-auto execution with the provided allow-list.

pub async fn review_tool_allowlist( &self, allowed_tools: &[String], ) -> Vec<String>

Restrict an allow-list to tools suitable for strict review-only runs.