NAiOSOmni Email

omnichat-emailv0.6.0

Afegeix un canal de correu electrònic (IMAP/SMTP) a NAiOSOmni. La teva safata apareix com un canal més dins de l'Inbox unificat, amb resposta automàtica IA, agents verticals i totes les capacitats de NAiOSOmni.

Inclòs a Bàsic i MAXComunicaciónemailimapsmtpomnichatchannelinboxNAiOS Team

Funcions

Versió

0.6.0

Llicència

MIT

Serveis

—

Descripció

Connector integrat a NAiOSOmni: registra un nou driver 'email-imap' al ChannelRegistry de NAiOSOmni perquè qualsevol compte IMAP/SMTP (Gmail amb contrasenya d'aplicació, IONOS, Outlook personal, corporatiu) es pugui connectar com a canal. Els correus entrants apareixen a l'Inbox unificat, agrupats per remitent (peer = adreça de correu). Les dades específiques del correu (subject, message-id, threading, cc/bcc, cos HTML, adjunts) es serialitzen a media_meta en JSON sense modificar l'esquema de NAiOSOmni. Les respostes s'envien per SMTP amb un threading correcte (In-Reply-To + Subject: Re:). El cos HTML es serveix amb «Veure original» des del publicRouter del mateix plugin (amb comprovació d'autenticació).

Funcionalitats (3)

Correu com a canal OmniChat

La teva safata IMAP apareix al costat de WhatsApp i Telegram a l'Inbox unificat.

IMAP/SMTP universal

Compatible amb Gmail (contrasenya d'aplicació), IONOS, Outlook personal i corporatiu. OAuth de Google/Microsoft a la fase 2.

Threading correcte

Les respostes mantenen In-Reply-To + Subject: Re: perquè el client del destinatari les enfili bé.

Changelog

v0.6.02026-05-11

FASE 10 · HUMAN-IN-THE-LOOP + integració d'eines RAG
MODE ESBORRANY — interruptor per canal a la pestanya General (només email-imap). Quan està activat, les respostes automàtiques IA NO s'envien: es desen amb status='draft' per revisar-les. Bombolla especial amb vora discontínua àmbar i 3 accions: Enviar (SMTP real ara) / Editar (carrega el text al compositor i descarta) / Descartar (neteja la BD i els fitxers). PATCH /channels/:id/draft-mode per activar/desactivar
Endpoints d'esborrany: GET /api/drafts/:msgId (obtenir per al compositor), POST /api/drafts/:msgId/send (promociona a enviament real), DELETE /api/drafts/:msgId (neteja amb esborrat dels adjunts al disc)
Renderitzador de la safata: detecta status='draft', mostra la capçalera 🤖 Esborrany IA pendent + bombolla amb estil diferent + fila d'accions amb 3 botons. Zero canvis als drivers de xat (WA/TG no emeten status='draft')
EINA search_inbox per als agents — registrada a TOOLS d'OmniChat mitjançant mutació de l'objecte exportat (zero canvis al nucli). Esquema OpenAI tool amb paràmetres {query, top_k}. ctx.invokePlugin delega al searchInbox() del plugin, que crida EmbeddingsStore. Els agents ara poden consultar la safata semànticament quan un client ho demana
Mètode públic searchInbox(args) al plugin: genera l'embedding de la consulta, executa una cerca de cosinus, retorna els top-K formatats per al LLM (sense buffers, puntuacions amb 2 decimals, fragment truncat)

v0.5.02026-05-11

FASE 9 · FUNCIONS D'IA PER AL CORREU — 4 funcions d'IA específiques per al correu
F-1 · TRIATGE AUTOMÀTIC — cada correu entrant és classificat per un LLM en {urgent, action, fyi, newsletter, spam} amb reason en ≤12 paraules. Insígnia de color a la bombolla de la safata (vermell/taronja/gris/blau/negre). Persistit a media_meta.triage
F-4 · ANTI-PHISHING IA — puntuació 0-1 calculada en la mateixa crida LLM que el triatge (eficient en tokens). Bàner amb severitat codificada sobre el missatge quan la puntuació és ≥ 0,5 (mitjà/alt/crític amb animació de pulsació). Factors de risc en castellà. Persistit a media_meta.phishing
F-5 · RAG SOBRE LA SAFATA — SQLite pròpia amb vectors Float32 empaquetats (1536 dimensions, ~6KB per correu). Indexa automàticament cada correu entrant no spam després de l'anàlisi. Endpoint POST /api/search amb embedding de la consulta + cosinus en JS. Resultats top-K amb peer/subject/snippet/score. Neteja integrada: esborra els embeddings dels canals eliminats
F-6 · TRES ESBORRANYS AUTOCOMPOSE — en obrir un fil de correu, fila de 3 xips sobre el compositor amb esborranys en tons formal/proper/breu. Clic → carrega el text al textarea. Memòria cau de 5 min per (canal+peer+last_inbound_id) per no tornar a gastar tokens en navegar entre pestanyes. Botó d'actualitzar per regenerar manualment
ENDPOINTS — POST /plugins/omnichat-email/api/search, POST /plugins/omnichat-email/api/drafts. Tots dos amb comprovació d'autenticació, limitats a l'usuari
UI/CSS — insígnies de triatge (5 colors), bàner de phishing (3 severitats amb pulsació), xips d'esborrany amb efecte d'elevació en passar el cursor. Tot condicionat al driver (només email-imap, WA/TG intactes)
Combinació LLM — triatge + phishing en una sola crida amb un prompt unificat → ~50% d'estalvi de tokens respecte a crides separades. Model: gpt-4o-mini per a classificació/esborranys, text-embedding-3-small per als vectors

v0.4.02026-05-11

FASE 8 · POLIT I ROBUSTESA — els 7 ítems completats
B-7 · Sanititzar el cos HTML del correu — allowedTags ampliat (style, font, center, table-layout, etc.) per preservar el format real dels correus. L'CSS inline no es filtra (parseStyleAttributes=false). charset utf-8 garantit mitjançant la capçalera HTTP i una meta inline
B-2 · Marca \Seen d'IMAP — driver.markAsRead(peerId) ara fa una cerca IMAP per From + STORE +FLAGS \Seen per a tots els UID no llegits del peer. L'endpoint /api/channels/:id/messages dispara markAsRead en mode fire-and-forget en servir el fil (agnòstic al driver, WA/TG no fan res)
B-6 · Healthcheck millorat — seguiment de la latència NOOP (finestra lliscant de 10 mostres), detecció de degradació (3 NOOP >5s consecutius → reconnexió preventiva), avís d'inactivitat (>6h sense entrants en horari laboral → log info)
B-1 · UI de quotes a la pestanya Anti-spam — targeta nova NOMÉS per als canals email-imap amb 3 camps (per_minute/hour/day), precarregats des de driver_config.quotas, PATCH /plugins/omnichat-email/channels/:cid/quotas amb límits raonables
B-5 · Cooldown de deduplicació de sortida — rebutja reenviar el mateix (peerId + body) dins de 60s. Hash SHA-1 en un mapa en memòria podat a la finestra. err.code DEDUP amb el temps des de l'enviament anterior
B-3 · Jobs de neteja d'orfes — cron diari (retard inicial de 60s) que escaneja data/bodies/<uid>/<cid>/ i uploads/users/<uid>/email-<cid>/ i elimina els directoris el canal email-imap dels quals ja no existeix a la BD. Abast a nivell de canal (orfes per missatge pendents)
B-4 · Mètriques dedicades — endpoint /plugins/omnichat-email/api/metrics (només admin/superadmin) amb canals totals/connectats, volum 24h/7d entrant/sortint, estalvi de filtre, errors SMTP, cops de quota, mida mitjana d'adjunts, principals remitents 7d, latència NOOP p50/p95 + ratxa lenta + últim entrant per canal actiu

v0.3.02026-05-11

FASE 7 · ENDURIMENT — enfortiment del driver per a producció real
QUOTES DE SORTIDA — valors per defecte 30/min · 200/hora · 1000/dia per canal, comptadors en memòria amb marques de temps podades a 24h. En excedir → throw amb err.code QUOTA_MINUTE/HOUR/DAY. Sobreescriptura per canal via driver_config.quotas. _recordSend() només compta després d'un èxit SMTP (les fallades no penalitzen)
HEALTHCHECK IMAP NOOP cada 5min — detecta IDLE mort silenciosament (timeout de NAT, reset del LB, caiguda al servidor). Si el NOOP falla → close → reconnexió via el backoff existent. S'inicia després de connect i s'atura en disconnect
PONT DE LOGS ESTRUCTURATS — el driver emet 'omnichat-email.log' al bus d'esdeveniments, el plugin ho reenvia a OmniChat.logService.log(). Categories: email-rx, email-tx, email-filter, email-quota, email-health. Esdeveniments detallats (subject, peer, uid, adjunts, smtp_code) visibles en temps real a la pestanya Log del canal
SANITITZACIÓ DE from_name — helper sanitizeFromName() elimina CR/LF/xevrons i limita a 80 caràcters. Aplicat a l'aparellament inicial i a la pàgina d'edició de connexió. Bloqueja la injecció de capçaleres SMTP
LÍMIT DE MIDA D'ADJUNTS — total de bytes bruts ≤ 24MB (SMTP màx. típic de 25MB amb sobrecàrrega base64 +33%). Suma amb fs.statSync abans d'enviar, falla netament amb err.code=ATTACHMENT_TOO_LARGE
LOG ESTRUCTURAT en totes les rutes de fallada — rebuigs SMTP (amb smtp_code si el dóna), quota excedida (code), adjunts massa grans (bytes), filtre de correu automàtic (reason), recepció/enviament amb èxit (metadades completes)

v0.2.02026-05-11

Canvi de nom — 'OmniChat Email' → 'NAiOSOmni Email' al manifest (l'id continua sent omnichat-email per compatibilitat)
APARELLAMENT (Fase 2) — validació real d'IMAP+SMTP amb imapflow + nodemailer.verify(), xifrat AES-256-GCM de les credencials amb secret-vault, sanititzacio (contrasenyes eliminades de driver_config)
RECEPCIÓ (Fase 3) — IMAP IDLE persistent, backfill inicial de 30 correus, seguiment de UIDVALIDITY + UIDNEXT, mailparser + sanitize-html, adjunts al disc, sanititzacio del cos HTML. Reconnexió amb backoff 5/10/30/60/120/300s
ENVIAMENT (Fase 4) — SMTP amb pool, threading correcte (In-Reply-To + References), 3 modes d'assumpte (Assumpte: explícit / Re: automàtic / sintètic de 60 caràcters), capçalera Auto-Submitted: auto-replied (anti-bucle activa)
VEURE ORIGINAL (Fase 5) — la ruta /plugins/omnichat-email/body/:cid/:mid serveix l'HTML sanititzat amb CSP estricte + capçaleres compatibles amb iframe, comprovació de propietat. Els adjunts reutilitzen /uploads/users/ existent de NAiOSOmni (zero codi nou d'autenticació)
ADJUNTS DE SORTIDA (Fase 6) — 1 correu = N adjunts en una única envoltura SMTP (en lloc de N correus com fan WA/TG). El driver accepta content.attachments[] del compositor i els mapa a nodemailer
MODE TÀCTIC DE CORREU — filtre d'entrada de correu automàtic (Auto-Submitted, Precedence bulk/list/junk, capçaleres List-*, X-Autoresponse, remitents màquina); supressió de notificacions de progrés de les eines (flag isProgress, ja no «📚 Consultant la KB…» per correu); sufix al system_prompt quan driver=email-imap per a un to adaptat al correu (una resposta, formal, sense emojis decoratius)
EDITAR CONNEXIÓ — pàgina pròpia /plugins/omnichat-email/channels/:cid/edit amb formulari precarregat (contrasenyes en blanc per seguretat), validació abans de desar, unload+load+connect en directe. «Tornar a vincular» del menú ⋮ redirigeix automàticament per als canals email-imap
UI DE LA SAFATA — el renderitzador ara dibuixa media_meta.attachments[] com a targetes (miniatures per a imatges, reproductors incrustats per a vídeo/àudio, icona+nom+mida per a PDF/Word/Excel/ZIP). Agnòstic al driver: qualsevol driver futur amb la mateixa estructura en pot treure partit
Modal 'Afegir contacte' conscient del driver — el text i la validació canvien segons el driver (correu vs telèfon vs chat_id de Telegram)
Pestanya 'Simulació' oculta per a email-imap (incompatible per disseny: màquina d'estats síncrona només de xat)
ERRORS — coerció BigInt per a uidValidity/uidNext/uid (imapflow >=1.3 les retorna com a BigInt → trencava JSON.stringify); _restoreOwnChannels per evitar 'driver not registered' en la carrera d'arrencada; sondeig de pluginLoader (no només setImmediate, hi ha awaits entre loadAll i app.set); CSS del padding del modal 'Afegir canal' (error preexistent)
TLS — flag tls_insecure per canal opcional per a servidors amb intercepció de certificats (Norton AV / proxies corporatius / certificats caducats). TLS estricte per defecte
Dependències — imapflow ^1.3.3, mailparser ^3.9.8, sanitize-html ^2.17.3 (nodemailer ja hi era)

v0.1.02026-05-08

Scaffold inicial — registre del driver 'email-imap' al ChannelRegistry d'OmniChat
Aparellament basat en formulari amb camps IMAP/SMTP (placeholder — la Fase 2 implementa la validació real)
Driver stub: connect/startPairing/sendMessage llancen 'not yet implemented' amb la fase pendent