Cette page est traduite de la documentation anglaise. Les commandes, identifiants et exemples sont inchangés. Runtime 7.24.4 · SDK 2.6.7. Source anglaise
Stabilité
Statut : actif
Portée : état actuel
Dernière revue : 2026-07-18
Responsable : runtime AX Code
Comment AX Code reste fiable pour les longues sessions interactives et les exécutions sans interface.
Couches
| Couche | Ce qui est renforcé | Modules clés |
|---|---|---|
| Cycle de vie du TUI | Suspension et reprise, restauration du terminal après plantage, élagage mémoire au départ de session | ADR-047 ; cli/tui/util/* |
| Fautes de processus | Abandon, annulation et broken-pipe ignorés ; les vrais plantages provoquent encore la sortie | util/harmless-interrupt, gestionnaire de plantage du TUI, crochets de démarrage CLI |
| Délais | Bornes outil, LSP et MCP sans unhandledRejection | util/timeout.withTimeout |
| Flux | Chien de garde d’inactivité, reconnexion résiliente | chien de garde d’inactivité session/llm-impl ; resilient-stream |
| Permissions | Verrou contre le double envoi + délai de réponse | permission-submit-latch, invite de permission |
| Wiki du dépôt | Confinement des chemins, écritures atomiques avec le manifeste en dernier, contenu protégé, validation avant écriture | packages/ax-wiki ; src/wiki/* |
Chemin TUI de référence
La pile de runtime prise en charge est :
- Runtime : Node empaqueté
- Interface : TUI AX Code + Solid (défaut principal)
- Rendu : Zig (production) ; les bibliothèques natives sont entièrement intégrées au dépôt (intégrées dans le framework autonome ax-tui, épinglées par empreinte via son
vendor/manifest.json) — aucun paquet npm amont@opentui/*n’intervient à l’installation ni au runtime - Yoga n’est pas un mode sélectionnable ; le moteur de rendu natif du TUI AX Code reste le défaut
Annulations face aux plantages
| Signal | Comportement attendu |
|---|---|
Abandon utilisateur / Esc / annulation d’outil (AbortError) |
Journaliser en avertissement si non géré ; ne pas quitter le TUI |
Tuyau rompu (EPIPE) à la fermeture du shell |
Ignorer comme inoffensif |
| Exception applicative non capturée | Réinitialiser le terminal, sortir avec un code non nul |
| Flux inactif trop longtemps | Abandonner le tour via le chien de garde d’inactivité du flux (configurable) |
Remplacez le délai d’inactivité du flux avec AX_CODE_STREAM_IDLE_TIMEOUT_MS (0 le désactive).
Invites de permission
Les réponses de permission sont :
- Verrouillées — une seule réponse en cours par identifiant de requête
- Réarmées lorsque la requête suivante en file devient active
- Expirées après 20s afin qu’un serveur bloqué ne puisse pas coincer « Autoriser » pour toujours
Documentation liée
- Mode bac à sable — isolation de l’exécution
- Mode autonome — exécutions sans surveillance
- AX Wiki — couche sémantique appuyée sur les sources (pas un substitut de graphe)