cadenya 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e7f15c89788992e84faa1b1a059033314f7c115317be1f0fdba0e49793bc0aa6
-  data.tar.gz: d56587810401e084e8b5497254d6a6680fc22b3eff1bf70af6bc20461a3b19e1
+  metadata.gz: f2d3ccc2b08967b6c09113b9f86077582cecb2ff914643efd624d35f590ee2e9
+  data.tar.gz: 7e2cfc5c58da2c628a855f586bc46aba2b96c936ac13611c3cb0761b54c0e028
 SHA512:
-  metadata.gz: c696765a5ffb6e7c97c6b3cb729b711fe424626b45e6e0732ef37a5dc9b56bde28f8ca54d0db305657bf459b4e3dfa3081f905e26a17a6e503b3b5709b82ef38
-  data.tar.gz: 9f178edbcaf810c598ccf931ee62bc8c68479f41128c63143852a255b673dcd69e1306706407cf7c0bb7f2ced5c8c581be9d45be426d04ab0306e3ce13e934cc
+  metadata.gz: 577b0a9463ee0830ec2f85033e6e858172101ca5580f398c919c4c45b6c5d5867358fa2c3e1dc18f316040ce50bde17065d18991a7bc053a8d4a4dcae936ac54
+  data.tar.gz: 623d30dc59554aeb07440ac9c163fc99ff2cb45120c36601a74133b3cb7cb02301f37b5abcf47addf165eacdc2652254846a81d9bf0f2d02ce49d71ac3f091f3

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 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.5.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,68 @@ 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 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(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 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/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

data/lib/cadenya/version.rb

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

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,

data/rbi/cadenya/models/ai_provider_key_spec.rbi

@@ -16,41 +16,83 @@ module Cadenya
       sig { params(api_key: String).void }
       attr_writer :api_key
 
-      # The AI provider this key authenticates against. Currently "openrouter".
-      sig { returns(T.nilable(String)) }
-      attr_reader :provider
+      # 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.
+      sig { returns(T.nilable(T.anything)) }
+      attr_reader :openrouter
 
-      sig { params(provider: String).void }
-      attr_writer :provider
+      sig { params(openrouter: T.anything).void }
+      attr_writer :openrouter
 
-      # The provider region. "us" or "eu". Defaults to "us".
-      sig { returns(T.nilable(String)) }
-      attr_reader :region
+      # The AI provider this key authenticates against.
+      sig { returns(T.nilable(Cadenya::AIProviderKeySpec::Provider::OrSymbol)) }
+      attr_reader :provider
 
-      sig { params(region: String).void }
-      attr_writer :region
+      sig do
+        params(provider: Cadenya::AIProviderKeySpec::Provider::OrSymbol).void
+      end
+      attr_writer :provider
 
       sig do
-        params(api_key: String, provider: String, region: String).returns(
-          T.attached_class
-        )
+        params(
+          api_key: String,
+          openrouter: T.anything,
+          provider: Cadenya::AIProviderKeySpec::Provider::OrSymbol
+        ).returns(T.attached_class)
       end
       def self.new(
         # The provider credential. Accepted on create/update; never populated in responses
         # (the server returns an empty value to avoid leaking it).
         api_key: nil,
-        # The AI provider this key authenticates against. Currently "openrouter".
-        provider: nil,
-        # The provider region. "us" or "eu". Defaults to "us".
-        region: nil
+        # 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.
+        openrouter: nil,
+        # The AI provider this key authenticates against.
+        provider: nil
       )
       end
 
       sig do
-        override.returns({ api_key: String, provider: String, region: String })
+        override.returns(
+          {
+            api_key: String,
+            openrouter: T.anything,
+            provider: Cadenya::AIProviderKeySpec::Provider::OrSymbol
+          }
+        )
       end
       def to_hash
       end
+
+      # The AI provider this key authenticates against.
+      module Provider
+        extend Cadenya::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Cadenya::AIProviderKeySpec::Provider) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        AI_PROVIDER_UNSPECIFIED =
+          T.let(
+            :AI_PROVIDER_UNSPECIFIED,
+            Cadenya::AIProviderKeySpec::Provider::TaggedSymbol
+          )
+        AI_PROVIDER_OPENROUTER =
+          T.let(
+            :AI_PROVIDER_OPENROUTER,
+            Cadenya::AIProviderKeySpec::Provider::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Cadenya::AIProviderKeySpec::Provider::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/cadenya/models/model.rbi

@@ -20,27 +20,126 @@ module Cadenya
       sig { params(spec: Cadenya::ModelSpec::OrHash).void }
       attr_writer :spec
 
+      # ModelInfo carries server-derived, read-only details about a model.
+      sig { returns(T.nilable(Cadenya::Model::Info)) }
+      attr_reader :info
+
+      sig { params(info: Cadenya::Model::Info::OrHash).void }
+      attr_writer :info
+
       sig do
         params(
           metadata: Cadenya::ResourceMetadata::OrHash,
-          spec: Cadenya::ModelSpec::OrHash
+          spec: Cadenya::ModelSpec::OrHash,
+          info: Cadenya::Model::Info::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
         # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
         metadata:,
         # Model specification
-        spec:
+        spec:,
+        # ModelInfo carries server-derived, read-only details about a model.
+        info: nil
       )
       end
 
       sig do
         override.returns(
-          { metadata: Cadenya::ResourceMetadata, spec: Cadenya::ModelSpec }
+          {
+            metadata: Cadenya::ResourceMetadata,
+            spec: Cadenya::ModelSpec,
+            info: Cadenya::Model::Info
+          }
         )
       end
       def to_hash
       end
+
+      class Info < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Cadenya::Model::Info, Cadenya::Internal::AnyHash)
+          end
+
+        # 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.
+        sig { returns(T.nilable(Cadenya::BareMetadata)) }
+        attr_reader :ai_provider_key
+
+        sig { params(ai_provider_key: Cadenya::BareMetadata::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
+
+        sig { params(provider: Cadenya::Model::Info::Provider::OrSymbol).void }
+        attr_writer :provider
+
+        # ModelInfo carries server-derived, read-only details about a model.
+        sig do
+          params(
+            ai_provider_key: Cadenya::BareMetadata::OrHash,
+            provider: Cadenya::Model::Info::Provider::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # 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.
+          ai_provider_key: nil,
+          # The AI provider this model routes through (via its provider key).
+          provider: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              ai_provider_key: Cadenya::BareMetadata,
+              provider: Cadenya::Model::Info::Provider::TaggedSymbol
+            }
+          )
+        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
 end

data/rbi/cadenya/models/model_list_params.rbi

@@ -14,6 +14,14 @@ module Cadenya
       sig { returns(String) }
       attr_accessor :workspace_id
 
+      # Filter to models provisioned on a specific AI provider key. Accepts the key's id
+      # or an "external_id:"-prefixed slug.
+      sig { returns(T.nilable(String)) }
+      attr_reader :ai_provider_key_id
+
+      sig { params(ai_provider_key_id: String).void }
+      attr_writer :ai_provider_key_id
+
       # Filter by bundle_key — return only resources owned by this bundle.
       sig { returns(T.nilable(String)) }
       attr_reader :bundle_key
@@ -28,6 +36,14 @@ module Cadenya
       sig { params(cursor: String).void }
       attr_writer :cursor
 
+      # When true, populate each item's info (e.g. the AI provider), 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
@@ -66,8 +82,10 @@ module Cadenya
       sig do
         params(
           workspace_id: String,
+          ai_provider_key_id: String,
           bundle_key: String,
           cursor: String,
+          include_info: T::Boolean,
           limit: Integer,
           prefix: String,
           query: String,
@@ -78,10 +96,16 @@ module Cadenya
       end
       def self.new(
         workspace_id:,
+        # Filter to models provisioned on a specific AI provider key. Accepts the key's id
+        # or an "external_id:"-prefixed slug.
+        ai_provider_key_id: nil,
         # Filter by bundle_key — return only resources owned by this bundle.
         bundle_key: nil,
         # Pagination cursor from previous response
         cursor: nil,
+        # When true, populate each item's info (e.g. the AI provider), at the cost of
+        # extra lookups.
+        include_info: nil,
         # Maximum number of results to return
         limit: nil,
         # Filter by name prefix
@@ -100,8 +124,10 @@ module Cadenya
         override.returns(
           {
             workspace_id: String,
+            ai_provider_key_id: String,
             bundle_key: String,
             cursor: String,
+            include_info: T::Boolean,
             limit: Integer,
             prefix: String,
             query: String,

data/rbi/cadenya/resources/ai_provider_keys.rbi

@@ -75,6 +75,7 @@ module Cadenya
         params(
           workspace_id: String,
           cursor: String,
+          include_info: T::Boolean,
           limit: Integer,
           prefix: String,
           query: String,
@@ -87,6 +88,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)

data/rbi/cadenya/resources/models.rbi

@@ -27,8 +27,10 @@ module Cadenya
       sig do
         params(
           workspace_id: String,
+          ai_provider_key_id: String,
           bundle_key: String,
           cursor: String,
+          include_info: T::Boolean,
           limit: Integer,
           prefix: String,
           query: String,
@@ -40,10 +42,16 @@ module Cadenya
       def list(
         # Workspace ID.
         workspace_id,
+        # Filter to models provisioned on a specific AI provider key. Accepts the key's id
+        # or an "external_id:"-prefixed slug.
+        ai_provider_key_id: nil,
         # Filter by bundle_key — return only resources owned by this bundle.
         bundle_key: nil,
         # Pagination cursor from previous response
         cursor: nil,
+        # When true, populate each item's info (e.g. the AI provider), at the cost of
+        # extra lookups.
+        include_info: nil,
         # Maximum number of results to return
         limit: nil,
         # Filter by name prefix

data/sig/cadenya/models/ai_provider_key.rbs

@@ -1,22 +1,55 @@
 module Cadenya
   module Models
     type ai_provider_key =
-      { metadata: Cadenya::ResourceMetadata, spec: Cadenya::AIProviderKeySpec }
+      {
+        metadata: Cadenya::ResourceMetadata,
+        spec: Cadenya::AIProviderKeySpec,
+        info: Cadenya::AIProviderKey::Info
+      }
 
     class AIProviderKey < Cadenya::Internal::Type::BaseModel
       attr_accessor metadata: Cadenya::ResourceMetadata
 
       attr_accessor spec: Cadenya::AIProviderKeySpec
 
+      attr_reader info: Cadenya::AIProviderKey::Info?
+
+      def info=: (Cadenya::AIProviderKey::Info) -> Cadenya::AIProviderKey::Info
+
       def initialize: (
         metadata: Cadenya::ResourceMetadata,
-        spec: Cadenya::AIProviderKeySpec
+        spec: Cadenya::AIProviderKeySpec,
+        ?info: Cadenya::AIProviderKey::Info
       ) -> void
 
       def to_hash: -> {
         metadata: Cadenya::ResourceMetadata,
-        spec: Cadenya::AIProviderKeySpec
+        spec: Cadenya::AIProviderKeySpec,
+        info: Cadenya::AIProviderKey::Info
       }
+
+      type info =
+        { disabled_model_count: Integer, enabled_model_count: Integer }
+
+      class Info < Cadenya::Internal::Type::BaseModel
+        attr_reader disabled_model_count: Integer?
+
+        def disabled_model_count=: (Integer) -> Integer
+
+        attr_reader enabled_model_count: Integer?
+
+        def enabled_model_count=: (Integer) -> Integer
+
+        def initialize: (
+          ?disabled_model_count: Integer,
+          ?enabled_model_count: Integer
+        ) -> void
+
+        def to_hash: -> {
+          disabled_model_count: Integer,
+          enabled_model_count: Integer
+        }
+      end
     end
   end
 end

data/sig/cadenya/models/ai_provider_key_list_params.rbs

@@ -4,6 +4,7 @@ module Cadenya
       {
         workspace_id: String,
         cursor: String,
+        include_info: bool,
         limit: Integer,
         prefix: String,
         query: String,
@@ -21,6 +22,10 @@ module Cadenya
 
       def cursor=: (String) -> String
 
+      attr_reader include_info: bool?
+
+      def include_info=: (bool) -> bool
+
       attr_reader limit: Integer?
 
       def limit=: (Integer) -> Integer
@@ -40,6 +45,7 @@ module Cadenya
       def initialize: (
         workspace_id: String,
         ?cursor: String,
+        ?include_info: bool,
         ?limit: Integer,
         ?prefix: String,
         ?query: String,
@@ -50,6 +56,7 @@ module Cadenya
       def to_hash: -> {
         workspace_id: String,
         cursor: String,
+        include_info: bool,
         limit: Integer,
         prefix: String,
         query: String,

data/sig/cadenya/models/ai_provider_key_spec.rbs

@@ -1,28 +1,49 @@
 module Cadenya
   module Models
     type ai_provider_key_spec =
-      { api_key: String, provider: String, region: String }
+      {
+        api_key: String,
+        openrouter: top,
+        provider: Cadenya::Models::AIProviderKeySpec::provider
+      }
 
     class AIProviderKeySpec < Cadenya::Internal::Type::BaseModel
       attr_reader api_key: String?
 
       def api_key=: (String) -> String
 
-      attr_reader provider: String?
+      attr_reader openrouter: top?
 
-      def provider=: (String) -> String
+      def openrouter=: (top) -> top
 
-      attr_reader region: String?
+      attr_reader provider: Cadenya::Models::AIProviderKeySpec::provider?
 
-      def region=: (String) -> String
+      def provider=: (
+        Cadenya::Models::AIProviderKeySpec::provider
+      ) -> Cadenya::Models::AIProviderKeySpec::provider
 
       def initialize: (
         ?api_key: String,
-        ?provider: String,
-        ?region: String
+        ?openrouter: top,
+        ?provider: Cadenya::Models::AIProviderKeySpec::provider
       ) -> void
 
-      def to_hash: -> { api_key: String, provider: String, region: String }
+      def to_hash: -> {
+        api_key: String,
+        openrouter: top,
+        provider: Cadenya::Models::AIProviderKeySpec::provider
+      }
+
+      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::AIProviderKeySpec::provider]
+      end
     end
   end
 end

data/sig/cadenya/models/model.rbs

@@ -1,22 +1,71 @@
 module Cadenya
   module Models
     type model =
-      { metadata: Cadenya::ResourceMetadata, spec: Cadenya::ModelSpec }
+      {
+        metadata: Cadenya::ResourceMetadata,
+        spec: Cadenya::ModelSpec,
+        info: Cadenya::Model::Info
+      }
 
     class Model < Cadenya::Internal::Type::BaseModel
       attr_accessor metadata: Cadenya::ResourceMetadata
 
       attr_accessor spec: Cadenya::ModelSpec
 
+      attr_reader info: Cadenya::Model::Info?
+
+      def info=: (Cadenya::Model::Info) -> Cadenya::Model::Info
+
       def initialize: (
         metadata: Cadenya::ResourceMetadata,
-        spec: Cadenya::ModelSpec
+        spec: Cadenya::ModelSpec,
+        ?info: Cadenya::Model::Info
       ) -> void
 
       def to_hash: -> {
         metadata: Cadenya::ResourceMetadata,
-        spec: Cadenya::ModelSpec
+        spec: Cadenya::ModelSpec,
+        info: Cadenya::Model::Info
       }
+
+      type info =
+        {
+          ai_provider_key: Cadenya::BareMetadata,
+          provider: Cadenya::Models::Model::Info::provider
+        }
+
+      class Info < Cadenya::Internal::Type::BaseModel
+        attr_reader ai_provider_key: Cadenya::BareMetadata?
+
+        def ai_provider_key=: (Cadenya::BareMetadata) -> Cadenya::BareMetadata
+
+        attr_reader provider: Cadenya::Models::Model::Info::provider?
+
+        def provider=: (
+          Cadenya::Models::Model::Info::provider
+        ) -> Cadenya::Models::Model::Info::provider
+
+        def initialize: (
+          ?ai_provider_key: Cadenya::BareMetadata,
+          ?provider: Cadenya::Models::Model::Info::provider
+        ) -> void
+
+        def to_hash: -> {
+          ai_provider_key: Cadenya::BareMetadata,
+          provider: Cadenya::Models::Model::Info::provider
+        }
+
+        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
 end

data/sig/cadenya/models/model_list_params.rbs

@@ -3,8 +3,10 @@ module Cadenya
     type model_list_params =
       {
         workspace_id: String,
+        ai_provider_key_id: String,
         bundle_key: String,
         cursor: String,
+        include_info: bool,
         limit: Integer,
         prefix: String,
         query: String,
@@ -19,6 +21,10 @@ module Cadenya
 
       attr_accessor workspace_id: String
 
+      attr_reader ai_provider_key_id: String?
+
+      def ai_provider_key_id=: (String) -> String
+
       attr_reader bundle_key: String?
 
       def bundle_key=: (String) -> String
@@ -27,6 +33,10 @@ module Cadenya
 
       def cursor=: (String) -> String
 
+      attr_reader include_info: bool?
+
+      def include_info=: (bool) -> bool
+
       attr_reader limit: Integer?
 
       def limit=: (Integer) -> Integer
@@ -51,8 +61,10 @@ module Cadenya
 
       def initialize: (
         workspace_id: String,
+        ?ai_provider_key_id: String,
         ?bundle_key: String,
         ?cursor: String,
+        ?include_info: bool,
         ?limit: Integer,
         ?prefix: String,
         ?query: String,
@@ -63,8 +75,10 @@ module Cadenya
 
       def to_hash: -> {
         workspace_id: String,
+        ai_provider_key_id: String,
         bundle_key: String,
         cursor: String,
+        include_info: bool,
         limit: Integer,
         prefix: String,
         query: String,

data/sig/cadenya/resources/ai_provider_keys.rbs

@@ -26,6 +26,7 @@ module Cadenya
       def list: (
         String workspace_id,
         ?cursor: String,
+        ?include_info: bool,
         ?limit: Integer,
         ?prefix: String,
         ?query: String,

data/sig/cadenya/resources/models.rbs

@@ -9,8 +9,10 @@ module Cadenya
 
       def list: (
         String workspace_id,
+        ?ai_provider_key_id: String,
         ?bundle_key: String,
         ?cursor: String,
+        ?include_info: 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.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Cadenya