@unbound-app/debugger 0.1.4 → 1.0.1

package/TODO.md

@@ -0,0 +1,2 @@
+- Add this as an installable global binary.
+- .help, .clearhistory, etc.

package/package.json

@@ -1,34 +1,21 @@
 {
 	"name": "@unbound-app/debugger",
-	"version": "0.1.4",
-	"description": "A REPL debugger for @unbound-app/client runtime instances.",
-	"author": {
-		"name": "Mario P.",
-		"email": "contact@marioparaschiv.com",
-		"url": "https://github.com/marioparaschiv"
-	},
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/marioparaschiv/unbound.git",
-		"directory": "packages/debugger"
-	},
+	"description": "A REPL debugger for @unbound-app instances.",
+	"version": "1.0.1",
+	"module": "src/index.ts",
+	"type": "module",
 	"bin": {
-		"ub-debugger": "dist/index.mjs"
+		"ub-debugger": "src/index.ts"
 	},
-	"files": [
-		"dist"
-	],
-	"type": "module",
-	"module": "./dist/index.mjs",
-	"scripts": {
-		"build": "tsdown"
+	"devDependencies": {
+		"@types/bun": "latest",
+		"@types/terminal-kit": "^2.5.7"
+	},
+	"peerDependencies": {
+		"typescript": "^5"
 	},
 	"dependencies": {
-		"@unbound-app/debugger-protocol": "0.1.3",
 		"cleye": "^1.3.4",
 		"terminal-kit": "^3.1.2"
-	},
-	"peerDependencies": {
-		"typescript": "^5.9.3"
 	}
-}
+}

package/src/index.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env bun
+import { loadHistory } from './lib/history';
+import { setupWebSocket } from './lib/ws';
+
+
+await loadHistory();
+await setupWebSocket();

package/src/lib/cli.ts

@@ -0,0 +1,15 @@
+import { cli } from 'cleye';
+
+
+const argv = cli({
+	name: 'ub-debugger',
+	flags: {
+		port: {
+			type: Number,
+			description: 'The port number to host the debugger on.',
+			default: 9090
+		}
+	}
+});
+
+export default argv;

package/src/lib/history.ts

@@ -0,0 +1,29 @@
+import { terminal } from 'terminal-kit';
+import { join } from 'node:path';
+
+
+type History = string[];
+
+const HISTORY_PATH = join(__dirname, '..', '..', '.history.json');
+const HISTORY_FILE = Bun.file(HISTORY_PATH);
+
+export let history: History = [];
+
+export async function loadHistory() {
+	try {
+		if (await HISTORY_FILE.exists()) {
+			history = await HISTORY_FILE.json();
+		}
+	} catch (error) {
+		terminal.red.bold(`Failed to load history.\n`);
+	}
+}
+
+export function addHistoryItem(item: string) {
+	history.push(item);
+	persistHistory();
+}
+
+export function persistHistory() {
+	HISTORY_FILE.write(JSON.stringify(history, null, 2));
+}

package/src/lib/repl.ts

@@ -0,0 +1,47 @@
+import { terminal } from 'terminal-kit';
+
+import { addHistoryItem, history } from './history';
+import { send } from './ws';
+
+
+export const state: {
+	repl: ReturnType<typeof terminal.inputField> | null;
+} = {
+	repl: null
+};
+
+export function setupReplListeners() {
+	terminal.on('key', (name: string) => {
+		if (name !== 'CTRL_C') return;
+		process.exit(0);
+	});
+}
+
+export async function takeReplInput() {
+	abortCurrentReplInput();
+
+	terminal.bold.cyan('» ');
+
+	state.repl = terminal.inputField({
+		minLength: 1,
+		history
+	}, (error, input) => {
+		if (error) return console.error(error);
+		if (!input) return;
+
+		abortCurrentReplInput(true);
+		terminal.white.bold(`» ${input}\n`);
+		addHistoryItem(input);
+		send(input);
+
+		takeReplInput();
+	});
+}
+
+export function abortCurrentReplInput(shouldDeletePrompt: boolean = false) {
+	if (state.repl) {
+		state.repl.abort();
+		state.repl = null;
+		if (shouldDeletePrompt) terminal.deleteLine(-1);
+	}
+}

package/src/lib/ws.ts

@@ -0,0 +1,97 @@
+import { terminal } from 'terminal-kit';
+import os from 'node:os';
+
+import { abortCurrentReplInput, setupReplListeners, takeReplInput } from './repl';
+import argv from './cli';
+
+
+interface SocketMessage {
+	level: 1 | 2 | 3;
+	message: string;
+}
+
+export const state: {
+	isInitialized: boolean,
+	socket: Bun.ServerWebSocket | null;
+} = {
+	isInitialized: false,
+	socket: null
+};
+
+export const MESSAGE_LEVELS = {
+	1: terminal.gray,
+	2: terminal.yellow,
+	3: terminal.red
+};
+
+export function setupWebSocket() {
+	if (state.isInitialized) return;
+
+	Bun.serve({
+		port: argv.flags.port,
+		fetch(request, server) {
+			if (state.socket) {
+				return new Response(
+					JSON.stringify({ error: 'Debugger is busy.' }),
+					{ status: 503 }
+				);
+			}
+
+			server.upgrade(request);
+		},
+		websocket: {
+			open(ws) {
+				state.socket = ws;
+				terminal.bold.green('Client connected.\n');
+
+				setupReplListeners();
+				takeReplInput();
+			},
+			message(_, message: string) {
+				try {
+					const payload: SocketMessage = JSON.parse(message);
+					abortCurrentReplInput(true);
+
+					MESSAGE_LEVELS[payload.level](`« ${payload.message}\n`);
+
+					takeReplInput();
+				} catch (error) {
+					terminal.red(`Parsing failed on message from client.\n`);
+				}
+			},
+			close() {
+				state.socket = null;
+				abortCurrentReplInput(true);
+				terminal.red('Client disconnected.\n');
+			}
+		}
+	});
+
+	const localAddress = getLocalAddress();
+
+	terminal.gray(`Unbound's Debugger is now active. Connect using ${localAddress}:${argv.flags.port}\n`);
+}
+
+export function getLocalAddress() {
+	const interfaces = os.networkInterfaces();
+
+	for (const ifaces of Object.values(interfaces)) {
+		if (!ifaces) continue;
+
+		for (const iface of ifaces) {
+			// Skip over internal (i.e., 127.0.0.1) and non-IPv4 addresses
+			if (iface.family === 'IPv4' && !iface.internal) {
+				return iface.address;
+			}
+		}
+	}
+};
+
+
+export function send(...payload: Parameters<Bun.ServerWebSocket['send']>) {
+	if (!state.socket) {
+		return terminal.bold.red('You cannot send messages without a connected client.\n');
+	}
+
+	state.socket.send(...payload);
+}

package/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}

package/dist/index.d.mts

@@ -1 +0,0 @@
-export {}

package/dist/index.mjs

@@ -1,550 +0,0 @@
-#!/usr/bin/env bun
-import { stripEscapeSequences, terminal } from "terminal-kit";
-import { join } from "node:path";
-import { parseMessage } from "@unbound-app/debugger-protocol";
-import os from "node:os";
-import { cli } from "cleye";
-//#region src/lib/history.ts
-const HISTORY_PATH = join(__dirname, "..", "..", ".history.json");
-const HISTORY_FILE = Bun.file(HISTORY_PATH);
-let history = [];
-async function loadHistory() {
-	try {
-		if (await HISTORY_FILE.exists()) history = await HISTORY_FILE.json();
-	} catch (error) {
-		terminal.red.bold(`Failed to load history.\n`);
-	}
-}
-function addHistoryItem(item) {
-	history.push(item);
-	persistHistory();
-}
-function persistHistory() {
-	HISTORY_FILE.write(JSON.stringify(history, null, 2));
-}
-//#endregion
-//#region src/lib/session.ts
-const state$2 = {
-	device: null,
-	controllers: /* @__PURE__ */ new Set()
-};
-const pending = /* @__PURE__ */ new Map();
-const logListeners = /* @__PURE__ */ new Set();
-const deviceListeners = /* @__PURE__ */ new Set();
-const evalListeners = /* @__PURE__ */ new Set();
-const resultListeners = /* @__PURE__ */ new Set();
-const controllerListeners = /* @__PURE__ */ new Set();
-/** How long to wait for a device to answer an eval before failing it. */
-const EVAL_TIMEOUT_MS = 1e4;
-/**
-* @description Registers the connected device, rejecting a second one so eval routing stays
-* unambiguous.
-* @param socket The device's socket.
-* @returns Whether the device was accepted (false if one is already connected).
-*/
-function attachDevice(socket) {
-	if (state$2.device) return false;
-	state$2.device = socket;
-	broadcastDeviceStatus(true);
-	return true;
-}
-/**
-* @description Clears the device on disconnect, notifies controllers, and fails every in-flight eval
-* so no caller waits forever. Twin of {@link attachDevice}.
-* @param socket The socket that closed; ignored if it isn't the current device.
-*/
-function detachDevice(socket) {
-	if (state$2.device !== socket) return;
-	state$2.device = null;
-	for (const [id, entry] of pending) {
-		clearTimeout(entry.timer);
-		entry.deliver({
-			type: "eval-result",
-			id,
-			ok: false,
-			error: "Device disconnected before the evaluation completed."
-		});
-		pending.delete(id);
-	}
-	broadcastDeviceStatus(false);
-}
-/** @description Adds a controller and immediately reports current device presence to it. */
-function attachController(socket) {
-	state$2.controllers.add(socket);
-	sendDeviceStatus(socket, Boolean(state$2.device));
-	for (const listener of controllerListeners) listener(true, state$2.controllers.size);
-}
-/**
-* @description Removes a controller and fails any of its in-flight evals. Twin of
-* {@link attachController}.
-* @param socket The controller that closed.
-*/
-function detachController(socket) {
-	state$2.controllers.delete(socket);
-	for (const [id, entry] of pending) {
-		if (entry.deliver !== controllerDelivery.get(socket)) continue;
-		clearTimeout(entry.timer);
-		pending.delete(id);
-	}
-	controllerDelivery.delete(socket);
-	for (const listener of controllerListeners) listener(false, state$2.controllers.size);
-}
-/**
-* @description Runs code on the device on behalf of a controller socket, delivering the id-correlated
-* result back over that same socket. Sends an error frame instead if no device is connected.
-* @param socket The controller that issued the request.
-* @param id The controller-chosen correlation id, echoed on the result.
-* @param code The JavaScript to evaluate on the device.
-*/
-function evaluateForController(socket, id, code) {
-	const deliver = getControllerDelivery(socket);
-	for (const listener of evalListeners) listener(code);
-	dispatch(id, code, (result) => {
-		for (const listener of resultListeners) listener(result);
-		deliver(result);
-	});
-}
-/**
-* @description Runs code on the device on behalf of an in-process caller (the terminal REPL),
-* resolving with the device's answer. Rejects if no device is connected or it doesn't answer within
-* {@link EVAL_TIMEOUT_MS}.
-* @param code The JavaScript to evaluate on the device.
-* @returns The device's {@link EvalResult}.
-*/
-function evaluate(code) {
-	return new Promise((resolve) => {
-		dispatch(crypto.randomUUID(), code, resolve);
-	});
-}
-function dispatch(id, code, deliver) {
-	if (!state$2.device) {
-		deliver({
-			type: "eval-result",
-			id,
-			ok: false,
-			error: "No device is connected to the debugger."
-		});
-		return;
-	}
-	const timer = setTimeout(() => {
-		pending.delete(id);
-		deliver({
-			type: "eval-result",
-			id,
-			ok: false,
-			error: `Evaluation timed out after ${EVAL_TIMEOUT_MS}ms.`
-		});
-	}, EVAL_TIMEOUT_MS);
-	pending.set(id, {
-		deliver,
-		timer
-	});
-	state$2.device.send(JSON.stringify({
-		type: "eval",
-		id,
-		code
-	}));
-}
-/**
-* @description Routes a single parsed frame arriving from the device: an eval result settles its
-* pending request, a log line fans out to controllers and local listeners.
-* @param message The framed message received from the device.
-*/
-function handleDeviceMessage$1(message) {
-	if (message.type === "eval-result") {
-		const entry = pending.get(message.id);
-		if (!entry) return;
-		clearTimeout(entry.timer);
-		pending.delete(message.id);
-		entry.deliver(message);
-		return;
-	}
-	if (message.type === "log") {
-		for (const socket of state$2.controllers) socket.send(JSON.stringify(message));
-		for (const listener of logListeners) listener(message);
-	}
-}
-/** @description Subscribes to device log lines; returns an unsubscribe function. */
-function onLog(listener) {
-	logListeners.add(listener);
-	return () => void logListeners.delete(listener);
-}
-/** @description Subscribes to code a controller (e.g. the MCP) sends to evaluate; returns an unsubscribe function. */
-function onControllerEval(listener) {
-	evalListeners.add(listener);
-	return () => void evalListeners.delete(listener);
-}
-/** @description Subscribes to the results of controller evals; returns an unsubscribe function. */
-function onControllerResult(listener) {
-	resultListeners.add(listener);
-	return () => void resultListeners.delete(listener);
-}
-/**
-* @description Subscribes to controller (MCP) connect/disconnect transitions, with the resulting
-* controller count; returns an unsubscribe function.
-*/
-function onController(listener) {
-	controllerListeners.add(listener);
-	return () => void controllerListeners.delete(listener);
-}
-const controllerDelivery = /* @__PURE__ */ new Map();
-function getControllerDelivery(socket) {
-	let deliver = controllerDelivery.get(socket);
-	if (deliver) return deliver;
-	deliver = (result) => socket.send(JSON.stringify(result));
-	controllerDelivery.set(socket, deliver);
-	return deliver;
-}
-function sendDeviceStatus(socket, connected) {
-	socket.send(JSON.stringify({
-		type: "device-status",
-		connected
-	}));
-}
-function broadcastDeviceStatus(connected) {
-	for (const socket of state$2.controllers) sendDeviceStatus(socket, connected);
-	for (const listener of deviceListeners) listener(connected);
-}
-//#endregion
-//#region src/lib/repl.ts
-const state$1 = {
-	repl: null,
-	currentInput: ""
-};
-function setupReplListeners() {
-	terminal.on("key", (name, ...t) => {
-		if (name !== "CTRL_C") return;
-		process.exit(0);
-	});
-}
-async function takeReplInput() {
-	abortCurrentReplInput();
-	terminal.bold.cyan("» ");
-	state$1.repl = terminal.inputField({
-		minLength: 1,
-		history
-	}, (error, input) => {
-		if (error) return console.error(error);
-		if (!input) return;
-		state$1.currentInput = input;
-		abortCurrentReplInput({ deletePrompt: true });
-		terminal.white.bold(`» ${input}\n`);
-		addHistoryItem(input);
-		evaluate(input).then((result) => {
-			if (result.ok) terminal.gray(`« ${result.value}\n`);
-			else terminal.red(`« ${result.error}\n`);
-			takeReplInput();
-		});
-	});
-	await state$1.repl.promise;
-}
-function abortCurrentReplInput({ deletePrompt = false, deleteCurrentInput = false } = {}) {
-	if (state$1.repl) {
-		state$1.repl.abort();
-		state$1.repl = null;
-		if (deletePrompt) terminal.deleteLine(-1);
-		if (deleteCurrentInput) state$1.currentInput = "";
-	}
-}
-//#endregion
-//#region src/lib/format-log.ts
-/**
-* Reformats a log line as Hermes hands it to `nativeLoggingHook`. Hermes inspects each `console.*`
-* argument and joins them with `, ` — quoting string args (`'a', 'b', { x: 1 }`). That reads badly
-* in the debugger terminal, so we split on the top-level commas Hermes inserted, unquote the plain
-* string segments, and rejoin with spaces — leaving inspected objects/arrays untouched.
-*
-* This is best-effort: it only rewrites what parses cleanly as Hermes's join format. A segment it
-* can't confidently classify is left exactly as received, so worst case a line is unchanged, never
-* mangled.
-*/
-/**
-* @description Cleans a Hermes-joined console line into space-separated, unquoted output.
-* @param message The raw `nativeLoggingHook` message string.
-* @returns The reformatted line, or the original if it doesn't look like a Hermes join.
-*/
-function formatLog(message) {
-	const segments = splitTopLevel(message);
-	const line = segments ? segments.map(unquoteSegment).join(" ") : message;
-	return line.startsWith("» ") ? line.slice(2) : line;
-}
-/**
-* Splits on the commas Hermes inserts between arguments — those at nesting depth zero and outside
-* any string literal. Returns null if the delimiters are unbalanced (not a Hermes join we trust).
-*/
-function splitTopLevel(input) {
-	const segments = [];
-	let depth = 0;
-	let inString = false;
-	let start = 0;
-	for (let i = 0, len = input.length; i < len; i++) {
-		const char = input[i];
-		if (inString) {
-			if (char === "\\") {
-				i++;
-				continue;
-			}
-			if (char === "'") inString = false;
-			continue;
-		}
-		switch (char) {
-			case "'":
-				inString = true;
-				break;
-			case "{":
-			case "[":
-			case "(":
-				depth++;
-				break;
-			case "}":
-			case "]":
-			case ")":
-				depth--;
-				break;
-			case ",":
-				if (depth === 0) {
-					segments.push(input.slice(start, i));
-					if (input[i + 1] === " ") i++;
-					start = i + 1;
-				}
-				break;
-		}
-	}
-	if (depth !== 0 || inString) return null;
-	segments.push(input.slice(start));
-	return segments;
-}
-/** Unwraps a fully single-quoted segment (`'text'`) into `text`; leaves anything else untouched. */
-function unquoteSegment(segment) {
-	const trimmed = segment.trim();
-	if (trimmed.length < 2 || trimmed[0] !== "'" || trimmed[trimmed.length - 1] !== "'") return trimmed;
-	return trimmed.slice(1, -1).replace(/\\'/g, "'");
-}
-//#endregion
-//#region src/lib/banner.ts
-/**
-* Renders the debugger's startup banner: a rounded box, tinted in the brand pink, that adapts to the
-* terminal's width. The box shrinks to fit narrow terminals and caps at a comfortable reading width
-* on wide ones; when the terminal is too narrow for a box, it falls back to plain starred lines.
-*/
-/** Brand pink used for the banner frame and title. */
-const PINK = "#ff5fbf";
-/** Dim grey for secondary label text inside the box. */
-const GREY = "#9ca3af";
-/** The banner never grows past this many columns, however wide the terminal is. */
-const MAX_WIDTH = 72;
-/** Below this inner width there's no room for a box; fall back to plain lines. */
-const MIN_BOX_WIDTH = 24;
-/** The horizontal padding between the box border and its content. */
-const PADDING = 2;
-/**
-* @description Prints the startup banner for the given connection targets, sized to the terminal.
-* @param deviceAddress The `host:port` a device connects to.
-* @param mcpAddress The `ws://…?mcp` URL an MCP client connects to.
-*/
-function printBanner(deviceAddress, mcpAddress) {
-	const title = "Unbound's Debugger";
-	const lines = [{
-		label: "Devices",
-		value: deviceAddress
-	}, {
-		label: "MCP",
-		value: mcpAddress
-	}];
-	const longest = Math.max(18, ...lines.map((l) => rowText(l).length));
-	const available = terminalWidth() - 2 - PADDING * 2;
-	const inner = Math.min(longest, MAX_WIDTH, available);
-	if (inner < MIN_BOX_WIDTH || inner < longest) {
-		printFallback(title, lines);
-		return;
-	}
-	printBox(title, lines, inner);
-}
-/** The plain (unstyled) text of a connection row, used for width maths. */
-function rowText(line) {
-	return `${line.label.padEnd(8)}${line.value}`;
-}
-function printBox(title, lines, inner) {
-	const pad = " ".repeat(PADDING);
-	const horizontal = "─".repeat(inner + PADDING * 2);
-	rgb(PINK, `╭${horizontal}╮\n`);
-	rgb(PINK, `│${pad}`);
-	boldRgb(PINK, center(title, inner));
-	rgb(PINK, `${pad}│\n`);
-	rgb(PINK, `├${horizontal}┤\n`);
-	for (const line of lines) {
-		const label = line.label.padEnd(8);
-		const filler = " ".repeat(Math.max(inner - rowText(line).length, 0));
-		rgb(PINK, `│${pad}`);
-		boldRgb(PINK, label);
-		rgb(GREY, line.value);
-		terminal(filler);
-		rgb(PINK, `${pad}│\n`);
-	}
-	rgb(PINK, `╰${horizontal}╯\n`);
-}
-function printFallback(title, lines) {
-	boldRgb(PINK, `✦ ${title}\n`);
-	for (const line of lines) {
-		rgb(PINK, `  ${line.label.padEnd(8)}`);
-		rgb(GREY, `${line.value}\n`);
-	}
-}
-/** The usable terminal width: terminal-kit's when it's a real TTY, else stdout's, else a default. */
-function terminalWidth() {
-	const fromKit = terminal.width;
-	if (typeof fromKit === "number" && Number.isFinite(fromKit)) return fromKit;
-	const fromStdout = process.stdout.columns;
-	if (typeof fromStdout === "number" && fromStdout > 0) return fromStdout;
-	return 80;
-}
-function center(text, width) {
-	const total = Math.max(width - text.length, 0);
-	const left = Math.floor(total / 2);
-	return " ".repeat(left) + text + " ".repeat(total - left);
-}
-function rgb(hex, text) {
-	terminal.colorRgbHex(hex, text);
-}
-function boldRgb(hex, text) {
-	terminal.bold.colorRgbHex(hex, text);
-}
-//#endregion
-//#region src/lib/cli.ts
-const argv = cli({
-	name: "ub-debugger",
-	flags: { port: {
-		type: Number,
-		description: "The port number to host the debugger on.",
-		default: 9090
-	} }
-});
-//#endregion
-//#region src/lib/ws.ts
-const state = { isInitialized: false };
-const MESSAGE_LEVELS = {
-	1: terminal.gray,
-	2: terminal.yellow,
-	3: terminal.red
-};
-/** The glyph that prefixes every bridge lifecycle line, so system events read as one family. */
-const SYSTEM_GLYPH = "✦";
-/** Hex colours for the system banners: pink for MCP, green/red for the device, gray for startup. */
-const SYSTEM_COLORS = {
-	pink: "#ff5fbf",
-	green: "#3cb371",
-	red: "#ff6b6b",
-	gray: "#9ca3af"
-};
-/**
-* @description Prints a bold, glyph-prefixed banner line for a bridge lifecycle event, tinted with
-* the given hex colour. Uses terminal-kit's runtime `colorRgbHex`, which `@types/terminal-kit`
-* doesn't declare, so the chain is reached through a narrow cast.
-* @param color The banner colour, keyed into {@link SYSTEM_COLORS}.
-* @param text The line to print (the glyph is prepended and a trailing newline added).
-*/
-function system(color, text) {
-	terminal.bold.colorRgbHex(SYSTEM_COLORS[color], `${SYSTEM_GLYPH} ${text}\n`);
-}
-/**
-* @description Boots the bridge: the phone-facing WebSocket server, the shared session routing, and
-* the terminal REPL as an in-process controller. A device connects plainly; controllers (MCP
-* clients) connect with `?mcp` and share the single device socket.
-*/
-function setupWebSocket() {
-	if (state.isInitialized) return;
-	state.isInitialized = true;
-	Bun.serve({
-		port: argv.flags.port,
-		fetch(request, server) {
-			if (new URL(request.url).searchParams.has("mcp")) {
-				server.upgrade(request, { data: { role: "controller" } });
-				return;
-			}
-			if (state$2.device) return new Response(JSON.stringify({ error: "A device is already connected." }), { status: 503 });
-			server.upgrade(request, { data: { role: "device" } });
-		},
-		websocket: {
-			open(ws) {
-				if (ws.data.role === "controller") {
-					attachController(ws);
-					return;
-				}
-				attachDevice(ws);
-				abortCurrentReplInput({ deletePrompt: true });
-				system("green", "Device connected");
-				setupReplListeners();
-				takeReplInput();
-			},
-			message(ws, message) {
-				if (typeof message !== "string") return;
-				if (ws.data.role === "controller") {
-					handleControllerMessage(ws, message);
-					return;
-				}
-				handleDeviceMessage(message);
-			},
-			close(ws) {
-				if (ws.data.role === "controller") {
-					detachController(ws);
-					return;
-				}
-				detachDevice(ws);
-				abortCurrentReplInput({
-					deletePrompt: true,
-					deleteCurrentInput: true
-				});
-				system("red", "Device disconnected");
-			}
-		}
-	});
-	onLog((log) => {
-		abortCurrentReplInput({ deletePrompt: true });
-		MESSAGE_LEVELS[log.level](`« ${formatLog(stripEscapeSequences(log.message))}\n`);
-		takeReplInput();
-	});
-	onControllerEval((code) => {
-		abortCurrentReplInput({ deletePrompt: true });
-		terminal.magenta(`» [mcp] ${code}\n`);
-		takeReplInput();
-	});
-	onControllerResult((result) => {
-		abortCurrentReplInput({ deletePrompt: true });
-		if (result.ok) terminal.gray(`« ${result.value}\n`);
-		else terminal.red(`« ${result.error}\n`);
-		takeReplInput();
-	});
-	onController((connected, count) => {
-		abortCurrentReplInput({ deletePrompt: true });
-		const plural = count === 1 ? "client" : "clients";
-		system("pink", connected ? `MCP connected - ${count} ${plural} attached` : `MCP disconnected - ${count} ${plural} attached`);
-		takeReplInput();
-	});
-	printBanner(`${getLocalAddress()}:${argv.flags.port}`, `ws://127.0.0.1:${argv.flags.port}?mcp`);
-}
-function handleDeviceMessage(raw) {
-	const message = parseMessage(raw);
-	if (!message) {
-		system("red", "Parsing failed on message from device");
-		return;
-	}
-	handleDeviceMessage$1(message);
-}
-function handleControllerMessage(ws, raw) {
-	const message = parseMessage(raw);
-	if (message?.type !== "eval") return;
-	evaluateForController(ws, message.id, message.code);
-}
-function getLocalAddress() {
-	const interfaces = os.networkInterfaces();
-	for (const ifaces of Object.values(interfaces)) {
-		if (!ifaces) continue;
-		for (const iface of ifaces) if (iface.family === "IPv4" && !iface.internal) return iface.address;
-	}
-}
-//#endregion
-//#region src/index.ts
-await loadHistory();
-await setupWebSocket();
-//#endregion
-export {};