fix: include plugin version in response, improve error messages, and validate captureAndContinue in singleShot mode

Author: dkattan

src/session.ts

@@ -1137,6 +1137,17 @@ export const startDebuggingAndWaitForStop = async (
 
   logger.debug("startDebuggingAndWaitForStop params", params);
 
+  if (mode === "singleShot" && breakpointConfig?.breakpoints) {
+    const invalidBp = breakpointConfig.breakpoints.find(
+      (bp) => bp.onHit === "captureAndContinue"
+    );
+    if (invalidBp) {
+      throw new Error(
+        `'captureAndContinue' onHit action is not supported in singleShot mode. Use 'inspect' mode or 'break'/'stopDebugging' action.`
+      );
+    }
+  }
+
   const serverReadyEnabled = config.serverReadyEnabled !== false;
   if (serverReadyParam && !serverReadyEnabled) {
     logger.info(
@@ -2089,7 +2100,7 @@ export const startDebuggingAndWaitForStop = async (
     if (entryStop.reason === "terminated") {
       throw new Error(
         withRuntimeDiagnostics(
-          `Debug session '${effectiveSessionName}' terminated before hitting entry.`,
+          `Debug session '${effectiveSessionName}' terminated before hitting entry (unexpected: user cancelled or app exited).`,
           entryStop.session.id
         )
       );
@@ -2152,7 +2163,7 @@ export const startDebuggingAndWaitForStop = async (
     if (finalStop.reason === "terminated") {
       throw new Error(
         withRuntimeDiagnostics(
-          `Debug session '${effectiveSessionName}' terminated before hitting a user breakpoint.`,
+          `Debug session '${effectiveSessionName}' terminated before hitting a user breakpoint (unexpected: user cancelled or app exited).`,
           finalStop.session.id
         )
       );
@@ -2194,7 +2205,7 @@ export const startDebuggingAndWaitForStop = async (
       if (nextStop.reason === "terminated") {
         throw new Error(
           withRuntimeDiagnostics(
-            `Debug session '${effectiveSessionName}' terminated after serverReady processing before hitting a user breakpoint.`,
+            `Debug session '${effectiveSessionName}' terminated after serverReady processing before hitting a user breakpoint (unexpected: user cancelled or app exited).`,
             finalStop.session.id
           )
         );

src/stopInfoMarkdown.ts

@@ -2,6 +2,7 @@ import type { BreakpointDefinition } from "./BreakpointDefinition";
 import type { StartDebuggerStopInfo } from "./session";
 import { markdownTable } from "markdown-table";
 import { config } from "./config";
+import { version } from "./generated-meta";
 
 // Keep rendering logic shared between StartDebuggerTool and ResumeDebugSessionTool.
 
@@ -256,6 +257,7 @@ export const renderStopInfoMarkdown = (params: {
     guidance.length > 0 ? guidance.map((item) => `- ${item}`).join("\n") : "";
 
   const successLine = `Success: ${success}`;
+  const versionLine = `Plugin Version: ${version}`;
 
   const serverReadySection = (() => {
     const info = stopInfo.serverReadyInfo;
@@ -289,7 +291,7 @@ export const renderStopInfoMarkdown = (params: {
   const sections: Array<{ title: string; body: string }> = [
     {
       title: "Summary",
-      body: [successLine, timestampLine, header]
+      body: [successLine, versionLine, timestampLine, header]
         .filter((entry) => entry && entry.trim().length > 0)
         .join("\n"),
     },

src/test/autoCapture.test.ts

@@ -45,6 +45,7 @@ describe("startDebuggingAndWaitForStop - capture-all (variableFilter empty)", ()
     const context = await startDebuggingAndWaitForStop(
       Object.assign({}, baseParams, {
         sessionName: "",
+        mode: "inspect" as const,
         breakpointConfig: {
           breakpoints: [
             {

src/test/snippetBreakpoints.test.ts

@@ -94,4 +94,35 @@ describe("snippet-based breakpoints", function () {
       }
     );
   });
+
+  it("throws when 'code' snippet is missing (even if line is provided)", async () => {
+    await activateCopilotDebugger();
+    const extensionRoot = getExtensionRoot();
+    const workspaceFolder = path.join(extensionRoot, "test-workspace");
+    const scriptPath = path.join(workspaceFolder, "test.js");
+
+    await assert.rejects(
+      () =>
+        startDebuggingAndWaitForStop({
+          sessionName: "",
+          workspaceFolder,
+          nameOrConfiguration: "Run test.js",
+          breakpointConfig: {
+            breakpoints: [
+              {
+                path: scriptPath,
+                line: 10,
+                onHit: "break",
+                variableFilter: [],
+                // eslint-disable-next-line ts/no-explicit-any
+              } as any, // Cast to any to bypass TS check for missing 'code'
+            ],
+          },
+        }),
+      (err: unknown) => {
+        const msg = err instanceof Error ? err.message : String(err);
+        return msg.includes("missing required 'code' snippet");
+      }
+    );
+  });
 });