cadenya 0.10.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fdbe6be38292a9c2cdb1398a82675a4b9d83e2a633479147843681b820dc21fb
-  data.tar.gz: 26192932a4a0229f48bcbcb6bc4f1ae119351fd349eabaadafcfe746a8f3a2de
+  metadata.gz: eccefbddc3e445e6a54402fc8a5eba71d7cb44baa645cb15177c73fbc52978da
+  data.tar.gz: 4e9a538a35dca88e184acac8d92e0db0dd7209346583e193d83bf6753be34ba8
 SHA512:
-  metadata.gz: b68888435e7da1c39ecb5a13f8543e8aee96e07cdef1433fe1ce5d4310bfe75f114f2efd1b43f290a278ec307c0697f2ff8dfd41712bf2c080114c1afb4dbed0
-  data.tar.gz: ab0ea603fe0175091589cb156b96129cc82a88468e627ff2232f5fb7d500b6863372f81c0ce3b12ec02d1c849b49363991334f37b22c725a404e2344ba04f049
+  metadata.gz: 10fa27a5fcd86594aa52b339718a896037884aa27323d2d668a598f5058db98930e7a1426d608e5196306946f3184785709ca3bcb0f5df846df3758fd10a4218
+  data.tar.gz: e84213d6dd22de862fbb36859443c9eb6da7784ac5a921d3c2c11db603c104710b62aab859d3897e683a31e5ab8e6db57952a3dce3723b01308174eff93eab9c

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.11.0 (2026-06-10)
+
+Full Changelog: [v0.10.0...v0.11.0](https://github.com/cadenya/cadenya-ruby/compare/v0.10.0...v0.11.0)
+
+### Features
+
+* **api:** api update ([5f00cea](https://github.com/cadenya/cadenya-ruby/commit/5f00ceaef72eb0c4ab66a2489eecb6de7ec35616))
+
 ## 0.10.0 (2026-06-09)
 
 Full Changelog: [v0.9.0...v0.10.0](https://github.com/cadenya/cadenya-ruby/compare/v0.9.0...v0.10.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.10.0"
+gem "cadenya", "~> 0.11.0"
 ```
 
 <!-- x-release-please-end -->

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

@@ -4,13 +4,6 @@ module Cadenya
   module Models
     module Agents
       class AgentScheduleSpec < Cadenya::Internal::Type::BaseModel
-        # @!attribute initial_message
-        #   The initial message passed to CreateObjective on each fire. Becomes the first
-        #   user message in the objective's chat history.
-        #
-        #   @return [String]
-        required :initial_message, String, api_name: :initialMessage
-
         # @!attribute schedule
         #   Schedule defines WHEN the schedule fires. Temporal-style structured form: a list
         #   of calendar rules (wall-clock) and/or interval rules (duration), OR'd together.
@@ -26,6 +19,14 @@ module Cadenya
         #   @return [Object, nil]
         optional :data, Cadenya::Internal::Type::Unknown
 
+        # @!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.
+        #
+        #   @return [String, nil]
+        optional :initial_message, String, api_name: :initialMessage
+
         # @!attribute overlap_policy
         #   What to do when the previous run is still in flight. Defaults to SKIP.
         #
@@ -34,6 +35,14 @@ 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.
+        #
+        #   @return [Object, nil]
+        optional :user_data, Cadenya::Internal::Type::Unknown, api_name: :userData
+
         # @!attribute variation_id
         #   Optional explicit variation. When unset, the agent's variation_selection_mode
         #   chooses per fire.
@@ -41,20 +50,22 @@ module Cadenya
         #   @return [String, nil]
         optional :variation_id, String, api_name: :variationId
 
-        # @!method initialize(initial_message:, schedule:, data: nil, overlap_policy: nil, variation_id: nil)
+        # @!method initialize(schedule:, data: nil, initial_message: nil, overlap_policy: nil, user_data: nil, variation_id: nil)
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Agents::AgentScheduleSpec} for more details.
         #
         #   AgentScheduleSpec is the user-provided configuration for a schedule.
         #
-        #   @param initial_message [String] The initial message passed to CreateObjective on each fire. Becomes the
-        #
         #   @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 initial_message [String] Optional initial message passed to CreateObjective on each fire. Becomes the
+        #
         #   @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 variation_id [String] Optional explicit variation. When unset, the agent's variation_selection_mode
 
         # What to do when the previous run is still in flight. Defaults to SKIP.

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

@@ -60,11 +60,22 @@ module Cadenya
                  -> { Cadenya::Agents::AgentVariationSpecProgressiveDiscovery },
                  api_name: :progressiveDiscovery
 
-        # @!attribute prompt
-        #   The system prompt for this variation
+        # @!attribute system_prompt_template
+        #   Liquid template for the system prompt of objectives using this variation.
+        #   Rendered with CreateObjectiveRequest.data into Objective.system_prompt.
         #
         #   @return [String, nil]
-        optional :prompt, String
+        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).
@@ -75,7 +86,7 @@ module Cadenya
         #   @return [Integer, nil]
         optional :weight, Integer
 
-        # @!method initialize(compaction_config: nil, constraints: nil, description: nil, enable_episodic_memory: nil, episodic_memory_ttl: nil, model_config: nil, progressive_discovery: nil, prompt: nil, weight: nil)
+        # @!method initialize(compaction_config: nil, constraints: nil, description: nil, enable_episodic_memory: nil, episodic_memory_ttl: nil, model_config: nil, progressive_discovery: nil, system_prompt_template: nil, user_message_template: nil, weight: nil)
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Agents::AgentVariationSpec} for more details.
         #
@@ -95,7 +106,9 @@ module Cadenya
         #
         #   @param progressive_discovery [Cadenya::Models::Agents::AgentVariationSpecProgressiveDiscovery] ProgressiveDiscovery is used to indicate that the agent should automatically dis
         #
-        #   @param prompt [String] The system prompt for this variation
+        #   @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

data/lib/cadenya/models/objective.rb

@@ -100,9 +100,17 @@ 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
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :user_data,
+                 Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown],
+                 api_name: :userData
       end
 
-      # @!method initialize(config_snapshot:, initial_message:, metadata:, state:, system_prompt:, data: nil, info: nil, memory_stack: nil, output: nil, parent_objective_id: nil, secrets: nil, state_message: nil)
+      # @!method initialize(config_snapshot:, initial_message:, metadata:, state:, system_prompt:, data: nil, info: nil, memory_stack: nil, output: nil, parent_objective_id: nil, secrets: nil, state_message: nil, user_data: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::Objective} for more details.
       #
@@ -133,6 +141,8 @@ module Cadenya
       #   @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).
+      #
+      #   @param user_data [Hash{Symbol=>Object}] Arbitrary data used to render the variation's user_message_template
 
       # The current lifecycle state of the objective.
       #

data/lib/cadenya/models/objective_create_params.rb

@@ -25,9 +25,11 @@ module Cadenya
       required :data, Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown]
 
       # @!attribute initial_message
-      #   Optional override for initial message sent to the agent. This becomes the first
-      #   user message in the LLM chat history. The agent variation is used to set this if
-      #   not present.
+      #   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
+      #   InvalidArgument.
       #
       #   @return [String, nil]
       optional :initial_message, String, api_name: :initialMessage
@@ -69,6 +71,16 @@ 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.
@@ -76,7 +88,7 @@ module Cadenya
       #   @return [String, nil]
       optional :variation_id, String, api_name: :variationId
 
-      # @!method initialize(workspace_id:, agent_id:, data:, initial_message: nil, memory_stack: nil, metadata: nil, secrets: nil, variation_id: nil, request_options: {})
+      # @!method initialize(workspace_id:, agent_id:, data:, initial_message: nil, memory_stack: nil, metadata: nil, secrets: nil, user_data: nil, variation_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ObjectiveCreateParams} for more details.
       #
@@ -86,7 +98,7 @@ module Cadenya
       #
       #   @param data [Hash{Symbol=>Object}] Arbitrary data for the objective. May be used in liquid templates for prompts co
       #
-      #   @param initial_message [String] Optional override for initial message sent to the agent. This becomes the first
+      #   @param initial_message [String] Optional override for the initial message sent to the agent. This becomes the fi
       #
       #   @param memory_stack [Array<Cadenya::Models::MemoryReference>] Memory layers/entries to push onto this objective's memory stack on
       #
@@ -94,6 +106,8 @@ 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/resources/objectives.rb

@@ -20,7 +20,7 @@ module Cadenya
       #
       # Creates a new objective in the workspace
       #
-      # @overload create(workspace_id, agent_id:, data:, initial_message: nil, memory_stack: nil, metadata: nil, secrets: nil, variation_id: nil, request_options: {})
+      # @overload create(workspace_id, agent_id:, data:, initial_message: nil, memory_stack: nil, metadata: nil, secrets: nil, user_data: nil, variation_id: nil, request_options: {})
       #
       # @param workspace_id [String]
       #
@@ -28,7 +28,7 @@ module Cadenya
       #
       # @param data [Hash{Symbol=>Object}] Arbitrary data for the objective. May be used in liquid templates for prompts co
       #
-      # @param initial_message [String] Optional override for initial message sent to the agent. This becomes the first
+      # @param initial_message [String] Optional override for the initial message sent to the agent. This becomes the fi
       #
       # @param memory_stack [Array<Cadenya::Models::MemoryReference>] Memory layers/entries to push onto this objective's memory stack on
       #
@@ -36,6 +36,8 @@ 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}, nil]

data/lib/cadenya/version.rb

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

data/rbi/cadenya/models/agents/agent_schedule_spec.rbi

@@ -14,11 +14,6 @@ module Cadenya
             )
           end
 
-        # The initial message passed to CreateObjective on each fire. Becomes the first
-        # user message in the objective's chat history.
-        sig { returns(String) }
-        attr_accessor :initial_message
-
         # Schedule defines WHEN the schedule fires. Temporal-style structured form: a list
         # of calendar rules (wall-clock) and/or interval rules (duration), OR'd together.
         # At least one rule is required.
@@ -40,6 +35,15 @@ module Cadenya
         sig { params(data: T.anything).void }
         attr_writer :data
 
+        # 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.
+        sig { returns(T.nilable(String)) }
+        attr_reader :initial_message
+
+        sig { params(initial_message: String).void }
+        attr_writer :initial_message
+
         # What to do when the previous run is still in flight. Defaults to SKIP.
         sig do
           returns(
@@ -58,6 +62,15 @@ module Cadenya
         end
         attr_writer :overlap_policy
 
+        # 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.
+        sig { returns(T.nilable(T.anything)) }
+        attr_reader :user_data
+
+        sig { params(user_data: T.anything).void }
+        attr_writer :user_data
+
         # Optional explicit variation. When unset, the agent's variation_selection_mode
         # chooses per fire.
         sig { returns(T.nilable(String)) }
@@ -69,18 +82,16 @@ module Cadenya
         # AgentScheduleSpec is the user-provided configuration for a schedule.
         sig do
           params(
-            initial_message: String,
             schedule: Cadenya::Agents::AgentScheduleSpecSchedule::OrHash,
             data: T.anything,
+            initial_message: String,
             overlap_policy:
               Cadenya::Agents::AgentScheduleSpec::OverlapPolicy::OrSymbol,
+            user_data: T.anything,
             variation_id: String
           ).returns(T.attached_class)
         end
         def self.new(
-          # The initial message passed to CreateObjective on each fire. Becomes the first
-          # user message in the objective's chat history.
-          initial_message:,
           # Schedule defines WHEN the schedule fires. Temporal-style structured form: a list
           # of calendar rules (wall-clock) and/or interval rules (duration), OR'd together.
           # At least one rule is required.
@@ -88,8 +99,16 @@ module Cadenya
           # Optional input data passed to the objective. If the agent has an
           # input_data_schema, this must satisfy it.
           data: nil,
+          # 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.
+          initial_message: nil,
           # What to do when the previous run is still in flight. Defaults to SKIP.
           overlap_policy: nil,
+          # 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.
+          user_data: nil,
           # Optional explicit variation. When unset, the agent's variation_selection_mode
           # chooses per fire.
           variation_id: nil
@@ -99,11 +118,12 @@ module Cadenya
         sig do
           override.returns(
             {
-              initial_message: String,
               schedule: Cadenya::Agents::AgentScheduleSpecSchedule,
               data: T.anything,
+              initial_message: String,
               overlap_policy:
                 Cadenya::Agents::AgentScheduleSpec::OverlapPolicy::OrSymbol,
+              user_data: T.anything,
               variation_id: String
             }
           )

data/rbi/cadenya/models/agents/agent_variation_spec.rbi

@@ -103,12 +103,24 @@ module Cadenya
         end
         attr_writer :progressive_discovery
 
-        # The system prompt for this variation
+        # Liquid template for the system prompt of objectives using this variation.
+        # Rendered with CreateObjectiveRequest.data into Objective.system_prompt.
         sig { returns(T.nilable(String)) }
-        attr_reader :prompt
+        attr_reader :system_prompt_template
 
-        sig { params(prompt: String).void }
-        attr_writer :prompt
+        sig { params(system_prompt_template: String).void }
+        attr_writer :system_prompt_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.
+        sig { returns(T.nilable(String)) }
+        attr_reader :user_message_template
+
+        sig { params(user_message_template: String).void }
+        attr_writer :user_message_template
 
         # 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
@@ -133,7 +145,8 @@ module Cadenya
               Cadenya::Agents::AgentVariationSpecModelConfig::OrHash,
             progressive_discovery:
               Cadenya::Agents::AgentVariationSpecProgressiveDiscovery::OrHash,
-            prompt: String,
+            system_prompt_template: String,
+            user_message_template: String,
             weight: Integer
           ).returns(T.attached_class)
         end
@@ -162,8 +175,15 @@ module Cadenya
           # tool search. These are used in conjunction with the context-aware tool search
           # and can help select the best tools for the task.
           progressive_discovery: nil,
-          # The system prompt for this variation
-          prompt: nil,
+          # Liquid template for the system prompt of objectives using this variation.
+          # Rendered with CreateObjectiveRequest.data into Objective.system_prompt.
+          system_prompt_template: nil,
+          # 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.
+          user_message_template: nil,
           # 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
           # means never auto-selected, but can still be chosen explicitly via variation_id
@@ -184,7 +204,8 @@ module Cadenya
               model_config: Cadenya::Agents::AgentVariationSpecModelConfig,
               progressive_discovery:
                 Cadenya::Agents::AgentVariationSpecProgressiveDiscovery,
-              prompt: String,
+              system_prompt_template: String,
+              user_message_template: String,
               weight: Integer
             }
           )

data/rbi/cadenya/models/objective.rbi

@@ -107,6 +107,13 @@ module Cadenya
       sig { params(state_message: String).void }
       attr_writer :state_message
 
+      # Arbitrary data used to render the variation's user_message_template
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_reader :user_data
+
+      sig { params(user_data: T::Hash[Symbol, T.anything]).void }
+      attr_writer :user_data
+
       # Objective is the data for an objective. It contains the snapshotted fields for
       # the selected agent and variation. Secrets are returned only with their names,
       # and the output definition is copied from the agent's configuration.
@@ -123,7 +130,8 @@ module Cadenya
           output: T::Hash[Symbol, T.anything],
           parent_objective_id: String,
           secrets: T::Array[Cadenya::ObjectiveSecret::OrHash],
-          state_message: String
+          state_message: String,
+          user_data: T::Hash[Symbol, T.anything]
         ).returns(T.attached_class)
       end
       def self.new(
@@ -172,7 +180,9 @@ module Cadenya
         # interpolation format.
         secrets: nil,
         # Optional human-readable detail about the current state (e.g. a failure reason).
-        state_message: nil
+        state_message: nil,
+        # Arbitrary data used to render the variation's user_message_template
+        user_data: nil
       )
       end
 
@@ -190,7 +200,8 @@ module Cadenya
             output: T::Hash[Symbol, T.anything],
             parent_objective_id: String,
             secrets: T::Array[Cadenya::ObjectiveSecret],
-            state_message: String
+            state_message: String,
+            user_data: T::Hash[Symbol, T.anything]
           }
         )
       end

data/rbi/cadenya/models/objective_create_params.rbi

@@ -22,9 +22,11 @@ module Cadenya
       sig { returns(T::Hash[Symbol, T.anything]) }
       attr_accessor :data
 
-      # Optional override for initial message sent to the agent. This becomes the first
-      # user message in the LLM chat history. The agent variation is used to set this if
-      # not present.
+      # 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
+      # InvalidArgument.
       sig { returns(T.nilable(String)) }
       attr_reader :initial_message
 
@@ -77,6 +79,15 @@ module Cadenya
       end
       attr_writer :secrets
 
+      # 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.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_reader :user_data
+
+      sig { params(user_data: T::Hash[Symbol, T.anything]).void }
+      attr_writer :user_data
+
       # Optional explicit variation selection. Overrides the agent's
       # variation_selection_mode.
       sig { returns(T.nilable(String)) }
@@ -94,6 +105,7 @@ module Cadenya
           memory_stack: T::Array[Cadenya::MemoryReference::OrHash],
           metadata: Cadenya::CreateOperationMetadata::OrHash,
           secrets: T::Array[Cadenya::ObjectiveCreateParams::Secret::OrHash],
+          user_data: T::Hash[Symbol, T.anything],
           variation_id: String,
           request_options: Cadenya::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -104,9 +116,11 @@ module Cadenya
         # Arbitrary data for the objective. May be used in liquid templates for prompts
         # configured on the agent variation
         data:,
-        # Optional override for initial message sent to the agent. This becomes the first
-        # user message in the LLM chat history. The agent variation is used to set this if
-        # not present.
+        # 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
+        # InvalidArgument.
         initial_message: nil,
         # Memory layers/entries to push onto this objective's memory stack on top of the
         # baseline stack inherited from the selected variation.
@@ -131,6 +145,10 @@ module Cadenya
         # Secrets that can be used in the headers for tool calls using the secret
         # interpolation format.
         secrets: nil,
+        # 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.
+        user_data: nil,
         # Optional explicit variation selection. Overrides the agent's
         # variation_selection_mode.
         variation_id: nil,
@@ -148,6 +166,7 @@ module Cadenya
             memory_stack: T::Array[Cadenya::MemoryReference],
             metadata: Cadenya::CreateOperationMetadata,
             secrets: T::Array[Cadenya::ObjectiveCreateParams::Secret],
+            user_data: T::Hash[Symbol, T.anything],
             variation_id: String,
             request_options: Cadenya::RequestOptions
           }

data/rbi/cadenya/resources/objectives.rbi

@@ -25,6 +25,7 @@ module Cadenya
           memory_stack: T::Array[Cadenya::MemoryReference::OrHash],
           metadata: Cadenya::CreateOperationMetadata::OrHash,
           secrets: T::Array[Cadenya::ObjectiveCreateParams::Secret::OrHash],
+          user_data: T::Hash[Symbol, T.anything],
           variation_id: String,
           request_options: Cadenya::RequestOptions::OrHash
         ).returns(Cadenya::Objective)
@@ -35,9 +36,11 @@ module Cadenya
         # Arbitrary data for the objective. May be used in liquid templates for prompts
         # configured on the agent variation
         data:,
-        # Optional override for initial message sent to the agent. This becomes the first
-        # user message in the LLM chat history. The agent variation is used to set this if
-        # not present.
+        # 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
+        # InvalidArgument.
         initial_message: nil,
         # Memory layers/entries to push onto this objective's memory stack on top of the
         # baseline stack inherited from the selected variation.
@@ -62,6 +65,10 @@ module Cadenya
         # Secrets that can be used in the headers for tool calls using the secret
         # interpolation format.
         secrets: nil,
+        # 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.
+        user_data: nil,
         # Optional explicit variation selection. Overrides the agent's
         # variation_selection_mode.
         variation_id: nil,

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

@@ -5,45 +5,54 @@ module Cadenya
     module Agents
       type agent_schedule_spec =
         {
-          initial_message: String,
           schedule: Cadenya::Agents::AgentScheduleSpecSchedule,
           data: top,
+          initial_message: String,
           overlap_policy: Cadenya::Models::Agents::AgentScheduleSpec::overlap_policy,
+          user_data: top,
           variation_id: String
         }
 
       class AgentScheduleSpec < Cadenya::Internal::Type::BaseModel
-        attr_accessor initial_message: String
-
         attr_accessor schedule: Cadenya::Agents::AgentScheduleSpecSchedule
 
         attr_reader data: top?
 
         def data=: (top) -> top
 
+        attr_reader initial_message: String?
+
+        def initial_message=: (String) -> String
+
         attr_reader overlap_policy: Cadenya::Models::Agents::AgentScheduleSpec::overlap_policy?
 
         def overlap_policy=: (
           Cadenya::Models::Agents::AgentScheduleSpec::overlap_policy
         ) -> Cadenya::Models::Agents::AgentScheduleSpec::overlap_policy
 
+        attr_reader user_data: top?
+
+        def user_data=: (top) -> top
+
         attr_reader variation_id: String?
 
         def variation_id=: (String) -> String
 
         def initialize: (
-          initial_message: String,
           schedule: Cadenya::Agents::AgentScheduleSpecSchedule,
           ?data: top,
+          ?initial_message: String,
           ?overlap_policy: Cadenya::Models::Agents::AgentScheduleSpec::overlap_policy,
+          ?user_data: top,
           ?variation_id: String
         ) -> void
 
         def to_hash: -> {
-          initial_message: String,
           schedule: Cadenya::Agents::AgentScheduleSpecSchedule,
           data: top,
+          initial_message: String,
           overlap_policy: Cadenya::Models::Agents::AgentScheduleSpec::overlap_policy,
+          user_data: top,
           variation_id: String
         }
 

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

@@ -12,7 +12,8 @@ module Cadenya
           episodic_memory_ttl: Integer,
           model_config: Cadenya::Agents::AgentVariationSpecModelConfig,
           progressive_discovery: Cadenya::Agents::AgentVariationSpecProgressiveDiscovery,
-          prompt: String,
+          system_prompt_template: String,
+          user_message_template: String,
           weight: Integer
         }
 
@@ -53,9 +54,13 @@ module Cadenya
           Cadenya::Agents::AgentVariationSpecProgressiveDiscovery
         ) -> Cadenya::Agents::AgentVariationSpecProgressiveDiscovery
 
-        attr_reader prompt: String?
+        attr_reader system_prompt_template: String?
 
-        def prompt=: (String) -> String
+        def system_prompt_template=: (String) -> String
+
+        attr_reader user_message_template: String?
+
+        def user_message_template=: (String) -> String
 
         attr_reader weight: Integer?
 
@@ -69,7 +74,8 @@ module Cadenya
           ?episodic_memory_ttl: Integer,
           ?model_config: Cadenya::Agents::AgentVariationSpecModelConfig,
           ?progressive_discovery: Cadenya::Agents::AgentVariationSpecProgressiveDiscovery,
-          ?prompt: String,
+          ?system_prompt_template: String,
+          ?user_message_template: String,
           ?weight: Integer
         ) -> void
 
@@ -81,7 +87,8 @@ module Cadenya
           episodic_memory_ttl: Integer,
           model_config: Cadenya::Agents::AgentVariationSpecModelConfig,
           progressive_discovery: Cadenya::Agents::AgentVariationSpecProgressiveDiscovery,
-          prompt: String,
+          system_prompt_template: String,
+          user_message_template: String,
           weight: Integer
         }
       end

data/sig/cadenya/models/objective.rbs

@@ -13,7 +13,8 @@ module Cadenya
         output: ::Hash[Symbol, top],
         parent_objective_id: String,
         secrets: ::Array[Cadenya::ObjectiveSecret],
-        state_message: String
+        state_message: String,
+        user_data: ::Hash[Symbol, top]
       }
 
     class Objective < Cadenya::Internal::Type::BaseModel
@@ -59,6 +60,10 @@ module Cadenya
 
       def state_message=: (String) -> String
 
+      attr_reader user_data: ::Hash[Symbol, top]?
+
+      def user_data=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
+
       def initialize: (
         config_snapshot: Cadenya::ObjectiveConfigSnapshot,
         initial_message: String,
@@ -71,7 +76,8 @@ module Cadenya
         ?output: ::Hash[Symbol, top],
         ?parent_objective_id: String,
         ?secrets: ::Array[Cadenya::ObjectiveSecret],
-        ?state_message: String
+        ?state_message: String,
+        ?user_data: ::Hash[Symbol, top]
       ) -> void
 
       def to_hash: -> {
@@ -86,7 +92,8 @@ module Cadenya
         output: ::Hash[Symbol, top],
         parent_objective_id: String,
         secrets: ::Array[Cadenya::ObjectiveSecret],
-        state_message: String
+        state_message: String,
+        user_data: ::Hash[Symbol, top]
       }
 
       type state =

data/sig/cadenya/models/objective_create_params.rbs

@@ -9,6 +9,7 @@ module Cadenya
         memory_stack: ::Array[Cadenya::MemoryReference],
         metadata: Cadenya::CreateOperationMetadata,
         secrets: ::Array[Cadenya::ObjectiveCreateParams::Secret],
+        user_data: ::Hash[Symbol, top],
         variation_id: String
       }
       & Cadenya::Internal::Type::request_parameters
@@ -45,6 +46,10 @@ module Cadenya
         ::Array[Cadenya::ObjectiveCreateParams::Secret]
       ) -> ::Array[Cadenya::ObjectiveCreateParams::Secret]
 
+      attr_reader user_data: ::Hash[Symbol, top]?
+
+      def user_data=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
+
       attr_reader variation_id: String?
 
       def variation_id=: (String) -> String
@@ -57,6 +62,7 @@ module Cadenya
         ?memory_stack: ::Array[Cadenya::MemoryReference],
         ?metadata: Cadenya::CreateOperationMetadata,
         ?secrets: ::Array[Cadenya::ObjectiveCreateParams::Secret],
+        ?user_data: ::Hash[Symbol, top],
         ?variation_id: String,
         ?request_options: Cadenya::request_opts
       ) -> void
@@ -69,6 +75,7 @@ module Cadenya
         memory_stack: ::Array[Cadenya::MemoryReference],
         metadata: Cadenya::CreateOperationMetadata,
         secrets: ::Array[Cadenya::ObjectiveCreateParams::Secret],
+        user_data: ::Hash[Symbol, top],
         variation_id: String,
         request_options: Cadenya::RequestOptions
       }

data/sig/cadenya/resources/objectives.rbs

@@ -17,6 +17,7 @@ module Cadenya
         ?memory_stack: ::Array[Cadenya::MemoryReference],
         ?metadata: Cadenya::CreateOperationMetadata,
         ?secrets: ::Array[Cadenya::ObjectiveCreateParams::Secret],
+        ?user_data: ::Hash[Symbol, top],
         ?variation_id: String,
         ?request_options: Cadenya::request_opts
       ) -> Cadenya::Objective

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cadenya
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.11.0
 platform: ruby
 authors:
 - Cadenya
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-09 00:00:00.000000000 Z
+date: 2026-06-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi