Struct ChatMessage 

pub struct ChatMessage {
    pub role: Role,
    pub content: String,
    pub timestamp: DateTime<Utc>,
    pub metadata: HashMap<String, Value>,
    pub tool_calls: Vec<ToolCall>,
    pub tokens: Option<u64>,
    pub thinking_trace: Option<String>,
    pub reasoning_content: Option<String>,
    pub token_usage: Option<HashMap<String, Value>>,
    pub provenance: Option<InputProvenance>,
}

Represents a single message in the conversation.

Fields

role: Role

content: String

timestamp: DateTime<Utc>

metadata: HashMap<String, Value>

tool_calls: Vec<ToolCall>

tokens: Option<u64>

thinking_trace: Option<String>

Thinking/reasoning used for this response.

reasoning_content: Option<String>

Native model reasoning (o1/o3).

token_usage: Option<HashMap<String, Value>>

Token usage stats (may contain nested dicts).

provenance: Option<InputProvenance>

Input provenance tracking (multi-channel architecture).

Implementations

impl ChatMessage

pub fn token_estimate(&self) -> u64

Estimate token count (rough approximation).

pub fn cache_token_estimate(&mut self) -> u64

Estimate token count and cache the result in self.tokens.

On first call (when tokens is None), computes the estimate and stores it so subsequent calls skip recomputation. Returns the (possibly newly cached) value.

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.