initial

test/PowerShellEditorServices.Test.E2E/Hosts/IAsyncLanguageServerHost.cs

@@ -0,0 +1,24 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+#nullable enable
+
+using System;
+using System.IO;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace PowerShellEditorServices.Test.E2E;
+
+/// <summary>
+/// Represents a debug adapter server host that can be started and stopped and provides streams for communication.
+/// </summary>
+public interface IAsyncLanguageServerHost : IAsyncDisposable
+{
+    // Start the host and return when the host is ready to communicate. It should return a tuple of a stream Reader and stream Writer for communication with the LSP. The underlying streams can be retrieved via baseStream propertyif needed.
+    Task<(StreamReader, StreamWriter)> Start(CancellationToken token = default);
+    // Stops the host and returns when the host has fully stopped. It should be idempotent, such that if called while the host is already stopping/stopped, it will have the same result
+    Task<bool> Stop(CancellationToken token = default);
+
+    // Optional to implement if more is required than a simple stop
+    async ValueTask IAsyncDisposable.DisposeAsync() => await Stop();
+}