realtime-avatar 0.26.1 → 0.27.1

package/dist/react-native.js

@@ -177,6 +177,8 @@ function RealtimeAvatarLiveKitRoom(props) {
     LiveKitRoom,
     {
       ...roomProps,
+      // Keep the room and its in-room observers scoped to the grant, as on web.
+      key: grant?.session_id ?? "no-session",
       serverUrl: grant?.livekit_url,
       token: grant?.participant_token,
       connect: shouldConnect,
@@ -1416,6 +1418,9 @@ function useAvatarQualityGovernor(input) {
 }
 
 // ../client/src/react/avatar-video-surface.ts
+function liveBadgeLabel(dims, debug) {
+  return debug && dims && dims.width > 0 && dims.height > 0 ? `live \xB7 ${dims.width}\xD7${dims.height}` : "live";
+}
 function resolveSurfaceLayers(input) {
   return {
     showPoster: Boolean(input.poster),
@@ -1491,6 +1496,7 @@ function AvatarVideoSurface(props) {
     style,
     children,
     showLiveBadge = true,
+    debug = false,
     adaptivePlayout = false,
     onPlayoutDelayChange,
     testID
@@ -1533,7 +1539,7 @@ function AvatarVideoSurface(props) {
   });
   const resizeMode = fit === "cover" ? "cover" : "contain";
   const liveDims = videoTrack?.publication?.dimensions ?? null;
-  const liveLabel = showLive && liveDims && liveDims.width > 0 && liveDims.height > 0 ? `live \xB7 ${liveDims.width}\xD7${liveDims.height}` : "live";
+  const liveLabel = liveBadgeLabel(liveDims, debug);
   const posterLayer = layers.showPoster ? createElement(Image, {
     key: "poster",
     source: { uri: poster },
@@ -2391,7 +2397,8 @@ function lifecyclePhaseFrom(args) {
       kind: "reconnectable",
       reconnecting: true,
       attempt: recovery.attempt,
-      strategy: "fresh-grant"
+      strategy: "fresh-grant",
+      ...recovery.reason ? { reason: recovery.reason } : {}
     };
   }
   if (recovery.kind === "failed") {
@@ -2399,11 +2406,16 @@ function lifecyclePhaseFrom(args) {
       kind: "reconnectable",
       reconnecting: false,
       attempt: MAX_RECONNECT_ATTEMPTS,
-      strategy: "fresh-grant"
+      strategy: "fresh-grant",
+      ...recovery.reason ? { reason: recovery.reason } : {}
     };
   }
   if (recovery.kind === "ended") {
-    return recovery.reason ? { kind: "ended", reason: recovery.reason } : { kind: "ended" };
+    return {
+      kind: "ended",
+      ...recovery.reason ? { reason: recovery.reason } : {},
+      ...recovery.code ? { code: recovery.code } : {}
+    };
   }
   switch (capacity.kind) {
     case "idle":
@@ -2416,7 +2428,7 @@ function lifecyclePhaseFrom(args) {
       return { kind: "ended", reason: "error" };
     case "active": {
       if (!connected || !agentPresent) {
-        return { kind: "connecting", grant: capacity.grant };
+        return { kind: "connecting", grant: capacity.grant, waitingFor: connected ? "agent" : "transport" };
       }
       if (idle.kind === "idle-warning") {
         return { kind: "idle-warning", secondsRemaining: idle.secondsRemaining, deadlineAt: idle.deadlineAt };
@@ -2444,6 +2456,7 @@ function resolveIdleTimeoutMs(args) {
   return DEFAULT_IDLE_SECONDS * 1e3;
 }
 var DEFAULT_CONNECT_WATCHDOG_SECONDS = 12;
+var DEFAULT_READY_TIMEOUT_SECONDS = 30;
 function resolveWarnBeforeMs(idleTimeoutMs, override, idleWarnLeadSeconds) {
   if (idleTimeoutMs <= 0) return 0;
   const maxLeadMs = Math.max(0, idleTimeoutMs - 1e3);
@@ -2469,6 +2482,7 @@ function useSessionLifecycle(input) {
     maxReconnectAttempts,
     autoRetryBusy = true,
     connectWatchdogSeconds,
+    readyTimeoutSeconds,
     requestOptions,
     onBehaviorChange
   } = input;
@@ -2479,17 +2493,27 @@ function useSessionLifecycle(input) {
   const reconnectPolicyRef = useRef(reconnectPolicy);
   reconnectPolicyRef.current = reconnectPolicy;
   const connectWatchdogMs = typeof connectWatchdogSeconds === "number" && Number.isFinite(connectWatchdogSeconds) ? Math.max(0, Math.floor(connectWatchdogSeconds)) * 1e3 : DEFAULT_CONNECT_WATCHDOG_SECONDS * 1e3;
+  const readyTimeoutMs = typeof readyTimeoutSeconds === "number" && Number.isFinite(readyTimeoutSeconds) && readyTimeoutSeconds > 0 ? Math.max(1, Math.floor(readyTimeoutSeconds)) * 1e3 : DEFAULT_READY_TIMEOUT_SECONDS * 1e3;
   const [userEnded, setUserEnded] = useState(false);
   const userEndedRef = useRef(false);
+  const [readinessFailed, setReadinessFailed] = useState(false);
+  const readinessFailureRef = useRef(null);
+  const readinessRef = useRef(null);
+  const readyGrantRef = useRef(null);
+  const agentWaitRef = useRef(null);
   const phaseRef = useRef({ kind: "idle" });
   const grantState = useLiveKitAvatarGrant({
     client,
     session,
-    active: active && !userEnded,
+    active: active && !userEnded && !readinessFailed,
     autoRetryBusy,
     requestOptions
   });
   const capacity = grantState.capacity;
+  const grantId = grantState.grant?.session_id ?? null;
+  const grantIdRef = useRef(null);
+  grantIdRef.current = grantId;
+  const retiredGrantRef = useRef(null);
   const [recovery, setRecovery] = useState({ kind: "connected" });
   const recoveryRef = useRef(recovery);
   recoveryRef.current = recovery;
@@ -2512,8 +2536,19 @@ function useSessionLifecycle(input) {
     grantIdleSeconds: grantState.grant?.idle_timeout_seconds ?? 0
   });
   const warnAtMs = resolveWarnBeforeMs(idleTimeoutMs, warnBeforeMs, idleWarnLeadSeconds);
-  const [agentPresent, setAgentPresentState] = useState(false);
-  const [connected, setConnected] = useState(false);
+  const [agentObservation, setAgentObservation] = useState({ grantId: null, present: false });
+  const [connectionObservation, setConnectionObservation] = useState({ grantId: null, connected: false });
+  const agentPresent = agentObservation.grantId === grantId && agentObservation.present;
+  const connected = connectionObservation.grantId === grantId && connectionObservation.connected;
+  connectedRef.current = connected;
+  const setAgentPresentState = useCallback((present) => {
+    const owner = grantIdRef.current;
+    setAgentObservation((prev) => prev.grantId === owner && prev.present === present ? prev : { grantId: owner, present });
+  }, []);
+  const setConnected = useCallback((value) => {
+    const owner = grantIdRef.current;
+    setConnectionObservation((prev) => prev.grantId === owner && prev.connected === value ? prev : { grantId: owner, connected: value });
+  }, []);
   const lastActivityRef = useRef(Date.now());
   const leaveRoomRef = useRef(null);
   const [, setClockTick] = useState(0);
@@ -2530,7 +2565,11 @@ function useSessionLifecycle(input) {
     refreshBaselineCapacityRef.current = null;
     attemptRef.current = 0;
     setAttempt(0);
-    setRecovery(userEndedRef.current ? { kind: "ended", reason: "user" } : { kind: "connected" });
+    readinessRef.current = null;
+    readyGrantRef.current = null;
+    agentWaitRef.current = null;
+    retiredGrantRef.current = null;
+    setRecovery(userEndedRef.current ? { kind: "ended", reason: "user" } : readinessFailureRef.current ? { kind: "ended", reason: "error", code: readinessFailureRef.current } : { kind: "connected" });
     setConnected(false);
     setAgentPresentState(false);
     lastActivityRef.current = Date.now();
@@ -2539,26 +2578,33 @@ function useSessionLifecycle(input) {
     if (active) return;
     userEndedRef.current = false;
     setUserEnded(false);
+    readinessFailureRef.current = null;
+    setReadinessFailed(false);
     reset();
   }, [active, reset]);
   const markActivity = useCallback(() => {
+    if (grantId === null || grantIdRef.current !== grantId) return;
     lastActivityRef.current = Date.now();
     setClockTick((value) => value + 1);
-  }, []);
+  }, [grantId]);
   const stayConnected = useCallback(() => {
+    if (grantId === null || grantIdRef.current !== grantId) return;
     if (!connectedRef.current) return;
     lastActivityRef.current = Date.now();
     setClockTick((value) => value + 1);
-  }, []);
+  }, [grantId]);
   const setAgentPresent = useCallback((present) => {
-    setAgentPresentState((prev) => {
-      if (present && !prev) lastActivityRef.current = Date.now();
-      return present;
+    if (grantId === null || grantIdRef.current !== grantId) return;
+    if (userEndedRef.current || readinessFailureRef.current || retiredGrantRef.current !== null && retiredGrantRef.current === grantIdRef.current) return;
+    setAgentObservation((prev) => {
+      if (present && (prev.grantId !== grantId || !prev.present)) lastActivityRef.current = Date.now();
+      return prev.grantId === grantId && prev.present === present ? prev : { grantId, present };
     });
-  }, []);
+  }, [grantId]);
   const registerLeaveRoom = useCallback((leave) => {
+    if (grantId === null || grantIdRef.current !== grantId) return;
     leaveRoomRef.current = leave;
-  }, []);
+  }, [grantId]);
   const endIdle = useCallback(() => {
     if (!connectedRef.current) return;
     clearTimer();
@@ -2570,24 +2616,25 @@ function useSessionLifecycle(input) {
     leaveRoomRef.current?.();
   }, [clearTimer]);
   const onConnected = useCallback(() => {
-    if (userEndedRef.current) return;
+    if (grantId === null || grantIdRef.current !== grantId) return;
+    if (userEndedRef.current || readinessFailureRef.current || retiredGrantRef.current !== null && retiredGrantRef.current === grantIdRef.current) return;
     clearTimer();
     connectedRef.current = true;
     manualReconnectPendingRef.current = false;
     refreshBaselineCapacityRef.current = null;
     setConnected(true);
-    attemptRef.current = 0;
-    setAttempt(0);
+    if (readinessRef.current) readinessRef.current.sawTransport = true;
     setRecovery({ kind: "connected" });
     lastActivityRef.current = Date.now();
-  }, [clearTimer]);
+  }, [clearTimer, grantId]);
   const onDisconnected = useCallback(
     (reason) => {
-      if (!active || userEndedRef.current) return;
+      if (grantId === null || grantIdRef.current !== grantId) return;
+      if (!active || userEndedRef.current || readinessFailureRef.current) return;
       const action = disconnectAction(reason, connectedRef.current);
       if (action === "noop") return;
       if (action === "reset") {
-        if (recoveryRef.current.kind === "refreshing") return;
+        if (recoveryRef.current.kind === "refreshing" || recoveryRef.current.kind === "reconnecting") return;
         reset();
         return;
       }
@@ -2604,11 +2651,12 @@ function useSessionLifecycle(input) {
       refreshBaselineCapacityRef.current = null;
       setRecovery({ kind: "reconnecting", attempt: attemptRef.current });
     },
-    [active, reset]
+    [active, reset, grantId]
   );
   const onConnectionError = useCallback(
     (error) => {
-      if (!active || userEndedRef.current || !isRecoverableConnectionError(error)) return;
+      if (grantId === null || grantIdRef.current !== grantId) return;
+      if (!active || userEndedRef.current || readinessFailureRef.current || !isRecoverableConnectionError(error)) return;
       connectedRef.current = false;
       setConnected(false);
       setAgentPresentState(false);
@@ -2619,7 +2667,7 @@ function useSessionLifecycle(input) {
         return { kind: "reconnecting", attempt: attemptRef.current };
       });
     },
-    [active]
+    [active, grantId]
   );
   useEffect(() => {
     if (capacity.kind === "error" && recovery.kind === "connected") manualReconnectPendingRef.current = false;
@@ -2629,11 +2677,12 @@ function useSessionLifecycle(input) {
     const baseline = refreshBaselineCapacityRef.current;
     if (baseline?.kind === "error" && baseline.error === capacity.error) return;
     refreshBaselineCapacityRef.current = null;
-    setRecovery({ kind: "reconnecting", attempt: recovery.attempt });
+    setRecovery({ kind: "reconnecting", attempt: recovery.attempt, ...recovery.reason ? { reason: recovery.reason } : {} });
   }, [capacity, recovery]);
   const onConnectionStateChange = useCallback(
     (state) => {
-      if (!active || userEndedRef.current) return;
+      if (grantId === null || grantIdRef.current !== grantId) return;
+      if (!active || userEndedRef.current || readinessFailureRef.current) return;
       if (state === "connected") {
         onConnected();
         return;
@@ -2647,14 +2696,78 @@ function useSessionLifecycle(input) {
         }
       }
     },
-    [active, onConnected]
+    [active, onConnected, grantId]
   );
+  useEffect(() => {
+    if (!active || userEnded || readinessFailed || !connected || !agentPresent || !grantState.grant) return;
+    readyGrantRef.current = grantState.grant.session_id;
+    readinessRef.current = null;
+    agentWaitRef.current = null;
+    attemptRef.current = 0;
+    setAttempt(0);
+  }, [active, userEnded, readinessFailed, connected, agentPresent, grantState.grant]);
+  const failReadiness = useCallback((code) => {
+    if (userEndedRef.current || readinessFailureRef.current) return;
+    readinessFailureRef.current = code;
+    clearTimer();
+    connectedRef.current = false;
+    manualReconnectPendingRef.current = false;
+    refreshBaselineCapacityRef.current = null;
+    const ended = { kind: "ended", reason: "error", code };
+    recoveryRef.current = ended;
+    setRecovery(ended);
+    setConnected(false);
+    setAgentPresentState(false);
+    releaseRef.current("disconnected");
+    setReadinessFailed(true);
+    leaveRoomRef.current?.();
+  }, [clearTimer]);
+  useEffect(() => {
+    if (!active || userEnded || readinessFailed) return;
+    if (recovery.kind === "ended" || recovery.kind === "failed") return;
+    if (grantState.grant && readyGrantRef.current === grantState.grant.session_id) return;
+    if (!readinessRef.current && grantState.grant) {
+      readinessRef.current = { startedAt: Date.now(), sawTransport: connected };
+    }
+    const budget = readinessRef.current;
+    if (!budget) return;
+    const timer = window.setTimeout(() => {
+      if (readinessRef.current !== budget) return;
+      failReadiness(budget.sawTransport ? "agent_timeout" : "connection_timeout");
+    }, Math.max(0, budget.startedAt + readyTimeoutMs - Date.now()));
+    return () => window.clearTimeout(timer);
+  }, [active, userEnded, readinessFailed, connected, agentPresent, grantState.grant, recovery.kind, readyTimeoutMs, failReadiness]);
+  useEffect(() => {
+    const sessionId = grantState.grant?.session_id;
+    if (!active || userEnded || readinessFailed || !sessionId || readyGrantRef.current === sessionId || agentPresent) return;
+    if (recovery.kind === "reconnecting" || recovery.kind === "failed" || recovery.kind === "ended") return;
+    if (agentWaitRef.current?.sessionId !== sessionId) {
+      if (!connected) return;
+      agentWaitRef.current = { sessionId, startedAt: Date.now() };
+    }
+    const wait = agentWaitRef.current;
+    if (connectWatchdogMs <= 0) return;
+    const timer = window.setTimeout(() => {
+      if (agentWaitRef.current !== wait || readinessFailureRef.current || userEndedRef.current) return;
+      retiredGrantRef.current = sessionId;
+      connectedRef.current = false;
+      setConnected(false);
+      setAgentPresentState(false);
+      const next = { kind: "reconnecting", attempt: attemptRef.current, reason: "agent_timeout" };
+      recoveryRef.current = next;
+      setRecovery(next);
+      releaseRef.current("disconnected");
+      leaveRoomRef.current?.();
+    }, Math.max(0, wait.startedAt + connectWatchdogMs - Date.now()));
+    return () => window.clearTimeout(timer);
+  }, [active, userEnded, readinessFailed, connected, agentPresent, grantState.grant, recovery.kind, connectWatchdogMs]);
   useEffect(() => {
     if (!active || connected || connectWatchdogMs <= 0) return;
     if (grantState.status !== "ready" || !grantState.grant) return;
     if (recovery.kind === "failed" || recovery.kind === "ended") return;
     if (recovery.kind === "in-place-reconnecting") return;
     const timer = window.setTimeout(() => {
+      if (readinessFailureRef.current || userEndedRef.current) return;
       releaseRef.current("disconnected");
       setRecovery({ kind: "reconnecting", attempt: attemptRef.current });
     }, connectWatchdogMs);
@@ -2664,6 +2777,10 @@ function useSessionLifecycle(input) {
     if (!active || !needsFreshGrant(recovery)) return;
     const step2 = retryStep(attemptRef.current, reconnectPolicyRef.current);
     if (step2.kind === "give-up") {
+      if (readinessRef.current) {
+        failReadiness(readinessRef.current.sawTransport ? "agent_timeout" : "connection_timeout");
+        return;
+      }
       manualReconnectPendingRef.current = false;
       refreshBaselineCapacityRef.current = null;
       releaseRef.current("disconnected");
@@ -2672,15 +2789,16 @@ function useSessionLifecycle(input) {
     }
     timerRef.current = window.setTimeout(() => {
       timerRef.current = null;
+      if (readinessFailureRef.current || userEndedRef.current) return;
       attemptRef.current = step2.attempt;
       setAttempt(step2.attempt);
       refreshBaselineCapacityRef.current = capacityRef.current;
       releaseRef.current("superseded");
-      setRecovery({ kind: "refreshing", attempt: step2.attempt });
+      setRecovery({ kind: "refreshing", attempt: step2.attempt, ...recovery.reason ? { reason: recovery.reason } : {} });
       refreshRef.current();
     }, step2.delayMs);
     return clearTimer;
-  }, [recovery.kind, active, attempt, clearTimer]);
+  }, [recovery.kind, active, attempt, clearTimer, failReadiness]);
   const end = useCallback(() => {
     if (!active || userEndedRef.current || phaseRef.current.kind === "ended") return;
     userEndedRef.current = true;
@@ -2697,6 +2815,13 @@ function useSessionLifecycle(input) {
   }, [active, clearTimer]);
   const reconnect = useCallback(() => {
     if (!active) return;
+    if (readinessFailureRef.current) {
+      readinessFailureRef.current = null;
+      setReadinessFailed(false);
+      reset();
+      manualReconnectPendingRef.current = true;
+      return;
+    }
     if (userEndedRef.current) {
       userEndedRef.current = false;
       setUserEnded(false);
@@ -2707,6 +2832,12 @@ function useSessionLifecycle(input) {
     if (manualReconnectPendingRef.current || recovery.kind === "in-place-reconnecting") return;
     manualReconnectPendingRef.current = true;
     clearTimer();
+    readinessRef.current = null;
+    agentWaitRef.current = null;
+    readyGrantRef.current = null;
+    connectedRef.current = false;
+    setConnected(false);
+    setAgentPresentState(false);
     attemptRef.current = 0;
     setAttempt(0);
     refreshBaselineCapacityRef.current = capacityRef.current;
@@ -2826,6 +2957,7 @@ function SessionLifecycleRoomBridge({
   const assistant = useVoiceAssistant();
   const transcriptions = useTranscriptions();
   const room = useRoomContext();
+  const roomMatchesGrant = lifecycle.grant === void 0 || lifecycle.grant !== null && room.name === lifecycle.grant.room_name;
   useCallMedia(room, {
     setMicrophoneFacts,
     setAudioPlayback,
@@ -2979,11 +3111,11 @@ function SessionLifecycleRoomBridge({
     detailsEnabled ? video?.publication : void 0
   ]);
   useEffect(() => {
-    onConnectionStateChange(connectionState);
-  }, [connectionState, onConnectionStateChange]);
+    if (roomMatchesGrant) onConnectionStateChange(connectionState);
+  }, [connectionState, onConnectionStateChange, roomMatchesGrant]);
   useEffect(() => {
-    setAgentPresent(agentPresent);
-  }, [agentPresent, setAgentPresent]);
+    if (roomMatchesGrant) setAgentPresent(agentPresent);
+  }, [agentPresent, setAgentPresent, roomMatchesGrant]);
   useEffect(() => {
     const active = isCallActivity({
       assistantState,
@@ -3691,4 +3823,4 @@ function createProxyClient(options) {
   };
 }
 
-export { AdaptivePlayoutController, AvatarVideoSurface, DEFAULT_APPROACHING_END_LEAD_SECONDS, DEFAULT_AVATAR_PLAYOUT_DELAY_SECONDS, DEFAULT_CREDITS_LOW_LEAD_SECONDS, DEFAULT_GOVERNOR_CONFIG, DEFAULT_GRACE_CEILING_SECONDS, DEFAULT_GRACE_WINDOW_LEAD_SECONDS, DEFAULT_IDLE_SECONDS, DEFAULT_IDLE_WARN_LEAD_SECONDS, DEFAULT_TURN_TIMEOUT_SECONDS, MAX_RECONNECT_ATTEMPTS, MAX_SESSION_INSTRUCTIONS_CHARS, RECONNECT_BACKOFF_MS, RealtimeAvatarLiveKitRoom, SessionLifecycleRoomBridge, capacityErrorFromBusy, capacityStateFromGrant, createProxyClient, isNativeLiveTrackSubscribed, knownBehaviorStates, mapTurnState, readInboundRtp, sessionBehaviorSchema, sessionClipSchema, splitCallTranscript, useAvatarAdaptivePlayoutDelay, useAvatarCamera, useAvatarPlayoutDelay, useAvatarQualityGovernor, useCallTranscript, useLiveKitAvatarGrant, useLiveTrackProducing, useMicLease, useRealtimeAvatarAudioSession, useRealtimeSession, useReleaseMicLeaseOnTrackEnded, useSessionLifecycle };
+export { AdaptivePlayoutController, AvatarVideoSurface, DEFAULT_APPROACHING_END_LEAD_SECONDS, DEFAULT_AVATAR_PLAYOUT_DELAY_SECONDS, DEFAULT_CREDITS_LOW_LEAD_SECONDS, DEFAULT_GOVERNOR_CONFIG, DEFAULT_GRACE_CEILING_SECONDS, DEFAULT_GRACE_WINDOW_LEAD_SECONDS, DEFAULT_IDLE_SECONDS, DEFAULT_IDLE_WARN_LEAD_SECONDS, DEFAULT_READY_TIMEOUT_SECONDS, DEFAULT_TURN_TIMEOUT_SECONDS, MAX_RECONNECT_ATTEMPTS, MAX_SESSION_INSTRUCTIONS_CHARS, RECONNECT_BACKOFF_MS, RealtimeAvatarLiveKitRoom, SessionLifecycleRoomBridge, capacityErrorFromBusy, capacityStateFromGrant, createProxyClient, isNativeLiveTrackSubscribed, knownBehaviorStates, mapTurnState, readInboundRtp, sessionBehaviorSchema, sessionClipSchema, splitCallTranscript, useAvatarAdaptivePlayoutDelay, useAvatarCamera, useAvatarPlayoutDelay, useAvatarQualityGovernor, useCallTranscript, useLiveKitAvatarGrant, useLiveTrackProducing, useMicLease, useRealtimeAvatarAudioSession, useRealtimeSession, useReleaseMicLeaseOnTrackEnded, useSessionLifecycle };

package/dist/react.d.ts

@@ -1,6 +1,6 @@
 import { ToolRegistration, RegisteredTool } from './tools.js';
-import { aj as SessionLifecycleRoomBridgeProps, h as AvatarSessionClient, A as AvatarVideoFit, aQ as CallMicrophone, aR as CallAudioPlayback, aS as CallMicrophoneProblem } from './proxy-client-C8M_G_Kk.js';
-export { a as AdaptivePlayoutController, b as AdaptivePlayoutDecision, c as AdaptivePlayoutOptions, d as AdaptivePlayoutSample, e as ApproachingEndEvent, f as ApproachingEndReason, g as AvatarConnectionDetails, aT as AvatarVideoSurface, aU as AvatarVideoSurfaceProps, B as BehaviorSnapshot, C as CallTranscript, i as CallTranscriptSegment, j as CartesiaTtsModel, k as ClipResult, l as ClosingTurnResult, m as CreditsLowEvent, D as DEFAULT_APPROACHING_END_LEAD_SECONDS, n as DEFAULT_CREDITS_LOW_LEAD_SECONDS, o as DEFAULT_GOVERNOR_CONFIG, p as DEFAULT_GRACE_CEILING_SECONDS, q as DEFAULT_GRACE_WINDOW_LEAD_SECONDS, r as DEFAULT_IDLE_SECONDS, s as DEFAULT_IDLE_WARN_LEAD_SECONDS, t as DEFAULT_TURN_TIMEOUT_SECONDS, u as DeclaredInputSource, E as EndReason, v as EndedEvent, w as ExtendResult, F as FishTtsModel, x as FreezeReadingFn, G as Governor, y as GovernorAction, z as GovernorConfig, H as GovernorSignal, I as GovernorState, J as GraceWindowClosedEvent, K as GraceWindowOpenEvent, M as GraceWindowState, N as IdleWarningEvent, O as InboundRtpCursor, P as InboundRtpReading, Q as KnownBehaviorState, R as LLMProvider, S as LLMSelection, T as LiveKitAvatarGrantState, U as LiveKitAvatarGrantStatus, V as LiveKitCapacityState, W as LiveKitConnectionStatus, X as LiveKitSessionRequest, Y as LiveKitSessionStartResult, aV as LivePlaybackKeeper, Z as MAX_RECONNECT_ATTEMPTS, _ as MAX_SESSION_INSTRUCTIONS_CHARS, aW as MIC_LEASE_ENDED_TIMEOUT_MS, aX as MicLease, aY as NETWORK_QUALITY_POLICY, aZ as NetworkQualityStatus, a_ as PlayableVideoElement, $ as ProxyClientOptions, a0 as QualityCap, a1 as RECONNECT_BACKOFF_MS, a$ as RealtimeAvatarCapacityError, b0 as RealtimeAvatarLiveKitRoom, b1 as RealtimeAvatarLiveKitRoomProps, a2 as RealtimeAvatarRequestOptions, a3 as RealtimeSessionApi, a4 as RealtimeSessionMedia, a5 as RealtimeSessionRoomSinks, a6 as ReconnectPolicy, a7 as ReconnectingEvent, a8 as RecoveryState, a9 as RetryStep, aa as SendTurnOptions, ab as SessionBehavior, ac as SessionClip, ad as SessionClocks, ae as SessionEndReason, af as SessionLifecycleApi, ag as SessionLifecyclePhase, ah as SessionLifecyclePhaseKind, ai as SessionLifecycleRoomBridge, ak as SurfaceLayers, al as TranscriptSender, am as TranscriptSenderOptions, an as TurnState, ao as TurnTimeoutEvent, ap as UseAvatarQualityGovernorInput, aq as UseLiveKitAvatarGrantInput, ar as UseRealtimeSessionInput, as as UseSessionLifecycleInput, at as VoiceSpec, au as VoiceSpecInput, av as capacityErrorFromBusy, aw as capacityStateFromGrant, ax as createProxyClient, az as knownBehaviorStates, aA as mapTurnState, aB as readInboundRtp, aC as sessionBehaviorSchema, aD as sessionClipSchema, b2 as shouldReplayPendingTurn, aE as splitCallTranscript, aF as useAvatarAdaptivePlayoutDelay, aG as useAvatarCamera, aH as useAvatarPlayoutDelay, aI as useAvatarQualityGovernor, aJ as useCallTranscript, aK as useLiveKitAvatarGrant, aM as useMicLease, aN as useRealtimeSession, aO as useReleaseMicLeaseOnTrackEnded, aP as useSessionLifecycle } from './proxy-client-C8M_G_Kk.js';
+import { ak as SessionLifecycleRoomBridgeProps, h as AvatarSessionClient, A as AvatarVideoFit, aS as CallMicrophone, aT as CallAudioPlayback, aU as CallMicrophoneProblem } from './proxy-client-Cs2azqD1.js';
+export { a as AdaptivePlayoutController, b as AdaptivePlayoutDecision, c as AdaptivePlayoutOptions, d as AdaptivePlayoutSample, e as ApproachingEndEvent, f as ApproachingEndReason, g as AvatarConnectionDetails, aV as AvatarVideoSurface, aW as AvatarVideoSurfaceProps, B as BehaviorSnapshot, C as CallTranscript, i as CallTranscriptSegment, j as CartesiaTtsModel, k as ClipResult, l as ClosingTurnResult, m as CreditsLowEvent, D as DEFAULT_APPROACHING_END_LEAD_SECONDS, n as DEFAULT_CREDITS_LOW_LEAD_SECONDS, o as DEFAULT_GOVERNOR_CONFIG, p as DEFAULT_GRACE_CEILING_SECONDS, q as DEFAULT_GRACE_WINDOW_LEAD_SECONDS, r as DEFAULT_IDLE_SECONDS, s as DEFAULT_IDLE_WARN_LEAD_SECONDS, t as DEFAULT_READY_TIMEOUT_SECONDS, u as DEFAULT_TURN_TIMEOUT_SECONDS, v as DeclaredInputSource, E as EndReason, w as EndedEvent, x as ExtendResult, F as FishTtsModel, y as FreezeReadingFn, G as Governor, z as GovernorAction, H as GovernorConfig, I as GovernorSignal, J as GovernorState, K as GraceWindowClosedEvent, M as GraceWindowOpenEvent, N as GraceWindowState, O as IdleWarningEvent, P as InboundRtpCursor, Q as InboundRtpReading, R as KnownBehaviorState, S as LLMProvider, T as LLMSelection, U as LiveKitAvatarGrantState, V as LiveKitAvatarGrantStatus, W as LiveKitCapacityState, X as LiveKitConnectionStatus, Y as LiveKitSessionRequest, Z as LiveKitSessionStartResult, aX as LivePlaybackKeeper, _ as MAX_RECONNECT_ATTEMPTS, $ as MAX_SESSION_INSTRUCTIONS_CHARS, aY as MIC_LEASE_ENDED_TIMEOUT_MS, aZ as MicLease, a_ as NETWORK_QUALITY_POLICY, a$ as NetworkQualityStatus, b0 as PlayableVideoElement, a0 as ProxyClientOptions, a1 as QualityCap, a2 as RECONNECT_BACKOFF_MS, b1 as RealtimeAvatarCapacityError, b2 as RealtimeAvatarLiveKitRoom, b3 as RealtimeAvatarLiveKitRoomProps, a3 as RealtimeAvatarRequestOptions, a4 as RealtimeSessionApi, a5 as RealtimeSessionMedia, a6 as RealtimeSessionRoomSinks, a7 as ReconnectPolicy, a8 as ReconnectingEvent, a9 as RecoveryState, aa as RetryStep, ab as SendTurnOptions, ac as SessionBehavior, ad as SessionClip, ae as SessionClocks, af as SessionEndReason, ag as SessionLifecycleApi, ah as SessionLifecyclePhase, ai as SessionLifecyclePhaseKind, aj as SessionLifecycleRoomBridge, al as SessionReadinessFailure, am as SurfaceLayers, an as TranscriptSender, ao as TranscriptSenderOptions, ap as TurnState, aq as TurnTimeoutEvent, ar as UseAvatarQualityGovernorInput, as as UseLiveKitAvatarGrantInput, at as UseRealtimeSessionInput, au as UseSessionLifecycleInput, av as VoiceSpec, aw as VoiceSpecInput, ax as capacityErrorFromBusy, ay as capacityStateFromGrant, az as createProxyClient, aB as knownBehaviorStates, aC as mapTurnState, aD as readInboundRtp, aE as sessionBehaviorSchema, aF as sessionClipSchema, b4 as shouldReplayPendingTurn, aG as splitCallTranscript, aH as useAvatarAdaptivePlayoutDelay, aI as useAvatarCamera, aJ as useAvatarPlayoutDelay, aK as useAvatarQualityGovernor, aL as useCallTranscript, aM as useLiveKitAvatarGrant, aO as useMicLease, aP as useRealtimeSession, aQ as useReleaseMicLeaseOnTrackEnded, aR as useSessionLifecycle } from './proxy-client-Cs2azqD1.js';
 import { CSSProperties, ReactNode } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { R as RecordingArtifact } from './recording-DjswTx5B.js';
@@ -138,6 +138,11 @@ type AvatarCallProps = Pick<SessionLifecycleRoomBridgeProps, "onConnectionDetail
     /** A still shown before the idle clip is playable. */
     poster?: string | null;
     fit?: AvatarVideoFit;
+    /**
+     * The small "live" badge over the video while she is live. Default true. Set false when your
+     * own UI already shows the call's status.
+     */
+    showLiveBadge?: boolean;
     /** Adds your classes to the call's box. The box sizes itself inline; to resize it, use `style`. */
     className?: string;
     /** Inline style for the call's box, spread over its own (`height`, `aspectRatio`, …). */