Add original source resolution and result modes

Author: pardeike

DecompilerServer.csproj

@@ -5,6 +5,7 @@
     <TargetFramework>net10.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
+    <Version>1.0.0</Version>
   </PropertyGroup>
 
   <ItemGroup>
@@ -14,6 +15,7 @@
   </ItemGroup>
 
   <ItemGroup>
+    <Compile Remove="EmbeddedSourceTestLibrary/**" />
     <Compile Remove="Tests/**" />
     <Compile Remove="TestLibrary/**" />
   </ItemGroup>

EmbeddedSourceTestLibrary/EmbeddedSourceSample.cs

@@ -0,0 +1,11 @@
+namespace EmbeddedSourceTestLibrary;
+
+public class EmbeddedSourceSample
+{
+    // Embedded source marker comment
+    public string GetValue()
+    {
+        const string marker = "EMBEDDED-SOURCE-MARKER";
+        return marker;
+    }
+}

EmbeddedSourceTestLibrary/EmbeddedSourceTestLibrary.csproj

@@ -0,0 +1,12 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <AssemblyName>embedded-source-test</AssemblyName>
+    <DebugType>embedded</DebugType>
+    <EmbedAllSources>true</EmbedAllSources>
+  </PropertyGroup>
+
+</Project>

README.md

@@ -91,7 +91,8 @@ Most MCP clients expose these tools in `snake_case` even though the underlying C
    ```text
    search_types({
      "query": "Player",
-     "limit": 10
+     "limit": 10,
+     "mode": "discovery"
    })
    ```
 
@@ -141,7 +142,8 @@ load_assembly({
 
 search_types({
   "query": "Simple",
-  "limit": 10
+  "limit": 10,
+  "mode": "discovery"
 })
 
 get_member_details({
@@ -160,7 +162,8 @@ load_assembly({
 search_members({
   "query": "Player",
   "kind": "method",
-  "limit": 10
+  "limit": 10,
+  "mode": "signatures"
 })
 
 generate_harmony_patch_skeleton({
@@ -188,6 +191,21 @@ find_usages({
 })
 ```
 
+### Result modes for high-churn discovery tools
+
+`search_types`, `search_members`, and `get_members_of_type` support output modes so callers can trade detail for context size:
+
+- `ids`: minimal chaining payload (`memberId`, `name`, `kind`)
+- `discovery`: candidate selection payload for follow-up inspection
+- `signatures`: callable/member surface focused payload
+- `full`: legacy rich summary payload
+
+Defaults are tuned for common workflows:
+
+- `search_types`: `discovery`
+- `search_members`: `discovery`
+- `get_members_of_type`: `signatures`
+
 ## 🔧 Development
 
 ### Building

Services/AssemblyContextManager.cs

@@ -23,6 +23,7 @@ public class AssemblyContextManager : IDisposable
     private CSharpDecompiler? _decompiler;
     private UniversalAssemblyResolver? _resolver;
     private bool _disposed;
+    private long _contextVersion;
     private readonly ReaderWriterLockSlim _lock = new();
 
     // Lazy indexes - built on-demand and cached
@@ -48,6 +49,7 @@ private void InitializeLazyIndexes()
     public string? AssemblyPath { get; private set; }
     public string? Mvid { get; private set; }
     public DateTime? LoadedAtUtc { get; private set; }
+    public long ContextVersion => Interlocked.Read(ref _contextVersion);
 
     // Basic statistics with enhanced caching awareness
     public int TypeCount => _compilation?.MainModule.TypeDefinitions.Count() ?? 0;
@@ -315,6 +317,7 @@ public void UpdateSettings(DecompilerSettings settings)
         {
             if (!IsLoaded) return;
             _decompiler = new CSharpDecompiler(_peFile!, _resolver!, settings);
+            Interlocked.Increment(ref _contextVersion);
         }
         finally
         {
@@ -511,6 +514,7 @@ private static PEFile CreatePEFile(string assemblyPath)
 
     private void DisposeContext()
     {
+        Interlocked.Increment(ref _contextVersion);
         _decompiler = null;
         _compilation = null;
         _peFile?.Dispose();