ugly-app 0.1.682 → 0.1.684

package/dist/cli/version.d.ts

@@ -1,2 +1,2 @@
-export declare const CLI_VERSION = "0.1.682";
+export declare const CLI_VERSION = "0.1.684";
 //# sourceMappingURL=version.d.ts.map

package/dist/cli/version.js

@@ -1,3 +1,3 @@
 // Auto-generated by prebuild — do not edit manually
-export const CLI_VERSION = "0.1.682";
+export const CLI_VERSION = "0.1.684";
 //# sourceMappingURL=version.js.map

package/dist/native/index.d.ts

@@ -17,7 +17,7 @@ export type { TerminalFacade } from './facades/terminal.js';
 export { MCP_CATALOG } from './mcp-catalog.js';
 export { createProxyClient, nativeSigner } from './proxyClient.js';
 export type { ProxyClient, ProxyClientOpts, ProxySocket, HostInfo, RTCFactory, } from './proxyClient.js';
-export { isDesktopChannel, withProxy, dispatchNativeEvent, DESKTOP_NAMESPACES } from './proxy.js';
+export { isDesktopChannel, withProxy, enableUglyProxy, installProxyClient, dispatchNativeEvent, DESKTOP_NAMESPACES } from './proxy.js';
 export type { WithProxyOpts } from './proxy.js';
 export { fpTag, verifyFpTag, parseFingerprint, mskSigner } from './proxyCrypto.js';
 export type { ProxyRole, ProxySigner } from './proxyCrypto.js';

package/dist/native/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/native/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,OAAO,EACP,WAAW,EACX,SAAS,EACT,QAAQ,EACR,MAAM,EACN,SAAS,EACT,cAAc,EACd,aAAa,EACb,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,eAAe,EACf,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/E,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtF,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACnE,YAAY,EACV,WAAW,EACX,eAAe,EACf,WAAW,EACX,QAAQ,EACR,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAClG,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACnF,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/native/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,OAAO,EACP,WAAW,EACX,SAAS,EACT,QAAQ,EACR,MAAM,EACN,SAAS,EACT,cAAc,EACd,aAAa,EACb,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,eAAe,EACf,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/E,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtF,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACnE,YAAY,EACV,WAAW,EACX,eAAe,EACf,WAAW,EACX,QAAQ,EACR,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,eAAe,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACvI,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACnF,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/native/index.js

@@ -6,6 +6,6 @@ export { native, permissions, nativePlatform, isNativeAvailable } from './wrappe
 export { MCP_CATALOG } from './mcp-catalog.js';
 // ── Ugly Proxy (remote UglyNative over WebRTC) ──
 export { createProxyClient, nativeSigner } from './proxyClient.js';
-export { isDesktopChannel, withProxy, dispatchNativeEvent, DESKTOP_NAMESPACES } from './proxy.js';
+export { isDesktopChannel, withProxy, enableUglyProxy, installProxyClient, dispatchNativeEvent, DESKTOP_NAMESPACES } from './proxy.js';
 export { fpTag, verifyFpTag, parseFingerprint, mskSigner } from './proxyCrypto.js';
 //# sourceMappingURL=index.js.map

package/dist/native/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/native/index.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE/E,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAStF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,mDAAmD;AACnD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAQnE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAElG,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/native/index.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE/E,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAStF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,mDAAmD;AACnD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAQnE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,eAAe,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEvI,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/native/proxy.d.ts

@@ -1,5 +1,5 @@
 import type { UglyNative } from './protocol.js';
-import type { ProxyClient } from './proxyClient.js';
+import { type ProxyClient, type ProxySocket, type RTCFactory } from './proxyClient.js';
 /** Namespaces that require a desktop host (RCE-grade / filesystem / long-running tasks). */
 export declare const DESKTOP_NAMESPACES: ReadonlySet<string>;
 export declare function isDesktopChannel(channel: string): boolean;
@@ -20,6 +20,33 @@ export interface WithProxyOpts {
  * to a `dispatchNativeEvent` (below) — then `base.subscribe` delivers them unchanged.
  */
 export declare function withProxy(base: UglyNative, opts: WithProxyOpts): UglyNative;
+/**
+ * Full mobile/web client bootstrap: returns an UglyNative whose desktop-capability calls
+ * lazily connect to a host and proxy. On the first such call (no host yet) it drives the
+ * native host-picker (proxy.pickHost) + status overlay (proxy.setStatus); afterwards it
+ * reconnects to the same host silently. Device-capability calls stay local. Wire the
+ * client's `onEvent` to dispatchNativeEvent so host events reach `subscribe`.
+ */
+export declare function enableUglyProxy(opts: {
+    native: UglyNative;
+    client: ProxyClient;
+}): UglyNative;
+/**
+ * One-call client bootstrap: build the WebRTC proxy client (signer = the native keychain
+ * channel, events fed back to the subscribe bus) and return an UglyNative that lazily
+ * connects + proxies desktop capabilities. Mobile/web shells call this once at startup and
+ * assign the result to `globalThis.UglyNative`.
+ */
+export declare function installProxyClient(opts: {
+    native: UglyNative;
+    socket: ProxySocket;
+    selfDeviceId: string;
+    iceServers?: RTCIceServer[];
+    rtcFactory?: RTCFactory;
+    win?: {
+        dispatchEvent(e: unknown): boolean;
+    };
+}): UglyNative;
 /** Dispatch a proxy event onto the same 'uglyNative' CustomEvent bus base.subscribe reads. */
 export declare function dispatchNativeEvent(win: {
     dispatchEvent(e: unknown): boolean;

package/dist/native/proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/native/proxy.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAYjD,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,+EAA+E;IAC/E,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,GAAG,UAAU,CAc3E;AAED,8FAA8F;AAC9F,wBAAgB,mBAAmB,CACjC,GAAG,EAAE;IAAE,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;CAAE,EAC3C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,GACZ,IAAI,CAON"}
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/native/proxy.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAmC,KAAK,WAAW,EAAE,KAAK,WAAW,EAAiB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEvI,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAYjD,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,+EAA+E;IAC/E,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,GAAG,UAAU,CAc3E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;CACrB,GAAG,UAAU,CAyDb;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE;QAAE,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;KAAE,CAAC;CAC9C,GAAG,UAAU,CAWb;AAED,8FAA8F;AAC9F,wBAAgB,mBAAmB,CACjC,GAAG,EAAE;IAAE,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;CAAE,EAC3C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,GACZ,IAAI,CAON"}

package/dist/native/proxy.js

@@ -1,4 +1,5 @@
 import { NativeUnavailableError } from './protocol.js';
+import { createProxyClient, nativeSigner } from './proxyClient.js';
 /** Namespaces that require a desktop host (RCE-grade / filesystem / long-running tasks). */
 export const DESKTOP_NAMESPACES = new Set([
     'fs',
@@ -38,6 +39,97 @@ export function withProxy(base, opts) {
         subscribe: base.subscribe,
     };
 }
+/**
+ * Full mobile/web client bootstrap: returns an UglyNative whose desktop-capability calls
+ * lazily connect to a host and proxy. On the first such call (no host yet) it drives the
+ * native host-picker (proxy.pickHost) + status overlay (proxy.setStatus); afterwards it
+ * reconnects to the same host silently. Device-capability calls stay local. Wire the
+ * client's `onEvent` to dispatchNativeEvent so host events reach `subscribe`.
+ */
+export function enableUglyProxy(opts) {
+    const { native, client } = opts;
+    let connecting = null;
+    let lastLabel;
+    const setStatus = (state, hostLabel) => {
+        void native.invoke('proxy.setStatus', { state, hostLabel }).catch(() => { });
+    };
+    async function ensureConnected() {
+        if (client.isOpen())
+            return true;
+        if (connecting)
+            return connecting;
+        connecting = (async () => {
+            try {
+                const existing = client.hostDeviceId();
+                if (existing) {
+                    // Silent reconnect to the previously chosen host.
+                    setStatus('reconnecting', lastLabel);
+                    await client.connect(existing);
+                    setStatus('connected', lastLabel);
+                    return true;
+                }
+                setStatus('connecting');
+                const hosts = await client.listHosts();
+                const picked = (await native.invoke('proxy.pickHost', {
+                    hosts: hosts.map((h) => ({ deviceId: h.deviceId, label: h.label, online: true, lastSeen: h.lastSeen })),
+                }));
+                if (!picked) {
+                    setStatus('none');
+                    return false;
+                }
+                lastLabel = hosts.find((h) => h.deviceId === picked.deviceId)?.label;
+                await client.connect(picked.deviceId);
+                setStatus('connected', lastLabel);
+                return true;
+            }
+            catch {
+                setStatus(client.hostDeviceId() ? 'offline' : 'none');
+                return false;
+            }
+            finally {
+                connecting = null;
+            }
+        })();
+        return connecting;
+    }
+    return {
+        platform: native.platform,
+        subscribe: native.subscribe,
+        invoke: (async (channel, payload) => {
+            if (!isDesktopChannel(channel))
+                return native.invoke(channel, payload);
+            if (!client.isOpen() && !(await ensureConnected()))
+                throw new NativeUnavailableError(channel);
+            try {
+                return await client.invoke(channel, payload);
+            }
+            catch (e) {
+                // Mid-session drop: surface the overlay, reconnect to the same host, retry once.
+                if (!client.isOpen() && (await ensureConnected()))
+                    return client.invoke(channel, payload);
+                throw e;
+            }
+        }),
+    };
+}
+/**
+ * One-call client bootstrap: build the WebRTC proxy client (signer = the native keychain
+ * channel, events fed back to the subscribe bus) and return an UglyNative that lazily
+ * connects + proxies desktop capabilities. Mobile/web shells call this once at startup and
+ * assign the result to `globalThis.UglyNative`.
+ */
+export function installProxyClient(opts) {
+    const win = opts.win ?? globalThis;
+    const client = createProxyClient({
+        socket: opts.socket,
+        selfDeviceId: opts.selfDeviceId,
+        signer: nativeSigner(opts.native),
+        iceServers: opts.iceServers,
+        rtcFactory: opts.rtcFactory,
+        onEvent: (event, data) => dispatchNativeEvent(win, event, data),
+    });
+    return enableUglyProxy({ native: opts.native, client });
+}
 /** Dispatch a proxy event onto the same 'uglyNative' CustomEvent bus base.subscribe reads. */
 export function dispatchNativeEvent(win, event, data) {
     const detail = { event, data };

package/dist/native/proxy.js.map

@@ -1 +1 @@
-{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../src/native/proxy.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAGvD,4FAA4F;AAC5F,MAAM,CAAC,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC;IAC7D,IAAI;IACJ,SAAS;IACT,KAAK;IACL,OAAO;IACP,SAAS;IACT,UAAU;IACV,SAAS;IACT,KAAK;IACL,SAAS;IACT,QAAQ;IACR,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACpF,OAAO,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACpC,CAAC;AAcD;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAgB,EAAE,IAAmB;IAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACvG,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,CAAC,CAAC,OAAe,EAAE,OAAgB,EAAE,EAAE;YAC7C,IAAI,WAAW,CAAC,OAAO,CAAC;gBAAE,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACtE,IAAI,IAAI,CAAC,wBAAwB,IAAI,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/D,0EAA0E;gBAC1E,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;YAC7D,CAAC;YACD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAgB,EAAE,OAAgB,CAAC,CAAC;QACzD,CAAC,CAAyB;QAC1B,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC;AACJ,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,mBAAmB,CACjC,GAA2C,EAC3C,KAAa,EACb,IAAa;IAEb,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC/B,MAAM,EAAE,GACN,OAAO,WAAW,KAAK,UAAU;QAC/B,CAAC,CAAC,IAAI,WAAW,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC;QAC3C,CAAC,CAAE,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAuB,CAAC;IAC3D,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC"}
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../src/native/proxy.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugly-app",
-  "version": "0.1.682",
+  "version": "0.1.684",
   "type": "module",
   "comment:files": "Allowlist what ships to npm. dist = runtime; src = sourcemap targets (dist/*.js.map reference ../../src/); templates = CLI scaffold. Everything else at repo root (.pgdata local Postgres, coverage, assets/icons sources, test/, test-results/) is excluded by omission. The !negations strip the scaffold's installed deps + cruft (templates/node_modules is 200MB+ and must never ship). package.json/README/LICENSE ship automatically.",
   "files": [

package/src/cli/version.ts

@@ -1,2 +1,2 @@
 // Auto-generated by prebuild — do not edit manually
-export const CLI_VERSION = "0.1.682";
+export const CLI_VERSION = "0.1.684";

package/src/native/index.ts

@@ -58,7 +58,7 @@ export type {
   HostInfo,
   RTCFactory,
 } from './proxyClient.js';
-export { isDesktopChannel, withProxy, dispatchNativeEvent, DESKTOP_NAMESPACES } from './proxy.js';
+export { isDesktopChannel, withProxy, enableUglyProxy, installProxyClient, dispatchNativeEvent, DESKTOP_NAMESPACES } from './proxy.js';
 export type { WithProxyOpts } from './proxy.js';
 export { fpTag, verifyFpTag, parseFingerprint, mskSigner } from './proxyCrypto.js';
 export type { ProxyRole, ProxySigner } from './proxyCrypto.js';

package/src/native/proxy.ts

@@ -5,7 +5,7 @@
 // base UglyNative with `withProxy(...)`; the core install.ts is untouched.
 import type { UglyNative } from './protocol.js';
 import { NativeUnavailableError } from './protocol.js';
-import type { ProxyClient } from './proxyClient.js';
+import { createProxyClient, nativeSigner, type ProxyClient, type ProxySocket, type HostInfo, type RTCFactory } from './proxyClient.js';
 
 /** Namespaces that require a desktop host (RCE-grade / filesystem / long-running tasks). */
 export const DESKTOP_NAMESPACES: ReadonlySet<string> = new Set([
@@ -60,6 +60,101 @@ export function withProxy(base: UglyNative, opts: WithProxyOpts): UglyNative {
   };
 }
 
+/**
+ * Full mobile/web client bootstrap: returns an UglyNative whose desktop-capability calls
+ * lazily connect to a host and proxy. On the first such call (no host yet) it drives the
+ * native host-picker (proxy.pickHost) + status overlay (proxy.setStatus); afterwards it
+ * reconnects to the same host silently. Device-capability calls stay local. Wire the
+ * client's `onEvent` to dispatchNativeEvent so host events reach `subscribe`.
+ */
+export function enableUglyProxy(opts: {
+  native: UglyNative;
+  client: ProxyClient;
+}): UglyNative {
+  const { native, client } = opts;
+  let connecting: Promise<boolean> | null = null;
+  let lastLabel: string | undefined;
+
+  const setStatus = (state: string, hostLabel?: string): void => {
+    void native.invoke('proxy.setStatus' as never, { state, hostLabel } as never).catch(() => {});
+  };
+
+  async function ensureConnected(): Promise<boolean> {
+    if (client.isOpen()) return true;
+    if (connecting) return connecting;
+    connecting = (async () => {
+      try {
+        const existing = client.hostDeviceId();
+        if (existing) {
+          // Silent reconnect to the previously chosen host.
+          setStatus('reconnecting', lastLabel);
+          await client.connect(existing);
+          setStatus('connected', lastLabel);
+          return true;
+        }
+        setStatus('connecting');
+        const hosts = await client.listHosts();
+        const picked = (await native.invoke('proxy.pickHost' as never, {
+          hosts: hosts.map((h: HostInfo) => ({ deviceId: h.deviceId, label: h.label, online: true, lastSeen: h.lastSeen })),
+        } as never)) as { deviceId: string } | null;
+        if (!picked) { setStatus('none'); return false; }
+        lastLabel = hosts.find((h) => h.deviceId === picked.deviceId)?.label;
+        await client.connect(picked.deviceId);
+        setStatus('connected', lastLabel);
+        return true;
+      } catch {
+        setStatus(client.hostDeviceId() ? 'offline' : 'none');
+        return false;
+      } finally {
+        connecting = null;
+      }
+    })();
+    return connecting;
+  }
+
+  return {
+    platform: native.platform,
+    subscribe: native.subscribe,
+    invoke: (async (channel: string, payload: unknown) => {
+      if (!isDesktopChannel(channel)) return native.invoke(channel as never, payload as never);
+      if (!client.isOpen() && !(await ensureConnected())) throw new NativeUnavailableError(channel);
+      try {
+        return await client.invoke(channel, payload);
+      } catch (e) {
+        // Mid-session drop: surface the overlay, reconnect to the same host, retry once.
+        if (!client.isOpen() && (await ensureConnected())) return client.invoke(channel, payload);
+        throw e;
+      }
+    }) as UglyNative['invoke'],
+  };
+}
+
+/**
+ * One-call client bootstrap: build the WebRTC proxy client (signer = the native keychain
+ * channel, events fed back to the subscribe bus) and return an UglyNative that lazily
+ * connects + proxies desktop capabilities. Mobile/web shells call this once at startup and
+ * assign the result to `globalThis.UglyNative`.
+ */
+export function installProxyClient(opts: {
+  native: UglyNative;
+  socket: ProxySocket;
+  selfDeviceId: string;
+  iceServers?: RTCIceServer[];
+  rtcFactory?: RTCFactory;
+  win?: { dispatchEvent(e: unknown): boolean };
+}): UglyNative {
+  const win = opts.win ?? (globalThis as unknown as { dispatchEvent(e: unknown): boolean });
+  const client = createProxyClient({
+    socket: opts.socket,
+    selfDeviceId: opts.selfDeviceId,
+    signer: nativeSigner(opts.native),
+    iceServers: opts.iceServers,
+    rtcFactory: opts.rtcFactory,
+    onEvent: (event, data) => dispatchNativeEvent(win, event, data),
+  });
+  return enableUglyProxy({ native: opts.native, client });
+}
+
 /** Dispatch a proxy event onto the same 'uglyNative' CustomEvent bus base.subscribe reads. */
 export function dispatchNativeEvent(
   win: { dispatchEvent(e: unknown): boolean },

package/src/native/proxyBootstrap.test.ts

@@ -0,0 +1,84 @@
+import { describe, it, expect, vi } from 'vitest';
+import { enableUglyProxy } from './proxy.js';
+import { NativeUnavailableError } from './protocol.js';
+import type { UglyNative } from './protocol.js';
+import type { ProxyClient } from './proxyClient.js';
+
+function fakeNative(pick: { deviceId: string } | null): {
+  native: UglyNative;
+  calls: Array<{ channel: string; payload: unknown }>;
+} {
+  const calls: Array<{ channel: string; payload: unknown }> = [];
+  const native: UglyNative = {
+    platform: 'ios',
+    subscribe: vi.fn(() => () => {}) as unknown as UglyNative['subscribe'],
+    invoke: (async (channel: string, payload: unknown) => {
+      calls.push({ channel, payload });
+      if (channel === 'proxy.pickHost') return pick;
+      if (channel === 'proxy.setStatus') return undefined;
+      return { local: channel }; // device-cap local impl
+    }) as unknown as UglyNative['invoke'],
+  };
+  return { native, calls };
+}
+
+function fakeClient(): ProxyClient & { _open: boolean; _host: string | null } {
+  const c = {
+    _open: false,
+    _host: null as string | null,
+    listHosts: vi.fn(async () => [{ deviceId: 'h1', label: 'My Mac', isHost: true, lastSeen: 1 }]),
+    connect: vi.fn(async (id: string) => { c._open = true; c._host = id; }),
+    invoke: vi.fn(async (channel: string, payload: unknown) => ({ proxied: channel, payload })),
+    subscribe: vi.fn(async () => ({ snapshot: undefined, unsubscribe: () => {} })),
+    isOpen: () => c._open,
+    hostDeviceId: () => c._host,
+    close: () => { c._open = false; },
+  };
+  return c as ProxyClient & { _open: boolean; _host: string | null };
+}
+
+const statuses = (calls: Array<{ channel: string; payload: unknown }>) =>
+  calls.filter((c) => c.channel === 'proxy.setStatus').map((c) => (c.payload as { state: string }).state);
+
+describe('enableUglyProxy', () => {
+  it('keeps device-cap calls local', async () => {
+    const { native } = fakeNative({ deviceId: 'h1' });
+    const client = fakeClient();
+    const n = enableUglyProxy({ native, client });
+    expect(await n.invoke('clipboard.write' as never, { text: 'x' } as never)).toEqual({ local: 'clipboard.write' });
+    expect(client.connect).not.toHaveBeenCalled();
+  });
+
+  it('on first desktop-cap call: picks a host, connects, proxies, and reports status', async () => {
+    const { native, calls } = fakeNative({ deviceId: 'h1' });
+    const client = fakeClient();
+    const n = enableUglyProxy({ native, client });
+    const r = await n.invoke('fs.readFile' as never, { path: '/p' } as never);
+    expect(client.listHosts).toHaveBeenCalled();
+    expect(calls.some((c) => c.channel === 'proxy.pickHost')).toBe(true);
+    expect(client.connect).toHaveBeenCalledWith('h1');
+    expect(r).toEqual({ proxied: 'fs.readFile', payload: { path: '/p' } });
+    expect(statuses(calls)).toEqual(['connecting', 'connected']);
+  });
+
+  it('throws + reports none when the user cancels the picker', async () => {
+    const { native, calls } = fakeNative(null);
+    const client = fakeClient();
+    const n = enableUglyProxy({ native, client });
+    await expect(n.invoke('process.spawn' as never, {} as never)).rejects.toBeInstanceOf(NativeUnavailableError);
+    expect(client.connect).not.toHaveBeenCalled();
+    expect(statuses(calls)).toEqual(['connecting', 'none']);
+  });
+
+  it('reconnects silently to the same host on a later call (no re-pick)', async () => {
+    const { native, calls } = fakeNative({ deviceId: 'h1' });
+    const client = fakeClient();
+    const n = enableUglyProxy({ native, client });
+    await n.invoke('fs.readFile' as never, {} as never); // connect once
+    client._open = false; // simulate drop
+    const r = await n.invoke('fs.readFile' as never, { again: true } as never);
+    expect(r).toMatchObject({ proxied: 'fs.readFile' });
+    expect(calls.filter((c) => c.channel === 'proxy.pickHost')).toHaveLength(1); // only the first time
+    expect(statuses(calls)).toEqual(['connecting', 'connected', 'reconnecting', 'connected']);
+  });
+});