CLI / TUI / Web

源码版本v2026.7.20

Responsabilidad

La capa de interfaces es otro grupo de entradas para que el usuario alcance al agent (además de las plataformas de mensajes del gateway): CLI (hermes_cli/, sistema de subcomandos), TUI (ui-tui/, UI de terminal en TypeScript + tui_gateway/ puente en Python), Web (web/, interfaz en navegador). Los tres terminan entregando la entrada del usuario al run_conversation del agent y renderizando su salida de vuelta. Son paralelos a la capa de gateway: el gateway conecta plataformas externas; la capa de interfaces, al usuario local.

Archivos clave

CLI

• hermes_cli/__init__.py — entrada del paquete
• _parser.py — parsing de argumentos
• auth.py / auth_commands.py — autenticación (Nous Portal, etc.)
• active_sessions.py — gestión de sesiones activas
• backup.py / checkpoints.py — backups y checkpoints
• blueprint_cmd.py — comando de blueprints
• browser_connect.py / bundles.py / callbacks.py
• banner.py / build_info.py — banner e información de build

TUI

• ui-tui/README — UI de terminal (TypeScript, con packages/src)
• ui-tui/package.json — dependencias y scripts
• tui_gateway/entry.py — entrada del gateway TUI
• server.py — servidor del TUI
• transport.py / ws.py — transporte y WebSocket
• event_publisher.py — publicación de eventos
• host_supervisor.py / compute_host.py — supervisión del host
• slash_worker.py / synthetic_turn.py / render.py / project_tree.py
• _stdin_recovery.py — recuperación de stdin

Web

• web/README — interfaz en navegador
• web/index.html / vite.config.ts — entrada de Vite
• web/src/ — código fuente del frontend

Flujo de datos

1. CLI: hermes <subcommand> → hermes_cli/_parser.py parsea → el módulo del subcomando (auth/backup/blueprint/…) ejecuta; los subcomandos de conversación terminan llamando a AIAgent.run_conversation:6350.
2. TUI: ui-tui/ (frontend TS) se conecta por WebSocket a tui_gateway/ws.py; tui_gateway puentea los eventos del terminal al agent (tui_gateway/server.py mantiene el agent) y publica la salida vía tui_gateway/event_publisher.py al frontend.
3. Web: web/ (frontend Vite) se conecta igualmente al agent por un backend y renderiza la conversación y los resultados de herramientas.
4. La instancia de agent en los tres casos se ensambla vía init_agent:276 y comparte la misma capa de capacidades.

Resumen

La capa de interfaces = tres carcasas (CLI/TUI/Web) + un puente tui_gateway. No albergan lógica de negocio; solo se ocupan de la forma de entrada/salida. Son paralelas a la capa de gateway: el gateway conecta plataformas externas de mensajes; la capa de interfaces conecta al terminal/navegador local. ACP (ver aquí) conecta el IDE, completando la «superficie de contacto».