cadenya 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eba2466a3e34e716fb0216440d0deb94999c5c96466b2c59b5999d39385cd916
-  data.tar.gz: 416782de6e871823e8e184ee7017290e62031b1fb4f594d31b12c791a4dea62b
+  metadata.gz: 7dff0947b39a815faaea2a4f68747c1d0117318d8f2aee08f8bca4cab40b69f7
+  data.tar.gz: ec5c0bb41033ed07ab07d33fd24dac1853b9ec65280dc8493902646d62e5eb03
 SHA512:
-  metadata.gz: 311cde5d3c1c6f74ffbb17cc672329edbf466e3f920daed0a6d4e51528f23b7ccd7be738ef426d7297ef9793959d023695f87bcd5020f5c7d90d51f3c757d4f0
-  data.tar.gz: a12fc8e1371dfde54ba22e8c4bacf630d3ac9f141dd405eb1f2da7727874598ff42818881223e8b6b823c73af89b279145e4b4565c697a338b47a2cc409a482c
+  metadata.gz: 146f613ac26f3669be288789e44d5727defcbf3373b5fe74c0b5cd11352476be830358a4def179cddb144192629ad7e14c798cb25ac48907c7379879e6ce5a60
+  data.tar.gz: 553296baa57d871c6f99976e480f3f67c60cb1afc6fda396816a4a3c4f263e3ceb588ebb64f9ce2070a53cbf1ecf03ba14c0b90d9f0ef48773786715ea3c04e2

data/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 0.3.0 (2026-06-05)
+
+Full Changelog: [v0.2.0...v0.3.0](https://github.com/cadenya/cadenya-ruby/compare/v0.2.0...v0.3.0)
+
+### Features
+
+* Add admin profile search (workspaceAdmin.profiles.list) — ENG-308 ([1e4797b](https://github.com/cadenya/cadenya-ruby/commit/1e4797be9bef5f7382270eb22d4e7ee1cea5a317))
+* **api:** api update ([8721ef8](https://github.com/cadenya/cadenya-ruby/commit/8721ef8a408a83e13ef49da9f8257027da9fa69d))
+* **api:** api update ([e4f7e6e](https://github.com/cadenya/cadenya-ruby/commit/e4f7e6e38b74ecb01be4e006d24ce5878343d481))
+* **api:** api update ([ca33f81](https://github.com/cadenya/cadenya-ruby/commit/ca33f814f4b7dbcdff61c64165a15742c1e281d0))
+* **api:** api update ([e7a5a6d](https://github.com/cadenya/cadenya-ruby/commit/e7a5a6de7e7a9c4f9310e5feff50cc1a733103f1))
+* **api:** api update ([98b0521](https://github.com/cadenya/cadenya-ruby/commit/98b0521380484243a201a4c0c2779808d4a2acad))
+* **api:** api update ([f2e807e](https://github.com/cadenya/cadenya-ruby/commit/f2e807e762dc8d0e4b2dfcd4cf16ff5161ef3003))
+* **api:** api update ([c2c28b1](https://github.com/cadenya/cadenya-ruby/commit/c2c28b16acff45120a9568952a812341502329fc))
+* **api:** api update ([0cb5f64](https://github.com/cadenya/cadenya-ruby/commit/0cb5f6447508b9fa8ed4ca297bc5181955f50c90))
+* **api:** api update ([2975430](https://github.com/cadenya/cadenya-ruby/commit/29754304ee42e35d1c3d38bd02bca0cf45271a16))
+
+## 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.3.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/cadenya/client.rb

@@ -73,9 +73,22 @@ module Cadenya
 
     # Manage workspaces within an account. Workspaces provide organizational grouping
     # and isolation for resources such as agents, tools, and API keys.
+    #
+    # This is the workspace-scoped, end-user surface. Administrative operations
+    # (create / archive workspaces, manage members) live in WorkspaceAdminService
+    # under /v1/account/workspaces and require the admin role.
     # @return [Cadenya::Resources::Workspaces]
     attr_reader :workspaces
 
+    # Administer workspaces across the account: create and archive workspaces and
+    # manage their membership. These operations are account-scoped and require the
+    # admin role (a token whose profile holds the WorkOS admin role); they live under
+    # /v1/account/workspaces rather than the workspace-scoped /v1/workspaces tree so
+    # an admin can manage any workspace in the account, including ones they are not
+    # themselves a member of.
+    # @return [Cadenya::Resources::WorkspaceAdmin]
+    attr_reader :workspace_admin
+
     # @return [Cadenya::Resources::Webhooks]
     attr_reader :webhooks
 
@@ -161,6 +174,7 @@ module Cadenya
       @api_keys = Cadenya::Resources::APIKeys.new(client: self)
       @workspace_secrets = Cadenya::Resources::WorkspaceSecrets.new(client: self)
       @workspaces = Cadenya::Resources::Workspaces.new(client: self)
+      @workspace_admin = Cadenya::Resources::WorkspaceAdmin.new(client: self)
       @webhooks = Cadenya::Resources::Webhooks.new(client: self)
       @bulk_workspace_resources = Cadenya::Resources::BulkWorkspaceResources.new(client: self)
     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/agent_spec.rb

@@ -31,8 +31,21 @@ module Cadenya
       #   is used as the tool's input parameter schema. If omitted, the sub-agent schema
       #   will be loaded with a simple "prompt" free text string as its schema.
       #
-      #   @return [Object, nil]
-      optional :input_data_schema, Cadenya::Internal::Type::Unknown, api_name: :inputDataSchema
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :input_data_schema,
+               Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown],
+               api_name: :inputDataSchema
+
+      # @!attribute output_definition
+      #   Optional output definition for objectives created for this agent. When provided,
+      #   Cadenya will append a tool to that will be called by the LLM in use by the
+      #   variant to extract information in the format provided here. Use this option when
+      #   you want structured data to be created by your objectives.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :output_definition,
+               Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown],
+               api_name: :outputDefinition
 
       # @!attribute webhook_events_url
       #   The URL that Cadenya will send events for any objective assigned to the agent.
@@ -40,7 +53,7 @@ module Cadenya
       #   @return [String, nil]
       optional :webhook_events_url, String, api_name: :webhookEventsUrl
 
-      # @!method initialize(status:, variation_selection_mode:, description: nil, input_data_schema: nil, webhook_events_url: nil)
+      # @!method initialize(status:, variation_selection_mode:, description: nil, input_data_schema: nil, output_definition: nil, webhook_events_url: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::AgentSpec} for more details.
       #
@@ -52,7 +65,9 @@ module Cadenya
       #
       #   @param description [String] Description of the agent's purpose
       #
-      #   @param input_data_schema [Object] InputDataSchema is used for enforcing a data input when objectives are created.
+      #   @param input_data_schema [Hash{Symbol=>Object}] InputDataSchema is used for enforcing a data input when objectives are created.
+      #
+      #   @param output_definition [Hash{Symbol=>Object}] Optional output definition for objectives created for this agent.
       #
       #   @param webhook_events_url [String] The URL that Cadenya will send events for any objective assigned to the agent.
 

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,9 @@ 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
+          OBJECTIVE_EVENT_TYPE_FINALIZED = :OBJECTIVE_EVENT_TYPE_FINALIZED
 
           # @!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,9 @@ 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
+          OBJECTIVE_EVENT_TYPE_FINALIZED = :OBJECTIVE_EVENT_TYPE_FINALIZED
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/cadenya/models/approval_requirement_filter.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ApprovalRequirementFilter < Cadenya::Internal::Type::BaseModel
+      # @!attribute always
+      #
+      #   @return [Boolean, nil]
+      optional :always, Cadenya::Internal::Type::Boolean
+
+      # @!attribute only
+      #   Top-level filter with simple boolean logic (no nesting)
+      #
+      #   @return [Cadenya::Models::ToolFilter, nil]
+      optional :only, -> { Cadenya::ToolFilter }
+
+      # @!method initialize(always: nil, only: nil)
+      #   Approval filters that will automatically set the approval requirement on tools
+      #   synced from an external source
+      #
+      #   @param always [Boolean]
+      #
+      #   @param only [Cadenya::Models::ToolFilter] Top-level filter with simple boolean logic (no nesting)
+    end
+  end
+end

data/lib/cadenya/models/attribute_filter.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class AttributeFilter < Cadenya::Internal::Type::BaseModel
+      # @!attribute attribute
+      #
+      #   @return [Symbol, Cadenya::Models::AttributeFilter::Attribute]
+      required :attribute, enum: -> { Cadenya::AttributeFilter::Attribute }
+
+      # @!attribute matcher
+      #   String matching operations
+      #
+      #   @return [Cadenya::Models::StringMatcher, nil]
+      optional :matcher, -> { Cadenya::StringMatcher }
+
+      # @!method initialize(attribute:, matcher: nil)
+      #   Single attribute filter
+      #
+      #   @param attribute [Symbol, Cadenya::Models::AttributeFilter::Attribute]
+      #
+      #   @param matcher [Cadenya::Models::StringMatcher] String matching operations
+
+      # @see Cadenya::Models::AttributeFilter#attribute
+      module Attribute
+        extend Cadenya::Internal::Type::Enum
+
+        ATTRIBUTE_UNSPECIFIED = :ATTRIBUTE_UNSPECIFIED
+        ATTRIBUTE_NAME = :ATTRIBUTE_NAME
+        ATTRIBUTE_TITLE = :ATTRIBUTE_TITLE
+        ATTRIBUTE_DESCRIPTION = :ATTRIBUTE_DESCRIPTION
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

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_data.rb

@@ -53,6 +53,22 @@ module Cadenya
         #   @return [Cadenya::Models::Agent, nil]
         optional :agent, -> { Cadenya::Agent }
 
+        # @!attribute output
+        #   The output of the objective, populated when the objective completes. Will match
+        #   the schema of output_json_schema or output_json_inferred.
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :output, Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown]
+
+        # @!attribute output_definition
+        #   Snapshot of the agent spec's output_definition at objective creation time. When
+        #   present, the objective will run an extraction step after the LLM finishes.
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :output_definition,
+                 Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown],
+                 api_name: :outputDefinition
+
         # @!attribute parent_objective_id
         #   A parent objective means the objective was spawned off using a separate agent to
         #   complete an objective
@@ -81,7 +97,7 @@ module Cadenya
         optional :variation, -> { Cadenya::Agents::AgentVariation }
       end
 
-      # @!method initialize(agent: nil, data: nil, initial_message: nil, memory_stack: nil, parent_objective_id: nil, secrets: nil, source_schedule_id: nil, system_prompt: nil, variation: nil)
+      # @!method initialize(agent: nil, data: nil, initial_message: nil, memory_stack: nil, output: nil, output_definition: nil, parent_objective_id: nil, secrets: nil, source_schedule_id: nil, system_prompt: nil, variation: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ObjectiveData} for more details.
       #
@@ -93,6 +109,10 @@ module Cadenya
       #
       #   @param memory_stack [Array<Cadenya::Models::MemoryReference>] Memory layers/entries to push onto this objective's memory stack on
       #
+      #   @param output [Hash{Symbol=>Object}] The output of the objective, populated when the objective completes. Will match
+      #
+      #   @param output_definition [Hash{Symbol=>Object}] Snapshot of the agent spec's output_definition at objective creation time.
+      #
       #   @param parent_objective_id [String] A parent objective means the objective was spawned off using a separate agent to
       #
       #   @param secrets [Array<Cadenya::Models::ObjectiveDataSecret>] Secrets that can be used in the headers for tool calls using the secret interpol

data/lib/cadenya/models/objective_event_data.rb

@@ -28,6 +28,14 @@ module Cadenya
       #   @return [Cadenya::Models::ObjectiveError, nil]
       optional :error, -> { Cadenya::ObjectiveError }
 
+      # @!attribute finalized
+      #   ObjectiveFinalized is the terminal event written when an objective is finalized.
+      #   After this event, the objective is super-terminal: no further iterations,
+      #   compaction, or continuation are permitted.
+      #
+      #   @return [Cadenya::Models::ObjectiveEventData::Finalized, nil]
+      optional :finalized, -> { Cadenya::ObjectiveEventData::Finalized }
+
       # @!attribute memory_read
       #   MemoryRead is emitted each time the agent resolves a key against the memory
       #   stack and loads an entry. Lookups that miss (key not found in any layer) do not
@@ -36,10 +44,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 +98,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, finalized: 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.
       #
@@ -97,9 +110,13 @@ module Cadenya
       #
       #   @param error [Cadenya::Models::ObjectiveError]
       #
+      #   @param finalized [Cadenya::Models::ObjectiveEventData::Finalized] ObjectiveFinalized is the terminal event written when an objective is
+      #
       #   @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]
       #
@@ -137,6 +154,27 @@ module Cadenya
         #
         #   @param message [String] Optional human-readable note recorded at cancel time. Today the workflow
       end
+
+      # @see Cadenya::Models::ObjectiveEventData#finalized
+      class Finalized < Cadenya::Internal::Type::BaseModel
+        # @!attribute output
+        #   If the objective was created with an output schema, and the agent successfully
+        #   completed the objective, this field will contain the structured output of the
+        #   objective.
+        #
+        #   @return [Object, nil]
+        optional :output, Cadenya::Internal::Type::Unknown
+
+        # @!method initialize(output: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ObjectiveEventData::Finalized} for more details.
+        #
+        #   ObjectiveFinalized is the terminal event written when an objective is finalized.
+        #   After this event, the objective is super-terminal: no further iterations,
+        #   compaction, or continuation are permitted.
+        #
+        #   @param output [Object] If the objective was created with an output schema, and the agent
+      end
     end
   end
 end

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/objective_list_params.rb

@@ -99,9 +99,10 @@ module Cadenya
         STATE_UNSPECIFIED = :STATE_UNSPECIFIED
         STATE_PENDING = :STATE_PENDING
         STATE_RUNNING = :STATE_RUNNING
-        STATE_COMPLETED = :STATE_COMPLETED
+        STATE_WAITING = :STATE_WAITING
         STATE_FAILED = :STATE_FAILED
         STATE_CANCELLED = :STATE_CANCELLED
+        STATE_FINALIZED = :STATE_FINALIZED
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/cadenya/models/objective_status.rb

@@ -24,9 +24,10 @@ module Cadenya
         STATE_UNSPECIFIED = :STATE_UNSPECIFIED
         STATE_PENDING = :STATE_PENDING
         STATE_RUNNING = :STATE_RUNNING
-        STATE_COMPLETED = :STATE_COMPLETED
+        STATE_WAITING = :STATE_WAITING
         STATE_FAILED = :STATE_FAILED
         STATE_CANCELLED = :STATE_CANCELLED
+        STATE_FINALIZED = :STATE_FINALIZED
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/cadenya/models/profile_spec.rb

@@ -40,6 +40,7 @@ module Cadenya
       module Type
         extend Cadenya::Internal::Type::Enum
 
+        PROFILE_TYPE_UNSPECIFIED = :PROFILE_TYPE_UNSPECIFIED
         PROFILE_TYPE_USER = :PROFILE_TYPE_USER
         PROFILE_TYPE_API_KEY = :PROFILE_TYPE_API_KEY
         PROFILE_TYPE_SYSTEM = :PROFILE_TYPE_SYSTEM

data/lib/cadenya/models/string_matcher.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class StringMatcher < Cadenya::Internal::Type::BaseModel
+      # @!attribute case_sensitive
+      #
+      #   @return [Boolean, nil]
+      optional :case_sensitive, Cadenya::Internal::Type::Boolean, api_name: :caseSensitive
+
+      # @!attribute contains
+      #
+      #   @return [String, nil]
+      optional :contains, String
+
+      # @!attribute ends_with
+      #
+      #   @return [String, nil]
+      optional :ends_with, String, api_name: :endsWith
+
+      # @!attribute exact
+      #
+      #   @return [String, nil]
+      optional :exact, String
+
+      # @!attribute regex
+      #
+      #   @return [String, nil]
+      optional :regex, String
+
+      # @!attribute starts_with
+      #
+      #   @return [String, nil]
+      optional :starts_with, String, api_name: :startsWith
+
+      # @!method initialize(case_sensitive: nil, contains: nil, ends_with: nil, exact: nil, regex: nil, starts_with: nil)
+      #   String matching operations
+      #
+      #   @param case_sensitive [Boolean]
+      #   @param contains [String]
+      #   @param ends_with [String]
+      #   @param exact [String]
+      #   @param regex [String]
+      #   @param starts_with [String]
+    end
+  end
+end

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