openai 0.97.0 → 0.99.0

data/sig/openai/models/image_generate_params.rbs

@@ -23,8 +23,7 @@ module OpenAI
       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`.
+      # characters.
       attr_accessor prompt: String
 
       # Allows to set transparency for the background of the generated image(s). Must be
@@ -38,12 +37,11 @@ module OpenAI
       # 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`,
+      # The GPT image model to use for image generation. Specify a model explicitly.
+      # Supported models include `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.
+      # `gpt-image-2.5-flare-2026-09-08`, and `chatgpt-image-latest`.
       attr_accessor model: OpenAI::Models::ImageGenerateParams::model?
 
       # Control the content-moderation level for images generated by the GPT image
@@ -51,8 +49,7 @@ module OpenAI
       # 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.
+      # The number of images to generate. Must be between 1 and 10.
       attr_accessor n: Integer?
 
       # The compression level (0-100%) for the generated images. This parameter is only
@@ -79,13 +76,9 @@ module OpenAI
       # - `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
+      # Legacy response format parameter for retired image models. Unsupported for GPT
       # image models, which always return base64-encoded images.
       attr_accessor response_format: OpenAI::Models::ImageGenerateParams::response_format?
 
@@ -98,15 +91,11 @@ module OpenAI
       # 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`.
+      # `auto` is supported for models that allow automatic sizing.
       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.
+      # Legacy style parameter for retired image models. Unsupported for GPT image
+      # models; describe the desired style in the prompt instead.
       attr_accessor style: OpenAI::Models::ImageGenerateParams::style?
 
       # A unique identifier representing your end-user, which can help OpenAI to monitor
@@ -121,8 +110,7 @@ module OpenAI
 
       # @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`.
+      #   characters.
       # @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,
@@ -134,19 +122,17 @@ module OpenAI
       #   `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`,
+      #   The GPT image model to use for image generation. Specify a model explicitly.
+      #   Supported models include `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.
+      #   `gpt-image-2.5-flare-2026-09-08`, and `chatgpt-image-latest`.
       # @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.
+      #   The number of images to generate. Must be between 1 and 10.
       # @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
@@ -169,12 +155,8 @@ module OpenAI
       #   - `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
+      #   Legacy response format parameter for retired image models. Unsupported for 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`,
@@ -186,14 +168,10 @@ module OpenAI
       #   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`.
+      #   `auto` is supported for models that allow automatic sizing.
       # @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.
+      #   Legacy style parameter for retired image models. Unsupported for GPT image
+      #   models; describe the desired style in the prompt instead.
       # @param user
       #   A unique identifier representing your end-user, which can help OpenAI to monitor
       #   and detect abuse.
@@ -276,19 +254,19 @@ module OpenAI
       end
 
       type quality =
-        :standard | :hd | :low | :medium | :high | :xhigh | :max | :auto
+        :low | :medium | :high | :xhigh | :max | :auto | :standard | :hd
 
       module Quality
         extend OpenAI::Internal::Type::Enum
 
-        STANDARD: :standard
-        HD: :hd
         LOW: :low
         MEDIUM: :medium
         HIGH: :high
         XHIGH: :xhigh
         MAX: :max
         AUTO: :auto
+        STANDARD: :standard
+        HD: :hd
 
         def self?.values: -> ::Array[OpenAI::Models::ImageGenerateParams::quality]
       end

data/sig/openai/models/image_model.rbs

@@ -1,15 +1,15 @@
 module OpenAI
   module Models
     type 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"
-      | :"gpt-image-1.5"
+      | :"gpt-image-1"
+      | :"gpt-image-1-mini"
       | :"chatgpt-image-latest"
       | :"dall-e-2"
       | :"dall-e-3"
@@ -17,15 +17,15 @@ module OpenAI
     module ImageModel
       extend OpenAI::Internal::Type::Enum
 
-      GPT_IMAGE_1: :"gpt-image-1"
-      GPT_IMAGE_1_MINI: :"gpt-image-1-mini"
+      GPT_IMAGE_1_5: :"gpt-image-1.5"
       GPT_IMAGE_2: :"gpt-image-2"
       GPT_IMAGE_2_2026_04_21: :"gpt-image-2-2026-04-21"
       GPT_IMAGE_2_5_SUNBURST: :"gpt-image-2.5-sunburst"
       GPT_IMAGE_2_5_SUNBURST_2026_09_08: :"gpt-image-2.5-sunburst-2026-09-08"
       GPT_IMAGE_2_5_FLARE: :"gpt-image-2.5-flare"
       GPT_IMAGE_2_5_FLARE_2026_09_08: :"gpt-image-2.5-flare-2026-09-08"
-      GPT_IMAGE_1_5: :"gpt-image-1.5"
+      GPT_IMAGE_1: :"gpt-image-1"
+      GPT_IMAGE_1_MINI: :"gpt-image-1-mini"
       CHATGPT_IMAGE_LATEST: :"chatgpt-image-latest"
       DALL_E_2: :"dall-e-2"
       DALL_E_3: :"dall-e-3"

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

@@ -81,7 +81,12 @@ module OpenAI
         end
 
         type transport_dtmf_send =
-          { event: String, event_id: String, ?type: :"transport.dtmf.send" }
+          {
+            event: String,
+            event_id: String,
+            ?type: :"transport.dtmf.send",
+            ?client_event_id: String
+          }
 
         class TransportDtmfSend < OpenAI::Internal::Type::BaseModel
           attr_accessor event: String
@@ -90,16 +95,26 @@ module OpenAI
 
           attr_accessor type: :"transport.dtmf.send"
 
+          # The event_id of the client command, when supplied.
+          attr_reader client_event_id: String?
+
+          # The event_id of the client command, when supplied.
+          def client_event_id=: (String) -> String
+
+          # @param client_event_id
+          #   The event_id of the client command, when supplied.
           def initialize: (
             event: String,
             event_id: String,
+            ?client_event_id: String,
             ?type: :"transport.dtmf.send"
           ) -> void
 
           def to_hash: -> {
             event: String,
             event_id: String,
-            ?type: :"transport.dtmf.send"
+            ?type: :"transport.dtmf.send",
+            ?client_event_id: String
           }
         end
 

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

@@ -81,7 +81,12 @@ module OpenAI
         end
 
         type transport_dtmf_send =
-          { event: String, event_id: String, ?type: :"transport.dtmf.send" }
+          {
+            event: String,
+            event_id: String,
+            ?type: :"transport.dtmf.send",
+            ?client_event_id: String
+          }
 
         class TransportDtmfSend < OpenAI::Internal::Type::BaseModel
           attr_accessor event: String
@@ -90,16 +95,26 @@ module OpenAI
 
           attr_accessor type: :"transport.dtmf.send"
 
+          # The event_id of the client command, when supplied.
+          attr_reader client_event_id: String?
+
+          # The event_id of the client command, when supplied.
+          def client_event_id=: (String) -> String
+
+          # @param client_event_id
+          #   The event_id of the client command, when supplied.
           def initialize: (
             event: String,
             event_id: String,
+            ?client_event_id: String,
             ?type: :"transport.dtmf.send"
           ) -> void
 
           def to_hash: -> {
             event: String,
             event_id: String,
-            ?type: :"transport.dtmf.send"
+            ?type: :"transport.dtmf.send",
+            ?client_event_id: String
           }
         end
 

data/sig/openai/models/realtime/realtime_audio_config_output.rbs

@@ -39,16 +39,18 @@ module OpenAI
         # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
         # `cedar`. You may also provide a custom voice object with an `id`, for example
         # `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
-        # model has responded with audio at least once. We recommend `marin` and `cedar`
-        # for best quality.
+        # model has responded with audio at least once. Custom voices must be created from
+        # audio samples. Voices created from text prompts are supported only in Live. We
+        # recommend `marin` and `cedar` for best quality.
         attr_reader voice: OpenAI::Models::Realtime::RealtimeAudioConfigOutput::voice?
 
         # The voice the model uses to respond. Supported built-in voices are `alloy`,
         # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
         # `cedar`. You may also provide a custom voice object with an `id`, for example
         # `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
-        # model has responded with audio at least once. We recommend `marin` and `cedar`
-        # for best quality.
+        # model has responded with audio at least once. Custom voices must be created from
+        # audio samples. Voices created from text prompts are supported only in Live. We
+        # recommend `marin` and `cedar` for best quality.
         def voice=: (
           OpenAI::Models::Realtime::RealtimeAudioConfigOutput::voice
         ) -> OpenAI::Models::Realtime::RealtimeAudioConfigOutput::voice
@@ -68,8 +70,9 @@ module OpenAI
         #   `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
         #   `cedar`. You may also provide a custom voice object with an `id`, for example
         #   `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
-        #   model has responded with audio at least once. We recommend `marin` and `cedar`
-        #   for best quality.
+        #   model has responded with audio at least once. Custom voices must be created from
+        #   audio samples. Voices created from text prompts are supported only in Live. We
+        #   recommend `marin` and `cedar` for best quality.
         def initialize: (
           ?format_: OpenAI::Models::Realtime::realtime_audio_formats,
           ?speed: Float,

data/sig/openai/models/realtime/realtime_response_create_audio_output.rbs

@@ -38,16 +38,18 @@ module OpenAI
           # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
           # `cedar`. You may also provide a custom voice object with an `id`, for example
           # `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
-          # model has responded with audio at least once. We recommend `marin` and `cedar`
-          # for best quality.
+          # model has responded with audio at least once. Custom voices must be created from
+          # audio samples. Voices created from text prompts are supported only in Live. We
+          # recommend `marin` and `cedar` for best quality.
           attr_reader voice: OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::voice?
 
           # The voice the model uses to respond. Supported built-in voices are `alloy`,
           # `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
           # `cedar`. You may also provide a custom voice object with an `id`, for example
           # `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
-          # model has responded with audio at least once. We recommend `marin` and `cedar`
-          # for best quality.
+          # model has responded with audio at least once. Custom voices must be created from
+          # audio samples. Voices created from text prompts are supported only in Live. We
+          # recommend `marin` and `cedar` for best quality.
           def voice=: (
             OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::voice
           ) -> OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::voice
@@ -59,8 +61,9 @@ module OpenAI
           #   `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
           #   `cedar`. You may also provide a custom voice object with an `id`, for example
           #   `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
-          #   model has responded with audio at least once. We recommend `marin` and `cedar`
-          #   for best quality.
+          #   model has responded with audio at least once. Custom voices must be created from
+          #   audio samples. Voices created from text prompts are supported only in Live. We
+          #   recommend `marin` and `cedar` for best quality.
           def initialize: (
             ?format_: OpenAI::Models::Realtime::realtime_audio_formats,
             ?voice: OpenAI::Models::Realtime::RealtimeResponseCreateAudioOutput::Output::voice

data/sig/openai/models/realtime/translations/client_secret_create_params.rbs

@@ -0,0 +1,39 @@
+module OpenAI
+  module Models
+    module Realtime
+      module Translations
+        type client_secret_create_params =
+          {
+            session: OpenAI::Realtime::RealtimeTranslationSessionCreateRequest,
+            ?expires_after: OpenAI::Realtime::RealtimeTranslationClientSecretCreateRequest::ExpiresAfter,
+            ?request_options: OpenAI::request_opts
+          }
+
+        class ClientSecretCreateParams < OpenAI::Models::Realtime::RealtimeTranslationClientSecretCreateRequest
+          extend OpenAI::Internal::Type::RequestParameters::Converter
+          include OpenAI::Internal::Type::RequestParameters
+
+          # @param session
+          #   Realtime translation session configuration. Translation sessions stream source
+          #   audio in and translated audio plus transcript deltas out continuously.
+          # @param expires_after
+          #   Configuration for the client secret expiration. Expiration refers to the time
+          #   after which a client secret will no longer be valid for creating sessions. The
+          #   session itself may continue after that time once started. A secret can be used
+          #   to create multiple sessions until it expires.
+          def initialize: (
+            session: OpenAI::Realtime::RealtimeTranslationSessionCreateRequest,
+            ?expires_after: OpenAI::Realtime::RealtimeTranslationClientSecretCreateRequest::ExpiresAfter,
+            ?request_options: OpenAI::request_opts
+          ) -> void
+
+          def to_hash: -> {
+            session: OpenAI::Realtime::RealtimeTranslationSessionCreateRequest,
+            ?expires_after: OpenAI::Realtime::RealtimeTranslationClientSecretCreateRequest::ExpiresAfter,
+            ?request_options: OpenAI::RequestOptions
+          }
+        end
+      end
+    end
+  end
+end

data/sig/openai/models/responses/response_output_text.rbs

@@ -69,7 +69,7 @@ module OpenAI
             # The filename of the file cited.
             attr_accessor filename: String
 
-            # The index of the file in the list of files.
+            # The index in the output text at which to insert the file citation.
             attr_accessor index: Integer
 
             # The type of the file citation. Always `file_citation`.
@@ -80,7 +80,7 @@ module OpenAI
             # @param filename
             #   The filename of the file cited.
             # @param index
-            #   The index of the file in the list of files.
+            #   The index in the output text at which to insert the file citation.
             # @param type
             #   The type of the file citation. Always `file_citation`.
             def initialize: (

data/sig/openai/models/responses/response_output_text_annotation_added_event.rbs

@@ -92,7 +92,7 @@ module OpenAI
             # The filename of the file cited.
             attr_accessor filename: String
 
-            # The index of the file in the list of files.
+            # The index in the output text at which to insert the file citation.
             attr_accessor index: Integer
 
             # The type of the file citation. Always `file_citation`.
@@ -103,7 +103,7 @@ module OpenAI
             # @param filename
             #   The filename of the file cited.
             # @param index
-            #   The index of the file in the list of files.
+            #   The index in the output text at which to insert the file citation.
             # @param type
             #   The type of the file citation. Always `file_citation`.
             def initialize: (

data/sig/openai/models/responses/tool.rbs

@@ -727,9 +727,7 @@ module OpenAI
           # 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`.
+          # `auto` is supported for models that allow automatic sizing.
           attr_reader size: OpenAI::Models::Responses::Tool::ImageGeneration::size?
 
           # The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
@@ -741,9 +739,7 @@ module OpenAI
           # 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`.
+          # `auto` is supported for models that allow automatic sizing.
           def size=: (
             OpenAI::Models::Responses::Tool::ImageGeneration::size
           ) -> OpenAI::Models::Responses::Tool::ImageGeneration::size
@@ -798,9 +794,7 @@ module OpenAI
           #   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`.
+          #   `auto` is supported for models that allow automatic sizing.
           # @param type
           #   The type of the image generation tool. Always `image_generation`.
           def initialize: (

data/sig/openai/models/webhooks/agent_session_action_required_webhook_event.rbs

@@ -0,0 +1,114 @@
+module OpenAI
+  module Models
+    module Webhooks
+      type agent_session_action_required_webhook_event =
+        {
+          id: String,
+          created_at: Integer,
+          data: OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data,
+          ?object: :event,
+          ?type: :"agent.session.action_required"
+        }
+
+      class AgentSessionActionRequiredWebhookEvent < OpenAI::Internal::Type::BaseModel
+        # The unique ID of the event.
+        attr_accessor id: String
+
+        # The Unix timestamp, in seconds, when the event was created.
+        attr_accessor created_at: Integer
+
+        attr_accessor data: OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data
+
+        # The object type. Always `event`.
+        attr_accessor object: :event
+
+        # The event type. Always `agent.session.action_required`.
+        attr_accessor type: :"agent.session.action_required"
+
+        # @param id
+        #   The unique ID of the event.
+        # @param created_at
+        #   The Unix timestamp, in seconds, when the event was created.
+        # @param object
+        #   The object type. Always `event`.
+        # @param type
+        #   The event type. Always `agent.session.action_required`.
+        def initialize: (
+          id: String,
+          created_at: Integer,
+          data: OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data,
+          ?object: :event,
+          ?type: :"agent.session.action_required"
+        ) -> void
+
+        def to_hash: -> {
+          id: String,
+          created_at: Integer,
+          data: OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data,
+          ?object: :event,
+          ?type: :"agent.session.action_required"
+        }
+
+        type data =
+          {
+            id: String,
+            required_action: OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction
+          }
+
+        class Data < OpenAI::Internal::Type::BaseModel
+          # The ID of the session.
+          attr_accessor id: String
+
+          # The action type. Retrieve the session for action details.
+          attr_accessor required_action: OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction
+
+          # @param id
+          #   The ID of the session.
+          # @param required_action
+          #   The action type. Retrieve the session for action details.
+          def initialize: (
+            id: String,
+            required_action: OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction
+          ) -> void
+
+          def to_hash: -> {
+            id: String,
+            required_action: OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction
+          }
+
+          type required_action =
+            {
+              type: OpenAI::Models::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction::type_
+            }
+
+          class RequiredAction < OpenAI::Internal::Type::BaseModel
+            attr_accessor type: OpenAI::Models::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction::type_
+
+            def initialize: (
+              type: OpenAI::Models::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction::type_
+            ) -> void
+
+            def to_hash: -> {
+              type: OpenAI::Models::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction::type_
+            }
+
+            type type_ =
+              :computer_use_approval_request
+              | :function_call
+              | :environment_connection
+
+            module Type
+              extend OpenAI::Internal::Type::Enum
+
+              COMPUTER_USE_APPROVAL_REQUEST: :computer_use_approval_request
+              FUNCTION_CALL: :function_call
+              ENVIRONMENT_CONNECTION: :environment_connection
+
+              def self?.values: -> ::Array[OpenAI::Models::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction::type_]
+            end
+          end
+        end
+      end
+    end
+  end
+end