pub fn load_agent_trace(path: &str) -> Result<Vec<AgentEvent>>
Load an agent trace from a JSON file.
Returns an error if the file cannot be read or the JSON is invalid.