pub trait Store: Send + Sync {
Show 32 methods
// Required methods
fn store_memory<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
memory: Memory,
) -> Pin<Box<dyn Future<Output = Result<MemoryId>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait;
fn recall_memory<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
id: &'life2 MemoryId,
) -> Pin<Box<dyn Future<Output = Result<Option<Memory>>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait;
fn delete_memory<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
id: &'life2 MemoryId,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait;
fn list_memories<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<Memory>>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait;
fn store_stats<'life0, 'async_trait>(
&'life0 self,
) -> Pin<Box<dyn Future<Output = Result<StoreStats>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait;
fn check_duplicate<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
content: &'life2 str,
) -> Pin<Box<dyn Future<Output = Result<Option<MemoryId>>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait;
fn search_memories<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
embedding: &'life2 Embedding,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<SearchHit>>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait;
fn list_rooms<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
project: Option<&'life2 str>,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<Room>>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait;
fn taxonomy<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
) -> Pin<Box<dyn Future<Output = Result<Vec<ProjectTaxon>>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait;
fn palace_graph<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
) -> Pin<Box<dyn Future<Output = Result<PalaceGraph>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait;
fn traverse_tunnel<'life0, 'life1, 'life2, 'life3, 'life4, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
topic: &'life2 str,
project_a: &'life3 str,
project_b: &'life4 str,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<TunnelTraversal>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
'life3: 'async_trait,
'life4: 'async_trait;
fn ingest_turn<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
turn: SessionTurn,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait;
fn session_turns<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
session: &'life2 SessionId,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<SessionTurn>>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait;
fn create_session<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
session: Session,
) -> Pin<Box<dyn Future<Output = Result<SessionId>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait;
fn list_sessions<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
harness: Option<&'life2 Harness>,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<Session>>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait;
fn end_session<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
session: &'life2 SessionId,
ended_at: String,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait;
fn write_diary<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
entry: DiaryEntry,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait;
fn read_diary<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
agent: &'life2 str,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<DiaryEntry>>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait;
fn register_repo<'life0, 'async_trait>(
&'life0 self,
repo: RepoDirectory,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait;
fn list_repos<'life0, 'async_trait>(
&'life0 self,
) -> Pin<Box<dyn Future<Output = Result<Vec<RepoDirectory>>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait;
fn revoke_token<'life0, 'async_trait>(
&'life0 self,
revocation: TokenRevocation,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait;
fn list_revocations<'life0, 'async_trait>(
&'life0 self,
) -> Pin<Box<dyn Future<Output = Result<Vec<TokenRevocation>>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait;
fn grant_namespace_membership<'life0, 'async_trait>(
&'life0 self,
membership: NamespaceMembership,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait;
fn revoke_namespace_membership<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
principal: &'life2 str,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait;
fn list_namespace_members<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
) -> Pin<Box<dyn Future<Output = Result<Vec<NamespaceMembership>>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait;
fn is_namespace_member<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
principal: &'life2 str,
) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait;
fn enqueue_extraction<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
memory: Memory,
confidence: f32,
) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait;
fn list_pending<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<QueuedExtraction>>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait;
fn accept_extraction<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
queue_id: &'life2 str,
) -> Pin<Box<dyn Future<Output = Result<AcceptedExtraction>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait;
fn reject_extraction<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
queue_id: &'life2 str,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait;
// Provided methods
fn list_memories_filtered<'life0, 'life1, 'life2, 'life3, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
project: Option<&'life2 str>,
topic: Option<&'life3 str>,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<Memory>>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
'life3: 'async_trait { ... }
fn resolve_repo<'life0, 'life1, 'async_trait>(
&'life0 self,
cwd: &'life1 str,
) -> Pin<Box<dyn Future<Output = Result<Option<RepoDirectory>>> + Send + 'async_trait>>
where Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait { ... }
}Expand description
The storage contract.
Implementations must be Send + Sync (shared across an axum handler
pool). Async via [async_trait], matching the DB backends’ async I/O.
Required Methods§
Sourcefn store_memory<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
memory: Memory,
) -> Pin<Box<dyn Future<Output = Result<MemoryId>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn store_memory<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
memory: Memory,
) -> Pin<Box<dyn Future<Output = Result<MemoryId>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Stores a curated memory under ns, performing content-hash +
semantic dedup. Returns the stored id.
Sourcefn recall_memory<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
id: &'life2 MemoryId,
) -> Pin<Box<dyn Future<Output = Result<Option<Memory>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn recall_memory<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
id: &'life2 MemoryId,
) -> Pin<Box<dyn Future<Output = Result<Option<Memory>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Recalls a single memory by id within ns. Returns None if the
id is absent or belongs to a different namespace (isolation).
Sourcefn delete_memory<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
id: &'life2 MemoryId,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn delete_memory<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
id: &'life2 MemoryId,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Deletes a memory by id within ns.
Sourcefn list_memories<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<Memory>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn list_memories<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<Memory>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Lists up to limit memories in ns, ranked by importance DESC
then recency DESC. Powers wake-up composition (L1a personal
essentials, L1b doctrine baseline).
Sourcefn store_stats<'life0, 'async_trait>(
&'life0 self,
) -> Pin<Box<dyn Future<Output = Result<StoreStats>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn store_stats<'life0, 'async_trait>(
&'life0 self,
) -> Pin<Box<dyn Future<Output = Result<StoreStats>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Global store statistics across all namespaces (operator/admin
view). Powers GET /status.
Sourcefn check_duplicate<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
content: &'life2 str,
) -> Pin<Box<dyn Future<Output = Result<Option<MemoryId>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn check_duplicate<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
content: &'life2 str,
) -> Pin<Box<dyn Future<Output = Result<Option<MemoryId>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Checks whether a memory with identical content already exists in
ns (content-hash dedup). Returns the existing MemoryId if so.
Sourcefn search_memories<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
embedding: &'life2 Embedding,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<SearchHit>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn search_memories<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
embedding: &'life2 Embedding,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<SearchHit>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Semantic search over memories in ns by nearest embedding.
Implementations back this with a vector index (SurrealDB MTREE,
pgvector). v0 backends MAY return crate::IjimaError::Store until
the vector index is wired.
Sourcefn list_rooms<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
project: Option<&'life2 str>,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<Room>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn list_rooms<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
project: Option<&'life2 str>,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<Room>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Lists rooms (topic cells) in ns, optionally filtered to a single
project. Each room carries its memory count. Ordered by count desc.
Sourcefn taxonomy<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
) -> Pin<Box<dyn Future<Output = Result<Vec<ProjectTaxon>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn taxonomy<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
) -> Pin<Box<dyn Future<Output = Result<Vec<ProjectTaxon>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Full project → topic → count taxonomy of ns. Powers
getTaxonomy navigation.
Sourcefn palace_graph<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
) -> Pin<Box<dyn Future<Output = Result<PalaceGraph>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn palace_graph<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
) -> Pin<Box<dyn Future<Output = Result<PalaceGraph>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
The palace graph: projects as nodes, shared-topic tunnels as edges.
Powers getPalaceGraph — “what connects these projects?”
Sourcefn traverse_tunnel<'life0, 'life1, 'life2, 'life3, 'life4, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
topic: &'life2 str,
project_a: &'life3 str,
project_b: &'life4 str,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<TunnelTraversal>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
'life3: 'async_trait,
'life4: 'async_trait,
fn traverse_tunnel<'life0, 'life1, 'life2, 'life3, 'life4, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
topic: &'life2 str,
project_a: &'life3 str,
project_b: &'life4 str,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<TunnelTraversal>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
'life3: 'async_trait,
'life4: 'async_trait,
Traverses a tunnel: returns the actual memories from both projects on
the shared topic, so the caller can see what connects them.
Sourcefn ingest_turn<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
turn: SessionTurn,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn ingest_turn<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
turn: SessionTurn,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Appends a raw turn to the session transcript under ns.
Sourcefn session_turns<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
session: &'life2 SessionId,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<SessionTurn>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn session_turns<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
session: &'life2 SessionId,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<SessionTurn>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Returns the last limit turns of session under ns, in order.
Sourcefn create_session<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
session: Session,
) -> Pin<Box<dyn Future<Output = Result<SessionId>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn create_session<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
session: Session,
) -> Pin<Box<dyn Future<Output = Result<SessionId>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Creates or updates a session’s metadata under ns (upsert by
id). Call when a session starts; turns reference the session id.
ended_at is set via Self::end_session.
Sourcefn list_sessions<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
harness: Option<&'life2 Harness>,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<Session>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn list_sessions<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
harness: Option<&'life2 Harness>,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<Session>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Lists up to limit sessions in ns, newest first, optionally
filtered by harness.
Sourcefn end_session<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
session: &'life2 SessionId,
ended_at: String,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn end_session<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
session: &'life2 SessionId,
ended_at: String,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Marks a session as ended (sets ended_at). Scoped by ns so a
principal can only end sessions in their own namespace.
Sourcefn write_diary<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
entry: DiaryEntry,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn write_diary<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
entry: DiaryEntry,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Appends a diary entry under ns.
Sourcefn read_diary<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
agent: &'life2 str,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<DiaryEntry>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn read_diary<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
agent: &'life2 str,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<DiaryEntry>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Returns the last limit entries of agent’s diary under ns, in
chronological order.
Sourcefn register_repo<'life0, 'async_trait>(
&'life0 self,
repo: RepoDirectory,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn register_repo<'life0, 'async_trait>(
&'life0 self,
repo: RepoDirectory,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Registers or upserts a repository in the global registry (keyed by
name). Powers POST /repos — the canonical Anima roster.
Sourcefn list_repos<'life0, 'async_trait>(
&'life0 self,
) -> Pin<Box<dyn Future<Output = Result<Vec<RepoDirectory>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn list_repos<'life0, 'async_trait>(
&'life0 self,
) -> Pin<Box<dyn Future<Output = Result<Vec<RepoDirectory>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Lists every registered repository (the ecosystem roster).
Sourcefn revoke_token<'life0, 'async_trait>(
&'life0 self,
revocation: TokenRevocation,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn revoke_token<'life0, 'async_trait>(
&'life0 self,
revocation: TokenRevocation,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Records a token revocation (idempotent upsert keyed by hash).
Powers POST /tokens/revoke (admin).
Sourcefn list_revocations<'life0, 'async_trait>(
&'life0 self,
) -> Pin<Box<dyn Future<Output = Result<Vec<TokenRevocation>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn list_revocations<'life0, 'async_trait>(
&'life0 self,
) -> Pin<Box<dyn Future<Output = Result<Vec<TokenRevocation>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Lists every recorded revocation, oldest first. Powers
GET /tokens/revocations (admin) and daemon-boot hydration of the
in-memory rejection set.
Sourcefn grant_namespace_membership<'life0, 'async_trait>(
&'life0 self,
membership: NamespaceMembership,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn grant_namespace_membership<'life0, 'async_trait>(
&'life0 self,
membership: NamespaceMembership,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Grants (upserts) a principal’s membership in a shared namespace.
Admin operation; idempotent — re-granting refreshes granted_at/
granted_by but never duplicates.
Sourcefn revoke_namespace_membership<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
principal: &'life2 str,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn revoke_namespace_membership<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
principal: &'life2 str,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Revokes a membership. Idempotent: revoking an absent membership is not an error.
Sourcefn list_namespace_members<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
) -> Pin<Box<dyn Future<Output = Result<Vec<NamespaceMembership>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn list_namespace_members<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
) -> Pin<Box<dyn Future<Output = Result<Vec<NamespaceMembership>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Lists the members of a namespace, oldest grant first. Powers
GET /namespaces/members (admin).
Sourcefn is_namespace_member<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
principal: &'life2 str,
) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn is_namespace_member<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
principal: &'life2 str,
) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Hot-path membership check behind resolve_ns (shared-namespace
reads/writes).
Sourcefn enqueue_extraction<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
memory: Memory,
confidence: f32,
) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn enqueue_extraction<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
memory: Memory,
confidence: f32,
) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Stages a PendingReview extraction in the per-namespace queue.
Sourcefn list_pending<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<QueuedExtraction>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn list_pending<'life0, 'life1, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<QueuedExtraction>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Lists pending extractions in ns, newest first.
Sourcefn accept_extraction<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
queue_id: &'life2 str,
) -> Pin<Box<dyn Future<Output = Result<AcceptedExtraction>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn accept_extraction<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
queue_id: &'life2 str,
) -> Pin<Box<dyn Future<Output = Result<AcceptedExtraction>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Accepts a queued extraction: promotes it to the palace and removes it from the queue.
Sourcefn reject_extraction<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
queue_id: &'life2 str,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn reject_extraction<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
queue_id: &'life2 str,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Rejects a queued extraction: drops it from the queue without promoting.
Provided Methods§
Sourcefn list_memories_filtered<'life0, 'life1, 'life2, 'life3, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
project: Option<&'life2 str>,
topic: Option<&'life3 str>,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<Memory>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
'life3: 'async_trait,
fn list_memories_filtered<'life0, 'life1, 'life2, 'life3, 'async_trait>(
&'life0 self,
ns: &'life1 NamespaceId,
project: Option<&'life2 str>,
topic: Option<&'life3 str>,
limit: usize,
) -> Pin<Box<dyn Future<Output = Result<Vec<Memory>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
'life3: 'async_trait,
Lists memories in ns, optionally filtered to project/topic.
Powers GET /memories (the memory_recall browse path — distinct
from Self::list_memories, which is the importance-ranked
wake-up feed). Default: fetch a cap, filter in Rust, truncate.
Backends MAY override with a native filtered query.
Sourcefn resolve_repo<'life0, 'life1, 'async_trait>(
&'life0 self,
cwd: &'life1 str,
) -> Pin<Box<dyn Future<Output = Result<Option<RepoDirectory>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn resolve_repo<'life0, 'life1, 'async_trait>(
&'life0 self,
cwd: &'life1 str,
) -> Pin<Box<dyn Future<Output = Result<Option<RepoDirectory>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Reverse-resolves a working directory to its registered repo: the
most specific repo whose path is a prefix of cwd (after
normalizing). Powers GET /repos/resolve (CWD → project).
Dyn Compatibility§
This trait is dyn compatible.
In older versions of Rust, dyn compatibility was called "object safety".