Beta3 update (Azure#52884)

Author: rhurey

sdk/ai/Azure.AI.VoiceLive/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Release History
 
-## 1.0.0-beta.3 (Unreleased)
+## 1.0.0-beta.3 (2025-09-26)
 
 ### Features Added
 
@@ -20,175 +20,175 @@
 
 ### Breaking Changes
 
-### Type Changes from Enums to Extensible Enums
+#### Type Changes from Enums to Extensible Enums
 
 Several enum types have been converted to extensible enums (struct-based) for better extensibility:
 
-### AnimationOutputType
+#### AnimationOutputType
 - **Before**: `enum AnimationOutputType`
 - **After**: `readonly partial struct AnimationOutputType`
 - **Impact**: The type is now an extensible enum. Existing code using the enum values will continue to work due to implicit conversions.
 
-### AudioNoiseReductionType
+#### AudioNoiseReductionType
 - **Before**: `enum AudioNoiseReductionType`
 - **After**: `readonly partial struct AudioNoiseReductionType`
 - **Impact**: The type is now an extensible enum. Existing code using the enum values will continue to work due to implicit conversions.
 
-### ItemParamStatus
+#### ItemParamStatus
 - **Before**: `enum ItemParamStatus`
 - **After**: `readonly partial struct ItemParamStatus`
 - **Impact**: The type is now an extensible enum. Existing code using the enum values will continue to work due to implicit conversions.
 
-### ResponseCancelledDetailsReason
+#### ResponseCancelledDetailsReason
 - **Before**: `enum ResponseCancelledDetailsReason`
 - **After**: `readonly partial struct ResponseCancelledDetailsReason`
 - **Impact**: The type is now an extensible enum. Existing code using the enum values will continue to work due to implicit conversions.
 
-### ResponseIncompleteDetailsReason
+#### ResponseIncompleteDetailsReason
 - **Before**: `enum ResponseIncompleteDetailsReason`
 - **After**: `readonly partial struct ResponseIncompleteDetailsReason`
 - **Impact**: The type is now an extensible enum. Existing code using the enum values will continue to work due to implicit conversions.
 
-## Class and Property Renames
+#### Class and Property Renames
 
-### AudioInputTranscriptionSettings → AudioInputTranscriptionOptions
+#### AudioInputTranscriptionSettings → AudioInputTranscriptionOptions
 - **Type renamed**: `AudioInputTranscriptionSettings` is now `AudioInputTranscriptionOptions`
 - **Model property renamed**: `AudioInputTranscriptionSettingsModel` is now `AudioInputTranscriptionOptionsModel`
 - **Impact**: Update all references to use the new type name.
 
-### InputModality → InteractionModality
+#### InputModality → InteractionModality
 - **Type renamed**: `InputModality` is now `InteractionModality`
 - **Impact**: Update all references from `InputModality` to `InteractionModality` throughout your code.
 
-### ResponseMaxOutputTokensOption → MaxResponseOutputTokensOption
+#### ResponseMaxOutputTokensOption → MaxResponseOutputTokensOption
 - **Type renamed**: `ResponseMaxOutputTokensOption` is now `MaxResponseOutputTokensOption`
 - **Impact**: Update all type references to use the new name.
 
-### Removed Types
+#### Removed Types
 
-### UserContentPart (abstract base class)
+#### UserContentPart (abstract base class)
 - **Removed**: The abstract `UserContentPart` class has been removed.
 - **Replacement**: Use the new `MessageContentPart` abstract base class instead.
 - **Impact**: Update inheritance hierarchies to use `MessageContentPart`.
 
-### AzureSemanticEnEouDetection
+#### AzureSemanticEnEouDetection
 - **Removed**: This class has been removed.
 - **Replacement**: Use `AzureSemanticEouDetectionEn` instead.
 
-### AzureSemanticMultilingualEouDetection
+#### AzureSemanticMultilingualEouDetection
 - **Removed**: This class has been removed.
 - **Replacement**: Use `AzureSemanticEouDetectionMultilingual` instead.
 
-### AzureSemanticVadEnTurnDetection
+#### AzureSemanticVadEnTurnDetection
 - **Removed**: This class has been removed.
 - **Replacement**: Use `AzureSemanticVadTurnDetectionEn` instead.
 
-### AzureSemanticVadMultilingualTurnDetection
+#### AzureSemanticVadMultilingualTurnDetection
 - **Removed**: This class has been removed.
 - **Replacement**: Use `AzureSemanticVadTurnDetectionMultilingual` instead.
 
-### Property Removals
+#### Property Removals
 
-### AnimationOptions
+#### AnimationOptions
 - **Removed properties**:
   - `EmotionDetectionInterval`
   - `EmotionDetectionIntervalMs`
 - **Impact**: Remove any code that sets or reads these properties.
 
-### AzureSemanticEouDetection family
+#### AzureSemanticEouDetection family
 - **Changed property**: `Threshold` (float) has been replaced with `ThresholdLevel` using new threshold level types:
   - `AzureSemanticDetectionThresholdLevel` for `AzureSemanticEouDetection`
   - `AzureSemanticDetectionEnThresholdLevel` for `AzureSemanticEouDetectionEn`
   - `AzureSemanticDetectionMultilingualThresholdLevel` for `AzureSemanticEouDetectionMultilingual`
 - **Impact**: Update code to use the new `ThresholdLevel` property with appropriate enum values (Default, Low, Medium, High).
 
-### Constructor and Method Signature Changes
+#### Constructor and Method Signature Changes
 
-### MessageItem
+#### MessageItem
 - **Constructor changed**:
   - **Before**: `MessageItem(string role)`
   - **After**: `MessageItem(ResponseMessageRole role, IEnumerable<MessageContentPart> content)`
 - **Impact**: Update all MessageItem instantiations to provide both role and content parameters.
 
-### AssistantMessageItem
+#### AssistantMessageItem
 - **Constructor changed**:
   - **Before**: Accepted `OutputTextContentPart` or `IEnumerable<OutputTextContentPart>`
   - **After**: Accepts `MessageContentPart`, `IEnumerable<MessageContentPart>`, or a string
 - **Property changed**: `Content` is now `IList<MessageContentPart>` instead of `IList<OutputTextContentPart>`
 
-### SystemMessageItem
+#### SystemMessageItem
 - **Constructor changed**:
   - **Before**: Accepted `InputTextContentPart` or `IEnumerable<InputTextContentPart>`
   - **After**: Accepts `InputTextContentPart`, `IEnumerable<MessageContentPart>`, or a string
 - **Property changed**: `Content` is now part of base `MessageItem` as `IList<MessageContentPart>`
 
-### UserMessageItem
+#### UserMessageItem
 - **Constructor changed**:
   - **Before**: Accepted `UserContentPart` or `IEnumerable<UserContentPart>`
   - **After**: Accepts `InputTextContentPart`, `IEnumerable<MessageContentPart>`, or a string
 - **Property changed**: `Content` is now part of base `MessageItem` as `IList<MessageContentPart>`
 
-### ToolChoiceOption
+#### ToolChoiceOption
 - **Constructor parameter renamed**:
   - **Before**: `ToolChoiceOption(string stringValue)`
   - **After**: `ToolChoiceOption(string functionName)`
 - **Impact**: The parameter name has changed, but functionality remains the same.
 
-### Service Version Changes
+#### Service Version Changes
 
-### VoiceLiveClientOptions
+#### VoiceLiveClientOptions
 - **Default service version changed**:
   - **Before**: `ServiceVersion.V2025_05_01_Preview`
   - **After**: `ServiceVersion.V2025_10_01`
 - **Impact**: The client now defaults to a newer, non-preview API version.
 
-### Class Inheritance Changes
+#### Class Inheritance Changes
 
-### VoiceLiveClientOptions
+#### VoiceLiveClientOptions
 - **Before**: Inherited from `Azure.Core.ClientOptions`
 - **After**: No longer inherits from `ClientOptions`, but provides a `DiagnosticsOptions` property
 - **Impact**: Some properties previously available through inheritance may need to be accessed differently.
 
-### Content Part Classes
+#### Content Part Classes
 - `InputAudioContentPart`: Now inherits from `MessageContentPart` instead of `UserContentPart`
 - `InputTextContentPart`: Now inherits from `MessageContentPart` instead of `UserContentPart`
 - `OutputTextContentPart`: Now inherits from `MessageContentPart` instead of being standalone
 
-### New Required Properties
+#### New Required Properties
 
-### Turn Detection Classes
+#### Turn Detection Classes
 Several turn detection classes have new properties that should be considered:
 - `CreateResponse` (bool?): Added to `ServerVadTurnDetection`, `AzureSemanticVadTurnDetection`, and related classes
 - `InterruptResponse` (bool?): Added to the same turn detection classes
 
-### VideoParams
+#### VideoParams
 - New optional properties:
   - `Background` (VideoBackground): Configure video background settings
   - `GopSize` (int?): Configure Group of Pictures size
 
-### Property Access Changes
+#### Property Access Changes
 
-### VoiceLiveClient
+#### VoiceLiveClient
 - **Removed**: `Pipeline` property is no longer publicly accessible
 - **Impact**: If you were accessing the HTTP pipeline directly, you'll need to find alternative approaches.
 
-### VoiceLiveResponse
+#### VoiceLiveResponse
 - **Property changed**: `Modalities` is now `ModalitiesInternal` and returns `IList<InteractionModality>` instead of `SessionUpdateModality`
 
-### Authentication Changes
+#### Authentication Changes
 
-### VoiceLiveClient Authentication Scope
+#### VoiceLiveClient Authentication Scope
 - **Authentication scope changed**: The default authentication scope has been updated from `https://cognitiveservices.azure.com/.default` to `https://ai.azure.com/.default`
 - **Impact**: This change should be transparent for most users, but custom authentication implementations may need adjustment.
 
-### Class Inheritance and Interface Implementation Changes
+#### Class Inheritance and Interface Implementation Changes
 
-### AzureSemanticEouDetectionEn and AzureSemanticEouDetectionMultilingual
+#### AzureSemanticEouDetectionEn and AzureSemanticEouDetectionMultilingual
 - **Before**: These classes were incomplete and did not properly inherit from base classes
 - **After**: Both classes now properly inherit from `EouDetection` and implement full serialization interfaces
 - **Impact**: These classes are now fully functional and consistent with the API pattern
 
-### Migration Guide
+#### Migration Guide
 
 1. **Update enum usage**: While the conversion to extensible enums maintains backward compatibility through implicit conversions, consider updating to use the new struct-based pattern for future-proofing.
 
@@ -205,8 +205,6 @@ Several turn detection classes have new properties that should be considered:
 
 6. **Consider new properties**: Review the new `CreateResponse` and `InterruptResponse` properties in turn detection configurations to see if they benefit your use case.
 
-### Bugs Fixed
-
 ### Other Changes
 
 - Updated README examples to use new `InteractionModality` instead of `InputModality`