Prepare 2.3.0 release (#581)

Author: joseharriaga

CHANGELOG.md

@@ -1,12 +1,80 @@
 # Release History
 
-## 2.3.0-beta.1 (Unreleased)
+## 2.3.0 (2025-08-01)
 
-### Other changes
+### Features Added
+
+- OpenAI.Audio:
+  - Added the `Model` property to `AudioClient`.
+  - Added constructors that can take a custom `AuthenticationPolicy` to `AudioClient`.
+- OpenAI.Batch:
+  - Added new methods to `BatchClient`:
+    - `GetBatch` and `GetBatchAsync`
+  - Added constructors that can take a custom `AuthenticationPolicy` to `BatchClient`.
+- OpenAI.Chat:
+  - Added new methods to `ChatClient`:
+    - `UpdateChatCompletion` and `UpdateChatCompletionAsync`
+    - `GetChatCompletions` and `GetChatCompletionsAsync`
+    - `GetChatCompletionMessages` and `GetChatCompletionMessagesAsync`
+  - Added the `Model` property to `ChatClient`.
+  - Added constructors that can take a custom `AuthenticationPolicy` to `ChatClient`.
+- OpenAI.Containers:
+  - Introduced the new `ContainersClient` to support the Containers API with protocol methods for the following operations:
+    - `CreateContainer` and `CreateContainerAsync`
+    - `GetContainers` and `GetContainersAsync`
+    - `GetContainer` and `GetContainerAsync`
+    - `DeleteContainer` and `DeleteContainerAsync`
+    - `CreateContainerFile` and `CreateContainerFileAsync`
+    - `GetContainerFiles` and `GetContainerFilesAsync`
+    - `GetContainerFile` and `GetContainerFileAsync`
+    - `GetContainerFileContent` and `GetContainerFileContentAsync`
+    - `DeleteContainerFile` and `DeleteContainerFileAsync`
+- OpenAI.Embeddings:
+  - Added the `Model` property to `EmbeddingClient`.
+  - Added constructors that can take a custom `AuthenticationPolicy` to `EmbeddingClient`.
+- OpenAI.Evals:
+  - Added constructors that can take a custom `AuthenticationPolicy` to `EvaluationClient`.
+- OpenAI.Files:
+  - Added constructors that can take a custom `AuthenticationPolicy` to `OpenAIFileClient`.
+- OpenAI.FineTuning:
+  - Added constructors that can take a custom `AuthenticationPolicy` to `FineTuningClient`.
+- OpenAI.Graders:
+  - Introduced the new `GraderClient` to support the Graders API with protocol methods for the following operations:
+    - `RunGrader` and `RunGraderAsync`
+    - `ValidateGrader` and `ValidateGraderAsync`
+- OpenAI.Images:
+  - Added the `Model` property to `ImageClient`.
+  - Added constructors that can take a custom `AuthenticationPolicy` to `ImageClient`.
+- OpenAI.Models:
+  - Added constructors that can take a custom `AuthenticationPolicy` to `OpenAIModelClient`.
+- OpenAI.Moderations:
+  - Added the `Model` property to `ModerationClient`.
+  - Added constructors that can take a custom `AuthenticationPolicy` to `ModerationClient`.
+- OpenAI.Realtime:
+  - Enabled support for semantic voice activity detection (VAD) via the new `CreateSemanticVoiceActivityTurnDetectionOptions` method of `TurnDetectionOptions`.
+- OpenAI.Responses:
+  - Added a model factory.
+  - Added constructors that can take a custom `AuthenticationPolicy` to `OpenAIResponseClient`.
+- OpenAI.VectorStores:
+  - Added constructors that can take a custom `AuthenticationPolicy` to `VectorStoreClient`.
+
+### Bug Fixed
+
+- OpenAI.Assistants:
+  - Fixed an issue causing the `ImageDetail` property of `MessageContent` to not be serialized correctly.
+- OpenAI.Audio:
+  - Added a check to all overloads of `TranscribeAudioStreaming` and `TranscribeAudioStreamingAsync` in the `AudioClient` to prevent using the `whisper-1` model, which does not support streaming and simply ignores the `stream` parameter.
+- OpenAI.Realtime:
+  - Improved the disposal logic in `AsyncWebsocketMessageResultEnumerator` to prevent multiple disposals.
+- OpenAI.Responses:
+  - Fixed an issue in code generation that caused the `StreamingResponseTextAnnotationAddedUpdate` class to not be generated correctly as part of the set of possible handles when streaming.
+  - Fixed an issue in code generation that caused the `Status` property of `ReasoningResponseItem` and the `ReasoningStatus` enum to not be generated correctly and lead to incorrect behavior.
+
+### Other Changes
 
-- Updated to `System.ClientModel` 1.5.1, which contains a fix for a concurrency bug which could cause some applications running on the legacy .NET Framework to experience an infinite loop while deserializing service responses.
-- Removed explicit `net6.0` target framework, as this version reached end-of-life in November, 2024 and is no longer maintained nor supported by Microsoft.  This does not prevent using the OpenAI library on .NET 6, as the runtime will fallback to the `netstandard2.0` target.
-- The NuGet package now contains signed binaries.
+- The `OpenAI` NuGet package now contains signed binaries.
+- Updated the `System.ClientModel` dependency to version 1.5.1, which contains a fix for a concurrency bug which could cause some applications running on the legacy .NET Framework to experience an infinite loop while deserializing service responses.
+- Removed the explicit `net6.0` target framework, as this version reached end-of-life in November 2024 and is no longer maintained nor supported by Microsoft. This does not prevent using the OpenAI library on .NET 6, as the runtime will fallback to the `netstandard2.0` target.
 
 ## 2.2.0 (2025-07-02)
 

scripts/Invoke-CodeGen.ps1

@@ -7,7 +7,7 @@ param(
     [string]$GitHubRepository,
 
     [Parameter(Mandatory = $false, ParameterSetName = 'GitHub')]
-    [string]$CommitHash = "1be53165a901cfdd40d20363f311e5d5fee84f7a",
+    [string]$CommitHash = "706a4fb91ea18b441723f8a57a7e2c67e3061bb6",
 
     [Parameter(Mandatory = $false, ParameterSetName = 'GitHub')]
     [string]$GitHubToken,

scripts/Test-ApiCompatibility.ps1

@@ -162,8 +162,20 @@ $repoRootPath = Join-Path $PSScriptRoot .. -Resolve
 $projectPath = Join-Path $repoRootPath "src\OpenAI.csproj"
 $releasePath = Join-Path $repoRootPath "src\bin\Release"
 
+$experimentalNamespaces = @(
+    "OpenAI.Assistants",
+    "OpenAI.Batch",
+    "OpenAI.Containers",
+    "OpenAI.Evals",
+    "OpenAI.FineTuning",
+    "OpenAI.Graders",
+    "OpenAI.Realtime",
+    "OpenAI.Responses",
+    "OpenAI.VectorStores"
+)
+
 Invoke-APICompat -ProjectPath $projectPath `
     -ReleasePath $releasePath `
     -PackageName "OpenAI" `
-    -BaselineVersion "2.1.0" `
-    -IgnoredNamespaces "OpenAI.Assistants", "OpenAI.Batch", "OpenAI.FineTuning", "OpenAI.Realtime", "OpenAI.VectorStores"
+    -BaselineVersion "2.2.0" `
+    -IgnoredNamespaces $experimentalNamespaces

src/OpenAI.csproj

@@ -8,7 +8,7 @@
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
     <Copyright>Copyright (c) 2024 OpenAI (https://openai.com)</Copyright>
 
-    <VersionPrefix>2.2.0</VersionPrefix>
+    <VersionPrefix>2.3.0</VersionPrefix>
     <VersionSuffix></VersionSuffix>
 
     <TargetFrameworks>net8.0;netstandard2.0</TargetFrameworks>