cadenya 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f2d3ccc2b08967b6c09113b9f86077582cecb2ff914643efd624d35f590ee2e9
-  data.tar.gz: 7e2cfc5c58da2c628a855f586bc46aba2b96c936ac13611c3cb0761b54c0e028
+  metadata.gz: '0488a69eb293e3cb4a745c2db7ed2b94aa1b59c82f6e6c1fbee1fa2bf392b216'
+  data.tar.gz: b3dcf3ecdfbbbf92bc8fc62e5293c1f5d456d4ff0341b5e26e0e161a3d630730
 SHA512:
-  metadata.gz: 577b0a9463ee0830ec2f85033e6e858172101ca5580f398c919c4c45b6c5d5867358fa2c3e1dc18f316040ce50bde17065d18991a7bc053a8d4a4dcae936ac54
-  data.tar.gz: 623d30dc59554aeb07440ac9c163fc99ff2cb45120c36601a74133b3cb7cb02301f37b5abcf47addf165eacdc2652254846a81d9bf0f2d02ce49d71ac3f091f3
+  metadata.gz: '0984e2d2b5c3e8aa4865e9048035a67ff75add28a8def45559155bce5d3c07c3efd685a59f8fd4b9e6f067eeb2379d34aabb07d4a93624e82b33eb816e49c2ea'
+  data.tar.gz: ca3bc8d58078c5f0ab8f5968176571bc256433bb230dfdaa4e0abe28b4c673c5ea624bd6038930e7aeb59a8bcf84f8af9c16f4898588430cae636c4ccfb8e985

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.6.0 (2026-06-07)
+
+Full Changelog: [v0.5.0...v0.6.0](https://github.com/cadenya/cadenya-ruby/compare/v0.5.0...v0.6.0)
+
+### Features
+
+* **api:** api update ([28a45e6](https://github.com/cadenya/cadenya-ruby/commit/28a45e61e923a2b1e555c73fe23299d38db83c7e))
+
 ## 0.5.0 (2026-06-07)
 
 Full Changelog: [v0.4.0...v0.5.0](https://github.com/cadenya/cadenya-ruby/compare/v0.4.0...v0.5.0)

data/README.md

@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "cadenya", "~> 0.5.0"
+gem "cadenya", "~> 0.6.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/cadenya/models/model.rb

@@ -37,6 +37,13 @@ module Cadenya
       # @see Cadenya::Models::Model#info
       class Info < Cadenya::Internal::Type::BaseModel
         response_only do
+          # @!attribute agent_variation_count
+          #   Number of agent variations currently provisioned on this model. Useful for
+          #   previewing how many variations a swap would affect.
+          #
+          #   @return [Integer, nil]
+          optional :agent_variation_count, Integer, api_name: :agentVariationCount
+
           # @!attribute ai_provider_key
           #   BareMetadata contains the minimal metadata for a resource: the ID and an
           #   optional human-readable name. These are used for reference fields where the full
@@ -55,12 +62,14 @@ module Cadenya
           optional :provider, enum: -> { Cadenya::Model::Info::Provider }
         end
 
-        # @!method initialize(ai_provider_key: nil, provider: nil)
+        # @!method initialize(agent_variation_count: nil, ai_provider_key: nil, provider: nil)
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Model::Info} for more details.
         #
         #   ModelInfo carries server-derived, read-only details about a model.
         #
+        #   @param agent_variation_count [Integer] Number of agent variations currently provisioned on this model. Useful for
+        #
         #   @param ai_provider_key [Cadenya::Models::BareMetadata] BareMetadata contains the minimal metadata for a resource: the ID and an
         #
         #   @param provider [Symbol, Cadenya::Models::Model::Info::Provider] The AI provider this model routes through (via its provider key).

data/lib/cadenya/models/model_swap_params.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Models#swap
+    class ModelSwapParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      # @!attribute workspace_id
+      #
+      #   @return [String]
+      required :workspace_id, String
+
+      # @!attribute model_swaps
+      #   The swaps to perform.
+      #
+      #   @return [Array<Cadenya::Models::ModelSwapParams::ModelSwap>, nil]
+      optional :model_swaps,
+               -> { Cadenya::Internal::Type::ArrayOf[Cadenya::ModelSwapParams::ModelSwap] },
+               api_name: :modelSwaps
+
+      # @!method initialize(workspace_id:, model_swaps: nil, request_options: {})
+      #   @param workspace_id [String]
+      #
+      #   @param model_swaps [Array<Cadenya::Models::ModelSwapParams::ModelSwap>] The swaps to perform.
+      #
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+
+      class ModelSwap < Cadenya::Internal::Type::BaseModel
+        # @!attribute current_model_id
+        #   The model variations are currently on. Accepts an id or "external_id:" slug.
+        #
+        #   @return [String, nil]
+        optional :current_model_id, String, api_name: :currentModelId
+
+        # @!attribute next_model_id
+        #   The model to move variations to. Accepts an id or "external_id:" slug.
+        #
+        #   @return [String, nil]
+        optional :next_model_id, String, api_name: :nextModelId
+
+        # @!method initialize(current_model_id: nil, next_model_id: nil)
+        #   @param current_model_id [String] The model variations are currently on. Accepts an id or "external_id:" slug.
+        #
+        #   @param next_model_id [String] The model to move variations to. Accepts an id or "external_id:" slug.
+      end
+    end
+  end
+end

data/lib/cadenya/models/model_swap_response.rb

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

data/lib/cadenya/models.rb

@@ -179,6 +179,8 @@ module Cadenya
 
   ModelSpec = Cadenya::Models::ModelSpec
 
+  ModelSwapParams = Cadenya::Models::ModelSwapParams
+
   Objective = Cadenya::Models::Objective
 
   ObjectiveCancelParams = Cadenya::Models::ObjectiveCancelParams

data/lib/cadenya/resources/models.rb

@@ -113,6 +113,31 @@ module Cadenya
         )
       end
 
+      # Reassigns agent variations from one model to another in bulk. Runs
+      # asynchronously and returns immediately.
+      #
+      # @overload swap(workspace_id, model_swaps: nil, request_options: {})
+      #
+      # @param workspace_id [String] Workspace ID.
+      #
+      # @param model_swaps [Array<Cadenya::Models::ModelSwapParams::ModelSwap>] The swaps to perform.
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Object]
+      #
+      # @see Cadenya::Models::ModelSwapParams
+      def swap(workspace_id, params = {})
+        parsed, options = Cadenya::ModelSwapParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["v1/workspaces/%1$s/models:swapModelOnVariations", workspace_id],
+          body: parsed,
+          model: Cadenya::Internal::Type::Unknown,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [Cadenya::Client]

data/lib/cadenya/version.rb

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

data/lib/cadenya.rb

@@ -183,6 +183,8 @@ require_relative "cadenya/models/model_list_params"
 require_relative "cadenya/models/model_retrieve_params"
 require_relative "cadenya/models/model_set_status_params"
 require_relative "cadenya/models/model_spec"
+require_relative "cadenya/models/model_swap_params"
+require_relative "cadenya/models/model_swap_response"
 require_relative "cadenya/models/objective"
 require_relative "cadenya/models/objective_cancel_params"
 require_relative "cadenya/models/objective_compact_params"

data/rbi/cadenya/models/model.rbi

@@ -62,6 +62,14 @@ module Cadenya
             T.any(Cadenya::Model::Info, Cadenya::Internal::AnyHash)
           end
 
+        # Number of agent variations currently provisioned on this model. Useful for
+        # previewing how many variations a swap would affect.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :agent_variation_count
+
+        sig { params(agent_variation_count: Integer).void }
+        attr_writer :agent_variation_count
+
         # BareMetadata contains the minimal metadata for a resource: the ID and an
         # optional human-readable name. These are used for reference fields where the full
         # metadata (account scoping, timestamps, labels, external IDs) is not needed —
@@ -84,11 +92,15 @@ module Cadenya
         # ModelInfo carries server-derived, read-only details about a model.
         sig do
           params(
+            agent_variation_count: Integer,
             ai_provider_key: Cadenya::BareMetadata::OrHash,
             provider: Cadenya::Model::Info::Provider::OrSymbol
           ).returns(T.attached_class)
         end
         def self.new(
+          # Number of agent variations currently provisioned on this model. Useful for
+          # previewing how many variations a swap would affect.
+          agent_variation_count: nil,
           # BareMetadata contains the minimal metadata for a resource: the ID and an
           # optional human-readable name. These are used for reference fields where the full
           # metadata (account scoping, timestamps, labels, external IDs) is not needed —
@@ -104,6 +116,7 @@ module Cadenya
         sig do
           override.returns(
             {
+              agent_variation_count: Integer,
               ai_provider_key: Cadenya::BareMetadata,
               provider: Cadenya::Model::Info::Provider::TaggedSymbol
             }

data/rbi/cadenya/models/model_swap_params.rbi

@@ -0,0 +1,99 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class ModelSwapParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::ModelSwapParams, Cadenya::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :workspace_id
+
+      # The swaps to perform.
+      sig { returns(T.nilable(T::Array[Cadenya::ModelSwapParams::ModelSwap])) }
+      attr_reader :model_swaps
+
+      sig do
+        params(
+          model_swaps: T::Array[Cadenya::ModelSwapParams::ModelSwap::OrHash]
+        ).void
+      end
+      attr_writer :model_swaps
+
+      sig do
+        params(
+          workspace_id: String,
+          model_swaps: T::Array[Cadenya::ModelSwapParams::ModelSwap::OrHash],
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        workspace_id:,
+        # The swaps to perform.
+        model_swaps: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            workspace_id: String,
+            model_swaps: T::Array[Cadenya::ModelSwapParams::ModelSwap],
+            request_options: Cadenya::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class ModelSwap < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::ModelSwapParams::ModelSwap,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # The model variations are currently on. Accepts an id or "external_id:" slug.
+        sig { returns(T.nilable(String)) }
+        attr_reader :current_model_id
+
+        sig { params(current_model_id: String).void }
+        attr_writer :current_model_id
+
+        # The model to move variations to. Accepts an id or "external_id:" slug.
+        sig { returns(T.nilable(String)) }
+        attr_reader :next_model_id
+
+        sig { params(next_model_id: String).void }
+        attr_writer :next_model_id
+
+        sig do
+          params(current_model_id: String, next_model_id: String).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # The model variations are currently on. Accepts an id or "external_id:" slug.
+          current_model_id: nil,
+          # The model to move variations to. Accepts an id or "external_id:" slug.
+          next_model_id: nil
+        )
+        end
+
+        sig do
+          override.returns({ current_model_id: String, next_model_id: String })
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/model_swap_response.rbi

@@ -0,0 +1,7 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    ModelSwapResponse = T.let(T.anything, Cadenya::Internal::Type::Converter)
+  end
+end

data/rbi/cadenya/models.rbi

@@ -145,6 +145,8 @@ module Cadenya
 
   ModelSpec = Cadenya::Models::ModelSpec
 
+  ModelSwapParams = Cadenya::Models::ModelSwapParams
+
   Objective = Cadenya::Models::Objective
 
   ObjectiveCancelParams = Cadenya::Models::ObjectiveCancelParams

data/rbi/cadenya/resources/models.rbi

@@ -86,6 +86,24 @@ module Cadenya
       )
       end
 
+      # Reassigns agent variations from one model to another in bulk. Runs
+      # asynchronously and returns immediately.
+      sig do
+        params(
+          workspace_id: String,
+          model_swaps: T::Array[Cadenya::ModelSwapParams::ModelSwap::OrHash],
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(T.anything)
+      end
+      def swap(
+        # Workspace ID.
+        workspace_id,
+        # The swaps to perform.
+        model_swaps: nil,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: Cadenya::Client).returns(T.attached_class) }
       def self.new(client:)

data/sig/cadenya/models/model.rbs

@@ -30,11 +30,16 @@ module Cadenya
 
       type info =
         {
+          agent_variation_count: Integer,
           ai_provider_key: Cadenya::BareMetadata,
           provider: Cadenya::Models::Model::Info::provider
         }
 
       class Info < Cadenya::Internal::Type::BaseModel
+        attr_reader agent_variation_count: Integer?
+
+        def agent_variation_count=: (Integer) -> Integer
+
         attr_reader ai_provider_key: Cadenya::BareMetadata?
 
         def ai_provider_key=: (Cadenya::BareMetadata) -> Cadenya::BareMetadata
@@ -46,11 +51,13 @@ module Cadenya
         ) -> Cadenya::Models::Model::Info::provider
 
         def initialize: (
+          ?agent_variation_count: Integer,
           ?ai_provider_key: Cadenya::BareMetadata,
           ?provider: Cadenya::Models::Model::Info::provider
         ) -> void
 
         def to_hash: -> {
+          agent_variation_count: Integer,
           ai_provider_key: Cadenya::BareMetadata,
           provider: Cadenya::Models::Model::Info::provider
         }

data/sig/cadenya/models/model_swap_params.rbs

@@ -0,0 +1,54 @@
+module Cadenya
+  module Models
+    type model_swap_params =
+      {
+        workspace_id: String,
+        model_swaps: ::Array[Cadenya::ModelSwapParams::ModelSwap]
+      }
+      & Cadenya::Internal::Type::request_parameters
+
+    class ModelSwapParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      attr_accessor workspace_id: String
+
+      attr_reader model_swaps: ::Array[Cadenya::ModelSwapParams::ModelSwap]?
+
+      def model_swaps=: (
+        ::Array[Cadenya::ModelSwapParams::ModelSwap]
+      ) -> ::Array[Cadenya::ModelSwapParams::ModelSwap]
+
+      def initialize: (
+        workspace_id: String,
+        ?model_swaps: ::Array[Cadenya::ModelSwapParams::ModelSwap],
+        ?request_options: Cadenya::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        workspace_id: String,
+        model_swaps: ::Array[Cadenya::ModelSwapParams::ModelSwap],
+        request_options: Cadenya::RequestOptions
+      }
+
+      type model_swap = { current_model_id: String, next_model_id: String }
+
+      class ModelSwap < Cadenya::Internal::Type::BaseModel
+        attr_reader current_model_id: String?
+
+        def current_model_id=: (String) -> String
+
+        attr_reader next_model_id: String?
+
+        def next_model_id=: (String) -> String
+
+        def initialize: (
+          ?current_model_id: String,
+          ?next_model_id: String
+        ) -> void
+
+        def to_hash: -> { current_model_id: String, next_model_id: String }
+      end
+    end
+  end
+end

data/sig/cadenya/models/model_swap_response.rbs

@@ -0,0 +1,5 @@
+module Cadenya
+  module Models
+    ModelSwapResponse: Cadenya::Internal::Type::Converter
+  end
+end

data/sig/cadenya/models.rbs

@@ -139,6 +139,8 @@ module Cadenya
 
   class ModelSpec = Cadenya::Models::ModelSpec
 
+  class ModelSwapParams = Cadenya::Models::ModelSwapParams
+
   class Objective = Cadenya::Models::Objective
 
   class ObjectiveCancelParams = Cadenya::Models::ObjectiveCancelParams

data/sig/cadenya/resources/models.rbs

@@ -28,6 +28,12 @@ module Cadenya
         ?request_options: Cadenya::request_opts
       ) -> Cadenya::Model
 
+      def swap: (
+        String workspace_id,
+        ?model_swaps: ::Array[Cadenya::ModelSwapParams::ModelSwap],
+        ?request_options: Cadenya::request_opts
+      ) -> top
+
       def initialize: (client: Cadenya::Client) -> void
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cadenya
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Cadenya
@@ -213,6 +213,8 @@ files:
 - lib/cadenya/models/model_retrieve_params.rb
 - lib/cadenya/models/model_set_status_params.rb
 - lib/cadenya/models/model_spec.rb
+- lib/cadenya/models/model_swap_params.rb
+- lib/cadenya/models/model_swap_response.rb
 - lib/cadenya/models/objective.rb
 - lib/cadenya/models/objective_cancel_params.rb
 - lib/cadenya/models/objective_compact_params.rb
@@ -520,6 +522,8 @@ files:
 - rbi/cadenya/models/model_retrieve_params.rbi
 - rbi/cadenya/models/model_set_status_params.rbi
 - rbi/cadenya/models/model_spec.rbi
+- rbi/cadenya/models/model_swap_params.rbi
+- rbi/cadenya/models/model_swap_response.rbi
 - rbi/cadenya/models/objective.rbi
 - rbi/cadenya/models/objective_cancel_params.rbi
 - rbi/cadenya/models/objective_compact_params.rbi
@@ -826,6 +830,8 @@ files:
 - sig/cadenya/models/model_retrieve_params.rbs
 - sig/cadenya/models/model_set_status_params.rbs
 - sig/cadenya/models/model_spec.rbs
+- sig/cadenya/models/model_swap_params.rbs
+- sig/cadenya/models/model_swap_response.rbs
 - sig/cadenya/models/objective.rbs
 - sig/cadenya/models/objective_cancel_params.rbs
 - sig/cadenya/models/objective_compact_params.rbs