chore: import upstream snapshot with attribution

dotnet/samples/Demos/ModelContextProtocolClientServer/MCPServer/Tools/DateTimeUtils.cs

@@ -0,0 +1,22 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using System.ComponentModel;
+using Microsoft.SemanticKernel;
+
+namespace MCPServer.Tools;
+
+/// <summary>
+/// A collection of utility methods for working with date time.
+/// </summary>
+internal sealed class DateTimeUtils
+{
+    /// <summary>
+    /// Retrieves the current date time in UTC.
+    /// </summary>
+    /// <returns>The current date time in UTC.</returns>
+    [KernelFunction, Description("Retrieves the current date time in UTC.")]
+    public static string GetCurrentDateTimeInUtc()
+    {
+        return DateTime.UtcNow.ToString("yyyy-MM-dd HH:mm:ss");
+    }
+}

dotnet/samples/Demos/ModelContextProtocolClientServer/MCPServer/Tools/MailboxUtils.cs

@@ -0,0 +1,126 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using MCPServer.ProjectResources;
+using Microsoft.SemanticKernel;
+using ModelContextProtocol.Protocol;
+using ModelContextProtocol.Server;
+
+namespace MCPServer.Tools;
+
+/// <summary>
+/// A collection of utility methods for working with mailbox.
+/// </summary>
+internal sealed class MailboxUtils
+{
+    /// <summary>
+    /// Summarizes unread emails in the mailbox by using MCP sampling
+    /// mechanism for summarization.
+    /// </summary>
+    [KernelFunction]
+    public static async Task<string> SummarizeUnreadEmailsAsync([FromKernelServices] McpServer server)
+    {
+        if (server.ClientCapabilities?.Sampling is null)
+        {
+            throw new InvalidOperationException("The client does not support sampling.");
+        }
+
+        // Create two sample emails with attachments
+        var email1 = new Email
+        {
+            Sender = "sales.report@example.com",
+            Subject = "Carretera Sales Report - Jan & Jun 2014",
+            Body = "Hi there, I hope this email finds you well! Please find attached the sales report for the first half of 2014. " +
+                   "Please review the report and provide your feedback today, if possible." +
+                   "By the way, we're having a BBQ this Saturday at my place, and you're welcome to join. Let me know if you can make it!",
+            Attachments = [EmbeddedResource.ReadAsBytes("SalesReport2014.png")]
+        };
+
+        var email2 = new Email
+        {
+            Sender = "hr.department@example.com",
+            Subject = "Employee Birthdays and Positions",
+            Body = "Attached is the list of employee birthdays and their positions. Please check it and let me know of any updates by tomorrow." +
+                   "Also, we're planning a hike this Sunday morning. It would be great if you could join us. Let me know if you're interested!",
+            Attachments = [EmbeddedResource.ReadAsBytes("EmployeeBirthdaysAndPositions.png")]
+        };
+
+        CreateMessageRequestParams request = new()
+        {
+            SystemPrompt = "You are a helpful assistant. You will be provided with a list of emails. Please summarize them. Each email is followed by its attachments.",
+            Messages = CreateMessagesFromEmails(email1, email2),
+            Temperature = 0
+        };
+
+        // Send the sampling request to the client to summarize the emails
+        CreateMessageResult result = await server.SampleAsync(request, cancellationToken: CancellationToken.None);
+
+        // Assuming the response is a text message
+        return (result.Content as TextContentBlock)!.Text;
+    }
+
+    /// <summary>
+    /// Creates a list of SamplingMessage objects from a list of emails.
+    /// </summary>
+    /// <param name="emails">The list of emails.</param>
+    /// <returns>A list of SamplingMessage objects.</returns>
+    private static List<SamplingMessage> CreateMessagesFromEmails(params Email[] emails)
+    {
+        var messages = new List<SamplingMessage>();
+
+        foreach (var email in emails)
+        {
+            messages.Add(new SamplingMessage
+            {
+                Role = Role.User,
+                Content = new TextContentBlock
+                {
+                    Text = $"Email from {email.Sender} with subject {email.Subject}. Body: {email.Body}",
+                }
+            });
+
+            if (email.Attachments != null && email.Attachments.Count != 0)
+            {
+                foreach (var attachment in email.Attachments)
+                {
+                    messages.Add(new SamplingMessage
+                    {
+                        Role = Role.User,
+                        Content = new ImageContentBlock
+                        {
+                            Data = Convert.ToBase64String(attachment),
+                            MimeType = "image/png",
+                        }
+                    });
+                }
+            }
+        }
+
+        return messages;
+    }
+
+    /// <summary>
+    /// Represents an email.
+    /// </summary>
+    private sealed class Email
+    {
+        /// <summary>
+        /// Gets or sets the email sender.
+        /// </summary>
+        public required string Sender { get; set; }
+
+        /// <summary>
+        /// Gets or sets the email subject.
+        /// </summary>
+        public required string Subject { get; set; }
+
+        /// <summary>
+        /// Gets or sets the email body.
+        /// </summary>
+        public required string Body { get; set; }
+
+        /// <summary>
+        /// Gets or sets the email attachments.
+        /// </summary>
+        public List<byte[]>? Attachments { get; set; }
+    }
+}

dotnet/samples/Demos/ModelContextProtocolClientServer/MCPServer/Tools/OrderProcessingUtils.cs

@@ -0,0 +1,33 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using Microsoft.SemanticKernel;
+
+namespace MCPServer.Tools;
+
+/// <summary>
+/// A collection of utility methods for working with orders.
+/// </summary>
+internal sealed class OrderProcessingUtils
+{
+    /// <summary>
+    /// Places an order for the specified item.
+    /// </summary>
+    /// <param name="itemName">The name of the item to be ordered.</param>
+    /// <returns>A string indicating the result of the order placement.</returns>
+    [KernelFunction]
+    public string PlaceOrder(string itemName)
+    {
+        return "success";
+    }
+
+    /// <summary>
+    /// Executes a refund for the specified item.
+    /// </summary>
+    /// <param name="itemName">The name of the item to be refunded.</param>
+    /// <returns>A string indicating the result of the refund execution.</returns>
+    [KernelFunction]
+    public string ExecuteRefund(string itemName)
+    {
+        return "success";
+    }
+}

dotnet/samples/Demos/ModelContextProtocolClientServer/MCPServer/Tools/WeatherUtils.cs

@@ -0,0 +1,34 @@
+// Copyright (c) Microsoft. All rights reserved.
+
+using System.ComponentModel;
+using Microsoft.SemanticKernel;
+
+namespace MCPServer.Tools;
+
+/// <summary>
+/// A collection of utility methods for working with weather.
+/// </summary>
+internal sealed class WeatherUtils
+{
+    /// <summary>
+    /// Gets the current weather for the specified city.
+    /// </summary>
+    /// <param name="cityName">The name of the city.</param>
+    /// <param name="currentDateTimeInUtc">The current date time in UTC.</param>
+    /// <returns>The current weather for the specified city.</returns>
+    [KernelFunction, Description("Gets the current weather for the specified city and specified date time.")]
+    public static string GetWeatherForCity(string cityName, string currentDateTimeInUtc)
+    {
+        return cityName switch
+        {
+            "Boston" => "61 and rainy",
+            "London" => "55 and cloudy",
+            "Miami" => "80 and sunny",
+            "Paris" => "60 and rainy",
+            "Tokyo" => "50 and sunny",
+            "Sydney" => "75 and sunny",
+            "Tel Aviv" => "80 and sunny",
+            _ => "31 and snowing",
+        };
+    }
+}