anthropic 1.72.0 → 1.74.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e7aa200569945cdf76744a8c251b760350a75834328da86c44930b40f741b31
-  data.tar.gz: 780bb11d38658bb95e1142b1c389fc82e49ad04d20cdc4c01a9c4ed54b7038dd
+  metadata.gz: b42acaa5fbcc24fe2574af40d17c100634efb986cf30ee24a5a327f295f6b922
+  data.tar.gz: b456d0a9bf98c97af0788edd55b6fac69c5607f8df31ed178fedca5d7e76eeff
 SHA512:
-  metadata.gz: 3de8eca81334145eaf72e0bfd8e142143ce8742e341db711085acac170f16132308f3c02fdaf424bdbc7e51d0832bc1de7a79e2abed18a2d80e57a92697c3b8c
-  data.tar.gz: 5994156c894b26d1cd0d504888f2cebc5409e4ff41bf81aa17f36f643e7de6c863ee831a34dc2ba49415f9fa531ab4456c33851d7655cb6461f36b7b39192074
+  metadata.gz: d998d3c2656dbe442adfb80bbb6c86d2b70e87112a9b06eb2dfa6588bdff72ac5f5a95fc7157f762ba06a5cb9bf13272f88c08a6ca435f1de9e71845626e0d60
+  data.tar.gz: fea464ecbbe55f09643d33a9d4ac92f2d8355dc7364c5fac63d30707ec99b6da7f48e8c9413e4bda296154205de9b674b84db8c993a88c62b0c4f76a6781be00

data/CHANGELOG.md

@@ -1,5 +1,73 @@
 # Changelog
 
+## 1.74.0 (2026-09-28)
+
+Full Changelog: [v1.73.0...v1.74.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.73.0...v1.74.0)
+
+### Features
+
+* **api:** add between_tools thinking type ([9b24118](https://github.com/anthropics/anthropic-sdk-ruby/commit/9b24118fb51616ba540d461db518dac5daf12f4b))
+* **api:** add claude-sonnet-5-5 ([d4c258e](https://github.com/anthropics/anthropic-sdk-ruby/commit/d4c258e340ccb9b459f5de72c6dbbd0e0c4ad049))
+* **api:** add include_inherited and source to workspace rate limits ([fb110e9](https://github.com/anthropics/anthropic-sdk-ruby/commit/fb110e9a38e7f60e12079a7b88db302c3c767182))
+* **api:** add typed event type values to the Managed Agents events list filter ([38ead1d](https://github.com/anthropics/anthropic-sdk-ruby/commit/38ead1d22356559e0f16149f6208930f6f5342c8))
+* **api:** cache diagnostics GA — diagnostics on Message / MessageCreateParams ([0bee370](https://github.com/anthropics/anthropic-sdk-ruby/commit/0bee370f64c82f51dbd8ed3d4fc03bfa7c8ad9d1))
+
+
+### Bug Fixes
+
+* **client:** keep base URL path for `request` paths starting with `/` ([2e70130](https://github.com/anthropics/anthropic-sdk-ruby/commit/2e70130a8b68e250fbdd7574ada78581c8f48cd5))
+* **client:** send no placeholder filename for unnamed file uploads ([d870615](https://github.com/anthropics/anthropic-sdk-ruby/commit/d870615ecb13e85cb190a1982ceb92856b7b0726))
+* **helpers:** degrade between_tools thinking to disabled on fallback hops ([#276](https://github.com/anthropics/anthropic-sdk-ruby/issues/276)) ([00fa84e](https://github.com/anthropics/anthropic-sdk-ruby/commit/00fa84e4063124357e7e16cbb5242086ddf1f108))
+* **messages:** add the diagnostics parameter to sig and def ([#272](https://github.com/anthropics/anthropic-sdk-ruby/issues/272)) ([ec8e144](https://github.com/anthropics/anthropic-sdk-ruby/commit/ec8e144410c4e59114e1d6ad74edd436113ed7ef))
+
+
+### Chores
+
+* **api:** deprecate the betas param on GA models and completions methods ([d5426bc](https://github.com/anthropics/anthropic-sdk-ruby/commit/d5426bc99a1504957ae6f7c1b5703c88aa3c6c93))
+* **ci:** run CI on larger runners ([07801fb](https://github.com/anthropics/anthropic-sdk-ruby/commit/07801fbdf64e515bc502e41d953689cf714860dd))
+* **docs:** clarify that stream: true returns the raw event stream ([30fd670](https://github.com/anthropics/anthropic-sdk-ruby/commit/30fd670fb5d63fc98842e728b0694435b0ecc684))
+* **docs:** make Managed Agents actor descriptions resource-neutral ([b1d2865](https://github.com/anthropics/anthropic-sdk-ruby/commit/b1d2865d7acbaf7d26e0053740550213ae66377b))
+* **docs:** restore the research-preview notice on the Dream type ([7f1a792](https://github.com/anthropics/anthropic-sdk-ruby/commit/7f1a7924d4c43bb185892c5873f6f2335759ae32))
+* **tools:** remove client-side compaction control ([#271](https://github.com/anthropics/anthropic-sdk-ruby/issues/271)) ([bdfa3ad](https://github.com/anthropics/anthropic-sdk-ruby/commit/bdfa3ad52df49e4de76fc68d490870eea7464cc0))
+
+
+### Documentation
+
+* **api:** prefer each field's own description over its shared type's ([e5b841b](https://github.com/anthropics/anthropic-sdk-ruby/commit/e5b841bbd6bda136fa47c052cd943e9025515692))
+
+## 1.73.0 (2026-09-22)
+
+Full Changelog: [v1.72.0...v1.73.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.72.0...v1.73.0)
+
+### Features
+
+* **api:** add support for claude-opus-5-5, inline tool definitions and MCP tool-list pinning (beta) ([b68ad25](https://github.com/anthropics/anthropic-sdk-ruby/commit/b68ad25d7e21c929b0a2309ba5c8ecc48f09fcfa))
+* **tools:** add compact_before_next_turn() to the tool runner ([#258](https://github.com/anthropics/anthropic-sdk-ruby/issues/258)) ([adccb26](https://github.com/anthropics/anthropic-sdk-ruby/commit/adccb26c933e2057794f903e41308d65108ecaff))
+
+
+### Bug Fixes
+
+* **api:** share one evaluated_permission enum across Managed Agents events ([5cea62a](https://github.com/anthropics/anthropic-sdk-ruby/commit/5cea62a855bec9f4cc991b2309b6934b9db987bf))
+* **tools:** add_tools takes effect straight away ([#269](https://github.com/anthropics/anthropic-sdk-ruby/issues/269)) ([289bfad](https://github.com/anthropics/anthropic-sdk-ruby/commit/289bfad23d1d26d0b86006f9aca7a624f8a86ce6))
+* **tools:** leave reply-only params off the tool runner's compaction request ([#267](https://github.com/anthropics/anthropic-sdk-ruby/issues/267)) ([5a1d7d2](https://github.com/anthropics/anthropic-sdk-ruby/commit/5a1d7d2352e7e4f65c312219c7a5695187ea2926))
+
+
+### Chores
+
+* **ci:** give the lint and breaking-change detection jobs more time ([59fc172](https://github.com/anthropics/anthropic-sdk-ruby/commit/59fc172c0f462de5743e947b6ec3c4708a5aac58))
+* **docs:** add descriptions to the Dreams API reference ([cfc7239](https://github.com/anthropics/anthropic-sdk-ruby/commit/cfc7239c607941094a470586342ed77cee41d75c))
+* **docs:** add descriptions to the User Profiles API reference ([cfc7239](https://github.com/anthropics/anthropic-sdk-ruby/commit/cfc7239c607941094a470586342ed77cee41d75c))
+* **docs:** add memory store descriptions to the Managed Agents API reference ([cfc7239](https://github.com/anthropics/anthropic-sdk-ruby/commit/cfc7239c607941094a470586342ed77cee41d75c))
+* **docs:** improve descriptions in the Dreams API reference ([54a81a7](https://github.com/anthropics/anthropic-sdk-ruby/commit/54a81a7c9f7fce043fafb342014144bf2a1bf050))
+* **docs:** simplify the session thread agent type description ([23d1d44](https://github.com/anthropics/anthropic-sdk-ruby/commit/23d1d4418dcf305366c48f144756071f173f909b))
+* **docs:** update diagnostics field descriptions on beta messages ([678a792](https://github.com/anthropics/anthropic-sdk-ruby/commit/678a7923359f8de6be74cffd9bbd1123df5e2cb9))
+* **internal:** let the typecheck task use every core, up to 16 ([f0ac300](https://github.com/anthropics/anthropic-sdk-ruby/commit/f0ac30052d083a8bf95c66a7c98a80985649c70d))
+
+
+### Documentation
+
+* add path and header parameter descriptions ([d458058](https://github.com/anthropics/anthropic-sdk-ruby/commit/d458058bfe901b540f5b346af63926d344c253dd))
+
 ## 1.72.0 (2026-09-18)
 
 Full Changelog: [v1.71.0...v1.72.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.71.0...v1.72.0)

data/README.md

@@ -15,7 +15,7 @@ Add to your application's Gemfile:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "anthropic", "~> 1.72.0"
+gem "anthropic", "~> 1.74.0"
 ```
 
 <!-- x-release-please-end -->
@@ -33,7 +33,7 @@ anthropic = Anthropic::Client.new(
 message = anthropic.messages.create(
   max_tokens: 1024,
   messages: [{role: "user", content: "Hello, Claude"}],
-  model: "claude-opus-4-6"
+  model: "claude-opus-5-5"
 )
 
 puts(message.content)

data/lib/anthropic/helpers/messages.rb

@@ -35,54 +35,29 @@ module Anthropic
 
           case data
           in {tools: Array => tool_array}
-            # rubocop:disable Metrics/BlockLength
-            mapped = tool_array.map do |tool|
-              case tool
-              # Runnable tool instance (an `Anthropic::BaseTool` subclass, hand-written or helper-built):
-              in Anthropic::Helpers::Tools::BaseTool
-                name = tool_api_name(tool)
-                # Helper-built tools (e.g. MCP) declare an explicit `tool_name` and only send the
-                # description they were given; hand-written tools fall back to their name.
-                description = tool.class.doc_string
-                description ||= name unless tool.class.tool_name
-                tools.store(name, tool)
-                input_schema = Anthropic::Helpers::InputSchema::JsonSchemaConverter.to_json_schema(tool)
-                # On a clash the derived keys win, so nothing in `tool_options` can shadow them.
-                definition =
-                  {name:, description:, input_schema:}
-                  .merge(tool.class.tool_options) { |_key, derived, _option| derived }
-                  .compact
-                definition.tap { _1.update(strict:) if strict }
-              # Input schema class used directly as a tool:
-              in Anthropic::Helpers::InputSchema::JsonSchemaConverter
-                name = model_name(tool.name)
-
-                description =
-                  case tool
-                  in Class if tool <= Anthropic::Helpers::InputSchema::BaseModel
-                    tool.doc_string || name
+            tool_array.replace(tool_array.map { tool_to_param(_1, tools:, strict:) })
+          else
+          end
+
+          # A `tool_addition` block defines a tool by value, in the shape of a `tools` entry.
+          case data
+          in {messages: Array => messages}
+            messages.each do |message|
+              case message
+              in {role: :system | "system", content: Array => blocks}
+                blocks.each do |block|
+                  case block
+                  in {
+                    type: :tool_addition | "tool_addition",
+                    tool: {type: :tool_definition | "tool_definition", definition:} => tool
+                  }
+                    tool.store(:definition, tool_to_param(definition, tools:, strict:))
                   else
-                    name
                   end
-
-                tools.store(name, tool)
-                input_schema = Anthropic::Helpers::InputSchema::JsonSchemaConverter.to_json_schema(tool)
-                {name:, description:, input_schema:}.tap { _1.update(strict:) if strict }
-              # Tool with explicit name/description and BaseModel as input_schema:
-              in {name: String => name,
-                  input_schema: Anthropic::Helpers::InputSchema::JsonSchemaConverter => tool,
-                  **rest}
-                tools.store(name, tool)
-                input_schema = Anthropic::Helpers::InputSchema::JsonSchemaConverter.to_json_schema(tool)
-                rest.merge(name:, input_schema:).tap { _1.update(strict:) if strict }
+                end
               else
-                # Any other format (pass through unchanged)
-                # This includes raw JSON schemas and any other tool definitions.
-                tool
               end
             end
-            # rubocop:enable Metrics/BlockLength
-            tool_array.replace(mapped)
           else
           end
 
@@ -212,6 +187,64 @@ module Anthropic
           data[:betas] = data[:betas].to_a.dup.push("structured-outputs-2025-12-15").uniq
         end
 
+        # @api private
+        #
+        # Convert one tool in any of the forms the helpers accept into a plain tool definition,
+        # recording under its name what `tool_use.input` is parsed back into.
+        #
+        # @param tool [Object]
+        #
+        # @param tools [Hash{String=>Class}]
+        #
+        # @param strict [Boolean, nil]
+        #
+        # @return [Object]
+        private def tool_to_param(tool, tools:, strict:)
+          case tool
+          # Runnable tool instance (an `Anthropic::BaseTool` subclass, hand-written or helper-built):
+          in Anthropic::Helpers::Tools::BaseTool
+            name = tool_api_name(tool)
+            # Helper-built tools (e.g. MCP) declare an explicit `tool_name` and only send the
+            # description they were given; hand-written tools fall back to their name.
+            description = tool.class.doc_string
+            description ||= name unless tool.class.tool_name
+            tools.store(name, tool)
+            input_schema = Anthropic::Helpers::InputSchema::JsonSchemaConverter.to_json_schema(tool)
+            # On a clash the derived keys win, so nothing in `tool_options` can shadow them.
+            definition =
+              {name:, description:, input_schema:}
+              .merge(tool.class.tool_options) { |_key, derived, _option| derived }
+              .compact
+            definition.tap { _1.update(strict:) if strict }
+          # Input schema class used directly as a tool:
+          in Anthropic::Helpers::InputSchema::JsonSchemaConverter
+            name = model_name(tool.name)
+
+            description =
+              case tool
+              in Class if tool <= Anthropic::Helpers::InputSchema::BaseModel
+                tool.doc_string || name
+              else
+                name
+              end
+
+            tools.store(name, tool)
+            input_schema = Anthropic::Helpers::InputSchema::JsonSchemaConverter.to_json_schema(tool)
+            {name:, description:, input_schema:}.tap { _1.update(strict:) if strict }
+          # Tool with explicit name/description and BaseModel as input_schema:
+          in {name: String => name,
+              input_schema: Anthropic::Helpers::InputSchema::JsonSchemaConverter => model,
+              **rest}
+            tools.store(name, model)
+            input_schema = Anthropic::Helpers::InputSchema::JsonSchemaConverter.to_json_schema(model)
+            rest.merge(name:, input_schema:).tap { _1.update(strict:) if strict }
+          else
+            # Any other format (pass through unchanged)
+            # This includes raw JSON schemas and any other tool definitions.
+            tool
+          end
+        end
+
         # @api private
         #
         # The `name` a runnable tool is serialized under in `tools[]`.

data/lib/anthropic/helpers/refusal_fallback.rb

@@ -26,7 +26,8 @@ module Anthropic
   # against the original params (a set field overrides, an explicit `nil`
   # unsets, an absent field keeps the original value) — passing along the
   # refusal's `fallback_credit_token` — until a model accepts or the chain is
-  # exhausted. A message served by a
+  # exhausted. A `between_tools` thinking config is sent to a fallback as
+  # `disabled` unless the entry sets `thinking` itself. A message served by a
   # fallback carries a `fallback` content block prepended at each model
   # boundary; an exhausted chain surfaces the final refusal verbatim.
   #
@@ -39,7 +40,8 @@ module Anthropic
   # model boundary, monotonic block indices, and per-hop `usage.iterations` on
   # the final `message_delta`. Only `model` is honored from each entry on this
   # path: the credit token is redeemable only against the refused request's
-  # body, so the other per-entry overrides would be rejected.
+  # body, so the other per-entry overrides would be rejected. A
+  # `between_tools` thinking config is always sent as `disabled` on this path.
   #
   # Credit tokens are sent in the object form with `mode: :best_effort`, so a
   # failing redemption never rejects the retry — it proceeds at normal price
@@ -69,7 +71,8 @@ module Anthropic
     #   the non-streaming path the remaining keys (`max_tokens:`, `thinking:`,
     #   …) patch the original request body for that hop — a value overrides
     #   the param, an explicit `nil` unsets it, an absent key keeps the
-    #   original value.
+    #   original value (an absent `thinking:` sends `between_tools` as
+    #   `disabled`).
     # @param betas [Array<String>] betas added to the `anthropic-beta` header
     #   of every `/v1/messages` request this middleware handles. Defaults to
     #   `["fallback-credit-2026-07-01"]`; pass `[]` to send none.
@@ -133,7 +136,7 @@ module Anthropic
           # Only `model` is honored on the streaming path so the credit token
           # — redeemable only against the refused request's body — stays valid
           # for the spliced hops.
-          body.merge(model: @fallbacks.fetch(start_index).fetch(:model))
+          degrade_between_tools(body.merge(model: @fallbacks.fetch(start_index).fetch(:model)))
         else
           apply_fallback(body, @fallbacks.fetch(start_index))
         end
@@ -165,6 +168,7 @@ module Anthropic
     # @return [Hash{Symbol=>Object}]
     def apply_fallback(body, entry)
       patched = patch(body, entry)
+      patched = degrade_between_tools(patched) unless entry.key?(:thinking)
       override = entry[:output_config]
       return patched if override.nil?
 
@@ -172,6 +176,16 @@ module Anthropic
       merged.empty? ? patched.except(:output_config) : patched.merge(output_config: merged)
     end
 
+    # The fallback model may not accept `between_tools` thinking, so a hop that
+    # carries it sends `disabled` instead.
+    #
+    # @param body [Hash{Symbol=>Object}]
+    # @return [Hash{Symbol=>Object}]
+    def degrade_between_tools(body)
+      return body unless hash_of(body[:thinking])[:type].to_s == "between_tools"
+      body.merge(thinking: {type: :disabled})
+    end
+
     # @param base [Hash{Symbol=>Object}]
     # @param overrides [Hash{Symbol=>Object}] a value sets the key, an
     #   explicit `nil` deletes it, an absent key keeps `base`'s value
@@ -388,7 +402,7 @@ module Anthropic
         model = @fallbacks.fetch(hop).fetch(:model).to_s
         has_next = hop + 1 < @fallbacks.length
 
-        res_b, sent, failed = issue_hop(req, nxt, body, model, token, base, partial)
+        res_b, sent, failed = issue_hop(req, nxt, degrade_between_tools(body), model, token, base, partial)
 
         if failed
           next if has_next