Initial bits for the interaction service (#4045)

* Initial bits for the interaction service

* Fix some issues

* Fix build issues

* Tweak rendering of code

* API example

* Update the article to be a bit more contextual to CLI and dashboard.

* Fix APIs

* More updates

* Remove .aspire stuff

* Enhance interaction service documentation for clarity and context in CLI and dashboard usage

* Update explore.md to include interaction prompts and update metadata - closes #4108

* Apply suggestions from code review

Co-authored-by: James Newton-King <[email protected]>

* Address peer feedback

* Update interaction service documentation and remove obsolete snippets

* Clarify input validation section in interaction service documentation

* Apply suggestions from code review

Co-authored-by: James Newton-King <[email protected]>

---------

Co-authored-by: James Newton-King <[email protected]>

Author: IEvangelist

docs/extensibility/interaction-service.md

@@ -0,0 +1,35 @@
+using Microsoft.Extensions.DependencyInjection;
+
+partial class Program
+{
+    public static async Task<ExecuteCommandResult> ShowConfirmationExample(ExecuteCommandContext context)
+    {
+        // <example>
+        var interactionService = context.ServiceProvider.GetRequiredService<IInteractionService>();        
+
+        // Prompt for confirmation before resetting database
+        var resetConfirmation = await interactionService.PromptConfirmationAsync(
+            title: "Confirm Reset",
+            message: "Are you sure you want to reset the `development-database`? This action **cannot** be undone.",
+            options: new MessageBoxInteractionOptions
+            {
+                Intent = MessageIntent.Confirmation,
+                PrimaryButtonText = "Reset",
+                SecondaryButtonText = "Cancel",
+                ShowSecondaryButton = true,
+                EnableMessageMarkdown = true
+            });
+
+        if (resetConfirmation.Data is true)
+        {
+            // Perform the reset operation...
+
+            return CommandResults.Success();
+        }
+        else
+        {
+            return CommandResults.Failure("Database reset canceled by user.");
+        }
+        // </example>
+    }
+}

docs/extensibility/media/interaction-service-confirmation.png

@@ -0,0 +1,46 @@
+using Microsoft.Extensions.DependencyInjection;
+
+partial class Program
+{
+    public static async Task<ExecuteCommandResult> ShowMessageBoxExample(ExecuteCommandContext context)
+    {
+        // <example>
+        var interactionService = context.ServiceProvider.GetRequiredService<IInteractionService>();
+
+        var result = await interactionService.PromptMessageBoxAsync(
+            "Simple Message Box: Example",
+            """
+            ##### 🤓 Nice!
+
+            It's worth noting that **Markdown** is _supported_
+            (and demonstrated here) in the message body. Simply
+            configure the options as:
+
+            ```csharp
+            var options = new MessageBoxInteractionOptions
+            {
+                EnableMessageMarkdown = true,
+                // Other options...
+            };
+            ```
+
+            Cool, [📖 learn more](https://learn.microsoft.com/dotnet/aspire/extensibility/interaction-service)...
+            """,
+            new MessageBoxInteractionOptions
+            {
+                EnableMessageMarkdown = true,
+                PrimaryButtonText = "Awesome"
+            }
+        );
+
+        if (result.Canceled)
+        {
+            return CommandResults.Failure("User cancalled.");
+        }
+
+        return result.Data
+            ? CommandResults.Success()
+            : CommandResults.Failure("The user doesn't like the example");
+        // </example>
+    }
+}

docs/extensibility/media/interaction-service-message-bar.png

@@ -0,0 +1,80 @@
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Logging;
+
+partial class Program
+{
+    public static async Task<ExecuteCommandResult> ShowMultipleInputExample(
+        ExecuteCommandContext context, FakeResource fakeResource)
+    {
+        // <example>
+        var interactionService = context.ServiceProvider.GetRequiredService<IInteractionService>();
+        var loggerService = context.ServiceProvider.GetRequiredService<ResourceLoggerService>();
+        var logger = loggerService.GetLogger(fakeResource);
+
+        var inputs = new List<InteractionInput>
+        {
+            new()
+            {
+                Label = "Application Name",
+                InputType = InputType.Text,
+                Required = true,
+                Placeholder = "my-app"
+            },
+            new()
+            {
+                Label = "Environment",
+                InputType = InputType.Choice,
+                Required = true,
+                Options =
+                [
+                    new("dev", "Development"),
+                    new("staging", "Staging"),
+                    new("test", "Testing")
+                ]
+            },
+            new()
+            {
+                Label = "Instance Count",
+                InputType = InputType.Number,
+                Required = true,
+                Placeholder = "1"
+            },
+            new()
+            {
+                Label = "Enable Monitoring",
+                InputType = InputType.Boolean,
+                Required = false
+            }
+        };
+
+        var appConfigurationInput = await interactionService.PromptInputsAsync(
+            title: "Application Configuration",
+            message: "Configure your application deployment settings:",
+            inputs: inputs);
+
+        if (!appConfigurationInput.Canceled)
+        {
+            // Process the collected input values
+            var appName = appConfigurationInput.Data[0].Value;
+            var environment = appConfigurationInput.Data[1].Value;
+            var instanceCount = int.Parse(appConfigurationInput.Data[2].Value ?? "1");
+            var enableMonitoring = bool.Parse(appConfigurationInput.Data[3].Value ?? "false");
+
+            logger.LogInformation("""
+                Application Name: {AppName}
+                Environment: {Environment}
+                Instance Count: {InstanceCount}
+                Monitoring Enabled: {EnableMonitoring}
+                """,
+                appName, environment, instanceCount, enableMonitoring);
+
+            // Use the collected values as needed
+            return CommandResults.Success();
+        }
+        else
+        {
+            return CommandResults.Failure("User canceled application configuration input.");
+        }
+        // </example>
+    }
+}