openidea/src/features/debugger/missingAdapter.ts

/**
 * A debug adapter that is not installed: name it and offer the one-click install
 * (ide-tools) followed by the same launch again, instead of a bare error.
 */
import { IpcError } from "@/platform/ipc";

/** Adapters the tools installer can provide (adapter id → tool name). */
const INSTALLABLE: Record<string, { tool: string; title: string }> = {
  "kotlin-debug-adapter": { tool: "kotlin-debug-adapter", title: "The Kotlin debugger is not installed" },
  netcoredbg: { tool: "netcoredbg", title: "netcoredbg is not installed" },
  debugpy: { tool: "debugpy", title: "debugpy is not installed" },
  "js-debug": { tool: "js-debug", title: "The JavaScript debugger (vscode-js-debug) is not installed" },
  delve: { tool: "delve", title: "Delve is not installed" },
  codelldb: { tool: "codelldb", title: "CodeLLDB is not installed" },
  "php-debug": { tool: "php-debug", title: "PHP Debug (Xdebug) is not installed" },
};

export interface MissingAdapter {
  tool: string;
  title: string;
  body: string;
}

/** The install offer for a failed start, or null when the failure is something else. */
export function missingAdapter(adapter: string, e: unknown): MissingAdapter | null {
  const entry = INSTALLABLE[adapter];
  if (!entry || !(e instanceof IpcError) || e.kind !== "unavailable") return null;
  if (adapter === "debugpy" && e.message.startsWith("debugpy is not installed")) {
    return {
      tool: entry.tool,
      title: entry.title,
      body: `${e.message}. OpenIDEA can install a private copy that every Python interpreter uses for debugging.`,
    };
  }
  if (!e.message.startsWith(`debug adapter \`${adapter}\` not found`)) return null;
  return {
    tool: entry.tool,
    title: entry.title,
    body: e.message,
  };
}