cadenya 0.49.0 → 0.50.0

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

@@ -10,8 +10,8 @@ module Cadenya
 
         # @!attribute workspace_id
         #
-        #   @return [String]
-        required :workspace_id, String
+        #   @return [String, nil]
+        optional :workspace_id, String
 
         # @!attribute agent_id
         #
@@ -34,15 +34,15 @@ module Cadenya
         #   @return [Integer, nil]
         optional :position, Integer
 
-        # @!method initialize(workspace_id:, agent_id:, variation_id:, id:, position: nil, request_options: {})
-        #   @param workspace_id [String]
-        #
+        # @!method initialize(agent_id:, variation_id:, id:, workspace_id: nil, position: nil, request_options: {})
         #   @param agent_id [String]
         #
         #   @param variation_id [String]
         #
         #   @param id [String]
         #
+        #   @param workspace_id [String]
+        #
         #   @param position [Integer] New position. Only field currently updatable on an assignment.
         #
         #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]

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

@@ -10,8 +10,8 @@ module Cadenya
 
         # @!attribute workspace_id
         #
-        #   @return [String]
-        required :workspace_id, String
+        #   @return [String, nil]
+        optional :workspace_id, String
 
         # @!attribute agent_id
         #
@@ -43,16 +43,16 @@ module Cadenya
         #   @return [String, nil]
         optional :update_mask, String, api_name: :updateMask
 
-        # @!method initialize(workspace_id:, agent_id:, id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+        # @!method initialize(agent_id:, id:, workspace_id: nil, metadata: nil, spec: nil, update_mask: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Agents::VariationUpdateParams} for more details.
         #
-        #   @param workspace_id [String]
-        #
         #   @param agent_id [String]
         #
         #   @param id [String]
         #
+        #   @param workspace_id [String]
+        #
         #   @param metadata [Cadenya::Models::UpdateResourceMetadata] UpdateResourceMetadata contains the user-provided fields for updating
         #
         #   @param spec [Cadenya::Models::Agents::AgentVariationSpec] AgentVariationSpec defines the operational configuration for a variation

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

@@ -10,8 +10,8 @@ module Cadenya
 
         # @!attribute workspace_id
         #
-        #   @return [String]
-        required :workspace_id, String
+        #   @return [String, nil]
+        optional :workspace_id, String
 
         # @!attribute agent_id
         #
@@ -50,14 +50,14 @@ module Cadenya
         #   @return [String, nil]
         optional :objective_id, String
 
-        # @!method initialize(workspace_id:, agent_id:, cursor: nil, event_type: nil, labels: nil, limit: nil, objective_id: nil, request_options: {})
+        # @!method initialize(agent_id:, workspace_id: nil, cursor: nil, event_type: nil, labels: nil, limit: nil, objective_id: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Agents::WebhookDeliveryListParams} for more details.
         #
-        #   @param workspace_id [String]
-        #
         #   @param agent_id [String]
         #
+        #   @param workspace_id [String]
+        #
         #   @param cursor [String] Pagination cursor from previous response
         #
         #   @param event_type [Symbol, Cadenya::Models::Agents::WebhookDeliveryListParams::EventType] Optional filter by event type

data/lib/cadenya/models/ai_provider_config_openai.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class AIProviderConfigOpenAI < Cadenya::Internal::Type::BaseModel
+      # @!attribute openai
+      #   OpenAIConfig holds OpenAI-specific settings.
+      #
+      #   @return [Cadenya::Models::AIProviderConfigOpenAI::OpenAI]
+      required :openai, -> { Cadenya::AIProviderConfigOpenAI::OpenAI }
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Cadenya::Models::AIProviderConfigOpenAI::Type]
+      required :type, enum: -> { Cadenya::AIProviderConfigOpenAI::Type }
+
+      # @!method initialize(openai:, type:)
+      #   @param openai [Cadenya::Models::AIProviderConfigOpenAI::OpenAI] OpenAIConfig holds OpenAI-specific settings.
+      #
+      #   @param type [Symbol, Cadenya::Models::AIProviderConfigOpenAI::Type]
+
+      # @see Cadenya::Models::AIProviderConfigOpenAI#openai
+      class OpenAI < Cadenya::Internal::Type::BaseModel
+        # @!attribute organization_id
+        #   Sent as the OpenAI-Organization header when set.
+        #
+        #   @return [String, nil]
+        optional :organization_id, String, api_name: :organizationId
+
+        # @!attribute project_id
+        #   Sent as the OpenAI-Project header when set.
+        #
+        #   @return [String, nil]
+        optional :project_id, String, api_name: :projectId
+
+        # @!method initialize(organization_id: nil, project_id: nil)
+        #   OpenAIConfig holds OpenAI-specific settings.
+        #
+        #   @param organization_id [String] Sent as the OpenAI-Organization header when set.
+        #
+        #   @param project_id [String] Sent as the OpenAI-Project header when set.
+      end
+
+      # @see Cadenya::Models::AIProviderConfigOpenAI#type
+      module Type
+        extend Cadenya::Internal::Type::Enum
+
+        OPENAI = :openai
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/ai_provider_config_openai_compatible.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class AIProviderConfigOpenAICompatible < Cadenya::Internal::Type::BaseModel
+      # @!attribute openai_compatible
+      #   OpenAICompatibleConfig configures a generic endpoint that speaks the OpenAI Chat
+      #   Completions API. The base URL is required and its model catalog is discovered
+      #   live via GET {base_url}/models.
+      #
+      #   @return [Cadenya::Models::AIProviderConfigOpenAICompatible::OpenAICompatible]
+      required :openai_compatible,
+               -> { Cadenya::AIProviderConfigOpenAICompatible::OpenAICompatible },
+               api_name: :openaiCompatible
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Cadenya::Models::AIProviderConfigOpenAICompatible::Type]
+      required :type, enum: -> { Cadenya::AIProviderConfigOpenAICompatible::Type }
+
+      # @!method initialize(openai_compatible:, type:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::AIProviderConfigOpenAICompatible} for more details.
+      #
+      #   @param openai_compatible [Cadenya::Models::AIProviderConfigOpenAICompatible::OpenAICompatible] OpenAICompatibleConfig configures a generic endpoint that speaks the OpenAI
+      #
+      #   @param type [Symbol, Cadenya::Models::AIProviderConfigOpenAICompatible::Type]
+
+      # @see Cadenya::Models::AIProviderConfigOpenAICompatible#openai_compatible
+      class OpenAICompatible < Cadenya::Internal::Type::BaseModel
+        # @!attribute base_url
+        #
+        #   @return [String]
+        required :base_url, String, api_name: :baseUrl
+
+        # @!method initialize(base_url:)
+        #   OpenAICompatibleConfig configures a generic endpoint that speaks the OpenAI Chat
+        #   Completions API. The base URL is required and its model catalog is discovered
+        #   live via GET {base_url}/models.
+        #
+        #   @param base_url [String]
+      end
+
+      # @see Cadenya::Models::AIProviderConfigOpenAICompatible#type
+      module Type
+        extend Cadenya::Internal::Type::Enum
+
+        OPENAI_COMPATIBLE = :openaiCompatible
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/ai_provider_config_openrouter.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class AIProviderConfigOpenrouter < Cadenya::Internal::Type::BaseModel
+      # @!attribute openrouter
+      #   OpenRouterConfig holds OpenRouter-specific settings.
+      #
+      #   @return [Cadenya::Models::AIProviderConfigOpenrouter::Openrouter]
+      required :openrouter, -> { Cadenya::AIProviderConfigOpenrouter::Openrouter }
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Cadenya::Models::AIProviderConfigOpenrouter::Type]
+      required :type, enum: -> { Cadenya::AIProviderConfigOpenrouter::Type }
+
+      # @!method initialize(openrouter:, type:)
+      #   @param openrouter [Cadenya::Models::AIProviderConfigOpenrouter::Openrouter] OpenRouterConfig holds OpenRouter-specific settings.
+      #
+      #   @param type [Symbol, Cadenya::Models::AIProviderConfigOpenrouter::Type]
+
+      # @see Cadenya::Models::AIProviderConfigOpenrouter#openrouter
+      class Openrouter < Cadenya::Internal::Type::BaseModel
+        # @!attribute region
+        #   Data-residency region (e.g. "us", "eu"). Empty uses the provider default.
+        #
+        #   @return [String, nil]
+        optional :region, String
+
+        # @!method initialize(region: nil)
+        #   OpenRouterConfig holds OpenRouter-specific settings.
+        #
+        #   @param region [String] Data-residency region (e.g. "us", "eu"). Empty uses the provider default.
+      end
+
+      # @see Cadenya::Models::AIProviderConfigOpenrouter#type
+      module Type
+        extend Cadenya::Internal::Type::Enum
+
+        OPENROUTER = :openrouter
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/ai_provider_credential_api_key.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class AIProviderCredentialAPIKey < Cadenya::Internal::Type::BaseModel
+      # @!attribute api_key
+      #   CredentialAPIKey carries a single bearer/header API key.
+      #
+      #   @return [Cadenya::Models::AIProviderCredentialAPIKey::APIKey]
+      required :api_key, -> { Cadenya::AIProviderCredentialAPIKey::APIKey }, api_name: :apiKey
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Cadenya::Models::AIProviderCredentialAPIKey::Type]
+      required :type, enum: -> { Cadenya::AIProviderCredentialAPIKey::Type }
+
+      # @!method initialize(api_key:, type:)
+      #   @param api_key [Cadenya::Models::AIProviderCredentialAPIKey::APIKey] CredentialAPIKey carries a single bearer/header API key.
+      #
+      #   @param type [Symbol, Cadenya::Models::AIProviderCredentialAPIKey::Type]
+
+      # @see Cadenya::Models::AIProviderCredentialAPIKey#api_key
+      class APIKey < Cadenya::Internal::Type::BaseModel
+        # @!attribute api_key
+        #
+        #   @return [String, nil]
+        optional :api_key, String, api_name: :apiKey
+
+        # @!method initialize(api_key: nil)
+        #   CredentialAPIKey carries a single bearer/header API key.
+        #
+        #   @param api_key [String]
+      end
+
+      # @see Cadenya::Models::AIProviderCredentialAPIKey#type
+      module Type
+        extend Cadenya::Internal::Type::Enum
+
+        API_KEY = :apiKey
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/ai_provider_credential_headers.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class AIProviderCredentialHeaders < Cadenya::Internal::Type::BaseModel
+      # @!attribute headers
+      #   CredentialHeaders carries arbitrary HTTP headers sent with every request to the
+      #   provider (e.g. {"Authorization": "Bearer ...", "X-Api-Key": "..."}).
+      #
+      #   @return [Cadenya::Models::AIProviderCredentialHeaders::Headers]
+      required :headers, -> { Cadenya::AIProviderCredentialHeaders::Headers }
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Cadenya::Models::AIProviderCredentialHeaders::Type]
+      required :type, enum: -> { Cadenya::AIProviderCredentialHeaders::Type }
+
+      # @!method initialize(headers:, type:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::AIProviderCredentialHeaders} for more details.
+      #
+      #   @param headers [Cadenya::Models::AIProviderCredentialHeaders::Headers] CredentialHeaders carries arbitrary HTTP headers sent with every request to
+      #
+      #   @param type [Symbol, Cadenya::Models::AIProviderCredentialHeaders::Type]
+
+      # @see Cadenya::Models::AIProviderCredentialHeaders#headers
+      class Headers < Cadenya::Internal::Type::BaseModel
+        # @!attribute headers
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :headers, Cadenya::Internal::Type::HashOf[String]
+
+        # @!method initialize(headers: nil)
+        #   CredentialHeaders carries arbitrary HTTP headers sent with every request to the
+        #   provider (e.g. {"Authorization": "Bearer ...", "X-Api-Key": "..."}).
+        #
+        #   @param headers [Hash{Symbol=>String}]
+      end
+
+      # @see Cadenya::Models::AIProviderCredentialHeaders#type
+      module Type
+        extend Cadenya::Internal::Type::Enum
+
+        HEADERS = :headers
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/ai_provider_key_create_params.rb

@@ -9,8 +9,8 @@ module Cadenya
 
       # @!attribute workspace_id
       #
-      #   @return [String]
-      required :workspace_id, String
+      #   @return [String, nil]
+      optional :workspace_id, String
 
       # @!attribute metadata
       #   CreateResourceMetadata contains the user-provided fields for creating a
@@ -25,16 +25,16 @@ module Cadenya
       #   @return [Cadenya::Models::AIProviderKeySpec]
       required :spec, -> { Cadenya::AIProviderKeySpec }
 
-      # @!method initialize(workspace_id:, metadata:, spec:, request_options: {})
+      # @!method initialize(metadata:, spec:, workspace_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::AIProviderKeyCreateParams} for more details.
       #
-      #   @param workspace_id [String]
-      #
       #   @param metadata [Cadenya::Models::CreateResourceMetadata] CreateResourceMetadata contains the user-provided fields for creating
       #
       #   @param spec [Cadenya::Models::AIProviderKeySpec]
       #
+      #   @param workspace_id [String]
+      #
       #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/cadenya/models/ai_provider_key_delete_params.rb

@@ -9,17 +9,17 @@ module Cadenya
 
       # @!attribute workspace_id
       #
-      #   @return [String]
-      required :workspace_id, String
+      #   @return [String, nil]
+      optional :workspace_id, String
 
       # @!attribute id
       #
       #   @return [String]
       required :id, String
 
-      # @!method initialize(workspace_id:, id:, request_options: {})
-      #   @param workspace_id [String]
+      # @!method initialize(id:, workspace_id: nil, request_options: {})
       #   @param id [String]
+      #   @param workspace_id [String]
       #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/cadenya/models/ai_provider_key_list_params.rb

@@ -9,8 +9,8 @@ module Cadenya
 
       # @!attribute workspace_id
       #
-      #   @return [String]
-      required :workspace_id, String
+      #   @return [String, nil]
+      optional :workspace_id, String
 
       # @!attribute cursor
       #   Pagination cursor from previous response
@@ -65,7 +65,7 @@ module Cadenya
       #   @return [String, nil]
       optional :sort_order, String
 
-      # @!method initialize(workspace_id:, cursor: nil, include_info: nil, labels: nil, limit: nil, prefix: nil, promotional: nil, query: nil, sort_order: nil, request_options: {})
+      # @!method initialize(workspace_id: nil, cursor: nil, include_info: nil, labels: 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.
       #

data/lib/cadenya/models/ai_provider_key_retrieve_params.rb

@@ -9,17 +9,17 @@ module Cadenya
 
       # @!attribute workspace_id
       #
-      #   @return [String]
-      required :workspace_id, String
+      #   @return [String, nil]
+      optional :workspace_id, String
 
       # @!attribute id
       #
       #   @return [String]
       required :id, String
 
-      # @!method initialize(workspace_id:, id:, request_options: {})
-      #   @param workspace_id [String]
+      # @!method initialize(id:, workspace_id: nil, request_options: {})
       #   @param id [String]
+      #   @param workspace_id [String]
       #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/cadenya/models/ai_provider_key_spec.rb

@@ -10,16 +10,16 @@ module Cadenya
       #   intentionally not overridable here; use the OpenAI-compatible provider to target
       #   a custom endpoint.
       #
-      #   @return [Cadenya::Models::AIProviderKeySpec::Config, nil]
-      optional :config, -> { Cadenya::AIProviderKeySpec::Config }
+      #   @return [Cadenya::Models::AIProviderConfigOpenrouter, Cadenya::Models::AIProviderConfigOpenAI, Cadenya::Models::AIProviderConfigOpenAICompatible, nil]
+      optional :config, union: -> { Cadenya::AIProviderKeySpec::Config }
 
       # @!attribute credentials
       #   AIProviderCredential is the secret material used to authenticate with a
       #   provider. The set case must correspond to AIProviderKeySpec.provider. The server
       #   encrypts the serialized message at rest and never returns it on reads.
       #
-      #   @return [Cadenya::Models::AIProviderKeySpec::Credentials, nil]
-      optional :credentials, -> { Cadenya::AIProviderKeySpec::Credentials }
+      #   @return [Cadenya::Models::AIProviderCredentialAPIKey, Cadenya::Models::AIProviderCredentialHeaders, nil]
+      optional :credentials, union: -> { Cadenya::AIProviderKeySpec::Credentials }
 
       # @!attribute provider
       #   The AI provider this key authenticates against.
@@ -31,157 +31,50 @@ module Cadenya
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::AIProviderKeySpec} for more details.
       #
-      #   @param config [Cadenya::Models::AIProviderKeySpec::Config] AIProviderConfig holds non-secret, provider-specific settings. The set case
+      #   @param config [Cadenya::Models::AIProviderConfigOpenrouter, Cadenya::Models::AIProviderConfigOpenAI, Cadenya::Models::AIProviderConfigOpenAICompatible] AIProviderConfig holds non-secret, provider-specific settings. The set case
       #
-      #   @param credentials [Cadenya::Models::AIProviderKeySpec::Credentials] AIProviderCredential is the secret material used to authenticate with a
+      #   @param credentials [Cadenya::Models::AIProviderCredentialAPIKey, Cadenya::Models::AIProviderCredentialHeaders] AIProviderCredential is the secret material used to authenticate with a
       #
       #   @param provider [Symbol, Cadenya::Models::AIProviderKeySpec::Provider] The AI provider this key authenticates against.
 
+      # AIProviderConfig holds non-secret, provider-specific settings. The set case must
+      # correspond to AIProviderKeySpec.provider. Providers with no settings (Anthropic,
+      # Gemini) simply leave this unset. The endpoint of a named provider is fixed and
+      # intentionally not overridable here; use the OpenAI-compatible provider to target
+      # a custom endpoint.
+      #
       # @see Cadenya::Models::AIProviderKeySpec#config
-      class Config < Cadenya::Internal::Type::BaseModel
-        # @!attribute openai
-        #   OpenAIConfig holds OpenAI-specific settings.
-        #
-        #   @return [Cadenya::Models::AIProviderKeySpec::Config::OpenAI, nil]
-        optional :openai, -> { Cadenya::AIProviderKeySpec::Config::OpenAI }
-
-        # @!attribute openai_compatible
-        #   OpenAICompatibleConfig configures a generic endpoint that speaks the OpenAI Chat
-        #   Completions API. The base URL is required and its model catalog is discovered
-        #   live via GET {base_url}/models.
-        #
-        #   @return [Cadenya::Models::AIProviderKeySpec::Config::OpenAICompatible, nil]
-        optional :openai_compatible,
-                 -> { Cadenya::AIProviderKeySpec::Config::OpenAICompatible },
-                 api_name: :openaiCompatible
-
-        # @!attribute openrouter
-        #   OpenRouterConfig holds OpenRouter-specific settings.
-        #
-        #   @return [Cadenya::Models::AIProviderKeySpec::Config::Openrouter, nil]
-        optional :openrouter, -> { Cadenya::AIProviderKeySpec::Config::Openrouter }
-
-        # @!method initialize(openai: nil, openai_compatible: nil, openrouter: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {Cadenya::Models::AIProviderKeySpec::Config} for more details.
-        #
-        #   AIProviderConfig holds non-secret, provider-specific settings. The set case must
-        #   correspond to AIProviderKeySpec.provider. Providers with no settings (Anthropic,
-        #   Gemini) simply leave this unset. The endpoint of a named provider is fixed and
-        #   intentionally not overridable here; use the OpenAI-compatible provider to target
-        #   a custom endpoint.
-        #
-        #   @param openai [Cadenya::Models::AIProviderKeySpec::Config::OpenAI] OpenAIConfig holds OpenAI-specific settings.
-        #
-        #   @param openai_compatible [Cadenya::Models::AIProviderKeySpec::Config::OpenAICompatible] OpenAICompatibleConfig configures a generic endpoint that speaks the OpenAI
-        #
-        #   @param openrouter [Cadenya::Models::AIProviderKeySpec::Config::Openrouter] OpenRouterConfig holds OpenRouter-specific settings.
-
-        # @see Cadenya::Models::AIProviderKeySpec::Config#openai
-        class OpenAI < Cadenya::Internal::Type::BaseModel
-          # @!attribute organization_id
-          #   Sent as the OpenAI-Organization header when set.
-          #
-          #   @return [String, nil]
-          optional :organization_id, String, api_name: :organizationId
-
-          # @!attribute project_id
-          #   Sent as the OpenAI-Project header when set.
-          #
-          #   @return [String, nil]
-          optional :project_id, String, api_name: :projectId
-
-          # @!method initialize(organization_id: nil, project_id: nil)
-          #   OpenAIConfig holds OpenAI-specific settings.
-          #
-          #   @param organization_id [String] Sent as the OpenAI-Organization header when set.
-          #
-          #   @param project_id [String] Sent as the OpenAI-Project header when set.
-        end
-
-        # @see Cadenya::Models::AIProviderKeySpec::Config#openai_compatible
-        class OpenAICompatible < Cadenya::Internal::Type::BaseModel
-          # @!attribute base_url
-          #
-          #   @return [String, nil]
-          optional :base_url, String, api_name: :baseUrl
-
-          # @!method initialize(base_url: nil)
-          #   OpenAICompatibleConfig configures a generic endpoint that speaks the OpenAI Chat
-          #   Completions API. The base URL is required and its model catalog is discovered
-          #   live via GET {base_url}/models.
-          #
-          #   @param base_url [String]
-        end
-
-        # @see Cadenya::Models::AIProviderKeySpec::Config#openrouter
-        class Openrouter < Cadenya::Internal::Type::BaseModel
-          # @!attribute region
-          #   Data-residency region (e.g. "us", "eu"). Empty uses the provider default.
-          #
-          #   @return [String, nil]
-          optional :region, String
-
-          # @!method initialize(region: nil)
-          #   OpenRouterConfig holds OpenRouter-specific settings.
-          #
-          #   @param region [String] Data-residency region (e.g. "us", "eu"). Empty uses the provider default.
-        end
+      module Config
+        extend Cadenya::Internal::Type::Union
+
+        discriminator :type
+
+        variant :openrouter, -> { Cadenya::AIProviderConfigOpenrouter }
+
+        variant :openai, -> { Cadenya::AIProviderConfigOpenAI }
+
+        variant :openaiCompatible, -> { Cadenya::AIProviderConfigOpenAICompatible }
+
+        # @!method self.variants
+        #   @return [Array(Cadenya::Models::AIProviderConfigOpenrouter, Cadenya::Models::AIProviderConfigOpenAI, Cadenya::Models::AIProviderConfigOpenAICompatible)]
       end
 
+      # AIProviderCredential is the secret material used to authenticate with a
+      # provider. The set case must correspond to AIProviderKeySpec.provider. The server
+      # encrypts the serialized message at rest and never returns it on reads.
+      #
       # @see Cadenya::Models::AIProviderKeySpec#credentials
-      class Credentials < Cadenya::Internal::Type::BaseModel
-        # @!attribute api_key
-        #   CredentialAPIKey carries a single bearer/header API key.
-        #
-        #   @return [Cadenya::Models::AIProviderKeySpec::Credentials::APIKey, nil]
-        optional :api_key, -> { Cadenya::AIProviderKeySpec::Credentials::APIKey }, api_name: :apiKey
-
-        # @!attribute headers
-        #   CredentialHeaders carries arbitrary HTTP headers sent with every request to the
-        #   provider (e.g. {"Authorization": "Bearer ...", "X-Api-Key": "..."}).
-        #
-        #   @return [Cadenya::Models::AIProviderKeySpec::Credentials::Headers, nil]
-        optional :headers, -> { Cadenya::AIProviderKeySpec::Credentials::Headers }
-
-        # @!method initialize(api_key: nil, headers: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {Cadenya::Models::AIProviderKeySpec::Credentials} for more details.
-        #
-        #   AIProviderCredential is the secret material used to authenticate with a
-        #   provider. The set case must correspond to AIProviderKeySpec.provider. The server
-        #   encrypts the serialized message at rest and never returns it on reads.
-        #
-        #   @param api_key [Cadenya::Models::AIProviderKeySpec::Credentials::APIKey] CredentialAPIKey carries a single bearer/header API key.
-        #
-        #   @param headers [Cadenya::Models::AIProviderKeySpec::Credentials::Headers] CredentialHeaders carries arbitrary HTTP headers sent with every request to
-
-        # @see Cadenya::Models::AIProviderKeySpec::Credentials#api_key
-        class APIKey < Cadenya::Internal::Type::BaseModel
-          # @!attribute api_key
-          #
-          #   @return [String, nil]
-          optional :api_key, String, api_name: :apiKey
-
-          # @!method initialize(api_key: nil)
-          #   CredentialAPIKey carries a single bearer/header API key.
-          #
-          #   @param api_key [String]
-        end
-
-        # @see Cadenya::Models::AIProviderKeySpec::Credentials#headers
-        class Headers < Cadenya::Internal::Type::BaseModel
-          # @!attribute headers
-          #
-          #   @return [Hash{Symbol=>String}, nil]
-          optional :headers, Cadenya::Internal::Type::HashOf[String]
-
-          # @!method initialize(headers: nil)
-          #   CredentialHeaders carries arbitrary HTTP headers sent with every request to the
-          #   provider (e.g. {"Authorization": "Bearer ...", "X-Api-Key": "..."}).
-          #
-          #   @param headers [Hash{Symbol=>String}]
-        end
+      module Credentials
+        extend Cadenya::Internal::Type::Union
+
+        discriminator :type
+
+        variant :apiKey, -> { Cadenya::AIProviderCredentialAPIKey }
+
+        variant :headers, -> { Cadenya::AIProviderCredentialHeaders }
+
+        # @!method self.variants
+        #   @return [Array(Cadenya::Models::AIProviderCredentialAPIKey, Cadenya::Models::AIProviderCredentialHeaders)]
       end
 
       # The AI provider this key authenticates against.