realtime-avatar 0.11.1 → 0.11.3

package/dist/{chunk-X3XXLAJJ.js → chunk-K726WCDN.js}

@@ -218,7 +218,7 @@ function isTransient(cause) {
 
 // ../http-client/src/client.ts
 var DEFAULT_BASE_URL = "https://realtimeavatar.ai/api/v1";
-var SDK_VERSION = "0.11.1";
+var SDK_VERSION = "0.11.3";
 var RealtimeAvatar = class {
   #apiKey;
   #baseUrl;

package/dist/{chunk-2TQVKQJJ.js → chunk-OVAQBIZ2.js}

@@ -1,4 +1,4 @@
-import { RealtimeAvatar, isQueued, RealtimeAvatarHttpError } from './chunk-X3XXLAJJ.js';
+import { RealtimeAvatar, isQueued, RealtimeAvatarHttpError } from './chunk-K726WCDN.js';
 
 // ../proxy/src/config.ts
 var json = (body, status = 200) => new Response(JSON.stringify(body), {

package/dist/express.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-2TQVKQJJ.js';
-import './chunk-X3XXLAJJ.js';
+import { createProxyHandler } from './chunk-OVAQBIZ2.js';
+import './chunk-K726WCDN.js';
 
 // ../proxy/src/express.ts
 function realtimeAvatarExpress(config) {

package/dist/hono.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-2TQVKQJJ.js';
-import './chunk-X3XXLAJJ.js';
+import { createProxyHandler } from './chunk-OVAQBIZ2.js';
+import './chunk-K726WCDN.js';
 
 // ../proxy/src/hono.ts
 function realtimeAvatarHono(config) {

package/dist/index.js

@@ -1 +1 @@
-export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, clipLibraryDeclarationSchema, isQueued, verifyTranscript } from './chunk-X3XXLAJJ.js';
+export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, clipLibraryDeclarationSchema, isQueued, verifyTranscript } from './chunk-K726WCDN.js';

package/dist/nextjs.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-2TQVKQJJ.js';
-import './chunk-X3XXLAJJ.js';
+import { createProxyHandler } from './chunk-OVAQBIZ2.js';
+import './chunk-K726WCDN.js';
 
 // ../proxy/src/nextjs.ts
 function createRealtimeAvatarRoute(config) {

package/dist/{proxy-client-D1Zm7reb.d.ts → proxy-client-8cQOLLE_.d.ts}

@@ -378,8 +378,24 @@ declare const DEFAULT_GOVERNOR_CONFIG: GovernorConfig;
 interface Governor {
     state: GovernorState;
     cap: QualityCap;
-    /** Consecutive failed up-probes — drives the exponential dwell backoff. */
+    /** Consecutive failed up-probes. Drives the exponential dwell backoff.
+     *
+     *  NOT a signal about the low rung. It counts attempts to reach HIGH that did not
+     *  survive, which says nothing about whether the rung below HIGH is holdable. Using it
+     *  to pick WHICH rung "low" means was a real regression: see `lowUnhealthy`. */
     failures: number;
+    /** Unhealthy ticks observed while ALREADY on the low cap.
+     *
+     *  This is the only honest evidence that the low rung itself is not affordable, and it
+     *  is what steps the cap down to the bottom of the ladder. It exists because `failures`
+     *  looked like it would do the job and does not: a starved OPENING reports the wait for
+     *  the first frame as a freeze (`firstFrameWaitFreezeMs`), so any session whose first
+     *  frame is slower than about a second fails its opening probation and lands on
+     *  `failures = 1` before the link has been asked to carry anything. Measured on prod,
+     *  first frames ran 2.4 s to 28 s, i.e. essentially every call. Keying the rung step on
+     *  `failures` therefore sent the FIRST demote straight to the bottom rung, including on
+     *  a call that recorded zero freezes. Reset whenever the cap returns to high. */
+    lowUnhealthy: number;
     /** Wall-clock ms the current state was entered (for dwell/clean/probe timing). */
     enteredAtMs: number;
     /** Wall-clock ms of the last healthy tick in the current low period (clean-window

package/dist/react-native.d.ts

@@ -1,8 +1,8 @@
 import { LiveKitRoomProps } from '@livekit/react-native';
 export { AudioSession, VideoTrack, VideoTrackProps, registerGlobals } from '@livekit/react-native';
 import { ReactNode, ReactElement } from 'react';
-import { L as LiveKitSessionGrant, A as AvatarVideoFit } from './proxy-client-D1Zm7reb.js';
-export { a as AdaptivePlayoutController, b as AdaptivePlayoutDecision, c as AdaptivePlayoutOptions, d as AdaptivePlayoutSample, e as ApproachingEndEvent, f as ApproachingEndReason, g as AvatarSessionClient, B as BehaviorSnapshot, C as CallTranscript, h as CallTranscriptSegment, i as CartesiaTtsModel, j as ClipResult, k as ClosingTurnResult, l as CreditsLowEvent, D as DEFAULT_APPROACHING_END_LEAD_SECONDS, m as DEFAULT_CREDITS_LOW_LEAD_SECONDS, n as DEFAULT_GOVERNOR_CONFIG, o as DEFAULT_GRACE_CEILING_SECONDS, p as DEFAULT_GRACE_WINDOW_LEAD_SECONDS, q as DEFAULT_IDLE_SECONDS, r as DEFAULT_IDLE_WARN_LEAD_SECONDS, s as DEFAULT_TURN_TIMEOUT_SECONDS, E as EndReason, t as EndedEvent, u as ExtendResult, F as FishTtsModel, v as FreezeReadingFn, G as Governor, w as GovernorAction, x as GovernorConfig, y as GovernorSignal, z as GovernorState, H as GraceWindowClosedEvent, I as GraceWindowOpenEvent, J as GraceWindowState, K as IdleWarningEvent, M as InboundRtpCursor, N as InboundRtpReading, O as KnownBehaviorState, P as LLMProvider, Q as LLMSelection, R as LiveKitAvatarGrantState, S as LiveKitAvatarGrantStatus, T as LiveKitCapacityState, U as LiveKitConnectionStatus, V as LiveKitSessionRequest, W as LiveKitSessionStartResult, X as MAX_RECONNECT_ATTEMPTS, Y as MAX_SESSION_INSTRUCTIONS_CHARS, Z as ProxyClientOptions, _ as QualityCap, $ as RECONNECT_BACKOFF_MS, a0 as RealtimeAvatarRequestOptions, a1 as RealtimeSessionApi, a2 as RealtimeSessionMedia, a3 as RealtimeSessionRoomSinks, a4 as ReconnectPolicy, a5 as ReconnectingEvent, a6 as RecoveryState, a7 as RetryStep, a8 as SessionBehavior, a9 as SessionClip, aa as SessionClocks, ab as SessionEndReason, ac as SessionLifecycleApi, ad as SessionLifecyclePhase, ae as SessionLifecyclePhaseKind, af as SessionLifecycleRoomBridge, ag as SessionLifecycleRoomBridgeProps, ah as SurfaceLayers, ai as TurnState, aj as TurnTimeoutEvent, ak as UseAvatarQualityGovernorInput, al as UseLiveKitAvatarGrantInput, am as UseRealtimeSessionInput, an as UseSessionLifecycleInput, ao as VoiceSpec, ap as VoiceSpecInput, aq as capacityErrorFromBusy, ar as capacityStateFromGrant, as as createProxyClient, at as isNativeLiveTrackSubscribed, au as knownBehaviorStates, av as mapTurnState, aw as readInboundRtp, ax as sessionBehaviorSchema, ay as sessionClipSchema, az as splitCallTranscript, aA as useAvatarAdaptivePlayoutDelay, aB as useAvatarPlayoutDelay, aC as useAvatarQualityGovernor, aD as useCallTranscript, aE as useLiveKitAvatarGrant, aF as useLiveTrackProducing, aG as useMicLease, aH as useRealtimeSession, aI as useReleaseMicLeaseOnTrackEnded, aJ as useSessionLifecycle } from './proxy-client-D1Zm7reb.js';
+import { L as LiveKitSessionGrant, A as AvatarVideoFit } from './proxy-client-8cQOLLE_.js';
+export { a as AdaptivePlayoutController, b as AdaptivePlayoutDecision, c as AdaptivePlayoutOptions, d as AdaptivePlayoutSample, e as ApproachingEndEvent, f as ApproachingEndReason, g as AvatarSessionClient, B as BehaviorSnapshot, C as CallTranscript, h as CallTranscriptSegment, i as CartesiaTtsModel, j as ClipResult, k as ClosingTurnResult, l as CreditsLowEvent, D as DEFAULT_APPROACHING_END_LEAD_SECONDS, m as DEFAULT_CREDITS_LOW_LEAD_SECONDS, n as DEFAULT_GOVERNOR_CONFIG, o as DEFAULT_GRACE_CEILING_SECONDS, p as DEFAULT_GRACE_WINDOW_LEAD_SECONDS, q as DEFAULT_IDLE_SECONDS, r as DEFAULT_IDLE_WARN_LEAD_SECONDS, s as DEFAULT_TURN_TIMEOUT_SECONDS, E as EndReason, t as EndedEvent, u as ExtendResult, F as FishTtsModel, v as FreezeReadingFn, G as Governor, w as GovernorAction, x as GovernorConfig, y as GovernorSignal, z as GovernorState, H as GraceWindowClosedEvent, I as GraceWindowOpenEvent, J as GraceWindowState, K as IdleWarningEvent, M as InboundRtpCursor, N as InboundRtpReading, O as KnownBehaviorState, P as LLMProvider, Q as LLMSelection, R as LiveKitAvatarGrantState, S as LiveKitAvatarGrantStatus, T as LiveKitCapacityState, U as LiveKitConnectionStatus, V as LiveKitSessionRequest, W as LiveKitSessionStartResult, X as MAX_RECONNECT_ATTEMPTS, Y as MAX_SESSION_INSTRUCTIONS_CHARS, Z as ProxyClientOptions, _ as QualityCap, $ as RECONNECT_BACKOFF_MS, a0 as RealtimeAvatarRequestOptions, a1 as RealtimeSessionApi, a2 as RealtimeSessionMedia, a3 as RealtimeSessionRoomSinks, a4 as ReconnectPolicy, a5 as ReconnectingEvent, a6 as RecoveryState, a7 as RetryStep, a8 as SessionBehavior, a9 as SessionClip, aa as SessionClocks, ab as SessionEndReason, ac as SessionLifecycleApi, ad as SessionLifecyclePhase, ae as SessionLifecyclePhaseKind, af as SessionLifecycleRoomBridge, ag as SessionLifecycleRoomBridgeProps, ah as SurfaceLayers, ai as TurnState, aj as TurnTimeoutEvent, ak as UseAvatarQualityGovernorInput, al as UseLiveKitAvatarGrantInput, am as UseRealtimeSessionInput, an as UseSessionLifecycleInput, ao as VoiceSpec, ap as VoiceSpecInput, aq as capacityErrorFromBusy, ar as capacityStateFromGrant, as as createProxyClient, at as isNativeLiveTrackSubscribed, au as knownBehaviorStates, av as mapTurnState, aw as readInboundRtp, ax as sessionBehaviorSchema, ay as sessionClipSchema, az as splitCallTranscript, aA as useAvatarAdaptivePlayoutDelay, aB as useAvatarPlayoutDelay, aC as useAvatarQualityGovernor, aD as useCallTranscript, aE as useLiveKitAvatarGrant, aF as useLiveTrackProducing, aG as useMicLease, aH as useRealtimeSession, aI as useReleaseMicLeaseOnTrackEnded, aJ as useSessionLifecycle } from './proxy-client-8cQOLLE_.js';
 import { StyleProp, ViewStyle } from 'react-native';
 export { useChat, useConnectionState, useLocalParticipant, useRoomContext, useTrackToggle, useTranscriptions, useVoiceAssistant } from '@livekit/components-react';
 export { D as DEFAULT_AVATAR_PLAYOUT_DELAY_SECONDS } from './playout-delay-DWOc8iCl.js';

package/dist/react-native.js

@@ -747,6 +747,7 @@ var initGovernor = (nowMs, openingCap = "low") => ({
   state: openingCap === "high" ? "opening_high" : "opening",
   cap: openingCap,
   failures: 0,
+  lowUnhealthy: 0,
   enteredAtMs: nowMs,
   healthySinceMs: null
 });
@@ -794,12 +795,14 @@ var step = (g, s, nowMs, cfg = DEFAULT_GOVERNOR_CONFIG) => {
       const healthy = isHealthy(s);
       const healthySince = healthy ? g.healthySinceMs ?? nowMs : null;
       const resetFailures = healthy && healthySince !== null && nowMs - healthySince >= cfg.healthyResetMs;
+      const lowUnhealthy = healthy ? g.lowUnhealthy : g.lowUnhealthy + 1;
       const dwellDone = nowMs - g.enteredAtMs >= dwellMs(g.failures, cfg);
       if (dwellDone && healthy) {
         return {
           governor: {
             ...enter(g, "cap_low_eligible", "low", nowMs),
             failures: resetFailures ? 0 : g.failures,
+            lowUnhealthy: resetFailures ? 0 : lowUnhealthy,
             healthySinceMs: nowMs
           }
         };
@@ -808,13 +811,14 @@ var step = (g, s, nowMs, cfg = DEFAULT_GOVERNOR_CONFIG) => {
         governor: {
           ...g,
           healthySinceMs: healthySince,
-          failures: resetFailures ? 0 : g.failures
+          failures: resetFailures ? 0 : g.failures,
+          lowUnhealthy: resetFailures ? 0 : lowUnhealthy
         }
       };
     }
     case "cap_low_eligible": {
       if (!isHealthy(s)) {
-        return { governor: { ...g, healthySinceMs: null } };
+        return { governor: { ...g, healthySinceMs: null, lowUnhealthy: g.lowUnhealthy + 1 } };
       }
       const cleanSince = g.healthySinceMs ?? nowMs;
       if (nowMs - cleanSince >= cfg.cleanMs) {
@@ -827,7 +831,9 @@ var step = (g, s, nowMs, cfg = DEFAULT_GOVERNOR_CONFIG) => {
     }
     case "probing_up": {
       if (nowMs - g.enteredAtMs >= cfg.probeMs) {
-        return { governor: { ...enter(g, "cap_high_stable", "high", nowMs), failures: 0 } };
+        return {
+          governor: { ...enter(g, "cap_high_stable", "high", nowMs), failures: 0, lowUnhealthy: 0 }
+        };
       }
       return { governor: g };
     }
@@ -837,9 +843,11 @@ var step = (g, s, nowMs, cfg = DEFAULT_GOVERNOR_CONFIG) => {
       return { governor: g };
   }
 };
-var resolveLowCapQuality = (declaredLayerQualities) => {
+var LOW_CAP_STEP_AFTER_UNHEALTHY = 2;
+var resolveLowCapQuality = (declaredLayerQualities, lowUnhealthy = 0) => {
   const sorted = [...declaredLayerQualities].sort((a, b) => a - b);
-  return sorted.length >= 2 ? sorted[sorted.length - 2] : 1;
+  if (sorted.length < 2) return 1;
+  return lowUnhealthy >= LOW_CAP_STEP_AFTER_UNHEALTHY ? sorted[0] : sorted[sorted.length - 2];
 };
 
 // ../client/src/react/use-quality-governor.ts
@@ -959,10 +967,11 @@ function useAvatarQualityGovernor(input) {
         return { freezeMs: 0, jitterRising: false };
       }
     };
-    const applyCap = (cap) => {
+    const applyCap = (cap, lowUnhealthy = 0) => {
       try {
         const lowCap = resolveLowCapQuality(
-          (targetPublication?.trackInfo?.layers ?? []).map((l) => l.quality)
+          (targetPublication?.trackInfo?.layers ?? []).map((l) => l.quality),
+          lowUnhealthy
         );
         targetPublication?.setVideoQuality?.(cap === "low" ? lowCap : VideoQuality.HIGH);
       } catch {
@@ -987,13 +996,13 @@ function useAvatarQualityGovernor(input) {
         pausedSinceTick = false;
         const { governor, action } = step(gov, signal, Date.now(), config);
         gov = governor;
-        if (action) applyCap(action.setCap);
+        if (action) applyCap(action.setCap, gov.lowUnhealthy);
       } catch {
       } finally {
         tickRunning = false;
       }
     };
-    applyCap(gov.cap);
+    applyCap(gov.cap, gov.lowUnhealthy);
     const handle = setInterval(() => void tick(), tickMs);
     return () => {
       disposed = true;

package/dist/react.d.ts

@@ -1,7 +1,7 @@
 import { RegisteredTool, ToolRegistration } from './tools.js';
 import { ReactNode } from 'react';
-import { g as AvatarSessionClient, A as AvatarVideoFit } from './proxy-client-D1Zm7reb.js';
-export { a as AdaptivePlayoutController, b as AdaptivePlayoutDecision, c as AdaptivePlayoutOptions, d as AdaptivePlayoutSample, e as ApproachingEndEvent, f as ApproachingEndReason, aK as AvatarVideoSurface, aL as AvatarVideoSurfaceProps, B as BehaviorSnapshot, C as CallTranscript, h as CallTranscriptSegment, i as CartesiaTtsModel, j as ClipResult, k as ClosingTurnResult, l as CreditsLowEvent, D as DEFAULT_APPROACHING_END_LEAD_SECONDS, m as DEFAULT_CREDITS_LOW_LEAD_SECONDS, n as DEFAULT_GOVERNOR_CONFIG, o as DEFAULT_GRACE_CEILING_SECONDS, p as DEFAULT_GRACE_WINDOW_LEAD_SECONDS, q as DEFAULT_IDLE_SECONDS, r as DEFAULT_IDLE_WARN_LEAD_SECONDS, s as DEFAULT_TURN_TIMEOUT_SECONDS, E as EndReason, t as EndedEvent, u as ExtendResult, F as FishTtsModel, v as FreezeReadingFn, G as Governor, w as GovernorAction, x as GovernorConfig, y as GovernorSignal, z as GovernorState, H as GraceWindowClosedEvent, I as GraceWindowOpenEvent, J as GraceWindowState, K as IdleWarningEvent, M as InboundRtpCursor, N as InboundRtpReading, O as KnownBehaviorState, P as LLMProvider, Q as LLMSelection, R as LiveKitAvatarGrantState, S as LiveKitAvatarGrantStatus, T as LiveKitCapacityState, U as LiveKitConnectionStatus, V as LiveKitSessionRequest, W as LiveKitSessionStartResult, aM as LivePlaybackKeeper, X as MAX_RECONNECT_ATTEMPTS, Y as MAX_SESSION_INSTRUCTIONS_CHARS, aN as MIC_LEASE_ENDED_TIMEOUT_MS, aO as MicLease, aP as PlayableVideoElement, Z as ProxyClientOptions, _ as QualityCap, $ as RECONNECT_BACKOFF_MS, aQ as RealtimeAvatarCapacityError, aR as RealtimeAvatarLiveKitRoom, aS as RealtimeAvatarLiveKitRoomProps, a0 as RealtimeAvatarRequestOptions, a1 as RealtimeSessionApi, a2 as RealtimeSessionMedia, a3 as RealtimeSessionRoomSinks, a4 as ReconnectPolicy, a5 as ReconnectingEvent, a6 as RecoveryState, a7 as RetryStep, a8 as SessionBehavior, a9 as SessionClip, aa as SessionClocks, ab as SessionEndReason, ac as SessionLifecycleApi, ad as SessionLifecyclePhase, ae as SessionLifecyclePhaseKind, af as SessionLifecycleRoomBridge, ag as SessionLifecycleRoomBridgeProps, ah as SurfaceLayers, ai as TurnState, aj as TurnTimeoutEvent, ak as UseAvatarQualityGovernorInput, al as UseLiveKitAvatarGrantInput, am as UseRealtimeSessionInput, an as UseSessionLifecycleInput, ao as VoiceSpec, ap as VoiceSpecInput, aq as capacityErrorFromBusy, ar as capacityStateFromGrant, as as createProxyClient, au as knownBehaviorStates, av as mapTurnState, aw as readInboundRtp, ax as sessionBehaviorSchema, ay as sessionClipSchema, aT as shouldReplayPendingTurn, az as splitCallTranscript, aA as useAvatarAdaptivePlayoutDelay, aB as useAvatarPlayoutDelay, aC as useAvatarQualityGovernor, aD as useCallTranscript, aE as useLiveKitAvatarGrant, aG as useMicLease, aH as useRealtimeSession, aI as useReleaseMicLeaseOnTrackEnded, aJ as useSessionLifecycle } from './proxy-client-D1Zm7reb.js';
+import { g as AvatarSessionClient, A as AvatarVideoFit } from './proxy-client-8cQOLLE_.js';
+export { a as AdaptivePlayoutController, b as AdaptivePlayoutDecision, c as AdaptivePlayoutOptions, d as AdaptivePlayoutSample, e as ApproachingEndEvent, f as ApproachingEndReason, aK as AvatarVideoSurface, aL as AvatarVideoSurfaceProps, B as BehaviorSnapshot, C as CallTranscript, h as CallTranscriptSegment, i as CartesiaTtsModel, j as ClipResult, k as ClosingTurnResult, l as CreditsLowEvent, D as DEFAULT_APPROACHING_END_LEAD_SECONDS, m as DEFAULT_CREDITS_LOW_LEAD_SECONDS, n as DEFAULT_GOVERNOR_CONFIG, o as DEFAULT_GRACE_CEILING_SECONDS, p as DEFAULT_GRACE_WINDOW_LEAD_SECONDS, q as DEFAULT_IDLE_SECONDS, r as DEFAULT_IDLE_WARN_LEAD_SECONDS, s as DEFAULT_TURN_TIMEOUT_SECONDS, E as EndReason, t as EndedEvent, u as ExtendResult, F as FishTtsModel, v as FreezeReadingFn, G as Governor, w as GovernorAction, x as GovernorConfig, y as GovernorSignal, z as GovernorState, H as GraceWindowClosedEvent, I as GraceWindowOpenEvent, J as GraceWindowState, K as IdleWarningEvent, M as InboundRtpCursor, N as InboundRtpReading, O as KnownBehaviorState, P as LLMProvider, Q as LLMSelection, R as LiveKitAvatarGrantState, S as LiveKitAvatarGrantStatus, T as LiveKitCapacityState, U as LiveKitConnectionStatus, V as LiveKitSessionRequest, W as LiveKitSessionStartResult, aM as LivePlaybackKeeper, X as MAX_RECONNECT_ATTEMPTS, Y as MAX_SESSION_INSTRUCTIONS_CHARS, aN as MIC_LEASE_ENDED_TIMEOUT_MS, aO as MicLease, aP as PlayableVideoElement, Z as ProxyClientOptions, _ as QualityCap, $ as RECONNECT_BACKOFF_MS, aQ as RealtimeAvatarCapacityError, aR as RealtimeAvatarLiveKitRoom, aS as RealtimeAvatarLiveKitRoomProps, a0 as RealtimeAvatarRequestOptions, a1 as RealtimeSessionApi, a2 as RealtimeSessionMedia, a3 as RealtimeSessionRoomSinks, a4 as ReconnectPolicy, a5 as ReconnectingEvent, a6 as RecoveryState, a7 as RetryStep, a8 as SessionBehavior, a9 as SessionClip, aa as SessionClocks, ab as SessionEndReason, ac as SessionLifecycleApi, ad as SessionLifecyclePhase, ae as SessionLifecyclePhaseKind, af as SessionLifecycleRoomBridge, ag as SessionLifecycleRoomBridgeProps, ah as SurfaceLayers, ai as TurnState, aj as TurnTimeoutEvent, ak as UseAvatarQualityGovernorInput, al as UseLiveKitAvatarGrantInput, am as UseRealtimeSessionInput, an as UseSessionLifecycleInput, ao as VoiceSpec, ap as VoiceSpecInput, aq as capacityErrorFromBusy, ar as capacityStateFromGrant, as as createProxyClient, au as knownBehaviorStates, av as mapTurnState, aw as readInboundRtp, ax as sessionBehaviorSchema, ay as sessionClipSchema, aT as shouldReplayPendingTurn, az as splitCallTranscript, aA as useAvatarAdaptivePlayoutDelay, aB as useAvatarPlayoutDelay, aC as useAvatarQualityGovernor, aD as useCallTranscript, aE as useLiveKitAvatarGrant, aG as useMicLease, aH as useRealtimeSession, aI as useReleaseMicLeaseOnTrackEnded, aJ as useSessionLifecycle } from './proxy-client-8cQOLLE_.js';
 export { D as DEFAULT_AVATAR_PLAYOUT_DELAY_SECONDS } from './playout-delay-DWOc8iCl.js';
 import 'zod';
 import '@livekit/components-react';

package/dist/react.js

@@ -948,6 +948,7 @@ var initGovernor = (nowMs, openingCap = "low") => ({
   state: openingCap === "high" ? "opening_high" : "opening",
   cap: openingCap,
   failures: 0,
+  lowUnhealthy: 0,
   enteredAtMs: nowMs,
   healthySinceMs: null
 });
@@ -995,12 +996,14 @@ var step = (g, s, nowMs, cfg = DEFAULT_GOVERNOR_CONFIG) => {
       const healthy = isHealthy(s);
       const healthySince = healthy ? g.healthySinceMs ?? nowMs : null;
       const resetFailures = healthy && healthySince !== null && nowMs - healthySince >= cfg.healthyResetMs;
+      const lowUnhealthy = healthy ? g.lowUnhealthy : g.lowUnhealthy + 1;
       const dwellDone = nowMs - g.enteredAtMs >= dwellMs(g.failures, cfg);
       if (dwellDone && healthy) {
         return {
           governor: {
             ...enter(g, "cap_low_eligible", "low", nowMs),
             failures: resetFailures ? 0 : g.failures,
+            lowUnhealthy: resetFailures ? 0 : lowUnhealthy,
             healthySinceMs: nowMs
           }
         };
@@ -1009,13 +1012,14 @@ var step = (g, s, nowMs, cfg = DEFAULT_GOVERNOR_CONFIG) => {
         governor: {
           ...g,
           healthySinceMs: healthySince,
-          failures: resetFailures ? 0 : g.failures
+          failures: resetFailures ? 0 : g.failures,
+          lowUnhealthy: resetFailures ? 0 : lowUnhealthy
         }
       };
     }
     case "cap_low_eligible": {
       if (!isHealthy(s)) {
-        return { governor: { ...g, healthySinceMs: null } };
+        return { governor: { ...g, healthySinceMs: null, lowUnhealthy: g.lowUnhealthy + 1 } };
       }
       const cleanSince = g.healthySinceMs ?? nowMs;
       if (nowMs - cleanSince >= cfg.cleanMs) {
@@ -1028,7 +1032,9 @@ var step = (g, s, nowMs, cfg = DEFAULT_GOVERNOR_CONFIG) => {
     }
     case "probing_up": {
       if (nowMs - g.enteredAtMs >= cfg.probeMs) {
-        return { governor: { ...enter(g, "cap_high_stable", "high", nowMs), failures: 0 } };
+        return {
+          governor: { ...enter(g, "cap_high_stable", "high", nowMs), failures: 0, lowUnhealthy: 0 }
+        };
       }
       return { governor: g };
     }
@@ -1038,9 +1044,11 @@ var step = (g, s, nowMs, cfg = DEFAULT_GOVERNOR_CONFIG) => {
       return { governor: g };
   }
 };
-var resolveLowCapQuality = (declaredLayerQualities) => {
+var LOW_CAP_STEP_AFTER_UNHEALTHY = 2;
+var resolveLowCapQuality = (declaredLayerQualities, lowUnhealthy = 0) => {
   const sorted = [...declaredLayerQualities].sort((a, b) => a - b);
-  return sorted.length >= 2 ? sorted[sorted.length - 2] : 1;
+  if (sorted.length < 2) return 1;
+  return lowUnhealthy >= LOW_CAP_STEP_AFTER_UNHEALTHY ? sorted[0] : sorted[sorted.length - 2];
 };
 
 // ../client/src/react/use-quality-governor.ts
@@ -1160,10 +1168,11 @@ function useAvatarQualityGovernor(input) {
         return { freezeMs: 0, jitterRising: false };
       }
     };
-    const applyCap = (cap) => {
+    const applyCap = (cap, lowUnhealthy = 0) => {
       try {
         const lowCap = resolveLowCapQuality(
-          (targetPublication?.trackInfo?.layers ?? []).map((l) => l.quality)
+          (targetPublication?.trackInfo?.layers ?? []).map((l) => l.quality),
+          lowUnhealthy
         );
         targetPublication?.setVideoQuality?.(cap === "low" ? lowCap : VideoQuality.HIGH);
       } catch {
@@ -1188,13 +1197,13 @@ function useAvatarQualityGovernor(input) {
         pausedSinceTick = false;
         const { governor, action } = step(gov, signal, Date.now(), config);
         gov = governor;
-        if (action) applyCap(action.setCap);
+        if (action) applyCap(action.setCap, gov.lowUnhealthy);
       } catch {
       } finally {
         tickRunning = false;
       }
     };
-    applyCap(gov.cap);
+    applyCap(gov.cap, gov.lowUnhealthy);
     const handle = setInterval(() => void tick(), tickMs);
     return () => {
       disposed = true;
@@ -1476,7 +1485,7 @@ function isFrameFlowingAt(snapshot) {
 }
 function freezeMsFromFrameGap(gapMs) {
   if (!Number.isFinite(gapMs) || gapMs <= AVATAR_FRAME_GAP_FREEZE_FLOOR_MS) return 0;
-  return gapMs;
+  return gapMs - AVATAR_FRAME_GAP_FREEZE_FLOOR_MS;
 }
 function isFrameFreezeInhibited(snapshot) {
   return snapshot.hidden || snapshot.resumePending || !snapshot.trackProducing || !snapshot.seenFrame || snapshot.lastFrameAtMs === null;

package/dist/server.js

@@ -1 +1 @@
-export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, clipLibraryDeclarationSchema, isQueued, verifyTranscript } from './chunk-X3XXLAJJ.js';
+export { RealtimeAvatar, RealtimeAvatarError, RealtimeAvatarHttpError, clipLibraryDeclarationSchema, isQueued, verifyTranscript } from './chunk-K726WCDN.js';

package/dist/tanstack-start.js

@@ -1,5 +1,5 @@
-import { createProxyHandler } from './chunk-2TQVKQJJ.js';
-import './chunk-X3XXLAJJ.js';
+import { createProxyHandler } from './chunk-OVAQBIZ2.js';
+import './chunk-K726WCDN.js';
 
 // src/tanstack-start.ts
 function realtimeAvatarServerRoute(config) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "realtime-avatar",
-  "version": "0.11.1",
+  "version": "0.11.3",
   "description": "Realtime Avatar SDK. `realtime-avatar` and the route adapters hold your API key and are server-only; `realtime-avatar/react`, `/browser` and `/tools` never can — importing a server entry into a browser build throws at bundle time.",
   "license": "MIT",
   "author": "The Influence Company",