agent-dbg 0.1.0 → 0.1.2

package/src/commands/exceptions.ts

@@ -15,7 +15,7 @@ registerCommand("exceptions", async (args) => {
 
 	if (!DaemonClient.isRunning(session)) {
 		console.error(`No active session "${session}"`);
-		console.error("  -> Try: ndbg launch --brk node app.js");
+		console.error("  -> Try: agent-dbg launch --brk node app.js");
 		return 1;
 	}
 

package/src/commands/hotpatch.ts

@@ -6,14 +6,14 @@ registerCommand("hotpatch", async (args) => {
 
 	if (!DaemonClient.isRunning(session)) {
 		console.error(`No active session "${session}"`);
-		console.error("  -> Try: ndbg launch --brk node app.js");
+		console.error("  -> Try: agent-dbg launch --brk node app.js");
 		return 1;
 	}
 
 	const file = args.subcommand;
 	if (!file) {
 		console.error("No file specified");
-		console.error("  -> Try: ndbg hotpatch app.js");
+		console.error("  -> Try: agent-dbg hotpatch app.js");
 		return 1;
 	}
 

package/src/commands/launch.ts

@@ -1,6 +1,7 @@
 import { registerCommand } from "../cli/registry.ts";
 import { DaemonClient } from "../daemon/client.ts";
 import { spawnDaemon } from "../daemon/spawn.ts";
+import { shortPath } from "../formatter/path.ts";
 
 registerCommand("launch", async (args) => {
 	const session = args.global.session;
@@ -12,26 +13,21 @@ registerCommand("launch", async (args) => {
 	// Reconstruct the full command from subcommand + positionals.
 	// The parser treats the second non-flag word as subcommand, but for launch
 	// it should be part of the command to execute.
-	// e.g., "ndbg launch node app.js" -> subcommand="node", positionals=["app.js"]
+	// e.g., "agent-dbg launch node app.js" -> subcommand="node", positionals=["app.js"]
 	// We need command = ["node", "app.js"]
 	const command = args.subcommand ? [args.subcommand, ...args.positionals] : [...args.positionals];
 
 	if (command.length === 0) {
 		console.error("No command specified");
-		console.error("  -> Try: ndbg launch --brk node app.js");
+		console.error("  -> Try: agent-dbg launch --brk node app.js");
 		return 1;
 	}
 
-	// Check if daemon already running for this session
-	if (DaemonClient.isRunning(session)) {
-		console.error(`Session "${session}" is already active`);
-		console.error(`  -> Try: ndbg stop --session ${session}`);
-		return 1;
+	// Spawn daemon if not already running (e.g. started externally for debugging)
+	if (!DaemonClient.isRunning(session)) {
+		await spawnDaemon(session, { timeout });
 	}
 
-	// Spawn daemon
-	await spawnDaemon(session, { timeout });
-
 	// Send launch command to daemon
 	const client = new DaemonClient(session);
 	const response = await client.request("launch", { command, brk, port });
@@ -57,7 +53,7 @@ registerCommand("launch", async (args) => {
 		if (data.paused && data.pauseInfo) {
 			const col = data.pauseInfo.column !== undefined ? `:${data.pauseInfo.column + 1}` : "";
 			const loc = data.pauseInfo.url
-				? `${data.pauseInfo.url}:${data.pauseInfo.line}${col}`
+				? `${shortPath(data.pauseInfo.url)}:${data.pauseInfo.line}${col}`
 				: "unknown";
 			console.log(`Paused at ${loc}`);
 		} else {

package/src/commands/logpoint.ts

@@ -1,19 +1,20 @@
 import { registerCommand } from "../cli/registry.ts";
 import { DaemonClient } from "../daemon/client.ts";
+import { shortPath } from "../formatter/path.ts";
 
 registerCommand("logpoint", async (args) => {
 	const session = args.global.session;
 
 	if (!DaemonClient.isRunning(session)) {
 		console.error(`No active session "${session}"`);
-		console.error("  -> Try: ndbg launch --brk node app.js");
+		console.error("  -> Try: agent-dbg launch --brk node app.js");
 		return 1;
 	}
 
 	const target = args.subcommand;
 	if (!target) {
 		console.error("No target specified");
-		console.error('  -> Try: ndbg logpoint src/app.ts:42 "x =", x');
+		console.error('  -> Try: agent-dbg logpoint src/app.ts:42 "x =", x');
 		return 1;
 	}
 
@@ -21,7 +22,7 @@ registerCommand("logpoint", async (args) => {
 	const lastColon = target.lastIndexOf(":");
 	if (lastColon === -1 || lastColon === 0) {
 		console.error(`Invalid logpoint target: "${target}"`);
-		console.error('  -> Try: ndbg logpoint src/app.ts:42 "x =", x');
+		console.error('  -> Try: agent-dbg logpoint src/app.ts:42 "x =", x');
 		return 1;
 	}
 
@@ -29,7 +30,7 @@ registerCommand("logpoint", async (args) => {
 	const line = parseInt(target.slice(lastColon + 1), 10);
 	if (Number.isNaN(line) || line <= 0) {
 		console.error(`Invalid line number in "${target}"`);
-		console.error('  -> Try: ndbg logpoint src/app.ts:42 "x =", x');
+		console.error('  -> Try: agent-dbg logpoint src/app.ts:42 "x =", x');
 		return 1;
 	}
 
@@ -37,7 +38,7 @@ registerCommand("logpoint", async (args) => {
 	const template = args.positionals[0];
 	if (!template) {
 		console.error("No log template specified");
-		console.error('  -> Try: ndbg logpoint src/app.ts:42 "x =", x');
+		console.error('  -> Try: agent-dbg logpoint src/app.ts:42 "x =", x');
 		return 1;
 	}
 
@@ -70,7 +71,7 @@ registerCommand("logpoint", async (args) => {
 	if (args.global.json) {
 		console.log(JSON.stringify(data, null, 2));
 	} else {
-		const loc = `${data.location.url}:${data.location.line}`;
+		const loc = `${shortPath(data.location.url)}:${data.location.line}`;
 		console.log(`${data.ref} set at ${loc} (log: ${template})`);
 	}
 

package/src/commands/logs.ts

@@ -0,0 +1,116 @@
+import type { FSWatcher } from "node:fs";
+import {
+	closeSync,
+	existsSync,
+	openSync,
+	readFileSync,
+	readSync,
+	watch,
+	writeFileSync,
+} from "node:fs";
+import type { CdpLogEntry } from "../cdp/logger.ts";
+import { registerCommand } from "../cli/registry.ts";
+import { getLogPath } from "../daemon/paths.ts";
+import { formatLogEntry } from "../formatter/logs.ts";
+
+function parseEntries(text: string): CdpLogEntry[] {
+	const entries: CdpLogEntry[] = [];
+	for (const line of text.split("\n")) {
+		if (!line.trim()) continue;
+		try {
+			entries.push(JSON.parse(line) as CdpLogEntry);
+		} catch {
+			// skip malformed lines
+		}
+	}
+	return entries;
+}
+
+function filterByDomain(entries: CdpLogEntry[], domain: string): CdpLogEntry[] {
+	return entries.filter((e) => e.method.startsWith(`${domain}.`));
+}
+
+function printEntries(entries: CdpLogEntry[], json: boolean): void {
+	for (const entry of entries) {
+		if (json) {
+			console.log(JSON.stringify(entry));
+		} else {
+			console.log(formatLogEntry(entry));
+		}
+	}
+}
+
+registerCommand("logs", async (args) => {
+	const session = args.global.session;
+	const logPath = getLogPath(session);
+
+	// --clear: truncate log file
+	if (args.flags.clear === true) {
+		if (existsSync(logPath)) {
+			writeFileSync(logPath, "");
+			console.log("Log cleared");
+		} else {
+			console.log("No log file to clear");
+		}
+		return 0;
+	}
+
+	if (!existsSync(logPath)) {
+		console.error(`No log file for session "${session}"`);
+		console.error("  -> Try: agent-dbg launch --brk node app.js");
+		return 1;
+	}
+
+	const isJson = args.global.json;
+	const domain = typeof args.flags.domain === "string" ? args.flags.domain : undefined;
+	const limit = typeof args.flags.limit === "string" ? parseInt(args.flags.limit, 10) : 50;
+	const follow = args.flags.follow === true;
+
+	// Read existing entries
+	const content = readFileSync(logPath, "utf-8");
+	let entries = parseEntries(content);
+	if (domain) entries = filterByDomain(entries, domain);
+
+	// Apply limit (show last N) — in follow mode, show all existing
+	const sliced = follow ? entries : entries.slice(-limit);
+	printEntries(sliced, isJson);
+
+	if (!follow) return 0;
+
+	// Follow mode: watch for new lines appended to the file
+	let offset = Buffer.byteLength(content, "utf-8");
+	let watcher: FSWatcher | undefined;
+
+	const readNew = () => {
+		try {
+			const size = Bun.file(logPath).size;
+			if (size <= offset) return;
+
+			const fd = openSync(logPath, "r");
+			const buf = Buffer.alloc(size - offset);
+			readSync(fd, buf, 0, buf.length, offset);
+			closeSync(fd);
+			offset = size;
+
+			let newEntries = parseEntries(buf.toString("utf-8"));
+			if (domain) newEntries = filterByDomain(newEntries, domain);
+			printEntries(newEntries, isJson);
+		} catch {
+			// File may have been truncated or removed
+		}
+	};
+
+	watcher = watch(logPath, () => {
+		readNew();
+	});
+
+	// Keep alive until Ctrl+C
+	await new Promise<void>((resolve) => {
+		process.on("SIGINT", () => {
+			watcher?.close();
+			resolve();
+		});
+	});
+
+	return 0;
+});

package/src/commands/pause.ts

@@ -1,13 +1,14 @@
 import { registerCommand } from "../cli/registry.ts";
 import { DaemonClient } from "../daemon/client.ts";
-import type { SessionStatus } from "../daemon/session.ts";
+import type { StateSnapshot } from "../daemon/session.ts";
+import { printState } from "./print-state.ts";
 
 registerCommand("pause", async (args) => {
 	const session = args.global.session;
 
 	if (!DaemonClient.isRunning(session)) {
 		console.error(`No active session "${session}"`);
-		console.error("  -> Try: ndbg launch --brk node app.js");
+		console.error("  -> Try: agent-dbg launch --brk node app.js");
 		return 1;
 	}
 
@@ -20,27 +21,13 @@ registerCommand("pause", async (args) => {
 		return 1;
 	}
 
-	const data = response.data as SessionStatus;
+	const data = response.data as StateSnapshot;
 
 	if (args.global.json) {
 		console.log(JSON.stringify(data, null, 2));
 	} else {
-		printStatus(data);
+		printState(data);
 	}
 
 	return 0;
 });
-
-function printStatus(data: SessionStatus): void {
-	if (data.state === "paused" && data.pauseInfo) {
-		const col = data.pauseInfo.column !== undefined ? `:${data.pauseInfo.column + 1}` : "";
-		const loc = data.pauseInfo.url
-			? `${data.pauseInfo.url}:${(data.pauseInfo.line ?? 0) + 1}${col}`
-			: "unknown";
-		console.log(`Paused at ${loc} (${data.pauseInfo.reason})`);
-	} else if (data.state === "running") {
-		console.log("Running");
-	} else {
-		console.log(`${data.state}`);
-	}
-}

package/src/commands/print-state.ts

@@ -0,0 +1,85 @@
+import type { StateSnapshot } from "../daemon/session.ts";
+import { shortPath } from "../formatter/path.ts";
+import type { SourceLine } from "../formatter/source.ts";
+import { formatSource } from "../formatter/source.ts";
+import type { StackFrame } from "../formatter/stack.ts";
+import { formatStack } from "../formatter/stack.ts";
+import type { Variable } from "../formatter/variables.ts";
+import { formatVariables } from "../formatter/variables.ts";
+
+/**
+ * Shared formatting for StateSnapshot output.
+ * Used by state, step, continue, pause, run-to commands.
+ */
+export function printState(data: StateSnapshot): void {
+	// Non-paused states
+	if (data.status !== "paused") {
+		const icon = data.status === "running" ? "\u25B6" : "\u25CB";
+		console.log(`${icon} ${data.status === "running" ? "Running" : "Idle"}`);
+		return;
+	}
+
+	// Paused state — header
+	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})`);
+
+	// Source section
+	if (data.source?.lines) {
+		console.log("");
+		console.log("Source:");
+		const sourceLines: SourceLine[] = 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));
+	}
+
+	// Variables section
+	if (data.vars) {
+		console.log("");
+		const vars: Variable[] = data.vars.map((v) => ({
+			ref: v.ref,
+			name: v.name,
+			value: v.value,
+			scope: v.scope,
+		}));
+		const formatted = formatVariables(vars);
+		if (formatted) {
+			// Single scope: simple header; multi-scope: grouped headers from formatter
+			const scopes = new Set(vars.map((v) => v.scope ?? "local"));
+			if (scopes.size <= 1) {
+				console.log("Locals:");
+			}
+			console.log(formatted);
+		} else {
+			console.log("Locals:");
+			console.log("  (none)");
+		}
+	}
+
+	// Stack section
+	if (data.stack) {
+		console.log("");
+		console.log("Stack:");
+		const frames: StackFrame[] = data.stack.map((f) => ({
+			ref: f.ref,
+			functionName: f.functionName,
+			file: f.file,
+			line: f.line,
+			column: f.column,
+			isAsync: f.isAsync,
+		}));
+		console.log(formatStack(frames));
+	}
+
+	// Breakpoints section
+	if (data.breakpointCount !== undefined) {
+		console.log("");
+		console.log(`Breakpoints: ${data.breakpointCount} active`);
+	}
+}

package/src/commands/props.ts

@@ -6,14 +6,14 @@ registerCommand("props", async (args) => {
 
 	if (!DaemonClient.isRunning(session)) {
 		console.error(`No active session "${session}"`);
-		console.error("  -> Try: ndbg launch --brk node app.js");
+		console.error("  -> Try: agent-dbg launch --brk node app.js");
 		return 1;
 	}
 
 	const ref = args.subcommand;
 	if (!ref) {
 		console.error("No ref specified");
-		console.error("  -> Try: ndbg props @v1");
+		console.error("  -> Try: agent-dbg props @v1");
 		return 1;
 	}
 

package/src/commands/restart-frame.ts

@@ -7,7 +7,7 @@ registerCommand("restart-frame", async (args) => {
 
 	if (!DaemonClient.isRunning(session)) {
 		console.error(`No active session "${session}"`);
-		console.error("  -> Try: ndbg launch --brk node app.js");
+		console.error("  -> Try: agent-dbg launch --brk node app.js");
 		return 1;
 	}
 

package/src/commands/restart.ts

@@ -0,0 +1,42 @@
+import { registerCommand } from "../cli/registry.ts";
+import { DaemonClient } from "../daemon/client.ts";
+import type { LaunchResult } from "../daemon/session.ts";
+import { shortPath } from "../formatter/path.ts";
+
+registerCommand("restart", async (args) => {
+	const session = args.global.session;
+
+	if (!DaemonClient.isRunning(session)) {
+		console.error(`No active session "${session}"`);
+		console.error("  -> Try: agent-dbg launch --brk node app.js");
+		return 1;
+	}
+
+	const client = new DaemonClient(session);
+	const response = await client.request("restart");
+
+	if (!response.ok) {
+		console.error(`${response.error}`);
+		if (response.suggestion) console.error(`  ${response.suggestion}`);
+		return 1;
+	}
+
+	const data = response.data as LaunchResult;
+
+	if (args.global.json) {
+		console.log(JSON.stringify(data, null, 2));
+	} else {
+		console.log(`Session "${session}" restarted (pid ${data.pid})`);
+		if (data.paused && data.pauseInfo) {
+			const col = data.pauseInfo.column !== undefined ? `:${data.pauseInfo.column + 1}` : "";
+			const loc = data.pauseInfo.url
+				? `${shortPath(data.pauseInfo.url)}:${data.pauseInfo.line}${col}`
+				: "unknown";
+			console.log(`Paused at ${loc}`);
+		} else {
+			console.log("Running");
+		}
+	}
+
+	return 0;
+});

package/src/commands/run-to.ts

@@ -1,22 +1,23 @@
 import { registerCommand } from "../cli/registry.ts";
 import { DaemonClient } from "../daemon/client.ts";
-import type { SessionStatus } from "../daemon/session.ts";
+import type { StateSnapshot } from "../daemon/session.ts";
+import { printState } from "./print-state.ts";
 
 registerCommand("run-to", async (args) => {
 	const session = args.global.session;
 
 	if (!DaemonClient.isRunning(session)) {
 		console.error(`No active session "${session}"`);
-		console.error("  -> Try: ndbg launch --brk node app.js");
+		console.error("  -> Try: agent-dbg launch --brk node app.js");
 		return 1;
 	}
 
 	// Parse file:line from subcommand
-	// e.g., "ndbg run-to src/file.ts:42" -> subcommand = "src/file.ts:42"
+	// e.g., "agent-dbg run-to src/file.ts:42" -> subcommand = "src/file.ts:42"
 	const target = args.subcommand ?? args.positionals[0];
 	if (!target) {
 		console.error("No target specified");
-		console.error("  -> Try: ndbg run-to src/file.ts:42");
+		console.error("  -> Try: agent-dbg run-to src/file.ts:42");
 		return 1;
 	}
 
@@ -44,27 +45,13 @@ registerCommand("run-to", async (args) => {
 		return 1;
 	}
 
-	const data = response.data as SessionStatus;
+	const data = response.data as StateSnapshot;
 
 	if (args.global.json) {
 		console.log(JSON.stringify(data, null, 2));
 	} else {
-		printStatus(data);
+		printState(data);
 	}
 
 	return 0;
 });
-
-function printStatus(data: SessionStatus): void {
-	if (data.state === "paused" && data.pauseInfo) {
-		const col = data.pauseInfo.column !== undefined ? `:${data.pauseInfo.column + 1}` : "";
-		const loc = data.pauseInfo.url
-			? `${data.pauseInfo.url}:${(data.pauseInfo.line ?? 0) + 1}${col}`
-			: "unknown";
-		console.log(`Paused at ${loc} (${data.pauseInfo.reason})`);
-	} else if (data.state === "running") {
-		console.log("Running");
-	} else {
-		console.log(`${data.state}`);
-	}
-}

package/src/commands/scripts.ts

@@ -6,7 +6,7 @@ registerCommand("scripts", async (args) => {
 
 	if (!DaemonClient.isRunning(session)) {
 		console.error(`No active session "${session}"`);
-		console.error("  -> Try: ndbg launch --brk node app.js");
+		console.error("  -> Try: agent-dbg launch --brk node app.js");
 		return 1;
 	}
 

package/src/commands/search.ts

@@ -1,12 +1,13 @@
 import { registerCommand } from "../cli/registry.ts";
 import { DaemonClient } from "../daemon/client.ts";
+import { shortPath } from "../formatter/path.ts";
 
 registerCommand("search", async (args) => {
 	const session = args.global.session;
 
 	if (!DaemonClient.isRunning(session)) {
 		console.error(`No active session "${session}"`);
-		console.error("  -> Try: ndbg launch --brk node app.js");
+		console.error("  -> Try: agent-dbg launch --brk node app.js");
 		return 1;
 	}
 
@@ -22,7 +23,7 @@ registerCommand("search", async (args) => {
 
 	if (!query) {
 		console.error("No search query specified");
-		console.error("  -> Try: ndbg search <query> [--regex] [--case-sensitive]");
+		console.error("  -> Try: agent-dbg search <query> [--regex] [--case-sensitive]");
 		return 1;
 	}
 
@@ -66,7 +67,7 @@ registerCommand("search", async (args) => {
 	}
 
 	for (const match of data) {
-		console.log(`${match.url}:${match.line}: ${match.content}`);
+		console.log(`${shortPath(match.url)}:${match.line}: ${match.content}`);
 	}
 
 	return 0;

package/src/commands/set-return.ts

@@ -6,7 +6,7 @@ registerCommand("set-return", async (args) => {
 
 	if (!DaemonClient.isRunning(session)) {
 		console.error(`No active session "${session}"`);
-		console.error("  -> Try: ndbg launch --brk node app.js");
+		console.error("  -> Try: agent-dbg launch --brk node app.js");
 		return 1;
 	}
 
@@ -20,7 +20,7 @@ registerCommand("set-return", async (args) => {
 
 	if (!value) {
 		console.error("No value specified");
-		console.error("  -> Try: ndbg set-return 42");
+		console.error("  -> Try: agent-dbg set-return 42");
 		return 1;
 	}
 

package/src/commands/set.ts

@@ -6,21 +6,21 @@ registerCommand("set", async (args) => {
 
 	if (!DaemonClient.isRunning(session)) {
 		console.error(`No active session "${session}"`);
-		console.error("  -> Try: ndbg launch --brk node app.js");
+		console.error("  -> Try: agent-dbg launch --brk node app.js");
 		return 1;
 	}
 
 	const varName = args.subcommand;
 	if (!varName) {
 		console.error("No variable name specified");
-		console.error("  -> Try: ndbg set counter 42");
+		console.error("  -> Try: agent-dbg set counter 42");
 		return 1;
 	}
 
 	const valueParts = args.positionals;
 	if (valueParts.length === 0) {
 		console.error("No value specified");
-		console.error("  -> Try: ndbg set counter 42");
+		console.error("  -> Try: agent-dbg set counter 42");
 		return 1;
 	}
 	const value = valueParts.join(" ");

package/src/commands/source.ts

@@ -1,5 +1,6 @@
 import { registerCommand } from "../cli/registry.ts";
 import { DaemonClient } from "../daemon/client.ts";
+import { shortPath } from "../formatter/path.ts";
 import type { SourceLine } from "../formatter/source.ts";
 import { formatSource } from "../formatter/source.ts";
 
@@ -8,7 +9,7 @@ registerCommand("source", async (args) => {
 
 	if (!DaemonClient.isRunning(session)) {
 		console.error(`No active session "${session}"`);
-		console.error("  -> Try: ndbg launch --brk node app.js");
+		console.error("  -> Try: agent-dbg launch --brk node app.js");
 		return 1;
 	}
 
@@ -47,7 +48,7 @@ registerCommand("source", async (args) => {
 		return 0;
 	}
 
-	console.log(`Source: ${data.url}`);
+	console.log(`Source: ${shortPath(data.url)}`);
 	const sourceLines: SourceLine[] = data.lines.map((l) => ({
 		lineNumber: l.line,
 		content: l.text,

package/src/commands/sourcemap.ts

@@ -6,7 +6,7 @@ registerCommand("sourcemap", async (args) => {
 
 	if (!DaemonClient.isRunning(session)) {
 		console.error(`No active session "${session}"`);
-		console.error("  -> Try: ndbg launch --brk node app.js");
+		console.error("  -> Try: agent-dbg launch --brk node app.js");
 		return 1;
 	}
 

package/src/commands/stack.ts

@@ -8,7 +8,7 @@ registerCommand("stack", async (args) => {
 
 	if (!DaemonClient.isRunning(session)) {
 		console.error(`No active session "${session}"`);
-		console.error("  -> Try: ndbg launch --brk node app.js");
+		console.error("  -> Try: agent-dbg launch --brk node app.js");
 		return 1;
 	}