Esta página é uma tradução da documentação em inglês. Comandos, identificadores e exemplos permanecem iguais. Runtime 7.24.4 · SDK 2.6.7. Original em inglês
Estabilidade
Status: Ativo
Escopo: estado atual
Última revisão: 2026-07-18
Responsável: ax-code runtime
Como o AX Code se mantém confiável em sessões interativas longas e em execuções headless.
Camadas
| Camada | O que é endurecido | Módulos principais |
|---|---|---|
| Ciclo de vida da TUI | Suspender/retomar, restaurar o terminal após falha, poda de memória ao sair da sessão | ADR-047; cli/tui/util/* |
| Falhas de processo | Abortar, cancelar e pipe quebrado são ignorados; falhas reais ainda encerram o processo | util/harmless-interrupt, tratador de falha da TUI, hooks de arranque da CLI |
| Tempos limite | Limites de ferramenta, LSP e MCP sem unhandledRejection | util/timeout.withTimeout |
| Fluxos | Vigilância de inatividade e reconexão resiliente | vigilância de inatividade de session/llm-impl; resilient-stream |
| Permissões | Trava contra envio duplo e tempo limite de resposta | permission-submit-latch, prompt de permissão |
| Wiki do repositório | Contenção de caminho, gravações atômicas com o manifesto por último, conteúdo protegido e validação antes de gravar | packages/ax-wiki; src/wiki/* |
Caminho da TUI Blessed
A pilha de runtime com suporte é:
- Runtime: Node.js empacotado
- Interface: AX Code TUI + Solid (padrão principal)
- Renderização: Zig (produção); as bibliotecas nativas ficam todas incluídas no repositório
(incluídas no framework independente ax-tui, com o hash fixado pelo seu
vendor/manifest.json) — nenhum pacote npm de origem@opentui/*entra na instalação nem no runtime - Yoga não é um modo selecionável; o renderizador nativo da AX Code TUI continua sendo o padrão
Cancelamentos e falhas
| Sinal | Comportamento esperado |
|---|---|
Abortar pelo usuário / Esc / cancelar ferramenta (AbortError) |
Registrar em aviso se não for tratado; não sair da TUI |
Pipe quebrado (EPIPE) quando o shell fecha |
Ignorar como inofensivo |
| Exceção da aplicação não capturada | Redefinir o terminal e sair com código diferente de zero |
| Fluxo inativo por tempo demais | Abortar o turno pela vigilância de inatividade do fluxo (configurável) |
Substitua o tempo limite de inatividade do fluxo com AX_CODE_STREAM_IDLE_TIMEOUT_MS (0 desativa).
Prompts de permissão
As respostas de permissão são:
- Travadas — só uma resposta em andamento por id de solicitação
- Rearmadas quando a próxima solicitação da fila fica ativa
- Com tempo esgotado depois de 20s, para que um servidor travado não possa prender “Permitir” para sempre