@unbound-app/debugger-protocol 0.4.0 → 0.7.0

package/dist/controller.d.mts

@@ -1,4 +1,4 @@
-import { l as PluginPushResult, o as EvalResult } from "./index-CMW4XGZB.mjs";
+import { l as PluginPushResult, o as EvalResult } from "./index-DgRewGZa.mjs";
 import { AddonManifest } from "@unbound-app/types";
 //#region src/controller.d.ts
 type PluginPush = {

package/dist/controller.mjs

@@ -2,6 +2,7 @@ import { parseMessage, serializeMessage } from "./index.mjs";
 //#region src/controller.ts
 /** How long the client waits for a result before failing an eval (must exceed the bridge's own). */
 const EVAL_TIMEOUT_MS = 15e3;
+const PLUGIN_PUSH_TIMEOUT_MS = 75e3;
 /** How long to wait between reconnection attempts when the bridge is unreachable. */
 const RECONNECT_DELAY_MS = 1e3;
 var ControllerClient = class {
@@ -117,9 +118,9 @@ var ControllerClient = class {
 					type: "plugin-push-result",
 					id,
 					ok: false,
-					error: `Plugin push timed out after ${EVAL_TIMEOUT_MS}ms.`
+					error: `Plugin push timed out after ${PLUGIN_PUSH_TIMEOUT_MS}ms.`
 				});
-			}, EVAL_TIMEOUT_MS);
+			}, PLUGIN_PUSH_TIMEOUT_MS);
 			this.pendingPushes.set(id, {
 				resolve,
 				timer
@@ -153,13 +154,12 @@ var ControllerClient = class {
 			});
 			return;
 		}
-		if (message.type === "plugin-push-result") {
-			const entry = this.pendingPushes.get(message.id);
-			if (!entry) return;
-			clearTimeout(entry.timer);
-			this.pendingPushes.delete(message.id);
-			entry.resolve(message);
-		}
+		if (message.type !== "plugin-push-result") return;
+		const entry = this.pendingPushes.get(message.id);
+		if (!entry) return;
+		clearTimeout(entry.timer);
+		this.pendingPushes.delete(message.id);
+		entry.resolve(message);
 	}
 	onClose() {
 		this.ws = null;

package/dist/{index-CMW4XGZB.d.mts → index-DgRewGZa.d.mts}

@@ -1,26 +1,18 @@
 import { AddonManifest } from "@unbound-app/types";
 //#region src/index.d.ts
 /**
- * The wire protocol shared by the bridge, the on-device debugger, and any controller (the terminal
- * REPL or an MCP client). Everything crossing a socket is a JSON-encoded {@link BridgeMessage}.
- *
- * Two planes travel over the single device socket:
- *   - control: a controller issues an {@link EvalRequest} or {@link PluginPushRequest}; the device
- *     answers with the matching {@link EvalResult} / {@link PluginPushResult} (correlated by `id`).
- *   - telemetry: the device streams {@link LogMessage}s, broadcast to every controller.
- *
- * Device-safe and dependency-free at runtime (the manifest type is import-erased) so it can be
- * bundled into the React Native client.
+ * The wire protocol shared by the bridge, the device and controllers: every frame is a JSON-encoded
+ * {@link BridgeMessage}. Dependency-free at runtime so the React Native client can bundle it.
  */
 /** A request to evaluate code on the device, sent controller → bridge → device. */
-interface EvalRequest {
+type EvalRequest = {
   type: 'eval';
   /** Correlation id echoed back on the matching {@link EvalResult}. */
   id: string;
   code: string;
-}
+};
 /** The outcome of an {@link EvalRequest}, sent device → bridge → the one waiting controller. */
-interface EvalResult {
+type EvalResult = {
   type: 'eval-result';
   /** The `id` of the {@link EvalRequest} this answers. */
   id: string;
@@ -30,45 +22,44 @@ interface EvalResult {
   /** Present when `!ok`; the inspected error. */
   error?: string;
   /**
-   * Console output captured on the device for the duration of this eval, so a caller sees the
-   * side effects (`console.log`s) the code produced, not just its return value. Populated by the
-   * controller that owns the request, not sent by the device.
+   * Console output captured during this eval, so callers see its side effects too. Populated by
+   * the controller that owns the request, not sent by the device.
    */
   logs?: LogMessage[];
-}
+};
 /**
  * A request to hot-reload a plugin on the device, sent controller → bridge → device. Carries the
  * freshly built bundle and manifest so the device swaps them in without a re-fetch.
  */
-interface PluginPushRequest {
+type PluginPushRequest = {
   type: 'plugin-push';
   /** Correlation id echoed back on the matching {@link PluginPushResult}. */
   id: string;
   addonId: string;
   bundle: string;
   manifest: AddonManifest;
-}
+};
 /** The outcome of a {@link PluginPushRequest}, sent device → bridge → the one waiting controller. */
-interface PluginPushResult {
+type PluginPushResult = {
   type: 'plugin-push-result';
   /** The `id` of the {@link PluginPushRequest} this answers. */
   id: string;
   ok: boolean;
   /** Present when `!ok`; the reload failure, inspected. */
   error?: string;
-}
+};
 /** A `console.*` / `nativeLoggingHook` line, streamed device → bridge → all controllers. */
-interface LogMessage {
+type LogMessage = {
   type: 'log';
   /** 1 = log/gray, 2 = warn/yellow, 3 = error/red. */
   level: 1 | 2 | 3;
   message: string;
-}
+};
 /** Bridge → controller, once on attach and whenever the device connects or drops. */
-interface DeviceStatus {
+type DeviceStatus = {
   type: 'device-status';
   connected: boolean;
-}
+};
 /** Every framed message on the wire. */
 type BridgeMessage = EvalRequest | EvalResult | PluginPushRequest | PluginPushResult | LogMessage | DeviceStatus;
 /** The default port the bridge listens on and controllers dial. */

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { a as EvalRequest, c as PluginPushRequest, d as parseMessage, f as serializeMessage, i as DeviceStatus, l as PluginPushResult, n as CONTROLLER_ENDPOINT_MARKER, o as EvalResult, r as DEFAULT_BRIDGE_PORT, s as LogMessage, t as BridgeMessage, u as _default } from "./index-CMW4XGZB.mjs";
+import { a as EvalRequest, c as PluginPushRequest, d as parseMessage, f as serializeMessage, i as DeviceStatus, l as PluginPushResult, n as CONTROLLER_ENDPOINT_MARKER, o as EvalResult, r as DEFAULT_BRIDGE_PORT, s as LogMessage, t as BridgeMessage, u as _default } from "./index-DgRewGZa.mjs";
 export { BridgeMessage, CONTROLLER_ENDPOINT_MARKER, DEFAULT_BRIDGE_PORT, DeviceStatus, EvalRequest, EvalResult, LogMessage, PluginPushRequest, PluginPushResult, _default as default, parseMessage, serializeMessage };

package/dist/index.mjs

@@ -24,10 +24,10 @@ function parseMessage(raw) {
 	} catch {
 		return;
 	}
-	if (typeof value !== "object" || value === null) return void 0;
-	const type = value.type;
-	if (typeof type !== "string" || !MESSAGE_TYPES.has(type)) return void 0;
-	return value;
+	return isBridgeMessage(value) ? value : void 0;
+}
+function isBridgeMessage(value) {
+	return typeof value === "object" && value !== null && "type" in value && typeof value.type === "string" && MESSAGE_TYPES.has(value.type);
 }
 /**
 * @description Serialises a {@link BridgeMessage} into its wire form. Inverse of {@link parseMessage}.

package/dist/registry.d.mts

@@ -2,9 +2,8 @@ import { ControllerClient } from "./controller.mjs";
 import { z } from "zod";
 //#region src/registry.d.ts
 /**
- * A single command definition is the one source both surfaces derive from: the CLI adapter builds
- * flags and positionals from its schema, the MCP adapter uses the schema as the tool's input schema.
- * Defining a command once keeps the two surfaces structurally in parity.
+ * One command definition feeds both surfaces: the CLI builds flags and positionals from its schema,
+ * and the MCP server uses the schema as the tool's input schema.
  */
 /** The shared runtime a command handler runs against: the bridge controller it evaluates through. */
 type CommandContext = {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@unbound-app/debugger-protocol",
-	"version": "0.4.0",
+	"version": "0.7.0",
 	"description": "The wire protocol and controller client shared by the debugger bridge, the on-device client, and the CLI.",
 	"author": {
 		"name": "Mario P.",
@@ -35,7 +35,7 @@
 		"build": "tsdown"
 	},
 	"dependencies": {
-		"@unbound-app/types": "0.4.0",
+		"@unbound-app/types": "0.7.0",
 		"zod": "^4.0.0"
 	},
 	"peerDependencies": {