aiterm-mcp 0.55.2 → 0.55.4

package/CHANGELOG.md

@@ -7,6 +7,37 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.55.4] - 2026-10-06
+
+### 変更
+
+- 止まっているCodex・Grok・Cursorの席へ`pty_send`で新しいturnを送る時、起動直後のための5秒の確かめを待たない
+  （ADR 0097）。受け付けを返すまで毎回5.4〜5.7秒かかっていた。画面を500msおきに11回続けて読む入力受付の確かめ
+  （ADR 0014）を、2通目以降の文にも毎回通していた。連携元の本番で、Codexの席への新しいturn17通が
+  5,686〜5,858msに揃っているのを見た。
+  - 席のharnessが自分の記録（Codexのrollout、Grokの`events.jsonl`、Cursorのtranscript）で「この起動でturnを1つ終えていて、
+    次のturnを始めていない」と示している時は、100msおきに2回続けて画面が入力待ちなら送る。
+  - 実物の席での受け付けまでの時間: Codex 5.6秒→0.66秒、Grok 5.6秒→0.65秒、Cursor 5.4秒→0.41秒（Linux）。
+    Macは5.8秒→0.75秒、Windowsは6.5秒→1.4秒（Codex）。
+  - 起動直後の最初の文と、記録の上でturnが動いている間に届いた文は、今までどおり11回の確かめを通る。
+  - 起動時prompt、`agent_configure`の後、利用上限のmodalを閉じた直後の確かめは変わらない。Claudeの席は元から
+    この確かめを通らない。
+  - 道具の返りの形と断りの文面は変わらない。
+
+## [0.55.3] - 2026-10-06
+
+### 修正
+
+- Claude Code親からの呼び出しを誤りで返す時、その呼び出しの置き場（Aiterm stateの`claude-parent-hooks/<tool_use_id>/`）を
+  返す前に消す（ADR 0096、`aiterm-steer-delivery` 0.2.3）。Claude Codeは誤りの返りで`PostToolUse`のhookを走らせないので、
+  `request.json`だけの置き場が、1日後の見回りまで残っていた。連携元の本番で、`harness: "claude-code"`へ`write_scope`を
+  付けて断られた`agent_launch`の置き場が残っているのを見た。
+  - 消すのは、配送を結んでいない置き場だけ。配送を結んだ後に誤りで返した呼び出しの置き場は、今までどおり残す。
+  - 入力の検査で断る返りと、handlerの例外から作られる返りでも消す。
+  - Claude Codeが自分で断った呼び出し（引数が道具の定義に合わない）と、Claude側で打ち切られた呼び出しは、Aitermへ
+    返りが渡らないので、今までどおり1日後の見回りが消す。
+  - 道具の返り、配送の記録、hookの登録は変わらない。`aiterm-setup`の流し直しは要らない。
+
 ## [0.55.2] - 2026-10-06
 
 ### 修正
@@ -2283,7 +2314,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.55.2...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.55.4...HEAD
+[0.55.4]: https://github.com/kitepon/aiterm-mcp/compare/v0.55.3...v0.55.4
+[0.55.3]: https://github.com/kitepon/aiterm-mcp/compare/v0.55.2...v0.55.3
 [0.55.2]: https://github.com/kitepon/aiterm-mcp/compare/v0.55.1...v0.55.2
 [0.55.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.55.0...v0.55.1
 [0.55.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.54.0...v0.55.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.55.2** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.55.4** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 

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.55.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.55.4** · 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
 

package/dist/agent-shared.js

@@ -16,6 +16,23 @@ export function safeStatSize(p) {
         return 0;
     }
 }
+/**
+ * 記録の末尾から、行を新しい順に返す。書いている途中の行（改行で終わっていない末尾）がある時はnullを返す。
+ * 読む範囲の先頭で切れた行は捨てる。
+ */
+export function readTailLinesNewestFirst(file, maxBytes) {
+    const size = safeStatSize(file);
+    if (size === 0)
+        return [];
+    const from = Math.max(0, size - maxBytes);
+    const text = readFileRange(file, from, size).toString("utf8");
+    if (!text.endsWith("\n"))
+        return null;
+    const lines = text.split("\n");
+    if (from > 0)
+        lines.shift();
+    return lines.filter(line => line.trim() !== "").reverse();
+}
 export function readFileRange(p, from, to) {
     const len = Math.max(0, to - from);
     if (len === 0)
@@ -103,6 +120,8 @@ export function pollGate(intervalMs, now = () => performance.now()) {
 }
 export const AGENT_EVENT_MAX_BYTES = 1024 * 1024;
 export const AGENT_EVENT_TAIL_BYTES = 64 * 1024;
+// turnの境界（開始・終わり）を、harnessの記録の末尾から探す時に読む大きさ。終わった席では境界は末尾の近くにある。
+export const AGENT_TURN_BOUNDARY_TAIL_BYTES = 1024 * 1024;
 export const CODEX_TRANSCRIPT_INCREMENT_MAX_BYTES = 16 * 1024 * 1024;
 export const GROK_TRANSCRIPT_INCREMENT_MAX_BYTES = 16 * 1024 * 1024;
 // session 名はファイルパス（logpath 等）と pipe-pane の /bin/sh 文字列へ流れる。英数 _ - のみ・64字に

package/dist/claude-parent-receiver.js

@@ -17,6 +17,10 @@ export function claudeParentFromRequest(clientName, metadata, root = defaultRoot
 }
 export function verifyClaudeParent(parent) { steer.verifyClaudeParent(AITERM_PROFILE, parent); }
 export function bindClaudeParentDelivery(parent, deliveryId) { steer.bindClaudeParentDelivery(AITERM_PROFILE, parent, deliveryId); }
+/** 誤りで返す呼び出しの置き場を消す。配送を結んだ置き場は消さない。 */
+export function discardClaudeHookRequest(clientName, metadata, root = defaultRoot()) {
+    return steer.discardClaudeHookRequest(clientName, metadata, root);
+}
 /** SessionEndはその時点の依頼だけを終了する。同じ会話をresumeした新規依頼は別requestになる。 */
 export function closeClaudeParentSession(input, root = defaultRoot()) { steer.closeClaudeParentSession(input, root); }
 export function submitClaudeParentAnswer(parent, deliveryId, text) {

package/dist/core.js

@@ -21,8 +21,8 @@ import { AitermError, telemetryOwnedFailure, ownTelemetryFailure } from "./error
 import { isWin, SOCKDIR, tmuxCommand, sendPsmuxPayload, loadPtyBufferChunk, pasteBufferBaseArgs, tmuxNewSession, registeredSessionEnvironment, attachCommand, normalizePaneCommand, atomicShellMultiline, appendMarkSentinel, markShellCommand, settlePaneLog, paneCwdArgument, sessionEnvironmentLaunch, } from "./tmux-runtime.js";
 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, 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, 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 { 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 { 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";
@@ -59,6 +59,11 @@ const LAUNCH_ECHO_TAIL_CHARS = 24;
 const LAUNCH_ECHO_MIN_CHARS = 8;
 const AGENT_TUI_READY_POLL_MS = 500;
 const AGENT_TUI_READY_STABLE_SAMPLES = 11;
+// 上の11回は、起動の途中に一瞬だけ出る入力欄を採らないための確かめ（ADR 0014）。席のharnessが自分の記録で
+// 「この起動でturnを1つ終えていて、次のturnを始めていない」と示している時は起動の途中ではないので、短い間隔で
+// 続けて確かめるだけで送る（ADR 0097）。記録で示せない時は、今までどおり11回。
+const AGENT_TUI_SETTLED_STABLE_SAMPLES = 2;
+const AGENT_TUI_SETTLED_POLL_MS = 100;
 const AGENT_TUI_READY_LINES = 45;
 const CLAUDE_APPROVAL_SCREEN_LINES = 80;
 // submit座礁観測（dispatch後にcomposerへ送信textが残存していないかの有界チェック）
@@ -3172,6 +3177,8 @@ async function waitAgentTuiReadyImpl(kind, sample, sleepFn, opts = {}) {
     const timeoutMs = opts.timeoutMs ?? AGENT_TUI_READY_TIMEOUT_MS;
     const pollMs = opts.pollMs ?? AGENT_TUI_READY_POLL_MS;
     const stableSamples = opts.stableSamples ?? agentTuiReadyStableSamplesTestOverride ?? AGENT_TUI_READY_STABLE_SAMPLES;
+    const settledSamples = opts.settledSamples ?? AGENT_TUI_SETTLED_STABLE_SAMPLES;
+    const settledPollMs = opts.settledPollMs ?? AGENT_TUI_SETTLED_POLL_MS;
     const now = opts.now ?? (() => performance.now());
     const start = now();
     let deadline = start + timeoutMs;
@@ -3179,6 +3186,7 @@ async function waitAgentTuiReadyImpl(kind, sample, sleepFn, opts = {}) {
     const firstDrawDeadline = timeoutMs >= AGENT_TUI_READY_TIMEOUT_MS ? start + AGENT_TUI_FIRST_DRAW_TIMEOUT_MS : deadline;
     let samples = 0;
     let readyStreak = 0;
+    let settledStreak = 0;
     let lastScreen = "";
     for (;;) {
         lastScreen = sample();
@@ -3189,9 +3197,20 @@ async function waitAgentTuiReadyImpl(kind, sample, sleepFn, opts = {}) {
             readyStreak++;
             if (readyStreak >= stableSamples)
                 return { ready: true, samples, lastScreen };
+            if (opts.turnSettled?.()) {
+                settledStreak++;
+                if (settledStreak >= settledSamples)
+                    return { ready: true, samples, lastScreen };
+            }
+            else if (settledStreak > 0) {
+                // 記録の上でturnが始まった。短い間隔で数えた分を、11回の確かめへ持ち越さない。
+                settledStreak = 0;
+                readyStreak = 1;
+            }
         }
         else {
             readyStreak = 0;
+            settledStreak = 0;
             if (isAgentTuiActionRequired(kind, lastScreen))
                 return { ready: false, samples, lastScreen };
         }
@@ -3202,11 +3221,30 @@ async function waitAgentTuiReadyImpl(kind, sample, sleepFn, opts = {}) {
                 return { ready: false, samples, lastScreen };
             deadline = firstDrawDeadline;
         }
-        await sleepFn(pollMs);
+        await sleepFn(settledStreak > 0 ? settledPollMs : pollMs);
     }
 }
-async function waitAgentTuiReady(name, meta, timeoutMs = AGENT_TUI_READY_TIMEOUT_MS) {
-    const result = await waitAgentTuiReadyImpl(meta.kind, () => captureScreen(name, AGENT_TUI_READY_LINES), sleep, { timeoutMs, launchLine: agentLaunchLines.get(name) });
+/**
+ * 席のharnessが、この起動でturnを1つ終えていて、次のturnを始めていない事を、自分の記録で示しているか。
+ * 記録はこの起動に結び付いた物だけを読む（Codexはlaunch markerかsession ID、Grokは起動時に決めたsession、
+ * Cursorは最初の文に入れたmarker）。起動直後の席は記録が無いのでfalse。読めない時もfalse。
+ * Claudeはturnの印で差し込みか新しいturnかを決めていて、この確かめを通らない。
+ */
+function agentTurnSettled(meta) {
+    try {
+        if (meta.kind === "codex")
+            return codexTurnSettled(meta);
+        if (meta.kind === "grok")
+            return meta.completion_route === "grok_transcript" && grokTurnSettled(meta);
+        if (meta.kind === "cursor") {
+            return meta.completion_route === "cursor_transcript" && latestCursorCompletion(meta, readTranscriptLines) !== null;
+        }
+    }
+    catch { /* 読めない時は、11回の確かめで決める */ }
+    return false;
+}
+async function waitAgentTuiReady(name, meta, timeoutMs = AGENT_TUI_READY_TIMEOUT_MS, o = {}) {
+    const result = await waitAgentTuiReadyImpl(meta.kind, () => captureScreen(name, AGENT_TUI_READY_LINES), sleep, { timeoutMs, launchLine: agentLaunchLines.get(name), ...(o.settledTurn ? { turnSettled: () => agentTurnSettled(meta) } : {}) });
     if (result.ready)
         agentLaunchLines.delete(name);
     return result;
@@ -3403,7 +3441,10 @@ export async function __testWaitAgentTuiReady(kind, samples, opts = {}) {
     const sleeps = [];
     // virtualClockは待った分だけ進む時計。実時間を使わずに締切の扱いを確かめる。
     let clock = 0;
-    const { virtualClock, ...waitOpts } = opts;
+    const { virtualClock, settled, ...rest } = opts;
+    let asked = 0;
+    const waitOpts = settled && settled.length > 0
+        ? { ...rest, turnSettled: () => settled[Math.min(asked++, settled.length - 1)] } : rest;
     const result = await waitAgentTuiReadyImpl(kind, () => samples[Math.min(i++, samples.length - 1)], async (ms) => {
         sleeps.push(ms);
         clock += ms;
@@ -3714,9 +3755,10 @@ async function recoverCodexRateLimitModelSwitch(name, meta) {
     return true;
 }
 /** ready待機中に現れたCodex利用上限modalも、同じ一時keep復旧へ戻す。 */
-async function waitAgentTuiReadyAfterCodexRateLimitRecovery(name, meta, timeoutMs) {
+async function waitAgentTuiReadyAfterCodexRateLimitRecovery(name, meta, timeoutMs, o = {}) {
     let codexRateLimitModelSwitch = await recoverCodexRateLimitModelSwitch(name, meta);
-    let ready = await waitAgentTuiReady(name, meta, timeoutMs);
+    // 上限のmodalを閉じた直後は、画面が落ち着くのを11回の確かめで待つ。
+    let ready = await waitAgentTuiReady(name, meta, timeoutMs, codexRateLimitModelSwitch ? {} : o);
     if (!ready.ready && !codexRateLimitModelSwitch) {
         codexRateLimitModelSwitch = await recoverCodexRateLimitModelSwitch(name, meta);
         if (codexRateLimitModelSwitch)
@@ -4189,7 +4231,8 @@ async function dispatchAgentTurnInLock(name, text, o) {
         sendKey(name, limitDialog.dismissKey);
     }
     if (meta.kind !== "claude" || claudeColdStart) {
-        const recovery = await waitAgentTuiReadyAfterCodexRateLimitRecovery(name, meta, o.ready_timeout ?? AGENT_TUI_READY_TIMEOUT_MS);
+        // 上限のpanelを閉じた直後（Grok）は、画面が落ち着くのを11回の確かめで待つ。
+        const recovery = await waitAgentTuiReadyAfterCodexRateLimitRecovery(name, meta, o.ready_timeout ?? AGENT_TUI_READY_TIMEOUT_MS, { settledTurn: !limitDialog });
         codexRateLimitModelSwitch = recovery.codexRateLimitModelSwitch;
         const { ready } = recovery;
         if (!ready.ready) {

package/dist/harnesses/codex.js

@@ -11,7 +11,7 @@ import { spawnAgentControlCommand } from "../agent-resolver.js";
 import * as steer from "aiterm-steer-delivery";
 import { AITERM_PROFILE } from "../steer-profile.js";
 import { catalogInvalid, catalogUnavailable, checkedCatalog } from "../model-catalog.js";
-import { shq, subagentInstruction, writeScopeLaunchNote, safeStatSize, readFileRange, sleep, agentMetadataPath, writeAgentMetadata, agentEventPath, createEmpty0600, agentLineageFields, AGENT_DONE_POLL_MS, AGENT_EVENT_MAX_BYTES, AGENT_EVENT_TAIL_BYTES, CODEX_TRANSCRIPT_INCREMENT_MAX_BYTES, agentHarness, } from "../agent-shared.js";
+import { shq, subagentInstruction, writeScopeLaunchNote, safeStatSize, readFileRange, sleep, agentMetadataPath, writeAgentMetadata, agentEventPath, createEmpty0600, agentLineageFields, AGENT_DONE_POLL_MS, AGENT_EVENT_MAX_BYTES, AGENT_EVENT_TAIL_BYTES, AGENT_TURN_BOUNDARY_TAIL_BYTES, readTailLinesNewestFirst, CODEX_TRANSCRIPT_INCREMENT_MAX_BYTES, agentHarness, } from "../agent-shared.js";
 export function realCodexHome() {
     return process.env.CODEX_HOME || path.join(process.env.HOME ?? os.homedir(), ".codex");
 }
@@ -261,6 +261,47 @@ export function codexUsageLimit(record) {
     const error = codexTurnError(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（分からない時は「終わった」と数えない）。
+ */
+export function codexTurnSettled(meta) {
+    let transcript;
+    try {
+        transcript = codexRootTranscript(meta);
+    }
+    catch {
+        return false;
+    }
+    if (!transcript)
+        return false;
+    const lines = readTailLinesNewestFirst(transcript, AGENT_TURN_BOUNDARY_TAIL_BYTES);
+    if (!lines)
+        return false;
+    for (const line of lines) {
+        if (!line.includes("task_started") && !line.includes("task_complete") && !line.includes("turn_aborted"))
+            continue;
+        let record;
+        try {
+            record = JSON.parse(line);
+        }
+        catch {
+            return false;
+        }
+        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";
+    }
+    return false;
+}
 export function latestCodexCompletion(meta, readTranscriptLines) {
     const transcript = codexRootTranscript(meta);
     if (!transcript)

package/dist/harnesses/grok.js

@@ -10,7 +10,7 @@ import { randomBytes, randomUUID } from "node:crypto";
 import { AitermError } from "../errors.js";
 import { runAgentProtocolCommand, spawnAgentControlCommand } from "../agent-resolver.js";
 import { catalogInvalid, catalogUnavailable, checkedCatalog, findJsonLine, processSummary } from "../model-catalog.js";
-import { shq, subagentInstruction, writeScopeLaunchNote, safeStatSize, readFileRange, sleep, agentMetadataPath, writeAgentMetadata, agentEventPath, createEmpty0600, agentLineageFields, AGENT_DONE_POLL_MS, AGENT_RATE_LIMIT_POLL_MS, pollGate, AGENT_EVENT_MAX_BYTES, GROK_TRANSCRIPT_INCREMENT_MAX_BYTES, agentHarness, } from "../agent-shared.js";
+import { shq, subagentInstruction, writeScopeLaunchNote, safeStatSize, readFileRange, sleep, agentMetadataPath, writeAgentMetadata, agentEventPath, createEmpty0600, agentLineageFields, AGENT_DONE_POLL_MS, AGENT_RATE_LIMIT_POLL_MS, pollGate, AGENT_EVENT_MAX_BYTES, AGENT_TURN_BOUNDARY_TAIL_BYTES, readTailLinesNewestFirst, GROK_TRANSCRIPT_INCREMENT_MAX_BYTES, agentHarness, } from "../agent-shared.js";
 const GROK_MODELS_MAX_BYTES = 1024 * 1024;
 const GROK_MODELS_TIMEOUT_MS = 15_000;
 // grok CLI はモデル未指定だと端末側 default に従うため、ツール契約として既定 slug を固定する。
@@ -191,6 +191,35 @@ export function latestGrokCompletion(meta, readTranscriptLines) {
     }
     return latest;
 }
+/**
+ * この起動のevents.jsonlで、最後のturnが終わっていて、次のturnが始まっていないか。
+ * 末尾から見て最初の境界が、完了と数えるturn_ended（grokCompletionEvent）の時だけtrue。差し込みの継ぎ目
+ * （cancelledかつsend_now）とturn_startedはfalse。記録が無い、書いている途中、境界が読む範囲に無い時もfalse。
+ */
+export function grokTurnSettled(meta) {
+    const transcript = grokEventsTranscript(meta);
+    if (!transcript || !fs.existsSync(transcript))
+        return false;
+    const lines = readTailLinesNewestFirst(transcript, AGENT_TURN_BOUNDARY_TAIL_BYTES);
+    if (!lines)
+        return false;
+    for (const line of lines) {
+        if (!line.includes("turn_started") && !line.includes("turn_ended"))
+            continue;
+        let record;
+        try {
+            record = JSON.parse(line);
+        }
+        catch {
+            return false;
+        }
+        if (record?.type === "turn_started")
+            return false;
+        if (record?.type === "turn_ended")
+            return grokCompletionEvent(meta, record) !== null;
+    }
+    return false;
+}
 export function grokInitializationComplete(meta) {
     const transcript = grokEventsTranscript(meta);
     if (!transcript || !fs.existsSync(transcript))

package/dist/index.js

@@ -11,6 +11,7 @@
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { z } from "zod";
 import { agentModelsResult } from "./model-catalog.js";
 import * as core from "./core.js";
@@ -20,7 +21,7 @@ import { createRequire } from "node:module";
 import { ParentDeliveryManager, deliveryKey } from "./parent-delivery.js";
 import { acceptRemote, callRemoteTool, observeRemoteAgentDone, remoteInputDescription, remoteInputSchema, remoteLabel, remoteWaitProcess } from "./remote.js";
 import { codexParentFromRequest } from "./codex-parent-receiver.js";
-import { claudeParentFromRequest } from "./claude-parent-receiver.js";
+import { claudeParentFromRequest, discardClaudeHookRequest } from "./claude-parent-receiver.js";
 import { parentDeliveryDiagnostic } from "./parent-hook-diagnostic.js";
 import { cursorParentFromRequest, isCursorMcpClient } from "./cursor-parent-receiver.js";
 import { waitProcessCommandLine } from "./cursor-parent-receive.js";
@@ -31,6 +32,20 @@ import { INTERIM_RESULT_META_KEY, interimRequestFromMeta } from "./interim-words
 // 除去済み＝どちらの静的構文も 18〜22 全域を満たせないため（実行時 require が唯一全域で動く）。
 const pkg = createRequire(import.meta.url)("../package.json");
 const server = new McpServer({ name: "aiterm", version: pkg.version });
+// 誤りの返りでは、Claude Code親は受け口のPostToolUse hookを走らせず、配送を結ばなかった呼び出しの置き場が残る。
+// 返す前にここで消す（ADR 0096）。McpServerは入力の検査の失敗やhandlerの例外も誤りの返りへ変えるので、
+// toolごとのhandlerではなくtools/callの返りを見る。McpServerがそのhandlerを置くのは最初のtool登録の時で、その前に包む。
+const setRequestHandler = server.server.setRequestHandler.bind(server.server);
+server.server.setRequestHandler = ((schema, handler) => setRequestHandler(schema, schema !== CallToolRequestSchema ? handler : async (request, extra) => {
+    const result = await handler(request, extra);
+    // 片付けの失敗で返りを変えない。残った置き場は、後の依頼のhookが見回って消す。
+    if (result?.isError)
+        try {
+            await discardClaudeHookRequest(server.server.getClientVersion()?.name, extra._meta);
+        }
+        catch { /* 見回りへ回す */ }
+    return result;
+}));
 let parentDelivery = null;
 // 別端末の子の配送。記録の保存場所を分けるため、この端末の子とは別のmanagerにする。
 let remoteParentDelivery = null;

package/docs/DESIGN.md

@@ -104,6 +104,9 @@ Grokは待ち行列へ入れた後に「send now」を押す。旧turnは`cancel
 新turnが作業を継ぐので、完了判定はこの継ぎ目を完了と数えない。Grokが待ち行列へ入れない時とCursorの入力欄に本文が残る時は`steered`を返さない。
 Cursorのsubmitはadapterがextended keyboard protocolのEnterへ変換し、呼び出し側は通常のdispatchだけを使う。
 起動直後のClaude sessionへの初回dispatchは、他harnessと同じくTUIの入力受付を確認してから貼付とEnterを送る。
+Codex・Grok・Cursorの席は、新しいturnを送るたびに入力受付を確かめる。起動の途中の入力欄を採らないよう、500msおきに11回続けて
+入力待ちを読む（ADR 0014）。席のharnessが自分の記録で「この起動でturnを1つ終えていて、次のturnを始めていない」と示している時は、
+100msおきに2回で通す（ADR 0097）。記録の上でturnが動いている間は、画面が入力待ちに見えても11回の確かめを通る。
 
 ### 親配送の共通モジュール化（設計）
 
@@ -187,6 +190,7 @@ hookはNodeの実行ファイルと引数配列で直接起動し、shellやWind
 hookとの受け渡しはAiterm stateの`claude-parent-hooks`へ、道具の呼び出しごとの置き場として置く。
 届いた置き場は、送り手がhookの出し終えた記録を確かめた時に消す。届かなかった置き場と、配送を結ばなかった置き場は1日残し、
 次の依頼の`PreToolUse`のhookが消す。依頼元が居て配送を待っている置き場は残す（ADR 0094）。
+誤りで返す呼び出しは、Claude Codeが`PostToolUse`を走らせないので、配送を結んでいない置き場をAitermが返す前に消す（ADR 0096）。
 
 hookの登録は、`args`を使わずshellを通す1行で書く（ADR 0089）。POSIXは`exec '<node>' '<hook>'`、Windowsは
 `& '<node>' '<hook>'; exit (Get-Variable LASTEXITCODE -ValueOnly)`と`shell: "powershell"`。同じ設定をGrokも読み、

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.55.2",
+  "version": "0.55.4",
   "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.2.2",
+    "aiterm-steer-delivery": "^0.2.3",
     "ws": "8.21.3",
     "zod": "^4.4.3"
   },