Struct Remote 

pub struct Remote { /* private fields */ }

Implementations

impl Remote

pub fn new(cfg: RemoteConfig, limits: Limits) -> Self

pub fn host(&self) -> &str

pub fn address(&self) -> Address

How the remote is addressed from this machine, as OpenSSH resolves the destination: (hostname, port). The model needs this to report URLs the user can open; an alias from ~/.ssh/config means nothing to a browser. Falls back to the configured destination.

pub fn workdir(&self) -> &str

The workdir as configured (~ not yet expanded).

pub async fn effective_workdir(&self) -> Result<String>

The workdir with ~ expanded; connects if needed.

pub fn limits(&self) -> &Limits

pub async fn connect(&self) -> Result<()>

Connect now, or report why that is impossible.

pub async fn is_connected(&self) -> bool

pub async fn resolve(&self, raw: &str) -> Result<String>

Absolute remote path for what the model typed: ~ expands to the remote home, relative paths hang off the working directory.

pub async fn exec( &self, command: &str, cwd: Option<&str>, timeout_secs: Option<u64>, ) -> Result<ExecOutput>

Run command through the configured shell in cwd (default: the working directory). timeout_secs is clamped to the configured maximum.

pub async fn read_file(&self, path: &str, max: usize) -> Result<(Vec<u8>, u64)>

Read at most max bytes of a remote file. Returns the bytes and the file’s full length.

pub async fn write_file(&self, path: &str, content: &[u8]) -> Result<String>

Write a whole file, creating parent directories.

pub async fn exists(&self, path: &str) -> Result<Option<bool>>

pub async fn has_tool(&self, name: &str) -> Result<bool>

Whether a remote executable is on PATH.