@spec available?() :: boolean()

Checks if the Anthropic API key is configured.

@spec available?(map()) :: boolean()

Checks availability using the TOML-resolved auth config.

When a provider alias reuses this module with a different api_key_env, this callback checks the correct env var instead of the hardcoded ANTHROPIC_API_KEY default.

@spec capabilities() :: LlmCore.LLM.Provider.capabilities()

Returns Anthropic's capability map including streaming, structured output, tool use, and supported models.

@spec provider_type() :: :api

Returns :api — Anthropic is a cloud API provider.

@spec send(
  LlmCore.LLM.Provider.prompt(),
  keyword()
) :: {:ok, LlmCore.LLM.Response.t()} | {:error, LlmCore.LLM.Error.t()}

Sends a prompt to the Anthropic Messages API and returns the response.

When opts[:tools] contains a list of LlmToolkit.Tool structs, tool definitions are encoded into the request body. If the model responds with stop_reason: "tool_use", the returned Response.tool_calls will contain decoded LlmToolkit.Tool.Call structs.

@spec stream(
  LlmCore.LLM.Provider.prompt(),
  keyword()
) :: {:ok, Enumerable.t()} | {:error, LlmCore.LLM.Error.t()}

Streams a response from the Anthropic Messages API using Server-Sent Events.