Module cluster 

Cluster membership and node fabric.

Defines types for multi-node WeftOS clusters where agents can migrate between nodes. Each node is a WeftOS kernel instance – native binary on cloud/edge, or WASM in a browser.

Feature Gate

All types compile unconditionally. Actual peer discovery, health monitoring, and cross-node communication require the cluster feature flag and a distributed networking layer.

Structs

ClusterConfig

Cluster configuration.

ClusterMembership

ClusterPeersFile

On-disk format for persisted cluster peers.

ClusterService

Native coordinator cluster service.

NodeEccCapability

ECC capabilities advertised by a cluster node.

NodeIdentity

Node identity derived from Ed25519 keypair.

PairedHost

A single paired host record.

PairedHostsFile

Persistent record of paired hosts.

PairingGate

Manages the pairing window state and persistent paired host list.

PairingWindowResult

Result returned when a pairing window is opened.

PeerNode

Information about a peer node in the cluster.

Enums

ClusterError

Cluster membership errors.

NodePlatform

Node platform type.

NodeState

Node health state.

Constants

UNVERIFIED_REAP_EVERY

How often the mesh listeners look for expired Unverified peers.

UNVERIFIED_TTL

How long an Unverified mesh peer may go unheard before membership drops it (see ClusterMembership::expire_unverified).

Type Aliases

NodeId

Unique node identifier (UUID or DID string).