Struct CompactionFailure 

pub struct CompactionFailure {
    pub trace_id: Uuid,
    pub fell_back_to: Option<FallbackStrategy>,
    pub reason: String,
    pub after_tokens: usize,
    pub budget: usize,
}

Emitted when every fallback strategy failed to fit under budget.

At this point the caller must surface an error to the user — sending the request to the provider would 400. fell_back_to is None explicitly (rather than omitted) so JSONL consumers can distinguish “never attempted truncation” from “attempted and it also failed”.

Examples

use codetether_agent::session::{CompactionFailure, FallbackStrategy};
use uuid::Uuid;

let f = CompactionFailure {
    trace_id: Uuid::nil(),
    fell_back_to: Some(FallbackStrategy::Truncate),
    reason: "truncation below minimum viable request".into(),
    after_tokens: 9_200,
    budget: 8_000,
};
assert!(f.after_tokens > f.budget);

Fields

trace_id: Uuid

Correlates with the originating CompactionStart.

fell_back_to: Option<FallbackStrategy>

Last strategy attempted before giving up, or None if compaction never managed to run at all.

reason: String

Human-readable diagnostic.

after_tokens: usize

Final estimated request tokens after the last attempt.

budget: usize

Budget the request still fails to fit under.

Trait Implementations

impl Clone for CompactionFailure

fn clone(&self) -> CompactionFailure

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CompactionFailure

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CompactionFailure

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CompactionFailure

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.