openai 0.103.0 → 0.105.0

data/rbi/openai/resources/beta/agents/sessions.rbi

@@ -44,6 +44,7 @@ module OpenAI
               agent_id: String,
               input: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Input::Variants),
               metadata: T.nilable(T::Hash[Symbol, String]),
+              spend_control: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl::OrHash),
               vault_ids: T.nilable(T::Array[String]),
               stream: T.noreturn,
               request_options: OpenAI::RequestOptions::OrHash
@@ -67,6 +68,9 @@ module OpenAI
             # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
             # characters. Omission or null defaults to an empty map.
             metadata: nil,
+            # Optional spending limit in USD cents. Omission or null creates an unlimited
+            # session.
+            spend_control: nil,
             # The IDs of vaults made available to the session.
             vault_ids: nil,
             # There is no need to provide `stream:`. Instead, use `#create_streaming` or
@@ -95,6 +99,7 @@ module OpenAI
               output_type: T.nilable(T.class_of(OpenAI::Helpers::StructuredOutput::BaseModel)),
               input: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Input::Variants),
               metadata: T.nilable(T::Hash[Symbol, String]),
+              spend_control: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::SpendControl::OrHash),
               vault_ids: T.nilable(T::Array[String]),
               stream: T.noreturn,
               request_options: OpenAI::RequestOptions::OrHash
@@ -120,6 +125,9 @@ module OpenAI
             # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
             # characters. Omission or null defaults to an empty map.
             metadata: nil,
+            # Optional spending limit in USD cents. Omission or null creates an unlimited
+            # session.
+            spend_control: nil,
             # The IDs of vaults made available to the session.
             vault_ids: nil,
             # There is no need to provide `stream:`. Instead, use `#create_streaming` or
@@ -151,6 +159,7 @@ module OpenAI
               session_id: String,
               agent: OpenAI::Beta::Agents::SessionUpdateParams::Agent::OrHash,
               metadata: T.nilable(T::Hash[Symbol, String]),
+              spend_control: T.nilable(OpenAI::Beta::Agents::SessionUpdateParams::SpendControl::OrHash),
               request_options: OpenAI::RequestOptions::OrHash
             )
               .returns(OpenAI::Beta::AgentSession)
@@ -164,6 +173,9 @@ module OpenAI
             # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
             # characters.
             metadata: nil,
+            # Omit to retain the limit; null or a null limit removes it without resetting
+            # spend.
+            spend_control: nil,
             request_options: {}
           )
           end
@@ -175,7 +187,7 @@ module OpenAI
             params(
               after: String,
               agent_id: String,
-              limit: T.nilable(Integer),
+              limit: Integer,
               order: OpenAI::Beta::Agents::SessionListParams::Order::OrSymbol,
               request_options: OpenAI::RequestOptions::OrHash
             )
@@ -187,10 +199,9 @@ module OpenAI
             # Only return sessions whose root agent has this ID. Omit to return sessions for
             # all agents.
             agent_id: nil,
-            # The maximum number of resources to return.
+            # The maximum number of resources to return, between 1 and 100. Defaults to 20.
             limit: nil,
-            # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-            # `desc` for descending order. Defaults to `desc`.
+            # The order in which resources are returned. Defaults to `desc`.
             order: nil,
             request_options: {}
           )

data/rbi/openai/resources/beta/agents/vaults/credentials.rbi

@@ -98,7 +98,8 @@ module OpenAI
               params(
                 vault_id: String,
                 after: String,
-                limit: T.nilable(Integer),
+                limit: Integer,
+                metadata: T::Hash[Symbol, String],
                 order: OpenAI::Beta::Agents::Vaults::CredentialListParams::Order::OrSymbol,
                 status: T.any(
                   OpenAI::Beta::Agents::VaultStatus::OrSymbol,
@@ -113,11 +114,14 @@ module OpenAI
               vault_id,
               # Return resources after this resource ID in the selected order.
               after: nil,
-              # The maximum number of resources to return. Defaults to 20. Values are clamped
-              # between 1 and 100.
+              # The maximum number of resources to return, between 1 and 100. Defaults to 20.
               limit: nil,
-              # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-              # `desc` for descending order. Defaults to `desc`.
+              # Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+              # match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+              # characters. Filtering is eventually consistent; metadata changes may take time
+              # to appear.
+              metadata: nil,
+              # The order in which resources are returned. Defaults to `desc`.
               order: nil,
               # Filter by one status or a list, such as `status=active` or
               # `status[]=active&status[]=archived`. Both statuses are included by default.

data/rbi/openai/resources/beta/agents/vaults.rbi

@@ -47,12 +47,38 @@ module OpenAI
           )
           end
 
+          # Updates the name or metadata of an active vault. Omitted fields remain
+          # unchanged. See
+          # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
+          sig {
+            params(
+              vault_id: String,
+              metadata: T::Hash[Symbol, String],
+              name: T.nilable(String),
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(OpenAI::Beta::Agents::Vault)
+          }
+          def update(
+            # The ID of the vault.
+            vault_id,
+            # Replaces all metadata. Omit to leave unchanged, or pass {} to clear it. Up to 16
+            # string key-value pairs, with keys up to 64 and values up to 512 characters.
+            metadata: nil,
+            # A replacement name. Omit to leave unchanged, or pass null to clear it. The name
+            # is trimmed before storage. It must contain 1 to 256 UTF-8 bytes after trimming.
+            name: nil,
+            request_options: {}
+          )
+          end
+
           # Lists vaults using ID-based pagination. See
           # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
           sig {
             params(
               after: String,
-              limit: T.nilable(Integer),
+              limit: Integer,
+              metadata: T::Hash[Symbol, String],
               order: OpenAI::Beta::Agents::VaultListParams::Order::OrSymbol,
               status: T.any(
                 OpenAI::Beta::Agents::VaultStatus::OrSymbol,
@@ -65,11 +91,14 @@ module OpenAI
           def list(
             # Return resources after this resource ID in the selected order.
             after: nil,
-            # The maximum number of resources to return. Defaults to 20. Values are clamped
-            # between 1 and 100.
+            # The maximum number of resources to return, between 1 and 100. Defaults to 20.
             limit: nil,
-            # Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-            # `desc` for descending order. Defaults to `desc`.
+            # Exact string matches supplied as `metadata[key]=value`. All supplied pairs must
+            # match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512
+            # characters. Filtering is eventually consistent; metadata changes may take time
+            # to appear.
+            metadata: nil,
+            # The order in which resources are returned. Defaults to `desc`.
             order: nil,
             # Filter by one status or a list, such as `status=active` or
             # `status[]=active&status[]=archived`. Both statuses are included by default.

data/rbi/openai/resources/beta/agents.rbi

@@ -65,7 +65,8 @@ module OpenAI
           # Configuration for generated text. Defaults to the `text` format and medium
           # verbosity.
           text: nil,
-          # Tools available to the agent. Defaults to an empty list.
+          # Tools available to the agent. Defaults to an empty list. The tool list must fit
+          # within 3 MiB (3,145,728 bytes) of compact UTF-8 JSON.
           tools: nil,
           request_options: {}
         )
@@ -133,7 +134,8 @@ module OpenAI
           service_tier: nil,
           # Configuration for text generated by the agent.
           text: nil,
-          # Tools available to the agent.
+          # Replaces the tool list. Omit to leave it unchanged, or pass null to clear it.
+          # The replacement must fit within 3 MiB (3,145,728 bytes) of compact UTF-8 JSON.
           tools: nil,
           request_options: {}
         )
@@ -144,7 +146,7 @@ module OpenAI
         sig {
           params(
             after: String,
-            limit: T.nilable(Integer),
+            limit: Integer,
             order: OpenAI::Beta::AgentListParams::Order::OrSymbol,
             request_options: OpenAI::RequestOptions::OrHash
           )
@@ -153,7 +155,7 @@ module OpenAI
         def list(
           # Return resources after this resource ID in the selected order.
           after: nil,
-          # The maximum number of resources to return.
+          # The maximum number of resources to return, between 1 and 100. Defaults to 20.
           limit: nil,
           # The order in which resources are returned. Defaults to `desc`.
           order: nil,

data/rbi/openai/resources/beta/responses.rbi

@@ -222,7 +222,7 @@ module OpenAI
           reasoning: nil,
           # Body param: A stable identifier used to help detect users of your application
           # that may be violating OpenAI's usage policies. The IDs should be a string that
-          # uniquely identifies each user, with a maximum length of 64 characters. We
+          # uniquely identifies each user, with a maximum length of 128 characters. We
           # recommend hashing their username or email address, in order to avoid sending us
           # any identifying information.
           # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
@@ -544,7 +544,7 @@ module OpenAI
           reasoning: nil,
           # Body param: A stable identifier used to help detect users of your application
           # that may be violating OpenAI's usage policies. The IDs should be a string that
-          # uniquely identifies each user, with a maximum length of 64 characters. We
+          # uniquely identifies each user, with a maximum length of 128 characters. We
           # recommend hashing their username or email address, in order to avoid sending us
           # any identifying information.
           # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).

data/rbi/openai/resources/chat/completions.rbi

@@ -36,7 +36,7 @@ module OpenAI
         #
         # Returns a chat completion object, or a streamed sequence of chat completion
         # chunk objects if the request is streamed.
-        sig do
+        sig {
           params(
             messages: T::Array[
               T.any(
@@ -72,10 +72,12 @@ module OpenAI
             prompt_cache_retention: T.nilable(OpenAI::Chat::CompletionCreateParams::PromptCacheRetention::OrSymbol),
             reasoning_effort: T.nilable(OpenAI::ReasoningEffort::OrSymbol),
             response_format: T.any(
-              OpenAI::ResponseFormatText::OrHash,
-              OpenAI::ResponseFormatJSONSchema::OrHash,
-              OpenAI::StructuredOutput::JsonSchemaConverter,
-              OpenAI::ResponseFormatJSONObject::OrHash
+              T.any(
+                OpenAI::ResponseFormatText::OrHash,
+                OpenAI::ResponseFormatJSONSchema::OrHash,
+                OpenAI::ResponseFormatJSONObject::OrHash
+              ),
+              OpenAI::StructuredOutput::JsonSchemaConverter
             ),
             safety_identifier: T.nilable(String),
             seed: T.nilable(Integer),
@@ -92,9 +94,8 @@ module OpenAI
             ),
             tools: T::Array[
               T.any(
-                OpenAI::StructuredOutput::JsonSchemaConverter,
-                OpenAI::Chat::ChatCompletionFunctionTool::OrHash,
-                OpenAI::Chat::ChatCompletionCustomTool::OrHash
+                T.any(OpenAI::Chat::ChatCompletionFunctionTool::OrHash, OpenAI::Chat::ChatCompletionCustomTool::OrHash),
+                OpenAI::StructuredOutput::JsonSchemaConverter
               )
             ],
             top_logprobs: T.nilable(Integer),
@@ -106,7 +107,7 @@ module OpenAI
             request_options: OpenAI::RequestOptions::OrHash
           )
             .returns(OpenAI::Chat::ChatCompletion)
-        end
+        }
         def create(
           # A list of messages comprising the conversation so far. Depending on the
           # [model](https://developers.openai.com/api/docs/models) you use, different
@@ -263,7 +264,7 @@ module OpenAI
           response_format: nil,
           # A stable identifier used to help detect users of your application that may be
           # violating OpenAI's usage policies. The IDs should be a string that uniquely
-          # identifies each user, with a maximum length of 64 characters. We recommend
+          # identifies each user, with a maximum length of 128 characters. We recommend
           # hashing their username or email address, in order to avoid sending us any
           # identifying information.
           # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
@@ -386,7 +387,7 @@ module OpenAI
         #
         # Returns a chat completion object, or a streamed sequence of chat completion
         # chunk objects if the request is streamed.
-        sig do
+        sig {
           params(
             messages: T::Array[
               T.any(
@@ -451,7 +452,7 @@ module OpenAI
             request_options: OpenAI::RequestOptions::OrHash
           )
             .returns(OpenAI::Internal::Stream[OpenAI::Chat::ChatCompletionChunk])
-        end
+        }
         def stream_raw(
           # A list of messages comprising the conversation so far. Depending on the
           # [model](https://developers.openai.com/api/docs/models) you use, different
@@ -608,7 +609,7 @@ module OpenAI
           response_format: nil,
           # A stable identifier used to help detect users of your application that may be
           # violating OpenAI's usage policies. The IDs should be a string that uniquely
-          # identifies each user, with a maximum length of 64 characters. We recommend
+          # identifies each user, with a maximum length of 128 characters. We recommend
           # hashing their username or email address, in order to avoid sending us any
           # identifying information.
           # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
@@ -711,13 +712,11 @@ module OpenAI
 
         # Get a stored chat completion. Only Chat Completions that have been created with
         # the `store` parameter set to `true` will be returned.
-        sig do
-          params(
-            completion_id: String,
-            request_options: OpenAI::RequestOptions::OrHash
+        sig {
+          params(completion_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+            OpenAI::Chat::ChatCompletion
           )
-            .returns(OpenAI::Chat::ChatCompletion)
-        end
+        }
         def retrieve(
           # The ID of the chat completion to retrieve.
           completion_id,
@@ -728,14 +727,14 @@ module OpenAI
         # Modify a stored chat completion. Only Chat Completions that have been created
         # with the `store` parameter set to `true` can be modified. Currently, the only
         # supported modification is to update the `metadata` field.
-        sig do
+        sig {
           params(
             completion_id: String,
             metadata: T.nilable(T::Hash[Symbol, String]),
             request_options: OpenAI::RequestOptions::OrHash
           )
             .returns(OpenAI::Chat::ChatCompletion)
-        end
+        }
         def update(
           # The ID of the chat completion to update.
           completion_id,
@@ -752,7 +751,7 @@ module OpenAI
 
         # List stored Chat Completions. Only Chat Completions that have been stored with
         # the `store` parameter set to `true` will be returned.
-        sig do
+        sig {
           params(
             after: String,
             limit: Integer,
@@ -762,7 +761,7 @@ module OpenAI
             request_options: OpenAI::RequestOptions::OrHash
           )
             .returns(OpenAI::Internal::CursorPage[OpenAI::Chat::ChatCompletion])
-        end
+        }
         def list(
           # Identifier for the last chat completion from the previous pagination request.
           after: nil,
@@ -783,13 +782,11 @@ module OpenAI
 
         # Delete a stored chat completion. Only Chat Completions that have been created
         # with the `store` parameter set to `true` can be deleted.
-        sig do
-          params(
-            completion_id: String,
-            request_options: OpenAI::RequestOptions::OrHash
+        sig {
+          params(completion_id: String, request_options: OpenAI::RequestOptions::OrHash).returns(
+            OpenAI::Chat::ChatCompletionDeleted
           )
-            .returns(OpenAI::Chat::ChatCompletionDeleted)
-        end
+        }
         def delete(
           # The ID of the chat completion to delete.
           completion_id,

data/rbi/openai/resources/decisions.rbi

@@ -5,17 +5,8 @@ module OpenAI
 
     class Decisions
 
-      # Evaluate ordered classification and scoring questions against shared input.
-      # Answers are returned in question order.
-      #
-      # Supply input as a string or user messages containing text and inline images.
-      # Only user messages with `input_text` and `input_image` parts are supported;
-      # non-user roles, function calls, files, audio, and item references are not
-      # supported. Images require a data URL, not an external URL or file ID. At most
-      # 128 images are allowed across the request.
-      #
-      # Each question can return a refusal instead of a scored answer. A refusal has
-      # type `refusal` and the corresponding question name, or null if unnamed.
+      # Use this endpoint to quickly answer classification or scoring questions about
+      # some input. You can ask multiple questions in one request.
       sig {
         params(
           input: OpenAI::DecisionCreateParams::Input::Variants,
@@ -33,12 +24,15 @@ module OpenAI
           .returns(OpenAI::Decision)
       }
       def create(
-        # Shared evidence, as a string or an array of user messages containing text and
-        # inline images. Non-user roles, function calls, function-call outputs, files,
-        # audio, and item references are not supported. At most 128 image parts are
-        # allowed across all messages in one request.
+        # The text or images to evaluate for every question. Provide a text string or user
+        # messages containing text and images. Images can be base64 data URLs or publicly
+        # accessible HTTP(S) URLs; at most 128 images are allowed across all messages in
+        # one request. Files, audio, tools, and item references are not supported.
         input:,
+        # The model to use. Only `gpt-6-luna` is supported.
         model:,
+        # Ask 1–200 questions about the input. Each question can be a predicate, choice,
+        # or score. Answers come back in the same order.
         questions:,
         # Opaque caller-provided end-user identifier, scoped by the verified org. Match
         # Responses' limit; this is never the authenticated user identity.

data/rbi/openai/resources/files.rbi

@@ -126,24 +126,6 @@ module OpenAI
       )
       end
 
-      # Wait for an uploaded file to finish processing.
-      sig do
-        params(
-          file_id: String,
-          poll_interval: T.nilable(T.any(Integer, Float)),
-          timeout: T.nilable(T.any(Integer, Float)),
-          request_options: OpenAI::RequestOptions::OrHash
-        )
-          .returns(OpenAI::FileObject)
-      end
-      def wait_for_processing(
-        file_id,
-        poll_interval: nil,
-        timeout: OpenAI::Internal::Poller::DEFAULT_TIMEOUT,
-        request_options: {}
-      )
-      end
-
       # @api private
       sig { params(client: OpenAI::Client).returns(T.attached_class) }
       def self.new(client:)

data/rbi/openai/resources/images.rbi

@@ -67,6 +67,7 @@ module OpenAI
           partial_images: T.nilable(Integer),
           quality: T.nilable(OpenAI::ImageEditParams::Quality::OrSymbol),
           response_format: T.nilable(OpenAI::ImageEditParams::ResponseFormat::OrSymbol),
+          safety_identifier: T.nilable(String),
           size: T.nilable(T.any(String, OpenAI::ImageEditParams::Size::OrSymbol)),
           user: String,
           stream: T.noreturn,
@@ -146,6 +147,13 @@ module OpenAI
         # Legacy response format parameter for retired image models. Unsupported for GPT
         # image models, which always return base64-encoded images.
         response_format: nil,
+        # A stable identifier for an end user in your organization, used for safety
+        # monitoring and abuse detection. Hash a username or email address to avoid
+        # sending identifying information. A non-empty value takes precedence over the
+        # deprecated `user` parameter. If omitted, null, or empty, the API uses `user`
+        # when available.
+        # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
+        safety_identifier: nil,
         # The size of the generated images. Defaults to `auto`. For `gpt-image-2`,
         # `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
         # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`, and
@@ -158,8 +166,9 @@ module OpenAI
         # `1024x1536` are supported by the GPT image models; `auto` is supported for
         # models that allow automatic sizing.
         size: nil,
-        # A unique identifier representing your end-user, which can help OpenAI to monitor
-        # and detect abuse.
+        # Deprecated: use `safety_identifier` instead. This parameter remains accepted for
+        # backward compatibility and is used when `safety_identifier` is omitted, null, or
+        # empty.
         # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
         user: nil,
         # There is no need to provide `stream:`. Instead, use `#edit_stream_raw` or
@@ -187,6 +196,7 @@ module OpenAI
           partial_images: T.nilable(Integer),
           quality: T.nilable(OpenAI::ImageEditParams::Quality::OrSymbol),
           response_format: T.nilable(OpenAI::ImageEditParams::ResponseFormat::OrSymbol),
+          safety_identifier: T.nilable(String),
           size: T.nilable(T.any(String, OpenAI::ImageEditParams::Size::OrSymbol)),
           user: String,
           stream: T.noreturn,
@@ -266,6 +276,13 @@ module OpenAI
         # Legacy response format parameter for retired image models. Unsupported for GPT
         # image models, which always return base64-encoded images.
         response_format: nil,
+        # A stable identifier for an end user in your organization, used for safety
+        # monitoring and abuse detection. Hash a username or email address to avoid
+        # sending identifying information. A non-empty value takes precedence over the
+        # deprecated `user` parameter. If omitted, null, or empty, the API uses `user`
+        # when available.
+        # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
+        safety_identifier: nil,
         # The size of the generated images. Defaults to `auto`. For `gpt-image-2`,
         # `gpt-image-2-2026-04-21`, `gpt-image-2.5-sunburst`,
         # `gpt-image-2.5-sunburst-2026-09-08`, `gpt-image-2.5-flare`, and
@@ -278,8 +295,9 @@ module OpenAI
         # `1024x1536` are supported by the GPT image models; `auto` is supported for
         # models that allow automatic sizing.
         size: nil,
-        # A unique identifier representing your end-user, which can help OpenAI to monitor
-        # and detect abuse.
+        # Deprecated: use `safety_identifier` instead. This parameter remains accepted for
+        # backward compatibility and is used when `safety_identifier` is omitted, null, or
+        # empty.
         # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
         user: nil,
         # There is no need to provide `stream:`. Instead, use `#edit_stream_raw` or
@@ -305,6 +323,7 @@ module OpenAI
           partial_images: T.nilable(Integer),
           quality: T.nilable(OpenAI::ImageGenerateParams::Quality::OrSymbol),
           response_format: T.nilable(OpenAI::ImageGenerateParams::ResponseFormat::OrSymbol),
+          safety_identifier: T.nilable(String),
           size: T.nilable(T.any(String, OpenAI::ImageGenerateParams::Size::OrSymbol)),
           style: T.nilable(OpenAI::ImageGenerateParams::Style::OrSymbol),
           user: String,
@@ -364,6 +383,13 @@ module OpenAI
         # Legacy response format parameter for retired image models. Unsupported for GPT
         # image models, which always return base64-encoded images.
         response_format: nil,
+        # A stable identifier for an end user in your organization, used for safety
+        # monitoring and abuse detection. Hash a username or email address to avoid
+        # sending identifying information. A non-empty value takes precedence over the
+        # deprecated `user` parameter. If omitted, null, or empty, the API uses `user`
+        # when available.
+        # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
+        safety_identifier: nil,
         # The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
         # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
         # `gpt-image-2.5-flare`, and `gpt-image-2.5-flare-2026-09-08`, arbitrary
@@ -378,8 +404,9 @@ module OpenAI
         # Legacy style parameter for retired image models. Unsupported for GPT image
         # models; describe the desired style in the prompt instead.
         style: nil,
-        # A unique identifier representing your end-user, which can help OpenAI to monitor
-        # and detect abuse.
+        # Deprecated: use `safety_identifier` instead. This parameter remains accepted for
+        # backward compatibility and is used when `safety_identifier` is omitted, null, or
+        # empty.
         # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
         user: nil,
         # There is no need to provide `stream:`. Instead, use `#generate_stream_raw` or
@@ -405,6 +432,7 @@ module OpenAI
           partial_images: T.nilable(Integer),
           quality: T.nilable(OpenAI::ImageGenerateParams::Quality::OrSymbol),
           response_format: T.nilable(OpenAI::ImageGenerateParams::ResponseFormat::OrSymbol),
+          safety_identifier: T.nilable(String),
           size: T.nilable(T.any(String, OpenAI::ImageGenerateParams::Size::OrSymbol)),
           style: T.nilable(OpenAI::ImageGenerateParams::Style::OrSymbol),
           user: String,
@@ -464,6 +492,13 @@ module OpenAI
         # Legacy response format parameter for retired image models. Unsupported for GPT
         # image models, which always return base64-encoded images.
         response_format: nil,
+        # A stable identifier for an end user in your organization, used for safety
+        # monitoring and abuse detection. Hash a username or email address to avoid
+        # sending identifying information. A non-empty value takes precedence over the
+        # deprecated `user` parameter. If omitted, null, or empty, the API uses `user`
+        # when available.
+        # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
+        safety_identifier: nil,
         # The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
         # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
         # `gpt-image-2.5-flare`, and `gpt-image-2.5-flare-2026-09-08`, arbitrary
@@ -478,8 +513,9 @@ module OpenAI
         # Legacy style parameter for retired image models. Unsupported for GPT image
         # models; describe the desired style in the prompt instead.
         style: nil,
-        # A unique identifier representing your end-user, which can help OpenAI to monitor
-        # and detect abuse.
+        # Deprecated: use `safety_identifier` instead. This parameter remains accepted for
+        # backward compatibility and is used when `safety_identifier` is omitted, null, or
+        # empty.
         # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
         user: nil,
         # There is no need to provide `stream:`. Instead, use `#generate_stream_raw` or

data/rbi/openai/resources/live/forks.rbi

@@ -7,6 +7,23 @@ module OpenAI
 
       class Forks
 
+        include OpenAI::WebSocket::Resource
+
+        # @api private
+        sig { params(session_id: String, query: T::Hash[T.untyped, T.untyped]).returns(T::Hash[Symbol, T.untyped]) }
+        def __websocket_request(session_id, query: {})
+        end
+
+        # @api private
+        sig { returns(T.untyped) }
+        def __websocket_client_event
+        end
+
+        # @api private
+        sig { returns(T.untyped) }
+        def __websocket_server_event
+        end
+
         # @api private
         sig { params(client: OpenAI::Client).returns(T.attached_class) }
         def self.new(client:)

data/rbi/openai/resources/live/sideband.rbi

@@ -7,6 +7,23 @@ module OpenAI
 
       class Sideband
 
+        include OpenAI::WebSocket::Resource
+
+        # @api private
+        sig { params(session_id: String, query: T::Hash[T.untyped, T.untyped]).returns(T::Hash[Symbol, T.untyped]) }
+        def __websocket_request(session_id, query: {})
+        end
+
+        # @api private
+        sig { returns(T.untyped) }
+        def __websocket_client_event
+        end
+
+        # @api private
+        sig { returns(T.untyped) }
+        def __websocket_server_event
+        end
+
         # @api private
         sig { params(client: OpenAI::Client).returns(T.attached_class) }
         def self.new(client:)

data/rbi/openai/resources/live.rbi

@@ -5,6 +5,23 @@ module OpenAI
 
     class Live
 
+      include OpenAI::WebSocket::Resource
+
+      # @api private
+      sig { params(query: T::Hash[T.untyped, T.untyped]).returns(T::Hash[Symbol, T.untyped]) }
+      def __websocket_request(query: {})
+      end
+
+      # @api private
+      sig { returns(T.untyped) }
+      def __websocket_client_event
+      end
+
+      # @api private
+      sig { returns(T.untyped) }
+      def __websocket_server_event
+      end
+
       sig { returns(OpenAI::Resources::Live::Sideband) }
       attr_reader :sideband