Struct TraceItem 

#[non_exhaustive]
pub struct TraceItem {
    pub duration_ns: i64,
    pub ended_at: String,
    pub main_usage: MainUsage,
    pub response_preview: String,
    pub source: String,
    pub span_count: i32,
    pub started_at: String,
    pub status: String,
    pub synthetic: String,
    pub trace_id: String,
    pub usage: TraceUsage,
    pub user_prompt: String,
}

One user-visible turn’s header. session_id / harness ids are not duplicated here — they belong to the session.

Models the contract’s TraceItem schema.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

duration_ns: i64

The contract’s duration_ns.

ended_at: String

The contract’s ended_at, an RFC 3339 timestamp.

main_usage: MainUsage

The contract’s main_usage.

response_preview: String

The derive-time fold of the closing conversation- spine llm call’s text output — the answer line for collapsed turn cards, so summary consumers never need spans.

source: String

The capture origin of the turn’s rows (“wire” | “transcript”), promoted from raw_turns.source.

span_count: i32

The contract’s span_count.

started_at: String

The contract’s started_at, an RFC 3339 timestamp.

status: String

The contract’s status.

synthetic: String

A typed deriver signal (“post-compaction” for a compaction continuation, “shadow-opener” for a shadow-only opener), promoted out of the old metadata grab-bag.

trace_id: String

The contract’s trace_id.

usage: TraceUsage

The contract’s usage.

user_prompt: String

Served explicitly (not omitempty): a synthetic opener has an empty prompt, and dropping the key turns the empty string into undefined on the wire, which breaks consumers that expect a string (e.g.

Trait Implementations

impl Clone for TraceItem

fn clone(&self) -> TraceItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ContractModel for TraceItem

const SCHEMA: &'static str = "TraceItem"

The schema’s own name in contracts/tapes-api.yaml.

impl Debug for TraceItem

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

Formats the value using the given formatter.

impl Default for TraceItem

fn default() -> TraceItem

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TraceItem

where TraceItem: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for TraceItem

fn eq(&self, other: &TraceItem) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for TraceItem

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TraceItem