Struct SpanItem 

#[non_exhaustive]
pub struct SpanItem {

    pub call_kind: String,
    pub duration_ns: i64,
    pub input: Vec<Value>,
    pub kind: String,
    pub model: String,
    pub name: String,
    pub output: Vec<Value>,
    pub parent_span_id: String,
    pub payload: String,
    pub raw_turn_id: i64,
    pub seq: i64,
    pub span_id: String,
    pub started_at: String,
    pub status: String,
    pub stop_reason: String,
    pub thread_id: String,
    pub trace_id: String,
    pub usage: Value,
    pub verdict: Option<Value>,
}

One observed unit of work. Every field is a deriver output, formatting- only: the harness-taxonomy fields (call_kind, model, stop_reason, thread_id, verdict) are typed rather than bagged in a metadata map, and input/output are uniform content-block arrays for ALL kinds — the console owns per-kind rendering.

Models the contract’s SpanItem 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.

call_kind: String

Deriver-written taxonomy, promoted from the old metadata grab-bag.

duration_ns: i64

The contract’s duration_ns.

input: Vec<Value>

Input/Output are content-block arrays (llm.ContentBlock), uniform for every kind (tool spans included — no unwrapping).

kind: String

The contract’s kind.

model: String

The contract’s model.

name: String

The contract’s name.

output: Vec<Value>

The contract’s output.

parent_span_id: String

The contract’s parent_span_id.

payload: String

Payload marks a preview-truncated span so the console drills in for the full payload; absent in full mode.

raw_turn_id: i64

The contract’s raw_turn_id.

seq: i64

The span’s presentation ordinal within its trace; spans arrive sorted by it (started_at ties inside one llm call — parallel tool batches share an instant).

span_id: String

The contract’s span_id.

started_at: String

The contract’s started_at, an RFC 3339 timestamp.

status: String

The contract’s status.

stop_reason: String

The contract’s stop_reason.

thread_id: String

The contract’s thread_id.

trace_id: String

The contract’s trace_id.

usage: Value

Usage (was metrics) is an llm.Usage object on the wire — {}-pinned for usage-less spans.

verdict: Option<Value>

The typed security-monitor disposition (null off permission-check spans), deriver-written.

Trait Implementations

impl Clone for SpanItem

fn clone(&self) -> SpanItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ContractModel for SpanItem

const SCHEMA: &'static str = "SpanItem"

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

impl Debug for SpanItem

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

Formats the value using the given formatter.

impl Default for SpanItem

fn default() -> SpanItem

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SpanItem

where SpanItem: 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 SpanItem

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SpanItem

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 SpanItem