aiterm-mcp 0.46.0 → 0.46.1

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.46.1] - 2026-10-02
+
+### 修正
+
+- 認証PTYが閉じられた、またはbackend再起動で失われた場合、`agent_auth`の`status`は`failed`、`cancel`は取消済みの`blocked`を返し、`session_id:null`で再開始できる。通常PTY・harness不一致・記録の破損や読取り失敗は引き続きエラーとする。
+
 ## [0.46.0] - 2026-10-02
 
 ### 追加
@@ -1958,7 +1964,8 @@ 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.46.0...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.46.1...HEAD
+[0.46.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.46.0...v0.46.1
 [0.46.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.45.2...v0.46.0
 [0.45.2]: https://github.com/kitepon/aiterm-mcp/compare/v0.45.1...v0.45.2
 [0.45.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.45.0...v0.45.1

package/README.ja.md

@@ -203,7 +203,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.46.0** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.46.1** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -556,6 +556,8 @@ consumer は `aiterm-runtime-errors snapshot` を読み、durable ingestion 後
 
 Grokには公式認証status commandが無いため、session付きの確認は公式loginのexit 0を正本にし、session無しの確認は`blocked`を返す。他harnessは公式statusも照合する。Claudeは認証後の公式初回案内を同じsessionで進め、選択待ちは`blocked`／`input_required:true`で返す。`authenticated`は認証結果であり、`agent_launch`の起動準備完了は別途確認する。`cancel`は指定した認証sessionだけを閉じ、資格情報を削除しない。
 
+PTYが消失した場合は、相関記録の有無にかかわらず`status`が`failed`、`cancel`が既に終了・取消済みを示す`blocked`を返し、どちらも`session_id:null`となる。保存したsession IDを解除して`start`で再開始できる。生存中の通常PTYやharness不一致、記録の破損・読取り失敗はエラーを返す。
+
 `agent_models({ harness, cwd?, include_hidden? })`は、導入済みのharnessが今選べるmodel IDとreasoning effortを返す。画面の候補を、実際にagentを動かす端末の一覧から作れる。各harness自身の一覧を読むだけで、promptもturnも送らない。
 
 | `harness` | 取得元 | 補足 |

package/README.md

@@ -217,7 +217,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.46.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).
+**Status:** actively maintained · current public release **v0.46.1** · 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
 
@@ -591,6 +591,8 @@ Consumer flow is `aiterm-runtime-errors snapshot`, then `aiterm-runtime-errors a
 
 Grokには公式認証status commandが無いため、session付きの確認は公式loginのexit 0を正本にし、session無しの確認は`blocked`を返す。他harnessは公式statusも照合する。Claudeは認証後の公式初回案内を同じsessionで進め、選択待ちは`blocked`／`input_required:true`で返す。`authenticated`は認証結果であり、`agent_launch`の起動準備完了は別途確認する。`cancel`は指定した認証sessionだけを閉じ、資格情報を削除しない。
 
+PTYが消失した場合は、相関記録の有無にかかわらず`status`が`failed`、`cancel`が既に終了・取消済みを示す`blocked`を返し、どちらも`session_id:null`となる。保存したsession IDを解除して`start`で再開始できる。生存中の通常PTYやharness不一致、記録の破損・読取り失敗はエラーを返す。
+
 `agent_models({ harness, cwd?, include_hidden? })` returns the model IDs and reasoning efforts the installed harness offers right now, so a UI can build its choices from the machine that actually runs the agents. It reads each harness's own catalog and never sends a prompt or starts a turn:
 
 | `harness` | Source | Notes |

package/dist/core.js

@@ -3372,13 +3372,26 @@ function authPane(meta, screen) {
     }
 }
 function loadAuthMetadata(name, kind) {
+    let source;
+    try {
+        source = fs.readFileSync(authMetadataPath(name), "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return null;
+        throw error;
+    }
     let value;
     try {
-        value = JSON.parse(fs.readFileSync(authMetadataPath(name), "utf8"));
+        value = JSON.parse(source);
     }
-    catch {
-        throw new AitermError("AGENT_AUTH_SESSION_NOT_FOUND: 指定sessionはAitermの認証sessionではありません。", 2);
+    catch (error) {
+        if (error instanceof SyntaxError)
+            throw new AitermError("AGENT_AUTH_STATE_INVALID: 認証sessionの記録が不正です。", 2);
+        throw error;
     }
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new AitermError("AGENT_AUTH_STATE_INVALID: 認証sessionの記録が不正です。", 2);
     if (value.kind !== kind)
         throw new AitermError("AGENT_AUTH_HARNESS_MISMATCH: 認証sessionのharnessが一致しません。", 2);
     if (typeof value.bin !== "string" || typeof value.cwd !== "string" || !path.isAbsolute(value.cwd)
@@ -3388,6 +3401,10 @@ function loadAuthMetadata(name, kind) {
     }
     return value;
 }
+/** 一覧の取得失敗を端末の消失へ丸めず、正規PTY一覧で存在を確認する。 */
+function authSessionExists(name) {
+    return listSessionsResult().sessions.some(session => session.session_id === name);
+}
 function authSessionEnvironment(name, keys) {
     const env = { ...process.env };
     for (const key of keys) {
@@ -3417,7 +3434,14 @@ export async function authenticateAgent(kind, options) {
     if (options.action === "cancel") {
         if (!options.session_id)
             throw new AitermError("AGENT_AUTH_SESSION_REQUIRED: cancelにはsession_idが必要です。", 2);
-        loadAuthMetadata(options.session_id, kind);
+        const meta = loadAuthMetadata(options.session_id, kind);
+        if (!authSessionExists(options.session_id)) {
+            if (meta)
+                fs.unlinkSync(authMetadataPath(options.session_id));
+            return result("blocked", null, "認証sessionは既に終了または取消済みです。");
+        }
+        if (!meta)
+            throw new AitermError("AGENT_AUTH_SESSION_NOT_FOUND: 指定sessionはAitermの認証sessionではありません。", 2);
         closeSession(options.session_id);
         return result("blocked", null, "認証sessionを取り消しました。");
     }
@@ -3461,13 +3485,19 @@ export async function authenticateAgent(kind, options) {
         const checked = 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
-        meta = loadAuthMetadata(name, kind);
+    else {
+        const loaded = loadAuthMetadata(name, kind);
+        if (!authSessionExists(name))
+            return result("failed", null, "認証sessionが失われました。agent_authのstartで開始してください。");
+        if (!loaded)
+            throw new AitermError("AGENT_AUTH_SESSION_NOT_FOUND: 指定sessionはAitermの認証sessionではありません。", 2);
+        meta = loaded;
+    }
     const session = name;
     const deadline = performance.now() + (options.action === "start" ? 3000 : 0);
     for (;;) {
-        if (!sessionExists(session))
-            return result("failed", session, "認証sessionが終了観測前に失われました。");
+        if (!authSessionExists(session))
+            return result("failed", null, "認証sessionが失われました。agent_authのstartで開始してください。");
         const observed = tmux("display-message", "-p", "-t", session, "#{pane_dead}\t#{pane_dead_status}");
         if (observed.code !== 0)
             return result("failed", session, "認証processの終了状態を取得できません。");

package/docs/DESIGN.md

@@ -248,6 +248,8 @@ shell、接続先、各harnessの公式CLIが所有する。
 
 `agent_auth`の共通進行はcore、公式command・status・認証画面の解釈は`src/harnesses/`が所有する。CLIの認証processを通常HOMEのPTYへ一度だけ起動し、`remain-on-exit`と`pane_dead_status`で終了を観測する。credentialを読み取る状態管理や独自OAuthは持たず、Aitermが保存するのは認証sessionのharness・実行file・cwd・phase・引き継いだenvの名前だけである。取消と通常のPTY closeでこの相関記録を削除する。
 
+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を省略しない。
 
 公開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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.46.0",
+  "version": "0.46.1",
   "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": [