Premier format version 1 stores a manifest.json plus an active protobuf journal or finalized Zstandard-compressed journal. Use CLI and API readers rather than coupling integrations to the binary framing.

Event input envelope

Field Type Meaning
kind string Required semantic family such as agent.spawn or tool.result
source string Producer or adapter identity; defaults to sdk for library input
actor_id / actor_type string Stable participant identity and role
parent_event_id string Exact causal event parent when known
span_id / parent_span_id string Lifecycle and delegation structure
correlation_id string Cross-event operation or provider call identity
links string[] Additional event relationships
status string Producer outcome such as running, ok, error, or denied
duration_ms integer Producer-measured duration; zero means absent, not estimated
timestamp RFC 3339 string Optional producer time; receipt time is used when omitted
payload JSON Structured evidence; object payloads provide the best viewer experience

Premier assigns event_id, trace_id, and monotonically increasing sequence at ingestion. Stored events expose payload as payload_json in the binary/API contract.

Known families

Semantic diagnostics understand agent spawn/result and delegation/join, model request/response, tool invocation/result, and approval request/decision lifecycles. Unknown custom kinds remain valid and visible; diagnostics are advisory and do not rewrite evidence.

Manifest

The manifest records command, start/end time, termination, tenant ownership, capabilities, finalized journal digest/count, diagnostics, redaction provenance, and adapter provenance. premier verify validates framing, digest, event count, and trace identity.

Compatibility rules

  • Preserve unknown event fields and payload keys.
  • Do not invent missing model usage, duration, causal parents, or role-token attribution.
  • Treat empty strings and zero durations as unavailable unless the producer explicitly defines them otherwise.
  • Pin behavior to format_version and adapter schema_version, not the Premier application version.