debug-that 0.2.1 → 0.3.0

package/README.md

@@ -2,6 +2,10 @@
 
 Debugger CLI built for AI agents. Fast, token-efficient, no fluff.
 
+<p align="center">
+  <img src="docs/demo-2x.gif" alt="debug-that demo" />
+</p>
+
 **Why?** Agents waste tokens on print-debugging. A real debugger gives precise state inspection in minimal output — variables, stack, breakpoints — all via short `@ref` handles.
 
 Inspired by Vercel's [agent-browser](https://github.com/vercel-labs/agent-browser) CLI — the same `@ref` concept, applied to debugging instead of browsing.
@@ -15,7 +19,7 @@ Inspired by Vercel's [agent-browser](https://github.com/vercel-labs/agent-browse
 | Bun | JavaScript / TypeScript | Supported | WebKit Inspector (JSC) |
 | LLDB | C / C++ / Rust / Swift | Supported | DAP (Debug Adapter Protocol) |
 | Deno | JavaScript / TypeScript | Planned | V8 Inspector (CDP) |
-| Python (debugpy) | Python | Planned | DAP |
+| Python (debugpy) | Python | Supported | DAP |
 | Go (delve) | Go | Planned | DAP |
 | Java (JDWP) | Java / Kotlin | Planned | DAP |
 

package/dist/main.js

@@ -13,6 +13,9 @@ var __export = (target, all) => {
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
+// src/constants.ts
+var REQUEST_TIMEOUT_MS = 30000, INSPECTOR_TIMEOUT_MS = 5000, SPAWN_TIMEOUT_MS = 5000, SPAWN_POLL_INTERVAL_MS = 50, BRK_PAUSE_TIMEOUT_MS = 2000, MAX_INTERNAL_PAUSE_SKIPS = 5, STATE_WAIT_TIMEOUT_MS = 5000, PAUSE_WAITER_TIMEOUT_MS = 30000, MAX_BUFFERED_MESSAGES = 1000, BUFFER_TRIM_BATCH = 100, MAX_SOURCE_LINE_WIDTH = 120, INITIALIZED_TIMEOUT_MS = 1e4, MAX_REQUEST_SIZE = 1048576;
+
 // src/refs/ref-table.ts
 class RefTable {
   entries = new Map;
@@ -108,9 +111,6 @@ var init_ref_table = __esm(() => {
   };
 });
 
-// src/constants.ts
-var REQUEST_TIMEOUT_MS = 30000, INSPECTOR_TIMEOUT_MS = 5000, SPAWN_TIMEOUT_MS = 5000, SPAWN_POLL_INTERVAL_MS = 50, BRK_PAUSE_TIMEOUT_MS = 2000, MAX_INTERNAL_PAUSE_SKIPS = 5, STATE_WAIT_TIMEOUT_MS = 5000, PAUSE_WAITER_TIMEOUT_MS = 30000, MAX_BUFFERED_MESSAGES = 1000, BUFFER_TRIM_BATCH = 100, MAX_SOURCE_LINE_WIDTH = 120, MAX_REQUEST_SIZE = 1048576;
-
 // src/dap/client.ts
 class DapClient {
   proc;
@@ -325,6 +325,12 @@ function resolveAdapterCommand(runtime) {
     }
     case "codelldb":
       return ["codelldb", "--port", "0"];
+    case "python":
+    case "debugpy": {
+      const py3 = Bun.spawnSync(["which", "python3"]);
+      const pyBin = py3.exitCode === 0 ? "python3" : "python";
+      return [pyBin, "-m", "debugpy.adapter"];
+    }
     default:
       return [runtime];
   }
@@ -368,8 +374,14 @@ class DapSession {
       stopOnEntry: options.brk ?? true,
       cwd: process.cwd()
     };
-    await this.dap.send("launch", launchArgs);
+    if (this._runtime === "python" || this._runtime === "debugpy") {
+      launchArgs.console = "internalConsole";
+      launchArgs.justMyCode = false;
+    }
+    const launchPromise = this.dap.send("launch", launchArgs);
+    await this.waitForInitialized();
     await this.dap.send("configurationDone");
+    await launchPromise;
     if (options.brk !== false) {
       await this.waitForStop(5000);
     }
@@ -393,8 +405,10 @@ class DapSession {
     await this.initializeAdapter();
     const pid = parseInt(target, 10);
     const attachArgs = Number.isNaN(pid) ? { program: target, waitFor: true } : { pid };
-    await this.dap.send("attach", attachArgs);
+    const attachPromise = this.dap.send("attach", attachArgs);
+    await this.waitForInitialized();
     await this.dap.send("configurationDone");
+    await attachPromise;
     await this.waitForStop(5000).catch(() => {});
     if (this._state === "idle") {
       this._state = "running";
@@ -433,12 +447,12 @@ class DapSession {
   async continue() {
     this.requireConnected();
     this.requirePaused();
-    const waiter = this.createStoppedWaiter(30000);
-    await this.getDap().send("continue", { threadId: this._threadId });
     this._state = "running";
     this._pauseInfo = null;
     this._stackFrames = [];
     this.refs.clearVolatile();
+    const waiter = this.createStoppedWaiter(30000);
+    await this.getDap().send("continue", { threadId: this._threadId });
     await waiter;
     if (this.isPaused())
       await this.fetchStackTrace();
@@ -446,12 +460,12 @@ class DapSession {
   async step(mode) {
     this.requireConnected();
     this.requirePaused();
-    const waiter = this.createStoppedWaiter(30000);
-    const command = mode === "into" ? "stepIn" : mode === "out" ? "stepOut" : "next";
-    await this.getDap().send(command, { threadId: this._threadId });
     this._state = "running";
     this._pauseInfo = null;
     this.refs.clearVolatile();
+    const waiter = this.createStoppedWaiter(30000);
+    const command = mode === "into" ? "stepIn" : mode === "out" ? "stepOut" : "next";
+    await this.getDap().send(command, { threadId: this._threadId });
     await waiter;
     if (this.isPaused())
       await this.fetchStackTrace();
@@ -1097,6 +1111,21 @@ class DapSession {
       };
     });
   }
+  async waitForInitialized() {
+    const dap = this.getDap();
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        dap.off("initialized", handler);
+        reject(new Error("Timed out waiting for DAP initialized event"));
+      }, INITIALIZED_TIMEOUT_MS);
+      const handler = () => {
+        clearTimeout(timer);
+        dap.off("initialized", handler);
+        resolve();
+      };
+      dap.on("initialized", handler);
+    });
+  }
   async waitForStop(timeoutMs) {
     if (!this.isPaused()) {
       await this.createStoppedWaiter(timeoutMs);
@@ -11017,7 +11046,7 @@ class DebugSession {
         if (match?.[1]) {
           clearTimeout(timeout);
           this.drainReader(reader);
-          return match[1];
+          return match[1].replace(ANSI_RE, "");
         }
       }
     } catch {}
@@ -11062,7 +11091,7 @@ class DebugSession {
     pump();
   }
 }
-var INSPECTOR_URL_REGEX;
+var INSPECTOR_URL_REGEX, ESC, ANSI_RE;
 var init_session2 = __esm(() => {
   init_client2();
   init_logger2();
@@ -11077,6 +11106,8 @@ var init_session2 = __esm(() => {
   init_session_mutation();
   init_session_state();
   INSPECTOR_URL_REGEX = /(?:Debugger listening on\s+)?(wss?:\/\/\S+)/;
+  ESC = String.fromCharCode(27);
+  ANSI_RE = new RegExp(`${ESC}\\[[0-9;]*m`, "g");
 });
 
 // src/daemon/entry.ts
@@ -11871,6 +11902,306 @@ var init_status = __esm(() => {
   });
 });
 
+// src/formatter/color.ts
+function c(color, text) {
+  return `${color}${text}${RESET}`;
+}
+function shouldEnableColor(explicitFlag) {
+  if (explicitFlag)
+    return true;
+  if (process.env.NO_COLOR !== undefined)
+    return false;
+  if (process.env.FORCE_COLOR !== undefined)
+    return true;
+  if (process.env.DBG_COLOR === "1" || process.env.DBG_COLOR === "true")
+    return true;
+  return false;
+}
+function detectLanguage(url2) {
+  const dot = url2.lastIndexOf(".");
+  if (dot === -1)
+    return "unknown";
+  return EXT_MAP[url2.slice(dot)] ?? "unknown";
+}
+function getKeywords(lang) {
+  switch (lang) {
+    case "js":
+      return { keywords: JS_KEYWORDS, constants: JS_CONSTANTS };
+    case "py":
+      return { keywords: PY_KEYWORDS, constants: PY_CONSTANTS };
+    case "c":
+      return { keywords: C_KEYWORDS, constants: C_CONSTANTS };
+    default:
+      return { keywords: new Set, constants: new Set };
+  }
+}
+function getRegex(lang) {
+  switch (lang) {
+    case "js":
+      return new RegExp(JS_LINE_RE.source, JS_LINE_RE.flags);
+    case "py":
+      return new RegExp(PY_LINE_RE.source, PY_LINE_RE.flags);
+    case "c":
+      return new RegExp(C_LINE_RE.source, C_LINE_RE.flags);
+    default:
+      return new RegExp(JS_LINE_RE.source, JS_LINE_RE.flags);
+  }
+}
+function tokenizeLine(line, lang) {
+  if (lang === "unknown")
+    return [{ text: line }];
+  const { keywords, constants } = getKeywords(lang);
+  const re = getRegex(lang);
+  const tokens = [];
+  for (let match = re.exec(line);match !== null; match = re.exec(line)) {
+    const [full, comment, str, num, word] = match;
+    if (comment) {
+      tokens.push({ text: comment, color: ansi.gray });
+    } else if (str) {
+      tokens.push({ text: str, color: ansi.green });
+    } else if (num) {
+      tokens.push({ text: num, color: ansi.yellow });
+    } else if (word) {
+      if (keywords.has(word)) {
+        tokens.push({ text: word, color: ansi.blue });
+      } else if (constants.has(word)) {
+        tokens.push({ text: word, color: ansi.yellow });
+      } else if (word[0] === word[0]?.toUpperCase() && /^[A-Z]/.test(word)) {
+        tokens.push({ text: word, color: ansi.cyan });
+      } else {
+        tokens.push({ text: word });
+      }
+    } else {
+      tokens.push({ text: full });
+    }
+  }
+  return tokens;
+}
+function highlightLine(line, lang) {
+  const tokens = tokenizeLine(line, lang);
+  return tokens.map((t) => t.color ? c(t.color, t.text) : t.text).join("");
+}
+var ESC2 = "\x1B[", RESET, ansi, EXT_MAP, JS_KEYWORDS, JS_CONSTANTS, PY_KEYWORDS, PY_CONSTANTS, C_KEYWORDS, C_CONSTANTS, JS_LINE_RE, PY_LINE_RE, C_LINE_RE;
+var init_color = __esm(() => {
+  RESET = `${ESC2}0m`;
+  ansi = {
+    reset: RESET,
+    bold: `${ESC2}1m`,
+    dim: `${ESC2}2m`,
+    italic: `${ESC2}3m`,
+    underline: `${ESC2}4m`,
+    red: `${ESC2}31m`,
+    green: `${ESC2}32m`,
+    yellow: `${ESC2}33m`,
+    blue: `${ESC2}34m`,
+    magenta: `${ESC2}35m`,
+    cyan: `${ESC2}36m`,
+    white: `${ESC2}37m`,
+    gray: `${ESC2}90m`,
+    brightRed: `${ESC2}91m`,
+    brightGreen: `${ESC2}92m`,
+    brightYellow: `${ESC2}93m`,
+    brightBlue: `${ESC2}94m`,
+    brightMagenta: `${ESC2}95m`,
+    brightCyan: `${ESC2}96m`
+  };
+  EXT_MAP = {
+    ".js": "js",
+    ".mjs": "js",
+    ".cjs": "js",
+    ".ts": "js",
+    ".mts": "js",
+    ".cts": "js",
+    ".tsx": "js",
+    ".jsx": "js",
+    ".py": "py",
+    ".pyw": "py",
+    ".c": "c",
+    ".cpp": "c",
+    ".cc": "c",
+    ".cxx": "c",
+    ".h": "c",
+    ".hpp": "c",
+    ".rs": "c",
+    ".go": "c",
+    ".java": "c",
+    ".swift": "c",
+    ".m": "c"
+  };
+  JS_KEYWORDS = new Set([
+    "async",
+    "await",
+    "break",
+    "case",
+    "catch",
+    "class",
+    "const",
+    "continue",
+    "debugger",
+    "default",
+    "delete",
+    "do",
+    "else",
+    "export",
+    "extends",
+    "finally",
+    "for",
+    "from",
+    "function",
+    "if",
+    "import",
+    "in",
+    "instanceof",
+    "let",
+    "new",
+    "of",
+    "return",
+    "static",
+    "super",
+    "switch",
+    "this",
+    "throw",
+    "try",
+    "typeof",
+    "var",
+    "void",
+    "while",
+    "with",
+    "yield",
+    "type",
+    "interface",
+    "enum",
+    "as",
+    "implements",
+    "declare",
+    "readonly",
+    "abstract",
+    "override"
+  ]);
+  JS_CONSTANTS = new Set(["true", "false", "null", "undefined", "NaN", "Infinity"]);
+  PY_KEYWORDS = new Set([
+    "and",
+    "as",
+    "assert",
+    "async",
+    "await",
+    "break",
+    "class",
+    "continue",
+    "def",
+    "del",
+    "elif",
+    "else",
+    "except",
+    "finally",
+    "for",
+    "from",
+    "global",
+    "if",
+    "import",
+    "in",
+    "is",
+    "lambda",
+    "nonlocal",
+    "not",
+    "or",
+    "pass",
+    "raise",
+    "return",
+    "try",
+    "while",
+    "with",
+    "yield"
+  ]);
+  PY_CONSTANTS = new Set(["True", "False", "None"]);
+  C_KEYWORDS = new Set([
+    "auto",
+    "break",
+    "case",
+    "char",
+    "const",
+    "continue",
+    "default",
+    "do",
+    "double",
+    "else",
+    "enum",
+    "extern",
+    "float",
+    "for",
+    "goto",
+    "if",
+    "inline",
+    "int",
+    "long",
+    "register",
+    "return",
+    "short",
+    "signed",
+    "sizeof",
+    "static",
+    "struct",
+    "switch",
+    "typedef",
+    "union",
+    "unsigned",
+    "void",
+    "volatile",
+    "while",
+    "class",
+    "namespace",
+    "template",
+    "typename",
+    "public",
+    "private",
+    "protected",
+    "virtual",
+    "override",
+    "final",
+    "new",
+    "delete",
+    "throw",
+    "try",
+    "catch",
+    "using",
+    "nullptr",
+    "fn",
+    "let",
+    "mut",
+    "pub",
+    "impl",
+    "trait",
+    "self",
+    "Self",
+    "match",
+    "mod",
+    "use",
+    "crate",
+    "where",
+    "async",
+    "await",
+    "move",
+    "ref",
+    "unsafe",
+    "func",
+    "package",
+    "import",
+    "var",
+    "type",
+    "range",
+    "defer",
+    "chan",
+    "select",
+    "go",
+    "map",
+    "interface"
+  ]);
+  C_CONSTANTS = new Set(["true", "false", "NULL", "nullptr", "nil"]);
+  JS_LINE_RE = /(\/\/.*$|\/\*.*?\*\/)|("(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'|`(?:[^`\\]|\\.)*`)|((?<!\w)(?:0[xXoObB][\da-fA-F_]+|\d[\d_]*(?:\.[\d_]*)?(?:[eE][+-]?\d+)?n?)(?!\w))|([a-zA-Z_$][\w$]*)|(.)/g;
+  PY_LINE_RE = /(#.*$)|("(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'|"""[\s\S]*?"""|'''[\s\S]*?''')|((?<!\w)(?:0[xXoObB][\da-fA-F_]+|\d[\d_]*(?:\.[\d_]*)?(?:[eE][+-]?\d+)?)(?!\w))|([a-zA-Z_][\w]*)|(.)/g;
+  C_LINE_RE = /(\/\/.*$|\/\*.*?\*\/)|("(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)')|((?<!\w)(?:0[xXoObB][\da-fA-F_]+|\d[\d_]*(?:\.[\d_]*)?(?:[eE][+-]?\d+)?[fFlLuU]*)(?!\w))|([a-zA-Z_][\w]*)|(.)/g;
+});
+
 // src/formatter/source.ts
 function trimLine(content, column) {
   const col = column !== undefined ? column - 1 : undefined;
@@ -11898,9 +12229,11 @@ function trimLine(content, column) {
   const adjustedCaret = col !== undefined ? col - start + (hasPrefix ? 1 : 0) : undefined;
   return { text: `${prefix}${content.slice(start, end)}${suffix}`, caretOffset: adjustedCaret };
 }
-function formatSource(lines) {
+function formatSource(lines, opts) {
   if (lines.length === 0)
     return "";
+  const color = opts?.color ?? false;
+  const lang = opts?.language ?? "unknown";
   const maxLineNum = Math.max(...lines.map((l) => l.lineNumber));
   const numWidth = String(maxLineNum).length;
   const result = [];
@@ -11915,20 +12248,36 @@ function formatSource(lines) {
       marker = " \u25CF";
     }
     const trimmed = line.isCurrent ? trimLine(line.content, line.currentColumn) : trimLine(line.content);
-    result.push(`${marker} ${num}\u2502${trimmed.text}`);
+    let coloredMarker = marker;
+    let coloredNum = num;
+    let coloredContent = trimmed.text;
+    if (color) {
+      if (line.isCurrent) {
+        coloredMarker = c(ansi.brightYellow, marker);
+      } else if (line.hasBreakpoint) {
+        coloredMarker = c(ansi.red, marker);
+      }
+      coloredNum = c(ansi.gray, num);
+      coloredContent = highlightLine(trimmed.text, lang);
+    }
+    result.push(`${coloredMarker} ${coloredNum}\u2502${coloredContent}`);
     if (line.isCurrent && trimmed.caretOffset !== undefined && trimmed.caretOffset >= 0) {
       const gutter = " ".repeat(numWidth + 4);
       const indent = trimmed.text.slice(0, trimmed.caretOffset).replace(/[^\t]/g, " ");
-      result.push(`${gutter}${indent}^`);
+      const caret = color ? c(ansi.brightYellow, "^") : "^";
+      result.push(`${gutter}${indent}${caret}`);
     }
   }
   return result.join(`
 `);
 }
-var init_source = () => {};
+var init_source = __esm(() => {
+  init_color();
+});
 
 // src/formatter/stack.ts
-function formatStack(frames) {
+function formatStack(frames, opts) {
+  const color = opts?.color ?? false;
   const outputLines = [];
   const segments = [];
   let i = 0;
@@ -11959,28 +12308,34 @@ function formatStack(frames) {
   for (const seg of segments) {
     if ("blackboxedCount" in seg) {
       const label = seg.blackboxedCount === 1 ? "\u250A ... 1 framework frame (blackboxed)" : `\u250A ... ${seg.blackboxedCount} framework frames (blackboxed)`;
-      outputLines.push(label);
+      outputLines.push(color ? c(ansi.gray, label) : label);
       continue;
     }
     const frame = seg;
     if (frame.isAsync) {
-      outputLines.push("\u250A async gap");
+      const gap = "\u250A async gap";
+      outputLines.push(color ? c(ansi.gray, gap) : gap);
     }
     const ref = frame.ref.padEnd(maxRefLen);
     const name = frame.functionName.padEnd(maxNameLen);
     const file2 = shortPath(frame.file);
     const loc = frame.column !== undefined ? `${file2}:${frame.line}:${frame.column}` : `${file2}:${frame.line}`;
-    outputLines.push(`${ref}  ${name}  ${loc}`);
+    if (color) {
+      outputLines.push(`${c(ansi.gray, ref)}  ${c(ansi.yellow, name)}  ${c(ansi.gray, loc)}`);
+    } else {
+      outputLines.push(`${ref}  ${name}  ${loc}`);
+    }
   }
   return outputLines.join(`
 `);
 }
 var init_stack = __esm(() => {
+  init_color();
   init_path();
 });
 
 // src/formatter/variables.ts
-function formatGroup(vars) {
+function formatGroup(vars, color) {
   if (vars.length === 0)
     return "";
   const maxRefLen = Math.max(...vars.map((v) => v.ref.length));
@@ -11988,13 +12343,17 @@ function formatGroup(vars) {
   return vars.map((v) => {
     const ref = v.ref.padEnd(maxRefLen);
     const name = v.name.padEnd(maxNameLen);
+    if (color) {
+      return `${c(ansi.gray, ref)}  ${c(ansi.cyan, name)}  ${v.value}`;
+    }
     return `${ref}  ${name}  ${v.value}`;
   }).join(`
 `);
 }
-function formatVariables(vars) {
+function formatVariables(vars, opts) {
   if (vars.length === 0)
     return "";
+  const color = opts?.color ?? false;
   const scopeOrder = [];
   const groups = new Map;
   for (const v of vars) {
@@ -12008,7 +12367,7 @@ function formatVariables(vars) {
     group.push(v);
   }
   if (scopeOrder.length === 1) {
-    return formatGroup(vars);
+    return formatGroup(vars, color);
   }
   const sections = [];
   for (const scope of scopeOrder) {
@@ -12016,8 +12375,9 @@ function formatVariables(vars) {
     if (!group || group.length === 0)
       continue;
     const label = SCOPE_LABELS[scope] ?? scope;
-    sections.push(`${label}:
-${formatGroup(group)}`);
+    const header = color ? c(ansi.bold, `${label}:`) : `${label}:`;
+    sections.push(`${header}
+${formatGroup(group, color)}`);
   }
   return sections.join(`
 
@@ -12025,6 +12385,7 @@ ${formatGroup(group)}`);
 }
 var SCOPE_LABELS;
 var init_variables = __esm(() => {
+  init_color();
   SCOPE_LABELS = {
     local: "Locals",
     module: "Module",
@@ -12039,7 +12400,8 @@ var init_variables = __esm(() => {
 });
 
 // src/commands/print-state.ts
-function printState(data) {
+function printState(data, opts) {
+  const color = opts?.color ?? false;
   if (data.status !== "paused") {
     const icon = data.status === "running" ? "\u25B6" : "\u25CB";
     const label = data.status === "running" ? "Running" : "Idle";
@@ -12047,27 +12409,43 @@ function printState(data) {
       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");
+      if (color) {
+        console.log(`${c(ansi.yellow, icon)} ${label} ${c(ansi.red, "(crashed)")}`);
+        console.log(`  ${c(ansi.red, firstLine)}`);
+        console.log(`  ${c(ansi.cyan, "-> Try:")} dbg exceptions`);
+      } else {
+        console.log(`${icon} ${label} (crashed)`);
+        console.log(`  ${firstLine}`);
+        console.log("  -> Try: dbg exceptions");
+      }
     } else {
-      console.log(`${icon} ${label}`);
+      if (color) {
+        const coloredIcon = data.status === "running" ? c(ansi.green, icon) : c(ansi.gray, icon);
+        console.log(`${coloredIcon} ${label}`);
+      } 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";
   const reason = data.reason ?? "unknown";
-  console.log(`\u23F8 Paused at ${loc} (${reason})`);
+  if (color) {
+    console.log(`${c(ansi.brightYellow, "\u23F8")} Paused at ${c(ansi.cyan, loc)} ${c(ansi.gray, `(${reason})`)}`);
+  } else {
+    console.log(`\u23F8 Paused at ${loc} (${reason})`);
+  }
+  const lang = data.location?.url ? detectLanguage(data.location.url) : "unknown";
   if (data.source?.lines) {
     console.log("");
-    console.log("Source:");
+    console.log(color ? c(ansi.bold, "Source:") : "Source:");
     const sourceLines = data.source.lines.map((l) => ({
       lineNumber: l.line,
       content: l.text,
       isCurrent: l.current,
       currentColumn: l.current ? data.location?.column : undefined
     }));
-    console.log(formatSource(sourceLines));
+    console.log(formatSource(sourceLines, { color, language: lang }));
   }
   if (data.vars) {
     console.log("");
@@ -12077,21 +12455,21 @@ function printState(data) {
       value: v.value,
       scope: v.scope
     }));
-    const formatted = formatVariables(vars);
+    const formatted = formatVariables(vars, { color });
     if (formatted) {
       const scopes = new Set(vars.map((v) => v.scope ?? "local"));
       if (scopes.size <= 1) {
-        console.log("Locals:");
+        console.log(color ? c(ansi.bold, "Locals:") : "Locals:");
       }
       console.log(formatted);
     } else {
-      console.log("Locals:");
+      console.log(color ? c(ansi.bold, "Locals:") : "Locals:");
       console.log("  (none)");
     }
   }
   if (data.stack) {
     console.log("");
-    console.log("Stack:");
+    console.log(color ? c(ansi.bold, "Stack:") : "Stack:");
     const frames = data.stack.map((f) => ({
       ref: f.ref,
       functionName: f.functionName,
@@ -12100,14 +12478,19 @@ function printState(data) {
       column: f.column,
       isAsync: f.isAsync
     }));
-    console.log(formatStack(frames));
+    console.log(formatStack(frames, { color }));
   }
   if (data.breakpointCount !== undefined) {
     console.log("");
-    console.log(`Breakpoints: ${data.breakpointCount} active`);
+    if (color) {
+      console.log(`Breakpoints: ${c(ansi.yellow, String(data.breakpointCount))} active`);
+    } else {
+      console.log(`Breakpoints: ${data.breakpointCount} active`);
+    }
   }
 }
 var init_print_state = __esm(() => {
+  init_color();
   init_path();
   init_source();
   init_stack();
@@ -12119,6 +12502,7 @@ var exports_state = {};
 var init_state = __esm(() => {
   init_registry();
   init_client3();
+  init_color();
   init_print_state();
   registerCommand("state", async (args) => {
     const session2 = args.global.session;
@@ -12164,7 +12548,7 @@ var init_state = __esm(() => {
       console.log(JSON.stringify(data, null, 2));
       return 0;
     }
-    printState(data);
+    printState(data, { color: shouldEnableColor(args.global.color) });
     return 0;
   });
 });
@@ -12174,6 +12558,7 @@ var exports_continue = {};
 var init_continue = __esm(() => {
   init_registry();
   init_client3();
+  init_color();
   init_print_state();
   registerCommand("continue", async (args) => {
     const session2 = args.global.session;
@@ -12194,7 +12579,7 @@ var init_continue = __esm(() => {
     if (args.global.json) {
       console.log(JSON.stringify(data, null, 2));
     } else {
-      printState(data);
+      printState(data, { color: shouldEnableColor(args.global.color) });
     }
     return 0;
   });
@@ -12205,6 +12590,7 @@ var exports_step = {};
 var init_step = __esm(() => {
   init_registry();
   init_client3();
+  init_color();
   init_print_state();
   registerCommand("step", async (args) => {
     const session2 = args.global.session;
@@ -12227,7 +12613,7 @@ var init_step = __esm(() => {
     if (args.global.json) {
       console.log(JSON.stringify(data, null, 2));
     } else {
-      printState(data);
+      printState(data, { color: shouldEnableColor(args.global.color) });
     }
     return 0;
   });
@@ -12238,6 +12624,7 @@ var exports_pause = {};
 var init_pause = __esm(() => {
   init_registry();
   init_client3();
+  init_color();
   init_print_state();
   registerCommand("pause", async (args) => {
     const session2 = args.global.session;
@@ -12258,7 +12645,7 @@ var init_pause = __esm(() => {
     if (args.global.json) {
       console.log(JSON.stringify(data, null, 2));
     } else {
-      printState(data);
+      printState(data, { color: shouldEnableColor(args.global.color) });
     }
     return 0;
   });
@@ -12304,6 +12691,7 @@ var exports_run_to = {};
 var init_run_to = __esm(() => {
   init_registry();
   init_client3();
+  init_color();
   init_print_state();
   registerCommand("run-to", async (args) => {
     const session2 = args.global.session;
@@ -12337,7 +12725,7 @@ var init_run_to = __esm(() => {
     if (args.global.json) {
       console.log(JSON.stringify(data, null, 2));
     } else {
-      printState(data);
+      printState(data, { color: shouldEnableColor(args.global.color) });
     }
     return 0;
   });
@@ -12348,6 +12736,7 @@ var exports_break = {};
 var init_break = __esm(() => {
   init_registry();
   init_client3();
+  init_color();
   init_path();
   registerCommand("break", async (args) => {
     const session2 = args.global.session;
@@ -12412,8 +12801,13 @@ var init_break = __esm(() => {
       if (args.global.json) {
         console.log(JSON.stringify(data2, null, 2));
       } else {
+        const color = shouldEnableColor(args.global.color);
         const loc = `${shortPath(data2.location.url)}:${data2.location.line}`;
-        console.log(`${data2.ref} set at ${loc} (log: ${logTemplate})`);
+        if (color) {
+          console.log(`${c(ansi.magenta, data2.ref)} set at ${c(ansi.cyan, loc)} (log: ${logTemplate})`);
+        } else {
+          console.log(`${data2.ref} set at ${loc} (log: ${logTemplate})`);
+        }
       }
       return 0;
     }
@@ -12438,15 +12832,27 @@ var init_break = __esm(() => {
     if (args.global.json) {
       console.log(JSON.stringify(data, null, 2));
     } else {
+      const color = shouldEnableColor(args.global.color);
       const loc = `${shortPath(data.location.url)}:${data.location.line}`;
-      let msg = `${data.ref} set at ${loc}`;
-      if (condition) {
-        msg += ` (condition: ${condition})`;
-      }
-      if (hitCount) {
-        msg += ` (hit-count: ${hitCount})`;
+      if (color) {
+        let msg = `${c(ansi.magenta, data.ref)} set at ${c(ansi.cyan, loc)}`;
+        if (condition) {
+          msg += ` ${c(ansi.gray, `(condition: ${condition})`)}`;
+        }
+        if (hitCount) {
+          msg += ` ${c(ansi.gray, `(hit-count: ${hitCount})`)}`;
+        }
+        console.log(msg);
+      } else {
+        let msg = `${data.ref} set at ${loc}`;
+        if (condition) {
+          msg += ` (condition: ${condition})`;
+        }
+        if (hitCount) {
+          msg += ` (hit-count: ${hitCount})`;
+        }
+        console.log(msg);
       }
-      console.log(msg);
     }
     if (shouldContinue) {
       const contResponse = await client.request("continue");
@@ -12544,6 +12950,7 @@ var exports_break_ls = {};
 var init_break_ls = __esm(() => {
   init_registry();
   init_client3();
+  init_color();
   init_path();
   registerCommand("break-ls", async (args) => {
     const session2 = args.global.session;
@@ -12564,22 +12971,37 @@ var init_break_ls = __esm(() => {
     if (args.global.json) {
       console.log(JSON.stringify(data, null, 2));
     } else {
+      const color = shouldEnableColor(args.global.color);
       if (data.length === 0) {
         console.log("No breakpoints or logpoints set");
       } else {
         for (const bp of data) {
           const loc = `${shortPath(bp.url)}:${bp.line}`;
-          let line = `${bp.ref} ${loc}`;
-          if (bp.type === "LP" && bp.template) {
-            line += ` (log: ${bp.template})`;
-          }
-          if (bp.condition) {
-            line += ` [condition: ${bp.condition}]`;
-          }
-          if (bp.hitCount) {
-            line += ` [hit-count: ${bp.hitCount}]`;
+          if (color) {
+            let line = `${c(ansi.magenta, bp.ref)} ${c(ansi.cyan, loc)}`;
+            if (bp.type === "LP" && bp.template) {
+              line += ` ${c(ansi.green, `(log: ${bp.template})`)}`;
+            }
+            if (bp.condition) {
+              line += ` ${c(ansi.gray, `[condition: ${bp.condition}]`)}`;
+            }
+            if (bp.hitCount) {
+              line += ` ${c(ansi.gray, `[hit-count: ${bp.hitCount}]`)}`;
+            }
+            console.log(line);
+          } else {
+            let line = `${bp.ref} ${loc}`;
+            if (bp.type === "LP" && bp.template) {
+              line += ` (log: ${bp.template})`;
+            }
+            if (bp.condition) {
+              line += ` [condition: ${bp.condition}]`;
+            }
+            if (bp.hitCount) {
+              line += ` [hit-count: ${bp.hitCount}]`;
+            }
+            console.log(line);
           }
-          console.log(line);
         }
       }
     }
@@ -12688,6 +13110,7 @@ var exports_source = {};
 var init_source2 = __esm(() => {
   init_registry();
   init_client3();
+  init_color();
   init_path();
   init_source();
   registerCommand("source", async (args) => {
@@ -12723,13 +13146,14 @@ var init_source2 = __esm(() => {
       console.log(JSON.stringify(data, null, 2));
       return 0;
     }
+    const color = shouldEnableColor(args.global.color);
     console.log(`Source: ${shortPath(data.url)}`);
     const sourceLines = data.lines.map((l) => ({
       lineNumber: l.line,
       content: l.text,
       isCurrent: l.current
     }));
-    console.log(formatSource(sourceLines));
+    console.log(formatSource(sourceLines, { color, language: detectLanguage(data.url) }));
     return 0;
   });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "debug-that",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Node.js Debugger CLI for AI Agents",
   "license": "MIT",
   "author": "Theodo Group",