anthropic 0.4.0 → 1.0.0

data/lib/anthropic/models/beta/beta_text_citation.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module BetaTextCitation
+        extend Anthropic::Internal::Type::Union
+
+        discriminator :type
+
+        variant :char_location, -> { Anthropic::Beta::BetaCitationCharLocation }
+
+        variant :page_location, -> { Anthropic::Beta::BetaCitationPageLocation }
+
+        variant :content_block_location, -> { Anthropic::Beta::BetaCitationContentBlockLocation }
+
+        variant :web_search_result_location, -> { Anthropic::Beta::BetaCitationsWebSearchResultLocation }
+
+        # @!method self.variants
+        #   @return [Array(Anthropic::Beta::BetaCitationCharLocation, Anthropic::Beta::BetaCitationPageLocation, Anthropic::Beta::BetaCitationContentBlockLocation, Anthropic::Beta::BetaCitationsWebSearchResultLocation)]
+      end
+    end
+
+    BetaTextCitation = Beta::BetaTextCitation
+  end
+end

data/lib/anthropic/models/beta/beta_text_citation_param.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module BetaTextCitationParam
+        extend Anthropic::Internal::Type::Union
+
+        discriminator :type
+
+        variant :char_location, -> { Anthropic::Beta::BetaCitationCharLocationParam }
+
+        variant :page_location, -> { Anthropic::Beta::BetaCitationPageLocationParam }
+
+        variant :content_block_location, -> { Anthropic::Beta::BetaCitationContentBlockLocationParam }
+
+        variant :web_search_result_location, -> { Anthropic::Beta::BetaCitationWebSearchResultLocationParam }
+
+        # @!method self.variants
+        #   @return [Array(Anthropic::Beta::BetaCitationCharLocationParam, Anthropic::Beta::BetaCitationPageLocationParam, Anthropic::Beta::BetaCitationContentBlockLocationParam, Anthropic::Beta::BetaCitationWebSearchResultLocationParam)]
+      end
+    end
+
+    BetaTextCitationParam = Beta::BetaTextCitationParam
+  end
+end

data/lib/anthropic/models/beta/beta_text_delta.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaTextDelta < Anthropic::Internal::Type::BaseModel
+        # @!attribute text
+        #
+        #   @return [String]
+        required :text, String
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :text_delta]
+        required :type, const: :text_delta
+
+        # @!method initialize(text:, type: :text_delta)
+        #   @param text [String]
+        #   @param type [Symbol, :text_delta]
+      end
+    end
+
+    BetaTextDelta = Beta::BetaTextDelta
+  end
+end

data/lib/anthropic/models/beta/beta_thinking_block.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaThinkingBlock < Anthropic::Internal::Type::BaseModel
+        # @!attribute signature
+        #
+        #   @return [String]
+        required :signature, String
+
+        # @!attribute thinking
+        #
+        #   @return [String]
+        required :thinking, String
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :thinking]
+        required :type, const: :thinking
+
+        # @!method initialize(signature:, thinking:, type: :thinking)
+        #   @param signature [String]
+        #   @param thinking [String]
+        #   @param type [Symbol, :thinking]
+      end
+    end
+
+    BetaThinkingBlock = Beta::BetaThinkingBlock
+  end
+end

data/lib/anthropic/models/beta/beta_thinking_block_param.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaThinkingBlockParam < Anthropic::Internal::Type::BaseModel
+        # @!attribute signature
+        #
+        #   @return [String]
+        required :signature, String
+
+        # @!attribute thinking
+        #
+        #   @return [String]
+        required :thinking, String
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :thinking]
+        required :type, const: :thinking
+
+        # @!method initialize(signature:, thinking:, type: :thinking)
+        #   @param signature [String]
+        #   @param thinking [String]
+        #   @param type [Symbol, :thinking]
+      end
+    end
+
+    BetaThinkingBlockParam = Beta::BetaThinkingBlockParam
+  end
+end

data/lib/anthropic/models/beta/beta_thinking_config_disabled.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaThinkingConfigDisabled < Anthropic::Internal::Type::BaseModel
+        # @!attribute type
+        #
+        #   @return [Symbol, :disabled]
+        required :type, const: :disabled
+
+        # @!method initialize(type: :disabled)
+        #   @param type [Symbol, :disabled]
+      end
+    end
+
+    BetaThinkingConfigDisabled = Beta::BetaThinkingConfigDisabled
+  end
+end

data/lib/anthropic/models/beta/beta_thinking_config_enabled.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaThinkingConfigEnabled < Anthropic::Internal::Type::BaseModel
+        # @!attribute budget_tokens
+        #   Determines how many tokens Claude can use for its internal reasoning process.
+        #   Larger budgets can enable more thorough analysis for complex problems, improving
+        #   response quality.
+        #
+        #   Must be ≥1024 and less than `max_tokens`.
+        #
+        #   See
+        #   [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+        #   for details.
+        #
+        #   @return [Integer]
+        required :budget_tokens, Integer
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :enabled]
+        required :type, const: :enabled
+
+        # @!method initialize(budget_tokens:, type: :enabled)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Beta::BetaThinkingConfigEnabled} for more details.
+        #
+        #   @param budget_tokens [Integer] Determines how many tokens Claude can use for its internal reasoning process. La
+        #
+        #   @param type [Symbol, :enabled]
+      end
+    end
+
+    BetaThinkingConfigEnabled = Beta::BetaThinkingConfigEnabled
+  end
+end

data/lib/anthropic/models/beta/beta_thinking_config_param.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      # Configuration for enabling Claude's extended thinking.
+      #
+      # When enabled, responses include `thinking` content blocks showing Claude's
+      # thinking process before the final answer. Requires a minimum budget of 1,024
+      # tokens and counts towards your `max_tokens` limit.
+      #
+      # See
+      # [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+      # for details.
+      module BetaThinkingConfigParam
+        extend Anthropic::Internal::Type::Union
+
+        discriminator :type
+
+        variant :enabled, -> { Anthropic::Beta::BetaThinkingConfigEnabled }
+
+        variant :disabled, -> { Anthropic::Beta::BetaThinkingConfigDisabled }
+
+        # @!method self.variants
+        #   @return [Array(Anthropic::Beta::BetaThinkingConfigEnabled, Anthropic::Beta::BetaThinkingConfigDisabled)]
+      end
+    end
+
+    BetaThinkingConfigParam = Beta::BetaThinkingConfigParam
+  end
+end

data/lib/anthropic/models/beta/beta_thinking_delta.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaThinkingDelta < Anthropic::Internal::Type::BaseModel
+        # @!attribute thinking
+        #
+        #   @return [String]
+        required :thinking, String
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :thinking_delta]
+        required :type, const: :thinking_delta
+
+        # @!method initialize(thinking:, type: :thinking_delta)
+        #   @param thinking [String]
+        #   @param type [Symbol, :thinking_delta]
+      end
+    end
+
+    BetaThinkingDelta = Beta::BetaThinkingDelta
+  end
+end

data/lib/anthropic/models/beta/beta_tool.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaTool < Anthropic::Internal::Type::BaseModel
+        # @!attribute input_schema
+        #   [JSON schema](https://json-schema.org/draft/2020-12) for this tool's input.
+        #
+        #   This defines the shape of the `input` that your tool accepts and that the model
+        #   will produce.
+        #
+        #   @return [Anthropic::Beta::BetaTool::InputSchema]
+        required :input_schema, -> { Anthropic::Beta::BetaTool::InputSchema }
+
+        # @!attribute name
+        #   Name of the tool.
+        #
+        #   This is how the tool will be called by the model and in `tool_use` blocks.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute cache_control
+        #   Create a cache control breakpoint at this content block.
+        #
+        #   @return [Anthropic::Beta::BetaCacheControlEphemeral, nil]
+        optional :cache_control, -> { Anthropic::Beta::BetaCacheControlEphemeral }, nil?: true
+
+        # @!attribute description
+        #   Description of what this tool does.
+        #
+        #   Tool descriptions should be as detailed as possible. The more information that
+        #   the model has about what the tool is and how to use it, the better it will
+        #   perform. You can use natural language descriptions to reinforce important
+        #   aspects of the tool input JSON schema.
+        #
+        #   @return [String, nil]
+        optional :description, String
+
+        # @!attribute type
+        #
+        #   @return [Symbol, Anthropic::Beta::BetaTool::Type, nil]
+        optional :type, enum: -> { Anthropic::Beta::BetaTool::Type }, nil?: true
+
+        # @!method initialize(input_schema:, name:, cache_control: nil, description: nil, type: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Beta::BetaTool} for more details.
+        #
+        #   @param input_schema [Anthropic::Beta::BetaTool::InputSchema] [JSON schema](https://json-schema.org/draft/2020-12) for this tool's input.
+        #
+        #   @param name [String] Name of the tool.
+        #
+        #   @param cache_control [Anthropic::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+        #
+        #   @param description [String] Description of what this tool does.
+        #
+        #   @param type [Symbol, Anthropic::Beta::BetaTool::Type, nil]
+
+        # @see Anthropic::Beta::BetaTool#input_schema
+        class InputSchema < Anthropic::Internal::Type::BaseModel
+          # @!attribute type
+          #
+          #   @return [Symbol, :object]
+          required :type, const: :object
+
+          # @!attribute properties
+          #
+          #   @return [Object, nil]
+          optional :properties, Anthropic::Internal::Type::Unknown, nil?: true
+
+          # @!method initialize(properties: nil, type: :object)
+          #   [JSON schema](https://json-schema.org/draft/2020-12) for this tool's input.
+          #
+          #   This defines the shape of the `input` that your tool accepts and that the model
+          #   will produce.
+          #
+          #   @param properties [Object, nil]
+          #   @param type [Symbol, :object]
+        end
+
+        # @see Anthropic::Beta::BetaTool#type
+        module Type
+          extend Anthropic::Internal::Type::Enum
+
+          CUSTOM = :custom
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+
+    BetaTool = Beta::BetaTool
+  end
+end

data/lib/anthropic/models/beta/beta_tool_bash_20241022.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaToolBash20241022 < Anthropic::Internal::Type::BaseModel
+        # @!attribute name
+        #   Name of the tool.
+        #
+        #   This is how the tool will be called by the model and in `tool_use` blocks.
+        #
+        #   @return [Symbol, :bash]
+        required :name, const: :bash
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :bash_20241022]
+        required :type, const: :bash_20241022
+
+        # @!attribute cache_control
+        #   Create a cache control breakpoint at this content block.
+        #
+        #   @return [Anthropic::Beta::BetaCacheControlEphemeral, nil]
+        optional :cache_control, -> { Anthropic::Beta::BetaCacheControlEphemeral }, nil?: true
+
+        # @!method initialize(cache_control: nil, name: :bash, type: :bash_20241022)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Beta::BetaToolBash20241022} for more details.
+        #
+        #   @param cache_control [Anthropic::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+        #
+        #   @param name [Symbol, :bash] Name of the tool.
+        #
+        #   @param type [Symbol, :bash_20241022]
+      end
+    end
+
+    BetaToolBash20241022 = Beta::BetaToolBash20241022
+  end
+end

data/lib/anthropic/models/beta/beta_tool_bash_20250124.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaToolBash20250124 < Anthropic::Internal::Type::BaseModel
+        # @!attribute name
+        #   Name of the tool.
+        #
+        #   This is how the tool will be called by the model and in `tool_use` blocks.
+        #
+        #   @return [Symbol, :bash]
+        required :name, const: :bash
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :bash_20250124]
+        required :type, const: :bash_20250124
+
+        # @!attribute cache_control
+        #   Create a cache control breakpoint at this content block.
+        #
+        #   @return [Anthropic::Beta::BetaCacheControlEphemeral, nil]
+        optional :cache_control, -> { Anthropic::Beta::BetaCacheControlEphemeral }, nil?: true
+
+        # @!method initialize(cache_control: nil, name: :bash, type: :bash_20250124)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Beta::BetaToolBash20250124} for more details.
+        #
+        #   @param cache_control [Anthropic::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+        #
+        #   @param name [Symbol, :bash] Name of the tool.
+        #
+        #   @param type [Symbol, :bash_20250124]
+      end
+    end
+
+    BetaToolBash20250124 = Beta::BetaToolBash20250124
+  end
+end

data/lib/anthropic/models/beta/beta_tool_choice.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      # How the model should use the provided tools. The model can use a specific tool,
+      # any available tool, decide by itself, or not use tools at all.
+      module BetaToolChoice
+        extend Anthropic::Internal::Type::Union
+
+        discriminator :type
+
+        # The model will automatically decide whether to use tools.
+        variant :auto, -> { Anthropic::Beta::BetaToolChoiceAuto }
+
+        # The model will use any available tools.
+        variant :any, -> { Anthropic::Beta::BetaToolChoiceAny }
+
+        # The model will use the specified tool with `tool_choice.name`.
+        variant :tool, -> { Anthropic::Beta::BetaToolChoiceTool }
+
+        # The model will not be allowed to use tools.
+        variant :none, -> { Anthropic::Beta::BetaToolChoiceNone }
+
+        # @!method self.variants
+        #   @return [Array(Anthropic::Beta::BetaToolChoiceAuto, Anthropic::Beta::BetaToolChoiceAny, Anthropic::Beta::BetaToolChoiceTool, Anthropic::Beta::BetaToolChoiceNone)]
+      end
+    end
+
+    BetaToolChoice = Beta::BetaToolChoice
+  end
+end

data/lib/anthropic/models/beta/beta_tool_choice_any.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaToolChoiceAny < Anthropic::Internal::Type::BaseModel
+        # @!attribute type
+        #
+        #   @return [Symbol, :any]
+        required :type, const: :any
+
+        # @!attribute disable_parallel_tool_use
+        #   Whether to disable parallel tool use.
+        #
+        #   Defaults to `false`. If set to `true`, the model will output exactly one tool
+        #   use.
+        #
+        #   @return [Boolean, nil]
+        optional :disable_parallel_tool_use, Anthropic::Internal::Type::Boolean
+
+        # @!method initialize(disable_parallel_tool_use: nil, type: :any)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Beta::BetaToolChoiceAny} for more details.
+        #
+        #   The model will use any available tools.
+        #
+        #   @param disable_parallel_tool_use [Boolean] Whether to disable parallel tool use.
+        #
+        #   @param type [Symbol, :any]
+      end
+    end
+
+    BetaToolChoiceAny = Beta::BetaToolChoiceAny
+  end
+end

data/lib/anthropic/models/beta/beta_tool_choice_auto.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaToolChoiceAuto < Anthropic::Internal::Type::BaseModel
+        # @!attribute type
+        #
+        #   @return [Symbol, :auto]
+        required :type, const: :auto
+
+        # @!attribute disable_parallel_tool_use
+        #   Whether to disable parallel tool use.
+        #
+        #   Defaults to `false`. If set to `true`, the model will output at most one tool
+        #   use.
+        #
+        #   @return [Boolean, nil]
+        optional :disable_parallel_tool_use, Anthropic::Internal::Type::Boolean
+
+        # @!method initialize(disable_parallel_tool_use: nil, type: :auto)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Beta::BetaToolChoiceAuto} for more details.
+        #
+        #   The model will automatically decide whether to use tools.
+        #
+        #   @param disable_parallel_tool_use [Boolean] Whether to disable parallel tool use.
+        #
+        #   @param type [Symbol, :auto]
+      end
+    end
+
+    BetaToolChoiceAuto = Beta::BetaToolChoiceAuto
+  end
+end

data/lib/anthropic/models/beta/beta_tool_choice_none.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaToolChoiceNone < Anthropic::Internal::Type::BaseModel
+        # @!attribute type
+        #
+        #   @return [Symbol, :none]
+        required :type, const: :none
+
+        # @!method initialize(type: :none)
+        #   The model will not be allowed to use tools.
+        #
+        #   @param type [Symbol, :none]
+      end
+    end
+
+    BetaToolChoiceNone = Beta::BetaToolChoiceNone
+  end
+end

data/lib/anthropic/models/beta/beta_tool_choice_tool.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaToolChoiceTool < Anthropic::Internal::Type::BaseModel
+        # @!attribute name
+        #   The name of the tool to use.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :tool]
+        required :type, const: :tool
+
+        # @!attribute disable_parallel_tool_use
+        #   Whether to disable parallel tool use.
+        #
+        #   Defaults to `false`. If set to `true`, the model will output exactly one tool
+        #   use.
+        #
+        #   @return [Boolean, nil]
+        optional :disable_parallel_tool_use, Anthropic::Internal::Type::Boolean
+
+        # @!method initialize(name:, disable_parallel_tool_use: nil, type: :tool)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Beta::BetaToolChoiceTool} for more details.
+        #
+        #   The model will use the specified tool with `tool_choice.name`.
+        #
+        #   @param name [String] The name of the tool to use.
+        #
+        #   @param disable_parallel_tool_use [Boolean] Whether to disable parallel tool use.
+        #
+        #   @param type [Symbol, :tool]
+      end
+    end
+
+    BetaToolChoiceTool = Beta::BetaToolChoiceTool
+  end
+end

data/lib/anthropic/models/beta/beta_tool_computer_use_20241022.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaToolComputerUse20241022 < Anthropic::Internal::Type::BaseModel
+        # @!attribute display_height_px
+        #   The height of the display in pixels.
+        #
+        #   @return [Integer]
+        required :display_height_px, Integer
+
+        # @!attribute display_width_px
+        #   The width of the display in pixels.
+        #
+        #   @return [Integer]
+        required :display_width_px, Integer
+
+        # @!attribute name
+        #   Name of the tool.
+        #
+        #   This is how the tool will be called by the model and in `tool_use` blocks.
+        #
+        #   @return [Symbol, :computer]
+        required :name, const: :computer
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :computer_20241022]
+        required :type, const: :computer_20241022
+
+        # @!attribute cache_control
+        #   Create a cache control breakpoint at this content block.
+        #
+        #   @return [Anthropic::Beta::BetaCacheControlEphemeral, nil]
+        optional :cache_control, -> { Anthropic::Beta::BetaCacheControlEphemeral }, nil?: true
+
+        # @!attribute display_number
+        #   The X11 display number (e.g. 0, 1) for the display.
+        #
+        #   @return [Integer, nil]
+        optional :display_number, Integer, nil?: true
+
+        # @!method initialize(display_height_px:, display_width_px:, cache_control: nil, display_number: nil, name: :computer, type: :computer_20241022)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Beta::BetaToolComputerUse20241022} for more details.
+        #
+        #   @param display_height_px [Integer] The height of the display in pixels.
+        #
+        #   @param display_width_px [Integer] The width of the display in pixels.
+        #
+        #   @param cache_control [Anthropic::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+        #
+        #   @param display_number [Integer, nil] The X11 display number (e.g. 0, 1) for the display.
+        #
+        #   @param name [Symbol, :computer] Name of the tool.
+        #
+        #   @param type [Symbol, :computer_20241022]
+      end
+    end
+
+    BetaToolComputerUse20241022 = Beta::BetaToolComputerUse20241022
+  end
+end