Back to Docs
Guide produit

Sessions de terminal

Sessions PTY persistantes, détection d'attention de l'agent et comportement de récupération dans le terminal Plans d'implémentation.

6 min read

Exécutez des commandes dans un PTY persistant avec vérifications de santé et journalisation. La transcription vocale est disponible quand vous en avez besoin.

Cycle de vie de la session

Lorsqu'un terminal s'ouvre, le composant d'interface utilisateur crée une session PTY et diffuse la sortie via une vue tampon. Le composant affiche l'état de connexion immédiat, transmet les touches au PTY et réessaie automatiquement si la session échoue. Les métadonnées de session sont stockées dans SQLite avec des horodatages, des codes de sortie, des répertoires de travail et le journal de sortie complet afin que les redémarrages puissent reprendre le contexte précédent.

Vérifications de dépendance

Avant de lancer des commandes, le terminal vérifie la présence d'outils CLI pris en charge tels que claude, cursor, codex et gemini. La même commande signale également le shell par défaut afin que les utilisateurs sachent quel environnement s'exécutera. Cela empêche le lancement dans une session qui ne peut pas trouver le binaire requis.

Détection d'attention de l'agent

Le terminal surveille l'activité de l'agent via un système de détection d'inactivité à deux niveaux. Lorsqu'un agent cesse de produire une sortie, le système vous alerte progressivement pour vérifier ce qui s'est passé :

  • Niveau 1 (30 secondes) : « Agent inactif - peut avoir terminé la tâche » avec indicateur jaune
  • Niveau 2 (2 minutes) : « L'agent nécessite une attention - vérifier le terminal » avec indicateur rouge et notification de bureau

Cette approche vous aide à suivre quand les agents ont terminé des tâches ou ont besoin de conseils, sans essayer de deviner pourquoi ils se sont arrêtés. Les indicateurs d'attention se vident automatiquement lorsqu'une nouvelle sortie est reçue.

Transcription vocale et récupération

Dans la modale de terminal, la transcription vocale peut capturer la parole et la coller dans la zone de saisie du terminal. Le hook d'enregistrement recherche les paramètres de transcription au niveau du projet, garde une trace de l'état d'enregistrement et diffuse le texte reconnu dans la session de plan active.

Si une session PTY se déconnecte, la surface du terminal affiche des contrôles de récupération et réessaie la connexion avec un recul exponentiel. Les vérifications de santé continuent à surveiller l'état de la session et fournissent des actions de récupération automatique lorsque des problèmes de connexion sont détectés.

Sessions de terminal - PlanToCode