realtime-avatar 0.11.3 → 0.11.5

package/dist/{chunk-K726WCDN.js → chunk-FAEFGA2G.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.3";
+var SDK_VERSION = "0.11.5";
 var RealtimeAvatar = class {
   #apiKey;
   #baseUrl;

package/dist/{chunk-OVAQBIZ2.js → chunk-SML2NB3Q.js}

@@ -1,4 +1,4 @@
-import { RealtimeAvatar, isQueued, RealtimeAvatarHttpError } from './chunk-K726WCDN.js';
+import { RealtimeAvatar, isQueued, RealtimeAvatarHttpError } from './chunk-FAEFGA2G.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-OVAQBIZ2.js';
-import './chunk-K726WCDN.js';
+import { createProxyHandler } from './chunk-SML2NB3Q.js';
+import './chunk-FAEFGA2G.js';
 
 // ../proxy/src/express.ts
 function realtimeAvatarExpress(config) {

package/dist/hono.js

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

package/dist/index.js

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

package/dist/nextjs.js

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

package/dist/react-native.js

@@ -723,8 +723,28 @@ var DEFAULT_GOVERNOR_CONFIG = {
   downgradeFreezeMs: 150,
   probationFreezeMs: 100,
   openingDwellMs: 2e3,
-  dwellBaseMs: 8e3,
-  dwellMaxMs: 12e4,
+  // HOW LONG THE PICTURE STAYS SOFT AFTER A DEMOTE. Swept against this reducer, 300 s per
+  // run, five link profiles, scored as switches / percent of time on the top rung / worst
+  // single spell on the low cap:
+  //
+  //   profile                      8s x 2^n max 120s   flat 3s        3s x 2^n max 12s
+  //   a spurious blip, link fine    2 /  94% /  19s    2 /  98% / 6s   2 /  97% /  9s
+  //   ordinary jitter, /30s        20 /  61% /  19s   20 /  80% / 6s  20 /  79% /  9s
+  //   flaky, /10s                   9 /   7% / 123s   59 /  40% / 6s  31 /  25% / 15s
+  //   genuinely bad, 600ms /5s      9 /   4% / 123s   59 /  20% / 8s  31 /  11% / 18s
+  //
+  // Two things that table says. First, the old `dwellMaxMs` of 120 s was the real damage:
+  // a link that is merely flaky could sit soft for TWO MINUTES, which is far worse than
+  // the churn the backoff exists to prevent. Second, removing the backoff entirely (flat
+  // 3 s) buys the last few points of quality at 59 switches instead of 31, and a switch is
+  // a decoder reconfigure plus a keyframe wait, measured at about 1.3 s of dead air on a
+  // weak link. So the shape is kept and only the numbers move: start lower, cap far lower.
+  //
+  // This depends on not charging a layer switch to the link (see the size-change reset in
+  // avatar-video-surface). Probing more often is only safe once a failed probe cannot
+  // trigger the next demotion by itself.
+  dwellBaseMs: 3e3,
+  dwellMaxMs: 12e3,
   cleanMs: 3e3,
   probeMs: 1e4,
   healthyResetMs: 12e4

package/dist/react.js

@@ -924,8 +924,28 @@ var DEFAULT_GOVERNOR_CONFIG = {
   downgradeFreezeMs: 150,
   probationFreezeMs: 100,
   openingDwellMs: 2e3,
-  dwellBaseMs: 8e3,
-  dwellMaxMs: 12e4,
+  // HOW LONG THE PICTURE STAYS SOFT AFTER A DEMOTE. Swept against this reducer, 300 s per
+  // run, five link profiles, scored as switches / percent of time on the top rung / worst
+  // single spell on the low cap:
+  //
+  //   profile                      8s x 2^n max 120s   flat 3s        3s x 2^n max 12s
+  //   a spurious blip, link fine    2 /  94% /  19s    2 /  98% / 6s   2 /  97% /  9s
+  //   ordinary jitter, /30s        20 /  61% /  19s   20 /  80% / 6s  20 /  79% /  9s
+  //   flaky, /10s                   9 /   7% / 123s   59 /  40% / 6s  31 /  25% / 15s
+  //   genuinely bad, 600ms /5s      9 /   4% / 123s   59 /  20% / 8s  31 /  11% / 18s
+  //
+  // Two things that table says. First, the old `dwellMaxMs` of 120 s was the real damage:
+  // a link that is merely flaky could sit soft for TWO MINUTES, which is far worse than
+  // the churn the backoff exists to prevent. Second, removing the backoff entirely (flat
+  // 3 s) buys the last few points of quality at 59 switches instead of 31, and a switch is
+  // a decoder reconfigure plus a keyframe wait, measured at about 1.3 s of dead air on a
+  // weak link. So the shape is kept and only the numbers move: start lower, cap far lower.
+  //
+  // This depends on not charging a layer switch to the link (see the size-change reset in
+  // avatar-video-surface). Probing more often is only safe once a failed probe cannot
+  // trigger the next demotion by itself.
+  dwellBaseMs: 3e3,
+  dwellMaxMs: 12e3,
   cleanMs: 3e3,
   probeMs: 1e4,
   healthyResetMs: 12e4
@@ -1502,7 +1522,8 @@ function useLiveFrameFlow(wrapRef, trackProducing, trackIdentity, stallAfterMs)
     lastFrameAtMs: null,
     maxGapMs: 0,
     resumePending: false,
-    producingSinceMs: null
+    producingSinceMs: null,
+    lastSizeKey: null
   });
   useEffect(() => {
     sampleRef.current = {
@@ -1510,7 +1531,8 @@ function useLiveFrameFlow(wrapRef, trackProducing, trackIdentity, stallAfterMs)
       lastFrameAtMs: null,
       maxGapMs: 0,
       resumePending: document.visibilityState !== "visible",
-      producingSinceMs: trackProducing ? Date.now() : null
+      producingSinceMs: trackProducing ? Date.now() : null,
+      lastSizeKey: null
     };
     flowingRef.current = false;
     setSeenFrame(false);
@@ -1527,17 +1549,20 @@ function useLiveFrameFlow(wrapRef, trackProducing, trackIdentity, stallAfterMs)
       const now = Date.now();
       lastCurrentTime = video?.currentTime ?? lastCurrentTime;
       const firstFrame = !previous.seenFrame;
+      const sizeKey = `${video?.videoWidth ?? 0}x${video?.videoHeight ?? 0}`;
+      const layerSwitched = previous.lastSizeKey !== null && sizeKey !== previous.lastSizeKey;
       sampleRef.current = {
         producingSinceMs: previous.producingSinceMs,
         seenFrame: true,
         lastFrameAtMs: now,
         // A hidden tab/bfcache resume is a local scheduling gap, not network
         // congestion. The first fresh frame becomes the new baseline.
-        maxGapMs: previous.resumePending ? 0 : Math.max(
+        maxGapMs: previous.resumePending || layerSwitched ? 0 : Math.max(
           previous.maxGapMs,
           previous.lastFrameAtMs === null ? 0 : now - previous.lastFrameAtMs
         ),
-        resumePending: false
+        resumePending: false,
+        lastSizeKey: sizeKey
       };
       if (firstFrame) setSeenFrame(true);
       recovery.stallAfterMs = escalation.thresholdMs(now);

package/dist/server.js

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

package/dist/tanstack-start.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "realtime-avatar",
-  "version": "0.11.3",
+  "version": "0.11.5",
   "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",