Arquitectura — Comunicación de doble plano

OxideTerm separa los datos del terminal de los comandos de control en dos planos independientes:

┌─────────────────────────────────────┐
│        Frontend (React 19)          │
│  xterm.js 6 (WebGL) + 19 stores     │
└──────────┬──────────────┬───────────┘
           │ Tauri IPC    │ WebSocket (binario)
           │ (JSON)       │ puerto por sesión
┌──────────▼──────────────▼───────────┐
│         Backend (Rust)              │
│  NodeRouter → SshConnectionRegistry │
│  Wire Protocol v1                   │
│  [Type:1][Length:4][Payload:n]      │
└─────────────────────────────────────┘

• Plano de datos (WebSocket): cada sesión SSH obtiene su propio puerto WebSocket. Los bytes del terminal fluyen como tramas binarias con encabezado Type-Length-Payload — sin serialización JSON, sin codificación Base64, cero sobrecarga en la ruta crítica.
• Plano de control (Tauri IPC): gestión de conexiones, operaciones SFTP, reenvíos, configuración — JSON estructurado, pero fuera de la ruta crítica.
• Direccionamiento por nodo: el frontend nunca toca sessionId ni connectionId. Todo se direcciona mediante nodeId, resuelto atómicamente en el servidor por el NodeRouter. La reconexión SSH cambia el connectionId subyacente — pero SFTP, IDE y reenvíos no se ven afectados en absoluto.

🔩 SSH puro en Rust — russh 0.59

Toda la pila SSH es russh 0.59 compilada contra el backend criptográfico ring:

• Cero dependencias C/OpenSSL — toda la pila criptográfica es Rust. No más depuración de «¿qué versión de OpenSSL?».
• Protocolo SSH2 completo: intercambio de claves, canales, subsistema SFTP, reenvío de puertos
• Suites de cifrado ChaCha20-Poly1305 y AES-GCM, claves Ed25519/RSA/ECDSA
• AgentSigner personalizado: envuelve el SSH Agent del sistema e implementa el trait Signer de russh, resolviendo problemas de bounds Send RPITIT clonando &AgentIdentity a un valor propio antes de cruzar .await

pub struct AgentSigner { /* wraps system SSH Agent */ }
impl Signer for AgentSigner { /* challenge-response via Agent IPC */ }

• Soporte de plataforma: Unix (SSH_AUTH_SOCK), Windows (\\.\pipe\openssh-ssh-agent)
• Cadenas proxy: cada salto usa autenticación Agent de forma independiente
• Reconexión: AuthMethod::Agent se reproduce automáticamente

🔄 Reconexión inteligente con período de gracia

La mayoría de los clientes SSH destruyen todo al desconectarse y empiezan de nuevo. El orquestador de reconexión de OxideTerm adopta un enfoque fundamentalmente diferente:

1. Detección del timeout de heartbeat WebSocket (300 s, calibrado para macOS App Nap y throttling de timers JS)
2. Snapshot del estado completo: paneles del terminal, transferencias SFTP en curso, reenvíos de puertos activos, archivos IDE abiertos
3. Sondeo inteligente: eventos visibilitychange + online disparan keepalive SSH proactivo (~2 s de detección frente a 15–30 s de timeout pasivo)
4. Período de gracia (30 s): sondea la conexión SSH antigua vía keepalive — si se recupera (ej.: cambio de punto de acceso WiFi), tus aplicaciones TUI (vim, htop, yazi) sobreviven completamente intactas
5. Si la recuperación falla → nueva conexión SSH → restauración automática de reenvíos → reanudación de transferencias SFTP → reapertura de archivos IDE

Pipeline: queued → snapshot → grace-period → ssh-connect → await-terminal → restore-forwards → resume-transfers → restore-ide → verify → done

Toda la lógica se ejecuta a través de un ReconnectOrchestratorStore dedicado — cero código de reconexión disperso en hooks o componentes.

🛡️ Pool de conexiones SSH

SshConnectionRegistry con conteo de referencias respaldado por DashMap para acceso concurrente sin bloqueo:

• Una conexión, muchos consumidores: terminal, SFTP, reenvíos de puertos e IDE comparten una única conexión SSH física — sin handshakes TCP redundantes
• Máquina de estados por conexión: connecting → active → idle → link_down → reconnecting
• Gestión del ciclo de vida: timeout de inactividad configurable (5 min / 15 min / 30 min / 1 h / nunca), intervalo keepalive de 15 s, detección de fallos de heartbeat
• Heartbeat WsBridge: intervalo de 30 s, timeout de 5 min — tolera macOS App Nap y throttling JS del navegador
• Propagación en cascada: fallo del host de salto → todos los nodos siguientes marcados automáticamente como link_down con sincronización de estado
• Desconexión por inactividad: emite connection_status_changed al frontend (no solo node:state interno), previniendo desincronización de la interfaz

🤖 OxideSens AI

Asistente de IA centrado en la privacidad con dos modos de interacción:

• Panel inline (⌘I): comandos rápidos de terminal, salida inyectada vía bracketed paste
• Chat lateral: conversaciones persistentes con historial completo
• Contexto de workspace orientado a objetivos: ve conexiones guardadas, sesiones SSH activas, buffers de terminal, rutas SFTP, ajustes y entradas de la base de conocimiento como objetivos del workspace
• Acciones aprobadas: puede diagnosticar salida remota, ejecutar comandos aprobados, inspeccionar archivos y explicar fallos sin requerir una cuenta de OxideTerm
• Soporte MCP: conexión a servidores Model Context Protocol externos (stdio & SSE) para integración de herramientas de terceros
• Base de conocimiento RAG (v0.20): importa documentos Markdown/TXT en colecciones con alcance (global o por conexión). La búsqueda híbrida fusiona índice de palabras clave BM25 + similitud coseno vectorial vía Reciprocal Rank Fusion. Fragmentación compatible con Markdown que preserva la jerarquía de encabezados. Tokenizer de bigramas CJK para chino/japonés/coreano.
• Proveedores: OpenAI, Ollama, DeepSeek, OneAPI, o cualquier endpoint /v1/chat/completions
• Seguridad: claves API almacenadas en el llavero del SO; en macOS, la lectura de claves protegida por Touch ID vía LAContext — sin entitlements ni firma de código requeridos, en caché tras la primera autenticación por sesión

Reenvío de puertos — I/O sin bloqueo

Reenvío local (-L), remoto (-R) y dinámico SOCKS5 (-D) completo:

• Arquitectura por paso de mensajes: el canal SSH es propiedad de una única tarea ssh_io — sin Arc<Mutex<Channel>>, eliminando la contención mutex por completo
• Informe de fallos: las tareas de reenvío informan activamente la razón de salida (desconexión SSH, cierre de puerto remoto, timeout) para diagnósticos claros
• Restauración automática: los reenvíos Suspended se reanudan automáticamente en reconexión sin intervención del usuario
• Timeout de inactividad: FORWARD_IDLE_TIMEOUT (300 s) previene la acumulación de conexiones zombi

📦 trzsz — Transferencia de Archivos Integrada

Sube y descarga archivos directamente a través de la sesión SSH — sin conexión SFTP:

• Protocolo integrado: los archivos viajan como tramas Base64 dentro del flujo terminal existente — funciona de forma transparente a través de cadenas ProxyJump y tmux sin puertos ni agentes adicionales
• Bidireccional: el servidor ejecuta tsz <archivo> para enviar archivos al cliente; trz inicia la subida del cliente; compatible con arrastrar y soltar
• Soporte de directorios: transferencias recursivas mediante trz -d / tsz -d
• Límites de transferencia: límites configurables por sesión para tamaño de bloque, cantidad de archivos y bytes totales
• I/O nativo de Tauri: lecturas y escrituras de archivos mediante diálogos nativos de Tauri y Rust I/O — sin restricciones de memoria del navegador
• Notificaciones en vivo: notificaciones Toast para inicio, finalización, cancelación y errores — incluyendo un aviso cuando se detecta trzsz pero la función está desactivada
• Activar en Configuración → Terminal → Transferencia Integrada

🔌 Sistema de plugins en tiempo de ejecución

Carga ESM dinámica con una superficie API congelada y reforzada en seguridad:

• API PluginContext: 18 espacios de nombres — terminal, ui, commands, settings, lifecycle, events, storage, system
• 24 componentes UI Kit: componentes React preconstruidos (botones, campos de entrada, diálogos, tablas…) inyectados en sandboxes de plugins vía window.__OXIDE__
• Membrana de seguridad: Object.freeze en todos los objetos de contexto, ACL basada en Proxy, lista blanca IPC, disyuntor con desactivación automática tras errores repetidos
• Módulos compartidos: React, ReactDOM, zustand, lucide-react expuestos para uso de plugins sin duplicar bundles

⚡ Renderizado adaptativo

Planificador de renderizado de tres niveles que reemplaza el batching fijo de requestAnimationFrame:

Las transiciones son completamente automáticas — impulsadas por el volumen de datos, la entrada del usuario y la API Page Visibility. Las pestañas en segundo plano siguen vaciando datos vía timer de inactividad sin despertar RAF.

🔐 Exportación cifrada .oxide

Respaldo de conexión portátil e inviolable:

• Cifrado autenticado ChaCha20-Poly1305 AEAD
• KDF Argon2id: coste de memoria de 256 MB, 4 iteraciones — resistente a fuerza bruta GPU
• Suma de verificación de integridad SHA-256
• Incrustación opcional de claves: claves privadas codificadas en base64 en la carga útil cifrada
• Análisis previo: desglose de tipos de autenticación, detección de claves faltantes antes de la exportación

📡 ProxyJump — Multi-salto con consciencia topológica

• Profundidad de cadena ilimitada: Cliente → Salto A → Salto B → … → Destino
• Análisis automático de ~/.ssh/config, construcción del grafo topológico, algoritmo de Dijkstra para la ruta óptima
• Nodos de salto reutilizables como sesiones independientes
• Propagación de fallos en cascada: host de salto caído → todos los nodos siguientes marcados automáticamente como link_down

⚙️ Terminal local — PTY thread-safe

Shell local multiplataforma vía portable-pty 0.8, protegido por feature gate local-terminal:

• MasterPty envuelto en std::sync::Mutex — hilos de E/S dedicados mantienen las lecturas PTY bloqueantes fuera del bucle de eventos de Tokio
• Detección automática de shell: zsh, bash, fish, pwsh, Git Bash, WSL2
• cargo build --no-default-features elimina PTY para builds móviles/ligeros

🪟 Optimización Windows

• ConPTY nativo: invoca directamente la API Windows Pseudo Console — soporte completo TrueColor y ANSI, sin WinPTY obsoleto
• Escáner de shells: detecta automáticamente PowerShell 7, Git Bash, WSL2, CMD vía Registro y PATH

Y más

• Modo IDE: CodeMirror 6 vía SFTP, 24 lenguajes, árbol de archivos con estado Git, multi-pestaña, resolución de conflictos — agente remoto opcional (~1 MB) para funcionalidades mejoradas en Linux
• Perfilador de recursos: CPU/memoria/red en vivo vía canal SSH persistente leyendo /proc/stat, cálculo basado en deltas, degradación automática a solo RTT en sistemas no Linux
• Motor de temas personalizado: 30+ temas integrados, editor visual con vista previa en vivo, 20 campos xterm.js + 24 variables de color UI, derivación automática de colores UI desde la paleta del terminal
• Grabación de sesiones: formato asciicast v2, grabación y reproducción completas
• Difusión de entrada: escribe una vez, envía a todos los paneles divididos — operaciones de servidor por lotes
• Galería de fondos: imágenes de fondo por pestaña, 16 tipos de pestañas, control de opacidad/desenfoque/ajuste
• Companion CLI (oxt): binario de ~1 MB, JSON-RPC 2.0 vía Unix Socket / Named Pipe, status/health/list/forward/config/connect/focus/attach/SFTP/import/AI con salida legible o --json
• WSL Graphics ⚠️ experimental: visor VNC integrado — 9 entornos de escritorio + modo aplicación única, detección WSLg, Xtigervnc + noVNC