cadenya 0.10.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fdbe6be38292a9c2cdb1398a82675a4b9d83e2a633479147843681b820dc21fb
-  data.tar.gz: 26192932a4a0229f48bcbcb6bc4f1ae119351fd349eabaadafcfe746a8f3a2de
+  metadata.gz: cc33022d12e62f8273e8a7aa25cc2f020c231e6ce29f66775f9b144747d5658f
+  data.tar.gz: 619df9b5f16e896b922e1f8a1fa312f175a869154eb78a54c29a641e20f09b6b
 SHA512:
-  metadata.gz: b68888435e7da1c39ecb5a13f8543e8aee96e07cdef1433fe1ce5d4310bfe75f114f2efd1b43f290a278ec307c0697f2ff8dfd41712bf2c080114c1afb4dbed0
-  data.tar.gz: ab0ea603fe0175091589cb156b96129cc82a88468e627ff2232f5fb7d500b6863372f81c0ce3b12ec02d1c849b49363991334f37b22c725a404e2344ba04f049
+  metadata.gz: 67d08c0901b15069f74e1a8a071876d9ac7c2871f5d73c2986c28ce4b6c01fe564a3385e6bd932f018a6392094d10e3d0a860f9bcd199435cc4fb99beb3a52d4
+  data.tar.gz: e6bd7a52e5e2a517108f7eeb6a3902c4662ed72c4158e06da10fc0862fc9292191d479ede3e87662a6104d9a680fe62d9e05d51be0f3b15ed9015907780415f4

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.12.0 (2026-06-10)
+
+Full Changelog: [v0.11.0...v0.12.0](https://github.com/cadenya/cadenya-ruby/compare/v0.11.0...v0.12.0)
+
+### Features
+
+* **api:** api update ([8359495](https://github.com/cadenya/cadenya-ruby/commit/83594951a99af87c376c9fd775b06e65f07d3323))
+
+## 0.11.0 (2026-06-10)
+
+Full Changelog: [v0.10.0...v0.11.0](https://github.com/cadenya/cadenya-ruby/compare/v0.10.0...v0.11.0)
+
+### Features
+
+* **api:** api update ([5f00cea](https://github.com/cadenya/cadenya-ruby/commit/5f00ceaef72eb0c4ab66a2489eecb6de7ec35616))
+
 ## 0.10.0 (2026-06-09)
 
 Full Changelog: [v0.9.0...v0.10.0](https://github.com/cadenya/cadenya-ruby/compare/v0.9.0...v0.10.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.10.0"
+gem "cadenya", "~> 0.12.0"
 ```
 
 <!-- x-release-please-end -->

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

@@ -4,13 +4,6 @@ module Cadenya
   module Models
     module Agents
       class AgentScheduleSpec < Cadenya::Internal::Type::BaseModel
-        # @!attribute initial_message
-        #   The initial message passed to CreateObjective on each fire. Becomes the first
-        #   user message in the objective's chat history.
-        #
-        #   @return [String]
-        required :initial_message, String, api_name: :initialMessage
-
         # @!attribute schedule
         #   Schedule defines WHEN the schedule fires. Temporal-style structured form: a list
         #   of calendar rules (wall-clock) and/or interval rules (duration), OR'd together.
@@ -26,6 +19,14 @@ module Cadenya
         #   @return [Object, nil]
         optional :data, Cadenya::Internal::Type::Unknown
 
+        # @!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.
+        #
+        #   @return [String, nil]
+        optional :initial_message, String, api_name: :initialMessage
+
         # @!attribute overlap_policy
         #   What to do when the previous run is still in flight. Defaults to SKIP.
         #
@@ -34,6 +35,14 @@ 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.
+        #
+        #   @return [Object, nil]
+        optional :user_data, Cadenya::Internal::Type::Unknown, api_name: :userData
+
         # @!attribute variation_id
         #   Optional explicit variation. When unset, the agent's variation_selection_mode
         #   chooses per fire.
@@ -41,20 +50,22 @@ module Cadenya
         #   @return [String, nil]
         optional :variation_id, String, api_name: :variationId
 
-        # @!method initialize(initial_message:, schedule:, data: nil, overlap_policy: nil, variation_id: nil)
+        # @!method initialize(schedule:, data: nil, initial_message: nil, overlap_policy: nil, user_data: nil, variation_id: nil)
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Agents::AgentScheduleSpec} for more details.
         #
         #   AgentScheduleSpec is the user-provided configuration for a schedule.
         #
-        #   @param initial_message [String] The initial message passed to CreateObjective on each fire. Becomes the
-        #
         #   @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 initial_message [String] Optional initial message passed to CreateObjective on each fire. Becomes the
+        #
         #   @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 variation_id [String] Optional explicit variation. When unset, the agent's variation_selection_mode
 
         # What to do when the previous run is still in flight. Defaults to SKIP.

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

@@ -60,11 +60,22 @@ module Cadenya
                  -> { Cadenya::Agents::AgentVariationSpecProgressiveDiscovery },
                  api_name: :progressiveDiscovery
 
-        # @!attribute prompt
-        #   The system prompt for this variation
+        # @!attribute system_prompt_template
+        #   Liquid template for the system prompt of objectives using this variation.
+        #   Rendered with CreateObjectiveRequest.data into Objective.system_prompt.
         #
         #   @return [String, nil]
-        optional :prompt, String
+        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).
@@ -75,7 +86,7 @@ module Cadenya
         #   @return [Integer, nil]
         optional :weight, Integer
 
-        # @!method initialize(compaction_config: nil, constraints: nil, description: nil, enable_episodic_memory: nil, episodic_memory_ttl: nil, model_config: nil, progressive_discovery: nil, prompt: nil, weight: nil)
+        # @!method initialize(compaction_config: nil, constraints: nil, description: nil, enable_episodic_memory: nil, episodic_memory_ttl: nil, model_config: nil, progressive_discovery: nil, system_prompt_template: nil, user_message_template: nil, weight: nil)
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Agents::AgentVariationSpec} for more details.
         #
@@ -95,7 +106,9 @@ module Cadenya
         #
         #   @param progressive_discovery [Cadenya::Models::Agents::AgentVariationSpecProgressiveDiscovery] ProgressiveDiscovery is used to indicate that the agent should automatically dis
         #
-        #   @param prompt [String] The system prompt for this variation
+        #   @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

data/lib/cadenya/models/objective.rb

@@ -100,9 +100,17 @@ 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
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :user_data,
+                 Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown],
+                 api_name: :userData
       end
 
-      # @!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)
+      # @!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, user_data: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::Objective} for more details.
       #
@@ -133,6 +141,8 @@ module Cadenya
       #   @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).
+      #
+      #   @param user_data [Hash{Symbol=>Object}] Arbitrary data used to render the variation's user_message_template
 
       # The current lifecycle state of the objective.
       #

data/lib/cadenya/models/objective_create_params.rb

@@ -25,9 +25,11 @@ module Cadenya
       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.
+      #   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
+      #   InvalidArgument.
       #
       #   @return [String, nil]
       optional :initial_message, String, api_name: :initialMessage
@@ -69,6 +71,16 @@ 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.
@@ -76,7 +88,7 @@ module Cadenya
       #   @return [String, nil]
       optional :variation_id, String, api_name: :variationId
 
-      # @!method initialize(workspace_id:, agent_id:, data:, initial_message: nil, memory_stack: nil, metadata: nil, secrets: nil, variation_id: nil, request_options: {})
+      # @!method initialize(workspace_id:, agent_id:, data:, initial_message: nil, memory_stack: nil, metadata: nil, secrets: nil, user_data: nil, variation_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::ObjectiveCreateParams} for more details.
       #
@@ -86,7 +98,7 @@ module Cadenya
       #
       #   @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 initial_message [String] Optional override for the initial message sent to the agent. This becomes the fi
       #
       #   @param memory_stack [Array<Cadenya::Models::MemoryReference>] Memory layers/entries to push onto this objective's memory stack on
       #
@@ -94,6 +106,8 @@ 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/objectives/objective_tool_call_data.rb

@@ -26,12 +26,6 @@ module Cadenya
         optional :memo, String
 
         response_only do
-          # @!attribute result
-          #   The result content returned by the tool after execution
-          #
-          #   @return [String, nil]
-          optional :result, String
-
           # @!attribute status_changed_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
@@ -41,7 +35,7 @@ module Cadenya
           optional :status_changed_by, -> { Cadenya::Profile }, api_name: :statusChangedBy
         end
 
-        # @!method initialize(callable:, arguments: nil, memo: nil, result: nil, status_changed_by: nil)
+        # @!method initialize(callable:, arguments: nil, memo: nil, status_changed_by: nil)
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Objectives::ObjectiveToolCallData} for more details.
         #
@@ -51,8 +45,6 @@ module Cadenya
         #
         #   @param memo [String] A memo supplied by the reviewer when denying the tool call
         #
-        #   @param result [String] The result content returned by the tool after execution
-        #
         #   @param status_changed_by [Cadenya::Models::Profile] A profile identifies a user or non-human principal (such as an API key)
       end
     end

data/lib/cadenya/models/objectives/objective_tool_call_result.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Objectives
+      class ObjectiveToolCallResult < Cadenya::Internal::Type::BaseModel
+        response_only do
+          # @!attribute content
+          #
+          #   @return [Array<Cadenya::Models::Objectives::ObjectiveToolCallResultContentBlock>]
+          required :content,
+                   -> { Cadenya::Internal::Type::ArrayOf[Cadenya::Objectives::ObjectiveToolCallResultContentBlock] }
+        end
+
+        # @!method initialize(content:)
+        #   ObjectiveToolCallResult is the content a tool returned after execution. Tools
+        #   can return multiple content blocks, and blocks can be multi-modal (text, image,
+        #   audio). Media blocks are stored by Cadenya and served as short-lived signed URLs
+        #   rather than inline bytes.
+        #
+        #   @param content [Array<Cadenya::Models::Objectives::ObjectiveToolCallResultContentBlock>]
+      end
+    end
+
+    ObjectiveToolCallResult = Objectives::ObjectiveToolCallResult
+  end
+end

data/lib/cadenya/models/objectives/objective_tool_call_result_audio_block.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Objectives
+      class ObjectiveToolCallResultAudioBlock < Cadenya::Internal::Type::BaseModel
+        response_only do
+          # @!attribute expires_at
+          #   When the signed URL expires.
+          #
+          #   @return [Time]
+          required :expires_at, Time, api_name: :expiresAt
+
+          # @!attribute mime_type
+          #   IANA media type of the stored audio, e.g. audio/wav.
+          #
+          #   @return [String]
+          required :mime_type, String, api_name: :mimeType
+
+          # @!attribute size_bytes
+          #   Size of the stored audio in bytes.
+          #
+          #   @return [String]
+          required :size_bytes, String, api_name: :sizeBytes
+
+          # @!attribute url
+          #   Short-lived signed URL to download the stored audio.
+          #
+          #   @return [String]
+          required :url, String
+        end
+
+        # @!method initialize(expires_at:, mime_type:, size_bytes:, url:)
+        #   @param expires_at [Time] When the signed URL expires.
+        #
+        #   @param mime_type [String] IANA media type of the stored audio, e.g. audio/wav.
+        #
+        #   @param size_bytes [String] Size of the stored audio in bytes.
+        #
+        #   @param url [String] Short-lived signed URL to download the stored audio.
+      end
+    end
+
+    ObjectiveToolCallResultAudioBlock = Objectives::ObjectiveToolCallResultAudioBlock
+  end
+end

data/lib/cadenya/models/objectives/objective_tool_call_result_content_block.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Objectives
+      class ObjectiveToolCallResultContentBlock < Cadenya::Internal::Type::BaseModel
+        # @!attribute audio
+        #
+        #   @return [Cadenya::Models::Objectives::ObjectiveToolCallResultAudioBlock, nil]
+        optional :audio, -> { Cadenya::Objectives::ObjectiveToolCallResultAudioBlock }
+
+        # @!attribute image
+        #
+        #   @return [Cadenya::Models::Objectives::ObjectiveToolCallResultImageBlock, nil]
+        optional :image, -> { Cadenya::Objectives::ObjectiveToolCallResultImageBlock }
+
+        # @!attribute text
+        #
+        #   @return [Cadenya::Models::Objectives::ObjectiveToolCallResultTextBlock, nil]
+        optional :text, -> { Cadenya::Objectives::ObjectiveToolCallResultTextBlock }
+
+        # @!method initialize(audio: nil, image: nil, text: nil)
+        #   ContentBlock is a single block of tool result content. Exactly one of the
+        #   variants is set.
+        #
+        #   @param audio [Cadenya::Models::Objectives::ObjectiveToolCallResultAudioBlock]
+        #   @param image [Cadenya::Models::Objectives::ObjectiveToolCallResultImageBlock]
+        #   @param text [Cadenya::Models::Objectives::ObjectiveToolCallResultTextBlock]
+      end
+    end
+
+    ObjectiveToolCallResultContentBlock = Objectives::ObjectiveToolCallResultContentBlock
+  end
+end

data/lib/cadenya/models/objectives/objective_tool_call_result_image_block.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Objectives
+      class ObjectiveToolCallResultImageBlock < Cadenya::Internal::Type::BaseModel
+        response_only do
+          # @!attribute expires_at
+          #   When the signed URL expires.
+          #
+          #   @return [Time]
+          required :expires_at, Time, api_name: :expiresAt
+
+          # @!attribute mime_type
+          #   IANA media type of the stored image, e.g. image/png.
+          #
+          #   @return [String]
+          required :mime_type, String, api_name: :mimeType
+
+          # @!attribute size_bytes
+          #   Size of the stored image in bytes.
+          #
+          #   @return [String]
+          required :size_bytes, String, api_name: :sizeBytes
+
+          # @!attribute url
+          #   Short-lived signed URL to download the stored image.
+          #
+          #   @return [String]
+          required :url, String
+        end
+
+        # @!method initialize(expires_at:, mime_type:, size_bytes:, url:)
+        #   @param expires_at [Time] When the signed URL expires.
+        #
+        #   @param mime_type [String] IANA media type of the stored image, e.g. image/png.
+        #
+        #   @param size_bytes [String] Size of the stored image in bytes.
+        #
+        #   @param url [String] Short-lived signed URL to download the stored image.
+      end
+    end
+
+    ObjectiveToolCallResultImageBlock = Objectives::ObjectiveToolCallResultImageBlock
+  end
+end

data/lib/cadenya/models/objectives/objective_tool_call_result_text_block.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Objectives
+      class ObjectiveToolCallResultTextBlock < Cadenya::Internal::Type::BaseModel
+        response_only do
+          # @!attribute text
+          #
+          #   @return [String]
+          required :text, String
+        end
+
+        # @!method initialize(text:)
+        #   @param text [String]
+      end
+    end
+
+    ObjectiveToolCallResultTextBlock = Objectives::ObjectiveToolCallResultTextBlock
+  end
+end

data/lib/cadenya/models/objectives/objective_tool_call_with_result.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Objectives
+      # @see Cadenya::Resources::Objectives::ToolCalls#retrieve
+      class ObjectiveToolCallWithResult < Cadenya::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Cadenya::Models::Objectives::ObjectiveToolCallData]
+        required :data, -> { Cadenya::Objectives::ObjectiveToolCallData }
+
+        # @!attribute info
+        #
+        #   @return [Cadenya::Models::Objectives::ObjectiveToolCallInfo]
+        required :info, -> { Cadenya::Objectives::ObjectiveToolCallInfo }
+
+        # @!attribute metadata
+        #   Metadata for ephemeral operations and activities (e.g., objectives, executions,
+        #   runs)
+        #
+        #   @return [Cadenya::Models::OperationMetadata]
+        required :metadata, -> { Cadenya::OperationMetadata }
+
+        # @!attribute status
+        #   Current status of the tool call
+        #
+        #   @return [Symbol, Cadenya::Models::Objectives::ObjectiveToolCallWithResult::Status]
+        required :status, enum: -> { Cadenya::Objectives::ObjectiveToolCallWithResult::Status }
+
+        response_only do
+          # @!attribute execution_status
+          #
+          #   @return [Symbol, Cadenya::Models::Objectives::ObjectiveToolCallWithResult::ExecutionStatus]
+          required :execution_status,
+                   enum: -> { Cadenya::Objectives::ObjectiveToolCallWithResult::ExecutionStatus },
+                   api_name: :executionStatus
+
+          # @!attribute result
+          #   ObjectiveToolCallResult is the content a tool returned after execution. Tools
+          #   can return multiple content blocks, and blocks can be multi-modal (text, image,
+          #   audio). Media blocks are stored by Cadenya and served as short-lived signed URLs
+          #   rather than inline bytes.
+          #
+          #   @return [Cadenya::Models::Objectives::ObjectiveToolCallResult, nil]
+          optional :result, -> { Cadenya::Objectives::ObjectiveToolCallResult }
+        end
+
+        # @!method initialize(data:, execution_status:, info:, metadata:, status:, result: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Objectives::ObjectiveToolCallWithResult} for more details.
+        #
+        #   ObjectiveToolCallWithResult is an ObjectiveToolCall plus the content the tool
+        #   returned. Returned by GetObjectiveToolCall.
+        #
+        #   @param data [Cadenya::Models::Objectives::ObjectiveToolCallData]
+        #
+        #   @param execution_status [Symbol, Cadenya::Models::Objectives::ObjectiveToolCallWithResult::ExecutionStatus]
+        #
+        #   @param info [Cadenya::Models::Objectives::ObjectiveToolCallInfo]
+        #
+        #   @param metadata [Cadenya::Models::OperationMetadata] Metadata for ephemeral operations and activities (e.g., objectives, executions,
+        #
+        #   @param status [Symbol, Cadenya::Models::Objectives::ObjectiveToolCallWithResult::Status] Current status of the tool call
+        #
+        #   @param result [Cadenya::Models::Objectives::ObjectiveToolCallResult] ObjectiveToolCallResult is the content a tool returned after execution.
+
+        # @see Cadenya::Models::Objectives::ObjectiveToolCallWithResult#execution_status
+        module ExecutionStatus
+          extend Cadenya::Internal::Type::Enum
+
+          TOOL_CALL_EXECUTION_STATUS_UNSPECIFIED = :TOOL_CALL_EXECUTION_STATUS_UNSPECIFIED
+          TOOL_CALL_EXECUTION_STATUS_PENDING = :TOOL_CALL_EXECUTION_STATUS_PENDING
+          TOOL_CALL_EXECUTION_STATUS_RUNNING = :TOOL_CALL_EXECUTION_STATUS_RUNNING
+          TOOL_CALL_EXECUTION_STATUS_COMPLETED = :TOOL_CALL_EXECUTION_STATUS_COMPLETED
+          TOOL_CALL_EXECUTION_STATUS_ERRORED = :TOOL_CALL_EXECUTION_STATUS_ERRORED
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Current status of the tool call
+        #
+        # @see Cadenya::Models::Objectives::ObjectiveToolCallWithResult#status
+        module Status
+          extend Cadenya::Internal::Type::Enum
+
+          TOOL_CALL_STATUS_UNSPECIFIED = :TOOL_CALL_STATUS_UNSPECIFIED
+          TOOL_CALL_STATUS_AUTO_APPROVED = :TOOL_CALL_STATUS_AUTO_APPROVED
+          TOOL_CALL_STATUS_WAITING_FOR_APPROVAL = :TOOL_CALL_STATUS_WAITING_FOR_APPROVAL
+          TOOL_CALL_STATUS_APPROVED = :TOOL_CALL_STATUS_APPROVED
+          TOOL_CALL_STATUS_DENIED = :TOOL_CALL_STATUS_DENIED
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+
+    ObjectiveToolCallWithResult = Objectives::ObjectiveToolCallWithResult
+  end
+end

data/lib/cadenya/models/objectives/tool_call_retrieve_params.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Objectives
+      # @see Cadenya::Resources::Objectives::ToolCalls#retrieve
+      class ToolCallRetrieveParams < 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 tool_call_id
+        #
+        #   @return [String]
+        required :tool_call_id, String
+
+        # @!method initialize(workspace_id:, objective_id:, tool_call_id:, request_options: {})
+        #   @param workspace_id [String]
+        #   @param objective_id [String]
+        #   @param tool_call_id [String]
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/cadenya/models/tool_result.rb

@@ -3,18 +3,26 @@
 module Cadenya
   module Models
     class ToolResult < Cadenya::Internal::Type::BaseModel
-      # @!attribute content
+      # @!attribute result
+      #   ObjectiveToolCallResult is the content a tool returned after execution. Tools
+      #   can return multiple content blocks, and blocks can be multi-modal (text, image,
+      #   audio). Media blocks are stored by Cadenya and served as short-lived signed URLs
+      #   rather than inline bytes.
       #
-      #   @return [String, nil]
-      optional :content, String
+      #   @return [Cadenya::Models::Objectives::ObjectiveToolCallResult]
+      required :result, -> { Cadenya::Objectives::ObjectiveToolCallResult }
 
       # @!attribute tool_call_id
       #
-      #   @return [String, nil]
-      optional :tool_call_id, String, api_name: :toolCallId
+      #   @return [String]
+      required :tool_call_id, String, api_name: :toolCallId
 
-      # @!method initialize(content: nil, tool_call_id: nil)
-      #   @param content [String]
+      # @!method initialize(result:, tool_call_id:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ToolResult} for more details.
+      #
+      #   @param result [Cadenya::Models::Objectives::ObjectiveToolCallResult] ObjectiveToolCallResult is the content a tool returned after execution.
+      #
       #   @param tool_call_id [String]
     end
   end