@unbound-app/debugger-protocol 0.9.0 → 0.11.0

package/dist/controller.d.mts

@@ -1,10 +1,12 @@
-import { l as EvalResult, o as DeviceInfo, p as PluginPushResult } from "./index-Ctl4b3sx.mjs";
-import { AddonManifest } from "@unbound-app/types";
+import { l as EvalResult, m as PushedAddonKind, o as DeviceInfo, p as PluginPushResult } from "./index-DdSiZNoR.mjs";
+import { PushedManifest } from "@unbound-app/types";
 type PluginPush = {
   addonId: string;
+  kind?: PushedAddonKind;
   bundle: string;
-  manifest: AddonManifest;
+  manifest: PushedManifest;
   bytecode?: Record<string, string>;
+  files?: Record<string, string>;
 };
 export declare class ControllerClient {
   private ws;
@@ -32,7 +34,7 @@ export declare class ControllerClient {
    */
   evaluate(code: string, timeout?: number): Promise<EvalResult>;
   /**
-   * @description Pushes a freshly built plugin to the device via the bridge and resolves with the
+   * @description Pushes a freshly built plugin or theme to the device via the bridge and resolves with the
    * device's reload outcome. Fails fast if the socket isn't open or the bridge doesn't answer in time.
    * @param push The addon id plus the built bundle and manifest to swap in.
    * @returns The device's {@link PluginPushResult}.

package/dist/controller.mjs

@@ -106,7 +106,7 @@ var ControllerClient = class {
 		});
 	}
 	/**
-	* @description Pushes a freshly built plugin to the device via the bridge and resolves with the
+	* @description Pushes a freshly built plugin or theme to the device via the bridge and resolves with the
 	* device's reload outcome. Fails fast if the socket isn't open or the bridge doesn't answer in time.
 	* @param push The addon id plus the built bundle and manifest to swap in.
 	* @returns The device's {@link PluginPushResult}.

package/dist/{index-Ctl4b3sx.d.mts → index-DdSiZNoR.d.mts}

@@ -1,4 +1,4 @@
-import { AddonManifest } from "@unbound-app/types";
+import { PushedManifest } from "@unbound-app/types";
 /**
  * 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.
@@ -16,40 +16,53 @@ type EvalResult = {
   type: 'eval-result';
   /** The `id` of the {@link EvalRequest} this answers. */
   id: string;
-  ok: boolean;
-  /** Present when `ok`; the inspected return value. */
-  value?: string;
-  /** Present when `!ok`; the inspected error. */
-  error?: string;
   /**
    * 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[];
-};
+} & ({
+  ok: true;
+  /** The inspected return value. */
+  value: string;
+} | {
+  ok: false;
+  /** The inspected error. */
+  error: string;
+});
+/** The addon managers a push can reload into. */
+type PushedAddonKind = 'plugin' | 'theme';
 /**
- * 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.
+ * A request to hot-reload a plugin or theme on the device, sent controller → bridge → device. Carries
+ * the freshly built bundle and manifest so the device swaps them in without a re-fetch.
  */
 type PluginPushRequest = {
   type: 'plugin-push';
   /** Correlation id echoed back on the matching {@link PluginPushResult}. */
   id: string;
   addonId: string;
+  /** Which manager reloads the addon; a plugin when omitted, as pushes from older CLIs are. */
+  kind?: PushedAddonKind;
   bundle: string;
-  manifest: AddonManifest;
+  /** The manifest as authored; the device validates it before swapping anything in. */
+  manifest: PushedManifest;
   /** The bundle compiled to Hermes bytecode, base64-encoded, by bytecode version; its digests are in `manifest.bytecode`. */
   bytecode?: Record<string, string>;
+  /** Each extra file the manifest lists beside the bundle, such as an image, base64-encoded, by path. */
+  files?: Record<string, string>;
 };
 /** The outcome of a {@link PluginPushRequest}, sent device → bridge → the one waiting controller. */
 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;
-};
+} & ({
+  ok: true;
+} | {
+  ok: false;
+  /** The reload failure, inspected. */
+  error: string;
+});
 /** A `console.*` / `nativeLoggingHook` line, streamed device → bridge → all controllers. */
 type LogMessage = {
   type: 'log';
@@ -72,10 +85,13 @@ type DeviceHello = {
 /** Bridge → controller, once on attach and whenever the device connects, drops or says hello. */
 type DeviceStatus = {
   type: 'device-status';
-  connected: boolean;
+} & ({
+  connected: false;
+} | {
+  connected: true;
   /** Present once the connected device has said hello. */
   device?: DeviceInfo;
-};
+});
 /** Every framed message on the wire. */
 type BridgeMessage = EvalRequest | EvalResult | PluginPushRequest | PluginPushResult | LogMessage | DeviceHello | DeviceStatus;
 /** The default port the bridge listens on and controllers dial. */
@@ -105,4 +121,4 @@ declare const _default: {
   parseMessage: typeof parseMessage;
   serializeMessage: typeof serializeMessage;
 };
-export { DeviceHello as a, EvalRequest as c, MAX_EVAL_TIMEOUT_MS as d, PluginPushRequest as f, serializeMessage as g, parseMessage as h, DEFAULT_EVAL_TIMEOUT_MS as i, EvalResult as l, _default as m, CONTROLLER_ENDPOINT_MARKER as n, DeviceInfo as o, PluginPushResult as p, DEFAULT_BRIDGE_PORT as r, DeviceStatus as s, BridgeMessage as t, LogMessage as u };
+export { serializeMessage as _, DeviceHello as a, EvalRequest as c, MAX_EVAL_TIMEOUT_MS as d, PluginPushRequest as f, parseMessage as g, _default as h, DEFAULT_EVAL_TIMEOUT_MS as i, EvalResult as l, PushedAddonKind as m, CONTROLLER_ENDPOINT_MARKER as n, DeviceInfo as o, PluginPushResult as p, DEFAULT_BRIDGE_PORT as r, DeviceStatus as s, BridgeMessage as t, LogMessage as u };

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { a as DeviceHello, c as EvalRequest, d as MAX_EVAL_TIMEOUT_MS, f as PluginPushRequest, g as serializeMessage, h as parseMessage, i as DEFAULT_EVAL_TIMEOUT_MS, l as EvalResult, m as _default, n as CONTROLLER_ENDPOINT_MARKER, o as DeviceInfo, p as PluginPushResult, r as DEFAULT_BRIDGE_PORT, s as DeviceStatus, t as BridgeMessage, u as LogMessage } from "./index-Ctl4b3sx.mjs";
-export { BridgeMessage, CONTROLLER_ENDPOINT_MARKER, DEFAULT_BRIDGE_PORT, DEFAULT_EVAL_TIMEOUT_MS, DeviceHello, DeviceInfo, DeviceStatus, EvalRequest, EvalResult, LogMessage, MAX_EVAL_TIMEOUT_MS, PluginPushRequest, PluginPushResult, _default as default, parseMessage, serializeMessage };
+import { _ as serializeMessage, a as DeviceHello, c as EvalRequest, d as MAX_EVAL_TIMEOUT_MS, f as PluginPushRequest, g as parseMessage, h as _default, i as DEFAULT_EVAL_TIMEOUT_MS, l as EvalResult, m as PushedAddonKind, n as CONTROLLER_ENDPOINT_MARKER, o as DeviceInfo, p as PluginPushResult, r as DEFAULT_BRIDGE_PORT, s as DeviceStatus, t as BridgeMessage, u as LogMessage } from "./index-DdSiZNoR.mjs";
+export { BridgeMessage, CONTROLLER_ENDPOINT_MARKER, DEFAULT_BRIDGE_PORT, DEFAULT_EVAL_TIMEOUT_MS, DeviceHello, DeviceInfo, DeviceStatus, EvalRequest, EvalResult, LogMessage, MAX_EVAL_TIMEOUT_MS, PluginPushRequest, PluginPushResult, PushedAddonKind, _default as default, parseMessage, serializeMessage };

package/dist/index.mjs

@@ -34,14 +34,17 @@ function hasRequiredFields(frame) {
 	switch (frame.type) {
 		case "log": return "message" in frame && typeof frame.message === "string" && "level" in frame && (frame.level === 1 || frame.level === 2 || frame.level === 3);
 		case "eval": return "id" in frame && typeof frame.id === "string" && "code" in frame && typeof frame.code === "string";
-		case "eval-result":
-		case "plugin-push-result": return "id" in frame && typeof frame.id === "string" && "ok" in frame && typeof frame.ok === "boolean";
-		case "plugin-push": return "id" in frame && typeof frame.id === "string" && "addonId" in frame && typeof frame.addonId === "string" && "bundle" in frame && typeof frame.bundle === "string" && "manifest" in frame && typeof frame.manifest === "object" && frame.manifest !== null && (!("bytecode" in frame) || frame.bytecode === void 0 || isStringRecord(frame.bytecode));
+		case "eval-result": return "id" in frame && typeof frame.id === "string" && "ok" in frame && (frame.ok === true ? "value" in frame && typeof frame.value === "string" : frame.ok === false && hasError(frame));
+		case "plugin-push-result": return "id" in frame && typeof frame.id === "string" && "ok" in frame && (frame.ok === true || frame.ok === false && hasError(frame));
+		case "plugin-push": return "id" in frame && typeof frame.id === "string" && "addonId" in frame && typeof frame.addonId === "string" && (!("kind" in frame) || frame.kind === void 0 || frame.kind === "plugin" || frame.kind === "theme") && "bundle" in frame && typeof frame.bundle === "string" && "manifest" in frame && typeof frame.manifest === "object" && frame.manifest !== null && (!("bytecode" in frame) || frame.bytecode === void 0 || isStringRecord(frame.bytecode)) && (!("files" in frame) || frame.files === void 0 || isStringRecord(frame.files));
 		case "hello": return "device" in frame && isDeviceInfo(frame.device);
-		case "device-status": return "connected" in frame && typeof frame.connected === "boolean" && (!("device" in frame) || frame.device === void 0 || isDeviceInfo(frame.device));
+		case "device-status": return "connected" in frame && (frame.connected === false || frame.connected === true && (!("device" in frame) || frame.device === void 0 || isDeviceInfo(frame.device)));
 		default: return false;
 	}
 }
+function hasError(frame) {
+	return typeof frame === "object" && frame !== null && "error" in frame && typeof frame.error === "string";
+}
 function isDeviceInfo(value) {
 	return typeof value === "object" && value !== null && "platform" in value && typeof value.platform === "string" && "discordVersion" in value && typeof value.discordVersion === "string" && "loaderVersion" in value && typeof value.loaderVersion === "string" && "clientVersion" in value && typeof value.clientVersion === "string";
 }

package/dist/registry.d.mts

@@ -1,5 +1,5 @@
 import { ControllerClient } from "./controller.mjs";
-import { z } from "zod";
+import { StaticDecode, TObject } from "typebox";
 /**
  * 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.
@@ -26,15 +26,17 @@ export type CommandSurfaces = {
   mcp: true;
 };
 /** A command usable from both the CLI and (when opted in) the MCP server. */
-export type CommandDefinition<S extends z.ZodObject<z.ZodRawShape>> = {
+export type CommandDefinition<S extends TObject = TObject> = {
   name: string;
   description: string;
+  /** A one-line summary for the CLI's menu, where the description is too long. */
+  summary?: string;
   surfaces: CommandSurfaces;
-  /** Used directly as the MCP inputSchema; the CLI adapter derives flags from its fields. */
+  /** Used directly as the MCP tool's input schema; the CLI adapter derives flags from its properties. */
   schema: S;
-  /** Which schema fields the CLI presents as positionals; the rest become flags. */
+  /** Which schema properties the CLI presents as positionals; the rest become flags. */
   cli?: {
-    positionals?: (keyof z.infer<S>)[];
+    positionals?: (keyof StaticDecode<S>)[];
   };
-  handler: (input: z.infer<S>, context: CommandContext) => Promise<CommandOutput>;
+  handler(input: StaticDecode<S>, context: CommandContext): Promise<CommandOutput>;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@unbound-app/debugger-protocol",
-	"version": "0.9.0",
+	"version": "0.11.0",
 	"description": "The wire protocol and controller client shared by the debugger bridge, the on-device client, and the CLI.",
 	"author": {
 		"name": "Mario P.",
@@ -32,12 +32,13 @@
 		}
 	},
 	"scripts": {
-		"build": "tsdown"
+		"build": "tsdown",
+		"typecheck": "tsc --noEmit -p ."
 	},
 	"dependencies": {
-		"zod": "^4.0.0"
+		"typebox": "^1.4.4"
 	},
 	"peerDependencies": {
-		"typescript": "^5.9.3"
+		"typescript": "^7.0.2"
 	}
 }