@furious.luke/argus-js 0.5.6 → 0.5.7

package/README.md

@@ -241,6 +241,7 @@ not the `utterance_finished` lifecycle event, which can overtake the last chunk.
 | `onUserTextResult({ messageId, accepted, reason })` | The server accepted or rejected a `sendUserText` message. |
 | `onConnectionStats(sample)` | A periodic `ConnectionStatsSample` (loss ratio, RTT, jitter, send/available bitrate, encoder limitation) — the raw feed behind `onConnectionQualityChange`. Fires every `connectionStatsIntervalMs` while connected. |
 | `onConnectionQualityChange({ level, sample })` | The derived connection-quality level (`"good" \| "fair" \| "poor" \| "critical"`) changed, including the first assessment after connecting. Downgrades are debounced; upgrades fire immediately. React to a degrading uplink here — warn the user, or drop a secondary track. |
+| `onSpeechQualityChange({ degraded, realtimeFactor })` | Server-side text-to-speech generation crossed the realtime boundary: `degraded: true` when the TTS provider dropped below realtime (`realtimeFactor` < 1.0), synthesizing slower than it plays and starving playout, `degraded: false` once it climbs comfortably back above realtime. The degraded transition is raised **live during synthesis** (a long, slow utterance is reported while it happens, not at its end). Edge-triggered (no flapping at the boundary). A **distinct axis from `onConnectionQualityChange`** (that is network health) — react by warning the user or offering a text fallback. |
 | `onError(error)` | A fatal error occurred (signaling error, WebRTC connection failure/timeout, or signaling resume timed out). |
 
 ## How `start()` works

package/dist/index.cjs

@@ -1121,6 +1121,17 @@ var Publisher = class {
         this.completeMediaRecovery(msg.track);
         break;
       }
+      case "speech_slow": {
+        this.opts.callbacks?.onSpeechQualityChange?.({
+          degraded: true,
+          realtimeFactor: msg.realtime_factor
+        });
+        break;
+      }
+      case "speech_recovered": {
+        this.opts.callbacks?.onSpeechQualityChange?.({ degraded: false });
+        break;
+      }
       case "error": {
         const err = new ReportedPublisherError(msg.error, msg.fatal === true);
         const pending = this.pendingAnswer;