Enum Error 

pub enum Error {
    Config(ConfigError),
    Gcs(GcsError),
    Auth(AuthError),
    Api {
        endpoint: String,
        status_code: u16,
        message: String,
    },
    Validation(String),
    Io(Error),
    Ffmpeg(String),
    Timeout(u64),
}

Unified error type for the common library.

This enum provides a single error type that can represent all error conditions across the MCP GenMedia servers, enabling consistent error handling and reporting.

Variants

Config(ConfigError)

Configuration errors (missing env vars, invalid values)

Gcs(GcsError)

GCS operation errors (upload, download, invalid URIs)

Auth(AuthError)

Authentication errors (ADC not configured, token refresh failures)

Api

API errors with endpoint and HTTP status context

Includes the API endpoint that failed, HTTP status code, and error message for debugging and user feedback.

Fields

endpoint: String

The API endpoint that was called

status_code: u16

HTTP status code returned by the API

message: String

Error message from the API or describing the failure

Validation(String)

Input validation errors

Io(Error)

File system I/O errors

Ffmpeg(String)

FFmpeg/FFprobe execution errors

Timeout(u64)

Operation timeout errors

Implementations

impl Error

pub fn api( endpoint: impl Into<String>, status_code: u16, message: impl Into<String>, ) -> Self

Create a new API error with endpoint, status code, and message.

Arguments

• endpoint - The API endpoint that was called
• status_code - The HTTP status code returned
• message - A description of the error

Example

use adk_rust_mcp_common::error::Error;

let err = Error::api(
    "https://api.example.com/v1/generate",
    500,
    "Internal server error"
);
assert!(err.to_string().contains("api.example.com"));
assert!(err.to_string().contains("500"));

pub fn validation(message: impl Into<String>) -> Self

Create a new validation error.

Example

use adk_rust_mcp_common::error::Error;

let err = Error::validation("prompt cannot be empty");
assert!(err.to_string().contains("prompt cannot be empty"));

pub fn ffmpeg(message: impl Into<String>) -> Self

Create a new FFmpeg error.

Example

use adk_rust_mcp_common::error::Error;

let err = Error::ffmpeg("Invalid input format");
assert!(err.to_string().contains("Invalid input format"));

pub fn timeout(seconds: u64) -> Self

Create a new timeout error.

Example

use adk_rust_mcp_common::error::Error;

let err = Error::timeout(300);
assert!(err.to_string().contains("300 seconds"));

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

fn from(source: AuthError) -> Self

Converts to this type from the input type.

impl From<ConfigError> for Error

fn from(source: ConfigError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<GcsError> for Error

fn from(source: GcsError) -> Self

Converts to this type from the input type.