NAiOSOmni Email

omnichat-emailv0.6.0

Engade un canal de email (IMAP/SMTP) a NAiOSOmni. A túa caixa de correo aparece como un canal máis dentro do Inbox unificado, con resposta automática por IA, axentes verticais e todas as capacidades de NAiOSOmni.

Incluído en Básico e MAXComunicaciónemailimapsmtpomnichatchannelinboxNAiOS Team

Funcións

Versión

0.6.0

Licenza

MIT

Servizos

—

Descrición

Plugin acoplado a NAiOSOmni: rexistra un novo driver 'email-imap' no ChannelRegistry de NAiOSOmni para que calquera conta IMAP/SMTP (Gmail con contrasinal de aplicación, IONOS, Outlook persoal, corporativo) poida conectarse como canal. Os emails entrantes aparecen no Inbox unificado, agrupados por remitente (peer = enderezo de email). Os elementos específicos do email (subject, message-id, threading, cc/bcc, corpo HTML, attachments) serialízanse en media_meta JSON sen modificar o esquema de NAiOSOmni. As respostas envíanse por SMTP con threading correcto (In-Reply-To + Subject: Re:). O corpo HTML sírvese mediante 'ver orixinal' desde o publicRouter do propio plugin (con comprobación de autenticación).

Funcionalidades (3)

Email como canal OmniChat

A túa bandexa IMAP aparece xunto a WhatsApp e Telegram no Inbox unificado.

IMAP/SMTP universal

Compatible con Gmail (contrasinal de aplicación), IONOS, Outlook persoal e corporativo. OAuth de Google/Microsoft na fase 2.

Threading correcto

As respostas mantén In-Reply-To + Subject: Re: para que o cliente do destinatario as enlace ben.

Changelog

v0.6.02026-05-11

FASE 10 · HUMAN-IN-THE-LOOP + integración de ferramentas RAG
MODO BORRADOR — interruptor por canal na pestana Xeral (só email-imap). Cando está activado, as respostas automáticas da IA NON se envían: gárdanse con status='draft' para revisión. Burbulla especial con borde discontinuo ámbar e 3 accións: Enviar (SMTP real agora) / Editar (carga o texto no compositor e descarta o borrador) / Descartar (limpa a BD e os ficheiros). PATCH /channels/:id/draft-mode para activar/desactivar
Endpoints de borradores: GET /api/drafts/:msgId (obtén o borrador para o compositor), POST /api/drafts/:msgId/send (promóveo a envío real), DELETE /api/drafts/:msgId (limpa con borrado dos adxuntos no disco)
Renderizador do inbox: detecta status='draft', mostra cabeceira 🤖 Borrador IA pendente + burbulla con estilo distinto + fila de accións con 3 botóns. Cero cambios nos drivers de chat (WA/TG non emiten status='draft')
FERRAMENTA search_inbox para axentes — rexistrada en TOOLS de OmniChat mediante mutación do obxecto exportado (cero cambios no core). Esquema OpenAI tool con parámetros {query, top_k}. ctx.invokePlugin delega no método searchInbox() do plugin, que chama ao EmbeddingsStore. Os axentes poden agora consultar o inbox de forma semántica cando un cliente o pide
Método público searchInbox(args) no plugin: xera o embedding da consulta, executa a busca por similitude coseno e devolve os top-K formateados para o LLM (sen buffers, puntuacións con 2 decimais, fragmento truncado)

v0.5.02026-05-11

FASE 9 · FUNCIÓNS DE IA PARA EMAIL — 4 funcións de IA específicas para email
F-1 · TRIAXE AUTOMÁTICO — cada email entrante é clasificado por LLM en {urgent, action, fyi, newsletter, spam} con motivo en ≤12 palabras. Insignia de cor na burbulla do inbox (vermello/laranxa/gris/azul/negro). Persistido en media_meta.triage
F-4 · ANTI-PHISHING IA — puntuación 0-1 calculada na mesma chamada ao LLM que o triaxe (eficiente en tokens). Aviso con código de severidade sobre a mensaxe cando a puntuación é ≥ 0.5 (medio/alto/crítico con animación de pulso). Factores de risco en español. Persistido en media_meta.phishing
F-5 · RAG SOBRE A CAIXA — SQLite propia con vectores Float32 empaquetados (1536 dimensións, ~6KB/email). Indexa automaticamente cada email entrante que non sexa spam despois da análise. Endpoint POST /api/search con embedding da consulta e similitude coseno en JS. Resultados top-K con peer/subject/fragmento/puntuación. Limpeza integrada: borra os embeddings dos canais eliminados
F-6 · TRES BORRADORES AUTOCOMPOSE — ao abrir un fío de email, fila de 3 chips enriba do compositor cos borradores en tons formal/próximo/breve. Ao facer clic, carga o texto no textarea. Caché de 5 min por (canal+peer+last_inbound_id) para non gastar tokens de novo ao navegar entre pestanas. Botón de actualizar para regenerar manualmente
ENDPOINTS — POST /plugins/omnichat-email/api/search, POST /plugins/omnichat-email/api/drafts. Ambos con comprobación de autenticación e limitados ao usuario
UI/CSS — insignias de triaxe (5 cores), aviso de phishing (3 severidades con pulso), chips de borrador con efecto de elevación ao pasar o cursor. Todo condicionado ao driver (só email-imap, WA/TG sen cambios)
Combinación de LLM — triaxe + phishing nunha soa chamada con prompt unificado → aforro de ~50% en tokens fronte a chamadas separadas. Modelo: gpt-4o-mini para clasificación/borradores, text-embedding-3-small para vectores

v0.4.02026-05-11

FASE 8 · PULIDO E ROBUSTEZ — os 7 elementos completos
B-7 · Sanitización do corpo HTML do email — allowedTags ampliados (style, font, center, table-layout, etc.) para preservar o formato real dos emails. O CSS inline non se filtra (parseStyleAttributes=false). charset utf-8 garantido mediante cabeceira HTTP + meta inline
B-2 · Flag IMAP \Seen — driver.markAsRead(peerId) agora fai unha busca IMAP por From + STORE +FLAGS \Seen para todos os UIDs sen ler do peer. O endpoint /api/channels/:id/messages dispara markAsRead fire-and-forget ao servir o fío (independente do driver; WA/TG non fan nada)
B-6 · Healthcheck enriquecido — seguimento da latencia NOOP (ventá deslizante de 10 mostras), detección de degradación (3 NOOPs >5s consecutivos → reconexión preventiva), aviso de inactividade (>6h sen entrada en horario laboral → log info)
B-1 · Interface de cuotas na pestana Anti-spam — tarxeta nova SOLO para canais email-imap con 3 campos (per_minute/hour/day), precargados desde driver_config.quotas, PATCH /plugins/omnichat-email/channels/:cid/quotas con límites razoables
B-5 · Cooldown de deduplicación de saída — rexeita o reenvío do mesmo (peerId + corpo) dentro de 60s. Hash SHA-1 nun mapa en memoria podado á ventá. err.code DEDUP co tempo desde o envío anterior
B-3 · Tarefas de limpeza de órfos — cron diario (atraso inicial de 60s) que escanea data/bodies/<uid>/<cid>/ e uploads/users/<uid>/email-<cid>/ e elimina os directorios cuxo canal email-imap xa non existe na BD. Alcance a nivel de canal (órfos por mensaxe, pendentes)
B-4 · Métricas dedicadas — endpoint /plugins/omnichat-email/api/metrics (só admin/superadmin) con canais totais/conectados, volume 24h/7d de entrada/saída, aforro de filtros, erros SMTP, acertos de cuota, tamaño medio dos adxuntos, principais remitentes de 7d, latencia NOOP p50/p95, racha lenta e última entrada por canal activo

v0.3.02026-05-11

FASE 7 · ENDURECEMENTO — reforzo do driver para produción real
CUOTAS DE SAÍDA — valores por defecto 30/min · 200/hora · 1000/día por canal, contadores en memoria con marcas de tempo podadas a 24h. Ao superar o límite lanza erro con err.code QUOTA_MINUTE/HOUR/DAY. Substitución por canal mediante driver_config.quotas. _recordSend() só conta tras éxito SMTP (os fallos non penalizan)
HEALTHCHECK IMAP NOOP cada 5 min — detecta IDLE morto silenciosamente (timeout de NAT, reset do balanceador, caída no servidor). Se o NOOP falla → close → reconexión mediante o backoff existente. Iníciase tras a conexión e páraa ao desconectar
PUENTE DE LOGS ESTRUTURADOS — o driver emite 'omnichat-email.log' no bus de eventos e o plugin reenvíao a OmniChat.logService.log(). Categorías: email-rx, email-tx, email-filter, email-quota, email-health. Eventos detallados (subject, peer, uid, adxuntos, smtp_code) visibles en tempo real na pestana Log do canal
SANITIZACIÓN de from_name — función auxiliar sanitizeFromName() que elimina CR/LF/ángulos e limita a 80 caracteres. Aplicada no emparellamento inicial e na páxina de edición de conexión. Bloquea a inxección de cabeceiras SMTP
LÍMITE DE TAMAÑO DE ADXUNTOS — bytes brutos totais ≤ 24MB (SMTP máx. típico de 25MB con sobrecarga base64 +33%). Suma previa con fs.statSync antes de enviar; falla limpiamente con err.code=ATTACHMENT_TOO_LARGE
LOG ESTRUTURADO en todos os camiños de fallo — rexeitamentos SMTP (con smtp_code se o devolve), cuota excedida (code), adxuntos demasiado grandes (bytes), filtro de correo automático (reason), recepción/envío exitoso (metadatos completos)

v0.2.02026-05-11

Renomeado — 'OmniChat Email' → 'NAiOSOmni Email' no manifest (o id segue sendo omnichat-email por compatibilidade)
EMPARELLAMENTO (Fase 2) — validación real de IMAP+SMTP con imapflow + nodemailer.verify(), cifrado AES-256-GCM das credenciais con secret-vault, sanitización (contrasinais eliminados de driver_config)
RECEPCIÓN (Fase 3) — IMAP IDLE persistente, backfill inicial de 30 emails, seguimento de UIDVALIDITY + UIDNEXT, mailparser + sanitize-html, adxuntos gardados no disco, sanitización do corpo HTML. Reconexión con backoff de 5/10/30/60/120/300s
ENVÍO (Fase 4) — SMTP con pool, threading correcto (In-Reply-To + References), 3 modos de asunto (Asunto: explícito / Re: automático / sintético de 60 caracteres), cabeceira Auto-Submitted: auto-replied (anti-bucle activo)
VER ORIXINAL (Fase 5) — a ruta /plugins/omnichat-email/body/:cid/:mid serve o HTML sanitizado con CSP estrito e cabeceiras compatibles con iframe, con comprobación de propiedade. Os adxuntos reutilizan o /uploads/users/ existente de NAiOSOmni (cero código novo de autenticación)
ADXUNTOS SALIENTES (Fase 6) — 1 email = N adxuntos nun único envelope SMTP (en lugar de N emails como fan WA/TG). O driver acepta content.attachments[] do compositor e mapéaos a nodemailer
MODO TÁCTICO DE EMAIL — filtro de entrada para correo automático (Auto-Submitted, Precedence bulk/list/junk, cabeceiras List-*, X-Autoresponse, remitentes máquina); supresión de notificacións de progreso das ferramentas (flag isProgress, xa non aparece '📚 Consultando KB…' por email); sufixo no system_prompt cando driver=email-imap para un ton consciente do email (unha resposta, formal, sen emojis decorativos)
EDITAR CONEXIÓN — páxina propia /plugins/omnichat-email/channels/:cid/edit con formulario preenchido (contrasinais en branco por seguridade), validación antes de gardar, unload+load+connect en directo. 'Re-vincular' do menú ⋮ redirixe automaticamente para os canais email-imap
INTERFACE DO INBOX — o renderizador agora debuxa media_meta.attachments[] como tarxetas (miniaturas para imaxes, reprodutores en liña para vídeo/audio, icona+nome+tamaño para PDF/Word/Excel/ZIP). Independente do driver: calquera driver futuro co mesmo formato benefícase
Modal 'Engadir contacto' consciente do driver — o texto e a validación cambian segundo o driver (email vs teléfono vs chat_id de Telegram)
Pestana 'Simulación' oculta para email-imap (incompatible por deseño: máquina de estados síncrona só para chat)
ERROS — coerción de BigInt para uidValidity/uidNext/uid (imapflow >=1.3 devólveos como BigInt e rompía JSON.stringify); _restoreOwnChannels para evitar 'driver not registered' en condición de carreira no arranque; sondaxe de pluginLoader (non só setImmediate, hai awaits entre loadAll e app.set); padding CSS do modal 'Engadir canal' (erro preexistente)
TLS — flag tls_insecure por canal opcional para servidores con interceptación de certificados (Norton AV / proxies corporativos / certificados caducados). TLS estrito por defecto
Dependencias — imapflow ^1.3.3, mailparser ^3.9.8, sanitize-html ^2.17.3 (nodemailer xa estaba)

v0.1.02026-05-08

Andamio inicial — rexistro do driver 'email-imap' no ChannelRegistry de OmniChat
Emparellamento baseado en formulario con campos IMAP/SMTP (marcador de posición — a Fase 2 implementa a validación real)
Driver stub: connect/startPairing/sendMessage lanzan 'not yet implemented' coa fase pendente