aiterm-mcp 0.57.1 → 0.57.3

package/CHANGELOG.md

@@ -7,6 +7,56 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.57.3] - 2026-10-08
+
+### 修正
+
+- Codexの席で、入力欄の`/new`・`/clear`で会話が切り替わった後、完了待ちが完了を拾えずに時間切れになっていた件を直す（ADR 0105）。
+  Codexは、processを生かしたまま、新しい会話を別の記録（rollout）へ書く。Aitermは最初の会話の記録を見続けていたので、
+  切り替えた後のturnは完了が届かず、回答の読み出しは前の会話の回答を返していた。席を閉じるまで直らなかった。
+  - 今の会話の記録を、結び付けた会話より後に書かれた、同じ起動の印を持つ派生でないroot会話（`codex-tui`・`cli`）から決める。
+  - 新しいturnを送る時に、席の`vendor_session_id`を今の会話へ結び付け直す。完了待ちは、読み始めた記録が3秒増えない時に今の会話を見直す。
+  - 引数、返りの形、断りの文面、会話が切り替わっていない席の読みは変えていない。BellTeamは席へ命令を打たないので、動きは変わらない。
+  - 切り替えた後の最初のturnでは、合間の言葉は出ず、完了は最長で3秒遅れる。派生させた会話（`/fork`）は追わない。
+  - 手で打った`/compact`の途中に届いた文が、差し込みで返るのにCodexでは後の別のturnになる件は、直していない（理由はADR 0105）。
+    自動の圧縮の途中に届いた文は、同じturnへ入る事を実物で確かめた。
+
+- Cursorのturnが誤りで終わった時、完了待ちが`done`を返していた件を直す（ADR 0106）。
+  Cursorは、記録の`turn_ended`へ`status: "error"`と文を書く。Aitermは`status`を見ていなかったので、呼んだ側に、
+  失敗が、空の（または途中までの）回答の完了として届いていた。Codexで0.57.2に直したのと同じ形。
+  - サービスの誤り（`[unavailable] Error`など）: `outcome: "error"`。`aiterm-wait`はexit 7。`error`は1行の文、
+    文の頭の角括弧の名前を`error_kind`で返す。
+  - 利用上限の文: `outcome: "rate_limited"`。画面から読めた時と同じ返りに揃える。
+  - 席で止めたturn（`User aborted request`）と、`status: "success"`は、今までどおり`done`。
+  - 引数、断りの文面、送信の振り分け、ほかの席は変えていない。
+
+### Tests
+
+- 試験の前処理（`test/seat-env.mjs`）が作る置き場（`/tmp/at-*`）を、試験processの終わりに消す（ADR 0104）。
+  今までは誰も消しておらず、全部の試験を1回流すと約100個残っていた。つながるtmuxのserverが残っている置き場は消さず、場所を標準エラーへ書く。
+  製品の動きは変えない。
+- `test/codex-relay-official.test.mjs`を、対象のOS（macOSとWindows）でだけ流す。Linuxで公式のCodexの実行ファイルを指定すると、
+  対象でない確かめ（`ps`の`comm=`、socketの確かめ）で2件落ちていた。
+- `test/claude-exit-before-close.test.mjs`の2件を、席を閉じた0.3秒後に記録を読む形から、切断の合図の記録が出るまで待つ形へ直す。
+  混んだmacOSのCIで、記録が0.3秒より遅れて1件落ちた。
+
+## [0.57.2] - 2026-10-07
+
+### 修正
+
+- Codexのturnがサービスの誤りや通信の失敗（HTTP 500・401・途中で切れる応答など）で終わった時、完了待ちが`done`・空の回答を返していた件を直す（ADR 0103）。
+  Codexは、この時も記録へ`task_complete`を書く（回答は無く、`error`が付く）。Aitermは利用上限だけを`rate_limited`に分けていたので、
+  ほかの失敗は、呼んだ側に、空の回答の完了として届いていた。
+  - 完了待ちは`outcome: "error"`を返す。`aiterm-wait`はexit 7、親への配送は`outcome=error`。
+  - `error`は、応答の本文とURLを落とした1行の文にする（例「unexpected status 401 Unauthorized」）。
+  - Codexが記録した種類（`internal_server_error`・`http_connection_failed`など）を、新しい項目`error_kind`で返す。ほかの席と、`error`でない返りでは`null`。
+  - 合間の言葉（`kind: "error"`）も、利用上限のほかは同じ1行にする。
+  - 引数、`done`と`rate_limited`の返り、断りの文面、Claude Code・Grok・Cursorの席は変えていない。
+
+### 文書
+
+- 通信の失敗・取消・待ちの時間切れを実行時エラーとして記録しない事と、重さの決め方を、決まりとして書く（ADR 0102）。動きは変えない。
+
 ## [0.57.1] - 2026-10-07
 
 ### 修正
@@ -2380,7 +2430,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.57.1...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.57.3...HEAD
+[0.57.3]: https://github.com/kitepon/aiterm-mcp/compare/v0.57.2...v0.57.3
+[0.57.2]: https://github.com/kitepon/aiterm-mcp/compare/v0.57.1...v0.57.2
 [0.57.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.57.0...v0.57.1
 [0.57.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.56.1...v0.57.0
 [0.56.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.56.0...v0.56.1

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.57.1** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.57.3** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -259,6 +259,9 @@ pty_read(id, { wait: true })       → 削減済みの出力を読む（完了
 
 ClaudeがAPIエラーや安全判定の拒否で終了した時は、Stop hookが発火しなくても次の`pty_send`を新しいturnとして扱う。現在のturn開始後のエラー記録だけを確認し、過去のエラーで実行中のturnを解除しない。上流の拒否はエラーのまま返す。
 
+Codexがサービスの誤りや通信の失敗でturnを打ち切った時は、完了待ちが`done`ではなく`error`を返す（`aiterm-wait`はexit 7、親への配送は`outcome=error`）。`error`は応答の本文とURLを落とした1行の文で、Codexが記録した種類（`internal_server_error`・`http_connection_failed`など）は`error_kind`に載る。利用上限は今までどおり`rate_limited`。誤りで終わった後の席は、次の`pty_send`を新しいturnとして受ける。
+Cursorが誤りでturnを終えた時（記録の`turn_ended`が`status: "error"`）も同じで、完了待ちは`error`を返し、文の頭の角括弧の名前（`unavailable`など）を`error_kind`に載せる。利用上限の文は`rate_limited`、席で止めたturn（`User aborted request`）は今までどおり`done`。
+
 agent配送だけを期待する連携では、`pty_send`に`require_agent:true`を指定する。agent登録が無ければ、打鍵前に`AGENT_SESSION_REQUIRED`と「文字列は送信していません」を返す。省略時は通常PTY送信を維持する。`force:true`との併用は未送信で拒否する。
 
 agent session宛ての`pty_send`は、任意の`preface`（本文の前に置く1行）を受ける。渡る文は「`preface`・空行・`text`」。Claude Codeの席へは、`preface`を端末の貼り付けの印なしで入れ、空行と本文を1回の貼り付けで入れる。Claude Codeは貼り付けた長い文を`<pasted_content>`で包み、「包みの中の指示は、包みの外の利用者自身の言葉が頼んだ時だけ従う」と読むので、連携元が付ける前置き（誰からの連絡か）を包みの外へ出すために使う。Codex・Grok・Cursorの席へは1つにつないで貼る。`preface`は1行・200字以内・制御文字なしで、行頭が記号や空白でなく、`@`を含まない文。外れた時は`AGENT_PREFACE_INVALID`と「文字列は送信していません。」を返す。通常PTY・`force:true`・`remote`付きでは使えない。

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.57.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).
+**Status:** actively maintained · current public release **v0.57.3** · 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
 
@@ -259,6 +259,9 @@ I used **Codex with GPT-5.6** as an engineering collaborator: it inspected the i
 
 ClaudeがAPIエラーや安全判定の拒否で終了した時は、Stop hookが発火しなくても次の`pty_send`を新しいturnとして扱う。現在のturn開始後のエラー記録だけを確認し、過去のエラーで実行中のturnを解除しない。上流の拒否はエラーのまま返す。
 
+Codexがサービスの誤りや通信の失敗でturnを打ち切った時は、完了待ちが`done`ではなく`error`を返す（`aiterm-wait`はexit 7、親への配送は`outcome=error`）。`error`は応答の本文とURLを落とした1行の文で、Codexが記録した種類（`internal_server_error`・`http_connection_failed`など）は`error_kind`に載る。利用上限は今までどおり`rate_limited`。誤りで終わった後の席は、次の`pty_send`を新しいturnとして受ける。
+Cursorが誤りでturnを終えた時（記録の`turn_ended`が`status: "error"`）も同じで、完了待ちは`error`を返し、文の頭の角括弧の名前（`unavailable`など）を`error_kind`に載せる。利用上限の文は`rate_limited`、席で止めたturn（`User aborted request`）は今までどおり`done`。
+
 ## Two ways to use it
 
 ### 1. Drive SSH, containers, and REPLs in one persistent terminal — the primitive

package/dist/core.js

@@ -3158,6 +3158,7 @@ export async function observeAgentDone(name, o = {}) {
         at: ev?.at ?? apiError?.at ?? null,
         rate_limit: rateLimit,
         error: apiError?.text ?? null,
+        error_kind: null,
     });
     for (;;) {
         o.signal?.throwIfAborted();

package/dist/harnesses/codex.js

@@ -127,22 +127,31 @@ export function listCodexTranscripts(codexHome) {
     visit(sessionsDir);
     return files.sort();
 }
-export function codexTranscriptMatchesLaunch(file, meta) {
+/**
+ * rolloutがこの起動のroot会話かを、頭の1MBから読む。
+ * - match: Codex CLIのroot会話で、developerの文にこの起動の印がある。
+ * - other: root会話でない。または、最初のturnの文脈（turn_context）まで書かれているのに印が無い。後から変わらない。
+ * - undecided: 書いている途中などで、まだ決められない。
+ * forkedは、ほかの会話から派生した会話（session_metaのforked_from_id）か。派生は元の会話の文を写すので、印だけでは持ち主を決められない。
+ */
+function codexLaunchVerdict(file, meta) {
     const createdAt = Date.parse(meta.created_at);
     try {
         const st = fs.statSync(file);
         if (Number.isFinite(createdAt) && st.mtimeMs + 5_000 < createdAt)
-            return false;
+            return { verdict: "other", forked: false };
     }
     catch {
-        return false;
+        return { verdict: "undecided", forked: false };
     }
     const size = Math.min(safeStatSize(file), 1024 * 1024);
     if (size === 0)
-        return false;
+        return { verdict: "undecided", forked: false };
     const marker = `AITERM_AGENT_LAUNCH_ID=${meta.launch_id}`;
     let rootCli = false;
+    let forked = false;
     let launchMarker = false;
+    let firstTurnContext = false;
     for (const line of readFileRange(file, 0, size).toString("utf8").split("\n")) {
         if (!line.trim())
             continue;
@@ -156,8 +165,11 @@ export function codexTranscriptMatchesLaunch(file, meta) {
         if (record?.type === "session_meta") {
             rootCli = record?.payload?.originator === "codex-tui" && record?.payload?.source === "cli";
             if (!rootCli)
-                return false;
+                return { verdict: "other", forked: false };
+            forked = typeof record?.payload?.forked_from_id === "string" && record.payload.forked_from_id !== "";
         }
+        if (record?.type === "turn_context")
+            firstTurnContext = true;
         if (record?.type === "response_item" &&
             record?.payload?.type === "message" &&
             record?.payload?.role === "developer" &&
@@ -167,9 +179,12 @@ export function codexTranscriptMatchesLaunch(file, meta) {
                 item.text.includes(marker));
         }
         if (rootCli && launchMarker)
-            return true;
+            return { verdict: "match", forked };
     }
-    return false;
+    return { verdict: rootCli && firstTurnContext ? "other" : "undecided", forked };
+}
+export function codexTranscriptMatchesLaunch(file, meta) {
+    return codexLaunchVerdict(file, meta).verdict === "match";
 }
 export function codexTranscriptSessionId(file) {
     const size = Math.min(safeStatSize(file), AGENT_EVENT_TAIL_BYTES);
@@ -191,11 +206,96 @@ export function codexTranscriptSessionId(file) {
     }
     return null;
 }
+/** rolloutのfile名にある会話ID（UUIDv7）と、そこに入っている作成時刻（ms）。v7でなければnull。 */
+function codexRolloutCreation(file) {
+    const id = /-([0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})\.jsonl$/.exec(path.basename(file))?.[1];
+    return id ? { id, ms: Number.parseInt(id.slice(0, 8) + id.slice(9, 13), 16) } : null;
+}
+// 起動ごとの、rolloutの判定の控え（file → この起動の会話か）。頭の読み直しを避ける。決められなかったfileは入れない。
+const CODEX_LAUNCH_VERDICT_MEMO_MAX = 64;
+const codexLaunchVerdictMemo = new Map();
+function codexLaunchVerdictMemoFor(launchId) {
+    let memo = codexLaunchVerdictMemo.get(launchId);
+    if (!memo) {
+        if (codexLaunchVerdictMemo.size >= CODEX_LAUNCH_VERDICT_MEMO_MAX) {
+            codexLaunchVerdictMemo.delete(codexLaunchVerdictMemo.keys().next().value);
+        }
+        memo = new Map();
+        codexLaunchVerdictMemo.set(launchId, memo);
+    }
+    return memo;
+}
+/** 結び付けた会話（vendor_session_id）のroot rollout。会話の切り替えは追わない。完了の読み位置（cursor）はこのfileの位置。 */
+export function codexBoundTranscript(meta) {
+    if (meta.kind !== "codex" || !meta.codex_home || !meta.vendor_session_id)
+        return null;
+    return findLatestCodexTranscript(meta.codex_home, meta.vendor_session_id);
+}
+/**
+ * 結び付けた会話より後に書かれた、この起動の別の会話のroot rollout。無ければnull（ADR 0105）。
+ * Codexは、入力欄の /new・/clear で、processを生かしたまま新しい会話（別のrollout）へ移る。古いrolloutには何も書かない。
+ * 新しい会話の候補は、次を全部満たすrolloutだけ。
+ * - 会話IDがUUIDv7で、その作成時刻がこの席の起動より後。
+ * - 結び付けた会話のrolloutより後に書かれている（mtime）。
+ * - Codex CLIのroot会話で、派生（forked_from_id）でなく、developerの文にこの起動の印がある。
+ *   印は起動時に渡したdeveloper_instructionsから来るので、派生でない会話が持つなら、この席のprocessが始めた会話。
+ *   派生は元の会話の文を写すので、別の端末で派生させた会話を拾わないよう、追わない。
+ * 候補が複数なら、最後に書かれた物。
+ */
+function codexSwitchedTranscript(meta, bound) {
+    if (!meta.codex_home || meta.hook_route !== "shared_codex_home")
+        return null;
+    const launchedAt = Date.parse(meta.created_at);
+    if (!Number.isFinite(launchedAt))
+        return null;
+    let boundMtime;
+    try {
+        boundMtime = fs.statSync(bound).mtimeMs;
+    }
+    catch {
+        return null;
+    }
+    const memo = codexLaunchVerdictMemoFor(meta.launch_id);
+    let latest = null;
+    let latestMtime = boundMtime;
+    for (const file of listCodexTranscripts(meta.codex_home)) {
+        if (file === bound || memo.get(file) === false)
+            continue;
+        const creation = codexRolloutCreation(file);
+        if (!creation || creation.ms + 5_000 < launchedAt)
+            continue;
+        let mtime;
+        try {
+            mtime = fs.statSync(file).mtimeMs;
+        }
+        catch {
+            continue;
+        }
+        if (mtime <= latestMtime)
+            continue;
+        let own = memo.get(file);
+        if (own === undefined) {
+            const { verdict, forked } = codexLaunchVerdict(file, meta);
+            if (verdict === "undecided")
+                continue;
+            own = verdict === "match" && !forked;
+            memo.set(file, own);
+        }
+        if (!own)
+            continue;
+        latest = file;
+        latestMtime = mtime;
+    }
+    return latest;
+}
+/** この起動の、今の会話のroot rollout。結び付けた会話から、同じprocessの新しい会話へ移っていれば、新しい方。 */
 export function codexRootTranscript(meta) {
     if (meta.kind !== "codex" || !meta.codex_home)
         return null;
-    if (meta.vendor_session_id)
-        return findLatestCodexTranscript(meta.codex_home, meta.vendor_session_id);
+    if (meta.vendor_session_id) {
+        const bound = findLatestCodexTranscript(meta.codex_home, meta.vendor_session_id);
+        return bound ? codexSwitchedTranscript(meta, bound) ?? bound : null;
+    }
     if (meta.hook_route === "shared_codex_home") {
         const matches = listCodexTranscripts(meta.codex_home).filter((file) => codexTranscriptMatchesLaunch(file, meta));
         if (matches.length > 1) {
@@ -205,12 +305,22 @@ export function codexRootTranscript(meta) {
     }
     return listCodexTranscripts(meta.codex_home)[0] ?? null;
 }
+/** rolloutの会話ID。結び付けた会話のrolloutならそのID、会話が切り替わった後のrolloutなら、その頭に書かれたID。 */
+function codexRolloutSessionId(meta, transcript) {
+    if (meta.vendor_session_id && path.basename(transcript).includes(meta.vendor_session_id))
+        return meta.vendor_session_id;
+    return codexTranscriptSessionId(transcript) ?? codexRolloutCreation(transcript)?.id ?? meta.vendor_session_id;
+}
+/**
+ * 今の会話のroot rolloutを返し、席の登録の会話ID（vendor_session_id）をその会話へ合わせる。
+ * 会話が切り替わっていた時は、ここで結び付け直す。呼ぶのは席の持ち主（送信の道）だけ。完了待ちは書かない。
+ */
 export function bindCodexTranscriptSession(meta) {
     const transcript = codexRootTranscript(meta);
     if (!transcript)
         return null;
-    const harnessSessionId = codexTranscriptSessionId(transcript);
-    if (harnessSessionId && !meta.vendor_session_id) {
+    const harnessSessionId = meta.vendor_session_id ? codexRolloutSessionId(meta, transcript) : codexTranscriptSessionId(transcript);
+    if (harnessSessionId && meta.vendor_session_id !== harnessSessionId) {
         meta.vendor_session_id = harnessSessionId;
         writeAgentMetadata(meta);
     }
@@ -254,6 +364,16 @@ export function codexTurnError(record) {
         return null;
     return { message: message || info, info };
 }
+// 呼んだ側の画面にそのまま出る1行の文。Codexの文は、応答の本文・URLを含む事がある
+// （実物 2026-10-07、codex 0.160.1: "unexpected status 401 Unauthorized: <応答の文>, url: http://…/v1/responses"）。
+// 「unexpected status」はHTTPの状態までで切り、ほかの文はURLを伏せる。改行は畳み、長さを切る。
+const CODEX_ERROR_LINE_MAX = 200;
+export function codexTurnErrorLine(error) {
+    const flat = error.message.replace(/\s+/g, " ").trim();
+    const status = /^unexpected status (\d{3}(?: [A-Za-z][A-Za-z' -]*)?)/.exec(flat);
+    const text = status ? `unexpected status ${status[1].trim()}` : flat.replace(/https?:\/\/[^\s)\]>"']+/gi, "…");
+    return text.length > CODEX_ERROR_LINE_MAX ? `${text.slice(0, CODEX_ERROR_LINE_MAX - 1)}…` : text;
+}
 // 利用上限はtask_completeのcodex_error_infoで見分ける。token_countのused_percentは100%のまま
 // 返事が続くことがある（macbookの実記録で7千件以上）ので上限の印にしない。
 // rate_limit_exceededは短い間の混雑で、Codexが自分で再試行するので上限に数えない。
@@ -261,6 +381,8 @@ export function codexUsageLimit(record) {
     const error = codexTurnError(record);
     return error?.info === "usage_limit_exceeded" ? error.message : null;
 }
+// 完了待ちが、会話の切り替えを確かめる間隔。送った文はすぐ記録へ書かれるので、普通のturnはここへ来ない。
+const CODEX_SWITCH_CHECK_MS = 3_000;
 /**
  * この起動のroot rolloutの、末尾から見て最初のturnの境界。
  * Codexはturnの開始でtask_started、終わりでtask_complete、止めた時はturn_aborted（reasonはinterrupted）を書く（0.160.1の実記録）。
@@ -322,7 +444,7 @@ export function latestCodexCompletion(meta, readTranscriptLines) {
     const transcript = codexRootTranscript(meta);
     if (!transcript)
         return null;
-    const harnessSessionId = meta.vendor_session_id ?? codexTranscriptSessionId(transcript);
+    const harnessSessionId = codexRolloutSessionId(meta, transcript);
     let latest = null;
     for (const line of readTranscriptLines(transcript)) {
         if (!line.trim())
@@ -338,15 +460,21 @@ export function latestCodexCompletion(meta, readTranscriptLines) {
 }
 export async function observeCodexDone(meta, timeout, requestedCursor, signal) {
     const metadataFile = agentMetadataPath(meta.aiterm_session, meta.launch_id);
-    let transcript = codexRootTranscript(meta);
-    const startOffset = requestedCursor ?? (transcript ? safeStatSize(transcript) : 0);
+    // 読み位置（cursor）は、送った時に結び付いていた会話のrolloutの位置。結び付けが済んだ席は、そのrolloutから読み始める。
+    const anchored = () => meta.vendor_session_id ? codexBoundTranscript(meta) : codexRootTranscript(meta);
+    let transcript = anchored();
+    let startOffset = requestedCursor ?? (transcript ? safeStatSize(transcript) : 0);
     let cursor = startOffset;
     let carry = "";
     let malformedEvents = 0;
     let discardLeadingFragment = false;
     let initializedBoundary = false;
+    // 待ち始めてからrolloutが1行も増えない時、会話が切り替わっていないかを見る時刻（ADR 0105）。
+    let switchCheckAt = performance.now() + CODEX_SWITCH_CHECK_MS;
+    // 切り替わった後の会話では、前の会話の最後の書き込みより後の完了だけを数える。
+    let completedAfter = null;
     const deadline = performance.now() + timeout * 1000;
-    const observation = (outcome, ev = null, rateLimit = null) => ({
+    const observation = (outcome, ev = null, rateLimit = null, failed = null) => ({
         schema: "aiterm.agent-wait-result.v1",
         session_id: meta.aiterm_session,
         launch_id: meta.launch_id,
@@ -359,13 +487,44 @@ export async function observeCodexDone(meta, timeout, requestedCursor, signal) {
         malformed_events: malformedEvents,
         at: ev?.at ?? null,
         rate_limit: rateLimit,
-        error: null,
+        error: failed ? codexTurnErrorLine(failed) : null,
+        error_kind: failed?.info ?? null,
     });
     for (;;) {
         signal?.throwIfAborted();
         if (!fs.existsSync(metadataFile))
             return observation("closed");
-        transcript ??= codexRootTranscript(meta);
+        transcript ??= anchored();
+        if (transcript && meta.vendor_session_id && cursor === startOffset && performance.now() >= switchCheckAt) {
+            switchCheckAt = performance.now() + CODEX_SWITCH_CHECK_MS;
+            let current = null;
+            try {
+                current = codexRootTranscript(meta);
+            }
+            catch { /* 読めない時は、今のrolloutを見続ける */ }
+            if (current && current !== transcript && safeStatSize(transcript) === cursor) {
+                // 送った後に、同じprocessの新しい会話へ移っていた。送る時に無かった会話なので、前の会話の最後の書き込みより後の記録が今回の分。
+                // 読み位置を指定せずに待ち始めた時は、今までどおり、今より後の完了を待つ。
+                const size = safeStatSize(current);
+                if (requestedCursor == null) {
+                    cursor = size;
+                }
+                else {
+                    try {
+                        completedAfter = fs.statSync(transcript).mtimeMs;
+                    }
+                    catch {
+                        completedAfter = null;
+                    }
+                    cursor = Math.max(0, size - CODEX_TRANSCRIPT_INCREMENT_MAX_BYTES);
+                }
+                transcript = current;
+                startOffset = cursor;
+                carry = "";
+                initializedBoundary = false;
+                discardLeadingFragment = false;
+            }
+        }
         if (transcript) {
             if (!initializedBoundary) {
                 if (cursor > 0) {
@@ -390,7 +549,7 @@ export async function observeCodexDone(meta, timeout, requestedCursor, signal) {
                     parts.shift();
                     discardLeadingFragment = false;
                 }
-                const harnessSessionId = meta.vendor_session_id ?? codexTranscriptSessionId(transcript);
+                const harnessSessionId = meta.vendor_session_id ? codexRolloutSessionId(meta, transcript) : codexTranscriptSessionId(transcript);
                 for (const line of parts) {
                     if (!line.trim())
                         continue;
@@ -401,11 +560,21 @@ export async function observeCodexDone(meta, timeout, requestedCursor, signal) {
                     try {
                         const record = JSON.parse(line);
                         const done = codexCompletionEvent(meta, harnessSessionId, record);
+                        if (done && completedAfter !== null) {
+                            const at = Date.parse(record.timestamp);
+                            if (Number.isFinite(at) && at <= completedAfter)
+                                continue;
+                        }
                         if (done) {
                             // 上限の知らせはこのturnの終わりにだけ書かれる。画面やpane logの文字は、上限が明けた後も
                             // 残り、道具の出力や依頼文にも現れるので見ない（2026-09-28）。
                             const limited = codexUsageLimit(record);
-                            return limited ? observation("rate_limited", done, limited) : observation("done", done);
+                            if (limited)
+                                return observation("rate_limited", done, limited);
+                            // サービスの誤りや通信の失敗で終わったturnも、Codexはtask_completeを書く（errorつき、回答は無い）。
+                            // 完了として返すと、失敗が空の回答に見える。Claude CodeのAPIエラーと同じく、typedな終了として返す（ADR 0103）。
+                            const failed = codexTurnError(record);
+                            return failed ? observation("error", done, null, failed) : observation("done", done);
                         }
                     }
                     catch {
@@ -690,7 +859,8 @@ export function codexMoreReasoningChoice(screen) {
 export function codexTranscriptText(meta, turnId, readTranscriptLines, transcriptUnavailable, exactCompletion = false) {
     if (!meta.codex_home || !meta.vendor_session_id)
         transcriptUnavailable();
-    const transcript = findLatestCodexTranscript(meta.codex_home, meta.vendor_session_id);
+    // 完了待ちが切り替わった後の会話で完了を見つけた時も、同じ会話から回答を読む（ADR 0105）。
+    const transcript = codexRootTranscript(meta);
     if (!transcript)
         transcriptUnavailable();
     const lines = readTranscriptLines(transcript);

package/dist/harnesses/cursor.js

@@ -114,6 +114,29 @@ export function bindCursorTranscriptSession(meta) {
     }
     return transcript;
 }
+// Cursorは、turnが誤りで終わると、turn_endedへ status "error" と文を書く（普通の終わりは "success" で、errorは無い）。
+// 実記録（2026-08-24〜09-28、macbook 23件・rabbit 1件）にあった文:
+//   "[unavailable] Error" / "[resource_exhausted] Error"（サービスの誤り）
+//   "You've hit your usage limit You've saved $… Your usage limits will reset when …" / "Other Models usage limit reached Switched to …"（利用上限）
+//   "User aborted request"（席で止めたturn）
+// 席で止めたturnは誤りに数えない（今までどおり完了として返す）。文は呼んだ側の画面にそのまま出るので、1行にしてURLを伏せ、長さを切る。
+const CURSOR_ERROR_LINE_MAX = 200;
+const CURSOR_LIMIT_LINE_MAX = 600;
+export function cursorTurnError(record) {
+    if (record?.type !== "turn_ended" || record?.status !== "error")
+        return null;
+    const flat = typeof record.error === "string" ? record.error.replace(/\s+/g, " ").trim() : "";
+    if (/^user aborted request\b/i.test(flat))
+        return null;
+    const limit = /usage limit/i.test(flat);
+    const text = flat.replace(/https?:\/\/[^\s)\]>"']+/gi, "…") || "Cursorのturnが誤りで終わりました（理由の文は記録にありません）";
+    const max = limit ? CURSOR_LIMIT_LINE_MAX : CURSOR_ERROR_LINE_MAX;
+    return {
+        message: text.length > max ? `${text.slice(0, max - 1)}…` : text,
+        kind: /^\[([a-z][a-z0-9_]*)\]/i.exec(flat)?.[1].toLowerCase() ?? null,
+        limit,
+    };
+}
 export function cursorCompletionEvent(meta, harnessSessionId, record, turnId) {
     if (meta.kind !== "cursor" || record?.type !== "turn_ended" || typeof record?.status !== "string")
         return null;
@@ -126,7 +149,7 @@ export function cursorCompletionEvent(meta, harnessSessionId, record, turnId) {
         turn_id: turnId,
         operation_id: null,
         reason: `Cursor transcript turn_ended:${record.status}`,
-        done_status: "turn_done",
+        done_status: cursorTurnError(record) ? "turn_error" : "turn_done",
         stop_hook_active: false,
         at: new Date().toISOString(),
     };
@@ -193,7 +216,7 @@ export async function observeCursorDone(meta, timeout, requestedCursor, readScre
     const deadline = performance.now() + timeout * 1000;
     // 画面を読むたびにtmuxを1回起動する。完了の見回りより間隔を空け、1回読んだ画面で利用上限とhook拒否の両方を見る。
     const screenDue = pollGate(CURSOR_SCREEN_POLL_MS);
-    const observation = (outcome, ev = null, rateLimit = null, error = null) => ({
+    const observation = (outcome, ev = null, rateLimit = null, error = null, errorKind = null) => ({
         schema: "aiterm.agent-wait-result.v1",
         session_id: meta.aiterm_session,
         launch_id: meta.launch_id,
@@ -207,6 +230,7 @@ export async function observeCursorDone(meta, timeout, requestedCursor, readScre
         at: ev?.at ?? null,
         rate_limit: rateLimit,
         error,
+        error_kind: errorKind,
     });
     for (;;) {
         signal?.throwIfAborted();
@@ -219,8 +243,13 @@ export async function observeCursorDone(meta, timeout, requestedCursor, readScre
             if (state.userTurns > startBoundary && state.terminalRecord) {
                 const harnessSessionId = meta.vendor_session_id ?? cursorTranscriptSessionId(transcript);
                 const done = cursorCompletionEvent(meta, harnessSessionId, state.terminalRecord, `cursor:${state.userTurns}`);
-                if (done)
-                    return observation("done", done);
+                if (done) {
+                    // 誤りで終わったturnを完了として返すと、失敗が空の回答に見える。Codexと同じく、typedな終了として返す（ADR 0106）。
+                    const failed = cursorTurnError(state.terminalRecord);
+                    if (failed?.limit)
+                        return observation("rate_limited", done, failed.message);
+                    return failed ? observation("error", done, null, failed.message, failed.kind) : observation("done", done);
+                }
             }
         }
         // 最初の周回では必ず読む（timeout=0の照会も1回は読む）。
@@ -525,7 +554,9 @@ export function cursorTuiReady(screen) {
     return /Cursor Agent/i.test(screen) &&
         (CURSOR_COMPOSER_MARKER_RE.test(screen) || CURSOR_START_PROMPT_MARKER_RE.test(screen));
 }
-// 利用上限に達したCursorは、transcriptへturn_endedを書かず、入力欄も戻さずに説明を出して止まる（2026.09.26-dd393fe、macOSで実測）。
+// 利用上限に達したCursorは、入力欄も戻さずに説明を出して止まる（2026.09.26-dd393fe、macOSで実測）。
+// transcriptには、user turnを残さずにturn_ended（status "error"）だけを書く事がある（実記録で8件）。その時は完了の条件
+// （user turnが増えている）に当たらないので、画面で見る。user turnがある時は、完了待ちが記録から読む（cursorTurnError）。
 //   Error: You've hit your usage limit
 //   You've saved $766 ... Switch to a different model or set a Spend Limit to continue with Sonnet. ...
 //   fallbackModel: / spendLimitHit: true / chatMessage: ...

package/dist/harnesses/grok.js

@@ -273,6 +273,7 @@ export async function observeGrokDone(meta, timeout, requestedCursor, detectRate
         at: ev?.at ?? null,
         rate_limit: rateLimit,
         error: ev?.done_status === "turn_error" ? ev.reason : null,
+        error_kind: null,
     });
     for (;;) {
         signal?.throwIfAborted();

package/dist/interim-words.js

@@ -14,7 +14,7 @@ import * as path from "node:path";
 import { AitermError } from "./errors.js";
 import { agentHarness, agentsDir, assertSessionName, LAUNCH_ID_RE, readFileRange, safeStatSize, writeJson0600, } from "./agent-shared.js";
 import { claudeSessionTranscriptPath } from "./harnesses/claude.js";
-import { codexRootTranscript, codexTurnError } from "./harnesses/codex.js";
+import { codexBoundTranscript, codexRootTranscript, codexTurnError, codexTurnErrorLine } from "./harnesses/codex.js";
 import { grokSessionDirectory } from "./harnesses/grok.js";
 import { cursorTranscript } from "./harnesses/cursor.js";
 /** BellTeamが要求の_metaへ入れる呼び手の印。値が "BellTeam" の時だけ合間の言葉を返す。 */
@@ -90,7 +90,9 @@ export function codexInterimWords(lines) {
         const error = codexTurnError(record);
         if (error) {
             words.push({
-                text: error.message,
+                // 利用上限はCodexの利用者向けの文をそのまま出す。ほかの誤りは、完了の返り（error）と同じ1行にする
+                // （応答の本文やURLが混ざる文があるため）。
+                text: error.info === "usage_limit_exceeded" ? error.message : codexTurnErrorLine(error),
                 kind: "error",
                 at: typeof record.timestamp === "string" ? record.timestamp : null,
                 turn_id: typeof payload.turn_id === "string" && payload.turn_id ? payload.turn_id : null,
@@ -246,8 +248,9 @@ export function readInterimWords(meta, after) {
         const boundary = recorded?.boundary ?? 0;
         if (meta.kind === "claude")
             found = claudeInterimWords(readLines(claudeSessionTranscriptPath(meta), boundary));
+        // 境界は、送った時に結び付いていた会話のrolloutの位置。会話の切り替えは追わない（ADR 0105）。
         else if (meta.kind === "codex")
-            found = codexInterimWords(readLines(codexRootTranscript(meta), boundary));
+            found = codexInterimWords(readLines(meta.vendor_session_id ? codexBoundTranscript(meta) : codexRootTranscript(meta), boundary));
         else if (meta.kind === "grok")
             found = grokInterimWords(readLines(grokChatHistory(meta)), boundary);
         else

package/docs/DESIGN.md

@@ -52,6 +52,7 @@ sessionの表には環境が丸ごと入るので、名指しで登録した名
 対象の一覧取得やserver終了が失敗した場合は登録を削除しない（ADR 0087）。
 試験の正規入口（`npm test`とCI）は`test/seat-env.mjs`を前処理として読み、席の保存場所・系譜・tmux環境を外し、
 試験processごとの一時領域を指定する。個別試験が指定する`TMPDIR`と`XDG_RUNTIME_DIR`もそのまま利用できる。
+前処理は、作った一時領域をprocessの終わりに消す。つながるtmuxのserverが残っている時だけ、消さずに場所を標準エラーへ書く（ADR 0104）。
 
 agent配送だけを期待する連携元は`pty_send(require_agent:true)`を指定する。agent登録が無ければ、通常PTYへ送る前に
 `AGENT_SESSION_REQUIRED`と「文字列は送信していません」を返す。未送信を確定してから対象sessionを復旧できる。
@@ -65,6 +66,9 @@ agentの席への`pty_send`は、任意の`preface`（本文の前に置く1行
 Codexは回答を流している間、画面に動作中の行を出さない。`pty_send`の振り分けは、Codexの席に限り、画面が入力待ちでも、この起動の記録の
 最後の境界がturnの開始で、processが生きていて、0.4秒おいて見直しても記録が同じturnのままで画面が動いている時を、動いていると数える
 （ADR 0101）。止まっている席を動いていると読まないよう、1つでも欠けたら新しいturnの道へ回す。
+Codexの席の記録は、結び付けた会話（`vendor_session_id`）のrolloutか、それより後に書かれた、同じ起動の印を持つ派生でないroot会話のrollout。
+入力欄の`/new`・`/clear`で会話が切り替わった後も、今の会話から完了・回答・turnの境界を読む。結び付け直すのは送信の道だけで、
+完了待ちは、読み始めた記録が3秒増えない時に今の会話を見直す（ADR 0105）。
 
 Windowsの`pty_close`は、Claude Codeの席を止める前に、C-cを間を空けずに2回送って、Claude Codeが自分で終わるのを待つ（ADR 0100）。
 psmuxは切断の合図なしでsessionを止めるので、そのままでは会話終了のhook（SessionEnd）が走らない。動いている番の席へは、先にC-cを
@@ -348,6 +352,13 @@ agent sessionへの送信1本を守る`<name>.agent-send.lock`は持つ時間が
 終了した持ち主のpidを別のprocessが使い回すと、pidだけでは生きて見える。生きて見える持ち主は、processが始まってからの経過とlockを作ってからの時間を比べ、
 lockより後に始まったprocessなら別人と読んで片付ける。消す役の印は、5秒より古ければ残った物と読む。`pty_close`は、どちらも片付ける。
 
+Codexは、サービスの誤りや通信の失敗でturnを打ち切る時も、記録へ`task_complete`を書く（回答は無く、`error`が付く）。完了待ちは、
+利用上限（`usage_limit_exceeded`）を`rate_limited`、ほかの`error`つきを`error`で返す。`error`は応答の本文とURLを落とした1行の文、
+Codexが書いた種類は`error_kind`で返す。失敗を空の回答の完了として返さない（ADR 0103）。判定と文の整え方は`src/harnesses/codex.ts`が所有する。
+Cursorは、誤りで終わったturnを、記録の`turn_ended`へ`status: "error"`と文で書く。完了待ちは、利用上限の文を`rate_limited`、
+席で止めたturn（`User aborted request`）を今までどおり`done`、ほかを`error`で返す。`error`は1行の文、文の頭の角括弧の名前は
+`error_kind`で返す（ADR 0106）。判定と文の整え方は`src/harnesses/cursor.ts`が所有する。
+
 Grokのread-only sandbox起動拒否は、`src/harnesses/grok.ts`の
 `assertGrokSandboxNotRejected`がCLIのエラー表示から検出する。`src/core.ts`の共通入力受付待機は
 Grokの場合だけこの判定を呼び、`GROK_SANDBOX_STARTUP_FAILED`で原因と未送信を返す。
@@ -390,7 +401,8 @@ Claude・Grokは2秒、Cursorは1秒に1回で、待ちに入った最初の周
 `diagnostics`はread-onlyで、PTY backendとagent dependencyを検査する。runtime error aggregateは
 製品所有のlocal stateに固定codeと集約metadataだけを保存し、既定ではnetwork I/Oを持たない。
 BugHubへの報告は、利用者が明示して有効にし、合鍵のファイルがある端末だけが、別processで行う。
-きっかけは記録・解決・起動・手動の4つで、定期的な見張りは置かない。受け取り済みにするのは応答の署名まで確かめた時だけ（ADR 0079）。工場reporterとの
+きっかけは記録・解決・起動・手動の4つで、定期的な見張りは置かない。受け取り済みにするのは応答の署名まで確かめた時だけ（ADR 0079）。
+記録するのは、Aitermが動く前提が欠けた時の固定の3種類だけ。通信の失敗・取消・待ちの時間切れは記録せず、呼んだ側へ返す（ADR 0102）。工場reporterとの
 連携は明示opt-inの任意adapterであり、未設定時もAiterm本体は単独動作する。raw error、prompt、出力、
 transcript、path、credentialを保存・公開しない。
 親配送hook（Claude Code・Cursor）の登録状態は`src/parent-hook-diagnostic.ts`が利用者設定の読取りだけで要約し、

package/package.json

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