Struct Trace 

pub struct Trace {
    pub flow_id: String,
    pub flow_version: u64,
    pub steps: Vec<TraceStep>,
    pub outcome: FlowOutcome,
    pub error: Option<String>,
    /* private fields */
}

The full record of one run of a flow against one caller.

Owned by the caller of crate::engine::run, not the engine — so a daemon that races the run against the dialog’s death still holds every step executed up to the drop (a caller hanging up mid-menu is exactly the trace worth keeping).

Fields

flow_id: String

flow_version: u64

steps: Vec<TraceStep>

outcome: FlowOutcome

error: Option<String>

Set when the run ended abnormally (Aborted/Defect) — the underlying effect or engine error, for logs. None on a clean run.

Implementations

impl Trace

pub fn new(flow_id: &str, flow_version: u64) -> Self

Start an empty trace for one run. outcome begins as FlowOutcome::Defect and is replaced when the engine finishes; a trace whose run was cancelled (dropped mid-select) keeps the placeholder — consumers that saw the cancellation should trust their own end signal, not this field.

pub fn is_clean(&self) -> bool

Whether the run completed without an effect failure or engine defect — the signal the daemon uses to decide whether to log a warning alongside persisting the trace.

Trait Implementations

impl Clone for Trace

fn clone(&self) -> Trace

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Trace

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Serialize for Trace

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.