openai 0.99.0 → 0.100.0

data/rbi/openai/models/eval_create_params.rbi

@@ -1021,7 +1021,7 @@ module OpenAI
             # The name of the grader.
             name:,
 
-            # The range of the score. Defaults to `[0, 1]`.
+            # The service requires two numbers for the score range. Defaults to `[0, 1]`.
             range: nil,
 
             # The sampling parameters for the model.

data/rbi/openai/models/eval_create_response.rbi

@@ -413,7 +413,7 @@ module OpenAI
             # The name of the grader.
             name:,
 
-            # The range of the score. Defaults to `[0, 1]`.
+            # The service requires two numbers for the score range. Defaults to `[0, 1]`.
             range: nil,
 
             # The sampling parameters for the model.

data/rbi/openai/models/eval_list_response.rbi

@@ -413,7 +413,7 @@ module OpenAI
             # The name of the grader.
             name:,
 
-            # The range of the score. Defaults to `[0, 1]`.
+            # The service requires two numbers for the score range. Defaults to `[0, 1]`.
             range: nil,
 
             # The sampling parameters for the model.

data/rbi/openai/models/eval_retrieve_response.rbi

@@ -413,7 +413,7 @@ module OpenAI
             # The name of the grader.
             name:,
 
-            # The range of the score. Defaults to `[0, 1]`.
+            # The service requires two numbers for the score range. Defaults to `[0, 1]`.
             range: nil,
 
             # The sampling parameters for the model.

data/rbi/openai/models/eval_update_response.rbi

@@ -413,7 +413,7 @@ module OpenAI
             # The name of the grader.
             name:,
 
-            # The range of the score. Defaults to `[0, 1]`.
+            # The service requires two numbers for the score range. Defaults to `[0, 1]`.
             range: nil,
 
             # The sampling parameters for the model.

data/rbi/openai/models/fine_tuning/job_list_params.rbi

@@ -31,8 +31,13 @@ module OpenAI
         sig { params(limit: Integer).void }
         attr_writer :limit
 
-        # 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.
         sig { returns(T.nilable(T::Hash[Symbol, String])) }
         attr_accessor :metadata
 
@@ -57,8 +62,13 @@ module OpenAI
           # 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/models/graders/score_model_grader.rbi

@@ -33,7 +33,7 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
-        # The range of the score. Defaults to `[0, 1]`.
+        # The service requires two numbers for the score range. Defaults to `[0, 1]`.
         sig { returns(T.nilable(T::Array[Float])) }
         attr_reader :range
 
@@ -77,7 +77,7 @@ module OpenAI
           # The name of the grader.
           name:,
 
-          # The range of the score. Defaults to `[0, 1]`.
+          # The service requires two numbers for the score range. Defaults to `[0, 1]`.
           range: nil,
 
           # The sampling parameters for the model.

data/rbi/openai/models/image_edit_params.rbi

@@ -47,9 +47,10 @@ module OpenAI
       sig { returns(T.nilable(OpenAI::ImageEditParams::Background::OrSymbol)) }
       attr_accessor :background
 
-      # 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.
       sig { returns(T.nilable(OpenAI::ImageEditParams::InputFidelity::OrSymbol)) }
       attr_accessor :input_fidelity
 
@@ -201,9 +202,10 @@ module OpenAI
         # 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)
@@ -348,9 +350,10 @@ module OpenAI
         end
       end
 
-      # 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.
       module InputFidelity
         extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/realtime/session_update_event.rbi

@@ -49,6 +49,22 @@ module OpenAI
         # fields that are present in the `session.update` are updated. To clear a field
         # like `instructions`, pass an empty string. To clear a field like `tools`, pass
         # an empty array. To clear a field like `turn_detection`, pass `null`.
+        #
+        # To turn off input audio noise reduction, send this Realtime event:
+        #
+        # ```json
+        # {
+        #   "type": "session.update",
+        #   "session": {
+        #     "type": "realtime",
+        #     "audio": { "input": { "noise_reduction": null } }
+        #   }
+        # }
+        # ```
+        #
+        # For a transcription session, use `"type":"transcription"` inside `session`.
+        # Omitting `audio.input.noise_reduction` from an update leaves its current setting
+        # unchanged.
         sig do
           params(
 

data/rbi/openai/models/responses/response_computer_tool_call_output_item.rbi

@@ -14,7 +14,7 @@ module OpenAI
           )
         end
 
-        # The unique ID of the computer call tool output.
+        # The ID of the computer tool call output.
         sig { returns(String) }
         attr_accessor :id
 
@@ -85,7 +85,7 @@ module OpenAI
         end
         def self.new(
 
-          # The unique ID of the computer call tool output.
+          # The ID of the computer tool call output.
           id:,
 
           # The ID of the computer tool call that produced the output.

data/rbi/openai/models/responses/response_error.rbi

@@ -137,6 +137,11 @@ module OpenAI
           }
           attr_writer :error_type
 
+          # An opaque target for explicitly continuing this review, or null when
+          # unavailable.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :review_target
+
           # An optional public continuation instruction.
           sig { returns(T.nilable(OpenAI::Responses::ResponseError::Misalignment::Steer)) }
           attr_reader :steer
@@ -151,6 +156,8 @@ module OpenAI
 
               error_type: T.any(String, OpenAI::Responses::ResponseError::Misalignment::ErrorType::OrSymbol),
 
+              review_target: T.nilable(String),
+
               steer: OpenAI::Responses::ResponseError::Misalignment::Steer::OrHash
             )
               .returns(T.attached_class)
@@ -163,6 +170,10 @@ module OpenAI
             # An optional classification; clients must accept additional values.
             error_type: nil,
 
+            # An opaque target for explicitly continuing this review, or null when
+            # unavailable.
+            review_target: nil,
+
             # An optional public continuation instruction.
 
             steer: nil
@@ -174,6 +185,7 @@ module OpenAI
               {
                 detailed_explanation: String,
                 error_type: OpenAI::Responses::ResponseError::Misalignment::ErrorType::Variants,
+                review_target: T.nilable(String),
                 steer: OpenAI::Responses::ResponseError::Misalignment::Steer
               }
             )

data/rbi/openai/models/responses/responses_server_event.rbi

@@ -4614,6 +4614,11 @@ module OpenAI
               }
               attr_writer :error_type
 
+              # An opaque target for explicitly continuing this review, or null when
+              # unavailable.
+              sig { returns(T.nilable(String)) }
+              attr_accessor :review_target
+
               # An optional public continuation instruction.
               sig {
                 returns(T.nilable(OpenAI::Responses::ResponsesServerEvent::ResponseWsError::Error::Misalignment::Steer))
@@ -4638,6 +4643,8 @@ module OpenAI
                     OpenAI::Responses::ResponsesServerEvent::ResponseWsError::Error::Misalignment::ErrorType::OrSymbol
                   ),
 
+                  review_target: T.nilable(String),
+
                   steer: OpenAI::Responses::ResponsesServerEvent::ResponseWsError::Error::Misalignment::Steer::OrHash
                 )
                   .returns(T.attached_class)
@@ -4650,6 +4657,10 @@ module OpenAI
                 # An optional classification; clients must accept additional values.
                 error_type: nil,
 
+                # An opaque target for explicitly continuing this review, or null when
+                # unavailable.
+                review_target: nil,
+
                 # An optional public continuation instruction.
 
                 steer: nil
@@ -4663,6 +4674,7 @@ module OpenAI
                     error_type: T.nilable(
                       OpenAI::Responses::ResponsesServerEvent::ResponseWsError::Error::Misalignment::ErrorType::Variants
                     ),
+                    review_target: T.nilable(String),
                     steer: T.nilable(
                       OpenAI::Responses::ResponsesServerEvent::ResponseWsError::Error::Misalignment::Steer
                     )

data/rbi/openai/models/responses/tool.rbi

@@ -977,9 +977,10 @@ module OpenAI
           sig { params(background: OpenAI::Responses::Tool::ImageGeneration::Background::OrSymbol).void }
           attr_writer :background
 
-          # 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.
           sig { returns(T.nilable(OpenAI::Responses::Tool::ImageGeneration::InputFidelity::OrSymbol)) }
           attr_accessor :input_fidelity
 
@@ -1104,9 +1105,10 @@ module OpenAI
             # 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,
 
             # Optional mask for inpainting. Contains `image_url` (string, optional) and
@@ -1219,9 +1221,10 @@ module OpenAI
             end
           end
 
-          # 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.
           module InputFidelity
             extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/video_create_error.rbi

@@ -99,6 +99,11 @@ module OpenAI
         sig { params(error_type: T.any(String, OpenAI::VideoCreateError::Misalignment::ErrorType::OrSymbol)).void }
         attr_writer :error_type
 
+        # An opaque target for explicitly continuing this review, or null when
+        # unavailable.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :review_target
+
         # An optional public continuation instruction.
         sig { returns(T.nilable(OpenAI::VideoCreateError::Misalignment::Steer)) }
         attr_reader :steer
@@ -113,6 +118,8 @@ module OpenAI
 
             error_type: T.any(String, OpenAI::VideoCreateError::Misalignment::ErrorType::OrSymbol),
 
+            review_target: T.nilable(String),
+
             steer: OpenAI::VideoCreateError::Misalignment::Steer::OrHash
           )
             .returns(T.attached_class)
@@ -125,6 +132,10 @@ module OpenAI
           # An optional classification; clients must accept additional values.
           error_type: nil,
 
+          # An opaque target for explicitly continuing this review, or null when
+          # unavailable.
+          review_target: nil,
+
           # An optional public continuation instruction.
 
           steer: nil
@@ -136,6 +147,7 @@ module OpenAI
             {
               detailed_explanation: String,
               error_type: OpenAI::VideoCreateError::Misalignment::ErrorType::Variants,
+              review_target: T.nilable(String),
               steer: OpenAI::VideoCreateError::Misalignment::Steer
             }
           )

data/rbi/openai/resources/admin/organization/usage.rbi

@@ -179,8 +179,10 @@ module OpenAI
             # End time (Unix seconds) of the query time range, exclusive.
             end_time: nil,
             # Group the usage data by the specified fields. Support fields include
-            # `project_id`, `user_id`, `api_key_id`, `model`, `batch`, `service_tier` or any
-            # combination of them.
+            # `project_id`, `user_id`, `api_key_id`, `model`, `batch`, `service_tier`,
+            # `api_source` or any combination of them. When grouped by `api_source`, results
+            # use `agents_api` for attributed Agents API activity and `unlabeled` for all
+            # other activity. Without source grouping, `api_source` is null.
             group_by: nil,
             # Specifies the number of buckets to return.
             #
@@ -227,8 +229,13 @@ module OpenAI
             bucket_width: nil,
             # End time (Unix seconds) of the query time range, exclusive.
             end_time: nil,
-            # Group the costs by the specified fields. Support fields include `project_id`,
-            # `line_item`, `api_key_id` and any combination of them.
+            # Group the costs by the specified fields. Supported fields include `project_id`,
+            # `user_id`, `line_item`, `api_key_id`, and `api_source`. Support for combining
+            # `user_id` with `project_id` grouping or the `project_ids` filter depends on the
+            # organization and requested time range. Unsupported combinations return HTTP 400.
+            # When grouped by `api_source`, results use `agents_api` for attributed Agents API
+            # activity and `unlabeled` for all other activity. Without source grouping,
+            # `api_source` is null.
             group_by: nil,
             # A limit on the number of buckets to be returned. Limit can range between 1 and
             # 180, and the default is 7.
@@ -522,8 +529,10 @@ module OpenAI
             # End time (Unix seconds) of the query time range, exclusive.
             end_time: nil,
             # Group the usage data by the specified fields. Support fields include
-            # `project_id`, `user_id`, `api_key_id`, `model`, `context_level` or any
-            # combination of them.
+            # `project_id`, `user_id`, `api_key_id`, `model`, `context_level`, `api_source` or
+            # any combination of them. When grouped by `api_source`, results use `agents_api`
+            # for attributed Agents API activity and `unlabeled` for all other activity.
+            # Without source grouping, `api_source` is null.
             group_by: nil,
             # Specifies the number of buckets to return.
             #

data/rbi/openai/resources/beta/agents/environments/templates.rbi

@@ -57,8 +57,8 @@ module OpenAI
               files: nil,
               # An optional human-readable display name for the template.
               name: nil,
-              # Network access policy for the environment. Defaults to disabled for GA requests
-              # and enabled for beta requests.
+              # Network access policy for the environment. If omitted, the API version
+              # determines whether network access is enabled or disabled.
               network: nil,
               # Packages to install in the environment. Defaults to empty package lists.
               packages: nil,
@@ -136,8 +136,7 @@ module OpenAI
               # A replacement human-readable display name, or `null` to clear the name.
               name: nil,
               # Network access available after setup completes. Omit to preserve the current
-              # policy, or pass `null` to reset to disabled for GA requests or enabled for beta
-              # requests.
+              # policy, or pass `null` to reset to the default policy.
               network: nil,
               # Packages installed before the runtime network policy applies.
               packages: nil,

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

@@ -101,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,
@@ -220,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,

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