cadenya 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eccefbddc3e445e6a54402fc8a5eba71d7cb44baa645cb15177c73fbc52978da
-  data.tar.gz: 4e9a538a35dca88e184acac8d92e0db0dd7209346583e193d83bf6753be34ba8
+  metadata.gz: cc33022d12e62f8273e8a7aa25cc2f020c231e6ce29f66775f9b144747d5658f
+  data.tar.gz: 619df9b5f16e896b922e1f8a1fa312f175a869154eb78a54c29a641e20f09b6b
 SHA512:
-  metadata.gz: 10fa27a5fcd86594aa52b339718a896037884aa27323d2d668a598f5058db98930e7a1426d608e5196306946f3184785709ca3bcb0f5df846df3758fd10a4218
-  data.tar.gz: e84213d6dd22de862fbb36859443c9eb6da7784ac5a921d3c2c11db603c104710b62aab859d3897e683a31e5ab8e6db57952a3dce3723b01308174eff93eab9c
+  metadata.gz: 67d08c0901b15069f74e1a8a071876d9ac7c2871f5d73c2986c28ce4b6c01fe564a3385e6bd932f018a6392094d10e3d0a860f9bcd199435cc4fb99beb3a52d4
+  data.tar.gz: e6bd7a52e5e2a517108f7eeb6a3902c4662ed72c4158e06da10fc0862fc9292191d479ede3e87662a6104d9a680fe62d9e05d51be0f3b15ed9015907780415f4

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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)

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.12.0"
 ```
 
 <!-- x-release-please-end -->

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

data/lib/cadenya/resources/objectives/tool_calls.rb

@@ -4,6 +4,45 @@ module Cadenya
   module Resources
     class Objectives
       class ToolCalls
+        # Retrieves a single tool call, including the content the tool returned. Media
+        # content (images, audio) is served as short-lived signed URLs.
+        #
+        # @overload retrieve(tool_call_id, workspace_id:, objective_id:, request_options: {})
+        #
+        # @param tool_call_id [String] The ID of the tool call to retrieve
+        #
+        # @param workspace_id [String]
+        #
+        # @param objective_id [String] The ID of the objective. Supports "external_id:" prefix for external IDs.
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Models::Objectives::ObjectiveToolCallWithResult]
+        #
+        # @see Cadenya::Models::Objectives::ToolCallRetrieveParams
+        def retrieve(tool_call_id, params)
+          parsed, options = Cadenya::Objectives::ToolCallRetrieveParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          objective_id =
+            parsed.delete(:objective_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :get,
+            path: [
+              "v1/workspaces/%1$s/objectives/%2$s/tool_calls/%3$s",
+              workspace_id,
+              objective_id,
+              tool_call_id
+            ],
+            model: Cadenya::Objectives::ObjectiveToolCallWithResult,
+            options: options
+          )
+        end
+
         # Lists all tool calls for an objective
         #
         # @overload list(objective_id, workspace_id:, cursor: nil, include_info: nil, limit: nil, status: nil, request_options: {})

data/lib/cadenya/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cadenya
-  VERSION = "0.11.0"
+  VERSION = "0.12.0"
 end

data/lib/cadenya.rb

@@ -224,11 +224,18 @@ require_relative "cadenya/models/objectives/objective_tool"
 require_relative "cadenya/models/objectives/objective_tool_call"
 require_relative "cadenya/models/objectives/objective_tool_call_data"
 require_relative "cadenya/models/objectives/objective_tool_call_info"
+require_relative "cadenya/models/objectives/objective_tool_call_result"
+require_relative "cadenya/models/objectives/objective_tool_call_result_audio_block"
+require_relative "cadenya/models/objectives/objective_tool_call_result_content_block"
+require_relative "cadenya/models/objectives/objective_tool_call_result_image_block"
+require_relative "cadenya/models/objectives/objective_tool_call_result_text_block"
+require_relative "cadenya/models/objectives/objective_tool_call_with_result"
 require_relative "cadenya/models/objectives/task_list_params"
 require_relative "cadenya/models/objectives/task_retrieve_params"
 require_relative "cadenya/models/objectives/tool_call_approve_params"
 require_relative "cadenya/models/objectives/tool_call_deny_params"
 require_relative "cadenya/models/objectives/tool_call_list_params"
+require_relative "cadenya/models/objectives/tool_call_retrieve_params"
 require_relative "cadenya/models/objectives/tool_list_params"
 require_relative "cadenya/models/objective_secret"
 require_relative "cadenya/models/operation_metadata"

data/rbi/cadenya/models/objectives/objective_tool_call_data.rbi

@@ -38,13 +38,6 @@ module Cadenya
         sig { params(memo: String).void }
         attr_writer :memo
 
-        # The result content returned by the tool after execution
-        sig { returns(T.nilable(String)) }
-        attr_reader :result
-
-        sig { params(result: String).void }
-        attr_writer :result
-
         # 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.
@@ -59,7 +52,6 @@ module Cadenya
             callable: Cadenya::CallableTool::OrHash,
             arguments: T::Hash[Symbol, T.anything],
             memo: String,
-            result: String,
             status_changed_by: Cadenya::Profile::OrHash
           ).returns(T.attached_class)
         end
@@ -73,8 +65,6 @@ module Cadenya
           arguments: nil,
           # A memo supplied by the reviewer when denying the tool call
           memo: nil,
-          # The result content returned by the tool after execution
-          result: nil,
           # 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.
@@ -88,7 +78,6 @@ module Cadenya
               callable: Cadenya::CallableTool,
               arguments: T::Hash[Symbol, T.anything],
               memo: String,
-              result: String,
               status_changed_by: Cadenya::Profile
             }
           )

data/rbi/cadenya/models/objectives/objective_tool_call_result.rbi

@@ -0,0 +1,54 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    ObjectiveToolCallResult = Objectives::ObjectiveToolCallResult
+
+    module Objectives
+      class ObjectiveToolCallResult < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Objectives::ObjectiveToolCallResult,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        sig do
+          returns(
+            T::Array[Cadenya::Objectives::ObjectiveToolCallResultContentBlock]
+          )
+        end
+        attr_accessor :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.
+        sig do
+          params(
+            content:
+              T::Array[
+                Cadenya::Objectives::ObjectiveToolCallResultContentBlock::OrHash
+              ]
+          ).returns(T.attached_class)
+        end
+        def self.new(content:)
+        end
+
+        sig do
+          override.returns(
+            {
+              content:
+                T::Array[
+                  Cadenya::Objectives::ObjectiveToolCallResultContentBlock
+                ]
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/objectives/objective_tool_call_result_audio_block.rbi

@@ -0,0 +1,69 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    ObjectiveToolCallResultAudioBlock =
+      Objectives::ObjectiveToolCallResultAudioBlock
+
+    module Objectives
+      class ObjectiveToolCallResultAudioBlock < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Objectives::ObjectiveToolCallResultAudioBlock,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # When the signed URL expires.
+        sig { returns(Time) }
+        attr_accessor :expires_at
+
+        # IANA media type of the stored audio, e.g. audio/wav.
+        sig { returns(String) }
+        attr_accessor :mime_type
+
+        # Size of the stored audio in bytes.
+        sig { returns(String) }
+        attr_accessor :size_bytes
+
+        # Short-lived signed URL to download the stored audio.
+        sig { returns(String) }
+        attr_accessor :url
+
+        sig do
+          params(
+            expires_at: Time,
+            mime_type: String,
+            size_bytes: String,
+            url: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # When the signed URL expires.
+          expires_at:,
+          # IANA media type of the stored audio, e.g. audio/wav.
+          mime_type:,
+          # Size of the stored audio in bytes.
+          size_bytes:,
+          # Short-lived signed URL to download the stored audio.
+          url:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              expires_at: Time,
+              mime_type: String,
+              size_bytes: String,
+              url: String
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end