Skip to content

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"}