Skip to main content

RemoteRunnerProvider

roder_api::remote_runner

Trait RemoteRunnerProvider 

Source 
pub trait RemoteRunnerProvider:
    Send
    + Sync
    + 'static {
    // Required methods
    fn id(&self) -> RemoteRunnerProviderId;
    fn capabilities(&self) -> RunnerCapabilities;
    fn create_session<'life0, 'async_trait>(
        &'life0 self,
        destination: RunnerDestination,
    ) -> Pin<Box<dyn Future<Output = Result<Arc<dyn RemoteRunnerSession>>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait;
    fn resume_session<'life0, 'async_trait>(
        &'life0 self,
        state: RunnerSessionState,
    ) -> Pin<Box<dyn Future<Output = Result<Arc<dyn RemoteRunnerSession>>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait;

    // Provided methods
    fn setup_hint(&self) -> Option<String> { ... }
    fn default_workspace(&self) -> Option<String> { ... }
    fn validate_destination<'life0, 'life1, 'async_trait>(
        &'life0 self,
        _destination: &'life1 RunnerDestination,
    ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait,
             'life1: 'async_trait { ... }
    fn rejoin_session<'life0, 'async_trait>(
        &'life0 self,
        state: RunnerSessionState,
    ) -> Pin<Box<dyn Future<Output = Result<Arc<dyn RemoteRunnerSession>>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait { ... }
}

Required Methods§

Source

fn id(&self) -> RemoteRunnerProviderId

Source

fn capabilities(&self) -> RunnerCapabilities

Source

fn create_session<'life0, 'async_trait>( &'life0 self, destination: RunnerDestination, ) -> Pin<Box<dyn Future<Output = Result<Arc<dyn RemoteRunnerSession>>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait,

Source

fn resume_session<'life0, 'async_trait>( &'life0 self, state: RunnerSessionState, ) -> Pin<Box<dyn Future<Output = Result<Arc<dyn RemoteRunnerSession>>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait,

Provided Methods§

Source

fn setup_hint(&self) -> Option<String>

  • Optional setup guidance shown by runner pickers when the provider is
  • installed but not yet usable (for example a missing credential env
  • var). Must name only documented env vars and never include secret
  • values. None means the provider is ready or needs no setup hint.
Source

fn default_workspace(&self) -> Option<String>

  • Default absolute workspace path on the runner for threads that select
  • this provider as a runtime-level destination without an explicit
  • per-thread workspace. When Some, selecting this runner (e.g. from the
  • TUI runner picker or config default_destination) routes a new thread’s
  • coding tools into the runner at this path. None (the default) keeps the
  • legacy behavior where only an explicit thread/start binding routes
  • tools, so other providers are unchanged.
Source

fn validate_destination<'life0, 'life1, 'async_trait>( &'life0 self, _destination: &'life1 RunnerDestination, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Source

fn rejoin_session<'life0, 'async_trait>( &'life0 self, state: RunnerSessionState, ) -> Pin<Box<dyn Future<Output = Result<Arc<dyn RemoteRunnerSession>>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait,

  • Reattach to a previously created remote sandbox from persisted state
  • without provisioning a new one. Providers that expose a durable,
  • rejoinable sandbox (see RunnerCapabilities::detachable) override this;
  • the default reuses resume_session.

Dyn Compatibility§

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors§