errors

type APICallError struct {
	// Message is the error message.
	Message string

	// URL is the request URL.
	URL string

	// RequestBodyValues contains the request body values for debugging.
	RequestBodyValues any

	// StatusCode is the HTTP status code (0 if not applicable).
	StatusCode int

	// ResponseHeaders are the response headers.
	ResponseHeaders map[string]string

	// ResponseBody is the raw response body.
	ResponseBody string

	// Data is the parsed error data from the provider.
	Data any

	// Cause is the underlying error.
	Cause error

	// IsRetryable indicates if the error is retryable.
	IsRetryable bool
}

type APICallErrorOptions struct {
	Message           string
	URL               string
	RequestBodyValues any
	StatusCode        int
	ResponseHeaders   map[string]string
	ResponseBody      string
	Data              any
	Cause             error
	IsRetryable       bool
	IsRetryableSet    bool // true if IsRetryable was explicitly set
}

type APIError struct {
	// Provider is the provider that returned the error.
	Provider string

	// StatusCode is the HTTP status code (0 if not applicable).
	StatusCode int

	// Code is the error code from the provider.
	Code string

	// Message is the error message.
	Message string

	// Param is the parameter that caused the error (if applicable).
	Param string

	// Type is the error type from the provider.
	Type string

	// RequestID is the request ID for debugging.
	RequestID string

	// Retryable indicates if the error is retryable.
	Retryable bool

	// RetryAfter is the number of seconds to wait before retrying (0 if not specified).
	RetryAfter int
}

type InvalidToolInputError struct {
	// ToolName is the name of the tool.
	ToolName string

	// ToolInput is the input that was invalid.
	ToolInput string

	// Cause is the underlying validation error.
	Cause error
}

type JSONParseError struct {
	// Text is the text that failed to parse.
	Text string

	// Cause is the underlying error.
	Cause error
}

type MissingToolResultsError struct {
	// ToolCallIDs are the IDs of the tool calls that are missing results.
	ToolCallIDs []string
}

type NoSuchToolError struct {
	// ToolName is the name of the tool the model tried to call.
	ToolName string

	// AvailableTools is the list of available tool names (nil if no tools available).
	AvailableTools []string
}

type RetryInfo struct {
	// ShouldRetry indicates if the error is retryable.
	ShouldRetry bool

	// RetryAfter is the suggested wait time in seconds.
	RetryAfter int

	// Attempt is the current attempt number.
	Attempt int

	// MaxAttempts is the maximum number of attempts.
	MaxAttempts int
}

type SchemaValidationError struct {
	// Schema is a description of the expected schema.
	Schema string

	// Value is the value that didn't match.
	Value any

	// Path is the JSON path to the invalid field.
	Path string

	// Message is the validation error message.
	Message string
}

type ToolCallRepairError struct {
	// Cause is the error from the repair function.
	Cause error

	// OriginalError is the original error that triggered repair.
	OriginalError error
}

type ToolError struct {
	// ToolCallID is the ID of the tool call.
	ToolCallID string

	// ToolName is the name of the tool.
	ToolName string

	// Message is the error message.
	Message string

	// Cause is the underlying error.
	Cause error
}