Struct ApiError 

pub struct ApiError { /* private fields */ }

Uniform error response type for the handlers in this module. Converts to a JSON {"error": message} body with the given status via IntoResponse.

Implementations

impl ApiError

pub fn engine(e: impl Display) -> Self

Wraps an engine-side error as 500 Internal Server Error.

pub fn not_found(m: String) -> Self

Builds a 404 Not Found with the given message.

pub fn bad_request(m: String) -> Self

Builds a 400 Bad Request with the given message.

pub fn conflict(m: String) -> Self

Builds a 409 Conflict with the given message (POST /v1/runs/:id/resume — the Run is not Interrupted, or a concurrent resume already won the Interrupted -> Running compare-and-set).

pub fn unavailable(m: String) -> Self

Builds a 503 Service Unavailable with the given message (GH #33 Guard 1 — operator readiness precheck).

pub fn timeout(m: String) -> Self

Builds a 504 Gateway Timeout with the given message (GH #33 Guard 2 — sync launch timeout ceiling).

pub fn gone(m: String) -> Self

Builds a 410 Gone with the given message (GH #37 — worker submit/artifact addressed at a Run that already reached a terminal status; the silent-204-then-orphan alternative is the failure shape this replaces).

pub fn payload_too_large(m: String) -> Self

Builds a 413 Payload Too Large with the given message (GH #42 — @file: sentinel resolves to a file larger than the shared DefaultBodyLimit; same size ceiling as the inline body path).

pub fn unprocessable(m: impl Into<String>) -> Self

Builds a 422 Unprocessable Entity with the given message (GH #50 — a worker_submit / worker_artifact value violates the dispatching agent’s declared VerdictContract: rejected before it reaches submit_worker_result_trusted / stage_worker_artifact_trusted, i.e. before it can land in the flow ctx).

Trait Implementations

impl Debug for ApiError

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

Formats the value using the given formatter.

impl IntoResponse for ApiError

fn into_response(self) -> Response

Create a response.