debug-that 0.2.0 → 0.2.1

package/dist/main.js

@@ -299,12 +299,29 @@ class DapClient {
 var init_client = () => {};
 
 // src/dap/session.ts
+import { existsSync } from "fs";
+import { join } from "path";
+function getManagedAdaptersDir() {
+  const home = process.env.HOME ?? process.env.USERPROFILE ?? "/tmp";
+  return join(home, ".debug-that", "adapters");
+}
 function resolveAdapterCommand(runtime) {
   switch (runtime) {
     case "lldb":
     case "lldb-dap": {
+      const managedPath = join(getManagedAdaptersDir(), "lldb-dap");
+      if (existsSync(managedPath)) {
+        return [managedPath];
+      }
+      const whichResult = Bun.spawnSync(["which", "lldb-dap"]);
+      if (whichResult.exitCode === 0) {
+        return ["lldb-dap"];
+      }
       const brewPath = "/opt/homebrew/opt/llvm/bin/lldb-dap";
-      return [brewPath];
+      if (existsSync(brewPath)) {
+        return [brewPath];
+      }
+      return ["lldb-dap"];
     }
     case "codelldb":
       return ["codelldb", "--port", "0"];
@@ -653,8 +670,8 @@ class DapSession {
       };
     });
   }
-  getStack(_options = {}) {
-    return this._stackFrames.map((frame) => {
+  getStack(options = {}) {
+    const frames = this._stackFrames.map((frame) => {
       const ref = this.refs.addFrame(String(frame.id), frame.name);
       return {
         ref,
@@ -664,6 +681,11 @@ class DapSession {
         column: frame.column > 0 ? frame.column : undefined
       };
     });
+    if (options.filter) {
+      const filterLower = options.filter.toLowerCase();
+      return frames.filter((f) => f.functionName.toLowerCase().includes(filterLower) || f.file.toLowerCase().includes(filterLower));
+    }
+    return frames;
   }
   async getSource(options = {}) {
     const file = options.file ?? this._pauseInfo?.url;
@@ -827,12 +849,41 @@ class DapSession {
   async restartFrame(_frameRef) {
     throw new Error("Frame restart is not supported in DAP mode.");
   }
-  async runTo(_file, _line) {
-    throw new Error("Run-to-location is not yet supported in DAP mode. Set a breakpoint and continue.");
+  async runTo(file, line) {
+    this.requireConnected();
+    this.requirePaused();
+    const tempBp = await this.setBreakpoint(file, line);
+    try {
+      await this.continue();
+    } finally {
+      try {
+        await this.removeBreakpoint(tempBp.ref);
+      } catch {}
+    }
   }
   getScripts(_filter) {
     return [];
   }
+  async getModules(filter) {
+    this.requireConnected();
+    if (!this.capabilities.supportsModulesRequest) {
+      throw new Error(`This debug adapter does not support the modules request.
+  -> The adapter may not report module/symbol information.`);
+    }
+    const response = await this.getDap().send("modules", { startModule: 0, moduleCount: 0 });
+    const body = response.body;
+    let modules = body.modules ?? [];
+    if (filter) {
+      const filterLower = filter.toLowerCase();
+      modules = modules.filter((m) => m.name.toLowerCase().includes(filterLower) || (m.path?.toLowerCase().includes(filterLower) ?? false));
+    }
+    return modules.map((m) => ({
+      id: String(m.id),
+      name: m.name,
+      path: m.path,
+      symbolStatus: m.symbolStatus
+    }));
+  }
   async addBlackbox(_patterns) {
     throw new Error("Blackboxing is not supported in DAP mode.");
   }
@@ -878,8 +929,8 @@ class DapSession {
   async initializeAdapter() {
     const response = await this.getDap().send("initialize", {
       adapterID: this._runtime,
-      clientID: "agent-dbg",
-      clientName: "agent-dbg",
+      clientID: "debug-that",
+      clientName: "debug-that",
       linesStartAt1: true,
       columnsStartAt1: true,
       pathFormat: "path",
@@ -1060,6 +1111,38 @@ var init_session = __esm(() => {
   init_client();
 });
 
+// src/daemon/eval-suggestions.ts
+function suggestEvalFix(errorMsg) {
+  const lower = errorMsg.toLowerCase();
+  if (lower.includes("invalid use of 'this'") || lower.includes("invalid use of this")) {
+    return `This frame may lack debug symbols. Try: debug-that modules
+  Or try a different frame: debug-that eval <expr> --frame @f1`;
+  }
+  if (lower.includes("no member named") || lower.includes("has no member")) {
+    return "Try: debug-that props <@ref> to list available members";
+  }
+  if (lower.includes("undeclared identifier") || lower.includes("use of undeclared") || lower.includes("is not defined")) {
+    return "Try: debug-that vars to see variables in scope";
+  }
+  if (lower.includes("not paused")) {
+    return "Try: debug-that pause";
+  }
+  if (lower.includes("timed out")) {
+    return `The expression may be blocking. Try: debug-that eval <expr> --timeout 30000
+  Or use --side-effect-free to safely inspect without side effects`;
+  }
+  if (lower.includes("side effect")) {
+    return "Expression has side effects. Remove --side-effect-free flag to allow mutation";
+  }
+  if (lower.includes("syntaxerror") || lower.includes("unexpected token")) {
+    return "Check expression syntax. Wrap multi-line expressions in parentheses";
+  }
+  if (lower.includes("cannot read propert") || lower.includes("undefined is not")) {
+    return "The value may be null/undefined. Try: debug-that vars to inspect available values";
+  }
+  return;
+}
+
 // src/daemon/logger.ts
 import { appendFileSync, writeFileSync } from "fs";
 
@@ -1096,31 +1179,31 @@ class DaemonLogger {
 var init_logger = () => {};
 
 // src/daemon/paths.ts
-import { existsSync, mkdirSync } from "fs";
-import { join } from "path";
+import { existsSync as existsSync2, mkdirSync } from "fs";
+import { join as join2 } from "path";
 function getSocketDir() {
   const xdgRuntime = process.env.XDG_RUNTIME_DIR;
   if (xdgRuntime) {
-    return join(xdgRuntime, "agent-dbg");
+    return join2(xdgRuntime, "debug-that");
   }
   const tmpdir = process.env.TMPDIR || "/tmp";
-  return join(tmpdir, `agent-dbg-${process.getuid?.() ?? 0}`);
+  return join2(tmpdir, `debug-that-${process.getuid?.() ?? 0}`);
 }
 function getSocketPath(session) {
-  return join(getSocketDir(), `${session}.sock`);
+  return join2(getSocketDir(), `${session}.sock`);
 }
 function getLockPath(session) {
-  return join(getSocketDir(), `${session}.lock`);
+  return join2(getSocketDir(), `${session}.lock`);
 }
 function getLogPath(session) {
-  return join(getSocketDir(), `${session}.cdp.log`);
+  return join2(getSocketDir(), `${session}.cdp.log`);
 }
 function getDaemonLogPath(session) {
-  return join(getSocketDir(), `${session}.daemon.log`);
+  return join2(getSocketDir(), `${session}.daemon.log`);
 }
 function ensureSocketDir() {
   const dir = getSocketDir();
-  if (!existsSync(dir)) {
+  if (!existsSync2(dir)) {
     mkdirSync(dir, { recursive: true });
   }
 }
@@ -7149,7 +7232,7 @@ var init_esm2 = __esm(() => {
 });
 
 // src/protocol/messages.ts
-var PingRequest, LaunchRequest, AttachRequest, StatusRequest, StateRequest, ContinueRequest, StepRequest, PauseRequest, RunToRequest, BreakRequest, BreakFnRequest, BreakRmRequest, BreakLsRequest, LogpointRequest, CatchRequest, SourceRequest, ScriptsRequest, StackRequest, SearchRequest, ConsoleRequest, ExceptionsRequest, EvalRequest, VarsRequest, PropsRequest, BlackboxRequest, BlackboxLsRequest, BlackboxRmRequest, SetRequest, SetReturnRequest, HotpatchRequest, BreakToggleRequest, BreakableRequest, RestartFrameRequest, SourcemapRequest, SourcemapDisableRequest, RestartRequest, StopRequest, DaemonRequestSchema, SuccessResponse, ErrorResponse, DaemonResponseSchema;
+var PingRequest, LaunchRequest, AttachRequest, StatusRequest, StateRequest, ContinueRequest, StepRequest, PauseRequest, RunToRequest, BreakRequest, BreakFnRequest, BreakRmRequest, BreakLsRequest, LogpointRequest, CatchRequest, SourceRequest, ScriptsRequest, StackRequest, SearchRequest, ConsoleRequest, ExceptionsRequest, EvalRequest, VarsRequest, PropsRequest, BlackboxRequest, BlackboxLsRequest, BlackboxRmRequest, SetRequest, SetReturnRequest, HotpatchRequest, BreakToggleRequest, BreakableRequest, RestartFrameRequest, SourcemapRequest, SourcemapDisableRequest, RestartRequest, StopRequest, ModulesRequest, DaemonRequestSchema, SuccessResponse, ErrorResponse, DaemonResponseSchema;
 var init_messages = __esm(() => {
   init_esm2();
   PingRequest = exports_external.object({ cmd: exports_external.literal("ping") });
@@ -7265,7 +7348,8 @@ var init_messages = __esm(() => {
     cmd: exports_external.literal("stack"),
     args: exports_external.object({
       asyncDepth: exports_external.optional(exports_external.number()),
-      generated: exports_external.optional(exports_external.boolean())
+      generated: exports_external.optional(exports_external.boolean()),
+      filter: exports_external.optional(exports_external.string())
     })
   });
   SearchRequest = exports_external.object({
@@ -7382,6 +7466,12 @@ var init_messages = __esm(() => {
   SourcemapDisableRequest = exports_external.object({ cmd: exports_external.literal("sourcemap-disable") });
   RestartRequest = exports_external.object({ cmd: exports_external.literal("restart") });
   StopRequest = exports_external.object({ cmd: exports_external.literal("stop") });
+  ModulesRequest = exports_external.object({
+    cmd: exports_external.literal("modules"),
+    args: exports_external.object({
+      filter: exports_external.optional(exports_external.string())
+    })
+  });
   DaemonRequestSchema = exports_external.union([
     PingRequest,
     LaunchRequest,
@@ -7419,7 +7509,8 @@ var init_messages = __esm(() => {
     RestartRequest,
     SourcemapRequest,
     SourcemapDisableRequest,
-    StopRequest
+    StopRequest,
+    ModulesRequest
   ]);
   SuccessResponse = exports_external.object({
     ok: exports_external.literal(true),
@@ -7434,7 +7525,7 @@ var init_messages = __esm(() => {
 });
 
 // src/daemon/server.ts
-import { existsSync as existsSync2, unlinkSync, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync as existsSync3, unlinkSync, writeFileSync as writeFileSync2 } from "fs";
 
 class DaemonServer {
   session;
@@ -7457,14 +7548,14 @@ class DaemonServer {
   }
   async start() {
     ensureSocketDir();
-    if (existsSync2(this.lockPath)) {
+    if (existsSync3(this.lockPath)) {
       const existingPid = parseInt(await Bun.file(this.lockPath).text(), 10);
       if (!Number.isNaN(existingPid) && isProcessRunning(existingPid)) {
         throw new Error(`Daemon already running for session "${this.session}" (pid ${existingPid})`);
       }
       unlinkSync(this.lockPath);
     }
-    if (existsSync2(this.socketPath)) {
+    if (existsSync3(this.socketPath)) {
       unlinkSync(this.socketPath);
     }
     writeFileSync2(this.lockPath, String(process.pid));
@@ -7547,7 +7638,7 @@ class DaemonServer {
       this.sendResponse(socket, cmd ? {
         ok: false,
         error: `Unknown command: ${cmd}`,
-        suggestion: "-> Try: agent-dbg --help"
+        suggestion: "-> Try: debug-that --help"
       } : {
         ok: false,
         error: "Invalid request: must have { cmd: string, args: object }"
@@ -7591,10 +7682,10 @@ class DaemonServer {
       this.listener.stop(true);
       this.listener = null;
     }
-    if (existsSync2(this.socketPath)) {
+    if (existsSync3(this.socketPath)) {
       unlinkSync(this.socketPath);
     }
-    if (existsSync2(this.lockPath)) {
+    if (existsSync3(this.lockPath)) {
       unlinkSync(this.lockPath);
     }
   }
@@ -9458,7 +9549,7 @@ async function continueExecution(session) {
   if (!session.cdp) {
     throw new Error("Cannot continue: no CDP connection");
   }
-  const waiter = session.createPauseWaiter();
+  const waiter = session.createPauseWaiter(CONTINUE_GRACE_MS);
   await session.cdp.send("Debugger.resume");
   await waiter;
 }
@@ -9479,8 +9570,8 @@ async function stepExecution(session, mode) {
   await waiter;
 }
 async function pauseExecution(session) {
-  if (session.sessionState !== "running") {
-    throw new Error("Cannot pause: process is not running");
+  if (session.isPaused()) {
+    throw new Error("Cannot pause: process is already paused");
   }
   if (!session.cdp) {
     throw new Error("Cannot pause: no CDP connection");
@@ -9540,6 +9631,7 @@ async function restartFrameExecution(session, frameRef) {
   await waiter;
   return { status: "restarted" };
 }
+var CONTINUE_GRACE_MS = 500;
 var init_session_execution = () => {};
 
 // src/daemon/session-inspection.ts
@@ -9715,6 +9807,10 @@ async function getProps(session, ref, options = {}) {
   if (objectId.startsWith("primitive:") || objectId.startsWith("eval:")) {
     throw new Error(`Ref ${ref} is a primitive and has no properties`);
   }
+  const depth = Math.min(options.depth ?? 1, MAX_DEPTH);
+  return fetchPropsRecursive(session, objectId, options, depth);
+}
+async function fetchPropsRecursive(session, objectId, options, remainingDepth) {
   const propsParams = {
     objectId,
     ownProperties: options.own ?? true,
@@ -9723,7 +9819,10 @@ async function getProps(session, ref, options = {}) {
   if (options.internal) {
     propsParams.accessorPropertiesOnly = false;
   }
-  const propsResult = await session.adapter.getProperties(session.cdp, propsParams);
+  const cdp = session.cdp;
+  if (!cdp)
+    throw new Error("No active debug session");
+  const propsResult = await session.adapter.getProperties(cdp, propsParams);
   const properties = propsResult.result ?? [];
   const internalProps = options.internal ? propsResult.internalProperties ?? [] : [];
   const result = [];
@@ -9758,6 +9857,9 @@ async function getProps(session, ref, options = {}) {
     if (isAccessor) {
       item.isAccessor = true;
     }
+    if (propValue?.objectId && remainingDepth > 1) {
+      item.children = await fetchPropsRecursive(session, propValue.objectId, options, remainingDepth - 1);
+    }
     result.push(item);
   }
   for (const prop of internalProps) {
@@ -9777,6 +9879,9 @@ async function getProps(session, ref, options = {}) {
     if (propRef) {
       item.ref = propRef;
     }
+    if (propValue.objectId && remainingDepth > 1) {
+      item.children = await fetchPropsRecursive(session, propValue.objectId, options, remainingDepth - 1);
+    }
     result.push(item);
   }
   return result;
@@ -9945,6 +10050,10 @@ function getStack(session, options = {}) {
     }
     stackFrames.push(stackEntry);
   }
+  if (options.filter) {
+    const filterLower = options.filter.toLowerCase();
+    return stackFrames.filter((f) => f.functionName.toLowerCase().includes(filterLower) || f.file.toLowerCase().includes(filterLower));
+  }
   return stackFrames;
 }
 async function searchInScripts(session, query, options = {}) {
@@ -10011,6 +10120,7 @@ function getExceptions(session, options = {}) {
 function clearConsole(session) {
   session.consoleMessages = [];
 }
+var MAX_DEPTH = 5;
 var init_session_inspection = () => {};
 
 // src/daemon/session-mutation.ts
@@ -10161,7 +10271,12 @@ var init_session_mutation = () => {};
 // src/daemon/session-state.ts
 async function buildState(session, options = {}) {
   if (session.sessionState !== "paused" || !session.cdp || !session.pauseInfo) {
-    return { status: session.sessionState };
+    const snapshot2 = { status: session.sessionState };
+    if (session.sessionState === "idle" && session.exceptionEntries.length > 0) {
+      const last = session.exceptionEntries[session.exceptionEntries.length - 1];
+      snapshot2.lastException = { text: last.text, description: last.description };
+    }
+    return snapshot2;
   }
   session.refs.clearVolatile();
   const showAll = !options.vars && !options.stack && !options.breakpoints && !options.code;
@@ -10475,6 +10590,10 @@ class DebugSession {
       }
       status.pauseInfo = translated;
     }
+    if (this.state === "idle" && this.exceptionEntries.length > 0) {
+      const last = this.exceptionEntries[this.exceptionEntries.length - 1];
+      status.lastException = { text: last.text, description: last.description };
+    }
     return status;
   }
   async stop() {
@@ -10701,7 +10820,7 @@ class DebugSession {
       };
       this.cdp?.waitFor("Debugger.paused", { timeoutMs }).then(() => settle()).catch(() => settle());
       const pollTimer = setInterval(() => {
-        if (this.isPaused() || this.state === "idle") {
+        if (this.isPaused() || this.state === "idle" || !this.cdp) {
           settle();
         }
       }, 100);
@@ -10978,7 +11097,7 @@ var init_entry = __esm(async () => {
   daemonIdx = process.argv.indexOf("--daemon");
   session = daemonIdx !== -1 ? process.argv[daemonIdx + 1] : process.argv[2];
   if (!session) {
-    console.error("Usage: agent-dbg --daemon <session> [--timeout <seconds>]");
+    console.error("Usage: debug-that --daemon <session> [--timeout <seconds>]");
     process.exit(1);
   }
   timeoutIdx = process.argv.indexOf("--timeout");
@@ -11129,8 +11248,13 @@ var init_entry = __esm(async () => {
       }
       case "eval": {
         const { expression, ...evalOptions } = req.args;
-        const evalResult = await activeSession().eval(expression, evalOptions);
-        return { ok: true, data: evalResult };
+        try {
+          const evalResult = await activeSession().eval(expression, evalOptions);
+          return { ok: true, data: evalResult };
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : String(err);
+          return { ok: false, error: msg, suggestion: suggestEvalFix(msg) };
+        }
       }
       case "vars": {
         const varsResult = await activeSession().getVars(req.args);
@@ -11204,6 +11328,18 @@ var init_entry = __esm(async () => {
         const result = await activeSession().restart();
         return { ok: true, data: result };
       }
+      case "modules": {
+        const session2 = activeSession();
+        if (!("getModules" in session2)) {
+          return {
+            ok: false,
+            error: "Modules are only available in DAP mode (e.g. --runtime lldb)",
+            suggestion: "For CDP sessions, use: debug-that scripts"
+          };
+        }
+        const modulesResult = await session2.getModules(req.args.filter);
+        return { ok: true, data: modulesResult };
+      }
       case "stop":
         await activeSession().stop();
         dapSession = null;
@@ -11236,7 +11372,7 @@ var init_registry = __esm(() => {
 });
 
 // src/daemon/client.ts
-import { existsSync as existsSync3, readdirSync, readFileSync, unlinkSync as unlinkSync2 } from "fs";
+import { existsSync as existsSync4, readdirSync, readFileSync, unlinkSync as unlinkSync2 } from "fs";
 
 class DaemonClient {
   session;
@@ -11333,11 +11469,11 @@ class DaemonClient {
   }
   static isRunning(session2) {
     const socketPath = getSocketPath(session2);
-    if (!existsSync3(socketPath)) {
+    if (!existsSync4(socketPath)) {
       return false;
     }
     const lockPath = getLockPath(session2);
-    if (!existsSync3(lockPath)) {
+    if (!existsSync4(lockPath)) {
       return false;
     }
     try {
@@ -11353,14 +11489,14 @@ class DaemonClient {
   static cleanStaleFiles(session2) {
     const socketPath = getSocketPath(session2);
     const lockPath = getLockPath(session2);
-    if (existsSync3(socketPath))
+    if (existsSync4(socketPath))
       unlinkSync2(socketPath);
-    if (existsSync3(lockPath))
+    if (existsSync4(lockPath))
       unlinkSync2(lockPath);
   }
   static async isAlive(session2) {
     const socketPath = getSocketPath(session2);
-    if (!existsSync3(socketPath)) {
+    if (!existsSync4(socketPath)) {
       return false;
     }
     try {
@@ -11373,7 +11509,7 @@ class DaemonClient {
   }
   static listSessions() {
     const dir = getSocketDir();
-    if (!existsSync3(dir)) {
+    if (!existsSync4(dir)) {
       return [];
     }
     const files = readdirSync(dir);
@@ -11386,7 +11522,7 @@ var init_client3 = __esm(() => {
 });
 
 // src/daemon/spawn.ts
-import { closeSync, existsSync as existsSync4, openSync, readFileSync as readFileSync2 } from "fs";
+import { closeSync, existsSync as existsSync5, openSync, readFileSync as readFileSync2 } from "fs";
 async function spawnDaemon(session2, options = {}) {
   const socketPath = getSocketPath(session2);
   const spawnArgs = [];
@@ -11413,7 +11549,7 @@ async function spawnDaemon(session2, options = {}) {
   proc.unref();
   const deadline = Date.now() + SPAWN_TIMEOUT_MS;
   while (Date.now() < deadline) {
-    if (existsSync4(socketPath)) {
+    if (existsSync5(socketPath)) {
       return;
     }
     await Bun.sleep(SPAWN_POLL_INTERVAL_MS);
@@ -11486,7 +11622,7 @@ var init_launch = __esm(() => {
     const command = args.subcommand ? [args.subcommand, ...args.positionals] : [...args.positionals];
     if (command.length === 0) {
       console.error("No command specified");
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     await ensureDaemon(session2, { timeout: timeout2 });
@@ -11527,12 +11663,12 @@ var init_attach = __esm(() => {
     const runtime = typeof args.flags.runtime === "string" ? args.flags.runtime : undefined;
     if (!target) {
       console.error("No target specified");
-      console.error("  -> Try: agent-dbg attach <ws-url | port>");
+      console.error("  -> Try: dbg attach <ws-url | port>");
       return 1;
     }
     if (DaemonClient.isRunning(session2)) {
       console.error(`Session "${session2}" is already active`);
-      console.error(`  -> Try: agent-dbg stop --session ${session2}`);
+      console.error(`  -> Try: dbg stop --session ${session2}`);
       return 1;
     }
     const timeout2 = parseIntFlag(args.flags, "timeout");
@@ -11594,7 +11730,7 @@ var init_restart = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -11697,7 +11833,7 @@ var init_status = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -11724,6 +11860,12 @@ var init_status = __esm(() => {
         const loc = data.pauseInfo.url ? `${shortPath(data.pauseInfo.url)}:${data.pauseInfo.line}${data.pauseInfo.column !== undefined ? `:${data.pauseInfo.column}` : ""}` : "unknown";
         console.log(`  Paused: ${data.pauseInfo.reason} at ${loc}`);
       }
+      if (data.lastException) {
+        const desc = data.lastException.description ?? data.lastException.text;
+        const firstLine = desc.split(`
+`)[0] ?? desc;
+        console.log(`  Last exception: ${firstLine}`);
+      }
     }
     return 0;
   });
@@ -11900,7 +12042,17 @@ var init_variables = __esm(() => {
 function printState(data) {
   if (data.status !== "paused") {
     const icon = data.status === "running" ? "\u25B6" : "\u25CB";
-    console.log(`${icon} ${data.status === "running" ? "Running" : "Idle"}`);
+    const label = data.status === "running" ? "Running" : "Idle";
+    if (data.lastException) {
+      const desc = data.lastException.description ?? data.lastException.text;
+      const firstLine = desc.split(`
+`)[0] ?? desc;
+      console.log(`${icon} ${label} (crashed)`);
+      console.log(`  ${firstLine}`);
+      console.log("  -> Try: dbg exceptions");
+    } else {
+      console.log(`${icon} ${label}`);
+    }
     return;
   }
   const loc = data.location ? `${shortPath(data.location.url)}:${data.location.line}${data.location.column !== undefined ? `:${data.location.column}` : ""}` : "unknown";
@@ -11972,7 +12124,7 @@ var init_state = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -12027,7 +12179,7 @@ var init_continue = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -12058,7 +12210,7 @@ var init_step = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const validModes = new Set(["over", "into", "out"]);
@@ -12091,7 +12243,7 @@ var init_pause = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -12157,13 +12309,13 @@ var init_run_to = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const target = args.subcommand ?? args.positionals[0];
     if (!target) {
       console.error("No target specified");
-      console.error("  -> Try: agent-dbg run-to src/file.ts:42");
+      console.error("  -> Try: dbg run-to src/file.ts:42");
       return 1;
     }
     const parsed = parseFileLine(target);
@@ -12201,7 +12353,7 @@ var init_break = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const patternFlag = typeof args.flags.pattern === "string" ? args.flags.pattern : undefined;
@@ -12213,7 +12365,7 @@ var init_break = __esm(() => {
       const lastColon = patternFlag.lastIndexOf(":");
       if (lastColon === -1 || lastColon === 0) {
         console.error(`Invalid --pattern target: "${patternFlag}"`);
-        console.error("  -> Try: agent-dbg break --pattern 'app\\.js':42");
+        console.error("  -> Try: dbg break --pattern 'app\\.js':42");
         return 1;
       }
       file2 = patternFlag.slice(0, lastColon);
@@ -12226,13 +12378,13 @@ var init_break = __esm(() => {
       const target = args.subcommand;
       if (!target) {
         console.error("No target specified");
-        console.error("  -> Try: agent-dbg break src/app.ts:42");
+        console.error("  -> Try: dbg break src/app.ts:42");
         return 1;
       }
       const parsed = parseFileLineColumn(target);
       if (!parsed) {
         console.error(`Invalid breakpoint target: "${target}"`);
-        console.error("  -> Try: agent-dbg break src/app.ts:42 or src/app.ts:42:5");
+        console.error("  -> Try: dbg break src/app.ts:42 or src/app.ts:42:5");
         return 1;
       }
       file2 = parsed.file;
@@ -12319,14 +12471,14 @@ var init_break_fn = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk --runtime lldb ./program");
+      console.error("  -> Try: dbg launch --brk --runtime lldb ./program");
       return 1;
     }
     const name = args.subcommand;
     if (!name) {
-      console.error("Usage: agent-dbg break-fn <function-name>");
-      console.error("  Example: agent-dbg break-fn __assert_rtn");
-      console.error("  Example: agent-dbg break-fn 'yoga::Style::operator=='");
+      console.error("Usage: dbg break-fn <function-name>");
+      console.error("  Example: dbg break-fn __assert_rtn");
+      console.error("  Example: dbg break-fn 'yoga::Style::operator=='");
       return 1;
     }
     const condition = typeof args.flags.condition === "string" ? args.flags.condition : undefined;
@@ -12357,13 +12509,13 @@ var init_break_rm = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const ref = args.subcommand;
     if (!ref) {
       console.error("No breakpoint ref specified");
-      console.error("  -> Try: agent-dbg break-rm BP#1");
+      console.error("  -> Try: dbg break-rm BP#1");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -12397,7 +12549,7 @@ var init_break_ls = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -12445,26 +12597,26 @@ var init_logpoint = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const target = args.subcommand;
     if (!target) {
       console.error("No target specified");
-      console.error('  -> Try: agent-dbg logpoint src/app.ts:42 "x =", x');
+      console.error('  -> Try: dbg logpoint src/app.ts:42 "x =", x');
       return 1;
     }
     const parsed = parseFileLine(target);
     if (!parsed) {
       console.error(`Invalid logpoint target: "${target}"`);
-      console.error('  -> Try: agent-dbg logpoint src/app.ts:42 "x =", x');
+      console.error('  -> Try: dbg logpoint src/app.ts:42 "x =", x');
       return 1;
     }
     const { file: file2, line } = parsed;
     const template = args.positionals[0];
     if (!template) {
       console.error("No log template specified");
-      console.error('  -> Try: agent-dbg logpoint src/app.ts:42 "x =", x');
+      console.error('  -> Try: dbg logpoint src/app.ts:42 "x =", x');
       return 1;
     }
     const condition = typeof args.flags.condition === "string" ? args.flags.condition : undefined;
@@ -12505,13 +12657,13 @@ var init_catch = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const mode = args.subcommand ?? "all";
     if (!VALID_MODES.has(mode)) {
       console.error(`Invalid catch mode: "${mode}"`);
-      console.error("  -> Try: agent-dbg catch [all | uncaught | caught | none]");
+      console.error("  -> Try: dbg catch [all | uncaught | caught | none]");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -12542,7 +12694,7 @@ var init_source2 = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -12591,7 +12743,7 @@ var init_scripts = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -12628,6 +12780,52 @@ var init_scripts = __esm(() => {
   });
 });
 
+// src/commands/modules.ts
+var exports_modules = {};
+var init_modules = __esm(() => {
+  init_registry();
+  init_client3();
+  registerCommand("modules", async (args) => {
+    const session2 = args.global.session;
+    if (!DaemonClient.isRunning(session2)) {
+      console.error(`No active session "${session2}"`);
+      console.error("  -> Try: dbg launch --brk node app.js");
+      return 1;
+    }
+    const client = new DaemonClient(session2);
+    const modulesArgs = {};
+    const filter = args.subcommand ?? (typeof args.flags.filter === "string" ? args.flags.filter : undefined);
+    if (filter) {
+      modulesArgs.filter = filter;
+    }
+    const response = await client.request("modules", modulesArgs);
+    if (!response.ok) {
+      console.error(`${response.error}`);
+      if (response.suggestion)
+        console.error(`  ${response.suggestion}`);
+      return 1;
+    }
+    const data = response.data;
+    if (args.global.json) {
+      console.log(JSON.stringify(data, null, 2));
+      return 0;
+    }
+    if (data.length === 0) {
+      console.log("No modules loaded");
+      return 0;
+    }
+    const nameWidth = Math.max(...data.map((m) => m.name.length), 4);
+    const statusWidth = Math.max(...data.map((m) => (m.symbolStatus ?? "").length), 7);
+    for (const mod of data) {
+      const name = mod.name.padEnd(nameWidth);
+      const status = (mod.symbolStatus ?? "unknown").padEnd(statusWidth);
+      const path = mod.path ?? "";
+      console.log(`  ${name}  ${status}  ${path}`);
+    }
+    return 0;
+  });
+});
+
 // src/commands/stack.ts
 var exports_stack = {};
 var init_stack2 = __esm(() => {
@@ -12638,7 +12836,7 @@ var init_stack2 = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -12649,6 +12847,9 @@ var init_stack2 = __esm(() => {
     if (args.flags.generated === true) {
       stackArgs.generated = true;
     }
+    if (typeof args.flags.filter === "string") {
+      stackArgs.filter = args.flags.filter;
+    }
     const response = await client.request("stack", stackArgs);
     if (!response.ok) {
       console.error(`${response.error}`);
@@ -12688,7 +12889,7 @@ var init_search = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const parts = [];
@@ -12701,7 +12902,7 @@ var init_search = __esm(() => {
     const query = parts.join(" ");
     if (!query) {
       console.error("No search query specified");
-      console.error("  -> Try: agent-dbg search <query> [--regex] [--case-sensitive]");
+      console.error("  -> Try: dbg search <query> [--regex] [--case-sensitive]");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -12756,7 +12957,7 @@ var init_console = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -12803,7 +13004,7 @@ var init_exceptions = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -12850,7 +13051,7 @@ var init_eval = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const parts = [];
@@ -12861,7 +13062,7 @@ var init_eval = __esm(() => {
     const expression = parts.join(" ");
     if (!expression) {
       console.error("No expression specified");
-      console.error("  -> Try: agent-dbg eval 1 + 2");
+      console.error("  -> Try: dbg eval 1 + 2");
       return 1;
     }
     const evalArgs = {
@@ -12910,7 +13111,7 @@ var init_vars = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const names = [];
@@ -12968,13 +13169,13 @@ var init_props = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const ref = args.subcommand;
     if (!ref) {
       console.error("No ref specified");
-      console.error("  -> Try: agent-dbg props @v1");
+      console.error("  -> Try: dbg props @v1");
       return 1;
     }
     const propsArgs = {
@@ -13030,7 +13231,7 @@ var init_blackbox = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const patterns = [];
@@ -13042,7 +13243,7 @@ var init_blackbox = __esm(() => {
     }
     if (patterns.length === 0) {
       console.error("No patterns specified");
-      console.error("  -> Try: agent-dbg blackbox node_modules");
+      console.error("  -> Try: dbg blackbox node_modules");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -13075,7 +13276,7 @@ var init_blackbox_ls = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -13112,7 +13313,7 @@ var init_blackbox_rm = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const patterns = [];
@@ -13128,8 +13329,8 @@ var init_blackbox_rm = __esm(() => {
     }
     if (patterns.length === 0) {
       console.error("No patterns specified");
-      console.error("  -> Try: agent-dbg blackbox-rm node_modules");
-      console.error("  -> Try: agent-dbg blackbox-rm all");
+      console.error("  -> Try: dbg blackbox-rm node_modules");
+      console.error("  -> Try: dbg blackbox-rm all");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -13166,19 +13367,19 @@ var init_set = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const varName = args.subcommand;
     if (!varName) {
       console.error("No variable name specified");
-      console.error("  -> Try: agent-dbg set counter 42");
+      console.error("  -> Try: dbg set counter 42");
       return 1;
     }
     const valueParts = args.positionals;
     if (valueParts.length === 0) {
       console.error("No value specified");
-      console.error("  -> Try: agent-dbg set counter 42");
+      console.error("  -> Try: dbg set counter 42");
       return 1;
     }
     const value = valueParts.join(" ");
@@ -13216,7 +13417,7 @@ var init_set_return = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const parts = [];
@@ -13227,7 +13428,7 @@ var init_set_return = __esm(() => {
     const value = parts.join(" ");
     if (!value) {
       console.error("No value specified");
-      console.error("  -> Try: agent-dbg set-return 42");
+      console.error("  -> Try: dbg set-return 42");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -13257,13 +13458,13 @@ var init_hotpatch = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const file2 = args.subcommand;
     if (!file2) {
       console.error("No file specified");
-      console.error("  -> Try: agent-dbg hotpatch app.js");
+      console.error("  -> Try: dbg hotpatch app.js");
       return 1;
     }
     let source;
@@ -13312,13 +13513,13 @@ var init_break_toggle = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const ref = args.subcommand;
     if (!ref) {
       console.error("No breakpoint ref specified");
-      console.error("  -> Try: agent-dbg break-toggle BP#1");
+      console.error("  -> Try: dbg break-toggle BP#1");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -13352,13 +13553,13 @@ var init_breakable = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const target = args.subcommand;
     if (!target) {
       console.error("No target specified");
-      console.error("  -> Try: agent-dbg breakable src/app.ts:10-20");
+      console.error("  -> Try: dbg breakable src/app.ts:10-20");
       return 1;
     }
     const lastColon = target.lastIndexOf(":");
@@ -13415,7 +13616,7 @@ var init_restart_frame = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const frameRef = args.subcommand ?? undefined;
@@ -13448,7 +13649,7 @@ var init_sourcemap = __esm(() => {
     const session2 = args.global.session;
     if (!DaemonClient.isRunning(session2)) {
       console.error(`No active session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const client = new DaemonClient(session2);
@@ -13491,6 +13692,148 @@ var init_sourcemap = __esm(() => {
   });
 });
 
+// src/commands/install.ts
+var exports_install = {};
+import { existsSync as existsSync6, mkdirSync as mkdirSync2 } from "fs";
+import { join as join3 } from "path";
+function getPlatformArch() {
+  const os = process.platform;
+  const arch = process.arch;
+  return { os, arch };
+}
+function getLlvmDownloadUrl(version, os, arch) {
+  if (os === "darwin") {
+    if (arch === "arm64") {
+      return `https://github.com/llvm/llvm-project/releases/download/llvmorg-${version}/LLVM-${version}-macOS-ARM64.tar.xz`;
+    }
+    if (arch === "x64") {
+      return `https://github.com/llvm/llvm-project/releases/download/llvmorg-${version}/LLVM-${version}-macOS-X64.tar.xz`;
+    }
+  }
+  if (os === "linux") {
+    if (arch === "x64") {
+      return `https://github.com/llvm/llvm-project/releases/download/llvmorg-${version}/LLVM-${version}-Linux-X64.tar.xz`;
+    }
+    if (arch === "arm64") {
+      return `https://github.com/llvm/llvm-project/releases/download/llvmorg-${version}/LLVM-${version}-Linux-AArch64.tar.xz`;
+    }
+  }
+  return null;
+}
+var LLVM_VERSION = "19.1.7";
+var init_install = __esm(() => {
+  init_registry();
+  init_session();
+  registerCommand("install", async (args) => {
+    const adapter = args.subcommand;
+    if (args.flags.list === true) {
+      const dir = getManagedAdaptersDir();
+      console.log(`Managed adapters directory: ${dir}`);
+      if (!existsSync6(dir)) {
+        console.log("  (empty \u2014 no adapters installed)");
+        return 0;
+      }
+      const entries = Array.from(new Bun.Glob("*").scanSync(dir));
+      if (entries.length === 0) {
+        console.log("  (empty \u2014 no adapters installed)");
+      } else {
+        for (const entry of entries) {
+          console.log(`  ${entry}`);
+        }
+      }
+      return 0;
+    }
+    if (!adapter) {
+      console.error("Usage: dbg install <adapter>");
+      console.error("  Supported adapters: lldb");
+      console.error("  Options: --list (show installed adapters)");
+      return 1;
+    }
+    if (adapter !== "lldb") {
+      console.error(`Unknown adapter: ${adapter}`);
+      console.error("  Supported adapters: lldb");
+      return 1;
+    }
+    const { os, arch } = getPlatformArch();
+    const url2 = getLlvmDownloadUrl(LLVM_VERSION, os, arch);
+    if (!url2) {
+      console.error(`Unsupported platform: ${os}-${arch}`);
+      console.error("  Supported: darwin-arm64, darwin-x64, linux-x64, linux-arm64");
+      return 1;
+    }
+    const adaptersDir = getManagedAdaptersDir();
+    const targetPath = join3(adaptersDir, "lldb-dap");
+    if (existsSync6(targetPath)) {
+      console.log(`lldb-dap already installed at ${targetPath}`);
+      console.log(`  To reinstall, remove it first: rm ${targetPath}`);
+      return 0;
+    }
+    console.log(`Downloading LLVM ${LLVM_VERSION} for ${os}-${arch}...`);
+    console.log(`  From: ${url2}`);
+    const response = await fetch(url2, { redirect: "follow" });
+    if (!response.ok) {
+      console.error(`Download failed: HTTP ${response.status}`);
+      console.error("  -> Check your internet connection or try again later");
+      return 1;
+    }
+    const tarball = await response.arrayBuffer();
+    console.log(`Downloaded ${(tarball.byteLength / 1024 / 1024).toFixed(1)} MB`);
+    mkdirSync2(adaptersDir, { recursive: true });
+    const tmpTar = join3(adaptersDir, "llvm-download.tar.xz");
+    await Bun.write(tmpTar, tarball);
+    console.log("Extracting lldb-dap...");
+    const listResult = Bun.spawnSync(["tar", "-tf", tmpTar], {
+      stdout: "pipe"
+    });
+    const files = listResult.stdout.toString().split(`
+`);
+    const lldbDapEntry = files.find((f) => f.endsWith("/bin/lldb-dap") || f === "bin/lldb-dap");
+    if (!lldbDapEntry) {
+      Bun.spawnSync(["rm", tmpTar]);
+      console.error("Could not find lldb-dap in the LLVM archive");
+      console.error(`  Archive entries searched: ${files.length}`);
+      console.error("  -> Try installing manually: brew install llvm");
+      return 1;
+    }
+    const extractResult = Bun.spawnSync([
+      "tar",
+      "-xf",
+      tmpTar,
+      "-C",
+      adaptersDir,
+      "--strip-components",
+      String(lldbDapEntry.split("/").length - 1),
+      lldbDapEntry
+    ], { stdout: "pipe", stderr: "pipe" });
+    Bun.spawnSync(["rm", tmpTar]);
+    if (extractResult.exitCode !== 0) {
+      console.error(`Extraction failed: ${extractResult.stderr.toString()}`);
+      return 1;
+    }
+    const liblldbEntries = files.filter((f) => f.includes("liblldb") && (f.endsWith(".so") || f.endsWith(".dylib")));
+    for (const libEntry of liblldbEntries) {
+      Bun.spawnSync([
+        "tar",
+        "-xf",
+        tmpTar,
+        "-C",
+        adaptersDir,
+        "--strip-components",
+        String(libEntry.split("/").length - 1),
+        libEntry
+      ], { stdout: "pipe", stderr: "pipe" });
+    }
+    Bun.spawnSync(["chmod", "+x", targetPath]);
+    if (existsSync6(targetPath)) {
+      console.log(`Installed lldb-dap to ${targetPath}`);
+      return 0;
+    }
+    console.error("Installation failed \u2014 lldb-dap not found after extraction");
+    console.error("  -> Try installing manually: brew install llvm");
+    return 1;
+  });
+});
+
 // src/formatter/logs.ts
 function formatTime(ts) {
   const d = new Date(ts);
@@ -13609,7 +13952,7 @@ var init_logs = __esm(() => {
 var exports_logs = {};
 import {
   closeSync as closeSync2,
-  existsSync as existsSync5,
+  existsSync as existsSync7,
   openSync as openSync2,
   readFileSync as readFileSync3,
   readSync,
@@ -13673,7 +14016,7 @@ var init_logs2 = __esm(() => {
     const isDaemon = args.flags.daemon === true;
     const logPath = isDaemon ? getDaemonLogPath(session2) : getLogPath(session2);
     if (args.flags.clear === true) {
-      if (existsSync5(logPath)) {
+      if (existsSync7(logPath)) {
         writeFileSync4(logPath, "");
         console.log(`${isDaemon ? "Daemon log" : "Log"} cleared`);
       } else {
@@ -13681,9 +14024,9 @@ var init_logs2 = __esm(() => {
       }
       return 0;
     }
-    if (!existsSync5(logPath)) {
+    if (!existsSync7(logPath)) {
       console.error(`No ${isDaemon ? "daemon " : ""}log file for session "${session2}"`);
-      console.error("  -> Try: agent-dbg launch --brk node app.js");
+      console.error("  -> Try: dbg launch --brk node app.js");
       return 1;
     }
     const isJson = args.global.json;
@@ -13748,16 +14091,16 @@ var init_logs2 = __esm(() => {
 // package.json
 var require_package = __commonJS((exports, module) => {
   module.exports = {
-    name: "agent-dbg",
-    version: "0.2.0",
+    name: "debug-that",
+    version: "0.2.1",
     description: "Node.js Debugger CLI for AI Agents",
     license: "MIT",
     author: "Theodo Group",
     repository: {
       type: "git",
-      url: "https://github.com/theodo-group/agent-dbg.git"
+      url: "https://github.com/theodo-group/debug-that.git"
     },
-    homepage: "https://github.com/theodo-group/agent-dbg",
+    homepage: "https://github.com/theodo-group/debug-that",
     keywords: [
       "debugger",
       "cli",
@@ -13771,7 +14114,8 @@ var require_package = __commonJS((exports, module) => {
     ],
     type: "module",
     bin: {
-      "agent-dbg": "./dist/main.js"
+      "debug-that": "./dist/main.js",
+      dbg: "./dist/main.js"
     },
     files: [
       "dist",
@@ -13912,9 +14256,9 @@ async function run(args) {
     const suggestion = suggestCommand(args.command);
     console.error(`\u2717 Unknown command: ${args.command}`);
     if (suggestion) {
-      console.error(`  \u2192 Did you mean: agent-dbg ${suggestion}`);
+      console.error(`  \u2192 Did you mean: dbg ${suggestion}`);
     } else {
-      console.error("  \u2192 Try: agent-dbg --help");
+      console.error("  \u2192 Try: dbg --help");
     }
     return 1;
   }
@@ -13932,7 +14276,7 @@ async function run(args) {
 }
 function printVersion() {
   const pkg = require_package();
-  console.log(`agent-dbg ${pkg.version}`);
+  console.log(`dbg ${pkg.version}`);
 }
 function suggestCommand(input) {
   let bestMatch = null;
@@ -13961,9 +14305,9 @@ function editDistance(a, b) {
   return prev[n] ?? m;
 }
 function printHelp() {
-  console.log(`agent-dbg \u2014 Node.js debugger CLI for AI agents
+  console.log(`dbg \u2014 Node.js debugger CLI for AI agents
 
-Usage: agent-dbg <command> [options]
+Usage: dbg <command> [options]
 
 Session:
   launch [--brk] <command...>      Start + attach debugger
@@ -13985,7 +14329,7 @@ Inspection:
   vars [name...]                   Show local variables
     [--frame @fN] [--all-scopes]
   stack [--async-depth N]          Show call stack
-    [--generated]
+    [--generated] [--filter <keyword>]
   eval <expression>                Evaluate expression
     [--frame @fN] [--silent] [--timeout MS] [--side-effect-free]
   props <@ref>                     Expand object properties
@@ -13995,6 +14339,7 @@ Inspection:
   search <query>                   Search loaded scripts
     [--regex] [--case-sensitive] [--file <id>]
   scripts [--filter <pattern>]     List loaded scripts
+  modules [--filter <pattern>]     List loaded modules/libraries (DAP only)
   console [--since N] [--level]    Console output
     [--clear]
   exceptions [--since N]           Captured exceptions
@@ -14024,6 +14369,10 @@ Source Maps:
   sourcemap [file]                 Show source map info
   sourcemap --disable              Disable resolution globally
 
+Setup:
+  install <adapter>                Download managed adapter binary
+  install --list                   Show installed adapters
+
 Diagnostics:
   logs [-f|--follow]               Show CDP protocol log
     [--limit N] [--domain <name>] [--clear]
@@ -14037,69 +14386,70 @@ Global flags:
   --version                        Show version`);
 }
 function printHelpAgent() {
-  console.log(`agent-dbg \u2014 Node.js debugger CLI for AI agents
+  console.log(`dbg \u2014 Node.js debugger CLI for AI agents
 
 CORE LOOP:
-  1. agent-dbg launch --brk "node app.js"    \u2192 pauses at first line, returns state
-  2. agent-dbg break src/file.ts:42          \u2192 set breakpoint
-  3. agent-dbg continue                      \u2192 run to breakpoint, returns state
-  4. Inspect: agent-dbg vars, agent-dbg eval, agent-dbg props @v1
-  5. Mutate/fix: agent-dbg set @v1 value, agent-dbg hotpatch src/file.ts
+  1. dbg launch --brk "node app.js"    \u2192 pauses at first line, returns state
+  2. dbg break src/file.ts:42          \u2192 set breakpoint
+  3. dbg continue                      \u2192 run to breakpoint, returns state
+  4. Inspect: dbg vars, dbg eval, dbg props @v1
+  5. Mutate/fix: dbg set @v1 value, dbg hotpatch src/file.ts
   6. Repeat from 3
 
 REFS: Every output assigns @refs. Use them everywhere:
-  @v1..@vN  variables    |  agent-dbg props @v1, agent-dbg set @v2 true
-  @f0..@fN  stack frames |  agent-dbg eval --frame @f1
-  BP#1..N   breakpoints  |  agent-dbg break-rm BP#1, agent-dbg break-toggle BP#1
+  @v1..@vN  variables    |  dbg props @v1, dbg set @v2 true
+  @f0..@fN  stack frames |  dbg eval --frame @f1
+  BP#1..N   breakpoints  |  dbg break-rm BP#1, dbg break-toggle BP#1
 
 EXECUTION (all return state automatically):
-  agent-dbg continue              Resume to next breakpoint
-  agent-dbg step [over|into|out]  Step one statement
-  agent-dbg run-to file:line      Continue to location
-  agent-dbg pause                 Interrupt running process
-  agent-dbg restart-frame [@fN]   Re-run frame from beginning
+  dbg continue              Resume to next breakpoint
+  dbg step [over|into|out]  Step one statement
+  dbg run-to file:line      Continue to location
+  dbg pause                 Interrupt running process
+  dbg restart-frame [@fN]   Re-run frame from beginning
 
 BREAKPOINTS:
-  agent-dbg break file:line [--condition expr] [--hit-count N] [--continue]
-  agent-dbg break --pattern "regex":line
-  agent-dbg break-rm <BP#|all>    Remove breakpoints
-  agent-dbg break-ls              List breakpoints
-  agent-dbg break-toggle <BP#|all>  Enable/disable breakpoints
-  agent-dbg breakable file:start-end  Valid breakpoint locations
-  agent-dbg logpoint file:line "template \${var}" [--condition expr]
-  agent-dbg catch [all|uncaught|caught|none]
+  dbg break file:line [--condition expr] [--hit-count N] [--continue]
+  dbg break --pattern "regex":line
+  dbg break-rm <BP#|all>    Remove breakpoints
+  dbg break-ls              List breakpoints
+  dbg break-toggle <BP#|all>  Enable/disable breakpoints
+  dbg breakable file:start-end  Valid breakpoint locations
+  dbg logpoint file:line "template \${var}" [--condition expr]
+  dbg catch [all|uncaught|caught|none]
 
 INSPECTION:
-  agent-dbg state [-v|-s|-b|-c] [--depth N] [--lines N] [--frame @fN] [--all-scopes] [--compact] [--generated]
-  agent-dbg vars [name...] [--frame @fN] [--all-scopes]
-  agent-dbg stack [--async-depth N] [--generated]
-  agent-dbg eval <expr> [--frame @fN] [--silent] [--timeout MS] [--side-effect-free]
-  agent-dbg props @ref [--own] [--depth N] [--private] [--internal]
-  agent-dbg source [--lines N] [--file path] [--all] [--generated]
-  agent-dbg search "query" [--regex] [--case-sensitive] [--file id]
-  agent-dbg scripts [--filter pattern]
-  agent-dbg console [--since N] [--level type] [--clear]
-  agent-dbg exceptions [--since N]
+  dbg state [-v|-s|-b|-c] [--depth N] [--lines N] [--frame @fN] [--all-scopes] [--compact] [--generated]
+  dbg vars [name...] [--frame @fN] [--all-scopes]
+  dbg stack [--async-depth N] [--generated] [--filter <keyword>]
+  dbg eval <expr> [--frame @fN] [--silent] [--timeout MS] [--side-effect-free]
+  dbg props @ref [--own] [--depth N] [--private] [--internal]
+  dbg modules [--filter <pattern>]        (DAP only: list loaded libraries with symbol status)
+  dbg source [--lines N] [--file path] [--all] [--generated]
+  dbg search "query" [--regex] [--case-sensitive] [--file id]
+  dbg scripts [--filter pattern]
+  dbg console [--since N] [--level type] [--clear]
+  dbg exceptions [--since N]
 
 MUTATION:
-  agent-dbg set <@ref|name> <value>   Change variable
-  agent-dbg set-return <value>        Change return value (at return point)
-  agent-dbg hotpatch <file> [--dry-run]  Live-edit code (no restart!)
+  dbg set <@ref|name> <value>   Change variable
+  dbg set-return <value>        Change return value (at return point)
+  dbg hotpatch <file> [--dry-run]  Live-edit code (no restart!)
 
 BLACKBOXING:
-  agent-dbg blackbox <pattern...>     Skip stepping into matching scripts
-  agent-dbg blackbox-ls               List current patterns
-  agent-dbg blackbox-rm <pattern|all> Remove patterns
+  dbg blackbox <pattern...>     Skip stepping into matching scripts
+  dbg blackbox-ls               List current patterns
+  dbg blackbox-rm <pattern|all> Remove patterns
 
 SOURCE MAPS:
-  agent-dbg sourcemap [file]          Show source map info
-  agent-dbg sourcemap --disable       Disable resolution globally
+  dbg sourcemap [file]          Show source map info
+  dbg sourcemap --disable       Disable resolution globally
 
 DIAGNOSTICS:
-  agent-dbg logs [-f|--follow]        Show CDP protocol log
-  agent-dbg logs --limit 100          Show last N entries (default: 50)
-  agent-dbg logs --domain Debugger    Filter by CDP domain
-  agent-dbg logs --clear              Clear the log file`);
+  dbg logs [-f|--follow]        Show CDP protocol log
+  dbg logs --limit 100          Show last N entries (default: 50)
+  dbg logs --domain Debugger    Filter by CDP domain
+  dbg logs --clear              Clear the log file`);
 }
 var GLOBAL_FLAGS, BOOLEAN_FLAGS;
 var init_parser = __esm(() => {
@@ -14163,6 +14513,7 @@ if (process.argv.includes("--daemon")) {
   await Promise.resolve().then(() => (init_catch(), exports_catch));
   await Promise.resolve().then(() => (init_source2(), exports_source));
   await Promise.resolve().then(() => (init_scripts(), exports_scripts));
+  await Promise.resolve().then(() => (init_modules(), exports_modules));
   await Promise.resolve().then(() => (init_stack2(), exports_stack));
   await Promise.resolve().then(() => (init_search(), exports_search));
   await Promise.resolve().then(() => (init_console(), exports_console));
@@ -14180,6 +14531,7 @@ if (process.argv.includes("--daemon")) {
   await Promise.resolve().then(() => (init_breakable(), exports_breakable));
   await Promise.resolve().then(() => (init_restart_frame(), exports_restart_frame));
   await Promise.resolve().then(() => (init_sourcemap(), exports_sourcemap));
+  await Promise.resolve().then(() => (init_install(), exports_install));
   await Promise.resolve().then(() => (init_logs2(), exports_logs));
   const { parseArgs: parseArgs2, run: run2 } = await Promise.resolve().then(() => (init_parser(), exports_parser));
   const args = parseArgs2(process.argv.slice(2));