Enum AgentError 

pub enum AgentError {
    Held {
        action: String,
        draft: String,
    },
    Invalid(&'static str),
    Unknown(String),
    NameTaken(String),
    Identity {
        holder: String,
        agent: String,
    },
    Present {
        agent: String,
        connection: u64,
        since_ms: u64,
    },
    Bound {
        bound: &'static str,
        limit: usize,
        count: usize,
    },
    Transition(&'static str),
    DraftMismatch,
    ServerOwned(String),
    Store(String),
    Uncertain,
    Delivery(&'static str),
}

Why an agent operation did nothing, or why its durable outcome is unknown.

Variants

Held

A deliberate act is still a draft in Lys.

Fields

action: String

The requested action.

draft: String

The retained draft id.

Invalid(&'static str)

A boundary value is malformed; only the member is named.

Unknown(String)

A name has no retained record.

NameTaken(String)

A retained name cannot be reused, including after retirement.

Identity

An identity claim does not match the verified pass.

Fields

holder: String

The verified holder, or unverified.

agent: String

The claimed agent.

Present

Another live connection holds this agent’s seat. It is never taken over or shared: the seat is released when that connection closes, or when its peer stops answering the kernel’s keepalive.

Fields

agent: String

The agent’s name.

connection: u64

The incumbent connection.

since_ms: u64

Epoch milliseconds the incumbent was admitted.

Bound

A configured count or byte bound is reached.

Fields

bound: &'static str

The configuration member.

limit: usize

The configured limit.

count: usize

The measured population or byte count.

Transition(&'static str)

The state machine does not admit this event.

DraftMismatch

A draft id is already bound to different immutable words.

ServerOwned(String)

Only the server writes presence and state.

Store(String)

A lock or store failed; request bodies are never included.

Uncertain

A write may have committed; reopen before making another decision.

Delivery(&'static str)

The library refused delivery, with no body retained in the error.

Trait Implementations

impl Debug for AgentError

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

Formats the value using the given formatter.

impl Display for AgentError

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

Formats the value using the given formatter.

impl Error for AgentError

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.

impl From<AgentError> for ServerError

fn from(source: AgentError) -> Self

Converts to this type from the input type.