Enum AptuError 

pub enum AptuError {
    GitHub {
        message: String,
    },
    AI {
        message: String,
        status: Option<u16>,
        provider: String,
    },
    NotAuthenticated,
    AiProviderNotAuthenticated {
        provider: String,
        env_var: String,
    },
    RateLimited {
        provider: String,
        retry_after: u64,
    },
    TruncatedResponse {
        provider: String,
    },
    Config {
        message: String,
    },
    InvalidAIResponse(Error),
    Network(Error),
    CircuitOpen,
    TypeMismatch {
        number: u64,
        expected: ResourceType,
        actual: ResourceType,
    },
    ModelRegistry {
        message: String,
    },
    ModelValidation {
        model_id: String,
        suggestions: String,
    },
    SecurityScan {
        message: String,
    },
    InputExceedsLimit {
        field: String,
        actual_bytes: usize,
        limit_bytes: usize,
    },
}

Errors that can occur during Aptu operations.

Variants

GitHub

GitHub API error from octocrab.

Fields

message: String

Error message.

AI

AI provider error (OpenRouter, Ollama, etc.).

Fields

message: String

Error message from the AI provider.

status: Option<u16>

Optional HTTP status code from the provider.

provider: String

Name of the AI provider (e.g., OpenRouter, Ollama).

NotAuthenticated

User is not authenticated - needs to run aptu auth login.

AiProviderNotAuthenticated

AI provider is not authenticated - missing API key.

Fields

provider: String

Name of the AI provider (e.g., OpenRouter, Ollama).

env_var: String

Environment variable name to set (e.g., OPENROUTER_API_KEY).

RateLimited

Rate limit exceeded from an AI provider.

Fields

provider: String

Name of the provider that rate limited (e.g., OpenRouter).

retry_after: u64

Number of seconds to wait before retrying.

TruncatedResponse

AI response was truncated (incomplete JSON due to EOF).

Fields

provider: String

Name of the AI provider that returned truncated response.

Config

Configuration file error.

Fields

message: String

Error message.

InvalidAIResponse(Error)

Invalid JSON response from AI provider.

Network(Error)

Network/HTTP error from reqwest.

CircuitOpen

Circuit breaker is open - AI provider is unavailable.

TypeMismatch

Type mismatch: reference is a different type than expected.

Fields

number: u64

The issue/PR number.

expected: ResourceType

Expected type.

actual: ResourceType

Actual type.

ModelRegistry

Model registry error (runtime model validation).

Fields

message: String

Error message.

ModelValidation

Model validation error - invalid model ID with suggestions.

Fields

model_id: String

The invalid model ID provided by the user.

suggestions: String

Suggested valid model IDs based on fuzzy matching.

SecurityScan

Security scan error.

Fields

message: String

Error message.

InputExceedsLimit

A user-supplied input field exceeds its configured byte limit.

Fields

field: String

Name of the field that exceeded the limit.

actual_bytes: usize

Actual byte count of the input.

limit_bytes: usize

Configured byte limit.

Trait Implementations

impl Debug for AptuError

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

Formats the value using the given formatter.

impl Display for AptuError

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

Formats the value using the given formatter.

impl Error for AptuError

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<ConfigError> for AptuError

fn from(err: ConfigError) -> Self

Converts to this type from the input type.

impl From<Error> for AptuError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for AptuError

fn from(err: Error) -> Self

Converts to this type from the input type.