openai 0.98.0 → 0.100.0

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

@@ -0,0 +1,62 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+
+    class Beta
+
+      class Agents
+
+        class Sessions
+
+          class Turns
+
+            class Items
+
+              # Lists items belonging to one root-agent turn, including its interactions with
+              # subagents. See
+              # [inspecting agent output](https://developers.openai.com/api/docs/guides/agents-api/observability).
+              sig {
+                params(
+                  turn_id: String,
+                  session_id: String,
+                  after: String,
+                  limit: Integer,
+                  order: OpenAI::Beta::Agents::Sessions::Turns::ItemListParams::Order::OrSymbol,
+                  request_options: OpenAI::RequestOptions::OrHash
+                )
+                  .returns(OpenAI::Internal::ConversationCursorPage[OpenAI::Beta::AgentSessionItem::Variants])
+              }
+              def list(
+                # Path param: The ID of the turn.
+                turn_id,
+                # Path param: The ID of the session that owns the turn.
+                session_id:,
+                # Query param: Return items after this cursor in the selected order. Pass the
+                # previous response's last_id, which can differ from the last item's ID.
+                after: nil,
+                # Query param: The maximum number of resources to return, between 1 and 100.
+                # Defaults to 20.
+                limit: nil,
+                # Query param: The order in which resources are returned. Defaults to `desc`.
+                order: 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
+
+  end
+end

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

@@ -11,6 +11,9 @@ module OpenAI
 
           class Turns
 
+            sig { returns(OpenAI::Resources::Beta::Agents::Sessions::Turns::Items) }
+            attr_reader :items
+
             # Retrieves a turn's current status, timestamps, usage, and error. Returns 404 if
             # the turn does not belong to the session. See
             # [session turns](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage#inspect-session-turns).

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

@@ -91,6 +91,7 @@ module OpenAI
               ),
               agent: OpenAI::Beta::Agents::SessionCreateParams::Agent::OrHash,
               agent_id: String,
+              tool_handlers: T::Hash[String, OpenAI::Helpers::Agents::ToolHandler],
               output_type: T.nilable(T.class_of(OpenAI::Helpers::StructuredOutput::BaseModel)),
               input: T.nilable(OpenAI::Beta::Agents::SessionCreateParams::Input::Variants),
               metadata: T.nilable(T::Hash[Symbol, String]),
@@ -109,6 +110,7 @@ module OpenAI
             # The ID of a saved reusable agent. Omit `agent` to use its configuration
             # unchanged.
             agent_id: nil,
+            tool_handlers: {},
             output_type: nil,
             # Initial input to submit when the session is created. A string is shorthand for a
             # single user message. Required when `environment.type` is `none`, or when

data/rbi/openai/resources/fine_tuning/jobs.rbi

@@ -130,8 +130,13 @@ module OpenAI
           after: nil,
           # Number of fine-tuning jobs to retrieve.
           limit: nil,
-          # Optional metadata filter. To filter, use the syntax `metadata[k]=v`.
-          # Alternatively, set `metadata=null` to indicate no metadata.
+          # Optional metadata filter. To filter, use the syntax `metadata[k]=v`. Omitting
+          # the parameter or passing an empty object applies no metadata filter. An empty
+          # value, such as `metadata[k]=`, filters for that key with an empty string value.
+          # To select jobs with null metadata, send the literal query string
+          # `metadata=null`. Nullable caller types do not specify how a client serializes
+          # null for a deep-object parameter. Use a raw query parameter if the client omits
+          # null. Do not combine the two query forms.
           metadata: nil,
           request_options: {}
         )

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,
@@ -102,9 +101,10 @@ 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,
-        # Controls fidelity to the original input image(s). This parameter is supported
-        # for GPT image models that support input fidelity. `gpt-image-2` and
-        # `gpt-image-2-2026-04-21` ignore this parameter.
+        # Control how much effort the model will exert to match the style and features,
+        # especially facial features, of input images. Supports `high` and `low` on
+        # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
+        # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
         input_fidelity: nil,
         # An additional image whose fully transparent areas (e.g. where alpha is zero)
         # indicate where `image` should be edited. If there are multiple images provided,
@@ -115,12 +115,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 +143,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 +172,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 +204,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,
@@ -228,9 +221,10 @@ 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,
-        # Controls fidelity to the original input image(s). This parameter is supported
-        # for GPT image models that support input fidelity. `gpt-image-2` and
-        # `gpt-image-2-2026-04-21` ignore this parameter.
+        # Control how much effort the model will exert to match the style and features,
+        # especially facial features, of input images. Supports `high` and `low` on
+        # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
+        # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
         input_fidelity: nil,
         # An additional image whose fully transparent areas (e.g. where alpha is zero)
         # indicate where `image` should be edited. If there are multiple images provided,
@@ -241,12 +235,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 +263,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 +291,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 +315,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 +327,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 +360,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 +373,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 +391,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 +415,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 +427,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 +460,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 +473,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/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

@@ -35,6 +35,9 @@ module OpenAI
             | Array[OpenAI::Beta::AgentSessionInputMessageParam
             | Hash[Symbol, untyped]],
             ?tool_handlers: Hash[String, OpenAI::Helpers::Agents::tool_handler],
+            ?on_tool_error: (^(
+              OpenAI::Helpers::Beta::Agents::ToolError
+            ) -> void)?,
             ?idempotency_key: String?,
             ?output_type: singleton(OpenAI::Helpers::StructuredOutput::BaseModel)?,
             ?request_options: OpenAI::RequestOptions

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

@@ -8,7 +8,8 @@ module OpenAI
           def initialize: (
             name: String,
             arguments: Class,
-            ?description: String
+            ?description: String,
+            ?defer_loading: bool?
           ) {
             (untyped) -> OpenAI::Helpers::Agents::tool_output
           } -> void
@@ -16,7 +17,9 @@ module OpenAI
           def handlers: -> Hash[String, OpenAI::Helpers::Agents::tool_handler]
           def call: (
             String | Hash[String | Symbol, untyped]
-          ) -> OpenAI::Helpers::Agents::tool_output
+          ) ?{
+            (:arguments | :execution) -> void
+          } -> OpenAI::Helpers::Agents::tool_output
         end
       end
     end

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

@@ -0,0 +1,17 @@
+module OpenAI
+  module Helpers
+    module Beta
+      module Agents
+        # Beta, local-only tool failure diagnostic.
+        class ToolError
+          attr_reader error: StandardError
+          attr_reader tool_name: String
+          attr_reader session_id: String
+          attr_reader turn_id: String
+          attr_reader call_id: String
+          attr_reader stage: :arguments | :execution | :output
+        end
+      end
+    end
+  end
+end

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

@@ -64,6 +64,11 @@ module OpenAI
 
           # @api private
           def configure_output_parser: (OutputParser? parser) -> self
+          def configure_tool_handlers: (
+            sessions: OpenAI::Resources::Beta::Agents::Sessions,
+            tool_handlers: Hash[String, OpenAI::Helpers::Agents::tool_handler],
+            request_options: untyped
+          ) -> self
         end
       end
     end