openai 0.99.0 → 0.101.0

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/responses/tool_search_output_namespace_tool.rbi

@@ -0,0 +1,272 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Responses
+
+      class ToolSearchOutputNamespaceTool < OpenAI::Internal::Type::BaseModel
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Responses::ToolSearchOutputNamespaceTool,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        # A description of the namespace shown to the model.
+        sig { returns(String) }
+        attr_accessor :description
+
+        # The namespace name used in tool calls (for example, `crm`).
+        sig { returns(String) }
+        attr_accessor :name
+
+        # The function/custom tools loaded inside this namespace.
+        sig {
+          returns(
+            T::Array[
+              T.any(OpenAI::Responses::ToolSearchOutputNamespaceTool::Tool::Function, OpenAI::Responses::CustomTool)
+            ]
+          )
+        }
+        attr_accessor :tools
+
+        # The type of the tool. Always `namespace`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Groups function/custom tools under a shared namespace.
+        sig do
+          params(
+
+            description: String,
+
+            name: String,
+
+            tools: T::Array[
+              T.any(
+                OpenAI::Responses::ToolSearchOutputNamespaceTool::Tool::Function::OrHash,
+                OpenAI::Responses::CustomTool::OrHash
+              )
+            ],
+
+            type: Symbol
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          # A description of the namespace shown to the model.
+          description:,
+
+          # The namespace name used in tool calls (for example, `crm`).
+          name:,
+
+          # The function/custom tools loaded inside this namespace.
+          tools:,
+
+          # The type of the tool. Always `namespace`.
+
+          type: :namespace
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              description: String,
+              name: String,
+              tools: T::Array[
+                T.any(OpenAI::Responses::ToolSearchOutputNamespaceTool::Tool::Function, OpenAI::Responses::CustomTool)
+              ],
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # A function or custom tool loaded into a namespace by tool search.
+        module Tool
+          extend OpenAI::Internal::Type::Union
+
+          Variants = T.type_alias {
+            T.any(OpenAI::Responses::ToolSearchOutputNamespaceTool::Tool::Function, OpenAI::Responses::CustomTool)
+          }
+
+          class Function < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Responses::ToolSearchOutputNamespaceTool::Tool::Function,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # The name of the loaded function tool.
+            sig { returns(String) }
+            attr_accessor :name
+
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            # The tool invocation context(s).
+            sig {
+              returns(
+                T.nilable(
+                  T::Array[OpenAI::Responses::ToolSearchOutputNamespaceTool::Tool::Function::AllowedCaller::OrSymbol]
+                )
+              )
+            }
+            attr_accessor :allowed_callers
+
+            # Whether the tool response can be returned asynchronously versus immediately
+            # returned on next response creation.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_reader :async
+
+            sig { params(async: T::Boolean).void }
+            attr_writer :async
+
+            # Whether this function should be deferred and discovered via tool search.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_reader :defer_loading
+
+            sig { params(defer_loading: T::Boolean).void }
+            attr_writer :defer_loading
+
+            sig { returns(T.nilable(String)) }
+            attr_accessor :description
+
+            # A JSON Schema describing the JSON value encoded in string outputs for this
+            # function tool. This does not describe content-array outputs.
+            sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+            attr_accessor :output_schema
+
+            sig { returns(T.nilable(T.anything)) }
+            attr_accessor :parameters
+
+            # Whether to enforce strict parameter validation. If omitted, Responses attempts
+            # to use strict validation when the schema is compatible, and falls back to
+            # non-strict validation otherwise.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_accessor :strict
+
+            sig do
+              params(
+
+                name: String,
+
+                allowed_callers: T.nilable(
+                  T::Array[OpenAI::Responses::ToolSearchOutputNamespaceTool::Tool::Function::AllowedCaller::OrSymbol]
+                ),
+
+                async: T::Boolean,
+
+                defer_loading: T::Boolean,
+
+                description: T.nilable(String),
+
+                output_schema: T.nilable(T::Hash[Symbol, T.anything]),
+
+                parameters: T.nilable(T.anything),
+
+                strict: T.nilable(T::Boolean),
+
+                type: Symbol
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # The name of the loaded function tool.
+              name:,
+
+              # The tool invocation context(s).
+              allowed_callers: nil,
+
+              # Whether the tool response can be returned asynchronously versus immediately
+              # returned on next response creation.
+              async: nil,
+
+              # Whether this function should be deferred and discovered via tool search.
+              defer_loading: nil,
+
+              description: nil,
+
+              # A JSON Schema describing the JSON value encoded in string outputs for this
+              # function tool. This does not describe content-array outputs.
+              output_schema: nil,
+
+              parameters: nil,
+
+              # Whether to enforce strict parameter validation. If omitted, Responses attempts
+              # to use strict validation when the schema is compatible, and falls back to
+              # non-strict validation otherwise.
+              strict: nil,
+
+              type: :function
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  name: String,
+                  type: Symbol,
+                  allowed_callers: T.nilable(
+                    T::Array[OpenAI::Responses::ToolSearchOutputNamespaceTool::Tool::Function::AllowedCaller::OrSymbol]
+                  ),
+                  async: T::Boolean,
+                  defer_loading: T::Boolean,
+                  description: T.nilable(String),
+                  output_schema: T.nilable(T::Hash[Symbol, T.anything]),
+                  parameters: T.nilable(T.anything),
+                  strict: T.nilable(T::Boolean)
+                }
+              )
+            end
+            def to_hash
+            end
+
+            module AllowedCaller
+              extend OpenAI::Internal::Type::Enum
+
+              TaggedSymbol = T.type_alias {
+                T.all(Symbol, OpenAI::Responses::ToolSearchOutputNamespaceTool::Tool::Function::AllowedCaller)
+              }
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              DIRECT = T.let(
+                :direct,
+                OpenAI::Responses::ToolSearchOutputNamespaceTool::Tool::Function::AllowedCaller::TaggedSymbol
+              )
+              PROGRAMMATIC = T.let(
+                :programmatic,
+                OpenAI::Responses::ToolSearchOutputNamespaceTool::Tool::Function::AllowedCaller::TaggedSymbol
+              )
+
+              sig {
+                override.returns(
+                  T::Array[
+                    OpenAI::Responses::ToolSearchOutputNamespaceTool::Tool::Function::AllowedCaller::TaggedSymbol
+                  ]
+                )
+              }
+              def self.values
+              end
+            end
+          end
+
+          sig { override.returns(T::Array[OpenAI::Responses::ToolSearchOutputNamespaceTool::Tool::Variants]) }
+          def self.variants
+          end
+
+        end
+
+      end
+
+    end
+
+  end
+end

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.rbi

@@ -68,6 +68,18 @@ module OpenAI
 
   CustomToolInputFormat = OpenAI::Models::CustomToolInputFormat
 
+  Decision = OpenAI::Models::Decision
+
+  DecisionCreateParams = OpenAI::Models::DecisionCreateParams
+
+  DecisionInputImage = OpenAI::Models::DecisionInputImage
+
+  DecisionInputMessage = OpenAI::Models::DecisionInputMessage
+
+  DecisionInputPart = OpenAI::Models::DecisionInputPart
+
+  DecisionInputText = OpenAI::Models::DecisionInputText
+
   DeletedSkill = OpenAI::Models::DeletedSkill
 
   Embedding = OpenAI::Models::Embedding

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/decisions.rbi

@@ -0,0 +1,57 @@
+# typed: strong
+
+module OpenAI
+  module Resources
+
+    class Decisions
+
+      # Evaluate ordered classification and scoring questions against shared input.
+      # Answers are returned in question order.
+      #
+      # Supply input as a string or user messages containing text and inline images.
+      # Only user messages with `input_text` and `input_image` parts are supported;
+      # non-user roles, function calls, files, audio, and item references are not
+      # supported. Images require a data URL, not an external URL or file ID. At most
+      # 128 images are allowed across the request.
+      #
+      # Each question can return a refusal instead of a scored answer. A refusal has
+      # type `refusal` and the corresponding question name, or null if unnamed.
+      sig {
+        params(
+          input: OpenAI::DecisionCreateParams::Input::Variants,
+          model: String,
+          questions: T::Array[
+            T.any(
+              OpenAI::DecisionCreateParams::Question::Predicate::OrHash,
+              OpenAI::DecisionCreateParams::Question::Choice::OrHash,
+              OpenAI::DecisionCreateParams::Question::Score::OrHash
+            )
+          ],
+          safety_identifier: T.nilable(String),
+          request_options: OpenAI::RequestOptions::OrHash
+        )
+          .returns(OpenAI::Decision)
+      }
+      def create(
+        # Shared evidence, as a string or an array of user messages containing text and
+        # inline images. Non-user roles, function calls, function-call outputs, files,
+        # audio, and item references are not supported. At most 128 image parts are
+        # allowed across all messages in one request.
+        input:,
+        model:,
+        questions:,
+        # Opaque caller-provided end-user identifier, scoped by the verified org. Match
+        # Responses' limit; this is never the authenticated user identity.
+        safety_identifier: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: OpenAI::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+
+  end
+end

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,