openai 0.57.0 → 0.58.0

data/rbi/openai/models/vector_stores/file_batch_create_params.rbi

@@ -63,8 +63,9 @@ module OpenAI
         # A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
         # the vector store should use. Useful for tools like `file_search` that can access
         # files. If `attributes` or `chunking_strategy` are provided, they will be applied
-        # to all files in the batch. The maximum batch size is 2000 files. Mutually
-        # exclusive with `files`.
+        # to all files in the batch. The maximum batch size is 2000 files. This endpoint
+        # is recommended for multi-file ingestion and helps reduce per-vector-store write
+        # request pressure. Mutually exclusive with `files`.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :file_ids
 
@@ -74,8 +75,9 @@ module OpenAI
         # A list of objects that each include a `file_id` plus optional `attributes` or
         # `chunking_strategy`. Use this when you need to override metadata for specific
         # files. The global `attributes` or `chunking_strategy` will be ignored and must
-        # be specified for each file. The maximum batch size is 2000 files. Mutually
-        # exclusive with `file_ids`.
+        # be specified for each file. The maximum batch size is 2000 files. This endpoint
+        # is recommended for multi-file ingestion and helps reduce per-vector-store write
+        # request pressure. Mutually exclusive with `file_ids`.
         sig do
           returns(
             T.nilable(
@@ -132,14 +134,16 @@ module OpenAI
           # A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
           # the vector store should use. Useful for tools like `file_search` that can access
           # files. If `attributes` or `chunking_strategy` are provided, they will be applied
-          # to all files in the batch. The maximum batch size is 2000 files. Mutually
-          # exclusive with `files`.
+          # to all files in the batch. The maximum batch size is 2000 files. This endpoint
+          # is recommended for multi-file ingestion and helps reduce per-vector-store write
+          # request pressure. Mutually exclusive with `files`.
           file_ids: nil,
           # A list of objects that each include a `file_id` plus optional `attributes` or
           # `chunking_strategy`. Use this when you need to override metadata for specific
           # files. The global `attributes` or `chunking_strategy` will be ignored and must
-          # be specified for each file. The maximum batch size is 2000 files. Mutually
-          # exclusive with `file_ids`.
+          # be specified for each file. The maximum batch size is 2000 files. This endpoint
+          # is recommended for multi-file ingestion and helps reduce per-vector-store write
+          # request pressure. Mutually exclusive with `file_ids`.
           files: nil,
           request_options: {}
         )
@@ -198,7 +202,9 @@ module OpenAI
 
           # A [File](https://platform.openai.com/docs/api-reference/files) ID that the
           # vector store should use. Useful for tools like `file_search` that can access
-          # files.
+          # files. For multi-file ingestion, we recommend
+          # [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+          # to minimize per-vector-store write requests.
           sig { returns(String) }
           attr_accessor :file_id
 
@@ -264,7 +270,9 @@ module OpenAI
           def self.new(
             # A [File](https://platform.openai.com/docs/api-reference/files) ID that the
             # vector store should use. Useful for tools like `file_search` that can access
-            # files.
+            # files. For multi-file ingestion, we recommend
+            # [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+            # to minimize per-vector-store write requests.
             file_id:,
             # Set of 16 key-value pairs that can be attached to an object. This can be useful
             # for storing additional information about the object in a structured format, and

data/rbi/openai/models/vector_stores/file_create_params.rbi

@@ -20,7 +20,9 @@ module OpenAI
 
         # A [File](https://platform.openai.com/docs/api-reference/files) ID that the
         # vector store should use. Useful for tools like `file_search` that can access
-        # files.
+        # files. For multi-file ingestion, we recommend
+        # [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+        # to minimize per-vector-store write requests.
         sig { returns(String) }
         attr_accessor :file_id
 
@@ -89,7 +91,9 @@ module OpenAI
           vector_store_id:,
           # A [File](https://platform.openai.com/docs/api-reference/files) ID that the
           # vector store should use. Useful for tools like `file_search` that can access
-          # files.
+          # files. For multi-file ingestion, we recommend
+          # [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+          # to minimize per-vector-store write requests.
           file_id:,
           # Set of 16 key-value pairs that can be attached to an object. This can be useful
           # for storing additional information about the object in a structured format, and

data/rbi/openai/models.rbi

@@ -169,6 +169,8 @@ module OpenAI
 
   ModerationTextInput = OpenAI::Models::ModerationTextInput
 
+  OAuthErrorCode = OpenAI::Models::OAuthErrorCode
+
   OtherFileChunkingStrategyObject =
     OpenAI::Models::OtherFileChunkingStrategyObject
 

data/rbi/openai/resources/realtime/calls.rbi

@@ -99,8 +99,9 @@ module OpenAI
           # Tools available to the model.
           tools: nil,
           # Realtime API can write session traces to the
-          # [Traces Dashboard](/logs?api=traces). Set to null to disable tracing. Once
-          # tracing is enabled for a session, the configuration cannot be modified.
+          # [Traces Dashboard](https://platform.openai.com/logs?api=traces). Set to null to
+          # disable tracing. Once tracing is enabled for a session, the configuration cannot
+          # be modified.
           #
           # `auto` will create a trace for the session with default values for the workflow
           # name, group id, and metadata.

data/rbi/openai/resources/vector_stores/file_batches.rbi

@@ -43,14 +43,16 @@ module OpenAI
           # A list of [File](https://platform.openai.com/docs/api-reference/files) IDs that
           # the vector store should use. Useful for tools like `file_search` that can access
           # files. If `attributes` or `chunking_strategy` are provided, they will be applied
-          # to all files in the batch. The maximum batch size is 2000 files. Mutually
-          # exclusive with `files`.
+          # to all files in the batch. The maximum batch size is 2000 files. This endpoint
+          # is recommended for multi-file ingestion and helps reduce per-vector-store write
+          # request pressure. Mutually exclusive with `files`.
           file_ids: nil,
           # A list of objects that each include a `file_id` plus optional `attributes` or
           # `chunking_strategy`. Use this when you need to override metadata for specific
           # files. The global `attributes` or `chunking_strategy` will be ignored and must
-          # be specified for each file. The maximum batch size is 2000 files. Mutually
-          # exclusive with `file_ids`.
+          # be specified for each file. The maximum batch size is 2000 files. This endpoint
+          # is recommended for multi-file ingestion and helps reduce per-vector-store write
+          # request pressure. Mutually exclusive with `file_ids`.
           files: nil,
           request_options: {}
         )

data/rbi/openai/resources/vector_stores/files.rbi

@@ -31,7 +31,9 @@ module OpenAI
           vector_store_id,
           # A [File](https://platform.openai.com/docs/api-reference/files) ID that the
           # vector store should use. Useful for tools like `file_search` that can access
-          # files.
+          # files. For multi-file ingestion, we recommend
+          # [`file_batches`](https://platform.openai.com/docs/api-reference/vector-stores-file-batches/createBatch)
+          # to minimize per-vector-store write requests.
           file_id:,
           # Set of 16 key-value pairs that can be attached to an object. This can be useful
           # for storing additional information about the object in a structured format, and

data/sig/openai/internal/util.rbs

@@ -45,8 +45,12 @@ module OpenAI
         -> top?
       } -> top?
 
+      RFC_3986_NOT_PCHARS: Regexp
+
       def self?.uri_origin: (URI::Generic uri) -> String
 
+      def self?.encode_path: (String | Integer path) -> String
+
       def self?.interpolate_path: (String | ::Array[String] path) -> String
 
       def self?.decode_query: (String? query) -> ::Hash[String, ::Array[String]]

data/sig/openai/models/conversations/message.rbs

@@ -7,7 +7,8 @@ module OpenAI
           content: ::Array[OpenAI::Models::Conversations::Message::content],
           role: OpenAI::Models::Conversations::Message::role,
           status: OpenAI::Models::Conversations::Message::status,
-          type: :message
+          type: :message,
+          phase: OpenAI::Models::Conversations::Message::phase?
         }
 
       class Message < OpenAI::Internal::Type::BaseModel
@@ -21,11 +22,14 @@ module OpenAI
 
         attr_accessor type: :message
 
+        attr_accessor phase: OpenAI::Models::Conversations::Message::phase?
+
         def initialize: (
           id: String,
           content: ::Array[OpenAI::Models::Conversations::Message::content],
           role: OpenAI::Models::Conversations::Message::role,
           status: OpenAI::Models::Conversations::Message::status,
+          ?phase: OpenAI::Models::Conversations::Message::phase?,
           ?type: :message
         ) -> void
 
@@ -34,7 +38,8 @@ module OpenAI
           content: ::Array[OpenAI::Models::Conversations::Message::content],
           role: OpenAI::Models::Conversations::Message::role,
           status: OpenAI::Models::Conversations::Message::status,
-          type: :message
+          type: :message,
+          phase: OpenAI::Models::Conversations::Message::phase?
         }
 
         type content =
@@ -102,6 +107,17 @@ module OpenAI
 
           def self?.values: -> ::Array[OpenAI::Models::Conversations::Message::status]
         end
+
+        type phase = :commentary | :final_answer
+
+        module Phase
+          extend OpenAI::Internal::Type::Enum
+
+          COMMENTARY: :commentary
+          FINAL_ANSWER: :final_answer
+
+          def self?.values: -> ::Array[OpenAI::Models::Conversations::Message::phase]
+        end
       end
     end
   end

data/sig/openai/models/oauth_error_code.rbs

@@ -0,0 +1,14 @@
+module OpenAI
+  module Models
+    type oauth_error_code = :invalid_grant | :invalid_subject_token | String
+
+    module OAuthErrorCode
+      extend OpenAI::Internal::Type::Union
+
+      def self?.variants: -> ::Array[OpenAI::Models::oauth_error_code]
+
+      INVALID_GRANT: :invalid_grant
+      INVALID_SUBJECT_TOKEN: :invalid_subject_token
+    end
+  end
+end

data/sig/openai/models.rbs

@@ -165,6 +165,8 @@ module OpenAI
 
   class ModerationTextInput = OpenAI::Models::ModerationTextInput
 
+  module OAuthErrorCode = OpenAI::Models::OAuthErrorCode
+
   class OtherFileChunkingStrategyObject = OpenAI::Models::OtherFileChunkingStrategyObject
 
   module Realtime = OpenAI::Models::Realtime

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: openai
 version: !ruby/object:Gem::Version
-  version: 0.57.0
+  version: 0.58.0
 platform: ruby
 authors:
 - OpenAI
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-25 00:00:00.000000000 Z
+date: 2026-04-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -64,6 +64,13 @@ files:
 - README.md
 - SECURITY.md
 - lib/openai.rb
+- lib/openai/auth/subject_token_provider.rb
+- lib/openai/auth/subject_token_providers/azure_managed_identity_token_provider.rb
+- lib/openai/auth/subject_token_providers/gcp_id_token_provider.rb
+- lib/openai/auth/subject_token_providers/k8s_service_account_token_provider.rb
+- lib/openai/auth/token_type.rb
+- lib/openai/auth/workload_identity.rb
+- lib/openai/auth/workload_identity_auth.rb
 - lib/openai/client.rb
 - lib/openai/errors.rb
 - lib/openai/file_part.rb
@@ -450,6 +457,7 @@ files:
 - lib/openai/models/moderation_model.rb
 - lib/openai/models/moderation_multi_modal_input.rb
 - lib/openai/models/moderation_text_input.rb
+- lib/openai/models/oauth_error_code.rb
 - lib/openai/models/other_file_chunking_strategy_object.rb
 - lib/openai/models/realtime/audio_transcription.rb
 - lib/openai/models/realtime/call_accept_params.rb
@@ -872,6 +880,7 @@ files:
 - lib/openai/structured_output.rb
 - lib/openai/version.rb
 - manifest.yaml
+- rbi/openai/auth.rbi
 - rbi/openai/client.rbi
 - rbi/openai/errors.rbi
 - rbi/openai/file_part.rbi
@@ -1253,6 +1262,7 @@ files:
 - rbi/openai/models/moderation_model.rbi
 - rbi/openai/models/moderation_multi_modal_input.rbi
 - rbi/openai/models/moderation_text_input.rbi
+- rbi/openai/models/oauth_error_code.rbi
 - rbi/openai/models/other_file_chunking_strategy_object.rbi
 - rbi/openai/models/realtime/audio_transcription.rbi
 - rbi/openai/models/realtime/call_accept_params.rbi
@@ -2046,6 +2056,7 @@ files:
 - sig/openai/models/moderation_model.rbs
 - sig/openai/models/moderation_multi_modal_input.rbs
 - sig/openai/models/moderation_text_input.rbs
+- sig/openai/models/oauth_error_code.rbs
 - sig/openai/models/other_file_chunking_strategy_object.rbs
 - sig/openai/models/realtime/audio_transcription.rbs
 - sig/openai/models/realtime/call_accept_params.rbs