package ocaml-ai-sdk

  1. Overview
  2. Docs
OCaml AI SDK - Provider abstraction for AI models

Install 

dune-project
 Dependency

github.com Readme Changelog Edit opam file Versions (9)

Authors

  1. A
    Ahrefs

Maintainers

  1. J
    José Nogueira <jose.nogueira@ahrefs.com>

Sources

ocaml-ai-sdk-0.6.3.tbz
sha256=0cc0a957784c295877b6bcc4f80c0dba0f6507d3c282e7d6cbd71038050376de
sha512=f8e082376b4de194a877d0df193892cdaa8139a4789f51eebac651acf8b6d4064b95242e158d86c1a32776d99130d43ed4c1119e2d54e738e93bdba2a6ad9a33

doc/ocaml-ai-sdk.ai_provider/Ai_provider/Provider_error/index.html

Module Ai_provider.Provider_errorSource

Errors from provider API calls.

Sourcetype timeout_phase =
  1. | Request_headers
    (*

    Not retryable: the server may already be processing the request.

    *)
  2. | Stream_idle
    (*

    Retryable: the connection has gone silent and is treated as dead.

    *)
Sourcetype error_kind =
  1. | Api_error of {
    1. status : int;
    2. body : string;
    }
  2. | Network_error of {
    1. message : string;
    }
  3. | Deserialization_error of {
    1. message : string;
    2. raw : string;
    }
  4. | Timeout of {
    1. phase : timeout_phase;
    2. elapsed_s : float;
    3. limit_s : float;
    }
Sourcetype t = {
  1. provider : string;
  2. kind : error_kind;
  3. is_retryable : bool;
  4. retry_after_s : float option;
}
Sourceexception Provider_error of t
Sourceval make_api_error : provider:string -> status:int -> body:string -> ?is_retryable:bool -> ?retry_after_s:float -> unit -> t

Construct an API error.

When is_retryable is omitted, defaults to the upstream status-code heuristic: 408, 409, 429, or any 5xx are retryable. Providers may override this when they can parse the error type from the response body.

Sourceval make_timeout : provider:string -> phase:timeout_phase -> elapsed_s:float -> limit_s:float -> t

Construct a timeout error. is_retryable is derived from phase: Request_headers is not retryable (server may already be processing the request; retry risks double-billing); Stream_idle is retryable (stream is dead, safe to start over).

Sourceval to_string : t -> string