meerkat-core 0.4.1

Core agent logic for Meerkat (no I/O deps)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

//! Session checkpointing trait for periodic persistence.
//!
//! Host-mode agents run indefinitely, so the normal post-turn persistence path
//! (`PersistentSessionService::persist_full_session`) never fires after the
//! initial `create_session`. This trait allows the agent to checkpoint the
//! session after each host-mode interaction.

use crate::session::Session;
use async_trait::async_trait;

/// Periodic session persistence hook.
///
/// Implementations clone what they need from the borrowed `Session`.
/// Errors are logged, not propagated — a checkpoint failure should not
/// kill the agent loop.
#[cfg_attr(target_arch = "wasm32", async_trait(?Send))]
#[cfg_attr(not(target_arch = "wasm32"), async_trait)]
pub trait SessionCheckpointer: Send + Sync {
    /// Save a snapshot of the current session state.
    async fn checkpoint(&self, session: &Session);
}