NAiOSOmni Email

omnichat-emailv0.6.0

Ajoute un canal email (IMAP/SMTP) à NAiOSOmni. Votre boîte apparaît comme un canal supplémentaire dans l'Inbox unifié, avec réponse automatique IA, agents verticaux et toutes les capacités de NAiOSOmni.

Inclus dans Basique et MAXComunicaciónemailimapsmtpomnichatchannelinboxNAiOS Team

Fonctions

Version

0.6.0

Licence

MIT

Services

—

Description

Plugin intégré à NAiOSOmni : enregistre un nouveau driver 'email-imap' dans le ChannelRegistry de NAiOSOmni afin que tout compte IMAP/SMTP (Gmail avec mot de passe d'application, IONOS, Outlook personnel, professionnel) puisse être branché comme canal. Les emails entrants apparaissent dans l'Inbox unifié, regroupés par expéditeur (peer = adresse email). Les éléments propres à l'email (subject, message-id, threading, cc/bcc, corps HTML, attachments) sont sérialisés dans media_meta au format JSON sans modifier le schéma de NAiOSOmni. Les réponses sont envoyées par SMTP avec un threading correct (In-Reply-To + Subject: Re:). Le corps HTML est servi via « voir l'original » depuis le publicRouter du plugin (authentification vérifiée).

Fonctionnalités (3)

Email comme canal OmniChat

Votre boîte IMAP apparaît à côté de WhatsApp et Telegram dans l'Inbox unifié.

IMAP/SMTP universel

Compatible avec Gmail (mot de passe d'application), IONOS, Outlook personnel et professionnel. OAuth Google/Microsoft en phase 2.

Threading correct

Les réponses conservent In-Reply-To + Subject: Re: afin que le client du destinataire les regroupe correctement.

Changelog

v0.6.02026-05-11

PHASE 10 · HUMAN-IN-THE-LOOP + intégration d'outils RAG
MODE BROUILLON — bascule par canal dans l'onglet Général (email-imap uniquement). Lorsqu'il est activé, les auto-réponses IA ne sont PAS envoyées : elles sont enregistrées avec status='draft' pour relecture. Bulle spéciale avec bordure en pointillés ambre + 3 actions : Envoyer (SMTP réel maintenant) / Modifier (charge le texte dans le composeur + supprime le brouillon) / Supprimer (nettoie la BD + les fichiers). PATCH /channels/:id/draft-mode pour activer/désactiver
Endpoints brouillon : GET /api/drafts/:msgId (récupération pour le composeur), POST /api/drafts/:msgId/send (promeut en envoi réel), DELETE /api/drafts/:msgId (nettoie avec suppression des pièces jointes sur le disque)
Rendu de l'inbox : détecte status='draft', affiche l'en-tête 🤖 Brouillon IA en attente + bulle au style distinct + ligne d'actions avec 3 boutons. Aucun changement pour les drivers de chat (WA/TG n'émettent pas status='draft')
OUTIL search_inbox pour les agents — enregistré dans TOOLS d'OmniChat par mutation de l'objet exporté (aucun changement dans le cœur). Schéma d'outil OpenAI avec les paramètres {query, top_k}. ctx.invokePlugin délègue à la méthode searchInbox() du plugin, qui appelle EmbeddingsStore. Les agents peuvent désormais interroger l'inbox sémantiquement lorsqu'un client le demande
Méthode publique searchInbox(args) dans le plugin : génère l'embedding de la requête, exécute une recherche par similarité cosinus, renvoie le top-K formaté pour le LLM (sans buffers, scores à 2 décimales, extrait tronqué)

v0.5.02026-05-11

PHASE 9 · FONCTIONNALITÉS IA EMAIL — 4 fonctionnalités d'IA spécifiques à l'email
F-1 · TRI AUTOMATIQUE — chaque email entrant est classé par LLM en {urgent, action, fyi, newsletter, spam} avec une raison en ≤12 mots. Badge coloré sur la bulle de l'inbox (rouge/orange/gris/bleu/noir). Persisté dans media_meta.triage
F-4 · ANTI-HAMEONNAGE IA (anti-phishing) — score de 0 à 1 calculé dans le même appel LLM que le tri (économe en tokens). Bannière selon la gravité au-dessus du message lorsque score ≥ 0,5 (moyen/élevé/critique avec animation pulsante). Facteurs de risque en espagnol. Persisté dans media_meta.phishing
F-5 · RAG SUR LA BOÎTE — SQLite dédiée avec vecteurs Float32 compressés (1536 dimensions, ~6 Ko par email). Indexe automatiquement chaque email entrant non spam après analyse. Endpoint POST /api/search avec l'embedding de la requête + cosinus en JS. Résultats top-K avec peer/subject/extrait/score. Nettoyage intégré : supprime les embeddings des canaux supprimés
F-6 · TROIS BROUILLONS AUTO-RÉDIGÉS — à l'ouverture d'un fil email, une rangée de 3 puces au-dessus du composeur avec des brouillons aux tons formel/proche/bref. Clic → charge le texte dans la zone de saisie. Cache de 5 min par (canal+peer+last_inbound_id) pour ne pas redépenser des tokens lors de la navigation entre onglets. Bouton d'actualisation pour régénérer manuellement
ENDPOINTS — POST /plugins/omnichat-email/api/search, POST /plugins/omnichat-email/api/drafts. Tous deux avec vérification d'authentification et limités à l'utilisateur
UI/CSS — badges de tri (5 couleurs), bannière anti-phishing (3 niveaux avec pulsation), puces de brouillon avec effet de surélévation au survol. Le tout conditionné au driver (email-imap uniquement, WA/TG intacts)
Combinaison LLM — tri + phishing en un seul appel avec un prompt unifié → environ 50 % d'économie de tokens par rapport à des appels séparés. Modèles : gpt-4o-mini pour la classification/les brouillons, text-embedding-3-small pour les vecteurs

v0.4.02026-05-11

PHASE 8 · FINITION & ROBUSTESSE — les 7 éléments complets
B-7 · Assainissement du corps HTML des emails — allowedTags étendus (style, font, center, table-layout, etc.) pour préserver la mise en forme réelle des emails. Le CSS inline n'est pas filtré (parseStyleAttributes=false). charset utf-8 garanti via l'en-tête HTTP et la balise meta inline
B-2 · Indicateur IMAP \Seen — driver.markAsRead(peerId) effectue désormais une recherche IMAP par From + STORE +FLAGS \Seen pour tous les UID non lus du peer. L'endpoint /api/channels/:id/messages déclenche markAsRead en fire-and-forget à l'affichage du fil (indépendant du driver, WA/TG sont sans effet)
B-6 · Healthcheck enrichi — suivi de la latence NOOP (fenêtre glissante de 10 échantillons), détection de dégradation (3 NOOP > 5 s consécutifs → reconnexion préventive), alerte d'inactivité (> 6 h sans message entrant pendant les heures ouvrées → log info)
B-1 · Interface des quotas dans l'onglet Anti-spam — nouvelle carte UNIQUEMENT pour les canaux email-imap avec 3 champs (par minute/heure/jour), pré-remplis depuis driver_config.quotas, PATCH /plugins/omnichat-email/channels/:cid/quotas avec des bornes raisonnables
B-5 · Délai de carence de l'envoi sortant (anti-doublon) — refuse le renvoi du même (peerId + corps) dans les 60 s. Hash SHA-1 dans une map en mémoire élaguée à la fenêtre. err.code DEDUP avec le temps écoulé depuis l'envoi précédent
B-3 · Tâches de nettoyage des orphelins — cron quotidien (délai initial de 60 s) qui parcourt data/bodies/<uid>/<cid>/ et uploads/users/<uid>/email-<cid>/ et supprime les dossiers dont le canal email-imap n'existe plus en BD. Périmètre au niveau du canal (orphelins par message reportés)
B-4 · Métriques dédiées — endpoint /plugins/omnichat-email/api/metrics (réservé aux admins/superadmins) avec canaux totaux/connectés, volume entrant/sortant sur 24 h/7 j, économies de filtrage, erreurs SMTP, dépassements de quotas, taille moyenne des pièces jointes, principaux expéditeurs sur 7 j, latence NOOP p50/p95, série de lenteurs et dernier message entrant par canal actif

v0.3.02026-05-11

PHASE 7 · DURCISSEMENT — renforcement du driver pour une production réelle
QUOTAS SORTANTS — valeurs par défaut 30/min · 200/heure · 1000/jour par canal, compteurs en mémoire avec horodatages élagués à 24 h. Dépassement → throw avec err.code QUOTA_MINUTE/HOUR/DAY. Redéfinition par canal via driver_config.quotas. _recordSend() ne compte qu'après un succès SMTP (les échecs ne pénalisent pas)
HEALTHCHECK IMAP NOOP toutes les 5 min — détecte silencieusement un IDLE mort (timeout NAT, reset de load balancer, coupure côté serveur). NOOP échoue → close → reconnexion via le backoff existant. Démarré après connect, arrêté au disconnect
PONT DE LOGS STRUCTURÉS — le driver émet 'omnichat-email.log' sur le bus d'événements, le plugin le transmet à OmniChat.logService.log(). Catégories : email-rx, email-tx, email-filter, email-quota, email-health. Événements détaillés (subject, peer, uid, attachments, smtp_code) visibles en temps réel dans l'onglet Log du canal
ASSAINISSEMENT de from_name — helper sanitizeFromName() qui retire CR/LF/chevrons et limite à 80 caractères. Appliqué à l'appairage initial et à la page de modification de connexion. Bloque l'injection d'en-têtes SMTP
LIMITE DE TAILLE DES PIÈCES JOINTES — total brut ≤ 24 Mo (SMTP max typique de 25 Mo avec le surcoût base64 de +33 %). Somme fs.statSync avant envoi, échoue proprement avec err.code=ATTACHMENT_TOO_LARGE
LOGS STRUCTURÉS sur tous les chemins d'échec — rejets SMTP (avec smtp_code si fourni), quota dépassé (code), pièces jointes trop volumineuses (octets), filtre de mail automatique (raison), réception/envoi réussi (métadonnées complètes)

v0.2.02026-05-11

Renommage — 'OmniChat Email' → 'NAiOSOmni Email' dans le manifest (l'id reste omnichat-email par compatibilité)
APPAIRAGE (phase 2) — validation réelle IMAP+SMTP avec imapflow + nodemailer.verify(), chiffrement AES-256-GCM des identifiants via secret-vault, assainissement (mots de passe retirés de driver_config)
RÉCEPTION (phase 3) — IMAP IDLE persistant, reprise initiale de 30 emails, suivi UIDVALIDITY + UIDNEXT, mailparser + sanitize-html, pièces jointes sur disque, assainissement du corps HTML. Reconnexion avec backoff 5/10/30/60/120/300 s
ENVOI (phase 4) — SMTP avec pool, threading correct (In-Reply-To + References), 3 modes d'objet (Objet : explicite / Re : automatique / synthétique 60 caractères), en-tête Auto-Submitted: auto-replied (anti-boucle actif)
VOIR L'ORIGINAL (phase 5) — la route /plugins/omnichat-email/body/:cid/:mid sert le HTML assaini avec une CSP stricte et des en-têtes compatibles iframe, avec vérification de propriété. Les pièces jointes réutilisent /uploads/users/ existant de NAiOSOmni (aucun nouveau code d'authentification)
PIÈCES JOINTES SORTANTES (phase 6) — 1 email = N pièces jointes dans une seule enveloppe SMTP (au lieu de N emails comme le font WA/TG). Le driver accepte content.attachments[] du composeur et les mappe vers nodemailer
MODE TACTIQUE EMAIL — filtre des mails automatiques entrants (Auto-Submitted, Precedence bulk/list/junk, en-têtes List-*, X-Autoresponse, expéditeurs machines) ; suppression des notifications de progression des outils (indicateur isProgress, plus de « 📚 Consultation de la base… » par email) ; suffixe ajouté au system_prompt lorsque driver=email-imap pour un ton adapté à l'email (une seule réponse, formelle, sans emojis décoratifs)
MODIFIER LA CONNEXION — page dédiée /plugins/omnichat-email/channels/:cid/edit avec formulaire pré-rempli (mots de passe vides par sécurité), validation avant enregistrement, unload+load+connect en direct. « Relier à nouveau » du menu ⋮ redirige automatiquement pour les canaux email-imap
UI INBOX — le rendu affiche désormais media_meta.attachments[] sous forme de cartes (miniatures pour les images, lecteurs intégrés pour vidéo/audio, icône+nom+taille pour PDF/Word/Excel/ZIP). Indépendant du driver : tout futur driver au même format en bénéficie
Modal « Ajouter un contact » adapté au driver — texte et validation changent selon le driver (email vs téléphone vs chat_id Telegram)
Onglet « Simulation » masqué pour email-imap (incompatible par conception : machine à états synchrone réservée au chat)
BUGS — coercition BigInt pour uidValidity/uidNext/uid (imapflow >=1.3 les renvoie en BigInt → cassait JSON.stringify) ; _restoreOwnChannels pour éviter « driver not registered » lors de la course au démarrage ; polling de pluginLoader (pas seulement setImmediate, il existe des await entre loadAll et app.set) ; CSS du padding du modal « Ajouter un canal » (bug préexistant)
TLS — option tls_insecure par canal pour les serveurs avec interception de certificat (Norton AV / proxys d'entreprise / certificats expirés). TLS strict par défaut
Dépendances — imapflow ^1.3.3, mailparser ^3.9.8, sanitize-html ^2.17.3 (nodemailer était déjà présent)

v0.1.02026-05-08

Scaffold initial — enregistrement du driver 'email-imap' dans le ChannelRegistry d'OmniChat
Appairage par formulaire avec champs IMAP/SMTP (espace réservé — la phase 2 implémente la validation réelle)
Driver stub : connect/startPairing/sendMessage lèvent 'not yet implemented' avec la phase en attente