cadenya 0.16.0 → 0.18.0

data/rbi/cadenya/models/tool_sets/secret_update_params.rbi

@@ -0,0 +1,93 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    module ToolSets
+      class SecretUpdateParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::ToolSets::SecretUpdateParams,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :workspace_id
+
+        sig { returns(String) }
+        attr_accessor :tool_set_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::ToolSets::ToolSetSecretSpec)) }
+        attr_reader :spec
+
+        sig { params(spec: Cadenya::ToolSets::ToolSetSecretSpec::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,
+            tool_set_id: String,
+            id: String,
+            metadata: Cadenya::UpdateResourceMetadata::OrHash,
+            spec: Cadenya::ToolSets::ToolSetSecretSpec::OrHash,
+            update_mask: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          workspace_id:,
+          tool_set_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,
+              tool_set_id: String,
+              id: String,
+              metadata: Cadenya::UpdateResourceMetadata,
+              spec: Cadenya::ToolSets::ToolSetSecretSpec,
+              update_mask: String,
+              request_options: Cadenya::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/tool_sets/tool_set_secret.rbi

@@ -0,0 +1,64 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    ToolSetSecret = ToolSets::ToolSetSecret
+
+    module ToolSets
+      class ToolSetSecret < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Cadenya::ToolSets::ToolSetSecret, Cadenya::Internal::AnyHash)
+          end
+
+        # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        sig { returns(Cadenya::ResourceMetadata) }
+        attr_reader :metadata
+
+        sig { params(metadata: Cadenya::ResourceMetadata::OrHash).void }
+        attr_writer :metadata
+
+        sig { returns(Cadenya::ToolSets::ToolSetSecretSpec) }
+        attr_reader :spec
+
+        sig { params(spec: Cadenya::ToolSets::ToolSetSecretSpec::OrHash).void }
+        attr_writer :spec
+
+        # Tool set secret information
+        sig { returns(T.nilable(Cadenya::ToolSets::ToolSetSecretInfo)) }
+        attr_reader :info
+
+        sig { params(info: Cadenya::ToolSets::ToolSetSecretInfo::OrHash).void }
+        attr_writer :info
+
+        sig do
+          params(
+            metadata: Cadenya::ResourceMetadata::OrHash,
+            spec: Cadenya::ToolSets::ToolSetSecretSpec::OrHash,
+            info: Cadenya::ToolSets::ToolSetSecretInfo::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+          metadata:,
+          spec:,
+          # Tool set secret information
+          info: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              metadata: Cadenya::ResourceMetadata,
+              spec: Cadenya::ToolSets::ToolSetSecretSpec,
+              info: Cadenya::ToolSets::ToolSetSecretInfo
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/tool_sets/tool_set_secret_info.rbi

@@ -0,0 +1,55 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    ToolSetSecretInfo = ToolSets::ToolSetSecretInfo
+
+    module ToolSets
+      class ToolSetSecretInfo < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::ToolSets::ToolSetSecretInfo,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # A profile identifies a user or non-human principal (such as an API key) at the
+        # account level. Profiles are account-scoped and can be granted access to multiple
+        # workspaces.
+        sig { returns(T.nilable(Cadenya::Profile)) }
+        attr_reader :created_by
+
+        sig { params(created_by: Cadenya::Profile::OrHash).void }
+        attr_writer :created_by
+
+        sig { returns(T.nilable(Time)) }
+        attr_reader :last_used_at
+
+        sig { params(last_used_at: Time).void }
+        attr_writer :last_used_at
+
+        sig do
+          params(
+            created_by: Cadenya::Profile::OrHash,
+            last_used_at: Time
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # A profile identifies a user or non-human principal (such as an API key) at the
+          # account level. Profiles are account-scoped and can be granted access to multiple
+          # workspaces.
+          created_by: nil,
+          last_used_at: nil
+        )
+        end
+
+        sig do
+          override.returns({ created_by: Cadenya::Profile, last_used_at: Time })
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/tool_sets/tool_set_secret_spec.rbi

@@ -0,0 +1,33 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    ToolSetSecretSpec = ToolSets::ToolSetSecretSpec
+
+    module ToolSets
+      class ToolSetSecretSpec < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::ToolSets::ToolSetSecretSpec,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :value
+
+        sig { params(value: String).void }
+        attr_writer :value
+
+        sig { params(value: String).returns(T.attached_class) }
+        def self.new(value: nil)
+        end
+
+        sig { override.returns({ value: String }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/resources/ai_provider_keys.rbi

@@ -78,6 +78,7 @@ module Cadenya
           include_info: T::Boolean,
           limit: Integer,
           prefix: String,
+          promotional: T::Boolean,
           query: String,
           sort_order: String,
           request_options: Cadenya::RequestOptions::OrHash
@@ -95,6 +96,10 @@ module Cadenya
         limit: nil,
         # Filter expression (query param: prefix)
         prefix: nil,
+        # When true, return only promotional keys (provided by Cadenya, e.g. for
+        # onboarding). Defaults to returning all keys, customer-provided and promotional
+        # alike.
+        promotional: nil,
         # Free-form search query
         query: nil,
         # Sort order for results (asc or desc by creation time)

data/rbi/cadenya/resources/models.rbi

@@ -31,6 +31,7 @@ module Cadenya
           bundle_key: String,
           cursor: String,
           include_info: T::Boolean,
+          is_assigned: T::Boolean,
           limit: Integer,
           prefix: String,
           query: String,
@@ -52,6 +53,10 @@ module Cadenya
         # When true, populate each item's info (e.g. the AI provider), at the cost of
         # extra lookups.
         include_info: nil,
+        # Filter models to only ones assigned to an active agent variation/agent. Draft
+        # agents count as assigned; archived agents do not. Assignment does not imply
+        # recent traffic — see ModelInfo.last_used_at for that.
+        is_assigned: nil,
         # Maximum number of results to return
         limit: nil,
         # Filter by name prefix

data/rbi/cadenya/resources/tool_sets/secrets.rbi

@@ -0,0 +1,164 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    class ToolSets
+      # Manage tool sets and the tools they contain. Tool sets group related tools, and
+      # tools define specific capabilities available to agents.
+      #
+      # When a tool set is managed, only API key actors can modify its tools; human
+      # (profile) actors cannot.
+      class Secrets
+        # Creates a new secret scoped to the tool set
+        sig do
+          params(
+            tool_set_id: String,
+            workspace_id: String,
+            metadata: Cadenya::CreateResourceMetadata::OrHash,
+            spec: Cadenya::ToolSets::ToolSetSecretSpec::OrHash,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::ToolSets::ToolSetSecret)
+        end
+        def create(
+          # Path param: The tool set that will own this secret. Accepts the canonical ts\_…
+          # form or the external_id:<value> form.
+          tool_set_id,
+          # Path param: The workspace that owns the tool set.
+          workspace_id:,
+          # Body param: 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:,
+          # Body param
+          spec:,
+          request_options: {}
+        )
+        end
+
+        # Retrieves a tool set secret by ID from the tool set
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            tool_set_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::ToolSets::ToolSetSecret)
+        end
+        def retrieve(
+          # The secret to retrieve.
+          id,
+          # The workspace that owns the tool set.
+          workspace_id:,
+          # The tool set the secret belongs to. Accepts the canonical ts\_… form or the
+          # external_id:<value> form.
+          tool_set_id:,
+          request_options: {}
+        )
+        end
+
+        # Updates a secret scoped to the tool set
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            tool_set_id: String,
+            metadata: Cadenya::UpdateResourceMetadata::OrHash,
+            spec: Cadenya::ToolSets::ToolSetSecretSpec::OrHash,
+            update_mask: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::ToolSets::ToolSetSecret)
+        end
+        def update(
+          # Path param: The secret to update.
+          id,
+          # Path param: The workspace that owns the tool set.
+          workspace_id:,
+          # Path param: The tool set the secret belongs to. Accepts the canonical ts\_… form
+          # or the external_id:<value> form.
+          tool_set_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 secrets scoped to the tool set
+        sig do
+          params(
+            tool_set_id: String,
+            workspace_id: String,
+            bundle_key: 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::ToolSets::ToolSetSecret
+            ]
+          )
+        end
+        def list(
+          # Path param: The tool set whose secrets will be listed. Accepts the canonical
+          # ts\_… form or the external_id:<value> form.
+          tool_set_id,
+          # Path param: The workspace that owns the tool set.
+          workspace_id:,
+          # Query param: Filter by bundle_key — return only resources owned by this bundle.
+          bundle_key: nil,
+          # Query param: Pagination cursor from previous response
+          cursor: nil,
+          # Query param: When set to true you may use more of your alloted API rate-limit
+          include_info: nil,
+          # Query param: Maximum number of results to return
+          limit: nil,
+          # Query param: Filter expression (query param: prefix)
+          prefix: nil,
+          # Query param: Free-form search query
+          query: nil,
+          # Query param: Sort order for results (asc or desc by creation time)
+          sort_order: nil,
+          request_options: {}
+        )
+        end
+
+        # Deletes a secret scoped to the tool set
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            tool_set_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).void
+        end
+        def delete(
+          # The secret to delete.
+          id,
+          # The workspace that owns the tool set.
+          workspace_id:,
+          # The tool set the secret belongs to. Accepts the canonical ts\_… form or the
+          # external_id:<value> form.
+          tool_set_id:,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Cadenya::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/resources/tool_sets.rbi

@@ -16,6 +16,14 @@ module Cadenya
       sig { returns(Cadenya::Resources::ToolSets::Tools) }
       attr_reader :tools
 
+      # Manage tool sets and the tools they contain. Tool sets group related tools, and
+      # tools define specific capabilities available to agents.
+      #
+      # When a tool set is managed, only API key actors can modify its tools; human
+      # (profile) actors cannot.
+      sig { returns(Cadenya::Resources::ToolSets::Secrets) }
+      attr_reader :secrets
+
       # Creates a new tool set in the workspace
       sig do
         params(

data/sig/cadenya/models/ai_provider_key.rbs

@@ -29,7 +29,11 @@ module Cadenya
       }
 
       type info =
-        { disabled_model_count: Integer, enabled_model_count: Integer }
+        {
+          disabled_model_count: Integer,
+          enabled_model_count: Integer,
+          is_promotional: bool
+        }
 
       class Info < Cadenya::Internal::Type::BaseModel
         attr_reader disabled_model_count: Integer?
@@ -40,14 +44,20 @@ module Cadenya
 
         def enabled_model_count=: (Integer) -> Integer
 
+        attr_reader is_promotional: bool?
+
+        def is_promotional=: (bool) -> bool
+
         def initialize: (
           ?disabled_model_count: Integer,
-          ?enabled_model_count: Integer
+          ?enabled_model_count: Integer,
+          ?is_promotional: bool
         ) -> void
 
         def to_hash: -> {
           disabled_model_count: Integer,
-          enabled_model_count: Integer
+          enabled_model_count: Integer,
+          is_promotional: bool
         }
       end
     end

data/sig/cadenya/models/ai_provider_key_list_params.rbs

@@ -7,6 +7,7 @@ module Cadenya
         include_info: bool,
         limit: Integer,
         prefix: String,
+        promotional: bool,
         query: String,
         sort_order: String
       }
@@ -34,6 +35,10 @@ module Cadenya
 
       def prefix=: (String) -> String
 
+      attr_reader promotional: bool?
+
+      def promotional=: (bool) -> bool
+
       attr_reader query: String?
 
       def query=: (String) -> String
@@ -48,6 +53,7 @@ module Cadenya
         ?include_info: bool,
         ?limit: Integer,
         ?prefix: String,
+        ?promotional: bool,
         ?query: String,
         ?sort_order: String,
         ?request_options: Cadenya::request_opts
@@ -59,6 +65,7 @@ module Cadenya
         include_info: bool,
         limit: Integer,
         prefix: String,
+        promotional: bool,
         query: String,
         sort_order: String,
         request_options: Cadenya::RequestOptions

data/sig/cadenya/models/model.rbs

@@ -48,8 +48,8 @@ module Cadenya
       type info =
         {
           agent_variation_count: Integer,
-          ai_provider_key: Cadenya::ResourceMetadata,
-          provider: Cadenya::Models::Model::Info::provider
+          ai_provider_key: Cadenya::AIProviderKey,
+          last_used_at: Time
         }
 
       class Info < Cadenya::Internal::Type::BaseModel
@@ -57,40 +57,25 @@ module Cadenya
 
         def agent_variation_count=: (Integer) -> Integer
 
-        attr_reader ai_provider_key: Cadenya::ResourceMetadata?
+        attr_reader ai_provider_key: Cadenya::AIProviderKey?
 
-        def ai_provider_key=: (
-          Cadenya::ResourceMetadata
-        ) -> Cadenya::ResourceMetadata
+        def ai_provider_key=: (Cadenya::AIProviderKey) -> Cadenya::AIProviderKey
 
-        attr_reader provider: Cadenya::Models::Model::Info::provider?
+        attr_reader last_used_at: Time?
 
-        def provider=: (
-          Cadenya::Models::Model::Info::provider
-        ) -> Cadenya::Models::Model::Info::provider
+        def last_used_at=: (Time) -> Time
 
         def initialize: (
           ?agent_variation_count: Integer,
-          ?ai_provider_key: Cadenya::ResourceMetadata,
-          ?provider: Cadenya::Models::Model::Info::provider
+          ?ai_provider_key: Cadenya::AIProviderKey,
+          ?last_used_at: Time
         ) -> void
 
         def to_hash: -> {
           agent_variation_count: Integer,
-          ai_provider_key: Cadenya::ResourceMetadata,
-          provider: Cadenya::Models::Model::Info::provider
+          ai_provider_key: Cadenya::AIProviderKey,
+          last_used_at: Time
         }
-
-        type provider = :AI_PROVIDER_UNSPECIFIED | :AI_PROVIDER_OPENROUTER
-
-        module Provider
-          extend Cadenya::Internal::Type::Enum
-
-          AI_PROVIDER_UNSPECIFIED: :AI_PROVIDER_UNSPECIFIED
-          AI_PROVIDER_OPENROUTER: :AI_PROVIDER_OPENROUTER
-
-          def self?.values: -> ::Array[Cadenya::Models::Model::Info::provider]
-        end
       end
     end
   end

data/sig/cadenya/models/model_list_params.rbs

@@ -7,6 +7,7 @@ module Cadenya
         bundle_key: String,
         cursor: String,
         include_info: bool,
+        is_assigned: bool,
         limit: Integer,
         prefix: String,
         query: String,
@@ -37,6 +38,10 @@ module Cadenya
 
       def include_info=: (bool) -> bool
 
+      attr_reader is_assigned: bool?
+
+      def is_assigned=: (bool) -> bool
+
       attr_reader limit: Integer?
 
       def limit=: (Integer) -> Integer
@@ -65,6 +70,7 @@ module Cadenya
         ?bundle_key: String,
         ?cursor: String,
         ?include_info: bool,
+        ?is_assigned: bool,
         ?limit: Integer,
         ?prefix: String,
         ?query: String,
@@ -79,6 +85,7 @@ module Cadenya
         bundle_key: String,
         cursor: String,
         include_info: bool,
+        is_assigned: bool,
         limit: Integer,
         prefix: String,
         query: String,

data/sig/cadenya/models/model_swap_params.rbs

@@ -31,23 +31,37 @@ module Cadenya
         request_options: Cadenya::RequestOptions
       }
 
-      type model_swap = { current_model_id: String, next_model_id: String }
+      type model_swap =
+        {
+          current_model_id: String,
+          disable_current_after_swap: bool,
+          next_model_id: String
+        }
 
       class ModelSwap < Cadenya::Internal::Type::BaseModel
         attr_reader current_model_id: String?
 
         def current_model_id=: (String) -> String
 
+        attr_reader disable_current_after_swap: bool?
+
+        def disable_current_after_swap=: (bool) -> bool
+
         attr_reader next_model_id: String?
 
         def next_model_id=: (String) -> String
 
         def initialize: (
           ?current_model_id: String,
+          ?disable_current_after_swap: bool,
           ?next_model_id: String
         ) -> void
 
-        def to_hash: -> { current_model_id: String, next_model_id: String }
+        def to_hash: -> {
+          current_model_id: String,
+          disable_current_after_swap: bool,
+          next_model_id: String
+        }
       end
     end
   end