Enum ContextCompilerEvent 

pub enum ContextCompilerEvent {
    BlockEmitted {
        source: &'static str,
        kind: SegmentKind,
        original_tokens: usize,
        kept_tokens: usize,
    },
    BudgetAllocated {
        total: usize,
        per_kind: Vec<(SegmentKind, usize)>,
    },
    TierSelected {
        tier: Tier,
        reason: &'static str,
    },
    SummarizerInvoked {
        duration_ms: u64,
        segments_in: usize,
        summary_tokens: usize,
    },
    SummarizerFailed {
        duration_ms: u64,
        error_kind: &'static str,
    },
    BudgetExceeded {
        overage: usize,
    },
}

Structured event emitted by ContextCompiler during prompt composition.

All variants are intentionally cheap to construct (no large captures) so emission stays under 1 ms even under high-frequency turns.

Variants

BlockEmitted

A single segment survived selection and was emitted into the composed prompt.

Fields

source: &'static str

Source identifier (e.g. "system_prompt", "recent_turn", "tool_result").

kind: SegmentKind

Coarse segment kind for dashboard grouping.

original_tokens: usize

Original token estimate (pre-compression).

kept_tokens: usize

Token estimate after per-segment compression / pruning.

BudgetAllocated

Total budget allocated and the per-kind reservation.

Fields

total: usize

Total prompt-window budget in token estimate.

per_kind: Vec<(SegmentKind, usize)>

Per-kind reserved tokens (sum may be ≤ total).

TierSelected

Capability tier selected for this compose() call.

Fields

tier: Tier

Which tier the orchestrator activated.

reason: &'static str

Short reason code (e.g. "summarizer_present", "heuristic_only").

SummarizerInvoked

Summarizer was invoked successfully (Tier ≥ 1).

Fields

duration_ms: u64

Wall-clock duration of the summarizer call.

segments_in: usize

Number of segments fed into the summarizer.

summary_tokens: usize

Token estimate of the resulting summary.

SummarizerFailed

Summarizer call failed; orchestrator auto-degraded to heuristic for this turn.

Fields

duration_ms: u64

Wall-clock duration of the failed call.

error_kind: &'static str

Short error kind classifier (e.g. "timeout", "http", "parse").

BudgetExceeded

Total budget was exceeded even after compaction; safety-net truncation applied.

Fields

overage: usize

Tokens over budget after best-effort compaction.

Trait Implementations

impl Clone for ContextCompilerEvent

fn clone(&self) -> ContextCompilerEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContextCompilerEvent

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

Formats the value using the given formatter.