session-storeとして分離

crates/session-store/src/lib.rs

@@ -0,0 +1,53 @@
+//! Session persistence via append-only JSONL logs.
+//!
+//! # Architecture
+//!
+//! Sessions are recorded as a sequence of [`LogEntry`] values, one per line
+//! in a `.jsonl` file. Reading the log and collecting entries reconstructs
+//! the full Worker state — no separate snapshots or checkpoints needed.
+//!
+//! This crate provides free functions for persistence operations.
+//! The caller (typically Pod) holds the Worker directly and calls these
+//! functions after state-mutating operations.
+//!
+//! Debug-mode [`TraceEntry`] records capture raw stream events in a separate
+//! `.trace.jsonl` file, independent of the session log.
+//!
+//! # Quick start
+//!
+//! ```ignore
+//! use session_store::{create_session, restore, save_delta, FsStore, SessionStartState};
+//!
+//! let store = FsStore::new("./sessions").await?;
+//! let (session_id, head_hash) = create_session(&store, SessionStartState {
+//!     system_prompt: None,
+//!     config: &config,
+//!     history: &[],
+//! }).await?;
+//! ```
+
+pub mod event_trace;
+pub mod fs_store;
+pub mod session;
+pub mod session_log;
+pub mod store;
+
+pub use event_trace::TraceEntry;
+pub use fs_store::FsStore;
+pub use session::{
+    SessionStartState, create_session, ensure_head_or_fork, fork, fork_at, restore, save_cache_locked,
+    save_cache_unlocked, save_config_changed, save_delta, save_outcome, save_turn_end,
+};
+pub use session_log::{
+    EntryHash, HashedEntry, LogEntry, Outcome, RestoredState, build_chain, collect_state,
+    compute_hash,
+};
+pub use store::{Store, StoreError};
+
+/// Session identifier. UUID v7 (time-ordered, lexicographically sortable).
+pub type SessionId = uuid::Uuid;
+
+/// Generate a new session ID.
+pub fn new_session_id() -> SessionId {
+    uuid::Uuid::now_v7()
+}