Struct ChatMessage 

pub struct ChatMessage {
    pub role: MessageRole,
    pub content: String,
    pub timestamp: DateTime<Local>,
    pub kind: ChatMessageKind,
    pub metadata: Option<Value>,
    pub actions: Vec<ActionDisplay>,
    pub thinking: Option<String>,
    pub images: Option<Vec<String>>,
    pub tool_calls: Option<Vec<ToolCall>>,
    pub tool_call_id: Option<String>,
    pub tool_name: Option<String>,
    pub thinking_signature: Option<String>,
}

Represents a chat message

Fields

role: MessageRole

content: String

timestamp: DateTime<Local>

kind: ChatMessageKind

Mermaid-owned message classification. Provider adapters ignore this; render/persistence use it to distinguish generated checkpoints from normal user/assistant turns.

metadata: Option<Value>

Optional Mermaid-owned structured metadata for UI/replay.

actions: Vec<ActionDisplay>

Actions performed during this message (for display purposes)

thinking: Option<String>

Thinking/reasoning content (for models that expose their thought process)

images: Option<Vec<String>>

Base64-encoded images/PDFs for multimodal models

tool_calls: Option<Vec<ToolCall>>

Tool calls from the model (Ollama native function calling)

tool_call_id: Option<String>

Tool call ID for tool result messages (OpenAI-compatible format) This links the tool result back to the original tool_call from the assistant

tool_name: Option<String>

Tool name for tool result messages (required by Ollama API) This tells the model which function’s result is being returned

thinking_signature: Option<String>

Anthropic thinking-block signature — encrypted server state that MUST round-trip back into the next request when extended thinking is enabled, or the API returns 400 invalid_request_error. Set only by the Anthropic adapter; other adapters leave it None and other providers ignore it on the wire.

Implementations

impl ChatMessage

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

Create a user message

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

Create an assistant message

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

Create a system message

pub fn tool( tool_call_id: impl Into<String>, tool_name: impl Into<String>, content: impl Into<String>, ) -> Self

Create a tool result message

pub fn with_images(self, images: Vec<String>) -> Self

Builder: attach images

pub fn with_tool_calls(self, tool_calls: Vec<ToolCall>) -> Self

Builder: attach tool calls

pub fn with_thinking_signature(self, signature: impl Into<String>) -> Self

Builder: attach an Anthropic thinking signature. Used by the Anthropic adapter when committing assistant messages so the signature can round-trip on the next request.

pub fn extract_thinking(text: &str) -> (Option<String>, String)

Extract thinking blocks from message content. Returns (thinking_content, answer_content).

Performs a single find for the start marker; the previous version scanned twice (contains + find) and called find("Thinking...") again inside the if-let-chain.

Safety: str::find() returns byte offsets. The markers "Thinking..." and "...done thinking." are pure ASCII, so adding their .len() always lands on a valid UTF-8 char boundary.

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 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.