Struct AgentRuntime 

pub struct AgentRuntime {
    pub config: AgentConfig,
    pub project_path: PathBuf,
    pub backend: Arc<dyn ShellBackend>,
}

A prepared agent runtime bound to a project directory + shell backend.

Fields

config: AgentConfig

project_path: PathBuf

backend: Arc<dyn ShellBackend>

Implementations

impl AgentRuntime

pub fn init(config: AgentConfig, project_path: PathBuf) -> Result<Self>

Initialize the runtime for project_path, building the appropriate shell backend. The native backend needs no setup; the fastshell backend initializes a VFS sandbox + embedded CPython.

pub fn with_fastshell( config: AgentConfig, project_path: PathBuf, fs: Arc<Mutex<Fastshell>>, ) -> Self

Initialize reusing an already-constructed fastshell handle (FFI path where the host already called fastshell_init on the same sandbox). Forces the fastshell backend regardless of config.

pub fn backend_kind(&self) -> &'static str

Which backend is active (for diagnostics).

pub fn validate_api_key(&self) -> Result<()>

Validate the configured API key with a lightweight probe. Uses a dedicated OS thread to avoid runtime nesting issues, reusing the shared runtime handle (no per-call Runtime::new() thread churn).

pub async fn run_task( &self, task: &str, session_id: Option<&str>, emitter: &dyn EventSink, cancel: &AtomicBool, ) -> Result<RunResult>

Run a task to completion, streaming events to emitter. session_id optionally continues an existing session.