openai 0.91.0 → 0.93.0

data/rbi/openai/models/beta/agents/vaults/credential_networking_param.rbi

@@ -0,0 +1,129 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Beta
+
+      module Agents
+
+        module Vaults
+
+          # Destination permissions for an environment-variable credential. These do not
+          # grant network access to the environment.
+          module CredentialNetworkingParam
+            extend OpenAI::Internal::Type::Union
+
+            Variants = T.type_alias do
+              T.any(
+                OpenAI::Beta::Agents::Vaults::CredentialNetworkingParam::Unrestricted,
+                OpenAI::Beta::Agents::Vaults::CredentialNetworkingParam::Limited
+              )
+            end
+
+            class Unrestricted < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Beta::Agents::Vaults::CredentialNetworkingParam::Unrestricted,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              # The type of the object. Always `unrestricted`.
+              sig { returns(Symbol) }
+              attr_accessor :type
+
+              # Allows substitution for destinations permitted by the environment network
+              # policy. Requires `environment.network.access` to be `restricted`, with explicit
+              # `allowed_domains`.
+              sig do
+                params(
+
+                  type: Symbol
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                # The type of the object. Always `unrestricted`.
+
+                type: :unrestricted
+              )
+              end
+
+              sig do
+                override.returns(
+                  {type: Symbol}
+                )
+              end
+              def to_hash
+              end
+
+            end
+
+            class Limited < OpenAI::Internal::Type::BaseModel
+              OrHash = T.type_alias do
+                T.any(
+                  OpenAI::Beta::Agents::Vaults::CredentialNetworkingParam::Limited,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+              # The 1 to 16 distinct allowed hostnames or IPv4 addresses, normalized to
+              # lowercase. Entries contain no scheme, path, port, or wildcard. IPv6 addresses
+              # are not supported.
+              sig { returns(T::Array[String]) }
+              attr_accessor :allowed_hosts
+
+              # The type of the object. Always `limited`.
+              sig { returns(Symbol) }
+              attr_accessor :type
+
+              # Allows substitution only for the listed hosts. The environment network policy
+              # must also allow these hosts.
+              sig do
+                params(
+
+                  allowed_hosts: T::Array[String],
+
+                  type: Symbol
+                )
+                  .returns(T.attached_class)
+              end
+              def self.new(
+
+                # The 1 to 16 distinct allowed hostnames or IPv4 addresses, normalized to
+                # lowercase. Entries contain no scheme, path, port, or wildcard. IPv6 addresses
+                # are not supported.
+                allowed_hosts:,
+
+                # The type of the object. Always `limited`.
+
+                type: :limited
+              )
+              end
+
+              sig do
+                override.returns(
+                  {allowed_hosts: T::Array[String], type: Symbol}
+                )
+              end
+              def to_hash
+              end
+
+            end
+
+            sig { override.returns(T::Array[OpenAI::Beta::Agents::Vaults::CredentialNetworkingParam::Variants]) }
+            def self.variants
+            end
+
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/beta/agents/vaults/credential_update_params.rbi

@@ -32,7 +32,8 @@ module OpenAI
               returns(
                 T.any(
                   OpenAI::Beta::Agents::Vaults::CredentialAuthRotateParam::McpOauth,
-                  OpenAI::Beta::Agents::Vaults::CredentialAuthRotateParam::StaticBearer
+                  OpenAI::Beta::Agents::Vaults::CredentialAuthRotateParam::StaticBearer,
+                  OpenAI::Beta::Agents::Vaults::CredentialAuthRotateParam::EnvironmentVariable
                 )
               )
             }
@@ -47,7 +48,8 @@ module OpenAI
 
                 auth: T.any(
                   OpenAI::Beta::Agents::Vaults::CredentialAuthRotateParam::McpOauth::OrHash,
-                  OpenAI::Beta::Agents::Vaults::CredentialAuthRotateParam::StaticBearer::OrHash
+                  OpenAI::Beta::Agents::Vaults::CredentialAuthRotateParam::StaticBearer::OrHash,
+                  OpenAI::Beta::Agents::Vaults::CredentialAuthRotateParam::EnvironmentVariable::OrHash
                 ),
 
                 request_options: OpenAI::RequestOptions::OrHash
@@ -74,7 +76,8 @@ module OpenAI
                   credential_id: String,
                   auth: T.any(
                     OpenAI::Beta::Agents::Vaults::CredentialAuthRotateParam::McpOauth,
-                    OpenAI::Beta::Agents::Vaults::CredentialAuthRotateParam::StaticBearer
+                    OpenAI::Beta::Agents::Vaults::CredentialAuthRotateParam::StaticBearer,
+                    OpenAI::Beta::Agents::Vaults::CredentialAuthRotateParam::EnvironmentVariable
                   ),
                   request_options: OpenAI::RequestOptions
                 }

data/rbi/openai/models/beta/beta_response.rbi

@@ -882,6 +882,7 @@ module OpenAI
           GPT_5_1 = T.let(:"gpt-5.1", OpenAI::Beta::BetaResponse::Model::TaggedSymbol)
           GPT_5_1_2025_11_13 = T.let(:"gpt-5.1-2025-11-13", OpenAI::Beta::BetaResponse::Model::TaggedSymbol)
           GPT_5_1_CODEX = T.let(:"gpt-5.1-codex", OpenAI::Beta::BetaResponse::Model::TaggedSymbol)
+          GPT_5_1_MINI = T.let(:"gpt-5.1-mini", OpenAI::Beta::BetaResponse::Model::TaggedSymbol)
           GPT_5_1_CHAT_LATEST = T.let(:"gpt-5.1-chat-latest", OpenAI::Beta::BetaResponse::Model::TaggedSymbol)
           GPT_5 = T.let(:"gpt-5", OpenAI::Beta::BetaResponse::Model::TaggedSymbol)
           GPT_5_MINI = T.let(:"gpt-5-mini", OpenAI::Beta::BetaResponse::Model::TaggedSymbol)
@@ -974,7 +975,6 @@ module OpenAI
           GPT_3_5_TURBO_1106 = T.let(:"gpt-3.5-turbo-1106", OpenAI::Beta::BetaResponse::Model::TaggedSymbol)
           GPT_3_5_TURBO_0125 = T.let(:"gpt-3.5-turbo-0125", OpenAI::Beta::BetaResponse::Model::TaggedSymbol)
           GPT_3_5_TURBO_16K_0613 = T.let(:"gpt-3.5-turbo-16k-0613", OpenAI::Beta::BetaResponse::Model::TaggedSymbol)
-          GPT_5_1_MINI = T.let(:"gpt-5.1-mini", OpenAI::Beta::BetaResponse::Model::TaggedSymbol)
           O1_PRO = T.let(:"o1-pro", OpenAI::Beta::BetaResponse::Model::TaggedSymbol)
           O1_PRO_2025_03_19 = T.let(:"o1-pro-2025-03-19", OpenAI::Beta::BetaResponse::Model::TaggedSymbol)
           O3_PRO = T.let(:"o3-pro", OpenAI::Beta::BetaResponse::Model::TaggedSymbol)

data/rbi/openai/models/beta/beta_response_output_text_annotation_added_event.rbi

@@ -16,7 +16,7 @@ module OpenAI
           )
         end
 
-        # An annotation that applies to a span of output text.
+        # The annotation object being added. (See annotation schema for details.)
         sig { returns(T.nilable(OpenAI::Beta::BetaResponseOutputTextAnnotationAddedEvent::Annotation::Variants)) }
         attr_accessor :annotation
 
@@ -82,7 +82,7 @@ module OpenAI
         end
         def self.new(
 
-          # An annotation that applies to a span of output text.
+          # The annotation object being added. (See annotation schema for details.)
           annotation:,
 
           # The index of the annotation within the content part.
@@ -126,7 +126,7 @@ module OpenAI
         def to_hash
         end
 
-        # An annotation that applies to a span of output text.
+        # The annotation object being added. (See annotation schema for details.)
         module Annotation
           extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/beta/beta_responses_client_event.rbi

@@ -1113,6 +1113,10 @@ module OpenAI
               :"gpt-5.1-codex",
               OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Model::TaggedSymbol
             )
+            GPT_5_1_MINI = T.let(
+              :"gpt-5.1-mini",
+              OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Model::TaggedSymbol
+            )
             GPT_5_1_CHAT_LATEST = T.let(
               :"gpt-5.1-chat-latest",
               OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Model::TaggedSymbol
@@ -1343,10 +1347,6 @@ module OpenAI
               :"gpt-3.5-turbo-16k-0613",
               OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Model::TaggedSymbol
             )
-            GPT_5_1_MINI = T.let(
-              :"gpt-5.1-mini",
-              OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Model::TaggedSymbol
-            )
             O1_PRO = T.let(:"o1-pro", OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Model::TaggedSymbol)
             O1_PRO_2025_03_19 = T.let(
               :"o1-pro-2025-03-19",

data/rbi/openai/models/beta/beta_responses_server_event.rbi

@@ -4484,7 +4484,7 @@ module OpenAI
           end
           def self.new(
 
-            # An annotation that applies to a span of output text.
+            # The annotation object being added. (See annotation schema for details.)
             annotation:,
 
             # The index of the annotation within the content part.

data/rbi/openai/models/beta/beta_tool.rbi

@@ -70,6 +70,10 @@ module OpenAI
           # service connectors
           # [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
           #
+          # This field is deprecated for models released after September 1, 2026. Use
+          # `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+          # through a Secure MCP Tunnel.
+          #
           # Currently supported `connector_id` values are:
           #
           # - Dropbox: `connector_dropbox`
@@ -194,6 +198,10 @@ module OpenAI
             # service connectors
             # [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
             #
+            # This field is deprecated for models released after September 1, 2026. Use
+            # `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+            # through a Secure MCP Tunnel.
+            #
             # Currently supported `connector_id` values are:
             #
             # - Dropbox: `connector_dropbox`
@@ -358,6 +366,10 @@ module OpenAI
           # service connectors
           # [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
           #
+          # This field is deprecated for models released after September 1, 2026. Use
+          # `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+          # through a Secure MCP Tunnel.
+          #
           # Currently supported `connector_id` values are:
           #
           # - Dropbox: `connector_dropbox`
@@ -964,10 +976,9 @@ module OpenAI
           sig { params(background: OpenAI::Beta::BetaTool::ImageGeneration::Background::OrSymbol).void }
           attr_writer :background
 
-          # Control how much effort the model will exert to match the style and features,
-          # especially facial features, of input images. This parameter is only supported
-          # for `gpt-image-1` and `gpt-image-1.5` and later models, unsupported for
-          # `gpt-image-1-mini`. Supports `high` and `low`. Defaults to `low`.
+          # Controls fidelity to the original input image(s). This parameter is supported
+          # for GPT image models that support input fidelity. `gpt-image-2` and
+          # `gpt-image-2-2026-04-21` ignore this parameter.
           sig { returns(T.nilable(OpenAI::Beta::BetaTool::ImageGeneration::InputFidelity::OrSymbol)) }
           attr_accessor :input_fidelity
 
@@ -1094,10 +1105,9 @@ module OpenAI
             # set the output format to `png` or `webp`.
             background: nil,
 
-            # Control how much effort the model will exert to match the style and features,
-            # especially facial features, of input images. This parameter is only supported
-            # for `gpt-image-1` and `gpt-image-1.5` and later models, unsupported for
-            # `gpt-image-1-mini`. Supports `high` and `low`. Defaults to `low`.
+            # Controls fidelity to the original input image(s). This parameter is supported
+            # for GPT image models that support input fidelity. `gpt-image-2` and
+            # `gpt-image-2-2026-04-21` ignore this parameter.
             input_fidelity: nil,
 
             # Optional mask for inpainting. Contains `image_url` (string, optional) and
@@ -1212,10 +1222,9 @@ module OpenAI
             end
           end
 
-          # Control how much effort the model will exert to match the style and features,
-          # especially facial features, of input images. This parameter is only supported
-          # for `gpt-image-1` and `gpt-image-1.5` and later models, unsupported for
-          # `gpt-image-1-mini`. Supports `high` and `low`. Defaults to `low`.
+          # Controls fidelity to the original input image(s). This parameter is supported
+          # for GPT image models that support input fidelity. `gpt-image-2` and
+          # `gpt-image-2-2026-04-21` ignore this parameter.
           module InputFidelity
             extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/beta/environment_param.rbi

@@ -99,14 +99,15 @@ module OpenAI
           }
           attr_accessor :files
 
-          # Network access for an OpenAI-hosted environment.
+          # Network access policy for the environment. Defaults to disabled for GA requests
+          # and enabled for alpha/beta requests.
           sig { returns(T.nilable(OpenAI::Beta::EnvironmentParam::OpenAIHosted::Network)) }
           attr_reader :network
 
           sig { params(network: T.nilable(OpenAI::Beta::EnvironmentParam::OpenAIHosted::Network::OrHash)).void }
           attr_writer :network
 
-          # Packages to install in an OpenAI-hosted environment.
+          # Packages to install in the environment. Defaults to empty package lists.
           sig { returns(T.nilable(OpenAI::Beta::EnvironmentParam::OpenAIHosted::Packages)) }
           attr_reader :packages
 
@@ -188,10 +189,11 @@ module OpenAI
             # Files available before the agent starts. Defaults to an empty list.
             files: nil,
 
-            # Network access for an OpenAI-hosted environment.
+            # Network access policy for the environment. Defaults to disabled for GA requests
+            # and enabled for alpha/beta requests.
             network: nil,
 
-            # Packages to install in an OpenAI-hosted environment.
+            # Packages to install in the environment. Defaults to empty package lists.
             packages: nil,
 
             # Plugins provided as inline ZIP archives. Defaults to an empty list.
@@ -256,7 +258,8 @@ module OpenAI
             sig { returns(T.nilable(T::Array[String])) }
             attr_accessor :allowed_domains
 
-            # Network access for an OpenAI-hosted environment.
+            # Network access policy for the environment. Defaults to disabled for GA requests
+            # and enabled for alpha/beta requests.
             sig do
               params(
 
@@ -297,7 +300,7 @@ module OpenAI
               }
               OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-              # Allows unrestricted network access, matching an omitted network policy.
+              # Allows unrestricted network access.
               ENABLED = T.let(:enabled, OpenAI::Beta::EnvironmentParam::OpenAIHosted::Network::Access::TaggedSymbol)
 
               # Disables network access.
@@ -337,7 +340,7 @@ module OpenAI
             sig { returns(T.nilable(T::Array[String])) }
             attr_accessor :system_
 
-            # Packages to install in an OpenAI-hosted environment.
+            # Packages to install in the environment. Defaults to empty package lists.
             sig do
               params(
 

data/rbi/openai/models/beta/persisted_agent_tool.rbi

@@ -327,7 +327,7 @@ module OpenAI
           sig { returns(OpenAI::Beta::PersistedAgentTool::WebSearch::ContextSize::TaggedSymbol) }
           attr_accessor :context_size
 
-          # Approximate user location used to localize web search results.
+          # Approximate location used to localize search results, if provided.
           sig { returns(T.nilable(OpenAI::Beta::PersistedAgentTool::WebSearch::Location)) }
           attr_reader :location
 
@@ -366,7 +366,7 @@ module OpenAI
             # The amount of search context made available to the model. Defaults to `medium`.
             context_size:,
 
-            # Approximate user location used to localize web search results.
+            # Approximate location used to localize search results, if provided.
             location:,
 
             # The source used for web search results.
@@ -432,7 +432,7 @@ module OpenAI
             sig { returns(T.nilable(String)) }
             attr_accessor :timezone
 
-            # Approximate user location used to localize web search results.
+            # Approximate location used to localize search results, if provided.
             sig do
               params(
 

data/rbi/openai/models/beta/persisted_agent_tool_param.rbi

@@ -220,7 +220,7 @@ module OpenAI
           sig { returns(T.nilable(T::Array[String])) }
           attr_accessor :allowed_tools
 
-          # Where outbound MCP HTTP connections originate.
+          # Selects where outbound MCP HTTP connections originate.
           sig { returns(T.nilable(OpenAI::Beta::PersistedAgentToolParam::Mcp::ConnectionOrigin::OrSymbol)) }
           attr_accessor :connection_origin
 
@@ -277,7 +277,7 @@ module OpenAI
             # The MCP tools the agent may call. All server tools are allowed when omitted.
             allowed_tools: nil,
 
-            # Where outbound MCP HTTP connections originate.
+            # Selects where outbound MCP HTTP connections originate.
             connection_origin: nil,
 
             # The vault credential selected for this MCP server. Optional when exactly one
@@ -317,7 +317,7 @@ module OpenAI
           def to_hash
           end
 
-          # Where outbound MCP HTTP connections originate.
+          # Selects where outbound MCP HTTP connections originate.
           module ConnectionOrigin
             extend OpenAI::Internal::Type::Enum
 
@@ -357,18 +357,18 @@ module OpenAI
           sig { returns(T.nilable(T::Array[String])) }
           attr_accessor :allowed_domains
 
-          # The amount of web search context made available to the model.
+          # The amount of search context made available to the model. Defaults to `medium`.
           sig { returns(T.nilable(OpenAI::Beta::PersistedAgentToolParam::WebSearch::ContextSize::OrSymbol)) }
           attr_accessor :context_size
 
-          # Approximate user location used to localize web search results.
+          # Approximate location used to localize search results.
           sig { returns(T.nilable(OpenAI::Beta::PersistedAgentToolParam::WebSearch::Location)) }
           attr_reader :location
 
           sig { params(location: T.nilable(OpenAI::Beta::PersistedAgentToolParam::WebSearch::Location::OrHash)).void }
           attr_writer :location
 
-          # The source used for web search results.
+          # The source used for web search results. Defaults to `live`.
           sig { returns(T.nilable(OpenAI::Beta::PersistedAgentToolParam::WebSearch::Mode::OrSymbol)) }
           attr_accessor :mode
 
@@ -393,13 +393,13 @@ module OpenAI
             # Domains the search may include.
             allowed_domains: nil,
 
-            # The amount of web search context made available to the model.
+            # The amount of search context made available to the model. Defaults to `medium`.
             context_size: nil,
 
-            # Approximate user location used to localize web search results.
+            # Approximate location used to localize search results.
             location: nil,
 
-            # The source used for web search results.
+            # The source used for web search results. Defaults to `live`.
             mode: nil,
 
             # The type of the object. Always `web_search`.
@@ -422,7 +422,7 @@ module OpenAI
           def to_hash
           end
 
-          # The amount of web search context made available to the model.
+          # The amount of search context made available to the model. Defaults to `medium`.
           module ContextSize
             extend OpenAI::Internal::Type::Enum
 
@@ -466,7 +466,7 @@ module OpenAI
             sig { returns(T.nilable(String)) }
             attr_accessor :timezone
 
-            # Approximate user location used to localize web search results.
+            # Approximate location used to localize search results.
             sig do
               params(
 
@@ -512,7 +512,7 @@ module OpenAI
 
           end
 
-          # The source used for web search results.
+          # The source used for web search results. Defaults to `live`.
           module Mode
             extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/beta/response_compact_params.rbi

@@ -251,6 +251,7 @@ module OpenAI
           GPT_5_1 = T.let(:"gpt-5.1", OpenAI::Beta::ResponseCompactParams::Model::TaggedSymbol)
           GPT_5_1_2025_11_13 = T.let(:"gpt-5.1-2025-11-13", OpenAI::Beta::ResponseCompactParams::Model::TaggedSymbol)
           GPT_5_1_CODEX = T.let(:"gpt-5.1-codex", OpenAI::Beta::ResponseCompactParams::Model::TaggedSymbol)
+          GPT_5_1_MINI = T.let(:"gpt-5.1-mini", OpenAI::Beta::ResponseCompactParams::Model::TaggedSymbol)
           GPT_5_1_CHAT_LATEST = T.let(:"gpt-5.1-chat-latest", OpenAI::Beta::ResponseCompactParams::Model::TaggedSymbol)
           GPT_5 = T.let(:"gpt-5", OpenAI::Beta::ResponseCompactParams::Model::TaggedSymbol)
           GPT_5_MINI = T.let(:"gpt-5-mini", OpenAI::Beta::ResponseCompactParams::Model::TaggedSymbol)
@@ -376,7 +377,6 @@ module OpenAI
             :"gpt-3.5-turbo-16k-0613",
             OpenAI::Beta::ResponseCompactParams::Model::TaggedSymbol
           )
-          GPT_5_1_MINI = T.let(:"gpt-5.1-mini", OpenAI::Beta::ResponseCompactParams::Model::TaggedSymbol)
           O1_PRO = T.let(:"o1-pro", OpenAI::Beta::ResponseCompactParams::Model::TaggedSymbol)
           O1_PRO_2025_03_19 = T.let(:"o1-pro-2025-03-19", OpenAI::Beta::ResponseCompactParams::Model::TaggedSymbol)
           O3_PRO = T.let(:"o3-pro", OpenAI::Beta::ResponseCompactParams::Model::TaggedSymbol)

data/rbi/openai/models/beta/response_create_params.rbi

@@ -975,6 +975,7 @@ module OpenAI
           GPT_5_1 = T.let(:"gpt-5.1", OpenAI::Beta::ResponseCreateParams::Model::TaggedSymbol)
           GPT_5_1_2025_11_13 = T.let(:"gpt-5.1-2025-11-13", OpenAI::Beta::ResponseCreateParams::Model::TaggedSymbol)
           GPT_5_1_CODEX = T.let(:"gpt-5.1-codex", OpenAI::Beta::ResponseCreateParams::Model::TaggedSymbol)
+          GPT_5_1_MINI = T.let(:"gpt-5.1-mini", OpenAI::Beta::ResponseCreateParams::Model::TaggedSymbol)
           GPT_5_1_CHAT_LATEST = T.let(:"gpt-5.1-chat-latest", OpenAI::Beta::ResponseCreateParams::Model::TaggedSymbol)
           GPT_5 = T.let(:"gpt-5", OpenAI::Beta::ResponseCreateParams::Model::TaggedSymbol)
           GPT_5_MINI = T.let(:"gpt-5-mini", OpenAI::Beta::ResponseCreateParams::Model::TaggedSymbol)
@@ -1094,7 +1095,6 @@ module OpenAI
             :"gpt-3.5-turbo-16k-0613",
             OpenAI::Beta::ResponseCreateParams::Model::TaggedSymbol
           )
-          GPT_5_1_MINI = T.let(:"gpt-5.1-mini", OpenAI::Beta::ResponseCreateParams::Model::TaggedSymbol)
           O1_PRO = T.let(:"o1-pro", OpenAI::Beta::ResponseCreateParams::Model::TaggedSymbol)
           O1_PRO_2025_03_19 = T.let(:"o1-pro-2025-03-19", OpenAI::Beta::ResponseCreateParams::Model::TaggedSymbol)
           O3_PRO = T.let(:"o3-pro", OpenAI::Beta::ResponseCreateParams::Model::TaggedSymbol)

data/rbi/openai/models/chat/completion_create_params.rbi

@@ -188,8 +188,11 @@ module OpenAI
         sig { params(parallel_tool_calls: T::Boolean).void }
         attr_writer :parallel_tool_calls
 
-        # Static predicted output content, such as the content of a text file that is
-        # being regenerated.
+        # Configuration for a
+        # [Predicted Output](https://developers.openai.com/api/docs/guides/predicted-outputs),
+        # which can greatly improve response times when large parts of the model response
+        # are known ahead of time. This is most common when you are regenerating a file
+        # with only minor changes to most of the content.
         sig { returns(T.nilable(OpenAI::Chat::ChatCompletionPredictionContent)) }
         attr_reader :prediction
 
@@ -687,8 +690,11 @@ module OpenAI
           # during tool use.
           parallel_tool_calls: nil,
 
-          # Static predicted output content, such as the content of a text file that is
-          # being regenerated.
+          # Configuration for a
+          # [Predicted Output](https://developers.openai.com/api/docs/guides/predicted-outputs),
+          # which can greatly improve response times when large parts of the model response
+          # are known ahead of time. This is most common when you are regenerating a file
+          # with only minor changes to most of the content.
           prediction: nil,
 
           # Number between -2.0 and 2.0. Positive values penalize new tokens based on

data/rbi/openai/models/chat_model.rbi

@@ -29,6 +29,7 @@ module OpenAI
       GPT_5_1 = T.let(:"gpt-5.1", OpenAI::ChatModel::TaggedSymbol)
       GPT_5_1_2025_11_13 = T.let(:"gpt-5.1-2025-11-13", OpenAI::ChatModel::TaggedSymbol)
       GPT_5_1_CODEX = T.let(:"gpt-5.1-codex", OpenAI::ChatModel::TaggedSymbol)
+      GPT_5_1_MINI = T.let(:"gpt-5.1-mini", OpenAI::ChatModel::TaggedSymbol)
       GPT_5_1_CHAT_LATEST = T.let(:"gpt-5.1-chat-latest", OpenAI::ChatModel::TaggedSymbol)
       GPT_5 = T.let(:"gpt-5", OpenAI::ChatModel::TaggedSymbol)
       GPT_5_MINI = T.let(:"gpt-5-mini", OpenAI::ChatModel::TaggedSymbol)
@@ -100,7 +101,6 @@ module OpenAI
       GPT_3_5_TURBO_1106 = T.let(:"gpt-3.5-turbo-1106", OpenAI::ChatModel::TaggedSymbol)
       GPT_3_5_TURBO_0125 = T.let(:"gpt-3.5-turbo-0125", OpenAI::ChatModel::TaggedSymbol)
       GPT_3_5_TURBO_16K_0613 = T.let(:"gpt-3.5-turbo-16k-0613", OpenAI::ChatModel::TaggedSymbol)
-      GPT_5_1_MINI = T.let(:"gpt-5.1-mini", OpenAI::ChatModel::TaggedSymbol)
 
       sig { override.returns(T::Array[OpenAI::ChatModel::TaggedSymbol]) }
       def self.values

data/rbi/openai/models/conversations/conversation_update_params.rbi

@@ -22,10 +22,9 @@ module OpenAI
 
         # 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
-        # querying for objects via API or the dashboard.
-        #
-        # Keys are strings with a maximum length of 64 characters. Values are strings with
-        # a maximum length of 512 characters.
+        # querying for objects via API or the dashboard. Keys are strings with a maximum
+        # length of 64 characters. Values are strings with a maximum length of 512
+        # characters.
         sig { returns(T.nilable(T::Hash[Symbol, String])) }
         attr_accessor :metadata
 
@@ -46,10 +45,9 @@ module OpenAI
 
           # 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
-          # querying for objects via API or the dashboard.
-          #
-          # Keys are strings with a maximum length of 64 characters. Values are strings with
-          # a maximum length of 512 characters.
+          # querying for objects via API or the dashboard. Keys are strings with a maximum
+          # length of 64 characters. Values are strings with a maximum length of 512
+          # characters.
           metadata:,
 
           request_options: {}

data/rbi/openai/models/image_edit_params.rbi

@@ -50,10 +50,9 @@ module OpenAI
       sig { returns(T.nilable(OpenAI::ImageEditParams::Background::OrSymbol)) }
       attr_accessor :background
 
-      # Control how much effort the model will exert to match the style and features,
-      # especially facial features, of input images. This parameter is only supported
-      # for `gpt-image-1` and `gpt-image-1.5` and later models, unsupported for
-      # `gpt-image-1-mini`. Supports `high` and `low`. Defaults to `low`.
+      # Controls fidelity to the original input image(s). This parameter is supported
+      # for GPT image models that support input fidelity. `gpt-image-2` and
+      # `gpt-image-2-2026-04-21` ignore this parameter.
       sig { returns(T.nilable(OpenAI::ImageEditParams::InputFidelity::OrSymbol)) }
       attr_accessor :input_fidelity
 
@@ -212,10 +211,9 @@ module OpenAI
         # set the output format to `png` or `webp`.
         background: nil,
 
-        # Control how much effort the model will exert to match the style and features,
-        # especially facial features, of input images. This parameter is only supported
-        # for `gpt-image-1` and `gpt-image-1.5` and later models, unsupported for
-        # `gpt-image-1-mini`. Supports `high` and `low`. Defaults to `low`.
+        # Controls fidelity to the original input image(s). This parameter is supported
+        # for GPT image models that support input fidelity. `gpt-image-2` and
+        # `gpt-image-2-2026-04-21` ignore this parameter.
         input_fidelity: nil,
 
         # An additional image whose fully transparent areas (e.g. where alpha is zero)
@@ -367,10 +365,9 @@ module OpenAI
         end
       end
 
-      # Control how much effort the model will exert to match the style and features,
-      # especially facial features, of input images. This parameter is only supported
-      # for `gpt-image-1` and `gpt-image-1.5` and later models, unsupported for
-      # `gpt-image-1-mini`. Supports `high` and `low`. Defaults to `low`.
+      # Controls fidelity to the original input image(s). This parameter is supported
+      # for GPT image models that support input fidelity. `gpt-image-2` and
+      # `gpt-image-2-2026-04-21` ignore this parameter.
       module InputFidelity
         extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/realtime/conversation_item_create_event.rbi

@@ -63,8 +63,9 @@ module OpenAI
         # "history" of the conversation and to add new items mid-stream, but has the
         # current limitation that it cannot populate assistant audio messages.
         #
-        # If successful, the server will respond with a `conversation.item.created` event,
-        # otherwise an `error` event will be sent.
+        # If successful, the server will emit a `conversation.item.added` event and, when
+        # the item is finalized, a `conversation.item.done` event. Otherwise, an `error`
+        # event will be sent.
         sig do
           params(