cadenya 0.8.0 → 0.10.0

data/lib/cadenya/models/bulk_workspace_apply_data.rb

@@ -19,14 +19,13 @@ module Cadenya
       optional :agents, -> { Cadenya::Internal::Type::HashOf[Cadenya::AgentEntry] }
 
       # @!attribute automatically_publish_agents
-      #   When true, every agent created or updated by this Apply has its status forced to
-      #   AGENT_STATUS_PUBLISHED, regardless of the status declared in the agent's
-      #   AgentSpec. Useful when the bundle represents a production configuration and you
-      #   want all of its agents live without setting status: AGENT_STATUS_PUBLISHED on
-      #   each entry.
+      #   When true, every agent created or updated by this Apply has its state forced to
+      #   STATE_PUBLISHED, regardless of the state declared on the agent's entry. Useful
+      #   when the bundle represents a production configuration and you want all of its
+      #   agents live without setting state: STATE_PUBLISHED on each entry.
       #
-      #   Default false: each agent's AgentSpec.status controls (which is
-      #   AGENT_STATUS_DRAFT on create when unspecified).
+      #   Default false: each agent entry's `state` controls (which is STATE_DRAFT on
+      #   create when unspecified).
       #
       #   @return [Boolean, nil]
       optional :automatically_publish_agents,

data/lib/cadenya/models/model.rb

@@ -17,6 +17,13 @@ module Cadenya
       required :spec, -> { Cadenya::ModelSpec }
 
       response_only do
+        # @!attribute state
+        #   Whether the model is usable in this workspace. Output only. Use the :enable and
+        #   :disable actions to transition.
+        #
+        #   @return [Symbol, Cadenya::Models::Model::State]
+        required :state, enum: -> { Cadenya::Model::State }
+
         # @!attribute info
         #   ModelInfo carries server-derived, read-only details about a model.
         #
@@ -24,7 +31,7 @@ module Cadenya
         optional :info, -> { Cadenya::Model::Info }
       end
 
-      # @!method initialize(metadata:, spec:, info: nil)
+      # @!method initialize(metadata:, spec:, state:, info: nil)
       #   Some parameter documentations has been truncated, see {Cadenya::Models::Model}
       #   for more details.
       #
@@ -32,8 +39,25 @@ module Cadenya
       #
       #   @param spec [Cadenya::Models::ModelSpec] Model specification
       #
+      #   @param state [Symbol, Cadenya::Models::Model::State] Whether the model is usable in this workspace. Output only. Use the
+      #
       #   @param info [Cadenya::Models::Model::Info] ModelInfo carries server-derived, read-only details about a model.
 
+      # Whether the model is usable in this workspace. Output only. Use the :enable and
+      # :disable actions to transition.
+      #
+      # @see Cadenya::Models::Model#state
+      module State
+        extend Cadenya::Internal::Type::Enum
+
+        STATE_UNSPECIFIED = :STATE_UNSPECIFIED
+        STATE_ENABLED = :STATE_ENABLED
+        STATE_DISABLED = :STATE_DISABLED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
       # @see Cadenya::Models::Model#info
       class Info < Cadenya::Internal::Type::BaseModel
         response_only do

data/lib/cadenya/models/model_disable_params.rb

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

data/lib/cadenya/models/model_enable_params.rb

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

data/lib/cadenya/models/model_list_params.rb

@@ -62,13 +62,13 @@ module Cadenya
       #   @return [String, nil]
       optional :sort_order, String
 
-      # @!attribute status
-      #   Filter by model status
+      # @!attribute state
+      #   Filter by model state
       #
-      #   @return [Symbol, Cadenya::Models::ModelListParams::Status, nil]
-      optional :status, enum: -> { Cadenya::ModelListParams::Status }
+      #   @return [Symbol, Cadenya::Models::ModelListParams::State, nil]
+      optional :state, enum: -> { Cadenya::ModelListParams::State }
 
-      # @!method initialize(workspace_id:, ai_provider_key_id: nil, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, status: nil, request_options: {})
+      # @!method initialize(workspace_id:, ai_provider_key_id: nil, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, state: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ModelListParams} for more details.
       #
@@ -90,17 +90,17 @@ module Cadenya
       #
       #   @param sort_order [String] Sort order for results (asc or desc by creation time)
       #
-      #   @param status [Symbol, Cadenya::Models::ModelListParams::Status] Filter by model status
+      #   @param state [Symbol, Cadenya::Models::ModelListParams::State] Filter by model state
       #
       #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
 
-      # Filter by model status
-      module Status
+      # Filter by model state
+      module State
         extend Cadenya::Internal::Type::Enum
 
-        MODEL_STATUS_UNSPECIFIED = :MODEL_STATUS_UNSPECIFIED
-        MODEL_STATUS_ENABLED = :MODEL_STATUS_ENABLED
-        MODEL_STATUS_DISABLED = :MODEL_STATUS_DISABLED
+        STATE_UNSPECIFIED = :STATE_UNSPECIFIED
+        STATE_ENABLED = :STATE_ENABLED
+        STATE_DISABLED = :STATE_DISABLED
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/cadenya/models/model_spec.rb

@@ -39,13 +39,7 @@ module Cadenya
       #   @return [String, nil]
       optional :provider, String
 
-      # @!attribute status
-      #   The status of the model in the workspace
-      #
-      #   @return [Symbol, Cadenya::Models::ModelSpec::Status, nil]
-      optional :status, enum: -> { Cadenya::ModelSpec::Status }
-
-      # @!method initialize(family: nil, input_price_per_million_tokens: nil, max_input_tokens: nil, max_output_tokens: nil, output_price_per_million_tokens: nil, provider: nil, status: nil)
+      # @!method initialize(family: nil, input_price_per_million_tokens: nil, max_input_tokens: nil, max_output_tokens: nil, output_price_per_million_tokens: nil, provider: nil)
       #   @param family [String] The model family (e.g., "claude-sonnet-4.6", "gpt-5.4", "gemini-2.5-flash")
       #
       #   @param input_price_per_million_tokens [String] Cost per million input tokens in cents (e.g., 300 = $3.00)
@@ -57,22 +51,6 @@ module Cadenya
       #   @param output_price_per_million_tokens [String] Cost per million output tokens in cents (e.g., 1500 = $15.00)
       #
       #   @param provider [String] The model provider (e.g., "anthropic", "openai", "google")
-      #
-      #   @param status [Symbol, Cadenya::Models::ModelSpec::Status] The status of the model in the workspace
-
-      # The status of the model in the workspace
-      #
-      # @see Cadenya::Models::ModelSpec#status
-      module Status
-        extend Cadenya::Internal::Type::Enum
-
-        MODEL_STATUS_UNSPECIFIED = :MODEL_STATUS_UNSPECIFIED
-        MODEL_STATUS_ENABLED = :MODEL_STATUS_ENABLED
-        MODEL_STATUS_DISABLED = :MODEL_STATUS_DISABLED
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
     end
   end
 end

data/lib/cadenya/models/objective.rb

@@ -4,10 +4,12 @@ module Cadenya
   module Models
     # @see Cadenya::Resources::Objectives#create
     class Objective < Cadenya::Internal::Type::BaseModel
-      # @!attribute data
+      # @!attribute initial_message
+      #   The initial message sent to the agent. This becomes the first user message in
+      #   the LLM chat history.
       #
-      #   @return [Cadenya::Models::ObjectiveData]
-      required :data, -> { Cadenya::ObjectiveData }
+      #   @return [String]
+      required :initial_message, String, api_name: :initialMessage
 
       # @!attribute metadata
       #   Metadata for ephemeral operations and activities (e.g., objectives, executions,
@@ -16,12 +18,61 @@ module Cadenya
       #   @return [Cadenya::Models::OperationMetadata]
       required :metadata, -> { Cadenya::OperationMetadata }
 
-      # @!attribute status
+      # @!attribute memory_stack
+      #   Memory layers/entries to push onto this objective's memory stack on top of the
+      #   baseline stack inherited from the selected variation.
       #
-      #   @return [Cadenya::Models::ObjectiveStatus]
-      required :status, -> { Cadenya::ObjectiveStatus }
+      #   Array order is push order: the first element sits lower in the objective's
+      #   contribution to the stack; the LAST element ends up on top of the effective
+      #   stack. Entries pinned via memory_entry_id behave as single-entry layers at their
+      #   position.
+      #
+      #   System-managed layers (e.g., episodic) cannot be referenced here; they attach
+      #   themselves automatically based on episodic_key.
+      #
+      #   Stack size cap: the TOTAL effective stack (variation's memory layers
+      #
+      #   - this field) must not exceed 10 entries. A request that would produce an
+      #     effective stack larger than 10 is rejected with InvalidArgument.
+      #
+      #   @return [Array<Cadenya::Models::MemoryReference>, nil]
+      optional :memory_stack,
+               -> { Cadenya::Internal::Type::ArrayOf[Cadenya::MemoryReference] },
+               api_name: :memoryStack
+
+      # @!attribute secrets
+      #   Secrets that can be used in the headers for tool calls using the secret
+      #   interpolation format.
+      #
+      #   @return [Array<Cadenya::Models::ObjectiveSecret>, nil]
+      optional :secrets, -> { Cadenya::Internal::Type::ArrayOf[Cadenya::ObjectiveSecret] }
 
       response_only do
+        # @!attribute config_snapshot
+        #   ObjectiveConfigSnapshot is the point-in-time snapshot of the agent, variation,
+        #   and (when applicable) schedule that an objective was started with.
+        #
+        #   @return [Cadenya::Models::ObjectiveConfigSnapshot]
+        required :config_snapshot, -> { Cadenya::ObjectiveConfigSnapshot }, api_name: :configSnapshot
+
+        # @!attribute state
+        #   The current lifecycle state of the objective.
+        #
+        #   @return [Symbol, Cadenya::Models::Objective::State]
+        required :state, enum: -> { Cadenya::Objective::State }
+
+        # @!attribute system_prompt
+        #   system_prompt is read-only, derived from the selected variation's prompt
+        #
+        #   @return [String]
+        required :system_prompt, String, api_name: :systemPrompt
+
+        # @!attribute data
+        #   Arbitrary data for the objective
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :data, Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown]
+
         # @!attribute info
         #   ObjectiveInfo provides read-only aggregated statistics about an objective's
         #   execution
@@ -29,30 +80,77 @@ module Cadenya
         #   @return [Cadenya::Models::ObjectiveInfo, nil]
         optional :info, -> { Cadenya::ObjectiveInfo }
 
-        # @!attribute last_five_windows
-        #   Read-only list of the last five windows of execution for this objective, ordered
-        #   by most recent first. Is only included in singular RPC calls (GetObjective, for
-        #   example).
+        # @!attribute output
+        #   The output of the objective, populated when the objective completes. Will match
+        #   the schema of output_json_schema or output_json_inferred. This will only be set
+        #   if the state of the objective is set to STATE_FINALIZED
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :output, Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown]
+
+        # @!attribute parent_objective_id
+        #   A parent objective means the objective was spawned off using a separate agent to
+        #   complete an objective
         #
-        #   @return [Array<Cadenya::Models::ObjectiveContextWindow>, nil]
-        optional :last_five_windows,
-                 -> { Cadenya::Internal::Type::ArrayOf[Cadenya::ObjectiveContextWindow] },
-                 api_name: :lastFiveWindows
+        #   @return [String, nil]
+        optional :parent_objective_id, String, api_name: :parentObjectiveId
+
+        # @!attribute state_message
+        #   Optional human-readable detail about the current state (e.g. a failure reason).
+        #
+        #   @return [String, nil]
+        optional :state_message, String, api_name: :stateMessage
       end
 
-      # @!method initialize(data:, metadata:, status:, info: nil, last_five_windows: nil)
+      # @!method initialize(config_snapshot:, initial_message:, metadata:, state:, system_prompt:, data: nil, info: nil, memory_stack: nil, output: nil, parent_objective_id: nil, secrets: nil, state_message: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::Objective} for more details.
       #
-      #   @param data [Cadenya::Models::ObjectiveData]
+      #   Objective is the data for an objective. It contains the snapshotted fields for
+      #   the selected agent and variation. Secrets are returned only with their names,
+      #   and the output definition is copied from the agent's configuration.
+      #
+      #   @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 metadata [Cadenya::Models::OperationMetadata] Metadata for ephemeral operations and activities (e.g., objectives, executions,
       #
-      #   @param status [Cadenya::Models::ObjectiveStatus]
+      #   @param state [Symbol, Cadenya::Models::Objective::State] The current lifecycle state of the objective.
+      #
+      #   @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 info [Cadenya::Models::ObjectiveInfo] ObjectiveInfo provides read-only aggregated statistics about an objective's exec
       #
-      #   @param last_five_windows [Array<Cadenya::Models::ObjectiveContextWindow>] Read-only list of the last five windows of execution for this objective, ordered
+      #   @param memory_stack [Array<Cadenya::Models::MemoryReference>] Memory layers/entries to push onto this objective's memory stack on
+      #
+      #   @param output [Hash{Symbol=>Object}] The output of the objective, populated when the objective completes. Will match
+      #
+      #   @param parent_objective_id [String] A parent objective means the objective was spawned off using a separate agent to
+      #
+      #   @param secrets [Array<Cadenya::Models::ObjectiveSecret>] Secrets that can be used in the headers for tool calls using the secret interpol
+      #
+      #   @param state_message [String] Optional human-readable detail about the current state (e.g. a failure reason).
+
+      # The current lifecycle state of the objective.
+      #
+      # @see Cadenya::Models::Objective#state
+      module State
+        extend Cadenya::Internal::Type::Enum
+
+        STATE_UNSPECIFIED = :STATE_UNSPECIFIED
+        STATE_PENDING = :STATE_PENDING
+        STATE_RUNNING = :STATE_RUNNING
+        STATE_WAITING = :STATE_WAITING
+        STATE_FAILED = :STATE_FAILED
+        STATE_CANCELLED = :STATE_CANCELLED
+        STATE_FINALIZED = :STATE_FINALIZED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/cadenya/models/objective_config_snapshot.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ObjectiveConfigSnapshot < Cadenya::Internal::Type::BaseModel
+      # @!attribute agent
+      #   Agent resource
+      #
+      #   @return [Cadenya::Models::Agent, nil]
+      optional :agent, -> { Cadenya::Agent }
+
+      # @!attribute agent_schedule
+      #   AgentSchedule resource — a recurring trigger attached to an agent that creates
+      #   objectives on its cadence.
+      #
+      #   @return [Cadenya::Models::Agents::AgentSchedule, nil]
+      optional :agent_schedule, -> { Cadenya::Agents::AgentSchedule }, api_name: :agentSchedule
+
+      # @!attribute agent_variation
+      #   AgentVariation resource
+      #
+      #   @return [Cadenya::Models::Agents::AgentVariation, nil]
+      optional :agent_variation, -> { Cadenya::Agents::AgentVariation }, api_name: :agentVariation
+
+      # @!method initialize(agent: nil, agent_schedule: nil, agent_variation: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ObjectiveConfigSnapshot} for more details.
+      #
+      #   ObjectiveConfigSnapshot is the point-in-time snapshot of the agent, variation,
+      #   and (when applicable) schedule that an objective was started with.
+      #
+      #   @param agent [Cadenya::Models::Agent] Agent resource
+      #
+      #   @param agent_schedule [Cadenya::Models::Agents::AgentSchedule] AgentSchedule resource — a recurring trigger attached to an agent that
+      #
+      #   @param agent_variation [Cadenya::Models::Agents::AgentVariation] AgentVariation resource
+    end
+  end
+end

data/lib/cadenya/models/objective_create_params.rb

@@ -18,9 +18,41 @@ module Cadenya
       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
       #
-      #   @return [Cadenya::Models::ObjectiveData]
-      required :data, -> { Cadenya::ObjectiveData }
+      #   @return [Hash{Symbol=>Object}]
+      required :data, Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown]
+
+      # @!attribute initial_message
+      #   Optional override for initial message sent to the agent. This becomes the first
+      #   user message in the LLM chat history. The agent variation is used to set this if
+      #   not present.
+      #
+      #   @return [String, nil]
+      optional :initial_message, String, api_name: :initialMessage
+
+      # @!attribute memory_stack
+      #   Memory layers/entries to push onto this objective's memory stack on top of the
+      #   baseline stack inherited from the selected variation.
+      #
+      #   Array order is push order: the first element sits lower in the objective's
+      #   contribution to the stack; the LAST element ends up on top of the effective
+      #   stack. Entries pinned via memory_entry_id behave as single-entry layers at their
+      #   position.
+      #
+      #   System-managed layers (e.g., episodic) cannot be referenced here; they attach
+      #   themselves automatically based on episodic_key.
+      #
+      #   Stack size cap: the TOTAL effective stack (variation's memory layers
+      #
+      #   - this field) must not exceed 10 entries. A request that would produce an
+      #     effective stack larger than 10 is rejected with InvalidArgument.
+      #
+      #   @return [Array<Cadenya::Models::MemoryReference>, nil]
+      optional :memory_stack,
+               -> { Cadenya::Internal::Type::ArrayOf[Cadenya::MemoryReference] },
+               api_name: :memoryStack
 
       # @!attribute metadata
       #   CreateOperationMetadata contains the user-provided fields for creating an
@@ -30,6 +62,13 @@ module Cadenya
       #   @return [Cadenya::Models::CreateOperationMetadata, nil]
       optional :metadata, -> { Cadenya::CreateOperationMetadata }
 
+      # @!attribute secrets
+      #   Secrets that can be used in the headers for tool calls using the secret
+      #   interpolation format.
+      #
+      #   @return [Array<Cadenya::Models::ObjectiveCreateParams::Secret>, nil]
+      optional :secrets, -> { Cadenya::Internal::Type::ArrayOf[Cadenya::ObjectiveCreateParams::Secret] }
+
       # @!attribute variation_id
       #   Optional explicit variation selection. Overrides the agent's
       #   variation_selection_mode.
@@ -37,7 +76,7 @@ module Cadenya
       #   @return [String, nil]
       optional :variation_id, String, api_name: :variationId
 
-      # @!method initialize(workspace_id:, agent_id:, data:, metadata: nil, variation_id: nil, request_options: {})
+      # @!method initialize(workspace_id:, agent_id:, data:, initial_message: nil, memory_stack: nil, metadata: nil, secrets: nil, variation_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ObjectiveCreateParams} for more details.
       #
@@ -45,13 +84,35 @@ module Cadenya
       #
       #   @param agent_id [String]
       #
-      #   @param data [Cadenya::Models::ObjectiveData]
+      #   @param data [Hash{Symbol=>Object}] Arbitrary data for the objective. May be used in liquid templates for prompts co
+      #
+      #   @param initial_message [String] Optional override for initial message sent to the agent. This becomes the first
+      #
+      #   @param memory_stack [Array<Cadenya::Models::MemoryReference>] Memory layers/entries to push onto this objective's memory stack on
       #
       #   @param metadata [Cadenya::Models::CreateOperationMetadata] CreateOperationMetadata contains the user-provided fields for creating
       #
+      #   @param secrets [Array<Cadenya::Models::ObjectiveCreateParams::Secret>] Secrets that can be used in the headers for tool calls using the secret interpol
+      #
       #   @param variation_id [String] Optional explicit variation selection. Overrides the agent's variation_selection
       #
       #   @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_info.rb

@@ -3,72 +3,84 @@
 module Cadenya
   module Models
     class ObjectiveInfo < Cadenya::Internal::Type::BaseModel
-      # @!attribute agent
-      #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-      #
-      #   @return [Cadenya::Models::ResourceMetadata, nil]
-      optional :agent, -> { Cadenya::ResourceMetadata }
-
-      # @!attribute agent_variation
-      #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-      #
-      #   @return [Cadenya::Models::ResourceMetadata, nil]
-      optional :agent_variation, -> { Cadenya::ResourceMetadata }, api_name: :agentVariation
-
       # @!attribute created_by
       #   A profile identifies a user or non-human principal (such as an API key) at the
       #   account level. Profiles are account-scoped and can be granted access to multiple
       #   workspaces.
       #
-      #   @return [Cadenya::Models::Profile, nil]
-      optional :created_by, -> { Cadenya::Profile }, api_name: :createdBy
+      #   @return [Cadenya::Models::Profile]
+      required :created_by, -> { Cadenya::Profile }, api_name: :createdBy
 
       response_only do
+        # @!attribute agent
+        #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        #
+        #   @return [Cadenya::Models::ResourceMetadata]
+        required :agent, -> { Cadenya::ResourceMetadata }
+
+        # @!attribute agent_variation
+        #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        #
+        #   @return [Cadenya::Models::ResourceMetadata]
+        required :agent_variation, -> { Cadenya::ResourceMetadata }, api_name: :agentVariation
+
+        # @!attribute current_context_window_id
+        #   ID of the objective's current (most recent) context window. Hydrated on demand;
+        #   empty when the objective has not yet produced a context window.
+        #
+        #   @return [String]
+        required :current_context_window_id, String, api_name: :currentContextWindowId
+
         # @!attribute effective_memory_stack
         #   The effective memory stack at objective creation time, flattened from the
-        #   variation's baseline plus ObjectiveData.memory_stack. Order is push order (last
-        #   = top). Returned on reads so clients can see exactly what stack the objective is
+        #   variation's baseline plus Objective.memory_stack. Order is push order (last =
+        #   top). Returned on reads so clients can see exactly what stack the objective is
         #   using without having to re-join variation state.
         #
-        #   @return [Array<Cadenya::Models::MemoryReference>, nil]
-        optional :effective_memory_stack,
+        #   @return [Array<Cadenya::Models::MemoryReference>]
+        required :effective_memory_stack,
                  -> { Cadenya::Internal::Type::ArrayOf[Cadenya::MemoryReference] },
                  api_name: :effectiveMemoryStack
 
         # @!attribute total_context_windows
         #   Total number of context windows that this objective has generated
         #
-        #   @return [Integer, nil]
-        optional :total_context_windows, Integer, api_name: :totalContextWindows
+        #   @return [Integer]
+        required :total_context_windows, Integer, api_name: :totalContextWindows
 
         # @!attribute total_events
         #   Total number of events generated during this objective's execution
         #
-        #   @return [Integer, nil]
-        optional :total_events, Integer, api_name: :totalEvents
+        #   @return [Integer]
+        required :total_events, Integer, api_name: :totalEvents
 
         # @!attribute total_input_tokens
         #   Total input tokens consumed across all LLM completions across all context
         #   windows
         #
-        #   @return [Integer, nil]
-        optional :total_input_tokens, Integer, api_name: :totalInputTokens
+        #   @return [Integer]
+        required :total_input_tokens, Integer, api_name: :totalInputTokens
+
+        # @!attribute total_iterations
+        #
+        #   @return [Integer]
+        required :total_iterations, Integer, api_name: :totalIterations
 
         # @!attribute total_output_tokens
         #   Total output tokens generated across all LLM completions across all context
         #   windows
         #
-        #   @return [Integer, nil]
-        optional :total_output_tokens, Integer, api_name: :totalOutputTokens
+        #   @return [Integer]
+        required :total_output_tokens, Integer, api_name: :totalOutputTokens
 
         # @!attribute total_tool_calls
         #   Total number of tool calls made during execution
         #
-        #   @return [Integer, nil]
-        optional :total_tool_calls, Integer, api_name: :totalToolCalls
+        #   @return [Integer]
+        required :total_tool_calls, Integer, api_name: :totalToolCalls
       end
 
-      # @!method initialize(agent: nil, agent_variation: nil, created_by: nil, effective_memory_stack: nil, total_context_windows: nil, total_events: nil, total_input_tokens: nil, total_output_tokens: nil, total_tool_calls: nil)
+      # @!method initialize(agent:, agent_variation:, created_by:, current_context_window_id:, effective_memory_stack:, total_context_windows:, total_events:, total_input_tokens:, total_iterations:, total_output_tokens:, total_tool_calls:)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ObjectiveInfo} for more details.
       #
@@ -81,6 +93,8 @@ module Cadenya
       #
       #   @param created_by [Cadenya::Models::Profile] A profile identifies a user or non-human principal (such as an API key)
       #
+      #   @param current_context_window_id [String] ID of the objective's current (most recent) context window. Hydrated on
+      #
       #   @param effective_memory_stack [Array<Cadenya::Models::MemoryReference>] The effective memory stack at objective creation time, flattened
       #
       #   @param total_context_windows [Integer] Total number of context windows that this objective has generated
@@ -89,6 +103,8 @@ module Cadenya
       #
       #   @param total_input_tokens [Integer] Total input tokens consumed across all LLM completions across all context window
       #
+      #   @param total_iterations [Integer]
+      #
       #   @param total_output_tokens [Integer] Total output tokens generated across all LLM completions across all context wind
       #
       #   @param total_tool_calls [Integer] Total number of tool calls made during execution