openai 0.99.0 → 0.101.0

data/lib/openai/resources/images.rb

@@ -104,9 +104,10 @@ module OpenAI
       #   set the output format to `png` or `webp`.
       #
       # @param input_fidelity [Symbol, OpenAI::Models::ImageEditParams::InputFidelity, 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.
       #
       # @param mask [Pathname, StringIO, IO, String, OpenAI::FilePart]
       #   An additional image whose fully transparent areas (e.g. where alpha is zero)
@@ -238,9 +239,10 @@ module OpenAI
       #   set the output format to `png` or `webp`.
       #
       # @param input_fidelity [Symbol, OpenAI::Models::ImageEditParams::InputFidelity, 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.
       #
       # @param mask [Pathname, StringIO, IO, String, OpenAI::FilePart]
       #   An additional image whose fully transparent areas (e.g. where alpha is zero)

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.99.0"
+  VERSION = "0.101.0"
 end

data/lib/openai.rb

@@ -529,6 +529,7 @@ require_relative "openai/models/beta/agents/sessions/trace_list_params"
 require_relative "openai/models/beta/agents/sessions/turn"
 require_relative "openai/models/beta/agents/sessions/turn_list_params"
 require_relative "openai/models/beta/agents/sessions/turn_retrieve_params"
+require_relative "openai/models/beta/agents/sessions/turns/item_list_params"
 require_relative "openai/models/beta/agents/session_update_params"
 require_relative "openai/models/beta/agents/vault"
 require_relative "openai/models/beta/agents/vault_create_params"
@@ -718,6 +719,7 @@ require_relative "openai/models/beta/beta_tool_choice_mcp"
 require_relative "openai/models/beta/beta_tool_choice_options"
 require_relative "openai/models/beta/beta_tool_choice_shell"
 require_relative "openai/models/beta/beta_tool_choice_types"
+require_relative "openai/models/beta/beta_tool_search_output_namespace_tool"
 require_relative "openai/models/beta/beta_tool_search_tool"
 require_relative "openai/models/beta/beta_web_search_preview_tool"
 require_relative "openai/models/beta/beta_web_search_tool"
@@ -953,6 +955,12 @@ require_relative "openai/models/conversations/summary_text_content"
 require_relative "openai/models/conversations/text_content"
 require_relative "openai/models/create_embedding_response"
 require_relative "openai/models/custom_tool_input_format"
+require_relative "openai/models/decision"
+require_relative "openai/models/decision_create_params"
+require_relative "openai/models/decision_input_image"
+require_relative "openai/models/decision_input_message"
+require_relative "openai/models/decision_input_part"
+require_relative "openai/models/decision_input_text"
 require_relative "openai/models/deleted_skill"
 require_relative "openai/models/embedding"
 require_relative "openai/models/embedding_create_params"
@@ -1363,6 +1371,7 @@ require_relative "openai/models/responses/tool_choice_mcp"
 require_relative "openai/models/responses/tool_choice_options"
 require_relative "openai/models/responses/tool_choice_shell"
 require_relative "openai/models/responses/tool_choice_types"
+require_relative "openai/models/responses/tool_search_output_namespace_tool"
 require_relative "openai/models/responses/tool_search_tool"
 require_relative "openai/models/responses/web_search_preview_tool"
 require_relative "openai/models/responses/web_search_tool"
@@ -1534,6 +1543,7 @@ require_relative "openai/resources/beta/agents/sessions/subagents/turns"
 require_relative "openai/resources/beta/agents/sessions/subagents/turns/items"
 require_relative "openai/resources/beta/agents/sessions/traces"
 require_relative "openai/resources/beta/agents/sessions/turns"
+require_relative "openai/resources/beta/agents/sessions/turns/items"
 require_relative "openai/resources/beta/agents/vaults"
 require_relative "openai/resources/beta/agents/vaults/credentials"
 require_relative "openai/resources/beta/assistants"
@@ -1557,6 +1567,7 @@ require_relative "openai/resources/containers/files/content"
 require_relative "openai/resources/content_provenance_checks"
 require_relative "openai/resources/conversations"
 require_relative "openai/resources/conversations/items"
+require_relative "openai/resources/decisions"
 require_relative "openai/resources/embeddings"
 require_relative "openai/resources/evals"
 require_relative "openai/resources/evals/runs"

data/rbi/openai/client.rbi

@@ -29,6 +29,9 @@ module OpenAI
     sig { returns(T.nilable(String)) }
     attr_reader :webhook_secret
 
+    sig { returns(OpenAI::Resources::Decisions) }
+    attr_reader :decisions
+
     # Given a prompt, the model will return one or more predicted completions, and can
     # also return the probabilities of alternative tokens at each position.
     sig { returns(OpenAI::Resources::Completions) }

data/rbi/openai/helpers/agents.rbi

@@ -56,6 +56,7 @@ module OpenAI
               session_id: String,
               input: T.any(String, T::Array[OpenAI::Models::Beta::AgentSessionInputMessageParam::OrHash]),
               tool_handlers: T::Hash[String, OpenAI::Helpers::Agents::ToolHandler],
+              on_tool_error: T.nilable(T.proc.params(failure: OpenAI::Helpers::Beta::Agents::ToolError).void),
               idempotency_key: T.nilable(String),
               output_type: T.nilable(T.class_of(OpenAI::Helpers::StructuredOutput::BaseModel)),
               request_options: T.nilable(OpenAI::RequestOptions::OrHash),
@@ -67,6 +68,7 @@ module OpenAI
             session_id,
             input:,
             tool_handlers: {},
+            on_tool_error: nil,
             idempotency_key: nil,
             output_type: nil,
             request_options: {},

data/rbi/openai/helpers/beta/agents/function_tool.rbi

@@ -13,11 +13,12 @@ module OpenAI
               name: String,
               arguments: T.class_of(OpenAI::BaseModel),
               description: String,
+              defer_loading: T.nilable(T::Boolean),
               handler: T.proc.params(arguments: T.untyped).returns(OpenAI::Helpers::Agents::ToolOutput)
             )
               .void
           end
-          def initialize(name:, arguments:, description: "", &handler)
+          def initialize(name:, arguments:, description: "", defer_loading: nil, &handler)
           end
 
           sig { returns(OpenAI::Internal::AnyHash) }
@@ -29,9 +30,13 @@ module OpenAI
           end
 
           sig {
-            params(arguments: T.any(String, OpenAI::Internal::AnyHash)).returns(OpenAI::Helpers::Agents::ToolOutput)
+            params(
+              arguments: T.any(String, OpenAI::Internal::AnyHash),
+              report_stage: T.nilable(T.proc.params(stage: Symbol).void)
+            )
+              .returns(OpenAI::Helpers::Agents::ToolOutput)
           }
-          def call(arguments)
+          def call(arguments, &report_stage)
           end
         end
       end

data/rbi/openai/helpers/beta/agents/tool_error.rbi

@@ -0,0 +1,19 @@
+# typed: strong
+
+module OpenAI
+  module Helpers
+    module Beta
+      module Agents
+        # Beta, local-only tool failure diagnostic.
+        class ToolError
+          sig { returns(StandardError) }
+          attr_reader :error
+          sig { returns(String) }
+          attr_reader :tool_name, :session_id, :turn_id, :call_id
+          sig { returns(Symbol) }
+          attr_reader :stage
+        end
+      end
+    end
+  end
+end

data/rbi/openai/helpers/beta/agents.rbi

@@ -139,6 +139,18 @@ module OpenAI
           sig { params(parser: T.nilable(OutputParser)).returns(T.self_type) }
           def configure_output_parser(parser)
           end
+
+          # @api private
+          sig do
+            params(
+              sessions: OpenAI::Resources::Beta::Agents::Sessions,
+              tool_handlers: T::Hash[String, OpenAI::Helpers::Agents::ToolHandler],
+              request_options: T.untyped
+            )
+              .returns(T.self_type)
+          end
+          def configure_tool_handlers(sessions:, tool_handlers:, request_options:)
+          end
         end
       end
     end

data/rbi/openai/models/admin/organization/usage_audio_speeches_response.rbi

@@ -194,6 +194,19 @@ module OpenAI
                 sig { returns(T.nilable(String)) }
                 attr_accessor :api_key_id
 
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                sig {
+                  returns(
+                    T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::TaggedSymbol
+                    )
+                  )
+                }
+                attr_accessor :api_source
+
                 # When `group_by=batch`, this field tells whether the grouped usage result is
                 # batch or not.
                 sig { returns(T.nilable(T::Boolean)) }
@@ -327,6 +340,10 @@ module OpenAI
 
                     api_key_id: T.nilable(String),
 
+                    api_source: T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::OrSymbol
+                    ),
+
                     batch: T.nilable(T::Boolean),
 
                     input_audio_tokens: Integer,
@@ -386,6 +403,12 @@ module OpenAI
                   # usage result.
                   api_key_id: nil,
 
+                  # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                  # activity and `unlabeled` includes all records without published source
+                  # attribution, including historical and unknown origins. Unlabeled does not imply
+                  # direct API usage. Without source grouping, this field is null.
+                  api_source: nil,
+
                   # When `group_by=batch`, this field tells whether the grouped usage result is
                   # batch or not.
                   batch: nil,
@@ -462,6 +485,9 @@ module OpenAI
                       object: Symbol,
                       output_tokens: Integer,
                       api_key_id: T.nilable(String),
+                      api_source: T.nilable(
+                        OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::TaggedSymbol
+                      ),
                       batch: T.nilable(T::Boolean),
                       input_audio_tokens: Integer,
                       input_cache_write_12h_tokens: Integer,
@@ -486,6 +512,40 @@ module OpenAI
                 def to_hash
                 end
 
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  TaggedSymbol = T.type_alias {
+                    T.all(
+                      Symbol,
+                      OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageCompletionsResult::APISource
+                    )
+                  }
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  AGENTS_API = T.let(
+                    :agents_api,
+                    OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::TaggedSymbol
+                  )
+                  UNLABELED = T.let(
+                    :unlabeled,
+                    OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::TaggedSymbol
+                  )
+
+                  sig {
+                    override.returns(
+                      T::Array[
+                        OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageCompletionsResult::APISource::TaggedSymbol
+                      ]
+                    )
+                  }
+                  def self.values
+                  end
+                end
               end
 
               class OrganizationUsageEmbeddingsResult < OpenAI::Internal::Type::BaseModel
@@ -1267,6 +1327,19 @@ module OpenAI
                 sig { returns(T.nilable(String)) }
                 attr_accessor :api_key_id
 
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                sig {
+                  returns(
+                    T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                    )
+                  )
+                }
+                attr_accessor :api_source
+
                 # When `group_by=context_level`, this field provides the search context size of
                 # the grouped usage result.
                 sig { returns(T.nilable(String)) }
@@ -1297,6 +1370,10 @@ module OpenAI
 
                     api_key_id: T.nilable(String),
 
+                    api_source: T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::OrSymbol
+                    ),
+
                     context_level: T.nilable(String),
 
                     model: T.nilable(String),
@@ -1321,6 +1398,12 @@ module OpenAI
                   # usage result.
                   api_key_id: nil,
 
+                  # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                  # activity and `unlabeled` includes all records without published source
+                  # attribution, including historical and unknown origins. Unlabeled does not imply
+                  # direct API usage. Without source grouping, this field is null.
+                  api_source: nil,
+
                   # When `group_by=context_level`, this field provides the search context size of
                   # the grouped usage result.
                   context_level: nil,
@@ -1348,6 +1431,9 @@ module OpenAI
                       num_requests: Integer,
                       object: Symbol,
                       api_key_id: T.nilable(String),
+                      api_source: T.nilable(
+                        OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                      ),
                       context_level: T.nilable(String),
                       model: T.nilable(String),
                       project_id: T.nilable(String),
@@ -1358,6 +1444,40 @@ module OpenAI
                 def to_hash
                 end
 
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  TaggedSymbol = T.type_alias {
+                    T.all(
+                      Symbol,
+                      OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource
+                    )
+                  }
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  AGENTS_API = T.let(
+                    :agents_api,
+                    OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                  )
+                  UNLABELED = T.let(
+                    :unlabeled,
+                    OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                  )
+
+                  sig {
+                    override.returns(
+                      T::Array[
+                        OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationUsageWebSearchesResult::APISource::TaggedSymbol
+                      ]
+                    )
+                  }
+                  def self.values
+                  end
+                end
               end
 
               class OrganizationCostsResult < OpenAI::Internal::Type::BaseModel
@@ -1394,6 +1514,19 @@ module OpenAI
                 sig { returns(T.nilable(String)) }
                 attr_accessor :api_key_id
 
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                sig {
+                  returns(
+                    T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult::APISource::TaggedSymbol
+                    )
+                  )
+                }
+                attr_accessor :api_source
+
                 # When `group_by=line_item`, this field provides the line item of the grouped
                 # costs result.
                 sig { returns(T.nilable(String)) }
@@ -1414,6 +1547,11 @@ module OpenAI
                 sig { returns(T.nilable(T.any(String, OpenAI::Admin::Organization::CostQuantityUnit::OrSymbol))) }
                 attr_accessor :quantity_unit
 
+                # When `group_by=user_id`, this field provides the user ID of the grouped costs
+                # result.
+                sig { returns(T.nilable(String)) }
+                attr_accessor :user_id
+
                 # The aggregated costs details of the specific time bucket.
                 sig do
                   params(
@@ -1422,6 +1560,10 @@ module OpenAI
 
                     api_key_id: T.nilable(String),
 
+                    api_source: T.nilable(
+                      OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult::APISource::OrSymbol
+                    ),
+
                     line_item: T.nilable(String),
 
                     project_id: T.nilable(String),
@@ -1430,6 +1572,8 @@ module OpenAI
 
                     quantity_unit: T.nilable(T.any(String, OpenAI::Admin::Organization::CostQuantityUnit::OrSymbol)),
 
+                    user_id: T.nilable(String),
+
                     object: Symbol
                   )
                     .returns(T.attached_class)
@@ -1443,6 +1587,12 @@ module OpenAI
                   # costs result.
                   api_key_id: nil,
 
+                  # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                  # activity and `unlabeled` includes all records without published source
+                  # attribution, including historical and unknown origins. Unlabeled does not imply
+                  # direct API usage. Without source grouping, this field is null.
+                  api_source: nil,
+
                   # When `group_by=line_item`, this field provides the line item of the grouped
                   # costs result.
                   line_item: nil,
@@ -1459,6 +1609,10 @@ module OpenAI
                   # result, this field is `null`.
                   quantity_unit: nil,
 
+                  # When `group_by=user_id`, this field provides the user ID of the grouped costs
+                  # result.
+                  user_id: nil,
+
                   object: :"organization.costs.result"
                 )
                 end
@@ -1469,10 +1623,14 @@ module OpenAI
                       object: Symbol,
                       amount: OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult::Amount,
                       api_key_id: T.nilable(String),
+                      api_source: T.nilable(
+                        OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult::APISource::TaggedSymbol
+                      ),
                       line_item: T.nilable(String),
                       project_id: T.nilable(String),
                       quantity: T.nilable(Float),
-                      quantity_unit: T.nilable(T.any(String, OpenAI::Admin::Organization::CostQuantityUnit::OrSymbol))
+                      quantity_unit: T.nilable(T.any(String, OpenAI::Admin::Organization::CostQuantityUnit::OrSymbol)),
+                      user_id: T.nilable(String)
                     }
                   )
                 end
@@ -1531,6 +1689,41 @@ module OpenAI
                   end
 
                 end
+
+                # When grouped by `api_source`, `agents_api` identifies attributed Agents API
+                # activity and `unlabeled` includes all records without published source
+                # attribution, including historical and unknown origins. Unlabeled does not imply
+                # direct API usage. Without source grouping, this field is null.
+                module APISource
+                  extend OpenAI::Internal::Type::Enum
+
+                  TaggedSymbol = T.type_alias {
+                    T.all(
+                      Symbol,
+                      OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult::APISource
+                    )
+                  }
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  AGENTS_API = T.let(
+                    :agents_api,
+                    OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult::APISource::TaggedSymbol
+                  )
+                  UNLABELED = T.let(
+                    :unlabeled,
+                    OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult::APISource::TaggedSymbol
+                  )
+
+                  sig {
+                    override.returns(
+                      T::Array[
+                        OpenAI::Models::Admin::Organization::UsageAudioSpeechesResponse::Data::Result::OrganizationCostsResult::APISource::TaggedSymbol
+                      ]
+                    )
+                  }
+                  def self.values
+                  end
+                end
               end
 
               sig {