aiterm-mcp 0.57.0 → 0.57.1

package/CHANGELOG.md

@@ -7,6 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.57.1] - 2026-10-07
+
+### 修正
+
+- Windowsで、`pty_close`されたClaude Codeが会話終了のhook（SessionEnd）を走らせない件を直す（ADR 0100）。psmuxは、sessionを止める時に
+  画面のprocessへ切断の合図を送らない（POSIXのtmuxは送る）。
+  - WindowsのClaude Codeの席を閉じる時、止める前にC-cを間を空けずに2回送り、Claude Codeが自分で終わるのを最大4秒待つ。
+    動いている番の席へは、先にC-cを1回送って入力待ちに戻るのを最大1.5秒待つ。終わらなくても、その後は今までどおり止める。
+  - `pty_close`は、WindowsのClaude Codeの席でだけ遅くなる（実物で、入力待ちの席は約2.3秒、動いている番の席は約3.2秒）。
+  - Linux・macOS、Codex・Grok・Cursorの席、返りの形は変わらない。
+- Codexが回答を流している間に届いた文を、新しいturnでなく差し込み（`mode: agent_steer`）として返す（ADR 0101）。Codex（0.160.1）は
+  回答を流している間、画面に動作中の行を出さない。今までは「入力待ち」と読んで新しいturnとして返し、Codexはその文を動いている
+  turnへ取り込むので、同じ1つの回答が2回の完了として届いていた（親への配送があれば2通）。
+  - 画面に入力欄が見え、この起動の記録（rollout）の最後の境界がturnの開始で、Codexのprocessが生きていて、0.4秒おいて見直しても
+    記録が同じturnの開始のままで画面が動いている時だけ、動いていると数える。1つでも欠けたら、今までどおり新しいturnで返す。
+  - その間に届いた文の受け付けは、5.6秒から約0.8秒になる（入力受付の11回の確かめを通らない。Windowsは約2秒）。
+  - 引数・返りの形・断りの文面、Claude Code・Grok・Cursorの席、画面に動作中の行が出ている時の動きは変わらない。
+- 配送パッケージ`aiterm-steer-delivery`を0.3.1へ上げる。
+  - Codexの親配送の登録（`aiterm-setup --codex-steer enable`、`ensureCodexParentSteer`）が、登録の間に終わったCodexを、再起動待ちの記録
+    （`stale_processes`）へ残さない。ほかの導入が設定のために一時的に起こして止めたCodexが、止まり切る前の一覧に載って残っていた。
+    居ないprocessは照合で当たらないので、配送は止まっていなかった。
+  - Codexを起こす時、PATHにnodeの場所が無ければ足す。0.56.1で`aiterm-parent-delivery`が自分でしていた事を、MCPの本体からCodexを
+    起こす所（認証の確かめ、model一覧、親配送）にも広げる。
+
 ## [0.57.0] - 2026-10-07
 
 ### 追加
@@ -2356,7 +2380,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.57.0...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.57.1...HEAD
+[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
 [0.56.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.55.4...v0.56.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.57.0** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.57.1** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -401,6 +401,9 @@ pty_close("t1")                     → 端末を解放
 
 `pty_close` は冪等で、`closed` / `already_closed` のstructured receiptを返す。
 MCP応答を失ったdurable callerも同じ`session_id`への再試行だけでclose結果を確定できる。
+Windowsでは、Claude Codeの席を閉じる前に、Claude Codeへ自分で終わる機会を与える（C-cを2回送り、最大4秒待つ）。
+psmuxは、POSIXのtmuxが送る切断の合図なしでsessionを止めるので、そのままでは会話終了のhook（SessionEnd）が走らない。
+終わっても終わらなくても、その後にsessionを止める。
 
 これだけ。`t1` の端末は本物で永続——`ssh`・`docker exec`・REPL・起動したエージェントのTUIは、そこに住む「もの」に過ぎない。ワーカー起動も1コールで、`agent_launch({ harness: "codex-cli" })`が返す`session_id`を同じ`pty_read`／`pty_send`で操作する。
 

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.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.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).
 
 ### Update and rollback
 
@@ -431,6 +431,9 @@ pty_close("t1")                     → terminal released
 
 `pty_close` is idempotent and returns a structured `closed` / `already_closed`
 receipt, so durable callers can retry the same `session_id` after losing the MCP response.
+On Windows, closing a Claude Code session first asks Claude Code to exit on its own (Ctrl-C twice, then a wait of up to 4 seconds)
+so that its `SessionEnd` hooks run; psmux stops a session without the hangup signal that tmux sends on POSIX. The session is stopped
+afterwards either way.
 
 That's it. The terminal in `t1` is real and persistent — `ssh`, `docker exec`, a REPL, or a launched agent's TUI are just things that live inside it. To launch a worker agent instead, one call does it: `agent_launch({ harness: "codex-cli" })` returns a `session_id` you drive with the same `pty_read` / `pty_send`.
 

package/dist/core.js

@@ -22,7 +22,7 @@ import { isWin, SOCKDIR, tmuxCommand, sendPsmuxPayload, loadPtyBufferChunk, past
 import { sleep, currentUid, runtimeStateBase, safeStatSize, readFileRange, writeJson0600, createEmpty0600, shq, LAUNCH_ID_RE, AGENT_DONE_POLL_MS, AGENT_RATE_LIMIT_POLL_MS, pollGate, AGENT_EVENT_MAX_BYTES, assertSessionName, agentsDir, agentEventPath, agentMetadataPath, writeAgentMetadata, AGENT_EVENT_TAIL_BYTES, agentLabel, agentHarness, subagentInstruction, agentLineageFields, } from "./agent-shared.js";
 import { catalogUnavailable } from "./model-catalog.js";
 import { grokAuthPlan, grokAuthStatus, grokAuthPane, realGrokHome, resolveAndValidateGrokAuth, assertGrokModelAvailable, grokModelChoices, grokEventsTranscript, latestGrokCompletion, grokTurnSettled, observeGrokDone, buildGrokAgentCmd, grokLaunchNote, grokEnvTokens, grokTuiReady, grokTuiBusy, grokPaneObservation, grokRateLimitDialog, grokStartupAction, grokLaunchBlockingDialog, assertGrokSandboxNotRejected, GROK_COMPOSER_MARKER_RE, grokFooterHasConfiguration, grokTranscriptText, createGrokAgentMetadata, } from "./harnesses/grok.js";
-import { codexAuthPlan, codexAuthStatus, codexAuthPane, bindCodexTranscriptSession, latestCodexCompletion, codexTurnSettled, observeCodexDone, buildCodexAgentCmd, codexLaunchNote, codexTuiReady, codexPaneObservation, codexTuiBusy, codexHelperProcess, codexRateLimitModelSwitchDialog, codexApprovalDialog, codexStartupAction, CODEX_COMPOSER_MARKER_RE, codexModelChoice, codexEffortChoice, codexMoreReasoningChoice, codexTranscriptText, createCodexAgentMetadata, codexModelChoices, } from "./harnesses/codex.js";
+import { codexAuthPlan, codexAuthStatus, codexAuthPane, bindCodexTranscriptSession, latestCodexCompletion, codexTurnSettled, codexRunningTurn, observeCodexDone, buildCodexAgentCmd, codexLaunchNote, codexTuiReady, codexPaneObservation, codexTuiBusy, codexHelperProcess, codexRateLimitModelSwitchDialog, codexApprovalDialog, codexStartupAction, CODEX_COMPOSER_MARKER_RE, codexModelChoice, codexEffortChoice, codexMoreReasoningChoice, codexTranscriptText, createCodexAgentMetadata, codexModelChoices, } from "./harnesses/codex.js";
 import { claudeAuthPlan, claudeAuthStatus, claudeAuthPane, OPERATION_ID_RE, CLAUDE_RESULT_MAX_BYTES, CLAUDE_EFFORTS, agentManagedClaudeSettingsPath, agentClaudeResultPath, agentClaudeOperationPath, agentClaudeApprovalReceiptPath, agentClaudeDispatchReceiptPath, validateOperationId, readClaudeResultText, assertClaudeAuthenticationReady, claudeModelChoices, buildClaudeAgentCmd, claudeLaunchNote, claudeTuiReady, claudePaneObservation, claudeUsageLimit, claudeStartupAction, claudeLoginMethodMenu, CLAUDE_COMPOSER_MARKER_RE, createClaudeAgentMetadata, claudeSessionTranscriptPath, claudeApiErrorFromLine, claudeApiErrorAfter, } from "./harnesses/claude.js";
 import { cursorAuthPlan, cursorAuthStatus, cursorAuthPane, bindCursorTranscriptSession, cursorTurnBoundary, latestCursorCompletion, observeCursorDone, cursorTranscriptText, assertCursorAuthenticationReady, assertCursorModelAvailable, cursorModelChoices, buildCursorAgentCmd, cursorAgentArgv, cursorPwshLaunchLine, cursorPromptWithLineage, createCursorAgentMetadata, cursorLaunchNote, cursorEffortNavigation, cursorTuiReady, cursorPaneObservation, cursorPromptHooksRunning, cursorUsageLimit, CURSOR_SUBMIT_SEQUENCE, CURSOR_COMPOSER_CONTENT_MARKER_RE, validateCursorModelEffort, } from "./harnesses/cursor.js";
 import { readInterimWords, recordInterimBoundary } from "./interim-words.js";
@@ -1386,8 +1386,8 @@ export function readOnlyPtyListDiagnostic(runTmux = tmux) {
     }
     return { status: "unverified", session_count: null };
 }
-function closeSessionInternal(name, observeDependency = true) {
-    assertSessionName(name);
+/** 別processが待機中・送信中のsessionは閉じない。閉じる前の操作（下のClaude Codeへの終了の鍵）より先に確かめる。 */
+function assertSessionClosable(name) {
     {
         // 別プロセスの待機は in-memory Set に映らない。生きた file lock があれば close で state を消さない
         const foreign = liveWaitLocks(name);
@@ -1403,6 +1403,80 @@ function closeSessionInternal(name, observeDependency = true) {
             throw new AitermError(`session '${name}' は別プロセス${d.pid != null ? `（pid ${d.pid}）` : ""}の送信中のため close できません`, 2);
         }
     }
+}
+// Windowsのpsmuxは、sessionを止める時に画面のprocessへ切断の合図を送らない（POSIXのtmuxはSIGHUPを送り、Claude Codeは
+// 片付けて終わる）。合図なしで止められたClaude Codeは、会話終了のhook（SessionEnd）を走らせない。
+// 止める前に、Claude Codeへ自分で終わる機会を与える（ADR 0100）。
+// 動いている番を止めた後、入力待ちに戻るのを待つ上限。
+const CLAUDE_EXIT_INTERRUPT_WAIT_MS = 1500;
+// 終了の受付（「Press Ctrl-C again to exit」）は短い。実物では、間が0.3〜0.7秒の2回は通り、2.2秒の2回は切れた。
+const CLAUDE_EXIT_KEY_GAP_MS = 200;
+// 2回目の後、会話終了のhookを走らせて終わるのを待つ上限。実物（fox）では、hookが走ったのは2回目の約1秒後で、processはその
+// 0.2〜0.3秒後に終わった。hookが遅い端末でも走り切れるように、余りを取る。
+const CLAUDE_EXIT_WAIT_MS = 4000;
+const CLAUDE_EXIT_POLL_MS = 100;
+/**
+ * Claude Codeへ終了を頼む鍵と待ちの順番。
+ * 入力待ちでない席（動いている番など）へは、先にC-cを1回送って入力待ちに戻るのを待つ（そのC-cは番を止めるのに使われ、
+ * 終了の受付にならない）。その後、C-cを間を空けずに2回送り、processが終わるのを待つ。
+ * 終わらなかった時も、呼ぶ側は今までどおりsessionを止める。
+ */
+export function requestClaudeExit(steps) {
+    if (!steps.idle()) {
+        steps.interrupt();
+        const until = steps.now() + CLAUDE_EXIT_INTERRUPT_WAIT_MS;
+        while (!steps.idle() && steps.now() < until)
+            steps.pause(CLAUDE_EXIT_POLL_MS);
+    }
+    steps.interrupt();
+    steps.pause(CLAUDE_EXIT_KEY_GAP_MS);
+    steps.interrupt();
+    const until = steps.now() + CLAUDE_EXIT_WAIT_MS;
+    for (;;) {
+        if (!steps.alive())
+            return "exited";
+        if (steps.now() >= until)
+            return "still_running";
+        steps.pause(CLAUDE_EXIT_POLL_MS);
+    }
+}
+let claudeExitBeforeCloseTestOverride = null;
+/** 試験用: POSIXでも、閉じる前にClaude Codeへ終了を頼む（nullで既定へ戻す）。 */
+export function __testSetClaudeExitBeforeClose(value) {
+    claudeExitBeforeCloseTestOverride = value;
+}
+/**
+ * 閉じる席がWindowsのClaude Codeで、processが生きている時だけ、止める前に終了を頼む。
+ * 待ちは同期のまま（最大で数秒）。待つ間にほかの呼び出しを通すと、閉じかけの席へ送信が入る。
+ * 席の観測や鍵の送信に失敗した時は、何もせずに今までどおり止める（閉じる事を妨げない）。
+ */
+function letClaudeExitBeforeClose(name) {
+    if (!(claudeExitBeforeCloseTestOverride ?? isWin))
+        return;
+    try {
+        if (tryLoadAgentMetadata(name)?.kind !== "claude" || !sessionExists(name))
+            return;
+        const seen = observeSession(name);
+        if (seen.harness_alive !== true)
+            return;
+        const harness = seen.harness_process;
+        const pause = new Int32Array(new SharedArrayBuffer(4));
+        requestClaudeExit({
+            idle: () => claudePaneObservation(captureScreen(name, AGENT_TUI_READY_LINES)).state === "idle",
+            interrupt: () => { tmux("send-keys", "-t", name, "C-c"); },
+            // processが1つに決まらない席は、席の観測で見る（Windowsではprocessの一覧を引くので遅い）。
+            alive: () => harness ? isPidAlive(harness.pid) : observeSession(name).harness_alive === true,
+            pause: ms => { Atomics.wait(pause, 0, 0, ms); },
+            now: () => performance.now(),
+        });
+    }
+    catch { /* 終了を頼めなかった席は、今までどおり止める */ }
+}
+function closeSessionInternal(name, observeDependency = true, o = {}) {
+    assertSessionName(name);
+    assertSessionClosable(name);
+    if (o.letHarnessExit)
+        letClaudeExitBeforeClose(name);
     (observeDependency ? tmux : tmuxCleanup)("kill-session", "-t", name);
     for (const p of [logpath(name), offsetpath(name), lastcmdpath(name), markpath(name), sendLockPath(name)]) {
         try {
@@ -1430,7 +1504,7 @@ export function closeSession(name) {
 export function closeSessionResult(name) {
     assertSessionName(name);
     const existed = sessionExists(name);
-    closeSessionInternal(name, true);
+    closeSessionInternal(name, true, { letHarnessExit: true });
     return {
         schema: "aiterm.pty-close-result.v1",
         session_id: name,
@@ -4396,6 +4470,39 @@ async function waitSteerScreen(name, predicate, stillRunning) {
 export function __testSteerQueued(kind, screen) {
     return kind === "cursor" ? cursorSteerQueued(screen) : grokSteerQueued(screen);
 }
+// 記録の上でturnが動いている席を、間を置いて見直すまでの待ち。回答を流している画面は、この間に必ず動く（実測で0.15秒ごと）。
+const CODEX_RECORD_RUNNING_CONFIRM_MS = 400;
+/**
+ * Codexの席で、画面は入力待ちに見えるが、記録の上ではturnが動いているか（回答を流している間。Codex 0.160.1は、その間
+ * 動作中の行を出さない）。
+ * 止まっている席を動いていると読むと、文は新しいturnになるのに差し込みとして返り、その完了を誰も待たない。
+ * 読み違えない方へ倒し、次を全部満たす時だけtrueにする。1つでも欠けたら、今までどおり新しいturnの道へ回す。
+ * - 画面に入力欄が見えている（承認などの画面は、新しいturnの道が今までどおり打鍵前に断る）。
+ * - この起動の記録の最後の境界がturnの開始で、harnessのprocessが生きている（Codexは、生きている間はturnの終わりを必ず書く）。
+ * - 間を置いて見直しても、記録は同じturnの開始のままで、画面が動いている（止まっている席の画面は動かない）。
+ */
+async function codexTurnRunningBehindIdleScreen(name, meta, screen) {
+    try {
+        if (!isAgentTuiIdleReady("codex", screen))
+            return false;
+        const turn = codexRunningTurn(meta);
+        if (turn === null)
+            return false;
+        if (observeSession(name).harness_alive !== true)
+            return false;
+        await sleep(CODEX_RECORD_RUNNING_CONFIRM_MS);
+        const later = captureScreen(name, AGENT_TUI_READY_LINES);
+        if (codexRunningTurn(meta) !== turn)
+            return false;
+        // 見直す間に動作中の行が出た時は、画面の読みでも動いている。
+        if (isAgentTuiBusy("codex", later))
+            return true;
+        return later !== screen && isAgentTuiIdleReady("codex", later);
+    }
+    catch {
+        return false; /* 読めない時は、動いていると数えない */
+    }
+}
 /**
  * agent sessionへの唯一の送信口。呼び出し側は子の状態を知らないまま呼び、Aitermがこの時点の画面で振り分ける。
  * 実行中なら現在のturnへ差し込み（steer）、そうでなければ新しいturnとしてdispatchする。
@@ -4414,7 +4521,8 @@ async function sendAgentMessageInLock(name, text, o) {
     const meta = loadAgentMetadata(name);
     // 前面回復は busy 判定より先（bash 前面のままだと画面の実行中マーカーを読んでも打鍵が届かない）。
     const paneInputRecovery = await ensureAgentOwnsPaneInput(name, meta.kind);
-    let running = isAgentTuiBusy(meta.kind, captureScreen(name, AGENT_TUI_READY_LINES));
+    const screen = captureScreen(name, AGENT_TUI_READY_LINES);
+    let running = isAgentTuiBusy(meta.kind, screen);
     // Claudeのtool処理中は画面のbusy表示が消えることがある。Stopまで保持するturnの印を正とし、
     // APIエラーでStopが来なかった印は、会話記録の終了時刻を確認して消す。
     // 有効な印がある間は差し込み、終了後は画面にbusy表示が残っても新しいturnとして送る。
@@ -4427,6 +4535,9 @@ async function sendAgentMessageInLock(name, text, o) {
     // turnは終わっているので新しいturnとして送る。dispatchは入力を受け付けるまで待ってから送る。
     if (running && meta.kind === "cursor" && latestCursorCompletion(meta, readTranscriptLines) !== null)
         running = false;
+    // Codexは回答を流している間、画面に動作中の行を出さない。その間に届いた文を、Codexは動いているturnへ取り込む（ADR 0101）。
+    if (!running && meta.kind === "codex" && await codexTurnRunningBehindIdleScreen(name, meta, screen))
+        running = true;
     if (running) {
         return steerRunningTurn(name, meta, text, { raw: o.raw, pane_input_recovery: paneInputRecovery, preface: o.preface });
     }

package/dist/harnesses/codex.js

@@ -262,24 +262,23 @@ export function codexUsageLimit(record) {
     return error?.info === "usage_limit_exceeded" ? error.message : null;
 }
 /**
- * この起動のroot rolloutで、最後のturnが終わっていて、次のturnが始まっていないか。
- * Codexはturnの開始でtask_started、終わりでtask_complete、Escで止めた時はturn_aborted（reasonはinterrupted）を書く
- * （0.160.1の実記録）。末尾から見て最初の境界が、task_completeか、止めた時のturn_abortedの時だけtrue。
- * rolloutが無い、この起動に結び付かない、書いている途中、境界が読む範囲に無い時はfalse（分からない時は「終わった」と数えない）。
+ * この起動のroot rolloutの、末尾から見て最初のturnの境界。
+ * Codexはturnの開始でtask_started、終わりでtask_complete、止めた時はturn_aborted（reasonはinterrupted）を書く（0.160.1の実記録）。
+ * rolloutが無い、この起動に結び付かない、書いている途中、境界が読む範囲に無い時はnull。
  */
-export function codexTurnSettled(meta) {
+function codexLatestTurnBoundary(meta) {
     let transcript;
     try {
         transcript = codexRootTranscript(meta);
     }
     catch {
-        return false;
+        return null;
     }
     if (!transcript)
-        return false;
+        return null;
     const lines = readTailLinesNewestFirst(transcript, AGENT_TURN_BOUNDARY_TAIL_BYTES);
     if (!lines)
-        return false;
+        return null;
     for (const line of lines) {
         if (!line.includes("task_started") && !line.includes("task_complete") && !line.includes("turn_aborted"))
             continue;
@@ -288,19 +287,36 @@ export function codexTurnSettled(meta) {
             record = JSON.parse(line);
         }
         catch {
-            return false;
+            return null;
         }
         if (record?.type !== "event_msg")
             continue;
-        if (record?.payload?.type === "task_started")
-            return false;
-        if (record?.payload?.type === "task_complete")
-            return typeof record.payload.turn_id === "string" && record.payload.turn_id !== "";
-        // 見たのはEscで止めた時の形だけ。他の理由（別のturnへの置き換え等）は、次のturnが続くかも知れないので数えない。
-        if (record?.payload?.type === "turn_aborted")
-            return record.payload.reason === "interrupted";
+        const type = record?.payload?.type;
+        if (type === "task_started" || type === "task_complete" || type === "turn_aborted")
+            return { type, turn_id: record.payload.turn_id, reason: record.payload.reason };
     }
-    return false;
+    return null;
+}
+/**
+ * この起動のroot rolloutで、最後のturnが終わっていて、次のturnが始まっていないか。
+ * 末尾から見て最初の境界が、task_completeか、止めた時のturn_abortedの時だけtrue。
+ * rolloutが無い、この起動に結び付かない、書いている途中、境界が読む範囲に無い時はfalse（分からない時は「終わった」と数えない）。
+ */
+export function codexTurnSettled(meta) {
+    const boundary = codexLatestTurnBoundary(meta);
+    if (boundary?.type === "task_complete")
+        return typeof boundary.turn_id === "string" && boundary.turn_id !== "";
+    // 見たのはEscで止めた時の形だけ。他の理由（別のturnへの置き換え等）は、次のturnが続くかも知れないので数えない。
+    return boundary?.type === "turn_aborted" && boundary.reason === "interrupted";
+}
+/**
+ * この起動のroot rolloutの上で動いているturnのID。末尾から見て最初の境界がtask_startedの時だけ返す。
+ * rolloutが無い、この起動に結び付かない、書いている途中、境界が読む範囲に無い時はnull（分からない時は「動いている」と数えない）。
+ * Codexは、processが生きている間、turnの終わりを必ず書く。書かずに終わるのは落ちた時なので、呼ぶ側はprocessの生死も見る。
+ */
+export function codexRunningTurn(meta) {
+    const boundary = codexLatestTurnBoundary(meta);
+    return boundary?.type === "task_started" && typeof boundary.turn_id === "string" && boundary.turn_id !== "" ? boundary.turn_id : null;
 }
 export function latestCodexCompletion(meta, readTranscriptLines) {
     const transcript = codexRootTranscript(meta);

package/docs/DESIGN.md

@@ -62,6 +62,14 @@ agentの席への`pty_send`は、任意の`preface`（本文の前に置く1行
 ほかのharnessの席へは1つにつないで貼る。`preface`は入力欄がそのまま読むので、1行・200字以内・制御文字なし・行頭が記号や空白でない・
 `@`を含まない文だけを通し、外れた時は打鍵前に断る。
 
+Codexは回答を流している間、画面に動作中の行を出さない。`pty_send`の振り分けは、Codexの席に限り、画面が入力待ちでも、この起動の記録の
+最後の境界がturnの開始で、processが生きていて、0.4秒おいて見直しても記録が同じturnのままで画面が動いている時を、動いていると数える
+（ADR 0101）。止まっている席を動いていると読まないよう、1つでも欠けたら新しいturnの道へ回す。
+
+Windowsの`pty_close`は、Claude Codeの席を止める前に、C-cを間を空けずに2回送って、Claude Codeが自分で終わるのを待つ（ADR 0100）。
+psmuxは切断の合図なしでsessionを止めるので、そのままでは会話終了のhook（SessionEnd）が走らない。動いている番の席へは、先にC-cを
+1回送って入力待ちに戻るのを待つ。待ちは同期で、上限つき。終わらなくても、その後にsessionを止める。POSIXとほかのharnessの席は変えない。
+
 `pty_observe`は存在、pane／harnessの生存、画面状態と理由、native process identityを分ける。
 PIDは開始識別子・argv digestと組にし、paneとharnessを同一視しない。特定できないidentityはnull。
 同じlaunchに属するnpm shimとnative本体は、中間の非候補processも含めた祖先関係から一つの起動として扱う。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.57.0",
+  "version": "0.57.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": [
@@ -72,7 +72,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "aiterm-steer-delivery": "^0.3.0",
+    "aiterm-steer-delivery": "^0.3.1",
     "ws": "8.21.3",
     "zod": "^4.4.3"
   },