behest 0.2.2

A Rust-native cloud agent runtime with typed tools, pluggable memory, queues, and observability.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

//! Composite in-memory store that coordinates cascading operations
//! across all storage domains.

use uuid::Uuid;

use crate::store::memory::{
    MemoryArtifactStore, MemoryEmbeddingStore, MemoryExecutionStore, MemorySessionStore,
};
use crate::store::{ArtifactStore, EmbeddingStore, ExecutionStore, SessionStore, StoreResult};

/// A composite store that holds all four in-memory sub-stores
/// and provides coordinated operations, including cascading deletes.
///
/// # Example
///
/// ```rust
/// use behest::store::memory::MemoryStore;
///
/// # async fn example() -> Result<(), behest::StorageError> {
/// let store = MemoryStore::new();
/// // Use store.sessions, store.executions, store.embeddings, store.artifacts
/// // individually, or use store.delete_session_cascading() for full cleanup.
/// # Ok(())
/// # }
/// ```
#[derive(Default)]
pub struct MemoryStore {
    /// Session and message storage.
    pub sessions: MemorySessionStore,
    /// Embedding storage.
    pub embeddings: MemoryEmbeddingStore,
    /// Artifact storage.
    pub artifacts: MemoryArtifactStore,
    /// Tool execution and usage storage.
    pub executions: MemoryExecutionStore,
}

impl MemoryStore {
    /// Creates a new empty composite memory store.
    #[must_use]
    pub fn new() -> Self {
        Self::default()
    }

    /// Deletes a session and all related data across all sub-stores.
    ///
    /// This is semantically equivalent to what a real database would do
    /// with foreign-key `ON DELETE CASCADE`, but across in-memory collections.
    ///
    /// # Errors
    ///
    /// Individual sub-store errors are collected and returned as a single
    /// [`StorageError::BackendError`](crate::error::StorageError::BackendError).
    pub async fn delete_session_cascading(&self, id: &Uuid) -> StoreResult<()> {
        // Collect errors from all sub-stores
        let mut errors: Vec<String> = Vec::new();

        if let Err(e) = self.sessions.delete_session(id).await {
            errors.push(format!("sessions: {e}"));
        }
        if let Err(e) = self.embeddings.delete_by_session(id).await {
            errors.push(format!("embeddings: {e}"));
        }
        if let Err(e) = self.artifacts.delete_by_session(id).await {
            errors.push(format!("artifacts: {e}"));
        }
        if let Err(e) = self.executions.delete_by_session(id).await {
            errors.push(format!("executions: {e}"));
        }

        if errors.is_empty() {
            Ok(())
        } else {
            Err(crate::error::StorageError::BackendError {
                backend: "memory".to_owned(),
                message: format!("cascade delete failed: {}", errors.join("; ")),
                source: None,
            })
        }
    }
}