Documentation
¶
Overview ¶
Package clienterror classifies upstream failures caused by the client request.
Index ¶
- Constants
- func HTTPStatusFromError(err error) int
- func HTTPStatusFromErrorOr(err error, fallback int) int
- func IsClaudeThreadNotFound(status int, err error) bool
- func IsClientCancellation(status int, err error) bool
- func IsCreditBalanceTooLow(status int, err error) bool
- func IsDevinRequestPermissionDenied(status int, err error) bool
- func IsItemNotPersisted(message string) bool
- func IsRequestFault(status int, err error) bool
Constants ¶
const StatusClientClosedRequest = 499
StatusClientClosedRequest is the nginx-style status used when the client aborts the request before the proxy finishes (context.Canceled).
Variables ¶
This section is empty.
Functions ¶
func HTTPStatusFromError ¶
HTTPStatusFromError extracts an HTTP status from err. Explicit StatusCode() values win. Otherwise context.Canceled maps to 499 and context.DeadlineExceeded maps to 504. Returns 0 when unknown.
func HTTPStatusFromErrorOr ¶
HTTPStatusFromErrorOr is like HTTPStatusFromError but returns fallback when the error does not carry a known status.
func IsClaudeThreadNotFound ¶ added in v8.0.14
IsClaudeThreadNotFound reports the Claude 404 response for a stale previous_message_id continuation from either a structured JSON response or a plain-text error message.
func IsClientCancellation ¶
IsClientCancellation reports whether an HTTP status code or error represents a client-initiated cancellation (HTTP 499 StatusClientClosedRequest or context.Canceled).
func IsCreditBalanceTooLow ¶ added in v8.0.50
IsCreditBalanceTooLow reports the Anthropic 400 response returned when a credential's API credit balance is exhausted.
func IsDevinRequestPermissionDenied ¶ added in v8.0.53
IsDevinRequestPermissionDenied reports whether a 403 error from Devin is deterministically caused by the request payload (such as the MCP tool configuration filter or the prompt content policy filter) rather than credential permissions.
func IsItemNotPersisted ¶
IsItemNotPersisted matches the upstream 404 raised when a request references a response item the upstream never stored because `store` was false. The upstream sends this as a plain-text message rather than a JSON body, so it cannot be recognized through the structured identifiers above.
The request can only succeed once the client rebuilds it without the stale reference, so it is a request fault: rotating credentials cannot help, and the client must be told rather than left to retry the same broken input.
func IsRequestFault ¶
IsRequestFault reports whether an upstream failure is caused by the request and therefore must not rotate or penalize credentials.
Types ¶
This section is empty.