cadenya 0.1.0 → 0.3.0

data/lib/cadenya.rb

@@ -120,8 +120,10 @@ require_relative "cadenya/models/api_keys/access_list_params"
 require_relative "cadenya/models/api_keys/access_remove_params"
 require_relative "cadenya/models/api_key_spec"
 require_relative "cadenya/models/api_key_update_params"
+require_relative "cadenya/models/approval_requirement_filter"
 require_relative "cadenya/models/assistant_message"
 require_relative "cadenya/models/assistant_tool_call"
+require_relative "cadenya/models/attribute_filter"
 require_relative "cadenya/models/bare_metadata"
 require_relative "cadenya/models/bulk_workspace_apply"
 require_relative "cadenya/models/bulk_workspace_apply_data"
@@ -146,7 +148,6 @@ require_relative "cadenya/models/callable_tool"
 require_relative "cadenya/models/context_window_compacted"
 require_relative "cadenya/models/create_operation_metadata"
 require_relative "cadenya/models/create_resource_metadata"
-require_relative "cadenya/models/mcp_tool_filter"
 require_relative "cadenya/models/memory_entry_item"
 require_relative "cadenya/models/memory_layer"
 require_relative "cadenya/models/memory_layer_create_params"
@@ -222,7 +223,9 @@ 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/string_matcher"
+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"
@@ -232,22 +235,27 @@ require_relative "cadenya/models/tool_called"
 require_relative "cadenya/models/tool_denied"
 require_relative "cadenya/models/tool_entry"
 require_relative "cadenya/models/tool_error"
+require_relative "cadenya/models/tool_filter"
 require_relative "cadenya/models/tool_result"
 require_relative "cadenya/models/tool_set"
 require_relative "cadenya/models/tool_set_adapter"
 require_relative "cadenya/models/tool_set_adapter_http"
 require_relative "cadenya/models/tool_set_adapter_mcp"
+require_relative "cadenya/models/tool_set_adapter_openapi"
 require_relative "cadenya/models/tool_set_create_params"
 require_relative "cadenya/models/tool_set_delete_params"
 require_relative "cadenya/models/tool_set_entry"
 require_relative "cadenya/models/tool_set_event"
 require_relative "cadenya/models/tool_set_event_data"
+require_relative "cadenya/models/tool_set_get_openapi_spec_params"
+require_relative "cadenya/models/tool_set_get_openapi_spec_response"
 require_relative "cadenya/models/tool_set_info"
 require_relative "cadenya/models/tool_set_list_events_params"
 require_relative "cadenya/models/tool_set_list_params"
 require_relative "cadenya/models/tool_set_retrieve_params"
 require_relative "cadenya/models/tool_sets/config_http"
 require_relative "cadenya/models/tool_sets/config_mcp"
+require_relative "cadenya/models/tool_sets/config_openapi"
 require_relative "cadenya/models/tool_sets/tool"
 require_relative "cadenya/models/tool_sets/tool_create_params"
 require_relative "cadenya/models/tool_sets/tool_delete_params"
@@ -273,8 +281,18 @@ require_relative "cadenya/models/variation_memory_layer_entry"
 require_relative "cadenya/models/webhook_unsafe_unwrap_params"
 require_relative "cadenya/models/webhook_unwrap_params"
 require_relative "cadenya/models/workspace"
+require_relative "cadenya/models/workspace_admin/member_add_params"
+require_relative "cadenya/models/workspace_admin/member_list_params"
+require_relative "cadenya/models/workspace_admin/member_remove_params"
+require_relative "cadenya/models/workspace_admin/profile_list_params"
+require_relative "cadenya/models/workspace_admin_archive_params"
+require_relative "cadenya/models/workspace_admin_create_params"
+require_relative "cadenya/models/workspace_admin_list_params"
+require_relative "cadenya/models/workspace_admin_retrieve_params"
+require_relative "cadenya/models/workspace_admin_update_params"
 require_relative "cadenya/models/workspace_get_params"
 require_relative "cadenya/models/workspace_list_params"
+require_relative "cadenya/models/workspace_member"
 require_relative "cadenya/models/workspace_secret"
 require_relative "cadenya/models/workspace_secret_create_params"
 require_relative "cadenya/models/workspace_secret_delete_params"
@@ -308,5 +326,8 @@ require_relative "cadenya/resources/tool_sets"
 require_relative "cadenya/resources/tool_sets/tools"
 require_relative "cadenya/resources/uploads"
 require_relative "cadenya/resources/webhooks"
+require_relative "cadenya/resources/workspace_admin"
+require_relative "cadenya/resources/workspace_admin/members"
+require_relative "cadenya/resources/workspace_admin/profiles"
 require_relative "cadenya/resources/workspaces"
 require_relative "cadenya/resources/workspace_secrets"

data/rbi/cadenya/client.rbi

@@ -68,9 +68,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.
     sig { returns(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.
+    sig { returns(Cadenya::Resources::WorkspaceAdmin) }
+    attr_reader :workspace_admin
+
     sig { returns(Cadenya::Resources::Webhooks) }
     attr_reader :webhooks
 

data/rbi/cadenya/models/agent_spec.rbi

@@ -27,12 +27,22 @@ module Cadenya
       # data schema is also valuable when using an agent as a sub-agent, as the schema
       # 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.
-      sig { returns(T.nilable(T.anything)) }
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
       attr_reader :input_data_schema
 
-      sig { params(input_data_schema: T.anything).void }
+      sig { params(input_data_schema: T::Hash[Symbol, T.anything]).void }
       attr_writer :input_data_schema
 
+      # 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.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_reader :output_definition
+
+      sig { params(output_definition: T::Hash[Symbol, T.anything]).void }
+      attr_writer :output_definition
+
       # The URL that Cadenya will send events for any objective assigned to the agent.
       sig { returns(T.nilable(String)) }
       attr_reader :webhook_events_url
@@ -47,7 +57,8 @@ module Cadenya
           variation_selection_mode:
             Cadenya::AgentSpec::VariationSelectionMode::OrSymbol,
           description: String,
-          input_data_schema: T.anything,
+          input_data_schema: T::Hash[Symbol, T.anything],
+          output_definition: T::Hash[Symbol, T.anything],
           webhook_events_url: String
         ).returns(T.attached_class)
       end
@@ -65,6 +76,11 @@ 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.
         input_data_schema: nil,
+        # 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.
+        output_definition: nil,
         # The URL that Cadenya will send events for any objective assigned to the agent.
         webhook_events_url: nil
       )
@@ -77,7 +93,8 @@ module Cadenya
             variation_selection_mode:
               Cadenya::AgentSpec::VariationSelectionMode::OrSymbol,
             description: String,
-            input_data_schema: T.anything,
+            input_data_schema: T::Hash[Symbol, T.anything],
+            output_definition: T::Hash[Symbol, T.anything],
             webhook_events_url: String
           }
         )

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,21 @@ 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
+            )
+          OBJECTIVE_EVENT_TYPE_FINALIZED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_FINALIZED,
+              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,21 @@ 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
+            )
+          OBJECTIVE_EVENT_TYPE_FINALIZED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_FINALIZED,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/cadenya/models/approval_requirement_filter.rbi

@@ -0,0 +1,45 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class ApprovalRequirementFilter < Cadenya::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::ApprovalRequirementFilter, Cadenya::Internal::AnyHash)
+        end
+
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :always
+
+      sig { params(always: T::Boolean).void }
+      attr_writer :always
+
+      # Top-level filter with simple boolean logic (no nesting)
+      sig { returns(T.nilable(Cadenya::ToolFilter)) }
+      attr_reader :only
+
+      sig { params(only: Cadenya::ToolFilter::OrHash).void }
+      attr_writer :only
+
+      # Approval filters that will automatically set the approval requirement on tools
+      # synced from an external source
+      sig do
+        params(always: T::Boolean, only: Cadenya::ToolFilter::OrHash).returns(
+          T.attached_class
+        )
+      end
+      def self.new(
+        always: nil,
+        # Top-level filter with simple boolean logic (no nesting)
+        only: nil
+      )
+      end
+
+      sig do
+        override.returns({ always: T::Boolean, only: Cadenya::ToolFilter })
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/attribute_filter.rbi

@@ -0,0 +1,84 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class AttributeFilter < Cadenya::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::AttributeFilter, Cadenya::Internal::AnyHash)
+        end
+
+      sig { returns(Cadenya::AttributeFilter::Attribute::OrSymbol) }
+      attr_accessor :attribute
+
+      # String matching operations
+      sig { returns(T.nilable(Cadenya::StringMatcher)) }
+      attr_reader :matcher
+
+      sig { params(matcher: Cadenya::StringMatcher::OrHash).void }
+      attr_writer :matcher
+
+      # Single attribute filter
+      sig do
+        params(
+          attribute: Cadenya::AttributeFilter::Attribute::OrSymbol,
+          matcher: Cadenya::StringMatcher::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        attribute:,
+        # String matching operations
+        matcher: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            attribute: Cadenya::AttributeFilter::Attribute::OrSymbol,
+            matcher: Cadenya::StringMatcher
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module Attribute
+        extend Cadenya::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Cadenya::AttributeFilter::Attribute) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ATTRIBUTE_UNSPECIFIED =
+          T.let(
+            :ATTRIBUTE_UNSPECIFIED,
+            Cadenya::AttributeFilter::Attribute::TaggedSymbol
+          )
+        ATTRIBUTE_NAME =
+          T.let(
+            :ATTRIBUTE_NAME,
+            Cadenya::AttributeFilter::Attribute::TaggedSymbol
+          )
+        ATTRIBUTE_TITLE =
+          T.let(
+            :ATTRIBUTE_TITLE,
+            Cadenya::AttributeFilter::Attribute::TaggedSymbol
+          )
+        ATTRIBUTE_DESCRIPTION =
+          T.let(
+            :ATTRIBUTE_DESCRIPTION,
+            Cadenya::AttributeFilter::Attribute::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Cadenya::AttributeFilter::Attribute::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

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

@@ -64,6 +64,22 @@ module Cadenya
       sig { params(agent: Cadenya::Agent::OrHash).void }
       attr_writer :agent
 
+      # The output of the objective, populated when the objective completes. Will match
+      # the schema of output_json_schema or output_json_inferred.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_reader :output
+
+      sig { params(output: T::Hash[Symbol, T.anything]).void }
+      attr_writer :output
+
+      # 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.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_reader :output_definition
+
+      sig { params(output_definition: T::Hash[Symbol, T.anything]).void }
+      attr_writer :output_definition
+
       # A parent objective means the objective was spawned off using a separate agent to
       # complete an objective
       sig { returns(T.nilable(String)) }
@@ -101,6 +117,8 @@ module Cadenya
           data: T.anything,
           initial_message: String,
           memory_stack: T::Array[Cadenya::MemoryReference::OrHash],
+          output: T::Hash[Symbol, T.anything],
+          output_definition: T::Hash[Symbol, T.anything],
           parent_objective_id: String,
           secrets: T::Array[Cadenya::ObjectiveDataSecret::OrHash],
           source_schedule_id: String,
@@ -133,6 +151,12 @@ module Cadenya
         # - this field) must not exceed 10 entries. A request that would produce an
         #   effective stack larger than 10 is rejected with InvalidArgument.
         memory_stack: nil,
+        # The output of the objective, populated when the objective completes. Will match
+        # the schema of output_json_schema or output_json_inferred.
+        output: nil,
+        # 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.
+        output_definition: nil,
         # A parent objective means the objective was spawned off using a separate agent to
         # complete an objective
         parent_objective_id: nil,
@@ -157,6 +181,8 @@ module Cadenya
             data: T.anything,
             initial_message: String,
             memory_stack: T::Array[Cadenya::MemoryReference],
+            output: T::Hash[Symbol, T.anything],
+            output_definition: T::Hash[Symbol, T.anything],
             parent_objective_id: String,
             secrets: T::Array[Cadenya::ObjectiveDataSecret],
             source_schedule_id: String,

data/rbi/cadenya/models/objective_event_data.rbi

@@ -41,6 +41,17 @@ module Cadenya
       sig { params(error: Cadenya::ObjectiveError::OrHash).void }
       attr_writer :error
 
+      # 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.
+      sig { returns(T.nilable(Cadenya::ObjectiveEventData::Finalized)) }
+      attr_reader :finalized
+
+      sig do
+        params(finalized: Cadenya::ObjectiveEventData::Finalized::OrHash).void
+      end
+      attr_writer :finalized
+
       # 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
       # emit this event.
@@ -50,13 +61,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
@@ -116,8 +131,10 @@ module Cadenya
           cancelled: Cadenya::ObjectiveEventData::Cancelled::OrHash,
           context_window_compacted: Cadenya::ContextWindowCompacted::OrHash,
           error: Cadenya::ObjectiveError::OrHash,
+          finalized: Cadenya::ObjectiveEventData::Finalized::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,
@@ -136,11 +153,16 @@ module Cadenya
         cancelled: nil,
         context_window_compacted: nil,
         error: nil,
+        # 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.
+        finalized: nil,
         # 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
         # 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,
@@ -159,8 +181,10 @@ module Cadenya
             cancelled: Cadenya::ObjectiveEventData::Cancelled,
             context_window_compacted: Cadenya::ContextWindowCompacted,
             error: Cadenya::ObjectiveError,
+            finalized: Cadenya::ObjectiveEventData::Finalized,
             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,
@@ -209,6 +233,41 @@ module Cadenya
         def to_hash
         end
       end
+
+      class Finalized < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::ObjectiveEventData::Finalized,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # 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.
+        sig { returns(T.nilable(T.anything)) }
+        attr_reader :output
+
+        sig { params(output: T.anything).void }
+        attr_writer :output
+
+        # 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.
+        sig { params(output: T.anything).returns(T.attached_class) }
+        def self.new(
+          # 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.
+          output: nil
+        )
+        end
+
+        sig { override.returns({ output: T.anything }) }
+        def to_hash
+        end
+      end
     end
   end
 end

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

@@ -159,9 +159,9 @@ module Cadenya
             :STATE_RUNNING,
             Cadenya::ObjectiveListParams::State::TaggedSymbol
           )
-        STATE_COMPLETED =
+        STATE_WAITING =
           T.let(
-            :STATE_COMPLETED,
+            :STATE_WAITING,
             Cadenya::ObjectiveListParams::State::TaggedSymbol
           )
         STATE_FAILED =
@@ -174,6 +174,11 @@ module Cadenya
             :STATE_CANCELLED,
             Cadenya::ObjectiveListParams::State::TaggedSymbol
           )
+        STATE_FINALIZED =
+          T.let(
+            :STATE_FINALIZED,
+            Cadenya::ObjectiveListParams::State::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/cadenya/models/objective_status.rbi

@@ -53,12 +53,14 @@ module Cadenya
           T.let(:STATE_PENDING, Cadenya::ObjectiveStatus::State::TaggedSymbol)
         STATE_RUNNING =
           T.let(:STATE_RUNNING, Cadenya::ObjectiveStatus::State::TaggedSymbol)
-        STATE_COMPLETED =
-          T.let(:STATE_COMPLETED, Cadenya::ObjectiveStatus::State::TaggedSymbol)
+        STATE_WAITING =
+          T.let(:STATE_WAITING, Cadenya::ObjectiveStatus::State::TaggedSymbol)
         STATE_FAILED =
           T.let(:STATE_FAILED, Cadenya::ObjectiveStatus::State::TaggedSymbol)
         STATE_CANCELLED =
           T.let(:STATE_CANCELLED, Cadenya::ObjectiveStatus::State::TaggedSymbol)
+        STATE_FINALIZED =
+          T.let(:STATE_FINALIZED, Cadenya::ObjectiveStatus::State::TaggedSymbol)
 
         sig do
           override.returns(

data/rbi/cadenya/models/profile_spec.rbi

@@ -64,6 +64,11 @@ module Cadenya
           T.type_alias { T.all(Symbol, Cadenya::ProfileSpec::Type) }
         OrSymbol = T.type_alias { T.any(Symbol, String) }
 
+        PROFILE_TYPE_UNSPECIFIED =
+          T.let(
+            :PROFILE_TYPE_UNSPECIFIED,
+            Cadenya::ProfileSpec::Type::TaggedSymbol
+          )
         PROFILE_TYPE_USER =
           T.let(:PROFILE_TYPE_USER, Cadenya::ProfileSpec::Type::TaggedSymbol)
         PROFILE_TYPE_API_KEY =