Struct MemoryLink 

pub struct MemoryLink {
    pub source_id: String,
    pub target_id: String,
    pub relation: MemoryLinkRelation,
    pub created_at: String,
    pub signature: Option<Vec<u8>>,
    pub observed_by: Option<String>,
    pub valid_from: Option<String>,
    pub valid_until: Option<String>,
    pub attest_level: Option<String>,
}

Fields

source_id: String

target_id: String

relation: MemoryLinkRelation

v0.7.0 fix campaign R1-M4 — typed closed set. Round-trips with the memory_links.relation TEXT column via MemoryLinkRelation::as_str (write) / from_str (read). The SQL CHECK constraint added in migration 0023 enforces the same membership at the storage layer so direct-SQL writers cannot bypass the Rust validator.

created_at: String

signature: Option<Vec<u8>>

v0.7 H3 — optional 64-byte Ed25519 signature carried over the federation wire. None for legacy peers (pre-v0.7) that do not sign outbound links; receivers in that case land the row with attest_level = "unsigned". When Some, it is verified against the public key associated with observed_by before insert. skip_serializing_if keeps the wire shape byte-identical to pre-H3 for unsigned rows so v0.6.x peers continue to deserialize without surprise.

observed_by: Option<String>

v0.7 H3 — agent_id that asserts this link. Mirrors the H2 SignableLink.observed_by field. Required when signature is Some (it is the lookup key for the verifying public key); None is treated as “no claim” and short-circuits to unsigned.

valid_from: Option<String>

v0.7 H3 — RFC3339 instant the link became true (matches the homonymous column in memory_links). Part of the signed bundle; must round-trip byte-identical with what the sender signed for verification to succeed.

valid_until: Option<String>

v0.7 H3 — RFC3339 instant the link was invalidated, or None if still valid. Part of the signed bundle.

attest_level: Option<String>

v0.7 H4 — attestation level for the row ("unsigned", "self_signed", "peer_attested"). Populated by readers that surface the memory_links.attest_level TEXT column (e.g. db::get_links for the memory_get_links MCP tool). Stays None on constructors that don’t go through a DB read — those paths still feed create_link_inbound which derives the column value from the attest_level: &str parameter. The skip_serializing_if keeps the wire shape byte-identical to pre-v0.7 federation peers that don’t carry the column.

Trait Implementations

impl Clone for MemoryLink

fn clone(&self) -> MemoryLink

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemoryLink

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MemoryLink

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MemoryLink

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

where __S: Serializer,

Serialize this value into the given Serde serializer.