cadenya 0.11.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eccefbddc3e445e6a54402fc8a5eba71d7cb44baa645cb15177c73fbc52978da
-  data.tar.gz: 4e9a538a35dca88e184acac8d92e0db0dd7209346583e193d83bf6753be34ba8
+  metadata.gz: 9d745ee46b5834e75465c12e027582ba88c12d3ec89e31546dba9fbb952a52ae
+  data.tar.gz: 14109f1c53873b94aac6562a48669211f8845299f19ec8d10ff89968f2f5e862
 SHA512:
-  metadata.gz: 10fa27a5fcd86594aa52b339718a896037884aa27323d2d668a598f5058db98930e7a1426d608e5196306946f3184785709ca3bcb0f5df846df3758fd10a4218
-  data.tar.gz: e84213d6dd22de862fbb36859443c9eb6da7784ac5a921d3c2c11db603c104710b62aab859d3897e683a31e5ab8e6db57952a3dce3723b01308174eff93eab9c
+  metadata.gz: 0ee1346f5e40ac85863bfe7ea5181159a810e92a1f68c0f83e357887caa589c711aa167a03061483b82ef8d2856c7497466817b09794379fb47b3cf534be5786
+  data.tar.gz: 36de46a6cd4079c7f527c33c71126c54c6f74db804452e2ba90838b4bfa6a0fc03e65654b8360944653f38d05bc7da357d2f86383284f058cc74b3e490f5b90e

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.13.0 (2026-06-11)
+
+Full Changelog: [v0.12.0...v0.13.0](https://github.com/cadenya/cadenya-ruby/compare/v0.12.0...v0.13.0)
+
+### Features
+
+* **api:** api update ([9a5ddd6](https://github.com/cadenya/cadenya-ruby/commit/9a5ddd6a2e2628aa7a73894216112b252ca8b0ba))
+
+## 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)

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.11.0"
+gem "cadenya", "~> 0.13.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/cadenya/models/agent_spec.rb

@@ -18,6 +18,24 @@ module Cadenya
       #   @return [String, nil]
       optional :description, String
 
+      # @!attribute enable_episodic_memory
+      #   Enable episodic memory for objectives created for this agent. When true,
+      #   objective creation requires an episodic_memory key and the system finds or
+      #   creates a memory layer for that (agent, key) pair, letting the agent store and
+      #   retrieve memories across objectives that share the key. Memory is agent-level so
+      #   all variations of the agent share the same layers.
+      #
+      #   @return [Boolean, nil]
+      optional :enable_episodic_memory, Cadenya::Internal::Type::Boolean, api_name: :enableEpisodicMemory
+
+      # @!attribute episodic_memory_ttl
+      #   How long episodic memories should be retained. Each new objective slides the
+      #   layer's expiry forward by this duration, and stored entries expire this long
+      #   after they are written. If not set, episodic memories are retained indefinitely.
+      #
+      #   @return [Integer, nil]
+      optional :episodic_memory_ttl, Integer, api_name: :episodicMemoryTtl
+
       # @!attribute input_data_schema
       #   InputDataSchema is used for enforcing a data input when objectives are created.
       #   This is valuable when using liquid formatting in agent variation prompts. Input
@@ -47,7 +65,7 @@ module Cadenya
       #   @return [String, nil]
       optional :webhook_events_url, String, api_name: :webhookEventsUrl
 
-      # @!method initialize(variation_selection_mode:, description: nil, input_data_schema: nil, output_definition: nil, webhook_events_url: nil)
+      # @!method initialize(variation_selection_mode:, description: nil, enable_episodic_memory: nil, episodic_memory_ttl: nil, input_data_schema: nil, output_definition: nil, webhook_events_url: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::AgentSpec} for more details.
       #
@@ -57,6 +75,10 @@ module Cadenya
       #
       #   @param description [String] Description of the agent's purpose
       #
+      #   @param enable_episodic_memory [Boolean] Enable episodic memory for objectives created for this agent.
+      #
+      #   @param episodic_memory_ttl [Integer] How long episodic memories should be retained.
+      #
       #   @param input_data_schema [Hash{Symbol=>Object}] InputDataSchema is used for enforcing a data input when objectives are created.
       #
       #   @param output_definition [Hash{Symbol=>Object}] Optional output definition for objectives created for this agent.

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

@@ -25,23 +25,6 @@ module Cadenya
         #   @return [String, nil]
         optional :description, String
 
-        # @!attribute enable_episodic_memory
-        #   Enable episodic memory for objectives using this variation. When true, the
-        #   system automatically creates a document namespace for each objective using the
-        #   objective's episodic_key as the external_id, allowing the agent to store and
-        #   retrieve documents specific to that episode.
-        #
-        #   @return [Boolean, nil]
-        optional :enable_episodic_memory, Cadenya::Internal::Type::Boolean, api_name: :enableEpisodicMemory
-
-        # @!attribute episodic_memory_ttl
-        #   How long episodic memories should be retained. After this duration, episodic
-        #   document namespaces can be automatically cleaned up. If not set, episodic
-        #   memories are retained indefinitely.
-        #
-        #   @return [Integer, nil]
-        optional :episodic_memory_ttl, Integer, api_name: :episodicMemoryTtl
-
         # @!attribute model_config
         #   ModelConfig defines the model configuration for a variation
         #
@@ -86,7 +69,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, system_prompt_template: nil, user_message_template: nil, weight: nil)
+        # @!method initialize(compaction_config: nil, constraints: nil, description: nil, model_config: nil, progressive_discovery: nil, system_prompt_template: nil, user_message_template: nil, weight: nil)
         #   Some parameter documentations has been truncated, see
         #   {Cadenya::Models::Agents::AgentVariationSpec} for more details.
         #
@@ -98,10 +81,6 @@ module Cadenya
         #
         #   @param description [String] Human-readable description of what this variation does or when it should be used
         #
-        #   @param enable_episodic_memory [Boolean] Enable episodic memory for objectives using this variation.
-        #
-        #   @param episodic_memory_ttl [Integer] How long episodic memories should be retained.
-        #
         #   @param model_config [Cadenya::Models::Agents::AgentVariationSpecModelConfig] ModelConfig defines the model configuration for a variation
         #
         #   @param progressive_discovery [Cadenya::Models::Agents::AgentVariationSpecProgressiveDiscovery] ProgressiveDiscovery is used to indicate that the agent should automatically dis

data/lib/cadenya/models/memory_layer_list_params.rb

@@ -12,6 +12,12 @@ module Cadenya
       #   @return [String]
       required :workspace_id, String
 
+      # @!attribute agent_id
+      #   Filter to episodic layers belonging to this agent.
+      #
+      #   @return [String, nil]
+      optional :agent_id, String
+
       # @!attribute bundle_key
       #   Filter by bundle_key — return only resources owned by this bundle.
       #
@@ -24,6 +30,14 @@ module Cadenya
       #   @return [String, nil]
       optional :cursor, String
 
+      # @!attribute episodic_key_prefix
+      #   Filter to episodic layers whose episodic key starts with this prefix (e.g.
+      #   "customer/" matches "customer/42" and "customer/43"). Useful for namespaced
+      #   keys, similar to a redis key scan.
+      #
+      #   @return [String, nil]
+      optional :episodic_key_prefix, String
+
       # @!attribute include_info
       #   When set to true you may use more of your alloted API rate-limit
       #
@@ -60,13 +74,20 @@ module Cadenya
       #   @return [Symbol, Cadenya::Models::MemoryLayerListParams::Type, nil]
       optional :type, enum: -> { Cadenya::MemoryLayerListParams::Type }
 
-      # @!method initialize(workspace_id:, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, type: nil, request_options: {})
+      # @!method initialize(workspace_id:, agent_id: nil, bundle_key: nil, cursor: nil, episodic_key_prefix: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, type: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::MemoryLayerListParams} for more details.
+      #
       #   @param workspace_id [String]
       #
+      #   @param agent_id [String] Filter to episodic layers belonging to this agent.
+      #
       #   @param bundle_key [String] Filter by bundle_key — return only resources owned by this bundle.
       #
       #   @param cursor [String] Pagination cursor from previous response
       #
+      #   @param episodic_key_prefix [String] Filter to episodic layers whose episodic key starts with this prefix
+      #
       #   @param include_info [Boolean] When set to true you may use more of your alloted API rate-limit
       #
       #   @param limit [Integer] Maximum number of results to return

data/lib/cadenya/models/memory_layer_spec.rb

@@ -16,6 +16,20 @@ module Cadenya
       optional :description, String
 
       response_only do
+        # @!attribute agent_id
+        #   Server-set on episodic layers: the agent this layer belongs to. Unset for
+        #   non-episodic layers.
+        #
+        #   @return [String, nil]
+        optional :agent_id, String, api_name: :agentId
+
+        # @!attribute episodic_key
+        #   Server-set on episodic layers: the caller-supplied episodic key the layer was
+        #   created for. Unset for non-episodic layers.
+        #
+        #   @return [String, nil]
+        optional :episodic_key, String, api_name: :episodicKey
+
         # @!attribute expires_at
         #   For layers with a finite lifetime (e.g., episodic), the time at which the layer
         #   becomes eligible for cleanup. Set by the system; unset for persistent layers.
@@ -33,14 +47,18 @@ module Cadenya
         optional :system_managed, Cadenya::Internal::Type::Boolean, api_name: :systemManaged
       end
 
-      # @!method initialize(type:, description: nil, expires_at: nil, system_managed: nil)
+      # @!method initialize(type:, agent_id: nil, description: nil, episodic_key: nil, expires_at: nil, system_managed: nil)
       #   Some parameter documentations has been truncated, see
       #   {Cadenya::Models::MemoryLayerSpec} for more details.
       #
       #   @param type [Symbol, Cadenya::Models::MemoryLayerSpec::Type]
       #
+      #   @param agent_id [String] Server-set on episodic layers: the agent this layer belongs to. Unset for
+      #
       #   @param description [String] Human-readable description of the layer's purpose. Encouraged for
       #
+      #   @param episodic_key [String] Server-set on episodic layers: the caller-supplied episodic key the layer
+      #
       #   @param expires_at [Time] For layers with a finite lifetime (e.g., episodic), the time at which the
       #
       #   @param system_managed [Boolean] Server-set. True for layers managed by the system (e.g., episodic layers

data/lib/cadenya/models/objective.rb

@@ -18,6 +18,12 @@ module Cadenya
       #   @return [Cadenya::Models::OperationMetadata]
       required :metadata, -> { Cadenya::OperationMetadata }
 
+      # @!attribute episodic_memory
+      #   Episodic is used to configure the episodic memory for the objective
+      #
+      #   @return [Cadenya::Models::Objective::EpisodicMemory, nil]
+      optional :episodic_memory, -> { Cadenya::Objective::EpisodicMemory }, api_name: :episodicMemory
+
       # @!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.
@@ -110,7 +116,7 @@ module Cadenya
                  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, user_data: nil)
+      # @!method initialize(config_snapshot:, initial_message:, metadata:, state:, system_prompt:, data: nil, episodic_memory: 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.
       #
@@ -130,6 +136,8 @@ module Cadenya
       #
       #   @param data [Hash{Symbol=>Object}] Arbitrary data for the objective
       #
+      #   @param episodic_memory [Cadenya::Models::Objective::EpisodicMemory] Episodic is used to configure the episodic memory for the objective
+      #
       #   @param info [Cadenya::Models::ObjectiveInfo] ObjectiveInfo provides read-only aggregated statistics about an objective's exec
       #
       #   @param memory_stack [Array<Cadenya::Models::MemoryReference>] Memory layers/entries to push onto this objective's memory stack on
@@ -161,6 +169,35 @@ module Cadenya
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      # @see Cadenya::Models::Objective#episodic_memory
+      class EpisodicMemory < Cadenya::Internal::Type::BaseModel
+        # @!attribute key
+        #   The caller-supplied episodic key. Objectives created with the same key (for the
+        #   same agent) share one episodic memory layer.
+        #
+        #   @return [String, nil]
+        optional :key, String
+
+        response_only do
+          # @!attribute memory_layer_id
+          #   The episodic memory layer resolved (created or reused) for this objective's key.
+          #   Populated by the system at objective creation.
+          #
+          #   @return [String, nil]
+          optional :memory_layer_id, String, api_name: :memoryLayerId
+        end
+
+        # @!method initialize(key: nil, memory_layer_id: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Objective::EpisodicMemory} for more details.
+        #
+        #   Episodic is used to configure the episodic memory for the objective
+        #
+        #   @param key [String] The caller-supplied episodic key. Objectives created with the same key
+        #
+        #   @param memory_layer_id [String] The episodic memory layer resolved (created or reused) for this
+      end
     end
   end
 end

data/lib/cadenya/models/objective_create_params.rb

@@ -24,6 +24,14 @@ module Cadenya
       #   @return [Hash{Symbol=>Object}]
       required :data, Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown]
 
+      # @!attribute episodic_memory
+      #   Episodic is used to configure the episodic memory for the objective
+      #
+      #   @return [Cadenya::Models::ObjectiveCreateParams::EpisodicMemory, nil]
+      optional :episodic_memory,
+               -> { Cadenya::ObjectiveCreateParams::EpisodicMemory },
+               api_name: :episodicMemory
+
       # @!attribute initial_message
       #   Optional override for the initial message sent to the agent. This becomes the
       #   first user message in the LLM chat history. When not set, the selected
@@ -88,7 +96,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, user_data: nil, variation_id: nil, request_options: {})
+      # @!method initialize(workspace_id:, agent_id:, data:, episodic_memory: nil, 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.
       #
@@ -98,6 +106,8 @@ module Cadenya
       #
       #   @param data [Hash{Symbol=>Object}] Arbitrary data for the objective. May be used in liquid templates for prompts co
       #
+      #   @param episodic_memory [Cadenya::Models::ObjectiveCreateParams::EpisodicMemory] Episodic is used to configure the episodic memory for the objective
+      #
       #   @param initial_message [String] Optional override for the initial message sent to the agent. This becomes the fi
       #
       #   @param memory_stack [Array<Cadenya::Models::MemoryReference>] Memory layers/entries to push onto this objective's memory stack on
@@ -112,6 +122,23 @@ module Cadenya
       #
       #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
 
+      class EpisodicMemory < Cadenya::Internal::Type::BaseModel
+        # @!attribute key
+        #   The caller-supplied episodic key. Objectives created with the same key (for the
+        #   same agent) share one episodic memory layer.
+        #
+        #   @return [String, nil]
+        optional :key, String
+
+        # @!method initialize(key: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ObjectiveCreateParams::EpisodicMemory} for more details.
+        #
+        #   Episodic is used to configure the episodic memory for the objective
+        #
+        #   @param key [String] The caller-supplied episodic key. Objectives created with the same key
+      end
+
       class Secret < Cadenya::Internal::Type::BaseModel
         # @!attribute name
         #

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