openai 0.98.0 → 0.100.0

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
 
@@ -1051,9 +1052,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.
           sig { returns(T.nilable(T.any(String, OpenAI::Responses::Tool::ImageGeneration::Size::OrSymbol))) }
           attr_reader :size
 
@@ -1106,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
@@ -1151,9 +1151,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.
             size: nil,
 
             # The type of the image generation tool. Always `image_generation`.
@@ -1223,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
 
@@ -1408,9 +1407,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.
           module Size
             extend OpenAI::Internal::Type::Union
 

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/models/webhooks/agent_session_action_required_webhook_event.rbi

@@ -0,0 +1,222 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Webhooks
+
+      class AgentSessionActionRequiredWebhookEvent < OpenAI::Internal::Type::BaseModel
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        # The unique ID of the event.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # The Unix timestamp, in seconds, when the event was created.
+        sig { returns(Integer) }
+        attr_accessor :created_at
+
+        sig { returns(OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data) }
+        attr_reader :data
+
+        sig { params(data: OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::OrHash).void }
+        attr_writer :data
+
+        # The object type. Always `event`.
+        sig { returns(Symbol) }
+        attr_accessor :object
+
+        # The event type. Always `agent.session.action_required`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Sent when an agent session requires an action. Retrieve the session for action
+        # details.
+        sig do
+          params(
+
+            id: String,
+
+            created_at: Integer,
+
+            data: OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::OrHash,
+
+            object: Symbol,
+
+            type: Symbol
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          # The unique ID of the event.
+          id:,
+
+          # The Unix timestamp, in seconds, when the event was created.
+          created_at:,
+
+          data:,
+
+          # The object type. Always `event`.
+          object: :event,
+
+          # The event type. Always `agent.session.action_required`.
+
+          type: :"agent.session.action_required"
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              created_at: Integer,
+              data: OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data,
+              object: Symbol,
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Data < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # The ID of the session.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # The action type. Retrieve the session for action details.
+          sig { returns(OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction) }
+          attr_reader :required_action
+
+          sig {
+            params(
+              required_action: OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction::OrHash
+            )
+              .void
+          }
+          attr_writer :required_action
+
+          sig do
+            params(
+
+              id: String,
+
+              required_action: OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction::OrHash
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # The ID of the session.
+            id:,
+
+            # The action type. Retrieve the session for action details.
+
+            required_action:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                required_action: OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class RequiredAction < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            sig {
+              returns(
+                OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction::Type::TaggedSymbol
+              )
+            }
+            attr_accessor :type
+
+            # The action type. Retrieve the session for action details.
+            sig do
+              params(
+
+                type: OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction::Type::OrSymbol
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              type:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  type: OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction::Type::TaggedSymbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            module Type
+              extend OpenAI::Internal::Type::Enum
+
+              TaggedSymbol = T.type_alias {
+                T.all(Symbol, OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction::Type)
+              }
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              COMPUTER_USE_APPROVAL_REQUEST = T.let(
+                :computer_use_approval_request,
+                OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction::Type::TaggedSymbol
+              )
+              FUNCTION_CALL = T.let(
+                :function_call,
+                OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction::Type::TaggedSymbol
+              )
+              ENVIRONMENT_CONNECTION = T.let(
+                :environment_connection,
+                OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction::Type::TaggedSymbol
+              )
+
+              sig {
+                override.returns(
+                  T::Array[
+                    OpenAI::Webhooks::AgentSessionActionRequiredWebhookEvent::Data::RequiredAction::Type::TaggedSymbol
+                  ]
+                )
+              }
+              def self.values
+              end
+            end
+          end
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/webhooks/agent_session_created_webhook_event.rbi

@@ -0,0 +1,202 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Webhooks
+
+      class AgentSessionCreatedWebhookEvent < OpenAI::Internal::Type::BaseModel
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Webhooks::AgentSessionCreatedWebhookEvent,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        # The unique ID of the event.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # The Unix timestamp, in seconds, when the event was created.
+        sig { returns(Integer) }
+        attr_accessor :created_at
+
+        sig { returns(OpenAI::Webhooks::AgentSessionCreatedWebhookEvent::Data) }
+        attr_reader :data
+
+        sig { params(data: OpenAI::Webhooks::AgentSessionCreatedWebhookEvent::Data::OrHash).void }
+        attr_writer :data
+
+        # The object type. Always `event`.
+        sig { returns(Symbol) }
+        attr_accessor :object
+
+        # The event type. Always `agent.session.created`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Sent when an agent session is created.
+        sig do
+          params(
+
+            id: String,
+
+            created_at: Integer,
+
+            data: OpenAI::Webhooks::AgentSessionCreatedWebhookEvent::Data::OrHash,
+
+            object: Symbol,
+
+            type: Symbol
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          # The unique ID of the event.
+          id:,
+
+          # The Unix timestamp, in seconds, when the event was created.
+          created_at:,
+
+          data:,
+
+          # The object type. Always `event`.
+          object: :event,
+
+          # The event type. Always `agent.session.created`.
+
+          type: :"agent.session.created"
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              created_at: Integer,
+              data: OpenAI::Webhooks::AgentSessionCreatedWebhookEvent::Data,
+              object: Symbol,
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Data < OpenAI::Internal::Type::BaseModel
+          OrHash = T.type_alias do
+            T.any(
+              OpenAI::Webhooks::AgentSessionCreatedWebhookEvent::Data,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+          # The ID of the session.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # The environment type: `none`, `openai_hosted`, or `self_hosted`.
+          sig { returns(String) }
+          attr_accessor :environment_type
+
+          sig { returns(T.nilable(OpenAI::Webhooks::AgentSessionCreatedWebhookEvent::Data::Connect)) }
+          attr_reader :connect
+
+          sig { params(connect: OpenAI::Webhooks::AgentSessionCreatedWebhookEvent::Data::Connect::OrHash).void }
+          attr_writer :connect
+
+          # The ID of the environment, when one exists.
+          sig { returns(T.nilable(String)) }
+          attr_reader :environment_id
+
+          sig { params(environment_id: String).void }
+          attr_writer :environment_id
+
+          sig do
+            params(
+
+              id: String,
+
+              environment_type: String,
+
+              connect: OpenAI::Webhooks::AgentSessionCreatedWebhookEvent::Data::Connect::OrHash,
+
+              environment_id: String
+            )
+              .returns(T.attached_class)
+          end
+          def self.new(
+
+            # The ID of the session.
+            id:,
+
+            # The environment type: `none`, `openai_hosted`, or `self_hosted`.
+            environment_type:,
+
+            connect: nil,
+
+            # The ID of the environment, when one exists.
+
+            environment_id: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                environment_type: String,
+                connect: OpenAI::Webhooks::AgentSessionCreatedWebhookEvent::Data::Connect,
+                environment_id: String
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class Connect < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Webhooks::AgentSessionCreatedWebhookEvent::Data::Connect,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # The URL used to connect the self-hosted environment.
+            sig { returns(String) }
+            attr_accessor :remote_url
+
+            sig do
+              params(
+
+                remote_url: String
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # The URL used to connect the self-hosted environment.
+
+              remote_url:
+            )
+            end
+
+            sig do
+              override.returns(
+                {remote_url: String}
+              )
+            end
+            def to_hash
+            end
+
+          end
+        end
+
+      end
+
+    end
+
+  end
+end