Enum AgentEvent 

#[non_exhaustive]
pub enum AgentEvent {
    WrapperTiming {
        timing: WrapperTiming,
    },
    ActionHit {
        crate_name: Option<String>,
        restore: RestoreStats,
    },
    Bypass {
        kind: String,
    },
    Unconsulted,
    BypassedCompilation {
        kind: String,
        crate_name: Option<String>,
        duration_ns: u64,
    },
    CompilerInvocation {
        outcome: String,
        crate_name: Option<String>,
        duration_ns: u64,
    },
    Verification {
        matched: bool,
        restore: RestoreStats,
    },
    Warning {
        message: String,
    },
    Error {
        message: String,
    },
    ActionDiagnostic {
        outcome: String,
        crate_name: Option<String>,
        diagnostic: ActionDiagnostic,
    },
}

One accounted cache decision, as it happens.

The agent already folds every one of these into [AgentStats]; an observer sees the same decisions individually, before that summing loses the crate they belong to. Delivered synchronously from the request handler, so an observer that blocks slows the build it is watching.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

WrapperTiming

An invocation completed its wrapper instrumentation.

Fields

timing: WrapperTiming

Completed invocation timings.

ActionHit

An action’s outputs were restored from cache.

Fields

crate_name: Option<String>

Compiler crate name, when the invocation supplied one.

restore: RestoreStats

Restoration work performed by the adapter.

Bypass

A compilation the adapter declined to cache.

Fields

kind: String

Stable, low-cardinality bypass-reason name.

Unconsulted

A compilation no lookup was possible for.

BypassedCompilation

A compilation the adapter declined to cache, and the compiler run that followed.

Emitted in place of Self::Bypass and a bypass Self::CompilerInvocation when a shim reports both over one connection, so the reason arrives with the crate and time it cost.

Fields

kind: String

Stable, low-cardinality bypass-reason name.

crate_name: Option<String>

Compiler crate name, when the invocation supplied one.

duration_ns: u64

Wall time spent running the compiler.

CompilerInvocation

A real compiler invocation ran.

Fields

outcome: String

Stable outcome category such as miss, unconsulted, or bypass.

crate_name: Option<String>

Compiler crate name, when the invocation supplied one.

duration_ns: u64

Wall time spent running the compiler.

Verification

A hit was rebuilt to verify it.

Fields

matched: bool

Whether rebuilt and cached outputs matched.

restore: RestoreStats

Restoration work performed before rebuilding.

Warning

A shim reported a diagnostic for the session to surface.

Fields

message: String

Human-readable single-line diagnostic.

Error

A shim reported a fatal diagnostic for the session to surface.

Fields

message: String

Human-readable single-line diagnostic.

ActionDiagnostic

Cache-key material for the action event immediately following it.

Fields

outcome: String

Outcome of the action this describes.

crate_name: Option<String>

Compiler crate name, when the invocation supplied one.

diagnostic: ActionDiagnostic

Privacy-preserving action-key decomposition.

Trait Implementations

impl Clone for AgentEvent

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 AgentEvent

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

Formats the value using the given formatter.