Sesiones de terminal
Sesiones PTY persistentes, detección de atención del agente y comportamiento de recuperación en el terminal de Planes de Implementación.
Ejecuta comandos en un PTY persistente con comprobaciones de estado y registro. La transcripción de voz está disponible cuando la necesitas.
Ciclo de vida de la sesión
Cuando se abre un terminal, el componente de UI crea una sesión PTY y transmite la salida a través de una vista con búfer. El componente muestra el estado de conexión inmediato, reenvía pulsaciones de teclas al PTY y reintenta automáticamente si falla la sesión. Los metadatos de sesión se almacenan en SQLite con marcas de tiempo, códigos de salida, directorios de trabajo y el registro de salida completo para que los reinicios puedan reanudar el contexto anterior.
Comprobaciones de dependencias
Antes de lanzar comandos, el terminal verifica la presencia de herramientas CLI compatibles como claude, cursor, codex y gemini. El mismo comando también informa el shell predeterminado para que los usuarios sepan qué entorno se ejecutará. Esto evita lanzar una sesión que no puede encontrar el binario requerido.
Detección de atención del agente
El terminal monitorea la actividad del agente a través de un sistema de detección de inactividad de dos niveles. Cuando un agente deja de producir salida, el sistema te alerta progresivamente para verificar qué ha sucedido:
- Nivel 1 (30 segundos): "Agente inactivo - puede haber completado la tarea" con indicador amarillo
- Nivel 2 (2 minutos): "El agente requiere atención - verificar terminal" con indicador rojo y notificación de escritorio
Este enfoque te ayuda a rastrear cuándo los agentes han finalizado tareas o necesitan orientación, sin intentar adivinar por qué se detuvieron. Los indicadores de atención se borran automáticamente cuando se recibe nueva salida.
Transcripción de voz y recuperación
Dentro del modal del terminal, la transcripción de voz puede capturar el habla y pegarla en el área de entrada del terminal. El hook de grabación busca la configuración de transcripción a nivel de proyecto, mantiene un registro del estado de grabación y transmite texto reconocido a la sesión del plan activo.
Si una sesión PTY se desconecta, la superficie del terminal muestra controles de recuperación y reintenta la conexión con retroceso exponencial. Las comprobaciones de estado continúan monitoreando el estado de la sesión y proporcionan acciones de recuperación automáticas cuando se detectan problemas de conexión.