aiterm-mcp 0.42.2 → 0.43.0

package/dist/setup-codex-hooks.js

@@ -1,154 +1,22 @@
-// Steerの正規導入。公式hookを登録・承認してから、旧中継の起動差し替えを解除する。
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { isDeepStrictEqual } from "node:util";
+// Steerの正規導入。公式hookを登録・承認してから、旧中継の起動差し替えを解除する。本体はaiterm-steer-delivery。
 import { fileURLToPath } from "node:url";
-import { currentCodexDesktopBinary } from "./codex-desktop-binary.js";
-import { withCodexReceiver } from "./codex-parent-receiver.js";
-import { realCodexHome } from "./harnesses/codex.js";
-import { SetupError } from "./setup-platform.js";
-import { setupNodeExecutable } from "./setup-node.js";
+import * as steer from "aiterm-steer-delivery";
 import { readRelayConfig } from "./codex-relay-config.js";
-import { configureCodexSteer as configureLegacyRelay, findDesktopBinary } from "./setup-codex-relay.js";
-import { findWindowsCodexBinary } from "./windows-codex-setup.js";
-import { readRuntimeProcesses } from "./process-runtime.js";
-import { resolveWindowsPowerShell7 } from "./windows-powershell.js";
-import { quotePowerShell } from "./windows-codex-state.js";
-import { assertCodexHooksReady, codexHookDirectory, ownedCodexHooks, readCodexHookConfig, writeHookJson } from "./codex-hook-state.js";
+import { configureCodexSteer as configureLegacyRelay } from "./setup-codex-relay.js";
+import { readCodexHookConfig } from "./codex-hook-state.js";
+import { AITERM_PROFILE } from "./steer-profile.js";
 export function codexSteerSelected() { return readCodexHookConfig()?.enabled === true || readRelayConfig()?.enabled === true; }
-export function codexHookCommand(node, hook, directory, platform = process.platform) {
-    if (platform === "win32") {
-        const script = `& ${[node, hook, directory].map(quotePowerShell).join(" ")}; exit $LASTEXITCODE`;
-        // Codexは利用中のPowerShellでhookを評価する。引用した実行パスには呼出し演算子が必要。
-        return `& ${quotePowerShell(resolveWindowsPowerShell7())} -NoLogo -NoProfile -NonInteractive -EncodedCommand ${Buffer.from(script, "utf16le").toString("base64")}`;
-    }
-    return [node, hook, directory].map(value => "'" + value.replace(/'/g, "'\"'\"'") + "'").join(" ");
-}
+export const codexHookCommand = steer.codexHookCommand;
 export function mergeCodexParentHooks(file, command, previousCommand) {
-    if (!fs.existsSync(file)) {
-        try {
-            if (fs.lstatSync(file).isSymbolicLink())
-                throw new SetupError("codex_hook_config_invalid", "hook設定symlinkの参照先がありません");
-        }
-        catch (error) {
-            if (error.code !== "ENOENT")
-                throw error;
-        }
-    }
-    const target = fs.existsSync(file) ? fs.realpathSync(file) : file;
-    let current = {};
-    if (fs.existsSync(target)) {
-        try {
-            current = JSON.parse(fs.readFileSync(target, "utf8"));
-        }
-        catch {
-            throw new SetupError("codex_hook_config_invalid", "Codexのhook設定JSONを読めません");
-        }
-    }
-    const object = (value) => value && typeof value === "object" && !Array.isArray(value);
-    if (!object(current) || (current.hooks !== undefined && !object(current.hooks)))
-        throw new SetupError("codex_hook_config_invalid", "Codexのhooks設定を読めません");
-    const hooks = { ...current.hooks };
-    for (const event of ["PostToolUse", "Stop"]) {
-        const groups = hooks[event] ?? [];
-        if (!Array.isArray(groups) || groups.some(group => !object(group) || !Array.isArray(group.hooks)))
-            throw new SetupError("codex_hook_config_invalid", `${event}のhook設定を読めません`);
-        // 既存の位置で置換する。末尾へ移すと同じ設定の再導入でも変更扱いになり、
-        // 稼働中のCodexへ不要な再起動を要求してしまう。
-        hooks[event] = [];
-        let insertionIndex = null;
-        for (const group of groups) {
-            const remaining = group.hooks.filter((hook) => !(hook?.type === "command" && ((command !== null && hook.command === command) || (previousCommand && hook.command === previousCommand))));
-            if (remaining.length !== group.hooks.length && insertionIndex === null)
-                insertionIndex = hooks[event].length;
-            if (remaining.length)
-                hooks[event].push({ ...group, hooks: remaining });
-        }
-        if (command !== null)
-            hooks[event].splice(insertionIndex ?? hooks[event].length, 0, { ...(event === "PostToolUse" ? { matcher: ".*" } : {}),
-                hooks: [{ type: "command", command, timeout: 20, ...(event === "PostToolUse" ? { additionalContextLimit: 0 } : {}) }] });
-        if (!hooks[event].length)
-            delete hooks[event];
-    }
-    const next = { ...current, hooks };
-    if (isDeepStrictEqual(current, next))
-        return false;
-    if (fs.existsSync(target))
-        fs.copyFileSync(target, `${target}.aiterm-backup`);
-    writeHookJson(target, next);
-    if (!isDeepStrictEqual(JSON.parse(fs.readFileSync(target, "utf8")), next))
-        throw new SetupError("codex_hook_readback_failed", "Codex hookの読戻しが一致しません");
-    return true;
+    return steer.mergeCodexParentHooks(AITERM_PROFILE, file, command, previousCommand);
 }
 export async function verifyCodexHookRegistration(config, approve) {
-    fs.accessSync(config.node, fs.constants.X_OK);
-    fs.accessSync(config.hook, fs.constants.R_OK);
-    const file = path.join(config.codex_home, "hooks.json");
-    await withCodexReceiver({ thread_id: "00000000-0000-4000-8000-000000000000", codex_home: config.codex_home }, async (request) => {
-        const list = () => request("hooks/list", { cwds: [config.codex_home] });
-        const hooks = ownedCodexHooks(await list(), config.command, file);
-        if (approve) {
-            const edits = hooks.filter(hook => !hook.enabled || hook.trustStatus !== "trusted").flatMap(hook => {
-                if (typeof hook.key !== "string" || typeof hook.currentHash !== "string")
-                    throw new SetupError("codex_hook_schema_unknown", "公式hookの承認情報を認識できません");
-                const key = `hooks.state.${JSON.stringify(hook.key)}`;
-                return [
-                    { keyPath: `${key}.trusted_hash`, value: hook.currentHash, mergeStrategy: "replace" },
-                    { keyPath: `${key}.enabled`, value: true, mergeStrategy: "replace" },
-                ];
-            });
-            if (edits.length)
-                await request("config/batchWrite", { edits, filePath: path.join(config.codex_home, "config.toml") });
-        }
-        assertCodexHooksReady(await list(), config.command, file);
-    }, { executable: await currentCodexDesktopBinary(config, { directory: codexHookDirectory() }) });
+    await steer.verifyCodexHookRegistration(AITERM_PROFILE, config, approve);
 }
 export async function configureCodexSteer(action = "status", overrides = {}) {
-    const runtime = { platform: process.platform, directory: codexHookDirectory(), codex_home: realCodexHome(),
-        node: process.execPath, hook: fileURLToPath(new URL("./codex-parent-hook.js", import.meta.url)),
-        findBinary: process.platform === "win32" ? findWindowsCodexBinary : findDesktopBinary,
-        processes: readRuntimeProcesses, legacy: readRelayConfig,
-        disableLegacy: () => configureLegacyRelay("disable"), verify: verifyCodexHookRegistration, ...overrides };
-    const previous = readCodexHookConfig(runtime.directory);
-    const legacy = runtime.legacy();
-    const file = path.join(action === "disable" && previous ? previous.codex_home : runtime.codex_home, "hooks.json");
-    const save = (config) => writeHookJson(path.join(runtime.directory, "config.json"), config);
-    const needsRestart = (config) => runtime.processes().some(process => config.stale_processes.some(stale => stale.pid === process.pid && stale.started_identity === process.started_identity));
-    if (action === "status") {
-        if (!previous?.enabled)
-            return legacy?.enabled ? { status: "failed", reason_code: "codex_steer_migration_required" } : { status: "disabled" };
-        await runtime.verify(previous, false);
-        return legacy?.enabled || needsRestart(previous) ? { status: "restart_required", reason_code: "codex_restart_required" } : { status: "ready" };
-    }
-    if (action === "disable") {
-        if (previous?.enabled) {
-            mergeCodexParentHooks(file, null, previous.command);
-            save({ ...previous, enabled: false });
-        }
-        if (legacy?.enabled)
-            return runtime.disableLegacy();
-        return previous?.enabled ? { status: "restart_required", reason_code: "codex_restart_required" } : { status: "disabled" };
-    }
-    if (!["darwin", "win32"].includes(runtime.platform))
-        return { status: "unsupported", reason_code: "codex_steer_platform_unsupported" };
-    if (previous?.enabled && fs.realpathSync(previous.codex_home) !== fs.realpathSync(runtime.codex_home))
-        throw new SetupError("codex_steer_configuration_conflict", "別のCODEX_HOMEでSteerが有効です。先に既存の選択を解除してください");
-    const node = setupNodeExecutable(runtime.node);
-    fs.accessSync(node, fs.constants.X_OK);
-    fs.accessSync(runtime.hook, fs.constants.R_OK);
-    const binary = runtime.findBinary();
-    const command = codexHookCommand(node, runtime.hook, runtime.directory, runtime.platform);
-    const changed = mergeCodexParentHooks(file, command, previous?.command);
-    const stale = !previous?.enabled || changed || legacy?.enabled
-        ? runtime.processes().filter(row => row.executable === binary || row.command.startsWith(binary + " "))
-            .map(({ pid, started_identity }) => ({ pid, started_identity }))
-        : previous.stale_processes;
-    const config = { schema: "aiterm.codex-parent-hooks.v1", enabled: true,
-        codex_home: runtime.codex_home, binary, command, node, hook: runtime.hook, stale_processes: stale };
-    await runtime.verify(config, true);
-    // 解除が中断しても、次のenableで移行を続行できるよう所有情報を先に保存する。
-    save(config);
-    if (legacy?.enabled)
-        await runtime.disableLegacy();
-    return needsRestart(config) ? { status: "restart_required", reason_code: "codex_restart_required" } : { status: "ready" };
+    return steer.configureCodexSteer(AITERM_PROFILE, action, {
+        hook: fileURLToPath(new URL("./codex-parent-hook.js", import.meta.url)),
+        legacy: readRelayConfig, disableLegacy: () => configureLegacyRelay("disable"), verify: verifyCodexHookRegistration,
+        ...overrides,
+    });
 }

package/dist/setup-integrations.js

@@ -3,8 +3,10 @@ import { copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, realpathS
 import { dirname, join } from "node:path";
 import { randomUUID } from "node:crypto";
 import { isDeepStrictEqual } from "node:util";
+import * as steer from "aiterm-steer-delivery";
 import { resolveAgentBin } from "./agent-resolver.js";
 import { SetupError, runSetupCommand } from "./setup-platform.js";
+import { AITERM_PROFILE } from "./steer-profile.js";
 export { powershellInvocation } from "./setup-platform.js";
 const record = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 export function mergeJsonMcp(file, registration) {
@@ -56,215 +58,28 @@ export function mergeJsonMcp(file, registration) {
     }
     return "configured";
 }
+// 配送hookの登録・解除はaiterm-steer-delivery。hook入口はMCP登録と同じdist directoryに置く。
+function hookRuntime(registration, file) {
+    return { command: registration.command, script: join(dirname(registration.args[0]), file) };
+}
 export function claudeParentHookEntries(registration) {
-    const command = { type: "command", command: registration.command, args: [join(dirname(registration.args[0]), "claude-parent-hook.js")] };
-    const matcher = "^mcp__aiterm__(agent_launch|claude_agent|codex_agent|grok_agent|pty_send|claude_turn)$";
-    return {
-        PreToolUse: [{ matcher, hooks: [{ ...command, timeout: 15 }] }],
-        PostToolUse: [{ matcher, hooks: [{ ...command, asyncRewake: true, timeout: 86400 }] }],
-        SessionEnd: [{ hooks: [{ ...command, timeout: 15 }] }],
-    };
+    return steer.claudeParentHookEntries(AITERM_PROFILE, hookRuntime(registration, AITERM_PROFILE.hooks.claude));
 }
 export function mergeClaudeParentHooks(file, registration) {
-    const target = existsSync(file) ? realpathSync(file) : file;
-    let current = {};
-    if (existsSync(target)) {
-        try {
-            current = JSON.parse(readFileSync(target, "utf8"));
-        }
-        catch {
-            throw new SetupError("config_invalid", "Claudeのhook設定JSONを読めません");
-        }
-    }
-    if (!record(current) || (current.hooks !== undefined && !record(current.hooks))) {
-        throw new SetupError("config_invalid", "Claudeのhooks設定はobjectである必要があります");
-    }
-    if (current.disableAllHooks === true)
-        throw new SetupError("claude_parent_hooks_disabled", "Claudeのhookが無効です。disableAllHooksをfalseに変更してからsetupしてください");
-    const hooks = { ...current.hooks };
-    for (const [event, additions] of Object.entries(claudeParentHookEntries(registration))) {
-        const previous = hooks[event] ?? [];
-        if (!Array.isArray(previous) || previous.some(group => !record(group) || !Array.isArray(group.hooks))) {
-            throw new SetupError("config_invalid", `Claudeの${event} hook形式を読めません`);
-        }
-        // 他製品のhookとmatcherはそのまま保ち、当製品の専用entryだけを更新する。
-        const retained = previous.map(group => ({ ...group, hooks: group.hooks.filter(hook => !isClaudeParentHook(hook))
-        })).filter(group => group.hooks.length > 0);
-        hooks[event] = [...retained, ...additions];
-    }
-    const next = { ...current, hooks };
-    if (isDeepStrictEqual(current, next))
-        return "unchanged";
-    mkdirSync(dirname(target), { recursive: true });
-    const temporary = `${target}.aiterm-${randomUUID()}`;
-    try {
-        writeFileSync(temporary, `${JSON.stringify(next, null, 2)}\n`, { mode: 0o600, flag: "wx" });
-        if (existsSync(target))
-            copyFileSync(target, `${target}.aiterm-backup`);
-        renameSync(temporary, target);
-    }
-    finally {
-        if (existsSync(temporary))
-            unlinkSync(temporary);
-    }
-    if (!isDeepStrictEqual(JSON.parse(readFileSync(target, "utf8")), next)) {
-        throw new SetupError("config_readback_failed", "Claudeのhook登録の読戻しが一致しません");
-    }
-    return "configured";
-}
-function isClaudeParentHook(hook) {
-    return record(hook) && hook.type === "command" && Array.isArray(hook.args)
-        && typeof hook.args[0] === "string" && /[/\\]claude-parent-hook\.js$/.test(hook.args[0]);
+    return steer.mergeClaudeParentHooks(AITERM_PROFILE, file, hookRuntime(registration, AITERM_PROFILE.hooks.claude));
 }
 /** hookを持たない旧版へ戻す前に、当製品の登録だけを除く。 */
 export function removeClaudeParentHooks(file) {
-    if (!existsSync(file))
-        return "unchanged";
-    const target = realpathSync(file);
-    const current = JSON.parse(readFileSync(target, "utf8"));
-    if (!record(current) || (current.hooks !== undefined && !record(current.hooks))) {
-        throw new SetupError("config_invalid", "Claudeのhook設定を読めません");
-    }
-    if (current.hooks === undefined)
-        return "unchanged";
-    const hooks = { ...current.hooks };
-    for (const event of ["PreToolUse", "PostToolUse", "SessionEnd"]) {
-        if (hooks[event] === undefined)
-            continue;
-        if (!Array.isArray(hooks[event]))
-            throw new SetupError("config_invalid", "Claudeのhook設定を読めません");
-        hooks[event] = hooks[event].map(group => {
-            if (!record(group) || !Array.isArray(group.hooks))
-                throw new SetupError("config_invalid", "Claudeのhook設定を読めません");
-            return { ...group, hooks: group.hooks.filter(hook => !isClaudeParentHook(hook)) };
-        }).filter(group => group.hooks.length > 0);
-    }
-    const next = { ...current, hooks };
-    if (isDeepStrictEqual(current, next))
-        return "unchanged";
-    const temporary = `${target}.aiterm-${randomUUID()}`;
-    try {
-        writeFileSync(temporary, `${JSON.stringify(next, null, 2)}\n`, { mode: 0o600, flag: "wx" });
-        copyFileSync(target, `${target}.aiterm-backup`);
-        renameSync(temporary, target);
-    }
-    finally {
-        if (existsSync(temporary))
-            unlinkSync(temporary);
-    }
-    if (!isDeepStrictEqual(JSON.parse(readFileSync(target, "utf8")), next))
-        throw new SetupError("config_readback_failed", "Claude hook解除の読戻しが一致しません");
-    return "removed";
-}
-function shellQuote(value) {
-    if (process.platform === "win32")
-        return `'${value.replace(/'/g, "''")}'`;
-    return `'${value.replace(/'/g, `'"'"'`)}'`;
+    return steer.removeClaudeParentHooks(AITERM_PROFILE, file);
 }
 export function cursorParentHookCommand(registration) {
-    const script = join(dirname(registration.args[0]), "cursor-parent-hook.js");
-    const command = `${shellQuote(registration.command)} ${shellQuote(script)}`;
-    return process.platform === "win32" ? `& ${command}` : command;
-}
-function ownsCursorParentHook(hook) {
-    return record(hook) && typeof hook.command === "string" && hook.command.includes("cursor-parent-hook.js");
+    return steer.cursorParentHookCommand(hookRuntime(registration, AITERM_PROFILE.hooks.cursor));
 }
 export function mergeCursorParentHooks(file, registration) {
-    const target = existsSync(file) ? realpathSync(file) : file;
-    let current = { version: 1, hooks: {} };
-    if (existsSync(target)) {
-        try {
-            current = JSON.parse(readFileSync(target, "utf8"));
-        }
-        catch {
-            throw new SetupError("config_invalid", "Cursorのhook設定JSONを読めません");
-        }
-    }
-    else {
-        try {
-            if (lstatSync(file).isSymbolicLink())
-                throw new SetupError("config_invalid", "Cursorのhooks設定symlinkの参照先がありません");
-        }
-        catch (error) {
-            if (error.code !== "ENOENT")
-                throw error;
-        }
-    }
-    if (!record(current) || (current.hooks !== undefined && !record(current.hooks))) {
-        throw new SetupError("config_invalid", "Cursorのhooks設定はobjectである必要があります");
-    }
-    const hooks = { ...current.hooks };
-    const entry = { command: cursorParentHookCommand(registration), timeout: 15 };
-    for (const event of ["afterMCPExecution", "postToolUse"]) {
-        const previous = hooks[event] ?? [];
-        if (!Array.isArray(previous))
-            throw new SetupError("config_invalid", `Cursorの${event} hook形式を読めません`);
-        const retained = previous.filter(hook => !ownsCursorParentHook(hook));
-        const owned = previous.filter(hook => ownsCursorParentHook(hook));
-        if (owned.length === 1 && isDeepStrictEqual(owned[0], entry) && retained.length + 1 === previous.length)
-            continue;
-        const index = previous.findIndex(hook => ownsCursorParentHook(hook));
-        hooks[event] = index < 0 ? [...retained, entry] : previous.map((hook, i) => i === index ? entry : hook).filter((hook, i) => i === index || !ownsCursorParentHook(hook));
-    }
-    const next = { ...current, version: current.version ?? 1, hooks };
-    if (isDeepStrictEqual(current, next))
-        return "unchanged";
-    mkdirSync(dirname(target), { recursive: true });
-    const temporary = `${target}.aiterm-${randomUUID()}`;
-    try {
-        writeFileSync(temporary, `${JSON.stringify(next, null, 2)}\n`, { mode: 0o600, flag: "wx" });
-        if (existsSync(target))
-            copyFileSync(target, `${target}.aiterm-backup`);
-        renameSync(temporary, target);
-    }
-    finally {
-        if (existsSync(temporary))
-            unlinkSync(temporary);
-    }
-    if (!isDeepStrictEqual(JSON.parse(readFileSync(target, "utf8")), next)) {
-        throw new SetupError("config_readback_failed", "Cursorのhook登録の読戻しが一致しません");
-    }
-    return "configured";
+    return steer.mergeCursorParentHooks(AITERM_PROFILE, file, hookRuntime(registration, AITERM_PROFILE.hooks.cursor));
 }
 export function removeCursorParentHooks(file) {
-    if (!existsSync(file))
-        return "unchanged";
-    const target = realpathSync(file);
-    const current = JSON.parse(readFileSync(target, "utf8"));
-    if (!record(current) || (current.hooks !== undefined && !record(current.hooks))) {
-        throw new SetupError("config_invalid", "Cursorのhook設定を読めません");
-    }
-    if (current.hooks === undefined)
-        return "unchanged";
-    const hooks = { ...current.hooks };
-    for (const event of ["afterMCPExecution", "postToolUse"]) {
-        if (hooks[event] === undefined)
-            continue;
-        if (!Array.isArray(hooks[event]))
-            throw new SetupError("config_invalid", "Cursorのhook設定を読めません");
-        const retained = hooks[event].filter(hook => !ownsCursorParentHook(hook));
-        if (retained.length)
-            hooks[event] = retained;
-        else
-            delete hooks[event];
-    }
-    const next = { ...current, hooks };
-    if (isDeepStrictEqual(current, next))
-        return "unchanged";
-    const temporary = `${target}.aiterm-${randomUUID()}`;
-    try {
-        writeFileSync(temporary, `${JSON.stringify(next, null, 2)}\n`, { mode: 0o600, flag: "wx" });
-        copyFileSync(target, `${target}.aiterm-backup`);
-        renameSync(temporary, target);
-    }
-    finally {
-        if (existsSync(temporary))
-            unlinkSync(temporary);
-    }
-    if (!isDeepStrictEqual(JSON.parse(readFileSync(target, "utf8")), next)) {
-        throw new SetupError("config_readback_failed", "Cursor hook解除の読戻しが一致しません");
-    }
-    return "removed";
+    return steer.removeCursorParentHooks(AITERM_PROFILE, file);
 }
 export function configureIntegrations(home, registration, run = runSetupCommand, resolveClient = resolveAgentBin) {
     const results = {};

package/dist/setup-platform.js

@@ -4,13 +4,9 @@ import { existsSync, readFileSync } from "node:fs";
 import { resolveWindowsPowerShell7 } from "./windows-powershell.js";
 import { resolveWinPaneShell } from "./agent-resolver.js";
 import { ensureWinPsmux, resolveTmux } from "./tmux-runtime.js";
-export class SetupError extends Error {
-    code;
-    constructor(code, message) {
-        super(message);
-        this.code = code;
-    }
-}
+// setupの失敗は配送パッケージと同じclassにする。パッケージのsetupが投げたものも同じreason_codeで返す。
+import { SetupError } from "aiterm-steer-delivery";
+export { SetupError };
 export function powershellInvocation(command, args) {
     const literal = (value) => `'${value.replaceAll("'", "''")}'`;
     const script = `& ${[command, ...args].map(literal).join(" ")}; if ($null -eq $LASTEXITCODE) { exit 1 }; exit $LASTEXITCODE`;

package/dist/steer-profile.js

@@ -0,0 +1,18 @@
+// Aitermがaiterm-steer-deliveryへ渡す製品の識別情報。保存場所・hook入口の名前・案内文は従来のまま。
+import * as path from "node:path";
+import { ensureStateRoot } from "./agent-shared.js";
+import { relayConfigDirectory } from "./codex-relay-config.js";
+export const AITERM_PROFILE = {
+    id: "aiterm",
+    display_name: "Aiterm",
+    setup_command: "aiterm-setup",
+    codex_steer_command: "aiterm-setup --codex-steer enable",
+    mcp_server: "aiterm",
+    dispatch_tools: ["agent_launch", "claude_agent", "codex_agent", "grok_agent", "pty_send", "claude_turn"],
+    state_root: ensureStateRoot,
+    config_root: () => path.dirname(relayConfigDirectory()),
+    hooks: { codex: "codex-parent-hook.js", claude: "claude-parent-hook.js", cursor: "cursor-parent-hook.js" },
+    codex_client_name: "aiterm_parent_delivery",
+    codex_hook_schema: "aiterm.codex-parent-hooks.v1",
+    backup_suffix: ".aiterm-backup",
+};

package/docs/00_overview.md

@@ -19,6 +19,8 @@ Grok／Composerのsandbox起動拒否については、[DESIGNの失敗と復旧
 
 Codex親への回答の自動配送は[DESIGN](DESIGN.md#codex親への自動配送)に、対応範囲と失敗時の状態を置く。
 Claude Code親の非同期hookによる受信は[DESIGN](DESIGN.md#claude-code親への自動配送)を参照する。
+親配送の共通モジュール化は[DESIGNの共通化設計](DESIGN.md#親配送の共通モジュール化設計)を参照する。
+共通化は設計段階であり、稼働済みAitermを正本とする。
 
 ## 履歴と証拠
 

package/docs/DESIGN.md

@@ -75,6 +75,14 @@ Grokは待ち行列へ入れた後に「send now」を押す。旧turnは`cancel
 Cursorのsubmitはadapterがextended keyboard protocolのEnterへ変換し、呼び出し側は通常のdispatchだけを使う。
 起動直後のClaude sessionへの初回dispatchは、他harnessと同じくTUIの入力受付を確認してから貼付とEnterを送る。
 
+### 親配送の共通モジュール化（設計）
+
+共通化の正本は、正常稼働しているAitermの親配送実装と挙動である。他製品との差分はAitermへ揃える。
+親の識別、配送、hook、配送固有state、導入・診断を独立packageへ抽出し、各製品が通常の依存として使う。
+各製品の完了観測・本文作成・job台帳は各製品に残し、hook登録と保存場所も製品ごとに維持する。
+実装・移行は未実施であり、以下に記す現行契約はそのまま有効である。
+公開API、抽出元、移行と受入条件は[ADR 0073](https://github.com/kitepon/aiterm-mcp/blob/main/docs/adr/0073-parent-delivery-module.md)に定める。
+
 ### Codex親への自動配送
 
 `src/parent-delivery.ts`が依頼の送信前に宛先と完了境界を保存し、完了観測、加工前の回答保存、配送を所有する。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.42.2",
+  "version": "0.43.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": [
@@ -70,6 +70,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "aiterm-steer-delivery": "^0.1.0",
     "ws": "8.21.3",
     "zod": "^4.4.3"
   },