Enum ActiveOverlay 

pub enum ActiveOverlay {
    State,
    Verdict(Box<Evaluation>),
    FrictionPause(FrictionPause),
    Risk {
        trigger: RiskOverlayTrigger,
        opened_at: Instant,
    },
}

Runtime representation of a live overlay. This exists as a separate enum (not just OverlayTarget) so overlays can carry ephemeral state — scroll offset, filter text, a timer, a typed-confirm buffer — that the input + render layers mutate without going back through dispatch.

Variants

State

The operator-state overview. Sourced every render from engine.operator_state; carries no state of its own.

Verdict(Box<Evaluation>)

Per-coin gate verdict. Carries the full zero_engine_client::Evaluation returned by the engine so the overlay renders exactly what the engine said — no local recomputation, no synthetic fields.

FrictionPause(FrictionPause)

Friction pause — visible countdown and, at L2+, a typed confirmation before a risk-increasing command runs. The overlay owns the pending Command so the event loop can re-dispatch via run_bypass_friction on completion.

Risk

M2 §4 risk overlay. Opens automatically when the operator-state snapshot reports L3/L4 or the engine reports drawdown within AppState::GUARDRAIL_PROXIMITY_PP of the last hard-alert threshold. The overlay never owns a pending command — unlike ActiveOverlay::FrictionPause, it is a context surface, not a gate. The operator dismisses with any key; the auto-open hook honors a 60 s cooldown (see AppState::RISK_DISMISS_COOLDOWN) unless the trigger strictly escalates.

Fields

trigger: RiskOverlayTrigger

opened_at: Instant

Monotonic Instant::now() at the moment the overlay opened. Not used for timing inside this struct — the rate-limiter anchors on AppState::risk_overlay_last_dismissed_at — but kept here so tests, logs, and future “overlay has been up for Xs” surfaces have a single source of truth.

Implementations

impl ActiveOverlay

pub fn from_target(t: OverlayTarget) -> Self

Construct an overlay from a OverlayTarget signal emitted by the dispatcher. Only applies to self-contained overlays; friction overlays are built separately because they need the full FrictionDecision + pending Command.

Trait Implementations

impl Clone for ActiveOverlay

fn clone(&self) -> ActiveOverlay

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ActiveOverlay

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

Formats the value using the given formatter.