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.

GH #76 error surface: an optional details field carries the structured mlua_swarm::service::TaskLaunchError::FlowEval envelope (failed_step / verdict_value / partial_ctx) when the abort originated from a Blueprint step. When present, the JSON body becomes {"error": message, "details": {...}} — a pure ADDITIVE schema change for consumers that already ignore unknown keys. Absent (the default) preserves the pre-#76 {"error": message} shape byte-for-byte for every other error site.

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).

pub fn with_details(self, details: Value) -> Self

GH #76 error surface: attach a structured details payload alongside the string message. Consumed by IntoResponse to emit {"error": message, "details": {...}}. The current sole caller is run_flow_form’s TaskApplicationError::Launch(FlowEval) arm, which lifts failed_step / verdict_value / partial_ctx out of the structured mlua_swarm::service::TaskLaunchError::FlowEval variant into this field.

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.