Esta página es una traducción de la documentación en inglés. Los comandos, identificadores y ejemplos no cambian. Runtime 7.24.4 · SDK 2.6.7. Original en inglés
Estabilidad
Estado: Activo Alcance: estado actual Última revisión: 2026-07-18 Responsable: runtime de ax-code
Cómo AX Code se mantiene fiable en sesiones interactivas largas y en ejecuciones sin interfaz.
Capas
| Capa | Qué se endurece | Módulos clave |
|---|---|---|
| Ciclo de vida de la TUI | Suspender y reanudar, restaurar la terminal tras un fallo, podar la memoria al salir de la sesión | ADR-047; cli/tui/util/* |
| Fallos de proceso | Se ignoran abortar, cancelar y la tubería rota; los fallos reales siguen saliendo | util/harmless-interrupt, manejador de fallos de la TUI, hooks de arranque de la CLI |
| Tiempos de espera | Límites de herramientas, LSP y MCP sin unhandledRejection | util/timeout.withTimeout |
| Flujos | Vigilante de inactividad, reconexión resistente | vigilante de inactividad de session/llm-impl; resilient-stream |
| Permisos | Pestillo de doble envío y tiempo de espera de la respuesta | permission-submit-latch, aviso de permiso |
| Wiki del repositorio | Contención de rutas, escrituras atómicas con el manifiesto al final, contenido protegido, validación previa a la escritura | packages/ax-wiki; src/wiki/* |
Camino de TUI admitido
La pila de entorno de ejecución admitida es:
- Entorno de ejecución: Node empaquetado
- Interfaz: TUI de AX Code + Solid (predeterminado principal)
- Representación: Zig (producción); las bibliotecas nativas están incluidas por completo en el repositorio
(incluidas dentro del marco autónomo ax-tui, con el hash fijado por su
vendor/manifest.json): no intervienen paquetes npm de origen@opentui/*en la instalación ni en el entorno de ejecución - Yoga no es un modo seleccionable; el representador nativo de la TUI de AX Code sigue siendo el predeterminado
Cancelaciones frente a fallos
| Señal | Comportamiento esperado |
|---|---|
Abortar del usuario / Esc / cancelar herramienta (AbortError) |
Registrar como aviso si no se gestiona; no salir de la TUI |
Tubería rota (EPIPE) cuando se cierra el shell |
Ignorar como inofensivo |
| Excepción de aplicación no capturada | Restablecer la terminal y salir con código distinto de cero |
| Flujo inactivo demasiado tiempo | Abortar el turno mediante el vigilante de inactividad del flujo (configurable) |
Anula el tiempo de espera de inactividad del flujo con AX_CODE_STREAM_IDLE_TIMEOUT_MS (0 lo desactiva).
Avisos de permiso
Las respuestas de permiso son:
- Con pestillo: solo una respuesta en curso por id de solicitud
- Rearmadas cuando la siguiente solicitud en cola pasa a estar activa
- Con tiempo de espera a los 20 s para que un servidor colgado no pueda dejar «Permitir» atascado para siempre