@burdenoff/website-sdk 2026.1102.3 → 2026.1104.2

package/README.md

@@ -301,6 +301,8 @@ publishes audio, video or data, and it sends the avatar nothing to say.
         manifestVersion: 'hb-en-1', // the version of `suggestedQuestions`
         // Optional: used only where the server checks for bots (see "The bot check is the server's setting").
         turnstileSiteKey: TURNSTILE_SITE_KEY,
+        // Optional, default false: end a session nobody attends to (see "A session nobody attends to").
+        endUnattended: true,
       },
     }}
   />
@@ -420,14 +422,50 @@ publishes audio, video or data, and it sends the avatar nothing to say.
   limits, region, language, paused, a question the avatar cannot read) is one
   short sentence and "Continue in Chat". A network or CORS failure, or a route
   that is not there, shows the view as it was before.
-- **Ending.** Stop, switching to Chat, closing the panel, hiding the page, and
-  the live avatar going off under a session (the panel's locale changing to one
+- **Ending.** Stop, closing the panel, leaving the page (`pagehide`), and the
+  live avatar going off under a session (the panel's locale changing to one
   whose strings have not been reviewed) all end the session with a `keepalive`
-  request and leave the room. The end is a simple CORS request: its body is a
+  request and leave the room. Once the create has been sent (connecting,
+  joining, speaking), switching to the Chat tab (or pressing Continue in Chat)
+  and hiding the page (another browser tab, another app) do **not** end it: the
+  Avatar pane is only hidden, the room's video and audio stay attached, and the
+  avatar speaks to the end the server planned for it, which a hidden page
+  cannot extend. Coming back to the Avatar tab shows the session as it is, with
+  the countdown to the server's end, and asks nothing again. Before the create,
+  nothing paid exists, so the Chat tab still calls off an availability check, a
+  "Start when ready" and a bot check, and a hidden page still calls off a
+  "Start when ready" and returns a bot check to the consent card, all with
+  nothing created. While a session is created, joined or played, Chat's own
+  read-aloud and dictation are held (`ExplorePage`'s `voiceHold`): a reading
+  under way stops, and both controls stay where they are, `aria-disabled`, with
+  the avatar's status line as their title, until the session ends; nothing in
+  Chat ends the session. The end is a simple CORS request: its body is a
   string and the SDK sets no `content-type`, so the browser sends it as
   `text/plain;charset=UTF-8` (which the gateway accepts for this route), and on
   production nothing else is added, so no preflight has to complete while the
   page unloads. The server ends sessions on its own deadlines as well.
+- **A session nobody attends to (opt-in: `live.endUnattended: true`, or
+  `websiteAvatarLive({ …, endUnattended: true })`).** Out of sight (the Chat
+  tab, a hidden page) the answer under way still plays to its end, and then
+  the session ends, with reason `user`, once:
+  - **its answer has played out**: at once. This is the lifecycle rule for
+    every later stage: an idle tail after an answer runs only while the Avatar
+    view is in sight, and going out of sight during one ends the session then.
+    The answer counts as played out 5 s after its speech ends at the source
+    (the room's other voice, the server's speaker, leaves or unpublishes): the
+    server's 3 s tail allowance for the worker's lag, plus 2 s. Today the
+    server ends a session about 3 s after its answer, so its own end comes
+    first and the browser sends nothing.
+  - **the browser holds its sound back** (autoplay refused, or the audio
+    context suspended) once the avatar's voice has arrived: after a 5 s grace,
+    since "Tap to turn on sound" is out of sight. The view then says "The live avatar stopped early." and "The
+    full answer is in Chat.". Back in sight within the grace, the button shows
+    and nothing ends; in sight, a held-back sound never ends a session.
+
+  Unset (the default) or `false`: a session out of sight plays on to the
+  server's planned end. A browser that silences a background page without
+  telling the room (iOS Safari may) cannot be seen; the server's planned end
+  bounds that session either way.
 - **Consent copy is versioned.** The panel shows a consent card only when it
   holds reviewed copy for exactly the version the server names; otherwise the
   view stays as it was. `web-consent-2026-11-02` is product-neutral: its card
@@ -510,9 +548,11 @@ publishes audio, video or data, and it sends the avatar nothing to say.
     of the same host for the validation check.
 - **Not verified in this package.** Every test here uses fakes: nothing reaches
   Turnstile, the gateway, the avatar service or the media room. Left to the
-  alpha test: real playback on iPhone Safari and Android Chrome; that
-  `page_hide` ends actually arrive from those browsers; and that the receive-only
-  token has `canPublish=false` and `canPublishData=false`, and a worker RPC
+  alpha test: real playback on iPhone Safari and Android Chrome; that the voice
+  keeps playing behind the Chat tab and in a background browser tab there (a
+  browser may suspend it; the server still ends the session at its planned
+  end); that `page_hide` ends actually arrive from those browsers; and that the
+  receive-only token has `canPublish=false` and `canPublishData=false`, and a worker RPC
   addressed to the viewer is dropped without disconnecting it (the media client
   answers incoming RPC requests on its own, so "never publishes" holds only as
   far as the token's permissions do).

package/dist/avatar-live/index.d.mts

@@ -1,5 +1,5 @@
-import { R as ReceiveOnlyJoinOptions, a as ReceiveOnlySession } from '../types-CndbmBK-.mjs';
-export { A as AvatarLiveModule, b as ReceiveOnlyEvent } from '../types-CndbmBK-.mjs';
+import { R as ReceiveOnlyJoinOptions, a as ReceiveOnlySession } from '../types-CXqaLlNB.mjs';
+export { A as AvatarLiveModule, b as ReceiveOnlyEvent } from '../types-CXqaLlNB.mjs';
 
 /**
  * Join the room in `options.url` with the receive-only `options.token`, and play the avatar worker's video and voice

package/dist/avatar-live/index.d.ts

@@ -1,5 +1,5 @@
-import { R as ReceiveOnlyJoinOptions, a as ReceiveOnlySession } from '../types-CndbmBK-.js';
-export { A as AvatarLiveModule, b as ReceiveOnlyEvent } from '../types-CndbmBK-.js';
+import { R as ReceiveOnlyJoinOptions, a as ReceiveOnlySession } from '../types-CXqaLlNB.js';
+export { A as AvatarLiveModule, b as ReceiveOnlyEvent } from '../types-CXqaLlNB.js';
 
 /**
  * Join the room in `options.url` with the receive-only `options.token`, and play the avatar worker's video and voice

package/dist/avatar-live/index.js

@@ -35,15 +35,30 @@ async function joinReceiveOnly(options) {
   });
   let leaving = false;
   const isSpeaker = (participant) => participant.identity === workerIdentity;
+  const voiced = /* @__PURE__ */ new Set();
+  let speechEnded = false;
   const consider = (publication, participant) => {
-    if (leaving || !isSpeaker(participant) || !isMedia(publication)) return;
+    if (leaving) return;
+    if (!isSpeaker(participant)) {
+      if (publication.kind === livekitClient.Track.Kind.Audio) {
+        voiced.add(participant.identity);
+      }
+      return;
+    }
+    if (!isMedia(publication)) return;
     if (!publication.isSubscribed) publication.setSubscribed(true);
   };
+  const voiceGone = (participant) => {
+    if (leaving || speechEnded || !voiced.has(participant.identity)) return;
+    speechEnded = true;
+    onEvent({ type: "speech-ended" });
+  };
   const reportPlayback = () => {
     if (leaving) return;
     onEvent({
       type: "playback-blocked",
-      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo
+      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo,
+      sound: !room.canPlaybackAudio
     });
   };
   room.on(livekitClient.RoomEvent.TrackPublished, consider).on(
@@ -64,9 +79,19 @@ async function joinReceiveOnly(options) {
     }
   ).on(livekitClient.RoomEvent.TrackUnsubscribed, (track) => {
     track.detach();
-  }).on(livekitClient.RoomEvent.ParticipantDisconnected, (participant) => {
-    if (!leaving && isSpeaker(participant)) {
+  }).on(
+    livekitClient.RoomEvent.TrackUnpublished,
+    (publication, participant) => {
+      if (!isSpeaker(participant) && publication.kind === livekitClient.Track.Kind.Audio) {
+        voiceGone(participant);
+      }
+    }
+  ).on(livekitClient.RoomEvent.ParticipantDisconnected, (participant) => {
+    if (leaving) return;
+    if (isSpeaker(participant)) {
       onEvent({ type: "speaker-left" });
+    } else {
+      voiceGone(participant);
     }
   }).on(livekitClient.RoomEvent.AudioPlaybackStatusChanged, reportPlayback).on(livekitClient.RoomEvent.VideoPlaybackStatusChanged, reportPlayback).on(livekitClient.RoomEvent.Disconnected, (reason) => {
     if (leaving) return;

package/dist/avatar-live/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/avatar-live/receive-only.ts"],"names":["DisconnectReason","Track","Room","RoomEvent"],"mappings":";;;;;AA6BA,IAAM,gBAAA,uBAAsD,GAAA,CAAI;AAAA,EAC9DA,8BAAA,CAAiB,YAAA;AAAA,EACjBA,8BAAA,CAAiB,WAAA;AAAA,EACjBA,8BAAA,CAAiB;AACnB,CAAC,CAAA;AAED,SAAS,QAAQ,WAAA,EAA8C;AAC7D,EAAA,OACE,WAAA,CAAY,SAASC,mBAAA,CAAM,IAAA,CAAK,SAChC,WAAA,CAAY,IAAA,KAASA,oBAAM,IAAA,CAAK,KAAA;AAEpC;AAOA,eAAsB,gBACpB,OAAA,EAC6B;AAC7B,EAAA,MAAM,EAAE,GAAA,EAAK,KAAA,EAAO,gBAAgB,KAAA,EAAO,KAAA,EAAO,SAAQ,GAAI,OAAA;AAC9D,EAAA,IAAI,MAAA;AACJ,EAAA,IAAI;AACF,IAAA,MAAA,GAAS,IAAI,IAAI,GAAG,CAAA;AAAA,EACtB,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,IAAI,MAAM,4CAA4C,CAAA;AAAA,EAC9D;AACA,EAAA,IAAI,MAAA,CAAO,aAAa,MAAA,EAAQ;AAC9B,IAAA,MAAM,IAAI,MAAM,4CAA4C,CAAA;AAAA,EAC9D;AACA,EAAA,IAAI,CAAC,KAAA,IAAS,CAAC,cAAA,EAAgB;AAC7B,IAAA,MAAM,IAAI,MAAM,mDAAmD,CAAA;AAAA,EACrE;AAEA,EAAA,MAAM,IAAA,GAAO,IAAIC,kBAAA,CAAK;AAAA;AAAA,IAEpB,cAAA,EAAgB,KAAA;AAAA,IAChB,QAAA,EAAU,KAAA;AAAA;AAAA;AAAA,IAGV,qBAAA,EAAuB;AAAA,GACxB,CAAA;AACD,EAAA,IAAI,OAAA,GAAU,KAAA;AAEd,EAAA,MAAM,SAAA,GAAY,CAAC,WAAA,KACjB,WAAA,CAAY,QAAA,KAAa,cAAA;AAG3B,EAAA,MAAM,QAAA,GAAW,CACf,WAAA,EACA,WAAA,KACG;AACH,IAAA,IAAI,OAAA,IAAW,CAAC,SAAA,CAAU,WAAW,KAAK,CAAC,OAAA,CAAQ,WAAW,CAAA,EAAG;AACjE,IAAA,IAAI,CAAC,WAAA,CAAY,YAAA,EAAc,WAAA,CAAY,cAAc,IAAI,CAAA;AAAA,EAC/D,CAAA;AAEA,EAAA,MAAM,iBAAiB,MAAM;AAC3B,IAAA,IAAI,OAAA,EAAS;AACb,IAAA,OAAA,CAAQ;AAAA,MACN,IAAA,EAAM,kBAAA;AAAA,MACN,OAAA,EAAS,CAAC,IAAA,CAAK,gBAAA,IAAoB,CAAC,IAAA,CAAK;AAAA,KAC1C,CAAA;AAAA,EACH,CAAA;AAEA,EAAA,IAAA,CACG,EAAA,CAAGC,uBAAA,CAAU,cAAA,EAAgB,QAAQ,CAAA,CACrC,EAAA;AAAA,IACCA,uBAAA,CAAU,eAAA;AAAA,IACV,CACE,KAAA,EACA,WAAA,EACA,WAAA,KACG;AACH,MAAA,IAAI,OAAA,EAAS;AACb,MAAA,IAAI,CAAC,SAAA,CAAU,WAAW,KAAK,CAAC,OAAA,CAAQ,WAAW,CAAA,EAAG;AAEpD,QAAA,WAAA,CAAY,cAAc,KAAK,CAAA;AAC/B,QAAA;AAAA,MACF;AACA,MAAA,IAAI,KAAA,CAAM,IAAA,KAASF,mBAAA,CAAM,IAAA,CAAK,KAAA,EAAO;AACnC,QAAA,KAAA,CAAM,OAAO,KAAK,CAAA;AAClB,QAAA,OAAA,CAAQ,EAAE,IAAA,EAAM,eAAA,EAAiB,IAAA,EAAM,SAAS,CAAA;AAAA,MAClD,CAAA,MAAO;AACL,QAAA,KAAA,CAAM,OAAO,KAAK,CAAA;AAClB,QAAA,OAAA,CAAQ,EAAE,IAAA,EAAM,eAAA,EAAiB,IAAA,EAAM,SAAS,CAAA;AAAA,MAClD;AAAA,IACF;AAAA,GACF,CACC,EAAA,CAAGE,uBAAA,CAAU,iBAAA,EAAmB,CAAC,KAAA,KAAuB;AACvD,IAAA,KAAA,CAAM,MAAA,EAAO;AAAA,EACf,CAAC,CAAA,CACA,EAAA,CAAGA,uBAAA,CAAU,uBAAA,EAAyB,CAAC,WAAA,KAAmC;AACzE,IAAA,IAAI,CAAC,OAAA,IAAW,SAAA,CAAU,WAAW,CAAA,EAAG;AACtC,MAAA,OAAA,CAAQ,EAAE,IAAA,EAAM,cAAA,EAAgB,CAAA;AAAA,IAClC;AAAA,EACF,CAAC,CAAA,CACA,EAAA,CAAGA,uBAAA,CAAU,0BAAA,EAA4B,cAAc,CAAA,CACvD,EAAA,CAAGA,uBAAA,CAAU,0BAAA,EAA4B,cAAc,CAAA,CACvD,EAAA,CAAGA,uBAAA,CAAU,YAAA,EAAc,CAAC,MAAA,KAA8B;AACzD,IAAA,IAAI,OAAA,EAAS;AACb,IAAA,OAAA,CAAQ;AAAA,MACN,IAAA,EAAM,cAAA;AAAA,MACN,QAAA,EAAU,MAAA,KAAW,MAAA,IAAa,gBAAA,CAAiB,IAAI,MAAM;AAAA,KAC9D,CAAA;AAAA,EACH,CAAC,CAAA;AAEH,EAAA,MAAM,YAAY,MAAM;AACtB,IAAA,KAAA,MAAW,WAAA,IAAe,IAAA,CAAK,kBAAA,CAAmB,MAAA,EAAO,EAAG;AAC1D,MAAA,KAAA,MAAW,WAAA,IAAe,WAAA,CAAY,iBAAA,CAAkB,MAAA,EAAO,EAAG;AAChE,QAAA,WAAA,CAAY,OAAO,MAAA,EAAO;AAAA,MAC5B;AAAA,IACF;AACA,IAAA,KAAA,CAAM,SAAA,GAAY,IAAA;AAClB,IAAA,KAAA,CAAM,SAAA,GAAY,IAAA;AAAA,EACpB,CAAA;AAEA,EAAA,IAAI;AACF,IAAA,MAAM,KAAK,OAAA,CAAQ,GAAA,EAAK,OAAO,EAAE,aAAA,EAAe,OAAO,CAAA;AAAA,EACzD,SAAS,KAAA,EAAO;AACd,IAAA,OAAA,GAAU,IAAA;AACV,IAAA,IAAA,CAAK,kBAAA,EAAmB;AACxB,IAAA,SAAA,EAAU;AACV,IAAA,MAAM,KAAA;AAAA,EACR;AAGA,EAAA,KAAA,MAAW,WAAA,IAAe,IAAA,CAAK,kBAAA,CAAmB,MAAA,EAAO,EAAG;AAC1D,IAAA,KAAA,MAAW,WAAA,IAAe,WAAA,CAAY,iBAAA,CAAkB,MAAA,EAAO,EAAG;AAChE,MAAA,QAAA,CAAS,aAAa,WAAW,CAAA;AAAA,IACnC;AAAA,EACF;AACA,EAAA,cAAA,EAAe;AAEf,EAAA,OAAO;AAAA,IACL,gBAAgB,YAAY;AAG1B,MAAA,MAAM,OAAA,CAAQ,WAAW,CAAC,IAAA,CAAK,YAAW,EAAG,IAAA,CAAK,UAAA,EAAY,CAAC,CAAA;AAC/D,MAAA,cAAA,EAAe;AAAA,IACjB,CAAA;AAAA,IACA,OAAO,YAAY;AACjB,MAAA,IAAI,OAAA,EAAS;AACb,MAAA,OAAA,GAAU,IAAA;AACV,MAAA,SAAA,EAAU;AACV,MAAA,IAAI;AACF,QAAA,MAAM,KAAK,UAAA,EAAW;AAAA,MACxB,CAAA,SAAE;AACA,QAAA,IAAA,CAAK,kBAAA,EAAmB;AAAA,MAC1B;AAAA,IACF;AAAA,GACF;AACF","file":"index.js","sourcesContent":["/**\n * BOFF-9797. The live avatar's room, joined to watch and listen only.\n *\n * A visitor's browser on a product website holds a subscribe-only room token: it can receive the avatar worker's\n * video and voice and do nothing else. This adapter keeps to that from its side too:\n *\n * - **Nothing is subscribed automatically** (`autoSubscribe: false`). Only the tracks of `workerIdentity`, the avatar\n *   worker the create answer named, are subscribed, and only their video and audio. Any other participant's track\n *   (the server's own speaker included) is never asked for, and is dropped again should the server send it anyway.\n * - **Nothing is published.** No microphone, no camera, no data, no RPC method: this file never calls a publishing\n *   API, and the token would refuse one.\n * - **Safari and iOS** hold sound back until a gesture. The room reports it (`playback-blocked`) and the panel offers\n *   \"Tap to turn on sound\", whose tap calls `enablePlayback`.\n *\n * Written for the website from the media library's public API: nothing here is copied from the product apps.\n */\nimport {\n  DisconnectReason,\n  Room,\n  RoomEvent,\n  Track,\n  type RemoteParticipant,\n  type RemoteTrack,\n  type RemoteTrackPublication,\n} from \"livekit-client\";\n\nimport type { ReceiveOnlyJoinOptions, ReceiveOnlySession } from \"./types\";\n\n/** The reasons a room closes because the server closed it, rather than because the connection was lost. */\nconst CLOSED_BY_SERVER: ReadonlySet<DisconnectReason> = new Set([\n  DisconnectReason.ROOM_DELETED,\n  DisconnectReason.ROOM_CLOSED,\n  DisconnectReason.PARTICIPANT_REMOVED,\n]);\n\nfunction isMedia(publication: RemoteTrackPublication): boolean {\n  return (\n    publication.kind === Track.Kind.Video ||\n    publication.kind === Track.Kind.Audio\n  );\n}\n\n/**\n * Join the room in `options.url` with the receive-only `options.token`, and play the avatar worker's video and voice\n * in `options.video` and `options.audio`. Resolves once connected; rejects when the room cannot be joined (the panel\n * then ends the session).\n */\nexport async function joinReceiveOnly(\n  options: ReceiveOnlyJoinOptions,\n): Promise<ReceiveOnlySession> {\n  const { url, token, workerIdentity, video, audio, onEvent } = options;\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    throw new Error(\"live avatar: the room address is not a URL\");\n  }\n  if (parsed.protocol !== \"wss:\") {\n    throw new Error(\"live avatar: the room address must be wss:\");\n  }\n  if (!token || !workerIdentity) {\n    throw new Error(\"live avatar: the room token or speaker is missing\");\n  }\n\n  const room = new Room({\n    // One small video, always shown while the session lasts: no quality switching, no layer pausing.\n    adaptiveStream: false,\n    dynacast: false,\n    // Closing the tab or leaving the page leaves the room at once. Belt and braces with the panel's own page-hide\n    // handler, which also asks the server to end the session: either may run first, and both are safe to repeat.\n    disconnectOnPageLeave: true,\n  });\n  let leaving = false;\n\n  const isSpeaker = (participant: RemoteParticipant) =>\n    participant.identity === workerIdentity;\n\n  /** Subscribe to `publication` when it is the speaker's video or audio; leave everything else alone. */\n  const consider = (\n    publication: RemoteTrackPublication,\n    participant: RemoteParticipant,\n  ) => {\n    if (leaving || !isSpeaker(participant) || !isMedia(publication)) return;\n    if (!publication.isSubscribed) publication.setSubscribed(true);\n  };\n\n  const reportPlayback = () => {\n    if (leaving) return;\n    onEvent({\n      type: \"playback-blocked\",\n      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo,\n    });\n  };\n\n  room\n    .on(RoomEvent.TrackPublished, consider)\n    .on(\n      RoomEvent.TrackSubscribed,\n      (\n        track: RemoteTrack,\n        publication: RemoteTrackPublication,\n        participant: RemoteParticipant,\n      ) => {\n        if (leaving) return;\n        if (!isSpeaker(participant) || !isMedia(publication)) {\n          // Never asked for: drop it rather than play it.\n          publication.setSubscribed(false);\n          return;\n        }\n        if (track.kind === Track.Kind.Video) {\n          track.attach(video);\n          onEvent({ type: \"speaker-track\", kind: \"video\" });\n        } else {\n          track.attach(audio);\n          onEvent({ type: \"speaker-track\", kind: \"audio\" });\n        }\n      },\n    )\n    .on(RoomEvent.TrackUnsubscribed, (track: RemoteTrack) => {\n      track.detach();\n    })\n    .on(RoomEvent.ParticipantDisconnected, (participant: RemoteParticipant) => {\n      if (!leaving && isSpeaker(participant)) {\n        onEvent({ type: \"speaker-left\" });\n      }\n    })\n    .on(RoomEvent.AudioPlaybackStatusChanged, reportPlayback)\n    .on(RoomEvent.VideoPlaybackStatusChanged, reportPlayback)\n    .on(RoomEvent.Disconnected, (reason?: DisconnectReason) => {\n      if (leaving) return;\n      onEvent({\n        type: \"disconnected\",\n        byServer: reason !== undefined && CLOSED_BY_SERVER.has(reason),\n      });\n    });\n\n  const detachAll = () => {\n    for (const participant of room.remoteParticipants.values()) {\n      for (const publication of participant.trackPublications.values()) {\n        publication.track?.detach();\n      }\n    }\n    video.srcObject = null;\n    audio.srcObject = null;\n  };\n\n  try {\n    await room.connect(url, token, { autoSubscribe: false });\n  } catch (error) {\n    leaving = true;\n    room.removeAllListeners();\n    detachAll();\n    throw error;\n  }\n\n  // Whoever was in the room before this viewer joined: their tracks were published before the listener above.\n  for (const participant of room.remoteParticipants.values()) {\n    for (const publication of participant.trackPublications.values()) {\n      consider(publication, participant);\n    }\n  }\n  reportPlayback();\n\n  return {\n    enablePlayback: async () => {\n      // Both started inside the visitor's gesture, before anything is awaited: Safari allows playback only there.\n      // A refusal leaves the room as it was, and the report below keeps the button offered.\n      await Promise.allSettled([room.startAudio(), room.startVideo()]);\n      reportPlayback();\n    },\n    leave: async () => {\n      if (leaving) return;\n      leaving = true;\n      detachAll();\n      try {\n        await room.disconnect();\n      } finally {\n        room.removeAllListeners();\n      }\n    },\n  };\n}\n"]}
+{"version":3,"sources":["../../src/avatar-live/receive-only.ts"],"names":["DisconnectReason","Track","Room","RoomEvent"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * BOFF-9797. The live avatar's room, joined to watch and listen only.\n *\n * A visitor's browser on a product website holds a subscribe-only room token: it can receive the avatar worker's\n * video and voice and do nothing else. This adapter keeps to that from its side too:\n *\n * - **Nothing is subscribed automatically** (`autoSubscribe: false`). Only the tracks of `workerIdentity`, the avatar\n *   worker the create answer named, are subscribed, and only their video and audio. Any other participant's track\n *   (the server's own speaker included) is never asked for, and is dropped again should the server send it anyway.\n * - **Nothing is published.** No microphone, no camera, no data, no RPC method: this file never calls a publishing\n *   API, and the token would refuse one.\n * - **Safari and iOS** hold sound back until a gesture. The room reports it (`playback-blocked`, with `sound` when the\n *   sound is held back and not only the video) and the panel offers \"Tap to turn on sound\", whose tap calls\n *   `enablePlayback`.\n * - **The end of the speech** is told (`speech-ended`) from what any viewer of the room sees: the other voice in it, the\n *   server's speaker that the worker follows, leaving the room or unpublishing its voice. Its track is never subscribed.\n *\n * Written for the website from the media library's public API: nothing here is copied from the product apps.\n */\nimport {\n  DisconnectReason,\n  Room,\n  RoomEvent,\n  Track,\n  type RemoteParticipant,\n  type RemoteTrack,\n  type RemoteTrackPublication,\n} from \"livekit-client\";\n\nimport type { ReceiveOnlyJoinOptions, ReceiveOnlySession } from \"./types\";\n\n/** The reasons a room closes because the server closed it, rather than because the connection was lost. */\nconst CLOSED_BY_SERVER: ReadonlySet<DisconnectReason> = new Set([\n  DisconnectReason.ROOM_DELETED,\n  DisconnectReason.ROOM_CLOSED,\n  DisconnectReason.PARTICIPANT_REMOVED,\n]);\n\nfunction isMedia(publication: RemoteTrackPublication): boolean {\n  return (\n    publication.kind === Track.Kind.Video ||\n    publication.kind === Track.Kind.Audio\n  );\n}\n\n/**\n * Join the room in `options.url` with the receive-only `options.token`, and play the avatar worker's video and voice\n * in `options.video` and `options.audio`. Resolves once connected; rejects when the room cannot be joined (the panel\n * then ends the session).\n */\nexport async function joinReceiveOnly(\n  options: ReceiveOnlyJoinOptions,\n): Promise<ReceiveOnlySession> {\n  const { url, token, workerIdentity, video, audio, onEvent } = options;\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    throw new Error(\"live avatar: the room address is not a URL\");\n  }\n  if (parsed.protocol !== \"wss:\") {\n    throw new Error(\"live avatar: the room address must be wss:\");\n  }\n  if (!token || !workerIdentity) {\n    throw new Error(\"live avatar: the room token or speaker is missing\");\n  }\n\n  const room = new Room({\n    // One small video, always shown while the session lasts: no quality switching, no layer pausing.\n    adaptiveStream: false,\n    dynacast: false,\n    // Closing the tab or leaving the page leaves the room at once. Belt and braces with the panel's own page-hide\n    // handler, which also asks the server to end the session: either may run first, and both are safe to repeat.\n    disconnectOnPageLeave: true,\n  });\n  let leaving = false;\n\n  const isSpeaker = (participant: RemoteParticipant) =>\n    participant.identity === workerIdentity;\n\n  /**\n   * Everyone else in the room seen publishing a voice: the server's speaker, whose speech the worker voices. Noted\n   * only, never subscribed to, so that the end of that speech can be told (`speech-ended`).\n   */\n  const voiced = new Set<string>();\n  let speechEnded = false;\n\n  /** Subscribe to `publication` when it is the speaker's video or audio; leave everything else alone. */\n  const consider = (\n    publication: RemoteTrackPublication,\n    participant: RemoteParticipant,\n  ) => {\n    if (leaving) return;\n    if (!isSpeaker(participant)) {\n      if (publication.kind === Track.Kind.Audio) {\n        voiced.add(participant.identity);\n      }\n      return;\n    }\n    if (!isMedia(publication)) return;\n    if (!publication.isSubscribed) publication.setSubscribed(true);\n  };\n\n  /** A voice seen published has gone (its track, or its participant): the speech has ended at its source. Once. */\n  const voiceGone = (participant: RemoteParticipant) => {\n    if (leaving || speechEnded || !voiced.has(participant.identity)) return;\n    speechEnded = true;\n    onEvent({ type: \"speech-ended\" });\n  };\n\n  const reportPlayback = () => {\n    if (leaving) return;\n    onEvent({\n      type: \"playback-blocked\",\n      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo,\n      sound: !room.canPlaybackAudio,\n    });\n  };\n\n  room\n    .on(RoomEvent.TrackPublished, consider)\n    .on(\n      RoomEvent.TrackSubscribed,\n      (\n        track: RemoteTrack,\n        publication: RemoteTrackPublication,\n        participant: RemoteParticipant,\n      ) => {\n        if (leaving) return;\n        if (!isSpeaker(participant) || !isMedia(publication)) {\n          // Never asked for: drop it rather than play it.\n          publication.setSubscribed(false);\n          return;\n        }\n        if (track.kind === Track.Kind.Video) {\n          track.attach(video);\n          onEvent({ type: \"speaker-track\", kind: \"video\" });\n        } else {\n          track.attach(audio);\n          onEvent({ type: \"speaker-track\", kind: \"audio\" });\n        }\n      },\n    )\n    .on(RoomEvent.TrackUnsubscribed, (track: RemoteTrack) => {\n      track.detach();\n    })\n    .on(\n      RoomEvent.TrackUnpublished,\n      (publication: RemoteTrackPublication, participant: RemoteParticipant) => {\n        if (!isSpeaker(participant) && publication.kind === Track.Kind.Audio) {\n          voiceGone(participant);\n        }\n      },\n    )\n    .on(RoomEvent.ParticipantDisconnected, (participant: RemoteParticipant) => {\n      if (leaving) return;\n      if (isSpeaker(participant)) {\n        onEvent({ type: \"speaker-left\" });\n      } else {\n        voiceGone(participant);\n      }\n    })\n    .on(RoomEvent.AudioPlaybackStatusChanged, reportPlayback)\n    .on(RoomEvent.VideoPlaybackStatusChanged, reportPlayback)\n    .on(RoomEvent.Disconnected, (reason?: DisconnectReason) => {\n      if (leaving) return;\n      onEvent({\n        type: \"disconnected\",\n        byServer: reason !== undefined && CLOSED_BY_SERVER.has(reason),\n      });\n    });\n\n  const detachAll = () => {\n    for (const participant of room.remoteParticipants.values()) {\n      for (const publication of participant.trackPublications.values()) {\n        publication.track?.detach();\n      }\n    }\n    video.srcObject = null;\n    audio.srcObject = null;\n  };\n\n  try {\n    await room.connect(url, token, { autoSubscribe: false });\n  } catch (error) {\n    leaving = true;\n    room.removeAllListeners();\n    detachAll();\n    throw error;\n  }\n\n  // Whoever was in the room before this viewer joined: their tracks were published before the listener above.\n  for (const participant of room.remoteParticipants.values()) {\n    for (const publication of participant.trackPublications.values()) {\n      consider(publication, participant);\n    }\n  }\n  reportPlayback();\n\n  return {\n    enablePlayback: async () => {\n      // Both started inside the visitor's gesture, before anything is awaited: Safari allows playback only there.\n      // A refusal leaves the room as it was, and the report below keeps the button offered.\n      await Promise.allSettled([room.startAudio(), room.startVideo()]);\n      reportPlayback();\n    },\n    leave: async () => {\n      if (leaving) return;\n      leaving = true;\n      detachAll();\n      try {\n        await room.disconnect();\n      } finally {\n        room.removeAllListeners();\n      }\n    },\n  };\n}\n"]}

package/dist/avatar-live/index.mjs

@@ -33,15 +33,30 @@ async function joinReceiveOnly(options) {
   });
   let leaving = false;
   const isSpeaker = (participant) => participant.identity === workerIdentity;
+  const voiced = /* @__PURE__ */ new Set();
+  let speechEnded = false;
   const consider = (publication, participant) => {
-    if (leaving || !isSpeaker(participant) || !isMedia(publication)) return;
+    if (leaving) return;
+    if (!isSpeaker(participant)) {
+      if (publication.kind === Track.Kind.Audio) {
+        voiced.add(participant.identity);
+      }
+      return;
+    }
+    if (!isMedia(publication)) return;
     if (!publication.isSubscribed) publication.setSubscribed(true);
   };
+  const voiceGone = (participant) => {
+    if (leaving || speechEnded || !voiced.has(participant.identity)) return;
+    speechEnded = true;
+    onEvent({ type: "speech-ended" });
+  };
   const reportPlayback = () => {
     if (leaving) return;
     onEvent({
       type: "playback-blocked",
-      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo
+      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo,
+      sound: !room.canPlaybackAudio
     });
   };
   room.on(RoomEvent.TrackPublished, consider).on(
@@ -62,9 +77,19 @@ async function joinReceiveOnly(options) {
     }
   ).on(RoomEvent.TrackUnsubscribed, (track) => {
     track.detach();
-  }).on(RoomEvent.ParticipantDisconnected, (participant) => {
-    if (!leaving && isSpeaker(participant)) {
+  }).on(
+    RoomEvent.TrackUnpublished,
+    (publication, participant) => {
+      if (!isSpeaker(participant) && publication.kind === Track.Kind.Audio) {
+        voiceGone(participant);
+      }
+    }
+  ).on(RoomEvent.ParticipantDisconnected, (participant) => {
+    if (leaving) return;
+    if (isSpeaker(participant)) {
       onEvent({ type: "speaker-left" });
+    } else {
+      voiceGone(participant);
     }
   }).on(RoomEvent.AudioPlaybackStatusChanged, reportPlayback).on(RoomEvent.VideoPlaybackStatusChanged, reportPlayback).on(RoomEvent.Disconnected, (reason) => {
     if (leaving) return;

package/dist/avatar-live/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/avatar-live/receive-only.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * BOFF-9797. The live avatar's room, joined to watch and listen only.\n *\n * A visitor's browser on a product website holds a subscribe-only room token: it can receive the avatar worker's\n * video and voice and do nothing else. This adapter keeps to that from its side too:\n *\n * - **Nothing is subscribed automatically** (`autoSubscribe: false`). Only the tracks of `workerIdentity`, the avatar\n *   worker the create answer named, are subscribed, and only their video and audio. Any other participant's track\n *   (the server's own speaker included) is never asked for, and is dropped again should the server send it anyway.\n * - **Nothing is published.** No microphone, no camera, no data, no RPC method: this file never calls a publishing\n *   API, and the token would refuse one.\n * - **Safari and iOS** hold sound back until a gesture. The room reports it (`playback-blocked`) and the panel offers\n *   \"Tap to turn on sound\", whose tap calls `enablePlayback`.\n *\n * Written for the website from the media library's public API: nothing here is copied from the product apps.\n */\nimport {\n  DisconnectReason,\n  Room,\n  RoomEvent,\n  Track,\n  type RemoteParticipant,\n  type RemoteTrack,\n  type RemoteTrackPublication,\n} from \"livekit-client\";\n\nimport type { ReceiveOnlyJoinOptions, ReceiveOnlySession } from \"./types\";\n\n/** The reasons a room closes because the server closed it, rather than because the connection was lost. */\nconst CLOSED_BY_SERVER: ReadonlySet<DisconnectReason> = new Set([\n  DisconnectReason.ROOM_DELETED,\n  DisconnectReason.ROOM_CLOSED,\n  DisconnectReason.PARTICIPANT_REMOVED,\n]);\n\nfunction isMedia(publication: RemoteTrackPublication): boolean {\n  return (\n    publication.kind === Track.Kind.Video ||\n    publication.kind === Track.Kind.Audio\n  );\n}\n\n/**\n * Join the room in `options.url` with the receive-only `options.token`, and play the avatar worker's video and voice\n * in `options.video` and `options.audio`. Resolves once connected; rejects when the room cannot be joined (the panel\n * then ends the session).\n */\nexport async function joinReceiveOnly(\n  options: ReceiveOnlyJoinOptions,\n): Promise<ReceiveOnlySession> {\n  const { url, token, workerIdentity, video, audio, onEvent } = options;\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    throw new Error(\"live avatar: the room address is not a URL\");\n  }\n  if (parsed.protocol !== \"wss:\") {\n    throw new Error(\"live avatar: the room address must be wss:\");\n  }\n  if (!token || !workerIdentity) {\n    throw new Error(\"live avatar: the room token or speaker is missing\");\n  }\n\n  const room = new Room({\n    // One small video, always shown while the session lasts: no quality switching, no layer pausing.\n    adaptiveStream: false,\n    dynacast: false,\n    // Closing the tab or leaving the page leaves the room at once. Belt and braces with the panel's own page-hide\n    // handler, which also asks the server to end the session: either may run first, and both are safe to repeat.\n    disconnectOnPageLeave: true,\n  });\n  let leaving = false;\n\n  const isSpeaker = (participant: RemoteParticipant) =>\n    participant.identity === workerIdentity;\n\n  /** Subscribe to `publication` when it is the speaker's video or audio; leave everything else alone. */\n  const consider = (\n    publication: RemoteTrackPublication,\n    participant: RemoteParticipant,\n  ) => {\n    if (leaving || !isSpeaker(participant) || !isMedia(publication)) return;\n    if (!publication.isSubscribed) publication.setSubscribed(true);\n  };\n\n  const reportPlayback = () => {\n    if (leaving) return;\n    onEvent({\n      type: \"playback-blocked\",\n      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo,\n    });\n  };\n\n  room\n    .on(RoomEvent.TrackPublished, consider)\n    .on(\n      RoomEvent.TrackSubscribed,\n      (\n        track: RemoteTrack,\n        publication: RemoteTrackPublication,\n        participant: RemoteParticipant,\n      ) => {\n        if (leaving) return;\n        if (!isSpeaker(participant) || !isMedia(publication)) {\n          // Never asked for: drop it rather than play it.\n          publication.setSubscribed(false);\n          return;\n        }\n        if (track.kind === Track.Kind.Video) {\n          track.attach(video);\n          onEvent({ type: \"speaker-track\", kind: \"video\" });\n        } else {\n          track.attach(audio);\n          onEvent({ type: \"speaker-track\", kind: \"audio\" });\n        }\n      },\n    )\n    .on(RoomEvent.TrackUnsubscribed, (track: RemoteTrack) => {\n      track.detach();\n    })\n    .on(RoomEvent.ParticipantDisconnected, (participant: RemoteParticipant) => {\n      if (!leaving && isSpeaker(participant)) {\n        onEvent({ type: \"speaker-left\" });\n      }\n    })\n    .on(RoomEvent.AudioPlaybackStatusChanged, reportPlayback)\n    .on(RoomEvent.VideoPlaybackStatusChanged, reportPlayback)\n    .on(RoomEvent.Disconnected, (reason?: DisconnectReason) => {\n      if (leaving) return;\n      onEvent({\n        type: \"disconnected\",\n        byServer: reason !== undefined && CLOSED_BY_SERVER.has(reason),\n      });\n    });\n\n  const detachAll = () => {\n    for (const participant of room.remoteParticipants.values()) {\n      for (const publication of participant.trackPublications.values()) {\n        publication.track?.detach();\n      }\n    }\n    video.srcObject = null;\n    audio.srcObject = null;\n  };\n\n  try {\n    await room.connect(url, token, { autoSubscribe: false });\n  } catch (error) {\n    leaving = true;\n    room.removeAllListeners();\n    detachAll();\n    throw error;\n  }\n\n  // Whoever was in the room before this viewer joined: their tracks were published before the listener above.\n  for (const participant of room.remoteParticipants.values()) {\n    for (const publication of participant.trackPublications.values()) {\n      consider(publication, participant);\n    }\n  }\n  reportPlayback();\n\n  return {\n    enablePlayback: async () => {\n      // Both started inside the visitor's gesture, before anything is awaited: Safari allows playback only there.\n      // A refusal leaves the room as it was, and the report below keeps the button offered.\n      await Promise.allSettled([room.startAudio(), room.startVideo()]);\n      reportPlayback();\n    },\n    leave: async () => {\n      if (leaving) return;\n      leaving = true;\n      detachAll();\n      try {\n        await room.disconnect();\n      } finally {\n        room.removeAllListeners();\n      }\n    },\n  };\n}\n"]}
+{"version":3,"sources":["../../src/avatar-live/receive-only.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * BOFF-9797. The live avatar's room, joined to watch and listen only.\n *\n * A visitor's browser on a product website holds a subscribe-only room token: it can receive the avatar worker's\n * video and voice and do nothing else. This adapter keeps to that from its side too:\n *\n * - **Nothing is subscribed automatically** (`autoSubscribe: false`). Only the tracks of `workerIdentity`, the avatar\n *   worker the create answer named, are subscribed, and only their video and audio. Any other participant's track\n *   (the server's own speaker included) is never asked for, and is dropped again should the server send it anyway.\n * - **Nothing is published.** No microphone, no camera, no data, no RPC method: this file never calls a publishing\n *   API, and the token would refuse one.\n * - **Safari and iOS** hold sound back until a gesture. The room reports it (`playback-blocked`, with `sound` when the\n *   sound is held back and not only the video) and the panel offers \"Tap to turn on sound\", whose tap calls\n *   `enablePlayback`.\n * - **The end of the speech** is told (`speech-ended`) from what any viewer of the room sees: the other voice in it, the\n *   server's speaker that the worker follows, leaving the room or unpublishing its voice. Its track is never subscribed.\n *\n * Written for the website from the media library's public API: nothing here is copied from the product apps.\n */\nimport {\n  DisconnectReason,\n  Room,\n  RoomEvent,\n  Track,\n  type RemoteParticipant,\n  type RemoteTrack,\n  type RemoteTrackPublication,\n} from \"livekit-client\";\n\nimport type { ReceiveOnlyJoinOptions, ReceiveOnlySession } from \"./types\";\n\n/** The reasons a room closes because the server closed it, rather than because the connection was lost. */\nconst CLOSED_BY_SERVER: ReadonlySet<DisconnectReason> = new Set([\n  DisconnectReason.ROOM_DELETED,\n  DisconnectReason.ROOM_CLOSED,\n  DisconnectReason.PARTICIPANT_REMOVED,\n]);\n\nfunction isMedia(publication: RemoteTrackPublication): boolean {\n  return (\n    publication.kind === Track.Kind.Video ||\n    publication.kind === Track.Kind.Audio\n  );\n}\n\n/**\n * Join the room in `options.url` with the receive-only `options.token`, and play the avatar worker's video and voice\n * in `options.video` and `options.audio`. Resolves once connected; rejects when the room cannot be joined (the panel\n * then ends the session).\n */\nexport async function joinReceiveOnly(\n  options: ReceiveOnlyJoinOptions,\n): Promise<ReceiveOnlySession> {\n  const { url, token, workerIdentity, video, audio, onEvent } = options;\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    throw new Error(\"live avatar: the room address is not a URL\");\n  }\n  if (parsed.protocol !== \"wss:\") {\n    throw new Error(\"live avatar: the room address must be wss:\");\n  }\n  if (!token || !workerIdentity) {\n    throw new Error(\"live avatar: the room token or speaker is missing\");\n  }\n\n  const room = new Room({\n    // One small video, always shown while the session lasts: no quality switching, no layer pausing.\n    adaptiveStream: false,\n    dynacast: false,\n    // Closing the tab or leaving the page leaves the room at once. Belt and braces with the panel's own page-hide\n    // handler, which also asks the server to end the session: either may run first, and both are safe to repeat.\n    disconnectOnPageLeave: true,\n  });\n  let leaving = false;\n\n  const isSpeaker = (participant: RemoteParticipant) =>\n    participant.identity === workerIdentity;\n\n  /**\n   * Everyone else in the room seen publishing a voice: the server's speaker, whose speech the worker voices. Noted\n   * only, never subscribed to, so that the end of that speech can be told (`speech-ended`).\n   */\n  const voiced = new Set<string>();\n  let speechEnded = false;\n\n  /** Subscribe to `publication` when it is the speaker's video or audio; leave everything else alone. */\n  const consider = (\n    publication: RemoteTrackPublication,\n    participant: RemoteParticipant,\n  ) => {\n    if (leaving) return;\n    if (!isSpeaker(participant)) {\n      if (publication.kind === Track.Kind.Audio) {\n        voiced.add(participant.identity);\n      }\n      return;\n    }\n    if (!isMedia(publication)) return;\n    if (!publication.isSubscribed) publication.setSubscribed(true);\n  };\n\n  /** A voice seen published has gone (its track, or its participant): the speech has ended at its source. Once. */\n  const voiceGone = (participant: RemoteParticipant) => {\n    if (leaving || speechEnded || !voiced.has(participant.identity)) return;\n    speechEnded = true;\n    onEvent({ type: \"speech-ended\" });\n  };\n\n  const reportPlayback = () => {\n    if (leaving) return;\n    onEvent({\n      type: \"playback-blocked\",\n      blocked: !room.canPlaybackAudio || !room.canPlaybackVideo,\n      sound: !room.canPlaybackAudio,\n    });\n  };\n\n  room\n    .on(RoomEvent.TrackPublished, consider)\n    .on(\n      RoomEvent.TrackSubscribed,\n      (\n        track: RemoteTrack,\n        publication: RemoteTrackPublication,\n        participant: RemoteParticipant,\n      ) => {\n        if (leaving) return;\n        if (!isSpeaker(participant) || !isMedia(publication)) {\n          // Never asked for: drop it rather than play it.\n          publication.setSubscribed(false);\n          return;\n        }\n        if (track.kind === Track.Kind.Video) {\n          track.attach(video);\n          onEvent({ type: \"speaker-track\", kind: \"video\" });\n        } else {\n          track.attach(audio);\n          onEvent({ type: \"speaker-track\", kind: \"audio\" });\n        }\n      },\n    )\n    .on(RoomEvent.TrackUnsubscribed, (track: RemoteTrack) => {\n      track.detach();\n    })\n    .on(\n      RoomEvent.TrackUnpublished,\n      (publication: RemoteTrackPublication, participant: RemoteParticipant) => {\n        if (!isSpeaker(participant) && publication.kind === Track.Kind.Audio) {\n          voiceGone(participant);\n        }\n      },\n    )\n    .on(RoomEvent.ParticipantDisconnected, (participant: RemoteParticipant) => {\n      if (leaving) return;\n      if (isSpeaker(participant)) {\n        onEvent({ type: \"speaker-left\" });\n      } else {\n        voiceGone(participant);\n      }\n    })\n    .on(RoomEvent.AudioPlaybackStatusChanged, reportPlayback)\n    .on(RoomEvent.VideoPlaybackStatusChanged, reportPlayback)\n    .on(RoomEvent.Disconnected, (reason?: DisconnectReason) => {\n      if (leaving) return;\n      onEvent({\n        type: \"disconnected\",\n        byServer: reason !== undefined && CLOSED_BY_SERVER.has(reason),\n      });\n    });\n\n  const detachAll = () => {\n    for (const participant of room.remoteParticipants.values()) {\n      for (const publication of participant.trackPublications.values()) {\n        publication.track?.detach();\n      }\n    }\n    video.srcObject = null;\n    audio.srcObject = null;\n  };\n\n  try {\n    await room.connect(url, token, { autoSubscribe: false });\n  } catch (error) {\n    leaving = true;\n    room.removeAllListeners();\n    detachAll();\n    throw error;\n  }\n\n  // Whoever was in the room before this viewer joined: their tracks were published before the listener above.\n  for (const participant of room.remoteParticipants.values()) {\n    for (const publication of participant.trackPublications.values()) {\n      consider(publication, participant);\n    }\n  }\n  reportPlayback();\n\n  return {\n    enablePlayback: async () => {\n      // Both started inside the visitor's gesture, before anything is awaited: Safari allows playback only there.\n      // A refusal leaves the room as it was, and the report below keeps the button offered.\n      await Promise.allSettled([room.startAudio(), room.startVideo()]);\n      reportPlayback();\n    },\n    leave: async () => {\n      if (leaving) return;\n      leaving = true;\n      detachAll();\n      try {\n        await room.disconnect();\n      } finally {\n        room.removeAllListeners();\n      }\n    },\n  };\n}\n"]}

package/dist/avatar-live-view/index.d.mts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { E as ExplorePanelAvatarLive, a as ExploreLocale, A as AvatarConversation } from '../explore-avatar-live-config-N4WhJzgS.mjs';
-import '../types-CndbmBK-.mjs';
+import { E as ExplorePanelAvatarLive, a as ExploreLocale, A as AvatarConversation } from '../explore-avatar-live-config-B6_p0q1c.mjs';
+import '../types-CXqaLlNB.mjs';
 import '../use-explore-chat-CbfohA9O.mjs';
 import '../explore-types-Ol1Mm3dW.mjs';
 
@@ -9,6 +9,11 @@ interface AvatarLiveViewProps {
     live: ExplorePanelAvatarLive;
     /** The Avatar view is showing: the panel is open and its Avatar tab is selected. */
     active: boolean;
+    /**
+     * The panel is open, whichever tab it shows. With `active` it tells the Chat tab (open, not active: the pane is only
+     * hidden, and a session under way keeps playing) from the panel closing (not open: what is under way ends).
+     */
+    open: boolean;
     locale: ExploreLocale;
     /** The product the panel speaks for, when it is one product's own; null on the portfolio's. */
     productName: string | null;
@@ -19,8 +24,18 @@ interface AvatarLiveViewProps {
     };
     /** The Avatar tab as it was before the live avatar: shown whenever the live avatar is not offered or not reachable. */
     fallback: ReactNode;
-    /** Back to the Chat tab. Leaving the Avatar tab ends a session, like any other way out of it. */
+    /**
+     * Back to the Chat tab. Like the Chat tab itself, it calls off a start that has not been sent yet, and leaves a
+     * session under way speaking.
+     */
     onContinueInChat: () => void;
+    /**
+     * Told whenever the avatar's voice starts or stops being the page's: its status line while a session is being
+     * created, joined or played ("Connecting to the live avatar…", "The avatar is speaking."), and null otherwise (and
+     * when the view goes). The panel holds Chat's own read-aloud and dictation meanwhile, so the page never speaks in two
+     * voices and the microphone never takes down the avatar's.
+     */
+    onVoiceHold?: (line: string | null) => void;
     /** "Continue in Chat" in the panel's language: the panel's own word for it, so this chunk carries none of the panel's. */
     continueInChat: string;
     /**
@@ -51,6 +66,6 @@ interface AvatarLiveViewProps {
     /** The panel's conversation, null when there is no provider. */
     conversation: AvatarConversation | null;
 }
-declare function AvatarLiveView({ live, active, locale, productName, still, fallback, onContinueInChat, continueInChat, newChat, send, tryAsking, prompts, touchFirst, currentPath, off, base, headers, conversation, }: AvatarLiveViewProps): react.JSX.Element;
+declare function AvatarLiveView({ live, active, open, locale, productName, still, fallback, onContinueInChat, onVoiceHold, continueInChat, newChat, send, tryAsking, prompts, touchFirst, currentPath, off, base, headers, conversation, }: AvatarLiveViewProps): react.JSX.Element;
 
 export { AvatarLiveView, type AvatarLiveViewProps };

package/dist/avatar-live-view/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { E as ExplorePanelAvatarLive, a as ExploreLocale, A as AvatarConversation } from '../explore-avatar-live-config-CAfN5eAX.js';
-import '../types-CndbmBK-.js';
+import { E as ExplorePanelAvatarLive, a as ExploreLocale, A as AvatarConversation } from '../explore-avatar-live-config-DRpS-mqQ.js';
+import '../types-CXqaLlNB.js';
 import '../use-explore-chat-B3dOOvJN.js';
 import '../explore-types-Ol1Mm3dW.js';
 
@@ -9,6 +9,11 @@ interface AvatarLiveViewProps {
     live: ExplorePanelAvatarLive;
     /** The Avatar view is showing: the panel is open and its Avatar tab is selected. */
     active: boolean;
+    /**
+     * The panel is open, whichever tab it shows. With `active` it tells the Chat tab (open, not active: the pane is only
+     * hidden, and a session under way keeps playing) from the panel closing (not open: what is under way ends).
+     */
+    open: boolean;
     locale: ExploreLocale;
     /** The product the panel speaks for, when it is one product's own; null on the portfolio's. */
     productName: string | null;
@@ -19,8 +24,18 @@ interface AvatarLiveViewProps {
     };
     /** The Avatar tab as it was before the live avatar: shown whenever the live avatar is not offered or not reachable. */
     fallback: ReactNode;
-    /** Back to the Chat tab. Leaving the Avatar tab ends a session, like any other way out of it. */
+    /**
+     * Back to the Chat tab. Like the Chat tab itself, it calls off a start that has not been sent yet, and leaves a
+     * session under way speaking.
+     */
     onContinueInChat: () => void;
+    /**
+     * Told whenever the avatar's voice starts or stops being the page's: its status line while a session is being
+     * created, joined or played ("Connecting to the live avatar…", "The avatar is speaking."), and null otherwise (and
+     * when the view goes). The panel holds Chat's own read-aloud and dictation meanwhile, so the page never speaks in two
+     * voices and the microphone never takes down the avatar's.
+     */
+    onVoiceHold?: (line: string | null) => void;
     /** "Continue in Chat" in the panel's language: the panel's own word for it, so this chunk carries none of the panel's. */
     continueInChat: string;
     /**
@@ -51,6 +66,6 @@ interface AvatarLiveViewProps {
     /** The panel's conversation, null when there is no provider. */
     conversation: AvatarConversation | null;
 }
-declare function AvatarLiveView({ live, active, locale, productName, still, fallback, onContinueInChat, continueInChat, newChat, send, tryAsking, prompts, touchFirst, currentPath, off, base, headers, conversation, }: AvatarLiveViewProps): react.JSX.Element;
+declare function AvatarLiveView({ live, active, open, locale, productName, still, fallback, onContinueInChat, onVoiceHold, continueInChat, newChat, send, tryAsking, prompts, touchFirst, currentPath, off, base, headers, conversation, }: AvatarLiveViewProps): react.JSX.Element;
 
 export { AvatarLiveView, type AvatarLiveViewProps };