aiterm-mcp 0.42.2 → 0.43.0

package/dist/codex-parent-receiver.js

@@ -1,25 +1,13 @@
 // Codex親の配送は公式queueを使う。旧中継の選択はsetupで移行するまで維持する。
-import { spawn } from "node:child_process";
-import { createInterface } from "node:readline";
-import * as path from "node:path";
-import { resolveAgentBin } from "./agent-resolver.js";
-import { realCodexHome } from "./harnesses/codex.js";
+// 公式queueの配送はaiterm-steer-deliveryが持ち、旧中継（relay）だけをAitermに残す。
+import * as steer from "aiterm-steer-delivery";
 import { CodexDeliveryError } from "./codex-delivery-error.js";
 import { readRelayConfig, parentRelaySocket } from "./codex-relay-config.js";
 import { withCodexRelay, verifyLoadedParent } from "./codex-relay-client.js";
-import { currentCodexDesktopBinary } from "./codex-desktop-binary.js";
-import { finishCodexHookSubmission, assertCodexHookParentCurrent, assertCodexHooksReady, codexHookDirectory, readCodexHookConfig, registerCodexHookInput } from "./codex-hook-state.js";
-export { CodexDeliveryError } from "./codex-delivery-error.js";
-/** modelの引数ではなく、CodexがMCP要求へ付けるmetadataだけを宛先にする。 */
-export function codexParentFromRequest(clientName, metadata) {
-    if (clientName !== "codex-mcp-client")
-        return null;
-    const threadId = metadata?.threadId;
-    if (typeof threadId !== "string" || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(threadId)) {
-        throw new CodexDeliveryError("CODEX_PARENT_ID_UNAVAILABLE", "MCP要求に親のthreadIdがありません。対応するCodexへ更新してください");
-    }
-    return { thread_id: threadId, codex_home: path.resolve(realCodexHome()) };
-}
+import { readCodexHookConfig } from "./codex-hook-state.js";
+import { AITERM_PROFILE } from "./steer-profile.js";
+export { CodexDeliveryError };
+export const codexParentFromRequest = steer.codexParentFromRequest;
 function relaySocket(runtime) {
     if (runtime)
         return runtime.socket_path ?? null;
@@ -29,87 +17,7 @@ function relaySocket(runtime) {
     return config?.enabled ? parentRelaySocket(config) : null;
 }
 export async function withCodexReceiver(parent, action, runtime = {}) {
-    const config = runtime.executable ? null : readCodexHookConfig();
-    const executable = runtime.executable ?? (config?.enabled ? await currentCodexDesktopBinary(config) : null) ?? resolveAgentBin("codex");
-    if (!executable)
-        throw new CodexDeliveryError("CODEX_RECEIVER_UNAVAILABLE", "Codexの実行ファイルを確認できません");
-    const child = spawn(executable, runtime.args ?? ["app-server", "--listen", "stdio://"], {
-        stdio: ["pipe", "pipe", "ignore"],
-        env: { ...process.env, CODEX_HOME: parent.codex_home },
-        windowsHide: true,
-    });
-    const pending = new Map();
-    let sequence = 0;
-    let stopped = false;
-    let transportError = null;
-    const failTransport = (message) => {
-        transportError = message;
-        for (const item of pending.values()) {
-            clearTimeout(item.timer);
-            item.reject(new CodexDeliveryError("CODEX_RECEIVER_TRANSPORT_FAILED", message, item.method === "thread/queue/add"));
-        }
-        pending.clear();
-    };
-    child.on("error", (error) => failTransport(`Codexを起動できません（${error.code ?? "unknown"}）`));
-    child.stdin.on("error", (error) => failTransport(`Codexへの書込みに失敗しました（${error.code ?? "unknown"}）`));
-    const exited = new Promise((resolve) => child.once("close", (code, signal) => {
-        if (!stopped)
-            failTransport(`Codexの接続が終了しました（exit=${code}, signal=${signal}）`);
-        resolve();
-    }));
-    const reader = createInterface({ input: child.stdout });
-    reader.on("line", (line) => {
-        let value;
-        try {
-            value = JSON.parse(line);
-        }
-        catch {
-            failTransport("Codexが不正なJSON応答を返しました");
-            return;
-        }
-        const item = pending.get(value?.id);
-        if (!item)
-            return;
-        clearTimeout(item.timer);
-        pending.delete(value.id);
-        if (value.error) {
-            item.reject(new CodexDeliveryError("CODEX_RECEIVER_REJECTED", typeof value.error.message === "string" ? value.error.message : "公式受信口が要求を拒否しました"));
-        }
-        else if ("result" in value)
-            item.resolve(value.result);
-        else
-            item.reject(new CodexDeliveryError("CODEX_RECEIVER_INVALID_RESPONSE", "公式受信口の応答にresultがありません", item.method === "thread/queue/add"));
-    });
-    const request = (method, params) => new Promise((resolve, reject) => {
-        if (transportError) {
-            reject(new CodexDeliveryError("CODEX_RECEIVER_TRANSPORT_FAILED", transportError));
-            return;
-        }
-        const id = ++sequence;
-        const timer = setTimeout(() => {
-            pending.delete(id);
-            reject(new CodexDeliveryError("CODEX_RECEIVER_TIMEOUT", `${method}の応答を確認できません`, method === "thread/queue/add"));
-        }, runtime.timeout_ms ?? 15_000);
-        pending.set(id, { resolve, reject, timer, method });
-        child.stdin.write(JSON.stringify({ id, method, params }) + "\n");
-    });
-    try {
-        await request("initialize", { clientInfo: { name: "aiterm_parent_delivery", version: "1" }, capabilities: { experimentalApi: true } });
-        child.stdin.write(JSON.stringify({ method: "initialized" }) + "\n");
-        return await action(request);
-    }
-    finally {
-        stopped = true;
-        for (const item of pending.values())
-            clearTimeout(item.timer);
-        pending.clear();
-        child.stdin.end();
-        // stdio終了を公式processへ伝える。終了しない外部processだけを明示的に停止する。
-        const terminate = setTimeout(() => child.kill("SIGKILL"), 2_000);
-        await exited;
-        clearTimeout(terminate);
-        reader.close();
-    }
+    return steer.withCodexReceiver(AITERM_PROFILE, parent, action, runtime);
 }
 /** 子へ送る前に、同じstoreの宛先と公式キューの対応を確認する。本文は保存・表示しない。 */
 export async function verifyCodexParent(parent, runtime) {
@@ -118,22 +26,7 @@ export async function verifyCodexParent(parent, runtime) {
         await withCodexRelay(socket, request => verifyLoadedParent(request, parent.thread_id), runtime?.timeout_ms);
         return;
     }
-    await withCodexReceiver(parent, async (request) => {
-        const response = await request("thread/read", { threadId: parent.thread_id, includeTurns: false });
-        if (response?.thread?.id !== parent.thread_id) {
-            throw new CodexDeliveryError("CODEX_PARENT_UNAVAILABLE", "同じCodex環境で親threadを確認できません");
-        }
-        const subagent = response.thread.source?.subAgent;
-        if (subagent && typeof subagent === "object" && "thread_spawn" in subagent) {
-            throw new CodexDeliveryError("CODEX_PARENT_UNSUPPORTED", "Codexのnative sub-agentは外部processからのキュー入力を受け付けません");
-        }
-        await request("thread/queue/list", { threadId: parent.thread_id, limit: 1 });
-        const config = runtime ? (runtime.hook_directory ? readCodexHookConfig(runtime.hook_directory) : null) : readCodexHookConfig();
-        if (config?.enabled) {
-            assertCodexHookParentCurrent(config);
-            assertCodexHooksReady(await request("hooks/list", { cwds: [response.thread.cwd] }), config.command, path.join(parent.codex_home, "hooks.json"));
-        }
-    }, runtime);
+    await steer.verifyCodexParent(AITERM_PROFILE, parent, runtime);
 }
 export async function submitCodexParentAnswer(parent, deliveryId, text, runtime) {
     const socket = relaySocket(runtime);
@@ -149,25 +42,5 @@ export async function submitCodexParentAnswer(parent, deliveryId, text, runtime)
             return { queued_submission_id: null };
         }, runtime?.timeout_ms);
     }
-    const root = runtime ? runtime.hook_directory : codexHookDirectory();
-    const hook = root && readCodexHookConfig(root)?.enabled;
-    if (hook)
-        registerCodexHookInput(parent.codex_home, parent.thread_id, deliveryId, text, root);
-    try {
-        return await withCodexReceiver(parent, async (request) => {
-            const result = await request("thread/queue/add", {
-                threadId: parent.thread_id,
-                input: [{ type: "text", text, text_elements: [] }],
-                clientUserMessageId: deliveryId,
-            });
-            if (typeof result?.queuedSubmission?.id !== "string") {
-                throw new CodexDeliveryError("CODEX_RECEIVER_INVALID_RESPONSE", "キューの受付IDを確認できません", true);
-            }
-            return { queued_submission_id: result.queuedSubmission.id };
-        }, runtime);
-    }
-    finally {
-        if (hook)
-            finishCodexHookSubmission(parent.codex_home, parent.thread_id, deliveryId, root);
-    }
+    return steer.submitCodexParentAnswer(AITERM_PROFILE, parent, deliveryId, text, runtime);
 }

package/dist/cursor-parent-hook.js

@@ -1,35 +1,6 @@
 #!/usr/bin/env node
-// Cursorが起動する公式hook。MCP stdioとは別processで、差し込み文をstdoutのJSONへ返す。
-import { fileURLToPath } from "node:url";
-import * as fs from "node:fs";
-import { handleCursorHook } from "./cursor-parent-receiver.js";
-async function main() {
-    let input = "";
-    process.stdin.setEncoding("utf8");
-    for await (const chunk of process.stdin)
-        input += chunk;
-    const result = await handleCursorHook(input.length > 0 ? input : "{}");
-    process.stdout.write(`${JSON.stringify(result)}\n`);
-}
-function isDirectExecution() {
-    const entry = process.argv[1];
-    if (!entry)
-        return false;
-    try {
-        const self = fileURLToPath(import.meta.url);
-        const a = fs.realpathSync(entry);
-        const b = fs.realpathSync(self);
-        if (a === b)
-            return true;
-        return process.platform === "win32" && a.toLowerCase() === b.toLowerCase();
-    }
-    catch {
-        return false;
-    }
-}
-if (isDirectExecution()) {
-    main().catch(error => {
-        process.stderr.write(`${error instanceof Error ? error.message : "CURSOR_PARENT_HOOK_FAILED"}\n`);
-        process.exitCode = 2;
-    });
-}
+// Cursorが起動する公式hook。MCP stdioとは別processで、差し込み文をstdoutのJSONへ返す。本体はaiterm-steer-delivery。
+import { isDirectExecution, runCursorHookMain } from "aiterm-steer-delivery";
+import { AITERM_PROFILE } from "./steer-profile.js";
+if (isDirectExecution(import.meta.url))
+    await runCursorHookMain(AITERM_PROFILE);

package/dist/cursor-parent-receive.js

@@ -1,56 +1,17 @@
 #!/usr/bin/env node
-// Cursor親がidleのとき、背景で起動して回答本文の到着を待つ受け口。
+// Cursor親がidleのとき、背景で起動して回答本文の到着を待つ受け口。本体はaiterm-steer-delivery。
 import { fileURLToPath } from "node:url";
-import * as fs from "node:fs";
-import { cursorHookRoot, receiveCursorAnswer } from "./cursor-parent-receiver.js";
-import { windowsStartProcessArgumentList } from "./core.js";
+import * as steer from "aiterm-steer-delivery";
+import { cursorHookRoot } from "./cursor-parent-receiver.js";
 export function cursorReceiveProcess(deliveryId, executable = process.execPath) {
-    const args = [fileURLToPath(import.meta.url), "--delivery", deliveryId];
-    return {
-        executable,
-        args,
-        windows_start_process_argument_list: process.platform === "win32" ? windowsStartProcessArgumentList(args) : null,
-    };
-}
-function emit(value) {
-    process.stdout.write(JSON.stringify(value) + "\n");
+    return steer.cursorReceiveProcess(fileURLToPath(import.meta.url), deliveryId, executable);
 }
 export async function main(argv) {
-    if (argv.length !== 2 || argv[0] !== "--delivery" || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(argv[1])) {
-        emit({ ok: false, code: "CURSOR_PARENT_RECEIVE_USAGE", message: "usage: cursor-parent-receive --delivery <uuid>" });
-        return 1;
-    }
-    const result = await receiveCursorAnswer(cursorHookRoot(), argv[1]);
-    if (result.outcome === "timeout") {
-        emit({ delivery_id: argv[1], outcome: "timeout" });
-        return 3;
-    }
-    if (result.outcome === "delivered_by_hook") {
-        emit({ delivery_id: argv[1], outcome: "delivered_by_hook" });
-        return 0;
-    }
-    emit({ delivery_id: argv[1], outcome: "delivered", text: result.text });
-    return 0;
-}
-function isDirectExecution() {
-    const entry = process.argv[1];
-    if (!entry)
-        return false;
-    try {
-        const self = fileURLToPath(import.meta.url);
-        const a = fs.realpathSync(entry);
-        const b = fs.realpathSync(self);
-        if (a === b)
-            return true;
-        return process.platform === "win32" && a.toLowerCase() === b.toLowerCase();
-    }
-    catch {
-        return false;
-    }
+    return steer.runCursorReceive(cursorHookRoot(), argv);
 }
-if (isDirectExecution()) {
+if (steer.isDirectExecution(import.meta.url)) {
     main(process.argv.slice(2)).then(code => { process.exitCode = code; }).catch(error => {
-        emit({ ok: false, code: "CURSOR_PARENT_RECEIVE_FAILED", message: error instanceof Error ? error.message : "cursor-parent-receive: operation failed" });
+        process.stdout.write(JSON.stringify({ ok: false, code: "CURSOR_PARENT_RECEIVE_FAILED", message: error instanceof Error ? error.message : "cursor-parent-receive: operation failed" }) + "\n");
         process.exitCode = 1;
     });
 }

package/dist/cursor-parent-receiver.js

@@ -1,255 +1,24 @@
 // Cursor親の受信口。会話への差し込みはCursor公式hookのadditional_context、idle時の起床は受け口processが担う。
-import * as fs from "node:fs";
-import { homedir } from "node:os";
+// 本体はaiterm-steer-delivery。
 import * as path from "node:path";
 import { z } from "zod";
-import { ensureStateRoot, waitForFileState, writeJson0600 } from "./agent-shared.js";
-import { AitermError } from "./errors.js";
-export const cursorParentSchema = z.object({
-    kind: z.literal("cursor"),
-    hook_root: z.string(),
-}).strict();
-const deliveryIdSchema = z.string().uuid();
-const dispatchTools = new Set([
-    "agent_launch", "claude_agent", "codex_agent", "grok_agent", "pty_send", "claude_turn",
-]);
-export class CursorDeliveryError extends AitermError {
-    delivery_code;
-    outcome_unknown;
-    constructor(delivery_code, message, outcome_unknown = false) {
-        super(`${delivery_code}: ${message}`, 2);
-        this.delivery_code = delivery_code;
-        this.outcome_unknown = outcome_unknown;
-    }
-}
-export function isCursorMcpClient(clientName) {
-    if (clientName === undefined)
-        return false;
-    return clientName === "cursor-vscode" || clientName.startsWith("cursor-vscode ");
-}
+import * as steer from "aiterm-steer-delivery";
+import { ensureStateRoot } from "./agent-shared.js";
+import { AITERM_PROFILE } from "./steer-profile.js";
+// 配送記録の検証はAitermのzodで行う（パッケージのschemaと同じ形）。
+export const cursorParentSchema = z.object({ kind: z.literal("cursor"), hook_root: z.string() }).strict();
+export const CursorDeliveryError = steer.CursorDeliveryError;
+export const { isCursorMcpClient, cursorHooksFile, prepareCursorDelivery, submitCursorParentAnswer, receiveCursorAnswer } = steer;
 export function cursorHookRoot(state = ensureStateRoot()) {
     return path.join(state, "cursor-parent-hooks");
 }
-export function cursorHooksFile(home = process.env.HOME ?? homedir()) {
-    return path.join(process.env.CURSOR_HOME ?? path.join(home, ".cursor"), "hooks.json");
-}
-export function cursorParentHooksRegistered(document) {
-    if (document === null || typeof document !== "object" || Array.isArray(document))
-        return false;
-    const hooks = document.hooks;
-    if (hooks === null || typeof hooks !== "object" || Array.isArray(hooks))
-        return false;
-    const owns = (event) => {
-        const list = hooks[event];
-        return Array.isArray(list) && list.some(entry => {
-            if (entry === null || typeof entry !== "object")
-                return false;
-            const command = entry.command;
-            return typeof command === "string" && command.includes("cursor-parent-hook.js");
-        });
-    };
-    return owns("postToolUse") && owns("afterMCPExecution");
-}
-export function verifyCursorParent(parent, hooksFile = cursorHooksFile()) {
-    cursorParentSchema.parse(parent);
-    let document;
-    try {
-        document = JSON.parse(fs.readFileSync(hooksFile, "utf8"));
-    }
-    catch {
-        throw new CursorDeliveryError("CURSOR_PARENT_HOOK_UNAVAILABLE", "Cursorのhookが登録されていません。aiterm-setupを実行してください");
-    }
-    if (!cursorParentHooksRegistered(document)) {
-        throw new CursorDeliveryError("CURSOR_PARENT_HOOK_UNAVAILABLE", "Cursorのhookが登録されていません。aiterm-setupを実行してください");
-    }
-}
+export function cursorParentHooksRegistered(document) { return steer.cursorParentHooksRegistered(AITERM_PROFILE, document); }
+export function verifyCursorParent(parent, hooksFile = cursorHooksFile()) { steer.verifyCursorParent(AITERM_PROFILE, parent, hooksFile); }
 export function cursorParentFromRequest(clientName, options = {}) {
     if (!isCursorMcpClient(clientName))
         return null;
-    const parent = { kind: "cursor", hook_root: options.hookRoot ?? cursorHookRoot() };
-    verifyCursorParent(parent, options.hooksFile);
-    return parent;
-}
-function deliveryDir(parent, deliveryId) {
-    return path.join(parent.hook_root, "deliveries", deliveryIdSchema.parse(deliveryId));
-}
-export function prepareCursorDelivery(parent, deliveryId) {
-    cursorParentSchema.parse(parent);
-    fs.mkdirSync(deliveryDir(parent, deliveryId), { recursive: true, mode: 0o700 });
-}
-export async function submitCursorParentAnswer(parent, deliveryId, text, timeoutMs = 86_400_000) {
-    const dir = deliveryDir(parent, deliveryId);
-    writeJson0600(path.join(dir, "answer.json"), { delivery_id: deliveryId, text });
-    try {
-        await waitForFileState(dir, () => fs.existsSync(path.join(dir, "claim.json")) ? true : undefined, timeoutMs);
-    }
-    catch (error) {
-        if (error instanceof Error && error.message === "WAIT_FOR_FILE_TIMEOUT") {
-            throw new CursorDeliveryError("CURSOR_PARENT_DELIVERY_UNCLAIMED", "Cursor親が時間内に回答を受け取りませんでした。回答は保存したままです");
-        }
-        throw error;
-    }
-    return { queued_submission_id: null };
-}
-function conversationId(value) {
-    if (typeof value !== "string" || value.length === 0 || value.length > 200)
-        return null;
-    if (value.includes("/") || value.includes("\\") || value.includes(".."))
-        return null;
-    return value;
-}
-function parseJson(value) {
-    try {
-        return JSON.parse(value);
-    }
-    catch {
-        return null;
-    }
-}
-function deliveryIdFromResult(value, depth = 0) {
-    if (depth > 3 || value === null || value === undefined)
-        return null;
-    const parsed = typeof value === "string" ? parseJson(value) : value;
-    if (parsed === null || typeof parsed !== "object")
-        return null;
-    const record = parsed;
-    const structured = record.structuredContent;
-    const carrier = structured !== null && typeof structured === "object" ? structured : record;
-    const parentDelivery = carrier.parent_delivery;
-    if (parentDelivery !== null && typeof parentDelivery === "object") {
-        const id = parentDelivery.delivery_id;
-        if (typeof id === "string" && deliveryIdSchema.safeParse(id).success)
-            return id;
-    }
-    if (depth === 0 && Array.isArray(record.content)) {
-        for (const entry of record.content) {
-            if (entry !== null && typeof entry === "object" && entry.type === "text") {
-                const text = entry.text;
-                if (typeof text === "string") {
-                    const id = deliveryIdFromResult(text, depth + 1) ?? deliveryIdInText(text);
-                    if (id)
-                        return id;
-                }
-            }
-        }
-    }
-    return null;
-}
-function deliveryIdInText(text) {
-    for (const line of text.split("\n")) {
-        const match = /^delivery_id=([0-9a-f-]{36})$/i.exec(line.trim());
-        if (match && deliveryIdSchema.safeParse(match[1]).success)
-            return match[1];
-    }
-    return null;
-}
-function toolBaseName(name) {
-    const tail = name.split(/[:.]/).pop() ?? name;
-    return tail.replace(/^mcp__aiterm__/, "");
-}
-function claim(dir, channel) {
-    try {
-        fs.writeFileSync(path.join(dir, "claim.json"), JSON.stringify({ channel, at: new Date().toISOString() }), { flag: "wx", mode: 0o600 });
-        return true;
-    }
-    catch (error) {
-        if (error.code === "EEXIST")
-            return false;
-        throw error;
-    }
-}
-function bind(hookRoot, deliveryId, conv) {
-    const dir = path.join(hookRoot, "deliveries", deliveryId);
-    if (!fs.existsSync(dir))
-        return;
-    const bindFile = path.join(dir, "bind.json");
-    if (!fs.existsSync(bindFile)) {
-        writeJson0600(bindFile, { conversation_id: conv, created_at: new Date().toISOString() });
-    }
-    const indexDir = path.join(hookRoot, "conversations", conv);
-    fs.mkdirSync(indexDir, { recursive: true, mode: 0o700 });
-    const index = path.join(indexDir, deliveryId);
-    if (!fs.existsSync(index))
-        fs.writeFileSync(index, "", { mode: 0o600 });
-}
-function inject(hookRoot, conv) {
-    const indexDir = path.join(hookRoot, "conversations", conv);
-    if (!fs.existsSync(indexDir))
-        return [];
-    const pending = fs.readdirSync(indexDir).flatMap(deliveryId => {
-        const dir = path.join(hookRoot, "deliveries", deliveryId);
-        const answerFile = path.join(dir, "answer.json");
-        const bindFile = path.join(dir, "bind.json");
-        if (!fs.existsSync(answerFile) || !fs.existsSync(bindFile))
-            return [];
-        const answer = z.object({ delivery_id: z.string(), text: z.string() }).parse(JSON.parse(fs.readFileSync(answerFile, "utf8")));
-        const bound = z.object({ conversation_id: z.string(), created_at: z.string() }).parse(JSON.parse(fs.readFileSync(bindFile, "utf8")));
-        if (answer.delivery_id !== deliveryId || bound.conversation_id !== conv)
-            return [];
-        return [{ deliveryId, dir, created_at: bound.created_at, text: answer.text }];
-    }).sort((a, b) => a.created_at.localeCompare(b.created_at));
-    const texts = [];
-    for (const item of pending) {
-        const index = path.join(indexDir, item.deliveryId);
-        if (!claim(item.dir, "hook")) {
-            if (fs.existsSync(path.join(item.dir, "claim.json")))
-                fs.rmSync(index, { force: true });
-            continue;
-        }
-        texts.push(item.text);
-        fs.rmSync(index, { force: true });
-    }
-    return texts;
-}
-export async function handleCursorHook(raw, hookRoot = cursorHookRoot()) {
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        return {};
-    }
-    if (parsed === null || typeof parsed !== "object")
-        return {};
-    const event = parsed;
-    const name = event.hook_event_name;
-    if (name !== "afterMCPExecution" && name !== "postToolUse" && name !== "postToolUseFailure")
-        return {};
-    const conv = conversationId(event.conversation_id);
-    if (!conv)
-        return {};
-    const toolName = typeof event.tool_name === "string" ? event.tool_name : "";
-    if (dispatchTools.has(toolBaseName(toolName))) {
-        const payload = name === "afterMCPExecution" ? event.result_json : event.tool_output;
-        const deliveryId = deliveryIdFromResult(payload);
-        if (deliveryId)
-            bind(hookRoot, deliveryId, conv);
-    }
-    if (name === "postToolUse" || name === "postToolUseFailure") {
-        const texts = inject(hookRoot, conv);
-        if (texts.length > 0)
-            return { additional_context: texts.join("\n\n") };
-    }
-    return {};
+    return steer.cursorParentFromRequest(AITERM_PROFILE, clientName, { hookRoot: options.hookRoot ?? cursorHookRoot(), hooksFile: options.hooksFile });
 }
-export async function receiveCursorAnswer(hookRoot, deliveryId, timeoutMs = 86_400_000) {
-    const id = deliveryIdSchema.parse(deliveryId);
-    const dir = path.join(hookRoot, "deliveries", id);
-    if (!fs.existsSync(dir))
-        throw new CursorDeliveryError("CURSOR_PARENT_DELIVERY_UNKNOWN", "Cursor配送の記録がありません");
-    const answerFile = path.join(dir, "answer.json");
-    try {
-        await waitForFileState(dir, () => fs.existsSync(answerFile) ? true : undefined, timeoutMs);
-    }
-    catch (error) {
-        if (error instanceof Error && error.message === "WAIT_FOR_FILE_TIMEOUT")
-            return { outcome: "timeout" };
-        throw error;
-    }
-    const answer = z.object({ delivery_id: z.string(), text: z.string() }).parse(JSON.parse(fs.readFileSync(answerFile, "utf8")));
-    if (answer.delivery_id !== id)
-        throw new CursorDeliveryError("CURSOR_PARENT_DELIVERY_MISMATCH", "保存された回答の配送IDが一致しません");
-    if (!claim(dir, "receiver"))
-        return { outcome: "delivered_by_hook" };
-    return { outcome: "delivered", text: answer.text };
+export function handleCursorHook(raw, hookRoot = cursorHookRoot()) {
+    return steer.handleCursorHook(AITERM_PROFILE, raw, hookRoot);
 }