@athenaintel/react 0.41.3 → 0.42.2

package/dist/voice/chat.cjs

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const useDeepAgentVoice = require("../agent-runtime/src/use-deep-agent-voice.cjs");
+exports.describeVoiceFailure = useDeepAgentVoice.describeVoiceFailure;
+exports.useAthenaChatVoice = useDeepAgentVoice.useDeepAgentVoice;
+//# sourceMappingURL=chat.cjs.map

package/dist/voice/chat.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}

package/dist/voice/chat.d.ts

@@ -0,0 +1,2 @@
+/** The chat voice controller carried by this SDK's shared agent runtime. */
+export { useDeepAgentVoice as useAthenaChatVoice, describeVoiceFailure, type DeepAgentVoiceDiagnostic, type DeepAgentVoiceFailure, type DeepAgentVoiceLiveKitAdapter, type DeepAgentVoiceLiveKitAnswer, type DeepAgentVoiceLiveKitSession, type DeepAgentVoiceModelOption, type DeepAgentVoicePhase, type UseDeepAgentVoiceOptions as UseAthenaChatVoiceOptions, type UseDeepAgentVoiceReturn as UseAthenaChatVoiceReturn, } from '../agent-runtime/src/use-deep-agent-voice';

package/dist/voice/chat.js

@@ -0,0 +1,6 @@
+import { describeVoiceFailure, useDeepAgentVoice } from "../agent-runtime/src/use-deep-agent-voice.js";
+export {
+  describeVoiceFailure,
+  useDeepAgentVoice as useAthenaChatVoice
+};
+//# sourceMappingURL=chat.js.map

package/dist/voice/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/voice/livekit-join.cjs

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+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,
+  publishDefaults: { stopMicTrackOnMute: true }
+});
+async 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 Promise.race([changing, ended]);
+    },
+    disconnect: () => {
+      rejectEnded(endedError());
+      return closeRoom();
+    }
+  };
+}
+exports.joinDeepAgentVoiceRoom = joinDeepAgentVoiceRoom;
+//# sourceMappingURL=livekit-join.cjs.map

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

@@ -0,0 +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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"}

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

@@ -0,0 +1,8 @@
+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.
+ */
+export declare function joinDeepAgentVoiceRoom({ answer, handlers, audioElement, roomFactory, }: JoinDeepAgentVoiceRoomOptions): Promise<DeepAgentVoiceLiveKitSession>;

package/dist/voice/livekit-join.js

@@ -0,0 +1,119 @@
+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,
+  publishDefaults: { stopMicTrackOnMute: true }
+});
+async 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 Promise.race([changing, ended]);
+    },
+    disconnect: () => {
+      rejectEnded(endedError());
+      return closeRoom();
+    }
+  };
+}
+export {
+  joinDeepAgentVoiceRoom
+};
+//# sourceMappingURL=livekit-join.js.map

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

@@ -0,0 +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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"}

package/dist/voice/livekit.cjs

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let joinModuleLoad = null;
+const loadDeepAgentVoiceLiveKitJoin = () => {
+  joinModuleLoad ?? (joinModuleLoad = Promise.resolve().then(() => require("./livekit-join.cjs")).catch((error) => {
+    joinModuleLoad = null;
+    throw error;
+  }));
+  return joinModuleLoad;
+};
+const createDeepAgentVoiceLiveKitAdapter = ({
+  audioElement,
+  roomFactory
+}) => ({
+  async connect(answer, handlers) {
+    const { joinDeepAgentVoiceRoom: joinDeepAgentVoiceRoom2 } = await loadDeepAgentVoiceLiveKitJoin();
+    return joinDeepAgentVoiceRoom2({
+      answer,
+      handlers,
+      audioElement,
+      roomFactory
+    });
+  }
+});
+async function joinDeepAgentVoiceRoom(options) {
+  const join = await loadDeepAgentVoiceLiveKitJoin();
+  return join.joinDeepAgentVoiceRoom(options);
+}
+exports.createDeepAgentVoiceLiveKitAdapter = createDeepAgentVoiceLiveKitAdapter;
+exports.joinDeepAgentVoiceRoom = joinDeepAgentVoiceRoom;
+exports.loadDeepAgentVoiceLiveKitJoin = loadDeepAgentVoiceLiveKitJoin;
+//# sourceMappingURL=livekit.cjs.map

package/dist/voice/livekit.cjs.map

@@ -0,0 +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;;;;"}

package/dist/voice/livekit.d.ts

@@ -0,0 +1,80 @@
+/** Media credentials already authorized and issued by the chat host. */
+export interface DeepAgentVoiceLiveKitCredentials {
+    serverUrl: string;
+    token: string;
+}
+/** The media controls the shared chat voice lifecycle drives. */
+export interface DeepAgentVoiceLiveKitSession {
+    setMicrophoneEnabled(enabled: boolean): Promise<void>;
+    disconnect(): Promise<void>;
+}
+/** Lifecycle controls supplied by the owning chat voice attempt. */
+export interface DeepAgentVoiceLiveKitHandlers {
+    micMuted: boolean;
+    /** Ends pending and joined media with the owning chat voice attempt. */
+    signal?: AbortSignal;
+    onDisconnected: (reason: string) => void;
+}
+/** Structural media boundary; compatible with the shared agent runtime. */
+export interface DeepAgentVoiceLiveKitAdapter {
+    connect(answer: DeepAgentVoiceLiveKitCredentials, handlers: DeepAgentVoiceLiveKitHandlers): Promise<DeepAgentVoiceLiveKitSession>;
+}
+/** The remote-track surface the adapter drives (`RemoteTrack`, structurally). */
+export interface DeepAgentVoiceLiveKitRemoteTrack {
+    readonly kind: 'audio' | 'video' | 'unknown';
+    /** Without an element LiveKit creates a detached, autoplaying one. */
+    attach(element?: HTMLMediaElement): HTMLMediaElement;
+    detach(): HTMLMediaElement[];
+}
+/**
+ * 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: {
+        setMicrophoneEnabled(enabled: boolean, options?: {
+            echoCancellation?: boolean;
+            noiseSuppression?: boolean;
+            autoGainControl?: boolean;
+        }): Promise<unknown>;
+    };
+    connect(url: string, token: string): Promise<void>;
+    disconnect(): Promise<unknown>;
+    on(event: 'trackSubscribed', listener: (track: DeepAgentVoiceLiveKitRemoteTrack) => void): unknown;
+    on(event: 'trackUnsubscribed', listener: (track: DeepAgentVoiceLiveKitRemoteTrack) => void): unknown;
+    on(event: 'disconnected', listener: (reason?: number) => void): unknown;
+}
+export interface CreateDeepAgentVoiceLiveKitAdapterOptions {
+    /**
+     * The `<audio>` sink for the agent participant's track, read when the track
+     * arrives; `null` lets LiveKit play through an element of its own.
+     */
+    audioElement: () => HTMLAudioElement | null;
+    /** Test seam; defaults to a fresh `livekit-client` `Room`. */
+    roomFactory?: () => DeepAgentVoiceLiveKitRoom;
+}
+type DeepAgentVoiceLiveKitJoin = typeof import('./livekit-join');
+/**
+ * The room join and `livekit-client` (~120 KB gzip) are fetched when a voice
+ * session starts, not with the composer: every Spaces boot mounts the
+ * composer, few start a voice session. One `import()` keeps LiveKit in one
+ * lazy chunk group. A failed import is not memoized: the next session imports
+ * again.
+ */
+export declare const loadDeepAgentVoiceLiveKitJoin: () => Promise<DeepAgentVoiceLiveKitJoin>;
+/**
+ * The composer's LiveKit leg for the shared voice session
+ * (`useDeepAgentVoice({ transport: 'livekit' })`): join the room the host
+ * minted, publish the microphone, play the agent's track, and report a drop
+ * (`joinDeepAgentVoiceRoom`, loaded on the first join).
+ */
+export declare const createDeepAgentVoiceLiveKitAdapter: ({ audioElement, roomFactory, }: CreateDeepAgentVoiceLiveKitAdapterOptions) => DeepAgentVoiceLiveKitAdapter;
+/** Join with an already-authorized room answer without eagerly loading LiveKit. */
+export declare function joinDeepAgentVoiceRoom(options: JoinDeepAgentVoiceRoomOptions): Promise<DeepAgentVoiceLiveKitSession>;
+export interface JoinDeepAgentVoiceRoomOptions {
+    answer: DeepAgentVoiceLiveKitCredentials;
+    handlers: DeepAgentVoiceLiveKitHandlers;
+    audioElement: () => HTMLAudioElement | null;
+    roomFactory?: () => DeepAgentVoiceLiveKitRoom;
+}
+export {};

package/dist/voice/livekit.js

@@ -0,0 +1,32 @@
+let joinModuleLoad = null;
+const loadDeepAgentVoiceLiveKitJoin = () => {
+  joinModuleLoad ?? (joinModuleLoad = import("./livekit-join.js").catch((error) => {
+    joinModuleLoad = null;
+    throw error;
+  }));
+  return joinModuleLoad;
+};
+const createDeepAgentVoiceLiveKitAdapter = ({
+  audioElement,
+  roomFactory
+}) => ({
+  async connect(answer, handlers) {
+    const { joinDeepAgentVoiceRoom: joinDeepAgentVoiceRoom2 } = await loadDeepAgentVoiceLiveKitJoin();
+    return joinDeepAgentVoiceRoom2({
+      answer,
+      handlers,
+      audioElement,
+      roomFactory
+    });
+  }
+});
+async function joinDeepAgentVoiceRoom(options) {
+  const join = await loadDeepAgentVoiceLiveKitJoin();
+  return join.joinDeepAgentVoiceRoom(options);
+}
+export {
+  createDeepAgentVoiceLiveKitAdapter,
+  joinDeepAgentVoiceRoom,
+  loadDeepAgentVoiceLiveKitJoin
+};
+//# sourceMappingURL=livekit.js.map

package/dist/voice/livekit.js.map

@@ -0,0 +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;"}

package/dist/voice/use-chat-voice-enabled.cjs

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const reactQuery = require("@tanstack/react-query");
+const apiClient = require("../chat-ui/mentions/suggestions/data/api-client.cjs");
+const runtimeCatalog = require("../catalog/runtime-catalog.cjs");
+const CHAT_VOICE_ACCESS_QUERY = `
+  query AthenaChatVoiceAccess {
+    getCurrentUserWithWorkspace { workspace { id voiceModeConfig } }
+  }
+`;
+function readChatVoiceEnabled(data) {
+  if (typeof data !== "object" || data === null || !("getCurrentUserWithWorkspace" in data))
+    return false;
+  const account = data.getCurrentUserWithWorkspace;
+  if (typeof account !== "object" || account === null || !("workspace" in account)) return false;
+  const workspace = account.workspace;
+  if (typeof workspace !== "object" || workspace === null || !("voiceModeConfig" in workspace))
+    return false;
+  const config = workspace.voiceModeConfig;
+  return typeof config === "object" && config !== null && "enabled" in config && config.enabled === true;
+}
+function useChatVoiceEnabled({ enabled }) {
+  const auth = apiClient.useMentionAuth();
+  const principal = runtimeCatalog.useCatalogPrincipal();
+  const queryClient = runtimeCatalog.useCatalogQueryClient();
+  const query = reactQuery.useQuery(
+    {
+      queryKey: ["athena-sdk", "chat-voice-access", auth.backendUrl, principal, auth.workspaceId],
+      queryFn: async ({ signal }) => readChatVoiceEnabled(
+        await apiClient.fetchGraphQL(auth, CHAT_VOICE_ACCESS_QUERY, {}, { signal })
+      ),
+      enabled,
+      retry: false,
+      staleTime: 3e4,
+      refetchInterval: 3e4
+    },
+    queryClient
+  );
+  return enabled && !query.isError && query.data === true;
+}
+exports.readChatVoiceEnabled = readChatVoiceEnabled;
+exports.useChatVoiceEnabled = useChatVoiceEnabled;
+//# sourceMappingURL=use-chat-voice-enabled.cjs.map

package/dist/voice/use-chat-voice-enabled.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chat-voice-enabled.cjs","sources":["../../src/voice/use-chat-voice-enabled.ts"],"sourcesContent":["import { useQuery } from '@tanstack/react-query';\nimport { useMentionAuth, fetchGraphQL } from '../chat-ui/mentions/suggestions/data/api-client';\nimport { useCatalogPrincipal, useCatalogQueryClient } from '../catalog/runtime-catalog';\n\nconst CHAT_VOICE_ACCESS_QUERY = `\n  query AthenaChatVoiceAccess {\n    getCurrentUserWithWorkspace { workspace { id voiceModeConfig } }\n  }\n`;\n\n/** Only an explicit boolean enables voice; malformed or older answers fail closed. */\nexport function readChatVoiceEnabled(data: unknown): boolean {\n  if (typeof data !== 'object' || data === null || !('getCurrentUserWithWorkspace' in data))\n    return false;\n  const account = data.getCurrentUserWithWorkspace;\n  if (typeof account !== 'object' || account === null || !('workspace' in account)) return false;\n  const workspace = account.workspace;\n  if (typeof workspace !== 'object' || workspace === null || !('voiceModeConfig' in workspace))\n    return false;\n  const config = workspace.voiceModeConfig;\n  return (\n    typeof config === 'object' && config !== null && 'enabled' in config && config.enabled === true\n  );\n}\n\n/**\n * The workspace read already folds in VOICE_MODE_ENABLED on the server. This\n * controls presentation; voice/start still enforces _require_voice_access.\n */\nexport function useChatVoiceEnabled({ enabled }: { enabled: boolean }): boolean {\n  const auth = useMentionAuth();\n  const principal = useCatalogPrincipal();\n  const queryClient = useCatalogQueryClient();\n  const query = useQuery(\n    {\n      queryKey: ['athena-sdk', 'chat-voice-access', auth.backendUrl, principal, auth.workspaceId],\n      queryFn: async ({ signal }) =>\n        readChatVoiceEnabled(\n          await fetchGraphQL<unknown>(auth, CHAT_VOICE_ACCESS_QUERY, {}, { signal })\n        ),\n      enabled,\n      retry: false,\n      staleTime: 30_000,\n      refetchInterval: 30_000,\n    },\n    queryClient\n  );\n  return enabled && !query.isError && query.data === true;\n}\n"],"names":["useMentionAuth","useCatalogPrincipal","useCatalogQueryClient","useQuery","fetchGraphQL"],"mappings":";;;;;AAIA,MAAM,0BAA0B;AAAA;AAAA;AAAA;AAAA;AAOzB,SAAS,qBAAqB,MAAwB;AAC3D,MAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,EAAE,iCAAiC;AAClF,WAAO;AACT,QAAM,UAAU,KAAK;AACrB,MAAI,OAAO,YAAY,YAAY,YAAY,QAAQ,EAAE,eAAe,SAAU,QAAO;AACzF,QAAM,YAAY,QAAQ;AAC1B,MAAI,OAAO,cAAc,YAAY,cAAc,QAAQ,EAAE,qBAAqB;AAChF,WAAO;AACT,QAAM,SAAS,UAAU;AACzB,SACE,OAAO,WAAW,YAAY,WAAW,QAAQ,aAAa,UAAU,OAAO,YAAY;AAE/F;AAMO,SAAS,oBAAoB,EAAE,WAA0C;AAC9E,QAAM,OAAOA,UAAAA,eAAA;AACb,QAAM,YAAYC,eAAAA,oBAAA;AAClB,QAAM,cAAcC,eAAAA,sBAAA;AACpB,QAAM,QAAQC,WAAAA;AAAAA,IACZ;AAAA,MACE,UAAU,CAAC,cAAc,qBAAqB,KAAK,YAAY,WAAW,KAAK,WAAW;AAAA,MAC1F,SAAS,OAAO,EAAE,OAAA,MAChB;AAAA,QACE,MAAMC,UAAAA,aAAsB,MAAM,yBAAyB,CAAA,GAAI,EAAE,QAAQ;AAAA,MAAA;AAAA,MAE7E;AAAA,MACA,OAAO;AAAA,MACP,WAAW;AAAA,MACX,iBAAiB;AAAA,IAAA;AAAA,IAEnB;AAAA,EAAA;AAEF,SAAO,WAAW,CAAC,MAAM,WAAW,MAAM,SAAS;AACrD;;;"}

package/dist/voice/use-chat-voice-enabled.d.ts

@@ -0,0 +1,9 @@
+/** Only an explicit boolean enables voice; malformed or older answers fail closed. */
+export declare function readChatVoiceEnabled(data: unknown): boolean;
+/**
+ * The workspace read already folds in VOICE_MODE_ENABLED on the server. This
+ * controls presentation; voice/start still enforces _require_voice_access.
+ */
+export declare function useChatVoiceEnabled({ enabled }: {
+    enabled: boolean;
+}): boolean;

package/dist/voice/use-chat-voice-enabled.js

@@ -0,0 +1,43 @@
+import { useQuery } from "@tanstack/react-query";
+import { useMentionAuth, fetchGraphQL } from "../chat-ui/mentions/suggestions/data/api-client.js";
+import { useCatalogPrincipal, useCatalogQueryClient } from "../catalog/runtime-catalog.js";
+const CHAT_VOICE_ACCESS_QUERY = `
+  query AthenaChatVoiceAccess {
+    getCurrentUserWithWorkspace { workspace { id voiceModeConfig } }
+  }
+`;
+function readChatVoiceEnabled(data) {
+  if (typeof data !== "object" || data === null || !("getCurrentUserWithWorkspace" in data))
+    return false;
+  const account = data.getCurrentUserWithWorkspace;
+  if (typeof account !== "object" || account === null || !("workspace" in account)) return false;
+  const workspace = account.workspace;
+  if (typeof workspace !== "object" || workspace === null || !("voiceModeConfig" in workspace))
+    return false;
+  const config = workspace.voiceModeConfig;
+  return typeof config === "object" && config !== null && "enabled" in config && config.enabled === true;
+}
+function useChatVoiceEnabled({ enabled }) {
+  const auth = useMentionAuth();
+  const principal = useCatalogPrincipal();
+  const queryClient = useCatalogQueryClient();
+  const query = useQuery(
+    {
+      queryKey: ["athena-sdk", "chat-voice-access", auth.backendUrl, principal, auth.workspaceId],
+      queryFn: async ({ signal }) => readChatVoiceEnabled(
+        await fetchGraphQL(auth, CHAT_VOICE_ACCESS_QUERY, {}, { signal })
+      ),
+      enabled,
+      retry: false,
+      staleTime: 3e4,
+      refetchInterval: 3e4
+    },
+    queryClient
+  );
+  return enabled && !query.isError && query.data === true;
+}
+export {
+  readChatVoiceEnabled,
+  useChatVoiceEnabled
+};
+//# sourceMappingURL=use-chat-voice-enabled.js.map

package/dist/voice/use-chat-voice-enabled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chat-voice-enabled.js","sources":["../../src/voice/use-chat-voice-enabled.ts"],"sourcesContent":["import { useQuery } from '@tanstack/react-query';\nimport { useMentionAuth, fetchGraphQL } from '../chat-ui/mentions/suggestions/data/api-client';\nimport { useCatalogPrincipal, useCatalogQueryClient } from '../catalog/runtime-catalog';\n\nconst CHAT_VOICE_ACCESS_QUERY = `\n  query AthenaChatVoiceAccess {\n    getCurrentUserWithWorkspace { workspace { id voiceModeConfig } }\n  }\n`;\n\n/** Only an explicit boolean enables voice; malformed or older answers fail closed. */\nexport function readChatVoiceEnabled(data: unknown): boolean {\n  if (typeof data !== 'object' || data === null || !('getCurrentUserWithWorkspace' in data))\n    return false;\n  const account = data.getCurrentUserWithWorkspace;\n  if (typeof account !== 'object' || account === null || !('workspace' in account)) return false;\n  const workspace = account.workspace;\n  if (typeof workspace !== 'object' || workspace === null || !('voiceModeConfig' in workspace))\n    return false;\n  const config = workspace.voiceModeConfig;\n  return (\n    typeof config === 'object' && config !== null && 'enabled' in config && config.enabled === true\n  );\n}\n\n/**\n * The workspace read already folds in VOICE_MODE_ENABLED on the server. This\n * controls presentation; voice/start still enforces _require_voice_access.\n */\nexport function useChatVoiceEnabled({ enabled }: { enabled: boolean }): boolean {\n  const auth = useMentionAuth();\n  const principal = useCatalogPrincipal();\n  const queryClient = useCatalogQueryClient();\n  const query = useQuery(\n    {\n      queryKey: ['athena-sdk', 'chat-voice-access', auth.backendUrl, principal, auth.workspaceId],\n      queryFn: async ({ signal }) =>\n        readChatVoiceEnabled(\n          await fetchGraphQL<unknown>(auth, CHAT_VOICE_ACCESS_QUERY, {}, { signal })\n        ),\n      enabled,\n      retry: false,\n      staleTime: 30_000,\n      refetchInterval: 30_000,\n    },\n    queryClient\n  );\n  return enabled && !query.isError && query.data === true;\n}\n"],"names":[],"mappings":";;;AAIA,MAAM,0BAA0B;AAAA;AAAA;AAAA;AAAA;AAOzB,SAAS,qBAAqB,MAAwB;AAC3D,MAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,EAAE,iCAAiC;AAClF,WAAO;AACT,QAAM,UAAU,KAAK;AACrB,MAAI,OAAO,YAAY,YAAY,YAAY,QAAQ,EAAE,eAAe,SAAU,QAAO;AACzF,QAAM,YAAY,QAAQ;AAC1B,MAAI,OAAO,cAAc,YAAY,cAAc,QAAQ,EAAE,qBAAqB;AAChF,WAAO;AACT,QAAM,SAAS,UAAU;AACzB,SACE,OAAO,WAAW,YAAY,WAAW,QAAQ,aAAa,UAAU,OAAO,YAAY;AAE/F;AAMO,SAAS,oBAAoB,EAAE,WAA0C;AAC9E,QAAM,OAAO,eAAA;AACb,QAAM,YAAY,oBAAA;AAClB,QAAM,cAAc,sBAAA;AACpB,QAAM,QAAQ;AAAA,IACZ;AAAA,MACE,UAAU,CAAC,cAAc,qBAAqB,KAAK,YAAY,WAAW,KAAK,WAAW;AAAA,MAC1F,SAAS,OAAO,EAAE,OAAA,MAChB;AAAA,QACE,MAAM,aAAsB,MAAM,yBAAyB,CAAA,GAAI,EAAE,QAAQ;AAAA,MAAA;AAAA,MAE7E;AAAA,MACA,OAAO;AAAA,MACP,WAAW;AAAA,MACX,iBAAiB;AAAA,IAAA;AAAA,IAEnB;AAAA,EAAA;AAEF,SAAO,WAAW,CAAC,MAAM,WAAW,MAAM,SAAS;AACrD;"}