Enum MemoryEvent 

pub enum MemoryEvent {
    Captured {
        meta: EventMeta,
        memory_id: MemoryId,
        namespace: Namespace,
        domain: Domain,
        content_length: usize,
    },
    Retrieved {
        meta: EventMeta,
        memory_id: MemoryId,
        query: Arc<str>,
        score: f32,
    },
    Updated {
        meta: EventMeta,
        memory_id: MemoryId,
        modified_fields: Vec<String>,
    },
    Archived {
        meta: EventMeta,
        memory_id: MemoryId,
        reason: String,
    },
    Deleted {
        meta: EventMeta,
        memory_id: MemoryId,
        reason: String,
    },
    Redacted {
        meta: EventMeta,
        memory_id: MemoryId,
        redaction_type: String,
    },
    Synced {
        meta: EventMeta,
        pushed: usize,
        pulled: usize,
        conflicts: usize,
    },
    Consolidated {
        meta: EventMeta,
        processed: usize,
        archived: usize,
        merged: usize,
    },
    McpStarted {
        meta: EventMeta,
        transport: String,
        port: Option<u16>,
    },
    McpAuthFailed {
        meta: EventMeta,
        client_id: Option<String>,
        reason: String,
    },
    McpToolExecuted {
        meta: EventMeta,
        tool_name: String,
        status: String,
        duration_ms: u64,
        error: Option<String>,
    },
    McpRequestError {
        meta: EventMeta,
        operation: String,
        error: String,
    },
    HookInvoked {
        meta: EventMeta,
        hook: String,
    },
    HookClassified {
        meta: EventMeta,
        hook: String,
        classification: String,
        classifier: String,
        confidence: f32,
    },
    HookCaptureDecision {
        meta: EventMeta,
        hook: String,
        decision: String,
        namespace: Option<String>,
        memory_id: Option<MemoryId>,
    },
    HookFailed {
        meta: EventMeta,
        hook: String,
        error: String,
    },
}

Events emitted during memory operations.

Variants

Captured

A memory was captured.

Fields

meta: EventMeta

Event metadata.

memory_id: MemoryId

The ID of the captured memory.

namespace: Namespace

The namespace.

domain: Domain

The domain.

content_length: usize

Content length in bytes.

Retrieved

A memory was retrieved via search.

Fields

meta: EventMeta

Event metadata.

memory_id: MemoryId

The ID of the retrieved memory.

query: Arc<str>

The search query that matched (Arc<str> for zero-copy sharing, PERF-C1).

score: f32

The similarity score.

Updated

A memory was updated.

Fields

meta: EventMeta

Event metadata.

memory_id: MemoryId

The ID of the updated memory.

modified_fields: Vec<String>

Fields that were modified.

Archived

A memory was archived.

Fields

meta: EventMeta

Event metadata.

memory_id: MemoryId

The ID of the archived memory.

reason: String

Reason for archiving.

Deleted

A memory was deleted.

Fields

meta: EventMeta

Event metadata.

memory_id: MemoryId

The ID of the deleted memory.

reason: String

Reason for deletion.

Redacted

Content was redacted for security.

Fields

meta: EventMeta

Event metadata.

memory_id: MemoryId

The ID of the affected memory.

redaction_type: String

Type of content redacted.

Synced

Memories were synchronized with remote.

Fields

meta: EventMeta

Event metadata.

pushed: usize

Number of memories pushed.

pulled: usize

Number of memories pulled.

conflicts: usize

Number of conflicts resolved.

Consolidated

Consolidation occurred.

Fields

meta: EventMeta

Event metadata.

processed: usize

Number of memories processed.

archived: usize

Number of memories archived.

merged: usize

Number of memories merged.

McpStarted

MCP server started.

Fields

meta: EventMeta

Event metadata.

transport: String

Transport type (stdio/http).

port: Option<u16>

HTTP port if applicable.

McpAuthFailed

MCP authentication failed.

Fields

meta: EventMeta

Event metadata.

client_id: Option<String>

Optional client identifier.

reason: String

Failure reason.

McpToolExecuted

MCP tool execution completed.

Fields

meta: EventMeta

Event metadata.

tool_name: String

Tool name.

status: String

Execution status (success/error).

duration_ms: u64

Execution duration in milliseconds.

error: Option<String>

Optional error string.

McpRequestError

MCP request error (invalid params, tool failure, etc.).

Fields

meta: EventMeta

Event metadata.

operation: String

Operation name.

error: String

Error message.

HookInvoked

Hook invocation event.

Fields

meta: EventMeta

Event metadata.

hook: String

Hook name.

HookClassified

Hook classification event.

Fields

meta: EventMeta

Event metadata.

hook: String

Hook name.

classification: String

Classification label.

classifier: String

Classifier source (keyword/llm/hybrid).

confidence: f32

Confidence score.

HookCaptureDecision

Hook capture decision event.

Fields

meta: EventMeta

Event metadata.

hook: String

Hook name.

decision: String

Decision outcome.

namespace: Option<String>

Namespace selected for capture.

memory_id: Option<MemoryId>

Memory ID if captured.

HookFailed

Hook failure event.

Fields

meta: EventMeta

Event metadata.

hook: String

Hook name.

error: String

Error message.

Implementations

impl MemoryEvent

pub const fn event_type(&self) -> &'static str

Returns the event type name.

pub const fn timestamp(&self) -> u64

Returns the timestamp of the event.

pub const fn meta(&self) -> &EventMeta

Returns the event metadata.

Trait Implementations

impl Clone for MemoryEvent

fn clone(&self) -> MemoryEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemoryEvent

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

Formats the value using the given formatter.