Add x-ms-ai-sensitivity extension (#2750)

Author: LucGenetier

src/libraries/Microsoft.PowerFx.Connectors/ConnectorConstants.cs

@@ -4,6 +4,7 @@ namespace Microsoft.PowerFx.Connectors
 {
     public static class Constants
     {
+        public const string XMsAiSensitivity = "x-ms-ai-sensitivity";
         public const string XMsBodyName = "x-bodyName";
         public const string XMsCapabilities = "x-ms-capabilities";
         public const string XMsDynamicList = "x-ms-dynamic-list";
@@ -17,8 +18,8 @@ public static class Constants
         public const string XMsKeyOrder = "x-ms-keyOrder";
         public const string XMsKeyType = "x-ms-keyType";
         public const string XMsMediaKind = "x-ms-media-kind";
-        public const string XMsNotificationUrl = "x-ms-notification-url";
         public const string XMsNotificationContent = "x-ms-notification-content";
+        public const string XMsNotificationUrl = "x-ms-notification-url";
         public const string XMsPageable = "x-ms-pageable";
         public const string XMsPermission = "x-ms-permission";
         public const string XMsRelationships = "x-ms-relationships";

src/libraries/Microsoft.PowerFx.Connectors/OpenApiExtensions.cs

@@ -369,6 +369,8 @@ enumName is OpenApiString enumNameStr
 
         internal static bool? GetNotificationUrl(this ISwaggerExtensions schema) => schema.Extensions.TryGetValue(XMsNotificationUrl, out IOpenApiExtension openApiExt) && openApiExt is OpenApiBoolean openApiBool ? openApiBool.Value : null;
 
+        internal static string GetAiSensitivity(this ISwaggerExtensions schema) => schema.Extensions.TryGetValue(XMsAiSensitivity, out IOpenApiExtension openApiExt) && openApiExt is OpenApiString openApiStr ? openApiStr.Value : null;
+
         internal static (bool IsPresent, string Value) GetString(this IDictionary<string, IOpenApiAny> apiObj, string str) => apiObj.TryGetValue(str, out IOpenApiAny openApiAny) && openApiAny is OpenApiString openApiStr ? (true, openApiStr.Value) : (false, null);
 
         internal static void WhenPresent(this IDictionary<string, IOpenApiAny> apiObj, string propName, Action<string> action)
@@ -932,6 +934,15 @@ public static Visibility ToVisibility(this string visibility)
                 : Visibility.Unknown;
         }
 
+        public static AiSensitivity ToAiSensitivity(this string aiSensitivity)
+        {
+            return string.IsNullOrEmpty(aiSensitivity)
+                ? AiSensitivity.None
+                : Enum.TryParse(aiSensitivity, true, out AiSensitivity ais)
+                ? ais
+                : AiSensitivity.Unknown;
+        }
+
         public static MediaKind ToMediaKind(this string mediaKind)
         {
             return string.IsNullOrEmpty(mediaKind)

src/libraries/Microsoft.PowerFx.Connectors/Public/AiSensitivity.cs

@@ -0,0 +1,20 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+
+namespace Microsoft.PowerFx.Connectors
+{
+    public enum AiSensitivity : int
+    {
+        // "x-ms-ai-sensitivity" is not corresponding to any valid value (normally, only "low", "high")
+        Unknown = -1,
+
+        // "x-ms-ai-sensitivity" is not defined
+        None = 0,
+
+        // "x-ms-ai-sensitivity" is "low"
+        Low,
+
+        // "x-ms-ai-sensitivity" is "high"
+        High
+    }
+}

src/libraries/Microsoft.PowerFx.Connectors/Public/ConnectorSchema.cs

@@ -31,6 +31,8 @@ public class ConnectorSchema : SupportsConnectorErrors
 
         public bool? NotificationUrl => ConnectorType.NotificationUrl;
 
+        public AiSensitivity AiSensitivity => ConnectorType.AiSensitivity;
+
         internal ConnectorSchema(ISwaggerParameter openApiParameter, ISwaggerExtensions bodyExtensions, bool useHiddenTypes, ConnectorCompatibility compatibility)
         {
             Schema = openApiParameter.Schema;

src/libraries/Microsoft.PowerFx.Connectors/Public/ConnectorType.cs

@@ -76,6 +76,9 @@ public class ConnectorType : SupportsConnectorErrors
         // Supports x-ms-notification-url
         public bool? NotificationUrl { get; }
 
+        // Supports x-ms-ai-sensitivity
+        public AiSensitivity AiSensitivity { get; }
+
         internal RecordType HiddenRecordType { get; }
 
         // Supports x-ms-dynamic-values or -list locally
@@ -128,6 +131,7 @@ internal ConnectorType(ISwaggerSchema schema, ISwaggerParameter openApiParameter
             Binary = schema.Format == "binary" || schema.Format == "no_format";
             MediaKind = openApiParameter?.GetMediaKind().ToMediaKind() ?? (Binary ? MediaKind.File : MediaKind.NotBinary);
             NotificationUrl = openApiParameter?.GetNotificationUrl();
+            AiSensitivity = openApiParameter?.GetAiSensitivity().ToAiSensitivity() ?? AiSensitivity.Unknown;
 
             if (schema != null)
             {

src/tests/Microsoft.PowerFx.Connectors.Tests.Shared/Microsoft.PowerFx.Connectors.Tests.Shared.projitems

@@ -297,6 +297,7 @@
     <EmbeddedResource Include="$(MSBuildThisFileDirectory)Swagger\PetStore.json" />
     <EmbeddedResource Include="$(MSBuildThisFileDirectory)Swagger\PowerAppsForMakers.json" />
     <EmbeddedResource Include="$(MSBuildThisFileDirectory)Swagger\PowerPlatformForAdmins.json" />
+    <EmbeddedResource Include="$(MSBuildThisFileDirectory)Swagger\SendMail.json" />
     <EmbeddedResource Include="$(MSBuildThisFileDirectory)Swagger\SQL Server.json" />
     <EmbeddedResource Include="$(MSBuildThisFileDirectory)Swagger\SalesForce.json" />
     <EmbeddedResource Include="$(MSBuildThisFileDirectory)Swagger\ServiceNow.json" />

src/tests/Microsoft.PowerFx.Connectors.Tests.Shared/PowerPlatformConnectorTests.cs

@@ -1791,7 +1791,7 @@ public void ExposeInternalParamsWithoutDefaultValueTest(ConnectorCompatibility c
             {
                 Compatibility = compatibility,
                 AllowUnsupportedFunctions = true,
-                IncludeInternalFunctions = true, 
+                IncludeInternalFunctions = true,
                 IncludeWebhookFunctions = true,
                 ExposeInternalParamsWithoutDefaultValue = exposeInternalParamsWithoutDefaultValue
             };
@@ -1837,6 +1837,36 @@ public async Task SendEmail()
             Assert.Single(functions.Where(x => x.Name == "SendEmailV3"));
         }
 
+        [Fact]
+        public async Task AiSensitivityTest()
+        {
+            using LoggingTestServer testConnector = new LoggingTestServer(@"Swagger\SendMail.json", _output);
+            OpenApiDocument apiDoc = testConnector._apiDocument;            
+           
+            ConnectorSettings connectorSettings = new ConnectorSettings("exob")
+            {            
+                Compatibility = ConnectorCompatibility.SwaggerCompatibility,
+                AllowUnsupportedFunctions = true,
+                IncludeInternalFunctions = true,
+                ReturnUnknownRecordFieldsAsUntypedObjects = true                
+            };
+            
+            List<ConnectorFunction> functions = OpenApiParser.GetFunctions(connectorSettings, apiDoc).OrderBy(f => f.Name).ToList();
+
+            ConnectorFunction sendmail = functions.First(f => f.Name == "SendEmailV3");
+            IEnumerable<ConnectorParameter> parameters = sendmail.RequiredParameters.Union(sendmail.OptionalParameters);
+
+            string unknownAiSensitivity = string.Join(", ", parameters.Where(p => p.AiSensitivity == AiSensitivity.Unknown).Select(p => p.Name));
+            string noAiSensitivity = string.Join(", ", parameters.Where(p => p.AiSensitivity == AiSensitivity.None).Select(p => p.Name));
+            string lowAiSensitivity = string.Join(", ", parameters.Where(p => p.AiSensitivity == AiSensitivity.Low).Select(p => p.Name));
+            string highAiSensitivity = string.Join(", ", parameters.Where(p => p.AiSensitivity == AiSensitivity.High).Select(p => p.Name));
+
+            Assert.Equal(string.Empty, unknownAiSensitivity);
+            Assert.Equal("subject, text, toname, ccname, bccname, files, filenames", noAiSensitivity);
+            Assert.Equal(string.Empty, lowAiSensitivity);
+            Assert.Equal("to, cc, bcc", highAiSensitivity);
+        }
+
         [Fact]
         public async Task ExcelOnlineTest()
         {

src/tests/Microsoft.PowerFx.Connectors.Tests.Shared/PublicSurfaceTests.cs

@@ -26,6 +26,7 @@ public void PublicSurfaceTest_Connectors()
             var allowed = new HashSet<string>()
             {
               "Microsoft.PowerFx.ConfigExtensions",
+              "Microsoft.PowerFx.Connectors.AiSensitivity",
               "Microsoft.PowerFx.Connectors.BaseRuntimeConnectorContext",
               "Microsoft.PowerFx.Connectors.CdpDataSource",
               "Microsoft.PowerFx.Connectors.CdpExtensions",