Struct Message 

pub struct Message {

    pub id: String,
    pub role: Role,
    pub content: String,
    pub reasoning: Option<String>,
    pub reasoning_signature: Option<String>,
    pub content_parts: Option<Vec<MessagePart>>,
    pub image_ocr: Option<Vec<ImageOcrResult>>,
    pub phase: Option<MessagePhase>,
    pub tool_calls: Option<Vec<ToolCall>>,
    pub tool_call_id: Option<String>,
    pub tool_success: Option<bool>,
    pub compressed: bool,
    pub compressed_by_event_id: Option<String>,
    pub never_compress: bool,
    pub compression_level: u8,
    pub created_at: DateTime<Utc>,
    pub metadata: Option<Value>,
}

A single message in a conversation.

Fields

id: String

role: Role

content: String

reasoning: Option<String>

reasoning_signature: Option<String>

Provider-minted cryptographic signature covering reasoning, when the turn’s thinking arrived as exactly ONE Anthropic thinking block (and no redacted_thinking). Real Anthropic only accepts a replayed thinking input block whose signature it minted itself over that exact text — so this must never be set for reasoning from another provider, and must be dropped if reasoning is ever rewritten (issue #520).

content_parts: Option<Vec<MessagePart>>

image_ocr: Option<Vec<ImageOcrResult>>

phase: Option<MessagePhase>

tool_calls: Option<Vec<ToolCall>>

tool_call_id: Option<String>

tool_success: Option<bool>

compressed: bool

compressed_by_event_id: Option<String>

never_compress: bool

When true, this message is protected from context compression and will never be moved into the summary set.

compression_level: u8

Progressive compression level: 0=uncompressed, 1=lightly compacted (head/tail), 2=heavily compacted. Applied at context preparation time, not persisted.

created_at: DateTime<Utc>

metadata: Option<Value>

Implementations

impl Message

pub fn user(content: impl Into<String>) -> Message

pub fn user_with_parts( content: impl Into<String>, parts: Vec<MessagePart>, ) -> Message

pub fn assistant( content: impl Into<String>, tool_calls: Option<Vec<ToolCall>>, ) -> Message

pub fn assistant_with_reasoning( content: impl Into<String>, tool_calls: Option<Vec<ToolCall>>, reasoning: Option<String>, ) -> Message

pub fn with_reasoning_signature(self, signature: Option<String>) -> Message

Attach a provider-minted signature covering reasoning (see the field doc). Intended for the builder position right after Message::assistant_with_reasoning.

pub fn tool_result( tool_call_id: impl Into<String>, content: impl Into<String>, ) -> Message

pub fn tool_result_with_status( tool_call_id: impl Into<String>, content: impl Into<String>, success: bool, ) -> Message

pub fn tool_result_with_images( tool_call_id: impl Into<String>, content: impl Into<String>, success: bool, images: Vec<ToolResultImage>, ) -> Message

Tool-result message carrying both text and images (e.g. an MCP screenshot). The text goes in content (token-capped/persisted as usual); each image becomes a MessagePart::ImageUrl data URL in content_parts, so vision-capable providers receive the real image.

pub fn system(content: impl Into<String>) -> Message

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<(), Error>

Formats the value using the given formatter.

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

fn deserialize<__D>( __deserializer: __D, ) -> Result<Message, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl FromProvider<AnthropicMessage> for Message

fn from_provider(msg: AnthropicMessage) -> Result<Message, ProtocolError>

Convert from provider-specific type to internal type.

impl FromProvider<ChatMessage> for Message

fn from_provider(msg: ChatMessage) -> Result<Message, ProtocolError>

Convert from provider-specific type to internal type.

impl FromProvider<GeminiContent> for Message

fn from_provider(content: GeminiContent) -> Result<Message, ProtocolError>

Convert from provider-specific type to internal type.

impl FromProviderBatch<ChatMessage> for Message

fn from_provider_batch( values: Vec<ChatMessage>, ) -> Result<Vec<Message>, ProtocolError>

impl GeminiExt for Message

fn into_internal(self) -> Result<Message, ProtocolError>

fn to_gemini(&self) -> Result<GeminiContent, ProtocolError>

impl Serialize for Message

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToProvider<AnthropicMessage> for Message

fn to_provider(&self) -> Result<AnthropicMessage, ProtocolError>

Convert from internal type to provider-specific type.

impl ToProvider<ChatMessage> for Message

fn to_provider(&self) -> Result<ChatMessage, ProtocolError>

Convert from internal type to provider-specific type.

impl ToProvider<GeminiContent> for Message

fn to_provider(&self) -> Result<GeminiContent, ProtocolError>

Convert from internal type to provider-specific type.