Struct AcpRuntimeManager 

pub struct AcpRuntimeManager { /* private fields */ }

Manages Node.js / uv runtime discovery and auto-download.

Implementations

impl AcpRuntimeManager

pub fn new(paths: AcpPaths) -> AcpRuntimeManager

Create a new runtime manager backed by the given AcpPaths.

pub async fn is_runtime_available(&self, rt: &RuntimeType) -> bool

Returns true if the runtime is reachable (managed or system).

pub async fn get_version(&self, rt: &RuntimeType) -> Option<String>

Run {binary} --version and return the trimmed first line of output. Returns None if the runtime is not available or the command fails.

pub async fn get_runtime_path(&self, rt: &RuntimeType) -> Option<PathBuf>

Return the best path for a runtime: managed first, then system.

pub fn get_system_runtime(&self, rt: &RuntimeType) -> Option<RuntimeInfo>

Locate the runtime on the system PATH.

pub async fn get_managed_runtime(&self, rt: &RuntimeType) -> Option<RuntimeInfo>

Locate a previously downloaded (managed) runtime.

pub async fn ensure_runtime( &self, rt: &RuntimeType, ) -> Result<RuntimeInfo, String>

Ensure the runtime is available, downloading it if necessary.

Returns a RuntimeInfo with the resolved path.

pub async fn download_node( &self, version: &str, platform: &str, ) -> Result<PathBuf, String>

Download and extract Node.js for platform.

Returns the path to the node binary.

Concurrent calls for the same version are serialised by a per-key mutex and will re-use the already-extracted binary.

pub async fn download_uv( &self, version: &str, platform: &str, ) -> Result<PathBuf, String>

Download and extract uv for platform.

Returns the path to the uv binary.