cadenya 0.27.0 → 0.29.0

data/rbi/cadenya/models/objective.rbi

@@ -6,10 +6,10 @@ module Cadenya
       OrHash =
         T.type_alias { T.any(Cadenya::Objective, Cadenya::Internal::AnyHash) }
 
-      # The initial message sent to the agent. This becomes the first user message in
-      # the LLM chat history.
+      # The first user message in the LLM chat history, either provided explicitly at
+      # creation or rendered from the variation's first_user_message_template.
       sig { returns(String) }
-      attr_accessor :initial_message
+      attr_accessor :first_user_message
 
       # Metadata for ephemeral operations and activities (e.g., objectives, executions,
       # runs)
@@ -75,12 +75,12 @@ module Cadenya
       sig { returns(String) }
       attr_accessor :system_prompt
 
-      # Arbitrary data for the objective
+      # Arbitrary data rendered into the variation's first_user_message_template
       sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
-      attr_reader :data
+      attr_reader :first_user_message_data
 
-      sig { params(data: T::Hash[Symbol, T.anything]).void }
-      attr_writer :data
+      sig { params(first_user_message_data: T::Hash[Symbol, T.anything]).void }
+      attr_writer :first_user_message_data
 
       # ObjectiveInfo provides read-only aggregated statistics about an objective's
       # execution
@@ -114,12 +114,12 @@ module Cadenya
       sig { params(state_message: String).void }
       attr_writer :state_message
 
-      # Arbitrary data used to render the variation's user_message_template
+      # Arbitrary data rendered into the variation's system_prompt_template
       sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
-      attr_reader :user_data
+      attr_reader :system_prompt_data
 
-      sig { params(user_data: T::Hash[Symbol, T.anything]).void }
-      attr_writer :user_data
+      sig { params(system_prompt_data: T::Hash[Symbol, T.anything]).void }
+      attr_writer :system_prompt_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,
@@ -127,28 +127,28 @@ module Cadenya
       sig do
         params(
           config_snapshot: Cadenya::ObjectiveConfigSnapshot::OrHash,
-          initial_message: String,
+          first_user_message: String,
           metadata: Cadenya::OperationMetadata::OrHash,
           state: Cadenya::Objective::State::OrSymbol,
           system_prompt: String,
-          data: T::Hash[Symbol, T.anything],
           episodic_memory: Cadenya::Objective::EpisodicMemory::OrHash,
+          first_user_message_data: T::Hash[Symbol, T.anything],
           info: Cadenya::ObjectiveInfo::OrHash,
           memory_cascade: T::Array[Cadenya::MemoryReference::OrHash],
           output: T::Hash[Symbol, T.anything],
           parent_objective_id: String,
           secrets: T::Array[Cadenya::ObjectiveSecret::OrHash],
           state_message: String,
-          user_data: T::Hash[Symbol, T.anything]
+          system_prompt_data: T::Hash[Symbol, T.anything]
         ).returns(T.attached_class)
       end
       def self.new(
         # ObjectiveConfigSnapshot is the point-in-time snapshot of the agent, variation,
         # and (when applicable) schedule that an objective was started with.
         config_snapshot:,
-        # The initial message sent to the agent. This becomes the first user message in
-        # the LLM chat history.
-        initial_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.
+        first_user_message:,
         # Metadata for ephemeral operations and activities (e.g., objectives, executions,
         # runs)
         metadata:,
@@ -156,10 +156,10 @@ module Cadenya
         state:,
         # system_prompt is read-only, derived from the selected variation's prompt
         system_prompt:,
-        # Arbitrary data for the objective
-        data: nil,
         # Episodic is used to configure the episodic memory for the objective
         episodic_memory: nil,
+        # Arbitrary data rendered into the variation's first_user_message_template
+        first_user_message_data: nil,
         # ObjectiveInfo provides read-only aggregated statistics about an objective's
         # execution
         info: nil,
@@ -189,8 +189,8 @@ module Cadenya
         secrets: nil,
         # Optional human-readable detail about the current state (e.g. a failure reason).
         state_message: nil,
-        # Arbitrary data used to render the variation's user_message_template
-        user_data: nil
+        # Arbitrary data rendered into the variation's system_prompt_template
+        system_prompt_data: nil
       )
       end
 
@@ -198,19 +198,19 @@ module Cadenya
         override.returns(
           {
             config_snapshot: Cadenya::ObjectiveConfigSnapshot,
-            initial_message: String,
+            first_user_message: String,
             metadata: Cadenya::OperationMetadata,
             state: Cadenya::Objective::State::TaggedSymbol,
             system_prompt: String,
-            data: T::Hash[Symbol, T.anything],
             episodic_memory: Cadenya::Objective::EpisodicMemory,
+            first_user_message_data: T::Hash[Symbol, T.anything],
             info: Cadenya::ObjectiveInfo,
             memory_cascade: T::Array[Cadenya::MemoryReference],
             output: T::Hash[Symbol, T.anything],
             parent_objective_id: String,
             secrets: T::Array[Cadenya::ObjectiveSecret],
             state_message: String,
-            user_data: T::Hash[Symbol, T.anything]
+            system_prompt_data: T::Hash[Symbol, T.anything]
           }
         )
       end

data/rbi/cadenya/models/objective_create_params.rbi

@@ -17,10 +17,11 @@ module Cadenya
       sig { returns(String) }
       attr_accessor :agent_id
 
-      # Arbitrary data for the objective. May be used in liquid templates for prompts
-      # configured on the agent variation
+      # 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.
       sig { returns(T::Hash[Symbol, T.anything]) }
-      attr_accessor :data
+      attr_accessor :system_prompt_data
 
       # Episodic is used to configure the episodic memory for the objective
       sig { returns(T.nilable(Cadenya::ObjectiveCreateParams::EpisodicMemory)) }
@@ -34,16 +35,25 @@ module Cadenya
       end
       attr_writer :episodic_memory
 
-      # 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
+      # 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.
       sig { returns(T.nilable(String)) }
-      attr_reader :initial_message
+      attr_reader :first_user_message
 
-      sig { params(initial_message: String).void }
-      attr_writer :initial_message
+      sig { params(first_user_message: String).void }
+      attr_writer :first_user_message
+
+      # 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.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_reader :first_user_message_data
+
+      sig { params(first_user_message_data: T::Hash[Symbol, T.anything]).void }
+      attr_writer :first_user_message_data
 
       # Memory layers/entries layered over the baseline cascade inherited from the
       # selected variation — element-level rules over inherited styles, in CSS terms.
@@ -89,15 +99,6 @@ 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)) }
@@ -110,14 +111,14 @@ module Cadenya
         params(
           workspace_id: String,
           agent_id: String,
-          data: T::Hash[Symbol, T.anything],
+          system_prompt_data: T::Hash[Symbol, T.anything],
           episodic_memory:
             Cadenya::ObjectiveCreateParams::EpisodicMemory::OrHash,
-          initial_message: String,
+          first_user_message: String,
+          first_user_message_data: T::Hash[Symbol, T.anything],
           memory_cascade: 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)
@@ -125,17 +126,22 @@ module Cadenya
       def self.new(
         workspace_id:,
         agent_id:,
-        # Arbitrary data for the objective. May be used in liquid templates for prompts
-        # configured on the agent variation
-        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.
+        system_prompt_data:,
         # Episodic is used to configure the episodic memory for the objective
         episodic_memory: nil,
-        # 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
+        # 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.
-        initial_message: nil,
+        first_user_message: nil,
+        # 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.
+        first_user_message_data: nil,
         # Memory layers/entries layered over the baseline cascade inherited from the
         # selected variation — element-level rules over inherited styles, in CSS terms.
         #
@@ -157,10 +163,6 @@ 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,
@@ -173,13 +175,13 @@ module Cadenya
           {
             workspace_id: String,
             agent_id: String,
-            data: T::Hash[Symbol, T.anything],
+            system_prompt_data: T::Hash[Symbol, T.anything],
             episodic_memory: Cadenya::ObjectiveCreateParams::EpisodicMemory,
-            initial_message: String,
+            first_user_message: String,
+            first_user_message_data: T::Hash[Symbol, T.anything],
             memory_cascade: 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/models/objective_diagnostics.rbi

@@ -0,0 +1,76 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class ObjectiveDiagnostics < Cadenya::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::ObjectiveDiagnostics, Cadenya::Internal::AnyHash)
+        end
+
+      # 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".
+      sig { returns(Integer) }
+      attr_accessor :cached_input_tokens
+
+      # 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.
+      sig { returns(Cadenya::ContextLengths) }
+      attr_reader :context_lengths
+
+      sig { params(context_lengths: Cadenya::ContextLengths::OrHash).void }
+      attr_writer :context_lengths
+
+      # Input tokens reported by the LLM provider for the iteration's completion.
+      sig { returns(Integer) }
+      attr_accessor :input_tokens
+
+      # 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.
+      sig do
+        params(
+          cached_input_tokens: Integer,
+          context_lengths: Cadenya::ContextLengths::OrHash,
+          input_tokens: Integer
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # 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".
+        cached_input_tokens:,
+        # 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.
+        context_lengths:,
+        # Input tokens reported by the LLM provider for the iteration's completion.
+        input_tokens:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            cached_input_tokens: Integer,
+            context_lengths: Cadenya::ContextLengths,
+            input_tokens: Integer
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/objective_retrieve_diagnostics_params.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class ObjectiveRetrieveDiagnosticsParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Cadenya::ObjectiveRetrieveDiagnosticsParams,
+            Cadenya::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :workspace_id
+
+      sig { returns(String) }
+      attr_accessor :objective_id
+
+      sig do
+        params(
+          workspace_id: String,
+          objective_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(workspace_id:, objective_id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          {
+            workspace_id: String,
+            objective_id: String,
+            request_options: Cadenya::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/objective_retrieve_diagnostics_response.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class ObjectiveRetrieveDiagnosticsResponse < Cadenya::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Cadenya::Models::ObjectiveRetrieveDiagnosticsResponse,
+            Cadenya::Internal::AnyHash
+          )
+        end
+
+      # 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.
+      sig { returns(Cadenya::ObjectiveDiagnostics) }
+      attr_reader :diagnostics
+
+      sig { params(diagnostics: Cadenya::ObjectiveDiagnostics::OrHash).void }
+      attr_writer :diagnostics
+
+      sig do
+        params(diagnostics: Cadenya::ObjectiveDiagnostics::OrHash).returns(
+          T.attached_class
+        )
+      end
+      def self.new(
+        # 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.
+        diagnostics:
+      )
+      end
+
+      sig { override.returns({ diagnostics: Cadenya::ObjectiveDiagnostics }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models.rbi

@@ -89,6 +89,8 @@ module Cadenya
 
   CallableTool = Cadenya::Models::CallableTool
 
+  ContextLengths = Cadenya::Models::ContextLengths
+
   ContextWindowCompacted = Cadenya::Models::ContextWindowCompacted
 
   CreateOperationMetadata = Cadenya::Models::CreateOperationMetadata
@@ -147,6 +149,8 @@ module Cadenya
 
   ObjectiveCreateParams = Cadenya::Models::ObjectiveCreateParams
 
+  ObjectiveDiagnostics = Cadenya::Models::ObjectiveDiagnostics
+
   ObjectiveError = Cadenya::Models::ObjectiveError
 
   ObjectiveEvent = Cadenya::Models::ObjectiveEvent
@@ -166,6 +170,9 @@ module Cadenya
 
   ObjectiveListParams = Cadenya::Models::ObjectiveListParams
 
+  ObjectiveRetrieveDiagnosticsParams =
+    Cadenya::Models::ObjectiveRetrieveDiagnosticsParams
+
   ObjectiveRetrieveParams = Cadenya::Models::ObjectiveRetrieveParams
 
   Objectives = Cadenya::Models::Objectives

data/rbi/cadenya/resources/objectives.rbi

@@ -20,14 +20,14 @@ module Cadenya
         params(
           workspace_id: String,
           agent_id: String,
-          data: T::Hash[Symbol, T.anything],
+          system_prompt_data: T::Hash[Symbol, T.anything],
           episodic_memory:
             Cadenya::ObjectiveCreateParams::EpisodicMemory::OrHash,
-          initial_message: String,
+          first_user_message: String,
+          first_user_message_data: T::Hash[Symbol, T.anything],
           memory_cascade: 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,17 +35,22 @@ module Cadenya
       def create(
         workspace_id,
         agent_id:,
-        # Arbitrary data for the objective. May be used in liquid templates for prompts
-        # configured on the agent variation
-        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.
+        system_prompt_data:,
         # Episodic is used to configure the episodic memory for the objective
         episodic_memory: nil,
-        # 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
+        # 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.
-        initial_message: nil,
+        first_user_message: nil,
+        # 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.
+        first_user_message_data: nil,
         # Memory layers/entries layered over the baseline cascade inherited from the
         # selected variation — element-level rules over inherited styles, in CSS terms.
         #
@@ -67,10 +72,6 @@ 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,
@@ -266,6 +267,25 @@ module Cadenya
       )
       end
 
+      # Returns the context-usage breakdown measured for the objective's most recent
+      # iteration: character lengths per context component (system prompt, memory
+      # appendices, tool definitions, messages by role) alongside the iteration's input
+      # token counts.
+      sig do
+        params(
+          objective_id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Models::ObjectiveRetrieveDiagnosticsResponse)
+      end
+      def retrieve_diagnostics(
+        # The ID of the objective. Supports "external_id:" prefix for external IDs.
+        objective_id,
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
       # Streams events for an objective in real-time using server-sent events (SSE)
       sig do
         params(

data/sig/cadenya/models/agent_spec.rbs

@@ -6,8 +6,8 @@ module Cadenya
         description: String,
         enable_episodic_memory: bool,
         episodic_memory_ttl: Integer,
-        input_data_schema: ::Hash[Symbol, top],
         output_definition: ::Hash[Symbol, top],
+        system_prompt_data_schema: ::Hash[Symbol, top],
         webhook_events_url: String
       }
 
@@ -26,14 +26,16 @@ module Cadenya
 
       def episodic_memory_ttl=: (Integer) -> Integer
 
-      attr_reader input_data_schema: ::Hash[Symbol, top]?
-
-      def input_data_schema=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
-
       attr_reader output_definition: ::Hash[Symbol, top]?
 
       def output_definition=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
 
+      attr_reader system_prompt_data_schema: ::Hash[Symbol, top]?
+
+      def system_prompt_data_schema=: (
+        ::Hash[Symbol, top]
+      ) -> ::Hash[Symbol, top]
+
       attr_reader webhook_events_url: String?
 
       def webhook_events_url=: (String) -> String
@@ -43,8 +45,8 @@ module Cadenya
         ?description: String,
         ?enable_episodic_memory: bool,
         ?episodic_memory_ttl: Integer,
-        ?input_data_schema: ::Hash[Symbol, top],
         ?output_definition: ::Hash[Symbol, top],
+        ?system_prompt_data_schema: ::Hash[Symbol, top],
         ?webhook_events_url: String
       ) -> void
 
@@ -53,8 +55,8 @@ module Cadenya
         description: String,
         enable_episodic_memory: bool,
         episodic_memory_ttl: Integer,
-        input_data_schema: ::Hash[Symbol, top],
         output_definition: ::Hash[Symbol, top],
+        system_prompt_data_schema: ::Hash[Symbol, top],
         webhook_events_url: String
       }
 

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

@@ -6,23 +6,23 @@ module Cadenya
       type agent_schedule_spec =
         {
           schedule: Cadenya::Agents::AgentScheduleSpecSchedule,
-          data: top,
-          initial_message: String,
+          first_user_message: String,
+          first_user_message_data: top,
           overlap_policy: Cadenya::Models::Agents::AgentScheduleSpec::overlap_policy,
-          user_data: top,
+          system_prompt_data: top,
           variation_id: String
         }
 
       class AgentScheduleSpec < Cadenya::Internal::Type::BaseModel
         attr_accessor schedule: Cadenya::Agents::AgentScheduleSpecSchedule
 
-        attr_reader data: top?
+        attr_reader first_user_message: String?
 
-        def data=: (top) -> top
+        def first_user_message=: (String) -> String
 
-        attr_reader initial_message: String?
+        attr_reader first_user_message_data: top?
 
-        def initial_message=: (String) -> String
+        def first_user_message_data=: (top) -> top
 
         attr_reader overlap_policy: Cadenya::Models::Agents::AgentScheduleSpec::overlap_policy?
 
@@ -30,9 +30,9 @@ module Cadenya
           Cadenya::Models::Agents::AgentScheduleSpec::overlap_policy
         ) -> Cadenya::Models::Agents::AgentScheduleSpec::overlap_policy
 
-        attr_reader user_data: top?
+        attr_reader system_prompt_data: top?
 
-        def user_data=: (top) -> top
+        def system_prompt_data=: (top) -> top
 
         attr_reader variation_id: String?
 
@@ -40,19 +40,19 @@ module Cadenya
 
         def initialize: (
           schedule: Cadenya::Agents::AgentScheduleSpecSchedule,
-          ?data: top,
-          ?initial_message: String,
+          ?first_user_message: String,
+          ?first_user_message_data: top,
           ?overlap_policy: Cadenya::Models::Agents::AgentScheduleSpec::overlap_policy,
-          ?user_data: top,
+          ?system_prompt_data: top,
           ?variation_id: String
         ) -> void
 
         def to_hash: -> {
           schedule: Cadenya::Agents::AgentScheduleSpecSchedule,
-          data: top,
-          initial_message: String,
+          first_user_message: String,
+          first_user_message_data: top,
           overlap_policy: Cadenya::Models::Agents::AgentScheduleSpec::overlap_policy,
-          user_data: top,
+          system_prompt_data: top,
           variation_id: String
         }