cadenya 0.28.0 → 0.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bf555cd84ae5279087a5b60695fec05f03451abbb21cc910c5e85cb1ed52c56e
-  data.tar.gz: b7662e178b9f76f9e044bdff89f57bb78a75fd58ef92c9f7ac4c75ed45aef3a6
+  metadata.gz: 5cf6a4a48bd9ffd441f8fb6b4a6ee91fc25a5296c50d52e49ec22892ebec3a87
+  data.tar.gz: c787c51e169c0eea08e7e61773b06df45a3bde4f5749ed82f2188c488333b2e4
 SHA512:
-  metadata.gz: eb71eb5d8238a2f9d63ceadf1ebd77230fbed22f146eada9da0abeb2b578128646b6bbe3feaaf4cc179d5e894cd9c94ab96f413cbf63cbf72ebe94e1b6d42c66
-  data.tar.gz: 4bb21c37969a3c091aa854523f4e45e323ad513f299b384978befb9d975ad442b0ad24c0c064ae1ff41ec9b1cb781c92ce1bd744531504707ec912e79a4f800c
+  metadata.gz: a3136f051b1bd97d922220532c5daf6d511aea663ec00c9831729c45bcbbda56a3d7e860072448e3ffca1a8a19839da4ec44cec2b3c31ab91d5940aa35ef171b
+  data.tar.gz: 33f6214ff31c4612cf1024908088b7727e818ef15d14ab740f3d51b4ecd1f33a7c4745d5d0aa2403344c1270fd5ec8b17f20b3e81e661540ed7f3b8144daa118

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.30.0 (2026-07-06)
+
+Full Changelog: [v0.29.0...v0.30.0](https://github.com/cadenya/cadenya-ruby/compare/v0.29.0...v0.30.0)
+
+### Features
+
+* Bare toolset proto contract: Bare adapter, SetToolCallContent, WAITING_FOR_CONTENT (ENG-385) ([075baa7](https://github.com/cadenya/cadenya-ruby/commit/075baa7b039c12f2f097c7b688935f3e14d4f98f))
+
+## 0.29.0 (2026-07-05)
+
+Full Changelog: [v0.28.0...v0.29.0](https://github.com/cadenya/cadenya-ruby/compare/v0.28.0...v0.29.0)
+
+### Features
+
+* **api:** api update ([e14c0d7](https://github.com/cadenya/cadenya-ruby/commit/e14c0d7509075b97bf655215eb5f266e8903b3a6))
+
 ## 0.28.0 (2026-07-04)
 
 Full Changelog: [v0.27.0...v0.28.0](https://github.com/cadenya/cadenya-ruby/compare/v0.27.0...v0.28.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.28.0"
+gem "cadenya", "~> 0.30.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/cadenya/models/context_lengths.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ContextLengths < Cadenya::Internal::Type::BaseModel
+      response_only do
+        # @!attribute assistant_messages
+        #   Chat history messages with the assistant role.
+        #
+        #   @return [Integer]
+        required :assistant_messages, Integer, api_name: :assistantMessages
+
+        # @!attribute available_tools
+        #   The discoverable/available-tools appendix attached to the system prompt.
+        #
+        #   @return [Integer]
+        required :available_tools, Integer, api_name: :availableTools
+
+        # @!attribute episodic_memory
+        #   The episodic memory appendix attached to the system prompt.
+        #
+        #   @return [Integer]
+        required :episodic_memory, Integer, api_name: :episodicMemory
+
+        # @!attribute skills_memory
+        #   The skills memory appendix attached to the system prompt.
+        #
+        #   @return [Integer]
+        required :skills_memory, Integer, api_name: :skillsMemory
+
+        # @!attribute system_prompt
+        #   The objective's base system prompt (rendered variation template).
+        #
+        #   @return [Integer]
+        required :system_prompt, Integer, api_name: :systemPrompt
+
+        # @!attribute tool_definitions
+        #   Serialized tool definitions sent with the completion request (names,
+        #   descriptions, and JSON-schema parameters).
+        #
+        #   @return [Integer]
+        required :tool_definitions, Integer, api_name: :toolDefinitions
+
+        # @!attribute tool_results
+        #   Tool results present in the chat history.
+        #
+        #   @return [Integer]
+        required :tool_results, Integer, api_name: :toolResults
+
+        # @!attribute user_messages
+        #   Chat history messages with the user role.
+        #
+        #   @return [Integer]
+        required :user_messages, Integer, api_name: :userMessages
+      end
+
+      # @!method initialize(assistant_messages:, available_tools:, episodic_memory:, skills_memory:, system_prompt:, tool_definitions:, tool_results:, user_messages:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ContextLengths} for more details.
+      #
+      #   ContextLengths is the measured character length of each distinct component of an
+      #   iteration's assembled context window. Values are raw character lengths of the
+      #   component as assembled into the request — token estimates are derived by the
+      #   client against input_tokens (component share = component length / sum of all
+      #   lengths).
+      #
+      #   New components are added as new fields — wire-compatible; absent components read
+      #   as 0.
+      #
+      #   @param assistant_messages [Integer] Chat history messages with the assistant role.
+      #
+      #   @param available_tools [Integer] The discoverable/available-tools appendix attached to the system prompt.
+      #
+      #   @param episodic_memory [Integer] The episodic memory appendix attached to the system prompt.
+      #
+      #   @param skills_memory [Integer] The skills memory appendix attached to the system prompt.
+      #
+      #   @param system_prompt [Integer] The objective's base system prompt (rendered variation template).
+      #
+      #   @param tool_definitions [Integer] Serialized tool definitions sent with the completion request
+      #
+      #   @param tool_results [Integer] Tool results present in the chat history.
+      #
+      #   @param user_messages [Integer] Chat history messages with the user role.
+    end
+  end
+end

data/lib/cadenya/models/objective_diagnostics.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ObjectiveDiagnostics < Cadenya::Internal::Type::BaseModel
+      response_only do
+        # @!attribute cached_input_tokens
+        #   The portion of input_tokens served from the provider's prompt cache. Lets
+        #   clients distinguish "big but cached" from "big and paid fresh every iteration".
+        #
+        #   @return [Integer]
+        required :cached_input_tokens, Integer, api_name: :cachedInputTokens
+
+        # @!attribute context_lengths
+        #   ContextLengths is the measured character length of each distinct component of an
+        #   iteration's assembled context window. Values are raw character lengths of the
+        #   component as assembled into the request — token estimates are derived by the
+        #   client against input_tokens (component share = component length / sum of all
+        #   lengths).
+        #
+        #   New components are added as new fields — wire-compatible; absent components read
+        #   as 0.
+        #
+        #   @return [Cadenya::Models::ContextLengths]
+        required :context_lengths, -> { Cadenya::ContextLengths }, api_name: :contextLengths
+
+        # @!attribute input_tokens
+        #   Input tokens reported by the LLM provider for the iteration's completion.
+        #
+        #   @return [Integer]
+        required :input_tokens, Integer, api_name: :inputTokens
+      end
+
+      # @!method initialize(cached_input_tokens:, context_lengths:, input_tokens:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ObjectiveDiagnostics} for more details.
+      #
+      #   ObjectiveDiagnostics is the context-usage breakdown measured for a single
+      #   iteration at request-assembly time. It reports how much of the context window
+      #   each component occupies so tool parameters, memory cascades, and prompts can be
+      #   tuned against real token usage.
+      #
+      #   @param cached_input_tokens [Integer] The portion of input_tokens served from the provider's prompt cache.
+      #
+      #   @param context_lengths [Cadenya::Models::ContextLengths] ContextLengths is the measured character length of each distinct component
+      #
+      #   @param input_tokens [Integer] Input tokens reported by the LLM provider for the iteration's completion.
+    end
+  end
+end

data/lib/cadenya/models/objective_retrieve_diagnostics_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Objectives#retrieve_diagnostics
+    class ObjectiveRetrieveDiagnosticsParams < 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 objective_id
+      #
+      #   @return [String]
+      required :objective_id, String
+
+      # @!method initialize(workspace_id:, objective_id:, request_options: {})
+      #   @param workspace_id [String]
+      #   @param objective_id [String]
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cadenya/models/objective_retrieve_diagnostics_response.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Objectives#retrieve_diagnostics
+    class ObjectiveRetrieveDiagnosticsResponse < Cadenya::Internal::Type::BaseModel
+      response_only do
+        # @!attribute diagnostics
+        #   ObjectiveDiagnostics is the context-usage breakdown measured for a single
+        #   iteration at request-assembly time. It reports how much of the context window
+        #   each component occupies so tool parameters, memory cascades, and prompts can be
+        #   tuned against real token usage.
+        #
+        #   @return [Cadenya::Models::ObjectiveDiagnostics]
+        required :diagnostics, -> { Cadenya::ObjectiveDiagnostics }
+      end
+
+      # @!method initialize(diagnostics:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ObjectiveRetrieveDiagnosticsResponse} for more details.
+      #
+      #   @param diagnostics [Cadenya::Models::ObjectiveDiagnostics] ObjectiveDiagnostics is the context-usage breakdown measured for a single
+    end
+  end
+end

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

@@ -64,6 +64,7 @@ module Cadenya
           TOOL_CALL_EXECUTION_STATUS_RUNNING = :TOOL_CALL_EXECUTION_STATUS_RUNNING
           TOOL_CALL_EXECUTION_STATUS_COMPLETED = :TOOL_CALL_EXECUTION_STATUS_COMPLETED
           TOOL_CALL_EXECUTION_STATUS_ERRORED = :TOOL_CALL_EXECUTION_STATUS_ERRORED
+          TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT = :TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -84,6 +84,7 @@ module Cadenya
           TOOL_CALL_EXECUTION_STATUS_RUNNING = :TOOL_CALL_EXECUTION_STATUS_RUNNING
           TOOL_CALL_EXECUTION_STATUS_COMPLETED = :TOOL_CALL_EXECUTION_STATUS_COMPLETED
           TOOL_CALL_EXECUTION_STATUS_ERRORED = :TOOL_CALL_EXECUTION_STATUS_ERRORED
+          TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT = :TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Objectives
+      class SetToolCallContentRequestAudioBlock < Cadenya::Internal::Type::BaseModel
+        # @!attribute data
+        #   Base64-encoded audio bytes.
+        #
+        #   @return [String]
+        required :data, String
+
+        # @!attribute mime_type
+        #   IANA media type of the audio, e.g. audio/wav.
+        #
+        #   @return [String]
+        required :mime_type, String, api_name: :mimeType
+
+        # @!method initialize(data:, mime_type:)
+        #   @param data [String] Base64-encoded audio bytes.
+        #
+        #   @param mime_type [String] IANA media type of the audio, e.g. audio/wav.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Objectives
+      class SetToolCallContentRequestContentBlock < Cadenya::Internal::Type::BaseModel
+        # @!attribute audio
+        #
+        #   @return [Cadenya::Models::Objectives::SetToolCallContentRequestAudioBlock, nil]
+        optional :audio, -> { Cadenya::Objectives::SetToolCallContentRequestAudioBlock }
+
+        # @!attribute image
+        #
+        #   @return [Cadenya::Models::Objectives::SetToolCallContentRequestImageBlock, nil]
+        optional :image, -> { Cadenya::Objectives::SetToolCallContentRequestImageBlock }
+
+        # @!attribute text
+        #
+        #   @return [Cadenya::Models::Objectives::SetToolCallContentRequestTextBlock, nil]
+        optional :text, -> { Cadenya::Objectives::SetToolCallContentRequestTextBlock }
+
+        # @!method initialize(audio: nil, image: nil, text: nil)
+        #   ContentBlock is a single block of tool call content supplied on input. Exactly
+        #   one of the variants is set.
+        #
+        #   @param audio [Cadenya::Models::Objectives::SetToolCallContentRequestAudioBlock]
+        #   @param image [Cadenya::Models::Objectives::SetToolCallContentRequestImageBlock]
+        #   @param text [Cadenya::Models::Objectives::SetToolCallContentRequestTextBlock]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Objectives
+      class SetToolCallContentRequestImageBlock < Cadenya::Internal::Type::BaseModel
+        # @!attribute data
+        #   Base64-encoded image bytes.
+        #
+        #   @return [String]
+        required :data, String
+
+        # @!attribute mime_type
+        #   IANA media type of the image, e.g. image/png.
+        #
+        #   @return [String]
+        required :mime_type, String, api_name: :mimeType
+
+        # @!method initialize(data:, mime_type:)
+        #   @param data [String] Base64-encoded image bytes.
+        #
+        #   @param mime_type [String] IANA media type of the image, e.g. image/png.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Objectives
+      class SetToolCallContentRequestTextBlock < Cadenya::Internal::Type::BaseModel
+        # @!attribute text
+        #
+        #   @return [String]
+        required :text, String
+
+        # @!method initialize(text:)
+        #   @param text [String]
+      end
+    end
+  end
+end

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

@@ -24,6 +24,14 @@ module Cadenya
         #   @return [String, nil]
         optional :cursor, String
 
+        # @!attribute execution_status
+        #   Filter by tool call execution status. Useful for reverse-harness polling of bare
+        #   tool calls waiting for externally supplied content
+        #   (TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT).
+        #
+        #   @return [Symbol, Cadenya::Models::Objectives::ToolCallListParams::ExecutionStatus, nil]
+        optional :execution_status, enum: -> { Cadenya::Objectives::ToolCallListParams::ExecutionStatus }
+
         # @!attribute include_info
         #   When set to true you may use more of your alloted API rate-limit
         #
@@ -42,13 +50,18 @@ module Cadenya
         #   @return [Symbol, Cadenya::Models::Objectives::ToolCallListParams::Status, nil]
         optional :status, enum: -> { Cadenya::Objectives::ToolCallListParams::Status }
 
-        # @!method initialize(workspace_id:, objective_id:, cursor: nil, include_info: nil, limit: nil, status: nil, request_options: {})
+        # @!method initialize(workspace_id:, objective_id:, cursor: nil, execution_status: nil, include_info: nil, limit: nil, status: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Objectives::ToolCallListParams} for more details.
+        #
         #   @param workspace_id [String]
         #
         #   @param objective_id [String]
         #
         #   @param cursor [String] Pagination cursor from previous response
         #
+        #   @param execution_status [Symbol, Cadenya::Models::Objectives::ToolCallListParams::ExecutionStatus] Filter by tool call execution status. Useful for reverse-harness
+        #
         #   @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
@@ -57,6 +70,23 @@ module Cadenya
         #
         #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
 
+        # Filter by tool call execution status. Useful for reverse-harness polling of bare
+        # tool calls waiting for externally supplied content
+        # (TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT).
+        module ExecutionStatus
+          extend Cadenya::Internal::Type::Enum
+
+          TOOL_CALL_EXECUTION_STATUS_UNSPECIFIED = :TOOL_CALL_EXECUTION_STATUS_UNSPECIFIED
+          TOOL_CALL_EXECUTION_STATUS_PENDING = :TOOL_CALL_EXECUTION_STATUS_PENDING
+          TOOL_CALL_EXECUTION_STATUS_RUNNING = :TOOL_CALL_EXECUTION_STATUS_RUNNING
+          TOOL_CALL_EXECUTION_STATUS_COMPLETED = :TOOL_CALL_EXECUTION_STATUS_COMPLETED
+          TOOL_CALL_EXECUTION_STATUS_ERRORED = :TOOL_CALL_EXECUTION_STATUS_ERRORED
+          TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT = :TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         # Filter by tool call status
         module Status
           extend Cadenya::Internal::Type::Enum

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

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Objectives
+      # @see Cadenya::Resources::Objectives::ToolCalls#set_content
+      class ToolCallSetContentParams < 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 objective_id
+        #
+        #   @return [String]
+        required :objective_id, String
+
+        # @!attribute tool_call_id
+        #
+        #   @return [String]
+        required :tool_call_id, String
+
+        # @!attribute content
+        #   The content to set on the tool call. Mirrors
+        #   ObjectiveToolCallResult.ContentBlock but writable: media blocks carry raw data
+        #   on input where the result-side carries a signed url on output.
+        #
+        #   @return [Array<Cadenya::Models::Objectives::SetToolCallContentRequestContentBlock>]
+        required :content,
+                 -> { Cadenya::Internal::Type::ArrayOf[Cadenya::Objectives::SetToolCallContentRequestContentBlock] }
+
+        # @!method initialize(workspace_id:, objective_id:, tool_call_id:, content:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Objectives::ToolCallSetContentParams} for more details.
+        #
+        #   @param workspace_id [String]
+        #
+        #   @param objective_id [String]
+        #
+        #   @param tool_call_id [String]
+        #
+        #   @param content [Array<Cadenya::Models::Objectives::SetToolCallContentRequestContentBlock>] The content to set on the tool call. Mirrors
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/cadenya/models/tool_called.rb

@@ -3,13 +3,45 @@
 module Cadenya
   module Models
     class ToolCalled < Cadenya::Internal::Type::BaseModel
+      # @!attribute arguments
+      #   The arguments passed to the tool.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :arguments, Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown]
+
+      # @!attribute config
+      #   Config defines the adapter to use for the tool. This is used to determine how
+      #   the tool is called. For example, if the tool is an HTTP tool, the adapter will
+      #   be Http. If the tool is an inline tool, the adapter will be Inline.
+      #
+      #   @return [Cadenya::Models::ToolSets::ToolSpecConfig, nil]
+      optional :config, -> { Cadenya::ToolSets::ToolSpecConfig }
+
+      # @!attribute tool
+      #   CallableTool is a union that represents a tool that can be called by an agent.
+      #   In Cadenya, a tool that is used within an agent objective might be a
+      #   user-defined tool (IE: MCP, HTTP), another Agent (useful to separate context),
+      #   or a Cadenya Tool (one Cadenya provides).
+      #
+      #   @return [Cadenya::Models::CallableTool, nil]
+      optional :tool, -> { Cadenya::CallableTool }
+
       # @!attribute tool_call_id
       #   The ID of the objective tool call record that was executed.
       #
       #   @return [String, nil]
       optional :tool_call_id, String, api_name: :toolCallId
 
-      # @!method initialize(tool_call_id: nil)
+      # @!method initialize(arguments: nil, config: nil, tool: nil, tool_call_id: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ToolCalled} for more details.
+      #
+      #   @param arguments [Hash{Symbol=>Object}] The arguments passed to the tool.
+      #
+      #   @param config [Cadenya::Models::ToolSets::ToolSpecConfig] Config defines the adapter to use for the tool.
+      #
+      #   @param tool [Cadenya::Models::CallableTool] CallableTool is a union that represents a tool that can be called by an agent. I
+      #
       #   @param tool_call_id [String] The ID of the objective tool call record that was executed.
     end
   end

data/lib/cadenya/models/tool_set_adapter.rb

@@ -3,6 +3,16 @@
 module Cadenya
   module Models
     class ToolSetAdapter < Cadenya::Internal::Type::BaseModel
+      # @!attribute bare
+      #   Bare tool sets define tools without an execution adapter. A bare tool call
+      #   doesn't fire anything: the objective's workflow pauses and waits for an external
+      #   API consumer to set the tool call's content (e.g. human-in-the-loop tools, or a
+      #   reverse harness that polls for pending tool calls, executes locally, and reports
+      #   results back via SetToolCallContent).
+      #
+      #   @return [Cadenya::Models::ToolSetAdapterBare, nil]
+      optional :bare, -> { Cadenya::ToolSetAdapterBare }
+
       # @!attribute http
       #
       #   @return [Cadenya::Models::ToolSetAdapterHTTP, nil]
@@ -18,9 +28,16 @@ module Cadenya
       #   @return [Cadenya::Models::ToolSetAdapterOpenAPI, nil]
       optional :openapi, -> { Cadenya::ToolSetAdapterOpenAPI }
 
-      # @!method initialize(http: nil, mcp: nil, openapi: nil)
+      # @!method initialize(bare: nil, http: nil, mcp: nil, openapi: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ToolSetAdapter} for more details.
+      #
+      #   @param bare [Cadenya::Models::ToolSetAdapterBare] Bare tool sets define tools without an execution adapter. A bare tool
+      #
       #   @param http [Cadenya::Models::ToolSetAdapterHTTP]
+      #
       #   @param mcp [Cadenya::Models::ToolSetAdapterMcp]
+      #
       #   @param openapi [Cadenya::Models::ToolSetAdapterOpenAPI]
     end
   end

data/lib/cadenya/models/tool_set_adapter_bare.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ToolSetAdapterBare < Cadenya::Internal::Type::BaseModel
+      # @!attribute content_timeout
+      #   How long to wait for content to be set before the tool call errors. If unset,
+      #   the call waits indefinitely.
+      #
+      #   @return [Integer, nil]
+      optional :content_timeout, Integer, api_name: :contentTimeout
+
+      # @!method initialize(content_timeout: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ToolSetAdapterBare} for more details.
+      #
+      #   Bare tool sets define tools without an execution adapter. A bare tool call
+      #   doesn't fire anything: the objective's workflow pauses and waits for an external
+      #   API consumer to set the tool call's content (e.g. human-in-the-loop tools, or a
+      #   reverse harness that polls for pending tool calls, executes locally, and reports
+      #   results back via SetToolCallContent).
+      #
+      #   @param content_timeout [Integer] How long to wait for content to be set before the tool call errors.
+    end
+  end
+end

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

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      class ConfigBare < Cadenya::Internal::Type::BaseModel
+        # @!method initialize
+        #   Marks the tool as bare: it has no execution adapter of its own and relies on the
+        #   parent tool set being a Bare tool set. Present so a webhook consumer can tell a
+        #   tool is bare from the tool data alone, without cross-referencing the tool set.
+      end
+    end
+  end
+end

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

@@ -4,6 +4,14 @@ module Cadenya
   module Models
     module ToolSets
       class ToolSpecConfig < Cadenya::Internal::Type::BaseModel
+        # @!attribute bare
+        #   Marks the tool as bare: it has no execution adapter of its own and relies on the
+        #   parent tool set being a Bare tool set. Present so a webhook consumer can tell a
+        #   tool is bare from the tool data alone, without cross-referencing the tool set.
+        #
+        #   @return [Cadenya::Models::ToolSets::ConfigBare, nil]
+        optional :bare, -> { Cadenya::ToolSets::ConfigBare }
+
         # @!attribute http
         #
         #   @return [Cadenya::Models::ToolSets::ConfigHTTP, nil]
@@ -19,13 +27,20 @@ module Cadenya
         #   @return [Cadenya::Models::ToolSets::ConfigOpenAPI, nil]
         optional :openapi, -> { Cadenya::ToolSets::ConfigOpenAPI }
 
-        # @!method initialize(http: nil, mcp: nil, openapi: nil)
+        # @!method initialize(bare: nil, http: nil, mcp: nil, openapi: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ToolSets::ToolSpecConfig} for more details.
+        #
         #   Config defines the adapter to use for the tool. This is used to determine how
         #   the tool is called. For example, if the tool is an HTTP tool, the adapter will
         #   be Http. If the tool is an inline tool, the adapter will be Inline.
         #
+        #   @param bare [Cadenya::Models::ToolSets::ConfigBare] Marks the tool as bare: it has no execution adapter of its own and
+        #
         #   @param http [Cadenya::Models::ToolSets::ConfigHTTP]
+        #
         #   @param mcp [Cadenya::Models::ToolSets::ConfigMcp]
+        #
         #   @param openapi [Cadenya::Models::ToolSets::ConfigOpenAPI]
       end
     end

data/lib/cadenya/models.rb

@@ -125,6 +125,8 @@ module Cadenya
 
   CallableTool = Cadenya::Models::CallableTool
 
+  ContextLengths = Cadenya::Models::ContextLengths
+
   ContextWindowCompacted = Cadenya::Models::ContextWindowCompacted
 
   CreateOperationMetadata = Cadenya::Models::CreateOperationMetadata
@@ -183,6 +185,8 @@ module Cadenya
 
   ObjectiveCreateParams = Cadenya::Models::ObjectiveCreateParams
 
+  ObjectiveDiagnostics = Cadenya::Models::ObjectiveDiagnostics
+
   ObjectiveError = Cadenya::Models::ObjectiveError
 
   ObjectiveEvent = Cadenya::Models::ObjectiveEvent
@@ -201,6 +205,8 @@ module Cadenya
 
   ObjectiveListParams = Cadenya::Models::ObjectiveListParams
 
+  ObjectiveRetrieveDiagnosticsParams = Cadenya::Models::ObjectiveRetrieveDiagnosticsParams
+
   ObjectiveRetrieveParams = Cadenya::Models::ObjectiveRetrieveParams
 
   Objectives = Cadenya::Models::Objectives
@@ -257,6 +263,8 @@ module Cadenya
 
   ToolSetAdapter = Cadenya::Models::ToolSetAdapter
 
+  ToolSetAdapterBare = Cadenya::Models::ToolSetAdapterBare
+
   ToolSetAdapterHTTP = Cadenya::Models::ToolSetAdapterHTTP
 
   ToolSetAdapterMcp = Cadenya::Models::ToolSetAdapterMcp