openai 0.17.0 → 0.18.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6413e169f6a035774a4322aa42bbce1b9374344c1f68c5d452be6b0dffcd9756
-  data.tar.gz: 1ef928f4030023fd8a2076b08c3077f8ee7b9d95eef046eebbfc72004d46d327
+  metadata.gz: c35bbfd04ead89e0106c7e37becbe9d9cded43bfb68f678052a09fa76a8b5c1c
+  data.tar.gz: b6870bb326394a91a1e1c2244ba8b25f8792fcbf4c7a54146505883a1d7cd4ef
 SHA512:
-  metadata.gz: cf5a3da338b678f1680b605d0cd5a383ca95d601706422e5bedd5131e7ee7d91f01941b7f913368cec2e007fc684309e64e449e52e724a3c7a764c993c3d9e53
-  data.tar.gz: ebb89edd3814ee447bcfababcb05662d26e7380fb024c943cb5fa30196fcc6c49aea64c820de4fe8256f2acdf20562544e41a410084d1e34c774cf179329dc47
+  metadata.gz: 3e3159ea33f98d814305fb82ff5d91a58c7824938fb008ecf29f2fc7993db3ed9fb809d5db6a69f0f28a9aa17fd5d5a5412b4c9c9b29de666ab6d7fb17c4fb3a
+  data.tar.gz: f9b4351d29b599c9e539684863f46ebada1bf5a1cb56c8a7d759d627a37fa603b53efc866708ac260b0b9a111b07313055d171bf7c8f0ebc9cb56b199b86f334

data/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## 0.18.1 (2025-08-19)
+
+Full Changelog: [v0.18.0...v0.18.1](https://github.com/openai/openai-ruby/compare/v0.18.0...v0.18.1)
+
+### Chores
+
+* **api:** accurately represent shape for verbosity on Chat Completions ([a19cd00](https://github.com/openai/openai-ruby/commit/a19cd00e6df3cc3f47239a25fe15f33c2cb77962))
+
+## 0.18.0 (2025-08-15)
+
+Full Changelog: [v0.17.1...v0.18.0](https://github.com/openai/openai-ruby/compare/v0.17.1...v0.18.0)
+
+### ⚠ BREAKING CHANGES
+
+* structured output desc should go on array items not array itself ([#799](https://github.com/openai/openai-ruby/issues/799))
+
+### Features
+
+* **api:** add new text parameters, expiration options ([f318432](https://github.com/openai/openai-ruby/commit/f318432b19800ab42d5b0c5f179f0cdd02dbf596))
+
+
+### Bug Fixes
+
+* structured output desc should go on array items not array itself ([#799](https://github.com/openai/openai-ruby/issues/799)) ([ff507d0](https://github.com/openai/openai-ruby/commit/ff507d095ff703ba3b44ab82b06eb4314688d4eb))
+
+
+### Chores
+
+* **internal:** update test skipping reason ([c815703](https://github.com/openai/openai-ruby/commit/c815703062ce79d2cb14f252ee5d23cf4ebf15ca))
+
+## 0.17.1 (2025-08-09)
+
+Full Changelog: [v0.17.0...v0.17.1](https://github.com/openai/openai-ruby/compare/v0.17.0...v0.17.1)
+
+### Chores
+
+* collect metadata from type DSL ([d63cb9e](https://github.com/openai/openai-ruby/commit/d63cb9eb8efc60d43bd17c96bb6dc1e3b4254b26))
+* **internal:** update comment in script ([a08be47](https://github.com/openai/openai-ruby/commit/a08be4787dfc910a7c9cc06bc72f9c40b40250a4))
+
 ## 0.17.0 (2025-08-08)
 
 Full Changelog: [v0.16.0...v0.17.0](https://github.com/openai/openai-ruby/compare/v0.16.0...v0.17.0)

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.17.0"
+gem "openai", "~> 0.18.1"
 ```
 
 <!-- x-release-please-end -->

data/lib/openai/helpers/structured_output/array_of.rb

@@ -30,19 +30,11 @@ module OpenAI
               state: state
             )
             items = OpenAI::Helpers::StructuredOutput::JsonSchemaConverter.to_nilable(items) if nilable?
+            OpenAI::Helpers::StructuredOutput::JsonSchemaConverter.assoc_meta!(items, meta: @meta)
 
-            schema = {type: "array", items: items}
-            description.nil? ? schema : schema.update(description: description)
+            {type: "array", items: items}
           end
         end
-
-        # @return [String, nil]
-        attr_reader :description
-
-        def initialize(type_info, spec = {})
-          super
-          @description = [type_info, spec].grep(Hash).filter_map { _1[:doc] }.first
-        end
       end
     end
   end

data/lib/openai/helpers/structured_output/base_model.rb

@@ -28,15 +28,13 @@ module OpenAI
             OpenAI::Helpers::StructuredOutput::JsonSchemaConverter.cache_def!(state, type: self) do
               path = state.fetch(:path)
               properties = fields.to_h do |name, field|
-                type, nilable = field.fetch_values(:type, :nilable)
+                type, nilable, meta = field.fetch_values(:type, :nilable, :meta)
                 new_state = {**state, path: [*path, ".#{name}"]}
 
                 schema =
                   case type
-                  in {"$ref": String}
-                    type
                   in OpenAI::Helpers::StructuredOutput::JsonSchemaConverter
-                    type.to_json_schema_inner(state: new_state).update(field.slice(:description))
+                    type.to_json_schema_inner(state: new_state)
                   else
                     OpenAI::Helpers::StructuredOutput::JsonSchemaConverter.to_json_schema_inner(
                       type,
@@ -44,6 +42,8 @@ module OpenAI
                     )
                   end
                 schema = OpenAI::Helpers::StructuredOutput::JsonSchemaConverter.to_nilable(schema) if nilable
+                OpenAI::Helpers::StructuredOutput::JsonSchemaConverter.assoc_meta!(schema, meta: meta)
+
                 [name, schema]
               end
 
@@ -58,13 +58,6 @@ module OpenAI
         end
 
         class << self
-          def required(name_sym, type_info, spec = {})
-            super
-
-            doc = [type_info, spec].grep(Hash).filter_map { _1[:doc] }.first
-            known_fields.fetch(name_sym).update(description: doc) unless doc.nil?
-          end
-
           def optional(...)
             # rubocop:disable Layout/LineLength
             message = "`optional` is not supported for structured output APIs, use `#required` with `nil?: true` instead"

data/lib/openai/helpers/structured_output/json_schema_converter.rb

@@ -46,7 +46,7 @@ module OpenAI
             in {"$ref": String}
               {
                 anyOf: [
-                  schema.update(OpenAI::Helpers::StructuredOutput::JsonSchemaConverter::NO_REF => true),
+                  schema.merge!(OpenAI::Helpers::StructuredOutput::JsonSchemaConverter::NO_REF => true),
                   {type: null}
                 ]
               }
@@ -60,6 +60,17 @@ module OpenAI
             end
           end
 
+          # @api private
+          #
+          # @param schema [Hash{Symbol=>Object}]
+          def assoc_meta!(schema, meta:)
+            xformed = meta.transform_keys(doc: :description)
+            if schema.key?(:$ref) && !xformed.empty?
+              schema.merge!(OpenAI::Helpers::StructuredOutput::JsonSchemaConverter::NO_REF => true)
+            end
+            schema.merge!(xformed)
+          end
+
           # @api private
           #
           # @param state [Hash{Symbol=>Object}]
@@ -116,12 +127,17 @@ module OpenAI
 
               case refs
               in [ref]
-                ref.replace(sch)
+                ref.replace(ref.except(:$ref).merge(sch))
               in [_, ref, *]
                 reused_defs.store(ref.fetch(:$ref), sch)
+                refs.each do
+                  unless (meta = _1.except(:$ref)).empty?
+                    _1.replace(allOf: [_1.slice(:$ref), meta])
+                  end
+                end
               else
               end
-              no_refs.each { _1.replace(sch) }
+              no_refs.each { _1.replace(_1.except(:$ref).merge(sch)) }
             end
 
             xformed = reused_defs.transform_keys { _1.delete_prefix("#/$defs/") }

data/lib/openai/helpers/structured_output/union_of.rb

@@ -56,16 +56,8 @@ module OpenAI
 
         # @param variants [Array<generic<Member>>]
         def initialize(*variants)
-          case variants
-          in [Symbol => d, Hash => vs]
-            discriminator(d)
-            vs.each do |k, v|
-              v.is_a?(Proc) ? variant(k, v) : variant(k, -> { v })
-            end
-          else
-            variants.each do |v|
-              v.is_a?(Proc) ? variant(v) : variant(-> { v })
-            end
+          variants.each do |v|
+            v.is_a?(Proc) ? variant(v) : variant(-> { v })
           end
         end
       end

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

@@ -148,6 +148,7 @@ module OpenAI
         #   @option spec [Boolean] :"nil?"
         def initialize(type_info, spec = {})
           @item_type_fn = OpenAI::Internal::Type::Converter.type_info(type_info || spec)
+          @meta = OpenAI::Internal::Type::Converter.meta_info(type_info, spec)
           @nilable = spec.fetch(:nil?, false)
         end
 

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

@@ -52,6 +52,7 @@ module OpenAI
           #
           #   @option spec [Boolean] :"nil?"
           private def add_field(name_sym, required:, type_info:, spec:)
+            meta = OpenAI::Internal::Type::Converter.meta_info(type_info, spec)
             type_fn, info =
               case type_info
               in Proc | OpenAI::Internal::Type::Converter | Class
@@ -74,7 +75,8 @@ module OpenAI
                 required: required,
                 nilable: nilable,
                 const: const,
-                type_fn: type_fn
+                type_fn: type_fn,
+                meta: meta
               }
 
             define_method(setter) do |value|

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

@@ -98,6 +98,33 @@ module OpenAI
             end
           end
 
+          # @api private
+          #
+          # @param type_info [Hash{Symbol=>Object}, Proc, OpenAI::Internal::Type::Converter, Class] .
+          #
+          #   @option type_info [NilClass, TrueClass, FalseClass, Integer, Float, Symbol] :const
+          #
+          #   @option type_info [Proc] :enum
+          #
+          #   @option type_info [Proc] :union
+          #
+          #   @option type_info [Boolean] :"nil?"
+          #
+          # @param spec [Hash{Symbol=>Object}, Proc, OpenAI::Internal::Type::Converter, Class] .
+          #
+          #   @option spec [NilClass, TrueClass, FalseClass, Integer, Float, Symbol] :const
+          #
+          #   @option spec [Proc] :enum
+          #
+          #   @option spec [Proc] :union
+          #
+          #   @option spec [Boolean] :"nil?"
+          #
+          # @return [Hash{Symbol=>Object}]
+          def meta_info(type_info, spec)
+            [spec, type_info].grep(Hash).first.to_h.except(:const, :enum, :union, :nil?)
+          end
+
           # @api private
           #
           # @param translate_names [Boolean]

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

@@ -168,6 +168,7 @@ module OpenAI
         #   @option spec [Boolean] :"nil?"
         def initialize(type_info, spec = {})
           @item_type_fn = OpenAI::Internal::Type::Converter.type_info(type_info || spec)
+          @meta = OpenAI::Internal::Type::Converter.meta_info(type_info, spec)
           @nilable = spec.fetch(:nil?, false)
         end
 

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

@@ -33,20 +33,20 @@ module OpenAI
         #
         # All of the specified variant info for this union.
         #
-        # @return [Array<Array(Symbol, Proc)>]
+        # @return [Array<Array(Symbol, Proc, Hash{Symbol=>Object})>]
         private def known_variants = (@known_variants ||= [])
 
         # @api private
         #
-        # @return [Array<Array(Symbol, Object)>]
+        # @return [Array<Array(Symbol, Object, Hash{Symbol=>Object})>]
         protected def derefed_variants
-          known_variants.map { |key, variant_fn| [key, variant_fn.call] }
+          known_variants.map { |key, variant_fn, meta| [key, variant_fn.call, meta] }
         end
 
         # All of the specified variants for this union.
         #
         # @return [Array<Object>]
-        def variants = derefed_variants.map(&:last)
+        def variants = derefed_variants.map { _2 }
 
         # @api private
         #
@@ -72,12 +72,13 @@ module OpenAI
         #
         #   @option spec [Boolean] :"nil?"
         private def variant(key, spec = nil)
+          meta = OpenAI::Internal::Type::Converter.meta_info(nil, spec)
           variant_info =
             case key
             in Symbol
-              [key, OpenAI::Internal::Type::Converter.type_info(spec)]
+              [key, OpenAI::Internal::Type::Converter.type_info(spec), meta]
             in Proc | OpenAI::Internal::Type::Converter | Class | Hash
-              [nil, OpenAI::Internal::Type::Converter.type_info(key)]
+              [nil, OpenAI::Internal::Type::Converter.type_info(key), meta]
             end
 
           known_variants << variant_info
@@ -100,7 +101,8 @@ module OpenAI
             return nil if key == OpenAI::Internal::OMIT
 
             key = key.to_sym if key.is_a?(String)
-            known_variants.find { |k,| k == key }&.last&.call
+            _, found = known_variants.find { |k,| k == key }
+            found&.call
           else
             nil
           end

data/lib/openai/models/batch_create_params.rb

@@ -48,7 +48,14 @@ module OpenAI
       #   @return [Hash{Symbol=>String}, nil]
       optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
-      # @!method initialize(completion_window:, endpoint:, input_file_id:, metadata: nil, request_options: {})
+      # @!attribute output_expires_after
+      #   The expiration policy for the output and/or error file that are generated for a
+      #   batch.
+      #
+      #   @return [OpenAI::Models::BatchCreateParams::OutputExpiresAfter, nil]
+      optional :output_expires_after, -> { OpenAI::BatchCreateParams::OutputExpiresAfter }
+
+      # @!method initialize(completion_window:, endpoint:, input_file_id:, metadata: nil, output_expires_after: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {OpenAI::Models::BatchCreateParams} for more details.
       #
@@ -60,6 +67,8 @@ 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 output_expires_after [OpenAI::Models::BatchCreateParams::OutputExpiresAfter] The expiration policy for the output and/or error file that are generated for a
+      #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
       # The time frame within which the batch should be processed. Currently only `24h`
@@ -88,6 +97,34 @@ module OpenAI
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      class OutputExpiresAfter < OpenAI::Internal::Type::BaseModel
+        # @!attribute anchor
+        #   Anchor timestamp after which the expiration policy applies. Supported anchors:
+        #   `created_at`. Note that the anchor is the file creation time, not the time the
+        #   batch is created.
+        #
+        #   @return [Symbol, :created_at]
+        required :anchor, const: :created_at
+
+        # @!attribute seconds
+        #   The number of seconds after the anchor time that the file will expire. Must be
+        #   between 3600 (1 hour) and 2592000 (30 days).
+        #
+        #   @return [Integer]
+        required :seconds, Integer
+
+        # @!method initialize(seconds:, anchor: :created_at)
+        #   Some parameter documentations has been truncated, see
+        #   {OpenAI::Models::BatchCreateParams::OutputExpiresAfter} for more details.
+        #
+        #   The expiration policy for the output and/or error file that are generated for a
+        #   batch.
+        #
+        #   @param seconds [Integer] The number of seconds after the anchor time that the file will expire. Must be b
+        #
+        #   @param anchor [Symbol, :created_at] Anchor timestamp after which the expiration policy applies. Supported anchors: `
+      end
     end
   end
 end

data/lib/openai/models/beta/thread_create_and_run_params.rb

@@ -157,7 +157,7 @@ module OpenAI
 
         # @!attribute truncation_strategy
         #   Controls for how a thread will be truncated prior to the run. Use this to
-        #   control the intial context window of the run.
+        #   control the initial context window of the run.
         #
         #   @return [OpenAI::Models::Beta::ThreadCreateAndRunParams::TruncationStrategy, nil]
         optional :truncation_strategy,
@@ -694,7 +694,7 @@ module OpenAI
           #   details.
           #
           #   Controls for how a thread will be truncated prior to the run. Use this to
-          #   control the intial context window of the run.
+          #   control the initial context window of the run.
           #
           #   @param type [Symbol, OpenAI::Models::Beta::ThreadCreateAndRunParams::TruncationStrategy::Type] The truncation strategy to use for the thread. The default is `auto`. If set to
           #

data/lib/openai/models/beta/threads/run.rb

@@ -195,7 +195,7 @@ module OpenAI
 
           # @!attribute truncation_strategy
           #   Controls for how a thread will be truncated prior to the run. Use this to
-          #   control the intial context window of the run.
+          #   control the initial context window of the run.
           #
           #   @return [OpenAI::Models::Beta::Threads::Run::TruncationStrategy, nil]
           required :truncation_strategy, -> { OpenAI::Beta::Threads::Run::TruncationStrategy }, nil?: true
@@ -415,7 +415,7 @@ module OpenAI
             #   {OpenAI::Models::Beta::Threads::Run::TruncationStrategy} for more details.
             #
             #   Controls for how a thread will be truncated prior to the run. Use this to
-            #   control the intial context window of the run.
+            #   control the initial context window of the run.
             #
             #   @param type [Symbol, OpenAI::Models::Beta::Threads::Run::TruncationStrategy::Type] The truncation strategy to use for the thread. The default is `auto`. If set to
             #

data/lib/openai/models/beta/threads/run_create_params.rb

@@ -184,7 +184,7 @@ module OpenAI
 
           # @!attribute truncation_strategy
           #   Controls for how a thread will be truncated prior to the run. Use this to
-          #   control the intial context window of the run.
+          #   control the initial context window of the run.
           #
           #   @return [OpenAI::Models::Beta::Threads::RunCreateParams::TruncationStrategy, nil]
           optional :truncation_strategy,
@@ -413,7 +413,7 @@ module OpenAI
             #   details.
             #
             #   Controls for how a thread will be truncated prior to the run. Use this to
-            #   control the intial context window of the run.
+            #   control the initial context window of the run.
             #
             #   @param type [Symbol, OpenAI::Models::Beta::Threads::RunCreateParams::TruncationStrategy::Type] The truncation strategy to use for the thread. The default is `auto`. If set to
             #

data/lib/openai/models/chat/chat_completion.rb

@@ -47,9 +47,8 @@ module OpenAI
         #   - If set to 'default', then the request will be processed with the standard
         #     pricing and performance for the selected model.
         #   - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
-        #     'priority', then the request will be processed with the corresponding service
-        #     tier. [Contact sales](https://openai.com/contact-sales) to learn more about
-        #     Priority processing.
+        #     '[priority](https://openai.com/api-priority-processing/)', then the request
+        #     will be processed with the corresponding service tier.
         #   - When not set, the default behavior is 'auto'.
         #
         #   When the `service_tier` parameter is set, the response body will include the
@@ -61,6 +60,8 @@ module OpenAI
         optional :service_tier, enum: -> { OpenAI::Chat::ChatCompletion::ServiceTier }, nil?: true
 
         # @!attribute system_fingerprint
+        #   @deprecated
+        #
         #   This fingerprint represents the backend configuration that the model runs with.
         #
         #   Can be used in conjunction with the `seed` request parameter to understand when
@@ -196,9 +197,8 @@ module OpenAI
         # - If set to 'default', then the request will be processed with the standard
         #   pricing and performance for the selected model.
         # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
-        #   'priority', then the request will be processed with the corresponding service
-        #   tier. [Contact sales](https://openai.com/contact-sales) to learn more about
-        #   Priority processing.
+        #   '[priority](https://openai.com/api-priority-processing/)', then the request
+        #   will be processed with the corresponding service tier.
         # - When not set, the default behavior is 'auto'.
         #
         # When the `service_tier` parameter is set, the response body will include the

data/lib/openai/models/chat/chat_completion_chunk.rb

@@ -46,9 +46,8 @@ module OpenAI
         #   - If set to 'default', then the request will be processed with the standard
         #     pricing and performance for the selected model.
         #   - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
-        #     'priority', then the request will be processed with the corresponding service
-        #     tier. [Contact sales](https://openai.com/contact-sales) to learn more about
-        #     Priority processing.
+        #     '[priority](https://openai.com/api-priority-processing/)', then the request
+        #     will be processed with the corresponding service tier.
         #   - When not set, the default behavior is 'auto'.
         #
         #   When the `service_tier` parameter is set, the response body will include the
@@ -60,6 +59,8 @@ module OpenAI
         optional :service_tier, enum: -> { OpenAI::Chat::ChatCompletionChunk::ServiceTier }, nil?: true
 
         # @!attribute system_fingerprint
+        #   @deprecated
+        #
         #   This fingerprint represents the backend configuration that the model runs with.
         #   Can be used in conjunction with the `seed` request parameter to understand when
         #   backend changes have been made that might impact determinism.
@@ -379,9 +380,8 @@ module OpenAI
         # - If set to 'default', then the request will be processed with the standard
         #   pricing and performance for the selected model.
         # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
-        #   'priority', then the request will be processed with the corresponding service
-        #   tier. [Contact sales](https://openai.com/contact-sales) to learn more about
-        #   Priority processing.
+        #   '[priority](https://openai.com/api-priority-processing/)', then the request
+        #   will be processed with the corresponding service tier.
         # - When not set, the default behavior is 'auto'.
         #
         # When the `service_tier` parameter is set, the response body will include the

data/lib/openai/models/chat/completion_create_params.rb

@@ -226,6 +226,8 @@ module OpenAI
         optional :safety_identifier, String
 
         # @!attribute seed
+        #   @deprecated
+        #
         #   This feature is in Beta. If specified, our system will make a best effort to
         #   sample deterministically, such that repeated requests with the same `seed` and
         #   parameters should return the same result. Determinism is not guaranteed, and you
@@ -244,9 +246,8 @@ module OpenAI
         #   - If set to 'default', then the request will be processed with the standard
         #     pricing and performance for the selected model.
         #   - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
-        #     'priority', then the request will be processed with the corresponding service
-        #     tier. [Contact sales](https://openai.com/contact-sales) to learn more about
-        #     Priority processing.
+        #     '[priority](https://openai.com/api-priority-processing/)', then the request
+        #     will be processed with the corresponding service tier.
         #   - When not set, the default behavior is 'auto'.
         #
         #   When the `service_tier` parameter is set, the response body will include the
@@ -271,7 +272,7 @@ module OpenAI
         #   our [model distillation](https://platform.openai.com/docs/guides/distillation)
         #   or [evals](https://platform.openai.com/docs/guides/evals) products.
         #
-        #   Supports text and image inputs. Note: image inputs over 10MB will be dropped.
+        #   Supports text and image inputs. Note: image inputs over 8MB will be dropped.
         #
         #   @return [Boolean, nil]
         optional :store, OpenAI::Internal::Type::Boolean, nil?: true
@@ -591,9 +592,8 @@ module OpenAI
         # - If set to 'default', then the request will be processed with the standard
         #   pricing and performance for the selected model.
         # - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
-        #   'priority', then the request will be processed with the corresponding service
-        #   tier. [Contact sales](https://openai.com/contact-sales) to learn more about
-        #   Priority processing.
+        #   '[priority](https://openai.com/api-priority-processing/)', then the request
+        #   will be processed with the corresponding service tier.
         # - When not set, the default behavior is 'auto'.
         #
         # When the `service_tier` parameter is set, the response body will include the

data/lib/openai/models/file_create_params.rb

@@ -22,7 +22,14 @@ module OpenAI
       #   @return [Symbol, OpenAI::Models::FilePurpose]
       required :purpose, enum: -> { OpenAI::FilePurpose }
 
-      # @!method initialize(file:, purpose:, request_options: {})
+      # @!attribute expires_after
+      #   The expiration policy for a file. By default, files with `purpose=batch` expire
+      #   after 30 days and all other files are persisted until they are manually deleted.
+      #
+      #   @return [OpenAI::Models::FileCreateParams::ExpiresAfter, nil]
+      optional :expires_after, -> { OpenAI::FileCreateParams::ExpiresAfter }
+
+      # @!method initialize(file:, purpose:, expires_after: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {OpenAI::Models::FileCreateParams} for more details.
       #
@@ -30,7 +37,36 @@ module OpenAI
       #
       #   @param purpose [Symbol, OpenAI::Models::FilePurpose] The intended purpose of the uploaded file. One of: - `assistants`: Used in the A
       #
+      #   @param expires_after [OpenAI::Models::FileCreateParams::ExpiresAfter] The expiration policy for a file. By default, files with `purpose=batch` expire
+      #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+
+      class ExpiresAfter < OpenAI::Internal::Type::BaseModel
+        # @!attribute anchor
+        #   Anchor timestamp after which the expiration policy applies. Supported anchors:
+        #   `created_at`.
+        #
+        #   @return [Symbol, :created_at]
+        required :anchor, const: :created_at
+
+        # @!attribute seconds
+        #   The number of seconds after the anchor time that the file will expire. Must be
+        #   between 3600 (1 hour) and 2592000 (30 days).
+        #
+        #   @return [Integer]
+        required :seconds, Integer
+
+        # @!method initialize(seconds:, anchor: :created_at)
+        #   Some parameter documentations has been truncated, see
+        #   {OpenAI::Models::FileCreateParams::ExpiresAfter} for more details.
+        #
+        #   The expiration policy for a file. By default, files with `purpose=batch` expire
+        #   after 30 days and all other files are persisted until they are manually deleted.
+        #
+        #   @param seconds [Integer] The number of seconds after the anchor time that the file will expire. Must be b
+        #
+        #   @param anchor [Symbol, :created_at] Anchor timestamp after which the expiration policy applies. Supported anchors: `
+      end
     end
   end
 end

data/lib/openai/models/graders/text_similarity_grader.rb

@@ -5,8 +5,8 @@ module OpenAI
     module Graders
       class TextSimilarityGrader < OpenAI::Internal::Type::BaseModel
         # @!attribute evaluation_metric
-        #   The evaluation metric to use. One of `fuzzy_match`, `bleu`, `gleu`, `meteor`,
-        #   `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5`, or `rouge_l`.
+        #   The evaluation metric to use. One of `cosine`, `fuzzy_match`, `bleu`, `gleu`,
+        #   `meteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5`, or `rouge_l`.
         #
         #   @return [Symbol, OpenAI::Models::Graders::TextSimilarityGrader::EvaluationMetric]
         required :evaluation_metric, enum: -> { OpenAI::Graders::TextSimilarityGrader::EvaluationMetric }
@@ -41,7 +41,7 @@ module OpenAI
         #
         #   A TextSimilarityGrader object which grades text based on similarity metrics.
         #
-        #   @param evaluation_metric [Symbol, OpenAI::Models::Graders::TextSimilarityGrader::EvaluationMetric] The evaluation metric to use. One of `fuzzy_match`, `bleu`, `gleu`, `meteor`, `r
+        #   @param evaluation_metric [Symbol, OpenAI::Models::Graders::TextSimilarityGrader::EvaluationMetric] The evaluation metric to use. One of `cosine`, `fuzzy_match`, `bleu`,
         #
         #   @param input [String] The text being graded.
         #
@@ -51,13 +51,14 @@ module OpenAI
         #
         #   @param type [Symbol, :text_similarity] The type of grader.
 
-        # The evaluation metric to use. One of `fuzzy_match`, `bleu`, `gleu`, `meteor`,
-        # `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5`, or `rouge_l`.
+        # The evaluation metric to use. One of `cosine`, `fuzzy_match`, `bleu`, `gleu`,
+        # `meteor`, `rouge_1`, `rouge_2`, `rouge_3`, `rouge_4`, `rouge_5`, or `rouge_l`.
         #
         # @see OpenAI::Models::Graders::TextSimilarityGrader#evaluation_metric
         module EvaluationMetric
           extend OpenAI::Internal::Type::Enum
 
+          COSINE = :cosine
           FUZZY_MATCH = :fuzzy_match
           BLEU = :bleu
           GLEU = :gleu

data/lib/openai/models/reasoning.rb

@@ -37,7 +37,7 @@ module OpenAI
       #   Some parameter documentations has been truncated, see
       #   {OpenAI::Models::Reasoning} for more details.
       #
-      #   **o-series models only**
+      #   **gpt-5 and o-series models only**
       #
       #   Configuration options for
       #   [reasoning models](https://platform.openai.com/docs/guides/reasoning).