SuperPi.AI.Providers (super_pi v0.1.0)

Provider registry. Selects the SuperPi.AI.Provider that serves a model.

Resolution order:

In mock mode (config :super_pi, mock_llm: true) only SuperPi.AI.Providers.Mock is active. Mock mode is for tests and demos. It never turns on by itself.
Otherwise the first provider in config :super_pi, :providers whose handles?/1 returns true serves the model. The default list is Gemini, Anthropic and OpenAI. A provider with no key is listed in the catalog as not available.
If that provider is not configured, or no provider handles the model, the result is an error. There is no silent fallback.

Summary

error()

active()

Providers that can serve requests now.

catalog()

Model catalog of all registered providers, with the provider id and availability.

Human-readable message for a resolution error.

registered()

Providers registered in the application environment.

resolve(model)

Returns the provider for model and the model name to send to it.

@type error() ::
  {:no_provider, String.t()} | {:not_configured, provider_id :: String.t()}

@spec active() :: [module()]

Providers that can serve requests now.

@spec catalog() :: [map()]

Model catalog of all registered providers, with the provider id and availability.

@spec format_error(error()) :: String.t()

Human-readable message for a resolution error.

@spec registered() :: [module()]

Providers registered in the application environment.

@spec resolve(String.t()) :: {:ok, module(), String.t()} | {:error, error()}

Returns the provider for model and the model name to send to it.