agent-shadow-mode 0.1.0

Toggle shadow mode for agent tool calls: record what would have happened without running real side-effecting code.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

# agent-shadow-mode

Toggle shadow mode for agent tool calls. When active, records the intended call and returns a safe placeholder without running real side-effecting code.

## Usage

```rust
use agent_shadow_mode::ShadowMode;
use serde_json::json;

let mut shadow = ShadowMode::new(true); // start in shadow mode

let result = shadow.intercept(
    "charge_card",
    json!([]),
    json!({"customer_id": "cus_1", "amount_usd": 4.99}),
    json!({"status": "shadowed"}),
    || json!({"status": "charged"}), // real call — never runs when active
);
assert_eq!(result, json!({"status": "shadowed"}));

// Later: toggle off for real execution
shadow.deactivate();

// Persist the shadow log
shadow.to_jsonl("shadow-audit.jsonl").unwrap();
```

## License

MIT OR Apache-2.0