Merge pull request #2557 from nagilson/nagilson-mcp-for-installing

Provide `Language Model Tools` for LLM/VS Code Agent to Manage .NET

Author: nagilson

sample/src/extension.ts

@@ -107,17 +107,17 @@ ${stderr}`);
         }
     }
 
-    const sampleAcquireRegistration = vscode.commands.registerCommand('sample.dotnet.acquire', async (version) =>
+    const sampleAcquireRegistration = vscode.commands.registerCommand('sample.dotnet.acquire', async (version: string | undefined) =>
     {
         await callAcquireAPI(version, undefined);
     });
 
-    const sampleAcquireASPNETRegistration = vscode.commands.registerCommand('sample.dotnet.acquireASPNET', async (version) =>
+    const sampleAcquireASPNETRegistration = vscode.commands.registerCommand('sample.dotnet.acquireASPNET', async (version: string | undefined) =>
     {
         await callAcquireAPI(version, 'aspnetcore');
     });
 
-    const sampleAcquireNoForceRegistration = vscode.commands.registerCommand('sample.dotnet.acquireNoForce', async (version) =>
+    const sampleAcquireNoForceRegistration = vscode.commands.registerCommand('sample.dotnet.acquireNoForce', async (version: string | undefined) =>
     {
         const mode = await vscode.window.showInputBox({
             placeHolder: 'runtime',
@@ -128,7 +128,7 @@ ${stderr}`);
         await callAcquireAPI(undefined, mode as DotnetInstallMode, false);
     });
 
-    const sampleAcquireStatusRegistration = vscode.commands.registerCommand('sample.dotnet.acquireStatus', async (version) =>
+    const sampleAcquireStatusRegistration = vscode.commands.registerCommand('sample.dotnet.acquireStatus', async (version: string | undefined) =>
     {
         if (!version)
         {
@@ -236,7 +236,7 @@ ${stderr}`);
         }
     });
 
-    const sampleGlobalSDKFromRuntimeRegistration = vscode.commands.registerCommand('sample.dotnet.acquireGlobalSDK', async (version) =>
+    const sampleGlobalSDKFromRuntimeRegistration = vscode.commands.registerCommand('sample.dotnet.acquireGlobalSDK', async (version: string | undefined) =>
     {
         if (!version)
         {
@@ -247,6 +247,11 @@ ${stderr}`);
             });
         }
 
+        if (!version)
+        {
+            return;
+        }
+
         try
         {
             await vscode.commands.executeCommand('dotnet.showAcquisitionLog');
@@ -303,7 +308,7 @@ ${stderr}`);
 ${JSON.stringify(result) ?? 'undefined'}`);
     });
 
-    const sampleAvailableInstallsRegistration = vscode.commands.registerCommand('sample.dotnet.availableInstalls', async (version) =>
+    const sampleAvailableInstallsRegistration = vscode.commands.registerCommand('sample.dotnet.availableInstalls', async (version: string | undefined) =>
     {
         let dotnetPath = await vscode.window.showInputBox({
             placeHolder: 'undefined',
@@ -357,7 +362,7 @@ ${JSON.stringify(result) ?? 'undefined'}`);
 
     // ---------------------sdk extension registrations--------------------------
 
-    const sampleSDKAcquireRegistration = vscode.commands.registerCommand('sample.dotnet-sdk.acquire', async (version) =>
+    const sampleSDKAcquireRegistration = vscode.commands.registerCommand('sample.dotnet-sdk.acquire', async (version: string | undefined) =>
     {
         if (!version)
         {
@@ -379,7 +384,7 @@ ${JSON.stringify(result) ?? 'undefined'}`);
         }
     });
 
-    const sampleSDKGlobalAcquireRegistration = vscode.commands.registerCommand('sample.dotnet-sdk.acquireGlobal', async (version) =>
+    const sampleSDKGlobalAcquireRegistration = vscode.commands.registerCommand('sample.dotnet-sdk.acquireGlobal', async (version: string | undefined) =>
     {
         if (!version)
         {
@@ -390,6 +395,11 @@ ${JSON.stringify(result) ?? 'undefined'}`);
             });
         }
 
+        if (!version)
+        {
+            return;
+        }
+
         try
         {
             await vscode.commands.executeCommand('dotnet-sdk.showAcquisitionLog');
@@ -402,7 +412,7 @@ ${JSON.stringify(result) ?? 'undefined'}`);
         }
     });
 
-    const sampleSDKAcquireStatusRegistration = vscode.commands.registerCommand('sample.dotnet-sdk.acquireStatus', async (version) =>
+    const sampleSDKAcquireStatusRegistration = vscode.commands.registerCommand('sample.dotnet-sdk.acquireStatus', async (version: string | undefined) =>
     {
         if (!version)
         {

sample/yarn.lock

@@ -7,9 +7,21 @@ and this project adheres to [Semantic Versioning].
 
 ## [Unreleased]
 
+
+
 ## [3.1.0] - 2026-5
 
-- Adds Language Model Tools for AI agents (GitHub Copilot) to install, uninstall, list, and find .NET SDKs/Runtimes.
+- Adds Language Model Tools for the AI chat in VS Code. These language model tools:
+1. Help the agent chat window resolve scenarios where C# or related extensions fail to load.
+2. Help agents deterministically install and uninstall the .NET SDK at the system-level, in a way that maintains updates, is visible to the user, persists across sessions, and provides a more secure and robust development environment. Prior agents often used one-off .NET installs that may have been discarded, undiscoverable, nondeterministic, or insecure.
+3. Provides tools to help discover what is installed and what is available for .NET runtimes and .NET SDKs.
+
+
+The language model tools may be disabled in the extension settings or in the settings JSON like so:
+```
+"dotnetAcquisitionExtension.enableLanguageModelTools": false
+```
+- The `dotnet.availableInstalls` API now accepts an optional `fallbackToFindPathInstalls` property (default `false`). When `true` and no install is found for the resolved host, it falls back to the `dotnet.findPath` logic to locate a host independently of the PATH and retries the search. This is opt-in (and enabled by the Language Model tools) to avoid a breaking change, since `findPath` may return non system-level paths depending on the environment.
 - Consolidate rimraf usage — thank you @Green00101!
 - Dependency updates.