MCP Prompt tools (Azure#11066)

* Create new tools. One for validation and one to donwload prompts

* Add response classes

* Integrate new tools to be discoverable

* Generalize prompt validation to file validation

* skip files already downloaded

* Variable declared twice

* Check if working repo is same as repo we are targerting

* remove unused variable

* When in repository all is good

Author: jeo02

tools/azsdk-cli/Azure.Sdk.Tools.Cli/Commands/SharedOptions.cs

@@ -23,6 +23,8 @@ public static class SharedOptions
             typeof(SpecWorkflowTool),
             typeof(SpecValidationTools),
             typeof(ReleaseReadinessTool),
+            typeof(FileValidationTool),
+            typeof(DownloadPromptsTool),
             typeof(SdkReleaseTool),
             #if DEBUG
             // only add this tool in debug mode

tools/azsdk-cli/Azure.Sdk.Tools.Cli/Models/Responses/DownloadResponse.cs

@@ -0,0 +1,27 @@
+using System.Text.Json.Serialization;
+
+namespace Azure.Sdk.Tools.Cli.Models;
+
+/// <summary>
+/// Response model for file download operations
+/// </summary>
+public class DownloadResponse : Response
+{
+    [JsonPropertyName("message")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
+    public string Message { get; set; } = string.Empty;
+
+    [JsonPropertyName("success")]
+    public bool Success { get; set; }
+
+    [JsonPropertyName("downloaded_count")]
+    public int DownloadedCount { get; set; }
+
+    [JsonPropertyName("total_files")]
+    public int TotalFiles { get; set; }
+
+    public override string ToString()
+    {
+        return ToString(Message);
+    }
+}

tools/azsdk-cli/Azure.Sdk.Tools.Cli/Models/Responses/ValidationResponse.cs

@@ -0,0 +1,31 @@
+using System.Text.Json.Serialization;
+
+namespace Azure.Sdk.Tools.Cli.Models;
+
+/// <summary>
+/// Response model for prompt validation operations
+/// </summary>
+public class ValidationResponse : Response
+{
+    [JsonPropertyName("message")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingDefault)]
+    public string Message { get; set; } = string.Empty;
+
+    [JsonPropertyName("is_valid")]
+    public bool IsValid { get; set; }
+
+    [JsonPropertyName("missing_count")]
+    public int MissingCount { get; set; }
+
+    [JsonPropertyName("total_source_files")]
+    public int TotalSourceFiles { get; set; }
+
+    [JsonPropertyName("missing_files")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+    public List<string>? MissingFiles { get; set; }
+
+    public override string ToString()
+    {
+        return ToString(Message);
+    }
+}

tools/azsdk-cli/Azure.Sdk.Tools.Cli/Services/GitHubService.cs

@@ -78,6 +78,7 @@ public interface IGitHubService
         public Task<List<string>> GetPullRequestCommentsAsync(string repoOwner, string repoName, int pullRequestNumber);
         public Task<PullRequest?> GetPullRequestForBranchAsync(string repoOwner, string repoName, string remoteBranch);
         public Task<Issue> GetIssueAsync(string repoOwner, string repoName, int issueNumber);
+        public Task<IReadOnlyList<RepositoryContent>?> GetContentsAsync(string owner, string repoName, string path);
     }
 
     public class GitHubService : GitConnection, IGitHubService
@@ -274,5 +275,31 @@ public async Task<Issue> GetIssueAsync(string repoOwner, string repoName, int is
         {
             return await gitHubClient.Issue.Get(repoOwner, repoName, issueNumber);
         }
+
+        /// <summary>
+        /// Helper method to get contents from a GitHub repository path.
+        /// </summary>
+        /// <param name="owner">Repository owner</param>
+        /// <param name="repoName">Repository name</param>
+        /// <param name="path">Directory or file path</param>
+        /// <param name="expectSingleFile">If true, returns only the first file content; if false, returns all contents</param>
+        /// <returns>List of repository contents or null if path doesn't exist</returns>
+        public async Task<IReadOnlyList<RepositoryContent>?> GetContentsAsync(string owner, string repoName, string path)
+        {
+            try
+            {
+                return await gitHubClient.Repository.Content.GetAllContents(owner, repoName, path);
+            }
+            catch (NotFoundException)
+            {
+                logger.LogInformation($"Path {path} not found in {owner}/{repoName}");
+                return null;
+            }
+            catch (Exception ex)
+            {
+                logger.LogError(ex, $"Error fetching contents from {owner}/{repoName}/{path}");
+                throw;
+            }
+        }
     }
 }