cadenya 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e7f15c89788992e84faa1b1a059033314f7c115317be1f0fdba0e49793bc0aa6
-  data.tar.gz: d56587810401e084e8b5497254d6a6680fc22b3eff1bf70af6bc20461a3b19e1
+  metadata.gz: '0488a69eb293e3cb4a745c2db7ed2b94aa1b59c82f6e6c1fbee1fa2bf392b216'
+  data.tar.gz: b3dcf3ecdfbbbf92bc8fc62e5293c1f5d456d4ff0341b5e26e0e161a3d630730
 SHA512:
-  metadata.gz: c696765a5ffb6e7c97c6b3cb729b711fe424626b45e6e0732ef37a5dc9b56bde28f8ca54d0db305657bf459b4e3dfa3081f905e26a17a6e503b3b5709b82ef38
-  data.tar.gz: 9f178edbcaf810c598ccf931ee62bc8c68479f41128c63143852a255b673dcd69e1306706407cf7c0bb7f2ced5c8c581be9d45be426d04ab0306e3ce13e934cc
+  metadata.gz: '0984e2d2b5c3e8aa4865e9048035a67ff75add28a8def45559155bce5d3c07c3efd685a59f8fd4b9e6f067eeb2379d34aabb07d4a93624e82b33eb816e49c2ea'
+  data.tar.gz: ca3bc8d58078c5f0ab8f5968176571bc256433bb230dfdaa4e0abe28b4c673c5ea624bd6038930e7aeb59a8bcf84f8af9c16f4898588430cae636c4ccfb8e985

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # 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)
+
+### Features
+
+* **api:** api update ([d88fdeb](https://github.com/cadenya/cadenya-ruby/commit/d88fdeb06d9d9ba77523cb5b36818c74119ec466))
+
 ## 0.4.0 (2026-06-07)
 
 Full Changelog: [v0.3.0...v0.4.0](https://github.com/cadenya/cadenya-ruby/compare/v0.3.0...v0.4.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.4.0"
+gem "cadenya", "~> 0.6.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/cadenya/models/ai_provider_key.rb

@@ -15,7 +15,16 @@ module Cadenya
       #   @return [Cadenya::Models::AIProviderKeySpec]
       required :spec, -> { Cadenya::AIProviderKeySpec }
 
-      # @!method initialize(metadata:, spec:)
+      response_only do
+        # @!attribute info
+        #   AIProviderKeyInfo carries server-derived, read-only details about a key, for AI
+        #   provider management UIs.
+        #
+        #   @return [Cadenya::Models::AIProviderKey::Info, nil]
+        optional :info, -> { Cadenya::AIProviderKey::Info }
+      end
+
+      # @!method initialize(metadata:, spec:, info: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::AIProviderKey} for more details.
       #
@@ -25,6 +34,33 @@ module Cadenya
       #   @param metadata [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
       #
       #   @param spec [Cadenya::Models::AIProviderKeySpec]
+      #
+      #   @param info [Cadenya::Models::AIProviderKey::Info] AIProviderKeyInfo carries server-derived, read-only details about a key, for
+
+      # @see Cadenya::Models::AIProviderKey#info
+      class Info < Cadenya::Internal::Type::BaseModel
+        response_only do
+          # @!attribute disabled_model_count
+          #   Number of disabled models provisioned on this key.
+          #
+          #   @return [Integer, nil]
+          optional :disabled_model_count, Integer, api_name: :disabledModelCount
+
+          # @!attribute enabled_model_count
+          #   Number of enabled models provisioned on this key.
+          #
+          #   @return [Integer, nil]
+          optional :enabled_model_count, Integer, api_name: :enabledModelCount
+        end
+
+        # @!method initialize(disabled_model_count: nil, enabled_model_count: nil)
+        #   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.
+      end
     end
   end
 end

data/lib/cadenya/models/ai_provider_key_list_params.rb

@@ -18,6 +18,13 @@ module Cadenya
       #   @return [String, nil]
       optional :cursor, String
 
+      # @!attribute include_info
+      #   When true, populate each item's info (model counts), at the cost of extra
+      #   lookups.
+      #
+      #   @return [Boolean, nil]
+      optional :include_info, Cadenya::Internal::Type::Boolean
+
       # @!attribute limit
       #   Maximum number of results to return
       #
@@ -42,11 +49,16 @@ module Cadenya
       #   @return [String, nil]
       optional :sort_order, String
 
-      # @!method initialize(workspace_id:, cursor: 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, query: nil, sort_order: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::AIProviderKeyListParams} for more details.
+      #
       #   @param workspace_id [String]
       #
       #   @param cursor [String] Pagination cursor from previous response
       #
+      #   @param include_info [Boolean] When true, populate each item's info (model counts), at the cost of extra
+      #
       #   @param limit [Integer] Maximum number of results to return
       #
       #   @param prefix [String] Filter expression (query param: prefix)

data/lib/cadenya/models/ai_provider_key_spec.rb

@@ -10,27 +10,42 @@ module Cadenya
       #   @return [String, nil]
       optional :api_key, String, api_name: :apiKey
 
-      # @!attribute provider
-      #   The AI provider this key authenticates against. Currently "openrouter".
+      # @!attribute openrouter
+      #   OpenRouterConfig holds OpenRouter-specific settings. Empty for now; it exists as
+      #   the oneof seam so provider-specific options (region, base URL, etc.) can be
+      #   added later without restructuring the spec.
       #
-      #   @return [String, nil]
-      optional :provider, String
+      #   @return [Object, nil]
+      optional :openrouter, Cadenya::Internal::Type::Unknown
 
-      # @!attribute region
-      #   The provider region. "us" or "eu". Defaults to "us".
+      # @!attribute provider
+      #   The AI provider this key authenticates against.
       #
-      #   @return [String, nil]
-      optional :region, String
+      #   @return [Symbol, Cadenya::Models::AIProviderKeySpec::Provider, nil]
+      optional :provider, enum: -> { Cadenya::AIProviderKeySpec::Provider }
 
-      # @!method initialize(api_key: nil, provider: nil, region: nil)
+      # @!method initialize(api_key: nil, openrouter: nil, provider: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::AIProviderKeySpec} for more details.
       #
       #   @param api_key [String] The provider credential. Accepted on create/update; never populated in
       #
-      #   @param provider [String] The AI provider this key authenticates against. Currently "openrouter".
+      #   @param openrouter [Object] OpenRouterConfig holds OpenRouter-specific settings. Empty for now; it exists
       #
-      #   @param region [String] The provider region. "us" or "eu". Defaults to "us".
+      #   @param provider [Symbol, Cadenya::Models::AIProviderKeySpec::Provider] The AI provider this key authenticates against.
+
+      # The AI provider this key authenticates against.
+      #
+      # @see Cadenya::Models::AIProviderKeySpec#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
     end
   end
 end

data/lib/cadenya/models/model.rb

@@ -16,13 +16,77 @@ module Cadenya
       #   @return [Cadenya::Models::ModelSpec]
       required :spec, -> { Cadenya::ModelSpec }
 
-      # @!method initialize(metadata:, spec:)
+      response_only do
+        # @!attribute info
+        #   ModelInfo carries server-derived, read-only details about a model.
+        #
+        #   @return [Cadenya::Models::Model::Info, nil]
+        optional :info, -> { Cadenya::Model::Info }
+      end
+
+      # @!method initialize(metadata:, spec:, info: nil)
       #   Some parameter documentations has been truncated, see {Cadenya::Models::Model}
       #   for more details.
       #
       #   @param metadata [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
       #
       #   @param spec [Cadenya::Models::ModelSpec] Model specification
+      #
+      #   @param info [Cadenya::Models::Model::Info] ModelInfo carries server-derived, read-only details about a model.
+
+      # @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
+          #   metadata (account scoping, timestamps, labels, external IDs) is not needed —
+          #   e.g., the tool references inside an agent variation spec or the tools assigned
+          #   to an objective. Both fields are server-populated; clients provide IDs through
+          #   sibling fields rather than by constructing a BareMetadata themselves.
+          #
+          #   @return [Cadenya::Models::BareMetadata, nil]
+          optional :ai_provider_key, -> { Cadenya::BareMetadata }, api_name: :aiProviderKey
+
+          # @!attribute provider
+          #   The AI provider this model routes through (via its provider key).
+          #
+          #   @return [Symbol, Cadenya::Models::Model::Info::Provider, nil]
+          optional :provider, enum: -> { Cadenya::Model::Info::Provider }
+        end
+
+        # @!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).
+
+        # 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
+      end
     end
   end
 end

data/lib/cadenya/models/model_list_params.rb

@@ -12,6 +12,13 @@ module Cadenya
       #   @return [String]
       required :workspace_id, String
 
+      # @!attribute ai_provider_key_id
+      #   Filter to models provisioned on a specific AI provider key. Accepts the key's id
+      #   or an "external_id:"-prefixed slug.
+      #
+      #   @return [String, nil]
+      optional :ai_provider_key_id, String
+
       # @!attribute bundle_key
       #   Filter by bundle_key — return only resources owned by this bundle.
       #
@@ -24,6 +31,13 @@ module Cadenya
       #   @return [String, nil]
       optional :cursor, String
 
+      # @!attribute include_info
+      #   When true, populate each item's info (e.g. the AI provider), at the cost of
+      #   extra lookups.
+      #
+      #   @return [Boolean, nil]
+      optional :include_info, Cadenya::Internal::Type::Boolean
+
       # @!attribute limit
       #   Maximum number of results to return
       #
@@ -54,13 +68,20 @@ module Cadenya
       #   @return [Symbol, Cadenya::Models::ModelListParams::Status, nil]
       optional :status, enum: -> { Cadenya::ModelListParams::Status }
 
-      # @!method initialize(workspace_id:, bundle_key: nil, cursor: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, status: nil, request_options: {})
+      # @!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, status: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ModelListParams} for more details.
+      #
       #   @param workspace_id [String]
       #
+      #   @param ai_provider_key_id [String] Filter to models provisioned on a specific AI provider key. Accepts the
+      #
       #   @param bundle_key [String] Filter by bundle_key — return only resources owned by this bundle.
       #
       #   @param cursor [String] Pagination cursor from previous response
       #
+      #   @param include_info [Boolean] When true, populate each item's info (e.g. the AI provider), at the cost of
+      #
       #   @param limit [Integer] Maximum number of results to return
       #
       #   @param prefix [String] Filter by name prefix

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/ai_provider_keys.rb

@@ -96,14 +96,19 @@ module Cadenya
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::AIProviderKeyListParams} for more details.
+      #
       # Lists all customer-provided AI provider keys in the workspace
       #
-      # @overload list(workspace_id, cursor: 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, query: nil, sort_order: nil, request_options: {})
       #
       # @param workspace_id [String] The workspace whose keys will be listed.
       #
       # @param cursor [String] Pagination cursor from previous response
       #
+      # @param include_info [Boolean] When true, populate each item's info (model counts), at the cost of extra
+      #
       # @param limit [Integer] Maximum number of results to return
       #
       # @param prefix [String] Filter expression (query param: prefix)
@@ -123,7 +128,7 @@ module Cadenya
         @client.request(
           method: :get,
           path: ["v1/workspaces/%1$s/ai_provider_keys", workspace_id],
-          query: query.transform_keys(sort_order: "sortOrder"),
+          query: query.transform_keys(include_info: "includeInfo", sort_order: "sortOrder"),
           page: Cadenya::Internal::CursorPagination,
           model: Cadenya::AIProviderKey,
           options: options

data/lib/cadenya/resources/models.rb

@@ -33,16 +33,23 @@ module Cadenya
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::ModelListParams} for more details.
+      #
       # Lists all models in the workspace
       #
-      # @overload list(workspace_id, bundle_key: nil, cursor: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, status: nil, request_options: {})
+      # @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, status: nil, request_options: {})
       #
       # @param workspace_id [String] Workspace ID.
       #
+      # @param ai_provider_key_id [String] Filter to models provisioned on a specific AI provider key. Accepts the
+      #
       # @param bundle_key [String] Filter by bundle_key — return only resources owned by this bundle.
       #
       # @param cursor [String] Pagination cursor from previous response
       #
+      # @param include_info [Boolean] When true, populate each item's info (e.g. the AI provider), at the cost of
+      #
       # @param limit [Integer] Maximum number of results to return
       #
       # @param prefix [String] Filter by name prefix
@@ -64,7 +71,12 @@ module Cadenya
         @client.request(
           method: :get,
           path: ["v1/workspaces/%1$s/models", workspace_id],
-          query: query.transform_keys(bundle_key: "bundleKey", sort_order: "sortOrder"),
+          query: query.transform_keys(
+            ai_provider_key_id: "aiProviderKeyId",
+            bundle_key: "bundleKey",
+            include_info: "includeInfo",
+            sort_order: "sortOrder"
+          ),
           page: Cadenya::Internal::CursorPagination,
           model: Cadenya::Model,
           options: options
@@ -101,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.4.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/ai_provider_key.rbi

@@ -21,18 +21,30 @@ module Cadenya
       sig { params(spec: Cadenya::AIProviderKeySpec::OrHash).void }
       attr_writer :spec
 
+      # AIProviderKeyInfo carries server-derived, read-only details about a key, for AI
+      # provider management UIs.
+      sig { returns(T.nilable(Cadenya::AIProviderKey::Info)) }
+      attr_reader :info
+
+      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.
       sig do
         params(
           metadata: Cadenya::ResourceMetadata::OrHash,
-          spec: Cadenya::AIProviderKeySpec::OrHash
+          spec: Cadenya::AIProviderKeySpec::OrHash,
+          info: Cadenya::AIProviderKey::Info::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
         # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
         metadata:,
-        spec:
+        spec:,
+        # AIProviderKeyInfo carries server-derived, read-only details about a key, for AI
+        # provider management UIs.
+        info: nil
       )
       end
 
@@ -40,12 +52,58 @@ module Cadenya
         override.returns(
           {
             metadata: Cadenya::ResourceMetadata,
-            spec: Cadenya::AIProviderKeySpec
+            spec: Cadenya::AIProviderKeySpec,
+            info: Cadenya::AIProviderKey::Info
           }
         )
       end
       def to_hash
       end
+
+      class Info < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Cadenya::AIProviderKey::Info, Cadenya::Internal::AnyHash)
+          end
+
+        # Number of disabled models provisioned on this key.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :disabled_model_count
+
+        sig { params(disabled_model_count: Integer).void }
+        attr_writer :disabled_model_count
+
+        # Number of enabled models provisioned on this key.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :enabled_model_count
+
+        sig { params(enabled_model_count: Integer).void }
+        attr_writer :enabled_model_count
+
+        # 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
+          ).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
+        )
+        end
+
+        sig do
+          override.returns(
+            { disabled_model_count: Integer, enabled_model_count: Integer }
+          )
+        end
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/cadenya/models/ai_provider_key_list_params.rbi

@@ -21,6 +21,14 @@ module Cadenya
       sig { params(cursor: String).void }
       attr_writer :cursor
 
+      # When true, populate each item's info (model counts), at the cost of extra
+      # lookups.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :include_info
+
+      sig { params(include_info: T::Boolean).void }
+      attr_writer :include_info
+
       # Maximum number of results to return
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
@@ -53,6 +61,7 @@ module Cadenya
         params(
           workspace_id: String,
           cursor: String,
+          include_info: T::Boolean,
           limit: Integer,
           prefix: String,
           query: String,
@@ -64,6 +73,9 @@ module Cadenya
         workspace_id:,
         # Pagination cursor from previous response
         cursor: nil,
+        # When true, populate each item's info (model counts), at the cost of extra
+        # lookups.
+        include_info: nil,
         # Maximum number of results to return
         limit: nil,
         # Filter expression (query param: prefix)
@@ -81,6 +93,7 @@ module Cadenya
           {
             workspace_id: String,
             cursor: String,
+            include_info: T::Boolean,
             limit: Integer,
             prefix: String,
             query: String,