dap-mcp-server 0.1.9 → 0.1.11

package/README.md

@@ -24,12 +24,15 @@ Additional adapters (e.g. Node.js via js-debug) can be registered via the `confi
 
 | Tool | Description |
 |------|-------------|
-| `debug_launch` | Start a debug session (launch a program with breakpoints) |
+| `debug_inspect` | **One-shot:** launch → run to breakpoint → evaluate expressions → disconnect. Use first when you just need a value at a line. |
+| `debug_run` | **One-shot:** launch → run to completion → return all output. Combine with logpoints for printf-style debugging without editing source. |
+| `debug_launch` | Start an interactive debug session (launch a program with breakpoints) |
 | `debug_attach` | Attach to a running process |
 | `debug_restart` | Restart with the same configuration |
 | `debug_disconnect` | End a debug session |
-| `set_breakpoints` | Set/replace breakpoints in a file |
+| `set_breakpoints` | Set/replace breakpoints in a file (use `logMessage` for logpoints) |
 | `set_exception_breakpoints` | Break on exceptions |
+| `list_breakpoints` | List currently-registered breakpoints for a session |
 | `get_state` | Get threads, stack trace, scopes, and variables |
 | `evaluate` | Evaluate an expression in the debuggee context |
 | `step` | Continue, next, stepIn, stepOut, or pause |

package/SKILL.md

@@ -7,56 +7,203 @@ description: Use when debugging a program — when you need to set breakpoints,
 
 You have access to a real debugger via the `dap` MCP server. **Use it instead of adding print/log statements** whenever you need to understand runtime behavior, track down a bug, or verify a fix.
 
-## When to Use the Debugger
+## When to switch from print() to the debugger
 
-- A test fails and the cause is not obvious from the error message or stack trace
-- You need to inspect the value of variables at a specific point in execution
-- You suspect a logic error in a loop, conditional, or data transformation
-- A function returns an unexpected result and you want to trace the execution path
-- You want to verify your fix actually changes behavior at the right point
+Reach for the debugger — don't keep guessing — when any of these are true:
 
-## Quick Start
+- **Your first fix attempt was wrong.** Stop iterating on guesses. Inspect actual values.
+- **You're about to add 3+ print statements.** Use a logpoint instead (see below) — same information, no code edits.
+- **You need a value on iteration N of a loop.** Use `hitCondition: "N"` instead of conditional prints.
+- **A test fails with a non-obvious traceback.** Launch the test under the debugger; you'll see locals at the failure site.
+- **You're reasoning about state that's modified across many call sites.** A conditional breakpoint on the value beats grepping for assignments.
 
-1. Check available adapters: call `list_adapters` to see what's installed.
-2. Launch with breakpoints in a single call:
+Print debugging is fine for: trivial one-line checks, scripts you'll throw away in the next message, or when you genuinely just want to see "did this code path execute?".
+
+## Logpoints — print debugging without editing code
+
+A **logpoint** is a breakpoint that doesn't pause execution. It just emits a formatted message every time it's hit. This is the single most useful feature for AI agents.
+
+Set it via the `logMessage` field on a breakpoint:
 
 ```
-debug_launch({
-  adapter: "python",         // or "node", "go", "cpp"
-  program: "/absolute/path/to/file.py",
-  stopOnEntry: false,
+set_breakpoints({
+  file: "/abs/path/src/foo.py",
   breakpoints: [
-    { file: "/absolute/path/to/file.py", line: 42 }
+    { line: 42, logMessage: "x={x} y={y} state={self.state}" },
+    { line: 88, logMessage: "iteration {i}: items={len(items)}" }
   ]
 })
 ```
 
-3. When the program stops, the response already contains the full state (threads, stack, scopes, variables). Read it — no extra call needed.
-4. Step through code with `step({ action: "next" })` — the response includes the new state.
-5. Evaluate expressions with `evaluate({ expression: "len(items)" })`.
-6. When done, call `debug_disconnect`.
+Then `step({ action: "continue" })` and let the program run. Retrieve every log with `get_output`. You get the same information as inserting `print(f"x={x} y={y}")` at five places — without touching the source file, without re-running, and with the program's natural execution preserved.
+
+**When to use logpoints over breakpoints**: when you want to *observe* values across many hits rather than *interrupt* execution to inspect one. They are the right tool ~70% of the time.
+
+Expression syntax inside `{...}` depends on the adapter (debugpy: Python; node: JS). The expression is evaluated in the breakpoint's scope.
+
+## Debugging a failing test
+
+This is the dominant case. Use the test runner as the program, with the specific test as an argument.
+
+### pytest
+
+```
+debug_launch({
+  adapter: "python",
+  program: "/abs/path/.venv/bin/pytest",
+  args: ["tests/test_foo.py::test_bar", "-x", "--no-header"],
+  cwd: "/abs/path",
+  breakpoints: [{ file: "/abs/path/src/foo.py", line: 42 }],
+  stopOnEntry: false,
+})
+```
+
+For pytest, also consider setting `exceptionBreakpoints: ["raised"]` — pytest swallows exceptions before you see them, but the debugger will stop at the raise site.
+
+### vitest / jest (Node.js)
+
+Requires the `node` adapter configured (see "Node.js setup" below). Use the runner binary from `node_modules/.bin`:
+
+```
+debug_launch({
+  adapter: "node",
+  program: "${cwd}/node_modules/.bin/vitest",
+  args: ["run", "tests/foo.test.ts", "-t", "the failing test name"],
+  cwd: "/abs/path",
+  breakpoints: [{ file: "/abs/path/src/foo.ts", line: 42 }],
+  stopOnEntry: false,
+})
+```
+
+### go test
+
+```
+debug_launch({
+  adapter: "go",
+  program: "${cwd}",   // delve takes a package dir, not a binary
+  args: ["-test.run", "TestFoo", "-test.v"],
+  cwd: "/abs/path",
+  breakpoints: [{ file: "/abs/path/foo.go", line: 42 }],
+  stopOnEntry: false,
+})
+```
+
+Delve uses `dlv test` semantics under the hood when the program is a package directory containing test files.
+
+### Node.js setup
+
+If `list_adapters` shows no `node` entry, register it once (path depends on installed extension):
+
+```
+configure_adapter({
+  type: "node",
+  runtime: "node",
+  program: "/abs/path/to/js-debug/src/dapDebugServer.js",
+  args: [],
+  scope: "global",
+})
+```
+
+`js-debug-dap` ships with the VS Code Node debugger extension. Alternatively use `@vscode/js-debug` from npm.
+
+## Quick Start (single-file program)
+
+1. `list_adapters` — see what's installed.
+2. Launch with breakpoints in one call:
+
+```
+debug_launch({
+  adapter: "python",
+  program: "/abs/path/file.py",
+  stopOnEntry: false,
+  breakpoints: [{ file: "/abs/path/file.py", line: 42 }],
+})
+```
+
+3. The response already contains the full state (threads, stack, scopes, variables) when the breakpoint is hit. No follow-up `get_state` needed.
+4. Step with `step({ action: "next" })` — response includes the new state.
+5. `evaluate({ expression: "len(items)" })` for ad-hoc inspection.
+6. `debug_disconnect` when done.
+
+## Stepping strategy
+
+- **`next`** (step over) is the default choice. Use it unless you have a specific reason not to.
+- **`stepIn`** only when you suspect the bug is *inside* the function being called — not at the call site. Stepping into library code will get you lost fast.
+- **`stepOut`** to bail out of a function you stepped into by mistake.
+- **`continue`** to run to the next breakpoint. With logpoints set, this is how you collect runtime traces.
+
+If you find yourself stepping line-by-line for more than ~10 steps, you're probably doing it wrong. Set a breakpoint at the next interesting location and continue to it.
+
+## Worked example
+
+Bug: `compute_total(items)` returns `0` when items contain a tax-exempt entry.
+
+```
+# Launch under pytest with a breakpoint at the suspect line
+debug_launch({
+  adapter: "python",
+  program: "/proj/.venv/bin/pytest",
+  args: ["tests/test_billing.py::test_tax_exempt", "-x"],
+  cwd: "/proj",
+  breakpoints: [{ file: "/proj/src/billing.py", line: 57 }],
+  stopOnEntry: false,
+})
+
+# Response (paraphrased):
+# {
+#   sessionId: "s-1",
+#   status: "stopped",
+#   location: { file: ".../billing.py", line: 57, functionName: "compute_total" },
+#   scopes: [{ name: "Locals", variables: [
+#     { name: "items", value: "[{...}, {...}]", ... },
+#     { name: "subtotal", value: "100", ... },
+#     { name: "tax", value: "0", ... }
+#   ] }]
+# }
+
+# Inspect the exempt item more closely
+evaluate({ expression: "[i for i in items if i.get('tax_exempt')]" })
+# → [{name: 'book', price: 100, tax_exempt: True}]
+
+# Step over to see what compute_total actually returns
+step({ action: "next" })
+# → see that `total = subtotal + tax` returns 100, not 0. Bug is upstream.
+
+# Continue to verify nothing else changes the return
+step({ action: "continue" })
+
+debug_disconnect()
+```
+
+Fix locally, re-run the test, done.
 
 ## Key Rules
 
 - **Do NOT call `get_state` after `step`** — `step` already returns the new stopped state.
-- **Omit `sessionId`** when only one debug session is active — the server resolves it automatically.
+- **Omit `sessionId`** when only one debug session is active.
 - **Use absolute paths** for `program` and breakpoint `file` parameters.
-- **Prefer `stopOnEntry: false` with breakpoints** over `stopOnEntry: true` — it gets you directly to the interesting code.
-- **Check `get_output`** for program stdout/stderr if you need to see what the program printed.
+- **Prefer `stopOnEntry: false` with breakpoints** — it gets you directly to the interesting code.
+- **Use `get_output`** for program stdout/stderr (including logpoint output).
 
 ## Debugging Strategies
 
 ### Narrowing down a bug
-1. Set a breakpoint where you know the state is still correct.
-2. Set another breakpoint where the state is wrong.
-3. Use `step` with `action: "next"` to walk through the code between them.
-4. Use `evaluate` to check intermediate values.
+1. Set a breakpoint where state is known good.
+2. Set another where state is wrong.
+3. Use `step` with `next` to walk between them, or set intermediate logpoints.
 
 ### Understanding a crash
-1. Launch with `exceptionBreakpoints: ["uncaughtExceptions"]`.
-2. When it stops on the exception, inspect the stack and variables.
+1. Launch with `exceptionBreakpoints: ["uncaughtExceptions"]` (or `"raised"` for any raise).
+2. When stopped at the exception, inspect stack and locals.
 
 ### Verifying a fix
 1. Set a breakpoint at the fixed code.
-2. Run to it, inspect variables, confirm the new behavior.
+2. Run to it, inspect variables, confirm new behavior.
 3. Continue to verify the program completes successfully.
+
+### Observing a hot loop without stopping it
+1. Set logpoints at the relevant lines with `{i}` and any state expression.
+2. `continue`.
+3. Read the trace via `get_output`. For long-running programs, poll incrementally:
+   pass the `nextSince` value from each call as the `since` parameter of the next call
+   to receive only newly-emitted entries.

package/TODO.md

@@ -0,0 +1,32 @@
+# DAP MCP Server — Improvement TODO
+
+Findings from a self-review of how usable this MCP is for an AI agent. Ordered by priority (descending). Check items off as completed.
+
+## Tier 1 — Documentation (SKILL.md). High leverage, low risk.
+
+- [x] **P1 — Logpoints section.** `breakpoints[].logMessage` is already wired through (session.ts:138) but is invisible in SKILL.md. It is the closest thing to a drop-in replacement for `print()` debugging: no code edits, captures every hit, no execution pause. Should have its own headline section with an example.
+- [x] **P2 — "Debug a failing test" section.** Most real bugs surface inside test runners (pytest, vitest, jest, go test, cargo test). Currently zero guidance. Add a per-framework template for launching a single test under the debugger.
+- [x] **P3 — "Switch from print() to debugger" triggers.** Concrete rules an AI agent will actually follow: "if first fix attempt was wrong, stop guessing"; "if about to add 3+ prints, use logpoints"; "if reasoning about iteration N, use `hitCondition`"; "if traceback is non-obvious, launch test under debugger".
+- [x] **P4 — Stepping strategy.** Default to `next`. Use `stepIn` only when you suspect the bug is *inside* the called function. Otherwise agents get lost in library internals.
+- [x] **P5 — Full worked example.** Real bug → real `debug_launch` call → real returned state → identified fix. Replaces all the abstract advice with one concrete walkthrough.
+- [x] **P5b — Node.js adapter recipe.** Builtin was removed; add a ready-to-paste `configure_adapter` snippet for `js-debug-dap`.
+
+## Tier 2 — Code changes that materially improve UX.
+
+- [x] **P6 — `debug_inspect` macro tool.** One call: launch, run to a breakpoint, evaluate a list of expressions, disconnect. Collapses a 5–7 round-trip workflow into 1. Most likely change to make me reach for the debugger reflexively.
+- [x] **P7 — Flip `stopOnEntry` default to `false` when breakpoints are provided.** Today defaults to `true` regardless (server.ts:206). Doing the right thing automatically is better than relying on the agent reading the SKILL.md.
+- [x] **P8 — Structured deep variables.** `getVariables` with `depth > 1` flattens children into the value string (session.ts:271–278). Hard for the AI to consume. Return nested `children: [...]` instead.
+- [x] **P9 — `list_adapters` summary line + surfaced install hints.** Add `summary: "2/4 installed"` and lift `installHint` for missing adapters to the top level so it's scannable.
+- [x] **P10 — `debug_run` macro tool.** Launch, run to completion, return all stdout/stderr. Zero breakpoints, zero round-trips. For "what does this script actually print/crash with?" cases.
+
+## Tier 3 — Polish.
+
+- [x] **P11 — Better "session is not stopped" error.** Currently says "use step with action: pause" (server.ts:549) — bad advice (Python `pause` lands in arbitrary library code). Suggest "set a breakpoint where you want to inspect, then continue to it".
+- [x] **P12 — Version drift.** `McpServer` registers as `0.1.0` (server.ts:48); package.json is `0.1.10`. Read from `package.json`.
+- [x] **P13 — `list_breakpoints` tool.** After several `set_breakpoints` calls, no way to introspect what's set. Minor.
+
+## Tier 4 — Speculative.
+
+- [x] **`get_output({ since })` for incremental polling.** Smaller substitute for streaming subscriptions. Caller passes the `nextSince` value from a prior call to receive only newly-emitted entries. Useful for watching logpoint output during `continue` against long-running programs.
+- [ ] ~~Streaming output via MCP resource subscriptions.~~ AI agents don't watch streams in real time; the request/response pattern doesn't benefit. `since`-based polling covers the practical case.
+- [ ] ~~Auto-detect test runner from program path.~~ Too magic; SKILL.md recipes (P2) make the right call explicit, and silent misfires would be worse than no detection at all.

package/build/adapters/builtin.js

@@ -25,6 +25,9 @@ export const BUILTIN_ADAPTERS = [
         runtime: "python3",
         program: "-m",
         args: ["debugpy.adapter"],
+        launchDefaults: {
+            console: "internalConsole",
+        },
         installHint: "pip install debugpy",
     },
     // node adapter removed — no reliable universal path to js-debug-dap.

package/build/adapters/builtin.js.map

@@ -1 +1 @@
-{"version":3,"file":"builtin.js","sourceRoot":"","sources":["../../src/adapters/builtin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,CAAC,iBAAiB,CAAC;QACzB,WAAW,EAAE,qBAAqB;KACnC;IACD,qEAAqE;IACrE,6CAA6C;IAC7C;QACE,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,KAAK,CAAC;QACb,WAAW,EAAE,qDAAqD;KACnE;IACD;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,UAAU;QACnB,IAAI,EAAE,EAAE;QACR,WAAW,EAAE,+DAA+D;KAC7E;CACF,CAAC"}
+{"version":3,"file":"builtin.js","sourceRoot":"","sources":["../../src/adapters/builtin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,CAAC,iBAAiB,CAAC;QACzB,cAAc,EAAE;YACd,OAAO,EAAE,iBAAiB;SAC3B;QACD,WAAW,EAAE,qBAAqB;KACnC;IACD,qEAAqE;IACrE,6CAA6C;IAC7C;QACE,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,KAAK,CAAC;QACb,WAAW,EAAE,qDAAqD;KACnE;IACD;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,UAAU;QACnB,IAAI,EAAE,EAAE;QACR,WAAW,EAAE,+DAA+D;KAC7E;CACF,CAAC"}

package/build/dap/dap-client.js

@@ -53,7 +53,11 @@ export class DAPClient extends EventEmitter {
             const cmd = this.runtime || this.executable;
             this.process = spawn(cmd, runtimeArgs, {
                 stdio: ["pipe", "pipe", "pipe"],
+                detached: true,
             });
+            // Detached child must be unref'd so the parent Node process can exit
+            // even if the adapter is still running (cleanup happens via dispose()).
+            this.process.unref();
             this.parser = new MessageParser((msg) => this.handleMessage(msg));
             this.process.stdout.on("data", (data) => {
                 this.parser.feed(data);
@@ -156,6 +160,25 @@ export class DAPClient extends EventEmitter {
                 }
             }
         }
+        else if (msg.type === "request") {
+            // Reverse request from the adapter (e.g. runInTerminal).
+            // We reject all reverse requests — the MCP server has no terminal.
+            const req = msg;
+            const errorResponse = {
+                seq: this.seq++,
+                type: "response",
+                request_seq: req.seq,
+                command: req.command,
+                success: false,
+                message: `Reverse request '${req.command}' is not supported by this client`,
+            };
+            try {
+                this.process?.stdin?.write(encodeMessage(errorResponse));
+            }
+            catch {
+                // ignore — process may have exited
+            }
+        }
         else if (msg.type === "event") {
             const event = msg;
             this.emit(event.event, event);

package/build/dap/dap-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"dap-client.js","sourceRoot":"","sources":["../../src/dap/dap-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dap-client.js","sourceRoot":"","sources":["../../src/dap/dap-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,KAAK,EAAgB,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE7D,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAQD,MAAM,OAAO,SAAU,SAAQ,YAAY;IACjC,OAAO,CAAS;IAChB,UAAU,CAAS;IACnB,IAAI,CAAW;IACf,OAAO,CAAgB;IACvB,MAAM,CAAiB;IACvB,GAAG,GAAG,CAAC,CAAC;IACR,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC5C,YAAY,GAAa,EAAE,CAAC;IAC5B,OAAO,GAAG,KAAK,CAAC;IAChB,SAAS,CAAU;IAE3B,YAAY,OAAe,EAAE,UAAkB,EAAE,OAAiB,EAAE;QAClE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO;gBAC9B,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;gBACjC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACd,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC;YAE5C,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,WAAW,EAAE;gBACrC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;gBAC/B,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;YAEH,qEAAqE;YACrE,wEAAwE;YACxE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAErB,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;YAElE,IAAI,CAAC,OAAO,CAAC,MAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBAC/C,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,OAAO,CAAC,MAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBAC/C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC1C,CAAC,CAAC,CAAC;YAEH,oFAAoF;YACpF,IAAI,CAAC,OAAO,CAAC,KAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACnC,mDAAmD;YACrD,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC/B,MAAM,CAAC,IAAI,cAAc,CAAC,4BAA4B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACxE,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;gBACvC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;gBACpB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,SAAS,CAAC;gBACnC,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBACnC,IAAI,GAAG,CAAC,KAAK;wBAAE,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;oBACvC,GAAG,CAAC,MAAM,CACR,IAAI,cAAc,CAChB,wBAAwB,IAAI,YAAY,MAAM,cAAc,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CACzF,CACF,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACrB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAClC,CAAC,CAAC,CAAC;YAEH,2EAA2E;YAC3E,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,MAAO,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE;gBACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAAC,QAAQ,GAAG,IAAI,CAAC;oBAAC,OAAO,EAAE,CAAC;gBAAC,CAAC;YAChD,CAAC,CAAC,CAAC;YACH,UAAU,CAAC,GAAG,EAAE;gBACd,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAAC,QAAQ,GAAG,IAAI,CAAC;oBAAC,OAAO,EAAE,CAAC;gBAAC,CAAC;YAChD,CAAC,EAAE,GAAG,CAAC,CAAC;QACV,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CACf,OAAe,EACf,IAA8B,EAC9B,OAAO,GAAG,KAAK;QAEf,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,cAAc,CACtB,4BAA4B,IAAI,CAAC,SAAS,cAAc,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CACrF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;YACnC,MAAM,IAAI,cAAc,CAAC,+BAA+B,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAA0B;YACrC,GAAG;YACH,IAAI,EAAE,SAAS;YACf,OAAO;YACP,SAAS,EAAE,IAAI;SAChB,CAAC;QAEF,OAAO,IAAI,OAAO,CAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7D,MAAM,OAAO,GAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YACpD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBACzB,MAAM,CAAC,IAAI,cAAc,CAAC,YAAY,OAAO,mBAAmB,OAAO,IAAI,CAAC,CAAC,CAAC;gBAChF,CAAC,EAAE,OAAO,CAAC,CAAC;YACd,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC/B,IAAI,CAAC;gBACH,IAAI,CAAC,OAAQ,CAAC,KAAM,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE;oBACzD,IAAI,GAAG,EAAE,CAAC;wBACR,iDAAiD;wBACjD,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;wBAChC,IAAI,CAAC,EAAE,CAAC;4BACN,IAAI,CAAC,CAAC,KAAK;gCAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;4BACnC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;4BACzB,CAAC,CAAC,MAAM,CAAC,IAAI,cAAc,CAAC,4BAA4B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;wBAC1E,CAAC;oBACH,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACzB,IAAI,OAAO,CAAC,KAAK;oBAAE,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC/C,MAAM,CAAC,IAAI,cAAc,CAAC,4BAA6B,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACnF,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,aAAa,CAAC,GAAkC;QACtD,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,GAA6B,CAAC;YAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YACvD,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,OAAO,CAAC,KAAK;oBAAE,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;gBAC1C,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;oBACrB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAC5B,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,MAAM,CACZ,IAAI,cAAc,CAChB,iBAAiB,QAAQ,CAAC,OAAO,MAAM,QAAQ,CAAC,OAAO,IAAI,eAAe,EAAE,CAC7E,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAClC,yDAAyD;YACzD,mEAAmE;YACnE,MAAM,GAAG,GAAG,GAA4B,CAAC;YACzC,MAAM,aAAa,GAA2B;gBAC5C,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;gBACf,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,GAAG,CAAC,GAAG;gBACpB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,oBAAoB,GAAG,CAAC,OAAO,mCAAmC;aAC5E,CAAC;YACF,IAAI,CAAC;gBACH,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;YAC3D,CAAC;YAAC,MAAM,CAAC;gBACP,mCAAmC;YACrC,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,GAA0B,CAAC;YACzC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC5B,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;oBAC9B,OAAO,EAAE,CAAC;gBACZ,CAAC,EAAE,IAAI,CAAC,CAAC;gBACT,IAAI,CAAC,OAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;oBAC5B,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/build/dap/types.d.ts

@@ -20,6 +20,15 @@
  * SOFTWARE.
  */
 export type SessionState = "idle" | "configuring" | "running" | "stopped" | "terminated";
+export interface Variable {
+    name: string;
+    value: string;
+    type?: string;
+    hasChildren: boolean;
+    variablesReference: number;
+    /** Populated when getVariables is called with depth > 1 and this variable has children. */
+    children?: Variable[];
+}
 export interface StoppedState {
     status: "stopped";
     reason: string;
@@ -43,13 +52,7 @@ export interface StoppedState {
     }>;
     scopes: Array<{
         name: string;
-        variables: Array<{
-            name: string;
-            value: string;
-            type?: string;
-            hasChildren: boolean;
-            variablesReference: number;
-        }>;
+        variables: Variable[];
     }>;
     output?: string[];
 }
@@ -68,6 +71,8 @@ export interface AdapterConfig {
     installHint?: string;
 }
 export interface OutputEntry {
+    /** Monotonic per-session sequence number assigned at push time. Survives ring-buffer eviction. */
+    seq: number;
     category: string;
     text: string;
     timestamp: string;