aiterm-mcp 0.55.3 → 0.56.0

package/CHANGELOG.md

@@ -7,6 +7,42 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.56.0] - 2026-10-07
+
+### 追加
+
+- ほかの製品が、Codexの親への回答をAitermの親配送へ頼む命令`aiterm-parent-delivery`を足す（ADR 0098）。製品はCodex用のhookを登録せず、
+  Aitermが登録したhookと公式キューで届く。決裁箱（Approval Box）が専用hookを捨てるための入口。
+  - `codex verify`・`codex submit`・`codex state`・`provider`。結果は1行のJSON。失敗は`{ok:false, code, message, outcome_unknown}`とexit 1。
+  - 設定・受付・実際に届いた事を分けて返す。`verify`の`steer`は設定（`enabled`＝hookが登録・承認済みで親がhookの導入後に起きている、
+    `disabled`＝公式キューだけ）。`submit`は公式キューの受付。`state`は`hook:"emitted"`と`turn_id`（hookがその番へ入れた）、`queued`（今も
+    公式キューにあるか）。
+  - 同じ配送idの2回目は`PARENT_DELIVERY_DUPLICATE`で断る。対象はCodexの親だけ。
+  - 実物の確かめ（公式のCodex、一時HOME）: 別のprocessから頼んで、動いている番へは同じ番へ、止まっている会話は公式キューが起こして届く。
+    hookを入れていない環境では`steer:"disabled"`と返り、番の後に届く。
+- `aiterm-setup`が、命令の場所を`~/.config/aiterm-mcp/delivery-provider.json`へ残す。残せなければ成功にしない（`delivery_provider_failed`）。
+- `dist/setup-integrations.js`に`ensureCodexParentSteer(home, options)`を足す。`aiterm-setup`を通らない導入（コンテナの起動時など）が、
+  Codexの親配送のhookを登録する入口。homeを引数で受け、その下だけを書く。動いているCodexは要らない。登録済みで承認済みなら何も書かない。
+  失敗は投げずに`{status:"failed", reason_code}`で返す。`writeDeliveryProvider(home, registration)`も同じ所から出す。
+- 今までの動きは変えていない。Aiterm自身の親配送、hookの登録の形、`aiterm-setup --codex-steer`はそのまま。
+
+## [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
 
 ### 修正
@@ -2297,7 +2333,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.3...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.56.0...HEAD
+[0.56.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.55.4...v0.56.0
+[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

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.3** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.56.0** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -528,6 +528,15 @@ agent sessionを閉じると失うものは、次の2項目で分かる。`activ
 子の結果の数。呼び出した側が誰でも付く。どちらも、分からない時はnull（通常PTY、harnessのprocessを特定できない時。
 processの数は0.48.0以前が起動したagentも）。別端末が旧版の時は項目ごと無い。nullと項目なしは「分からない」で、0ではない。
 
+ほかの製品が、Codexの親へ回答を届ける時は、製品のhookを登録せずに`aiterm-parent-delivery`でAitermへ頼める。Aitermが登録したhookと
+公式キューで届く。`codex verify --thread <uuid>`は親を確かめ、`steer`で設定を返す（`enabled`＝hookが登録・承認済みで親がhookの導入後に
+起きている。`disabled`＝公式キューだけで、ターンが終わってから届く）。`codex submit --thread <uuid> --delivery <uuid> --text-file <file|->`は
+本文を一度だけ渡し、公式キューの受付IDを返す。`codex state --thread <uuid> --delivery <uuid>`は届き方の事実を返す（`hook:"emitted"`と
+`turn_id`＝hookがそのターンへ本文を入れた。`queued`＝今も公式キューにあるか）。結果は1行のJSONで、失敗は
+`{ok:false, code, message, outcome_unknown}`とexit 1。同じ配送IDの2回目は`PARENT_DELIVERY_DUPLICATE`で断る。対象はCodexの親だけ。
+命令の場所は`aiterm-setup`が`~/.config/aiterm-mcp/delivery-provider.json`へ残す。Nodeの製品は`aiterm-steer-delivery`（0.3.0以上）の
+`submitCodexParentAnswerViaAiterm`などから呼べる。
+
 MCPの本体を初めて使う時まで起こさない中継の後ろにAitermを登録すると、眠っている本体は、終了した持ち主の配送を引き取れない。
 `aiterm-delivery-wake --parent <codex|claude|cursor>`は、起こす必要があるかを返す。その種類の親の配送を、終了した持ち主が
 持ったままならexit 0、そうでなければexit 1、引数の誤りはexit 2。何も出力せず、子processを起こさない。同じ判定を回す席のうち

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.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).
+**Status:** actively maintained · current public release **v0.56.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
 
@@ -563,6 +563,16 @@ is the number of sub-agent results this session is still waiting for as a parent
 Aiterm cannot tell (ordinary terminals, agents launched by 0.48.0 or earlier for the process count, or an unresolved harness
 process), and may be absent when a remote host runs an older Aiterm. Treat null or absent as unknown, not as zero.
 
+Another product that needs to deliver an answer to a Codex parent can ask Aiterm with `aiterm-parent-delivery` instead of registering its own hooks.
+Aiterm's registered hooks and the official queue deliver it. `codex verify --thread <uuid>` checks the parent and reports configuration in `steer`
+(`enabled`: the hooks are registered and trusted and the parent started after they were installed; `disabled`: official queue only, so the text arrives
+after the turn ends). `codex submit --thread <uuid> --delivery <uuid> --text-file <file|->` hands the text over once and returns the queue's acceptance id.
+`codex state --thread <uuid> --delivery <uuid>` reports how it arrived (`hook:"emitted"` with `turn_id`: the hook put the text into that turn; `queued`:
+whether it is still in the official queue). Each result is one JSON line; failures are `{ok:false, code, message, outcome_unknown}` with exit 1, and a
+reused delivery id is refused with `PARENT_DELIVERY_DUPLICATE`. Only Codex parents are supported. `aiterm-setup` records the command's location in
+`~/.config/aiterm-mcp/delivery-provider.json`. Node products can call it through `aiterm-steer-delivery` (0.3.0 or later), for example
+`submitCodexParentAnswerViaAiterm`.
+
 When Aiterm is registered behind a relay that starts the MCP server only on first use, a sleeping server cannot take over the
 deliveries of an owner that has exited. `aiterm-delivery-wake --parent <codex|claude|cursor>` answers whether one needs to start:
 exit 0 when an exited owner still holds a delivery for that parent kind, exit 1 otherwise, exit 2 for bad arguments. It prints

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/codex-parent-receiver.js

@@ -28,6 +28,20 @@ export async function verifyCodexParent(parent, runtime) {
     }
     await steer.verifyCodexParent(AITERM_PROFILE, parent, runtime);
 }
+/**
+ * 親を確かめ、渡した文が同じ番へ入るかどうかも返す。ほかの製品がAitermへ配送を頼む入口（aiterm-parent-delivery）が使う。
+ * 確かめる中身は`verifyCodexParent`と同じ。hookが有効なのに未承認・親が導入前から動いている時は、今までどおり理由つきで断る。
+ */
+export async function checkCodexParent(parent, runtime) {
+    const socket = relaySocket(runtime);
+    if (socket) {
+        await withCodexRelay(socket, request => verifyLoadedParent(request, parent.thread_id), runtime?.timeout_ms);
+        return { thread: { thread_id: parent.thread_id, cwd: null, source: null }, steer: "enabled" };
+    }
+    const thread = await steer.verifyCodexParent(AITERM_PROFILE, parent, runtime);
+    const config = runtime ? (runtime.hook_directory ? readCodexHookConfig(runtime.hook_directory) : null) : readCodexHookConfig();
+    return { thread, steer: config?.enabled ? "enabled" : "disabled" };
+}
 export async function submitCodexParentAnswer(parent, deliveryId, text, runtime) {
     const socket = relaySocket(runtime);
     if (socket) {

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/delivery-provider.js

@@ -0,0 +1,37 @@
+// ほかの製品が、Aitermの親配送の入口（aiterm-parent-delivery）の場所を知るための記録（ADR 0098）。
+// 製品のprocess（MCP serverや常駐process）は、PATHにnpmの置き場が無い環境で起きる事がある（macOSのアプリ配下など）。
+// setupが、nodeと命令の絶対pathをHOMEの下へ残す。製品は読むだけで、書かない。
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { homedir } from "node:os";
+import { createRequire } from "node:module";
+import { isDeepStrictEqual } from "node:util";
+import { writeJson0600 } from "aiterm-steer-delivery";
+export const DELIVERY_PROVIDER_SCHEMA = "aiterm.delivery-provider.v1";
+const pkg = createRequire(import.meta.url)("../package.json");
+export function deliveryProviderFile(home = process.env.HOME ?? homedir()) {
+    return path.join(home, ".config", "aiterm-mcp", "delivery-provider.json");
+}
+/**
+ * 登録（nodeの絶対pathとdist/index.js）から、同じ導入のaiterm-parent-deliveryの場所を記録する。変わりが無ければ書かない。
+ * MCPの本体の起動時には呼ばない（試験用に別の場所から起こした本体が、導入済みの記録を書き換えるため）。
+ */
+export function writeDeliveryProvider(home, registration) {
+    const entry = registration.args[0];
+    if (!path.isAbsolute(home) || !path.isAbsolute(registration.command) || typeof entry !== "string" || !path.isAbsolute(entry)) {
+        throw new Error("delivery providerの記録には、homeと登録の絶対pathが要ります");
+    }
+    const cli = path.join(path.dirname(entry), "parent-delivery-cli.js");
+    if (!fs.existsSync(cli))
+        throw new Error("aiterm-parent-deliveryの入口が、登録と同じ導入の中にありません");
+    const next = { schema: DELIVERY_PROVIDER_SCHEMA, version: pkg.version, node: registration.command, cli };
+    const file = deliveryProviderFile(home);
+    try {
+        if (isDeepStrictEqual(JSON.parse(fs.readFileSync(file, "utf8")), next))
+            return "unchanged";
+    }
+    catch { /* 無い・読めない時は書く */ }
+    fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
+    writeJson0600(file, next);
+    return "configured";
+}

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/parent-delivery-cli.js

@@ -0,0 +1,190 @@
+#!/usr/bin/env node
+// aiterm-parent-delivery — ほかの製品が、確定した回答をAitermの親配送へ頼む入口（ADR 0098）。
+// Aitermが登録したhookと公式キューで渡す。頼む製品は自分のhookを登録せず、Aitermの中のfileも書かない。
+// 結果はstdoutへ1行のJSONで返す。成功は {ok:true, schema, …}、失敗は {ok:false, schema, code, message, outcome_unknown} と exit 1。
+// outcome_unknown:true は「受け付けたかどうか確定できない」。その時は送り直さない。
+//
+//   aiterm-parent-delivery provider
+//   aiterm-parent-delivery codex verify --thread <uuid> [--codex-home <dir>]
+//   aiterm-parent-delivery codex submit --thread <uuid> --delivery <uuid> --text-file <file|-> [--codex-home <dir>]
+//   aiterm-parent-delivery codex state  --thread <uuid> --delivery <uuid> [--codex-home <dir>]
+//
+// 「設定が整っている」「受け付けた」「実際に届いた」は別の事として返す。
+//   verify の steer:"enabled" は設定の話（hookが登録・承認済みで、親がhookの導入後に起きている）。届いた事は言わない。
+//   submit の queued_submission_id は、公式キューが受け付けた事。
+//   state は届き方の事実を返す。hook:"emitted" と turn_id は、Aitermのhookがその番へ本文を入れた事。queued は、今も公式キューに残っているか。
+//
+// 対象はCodexの親だけ。親の指定は、CodexがMCP要求へ付けるthreadIdと、そのCodexのCODEX_HOME。
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import { realCodexHome } from "aiterm-steer-delivery";
+import { checkCodexParent, submitCodexParentAnswer, withCodexReceiver } from "./codex-parent-receiver.js";
+import { codexHookDeliveryState, codexHookDirectory, codexInputDirectory } from "./codex-hook-state.js";
+export const PARENT_DELIVERY_SCHEMA = "aiterm.parent-delivery.v1";
+const pkg = createRequire(import.meta.url)("../package.json");
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const USAGE = "usage: aiterm-parent-delivery provider | codex <verify|submit|state> --thread <uuid> [--delivery <uuid>] [--text-file <file|->] [--codex-home <dir>]";
+class UsageError extends Error {
+}
+/** 同じ配送idの本文が、もう配送の記録にある。送り直しで同じ回答が2回届く事を止める。 */
+class DuplicateError extends Error {
+}
+/** この配送idの所有記録（送る途中・hookが取り出した後）が、Aitermのhookの置き場に残っているか。hookを入れていない環境には記録が無い。 */
+function deliveryRecorded(target, delivery) {
+    const root = codexHookDirectory();
+    if (!fs.existsSync(path.join(root, "inputs")) || !fs.existsSync(target.codex_home))
+        return false;
+    const directory = codexInputDirectory(root, target.codex_home, target.thread_id);
+    return ["pending", "claims"].some(kind => fs.existsSync(path.join(directory, kind, `${delivery}.json`)));
+}
+function option(args, name) {
+    const index = args.indexOf(name);
+    if (index < 0)
+        return undefined;
+    const value = args[index + 1];
+    if (value === undefined)
+        throw new UsageError(`${name} に値がありません。${USAGE}`);
+    return value;
+}
+function uuid(args, name) {
+    const value = option(args, name);
+    if (value === undefined)
+        throw new UsageError(`${name} は必須です。${USAGE}`);
+    if (!UUID_RE.test(value))
+        throw new UsageError(`${name} はUUIDで指定してください。${USAGE}`);
+    return value;
+}
+function parent(args) {
+    const home = option(args, "--codex-home");
+    if (home !== undefined && !path.isAbsolute(home))
+        throw new UsageError(`--codex-home は絶対pathで指定してください。${USAGE}`);
+    return { thread_id: uuid(args, "--thread"), codex_home: path.resolve(home ?? realCodexHome()) };
+}
+async function readText(source) {
+    if (source !== "-")
+        return fs.readFileSync(source, "utf8");
+    let text = "";
+    process.stdin.setEncoding("utf8");
+    for await (const chunk of process.stdin)
+        text += chunk;
+    return text;
+}
+/** 届き方の事実を読む。何も書き換えない。 */
+async function deliveryState(target, delivery) {
+    const state = codexHookDeliveryState(target.codex_home, target.thread_id, delivery);
+    let hook = null;
+    let turn = null;
+    const root = codexHookDirectory();
+    if (fs.existsSync(path.join(root, "inputs")) && fs.existsSync(target.codex_home)) {
+        const directory = codexInputDirectory(root, target.codex_home, target.thread_id);
+        let claim = null;
+        try {
+            claim = JSON.parse(fs.readFileSync(path.join(directory, "claims", `${delivery}.json`), "utf8"));
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+        if (claim?.state === "emitted") {
+            hook = "emitted";
+            turn = typeof claim.turn_id === "string" ? claim.turn_id : null;
+        }
+        else if (claim?.state === "not_in_queue")
+            hook = "not_in_queue";
+        else if (state)
+            hook = state;
+        // 所有権のlinkだけを作った段階（まだ公式キューから取り出していない）は、受け付けた後と同じ。
+        else if (claim !== null || fs.existsSync(path.join(directory, "pending", `${delivery}.json`)))
+            hook = "pending";
+    }
+    try {
+        const queued = await withCodexReceiver(target, async (request) => {
+            let cursor = null;
+            do {
+                const page = await request("thread/queue/list", { threadId: target.thread_id, cursor, limit: 100 });
+                if (!Array.isArray(page?.data))
+                    throw new Error("queue list invalid");
+                if (page.data.some((entry) => entry?.clientUserMessageId === delivery))
+                    return true;
+                cursor = typeof page.nextCursor === "string" ? page.nextCursor : null;
+            } while (cursor);
+            return false;
+        });
+        return { state, hook, turn_id: turn, queued };
+    }
+    catch (error) {
+        const code = error?.delivery_code;
+        return { state, hook, turn_id: turn, queued: null, queue_error: typeof code === "string" ? code : "CODEX_QUEUE_UNREADABLE" };
+    }
+}
+/** この命令の場所と版。製品側の入口（aiterm-steer-delivery）が、呼べる相手かどうかを確かめるのに使う。 */
+export function providerDescription() {
+    return { version: pkg.version, node: process.execPath, cli: fileURLToPath(import.meta.url) };
+}
+export async function runParentDelivery(argv) {
+    const [kind, command, ...args] = argv;
+    if (kind === "provider" && command === undefined)
+        return providerDescription();
+    if (kind !== "codex")
+        throw new UsageError(`対応する親は codex だけです。${USAGE}`);
+    switch (command) {
+        case "verify": {
+            const checked = await checkCodexParent(parent(args));
+            return { verified: true, thread: checked.thread, steer: checked.steer };
+        }
+        case "submit": {
+            const target = parent(args);
+            const delivery = uuid(args, "--delivery");
+            const source = option(args, "--text-file");
+            if (source === undefined)
+                throw new UsageError(`--text-file は必須です。${USAGE}`);
+            const text = await readText(source);
+            if (text.length === 0)
+                throw new UsageError("本文が空です。文字列は送っていません。");
+            // 配送idは本文ごとに新しいUUID。同じidをもう一度受けると、同じ回答が2回届く。
+            if (deliveryRecorded(target, delivery))
+                throw new DuplicateError("同じ配送idの本文は、もう受け付けています。文字列は送っていません。");
+            return await submitCodexParentAnswer(target, delivery, text);
+        }
+        case "state": {
+            const target = parent(args);
+            return await deliveryState(target, uuid(args, "--delivery"));
+        }
+        default: throw new UsageError(`未対応のcommandです: ${String(command)}。${USAGE}`);
+    }
+}
+function isDirectExecution() {
+    const entry = process.argv[1];
+    if (!entry)
+        return false;
+    try {
+        const a = fs.realpathSync(entry);
+        const b = fs.realpathSync(fileURLToPath(import.meta.url));
+        return a === b || (process.platform === "win32" && a.toLowerCase() === b.toLowerCase());
+    }
+    catch {
+        return false;
+    }
+}
+if (isDirectExecution()) {
+    try {
+        process.stdout.write(JSON.stringify({ ok: true, schema: PARENT_DELIVERY_SCHEMA, ...(await runParentDelivery(process.argv.slice(2))) }) + "\n");
+    }
+    catch (error) {
+        // 配送の誤り（delivery_code）と使い方の誤りは、文面が呼び出し元向けに決めてあるのでそのまま返す。
+        // それ以外の例外は、中身（path・本文）を出さずに固定の文面へ落とす。
+        const value = error;
+        const delivery = typeof value?.delivery_code === "string" ? value.delivery_code : null;
+        const usage = error instanceof UsageError;
+        const duplicate = error instanceof DuplicateError;
+        process.stdout.write(JSON.stringify({
+            ok: false, schema: PARENT_DELIVERY_SCHEMA,
+            code: delivery ?? (usage ? "PARENT_DELIVERY_USAGE" : duplicate ? "PARENT_DELIVERY_DUPLICATE" : "PARENT_DELIVERY_FAILED"),
+            message: delivery || usage || duplicate ? String(value.message) : "aiterm-parent-delivery: operation failed",
+            outcome_unknown: value?.outcome_unknown === true,
+        }) + "\n");
+        process.exitCode = 1;
+    }
+}

package/dist/setup-codex-hooks.js

@@ -1,7 +1,8 @@
 // Steerの正規導入。公式hookを登録・承認してから、旧中継の起動差し替えを解除する。本体はaiterm-steer-delivery。
+import * as path from "node:path";
 import { fileURLToPath } from "node:url";
 import * as steer from "aiterm-steer-delivery";
-import { readRelayConfig } from "./codex-relay-config.js";
+import { readRelayConfig, relayConfigDirectory } from "./codex-relay-config.js";
 import { configureCodexSteer as configureLegacyRelay } from "./setup-codex-relay.js";
 import { readCodexHookConfig } from "./codex-hook-state.js";
 import { AITERM_PROFILE } from "./steer-profile.js";
@@ -20,3 +21,41 @@ export async function configureCodexSteer(action = "status", overrides = {}) {
         ...overrides,
     });
 }
+/**
+ * aiterm-setupを通らない導入（コンテナの起動時など）が、Codexの親配送のhookを登録する入口（ADR 0098）。
+ * - `home`を引数で受け、その下（`.codex`と`.config/aiterm-mcp/codex-parent-hooks`）だけを書く。
+ * - 動いているCodexは要らない。Codexの実行ファイルを一時的に起こし、登録の読戻しと承認を公式の口（hooks/list・config/batchWrite）で行う。
+ * - 登録済みで、公式の読戻しでも承認済みなら、何も書かない（`changed:false`）。登録が外れていた・commandが変わった時だけ書き直す。
+ * - 失敗は投げない。`{status:"failed", reason_code}`で返す（書き換える前の`hooks.json`は`.aiterm-backup`に残る）。
+ * 登録より前から動いているCodexは、起き直すまで同じ番への配送を受けられない（`restart_required`）。
+ */
+export async function ensureCodexParentSteer(home, options = {}) {
+    try {
+        if (!path.isAbsolute(home))
+            throw new steer.SetupError("codex_steer_home_invalid", "homeは絶対pathで指定してください");
+        const directory = path.join(home, ".config", "aiterm-mcp", "codex-parent-hooks");
+        const codexHome = options.codex_home ?? path.join(home, ".codex");
+        const hook = fileURLToPath(new URL("./codex-parent-hook.js", import.meta.url));
+        const overrides = {
+            directory, codex_home: codexHome,
+            legacy: () => readRelayConfig(relayConfigDirectory(home)),
+            verify: (config, approve) => steer.verifyCodexHookRegistration(AITERM_PROFILE, config, approve, directory),
+            ...(options.binary ? { findBinary: () => options.binary } : {}),
+            ...options.runtime,
+        };
+        const previous = readCodexHookConfig(directory);
+        const expected = steer.codexHookCommand(steer.setupNodeExecutable(process.execPath), hook, directory);
+        if (previous?.enabled && previous.command === expected && path.resolve(previous.codex_home) === path.resolve(codexHome)) {
+            // 登録の読戻しが通れば書かない。通らない時（ほかの導入がhooks.jsonを書き直して登録が外れた等）は、下で登録し直す。
+            const status = await configureCodexSteer("status", overrides).catch(() => null);
+            if (status && (status.status === "ready" || status.status === "restart_required"))
+                return { ...status, changed: false };
+        }
+        return { ...await configureCodexSteer("enable", overrides), changed: true };
+    }
+    catch (error) {
+        const value = error;
+        const reason = typeof value?.delivery_code === "string" ? value.delivery_code : typeof value?.code === "string" ? value.code : "codex_steer_setup_failed";
+        return { status: "failed", reason_code: reason, changed: false };
+    }
+}

package/dist/setup-integrations.js

@@ -9,6 +9,9 @@ import { lazyRelayExecutable } from "./lazy-relay.js";
 import { SetupError, runSetupCommand } from "./setup-platform.js";
 import { AITERM_PROFILE } from "./steer-profile.js";
 export { powershellInvocation } from "./setup-platform.js";
+// aiterm-setupを通らない導入（コンテナの起動時）が、ClaudeとCursorのhookと同じ並びで呼べるように、ここからも出す。
+export { ensureCodexParentSteer } from "./setup-codex-hooks.js";
+export { writeDeliveryProvider, deliveryProviderFile } from "./delivery-provider.js";
 const record = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 /**
  * 既にある登録が、今から書く登録と同じ本体を指しているか。

package/dist/setup.js

@@ -9,6 +9,7 @@ import { CallToolResultSchema } from "@modelcontextprotocol/sdk/types.js";
 import { prepareBackend, runSetupCommand, SetupError } from "./setup-platform.js";
 import { configureIntegrations, configureParentHooks } from "./setup-integrations.js";
 import { configureCodexSteer, codexSteerSelected } from "./setup-codex-hooks.js";
+import { writeDeliveryProvider } from "./delivery-provider.js";
 import { setupNodeExecutable } from "./setup-node.js";
 /** 実行中のNodeに付属するnpmの既定のglobal root。npmのprefixを環境変数や設定で別の場所へ向けていても変わらない。 */
 export function nodeDefaultGlobalRoot(execPath = process.execPath, platform = process.platform) {
@@ -95,6 +96,9 @@ export async function runSetup(options = {}) {
         else
             result.status = "ready";
         if (result.status === "ready") {
+            // ほかの製品がAitermの親配送を頼む入口（aiterm-parent-delivery）の場所を残す。
+            stage = "delivery_provider";
+            (options.provider ?? writeDeliveryProvider)(process.env.HOME ?? homedir(), registration);
             stage = "codex_steer";
             result.codex_steer = await (options.steer ?? configureCodexSteer)(options.codex_steer ?? (codexSteerSelected() ? "enable" : "status"));
             if (["failed", "unsupported", "restart_required"].includes(result.codex_steer.status)) {

package/docs/DESIGN.md

@@ -68,6 +68,10 @@ harnessと中継が自分のために立てるprocessは数えない（Codexの`
 harnessが同じ親の下に同じargvで立て直した起動時のprocessも数えない（ADR 0083）。
 Aitermがprocess表を引くために起こしたprocess（`ps`、WindowsのPowerShellと付いて立つconsole host）も数えない（ADR 0084）。
 中継の後ろで眠っている本体を配送の引き取りのために起こすかは、`aiterm-delivery-wake`が返す（ADR 0082）。
+ほかの製品がCodexの親へ回答を届ける時は、製品のhookを登録せず、`aiterm-parent-delivery`でAitermの親配送へ頼む（ADR 0098）。
+Aitermの登録済みhookと公式キューで届け、設定（`steer`）・受付（`queued_submission_id`）・実際に届いた事（`hook:"emitted"`と`turn_id`）を分けて返す。
+命令の場所は`aiterm-setup`が`~/.config/aiterm-mcp/delivery-provider.json`へ残す。`aiterm-setup`を通らない導入は、
+`dist/setup-integrations.js`の`ensureCodexParentSteer(home)`でCodexのhookを登録する。
 Claude Codeの入力待ちは、起動時の見出しが取得範囲から流れ出た後も、入力欄の形（`❯`行の上下の罫線）で読む。
 画面本文とargv本文は返さず、活動cursorには画面digestとprocess別CPUだけを持たせる。
 初回とpane再作成後の差分はnull。区間中にprocessが消えた時は観測できたCPU増分だけを返し、
@@ -104,6 +108,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回の確かめを通る。
 
 ### 親配送の共通モジュール化（設計）
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.55.3",
+  "version": "0.56.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": [
@@ -44,6 +44,7 @@
     "aiterm-runtime-errors": "dist/runtime-errors-cli.js",
     "aiterm-wait": "dist/aiterm-wait-cli.js",
     "aiterm-delivery-wake": "dist/delivery-wake-cli.js",
+    "aiterm-parent-delivery": "dist/parent-delivery-cli.js",
     "aiterm-update": "dist/update-cli.js"
   },
   "files": [
@@ -71,7 +72,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "aiterm-steer-delivery": "^0.2.3",
+    "aiterm-steer-delivery": "^0.3.0",
     "ws": "8.21.3",
     "zod": "^4.4.3"
   },