cadenya 0.17.0 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95ccbe7ef557fb4d1a576ba7483e09020bc0d2c026df9f46ed23f1f49eccd13f
-  data.tar.gz: a781fcd75e6729b264dea552d6aa92b1d57595437cc02842d101349f04da7a3b
+  metadata.gz: 870caa5861d88c74a29670c427f0582778ef11797b8907256c9abf720b1d351f
+  data.tar.gz: 4c932d49f6ec3944cf1e6397863a9c09b493bff2532a0e2bbd2c013824005baf
 SHA512:
-  metadata.gz: 756a4245fc74b038820f35a617a383558455c2c430e522d61576d2d08ae79db93636fec67feca574094bdbbfe5d82a1966467fc5beb1336a998c6952384c9c9f
-  data.tar.gz: 9c538148f62bbfc2c22d7de12e14b426600a24a0a769782998c3f01af4fa6699809dedf204a6c1b0fbce91b7ffc714bf13406d718bb42d9a3fb50eba4a085d28
+  metadata.gz: ec277a7357047b4864a5b3460d7ea70bc8141e860084a73f76b93cb71a0a0b549fb02967bf79e030758d356e2ad19ebaee6f1f8d1d91a8804111dc79311b329b
+  data.tar.gz: d04915be80453482e4dcac1de5271ead1744caac3b8c903209d2f43d315607afdfdedbcede0b999f6001b87fe2d1af34c1d79584f8c2501300beef2b4c53cc3e

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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)

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.17.0"
+gem "cadenya", "~> 0.18.0"
 ```
 
 <!-- x-release-please-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

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

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      # @see Cadenya::Resources::ToolSets::Secrets#create
+      class ToolSetSecret < Cadenya::Internal::Type::BaseModel
+        # @!attribute metadata
+        #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        #
+        #   @return [Cadenya::Models::ResourceMetadata]
+        required :metadata, -> { Cadenya::ResourceMetadata }
+
+        # @!attribute spec
+        #
+        #   @return [Cadenya::Models::ToolSets::ToolSetSecretSpec]
+        required :spec, -> { Cadenya::ToolSets::ToolSetSecretSpec }
+
+        response_only do
+          # @!attribute info
+          #   Tool set secret information
+          #
+          #   @return [Cadenya::Models::ToolSets::ToolSetSecretInfo, nil]
+          optional :info, -> { Cadenya::ToolSets::ToolSetSecretInfo }
+        end
+
+        # @!method initialize(metadata:, spec:, info: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ToolSets::ToolSetSecret} for more details.
+        #
+        #   @param metadata [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        #
+        #   @param spec [Cadenya::Models::ToolSets::ToolSetSecretSpec]
+        #
+        #   @param info [Cadenya::Models::ToolSets::ToolSetSecretInfo] Tool set secret information
+      end
+    end
+
+    ToolSetSecret = ToolSets::ToolSetSecret
+  end
+end

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

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      class ToolSetSecretInfo < Cadenya::Internal::Type::BaseModel
+        # @!attribute created_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
+        #   workspaces.
+        #
+        #   @return [Cadenya::Models::Profile, nil]
+        optional :created_by, -> { Cadenya::Profile }, api_name: :createdBy
+
+        response_only do
+          # @!attribute last_used_at
+          #
+          #   @return [Time, nil]
+          optional :last_used_at, Time, api_name: :lastUsedAt
+        end
+
+        # @!method initialize(created_by: nil, last_used_at: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ToolSets::ToolSetSecretInfo} for more details.
+        #
+        #   @param created_by [Cadenya::Models::Profile] A profile identifies a user or non-human principal (such as an API key)
+        #
+        #   @param last_used_at [Time]
+      end
+    end
+
+    ToolSetSecretInfo = ToolSets::ToolSetSecretInfo
+  end
+end

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

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      class ToolSetSecretSpec < Cadenya::Internal::Type::BaseModel
+        # @!attribute value
+        #
+        #   @return [String, nil]
+        optional :value, String
+
+        # @!method initialize(value: nil)
+        #   @param value [String]
+      end
+    end
+
+    ToolSetSecretSpec = ToolSets::ToolSetSecretSpec
+  end
+end