openai 0.92.0 → 0.94.0

data/sig/openai/models/image_generate_params.rbs

@@ -22,34 +22,182 @@ module OpenAI
       extend OpenAI::Internal::Type::RequestParameters::Converter
       include OpenAI::Internal::Type::RequestParameters
 
+      # A text description of the desired image(s). The maximum length is 32000
+      # characters for the GPT image models, 1000 characters for `dall-e-2` and 4000
+      # characters for `dall-e-3`.
       attr_accessor prompt: String
 
+      # Allows to set transparency for the background of the generated image(s). Must be
+      # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
+      # the model will automatically determine the best background for the image.
+      #
+      # `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+      # snapshots, support `opaque` and `transparent` backgrounds. Transparent
+      # backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+      # `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
+      # set the output format to `png` or `webp`.
       attr_accessor background: OpenAI::Models::ImageGenerateParams::background?
 
+      # The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT
+      # image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `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`,
+      # `gpt-image-2.5-flare-2026-09-08`). Defaults to `dall-e-2` unless a parameter
+      # specific to the GPT image models is used.
       attr_accessor model: OpenAI::Models::ImageGenerateParams::model?
 
+      # Control the content-moderation level for images generated by the GPT image
+      # models. Must be either `low` for less restrictive filtering or `auto` (default
+      # value).
       attr_accessor moderation: OpenAI::Models::ImageGenerateParams::moderation?
 
+      # The number of images to generate. Must be between 1 and 10. For `dall-e-3`, only
+      # `n=1` is supported.
       attr_accessor n: Integer?
 
+      # The compression level (0-100%) for the generated images. This parameter is only
+      # supported for the GPT image models with the `webp` or `jpeg` output formats, and
+      # defaults to 100.
       attr_accessor output_compression: Integer?
 
+      # The format in which the generated images are returned. This parameter is only
+      # supported for the GPT image models. Must be one of `png`, `jpeg`, or `webp`.
       attr_accessor output_format: OpenAI::Models::ImageGenerateParams::output_format?
 
+      # The number of partial images to generate. This parameter is used for streaming
+      # responses that return partial images. Value must be between 0 and 3. When set to
+      # 0, the response will be a single image sent in one streaming event.
+      #
+      # Note that the final image may be sent before the full number of partial images
+      # are generated if the full image is generated more quickly.
       attr_accessor partial_images: Integer?
 
+      # The quality of the image that will be generated.
+      #
+      # - `auto` (default value) will automatically select the best quality for the
+      #   given model.
+      # - `high`, `medium` and `low` are supported for the GPT image models.
+      # - `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their
+      #   `2026-09-08` snapshots, also support `xhigh` and `max`.
+      # - `hd` and `standard` are supported for `dall-e-3`.
+      # - `standard` is the only option for `dall-e-2`.
       attr_accessor quality: OpenAI::Models::ImageGenerateParams::quality?
 
+      # The format in which generated images with `dall-e-2` and `dall-e-3` are
+      # returned. Must be one of `url` or `b64_json`. URLs are only valid for 60 minutes
+      # after the image has been generated. This parameter isn't supported for the GPT
+      # image models, which always return base64-encoded images.
       attr_accessor response_format: OpenAI::Models::ImageGenerateParams::response_format?
 
+      # 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
+      # resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`.
+      # Width and height must both be divisible by 16 and the requested aspect ratio
+      # must be between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and
+      # the maximum supported resolution is `3840x2160`. The requested size must also
+      # satisfy the model's current pixel and edge limits. The standard sizes
+      # `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
+      # `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
+      # one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
+      # `1024x1024`, `1792x1024`, or `1024x1792`.
       attr_accessor size: OpenAI::Models::ImageGenerateParams::size?
 
+      # The style of the generated images. This parameter is only supported for
+      # `dall-e-3`. Must be one of `vivid` or `natural`. Vivid causes the model to lean
+      # towards generating hyper-real and dramatic images. Natural causes the model to
+      # produce more natural, less hyper-real looking images.
       attr_accessor style: OpenAI::Models::ImageGenerateParams::style?
 
+      # A unique identifier representing your end-user, which can help OpenAI to monitor
+      # and detect abuse.
+      # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       attr_reader user: String?
 
+      # A unique identifier representing your end-user, which can help OpenAI to monitor
+      # and detect abuse.
+      # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       def user=: (String) -> String
 
+      # @param prompt
+      #   A text description of the desired image(s). The maximum length is 32000
+      #   characters for the GPT image models, 1000 characters for `dall-e-2` and 4000
+      #   characters for `dall-e-3`.
+      # @param background
+      #   Allows to set transparency for the background of the generated image(s). Must be
+      #   one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
+      #   the model will automatically determine the best background for the image.
+      #
+      #   `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+      #   snapshots, support `opaque` and `transparent` backgrounds. Transparent
+      #   backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+      #   `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
+      #   set the output format to `png` or `webp`.
+      # @param model
+      #   The model to use for image generation. One of `dall-e-2`, `dall-e-3`, or a GPT
+      #   image model (`gpt-image-1`, `gpt-image-1-mini`, `gpt-image-1.5`, `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`,
+      #   `gpt-image-2.5-flare-2026-09-08`). Defaults to `dall-e-2` unless a parameter
+      #   specific to the GPT image models is used.
+      # @param moderation
+      #   Control the content-moderation level for images generated by the GPT image
+      #   models. Must be either `low` for less restrictive filtering or `auto` (default
+      #   value).
+      # @param n
+      #   The number of images to generate. Must be between 1 and 10. For `dall-e-3`, only
+      #   `n=1` is supported.
+      # @param output_compression
+      #   The compression level (0-100%) for the generated images. This parameter is only
+      #   supported for the GPT image models with the `webp` or `jpeg` output formats, and
+      #   defaults to 100.
+      # @param output_format
+      #   The format in which the generated images are returned. This parameter is only
+      #   supported for the GPT image models. Must be one of `png`, `jpeg`, or `webp`.
+      # @param partial_images
+      #   The number of partial images to generate. This parameter is used for streaming
+      #   responses that return partial images. Value must be between 0 and 3. When set to
+      #   0, the response will be a single image sent in one streaming event.
+      #
+      #   Note that the final image may be sent before the full number of partial images
+      #   are generated if the full image is generated more quickly.
+      # @param quality
+      #   The quality of the image that will be generated.
+      #
+      #   - `auto` (default value) will automatically select the best quality for the
+      #     given model.
+      #   - `high`, `medium` and `low` are supported for the GPT image models.
+      #   - `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their
+      #     `2026-09-08` snapshots, also support `xhigh` and `max`.
+      #   - `hd` and `standard` are supported for `dall-e-3`.
+      #   - `standard` is the only option for `dall-e-2`.
+      # @param response_format
+      #   The format in which generated images with `dall-e-2` and `dall-e-3` are
+      #   returned. Must be one of `url` or `b64_json`. URLs are only valid for 60 minutes
+      #   after the image has been generated. This parameter isn't supported for the GPT
+      #   image models, which always return base64-encoded images.
+      # @param size
+      #   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
+      #   resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`.
+      #   Width and height must both be divisible by 16 and the requested aspect ratio
+      #   must be between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and
+      #   the maximum supported resolution is `3840x2160`. The requested size must also
+      #   satisfy the model's current pixel and edge limits. The standard sizes
+      #   `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
+      #   `auto` is supported for models that allow automatic sizing. For `dall-e-2`, use
+      #   one of `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of
+      #   `1024x1024`, `1792x1024`, or `1024x1792`.
+      # @param style
+      #   The style of the generated images. This parameter is only supported for
+      #   `dall-e-3`. Must be one of `vivid` or `natural`. Vivid causes the model to lean
+      #   towards generating hyper-real and dramatic images. Natural causes the model to
+      #   produce more natural, less hyper-real looking images.
+      # @param user
+      #   A unique identifier representing your end-user, which can help OpenAI to monitor
+      #   and detect abuse.
+      #   [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       def initialize: (
         prompt: String,
         ?background: OpenAI::Models::ImageGenerateParams::background?,

data/sig/openai/models/image_input_reference_param.rbs

@@ -7,10 +7,14 @@ module OpenAI
 
       def file_id=: (String) -> String
 
+      # A fully qualified URL or base64-encoded data URL.
       attr_reader image_url: String?
 
+      # A fully qualified URL or base64-encoded data URL.
       def image_url=: (String) -> String
 
+      # @param image_url
+      #   A fully qualified URL or base64-encoded data URL.
       def initialize: (?file_id: String, ?image_url: String) -> void
 
       def to_hash: -> { ?file_id: String, ?image_url: String }

data/sig/openai/models/images_response.rbs

@@ -12,42 +12,75 @@ module OpenAI
       }
 
     class ImagesResponse < OpenAI::Internal::Type::BaseModel
+      # The Unix timestamp (in seconds) of when the image was created.
       attr_accessor created: Integer
 
+      # The background parameter used for the image generation. Either `transparent` or
+      # `opaque`.
       attr_reader background: OpenAI::Models::ImagesResponse::background?
 
+      # The background parameter used for the image generation. Either `transparent` or
+      # `opaque`.
       def background=: (
         OpenAI::Models::ImagesResponse::background
       ) -> OpenAI::Models::ImagesResponse::background
 
+      # The list of generated images.
       attr_reader data: ::Array[OpenAI::Image]?
 
+      # The list of generated images.
       def data=: (::Array[OpenAI::Image]) -> ::Array[OpenAI::Image]
 
+      # The output format of the image generation. Either `png`, `webp`, or `jpeg`.
       attr_reader output_format: OpenAI::Models::ImagesResponse::output_format?
 
+      # The output format of the image generation. Either `png`, `webp`, or `jpeg`.
       def output_format=: (
         OpenAI::Models::ImagesResponse::output_format
       ) -> OpenAI::Models::ImagesResponse::output_format
 
+      # The quality of the image generated. One of `low`, `medium`, `high`, `xhigh`, or
+      # `max`.
       attr_reader quality: OpenAI::Models::ImagesResponse::quality?
 
+      # The quality of the image generated. One of `low`, `medium`, `high`, `xhigh`, or
+      # `max`.
       def quality=: (
         OpenAI::Models::ImagesResponse::quality
       ) -> OpenAI::Models::ImagesResponse::quality
 
+      # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       attr_reader size: OpenAI::Models::ImagesResponse::size?
 
+      # The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
       def size=: (
         OpenAI::Models::ImagesResponse::size
       ) -> OpenAI::Models::ImagesResponse::size
 
+      # For `gpt-image-1` only, the token usage information for the image generation.
       attr_reader usage: OpenAI::ImagesResponse::Usage?
 
+      # For `gpt-image-1` only, the token usage information for the image generation.
       def usage=: (
         OpenAI::ImagesResponse::Usage
       ) -> OpenAI::ImagesResponse::Usage
 
+      # @param created
+      #   The Unix timestamp (in seconds) of when the image was created.
+      # @param background
+      #   The background parameter used for the image generation. Either `transparent` or
+      #   `opaque`.
+      # @param data
+      #   The list of generated images.
+      # @param output_format
+      #   The output format of the image generation. Either `png`, `webp`, or `jpeg`.
+      # @param quality
+      #   The quality of the image generated. One of `low`, `medium`, `high`, `xhigh`, or
+      #   `max`.
+      # @param size
+      #   The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+      # @param usage
+      #   For `gpt-image-1` only, the token usage information for the image generation.
       def initialize: (
         created: Integer,
         ?background: OpenAI::Models::ImagesResponse::background,
@@ -131,20 +164,36 @@ module OpenAI
         }
 
       class Usage < OpenAI::Internal::Type::BaseModel
+        # The number of tokens (images and text) in the input prompt.
         attr_accessor input_tokens: Integer
 
+        # The input tokens detailed information for the image generation.
         attr_accessor input_tokens_details: OpenAI::ImagesResponse::Usage::InputTokensDetails
 
+        # The number of output tokens generated by the model.
         attr_accessor output_tokens: Integer
 
+        # The total number of tokens (images and text) used for the image generation.
         attr_accessor total_tokens: Integer
 
+        # The output token details for the image generation.
         attr_reader output_tokens_details: OpenAI::ImagesResponse::Usage::OutputTokensDetails?
 
+        # The output token details for the image generation.
         def output_tokens_details=: (
           OpenAI::ImagesResponse::Usage::OutputTokensDetails
         ) -> OpenAI::ImagesResponse::Usage::OutputTokensDetails
 
+        # @param input_tokens
+        #   The number of tokens (images and text) in the input prompt.
+        # @param input_tokens_details
+        #   The input tokens detailed information for the image generation.
+        # @param output_tokens
+        #   The number of output tokens generated by the model.
+        # @param total_tokens
+        #   The total number of tokens (images and text) used for the image generation.
+        # @param output_tokens_details
+        #   The output token details for the image generation.
         def initialize: (
           input_tokens: Integer,
           input_tokens_details: OpenAI::ImagesResponse::Usage::InputTokensDetails,
@@ -165,10 +214,16 @@ module OpenAI
           { image_tokens: Integer, text_tokens: Integer }
 
         class InputTokensDetails < OpenAI::Internal::Type::BaseModel
+          # The number of image tokens in the input prompt.
           attr_accessor image_tokens: Integer
 
+          # The number of text tokens in the input prompt.
           attr_accessor text_tokens: Integer
 
+          # @param image_tokens
+          #   The number of image tokens in the input prompt.
+          # @param text_tokens
+          #   The number of text tokens in the input prompt.
           def initialize: (image_tokens: Integer, text_tokens: Integer) -> void
 
           def to_hash: -> { image_tokens: Integer, text_tokens: Integer }
@@ -178,10 +233,16 @@ module OpenAI
           { image_tokens: Integer, text_tokens: Integer }
 
         class OutputTokensDetails < OpenAI::Internal::Type::BaseModel
+          # The number of image output tokens generated by the model.
           attr_accessor image_tokens: Integer
 
+          # The number of text output tokens generated by the model.
           attr_accessor text_tokens: Integer
 
+          # @param image_tokens
+          #   The number of image output tokens generated by the model.
+          # @param text_tokens
+          #   The number of text output tokens generated by the model.
           def initialize: (image_tokens: Integer, text_tokens: Integer) -> void
 
           def to_hash: -> { image_tokens: Integer, text_tokens: Integer }

data/sig/openai/models/live/audio_format.rbs

@@ -16,10 +16,16 @@ module OpenAI
           }
 
         class AudioPCM < OpenAI::Internal::Type::BaseModel
+          # Audio sample rate in hertz. Live WebSocket PCM audio supports 16000 or 24000 Hz.
           attr_accessor rate: OpenAI::Models::Live::AudioFormat::AudioPCM::rate
 
+          # The audio encoding. Always `audio/pcm`.
           attr_accessor type: :"audio/pcm"
 
+          # @param rate
+          #   Audio sample rate in hertz. Live WebSocket PCM audio supports 16000 or 24000 Hz.
+          # @param type
+          #   The audio encoding. Always `audio/pcm`.
           def initialize: (
             rate: OpenAI::Models::Live::AudioFormat::AudioPCM::rate,
             ?type: :"audio/pcm"
@@ -45,10 +51,16 @@ module OpenAI
         type audio_pcmu = { rate: Integer, ?type: :"audio/pcmu" }
 
         class AudioPCMU < OpenAI::Internal::Type::BaseModel
+          # Audio sample rate in hertz. G.711 audio uses 8000 Hz.
           attr_accessor rate: Integer
 
+          # The audio encoding. Always `audio/pcmu`.
           attr_accessor type: :"audio/pcmu"
 
+          # @param rate
+          #   Audio sample rate in hertz. G.711 audio uses 8000 Hz.
+          # @param type
+          #   The audio encoding. Always `audio/pcmu`.
           def initialize: (rate: Integer, ?type: :"audio/pcmu") -> void
 
           def to_hash: -> { rate: Integer, ?type: :"audio/pcmu" }
@@ -57,10 +69,16 @@ module OpenAI
         type audio_pcma = { rate: Integer, ?type: :"audio/pcma" }
 
         class AudioPCMA < OpenAI::Internal::Type::BaseModel
+          # Audio sample rate in hertz. G.711 audio uses 8000 Hz.
           attr_accessor rate: Integer
 
+          # The audio encoding. Always `audio/pcma`.
           attr_accessor type: :"audio/pcma"
 
+          # @param rate
+          #   Audio sample rate in hertz. G.711 audio uses 8000 Hz.
+          # @param type
+          #   The audio encoding. Always `audio/pcma`.
           def initialize: (rate: Integer, ?type: :"audio/pcma") -> void
 
           def to_hash: -> { rate: Integer, ?type: :"audio/pcma" }

data/sig/openai/models/live/client_config.rbs

@@ -4,8 +4,11 @@ module OpenAI
       type client_config = { data_channel: OpenAI::Live::DataChannelConfig }
 
       class ClientConfig < OpenAI::Internal::Type::BaseModel
+        # Client and server event permissions for the WebRTC frontend data channel.
         attr_accessor data_channel: OpenAI::Live::DataChannelConfig
 
+        # @param data_channel
+        #   Client and server event permissions for the WebRTC frontend data channel.
         def initialize: (data_channel: OpenAI::Live::DataChannelConfig) -> void
 
         def to_hash: -> { data_channel: OpenAI::Live::DataChannelConfig }

data/sig/openai/models/live/client_delegation.rbs

@@ -4,8 +4,11 @@ module OpenAI
       type client_delegation = { ?type: :client }
 
       class ClientDelegation < OpenAI::Internal::Type::BaseModel
+        # The delegation owner. Always `client` for tasks handled by your application.
         attr_accessor type: :client
 
+        # @param type
+        #   The delegation owner. Always `client` for tasks handled by your application.
         def initialize: (?type: :client) -> void
 
         def to_hash: -> { ?type: :client }

data/sig/openai/models/live/commentary_append_event.rbs

@@ -10,14 +10,36 @@ module OpenAI
         }
 
       class CommentaryAppendEvent < OpenAI::Internal::Type::BaseModel
+        # Speakable context for the Live model, limited to 500 tokens. Use this for a
+        # result the model should communicate; use session.thinking.append for silent
+        # context.
         attr_accessor content: String
 
+        # Required, nullable. Set null for general session context, or use the ID from
+        # session.delegation.created for an existing client delegation. Non-null IDs are
+        # not accepted with Responses delegation.
         attr_accessor delegation_id: String?
 
+        # The Live client event type. Always `session.commentary.append`.
         attr_accessor type: :"session.commentary.append"
 
+        # Optional client identifier for correlating this command with a server event's
+        # client_event_id or error.client_event_id.
         attr_accessor event_id: String?
 
+        # @param content
+        #   Speakable context for the Live model, limited to 500 tokens. Use this for a
+        #   result the model should communicate; use session.thinking.append for silent
+        #   context.
+        # @param delegation_id
+        #   Required, nullable. Set null for general session context, or use the ID from
+        #   session.delegation.created for an existing client delegation. Non-null IDs are
+        #   not accepted with Responses delegation.
+        # @param event_id
+        #   Optional client identifier for correlating this command with a server event's
+        #   client_event_id or error.client_event_id.
+        # @param type
+        #   The Live client event type. Always `session.commentary.append`.
         def initialize: (
           content: String,
           delegation_id: String?,

data/sig/openai/models/live/commentary_appended_event.rbs

@@ -11,18 +11,41 @@ module OpenAI
         }
 
       class CommentaryAppendedEvent < OpenAI::Internal::Type::BaseModel
+        # The end of this event on the Live session timeline, in milliseconds from the
+        # beginning of the session. For appended context, this can equal start_ms.
         attr_accessor end_ms: Integer
 
+        # The unique ID of the Live server event.
         attr_accessor event_id: String
 
+        # The start of this event on the Live session timeline, in milliseconds from the
+        # beginning of the session.
         attr_accessor start_ms: Integer
 
+        # The event type, always `session.commentary.appended`.
         attr_accessor type: :"session.commentary.appended"
 
+        # The event_id of the client command associated with this server event, when
+        # supplied.
         attr_reader client_event_id: String?
 
+        # The event_id of the client command associated with this server event, when
+        # supplied.
         def client_event_id=: (String) -> String
 
+        # @param end_ms
+        #   The end of this event on the Live session timeline, in milliseconds from the
+        #   beginning of the session. For appended context, this can equal start_ms.
+        # @param event_id
+        #   The unique ID of the Live server event.
+        # @param start_ms
+        #   The start of this event on the Live session timeline, in milliseconds from the
+        #   beginning of the session.
+        # @param client_event_id
+        #   The event_id of the client command associated with this server event, when
+        #   supplied.
+        # @param type
+        #   The event type, always `session.commentary.appended`.
         def initialize: (
           end_ms: Integer,
           event_id: String,

data/sig/openai/models/live/data_channel_config.rbs

@@ -8,18 +8,41 @@ module OpenAI
         }
 
       class DataChannelConfig < OpenAI::Internal::Type::BaseModel
+        # Client event types that the frontend data channel may send. Use 'all' to allow
+        # every client event; an empty array allows none. Omission preserves the existing
+        # allow-all behavior.
         attr_reader allowed_client_events: OpenAI::Models::Live::DataChannelConfig::allowed_client_events?
 
+        # Client event types that the frontend data channel may send. Use 'all' to allow
+        # every client event; an empty array allows none. Omission preserves the existing
+        # allow-all behavior.
         def allowed_client_events=: (
           OpenAI::Models::Live::DataChannelConfig::allowed_client_events
         ) -> OpenAI::Models::Live::DataChannelConfig::allowed_client_events
 
+        # Server events that may be sent to the frontend data channel. Use 'all' to allow
+        # every server event; an empty array allows none. Omission preserves the existing
+        # allow-all behavior. Responses events use an object with type 'response.event'
+        # and a response_event selector.
         attr_reader allowed_server_events: OpenAI::Models::Live::DataChannelConfig::allowed_server_events?
 
+        # Server events that may be sent to the frontend data channel. Use 'all' to allow
+        # every server event; an empty array allows none. Omission preserves the existing
+        # allow-all behavior. Responses events use an object with type 'response.event'
+        # and a response_event selector.
         def allowed_server_events=: (
           OpenAI::Models::Live::DataChannelConfig::allowed_server_events
         ) -> OpenAI::Models::Live::DataChannelConfig::allowed_server_events
 
+        # @param allowed_client_events
+        #   Client event types that the frontend data channel may send. Use 'all' to allow
+        #   every client event; an empty array allows none. Omission preserves the existing
+        #   allow-all behavior.
+        # @param allowed_server_events
+        #   Server events that may be sent to the frontend data channel. Use 'all' to allow
+        #   every server event; an empty array allows none. Omission preserves the existing
+        #   allow-all behavior. Responses events use an object with type 'response.event'
+        #   and a response_event selector.
         def initialize: (
           ?allowed_client_events: OpenAI::Models::Live::DataChannelConfig::allowed_client_events,
           ?allowed_server_events: OpenAI::Models::Live::DataChannelConfig::allowed_server_events

data/sig/openai/models/live/delegation_created_event.rbs

@@ -11,18 +11,41 @@ module OpenAI
         }
 
       class DelegationCreatedEvent < OpenAI::Internal::Type::BaseModel
+        # The delegated work identifier and destination. This object contains metadata,
+        # not the task text.
         attr_accessor delegation: OpenAI::Live::DelegationCreatedEvent::Delegation
 
+        # The unique ID of the Live server event.
         attr_accessor event_id: String
 
+        # The position on the Live session timeline where the delegation was created, in
+        # milliseconds from the beginning of the session.
         attr_accessor offset_ms: Integer
 
+        # The event type, always `session.delegation.created`.
         attr_accessor type: :"session.delegation.created"
 
+        # The event_id of the client command associated with this server event, when
+        # supplied.
         attr_reader client_event_id: String?
 
+        # The event_id of the client command associated with this server event, when
+        # supplied.
         def client_event_id=: (String) -> String
 
+        # @param delegation
+        #   The delegated work identifier and destination. This object contains metadata,
+        #   not the task text.
+        # @param event_id
+        #   The unique ID of the Live server event.
+        # @param offset_ms
+        #   The position on the Live session timeline where the delegation was created, in
+        #   milliseconds from the beginning of the session.
+        # @param client_event_id
+        #   The event_id of the client command associated with this server event, when
+        #   supplied.
+        # @param type
+        #   The event type, always `session.delegation.created`.
         def initialize: (
           delegation: OpenAI::Live::DelegationCreatedEvent::Delegation,
           event_id: String,
@@ -48,16 +71,36 @@ module OpenAI
           }
 
         class Delegation < OpenAI::Internal::Type::BaseModel
+          # The unique ID of the delegation. Use this as delegation_id when replying to
+          # client-owned work or correlating Responses events.
           attr_accessor id: String
 
+          # Where the Live model delegated the work: `client` for your application, or
+          # `responses` for the configured Responses backend.
           attr_accessor target: OpenAI::Models::Live::DelegationCreatedEvent::Delegation::target
 
+          # The object type, always `delegation`.
           attr_accessor type: :delegation
 
+          # The ID of the Responses API response associated with a Responses delegation.
+          # Omitted for client delegations.
           attr_reader response_id: String?
 
+          # The ID of the Responses API response associated with a Responses delegation.
+          # Omitted for client delegations.
           def response_id=: (String) -> String
 
+          # @param id
+          #   The unique ID of the delegation. Use this as delegation_id when replying to
+          #   client-owned work or correlating Responses events.
+          # @param target
+          #   Where the Live model delegated the work: `client` for your application, or
+          #   `responses` for the configured Responses backend.
+          # @param response_id
+          #   The ID of the Responses API response associated with a Responses delegation.
+          #   Omitted for client delegations.
+          # @param type
+          #   The object type, always `delegation`.
           def initialize: (
             id: String,
             target: OpenAI::Models::Live::DelegationCreatedEvent::Delegation::target,

data/sig/openai/models/live/error.rbs

@@ -11,20 +11,39 @@ module OpenAI
         }
 
       class Error < OpenAI::Internal::Type::BaseModel
+        # A machine-readable code identifying the Live error, such as `unknown_parameter`.
         attr_accessor code: String
 
+        # A human-readable explanation of the Live error.
         attr_accessor message: String
 
+        # The category of error, such as `invalid_request_error` for an invalid Live
+        # client command.
         attr_accessor type: String
 
+        # The event_id of the client command that caused the error, when supplied.
         attr_reader client_event_id: String?
 
+        # The event_id of the client command that caused the error, when supplied.
         def client_event_id=: (String) -> String
 
+        # The parameter that caused the error, when applicable, such as `session.voice`.
         attr_reader param: String?
 
+        # The parameter that caused the error, when applicable, such as `session.voice`.
         def param=: (String) -> String
 
+        # @param code
+        #   A machine-readable code identifying the Live error, such as `unknown_parameter`.
+        # @param message
+        #   A human-readable explanation of the Live error.
+        # @param type
+        #   The category of error, such as `invalid_request_error` for an invalid Live
+        #   client command.
+        # @param client_event_id
+        #   The event_id of the client command that caused the error, when supplied.
+        # @param param
+        #   The parameter that caused the error, when applicable, such as `session.voice`.
         def initialize: (
           code: String,
           message: String,