Architecture

Vue d'ensemble

WeeAgent et ses connecteurs forment un systeme d'assistant IA complet : un chat en streaming, une boucle agentique a outils, un mode vocal, et un catalogue de connecteurs exposes de trois facons (agent, Public API, MCP).

1Navigateur (React)
2  WeeAgentDock (chat streaming)        VoicePanel (boule, STT/TTS)
3        |                                    |
4        v  SSE                               v
5  edge: weeagent  --> OpenRouter       weeagent-tts (ElevenLabs)
6        |  boucle agent: action -> observation   weeagent-transcribe (Groq)
7        v
8  AppBridge (donnees de l'app hote)   +   Connecteurs
9        |                                  |
10        v                                  v
11  ouvrir/mettre a jour  (curseur)     weeagent-connectors --> APIs FR / Pappers
12                                      public-api /v1/connectors/*  (meme module _shared)
13                                      mcp-server (outils fr_*)
14                                      ms-graph --> Microsoft Graph (Outlook / OneDrive)

Capacites

• Chat en streaming (SSE, format OpenAI) via OpenRouter, avec repli mock sans cle.
• Boucle agentique : l'agent appelle des outils, se rend sur un enregistrement (curseur anime), le complete, resume.
• Mode vocal : boule reactive, reconnaissance (Groq/Whisper ou navigateur), synthese (ElevenLabs ou navigateur), accueil quotidien.
• Connecteurs : APIs publiques FR gratuites, Pappers (a cle), Microsoft 365 (OAuth : Outlook + OneDrive).
• Trois expositions du meme code : outils WeeAgent, Public API, serveur MCP.

Edge functions

• weeagent — chat streaming (proxy OpenRouter, repli mock).
• weeagent-tts / weeagent-transcribe / weeagent-config — voix (ElevenLabs / Groq) + capacites.
• weeagent-connectors — connecteurs FR pour l'agent (JWT).
• public-api (/v1/connectors/) + `mcp-server` (outils fr_) — memes connecteurs, autres canaux.
• ms-oauth-start / ms-oauth-callback / ms-graph — OAuth Microsoft + proxy Graph.

Securite

• Toutes les fonctions exigent un JWT Supabase ; les secrets (OpenRouter, Groq, ElevenLabs, Microsoft) restent cote serveur.
• Jetons OAuth chiffres au repos (AES-GCM) ; table oauth_connections en RLS sans policy + RPC SECURITY DEFINER.
• Connecteurs en lecture seule cote MCP ; le flow OAuth utilise un state signe (HMAC).
• Replis sans cle : le kit tourne des l'installation, on active les fournisseurs au fur et a mesure.

Pour aller plus loin

• WeeAgent : Installation, Wire it to your data, Voice mode.
• Connecteurs : vue d'ensemble, Public API, MCP tools, Microsoft 365, Catalog & roadmap.