Struct Record 

pub struct Record {
    pub version: String,
    pub id: String,
    pub kind: Kind,
    pub ts: String,
    pub parent: Option<String>,
    pub meta: Option<Map<String, Value>>,
    pub payload: Value,
}

One record in an .agentlog file (SPEC §3.1).

Fields

version: String

.agentlog schema version; must equal CURRENT_VERSION for records created by this implementation. Strict parsers reject other values.

id: String

Content id: "sha256:" + hex(sha256(canonical_json(payload))) (SPEC §6).

kind: Kind

Record kind (SPEC §4).

ts: String

RFC 3339 UTC timestamp with millisecond precision, e.g. "2026-04-21T10:00:00.100Z". Always ends in Z (no numeric offset) — SPEC §3.1.

parent: Option<String>

Parent record id, or None if this is the root (metadata) record.

meta: Option<Map<String, Value>>

Free-form envelope metadata. Not part of the content hash.

payload: Value

The kind-specific body; SHA-256 of the canonical form of this field is the id.

Implementations

impl Record

pub fn new( kind: Kind, payload: Value, ts: impl Into<String>, parent: Option<String>, ) -> Self

Build a new record, computing id from the canonical-JSON of payload.

The version field is always set to CURRENT_VERSION; the caller provides kind, payload, ts, and parent. meta is None — set it via Record::with_meta if needed.

pub fn with_meta(self, meta: Map<String, Value>) -> Self

Attach a meta map (builder-style).

pub fn verify_id(&self) -> bool

Re-compute the id from the payload and compare. Returns true if the record has not been tampered with since it was created.

Trait Implementations

impl Clone for Record

fn clone(&self) -> Record

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Record

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Record

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Record

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Record

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Record

impl StructuralPartialEq for Record