cadenya 0.3.0 → 0.5.0

data/rbi/cadenya/models/ai_provider_key_spec.rbi

@@ -0,0 +1,98 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class AIProviderKeySpec < Cadenya::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          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
+
+      sig { params(api_key: String).void }
+      attr_writer :api_key
+
+      # 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(openrouter: T.anything).void }
+      attr_writer :openrouter
+
+      # The AI provider this key authenticates against.
+      sig { returns(T.nilable(Cadenya::AIProviderKeySpec::Provider::OrSymbol)) }
+      attr_reader :provider
+
+      sig do
+        params(provider: Cadenya::AIProviderKeySpec::Provider::OrSymbol).void
+      end
+      attr_writer :provider
+
+      sig do
+        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,
+        # 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,
+            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/ai_provider_key_update_params.rbi

@@ -0,0 +1,82 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class AIProviderKeyUpdateParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::AIProviderKeyUpdateParams, Cadenya::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :workspace_id
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      # UpdateResourceMetadata contains the user-provided fields for updating a
+      # workspace-scoped resource. Read-only fields (id, account_id, workspace_id,
+      # profile_id, created_at) are excluded since they are set by the server.
+      sig { returns(T.nilable(Cadenya::UpdateResourceMetadata)) }
+      attr_reader :metadata
+
+      sig { params(metadata: Cadenya::UpdateResourceMetadata::OrHash).void }
+      attr_writer :metadata
+
+      sig { returns(T.nilable(Cadenya::AIProviderKeySpec)) }
+      attr_reader :spec
+
+      sig { params(spec: Cadenya::AIProviderKeySpec::OrHash).void }
+      attr_writer :spec
+
+      # Fields to update.
+      sig { returns(T.nilable(String)) }
+      attr_reader :update_mask
+
+      sig { params(update_mask: String).void }
+      attr_writer :update_mask
+
+      sig do
+        params(
+          workspace_id: String,
+          id: String,
+          metadata: Cadenya::UpdateResourceMetadata::OrHash,
+          spec: Cadenya::AIProviderKeySpec::OrHash,
+          update_mask: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        workspace_id:,
+        id:,
+        # UpdateResourceMetadata contains the user-provided fields for updating a
+        # workspace-scoped resource. Read-only fields (id, account_id, workspace_id,
+        # profile_id, created_at) are excluded since they are set by the server.
+        metadata: nil,
+        spec: nil,
+        # Fields to update.
+        update_mask: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            workspace_id: String,
+            id: String,
+            metadata: Cadenya::UpdateResourceMetadata,
+            spec: Cadenya::AIProviderKeySpec,
+            update_mask: String,
+            request_options: Cadenya::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      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/models.rbi

@@ -38,6 +38,20 @@ module Cadenya
 
   AgentVariationEntry = Cadenya::Models::AgentVariationEntry
 
+  AIProviderKey = Cadenya::Models::AIProviderKey
+
+  AIProviderKeyCreateParams = Cadenya::Models::AIProviderKeyCreateParams
+
+  AIProviderKeyDeleteParams = Cadenya::Models::AIProviderKeyDeleteParams
+
+  AIProviderKeyListParams = Cadenya::Models::AIProviderKeyListParams
+
+  AIProviderKeyRetrieveParams = Cadenya::Models::AIProviderKeyRetrieveParams
+
+  AIProviderKeySpec = Cadenya::Models::AIProviderKeySpec
+
+  AIProviderKeyUpdateParams = Cadenya::Models::AIProviderKeyUpdateParams
+
   APIKey = Cadenya::Models::APIKey
 
   APIKeyCreateParams = Cadenya::Models::APIKeyCreateParams

data/rbi/cadenya/resources/ai_provider_keys.rbi

@@ -0,0 +1,129 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    class AIProviderKeys
+      # Creates a new customer-provided AI provider key in the workspace
+      sig do
+        params(
+          workspace_id: String,
+          metadata: Cadenya::CreateResourceMetadata::OrHash,
+          spec: Cadenya::AIProviderKeySpec::OrHash,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::AIProviderKey)
+      end
+      def create(
+        # The workspace that will own this key.
+        workspace_id,
+        # CreateResourceMetadata contains the user-provided fields for creating a
+        # workspace-scoped resource. Read-only fields (id, account_id, workspace_id,
+        # profile_id, created_at) are excluded since they are set by the server.
+        metadata:,
+        spec:,
+        request_options: {}
+      )
+      end
+
+      # Retrieves an AI provider key by ID from the workspace
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::AIProviderKey)
+      end
+      def retrieve(
+        # The key to retrieve.
+        id,
+        # The workspace the key belongs to.
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
+      # Updates an AI provider key's name or key value in the workspace
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          metadata: Cadenya::UpdateResourceMetadata::OrHash,
+          spec: Cadenya::AIProviderKeySpec::OrHash,
+          update_mask: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::AIProviderKey)
+      end
+      def update(
+        # Path param: The key to update.
+        id,
+        # Path param: The workspace the key belongs to.
+        workspace_id:,
+        # Body param: UpdateResourceMetadata contains the user-provided fields for
+        # updating a workspace-scoped resource. Read-only fields (id, account_id,
+        # workspace_id, profile_id, created_at) are excluded since they are set by the
+        # server.
+        metadata: nil,
+        # Body param
+        spec: nil,
+        # Body param: Fields to update.
+        update_mask: nil,
+        request_options: {}
+      )
+      end
+
+      # Lists all customer-provided AI provider keys in the workspace
+      sig do
+        params(
+          workspace_id: String,
+          cursor: String,
+          include_info: T::Boolean,
+          limit: Integer,
+          prefix: String,
+          query: String,
+          sort_order: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Internal::CursorPagination[Cadenya::AIProviderKey])
+      end
+      def list(
+        # The workspace whose keys will be listed.
+        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)
+        prefix: nil,
+        # Free-form search query
+        query: nil,
+        # Sort order for results (asc or desc by creation time)
+        sort_order: nil,
+        request_options: {}
+      )
+      end
+
+      # Deletes an AI provider key from the workspace
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).void
+      end
+      def delete(
+        # The key to delete.
+        id,
+        # The workspace the key belongs to.
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Cadenya::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

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/client.rbs

@@ -12,6 +12,8 @@ module Cadenya
 
     attr_reader webhook_key: String?
 
+    attr_reader ai_provider_keys: Cadenya::Resources::AIProviderKeys
+
     attr_reader account: Cadenya::Resources::Account
 
     attr_reader agents: Cadenya::Resources::Agents

data/sig/cadenya/models/ai_provider_key.rbs

@@ -0,0 +1,55 @@
+module Cadenya
+  module Models
+    type ai_provider_key =
+      {
+        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,
+        ?info: Cadenya::AIProviderKey::Info
+      ) -> void
+
+      def to_hash: -> {
+        metadata: Cadenya::ResourceMetadata,
+        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_create_params.rbs

@@ -0,0 +1,36 @@
+module Cadenya
+  module Models
+    type ai_provider_key_create_params =
+      {
+        workspace_id: String,
+        metadata: Cadenya::CreateResourceMetadata,
+        spec: Cadenya::AIProviderKeySpec
+      }
+      & Cadenya::Internal::Type::request_parameters
+
+    class AIProviderKeyCreateParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      attr_accessor workspace_id: String
+
+      attr_accessor metadata: Cadenya::CreateResourceMetadata
+
+      attr_accessor spec: Cadenya::AIProviderKeySpec
+
+      def initialize: (
+        workspace_id: String,
+        metadata: Cadenya::CreateResourceMetadata,
+        spec: Cadenya::AIProviderKeySpec,
+        ?request_options: Cadenya::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        workspace_id: String,
+        metadata: Cadenya::CreateResourceMetadata,
+        spec: Cadenya::AIProviderKeySpec,
+        request_options: Cadenya::RequestOptions
+      }
+    end
+  end
+end

data/sig/cadenya/models/ai_provider_key_delete_params.rbs

@@ -0,0 +1,28 @@
+module Cadenya
+  module Models
+    type ai_provider_key_delete_params =
+      { workspace_id: String, id: String }
+      & Cadenya::Internal::Type::request_parameters
+
+    class AIProviderKeyDeleteParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      attr_accessor workspace_id: String
+
+      attr_accessor id: String
+
+      def initialize: (
+        workspace_id: String,
+        id: String,
+        ?request_options: Cadenya::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        workspace_id: String,
+        id: String,
+        request_options: Cadenya::RequestOptions
+      }
+    end
+  end
+end