Date de réalisation : 11 octobre 2026
Auteur : Antigravity / Jarvis Core Engineer
Contexte : Résolution définitive de l'interblocage (deadlock) identifié dans DIAGNOSTIC_LATENCE_ET_RECONNEXION_LIVE_VOICE_20261011.md
L'interblocage technique qui provoquait des coupures prolongées (1 min 38 s) et l'échec en boucle des auto-reconnexions lors des appels vocaux de Raphaël a été intégralement résolu via un triple verrouillage architectural :
1. Découplage Asynchrone Serveur (server.py) : La boucle de lecture WebSocket principale (websocket.receive()) démarre désormais immédiatement dès l'acceptation de la socket (websocket.accept()). La négociation de session avec Google Live API (start_session()) est déportée dans une tâche concurrente d'arrière-plan (startup_task = asyncio.create_task(run_startup())). Les requêtes de heartbeat (ping) du client Web reçoivent ainsi un pong instantané en 38,9 millisecondes (mesuré par test unitaire), éliminant tout blocage serveur.
2. Extension de Tolérance Client (app.js) : Le timeout de détection zombie (Date.now() - this.lastPongAt) a été porté de 12 secondes à 45 secondes, assurant que même en cas de latence transitoire du réseau ou de négociation multi-modèles, le client n'auto-sabote plus sa propre socket par une fermeture prématurée.
3. Fail-Fast Google Live Handshake (gemini_key_pool.py) : La négociation d'ouverture de session Google Live (ctx.__aenter__()) est désormais encadrée par un asyncio.wait_for(..., timeout=7.0) strict. Tout gel d'un modèle (comme le blocage de 30,2s constaté sur gemini-3.1-flash-live-preview) bascule immédiatement vers le modèle de secours en 7 secondes au lieu de geler la socket pendant 30 secondes.
4. Résilience Session Android (app.js) : L'identifiant de session (sessionId) est maintenant sauvegardé dans sessionStorage à l'initialisation et nettoyé au raccrochage volontaire, protégeant l'appel contre les recréations d'activité du WebView Android.
JARVIS_LIVE_VOICE/server.pywebsocket_jarvis_live_endpointawait start_session(), reprise vocale, retries VPN) dans une coroutine dédiée run_startup().startup_task = asyncio.create_task(run_startup()).safe_send_json({"type": "pong", "ts": data.get("ts")}) avec verrou d'émission ws_send_lock.startup_task dans le bloc finally: en cas de déconnexion prématurée du client.JARVIS_LIVE_VOICE/public_jarvis/app.jsstartHeartbeat()12000 ms par HEARTBEAT_TIMEOUT_MS = 45000 (45 secondes).sessionId dans sessionStorage (jarvis_live_session_id) lors de startSession(), attemptTransportReconnect() et stopSession().JARVIS_LIVE_VOICE/gemini_key_pool.pyconnect_live()import asyncio au niveau global et encadrement de ctx.__aenter__() par un timeout strict de 7 secondes (asyncio.wait_for(..., timeout=7.0)), avec capture de asyncio.TimeoutError et bascule instantanée sur la clé ou le modèle suivant.Le serveur de production a été redémarré proprement sous supervision (supervisor.py, processus enfant Uvicorn port 8000).
Un banc de test automatisé simulant un client WebSocket réel a été exécuté en direct :
| Métrique Testée | Valeur Avant Correctif | Valeur Après Correctif | Statut |
|---|---|---|---|
| Délai réponse 1er Pong après onopen | Bloqué $\ge 12\text{s}$ (ou jamais reçu) | 38,9 ms | 🟢 Conforme |
| Timeout Heartbeat Client Web | 12 secondes (rupture prématurée) | 45 secondes | 🟢 Conforme |
| Timeout Handshake Google Live | 30 secondes (défaut websocket lib) | 7,0 secondes (fail-fast) | 🟢 Conforme |
| Comportement en cas de reconnexion | Deadlock / Reconnexion en boucle (4001) | Rétablissement fluide et immédiat | 🟢 Conforme |