openai 0.27.1 → 0.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 771318c0267e149df16523a1341d80a925d09a4d020fc12602e7da3c91e57ca0
-  data.tar.gz: cb371db328139f92e1c2ae38b8ef9a533a2d38f04947156ec5d8415cb753d301
+  metadata.gz: 01342bdfdf8f3ad25ed0b3266cae9dc3022f3356ed7b6268d01164e10702ce69
+  data.tar.gz: f49a9c99e8441520c6ed0fcfc5acac72d0622c73c811ae5462d2c4d615f66e54
 SHA512:
-  metadata.gz: 12a9667f62fbe9fc9d4ba150490ff2484a82f283c3dfb4ef82fdbf64d70ba507509ac6c593b6597e93255c576f1f123c8b5e5bfacfbc2954c4bb305a6bc087db
-  data.tar.gz: 248f09914e2785bcbc96cc6ff3a7fbd52a19da1e6c8418c0434ccfc5ed756be88fe8c20056fe222b4030f5487b17da5a631f876c66d8a7bccb957499165e98c5
+  metadata.gz: 5ce27503d671f912a27cd1e9e0dfb78088ec362aa1697c9fbaf938882bb5f7e6fc25e7c7e50b2a6b8bb7ec84acb356a9ce3756885084ddf6aa0def3f8841c245
+  data.tar.gz: bad48c4d256ff7d274432f6361432adca1c0cba1696f75c42f656757f3cdc9bd5913c695184bb3307e9f93e360d745c87002cbc96333bd6af960a912ee19e7dd

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.28.0 (2025-09-30)
+
+Full Changelog: [v0.27.1...v0.28.0](https://github.com/openai/openai-ruby/compare/v0.27.1...v0.28.0)
+
+### ⚠ BREAKING CHANGES
+
+* **api:** `ResponseFunctionToolCallOutputItem.output` and `ResponseCustomToolCallOutput.output` now return `string | Array<ResponseInputText | ResponseInputImage | ResponseInputFile>` instead of `string` only. This may break existing callsites that assume `output` is always a string.
+
+### Features
+
+* **api:** Support images and files for function call outputs in responses, BatchUsage ([904348a](https://github.com/openai/openai-ruby/commit/904348a26c713601f10063fef73f9982088aa438))
+
+
+### Bug Fixes
+
+* coroutine leaks from connection pool ([7f0b3cd](https://github.com/openai/openai-ruby/commit/7f0b3cdfee0232dbfa1800029ba80f5470f95c13))
+
 ## 0.27.1 (2025-09-29)
 
 Full Changelog: [v0.27.0...v0.27.1](https://github.com/openai/openai-ruby/compare/v0.27.0...v0.27.1)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "openai", "~> 0.27.1"
+gem "openai", "~> 0.28.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/openai/internal/transport/pooled_net_requester.rb

@@ -134,9 +134,9 @@ module OpenAI
 
           # rubocop:disable Metrics/BlockLength
           enum = Enumerator.new do |y|
-            with_pool(url, deadline: deadline) do |conn|
-              next if finished
+            next if finished
 
+            with_pool(url, deadline: deadline) do |conn|
               req, closing = self.class.build_request(request) do
                 self.class.calibrate_socket_timeout(conn, deadline)
               end
@@ -149,7 +149,7 @@ module OpenAI
 
               self.class.calibrate_socket_timeout(conn, deadline)
               conn.request(req) do |rsp|
-                y << [conn, req, rsp]
+                y << [req, rsp]
                 break if finished
 
                 rsp.read_body do |bytes|
@@ -160,6 +160,8 @@ module OpenAI
                 end
                 eof = true
               end
+            ensure
+              conn.finish if !eof && conn&.started?
             end
           rescue Timeout::Error
             raise OpenAI::Errors::APITimeoutError.new(url: url, request: req)
@@ -168,16 +170,11 @@ module OpenAI
           end
           # rubocop:enable Metrics/BlockLength
 
-          conn, _, response = enum.next
+          _, response = enum.next
           body = OpenAI::Internal::Util.fused_enum(enum, external: true) do
             finished = true
-            tap do
-              enum.next
-            rescue StopIteration
-              nil
-            end
+            loop { enum.next }
           ensure
-            conn.finish if !eof && conn&.started?
             closing&.call
           end
           [Integer(response.code), response, body]

data/lib/openai/internal/type/base_stream.rb

@@ -13,21 +13,6 @@ module OpenAI
       module BaseStream
         include Enumerable
 
-        class << self
-          # Attempt to close the underlying transport when the stream itself is garbage
-          # collected.
-          #
-          # This should not be relied upon for resource clean up, as the garbage collector
-          # is not guaranteed to run.
-          #
-          # @param stream [Enumerable<Object>]
-          #
-          # @return [Proc]
-          #
-          # @see https://rubyapi.org/3.2/o/objectspace#method-c-define_finalizer
-          def defer_closing(stream) = ->(_id) { OpenAI::Internal::Util.close_fused!(stream) }
-        end
-
         # @return [Integer]
         attr_reader :status
 
@@ -82,8 +67,6 @@ module OpenAI
           @unwrap = unwrap
           @stream = stream
           @iterator = iterator
-
-          ObjectSpace.define_finalizer(self, OpenAI::Internal::Type::BaseStream.defer_closing(@stream))
         end
 
         # @api private

data/lib/openai/models/batch.rb

@@ -115,6 +115,16 @@ module OpenAI
       #   @return [Hash{Symbol=>String}, nil]
       optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
+      # @!attribute model
+      #   Model ID used to process the batch, like `gpt-5-2025-08-07`. OpenAI offers a
+      #   wide range of models with different capabilities, performance characteristics,
+      #   and price points. Refer to the
+      #   [model guide](https://platform.openai.com/docs/models) to browse and compare
+      #   available models.
+      #
+      #   @return [String, nil]
+      optional :model, String
+
       # @!attribute output_file_id
       #   The ID of the file containing the outputs of successfully executed requests.
       #
@@ -127,7 +137,15 @@ module OpenAI
       #   @return [OpenAI::Models::BatchRequestCounts, nil]
       optional :request_counts, -> { OpenAI::BatchRequestCounts }
 
-      # @!method initialize(id:, completion_window:, created_at:, endpoint:, input_file_id:, status:, cancelled_at: nil, cancelling_at: nil, completed_at: nil, error_file_id: nil, errors: nil, expired_at: nil, expires_at: nil, failed_at: nil, finalizing_at: nil, in_progress_at: nil, metadata: nil, output_file_id: nil, request_counts: nil, object: :batch)
+      # @!attribute usage
+      #   Represents token usage details including input tokens, output tokens, a
+      #   breakdown of output tokens, and the total tokens used. Only populated on batches
+      #   created after September 7, 2025.
+      #
+      #   @return [OpenAI::Models::BatchUsage, nil]
+      optional :usage, -> { OpenAI::BatchUsage }
+
+      # @!method initialize(id:, completion_window:, created_at:, endpoint:, input_file_id:, status:, cancelled_at: nil, cancelling_at: nil, completed_at: nil, error_file_id: nil, errors: nil, expired_at: nil, expires_at: nil, failed_at: nil, finalizing_at: nil, in_progress_at: nil, metadata: nil, model: nil, output_file_id: nil, request_counts: nil, usage: nil, object: :batch)
       #   Some parameter documentations has been truncated, see {OpenAI::Models::Batch}
       #   for more details.
       #
@@ -165,10 +183,14 @@ module OpenAI
       #
       #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
       #
+      #   @param model [String] Model ID used to process the batch, like `gpt-5-2025-08-07`. OpenAI
+      #
       #   @param output_file_id [String] The ID of the file containing the outputs of successfully executed requests.
       #
       #   @param request_counts [OpenAI::Models::BatchRequestCounts] The request counts for different statuses within the batch.
       #
+      #   @param usage [OpenAI::Models::BatchUsage] Represents token usage details including input tokens, output tokens, a
+      #
       #   @param object [Symbol, :batch] The object type, which is always `batch`.
 
       # The current status of the batch.

data/lib/openai/models/batch_usage.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    class BatchUsage < OpenAI::Internal::Type::BaseModel
+      # @!attribute input_tokens
+      #   The number of input tokens.
+      #
+      #   @return [Integer]
+      required :input_tokens, Integer
+
+      # @!attribute input_tokens_details
+      #   A detailed breakdown of the input tokens.
+      #
+      #   @return [OpenAI::Models::BatchUsage::InputTokensDetails]
+      required :input_tokens_details, -> { OpenAI::BatchUsage::InputTokensDetails }
+
+      # @!attribute output_tokens
+      #   The number of output tokens.
+      #
+      #   @return [Integer]
+      required :output_tokens, Integer
+
+      # @!attribute output_tokens_details
+      #   A detailed breakdown of the output tokens.
+      #
+      #   @return [OpenAI::Models::BatchUsage::OutputTokensDetails]
+      required :output_tokens_details, -> { OpenAI::BatchUsage::OutputTokensDetails }
+
+      # @!attribute total_tokens
+      #   The total number of tokens used.
+      #
+      #   @return [Integer]
+      required :total_tokens, Integer
+
+      # @!method initialize(input_tokens:, input_tokens_details:, output_tokens:, output_tokens_details:, total_tokens:)
+      #   Represents token usage details including input tokens, output tokens, a
+      #   breakdown of output tokens, and the total tokens used. Only populated on batches
+      #   created after September 7, 2025.
+      #
+      #   @param input_tokens [Integer] The number of input tokens.
+      #
+      #   @param input_tokens_details [OpenAI::Models::BatchUsage::InputTokensDetails] A detailed breakdown of the input tokens.
+      #
+      #   @param output_tokens [Integer] The number of output tokens.
+      #
+      #   @param output_tokens_details [OpenAI::Models::BatchUsage::OutputTokensDetails] A detailed breakdown of the output tokens.
+      #
+      #   @param total_tokens [Integer] The total number of tokens used.
+
+      # @see OpenAI::Models::BatchUsage#input_tokens_details
+      class InputTokensDetails < OpenAI::Internal::Type::BaseModel
+        # @!attribute cached_tokens
+        #   The number of tokens that were retrieved from the cache.
+        #   [More on prompt caching](https://platform.openai.com/docs/guides/prompt-caching).
+        #
+        #   @return [Integer]
+        required :cached_tokens, Integer
+
+        # @!method initialize(cached_tokens:)
+        #   Some parameter documentations has been truncated, see
+        #   {OpenAI::Models::BatchUsage::InputTokensDetails} for more details.
+        #
+        #   A detailed breakdown of the input tokens.
+        #
+        #   @param cached_tokens [Integer] The number of tokens that were retrieved from the cache. [More on
+      end
+
+      # @see OpenAI::Models::BatchUsage#output_tokens_details
+      class OutputTokensDetails < OpenAI::Internal::Type::BaseModel
+        # @!attribute reasoning_tokens
+        #   The number of reasoning tokens.
+        #
+        #   @return [Integer]
+        required :reasoning_tokens, Integer
+
+        # @!method initialize(reasoning_tokens:)
+        #   A detailed breakdown of the output tokens.
+        #
+        #   @param reasoning_tokens [Integer] The number of reasoning tokens.
+      end
+    end
+  end
+end

data/lib/openai/models/responses/response_custom_tool_call_output.rb

@@ -11,10 +11,11 @@ module OpenAI
         required :call_id, String
 
         # @!attribute output
-        #   The output from the custom tool call generated by your code.
+        #   The output from the custom tool call generated by your code. Can be a string or
+        #   an list of output content.
         #
-        #   @return [String]
-        required :output, String
+        #   @return [String, Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>]
+        required :output, union: -> { OpenAI::Responses::ResponseCustomToolCallOutput::Output }
 
         # @!attribute type
         #   The type of the custom tool call output. Always `custom_tool_call_output`.
@@ -36,11 +37,53 @@ module OpenAI
         #
         #   @param call_id [String] The call ID, used to map this custom tool call output to a custom tool call.
         #
-        #   @param output [String] The output from the custom tool call generated by your code.
+        #   @param output [String, Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>] The output from the custom tool call generated by your code.
         #
         #   @param id [String] The unique ID of the custom tool call output in the OpenAI platform.
         #
         #   @param type [Symbol, :custom_tool_call_output] The type of the custom tool call output. Always `custom_tool_call_output`.
+
+        # The output from the custom tool call generated by your code. Can be a string or
+        # an list of output content.
+        #
+        # @see OpenAI::Models::Responses::ResponseCustomToolCallOutput#output
+        module Output
+          extend OpenAI::Internal::Type::Union
+
+          # A string of the output of the custom tool call.
+          variant String
+
+          # Text, image, or file output of the custom tool call.
+          variant -> { OpenAI::Models::Responses::ResponseCustomToolCallOutput::Output::OutputContentListArray }
+
+          # A text input to the model.
+          module OutputContentList
+            extend OpenAI::Internal::Type::Union
+
+            discriminator :type
+
+            # A text input to the model.
+            variant :input_text, -> { OpenAI::Responses::ResponseInputText }
+
+            # An image input to the model. Learn about [image inputs](https://platform.openai.com/docs/guides/vision).
+            variant :input_image, -> { OpenAI::Responses::ResponseInputImage }
+
+            # A file input to the model.
+            variant :input_file, -> { OpenAI::Responses::ResponseInputFile }
+
+            # @!method self.variants
+            #   @return [Array(OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile)]
+          end
+
+          # @!method self.variants
+          #   @return [Array(String, Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>)]
+
+          # @type [OpenAI::Internal::Type::Converter]
+          OutputContentListArray =
+            OpenAI::Internal::Type::ArrayOf[union: -> {
+              OpenAI::Responses::ResponseCustomToolCallOutput::Output::OutputContentList
+            }]
+        end
       end
     end
   end

data/lib/openai/models/responses/response_function_call_arguments_done_event.rb

@@ -16,6 +16,12 @@ module OpenAI
         #   @return [String]
         required :item_id, String
 
+        # @!attribute name
+        #   The name of the function that was called.
+        #
+        #   @return [String]
+        required :name, String
+
         # @!attribute output_index
         #   The index of the output item.
         #
@@ -33,13 +39,15 @@ module OpenAI
         #   @return [Symbol, :"response.function_call_arguments.done"]
         required :type, const: :"response.function_call_arguments.done"
 
-        # @!method initialize(arguments:, item_id:, output_index:, sequence_number:, type: :"response.function_call_arguments.done")
+        # @!method initialize(arguments:, item_id:, name:, output_index:, sequence_number:, type: :"response.function_call_arguments.done")
         #   Emitted when function-call arguments are finalized.
         #
         #   @param arguments [String] The function-call arguments.
         #
         #   @param item_id [String] The ID of the item.
         #
+        #   @param name [String] The name of the function that was called.
+        #
         #   @param output_index [Integer] The index of the output item.
         #
         #   @param sequence_number [Integer] The sequence number of this event.

data/lib/openai/models/responses/response_function_call_output_item.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      # A text input to the model.
+      module ResponseFunctionCallOutputItem
+        extend OpenAI::Internal::Type::Union
+
+        discriminator :type
+
+        # A text input to the model.
+        variant :input_text, -> { OpenAI::Responses::ResponseInputTextContent }
+
+        # An image input to the model. Learn about [image inputs](https://platform.openai.com/docs/guides/vision)
+        variant :input_image, -> { OpenAI::Responses::ResponseInputImageContent }
+
+        # A file input to the model.
+        variant :input_file, -> { OpenAI::Responses::ResponseInputFileContent }
+
+        # @!method self.variants
+        #   @return [Array(OpenAI::Models::Responses::ResponseInputTextContent, OpenAI::Models::Responses::ResponseInputImageContent, OpenAI::Models::Responses::ResponseInputFileContent)]
+      end
+    end
+  end
+end

data/lib/openai/models/responses/response_function_call_output_item_list.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      # @type [OpenAI::Internal::Type::Converter]
+      ResponseFunctionCallOutputItemList =
+        OpenAI::Internal::Type::ArrayOf[union: -> { OpenAI::Responses::ResponseFunctionCallOutputItem }]
+    end
+  end
+end

data/lib/openai/models/responses/response_function_tool_call_output_item.rb

@@ -17,10 +17,11 @@ module OpenAI
         required :call_id, String
 
         # @!attribute output
-        #   A JSON string of the output of the function tool call.
+        #   The output from the function call generated by your code. Can be a string or an
+        #   list of output content.
         #
-        #   @return [String]
-        required :output, String
+        #   @return [String, Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>]
+        required :output, union: -> { OpenAI::Responses::ResponseFunctionToolCallOutputItem::Output }
 
         # @!attribute type
         #   The type of the function tool call output. Always `function_call_output`.
@@ -44,12 +45,54 @@ module OpenAI
         #
         #   @param call_id [String] The unique ID of the function tool call generated by the model.
         #
-        #   @param output [String] A JSON string of the output of the function tool call.
+        #   @param output [String, Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>] The output from the function call generated by your code.
         #
         #   @param status [Symbol, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem::Status] The status of the item. One of `in_progress`, `completed`, or
         #
         #   @param type [Symbol, :function_call_output] The type of the function tool call output. Always `function_call_output`.
 
+        # The output from the function call generated by your code. Can be a string or an
+        # list of output content.
+        #
+        # @see OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem#output
+        module Output
+          extend OpenAI::Internal::Type::Union
+
+          # A string of the output of the function call.
+          variant String
+
+          # Text, image, or file output of the function call.
+          variant -> { OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem::Output::OutputContentListArray }
+
+          # A text input to the model.
+          module OutputContentList
+            extend OpenAI::Internal::Type::Union
+
+            discriminator :type
+
+            # A text input to the model.
+            variant :input_text, -> { OpenAI::Responses::ResponseInputText }
+
+            # An image input to the model. Learn about [image inputs](https://platform.openai.com/docs/guides/vision).
+            variant :input_image, -> { OpenAI::Responses::ResponseInputImage }
+
+            # A file input to the model.
+            variant :input_file, -> { OpenAI::Responses::ResponseInputFile }
+
+            # @!method self.variants
+            #   @return [Array(OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile)]
+          end
+
+          # @!method self.variants
+          #   @return [Array(String, Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>)]
+
+          # @type [OpenAI::Internal::Type::Converter]
+          OutputContentListArray =
+            OpenAI::Internal::Type::ArrayOf[union: -> {
+              OpenAI::Responses::ResponseFunctionToolCallOutputItem::Output::OutputContentList
+            }]
+        end
+
         # The status of the item. One of `in_progress`, `completed`, or `incomplete`.
         # Populated when items are returned via API.
         #

data/lib/openai/models/responses/response_input_file_content.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class ResponseInputFileContent < OpenAI::Internal::Type::BaseModel
+        # @!attribute type
+        #   The type of the input item. Always `input_file`.
+        #
+        #   @return [Symbol, :input_file]
+        required :type, const: :input_file
+
+        # @!attribute file_data
+        #   The base64-encoded data of the file to be sent to the model.
+        #
+        #   @return [String, nil]
+        optional :file_data, String, nil?: true
+
+        # @!attribute file_id
+        #   The ID of the file to be sent to the model.
+        #
+        #   @return [String, nil]
+        optional :file_id, String, nil?: true
+
+        # @!attribute file_url
+        #   The URL of the file to be sent to the model.
+        #
+        #   @return [String, nil]
+        optional :file_url, String, nil?: true
+
+        # @!attribute filename
+        #   The name of the file to be sent to the model.
+        #
+        #   @return [String, nil]
+        optional :filename, String, nil?: true
+
+        # @!method initialize(file_data: nil, file_id: nil, file_url: nil, filename: nil, type: :input_file)
+        #   A file input to the model.
+        #
+        #   @param file_data [String, nil] The base64-encoded data of the file to be sent to the model.
+        #
+        #   @param file_id [String, nil] The ID of the file to be sent to the model.
+        #
+        #   @param file_url [String, nil] The URL of the file to be sent to the model.
+        #
+        #   @param filename [String, nil] The name of the file to be sent to the model.
+        #
+        #   @param type [Symbol, :input_file] The type of the input item. Always `input_file`.
+      end
+    end
+  end
+end

data/lib/openai/models/responses/response_input_image_content.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class ResponseInputImageContent < OpenAI::Internal::Type::BaseModel
+        # @!attribute type
+        #   The type of the input item. Always `input_image`.
+        #
+        #   @return [Symbol, :input_image]
+        required :type, const: :input_image
+
+        # @!attribute detail
+        #   The detail level of the image to be sent to the model. One of `high`, `low`, or
+        #   `auto`. Defaults to `auto`.
+        #
+        #   @return [Symbol, OpenAI::Models::Responses::ResponseInputImageContent::Detail, nil]
+        optional :detail, enum: -> { OpenAI::Responses::ResponseInputImageContent::Detail }, nil?: true
+
+        # @!attribute file_id
+        #   The ID of the file to be sent to the model.
+        #
+        #   @return [String, nil]
+        optional :file_id, String, nil?: true
+
+        # @!attribute image_url
+        #   The URL of the image to be sent to the model. A fully qualified URL or base64
+        #   encoded image in a data URL.
+        #
+        #   @return [String, nil]
+        optional :image_url, String, nil?: true
+
+        # @!method initialize(detail: nil, file_id: nil, image_url: nil, type: :input_image)
+        #   Some parameter documentations has been truncated, see
+        #   {OpenAI::Models::Responses::ResponseInputImageContent} for more details.
+        #
+        #   An image input to the model. Learn about
+        #   [image inputs](https://platform.openai.com/docs/guides/vision)
+        #
+        #   @param detail [Symbol, OpenAI::Models::Responses::ResponseInputImageContent::Detail, nil] The detail level of the image to be sent to the model. One of `high`, `low`, or
+        #
+        #   @param file_id [String, nil] The ID of the file to be sent to the model.
+        #
+        #   @param image_url [String, nil] The URL of the image to be sent to the model. A fully qualified URL or base64 en
+        #
+        #   @param type [Symbol, :input_image] The type of the input item. Always `input_image`.
+
+        # The detail level of the image to be sent to the model. One of `high`, `low`, or
+        # `auto`. Defaults to `auto`.
+        #
+        # @see OpenAI::Models::Responses::ResponseInputImageContent#detail
+        module Detail
+          extend OpenAI::Internal::Type::Enum
+
+          LOW = :low
+          HIGH = :high
+          AUTO = :auto
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/openai/models/responses/response_input_item.rb

@@ -291,10 +291,10 @@ module OpenAI
           required :call_id, String
 
           # @!attribute output
-          #   A JSON string of the output of the function tool call.
+          #   Text, image, or file output of the function tool call.
           #
-          #   @return [String]
-          required :output, String
+          #   @return [String, Array<OpenAI::Models::Responses::ResponseInputTextContent, OpenAI::Models::Responses::ResponseInputImageContent, OpenAI::Models::Responses::ResponseInputFileContent>]
+          required :output, union: -> { OpenAI::Responses::ResponseInputItem::FunctionCallOutput::Output }
 
           # @!attribute type
           #   The type of the function tool call output. Always `function_call_output`.
@@ -327,7 +327,7 @@ module OpenAI
           #
           #   @param call_id [String] The unique ID of the function tool call generated by the model.
           #
-          #   @param output [String] A JSON string of the output of the function tool call.
+          #   @param output [String, Array<OpenAI::Models::Responses::ResponseInputTextContent, OpenAI::Models::Responses::ResponseInputImageContent, OpenAI::Models::Responses::ResponseInputFileContent>] Text, image, or file output of the function tool call.
           #
           #   @param id [String, nil] The unique ID of the function tool call output. Populated when this item is retu
           #
@@ -335,6 +335,21 @@ module OpenAI
           #
           #   @param type [Symbol, :function_call_output] The type of the function tool call output. Always `function_call_output`.
 
+          # Text, image, or file output of the function tool call.
+          #
+          # @see OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput#output
+          module Output
+            extend OpenAI::Internal::Type::Union
+
+            # A JSON string of the output of the function tool call.
+            variant String
+
+            variant -> { OpenAI::Responses::ResponseFunctionCallOutputItemList }
+
+            # @!method self.variants
+            #   @return [Array(String, Array<OpenAI::Models::Responses::ResponseInputTextContent, OpenAI::Models::Responses::ResponseInputImageContent, OpenAI::Models::Responses::ResponseInputFileContent>)]
+          end
+
           # The status of the item. One of `in_progress`, `completed`, or `incomplete`.
           # Populated when items are returned via API.
           #

data/lib/openai/models/responses/response_input_text_content.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      class ResponseInputTextContent < OpenAI::Internal::Type::BaseModel
+        # @!attribute text
+        #   The text input to the model.
+        #
+        #   @return [String]
+        required :text, String
+
+        # @!attribute type
+        #   The type of the input item. Always `input_text`.
+        #
+        #   @return [Symbol, :input_text]
+        required :type, const: :input_text
+
+        # @!method initialize(text:, type: :input_text)
+        #   A text input to the model.
+        #
+        #   @param text [String] The text input to the model.
+        #
+        #   @param type [Symbol, :input_text] The type of the input item. Always `input_text`.
+      end
+    end
+  end
+end