このページは英語版ドキュメントの翻訳です。コマンド、識別子、例はそのままです。ランタイム 7.24.4 · SDK 2.6.7。 英語版
安定性
ステータス: 現行
対象範囲: 現在の状態
最終確認: 2026-07-18
所有者: ax-code runtime
AX Code が、長い対話セッションとヘッドレス実行で信頼できる状態を保つ方法です。
層
| 層 | 何が強化されているか | 主なモジュール |
|---|---|---|
| TUI のライフサイクル | 一時停止と再開、クラッシュ時のターミナル復元、セッション離脱時のメモリ整理 | ADR-047。cli/tui/util/* |
| プロセス障害 | 中断、取り消し、壊れたパイプは無視する。本当のクラッシュは引き続き終了する | util/harmless-interrupt、TUI のクラッシュハンドラ、CLI の起動フック |
| タイムアウト | 未処理の拒否なしで、ツール、LSP、MCP を境界づける | util/timeout.withTimeout |
| ストリーム | アイドルの番犬、回復力のある再接続 | session/llm-impl のアイドル番犬。resilient-stream |
| 権限 | 二重送信のラッチと応答タイムアウト | permission-submit-latch、権限プロンプト |
| リポジトリ wiki | パスの封じ込め、マニフェストを最後にする原子的書き込み、保護された内容、書き込み前の検証 | packages/ax-wiki。src/wiki/* |
推奨される TUI 経路
サポートされるランタイムの積み重ねは次のとおりです。
- ランタイム: 同梱の Node
- UI: AX Code TUI + Solid(主たる既定)
- 描画: Zig(本番)。ネイティブライブラリはリポジトリ内に完全にベンダーされています(スタンドアロンの ax-tui フレームワークの内側にベンダーされ、その
vendor/manifest.jsonでハッシュが固定されます)。インストール時も実行時も、上流の@opentui/*npm パッケージは関与しません - Yoga は選択可能なモードではありません。AX Code TUI のネイティブレンダラーが既定のままです
取り消しとクラッシュ
| 信号 | 期待される挙動 |
|---|---|
利用者の中断 / Esc / ツール取り消し(AbortError) |
未処理なら警告で記録する。TUI は 終了しない |
シェルが閉じたときの壊れたパイプ(EPIPE) |
無害として無視する |
| 捕捉されないアプリケーション例外 | ターミナルをリセットし、ゼロ以外で終了する |
| ストリームのアイドルが長すぎる | ストリームのアイドル番犬を通じてターンを中断する(設定可能) |
ストリームのアイドルタイムアウトは AX_CODE_STREAM_IDLE_TIMEOUT_MS で上書きします(0 は無効にします)。
権限プロンプト
権限の応答は次のとおりです。
- ラッチされる — 要求 ID あたり、飛行中の応答は 1 つだけ
- 次のキューされた要求がアクティブになると 再武装される
- 20 秒後に 時間切れ になり、ハングしたサーバーが「許可」を永遠に食い止めることはない