cadenya 0.16.0 → 0.18.0

data/rbi/cadenya/models/model_list_params.rbi

@@ -44,6 +44,15 @@ module Cadenya
       sig { params(include_info: T::Boolean).void }
       attr_writer :include_info
 
+      # 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.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :is_assigned
+
+      sig { params(is_assigned: T::Boolean).void }
+      attr_writer :is_assigned
+
       # Maximum number of results to return
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
@@ -86,6 +95,7 @@ module Cadenya
           bundle_key: String,
           cursor: String,
           include_info: T::Boolean,
+          is_assigned: T::Boolean,
           limit: Integer,
           prefix: String,
           query: String,
@@ -106,6 +116,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
@@ -128,6 +142,7 @@ module Cadenya
             bundle_key: String,
             cursor: String,
             include_info: T::Boolean,
+            is_assigned: T::Boolean,
             limit: Integer,
             prefix: String,
             query: String,

data/rbi/cadenya/models/model_swap_params.rbi

@@ -68,6 +68,13 @@ module Cadenya
         sig { params(current_model_id: String).void }
         attr_writer :current_model_id
 
+        # Whether to disable the current model after the swap.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :disable_current_after_swap
+
+        sig { params(disable_current_after_swap: T::Boolean).void }
+        attr_writer :disable_current_after_swap
+
         # The model to move variations to. Accepts an id or "external_id:" slug.
         sig { returns(T.nilable(String)) }
         attr_reader :next_model_id
@@ -76,20 +83,30 @@ module Cadenya
         attr_writer :next_model_id
 
         sig do
-          params(current_model_id: String, next_model_id: String).returns(
-            T.attached_class
-          )
+          params(
+            current_model_id: String,
+            disable_current_after_swap: T::Boolean,
+            next_model_id: String
+          ).returns(T.attached_class)
         end
         def self.new(
           # The model variations are currently on. Accepts an id or "external_id:" slug.
           current_model_id: nil,
+          # Whether to disable the current model after the swap.
+          disable_current_after_swap: nil,
           # The model to move variations to. Accepts an id or "external_id:" slug.
           next_model_id: nil
         )
         end
 
         sig do
-          override.returns({ current_model_id: String, next_model_id: String })
+          override.returns(
+            {
+              current_model_id: String,
+              disable_current_after_swap: T::Boolean,
+              next_model_id: String
+            }
+          )
         end
         def to_hash
         end

data/rbi/cadenya/models/objectives/objective_tool_call_data.rbi

@@ -38,6 +38,20 @@ module Cadenya
         sig { params(memo: String).void }
         attr_writer :memo
 
+        # List of resolved secrets used by the tool call
+        sig do
+          returns(T.nilable(T::Array[Cadenya::Objectives::ResolvedSecret]))
+        end
+        attr_reader :resolved_secrets
+
+        sig do
+          params(
+            resolved_secrets:
+              T::Array[Cadenya::Objectives::ResolvedSecret::OrHash]
+          ).void
+        end
+        attr_writer :resolved_secrets
+
         # 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.
@@ -52,6 +66,8 @@ module Cadenya
             callable: Cadenya::CallableTool::OrHash,
             arguments: T::Hash[Symbol, T.anything],
             memo: String,
+            resolved_secrets:
+              T::Array[Cadenya::Objectives::ResolvedSecret::OrHash],
             status_changed_by: Cadenya::Profile::OrHash
           ).returns(T.attached_class)
         end
@@ -65,6 +81,8 @@ module Cadenya
           arguments: nil,
           # A memo supplied by the reviewer when denying the tool call
           memo: nil,
+          # List of resolved secrets used by the tool call
+          resolved_secrets: nil,
           # 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.
@@ -78,6 +96,7 @@ module Cadenya
               callable: Cadenya::CallableTool,
               arguments: T::Hash[Symbol, T.anything],
               memo: String,
+              resolved_secrets: T::Array[Cadenya::Objectives::ResolvedSecret],
               status_changed_by: Cadenya::Profile
             }
           )

data/rbi/cadenya/models/objectives/objective_tool_call_info.rbi

@@ -31,10 +31,36 @@ module Cadenya
         sig { params(objective: Cadenya::OperationMetadata::OrHash).void }
         attr_writer :objective
 
+        # 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 :tool
+
+        sig { params(tool: Cadenya::BareMetadata::OrHash).void }
+        attr_writer :tool
+
+        # 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 :tool_set
+
+        sig { params(tool_set: Cadenya::BareMetadata::OrHash).void }
+        attr_writer :tool_set
+
         sig do
           params(
             created_by: Cadenya::Profile::OrHash,
-            objective: Cadenya::OperationMetadata::OrHash
+            objective: Cadenya::OperationMetadata::OrHash,
+            tool: Cadenya::BareMetadata::OrHash,
+            tool_set: Cadenya::BareMetadata::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
@@ -44,7 +70,21 @@ module Cadenya
           created_by: nil,
           # Metadata for ephemeral operations and activities (e.g., objectives, executions,
           # runs)
-          objective: nil
+          objective: nil,
+          # 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.
+          tool: nil,
+          # 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.
+          tool_set: nil
         )
         end
 
@@ -52,7 +92,9 @@ module Cadenya
           override.returns(
             {
               created_by: Cadenya::Profile,
-              objective: Cadenya::OperationMetadata
+              objective: Cadenya::OperationMetadata,
+              tool: Cadenya::BareMetadata,
+              tool_set: Cadenya::BareMetadata
             }
           )
         end

data/rbi/cadenya/models/objectives/objective_tool_call_with_result.rbi

@@ -53,6 +53,20 @@ module Cadenya
         end
         attr_accessor :execution_status
 
+        # List of resolved secrets used by the tool call
+        sig do
+          returns(T.nilable(T::Array[Cadenya::Objectives::ResolvedSecret]))
+        end
+        attr_reader :resolved_secrets
+
+        sig do
+          params(
+            resolved_secrets:
+              T::Array[Cadenya::Objectives::ResolvedSecret::OrHash]
+          ).void
+        end
+        attr_writer :resolved_secrets
+
         # ObjectiveToolCallResult is the content a tool returned after execution. Tools
         # can return multiple content blocks, and blocks can be multi-modal (text, image,
         # audio). Media blocks are stored by Cadenya and served as short-lived signed URLs
@@ -78,6 +92,8 @@ module Cadenya
             metadata: Cadenya::OperationMetadata::OrHash,
             status:
               Cadenya::Objectives::ObjectiveToolCallWithResult::Status::OrSymbol,
+            resolved_secrets:
+              T::Array[Cadenya::Objectives::ResolvedSecret::OrHash],
             result: Cadenya::Objectives::ObjectiveToolCallResult::OrHash
           ).returns(T.attached_class)
         end
@@ -90,6 +106,8 @@ module Cadenya
           metadata:,
           # Current status of the tool call
           status:,
+          # List of resolved secrets used by the tool call
+          resolved_secrets: nil,
           # ObjectiveToolCallResult is the content a tool returned after execution. Tools
           # can return multiple content blocks, and blocks can be multi-modal (text, image,
           # audio). Media blocks are stored by Cadenya and served as short-lived signed URLs
@@ -108,6 +126,7 @@ module Cadenya
               metadata: Cadenya::OperationMetadata,
               status:
                 Cadenya::Objectives::ObjectiveToolCallWithResult::Status::TaggedSymbol,
+              resolved_secrets: T::Array[Cadenya::Objectives::ResolvedSecret],
               result: Cadenya::Objectives::ObjectiveToolCallResult
             }
           )

data/rbi/cadenya/models/objectives/resolved_secret.rbi

@@ -0,0 +1,104 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    module Objectives
+      class ResolvedSecret < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Objectives::ResolvedSecret,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :key
+
+        sig { params(key: String).void }
+        attr_writer :key
+
+        sig do
+          returns(
+            T.nilable(Cadenya::Objectives::ResolvedSecret::Source::TaggedSymbol)
+          )
+        end
+        attr_reader :source
+
+        sig do
+          params(
+            source: Cadenya::Objectives::ResolvedSecret::Source::OrSymbol
+          ).void
+        end
+        attr_writer :source
+
+        # ResolvedSecret is a resolved secret value from the workspace, toolset, or
+        # objective. When a tool is called, it will rely on secrets in the order of:
+        #
+        # - Objective
+        # - Toolset
+        # - Workspace
+        sig do
+          params(
+            key: String,
+            source: Cadenya::Objectives::ResolvedSecret::Source::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(key: nil, source: nil)
+        end
+
+        sig do
+          override.returns(
+            {
+              key: String,
+              source: Cadenya::Objectives::ResolvedSecret::Source::TaggedSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        module Source
+          extend Cadenya::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Cadenya::Objectives::ResolvedSecret::Source)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          RESOLVED_SECRET_SOURCE_UNSPECIFIED =
+            T.let(
+              :RESOLVED_SECRET_SOURCE_UNSPECIFIED,
+              Cadenya::Objectives::ResolvedSecret::Source::TaggedSymbol
+            )
+          RESOLVED_SECRET_SOURCE_WORKSPACE =
+            T.let(
+              :RESOLVED_SECRET_SOURCE_WORKSPACE,
+              Cadenya::Objectives::ResolvedSecret::Source::TaggedSymbol
+            )
+          RESOLVED_SECRET_SOURCE_TOOLSET =
+            T.let(
+              :RESOLVED_SECRET_SOURCE_TOOLSET,
+              Cadenya::Objectives::ResolvedSecret::Source::TaggedSymbol
+            )
+          RESOLVED_SECRET_SOURCE_OBJECTIVE =
+            T.let(
+              :RESOLVED_SECRET_SOURCE_OBJECTIVE,
+              Cadenya::Objectives::ResolvedSecret::Source::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Cadenya::Objectives::ResolvedSecret::Source::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/tool_sets/secret_create_params.rbi

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

data/rbi/cadenya/models/tool_sets/secret_delete_params.rbi

@@ -0,0 +1,53 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    module ToolSets
+      class SecretDeleteParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::ToolSets::SecretDeleteParams,
+              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
+
+        sig do
+          params(
+            workspace_id: String,
+            tool_set_id: String,
+            id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(workspace_id:, tool_set_id:, id:, request_options: {})
+        end
+
+        sig do
+          override.returns(
+            {
+              workspace_id: String,
+              tool_set_id: String,
+              id: String,
+              request_options: Cadenya::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/tool_sets/secret_list_params.rbi

@@ -0,0 +1,129 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    module ToolSets
+      class SecretListParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::ToolSets::SecretListParams,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :workspace_id
+
+        sig { returns(String) }
+        attr_accessor :tool_set_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
+
+        sig { params(cursor: String).void }
+        attr_writer :cursor
+
+        # When set to true you may use more of your alloted API rate-limit
+        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
+
+        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,
+            tool_set_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(T.attached_class)
+        end
+        def self.new(
+          workspace_id:,
+          tool_set_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
+          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
+
+        sig do
+          override.returns(
+            {
+              workspace_id: String,
+              tool_set_id: String,
+              bundle_key: String,
+              cursor: String,
+              include_info: T::Boolean,
+              limit: Integer,
+              prefix: String,
+              query: String,
+              sort_order: String,
+              request_options: Cadenya::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/tool_sets/secret_retrieve_params.rbi

@@ -0,0 +1,53 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    module ToolSets
+      class SecretRetrieveParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::ToolSets::SecretRetrieveParams,
+              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
+
+        sig do
+          params(
+            workspace_id: String,
+            tool_set_id: String,
+            id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(workspace_id:, tool_set_id:, id:, request_options: {})
+        end
+
+        sig do
+          override.returns(
+            {
+              workspace_id: String,
+              tool_set_id: String,
+              id: String,
+              request_options: Cadenya::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end