Struct ChatMessage 

pub struct ChatMessage {
    pub role: Role,
    pub content: Option<Content>,
    pub name: Option<String>,
    pub tool_calls: Vec<ToolCall>,
    pub tool_call_id: Option<String>,
    pub reasoning: Option<String>,
    pub reasoning_details: Vec<ReasoningDetail>,
}

A chat message (request or response).

Fields

role: Role

content: Option<Content>

content is a plain string or an array of content parts. Optional because an assistant message that only calls tools may omit it.

name: Option<String>

tool_calls: Vec<ToolCall>

tool_call_id: Option<String>

Set when role == Tool.

reasoning: Option<String>

Open reasoning text the assistant emitted (OpenRouter reasoning), if any. The flat, human-readable form; the structured reasoning_details is the replay-safe one.

reasoning_details: Vec<ReasoningDetail>

Structured reasoning blocks (open and hidden, with signatures — see ReasoningDetail). Echo these back verbatim on the next request to preserve signed reasoning across a turn.

Implementations

impl ChatMessage

pub fn system(text: impl Into<String>) -> Self

A system message with text content.

pub fn user(text: impl Into<String>) -> Self

A user message with text content.

pub fn assistant(text: impl Into<String>) -> Self

An assistant message with text content.

pub fn text(&self) -> Option<&str>

Accumulated plain-text content, if the message carries a text body.

pub fn reasoning_text(&self) -> Option<String>

The visible (open) reasoning for this message: the flat reasoning text if present, else the concatenation of the open reasoning_details blocks. None when the turn carried no visible reasoning (it may still carry hidden blocks — see reasoning_details).

Trait Implementations

impl Clone for ChatMessage

fn clone(&self) -> ChatMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChatMessage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ChatMessage

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ChatMessage

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ChatMessage

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 ChatMessage