Struct MessageRecord 

pub struct MessageRecord {
    pub id: Uuid,
    pub session_id: Uuid,
    pub role: MessageRole,
    pub content: Vec<ContentPart>,
    pub tool_calls: Vec<ToolCall>,
    pub tool_call_id: Option<String>,
    pub tool_name: Option<String>,
    pub usage: Option<TokenUsage>,
    pub created_at: DateTime<Utc>,
    pub is_compaction: bool,
    pub is_summary: bool,
    pub compaction_meta: Option<CompactionMeta>,
}

Persisted message exchange within a session.

Each message records a single turn in the conversation: the role (user, assistant, system, tool), its content parts, optional tool calls or tool results, token usage, and compaction state.

Fields

id: Uuid

Unique message identifier.

session_id: Uuid

Session this message belongs to.

role: MessageRole

Message role.

content: Vec<ContentPart>

Message content parts.

tool_calls: Vec<ToolCall>

Tool calls made by the assistant, if any.

tool_call_id: Option<String>

Tool call ID for tool result messages.

tool_name: Option<String>

Tool name for tool result messages.

usage: Option<TokenUsage>

Token usage associated with this exchange.

created_at: DateTime<Utc>

When the message was created.

is_compaction: bool

Whether this message is a compaction task (user message triggering compression).

is_summary: bool

Whether this message contains a compaction summary (assistant response to compaction).

compaction_meta: Option<CompactionMeta>

Compaction metadata, populated only for compaction-related messages.

Implementations

impl MessageRecord

pub fn new( session_id: Uuid, role: MessageRole, content: Vec<ContentPart>, ) -> Self

Creates a new message record with a generated UUIDv7 ID and current timestamp.

All optional fields (tool_calls, tool_call_id, tool_name, usage, compaction flags) are initialized to their default/absent state.

pub fn with_tool_result(self, call_id: String, name: String) -> Self

Sets tool call metadata on a tool result message, consuming and returning self.

Use this when the message represents a tool execution result rather than an assistant message that initiates tool calls.

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

Sets tool calls on the message record, consuming and returning self.

Use this when the assistant message initiates one or more tool calls.

pub fn with_usage(self, usage: TokenUsage) -> Self

Sets token usage on the message record, consuming and returning self.

pub fn with_compaction(self, meta: CompactionMeta) -> Self

Marks this message as a compaction task user message, consuming and returning self.

pub fn with_summary(self, meta: CompactionMeta) -> Self

Marks this message as a compaction summary assistant message, consuming and returning self.

Trait Implementations

impl Clone for MessageRecord

fn clone(&self) -> MessageRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MessageRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MessageRecord

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for MessageRecord

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for MessageRecord

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 MessageRecord