dap-mcp-server 0.1.12 → 0.1.16

package/src/adapters/builtin.ts

@@ -1,75 +0,0 @@
-/**
- * Copyright (c) 2026 Ivan Iraci <ivan.iraci@professioneit.com>
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-import { AdapterConfig } from "../dap/types.js";
-
-export const BUILTIN_ADAPTERS: AdapterConfig[] = [
-  {
-    type: "python",
-    runtime: "python3",
-    program: "-m",
-    args: ["debugpy.adapter"],
-    launchDefaults: {
-      console: "internalConsole",
-    },
-    installHint: "pip install debugpy",
-  },
-  {
-    type: "go",
-    program: "dlv",
-    args: ["dap", "--listen=127.0.0.1:0"],
-    transport: "tcp",
-    // Matches: "DAP server listening at: 127.0.0.1:38251"
-    portMatcher: "DAP server listening at:\\s*\\S+:(\\d+)",
-    installHint: "go install github.com/go-delve/delve/cmd/dlv@latest",
-  },
-  // node adapter: vscode-js-debug's dapDebugServer.js. The user must install
-  // it (no universal path); the registry's availability check will mark this
-  // unavailable when the program is missing.
-  {
-    type: "node",
-    runtime: "node",
-    program: "dapDebugServer.js",
-    // Bind to IPv4 explicitly; the default is IPv6 ('::1') which our client
-    // (which connects to 127.0.0.1) can't reach on systems without v4↔v6
-    // bridging.
-    args: ["0", "127.0.0.1"],
-    transport: "tcp",
-    // Matches: "Debug server listening at 127.0.0.1:38251" (vscode-js-debug)
-    portMatcher: "[Ll]istening at\\s*\\S*?:(\\d+)",
-    // vscode-js-debug requires these in the launch request; pwa-node is the
-    // "production worker agent" Node launcher.
-    launchDefaults: {
-      type: "pwa-node",
-      request: "launch",
-    },
-    installHint:
-      "Install vscode-js-debug DAP server and set the adapter's `program` to its dapDebugServer.js path " +
-      "(e.g. via `configure_adapter`). See https://github.com/microsoft/vscode-js-debug.",
-  },
-  {
-    type: "cppdbg",
-    program: "lldb-dap",
-    args: [],
-    installHint: "apt install lldb (Debian/Ubuntu) or brew install llvm (macOS)",
-  },
-];

package/src/adapters/detect.test.ts

@@ -1,36 +0,0 @@
-/**
- * Copyright (c) 2026 Ivan Iraci <ivan.iraci@professioneit.com>
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-import { describe, it, expect } from "vitest";
-import { checkAdapterAvailable } from "./detect.js";
-
-describe("checkAdapterAvailable", () => {
-  it("detects 'node' as available", async () => {
-    const result = await checkAdapterAvailable("node");
-    expect(result).toBe(true);
-  });
-
-  it("detects non-existent binary as unavailable", async () => {
-    const result = await checkAdapterAvailable("definitely-not-a-real-binary-xyz");
-    expect(result).toBe(false);
-  });
-});

package/src/adapters/detect.ts

@@ -1,36 +0,0 @@
-/**
- * Copyright (c) 2026 Ivan Iraci <ivan.iraci@professioneit.com>
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
-
-const execFileAsync = promisify(execFile);
-
-export async function checkAdapterAvailable(command: string): Promise<boolean> {
-  try {
-    const whichCmd = process.platform === "win32" ? "where" : "which";
-    await execFileAsync(whichCmd, [command]);
-    return true;
-  } catch {
-    return false;
-  }
-}

package/src/adapters/registry.test.ts

@@ -1,74 +0,0 @@
-/**
- * Copyright (c) 2026 Ivan Iraci <ivan.iraci@professioneit.com>
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import { AdapterRegistry } from "./registry.js";
-import fs from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-
-describe("AdapterRegistry", () => {
-  let tmpDir: string;
-  let registry: AdapterRegistry;
-
-  beforeEach(async () => {
-    tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "dap-mcp-test-"));
-    registry = new AdapterRegistry(tmpDir, tmpDir);
-  });
-
-  afterEach(async () => {
-    await fs.rm(tmpDir, { recursive: true, force: true });
-  });
-
-  it("returns built-in adapters", () => {
-    const adapters = registry.listAll();
-    expect(adapters.some((a) => a.type === "python")).toBe(true);
-    expect(adapters.some((a) => a.type === "go")).toBe(true);
-    // node adapter now points at vscode-js-debug's dapDebugServer.js via TCP.
-    // The user must install/configure it; the registry just publishes the entry.
-    expect(adapters.some((a) => a.type === "node")).toBe(true);
-  });
-
-  it("registers a custom adapter", () => {
-    registry.register({ type: "ruby", program: "/usr/bin/rdbg", args: ["--open", "--dap"] });
-    const ruby = registry.get("ruby");
-    expect(ruby).toBeDefined();
-    expect(ruby!.program).toBe("/usr/bin/rdbg");
-  });
-
-  it("project-local overrides built-in", () => {
-    registry.register({ type: "python", program: "/custom/debugpy" });
-    const python = registry.get("python");
-    expect(python!.program).toBe("/custom/debugpy");
-  });
-
-  it("saves and loads config from disk", async () => {
-    registry.register({ type: "ruby", program: "/usr/bin/rdbg" });
-    await registry.save("project");
-
-    const registry2 = new AdapterRegistry(tmpDir, tmpDir);
-    await registry2.load();
-    const ruby = registry2.get("ruby");
-    expect(ruby).toBeDefined();
-    expect(ruby!.program).toBe("/usr/bin/rdbg");
-  });
-});

package/src/adapters/registry.ts

@@ -1,86 +0,0 @@
-/**
- * Copyright (c) 2026 Ivan Iraci <ivan.iraci@professioneit.com>
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-import { AdapterConfig } from "../dap/types.js";
-import { BUILTIN_ADAPTERS } from "./builtin.js";
-import fs from "node:fs/promises";
-import path from "node:path";
-
-export class AdapterRegistry {
-  private builtins: Map<string, AdapterConfig>;
-  private global: Map<string, AdapterConfig> = new Map();
-  private project: Map<string, AdapterConfig> = new Map();
-  private globalDir: string;
-  private projectDir: string;
-
-  constructor(globalDir: string, projectDir: string) {
-    this.globalDir = globalDir;
-    this.projectDir = projectDir;
-    this.builtins = new Map(BUILTIN_ADAPTERS.map((a) => [a.type, a]));
-  }
-
-  get(type: string): AdapterConfig | undefined {
-    return this.project.get(type) ?? this.global.get(type) ?? this.builtins.get(type);
-  }
-
-  register(config: AdapterConfig, scope: "global" | "project" = "project"): void {
-    const map = scope === "global" ? this.global : this.project;
-    map.set(config.type, config);
-  }
-
-  listAll(): Array<AdapterConfig & { source: "builtin" | "global" | "project" }> {
-    const result = new Map<string, AdapterConfig & { source: "builtin" | "global" | "project" }>();
-    for (const [type, config] of this.builtins) {
-      result.set(type, { ...config, source: "builtin" });
-    }
-    for (const [type, config] of this.global) {
-      result.set(type, { ...config, source: "global" });
-    }
-    for (const [type, config] of this.project) {
-      result.set(type, { ...config, source: "project" });
-    }
-    return Array.from(result.values());
-  }
-
-  async load(): Promise<void> {
-    this.global = await this.loadFile(path.join(this.globalDir, "adapters.json"));
-    this.project = await this.loadFile(path.join(this.projectDir, "adapters.json"));
-  }
-
-  async save(scope: "global" | "project"): Promise<void> {
-    const dir = scope === "global" ? this.globalDir : this.projectDir;
-    const map = scope === "global" ? this.global : this.project;
-    await fs.mkdir(dir, { recursive: true });
-    const data = Object.fromEntries(map);
-    await fs.writeFile(path.join(dir, "adapters.json"), JSON.stringify(data, null, 2));
-  }
-
-  private async loadFile(filePath: string): Promise<Map<string, AdapterConfig>> {
-    try {
-      const data = await fs.readFile(filePath, "utf-8");
-      const parsed = JSON.parse(data) as Record<string, AdapterConfig>;
-      return new Map(Object.entries(parsed));
-    } catch {
-      return new Map();
-    }
-  }
-}

package/src/dap/dap-client.test.ts

@@ -1,118 +0,0 @@
-/**
- * Copyright (c) 2026 Ivan Iraci <ivan.iraci@professioneit.com>
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-import { describe, it, expect, afterEach } from "vitest";
-import { DAPClient, DAPClientError } from "./dap-client.js";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-describe("DAPClient", () => {
-  let client: DAPClient | undefined;
-
-  afterEach(async () => {
-    if (client) {
-      try { await client.dispose(); } catch { /* ignore */ }
-      client = undefined;
-    }
-  });
-
-  it("spawns adapter and sends initialize request", async () => {
-    client = new DAPClient("node", path.join(__dirname, "../test-fixtures/mock-adapter.js"));
-    await client.spawn();
-    const response = await client.sendRequest("initialize", {
-      adapterID: "test",
-      linesStartAt1: true,
-      columnsStartAt1: true,
-      pathFormat: "path",
-    });
-    expect(response.success).toBe(true);
-    expect(response.command).toBe("initialize");
-  });
-
-  it("receives events from adapter", async () => {
-    client = new DAPClient("node", path.join(__dirname, "../test-fixtures/mock-adapter.js"));
-    await client.spawn();
-
-    const eventPromise = new Promise<any>((resolve) => {
-      client!.on("initialized", resolve);
-    });
-
-    await client.sendRequest("initialize", {
-      adapterID: "test",
-      linesStartAt1: true,
-      columnsStartAt1: true,
-      pathFormat: "path",
-    });
-
-    const event = await eventPromise;
-    expect(event.event).toBe("initialized");
-  });
-
-  it("rejects on adapter exit during request", async () => {
-    client = new DAPClient("node", path.join(__dirname, "../test-fixtures/crash-adapter.js"));
-    await client.spawn();
-    await expect(
-      client.sendRequest("initialize", { adapterID: "test" })
-    ).rejects.toThrow();
-  });
-
-  it("times out if adapter does not respond", async () => {
-    client = new DAPClient("node", path.join(__dirname, "../test-fixtures/silent-adapter.js"));
-    await client.spawn();
-    await expect(
-      client.sendRequest("initialize", { adapterID: "test" }, 500)
-    ).rejects.toThrow(/timeout/i);
-  });
-
-  it("speaks DAP over TCP when configured", async () => {
-    client = new DAPClient(
-      "node",
-      path.join(__dirname, "../test-fixtures/tcp-mock-adapter.js"),
-      [],
-      {
-        transport: "tcp",
-        portMatcher: "DAP server listening at:\\s*\\S+:(\\d+)",
-        tcpConnectTimeout: 3000,
-      }
-    );
-    await client.spawn();
-    const response = await client.sendRequest("initialize", {
-      adapterID: "test",
-      linesStartAt1: true,
-      columnsStartAt1: true,
-      pathFormat: "path",
-    });
-    expect(response.success).toBe(true);
-    expect(response.command).toBe("initialize");
-  });
-
-  it("rejects TCP transport without a portMatcher", () => {
-    expect(
-      () =>
-        new DAPClient("node", "irrelevant.js", [], {
-          transport: "tcp",
-        })
-    ).toThrow(DAPClientError);
-  });
-});