Struct PeerMessageHoldMessage 

pub struct PeerMessageHoldMessage {
    pub state: PeerMessageHoldState,
    pub message_uuid: Option<String>,
    pub lane: PeerMessageLane,
    pub from: String,
    pub from_name: Option<String>,
    pub cause: Option<PeerMessageHoldCause>,
    pub outcome: Option<PeerMessageHoldOutcome>,
    pub uuid: String,
    pub session_id: String,
    pub extra: Map<String, Value>,
}

system/peer_message_hold — a cross-session (peer) message this session’s receive-side policy held rather than queued, and how that hold resolved. Lets a host show the human that a message arrived but has not reached the model (and may never) instead of nothing at all; the sending session is told separately over its own transport where one exists. Informational only — there is no host-side approval through this frame. Emitted in -p/SDK sessions (CLI 2.1.273+).

Fields

state: PeerMessageHoldState

held once per message per hold cause (a re-announcement under a different cause emits again); then at most one of released (it enters the queue — its command_lifecycle queued and user replay echo follow under message_uuid) or dropped (it will never reach the model in this session; see outcome).

message_uuid: Option<String>

The parked command’s uuid — the value its later command_lifecycle frames and user replay echo carry. For lane bridge/stdin it is the id the host supplied on the inbound message; for lane socket it was chosen by the sending session, so correlate it only within peer_message_hold / peer replay frames, never against the host’s own prompts’ lifecycle.

lane: PeerMessageLane

Which ingress delivered it.

from: String

The sender’s address as the envelope will show it — an address-shaped token with control and invisible code points scrubbed; empty when the sender supplied none or an unshaped one. Sender-asserted on the socket lane: a label, not an identity proof.

from_name: Option<String>

The sender’s display name when it supplied one, normalized and scrubbed the same way. A claim, like from.

cause: Option<PeerMessageHoldCause>

State held only: why the policy parked it.

outcome: Option<PeerMessageHoldOutcome>

State dropped only: how the hold ended.

uuid: String

session_id: String

extra: Map<String, Value>

Trait Implementations

impl Clone for PeerMessageHoldMessage

fn clone(&self) -> PeerMessageHoldMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PeerMessageHoldMessage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PeerMessageHoldMessage

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PeerMessageHoldMessage

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

where __S: Serializer,

Serialize this value into the given Serde serializer.