Struct InterAgentMessage 

pub struct InterAgentMessage {
    pub id: Uuid,
    pub from_agent: String,
    pub to_agent: String,
    pub task: String,
    pub payload: Value,
    pub reply_to: Option<Uuid>,
    pub ttl: Duration,
    pub created_at_ms: i64,
}

A message exchanged between agents via the [AgentBus].

Each message has a unique ID, sender/recipient agent IDs, a task description, and an arbitrary JSON payload. Messages can optionally reference a parent message via reply_to for request/response patterns.

TTL enforcement

Messages have a time-to-live. If undelivered within this duration, they are dropped and logged at warn level.

Fields

id: Uuid

Unique message identifier.

from_agent: String

Agent ID of the sender.

to_agent: String

Agent ID of the recipient.

task: String

Task description or intent.

payload: Value

Arbitrary JSON payload.

reply_to: Option<Uuid>

If this is a reply, the ID of the original message.

ttl: Duration

Time-to-live: message expires if undelivered within this duration.

created_at_ms: i64

Timestamp when the message was created (milliseconds since epoch).

Implementations

impl InterAgentMessage

pub fn new( from_agent: impl Into<String>, to_agent: impl Into<String>, task: impl Into<String>, payload: Value, ttl: Duration, ) -> Self

Create a new inter-agent message.

pub fn reply( original: &InterAgentMessage, payload: Value, ttl: Duration, ) -> Self

Create a reply to an existing message.

pub fn is_expired(&self) -> bool

Check whether this message has expired based on its TTL.

Trait Implementations

impl Clone for InterAgentMessage

fn clone(&self) -> InterAgentMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InterAgentMessage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for InterAgentMessage

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for InterAgentMessage

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

where __S: Serializer,

Serialize this value into the given Serde serializer.