Struct TraceRecorder 

pub struct TraceRecorder {
    opts: CaptureOptions,
    max_steps: usize,
    prev_bodies: PreviousBodies,
    initial: Option<ContextSnapshot>,
    steps: Vec<NodeStep>,
    notes: Vec<String>,
    truncated: bool,
}

Accumulates steps while the engine walks a graph.

Created per traced execution and handed to CompiledGraph::execute_traced; the engine calls record_step after each node and the caller then finishes it into a Trace.

Fields

opts: CaptureOptions

max_steps: usize

prev_bodies: PreviousBodies

Bodies from the previous step, so an unchanged body is not stored once per node. Cloning Bytes is a refcount bump, not a copy.

initial: Option<ContextSnapshot>

steps: Vec<NodeStep>

notes: Vec<String>

truncated: bool

Implementations

impl TraceRecorder

pub fn new(ctx: &Context, opts: CaptureOptions, max_steps: usize) -> Self

Starts a recording, capturing the context as it enters the graph.

pub fn record_step( &mut self, node_id: &str, node_type: &str, outcome: StepOutcome, duration: Duration, edge: EdgeKind, next_node_id: Option<&str>, ctx: &Context, )

Records one node execution. Called by the engine immediately after the plugin returns, while the context is still in hand.

pub fn finish( self, id: String, seq: u64, source: TraceSource, route: Option<String>, policy: String, final_ctx: &Context, duration: Duration, ) -> Trace

Seals the recording into a Trace.