Enum CapabilityError 

pub enum CapabilityError {
    InvalidInput(String),
    NotFound(String),
    Refused(String),
    Internal(String),
    Forbidden(String),
}

Why a call did not produce an output. Transport adapters map these to their own vocabularies; nothing here names a status code or a JSON-RPC code.

Variants

InvalidInput(String)

The input did not deserialize into the handler’s type, or a filter named something the repository does not have.

NotFound(String)

The thing asked for does not exist: an object, a capability.

Refused(String)

The input is well-formed and the call is declined, with the reason (a blank query).

Internal(String)

The handler itself failed; never the caller’s fault.

Forbidden(String)

The caller may not run this from where it is: a request from another host for a capability that changes something and does not authenticate its input (ADR 0126).

Implementations

impl CapabilityError

pub fn code(&self) -> &'static str

The category as one word, the same on every transport: the error.code of an HTTP answer and the _meta.majordomus.error.code of an MCP tool result that is an error. A caller branches on this and reads the message; it never has to parse the message to learn which of the five happened.

use majordomus_cli::capability::CapabilityError;
assert_eq!(CapabilityError::InvalidInput("x".into()).code(), "invalid_input");
assert_eq!(CapabilityError::NotFound("x".into()).code(), "not_found");
assert_eq!(CapabilityError::Refused("x".into()).code(), "refused");
assert_eq!(CapabilityError::Internal("x".into()).code(), "internal");
assert_eq!(CapabilityError::Forbidden("x".into()).code(), "forbidden");

pub fn remote(id: &str) -> Self

The refusal a caller on another host meets when it asks for a capability that changes something and does not authenticate its input. One sentence on every transport, so the HTTP route and the MCP tool refuse alike.

use majordomus_cli::capability::CapabilityError;
let e = CapabilityError::remote("plan.transition");
assert_eq!(e.code(), "forbidden");
assert!(e.to_string().contains("plan.transition"));

Trait Implementations

impl Clone for CapabilityError

fn clone(&self) -> CapabilityError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CapabilityError

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

Formats the value using the given formatter.

impl Display for CapabilityError

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

Formats the value using the given formatter.

impl Eq for CapabilityError

impl Error for CapabilityError

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 PartialEq for CapabilityError

fn eq(&self, other: &CapabilityError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for CapabilityError