openai 0.103.0 → 0.105.0

data/lib/openai/resources/beta/responses.rb

@@ -173,7 +173,7 @@ module OpenAI
         # @param safety_identifier [String, 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).
@@ -474,7 +474,7 @@ module OpenAI
         # @param safety_identifier [String, 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/lib/openai/resources/chat/completions.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative "../../helpers/streaming/chat_completion_resource"
 require_relative "../../helpers/structured_output/chat_completion_parser"
 
 module OpenAI
@@ -216,7 +217,7 @@ module OpenAI
         # @param safety_identifier [String, 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).
@@ -350,41 +351,6 @@ module OpenAI
           )
         end
 
-        def get_structured_output_models(parsed)
-          OpenAI::Helpers::StructuredOutput::ChatCompletionParser.get_models(parsed)
-        end
-
-        def build_tools_with_models(tools, tool_models)
-          OpenAI::Helpers::StructuredOutput::ChatCompletionParser.build_tools(tools, tool_models)
-        end
-
-        def stream(params)
-          parsed, options = OpenAI::Chat::CompletionCreateParams.dump_request(params)
-
-          parsed.store(:stream, true)
-
-          response_format, tool_models = get_structured_output_models(parsed)
-
-          input_tools = build_tools_with_models(parsed[:tools], tool_models)
-
-          raw_stream = @client.request(
-            method: :post,
-            path: "chat/completions",
-            headers: {"accept" => "text/event-stream"},
-            body: parsed,
-            stream: OpenAI::Internal::Stream,
-            model: OpenAI::Chat::ChatCompletionChunk,
-            security: {bearer_auth: true},
-            options: options
-          )
-
-          OpenAI::Helpers::Streaming::ChatCompletionStream.new(
-            raw_stream: raw_stream,
-            response_format: response_format,
-            input_tools: input_tools
-          )
-        end
-
         # See {OpenAI::Resources::Chat::Completions#create} for non-streaming counterpart.
         #
         # **Starting a new project?** We recommend trying
@@ -588,7 +554,7 @@ module OpenAI
         # @param safety_identifier [String, 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).
@@ -842,6 +808,14 @@ module OpenAI
           )
         end
 
+        def get_structured_output_models(parsed)
+          OpenAI::Helpers::StructuredOutput::ChatCompletionParser.get_models(parsed)
+        end
+
+        def build_tools_with_models(tools, tool_models)
+          OpenAI::Helpers::StructuredOutput::ChatCompletionParser.build_tools(tools, tool_models)
+        end
+
         # @api private
         #
         # @param client [OpenAI::Client]

data/lib/openai/resources/decisions.rb

@@ -3,29 +3,23 @@
 module OpenAI
   module Resources
     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.
       #
       # @overload create(input:, model:, questions:, safety_identifier: nil, request_options: {})
       #
       # @param input [String, Array<OpenAI::Models::DecisionInputMessage>]
-      #   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.
       #
       # @param model [String]
+      #   The model to use. Only `gpt-6-luna` is supported.
       #
       # @param questions [Array<OpenAI::Models::DecisionCreateParams::Question::Predicate, OpenAI::Models::DecisionCreateParams::Question::Choice, OpenAI::Models::DecisionCreateParams::Question::Score>]
+      #   Ask 1–200 questions about the input. Each question can be a predicate, choice,
+      #   or score. Answers come back in the same order.
       #
       # @param safety_identifier [String, nil]
       #   Opaque caller-provided end-user identifier, scoped by the verified org. Match

data/lib/openai/resources/files.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative "../helpers/resource_polling"
-
 module OpenAI
   module Resources
     # Files are used to upload documents that can be used with features like
@@ -187,43 +185,6 @@ module OpenAI
         )
       end
 
-      # Wait for an uploaded file to finish processing.
-      #
-      # The returned file may have an `error` status; callers should inspect the
-      # status before using it. Polling intervals and the overall timeout are in
-      # seconds. Finite timeouts include authentication and request replay time and
-      # disable transport retries so the deadline remains strict. Set `timeout` to
-      # `nil` to wait indefinitely and retain configured transport retries.
-      #
-      # @overload wait_for_processing(file_id, poll_interval: nil, timeout: 1800.0, request_options: {})
-      #
-      # @param file_id [String] The ID of the file to wait for.
-      #
-      # @param poll_interval [Integer, Float, nil] How often to retrieve the file. When omitted, the SDK honors the server's
-      #   polling hint and otherwise waits 5 seconds.
-      #
-      # @param timeout [Integer, Float, nil] Maximum total time to poll. Defaults to 30 minutes. Set to `nil` to wait
-      #   indefinitely.
-      #
-      # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @raise [ArgumentError, OpenAI::Errors::PollingError]
-      # @return [OpenAI::Models::FileObject]
-      def wait_for_processing(
-        file_id,
-        poll_interval: nil,
-        timeout: OpenAI::Internal::Poller::DEFAULT_TIMEOUT,
-        request_options: {}
-      )
-        OpenAI::Helpers::ResourcePolling.wait_for_file(
-          self,
-          file_id,
-          poll_interval: poll_interval,
-          timeout: timeout,
-          request_options: request_options
-        )
-      end
-
       # @api private
       #
       # @param client [OpenAI::Client]

data/lib/openai/resources/images.rb

@@ -72,7 +72,7 @@ module OpenAI
       # metadata. Use `OpenAI::FilePart` when you need to override the filename or
       # content type.
       #
-      # @overload edit(image:, prompt:, background: nil, input_fidelity: nil, mask: nil, model: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, size: nil, user: nil, request_options: {})
+      # @overload edit(image:, prompt:, background: nil, input_fidelity: nil, mask: nil, model: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, safety_identifier: nil, size: nil, user: nil, request_options: {})
       #
       # @param image [Pathname, StringIO, IO, String, OpenAI::FilePart, Array<Pathname, StringIO, IO, String, OpenAI::FilePart>]
       #   The image(s) to edit. Must be a supported image file or an array of images.
@@ -157,6 +157,14 @@ module OpenAI
       #   Legacy response format parameter for retired image models. Unsupported for GPT
       #   image models, which always return base64-encoded images.
       #
+      # @param safety_identifier [String, 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).
+      #
       # @param size [String, Symbol, OpenAI::Models::ImageEditParams::Size, 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`,
@@ -171,8 +179,9 @@ module OpenAI
       #   models that allow automatic sizing.
       #
       # @param user [String]
-      #   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).
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -187,6 +196,7 @@ module OpenAI
           raise ArgumentError.new(message)
         end
 
+        parsed.delete(:safety_identifier) if parsed[:safety_identifier].nil?
         @client.request(
           method: :post,
           path: "images/edits",
@@ -207,7 +217,7 @@ module OpenAI
       # metadata. Use `OpenAI::FilePart` when you need to override the filename or
       # content type.
       #
-      # @overload edit_stream_raw(image:, prompt:, background: nil, input_fidelity: nil, mask: nil, model: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, size: nil, user: nil, request_options: {})
+      # @overload edit_stream_raw(image:, prompt:, background: nil, input_fidelity: nil, mask: nil, model: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, safety_identifier: nil, size: nil, user: nil, request_options: {})
       #
       # @param image [Pathname, StringIO, IO, String, OpenAI::FilePart, Array<Pathname, StringIO, IO, String, OpenAI::FilePart>]
       #   The image(s) to edit. Must be a supported image file or an array of images.
@@ -292,6 +302,14 @@ module OpenAI
       #   Legacy response format parameter for retired image models. Unsupported for GPT
       #   image models, which always return base64-encoded images.
       #
+      # @param safety_identifier [String, 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).
+      #
       # @param size [String, Symbol, OpenAI::Models::ImageEditParams::Size, 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`,
@@ -306,8 +324,9 @@ module OpenAI
       #   models that allow automatic sizing.
       #
       # @param user [String]
-      #   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).
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -323,6 +342,7 @@ module OpenAI
         end
 
         parsed.store(:stream, true)
+        parsed.delete(:safety_identifier) if parsed[:safety_identifier].nil?
         @client.request(
           method: :post,
           path: "images/edits",
@@ -344,7 +364,7 @@ module OpenAI
       # Creates an image given a prompt using a GPT Image model.
       # [Learn more](https://developers.openai.com/api/docs/guides/images-vision).
       #
-      # @overload generate(prompt:, background: nil, model: nil, moderation: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, size: nil, style: nil, user: nil, request_options: {})
+      # @overload generate(prompt:, background: nil, model: nil, moderation: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, safety_identifier: nil, size: nil, style: nil, user: nil, request_options: {})
       #
       # @param prompt [String]
       #   A text description of the desired image(s). The maximum length is 32000
@@ -406,6 +426,14 @@ module OpenAI
       #   Legacy response format parameter for retired image models. Unsupported for GPT
       #   image models, which always return base64-encoded images.
       #
+      # @param safety_identifier [String, 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).
+      #
       # @param size [String, Symbol, OpenAI::Models::ImageGenerateParams::Size, 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`,
@@ -423,8 +451,9 @@ module OpenAI
       #   models; describe the desired style in the prompt instead.
       #
       # @param user [String]
-      #   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).
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -454,7 +483,7 @@ module OpenAI
       # Creates an image given a prompt using a GPT Image model.
       # [Learn more](https://developers.openai.com/api/docs/guides/images-vision).
       #
-      # @overload generate_stream_raw(prompt:, background: nil, model: nil, moderation: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, size: nil, style: nil, user: nil, request_options: {})
+      # @overload generate_stream_raw(prompt:, background: nil, model: nil, moderation: nil, n: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, response_format: nil, safety_identifier: nil, size: nil, style: nil, user: nil, request_options: {})
       #
       # @param prompt [String]
       #   A text description of the desired image(s). The maximum length is 32000
@@ -516,6 +545,14 @@ module OpenAI
       #   Legacy response format parameter for retired image models. Unsupported for GPT
       #   image models, which always return base64-encoded images.
       #
+      # @param safety_identifier [String, 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).
+      #
       # @param size [String, Symbol, OpenAI::Models::ImageGenerateParams::Size, 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`,
@@ -533,8 +570,9 @@ module OpenAI
       #   models; describe the desired style in the prompt instead.
       #
       # @param user [String]
-      #   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).
       #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/openai/resources/live/forks.rb

@@ -1,9 +1,28 @@
 # frozen_string_literal: true
 
+require_relative "../../helpers/websocket/resource"
+
 module OpenAI
   module Resources
     class Live
       class Forks
+        include OpenAI::WebSocket::Resource
+
+        # @api private
+        def __websocket_request(session_id, query: {})
+          {method: :get, path: ["live/sessions/%1$s/fork", session_id], query: query, security: {bearer_auth: true}}
+        end
+
+        # @api private
+        def __websocket_client_event
+          OpenAI::Models::Live::ForkClientEvent
+        end
+
+        # @api private
+        def __websocket_server_event
+          OpenAI::Models::Live::ForkServerEvent
+        end
+
         # @api private
         #
         # @param client [OpenAI::Client]

data/lib/openai/resources/live/sideband.rb

@@ -1,9 +1,28 @@
 # frozen_string_literal: true
 
+require_relative "../../helpers/websocket/resource"
+
 module OpenAI
   module Resources
     class Live
       class Sideband
+        include OpenAI::WebSocket::Resource
+
+        # @api private
+        def __websocket_request(session_id, query: {})
+          {method: :get, path: ["live/sessions/%1$s/attach", session_id], query: query, security: {bearer_auth: true}}
+        end
+
+        # @api private
+        def __websocket_client_event
+          OpenAI::Models::Live::SidebandClientEvent
+        end
+
+        # @api private
+        def __websocket_server_event
+          OpenAI::Models::Live::SidebandServerEvent
+        end
+
         # @api private
         #
         # @param client [OpenAI::Client]

data/lib/openai/resources/live.rb

@@ -1,8 +1,27 @@
 # frozen_string_literal: true
 
+require_relative "../helpers/websocket/resource"
+
 module OpenAI
   module Resources
     class Live
+      include OpenAI::WebSocket::Resource
+
+      # @api private
+      def __websocket_request(query: {})
+        {method: :get, path: "live/sessions", query: query, security: {bearer_auth: true}}
+      end
+
+      # @api private
+      def __websocket_client_event
+        OpenAI::Models::Live::ClientEvent
+      end
+
+      # @api private
+      def __websocket_server_event
+        OpenAI::Models::Live::ServerEvent
+      end
+
       # @return [OpenAI::Resources::Live::Sideband]
       attr_reader :sideband
 

data/lib/openai/resources/realtime/translations.rb

@@ -1,9 +1,28 @@
 # frozen_string_literal: true
 
+require_relative "../../helpers/websocket/resource"
+
 module OpenAI
   module Resources
     class Realtime
       class Translations
+        include OpenAI::WebSocket::Resource
+
+        # @api private
+        def __websocket_request(query: {})
+          {method: :get, path: "realtime/translations", query: query, security: {bearer_auth: true}}
+        end
+
+        # @api private
+        def __websocket_client_event
+          OpenAI::Models::Realtime::RealtimeTranslationClientEvent
+        end
+
+        # @api private
+        def __websocket_server_event
+          OpenAI::Models::Realtime::RealtimeTranslationServerEvent
+        end
+
         # @return [OpenAI::Resources::Realtime::Translations::ClientSecrets]
         attr_reader :client_secrets
 

data/lib/openai/resources/realtime.rb

@@ -1,8 +1,27 @@
 # frozen_string_literal: true
 
+require_relative "../helpers/websocket/resource"
+
 module OpenAI
   module Resources
     class Realtime
+      include OpenAI::WebSocket::Resource
+
+      # @api private
+      def __websocket_request(query: {})
+        {method: :get, path: "realtime", query: query, security: {bearer_auth: true}}
+      end
+
+      # @api private
+      def __websocket_client_event
+        OpenAI::Models::Realtime::RealtimeClientEvent
+      end
+
+      # @api private
+      def __websocket_server_event
+        OpenAI::Models::Realtime::RealtimeServerEvent
+      end
+
       # @return [OpenAI::Resources::Realtime::ClientSecrets]
       attr_reader :client_secrets