Struct ReadProvenance 

pub struct ReadProvenance {
    pub read_id: Uuid,
    pub agent_id: String,
    pub query_hash: Vec<u8>,
    pub derived_from: Vec<RecordRef>,
    pub hmac: Vec<u8>,
    pub hmac_key_id: String,
    pub ts: DateTime<Utc>,
}

Cryptographic receipt that an engine.recall call returned the listed memories.

Carry this alongside any audit-log export. Verifiers call verify_read_provenance with the records they have access to.

Fields

read_id: Uuid

agent_id: String

query_hash: Vec<u8>

SHA-256 of the recall query string. Hashing rather than storing the raw query keeps PII off the wire when a downstream system only needs to verify the chain.

derived_from: Vec<RecordRef>

Records the recall derived from, in retrieval-rank order.

hmac: Vec<u8>

HMAC-SHA256 over read_id || query_hash || concat(derived_from).

hmac_key_id: String

Identifier of the HMAC key used. Lets verifiers look up the right historical key after rotation.

ts: DateTime<Utc>

Trait Implementations

impl Clone for ReadProvenance

fn clone(&self) -> ReadProvenance

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReadProvenance

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ReadProvenance

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ReadProvenance

fn eq(&self, other: &ReadProvenance) -> 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 ReadProvenance

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 ReadProvenance