Start a debug session. mode: launch|compile_launch|attach. debugger: gdb|lldb.

Kill (launch) or detach (attach) and free the session.

Resume execution until the next stop, exit, or timeout.

Step the current thread. kind: over|into|out. granularity: line|instruction.

Interrupt a running program.

This only acknowledges the pause request; it does NOT wait for the stop. A continue/step in flight holds the session lock for its whole await-for-stop, so pause must run lock-free to interrupt it. The resulting stopped event is delivered to that in-flight call's waiter, which returns the stop snapshot to its own caller. The caller of dbg_pause receives only this ack.

Residual race (acceptable): pause may transiently reject at the exact instant a continue/step starts, while state is still STOPPED for the microsecond before run_and_wait flips it to RUNNING under the lock. Flipping to RUNNING early (before awaiting the resume response) minimizes this window.

Set a breakpoint at file:line OR on a function. Optional condition / hit count / logpoint.

List all breakpoints tracked in this session, with their stable handles.

Remove a breakpoint by its stable session handle and resync the affected list.

Set a data breakpoint (watchpoint) on a variable. access: read|write|rw.

Return up to levels stack frames for a thread (default current thread).

List all threads of the debuggee.

Set the active frame for evaluate/scopes/variables.

List variable scopes (Locals, Registers, ...) for a frame.

List variables under a variablesReference (from scopes or an expandable var).

Evaluate an expression in a frame. Handles reads AND function calls (e.g. 'square(v)' or 'call square(v)'). context: watch|repl|hover.

Set a variable (by container ref + name) to a new value.

Read count bytes of memory (base64) from a memory reference.

Disassemble around a memory reference.

Return source lines around file:line (defaults to the current stop frame).

Run a raw gdb/lldb command via the DAP evaluate repl context. Use for the long tail no structured tool covers (e.g. 'info registers').