aiterm-mcp 0.58.4 → 0.59.0

package/dist/harnesses/grok.js

@@ -117,16 +117,41 @@ export function grokCatalogFromInitialize(stdout, summary = "") {
             // 候補に無い既定値は黙って捨てず、checkedCatalogで形式異常にする。
             default_effort: efforts.length > 0 ? defaultEffort : null,
             hidden: false,
+            fast: false,
         };
     });
+    // Grokのfastは別のmodel（表示名が「<元の表示名> Fast」。1.0.50: Grok 4.7 と Grok 4.7 Fast＝grok-4.7-build-fast）。
+    // fast版は別のmodelとして並べず、元のmodelの fast: true にまとめる。元のmodelが一覧に無いfast版は、そのまま1つのmodelとして残す。
+    const fastIds = grokFastVariants(models);
+    const variants = new Set(Object.values(fastIds));
+    const current = typeof state.currentModelId === "string" ? state.currentModelId : null;
+    const baseOf = (id) => Object.keys(fastIds).find((base) => fastIds[base] === id) ?? id;
     return checkedCatalog("Grok", {
         source: "grok agent stdio initialize (_meta.modelState)",
         harness_version: typeof meta.agentVersion === "string" ? meta.agentVersion : null,
-        default_model: typeof state.currentModelId === "string" ? state.currentModelId : null,
+        default_model: baseOf(current),
         adapter_efforts: {},
-        models,
+        models: models.filter((model) => !variants.has(model.id))
+            .map((model) => ({ ...model, fast: model.id in fastIds })),
+        fast_ids: fastIds,
     });
 }
+/** 元のmodel ID → fast版のmodel ID。表示名が「<元の表示名> Fast」のmodelを、その元のmodelのfast版と読む。 */
+export function grokFastVariants(models) {
+    const byName = new Map(models.flatMap((model) => model.display_name ? [[model.display_name, model.id]] : []));
+    const pairs = {};
+    for (const model of models) {
+        const match = model.display_name?.match(/^(.+) Fast$/);
+        const base = match ? byName.get(match[1]) : undefined;
+        if (base && base !== model.id)
+            pairs[base] = model.id;
+    }
+    return pairs;
+}
+/** model IDが、一覧の上でほかのmodelのfast版なら、その元のmodel ID。 */
+export function grokFastBase(catalog, model) {
+    return Object.keys(catalog.fast_ids ?? {}).find((base) => catalog.fast_ids?.[base] === model) ?? null;
+}
 export function assertGrokModelAvailable(bin, cwd, model) {
     const models = grokModelCatalog(bin, cwd);
     if (!models.includes(model)) {
@@ -630,3 +655,135 @@ export function grokAuthPane(screen) {
     }
     return { url, user_code: embedded, input_required: false, message: null };
 }
+// ---- ファスト。Grokのfastは別のmodel。Grokは、起動の --model と、動いている席の `/model <ID> [effort]`・`/effort` で、
+// 利用者のconfig.tomlの [models] の default と default_reasoning_effort を書き換える（1.0.50で確かめた。「✓ Default model: …」）。
+// 席だけの切り替えにするため、切り替えの直前の値へ戻す。
+const GROK_DEFAULT_KEYS = ["default", "default_reasoning_effort"];
+/** [models] の節の中の `<key> = …` の行の番号。節や行が無ければnull。 */
+function grokModelsLine(rows, key) {
+    const start = rows.findIndex((row) => /^\s*\[models\]\s*(?:#.*)?$/.test(row));
+    if (start < 0)
+        return null;
+    for (let index = start + 1; index < rows.length && !/^\s*\[/.test(rows[index]); index++) {
+        if (new RegExp(`^\\s*${key}\\s*=`).test(rows[index]))
+            return index;
+    }
+    return null;
+}
+export function readGrokModelDefaults(configPath) {
+    let body;
+    try {
+        body = fs.readFileSync(configPath, "utf8");
+    }
+    catch {
+        body = null;
+    }
+    return grokModelDefaultsFromBody(body);
+}
+/** config.tomlの中身（読めなかった時はnull）から、[models] の既定を読む。 */
+export function grokModelDefaultsFromBody(body) {
+    if (body === null)
+        return { body: null, default: { present: false, value: null }, default_reasoning_effort: { present: false, value: null } };
+    const rows = body.split(/\r?\n/);
+    const pick = (key) => {
+        const line = grokModelsLine(rows, key);
+        if (line === null)
+            return { present: false, value: null };
+        const value = rows[line].match(/=\s*"([^"\\]*)"\s*(?:#.*)?$/);
+        return { present: true, value: value ? value[1] : null };
+    };
+    return { body, default: pick("default"), default_reasoning_effort: pick("default_reasoning_effort") };
+}
+function withoutGrokDefaults(body) {
+    const rows = body.split(/\r?\n/);
+    for (const key of GROK_DEFAULT_KEYS) {
+        const line = grokModelsLine(rows, key);
+        if (line !== null)
+            rows.splice(line, 1);
+    }
+    return rows.join("\n");
+}
+/**
+ * Grokがconfig.tomlへ書いた [models] の既定（default・default_reasoning_effort）を、切り替えの直前の値へ戻す。
+ * 切り替えの前後で、ほかの行が同じなら前の中身をそのまま書き戻す。ほかの行も変わっていたら、既定の行だけを直す。
+ * 前の中身を読めなかった時、元の値が読めない書き方だった時、今のfileに [models] の節が無い時は、その項目に触らない。
+ */
+export function restoreGrokModelDefaults(configPath, before) {
+    if (before.body === null)
+        return;
+    let now;
+    try {
+        now = fs.readFileSync(configPath, "utf8");
+    }
+    catch {
+        return;
+    }
+    if (now === before.body)
+        return;
+    const eol = now.includes("\r\n") ? "\r\n" : "\n";
+    const rows = now.split(/\r?\n/);
+    for (const key of GROK_DEFAULT_KEYS) {
+        const pin = before[key];
+        if (pin.present && pin.value === null)
+            continue;
+        const line = grokModelsLine(rows, key);
+        if (pin.present) {
+            const wanted = `${key} = ${JSON.stringify(pin.value)}`;
+            if (line !== null)
+                rows[line] = wanted;
+            else {
+                const header = rows.findIndex((row) => /^\s*\[models\]\s*(?:#.*)?$/.test(row));
+                if (header >= 0)
+                    rows.splice(header + 1, 0, wanted);
+            }
+        }
+        else if (line !== null) {
+            rows.splice(line, 1);
+        }
+    }
+    const edited = rows.join(eol);
+    if (edited === now)
+        return;
+    // ほかの行が前と同じなら、前の中身（空白や並びもそのまま）を書き戻す。
+    const next = withoutGrokDefaults(edited) === withoutGrokDefaults(before.body) ? before.body : edited;
+    const temp = `${configPath}.aiterm-restore-${process.pid}`;
+    fs.writeFileSync(temp, next, { mode: fs.statSync(configPath).mode & 0o777 });
+    try {
+        fs.renameSync(temp, configPath);
+    }
+    catch (error) {
+        // Windowsでは、ほかのprocessがfileを開いている間、置き換えに失敗する事がある。途中のfileを残さず、呼び手に次の回で試させる。
+        try {
+            fs.unlinkSync(temp);
+        }
+        catch { /* 残っても中身は前の値 */ }
+        throw error;
+    }
+}
+/**
+ * 足元の枠の行の「<modelの表示> (<effort>)」から、modelの表示（「Grok 4.7 Fast」）を読む。権限の表示（· always-approve）は、付く時と付かない時がある。
+ * 切り替えの知らせ（Switched to Grok 4.7 Fast (high effort)）は、かっこの中に空白があるので拾わない。
+ */
+export function grokFooterModelName(screen) {
+    let name = null;
+    for (const line of screen.split("\n")) {
+        const match = line.match(/(Grok [^()·│╯╰─]+?) \([a-z-]+\)/);
+        if (match)
+            name = match[1].trim();
+    }
+    return name;
+}
+/** 足元の「Grok 4.7 Fast (high)」から、今のmodelを一覧のIDで返す。base は元のmodel、fast はfast版かどうか。 */
+export function grokModelFromFooter(screen, catalog) {
+    const name = grokFooterModelName(screen);
+    if (!name)
+        return null;
+    const fastIds = catalog.fast_ids ?? {};
+    for (const model of catalog.models) {
+        if (model.display_name === name)
+            return { id: model.id, base: model.id, fast: false };
+        if (fastIds[model.id] && `${model.display_name} Fast` === name)
+            return { id: fastIds[model.id], base: model.id, fast: true };
+    }
+    return null;
+}

package/dist/index.js

@@ -834,15 +834,27 @@ registerRemoteAwareTool("agent_auth", {
         return fail(error);
     }
 });
+// ファスト（高速の応答。ADR 0114）。断りの符号は4つのharnessで共通で、文の先頭に付く。
+const fastModeErrorCodes = ["FAST_MODE_NOT_SUPPORTED", "FAST_MODE_UNAVAILABLE", "FAST_MODE_MODEL_CONFLICT", "FAST_MODE_UNCONFIRMED"];
+const fastModeFailureSchema = z.object({
+    code: z.enum(fastModeErrorCodes),
+    message: z.string(),
+});
+const fastModeDesc = "ファスト（harnessの高速の応答。費用や利用量が増える）。席は必ず通常の速度で起きる。trueはその席をfastへ切り替え、falseは通常の速度にする" +
+    "（fastに対応していないmodelでもfalseは受ける）。切り替えは席だけに留め、harnessが利用者の既定へ書いた分は切り替えの直前の値へ戻す。" +
+    "断りは文の先頭の符号で分かる: FAST_MODE_NOT_SUPPORTED（そのmodelは対応していない）、FAST_MODE_UNAVAILABLE（アカウントや契約で使えない）、" +
+    "FAST_MODE_MODEL_CONFLICT（modelへfast版のIDを書いてfalseを渡した）、FAST_MODE_UNCONFIRMED（切り替えた後の状態を確かめられない）。";
 registerRemoteAwareTool("agent_configure", {
-    description: "起動済みのClaude／Codex／Grok／Cursor agent sessionを再起動せず、会話contextを保ったままmodel／reasoning effortを変更する。" +
+    description: "起動済みのClaude／Codex／Grok／Cursor agent sessionを再起動せず、会話contextを保ったままmodel／reasoning effort／fastを変更する。" +
         "各harnessのCLI標準model操作を使う。Cursorのreasoning_effort変更はmodelと同時指定する。" +
         "Claude Codeの席では /model の選ぶ画面の「この会話だけ」（s）で替え、端末の ~/.claude/settings.json の既定は書き換えない。" +
-        "その選び方が無い版、選ぶ画面に無いmodel、そのmodelで選べないeffortは、何も変えずに断る。",
+        "その選び方が無い版、選ぶ画面に無いmodel、そのmodelで選べないeffortは、何も変えずに断る。" +
+        "fastだけの指定も受ける。" + fastModeDesc,
     inputSchema: {
         session_id: z.string().regex(/^[A-Za-z0-9_-]{1,64}$/),
         model: z.string().min(1).nullish().describe("変更後のmodel。省略時はmodelを変更しない"),
         reasoning_effort: z.string().min(1).nullish().describe("変更後のreasoning effort。省略時はeffortを変更しない"),
+        fast: z.boolean().nullish().describe("変更後のfast。省略時は、その席の今の状態を変えない"),
     },
     outputSchema: {
         schema: z.literal("aiterm.agent-configure-result.v1"),
@@ -851,10 +863,11 @@ registerRemoteAwareTool("agent_configure", {
         harness: z.enum(["claude-code", "codex-cli", "grok-cli", "cursor-cli"]),
         model: z.string().nullable(),
         reasoning_effort: z.string().nullable(),
+        fast: z.boolean().nullable().optional().describe("切り替えた後の、席のfastの状態。Aitermが確かめた事の無い席（前の版が起こした席）はnull"),
     },
-}, async ({ session_id, model, reasoning_effort }) => {
+}, async ({ session_id, model, reasoning_effort, fast }) => {
     try {
-        const result = await core.configureAgent(session_id, { model, reasoning_effort });
+        const result = await core.configureAgent(session_id, { model, reasoning_effort, fast });
         return {
             content: [{ type: "text", text: JSON.stringify(result) }],
             structuredContent: { ...result },
@@ -870,11 +883,14 @@ const agentModelChoiceSchema = z.object({
     efforts: z.array(z.string()).describe("このmodelで選べるreasoning_effort。空ならeffort非対応"),
     default_effort: z.string().nullable(),
     hidden: z.boolean().describe("harnessが一覧で隠すmodel（Codexのinclude_hidden時だけtrueがある）"),
+    fast: z.boolean().describe("このharness・このmodelでfastへ切り替えられるか（agent_launch／agent_configureのfast: true）。" +
+        "fastが別のmodel IDのharness（Cursor・Grok）は、fast版を別のmodelとして並べず、元のmodelのここがtrueになる"),
 });
 registerRemoteAwareTool("agent_models", {
     description: "harnessが今返すmodelとreasoning effortの候補を、そのharnessの公式の一覧から取得する。promptもturnも送らず推論を消費しない。" +
         "Codexはapp-server model/list、Claude Codeはstream-json initializeのmodels、Grokはagent stdio initializeのmodelState、" +
         "Cursorはcursor-agent modelsを素のmodel IDとeffortへ分けたもの。返るidとeffortsはagent_launch／agent_configureへそのまま渡せる。" +
+        "modelごとのfastは、そのmodelでfastへ切り替えられるか（harnessが返す値）。fast_unavailableは、アカウントの都合でどのmodelでも使えない時の訳。" +
         "取得不能はMODEL_CATALOG_UNAVAILABLE、形式異常はMODEL_CATALOG_INVALIDのエラーで返し、別の一覧へfallbackしない。" +
         "remoteを付けると別端末のharnessの候補を返す。",
     inputSchema: {
@@ -890,6 +906,7 @@ registerRemoteAwareTool("agent_models", {
         default_model: z.string().nullable().describe("model省略時にharnessが使うmodel。一覧のIDで表せなければnull"),
         efforts: z.array(z.string()).describe("全modelのeffortの和"),
         adapter_efforts: z.record(z.string(), z.string()).describe("harnessの一覧には無く、Aitermのadapterが足したeffortと理由"),
+        fast_unavailable: fastModeFailureSchema.nullable().optional().describe("このアカウント・この端末では、どのmodelでもfastを使えない時の訳（harnessが先に答えられる時だけ。今はClaude Code）。使える・分からない時はnull"),
         models: z.array(agentModelChoiceSchema),
     },
 }, async ({ harness, cwd, include_hidden }) => {
@@ -907,6 +924,11 @@ registerRemoteAwareTool("agent_models", {
 });
 // 新規APIの選択軸はharness。旧4 launcher名は移行期間中の薄いaliasとして同じ実装へ流す。
 const kindForHarness = (harness) => harness === "claude-code" ? "claude" : harness === "codex-cli" ? "codex" : harness === "cursor-cli" ? "cursor" : "grok";
+const fastModeLaunchDesc = "ファスト（harnessの高速の応答。費用や利用量が増える）。省略とfalseは通常の速度で起こす（利用者の設定にfastが残っていても通常）。" +
+    "trueは通常で起こしてから、その席をfastへ切り替える。modelがfastに対応していない時（FAST_MODE_NOT_SUPPORTED）と、" +
+    "modelへfast版のIDを書いてfalseを渡した時（FAST_MODE_MODEL_CONFLICT）は起動を断る。アカウントの都合で使えない時・確かめられない時は、" +
+    "起動を断らずに通常の速度で起こし、返りの fast を false、fast_error に訳を入れる。" +
+    "modelへfast版のIDを直に書いて省略した時だけ、そのIDのまま起こす（返りの fast は true）。";
 const agentModelDesc = (kind) => kind === "claude"
     ? "起動モデル（例: claude-sonnet-4-6）。省略時はClaude CLI既定"
     : kind === "codex"
@@ -966,7 +988,7 @@ async function launchRemoteAgent(target, harness, args, extra) {
 }
 async function launchAgent(kind, args, extra) {
     const supportsWriteScope = kind !== "claude";
-    const { prompt, image, throughline_source_session, throughline_supplement_file, model, reasoning_effort, env_vars, cwd, session_name, launch_operation_id, write_scope, trust_project } = args;
+    const { prompt, image, throughline_source_session, throughline_supplement_file, model, reasoning_effort, fast, env_vars, cwd, session_name, launch_operation_id, write_scope, trust_project } = args;
     let delivery = null;
     try {
         if (!supportsWriteScope && write_scope !== undefined) {
@@ -975,12 +997,13 @@ async function launchAgent(kind, args, extra) {
         const initialPrompt = image && image.length > 0 ? core.attachImages(prompt ?? "", image) : prompt ?? undefined;
         if (initialPrompt || throughline_source_session)
             delivery = await deliveryForRequest(extra);
-        const [sid, hint, eventCursor, submitResidue, initialDelivery, startup] = await core.openAgentWithInitialPrompt(kind, {
+        const [sid, hint, eventCursor, submitResidue, initialDelivery, startup, fastState] = await core.openAgentWithInitialPrompt(kind, {
             prompt: initialPrompt,
             throughline_source_session,
             throughline_supplement_file,
             model: model ?? undefined,
             reasoning_effort: reasoning_effort ?? undefined,
+            fast: fast ?? undefined,
             env_vars,
             trust_project,
             before_send: delivery?.before_send,
@@ -1001,6 +1024,8 @@ async function launchAgent(kind, args, extra) {
             submit_residue: submitResidue,
             initial_prompt: initialDelivery,
             startup,
+            fast: fastState.fast,
+            fast_error: fastState.fast_error,
             ...(supportsWriteScope && write_scope !== undefined
                 ? {
                     write_scope,
@@ -1012,8 +1037,11 @@ async function launchAgent(kind, args, extra) {
         };
         // 開始未確認（submitted_unconfirmed）は誤りにしない。sessionは立ち、promptは入力欄を離れ、配送も登録済み。
         // 誤りで返すとClaude Code親は受け口のhookを走らせず、子の回答が届かない（ADR 0093）。状態はinitial_promptと本文で伝える。
+        const fastLine = fastState.fast_error
+            ? `\nfast: false（通常の速度で起こした）。${fastState.fast_error.message}`
+            : fast === true ? `\nfast: ${fastState.fast}` : "";
         return {
-            content: [{ type: "text", text: `session_id: ${sid}\n${hint}${deliveryIdLine(delivery)}` }],
+            content: [{ type: "text", text: `session_id: ${sid}\n${hint}${fastLine}${deliveryIdLine(delivery)}` }],
             structuredContent: structured,
         };
     }
@@ -1073,6 +1101,7 @@ function registerAgentTool(toolName, kind, desc) {
             model: z.string().nullish().describe(agentModelDesc(kind)),
             // CLI／model側の値集合が版で変わるため公開enumでは縛らない（core側も同方針）。
             reasoning_effort: z.string().nullish().describe(agentEffortDesc(kind)),
+            fast: z.boolean().nullish().describe(fastModeLaunchDesc),
             env_vars: z.array(z.string()).optional().describe("起動したagentへ現在のMCP processから継承する環境変数名。値はtool引数へ渡さない"),
             trust_project: z.boolean().optional().describe("対象projectを信頼し、既知のworkspace・project hooks・MCP初期同意を起動中に進める"),
             cwd: z.string().nullish().describe("作業ディレクトリ（対象リポのルート等・任意）"),
@@ -1097,6 +1126,8 @@ function registerAgentTool(toolName, kind, desc) {
             // 初回prompt dispatch後のsubmit座礁観測（additive）。true=composerに残存を確認（submit未成立の疑い）/
             // false=残存を観測せず（submit成立の保証ではない）/ null=promptなし・判定不能。
             submit_residue: z.boolean().nullable(),
+            fast: z.boolean().optional().describe("起こした後の、席のfastの状態"),
+            fast_error: fastModeFailureSchema.nullable().optional().describe("fastを頼まれたが、通常の速度で起こした時の訳"),
             ...writeScopeOutputSchema,
         },
     }, async (args, extra) => launchAgent(kind, args, extra));
@@ -1115,6 +1146,7 @@ server.registerTool("agent_launch", {
         throughline_supplement_file: z.string().min(1).optional().describe("Throughline 0.10.8以降へそのまま渡すproject束縛済み長期記憶・知識の補足JSON path"),
         model: z.string().nullish().describe("harnessが選ぶモデル。provider名ではなくlive catalog上のmodel ID"),
         reasoning_effort: z.string().nullish().describe("harness adapterが標準CLI表現へ変換する思考レベル。Cursorではmodel同時指定が必要"),
+        fast: z.boolean().nullish().describe(fastModeLaunchDesc),
         env_vars: z.array(z.string()).optional().describe("現在のMCP processから継承する環境変数名"),
         trust_project: z.boolean().optional().describe("対象projectを信頼し、既知のworkspace・project hooks・MCP初期同意を起動中に進める"),
         cwd: z.string().nullish().describe("作業ディレクトリ（絶対パス・任意）"),
@@ -1138,6 +1170,8 @@ server.registerTool("agent_launch", {
         wait_command: z.string().nullable(),
         parent_delivery: parentDeliveryOutputSchema.optional(),
         submit_residue: z.boolean().nullable(),
+        fast: z.boolean().optional().describe("起こした後の、席のfastの状態（この項目を返さない版の別端末では無い）"),
+        fast_error: fastModeFailureSchema.nullable().optional().describe("fastを頼まれたが、通常の速度で起こした時の訳"),
         write_scope: z.string().optional(),
         write_scope_enforcement: z.enum(["enforced_read_only", "declaration_only_unsupported"]).optional(),
     },

package/dist/live-node.js

@@ -0,0 +1,17 @@
+import { existsSync } from "node:fs";
+/**
+ * このprocessのNodeを、後からでも起こせる場所で返す。自分でNodeを起こす時と、呼び手へ「起こす先」として渡す時に使う。
+ * `process.execPath`は起きた時の実体で、長く動くprocessでは後から消える事がある（Homebrewは版ごとの場所へ入れ、更新で前の版を消す。
+ * 2026-10-12、MacでNodeが26.10.0_1から26.11.1へ上がり、前の版から起きていたMCP process 19個が、無いNodeを起こそうとして黙って失敗していた）。
+ * Homebrewの時は同じformulaのopt（更新でも残る）を返す。実体が消えていて代わりも無い時は、PATHから探させる（`node`）。
+ * aiterm-steer-deliveryの同じ名前の関数と同じ決まり（0.4.6〜）。
+ */
+export function liveNodeExecutable(executable = process.execPath, exists = existsSync) {
+    const brew = /^(.*)\/Cellar\/(node(?:@\d+)?)\/[^/]+\/bin\/node$/.exec(executable);
+    if (brew) {
+        const opt = `${brew[1]}/opt/${brew[2]}/bin/node`;
+        if (exists(opt))
+            return opt;
+    }
+    return exists(executable) ? executable : "node";
+}

package/dist/model-catalog.js

@@ -50,6 +50,7 @@ export function agentModelsResult(harness, catalog) {
         default_model: catalog.default_model,
         efforts: sortEfforts(catalog.models.flatMap(model => model.efforts)),
         adapter_efforts: catalog.adapter_efforts,
+        fast_unavailable: catalog.fast_unavailable ?? null,
         models: catalog.models,
     };
 }

package/dist/parent-delivery-cli.js

@@ -22,6 +22,7 @@ import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
 import { realCodexHome, readCodexWakeResult } from "aiterm-steer-delivery";
 import { AITERM_PROFILE } from "./steer-profile.js";
+import { liveNodeExecutable } from "./live-node.js";
 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";
@@ -134,7 +135,7 @@ async function deliveryState(target, delivery) {
  * アプリ配下のprocessは、PATHが細い事がある（2026-10-07、素のsshの環境からの呼び出しで起きた）。
  * nodeの場所がPATHに無い時だけ頭へ足す。既にあれば、並びも中身も変えない。
  */
-export function pathWithNode(env, node = process.execPath, platform = process.platform) {
+export function pathWithNode(env, node = liveNodeExecutable(), platform = process.platform) {
     const windows = platform === "win32";
     // Windowsの環境変数名は大文字小文字を区別しない（`Path`で入っている事が多い）。
     const key = Object.keys(env).find(name => windows ? name.toLowerCase() === "path" : name === "PATH") ?? "PATH";
@@ -146,7 +147,7 @@ export function pathWithNode(env, node = process.execPath, platform = process.pl
 }
 /** この命令の場所と版。製品側の入口（aiterm-steer-delivery）が、呼べる相手かどうかを確かめるのに使う。 */
 export function providerDescription() {
-    return { version: pkg.version, node: process.execPath, cli: fileURLToPath(import.meta.url) };
+    return { version: pkg.version, node: liveNodeExecutable(), cli: fileURLToPath(import.meta.url) };
 }
 export async function runParentDelivery(argv) {
     const [kind, command, ...args] = argv;

package/dist/runtime-error-report.js

@@ -7,6 +7,7 @@ import { createRequire } from "node:module";
 import * as path from "node:path";
 import { fileURLToPath } from "node:url";
 import { defaultRuntimeErrorReportPaths, readBoundedFile, runtimeErrorReportingStatus } from "./runtime-error-os.js";
+import { liveNodeExecutable } from "./live-node.js";
 import { RuntimeErrorStore } from "./runtime-error-store.js";
 const pkg = createRequire(import.meta.url)("../package.json");
 const WORKER = fileURLToPath(new URL("./runtime-error-worker.js", import.meta.url));
@@ -252,7 +253,7 @@ export function triggerRuntimeErrorReport(env = process.env) {
     try {
         if (runtimeErrorReportingStatus(defaultRuntimeErrorReportPaths().reportingConfigPath) !== "enabled")
             return false;
-        const child = spawn(process.execPath, [WORKER, "report"], { stdio: "ignore", detached: true, windowsHide: true, env });
+        const child = spawn(liveNodeExecutable(), [WORKER, "report"], { stdio: "ignore", detached: true, windowsHide: true, env });
         child.once("error", () => { });
         child.unref();
         return true;

package/dist/runtime-error-store.js

@@ -4,6 +4,7 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import { createRequire } from "node:module";
 import { defaultRuntimeErrorReportPaths, runtimeErrorReportingStatus } from "./runtime-error-os.js";
+import { liveNodeExecutable } from "./live-node.js";
 import { defaultRuntimeErrorPaths, windowsPrivateDaclCommand, expectedHostProfiles, readBoundedFile, processStartIdentity, forceKill } from "./runtime-error-os.js";
 export { defaultRuntimeErrorPaths, windowsPrivateDaclCommand, windowsPrivateDaclVerifyCommand } from "./runtime-error-os.js";
 import { fileURLToPath } from "node:url";
@@ -673,7 +674,7 @@ export function recordRuntimeError(code, options = {}) {
         fixedStoreFailure(stderr);
     } };
     try {
-        const child = spawn(process.execPath, [options.workerPath ?? WORKER, "record", code], {
+        const child = spawn(liveNodeExecutable(), [options.workerPath ?? WORKER, "record", code], {
             stdio: "ignore", windowsHide: true, env: process.env,
         });
         const timer = setTimeout(() => { report(); forceKill(child); }, options.timeoutMs ?? defaultWorkerTimeoutMs("record"));
@@ -707,7 +708,7 @@ export async function runtimeErrorStoreDiagnostic(options = {}) {
         } };
         let child;
         try {
-            child = spawn(process.execPath, [options.workerPath ?? WORKER, "diagnostic"], {
+            child = spawn(liveNodeExecutable(), [options.workerPath ?? WORKER, "diagnostic"], {
                 stdio: ["ignore", "pipe", "ignore"], windowsHide: true, env: process.env,
             });
         }

package/dist/user-config.js

@@ -0,0 +1,138 @@
+// 利用者の設定file（harnessが既定を保存するfile）を、席の切り替えの前後で元の値へ戻すための部品（ADR 0114）。
+// harnessの切り替えの命令は、席だけでなく利用者の既定も書き換える（Claude Codeの /fast、Codexの /fast、Grokの --model と /model）。
+// 席の切り替えを席だけに留めるため、「読む → 切り替える → 戻す」を、processをまたぐ鍵で1つずつにする。
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { isDeepStrictEqual } from "node:util";
+import { AitermError } from "./errors.js";
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+// 鍵を握ったままprocessが落ちた時に、後の人が引き取るまでの時間。1回の切り替え（画面の待ちと公式の口の呼び出し）より十分長く取る。
+const LOCK_STALE_MS = 120_000;
+const LOCK_WAIT_MS = 150_000;
+const LOCK_POLL_MS = 120;
+/**
+ * 設定fileを触る切り替えを、同じ端末の全てのAitermの間で1つずつにする。鍵は設定fileの隣に作る
+ * （Aitermの置き場はprocessごとに変えられるが、設定fileの場所は全員が同じに見る）。
+ * 設定fileの置き場が無い・書けない時は、harnessも書けないので鍵なしで通す。
+ */
+export async function withUserConfigLock(configPath, action) {
+    const lock = `${configPath}.aiterm-lock`;
+    if (!fs.existsSync(path.dirname(configPath)))
+        return action();
+    const deadline = Date.now() + LOCK_WAIT_MS;
+    for (;;) {
+        try {
+            fs.mkdirSync(lock);
+            break;
+        }
+        catch (error) {
+            const code = error.code;
+            if (code !== "EEXIST")
+                return action();
+        }
+        let age = 0;
+        try {
+            age = Date.now() - fs.statSync(lock).mtimeMs;
+        }
+        catch {
+            continue;
+        }
+        if (age > LOCK_STALE_MS) {
+            try {
+                fs.rmSync(lock, { recursive: true, force: true });
+            }
+            catch { /* 先に誰かが片付けた */ }
+            continue;
+        }
+        if (Date.now() > deadline) {
+            throw new AitermError(`USER_CONFIG_LOCK_TIMEOUT: ${configPath} を触る切り替えが、ほかの席で続いています。何も変えていません。`, 2);
+        }
+        await sleep(LOCK_POLL_MS + Math.floor(Math.random() * LOCK_POLL_MS));
+    }
+    try {
+        try {
+            fs.writeFileSync(path.join(lock, "owner"), `${process.pid}\n`);
+        }
+        catch { /* 持ち主の控えは調べる時のため。無くても動く */ }
+        return await action();
+    }
+    finally {
+        try {
+            fs.rmSync(lock, { recursive: true, force: true });
+        }
+        catch { /* 残っても、古くなれば次の人が引き取る */ }
+    }
+}
+/** fileの今の中身。無い・読めない時はnull。 */
+export function readFileOrNull(file) {
+    try {
+        return fs.readFileSync(file);
+    }
+    catch {
+        return null;
+    }
+}
+function writeInPlace(file, body) {
+    let mode = 0o600;
+    try {
+        mode = fs.statSync(file).mode & 0o777;
+    }
+    catch { /* 無ければ0600で作る */ }
+    const temp = `${file}.aiterm-restore-${process.pid}`;
+    fs.writeFileSync(temp, body, { mode });
+    try {
+        fs.renameSync(temp, file);
+    }
+    catch (error) {
+        // Windowsでは、ほかのprocessがfileを開いている間、置き換えに失敗する事がある。途中のfileを残さず、呼び手に次の回で試させる。
+        try {
+            fs.unlinkSync(temp);
+        }
+        catch { /* 残っても中身は前の値 */ }
+        throw error;
+    }
+}
+/**
+ * JSONの設定fileの、最上位の項目（1つ、または複数）を、切り替えの前の値へ戻す。
+ * - 項目が前と同じで、ほかの項目の値も同じ（harnessが書き直して並びが変わっただけ）なら、前の中身をそのまま書き戻す。
+ * - ほかの項目が変わっていたら（ほかの人の書き込み、harnessの控えの更新）、その項目だけを直して、ほかは今のまま残す。
+ * - 今のfileが無い・JSONとして読めない時、前の中身が読めない時は触らない。
+ * 戻り値は、書き戻したかどうか。
+ */
+export function restoreJsonSetting(file, before, key) {
+    const keys = typeof key === "string" ? [key] : key;
+    const now = readFileOrNull(file);
+    if (now === null)
+        return false;
+    if (before !== null && now.equals(before))
+        return false;
+    let current;
+    let previous = null;
+    try {
+        current = JSON.parse(now.toString("utf8"));
+        if (before !== null)
+            previous = JSON.parse(before.toString("utf8"));
+    }
+    catch {
+        return false;
+    }
+    if (!current || typeof current !== "object" || Array.isArray(current))
+        return false;
+    if (previous !== null && (typeof previous !== "object" || Array.isArray(previous)))
+        return false;
+    const edited = { ...current };
+    for (const name of keys) {
+        if (previous !== null && Object.hasOwn(previous, name))
+            edited[name] = previous[name];
+        else
+            delete edited[name];
+    }
+    if (before !== null && isDeepStrictEqual(edited, previous)) {
+        writeInPlace(file, before);
+        return true;
+    }
+    if (isDeepStrictEqual(edited, current))
+        return false;
+    writeInPlace(file, `${JSON.stringify(edited, null, 2)}\n`);
+    return true;
+}

package/docs/DESIGN.md

@@ -63,6 +63,16 @@ agentの席への`pty_send`は、任意の`preface`（本文の前に置く1行
 空行と本文を1回の貼り付けで入れる。貼り付けた長い文をClaude Codeが`<pasted_content>`で包んでも、前置きは包みの外に出る。
 ほかのharnessの席へは1つにつないで貼る。`preface`は入力欄がそのまま読むので、1行・200字以内・制御文字なし・行頭が記号や空白でない・
 `@`を含まない文だけを通し、外れた時は打鍵前に断る。
+呼び手が`preface`を渡さない時も、Claude Codeの席へ送る文が包まれる長さ（改行3つ以上か800字以上。`claudeWrapsPaste`）なら、Aitermが既定の1行
+（`AGENT_DEFAULT_PREFACE`。出所だけを言う）を同じ形で入れる。新しいturn・差し込み・起動時の文で同じ。起動時に席へ渡す文で、この1行の見分け方を教える（ADR 0116）。
+
+Claude Codeの席へ送る前に、今の画面が選ぶ画面（最後の行が`Enter to confirm · Esc to cancel`で、上に番号の行がある。`claudeLiveSelectMenu`）で
+ないかを読む。利用枠に当たったClaude Codeが自分で開く`/rate-limit-options`の画面は、Escで閉じてから送る。見覚えの無い選ぶ画面には何も打たずに
+断る。選ぶ画面は貼り付けを捨ててEnterだけを読み、打鍵の数字と「j」「k」を選択の操作として読むので、そのまま送ると文が消える（ADR 0117）。
+
+席のprocessの環境には、起動の印（`AITERM_AGENT_LAUNCH_ID`ほか`AITERM_AGENT_*`）を入れる。印は席が起こした子にも継がれる。起動の時点で会話IDが
+決まるClaude CodeとGrokの席には、席の会話ID（`AITERM_AGENT_VENDOR_SESSION_ID`）も入れ、席そのものの会話かを値で見分けられるようにする（ADR 0118）。
+素の端末（`pty_open`）には`AITERM_AGENT_*`を入れない。
 
 Codexは回答を流している間、画面に動作中の行を出さない。`pty_send`の振り分けは、Codexの席に限り、画面が入力待ちでも、この起動の記録の
 最後の境界がturnの開始で、processが生きていて、0.4秒おいて見直しても記録が同じturnのままで画面が動いている時を、動いていると数える
@@ -171,6 +181,7 @@ hookコマンドはCodexが使うshellで評価される。Windowsでは引用
 承認省略flagを恒久設定へ書かない。利用者の別hookを承認しない。
 選択と配送の所有記録は`~/.config/aiterm-mcp/codex-parent-hooks/`に置く。
 Nodeは`src/setup-node.ts`でHomebrewの同じformulaの`opt`へ正規化し、更新で消えるCellar実体を保存しない。
+動いているprocessが自分のNodeを起こす時・呼び手へ渡す時も、`src/live-node.ts`で今ある場所を引く（`process.execPath`を直接使わない。ADR 0113）。
 
 新規の起動差し替えは作らない。旧中継の設定は新しいhookの確認後に従来の解除処理で復元する。
 macOSの専用LaunchAgent、Windowsのユーザー環境変数、所有外の値の保持は旧adapterが担う。

package/docs/RELEASE.md

@@ -11,6 +11,9 @@ Aitermのreleaseはこのrepositoryが所有する。`.github/workflows/product-
 - 版番号だけの変更はJSONの実差分で識別し、Linuxでbuildと配布metadata・pack・文書確認を行う。依存や実行設定の変更は省略しない。
   文書だけなら文書検査、実装と文書の混在なら関連試験と文書検査を行う。
 - 週1回の定期実行（月曜 03:00 JST）と手動実行は、指定された環境で全テストを回す。定期実行の対象は3環境である。
+- pushは、同じcommitの全テスト（手動実行か定期実行）がもう通っている環境を流さない。枝で手動実行を通してからmainへ早送りすると、
+  mainのpushは変更分類と関門だけで終わる。通っている環境が一部の時は、残りの環境だけを流す。GitHubへ聞けない時は、選んだ環境を全部流す。
+  同じcommitのpush・pull requestの成功は、試験を絞っている事があるので数えない（ADR 0115）。
 - tag push: 所有確認と、tagged commitが`origin/main`の祖先であることの確認だけを行い、npmへprovenance付きで
   publishする。同じcommitのmain CIの結果は待たない。
 
@@ -19,6 +22,8 @@ Aitermのreleaseはこのrepositoryが所有する。`.github/workflows/product-
 1. 変更に直結するfocused testを手元で通す。full regressionは手元で回さず、CIに任せる。
    個別試験も`node --import ./test/seat-env.mjs --test ...`で起動する。稼働中の席の保存場所を試験へ継承しない。
 2. `CHANGELOG.md`の`## [Unreleased]`へ内容を書き、mainへcommitしてpushする。
+   3環境の全テストを先に通しておく時は、枝をpushして手動実行（`gh workflow run ci.yml --ref <枝> -f environment=all -f comparison_base=<前の公開commit>`）を
+   1回流し、通ったcommitをそのままmainへ早送りする。Windowsの全テストは1回で済む。
 3. 一回で公開する。
 
    ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.58.4",
+  "version": "0.59.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": [
@@ -72,7 +72,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "aiterm-steer-delivery": "^0.4.5",
+    "aiterm-steer-delivery": "^0.4.6",
     "ws": "8.21.3",
     "zod": "^4.4.3"
   },