Package org.mockserver.llm

Class LlmErrorBodies

java.lang.Object

org.mockserver.llm.LlmErrorBodies

public final class LlmErrorBodies
extends Object

Pure, deterministic helper that produces the provider-specific JSON error body real LLM providers return for overload / rate-limit / server errors. Client SDKs (the OpenAI Python SDK, Anthropic SDK, Google GenAI SDK, …) parse the error.type / error.code fields in these bodies to drive their retry/backoff logic, so emitting the correct shape lets MockServer exercise that logic faithfully against a mock.

Used by HttpLlmResponseActionHandler when injecting a chaos error (probabilistic error or a stateful quota breach) on the LLM response path. When the provider is null or unknown, callers fall back to the generic {"error":{"type":..,"message":..}} body.

Error kinds

The mapping is keyed by a coarse LlmErrorBodies.Kind derived from the HTTP status and the caller's intent:

• LlmErrorBodies.Kind.OVERLOADED — the provider is temporarily overloaded (Anthropic 529 overloaded_error; OpenAI 503 server_error; …).
• LlmErrorBodies.Kind.RATE_LIMIT — a quota / rate limit was exceeded (429; OpenAI rate_limit_exceeded, Anthropic rate_limit_error, …).
• LlmErrorBodies.Kind.SERVER_ERROR — a generic upstream 5xx (OpenAI server_error, Anthropic api_error, …).

Provider body reference

• ANTHROPIC / BEDROCK (Anthropic Messages API errors) — {"type":"error","error":{"type":"overloaded_error"|"rate_limit_error"|"api_error","message":..}}. Bedrock delivers the Anthropic body unchanged.
• OPENAI / OPENAI_RESPONSES / AZURE_OPENAI (OpenAI error envelope) — {"error":{"message":..,"type":"server_error"|"rate_limit_exceeded","code":..,"param":null}}.
• GEMINI (Google API error envelope) — {"error":{"code":..,"message":..,"status":"UNAVAILABLE"|"RESOURCE_EXHAUSTED"|"INTERNAL"}}.
• OLLAMA — {"error":".."} (a plain message string).

All output is a JSON string; the helper is static, deterministic, and performs no I/O. Messages are short, fixed, benign test fixtures.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	LlmErrorBodies.Kind

Method Summary

Modifier and Type	Method	Description
static String	bodyFor(Provider provider, LlmErrorBodies.Kind kind, int status, String message)	Produce the provider-specific JSON error body for the given provider and kind, or null when the provider is null or has no specific shape (the caller then uses the generic fallback body).
static LlmErrorBodies.Kind	kindForStatus(Integer status)	Derive the LlmErrorBodies.Kind from an HTTP status code. 429 → LlmErrorBodies.Kind.RATE_LIMIT; 529 → LlmErrorBodies.Kind.OVERLOADED; any other 5xx → LlmErrorBodies.Kind.SERVER_ERROR; any 4xx (other than 429) → LlmErrorBodies.Kind.SERVER_ERROR (treated as a generic provider error envelope).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

kindForStatus

public static LlmErrorBodies.Kind kindForStatus(Integer status)

Derive the LlmErrorBodies.Kind from an HTTP status code. 429 → LlmErrorBodies.Kind.RATE_LIMIT; 529 → LlmErrorBodies.Kind.OVERLOADED; any other 5xx → LlmErrorBodies.Kind.SERVER_ERROR; any 4xx (other than 429) → LlmErrorBodies.Kind.SERVER_ERROR (treated as a generic provider error envelope). A null status defaults to LlmErrorBodies.Kind.SERVER_ERROR.

bodyFor

public static String bodyFor(Provider provider,
 LlmErrorBodies.Kind kind,
 int status,
 String message)

Produce the provider-specific JSON error body for the given provider and kind, or null when the provider is null or has no specific shape (the caller then uses the generic fallback body). The message is escaped for embedding in a JSON string. status feeds the numeric code field for providers (OpenAI Gemini) that echo the HTTP status in the body.

Parameters:

provider - the LLM provider (may be null)

kind - the coarse error kind

status - the HTTP status being returned (used for body code fields)

message - a human-readable error message

Returns:

the JSON error body string, or null for an unknown/null provider