cadenya 0.37.0 → 0.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ca442fe2d2711e6a485b2a4dd60c5bbd00c7a3557c0a4ceefdb64beae7023f96
-  data.tar.gz: 95863b2994482af8161b07a5d70bc2531939edfc444be20bef0c3ed3d6ea418e
+  metadata.gz: d476228cba96c8a01b39f390fd8fb398e62cea6ca8922b06f8d4192b1274098a
+  data.tar.gz: cc90ef1539b9246e99ea0f9e26b953383bb020fd25f85537445c1afbc3697105
 SHA512:
-  metadata.gz: abe085b7833b0c4b8f1b5cf109345b9c70666edb66b9c403b411c9edb6033e3a829ed7614be2ebd7f5778b504d5f8e445ab94b046ff864d8d376d6ba49025a9a
-  data.tar.gz: 87a3a04f0c8ec732fa3c215306181a8729b6bf2972d0924edc52c559db0e75d4efa91e98e4c3477e37d36674efb764c757593d994bd19a178bbff16cdcae066f
+  metadata.gz: 86308ad83b4a82f733671c19859766677a70bd7ddca427bacdda95c52709596eae0fa176d2418eaa0c219b87c489573941c01fad5391ef959b052dfa87123b6c
+  data.tar.gz: 93c02bb40ac05cb76797eb36b639da1a44d5e4899d7b6e925741cec8438625b5d00fda089b6c449eebe792df1061f70dc6f02ae2133d01d04aa3053053ae52ec

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.39.0 (2026-07-08)
+
+Full Changelog: [v0.38.0...v0.39.0](https://github.com/cadenya/cadenya-ruby/compare/v0.38.0...v0.39.0)
+
+### Features
+
+* **api:** api update ([e6ab66f](https://github.com/cadenya/cadenya-ruby/commit/e6ab66fffe14ee4c081fddbf46922dbbdadbd981))
+
+## 0.38.0 (2026-07-08)
+
+Full Changelog: [v0.37.0...v0.38.0](https://github.com/cadenya/cadenya-ruby/compare/v0.37.0...v0.38.0)
+
+### Features
+
+* **api:** api update ([55059de](https://github.com/cadenya/cadenya-ruby/commit/55059deb9a0e57c8056d9de2545d885216f2f7b3))
+
 ## 0.37.0 (2026-07-08)
 
 Full Changelog: [v0.36.0...v0.37.0](https://github.com/cadenya/cadenya-ruby/compare/v0.36.0...v0.37.0)

data/README.md

@@ -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.37.0"
+gem "cadenya", "~> 0.39.0"
 ```
 
 <!-- x-release-please-end -->

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

@@ -5,26 +5,23 @@ module Cadenya
     module Agents
       class AgentVariationSpecProgressiveDiscovery < Cadenya::Internal::Type::BaseModel
         # @!attribute hints
+        #   Free-text guidance appended to the discoverable-tools appendix in the system
+        #   prompt. Hints steer the model's choice of tool names; they do not filter or rank
+        #   anything, because tool_search matches names exactly rather than searching.
         #
         #   @return [Array<String>, nil]
         optional :hints, Cadenya::Internal::Type::ArrayOf[String]
 
         # @!attribute max_tools
+        #   The most tool names tool_search will load in a single call. Requesting more than
+        #   this returns an error telling the model to retry in smaller batches -- it is a
+        #   per-call batch limit, not a ceiling on how many tools an objective may end up
+        #   with.
         #
         #   @return [Integer, nil]
         optional :max_tools, Integer, api_name: :maxTools
 
-        # @!attribute rerank_threshold
-        #   Rerank Threshold is an optional value that instructs whether or not to run a
-        #   search result through a embedding/reranker process which can improve performance
-        #   and reduce context bloat when tools reach the configured threshold. If a tool
-        #   match must exceed 0.8, for example, the tool very closely match the query the
-        #   tool search performed.
-        #
-        #   @return [Float, nil]
-        optional :rerank_threshold, Float, api_name: :rerankThreshold
-
-        # @!method initialize(hints: nil, max_tools: nil, rerank_threshold: nil)
+        # @!method initialize(hints: nil, max_tools: nil)
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Agents::AgentVariationSpecProgressiveDiscovery} for more
         #   details.
@@ -35,11 +32,9 @@ module Cadenya
         #   tool search. These are used in conjunction with the context-aware tool search
         #   and can help select the best tools for the task.
         #
-        #   @param hints [Array<String>]
-        #
-        #   @param max_tools [Integer]
+        #   @param hints [Array<String>] Free-text guidance appended to the discoverable-tools appendix in the
         #
-        #   @param rerank_threshold [Float] Rerank Threshold is an optional value that instructs whether or not to run a sea
+        #   @param max_tools [Integer] The most tool names tool_search will load in a single call. Requesting more
       end
     end
 

data/lib/cadenya/models/context_lengths.rb

@@ -5,50 +5,52 @@ module Cadenya
     class ContextLengths < Cadenya::Internal::Type::BaseModel
       response_only do
         # @!attribute assistant_messages
-        #   Chat history messages with the assistant role.
+        #   Character length of the chat history messages with the assistant role.
         #
         #   @return [Integer]
         required :assistant_messages, Integer, api_name: :assistantMessages
 
         # @!attribute available_tools
-        #   The discoverable/available-tools appendix attached to the system prompt.
+        #   Character length of the discoverable/available-tools appendix attached to the
+        #   system prompt.
         #
         #   @return [Integer]
         required :available_tools, Integer, api_name: :availableTools
 
         # @!attribute episodic_memory
-        #   The episodic memory appendix attached to the system prompt.
+        #   Character length of the episodic memory appendix attached to the system prompt.
         #
         #   @return [Integer]
         required :episodic_memory, Integer, api_name: :episodicMemory
 
         # @!attribute skills_memory
-        #   The skills memory appendix attached to the system prompt.
+        #   Character length of the skills memory appendix attached to the system prompt.
         #
         #   @return [Integer]
         required :skills_memory, Integer, api_name: :skillsMemory
 
         # @!attribute system_prompt
-        #   The objective's base system prompt (rendered variation template).
+        #   Character length of the objective's base system prompt (rendered variation
+        #   template). Not tokens -- see the message comment.
         #
         #   @return [Integer]
         required :system_prompt, Integer, api_name: :systemPrompt
 
         # @!attribute tool_definitions
-        #   Serialized tool definitions sent with the completion request (names,
-        #   descriptions, and JSON-schema parameters).
+        #   Character length of the serialized tool definitions sent with the completion
+        #   request (names, descriptions, and JSON-schema parameters).
         #
         #   @return [Integer]
         required :tool_definitions, Integer, api_name: :toolDefinitions
 
         # @!attribute tool_results
-        #   Tool results present in the chat history.
+        #   Character length of the tool results present in the chat history.
         #
         #   @return [Integer]
         required :tool_results, Integer, api_name: :toolResults
 
         # @!attribute user_messages
-        #   Chat history messages with the user role.
+        #   Character length of the chat history messages with the user role.
         #
         #   @return [Integer]
         required :user_messages, Integer, api_name: :userMessages
@@ -67,21 +69,21 @@ module Cadenya
       #   New components are added as new fields — wire-compatible; absent components read
       #   as 0.
       #
-      #   @param assistant_messages [Integer] Chat history messages with the assistant role.
+      #   @param assistant_messages [Integer] Character length of the chat history messages with the assistant role.
       #
-      #   @param available_tools [Integer] The discoverable/available-tools appendix attached to the system prompt.
+      #   @param available_tools [Integer] Character length of the discoverable/available-tools appendix attached to the
       #
-      #   @param episodic_memory [Integer] The episodic memory appendix attached to the system prompt.
+      #   @param episodic_memory [Integer] Character length of the episodic memory appendix attached to the system prompt.
       #
-      #   @param skills_memory [Integer] The skills memory appendix attached to the system prompt.
+      #   @param skills_memory [Integer] Character length of the skills memory appendix attached to the system prompt.
       #
-      #   @param system_prompt [Integer] The objective's base system prompt (rendered variation template).
+      #   @param system_prompt [Integer] Character length of the objective's base system prompt (rendered variation
       #
-      #   @param tool_definitions [Integer] Serialized tool definitions sent with the completion request
+      #   @param tool_definitions [Integer] Character length of the serialized tool definitions sent with the completion
       #
-      #   @param tool_results [Integer] Tool results present in the chat history.
+      #   @param tool_results [Integer] Character length of the tool results present in the chat history.
       #
-      #   @param user_messages [Integer] Chat history messages with the user role.
+      #   @param user_messages [Integer] Character length of the chat history messages with the user role.
     end
   end
 end

data/lib/cadenya/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cadenya
-  VERSION = "0.37.0"
+  VERSION = "0.39.0"
 end

data/rbi/cadenya/models/agents/agent_variation_spec_progressive_discovery.rbi

@@ -15,61 +15,50 @@ module Cadenya
             )
           end
 
+        # Free-text guidance appended to the discoverable-tools appendix in the system
+        # prompt. Hints steer the model's choice of tool names; they do not filter or rank
+        # anything, because tool_search matches names exactly rather than searching.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :hints
 
         sig { params(hints: T::Array[String]).void }
         attr_writer :hints
 
+        # The most tool names tool_search will load in a single call. Requesting more than
+        # this returns an error telling the model to retry in smaller batches -- it is a
+        # per-call batch limit, not a ceiling on how many tools an objective may end up
+        # with.
         sig { returns(T.nilable(Integer)) }
         attr_reader :max_tools
 
         sig { params(max_tools: Integer).void }
         attr_writer :max_tools
 
-        # Rerank Threshold is an optional value that instructs whether or not to run a
-        # search result through a embedding/reranker process which can improve performance
-        # and reduce context bloat when tools reach the configured threshold. If a tool
-        # match must exceed 0.8, for example, the tool very closely match the query the
-        # tool search performed.
-        sig { returns(T.nilable(Float)) }
-        attr_reader :rerank_threshold
-
-        sig { params(rerank_threshold: Float).void }
-        attr_writer :rerank_threshold
-
         # ProgressiveDiscovery is used to indicate that the agent should automatically
         # discover tools that are not explicitly assigned to it. Max tools is the maximum
         # number of tools that can be discovered per search. Hints are optional hints for
         # tool search. These are used in conjunction with the context-aware tool search
         # and can help select the best tools for the task.
         sig do
-          params(
-            hints: T::Array[String],
-            max_tools: Integer,
-            rerank_threshold: Float
-          ).returns(T.attached_class)
+          params(hints: T::Array[String], max_tools: Integer).returns(
+            T.attached_class
+          )
         end
         def self.new(
+          # Free-text guidance appended to the discoverable-tools appendix in the system
+          # prompt. Hints steer the model's choice of tool names; they do not filter or rank
+          # anything, because tool_search matches names exactly rather than searching.
           hints: nil,
-          max_tools: nil,
-          # Rerank Threshold is an optional value that instructs whether or not to run a
-          # search result through a embedding/reranker process which can improve performance
-          # and reduce context bloat when tools reach the configured threshold. If a tool
-          # match must exceed 0.8, for example, the tool very closely match the query the
-          # tool search performed.
-          rerank_threshold: nil
+          # The most tool names tool_search will load in a single call. Requesting more than
+          # this returns an error telling the model to retry in smaller batches -- it is a
+          # per-call batch limit, not a ceiling on how many tools an objective may end up
+          # with.
+          max_tools: nil
         )
         end
 
         sig do
-          override.returns(
-            {
-              hints: T::Array[String],
-              max_tools: Integer,
-              rerank_threshold: Float
-            }
-          )
+          override.returns({ hints: T::Array[String], max_tools: Integer })
         end
         def to_hash
         end

data/rbi/cadenya/models/context_lengths.rbi

@@ -8,36 +8,38 @@ module Cadenya
           T.any(Cadenya::ContextLengths, Cadenya::Internal::AnyHash)
         end
 
-      # Chat history messages with the assistant role.
+      # Character length of the chat history messages with the assistant role.
       sig { returns(Integer) }
       attr_accessor :assistant_messages
 
-      # The discoverable/available-tools appendix attached to the system prompt.
+      # Character length of the discoverable/available-tools appendix attached to the
+      # system prompt.
       sig { returns(Integer) }
       attr_accessor :available_tools
 
-      # The episodic memory appendix attached to the system prompt.
+      # Character length of the episodic memory appendix attached to the system prompt.
       sig { returns(Integer) }
       attr_accessor :episodic_memory
 
-      # The skills memory appendix attached to the system prompt.
+      # Character length of the skills memory appendix attached to the system prompt.
       sig { returns(Integer) }
       attr_accessor :skills_memory
 
-      # The objective's base system prompt (rendered variation template).
+      # Character length of the objective's base system prompt (rendered variation
+      # template). Not tokens -- see the message comment.
       sig { returns(Integer) }
       attr_accessor :system_prompt
 
-      # Serialized tool definitions sent with the completion request (names,
-      # descriptions, and JSON-schema parameters).
+      # Character length of the serialized tool definitions sent with the completion
+      # request (names, descriptions, and JSON-schema parameters).
       sig { returns(Integer) }
       attr_accessor :tool_definitions
 
-      # Tool results present in the chat history.
+      # Character length of the tool results present in the chat history.
       sig { returns(Integer) }
       attr_accessor :tool_results
 
-      # Chat history messages with the user role.
+      # Character length of the chat history messages with the user role.
       sig { returns(Integer) }
       attr_accessor :user_messages
 
@@ -62,22 +64,24 @@ module Cadenya
         ).returns(T.attached_class)
       end
       def self.new(
-        # Chat history messages with the assistant role.
+        # Character length of the chat history messages with the assistant role.
         assistant_messages:,
-        # The discoverable/available-tools appendix attached to the system prompt.
+        # Character length of the discoverable/available-tools appendix attached to the
+        # system prompt.
         available_tools:,
-        # The episodic memory appendix attached to the system prompt.
+        # Character length of the episodic memory appendix attached to the system prompt.
         episodic_memory:,
-        # The skills memory appendix attached to the system prompt.
+        # Character length of the skills memory appendix attached to the system prompt.
         skills_memory:,
-        # The objective's base system prompt (rendered variation template).
+        # Character length of the objective's base system prompt (rendered variation
+        # template). Not tokens -- see the message comment.
         system_prompt:,
-        # Serialized tool definitions sent with the completion request (names,
-        # descriptions, and JSON-schema parameters).
+        # Character length of the serialized tool definitions sent with the completion
+        # request (names, descriptions, and JSON-schema parameters).
         tool_definitions:,
-        # Tool results present in the chat history.
+        # Character length of the tool results present in the chat history.
         tool_results:,
-        # Chat history messages with the user role.
+        # Character length of the chat history messages with the user role.
         user_messages:
       )
       end

data/sig/cadenya/models/agents/agent_variation_spec_progressive_discovery.rbs

@@ -4,7 +4,7 @@ module Cadenya
 
     module Agents
       type agent_variation_spec_progressive_discovery =
-        { hints: ::Array[String], max_tools: Integer, rerank_threshold: Float }
+        { hints: ::Array[String], max_tools: Integer }
 
       class AgentVariationSpecProgressiveDiscovery < Cadenya::Internal::Type::BaseModel
         attr_reader hints: ::Array[String]?
@@ -15,21 +15,9 @@ module Cadenya
 
         def max_tools=: (Integer) -> Integer
 
-        attr_reader rerank_threshold: Float?
+        def initialize: (?hints: ::Array[String], ?max_tools: Integer) -> void
 
-        def rerank_threshold=: (Float) -> Float
-
-        def initialize: (
-          ?hints: ::Array[String],
-          ?max_tools: Integer,
-          ?rerank_threshold: Float
-        ) -> void
-
-        def to_hash: -> {
-          hints: ::Array[String],
-          max_tools: Integer,
-          rerank_threshold: Float
-        }
+        def to_hash: -> { hints: ::Array[String], max_tools: Integer }
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cadenya
 version: !ruby/object:Gem::Version
-  version: 0.37.0
+  version: 0.39.0
 platform: ruby
 authors:
 - Cadenya