Module debug_tool 

Debug tool — DAP-backed debugger integration (scaffold). Debug tool — Debugger integration via DAP (Debug Adapter Protocol).

Provides model-driven access to a debugger through the xd://debug virtual device, which wraps DAP clients for common debug adapters (gdb, lldb-dap, debugpy, dlv).

Status

This is a scaffold. The tool validates the requested action against the supported DAP set and returns a structured pointer describing how the same operation would be issued via the xd://debug device. A future change will route execute to wrap the device directly, streaming results back as the tool return value.

For now, callers wanting real debugger control should use the host harness’s xd://debug device directly. The agent still observes a regular AgentToolResult round-trip — the contract is preserved while the proxy wiring is being built.

Structs

DebugTool

debug agent tool — DAP-backed debugger integration.