Struct StepEntry 

pub struct StepEntry {

    pub step_id: StepId,
    pub step_ref: Option<String>,
    pub status: Option<String>,
    pub binding_digest: Option<BindingDigest>,
    pub at: u64,
    pub attempt: Option<u32>,
    pub started_at_ms: Option<i64>,
    pub completed_at_ms: Option<i64>,
    pub duration_ms: Option<u64>,
    pub worker_kind: Option<String>,
    pub model: Option<String>,
    pub usage: Option<TokenUsage>,
    pub num_turns: Option<u32>,
    pub adapter_data: Option<Value>,
}

One entry in a Run’s step trace — appended as the engine dispatches (and finishes) each step. Purely observational: no field here is consulted for flow control.

The per-step stats extension (started/completed timestamps, duration, token usage, model, worker kind, variant-specific adapter_data) is additive: every field is Option + #[serde(default)] so rows written before the extension deserialize unchanged, and a dispatch where no boundary reported stats still appends a valid entry. The entry stays write-once — in-flight visibility belongs to the sibling crate::store::trace::TraceEvent stream, never to in-place updates here.

Fields

step_id: StepId

The step this entry traces.

step_ref: Option<String>

The Blueprint step ref (Step.ref) that was dispatched, if known.

status: Option<String>

Free-form status label for this step at the time the entry was recorded (e.g. "dispatched", "passed", "blocked").

binding_digest: Option<BindingDigest>

Immutable Runner/Agent/Context snapshot digest used for this step. None for rows created before BoundAgent launch wiring.

at: u64

Unix epoch seconds — when this entry was recorded.

attempt: Option<u32>

The attempt number the stats below describe (the LAST attempt the dispatch ran), when a worker boundary reported one.

started_at_ms: Option<i64>

Unix epoch milliseconds — when the dispatcher began this step.

completed_at_ms: Option<i64>

Unix epoch milliseconds — when the step reached its outcome.

duration_ms: Option<u64>

Wall-clock dispatch duration in milliseconds (dispatcher-measured, worker-kind independent).

worker_kind: Option<String>

Worker kind label ("agent_block" / "subprocess" / "operator" / …) as reported by the worker boundary.

model: Option<String>

The model that served the attempt, when known.

usage: Option<TokenUsage>

Normalized token usage, when a worker boundary reported one.

num_turns: Option<u32>

Number of LLM turns the attempt ran, when reported.

adapter_data: Option<Value>

Worker-kind-specific raw payload (size-capped, engine-opaque).

Implementations

impl StepEntry

pub fn basic( step_id: StepId, step_ref: Option<String>, status: Option<String>, binding_digest: Option<BindingDigest>, at: u64, ) -> Self

Construct an entry with only the pre-stats fields set — the shape every pre-extension writer produced. Stats fields default to None; the dispatcher’s fold fills them when available.

pub fn with_worker_stats(self, stats: WorkerStats) -> Self

Fold a boundary-reported crate::store::trace::WorkerStats into this entry (the dispatcher’s outcome-time fold). None fields in stats leave the entry untouched; adapter_data is size-capped via crate::store::trace::cap_payload.

Trait Implementations

impl Clone for StepEntry

fn clone(&self) -> StepEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StepEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StepEntry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for StepEntry

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for StepEntry

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

where __S: Serializer,

Serialize this value into the given Serde serializer.