cadenya 0.29.0 → 0.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d00d248c33699a4a01039ddd4d6123e9648ff8bc367c20a8e65e4885851cb60e
-  data.tar.gz: 81189360913ae6f04eb92b83ffdad219dade81eeb6eccb400318d39e89bc8e47
+  metadata.gz: dac0e8c6022a63f3c33c62fca0c5bb8ba01434057ed39f8550e2e47069c6e701
+  data.tar.gz: 8612305347fd260fc37629022d774ef83a6b8a964f76dcfaca996810f86a4ecc
 SHA512:
-  metadata.gz: c276b5b5f6499525a452490dc7df6de4ffd9109a666aa712dbcbc201420a9de9ef0cfbffae86174836e055bc31272a72303de43aa6c0ceb4c1de9123f4531ab3
-  data.tar.gz: c2f2abd24fa38008337bda2931e8c27e9e39ca1412a9a523ae3d678766e62f58a855de3373a533e4c9733b327ae40286764161dd2e7ef823cf65fa99cc7b820f
+  metadata.gz: 6805e7d3a55694fbcbcbaba00c56dbfd7eae5b28e5a6b9b7a2e524ac902cfb1f6a79fa03dd282b7dde3d88954b51d7d7c6a3b30ec88e6f71eb83b3a76f220c84
+  data.tar.gz: 10847a32205e46f2b42a110d458cb1236dafcbc1d55bce5aabc80dcf334aee9dba326b7a660ee98e05f0bc35fddd60f7a5072f602f1b7936d41ca50c77d694c6

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.31.0 (2026-07-07)
+
+Full Changelog: [v0.30.0...v0.31.0](https://github.com/cadenya/cadenya-ruby/compare/v0.30.0...v0.31.0)
+
+### Features
+
+* **api:** api update ([7b43203](https://github.com/cadenya/cadenya-ruby/commit/7b43203524536c3646637effe7f6c0babb3911a7))
+
+## 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)

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

data/lib/cadenya/models/agents/agent_variation_spec_constraints.rb

@@ -4,6 +4,15 @@ module Cadenya
   module Models
     module Agents
       class AgentVariationSpecConstraints < Cadenya::Internal::Type::BaseModel
+        # @!attribute inactivity_timeout
+        #   How long an objective may sit with no activity (no user messages, no LLM calls)
+        #   before it is finalized as timed out. Between 1 minute and 24 hours. When not
+        #   set, objectives are still swept at the system-wide 24 hour maximum — every
+        #   objective eventually reaches a terminal state.
+        #
+        #   @return [Integer, nil]
+        optional :inactivity_timeout, Integer, api_name: :inactivityTimeout
+
         # @!attribute max_sub_objectives
         #   The maximum number of sub-objectives that can be created. 0 means no limit.
         #
@@ -16,7 +25,12 @@ module Cadenya
         #   @return [Integer, nil]
         optional :max_tool_calls, Integer, api_name: :maxToolCalls
 
-        # @!method initialize(max_sub_objectives: nil, max_tool_calls: nil)
+        # @!method initialize(inactivity_timeout: nil, max_sub_objectives: nil, max_tool_calls: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::AgentVariationSpecConstraints} for more details.
+        #
+        #   @param inactivity_timeout [Integer] How long an objective may sit with no activity (no user messages, no
+        #
         #   @param max_sub_objectives [Integer] The maximum number of sub-objectives that can be created. 0 means no limit.
         #
         #   @param max_tool_calls [Integer] The maximum number of tool calls that can be made. 0 means no limit.

data/lib/cadenya/models/agents/webhook_delivery_data.rb

@@ -136,6 +136,7 @@ module Cadenya
           OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED = :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
           OBJECTIVE_EVENT_TYPE_FINALIZED = :OBJECTIVE_EVENT_TYPE_FINALIZED
           OBJECTIVE_EVENT_TYPE_NOTICE = :OBJECTIVE_EVENT_TYPE_NOTICE
+          OBJECTIVE_EVENT_TYPE_TIMED_OUT = :OBJECTIVE_EVENT_TYPE_TIMED_OUT
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/cadenya/models/agents/webhook_delivery_list_params.rb

@@ -78,6 +78,7 @@ module Cadenya
           OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED = :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
           OBJECTIVE_EVENT_TYPE_FINALIZED = :OBJECTIVE_EVENT_TYPE_FINALIZED
           OBJECTIVE_EVENT_TYPE_NOTICE = :OBJECTIVE_EVENT_TYPE_NOTICE
+          OBJECTIVE_EVENT_TYPE_TIMED_OUT = :OBJECTIVE_EVENT_TYPE_TIMED_OUT
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/cadenya/models/objective.rb

@@ -165,6 +165,7 @@ module Cadenya
         STATE_FAILED = :STATE_FAILED
         STATE_CANCELLED = :STATE_CANCELLED
         STATE_FINALIZED = :STATE_FINALIZED
+        STATE_TIMED_OUT = :STATE_TIMED_OUT
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/cadenya/models/objective_event_data.rb

@@ -64,6 +64,17 @@ module Cadenya
       #   @return [Cadenya::Models::SubAgentUpdated, nil]
       optional :sub_agent_updated, -> { Cadenya::SubAgentUpdated }, api_name: :subAgentUpdated
 
+      # @!attribute timed_out
+      #   ObjectiveTimedOut is the terminal event written when an objective is finalized
+      #   by the inactivity sweep because it saw no activity (no user messages, no LLM
+      #   calls) within its variation's inactivity timeout — or the system-wide 24 hour
+      #   maximum when no timeout is configured. The objective produces no output. After
+      #   this event, the objective is super-terminal: no further iterations, compaction,
+      #   or continuation are permitted.
+      #
+      #   @return [Cadenya::Models::ObjectiveEventData::TimedOut, nil]
+      optional :timed_out, -> { Cadenya::ObjectiveEventData::TimedOut }, api_name: :timedOut
+
       # @!attribute tool_approval_requested
       #
       #   @return [Cadenya::Models::ToolApprovalRequested, nil]
@@ -108,7 +119,7 @@ module Cadenya
       #   @return [Cadenya::Models::UserMessage, nil]
       optional :user_message, -> { Cadenya::UserMessage }, api_name: :userMessage
 
-      # @!method initialize(assistant_message: nil, cancelled: nil, context_window_compacted: nil, error: nil, finalized: nil, memory_read: nil, notice: nil, sub_agent_spawned: nil, sub_agent_updated: nil, tool_approval_requested: nil, tool_approved: nil, tool_called: nil, tool_denied: nil, tool_error: nil, tool_result: nil, type: nil, user_message: nil)
+      # @!method initialize(assistant_message: nil, cancelled: nil, context_window_compacted: nil, error: nil, finalized: nil, memory_read: nil, notice: nil, sub_agent_spawned: nil, sub_agent_updated: nil, timed_out: nil, tool_approval_requested: nil, tool_approved: nil, tool_called: nil, tool_denied: nil, tool_error: nil, tool_result: nil, type: nil, user_message: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ObjectiveEventData} for more details.
       #
@@ -130,6 +141,8 @@ module Cadenya
       #
       #   @param sub_agent_updated [Cadenya::Models::SubAgentUpdated]
       #
+      #   @param timed_out [Cadenya::Models::ObjectiveEventData::TimedOut] ObjectiveTimedOut is the terminal event written when an objective is
+      #
       #   @param tool_approval_requested [Cadenya::Models::ToolApprovalRequested]
       #
       #   @param tool_approved [Cadenya::Models::ToolApproved]
@@ -237,6 +250,29 @@ module Cadenya
           #   @return [Array<Symbol>]
         end
       end
+
+      # @see Cadenya::Models::ObjectiveEventData#timed_out
+      class TimedOut < Cadenya::Internal::Type::BaseModel
+        # @!attribute message
+        #   Human-readable note recorded at timeout time (e.g. "Timed out after 2h of
+        #   inactivity").
+        #
+        #   @return [String, nil]
+        optional :message, String
+
+        # @!method initialize(message: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ObjectiveEventData::TimedOut} for more details.
+        #
+        #   ObjectiveTimedOut is the terminal event written when an objective is finalized
+        #   by the inactivity sweep because it saw no activity (no user messages, no LLM
+        #   calls) within its variation's inactivity timeout — or the system-wide 24 hour
+        #   maximum when no timeout is configured. The objective produces no output. After
+        #   this event, the objective is super-terminal: no further iterations, compaction,
+        #   or continuation are permitted.
+        #
+        #   @param message [String] Human-readable note recorded at timeout time (e.g. "Timed out after 2h
+      end
     end
   end
 end

data/lib/cadenya/models/objective_list_params.rb

@@ -103,6 +103,7 @@ module Cadenya
         STATE_FAILED = :STATE_FAILED
         STATE_CANCELLED = :STATE_CANCELLED
         STATE_FINALIZED = :STATE_FINALIZED
+        STATE_TIMED_OUT = :STATE_TIMED_OUT
 
         # @!method self.values
         #   @return [Array<Symbol>]

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

@@ -263,6 +263,8 @@ module Cadenya
 
   ToolSetAdapter = Cadenya::Models::ToolSetAdapter
 
+  ToolSetAdapterBare = Cadenya::Models::ToolSetAdapterBare
+
   ToolSetAdapterHTTP = Cadenya::Models::ToolSetAdapterHTTP
 
   ToolSetAdapterMcp = Cadenya::Models::ToolSetAdapterMcp