Struct CommandEnvelope 

pub struct CommandEnvelope { /* private fields */ }

A versioned command transport envelope.

Implementations

impl CommandEnvelope

pub fn new( command_id: CommandId, session_id: Option<SessionId>, timestamp: ProtocolTimestamp, command: AgentCommand, ) -> Result<Self, CommandValidationError>

Creates a validated current-version command envelope.

Errors

Returns an error when session presence or command payload invariants fail.

pub fn decode_value(value: Value) -> Result<Self, CommandDecodeError>

Decodes a JSON value while preserving unsupported-command classification.

Errors

Returns CommandDecodeError::UnsupportedType for an unknown safe discriminator and CommandDecodeError::Invalid for malformed input.

pub const fn protocol_version(&self) -> ProtocolVersion

Returns the protocol version read from or written to the envelope.

pub const fn command_id(&self) -> CommandId

Returns the command identifier.

pub const fn session_id(&self) -> Option<SessionId>

Returns the target session, absent only for session creation.

pub const fn timestamp(&self) -> ProtocolTimestamp

Returns the command timestamp.

pub const fn command(&self) -> &AgentCommand

Returns the command payload.

pub const fn command_type(&self) -> AgentCommandType

Returns the stable command discriminator.

Trait Implementations

impl Clone for CommandEnvelope

fn clone(&self) -> CommandEnvelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CommandEnvelope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CommandEnvelope

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for CommandEnvelope

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for CommandEnvelope

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 CommandEnvelope