cadenya 0.51.1 → 0.52.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eee358f41c4676b08825c038d3f5be16d39d1e3f6530b997b6122f5f278bcd4c
-  data.tar.gz: a51b13f4d27021161b7e6d58f1cc59893ea9172cbc31be2a52f3635d45107b27
+  metadata.gz: 031016da77105ecc74d1c80856344a6f2ea11cb57f07f6bd404909d211da9500
+  data.tar.gz: 3d50d476b619ab95929ccc0de37c637369dd7041dc392ea67846cc839e217781
 SHA512:
-  metadata.gz: 037be4c3e8a660d36912ec09643515e2d3046efe190e299b329616d76f2180f54ad058f421051861b4fd7d5e62427637d528d66fcea476acece02d637b9c13f7
-  data.tar.gz: 95a41747fcd2eb24babb22327c2ef1d1638b11f9bf787a4aa72ff531a1a866363c8edf56daa618c26375a50117ea24f23b223498c3cbbb9b98fc341d95e249d1
+  metadata.gz: 4b40db3b346cee3484aca5508e0ba303964390906542da1b9acf393d86753e2c1905095fddc9d09c8ae15d4f841a0da2b09d69137e29e2c3bba1a7ccf7fd8210
+  data.tar.gz: '0729374eb58115ab3e48792bfb25d577353b8990268fb78aedfd48cd7c997969f5b30b42fd7f2d639e1576a7da2da76926ece09c84a2a2f71da84d434b0c9a83'

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.52.0](https://github.com/cadenya/cadenya-ruby/compare/v0.51.1...v0.52.0) (2026-08-12)
+
+
+### Features
+
+* regenerate from spec with webhooks and discriminator overlays ([#57](https://github.com/cadenya/cadenya-ruby/issues/57)) ([8a05f27](https://github.com/cadenya/cadenya-ruby/commit/8a05f27fedfc351069d2f77baeb501aafac02498))
+* sync SDKs to current API spec and add stlc promote/sync workflows ([8a05f27](https://github.com/cadenya/cadenya-ruby/commit/8a05f27fedfc351069d2f77baeb501aafac02498))
+
+
+### Chores
+
+* disable Lint/UselessTimes (generator emits 1.times with max_retries: 0) ([8a05f27](https://github.com/cadenya/cadenya-ruby/commit/8a05f27fedfc351069d2f77baeb501aafac02498))
+
 ## 0.51.1 (2026-08-06)
 
 Full Changelog: [v0.51.0...v0.51.1](https://github.com/cadenya/cadenya-ruby/compare/v0.51.0...v0.51.1)
@@ -42,7 +55,7 @@ Full Changelog: [v0.47.0...v0.48.0](https://github.com/cadenya/cadenya-ruby/comp
 
 ### Features
 
-* **stlc:** configurable CI runner and private-production-repo support in workflow templates ([efc2777](https://github.com/cadenya/cadenya-ruby/commit/efc2777d7b7623ef2a27c102302c3f192ca642f1))
+* **ci:** configurable CI runner and private-production-repo support in workflow templates ([efc2777](https://github.com/cadenya/cadenya-ruby/commit/efc2777d7b7623ef2a27c102302c3f192ca642f1))
 
 ## 0.47.0 (2026-07-18)
 

data/README.md

@@ -2,7 +2,7 @@
 
 The Cadenya Ruby library provides convenient access to the Cadenya REST API from any Ruby 3.2.0+ application. It ships with comprehensive types & docstrings in Yard, RBS, and RBI – [see below](https://github.com/cadenya/cadenya-ruby#Sorbet) for usage with Sorbet. The standard library's `net/http` is used as the HTTP transport, with connection pooling via the `connection_pool` gem.
 
-It is generated with [Stainless](https://www.stainless.com/).
+This library is maintained by Cadenya, including its coding agents. Community contributions are welcome — see [Contributing](#contributing).
 
 ## Documentation
 
@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "cadenya", "~> 0.51.1"
+gem "cadenya", "~> 0.52.0"
 ```
 
 <!-- x-release-please-end -->

data/SECURITY.md

@@ -2,26 +2,22 @@
 
 ## Reporting Security Issues
 
-This SDK is generated by [Stainless Software Inc](http://stainless.com). Stainless takes security seriously, and encourages you to report any security vulnerability promptly so that appropriate action can be taken.
+We take security seriously, and encourage you to report any security vulnerability promptly so that appropriate action can be taken.
 
-To report a security issue, please contact the Stainless team at security@stainless.com.
+To report a security issue in this SDK, please use [GitHub security advisories](https://github.com/cadenya/cadenya-ruby/security/advisories/new) for this repository.
 
 ## Responsible Disclosure
 
 We appreciate the efforts of security researchers and individuals who help us maintain the security of
-SDKs we generate. If you believe you have found a security vulnerability, please adhere to responsible
+this SDK. If you believe you have found a security vulnerability, please adhere to responsible
 disclosure practices by allowing us a reasonable amount of time to investigate and address the issue
 before making any information public.
 
 ## Reporting Non-SDK Related Security Issues
 
-If you encounter security issues that are not directly related to SDKs but pertain to the services
-or products provided by Cadenya, please follow the respective company's security reporting guidelines.
-
-### Cadenya Terms and Policies
-
-Please contact support@cadenya.com for any questions or concerns regarding the security of our services.
+If you encounter security issues that are not directly related to this SDK but pertain to the services
+or products provided by Cadenya, please contact support@cadenya.com.
 
 ---
 
-Thank you for helping us keep the SDKs and systems they interact with secure.
+Thank you for helping us keep this SDK and the systems it interacts with secure.

data/lib/cadenya/internal/transport/base_client.rb

@@ -15,12 +15,12 @@ module Cadenya
         # rubocop:disable Style/MutableConstant
         PLATFORM_HEADERS =
           {
-            "x-stainless-arch" => Cadenya::Internal::Util.arch,
-            "x-stainless-lang" => "ruby",
-            "x-stainless-os" => Cadenya::Internal::Util.os,
-            "x-stainless-package-version" => Cadenya::VERSION,
-            "x-stainless-runtime" => ::RUBY_ENGINE,
-            "x-stainless-runtime-version" => ::RUBY_ENGINE_VERSION
+            "x-cadenya-arch" => Cadenya::Internal::Util.arch,
+            "x-cadenya-lang" => "ruby",
+            "x-cadenya-os" => Cadenya::Internal::Util.os,
+            "x-cadenya-package-version" => Cadenya::VERSION,
+            "x-cadenya-runtime" => ::RUBY_ENGINE,
+            "x-cadenya-runtime-version" => ::RUBY_ENGINE_VERSION
           }
         # rubocop:enable Style/MutableConstant
 
@@ -228,7 +228,7 @@ module Cadenya
         # @api private
         #
         # @return [String]
-        private def generate_idempotency_key = "stainless-ruby-retry-#{SecureRandom.uuid}"
+        private def generate_idempotency_key = "cadenya-ruby-retry-#{SecureRandom.uuid}"
 
         # @api private
         #
@@ -287,13 +287,13 @@ module Cadenya
             headers[@idempotency_header] = opts.fetch(:idempotency_key) { generate_idempotency_key }
           end
 
-          unless headers.key?("x-stainless-retry-count")
-            headers["x-stainless-retry-count"] = "0"
+          unless headers.key?("x-cadenya-retry-count")
+            headers["x-cadenya-retry-count"] = "0"
           end
 
           timeout = opts.fetch(:timeout, @timeout).to_f.clamp(0..)
-          unless headers.key?("x-stainless-timeout") || timeout.zero?
-            headers["x-stainless-timeout"] = timeout.to_s
+          unless headers.key?("x-cadenya-timeout") || timeout.zero?
+            headers["x-cadenya-timeout"] = timeout.to_s
           end
 
           headers.reject! { |_, v| v.to_s.empty? }
@@ -381,7 +381,7 @@ module Cadenya
           input = {**request.except(:timeout), deadline: Cadenya::Internal::Util.monotonic_secs + timeout}
 
           if send_retry_header
-            headers["x-stainless-retry-count"] = retry_count.to_s
+            headers["x-cadenya-retry-count"] = retry_count.to_s
           end
 
           begin
@@ -490,7 +490,7 @@ module Cadenya
           url = request.fetch(:url)
 
           # Don't send the current retry count in the headers if the caller modified the header defaults.
-          send_retry_header = request.fetch(:headers)["x-stainless-retry-count"] == "0"
+          send_retry_header = request.fetch(:headers)["x-cadenya-retry-count"] == "0"
           status, response, stream = send_request(
             request,
             redirect_count: 0,

data/lib/cadenya/models/agents/agent_variation_spec.rb

@@ -37,7 +37,10 @@ module Cadenya
         optional :first_user_message_template, String, api_name: :firstUserMessageTemplate
 
         # @!attribute model_config
-        #   ModelConfig defines the model configuration for a variation
+        #   ModelConfig defines the model configuration for a variation.
+        #
+        #   Every knob besides model_id is honored only when the assigned model's
+        #   spec.capabilities lists the matching capability.
         #
         #   @return [Cadenya::Models::Agents::AgentVariationSpecModelConfig, nil]
         optional :model_config, -> { Cadenya::Agents::AgentVariationSpecModelConfig }, api_name: :modelConfig
@@ -76,7 +79,7 @@ module Cadenya
         #
         #   @param first_user_message_template [String] Liquid template for the first user message of objectives using this variation.
         #
-        #   @param model_config [Cadenya::Models::Agents::AgentVariationSpecModelConfig] ModelConfig defines the model configuration for a variation
+        #   @param model_config [Cadenya::Models::Agents::AgentVariationSpecModelConfig] ModelConfig defines the model configuration for a variation.
         #
         #   @param progressive_discovery [Cadenya::Models::Agents::AgentVariationSpecProgressiveDiscovery] ProgressiveDiscovery is used to indicate that the agent should automatically dis
         #

data/lib/cadenya/models/agents/agent_variation_spec_model_config.rb

@@ -8,25 +8,94 @@ module Cadenya
         #   The model identifier in family/model format (e.g., "claude/opus-4.6",
         #   "claude/sonnet-4.5")
         #
-        #   @return [String, nil]
-        optional :model_id, String, api_name: :modelId
+        #   @return [String]
+        required :model_id, String, api_name: :modelId
+
+        # @!attribute max_output_tokens
+        #   Cap on output tokens per LLM call. Must not exceed the model's
+        #   spec.max_output_tokens. Requires the model's "maxOutputTokens" capability.
+        #
+        #   @return [Integer, nil]
+        optional :max_output_tokens, Integer, api_name: :maxOutputTokens
+
+        # @!attribute reasoning_effort
+        #   Reasoning effort. Requires the model's "reasoning" capability.
+        #
+        #   @return [Symbol, Cadenya::Models::Agents::AgentVariationSpecModelConfig::ReasoningEffort, nil]
+        optional :reasoning_effort,
+                 enum: -> { Cadenya::Agents::AgentVariationSpecModelConfig::ReasoningEffort },
+                 api_name: :reasoningEffort
+
+        # @!attribute stop_sequences
+        #   Sequences that stop generation when produced. Empty means none. No count cap
+        #   here — providers impose their own limits (surfaced as the "stopSequences"
+        #   capability's `limit` on the model spec), and it is the caller's responsibility
+        #   to stay within the selected model's limit. Requires the model's "stopSequences"
+        #   capability.
+        #
+        #   @return [Array<String>, nil]
+        optional :stop_sequences, Cadenya::Internal::Type::ArrayOf[String], api_name: :stopSequences
 
         # @!attribute temperature
         #   Sampling temperature for model inference (0.0 to 1.0) Lower values produce more
-        #   deterministic outputs, higher values increase randomness
+        #   deterministic outputs, higher values increase randomness. Presence-tracked so a
+        #   deliberate 0.0 (fully deterministic) is distinguishable from unset.
         #
         #   @return [Float, nil]
         optional :temperature, Float
 
-        # @!method initialize(model_id: nil, temperature: nil)
+        # @!attribute top_k
+        #   Only sample from the top_k most likely tokens. Requires the model's "topK"
+        #   capability.
+        #
+        #   @return [Integer, nil]
+        optional :top_k, Integer, api_name: :topK
+
+        # @!attribute top_p
+        #   Nucleus sampling: only tokens comprising the top_p probability mass are
+        #   considered. Requires the model's "topP" capability.
+        #
+        #   @return [Float, nil]
+        optional :top_p, Float, api_name: :topP
+
+        # @!method initialize(model_id:, max_output_tokens: nil, reasoning_effort: nil, stop_sequences: nil, temperature: nil, top_k: nil, top_p: nil)
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Agents::AgentVariationSpecModelConfig} for more details.
         #
-        #   ModelConfig defines the model configuration for a variation
+        #   ModelConfig defines the model configuration for a variation.
+        #
+        #   Every knob besides model_id is honored only when the assigned model's
+        #   spec.capabilities lists the matching capability.
         #
         #   @param model_id [String] The model identifier in family/model format (e.g., "claude/opus-4.6", "claude/so
         #
+        #   @param max_output_tokens [Integer] Cap on output tokens per LLM call. Must not exceed the model's
+        #
+        #   @param reasoning_effort [Symbol, Cadenya::Models::Agents::AgentVariationSpecModelConfig::ReasoningEffort] Reasoning effort. Requires the model's "reasoning" capability.
+        #
+        #   @param stop_sequences [Array<String>] Sequences that stop generation when produced. Empty means none.
+        #
         #   @param temperature [Float] Sampling temperature for model inference (0.0 to 1.0)
+        #
+        #   @param top_k [Integer] Only sample from the top_k most likely tokens.
+        #
+        #   @param top_p [Float] Nucleus sampling: only tokens comprising the top_p probability mass
+
+        # Reasoning effort. Requires the model's "reasoning" capability.
+        #
+        # @see Cadenya::Models::Agents::AgentVariationSpecModelConfig#reasoning_effort
+        module ReasoningEffort
+          extend Cadenya::Internal::Type::Enum
+
+          REASONING_EFFORT_UNSPECIFIED = :REASONING_EFFORT_UNSPECIFIED
+          REASONING_EFFORT_NONE = :REASONING_EFFORT_NONE
+          REASONING_EFFORT_LOW = :REASONING_EFFORT_LOW
+          REASONING_EFFORT_MEDIUM = :REASONING_EFFORT_MEDIUM
+          REASONING_EFFORT_HIGH = :REASONING_EFFORT_HIGH
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
     end
 

data/lib/cadenya/models/capability_max_output_tokens.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @type [Cadenya::Internal::Type::Converter]
+    CapabilityMaxOutputTokens = Cadenya::Internal::Type::Unknown
+  end
+end

data/lib/cadenya/models/capability_reasoning.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class CapabilityReasoning < Cadenya::Internal::Type::BaseModel
+      # @!attribute mode
+      #   How reasoning is enabled for this model. Catalog data used to decide whether
+      #   thinking is requested for objective iterations on this model.
+      #
+      #   @return [Symbol, Cadenya::Models::CapabilityReasoning::Mode, nil]
+      optional :mode, enum: -> { Cadenya::CapabilityReasoning::Mode }
+
+      # @!method initialize(mode: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::CapabilityReasoning} for more details.
+      #
+      #   Reasoning / extended thinking (ModelConfig.reasoning_effort). A model that does
+      #   not reason simply omits this capability.
+      #
+      #   @param mode [Symbol, Cadenya::Models::CapabilityReasoning::Mode] How reasoning is enabled for this model. Catalog data used to decide
+
+      # How reasoning is enabled for this model. Catalog data used to decide whether
+      # thinking is requested for objective iterations on this model.
+      #
+      # @see Cadenya::Models::CapabilityReasoning#mode
+      module Mode
+        extend Cadenya::Internal::Type::Enum
+
+        MODE_UNSPECIFIED = :MODE_UNSPECIFIED
+        MODE_ADAPTIVE = :MODE_ADAPTIVE
+        MODE_BUDGET = :MODE_BUDGET
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/capability_stop_sequences.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class CapabilityStopSequences < Cadenya::Internal::Type::BaseModel
+      # @!attribute limit
+      #   Maximum number of stop sequences the model accepts per request. 0 means the
+      #   provider imposes no meaningful limit.
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!method initialize(limit: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::CapabilityStopSequences} for more details.
+      #
+      #   Custom stop sequences (ModelConfig.stop_sequences).
+      #
+      #   @param limit [Integer] Maximum number of stop sequences the model accepts per request.
+    end
+  end
+end

data/lib/cadenya/models/capability_temperature.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @type [Cadenya::Internal::Type::Converter]
+    CapabilityTemperature = Cadenya::Internal::Type::Unknown
+  end
+end

data/lib/cadenya/models/capability_top_k.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @type [Cadenya::Internal::Type::Converter]
+    CapabilityTopK = Cadenya::Internal::Type::Unknown
+  end
+end

data/lib/cadenya/models/capability_top_p.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @type [Cadenya::Internal::Type::Converter]
+    CapabilityTopP = Cadenya::Internal::Type::Unknown
+  end
+end

data/lib/cadenya/models/model_spec.rb

@@ -15,6 +15,14 @@ module Cadenya
       #   @return [String]
       required :provider, String
 
+      # @!attribute capabilities
+      #   The inference knobs this model supports. Catalog data; drives which ModelConfig
+      #   fields a variation on this model may set. Reasoning support (and its mode) lives
+      #   here too, as the "reasoning" capability.
+      #
+      #   @return [Array<Cadenya::Models::ModelSpecCapabilityTemperature, Cadenya::Models::ModelSpecCapabilityTopP, Cadenya::Models::ModelSpecCapabilityTopK, Cadenya::Models::ModelSpecCapabilityStopSequences, Cadenya::Models::ModelSpecCapabilityMaxOutputTokens, Cadenya::Models::ModelSpecCapabilityReasoning>, nil]
+      optional :capabilities, -> { Cadenya::Internal::Type::ArrayOf[union: Cadenya::ModelSpecCapability] }
+
       # @!attribute input_price_per_million_tokens
       #   Cost per million input tokens in cents (e.g., 300 = $3.00)
       #
@@ -39,14 +47,7 @@ module Cadenya
       #   @return [String, nil]
       optional :output_price_per_million_tokens, String, api_name: :outputPricePerMillionTokens
 
-      # @!attribute reasoning
-      #   The model's reasoning capability. Catalog data used to decide whether thinking
-      #   is requested for objective iterations on this model.
-      #
-      #   @return [Symbol, Cadenya::Models::ModelSpec::Reasoning, nil]
-      optional :reasoning, enum: -> { Cadenya::ModelSpec::Reasoning }
-
-      # @!method initialize(family:, provider:, input_price_per_million_tokens: nil, max_input_tokens: nil, max_output_tokens: nil, output_price_per_million_tokens: nil, reasoning: nil)
+      # @!method initialize(family:, provider:, capabilities: nil, input_price_per_million_tokens: nil, max_input_tokens: nil, max_output_tokens: nil, output_price_per_million_tokens: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ModelSpec} for more details.
       #
@@ -54,6 +55,8 @@ module Cadenya
       #
       #   @param provider [String] The model provider (e.g., "anthropic", "openai", "google")
       #
+      #   @param capabilities [Array<Cadenya::Models::ModelSpecCapabilityTemperature, Cadenya::Models::ModelSpecCapabilityTopP, Cadenya::Models::ModelSpecCapabilityTopK, Cadenya::Models::ModelSpecCapabilityStopSequences, Cadenya::Models::ModelSpecCapabilityMaxOutputTokens, Cadenya::Models::ModelSpecCapabilityReasoning>] The inference knobs this model supports. Catalog data; drives which
+      #
       #   @param input_price_per_million_tokens [String] Cost per million input tokens in cents (e.g., 300 = $3.00)
       #
       #   @param max_input_tokens [Integer] Maximum number of input tokens the model supports
@@ -61,24 +64,6 @@ module Cadenya
       #   @param max_output_tokens [Integer] Maximum number of output tokens the model can generate
       #
       #   @param output_price_per_million_tokens [String] Cost per million output tokens in cents (e.g., 1500 = $15.00)
-      #
-      #   @param reasoning [Symbol, Cadenya::Models::ModelSpec::Reasoning] The model's reasoning capability. Catalog data used to decide whether
-
-      # The model's reasoning capability. Catalog data used to decide whether thinking
-      # is requested for objective iterations on this model.
-      #
-      # @see Cadenya::Models::ModelSpec#reasoning
-      module Reasoning
-        extend Cadenya::Internal::Type::Enum
-
-        REASONING_UNSPECIFIED = :REASONING_UNSPECIFIED
-        REASONING_NONE = :REASONING_NONE
-        REASONING_ADAPTIVE = :REASONING_ADAPTIVE
-        REASONING_BUDGET = :REASONING_BUDGET
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
     end
   end
 end

data/lib/cadenya/models/model_spec_capability.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # Capability describes one inference knob this model supports, with any
+    # model-specific parameters for it. A variation's ModelConfig may only set a knob
+    # whose capability is listed on the model's spec.
+    module ModelSpecCapability
+      extend Cadenya::Internal::Type::Union
+
+      discriminator :type
+
+      variant :temperature, -> { Cadenya::ModelSpecCapabilityTemperature }
+
+      variant :topP, -> { Cadenya::ModelSpecCapabilityTopP }
+
+      variant :topK, -> { Cadenya::ModelSpecCapabilityTopK }
+
+      variant :stopSequences, -> { Cadenya::ModelSpecCapabilityStopSequences }
+
+      variant :maxOutputTokens, -> { Cadenya::ModelSpecCapabilityMaxOutputTokens }
+
+      variant :reasoning, -> { Cadenya::ModelSpecCapabilityReasoning }
+
+      # @!method self.variants
+      #   @return [Array(Cadenya::Models::ModelSpecCapabilityTemperature, Cadenya::Models::ModelSpecCapabilityTopP, Cadenya::Models::ModelSpecCapabilityTopK, Cadenya::Models::ModelSpecCapabilityStopSequences, Cadenya::Models::ModelSpecCapabilityMaxOutputTokens, Cadenya::Models::ModelSpecCapabilityReasoning)]
+    end
+  end
+end

data/lib/cadenya/models/model_spec_capability_max_output_tokens.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ModelSpecCapabilityMaxOutputTokens < Cadenya::Internal::Type::BaseModel
+      # @!attribute max_output_tokens
+      #   Per-request output token cap (ModelConfig.max_output_tokens). The effective
+      #   ceiling is ModelSpec.max_output_tokens.
+      #
+      #   @return [Object]
+      required :max_output_tokens, Cadenya::Internal::Type::Unknown, api_name: :maxOutputTokens
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Cadenya::Models::ModelSpecCapabilityMaxOutputTokens::Type]
+      required :type, enum: -> { Cadenya::ModelSpecCapabilityMaxOutputTokens::Type }
+
+      # @!method initialize(max_output_tokens:, type:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ModelSpecCapabilityMaxOutputTokens} for more details.
+      #
+      #   @param max_output_tokens [Object] Per-request output token cap (ModelConfig.max_output_tokens).
+      #
+      #   @param type [Symbol, Cadenya::Models::ModelSpecCapabilityMaxOutputTokens::Type]
+
+      # @see Cadenya::Models::ModelSpecCapabilityMaxOutputTokens#type
+      module Type
+        extend Cadenya::Internal::Type::Enum
+
+        MAX_OUTPUT_TOKENS = :maxOutputTokens
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/model_spec_capability_reasoning.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ModelSpecCapabilityReasoning < Cadenya::Internal::Type::BaseModel
+      # @!attribute reasoning
+      #   Reasoning / extended thinking (ModelConfig.reasoning_effort). A model that does
+      #   not reason simply omits this capability.
+      #
+      #   @return [Cadenya::Models::CapabilityReasoning]
+      required :reasoning, -> { Cadenya::CapabilityReasoning }
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Cadenya::Models::ModelSpecCapabilityReasoning::Type]
+      required :type, enum: -> { Cadenya::ModelSpecCapabilityReasoning::Type }
+
+      # @!method initialize(reasoning:, type:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ModelSpecCapabilityReasoning} for more details.
+      #
+      #   @param reasoning [Cadenya::Models::CapabilityReasoning] Reasoning / extended thinking (ModelConfig.reasoning_effort). A model
+      #
+      #   @param type [Symbol, Cadenya::Models::ModelSpecCapabilityReasoning::Type]
+
+      # @see Cadenya::Models::ModelSpecCapabilityReasoning#type
+      module Type
+        extend Cadenya::Internal::Type::Enum
+
+        REASONING = :reasoning
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/model_spec_capability_stop_sequences.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ModelSpecCapabilityStopSequences < Cadenya::Internal::Type::BaseModel
+      # @!attribute stop_sequences
+      #   Custom stop sequences (ModelConfig.stop_sequences).
+      #
+      #   @return [Cadenya::Models::CapabilityStopSequences]
+      required :stop_sequences, -> { Cadenya::CapabilityStopSequences }, api_name: :stopSequences
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Cadenya::Models::ModelSpecCapabilityStopSequences::Type]
+      required :type, enum: -> { Cadenya::ModelSpecCapabilityStopSequences::Type }
+
+      # @!method initialize(stop_sequences:, type:)
+      #   @param stop_sequences [Cadenya::Models::CapabilityStopSequences] Custom stop sequences (ModelConfig.stop_sequences).
+      #
+      #   @param type [Symbol, Cadenya::Models::ModelSpecCapabilityStopSequences::Type]
+
+      # @see Cadenya::Models::ModelSpecCapabilityStopSequences#type
+      module Type
+        extend Cadenya::Internal::Type::Enum
+
+        STOP_SEQUENCES = :stopSequences
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/model_spec_capability_temperature.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ModelSpecCapabilityTemperature < Cadenya::Internal::Type::BaseModel
+      # @!attribute temperature
+      #   Sampling temperature (ModelConfig.temperature).
+      #
+      #   @return [Object]
+      required :temperature, Cadenya::Internal::Type::Unknown
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Cadenya::Models::ModelSpecCapabilityTemperature::Type]
+      required :type, enum: -> { Cadenya::ModelSpecCapabilityTemperature::Type }
+
+      # @!method initialize(temperature:, type:)
+      #   @param temperature [Object] Sampling temperature (ModelConfig.temperature).
+      #
+      #   @param type [Symbol, Cadenya::Models::ModelSpecCapabilityTemperature::Type]
+
+      # @see Cadenya::Models::ModelSpecCapabilityTemperature#type
+      module Type
+        extend Cadenya::Internal::Type::Enum
+
+        TEMPERATURE = :temperature
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/model_spec_capability_top_k.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ModelSpecCapabilityTopK < Cadenya::Internal::Type::BaseModel
+      # @!attribute top_k
+      #   Top-k sampling (ModelConfig.top_k).
+      #
+      #   @return [Object]
+      required :top_k, Cadenya::Internal::Type::Unknown, api_name: :topK
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Cadenya::Models::ModelSpecCapabilityTopK::Type]
+      required :type, enum: -> { Cadenya::ModelSpecCapabilityTopK::Type }
+
+      # @!method initialize(top_k:, type:)
+      #   @param top_k [Object] Top-k sampling (ModelConfig.top_k).
+      #
+      #   @param type [Symbol, Cadenya::Models::ModelSpecCapabilityTopK::Type]
+
+      # @see Cadenya::Models::ModelSpecCapabilityTopK#type
+      module Type
+        extend Cadenya::Internal::Type::Enum
+
+        TOP_K = :topK
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end