Enum WireMessage 

pub enum WireMessage {
    Snapshot(SystemSnapshot),
    Heartbeat {
        server_version: String,
        uptime_secs: u64,
    },
    Error {
        code: u16,
        message: String,
    },
    Hello {
        client_version: String,
        auth_token: Option<String>,
    },
    Welcome {
        server_version: String,
        hostname: String,
        refresh_hz: u32,
    },
}

Wire protocol messages exchanged between muxtop client and server.

Uses a custom Debug impl to redact auth_token in Hello messages, preventing accidental token leakage in logs or panic messages.

Variants

Snapshot(SystemSnapshot)

Full system snapshot (server → client).

Heartbeat

Keepalive heartbeat (server → client).

Fields

server_version: String

uptime_secs: u64

Error

Error message (server → client).

Fields

code: u16

message: String

Hello

Client handshake (client → server).

Fields

client_version: String

auth_token: Option<String>

Welcome

Server handshake response (server → client).

Fields

server_version: String

hostname: String

refresh_hz: u32

Implementations

impl WireMessage

pub fn encode_snapshot_ref(snap: &SystemSnapshot) -> Result<Frame, ProtoError>

Encode a SystemSnapshot into a Snapshot frame without taking ownership of the snapshot.

Per ADR-30-4 the relay path holds an Arc<SystemSnapshot> and needs to produce a single encoded Frame that it can then broadcast as bytes to every client task. Calling to_frame() would require constructing a WireMessage::Snapshot variant that owns the SystemSnapshot, which defeats the whole point of the Arc. This helper bypasses the wrapper and encodes directly from a borrow.

pub fn to_frame(&self) -> Result<Frame, ProtoError>

Serialize this message into a Frame.

pub fn from_frame(frame: &Frame) -> Result<Self, ProtoError>

Deserialize a Frame into a WireMessage.

Trait Implementations

impl Clone for WireMessage

fn clone(&self) -> WireMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WireMessage

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WireMessage

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for WireMessage

fn eq(&self, other: &WireMessage) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for WireMessage

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for WireMessage