shellcanvas-filesystem-sdk 0.1.0

Optional filesystem handles and native bridge protocol for ShellCanvas
Documentation

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.