cadenya 0.1.0

data/lib/cadenya/models/model_spec.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ModelSpec < Cadenya::Internal::Type::BaseModel
+      # @!attribute family
+      #   The model family (e.g., "claude-sonnet-4.6", "gpt-5.4", "gemini-2.5-flash")
+      #
+      #   @return [String, nil]
+      optional :family, String
+
+      # @!attribute input_price_per_million_tokens
+      #   Cost per million input tokens in cents (e.g., 300 = $3.00)
+      #
+      #   @return [String, nil]
+      optional :input_price_per_million_tokens, String, api_name: :inputPricePerMillionTokens
+
+      # @!attribute max_input_tokens
+      #   Maximum number of input tokens the model supports
+      #
+      #   @return [Integer, nil]
+      optional :max_input_tokens, Integer, api_name: :maxInputTokens
+
+      # @!attribute max_output_tokens
+      #   Maximum number of output tokens the model can generate
+      #
+      #   @return [Integer, nil]
+      optional :max_output_tokens, Integer, api_name: :maxOutputTokens
+
+      # @!attribute output_price_per_million_tokens
+      #   Cost per million output tokens in cents (e.g., 1500 = $15.00)
+      #
+      #   @return [String, nil]
+      optional :output_price_per_million_tokens, String, api_name: :outputPricePerMillionTokens
+
+      # @!attribute provider
+      #   The model provider (e.g., "anthropic", "openai", "google")
+      #
+      #   @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)
+      #   @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)
+      #
+      #   @param max_input_tokens [Integer] Maximum number of input tokens the model supports
+      #
+      #   @param max_output_tokens [Integer] Maximum number of output tokens the model can generate
+      #
+      #   @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

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Objectives#create
+    class Objective < Cadenya::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [Cadenya::Models::ObjectiveData]
+      required :data, -> { Cadenya::ObjectiveData }
+
+      # @!attribute metadata
+      #   Metadata for ephemeral operations and activities (e.g., objectives, executions,
+      #   runs)
+      #
+      #   @return [Cadenya::Models::OperationMetadata]
+      required :metadata, -> { Cadenya::OperationMetadata }
+
+      # @!attribute status
+      #
+      #   @return [Cadenya::Models::ObjectiveStatus]
+      required :status, -> { Cadenya::ObjectiveStatus }
+
+      response_only do
+        # @!attribute info
+        #   ObjectiveInfo provides read-only aggregated statistics about an objective's
+        #   execution
+        #
+        #   @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).
+        #
+        #   @return [Array<Cadenya::Models::ObjectiveContextWindow>, nil]
+        optional :last_five_windows,
+                 -> { Cadenya::Internal::Type::ArrayOf[Cadenya::ObjectiveContextWindow] },
+                 api_name: :lastFiveWindows
+      end
+
+      # @!method initialize(data:, metadata:, status:, info: nil, last_five_windows: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::Objective} for more details.
+      #
+      #   @param data [Cadenya::Models::ObjectiveData]
+      #
+      #   @param metadata [Cadenya::Models::OperationMetadata] Metadata for ephemeral operations and activities (e.g., objectives, executions,
+      #
+      #   @param status [Cadenya::Models::ObjectiveStatus]
+      #
+      #   @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
+    end
+  end
+end

data/lib/cadenya/models/objective_cancel_params.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Objectives#cancel
+    class ObjectiveCancelParams < 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 objective_id
+      #
+      #   @return [String]
+      required :objective_id, String
+
+      # @!attribute reason
+      #   Optional reason for cancellation
+      #
+      #   @return [String, nil]
+      optional :reason, String
+
+      # @!method initialize(workspace_id:, objective_id:, reason: nil, request_options: {})
+      #   @param workspace_id [String]
+      #
+      #   @param objective_id [String]
+      #
+      #   @param reason [String] Optional reason for cancellation
+      #
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cadenya/models/objective_compact_params.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Objectives#compact
+    class ObjectiveCompactParams < 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 objective_id
+      #
+      #   @return [String]
+      required :objective_id, String
+
+      # @!attribute compaction_config
+      #   CompactionConfig defines how context window compaction behaves for objectives
+      #   using this variation.
+      #
+      #   @return [Cadenya::Models::Agents::AgentVariationSpecCompactionConfig, nil]
+      optional :compaction_config,
+               -> { Cadenya::Agents::AgentVariationSpecCompactionConfig },
+               api_name: :compactionConfig
+
+      # @!method initialize(workspace_id:, objective_id:, compaction_config: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ObjectiveCompactParams} for more details.
+      #
+      #   @param workspace_id [String]
+      #
+      #   @param objective_id [String]
+      #
+      #   @param compaction_config [Cadenya::Models::Agents::AgentVariationSpecCompactionConfig] CompactionConfig defines how context window compaction behaves for objectives us
+      #
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cadenya/models/objective_compact_response.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Objectives#compact
+    class ObjectiveCompactResponse < Cadenya::Internal::Type::BaseModel
+      # @!attribute context_window
+      #   The new context window created by the compaction
+      #
+      #   @return [Cadenya::Models::ObjectiveContextWindowData, nil]
+      optional :context_window, -> { Cadenya::ObjectiveContextWindowData }, api_name: :contextWindow
+
+      # @!method initialize(context_window: nil)
+      #   Compact objective response
+      #
+      #   @param context_window [Cadenya::Models::ObjectiveContextWindowData] The new context window created by the compaction
+    end
+  end
+end

data/lib/cadenya/models/objective_context_window.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Objectives#list_context_windows
+    class ObjectiveContextWindow < Cadenya::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [Cadenya::Models::ObjectiveContextWindowData]
+      required :data, -> { Cadenya::ObjectiveContextWindowData }
+
+      # @!attribute metadata
+      #   Metadata for ephemeral operations and activities (e.g., objectives, executions,
+      #   runs)
+      #
+      #   @return [Cadenya::Models::OperationMetadata]
+      required :metadata, -> { Cadenya::OperationMetadata }
+
+      # @!attribute info
+      #
+      #   @return [Cadenya::Models::ObjectiveContextWindow::Info, nil]
+      optional :info, -> { Cadenya::ObjectiveContextWindow::Info }
+
+      # @!method initialize(data:, metadata:, info: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ObjectiveContextWindow} for more details.
+      #
+      #   ObjectiveContextWindow is a window of chat completions that is grouped together
+      #   to prevent context-window overflows. Context windows also allow agents to
+      #   compact their windows and carry on into a new one.
+      #
+      #   @param data [Cadenya::Models::ObjectiveContextWindowData]
+      #
+      #   @param metadata [Cadenya::Models::OperationMetadata] Metadata for ephemeral operations and activities (e.g., objectives, executions,
+      #
+      #   @param info [Cadenya::Models::ObjectiveContextWindow::Info]
+
+      # @see Cadenya::Models::ObjectiveContextWindow#info
+      class Info < Cadenya::Internal::Type::BaseModel
+        # @!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
+
+        # @!attribute objective
+        #   Metadata for ephemeral operations and activities (e.g., objectives, executions,
+        #   runs)
+        #
+        #   @return [Cadenya::Models::OperationMetadata, nil]
+        optional :objective, -> { Cadenya::OperationMetadata }
+
+        # @!method initialize(created_by: nil, objective: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ObjectiveContextWindow::Info} for more details.
+        #
+        #   @param created_by [Cadenya::Models::Profile] A profile identifies a user or non-human principal (such as an API key)
+        #
+        #   @param objective [Cadenya::Models::OperationMetadata] Metadata for ephemeral operations and activities (e.g., objectives, executions,
+      end
+    end
+  end
+end

data/lib/cadenya/models/objective_context_window_data.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ObjectiveContextWindowData < Cadenya::Internal::Type::BaseModel
+      # @!attribute previous_window_continue_instructions
+      #   The instructions for this window to continue from a previous window's chat
+      #   history.
+      #
+      #   @return [String, nil]
+      optional :previous_window_continue_instructions, String, api_name: :previousWindowContinueInstructions
+
+      response_only do
+        # @!attribute completion_tokens
+        #   A calculated value for how many completion tokens (output tokens) have been used
+        #   in this context window
+        #
+        #   @return [Integer, nil]
+        optional :completion_tokens, Integer, api_name: :completionTokens
+
+        # @!attribute objective_id
+        #   The objective's ID that this window belongs to
+        #
+        #   @return [String, nil]
+        optional :objective_id, String, api_name: :objectiveId
+
+        # @!attribute prompt_tokens
+        #   A calculated value for how many prompt tokens (input tokens) have been used in
+        #   this context window
+        #
+        #   @return [Integer, nil]
+        optional :prompt_tokens, Integer, api_name: :promptTokens
+
+        # @!attribute sequence
+        #   sequence is a numeric representation of which context window this is. Sequences
+        #   are useful to perform a max(sequence) on in order to calculate how many context
+        #   windows an objective has.
+        #
+        #   @return [Integer, nil]
+        optional :sequence, Integer
+      end
+
+      # @!method initialize(completion_tokens: nil, objective_id: nil, previous_window_continue_instructions: nil, prompt_tokens: nil, sequence: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ObjectiveContextWindowData} for more details.
+      #
+      #   @param completion_tokens [Integer] A calculated value for how many completion tokens (output tokens) have been used
+      #
+      #   @param objective_id [String] The objective's ID that this window belongs to
+      #
+      #   @param previous_window_continue_instructions [String] The instructions for this window to continue from a previous window's chat histo
+      #
+      #   @param prompt_tokens [Integer] A calculated value for how many prompt tokens (input tokens) have been used in t
+      #
+      #   @param sequence [Integer] sequence is a numeric representation of which context window this is. Sequences
+    end
+  end
+end

data/lib/cadenya/models/objective_continue_params.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Objectives#continue
+    class ObjectiveContinueParams < 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 objective_id
+      #
+      #   @return [String]
+      required :objective_id, String
+
+      # @!attribute enqueue
+      #   When set to true, the message will be enqueued for when the agent loop is
+      #   available to process it.
+      #
+      #   @return [Boolean, nil]
+      optional :enqueue, Cadenya::Internal::Type::Boolean
+
+      # @!attribute message
+      #   The message to continue an objective that has completed (or you are enqueing)
+      #
+      #   @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: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ObjectiveContinueParams} for more details.
+      #
+      #   @param workspace_id [String]
+      #
+      #   @param objective_id [String]
+      #
+      #   @param enqueue [Boolean] When set to true, the message will be enqueued for when the agent loop is availa
+      #
+      #   @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_continue_response.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Objectives#continue
+    class ObjectiveContinueResponse < Cadenya::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [Cadenya::Models::ObjectiveEventData]
+      required :data, -> { Cadenya::ObjectiveEventData }
+
+      # @!attribute metadata
+      #   Metadata for ephemeral operations and activities (e.g., objectives, executions,
+      #   runs)
+      #
+      #   @return [Cadenya::Models::OperationMetadata]
+      required :metadata, -> { Cadenya::OperationMetadata }
+
+      # @!attribute context_window_id
+      #
+      #   @return [String, nil]
+      optional :context_window_id, String, api_name: :contextWindowId
+
+      # @!attribute info
+      #
+      #   @return [Cadenya::Models::ObjectiveEventInfo, nil]
+      optional :info, -> { Cadenya::ObjectiveEventInfo }
+
+      # @!method initialize(data:, metadata:, context_window_id: nil, info: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ObjectiveContinueResponse} for more details.
+      #
+      #   @param data [Cadenya::Models::ObjectiveEventData]
+      #
+      #   @param metadata [Cadenya::Models::OperationMetadata] Metadata for ephemeral operations and activities (e.g., objectives, executions,
+      #
+      #   @param context_window_id [String]
+      #
+      #   @param info [Cadenya::Models::ObjectiveEventInfo]
+    end
+  end
+end

data/lib/cadenya/models/objective_create_params.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Objectives#create
+    class ObjectiveCreateParams < 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 agent_id
+      #
+      #   @return [String]
+      required :agent_id, String, api_name: :agentId
+
+      # @!attribute data
+      #
+      #   @return [Cadenya::Models::ObjectiveData]
+      required :data, -> { Cadenya::ObjectiveData }
+
+      # @!attribute metadata
+      #   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.
+      #
+      #   @return [Cadenya::Models::CreateOperationMetadata]
+      required :metadata, -> { Cadenya::CreateOperationMetadata }
+
+      # @!attribute variation_id
+      #   Optional explicit variation selection. Overrides the agent's
+      #   variation_selection_mode.
+      #
+      #   @return [String, nil]
+      optional :variation_id, String, api_name: :variationId
+
+      # @!method initialize(workspace_id:, agent_id:, data:, metadata:, variation_id: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ObjectiveCreateParams} for more details.
+      #
+      #   @param workspace_id [String]
+      #
+      #   @param agent_id [String]
+      #
+      #   @param data [Cadenya::Models::ObjectiveData]
+      #
+      #   @param metadata [Cadenya::Models::CreateOperationMetadata] CreateOperationMetadata contains the user-provided fields for creating
+      #
+      #   @param variation_id [String] Optional explicit variation selection. Overrides the agent's variation_selection
+      #
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cadenya/models/objective_data.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ObjectiveData < Cadenya::Internal::Type::BaseModel
+      # @!attribute data
+      #   Represents a dynamically typed value which can be either null, a number, a
+      #   string, a boolean, a recursive struct value, or a list of values.
+      #
+      #   @return [Object, nil]
+      optional :data, Cadenya::Internal::Type::Unknown
+
+      # @!attribute initial_message
+      #   The initial message sent to the agent. This becomes the first user message in
+      #   the LLM chat history.
+      #
+      #   @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 secrets
+      #   Secrets that can be used in the headers for tool calls using the secret
+      #   interpolation format.
+      #
+      #   @return [Array<Cadenya::Models::ObjectiveDataSecret>, nil]
+      optional :secrets, -> { Cadenya::Internal::Type::ArrayOf[Cadenya::ObjectiveDataSecret] }
+
+      response_only do
+        # @!attribute agent
+        #   Agent resource
+        #
+        #   @return [Cadenya::Models::Agent, nil]
+        optional :agent, -> { Cadenya::Agent }
+
+        # @!attribute parent_objective_id
+        #   A parent objective means the objective was spawned off using a separate agent to
+        #   complete an objective
+        #
+        #   @return [String, nil]
+        optional :parent_objective_id, String, api_name: :parentObjectiveId
+
+        # @!attribute source_schedule_id
+        #   ID of the AgentSchedule that produced this objective, when applicable. Populated
+        #   when the objective is created from a schedule fire; empty when the objective was
+        #   created via CreateObjective directly.
+        #
+        #   @return [String, nil]
+        optional :source_schedule_id, String, api_name: :sourceScheduleId
+
+        # @!attribute system_prompt
+        #   system_prompt is read-only, derived from the selected variation's prompt
+        #
+        #   @return [String, nil]
+        optional :system_prompt, String, api_name: :systemPrompt
+
+        # @!attribute variation
+        #   AgentVariation resource
+        #
+        #   @return [Cadenya::Models::Agents::AgentVariation, nil]
+        optional :variation, -> { Cadenya::Agents::AgentVariation }
+      end
+
+      # @!method initialize(agent: nil, data: nil, initial_message: nil, memory_stack: nil, parent_objective_id: nil, secrets: nil, source_schedule_id: nil, system_prompt: nil, variation: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ObjectiveData} for more details.
+      #
+      #   @param agent [Cadenya::Models::Agent] Agent resource
+      #
+      #   @param data [Object] Represents a dynamically typed value which can be either null, a number, a strin
+      #
+      #   @param initial_message [String] The initial message sent to the agent. This becomes the first user message in th
+      #
+      #   @param memory_stack [Array<Cadenya::Models::MemoryReference>] Memory layers/entries to push onto this objective's memory stack on
+      #
+      #   @param parent_objective_id [String] A parent objective means the objective was spawned off using a separate agent to
+      #
+      #   @param secrets [Array<Cadenya::Models::ObjectiveDataSecret>] Secrets that can be used in the headers for tool calls using the secret interpol
+      #
+      #   @param source_schedule_id [String] ID of the AgentSchedule that produced this objective, when applicable.
+      #
+      #   @param system_prompt [String] system_prompt is read-only, derived from the selected variation's prompt
+      #
+      #   @param variation [Cadenya::Models::Agents::AgentVariation] AgentVariation resource
+    end
+  end
+end

data/lib/cadenya/models/objective_data_secret.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ObjectiveDataSecret < 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