Enum A2aError 

#[non_exhaustive]
pub enum A2aError {
    TaskNotFound {
        task_id: String,
    },
    TaskNotCancelable {
        task_id: String,
    },
    PushNotificationNotSupported,
    UnsupportedOperation {
        message: String,
    },
    ContentTypeNotSupported {
        content_type: String,
    },
    InvalidAgentResponse {
        message: String,
    },
    ExtendedAgentCardNotConfigured,
    ExtensionSupportRequired {
        extension: String,
    },
    VersionNotSupported {
        version: String,
    },
    InvalidRequest {
        message: String,
    },
    Internal(String),
}

Server-level error for A2A operations.

Each variant corresponds to an A2A-specific error type from the spec with exact HTTP status, JSON-RPC code, and ErrorInfo reason mappings.

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.

TaskNotFound

Fields

task_id: String

TaskNotCancelable

Fields

task_id: String

PushNotificationNotSupported

UnsupportedOperation

Fields

message: String

ContentTypeNotSupported

Fields

content_type: String

InvalidAgentResponse

Fields

message: String

ExtendedAgentCardNotConfigured

ExtensionSupportRequired

Fields

extension: String

VersionNotSupported

Fields

version: String

InvalidRequest

Fields

message: String

Internal(String)

Implementations

impl A2aError

pub fn http_status(&self) -> u16

HTTP status code per spec Section 5.4.

pub fn jsonrpc_code(&self) -> i32

JSON-RPC error code per spec Section 5.4 (-32001 to -32009). Non-A2A errors use standard JSON-RPC codes.

pub fn error_reason(&self) -> Option<&'static str>

ErrorInfo reason string (UPPER_SNAKE_CASE, no “Error” suffix). Returns None for non-A2A errors (InvalidRequest, Internal).

pub fn error_info(&self) -> Option<Value>

Build the google.rpc.ErrorInfo JSON object for this error. Returns None for non-A2A errors.

pub fn to_http_error_body(&self) -> Value

Build the HTTP error response body per AIP-193.

pub fn to_jsonrpc_error(&self, id: Option<&Value>) -> Value

Build the JSON-RPC error object.

Trait Implementations

impl Debug for A2aError

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

Formats the value using the given formatter.

impl Display for A2aError

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

Formats the value using the given formatter.

impl Error for A2aError

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<A2aStorageError> for A2aError

fn from(err: A2aStorageError) -> Self

Converts to this type from the input type.

impl IntoResponse for A2aError

fn into_response(self) -> Response

Create a response.

impl ToJsonRpcError for A2aError

Map A2aError onto turul-rpc’s JsonRpcErrorObject (code/message/data only). The full JSON-RPC envelope (jsonrpc/id/error) is built by the dispatcher or by to_jsonrpc_error above for non-dispatcher paths.

fn to_error_object(&self) -> JsonRpcErrorObject

Convert this error to a JSON-RPC error object.