LlmCall.Dialect.Anthropic.Messages (llm_call v0.1.0)

Copy Markdown View Source

Anthropic Messages (POST /v1/messages).

system is a top-level field, max_tokens is required, tool results are tool_result blocks inside a user turn, and reasoning is controlled by an explicit thinking budget rather than an effort level.

A server tool is {"type": "web_search_20250305", "name": "web_search"}. The codec takes ToolSpec.name as the versioned type and derives the callable name from its date suffix; provider_options.anthropic["name"] overrides it.

thinking.budget_tokens must be at least 1024 and less than max_tokens, and usage.input_tokens counts only the tokens after the last cache breakpoint, so Usage.total_tokens adds the cache read and write counters.

stop_reason values outside the canonical union decode as :unknown: pause_turn (a server-tool loop paused; send the response back to continue) and model_context_window_exceeded. refusal decodes as :content_filter, because it is a classifier stop. The wire value stays in Response.raw.

The anthropic-version header is pinned to the API version this codec targets, and a codec header wins over a client one, so it is not overridable per call.

call_id on a tool result is the Anthropic tool_use_id.

Summary

Functions

Validates the request and encodes it as a POST to the codec's @path.

Functions

encode_request(request, config)

@spec encode_request(LlmCall.Request.t(), LlmCall.Config.t()) ::
  {:ok, LlmCall.EncodedRequest.t()} | {:error, LlmCall.Error.t()}

Validates the request and encodes it as a POST to the codec's @path.