Documentation
¶
Overview ¶
Package failure owns normalized inference failure semantics.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Failure ¶
type Failure struct {
// contains filtered or unexported fields
}
Failure separates a client-safe message from provider and cause details.
func New ¶
func New(kind Kind, safeMessage string, retryable bool, provider ProviderDetails, cause error) *Failure
New constructs one normalized failure.
func (*Failure) ProviderDetails ¶
func (f *Failure) ProviderDetails() ProviderDetails
ProviderDetails returns a copy of the provider-only evidence.
func (*Failure) SafeMessage ¶
SafeMessage returns text that a protocol adapter can expose.
type Kind ¶
type Kind string
Kind identifies a stable failure class.
const ( // Validation identifies invalid client input. Validation Kind = "validation" // Authentication identifies invalid credentials. Authentication Kind = "authentication" // Permission identifies an unauthorized action. Permission Kind = "permission" // RateLimit identifies provider or gateway throttling. RateLimit Kind = "rate_limit" // NotFound identifies an absent model or provider resource. NotFound Kind = "not_found" // ContextLimit identifies input that exceeds a model context window. ContextLimit Kind = "context_limit" // ContentBlocked identifies a provider content-policy rejection. ContentBlocked Kind = "content_blocked" ProviderUnavailable Kind = "provider_unavailable" // Timeout identifies an elapsed request deadline. Timeout Kind = "timeout" // Canceled identifies caller cancellation. Canceled Kind = "canceled" // Internal identifies a gateway implementation failure. Internal Kind = "internal" )
Click to show internal directories.
Click to hide internal directories.