View Source CHANGELOG

0.5.0 - 2026-07-10

Complete rewrite into an official-SDK-style client. Breaking change across the entire public API — no compatibility shims.

Security

  • Anthropic.Client no longer prints api_key via inspect/1 (@derive {Inspect, except: [:api_key]}) — previously any crash report, Logger metadata, or IO.inspect/dbg of a client struct leaked the raw key.
  • Anthropic.Batches.results/2 now refuses to follow a results_url whose host doesn't match Client.base_url, so a tampered/malicious API response can't redirect the client's x-api-key to an attacker-controlled host.
  • Anthropic.HTTPTransport.Retry.delay_ms/2 now caps retry-after-ms at 60 seconds (matching the existing cap on the retry-after seconds header) — previously an unbounded header value could block a caller indefinitely via Process.sleep.
  • Anthropic.HTTPTransport.Multipart now strips CR/LF from a caller-supplied :content_type (as it already did for name/filename), preventing header injection via Anthropic.Files.create/3/create_from_binary/4.

Fixed

Changed

  • Collapsed Anthropic.HTTPTransport's duplicated send_request/send_raw request-attempt-and-retry loops into one (send_raw), removing a documented "keep both in sync" maintenance hazard.
  • mix.exs: added docs: [main: "readme", extras: [...]] config so HexDocs gets a proper landing page; package() now declares files:, maintainers:, and a changelog link. Added a top-level LICENSE file (Apache-2.0).

Added

  • :telemetry.span/3 around every Anthropic.HTTPTransport request attempt ([:anthropic, :http, :request, :start/:stop/:exception]), covering create/2, count_tokens/2, Models, Batches, and Files uniformly since they all funnel through the shared transport layer. Metadata includes method, url, attempt (retry count), and the resulting status.
  • Anthropic.Client struct (Client.new/1), replacing Anthropic.Config and the implicit pipeline configuration.
  • Typed content blocks: Anthropic.Messages.Content.{Text, ToolUse, ToolResult, Thinking, RedactedThinking, Image}.
  • Native tool use via the API's real tools/tool_use/tool_result protocol. Anthropic.Tools (JSON Schema input_schema/0) replaces Anthropic.Tools.ToolBehaviour. Anthropic.ToolRunner.run/4 drives the full agentic loop, replacing the hand-rolled XML-in-system-prompt hack.
  • Streaming: Anthropic.Messages.stream/2 returns a lazy Stream of typed Anthropic.Messages.StreamEvent structs; Anthropic.Messages.stream_to_message/1 folds a stream into a final Message.
  • Anthropic.Messages.count_tokens/2 (POST /v1/messages/count_tokens).
  • Anthropic.Error — a unified error struct/exception mirroring the API's error taxonomy, with retryable?/1.
  • Automatic retries with exponential backoff (capped at 8s) and jitter on 408/409/429/5xx, honoring retry-after-ms/retry-after and a server-sent x-should-retry override, shared by create/2, stream/2, and count_tokens/2.
  • Anthropic.Models and Anthropic.Batches resources, including Batches.delete/2 and cursor-based auto-pagination (Models.list_all/2, Batches.list_all/2 — lazy Streams that transparently walk pages via after_id/last_id, backed by the new Anthropic.Pagination helper).
  • Prompt caching: Anthropic.CacheControl.ephemeral/1 builds a cache_control map; attach it to a Text/Image/ToolUse/ToolResult content block's :cache_control field.
  • Extended thinking request config: Anthropic.Thinking.enabled/1, .adaptive/1, .disabled/0 build a :thinking param for Messages.create/2/stream/2.
  • Structured outputs: Anthropic.OutputConfig.json_schema/2 builds an :output_config param constraining the response to a given JSON Schema.
  • PDF/document content blocks: Anthropic.Messages.Content.Document — process_document/3 (local PDF), from_url/2, from_text/2, from_content/2.
  • Citations: typed response-side citation structs (Anthropic.Messages.Content.Citation.{CharLocation, PageLocation, ContentBlockLocation, SearchResultLocation, WebSearchResultLocation}), decoded from a Text block's :citations list instead of raw maps and re-encoded correctly if replayed into a later request. Request-side config is the existing citations: %{enabled: true} option on Document.
  • Server tools (web search, web fetch, code execution, bash, text editor, memory) — executed by Anthropic server-side, no client execute/1 needed: Anthropic.Tools.{WebSearch, WebFetch, CodeExecution, Bash, TextEditor, Memory} build each tool's versioned wire shape (version: defaults to latest, overridable). Results decode into Anthropic.Messages.Content.{ServerToolUse, WebSearchToolResult, WebFetchToolResult, CodeExecutionToolResult, BashCodeExecutionToolResult, TextEditorCodeExecutionToolResult} — ServerToolUse is distinct from ToolUse so Anthropic.ToolRunner never tries to dispatch a server-tool invocation to a client-side tool. Computer use and the MCP connector are beta-only and not yet supported.
  • Anthropic.Files resource (beta — automatically sends the required anthropic-beta: files-api-2025-04-14 header): create/3 (local path), create_from_binary/4, list/2, list_all/2, retrieve/2, download/2, delete/2. Backed by new multipart/form-data support in Anthropic.HTTPTransport (post_multipart/4, get_binary/3, Anthropic.HTTPTransport.Multipart encoder) and get/3/delete/3 overloads accepting per-request extra headers.
  • Added nimble_options and mime as dependencies — nimble_options validates CacheControl/Thinking/OutputConfig/server-tool option shapes with clear error messages; mime guesses a file's content-type from its extension in Files.create/3.

Removed

  • Anthropic pipeline API (new/1, add_user_message/2, request_next_message/1, process_invocations/1, etc).
  • Anthropic.Config, Anthropic.Messages.Request/Response (old pipeline versions), Anthropic.HTTPClient, Anthropic.Tools.ToolBehaviour, Anthropic.Tools.Utils (XML tool-calling).

0.4.3 - 2024-03-15

Fixed

  • Fixed inconsistency in storing messages in Anthropic.Request

0.4.2 - 2024-03-15

Fixed

  • Prevent to add system message when no Anthropic.Tools.ToolBehaviour is registered.

0.4.1 - 2024-03-15

Improved

  • Removed GenServer from Anthropic.Config. It will be created from Application.get_env or from the supplied options.
  • Added Mox to test environment.
  • Increased test coverage.

Breaking change

  • Changed the tool field type to MapSet

Improved

  • Better system function concatenation with tools description
  • Moved List.reverse from messages to Jason.Encoder implementation.

0.4.0 - 2024-03-13

Improved

  • Added tools handling. Now you can register tools that the AI can call, and these calls are automaticaly captured.

Fixed

  • The way Messages.content was being generated

Minor

  • Moved Response parsing to Request module.

Breaking change

  • Replaced Anthropic.add_image/2 with Anthropic.add_user_image/2

0.3.0 - 2024-03-12

Improved

  • Included telemetry
  • Added threatment of nil api_key

0.2.1 - 2024-03-11

Fixed

  • Removed guard that would not allow assistant message to be added to request
  • Process response with Jason.decode.

Improved

  • Added type annotations to documentatio

0.2.0 - 2024-03-11

Improved

  • Added support for image content