Struct ShadowMode 

pub struct ShadowMode { /* private fields */ }

Toggleable shadow-mode manager for agent tool calls.

Implementations

impl ShadowMode

pub fn new(active: bool) -> Self

Create a new instance. Pass true to start in shadow mode.

pub fn with_clock( active: bool, clock: impl Fn() -> f64 + Send + 'static, ) -> Self

Create with a custom clock (useful for tests).

pub fn is_active(&self) -> bool

pub fn activate(&mut self)

pub fn deactivate(&mut self)

pub fn records(&self) -> &[ShadowRecord]

pub fn clear_records(&mut self)

pub fn intercept<F>( &mut self, tool_name: &str, args: Value, kwargs: Value, when_shadow: Value, f: F, ) -> Value

where F: FnOnce() -> Value,

Intercept a tool call.

If active: record the call, return when_shadow without calling f. If inactive: call f and return its result.

• args: positional args (usually json!([arg1, arg2]))
• kwargs: keyword args (usually json!({"key": val}))
• when_shadow: the placeholder to return in shadow mode
• f: the real implementation (only called when inactive)

pub fn to_jsonl(&self, path: impl AsRef<Path>) -> Result<usize>

Save all records to path as JSONL (overwrites). Returns count.

pub fn load_jsonl(path: impl AsRef<Path>) -> Result<Vec<ShadowRecord>>

Load records from a JSONL file.