Struct Environment 

pub struct Environment { /* private fields */ }

Concrete execution/filesystem environment selected for a session.

This bundles the selected backend metadata together with the local runtime paths used by filesystem helpers.

Implementations

impl Environment

pub fn default_for_tests() -> Self

Builds a test-only local environment without configured sandbox helper paths.

impl Environment

pub fn create( exec_server_url: Option<String>, local_runtime_paths: ExecServerRuntimePaths, ) -> Result<Self, ExecServerError>

Builds an environment from the raw CODEX_EXEC_SERVER_URL value.

pub fn create_for_tests( exec_server_url: Option<String>, ) -> Result<Self, ExecServerError>

Builds a test-only environment without configured sandbox helper paths.

pub fn is_remote(&self) -> bool

pub fn selected_capability_roots(&self) -> &[SelectedCapabilityRoot]

Returns capability roots supplied with the deferred environment’s ready signal.

pub fn subscribe_connection_state( &self, ) -> Option<Receiver<EnvironmentConnectionState>>

Subscribes to the current connection state for this remote environment.

pub fn local_runtime_paths(&self) -> Option<&ExecServerRuntimePaths>

pub async fn info(&self) -> Result<EnvironmentInfo, ExecServerError>

Returns environment information from the selected execution/filesystem environment.

pub async fn discover_capability_roots( &self, params: CapabilityRootsDiscoverParams, ) -> Result<CapabilityRootsDiscoverResponse, ExecServerError>

Discovers plugin and skill manifests through the environment’s high-level discovery API.

pub fn start_connecting(&self)

Starts connecting a remote environment without waiting for it. Requires an active Tokio runtime when background startup is supported.

pub fn startup_finished(&self) -> bool

Returns whether initial startup has either succeeded or permanently failed.

pub async fn wait_until_ready(&self) -> Result<(), ExecServerError>

Waits for initial startup. A failed startup is never attempted again.

pub async fn status(&self) -> EnvironmentObservedStatus

Returns the environment’s status without starting or recovering it.

Local environments are always ready. Remote environments with an already-ready cached connection receive a fail-fast environment/status probe; other remote states are returned from cached connection state without waiting for startup or recovery.

pub fn get_exec_backend(&self) -> Arc<dyn ExecBackend>

pub fn get_http_client(&self) -> Arc<dyn HttpClient>

pub fn get_filesystem(&self) -> Arc<dyn ExecutorFileSystem>

pub fn get_filesystem_without_reconnect(&self) -> Arc<dyn ExecutorFileSystem>

Returns a filesystem view that fails instead of starting or waiting for a connection.

Trait Implementations

impl Clone for Environment

fn clone(&self) -> Environment

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Environment

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

Formats the value using the given formatter.