cadenya 0.3.0 → 0.4.0

data/rbi/cadenya/models/ai_provider_key_create_params.rbi

@@ -0,0 +1,65 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class AIProviderKeyCreateParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::AIProviderKeyCreateParams, Cadenya::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :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.
+      sig { returns(Cadenya::CreateResourceMetadata) }
+      attr_reader :metadata
+
+      sig { params(metadata: Cadenya::CreateResourceMetadata::OrHash).void }
+      attr_writer :metadata
+
+      sig { returns(Cadenya::AIProviderKeySpec) }
+      attr_reader :spec
+
+      sig { params(spec: Cadenya::AIProviderKeySpec::OrHash).void }
+      attr_writer :spec
+
+      sig do
+        params(
+          workspace_id: String,
+          metadata: Cadenya::CreateResourceMetadata::OrHash,
+          spec: Cadenya::AIProviderKeySpec::OrHash,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        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
+
+      sig do
+        override.returns(
+          {
+            workspace_id: String,
+            metadata: Cadenya::CreateResourceMetadata,
+            spec: Cadenya::AIProviderKeySpec,
+            request_options: Cadenya::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/ai_provider_key_delete_params.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class AIProviderKeyDeleteParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::AIProviderKeyDeleteParams, Cadenya::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :workspace_id
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig do
+        params(
+          workspace_id: String,
+          id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(workspace_id:, id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          {
+            workspace_id: String,
+            id: String,
+            request_options: Cadenya::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/ai_provider_key_list_params.rbi

@@ -0,0 +1,96 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class AIProviderKeyListParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::AIProviderKeyListParams, Cadenya::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :workspace_id
+
+      # Pagination cursor from previous response
+      sig { returns(T.nilable(String)) }
+      attr_reader :cursor
+
+      sig { params(cursor: String).void }
+      attr_writer :cursor
+
+      # Maximum number of results to return
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :limit
+
+      sig { params(limit: Integer).void }
+      attr_writer :limit
+
+      # Filter expression (query param: prefix)
+      sig { returns(T.nilable(String)) }
+      attr_reader :prefix
+
+      sig { params(prefix: String).void }
+      attr_writer :prefix
+
+      # Free-form search query
+      sig { returns(T.nilable(String)) }
+      attr_reader :query
+
+      sig { params(query: String).void }
+      attr_writer :query
+
+      # Sort order for results (asc or desc by creation time)
+      sig { returns(T.nilable(String)) }
+      attr_reader :sort_order
+
+      sig { params(sort_order: String).void }
+      attr_writer :sort_order
+
+      sig do
+        params(
+          workspace_id: String,
+          cursor: String,
+          limit: Integer,
+          prefix: String,
+          query: String,
+          sort_order: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        workspace_id:,
+        # Pagination cursor from previous response
+        cursor: 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
+
+      sig do
+        override.returns(
+          {
+            workspace_id: String,
+            cursor: String,
+            limit: Integer,
+            prefix: String,
+            query: String,
+            sort_order: String,
+            request_options: Cadenya::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/ai_provider_key_retrieve_params.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class AIProviderKeyRetrieveParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Cadenya::AIProviderKeyRetrieveParams,
+            Cadenya::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :workspace_id
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig do
+        params(
+          workspace_id: String,
+          id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(workspace_id:, id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          {
+            workspace_id: String,
+            id: String,
+            request_options: Cadenya::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/ai_provider_key_spec.rbi

@@ -0,0 +1,56 @@
+# 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
+
+      # The AI provider this key authenticates against. Currently "openrouter".
+      sig { returns(T.nilable(String)) }
+      attr_reader :provider
+
+      sig { params(provider: String).void }
+      attr_writer :provider
+
+      # The provider region. "us" or "eu". Defaults to "us".
+      sig { returns(T.nilable(String)) }
+      attr_reader :region
+
+      sig { params(region: String).void }
+      attr_writer :region
+
+      sig do
+        params(api_key: String, provider: String, region: String).returns(
+          T.attached_class
+        )
+      end
+      def self.new(
+        # The provider credential. Accepted on create/update; never populated in responses
+        # (the server returns an empty value to avoid leaking it).
+        api_key: nil,
+        # The AI provider this key authenticates against. Currently "openrouter".
+        provider: nil,
+        # The provider region. "us" or "eu". Defaults to "us".
+        region: nil
+      )
+      end
+
+      sig do
+        override.returns({ api_key: String, provider: String, region: String })
+      end
+      def to_hash
+      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.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,125 @@
+# 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,
+          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,
+        # 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/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,22 @@
+module Cadenya
+  module Models
+    type ai_provider_key =
+      { metadata: Cadenya::ResourceMetadata, spec: Cadenya::AIProviderKeySpec }
+
+    class AIProviderKey < Cadenya::Internal::Type::BaseModel
+      attr_accessor metadata: Cadenya::ResourceMetadata
+
+      attr_accessor spec: Cadenya::AIProviderKeySpec
+
+      def initialize: (
+        metadata: Cadenya::ResourceMetadata,
+        spec: Cadenya::AIProviderKeySpec
+      ) -> void
+
+      def to_hash: -> {
+        metadata: Cadenya::ResourceMetadata,
+        spec: Cadenya::AIProviderKeySpec
+      }
+    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

data/sig/cadenya/models/ai_provider_key_list_params.rbs

@@ -0,0 +1,61 @@
+module Cadenya
+  module Models
+    type ai_provider_key_list_params =
+      {
+        workspace_id: String,
+        cursor: String,
+        limit: Integer,
+        prefix: String,
+        query: String,
+        sort_order: String
+      }
+      & Cadenya::Internal::Type::request_parameters
+
+    class AIProviderKeyListParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      attr_accessor workspace_id: String
+
+      attr_reader cursor: String?
+
+      def cursor=: (String) -> String
+
+      attr_reader limit: Integer?
+
+      def limit=: (Integer) -> Integer
+
+      attr_reader prefix: String?
+
+      def prefix=: (String) -> String
+
+      attr_reader query: String?
+
+      def query=: (String) -> String
+
+      attr_reader sort_order: String?
+
+      def sort_order=: (String) -> String
+
+      def initialize: (
+        workspace_id: String,
+        ?cursor: String,
+        ?limit: Integer,
+        ?prefix: String,
+        ?query: String,
+        ?sort_order: String,
+        ?request_options: Cadenya::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        workspace_id: String,
+        cursor: String,
+        limit: Integer,
+        prefix: String,
+        query: String,
+        sort_order: String,
+        request_options: Cadenya::RequestOptions
+      }
+    end
+  end
+end