Struct FilesystemWorkspace 

pub struct FilesystemWorkspace { /* private fields */ }

A safe headless adapter rooted at one canonical workspace directory.

Implementations

impl FilesystemWorkspace

pub async fn new<I>( root: impl AsRef<Path>, allowed_roots: I, mutations_allowed: bool, ) -> Result<Self>

where I: IntoIterator<Item = PathBuf>,

Construct an adapter. The current adapter exposes one canonical root; an empty allowlist means only the supplied root is visible.

pub fn with_limits(self, limits: FilesystemLimits) -> Self

Replace the default workspace limits.

pub fn with_allowed_commands<I, S>(self, commands: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Replace the allowlisted check executables.

pub fn with_checks_allowed(self, checks_allowed: bool) -> Self

Configure whether the runtime may execute the allowlisted checks.

pub async fn proposal_for_turn( &self, proposal_id: &str, ) -> Result<PatchProposal>

Return a still-current proposal for an active runtime turn handoff.

Rechecking the snapshots here prevents a browser proposal from being handed to the agent after an external edit occurred between proposal creation and turn submission.

pub fn root(&self) -> &Path

Returns the canonical primary workspace path.

Trait Implementations

impl Clone for FilesystemWorkspace

fn clone(&self) -> FilesystemWorkspace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FilesystemWorkspace

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

Formats the value using the given formatter.

impl RuntimeAdapter for FilesystemWorkspace

fn status<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<RuntimeStatus>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Return current workspace and permission state.

fn list_files<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<WorkspaceFile>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

List files visible to the session.

fn read_file<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<FileSnapshot>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Read one visible file.

fn propose_changes<'life0, 'async_trait>( &'life0 self, changes: Vec<FileChange>, ) -> Pin<Box<dyn Future<Output = Result<PatchProposal>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Validate and stage a proposal without mutating the workspace.

fn apply_proposal<'life0, 'life1, 'async_trait>( &'life0 self, proposal_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<AppliedChange>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Apply a proposal through the runtime’s approval authority.

fn run_checks<'life0, 'life1, 'async_trait>( &'life0 self, command: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<CheckResult>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Run a runtime-approved check command.

fn revert_last_change<'life0, 'life1, 'async_trait>( &'life0 self, change_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<AppliedChange>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Revert a still-current last change.

fn request_turn<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, prompt: &'life1 str, _proposal_id: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = Result<TurnResult>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Submit a prompt and optional validated proposal to the active runtime.

fn cancel<'life0, 'life1, 'async_trait>( &'life0 self, _target_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Cancel a runtime request.