mnemara-protocol

mnemara-protocol publishes the protobuf and gRPC types used by the Mnemara service surface.

Choose this crate when you need Rust client or server access to the wire contract without pulling in a storage backend or the full daemon implementation.

Install

Add the crate to your Rust project with:

cargo add mnemara-protocol

What it exposes

• generated protobuf messages under mnemara_protocol::v1
• generated gRPC client and server traits for the Mnemara memory service
• episodic record fields, lineage links, recall filter controls, and planning-trace payloads
• lifecycle, stats, integrity, trace, and portable import or export RPCs

Minimal example

use mnemara_protocol::v1::{RecallFilters, RecallRequest};

let request = RecallRequest {
    query_text: "reconnect storm mitigation".to_string(),
    filters: Some(RecallFilters {
        unresolved_only: true,
        ..Default::default()
    }),
    ..Default::default()
};

Notes

• intended for Rust gRPC clients and servers that need the wire-level schema
• the schema includes additive episodic memory fields such as episode context, recurrence, boundary cues, historical state, and lineage
• recall filters cover historical and continuity-aware retrieval controls such as episode_id, continuity_states, unresolved_only, temporal_order, historical_mode, and lineage_record_id
• lifecycle RPCs cover archive, suppress, recover, stats, integrity, repair, trace lookup, export, and import flows in addition to upsert, recall, compact, snapshot, and delete
• pairs with mnemara-server for the reference daemon implementation
• embedded applications that only need the domain model should depend on mnemara-core or the mnemara facade instead

Project documentation: https://github.com/deliberium/mnemara