Add record support for unauthorized result

Author: localden

samples/ProtectedMCPClient/BasicOAuthAuthorizationProvider.cs

@@ -78,15 +78,15 @@ public BasicOAuthAuthorizationProvider(
     }
 
     /// <inheritdoc />
-    public async Task<(bool Success, string? RecommendedScheme)> HandleUnauthorizedResponseAsync(
+    public async Task<McpUnauthorizedResponseResult> HandleUnauthorizedResponseAsync(
         HttpResponseMessage response, 
         string scheme,
         CancellationToken cancellationToken = default)
     {
         // This provider only supports Bearer scheme
         if (scheme != "Bearer")
         {
-            return (false, null);
+            return new McpUnauthorizedResponseResult(false, null);
         }
 
         try
@@ -111,17 +111,17 @@ public BasicOAuthAuthorizationProvider(
                     if (token != null)
                     {
                         _token = token;
-                        return (true, "Bearer");
+                        return new McpUnauthorizedResponseResult(true, "Bearer");
                     }
                 }
             }
 
-            return (false, null);
+            return new McpUnauthorizedResponseResult(false, null);
         }
         catch (Exception ex)
         {
             Console.WriteLine($"Error handling auth challenge: {ex.Message}");
-            return (false, null);
+            return new McpUnauthorizedResponseResult(false, null);
         }
     }
 

src/ModelContextProtocol/Authentication/ITokenProvider.cs

@@ -38,10 +38,10 @@ public interface ITokenProvider
     /// <param name="scheme">The authentication scheme that was used when the unauthorized response was received.</param>
     /// <param name="cancellationToken">A token to cancel the operation.</param>
     /// <returns>
-    /// A tuple containing a boolean indicating if the provider was able to handle the unauthorized response,
-    /// and the authentication scheme that should be used for the next attempt.
+    /// A result object indicating if the provider was able to handle the unauthorized response,
+    /// and the authentication scheme that should be used for the next attempt, if any.
     /// </returns>
-    Task<(bool Success, string? RecommendedScheme)> HandleUnauthorizedResponseAsync(
+    Task<McpUnauthorizedResponseResult> HandleUnauthorizedResponseAsync(
         HttpResponseMessage response, 
         string scheme,
         CancellationToken cancellationToken = default);

src/ModelContextProtocol/Authentication/McpUnauthorizedResponseResult.cs

@@ -0,0 +1,8 @@
+namespace ModelContextProtocol.Authentication;
+
+/// <summary>
+/// Represents the result of handling an unauthorized response from a resource.
+/// </summary>
+/// <param name="Success">Indicates if the provider was able to handle the unauthorized response.</param>
+/// <param name="RecommendedScheme">The authentication scheme that should be used for the next attempt, if any.</param>
+public record McpUnauthorizedResponseResult(bool Success, string? RecommendedScheme);