cadenya 0.8.0 → 0.9.0

data/rbi/cadenya/models/objective_info.rbi

@@ -8,79 +8,65 @@ module Cadenya
           T.any(Cadenya::ObjectiveInfo, Cadenya::Internal::AnyHash)
         end
 
+      # 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.
+      sig { returns(Cadenya::Profile) }
+      attr_reader :created_by
+
+      sig { params(created_by: Cadenya::Profile::OrHash).void }
+      attr_writer :created_by
+
       # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-      sig { returns(T.nilable(Cadenya::ResourceMetadata)) }
+      sig { returns(Cadenya::ResourceMetadata) }
       attr_reader :agent
 
       sig { params(agent: Cadenya::ResourceMetadata::OrHash).void }
       attr_writer :agent
 
       # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-      sig { returns(T.nilable(Cadenya::ResourceMetadata)) }
+      sig { returns(Cadenya::ResourceMetadata) }
       attr_reader :agent_variation
 
       sig { params(agent_variation: Cadenya::ResourceMetadata::OrHash).void }
       attr_writer :agent_variation
 
-      # 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.
-      sig { returns(T.nilable(Cadenya::Profile)) }
-      attr_reader :created_by
-
-      sig { params(created_by: Cadenya::Profile::OrHash).void }
-      attr_writer :created_by
+      # ID of the objective's current (most recent) context window. Hydrated on demand;
+      # empty when the objective has not yet produced a context window.
+      sig { returns(String) }
+      attr_accessor :current_context_window_id
 
       # 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.
-      sig { returns(T.nilable(T::Array[Cadenya::MemoryReference])) }
-      attr_reader :effective_memory_stack
-
-      sig do
-        params(
-          effective_memory_stack: T::Array[Cadenya::MemoryReference::OrHash]
-        ).void
-      end
-      attr_writer :effective_memory_stack
+      sig { returns(T::Array[Cadenya::MemoryReference]) }
+      attr_accessor :effective_memory_stack
 
       # Total number of context windows that this objective has generated
-      sig { returns(T.nilable(Integer)) }
-      attr_reader :total_context_windows
-
-      sig { params(total_context_windows: Integer).void }
-      attr_writer :total_context_windows
+      sig { returns(Integer) }
+      attr_accessor :total_context_windows
 
       # Total number of events generated during this objective's execution
-      sig { returns(T.nilable(Integer)) }
-      attr_reader :total_events
-
-      sig { params(total_events: Integer).void }
-      attr_writer :total_events
+      sig { returns(Integer) }
+      attr_accessor :total_events
 
       # Total input tokens consumed across all LLM completions across all context
       # windows
-      sig { returns(T.nilable(Integer)) }
-      attr_reader :total_input_tokens
+      sig { returns(Integer) }
+      attr_accessor :total_input_tokens
 
-      sig { params(total_input_tokens: Integer).void }
-      attr_writer :total_input_tokens
+      sig { returns(Integer) }
+      attr_accessor :total_iterations
 
       # Total output tokens generated across all LLM completions across all context
       # windows
-      sig { returns(T.nilable(Integer)) }
-      attr_reader :total_output_tokens
-
-      sig { params(total_output_tokens: Integer).void }
-      attr_writer :total_output_tokens
+      sig { returns(Integer) }
+      attr_accessor :total_output_tokens
 
       # Total number of tool calls made during execution
-      sig { returns(T.nilable(Integer)) }
-      attr_reader :total_tool_calls
-
-      sig { params(total_tool_calls: Integer).void }
-      attr_writer :total_tool_calls
+      sig { returns(Integer) }
+      attr_accessor :total_tool_calls
 
       # ObjectiveInfo provides read-only aggregated statistics about an objective's
       # execution
@@ -89,40 +75,46 @@ module Cadenya
           agent: Cadenya::ResourceMetadata::OrHash,
           agent_variation: Cadenya::ResourceMetadata::OrHash,
           created_by: Cadenya::Profile::OrHash,
+          current_context_window_id: String,
           effective_memory_stack: T::Array[Cadenya::MemoryReference::OrHash],
           total_context_windows: Integer,
           total_events: Integer,
           total_input_tokens: Integer,
+          total_iterations: Integer,
           total_output_tokens: Integer,
           total_tool_calls: Integer
         ).returns(T.attached_class)
       end
       def self.new(
         # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-        agent: nil,
+        agent:,
         # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-        agent_variation: nil,
+        agent_variation:,
         # 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.
-        created_by: nil,
+        created_by:,
+        # ID of the objective's current (most recent) context window. Hydrated on demand;
+        # empty when the objective has not yet produced a context window.
+        current_context_window_id:,
         # 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.
-        effective_memory_stack: nil,
+        effective_memory_stack:,
         # Total number of context windows that this objective has generated
-        total_context_windows: nil,
+        total_context_windows:,
         # Total number of events generated during this objective's execution
-        total_events: nil,
+        total_events:,
         # Total input tokens consumed across all LLM completions across all context
         # windows
-        total_input_tokens: nil,
+        total_input_tokens:,
+        total_iterations:,
         # Total output tokens generated across all LLM completions across all context
         # windows
-        total_output_tokens: nil,
+        total_output_tokens:,
         # Total number of tool calls made during execution
-        total_tool_calls: nil
+        total_tool_calls:
       )
       end
 
@@ -132,10 +124,12 @@ module Cadenya
             agent: Cadenya::ResourceMetadata,
             agent_variation: Cadenya::ResourceMetadata,
             created_by: Cadenya::Profile,
+            current_context_window_id: String,
             effective_memory_stack: T::Array[Cadenya::MemoryReference],
             total_context_windows: Integer,
             total_events: Integer,
             total_input_tokens: Integer,
+            total_iterations: Integer,
             total_output_tokens: Integer,
             total_tool_calls: Integer
           }

data/rbi/cadenya/models/objective_secret.rbi

@@ -0,0 +1,26 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class ObjectiveSecret < Cadenya::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::ObjectiveSecret, Cadenya::Internal::AnyHash)
+        end
+
+      sig { returns(T.nilable(String)) }
+      attr_reader :name
+
+      sig { params(name: String).void }
+      attr_writer :name
+
+      sig { params(name: String).returns(T.attached_class) }
+      def self.new(name: nil)
+      end
+
+      sig { override.returns({ name: String }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/objectives/objective_tool_call.rbi

@@ -46,20 +46,10 @@ module Cadenya
 
         sig do
           returns(
-            T.nilable(
-              Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol
-            )
+            Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol
           )
         end
-        attr_reader :execution_status
-
-        sig do
-          params(
-            execution_status:
-              Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::OrSymbol
-          ).void
-        end
-        attr_writer :execution_status
+        attr_accessor :execution_status
 
         # ObjectiveToolCall is a record of a tool call made during an objective's
         # execution. Tool calls are mutable — their status changes as they are approved,
@@ -67,21 +57,21 @@ module Cadenya
         sig do
           params(
             data: Cadenya::Objectives::ObjectiveToolCallData::OrHash,
-            metadata: Cadenya::OperationMetadata::OrHash,
-            status: Cadenya::Objectives::ObjectiveToolCall::Status::OrSymbol,
             execution_status:
               Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::OrSymbol,
+            metadata: Cadenya::OperationMetadata::OrHash,
+            status: Cadenya::Objectives::ObjectiveToolCall::Status::OrSymbol,
             info: Cadenya::Objectives::ObjectiveToolCallInfo::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
           data:,
+          execution_status:,
           # Metadata for ephemeral operations and activities (e.g., objectives, executions,
           # runs)
           metadata:,
           # Current status of the tool call
           status:,
-          execution_status: nil,
           info: nil
         )
         end
@@ -90,11 +80,11 @@ module Cadenya
           override.returns(
             {
               data: Cadenya::Objectives::ObjectiveToolCallData,
+              execution_status:
+                Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol,
               metadata: Cadenya::OperationMetadata,
               status:
                 Cadenya::Objectives::ObjectiveToolCall::Status::TaggedSymbol,
-              execution_status:
-                Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol,
               info: Cadenya::Objectives::ObjectiveToolCallInfo
             }
           )
@@ -102,46 +92,48 @@ module Cadenya
         def to_hash
         end
 
-        # Current status of the tool call
-        module Status
+        module ExecutionStatus
           extend Cadenya::Internal::Type::Enum
 
           TaggedSymbol =
             T.type_alias do
-              T.all(Symbol, Cadenya::Objectives::ObjectiveToolCall::Status)
+              T.all(
+                Symbol,
+                Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus
+              )
             end
           OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-          TOOL_CALL_STATUS_UNSPECIFIED =
+          TOOL_CALL_EXECUTION_STATUS_UNSPECIFIED =
             T.let(
-              :TOOL_CALL_STATUS_UNSPECIFIED,
-              Cadenya::Objectives::ObjectiveToolCall::Status::TaggedSymbol
+              :TOOL_CALL_EXECUTION_STATUS_UNSPECIFIED,
+              Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol
             )
-          TOOL_CALL_STATUS_AUTO_APPROVED =
+          TOOL_CALL_EXECUTION_STATUS_PENDING =
             T.let(
-              :TOOL_CALL_STATUS_AUTO_APPROVED,
-              Cadenya::Objectives::ObjectiveToolCall::Status::TaggedSymbol
+              :TOOL_CALL_EXECUTION_STATUS_PENDING,
+              Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol
             )
-          TOOL_CALL_STATUS_WAITING_FOR_APPROVAL =
+          TOOL_CALL_EXECUTION_STATUS_RUNNING =
             T.let(
-              :TOOL_CALL_STATUS_WAITING_FOR_APPROVAL,
-              Cadenya::Objectives::ObjectiveToolCall::Status::TaggedSymbol
+              :TOOL_CALL_EXECUTION_STATUS_RUNNING,
+              Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol
             )
-          TOOL_CALL_STATUS_APPROVED =
+          TOOL_CALL_EXECUTION_STATUS_COMPLETED =
             T.let(
-              :TOOL_CALL_STATUS_APPROVED,
-              Cadenya::Objectives::ObjectiveToolCall::Status::TaggedSymbol
+              :TOOL_CALL_EXECUTION_STATUS_COMPLETED,
+              Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol
             )
-          TOOL_CALL_STATUS_DENIED =
+          TOOL_CALL_EXECUTION_STATUS_ERRORED =
             T.let(
-              :TOOL_CALL_STATUS_DENIED,
-              Cadenya::Objectives::ObjectiveToolCall::Status::TaggedSymbol
+              :TOOL_CALL_EXECUTION_STATUS_ERRORED,
+              Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol
             )
 
           sig do
             override.returns(
               T::Array[
-                Cadenya::Objectives::ObjectiveToolCall::Status::TaggedSymbol
+                Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol
               ]
             )
           end
@@ -149,48 +141,46 @@ module Cadenya
           end
         end
 
-        module ExecutionStatus
+        # Current status of the tool call
+        module Status
           extend Cadenya::Internal::Type::Enum
 
           TaggedSymbol =
             T.type_alias do
-              T.all(
-                Symbol,
-                Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus
-              )
+              T.all(Symbol, Cadenya::Objectives::ObjectiveToolCall::Status)
             end
           OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-          TOOL_CALL_EXECUTION_STATUS_UNSPECIFIED =
+          TOOL_CALL_STATUS_UNSPECIFIED =
             T.let(
-              :TOOL_CALL_EXECUTION_STATUS_UNSPECIFIED,
-              Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol
+              :TOOL_CALL_STATUS_UNSPECIFIED,
+              Cadenya::Objectives::ObjectiveToolCall::Status::TaggedSymbol
             )
-          TOOL_CALL_EXECUTION_STATUS_PENDING =
+          TOOL_CALL_STATUS_AUTO_APPROVED =
             T.let(
-              :TOOL_CALL_EXECUTION_STATUS_PENDING,
-              Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol
+              :TOOL_CALL_STATUS_AUTO_APPROVED,
+              Cadenya::Objectives::ObjectiveToolCall::Status::TaggedSymbol
             )
-          TOOL_CALL_EXECUTION_STATUS_RUNNING =
+          TOOL_CALL_STATUS_WAITING_FOR_APPROVAL =
             T.let(
-              :TOOL_CALL_EXECUTION_STATUS_RUNNING,
-              Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol
+              :TOOL_CALL_STATUS_WAITING_FOR_APPROVAL,
+              Cadenya::Objectives::ObjectiveToolCall::Status::TaggedSymbol
             )
-          TOOL_CALL_EXECUTION_STATUS_COMPLETED =
+          TOOL_CALL_STATUS_APPROVED =
             T.let(
-              :TOOL_CALL_EXECUTION_STATUS_COMPLETED,
-              Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol
+              :TOOL_CALL_STATUS_APPROVED,
+              Cadenya::Objectives::ObjectiveToolCall::Status::TaggedSymbol
             )
-          TOOL_CALL_EXECUTION_STATUS_ERRORED =
+          TOOL_CALL_STATUS_DENIED =
             T.let(
-              :TOOL_CALL_EXECUTION_STATUS_ERRORED,
-              Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol
+              :TOOL_CALL_STATUS_DENIED,
+              Cadenya::Objectives::ObjectiveToolCall::Status::TaggedSymbol
             )
 
           sig do
             override.returns(
               T::Array[
-                Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol
+                Cadenya::Objectives::ObjectiveToolCall::Status::TaggedSymbol
               ]
             )
           end

data/rbi/cadenya/models/profile_spec.rbi

@@ -7,7 +7,7 @@ module Cadenya
         T.type_alias { T.any(Cadenya::ProfileSpec, Cadenya::Internal::AnyHash) }
 
       # Whether this profile represents a human user, an API key, or a system principal.
-      sig { returns(Cadenya::ProfileSpec::Type::OrSymbol) }
+      sig { returns(Cadenya::ProfileSpec::Type::TaggedSymbol) }
       attr_accessor :type
 
       # Email address of the profile. Required and unique within an account for user
@@ -47,7 +47,7 @@ module Cadenya
       sig do
         override.returns(
           {
-            type: Cadenya::ProfileSpec::Type::OrSymbol,
+            type: Cadenya::ProfileSpec::Type::TaggedSymbol,
             email: String,
             name: String
           }

data/rbi/cadenya/models.rbi

@@ -153,6 +153,8 @@ module Cadenya
 
   ObjectiveCompactParams = Cadenya::Models::ObjectiveCompactParams
 
+  ObjectiveConfigSnapshot = Cadenya::Models::ObjectiveConfigSnapshot
+
   ObjectiveContextWindow = Cadenya::Models::ObjectiveContextWindow
 
   ObjectiveContextWindowData = Cadenya::Models::ObjectiveContextWindowData
@@ -161,10 +163,6 @@ module Cadenya
 
   ObjectiveCreateParams = Cadenya::Models::ObjectiveCreateParams
 
-  ObjectiveData = Cadenya::Models::ObjectiveData
-
-  ObjectiveDataSecret = Cadenya::Models::ObjectiveDataSecret
-
   ObjectiveError = Cadenya::Models::ObjectiveError
 
   ObjectiveEventData = Cadenya::Models::ObjectiveEventData
@@ -186,7 +184,7 @@ module Cadenya
 
   Objectives = Cadenya::Models::Objectives
 
-  ObjectiveStatus = Cadenya::Models::ObjectiveStatus
+  ObjectiveSecret = Cadenya::Models::ObjectiveSecret
 
   OperationMetadata = Cadenya::Models::OperationMetadata
 

data/rbi/cadenya/resources/objectives.rbi

@@ -20,8 +20,11 @@ module Cadenya
         params(
           workspace_id: String,
           agent_id: String,
-          data: Cadenya::ObjectiveData::OrHash,
+          data: T::Hash[Symbol, T.anything],
+          initial_message: String,
+          memory_stack: T::Array[Cadenya::MemoryReference::OrHash],
           metadata: Cadenya::CreateOperationMetadata::OrHash,
+          secrets: T::Array[Cadenya::ObjectiveCreateParams::Secret::OrHash],
           variation_id: String,
           request_options: Cadenya::RequestOptions::OrHash
         ).returns(Cadenya::Objective)
@@ -29,11 +32,36 @@ 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:,
+        # 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.
+        initial_message: nil,
+        # Memory layers/entries to push onto this objective's memory stack on top of the
+        # baseline stack inherited from the selected variation.
+        #
+        # 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.
+        memory_stack: nil,
         # CreateOperationMetadata contains the user-provided fields for creating an
         # operation. Read-only fields (id, account_id, workspace_id, created_at,
         # profile_id) are excluded since they are set by the server.
         metadata: nil,
+        # Secrets that can be used in the headers for tool calls using the secret
+        # interpolation format.
+        secrets: nil,
         # Optional explicit variation selection. Overrides the agent's
         # variation_selection_mode.
         variation_id: nil,

data/sig/cadenya/models/objective.rbs

@@ -2,45 +2,115 @@ module Cadenya
   module Models
     type objective =
       {
-        data: Cadenya::ObjectiveData,
+        config_snapshot: Cadenya::ObjectiveConfigSnapshot,
+        initial_message: String,
         metadata: Cadenya::OperationMetadata,
-        status: Cadenya::ObjectiveStatus,
+        state: Cadenya::Models::Objective::state,
+        system_prompt: String,
+        data: ::Hash[Symbol, top],
         info: Cadenya::ObjectiveInfo,
-        last_five_windows: ::Array[Cadenya::ObjectiveContextWindow]
+        memory_stack: ::Array[Cadenya::MemoryReference],
+        output: ::Hash[Symbol, top],
+        parent_objective_id: String,
+        secrets: ::Array[Cadenya::ObjectiveSecret],
+        state_message: String
       }
 
     class Objective < Cadenya::Internal::Type::BaseModel
-      attr_accessor data: Cadenya::ObjectiveData
+      attr_accessor initial_message: String
 
       attr_accessor metadata: Cadenya::OperationMetadata
 
-      attr_accessor status: Cadenya::ObjectiveStatus
+      attr_reader memory_stack: ::Array[Cadenya::MemoryReference]?
+
+      def memory_stack=: (
+        ::Array[Cadenya::MemoryReference]
+      ) -> ::Array[Cadenya::MemoryReference]
+
+      attr_reader secrets: ::Array[Cadenya::ObjectiveSecret]?
+
+      def secrets=: (
+        ::Array[Cadenya::ObjectiveSecret]
+      ) -> ::Array[Cadenya::ObjectiveSecret]
+
+      attr_accessor config_snapshot: Cadenya::ObjectiveConfigSnapshot
+
+      attr_accessor state: Cadenya::Models::Objective::state
+
+      attr_accessor system_prompt: String
+
+      attr_reader data: ::Hash[Symbol, top]?
+
+      def data=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
 
       attr_reader info: Cadenya::ObjectiveInfo?
 
       def info=: (Cadenya::ObjectiveInfo) -> Cadenya::ObjectiveInfo
 
-      attr_reader last_five_windows: ::Array[Cadenya::ObjectiveContextWindow]?
+      attr_reader output: ::Hash[Symbol, top]?
 
-      def last_five_windows=: (
-        ::Array[Cadenya::ObjectiveContextWindow]
-      ) -> ::Array[Cadenya::ObjectiveContextWindow]
+      def output=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
+
+      attr_reader parent_objective_id: String?
+
+      def parent_objective_id=: (String) -> String
+
+      attr_reader state_message: String?
+
+      def state_message=: (String) -> String
 
       def initialize: (
-        data: Cadenya::ObjectiveData,
+        config_snapshot: Cadenya::ObjectiveConfigSnapshot,
+        initial_message: String,
         metadata: Cadenya::OperationMetadata,
-        status: Cadenya::ObjectiveStatus,
+        state: Cadenya::Models::Objective::state,
+        system_prompt: String,
+        ?data: ::Hash[Symbol, top],
         ?info: Cadenya::ObjectiveInfo,
-        ?last_five_windows: ::Array[Cadenya::ObjectiveContextWindow]
+        ?memory_stack: ::Array[Cadenya::MemoryReference],
+        ?output: ::Hash[Symbol, top],
+        ?parent_objective_id: String,
+        ?secrets: ::Array[Cadenya::ObjectiveSecret],
+        ?state_message: String
       ) -> void
 
       def to_hash: -> {
-        data: Cadenya::ObjectiveData,
+        config_snapshot: Cadenya::ObjectiveConfigSnapshot,
+        initial_message: String,
         metadata: Cadenya::OperationMetadata,
-        status: Cadenya::ObjectiveStatus,
+        state: Cadenya::Models::Objective::state,
+        system_prompt: String,
+        data: ::Hash[Symbol, top],
         info: Cadenya::ObjectiveInfo,
-        last_five_windows: ::Array[Cadenya::ObjectiveContextWindow]
+        memory_stack: ::Array[Cadenya::MemoryReference],
+        output: ::Hash[Symbol, top],
+        parent_objective_id: String,
+        secrets: ::Array[Cadenya::ObjectiveSecret],
+        state_message: String
       }
+
+      type state =
+        :STATE_UNSPECIFIED
+        | :STATE_PENDING
+        | :STATE_RUNNING
+        | :STATE_WAITING
+        | :STATE_FAILED
+        | :STATE_CANCELLED
+        | :STATE_FINALIZED
+
+      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
+
+        def self?.values: -> ::Array[Cadenya::Models::Objective::state]
+      end
     end
   end
 end

data/sig/cadenya/models/objective_config_snapshot.rbs

@@ -0,0 +1,40 @@
+module Cadenya
+  module Models
+    type objective_config_snapshot =
+      {
+        agent: Cadenya::Agent,
+        agent_schedule: Cadenya::Agents::AgentSchedule,
+        agent_variation: Cadenya::Agents::AgentVariation
+      }
+
+    class ObjectiveConfigSnapshot < Cadenya::Internal::Type::BaseModel
+      attr_reader agent: Cadenya::Agent?
+
+      def agent=: (Cadenya::Agent) -> Cadenya::Agent
+
+      attr_reader agent_schedule: Cadenya::Agents::AgentSchedule?
+
+      def agent_schedule=: (
+        Cadenya::Agents::AgentSchedule
+      ) -> Cadenya::Agents::AgentSchedule
+
+      attr_reader agent_variation: Cadenya::Agents::AgentVariation?
+
+      def agent_variation=: (
+        Cadenya::Agents::AgentVariation
+      ) -> Cadenya::Agents::AgentVariation
+
+      def initialize: (
+        ?agent: Cadenya::Agent,
+        ?agent_schedule: Cadenya::Agents::AgentSchedule,
+        ?agent_variation: Cadenya::Agents::AgentVariation
+      ) -> void
+
+      def to_hash: -> {
+        agent: Cadenya::Agent,
+        agent_schedule: Cadenya::Agents::AgentSchedule,
+        agent_variation: Cadenya::Agents::AgentVariation
+      }
+    end
+  end
+end