openai 0.97.0 → 0.99.0

data/rbi/openai/resources/images.rbi

@@ -6,7 +6,9 @@ module OpenAI
     # Given a prompt and/or an input image, the model will generate a new image.
     class Images
 
-      # Creates a variation of a given image. This endpoint only supports `dall-e-2`.
+      # This endpoint is retired and no longer available. Use the image edits endpoint
+      # with a GPT Image model and a prompt to create a variation of an image. The
+      # request and response schemas below describe the legacy contract.
       sig {
         params(
           image: OpenAI::Internal::FileInput,
@@ -27,8 +29,8 @@ module OpenAI
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or
         # content type.
         image:,
-        # The model to use for image generation. Only `dall-e-2` is supported at this
-        # time.
+        # The legacy model used by the retired image variations endpoint. This endpoint no
+        # longer accepts requests.
         model: nil,
         # The number of images to generate. Must be between 1 and 10.
         n: nil,
@@ -50,7 +52,7 @@ module OpenAI
       # See {OpenAI::Resources::Images#edit_stream_raw} for streaming counterpart.
       #
       # Creates an edited or extended image given one or more source images and a
-      # prompt. This endpoint supports GPT Image models and `dall-e-2`.
+      # prompt. This endpoint supports GPT Image models.
       sig {
         params(
           image: OpenAI::ImageEditParams::Image::Variants,
@@ -82,15 +84,12 @@ module OpenAI
         # be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to 16
         # images.
         #
-        # For `dall-e-2`, you can only provide one image, and it should be a square `png`
-        # file less than 4MB.
-        #
         # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or
         # content type.
         image:,
-        # A text description of the desired image(s). The maximum length is 1000
-        # characters for `dall-e-2`, and 32000 characters for the GPT image models.
+        # A text description of the desired image(s). The maximum length is 32000
+        # characters for the GPT image models.
         prompt:,
         # 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,
@@ -115,12 +114,11 @@ module OpenAI
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or
         # content type.
         mask: nil,
-        # The model to use for image generation. One of `dall-e-2` 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`, or `chatgpt-image-latest`). Defaults to
-        # `gpt-image-1.5`.
+        # The GPT image model to use for image editing (`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`, or
+        # `chatgpt-image-latest`).
         model: nil,
         # The number of images to generate. Must be between 1 and 10.
         n: nil,
@@ -144,23 +142,20 @@ module OpenAI
         # `gpt-image-2.5-flare`, including their `2026-09-08` snapshots, also support
         # `xhigh` and `max`. Defaults to `auto`.
         quality: nil,
-        # The format in which the generated images 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 is only supported for `dall-e-2` (default is `url` for
-        # `dall-e-2`), as GPT image models always return base64-encoded images.
+        # Legacy response format parameter for retired image models. Unsupported for GPT
+        # image models, which always return base64-encoded images.
         response_format: 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
-        # 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`.
+        # 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
+        # `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.
         size: nil,
         # A unique identifier representing your end-user, which can help OpenAI to monitor
         # and detect abuse.
@@ -176,7 +171,7 @@ module OpenAI
       # See {OpenAI::Resources::Images#edit} for non-streaming counterpart.
       #
       # Creates an edited or extended image given one or more source images and a
-      # prompt. This endpoint supports GPT Image models and `dall-e-2`.
+      # prompt. This endpoint supports GPT Image models.
       sig {
         params(
           image: OpenAI::ImageEditParams::Image::Variants,
@@ -208,15 +203,12 @@ module OpenAI
         # be a `png`, `webp`, or `jpg` file less than 50MB. You can provide up to 16
         # images.
         #
-        # For `dall-e-2`, you can only provide one image, and it should be a square `png`
-        # file less than 4MB.
-        #
         # `String`, `StringIO`, and pathless `IO` inputs are sent with generic upload
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or
         # content type.
         image:,
-        # A text description of the desired image(s). The maximum length is 1000
-        # characters for `dall-e-2`, and 32000 characters for the GPT image models.
+        # A text description of the desired image(s). The maximum length is 32000
+        # characters for the GPT image models.
         prompt:,
         # 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,
@@ -241,12 +233,11 @@ module OpenAI
         # metadata. Use `OpenAI::FilePart` when you need to override the filename or
         # content type.
         mask: nil,
-        # The model to use for image generation. One of `dall-e-2` 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`, or `chatgpt-image-latest`). Defaults to
-        # `gpt-image-1.5`.
+        # The GPT image model to use for image editing (`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`, or
+        # `chatgpt-image-latest`).
         model: nil,
         # The number of images to generate. Must be between 1 and 10.
         n: nil,
@@ -270,23 +261,20 @@ module OpenAI
         # `gpt-image-2.5-flare`, including their `2026-09-08` snapshots, also support
         # `xhigh` and `max`. Defaults to `auto`.
         quality: nil,
-        # The format in which the generated images 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 is only supported for `dall-e-2` (default is `url` for
-        # `dall-e-2`), as GPT image models always return base64-encoded images.
+        # Legacy response format parameter for retired image models. Unsupported for GPT
+        # image models, which always return base64-encoded images.
         response_format: 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
-        # 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`.
+        # 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
+        # `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.
         size: nil,
         # A unique identifier representing your end-user, which can help OpenAI to monitor
         # and detect abuse.
@@ -301,7 +289,7 @@ module OpenAI
 
       # See {OpenAI::Resources::Images#generate_stream_raw} for streaming counterpart.
       #
-      # Creates an image given a prompt.
+      # Creates an image given a prompt using a GPT Image model.
       # [Learn more](https://developers.openai.com/api/docs/guides/images-vision).
       sig {
         params(
@@ -325,8 +313,7 @@ module OpenAI
       }
       def generate(
         # 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.
         prompt:,
         # 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,
@@ -338,19 +325,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`.
         background: nil,
-        # 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`.
         model: nil,
         # 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).
         moderation: nil,
-        # 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.
         n: nil,
         # 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
@@ -373,12 +358,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`.
         quality: nil,
-        # 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.
         response_format: nil,
         # The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
@@ -390,14 +371,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.
         size: nil,
-        # 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.
         style: nil,
         # A unique identifier representing your end-user, which can help OpenAI to monitor
         # and detect abuse.
@@ -412,7 +389,7 @@ module OpenAI
 
       # See {OpenAI::Resources::Images#generate} for non-streaming counterpart.
       #
-      # Creates an image given a prompt.
+      # Creates an image given a prompt using a GPT Image model.
       # [Learn more](https://developers.openai.com/api/docs/guides/images-vision).
       sig {
         params(
@@ -436,8 +413,7 @@ module OpenAI
       }
       def generate_stream_raw(
         # 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.
         prompt:,
         # 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,
@@ -449,19 +425,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`.
         background: nil,
-        # 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`.
         model: nil,
         # 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).
         moderation: nil,
-        # 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.
         n: nil,
         # 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
@@ -484,12 +458,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`.
         quality: nil,
-        # 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.
         response_format: nil,
         # The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
@@ -501,14 +471,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.
         size: nil,
-        # 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.
         style: nil,
         # A unique identifier representing your end-user, which can help OpenAI to monitor
         # and detect abuse.

data/rbi/openai/resources/realtime/translations/client_secrets.rbi

@@ -0,0 +1,54 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+
+    class Realtime
+
+      class Translations
+
+        class ClientSecrets
+
+          # Create a Realtime translation client secret with an associated translation
+          # session configuration.
+          #
+          # Client secrets are short-lived tokens that can be passed to a client app, such
+          # as a web frontend or mobile client, which grants access to the Realtime
+          # Translation API without leaking your main API key. You can configure a custom
+          # TTL for each client secret.
+          #
+          # Returns the created client secret and the effective translation session object.
+          # The client secret is a string that looks like `ek_1234`.
+          sig {
+            params(
+              session: OpenAI::Realtime::RealtimeTranslationSessionCreateRequest::OrHash,
+              expires_after: OpenAI::Realtime::RealtimeTranslationClientSecretCreateRequest::ExpiresAfter::OrHash,
+              request_options: OpenAI::RequestOptions::OrHash
+            )
+              .returns(OpenAI::Realtime::RealtimeTranslationClientSecretCreateResponse)
+          }
+          def create(
+            # Realtime translation session configuration. Translation sessions stream source
+            # audio in and translated audio plus transcript deltas out continuously.
+            session:,
+            # 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.
+            expires_after: nil,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: OpenAI::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/resources/realtime/translations.rbi

@@ -0,0 +1,22 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+
+    class Realtime
+
+      class Translations
+
+        sig { returns(OpenAI::Resources::Realtime::Translations::ClientSecrets) }
+        attr_reader :client_secrets
+
+        # @api private
+        sig { params(client: OpenAI::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+
+    end
+
+  end
+end

data/rbi/openai/resources/realtime.rbi

@@ -11,6 +11,9 @@ module OpenAI
       sig { returns(OpenAI::Resources::Realtime::Calls) }
       attr_reader :calls
 
+      sig { returns(OpenAI::Resources::Realtime::Translations) }
+      attr_reader :translations
+
       # @api private
       sig { params(client: OpenAI::Client).returns(T.attached_class) }
       def self.new(client:)

data/rbi/openai/resources/webhooks.rbi

@@ -140,6 +140,11 @@ module OpenAI
         )
           .returns(
             T.any(
+              OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent,
+              OpenAI::Webhooks::AgentSessionCreatedWebhookEvent,
+              OpenAI::Webhooks::AgentSessionFailedWebhookEvent,
+              OpenAI::Webhooks::AgentSessionIdleWebhookEvent,
+              OpenAI::Webhooks::AgentSessionInProgressWebhookEvent,
               OpenAI::Webhooks::BatchCancelledWebhookEvent,
               OpenAI::Webhooks::BatchCompletedWebhookEvent,
               OpenAI::Webhooks::BatchExpiredWebhookEvent,

data/sig/openai/helpers/agents.rbs

@@ -16,6 +16,12 @@ module OpenAI
           | -> Enumerator[OpenAI::Models::Beta::agent_session_event, self]
         def close: -> void
         def until_done: -> self
+
+        # @beta
+        def get_final_result: -> OpenAI::Helpers::Beta::Agents::TurnResult
+
+        # @beta
+        def with_result_collection: -> self
       end
     end
   end
@@ -30,6 +36,7 @@ module OpenAI
             | Hash[Symbol, untyped]],
             ?tool_handlers: Hash[String, OpenAI::Helpers::Agents::tool_handler],
             ?idempotency_key: String?,
+            ?output_type: singleton(OpenAI::Helpers::StructuredOutput::BaseModel)?,
             ?request_options: OpenAI::RequestOptions
             | Hash[Symbol, untyped]
             | nil

data/sig/openai/helpers/beta/agents/artifacts.rbs

@@ -0,0 +1,20 @@
+module OpenAI
+  module Helpers
+    module Beta
+      module Agents
+        class ResultArtifacts
+          def initialize: (
+            artifacts: OpenAI::Resources::Beta::Agents::Sessions::Artifacts,
+            client: OpenAI::Client,
+            result: TurnResult
+          ) -> void
+          def download: (
+            path: String,
+            to: untyped,
+            ?request_options: OpenAI::request_opts
+          ) -> OpenAI::Models::Beta::Agents::Sessions::SessionArtifact
+        end
+      end
+    end
+  end
+end

data/sig/openai/helpers/beta/agents/files.rbs

@@ -0,0 +1,41 @@
+module OpenAI
+  module Helpers
+    module Beta
+      module Agents
+        class PreparedFiles
+          attr_reader files: Array[OpenAI::Models::Beta::HostedEnvironmentFileParam::FileID]
+          attr_reader upload_ids: Array[String]
+          def initialize: (Array[Hash[Symbol, untyped]] files) -> void
+        end
+        class FilePreparationError < OpenAI::Errors::Error
+          attr_reader prepared: PreparedFiles
+          def initialize: (prepared: PreparedFiles) -> void
+        end
+
+        # @api private
+        class FilePreparation
+          def initialize: (
+            client: OpenAI::Client,
+            environment_files: OpenAI::Resources::Beta::Agents::Environments::Files
+          ) -> void
+          def prepare: (
+            Hash[String, String | Pathname] files,
+            ?request_options: OpenAI::request_opts
+          ) -> PreparedFiles
+          def prepare_directory: (
+            String | Pathname directory,
+            destination: String,
+            include: Array[String],
+            ?request_options: OpenAI::request_opts
+          ) -> PreparedFiles
+          def upload: (
+            String environment_id,
+            file: String | Pathname,
+            path: String,
+            ?request_options: OpenAI::request_opts
+          ) -> PreparedFiles
+        end
+      end
+    end
+  end
+end

data/sig/openai/helpers/beta/agents/function_tool.rbs

@@ -0,0 +1,24 @@
+module OpenAI
+  module Helpers
+    module Beta
+      module Agents
+        class FunctionTool
+          attr_reader name: String
+
+          def initialize: (
+            name: String,
+            arguments: Class,
+            ?description: String
+          ) {
+            (untyped) -> OpenAI::Helpers::Agents::tool_output
+          } -> void
+          def definition: -> Hash[Symbol, untyped]
+          def handlers: -> Hash[String, OpenAI::Helpers::Agents::tool_handler]
+          def call: (
+            String | Hash[String | Symbol, untyped]
+          ) -> OpenAI::Helpers::Agents::tool_output
+        end
+      end
+    end
+  end
+end

data/sig/openai/helpers/beta/agents/model_adapter.rbs

@@ -0,0 +1,16 @@
+module OpenAI
+  module Helpers
+    module Beta
+      module Agents
+        module ModelAdapter
+          def self.validate!: (untyped model, parameter: String) -> void
+          def self.coerce: (
+            singleton(OpenAI::BaseModel) model,
+            untyped value,
+            ?memoize: bool
+          ) -> OpenAI::BaseModel?
+        end
+      end
+    end
+  end
+end

data/sig/openai/helpers/beta/agents.rbs

@@ -0,0 +1,71 @@
+module OpenAI
+  module Helpers
+    module Beta
+      module Agents
+        class TurnResult
+          attr_reader turn: OpenAI::Models::Beta::Agents::Sessions::Turn
+          attr_reader messages: Array[OpenAI::Models::Beta::AgentSessionMessage]
+          def session_id: -> String
+          def turn_id: -> String
+          def output_text: -> String
+          def output_parsed: -> untyped
+          def parse: (
+            output_type: singleton(OpenAI::Helpers::StructuredOutput::BaseModel)
+          ) -> ParsedTurnResult
+        end
+
+        class ResultError < OpenAI::Errors::Error
+          attr_reader reason: Symbol
+          attr_reader session_id: String?
+          attr_reader turn: OpenAI::Models::Beta::Agents::Sessions::Turn?
+          attr_reader messages: Array[OpenAI::Models::Beta::AgentSessionMessage]
+          attr_reader required_actions: Array[OpenAI::Models::Beta::AgentSession::required_action
+          | Hash[Symbol, untyped]]
+          def turn_id: -> String?
+        end
+
+        # @api private
+        class ResultCollector
+          def initialize: (
+            ?session_id: String?,
+            ?handler_names: Array[String]
+          ) -> void
+          def enable: -> void
+          def observe: (
+            OpenAI::Models::Beta::agent_session_event
+            | Hash[Symbol, untyped] event
+          ) -> void
+          def stopped?: -> bool?
+          def observe_error: (StandardError error) -> void
+          def result: -> TurnResult
+        end
+
+        class ParsedTurnResult < TurnResult
+          attr_reader raw_result: TurnResult
+          attr_reader output_parsed: untyped
+        end
+
+        class OutputParseError < OpenAI::Errors::Error
+          attr_reader raw_result: TurnResult
+        end
+
+        # @api private
+        class OutputParser
+          def initialize: (
+            singleton(OpenAI::Helpers::StructuredOutput::BaseModel) model
+          ) -> void
+          def prepare_request: (Hash[Symbol, untyped] params) -> void
+          def parse: (TurnResult result) -> ParsedTurnResult
+        end
+
+        class CreationStream < OpenAI::Internal::Stream[OpenAI::Models::Beta::agent_session_event]
+          def get_final_result: -> TurnResult
+          def with_result_collection: -> self
+
+          # @api private
+          def configure_output_parser: (OutputParser? parser) -> self
+        end
+      end
+    end
+  end
+end

data/sig/openai/helpers/structured_output.rbs

@@ -0,0 +1,12 @@
+module OpenAI
+  module Helpers
+    module StructuredOutput
+      class BaseModel < OpenAI::Internal::Type::BaseModel
+        def self.optional: -> bot
+        def self.to_json_schema: -> Hash[Symbol, untyped]
+      end
+    end
+  end
+
+  class BaseModel = OpenAI::Helpers::StructuredOutput::BaseModel
+end