Struct MessageMetadata 

pub struct MessageMetadata { /* private fields */ }

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

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 harness_notice(timestamp: u64, estimated_tokens: usize) -> Self

Create metadata for a harness-generated notice injected as a User-role turn (recovery nudges, tracker continuations, evaluator retries).

The role stays User because providers only accept user-role steering, but the provenance is machine-generated: reverse history must not offer it as something the user typed.

pub fn is_synthetic(&self) -> bool

Return whether this message was generated by the harness rather than typed by the user.

pub fn source(&self) -> Option<&str>

Return the recorded message origin (user_input, llm_response, tool_result, system, or synthetic).

pub fn with_intent_id(self, intent_id: impl Into<String>) -> Self

Associate this metadata with a queued steering intent.

pub fn intent_id(&self) -> Option<&str>

Return the steering intent identity associated with this message.

Trait Implementations

impl Clone for MessageMetadata

fn clone(&self) -> Self

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: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

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