litellm.errors — tech.unravel/litellm-clj 0.3.0-alpha

Comprehensive error handling for LiteLLM-clj

This namespace provides:

• Namespaced error types for clear categorization
• Rich error data structures with context
• Error predicates for pattern matching
• Retry and recoverability analysis

all-error-types clj

authentication-error clj

(authentication-error provider
                      message
                      &
                      {:keys [http-status provider-code] :as opts})

API key invalid or missing

authentication-error? clj

(authentication-error? ex)

authorization-error clj

(authorization-error provider
                     message
                     &
                     {:keys [http-status provider-code resource] :as opts})

API key valid but lacks permissions

chunk->exception clj

(chunk->exception chunk)

Convert an error chunk to an exception

client-error? clj

(client-error? ex)

Check if error is a client/configuration error

client-errors clj

connection-error clj

(connection-error provider message & {:keys [cause request-id] :as opts})

Network connectivity issues

content-filter clj

(content-filter provider message & {:keys [provider-code filter-type] :as opts})

Content filtered by provider safety systems

error-chunk? clj

(error-chunk? chunk)

Check if a streaming chunk is an error chunk

error-details clj

(error-details ex)

Get detailed error information as a map

error-summary clj

(error-summary ex)

Create a human-readable error summary

error-type? clj

(error-type? ex error-type)

Check if exception matches a specific error type

get-error-category clj

(get-error-category ex)

Get human-readable error category

http-status->error clj

(http-status->error status
                    provider
                    message
                    &
                    {:keys [provider-code retry-after request-id body]
                     :as opts})

Map HTTP status code to appropriate error constructor

internal-error clj

(internal-error message & {:keys [cause stack-trace] :as opts})

Unexpected litellm bug

invalid-config clj

(invalid-config message & {:keys [config errors] :as opts})

Configuration validation failed

invalid-request clj

(invalid-request message & {:keys [request errors] :as opts})

Request validation failed - missing required fields or invalid types

invalid-response clj

(invalid-response provider
                  message
                  &
                  {:keys [response validation-errors] :as opts})

Response doesn't match expected schema

litellm-error? clj

(litellm-error? ex)

Check if exception is a litellm error

model-not-found clj

(model-not-found provider
                 model
                 &
                 {:keys [http-status provider-code available-models] :as opts})

Model doesn't exist for provider

model-not-found-error? clj

(model-not-found-error? ex)

provider-error clj

(provider-error provider
                message
                &
                {:keys [http-status provider-code request-id recoverable?]
                 :as opts})

Generic provider-side error

provider-error? clj

(provider-error? ex)

Check if error is a provider/network error

provider-errors clj

provider-not-found clj

(provider-not-found provider & {:keys [available-providers] :as opts})

Requested provider doesn't exist

quota-exceeded clj

(quota-exceeded provider
                message
                &
                {:keys [http-status provider-code quota-type reset-at]
                 :as opts})

Account quota exhausted

rate-limit clj

(rate-limit provider
            message
            &
            {:keys [http-status provider-code retry-after request-id] :as opts})

Rate limit hit - usually recoverable with backoff

rate-limit-error? clj

(rate-limit-error? ex)

recoverable? clj

(recoverable? ex)

Check if error is recoverable (retry might succeed)

resource-exhausted clj

(resource-exhausted message
                    &
                    {:keys [resource-type current-usage limit] :as opts})

Thread pool or channel buffer full

response-error? clj

(response-error? ex)

Check if error is a response error

response-errors clj

retry-delay clj

(retry-delay ex retry-count)

Calculate retry delay in milliseconds based on error type and retry count

server-error clj

(server-error provider
              message
              &
              {:keys [http-status provider-code request-id] :as opts})

Provider's server error (500, 502, 503)

should-retry? clj

(should-retry? ex
               &
               {:keys [max-retries current-retry]
                :or {max-retries 3 current-retry 0}})

Determine if error should be retried based on type and recoverability

streaming-error clj

(streaming-error provider
                 message
                 &
                 {:keys [recoverable? chunk-number cause] :as opts})

Error during streaming operation

streaming-error-chunk clj

(streaming-error-chunk
  provider
  message
  &
  {:keys [error-type http-status provider-code recoverable? chunk-number cause]
   :or {error-type :litellm/streaming-error recoverable? false}})

Create an error chunk for placing on streaming channels

streaming-error? clj

(streaming-error? ex)

system-error? clj

(system-error? ex)

Check if error is a system error

system-errors clj

timeout-error clj

(timeout-error provider message & {:keys [timeout-ms request-id] :as opts})

Request timeout

timeout-error? clj

(timeout-error? ex)

unsupported-feature clj

(unsupported-feature provider feature & {:keys [message] :as opts})

Feature not supported by provider

wrap-http-errors clj

(wrap-http-errors provider-name f)

Wrap HTTP calls to convert hato exceptions to litellm errors. Preserves HTTP response details when available.