aiterm-mcp 0.52.2 → 0.53.0

package/CHANGELOG.md

@@ -7,6 +7,66 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.53.0] - 2026-10-05
+
+### 追加
+
+- `agent_auth`の`start`に`relogin`を足す（既定false）。trueの時は、公式の状態が認証済みでも公式ログインを開始し、
+  `session_id`付きの結果を返す（`authenticated`かつ`session_id:null`は返さない）。別のアカウントへ入り直す時と、
+  ログインの期限切れを状態から見抜けない時に使う。Aitermは資格情報を消さず、置き換えは公式CLIが行う。
+  公式CLIがログインを始めた時点で元のログインを消す事がある（Codex 0.160.0の`codex login --device-auth`は、
+  始めた時点で`auth.json`を消し、途中で`cancel`しても戻らない。期限切れのログインの写しで確認）。
+  Claude CodeとCursorは、途中で`cancel`すれば元の資格情報が残った（無効な資格情報で確認）。
+  結果の形（`aiterm.agent-auth-result.v1`）は変えていない。
+- `agent_auth`の`status`（sessionなし）が、Grokの認証状態を答える。今までは「公式ログインsessionの終了結果で確認します」の
+  `blocked`だけだった。`grok models`が`You are not authenticated.`と答えれば`blocked`、答えなければ`authenticated`。
+  これに伴い、Grokが認証済みの時の`start`（`relogin`なし）は、何も起こさず`authenticated`を返す（今までは毎回ログインを始めていた）。
+
+### 修正
+
+- 期限が切れたCodexのログインを、`agent_auth`の`status`と`start`が`authenticated`と返していた（ADR 0090）。
+  `codex login status`は`auth.json`の有無だけを見て、ログインから30日でrefresh tokenが切れた後も「Logged in」と答える
+  （2026-10-05、Codex 0.160.0、BellTeamのコンテナ）。`start`は入り直しを始めず、`auth.json`の名前を手で変えるまで戻せなかった。
+  「Logged in」の時は公式App Serverへ`getAuthStatus`、`account/read`の順に聞き、`account`が`null`なら
+  `status`は`blocked`（「Codexのログインの期限が切れています」）、`start`は入り直しを始める。
+  生きているログインへ余計なtokenの取り直しはかけず、資格情報のfileも読まない。
+  App Serverがこの問い合わせを知らない旧版のCodexでは、今までどおり`codex login status`の答えに従う。
+- Cursorの公式statusが`Logged in (unable to fetch user details)`と答える時（無効なtoken。期限切れか通信できないかは分からない）、
+  `authenticated`でなく`failed`を返す。入り直しは`relogin:true`で始められる。
+- Grokのログインが無い・切れている時、`agent_launch`が30秒待ってから`unrecognized_screen`で返っていた。
+  Grokが起動してすぐ自分で始めるサインイン画面（`Approve in your browser to finish signing in`）を見分け、
+  すぐ`startup.status: blocked`／`reason: startup_dialog`で返す。Codexのサインイン画面も同じ`startup_dialog`のまま、
+  種別を「サインイン画面（ログインが必要）」と読む。
+
+### 分かっている限界
+
+- Claude Codeの期限切れは、`status`では見抜けない（`claude auth status --json`が`loggedIn:true`と答える）。
+  `agent_launch`は通り、最初のturnが認証の誤りで終わる。入り直しは`relogin:true`。
+- Cursorのログインが無効な時、`agent_launch`はsessionを作る前に
+  「Cursor model catalog を取得できません: Error: Authentication required…」の誤りで返る（今までと同じ）。
+
+## [0.52.3] - 2026-10-05
+
+### 修正
+
+- Claude Code親の配送hookの登録を、`args`を使わずshellを通す1行で書く（aiterm-steer-delivery 0.2.0、ADR 0089）。
+  Grokは共有の`~/.claude/settings.json`のhookも動かすが、`args`を落として`command`だけを動かす。
+  0.52.2までの`command=node, args=[claude-parent-hook.js]`の形では、Grokがnodeだけを起こし、nodeがhookの入力を
+  scriptとして読んで、会話の終わりのたびに`[stdin]:1`で失敗の記録を残していた（Grok 1.0.46、LinuxとWindowsで再現）。
+  POSIXは`exec '<node>' '<hook>'`、Windowsは`& '<node>' '<hook>'; exit (Get-Variable LASTEXITCODE -ValueOnly)`と
+  `shell: "powershell"`。`aiterm-setup`（`--hooks-only`も）を流すと、0.52.2までの登録をこの形へ置き換える。
+  Grokから起こされたhookは何もせず0で終わる。PreToolUseのhookは、間に挟まるshellではなくClaude Code本体を
+  依頼元として記録する。
+- Windowsで、Claude Code親へ子の回答が届いているのに、配送が`CLAUDE_PARENT_HOOK_CLOSED`（結果不明）で終わる事があった。
+  process表を読む間（約1秒）に受信hookが本文を出し終えて終わると、出し終えた後のhookを「途中で終わった」と数えていた。
+- `diagnostics`の親配送hookの状態は、0.52.2までの登録と新しい登録のどちらも「登録済み」と読む。
+
+### 注意
+
+- 0.52.2以前へ戻す時は、旧版のinstall前に`aiterm-setup --remove-claude-parent-hooks`を実行する。
+  0.52.2以前は新しい形の登録を自分の物と数えず、もう1組を足す。
+- Windowsでは、子の回答を待っているhook1つにつき、Claude Codeが起こすPowerShellのprocessが1つ残る。
+
 ## [0.52.2] - 2026-10-05
 
 ### 修正
@@ -2135,7 +2195,9 @@ prototype (preserved under `prototype/python/` as the porting source and referen
   `ubuntu-latest` for Node 18/20/22, publishing to npm on `v*` tags with
   provenance.
 
-[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.52.2...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.53.0...HEAD
+[0.53.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.52.3...v0.53.0
+[0.52.3]: https://github.com/kitepon/aiterm-mcp/compare/v0.52.2...v0.52.3
 [0.52.2]: https://github.com/kitepon/aiterm-mcp/compare/v0.52.1...v0.52.2
 [0.52.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.52.0...v0.52.1
 [0.52.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.51.3...v0.52.0

package/README.ja.md

@@ -209,7 +209,7 @@ runtime-error store は canonical dotagents config の `collection.enabled: true
 場合だけ収集し、既定OFF、network送信は行いません。tag起点CIのnpm provenance（OIDC Trusted
 Publishing）で公開し、GitHub Release が Official MCP Registry を再登録します。
 
-**状態:** 開発継続中 · 現行公開版 **v0.52.2** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.53.0** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -561,7 +561,7 @@ Claudeの相関済み承認は既存の`claude_approval`を使う。
 | `pty_list` | textと構造化したsession一覧、明示した非秘密環境変数の照会 | `env_keys?` |
 | `pty_observe` | pane／harnessの生存、native process identity、状態と活動 | `session_id`, `cursor?` |
 | `agent_launch` | harnessとmodelを別軸で選ぶ正規agent起動入口 | `harness`, `prompt?`, `model?`, `reasoning_effort?`, `cwd?`, `write_scope?`, `trust_project?`, `env_vars?`, `throughline_source_session?`, `throughline_supplement_file?` |
-| `agent_auth` | 公式CLIの認証を開始・確認・取消し、公式URL・device code・入力待ちを返す | `harness`, `action`, `session_id?`, `cwd?`, `env_vars?` |
+| `agent_auth` | 公式CLIの認証を開始・確認・取消し、公式URL・device code・入力待ちを返す | `harness`, `action`, `session_id?`, `cwd?`, `env_vars?`, `relogin?` |
 | `agent_models` | harnessが今選べるmodelとreasoning effortを、そのharness自身の一覧からpromptを送らずに取得 | `harness`, `cwd?`, `include_hidden?` |
 | `agent_approval` | Codexの現在の承認を検査し、単発許可・拒否を送る | `action`, `session_id`, `approval_choice?`, `observed_prompt_digest?` |
 | `claude_agent` / `codex_agent` / `grok_agent` | deprecated互換alias（`composer_agent`は0.41.0で削除。Composerは`agent_launch`の`cursor-cli`で使う） | 旧launcher引数 |
@@ -597,7 +597,18 @@ Aitermは、既定では実行時エラーをどこへも送らない。送る
 
 `agent_configure({ session_id, model?, reasoning_effort? })`はharness標準操作で起動中のClaude／Codex／Grok／Cursorを変更し、PTYと会話contextを維持する。
 
-`agent_auth({ harness, action:"start"|"status"|"cancel", session_id?, cwd?, env_vars? })`は、各harnessの公式CLIで認証を進める。Claudeは`claude auth login`、CodexとGrokは`login --device-auth`、Cursorは`NO_OPEN_BROWSER=1 cursor-agent login`を使い、資格情報は各CLIだけが保存する。Aitermは資格情報を読取り・copy・編集せず、独自OAuthも実装しない。`remote`は他toolと同じ標準対応。
+`agent_auth({ harness, action:"start"|"status"|"cancel", session_id?, cwd?, env_vars?, relogin? })`は、各harnessの公式CLIで認証を進める。Claudeは`claude auth login`、CodexとGrokは`login --device-auth`、Cursorは`NO_OPEN_BROWSER=1 cursor-agent login`を使い、資格情報は各CLIだけが保存する。Aitermは資格情報を読取り・copy・編集せず、独自OAuthも実装しない。`remote`は他toolと同じ標準対応。
+
+`start`は、公式の状態が認証済みなら何も起こさず`authenticated`（`session_id:null`）を返す。`relogin:true`を付けると、認証済みに見えても公式ログインを開始し、`session_id`付きの結果を返す。別のアカウントへ入り直す時と、ログインの期限切れを状態から見抜けない時に使う。Aitermは資格情報を消さず、置き換えは公式CLIが行う。ただし、公式CLIがログインを始めた時点で元のログインを消す事がある（Codex 0.160.0の`codex login --device-auth`は、始めた時点で`auth.json`を消す。途中で`cancel`しても戻らない）。Claude CodeとCursorは、途中で`cancel`すれば元の資格情報が残る（無効な資格情報で確認）。
+
+`status`（sessionなし）は、公式CLIに今の状態を聞く。
+
+| harness | 聞き方 | 期限が切れたログイン |
+|---|---|---|
+| Codex | `codex login status`が「Logged in」の時、公式App Serverの`getAuthStatus`→`account/read` | `blocked`（`account`が`null`）。`codex login status`だけでは「Logged in」のままで見抜けない |
+| Claude Code | `claude auth status --json` | **見抜けない**（公式の答えが`loggedIn:true`のまま）。起動は通り、最初のturnが認証の誤りで終わる |
+| Grok | `grok models`（状態の命令は無い） | `blocked`（`You are not authenticated.`）。Grokは使えない資格情報を自分で消す |
+| Cursor | `cursor-agent status` | `failed`（`Logged in (unable to fetch user details)`。期限切れか通信できないかは区別できない）。`relogin:true`で入り直す |
 
 結果は`aiterm.agent-auth-result.v1`。`status`は`waiting`／`authenticated`／`blocked`／`failed`、`session_id`・`url`・`user_code`・`input_required`・`message`を返す。`start`のsession IDを保存して`status`へ渡す。公式HTTPS URLと明示device codeだけを返し、CLIの生出力・token・OAuth callback codeを結果へ載せない。`input_required:true`なら同じsessionの`pty_read(screen:true)`で公式画面を表示し、`pty_send`／`pty_key`で人の入力を中継する。
 
@@ -655,7 +666,7 @@ Claude Codeは2.1.259以上の対話sessionに対応する。`aiterm-setup`が
 
 `/clear`などで会話を終了すると未送信の旧回答の配送を止め、本文は保存する。受信hookの上限は24時間で、終了や出力失敗を成功扱いしない。hookが無効な場合は送信前に明示errorにし、waiterへ黙って切り替えない。Claude Desktopのチャット、Web、`agent_id`付きの会話（`--agent`起動とnative subagent）はこの受信契約に含めない。
 
-hookを持たない旧版へ戻す時は、install前に`aiterm-setup --remove-claude-parent-hooks`を実行する。Aiterm専用hookだけを解除し、他製品のhookと設定は保持する。
+hookを持たない旧版、または0.52.2以前へ戻す時は、install前に`aiterm-setup --remove-claude-parent-hooks`を実行する。Aiterm専用hookだけを解除し、他製品のhookと設定は保持する。
 
 Cursor親（`clientInfo.name`が`cursor-vscode`）も同じ完了観測と本文保存を使う。`aiterm-setup`が`~/.cursor/hooks.json`へ`afterMCPExecution`と`postToolUse`を追加し、他製品のhookと順序は保持する。hookが無い場合は子への送信前に`CURSOR_PARENT_HOOK_UNAVAILABLE`で止める。作業を続けていれば次のツール返りへ`additional_context`で本文が差し込まれ、ターンを終える前にreceiptの`wait_process`を背景で起動しておけばidle中の完了でも起きられる。`wait_command`はnull。`submitted`はhookまたは受け口が本文を受け取った状態であり、modelの読了ではない。24時間以内に受け取りが無ければ`failed`とし、本文は残して自動再送しない。解除は`aiterm-setup --remove-cursor-parent-hooks`。Cursor Cloud Agent／Background Agentはこの受信契約に含めない。
 

package/README.md

@@ -223,7 +223,7 @@ collection is off by default and performs no network I/O. It ships via
 tag-triggered CI with npm provenance (OIDC Trusted Publishing); the GitHub
 Release re-registers the Official MCP Registry entry.
 
-**Status:** actively maintained · current public release **v0.52.2** · runs on Linux · WSL2 · macOS · native Windows (tmux on POSIX, the tmux-CLI-compatible [psmux](https://github.com/psmux/psmux) on native Windows — no WSL required) · MIT · see the [CHANGELOG](CHANGELOG.md).
+**Status:** actively maintained · current public release **v0.53.0** · runs on Linux · WSL2 · macOS · native Windows (tmux on POSIX, the tmux-CLI-compatible [psmux](https://github.com/psmux/psmux) on native Windows — no WSL required) · MIT · see the [CHANGELOG](CHANGELOG.md).
 
 ### Update and rollback
 
@@ -598,7 +598,7 @@ continue to use `claude_approval`.
 | `pty_list` | Text and structured session list, with explicitly requested non-secret environment values | `env_keys?` |
 | `pty_observe` | Pane/harness liveness, native process identity, state, and activity | `session_id`, `cursor?` |
 | `agent_launch` | Canonical agent launch; harness and model are independent | `harness`, `prompt?`, `model?`, `reasoning_effort?`, `cwd?`, `write_scope?`, `trust_project?`, `env_vars?`, `throughline_source_session?`, `throughline_supplement_file?` |
-| `agent_auth` | 公式CLIの認証を開始・確認・取消し、公式URL・device code・入力待ちを返す | `harness`, `action`, `session_id?`, `cwd?`, `env_vars?` |
+| `agent_auth` | 公式CLIの認証を開始・確認・取消し、公式URL・device code・入力待ちを返す | `harness`, `action`, `session_id?`, `cwd?`, `env_vars?`, `relogin?` |
 | `agent_models` | List the models and reasoning efforts a harness offers now, read from that harness's own catalog without sending a prompt | `harness`, `cwd?`, `include_hidden?` |
 | `agent_approval` | Inspect a Codex approval and submit a one-time approval or denial | `action`, `session_id`, `approval_choice?`, `observed_prompt_digest?` |
 | `claude_agent` / `codex_agent` / `grok_agent` | Deprecated compatibility aliases (`composer_agent` was removed in 0.41.0; run Composer with `agent_launch` on `cursor-cli`) | legacy launcher arguments |
@@ -637,7 +637,18 @@ enables collection on that host.
 
 `agent_configure({ session_id, model?, reasoning_effort? })` changes a running Claude, Codex, Grok, or Cursor TUI through the harness's standard controls, preserving the PTY and conversation context.
 
-`agent_auth({ harness, action:"start"|"status"|"cancel", session_id?, cwd?, env_vars? })`は、各harnessの公式CLIで認証を進める。Claudeは`claude auth login`、CodexとGrokは`login --device-auth`、Cursorは`NO_OPEN_BROWSER=1 cursor-agent login`を使い、資格情報は各CLIだけが保存する。Aitermは資格情報を読取り・copy・編集せず、独自OAuthも実装しない。`remote`は他toolと同じ標準対応。
+`agent_auth({ harness, action:"start"|"status"|"cancel", session_id?, cwd?, env_vars?, relogin? })`は、各harnessの公式CLIで認証を進める。Claudeは`claude auth login`、CodexとGrokは`login --device-auth`、Cursorは`NO_OPEN_BROWSER=1 cursor-agent login`を使い、資格情報は各CLIだけが保存する。Aitermは資格情報を読取り・copy・編集せず、独自OAuthも実装しない。`remote`は他toolと同じ標準対応。
+
+`start`は、公式の状態が認証済みなら何も起こさず`authenticated`（`session_id:null`）を返す。`relogin:true`を付けると、認証済みに見えても公式ログインを開始し、`session_id`付きの結果を返す。別のアカウントへ入り直す時と、ログインの期限切れを状態から見抜けない時に使う。Aitermは資格情報を消さず、置き換えは公式CLIが行う。ただし、公式CLIがログインを始めた時点で元のログインを消す事がある（Codex 0.160.0の`codex login --device-auth`は、始めた時点で`auth.json`を消す。途中で`cancel`しても戻らない）。Claude CodeとCursorは、途中で`cancel`すれば元の資格情報が残る（無効な資格情報で確認）。
+
+`status`（sessionなし）は、公式CLIに今の状態を聞く。
+
+| harness | 聞き方 | 期限が切れたログイン |
+|---|---|---|
+| Codex | `codex login status`が「Logged in」の時、公式App Serverの`getAuthStatus`→`account/read` | `blocked`（`account`が`null`）。`codex login status`だけでは「Logged in」のままで見抜けない |
+| Claude Code | `claude auth status --json` | **見抜けない**（公式の答えが`loggedIn:true`のまま）。起動は通り、最初のturnが認証の誤りで終わる |
+| Grok | `grok models`（状態の命令は無い） | `blocked`（`You are not authenticated.`）。Grokは使えない資格情報を自分で消す |
+| Cursor | `cursor-agent status` | `failed`（`Logged in (unable to fetch user details)`。期限切れか通信できないかは区別できない）。`relogin:true`で入り直す |
 
 結果は`aiterm.agent-auth-result.v1`。`status`は`waiting`／`authenticated`／`blocked`／`failed`、`session_id`・`url`・`user_code`・`input_required`・`message`を返す。`start`のsession IDを保存して`status`へ渡す。公式HTTPS URLと明示device codeだけを返し、CLIの生出力・token・OAuth callback codeを結果へ載せない。`input_required:true`なら同じsessionの`pty_read(screen:true)`で公式画面を表示し、`pty_send`／`pty_key`で人の入力を中継する。
 
@@ -696,7 +707,7 @@ Claude Codeは2.1.259以上の対話sessionに対応する。`aiterm-setup`が
 
 `/clear`等の会話終了後は未送信の旧回答を送らず、本文を保存する。受信hookの上限は24時間。hookの終了・出力失敗・無効化を成功扱いせず、別の待機経路へ黙って切り替えない。Claude Desktopのチャット、Web、`agent_id`付きの会話（`--agent`起動とnative subagent）はこの受信契約に含めない。
 
-hookを持たない旧版へ戻す時は、install前に`aiterm-setup --remove-claude-parent-hooks`を実行する。Aiterm専用hookだけを解除し、他製品のhookと設定は保持する。
+hookを持たない旧版、または0.52.2以前へ戻す時は、install前に`aiterm-setup --remove-claude-parent-hooks`を実行する。Aiterm専用hookだけを解除し、他製品のhookと設定は保持する。
 
 Cursor parents (`clientInfo.name` of `cursor-vscode`) use the same completion capture. `aiterm-setup` adds `afterMCPExecution` and `postToolUse` to `~/.cursor/hooks.json` and keeps every other hook and its position. A missing registration fails the dispatch with `CURSOR_PARENT_HOOK_UNAVAILABLE` before the child is sent. While the parent keeps calling tools, the answer is injected through `additional_context` on the next tool result. If the parent ends the turn, start the receipt `wait_process` in the background first; that receiver exits when the answer arrives. `wait_command` is null. `submitted` means the hook or the receiver claimed the text, not that the model has read it. No claim within 24 hours is `failed`, the text is kept, and nothing is resent. Remove only Aiterm's entries with `aiterm-setup --remove-cursor-parent-hooks`. Cursor Cloud Agents and Background Agents are outside this contract.
 

package/dist/core.js

@@ -2125,9 +2125,6 @@ async function acquireAgentSendFileLock(name, deadline, waitMs) {
             }
         }
         if (dead && reapDeadAgentSendLock(name, replacedToken) === "stuck") {
-            // BellTeamのため: 先頭の「agent session '<名前>' に、終了した送信のlockを片付ける途中で残った印があります。」と、
-            // 文中の「文字列は送信していません。」で見分け、pty_close→起動し直しへ回している（2026-10-05）。
-            // この文面と、pty_closeがこの印を片付ける事を変える時は、変える前に知らせる。
             throw new AitermError(`agent session '${name}' に、終了した送信のlockを片付ける途中で残った印があります。` +
                 `自動回収は並行送信の混線を招くため行いません。文字列は送信していません。` +
                 `pty_listで対象を確認し、pty_closeでsessionを閉じてから同じIDで再作成してください`, 2);
@@ -3713,11 +3710,11 @@ function authPlan(kind, phase) {
         case "cursor": return cursorAuthPlan();
     }
 }
-function authStatus(kind, bin, cwd, env = process.env) {
+async function authStatus(kind, bin, cwd, env = process.env) {
     switch (kind) {
         case "claude": return claudeAuthStatus(bin, cwd, env);
-        case "codex": return codexAuthStatus(bin, cwd, env);
-        case "grok": return grokAuthStatus();
+        case "codex": return await codexAuthStatus(bin, cwd, env);
+        case "grok": return grokAuthStatus(bin, cwd, env);
         case "cursor": return cursorAuthStatus(bin, cwd, env);
     }
 }
@@ -3784,7 +3781,11 @@ function launchAuthProcess(name, meta) {
     const cmd = ["exec", "env", ...env, shq(agentBinForPaneShell(meta.bin)), ...plan.args.map(shq)].join(" ");
     send(name, `cd ${shq(paneCwdArgument(meta.cwd))} && ${cmd}`, { enter: true, force: true, raw: true });
 }
-/** 公式CLIの認証processを起動・観測する。資格情報の読取り・copy・独自OAuthは行わない。 */
+/**
+ * 公式CLIの認証processを起動・観測する。資格情報の読取り・copy・独自OAuthは行わない。
+ * startは、公式の状態が認証済みなら何も起こさない。`relogin`は、認証済みに見えても公式ログインを始める
+ * （別のアカウントへ入り直す時と、期限切れを状態から見抜けない時のため）。資格情報を消すことはせず、置き換えは公式CLIが行う。
+ */
 export async function authenticateAgent(kind, options) {
     const result = (status, session, message, pane) => ({ schema: "aiterm.agent-auth-result.v1", harness: agentHarness(kind),
         status, session_id: session, url: pane?.url ?? null, user_code: pane?.user_code ?? null,
@@ -3812,7 +3813,8 @@ export async function authenticateAgent(kind, options) {
         const bin = resolveAgentBin(kind);
         if (!bin)
             return result("failed", null, `${agentLabel(kind)}の公式CLIが見つかりません。`);
-        const before = authStatus(kind, bin, cwd);
+        // reloginは今の状態を聞かない。状態を確認できない時（failed）でも、入り直しは始められる。
+        const before = options.relogin ? { status: "unauthenticated", message: null } : await authStatus(kind, bin, cwd);
         if (before.status === "failed")
             return result("failed", null, before.message);
         if (before.status === "authenticated" && !before.verify_onboarding)
@@ -3840,7 +3842,7 @@ export async function authenticateAgent(kind, options) {
         const bin = resolveAgentBin(kind);
         if (!bin)
             return result("failed", null, `${agentLabel(kind)}の公式CLIが見つかりません。`);
-        const checked = authStatus(kind, bin, cwd);
+        const checked = await authStatus(kind, bin, cwd);
         return result(checked.status === "authenticated" ? "authenticated" : checked.status === "failed" ? "failed" : "blocked", null, checked.message ?? (checked.status === "unauthenticated" ? "公式CLIの認証が必要です。agent_authのstartで開始してください。" : null));
     }
     else {
@@ -3864,7 +3866,7 @@ export async function authenticateAgent(kind, options) {
         if (dead === "1") {
             if (exit !== "0")
                 return result("failed", session, `公式認証processが失敗しました（exit=${/^\d+$/.test(exit ?? "") ? exit : "unknown"}）。`);
-            const checked = authStatus(kind, meta.bin, meta.cwd, authSessionEnvironment(session, meta.env_vars));
+            const checked = await authStatus(kind, meta.bin, meta.cwd, authSessionEnvironment(session, meta.env_vars));
             if (checked.status === "failed")
                 return result("failed", session, checked.message);
             if (checked.status === "unauthenticated")
@@ -3884,7 +3886,7 @@ export async function authenticateAgent(kind, options) {
         if (dead !== "0")
             return result("failed", session, "認証processの生存状態の形式を認識できません。");
         if (pane.onboarding_complete) {
-            const checked = authStatus(kind, meta.bin, meta.cwd, authSessionEnvironment(session, meta.env_vars));
+            const checked = await authStatus(kind, meta.bin, meta.cwd, authSessionEnvironment(session, meta.env_vars));
             if (checked.status === "authenticated")
                 return result("authenticated", session, null);
             return result("failed", session, checked.message ?? "公式CLIのstatusが未認証です。");

package/dist/harnesses/codex.js

@@ -575,6 +575,9 @@ export function codexLaunchBlockingDialog(screen) {
         return "directory trust確認ダイアログ";
     if (screen.includes("Trust this folder?"))
         return "folder trust確認ダイアログ";
+    // ログインが無い・期限が切れた時の最初の画面（Codex 0.160.0）。
+    if (screen.includes("Sign in with ChatGPT") && screen.includes("Sign in with Device Code"))
+        return "サインイン画面（ログインが必要）";
     if (screen.includes("Press enter to continue"))
         return "起動時ダイアログ（種別未特定）";
     return null;
@@ -788,14 +791,40 @@ export function codexCatalogFromPages(pages) {
     });
 }
 export function codexAuthPlan() { return { args: ["login", "--device-auth"], env: [] }; }
-export function codexAuthStatus(bin, cwd, env = process.env) {
+const CODEX_AUTH_CHECK_TIMEOUT_MS = 15_000;
+/**
+ * `codex login status`は`auth.json`があるかだけを見る。ログインの期限が切れた後（refresh tokenの失効）も「Logged in」と答える
+ * （2026-10-05、Codex 0.160.0、ログインから30日後）。使えるログインかは、公式App Serverに聞く。
+ * `getAuthStatus`（`refreshToken:false`）は、Codex自身が要ると判断した時だけtokenを取り直す。取り直しが恒久的に失敗していると、
+ * 続く`account/read`が`account: null`を返す。Aitermは資格情報を読まず、生きているログインへ余計な取り直しもかけない。
+ */
+export async function codexAuthStatus(bin, cwd, env = process.env) {
     const result = spawnAgentControlCommand(bin, ["login", "status"], cwd, { cwd, env, encoding: "utf8", timeout: 5000, maxBuffer: 64 * 1024 });
     const output = `${result.stdout ?? ""}\n${result.stderr ?? ""}`;
-    if (!result.error && result.status === 0 && /Logged in/i.test(output))
-        return { status: "authenticated", message: null };
     if (!result.error && /Not logged in/i.test(output))
         return { status: "unauthenticated", message: null };
-    return { status: "failed", message: "Codex CLIの公式認証状態を確認できません。" };
+    if (result.error || result.status !== 0 || !/Logged in/i.test(output))
+        return { status: "failed", message: "Codex CLIの公式認証状態を確認できません。" };
+    const parent = { thread_id: "00000000-0000-4000-8000-000000000000", codex_home: path.resolve(env.CODEX_HOME || steer.realCodexHome()) };
+    let read;
+    try {
+        read = await steer.withCodexReceiver(AITERM_PROFILE, parent, async (request) => {
+            await request("getAuthStatus", { includeToken: false, refreshToken: false });
+            return await request("account/read", { refreshToken: false });
+        }, { executable: bin, timeout_ms: CODEX_AUTH_CHECK_TIMEOUT_MS, env });
+    }
+    catch (error) {
+        // App Serverがこの問い合わせを知らない旧版は、今までどおり公式statusの答えに従う（期限切れは見抜けない）。
+        if (error instanceof steer.CodexDeliveryError && error.delivery_code === "CODEX_RECEIVER_REJECTED")
+            return { status: "authenticated", message: null };
+        return { status: "failed", message: "Codexのログインが使えるかを、公式App Serverで確認できません。" };
+    }
+    if (read?.requiresOpenaiAuth === false || (read?.account !== null && typeof read?.account === "object"))
+        return { status: "authenticated", message: null };
+    if (read?.account === null) {
+        return { status: "unauthenticated", message: "Codexのログインの期限が切れています。agent_authのstartで入り直してください。" };
+    }
+    return { status: "failed", message: "Codexの公式App Serverが返した認証状態の形式を認識できません。" };
 }
 export function codexAuthPane(screen) {
     return { url: authUrl(screen, ["auth.openai.com", "auth0.openai.com", "login.openai.com"]),

package/dist/harnesses/cursor.js

@@ -581,6 +581,11 @@ export function cursorAuthStatus(bin, cwd, env = process.env) {
     const output = `${result.stdout ?? ""}\n${result.stderr ?? ""}`;
     if (!result.error && /not logged in|unauthenticated|sign in/i.test(output))
         return { status: "unauthenticated", message: null };
+    // 無効なtoken（期限切れ等）の時、公式statusは「Logged in (unable to fetch user details)」と終了0で答える（2026-10-05）。
+    // 期限切れか、通信できないだけかは、この答えからは分からない。認証済みとは返さない。
+    if (!result.error && /unable to fetch user details/i.test(output)) {
+        return { status: "failed", message: "Cursorのログインを確認できません（期限切れか、通信できない状態です）。入り直す時はagent_authのstartにrelogin:trueを付けてください。" };
+    }
     // launcherと同じ公式status契約。stderrやアカウント情報はreceiptへ載せない。
     if (!result.error && result.status === 0)
         return { status: "authenticated", message: null };

package/dist/harnesses/grok.js

@@ -355,6 +355,13 @@ export function assertGrokSandboxNotRejected(screen) {
         "CLIが示した設定の問題を、その設定の管理元で修正してください。修正後はpty_closeで対象sessionを閉じ、agent_launchで起動し直してください。", 2);
 }
 export function grokLaunchBlockingDialog(screen) {
+    // ログインが無い・期限が切れた時、Grok 1.0.46は起動してすぐdevice codeのサインインを自分で始め、承認を待つ。
+    const signInAt = screen.lastIndexOf("Approve in your browser to finish signing in");
+    if (signInAt >= 0) {
+        const afterSignIn = screen.slice(signInAt);
+        if (afterSignIn.includes("Waiting for approval") && !/(?:^|\n)[ \t]*(?:│[ \t]*)?[❯>]/u.test(afterSignIn))
+            return "サインイン画面（ログインが必要）";
+    }
     const trustAt = screen.lastIndexOf("Do you trust the contents of this directory?");
     if (trustAt < 0)
         return null;
@@ -523,9 +530,18 @@ export function createGrokAgentMetadata(kind, name, cwd, initialPrompt, authPath
     return meta;
 }
 export function grokAuthPlan() { return { args: ["login", "--device-auth"], env: [] }; }
-export function grokAuthStatus() {
-    // 現行Grokには公式status commandが無い。auth fileの存在を成功とみなさない。
-    return { status: "unsupported", message: "Grokの認証状態はagent_authで開始した公式ログインsessionの終了結果で確認します。" };
+/**
+ * Grokには認証状態を答える公式commandが無い。`grok models`は、使えるログインが無い時に`You are not authenticated.`と答える
+ * （1.0.46。ログイン無しと、期限切れ・無効なtokenの両方。後者ではGrokが`auth.json`を自分で消す）。auth fileの存在は見ない。
+ */
+export function grokAuthStatus(bin, cwd, env = process.env) {
+    const result = spawnAgentControlCommand(bin, ["models"], cwd, { cwd, env, encoding: "utf8", timeout: 20000, maxBuffer: 256 * 1024 });
+    const output = `${result.stdout ?? ""}\n${result.stderr ?? ""}`;
+    if (!result.error && /You are not authenticated|Not signed in/i.test(output))
+        return { status: "unauthenticated", message: null };
+    if (!result.error && result.status === 0 && /Available models/i.test(output))
+        return { status: "authenticated", message: null };
+    return { status: "failed", message: "Grokの公式CLIで認証状態を確認できません。" };
 }
 export function grokAuthPane(screen) {
     const url = authUrl(screen, ["auth.x.ai", "accounts.x.ai", "grok.com"]);

package/dist/index.js

@@ -758,13 +758,17 @@ registerRemoteAwareTool("claude_approval", {
 registerRemoteAwareTool("agent_auth", {
     description: "各harnessの公式CLI認証を開始・確認・取消する。CLIごとのコマンドと認証URL/codeの抽出はAitermが所有し、資格情報は各CLIだけが保存する。" +
         "waitingのURL/codeを人へ表示し、input_requiredなら同じsessionのpty_send／pty_keyで公式画面へ入力する。" +
-        "authenticatedは認証の結果であり、agent_launchの起動準備完了とは別。remoteは他toolと同じ標準対応。",
+        "authenticatedは認証の結果であり、agent_launchの起動準備完了とは別。remoteは他toolと同じ標準対応。" +
+        "startは公式の状態が認証済みなら何も起こさずauthenticatedを返す。relogin:trueを付けると、認証済みに見えても公式ログインを開始する" +
+        "（別のアカウントへ入り直す時、ログインの期限切れを状態から見抜けない時）。Aitermは資格情報を消さず、置き換えは公式CLIが行う。" +
+        "Codexの公式ログインは、始めた時点で元のログインを消す（途中でcancelしても戻らない）。",
     inputSchema: {
         harness: z.enum(["claude-code", "codex-cli", "grok-cli", "cursor-cli"]),
         action: z.enum(["start", "status", "cancel"]),
         session_id: z.string().regex(/^[A-Za-z0-9_-]{1,64}$/).optional(),
         cwd: z.string().optional().describe("公式CLIを実行する作業ディレクトリの絶対パス"),
         env_vars: z.array(z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/)).optional().describe("startで認証PTYへ引き継ぐ環境変数名。値はreceiptへ返さない"),
+        relogin: z.boolean().optional().describe("startで、公式の状態が認証済みでも公式ログインを開始する。既定false。trueの時、authenticatedかつsession_idがnullの結果は返さない"),
     },
     outputSchema: {
         schema: z.literal("aiterm.agent-auth-result.v1"),

package/dist/parent-hook-diagnostic.js

@@ -40,21 +40,15 @@ export function claudeParentHookDiagnostic(file) {
         return unreadable;
     if (settings.disableAllHooks === true)
         return required("hooks_disabled");
-    const entry = AITERM_PROFILE.hooks.claude;
-    const owned = (value) => value === entry || value.endsWith(`/${entry}`) || value.endsWith(`\\${entry}`);
-    const scripts = [];
-    for (const event of Object.keys(steer.claudeParentHookEntries(AITERM_PROFILE, { command: "", script: entry }))) {
+    // 登録の形（0.52.2までの`args`形式と、今のshellを通す1行）は配送ライブラリが読む。ここで`args`を直接読まない。
+    for (const event of Object.keys(steer.claudeParentHookEntries(AITERM_PROFILE, { command: "", script: AITERM_PROFILE.hooks.claude }))) {
         const groups = settings.hooks[event];
         if (groups !== undefined && !Array.isArray(groups))
             return unreadable;
-        const found = (groups ?? []).flatMap(group => record(group) && Array.isArray(group.hooks) ? group.hooks : [])
-            .filter(hook => record(hook) && hook.type === "command" && Array.isArray(hook.args) && typeof hook.args[0] === "string" && owned(hook.args[0]))
-            .map(hook => hook.args[0]);
-        if (found.length === 0)
-            return required("hooks_not_registered");
-        scripts.push(...found);
     }
-    return scripts.every(script => existsSync(script)) ? ready : required("hook_script_missing");
+    if (!steer.claudeParentHooksRegistered(AITERM_PROFILE, settings))
+        return required("hooks_not_registered");
+    return steer.claudeParentHookScripts(AITERM_PROFILE, settings).every(script => existsSync(script)) ? ready : required("hook_script_missing");
 }
 export function cursorParentHookDiagnostic(file) {
     const document = readSettings(file);

package/docs/DESIGN.md

@@ -186,6 +186,11 @@ hookはNodeの実行ファイルと引数配列で直接起動し、shellやWind
 子の予約は既存の`parent-deliveries/claims`で共有し、親の種類をまたぐ並行送信を防ぐ。
 hookとの受け渡しはAiterm stateの`claude-parent-hooks`へ置く。
 
+hookの登録は、`args`を使わずshellを通す1行で書く（ADR 0089）。POSIXは`exec '<node>' '<hook>'`、Windowsは
+`& '<node>' '<hook>'; exit (Get-Variable LASTEXITCODE -ValueOnly)`と`shell: "powershell"`。同じ設定をGrokも読み、
+`args`を落として`command`だけを動かすためである。Grokから起こされたhookは何もせず0で終わる。
+PreToolUseのhookは、間に挟まるshellを飛ばして、Claude Code本体を依頼元のprocessとして記録する。
+
 `PostToolUse`は`asyncRewake:true`で待機し、保存済み本文をstderrへ出してexit 2を返す。
 exit 2はClaudeが規定する再開信号であり、子の成功・失敗は本文の`outcome`で区別する。
 親は待機中も別作業や次のturnへ進める。Claudeの画面では`Stop hook feedback`として届く。
@@ -288,7 +293,10 @@ shell、接続先、各harnessの公式CLIが所有する。
 
 PTYが消失した場合は、相関記録の有無にかかわらず`status`が`failed`、`cancel`が既に終了・取消済みを示す`blocked`を返し、どちらも`session_id:null`となる。保存したsession IDを解除して`start`で再開始できる。生存中の通常PTYやharness不一致、記録の破損・読取り失敗はエラーを返す。
 
-Claude／Codex／Cursorは公式statusを照合する。Grokは公式status commandが無いため、認証sessionの公式login exit 0を正本にし、session無しの確認を`blocked`とする。Claudeはlogin完了後に同じPTYへ公式の初回TUIを用意し、初回案内の入力待ちを`blocked`／`input_required:true`へ写す。認証とlauncherの起動準備は別の結果であり、`agent_launch`のready gateを省略しない。
+Claude／Codex／Cursorは公式statusを照合する。Grokは公式status commandが無いため、`grok models`が`You are not authenticated.`と答えるかで見る（ADR 0090）。auth fileの存在は見ない。
+Codexの`codex login status`は`auth.json`の有無だけを答え、ログインの期限が切れた後も「Logged in」を返す。「Logged in」の時は、公式App Serverへ`getAuthStatus`（`refreshToken:false`）、`account/read`の順に聞き、`account`が`null`なら未認証とする。App Serverを起こす環境は、認証sessionへ引き継いだ環境を使う。
+Cursorの公式statusが`unable to fetch user details`を返す時は、認証済みとせず`failed`とする。Claudeの期限切れは、公式statusからは見抜けない。
+`start`の`relogin:true`は、今の状態を聞かずに公式ログインを始める。資格情報を消す処理は持たない。Claudeはlogin完了後に同じPTYへ公式の初回TUIを用意し、初回案内の入力待ちを`blocked`／`input_required:true`へ写す。認証とlauncherの起動準備は別の結果であり、`agent_launch`のready gateを省略しない。
 
 公開receiptは`aiterm.agent-auth-result.v1`で、公式HTTPS URLと明示device codeだけを抽出する。生の画面本文・credential・token・OAuth callback codeは含めない。人の入力は既存の`pty_send`／`pty_key`で同じPTYへ送る。`remote`は標準のremote tool中継を使い、callerはCLI commandや環境ごとの入力方言を組み立てない。
 

package/docs/RELEASE.md

@@ -83,8 +83,9 @@ aiterm-setup --json
 互換launcherを共有していた場合はAitermのSteer選択だけを解除し、所有外の起動設定を保持する。
 回答record schemaは従来と共通であり、新方式のSteer相当配送も`queued_submission_id`を保持する。
 
-Claude親配送hookのない旧版へ戻す場合は、旧版のinstall前に`aiterm-setup --remove-claude-parent-hooks`を
-実行する。Aiterm専用の3 hookだけを解除し、他製品のhookと設定を保持する。
+Claude親配送hookのない旧版、または0.52.2以前へ戻す場合は、旧版のinstall前に`aiterm-setup --remove-claude-parent-hooks`を
+実行する。Aiterm専用の3 hookだけを解除し、他製品のhookと設定を保持する。0.52.2以前は、shellを通す1行の登録（ADR 0089）を
+自分の物と数えず、もう1組を足す。
 
 ```bash
 npm install -g "aiterm-mcp@<known-good-version>"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.52.2",
+  "version": "0.53.0",
   "mcpName": "io.github.kitepon/aiterm-mcp",
   "description": "Persistent terminal MCP with one harness-based launcher for Claude Code, Codex CLI, Grok CLI, and Cursor Agent CLI, plus durable PTYs for SSH, containers, and REPLs.",
   "keywords": [
@@ -71,7 +71,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "aiterm-steer-delivery": "^0.1.12",
+    "aiterm-steer-delivery": "^0.2.1",
     "ws": "8.21.3",
     "zod": "^4.4.3"
   },