starweaver-session 0.10.0

Durable session contracts for Starweaver
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

//! Session store errors.

use thiserror::Error;

/// Session store failure.
#[derive(Debug, Error)]
pub enum SessionStoreError {
    /// Record was not found.
    #[error("session record not found: {0}")]
    NotFound(String),
    /// Record already exists.
    #[error("session record already exists: {0}")]
    AlreadyExists(String),
    /// Optimistic revision or lifecycle conflict.
    #[error("session record conflict: {0}")]
    Conflict(String),
    /// The caller no longer owns the admission or fencing generation.
    #[error("session stale fence: {0}")]
    StaleFence(String),
    /// One idempotency key was reused for a different normalized command.
    #[error("session idempotency conflict: {0}")]
    IdempotencyConflict(String),
    /// A trusted host retention or admission quota was exceeded.
    #[error("session quota exceeded: {0}")]
    QuotaExceeded(String),
    /// The session already owns a live run admission.
    #[error("session run conflict: {0}")]
    RunConflict(String),
    /// Store operation failed transiently and may be retried with the same command identity.
    #[error("session store temporarily unavailable: {0}")]
    RetryableStorage(String),
    /// Store failed.
    #[error("session store failed: {0}")]
    Failed(String),
}

/// Result alias for session store operations.
pub type SessionStoreResult<T> = Result<T, SessionStoreError>;

impl From<SessionStoreError> for starweaver_context::AgentExecutorError {
    fn from(error: SessionStoreError) -> Self {
        Self::Failed(error.to_string())
    }
}