Enum EditSource 

pub enum EditSource {
    Human,
    Llm,
    Hook,
    Agent,
}

v0.7.0 Provenance Gap 5 (issue #888) — typed edit-source discriminator gating the storage::update write-path branch.

• EditSource::Human (default) — direct in-place mutation, the v0.6.x / pre-Gap-5 behaviour. Content is overwritten; the row’s version is bumped; no archive is created.
• EditSource::Llm / EditSource::Hook — append-and-archive. A NEW memory row is minted carrying the patched content; a supersedes link is written pointing new→old; the OLD row is archived with archive_reason = 'superseded' so callers can rewind via memory_archive_list to read the pre-edit state.

The split exists so caller intent (human-typed correction vs. curator/LLM rewrite) is preserved in the audit trail. Mem9’s pattern: in-place for human edits, append-and-archive for programmatic rewrites where the new content semantically replaces the old.

Variants

Human

Direct in-place mutation of the existing row. Default.

Llm

Append-and-archive: mint a NEW row + supersedes link + archive the OLD row with archive_reason='superseded'.

Hook

Append-and-archive: same shape as EditSource::Llm but records that a substrate hook triggered the rewrite.

Agent

v0.7.x issue #1600 — direct in-place mutation performed by an AI/NHI agent. Mutation semantics are IDENTICAL to EditSource::Human (does NOT route through append-and-archive); the variant exists so the audit trail can distinguish a human-typed correction from an agent-initiated in-place edit. When edit_source is omitted on memory_update the default is derived from the resolved caller id via EditSource::default_for_agent_id.

Implementations

impl EditSource

pub const ALL: [Self; 4]

#1600 — the closed wire vocabulary, in declaration order. The memory_update validation error names the valid set from this const so the message can never drift from the parser below.

pub fn as_str(&self) -> &'static str

Column-wire string used in audit log entries + the archive row’s archive_reason-adjacent metadata.

pub fn from_str(s: &str) -> Option<Self>

Parse the column-wire string. Returns None on unrecognised values; per #1600 the MCP memory_update surface now surfaces None as a validation ERROR naming EditSource::ALL instead of silently defaulting to EditSource::Human.

pub fn default_for_agent_id(agent_id: &str) -> Self

#1600 — default edit-source for an UPDATE whose caller omitted edit_source, derived from the resolved caller agent id: ids under crate::identity::sentinels::AI_AGENT_ID_PREFIX (ai:…) default to EditSource::Agent; every other shape (host:…, anonymous:…, bare operator ids) keeps the historical EditSource::Human default.

pub fn appends_and_archives(&self) -> bool

true when the edit-source semantics call for the append-and-archive write path (vs. in-place mutation).

Trait Implementations

impl Clone for EditSource

fn clone(&self) -> EditSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for EditSource

impl Debug for EditSource

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

Formats the value using the given formatter.

impl Default for EditSource

fn default() -> EditSource

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for EditSource

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for EditSource

impl PartialEq for EditSource

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

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 EditSource