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 image_numbers: Option<Vec<u64>>,
    pub tool_calls: Option<Vec<ToolCall>>,
    pub tool_call_id: Option<String>,
    pub tool_name: Option<String>,
    pub provider_continuation: Option<ProviderContinuation>,
}

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

image_numbers: Option<Vec<u64>>

Global [Image #N] display numbers, parallel to images (same length, same order). Kept separate from images so provider adapters and the /context image count keep reading images: Vec<String> unchanged, and so sessions saved before image numbering deserialize cleanly (None → the transcript falls back to a positional index).

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

provider_continuation: Option<ProviderContinuation>

Provider-owned continuation state. Anthropic stores its signed thinking block; Meta stores ordered Responses output items for encrypted replay. Other providers leave this unset and 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 run_summary(content: impl Into<String>) -> Self

Create a display-only run summary (e.g. “Worked for 5m 12s · used 12.3k tokens”). Rendered dim/italic where the spinner was; excluded from the model context by build_chat_request so it never bloats the conversation.

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_image_numbers(self, numbers: Vec<u64>) -> Self

Builder: attach the parallel global image numbers (same length/order as with_images). Set together at submit time so the transcript can show each image’s stable [Image #N].

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

Builder: attach tool calls

pub fn with_provider_continuation( self, continuation: ProviderContinuation, ) -> Self

Builder: attach opaque provider continuation data.

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.