v0.12.0

0.12.0 (2026-11-09)

Features

• error: expose the API's error code from error.details (#148) (b28f4a4)
• message: add file_ids/1 and document agent skills in requests (#137) (61dd7a5)
• skills: add Claudex.Skills for managing custom skills (#139) (7e81dcf)
• skills: add skill versions to Claudex.Skills (#140) (f0d6245)

Bug Fixes

• skills: document the pre-GA skills beta and pinning Anthropic versions (#143) (a69d5e7)
• skills: take a .zip path, treat a nil display name as absent, and document retried creates (#145) (480579d)
• tool_runner: pin skill versions across turns and expose the run's container (#142) (d91ccf0)
• tracing: name request spans for their route, not the concrete path (#144) (4f0c5e7)

v0.11.1

0.11.1 (2026-11-02)

Bug Fixes

• tool_runner: stop the calls a cancel lands before (#134) (de5c7a3)

v0.11.0

0.11.0 (2026-10-28)

⚠ BREAKING CHANGES

• client: requests now use API version 2026-10-21, which answers temperature, top_p or top_k, a document block directly in an assistant message, and a text block with citations in a user message with a 400. Claudex.Client.put_header(client, "anthropic-version", "2023-06-01") sends the previous version.
• tool_runner: a {:turn, turn} handler for stream_to/3 can now receive a turn with stop: :cancelled, and a finished turn can be followed by :cancelled instead of :done.
• tool_runner: ToolRunner.stream_to/3 used to ignore every:; it now batches events, so a reader that matches only {:event, event} must also handle {:events, events}, and an :every that is not a positive integer raises ArgumentError.
• tool_runner: add stream!/3 and deprecate stream/3 (#127)
• tool_runner: report a cancelled reply as cancelled (#125)
• messages: refuse string-keyed params and send struct system blocks (#118)
• tool: name a pattern parameter for the variable bound to it (#111)
• tool: refuse @tool on a function whose name the API rejects (#110)
• tool: refuse two @tool functions that would share a name (#108)
• tracing: report provider and token counts the way the GenAI conventions define them (#106)
• message: map the compaction stop reason and resume it in the tool runner (#104)
• telemetry: a streamed 4xx/5xx moves from :exception to :stop, and a plain request that got no response moves from :stop with status: nil to :exception.

Features

• client: add headers and betas to a copy of a client (#114) (a2672c4)
• models: decode a model's lifecycle, line and retirement dates (#119) (92c1b8f)
• schema: build a struct's JSON schema while it compiles with use Claudex.Schema (#95) (9d059eb)
• send :every batches on a timer and add ContentBlock.replayable?/1 (#88) (164eb30)
• streaming: batch stream_to/3 events over a window (#78) (417bdf7)
• tool_runner: add stream!/3 and deprecate stream/3 (#127) (116cbd3)
• tool_runner: batch stream_to/3 events with :every (#130) (a0421db)
• tool_runner: halt a run and resume it from its own history (#82) (26c1c22)
• tool_runner: send the turn a cancel ended from stream_to/3 (#131) (02d949b)
• tool: let a tool return content blocks (#122) (c861dc2)
• tool: set the API's tool-definition fields from @tool (#113) (5f112ef)
• tracing: run a conversation in a block (#81) (cc4c030)
• usage: answer whether prompt caching did anything (#83) (6dcd640)

Bug Fixes

• 0.11.0 review findings (#87) (708e442)
• batches: prepare each request's params the way Messages.create/2 does (#96) (03b5812)
• client: keep the API key out of the Req request a client holds (#120) (7daabff)
• client: retry failed requests the way the official SDKs do (#99) (f0935cd)
• client: send API version 2026-10-21 (#133) (1149852)
• deps: bump req from 0.7.4 to 0.7.5 (#97) (cad56f5)
• gen.tracing: leave the service name out at an umbrella root (#128) (21e9b90)
• message: leave a cut-off reply's unanswered tool calls out of the history (#91) (5154bfe)
• message: leave a cut-off stream's unsendable blocks out of the history (#86) (88974a8)
• message: map the compaction stop reason and resume it in the tool runner (#104) (d436c26)
• messages: refuse a non-streaming request that can outlast the default timeout (#98) (d055eb2)
• messages: refuse string-keyed params and send struct system blocks (#118) (d5eb71f)
• models: send the lifecycle filter as the list the API reads (#115) (5a6a478)
• page: walk back with before_id instead of sending both cursors (#107) (8906a0e)
• schema: recompile a module whose schema came from a struct that changed (#129) (c4fbd8a)
• streaming: keep the content a message_start event carries (bf08e91)
• streaming: keep the summary a compaction delta carries (#90) (0b21499)
• stream: keep iterations, context edits and raw fields from message_delta (#105) (132a372)
• stream: leave nothing in the caller's mailbox when a stream stops early (#102) (3b8698d)
• stream: stop a forwarded stream when its caller exits normally (#100) (0dd2955)
• stream: stop a request the moment the process it serves dies (#121) (1a11c4a)
• telemetry: report a failed request the same way on both transports (#103) (4a2ca30)
• telemetry: report a streamed request's tokens and say what Claudex logs (#116) (04c8662)
• tool_runner: answer a call whose streamed input doesn't parse instead of running it (...

v0.10.0

0.10.0 (2026-09-20)

Features

• mcp: support the MCP connector (#70) (fb46876)
• session ids on spans, and two content-block accessors (#72) (8b5b58b)
• tracing: emit OpenTelemetry spans (#65) (4c56a4b)

v0.9.1

0.9.1 (2026-09-15)

Bug Fixes

• tool_runner: describe a tool result JSON cannot carry (#66) (57fd487)

v0.9.0

0.9.0 (2026-09-13)

Features

• client: add build/1 and Model.supports?/2, read named spec args (#57) (d5717b8)
• message: answer how a reply ended, for a loop you drive yourself (#53) (09f7a6d)
• mix: add claudex.gen.tool (#61) (b0763b1)
• streaming: let a stream stop with the process it delivers to (#63) (722753c)
• tool_runner: add stream_to/3 (#62) (8ae7366)

Bug Fixes

• tool: report a tool call whoever is driving the loop (#56) (64c6e74)

v0.8.1

0.8.1 (2026-09-11)

Bug Fixes

• stream: keep a server tool's arguments when they stream in (#51) (53f68b0)

v0.8.0

0.8.0 (2026-09-11)

Features

• content_block: build the document and image blocks you send (#44) (c89f33b)
• content_block: decode the blocks server tools send back (#41) (f73af0f)
• messages: build output_config.format from a struct (#42) (38e69bd)
• page: walk every page, whichever cursor the endpoint uses (#45) (c62bb9c)
• tool_runner: stream each turn and report events to :on_event (#36) (dffb3ca)

Bug Fixes

• tool_runner: report a reply that ran out of room as truncated (#47) (f66dfc0)
• tool_runner: resume a turn the API paused (#40) (24d40c9)

v0.7.0

0.7.0 (2026-09-09)

Features

• stream: make usage merging, tool_uses and streamed text public (#33) (f50cd06)
• tool_runner: gate tool calls with a before_call hook (#32) (080ad6d)
• tool: describe tool arguments without giving up schema inference (#31) (a44e250)

Bug Fixes

• tool: return a uniform error struct from Tool.call/3 (#29) (79aa940)
• streaming: cancel a stream immediately instead of at the next event (#28) (eadf02b)
• telemetry: report the request span for streaming requests too (#27) (129b002)

v0.6.1

0.6.1 (2026-09-07)

Build System

• add Hex package metadata, ex_doc and an MIT licence (#20) (89a2712)