feat: capture terminal diagnostics for runtime errors

Author: dkattan

.vscode-test.mjs

@@ -1,42 +1,45 @@
 // import { execSync } from 'node:child_process';
-import { existsSync, rmSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
+import { existsSync, rmSync } from "node:fs";
+import { dirname, resolve } from "node:path";
 // import process from 'node:process';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath } from "node:url";
 
-import { defineConfig } from '@vscode/test-cli';
+import { defineConfig } from "@vscode/test-cli";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
 // Clear user data directory before tests to prevent cached workspace state
-const userDataDir = resolve(__dirname, '.vscode-test/user-data');
+const userDataDir = resolve(__dirname, ".vscode-test/user-data");
 if (existsSync(userDataDir)) {
   rmSync(userDataDir, { recursive: true, force: true });
 }
 
 export default defineConfig({
-  files: 'src/test/**/*.test.ts',
-  version: 'stable', // Match the parent VS Code version
+  files: "src/test/**/*.test.ts",
+  version: "stable", // Match the parent VS Code version
   mocha: {
-    ui: 'bdd',
+    ui: "bdd",
     timeout: 30000,
     parallel: false,
-    require: ['esbuild-register'],
+    require: ["esbuild-register"],
+    bail: true,
   },
   // Allow extensions to load; we install required ones below via the 'extensions' field.
   // Run with a temporary profile for isolation between test runs.
   launchArgs: [
-    resolve(__dirname, 'test-workspace', 'test-workspace.code-workspace'),
+    resolve(__dirname, "test-workspace", "test-workspace.code-workspace"),
     // '--profile-temp',
-    '--disable-extensions',
+    "--disable-extensions",
+    "--enable-proposed-api",
+    "dkattan.copilot-breakpoint-debugger",
   ],
   // Request automatic installation of required marketplace extensions for tests.
   // @vscode/test-cli will ensure these are present before running.
   // extensions: ['ms-vscode.powershell'],
   coverage: {
-    reporter: ['text', 'html', 'lcov'],
-    exclude: ['src/test/**', '**/node_modules/**'],
+    reporter: ["text", "html", "lcov"],
+    exclude: ["src/test/**", "**/node_modules/**"],
   },
   timeout: 30000,
 });

agents.md

@@ -140,6 +140,12 @@ The debug tracker extension provides API services for monitoring debug sessions
 - Always validate workspace folder exists before debugging operations
 - **NO FALLBACK CODE**: Never implement fallback code or fallback logic. Fallback code hides underlying issues and makes debugging harder. If something fails, it should fail explicitly with a clear error message.
 
+### Runtime Diagnostics Capture
+
+- `startDebuggingAndWaitForStop` now streams integrated-terminal output using `vscode.window.onDidWriteTerminalData` so crash diagnostics are available even when adapters bypass the Debug Console (e.g., configs with `console: "integratedTerminal"`).
+- The extension declares the `terminalDataWriteEvent` proposal via `enabledApiProposals` in `package.json` and tests pass `--enable-proposed-api dkattan.copilot-breakpoint-debugger` through `.vscode-test.mjs` launch args.
+- Runtime error messages automatically append exit codes, DAP stderr, and/or terminal lines (capped by `copilot-debugger.maxOutputLines`), keeping messaging concise while surfacing crash context for Copilot tools.
+
 ## External Dependencies
 
 ### debug-tracker-vscode Integration

package.json

@@ -36,6 +36,9 @@
     "onLanguageModelTools",
     "onStartupFinished"
   ],
+  "enabledApiProposals": [
+    "terminalDataWriteEvent"
+  ],
   "contributes": {
     "commands": [
       {
@@ -82,6 +85,18 @@
           ],
           "default": "httpRequest",
           "description": "Preferred serverReady action type surfaced in samples and quick insert command."
+        },
+        "copilot-debugger.maxBuildErrors": {
+          "type": "integer",
+          "default": 5,
+          "description": "Maximum number of build diagnostics (from problem matchers) to include in error messages when debug session fails to start.",
+          "scope": "resource"
+        },
+        "copilot-debugger.maxOutputLines": {
+          "type": "integer",
+          "default": 50,
+          "description": "Maximum number of output lines (stderr/stdout) to buffer per debug session for runtime error reporting.",
+          "scope": "resource"
         }
       }
     },
@@ -461,15 +476,16 @@
     "compile-tests": "tsc -p ./",
     "pretest": "npm run lint && npm run compile-tests && npm run build:dist",
     "lint": "eslint",
-    "test": "node -e \"try{require('fs').rmSync('./.vscode-test/user-data/DIP',{recursive:true,force:true});}catch(e){}\" && npx vscode-test",
+    "test": "node -e \"try{require('fs').rmSync('./.vscode-test/user-data',{recursive:true,force:true});}catch(e){}\" && npx vscode-test",
     "test:coverage": "npm run compile-tests && npx vscode-test --coverage"
   },
   "dependencies": {
     "@actions/core": "^1.11.1",
     "@actions/github": "^6.0.0",
     "@anthropic-ai/sdk": "^0.27.3",
     "@vscode/prompt-tsx": "^0.4.0-alpha.5",
-    "mocha": "^10.7.3"
+    "mocha": "^10.7.3",
+    "strip-ansi": "^7.1.2"
   },
   "devDependencies": {
     "@antfu/eslint-config": "^3.0.0",