feat(api): new API tools

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 99
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-d51538ac955164de98b0c94a0a4718d96623fe39bf31a1d168be06c93c94e645.yml
-openapi_spec_hash: 33e00a48df8f94c94f46290c489f132b
-config_hash: c42d37618b8628ce7e1c76437db5dd8f
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-a5651cb97f86d1e2531af6aef8c5230f1ea350560fbae790ca2e481b30a6c217.yml
+openapi_spec_hash: 66a5104fd3bb43383cf919225df7a6fd
+config_hash: bb657c3fed232a56930035de3aaed936

lib/openai.rb

@@ -367,6 +367,10 @@
 require_relative "openai/models/responses/response_function_tool_call_item"
 require_relative "openai/models/responses/response_function_tool_call_output_item"
 require_relative "openai/models/responses/response_function_web_search"
+require_relative "openai/models/responses/response_image_gen_call_completed_event"
+require_relative "openai/models/responses/response_image_gen_call_generating_event"
+require_relative "openai/models/responses/response_image_gen_call_in_progress_event"
+require_relative "openai/models/responses/response_image_gen_call_partial_image_event"
 require_relative "openai/models/responses/response_includable"
 require_relative "openai/models/responses/response_incomplete_event"
 require_relative "openai/models/responses/response_in_progress_event"
@@ -381,14 +385,28 @@
 require_relative "openai/models/responses/response_input_text"
 require_relative "openai/models/responses/response_item"
 require_relative "openai/models/responses/response_item_list"
+require_relative "openai/models/responses/response_mcp_call_arguments_delta_event"
+require_relative "openai/models/responses/response_mcp_call_arguments_done_event"
+require_relative "openai/models/responses/response_mcp_call_completed_event"
+require_relative "openai/models/responses/response_mcp_call_failed_event"
+require_relative "openai/models/responses/response_mcp_call_in_progress_event"
+require_relative "openai/models/responses/response_mcp_list_tools_completed_event"
+require_relative "openai/models/responses/response_mcp_list_tools_failed_event"
+require_relative "openai/models/responses/response_mcp_list_tools_in_progress_event"
 require_relative "openai/models/responses/response_output_audio"
 require_relative "openai/models/responses/response_output_item"
 require_relative "openai/models/responses/response_output_item_added_event"
 require_relative "openai/models/responses/response_output_item_done_event"
 require_relative "openai/models/responses/response_output_message"
 require_relative "openai/models/responses/response_output_refusal"
 require_relative "openai/models/responses/response_output_text"
+require_relative "openai/models/responses/response_output_text_annotation_added_event"
+require_relative "openai/models/responses/response_queued_event"
+require_relative "openai/models/responses/response_reasoning_delta_event"
+require_relative "openai/models/responses/response_reasoning_done_event"
 require_relative "openai/models/responses/response_reasoning_item"
+require_relative "openai/models/responses/response_reasoning_summary_delta_event"
+require_relative "openai/models/responses/response_reasoning_summary_done_event"
 require_relative "openai/models/responses/response_reasoning_summary_part_added_event"
 require_relative "openai/models/responses/response_reasoning_summary_part_done_event"
 require_relative "openai/models/responses/response_reasoning_summary_text_delta_event"

lib/openai/models/responses/response.rb

@@ -78,7 +78,7 @@ class Response < OpenAI::Internal::Type::BaseModel
         #     an `assistant` message with the content generated by the model, you might
         #     consider using the `output_text` property where supported in SDKs.
         #
-        #   @return [Array<OpenAI::Responses::ResponseOutputMessage, OpenAI::Responses::ResponseFileSearchToolCall, OpenAI::Responses::ResponseFunctionToolCall, OpenAI::Responses::ResponseFunctionWebSearch, OpenAI::Responses::ResponseComputerToolCall, OpenAI::Responses::ResponseReasoningItem>]
+        #   @return [Array<OpenAI::Responses::ResponseOutputMessage, OpenAI::Responses::ResponseFileSearchToolCall, OpenAI::Responses::ResponseFunctionToolCall, OpenAI::Responses::ResponseFunctionWebSearch, OpenAI::Responses::ResponseComputerToolCall, OpenAI::Responses::ResponseReasoningItem, OpenAI::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Responses::ResponseCodeInterpreterToolCall, OpenAI::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Responses::ResponseOutputItem::McpCall, OpenAI::Responses::ResponseOutputItem::McpListTools, OpenAI::Responses::ResponseOutputItem::McpApprovalRequest>]
         required :output, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseOutputItem] }
 
         # @!attribute parallel_tool_calls
@@ -120,7 +120,7 @@ class Response < OpenAI::Internal::Type::BaseModel
         #     the model to call your own code. Learn more about
         #     [function calling](https://platform.openai.com/docs/guides/function-calling).
         #
-        #   @return [Array<OpenAI::Responses::FileSearchTool, OpenAI::Responses::FunctionTool, OpenAI::Responses::ComputerTool, OpenAI::Responses::WebSearchTool>]
+        #   @return [Array<OpenAI::Responses::FunctionTool, OpenAI::Responses::FileSearchTool, OpenAI::Responses::ComputerTool, OpenAI::Responses::Tool::Mcp, OpenAI::Responses::Tool::CodeInterpreter, OpenAI::Responses::Tool::ImageGeneration, OpenAI::Responses::Tool::LocalShell, OpenAI::Responses::WebSearchTool>]
         required :tools, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::Tool] }
 
         # @!attribute top_p
@@ -133,6 +133,13 @@ class Response < OpenAI::Internal::Type::BaseModel
         #   @return [Float, nil]
         required :top_p, Float, nil?: true
 
+        # @!attribute background
+        #   Whether to run the model response in the background.
+        #   [Learn more](https://platform.openai.com/docs/guides/background).
+        #
+        #   @return [Boolean, nil]
+        optional :background, OpenAI::Internal::Type::Boolean, nil?: true
+
         # @!attribute max_output_tokens
         #   An upper bound for the number of tokens that can be generated for a response,
         #   including visible output tokens and
@@ -182,7 +189,7 @@ class Response < OpenAI::Internal::Type::BaseModel
 
         # @!attribute status
         #   The status of the response generation. One of `completed`, `failed`,
-        #   `in_progress`, or `incomplete`.
+        #   `in_progress`, `cancelled`, `queued`, or `incomplete`.
         #
         #   @return [Symbol, OpenAI::Responses::ResponseStatus, nil]
         optional :status, enum: -> { OpenAI::Responses::ResponseStatus }
@@ -224,7 +231,7 @@ class Response < OpenAI::Internal::Type::BaseModel
         #   @return [String, nil]
         optional :user, String
 
-        # @!method initialize(id:, created_at:, error:, incomplete_details:, instructions:, metadata:, model:, output:, parallel_tool_calls:, temperature:, tool_choice:, tools:, top_p:, max_output_tokens: nil, previous_response_id: nil, reasoning: nil, service_tier: nil, status: nil, text: nil, truncation: nil, usage: nil, user: nil, object: :response)
+        # @!method initialize(id:, created_at:, error:, incomplete_details:, instructions:, metadata:, model:, output:, parallel_tool_calls:, temperature:, tool_choice:, tools:, top_p:, background: nil, max_output_tokens: nil, previous_response_id: nil, reasoning: nil, service_tier: nil, status: nil, text: nil, truncation: nil, usage: nil, user: nil, object: :response)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Responses::Response} for more details.
         #
@@ -242,18 +249,20 @@ class Response < OpenAI::Internal::Type::BaseModel
         #
         #   @param model [String, Symbol, OpenAI::ChatModel, OpenAI::ResponsesModel::ResponsesOnlyModel] Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI
         #
-        #   @param output [Array<OpenAI::Responses::ResponseOutputMessage, OpenAI::Responses::ResponseFileSearchToolCall, OpenAI::Responses::ResponseFunctionToolCall, OpenAI::Responses::ResponseFunctionWebSearch, OpenAI::Responses::ResponseComputerToolCall, OpenAI::Responses::ResponseReasoningItem>] An array of content items generated by the model.
+        #   @param output [Array<OpenAI::Responses::ResponseOutputMessage, OpenAI::Responses::ResponseFileSearchToolCall, OpenAI::Responses::ResponseFunctionToolCall, OpenAI::Responses::ResponseFunctionWebSearch, OpenAI::Responses::ResponseComputerToolCall, OpenAI::Responses::ResponseReasoningItem, OpenAI::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Responses::ResponseCodeInterpreterToolCall, OpenAI::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Responses::ResponseOutputItem::McpCall, OpenAI::Responses::ResponseOutputItem::McpListTools, OpenAI::Responses::ResponseOutputItem::McpApprovalRequest>] An array of content items generated by the model.
         #
         #   @param parallel_tool_calls [Boolean] Whether to allow the model to run tool calls in parallel.
         #
         #   @param temperature [Float, nil] What sampling temperature to use, between 0 and 2. Higher values like 0.8 will m
         #
         #   @param tool_choice [Symbol, OpenAI::Responses::ToolChoiceOptions, OpenAI::Responses::ToolChoiceTypes, OpenAI::Responses::ToolChoiceFunction] How the model should select which tool (or tools) to use when generating
         #
-        #   @param tools [Array<OpenAI::Responses::FileSearchTool, OpenAI::Responses::FunctionTool, OpenAI::Responses::ComputerTool, OpenAI::Responses::WebSearchTool>] An array of tools the model may call while generating a response. You
+        #   @param tools [Array<OpenAI::Responses::FunctionTool, OpenAI::Responses::FileSearchTool, OpenAI::Responses::ComputerTool, OpenAI::Responses::Tool::Mcp, OpenAI::Responses::Tool::CodeInterpreter, OpenAI::Responses::Tool::ImageGeneration, OpenAI::Responses::Tool::LocalShell, OpenAI::Responses::WebSearchTool>] An array of tools the model may call while generating a response. You
         #
         #   @param top_p [Float, nil] An alternative to sampling with temperature, called nucleus sampling,
         #
+        #   @param background [Boolean, nil] Whether to run the model response in the background.
+        #
         #   @param max_output_tokens [Integer, nil] An upper bound for the number of tokens that can be generated for a response, in
         #
         #   @param previous_response_id [String, nil] The unique ID of the previous response to the model. Use this to

lib/openai/models/responses/response_code_interpreter_tool_call.rb

@@ -37,7 +37,13 @@ class ResponseCodeInterpreterToolCall < OpenAI::Internal::Type::BaseModel
         #   @return [Symbol, :code_interpreter_call]
         required :type, const: :code_interpreter_call
 
-        # @!method initialize(id:, code:, results:, status:, type: :code_interpreter_call)
+        # @!attribute container_id
+        #   The ID of the container used to run the code.
+        #
+        #   @return [String, nil]
+        optional :container_id, String
+
+        # @!method initialize(id:, code:, results:, status:, container_id: nil, type: :code_interpreter_call)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Responses::ResponseCodeInterpreterToolCall} for more details.
         #
@@ -51,9 +57,11 @@ class ResponseCodeInterpreterToolCall < OpenAI::Internal::Type::BaseModel
         #
         #   @param status [Symbol, OpenAI::Responses::ResponseCodeInterpreterToolCall::Status] The status of the code interpreter tool call.
         #
+        #   @param container_id [String] The ID of the container used to run the code.
+        #
         #   @param type [Symbol, :code_interpreter_call] The type of the code interpreter tool call. Always `code_interpreter_call`.
 
-        # The output of a code interpreter tool call that is text.
+        # The output of a code interpreter tool.
         module Result
           extend OpenAI::Internal::Type::Union