Skip to content

NormalizedSpan

NormalizedSpan = object

Normalized operation span captured during a harness run.

optional attributes?: NormalizedSpanAttributes

JSON-safe operation attributes.


optional durationMs?: number

Span duration in milliseconds.


optional error?: NormalizedError

Normalized error when the span failed.


optional events?: NormalizedSpanEvent[]

Events observed inside this span.


optional finishedAt?: string

ISO timestamp for the end of the span.


optional id?: string

Runtime or provider span id when one is available.


optional kind?: "run" | "agent" | "model" | "tool" | "guardrail" | "handoff" | "custom"

Coarse operation kind used by reporters and judges.


name: string

Human-readable operation name.


optional parentId?: string

Parent span id when the runtime exposes hierarchy.


optional startedAt?: string

ISO timestamp for the start of the span.


optional status?: "ok" | "error"

Success or failure status for the span.


optional traceId?: string

Trace id this span belongs to.