Struct Message 

pub struct Message {
    pub text: String,
    pub origin: MessageOrigin,
    pub attachments: Option<Vec<MessageAttachment>>,
    pub model: Option<ModelSelection>,
    pub agent: Option<AgentSelection>,
    pub meta: Option<JsonObject>,
}

A message that initiates or steers a turn. Messages can originate from the user, the agent, a tool, or be system-generated (see {@link MessageOrigin}).

Attachments MAY be referenced inside {@link Message.text} via their {@link MessageAttachmentBase.range} field. Attachments without a range are still associated with the message but do not correspond to a specific span in the text.

Fields

text: String

Message text

origin: MessageOrigin

The origin of the message

attachments: Option<Vec<MessageAttachment>>

File/selection attachments

model: Option<ModelSelection>

The model this message was, or will be, sent with.

For historic user/agent messages this records the model actually used, so a client editing or resending the message can retain that selection. For a {@link ChatState.draft | draft} it carries the model the user picked for the message they are composing. Absent means the agent host’s default model applies.

agent: Option<AgentSelection>

The custom agent this message was, or will be, sent with.

For historic messages this records the agent actually used; for a {@link ChatState.draft | draft} it carries the agent the user picked. Absent means no custom agent — the provider’s default behavior applies.

meta: Option<JsonObject>

Additional provider-specific metadata for this message.

Clients MAY look for well-known keys here to provide enhanced UI, and agent hosts MAY use it to carry context that does not fit any other field. Mirrors the MCP _meta convention.

Trait Implementations

impl Clone for Message

fn clone(&self) -> Message

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Message

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

Formats the value using the given formatter.

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

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Message

fn eq(&self, other: &Message) -> 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 Message

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 Message