cadenya 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eba2466a3e34e716fb0216440d0deb94999c5c96466b2c59b5999d39385cd916
-  data.tar.gz: 416782de6e871823e8e184ee7017290e62031b1fb4f594d31b12c791a4dea62b
+  metadata.gz: c3cc49ac49fbdbfff8fb89d30d752845056dc3d02f3c3d85bc0bfda74647948d
+  data.tar.gz: fc413c92248c0b5eea54f808545eaf8207caa90cbbd043e38e798a7b3c05e917
 SHA512:
-  metadata.gz: 311cde5d3c1c6f74ffbb17cc672329edbf466e3f920daed0a6d4e51528f23b7ccd7be738ef426d7297ef9793959d023695f87bcd5020f5c7d90d51f3c757d4f0
-  data.tar.gz: a12fc8e1371dfde54ba22e8c4bacf630d3ac9f141dd405eb1f2da7727874598ff42818881223e8b6b823c73af89b279145e4b4565c697a338b47a2cc409a482c
+  metadata.gz: c8efd167e60512e6bab2ea8532382565490fdfe2cd5bfa0a9f489b655c4cca369dc69fad7362cf1ff04981a41d297787936ce6a60133c1919e6bc6a09f3f6fd6
+  data.tar.gz: 5626793207092ca923346d462f8a5755e3b297092f9b1ced17379f09ea6be3ad7f4977eb9a798943ef1902989abe722efccf18431ba951ccb5f06ecb79925bfb

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.2.0 (2026-05-14)
+
+Full Changelog: [v0.1.0...v0.2.0](https://github.com/cadenya/cadenya-ruby/compare/v0.1.0...v0.2.0)
+
+### Features
+
+* **api:** api update ([ef1d2e7](https://github.com/cadenya/cadenya-ruby/commit/ef1d2e785d222bf4b027b628f93f4dc97d52c167))
+* **api:** api update ([d62dad1](https://github.com/cadenya/cadenya-ruby/commit/d62dad1c1f7103e636510cb7afb3a3e0a673c096))
+* **api:** api update ([b22688f](https://github.com/cadenya/cadenya-ruby/commit/b22688f6eaa880efe3c0016aced19fc2b94b43c3))
+* **api:** api update ([7b65d0c](https://github.com/cadenya/cadenya-ruby/commit/7b65d0c4606fac3bfde5d0bbf3b34d6fc2b3047e))
+
+
+### Bug Fixes
+
+* **client:** elide content type header on requests without body ([68e218f](https://github.com/cadenya/cadenya-ruby/commit/68e218f00e026629ee99d1c05bb62fe385de43e7))
+
 ## 0.1.0 (2026-05-06)
 
 Full Changelog: [v0.0.1...v0.1.0](https://github.com/cadenya/cadenya-ruby/compare/v0.0.1...v0.1.0)

data/README.md

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

data/lib/cadenya/internal/cursor_pagination.rb

@@ -94,7 +94,7 @@ module Cadenya
         # @!attribute next_cursor
         #
         #   @return [String, nil]
-        optional :next_cursor, String
+        optional :next_cursor, String, api_name: :nextCursor
 
         # @!method initialize(next_cursor: nil)
         #   @param next_cursor [String]

data/lib/cadenya/internal/transport/base_client.rb

@@ -306,6 +306,8 @@ module Cadenya
               Cadenya::Internal::Util.deep_merge(*[req[:body], opts[:extra_body]].compact)
             end
 
+          headers.delete("content-type") if body.nil?
+
           url = Cadenya::Internal::Util.join_parsed_uri(
             @base_url_components,
             {**req, path: path, query: query}

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

@@ -125,7 +125,6 @@ module Cadenya
           OBJECTIVE_EVENT_TYPE_TOOL_APPROVED = :OBJECTIVE_EVENT_TYPE_TOOL_APPROVED
           OBJECTIVE_EVENT_TYPE_TOOL_DENIED = :OBJECTIVE_EVENT_TYPE_TOOL_DENIED
           OBJECTIVE_EVENT_TYPE_TOOL_CALLED = :OBJECTIVE_EVENT_TYPE_TOOL_CALLED
-          OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED = :OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED
           OBJECTIVE_EVENT_TYPE_ERROR = :OBJECTIVE_EVENT_TYPE_ERROR
           OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE = :OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE
           OBJECTIVE_EVENT_TYPE_TOOL_RESULT = :OBJECTIVE_EVENT_TYPE_TOOL_RESULT
@@ -133,6 +132,8 @@ module Cadenya
           OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED = :OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED
           OBJECTIVE_EVENT_TYPE_MEMORY_READ = :OBJECTIVE_EVENT_TYPE_MEMORY_READ
           OBJECTIVE_EVENT_TYPE_CANCELLED = :OBJECTIVE_EVENT_TYPE_CANCELLED
+          OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED = :OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED
+          OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED = :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -67,7 +67,6 @@ module Cadenya
           OBJECTIVE_EVENT_TYPE_TOOL_APPROVED = :OBJECTIVE_EVENT_TYPE_TOOL_APPROVED
           OBJECTIVE_EVENT_TYPE_TOOL_DENIED = :OBJECTIVE_EVENT_TYPE_TOOL_DENIED
           OBJECTIVE_EVENT_TYPE_TOOL_CALLED = :OBJECTIVE_EVENT_TYPE_TOOL_CALLED
-          OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED = :OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED
           OBJECTIVE_EVENT_TYPE_ERROR = :OBJECTIVE_EVENT_TYPE_ERROR
           OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE = :OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE
           OBJECTIVE_EVENT_TYPE_TOOL_RESULT = :OBJECTIVE_EVENT_TYPE_TOOL_RESULT
@@ -75,6 +74,8 @@ module Cadenya
           OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED = :OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED
           OBJECTIVE_EVENT_TYPE_MEMORY_READ = :OBJECTIVE_EVENT_TYPE_MEMORY_READ
           OBJECTIVE_EVENT_TYPE_CANCELLED = :OBJECTIVE_EVENT_TYPE_CANCELLED
+          OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED = :OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED
+          OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED = :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/cadenya/models/objective_create_params.rb

@@ -27,8 +27,8 @@ module Cadenya
       #   operation. Read-only fields (id, account_id, workspace_id, created_at,
       #   profile_id) are excluded since they are set by the server.
       #
-      #   @return [Cadenya::Models::CreateOperationMetadata]
-      required :metadata, -> { Cadenya::CreateOperationMetadata }
+      #   @return [Cadenya::Models::CreateOperationMetadata, nil]
+      optional :metadata, -> { Cadenya::CreateOperationMetadata }
 
       # @!attribute variation_id
       #   Optional explicit variation selection. Overrides the agent's
@@ -37,7 +37,7 @@ module Cadenya
       #   @return [String, nil]
       optional :variation_id, String, api_name: :variationId
 
-      # @!method initialize(workspace_id:, agent_id:, data:, metadata:, variation_id: nil, request_options: {})
+      # @!method initialize(workspace_id:, agent_id:, data:, metadata: nil, variation_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ObjectiveCreateParams} for more details.
       #

data/lib/cadenya/models/objective_event_data.rb

@@ -36,10 +36,15 @@ module Cadenya
       #   @return [Cadenya::Models::MemoryRead, nil]
       optional :memory_read, -> { Cadenya::MemoryRead }, api_name: :memoryRead
 
-      # @!attribute sub_objective_created
+      # @!attribute sub_agent_spawned
       #
-      #   @return [Cadenya::Models::SubObjectiveCreated, nil]
-      optional :sub_objective_created, -> { Cadenya::SubObjectiveCreated }, api_name: :subObjectiveCreated
+      #   @return [Cadenya::Models::SubAgentSpawned, nil]
+      optional :sub_agent_spawned, -> { Cadenya::SubAgentSpawned }, api_name: :subAgentSpawned
+
+      # @!attribute sub_agent_updated
+      #
+      #   @return [Cadenya::Models::SubAgentUpdated, nil]
+      optional :sub_agent_updated, -> { Cadenya::SubAgentUpdated }, api_name: :subAgentUpdated
 
       # @!attribute tool_approval_requested
       #
@@ -85,7 +90,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, memory_read: nil, sub_objective_created: 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, memory_read: 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)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ObjectiveEventData} for more details.
       #
@@ -99,7 +104,9 @@ module Cadenya
       #
       #   @param memory_read [Cadenya::Models::MemoryRead] MemoryRead is emitted each time the agent resolves a key against the
       #
-      #   @param sub_objective_created [Cadenya::Models::SubObjectiveCreated]
+      #   @param sub_agent_spawned [Cadenya::Models::SubAgentSpawned]
+      #
+      #   @param sub_agent_updated [Cadenya::Models::SubAgentUpdated]
       #
       #   @param tool_approval_requested [Cadenya::Models::ToolApprovalRequested]
       #

data/lib/cadenya/models/objective_list_events_params.rb

@@ -35,6 +35,12 @@ module Cadenya
       #   @return [Integer, nil]
       optional :limit, Integer
 
+      # @!attribute since_event_id
+      #   Optional string to fetch events since an ID
+      #
+      #   @return [String, nil]
+      optional :since_event_id, String
+
       # @!attribute sort_order
       #   Sort order for results (asc or desc by creation time)
       #
@@ -47,7 +53,7 @@ module Cadenya
       #   @return [String, nil]
       optional :window_id, String
 
-      # @!method initialize(workspace_id:, objective_id:, cursor: nil, include_info: nil, limit: nil, sort_order: nil, window_id: nil, request_options: {})
+      # @!method initialize(workspace_id:, objective_id:, cursor: nil, include_info: nil, limit: nil, since_event_id: nil, sort_order: nil, window_id: nil, request_options: {})
       #   @param workspace_id [String]
       #
       #   @param objective_id [String]
@@ -58,6 +64,8 @@ module Cadenya
       #
       #   @param limit [Integer] Maximum number of results to return
       #
+      #   @param since_event_id [String] Optional string to fetch events since an ID
+      #
       #   @param sort_order [String] Sort order for results (asc or desc by creation time)
       #
       #   @param window_id [String] Optional context window ID to filter events by

data/lib/cadenya/models/sub_agent_spawned.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class SubAgentSpawned < Cadenya::Internal::Type::BaseModel
+      # @!attribute agent
+      #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+      #
+      #   @return [Cadenya::Models::ResourceMetadata, nil]
+      optional :agent, -> { Cadenya::ResourceMetadata }
+
+      # @!attribute objective
+      #   Metadata for ephemeral operations and activities (e.g., objectives, executions,
+      #   runs)
+      #
+      #   @return [Cadenya::Models::OperationMetadata, nil]
+      optional :objective, -> { Cadenya::OperationMetadata }
+
+      # @!attribute task
+      #
+      #   @return [String, nil]
+      optional :task, String
+
+      # @!method initialize(agent: nil, objective: nil, task: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::SubAgentSpawned} for more details.
+      #
+      #   @param agent [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+      #
+      #   @param objective [Cadenya::Models::OperationMetadata] Metadata for ephemeral operations and activities (e.g., objectives, executions,
+      #
+      #   @param task [String]
+    end
+  end
+end

data/lib/cadenya/models/sub_agent_updated.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class SubAgentUpdated < Cadenya::Internal::Type::BaseModel
+      # @!attribute agent
+      #   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 :agent, -> { Cadenya::BareMetadata }
+
+      # @!attribute message
+      #
+      #   @return [String, nil]
+      optional :message, String
+
+      # @!attribute objective
+      #   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 :objective, -> { Cadenya::BareMetadata }
+
+      # @!attribute status
+      #
+      #   @return [Symbol, Cadenya::Models::SubAgentUpdated::Status, nil]
+      optional :status, enum: -> { Cadenya::SubAgentUpdated::Status }
+
+      # @!method initialize(agent: nil, message: nil, objective: nil, status: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::SubAgentUpdated} for more details.
+      #
+      #   @param agent [Cadenya::Models::BareMetadata] BareMetadata contains the minimal metadata for a resource: the ID and an
+      #
+      #   @param message [String]
+      #
+      #   @param objective [Cadenya::Models::BareMetadata] BareMetadata contains the minimal metadata for a resource: the ID and an
+      #
+      #   @param status [Symbol, Cadenya::Models::SubAgentUpdated::Status]
+
+      # @see Cadenya::Models::SubAgentUpdated#status
+      module Status
+        extend Cadenya::Internal::Type::Enum
+
+        STATUS_UNSPECIFIED = :STATUS_UNSPECIFIED
+        STATUS_PENDING = :STATUS_PENDING
+        STATUS_RUNNING = :STATUS_RUNNING
+        STATUS_COMPLETED = :STATUS_COMPLETED
+        STATUS_FAILED = :STATUS_FAILED
+        STATUS_CANCELLED = :STATUS_CANCELLED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models.rb

@@ -217,7 +217,9 @@ module Cadenya
 
   SearchSearchToolsOrToolSetsParams = Cadenya::Models::SearchSearchToolsOrToolSetsParams
 
-  SubObjectiveCreated = Cadenya::Models::SubObjectiveCreated
+  SubAgentSpawned = Cadenya::Models::SubAgentSpawned
+
+  SubAgentUpdated = Cadenya::Models::SubAgentUpdated
 
   SyncCompleted = Cadenya::Models::SyncCompleted
 

data/lib/cadenya/resources/objectives.rb

@@ -20,7 +20,7 @@ module Cadenya
       #
       # Creates a new objective in the workspace
       #
-      # @overload create(workspace_id, agent_id:, data:, metadata:, variation_id: nil, request_options: {})
+      # @overload create(workspace_id, agent_id:, data:, metadata: nil, variation_id: nil, request_options: {})
       #
       # @param workspace_id [String]
       #
@@ -269,7 +269,7 @@ module Cadenya
 
       # Lists all events for an objective
       #
-      # @overload list_events(objective_id, workspace_id:, cursor: nil, include_info: nil, limit: nil, sort_order: nil, window_id: nil, request_options: {})
+      # @overload list_events(objective_id, workspace_id:, cursor: nil, include_info: nil, limit: nil, since_event_id: nil, sort_order: nil, window_id: nil, request_options: {})
       #
       # @param objective_id [String] Path param: Objective ID for filtering
       #
@@ -281,6 +281,8 @@ module Cadenya
       #
       # @param limit [Integer] Query param: Maximum number of results to return
       #
+      # @param since_event_id [String] Query param: Optional string to fetch events since an ID
+      #
       # @param sort_order [String] Query param: Sort order for results (asc or desc by creation time)
       #
       # @param window_id [String] Query param: Optional context window ID to filter events by
@@ -302,6 +304,7 @@ module Cadenya
           path: ["v1/workspaces/%1$s/objectives/%2$s/events", workspace_id, objective_id],
           query: query.transform_keys(
             include_info: "includeInfo",
+            since_event_id: "sinceEventId",
             sort_order: "sortOrder",
             window_id: "windowId"
           ),

data/lib/cadenya/version.rb

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

data/lib/cadenya.rb

@@ -222,7 +222,8 @@ require_relative "cadenya/models/resource_metadata"
 require_relative "cadenya/models/rotate_webhook_signing_key_response"
 require_relative "cadenya/models/search_search_tools_or_tool_sets_params"
 require_relative "cadenya/models/search_search_tools_or_tool_sets_response"
-require_relative "cadenya/models/sub_objective_created"
+require_relative "cadenya/models/sub_agent_spawned"
+require_relative "cadenya/models/sub_agent_updated"
 require_relative "cadenya/models/sync_completed"
 require_relative "cadenya/models/sync_failed"
 require_relative "cadenya/models/sync_started"

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

@@ -178,11 +178,6 @@ module Cadenya
               :OBJECTIVE_EVENT_TYPE_TOOL_CALLED,
               Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
             )
-          OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED =
-            T.let(
-              :OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED,
-              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
-            )
           OBJECTIVE_EVENT_TYPE_ERROR =
             T.let(
               :OBJECTIVE_EVENT_TYPE_ERROR,
@@ -218,6 +213,16 @@ module Cadenya
               :OBJECTIVE_EVENT_TYPE_CANCELLED,
               Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
             )
+          OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
 
           sig do
             override.returns(

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

@@ -147,11 +147,6 @@ module Cadenya
               :OBJECTIVE_EVENT_TYPE_TOOL_CALLED,
               Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
             )
-          OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED =
-            T.let(
-              :OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED,
-              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
-            )
           OBJECTIVE_EVENT_TYPE_ERROR =
             T.let(
               :OBJECTIVE_EVENT_TYPE_ERROR,
@@ -187,6 +182,16 @@ module Cadenya
               :OBJECTIVE_EVENT_TYPE_CANCELLED,
               Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
             )
+          OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/cadenya/models/objective_create_params.rbi

@@ -26,7 +26,7 @@ module Cadenya
       # CreateOperationMetadata contains the user-provided fields for creating an
       # operation. Read-only fields (id, account_id, workspace_id, created_at,
       # profile_id) are excluded since they are set by the server.
-      sig { returns(Cadenya::CreateOperationMetadata) }
+      sig { returns(T.nilable(Cadenya::CreateOperationMetadata)) }
       attr_reader :metadata
 
       sig { params(metadata: Cadenya::CreateOperationMetadata::OrHash).void }
@@ -57,7 +57,7 @@ module Cadenya
         # CreateOperationMetadata contains the user-provided fields for creating an
         # operation. Read-only fields (id, account_id, workspace_id, created_at,
         # profile_id) are excluded since they are set by the server.
-        metadata:,
+        metadata: nil,
         # Optional explicit variation selection. Overrides the agent's
         # variation_selection_mode.
         variation_id: nil,

data/rbi/cadenya/models/objective_event_data.rbi

@@ -50,13 +50,17 @@ module Cadenya
       sig { params(memory_read: Cadenya::MemoryRead::OrHash).void }
       attr_writer :memory_read
 
-      sig { returns(T.nilable(Cadenya::SubObjectiveCreated)) }
-      attr_reader :sub_objective_created
+      sig { returns(T.nilable(Cadenya::SubAgentSpawned)) }
+      attr_reader :sub_agent_spawned
 
-      sig do
-        params(sub_objective_created: Cadenya::SubObjectiveCreated::OrHash).void
-      end
-      attr_writer :sub_objective_created
+      sig { params(sub_agent_spawned: Cadenya::SubAgentSpawned::OrHash).void }
+      attr_writer :sub_agent_spawned
+
+      sig { returns(T.nilable(Cadenya::SubAgentUpdated)) }
+      attr_reader :sub_agent_updated
+
+      sig { params(sub_agent_updated: Cadenya::SubAgentUpdated::OrHash).void }
+      attr_writer :sub_agent_updated
 
       sig { returns(T.nilable(Cadenya::ToolApprovalRequested)) }
       attr_reader :tool_approval_requested
@@ -117,7 +121,8 @@ module Cadenya
           context_window_compacted: Cadenya::ContextWindowCompacted::OrHash,
           error: Cadenya::ObjectiveError::OrHash,
           memory_read: Cadenya::MemoryRead::OrHash,
-          sub_objective_created: Cadenya::SubObjectiveCreated::OrHash,
+          sub_agent_spawned: Cadenya::SubAgentSpawned::OrHash,
+          sub_agent_updated: Cadenya::SubAgentUpdated::OrHash,
           tool_approval_requested: Cadenya::ToolApprovalRequested::OrHash,
           tool_approved: Cadenya::ToolApproved::OrHash,
           tool_called: Cadenya::ToolCalled::OrHash,
@@ -140,7 +145,8 @@ module Cadenya
         # stack and loads an entry. Lookups that miss (key not found in any layer) do not
         # emit this event.
         memory_read: nil,
-        sub_objective_created: nil,
+        sub_agent_spawned: nil,
+        sub_agent_updated: nil,
         tool_approval_requested: nil,
         tool_approved: nil,
         tool_called: nil,
@@ -160,7 +166,8 @@ module Cadenya
             context_window_compacted: Cadenya::ContextWindowCompacted,
             error: Cadenya::ObjectiveError,
             memory_read: Cadenya::MemoryRead,
-            sub_objective_created: Cadenya::SubObjectiveCreated,
+            sub_agent_spawned: Cadenya::SubAgentSpawned,
+            sub_agent_updated: Cadenya::SubAgentUpdated,
             tool_approval_requested: Cadenya::ToolApprovalRequested,
             tool_approved: Cadenya::ToolApproved,
             tool_called: Cadenya::ToolCalled,

data/rbi/cadenya/models/objective_list_events_params.rbi

@@ -38,6 +38,13 @@ module Cadenya
       sig { params(limit: Integer).void }
       attr_writer :limit
 
+      # Optional string to fetch events since an ID
+      sig { returns(T.nilable(String)) }
+      attr_reader :since_event_id
+
+      sig { params(since_event_id: String).void }
+      attr_writer :since_event_id
+
       # Sort order for results (asc or desc by creation time)
       sig { returns(T.nilable(String)) }
       attr_reader :sort_order
@@ -59,6 +66,7 @@ module Cadenya
           cursor: String,
           include_info: T::Boolean,
           limit: Integer,
+          since_event_id: String,
           sort_order: String,
           window_id: String,
           request_options: Cadenya::RequestOptions::OrHash
@@ -73,6 +81,8 @@ module Cadenya
         include_info: nil,
         # Maximum number of results to return
         limit: nil,
+        # Optional string to fetch events since an ID
+        since_event_id: nil,
         # Sort order for results (asc or desc by creation time)
         sort_order: nil,
         # Optional context window ID to filter events by
@@ -89,6 +99,7 @@ module Cadenya
             cursor: String,
             include_info: T::Boolean,
             limit: Integer,
+            since_event_id: String,
             sort_order: String,
             window_id: String,
             request_options: Cadenya::RequestOptions

data/rbi/cadenya/models/sub_agent_spawned.rbi

@@ -0,0 +1,62 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class SubAgentSpawned < Cadenya::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::SubAgentSpawned, Cadenya::Internal::AnyHash)
+        end
+
+      # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+      sig { returns(T.nilable(Cadenya::ResourceMetadata)) }
+      attr_reader :agent
+
+      sig { params(agent: Cadenya::ResourceMetadata::OrHash).void }
+      attr_writer :agent
+
+      # Metadata for ephemeral operations and activities (e.g., objectives, executions,
+      # runs)
+      sig { returns(T.nilable(Cadenya::OperationMetadata)) }
+      attr_reader :objective
+
+      sig { params(objective: Cadenya::OperationMetadata::OrHash).void }
+      attr_writer :objective
+
+      sig { returns(T.nilable(String)) }
+      attr_reader :task
+
+      sig { params(task: String).void }
+      attr_writer :task
+
+      sig do
+        params(
+          agent: Cadenya::ResourceMetadata::OrHash,
+          objective: Cadenya::OperationMetadata::OrHash,
+          task: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        agent: nil,
+        # Metadata for ephemeral operations and activities (e.g., objectives, executions,
+        # runs)
+        objective: nil,
+        task: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            agent: Cadenya::ResourceMetadata,
+            objective: Cadenya::OperationMetadata,
+            task: String
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/sub_agent_updated.rbi

@@ -0,0 +1,127 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class SubAgentUpdated < Cadenya::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::SubAgentUpdated, Cadenya::Internal::AnyHash)
+        end
+
+      # 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.
+      sig { returns(T.nilable(Cadenya::BareMetadata)) }
+      attr_reader :agent
+
+      sig { params(agent: Cadenya::BareMetadata::OrHash).void }
+      attr_writer :agent
+
+      sig { returns(T.nilable(String)) }
+      attr_reader :message
+
+      sig { params(message: String).void }
+      attr_writer :message
+
+      # 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.
+      sig { returns(T.nilable(Cadenya::BareMetadata)) }
+      attr_reader :objective
+
+      sig { params(objective: Cadenya::BareMetadata::OrHash).void }
+      attr_writer :objective
+
+      sig { returns(T.nilable(Cadenya::SubAgentUpdated::Status::TaggedSymbol)) }
+      attr_reader :status
+
+      sig { params(status: Cadenya::SubAgentUpdated::Status::OrSymbol).void }
+      attr_writer :status
+
+      sig do
+        params(
+          agent: Cadenya::BareMetadata::OrHash,
+          message: String,
+          objective: Cadenya::BareMetadata::OrHash,
+          status: Cadenya::SubAgentUpdated::Status::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # 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.
+        agent: nil,
+        message: nil,
+        # 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.
+        objective: nil,
+        status: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            agent: Cadenya::BareMetadata,
+            message: String,
+            objective: Cadenya::BareMetadata,
+            status: Cadenya::SubAgentUpdated::Status::TaggedSymbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module Status
+        extend Cadenya::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Cadenya::SubAgentUpdated::Status) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        STATUS_UNSPECIFIED =
+          T.let(
+            :STATUS_UNSPECIFIED,
+            Cadenya::SubAgentUpdated::Status::TaggedSymbol
+          )
+        STATUS_PENDING =
+          T.let(:STATUS_PENDING, Cadenya::SubAgentUpdated::Status::TaggedSymbol)
+        STATUS_RUNNING =
+          T.let(:STATUS_RUNNING, Cadenya::SubAgentUpdated::Status::TaggedSymbol)
+        STATUS_COMPLETED =
+          T.let(
+            :STATUS_COMPLETED,
+            Cadenya::SubAgentUpdated::Status::TaggedSymbol
+          )
+        STATUS_FAILED =
+          T.let(:STATUS_FAILED, Cadenya::SubAgentUpdated::Status::TaggedSymbol)
+        STATUS_CANCELLED =
+          T.let(
+            :STATUS_CANCELLED,
+            Cadenya::SubAgentUpdated::Status::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Cadenya::SubAgentUpdated::Status::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models.rbi

@@ -186,7 +186,9 @@ module Cadenya
   SearchSearchToolsOrToolSetsParams =
     Cadenya::Models::SearchSearchToolsOrToolSetsParams
 
-  SubObjectiveCreated = Cadenya::Models::SubObjectiveCreated
+  SubAgentSpawned = Cadenya::Models::SubAgentSpawned
+
+  SubAgentUpdated = Cadenya::Models::SubAgentUpdated
 
   SyncCompleted = Cadenya::Models::SyncCompleted
 

data/rbi/cadenya/resources/objectives.rbi

@@ -33,7 +33,7 @@ module Cadenya
         # CreateOperationMetadata contains the user-provided fields for creating an
         # operation. Read-only fields (id, account_id, workspace_id, created_at,
         # profile_id) are excluded since they are set by the server.
-        metadata:,
+        metadata: nil,
         # Optional explicit variation selection. Overrides the agent's
         # variation_selection_mode.
         variation_id: nil,
@@ -207,6 +207,7 @@ module Cadenya
           cursor: String,
           include_info: T::Boolean,
           limit: Integer,
+          since_event_id: String,
           sort_order: String,
           window_id: String,
           request_options: Cadenya::RequestOptions::OrHash
@@ -227,6 +228,8 @@ module Cadenya
         include_info: nil,
         # Query param: Maximum number of results to return
         limit: nil,
+        # Query param: Optional string to fetch events since an ID
+        since_event_id: nil,
         # Query param: Sort order for results (asc or desc by creation time)
         sort_order: nil,
         # Query param: Optional context window ID to filter events by

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

@@ -95,7 +95,6 @@ module Cadenya
           | :OBJECTIVE_EVENT_TYPE_TOOL_APPROVED
           | :OBJECTIVE_EVENT_TYPE_TOOL_DENIED
           | :OBJECTIVE_EVENT_TYPE_TOOL_CALLED
-          | :OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED
           | :OBJECTIVE_EVENT_TYPE_ERROR
           | :OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE
           | :OBJECTIVE_EVENT_TYPE_TOOL_RESULT
@@ -103,6 +102,8 @@ module Cadenya
           | :OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED
           | :OBJECTIVE_EVENT_TYPE_MEMORY_READ
           | :OBJECTIVE_EVENT_TYPE_CANCELLED
+          | :OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED
+          | :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
 
         module EventType
           extend Cadenya::Internal::Type::Enum
@@ -113,7 +114,6 @@ module Cadenya
           OBJECTIVE_EVENT_TYPE_TOOL_APPROVED: :OBJECTIVE_EVENT_TYPE_TOOL_APPROVED
           OBJECTIVE_EVENT_TYPE_TOOL_DENIED: :OBJECTIVE_EVENT_TYPE_TOOL_DENIED
           OBJECTIVE_EVENT_TYPE_TOOL_CALLED: :OBJECTIVE_EVENT_TYPE_TOOL_CALLED
-          OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED: :OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED
           OBJECTIVE_EVENT_TYPE_ERROR: :OBJECTIVE_EVENT_TYPE_ERROR
           OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE: :OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE
           OBJECTIVE_EVENT_TYPE_TOOL_RESULT: :OBJECTIVE_EVENT_TYPE_TOOL_RESULT
@@ -121,6 +121,8 @@ module Cadenya
           OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED: :OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED
           OBJECTIVE_EVENT_TYPE_MEMORY_READ: :OBJECTIVE_EVENT_TYPE_MEMORY_READ
           OBJECTIVE_EVENT_TYPE_CANCELLED: :OBJECTIVE_EVENT_TYPE_CANCELLED
+          OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED: :OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED
+          OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED: :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
 
           def self?.values: -> ::Array[Cadenya::Models::Agents::WebhookDeliveryData::event_type]
         end

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

@@ -65,7 +65,6 @@ module Cadenya
           | :OBJECTIVE_EVENT_TYPE_TOOL_APPROVED
           | :OBJECTIVE_EVENT_TYPE_TOOL_DENIED
           | :OBJECTIVE_EVENT_TYPE_TOOL_CALLED
-          | :OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED
           | :OBJECTIVE_EVENT_TYPE_ERROR
           | :OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE
           | :OBJECTIVE_EVENT_TYPE_TOOL_RESULT
@@ -73,6 +72,8 @@ module Cadenya
           | :OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED
           | :OBJECTIVE_EVENT_TYPE_MEMORY_READ
           | :OBJECTIVE_EVENT_TYPE_CANCELLED
+          | :OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED
+          | :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
 
         module EventType
           extend Cadenya::Internal::Type::Enum
@@ -83,7 +84,6 @@ module Cadenya
           OBJECTIVE_EVENT_TYPE_TOOL_APPROVED: :OBJECTIVE_EVENT_TYPE_TOOL_APPROVED
           OBJECTIVE_EVENT_TYPE_TOOL_DENIED: :OBJECTIVE_EVENT_TYPE_TOOL_DENIED
           OBJECTIVE_EVENT_TYPE_TOOL_CALLED: :OBJECTIVE_EVENT_TYPE_TOOL_CALLED
-          OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED: :OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED
           OBJECTIVE_EVENT_TYPE_ERROR: :OBJECTIVE_EVENT_TYPE_ERROR
           OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE: :OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE
           OBJECTIVE_EVENT_TYPE_TOOL_RESULT: :OBJECTIVE_EVENT_TYPE_TOOL_RESULT
@@ -91,6 +91,8 @@ module Cadenya
           OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED: :OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED
           OBJECTIVE_EVENT_TYPE_MEMORY_READ: :OBJECTIVE_EVENT_TYPE_MEMORY_READ
           OBJECTIVE_EVENT_TYPE_CANCELLED: :OBJECTIVE_EVENT_TYPE_CANCELLED
+          OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED: :OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED
+          OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED: :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
 
           def self?.values: -> ::Array[Cadenya::Models::Agents::WebhookDeliveryListParams::event_type]
         end

data/sig/cadenya/models/objective_create_params.rbs

@@ -20,7 +20,11 @@ module Cadenya
 
       attr_accessor data: Cadenya::ObjectiveData
 
-      attr_accessor metadata: Cadenya::CreateOperationMetadata
+      attr_reader metadata: Cadenya::CreateOperationMetadata?
+
+      def metadata=: (
+        Cadenya::CreateOperationMetadata
+      ) -> Cadenya::CreateOperationMetadata
 
       attr_reader variation_id: String?
 
@@ -30,7 +34,7 @@ module Cadenya
         workspace_id: String,
         agent_id: String,
         data: Cadenya::ObjectiveData,
-        metadata: Cadenya::CreateOperationMetadata,
+        ?metadata: Cadenya::CreateOperationMetadata,
         ?variation_id: String,
         ?request_options: Cadenya::request_opts
       ) -> void

data/sig/cadenya/models/objective_event_data.rbs

@@ -7,7 +7,8 @@ module Cadenya
         context_window_compacted: Cadenya::ContextWindowCompacted,
         error: Cadenya::ObjectiveError,
         memory_read: Cadenya::MemoryRead,
-        sub_objective_created: Cadenya::SubObjectiveCreated,
+        sub_agent_spawned: Cadenya::SubAgentSpawned,
+        sub_agent_updated: Cadenya::SubAgentUpdated,
         tool_approval_requested: Cadenya::ToolApprovalRequested,
         tool_approved: Cadenya::ToolApproved,
         tool_called: Cadenya::ToolCalled,
@@ -45,11 +46,17 @@ module Cadenya
 
       def memory_read=: (Cadenya::MemoryRead) -> Cadenya::MemoryRead
 
-      attr_reader sub_objective_created: Cadenya::SubObjectiveCreated?
+      attr_reader sub_agent_spawned: Cadenya::SubAgentSpawned?
 
-      def sub_objective_created=: (
-        Cadenya::SubObjectiveCreated
-      ) -> Cadenya::SubObjectiveCreated
+      def sub_agent_spawned=: (
+        Cadenya::SubAgentSpawned
+      ) -> Cadenya::SubAgentSpawned
+
+      attr_reader sub_agent_updated: Cadenya::SubAgentUpdated?
+
+      def sub_agent_updated=: (
+        Cadenya::SubAgentUpdated
+      ) -> Cadenya::SubAgentUpdated
 
       attr_reader tool_approval_requested: Cadenya::ToolApprovalRequested?
 
@@ -91,7 +98,8 @@ module Cadenya
         ?context_window_compacted: Cadenya::ContextWindowCompacted,
         ?error: Cadenya::ObjectiveError,
         ?memory_read: Cadenya::MemoryRead,
-        ?sub_objective_created: Cadenya::SubObjectiveCreated,
+        ?sub_agent_spawned: Cadenya::SubAgentSpawned,
+        ?sub_agent_updated: Cadenya::SubAgentUpdated,
         ?tool_approval_requested: Cadenya::ToolApprovalRequested,
         ?tool_approved: Cadenya::ToolApproved,
         ?tool_called: Cadenya::ToolCalled,
@@ -108,7 +116,8 @@ module Cadenya
         context_window_compacted: Cadenya::ContextWindowCompacted,
         error: Cadenya::ObjectiveError,
         memory_read: Cadenya::MemoryRead,
-        sub_objective_created: Cadenya::SubObjectiveCreated,
+        sub_agent_spawned: Cadenya::SubAgentSpawned,
+        sub_agent_updated: Cadenya::SubAgentUpdated,
         tool_approval_requested: Cadenya::ToolApprovalRequested,
         tool_approved: Cadenya::ToolApproved,
         tool_called: Cadenya::ToolCalled,

data/sig/cadenya/models/objective_list_events_params.rbs

@@ -7,6 +7,7 @@ module Cadenya
         cursor: String,
         include_info: bool,
         limit: Integer,
+        since_event_id: String,
         sort_order: String,
         window_id: String
       }
@@ -32,6 +33,10 @@ module Cadenya
 
       def limit=: (Integer) -> Integer
 
+      attr_reader since_event_id: String?
+
+      def since_event_id=: (String) -> String
+
       attr_reader sort_order: String?
 
       def sort_order=: (String) -> String
@@ -46,6 +51,7 @@ module Cadenya
         ?cursor: String,
         ?include_info: bool,
         ?limit: Integer,
+        ?since_event_id: String,
         ?sort_order: String,
         ?window_id: String,
         ?request_options: Cadenya::request_opts
@@ -57,6 +63,7 @@ module Cadenya
         cursor: String,
         include_info: bool,
         limit: Integer,
+        since_event_id: String,
         sort_order: String,
         window_id: String,
         request_options: Cadenya::RequestOptions

data/sig/cadenya/models/sub_agent_spawned.rbs

@@ -0,0 +1,36 @@
+module Cadenya
+  module Models
+    type sub_agent_spawned =
+      {
+        agent: Cadenya::ResourceMetadata,
+        objective: Cadenya::OperationMetadata,
+        task: String
+      }
+
+    class SubAgentSpawned < Cadenya::Internal::Type::BaseModel
+      attr_reader agent: Cadenya::ResourceMetadata?
+
+      def agent=: (Cadenya::ResourceMetadata) -> Cadenya::ResourceMetadata
+
+      attr_reader objective: Cadenya::OperationMetadata?
+
+      def objective=: (Cadenya::OperationMetadata) -> Cadenya::OperationMetadata
+
+      attr_reader task: String?
+
+      def task=: (String) -> String
+
+      def initialize: (
+        ?agent: Cadenya::ResourceMetadata,
+        ?objective: Cadenya::OperationMetadata,
+        ?task: String
+      ) -> void
+
+      def to_hash: -> {
+        agent: Cadenya::ResourceMetadata,
+        objective: Cadenya::OperationMetadata,
+        task: String
+      }
+    end
+  end
+end

data/sig/cadenya/models/sub_agent_updated.rbs

@@ -0,0 +1,66 @@
+module Cadenya
+  module Models
+    type sub_agent_updated =
+      {
+        agent: Cadenya::BareMetadata,
+        message: String,
+        objective: Cadenya::BareMetadata,
+        status: Cadenya::Models::SubAgentUpdated::status
+      }
+
+    class SubAgentUpdated < Cadenya::Internal::Type::BaseModel
+      attr_reader agent: Cadenya::BareMetadata?
+
+      def agent=: (Cadenya::BareMetadata) -> Cadenya::BareMetadata
+
+      attr_reader message: String?
+
+      def message=: (String) -> String
+
+      attr_reader objective: Cadenya::BareMetadata?
+
+      def objective=: (Cadenya::BareMetadata) -> Cadenya::BareMetadata
+
+      attr_reader status: Cadenya::Models::SubAgentUpdated::status?
+
+      def status=: (
+        Cadenya::Models::SubAgentUpdated::status
+      ) -> Cadenya::Models::SubAgentUpdated::status
+
+      def initialize: (
+        ?agent: Cadenya::BareMetadata,
+        ?message: String,
+        ?objective: Cadenya::BareMetadata,
+        ?status: Cadenya::Models::SubAgentUpdated::status
+      ) -> void
+
+      def to_hash: -> {
+        agent: Cadenya::BareMetadata,
+        message: String,
+        objective: Cadenya::BareMetadata,
+        status: Cadenya::Models::SubAgentUpdated::status
+      }
+
+      type status =
+        :STATUS_UNSPECIFIED
+        | :STATUS_PENDING
+        | :STATUS_RUNNING
+        | :STATUS_COMPLETED
+        | :STATUS_FAILED
+        | :STATUS_CANCELLED
+
+      module Status
+        extend Cadenya::Internal::Type::Enum
+
+        STATUS_UNSPECIFIED: :STATUS_UNSPECIFIED
+        STATUS_PENDING: :STATUS_PENDING
+        STATUS_RUNNING: :STATUS_RUNNING
+        STATUS_COMPLETED: :STATUS_COMPLETED
+        STATUS_FAILED: :STATUS_FAILED
+        STATUS_CANCELLED: :STATUS_CANCELLED
+
+        def self?.values: -> ::Array[Cadenya::Models::SubAgentUpdated::status]
+      end
+    end
+  end
+end

data/sig/cadenya/models.rbs

@@ -177,7 +177,9 @@ module Cadenya
 
   class SearchSearchToolsOrToolSetsParams = Cadenya::Models::SearchSearchToolsOrToolSetsParams
 
-  class SubObjectiveCreated = Cadenya::Models::SubObjectiveCreated
+  class SubAgentSpawned = Cadenya::Models::SubAgentSpawned
+
+  class SubAgentUpdated = Cadenya::Models::SubAgentUpdated
 
   class SyncCompleted = Cadenya::Models::SyncCompleted
 

data/sig/cadenya/resources/objectives.rbs

@@ -13,7 +13,7 @@ module Cadenya
         String workspace_id,
         agent_id: String,
         data: Cadenya::ObjectiveData,
-        metadata: Cadenya::CreateOperationMetadata,
+        ?metadata: Cadenya::CreateOperationMetadata,
         ?variation_id: String,
         ?request_options: Cadenya::request_opts
       ) -> Cadenya::Objective
@@ -76,6 +76,7 @@ module Cadenya
         ?cursor: String,
         ?include_info: bool,
         ?limit: Integer,
+        ?since_event_id: String,
         ?sort_order: String,
         ?window_id: String,
         ?request_options: Cadenya::request_opts

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cadenya
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Cadenya
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-06 00:00:00.000000000 Z
+date: 2026-05-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -252,7 +252,8 @@ files:
 - lib/cadenya/models/rotate_webhook_signing_key_response.rb
 - lib/cadenya/models/search_search_tools_or_tool_sets_params.rb
 - lib/cadenya/models/search_search_tools_or_tool_sets_response.rb
-- lib/cadenya/models/sub_objective_created.rb
+- lib/cadenya/models/sub_agent_spawned.rb
+- lib/cadenya/models/sub_agent_updated.rb
 - lib/cadenya/models/sync_completed.rb
 - lib/cadenya/models/sync_failed.rb
 - lib/cadenya/models/sync_started.rb
@@ -530,7 +531,8 @@ files:
 - rbi/cadenya/models/rotate_webhook_signing_key_response.rbi
 - rbi/cadenya/models/search_search_tools_or_tool_sets_params.rbi
 - rbi/cadenya/models/search_search_tools_or_tool_sets_response.rbi
-- rbi/cadenya/models/sub_objective_created.rbi
+- rbi/cadenya/models/sub_agent_spawned.rbi
+- rbi/cadenya/models/sub_agent_updated.rbi
 - rbi/cadenya/models/sync_completed.rbi
 - rbi/cadenya/models/sync_failed.rbi
 - rbi/cadenya/models/sync_started.rbi
@@ -807,7 +809,8 @@ files:
 - sig/cadenya/models/rotate_webhook_signing_key_response.rbs
 - sig/cadenya/models/search_search_tools_or_tool_sets_params.rbs
 - sig/cadenya/models/search_search_tools_or_tool_sets_response.rbs
-- sig/cadenya/models/sub_objective_created.rbs
+- sig/cadenya/models/sub_agent_spawned.rbs
+- sig/cadenya/models/sub_agent_updated.rbs
 - sig/cadenya/models/sync_completed.rbs
 - sig/cadenya/models/sync_failed.rbs
 - sig/cadenya/models/sync_started.rbs

data/lib/cadenya/models/sub_objective_created.rb

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-module Cadenya
-  module Models
-    class SubObjectiveCreated < Cadenya::Internal::Type::BaseModel
-      # @!attribute metadata
-      #   Metadata for ephemeral operations and activities (e.g., objectives, executions,
-      #   runs)
-      #
-      #   @return [Cadenya::Models::OperationMetadata, nil]
-      optional :metadata, -> { Cadenya::OperationMetadata }
-
-      # @!method initialize(metadata: nil)
-      #   Some parameter documentations has been truncated, see
-      #   {Cadenya::Models::SubObjectiveCreated} for more details.
-      #
-      #   @param metadata [Cadenya::Models::OperationMetadata] Metadata for ephemeral operations and activities (e.g., objectives, executions,
-    end
-  end
-end

data/rbi/cadenya/models/sub_objective_created.rbi

@@ -1,36 +0,0 @@
-# typed: strong
-
-module Cadenya
-  module Models
-    class SubObjectiveCreated < Cadenya::Internal::Type::BaseModel
-      OrHash =
-        T.type_alias do
-          T.any(Cadenya::SubObjectiveCreated, Cadenya::Internal::AnyHash)
-        end
-
-      # Metadata for ephemeral operations and activities (e.g., objectives, executions,
-      # runs)
-      sig { returns(T.nilable(Cadenya::OperationMetadata)) }
-      attr_reader :metadata
-
-      sig { params(metadata: Cadenya::OperationMetadata::OrHash).void }
-      attr_writer :metadata
-
-      sig do
-        params(metadata: Cadenya::OperationMetadata::OrHash).returns(
-          T.attached_class
-        )
-      end
-      def self.new(
-        # Metadata for ephemeral operations and activities (e.g., objectives, executions,
-        # runs)
-        metadata: nil
-      )
-      end
-
-      sig { override.returns({ metadata: Cadenya::OperationMetadata }) }
-      def to_hash
-      end
-    end
-  end
-end

data/sig/cadenya/models/sub_objective_created.rbs

@@ -1,15 +0,0 @@
-module Cadenya
-  module Models
-    type sub_objective_created = { metadata: Cadenya::OperationMetadata }
-
-    class SubObjectiveCreated < Cadenya::Internal::Type::BaseModel
-      attr_reader metadata: Cadenya::OperationMetadata?
-
-      def metadata=: (Cadenya::OperationMetadata) -> Cadenya::OperationMetadata
-
-      def initialize: (?metadata: Cadenya::OperationMetadata) -> void
-
-      def to_hash: -> { metadata: Cadenya::OperationMetadata }
-    end
-  end
-end