Enum SessionError 

pub enum SessionError {
    NotFound(Uuid),
    Expired(Uuid),
    BudgetExceeded {
        session_id: Uuid,
        limit: u64,
        used: u64,
    },
    ToolNotAuthorized {
        session_id: Uuid,
        tool: String,
    },
    AlreadyClosed(Uuid),
    RateLimited {
        session_id: Uuid,
        limit_per_minute: u64,
    },
    TooManySessions {
        agent_id: String,
        max: u64,
        current: u64,
    },
}

Errors from session operations.

Display impls are intentionally opaque — they appear in HTTP error responses sent to agents. Internal fields are preserved for structured logging via Debug. Previously, Display exposed budget limits, rate limit values, tool names, and session caps to untrusted agents.

Variants

NotFound(Uuid)

The referenced session does not exist.

Expired(Uuid)

The session has expired (time limit exceeded).

BudgetExceeded

The session’s call budget has been exhausted.

Fields

session_id: Uuid

limit: u64

used: u64

ToolNotAuthorized

The requested tool is not in the session’s authorized set.

Fields

session_id: Uuid

tool: String

AlreadyClosed(Uuid)

The session has already been closed.

RateLimited

The session’s per-minute rate limit has been exceeded.

Fields

session_id: Uuid

limit_per_minute: u64

TooManySessions

The agent has reached the maximum number of concurrent active sessions.

P0: Per-agent session cap to prevent session multiplication attacks.

Fields

agent_id: String

max: u64

current: u64

Trait Implementations

impl Debug for SessionError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for SessionError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for SessionError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.