Struct FileTreeBuilder 

pub struct FileTreeBuilder { /* private fields */ }

Unconnected configuration — FileTree::laboratory / FileTree::daemon + builder methods + FileTreeBuilder::connect.

Implementations

impl FileTreeBuilder

pub fn path(self, path: impl Into<String>) -> Self

Scope the watch to an absolute path inside the container. Laboratory variant only: the daemon endpoint always serves the laboratory’s workspace (its cwd) and ignores this.

pub fn signature(self, signature: impl Into<String>) -> Self

Attach the daemon auth signature (the pre-derived sha256=<hex(SHA256(DAEMON_SECRET))>), sent as the X-OBJECTIVEAI-SIGNATURE header. Daemon variant only; without it the daemon must be running without a secret.

pub fn host( self, machine: impl Into<String>, machine_state: impl Into<String>, ) -> Self

Pin the exact serving host (?machine=…&machine_state=…) — laboratory ids are only unique per (machine, state). Daemon variant only; omit for the legacy first-match-by-id scan.

pub fn on_change( self, callback: impl Fn(&[FileTreeNode]) + Send + Sync + 'static, ) -> Self

Register a callback invoked with the full current tree after every applied change. Runs on the pump task, so keep it cheap and non-blocking; for the tree on demand use tree.

pub async fn connect(self) -> Result<FileTree, Error>

Open the SSE stream and start the pump. The returned FileTree immediately begins folding events (the first is the endpoint’s connect-time snapshot).