errors.go

package goai

import (
	"errors"
	"fmt"
)

// Error represents an error from an LLM provider
type Error struct {
	Provider   string // Provider name
	StatusCode int    // HTTP status code (if applicable)
	Message    string // Error message
	Err        error  // Underlying error
}

// Error implements the error interface
func (e *Error) Error() string {
	if e.StatusCode > 0 {
		return fmt.Sprintf("%s error (status %d): %s", e.Provider, e.StatusCode, e.Message)
	}
	return fmt.Sprintf("%s error: %s", e.Provider, e.Message)
}

// Unwrap returns the underlying error
func (e *Error) Unwrap() error {
	return e.Err
}

// Sentinel errors
var (
	// ErrNoAPIKey is returned when an API key is required but not provided
	ErrNoAPIKey = errors.New("API key required")
	
	// ErrNoResponse is returned when the provider returns no response
	ErrNoResponse = errors.New("no response from provider")
	
	// ErrProviderNotFound is returned when a provider is not registered
	ErrProviderNotFound = errors.New("provider not found")
	
	// ErrInvalidModel is returned when a model identifier is invalid
	ErrInvalidModel = errors.New("invalid model identifier")
)