openai 0.106.0 → 0.107.0

data/lib/openai/helpers/websocket/protocol.rb

@@ -6,6 +6,166 @@ module OpenAI
     #
     # @api private
     module Protocol
+      # JSON schemas and extension data do not have a transport-specific depth limit.
+      private def parse_json(data) = JSON.parse(data, symbolize_names: true, max_nesting: false)
+
+      private def generate_json(value) = JSON.generate(value, max_nesting: false)
+
+      private def freeze_json(value)
+        pending = [value]
+        visited = {}.compare_by_identity
+        until pending.empty?
+          item = pending.pop
+          next if visited.key?(item)
+          visited[item] = true
+          case item
+          when Hash
+            item.each { |key, val| pending.push(key, val) }
+          when Array
+            pending.concat(item)
+          end
+
+          item.freeze
+        end
+
+        value
+      end
+
+      # Unknown wire keys must not replace a selected model's renamed Ruby fields.
+      private def validate_wire_field_names!(event, payload)
+        pending = [[event, payload]]
+        until pending.empty?
+          value, raw = pending.pop
+          case value
+          when OpenAI::Internal::Type::BaseModel
+            value.class.fields.each do |name, field|
+              raise ArgumentError if name != field.fetch(:api_name) && raw.is_a?(Hash) && raw.key?(name)
+            end
+
+            value.to_h.each do |name, child|
+              field = value.class.fields[name]
+              key = field ? field.fetch(:api_name) : name
+              pending << [child, raw.is_a?(Hash) ? raw[key] : nil]
+            end
+
+          when Hash
+            value.each { |name, child| pending << [child, raw.is_a?(Hash) ? raw[name] : nil] }
+          when Array
+            value.each_with_index { |child, index| pending << [child, raw.is_a?(Array) ? raw[index] : nil] }
+          end
+        end
+
+        event
+      end
+
+      private def coerce_event(union, payload, outbound: false)
+        state = OpenAI::Internal::Type::Converter.new_coerce_state(request_only: outbound)
+        event = OpenAI::Internal::Type::Converter.coerce(union, payload, state: state)
+        raise ArgumentError if state[:error] || !state.fetch(:exactness).fetch(:no).zero?
+        ancestors = {}.compare_by_identity
+        pending = [[event, false]]
+        until pending.empty?
+          value, exiting = pending.pop
+          if exiting
+            ancestors.delete(value)
+            next
+          end
+
+          children = case value
+          when OpenAI::Internal::Type::BaseModel
+            data = value.to_h
+            validate_model_fields!(value)
+            value.class.fields.each do |name, field|
+              const = field.fetch(:const)
+              if field.fetch(:required) &&
+                  field.fetch(:mode) != (outbound ? :coerce : :dump) &&
+                  (!outbound || const == OpenAI::Internal::OMIT) &&
+                  !data.key?(name)
+                raise ArgumentError
+              end
+            end
+
+            data.values
+          when Hash
+            value.values
+          when Array
+            value
+          else
+            next
+          end
+
+          raise ArgumentError if ancestors.key?(value)
+          ancestors[value] = true
+          pending << [value, true]
+          children.each { |child| pending << [child, false] }
+        end
+
+        event
+      end
+
+      private def validate_event_tree!(event, json_only: false, strict_keys: true)
+        ancestors = {}.compare_by_identity
+        pending = [[event, false]]
+        until pending.empty?
+          value, exiting = pending.pop
+          if exiting
+            ancestors.delete(value)
+            next
+          end
+
+          children = case value
+          when OpenAI::Internal::Type::BaseModel
+            raise ArgumentError if json_only
+            data = value.to_h
+            validate_model_fields!(value)
+            [data]
+          when Hash
+            if strict_keys
+              keys = {}
+              value.each_key do |key|
+                raise ArgumentError unless key.is_a?(String) || key.is_a?(Symbol)
+                name = key.to_s
+                raise ArgumentError if keys.key?(name)
+                keys[name] = true
+              end
+            end
+
+            value.values
+          when Array
+            value
+          when NilClass, TrueClass, FalseClass, String, Integer, Float, Symbol
+            next
+          else
+            raise ArgumentError if json_only
+            next
+          end
+
+          raise ArgumentError if ancestors.key?(value)
+          ancestors[value] = true
+          pending << [value, true]
+          children.each { |child| pending << [child, false] }
+        end
+      end
+
+      private def validate_model_fields!(model)
+        names = {}
+        model.to_h.each do |name, actual|
+          key = name.is_a?(String) ? name.to_sym : name
+          field = model.class.known_fields[key]
+          serialized_name = field ? field.fetch(:api_name).to_s : key.to_s
+          raise ArgumentError if names.key?(serialized_name)
+          names[serialized_name] = true
+          next unless field
+          const = field.fetch(:const)
+          next if const == OpenAI::Internal::OMIT
+          if const.is_a?(Symbol)
+            raise ArgumentError unless (actual.is_a?(String) || actual.is_a?(Symbol)) && actual.to_s == const.to_s
+          elsif actual != const
+            raise ArgumentError
+          end
+        end
+      end
+
       private def discriminator_values(union)
         union.variants.to_h do |variant|
           value = variant.fields.fetch(:type).fetch(:const)

data/lib/openai/helpers/websocket/typed_connection.rb

@@ -2,7 +2,7 @@
 
 module OpenAI
   module WebSocket
-    # Generic event codec for APIs with generated bindings and no specialized helper.
+    # Shared event codec for generated bindings and specialized product facades.
     #
     # @api private
     class TypedConnection < Connection
@@ -30,36 +30,36 @@ module OpenAI
       end
 
       private def encode_client_event(event)
-        event_type(event, message: "Invalid WebSocket client event.") if event.is_a?(Hash)
+        validate_event_tree!(event)
+        event_type(event, message: client_event_error_message) if event.is_a?(Hash)
         payload = @client_event ? OpenAI::Internal::Type::Converter.dump(@client_event, event) : event
-        type = event_type(payload, message: "Invalid WebSocket client event.")
+        type = event_type(payload, message: client_event_error_message)
         if @client_event && !@client_event_types.any? { _1.nil? || _1 === type.to_sym || _1 === type.to_s }
-          raise ArgumentError, "Invalid WebSocket client event."
+          raise ArgumentError, client_event_error_message
         end
 
-        payload = coerce(@client_event, payload) if @client_event
+        payload = coerce_client_event(payload) if @client_event
         payload = OpenAI::Internal::Type::Converter.dump(@client_event, payload) if @client_event
-        JSON.generate(payload, max_nesting: false)
+        validate_event_tree!(payload, json_only: true)
+        generate_json(payload)
       rescue StandardError, SystemStackError
-        raise ArgumentError, "Invalid WebSocket client event.", cause: nil
+        raise ArgumentError, client_event_error_message, cause: nil
       end
 
       def parse_event(data)
-        parsed = JSON.parse(data, symbolize_names: true, max_nesting: false)
+        parsed = parse_json(data)
         type = event_type(parsed, message: "WebSocket server event must be an object with a string type")
         _, model = @server_event_types.find { |event_type,| event_type === type.to_sym }
-        return parsed unless model
+        return unknown_server_event(parsed) unless model
 
-        # Unknown wire fields must not overwrite a known field's Ruby name.
-        model.fields.each do |name, field|
-          raise ArgumentError if name != field.fetch(:api_name) && parsed.key?(name)
-        end
-
-        coerce(@server_event, parsed)
+        event = coerce(@server_event, parsed)
+        validate_wire_field_names!(event, parsed)
       rescue StandardError, SystemStackError
-        raise OpenAI::Errors::WebSocketProtocolError, "Invalid WebSocket server event.", cause: nil
+        raise protocol_error, cause: nil
       end
 
+      private def coerce_client_event(payload) = coerce(@client_event, payload)
+
       private def coerce(type, value)
         state = OpenAI::Internal::Type::Converter.new_coerce_state
         result = OpenAI::Internal::Type::Converter.coerce(type, value, state: state)
@@ -70,6 +70,12 @@ module OpenAI
         result
       end
 
+      private def client_event_error_message = "Invalid WebSocket client event."
+
+      private def unknown_server_event(payload) = payload
+
+      private def protocol_error = OpenAI::Errors::WebSocketProtocolError.new("Invalid WebSocket server event.")
+
       private def connection_error(message) = BindingConnectionError.new(url: @url, message: message)
 
       private def transport_error = connection_error("WebSocket transport failed.")

data/lib/openai/helpers/websocket/typed_resource.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require_relative "resource"
+
+module OpenAI
+  module WebSocket
+    # Supplies the generic signature contract for generated event bindings.
+    # Connection lifecycle and event handling are implemented by Resource.
+    #
+    # @api private
+    module TypedResource
+      include Resource
+    end
+  end
+end

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

@@ -1012,7 +1012,7 @@ module OpenAI
                 T::Class[OpenAI::Internal::Type::BaseStream[T.anything, OpenAI::Internal::Type::BaseModel]]
               ),
               model: T.nilable(OpenAI::Internal::Type::Converter::Input),
-              security: T.nilable({bearer_auth?: T::Boolean, admin_api_key_auth?: T::Boolean}),
+              security: T.nilable(T::Hash[Symbol, T::Boolean]),
               options: T.nilable(OpenAI::RequestOptions::OrHash)
             }
           end

data/lib/openai/models/admin/organization/usage_audio_speeches_response.rb

@@ -235,6 +235,13 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_cache_write_12h_tokens, Integer
 
+                # @!attribute input_cache_write_30m_tokens
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period. May be absent or null for older responses.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_30m_tokens, Integer, nil?: true
+
                 # @!attribute input_cache_write_tokens
                 #   The aggregated number of input tokens written to the cache with a 30-minute
                 #   retention period.
@@ -333,7 +340,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_30m_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -370,6 +377,10 @@ module OpenAI
                 #     The aggregated number of input tokens written to the cache with a 12-hour
                 #     retention period.
                 #
+                #   @param input_cache_write_30m_tokens [Integer, nil]
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period. May be absent or null for older responses.
+                #
                 #   @param input_cache_write_tokens [Integer]
                 #     The aggregated number of input tokens written to the cache with a 30-minute
                 #     retention period.

data/lib/openai/models/admin/organization/usage_audio_transcriptions_response.rb

@@ -237,6 +237,13 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_cache_write_12h_tokens, Integer
 
+                # @!attribute input_cache_write_30m_tokens
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period. May be absent or null for older responses.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_30m_tokens, Integer, nil?: true
+
                 # @!attribute input_cache_write_tokens
                 #   The aggregated number of input tokens written to the cache with a 30-minute
                 #   retention period.
@@ -335,7 +342,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_30m_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -372,6 +379,10 @@ module OpenAI
                 #     The aggregated number of input tokens written to the cache with a 12-hour
                 #     retention period.
                 #
+                #   @param input_cache_write_30m_tokens [Integer, nil]
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period. May be absent or null for older responses.
+                #
                 #   @param input_cache_write_tokens [Integer]
                 #     The aggregated number of input tokens written to the cache with a 30-minute
                 #     retention period.

data/lib/openai/models/admin/organization/usage_code_interpreter_sessions_response.rb

@@ -237,6 +237,13 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_cache_write_12h_tokens, Integer
 
+                # @!attribute input_cache_write_30m_tokens
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period. May be absent or null for older responses.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_30m_tokens, Integer, nil?: true
+
                 # @!attribute input_cache_write_tokens
                 #   The aggregated number of input tokens written to the cache with a 30-minute
                 #   retention period.
@@ -335,7 +342,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_30m_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -372,6 +379,10 @@ module OpenAI
                 #     The aggregated number of input tokens written to the cache with a 12-hour
                 #     retention period.
                 #
+                #   @param input_cache_write_30m_tokens [Integer, nil]
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period. May be absent or null for older responses.
+                #
                 #   @param input_cache_write_tokens [Integer]
                 #     The aggregated number of input tokens written to the cache with a 30-minute
                 #     retention period.

data/lib/openai/models/admin/organization/usage_completions_response.rb

@@ -233,6 +233,13 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_cache_write_12h_tokens, Integer
 
+                # @!attribute input_cache_write_30m_tokens
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period. May be absent or null for older responses.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_30m_tokens, Integer, nil?: true
+
                 # @!attribute input_cache_write_tokens
                 #   The aggregated number of input tokens written to the cache with a 30-minute
                 #   retention period.
@@ -331,7 +338,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_30m_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -368,6 +375,10 @@ module OpenAI
                 #     The aggregated number of input tokens written to the cache with a 12-hour
                 #     retention period.
                 #
+                #   @param input_cache_write_30m_tokens [Integer, nil]
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period. May be absent or null for older responses.
+                #
                 #   @param input_cache_write_tokens [Integer]
                 #     The aggregated number of input tokens written to the cache with a 30-minute
                 #     retention period.

data/lib/openai/models/admin/organization/usage_costs_response.rb

@@ -231,6 +231,13 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_cache_write_12h_tokens, Integer
 
+                # @!attribute input_cache_write_30m_tokens
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period. May be absent or null for older responses.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_30m_tokens, Integer, nil?: true
+
                 # @!attribute input_cache_write_tokens
                 #   The aggregated number of input tokens written to the cache with a 30-minute
                 #   retention period.
@@ -329,7 +336,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_30m_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -366,6 +373,10 @@ module OpenAI
                 #     The aggregated number of input tokens written to the cache with a 12-hour
                 #     retention period.
                 #
+                #   @param input_cache_write_30m_tokens [Integer, nil]
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period. May be absent or null for older responses.
+                #
                 #   @param input_cache_write_tokens [Integer]
                 #     The aggregated number of input tokens written to the cache with a 30-minute
                 #     retention period.

data/lib/openai/models/admin/organization/usage_decisions_response.rb

@@ -137,6 +137,13 @@ module OpenAI
               #   @return [Integer, nil]
               optional :input_cache_write_12h_tokens, Integer, nil?: true
 
+              # @!attribute input_cache_write_30m_tokens
+              #   The aggregated number of input tokens written to the cache with a 30-minute
+              #   retention period.
+              #
+              #   @return [Integer, nil]
+              optional :input_cache_write_30m_tokens, Integer, nil?: true
+
               # @!attribute input_cache_write_tokens
               #   The aggregated number of input tokens written to the cache with a 30-minute
               #   retention period.
@@ -235,7 +242,7 @@ module OpenAI
               #   @return [String, nil]
               optional :user_id, String, nil?: true
 
-              # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.decisions.result")
+              # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_30m_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.decisions.result")
               #   The aggregated Decisions API usage details of the specific time bucket.
               #
               #   @param input_tokens [Integer]
@@ -272,6 +279,10 @@ module OpenAI
               #     The aggregated number of input tokens written to the cache with a 12-hour
               #     retention period.
               #
+              #   @param input_cache_write_30m_tokens [Integer, nil]
+              #     The aggregated number of input tokens written to the cache with a 30-minute
+              #     retention period.
+              #
               #   @param input_cache_write_tokens [Integer, nil]
               #     The aggregated number of input tokens written to the cache with a 30-minute
               #     retention period.

data/lib/openai/models/admin/organization/usage_embeddings_response.rb

@@ -233,6 +233,13 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_cache_write_12h_tokens, Integer
 
+                # @!attribute input_cache_write_30m_tokens
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period. May be absent or null for older responses.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_30m_tokens, Integer, nil?: true
+
                 # @!attribute input_cache_write_tokens
                 #   The aggregated number of input tokens written to the cache with a 30-minute
                 #   retention period.
@@ -331,7 +338,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_30m_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -368,6 +375,10 @@ module OpenAI
                 #     The aggregated number of input tokens written to the cache with a 12-hour
                 #     retention period.
                 #
+                #   @param input_cache_write_30m_tokens [Integer, nil]
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period. May be absent or null for older responses.
+                #
                 #   @param input_cache_write_tokens [Integer]
                 #     The aggregated number of input tokens written to the cache with a 30-minute
                 #     retention period.

data/lib/openai/models/admin/organization/usage_file_search_calls_response.rb

@@ -235,6 +235,13 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_cache_write_12h_tokens, Integer
 
+                # @!attribute input_cache_write_30m_tokens
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period. May be absent or null for older responses.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_30m_tokens, Integer, nil?: true
+
                 # @!attribute input_cache_write_tokens
                 #   The aggregated number of input tokens written to the cache with a 30-minute
                 #   retention period.
@@ -333,7 +340,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_30m_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -370,6 +377,10 @@ module OpenAI
                 #     The aggregated number of input tokens written to the cache with a 12-hour
                 #     retention period.
                 #
+                #   @param input_cache_write_30m_tokens [Integer, nil]
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period. May be absent or null for older responses.
+                #
                 #   @param input_cache_write_tokens [Integer]
                 #     The aggregated number of input tokens written to the cache with a 30-minute
                 #     retention period.

data/lib/openai/models/admin/organization/usage_images_response.rb

@@ -231,6 +231,13 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_cache_write_12h_tokens, Integer
 
+                # @!attribute input_cache_write_30m_tokens
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period. May be absent or null for older responses.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_30m_tokens, Integer, nil?: true
+
                 # @!attribute input_cache_write_tokens
                 #   The aggregated number of input tokens written to the cache with a 30-minute
                 #   retention period.
@@ -329,7 +336,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_30m_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -366,6 +373,10 @@ module OpenAI
                 #     The aggregated number of input tokens written to the cache with a 12-hour
                 #     retention period.
                 #
+                #   @param input_cache_write_30m_tokens [Integer, nil]
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period. May be absent or null for older responses.
+                #
                 #   @param input_cache_write_tokens [Integer]
                 #     The aggregated number of input tokens written to the cache with a 30-minute
                 #     retention period.

data/lib/openai/models/admin/organization/usage_moderations_response.rb

@@ -233,6 +233,13 @@ module OpenAI
                 #   @return [Integer, nil]
                 optional :input_cache_write_12h_tokens, Integer
 
+                # @!attribute input_cache_write_30m_tokens
+                #   The aggregated number of input tokens written to the cache with a 30-minute
+                #   retention period. May be absent or null for older responses.
+                #
+                #   @return [Integer, nil]
+                optional :input_cache_write_30m_tokens, Integer, nil?: true
+
                 # @!attribute input_cache_write_tokens
                 #   The aggregated number of input tokens written to the cache with a 30-minute
                 #   retention period.
@@ -331,7 +338,7 @@ module OpenAI
                 #   @return [String, nil]
                 optional :user_id, String, nil?: true
 
-                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
+                # @!method initialize(input_tokens:, num_model_requests:, output_tokens:, api_key_id: nil, api_source: nil, batch: nil, input_audio_tokens: nil, input_cache_write_12h_tokens: nil, input_cache_write_30m_tokens: nil, input_cache_write_tokens: nil, input_cached_audio_tokens: nil, input_cached_image_tokens: nil, input_cached_text_tokens: nil, input_cached_tokens: nil, input_image_tokens: nil, input_text_tokens: nil, input_uncached_tokens: nil, model: nil, output_audio_tokens: nil, output_image_tokens: nil, output_text_tokens: nil, project_id: nil, service_tier: nil, user_id: nil, object: :"organization.usage.completions.result")
                 #   The aggregated completions usage details of the specific time bucket.
                 #
                 #   @param input_tokens [Integer]
@@ -368,6 +375,10 @@ module OpenAI
                 #     The aggregated number of input tokens written to the cache with a 12-hour
                 #     retention period.
                 #
+                #   @param input_cache_write_30m_tokens [Integer, nil]
+                #     The aggregated number of input tokens written to the cache with a 30-minute
+                #     retention period. May be absent or null for older responses.
+                #
                 #   @param input_cache_write_tokens [Integer]
                 #     The aggregated number of input tokens written to the cache with a 30-minute
                 #     retention period.