cadenya 0.16.0 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ae6a3e7de7658dc3909f5b116f10952737be338c529999a20c5678f9da27512b
-  data.tar.gz: 3009569366c92b99760b8caea39f18bb848bf8c6f57ff4fc697cb07a6a7032ed
+  metadata.gz: 870caa5861d88c74a29670c427f0582778ef11797b8907256c9abf720b1d351f
+  data.tar.gz: 4c932d49f6ec3944cf1e6397863a9c09b493bff2532a0e2bbd2c013824005baf
 SHA512:
-  metadata.gz: 7dbc099db32c64a045d6468124176665f3a86c431a4f014e0289372bad2475f2fd0095583a441810c59b86990049bc3dee004383f3db5858659541126911d87c
-  data.tar.gz: fc2609020e4791914a3eb6259f8403039c82ae6cd9756bc680cbbbda589c583927805dfd115c1bba72a3b92d6b2500ba8141cf015b6a64e73b902891d764b811
+  metadata.gz: ec277a7357047b4864a5b3460d7ea70bc8141e860084a73f76b93cb71a0a0b549fb02967bf79e030758d356e2ad19ebaee6f1f8d1d91a8804111dc79311b329b
+  data.tar.gz: d04915be80453482e4dcac1de5271ead1744caac3b8c903209d2f43d315607afdfdedbcede0b999f6001b87fe2d1af34c1d79584f8c2501300beef2b4c53cc3e

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.18.0 (2026-06-14)
+
+Full Changelog: [v0.17.0...v0.18.0](https://github.com/cadenya/cadenya-ruby/compare/v0.17.0...v0.18.0)
+
+### Features
+
+* **api:** api update ([d0f9386](https://github.com/cadenya/cadenya-ruby/commit/d0f9386001d7a584b2985f46b71848c74959a7e8))
+
+## 0.17.0 (2026-06-12)
+
+Full Changelog: [v0.16.0...v0.17.0](https://github.com/cadenya/cadenya-ruby/compare/v0.16.0...v0.17.0)
+
+### Features
+
+* **api:** api update ([6a0f6da](https://github.com/cadenya/cadenya-ruby/commit/6a0f6da77dd3f34b582c40acc9971286bd5ff00f))
+
 ## 0.16.0 (2026-06-12)
 
 Full Changelog: [v0.15.0...v0.16.0](https://github.com/cadenya/cadenya-ruby/compare/v0.15.0...v0.16.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "cadenya", "~> 0.16.0"
+gem "cadenya", "~> 0.18.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/cadenya/models/ai_provider_key.rb

@@ -28,8 +28,10 @@ module Cadenya
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::AIProviderKey} for more details.
       #
-      #   AIProviderKey is a customer-provided (BYOK) credential for an AI provider,
-      #   scoped to a workspace. The secret value is never returned in responses.
+      #   AIProviderKey is a credential for an AI provider, scoped to a workspace. Most
+      #   keys are customer-provided (BYOK); Cadenya also provisions promotional keys (see
+      #   AIProviderKeyInfo.is_promotional), which cannot be modified or deleted by
+      #   account administrators. The secret value is never returned in responses.
       #
       #   @param metadata [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
       #
@@ -51,15 +53,27 @@ module Cadenya
           #
           #   @return [Integer, nil]
           optional :enabled_model_count, Integer, api_name: :enabledModelCount
+
+          # @!attribute is_promotional
+          #   Cadenya includes promotional keys (one for onboarding, and potentially more in
+          #   the future). These are not added or maintained by account administrators.
+          #
+          #   @return [Boolean, nil]
+          optional :is_promotional, Cadenya::Internal::Type::Boolean, api_name: :isPromotional
         end
 
-        # @!method initialize(disabled_model_count: nil, enabled_model_count: nil)
+        # @!method initialize(disabled_model_count: nil, enabled_model_count: nil, is_promotional: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::AIProviderKey::Info} for more details.
+        #
         #   AIProviderKeyInfo carries server-derived, read-only details about a key, for AI
         #   provider management UIs.
         #
         #   @param disabled_model_count [Integer] Number of disabled models provisioned on this key.
         #
         #   @param enabled_model_count [Integer] Number of enabled models provisioned on this key.
+        #
+        #   @param is_promotional [Boolean] Cadenya includes promotional keys (one for onboarding, and potentially more in t
       end
     end
   end

data/lib/cadenya/models/ai_provider_key_list_params.rb

@@ -37,6 +37,14 @@ module Cadenya
       #   @return [String, nil]
       optional :prefix, String
 
+      # @!attribute promotional
+      #   When true, return only promotional keys (provided by Cadenya, e.g. for
+      #   onboarding). Defaults to returning all keys, customer-provided and promotional
+      #   alike.
+      #
+      #   @return [Boolean, nil]
+      optional :promotional, Cadenya::Internal::Type::Boolean
+
       # @!attribute query
       #   Free-form search query
       #
@@ -49,7 +57,7 @@ module Cadenya
       #   @return [String, nil]
       optional :sort_order, String
 
-      # @!method initialize(workspace_id:, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, request_options: {})
+      # @!method initialize(workspace_id:, cursor: nil, include_info: nil, limit: nil, prefix: nil, promotional: nil, query: nil, sort_order: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::AIProviderKeyListParams} for more details.
       #
@@ -63,6 +71,8 @@ module Cadenya
       #
       #   @param prefix [String] Filter expression (query param: prefix)
       #
+      #   @param promotional [Boolean] When true, return only promotional keys (provided by Cadenya, e.g. for
+      #
       #   @param query [String] Free-form search query
       #
       #   @param sort_order [String] Sort order for results (asc or desc by creation time)

data/lib/cadenya/models/model.rb

@@ -69,19 +69,22 @@ module Cadenya
           optional :agent_variation_count, Integer, api_name: :agentVariationCount
 
           # @!attribute ai_provider_key
-          #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+          #   AIProviderKey is a credential for an AI provider, scoped to a workspace. Most
+          #   keys are customer-provided (BYOK); Cadenya also provisions promotional keys (see
+          #   AIProviderKeyInfo.is_promotional), which cannot be modified or deleted by
+          #   account administrators. The secret value is never returned in responses.
           #
-          #   @return [Cadenya::Models::ResourceMetadata, nil]
-          optional :ai_provider_key, -> { Cadenya::ResourceMetadata }, api_name: :aiProviderKey
+          #   @return [Cadenya::Models::AIProviderKey, nil]
+          optional :ai_provider_key, -> { Cadenya::AIProviderKey }, api_name: :aiProviderKey
 
-          # @!attribute provider
-          #   The AI provider this model routes through (via its provider key).
+          # @!attribute last_used_at
+          #   Represents the last time this model was used in an agent objective
           #
-          #   @return [Symbol, Cadenya::Models::Model::Info::Provider, nil]
-          optional :provider, enum: -> { Cadenya::Model::Info::Provider }
+          #   @return [Time, nil]
+          optional :last_used_at, Time, api_name: :lastUsedAt
         end
 
-        # @!method initialize(agent_variation_count: nil, ai_provider_key: nil, provider: nil)
+        # @!method initialize(agent_variation_count: nil, ai_provider_key: nil, last_used_at: nil)
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Model::Info} for more details.
         #
@@ -89,22 +92,9 @@ module Cadenya
         #
         #   @param agent_variation_count [Integer] Number of agent variations currently provisioned on this model. Useful for
         #
-        #   @param ai_provider_key [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        #   @param ai_provider_key [Cadenya::Models::AIProviderKey] AIProviderKey is a credential for an AI provider, scoped to a workspace.
         #
-        #   @param provider [Symbol, Cadenya::Models::Model::Info::Provider] The AI provider this model routes through (via its provider key).
-
-        # The AI provider this model routes through (via its provider key).
-        #
-        # @see Cadenya::Models::Model::Info#provider
-        module Provider
-          extend Cadenya::Internal::Type::Enum
-
-          AI_PROVIDER_UNSPECIFIED = :AI_PROVIDER_UNSPECIFIED
-          AI_PROVIDER_OPENROUTER = :AI_PROVIDER_OPENROUTER
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
+        #   @param last_used_at [Time] Represents the last time this model was used in an agent objective
       end
     end
   end

data/lib/cadenya/models/model_list_params.rb

@@ -38,6 +38,14 @@ module Cadenya
       #   @return [Boolean, nil]
       optional :include_info, Cadenya::Internal::Type::Boolean
 
+      # @!attribute is_assigned
+      #   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.
+      #
+      #   @return [Boolean, nil]
+      optional :is_assigned, Cadenya::Internal::Type::Boolean
+
       # @!attribute limit
       #   Maximum number of results to return
       #
@@ -68,7 +76,7 @@ module Cadenya
       #   @return [Symbol, Cadenya::Models::ModelListParams::State, nil]
       optional :state, enum: -> { Cadenya::ModelListParams::State }
 
-      # @!method initialize(workspace_id:, ai_provider_key_id: nil, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, state: nil, request_options: {})
+      # @!method initialize(workspace_id:, ai_provider_key_id: nil, bundle_key: nil, cursor: nil, include_info: nil, is_assigned: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, state: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ModelListParams} for more details.
       #
@@ -82,6 +90,8 @@ module Cadenya
       #
       #   @param include_info [Boolean] When true, populate each item's info (e.g. the AI provider), at the cost of
       #
+      #   @param is_assigned [Boolean] Filter models to only ones assigned to an active agent variation/agent.
+      #
       #   @param limit [Integer] Maximum number of results to return
       #
       #   @param prefix [String] Filter by name prefix

data/lib/cadenya/models/model_swap_params.rb

@@ -34,15 +34,25 @@ module Cadenya
         #   @return [String, nil]
         optional :current_model_id, String, api_name: :currentModelId
 
+        # @!attribute disable_current_after_swap
+        #   Whether to disable the current model after the swap.
+        #
+        #   @return [Boolean, nil]
+        optional :disable_current_after_swap,
+                 Cadenya::Internal::Type::Boolean,
+                 api_name: :disableCurrentAfterSwap
+
         # @!attribute next_model_id
         #   The model to move variations to. Accepts an id or "external_id:" slug.
         #
         #   @return [String, nil]
         optional :next_model_id, String, api_name: :nextModelId
 
-        # @!method initialize(current_model_id: nil, next_model_id: nil)
+        # @!method initialize(current_model_id: nil, disable_current_after_swap: nil, next_model_id: nil)
         #   @param current_model_id [String] The model variations are currently on. Accepts an id or "external_id:" slug.
         #
+        #   @param disable_current_after_swap [Boolean] Whether to disable the current model after the swap.
+        #
         #   @param next_model_id [String] The model to move variations to. Accepts an id or "external_id:" slug.
       end
     end

data/lib/cadenya/models/objectives/objective_tool_call_data.rb

@@ -26,6 +26,14 @@ module Cadenya
         optional :memo, String
 
         response_only do
+          # @!attribute resolved_secrets
+          #   List of resolved secrets used by the tool call
+          #
+          #   @return [Array<Cadenya::Models::Objectives::ResolvedSecret>, nil]
+          optional :resolved_secrets,
+                   -> { Cadenya::Internal::Type::ArrayOf[Cadenya::Objectives::ResolvedSecret] },
+                   api_name: :resolvedSecrets
+
           # @!attribute status_changed_by
           #   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
@@ -35,7 +43,7 @@ module Cadenya
           optional :status_changed_by, -> { Cadenya::Profile }, api_name: :statusChangedBy
         end
 
-        # @!method initialize(callable:, arguments: nil, memo: nil, status_changed_by: nil)
+        # @!method initialize(callable:, arguments: nil, memo: nil, resolved_secrets: nil, status_changed_by: nil)
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Objectives::ObjectiveToolCallData} for more details.
         #
@@ -45,6 +53,8 @@ module Cadenya
         #
         #   @param memo [String] A memo supplied by the reviewer when denying the tool call
         #
+        #   @param resolved_secrets [Array<Cadenya::Models::Objectives::ResolvedSecret>] List of resolved secrets used by the tool call
+        #
         #   @param status_changed_by [Cadenya::Models::Profile] A profile identifies a user or non-human principal (such as an API key)
       end
     end

data/lib/cadenya/models/objectives/objective_tool_call_info.rb

@@ -19,13 +19,39 @@ module Cadenya
         #   @return [Cadenya::Models::OperationMetadata, nil]
         optional :objective, -> { Cadenya::OperationMetadata }
 
-        # @!method initialize(created_by: nil, objective: nil)
+        # @!attribute 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.
+        #
+        #   @return [Cadenya::Models::BareMetadata, nil]
+        optional :tool, -> { Cadenya::BareMetadata }
+
+        # @!attribute tool_set
+        #   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.
+        #
+        #   @return [Cadenya::Models::BareMetadata, nil]
+        optional :tool_set, -> { Cadenya::BareMetadata }, api_name: :toolSet
+
+        # @!method initialize(created_by: nil, objective: nil, tool: nil, tool_set: nil)
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Objectives::ObjectiveToolCallInfo} for more details.
         #
         #   @param created_by [Cadenya::Models::Profile] A profile identifies a user or non-human principal (such as an API key)
         #
         #   @param objective [Cadenya::Models::OperationMetadata] Metadata for ephemeral operations and activities (e.g., objectives, executions,
+        #
+        #   @param tool [Cadenya::Models::BareMetadata] BareMetadata contains the minimal metadata for a resource: the ID and an
+        #
+        #   @param tool_set [Cadenya::Models::BareMetadata] BareMetadata contains the minimal metadata for a resource: the ID and an
       end
     end
 

data/lib/cadenya/models/objectives/objective_tool_call_with_result.rb

@@ -36,6 +36,14 @@ module Cadenya
                    enum: -> { Cadenya::Objectives::ObjectiveToolCallWithResult::ExecutionStatus },
                    api_name: :executionStatus
 
+          # @!attribute resolved_secrets
+          #   List of resolved secrets used by the tool call
+          #
+          #   @return [Array<Cadenya::Models::Objectives::ResolvedSecret>, nil]
+          optional :resolved_secrets,
+                   -> { Cadenya::Internal::Type::ArrayOf[Cadenya::Objectives::ResolvedSecret] },
+                   api_name: :resolvedSecrets
+
           # @!attribute result
           #   ObjectiveToolCallResult is the content a tool returned after execution. Tools
           #   can return multiple content blocks, and blocks can be multi-modal (text, image,
@@ -46,7 +54,7 @@ module Cadenya
           optional :result, -> { Cadenya::Objectives::ObjectiveToolCallResult }
         end
 
-        # @!method initialize(data:, execution_status:, info:, metadata:, status:, result: nil)
+        # @!method initialize(data:, execution_status:, info:, metadata:, status:, resolved_secrets: nil, result: nil)
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Objectives::ObjectiveToolCallWithResult} for more details.
         #
@@ -63,6 +71,8 @@ module Cadenya
         #
         #   @param status [Symbol, Cadenya::Models::Objectives::ObjectiveToolCallWithResult::Status] Current status of the tool call
         #
+        #   @param resolved_secrets [Array<Cadenya::Models::Objectives::ResolvedSecret>] List of resolved secrets used by the tool call
+        #
         #   @param result [Cadenya::Models::Objectives::ObjectiveToolCallResult] ObjectiveToolCallResult is the content a tool returned after execution.
 
         # @see Cadenya::Models::Objectives::ObjectiveToolCallWithResult#execution_status

data/lib/cadenya/models/objectives/resolved_secret.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Objectives
+      class ResolvedSecret < Cadenya::Internal::Type::BaseModel
+        # @!attribute key
+        #
+        #   @return [String, nil]
+        optional :key, String
+
+        # @!attribute source
+        #
+        #   @return [Symbol, Cadenya::Models::Objectives::ResolvedSecret::Source, nil]
+        optional :source, enum: -> { Cadenya::Objectives::ResolvedSecret::Source }
+
+        # @!method initialize(key: nil, source: nil)
+        #   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
+        #
+        #   @param key [String]
+        #   @param source [Symbol, Cadenya::Models::Objectives::ResolvedSecret::Source]
+
+        # @see Cadenya::Models::Objectives::ResolvedSecret#source
+        module Source
+          extend Cadenya::Internal::Type::Enum
+
+          RESOLVED_SECRET_SOURCE_UNSPECIFIED = :RESOLVED_SECRET_SOURCE_UNSPECIFIED
+          RESOLVED_SECRET_SOURCE_WORKSPACE = :RESOLVED_SECRET_SOURCE_WORKSPACE
+          RESOLVED_SECRET_SOURCE_TOOLSET = :RESOLVED_SECRET_SOURCE_TOOLSET
+          RESOLVED_SECRET_SOURCE_OBJECTIVE = :RESOLVED_SECRET_SOURCE_OBJECTIVE
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/cadenya/models/tool_sets/secret_create_params.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      # @see Cadenya::Resources::ToolSets::Secrets#create
+      class SecretCreateParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute tool_set_id
+        #
+        #   @return [String]
+        required :tool_set_id, String
+
+        # @!attribute metadata
+        #   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.
+        #
+        #   @return [Cadenya::Models::CreateResourceMetadata]
+        required :metadata, -> { Cadenya::CreateResourceMetadata }
+
+        # @!attribute spec
+        #
+        #   @return [Cadenya::Models::ToolSets::ToolSetSecretSpec]
+        required :spec, -> { Cadenya::ToolSets::ToolSetSecretSpec }
+
+        # @!method initialize(workspace_id:, tool_set_id:, metadata:, spec:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ToolSets::SecretCreateParams} for more details.
+        #
+        #   @param workspace_id [String]
+        #
+        #   @param tool_set_id [String]
+        #
+        #   @param metadata [Cadenya::Models::CreateResourceMetadata] CreateResourceMetadata contains the user-provided fields for creating
+        #
+        #   @param spec [Cadenya::Models::ToolSets::ToolSetSecretSpec]
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/cadenya/models/tool_sets/secret_delete_params.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      # @see Cadenya::Resources::ToolSets::Secrets#delete
+      class SecretDeleteParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute tool_set_id
+        #
+        #   @return [String]
+        required :tool_set_id, String
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(workspace_id:, tool_set_id:, id:, request_options: {})
+        #   @param workspace_id [String]
+        #   @param tool_set_id [String]
+        #   @param id [String]
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/cadenya/models/tool_sets/secret_list_params.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      # @see Cadenya::Resources::ToolSets::Secrets#list
+      class SecretListParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute tool_set_id
+        #
+        #   @return [String]
+        required :tool_set_id, String
+
+        # @!attribute bundle_key
+        #   Filter by bundle_key — return only resources owned by this bundle.
+        #
+        #   @return [String, nil]
+        optional :bundle_key, String
+
+        # @!attribute cursor
+        #   Pagination cursor from previous response
+        #
+        #   @return [String, nil]
+        optional :cursor, String
+
+        # @!attribute include_info
+        #   When set to true you may use more of your alloted API rate-limit
+        #
+        #   @return [Boolean, nil]
+        optional :include_info, Cadenya::Internal::Type::Boolean
+
+        # @!attribute limit
+        #   Maximum number of results to return
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer
+
+        # @!attribute prefix
+        #   Filter expression (query param: prefix)
+        #
+        #   @return [String, nil]
+        optional :prefix, String
+
+        # @!attribute query
+        #   Free-form search query
+        #
+        #   @return [String, nil]
+        optional :query, String
+
+        # @!attribute sort_order
+        #   Sort order for results (asc or desc by creation time)
+        #
+        #   @return [String, nil]
+        optional :sort_order, String
+
+        # @!method initialize(workspace_id:, tool_set_id:, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, request_options: {})
+        #   @param workspace_id [String]
+        #
+        #   @param tool_set_id [String]
+        #
+        #   @param bundle_key [String] Filter by bundle_key — return only resources owned by this bundle.
+        #
+        #   @param cursor [String] Pagination cursor from previous response
+        #
+        #   @param include_info [Boolean] When set to true you may use more of your alloted API rate-limit
+        #
+        #   @param limit [Integer] Maximum number of results to return
+        #
+        #   @param prefix [String] Filter expression (query param: prefix)
+        #
+        #   @param query [String] Free-form search query
+        #
+        #   @param sort_order [String] Sort order for results (asc or desc by creation time)
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/cadenya/models/tool_sets/secret_retrieve_params.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      # @see Cadenya::Resources::ToolSets::Secrets#retrieve
+      class SecretRetrieveParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute tool_set_id
+        #
+        #   @return [String]
+        required :tool_set_id, String
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(workspace_id:, tool_set_id:, id:, request_options: {})
+        #   @param workspace_id [String]
+        #   @param tool_set_id [String]
+        #   @param id [String]
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/cadenya/models/tool_sets/secret_update_params.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      # @see Cadenya::Resources::ToolSets::Secrets#update
+      class SecretUpdateParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute tool_set_id
+        #
+        #   @return [String]
+        required :tool_set_id, String
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute metadata
+        #   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.
+        #
+        #   @return [Cadenya::Models::UpdateResourceMetadata, nil]
+        optional :metadata, -> { Cadenya::UpdateResourceMetadata }
+
+        # @!attribute spec
+        #
+        #   @return [Cadenya::Models::ToolSets::ToolSetSecretSpec, nil]
+        optional :spec, -> { Cadenya::ToolSets::ToolSetSecretSpec }
+
+        # @!attribute update_mask
+        #   Fields to update.
+        #
+        #   @return [String, nil]
+        optional :update_mask, String, api_name: :updateMask
+
+        # @!method initialize(workspace_id:, tool_set_id:, id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ToolSets::SecretUpdateParams} for more details.
+        #
+        #   @param workspace_id [String]
+        #
+        #   @param tool_set_id [String]
+        #
+        #   @param id [String]
+        #
+        #   @param metadata [Cadenya::Models::UpdateResourceMetadata] UpdateResourceMetadata contains the user-provided fields for updating
+        #
+        #   @param spec [Cadenya::Models::ToolSets::ToolSetSecretSpec]
+        #
+        #   @param update_mask [String] Fields to update.
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end