anthropic 1.1.1 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13b85406d88291ad8b4617f040286edefe795c4b0400312d0a630dfe30a70bf6
-  data.tar.gz: 3467c4167d8db97ecc9bd2dbf049f6795ac7d6474ad8e3b1c1d0414aee1d297e
+  metadata.gz: 9508f2174591353cfaa66f66d1ec7d72fbd3dced9f88e64aae101ad0b370ec51
+  data.tar.gz: 4e10f3b7dcdfe9e1fc2bf5efec9bb8578d63f2d49a0ed36b08db2153109a0ada
 SHA512:
-  metadata.gz: d5ea1bd30663111c0cf3d5681469b9186621bf2eb8009f38e3aea031092f5b4a1bf091b484c8bb40b8214977ff29efc19ef03b25ed7479cd69e6c9d528a5f06a
-  data.tar.gz: d7afee44eb07c19934d5691b7b2d7e55fbdbcd88b82dc3ae65d71cc4e00ab6093836da1c4158e68f8d0fd48a9520993350abb4c29957785edcd68862cafaa3f8
+  metadata.gz: b5eeb2c0701c8ab45b86c58f28c4fd49344ae4b9ac1539486ba282ce3b9154cd3b7e8466fb933b61206f18ef2024f50de8366d5aa89336e86307e2ab22a8f1c2
+  data.tar.gz: c6f369c9cd95b5501e4416dd8c46ba936f2b09134ccb1a7fec65e7a7948b0e734db46bc3836dee43deac948c4fd216162a5395301c71b837e6277cdbabbbc7a9

data/CHANGELOG.md

@@ -1,5 +1,175 @@
 # Changelog
 
+## 1.9.0 (2025-09-10)
+
+Full Changelog: [v1.8.0...v1.9.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.8.0...v1.9.0)
+
+### Features
+
+* **api:** adds support for Documents in tool results ([91e23c1](https://github.com/anthropics/anthropic-sdk-ruby/commit/91e23c14525ba91fa63eab1ab901c7d8782aa6b3))
+* **api:** adds support for web_fetch_20250910 tool ([631783d](https://github.com/anthropics/anthropic-sdk-ruby/commit/631783ddbbcc0aab95172b3dd4d6cbd29e0ec507))
+
+
+### Bug Fixes
+
+* unnecessarily long multipart boundary length ([#124](https://github.com/anthropics/anthropic-sdk-ruby/issues/124))  ([69aa4c8](https://github.com/anthropics/anthropic-sdk-ruby/commit/69aa4c8c918b3d401933efaba6440164c6eb6962))
+
+## 1.8.0 (2025-09-02)
+
+Full Changelog: [v1.7.0...v1.8.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.7.0...v1.8.0)
+
+### Features
+
+* **client:** adds support for code-execution-2025-08-26 tool ([28e554e](https://github.com/anthropics/anthropic-sdk-ruby/commit/28e554ec75e8c34d20ef1e021672f9a02d5be3ec))
+* input schemas ([#660](https://github.com/anthropics/anthropic-sdk-ruby/issues/660)) ([3e062c0](https://github.com/anthropics/anthropic-sdk-ruby/commit/3e062c03b0fc964877095a34cb69de9ba63dfa19))
+
+
+### Bug Fixes
+
+* bump sorbet version and fix new type errors from the breaking change ([3c4f15d](https://github.com/anthropics/anthropic-sdk-ruby/commit/3c4f15d8f4115d6da6d8589856e7654162f91110))
+* correctly raise errors encountered during streaming ([be9bc45](https://github.com/anthropics/anthropic-sdk-ruby/commit/be9bc45d96ac227fd5648281199a7c8dd234897d))
+
+
+### Chores
+
+* add json schema comment for rubocop.yml ([3fce402](https://github.com/anthropics/anthropic-sdk-ruby/commit/3fce4021da72749b127adacee9436327d4b03f60))
+
+## 1.7.0 (2025-08-13)
+
+Full Changelog: [v1.6.0...v1.7.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.6.0...v1.7.0)
+
+### Features
+
+* **api:** makes 1 hour TTL Cache Control generally available ([c2dbf3b](https://github.com/anthropics/anthropic-sdk-ruby/commit/c2dbf3bcc3137b53db4d0a5779a014d4c59609bc))
+
+
+### Chores
+
+* deprecate older claude-3-5 sonnet models ([#679](https://github.com/anthropics/anthropic-sdk-ruby/issues/679)) ([4a3fb20](https://github.com/anthropics/anthropic-sdk-ruby/commit/4a3fb2042b20ca34346e2fa914c77713e664b922))
+
+## 1.6.0 (2025-08-12)
+
+Full Changelog: [v1.5.0...v1.6.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.5.0...v1.6.0)
+
+### Features
+
+* **betas:** add context-1m-2025-08-07 ([5bb5064](https://github.com/anthropics/anthropic-sdk-ruby/commit/5bb506416852bcd0c893c643831ec6e52a2cc79d))
+
+
+### Chores
+
+* collect metadata from type DSL ([69114b1](https://github.com/anthropics/anthropic-sdk-ruby/commit/69114b159e3710c467cbb7c55b8b7526cb5ea8e7))
+* **internal:** update comment in script ([c5bd3b1](https://github.com/anthropics/anthropic-sdk-ruby/commit/c5bd3b144ad399c114e644437820a8785e7399f0))
+* **internal:** update test skipping reason ([6d7c586](https://github.com/anthropics/anthropic-sdk-ruby/commit/6d7c58606a88e6a34b16f19006e44dbf17d657c0))
+* update @stainless-api/prism-cli to v5.15.0 ([356427c](https://github.com/anthropics/anthropic-sdk-ruby/commit/356427c4ec83d134dbcccdf27915eee65e5e8daa))
+
+## 1.5.0 (2025-08-08)
+
+Full Changelog: [v1.4.1...v1.5.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.4.1...v1.5.0)
+
+### Features
+
+* **api:** search result content blocks ([9a94866](https://github.com/anthropics/anthropic-sdk-ruby/commit/9a9486664e10ce0d02967ab1d5360357ffb72a66))
+
+
+### Bug Fixes
+
+* aws bedrock base url ([#673](https://github.com/anthropics/anthropic-sdk-ruby/issues/673)) ([b2996b9](https://github.com/anthropics/anthropic-sdk-ruby/commit/b2996b9349b047c53232ecd63823110ad90c71c3))
+
+## 1.4.1 (2025-08-07)
+
+Full Changelog: [v1.4.0...v1.4.1](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.4.0...v1.4.1)
+
+### Bug Fixes
+
+* aws bedrock should sign each request follow retries ([#672](https://github.com/anthropics/anthropic-sdk-ruby/issues/672)) ([df9f4e1](https://github.com/anthropics/anthropic-sdk-ruby/commit/df9f4e1aa7e7211dab3d36dd9093092d20649359))
+
+## 1.4.0 (2025-08-05)
+
+Full Changelog: [v1.3.0...v1.4.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.3.0...v1.4.0)
+
+### Features
+
+* **api:** add claude-opus-4-1-20250805 ([2477a05](https://github.com/anthropics/anthropic-sdk-ruby/commit/2477a05b8b26b047df178264db7d0764ca954954))
+* **api:** adds support for text_editor_20250728 tool ([dff36db](https://github.com/anthropics/anthropic-sdk-ruby/commit/dff36db0eb8b7077ba311f3815eb0065422c2fd4))
+* update streaming error message to say 'required' not 'recommended' ([6272ddd](https://github.com/anthropics/anthropic-sdk-ruby/commit/6272ddd9cd3ae0110afee98159516c3232c65832))
+
+
+### Chores
+
+* **ci:** setup Ruby on release job ([#111](https://github.com/anthropics/anthropic-sdk-ruby/issues/111)) ([bb5d08f](https://github.com/anthropics/anthropic-sdk-ruby/commit/bb5d08f052b3e65f70d345c45ce59e3e8fe282f3))
+* **client:** add TextEditor_20250429 tool ([3b344dc](https://github.com/anthropics/anthropic-sdk-ruby/commit/3b344dcf2dc759a0a01a1061573115c7a6c8a449))
+* **internal:** increase visibility of internal helper method ([72fb96c](https://github.com/anthropics/anthropic-sdk-ruby/commit/72fb96cdcdb2a6436aaf6d908f010ae16c08bd33))
+
+## 1.3.0 (2025-07-28)
+
+Full Changelog: [v1.2.0...v1.3.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.2.0...v1.3.0)
+
+### Features
+
+* **api:** removed older deprecated models ([47de6c2](https://github.com/anthropics/anthropic-sdk-ruby/commit/47de6c2860fabd344374aed733df1bcb17988454))
+* **client:** add beta stream implementation and fine grained tool streaming example ([2856b81](https://github.com/anthropics/anthropic-sdk-ruby/commit/2856b8119b99e6487093df3f49216ecc8d1bd3e3))
+* **client:** add beta stream implementation and fine grained tool streaming example ([bc87fd4](https://github.com/anthropics/anthropic-sdk-ruby/commit/bc87fd4afd94a48301fec548a0e7b21f44a24a59))
+
+
+### Bug Fixes
+
+* **internal:** ensure sorbet test always runs serially ([0b39a19](https://github.com/anthropics/anthropic-sdk-ruby/commit/0b39a1908587597ca5836872333541307f24bdf2))
+* **internal:** ensure vertex client test ordering ([#667](https://github.com/anthropics/anthropic-sdk-ruby/issues/667)) ([d7439fa](https://github.com/anthropics/anthropic-sdk-ruby/commit/d7439fa58664d9a533cacca6a299b3dbbe43ec7f))
+
+
+### Chores
+
+* add basic tool use example ([#107](https://github.com/anthropics/anthropic-sdk-ruby/issues/107)) ([4452119](https://github.com/anthropics/anthropic-sdk-ruby/commit/445211929b09ff0be9406aad1b3f3604d8bf3794))
+* add Darwin to PLATFORMS in Gemfile.lock ([#104](https://github.com/anthropics/anthropic-sdk-ruby/issues/104)) ([aa5bcbe](https://github.com/anthropics/anthropic-sdk-ruby/commit/aa5bcbedc48cc9a49ba14050fa3ad934a6f95c99))
+* **internal:** run formatter ([87ce979](https://github.com/anthropics/anthropic-sdk-ruby/commit/87ce979a06108f980e8c867d43166fbeeff02ec3))
+* update contribute.md ([aa928a0](https://github.com/anthropics/anthropic-sdk-ruby/commit/aa928a09f08250c9e6e93b884761eb35a9d5b6b4))
+
+## 1.2.0 (2025-07-18)
+
+Full Changelog: [v1.1.1...v1.2.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.1.1...v1.2.0)
+
+### Features
+
+* **api:** add support for Search Result Content Blocks ([158a7ce](https://github.com/anthropics/anthropic-sdk-ruby/commit/158a7ced1013c3af956554caf41ee08ec5d1db3c))
+* **api:** api update ([cd22765](https://github.com/anthropics/anthropic-sdk-ruby/commit/cd2276536c7960a4f7276ceb9baba8ba5aec196e))
+* **api:** manual updates ([7f51b33](https://github.com/anthropics/anthropic-sdk-ruby/commit/7f51b336943422d230d8704583f42dc6f8a3ac62))
+* **client:** add breaking change detection to CI ([52e342f](https://github.com/anthropics/anthropic-sdk-ruby/commit/52e342fe8c8231ad6b6b6ff68ed522033cd503c7))
+* **client:** add support for new text_editor_20250429 tool ([9049af2](https://github.com/anthropics/anthropic-sdk-ruby/commit/9049af2f634f88d867104f2dc0ddc6396f5f8031))
+* streaming helpers ([#627](https://github.com/anthropics/anthropic-sdk-ruby/issues/627)) ([43fbbf8](https://github.com/anthropics/anthropic-sdk-ruby/commit/43fbbf8a39ac1d99920845ba19da43d7419a5e73))
+* **vertex:** support global region endpoint ([da8c452](https://github.com/anthropics/anthropic-sdk-ruby/commit/da8c452a22c56780f311f4f1ab3477a48ac46891))
+
+
+### Bug Fixes
+
+* `to_sorbet_type` should not return branded types ([2658903](https://github.com/anthropics/anthropic-sdk-ruby/commit/2658903f13178a133ca679f4b87615e9cddcd813))
+* **ci:** release-doctor — report correct token name ([e30183e](https://github.com/anthropics/anthropic-sdk-ruby/commit/e30183e5561070dfd3dfe041f48e76765975cb3b))
+* **client:** deprecate BetaBase64PDFBlock in favor of BetaRequestDocumentBlock ([f75705b](https://github.com/anthropics/anthropic-sdk-ruby/commit/f75705bfb4af3160b2fa7208adfad10719cd17a7))
+* default content-type for text in multi-part formdata uploads should be text/plain ([0a91592](https://github.com/anthropics/anthropic-sdk-ruby/commit/0a915925fc93ca7ad191bab33dba8c72b6c48a2a))
+* **internal:** fix: should publish to ruby gems when a release is created ([cc88c6c](https://github.com/anthropics/anthropic-sdk-ruby/commit/cc88c6c7c164c5bb1937e12cefb4d91f05fec157))
+* issue where we cannot mutate arrays on base model derivatives ([446c8be](https://github.com/anthropics/anthropic-sdk-ruby/commit/446c8be0eb77a29641d472ea36cbaf6f786f7e3a))
+
+
+### Chores
+
+* add `license` to the gemspec ([#101](https://github.com/anthropics/anthropic-sdk-ruby/issues/101)) ([af509a7](https://github.com/anthropics/anthropic-sdk-ruby/commit/af509a735c0e985e615f9279bc070dc090874df8))
+* add RBS types for helpers/streaming ([#631](https://github.com/anthropics/anthropic-sdk-ruby/issues/631)) ([0d7941d](https://github.com/anthropics/anthropic-sdk-ruby/commit/0d7941df6628b1500f7e7e8def88f613d7bcf2fa))
+* **api:** mark claude-3-opus-20240229 as deprecated ([1edd9bd](https://github.com/anthropics/anthropic-sdk-ruby/commit/1edd9bdf0bf508f5467daf92c4b1db11128d70ea))
+* **api:** update BetaCitationSearchResultLocation ([b294f7e](https://github.com/anthropics/anthropic-sdk-ruby/commit/b294f7e2bfd44d01504eeb7e30b37926ca7200e2))
+* **ci:** enable for pull requests ([31bbb43](https://github.com/anthropics/anthropic-sdk-ruby/commit/31bbb43d02cc56505ad5ec8d737801b73f9f5fd8))
+* **ci:** link to correct github repo ([37b5902](https://github.com/anthropics/anthropic-sdk-ruby/commit/37b59027a26268ad5bb20ee6530c7f0c630bc5b5))
+* **ci:** only run for pushes and fork pull requests ([8d3c942](https://github.com/anthropics/anthropic-sdk-ruby/commit/8d3c9425afe873a49e403c7a8a36f14642191a89))
+* **internal:** allow streams to also be unwrapped on a per-row basis ([a271d21](https://github.com/anthropics/anthropic-sdk-ruby/commit/a271d21d2f01a9f7c9c2d126b1f3d9b0611dd8cd))
+* **internal:** codegen related update ([8b12fd6](https://github.com/anthropics/anthropic-sdk-ruby/commit/8b12fd6e8ec1c06d3cbf7d20c63c6933538d0983))
+* remove workaround for updating arrays in place in streaming ([#643](https://github.com/anthropics/anthropic-sdk-ruby/issues/643)) ([e0a30b8](https://github.com/anthropics/anthropic-sdk-ruby/commit/e0a30b8128624566f673ac77f97c305953b11c63))
+
+
+### Documentation
+
+* model in examples ([18ba0b6](https://github.com/anthropics/anthropic-sdk-ruby/commit/18ba0b62bd8f87b84766265726090ca2265a64b7))
+* update documentation in MessageStream ([#630](https://github.com/anthropics/anthropic-sdk-ruby/issues/630)) ([4795c73](https://github.com/anthropics/anthropic-sdk-ruby/commit/4795c73f0628d2bc710f77bd0868be18c53ec31a))
+* update models and non-beta ([a4ea04e](https://github.com/anthropics/anthropic-sdk-ruby/commit/a4ea04eaf88e608612512d39d07051842beaf500))
+
 ## 1.1.1 (2025-05-28)
 
 Full Changelog: [v1.1.0...v1.1.1](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.1.0...v1.1.1)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "anthropic", "~> 1.1.1"
+gem "anthropic", "~> 1.9.0"
 ```
 
 <!-- x-release-please-end -->
@@ -39,7 +39,7 @@ anthropic = Anthropic::Client.new(
 message = anthropic.messages.create(
   max_tokens: 1024,
   messages: [{role: "user", content: "Hello, Claude"}],
-  model: :"claude-3-7-sonnet-latest"
+  model: :"claude-sonnet-4-20250514"
 )
 
 puts(message.content)
@@ -49,13 +49,11 @@ puts(message.content)
 
 We provide support for streaming responses using Server-Sent Events (SSE).
 
-**coming soon**: `anthropic.messages.stream` will have [Python SDK](https://github.com/anthropics/anthropic-sdk-python?tab=readme-ov-file#streaming-helpers) style streaming response helpers.
-
 ```ruby
-stream = anthropic.messages.stream_raw(
+stream = anthropic.messages.stream(
   max_tokens: 1024,
   messages: [{role: "user", content: "Hello, Claude"}],
-  model: :"claude-3-7-sonnet-latest"
+  model: :"claude-sonnet-4-20250514"
 )
 
 stream.each do |message|
@@ -63,6 +61,24 @@ stream.each do |message|
 end
 ```
 
+### Streaming Helpers
+
+This library provides several conveniences for streaming messages, for example:
+
+```ruby
+stream = anthropic.messages.stream(
+  max_tokens: 1024,
+  messages: [{role: :user, content: "Say hello there!"}],
+  model: :"claude-sonnet-4-20250514"
+)
+
+stream.text.each do |text|
+  print(text)
+end
+```
+
+Streaming with `anthropic.messages.stream(...)` exposes [various helpers for your convenience](helpers.md) including accumulation & SDK-specific events.
+
 ### Pagination
 
 List methods in the Anthropic API are paginated.
@@ -70,7 +86,7 @@ List methods in the Anthropic API are paginated.
 This library provides auto-paginating iterators with each list response, so you do not have to request successive pages manually:
 
 ```ruby
-page = anthropic.beta.messages.batches.list(limit: 20)
+page = anthropic.messages.batches.list(limit: 20)
 
 # Fetch single item from page.
 batch = page.data[0]
@@ -122,7 +138,7 @@ begin
   message = anthropic.messages.create(
     max_tokens: 1024,
     messages: [{role: "user", content: "Hello, Claude"}],
-    model: :"claude-3-7-sonnet-latest"
+    model: :"claude-sonnet-4-20250514"
   )
 rescue Anthropic::Errors::APIConnectionError => e
   puts("The server could not be reached")
@@ -169,7 +185,7 @@ anthropic = Anthropic::Client.new(
 anthropic.messages.create(
   max_tokens: 1024,
   messages: [{role: "user", content: "Hello, Claude"}],
-  model: :"claude-3-7-sonnet-latest",
+  model: :"claude-sonnet-4-20250514",
   request_options: {max_retries: 5}
 )
 ```
@@ -188,7 +204,7 @@ anthropic = Anthropic::Client.new(
 anthropic.messages.create(
   max_tokens: 1024,
   messages: [{role: "user", content: "Hello, Claude"}],
-  model: :"claude-3-7-sonnet-latest",
+  model: :"claude-sonnet-4-20250514",
   request_options: {timeout: 5}
 )
 ```
@@ -219,7 +235,7 @@ message = anthropic.messages.create(
       content: "Hello, Claude"
     }
   ],
-  model: "anthropic.claude-3-5-sonnet-20241022-v2:0"
+  model: "anthropic.claude-sonnet-4-20250514-v2:0"
 )
 
 puts(message)
@@ -247,7 +263,7 @@ message = anthropic.messages.create(
       content: "Hello, Claude"
     }
   ],
-  model: "claude-3-7-sonnet@20250219"
+  model: "claude-sonnet-4@20250514"
 )
 
 puts(message)
@@ -284,7 +300,7 @@ message =
   anthropic.messages.create(
     max_tokens: 1024,
     messages: [{role: "user", content: "Hello, Claude"}],
-    model: :"claude-3-7-sonnet-latest",
+    model: :"claude-sonnet-4-20250514",
     request_options: {
       extra_query: {my_query_parameter: value},
       extra_body: {my_body_parameter: value},
@@ -333,7 +349,7 @@ You can provide typesafe request parameters like so:
 anthropic.messages.create(
   max_tokens: 1024,
   messages: [Anthropic::MessageParam.new(role: "user", content: "Hello, Claude")],
-  model: :"claude-3-7-sonnet-latest"
+  model: :"claude-sonnet-4-20250514"
 )
 ```
 
@@ -344,14 +360,14 @@ Or, equivalently:
 anthropic.messages.create(
   max_tokens: 1024,
   messages: [{role: "user", content: "Hello, Claude"}],
-  model: :"claude-3-7-sonnet-latest"
+  model: :"claude-sonnet-4-20250514"
 )
 
 # You can also splat a full Params class:
 params = Anthropic::MessageCreateParams.new(
   max_tokens: 1024,
   messages: [Anthropic::MessageParam.new(role: "user", content: "Hello, Claude")],
-  model: :"claude-3-7-sonnet-latest"
+  model: :"claude-sonnet-4-20250514"
 )
 anthropic.messages.create(**params)
 ```

data/lib/anthropic/client.rb

@@ -21,7 +21,10 @@ module Anthropic
       "claude-opus-4-0": 8_192,
       "claude-4-opus-20250514": 8_192,
       "anthropic.claude-opus-4-20250514-v1:0": 8_192,
-      "claude-opus-4@20250514": 8_192
+      "claude-opus-4@20250514": 8_192,
+      "claude-opus-4-1-20250805": 8192,
+      "anthropic.claude-opus-4-1-20250805-v1:0": 8192,
+      "claude-opus-4-1@20250805": 8192
     }.freeze
 
     # @return [String, nil]
@@ -78,7 +81,7 @@ module Anthropic
       expected_time = maximum_time * max_tokens / 128_000.0
       if expected_time > default_time || (max_nonstreaming_tokens && max_tokens > max_nonstreaming_tokens)
         raise ArgumentError.new(
-          "Streaming is strongly recommended for operations that may take longer than 10 minutes. " \
+          "Streaming is required for operations that may take longer than 10 minutes. " \
           "See https://github.com/anthropics/anthropic-sdk-ruby#long-requests for more details"
         )
       end

data/lib/anthropic/errors.rb

@@ -9,6 +9,28 @@ module Anthropic
     end
 
     class ConversionError < Anthropic::Errors::Error
+      # @return [StandardError, nil]
+      def cause = @cause.nil? ? super : @cause
+
+      # @api private
+      #
+      # @param on [Class<StandardError>]
+      # @param method [Symbol]
+      # @param target [Object]
+      # @param value [Object]
+      # @param cause [StandardError, nil]
+      def initialize(on:, method:, target:, value:, cause: nil)
+        cls = on.name.split("::").last
+
+        message = [
+          "Failed to parse #{cls}.#{method} from #{value.class} to #{target.inspect}.",
+          "To get the unparsed API response, use #{cls}[#{method.inspect}].",
+          cause && "Cause: #{cause.message}"
+        ].filter(&:itself).join(" ")
+
+        @cause = cause
+        super(message)
+      end
     end
 
     class APIError < Anthropic::Errors::Error

data/lib/anthropic/helpers/bedrock/client.rb

@@ -50,10 +50,10 @@ module Anthropic
         def initialize(
           aws_region: nil,
           base_url: nil,
-          max_retries: DEFAULT_MAX_RETRIES,
-          timeout: DEFAULT_TIMEOUT_IN_SECONDS,
-          initial_retry_delay: DEFAULT_INITIAL_RETRY_DELAY,
-          max_retry_delay: DEFAULT_MAX_RETRY_DELAY,
+          max_retries: self.class::DEFAULT_MAX_RETRIES,
+          timeout: self.class::DEFAULT_TIMEOUT_IN_SECONDS,
+          initial_retry_delay: self.class::DEFAULT_INITIAL_RETRY_DELAY,
+          max_retry_delay: self.class::DEFAULT_MAX_RETRY_DELAY,
           aws_access_key: nil,
           aws_secret_key: nil,
           aws_session_token: nil,
@@ -165,6 +165,36 @@ module Anthropic
           request_input
         end
 
+        # @api private
+        #
+        # Very private API, do not use
+        #
+        # @param request [Hash{Symbol=>Object}] .
+        #
+        #   @option request [Symbol] :method
+        #
+        #   @option request [URI::Generic] :url
+        #
+        #   @option request [Hash{String=>String}] :headers
+        #
+        #   @option request [Object] :body
+        #
+        # @return [Hash{Symbol, Object}]
+        private def transform_request(request)
+          sliced = super.slice(
+            :method,
+            :url,
+            :headers,
+            :body
+          ).transform_keys(method: :http_method)
+          body = StringIO.new(body.to_a.join) if (body = sliced.fetch(:body)).is_a?(Enumerator)
+
+          signed = @signer.sign_request({**sliced, body: body})
+
+          headers = Anthropic::Internal::Util.normalized_headers(request.fetch(:headers), signed.headers)
+          {**request, headers: headers}
+        end
+
         # @param aws_region [String, nil]
         #
         # @param aws_secret_key [String, nil]

data/lib/anthropic/helpers/input_schema/array_of.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Helpers
+    module InputSchema
+      # @generic Elem
+      #
+      # @example
+      #   example = Anthropic::ArrayOf[Integer]
+      #
+      # @example
+      #   example = Anthropic::ArrayOf[Integer, nil?: true, doc: "hi there!"]
+      class ArrayOf < Anthropic::Internal::Type::ArrayOf
+        include Anthropic::Helpers::InputSchema::JsonSchemaConverter
+
+        # @api private
+        #
+        # @param state [Hash{Symbol=>Object}]
+        #
+        #   @option state [Hash{Object=>String}] :defs
+        #
+        #   @option state [Array<String>] :path
+        #
+        # @return [Hash{Symbol=>Object}]
+        def to_json_schema_inner(state:)
+          Anthropic::Helpers::InputSchema::JsonSchemaConverter.cache_def!(state, type: self) do
+            state.fetch(:path) << "[]"
+            items = Anthropic::Helpers::InputSchema::JsonSchemaConverter.to_json_schema_inner(
+              item_type,
+              state: state
+            )
+            items = Anthropic::Helpers::InputSchema::JsonSchemaConverter.to_nilable(items) if nilable?
+            Anthropic::Helpers::InputSchema::JsonSchemaConverter.assoc_meta!(items, meta: @meta)
+
+            {type: "array", items: items}
+          end
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/helpers/input_schema/base_model.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Helpers
+    module InputSchema
+      # Represents a response from Anthropic's API where the model's output has been structured according to a schema predefined by the user.
+      #
+      # This class is specifically used when making requests with the `input_schema` parameter.
+      #
+      # See {examples/input_schemas.rb} for a complete example of use
+      class BaseModel < Anthropic::Internal::Type::BaseModel
+        extend Anthropic::Helpers::InputSchema::JsonSchemaConverter
+
+        class << self
+          # @return [Hash{Symbol=>Object}]
+          def to_json_schema = Anthropic::Helpers::InputSchema::JsonSchemaConverter.to_json_schema(self)
+
+          # @api private
+          #
+          # @param state [Hash{Symbol=>Object}]
+          #
+          #   @option state [Hash{Object=>String}] :defs
+          #
+          #   @option state [Array<String>] :path
+          #
+          # @return [Hash{Symbol=>Object}]
+          def to_json_schema_inner(state:)
+            Anthropic::Helpers::InputSchema::JsonSchemaConverter.cache_def!(state, type: self) do
+              path = state.fetch(:path)
+              properties = fields.to_h do |name, field|
+                type, nilable, meta = field.fetch_values(:type, :nilable, :meta)
+                new_state = {**state, path: [*path, ".#{name}"]}
+
+                schema =
+                  case type
+                  in Anthropic::Helpers::InputSchema::JsonSchemaConverter
+                    type.to_json_schema_inner(state: new_state)
+                  else
+                    Anthropic::Helpers::InputSchema::JsonSchemaConverter.to_json_schema_inner(
+                      type,
+                      state: new_state
+                    )
+                  end
+                Anthropic::Helpers::InputSchema::JsonSchemaConverter.assoc_meta!(schema, meta: meta)
+                schema = Anthropic::Helpers::InputSchema::JsonSchemaConverter.to_nilable(schema) if nilable
+
+                [name, schema]
+              end
+
+              {
+                type: "object",
+                properties: properties,
+                required: fields.select { _2.fetch(:required) }.keys.map(&:to_s),
+                additionalProperties: false
+              }.tap { _1.store(:description, @doc_string) unless @doc_string.nil? }
+            end
+          end
+        end
+
+        class << self
+          def required(name_sym, type_info, *args)
+            spec = process_field_args(args)
+            super(name_sym, type_info, spec)
+          end
+
+          def optional(name_sym, type_info, *args)
+            spec = process_field_args(args)
+            super(name_sym, type_info, spec)
+          end
+
+          attr_reader :doc_string
+
+          # @param description [String]
+          def doc(description)
+            @doc_string = description
+          end
+
+          private def process_field_args(args)
+            # Only accept hash format for descriptions.
+            args.grep(Hash).first.to_h
+          end
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/helpers/input_schema/boolean.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Helpers
+    module InputSchema
+      # @abstract
+      #
+      # Ruby does not have a "boolean" Class, this is something for models to refer to.
+      class Boolean < Anthropic::Internal::Type::Boolean
+        extend Anthropic::Helpers::InputSchema::JsonSchemaConverter
+
+        # rubocop:disable Lint/UnusedMethodArgument
+
+        # @api private
+        #
+        # @param state [Hash{Symbol=>Object}]
+        #
+        #   @option state [Hash{Object=>String}] :defs
+        #
+        #   @option state [Array<String>] :path
+        #
+        # @return [Hash{Symbol=>Object}]
+        def self.to_json_schema_inner(state:) = {type: "boolean"}
+
+        # rubocop:enable Lint/UnusedMethodArgument
+      end
+    end
+  end
+end

data/lib/anthropic/helpers/input_schema/enum_of.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Helpers
+    module InputSchema
+      # @generic Value
+      #
+      # @example
+      #   example = Anthropic::EnumOf[:foo, :bar, :zoo]
+      #
+      # @example
+      #   example = Anthropic::EnumOf[1, 2, 3]
+      class EnumOf
+        include Anthropic::Internal::Type::Enum
+        include Anthropic::Helpers::InputSchema::JsonSchemaConverter
+
+        # @api private
+        #
+        # @param state [Hash{Symbol=>Object}]
+        #
+        #   @option state [Hash{Object=>String}] :defs
+        #
+        #   @option state [Array<String>] :path
+        #
+        # @return [Hash{Symbol=>Object}]
+        def to_json_schema_inner(state:)
+          Anthropic::Helpers::InputSchema::JsonSchemaConverter.cache_def!(state, type: self) do
+            types = values.map do
+              case _1
+              in NilClass
+                "null"
+              in true | false
+                "boolean"
+              in Integer
+                "integer"
+              in Float
+                "number"
+              in Symbol
+                "string"
+              end
+            end
+              .uniq
+
+            {
+              type: types.length == 1 ? types.first : types,
+              enum: values.map { _1.is_a?(Symbol) ? _1.to_s : _1 }
+            }
+          end
+        end
+
+        private_class_method :new
+
+        def self.[](...) = new(...)
+
+        # @return [Array<generic<Value>>]
+        attr_reader :values
+
+        # @param values [Array<generic<Value>>]
+        def initialize(*values) = (@values = values.map { _1.is_a?(String) ? _1.to_sym : _1 })
+      end
+    end
+  end
+end