aigoerr

Documentation

Overview

Package aigoerr provides structured, classifiable errors for aigo engines. Agents can use IsRetryable and GetCode to make informed retry decisions.

Index

• func IsRetryable(err error) bool
• func IsTransientNative(err error) bool
• type Code
  • func GetCode(err error) (Code, bool)
• type Error
  • func FromHTTPResponse(resp *http.Response, body []byte, prefix string) *Error
  • func (e *Error) Error() string
  • func (e *Error) Unwrap() error

Functions

func IsRetryable

func IsRetryable(err error) bool

IsRetryable checks the error chain for a retryable *Error. When no structured *Error is found, it falls back to IsTransientNative to detect Go-native transient errors (timeouts, network failures).

func IsTransientNative

func IsTransientNative(err error) bool

IsTransientNative reports whether err is a Go-native transient error that is safe to retry (timeout, network failure, unexpected EOF). It does NOT check for *aigoerr.Error — use IsRetryable for that.

Types

type Code

type Code int

Code classifies an error for agent retry logic.

const (
	CodeUnknown        Code = iota
	CodeInvalidInput        // 400
	CodeAuthentication      // 401, 403
	CodeQuotaExceeded       // 402
	CodeRateLimit           // 429
	CodeServerError         // 5xx
	CodeTimeout             // context deadline / timeout
	CodeUnavailable         // engine unreachable
)

func GetCode

func GetCode(err error) (Code, bool)

GetCode extracts the error Code from the chain, if present.

type Error

type Error struct {
	Code       Code
	StatusCode int
	Message    string
	Retryable  bool
	RetryAfter time.Duration
	Err        error // wrapped original
}

Error is a structured error carrying classification metadata.

func FromHTTPResponse

func FromHTTPResponse(resp *http.Response, body []byte, prefix string) *Error

FromHTTPResponse creates a classified Error from an HTTP response. prefix is prepended to the message (e.g., "newapi", "openai").

func (*Error) Error

func (e *Error) Error() string

func (*Error) Unwrap

func (e *Error) Unwrap() error