cadenya 0.16.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ae6a3e7de7658dc3909f5b116f10952737be338c529999a20c5678f9da27512b
-  data.tar.gz: 3009569366c92b99760b8caea39f18bb848bf8c6f57ff4fc697cb07a6a7032ed
+  metadata.gz: 95ccbe7ef557fb4d1a576ba7483e09020bc0d2c026df9f46ed23f1f49eccd13f
+  data.tar.gz: a781fcd75e6729b264dea552d6aa92b1d57595437cc02842d101349f04da7a3b
 SHA512:
-  metadata.gz: 7dbc099db32c64a045d6468124176665f3a86c431a4f014e0289372bad2475f2fd0095583a441810c59b86990049bc3dee004383f3db5858659541126911d87c
-  data.tar.gz: fc2609020e4791914a3eb6259f8403039c82ae6cd9756bc680cbbbda589c583927805dfd115c1bba72a3b92d6b2500ba8141cf015b6a64e73b902891d764b811
+  metadata.gz: 756a4245fc74b038820f35a617a383558455c2c430e522d61576d2d08ae79db93636fec67feca574094bdbbfe5d82a1966467fc5beb1336a998c6952384c9c9f
+  data.tar.gz: 9c538148f62bbfc2c22d7de12e14b426600a24a0a769782998c3f01af4fa6699809dedf204a6c1b0fbce91b7ffc714bf13406d718bb42d9a3fb50eba4a085d28

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.17.0 (2026-06-12)
+
+Full Changelog: [v0.16.0...v0.17.0](https://github.com/cadenya/cadenya-ruby/compare/v0.16.0...v0.17.0)
+
+### Features
+
+* **api:** api update ([6a0f6da](https://github.com/cadenya/cadenya-ruby/commit/6a0f6da77dd3f34b582c40acc9971286bd5ff00f))
+
 ## 0.16.0 (2026-06-12)
 
 Full Changelog: [v0.15.0...v0.16.0](https://github.com/cadenya/cadenya-ruby/compare/v0.15.0...v0.16.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.16.0"
+gem "cadenya", "~> 0.17.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/cadenya/models/ai_provider_key.rb

@@ -28,8 +28,10 @@ module Cadenya
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::AIProviderKey} for more details.
       #
-      #   AIProviderKey is a customer-provided (BYOK) credential for an AI provider,
-      #   scoped to a workspace. The secret value is never returned in responses.
+      #   AIProviderKey is a credential for an AI provider, scoped to a workspace. Most
+      #   keys are customer-provided (BYOK); Cadenya also provisions promotional keys (see
+      #   AIProviderKeyInfo.is_promotional), which cannot be modified or deleted by
+      #   account administrators. The secret value is never returned in responses.
       #
       #   @param metadata [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
       #
@@ -51,15 +53,27 @@ module Cadenya
           #
           #   @return [Integer, nil]
           optional :enabled_model_count, Integer, api_name: :enabledModelCount
+
+          # @!attribute is_promotional
+          #   Cadenya includes promotional keys (one for onboarding, and potentially more in
+          #   the future). These are not added or maintained by account administrators.
+          #
+          #   @return [Boolean, nil]
+          optional :is_promotional, Cadenya::Internal::Type::Boolean, api_name: :isPromotional
         end
 
-        # @!method initialize(disabled_model_count: nil, enabled_model_count: nil)
+        # @!method initialize(disabled_model_count: nil, enabled_model_count: nil, is_promotional: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::AIProviderKey::Info} for more details.
+        #
         #   AIProviderKeyInfo carries server-derived, read-only details about a key, for AI
         #   provider management UIs.
         #
         #   @param disabled_model_count [Integer] Number of disabled models provisioned on this key.
         #
         #   @param enabled_model_count [Integer] Number of enabled models provisioned on this key.
+        #
+        #   @param is_promotional [Boolean] Cadenya includes promotional keys (one for onboarding, and potentially more in t
       end
     end
   end

data/lib/cadenya/models/ai_provider_key_list_params.rb

@@ -37,6 +37,14 @@ module Cadenya
       #   @return [String, nil]
       optional :prefix, String
 
+      # @!attribute promotional
+      #   When true, return only promotional keys (provided by Cadenya, e.g. for
+      #   onboarding). Defaults to returning all keys, customer-provided and promotional
+      #   alike.
+      #
+      #   @return [Boolean, nil]
+      optional :promotional, Cadenya::Internal::Type::Boolean
+
       # @!attribute query
       #   Free-form search query
       #
@@ -49,7 +57,7 @@ module Cadenya
       #   @return [String, nil]
       optional :sort_order, String
 
-      # @!method initialize(workspace_id:, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, request_options: {})
+      # @!method initialize(workspace_id:, cursor: nil, include_info: nil, limit: nil, prefix: nil, promotional: nil, query: nil, sort_order: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::AIProviderKeyListParams} for more details.
       #
@@ -63,6 +71,8 @@ module Cadenya
       #
       #   @param prefix [String] Filter expression (query param: prefix)
       #
+      #   @param promotional [Boolean] When true, return only promotional keys (provided by Cadenya, e.g. for
+      #
       #   @param query [String] Free-form search query
       #
       #   @param sort_order [String] Sort order for results (asc or desc by creation time)

data/lib/cadenya/models/model.rb

@@ -69,19 +69,22 @@ module Cadenya
           optional :agent_variation_count, Integer, api_name: :agentVariationCount
 
           # @!attribute ai_provider_key
-          #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+          #   AIProviderKey is a credential for an AI provider, scoped to a workspace. Most
+          #   keys are customer-provided (BYOK); Cadenya also provisions promotional keys (see
+          #   AIProviderKeyInfo.is_promotional), which cannot be modified or deleted by
+          #   account administrators. The secret value is never returned in responses.
           #
-          #   @return [Cadenya::Models::ResourceMetadata, nil]
-          optional :ai_provider_key, -> { Cadenya::ResourceMetadata }, api_name: :aiProviderKey
+          #   @return [Cadenya::Models::AIProviderKey, nil]
+          optional :ai_provider_key, -> { Cadenya::AIProviderKey }, api_name: :aiProviderKey
 
-          # @!attribute provider
-          #   The AI provider this model routes through (via its provider key).
+          # @!attribute last_used_at
+          #   Represents the last time this model was used in an agent objective
           #
-          #   @return [Symbol, Cadenya::Models::Model::Info::Provider, nil]
-          optional :provider, enum: -> { Cadenya::Model::Info::Provider }
+          #   @return [Time, nil]
+          optional :last_used_at, Time, api_name: :lastUsedAt
         end
 
-        # @!method initialize(agent_variation_count: nil, ai_provider_key: nil, provider: nil)
+        # @!method initialize(agent_variation_count: nil, ai_provider_key: nil, last_used_at: nil)
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Model::Info} for more details.
         #
@@ -89,22 +92,9 @@ module Cadenya
         #
         #   @param agent_variation_count [Integer] Number of agent variations currently provisioned on this model. Useful for
         #
-        #   @param ai_provider_key [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        #   @param ai_provider_key [Cadenya::Models::AIProviderKey] AIProviderKey is a credential for an AI provider, scoped to a workspace.
         #
-        #   @param provider [Symbol, Cadenya::Models::Model::Info::Provider] The AI provider this model routes through (via its provider key).
-
-        # The AI provider this model routes through (via its provider key).
-        #
-        # @see Cadenya::Models::Model::Info#provider
-        module Provider
-          extend Cadenya::Internal::Type::Enum
-
-          AI_PROVIDER_UNSPECIFIED = :AI_PROVIDER_UNSPECIFIED
-          AI_PROVIDER_OPENROUTER = :AI_PROVIDER_OPENROUTER
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
+        #   @param last_used_at [Time] Represents the last time this model was used in an agent objective
       end
     end
   end

data/lib/cadenya/models/model_list_params.rb

@@ -38,6 +38,14 @@ module Cadenya
       #   @return [Boolean, nil]
       optional :include_info, Cadenya::Internal::Type::Boolean
 
+      # @!attribute is_assigned
+      #   Filter models to only ones assigned to an active agent variation/agent. Draft
+      #   agents count as assigned; archived agents do not. Assignment does not imply
+      #   recent traffic — see ModelInfo.last_used_at for that.
+      #
+      #   @return [Boolean, nil]
+      optional :is_assigned, Cadenya::Internal::Type::Boolean
+
       # @!attribute limit
       #   Maximum number of results to return
       #
@@ -68,7 +76,7 @@ module Cadenya
       #   @return [Symbol, Cadenya::Models::ModelListParams::State, nil]
       optional :state, enum: -> { Cadenya::ModelListParams::State }
 
-      # @!method initialize(workspace_id:, ai_provider_key_id: nil, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, state: nil, request_options: {})
+      # @!method initialize(workspace_id:, ai_provider_key_id: nil, bundle_key: nil, cursor: nil, include_info: nil, is_assigned: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, state: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ModelListParams} for more details.
       #
@@ -82,6 +90,8 @@ module Cadenya
       #
       #   @param include_info [Boolean] When true, populate each item's info (e.g. the AI provider), at the cost of
       #
+      #   @param is_assigned [Boolean] Filter models to only ones assigned to an active agent variation/agent.
+      #
       #   @param limit [Integer] Maximum number of results to return
       #
       #   @param prefix [String] Filter by name prefix

data/lib/cadenya/models/model_swap_params.rb

@@ -34,15 +34,25 @@ module Cadenya
         #   @return [String, nil]
         optional :current_model_id, String, api_name: :currentModelId
 
+        # @!attribute disable_current_after_swap
+        #   Whether to disable the current model after the swap.
+        #
+        #   @return [Boolean, nil]
+        optional :disable_current_after_swap,
+                 Cadenya::Internal::Type::Boolean,
+                 api_name: :disableCurrentAfterSwap
+
         # @!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)
+        # @!method initialize(current_model_id: nil, disable_current_after_swap: nil, next_model_id: nil)
         #   @param current_model_id [String] The model variations are currently on. Accepts an id or "external_id:" slug.
         #
+        #   @param disable_current_after_swap [Boolean] Whether to disable the current model after the swap.
+        #
         #   @param next_model_id [String] The model to move variations to. Accepts an id or "external_id:" slug.
       end
     end

data/lib/cadenya/resources/ai_provider_keys.rb

@@ -101,7 +101,7 @@ module Cadenya
       #
       # Lists all customer-provided AI provider keys in the workspace
       #
-      # @overload list(workspace_id, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, request_options: {})
+      # @overload list(workspace_id, cursor: nil, include_info: nil, limit: nil, prefix: nil, promotional: nil, query: nil, sort_order: nil, request_options: {})
       #
       # @param workspace_id [String] The workspace whose keys will be listed.
       #
@@ -113,6 +113,8 @@ module Cadenya
       #
       # @param prefix [String] Filter expression (query param: prefix)
       #
+      # @param promotional [Boolean] When true, return only promotional keys (provided by Cadenya, e.g. for
+      #
       # @param query [String] Free-form search query
       #
       # @param sort_order [String] Sort order for results (asc or desc by creation time)

data/lib/cadenya/resources/models.rb

@@ -38,7 +38,7 @@ module Cadenya
       #
       # Lists all models in the workspace
       #
-      # @overload list(workspace_id, ai_provider_key_id: nil, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, state: nil, request_options: {})
+      # @overload list(workspace_id, ai_provider_key_id: nil, bundle_key: nil, cursor: nil, include_info: nil, is_assigned: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, state: nil, request_options: {})
       #
       # @param workspace_id [String] Workspace ID.
       #
@@ -50,6 +50,8 @@ module Cadenya
       #
       # @param include_info [Boolean] When true, populate each item's info (e.g. the AI provider), at the cost of
       #
+      # @param is_assigned [Boolean] Filter models to only ones assigned to an active agent variation/agent.
+      #
       # @param limit [Integer] Maximum number of results to return
       #
       # @param prefix [String] Filter by name prefix
@@ -75,6 +77,7 @@ module Cadenya
             ai_provider_key_id: "aiProviderKeyId",
             bundle_key: "bundleKey",
             include_info: "includeInfo",
+            is_assigned: "isAssigned",
             sort_order: "sortOrder"
           ),
           page: Cadenya::Internal::CursorPagination,

data/lib/cadenya/version.rb

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

data/rbi/cadenya/models/ai_provider_key.rbi

@@ -29,8 +29,10 @@ module Cadenya
       sig { params(info: Cadenya::AIProviderKey::Info::OrHash).void }
       attr_writer :info
 
-      # AIProviderKey is a customer-provided (BYOK) credential for an AI provider,
-      # scoped to a workspace. The secret value is never returned in responses.
+      # AIProviderKey is a credential for an AI provider, scoped to a workspace. Most
+      # keys are customer-provided (BYOK); Cadenya also provisions promotional keys (see
+      # AIProviderKeyInfo.is_promotional), which cannot be modified or deleted by
+      # account administrators. The secret value is never returned in responses.
       sig do
         params(
           metadata: Cadenya::ResourceMetadata::OrHash,
@@ -80,25 +82,41 @@ module Cadenya
         sig { params(enabled_model_count: Integer).void }
         attr_writer :enabled_model_count
 
+        # Cadenya includes promotional keys (one for onboarding, and potentially more in
+        # the future). These are not added or maintained by account administrators.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :is_promotional
+
+        sig { params(is_promotional: T::Boolean).void }
+        attr_writer :is_promotional
+
         # AIProviderKeyInfo carries server-derived, read-only details about a key, for AI
         # provider management UIs.
         sig do
           params(
             disabled_model_count: Integer,
-            enabled_model_count: Integer
+            enabled_model_count: Integer,
+            is_promotional: T::Boolean
           ).returns(T.attached_class)
         end
         def self.new(
           # Number of disabled models provisioned on this key.
           disabled_model_count: nil,
           # Number of enabled models provisioned on this key.
-          enabled_model_count: nil
+          enabled_model_count: nil,
+          # Cadenya includes promotional keys (one for onboarding, and potentially more in
+          # the future). These are not added or maintained by account administrators.
+          is_promotional: nil
         )
         end
 
         sig do
           override.returns(
-            { disabled_model_count: Integer, enabled_model_count: Integer }
+            {
+              disabled_model_count: Integer,
+              enabled_model_count: Integer,
+              is_promotional: T::Boolean
+            }
           )
         end
         def to_hash

data/rbi/cadenya/models/ai_provider_key_list_params.rbi

@@ -43,6 +43,15 @@ module Cadenya
       sig { params(prefix: String).void }
       attr_writer :prefix
 
+      # When true, return only promotional keys (provided by Cadenya, e.g. for
+      # onboarding). Defaults to returning all keys, customer-provided and promotional
+      # alike.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :promotional
+
+      sig { params(promotional: T::Boolean).void }
+      attr_writer :promotional
+
       # Free-form search query
       sig { returns(T.nilable(String)) }
       attr_reader :query
@@ -64,6 +73,7 @@ module Cadenya
           include_info: T::Boolean,
           limit: Integer,
           prefix: String,
+          promotional: T::Boolean,
           query: String,
           sort_order: String,
           request_options: Cadenya::RequestOptions::OrHash
@@ -80,6 +90,10 @@ module Cadenya
         limit: nil,
         # Filter expression (query param: prefix)
         prefix: nil,
+        # When true, return only promotional keys (provided by Cadenya, e.g. for
+        # onboarding). Defaults to returning all keys, customer-provided and promotional
+        # alike.
+        promotional: nil,
         # Free-form search query
         query: nil,
         # Sort order for results (asc or desc by creation time)
@@ -96,6 +110,7 @@ module Cadenya
             include_info: T::Boolean,
             limit: Integer,
             prefix: String,
+            promotional: T::Boolean,
             query: String,
             sort_order: String,
             request_options: Cadenya::RequestOptions

data/rbi/cadenya/models/model.rbi

@@ -100,36 +100,42 @@ module Cadenya
         sig { params(agent_variation_count: Integer).void }
         attr_writer :agent_variation_count
 
-        # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-        sig { returns(T.nilable(Cadenya::ResourceMetadata)) }
+        # AIProviderKey is a credential for an AI provider, scoped to a workspace. Most
+        # keys are customer-provided (BYOK); Cadenya also provisions promotional keys (see
+        # AIProviderKeyInfo.is_promotional), which cannot be modified or deleted by
+        # account administrators. The secret value is never returned in responses.
+        sig { returns(T.nilable(Cadenya::AIProviderKey)) }
         attr_reader :ai_provider_key
 
-        sig { params(ai_provider_key: Cadenya::ResourceMetadata::OrHash).void }
+        sig { params(ai_provider_key: Cadenya::AIProviderKey::OrHash).void }
         attr_writer :ai_provider_key
 
-        # The AI provider this model routes through (via its provider key).
-        sig { returns(T.nilable(Cadenya::Model::Info::Provider::TaggedSymbol)) }
-        attr_reader :provider
+        # Represents the last time this model was used in an agent objective
+        sig { returns(T.nilable(Time)) }
+        attr_reader :last_used_at
 
-        sig { params(provider: Cadenya::Model::Info::Provider::OrSymbol).void }
-        attr_writer :provider
+        sig { params(last_used_at: Time).void }
+        attr_writer :last_used_at
 
         # ModelInfo carries server-derived, read-only details about a model.
         sig do
           params(
             agent_variation_count: Integer,
-            ai_provider_key: Cadenya::ResourceMetadata::OrHash,
-            provider: Cadenya::Model::Info::Provider::OrSymbol
+            ai_provider_key: Cadenya::AIProviderKey::OrHash,
+            last_used_at: Time
           ).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,
-          # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+          # AIProviderKey is a credential for an AI provider, scoped to a workspace. Most
+          # keys are customer-provided (BYOK); Cadenya also provisions promotional keys (see
+          # AIProviderKeyInfo.is_promotional), which cannot be modified or deleted by
+          # account administrators. The secret value is never returned in responses.
           ai_provider_key: nil,
-          # The AI provider this model routes through (via its provider key).
-          provider: nil
+          # Represents the last time this model was used in an agent objective
+          last_used_at: nil
         )
         end
 
@@ -137,41 +143,13 @@ module Cadenya
           override.returns(
             {
               agent_variation_count: Integer,
-              ai_provider_key: Cadenya::ResourceMetadata,
-              provider: Cadenya::Model::Info::Provider::TaggedSymbol
+              ai_provider_key: Cadenya::AIProviderKey,
+              last_used_at: Time
             }
           )
         end
         def to_hash
         end
-
-        # The AI provider this model routes through (via its provider key).
-        module Provider
-          extend Cadenya::Internal::Type::Enum
-
-          TaggedSymbol =
-            T.type_alias { T.all(Symbol, Cadenya::Model::Info::Provider) }
-          OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-          AI_PROVIDER_UNSPECIFIED =
-            T.let(
-              :AI_PROVIDER_UNSPECIFIED,
-              Cadenya::Model::Info::Provider::TaggedSymbol
-            )
-          AI_PROVIDER_OPENROUTER =
-            T.let(
-              :AI_PROVIDER_OPENROUTER,
-              Cadenya::Model::Info::Provider::TaggedSymbol
-            )
-
-          sig do
-            override.returns(
-              T::Array[Cadenya::Model::Info::Provider::TaggedSymbol]
-            )
-          end
-          def self.values
-          end
-        end
       end
     end
   end

data/rbi/cadenya/models/model_list_params.rbi

@@ -44,6 +44,15 @@ module Cadenya
       sig { params(include_info: T::Boolean).void }
       attr_writer :include_info
 
+      # Filter models to only ones assigned to an active agent variation/agent. Draft
+      # agents count as assigned; archived agents do not. Assignment does not imply
+      # recent traffic — see ModelInfo.last_used_at for that.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :is_assigned
+
+      sig { params(is_assigned: T::Boolean).void }
+      attr_writer :is_assigned
+
       # Maximum number of results to return
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
@@ -86,6 +95,7 @@ module Cadenya
           bundle_key: String,
           cursor: String,
           include_info: T::Boolean,
+          is_assigned: T::Boolean,
           limit: Integer,
           prefix: String,
           query: String,
@@ -106,6 +116,10 @@ module Cadenya
         # When true, populate each item's info (e.g. the AI provider), at the cost of
         # extra lookups.
         include_info: nil,
+        # Filter models to only ones assigned to an active agent variation/agent. Draft
+        # agents count as assigned; archived agents do not. Assignment does not imply
+        # recent traffic — see ModelInfo.last_used_at for that.
+        is_assigned: nil,
         # Maximum number of results to return
         limit: nil,
         # Filter by name prefix
@@ -128,6 +142,7 @@ module Cadenya
             bundle_key: String,
             cursor: String,
             include_info: T::Boolean,
+            is_assigned: T::Boolean,
             limit: Integer,
             prefix: String,
             query: String,

data/rbi/cadenya/models/model_swap_params.rbi

@@ -68,6 +68,13 @@ module Cadenya
         sig { params(current_model_id: String).void }
         attr_writer :current_model_id
 
+        # Whether to disable the current model after the swap.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :disable_current_after_swap
+
+        sig { params(disable_current_after_swap: T::Boolean).void }
+        attr_writer :disable_current_after_swap
+
         # The model to move variations to. Accepts an id or "external_id:" slug.
         sig { returns(T.nilable(String)) }
         attr_reader :next_model_id
@@ -76,20 +83,30 @@ module Cadenya
         attr_writer :next_model_id
 
         sig do
-          params(current_model_id: String, next_model_id: String).returns(
-            T.attached_class
-          )
+          params(
+            current_model_id: String,
+            disable_current_after_swap: T::Boolean,
+            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,
+          # Whether to disable the current model after the swap.
+          disable_current_after_swap: 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 })
+          override.returns(
+            {
+              current_model_id: String,
+              disable_current_after_swap: T::Boolean,
+              next_model_id: String
+            }
+          )
         end
         def to_hash
         end

data/rbi/cadenya/resources/ai_provider_keys.rbi

@@ -78,6 +78,7 @@ module Cadenya
           include_info: T::Boolean,
           limit: Integer,
           prefix: String,
+          promotional: T::Boolean,
           query: String,
           sort_order: String,
           request_options: Cadenya::RequestOptions::OrHash
@@ -95,6 +96,10 @@ module Cadenya
         limit: nil,
         # Filter expression (query param: prefix)
         prefix: nil,
+        # When true, return only promotional keys (provided by Cadenya, e.g. for
+        # onboarding). Defaults to returning all keys, customer-provided and promotional
+        # alike.
+        promotional: nil,
         # Free-form search query
         query: nil,
         # Sort order for results (asc or desc by creation time)

data/rbi/cadenya/resources/models.rbi

@@ -31,6 +31,7 @@ module Cadenya
           bundle_key: String,
           cursor: String,
           include_info: T::Boolean,
+          is_assigned: T::Boolean,
           limit: Integer,
           prefix: String,
           query: String,
@@ -52,6 +53,10 @@ module Cadenya
         # When true, populate each item's info (e.g. the AI provider), at the cost of
         # extra lookups.
         include_info: nil,
+        # Filter models to only ones assigned to an active agent variation/agent. Draft
+        # agents count as assigned; archived agents do not. Assignment does not imply
+        # recent traffic — see ModelInfo.last_used_at for that.
+        is_assigned: nil,
         # Maximum number of results to return
         limit: nil,
         # Filter by name prefix

data/sig/cadenya/models/ai_provider_key.rbs

@@ -29,7 +29,11 @@ module Cadenya
       }
 
       type info =
-        { disabled_model_count: Integer, enabled_model_count: Integer }
+        {
+          disabled_model_count: Integer,
+          enabled_model_count: Integer,
+          is_promotional: bool
+        }
 
       class Info < Cadenya::Internal::Type::BaseModel
         attr_reader disabled_model_count: Integer?
@@ -40,14 +44,20 @@ module Cadenya
 
         def enabled_model_count=: (Integer) -> Integer
 
+        attr_reader is_promotional: bool?
+
+        def is_promotional=: (bool) -> bool
+
         def initialize: (
           ?disabled_model_count: Integer,
-          ?enabled_model_count: Integer
+          ?enabled_model_count: Integer,
+          ?is_promotional: bool
         ) -> void
 
         def to_hash: -> {
           disabled_model_count: Integer,
-          enabled_model_count: Integer
+          enabled_model_count: Integer,
+          is_promotional: bool
         }
       end
     end

data/sig/cadenya/models/ai_provider_key_list_params.rbs

@@ -7,6 +7,7 @@ module Cadenya
         include_info: bool,
         limit: Integer,
         prefix: String,
+        promotional: bool,
         query: String,
         sort_order: String
       }
@@ -34,6 +35,10 @@ module Cadenya
 
       def prefix=: (String) -> String
 
+      attr_reader promotional: bool?
+
+      def promotional=: (bool) -> bool
+
       attr_reader query: String?
 
       def query=: (String) -> String
@@ -48,6 +53,7 @@ module Cadenya
         ?include_info: bool,
         ?limit: Integer,
         ?prefix: String,
+        ?promotional: bool,
         ?query: String,
         ?sort_order: String,
         ?request_options: Cadenya::request_opts
@@ -59,6 +65,7 @@ module Cadenya
         include_info: bool,
         limit: Integer,
         prefix: String,
+        promotional: bool,
         query: String,
         sort_order: String,
         request_options: Cadenya::RequestOptions

data/sig/cadenya/models/model.rbs

@@ -48,8 +48,8 @@ module Cadenya
       type info =
         {
           agent_variation_count: Integer,
-          ai_provider_key: Cadenya::ResourceMetadata,
-          provider: Cadenya::Models::Model::Info::provider
+          ai_provider_key: Cadenya::AIProviderKey,
+          last_used_at: Time
         }
 
       class Info < Cadenya::Internal::Type::BaseModel
@@ -57,40 +57,25 @@ module Cadenya
 
         def agent_variation_count=: (Integer) -> Integer
 
-        attr_reader ai_provider_key: Cadenya::ResourceMetadata?
+        attr_reader ai_provider_key: Cadenya::AIProviderKey?
 
-        def ai_provider_key=: (
-          Cadenya::ResourceMetadata
-        ) -> Cadenya::ResourceMetadata
+        def ai_provider_key=: (Cadenya::AIProviderKey) -> Cadenya::AIProviderKey
 
-        attr_reader provider: Cadenya::Models::Model::Info::provider?
+        attr_reader last_used_at: Time?
 
-        def provider=: (
-          Cadenya::Models::Model::Info::provider
-        ) -> Cadenya::Models::Model::Info::provider
+        def last_used_at=: (Time) -> Time
 
         def initialize: (
           ?agent_variation_count: Integer,
-          ?ai_provider_key: Cadenya::ResourceMetadata,
-          ?provider: Cadenya::Models::Model::Info::provider
+          ?ai_provider_key: Cadenya::AIProviderKey,
+          ?last_used_at: Time
         ) -> void
 
         def to_hash: -> {
           agent_variation_count: Integer,
-          ai_provider_key: Cadenya::ResourceMetadata,
-          provider: Cadenya::Models::Model::Info::provider
+          ai_provider_key: Cadenya::AIProviderKey,
+          last_used_at: Time
         }
-
-        type provider = :AI_PROVIDER_UNSPECIFIED | :AI_PROVIDER_OPENROUTER
-
-        module Provider
-          extend Cadenya::Internal::Type::Enum
-
-          AI_PROVIDER_UNSPECIFIED: :AI_PROVIDER_UNSPECIFIED
-          AI_PROVIDER_OPENROUTER: :AI_PROVIDER_OPENROUTER
-
-          def self?.values: -> ::Array[Cadenya::Models::Model::Info::provider]
-        end
       end
     end
   end

data/sig/cadenya/models/model_list_params.rbs

@@ -7,6 +7,7 @@ module Cadenya
         bundle_key: String,
         cursor: String,
         include_info: bool,
+        is_assigned: bool,
         limit: Integer,
         prefix: String,
         query: String,
@@ -37,6 +38,10 @@ module Cadenya
 
       def include_info=: (bool) -> bool
 
+      attr_reader is_assigned: bool?
+
+      def is_assigned=: (bool) -> bool
+
       attr_reader limit: Integer?
 
       def limit=: (Integer) -> Integer
@@ -65,6 +70,7 @@ module Cadenya
         ?bundle_key: String,
         ?cursor: String,
         ?include_info: bool,
+        ?is_assigned: bool,
         ?limit: Integer,
         ?prefix: String,
         ?query: String,
@@ -79,6 +85,7 @@ module Cadenya
         bundle_key: String,
         cursor: String,
         include_info: bool,
+        is_assigned: bool,
         limit: Integer,
         prefix: String,
         query: String,

data/sig/cadenya/models/model_swap_params.rbs

@@ -31,23 +31,37 @@ module Cadenya
         request_options: Cadenya::RequestOptions
       }
 
-      type model_swap = { current_model_id: String, next_model_id: String }
+      type model_swap =
+        {
+          current_model_id: String,
+          disable_current_after_swap: bool,
+          next_model_id: String
+        }
 
       class ModelSwap < Cadenya::Internal::Type::BaseModel
         attr_reader current_model_id: String?
 
         def current_model_id=: (String) -> String
 
+        attr_reader disable_current_after_swap: bool?
+
+        def disable_current_after_swap=: (bool) -> bool
+
         attr_reader next_model_id: String?
 
         def next_model_id=: (String) -> String
 
         def initialize: (
           ?current_model_id: String,
+          ?disable_current_after_swap: bool,
           ?next_model_id: String
         ) -> void
 
-        def to_hash: -> { current_model_id: String, next_model_id: String }
+        def to_hash: -> {
+          current_model_id: String,
+          disable_current_after_swap: bool,
+          next_model_id: String
+        }
       end
     end
   end

data/sig/cadenya/resources/ai_provider_keys.rbs

@@ -29,6 +29,7 @@ module Cadenya
         ?include_info: bool,
         ?limit: Integer,
         ?prefix: String,
+        ?promotional: bool,
         ?query: String,
         ?sort_order: String,
         ?request_options: Cadenya::request_opts

data/sig/cadenya/resources/models.rbs

@@ -13,6 +13,7 @@ module Cadenya
         ?bundle_key: String,
         ?cursor: String,
         ?include_info: bool,
+        ?is_assigned: bool,
         ?limit: Integer,
         ?prefix: String,
         ?query: String,

metadata

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