cadenya 0.27.0 → 0.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c6eb50e3dd9cd1e5abf056602489f69eb105ade97ee895cc3317800037f7fc38
-  data.tar.gz: e09e1f78f5785eb72204bf9f386bcab14a520860c398976ad0924c687104ae7d
+  metadata.gz: d00d248c33699a4a01039ddd4d6123e9648ff8bc367c20a8e65e4885851cb60e
+  data.tar.gz: 81189360913ae6f04eb92b83ffdad219dade81eeb6eccb400318d39e89bc8e47
 SHA512:
-  metadata.gz: d04c3cecc0ff18faf6f7ed78f3534212d31dc3cc232810b2d3f27e479f9c2e25cc4dc2f14cabce32bdc2e1937e00043032608400d67c2d30cde27ce315230967
-  data.tar.gz: 52851b33c7aa1d0fcceaf8f82807900525f38074b0437c951f193ee1c0de8baadcb2624e80b840f970d0ec5220fb989b8d7c4eec07bc2a516c18e994a539ad69
+  metadata.gz: c276b5b5f6499525a452490dc7df6de4ffd9109a666aa712dbcbc201420a9de9ef0cfbffae86174836e055bc31272a72303de43aa6c0ceb4c1de9123f4531ab3
+  data.tar.gz: c2f2abd24fa38008337bda2931e8c27e9e39ca1412a9a523ae3d678766e62f58a855de3373a533e4c9733b327ae40286764161dd2e7ef823cf65fa99cc7b820f

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.29.0 (2026-07-05)
+
+Full Changelog: [v0.28.0...v0.29.0](https://github.com/cadenya/cadenya-ruby/compare/v0.28.0...v0.29.0)
+
+### Features
+
+* **api:** api update ([e14c0d7](https://github.com/cadenya/cadenya-ruby/commit/e14c0d7509075b97bf655215eb5f266e8903b3a6))
+
+## 0.28.0 (2026-07-04)
+
+Full Changelog: [v0.27.0...v0.28.0](https://github.com/cadenya/cadenya-ruby/compare/v0.27.0...v0.28.0)
+
+### Features
+
+* **api:** api update ([c9dc7c5](https://github.com/cadenya/cadenya-ruby/commit/c9dc7c5f0fc9da27463add06430456abdaaa7163))
+
 ## 0.27.0 (2026-07-03)
 
 Full Changelog: [v0.26.0...v0.27.0](https://github.com/cadenya/cadenya-ruby/compare/v0.26.0...v0.27.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.27.0"
+gem "cadenya", "~> 0.29.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/cadenya/models/agent_spec.rb

@@ -36,18 +36,6 @@ module Cadenya
       #   @return [Integer, nil]
       optional :episodic_memory_ttl, Integer, api_name: :episodicMemoryTtl
 
-      # @!attribute input_data_schema
-      #   InputDataSchema is used for enforcing a data input when objectives are created.
-      #   This is valuable when using liquid formatting in agent variation prompts. Input
-      #   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.
-      #
-      #   @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
@@ -59,13 +47,26 @@ module Cadenya
                Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown],
                api_name: :outputDefinition
 
+      # @!attribute system_prompt_data_schema
+      #   SystemPromptDataSchema enforces the shape of system_prompt_data when objectives
+      #   are created. This is valuable when using liquid formatting in agent variation
+      #   system prompt templates. The schema is also used when the agent is attached as a
+      #   sub-agent, as it becomes 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 [Hash{Symbol=>Object}, nil]
+      optional :system_prompt_data_schema,
+               Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown],
+               api_name: :systemPromptDataSchema
+
       # @!attribute webhook_events_url
       #   The URL that Cadenya will send events for any objective assigned to the agent.
       #
       #   @return [String, nil]
       optional :webhook_events_url, String, api_name: :webhookEventsUrl
 
-      # @!method initialize(variation_selection_mode:, description: nil, enable_episodic_memory: nil, episodic_memory_ttl: nil, input_data_schema: nil, output_definition: nil, webhook_events_url: nil)
+      # @!method initialize(variation_selection_mode:, description: nil, enable_episodic_memory: nil, episodic_memory_ttl: nil, output_definition: nil, system_prompt_data_schema: nil, webhook_events_url: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::AgentSpec} for more details.
       #
@@ -79,10 +80,10 @@ module Cadenya
       #
       #   @param episodic_memory_ttl [Integer] How long episodic memories should be retained.
       #
-      #   @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 system_prompt_data_schema [Hash{Symbol=>Object}] SystemPromptDataSchema enforces the shape of system_prompt_data when objectives
+      #
       #   @param webhook_events_url [String] The URL that Cadenya will send events for any objective assigned to the agent.
 
       # Controls how variations are automatically selected when creating objectives

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

@@ -12,20 +12,21 @@ module Cadenya
         #   @return [Cadenya::Models::Agents::AgentScheduleSpecSchedule]
         required :schedule, -> { Cadenya::Agents::AgentScheduleSpecSchedule }
 
-        # @!attribute data
-        #   Optional input data passed to the objective. If the agent has an
-        #   input_data_schema, this must satisfy it.
+        # @!attribute first_user_message
+        #   Optional explicit first user message passed to CreateObjective on each fire.
+        #   Becomes the first user message in the objective's chat history. When unset, the
+        #   fired objective defers to the selected variation's first_user_message_template.
         #
-        #   @return [Object, nil]
-        optional :data, Cadenya::Internal::Type::Unknown
+        #   @return [String, nil]
+        optional :first_user_message, String, api_name: :firstUserMessage
 
-        # @!attribute initial_message
-        #   Optional initial message passed to CreateObjective on each fire. Becomes the
-        #   first user message in the objective's chat history. When unset, the fired
-        #   objective defers to the selected variation's user_message_template.
+        # @!attribute first_user_message_data
+        #   Optional data rendered into the variation's first_user_message_template when
+        #   each fired objective is created. Separate from `system_prompt_data`, which
+        #   renders the system prompt template.
         #
-        #   @return [String, nil]
-        optional :initial_message, String, api_name: :initialMessage
+        #   @return [Object, nil]
+        optional :first_user_message_data, Cadenya::Internal::Type::Unknown, api_name: :firstUserMessageData
 
         # @!attribute overlap_policy
         #   What to do when the previous run is still in flight. Defaults to SKIP.
@@ -35,13 +36,13 @@ module Cadenya
                  enum: -> { Cadenya::Agents::AgentScheduleSpec::OverlapPolicy },
                  api_name: :overlapPolicy
 
-        # @!attribute user_data
-        #   Optional data rendered into the variation's user_message_template when each
-        #   fired objective is created. Separate from `data`, which renders the system
-        #   prompt template.
+        # @!attribute system_prompt_data
+        #   Optional data rendered into the variation's system_prompt_template when each
+        #   fired objective is created. If the agent has a system_prompt_data_schema, this
+        #   must satisfy it.
         #
         #   @return [Object, nil]
-        optional :user_data, Cadenya::Internal::Type::Unknown, api_name: :userData
+        optional :system_prompt_data, Cadenya::Internal::Type::Unknown, api_name: :systemPromptData
 
         # @!attribute variation_id
         #   Optional explicit variation. When unset, the agent's variation_selection_mode
@@ -50,7 +51,7 @@ module Cadenya
         #   @return [String, nil]
         optional :variation_id, String, api_name: :variationId
 
-        # @!method initialize(schedule:, data: nil, initial_message: nil, overlap_policy: nil, user_data: nil, variation_id: nil)
+        # @!method initialize(schedule:, first_user_message: nil, first_user_message_data: nil, overlap_policy: nil, system_prompt_data: nil, variation_id: nil)
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Agents::AgentScheduleSpec} for more details.
         #
@@ -58,13 +59,13 @@ module Cadenya
         #
         #   @param schedule [Cadenya::Models::Agents::AgentScheduleSpecSchedule] Schedule defines WHEN the schedule fires. Temporal-style structured form:
         #
-        #   @param data [Object] Optional input data passed to the objective. If the agent has an
+        #   @param first_user_message [String] Optional explicit first user message passed to CreateObjective on each fire.
         #
-        #   @param initial_message [String] Optional initial message passed to CreateObjective on each fire. Becomes the
+        #   @param first_user_message_data [Object] Optional data rendered into the variation's first_user_message_template when
         #
         #   @param overlap_policy [Symbol, Cadenya::Models::Agents::AgentScheduleSpec::OverlapPolicy] What to do when the previous run is still in flight. Defaults to SKIP.
         #
-        #   @param user_data [Object] Optional data rendered into the variation's user_message_template when each
+        #   @param system_prompt_data [Object] Optional data rendered into the variation's system_prompt_template when each
         #
         #   @param variation_id [String] Optional explicit variation. When unset, the agent's variation_selection_mode
 

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

@@ -25,6 +25,17 @@ module Cadenya
         #   @return [String, nil]
         optional :description, String
 
+        # @!attribute first_user_message_template
+        #   Liquid template for the first user message of objectives using this variation.
+        #   Rendered with CreateObjectiveRequest.first_user_message_data into
+        #   Objective.first_user_message, the first user message in the LLM chat history.
+        #   CreateObjectiveRequest.first_user_message, when set, overrides the rendered
+        #   result. If neither this template nor first_user_message is present, objective
+        #   creation is rejected with InvalidArgument.
+        #
+        #   @return [String, nil]
+        optional :first_user_message_template, String, api_name: :firstUserMessageTemplate
+
         # @!attribute model_config
         #   ModelConfig defines the model configuration for a variation
         #
@@ -45,21 +56,12 @@ module Cadenya
 
         # @!attribute system_prompt_template
         #   Liquid template for the system prompt of objectives using this variation.
-        #   Rendered with CreateObjectiveRequest.data into Objective.system_prompt.
+        #   Rendered with CreateObjectiveRequest.system_prompt_data into
+        #   Objective.system_prompt.
         #
         #   @return [String, nil]
         optional :system_prompt_template, String, api_name: :systemPromptTemplate
 
-        # @!attribute user_message_template
-        #   Liquid template for the initial user message of objectives using this variation.
-        #   Rendered with CreateObjectiveRequest.user_data and becomes the first user
-        #   message in the LLM chat history. CreateObjectiveRequest.initial_message, when
-        #   set, overrides the rendered result. If neither this template nor initial_message
-        #   is present, objective creation is rejected with InvalidArgument.
-        #
-        #   @return [String, nil]
-        optional :user_message_template, String, api_name: :userMessageTemplate
-
         # @!attribute weight
         #   Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights).
         #   Only used when the agent's variation_selection_mode is WEIGHTED. A weight of 0
@@ -69,7 +71,7 @@ module Cadenya
         #   @return [Integer, nil]
         optional :weight, Integer
 
-        # @!method initialize(compaction_config: nil, constraints: nil, description: nil, model_config: nil, progressive_discovery: nil, system_prompt_template: nil, user_message_template: nil, weight: nil)
+        # @!method initialize(compaction_config: nil, constraints: nil, description: nil, first_user_message_template: nil, model_config: nil, progressive_discovery: nil, system_prompt_template: nil, weight: nil)
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Agents::AgentVariationSpec} for more details.
         #
@@ -81,14 +83,14 @@ module Cadenya
         #
         #   @param description [String] Human-readable description of what this variation does or when it should be used
         #
+        #   @param first_user_message_template [String] Liquid template for the first user message of objectives using this variation.
+        #
         #   @param model_config [Cadenya::Models::Agents::AgentVariationSpecModelConfig] ModelConfig defines the model configuration for a variation
         #
         #   @param progressive_discovery [Cadenya::Models::Agents::AgentVariationSpecProgressiveDiscovery] ProgressiveDiscovery is used to indicate that the agent should automatically dis
         #
         #   @param system_prompt_template [String] Liquid template for the system prompt of objectives using this variation.
         #
-        #   @param user_message_template [String] Liquid template for the initial user message of objectives using this variation.
-        #
         #   @param weight [Integer] Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights).
       end
     end

data/lib/cadenya/models/context_lengths.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ContextLengths < Cadenya::Internal::Type::BaseModel
+      response_only do
+        # @!attribute assistant_messages
+        #   Chat history messages with the assistant role.
+        #
+        #   @return [Integer]
+        required :assistant_messages, Integer, api_name: :assistantMessages
+
+        # @!attribute available_tools
+        #   The discoverable/available-tools appendix attached to the system prompt.
+        #
+        #   @return [Integer]
+        required :available_tools, Integer, api_name: :availableTools
+
+        # @!attribute episodic_memory
+        #   The episodic memory appendix attached to the system prompt.
+        #
+        #   @return [Integer]
+        required :episodic_memory, Integer, api_name: :episodicMemory
+
+        # @!attribute skills_memory
+        #   The skills memory appendix attached to the system prompt.
+        #
+        #   @return [Integer]
+        required :skills_memory, Integer, api_name: :skillsMemory
+
+        # @!attribute system_prompt
+        #   The objective's base system prompt (rendered variation template).
+        #
+        #   @return [Integer]
+        required :system_prompt, Integer, api_name: :systemPrompt
+
+        # @!attribute tool_definitions
+        #   Serialized tool definitions sent with the completion request (names,
+        #   descriptions, and JSON-schema parameters).
+        #
+        #   @return [Integer]
+        required :tool_definitions, Integer, api_name: :toolDefinitions
+
+        # @!attribute tool_results
+        #   Tool results present in the chat history.
+        #
+        #   @return [Integer]
+        required :tool_results, Integer, api_name: :toolResults
+
+        # @!attribute user_messages
+        #   Chat history messages with the user role.
+        #
+        #   @return [Integer]
+        required :user_messages, Integer, api_name: :userMessages
+      end
+
+      # @!method initialize(assistant_messages:, available_tools:, episodic_memory:, skills_memory:, system_prompt:, tool_definitions:, tool_results:, user_messages:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ContextLengths} for more details.
+      #
+      #   ContextLengths is the measured character length of each distinct component of an
+      #   iteration's assembled context window. Values are raw character lengths of the
+      #   component as assembled into the request — token estimates are derived by the
+      #   client against input_tokens (component share = component length / sum of all
+      #   lengths).
+      #
+      #   New components are added as new fields — wire-compatible; absent components read
+      #   as 0.
+      #
+      #   @param assistant_messages [Integer] Chat history messages with the assistant role.
+      #
+      #   @param available_tools [Integer] The discoverable/available-tools appendix attached to the system prompt.
+      #
+      #   @param episodic_memory [Integer] The episodic memory appendix attached to the system prompt.
+      #
+      #   @param skills_memory [Integer] The skills memory appendix attached to the system prompt.
+      #
+      #   @param system_prompt [Integer] The objective's base system prompt (rendered variation template).
+      #
+      #   @param tool_definitions [Integer] Serialized tool definitions sent with the completion request
+      #
+      #   @param tool_results [Integer] Tool results present in the chat history.
+      #
+      #   @param user_messages [Integer] Chat history messages with the user role.
+    end
+  end
+end

data/lib/cadenya/models/objective.rb

@@ -4,12 +4,12 @@ module Cadenya
   module Models
     # @see Cadenya::Resources::Objectives#create
     class Objective < Cadenya::Internal::Type::BaseModel
-      # @!attribute initial_message
-      #   The initial message sent to the agent. This becomes the first user message in
-      #   the LLM chat history.
+      # @!attribute first_user_message
+      #   The first user message in the LLM chat history, either provided explicitly at
+      #   creation or rendered from the variation's first_user_message_template.
       #
       #   @return [String]
-      required :initial_message, String, api_name: :initialMessage
+      required :first_user_message, String, api_name: :firstUserMessage
 
       # @!attribute metadata
       #   Metadata for ephemeral operations and activities (e.g., objectives, executions,
@@ -71,11 +71,13 @@ module Cadenya
         #   @return [String]
         required :system_prompt, String, api_name: :systemPrompt
 
-        # @!attribute data
-        #   Arbitrary data for the objective
+        # @!attribute first_user_message_data
+        #   Arbitrary data rendered into the variation's first_user_message_template
         #
         #   @return [Hash{Symbol=>Object}, nil]
-        optional :data, Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown]
+        optional :first_user_message_data,
+                 Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown],
+                 api_name: :firstUserMessageData
 
         # @!attribute info
         #   ObjectiveInfo provides read-only aggregated statistics about an objective's
@@ -105,16 +107,16 @@ module Cadenya
         #   @return [String, nil]
         optional :state_message, String, api_name: :stateMessage
 
-        # @!attribute user_data
-        #   Arbitrary data used to render the variation's user_message_template
+        # @!attribute system_prompt_data
+        #   Arbitrary data rendered into the variation's system_prompt_template
         #
         #   @return [Hash{Symbol=>Object}, nil]
-        optional :user_data,
+        optional :system_prompt_data,
                  Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown],
-                 api_name: :userData
+                 api_name: :systemPromptData
       end
 
-      # @!method initialize(config_snapshot:, initial_message:, metadata:, state:, system_prompt:, data: nil, episodic_memory: nil, info: nil, memory_cascade: nil, output: nil, parent_objective_id: nil, secrets: nil, state_message: nil, user_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, secrets: nil, state_message: nil, system_prompt_data: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::Objective} for more details.
       #
@@ -124,7 +126,7 @@ module Cadenya
       #
       #   @param config_snapshot [Cadenya::Models::ObjectiveConfigSnapshot] ObjectiveConfigSnapshot is the point-in-time snapshot of the agent, variation, a
       #
-      #   @param initial_message [String] The initial message sent to the agent. This becomes the first user message in th
+      #   @param first_user_message [String] The first user message in the LLM chat history, either provided explicitly at
       #
       #   @param metadata [Cadenya::Models::OperationMetadata] Metadata for ephemeral operations and activities (e.g., objectives, executions,
       #
@@ -132,10 +134,10 @@ module Cadenya
       #
       #   @param system_prompt [String] system_prompt is read-only, derived from the selected variation's prompt
       #
-      #   @param data [Hash{Symbol=>Object}] Arbitrary data for the objective
-      #
       #   @param episodic_memory [Cadenya::Models::Objective::EpisodicMemory] Episodic is used to configure the episodic memory for the objective
       #
+      #   @param first_user_message_data [Hash{Symbol=>Object}] Arbitrary data rendered into the variation's first_user_message_template
+      #
       #   @param info [Cadenya::Models::ObjectiveInfo] ObjectiveInfo provides read-only aggregated statistics about an objective's exec
       #
       #   @param memory_cascade [Array<Cadenya::Models::MemoryReference>] Memory layers/entries layered over the baseline cascade inherited
@@ -148,7 +150,7 @@ module Cadenya
       #
       #   @param state_message [String] Optional human-readable detail about the current state (e.g. a failure reason).
       #
-      #   @param user_data [Hash{Symbol=>Object}] Arbitrary data used to render the variation's user_message_template
+      #   @param system_prompt_data [Hash{Symbol=>Object}] Arbitrary data rendered into the variation's system_prompt_template
 
       # The current lifecycle state of the objective.
       #

data/lib/cadenya/models/objective_create_params.rb

@@ -17,12 +17,15 @@ module Cadenya
       #   @return [String]
       required :agent_id, String, api_name: :agentId
 
-      # @!attribute data
-      #   Arbitrary data for the objective. May be used in liquid templates for prompts
-      #   configured on the agent variation
+      # @!attribute system_prompt_data
+      #   Arbitrary data rendered into the selected variation's system_prompt_template
+      #   (liquid) to produce the objective's system prompt. If the agent has a
+      #   system_prompt_data_schema, this must satisfy it.
       #
       #   @return [Hash{Symbol=>Object}]
-      required :data, Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown]
+      required :system_prompt_data,
+               Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown],
+               api_name: :systemPromptData
 
       # @!attribute episodic_memory
       #   Episodic is used to configure the episodic memory for the objective
@@ -32,15 +35,25 @@ module Cadenya
                -> { Cadenya::ObjectiveCreateParams::EpisodicMemory },
                api_name: :episodicMemory
 
-      # @!attribute initial_message
-      #   Optional override for the initial message sent to the agent. This becomes the
-      #   first user message in the LLM chat history. When not set, the selected
-      #   variation's user_message_template is rendered with user_data instead. If neither
-      #   this field nor a user_message_template is present, the request is rejected with
+      # @!attribute first_user_message
+      #   Optional explicit first user message for the LLM chat history. When not set, the
+      #   selected variation's first_user_message_template is rendered with
+      #   first_user_message_data instead. If neither this field nor a
+      #   first_user_message_template is present, the request is rejected with
       #   InvalidArgument.
       #
       #   @return [String, nil]
-      optional :initial_message, String, api_name: :initialMessage
+      optional :first_user_message, String, api_name: :firstUserMessage
+
+      # @!attribute first_user_message_data
+      #   Arbitrary data rendered into the selected variation's
+      #   first_user_message_template (liquid) to produce the first user message. Separate
+      #   from `system_prompt_data`, which renders the system prompt template.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :first_user_message_data,
+               Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown],
+               api_name: :firstUserMessageData
 
       # @!attribute memory_cascade
       #   Memory layers/entries layered over the baseline cascade inherited from the
@@ -77,16 +90,6 @@ module Cadenya
       #   @return [Array<Cadenya::Models::ObjectiveCreateParams::Secret>, nil]
       optional :secrets, -> { Cadenya::Internal::Type::ArrayOf[Cadenya::ObjectiveCreateParams::Secret] }
 
-      # @!attribute user_data
-      #   Arbitrary data rendered into the selected variation's user_message_template
-      #   (liquid) to produce the initial user message. Separate from `data`, which
-      #   renders the system prompt template.
-      #
-      #   @return [Hash{Symbol=>Object}, nil]
-      optional :user_data,
-               Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown],
-               api_name: :userData
-
       # @!attribute variation_id
       #   Optional explicit variation selection. Overrides the agent's
       #   variation_selection_mode.
@@ -94,7 +97,7 @@ module Cadenya
       #   @return [String, nil]
       optional :variation_id, String, api_name: :variationId
 
-      # @!method initialize(workspace_id:, agent_id:, data:, episodic_memory: nil, initial_message: nil, memory_cascade: nil, metadata: nil, secrets: nil, user_data: nil, variation_id: nil, request_options: {})
+      # @!method initialize(workspace_id:, agent_id:, system_prompt_data:, episodic_memory: nil, first_user_message: nil, first_user_message_data: nil, memory_cascade: nil, metadata: nil, secrets: nil, variation_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ObjectiveCreateParams} for more details.
       #
@@ -102,11 +105,13 @@ module Cadenya
       #
       #   @param agent_id [String]
       #
-      #   @param data [Hash{Symbol=>Object}] Arbitrary data for the objective. May be used in liquid templates for prompts co
+      #   @param system_prompt_data [Hash{Symbol=>Object}] Arbitrary data rendered into the selected variation's system_prompt_template
       #
       #   @param episodic_memory [Cadenya::Models::ObjectiveCreateParams::EpisodicMemory] Episodic is used to configure the episodic memory for the objective
       #
-      #   @param initial_message [String] Optional override for the initial message sent to the agent. This becomes the fi
+      #   @param first_user_message [String] Optional explicit first user message for the LLM chat history. When not set,
+      #
+      #   @param first_user_message_data [Hash{Symbol=>Object}] Arbitrary data rendered into the selected variation's first_user_message_templat
       #
       #   @param memory_cascade [Array<Cadenya::Models::MemoryReference>] Memory layers/entries layered over the baseline cascade inherited
       #
@@ -114,8 +119,6 @@ module Cadenya
       #
       #   @param secrets [Array<Cadenya::Models::ObjectiveCreateParams::Secret>] Secrets that can be used in the headers for tool calls using the secret interpol
       #
-      #   @param user_data [Hash{Symbol=>Object}] Arbitrary data rendered into the selected variation's user_message_template
-      #
       #   @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_diagnostics.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ObjectiveDiagnostics < Cadenya::Internal::Type::BaseModel
+      response_only do
+        # @!attribute cached_input_tokens
+        #   The portion of input_tokens served from the provider's prompt cache. Lets
+        #   clients distinguish "big but cached" from "big and paid fresh every iteration".
+        #
+        #   @return [Integer]
+        required :cached_input_tokens, Integer, api_name: :cachedInputTokens
+
+        # @!attribute context_lengths
+        #   ContextLengths is the measured character length of each distinct component of an
+        #   iteration's assembled context window. Values are raw character lengths of the
+        #   component as assembled into the request — token estimates are derived by the
+        #   client against input_tokens (component share = component length / sum of all
+        #   lengths).
+        #
+        #   New components are added as new fields — wire-compatible; absent components read
+        #   as 0.
+        #
+        #   @return [Cadenya::Models::ContextLengths]
+        required :context_lengths, -> { Cadenya::ContextLengths }, api_name: :contextLengths
+
+        # @!attribute input_tokens
+        #   Input tokens reported by the LLM provider for the iteration's completion.
+        #
+        #   @return [Integer]
+        required :input_tokens, Integer, api_name: :inputTokens
+      end
+
+      # @!method initialize(cached_input_tokens:, context_lengths:, input_tokens:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ObjectiveDiagnostics} for more details.
+      #
+      #   ObjectiveDiagnostics is the context-usage breakdown measured for a single
+      #   iteration at request-assembly time. It reports how much of the context window
+      #   each component occupies so tool parameters, memory cascades, and prompts can be
+      #   tuned against real token usage.
+      #
+      #   @param cached_input_tokens [Integer] The portion of input_tokens served from the provider's prompt cache.
+      #
+      #   @param context_lengths [Cadenya::Models::ContextLengths] ContextLengths is the measured character length of each distinct component
+      #
+      #   @param input_tokens [Integer] Input tokens reported by the LLM provider for the iteration's completion.
+    end
+  end
+end

data/lib/cadenya/models/objective_retrieve_diagnostics_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Objectives#retrieve_diagnostics
+    class ObjectiveRetrieveDiagnosticsParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      # @!attribute workspace_id
+      #
+      #   @return [String]
+      required :workspace_id, String
+
+      # @!attribute objective_id
+      #
+      #   @return [String]
+      required :objective_id, String
+
+      # @!method initialize(workspace_id:, objective_id:, request_options: {})
+      #   @param workspace_id [String]
+      #   @param objective_id [String]
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cadenya/models/objective_retrieve_diagnostics_response.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Objectives#retrieve_diagnostics
+    class ObjectiveRetrieveDiagnosticsResponse < Cadenya::Internal::Type::BaseModel
+      response_only do
+        # @!attribute diagnostics
+        #   ObjectiveDiagnostics is the context-usage breakdown measured for a single
+        #   iteration at request-assembly time. It reports how much of the context window
+        #   each component occupies so tool parameters, memory cascades, and prompts can be
+        #   tuned against real token usage.
+        #
+        #   @return [Cadenya::Models::ObjectiveDiagnostics]
+        required :diagnostics, -> { Cadenya::ObjectiveDiagnostics }
+      end
+
+      # @!method initialize(diagnostics:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ObjectiveRetrieveDiagnosticsResponse} for more details.
+      #
+      #   @param diagnostics [Cadenya::Models::ObjectiveDiagnostics] ObjectiveDiagnostics is the context-usage breakdown measured for a single
+    end
+  end
+end