@pollen-robotics/reachy-mini-sdk 1.9.0 → 1.10.0-dev.0.main.60dddbe

package/host/dist/chunks/{reachy-mini-CdsdQLIU.js → reachy-mini-DCbCDwyd.js}

@@ -1,4 +1,4 @@
-var $ = Object.defineProperty, F = (r, e, t) => e in r ? $(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t, k = (r, e, t) => (F(r, typeof e != "symbol" ? e + "" : e, t), t), x = "https://huggingface.co";
+var H = Object.defineProperty, $ = (r, e, t) => e in r ? H(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t, k = (r, e, t) => ($(r, typeof e != "symbol" ? e + "" : e, t), t), D = "https://huggingface.co";
 async function C(r, e) {
   var t, s;
   const i = new O(r.url, r.status, (t = r.headers.get("X-Request-Id")) != null ? t : void 0);
@@ -18,7 +18,7 @@ var O = class extends Error {
 };
 new Promise((r) => {
 });
-function H(r) {
+function x(r) {
   if (globalThis.Buffer)
     return globalThis.Buffer.from(r).toString("base64");
   {
@@ -40,28 +40,28 @@ async function M(r) {
     throw new Error("Missing oauth code from query parameters in redirected URL");
   if (!a)
     throw new Error("Missing oauth nonce from localStorage");
-  const c = localStorage.getItem("huggingface.co:oauth:code_verifier");
-  if (!c)
-    throw new Error("Missing oauth code_verifier from localStorage");
-  const l = s.get("state");
+  const l = localStorage.getItem("huggingface.co:oauth:code_verifier");
   if (!l)
+    throw new Error("Missing oauth code_verifier from localStorage");
+  const c = s.get("state");
+  if (!c)
     throw new Error("Missing oauth state from query parameters in redirected URL");
   let h;
   try {
-    h = JSON.parse(l);
+    h = JSON.parse(c);
   } catch {
-    throw new Error("Invalid oauth state in redirected URL, unable to parse JSON: " + l);
+    throw new Error("Invalid oauth state in redirected URL, unable to parse JSON: " + c);
   }
   if (h.nonce !== a)
     throw new Error("Invalid oauth state in redirected URL");
-  const d = x, m = `${new URL(d).origin}/.well-known/openid-configuration`, f = await fetch(m, {
+  const d = D, m = `${new URL(d).origin}/.well-known/openid-configuration`, f = await fetch(m, {
     headers: {
       Accept: "application/json"
     }
   });
   if (!f.ok)
     throw await C(f);
-  const p = await f.json(), v = await fetch(p.token_endpoint, {
+  const p = await f.json(), y = await fetch(p.token_endpoint, {
     method: "POST",
     headers: {
       "Content-Type": "application/x-www-form-urlencoded"
@@ -70,12 +70,12 @@ async function M(r) {
       grant_type: "authorization_code",
       code: n,
       redirect_uri: h.redirectUri,
-      code_verifier: c
+      code_verifier: l
     }).toString()
   });
-  if (localStorage.removeItem("huggingface.co:oauth:code_verifier"), localStorage.removeItem("huggingface.co:oauth:nonce"), !v.ok)
-    throw await C(v);
-  const g = await v.json(), w = new Date(Date.now() + g.expires_in * 1e3), S = await fetch(p.userinfo_endpoint, {
+  if (localStorage.removeItem("huggingface.co:oauth:code_verifier"), localStorage.removeItem("huggingface.co:oauth:nonce"), !y.ok)
+    throw await C(y);
+  const g = await y.json(), w = new Date(Date.now() + g.expires_in * 1e3), S = await fetch(p.userinfo_endpoint, {
     headers: {
       Authorization: `Bearer ${g.access_token}`
     }
@@ -109,7 +109,7 @@ async function M(r) {
     scope: g.scope
   };
 }
-async function N(r) {
+async function F(r) {
   if (typeof window > "u")
     throw new Error("oauthHandleRedirect is only available in the browser");
   const e = new URLSearchParams(window.location.search);
@@ -121,30 +121,30 @@ async function V(r) {
   var e, t;
   if (typeof window > "u")
     throw new Error("oauthLogin is only available in the browser");
-  const s = r?.hubUrl || x, i = `${new URL(s).origin}/.well-known/openid-configuration`, o = await fetch(i, {
+  const s = r?.hubUrl || D, i = `${new URL(s).origin}/.well-known/openid-configuration`, o = await fetch(i, {
     headers: {
       Accept: "application/json"
     }
   });
   if (!o.ok)
     throw await C(o);
-  const n = await o.json(), a = globalThis.crypto.randomUUID(), c = globalThis.crypto.randomUUID() + globalThis.crypto.randomUUID();
-  localStorage.setItem("huggingface.co:oauth:nonce", a), localStorage.setItem("huggingface.co:oauth:code_verifier", c);
-  const l = r?.redirectUrl || window.location.href, h = JSON.stringify({
+  const n = await o.json(), a = globalThis.crypto.randomUUID(), l = globalThis.crypto.randomUUID() + globalThis.crypto.randomUUID();
+  localStorage.setItem("huggingface.co:oauth:nonce", a), localStorage.setItem("huggingface.co:oauth:code_verifier", l);
+  const c = r?.redirectUrl || window.location.href, h = JSON.stringify({
     nonce: a,
-    redirectUri: l,
+    redirectUri: c,
     state: r?.state
   }), d = (t = (e = window?.huggingface) == null ? void 0 : e.variables) != null ? t : null, m = r?.clientId || d?.OAUTH_CLIENT_ID;
   if (!m)
     throw d ? new Error("Missing clientId, please add hf_oauth: true to the README.md's metadata in your static Space") : new Error("Missing clientId");
-  const f = H(
-    new Uint8Array(await globalThis.crypto.subtle.digest("SHA-256", new TextEncoder().encode(c)))
+  const f = x(
+    new Uint8Array(await globalThis.crypto.subtle.digest("SHA-256", new TextEncoder().encode(l)))
   ).replace(/[+]/g, "-").replace(/[/]/g, "_").replace(/=/g, "");
   return `${n.authorization_endpoint}?${new URLSearchParams({
     client_id: m,
     scope: r?.scopes || d?.OAUTH_SCOPES || "openid profile",
     response_type: "code",
-    redirect_uri: l,
+    redirect_uri: c,
     state: h,
     code_challenge: f,
     code_challenge_method: "S256"
@@ -154,11 +154,11 @@ function R(r) {
   return r * Math.PI / 180;
 }
 function B(r, e, t) {
-  const s = R(r), i = R(e), o = R(t), n = Math.cos(o), a = Math.sin(o), c = Math.cos(i), l = Math.sin(i), h = Math.cos(s), d = Math.sin(s);
+  const s = R(r), i = R(e), o = R(t), n = Math.cos(o), a = Math.sin(o), l = Math.cos(i), c = Math.sin(i), h = Math.cos(s), d = Math.sin(s);
   return [
-    [n * c, n * l * d - a * h, n * l * h + a * d, 0],
-    [a * c, a * l * d + n * h, a * l * h - n * d, 0],
-    [-l, c * d, c * h, 0],
+    [n * l, n * c * d - a * h, n * c * h + a * d, 0],
+    [a * l, a * c * d + n * h, a * c * h - n * d, 0],
+    [-c, l * d, l * h, 0],
     [0, 0, 0, 1]
   ];
 }
@@ -176,8 +176,8 @@ function G() {
   const s = e.get("hf_username") || "user", i = e.get("hf_token_expires"), o = i && !Number.isNaN(new Date(i).getTime()) ? i : new Date(Date.now() + 365 * 24 * 60 * 60 * 1e3).toISOString();
   try {
     sessionStorage.setItem("hf_token", t), sessionStorage.setItem("hf_username", s), sessionStorage.setItem("hf_token_expires", o);
-  } catch (c) {
-    console.warn("[reachy-mini] could not persist pre-seeded HF credentials:", c);
+  } catch (l) {
+    console.warn("[reachy-mini] could not persist pre-seeded HF credentials:", l);
   }
   e.delete("hf_token"), e.delete("hf_username"), e.delete("hf_token_expires");
   const n = e.toString(), a = window.location.pathname + window.location.search + (n ? "#" + n : "");
@@ -212,14 +212,14 @@ function W(r) {
     if (s.startsWith("m=audio") ? t = !0 : s.startsWith("m=") && (t = !1), t && s === "a=sendrecv") return !0;
   return !1;
 }
-const y = 12 * 1024, A = 1 * 1024 * 1024, z = 512 * 1024;
+const v = 12 * 1024, E = 1 * 1024 * 1024, z = 512 * 1024;
 function J() {
   return typeof CompressionStream < "u";
 }
 function U() {
   return "u" + Math.random().toString(36).slice(2, 11) + Date.now().toString(36);
 }
-function E(r) {
+function T(r) {
   let e = "";
   for (let s = 0; s < r.length; s += 32768)
     e += String.fromCharCode.apply(
@@ -232,7 +232,7 @@ async function X(r) {
   const e = new TextEncoder().encode(r), t = await new Response(
     new Blob([e]).stream().pipeThrough(new CompressionStream("gzip"))
   ).arrayBuffer();
-  return E(new Uint8Array(t));
+  return T(new Uint8Array(t));
 }
 function L(r) {
   const e = Math.round(Number(r) || 0);
@@ -261,8 +261,8 @@ function P(r) {
       return "wav-base64";
   }
 }
-const j = 3e3, D = 1e3, Y = 6e4;
-class K extends EventTarget {
+const j = 3e3, N = 1e3, Y = 6e4, K = 4e3;
+class Q extends EventTarget {
   // ─── Config ──────────────────────────────────────────────────────────
   _signalingUrl;
   _clientId;
@@ -301,6 +301,8 @@ class K extends EventTarget {
   _volumeResolve = null;
   _micVolumeResolve = null;
   _trackedFaceResolve = null;
+  _robotNameResolve = null;
+  _deleteHfTokenResolve = null;
   // applyAudioConfig() / readAudioParameter() share the same single-slot
   // pattern as the volume helpers. Separate slots so the two can be
   // in-flight concurrently without collision.
@@ -309,6 +311,13 @@ class K extends EventTarget {
   // ─── Log subscribers ─────────────────────────────────────────────────
   _logSubscribers = /* @__PURE__ */ new Set();
   _updateProgressSubscribers = /* @__PURE__ */ new Set();
+  // ─── JSON-RPC app control (over the same DataChannel) ────────────────
+  // rpcCall() sends {jsonrpc,id,method,params} and awaits the matching
+  // response; onNotification() subscribes to one-way events (no id) the
+  // robot/app pushes (conversation.phase/turn/transcript, ...).
+  _rpcCounter = 0;
+  _pendingRpc = /* @__PURE__ */ new Map();
+  _rpcListeners = /* @__PURE__ */ new Map();
   // ─── Broadcast waiters (playMove / playUploadedAudio) ────────────────
   _broadcastWaiters = [];
   // ─── Active upload ids for no-arg cancels ────────────────────────────
@@ -393,7 +402,7 @@ class K extends EventTarget {
   async authenticate() {
     try {
       G();
-      const e = await N();
+      const e = await F();
       if (e)
         return this._username = e.userInfo.preferred_username || e.userInfo.name || null, this._token = e.accessToken, this._tokenExpires = e.accessTokenExpiresAt, sessionStorage.setItem("hf_token", this._token), sessionStorage.setItem("hf_username", this._username ?? ""), sessionStorage.setItem(
           "hf_token_expires",
@@ -434,16 +443,16 @@ class K extends EventTarget {
     return new Promise((s, i) => {
       let o = !1;
       const n = t.body.getReader(), a = new TextDecoder();
-      let c = "";
+      let l = "";
       (async () => {
         try {
           for (; ; ) {
             const { done: h, value: d } = await n.read();
             if (h) break;
-            c += a.decode(d, { stream: !0 });
-            const m = c.split(`
+            l += a.decode(d, { stream: !0 });
+            const m = l.split(`
 `);
-            c = m.pop() ?? "";
+            l = m.pop() ?? "";
             for (const f of m)
               if (f.startsWith("data:"))
                 try {
@@ -475,10 +484,10 @@ class K extends EventTarget {
       wakeOnConnect: n = !0
     } = e;
     if (this._state === "streaming") {
-      const c = this._robots?.find((l) => l.id === this._selectedRobotId);
+      const l = this._robots?.find((c) => c.id === this._selectedRobotId);
       return {
         robotId: this._selectedRobotId,
-        robotName: c?.meta?.name ?? null,
+        robotName: l?.meta?.name ?? null,
         isEmbedded: this.isEmbedded,
         alreadyStreaming: !0
       };
@@ -491,36 +500,36 @@ class K extends EventTarget {
       else if (!this._token && !await this.authenticate())
         throw new Error("Not authenticated — call login() or pass a token");
       this._state === "disconnected" && await this.connect();
-      let c, l = null;
+      let l, c = null;
       if (this.isEmbedded) {
-        c = this._preselectedRobotId;
+        l = this._preselectedRobotId;
         try {
-          await this._waitForRobotInList(c, 5e3);
+          await this._waitForRobotInList(l, 5e3);
         } catch {
         }
-        l = this._robots?.find((d) => d.id === c)?.meta?.name ?? null;
+        c = this._robots?.find((d) => d.id === l)?.meta?.name ?? null;
       } else {
         const h = await this._fetchOwnedRobots({ filterBusy: o });
         if (h.length === 0)
           throw new Error("No reachable robots");
         if (i && h.length === 1 && !h[0].busy)
-          c = h[0].id, l = h[0].name;
+          l = h[0].id, c = h[0].name;
         else if (s) {
           const d = await s(h);
           if (!d) throw new Error("Robot selection cancelled");
-          c = d, l = h.find((m) => m.id === d)?.name ?? null;
+          l = d, c = h.find((m) => m.id === d)?.name ?? null;
         } else
           throw new Error(
             "Multiple robots available — pass a pickRobot callback to autoConnect()"
           );
       }
-      if (await this.startSession(c), n && typeof this.ensureAwake == "function")
+      if (await this.startSession(l), n && typeof this.ensureAwake == "function")
         try {
           await this.ensureAwake();
         } catch (h) {
           console.warn("[reachy-mini] autoConnect: ensureAwake failed:", h);
         }
-      return { robotId: c, robotName: l, isEmbedded: this.isEmbedded };
+      return { robotId: l, robotName: c, isEmbedded: this.isEmbedded };
     } finally {
       this._autoStartFromUrl = a;
     }
@@ -576,10 +585,10 @@ class K extends EventTarget {
       if (!s) throw new Error("AudioContext not supported");
       const i = new s(), o = i.createMediaStreamDestination(), n = i.createOscillator(), a = i.createGain();
       a.gain.value = 0, n.connect(a).connect(o), n.start();
-      const c = o.stream;
-      c.getAudioTracks().forEach((l) => {
-        l.enabled = !1;
-      }), this._micStream = c, this._micMuted = !0;
+      const l = o.stream;
+      l.getAudioTracks().forEach((c) => {
+        c.enabled = !1;
+      }), this._micStream = l, this._micMuted = !0;
     } catch (t) {
       console.warn("Audio sender placeholder setup failed:", t), this._micStream = null;
     }
@@ -621,7 +630,7 @@ class K extends EventTarget {
             return;
           }
           if (i === "failed") {
-            this._scheduleIceGrace(D, "failed");
+            this._scheduleIceGrace(N, "failed");
             return;
           }
         }
@@ -648,10 +657,10 @@ class K extends EventTarget {
     }
   }
   async stopSession() {
-    this._versionResolve && (this._versionResolve(null), this._versionResolve = null), this._hardwareIdResolve && (this._hardwareIdResolve(null), this._hardwareIdResolve = null), this._volumeResolve && (this._volumeResolve(null), this._volumeResolve = null), this._micVolumeResolve && (this._micVolumeResolve(null), this._micVolumeResolve = null), this._trackedFaceResolve && (this._trackedFaceResolve(null), this._trackedFaceResolve = null), this._applyAudioConfigResolve && (this._applyAudioConfigResolve(!1), this._applyAudioConfigResolve = null), this._readAudioParameterResolve && (this._readAudioParameterResolve(null), this._readAudioParameterResolve = null), this._logSubscribers.clear(), this._updateProgressSubscribers.clear(), this._rejectPendingMotionCompletions(new Error("Session stopped")), this._clearIceGrace(), this._uninstallNetworkListeners(), this._sessionReject && (this._sessionReject(new Error("Session stopped")), this._sessionResolve = null, this._sessionReject = null), this._stateRefreshInterval && (clearInterval(this._stateRefreshInterval), this._stateRefreshInterval = null), this._latencyMonitorId && (clearInterval(this._latencyMonitorId), this._latencyMonitorId = null), this._sessionId && await this._sendToServer({ type: "endSession", sessionId: this._sessionId }), this._micStream && (this._micStream.getTracks().forEach((t) => t.stop()), this._micStream = null), this._micMuted = !0, this._micSupported = !1, this._pc && (this._pc.close(), this._pc = null), this._dc && (this._dc.close(), this._dc = null), this._sessionId = null, this._iceConnected = !1, this._dcOpen = !1, this._state === "streaming" && (this._state = "connected", this._emit("sessionStopped", { reason: "user" }));
+    this._versionResolve && (this._versionResolve(null), this._versionResolve = null), this._hardwareIdResolve && (this._hardwareIdResolve(null), this._hardwareIdResolve = null), this._volumeResolve && (this._volumeResolve(null), this._volumeResolve = null), this._micVolumeResolve && (this._micVolumeResolve(null), this._micVolumeResolve = null), this._trackedFaceResolve && (this._trackedFaceResolve(null), this._trackedFaceResolve = null), this._applyAudioConfigResolve && (this._applyAudioConfigResolve(!1), this._applyAudioConfigResolve = null), this._readAudioParameterResolve && (this._readAudioParameterResolve(null), this._readAudioParameterResolve = null), this._robotNameResolve && (this._robotNameResolve(null), this._robotNameResolve = null), this._deleteHfTokenResolve && (this._deleteHfTokenResolve(null), this._deleteHfTokenResolve = null), this._logSubscribers.clear(), this._updateProgressSubscribers.clear(), this._rejectPendingMotionCompletions(new Error("Session stopped")), this._rejectPendingRpc(new Error("Session stopped")), this._clearIceGrace(), this._uninstallNetworkListeners(), this._sessionReject && (this._sessionReject(new Error("Session stopped")), this._sessionResolve = null, this._sessionReject = null), this._stateRefreshInterval && (clearInterval(this._stateRefreshInterval), this._stateRefreshInterval = null), this._latencyMonitorId && (clearInterval(this._latencyMonitorId), this._latencyMonitorId = null), this._sessionId && await this._sendToServer({ type: "endSession", sessionId: this._sessionId }), this._micStream && (this._micStream.getTracks().forEach((t) => t.stop()), this._micStream = null), this._micMuted = !0, this._micSupported = !1, this._pc && (this._pc.close(), this._pc = null), this._dc && (this._dc.close(), this._dc = null), this._sessionId = null, this._iceConnected = !1, this._dcOpen = !1, this._state === "streaming" && (this._state = "connected", this._emit("sessionStopped", { reason: "user" }));
   }
   disconnect() {
-    this._sseAbortController && (this._sseAbortController.abort(), this._sseAbortController = null), this._versionResolve && (this._versionResolve(null), this._versionResolve = null), this._hardwareIdResolve && (this._hardwareIdResolve(null), this._hardwareIdResolve = null), this._volumeResolve && (this._volumeResolve(null), this._volumeResolve = null), this._micVolumeResolve && (this._micVolumeResolve(null), this._micVolumeResolve = null), this._trackedFaceResolve && (this._trackedFaceResolve(null), this._trackedFaceResolve = null), this._applyAudioConfigResolve && (this._applyAudioConfigResolve(!1), this._applyAudioConfigResolve = null), this._readAudioParameterResolve && (this._readAudioParameterResolve(null), this._readAudioParameterResolve = null), this._logSubscribers.clear(), this._updateProgressSubscribers.clear(), this._rejectPendingMotionCompletions(new Error("Disconnected")), this._clearIceGrace(), this._uninstallNetworkListeners(), this._sessionReject && (this._sessionReject(new Error("Disconnected")), this._sessionResolve = null, this._sessionReject = null), this._stateRefreshInterval && (clearInterval(this._stateRefreshInterval), this._stateRefreshInterval = null), this._latencyMonitorId && (clearInterval(this._latencyMonitorId), this._latencyMonitorId = null), this._sessionId && this._token && this._sendToServer({ type: "endSession", sessionId: this._sessionId }), this._micStream && (this._micStream.getTracks().forEach((e) => e.stop()), this._micStream = null), this._pc && (this._pc.close(), this._pc = null), this._dc && (this._dc.close(), this._dc = null), this._sessionId = null, this._micMuted = !0, this._micSupported = !1, this._iceConnected = !1, this._dcOpen = !1, this._robots = [], this._state = "disconnected", this._emit("disconnected", { reason: "user" });
+    this._sseAbortController && (this._sseAbortController.abort(), this._sseAbortController = null), this._versionResolve && (this._versionResolve(null), this._versionResolve = null), this._hardwareIdResolve && (this._hardwareIdResolve(null), this._hardwareIdResolve = null), this._volumeResolve && (this._volumeResolve(null), this._volumeResolve = null), this._micVolumeResolve && (this._micVolumeResolve(null), this._micVolumeResolve = null), this._trackedFaceResolve && (this._trackedFaceResolve(null), this._trackedFaceResolve = null), this._applyAudioConfigResolve && (this._applyAudioConfigResolve(!1), this._applyAudioConfigResolve = null), this._readAudioParameterResolve && (this._readAudioParameterResolve(null), this._readAudioParameterResolve = null), this._robotNameResolve && (this._robotNameResolve(null), this._robotNameResolve = null), this._deleteHfTokenResolve && (this._deleteHfTokenResolve(null), this._deleteHfTokenResolve = null), this._logSubscribers.clear(), this._updateProgressSubscribers.clear(), this._rejectPendingMotionCompletions(new Error("Disconnected")), this._clearIceGrace(), this._uninstallNetworkListeners(), this._sessionReject && (this._sessionReject(new Error("Disconnected")), this._sessionResolve = null, this._sessionReject = null), this._stateRefreshInterval && (clearInterval(this._stateRefreshInterval), this._stateRefreshInterval = null), this._latencyMonitorId && (clearInterval(this._latencyMonitorId), this._latencyMonitorId = null), this._sessionId && this._token && this._sendToServer({ type: "endSession", sessionId: this._sessionId }), this._micStream && (this._micStream.getTracks().forEach((e) => e.stop()), this._micStream = null), this._pc && (this._pc.close(), this._pc = null), this._dc && (this._dc.close(), this._dc = null), this._sessionId = null, this._micMuted = !0, this._micSupported = !1, this._iceConnected = !1, this._dcOpen = !1, this._robots = [], this._state = "disconnected", this._emit("disconnected", { reason: "user" });
   }
   // ─── Resilience: ICE-blip debounce + network awareness ───────────────
   //
@@ -724,7 +733,7 @@ class K extends EventTarget {
           return;
         }
         if (s === "failed") {
-          this._scheduleIceGrace(D, "failed");
+          this._scheduleIceGrace(N, "failed");
           return;
         }
         this._scheduleIceGrace(j, "disconnected");
@@ -1026,6 +1035,61 @@ class K extends EventTarget {
       { type: "set_microphone_volume", volume: L(e) }
     );
   }
+  /**
+   * Query the persisted robot display name. Resolves the stored name,
+   * `null` when none is set / the channel isn't open / the daemon predates
+   * the `get_robot_name` command.
+   */
+  getRobotName() {
+    return this._slotRoundtrip(
+      () => this._robotNameResolve,
+      (e) => {
+        this._robotNameResolve = e;
+      },
+      { type: "get_robot_name" }
+    );
+  }
+  /**
+   * Set and persist the robot display name on the robot. Resolves with the
+   * stored (trimmed) name, or `null` on error / channel-closed. Applied live
+   * by the daemon (status + central relay + mDNS), so it takes effect right
+   * away without a restart; the persisted name also overrides --robot-name
+   * on the next start.
+   */
+  setRobotName(e) {
+    return this._slotRoundtrip(
+      () => this._robotNameResolve,
+      (t) => {
+        this._robotNameResolve = t;
+      },
+      { type: "set_robot_name", name: e }
+    );
+  }
+  /**
+   * Sign this robot out of Hugging Face: asks the daemon to delete its
+   * stored HF token, which de-registers the robot from the central
+   * signaling relay (it disappears from its owner's robot list until it
+   * is set up again). Works over the WebRTC data channel, so it reaches
+   * the robot remotely (no LAN HTTP path required).
+   *
+   * Resolves `true` when the daemon acked success, `false` on a daemon
+   * error, or `null` when no ack arrives before the timeout (e.g. a
+   * daemon that predates the `delete_hf_token` command silently drops
+   * it). Rejects if the data channel isn't open. Note the sign-out
+   * drops the central relay, so the session may tear down right after
+   * the ack - callers should treat a post-call session drop as expected,
+   * and a successful sign-out may surface as `null` if teardown races
+   * ahead of the ack.
+   */
+  signOut() {
+    return this._slotRoundtrip(
+      () => this._deleteHfTokenResolve,
+      (e) => {
+        this._deleteHfTokenResolve = e;
+      },
+      { type: "delete_hf_token" }
+    );
+  }
   applyAudioConfig(e, { verify: t = !0 } = {}) {
     return this._slotRoundtrip(
       () => this._applyAudioConfigResolve,
@@ -1065,7 +1129,12 @@ class K extends EventTarget {
         return;
       }
       const n = e();
-      n && n(null), t(i), this._sendCommand(s);
+      n && n(null);
+      let a;
+      const l = (c) => {
+        a !== void 0 && (clearTimeout(a), a = void 0), e() === l && t(null), i(c);
+      };
+      t(l), a = setTimeout(() => l(null), K), this._sendCommand(s);
     });
   }
   sendRaw(e) {
@@ -1114,8 +1183,8 @@ class K extends EventTarget {
     encoding: o = "gzip+base64",
     playFrequency: n = 100,
     initialGotoDuration: a = 0,
-    startTimeoutMs: c = 8e3,
-    onProgress: l = () => {
+    startTimeoutMs: l = 8e3,
+    onProgress: c = () => {
     },
     onStarted: h = () => {
     }
@@ -1131,35 +1200,35 @@ class K extends EventTarget {
       time: e.time,
       set_target_data: e.set_target_data
     }, f = JSON.stringify(m);
-    let p, v;
-    o === "gzip+base64" && J() ? (p = await X(f), v = "gzip+base64") : (p = f, v = "json");
-    const g = Math.ceil(p.length / y) || 1;
-    l({
+    let p, y;
+    o === "gzip+base64" && J() ? (p = await X(f), y = "gzip+base64") : (p = f, y = "json");
+    const g = Math.ceil(p.length / v) || 1;
+    c({
       phase: "starting",
       sent: 0,
       total: g,
       bytes: p.length,
-      encoding: v
+      encoding: y
     }), this._sendCommand({
       type: "upload_move_start",
       upload_id: d,
       total_chunks: g,
       description: i,
-      encoding: v
+      encoding: y
     });
     for (let u = 0; u < g; u++) {
-      this._dc.bufferedAmount > A && await this._awaitDataChannelDrain();
-      const _ = u * y;
+      this._dc.bufferedAmount > E && await this._awaitDataChannelDrain();
+      const _ = u * v;
       this._sendCommand({
         type: "upload_move_chunk",
         upload_id: d,
         chunk_index: u,
-        chunk: p.slice(_, _ + y)
-      }), l({ phase: "upload", sent: u + 1, total: g });
+        chunk: p.slice(_, _ + v)
+      }), c({ phase: "upload", sent: u + 1, total: g });
     }
-    if (this._sendCommand({ type: "upload_move_finish", upload_id: d }), l({ phase: "uploaded", sent: g, total: g }), t) {
-      const u = new Uint8Array(await t.arrayBuffer()), _ = E(u), b = Math.ceil(_.length / y) || 1;
-      l({
+    if (this._sendCommand({ type: "upload_move_finish", upload_id: d }), c({ phase: "uploaded", sent: g, total: g }), t) {
+      const u = new Uint8Array(await t.arrayBuffer()), _ = T(u), b = Math.ceil(_.length / v) || 1;
+      c({
         phase: "audio-starting",
         sent: 0,
         total: b,
@@ -1172,16 +1241,16 @@ class K extends EventTarget {
         description: i
       });
       for (let I = 0; I < b; I++) {
-        this._dc.bufferedAmount > A && await this._awaitDataChannelDrain();
-        const T = I * y;
+        this._dc.bufferedAmount > E && await this._awaitDataChannelDrain();
+        const A = I * v;
         this._sendCommand({
           type: "upload_audio_chunk",
           upload_id: d,
           chunk_index: I,
-          chunk: _.slice(T, T + y)
-        }), l({ phase: "audio-upload", sent: I + 1, total: b });
+          chunk: _.slice(A, A + v)
+        }), c({ phase: "audio-upload", sent: I + 1, total: b });
       }
-      this._sendCommand({ type: "upload_audio_finish", upload_id: d }), l({ phase: "audio-uploaded", sent: b, total: b });
+      this._sendCommand({ type: "upload_audio_finish", upload_id: d }), c({ phase: "audio-uploaded", sent: b, total: b });
     }
     this._sendCommand({
       type: "play_uploaded_move",
@@ -1194,7 +1263,7 @@ class K extends EventTarget {
     try {
       w = await this._waitForBroadcast(
         (u) => u?.type === "play_uploaded_move" && u?.upload_id === d && (u.started === !0 || typeof u.error == "string"),
-        { timeoutMs: c, debugLabel: "play_uploaded_move started" }
+        { timeoutMs: l, debugLabel: "play_uploaded_move started" }
       );
     } catch (u) {
       throw new Error(
@@ -1211,7 +1280,7 @@ class K extends EventTarget {
     } catch (u) {
       console.warn("playMove.onStarted threw:", u);
     }
-    l({ phase: "playing", duration_s: w.duration_s });
+    c({ phase: "playing", duration_s: w.duration_s });
     const S = await this._waitForBroadcast(
       (u) => u?.type === "play_uploaded_move" && u?.upload_id === d && (u.finished === !0 || u.cancelled === !0 || typeof u.error == "string"),
       {
@@ -1231,7 +1300,7 @@ class K extends EventTarget {
       throw new Error("data channel not open");
     if (!(e instanceof Blob))
       throw new TypeError("uploadAudio: expected a Blob");
-    const i = U(), o = new Uint8Array(await e.arrayBuffer()), n = E(o), a = Math.ceil(n.length / y) || 1;
+    const i = U(), o = new Uint8Array(await e.arrayBuffer()), n = T(o), a = Math.ceil(n.length / v) || 1;
     s({ phase: "audio-starting", sent: 0, total: a, bytes: n.length }), this._sendCommand({
       type: "upload_audio_start",
       upload_id: i,
@@ -1239,15 +1308,15 @@ class K extends EventTarget {
       encoding: P(e),
       description: t
     });
-    for (let c = 0; c < a; c++) {
-      this._dc.bufferedAmount > A && await this._awaitDataChannelDrain();
-      const l = c * y;
+    for (let l = 0; l < a; l++) {
+      this._dc.bufferedAmount > E && await this._awaitDataChannelDrain();
+      const c = l * v;
       this._sendCommand({
         type: "upload_audio_chunk",
         upload_id: i,
-        chunk_index: c,
-        chunk: n.slice(l, l + y)
-      }), s({ phase: "audio-upload", sent: c + 1, total: a });
+        chunk_index: l,
+        chunk: n.slice(c, c + v)
+      }), s({ phase: "audio-upload", sent: l + 1, total: a });
     }
     return this._sendCommand({ type: "upload_audio_finish", upload_id: i }), s({ phase: "audio-uploaded", sent: a, total: a }), i;
   }
@@ -1318,6 +1387,62 @@ class K extends EventTarget {
   _sendCommand(e) {
     return !this._dc || this._dc.readyState !== "open" ? !1 : (this._dc.send(JSON.stringify(e)), !0);
   }
+  /**
+   * Call a JSON-RPC method on the robot/app over the DataChannel and await
+   * its result. This is the one way to drive an on-robot app (start/stop it
+   * via `apps.*`, or drive a running app via its own namespace, e.g.
+   * `conversation.say`). Rejects on the JSON-RPC error, a closed channel, or
+   * timeout.
+   */
+  rpcCall(e, t = {}, s = {}) {
+    const i = s.timeoutMs ?? 2e4, o = `rpc-${++this._rpcCounter}`;
+    return this._sendCommand({ jsonrpc: "2.0", id: o, method: e, params: t }) ? new Promise((n, a) => {
+      const l = setTimeout(() => {
+        this._pendingRpc.delete(o), a(new Error(`rpcCall(${e}) timed out after ${i}ms`));
+      }, i);
+      this._pendingRpc.set(o, {
+        resolve: (c) => n(c),
+        reject: a,
+        timer: l
+      });
+    }) : Promise.reject(new Error(`rpcCall(${e}): data channel not open`));
+  }
+  /**
+   * Subscribe to a JSON-RPC notification (one-way event) pushed by the
+   * robot/app, e.g. `conversation.turn`. Returns an unsubscribe function.
+   */
+  onNotification(e, t) {
+    let s = this._rpcListeners.get(e);
+    return s || (s = /* @__PURE__ */ new Set(), this._rpcListeners.set(e, s)), s.add(t), () => {
+      this._rpcListeners.get(e)?.delete(t);
+    };
+  }
+  _rejectPendingRpc(e) {
+    for (const t of this._pendingRpc.values())
+      clearTimeout(t.timer), t.reject(e);
+    this._pendingRpc.clear();
+  }
+  _handleRpcMessage(e) {
+    if ("id" in e && e.id != null && ("result" in e || "error" in e)) {
+      const t = this._pendingRpc.get(e.id);
+      if (!t) return;
+      if (this._pendingRpc.delete(e.id), clearTimeout(t.timer), "error" in e && e.error) {
+        const s = e.error, i = new Error(s.message ?? "rpc error");
+        i.reason = s.data?.reason, t.reject(i);
+      } else
+        t.resolve(e.result);
+      return;
+    }
+    if (typeof e.method == "string") {
+      const t = e.params ?? {};
+      for (const s of this._rpcListeners.get(e.method) ?? [])
+        try {
+          s(t);
+        } catch (i) {
+          console.error(`onNotification(${e.method}) threw:`, i);
+        }
+    }
+  }
   _checkSessionReady() {
     this._iceConnected && this._dcOpen && this._sessionResolve && (this._state = "streaming", this.requestState(), this._stateRefreshInterval = setInterval(() => this.requestState(), 500), this._emit("streaming", { sessionId: this._sessionId, robotId: this._selectedRobotId }), this._sessionResolve(), this._sessionResolve = null, this._sessionReject = null);
   }
@@ -1403,6 +1528,10 @@ class K extends EventTarget {
       }
   }
   _handleRobotMessage(e) {
+    if (e.jsonrpc === "2.0") {
+      this._handleRpcMessage(e);
+      return;
+    }
     if ("version" in e && this._versionResolve) {
       this._versionResolve(e.version), this._versionResolve = null;
       return;
@@ -1419,6 +1548,16 @@ class K extends EventTarget {
       this._micVolumeResolve && (this._micVolumeResolve(e.status === "error" ? null : e.volume), this._micVolumeResolve = null);
       return;
     }
+    if (e.command === "get_robot_name" || e.command === "set_robot_name") {
+      this._robotNameResolve && (this._robotNameResolve(
+        e.status === "error" ? null : e.name ?? null
+      ), this._robotNameResolve = null);
+      return;
+    }
+    if (e.command === "delete_hf_token") {
+      this._deleteHfTokenResolve && (this._deleteHfTokenResolve(e.status !== "error"), this._deleteHfTokenResolve = null);
+      return;
+    }
     if (e.command === "apply_audio_config") {
       this._applyAudioConfigResolve && (this._applyAudioConfigResolve(e.error ? !1 : !!e.applied), this._applyAudioConfigResolve = null);
       return;
@@ -1519,5 +1658,5 @@ class K extends EventTarget {
   }
 }
 export {
-  K as R
+  Q as R
 };

package/host/dist/components/ConnectingView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConnectingView.d.ts","sourceRoot":"","sources":["../../src/components/ConnectingView.tsx"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAIjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIzD,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC/B;;oCAEgC;IAChC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAiBD,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,OAAO,GACR,EAAE,mBAAmB,GAAG,GAAG,CAAC,OAAO,CA6FnC;AAkED,eAAO,MAAM,qBAAqB,qBAAa,CAAC"}
+{"version":3,"file":"ConnectingView.d.ts","sourceRoot":"","sources":["../../src/components/ConnectingView.tsx"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAIjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIzD,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC/B;;oCAEgC;IAChC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAiBD,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,OAAO,GACR,EAAE,mBAAmB,GAAG,GAAG,CAAC,OAAO,CAmGnC;AAkED,eAAO,MAAM,qBAAqB,qBAAa,CAAC"}

package/host/dist/components/ErrorView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorView.d.ts","sourceRoot":"","sources":["../../src/components/ErrorView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAMjC,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,IAAI,IAAI,CAAC;IACjB,cAAc,IAAI,IAAI,CAAC;CACxB;AAED,wBAAgB,SAAS,CAAC,EACxB,KAA8B,EAC9B,OAAO,EACP,MAAM,EACN,QAAQ,EACR,cAAc,GACf,EAAE,cAAc,GAAG,GAAG,CAAC,OAAO,CA6D9B"}
+{"version":3,"file":"ErrorView.d.ts","sourceRoot":"","sources":["../../src/components/ErrorView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAMjC,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,IAAI,IAAI,CAAC;IACjB,cAAc,IAAI,IAAI,CAAC;CACxB;AAED,wBAAgB,SAAS,CAAC,EACxB,KAA8B,EAC9B,OAAO,EACP,MAAM,EACN,QAAQ,EACR,cAAc,GACf,EAAE,cAAc,GAAG,GAAG,CAAC,OAAO,CA+D9B"}

package/host/dist/components/LeavingView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LeavingView.d.ts","sourceRoot":"","sources":["../../src/components/LeavingView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAKjC,wBAAgB,WAAW,IAAI,GAAG,CAAC,OAAO,CA2CzC"}
+{"version":3,"file":"LeavingView.d.ts","sourceRoot":"","sources":["../../src/components/LeavingView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAKjC,wBAAgB,WAAW,IAAI,GAAG,CAAC,OAAO,CA+CzC"}