.Net: Add support for 'minimal' reasoning effort for {Azure}+OpenAI Connectors (#12989)

This PR resolves issue #12887 by adding support for the new 'minimal'
reasoning effort level introduced with gpt-5 models.

Interestingly enought the latest 2.3.0 version of OpenAI SDK doesn't
have a specific `ChatReasoningEffortLevel.Minimal` option, but this is
possible using a string "minimal" effort.

## Problem

Users were unable to use the new 'minimal' reasoning effort level with
GPT-5 and other reasoning models, receiving the error:
```
The provided reasoning effort 'minimal' is not supported.
```

## Solution

The fix adds support for the "minimal" string value in the
`GetEffortLevel` method within `ClientCore.ChatCompletion.cs`. The
implementation leverages OpenAI SDK implicit string conversion
capability for `ChatReasoningEffortLevel` type.

### Changes Made

1. **Updated `GetEffortLevel` method** to recognize "MINIMAL"
(case-insensitive) and convert it to
`(ChatReasoningEffortLevel)"minimal"`
2. **Added comprehensive test coverage** for the new "minimal" option in
both OpenAI and AzureOpenAI connector unit tests
3. **Updated documentation** in `OpenAIPromptExecutionSettings.cs` to
include "minimal" as a supported string value

### Usage

Users can now specify reasoning effort in multiple ways:

```csharp
// Using string (new minimal option)
var settings = new OpenAIPromptExecutionSettings 
{ 
    ReasoningEffort = "minimal" 
};

// Using existing enum values (unchanged)
var settings = new OpenAIPromptExecutionSettings 
{ 
    ReasoningEffort = ChatReasoningEffortLevel.Low 
};
```

All supported string values: `"low"`, `"medium"`, `"high"`, `"minimal"`

## Testing

- ✅ All existing tests continue to pass (471 OpenAI + 490 AzureOpenAI
tests)
- ✅ New test cases validate "minimal" support in both connectors
- ✅ Backward compatibility maintained for existing reasoning effort
values
- ✅ Invalid strings still throw appropriate `NotSupportedException`

Fixes #12887

<!-- START COPILOT CODING AGENT TIPS -->
---

✨ Let Copilot coding agent [set things up for
you](https://github.com/microsoft/semantic-kernel/issues/new?title=✨+Set+up+Copilot+instructions&body=Configure%20instructions%20for%20this%20repository%20as%20documented%20in%20%5BBest%20practices%20for%20Copilot%20coding%20agent%20in%20your%20repository%5D%28https://gh.io/copilot-coding-agent-tips%29%2E%0A%0A%3COnboard%20this%20repo%3E&assignees=copilot)
— coding agent works faster and does higher quality work when set up for
your repo.

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: rogerbarreto <19890735+rogerbarreto@users.noreply.github.com>

Author: Copilot

dotnet/src/Connectors/Connectors.AzureOpenAI.UnitTests/Services/AzureOpenAIChatCompletionServiceTests.cs

@@ -421,6 +421,7 @@ public async Task GetChatMessageContentsRequestHandlesInternalFieldsCorrectlyAsy
     [InlineData("string", "low")]
     [InlineData("string", "medium")]
     [InlineData("string", "high")]
+    [InlineData("string", "minimal")]
     [InlineData("ChatReasonEffortLevel.Low", "low")]
     [InlineData("ChatReasonEffortLevel.Medium", "medium")]
     [InlineData("ChatReasonEffortLevel.High", "high")]

dotnet/src/Connectors/Connectors.OpenAI.UnitTests/Services/OpenAIChatCompletionServiceTests.cs

@@ -1010,6 +1010,7 @@ public async Task GetChatMessageInResponseFormatsAsync(string formatType, string
     [InlineData("string", "low")]
     [InlineData("string", "medium")]
     [InlineData("string", "high")]
+    [InlineData("string", "minimal")]
     [InlineData("ChatReasonEffortLevel.Low", "low")]
     [InlineData("ChatReasonEffortLevel.Medium", "medium")]
     [InlineData("ChatReasonEffortLevel.High", "high")]

dotnet/src/Connectors/Connectors.OpenAI/Core/ClientCore.ChatCompletion.cs

@@ -557,6 +557,7 @@ protected virtual ChatCompletionOptions CreateChatCompletionOptions(
                 "LOW" => ChatReasoningEffortLevel.Low,
                 "MEDIUM" => ChatReasoningEffortLevel.Medium,
                 "HIGH" => ChatReasoningEffortLevel.High,
+                "MINIMAL" => new("minimal"),
                 _ => throw new NotSupportedException($"The provided reasoning effort '{textEffortLevel}' is not supported.")
             };
         }

dotnet/src/Connectors/Connectors.OpenAI/Settings/OpenAIPromptExecutionSettings.cs

@@ -26,7 +26,7 @@ public class OpenAIPromptExecutionSettings : PromptExecutionSettings
     /// Constrains effort on reasoning for reasoning models.
     /// Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response.
     /// Possible values are:
-    /// <para>- <see cref="string"/> values: <c>"low"</c>, <c>"medium"</c>, <c>"high"</c>;</para>
+    /// <para>- <see cref="string"/> values: <c>"low"</c>, <c>"medium"</c>, <c>"high"</c>, <c>"minimal"</c>;</para>
     /// <para>- <see cref="ChatReasoningEffortLevel"/> object;</para>
     /// </remarks>
     [JsonPropertyName("reasoning_effort")]