Struct HostBuilder 

pub struct HostBuilder { /* private fields */ }

Builder that mounts modules and lowers them into a runnable Host.

Implementations

impl HostBuilder

pub fn new() -> Self

Create an empty host builder backed by the production ThreadSpawn.

pub fn receipt_sink<S>(self, sink: S) -> Self

where S: ReceiptSink + 'static,

Attach the receipt sink the composed runtime records into.

pub fn status_sink<S>(self, sink: S) -> Self

where S: OperationStatusSink + Send + Sync + 'static,

Wire an operation-status sink through to the composed runtime.

Operations mounted through this host then emit syncbat::OperationStatusFactV1 lifecycle facts (started / terminal) exactly as they would through a bare syncbat::CoreBuilder::status_sink. Without a sink bound, no lifecycle facts are recorded.

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

Grant one runtime capability token to the composed runtime (repeatable).

An operation declaring a required capability token (via OperationEffectRow::requires_capability or the #[operation] macro) dispatches only when every named token was granted here; otherwise the runtime fails closed, exactly as with syncbat::CoreBuilder::grant_capability.

pub fn grant_capabilities<I, S>(self, capabilities: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Grant several runtime capability tokens; see Self::grant_capability for the gate semantics.

pub fn effect_backend<B>(self, backend: B) -> Self

where B: EffectBackend + 'static,

Attach the runtime-owned effect backend operations append through.

Operations append events only via Ctx, which performs the append through this backend; without it bound, an append_event call fails closed instead of reaching a store the runtime did not mediate.

pub fn host_control<C>(self, controller: C) -> Self

where C: HostController + 'static,

Attach the controller that performs a Control operation’s declared host controls.

Control operations reach host authority only via Ctx, which performs the identified control through this controller; without it bound, a use_host_control call fails closed instead of touching the host. The composed host-control backend layers OUTER over any effect_backend, so the store axes still flow through that inner backend.

pub fn mount(self, module: HostModule) -> Result<Self, HostError>

Mount a module, validating it against everything already mounted.

Errors

A HostError collision variant if the module’s id, any operation, receipt namespace, or job kind clashes with a mounted module; or HostError::ModuleHashMismatch if the module’s manifest does not match its declared parts.

pub fn build(self) -> Result<Host, HostError>

Lower the mounted modules into a runnable Host.

Errors

HostError::EmptyHost if nothing is mounted; HostError::ModuleCoherence if a declared operation has no handler; HostError::Build if the lowered syncbat runtime does not validate; or HostError::CanonicalEncoding if the fingerprint cannot be sealed.

Trait Implementations

impl Default for HostBuilder

fn default() -> Self

Returns the “default value” for a type.