Généré le 14/10/2026 10:01

🎙️ Diagnostic Approfondi : Latence & Échec de Reconnexion Automatique Live Voice

Date de l'incident : 11 octobre 2026
Fenêtre d'analyse : 16:59:17 à 17:08:40 (Heure locale Guadeloupe, UTC-4)
Appelant : Raphaël (Guadeloupe)
Composants audités :
- JARVIS_LIVE_VOICE/server.py (websocket_jarvis_live_endpoint, gemini_receiver, register_or_resume_session)
- JARVIS_LIVE_VOICE/public_jarvis/app.js (attemptTransportReconnect, startHeartbeat, _bufferReconnectPcm)
- JARVIS_LIVE_VOICE/gemini_key_pool.py (connect_live, gestion des timeouts)
- Journaux uvicorn_supervisor.log et supervisor.log


1. Synthèse Exécutive

Lors de l'appel vocal du 11/10/2026 vers 17h05, Raphaël a subi une coupure totale et prolongée de 1 minute et 38 secondes, accompagnée de latences de réponse anormales (jusqu'à 26,3 secondes sur un tour de parole) et de l'échec répété de la reconnexion automatique.

L'analyse chirurgicale des logs et du code démontre que la reconnexion automatique n'a pas échoué à cause du réseau de Raphaël, mais à cause d'un interblocage (deadlock) structurel entre le client Web et le serveur Python :
1. Le piège du Heartbeat client (12s) : Le client WebSocket déclenche un arrêt d'urgence s'il ne reçoit aucun pong pendant 12 secondes consécutives.
2. Le blocage séquentiel du serveur : Le serveur n'écoute pas la socket et ne répond à aucun ping tant que la session Google Live n'est pas totalement négociée.
3. Le gel de Google Live API (30,2s) : Le modèle principal gemini-3.1-flash-live-preview est resté bloqué 30,2 secondes lors du handshake initial.
4. La boucle infernale (Flapping) : Le client a tué la connexion à 12s, réessayé en boucle, tuant à chaque tentative la connexion que le serveur était en train d'établir.


2. Chronologie Factuelle et Preuves Logs (Appel du 11/10/2026)

Étape 1 : Session initiale et latence critique sur la délégation (16:59:17 - 17:05:15)

Étape 2 : Rupture et échec en boucle de l'auto-reconnexion (17:05:31 - 17:06:53)


3. Causes Racines Techniques

Cause 1 : L'interblocage asynchrone (Deadlock Pong / Handshake)

Cause 2 : Absence de Fail-Fast sur connect_live

Dans gemini_key_pool.py :

ctx = client.aio.live.connect(model=model, config=config)
session = await ctx.__aenter__()  # <-- AUCUN TIMEOUT SPÉCIFIÉ

Le timeout par défaut de la bibliothèque WebSocket sous-jacente est de 30 secondes. En cas d'indisponibilité ou d'engorgement du cluster Google sur gemini-3.1-flash-live-preview, le code attend 30 secondes complètes avant d'essayer le modèle de secours (gemini-2.5-flash-native-audio-latest), ce qui dépasse fatalement le seuil de tolérance de l'appel.

Cause 3 : La latence outil sur active_session.send_tool_response

Lors de la délégation d'une mission :
Le serveur transmet le résultat de l'outil deleguer_mission à Google Live via active_session.send_tool_response(...). Ce paquet transite par le proxy WireGuard local (127.0.0.1:1080 -> VPS en France -> Google). Lors du Tour 14, cette transmission a mis 22,2 secondes à être acquittée par le serveur Google. Pendant ce temps, le flux audio de Jarvis était gelé.


4. Matrice d'Audit du Mode Reconnexion par Scénario Réseau

Scénario Réseau Comportement Actuel Statut Réel Vulnérabilité Majeure
1. Micro-coupure Wi-Fi/4G (< 5s) Hot Audio Engine maintient le micro, reconnecte transport. 🟠 Instable Échoue systématiquement si le handshake Google dépasse 12s (cas constaté aujourd'hui).
2. Changement d'IP (Bascule 4G $\leftrightarrow$ Wi-Fi) L'IP change. Le client fournit son session_id en query param. register_or_resume_session réassocie la session. 🟢 Fonctionnel Fonctionne bien en mémoire JS, mais échoue si le WebView Android recharge la page (session_id non persisté dans localStorage).
3. Perte prolongée / Tunnel coupé (> 15s) Le client réessaie toutes les 3s. Le buffer audio _bufferReconnectPcm est plafonné à 3,5s (112 Ko). 🔴 Perte de données Toutes les paroles prononcées au-delà des 3,5 dernières secondes sont écrasées et perdues.
4. Redémarrage ou crash Uvicorn Superviseur relance en 2s. Sessions mémorisées sur 15 min dans _live_sessions. 🟠 Dégradé La session reprend, mais le texte en cours de prononciation (pending_jarvis_reply_text) en RAM est perdu.
5. Coupure Google 10 min (Signal GoAway) Hot-swap préventif à 9 min (is_internal_reconnect=True) dans gemini_receiver. 🟢 Opérationnel Validé dans les logs (plusieurs hot-swaps réussis sans coupure client).

5. Plan de Résolution Définitif

Correctif 1 : Découplage du Heartbeat avant le signal "READY" (app.js)

Ne pas sanctionner d'un timeout de 12s tant que le serveur n'a pas confirmé que la session AI est prête :
- Modifier startHeartbeat() pour n'activer le seuil de coupure zombie (lastPongAt) qu'après la réception de {"type": "ready"}.
- Pendant la phase de connexion initiale ou de reconnexion (avant ready), accorder une tolérance de 45 secondes pour laisser le temps à la rotation multi-clés et multi-modèles de s'exécuter sans auto-sabotage.

Correctif 2 : Fail-Fast sur l'ouverture de session Google (gemini_key_pool.py)

Encapsuler la négociation dans un délai strict de 7 secondes :

try:
    session = await asyncio.wait_for(ctx.__aenter__(), timeout=7.0)
except asyncio.TimeoutError:
    print(f"[GeminiKeyPool] Timeout 7s dépassé sur {model}, bascule immédiate sur modèle suivant...")

Si gemini-3.1 ne répond pas en 7s, basculer instantanément sur gemini-2.5 au lieu d'attendre 30 secondes.

Correctif 3 : Réponse immédiate aux Pings pendant la négociation (server.py)

Dans websocket_jarvis_live_endpoint :
Lancer la boucle de lecture des pings en tâche concurrente de fond dès le websocket.accept(). Le serveur peut ainsi renvoyer des pong immédiatement au client même si start_session() prend plusieurs secondes.

Correctif 4 : Persistance du session_id dans sessionStorage (app.js)

Stocker this.sessionId dans le stockage de session du navigateur pour résister aux redémarrages de composants de l'application Android.