cadenya 0.26.0 → 0.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c9e5f872c6b3d400630fe4c6ff1429e78b994dc389ab7e610a0b6d208837ac0b
-  data.tar.gz: 8fab533c3fac313a45a7458b0c27d4d4be58bb8f27c0a33d8783a48ec246690f
+  metadata.gz: bf555cd84ae5279087a5b60695fec05f03451abbb21cc910c5e85cb1ed52c56e
+  data.tar.gz: b7662e178b9f76f9e044bdff89f57bb78a75fd58ef92c9f7ac4c75ed45aef3a6
 SHA512:
-  metadata.gz: 5edd2c17b031c2044ab6dc3ffe5a94585c6f2860511951bd9721c546571287c176f25cd10648bb008385f989611d86f998dc560250267fb3bc0ba1425ba5579d
-  data.tar.gz: f593a86264bf46b5ff61d546e63e93926bc2850ef10d6d8bc82f906c2ce587b03455bdf62d755a1a66f39a6d715383f0374668dd73f5e525e1d79850fcdaf9bc
+  metadata.gz: eb71eb5d8238a2f9d63ceadf1ebd77230fbed22f146eada9da0abeb2b578128646b6bbe3feaaf4cc179d5e894cd9c94ab96f413cbf63cbf72ebe94e1b6d42c66
+  data.tar.gz: 4bb21c37969a3c091aa854523f4e45e323ad513f299b384978befb9d975ad442b0ad24c0c064ae1ff41ec9b1cb781c92ce1bd744531504707ec912e79a4f800c

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # 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)
+
+### Features
+
+* **api:** api update ([f407d32](https://github.com/cadenya/cadenya-ruby/commit/f407d328b0177f7048eb6d2a90916bd98351d3d3))
+
 ## 0.26.0 (2026-07-02)
 
 Full Changelog: [v0.25.0...v0.26.0](https://github.com/cadenya/cadenya-ruby/compare/v0.25.0...v0.26.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.26.0"
+gem "cadenya", "~> 0.28.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/cadenya/models/account_info.rb

@@ -4,6 +4,16 @@ module Cadenya
   module Models
     class AccountInfo < Cadenya::Internal::Type::BaseModel
       response_only do
+        # @!attribute challenge_token
+        #   The challenge token Cadenya sends in the X-Cadenya-Challenge-Token header on
+        #   every MCP tools/list request. Server implementations can accept a valid
+        #   challenge token in place of per-user auth when listing tools, while still
+        #   requiring real auth on tools/call. Rotate with RotateChallengeToken; update any
+        #   servers validating the token before rotating.
+        #
+        #   @return [String, nil]
+        optional :challenge_token, String, api_name: :challengeToken
+
         # @!attribute global_api_key
         #   An API key for the account. Use workspace-association RPCs to grant the key
         #   access to specific workspaces; a key with zero workspaces is valid but cannot
@@ -21,12 +31,14 @@ module Cadenya
         optional :webhook_events_hmac_secret, String, api_name: :webhookEventsHmacSecret
       end
 
-      # @!method initialize(global_api_key: nil, webhook_events_hmac_secret: nil)
+      # @!method initialize(challenge_token: nil, global_api_key: nil, webhook_events_hmac_secret: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::AccountInfo} for more details.
       #
       #   Server-populated information about the account.
       #
+      #   @param challenge_token [String] The challenge token Cadenya sends in the X-Cadenya-Challenge-Token header
+      #
       #   @param global_api_key [Cadenya::Models::APIKey] An API key for the account. Use workspace-association RPCs to grant the
       #
       #   @param webhook_events_hmac_secret [String] The generated secret that will sign all webhooks that are sent to your configure

data/lib/cadenya/models/account_rotate_challenge_token_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Account#rotate_challenge_token
+    class AccountRotateChallengeTokenParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+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/agents/webhook_delivery_data.rb

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

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

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

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_continue_params.rb

@@ -30,14 +30,7 @@ module Cadenya
       #   @return [String, nil]
       optional :message, String
 
-      # @!attribute secrets
-      #   Secrets that should be included with the message. Helpful for when you need to
-      #   update secrets on the objective (IE: A secret expires and needs to be refreshed)
-      #
-      #   @return [Array<Cadenya::Models::ObjectiveContinueParams::Secret>, nil]
-      optional :secrets, -> { Cadenya::Internal::Type::ArrayOf[Cadenya::ObjectiveContinueParams::Secret] }
-
-      # @!method initialize(workspace_id:, objective_id:, enqueue: nil, message: nil, secrets: nil, request_options: {})
+      # @!method initialize(workspace_id:, objective_id:, enqueue: nil, message: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ObjectiveContinueParams} for more details.
       #
@@ -49,25 +42,7 @@ module Cadenya
       #
       #   @param message [String] The message to continue an objective that has completed (or you are enqueing)
       #
-      #   @param secrets [Array<Cadenya::Models::ObjectiveContinueParams::Secret>] Secrets that should be included with the message. Helpful for when you need to u
-      #
       #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
-
-      class Secret < Cadenya::Internal::Type::BaseModel
-        # @!attribute name
-        #
-        #   @return [String, nil]
-        optional :name, String
-
-        # @!attribute value
-        #
-        #   @return [String, nil]
-        optional :value, String
-
-        # @!method initialize(name: nil, value: nil)
-        #   @param name [String]
-        #   @param value [String]
-      end
     end
   end
 end

data/lib/cadenya/models/objective_create_params.rb

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

data/lib/cadenya/models/objective_event_data.rb

@@ -44,6 +44,16 @@ module Cadenya
       #   @return [Cadenya::Models::MemoryRead, nil]
       optional :memory_read, -> { Cadenya::MemoryRead }, api_name: :memoryRead
 
+      # @!attribute notice
+      #   Notice is a non-terminal diagnostic emitted by the runtime when something
+      #   noteworthy but non-fatal happens during an objective — for example a
+      #   just-in-time tool set failing to load, or a previously loaded tool being dropped
+      #   because it was archived. Notices carry no structured payload; they exist to make
+      #   the objective timeline self-explanatory.
+      #
+      #   @return [Cadenya::Models::ObjectiveEventData::Notice, nil]
+      optional :notice, -> { Cadenya::ObjectiveEventData::Notice }
+
       # @!attribute sub_agent_spawned
       #
       #   @return [Cadenya::Models::SubAgentSpawned, nil]
@@ -98,7 +108,7 @@ module Cadenya
       #   @return [Cadenya::Models::UserMessage, nil]
       optional :user_message, -> { Cadenya::UserMessage }, api_name: :userMessage
 
-      # @!method initialize(assistant_message: nil, cancelled: nil, context_window_compacted: nil, error: nil, finalized: nil, memory_read: nil, sub_agent_spawned: nil, sub_agent_updated: nil, tool_approval_requested: nil, tool_approved: nil, tool_called: nil, tool_denied: nil, tool_error: nil, tool_result: nil, type: nil, user_message: nil)
+      # @!method initialize(assistant_message: nil, cancelled: nil, context_window_compacted: nil, error: nil, finalized: nil, memory_read: nil, notice: nil, sub_agent_spawned: nil, sub_agent_updated: nil, tool_approval_requested: nil, tool_approved: nil, tool_called: nil, tool_denied: nil, tool_error: nil, tool_result: nil, type: nil, user_message: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ObjectiveEventData} for more details.
       #
@@ -114,6 +124,8 @@ module Cadenya
       #
       #   @param memory_read [Cadenya::Models::MemoryRead] MemoryRead is emitted each time the agent resolves a key against the
       #
+      #   @param notice [Cadenya::Models::ObjectiveEventData::Notice] Notice is a non-terminal diagnostic emitted by the runtime when something
+      #
       #   @param sub_agent_spawned [Cadenya::Models::SubAgentSpawned]
       #
       #   @param sub_agent_updated [Cadenya::Models::SubAgentUpdated]
@@ -175,6 +187,56 @@ module Cadenya
         #
         #   @param output [Object] If the objective was created with an output schema, and the agent
       end
+
+      # @see Cadenya::Models::ObjectiveEventData#notice
+      class Notice < Cadenya::Internal::Type::BaseModel
+        # @!attribute key
+        #   Stable machine-readable identifier for the notice kind (for example
+        #   "tool_set_load_failed", "tool_archived"). Clients can switch on it or use it as
+        #   an i18n key; the message is the English fallback.
+        #
+        #   @return [String, nil]
+        optional :key, String
+
+        # @!attribute level
+        #
+        #   @return [Symbol, Cadenya::Models::ObjectiveEventData::Notice::Level, nil]
+        optional :level, enum: -> { Cadenya::ObjectiveEventData::Notice::Level }
+
+        # @!attribute message
+        #   Human-readable description of what happened.
+        #
+        #   @return [String, nil]
+        optional :message, String
+
+        # @!method initialize(key: nil, level: nil, message: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ObjectiveEventData::Notice} for more details.
+        #
+        #   Notice is a non-terminal diagnostic emitted by the runtime when something
+        #   noteworthy but non-fatal happens during an objective — for example a
+        #   just-in-time tool set failing to load, or a previously loaded tool being dropped
+        #   because it was archived. Notices carry no structured payload; they exist to make
+        #   the objective timeline self-explanatory.
+        #
+        #   @param key [String] Stable machine-readable identifier for the notice kind (for example
+        #
+        #   @param level [Symbol, Cadenya::Models::ObjectiveEventData::Notice::Level]
+        #
+        #   @param message [String] Human-readable description of what happened.
+
+        # @see Cadenya::Models::ObjectiveEventData::Notice#level
+        module Level
+          extend Cadenya::Internal::Type::Enum
+
+          LEVEL_UNSPECIFIED = :LEVEL_UNSPECIFIED
+          LEVEL_INFO = :LEVEL_INFO
+          LEVEL_WARN = :LEVEL_WARN
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
     end
   end
 end