cadenya 0.20.0 → 0.22.0

data/rbi/cadenya/models/agents/variation_list_params.rbi

@@ -21,13 +21,6 @@ module Cadenya
         sig { returns(String) }
         attr_accessor :agent_id
 
-        # Filter by bundle_key — return only resources owned by this bundle.
-        sig { returns(T.nilable(String)) }
-        attr_reader :bundle_key
-
-        sig { params(bundle_key: String).void }
-        attr_writer :bundle_key
-
         # Pagination cursor from previous response
         sig { returns(T.nilable(String)) }
         attr_reader :cursor
@@ -61,7 +54,6 @@ module Cadenya
           params(
             workspace_id: String,
             agent_id: String,
-            bundle_key: String,
             cursor: String,
             include_info: T::Boolean,
             limit: Integer,
@@ -72,8 +64,6 @@ module Cadenya
         def self.new(
           workspace_id:,
           agent_id:,
-          # Filter by bundle_key — return only resources owned by this bundle.
-          bundle_key: nil,
           # Pagination cursor from previous response
           cursor: nil,
           # When true, the `info` field on each returned variation is populated. Requests
@@ -92,7 +82,6 @@ module Cadenya
             {
               workspace_id: String,
               agent_id: String,
-              bundle_key: String,
               cursor: String,
               include_info: T::Boolean,
               limit: Integer,

data/rbi/cadenya/models/ai_provider_key_spec.rbi

@@ -8,22 +8,29 @@ module Cadenya
           T.any(Cadenya::AIProviderKeySpec, Cadenya::Internal::AnyHash)
         end
 
-      # The provider credential. Accepted on create/update; never populated in responses
-      # (the server returns an empty value to avoid leaking it).
-      sig { returns(T.nilable(String)) }
-      attr_reader :api_key
+      # 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.
+      sig { returns(T.nilable(Cadenya::AIProviderKeySpec::Config)) }
+      attr_reader :config
 
-      sig { params(api_key: String).void }
-      attr_writer :api_key
+      sig { params(config: Cadenya::AIProviderKeySpec::Config::OrHash).void }
+      attr_writer :config
 
-      # 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
+      # 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.
+      sig { returns(T.nilable(Cadenya::AIProviderKeySpec::Credentials)) }
+      attr_reader :credentials
 
-      sig { params(openrouter: T.anything).void }
-      attr_writer :openrouter
+      sig do
+        params(
+          credentials: Cadenya::AIProviderKeySpec::Credentials::OrHash
+        ).void
+      end
+      attr_writer :credentials
 
       # The AI provider this key authenticates against.
       sig { returns(T.nilable(Cadenya::AIProviderKeySpec::Provider::OrSymbol)) }
@@ -36,19 +43,22 @@ module Cadenya
 
       sig do
         params(
-          api_key: String,
-          openrouter: T.anything,
+          config: Cadenya::AIProviderKeySpec::Config::OrHash,
+          credentials: Cadenya::AIProviderKeySpec::Credentials::OrHash,
           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,
-        # 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,
+        # 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.
+        config: nil,
+        # 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.
+        credentials: nil,
         # The AI provider this key authenticates against.
         provider: nil
       )
@@ -57,8 +67,8 @@ module Cadenya
       sig do
         override.returns(
           {
-            api_key: String,
-            openrouter: T.anything,
+            config: Cadenya::AIProviderKeySpec::Config,
+            credentials: Cadenya::AIProviderKeySpec::Credentials,
             provider: Cadenya::AIProviderKeySpec::Provider::OrSymbol
           }
         )
@@ -66,6 +76,315 @@ module Cadenya
       def to_hash
       end
 
+      class Config < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::AIProviderKeySpec::Config,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # OpenAIConfig holds OpenAI-specific settings.
+        sig { returns(T.nilable(Cadenya::AIProviderKeySpec::Config::OpenAI)) }
+        attr_reader :openai
+
+        sig do
+          params(
+            openai: Cadenya::AIProviderKeySpec::Config::OpenAI::OrHash
+          ).void
+        end
+        attr_writer :openai
+
+        # 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.
+        sig do
+          returns(
+            T.nilable(Cadenya::AIProviderKeySpec::Config::OpenAICompatible)
+          )
+        end
+        attr_reader :openai_compatible
+
+        sig do
+          params(
+            openai_compatible:
+              Cadenya::AIProviderKeySpec::Config::OpenAICompatible::OrHash
+          ).void
+        end
+        attr_writer :openai_compatible
+
+        # OpenRouterConfig holds OpenRouter-specific settings.
+        sig do
+          returns(T.nilable(Cadenya::AIProviderKeySpec::Config::Openrouter))
+        end
+        attr_reader :openrouter
+
+        sig do
+          params(
+            openrouter: Cadenya::AIProviderKeySpec::Config::Openrouter::OrHash
+          ).void
+        end
+        attr_writer :openrouter
+
+        # 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.
+        sig do
+          params(
+            openai: Cadenya::AIProviderKeySpec::Config::OpenAI::OrHash,
+            openai_compatible:
+              Cadenya::AIProviderKeySpec::Config::OpenAICompatible::OrHash,
+            openrouter: Cadenya::AIProviderKeySpec::Config::Openrouter::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # OpenAIConfig holds OpenAI-specific settings.
+          openai: 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.
+          openai_compatible: nil,
+          # OpenRouterConfig holds OpenRouter-specific settings.
+          openrouter: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              openai: Cadenya::AIProviderKeySpec::Config::OpenAI,
+              openai_compatible:
+                Cadenya::AIProviderKeySpec::Config::OpenAICompatible,
+              openrouter: Cadenya::AIProviderKeySpec::Config::Openrouter
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class OpenAI < Cadenya::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Cadenya::AIProviderKeySpec::Config::OpenAI,
+                Cadenya::Internal::AnyHash
+              )
+            end
+
+          # Sent as the OpenAI-Organization header when set.
+          sig { returns(T.nilable(String)) }
+          attr_reader :organization_id
+
+          sig { params(organization_id: String).void }
+          attr_writer :organization_id
+
+          # Sent as the OpenAI-Project header when set.
+          sig { returns(T.nilable(String)) }
+          attr_reader :project_id
+
+          sig { params(project_id: String).void }
+          attr_writer :project_id
+
+          # OpenAIConfig holds OpenAI-specific settings.
+          sig do
+            params(organization_id: String, project_id: String).returns(
+              T.attached_class
+            )
+          end
+          def self.new(
+            # Sent as the OpenAI-Organization header when set.
+            organization_id: nil,
+            # Sent as the OpenAI-Project header when set.
+            project_id: nil
+          )
+          end
+
+          sig do
+            override.returns({ organization_id: String, project_id: String })
+          end
+          def to_hash
+          end
+        end
+
+        class OpenAICompatible < Cadenya::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Cadenya::AIProviderKeySpec::Config::OpenAICompatible,
+                Cadenya::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T.nilable(String)) }
+          attr_reader :base_url
+
+          sig { params(base_url: String).void }
+          attr_writer :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.
+          sig { params(base_url: String).returns(T.attached_class) }
+          def self.new(base_url: nil)
+          end
+
+          sig { override.returns({ base_url: String }) }
+          def to_hash
+          end
+        end
+
+        class Openrouter < Cadenya::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Cadenya::AIProviderKeySpec::Config::Openrouter,
+                Cadenya::Internal::AnyHash
+              )
+            end
+
+          # Data-residency region (e.g. "us", "eu"). Empty uses the provider default.
+          sig { returns(T.nilable(String)) }
+          attr_reader :region
+
+          sig { params(region: String).void }
+          attr_writer :region
+
+          # OpenRouterConfig holds OpenRouter-specific settings.
+          sig { params(region: String).returns(T.attached_class) }
+          def self.new(
+            # Data-residency region (e.g. "us", "eu"). Empty uses the provider default.
+            region: nil
+          )
+          end
+
+          sig { override.returns({ region: String }) }
+          def to_hash
+          end
+        end
+      end
+
+      class Credentials < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::AIProviderKeySpec::Credentials,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # CredentialAPIKey carries a single bearer/header API key.
+        sig do
+          returns(T.nilable(Cadenya::AIProviderKeySpec::Credentials::APIKey))
+        end
+        attr_reader :api_key
+
+        sig do
+          params(
+            api_key: Cadenya::AIProviderKeySpec::Credentials::APIKey::OrHash
+          ).void
+        end
+        attr_writer :api_key
+
+        # CredentialHeaders carries arbitrary HTTP headers sent with every request to the
+        # provider (e.g. {"Authorization": "Bearer ...", "X-Api-Key": "..."}).
+        sig do
+          returns(T.nilable(Cadenya::AIProviderKeySpec::Credentials::Headers))
+        end
+        attr_reader :headers
+
+        sig do
+          params(
+            headers: Cadenya::AIProviderKeySpec::Credentials::Headers::OrHash
+          ).void
+        end
+        attr_writer :headers
+
+        # 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.
+        sig do
+          params(
+            api_key: Cadenya::AIProviderKeySpec::Credentials::APIKey::OrHash,
+            headers: Cadenya::AIProviderKeySpec::Credentials::Headers::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # CredentialAPIKey carries a single bearer/header API key.
+          api_key: nil,
+          # CredentialHeaders carries arbitrary HTTP headers sent with every request to the
+          # provider (e.g. {"Authorization": "Bearer ...", "X-Api-Key": "..."}).
+          headers: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              api_key: Cadenya::AIProviderKeySpec::Credentials::APIKey,
+              headers: Cadenya::AIProviderKeySpec::Credentials::Headers
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class APIKey < Cadenya::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Cadenya::AIProviderKeySpec::Credentials::APIKey,
+                Cadenya::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T.nilable(String)) }
+          attr_reader :api_key
+
+          sig { params(api_key: String).void }
+          attr_writer :api_key
+
+          # CredentialAPIKey carries a single bearer/header API key.
+          sig { params(api_key: String).returns(T.attached_class) }
+          def self.new(api_key: nil)
+          end
+
+          sig { override.returns({ api_key: String }) }
+          def to_hash
+          end
+        end
+
+        class Headers < Cadenya::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Cadenya::AIProviderKeySpec::Credentials::Headers,
+                Cadenya::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T.nilable(T::Hash[Symbol, String])) }
+          attr_reader :headers
+
+          sig { params(headers: T::Hash[Symbol, String]).void }
+          attr_writer :headers
+
+          # CredentialHeaders carries arbitrary HTTP headers sent with every request to the
+          # provider (e.g. {"Authorization": "Bearer ...", "X-Api-Key": "..."}).
+          sig do
+            params(headers: T::Hash[Symbol, String]).returns(T.attached_class)
+          end
+          def self.new(headers: nil)
+          end
+
+          sig { override.returns({ headers: T::Hash[Symbol, String] }) }
+          def to_hash
+          end
+        end
+      end
+
       # The AI provider this key authenticates against.
       module Provider
         extend Cadenya::Internal::Type::Enum
@@ -84,6 +403,26 @@ module Cadenya
             :AI_PROVIDER_OPENROUTER,
             Cadenya::AIProviderKeySpec::Provider::TaggedSymbol
           )
+        AI_PROVIDER_OPENAI =
+          T.let(
+            :AI_PROVIDER_OPENAI,
+            Cadenya::AIProviderKeySpec::Provider::TaggedSymbol
+          )
+        AI_PROVIDER_ANTHROPIC =
+          T.let(
+            :AI_PROVIDER_ANTHROPIC,
+            Cadenya::AIProviderKeySpec::Provider::TaggedSymbol
+          )
+        AI_PROVIDER_GEMINI =
+          T.let(
+            :AI_PROVIDER_GEMINI,
+            Cadenya::AIProviderKeySpec::Provider::TaggedSymbol
+          )
+        AI_PROVIDER_OPENAI_COMPATIBLE =
+          T.let(
+            :AI_PROVIDER_OPENAI_COMPATIBLE,
+            Cadenya::AIProviderKeySpec::Provider::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/cadenya/models/api_key_list_params.rbi

@@ -11,13 +11,6 @@ module Cadenya
           T.any(Cadenya::APIKeyListParams, Cadenya::Internal::AnyHash)
         end
 
-      # Filter by bundle_key — return only resources owned by this bundle.
-      sig { returns(T.nilable(String)) }
-      attr_reader :bundle_key
-
-      sig { params(bundle_key: String).void }
-      attr_writer :bundle_key
-
       # Pagination cursor from previous response.
       sig { returns(T.nilable(String)) }
       attr_reader :cursor
@@ -63,7 +56,6 @@ module Cadenya
 
       sig do
         params(
-          bundle_key: String,
           cursor: String,
           include_info: T::Boolean,
           limit: Integer,
@@ -74,8 +66,6 @@ module Cadenya
         ).returns(T.attached_class)
       end
       def self.new(
-        # Filter by bundle_key — return only resources owned by this bundle.
-        bundle_key: nil,
         # Pagination cursor from previous response.
         cursor: nil,
         # When true, included info fields are populated. Requests with this flag count
@@ -96,7 +86,6 @@ module Cadenya
       sig do
         override.returns(
           {
-            bundle_key: String,
             cursor: String,
             include_info: T::Boolean,
             limit: Integer,

data/rbi/cadenya/models/create_resource_metadata.rbi

@@ -13,13 +13,6 @@ module Cadenya
       sig { returns(String) }
       attr_accessor :name
 
-      # Optional bundle ownership key. See ResourceMetadata.bundle_key.
-      sig { returns(T.nilable(String)) }
-      attr_reader :bundle_key
-
-      sig { params(bundle_key: String).void }
-      attr_writer :bundle_key
-
       # External ID for the resource (e.g., a workflow ID from an external system)
       sig { returns(T.nilable(String)) }
       attr_reader :external_id
@@ -41,7 +34,6 @@ module Cadenya
       sig do
         params(
           name: String,
-          bundle_key: String,
           external_id: String,
           labels: T::Hash[Symbol, String]
         ).returns(T.attached_class)
@@ -50,8 +42,6 @@ module Cadenya
         # Human-readable name for the resource (e.g., "Customer Support Agent", "Email
         # Tool")
         name:,
-        # Optional bundle ownership key. See ResourceMetadata.bundle_key.
-        bundle_key: nil,
         # External ID for the resource (e.g., a workflow ID from an external system)
         external_id: nil,
         # Arbitrary key-value pairs for categorization and filtering Examples:
@@ -62,12 +52,7 @@ module Cadenya
 
       sig do
         override.returns(
-          {
-            name: String,
-            bundle_key: String,
-            external_id: String,
-            labels: T::Hash[Symbol, String]
-          }
+          { name: String, external_id: String, labels: T::Hash[Symbol, String] }
         )
       end
       def to_hash

data/rbi/cadenya/models/memory_layer_list_params.rbi

@@ -21,13 +21,6 @@ module Cadenya
       sig { params(agent_id: String).void }
       attr_writer :agent_id
 
-      # Filter by bundle_key — return only resources owned by this bundle.
-      sig { returns(T.nilable(String)) }
-      attr_reader :bundle_key
-
-      sig { params(bundle_key: String).void }
-      attr_writer :bundle_key
-
       # Pagination cursor from previous response
       sig { returns(T.nilable(String)) }
       attr_reader :cursor
@@ -90,7 +83,6 @@ module Cadenya
         params(
           workspace_id: String,
           agent_id: String,
-          bundle_key: String,
           cursor: String,
           episodic_key_prefix: String,
           include_info: T::Boolean,
@@ -106,8 +98,6 @@ module Cadenya
         workspace_id:,
         # Filter to episodic layers belonging to this agent.
         agent_id: nil,
-        # Filter by bundle_key — return only resources owned by this bundle.
-        bundle_key: nil,
         # Pagination cursor from previous response
         cursor: nil,
         # Filter to episodic layers whose episodic key starts with this prefix (e.g.
@@ -135,7 +125,6 @@ module Cadenya
           {
             workspace_id: String,
             agent_id: String,
-            bundle_key: String,
             cursor: String,
             episodic_key_prefix: String,
             include_info: T::Boolean,

data/rbi/cadenya/models/memory_layers/entry_list_params.rbi

@@ -21,13 +21,6 @@ module Cadenya
         sig { returns(String) }
         attr_accessor :memory_layer_id
 
-        # Filter by bundle_key — return only resources owned by this bundle.
-        sig { returns(T.nilable(String)) }
-        attr_reader :bundle_key
-
-        sig { params(bundle_key: String).void }
-        attr_writer :bundle_key
-
         # Pagination cursor from previous response
         sig { returns(T.nilable(String)) }
         attr_reader :cursor
@@ -75,7 +68,6 @@ module Cadenya
           params(
             workspace_id: String,
             memory_layer_id: String,
-            bundle_key: String,
             cursor: String,
             include_info: T::Boolean,
             limit: Integer,
@@ -88,8 +80,6 @@ module Cadenya
         def self.new(
           workspace_id:,
           memory_layer_id:,
-          # Filter by bundle_key — return only resources owned by this bundle.
-          bundle_key: nil,
           # Pagination cursor from previous response
           cursor: nil,
           # When set to true you may use more of your alloted API rate-limit
@@ -112,7 +102,6 @@ module Cadenya
             {
               workspace_id: String,
               memory_layer_id: String,
-              bundle_key: String,
               cursor: String,
               include_info: T::Boolean,
               limit: Integer,

data/rbi/cadenya/models/model_list_params.rbi

@@ -22,13 +22,6 @@ module Cadenya
       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
-
-      sig { params(bundle_key: String).void }
-      attr_writer :bundle_key
-
       # Pagination cursor from previous response
       sig { returns(T.nilable(String)) }
       attr_reader :cursor
@@ -92,7 +85,6 @@ module Cadenya
         params(
           workspace_id: String,
           ai_provider_key_id: String,
-          bundle_key: String,
           cursor: String,
           include_info: T::Boolean,
           is_assigned: T::Boolean,
@@ -109,8 +101,6 @@ module Cadenya
         # 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
@@ -139,7 +129,6 @@ module Cadenya
           {
             workspace_id: String,
             ai_provider_key_id: String,
-            bundle_key: String,
             cursor: String,
             include_info: T::Boolean,
             is_assigned: T::Boolean,