Debug This Crash
debug_this_crashInspect stopped debugger sessions or core dumps and launch DAP debuggers to gather stack, variables, and exception evidence, returning a root-cause diagnosis with verification status.
Instructions
Preferred high-level native crash workflow. Use mode=current for an already stopped session, dump for read-only postmortem analysis, codelldb to discover CodeLLDB, lldb-dap to discover upstream LLVM lldb-dap, gdb to discover GNU GDB built-in DAP interpreter, or live with an already initialized generic DAP adapter. Do not use codelldb/lldb-dap/gdb/live when executing or attaching to the target is not authorized: those modes can run application code and cause its normal side effects, while current/dump only inspect stopped evidence. workflow.stage selects initial diagnosis, verification against a prior baseline, or the bounded autonomous cycle. Returns runtime evidence, diagnosis, verification/autonomous metadata, and debugger status with deterministic fixed/blocked/budget-exhausted outcomes where applicable.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Working directory for the selected debugger/target launch and a project-root hint for diagnosis. | |
| env | No | Environment variables supplied to the launched program in codelldb/lldb-dap/gdb modes. | |
| args | No | Command-line arguments passed to the launched program in codelldb/lldb-dap/gdb modes. | |
| mode | No | current inspects an existing stop; live uses an initialized generic DAP session; codelldb starts CodeLLDB; lldb-dap starts upstream LLVM lldb-dap; gdb starts GNU GDB with --interpreter=dap; dump opens a frozen core/minidump. | current |
| program | No | Required for codelldb/lldb-dap/gdb launch modes; optional for CodeLLDB/GDB dumps but required when dumpAdapter=lldb-dap. Local path to the native executable. | |
| request | No | For mode=live, choose whether the initialized DAP adapter launches a target or attaches to an existing authorized target. | launch |
| analysis | No | Hints used to distinguish project code from runtime, system, or third-party frames. | |
| dumpPath | No | Required for mode=dump: local path to the native core/minidump file. | |
| snapshot | No | Bounds and optional evidence categories for a runtime crash snapshot. | |
| workflow | No | Controls one-shot diagnosis, explicit verification, or the bounded autonomous crash workflow. | |
| sessionId | No | Optional DAP session ID. Omit to use the backward-compatible default session. | |
| sourceMap | No | For mode=dump, map source paths stored in debug symbols to local source paths. | |
| timeoutMs | No | Maximum milliseconds to wait for the reproduction to stop, exit, or terminate. | |
| adapterPath | No | Optional explicit debugger executable/adapter path for codelldb/lldb-dap/gdb/dump modes; omit to auto-discover the selected adapter. | |
| breakpoints | No | Optional source breakpoints configured before a live/codelldb reproduction completes setup. | |
| dumpAdapter | No | For mode=dump, choose CodeLLDB, upstream LLVM lldb-dap coreFile loading, or GNU GDB coreFile attach semantics. | codelldb |
| stopOnEntry | No | When true in codelldb/lldb-dap/gdb modes, request an initial debugger stop at program entry before normal execution. | |
| configuration | No | Required for mode=live: adapter-specific DAP launch/attach configuration. | |
| requestTimeoutMs | No | Per-request DAP timeout in milliseconds for the selected debugger adapter. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| status | Yes | ||
| workflow | No | ||
| diagnosis | No |