agent-debugger 0.1.0

package/README.md

@@ -0,0 +1,131 @@
+# agent-debugger
+
+CLI debugger for AI agents. Set breakpoints, inspect variables, evaluate expressions, and step through code — in Python, JavaScript, Go, Rust, C, and C++.
+
+Built on the [Debug Adapter Protocol](https://microsoft.github.io/debug-adapter-protocol/) (DAP), the same protocol that powers VS Code's debugger. One CLI, multiple language backends.
+
+## Install
+
+```bash
+npm install -g agent-debugger
+```
+
+Requires Node.js >= 18.
+
+## Quick Start
+
+```bash
+# Start a debug session, paused at line 25
+agent-debugger start app.py --break app.py:25
+
+# Inspect variables at the breakpoint
+agent-debugger vars
+
+# Evaluate any expression in the current scope
+agent-debugger eval "type(data['age'])"
+
+# Continue to the next breakpoint
+agent-debugger continue
+
+# Done
+agent-debugger close
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `start <script> [options]` | Start a debug session |
+| `vars` | List local variables in the current frame |
+| `eval <expression>` | Evaluate an expression in the current scope |
+| `step [into\|out]` | Step over, into a function, or out of a function |
+| `continue` | Resume execution until the next breakpoint |
+| `stack` | Show the call stack |
+| `break <file:line[:condition]>` | Add a breakpoint mid-session |
+| `source [file] [line]` | Show source code around the current line |
+| `status` | Show session state and current location |
+| `close` | End the debug session and clean up |
+
+### Start Options
+
+```bash
+agent-debugger start <script> [options]
+
+Options:
+  --break, -b <file:line[:condition]>   Set a breakpoint (repeatable)
+  --runtime <path>                      Path to language runtime (e.g. python, node)
+  --stop-on-entry                       Pause on the first line
+  --args <...>                          Arguments to pass to the script
+```
+
+### Breakpoints
+
+Multiple breakpoints and conditional breakpoints are supported:
+
+```bash
+# Multiple breakpoints
+agent-debugger start app.py --break app.py:25 --break app.py:40
+
+# Conditional breakpoint — only pause when the condition is true
+agent-debugger start app.py --break "app.py:30:i == 50"
+
+# Add a breakpoint to a running session
+agent-debugger break app.py:60
+```
+
+## Supported Languages
+
+| Language | Extensions | Debug Adapter | Setup |
+|----------|------------|---------------|-------|
+| Python | `.py` | [debugpy](https://github.com/microsoft/debugpy) | `pip install debugpy` |
+| JavaScript | `.js`, `.mjs`, `.cjs` | @vscode/js-debug | VS Code installed, or `JS_DEBUG_PATH` env var |
+| TypeScript | `.ts`, `.mts`, `.tsx` | @vscode/js-debug | Same as JavaScript |
+| Go | `.go` | Delve | `go install github.com/go-delve/delve/cmd/dlv@latest` |
+| Rust | `.rs` | CodeLLDB | `CODELLDB_PATH` env var |
+| C/C++ | `.c`, `.cpp`, `.cc` | CodeLLDB | Same as Rust |
+
+### Language-specific setup
+
+**Python** — install debugpy in the environment you want to debug:
+```bash
+pip install debugpy
+
+# Use a specific Python interpreter
+agent-debugger start app.py --break app.py:10 --runtime /path/to/venv/bin/python
+```
+
+**JavaScript/TypeScript** — requires VS Code's js-debug extension, which ships with any VS Code install. The adapter auto-detects it from `~/.vscode/extensions/`. To use a custom location:
+```bash
+export JS_DEBUG_PATH=/path/to/ms-vscode.js-debug-x.x.x
+```
+
+**Go** — install Delve:
+```bash
+go install github.com/go-delve/delve/cmd/dlv@latest
+```
+
+**Rust/C/C++** — set the path to the CodeLLDB adapter binary:
+```bash
+export CODELLDB_PATH=/path/to/codelldb/adapter/codelldb
+```
+
+## How It Works
+
+```
+CLI (stateless)  ──unix socket──▶  Daemon (session state)  ──TCP/DAP──▶  Debug Adapter
+                                                                          (debugpy, dlv, etc.)
+```
+
+- **CLI** (`agent-debugger`): Stateless client. Parses arguments, sends JSON commands over a Unix socket, prints results.
+- **Daemon**: Background process that manages the debug session. Spawns the debug adapter, connects via DAP, and translates CLI commands into DAP requests.
+- **Debug Adapter**: Language-specific process (debugpy, Delve, js-debug, CodeLLDB) that implements the Debug Adapter Protocol.
+
+The daemon starts automatically on the first command and shuts down when the session closes. Only one debug session runs at a time.
+
+## Programmatic API
+
+The `Session` class is exported for use as a library:
+
+```js
+import { Session } from "agent-debugger";
+```

package/bin/agent-debugger

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/src/cli.js');

package/dist/src/adapters/base.d.ts

@@ -0,0 +1,45 @@
+/** Base adapter interface for debug adapters. */
+import type { ChildProcess } from "node:child_process";
+import type { DAPClient } from "../dap-client.js";
+import type { StackFrame, Variable } from "../dap-types.js";
+import type { CommandResult } from "../protocol.js";
+export interface SpawnResult {
+    process: ChildProcess;
+    port: number;
+}
+export interface LaunchOpts {
+    program: string;
+    args?: string[];
+    cwd?: string;
+    stopOnEntry?: boolean;
+    /** Path to language runtime (e.g. python3, node, dlv) */
+    runtimePath?: string;
+}
+export interface InitFlowOpts extends LaunchOpts {
+    breakpoints?: Array<{
+        file: string;
+        lines: number[];
+        conditions?: Array<string | null>;
+    }>;
+}
+export interface AdapterConfig {
+    name: string;
+    /** Check if the debug adapter is installed. Returns null if OK, error message if not. */
+    checkInstalled(runtimePath?: string): Promise<string | null>;
+    /** Spawn the debug adapter process. Returns the child process and DAP port. */
+    spawn(opts: LaunchOpts): Promise<SpawnResult>;
+    /** Arguments for the DAP initialize request. */
+    initializeArgs(): Record<string, unknown>;
+    /** Arguments for the DAP launch request. */
+    launchArgs(opts: LaunchOpts): Record<string, unknown>;
+    /**
+     * Adapter-specific DAP initialization flow.
+     * Handles quirks like debugpy's deferred launch response.
+     */
+    initFlow(client: DAPClient, opts: InitFlowOpts): Promise<CommandResult>;
+    /** Filter internal frames (e.g. debugpy/pydevd internals). */
+    isInternalFrame(frame: StackFrame): boolean;
+    /** Filter internal variables (e.g. __dunder__ vars). */
+    isInternalVariable(v: Variable): boolean;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/src/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/adapters/base.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;KAAE,CAAC,CAAC;CAC3F;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IAEb,yFAAyF;IACzF,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE7D,+EAA+E;IAC/E,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE9C,gDAAgD;IAChD,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE1C,4CAA4C;IAC5C,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtD;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAExE,8DAA8D;IAC9D,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC;IAE5C,wDAAwD;IACxD,kBAAkB,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC1C"}

package/dist/src/adapters/base.js

@@ -0,0 +1,3 @@
+/** Base adapter interface for debug adapters. */
+export {};
+//# sourceMappingURL=base.js.map

package/dist/src/adapters/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/adapters/base.ts"],"names":[],"mappings":"AAAA,iDAAiD"}

package/dist/src/adapters/go.d.ts

@@ -0,0 +1,27 @@
+/** Go debug adapter — dlv (Delve). */
+import type { DAPClient } from "../dap-client.js";
+import type { StackFrame, Variable } from "../dap-types.js";
+import type { CommandResult } from "../protocol.js";
+import type { AdapterConfig, SpawnResult, LaunchOpts, InitFlowOpts } from "./base.js";
+export declare class GoAdapter implements AdapterConfig {
+    name: string;
+    checkInstalled(): Promise<string | null>;
+    spawn(opts: LaunchOpts): Promise<SpawnResult>;
+    initializeArgs(): Record<string, unknown>;
+    launchArgs(opts: LaunchOpts): Record<string, unknown>;
+    /**
+     * Delve DAP init flow (aligned with Python/debugpy pattern):
+     * 1. initialize
+     * 2. launch (async — response may be deferred)
+     * 3. wait for initialized event
+     * 4. setBreakpoints
+     * 5. setExceptionBreakpoints
+     * 6. configurationDone
+     * 7. wait for deferred launch response
+     * 8. wait for stopped event
+     */
+    initFlow(client: DAPClient, opts: InitFlowOpts): Promise<CommandResult>;
+    isInternalFrame(frame: StackFrame): boolean;
+    isInternalVariable(v: Variable): boolean;
+}
+//# sourceMappingURL=go.d.ts.map

package/dist/src/adapters/go.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"go.d.ts","sourceRoot":"","sources":["../../../src/adapters/go.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAGtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGtF,qBAAa,SAAU,YAAW,aAAa;IAC7C,IAAI,SAAQ;IAEN,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASxC,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAanD,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYzC,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYrD;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA4E7E,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO;IAM3C,kBAAkB,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO;CAGzC"}

package/dist/src/adapters/go.js

@@ -0,0 +1,144 @@
+/** Go debug adapter — dlv (Delve). */
+import { spawn as cpSpawn } from "node:child_process";
+import { getFreePort } from "../util/ports.js";
+export class GoAdapter {
+    name = "go";
+    async checkInstalled() {
+        try {
+            await execCheck("dlv", ["version"]);
+            return null;
+        }
+        catch {
+            return "Delve not found. Run: go install github.com/go-delve/delve/cmd/dlv@latest";
+        }
+    }
+    async spawn(opts) {
+        const port = await getFreePort();
+        const proc = cpSpawn("dlv", ["dap", "--listen", `127.0.0.1:${port}`], {
+            stdio: ["pipe", "pipe", "pipe"],
+            cwd: opts.cwd,
+        });
+        return { process: proc, port };
+    }
+    initializeArgs() {
+        return {
+            clientID: "agent-debugger",
+            clientName: "agent-debugger",
+            adapterID: "dlv",
+            pathFormat: "path",
+            linesStartAt1: true,
+            columnsStartAt1: true,
+            supportsVariableType: true,
+        };
+    }
+    launchArgs(opts) {
+        return {
+            type: "go",
+            request: "launch",
+            mode: "debug",
+            program: opts.program,
+            stopOnEntry: opts.stopOnEntry ?? false,
+            args: opts.args || [],
+            cwd: opts.cwd,
+        };
+    }
+    /**
+     * Delve DAP init flow (aligned with Python/debugpy pattern):
+     * 1. initialize
+     * 2. launch (async — response may be deferred)
+     * 3. wait for initialized event
+     * 4. setBreakpoints
+     * 5. setExceptionBreakpoints
+     * 6. configurationDone
+     * 7. wait for deferred launch response
+     * 8. wait for stopped event
+     */
+    async initFlow(client, opts) {
+        // 1. Initialize
+        const initResp = await client.request("initialize", this.initializeArgs());
+        if (!initResp.success) {
+            return { error: `Initialize failed: ${initResp.message || "unknown"}` };
+        }
+        // 2. Launch (async — Delve may defer response until configurationDone)
+        const launchSeq = client.requestAsync("launch", this.launchArgs(opts));
+        // 3. Wait for initialized event
+        const initialized = await client.waitForEvent("initialized", 10000);
+        if (!initialized) {
+            return { error: "Timeout waiting for initialized event" };
+        }
+        // 4. Set breakpoints
+        const bpResults = [];
+        if (opts.breakpoints?.length) {
+            for (const bp of opts.breakpoints) {
+                const bpArgs = {
+                    source: { path: bp.file },
+                    breakpoints: bp.lines.map((line, i) => {
+                        const entry = { line };
+                        if (bp.conditions?.[i])
+                            entry.condition = bp.conditions[i];
+                        return entry;
+                    }),
+                };
+                const resp = await client.request("setBreakpoints", bpArgs);
+                if (resp.success && resp.body) {
+                    const bps = resp.body.breakpoints;
+                    if (bps) {
+                        for (const b of bps) {
+                            bpResults.push({
+                                file: bp.file,
+                                line: b.line ?? 0,
+                                verified: b.verified ?? false,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        // 5. Exception breakpoints (empty = no exception breaking, required by spec)
+        await client.request("setExceptionBreakpoints", { filters: [] });
+        // 6. configurationDone
+        await client.request("configurationDone");
+        // 7. Wait for the deferred launch response
+        const launchResp = await client.waitForResponse(launchSeq, 15000);
+        if (!launchResp.success) {
+            return { error: `Launch failed: ${launchResp.message || "unknown"}` };
+        }
+        // 8. Wait for stopped event (breakpoint hit or entry)
+        const stopped = await client.waitForEvent("stopped", 15000);
+        if (stopped) {
+            const body = (stopped.body || {});
+            return {
+                status: "paused",
+                reason: body.reason || "unknown",
+                breakpoints: bpResults,
+            };
+        }
+        // Program may have finished without hitting breakpoint
+        const terminated = client.drainEvents("terminated");
+        if (terminated.length) {
+            return { status: "terminated", message: "Program finished without hitting breakpoint" };
+        }
+        return { status: "running", breakpoints: bpResults };
+    }
+    isInternalFrame(frame) {
+        const path = frame.source?.path || "";
+        const name = frame.name || "";
+        return path.includes("/runtime/") || name.startsWith("runtime.");
+    }
+    isInternalVariable(v) {
+        return false; // Go doesn't have dunder-style internals
+    }
+}
+function execCheck(cmd, args) {
+    return new Promise((resolve, reject) => {
+        const proc = cpSpawn(cmd, args, { stdio: "pipe" });
+        proc.on("close", (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`${cmd} exited with code ${code}`));
+        });
+        proc.on("error", reject);
+    });
+}
+//# sourceMappingURL=go.js.map

package/dist/src/adapters/go.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"go.js","sourceRoot":"","sources":["../../../src/adapters/go.ts"],"names":[],"mappings":"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"}

package/dist/src/adapters/node.d.ts

@@ -0,0 +1,27 @@
+/** Node.js debug adapter — @vscode/js-debug (dapDebugServer). */
+import type { DAPClient } from "../dap-client.js";
+import type { StackFrame, Variable } from "../dap-types.js";
+import type { CommandResult } from "../protocol.js";
+import type { AdapterConfig, SpawnResult, LaunchOpts, InitFlowOpts } from "./base.js";
+export declare class NodeAdapter implements AdapterConfig {
+    name: string;
+    checkInstalled(): Promise<string | null>;
+    spawn(opts: LaunchOpts): Promise<SpawnResult>;
+    initializeArgs(): Record<string, unknown>;
+    launchArgs(opts: LaunchOpts): Record<string, unknown>;
+    /**
+     * js-debug DAP init flow (aligned with Python/debugpy pattern):
+     * 1. initialize
+     * 2. launch (async — response may be deferred until configurationDone)
+     * 3. wait for initialized event
+     * 4. setBreakpoints
+     * 5. setExceptionBreakpoints
+     * 6. configurationDone
+     * 7. wait for deferred launch response
+     * 8. wait for stopped event
+     */
+    initFlow(client: DAPClient, opts: InitFlowOpts): Promise<CommandResult>;
+    isInternalFrame(frame: StackFrame): boolean;
+    isInternalVariable(v: Variable): boolean;
+}
+//# sourceMappingURL=node.d.ts.map

package/dist/src/adapters/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/adapters/node.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAMjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAiCtF,qBAAa,WAAY,YAAW,aAAa;IAC/C,IAAI,SAAU;IAER,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqBxC,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAiBnD,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAazC,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAiBrD;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA4E7E,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO;IAK3C,kBAAkB,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO;CAGzC"}

package/dist/src/adapters/node.js

@@ -0,0 +1,197 @@
+/** Node.js debug adapter — @vscode/js-debug (dapDebugServer). */
+import { spawn as cpSpawn } from "node:child_process";
+import { existsSync, readdirSync } from "node:fs";
+import { resolve as pathResolve } from "node:path";
+import { homedir } from "node:os";
+import { getFreePort } from "../util/ports.js";
+/** Locate dapDebugServer.js from js-debug. */
+function findJsDebugPath() {
+    // 1. Explicit env var
+    const envPath = process.env.JS_DEBUG_PATH;
+    if (envPath) {
+        const candidate = pathResolve(envPath, "src", "dapDebugServer.js");
+        if (existsSync(candidate))
+            return candidate;
+        // Maybe they pointed directly at dapDebugServer.js
+        if (existsSync(envPath) && envPath.endsWith("dapDebugServer.js"))
+            return envPath;
+    }
+    // 2. Auto-detect from VS Code extensions
+    const vscodeExtDir = pathResolve(homedir(), ".vscode", "extensions");
+    if (existsSync(vscodeExtDir)) {
+        try {
+            const entries = readdirSync(vscodeExtDir)
+                .filter((e) => e.startsWith("ms-vscode.js-debug-"))
+                .sort();
+            for (let i = entries.length - 1; i >= 0; i--) {
+                const candidate = pathResolve(vscodeExtDir, entries[i], "src", "dapDebugServer.js");
+                if (existsSync(candidate))
+                    return candidate;
+            }
+        }
+        catch {
+            // directory read failed
+        }
+    }
+    return null;
+}
+export class NodeAdapter {
+    name = "node";
+    async checkInstalled() {
+        // Check node is available
+        try {
+            await execCheck("node", ["--version"]);
+        }
+        catch {
+            return "Node.js not found in PATH";
+        }
+        // Check js-debug is available
+        const jsDebugPath = findJsDebugPath();
+        if (!jsDebugPath) {
+            return [
+                "@vscode/js-debug not found.",
+                "Install VS Code (which bundles js-debug), or set JS_DEBUG_PATH to the js-debug extension directory.",
+                "  e.g. JS_DEBUG_PATH=~/.vscode/extensions/ms-vscode.js-debug-1.x.x",
+            ].join("\n");
+        }
+        return null;
+    }
+    async spawn(opts) {
+        const jsDebugPath = findJsDebugPath();
+        if (!jsDebugPath)
+            throw new Error("js-debug not found (run checkInstalled first)");
+        const port = await getFreePort();
+        // dapDebugServer.js <port> starts a DAP server on the given TCP port
+        const proc = cpSpawn("node", [jsDebugPath, String(port)], {
+            stdio: ["pipe", "pipe", "pipe"],
+            cwd: opts.cwd,
+        });
+        return { process: proc, port };
+    }
+    initializeArgs() {
+        return {
+            clientID: "agent-debugger",
+            clientName: "agent-debugger",
+            adapterID: "js-debug",
+            pathFormat: "path",
+            linesStartAt1: true,
+            columnsStartAt1: true,
+            supportsVariableType: true,
+            supportsRunInTerminalRequest: false,
+        };
+    }
+    launchArgs(opts) {
+        const args = {
+            type: "pwa-node",
+            request: "launch",
+            program: opts.program,
+            console: "internalConsole",
+            stopOnEntry: opts.stopOnEntry ?? false,
+        };
+        if (opts.args?.length) {
+            args.args = opts.args;
+        }
+        if (opts.cwd) {
+            args.cwd = opts.cwd;
+        }
+        return args;
+    }
+    /**
+     * js-debug DAP init flow (aligned with Python/debugpy pattern):
+     * 1. initialize
+     * 2. launch (async — response may be deferred until configurationDone)
+     * 3. wait for initialized event
+     * 4. setBreakpoints
+     * 5. setExceptionBreakpoints
+     * 6. configurationDone
+     * 7. wait for deferred launch response
+     * 8. wait for stopped event
+     */
+    async initFlow(client, opts) {
+        // 1. Initialize
+        const initResp = await client.request("initialize", this.initializeArgs());
+        if (!initResp.success) {
+            return { error: `Initialize failed: ${initResp.message || "unknown"}` };
+        }
+        // 2. Launch (async — response may be deferred until configurationDone)
+        const launchSeq = client.requestAsync("launch", this.launchArgs(opts));
+        // 3. Wait for initialized event
+        const initialized = await client.waitForEvent("initialized", 10000);
+        if (!initialized) {
+            return { error: "Timeout waiting for initialized event" };
+        }
+        // 4. Set breakpoints
+        const bpResults = [];
+        if (opts.breakpoints?.length) {
+            for (const bp of opts.breakpoints) {
+                const bpArgs = {
+                    source: { path: bp.file },
+                    breakpoints: bp.lines.map((line, i) => {
+                        const entry = { line };
+                        if (bp.conditions?.[i])
+                            entry.condition = bp.conditions[i];
+                        return entry;
+                    }),
+                };
+                const resp = await client.request("setBreakpoints", bpArgs);
+                if (resp.success && resp.body) {
+                    const bps = resp.body.breakpoints;
+                    if (bps) {
+                        for (const b of bps) {
+                            bpResults.push({
+                                file: bp.file,
+                                line: b.line ?? 0,
+                                verified: b.verified ?? false,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        // 5. Exception breakpoints (empty = no exception breaking)
+        await client.request("setExceptionBreakpoints", { filters: [] });
+        // 6. configurationDone
+        await client.request("configurationDone");
+        // 7. Wait for the deferred launch response
+        const launchResp = await client.waitForResponse(launchSeq, 15000);
+        if (!launchResp.success) {
+            return { error: `Launch failed: ${launchResp.message || "unknown"}` };
+        }
+        // 8. Wait for stopped event (breakpoint hit or entry)
+        const stopped = await client.waitForEvent("stopped", 15000);
+        if (stopped) {
+            const body = (stopped.body || {});
+            return {
+                status: "paused",
+                reason: body.reason || "unknown",
+                breakpoints: bpResults,
+            };
+        }
+        // Program may have finished without hitting breakpoint
+        const terminated = client.drainEvents("terminated");
+        if (terminated.length) {
+            return { status: "terminated", message: "Program finished without hitting breakpoint" };
+        }
+        return { status: "running", breakpoints: bpResults };
+    }
+    isInternalFrame(frame) {
+        const path = frame.source?.path || "";
+        return path.includes("node:internal") || path.includes("node_modules");
+    }
+    isInternalVariable(v) {
+        return v.name === "this" || v.name === "__proto__";
+    }
+}
+function execCheck(cmd, args) {
+    return new Promise((resolve, reject) => {
+        const proc = cpSpawn(cmd, args, { stdio: "pipe" });
+        proc.on("close", (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`${cmd} exited with code ${code}`));
+        });
+        proc.on("error", reject);
+    });
+}
+//# sourceMappingURL=node.js.map

package/dist/src/adapters/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../src/adapters/node.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAEjE,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAKlC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,8CAA8C;AAC9C,SAAS,eAAe;IACtB,sBAAsB;IACtB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC1C,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,mBAAmB,CAAC,CAAC;QACnE,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5C,mDAAmD;QACnD,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAAE,OAAO,OAAO,CAAC;IACnF,CAAC;IAED,yCAAyC;IACzC,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IACrE,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,WAAW,CAAC,YAAY,CAAC;iBACtC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;iBAClD,IAAI,EAAE,CAAC;YACV,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC7C,MAAM,SAAS,GAAG,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAE,EAAE,KAAK,EAAE,mBAAmB,CAAC,CAAC;gBACrF,IAAI,UAAU,CAAC,SAAS,CAAC;oBAAE,OAAO,SAAS,CAAC;YAC9C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,OAAO,WAAW;IACtB,IAAI,GAAG,MAAM,CAAC;IAEd,KAAK,CAAC,cAAc;QAClB,0BAA0B;QAC1B,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,2BAA2B,CAAC;QACrC,CAAC;QAED,8BAA8B;QAC9B,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;QACtC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;gBACL,6BAA6B;gBAC7B,qGAAqG;gBACrG,oEAAoE;aACrE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAgB;QAC1B,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;QACtC,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAEnF,MAAM,IAAI,GAAG,MAAM,WAAW,EAAE,CAAC;QACjC,qEAAqE;QACrE,MAAM,IAAI,GAAG,OAAO,CAClB,MAAM,EACN,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAC3B;YACE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CACF,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACjC,CAAC;IAED,cAAc;QACZ,OAAO;YACL,QAAQ,EAAE,gBAAgB;YAC1B,UAAU,EAAE,gBAAgB;YAC5B,SAAS,EAAE,UAAU;YACrB,UAAU,EAAE,MAAM;YAClB,aAAa,EAAE,IAAI;YACnB,eAAe,EAAE,IAAI;YACrB,oBAAoB,EAAE,IAAI;YAC1B,4BAA4B,EAAE,KAAK;SACpC,CAAC;IACJ,CAAC;IAED,UAAU,CAAC,IAAgB;QACzB,MAAM,IAAI,GAA4B;YACpC,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,iBAAiB;YAC1B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,KAAK;SACvC,CAAC;QACF,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACxB,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACtB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAiB,EAAE,IAAkB;QAClD,gBAAgB;QAChB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,OAAO,EAAE,KAAK,EAAE,sBAAsB,QAAQ,CAAC,OAAO,IAAI,SAAS,EAAE,EAAE,CAAC;QAC1E,CAAC;QAED,uEAAuE;QACvE,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QAEvE,gCAAgC;QAChC,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QACpE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;QAC5D,CAAC;QAED,qBAAqB;QACrB,MAAM,SAAS,GAA6D,EAAE,CAAC;QAC/E,IAAI,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;YAC7B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBAClC,MAAM,MAAM,GAA4B;oBACtC,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE;oBACzB,WAAW,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;wBACpC,MAAM,KAAK,GAA4B,EAAE,IAAI,EAAE,CAAC;wBAChD,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;4BAAE,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;wBAC3D,OAAO,KAAK,CAAC;oBACf,CAAC,CAAC;iBACH,CAAC;gBACF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;gBAC5D,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC9B,MAAM,GAAG,GAAI,IAAI,CAAC,IAAuE,CAAC,WAAW,CAAC;oBACtG,IAAI,GAAG,EAAE,CAAC;wBACR,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;4BACpB,SAAS,CAAC,IAAI,CAAC;gCACb,IAAI,EAAE,EAAE,CAAC,IAAI;gCACb,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;gCACjB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,KAAK;6BAC9B,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,2DAA2D;QAC3D,MAAM,MAAM,CAAC,OAAO,CAAC,yBAAyB,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAEjE,uBAAuB;QACvB,MAAM,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAE1C,2CAA2C;QAC3C,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAClE,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO,EAAE,KAAK,EAAE,kBAAkB,UAAU,CAAC,OAAO,IAAI,SAAS,EAAE,EAAE,CAAC;QACxE,CAAC;QAED,sDAAsD;QACtD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC5D,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAA2C,CAAC;YAC5E,OAAO;gBACL,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;gBAChC,WAAW,EAAE,SAAS;aACvB,CAAC;QACJ,CAAC;QAED,uDAAuD;QACvD,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QACpD,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;QAC1F,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;IACvD,CAAC;IAED,eAAe,CAAC,KAAiB;QAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACzE,CAAC;IAED,kBAAkB,CAAC,CAAW;QAC5B,OAAO,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;IACrD,CAAC;CACF;AAED,SAAS,SAAS,CAAC,GAAW,EAAE,IAAc;IAC5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;;gBACrB,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,qBAAqB,IAAI,EAAE,CAAC,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/adapters/python.d.ts

@@ -0,0 +1,27 @@
+/** Python debug adapter — debugpy. */
+import type { DAPClient } from "../dap-client.js";
+import type { StackFrame, Variable } from "../dap-types.js";
+import type { CommandResult } from "../protocol.js";
+import type { AdapterConfig, SpawnResult, LaunchOpts, InitFlowOpts } from "./base.js";
+export declare class PythonAdapter implements AdapterConfig {
+    name: string;
+    checkInstalled(runtimePath?: string): Promise<string | null>;
+    spawn(opts: LaunchOpts): Promise<SpawnResult>;
+    initializeArgs(): Record<string, unknown>;
+    launchArgs(opts: LaunchOpts): Record<string, unknown>;
+    /**
+     * debugpy-specific init flow:
+     * 1. initialize
+     * 2. launch (async — response deferred until configurationDone)
+     * 3. wait for initialized event
+     * 4. setBreakpoints
+     * 5. setExceptionBreakpoints
+     * 6. configurationDone
+     * 7. wait for deferred launch response
+     * 8. wait for stopped event
+     */
+    initFlow(client: DAPClient, opts: InitFlowOpts): Promise<CommandResult>;
+    isInternalFrame(frame: StackFrame): boolean;
+    isInternalVariable(v: Variable): boolean;
+}
+//# sourceMappingURL=python.d.ts.map

package/dist/src/adapters/python.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../../src/adapters/python.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAGtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGtF,qBAAa,aAAc,YAAW,aAAa;IACjD,IAAI,SAAY;IAEV,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAU5D,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAWnD,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAazC,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAqBrD;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA4E7E,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO;IAK3C,kBAAkB,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO;CAGzC"}