Proposition : Progress Steps + Model Fallback + Deep Search

Status : EN ATTENTE

Date : 31/01/2026

3 fonctionnalites

1. Progress Steps (SSE streaming)

Probleme : L'utilisateur attend 5-8s avec juste des "loading dots" sans savoir ce qui se passe.

Solution : Nouveau endpoint SSE qui emet des events de progression.

Backend (aiChat.ts) :

• Nouveau sendMessageStream() qui retourne un ReadableStream SSE
• Events emis a chaque etape :
  • {"step":"intent","detail":"Detection d'intent..."}
  • {"step":"intent_result","detail":"Haute confiance: Jellyfin (recherche)"}
  • {"step":"api_call","detail":"Appel API Jellyfin /Items?searchTerm=batman..."}
  • {"step":"api_result","detail":"2 resultats trouves"}
  • {"step":"formatting","detail":"Mise en forme des resultats..."}
  • {"step":"done","message":{...},"assistantMessage":{...}}
• Ou pour le fallback LLM :
  • {"step":"llm_call","detail":"Envoi au LLM (mistral:latest)..."}
  • {"step":"tool_call","detail":"Execution outil: fetch jellyfin..."}
  • {"step":"llm_format","detail":"Formatage de la reponse..."}
  • {"step":"done","message":{...}}

API (index.ts) :

• POST /api/ai/conversations/:id/messages → garde l'ancien comportement (retro-compatible)
• POST /api/ai/conversations/:id/messages/stream → SSE avec progress events

Frontend (ChatMessages.tsx) :

• Remplacer les "loading dots" par un indicateur de steps :

  AI
  [=====     ] Detection d'intent...
  [==========] Haute confiance: Jellyfin
  [===============] Appel API Jellyfin...
  [====================] 2 resultats, mise en forme...

• Utiliser EventSource ou fetch avec ReadableStream pour lire le SSE

Fichiers modifies :

2. Model Fallback (formatter)

Probleme : Mistral omet les URLs "par securite", genere du texte brut au lieu de markdown.

Solution : Si le formatter LLM produit un resultat sans URLs alors que les data en contenaient, retry avec un autre modele.

Implementation dans aiChat.ts :

• Apres le formatter call, verifier si le resultat contient des URLs (/player?, /api/stream/)
• Si les data originales avaient _playerUrl/_imageUrl mais le resultat LLM non → retry avec modele fallback
• Ordre de preference : conv.model → deepseek-r1:7b → llama3:latest
• Verifier les modeles disponibles au demarrage via listModels()

Fichiers modifies :

3. Deep Search (retry si 0 resultats)

Probleme : Si "cherche batman" ne trouve rien sur Jellyfin, l'utilisateur recoit "0 resultats" sans alternatives.

Solution : Retry automatique avec parametres elargis.

Implementation dans intentExecutor.ts :

• Si un fetch retourne 0 items → retry avec parametres elargis :
  1. Retirer includeItemTypes (chercher dans TOUT)
  2. Reduire le searchTerm (premier mot seulement)
  3. Si toujours 0 → essayer le candidat suivant (pour medium confidence)
• Max 2 retries

Fichiers modifies :

Ordre d'implementation

1. Progress Steps SSE (le plus visible pour l'UX)
2. Deep Search (amelioration resultats)
3. Model Fallback (polish)

Ce qui ne change PAS

• Endpoint POST /messages existant (retro-compatible)
• CRUD conversations
• Intent detection deterministe
• Logique classifier