Struct SessionRecorder 

pub struct SessionRecorder { /* private fields */ }

Writes one JSONL file per run. Call start() then zero or more step() then finish().

Implementations

impl SessionRecorder

pub fn new( agent_sessions_dir: PathBuf, project_sessions_dir: Option<PathBuf>, agent: String, project: Option<String>, session_id: String, ) -> Self

Create a new recorder. Paths should be ENACT_HOME/agents//sessions and optionally ENACT_HOME/projects//sessions.

pub fn start(&mut self, input: &str) -> Result<()>

Record session start. Call once at the beginning of a run.

pub fn turn(&self, turn: u32, input: &str, output: &str) -> Result<()>

Record one conversation turn (user input + assistant output).

pub fn step( &self, step: u32, tool: &str, args: &Value, duration_ms: u64, ) -> Result<()>

Record one tool step (legacy, for backwards compatibility).

pub fn tool_call( &self, tool_call_id: &str, tool: &str, input: &Value, ) -> Result<()>

Record a tool call (input/arguments before execution).

pub fn tool_call_result( &self, tool_call_id: &str, tool: &str, output: &Value, duration_ms: u64, ) -> Result<()>

Record a tool call result (output after execution).

pub fn finish( &self, outcome: &str, output: Option<&str>, iterations: usize, ) -> Result<()>

Record session finish. Copies the session file to project_sessions_dir if set.