cadenya 0.27.0 → 0.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c6eb50e3dd9cd1e5abf056602489f69eb105ade97ee895cc3317800037f7fc38
-  data.tar.gz: e09e1f78f5785eb72204bf9f386bcab14a520860c398976ad0924c687104ae7d
+  metadata.gz: bf555cd84ae5279087a5b60695fec05f03451abbb21cc910c5e85cb1ed52c56e
+  data.tar.gz: b7662e178b9f76f9e044bdff89f57bb78a75fd58ef92c9f7ac4c75ed45aef3a6
 SHA512:
-  metadata.gz: d04c3cecc0ff18faf6f7ed78f3534212d31dc3cc232810b2d3f27e479f9c2e25cc4dc2f14cabce32bdc2e1937e00043032608400d67c2d30cde27ce315230967
-  data.tar.gz: 52851b33c7aa1d0fcceaf8f82807900525f38074b0437c951f193ee1c0de8baadcb2624e80b840f970d0ec5220fb989b8d7c4eec07bc2a516c18e994a539ad69
+  metadata.gz: eb71eb5d8238a2f9d63ceadf1ebd77230fbed22f146eada9da0abeb2b578128646b6bbe3feaaf4cc179d5e894cd9c94ab96f413cbf63cbf72ebe94e1b6d42c66
+  data.tar.gz: 4bb21c37969a3c091aa854523f4e45e323ad513f299b384978befb9d975ad442b0ad24c0c064ae1ff41ec9b1cb781c92ce1bd744531504707ec912e79a4f800c

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 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.28.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/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/resources/objectives.rb

@@ -20,17 +20,19 @@ module Cadenya
       #
       # Creates a new objective in the workspace
       #
-      # @overload create(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: {})
+      # @overload create(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: {})
       #
       # @param workspace_id [String]
       #
       # @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
       #
@@ -38,8 +40,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}, nil]

data/lib/cadenya/version.rb

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

data/rbi/cadenya/models/agent_spec.rbi

@@ -38,17 +38,6 @@ module Cadenya
       sig { params(episodic_memory_ttl: Integer).void }
       attr_writer :episodic_memory_ttl
 
-      # 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.
-      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
-      attr_reader :input_data_schema
-
-      sig { params(input_data_schema: T::Hash[Symbol, T.anything]).void }
-      attr_writer :input_data_schema
-
       # Optional output definition for objectives created for this agent. When provided,
       # Cadenya will append a tool to that will be called by the LLM in use by the
       # variant to extract information in the format provided here. Use this option when
@@ -59,6 +48,20 @@ module Cadenya
       sig { params(output_definition: T::Hash[Symbol, T.anything]).void }
       attr_writer :output_definition
 
+      # 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.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_reader :system_prompt_data_schema
+
+      sig do
+        params(system_prompt_data_schema: T::Hash[Symbol, T.anything]).void
+      end
+      attr_writer :system_prompt_data_schema
+
       # The URL that Cadenya will send events for any objective assigned to the agent.
       sig { returns(T.nilable(String)) }
       attr_reader :webhook_events_url
@@ -74,8 +77,8 @@ module Cadenya
           description: String,
           enable_episodic_memory: T::Boolean,
           episodic_memory_ttl: Integer,
-          input_data_schema: T::Hash[Symbol, T.anything],
           output_definition: T::Hash[Symbol, T.anything],
+          system_prompt_data_schema: T::Hash[Symbol, T.anything],
           webhook_events_url: String
         ).returns(T.attached_class)
       end
@@ -95,17 +98,18 @@ module Cadenya
         # layer's expiry forward by this duration, and stored entries expire this long
         # after they are written. If not set, episodic memories are retained indefinitely.
         episodic_memory_ttl: nil,
-        # 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.
-        input_data_schema: nil,
         # Optional output definition for objectives created for this agent. When provided,
         # Cadenya will append a tool to that will be called by the LLM in use by the
         # variant to extract information in the format provided here. Use this option when
         # you want structured data to be created by your objectives.
         output_definition: nil,
+        # 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.
+        system_prompt_data_schema: nil,
         # The URL that Cadenya will send events for any objective assigned to the agent.
         webhook_events_url: nil
       )
@@ -119,8 +123,8 @@ module Cadenya
             description: String,
             enable_episodic_memory: T::Boolean,
             episodic_memory_ttl: Integer,
-            input_data_schema: T::Hash[Symbol, T.anything],
             output_definition: T::Hash[Symbol, T.anything],
+            system_prompt_data_schema: T::Hash[Symbol, T.anything],
             webhook_events_url: String
           }
         )