Struct ShadowEvent 

pub struct ShadowEvent {
    pub turn: u32,
    pub tools: Vec<String>,
    pub max_permission_class: u8,
    pub deviation_score: f32,
    pub goal_summary: String,
}

A single safety-relevant observation recorded after a tool batch completes.

Events are appended to ShadowMemory in monotonic turn order. The fields capture the most goal-relevant signals without requiring an additional LLM call.

goal_summary is truncated to GOAL_SUMMARY_MAX_CHARS on ingestion by ShadowMemory::record, so callers do not need to truncate themselves.

Fields

turn: u32

Monotonic turn index within the session (0-based).

tools: Vec<String>

Tool names executed in this batch.

max_permission_class: u8

Maximum permission class across all tools in this batch.

0 = read, 1 = write, 2 = execute, 3 = network.

deviation_score: f32

Causal deviation score from TurnCausalAnalyzer.

0.0 when causal IPI is disabled or probes failed.

goal_summary: String

First GOAL_SUMMARY_MAX_CHARS characters of the pre-probe response.

Empty string when no pre-probe was available (causal IPI disabled). An empty goal_summary triggers maximum Jaccard drift penalty.

Trait Implementations

impl Clone for ShadowEvent

fn clone(&self) -> ShadowEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ShadowEvent

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

Formats the value using the given formatter.