Struct MessageMetadata 

pub struct MessageMetadata {
    pub timestamp: u64,
    pub importance_score: f64,
    pub compression_status: CompressionStatus,
    pub estimated_tokens: usize,
    pub source: Option<String>,
}

Metadata attached to every message in the conversation history.

Skipped during serialization when None to preserve backward compatibility with all existing persistence formats (session archives, snapshots, etc.).

Fields

timestamp: u64

Unix millisecond timestamp when the message was created.

importance_score: f64

Importance score in [0.0, 1.0]: 0.0 = low (safe to drop first), 1.0 = high (preserve as long as possible).

Initialised to 0.5 (neutral) and adjusted by the compression/pruning system or by explicit agent reflection.

compression_status: CompressionStatus

Current compression status of this message.

estimated_tokens: usize

Cached token estimate for this message. Populated on creation and updated after compression.

source: Option<String>

Origin of this message: “user_input”, “llm_response”, “tool_result”, “system”, or “synthetic”.

Implementations

impl MessageMetadata

pub fn user_input(timestamp: u64, estimated_tokens: usize) -> Self

Create metadata for a message originating from a user.

pub fn llm_response(timestamp: u64, estimated_tokens: usize) -> Self

Create metadata for a message originating from an LLM response.

pub fn tool_result(timestamp: u64, estimated_tokens: usize) -> Self

Create metadata for a tool result message.

pub fn system(timestamp: u64, estimated_tokens: usize) -> Self

Create metadata for a system message.

pub fn synthetic(timestamp: u64, estimated_tokens: usize) -> Self

Create metadata for a synthetic (e.g., recovery/injected) message.

pub fn mark_compressed( &mut self, original_tokens: usize, compressed_tokens: usize, )

Mark this message as compressed, recording the original and new token counts.

pub fn mark_summarized(&mut self, original_tokens: usize, summary_tokens: usize)

Mark this message as summarized.

pub fn set_importance(&mut self, score: f64)

Set the importance score (clamped to [0.0, 1.0]).

pub fn original_token_count(&self) -> usize

Returns the original (pre-compression) token count, or the current count if the message was never compressed.

pub fn effective_token_count(&self) -> usize

Returns the effective (post-compression) token count.

Trait Implementations

impl Clone for MessageMetadata

fn clone(&self) -> MessageMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MessageMetadata

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MessageMetadata

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for MessageMetadata

fn eq(&self, other: &MessageMetadata) -> 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 MessageMetadata

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 MessageMetadata