Add VS Code resource debugging for .NET and Go

.github/workflows/extension-e2e-tests.yml

@@ -282,6 +282,15 @@ jobs:
             archivePattern: aspire-cli-win-x64*.zip
             cliBinary: aspire.exe
             useXvfb: false
+          - name: Linux
+            shardName: resource-debug-tools
+            spec: out/test-e2e/test-e2e/resourceDebugTools.e2e.test.js
+            runner: ubuntu-latest
+            rid: linux-x64
+            archivePattern: aspire-cli-linux-x64*.tar.gz
+            cliBinary: aspire
+            useXvfb: true
+            installResourceDebug: true
           - name: Linux
             shardName: java-apphost
             spec: out/test-e2e/test-e2e/javaAppHost.e2e.test.js
@@ -346,6 +355,14 @@ jobs:
             archivePattern: aspire-cli-linux-x64*.tar.gz
             cliBinary: aspire
             useXvfb: true
+          - name: Windows
+            shardName: resource-debug-tools
+            spec: out/test-e2e/test-e2e/resourceDebugTools.e2e.test.js
+            runner: windows-latest
+            rid: win-x64
+            archivePattern: aspire-cli-win-x64*.zip
+            cliBinary: aspire.exe
+            useXvfb: false
           - name: Windows
             shardName: cli-path-rejection
             spec: out/test-e2e/test-e2e/cliPathRejectionNotification.e2e.test.js
@@ -554,6 +571,49 @@ jobs:
             echo 'FUNCTIONS_CORE_TOOLS_TELEMETRY_OPTOUT=1'
           } >> "$GITHUB_ENV"
 
+      - name: Install resource debug E2E prerequisites
+        if: ${{ matrix.installResourceDebug }}
+        shell: bash
+        run: |
+          set -euo pipefail
+
+          # Ubuntu's Yama default allows ptrace only when the debugger is an ancestor of the target.
+          # DCP launches the Go resource independently from Delve, so packaged attach needs this test-only policy.
+          sudo sysctl --write kernel.yama.ptrace_scope=0
+          test "$(cat /proc/sys/kernel/yama/ptrace_scope)" = "0"
+
+          debugger_bin="$RUNNER_TEMP/resource-debug-bin"
+          mkdir -p "$debugger_bin"
+          GOBIN="$debugger_bin" GOTOOLCHAIN=local go install github.com/go-delve/delve/cmd/dlv@v1.25.2
+          echo "$debugger_bin" >> "$GITHUB_PATH"
+          export PATH="$debugger_bin:$PATH"
+          dlv version
+
+          dotnet_runtime_vsix="$RUNNER_TEMP/vscode-dotnet-runtime-3.1.0.vsix"
+          curl --fail --location --compressed --retry 3 --retry-all-errors \
+            --output "$dotnet_runtime_vsix" \
+            'https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-dotnettools/vsextensions/vscode-dotnet-runtime/3.1.0/vspackage'
+          echo '8e675ffe5f3674430d63e28d2dc05ab40f36c8494e9549e79d3995d721b13f5a  '"$dotnet_runtime_vsix" | sha256sum --check -
+
+          csharp_vsix="$RUNNER_TEMP/vscode-csharp-2.148.23-linux-x64.vsix"
+          curl --fail --location --compressed --retry 3 --retry-all-errors \
+            --output "$csharp_vsix" \
+            'https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-dotnettools/vsextensions/csharp/2.148.23/vspackage?targetPlatform=linux-x64'
+          echo '18b503e614a979212762683b35a4fa1806688ba773d5fe93bf62c9f9346db23f  '"$csharp_vsix" | sha256sum --check -
+
+          go_vsix="$RUNNER_TEMP/vscode-go-0.56.0.vsix"
+          curl --fail --location --compressed --retry 3 --retry-all-errors \
+            --output "$go_vsix" \
+            'https://marketplace.visualstudio.com/_apis/public/gallery/publishers/golang/vsextensions/Go/0.56.0/vspackage'
+          echo '9f5959fb17ba0a8dbd804387ddda50975fcaa9dd5267aa33eaaa89912072aacb  '"$go_vsix" | sha256sum --check -
+
+          {
+            echo 'ASPIRE_EXTENSION_E2E_ENABLE_RESOURCE_DEBUG=true'
+            echo "ASPIRE_EXTENSION_E2E_DOTNET_RUNTIME_VSIX=$dotnet_runtime_vsix"
+            echo "ASPIRE_EXTENSION_E2E_CSHARP_VSIX=$csharp_vsix"
+            echo "ASPIRE_EXTENSION_E2E_GO_VSIX=$go_vsix"
+          } >> "$GITHUB_ENV"
+
       - name: Set up the JDK for the Java E2E specs
         if: ${{ matrix.installJava }}
         uses: actions/setup-java@b6effb05e454b25005698d916606bdc6ffcbf961 # v5.7.0

docs/specs/cli-output-formats.md

@@ -197,7 +197,7 @@ If discovery finds no AppHost candidates, the stream emits no lines. The stream
 | `relationships` | Related resources as `{ "type": "...", "resourceName": "..." }`. |
 | `urls` | Endpoint objects with `name`, `displayName`, `url`, and `isInternal`. |
 | `volumes` | Volume objects with `source`, `target`, `mountType`, and `isReadOnly`. |
-| `properties` | Resource properties keyed by property name. |
+| `properties` | Resource properties keyed by property name. Common debug-related keys include `project.path`, `project.launchProfile`, `project.launchCommand`, `project.configuration`, `project.targetFramework`, and `resource.launchConfigurationType`. For current AppHosts, `project.launchCommand` is `run`, `watch`, or `null` when a dotnet project launch command cannot be classified. |
 | `environment` | Environment variables keyed by variable name. |
 | `healthReports` | Health report objects keyed by report name. |
 | `commands` | Resource command metadata keyed by command name. |

extension/CHANGELOG.md

@@ -14,6 +14,10 @@
 
 <!-- aspire-ext-changelog-done from=689b3c3226482b5d84d80e6d8c7ea8408c704c1f to=1410c1a7fc2e0dce9539f234e2464ca3e20cd9bf base=1.20.0 -->
 
+### Features
+
+- Add an **Attach debugger** action for running .NET and Go resources in the Aspire pane, including installation guidance when the required C# or Go debugger extension is missing ([#18602](https://github.com/microsoft/aspire/pull/18602)).
+
 ### Fixes
 
 - Prevent the Aspire view from stealing sidebar focus and reappearing in the Activity Bar when the window is reloaded ([#19746](https://github.com/microsoft/aspire/issues/19746), [#19754](https://github.com/microsoft/aspire/pull/19754)).

extension/README.md

@@ -20,6 +20,7 @@ An **AppHost** defines your app in code: services, containers, databases, front
 
 - **Run your apps:** Start, debug, and stop an Aspire application, or use the available start, stop, and restart actions for individual resources, from the Aspire view.
 - **Debug across your stack:** Aspire debug sessions support C#, JavaScript, Python, Go, Java, and Rust application resources when the corresponding debugger is available. Java and Rust debugging require Aspire 13.6 or later.
+- **Attach to running resources:** Attach to .NET and Go resources from the Aspire view. The action remains available when a required debugger extension is missing so VS Code can show installation guidance.
 - **See live health and analytics:** Open the Aspire dashboard for resource health, endpoints, console logs, structured logs, distributed traces, and metrics.
 - **Monitor without leaving VS Code:** See resource health summaries and quick actions beside resource definitions in your AppHost.
 - **Move toward production.** Deploy, publish artifacts, and run pipeline steps using the Aspire view.
@@ -28,6 +29,10 @@ An **AppHost** defines your app in code: services, containers, databases, front
 
 Aspire can bring together C#, TypeScript and JavaScript, Python, Go, Java, containers, databases, cloud resources, and more. Browse the [integration gallery](https://aspire.dev/integrations/gallery/) to find the pieces your app needs.
 
+## Chat tools for agents
+
+The extension contributes `aspire_apphost_start`, `aspire_apphost_stop`, and `aspire_resource_debug` language model tools. They only accept AppHosts and resources already discovered in a trusted workspace, reject arbitrary or absolute paths, and ask the user to confirm before acting. Resource debugging attaches to a running resource; it does not start or restart one.
+
 ## Learn more
 
 - [Aspire extension for Visual Studio Code](https://aspire.dev/get-started/aspire-vscode-extension/)