Questa pagina è tradotta dalla documentazione inglese. Comandi, identificatori ed esempi restano invariati. Runtime 7.24.4 · SDK 2.6.7. Testo inglese
Stabilità
Stato: Attivo
Ambito: stato attuale
Ultima revisione: 2026-07-18
Responsabile: runtime di ax-code
Come AX Code resta affidabile nelle sessioni interattive lunghe e nelle esecuzioni senza interfaccia.
Livelli
| Livello | Che cosa è irrobustito | Moduli chiave |
|---|---|---|
| Ciclo di vita della TUI | Sospensione e ripresa, ripristino del terminale dopo un crash, potatura della memoria all’uscita dalla sessione | ADR-047; cli/tui/util/* |
| Guasti di processo | Abort, annullamento e pipe interrotta ignorati; i crash reali escono comunque | util/harmless-interrupt, gestore di crash della TUI, hook di avvio della CLI |
| Timeout | Limiti di strumenti, LSP e MCP senza unhandledRejection | util/timeout.withTimeout |
| Flussi | Watchdog di inattività, riconnessione resiliente | watchdog di inattività di session/llm-impl; resilient-stream |
| Autorizzazioni | Blocco contro il doppio invio e timeout della risposta | permission-submit-latch, richiesta di autorizzazione |
| Wiki del repository | Contenimento dei percorsi, scritture atomiche con il manifesto per ultimo, contenuto protetto, validazione prima della scrittura | packages/ax-wiki; src/wiki/* |
Percorso della TUI Blessed
Lo stack di runtime supportato è:
- Runtime: Node in bundle
- Interfaccia: TUI di AX Code + Solid (predefinito primario)
- Rendering: Zig (produzione); le librerie native sono interamente incorporate nel repository
(incorporate dentro il framework autonomo ax-tui, con hash fissato dal suo
vendor/manifest.json) — nessun pacchetto npm@opentui/*a monte è coinvolto in installazione o runtime - Yoga non è una modalità selezionabile; il renderer nativo della TUI di AX Code resta il predefinito
Annullamenti e crash
| Segnale | Comportamento atteso |
|---|---|
Interruzione dell’utente / Esc / annullamento dello strumento (AbortError) |
Registra un avviso se non gestito; non uscire dalla TUI |
Pipe interrotta (EPIPE) quando la shell si chiude |
Ignora come innocua |
| Eccezione applicativa non intercettata | Reimposta il terminale, esci con codice diverso da zero |
| Flusso inattivo troppo a lungo | Interrompi il turno tramite il watchdog di inattività del flusso (configurabile) |
Sostituisci il timeout di inattività del flusso con AX_CODE_STREAM_IDLE_TIMEOUT_MS (0 lo disattiva).
Richieste di autorizzazione
Le risposte alle autorizzazioni sono:
- Bloccate — una sola risposta in corso per ogni id di richiesta
- Riarmate quando la richiesta successiva in coda diventa attiva
- Scadute dopo 20s, così un server bloccato non può tenere fermo “Allow” per sempre