Struct FileTree 

pub struct FileTree { /* private fields */ }

The materialized /filetree view — see the module docs. Construct via FileTree::laboratory or FileTree::daemon. Dropping it aborts the background pump.

Implementations

impl FileTree

pub fn laboratory(base_url: impl Into<String>) -> FileTreeBuilder

Build a FileTree against a laboratory MCP’s own /filetree endpoint, from its base HTTP address (e.g. http://127.0.0.1:<port> — the loopback-published container port). No auth — the port itself is the trust boundary.

pub fn daemon( base_url: impl Into<String>, laboratory_id: impl AsRef<str>, ) -> FileTreeBuilder

Build a FileTree against a CLI daemon’s /laboratories/{id}/filetree endpoint, from the daemon’s published http:// address and the RAW laboratory id (ids forbid /, so the URL is safe by construction). Same wire contract as the laboratory variant — the daemon re-emits the identical events from its own materialized state. Attach signature against a secretful daemon and host to pin the exact serving host.

pub async fn tree(&self) -> Vec<FileTreeNode>

Snapshot the current tree — the watched root’s child nodes. Empty before the first snapshot has been folded.

pub async fn subscribe(&self)

Block until the next change is applied. A fresh call waits for the FIRST change after it is made, so a change that lands between a preceding tree read and this call is not observed by it — pair with the read in a loop, or use the on_change callback for guaranteed push.

Trait Implementations

impl Drop for FileTree

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.