Struct MountFs 

pub struct MountFs { /* private fields */ }

Mount-based resolver. Implements SessionFileSystem, so it drops into ToolContext / SystemPromptContext wherever the file store is wired.

Implementations

impl MountFs

pub fn new(workspace: Arc<dyn SessionFileSystem>) -> Self

Build a resolver over a single workspace backend.

The backend is mounted at both / (its native keyspace, for legacy absolute paths) and /workspace (the model-facing view). cwd defaults to /workspace.

pub fn with_display_policy(self, policy: DisplayPolicy) -> Self

Select how primary-workspace paths are presented. See DisplayPolicy for the rationale behind keeping presentation separate from routing.

pub fn with_backend_display(self) -> Self

Opt into backend-native presentation: primary paths are rendered by the backend’s own display_path/display_root (real host paths for a real-disk store), instead of the host-agnostic /workspace alias.

For local, single-user embedders (e.g. a coding CLI) where exposing the real host path is the intended, useful behavior. Routing is unchanged — only presentation. Do not use this on multi-tenant/server hosts; the default DisplayPolicy::WorkspaceAlias keeps host paths out of model-visible and persisted output (threat model TM-FS, PR #2776).

pub fn wrap(workspace: Arc<dyn SessionFileSystem>) -> Arc<dyn SessionFileSystem>

Build a resolver and return it as a trait object.

pub fn wrap_if_needed( workspace: Arc<dyn SessionFileSystem>, ) -> Arc<dyn SessionFileSystem>

Wrap only when workspace is not already a MountFs.

Re-wrapping would collapse nested mount tables (e.g. multi-root workspaces) into a single primary view and break named-mount display.

pub fn with_mount( self, mount_point: impl Into<String>, backend: Arc<dyn SessionFileSystem>, backend_root: impl Into<String>, ) -> Self

Register an additional mount (e.g. a read-only skills source or a named volume) backed by a different store. Longest-prefix wins at resolution.

pub fn cwd(&self) -> String

The current working directory (normalized virtual path).

Trait Implementations

impl SessionFileSystem for MountFs

fn display_root(&self) -> String

Human-facing root path for this filesystem.

fn is_mount_resolver(&self) -> bool

Whether this store is already a mount-based resolver ([MountFs]).

fn resolve_path(&self, input: &str) -> String

Resolve an input path (any accepted spelling, relative or absolute) to an absolute path within this filesystem’s namespace. Relative inputs resolve against the filesystem’s current directory.

fn display_path(&self, path: &str) -> String

Convert a canonical session path into a human-facing path.

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

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

Read a file by path

fn write_file<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, session_id: SessionId, path: &'life1 str, content: &'life2 str, encoding: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<SessionFile>> + Send + 'async_trait>>

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

Write/create a file

fn write_file_if_content_matches<'life0, 'life1, 'life2, 'life3, 'life4, 'life5, 'async_trait>( &'life0 self, session_id: SessionId, path: &'life1 str, expected_content: &'life2 str, expected_encoding: &'life3 str, content: &'life4 str, encoding: &'life5 str, ) -> Pin<Box<dyn Future<Output = Result<Option<SessionFile>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, 'life4: 'async_trait, 'life5: 'async_trait,

Write a file only if its current content snapshot still matches.

fn delete_file<'life0, 'life1, 'async_trait>( &'life0 self, session_id: SessionId, path: &'life1 str, recursive: bool, ) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>

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

Delete a file or directory

fn list_directory<'life0, 'life1, 'async_trait>( &'life0 self, session_id: SessionId, path: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<FileInfo>>> + Send + 'async_trait>>

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

List files in a directory

fn stat_file<'life0, 'life1, 'async_trait>( &'life0 self, session_id: SessionId, path: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<FileStat>>> + Send + 'async_trait>>

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

Get file metadata

fn grep_files<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, session_id: SessionId, pattern: &'life1 str, path_pattern: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = Result<Vec<GrepMatch>>> + Send + 'async_trait>>

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

Search file contents with Rust regex syntax, optionally filtering canonical paths by glob.

fn grep_files_with_options<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, session_id: SessionId, pattern: &'life1 str, options: &'life2 GrepOptions, ) -> Pin<Box<dyn Future<Output = Result<GrepSearchResult>> + Send + 'async_trait>>

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

Search with match pagination and bounded before/after context.

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

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

Create a directory

fn seed_initial_file<'life0, 'life1, 'async_trait>( &'life0 self, session_id: SessionId, file: &'life1 InitialFile, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

Seed a starter file into a session workspace.