openai · kwhinnery-openai · May 21, 2025 · May 19, 2025 · May 21, 2025 · May 21, 2025
@@ -1,3 +1,3 @@
 {
-  ".": "1.79.0"
+  ".": "1.80.0"
 }
@@ -1,4 +1,4 @@
 configured_endpoints: 101
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-262e171d0a8150ea1192474d16ba3afdf9a054b399f1a49a9c9b697a3073c136.yml
-openapi_spec_hash: 33e00a48df8f94c94f46290c489f132b
-config_hash: d8d5fda350f6db77c784f35429741a2e
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-a5651cb97f86d1e2531af6aef8c5230f1ea350560fbae790ca2e481b30a6c217.yml
+openapi_spec_hash: 66a5104fd3bb43383cf919225df7a6fd
+config_hash: bb657c3fed232a56930035de3aaed936
@@ -1,5 +1,18 @@
 # Changelog
 
+## 1.80.0 (2025-05-21)
+
+Full Changelog: [v1.79.0...v1.80.0](https://github.com/openai/openai-python/compare/v1.79.0...v1.80.0)
+
+### Features
+
+* **api:** new API tools ([d36ae52](https://github.com/openai/openai-python/commit/d36ae528d55fe87067c4b8c6b2c947cbad5e5002))
+
+
+### Chores
+
+* **docs:** grammar improvements ([e746145](https://github.com/openai/openai-python/commit/e746145a12b5335d8841aff95c91bbbde8bae8e3))
+
 ## 1.79.0 (2025-05-16)
 
 Full Changelog: [v1.78.1...v1.79.0](https://github.com/openai/openai-python/compare/v1.78.1...v1.79.0)

@@ -16,13 +16,13 @@ before making any information public.
 ## Reporting Non-SDK Related Security Issues
 
 If you encounter security issues that are not directly related to SDKs but pertain to the services
-or products provided by OpenAI please follow the respective company's security reporting guidelines.
+or products provided by OpenAI, please follow the respective company's security reporting guidelines.
 
 ### OpenAI Terms and Policies
 
 Our Security Policy can be found at [Security Policy URL](https://openai.com/policies/coordinated-vulnerability-disclosure-policy).
 
-Please contact disclosure@openai.com for any questions or concerns regarding security of our services.
+Please contact disclosure@openai.com for any questions or concerns regarding the security of our services.
 
 ---
 

@@ -717,6 +717,10 @@ from openai.types.responses import (
     ResponseFunctionToolCallItem,
     ResponseFunctionToolCallOutputItem,
     ResponseFunctionWebSearch,
+    ResponseImageGenCallCompletedEvent,
+    ResponseImageGenCallGeneratingEvent,
+    ResponseImageGenCallInProgressEvent,
+    ResponseImageGenCallPartialImageEvent,
     ResponseInProgressEvent,
     ResponseIncludable,
     ResponseIncompleteEvent,
@@ -730,14 +734,28 @@ from openai.types.responses import (
     ResponseInputMessageItem,
     ResponseInputText,
     ResponseItem,
+    ResponseMcpCallArgumentsDeltaEvent,
+    ResponseMcpCallArgumentsDoneEvent,
+    ResponseMcpCallCompletedEvent,
+    ResponseMcpCallFailedEvent,
+    ResponseMcpCallInProgressEvent,
+    ResponseMcpListToolsCompletedEvent,
+    ResponseMcpListToolsFailedEvent,
+    ResponseMcpListToolsInProgressEvent,
     ResponseOutputAudio,
     ResponseOutputItem,
     ResponseOutputItemAddedEvent,
     ResponseOutputItemDoneEvent,
     ResponseOutputMessage,
     ResponseOutputRefusal,
     ResponseOutputText,
+    ResponseOutputTextAnnotationAddedEvent,
+    ResponseQueuedEvent,
+    ResponseReasoningDeltaEvent,
+    ResponseReasoningDoneEvent,
     ResponseReasoningItem,
+    ResponseReasoningSummaryDeltaEvent,
+    ResponseReasoningSummaryDoneEvent,
     ResponseReasoningSummaryPartAddedEvent,
     ResponseReasoningSummaryPartDoneEvent,
     ResponseReasoningSummaryTextDeltaEvent,

@@ -1,6 +1,6 @@
 [project]
 name = "openai"
-version = "1.79.0"
+version = "1.80.0"
 description = "The official Python library for the openai API"
 dynamic = ["readme"]
 license = "Apache-2.0"

@@ -59,7 +59,7 @@ def __stream__(self) -> Iterator[_T]:
             if sse.data.startswith("[DONE]"):
                 break
 
-            if sse.event is None or sse.event.startswith("response.") or sse.event.startswith('transcript.'):
+            if sse.event is None or sse.event.startswith("response.") or sse.event.startswith("transcript."):
                 data = sse.json()
                 if is_mapping(data) and data.get("error"):
                     message = None
@@ -161,7 +161,7 @@ async def __stream__(self) -> AsyncIterator[_T]:
             if sse.data.startswith("[DONE]"):
                 break
 
-            if sse.event is None or sse.event.startswith("response.") or sse.event.startswith('transcript.'):
+            if sse.event is None or sse.event.startswith("response.") or sse.event.startswith("transcript."):
                 data = sse.json()
                 if is_mapping(data) and data.get("error"):
                     message = None

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "openai"
-__version__ = "1.79.0"  # x-release-please-version
+__version__ = "1.80.0"  # x-release-please-version
@@ -65,7 +65,7 @@ async def play(
             if input.dtype == np.int16 and self.dtype == np.float32:
                 audio_content = (input.astype(np.float32) / 32767.0).reshape(-1, self.channels)
             elif input.dtype == np.float32:
-                audio_content = cast('npt.NDArray[np.float32]', input)
+                audio_content = cast("npt.NDArray[np.float32]", input)
             else:
                 raise ValueError(f"Unsupported dtype: {input.dtype}")
         else:

@@ -103,6 +103,13 @@ def parse_response(
             or output.type == "file_search_call"
             or output.type == "web_search_call"
             or output.type == "reasoning"
+            or output.type == "mcp_call"
+            or output.type == "mcp_approval_request"
+            or output.type == "image_generation_call"
+            or output.type == "code_interpreter_call"
+            or output.type == "local_shell_call"
+            or output.type == "mcp_list_tools"
+            or output.type == 'exec'
         ):
             output_list.append(output)
         elif TYPE_CHECKING:  # type: ignore

@@ -9,6 +9,7 @@
     ParsedResponse,
     ResponseErrorEvent,
     ResponseFailedEvent,
+    ResponseQueuedEvent,
     ResponseCreatedEvent,
     ResponseTextDoneEvent as RawResponseTextDoneEvent,
     ResponseAudioDoneEvent,
@@ -19,22 +20,39 @@
     ResponseInProgressEvent,
     ResponseRefusalDoneEvent,
     ResponseRefusalDeltaEvent,
+    ResponseMcpCallFailedEvent,
+    ResponseReasoningDoneEvent,
     ResponseOutputItemDoneEvent,
+    ResponseReasoningDeltaEvent,
     ResponseContentPartDoneEvent,
     ResponseOutputItemAddedEvent,
     ResponseContentPartAddedEvent,
+    ResponseMcpCallCompletedEvent,
+    ResponseMcpCallInProgressEvent,
+    ResponseMcpListToolsFailedEvent,
     ResponseAudioTranscriptDoneEvent,
     ResponseTextAnnotationDeltaEvent,
     ResponseAudioTranscriptDeltaEvent,
+    ResponseMcpCallArgumentsDoneEvent,
+    ResponseReasoningSummaryDoneEvent,
+    ResponseImageGenCallCompletedEvent,
+    ResponseMcpCallArgumentsDeltaEvent,
+    ResponseMcpListToolsCompletedEvent,
+    ResponseReasoningSummaryDeltaEvent,
+    ResponseImageGenCallGeneratingEvent,
+    ResponseImageGenCallInProgressEvent,
+    ResponseMcpListToolsInProgressEvent,
     ResponseWebSearchCallCompletedEvent,
     ResponseWebSearchCallSearchingEvent,
     ResponseFileSearchCallCompletedEvent,
     ResponseFileSearchCallSearchingEvent,
     ResponseWebSearchCallInProgressEvent,
     ResponseFileSearchCallInProgressEvent,
+    ResponseImageGenCallPartialImageEvent,
     ResponseReasoningSummaryPartDoneEvent,
     ResponseReasoningSummaryTextDoneEvent,
     ResponseFunctionCallArgumentsDoneEvent,
+    ResponseOutputTextAnnotationAddedEvent,
     ResponseReasoningSummaryPartAddedEvent,
     ResponseReasoningSummaryTextDeltaEvent,
     ResponseFunctionCallArgumentsDeltaEvent as RawResponseFunctionCallArgumentsDeltaEvent,
@@ -109,6 +127,24 @@ class ResponseCompletedEvent(RawResponseCompletedEvent, GenericModel, Generic[Te
         ResponseReasoningSummaryPartDoneEvent,
         ResponseReasoningSummaryTextDeltaEvent,
         ResponseReasoningSummaryTextDoneEvent,
+        ResponseImageGenCallCompletedEvent,
+        ResponseImageGenCallInProgressEvent,
+        ResponseImageGenCallGeneratingEvent,
+        ResponseImageGenCallPartialImageEvent,
+        ResponseMcpCallCompletedEvent,
+        ResponseMcpCallArgumentsDeltaEvent,
+        ResponseMcpCallArgumentsDoneEvent,
+        ResponseMcpCallFailedEvent,
+        ResponseMcpCallInProgressEvent,
+        ResponseMcpListToolsCompletedEvent,
+        ResponseMcpListToolsFailedEvent,
+        ResponseMcpListToolsInProgressEvent,
+        ResponseOutputTextAnnotationAddedEvent,
+        ResponseQueuedEvent,
+        ResponseReasoningDeltaEvent,
+        ResponseReasoningSummaryDeltaEvent,
+        ResponseReasoningSummaryDoneEvent,
+        ResponseReasoningDoneEvent,
     ],
     PropertyInfo(discriminator="type"),
 ]
@@ -449,7 +449,7 @@ async def create(
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
-          """
+        """
 
     @overload
     async def create(

@@ -77,6 +77,7 @@ def create(
         *,
         input: Union[str, ResponseInputParam],
         model: ResponsesModel,
+        background: Optional[bool] | NotGiven = NOT_GIVEN,
         include: Optional[List[ResponseIncludable]] | NotGiven = NOT_GIVEN,
         instructions: Optional[str] | NotGiven = NOT_GIVEN,
         max_output_tokens: Optional[int] | NotGiven = NOT_GIVEN,
@@ -132,6 +133,9 @@ def create(
               [model guide](https://platform.openai.com/docs/models) to browse and compare
               available models.
 
+          background: Whether to run the model response in the background.
+              [Learn more](https://platform.openai.com/docs/guides/background).
+
           include: Specify additional output data to include in the model response. Currently
               supported values are:
 
@@ -267,6 +271,7 @@ def create(
         input: Union[str, ResponseInputParam],
         model: ResponsesModel,
         stream: Literal[True],
+        background: Optional[bool] | NotGiven = NOT_GIVEN,
         include: Optional[List[ResponseIncludable]] | NotGiven = NOT_GIVEN,
         instructions: Optional[str] | NotGiven = NOT_GIVEN,
         max_output_tokens: Optional[int] | NotGiven = NOT_GIVEN,
@@ -328,6 +333,9 @@ def create(
               [Streaming section below](https://platform.openai.com/docs/api-reference/responses-streaming)
               for more information.
 
+          background: Whether to run the model response in the background.
+              [Learn more](https://platform.openai.com/docs/guides/background).
+
           include: Specify additional output data to include in the model response. Currently
               supported values are:
 
@@ -456,6 +464,7 @@ def create(
         input: Union[str, ResponseInputParam],
         model: ResponsesModel,
         stream: bool,
+        background: Optional[bool] | NotGiven = NOT_GIVEN,
         include: Optional[List[ResponseIncludable]] | NotGiven = NOT_GIVEN,
         instructions: Optional[str] | NotGiven = NOT_GIVEN,
         max_output_tokens: Optional[int] | NotGiven = NOT_GIVEN,
@@ -517,6 +526,9 @@ def create(
               [Streaming section below](https://platform.openai.com/docs/api-reference/responses-streaming)
               for more information.
 
+          background: Whether to run the model response in the background.
+              [Learn more](https://platform.openai.com/docs/guides/background).
+
           include: Specify additional output data to include in the model response. Currently
               supported values are:
 
@@ -644,6 +656,7 @@ def create(
         *,
         input: Union[str, ResponseInputParam],
         model: ResponsesModel,
+        background: Optional[bool] | NotGiven = NOT_GIVEN,
         include: Optional[List[ResponseIncludable]] | NotGiven = NOT_GIVEN,
         instructions: Optional[str] | NotGiven = NOT_GIVEN,
         max_output_tokens: Optional[int] | NotGiven = NOT_GIVEN,
@@ -674,6 +687,7 @@ def create(
                 {
                     "input": input,
                     "model": model,
+                    "background": background,
                     "include": include,
                     "instructions": instructions,
                     "max_output_tokens": max_output_tokens,
@@ -965,6 +979,7 @@ async def create(
         *,
         input: Union[str, ResponseInputParam],
         model: ResponsesModel,
+        background: Optional[bool] | NotGiven = NOT_GIVEN,
         include: Optional[List[ResponseIncludable]] | NotGiven = NOT_GIVEN,
         instructions: Optional[str] | NotGiven = NOT_GIVEN,
         max_output_tokens: Optional[int] | NotGiven = NOT_GIVEN,
@@ -1020,6 +1035,9 @@ async def create(
               [model guide](https://platform.openai.com/docs/models) to browse and compare
               available models.
 
+          background: Whether to run the model response in the background.
+              [Learn more](https://platform.openai.com/docs/guides/background).
+
           include: Specify additional output data to include in the model response. Currently
               supported values are:
 
@@ -1155,6 +1173,7 @@ async def create(
         input: Union[str, ResponseInputParam],
         model: ResponsesModel,
         stream: Literal[True],
+        background: Optional[bool] | NotGiven = NOT_GIVEN,
         include: Optional[List[ResponseIncludable]] | NotGiven = NOT_GIVEN,
         instructions: Optional[str] | NotGiven = NOT_GIVEN,
         max_output_tokens: Optional[int] | NotGiven = NOT_GIVEN,
@@ -1216,6 +1235,9 @@ async def create(
               [Streaming section below](https://platform.openai.com/docs/api-reference/responses-streaming)
               for more information.
 
+          background: Whether to run the model response in the background.
+              [Learn more](https://platform.openai.com/docs/guides/background).
+
           include: Specify additional output data to include in the model response. Currently
               supported values are:
 
@@ -1344,6 +1366,7 @@ async def create(
         input: Union[str, ResponseInputParam],
         model: ResponsesModel,
         stream: bool,
+        background: Optional[bool] | NotGiven = NOT_GIVEN,
         include: Optional[List[ResponseIncludable]] | NotGiven = NOT_GIVEN,
         instructions: Optional[str] | NotGiven = NOT_GIVEN,
         max_output_tokens: Optional[int] | NotGiven = NOT_GIVEN,
@@ -1405,6 +1428,9 @@ async def create(
               [Streaming section below](https://platform.openai.com/docs/api-reference/responses-streaming)
               for more information.
 
+          background: Whether to run the model response in the background.
+              [Learn more](https://platform.openai.com/docs/guides/background).
+
           include: Specify additional output data to include in the model response. Currently
               supported values are:
 
@@ -1532,6 +1558,7 @@ async def create(
         *,
         input: Union[str, ResponseInputParam],
         model: ResponsesModel,
+        background: Optional[bool] | NotGiven = NOT_GIVEN,
         include: Optional[List[ResponseIncludable]] | NotGiven = NOT_GIVEN,
         instructions: Optional[str] | NotGiven = NOT_GIVEN,
         max_output_tokens: Optional[int] | NotGiven = NOT_GIVEN,
@@ -1562,6 +1589,7 @@ async def create(
                 {
                     "input": input,
                     "model": model,
+                    "background": background,
                     "include": include,
                     "instructions": instructions,
                     "max_output_tokens": max_output_tokens,