cadenya 0.48.0 → 0.50.0

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.

data/lib/cadenya/models/ai_provider_key_update_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 id
       #
@@ -36,14 +36,14 @@ module Cadenya
       #   @return [String, nil]
       optional :update_mask, String, api_name: :updateMask
 
-      # @!method initialize(workspace_id:, id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+      # @!method initialize(id:, workspace_id: nil, metadata: nil, spec: nil, update_mask: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::AIProviderKeyUpdateParams} for more details.
       #
-      #   @param workspace_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::AIProviderKeySpec]

data/lib/cadenya/models/api_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
       #   CreateAccountResourceMetadata contains the user-provided fields for creating an
@@ -26,16 +26,16 @@ module Cadenya
       #   @return [Cadenya::Models::APIKeySpec]
       required :spec, -> { Cadenya::APIKeySpec }
 
-      # @!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::APIKeyCreateParams} for more details.
       #
-      #   @param workspace_id [String]
-      #
       #   @param metadata [Cadenya::Models::APIKeyCreateParams::Metadata] CreateAccountResourceMetadata contains the user-provided fields for creating
       #
       #   @param spec [Cadenya::Models::APIKeySpec] Configuration for an API key.
       #
+      #   @param workspace_id [String]
+      #
       #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
 
       class Metadata < Cadenya::Internal::Type::BaseModel

data/lib/cadenya/models/api_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/api_key_disable_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/api_key_enable_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/api_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.
@@ -57,7 +57,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, query: nil, sort_order: nil, request_options: {})
+      # @!method initialize(workspace_id: nil, cursor: nil, include_info: nil, labels: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::APIKeyListParams} for more details.
       #

data/lib/cadenya/models/api_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/api_key_rotate_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/api_key_update_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 id
       #
@@ -37,14 +37,14 @@ module Cadenya
       #   @return [String, nil]
       optional :update_mask, String, api_name: :updateMask
 
-      # @!method initialize(workspace_id:, id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+      # @!method initialize(id:, workspace_id: nil, metadata: nil, spec: nil, update_mask: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::APIKeyUpdateParams} for more details.
       #
-      #   @param workspace_id [String]
-      #
       #   @param id [String]
       #
+      #   @param workspace_id [String]
+      #
       #   @param metadata [Cadenya::Models::APIKeyUpdateParams::Metadata] UpdateAccountResourceMetadata contains the user-provided fields for updating
       #
       #   @param spec [Cadenya::Models::APIKeySpec] Configuration for an API key.

data/lib/cadenya/models/approval_requirement_filter.rb

@@ -2,25 +2,19 @@
 
 module Cadenya
   module Models
-    class ApprovalRequirementFilter < Cadenya::Internal::Type::BaseModel
-      # @!attribute always
-      #
-      #   @return [Boolean, nil]
-      optional :always, Cadenya::Internal::Type::Boolean
+    # Approval filters that will automatically set the approval requirement on tools
+    # synced from an external source
+    module ApprovalRequirementFilter
+      extend Cadenya::Internal::Type::Union
 
-      # @!attribute only
-      #   Top-level filter with simple boolean logic (no nesting)
-      #
-      #   @return [Cadenya::Models::ToolFilter, nil]
-      optional :only, -> { Cadenya::ToolFilter }
+      discriminator :type
 
-      # @!method initialize(always: nil, only: nil)
-      #   Approval filters that will automatically set the approval requirement on tools
-      #   synced from an external source
-      #
-      #   @param always [Boolean]
-      #
-      #   @param only [Cadenya::Models::ToolFilter] Top-level filter with simple boolean logic (no nesting)
+      variant :always, -> { Cadenya::ApprovalRequirementFilterAlways }
+
+      variant :only, -> { Cadenya::ApprovalRequirementFilterOnly }
+
+      # @!method self.variants
+      #   @return [Array(Cadenya::Models::ApprovalRequirementFilterAlways, Cadenya::Models::ApprovalRequirementFilterOnly)]
     end
   end
 end

data/lib/cadenya/models/approval_requirement_filter_always.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ApprovalRequirementFilterAlways < Cadenya::Internal::Type::BaseModel
+      # @!attribute always
+      #
+      #   @return [Boolean]
+      required :always, Cadenya::Internal::Type::Boolean
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Cadenya::Models::ApprovalRequirementFilterAlways::Type]
+      required :type, enum: -> { Cadenya::ApprovalRequirementFilterAlways::Type }
+
+      # @!method initialize(always:, type:)
+      #   @param always [Boolean]
+      #   @param type [Symbol, Cadenya::Models::ApprovalRequirementFilterAlways::Type]
+
+      # @see Cadenya::Models::ApprovalRequirementFilterAlways#type
+      module Type
+        extend Cadenya::Internal::Type::Enum
+
+        ALWAYS = :always
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/approval_requirement_filter_only.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ApprovalRequirementFilterOnly < Cadenya::Internal::Type::BaseModel
+      # @!attribute only
+      #   Top-level filter with simple boolean logic (no nesting)
+      #
+      #   @return [Cadenya::Models::ToolFilter]
+      required :only, -> { Cadenya::ToolFilter }
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Cadenya::Models::ApprovalRequirementFilterOnly::Type]
+      required :type, enum: -> { Cadenya::ApprovalRequirementFilterOnly::Type }
+
+      # @!method initialize(only:, type:)
+      #   @param only [Cadenya::Models::ToolFilter] Top-level filter with simple boolean logic (no nesting)
+      #
+      #   @param type [Symbol, Cadenya::Models::ApprovalRequirementFilterOnly::Type]
+
+      # @see Cadenya::Models::ApprovalRequirementFilterOnly#type
+      module Type
+        extend Cadenya::Internal::Type::Enum
+
+        ONLY = :only
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/assistant_tool_call.rb

@@ -19,8 +19,8 @@ module Cadenya
       #   user-defined tool (IE: MCP, HTTP), another Agent (useful to separate context),
       #   or a Cadenya Tool (one Cadenya provides).
       #
-      #   @return [Cadenya::Models::CallableTool, nil]
-      optional :tool, -> { Cadenya::CallableTool }
+      #   @return [Cadenya::Models::CallableToolTool, Cadenya::Models::CallableToolAgent, Cadenya::Models::CallableToolCadenyaProvidedTool, nil]
+      optional :tool, union: -> { Cadenya::CallableTool }
 
       # @!method initialize(arguments: nil, function_name: nil, tool: nil)
       #   Some parameter documentations has been truncated, see
@@ -30,7 +30,7 @@ module Cadenya
       #
       #   @param function_name [String]
       #
-      #   @param tool [Cadenya::Models::CallableTool] CallableTool is a union that represents a tool that can be called by an agent. I
+      #   @param tool [Cadenya::Models::CallableToolTool, Cadenya::Models::CallableToolAgent, Cadenya::Models::CallableToolCadenyaProvidedTool] CallableTool is a union that represents a tool that can be called by an agent. I
     end
   end
 end

data/lib/cadenya/models/attribute_filter.rb

@@ -11,15 +11,15 @@ module Cadenya
       # @!attribute matcher
       #   String matching operations
       #
-      #   @return [Cadenya::Models::StringMatcher, nil]
-      optional :matcher, -> { Cadenya::StringMatcher }
+      #   @return [Cadenya::Models::StringMatcherExact, Cadenya::Models::StringMatcherStartsWith, Cadenya::Models::StringMatcherEndsWith, Cadenya::Models::StringMatcherContains, Cadenya::Models::StringMatcherRegex, nil]
+      optional :matcher, union: -> { Cadenya::StringMatcher }
 
       # @!method initialize(attribute:, matcher: nil)
       #   Single attribute filter
       #
       #   @param attribute [Symbol, Cadenya::Models::AttributeFilter::Attribute]
       #
-      #   @param matcher [Cadenya::Models::StringMatcher] String matching operations
+      #   @param matcher [Cadenya::Models::StringMatcherExact, Cadenya::Models::StringMatcherStartsWith, Cadenya::Models::StringMatcherEndsWith, Cadenya::Models::StringMatcherContains, Cadenya::Models::StringMatcherRegex] String matching operations
 
       # @see Cadenya::Models::AttributeFilter#attribute
       module Attribute

data/lib/cadenya/models/callable_tool.rb

@@ -2,39 +2,23 @@
 
 module Cadenya
   module Models
-    class CallableTool < Cadenya::Internal::Type::BaseModel
-      # @!attribute agent
-      #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-      #
-      #   @return [Cadenya::Models::ResourceMetadata, nil]
-      optional :agent, -> { Cadenya::ResourceMetadata }
+    # CallableTool is a union that represents a tool that can be called by an agent.
+    # In Cadenya, a tool that is used within an agent objective might be a
+    # user-defined tool (IE: MCP, HTTP), another Agent (useful to separate context),
+    # or a Cadenya Tool (one Cadenya provides).
+    module CallableTool
+      extend Cadenya::Internal::Type::Union
 
-      # @!attribute cadenya_provided_tool
-      #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-      #
-      #   @return [Cadenya::Models::ResourceMetadata, nil]
-      optional :cadenya_provided_tool, -> { Cadenya::ResourceMetadata }, api_name: :cadenyaProvidedTool
+      discriminator :type
 
-      # @!attribute tool
-      #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-      #
-      #   @return [Cadenya::Models::ResourceMetadata, nil]
-      optional :tool, -> { Cadenya::ResourceMetadata }
+      variant :tool, -> { Cadenya::CallableToolTool }
 
-      # @!method initialize(agent: nil, cadenya_provided_tool: nil, tool: nil)
-      #   Some parameter documentations has been truncated, see
-      #   {Cadenya::Models::CallableTool} for more details.
-      #
-      #   CallableTool is a union that represents a tool that can be called by an agent.
-      #   In Cadenya, a tool that is used within an agent objective might be a
-      #   user-defined tool (IE: MCP, HTTP), another Agent (useful to separate context),
-      #   or a Cadenya Tool (one Cadenya provides).
-      #
-      #   @param agent [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-      #
-      #   @param cadenya_provided_tool [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-      #
-      #   @param tool [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+      variant :agent, -> { Cadenya::CallableToolAgent }
+
+      variant :cadenyaProvidedTool, -> { Cadenya::CallableToolCadenyaProvidedTool }
+
+      # @!method self.variants
+      #   @return [Array(Cadenya::Models::CallableToolTool, Cadenya::Models::CallableToolAgent, Cadenya::Models::CallableToolCadenyaProvidedTool)]
     end
   end
 end