voice_live_routes
diapason.server.voice_live_routes
¶
WebSocket routes for realtime duplex voice (/v1/voice/live).
outils_demandes_par_le_client(csv)
¶
Ce qu'un client a le droit de demander à la voix — au plus le défaut.
RESTREINDRE, jamais élargir. Cette liste vient de la trame WebSocket du
client ; list_voice_tool_ids ne la confrontait qu'au registre GLOBAL,
si bien qu'un client pouvait demander n'importe quel outil enregistré —
y compris ceux que DEFAULT_VOICE_TOOL_IDS tient délibérément hors du
chemin vocal, et qu'un test-fusible prétend garder. La restriction était
décorative : elle se contournait en nommant l'outil.
Ce n'est pas une élévation de privilège : le WebSocket est derrière la clé d'API, et le même outil s'atteint par le chat. C'est une décision de portée qui ne s'appliquait pas — ce qui est pire qu'une décision absente, parce qu'un test la disait tenue.
La liste du SERVEUR (defaults) n'est pas bridée ici : elle vient de la
configuration, donc de la machine, pas du réseau.
Rend None quand il ne reste rien — même contrat que
_parse_tools_csv, et même conséquence en aval : « aucune restriction
demandée », donc la liste par défaut. Un client qui ne nomme QUE des
outils hors portée obtient le défaut, pas le vide : refuser toute voix à
qui a mal demandé serait une punition, pas une garde.
voice_live_health(request)
async
¶
Report realtime voice availability (keys + config).
websocket_voice_live(websocket)
async
¶
Realtime duplex voice bridge.
Client protocol (JSON)::
{"type": "start", "provider": "gemini"|"openai", "voice": "...", ...}
{"type": "audio", "data": "<base64 pcm16>", "sample_rate": 16000}
{"type": "text", "text": "..."}
{"type": "interrupt"}
{"type": "stop"}
Server protocol::
{"type": "ready"}
{"type": "audio", "data": "<base64 pcm16>", "sample_rate": 24000}
{"type": "transcript", "role": ..., "text": ..., "final": bool, "replace": bool}
{"type": "tool", "name": "...", "ok": bool, "detail": "..."}
{"type": "interrupted"}
{"type": "error", "detail": "..."}
{"type": "closed"}