Struct MembraneHandle 

pub struct MembraneHandle { /* private fields */ }

Shared, cheaply cloneable access to the located membrane binary.

Implementations

impl MembraneHandle

pub fn connect() -> Self

Locate Pulse’s membrane (env override, notch state, resident file, installed path). Touches the filesystem only; the binary is verified lazily on first call.

pub fn shared() -> Self

The one process-wide handle: a single discovery and a single membrane where check, shared by the memory backend, DaemonState.membrane and the transcript exporter.

pub fn verified_cli(&self) -> Option<MembraneCli>

The verified adapter, or None when Pulse is absent or the binary failed verification.

pub fn backend_arc(&self) -> Arc<dyn MembraneBackend + Send + Sync>

Shareable MembraneBackend: the verified CLI, else Unavailable.

pub fn from_cli(cli: MembraneCli) -> Self

Use an explicit adapter (custom timeout, test binary).

pub fn is_off(&self) -> bool

True when no Pulse binary was found.

pub fn off_reason(&self) -> Option<String>

off: pulse not installed, or the verify failure. May run membrane where (bounded).

pub fn call_blocking<T>( &self, f: impl FnOnce(&dyn MembraneBackend) -> Result<T, MembraneError>, ) -> Result<T, MembraneError>

Synchronous call, bounded by the adapter’s per-invocation timeout.

pub async fn call<T, F>( &self, context: &CallContext, mutation: bool, f: F, ) -> Result<T, MemoryBackendError>

where T: Send + 'static, F: FnOnce(&dyn MembraneBackend) -> Result<T, MembraneError> + Send + 'static,

Async call on the blocking pool, bounded by the context deadline and cancellation. A timeout or cancellation of a mutation reports CommitUnknown.

pub async fn context_pull( &self, context: &CallContext, cwd: &Path, prompt: &str, budget: Option<usize>, repo: Option<&Path>, ) -> Result<ContextPull, MemoryBackendError>

Bounded async context pull. Pulse absent yields empty text with the off reason.

Trait Implementations

impl Clone for MembraneHandle

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.