Struct RunHandle 

pub struct RunHandle {
    pub provider: ProviderKind,
    pub config: AgentRunConfig,
    pub prompt: String,
    pub messages: Vec<ProviderMessage>,
    pub expects_write: bool,
    pub steering: Option<Receiver<String>>,
    pub cancel: CancelToken,
    pub permission_hook: Option<ToolPermissionHook>,
    pub execution_hook: Option<ToolExecutionHook>,
}

Handle for a single agent run: provider kind, config, prompt, and cancel.

Fields

provider: ProviderKind

config: AgentRunConfig

prompt: String

messages: Vec<ProviderMessage>

expects_write: bool

steering: Option<Receiver<String>>

cancel: CancelToken

permission_hook: Option<ToolPermissionHook>

execution_hook: Option<ToolExecutionHook>

Implementations

impl RunHandle

pub fn spawn(self) -> Receiver<AgentEvent>

Spawn the unified agent loop on a background thread and return the receiver.

The thread closes its sender when done, so the receiver’s try_recv will return Err(Disconnected) once the run completes.

If the receiver is dropped early (e.g. the user cancels), the thread exits on the next failed send. The CancelToken inside the handle can also be signalled for cooperative cancellation.

pub fn fake(config: AgentRunConfig, prompt: String) -> Self

Create a fake-provider run handle.

pub fn provider_with_steering( config: AgentRunConfig, messages: Vec<ProviderMessage>, expects_write: bool, steering: Receiver<String>, ) -> Self

Create a provider run handle with a steering-message receiver.

pub fn with_permission_hook(self, hook: ToolPermissionHook) -> Self

Attach a permission hook for sensitive tool calls.

pub fn with_execution_hook(self, hook: ToolExecutionHook) -> Self

Attach an execution hook for front-end-specific tool handling.

Trait Implementations

impl Debug for RunHandle

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

Formats the value using the given formatter.