@athenaintel/react 0.43.0 → 0.48.0

package/dist/voice/livekit-join.cjs

@@ -1,119 +1,70 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const voiceMedia = require("../agent-runtime/src/voice-media.cjs");
 const livekitClient = require("livekit-client");
-const MICROPHONE_CAPTURE = {
-  echoCancellation: true,
-  noiseSuppression: true,
-  autoGainControl: true
-};
-const disconnectReasonLabel = (reason) => {
-  if (reason === void 0) return "room-disconnected";
-  const name = livekitClient.DisconnectReason[reason];
-  return `room-disconnected:${(name ?? String(reason)).toLowerCase()}`;
-};
 const defaultRoomFactory = () => new livekitClient.Room({
   adaptiveStream: false,
   dynacast: false,
-  audioCaptureDefaults: MICROPHONE_CAPTURE,
+  audioCaptureDefaults: voiceMedia.VOICE_MICROPHONE_CAPTURE,
   publishDefaults: { stopMicTrackOnMute: true }
 });
-async function joinDeepAgentVoiceRoom({
+function joinDeepAgentVoiceRoom({
   answer,
   handlers,
   audioElement,
   roomFactory = defaultRoomFactory
 }) {
-  const { signal } = handlers;
-  const endedError = () => new DOMException("The voice session ended", "AbortError");
-  if (signal == null ? void 0 : signal.aborted) throw endedError();
-  const room = roomFactory();
-  let connected = false;
-  let joined = false;
-  let closed = false;
-  let disconnecting = null;
-  const attached = /* @__PURE__ */ new Set();
-  let rejectEnded;
-  const ended = new Promise((_, reject) => {
-    rejectEnded = reject;
-  });
-  const closeRoom = () => {
-    closed = true;
-    signal == null ? void 0 : signal.removeEventListener("abort", onAbort);
-    for (const track of attached) {
-      try {
-        track.detach();
-      } catch {
-      }
-    }
-    attached.clear();
-    disconnecting ?? (disconnecting = room.disconnect().then(() => void 0));
-    return disconnecting;
-  };
-  const onAbort = () => {
-    rejectEnded(endedError());
-    void closeRoom().catch(() => void 0);
-  };
-  signal == null ? void 0 : signal.addEventListener("abort", onAbort, { once: true });
-  if (signal == null ? void 0 : signal.aborted) onAbort();
-  room.on(livekitClient.RoomEvent.TrackSubscribed, (track) => {
-    if (closed || track.kind !== livekitClient.Track.Kind.Audio) return;
-    track.attach(audioElement() ?? void 0);
-    attached.add(track);
-  });
-  room.on(livekitClient.RoomEvent.TrackUnsubscribed, (track) => {
-    if (track.kind !== livekitClient.Track.Kind.Audio) return;
-    if (attached.delete(track)) track.detach();
-  });
-  room.on(livekitClient.RoomEvent.Disconnected, (reason) => {
-    if (closed) return;
-    if (!connected && reason === livekitClient.DisconnectReason.JOIN_FAILURE) return;
-    const label = disconnectReasonLabel(reason);
-    rejectEnded(new Error(label));
-    void closeRoom().catch(() => void 0);
-    if (joined) handlers.onDisconnected(label);
-  });
-  const checkOpen = () => {
-    if (closed) throw endedError();
-  };
-  const joining = (async () => {
-    try {
-      checkOpen();
-      await room.connect(answer.serverUrl, answer.token);
-      connected = true;
-      checkOpen();
-      await room.localParticipant.setMicrophoneEnabled(
-        !handlers.micMuted,
-        MICROPHONE_CAPTURE
-      );
-      checkOpen();
-    } catch (error) {
-      const alreadyClosed = closed;
-      await closeRoom().catch(() => void 0);
-      if (alreadyClosed) await room.disconnect().catch(() => void 0);
-      throw error;
-    }
-  })();
-  await Promise.race([joining, ended]);
-  checkOpen();
-  joined = true;
-  return {
-    setMicrophoneEnabled: (enabled) => {
-      const changing = (async () => {
-        checkOpen();
-        try {
-          await room.localParticipant.setMicrophoneEnabled(enabled);
-          checkOpen();
-        } finally {
-          if (closed) await room.disconnect().catch(() => void 0);
+  return voiceMedia.connectVoiceMedia({
+    handlers,
+    createDriver: () => {
+      const room = roomFactory();
+      let closed = false;
+      const attached = /* @__PURE__ */ new Set();
+      room.on(livekitClient.RoomEvent.TrackSubscribed, (track, publication, participant) => {
+        if (closed || track.kind !== livekitClient.Track.Kind.Audio) return;
+        if (participant !== void 0 && voiceMedia.isOwnOtherVoiceDevice({
+          identity: participant.identity,
+          localIdentity: room.localParticipant.identity
+        })) {
+          publication == null ? void 0 : publication.setSubscribed(false);
+          return;
         }
-      })();
-      return Promise.race([changing, ended]);
-    },
-    disconnect: () => {
-      rejectEnded(endedError());
-      return closeRoom();
+        track.attach(audioElement() ?? void 0);
+        attached.add(track);
+      });
+      room.on(livekitClient.RoomEvent.TrackUnsubscribed, (track) => {
+        if (track.kind !== livekitClient.Track.Kind.Audio) return;
+        if (attached.delete(track)) track.detach();
+      });
+      return {
+        connect: () => room.connect(answer.serverUrl, answer.token),
+        setMicrophoneEnabled: ({ enabled, initial }) => room.localParticipant.setMicrophoneEnabled(
+          enabled,
+          initial ? voiceMedia.VOICE_MICROPHONE_CAPTURE : void 0
+        ),
+        disconnect: () => {
+          closed = true;
+          for (const track of attached) {
+            try {
+              track.detach();
+            } catch {
+            }
+          }
+          attached.clear();
+          return room.disconnect();
+        },
+        onDisconnected: (listener) => {
+          room.on(livekitClient.RoomEvent.Disconnected, (reason) => {
+            const name = reason === void 0 ? void 0 : livekitClient.DisconnectReason[reason];
+            listener({
+              reason: reason === void 0 ? "room-disconnected" : `room-disconnected:${(name ?? String(reason)).toLowerCase()}`,
+              joinFailure: reason === livekitClient.DisconnectReason.JOIN_FAILURE
+            });
+          });
+        }
+      };
     }
-  };
+  });
 }
 exports.joinDeepAgentVoiceRoom = joinDeepAgentVoiceRoom;
 //# sourceMappingURL=livekit-join.cjs.map

package/dist/voice/livekit-join.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"livekit-join.cjs","sources":["../../src/voice/livekit-join.ts"],"sourcesContent":["import type {\n  DeepAgentVoiceLiveKitSession,\n  DeepAgentVoiceLiveKitRoom,\n  DeepAgentVoiceLiveKitRemoteTrack,\n  JoinDeepAgentVoiceRoomOptions,\n} from './livekit';\nimport {\n  type AudioCaptureOptions,\n  DisconnectReason,\n  Room,\n  RoomEvent,\n  Track,\n} from 'livekit-client';\n\n/** Conversation-grade capture: the same processing the transcriber asks for. */\nconst MICROPHONE_CAPTURE = {\n  echoCancellation: true,\n  noiseSuppression: true,\n  autoGainControl: true,\n} satisfies AudioCaptureOptions;\n\n/** The media-loss reason the session state machine records for a room drop. */\nconst disconnectReasonLabel = (\n  reason: DisconnectReason | undefined,\n): string => {\n  if (reason === undefined) return 'room-disconnected';\n  const name: string | undefined = DisconnectReason[reason];\n  return `room-disconnected:${(name ?? String(reason)).toLowerCase()}`;\n};\n\n// One remote audio track: adaptive stream and dynacast are video levers.\nconst defaultRoomFactory = (): DeepAgentVoiceLiveKitRoom =>\n  new Room({\n    adaptiveStream: false,\n    dynacast: false,\n    audioCaptureDefaults: MICROPHONE_CAPTURE,\n    publishDefaults: { stopMicTrackOnMute: true },\n  });\n\n/**\n * The LiveKit half of the composer's voice adapter (`livekit.ts`),\n * loaded when a session joins its room: join the room the host minted, publish\n * the microphone, play the agent's track, and report a drop. Everything that\n * needs `livekit-client` at runtime lives here, behind that one import.\n */\nexport async function joinDeepAgentVoiceRoom({\n  answer,\n  handlers,\n  audioElement,\n  roomFactory = defaultRoomFactory,\n}: JoinDeepAgentVoiceRoomOptions): Promise<DeepAgentVoiceLiveKitSession> {\n  const { signal } = handlers;\n  const endedError = () =>\n    new DOMException('The voice session ended', 'AbortError');\n  if (signal?.aborted) throw endedError();\n  const room = roomFactory();\n  let connected = false;\n  let joined = false;\n  let closed = false;\n  let disconnecting: Promise<void> | null = null;\n  const attached = new Set<DeepAgentVoiceLiveKitRemoteTrack>();\n  let rejectEnded!: (error: Error) => void;\n  const ended = new Promise<never>((_, reject) => {\n    rejectEnded = reject;\n  });\n  const closeRoom = (): Promise<void> => {\n    closed = true;\n    signal?.removeEventListener('abort', onAbort);\n    for (const track of attached) {\n      try {\n        track.detach();\n      } catch {\n        /* Release the remaining tracks too. */\n      }\n    }\n    attached.clear();\n    disconnecting ??= room.disconnect().then(() => undefined);\n    return disconnecting;\n  };\n  const onAbort = (): void => {\n    rejectEnded(endedError());\n    void closeRoom().catch(() => undefined);\n  };\n  signal?.addEventListener('abort', onAbort, { once: true });\n  // A custom factory may synchronously end its caller's attempt.\n  if (signal?.aborted) onAbort();\n  room.on(RoomEvent.TrackSubscribed, (track) => {\n    if (closed || track.kind !== Track.Kind.Audio) return;\n    track.attach(audioElement() ?? undefined);\n    attached.add(track);\n  });\n  room.on(RoomEvent.TrackUnsubscribed, (track) => {\n    if (track.kind !== Track.Kind.Audio) return;\n    if (attached.delete(track)) track.detach();\n  });\n  room.on(RoomEvent.Disconnected, (reason) => {\n    if (closed) return;\n    // Room.connect() emits JOIN_FAILURE before rejecting with its real cause.\n    // Preserve that error (including microphone/permission classifications).\n    if (!connected && reason === DisconnectReason.JOIN_FAILURE) return;\n    // A drop can follow connect() while capture is still pending. Settle the\n    // join now; the platform operation may neither resolve nor reject yet.\n    const label = disconnectReasonLabel(reason);\n    rejectEnded(new Error(label));\n    void closeRoom().catch(() => undefined);\n    if (joined) handlers.onDisconnected(label);\n  });\n  const checkOpen = (): void => {\n    if (closed) throw endedError();\n  };\n  const joining = (async () => {\n    try {\n      checkOpen();\n      await room.connect(answer.serverUrl, answer.token);\n      connected = true;\n      checkOpen();\n      await room.localParticipant.setMicrophoneEnabled(\n        !handlers.micMuted,\n        MICROPHONE_CAPTURE,\n      );\n      checkOpen();\n    } catch (error) {\n      const alreadyClosed = closed;\n      await closeRoom().catch(() => undefined);\n      // An uncancellable capture/join may finish after the first disconnect.\n      if (alreadyClosed) await room.disconnect().catch(() => undefined);\n      throw error;\n    }\n  })();\n  await Promise.race([joining, ended]);\n  checkOpen();\n  joined = true;\n  return {\n    setMicrophoneEnabled: (enabled) => {\n      const changing = (async () => {\n        checkOpen();\n        try {\n          await room.localParticipant.setMicrophoneEnabled(enabled);\n          checkOpen();\n        } finally {\n          if (closed) await room.disconnect().catch(() => undefined);\n        }\n      })();\n      return Promise.race([changing, ended]);\n    },\n    disconnect: () => {\n      rejectEnded(endedError());\n      return closeRoom();\n    },\n  };\n}\n"],"names":["DisconnectReason","Room","RoomEvent","Track"],"mappings":"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"}
+{"version":3,"file":"livekit-join.cjs","sources":["../../src/voice/livekit-join.ts"],"sourcesContent":["import {\n  connectVoiceMedia,\n  isOwnOtherVoiceDevice,\n  VOICE_MICROPHONE_CAPTURE,\n} from '@athenaintel/agent-runtime/voice-media';\nimport { DisconnectReason, Room, RoomEvent, Track } from 'livekit-client';\nimport type {\n  DeepAgentVoiceLiveKitSession,\n  DeepAgentVoiceLiveKitRoom,\n  DeepAgentVoiceLiveKitRemoteTrack,\n  JoinDeepAgentVoiceRoomOptions,\n} from './livekit';\n\n// One remote audio track: adaptive stream and dynacast are video levers.\nconst defaultRoomFactory = (): DeepAgentVoiceLiveKitRoom =>\n  new Room({\n    adaptiveStream: false,\n    dynacast: false,\n    audioCaptureDefaults: VOICE_MICROPHONE_CAPTURE,\n    publishDefaults: { stopMicTrackOnMute: true },\n  });\n\n/** Browser audio sinks around the same media lifecycle used by native chat. */\nexport function joinDeepAgentVoiceRoom({\n  answer,\n  handlers,\n  audioElement,\n  roomFactory = defaultRoomFactory,\n}: JoinDeepAgentVoiceRoomOptions): Promise<DeepAgentVoiceLiveKitSession> {\n  return connectVoiceMedia({\n    handlers,\n    createDriver: () => {\n      const room = roomFactory();\n      let closed = false;\n      const attached = new Set<DeepAgentVoiceLiveKitRemoteTrack>();\n      room.on(RoomEvent.TrackSubscribed, (track, publication, participant) => {\n        if (closed || track.kind !== Track.Kind.Audio) return;\n        // While a call moves here (or away), the person's other device is in\n        // the room too. Its microphone must not reach the one sink: attaching\n        // it would replace the agent's audio, and its departure would leave\n        // this device silent for the rest of the call.\n        if (\n          participant !== undefined &&\n          isOwnOtherVoiceDevice({\n            identity: participant.identity,\n            localIdentity: room.localParticipant.identity,\n          })\n        ) {\n          publication?.setSubscribed(false);\n          return;\n        }\n        track.attach(audioElement() ?? undefined);\n        attached.add(track);\n      });\n      room.on(RoomEvent.TrackUnsubscribed, (track) => {\n        if (track.kind !== Track.Kind.Audio) return;\n        if (attached.delete(track)) track.detach();\n      });\n      return {\n        connect: () => room.connect(answer.serverUrl, answer.token),\n        setMicrophoneEnabled: ({ enabled, initial }) =>\n          room.localParticipant.setMicrophoneEnabled(\n            enabled,\n            initial ? VOICE_MICROPHONE_CAPTURE : undefined\n          ),\n        disconnect: () => {\n          closed = true;\n          for (const track of attached) {\n            try {\n              track.detach();\n            } catch {\n              /* Release every remaining sink too. */\n            }\n          }\n          attached.clear();\n          return room.disconnect();\n        },\n        onDisconnected: (listener) => {\n          room.on(RoomEvent.Disconnected, (reason) => {\n            const name: string | undefined =\n              reason === undefined ? undefined : DisconnectReason[reason];\n            listener({\n              reason:\n                reason === undefined\n                  ? 'room-disconnected'\n                  : `room-disconnected:${(\n                      name ?? String(reason)\n                    ).toLowerCase()}`,\n              joinFailure: reason === DisconnectReason.JOIN_FAILURE,\n            });\n          });\n        },\n      };\n    },\n  });\n}\n"],"names":["Room","VOICE_MICROPHONE_CAPTURE","connectVoiceMedia","RoomEvent","Track","isOwnOtherVoiceDevice","DisconnectReason"],"mappings":";;;;AAcA,MAAM,qBAAqB,MACzB,IAAIA,mBAAK;AAAA,EACP,gBAAgB;AAAA,EAChB,UAAU;AAAA,EACV,sBAAsBC,WAAAA;AAAAA,EACtB,iBAAiB,EAAE,oBAAoB,KAAA;AACzC,CAAC;AAGI,SAAS,uBAAuB;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA,cAAc;AAChB,GAAyE;AACvE,SAAOC,6BAAkB;AAAA,IACvB;AAAA,IACA,cAAc,MAAM;AAClB,YAAM,OAAO,YAAA;AACb,UAAI,SAAS;AACb,YAAM,+BAAe,IAAA;AACrB,WAAK,GAAGC,wBAAU,iBAAiB,CAAC,OAAO,aAAa,gBAAgB;AACtE,YAAI,UAAU,MAAM,SAASC,cAAAA,MAAM,KAAK,MAAO;AAK/C,YACE,gBAAgB,UAChBC,iCAAsB;AAAA,UACpB,UAAU,YAAY;AAAA,UACtB,eAAe,KAAK,iBAAiB;AAAA,QAAA,CACtC,GACD;AACA,qDAAa,cAAc;AAC3B;AAAA,QACF;AACA,cAAM,OAAO,aAAA,KAAkB,MAAS;AACxC,iBAAS,IAAI,KAAK;AAAA,MACpB,CAAC;AACD,WAAK,GAAGF,cAAAA,UAAU,mBAAmB,CAAC,UAAU;AAC9C,YAAI,MAAM,SAASC,oBAAM,KAAK,MAAO;AACrC,YAAI,SAAS,OAAO,KAAK,SAAS,OAAA;AAAA,MACpC,CAAC;AACD,aAAO;AAAA,QACL,SAAS,MAAM,KAAK,QAAQ,OAAO,WAAW,OAAO,KAAK;AAAA,QAC1D,sBAAsB,CAAC,EAAE,SAAS,QAAA,MAChC,KAAK,iBAAiB;AAAA,UACpB;AAAA,UACA,UAAUH,WAAAA,2BAA2B;AAAA,QAAA;AAAA,QAEzC,YAAY,MAAM;AAChB,mBAAS;AACT,qBAAW,SAAS,UAAU;AAC5B,gBAAI;AACF,oBAAM,OAAA;AAAA,YACR,QAAQ;AAAA,YAER;AAAA,UACF;AACA,mBAAS,MAAA;AACT,iBAAO,KAAK,WAAA;AAAA,QACd;AAAA,QACA,gBAAgB,CAAC,aAAa;AAC5B,eAAK,GAAGE,cAAAA,UAAU,cAAc,CAAC,WAAW;AAC1C,kBAAM,OACJ,WAAW,SAAY,SAAYG,cAAAA,iBAAiB,MAAM;AAC5D,qBAAS;AAAA,cACP,QACE,WAAW,SACP,sBACA,sBACE,QAAQ,OAAO,MAAM,GACrB,YAAA,CAAa;AAAA,cACrB,aAAa,WAAWA,+BAAiB;AAAA,YAAA,CAC1C;AAAA,UACH,CAAC;AAAA,QACH;AAAA,MAAA;AAAA,IAEJ;AAAA,EAAA,CACD;AACH;;"}

package/dist/voice/livekit-join.d.ts

@@ -1,8 +1,3 @@
 import type { DeepAgentVoiceLiveKitSession, JoinDeepAgentVoiceRoomOptions } from './livekit';
-/**
- * The LiveKit half of the composer's voice adapter (`livekit.ts`),
- * loaded when a session joins its room: join the room the host minted, publish
- * the microphone, play the agent's track, and report a drop. Everything that
- * needs `livekit-client` at runtime lives here, behind that one import.
- */
+/** Browser audio sinks around the same media lifecycle used by native chat. */
 export declare function joinDeepAgentVoiceRoom({ answer, handlers, audioElement, roomFactory, }: JoinDeepAgentVoiceRoomOptions): Promise<DeepAgentVoiceLiveKitSession>;

package/dist/voice/livekit-join.js

@@ -1,117 +1,68 @@
+import { connectVoiceMedia, VOICE_MICROPHONE_CAPTURE, isOwnOtherVoiceDevice } from "../agent-runtime/src/voice-media.js";
 import { Room, RoomEvent, Track, DisconnectReason } from "livekit-client";
-const MICROPHONE_CAPTURE = {
-  echoCancellation: true,
-  noiseSuppression: true,
-  autoGainControl: true
-};
-const disconnectReasonLabel = (reason) => {
-  if (reason === void 0) return "room-disconnected";
-  const name = DisconnectReason[reason];
-  return `room-disconnected:${(name ?? String(reason)).toLowerCase()}`;
-};
 const defaultRoomFactory = () => new Room({
   adaptiveStream: false,
   dynacast: false,
-  audioCaptureDefaults: MICROPHONE_CAPTURE,
+  audioCaptureDefaults: VOICE_MICROPHONE_CAPTURE,
   publishDefaults: { stopMicTrackOnMute: true }
 });
-async function joinDeepAgentVoiceRoom({
+function joinDeepAgentVoiceRoom({
   answer,
   handlers,
   audioElement,
   roomFactory = defaultRoomFactory
 }) {
-  const { signal } = handlers;
-  const endedError = () => new DOMException("The voice session ended", "AbortError");
-  if (signal == null ? void 0 : signal.aborted) throw endedError();
-  const room = roomFactory();
-  let connected = false;
-  let joined = false;
-  let closed = false;
-  let disconnecting = null;
-  const attached = /* @__PURE__ */ new Set();
-  let rejectEnded;
-  const ended = new Promise((_, reject) => {
-    rejectEnded = reject;
-  });
-  const closeRoom = () => {
-    closed = true;
-    signal == null ? void 0 : signal.removeEventListener("abort", onAbort);
-    for (const track of attached) {
-      try {
-        track.detach();
-      } catch {
-      }
-    }
-    attached.clear();
-    disconnecting ?? (disconnecting = room.disconnect().then(() => void 0));
-    return disconnecting;
-  };
-  const onAbort = () => {
-    rejectEnded(endedError());
-    void closeRoom().catch(() => void 0);
-  };
-  signal == null ? void 0 : signal.addEventListener("abort", onAbort, { once: true });
-  if (signal == null ? void 0 : signal.aborted) onAbort();
-  room.on(RoomEvent.TrackSubscribed, (track) => {
-    if (closed || track.kind !== Track.Kind.Audio) return;
-    track.attach(audioElement() ?? void 0);
-    attached.add(track);
-  });
-  room.on(RoomEvent.TrackUnsubscribed, (track) => {
-    if (track.kind !== Track.Kind.Audio) return;
-    if (attached.delete(track)) track.detach();
-  });
-  room.on(RoomEvent.Disconnected, (reason) => {
-    if (closed) return;
-    if (!connected && reason === DisconnectReason.JOIN_FAILURE) return;
-    const label = disconnectReasonLabel(reason);
-    rejectEnded(new Error(label));
-    void closeRoom().catch(() => void 0);
-    if (joined) handlers.onDisconnected(label);
-  });
-  const checkOpen = () => {
-    if (closed) throw endedError();
-  };
-  const joining = (async () => {
-    try {
-      checkOpen();
-      await room.connect(answer.serverUrl, answer.token);
-      connected = true;
-      checkOpen();
-      await room.localParticipant.setMicrophoneEnabled(
-        !handlers.micMuted,
-        MICROPHONE_CAPTURE
-      );
-      checkOpen();
-    } catch (error) {
-      const alreadyClosed = closed;
-      await closeRoom().catch(() => void 0);
-      if (alreadyClosed) await room.disconnect().catch(() => void 0);
-      throw error;
-    }
-  })();
-  await Promise.race([joining, ended]);
-  checkOpen();
-  joined = true;
-  return {
-    setMicrophoneEnabled: (enabled) => {
-      const changing = (async () => {
-        checkOpen();
-        try {
-          await room.localParticipant.setMicrophoneEnabled(enabled);
-          checkOpen();
-        } finally {
-          if (closed) await room.disconnect().catch(() => void 0);
+  return connectVoiceMedia({
+    handlers,
+    createDriver: () => {
+      const room = roomFactory();
+      let closed = false;
+      const attached = /* @__PURE__ */ new Set();
+      room.on(RoomEvent.TrackSubscribed, (track, publication, participant) => {
+        if (closed || track.kind !== Track.Kind.Audio) return;
+        if (participant !== void 0 && isOwnOtherVoiceDevice({
+          identity: participant.identity,
+          localIdentity: room.localParticipant.identity
+        })) {
+          publication == null ? void 0 : publication.setSubscribed(false);
+          return;
         }
-      })();
-      return Promise.race([changing, ended]);
-    },
-    disconnect: () => {
-      rejectEnded(endedError());
-      return closeRoom();
+        track.attach(audioElement() ?? void 0);
+        attached.add(track);
+      });
+      room.on(RoomEvent.TrackUnsubscribed, (track) => {
+        if (track.kind !== Track.Kind.Audio) return;
+        if (attached.delete(track)) track.detach();
+      });
+      return {
+        connect: () => room.connect(answer.serverUrl, answer.token),
+        setMicrophoneEnabled: ({ enabled, initial }) => room.localParticipant.setMicrophoneEnabled(
+          enabled,
+          initial ? VOICE_MICROPHONE_CAPTURE : void 0
+        ),
+        disconnect: () => {
+          closed = true;
+          for (const track of attached) {
+            try {
+              track.detach();
+            } catch {
+            }
+          }
+          attached.clear();
+          return room.disconnect();
+        },
+        onDisconnected: (listener) => {
+          room.on(RoomEvent.Disconnected, (reason) => {
+            const name = reason === void 0 ? void 0 : DisconnectReason[reason];
+            listener({
+              reason: reason === void 0 ? "room-disconnected" : `room-disconnected:${(name ?? String(reason)).toLowerCase()}`,
+              joinFailure: reason === DisconnectReason.JOIN_FAILURE
+            });
+          });
+        }
+      };
     }
-  };
+  });
 }
 export {
   joinDeepAgentVoiceRoom

package/dist/voice/livekit-join.js.map

@@ -1 +1 @@
-{"version":3,"file":"livekit-join.js","sources":["../../src/voice/livekit-join.ts"],"sourcesContent":["import type {\n  DeepAgentVoiceLiveKitSession,\n  DeepAgentVoiceLiveKitRoom,\n  DeepAgentVoiceLiveKitRemoteTrack,\n  JoinDeepAgentVoiceRoomOptions,\n} from './livekit';\nimport {\n  type AudioCaptureOptions,\n  DisconnectReason,\n  Room,\n  RoomEvent,\n  Track,\n} from 'livekit-client';\n\n/** Conversation-grade capture: the same processing the transcriber asks for. */\nconst MICROPHONE_CAPTURE = {\n  echoCancellation: true,\n  noiseSuppression: true,\n  autoGainControl: true,\n} satisfies AudioCaptureOptions;\n\n/** The media-loss reason the session state machine records for a room drop. */\nconst disconnectReasonLabel = (\n  reason: DisconnectReason | undefined,\n): string => {\n  if (reason === undefined) return 'room-disconnected';\n  const name: string | undefined = DisconnectReason[reason];\n  return `room-disconnected:${(name ?? String(reason)).toLowerCase()}`;\n};\n\n// One remote audio track: adaptive stream and dynacast are video levers.\nconst defaultRoomFactory = (): DeepAgentVoiceLiveKitRoom =>\n  new Room({\n    adaptiveStream: false,\n    dynacast: false,\n    audioCaptureDefaults: MICROPHONE_CAPTURE,\n    publishDefaults: { stopMicTrackOnMute: true },\n  });\n\n/**\n * The LiveKit half of the composer's voice adapter (`livekit.ts`),\n * loaded when a session joins its room: join the room the host minted, publish\n * the microphone, play the agent's track, and report a drop. Everything that\n * needs `livekit-client` at runtime lives here, behind that one import.\n */\nexport async function joinDeepAgentVoiceRoom({\n  answer,\n  handlers,\n  audioElement,\n  roomFactory = defaultRoomFactory,\n}: JoinDeepAgentVoiceRoomOptions): Promise<DeepAgentVoiceLiveKitSession> {\n  const { signal } = handlers;\n  const endedError = () =>\n    new DOMException('The voice session ended', 'AbortError');\n  if (signal?.aborted) throw endedError();\n  const room = roomFactory();\n  let connected = false;\n  let joined = false;\n  let closed = false;\n  let disconnecting: Promise<void> | null = null;\n  const attached = new Set<DeepAgentVoiceLiveKitRemoteTrack>();\n  let rejectEnded!: (error: Error) => void;\n  const ended = new Promise<never>((_, reject) => {\n    rejectEnded = reject;\n  });\n  const closeRoom = (): Promise<void> => {\n    closed = true;\n    signal?.removeEventListener('abort', onAbort);\n    for (const track of attached) {\n      try {\n        track.detach();\n      } catch {\n        /* Release the remaining tracks too. */\n      }\n    }\n    attached.clear();\n    disconnecting ??= room.disconnect().then(() => undefined);\n    return disconnecting;\n  };\n  const onAbort = (): void => {\n    rejectEnded(endedError());\n    void closeRoom().catch(() => undefined);\n  };\n  signal?.addEventListener('abort', onAbort, { once: true });\n  // A custom factory may synchronously end its caller's attempt.\n  if (signal?.aborted) onAbort();\n  room.on(RoomEvent.TrackSubscribed, (track) => {\n    if (closed || track.kind !== Track.Kind.Audio) return;\n    track.attach(audioElement() ?? undefined);\n    attached.add(track);\n  });\n  room.on(RoomEvent.TrackUnsubscribed, (track) => {\n    if (track.kind !== Track.Kind.Audio) return;\n    if (attached.delete(track)) track.detach();\n  });\n  room.on(RoomEvent.Disconnected, (reason) => {\n    if (closed) return;\n    // Room.connect() emits JOIN_FAILURE before rejecting with its real cause.\n    // Preserve that error (including microphone/permission classifications).\n    if (!connected && reason === DisconnectReason.JOIN_FAILURE) return;\n    // A drop can follow connect() while capture is still pending. Settle the\n    // join now; the platform operation may neither resolve nor reject yet.\n    const label = disconnectReasonLabel(reason);\n    rejectEnded(new Error(label));\n    void closeRoom().catch(() => undefined);\n    if (joined) handlers.onDisconnected(label);\n  });\n  const checkOpen = (): void => {\n    if (closed) throw endedError();\n  };\n  const joining = (async () => {\n    try {\n      checkOpen();\n      await room.connect(answer.serverUrl, answer.token);\n      connected = true;\n      checkOpen();\n      await room.localParticipant.setMicrophoneEnabled(\n        !handlers.micMuted,\n        MICROPHONE_CAPTURE,\n      );\n      checkOpen();\n    } catch (error) {\n      const alreadyClosed = closed;\n      await closeRoom().catch(() => undefined);\n      // An uncancellable capture/join may finish after the first disconnect.\n      if (alreadyClosed) await room.disconnect().catch(() => undefined);\n      throw error;\n    }\n  })();\n  await Promise.race([joining, ended]);\n  checkOpen();\n  joined = true;\n  return {\n    setMicrophoneEnabled: (enabled) => {\n      const changing = (async () => {\n        checkOpen();\n        try {\n          await room.localParticipant.setMicrophoneEnabled(enabled);\n          checkOpen();\n        } finally {\n          if (closed) await room.disconnect().catch(() => undefined);\n        }\n      })();\n      return Promise.race([changing, ended]);\n    },\n    disconnect: () => {\n      rejectEnded(endedError());\n      return closeRoom();\n    },\n  };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"livekit-join.js","sources":["../../src/voice/livekit-join.ts"],"sourcesContent":["import {\n  connectVoiceMedia,\n  isOwnOtherVoiceDevice,\n  VOICE_MICROPHONE_CAPTURE,\n} from '@athenaintel/agent-runtime/voice-media';\nimport { DisconnectReason, Room, RoomEvent, Track } from 'livekit-client';\nimport type {\n  DeepAgentVoiceLiveKitSession,\n  DeepAgentVoiceLiveKitRoom,\n  DeepAgentVoiceLiveKitRemoteTrack,\n  JoinDeepAgentVoiceRoomOptions,\n} from './livekit';\n\n// One remote audio track: adaptive stream and dynacast are video levers.\nconst defaultRoomFactory = (): DeepAgentVoiceLiveKitRoom =>\n  new Room({\n    adaptiveStream: false,\n    dynacast: false,\n    audioCaptureDefaults: VOICE_MICROPHONE_CAPTURE,\n    publishDefaults: { stopMicTrackOnMute: true },\n  });\n\n/** Browser audio sinks around the same media lifecycle used by native chat. */\nexport function joinDeepAgentVoiceRoom({\n  answer,\n  handlers,\n  audioElement,\n  roomFactory = defaultRoomFactory,\n}: JoinDeepAgentVoiceRoomOptions): Promise<DeepAgentVoiceLiveKitSession> {\n  return connectVoiceMedia({\n    handlers,\n    createDriver: () => {\n      const room = roomFactory();\n      let closed = false;\n      const attached = new Set<DeepAgentVoiceLiveKitRemoteTrack>();\n      room.on(RoomEvent.TrackSubscribed, (track, publication, participant) => {\n        if (closed || track.kind !== Track.Kind.Audio) return;\n        // While a call moves here (or away), the person's other device is in\n        // the room too. Its microphone must not reach the one sink: attaching\n        // it would replace the agent's audio, and its departure would leave\n        // this device silent for the rest of the call.\n        if (\n          participant !== undefined &&\n          isOwnOtherVoiceDevice({\n            identity: participant.identity,\n            localIdentity: room.localParticipant.identity,\n          })\n        ) {\n          publication?.setSubscribed(false);\n          return;\n        }\n        track.attach(audioElement() ?? undefined);\n        attached.add(track);\n      });\n      room.on(RoomEvent.TrackUnsubscribed, (track) => {\n        if (track.kind !== Track.Kind.Audio) return;\n        if (attached.delete(track)) track.detach();\n      });\n      return {\n        connect: () => room.connect(answer.serverUrl, answer.token),\n        setMicrophoneEnabled: ({ enabled, initial }) =>\n          room.localParticipant.setMicrophoneEnabled(\n            enabled,\n            initial ? VOICE_MICROPHONE_CAPTURE : undefined\n          ),\n        disconnect: () => {\n          closed = true;\n          for (const track of attached) {\n            try {\n              track.detach();\n            } catch {\n              /* Release every remaining sink too. */\n            }\n          }\n          attached.clear();\n          return room.disconnect();\n        },\n        onDisconnected: (listener) => {\n          room.on(RoomEvent.Disconnected, (reason) => {\n            const name: string | undefined =\n              reason === undefined ? undefined : DisconnectReason[reason];\n            listener({\n              reason:\n                reason === undefined\n                  ? 'room-disconnected'\n                  : `room-disconnected:${(\n                      name ?? String(reason)\n                    ).toLowerCase()}`,\n              joinFailure: reason === DisconnectReason.JOIN_FAILURE,\n            });\n          });\n        },\n      };\n    },\n  });\n}\n"],"names":[],"mappings":";;AAcA,MAAM,qBAAqB,MACzB,IAAI,KAAK;AAAA,EACP,gBAAgB;AAAA,EAChB,UAAU;AAAA,EACV,sBAAsB;AAAA,EACtB,iBAAiB,EAAE,oBAAoB,KAAA;AACzC,CAAC;AAGI,SAAS,uBAAuB;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA,cAAc;AAChB,GAAyE;AACvE,SAAO,kBAAkB;AAAA,IACvB;AAAA,IACA,cAAc,MAAM;AAClB,YAAM,OAAO,YAAA;AACb,UAAI,SAAS;AACb,YAAM,+BAAe,IAAA;AACrB,WAAK,GAAG,UAAU,iBAAiB,CAAC,OAAO,aAAa,gBAAgB;AACtE,YAAI,UAAU,MAAM,SAAS,MAAM,KAAK,MAAO;AAK/C,YACE,gBAAgB,UAChB,sBAAsB;AAAA,UACpB,UAAU,YAAY;AAAA,UACtB,eAAe,KAAK,iBAAiB;AAAA,QAAA,CACtC,GACD;AACA,qDAAa,cAAc;AAC3B;AAAA,QACF;AACA,cAAM,OAAO,aAAA,KAAkB,MAAS;AACxC,iBAAS,IAAI,KAAK;AAAA,MACpB,CAAC;AACD,WAAK,GAAG,UAAU,mBAAmB,CAAC,UAAU;AAC9C,YAAI,MAAM,SAAS,MAAM,KAAK,MAAO;AACrC,YAAI,SAAS,OAAO,KAAK,SAAS,OAAA;AAAA,MACpC,CAAC;AACD,aAAO;AAAA,QACL,SAAS,MAAM,KAAK,QAAQ,OAAO,WAAW,OAAO,KAAK;AAAA,QAC1D,sBAAsB,CAAC,EAAE,SAAS,QAAA,MAChC,KAAK,iBAAiB;AAAA,UACpB;AAAA,UACA,UAAU,2BAA2B;AAAA,QAAA;AAAA,QAEzC,YAAY,MAAM;AAChB,mBAAS;AACT,qBAAW,SAAS,UAAU;AAC5B,gBAAI;AACF,oBAAM,OAAA;AAAA,YACR,QAAQ;AAAA,YAER;AAAA,UACF;AACA,mBAAS,MAAA;AACT,iBAAO,KAAK,WAAA;AAAA,QACd;AAAA,QACA,gBAAgB,CAAC,aAAa;AAC5B,eAAK,GAAG,UAAU,cAAc,CAAC,WAAW;AAC1C,kBAAM,OACJ,WAAW,SAAY,SAAY,iBAAiB,MAAM;AAC5D,qBAAS;AAAA,cACP,QACE,WAAW,SACP,sBACA,sBACE,QAAQ,OAAO,MAAM,GACrB,YAAA,CAAa;AAAA,cACrB,aAAa,WAAW,iBAAiB;AAAA,YAAA,CAC1C;AAAA,UACH,CAAC;AAAA,QACH;AAAA,MAAA;AAAA,IAEJ;AAAA,EAAA,CACD;AACH;"}

package/dist/voice/livekit.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"livekit.cjs","sources":["../../src/voice/livekit.ts"],"sourcesContent":["/** Media credentials already authorized and issued by the chat host. */\nexport interface DeepAgentVoiceLiveKitCredentials {\n  serverUrl: string;\n  token: string;\n}\n\n/** The media controls the shared chat voice lifecycle drives. */\nexport interface DeepAgentVoiceLiveKitSession {\n  setMicrophoneEnabled(enabled: boolean): Promise<void>;\n  disconnect(): Promise<void>;\n}\n\n/** Lifecycle controls supplied by the owning chat voice attempt. */\nexport interface DeepAgentVoiceLiveKitHandlers {\n  micMuted: boolean;\n  /** Ends pending and joined media with the owning chat voice attempt. */\n  signal?: AbortSignal;\n  onDisconnected: (reason: string) => void;\n}\n\n/** Structural media boundary; compatible with the shared agent runtime. */\nexport interface DeepAgentVoiceLiveKitAdapter {\n  connect(\n    answer: DeepAgentVoiceLiveKitCredentials,\n    handlers: DeepAgentVoiceLiveKitHandlers,\n  ): Promise<DeepAgentVoiceLiveKitSession>;\n}\n\n/** The remote-track surface the adapter drives (`RemoteTrack`, structurally). */\nexport interface DeepAgentVoiceLiveKitRemoteTrack {\n  readonly kind: 'audio' | 'video' | 'unknown';\n  /** Without an element LiveKit creates a detached, autoplaying one. */\n  attach(element?: HTMLMediaElement): HTMLMediaElement;\n  detach(): HTMLMediaElement[];\n}\n\n/**\n * The slice of `livekit-client`'s `Room` the adapter drives — a real `Room`\n * satisfies it; tests inject a fake through `roomFactory`.\n */\nexport interface DeepAgentVoiceLiveKitRoom {\n  readonly localParticipant: {\n    setMicrophoneEnabled(\n      enabled: boolean,\n      options?: {\n        echoCancellation?: boolean;\n        noiseSuppression?: boolean;\n        autoGainControl?: boolean;\n      },\n    ): Promise<unknown>;\n  };\n  connect(url: string, token: string): Promise<void>;\n  disconnect(): Promise<unknown>;\n  on(\n    event: 'trackSubscribed',\n    listener: (track: DeepAgentVoiceLiveKitRemoteTrack) => void,\n  ): unknown;\n  on(\n    event: 'trackUnsubscribed',\n    listener: (track: DeepAgentVoiceLiveKitRemoteTrack) => void,\n  ): unknown;\n  on(event: 'disconnected', listener: (reason?: number) => void): unknown;\n}\n\nexport interface CreateDeepAgentVoiceLiveKitAdapterOptions {\n  /**\n   * The `<audio>` sink for the agent participant's track, read when the track\n   * arrives; `null` lets LiveKit play through an element of its own.\n   */\n  audioElement: () => HTMLAudioElement | null;\n  /** Test seam; defaults to a fresh `livekit-client` `Room`. */\n  roomFactory?: () => DeepAgentVoiceLiveKitRoom;\n}\n\ntype DeepAgentVoiceLiveKitJoin = typeof import('./livekit-join');\n\nlet joinModuleLoad: Promise<DeepAgentVoiceLiveKitJoin> | null = null;\n\n/**\n * The room join and `livekit-client` (~120 KB gzip) are fetched when a voice\n * session starts, not with the composer: every Spaces boot mounts the\n * composer, few start a voice session. One `import()` keeps LiveKit in one\n * lazy chunk group. A failed import is not memoized: the next session imports\n * again.\n */\nexport const loadDeepAgentVoiceLiveKitJoin =\n  (): Promise<DeepAgentVoiceLiveKitJoin> => {\n    joinModuleLoad ??= import('./livekit-join').catch((error: unknown) => {\n      joinModuleLoad = null;\n      throw error;\n    });\n    return joinModuleLoad;\n  };\n\n/**\n * The composer's LiveKit leg for the shared voice session\n * (`useDeepAgentVoice({ transport: 'livekit' })`): join the room the host\n * minted, publish the microphone, play the agent's track, and report a drop\n * (`joinDeepAgentVoiceRoom`, loaded on the first join).\n */\nexport const createDeepAgentVoiceLiveKitAdapter = ({\n  audioElement,\n  roomFactory,\n}: CreateDeepAgentVoiceLiveKitAdapterOptions): DeepAgentVoiceLiveKitAdapter => ({\n  async connect(\n    answer: DeepAgentVoiceLiveKitCredentials,\n    handlers: DeepAgentVoiceLiveKitHandlers,\n  ): Promise<DeepAgentVoiceLiveKitSession> {\n    const { joinDeepAgentVoiceRoom } = await loadDeepAgentVoiceLiveKitJoin();\n    return joinDeepAgentVoiceRoom({\n      answer,\n      handlers,\n      audioElement,\n      roomFactory,\n    });\n  },\n});\n\n/** Join with an already-authorized room answer without eagerly loading LiveKit. */\nexport async function joinDeepAgentVoiceRoom(\n  options: JoinDeepAgentVoiceRoomOptions,\n): Promise<DeepAgentVoiceLiveKitSession> {\n  const join = await loadDeepAgentVoiceLiveKitJoin();\n  return join.joinDeepAgentVoiceRoom(options);\n}\n\nexport interface JoinDeepAgentVoiceRoomOptions {\n  answer: DeepAgentVoiceLiveKitCredentials;\n  handlers: DeepAgentVoiceLiveKitHandlers;\n  audioElement: () => HTMLAudioElement | null;\n  roomFactory?: () => DeepAgentVoiceLiveKitRoom;\n}\n"],"names":["joinDeepAgentVoiceRoom"],"mappings":";;AA4EA,IAAI,iBAA4D;AASzD,MAAM,gCACX,MAA0C;AACxC,sCAAmB,QAAA,QAAA,EAAA,KAAA,MAAA,QAAO,oBAAgB,CAAA,EAAE,MAAM,CAAC,UAAmB;AACpE,qBAAiB;AACjB,UAAM;AAAA,EACR,CAAC;AACD,SAAO;AACT;AAQK,MAAM,qCAAqC,CAAC;AAAA,EACjD;AAAA,EACA;AACF,OAAgF;AAAA,EAC9E,MAAM,QACJ,QACA,UACuC;AACvC,UAAM,EAAE,wBAAAA,wBAAAA,IAA2B,MAAM,8BAAA;AACzC,WAAOA,wBAAuB;AAAA,MAC5B;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IAAA,CACD;AAAA,EACH;AACF;AAGA,eAAsB,uBACpB,SACuC;AACvC,QAAM,OAAO,MAAM,8BAAA;AACnB,SAAO,KAAK,uBAAuB,OAAO;AAC5C;;;;"}
+{"version":3,"file":"livekit.cjs","sources":["../../src/voice/livekit.ts"],"sourcesContent":["/** Media credentials already authorized and issued by the chat host. */\nexport interface DeepAgentVoiceLiveKitCredentials {\n  serverUrl: string;\n  token: string;\n}\n\n/** The media controls the shared chat voice lifecycle drives. */\nexport interface DeepAgentVoiceLiveKitSession {\n  setMicrophoneEnabled(enabled: boolean): Promise<void>;\n  disconnect(): Promise<void>;\n}\n\n/** Lifecycle controls supplied by the owning chat voice attempt. */\nexport interface DeepAgentVoiceLiveKitHandlers {\n  micMuted: boolean;\n  /** Ends pending and joined media with the owning chat voice attempt. */\n  signal?: AbortSignal;\n  onDisconnected: (reason: string) => void;\n}\n\n/** Structural media boundary; compatible with the shared agent runtime. */\nexport interface DeepAgentVoiceLiveKitAdapter {\n  connect(\n    answer: DeepAgentVoiceLiveKitCredentials,\n    handlers: DeepAgentVoiceLiveKitHandlers,\n  ): Promise<DeepAgentVoiceLiveKitSession>;\n}\n\n/** The remote-track surface the adapter drives (`RemoteTrack`, structurally). */\nexport interface DeepAgentVoiceLiveKitRemoteTrack {\n  readonly kind: 'audio' | 'video' | 'unknown';\n  /** Without an element LiveKit creates a detached, autoplaying one. */\n  attach(element?: HTMLMediaElement): HTMLMediaElement;\n  detach(): HTMLMediaElement[];\n}\n\n/** The publication a remote track arrived on (`RemoteTrackPublication`, structurally). */\nexport interface DeepAgentVoiceLiveKitRemotePublication {\n  setSubscribed(subscribed: boolean): void;\n}\n\n/** Who published a remote track (`RemoteParticipant`, structurally). */\nexport interface DeepAgentVoiceLiveKitRemoteParticipant {\n  readonly identity: string;\n}\n\n/**\n * The slice of `livekit-client`'s `Room` the adapter drives — a real `Room`\n * satisfies it; tests inject a fake through `roomFactory`.\n */\nexport interface DeepAgentVoiceLiveKitRoom {\n  readonly localParticipant: {\n    /** This device's participant, known once the room is joined. */\n    readonly identity?: string;\n    setMicrophoneEnabled(\n      enabled: boolean,\n      options?: {\n        echoCancellation?: boolean;\n        noiseSuppression?: boolean;\n        autoGainControl?: boolean;\n      },\n    ): Promise<unknown>;\n  };\n  connect(url: string, token: string): Promise<void>;\n  disconnect(): Promise<unknown>;\n  on(\n    event: 'trackSubscribed',\n    listener: (\n      track: DeepAgentVoiceLiveKitRemoteTrack,\n      publication?: DeepAgentVoiceLiveKitRemotePublication,\n      participant?: DeepAgentVoiceLiveKitRemoteParticipant,\n    ) => void,\n  ): unknown;\n  on(\n    event: 'trackUnsubscribed',\n    listener: (track: DeepAgentVoiceLiveKitRemoteTrack) => void,\n  ): unknown;\n  on(event: 'disconnected', listener: (reason?: number) => void): unknown;\n}\n\nexport interface CreateDeepAgentVoiceLiveKitAdapterOptions {\n  /**\n   * The `<audio>` sink for the agent participant's track, read when the track\n   * arrives; `null` lets LiveKit play through an element of its own.\n   */\n  audioElement: () => HTMLAudioElement | null;\n  /** Test seam; defaults to a fresh `livekit-client` `Room`. */\n  roomFactory?: () => DeepAgentVoiceLiveKitRoom;\n}\n\ntype DeepAgentVoiceLiveKitJoin = typeof import('./livekit-join');\n\nlet joinModuleLoad: Promise<DeepAgentVoiceLiveKitJoin> | null = null;\n\n/**\n * The room join and `livekit-client` (~120 KB gzip) are fetched when a voice\n * session starts, not with the composer: every Spaces boot mounts the\n * composer, few start a voice session. One `import()` keeps LiveKit in one\n * lazy chunk group. A failed import is not memoized: the next session imports\n * again.\n */\nexport const loadDeepAgentVoiceLiveKitJoin =\n  (): Promise<DeepAgentVoiceLiveKitJoin> => {\n    joinModuleLoad ??= import('./livekit-join').catch((error: unknown) => {\n      joinModuleLoad = null;\n      throw error;\n    });\n    return joinModuleLoad;\n  };\n\n/**\n * The composer's LiveKit leg for the shared voice session\n * (`useDeepAgentVoice({ transport: 'livekit' })`): join the room the host\n * minted, publish the microphone, play the agent's track, and report a drop\n * (`joinDeepAgentVoiceRoom`, loaded on the first join).\n */\nexport const createDeepAgentVoiceLiveKitAdapter = ({\n  audioElement,\n  roomFactory,\n}: CreateDeepAgentVoiceLiveKitAdapterOptions): DeepAgentVoiceLiveKitAdapter => ({\n  async connect(\n    answer: DeepAgentVoiceLiveKitCredentials,\n    handlers: DeepAgentVoiceLiveKitHandlers,\n  ): Promise<DeepAgentVoiceLiveKitSession> {\n    const { joinDeepAgentVoiceRoom } = await loadDeepAgentVoiceLiveKitJoin();\n    return joinDeepAgentVoiceRoom({\n      answer,\n      handlers,\n      audioElement,\n      roomFactory,\n    });\n  },\n});\n\n/** Join with an already-authorized room answer without eagerly loading LiveKit. */\nexport async function joinDeepAgentVoiceRoom(\n  options: JoinDeepAgentVoiceRoomOptions,\n): Promise<DeepAgentVoiceLiveKitSession> {\n  const join = await loadDeepAgentVoiceLiveKitJoin();\n  return join.joinDeepAgentVoiceRoom(options);\n}\n\nexport interface JoinDeepAgentVoiceRoomOptions {\n  answer: DeepAgentVoiceLiveKitCredentials;\n  handlers: DeepAgentVoiceLiveKitHandlers;\n  audioElement: () => HTMLAudioElement | null;\n  roomFactory?: () => DeepAgentVoiceLiveKitRoom;\n}\n"],"names":["joinDeepAgentVoiceRoom"],"mappings":";;AA4FA,IAAI,iBAA4D;AASzD,MAAM,gCACX,MAA0C;AACxC,sCAAmB,QAAA,QAAA,EAAA,KAAA,MAAA,QAAO,oBAAgB,CAAA,EAAE,MAAM,CAAC,UAAmB;AACpE,qBAAiB;AACjB,UAAM;AAAA,EACR,CAAC;AACD,SAAO;AACT;AAQK,MAAM,qCAAqC,CAAC;AAAA,EACjD;AAAA,EACA;AACF,OAAgF;AAAA,EAC9E,MAAM,QACJ,QACA,UACuC;AACvC,UAAM,EAAE,wBAAAA,wBAAAA,IAA2B,MAAM,8BAAA;AACzC,WAAOA,wBAAuB;AAAA,MAC5B;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IAAA,CACD;AAAA,EACH;AACF;AAGA,eAAsB,uBACpB,SACuC;AACvC,QAAM,OAAO,MAAM,8BAAA;AACnB,SAAO,KAAK,uBAAuB,OAAO;AAC5C;;;;"}

package/dist/voice/livekit.d.ts

@@ -26,12 +26,22 @@ export interface DeepAgentVoiceLiveKitRemoteTrack {
     attach(element?: HTMLMediaElement): HTMLMediaElement;
     detach(): HTMLMediaElement[];
 }
+/** The publication a remote track arrived on (`RemoteTrackPublication`, structurally). */
+export interface DeepAgentVoiceLiveKitRemotePublication {
+    setSubscribed(subscribed: boolean): void;
+}
+/** Who published a remote track (`RemoteParticipant`, structurally). */
+export interface DeepAgentVoiceLiveKitRemoteParticipant {
+    readonly identity: string;
+}
 /**
  * The slice of `livekit-client`'s `Room` the adapter drives — a real `Room`
  * satisfies it; tests inject a fake through `roomFactory`.
  */
 export interface DeepAgentVoiceLiveKitRoom {
     readonly localParticipant: {
+        /** This device's participant, known once the room is joined. */
+        readonly identity?: string;
         setMicrophoneEnabled(enabled: boolean, options?: {
             echoCancellation?: boolean;
             noiseSuppression?: boolean;
@@ -40,7 +50,7 @@ export interface DeepAgentVoiceLiveKitRoom {
     };
     connect(url: string, token: string): Promise<void>;
     disconnect(): Promise<unknown>;
-    on(event: 'trackSubscribed', listener: (track: DeepAgentVoiceLiveKitRemoteTrack) => void): unknown;
+    on(event: 'trackSubscribed', listener: (track: DeepAgentVoiceLiveKitRemoteTrack, publication?: DeepAgentVoiceLiveKitRemotePublication, participant?: DeepAgentVoiceLiveKitRemoteParticipant) => void): unknown;
     on(event: 'trackUnsubscribed', listener: (track: DeepAgentVoiceLiveKitRemoteTrack) => void): unknown;
     on(event: 'disconnected', listener: (reason?: number) => void): unknown;
 }

package/dist/voice/livekit.js.map

@@ -1 +1 @@
-{"version":3,"file":"livekit.js","sources":["../../src/voice/livekit.ts"],"sourcesContent":["/** Media credentials already authorized and issued by the chat host. */\nexport interface DeepAgentVoiceLiveKitCredentials {\n  serverUrl: string;\n  token: string;\n}\n\n/** The media controls the shared chat voice lifecycle drives. */\nexport interface DeepAgentVoiceLiveKitSession {\n  setMicrophoneEnabled(enabled: boolean): Promise<void>;\n  disconnect(): Promise<void>;\n}\n\n/** Lifecycle controls supplied by the owning chat voice attempt. */\nexport interface DeepAgentVoiceLiveKitHandlers {\n  micMuted: boolean;\n  /** Ends pending and joined media with the owning chat voice attempt. */\n  signal?: AbortSignal;\n  onDisconnected: (reason: string) => void;\n}\n\n/** Structural media boundary; compatible with the shared agent runtime. */\nexport interface DeepAgentVoiceLiveKitAdapter {\n  connect(\n    answer: DeepAgentVoiceLiveKitCredentials,\n    handlers: DeepAgentVoiceLiveKitHandlers,\n  ): Promise<DeepAgentVoiceLiveKitSession>;\n}\n\n/** The remote-track surface the adapter drives (`RemoteTrack`, structurally). */\nexport interface DeepAgentVoiceLiveKitRemoteTrack {\n  readonly kind: 'audio' | 'video' | 'unknown';\n  /** Without an element LiveKit creates a detached, autoplaying one. */\n  attach(element?: HTMLMediaElement): HTMLMediaElement;\n  detach(): HTMLMediaElement[];\n}\n\n/**\n * The slice of `livekit-client`'s `Room` the adapter drives — a real `Room`\n * satisfies it; tests inject a fake through `roomFactory`.\n */\nexport interface DeepAgentVoiceLiveKitRoom {\n  readonly localParticipant: {\n    setMicrophoneEnabled(\n      enabled: boolean,\n      options?: {\n        echoCancellation?: boolean;\n        noiseSuppression?: boolean;\n        autoGainControl?: boolean;\n      },\n    ): Promise<unknown>;\n  };\n  connect(url: string, token: string): Promise<void>;\n  disconnect(): Promise<unknown>;\n  on(\n    event: 'trackSubscribed',\n    listener: (track: DeepAgentVoiceLiveKitRemoteTrack) => void,\n  ): unknown;\n  on(\n    event: 'trackUnsubscribed',\n    listener: (track: DeepAgentVoiceLiveKitRemoteTrack) => void,\n  ): unknown;\n  on(event: 'disconnected', listener: (reason?: number) => void): unknown;\n}\n\nexport interface CreateDeepAgentVoiceLiveKitAdapterOptions {\n  /**\n   * The `<audio>` sink for the agent participant's track, read when the track\n   * arrives; `null` lets LiveKit play through an element of its own.\n   */\n  audioElement: () => HTMLAudioElement | null;\n  /** Test seam; defaults to a fresh `livekit-client` `Room`. */\n  roomFactory?: () => DeepAgentVoiceLiveKitRoom;\n}\n\ntype DeepAgentVoiceLiveKitJoin = typeof import('./livekit-join');\n\nlet joinModuleLoad: Promise<DeepAgentVoiceLiveKitJoin> | null = null;\n\n/**\n * The room join and `livekit-client` (~120 KB gzip) are fetched when a voice\n * session starts, not with the composer: every Spaces boot mounts the\n * composer, few start a voice session. One `import()` keeps LiveKit in one\n * lazy chunk group. A failed import is not memoized: the next session imports\n * again.\n */\nexport const loadDeepAgentVoiceLiveKitJoin =\n  (): Promise<DeepAgentVoiceLiveKitJoin> => {\n    joinModuleLoad ??= import('./livekit-join').catch((error: unknown) => {\n      joinModuleLoad = null;\n      throw error;\n    });\n    return joinModuleLoad;\n  };\n\n/**\n * The composer's LiveKit leg for the shared voice session\n * (`useDeepAgentVoice({ transport: 'livekit' })`): join the room the host\n * minted, publish the microphone, play the agent's track, and report a drop\n * (`joinDeepAgentVoiceRoom`, loaded on the first join).\n */\nexport const createDeepAgentVoiceLiveKitAdapter = ({\n  audioElement,\n  roomFactory,\n}: CreateDeepAgentVoiceLiveKitAdapterOptions): DeepAgentVoiceLiveKitAdapter => ({\n  async connect(\n    answer: DeepAgentVoiceLiveKitCredentials,\n    handlers: DeepAgentVoiceLiveKitHandlers,\n  ): Promise<DeepAgentVoiceLiveKitSession> {\n    const { joinDeepAgentVoiceRoom } = await loadDeepAgentVoiceLiveKitJoin();\n    return joinDeepAgentVoiceRoom({\n      answer,\n      handlers,\n      audioElement,\n      roomFactory,\n    });\n  },\n});\n\n/** Join with an already-authorized room answer without eagerly loading LiveKit. */\nexport async function joinDeepAgentVoiceRoom(\n  options: JoinDeepAgentVoiceRoomOptions,\n): Promise<DeepAgentVoiceLiveKitSession> {\n  const join = await loadDeepAgentVoiceLiveKitJoin();\n  return join.joinDeepAgentVoiceRoom(options);\n}\n\nexport interface JoinDeepAgentVoiceRoomOptions {\n  answer: DeepAgentVoiceLiveKitCredentials;\n  handlers: DeepAgentVoiceLiveKitHandlers;\n  audioElement: () => HTMLAudioElement | null;\n  roomFactory?: () => DeepAgentVoiceLiveKitRoom;\n}\n"],"names":["joinDeepAgentVoiceRoom"],"mappings":"AA4EA,IAAI,iBAA4D;AASzD,MAAM,gCACX,MAA0C;AACxC,sCAAmB,OAAO,mBAAgB,EAAE,MAAM,CAAC,UAAmB;AACpE,qBAAiB;AACjB,UAAM;AAAA,EACR,CAAC;AACD,SAAO;AACT;AAQK,MAAM,qCAAqC,CAAC;AAAA,EACjD;AAAA,EACA;AACF,OAAgF;AAAA,EAC9E,MAAM,QACJ,QACA,UACuC;AACvC,UAAM,EAAE,wBAAAA,wBAAAA,IAA2B,MAAM,8BAAA;AACzC,WAAOA,wBAAuB;AAAA,MAC5B;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IAAA,CACD;AAAA,EACH;AACF;AAGA,eAAsB,uBACpB,SACuC;AACvC,QAAM,OAAO,MAAM,8BAAA;AACnB,SAAO,KAAK,uBAAuB,OAAO;AAC5C;"}
+{"version":3,"file":"livekit.js","sources":["../../src/voice/livekit.ts"],"sourcesContent":["/** Media credentials already authorized and issued by the chat host. */\nexport interface DeepAgentVoiceLiveKitCredentials {\n  serverUrl: string;\n  token: string;\n}\n\n/** The media controls the shared chat voice lifecycle drives. */\nexport interface DeepAgentVoiceLiveKitSession {\n  setMicrophoneEnabled(enabled: boolean): Promise<void>;\n  disconnect(): Promise<void>;\n}\n\n/** Lifecycle controls supplied by the owning chat voice attempt. */\nexport interface DeepAgentVoiceLiveKitHandlers {\n  micMuted: boolean;\n  /** Ends pending and joined media with the owning chat voice attempt. */\n  signal?: AbortSignal;\n  onDisconnected: (reason: string) => void;\n}\n\n/** Structural media boundary; compatible with the shared agent runtime. */\nexport interface DeepAgentVoiceLiveKitAdapter {\n  connect(\n    answer: DeepAgentVoiceLiveKitCredentials,\n    handlers: DeepAgentVoiceLiveKitHandlers,\n  ): Promise<DeepAgentVoiceLiveKitSession>;\n}\n\n/** The remote-track surface the adapter drives (`RemoteTrack`, structurally). */\nexport interface DeepAgentVoiceLiveKitRemoteTrack {\n  readonly kind: 'audio' | 'video' | 'unknown';\n  /** Without an element LiveKit creates a detached, autoplaying one. */\n  attach(element?: HTMLMediaElement): HTMLMediaElement;\n  detach(): HTMLMediaElement[];\n}\n\n/** The publication a remote track arrived on (`RemoteTrackPublication`, structurally). */\nexport interface DeepAgentVoiceLiveKitRemotePublication {\n  setSubscribed(subscribed: boolean): void;\n}\n\n/** Who published a remote track (`RemoteParticipant`, structurally). */\nexport interface DeepAgentVoiceLiveKitRemoteParticipant {\n  readonly identity: string;\n}\n\n/**\n * The slice of `livekit-client`'s `Room` the adapter drives — a real `Room`\n * satisfies it; tests inject a fake through `roomFactory`.\n */\nexport interface DeepAgentVoiceLiveKitRoom {\n  readonly localParticipant: {\n    /** This device's participant, known once the room is joined. */\n    readonly identity?: string;\n    setMicrophoneEnabled(\n      enabled: boolean,\n      options?: {\n        echoCancellation?: boolean;\n        noiseSuppression?: boolean;\n        autoGainControl?: boolean;\n      },\n    ): Promise<unknown>;\n  };\n  connect(url: string, token: string): Promise<void>;\n  disconnect(): Promise<unknown>;\n  on(\n    event: 'trackSubscribed',\n    listener: (\n      track: DeepAgentVoiceLiveKitRemoteTrack,\n      publication?: DeepAgentVoiceLiveKitRemotePublication,\n      participant?: DeepAgentVoiceLiveKitRemoteParticipant,\n    ) => void,\n  ): unknown;\n  on(\n    event: 'trackUnsubscribed',\n    listener: (track: DeepAgentVoiceLiveKitRemoteTrack) => void,\n  ): unknown;\n  on(event: 'disconnected', listener: (reason?: number) => void): unknown;\n}\n\nexport interface CreateDeepAgentVoiceLiveKitAdapterOptions {\n  /**\n   * The `<audio>` sink for the agent participant's track, read when the track\n   * arrives; `null` lets LiveKit play through an element of its own.\n   */\n  audioElement: () => HTMLAudioElement | null;\n  /** Test seam; defaults to a fresh `livekit-client` `Room`. */\n  roomFactory?: () => DeepAgentVoiceLiveKitRoom;\n}\n\ntype DeepAgentVoiceLiveKitJoin = typeof import('./livekit-join');\n\nlet joinModuleLoad: Promise<DeepAgentVoiceLiveKitJoin> | null = null;\n\n/**\n * The room join and `livekit-client` (~120 KB gzip) are fetched when a voice\n * session starts, not with the composer: every Spaces boot mounts the\n * composer, few start a voice session. One `import()` keeps LiveKit in one\n * lazy chunk group. A failed import is not memoized: the next session imports\n * again.\n */\nexport const loadDeepAgentVoiceLiveKitJoin =\n  (): Promise<DeepAgentVoiceLiveKitJoin> => {\n    joinModuleLoad ??= import('./livekit-join').catch((error: unknown) => {\n      joinModuleLoad = null;\n      throw error;\n    });\n    return joinModuleLoad;\n  };\n\n/**\n * The composer's LiveKit leg for the shared voice session\n * (`useDeepAgentVoice({ transport: 'livekit' })`): join the room the host\n * minted, publish the microphone, play the agent's track, and report a drop\n * (`joinDeepAgentVoiceRoom`, loaded on the first join).\n */\nexport const createDeepAgentVoiceLiveKitAdapter = ({\n  audioElement,\n  roomFactory,\n}: CreateDeepAgentVoiceLiveKitAdapterOptions): DeepAgentVoiceLiveKitAdapter => ({\n  async connect(\n    answer: DeepAgentVoiceLiveKitCredentials,\n    handlers: DeepAgentVoiceLiveKitHandlers,\n  ): Promise<DeepAgentVoiceLiveKitSession> {\n    const { joinDeepAgentVoiceRoom } = await loadDeepAgentVoiceLiveKitJoin();\n    return joinDeepAgentVoiceRoom({\n      answer,\n      handlers,\n      audioElement,\n      roomFactory,\n    });\n  },\n});\n\n/** Join with an already-authorized room answer without eagerly loading LiveKit. */\nexport async function joinDeepAgentVoiceRoom(\n  options: JoinDeepAgentVoiceRoomOptions,\n): Promise<DeepAgentVoiceLiveKitSession> {\n  const join = await loadDeepAgentVoiceLiveKitJoin();\n  return join.joinDeepAgentVoiceRoom(options);\n}\n\nexport interface JoinDeepAgentVoiceRoomOptions {\n  answer: DeepAgentVoiceLiveKitCredentials;\n  handlers: DeepAgentVoiceLiveKitHandlers;\n  audioElement: () => HTMLAudioElement | null;\n  roomFactory?: () => DeepAgentVoiceLiveKitRoom;\n}\n"],"names":["joinDeepAgentVoiceRoom"],"mappings":"AA4FA,IAAI,iBAA4D;AASzD,MAAM,gCACX,MAA0C;AACxC,sCAAmB,OAAO,mBAAgB,EAAE,MAAM,CAAC,UAAmB;AACpE,qBAAiB;AACjB,UAAM;AAAA,EACR,CAAC;AACD,SAAO;AACT;AAQK,MAAM,qCAAqC,CAAC;AAAA,EACjD;AAAA,EACA;AACF,OAAgF;AAAA,EAC9E,MAAM,QACJ,QACA,UACuC;AACvC,UAAM,EAAE,wBAAAA,wBAAAA,IAA2B,MAAM,8BAAA;AACzC,WAAOA,wBAAuB;AAAA,MAC5B;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IAAA,CACD;AAAA,EACH;AACF;AAGA,eAAsB,uBACpB,SACuC;AACvC,QAAM,OAAO,MAAM,8BAAA;AACnB,SAAO,KAAK,uBAAuB,OAAO;AAC5C;"}