Error reference

Every somm error carries a canonical SOMM_* code with a fixed problem / cause / fix / related shape. The pages below mirror that format — copy-paste the fix into your shell or code and the error should resolve.

• SOMM_WORKLOAD_UNREGISTERED — strict mode refused an unregistered workload
• SOMM_PORT_BUSY — somm serve port conflict
• SOMM_PROVIDERS_EXHAUSTED — every provider is cooled for longer than the retry cap
• SOMM_SCHEMA_STALE — DB schema older than the library expects
• SOMM_PRIVACY_VIOLATION — attempted to egress a privacy_class=PRIVATE workload
• SOMM_NO_CAPABLE_PROVIDER — no provider in the chain can serve a required capability
• SOMM_PROVIDER_TIMEOUT — a provider call didn't return before the timeout
• SOMM_PROVIDER_RATE_LIMIT — a provider returned HTTP 429
• SOMM_PROVIDER_5XX — a provider returned a server-side error
• SOMM_EMPTY_RESPONSE — a model returned no usable content
• SOMM_PROVIDER_INSUFFICIENT_CREDIT — a provider's account balance/quota is exhausted
• SOMM_PROVIDER_AUTH — a provider rejected the call as unauthenticated/unauthorized
• SOMM_PROVIDER_BAD_REQUEST — a provider rejected the call as malformed
• SOMM_BUDGET_EXCEEDED — the fail-closed daily budget gate refused the call before dispatch
• SOMM_ERROR — base code for the somm exception hierarchy

Links open the canonical markdown on GitHub for rich rendering. The raw files live in docs/errors/.