@unbound-app/cli 0.7.3 → 0.8.0

package/dist/index.mjs

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import { cli, command } from "cleye";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CONTROLLER_ENDPOINT_MARKER, DEFAULT_BRIDGE_PORT } from "@unbound-app/debugger-protocol";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { existsSync, mkdirSync, openAsBlob, readFileSync, readdirSync, rmSync, watch, writeFileSync } from "node:fs";
 import { basename, dirname, join, relative, resolve, sep } from "node:path";
 import { ControllerClient } from "@unbound-app/debugger-protocol/controller";
-import { CONTROLLER_ENDPOINT_MARKER, DEFAULT_BRIDGE_PORT } from "@unbound-app/debugger-protocol";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { glob } from "node:fs/promises";
 import { spawn, spawnSync } from "node:child_process";
 import { homedir } from "node:os";
@@ -37,7 +37,7 @@ async function readStdin() {
 //#region src/lib/config.ts
 /** The filename walked up the directory tree to locate a workspace root. */
 const CONFIG_FILENAME = "unbound.config.json";
-const schema$2 = z.object({
+const schema$4 = z.object({
 	$schema: z.string().optional(),
 	addons: z.array(z.string()).default(["plugins/*", "themes/*"]),
 	build: z.string().default("bun run build"),
@@ -53,13 +53,13 @@ const schema$2 = z.object({
 function loadConfig(cwd = process.cwd()) {
 	const found = findConfigFile(cwd);
 	if (!found) return {
-		config: schema$2.parse({}),
+		config: schema$4.parse({}),
 		dir: resolve(cwd),
 		bare: true
 	};
 	const raw = JSON.parse(readFileSync(found, "utf8"));
 	return {
-		config: schema$2.parse(raw),
+		config: schema$4.parse(raw),
 		dir: dirname(found),
 		bare: false
 	};
@@ -188,7 +188,12 @@ function toCleyeCommand(definition) {
 		name: definition.name,
 		description: definition.description,
 		parameters: positionalNames.map((name) => `[${name}]`),
-		flags
+		flags,
+		help: definition.surfaces.cli === "mcp" ? { usage: [
+			"ubd mcp",
+			definition.name,
+			"[flags...]"
+		].concat(positionalNames.map((name) => `[${name}]`)).join(" ") } : void 0
 	}, async (parsed) => {
 		const { json, ...flagInput } = parsed.flags;
 		const input = { ...flagInput };
@@ -280,6 +285,8 @@ const apiErrorCodeSchema = z.enum([
 	"last_owner",
 	"github_not_linked",
 	"github_no_push_access",
+	"sync_conflict",
+	"sync_document_too_large",
 	"internal_error"
 ]);
 /** The body of every non-2xx JSON response from `/api/v1/*`. */
@@ -302,6 +309,13 @@ var ApiRequestError = class extends Error {
 		this.name = "ApiRequestError";
 	}
 };
+/** A `304 Not Modified` answer to a conditional request: the copy the caller holds is current. */
+var NotModifiedError = class extends Error {
+	constructor() {
+		super("Not modified.");
+		this.name = "NotModifiedError";
+	}
+};
 function buildUrl(baseUrl, path, params, query) {
 	const url = new URL(buildPath(path, params), baseUrl);
 	for (const [name, value] of Object.entries(query ?? {})) {
@@ -326,7 +340,7 @@ async function toRequestError(response) {
 * @description Creates a typed client for the Unbound web API. Routes, bodies and responses are
 * checked against the API map exported by `@unbound-app/web/api`; responses are parsed with the
 * route's contract schema and `{ error: { code, message } }` bodies are thrown as
-* {@link ApiRequestError}.
+* {@link ApiRequestError}. A `304` to a conditional request is thrown as {@link NotModifiedError}.
 * @template Api The API map, `Api` from `@unbound-app/web/api`.
 * @param options The API origin and headers sent with every request (e.g. credentials).
 * @returns A `request(route, options)` function.
@@ -345,6 +359,7 @@ function createApiClient(options) {
 			headers,
 			body: init.body === void 0 ? void 0 : JSON.stringify(init.body)
 		});
+		if (response.status === 304) throw new NotModifiedError();
 		if (!response.ok) throw await toRequestError(response);
 		return init.response.parse(await response.json());
 	};
@@ -427,13 +442,18 @@ function hasBuildScript(addonDir) {
 * stdout and stderr are inherited so the build's own output surfaces live.
 * @param addon The addon to build.
 * @param buildCommand The shell command to run in the addon directory.
+* @param env Variables added to the build's environment.
 * @returns Whether the build succeeded (always `true` for static addons).
 */
-function buildAddon(addon, buildCommand) {
+function buildAddon(addon, buildCommand, env = {}) {
 	if (addon.static) return Promise.resolve(true);
 	return new Promise((resolve) => {
 		const child = spawn(buildCommand, {
 			cwd: addon.dir,
+			env: {
+				...process.env,
+				...env
+			},
 			shell: true,
 			stdio: "inherit"
 		});
@@ -608,7 +628,7 @@ function getBundleName(addon, main) {
 const apiUrlSchema = z.url({ protocol: /^https?$/ }).transform((url) => new URL(url).origin).default("https://unbound.rip");
 //#endregion
 //#region src/lib/env.ts
-const schema$1 = z.object({
+const schema$3 = z.object({
 	/** The origin of the Unbound web API that `ubd login` and `ubd publish` talk to. */
 	UNBOUND_API_URL: apiUrlSchema,
 	/** An API key for CI; when set, `ubd publish` sends it instead of the stored login. */
@@ -622,7 +642,7 @@ const schema$1 = z.object({
 * @returns The validated environment.
 */
 function parseEnv(source = process.env) {
-	const parsed = schema$1.safeParse(source);
+	const parsed = schema$3.safeParse(source);
 	if (!parsed.success) throw new Error(`Invalid environment:\n${z.prettifyError(parsed.error)}`);
 	return parsed.data;
 }
@@ -637,7 +657,7 @@ function getCredentialsPath(env) {
 }
 //#endregion
 //#region src/lib/credentials.ts
-const schema = z.object({
+const schema$2 = z.object({
 	/** The API origin the session belongs to; it is never sent to any other origin. */
 	apiUrl: z.url(),
 	/** The Better Auth session token from the device authorization flow, sent as a bearer token. */
@@ -650,7 +670,7 @@ const schema = z.object({
 */
 function readCredentials(path) {
 	if (!existsSync(path)) return;
-	const parsed = schema.safeParse(JSON.parse(readFileSync(path, "utf8")));
+	const parsed = schema$2.safeParse(JSON.parse(readFileSync(path, "utf8")));
 	if (!parsed.success) throw new Error(`Invalid credentials in ${path}:\n${z.prettifyError(parsed.error)}`);
 	return parsed.data;
 }
@@ -742,7 +762,7 @@ const publishCommand = {
 	name: "publish",
 	description: "Build an addon and submit it for review on Unbound. Authenticates with UNBOUND_API_KEY when set, otherwise with the `ubd login` session.",
 	surfaces: {
-		cli: true,
+		cli: "root",
 		mcp: false
 	},
 	schema: z.object({
@@ -1096,7 +1116,7 @@ const createCommand = {
 	name: "create",
 	description: "Scaffold a new Unbound addon or addon workspace. Prompts for anything left unset, so a fully-flagged invocation runs without prompts for use in CI.",
 	surfaces: {
-		cli: true,
+		cli: "root",
 		mcp: false
 	},
 	schema: z.object({
@@ -1148,7 +1168,7 @@ const logoutCommand = {
 	name: "logout",
 	description: "Delete the credentials `ubd login` stored.",
 	surfaces: {
-		cli: true,
+		cli: "root",
 		mcp: false
 	},
 	schema: z.object({}),
@@ -1172,12 +1192,130 @@ const logoutCommand = {
 	}
 };
 //#endregion
+//#region src/lib/format.ts
+/**
+* @description Renders an {@link EvalResult} into the human-readable transcript both surfaces print:
+* captured console output first, then the value or error, each under its own header.
+* @param result The device's eval result.
+* @returns The formatted transcript.
+*/
+function formatResult(result) {
+	const parts = [];
+	if (result.logs?.length) parts.push("--- console ---", result.logs.map(formatLog).join("\n"));
+	if (result.ok) parts.push("--- result ---", result.value ?? "undefined");
+	else parts.push("--- error ---", result.error ?? "Unknown error.");
+	return parts.join("\n");
+}
+/**
+* @description Renders a single {@link LogMessage} as a level-tagged line for the console transcript.
+* @param log The captured log line.
+* @returns The `[level] message` line.
+*/
+function formatLog(log) {
+	return `[${log.level === 3 ? "error" : log.level === 2 ? "warn" : "log"}] ${log.message}`;
+}
+//#endregion
+//#region src/lib/device.ts
+/**
+* @description Serialises a function into device code that calls it with Unbound's global and the given arguments.
+* @template A The function's arguments after `unbound`.
+* @template R The function's return type.
+* @param fn The function to run on the device. It must not close over anything outside its own body.
+* @param args The arguments to pass after `unbound`, sent as JSON.
+* @returns The JavaScript to evaluate.
+*/
+function toDeviceCode(fn, ...args) {
+	return `(${fn.toString()})(unbound, ${args.map((arg) => JSON.stringify(arg)).join(", ")})`;
+}
+/** The answer every device command gives when the bridge has no device. */
+const NOT_CONNECTED = {
+	ok: false,
+	text: "No device is connected to the debugger. Launch the app so its debugger dials the bridge, then retry."
+};
+/**
+* @description Waits briefly for a device, then evaluates code on it.
+* @param client The bridge controller.
+* @param code The JavaScript to evaluate on the device.
+* @returns The device's result, or `undefined` when no device connected in time.
+*/
+async function evaluateOnDevice(client, code) {
+	await waitForDevice(client);
+	if (!client.isDeviceConnected) return;
+	return client.evaluate(code);
+}
+/**
+* @description Evaluates code on the device and renders the result as a command's output.
+* @param client The bridge controller.
+* @param code The JavaScript to evaluate on the device.
+* @returns The formatted transcript with the raw result as data, or {@link NOT_CONNECTED}.
+*/
+async function runOnDevice(client, code) {
+	const result = await evaluateOnDevice(client, code);
+	if (!result) return NOT_CONNECTED;
+	return {
+		ok: result.ok,
+		text: formatResult(result),
+		data: result
+	};
+}
+//#endregion
+//#region src/commands/reload.ts
+/** The global the running bundle is tagged with, so the reloaded one can be told apart. */
+const TOKEN_KEY = "__UBD_RELOAD__";
+/** How often the reload command probes for the fresh bundle. */
+const RELOAD_POLL_MS = 500;
+const schema$1 = z.object({
+	timeout: z.number().default(6e4).describe("How long to wait for the reloaded app to reconnect, in milliseconds."),
+	port: z.number().default(DEFAULT_BRIDGE_PORT).describe("The port the debugger bridge listens on.")
+});
+function tagAndReload(unbound, key, token) {
+	Reflect.set(globalThis, key, token);
+	setTimeout(() => void unbound.native.reload(), 100);
+	return "reloading";
+}
+function bundleFreshness(_unbound, key, token) {
+	return Reflect.get(globalThis, key) === token ? "stale" : "fresh";
+}
+const reloadCommand = {
+	name: "reload",
+	description: "Reload the JavaScript bundle on the connected device and wait until the fresh bundle reconnects to the debugger. The fresh bundle is told apart by a token the old one carried.",
+	surfaces: {
+		cli: "root",
+		mcp: true
+	},
+	schema: schema$1,
+	async handler({ timeout }, { client }) {
+		const token = crypto.randomUUID();
+		const started = Date.now();
+		const result = await evaluateOnDevice(client, toDeviceCode(tagAndReload, TOKEN_KEY, token));
+		if (!result) return NOT_CONNECTED;
+		if (!result.ok) return {
+			ok: false,
+			text: formatResult(result)
+		};
+		while (Date.now() - started < timeout) {
+			await Bun.sleep(RELOAD_POLL_MS);
+			await waitForDevice(client, RELOAD_POLL_MS);
+			if (!client.isDeviceConnected) continue;
+			const probe = await client.evaluate(toDeviceCode(bundleFreshness, TOKEN_KEY, token));
+			if (probe.ok && probe.value === "fresh") return {
+				ok: true,
+				text: `Reloaded in ${Date.now() - started}ms.`
+			};
+		}
+		return {
+			ok: false,
+			text: `The app did not reconnect within ${timeout}ms of reloading.`
+		};
+	}
+};
+//#endregion
 //#region src/commands/build.ts
 const buildCommand = {
 	name: "build",
 	description: "Build every addon in the workspace once, reporting per-addon success and failure.",
 	surfaces: {
-		cli: true,
+		cli: "root",
 		mcp: false
 	},
 	schema: z.object({}),
@@ -1265,7 +1403,7 @@ const loginCommand = {
 	name: "login",
 	description: "Log in to Unbound by approving a code on the website, so `ubd publish` can submit addons. Not needed in CI when UNBOUND_API_KEY is set.",
 	surfaces: {
-		cli: true,
+		cli: "root",
 		mcp: false
 	},
 	schema: z.object({}),
@@ -1296,35 +1434,74 @@ function printCode(code) {
 	process.stdout.write(`Open ${code.verificationUriComplete} and confirm the code ${code.userCode}.\n(Or go to ${code.verificationUri} and enter it.)\nWaiting for approval…\n`);
 }
 //#endregion
-//#region src/lib/format.ts
+//#region src/lib/navigation.ts
 /**
-* @description Renders an {@link EvalResult} into the human-readable transcript both surfaces print:
-* captured console output first, then the value or error, each under its own header.
-* @param result The device's eval result.
-* @returns The formatted transcript.
+* @description Opens a settings screen from anywhere in the app, through Discord's root navigation ref.
+* @param unbound Unbound's global on the device.
+* @param name A route key, or a name matching one ignoring case, underscores and `UNBOUND_` (`Marketplace` → `UNBOUND_MARKETPLACE`).
+* @param params Route parameters for the screen.
+* @returns The route key it opened. Throws, listing Unbound's screens, when nothing matches.
 */
-function formatResult(result) {
-	const parts = [];
-	if (result.logs?.length) parts.push("--- console ---", result.logs.map(formatLog).join("\n"));
-	if (result.ok) parts.push("--- result ---", result.value ?? "undefined");
-	else parts.push("--- error ---", result.error ?? "Unknown error.");
-	return parts.join("\n");
+function openScreen(unbound, name, params) {
+	const { SETTING_RENDERER_CONFIG } = unbound.metro.findByProps("SETTING_RENDERER_CONFIG");
+	const { getRootNavigationRef } = unbound.metro.findByProps("getRootNavigationRef");
+	function normalize(key) {
+		return key.toLowerCase().replace(/^unbound_/, "").replace(/[^a-z0-9]/g, "");
+	}
+	const keys = Object.keys(SETTING_RENDERER_CONFIG);
+	const own = keys.filter((key) => key.startsWith("UNBOUND_"));
+	const wanted = normalize(name);
+	const route = keys.includes(name) ? name : own.find((key) => normalize(key) === wanted) ?? keys.find((key) => normalize(key) === wanted);
+	if (!route) throw new Error(`No settings screen matches ${name}. Unbound screens: ${own.join(", ")}`);
+	getRootNavigationRef().navigate("settings", {
+		screen: route,
+		params
+	});
+	return route;
 }
 /**
-* @description Renders a single {@link LogMessage} as a level-tagged line for the console transcript.
-* @param log The captured log line.
-* @returns The `[level] message` line.
+* @description Reads the focused route and the stack of route names leading to it.
+* @param unbound Unbound's global on the device.
+* @returns The route as a JSON string of {@link CurrentRoute}.
 */
-function formatLog(log) {
-	return `[${log.level === 3 ? "error" : log.level === 2 ? "warn" : "log"}] ${log.message}`;
+function currentRoute(unbound) {
+	const ref = unbound.metro.findByProps("getRootNavigationRef").getRootNavigationRef();
+	const path = [];
+	let state = ref.getRootState();
+	while (state) {
+		const route = state.routes[state.index ?? state.routes.length - 1];
+		if (!route) break;
+		path.push(route.name);
+		state = route.state;
+	}
+	const { name, params } = ref.getCurrentRoute();
+	return JSON.stringify({
+		name,
+		params: params ?? {},
+		path
+	});
 }
 //#endregion
+//#region src/commands/route.ts
+const routeCommand = {
+	name: "route",
+	description: "Print the focused navigation route on the connected device: its name, its params, and the navigator path leading to it.",
+	surfaces: {
+		cli: "mcp",
+		mcp: true
+	},
+	schema: z.object({ port: z.number().default(DEFAULT_BRIDGE_PORT).describe("The port the debugger bridge listens on.") }),
+	handler(_input, { client }) {
+		return runOnDevice(client, toDeviceCode(currentRoute));
+	}
+};
+//#endregion
 //#region src/commands/eval.ts
 const evalCommand = {
 	name: "eval",
 	description: "Evaluate JavaScript inside the running Unbound client on the connected device and return its result plus any console output the code produced. Use this to inspect the live runtime: read globals (e.g. `unbound.metro`), call APIs, and probe Discord internals. The last expression is the return value; `console.log`/`warn`/`error` are captured separately.",
 	surfaces: {
-		cli: true,
+		cli: "root",
 		mcp: true
 	},
 	schema: z.object({
@@ -1332,18 +1509,43 @@ const evalCommand = {
 		port: z.number().default(DEFAULT_BRIDGE_PORT).describe("The port the debugger bridge listens on.")
 	}),
 	cli: { positionals: ["code"] },
-	async handler({ code }, { client }) {
-		await waitForDevice(client);
-		if (!client.isDeviceConnected) return {
-			ok: false,
-			text: "No device is connected to the debugger. Launch the app so its debugger dials the bridge, then retry."
-		};
-		const result = await client.evaluate(code);
-		return {
-			ok: result.ok,
-			text: formatResult(result),
-			data: result
-		};
+	handler({ code }, { client }) {
+		return runOnDevice(client, code);
+	}
+};
+//#endregion
+//#region src/commands/open.ts
+const schema = z.object({
+	screen: z.string().min(1).describe("The settings screen to open: a `Screens` key such as `Marketplace` or `Plugins`, or any `SETTING_RENDERER_CONFIG` route key."),
+	params: z.string().default("{}").describe("Route parameters for the screen, as a JSON object, e.g. `{\"kind\":\"theme\"}`."),
+	port: z.number().default(DEFAULT_BRIDGE_PORT).describe("The port the debugger bridge listens on.")
+});
+const paramsSchema = z.record(z.string(), z.union([
+	z.string(),
+	z.number(),
+	z.boolean(),
+	z.null()
+]));
+const openCommand = {
+	name: "open",
+	description: "Open an Unbound (or Discord) settings screen on the connected device from anywhere in the app, through the root navigation ref. Prints the route key it opened.",
+	surfaces: {
+		cli: "mcp",
+		mcp: true
+	},
+	schema,
+	cli: { positionals: ["screen"] },
+	async handler({ screen, params }, { client }) {
+		let parsed;
+		try {
+			parsed = paramsSchema.parse(JSON.parse(params));
+		} catch (error) {
+			return {
+				ok: false,
+				text: `params must be a JSON object of plain values: ${toError(error).message}`
+			};
+		}
+		return runOnDevice(client, toDeviceCode(openScreen, screen, parsed));
 	}
 };
 //#endregion
@@ -1409,6 +1611,7 @@ function readBuiltAddon(addon) {
 }
 //#endregion
 //#region src/lib/dev-server.ts
+const DEV_BUILD_ENV = { UNBOUND_HOT: "1" };
 /** How long file changes inside one addon settle before that addon rebuilds. */
 const DEBOUNCE_MS = 150;
 /**
@@ -1463,7 +1666,7 @@ var DevServer = class {
 	}
 	async rebuild(addon) {
 		if (!addon.static) process.stdout.write(`Building ${addon.id}…\n`);
-		if (!await buildAddon(addon, this.resolved.config.build)) {
+		if (!await buildAddon(addon, this.resolved.config.build, DEV_BUILD_ENV)) {
 			process.stderr.write(`Failed to build ${addon.id}.\n`);
 			return;
 		}
@@ -1509,12 +1712,15 @@ function toBuiltAddon(addon) {
 */
 const commands = [
 	evalCommand,
+	openCommand,
+	routeCommand,
+	reloadCommand,
 	buildCommand,
 	{
 		name: "dev",
 		description: "Watch every addon in the workspace and rebuild only the addon whose files change, reloading it in the running client after each successful build. Runs until interrupted.",
 		surfaces: {
-			cli: true,
+			cli: "root",
 			mcp: false
 		},
 		schema: z.object({ port: z.number().default(DEFAULT_BRIDGE_PORT).describe("The port the debugger bridge listens on.") }),
@@ -1535,10 +1741,11 @@ const commands = [
 ];
 //#endregion
 //#region src/commands/mcp.ts
+/** The agent-facing tools the CLI lists under `ubd mcp` instead of at the root. */
+const tools = commands.filter((definition) => definition.surfaces.cli === "mcp");
 /**
 * @description The `ubd mcp` command: a stdio MCP server exposing every registry entry opted into
-* `surfaces.mcp`, each riding a single long-lived controller connection to the bridge. This is the
-* relocated debugger MCP, now registry-driven.
+* `surfaces.mcp`, each riding a single long-lived controller connection to the bridge.
 */
 const mcpCommand = command({
 	name: "mcp",
@@ -1547,7 +1754,8 @@ const mcpCommand = command({
 		type: Number,
 		description: "The port the debugger bridge listens on.",
 		default: DEFAULT_BRIDGE_PORT
-	} }
+	} },
+	help: { usage: ["ubd mcp [flags]", ...tools.map((tool) => `ubd mcp ${tool.name} --help`)] }
 }, async (parsed) => {
 	const context = createContext(parsed.flags.port);
 	const server = new McpServer({
@@ -1561,6 +1769,24 @@ const mcpCommand = command({
 	const transport = new StdioServerTransport();
 	await server.connect(transport);
 });
+/**
+* @description Whether a name is one of the tools run as `ubd mcp <tool>`.
+* @param name The argument after `mcp`.
+* @returns Whether `ubd mcp <name>` runs a tool instead of the server.
+*/
+function isMcpTool(name) {
+	return tools.some((tool) => tool.name === name);
+}
+/**
+* @description Runs one MCP tool from the command line, as `ubd mcp <tool> [args]`.
+* @param argv The arguments after `mcp`, starting with the tool name.
+*/
+function runMcpTool(argv) {
+	cli({
+		name: "ubd",
+		commands: tools.map(toCleyeCommand)
+	}, void 0, argv);
+}
 //#endregion
 //#region src/lib/menu.ts
 /** Concise, menu-friendly summaries keyed by command name; the registry descriptions are tuned for
@@ -1593,7 +1819,8 @@ const ORDER = [
 * @returns The menu as a single printable string.
 */
 function renderMenu() {
-	const names = /* @__PURE__ */ new Set([...commands.map((command) => command.name), "mcp"]);
+	const roots = commands.filter((command) => command.surfaces.cli === "root");
+	const names = /* @__PURE__ */ new Set([...roots.map((command) => command.name), "mcp"]);
 	const ordered = [...ORDER.filter((name) => names.has(name)), ...[...names].filter((name) => !ORDER.includes(name))];
 	const width = Math.max(...ordered.map((name) => name.length));
 	const rows = ordered.map((name) => {
@@ -1616,10 +1843,15 @@ function renderMenu() {
 }
 //#endregion
 //#region src/index.ts
-const argv = cli({
-	name: "ubd",
-	commands: [...commands.map(toCleyeCommand), mcpCommand]
-});
-if (!argv.command && argv._.length === 0 && !argv.flags.help && !argv.flags.version) process.stdout.write(`${renderMenu()}\n`);
+const [first, ...rest] = process.argv.slice(2);
+if (first === "mcp" && isMcpTool(rest[0])) runMcpTool(rest);
+else {
+	const roots = commands.filter((definition) => definition.surfaces.cli === "root");
+	const argv = cli({
+		name: "ubd",
+		commands: [...roots.map(toCleyeCommand), mcpCommand]
+	});
+	if (!argv.command && argv._.length === 0 && !argv.flags.help && !argv.flags.version) process.stdout.write(`${renderMenu()}\n`);
+}
 //#endregion
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@unbound-app/cli",
-	"version": "0.7.3",
+	"version": "0.8.0",
 	"description": "The `ubd` command line for the Unbound client: evaluate on-device code and serve the debugger as an MCP.",
 	"author": {
 		"name": "Mario P.",
@@ -28,7 +28,7 @@
 	"dependencies": {
 		"@clack/prompts": "^1.7.0",
 		"@modelcontextprotocol/sdk": "^1.29.0",
-		"@unbound-app/debugger-protocol": "0.7.2",
+		"@unbound-app/debugger-protocol": "0.8.0",
 		"better-auth": "1.7.10",
 		"cleye": "^1.3.4",
 		"picocolors": "^1.1.1",

package/templates/plugin/package.json

@@ -14,7 +14,6 @@
 		"@types/react": "^19.2.7",
 		"react-native": "^0.83.0",
 		"rollup": "^4.62.2",
-		"rollup-plugin-iife": "^0.8.0",
 		"rollup-plugin-swc3": "^0.12.1"
 	}
 }

package/templates/plugin/rollup.config.mjs

@@ -1,25 +1,41 @@
 import { nodeResolve } from '@rollup/plugin-node-resolve';
 import { swc } from 'rollup-plugin-swc3';
 import json from '@rollup/plugin-json';
-import iife from 'rollup-plugin-iife';
 
 const globals = {
 	'@unbound-app/api': 'window.unbound',
-	'react': 'window.React',
+	// The bare name reaches the React Unbound passes the bundle, which keeps components' state on hot refresh.
+	'react': 'React',
 	'react-native': 'window.ReactNative',
 	'react-native-reanimated': 'window.unbound.metro.common.Reanimated',
 	'@react-native-clipboard/clipboard': 'window.unbound.metro.common.Clipboard',
 	'moment': 'window.unbound.metro.common.Moment',
 };
 
+const hot = process.env.UNBOUND_HOT === '1';
+
+function keepIifeUnnamedForUnbound(level, log, handler) {
+	if (log.code !== 'MISSING_NAME_OPTION_FOR_IIFE_EXPORT') {
+		handler(level, log);
+	}
+}
+
 /** @type {import('rollup').RollupOptions} */
 export default {
 	input: 'index.tsx',
 	external: Object.keys(globals),
-	plugins: [nodeResolve(), json(), swc({ tsconfig: false }), iife()],
+	plugins: [
+		nodeResolve(),
+		json(),
+		swc({
+			tsconfig: false,
+			jsc: { transform: { react: { refresh: hot, development: hot } } },
+		}),
+	],
+	onLog: keepIifeUnnamedForUnbound,
 	output: {
 		dir: 'dist',
-		format: 'es',
+		format: 'iife',
 		compact: true,
 		exports: 'named',
 		globals,