Add breakOnSystemExit setting to launch/attach configuration schema (#1078)

* Add breakOnSystemExit setting to launch/attach schema

Exposes debugpy's breakOnSystemExit option (microsoft/debugpy#2017) in the extension's launch.json/attach configuration schema and TypeScript debug config types. Accepts an array of exit codes and/or inclusive {from,to} ranges to control which SystemExit codes cause the debugger to break.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 24c2d34b-15f0-45d2-bd59-8ee042269d20

* Clarify breakOnSystemExit default behavior in schema description

Describe the default as an ignore-list ({0, None}, plus 3 under Django/Flask) that breaks on any other code when uncaught-exception breaking is enabled, rather than the looser 'break on all non-zero exit codes'.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 24c2d34b-15f0-45d2-bd59-8ee042269d20

---------

Copilot-Session: 24c2d34b-15f0-45d2-bd59-8ee042269d20

Author: rchiodo

package.json

@@ -186,6 +186,37 @@
                                 },
                                 "type": "object"
                             },
+                            "breakOnSystemExit": {
+                                "description": "Controls which SystemExit exit codes cause the debugger to break. Accepts an array of exit codes and/or inclusive ranges. Set to an empty array to never break on SystemExit. When omitted, the debugger's default applies: successful exits (SystemExit(0) and SystemExit(None), plus 3 under Django/Flask) are ignored, and any other code causes a break when uncaught-exception breaking is enabled.",
+                                "type": "array",
+                                "items": {
+                                    "oneOf": [
+                                        {
+                                            "type": "integer",
+                                            "description": "A specific SystemExit code to break on."
+                                        },
+                                        {
+                                            "type": "object",
+                                            "additionalProperties": false,
+                                            "description": "An inclusive range of SystemExit codes to break on.",
+                                            "properties": {
+                                                "from": {
+                                                    "type": "integer",
+                                                    "description": "Lower bound of the range (inclusive)."
+                                                },
+                                                "to": {
+                                                    "type": "integer",
+                                                    "description": "Upper bound of the range (inclusive)."
+                                                }
+                                            },
+                                            "required": [
+                                                "from",
+                                                "to"
+                                            ]
+                                        }
+                                    ]
+                                }
+                            },
                             "connect": {
                                 "label": "Attach by connecting to debugpy over a socket.",
                                 "properties": {
@@ -405,6 +436,37 @@
                                 },
                                 "type": "object"
                             },
+                            "breakOnSystemExit": {
+                                "description": "Controls which SystemExit exit codes cause the debugger to break. Accepts an array of exit codes and/or inclusive ranges. Set to an empty array to never break on SystemExit. When omitted, the debugger's default applies: successful exits (SystemExit(0) and SystemExit(None), plus 3 under Django/Flask) are ignored, and any other code causes a break when uncaught-exception breaking is enabled.",
+                                "type": "array",
+                                "items": {
+                                    "oneOf": [
+                                        {
+                                            "type": "integer",
+                                            "description": "A specific SystemExit code to break on."
+                                        },
+                                        {
+                                            "type": "object",
+                                            "additionalProperties": false,
+                                            "description": "An inclusive range of SystemExit codes to break on.",
+                                            "properties": {
+                                                "from": {
+                                                    "type": "integer",
+                                                    "description": "Lower bound of the range (inclusive)."
+                                                },
+                                                "to": {
+                                                    "type": "integer",
+                                                    "description": "Upper bound of the range (inclusive)."
+                                                }
+                                            },
+                                            "required": [
+                                                "from",
+                                                "to"
+                                            ]
+                                        }
+                                    ]
+                                }
+                            },
                             "console": {
                                 "default": "integratedTerminal",
                                 "description": "Where to launch the debug target: internal console, integrated terminal, or external terminal.",

src/extension/types.ts

@@ -43,6 +43,11 @@ export type PathMapping = {
     remoteRoot: string;
 };
 
+export type SystemExitRange = {
+    from: number;
+    to: number;
+};
+
 type Connection = {
     host?: string;
     port?: number | string;
@@ -69,6 +74,9 @@ interface ICommonDebugArguments {
     // Show return values of functions while stepping.
     showReturnValue?: boolean;
     subProcess?: boolean;
+    // SystemExit codes (and/or inclusive ranges) that cause the debugger to break.
+    // An empty array disables breaking on SystemExit entirely.
+    breakOnSystemExit?: (number | SystemExitRange)[];
     // An absolute path to local directory with source.
     pathMappings?: PathMapping[];
 }