Add plugin generation for openAI

Author: Andrew Omondi

Diff for: src/Kiota.Builder/Plugins/PluginsGenerationService.cs

@@ -74,10 +74,17 @@ public async Task GenerateManifestAsync(CancellationToken cancellationToken = de
                     var apiManifest = new ApiManifestDocument("application"); //TODO add application name
                     // pass empty config hash so that its not included in this manifest.
                     apiManifest.ApiDependencies.AddOrReplace(Configuration.ClientClassName, Configuration.ToApiDependency(string.Empty, TreeNode?.GetRequestInfo().ToDictionary(static x => x.Key, static x => x.Value) ?? [], WorkingDirectory));
+                    var publisherName = string.IsNullOrEmpty(OAIDocument.Info?.Contact?.Name)
+                        ? DefaultContactName
+                        : OAIDocument.Info.Contact.Name;
+                    var publisherEmail = string.IsNullOrEmpty(OAIDocument.Info?.Contact?.Email)
+                        ? DefaultContactEmail
+                        : OAIDocument.Info.Contact.Email;
+                    apiManifest.Publisher = new Publisher(publisherName, publisherEmail);
                     apiManifest.Write(writer);
                     break;
                 case PluginType.OpenAI:
-                    var pluginDocumentV1 = GetV1ManifestDocument();
+                    var pluginDocumentV1 = GetV1ManifestDocument(descriptionRelativePath);
                     pluginDocumentV1.Write(writer);
                     break;
                 default:
@@ -86,24 +93,24 @@ public async Task GenerateManifestAsync(CancellationToken cancellationToken = de
             await writer.FlushAsync(cancellationToken).ConfigureAwait(false);
         }
     }
-    private PluginManifestDocument GetV1ManifestDocument()
+    private PluginManifestDocument GetV1ManifestDocument(string openApiDocumentPath)
     {
         var descriptionForHuman = OAIDocument.Info?.Description.CleanupXMLString() is string d && !string.IsNullOrEmpty(d) ? d : $"Description for {OAIDocument.Info?.Title.CleanupXMLString()}";
         var manifestInfo = ExtractInfoFromDocument(OAIDocument.Info);
         return new PluginManifestDocument
         {
             SchemaVersion = "v1",
             NameForHuman = OAIDocument.Info?.Title.CleanupXMLString(),
-            // TODO name for model ???
+            NameForModel = OAIDocument.Info?.Title.CleanupXMLString(),
             DescriptionForHuman = descriptionForHuman,
             DescriptionForModel = manifestInfo.DescriptionForModel ?? descriptionForHuman,
             Auth = new V1AnonymousAuth(),
             Api = new Api()
             {
                 Type = ApiType.openapi,
-                URL = Configuration.OpenAPIFilePath
+                URL = openApiDocumentPath
             },
-            ContactEmail = OAIDocument.Info?.Contact?.Email,
+            ContactEmail = manifestInfo.ContactEmail,
             LogoUrl = manifestInfo.LogoUrl,
             LegalInfoUrl = manifestInfo.LegalUrl,
         };
@@ -118,10 +125,10 @@ private PluginManifestDocument GetManifestDocument(string openApiDocumentPath)
         {
             SchemaVersion = "v2",
             NameForHuman = OAIDocument.Info?.Title.CleanupXMLString(),
-            // TODO name for model ???
+            NameForModel = OAIDocument.Info?.Title.CleanupXMLString(),
             DescriptionForHuman = descriptionForHuman,
             DescriptionForModel = manifestInfo.DescriptionForModel ?? descriptionForHuman,
-            ContactEmail = OAIDocument.Info?.Contact?.Email,
+            ContactEmail = manifestInfo.ContactEmail,
             Namespace = Configuration.ClientClassName,
             LogoUrl = manifestInfo.LogoUrl,
             LegalInfoUrl = manifestInfo.LegalUrl,
@@ -150,6 +157,9 @@ private static OpenApiManifestInfo ExtractInfoFromDocument(OpenApiInfo? openApiI
         string? legalUrl = null;
         string? logoUrl = null;
         string? privacyUrl = null;
+        string contactEmail = string.IsNullOrEmpty(openApiInfo.Contact?.Email)
+            ? DefaultContactEmail
+            : openApiInfo.Contact.Email;
 
         if (openApiInfo.Extensions.TryGetValue(OpenApiDescriptionForModelExtension.Name, out var descriptionExtension) &&
             descriptionExtension is OpenApiDescriptionForModelExtension extension &&
@@ -162,11 +172,12 @@ descriptionExtension is OpenApiDescriptionForModelExtension extension &&
         if (openApiInfo.Extensions.TryGetValue(OpenApiPrivacyPolicyUrlExtension.Name, out var privacyExtension) && privacyExtension is OpenApiPrivacyPolicyUrlExtension privacy)
             privacyUrl = privacy.Privacy;
 
-        return new OpenApiManifestInfo(descriptionForModel, legalUrl, logoUrl, privacyUrl);
+        return new OpenApiManifestInfo(descriptionForModel, legalUrl, logoUrl, privacyUrl, contactEmail);
 
     }
-
-    private sealed record OpenApiManifestInfo(string? DescriptionForModel = null, string? LegalUrl = null, string? LogoUrl = null, string? PrivacyUrl = null);
+    private const string DefaultContactName = "publisher-name";
+    private const string DefaultContactEmail = "[email protected]";
+    private sealed record OpenApiManifestInfo(string? DescriptionForModel = null, string? LegalUrl = null, string? LogoUrl = null, string? PrivacyUrl = null, string ContactEmail = DefaultContactEmail);
     private static (OpenApiRuntime[], Function[]) GetRuntimesAndFunctionsFromTree(OpenApiUrlTreeNode currentNode, string openApiDocumentPath)
     {
         var runtimes = new List<OpenApiRuntime>();

Diff for: tests/Kiota.Builder.Tests/Plugins/PluginsGenerationServiceTests.cs

@@ -78,14 +78,26 @@ public async Task GeneratesManifest()
 
         Assert.True(File.Exists(Path.Combine(outputDirectory, ManifestFileName)));
         Assert.True(File.Exists(Path.Combine(outputDirectory, "client-apimanifest.json")));
-        Assert.True(File.Exists(Path.Combine(outputDirectory, "openai-plugins.json")));
+        Assert.True(File.Exists(Path.Combine(outputDirectory, OpenAIPluginFileName)));
         Assert.True(File.Exists(Path.Combine(outputDirectory, OpenApiFileName)));
+
+        // Validate the v2 plugin
         var manifestContent = await File.ReadAllTextAsync(Path.Combine(outputDirectory, ManifestFileName));
         using var jsonDocument = JsonDocument.Parse(manifestContent);
         var resultingManifest = PluginManifestDocument.Load(jsonDocument.RootElement);
+        Assert.NotNull(resultingManifest.Document);
         Assert.Equal(OpenApiFileName, resultingManifest.Document.Runtimes.OfType<OpenApiRuntime>().First().Spec.Url);
         Assert.Empty(resultingManifest.Problems);
+
+        // Validate the v1 plugin
+        var v1ManifestContent = await File.ReadAllTextAsync(Path.Combine(outputDirectory, OpenAIPluginFileName));
+        using var v1JsonDocument = JsonDocument.Parse(v1ManifestContent);
+        var v1Manifest = PluginManifestDocument.Load(v1JsonDocument.RootElement);
+        Assert.NotNull(resultingManifest.Document);
+        Assert.Equal(OpenApiFileName, v1Manifest.Document.Api.URL);
+        Assert.Empty(v1Manifest.Problems);
     }
     private const string ManifestFileName = "client-microsoft.json";
+    private const string OpenAIPluginFileName = "openai-plugins.json";
     private const string OpenApiFileName = "client-openapi.yml";
 }