Struct MessageMetadata 

pub struct MessageMetadata {
    pub visibility: MessageVisibility,
    pub compacted_at: Option<i64>,
    pub deferred_summary: Option<String>,
    pub focus_pinned: bool,
    pub focus_marker_id: Option<Uuid>,
    pub db_id: Option<i64>,
    pub fidelity_tag: Option<ContextFidelity>,
    pub embedding: Option<Vec<f32>>,
}

Per-message visibility and metadata controlling agent context and user display.

Constructors agent_only, user_only, and focus_pinned cover the most common combinations.

Fields

visibility: MessageVisibility

Who can see this message.

compacted_at: Option<i64>

Unix timestamp (seconds) when this message was compacted, if applicable.

deferred_summary: Option<String>

Pre-computed tool pair summary, applied lazily when context pressure rises. Stored on the tool response message; cleared after application.

focus_pinned: bool

When true, this message is excluded from all compaction passes (soft pruning, hard summarization, sidequest eviction). Used for the Focus Knowledge block (#1850).

focus_marker_id: Option<Uuid>

Unique marker UUID set when start_focus begins a session. Used by complete_focus to locate the checkpoint without relying on a fragile raw index.

db_id: Option<i64>

SQLite row ID for this message. Populated when loading from DB or after persisting. Never serialized — always re-populated from the database on load.

fidelity_tag: Option<ContextFidelity>

Fidelity level assigned by FidelityScorer during context assembly.

None when fidelity scoring is disabled or the message has not yet been scored. Used for debug tracing and compaction input filtering (INV-02).

embedding: Option<Vec<f32>>

Cached embedding vector for semantic fidelity scoring.

In-memory only — not serialized or persisted to the database.

Implementations

impl MessageMetadata

pub fn agent_only() -> Self

Message visible only to the agent (e.g. compaction summary).

pub fn user_only() -> Self

Message visible only to the user (e.g. compacted original).

pub fn focus_pinned() -> Self

Pinned Knowledge block — excluded from all compaction passes.

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 Default for MessageMetadata

fn default() -> Self

Returns the “default value” for a type.

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