Enum Error 

#[non_exhaustive]
pub enum Error {
    Body {
        status: StatusCode,
        message: String,
    },
    ContentType {
        found: String,
    },
    Decode(Error),
    EmptyBody,
    NotAcceptable {
        accept: String,
    },
}

A request this endpoint refused, before any events were produced.

Implements [IntoResponse], so it doubles as the rejection type of AgUiInput — a handler can take Result<AgUiInput, Error> and inspect the failure, or take AgUiInput and let axum answer with the response below.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Body

The request body could not be read at all — a connection that died mid-body, or a payload over the configured DefaultBodyLimit.

Carries the status axum’s own extractor chose, so a body limit stays a 413 rather than being flattened into a 400.

Fields

status: StatusCode

The status to answer with.

message: String

What axum said about it.

ContentType

The Content-Type was set to something that is not JSON.

An absent header is accepted — curl -d and hand-written clients often omit it. A wrong one is refused rather than sniffed, which also means a cross-origin HTML form (whose content type is always one of three non-JSON values it cannot override) can never reach an agent.

Fields

found: String

The offending header value.

Decode(Error)

The body was JSON, but not a RunAgentInput.

The message is serde’s, so it names the field and the offset.

EmptyBody

The request body was empty.

NotAcceptable

Content negotiation found nothing this build can emit.

See negotiate.

Fields

accept: String

The Accept header that could not be satisfied.

Implementations

impl Error

pub const fn status(&self) -> StatusCode

The status this error answers with.

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

The machine-readable code placed in the response body.

Deliberately not derived from the status: a client that wants to branch should not have to distinguish two 400s by parsing prose.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl IntoResponse for Error

fn into_response(self) -> Response

Create a response.