cadenya 0.50.0 → 0.51.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d99a2c43428a1e5c801241eee6987fe357872a81f4efee9ad4851071d5d4057e
-  data.tar.gz: 7744729bb14d0c6faada1df94ba0f5bcbd5d7ff3799006a8d8130e246433ea8b
+  metadata.gz: b7720d802ad10daa44db4b332ec4dc695d3bf0cbda5635fe181b3e73582cb122
+  data.tar.gz: 87eb98bbac943e0ce28df27d9b3c3d36463726f0867db6d7ee656b33fcb91294
 SHA512:
-  metadata.gz: d23c2109a9290c7bf888db04ffe5b9e08ad583c040afe30164b38aea7372e77b44b7f2727ba6487a4f576f13b598e84486b8f0043f9b503b445866da3d81999c
-  data.tar.gz: ebfa57aefa3325012ed9e23ef68c5de53146983e421963baae317831dc0f6d782c946ce0f7319523764fb2337acae93b7a3a70e2c19b3c63dbac4b0ef005a93d
+  metadata.gz: 077d3323962c15cce7a371c8488bc459f94854f0751b078fa1caa78d803a575baadadf583bf59747aa17591a5f81842316939471aaec1a60ec519492a4223723
+  data.tar.gz: c461bbb91bd8f4a7bd03c385e7fc3adb6a8f132ae1266b5ce03b4cdb7e6b458e1564d92900fe0f018c5ddb5c7b0d0993d2465ab62569340e5ab8ac69deeec141

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.51.0 (2026-08-05)
+
+Full Changelog: [v0.50.0...v0.51.0](https://github.com/cadenya/cadenya-ruby/compare/v0.50.0...v0.51.0)
+
+### Features
+
+* **api:** api update ([f38375e](https://github.com/cadenya/cadenya-ruby/commit/f38375e25291fabd524b2ce91a711a6710024adb))
+* **api:** api update ([e47a68b](https://github.com/cadenya/cadenya-ruby/commit/e47a68bd7daa9aa2b556bb440d5506e3036ba77b))
+* **api:** api update ([ddfe08d](https://github.com/cadenya/cadenya-ruby/commit/ddfe08d1f138ed8da6555fc03e2edbfb561c5835))
+* **api:** api update ([5c8fa0d](https://github.com/cadenya/cadenya-ruby/commit/5c8fa0d83455ec315b97c6b67cea81c38015b326))
+
 ## 0.50.0 (2026-07-22)
 
 Full Changelog: [v0.49.0...v0.50.0](https://github.com/cadenya/cadenya-ruby/compare/v0.49.0...v0.50.0)

data/README.md

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

data/lib/cadenya/client.rb

@@ -112,6 +112,26 @@ module Cadenya
     # @return [Cadenya::Resources::Webhooks]
     attr_reader :webhooks
 
+    # Manage embeddable chat widgets. A widget binds an agent to a globally unique
+    # hostname with a per-widget origin allowlist; browsers reach it with session
+    # tokens minted via WidgetSessionService.
+    # @return [Cadenya::Resources::Widgets]
+    attr_reader :widgets
+
+    # Read and erase tenants and the subjects under them. Tenants and subjects are
+    # created by assertion — on objective creation or widget session mint — never
+    # directly, so this service has no create or update: it exists to enumerate what
+    # assertions have produced, and to destroy it on request.
+    # @return [Cadenya::Resources::Tenants]
+    attr_reader :tenants
+
+    # Mint and manage widget sessions. Session creation is server-to-server only: the
+    # customer's backend authenticates its visitor, asserts tenant/subject context,
+    # attaches any per-visitor secrets, and receives a short-lived bearer token the
+    # browser uses against the widget host.
+    # @return [Cadenya::Resources::WidgetSessions]
+    attr_reader :widget_sessions
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -199,6 +219,9 @@ module Cadenya
       @workspaces = Cadenya::Resources::Workspaces.new(client: self)
       @workspace_admin = Cadenya::Resources::WorkspaceAdmin.new(client: self)
       @webhooks = Cadenya::Resources::Webhooks.new(client: self)
+      @widgets = Cadenya::Resources::Widgets.new(client: self)
+      @tenants = Cadenya::Resources::Tenants.new(client: self)
+      @widget_sessions = Cadenya::Resources::WidgetSessions.new(client: self)
     end
   end
 end

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

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

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

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

data/lib/cadenya/models/api_key_spec.rb

@@ -13,10 +13,11 @@ module Cadenya
       #   Scopes granted to this key. Each entry is a colon-separated resource:verb string
       #   (e.g. "objectives:manage").
       #
-      #   Resources: agents, objectives, tools, memory, api_keys, workspaces, secrets,
-      #   account. Verbs: read and manage, where manage implies read — a stored scope set
-      #   is normalized to drop "x:read" when "x:manage" is present. The secrets and
-      #   account resources support only manage. "\*" is an explicit full-access grant.
+      #   Resources: agents, objectives, tools, memory, api_keys, workspaces, widgets,
+      #   widget_sessions, secrets, account. Verbs: read and manage, where manage implies
+      #   read — a stored scope set is normalized to drop "x:read" when "x:manage" is
+      #   present. The secrets and account resources support only manage. "\*" is an
+      #   explicit full-access grant.
       #
       #   Scopes are deny-by-default: a key with an empty list can call only scope-free
       #   endpoints. Full access is always an explicit "\*" grant.

data/lib/cadenya/models/model_spec.rb

@@ -39,7 +39,17 @@ module Cadenya
       #   @return [String, nil]
       optional :output_price_per_million_tokens, String, api_name: :outputPricePerMillionTokens
 
-      # @!method initialize(family:, provider:, input_price_per_million_tokens: nil, max_input_tokens: nil, max_output_tokens: nil, output_price_per_million_tokens: nil)
+      # @!attribute reasoning
+      #   The model's reasoning capability. Catalog data used to decide whether thinking
+      #   is requested for objective iterations on this model.
+      #
+      #   @return [Symbol, Cadenya::Models::ModelSpec::Reasoning, nil]
+      optional :reasoning, enum: -> { Cadenya::ModelSpec::Reasoning }
+
+      # @!method initialize(family:, provider:, input_price_per_million_tokens: nil, max_input_tokens: nil, max_output_tokens: nil, output_price_per_million_tokens: nil, reasoning: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ModelSpec} for more details.
+      #
       #   @param family [String] The model family (e.g., "claude-sonnet-4.6", "gpt-5.4", "gemini-2.5-flash")
       #
       #   @param provider [String] The model provider (e.g., "anthropic", "openai", "google")
@@ -51,6 +61,24 @@ module Cadenya
       #   @param max_output_tokens [Integer] Maximum number of output tokens the model can generate
       #
       #   @param output_price_per_million_tokens [String] Cost per million output tokens in cents (e.g., 1500 = $15.00)
+      #
+      #   @param reasoning [Symbol, Cadenya::Models::ModelSpec::Reasoning] The model's reasoning capability. Catalog data used to decide whether
+
+      # The model's reasoning capability. Catalog data used to decide whether thinking
+      # is requested for objective iterations on this model.
+      #
+      # @see Cadenya::Models::ModelSpec#reasoning
+      module Reasoning
+        extend Cadenya::Internal::Type::Enum
+
+        REASONING_UNSPECIFIED = :REASONING_UNSPECIFIED
+        REASONING_NONE = :REASONING_NONE
+        REASONING_ADAPTIVE = :REASONING_ADAPTIVE
+        REASONING_BUDGET = :REASONING_BUDGET
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/cadenya/models/objective.rb

@@ -101,6 +101,13 @@ module Cadenya
         #   @return [String, nil]
         optional :parent_objective_id, String, api_name: :parentObjectiveId
 
+        # @!attribute pinned_parameters
+        #   Parameters forced onto this objective's tool calls, as provided at creation. See
+        #   CreateObjectiveRequest.pinned_parameters for semantics.
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :pinned_parameters, Cadenya::Internal::Type::HashOf[String], api_name: :pinnedParameters
+
         # @!attribute state_message
         #   Optional human-readable detail about the current state (e.g. a failure reason).
         #
@@ -116,7 +123,7 @@ module Cadenya
                  api_name: :systemPromptData
       end
 
-      # @!method initialize(config_snapshot:, first_user_message:, metadata:, state:, system_prompt:, episodic_memory: nil, first_user_message_data: nil, info: nil, memory_cascade: nil, output: nil, parent_objective_id: nil, secrets: nil, state_message: nil, system_prompt_data: nil)
+      # @!method initialize(config_snapshot:, first_user_message:, metadata:, state:, system_prompt:, episodic_memory: nil, first_user_message_data: nil, info: nil, memory_cascade: nil, output: nil, parent_objective_id: nil, pinned_parameters: nil, secrets: nil, state_message: nil, system_prompt_data: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::Objective} for more details.
       #
@@ -146,6 +153,8 @@ module Cadenya
       #
       #   @param parent_objective_id [String] A parent objective means the objective was spawned off using a separate agent to
       #
+      #   @param pinned_parameters [Hash{Symbol=>String}] Parameters forced onto this objective's tool calls, as provided at
+      #
       #   @param secrets [Array<Cadenya::Models::ObjectiveSecret>] Secrets that can be used in the headers for tool calls using the secret interpol
       #
       #   @param state_message [String] Optional human-readable detail about the current state (e.g. a failure reason).

data/lib/cadenya/models/objective_create_params.rb

@@ -83,6 +83,15 @@ module Cadenya
       #   @return [Cadenya::Models::CreateOperationMetadata, nil]
       optional :metadata, -> { Cadenya::CreateOperationMetadata }
 
+      # @!attribute pinned_parameters
+      #   Parameters forced onto this objective's tool calls. A pinned parameter is an
+      #   overlay on a tool's JSON schema: the parameter is removed from what the LLM
+      #   sees, and its value is always overwritten server-side with the pinned value —
+      #   the model cannot choose a different value for it.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :pinned_parameters, Cadenya::Internal::Type::HashOf[String], api_name: :pinnedParameters
+
       # @!attribute secrets
       #   Secrets that can be used in the headers for tool calls using the secret
       #   interpolation format.
@@ -90,6 +99,25 @@ module Cadenya
       #   @return [Array<Cadenya::Models::ObjectiveCreateParams::Secret>, nil]
       optional :secrets, -> { Cadenya::Internal::Type::ArrayOf[Cadenya::ObjectiveCreateParams::Secret] }
 
+      # @!attribute subject
+      #   SubjectAssertion identifies a person within a tenant in the customer's own
+      #   namespace — typically their user id. Asserting a subject upserts the subject
+      #   record under the asserted tenant and associates the created resource with it. A
+      #   subject assertion is only valid alongside a tenant assertion: subject
+      #   identifiers are scoped to their tenant.
+      #
+      #   @return [Cadenya::Models::SubjectAssertion, nil]
+      optional :subject, -> { Cadenya::SubjectAssertion }
+
+      # @!attribute tenant
+      #   TenantAssertion identifies a tenant in the customer's own namespace — their org,
+      #   company, or team identifier for an end user. Asserting a tenant upserts the
+      #   tenant record in the workspace (keyed on `id` as the tenant's external_id) and
+      #   associates the created resource with it.
+      #
+      #   @return [Cadenya::Models::TenantAssertion, nil]
+      optional :tenant, -> { Cadenya::TenantAssertion }
+
       # @!attribute variation_id
       #   Optional explicit variation selection. Overrides the agent's
       #   variation_selection_mode.
@@ -97,7 +125,7 @@ module Cadenya
       #   @return [String, nil]
       optional :variation_id, String, api_name: :variationId
 
-      # @!method initialize(agent_id:, system_prompt_data:, workspace_id: nil, episodic_memory: nil, first_user_message: nil, first_user_message_data: nil, memory_cascade: nil, metadata: nil, secrets: nil, variation_id: nil, request_options: {})
+      # @!method initialize(agent_id:, system_prompt_data:, workspace_id: nil, episodic_memory: nil, first_user_message: nil, first_user_message_data: nil, memory_cascade: nil, metadata: nil, pinned_parameters: nil, secrets: nil, subject: nil, tenant: nil, variation_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ObjectiveCreateParams} for more details.
       #
@@ -117,8 +145,14 @@ module Cadenya
       #
       #   @param metadata [Cadenya::Models::CreateOperationMetadata] CreateOperationMetadata contains the user-provided fields for creating
       #
+      #   @param pinned_parameters [Hash{Symbol=>String}] Parameters forced onto this objective's tool calls. A pinned parameter
+      #
       #   @param secrets [Array<Cadenya::Models::ObjectiveCreateParams::Secret>] Secrets that can be used in the headers for tool calls using the secret interpol
       #
+      #   @param subject [Cadenya::Models::SubjectAssertion] SubjectAssertion identifies a person within a tenant in the customer's own
+      #
+      #   @param tenant [Cadenya::Models::TenantAssertion] TenantAssertion identifies a tenant in the customer's own namespace — their
+      #
       #   @param variation_id [String] Optional explicit variation selection. Overrides the agent's variation_selection
       #
       #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]

data/lib/cadenya/models/objective_event.rb

@@ -6,7 +6,7 @@ module Cadenya
     class ObjectiveEvent < Cadenya::Internal::Type::BaseModel
       # @!attribute data
       #
-      #   @return [Cadenya::Models::ObjectiveEventDataUserMessage, Cadenya::Models::ObjectiveEventDataToolApprovalRequested, Cadenya::Models::ObjectiveEventDataToolApproved, Cadenya::Models::ObjectiveEventDataToolDenied, Cadenya::Models::ObjectiveEventDataToolCalled, Cadenya::Models::ObjectiveEventDataError, Cadenya::Models::ObjectiveEventDataAssistantMessage, Cadenya::Models::ObjectiveEventDataToolResult, Cadenya::Models::ObjectiveEventDataToolError, Cadenya::Models::ObjectiveEventDataContextWindowCompacted, Cadenya::Models::ObjectiveEventDataMemoryRead, Cadenya::Models::ObjectiveEventDataCancelled, Cadenya::Models::ObjectiveEventDataSubAgentSpawned, Cadenya::Models::ObjectiveEventDataSubAgentUpdated, Cadenya::Models::ObjectiveEventDataFinalized, Cadenya::Models::ObjectiveEventDataNotice, Cadenya::Models::ObjectiveEventDataTimedOut]
+      #   @return [Cadenya::Models::ObjectiveEventDataUserMessage, Cadenya::Models::ObjectiveEventDataToolApprovalRequested, Cadenya::Models::ObjectiveEventDataToolApproved, Cadenya::Models::ObjectiveEventDataToolDenied, Cadenya::Models::ObjectiveEventDataToolCalled, Cadenya::Models::ObjectiveEventDataError, Cadenya::Models::ObjectiveEventDataAssistantMessage, Cadenya::Models::ObjectiveEventDataToolResult, Cadenya::Models::ObjectiveEventDataToolError, Cadenya::Models::ObjectiveEventDataContextWindowCompacted, Cadenya::Models::ObjectiveEventDataMemoryRead, Cadenya::Models::ObjectiveEventDataCancelled, Cadenya::Models::ObjectiveEventDataSubAgentSpawned, Cadenya::Models::ObjectiveEventDataSubAgentUpdated, Cadenya::Models::ObjectiveEventDataFinalized, Cadenya::Models::ObjectiveEventDataNotice, Cadenya::Models::ObjectiveEventDataTimedOut, Cadenya::Models::ObjectiveEventDataReasoning]
       required :data, union: -> { Cadenya::ObjectiveEventData }
 
       # @!attribute metadata
@@ -50,7 +50,7 @@ module Cadenya
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ObjectiveEvent} for more details.
       #
-      #   @param data [Cadenya::Models::ObjectiveEventDataUserMessage, Cadenya::Models::ObjectiveEventDataToolApprovalRequested, Cadenya::Models::ObjectiveEventDataToolApproved, Cadenya::Models::ObjectiveEventDataToolDenied, Cadenya::Models::ObjectiveEventDataToolCalled, Cadenya::Models::ObjectiveEventDataError, Cadenya::Models::ObjectiveEventDataAssistantMessage, Cadenya::Models::ObjectiveEventDataToolResult, Cadenya::Models::ObjectiveEventDataToolError, Cadenya::Models::ObjectiveEventDataContextWindowCompacted, Cadenya::Models::ObjectiveEventDataMemoryRead, Cadenya::Models::ObjectiveEventDataCancelled, Cadenya::Models::ObjectiveEventDataSubAgentSpawned, Cadenya::Models::ObjectiveEventDataSubAgentUpdated, Cadenya::Models::ObjectiveEventDataFinalized, Cadenya::Models::ObjectiveEventDataNotice, Cadenya::Models::ObjectiveEventDataTimedOut]
+      #   @param data [Cadenya::Models::ObjectiveEventDataUserMessage, Cadenya::Models::ObjectiveEventDataToolApprovalRequested, Cadenya::Models::ObjectiveEventDataToolApproved, Cadenya::Models::ObjectiveEventDataToolDenied, Cadenya::Models::ObjectiveEventDataToolCalled, Cadenya::Models::ObjectiveEventDataError, Cadenya::Models::ObjectiveEventDataAssistantMessage, Cadenya::Models::ObjectiveEventDataToolResult, Cadenya::Models::ObjectiveEventDataToolError, Cadenya::Models::ObjectiveEventDataContextWindowCompacted, Cadenya::Models::ObjectiveEventDataMemoryRead, Cadenya::Models::ObjectiveEventDataCancelled, Cadenya::Models::ObjectiveEventDataSubAgentSpawned, Cadenya::Models::ObjectiveEventDataSubAgentUpdated, Cadenya::Models::ObjectiveEventDataFinalized, Cadenya::Models::ObjectiveEventDataNotice, Cadenya::Models::ObjectiveEventDataTimedOut, Cadenya::Models::ObjectiveEventDataReasoning]
       #
       #   @param metadata [Cadenya::Models::OperationMetadata] Metadata for ephemeral operations and activities (e.g., objectives, executions,
       #

data/lib/cadenya/models/objective_event_data.rb

@@ -41,8 +41,10 @@ module Cadenya
 
       variant :timedOut, -> { Cadenya::ObjectiveEventDataTimedOut }
 
+      variant :reasoning, -> { Cadenya::ObjectiveEventDataReasoning }
+
       # @!method self.variants
-      #   @return [Array(Cadenya::Models::ObjectiveEventDataUserMessage, Cadenya::Models::ObjectiveEventDataToolApprovalRequested, Cadenya::Models::ObjectiveEventDataToolApproved, Cadenya::Models::ObjectiveEventDataToolDenied, Cadenya::Models::ObjectiveEventDataToolCalled, Cadenya::Models::ObjectiveEventDataError, Cadenya::Models::ObjectiveEventDataAssistantMessage, Cadenya::Models::ObjectiveEventDataToolResult, Cadenya::Models::ObjectiveEventDataToolError, Cadenya::Models::ObjectiveEventDataContextWindowCompacted, Cadenya::Models::ObjectiveEventDataMemoryRead, Cadenya::Models::ObjectiveEventDataCancelled, Cadenya::Models::ObjectiveEventDataSubAgentSpawned, Cadenya::Models::ObjectiveEventDataSubAgentUpdated, Cadenya::Models::ObjectiveEventDataFinalized, Cadenya::Models::ObjectiveEventDataNotice, Cadenya::Models::ObjectiveEventDataTimedOut)]
+      #   @return [Array(Cadenya::Models::ObjectiveEventDataUserMessage, Cadenya::Models::ObjectiveEventDataToolApprovalRequested, Cadenya::Models::ObjectiveEventDataToolApproved, Cadenya::Models::ObjectiveEventDataToolDenied, Cadenya::Models::ObjectiveEventDataToolCalled, Cadenya::Models::ObjectiveEventDataError, Cadenya::Models::ObjectiveEventDataAssistantMessage, Cadenya::Models::ObjectiveEventDataToolResult, Cadenya::Models::ObjectiveEventDataToolError, Cadenya::Models::ObjectiveEventDataContextWindowCompacted, Cadenya::Models::ObjectiveEventDataMemoryRead, Cadenya::Models::ObjectiveEventDataCancelled, Cadenya::Models::ObjectiveEventDataSubAgentSpawned, Cadenya::Models::ObjectiveEventDataSubAgentUpdated, Cadenya::Models::ObjectiveEventDataFinalized, Cadenya::Models::ObjectiveEventDataNotice, Cadenya::Models::ObjectiveEventDataTimedOut, Cadenya::Models::ObjectiveEventDataReasoning)]
     end
   end
 end

data/lib/cadenya/models/objective_event_data_reasoning.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ObjectiveEventDataReasoning < Cadenya::Internal::Type::BaseModel
+      # @!attribute reasoning
+      #   Reasoning carries the human-readable reasoning text a model produced while
+      #   working on an iteration — extended thinking (Anthropic, Gemini) or reasoning
+      #   summaries (OpenAI). It is emitted alongside the assistant message from the same
+      #   model response and is purely informational: the text shown here is never sent
+      #   back to the model.
+      #
+      #   @return [Cadenya::Models::Reasoning]
+      required :reasoning, -> { Cadenya::Reasoning }
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Cadenya::Models::ObjectiveEventDataReasoning::Type]
+      required :type, enum: -> { Cadenya::ObjectiveEventDataReasoning::Type }
+
+      # @!method initialize(reasoning:, type:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ObjectiveEventDataReasoning} for more details.
+      #
+      #   @param reasoning [Cadenya::Models::Reasoning] Reasoning carries the human-readable reasoning text a model produced while
+      #
+      #   @param type [Symbol, Cadenya::Models::ObjectiveEventDataReasoning::Type]
+
+      # @see Cadenya::Models::ObjectiveEventDataReasoning#type
+      module Type
+        extend Cadenya::Internal::Type::Enum
+
+        REASONING = :reasoning
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/objective_info.rb

@@ -80,9 +80,34 @@ module Cadenya
         #
         #   @return [Integer]
         required :total_tool_calls, Integer, api_name: :totalToolCalls
+
+        # @!attribute subject
+        #   SubjectReference is the read-only echo of a resource's subject association,
+        #   carrying both Cadenya's canonical id and the customer's own key.
+        #
+        #   @return [Cadenya::Models::SubjectReference, nil]
+        optional :subject, -> { Cadenya::SubjectReference }
+
+        # @!attribute tenant
+        #   TenantReference is the read-only echo of a resource's tenant association,
+        #   carrying both Cadenya's canonical id and the customer's own key.
+        #
+        #   @return [Cadenya::Models::TenantReference, nil]
+        optional :tenant, -> { Cadenya::TenantReference }
+
+        # @!attribute widget
+        #   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 :widget, -> { Cadenya::BareMetadata }
       end
 
-      # @!method initialize(agent:, agent_variation:, created_by:, current_context_window_id:, effective_memory_cascade:, total_context_windows:, total_events:, total_input_tokens:, total_iterations:, total_output_tokens:, total_tool_calls:)
+      # @!method initialize(agent:, agent_variation:, created_by:, current_context_window_id:, effective_memory_cascade:, total_context_windows:, total_events:, total_input_tokens:, total_iterations:, total_output_tokens:, total_tool_calls:, subject: nil, tenant: nil, widget: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ObjectiveInfo} for more details.
       #
@@ -110,6 +135,12 @@ module Cadenya
       #   @param total_output_tokens [Integer] Total output tokens generated across all LLM completions across all context wind
       #
       #   @param total_tool_calls [Integer] Total number of tool calls made during execution
+      #
+      #   @param subject [Cadenya::Models::SubjectReference] SubjectReference is the read-only echo of a resource's subject association,
+      #
+      #   @param tenant [Cadenya::Models::TenantReference] TenantReference is the read-only echo of a resource's tenant association,
+      #
+      #   @param widget [Cadenya::Models::BareMetadata] BareMetadata contains the minimal metadata for a resource: the ID and an
     end
   end
 end

data/lib/cadenya/models/objective_list_params.rb

@@ -74,7 +74,35 @@ module Cadenya
       #   @return [Symbol, Cadenya::Models::ObjectiveListParams::State, nil]
       optional :state, enum: -> { Cadenya::ObjectiveListParams::State }
 
-      # @!method initialize(workspace_id: nil, agent_id: nil, agent_schedule_id: nil, cursor: nil, include_info: nil, labels: nil, limit: nil, parent_objective_id: nil, profile_id: nil, sort_order: nil, state: nil, request_options: {})
+      # @!attribute subject_id
+      #   Filter to objectives associated with a subject. Accepts the canonical `subj_…`
+      #   form or the `external_id:<value>` form; the external_id form is scoped within a
+      #   tenant and requires `tenant_id` to also be set.
+      #
+      #   @return [String, nil]
+      optional :subject_id, String
+
+      # @!attribute tenant_id
+      #   Filter to objectives associated with a tenant. Accepts the canonical `tenant_…`
+      #   form or the `external_id:<value>` form.
+      #
+      #   @return [String, nil]
+      optional :tenant_id, String
+
+      # @!attribute widget_id
+      #   Filter to objectives whose conversation ran through a widget. Accepts the
+      #   canonical `wgt_…` form or the `external_id:<value>` form.
+      #
+      #   @return [String, nil]
+      optional :widget_id, String
+
+      # @!attribute widget_session_id
+      #   Filter to objectives created by a specific widget session.
+      #
+      #   @return [String, nil]
+      optional :widget_session_id, String
+
+      # @!method initialize(workspace_id: nil, agent_id: nil, agent_schedule_id: nil, cursor: nil, include_info: nil, labels: nil, limit: nil, parent_objective_id: nil, profile_id: nil, sort_order: nil, state: nil, subject_id: nil, tenant_id: nil, widget_id: nil, widget_session_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ObjectiveListParams} for more details.
       #
@@ -100,6 +128,14 @@ module Cadenya
       #
       #   @param state [Symbol, Cadenya::Models::ObjectiveListParams::State] Filter by state
       #
+      #   @param subject_id [String] Filter to objectives associated with a subject. Accepts the canonical
+      #
+      #   @param tenant_id [String] Filter to objectives associated with a tenant. Accepts the canonical
+      #
+      #   @param widget_id [String] Filter to objectives whose conversation ran through a widget. Accepts
+      #
+      #   @param widget_session_id [String] Filter to objectives created by a specific widget session.
+      #
       #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
 
       # Filter by state

data/lib/cadenya/models/reasoning.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class Reasoning < Cadenya::Internal::Type::BaseModel
+      # @!attribute content
+      #   The reasoning text. May be a verbatim chain of thought or a provider-generated
+      #   summary depending on the model.
+      #
+      #   @return [String]
+      required :content, String
+
+      # @!method initialize(content:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::Reasoning} for more details.
+      #
+      #   Reasoning carries the human-readable reasoning text a model produced while
+      #   working on an iteration — extended thinking (Anthropic, Gemini) or reasoning
+      #   summaries (OpenAI). It is emitted alongside the assistant message from the same
+      #   model response and is purely informational: the text shown here is never sent
+      #   back to the model.
+      #
+      #   @param content [String] The reasoning text. May be a verbatim chain of thought or a
+    end
+  end
+end

data/lib/cadenya/models/subject.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class Subject < Cadenya::Internal::Type::BaseModel
+      # @!attribute metadata
+      #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+      #
+      #   @return [Cadenya::Models::ResourceMetadata]
+      required :metadata, -> { Cadenya::ResourceMetadata }
+
+      # @!attribute info
+      #   SubjectInfo provides read-only server-derived data about a subject.
+      #
+      #   @return [Cadenya::Models::SubjectInfo, nil]
+      optional :info, -> { Cadenya::SubjectInfo }
+
+      # @!method initialize(metadata:, info: nil)
+      #   Some parameter documentations has been truncated, see {Cadenya::Models::Subject}
+      #   for more details.
+      #
+      #   Subject is a person within a tenant as a readable record. Like Tenant it carries
+      #   no spec — `metadata.external_id` is the customer's key for them, unique within
+      #   the tenant rather than the workspace.
+      #
+      #   @param metadata [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+      #
+      #   @param info [Cadenya::Models::SubjectInfo] SubjectInfo provides read-only server-derived data about a subject.
+    end
+  end
+end

data/lib/cadenya/models/subject_assertion.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class SubjectAssertion < Cadenya::Internal::Type::BaseModel
+      # @!attribute id
+      #   The subject identifier in the customer's namespace (e.g. their user id). Stored
+      #   as the subject record's external_id; unique within the tenant.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute name
+      #   Optional human-readable name for the subject. Updates the subject record's name
+      #   on every assertion that provides it.
+      #
+      #   @return [String, nil]
+      optional :name, String
+
+      # @!method initialize(id:, name: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::SubjectAssertion} for more details.
+      #
+      #   SubjectAssertion identifies a person within a tenant in the customer's own
+      #   namespace — typically their user id. Asserting a subject upserts the subject
+      #   record under the asserted tenant and associates the created resource with it. A
+      #   subject assertion is only valid alongside a tenant assertion: subject
+      #   identifiers are scoped to their tenant.
+      #
+      #   @param id [String] The subject identifier in the customer's namespace (e.g. their user id).
+      #
+      #   @param name [String] Optional human-readable name for the subject. Updates the subject
+    end
+  end
+end

data/lib/cadenya/models/subject_info.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class SubjectInfo < Cadenya::Internal::Type::BaseModel
+      response_only do
+        # @!attribute objective_count
+        #   Number of objectives associated with this subject.
+        #
+        #   @return [Integer, nil]
+        optional :objective_count, Integer, api_name: :objectiveCount
+
+        # @!attribute tenant
+        #   TenantReference is the read-only echo of a resource's tenant association,
+        #   carrying both Cadenya's canonical id and the customer's own key.
+        #
+        #   @return [Cadenya::Models::TenantReference, nil]
+        optional :tenant, -> { Cadenya::TenantReference }
+      end
+
+      # @!method initialize(objective_count: nil, tenant: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::SubjectInfo} for more details.
+      #
+      #   SubjectInfo provides read-only server-derived data about a subject.
+      #
+      #   @param objective_count [Integer] Number of objectives associated with this subject.
+      #
+      #   @param tenant [Cadenya::Models::TenantReference] TenantReference is the read-only echo of a resource's tenant association,
+    end
+  end
+end

data/lib/cadenya/models/subject_reference.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class SubjectReference < Cadenya::Internal::Type::BaseModel
+      response_only do
+        # @!attribute id
+        #   Cadenya's canonical subject id.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute external_id
+        #   The subject identifier in the customer's namespace, as asserted. Unique within
+        #   the subject's tenant.
+        #
+        #   @return [String]
+        required :external_id, String, api_name: :externalId
+
+        # @!attribute name
+        #   Human-readable name of the subject, when one has been asserted.
+        #
+        #   @return [String, nil]
+        optional :name, String
+      end
+
+      # @!method initialize(id:, external_id:, name: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::SubjectReference} for more details.
+      #
+      #   SubjectReference is the read-only echo of a resource's subject association,
+      #   carrying both Cadenya's canonical id and the customer's own key.
+      #
+      #   @param id [String] Cadenya's canonical subject id.
+      #
+      #   @param external_id [String] The subject identifier in the customer's namespace, as asserted. Unique
+      #
+      #   @param name [String] Human-readable name of the subject, when one has been asserted.
+    end
+  end
+end