aiterm-mcp 0.55.4 → 0.56.1

package/CHANGELOG.md

@@ -7,6 +7,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.56.1] - 2026-10-07
+
+### 修正
+
+- `aiterm-parent-delivery`が、呼ぶ側のPATHにnodeの場所が無い環境でも、nodeで動くCodexの起動役（npm版の`codex`。1行目が
+  `#!/usr/bin/env node`）を起こせるようにする。0.56.0は、そういう環境（素のsshの環境、製品の常駐process、アプリ配下のprocess）から
+  呼ぶと、`codex verify`が`CODEX_RECEIVER_TRANSPORT_FAILED`（exit=127）で断っていた。本文は送られていなかった。
+  - 命令が、自分を動かしているnodeの場所を、起こすCodexのPATHの頭へ足す。既にPATHにあれば何も変えない。
+  - 引数・返りの形は変わらない。Desktop同梱のCodex（macOS・Windows）は元から当たらない。
+
+## [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
 
 ### 変更
@@ -2314,7 +2343,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.4...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.56.1...HEAD
+[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
 [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

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.4** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.56.1** · 動作対象は 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.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).
+**Status:** actively maintained · current public release **v0.56.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
 
@@ -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/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/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/parent-delivery-cli.js

@@ -0,0 +1,208 @@
+#!/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" };
+    }
+}
+/**
+ * 起こすCodexが、この命令を動かしているnodeを見つけられるPATHを返す。
+ * npm版のCodexは`#!/usr/bin/env node`の起動役で、呼ぶ側のPATHにnodeの場所が無いと起きない（exit 127）。製品の常駐processや
+ * アプリ配下のprocessは、PATHが細い事がある（2026-10-07、素のsshの環境からの呼び出しで起きた）。
+ * nodeの場所がPATHに無い時だけ頭へ足す。既にあれば、並びも中身も変えない。
+ */
+export function pathWithNode(env, node = process.execPath, platform = process.platform) {
+    const windows = platform === "win32";
+    // Windowsの環境変数名は大文字小文字を区別しない（`Path`で入っている事が多い）。
+    const key = Object.keys(env).find(name => windows ? name.toLowerCase() === "path" : name === "PATH") ?? "PATH";
+    const delimiter = windows ? ";" : ":";
+    const directory = (windows ? path.win32 : path.posix).dirname(node);
+    const current = env[key] ?? "";
+    const listed = current.split(delimiter).some(part => windows ? part.toLowerCase() === directory.toLowerCase() : part === directory);
+    return { key, value: listed ? current : current ? `${directory}${delimiter}${current}` : directory };
+}
+/** この命令の場所と版。製品側の入口（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 {
+        const found = pathWithNode(process.env);
+        process.env[found.key] = found.value;
+        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増分だけを返し、

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.55.4",
+  "version": "0.56.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": [
@@ -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"
   },