Struct ChatMessage 

pub struct ChatMessage {
    pub role: String,
    pub content: MessageContent,
    pub tool_calls: Vec<ToolCall>,
    pub tool_call_id: Option<String>,
    pub name: Option<String>,
    pub thinking_steps: Vec<ThinkingStep>,
    pub reasoning_content: String,
    pub reasoning: String,
}

Fields

role: String

content: MessageContent

tool_calls: Vec<ToolCall>

Tool calls an assistant turn is requesting (OpenAI tool_calls).

tool_call_id: Option<String>

For a tool role message: the id of the tool call this result answers.

name: Option<String>

For a tool role message: the name of the tool that produced the result.

thinking_steps: Vec<ThinkingStep>

Ordered solver-thinking projection attached to assistant answers.

reasoning_content: String

OpenAI-compatible reasoning text used by clients that display assistant reasoning in a standard message field.

reasoning: String

Alias consumed by some OpenAI-compatible clients for the same reasoning text as reasoning_content.

Implementations

impl ChatMessage

pub fn new(role: impl Into<String>, content: impl Into<String>) -> Self

A message with the given role and plain-text content.

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

A user message carrying text.

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

An assistant message carrying text.

pub fn assistant_tool_calls(tool_calls: Vec<ToolCall>) -> Self

An assistant message requesting tool_calls (no textual content).

pub fn assistant_tool_calls_with_content( content: impl Into<String>, tool_calls: Vec<ToolCall>, ) -> Self

An assistant message that explains an action before requesting it.

Tool-capable protocol surfaces preserve both fields, so agentic clients can show the user what is about to happen while they execute the machine-readable call (issue #781).

pub fn tool_result( tool_call_id: impl Into<String>, name: impl Into<String>, result: impl Into<String>, ) -> Self

A tool message carrying the result for the call tool_call_id made against the tool name.

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 Default for ChatMessage

fn default() -> ChatMessage

Returns the “default value” for a type.

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 Eq for ChatMessage

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