cadenya 0.30.0 → 0.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5cf6a4a48bd9ffd441f8fb6b4a6ee91fc25a5296c50d52e49ec22892ebec3a87
-  data.tar.gz: c787c51e169c0eea08e7e61773b06df45a3bde4f5749ed82f2188c488333b2e4
+  metadata.gz: dac0e8c6022a63f3c33c62fca0c5bb8ba01434057ed39f8550e2e47069c6e701
+  data.tar.gz: 8612305347fd260fc37629022d774ef83a6b8a964f76dcfaca996810f86a4ecc
 SHA512:
-  metadata.gz: a3136f051b1bd97d922220532c5daf6d511aea663ec00c9831729c45bcbbda56a3d7e860072448e3ffca1a8a19839da4ec44cec2b3c31ab91d5940aa35ef171b
-  data.tar.gz: 33f6214ff31c4612cf1024908088b7727e818ef15d14ab740f3d51b4ecd1f33a7c4745d5d0aa2403344c1270fd5ec8b17f20b3e81e661540ed7f3b8144daa118
+  metadata.gz: 6805e7d3a55694fbcbcbaba00c56dbfd7eae5b28e5a6b9b7a2e524ac902cfb1f6a79fa03dd282b7dde3d88954b51d7d7c6a3b30ec88e6f71eb83b3a76f220c84
+  data.tar.gz: 10847a32205e46f2b42a110d458cb1236dafcbc1d55bce5aabc80dcf334aee9dba326b7a660ee98e05f0bc35fddd60f7a5072f602f1b7936d41ca50c77d694c6

data/CHANGELOG.md

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

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.30.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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cadenya
-  VERSION = "0.30.0"
+  VERSION = "0.31.0"
 end

data/rbi/cadenya/models/agents/agent_variation_spec_constraints.rbi

@@ -14,6 +14,16 @@ module Cadenya
             )
           end
 
+        # 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.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :inactivity_timeout
+
+        sig { params(inactivity_timeout: Integer).void }
+        attr_writer :inactivity_timeout
+
         # The maximum number of sub-objectives that can be created. 0 means no limit.
         sig { returns(T.nilable(Integer)) }
         attr_reader :max_sub_objectives
@@ -29,11 +39,18 @@ module Cadenya
         attr_writer :max_tool_calls
 
         sig do
-          params(max_sub_objectives: Integer, max_tool_calls: Integer).returns(
-            T.attached_class
-          )
+          params(
+            inactivity_timeout: Integer,
+            max_sub_objectives: Integer,
+            max_tool_calls: Integer
+          ).returns(T.attached_class)
         end
         def self.new(
+          # 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.
+          inactivity_timeout: nil,
           # The maximum number of sub-objectives that can be created. 0 means no limit.
           max_sub_objectives: nil,
           # The maximum number of tool calls that can be made. 0 means no limit.
@@ -43,7 +60,11 @@ module Cadenya
 
         sig do
           override.returns(
-            { max_sub_objectives: Integer, max_tool_calls: Integer }
+            {
+              inactivity_timeout: Integer,
+              max_sub_objectives: Integer,
+              max_tool_calls: Integer
+            }
           )
         end
         def to_hash

data/rbi/cadenya/models/agents/webhook_delivery_data.rbi

@@ -233,6 +233,11 @@ module Cadenya
               :OBJECTIVE_EVENT_TYPE_NOTICE,
               Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
             )
+          OBJECTIVE_EVENT_TYPE_TIMED_OUT =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_TIMED_OUT,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/cadenya/models/agents/webhook_delivery_list_params.rbi

@@ -202,6 +202,11 @@ module Cadenya
               :OBJECTIVE_EVENT_TYPE_NOTICE,
               Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
             )
+          OBJECTIVE_EVENT_TYPE_TIMED_OUT =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_TIMED_OUT,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/cadenya/models/objective.rbi

@@ -238,6 +238,8 @@ module Cadenya
           T.let(:STATE_CANCELLED, Cadenya::Objective::State::TaggedSymbol)
         STATE_FINALIZED =
           T.let(:STATE_FINALIZED, Cadenya::Objective::State::TaggedSymbol)
+        STATE_TIMED_OUT =
+          T.let(:STATE_TIMED_OUT, Cadenya::Objective::State::TaggedSymbol)
 
         sig do
           override.returns(T::Array[Cadenya::Objective::State::TaggedSymbol])

data/rbi/cadenya/models/objective_event_data.rbi

@@ -84,6 +84,20 @@ module Cadenya
       sig { params(sub_agent_updated: Cadenya::SubAgentUpdated::OrHash).void }
       attr_writer :sub_agent_updated
 
+      # 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.
+      sig { returns(T.nilable(Cadenya::ObjectiveEventData::TimedOut)) }
+      attr_reader :timed_out
+
+      sig do
+        params(timed_out: Cadenya::ObjectiveEventData::TimedOut::OrHash).void
+      end
+      attr_writer :timed_out
+
       sig { returns(T.nilable(Cadenya::ToolApprovalRequested)) }
       attr_reader :tool_approval_requested
 
@@ -147,6 +161,7 @@ module Cadenya
           notice: Cadenya::ObjectiveEventData::Notice::OrHash,
           sub_agent_spawned: Cadenya::SubAgentSpawned::OrHash,
           sub_agent_updated: Cadenya::SubAgentUpdated::OrHash,
+          timed_out: Cadenya::ObjectiveEventData::TimedOut::OrHash,
           tool_approval_requested: Cadenya::ToolApprovalRequested::OrHash,
           tool_approved: Cadenya::ToolApproved::OrHash,
           tool_called: Cadenya::ToolCalled::OrHash,
@@ -181,6 +196,13 @@ module Cadenya
         notice: nil,
         sub_agent_spawned: nil,
         sub_agent_updated: nil,
+        # 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.
+        timed_out: nil,
         tool_approval_requested: nil,
         tool_approved: nil,
         tool_called: nil,
@@ -204,6 +226,7 @@ module Cadenya
             notice: Cadenya::ObjectiveEventData::Notice,
             sub_agent_spawned: Cadenya::SubAgentSpawned,
             sub_agent_updated: Cadenya::SubAgentUpdated,
+            timed_out: Cadenya::ObjectiveEventData::TimedOut,
             tool_approval_requested: Cadenya::ToolApprovalRequested,
             tool_approved: Cadenya::ToolApproved,
             tool_called: Cadenya::ToolCalled,
@@ -396,6 +419,42 @@ module Cadenya
           end
         end
       end
+
+      class TimedOut < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::ObjectiveEventData::TimedOut,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # Human-readable note recorded at timeout time (e.g. "Timed out after 2h of
+        # inactivity").
+        sig { returns(T.nilable(String)) }
+        attr_reader :message
+
+        sig { params(message: String).void }
+        attr_writer :message
+
+        # 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.
+        sig { params(message: String).returns(T.attached_class) }
+        def self.new(
+          # Human-readable note recorded at timeout time (e.g. "Timed out after 2h of
+          # inactivity").
+          message: nil
+        )
+        end
+
+        sig { override.returns({ message: String }) }
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/cadenya/models/objective_list_params.rbi

@@ -179,6 +179,11 @@ module Cadenya
             :STATE_FINALIZED,
             Cadenya::ObjectiveListParams::State::TaggedSymbol
           )
+        STATE_TIMED_OUT =
+          T.let(
+            :STATE_TIMED_OUT,
+            Cadenya::ObjectiveListParams::State::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/sig/cadenya/models/agents/agent_variation_spec_constraints.rbs

@@ -4,9 +4,17 @@ module Cadenya
 
     module Agents
       type agent_variation_spec_constraints =
-        { max_sub_objectives: Integer, max_tool_calls: Integer }
+        {
+          inactivity_timeout: Integer,
+          max_sub_objectives: Integer,
+          max_tool_calls: Integer
+        }
 
       class AgentVariationSpecConstraints < Cadenya::Internal::Type::BaseModel
+        attr_reader inactivity_timeout: Integer?
+
+        def inactivity_timeout=: (Integer) -> Integer
+
         attr_reader max_sub_objectives: Integer?
 
         def max_sub_objectives=: (Integer) -> Integer
@@ -16,11 +24,16 @@ module Cadenya
         def max_tool_calls=: (Integer) -> Integer
 
         def initialize: (
+          ?inactivity_timeout: Integer,
           ?max_sub_objectives: Integer,
           ?max_tool_calls: Integer
         ) -> void
 
-        def to_hash: -> { max_sub_objectives: Integer, max_tool_calls: Integer }
+        def to_hash: -> {
+          inactivity_timeout: Integer,
+          max_sub_objectives: Integer,
+          max_tool_calls: Integer
+        }
       end
     end
   end

data/sig/cadenya/models/agents/webhook_delivery_data.rbs

@@ -106,6 +106,7 @@ module Cadenya
           | :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
           | :OBJECTIVE_EVENT_TYPE_FINALIZED
           | :OBJECTIVE_EVENT_TYPE_NOTICE
+          | :OBJECTIVE_EVENT_TYPE_TIMED_OUT
 
         module EventType
           extend Cadenya::Internal::Type::Enum
@@ -127,6 +128,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
 
           def self?.values: -> ::Array[Cadenya::Models::Agents::WebhookDeliveryData::event_type]
         end

data/sig/cadenya/models/agents/webhook_delivery_list_params.rbs

@@ -76,6 +76,7 @@ module Cadenya
           | :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
           | :OBJECTIVE_EVENT_TYPE_FINALIZED
           | :OBJECTIVE_EVENT_TYPE_NOTICE
+          | :OBJECTIVE_EVENT_TYPE_TIMED_OUT
 
         module EventType
           extend Cadenya::Internal::Type::Enum
@@ -97,6 +98,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
 
           def self?.values: -> ::Array[Cadenya::Models::Agents::WebhookDeliveryListParams::event_type]
         end

data/sig/cadenya/models/objective.rbs

@@ -113,6 +113,7 @@ module Cadenya
         | :STATE_FAILED
         | :STATE_CANCELLED
         | :STATE_FINALIZED
+        | :STATE_TIMED_OUT
 
       module State
         extend Cadenya::Internal::Type::Enum
@@ -124,6 +125,7 @@ module Cadenya
         STATE_FAILED: :STATE_FAILED
         STATE_CANCELLED: :STATE_CANCELLED
         STATE_FINALIZED: :STATE_FINALIZED
+        STATE_TIMED_OUT: :STATE_TIMED_OUT
 
         def self?.values: -> ::Array[Cadenya::Models::Objective::state]
       end

data/sig/cadenya/models/objective_event_data.rbs

@@ -11,6 +11,7 @@ module Cadenya
         notice: Cadenya::ObjectiveEventData::Notice,
         sub_agent_spawned: Cadenya::SubAgentSpawned,
         sub_agent_updated: Cadenya::SubAgentUpdated,
+        timed_out: Cadenya::ObjectiveEventData::TimedOut,
         tool_approval_requested: Cadenya::ToolApprovalRequested,
         tool_approved: Cadenya::ToolApproved,
         tool_called: Cadenya::ToolCalled,
@@ -72,6 +73,12 @@ module Cadenya
         Cadenya::SubAgentUpdated
       ) -> Cadenya::SubAgentUpdated
 
+      attr_reader timed_out: Cadenya::ObjectiveEventData::TimedOut?
+
+      def timed_out=: (
+        Cadenya::ObjectiveEventData::TimedOut
+      ) -> Cadenya::ObjectiveEventData::TimedOut
+
       attr_reader tool_approval_requested: Cadenya::ToolApprovalRequested?
 
       def tool_approval_requested=: (
@@ -116,6 +123,7 @@ module Cadenya
         ?notice: Cadenya::ObjectiveEventData::Notice,
         ?sub_agent_spawned: Cadenya::SubAgentSpawned,
         ?sub_agent_updated: Cadenya::SubAgentUpdated,
+        ?timed_out: Cadenya::ObjectiveEventData::TimedOut,
         ?tool_approval_requested: Cadenya::ToolApprovalRequested,
         ?tool_approved: Cadenya::ToolApproved,
         ?tool_called: Cadenya::ToolCalled,
@@ -136,6 +144,7 @@ module Cadenya
         notice: Cadenya::ObjectiveEventData::Notice,
         sub_agent_spawned: Cadenya::SubAgentSpawned,
         sub_agent_updated: Cadenya::SubAgentUpdated,
+        timed_out: Cadenya::ObjectiveEventData::TimedOut,
         tool_approval_requested: Cadenya::ToolApprovalRequested,
         tool_approved: Cadenya::ToolApproved,
         tool_called: Cadenya::ToolCalled,
@@ -216,6 +225,18 @@ module Cadenya
           def self?.values: -> ::Array[Cadenya::Models::ObjectiveEventData::Notice::level]
         end
       end
+
+      type timed_out = { message: String }
+
+      class TimedOut < Cadenya::Internal::Type::BaseModel
+        attr_reader message: String?
+
+        def message=: (String) -> String
+
+        def initialize: (?message: String) -> void
+
+        def to_hash: -> { message: String }
+      end
     end
   end
 end

data/sig/cadenya/models/objective_list_params.rbs

@@ -95,6 +95,7 @@ module Cadenya
         | :STATE_FAILED
         | :STATE_CANCELLED
         | :STATE_FINALIZED
+        | :STATE_TIMED_OUT
 
       module State
         extend Cadenya::Internal::Type::Enum
@@ -106,6 +107,7 @@ module Cadenya
         STATE_FAILED: :STATE_FAILED
         STATE_CANCELLED: :STATE_CANCELLED
         STATE_FINALIZED: :STATE_FINALIZED
+        STATE_TIMED_OUT: :STATE_TIMED_OUT
 
         def self?.values: -> ::Array[Cadenya::Models::ObjectiveListParams::state]
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cadenya
 version: !ruby/object:Gem::Version
-  version: 0.30.0
+  version: 0.31.0
 platform: ruby
 authors:
 - Cadenya
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-06 00:00:00.000000000 Z
+date: 2026-07-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi