Struct Message 

pub struct Message<T> {
    pub wire_version: u8,
    pub msg_id: Uuid,
    pub correlation_id: Option<Uuid>,
    pub sender: DaemonId,
    pub timestamp: Timestamp,
    pub payload: T,
    pub security_level: SecurityLevel,
    pub verified_sender_name: Option<String>,
    pub origin_installation: Option<InstallationId>,
    pub agent_id: Option<AgentId>,
    pub trust_snapshot: Option<TrustVector>,
}

The IPC bus message envelope wrapping any payload type.

Debug is manually implemented to delegate to T’s Debug impl. When T = EventKind, the payload’s custom Debug redacts secret fields.

Fields

wire_version: u8

Wire format version. Always serialized first. Receivers should check this before interpreting remaining fields.

msg_id: Uuid

Unique message identifier (UUID v7 for time-ordering).

correlation_id: Option<Uuid>

Correlation ID for request-response patterns.

sender: DaemonId

Sender daemon identity.

timestamp: Timestamp

Dual-clock timestamp.

payload: T

The event or request payload.

security_level: SecurityLevel

Access control level for this message.

verified_sender_name: Option<String>

Server-stamped verified sender name from Noise IK registry lookup.

Set by route_frame() in the bus server — never trust client-supplied values. None for unregistered clients (CLI, Open clearance). Note: no skip_serializing_if — postcard uses positional encoding, so the field must always be present in the wire format for decode compatibility.

origin_installation: Option<InstallationId>

Installation identity of the sender. No skip_serializing_if — postcard positional encoding requires all fields present.

agent_id: Option<AgentId>

Agent identity of the sender.

trust_snapshot: Option<TrustVector>

Trust snapshot at time of message creation.

Implementations

impl<T: Serialize> Message<T>

pub fn new( ctx: &MessageContext, payload: T, security_level: SecurityLevel, epoch: Instant, ) -> Self

Create a new message with a fresh UUID v7 and current timestamp.

pub fn with_correlation(self, id: Uuid) -> Self

Set a correlation ID for request-response linking.

Trait Implementations

impl<T: Clone> Clone for Message<T>

fn clone(&self) -> Message<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Message<T>

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for Message<T>

where T: Deserialize<'de>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> Serialize for Message<T>

where T: Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.