Struct CompactionReceipt 

pub struct CompactionReceipt {

    pub schema_version: u32,
    pub receipt_id: String,
    pub session_id: Option<String>,
    pub transcript_id: Option<String>,
    pub mode: String,
    pub reason: String,
    pub strategy: String,
    pub engine_strategy: String,
    pub requested_strategy: Option<String>,
    pub resolved_threshold_tokens: Option<usize>,
    pub threshold_source: Option<String>,
    pub hard_limit_tokens: Option<usize>,
    pub archived_messages: usize,
    pub estimated_tokens_before: usize,
    pub estimated_tokens_after: usize,
    pub snapshot_asset_id: Option<String>,
    pub instruction_mode: Option<String>,
    pub instruction_source: Option<String>,
    pub compaction_policy: Option<Value>,
    pub recap: Option<RecapMetrics>,
    pub source_measurement: Option<CompactionSourceMeasurement>,
}

One serializable, versioned record of a single transcript compaction. See the module docs for how it flows through every projection.

Fields

schema_version: u32

Schema version. Lets readers migrate: a receipt read from an older persisted transcript that predates a meaning change carries its original version, and a transcript with no embedded receipt at all is migrated by the record builder (see compaction_events_from_transcript).

receipt_id: String

Stable identity for this compaction operation, shared verbatim across the transcript event id, the live event, ACP, and the observability record.

session_id: Option<String>

Owning agent session, when the compaction ran against one.

transcript_id: Option<String>

Owning transcript, when known. Best-effort provenance; the record’s transcript_id is sourced authoritatively from the transcript itself.

mode: String

Call-site surface that initiated compaction (CompactMode::as_str).

reason: String

Why compaction fired (CompactionTrigger::as_str, or a host-supplied reason such as context_overflow).

strategy: String

User-facing policy label (may be broader than the engine strategy).

engine_strategy: String

Engine strategy actually used after honoring any PreCompact Modify.

requested_strategy: Option<String>

Normalized strategy requested at the caller boundary, before lifecycle hooks or fallback policy changed the engine choice. None on legacy receipts whose request was not measured.

resolved_threshold_tokens: Option<usize>

Resolved tier-1 threshold that admitted this compaction. Some(0) is a measured force-compaction threshold; None means the initiating path did not report threshold provenance.

threshold_source: Option<String>

Boundary field that supplied resolved_threshold_tokens, for example token_threshold, compact_threshold, or default.

hard_limit_tokens: Option<usize>

Resolved tier-2 hard limit, when configured.

archived_messages: usize

estimated_tokens_before: usize

estimated_tokens_after: usize

snapshot_asset_id: Option<String>

Id of the pre-compaction snapshot asset, when one was built.

instruction_mode: Option<String>

instruction_source: Option<String>

compaction_policy: Option<Value>

recap: Option<RecapMetrics>

Observation-mask recap metrics; None for the LLM/truncate/custom strategies, which do not spend a recap budget.

source_measurement: Option<CompactionSourceMeasurement>

Source-window and summary byte measurement for this compaction.

None means this compaction path took no measurement. That is deliberately distinct from Some(..) carrying Some(0), which is a measurement that was taken and read zero.

Implementations

impl CompactionReceipt

pub fn to_json(&self) -> Value

Serialize the receipt for verbatim embedding under metadata.receipt on the transcript event.

pub fn from_event_metadata(metadata: Option<&Value>) -> Option<Self>

Read a receipt embedded under metadata.receipt on a transcript compaction event. Returns None when the key is absent (a legacy transcript written before receipts existed) or malformed, so the caller can fall back to the legacy flat-metadata migration path.

pub fn from_host_payload(session_id: &str, payload: &Value) -> Self

Normalize a host-script compaction payload — the dict .harn code hands to agent_record_compaction / __host_agent_record_compaction — into a receipt at the builtin boundary. Current callers forward the engine-owned receipt, whose identity and measured outcome stay authoritative. Legacy flat payloads still normalize here and receive a new identity.

Trait Implementations

impl Clone for CompactionReceipt

fn clone(&self) -> CompactionReceipt

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CompactionReceipt

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

Formats the value using the given formatter.

impl Default for CompactionReceipt

fn default() -> CompactionReceipt

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CompactionReceipt

where CompactionReceipt: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for CompactionReceipt

impl PartialEq for CompactionReceipt

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for CompactionReceipt

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 CompactionReceipt