Support: Debug Adapter Protocol

LSP.sln

@@ -1,4 +1,4 @@
-Microsoft Visual Studio Solution File, Format Version 12.00
+Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio Version 16
 VisualStudioVersion = 16.0.29025.244
 MinimumVisualStudioVersion = 10.0.40219.1
@@ -50,6 +50,10 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 		cake.config = cake.config
 	EndProjectSection
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Dap.Protocol", "src\Dap.Protocol\Dap.Protocol.csproj", "{F2C9D555-118E-442B-A953-9A7B58A53F33}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Dap.Server", "src\Dap.Server\Dap.Server.csproj", "{E1A9123B-A236-4240-8C82-A61BD85C3BF4}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -156,6 +160,30 @@ Global
 		{E540868F-438E-4F7F-BBB7-010D6CB18A57}.Release|x64.Build.0 = Release|Any CPU
 		{E540868F-438E-4F7F-BBB7-010D6CB18A57}.Release|x86.ActiveCfg = Release|Any CPU
 		{E540868F-438E-4F7F-BBB7-010D6CB18A57}.Release|x86.Build.0 = Release|Any CPU
+		{F2C9D555-118E-442B-A953-9A7B58A53F33}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{F2C9D555-118E-442B-A953-9A7B58A53F33}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{F2C9D555-118E-442B-A953-9A7B58A53F33}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{F2C9D555-118E-442B-A953-9A7B58A53F33}.Debug|x64.Build.0 = Debug|Any CPU
+		{F2C9D555-118E-442B-A953-9A7B58A53F33}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{F2C9D555-118E-442B-A953-9A7B58A53F33}.Debug|x86.Build.0 = Debug|Any CPU
+		{F2C9D555-118E-442B-A953-9A7B58A53F33}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{F2C9D555-118E-442B-A953-9A7B58A53F33}.Release|Any CPU.Build.0 = Release|Any CPU
+		{F2C9D555-118E-442B-A953-9A7B58A53F33}.Release|x64.ActiveCfg = Release|Any CPU
+		{F2C9D555-118E-442B-A953-9A7B58A53F33}.Release|x64.Build.0 = Release|Any CPU
+		{F2C9D555-118E-442B-A953-9A7B58A53F33}.Release|x86.ActiveCfg = Release|Any CPU
+		{F2C9D555-118E-442B-A953-9A7B58A53F33}.Release|x86.Build.0 = Release|Any CPU
+		{E1A9123B-A236-4240-8C82-A61BD85C3BF4}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{E1A9123B-A236-4240-8C82-A61BD85C3BF4}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{E1A9123B-A236-4240-8C82-A61BD85C3BF4}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{E1A9123B-A236-4240-8C82-A61BD85C3BF4}.Debug|x64.Build.0 = Debug|Any CPU
+		{E1A9123B-A236-4240-8C82-A61BD85C3BF4}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{E1A9123B-A236-4240-8C82-A61BD85C3BF4}.Debug|x86.Build.0 = Debug|Any CPU
+		{E1A9123B-A236-4240-8C82-A61BD85C3BF4}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{E1A9123B-A236-4240-8C82-A61BD85C3BF4}.Release|Any CPU.Build.0 = Release|Any CPU
+		{E1A9123B-A236-4240-8C82-A61BD85C3BF4}.Release|x64.ActiveCfg = Release|Any CPU
+		{E1A9123B-A236-4240-8C82-A61BD85C3BF4}.Release|x64.Build.0 = Release|Any CPU
+		{E1A9123B-A236-4240-8C82-A61BD85C3BF4}.Release|x86.ActiveCfg = Release|Any CPU
+		{E1A9123B-A236-4240-8C82-A61BD85C3BF4}.Release|x86.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -169,6 +197,8 @@ Global
 		{97437BE1-2EC3-4F6B-AC75-C3E099040A07} = {2F323ED5-EBF8-45E1-B9D3-C014561B3DDA}
 		{92B331E9-5225-428D-AE82-37F5F46156A3} = {D764E024-3D3F-4112-B932-2DB722A1BACC}
 		{E540868F-438E-4F7F-BBB7-010D6CB18A57} = {D764E024-3D3F-4112-B932-2DB722A1BACC}
+		{F2C9D555-118E-442B-A953-9A7B58A53F33} = {D764E024-3D3F-4112-B932-2DB722A1BACC}
+		{E1A9123B-A236-4240-8C82-A61BD85C3BF4} = {D764E024-3D3F-4112-B932-2DB722A1BACC}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {D38DD0EC-D095-4BCD-B8AF-2D788AF3B9AE}

src/Dap.Protocol/Dap.Protocol.csproj

@@ -0,0 +1,21 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+      <TargetFrameworks>netstandard2.0</TargetFrameworks>
+      <PlatformTarget>AnyCPU</PlatformTarget>
+      <AssemblyName>OmniSharp.Extensions.DebugAdapter</AssemblyName>
+      <RootNamespace>OmniSharp.Extensions.DebugAdapter.Protocol</RootNamespace>
+      <PackageDescription>Debug Adapter Protocol models, classes, interfaces and helper methods</PackageDescription>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\JsonRpc\JsonRpc.csproj" />
+    <AssemblyAttribute Include="System.Runtime.CompilerServices.InternalsVisibleToAttribute">
+        <_Parameter1>OmniSharp.Extensions.LanguageServer, PublicKey=0024000004800000940000000602000000240000525341310004000001000100391db875e68eb4bfef49ce14313b9e13f2cd3cc89eb273bbe6c11a55044c7d4f566cf092e1c77ef9e7c75b1496ae7f95d925938f5a01793dd8d9f99ae0a7595779b71b971287d7d7b5960d052078d14f5ce1a85ea5c9fb2f59ac735ff7bc215cab469b7c3486006860bad6f4c3b5204ea2f28dd4e1d05e2cca462cfd593b9f9f</_Parameter1>
+    </AssemblyAttribute>
+    <AssemblyAttribute Include="System.Runtime.CompilerServices.InternalsVisibleToAttribute">
+        <_Parameter1>OmniSharp.Extensions.LanguageClient, PublicKey=0024000004800000940000000602000000240000525341310004000001000100391db875e68eb4bfef49ce14313b9e13f2cd3cc89eb273bbe6c11a55044c7d4f566cf092e1c77ef9e7c75b1496ae7f95d925938f5a01793dd8d9f99ae0a7595779b71b971287d7d7b5960d052078d14f5ce1a85ea5c9fb2f59ac735ff7bc215cab469b7c3486006860bad6f4c3b5204ea2f28dd4e1d05e2cca462cfd593b9f9f</_Parameter1>
+    </AssemblyAttribute>
+  </ItemGroup>
+
+</Project>

src/Dap.Protocol/Events/BreakpointEvent.cs

@@ -0,0 +1,20 @@
+using OmniSharp.Extensions.DebugAdapter.Protocol.Models;
+using OmniSharp.Extensions.Embedded.MediatR;
+
+namespace OmniSharp.Extensions.DebugAdapter.Protocol.Events
+{
+    public class BreakpointEvent : IRequest
+    {
+        /// <summary>
+        /// The reason for the event.
+        /// Values: 'changed', 'new', 'removed', etc.
+        /// </summary>
+        public string Reason { get; set; }
+
+        /// <summary>
+        /// The 'id' attribute is used to find the target breakpoint and the other attributes are used as the new values.
+        /// </summary>
+        public Breakpoint Breakpoint { get; set; }
+    }
+
+}

src/Dap.Protocol/Events/BreakpointExtensions.cs

@@ -0,0 +1,17 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+using OmniSharp.Extensions.DebugAdapter.Protocol.Requests;
+using OmniSharp.Extensions.Embedded.MediatR;
+using OmniSharp.Extensions.JsonRpc;
+
+namespace OmniSharp.Extensions.DebugAdapter.Protocol.Events
+{
+    public static class BreakpointExtensions
+    {
+        public static void SendBreakpoint(this IDebugClient mediator, BreakpointEvent @event)
+        {
+            mediator.SendNotification(EventNames.Breakpoint, @event);
+        }
+    }
+}

src/Dap.Protocol/Events/CapabilitiesEvent.cs

@@ -0,0 +1,15 @@
+using OmniSharp.Extensions.DebugAdapter.Protocol.Models;
+using OmniSharp.Extensions.Embedded.MediatR;
+
+namespace OmniSharp.Extensions.DebugAdapter.Protocol.Events
+{
+    public class CapabilitiesEvent : IRequest
+    {
+
+        /// <summary>
+        /// The set of updated capabilities.
+        /// </summary>
+        public Capabilities Capabilities { get; set; }
+    }
+
+}

src/Dap.Protocol/Events/CapabilitiesExtensions.cs

@@ -0,0 +1,17 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+using OmniSharp.Extensions.DebugAdapter.Protocol.Requests;
+using OmniSharp.Extensions.Embedded.MediatR;
+using OmniSharp.Extensions.JsonRpc;
+
+namespace OmniSharp.Extensions.DebugAdapter.Protocol.Events
+{
+    public static class CapabilitiesExtensions
+    {
+        public static void SendCapabilities(this IDebugClient mediator, CapabilitiesEvent @event)
+        {
+            mediator.SendNotification(EventNames.Capabilities, @event);
+        }
+    }
+}

src/Dap.Protocol/Events/ContinuedEvent.cs

@@ -0,0 +1,18 @@
+using OmniSharp.Extensions.DebugAdapter.Protocol.Serialization;
+using OmniSharp.Extensions.Embedded.MediatR;
+
+namespace OmniSharp.Extensions.DebugAdapter.Protocol.Events
+{
+    public class ContinuedEvent : IRequest
+    {
+        /// <summary>
+        /// The thread which was continued.
+        /// </summary>
+        public long ThreadId { get; set; }
+
+        /// <summary>
+        /// If 'allThreadsContinued' is true, a debug adapter can announce that all threads have continued.
+        /// </summary>
+        [Optional] public bool? AllThreadsContinued { get; set; }
+    }
+}

src/Dap.Protocol/Events/ContinuedExtensions.cs

@@ -0,0 +1,17 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+using OmniSharp.Extensions.DebugAdapter.Protocol.Requests;
+using OmniSharp.Extensions.Embedded.MediatR;
+using OmniSharp.Extensions.JsonRpc;
+
+namespace OmniSharp.Extensions.DebugAdapter.Protocol.Events
+{
+    public static class ContinuedExtensions
+    {
+        public static void SendContinued(this IDebugClient mediator, ContinuedEvent @event)
+        {
+            mediator.SendNotification(EventNames.Continued, @event);
+        }
+    }
+}

src/Dap.Protocol/Events/EventNames.cs

@@ -0,0 +1,23 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+using System.Threading;
+
+namespace OmniSharp.Extensions.DebugAdapter.Protocol.Events
+{
+    public static class EventNames
+    {
+        public const string Initialized = "initialized";
+        public const string Stopped = "stopped";
+        public const string Continued = "continued";
+        public const string Exited = "exited";
+        public const string Terminated = "terminated";
+        public const string Thread = "thread";
+        public const string Output = "output";
+        public const string Breakpoint = "breakpoint";
+        public const string Module = "module";
+        public const string LoadedSource = "loadedSource";
+        public const string Process = "process";
+        public const string Capabilities = "capabilities";
+    }
+}

src/Dap.Protocol/Events/ExitedEvent.cs

@@ -0,0 +1,13 @@
+using OmniSharp.Extensions.Embedded.MediatR;
+
+namespace OmniSharp.Extensions.DebugAdapter.Protocol.Events
+{
+    public class ExitedEvent : IRequest
+    {
+
+        /// <summary>
+        /// The exit code returned from the debuggee.
+        /// </summary>
+        public long ExitCode { get; set; }
+    }
+}

src/Dap.Protocol/Events/ExitedExtensions.cs

@@ -0,0 +1,17 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+using OmniSharp.Extensions.DebugAdapter.Protocol.Requests;
+using OmniSharp.Extensions.Embedded.MediatR;
+using OmniSharp.Extensions.JsonRpc;
+
+namespace OmniSharp.Extensions.DebugAdapter.Protocol.Events
+{
+    public static class ExitedExtensions
+    {
+        public static void SendExited(this IDebugClient mediator, ExitedEvent @event)
+        {
+            mediator.SendNotification(EventNames.Exited, @event);
+        }
+    }
+}

src/Dap.Protocol/Events/InitializedEvent.cs

@@ -0,0 +1,8 @@
+using OmniSharp.Extensions.Embedded.MediatR;
+
+namespace OmniSharp.Extensions.DebugAdapter.Protocol.Events
+{
+    public class InitializedEvent : IRequest
+    {
+    }
+}

src/Dap.Protocol/Events/InitializedExtensions.cs

@@ -0,0 +1,17 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+using OmniSharp.Extensions.DebugAdapter.Protocol.Requests;
+using OmniSharp.Extensions.Embedded.MediatR;
+using OmniSharp.Extensions.JsonRpc;
+
+namespace OmniSharp.Extensions.DebugAdapter.Protocol.Events
+{
+    public static class InitializedExtensions
+    {
+        public static void SendInitialized(this IDebugClient mediator, InitializedEvent @event)
+        {
+            mediator.SendNotification(EventNames.Initialized, @event);
+        }
+    }
+}

src/Dap.Protocol/Events/LoadedSourceEvent.cs

@@ -0,0 +1,20 @@
+using OmniSharp.Extensions.DebugAdapter.Protocol.Models;
+using OmniSharp.Extensions.Embedded.MediatR;
+
+namespace OmniSharp.Extensions.DebugAdapter.Protocol.Events
+{
+    public class LoadedSourceEvent : IRequest
+    {
+
+        /// <summary>
+        /// The reason for the event.
+        /// </summary>
+        public LoadedSourceReason Reason { get; set; }
+
+        /// <summary>
+        /// The new, changed, or removed source.
+        /// </summary>
+        public Source Source { get; set; }
+    }
+
+}

src/Dap.Protocol/Events/LoadedSourceExtensions.cs

@@ -0,0 +1,17 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+using OmniSharp.Extensions.DebugAdapter.Protocol.Requests;
+using OmniSharp.Extensions.Embedded.MediatR;
+using OmniSharp.Extensions.JsonRpc;
+
+namespace OmniSharp.Extensions.DebugAdapter.Protocol.Events
+{
+    public static class LoadedSourceExtensions
+    {
+        public static void SendLoadedSource(this IDebugClient mediator, LoadedSourceEvent @event)
+        {
+            mediator.SendNotification(EventNames.LoadedSource, @event);
+        }
+    }
+}

src/Dap.Protocol/Events/LoadedSourceReason.cs

@@ -0,0 +1,11 @@
+using Newtonsoft.Json;
+using Newtonsoft.Json.Converters;
+
+namespace OmniSharp.Extensions.DebugAdapter.Protocol.Events
+{
+    [JsonConverter(typeof(StringEnumConverter))]
+    public enum LoadedSourceReason
+    {
+        New, Changed, Removed
+    }
+}

src/Dap.Protocol/Events/ModuleEvent.cs

@@ -0,0 +1,20 @@
+using OmniSharp.Extensions.DebugAdapter.Protocol.Models;
+using OmniSharp.Extensions.Embedded.MediatR;
+
+namespace OmniSharp.Extensions.DebugAdapter.Protocol.Events
+{
+    public class ModuleEvent : IRequest
+    {
+
+        /// <summary>
+        /// The reason for the event.
+        /// </summary>
+        public ModuleEventReason Reason { get; set; }
+
+        /// <summary>
+        /// The new, changed, or removed module. In case of 'removed' only the module id is used.
+        /// </summary>
+        public Module Module { get; set; }
+    }
+
+}

src/Dap.Protocol/Events/ModuleEventReason.cs

@@ -0,0 +1,12 @@
+using Newtonsoft.Json;
+using Newtonsoft.Json.Converters;
+
+namespace OmniSharp.Extensions.DebugAdapter.Protocol.Events
+{
+    [JsonConverter(typeof(StringEnumConverter))]
+    public enum ModuleEventReason
+    {
+        New, Changed, Removed
+    }
+
+}

src/Dap.Protocol/Events/ModuleExtensions.cs

@@ -0,0 +1,17 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+using OmniSharp.Extensions.DebugAdapter.Protocol.Requests;
+using OmniSharp.Extensions.Embedded.MediatR;
+using OmniSharp.Extensions.JsonRpc;
+
+namespace OmniSharp.Extensions.DebugAdapter.Protocol.Events
+{
+    public static class ModuleExtensions
+    {
+        public static void SendModule(this IDebugClient mediator, ModuleEvent @event)
+        {
+            mediator.SendNotification(EventNames.Module, @event);
+        }
+    }
+}