Skip to content
1 min read · 207 words

@nhtio/adk/batteries/embeddings/ollama/exceptions

Battery-scoped exception constructors for Ollama Embeddings adapter failures.

Remarks

Battery-scoped exception classes for the Ollama Embeddings adapter. These exceptions are owned by the battery (not the ADK core) and are minted via createException from @nhtio/adk/factories. Re-exported from the battery's barrel.

The categories mirror the OpenAI Embeddings battery one-to-one so the two batteries fail with parallel semantics — only the engine-specific transport exception differs.

Variables

VariableDescription
E_INVALID_OLLAMA_EMBEDDINGS_OPTIONSThrown when the resolved adapter options fail validation against ollamaEmbeddingsOptionsSchema — e.g. a missing/empty model, or an unknown option key. Fatal: config bugs fail loud at construction time, not at embed time.
E_OLLAMA_EMBEDDINGS_HTTP_ERRORThrown when the upstream /api/embed endpoint returns a non-2xx response (after retries are exhausted), or the transport throws. Non-fatal. Printf args: [status, detail]status is 0 for a transport-level failure with no HTTP response.
E_OLLAMA_EMBEDDINGS_MALFORMED_RESPONSEThrown when a 2xx response body cannot be parsed into the expected { embeddings: number[][] } shape (malformed JSON, missing embeddings, wrong vector count). Non-fatal. Printf arg: [detail].
E_OLLAMA_EMBEDDINGS_REQUEST_TIMEOUTThrown when the request handshake does not complete before requestTimeoutMs (and retries are exhausted). Non-fatal. Printf arg: [requestTimeoutMs].