ShellCanvas filesystem SDK
Optional rooted filesystem handles for native bridge applications. This crate has no WinFsp, FUSE, SSH, desktop-window or kernel-driver dependency. It is MPL-2.0.
Providers implement MountedFileSystem only when they support filesystem-style
access. Sequential download/upload contracts remain separate. MountPath is a
validated sequence of relative components, not an arbitrary remote pathname.
wire::Server serves one explicitly granted provider/root through inherited
anonymous pipes. wire::Client is the blocking counterpart used by native OS
callbacks. Frames are length-prefixed JSON with a 1 MiB bound, protocol version
and monotonic request ID. File I/O uses 32 KiB chunks and directory replies use
pages; those are request bounds, not limits on file or directory totals.
One server instance owns its file/directory handles. Source reconnection creates a new grant; old handles must never be attached to it. A timed-out operation retires the transport and is not replayed. The desktop must supervise the native process and release its grant on teardown; this protocol is not a sandbox for native executables.
The independent Drive Bridge vendors a snapshot of this crate for standalone builds. Update that snapshot and validate the protocol whenever changing it.