Enum CompressionEvent 

pub enum CompressionEvent {
    Preparing {
        session_id: u64,
        tokens_before: usize,
        msg_count: usize,
        trigger: CompressionTrigger,
    },
    Started {
        session_id: u64,
        tokens_before: usize,
        msg_count: usize,
        trigger: CompressionTrigger,
    },
    Progress {
        session_id: u64,
        chars: usize,
    },
    Completed {
        session_id: u64,
        tokens_before: usize,
        tokens_after: usize,
        reduction_pct: i32,
        msg_count_before: usize,
        msg_count_after: usize,
        trigger: CompressionTrigger,
    },
    Failed {
        session_id: u64,
        error: String,
        trigger: CompressionTrigger,
    },
}

Context compression lifecycle events.

Emitted as UserEvent::Structured { event_type: "compression", data: ... } so consumers can match on the typed enum for compile-time safety.

Lifecycle

Preparing → Started → Progress (0..N) → Completed | Failed

Variants

Preparing

Pre-processing — saving snapshot, about to start.

Fields

session_id: u64

Session that owns this compression.

tokens_before: usize

Estimated token count before compression.

msg_count: usize

Number of messages in the session.

trigger: CompressionTrigger

What triggered this compression.

Started

Compression started — LLM call about to begin.

Fields

session_id: u64

Session that owns this compression.

tokens_before: usize

Estimated token count before compression.

msg_count: usize

Number of messages in the session.

trigger: CompressionTrigger

What triggered this compression.

Progress

Streaming progress — cumulative character count from LLM.

Fields

session_id: u64

Session that owns this compression.

chars: usize

Cumulative characters received from the summarisation LLM so far.

Completed

Compression completed — session messages replaced.

Fields

session_id: u64

Session that owns this compression.

tokens_before: usize

Estimated token count before compression.

tokens_after: usize

Estimated token count after compression.

reduction_pct: i32

Reduction percentage (positive = saved tokens).

msg_count_before: usize

Message count before compression.

msg_count_after: usize

Message count after compression.

trigger: CompressionTrigger

What triggered this compression.

Failed

Compression failed — session restored from snapshot.

Fields

session_id: u64

Session that owns this compression.

error: String

Human-readable error description.

trigger: CompressionTrigger

What triggered this compression.

Implementations

impl CompressionEvent

pub fn into_user_event(self) -> UserEvent

Convert into an agent_base::UserEvent::Structured for transport.

pub fn from_user_event(event: &UserEvent) -> Option<Self>

Try to extract a CompressionEvent from a agent_base::UserEvent.

Returns None if the event is not a compression event or if deserialization fails.

Trait Implementations

impl Clone for CompressionEvent

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 CompressionEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CompressionEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for CompressionEvent

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for CompressionEvent

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 CompressionEvent