Struct LocalWorkspace 

pub struct LocalWorkspace { /* private fields */ }

Local filesystem implementation of Workspace.

Implementations

impl LocalWorkspace

pub fn new(root: impl AsRef<Path>) -> Result<Self, WorkspaceError>

Constructs a local workspace from a root directory.

Errors

Returns WorkspaceError if the root cannot be canonicalized or is not an existing directory.

pub fn with_config( root: impl AsRef<Path>, config: LocalWorkspaceConfig, ) -> Result<Self, WorkspaceError>

Constructs a local workspace with explicit configuration.

Errors

Returns WorkspaceError if the root cannot be canonicalized or is not an existing directory.

pub fn change_tracker(&self) -> AgentChangeTracker

Returns the local change tracker.

Trait Implementations

impl Clone for LocalWorkspace

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LocalWorkspace

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

Formats the value using the given formatter.

impl Workspace for LocalWorkspace

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

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

Returns this workspace’s root.

fn resolve<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 WorkspacePath, access: WorkspaceAccess, ) -> Pin<Box<dyn Future<Output = Result<ResolvedPath, WorkspaceError>> + Send + 'async_trait>>

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

Resolves a root-relative path for a specific access mode.

fn read_file<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 WorkspacePath, options: FileReadOptions, ) -> Pin<Box<dyn Future<Output = Result<FileContent, WorkspaceError>> + Send + 'async_trait>>

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

Reads a file through workspace policy.

fn write_file<'life0, 'async_trait>( &'life0 self, request: WriteFileRequest, ) -> Pin<Box<dyn Future<Output = Result<FileWriteResult, WorkspaceError>> + Send + 'async_trait>>

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

Writes a file through workspace policy.

fn list_files<'life0, 'async_trait>( &'life0 self, query: ListFilesQuery, ) -> Pin<Box<dyn Future<Output = Result<Vec<WorkspaceEntry>, WorkspaceError>> + Send + 'async_trait>>

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

Lists files through workspace policy.

fn snapshot<'life0, 'async_trait>( &'life0 self, request: SnapshotRequest, ) -> Pin<Box<dyn Future<Output = Result<WorkspaceSnapshot, WorkspaceError>> + Send + 'async_trait>>

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

Captures a lightweight snapshot of file versions.

fn diff<'life0, 'async_trait>( &'life0 self, request: DiffRequest, ) -> Pin<Box<dyn Future<Output = Result<WorkspaceDiff, WorkspaceError>> + Send + 'async_trait>>

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

Diffs two snapshots.

fn apply_patch<'life0, 'async_trait>( &'life0 self, request: PatchRequest, ) -> Pin<Box<dyn Future<Output = Result<PatchResult, WorkspaceError>> + Send + 'async_trait>>

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

Applies or dry-runs a structured patch.