aiterm-mcp 0.27.3 → 0.27.7

package/dist/core.js

@@ -10,13 +10,15 @@
 import { spawnSync } from "node:child_process";
 import * as fs from "node:fs";
 import * as path from "node:path";
-import * as os from "node:os";
-import { createHash, randomBytes, randomUUID } from "node:crypto";
-import { fileURLToPath } from "node:url";
+import { createHash, randomBytes } from "node:crypto";
 import * as rtk from "./rtk.js";
 import { AitermError, telemetryOwnedFailure, ownTelemetryFailure } from "./errors.js";
-import { isWin, SOCKDIR, SOCK, WIN_NS, tmuxCommand, tmuxCommandWithInput } from "./tmux-runtime.js";
-import { resolveAgentBin, spawnAgentControlCommand, resolveThroughlineBin, runThroughlineHandoffContext, isWindowsNativeExecutable, agentBinForPaneShell, resolveWinPaneShell } from "./agent-resolver.js";
+import { isWin, SOCKDIR, tmuxCommand, loadPtyBufferChunk, pasteBufferBaseArgs, TMUX_EMPTY_CONFIG, attachCommand, normalizePaneCommand, settlePaneLog, paneCwdArgument, } from "./tmux-runtime.js";
+import { sleep, currentUid, runtimeStateBase, safeStatSize, readFileRange, writeJson0600, createEmpty0600, shq, LAUNCH_ID_RE, AGENT_DONE_POLL_MS, AGENT_EVENT_MAX_BYTES, assertSessionName, agentsDir, agentEventPath, agentMetadataPath, writeAgentMetadata, AGENT_EVENT_TAIL_BYTES, agentLabel, agentLineageFields, } from "./agent-shared.js";
+import { GROK_MODEL_DEFAULTS, realGrokHome, resolveAndValidateGrokAuth, assertGrokModelAvailable, grokEventsTranscript, latestGrokCompletion, grokInitializationComplete, observeGrokDone, buildGrokAgentCmd, grokLaunchNote, grokEnvTokens, grokTuiReady, GROK_COMPOSER_MARKER_RE, grokFooterHasConfiguration, grokTranscriptText, createGrokAgentMetadata, } from "./vendors/grok.js";
+import { bindCodexTranscriptSession, latestCodexCompletion, observeCodexDone, buildCodexAgentCmd, codexLaunchNote, codexTuiReady, CODEX_COMPOSER_MARKER_RE, codexModelChoice, codexEffortChoice, codexMoreReasoningChoice, codexTranscriptText, createCodexAgentMetadata, } from "./vendors/codex.js";
+import { OPERATION_ID_RE, CLAUDE_RESULT_MAX_BYTES, CLAUDE_EFFORTS, agentManagedClaudeSettingsPath, agentClaudeResultPath, agentClaudeOperationPath, agentClaudeApprovalReceiptPath, agentClaudeDispatchReceiptPath, validateOperationId, readClaudeResultText, assertClaudeAuthenticationReady, buildClaudeAgentCmd, claudeLaunchNote, claudeTuiReady, CLAUDE_COMPOSER_MARKER_RE, createClaudeAgentMetadata, } from "./vendors/claude.js";
+import { resolveAgentBin, resolveThroughlineBin, runThroughlineHandoffContext, isWindowsNativeExecutable, agentBinForPaneShell, resolveWinPaneShell } from "./agent-resolver.js";
 export { AitermError } from "./errors.js";
 export { tmuxSpawnEnv } from "./tmux-runtime.js";
 // 完了検出
@@ -37,20 +39,13 @@ const NON_POSIX_MARK_SHELLS = new Set(["fish", "csh", "tcsh"]);
 // エコーは rc=%d(リテラル)。数字アンカーでエコーに免疫化し、部分一致による早期誤完了を防ぐ（B1）。
 // send の printf 書式（`rc=%d`）と対で保守すること。
 const MARK_DONE_RE = /<<<AITERM_DONE rc=[0-9]+>>>/;
-const LAUNCH_ID_RE = /^[0-9a-f]{32}$/;
-const OPERATION_ID_RE = /^sha256:[0-9a-f]{64}$/;
 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 const AGENT_LINEAGE_RE = /^[A-Za-z0-9_.:-]+(?:>[A-Za-z0-9_.:-]+)*$/;
-const AGENT_DONE_POLL_MS = 100;
 const AGENT_DONE_SETTLE_MIN_MS = 250;
 const AGENT_DONE_SCREEN_SETTLE_POLL_MS = 100;
 const AGENT_DONE_SCREEN_SETTLE_MAX_POLLS = 5;
 const AGENT_DONE_SCREEN_SETTLE_MIN_SAMPLES = 3;
 const AGENT_SUBMIT_DELAY_MS = 250;
-const AGENT_EVENT_MAX_BYTES = 1024 * 1024;
-const AGENT_EVENT_TAIL_BYTES = 64 * 1024;
-const CODEX_TRANSCRIPT_INCREMENT_MAX_BYTES = 16 * 1024 * 1024;
-const GROK_TRANSCRIPT_INCREMENT_MAX_BYTES = 16 * 1024 * 1024;
 const AGENT_METADATA_NEGATIVE_CACHE_TTL_MS = 2_000;
 const AGENT_TUI_READY_TIMEOUT_MS = 30_000;
 const AGENT_TUI_READY_POLL_MS = 500;
@@ -63,10 +58,6 @@ const AGENT_SUBMIT_RESIDUE_POLL_MS = 300;
 const AGENT_SUBMIT_RESIDUE_MAX_SAMPLES = 5;
 const AGENT_SUBMIT_RESIDUE_TAIL_CHARS = 32;
 const AGENT_SUBMIT_RESIDUE_MIN_TAIL_CHARS = 8;
-const GROK_AUTH_MAX_BYTES = 64 * 1024;
-const GROK_MODELS_MAX_BYTES = 1024 * 1024;
-const GROK_MODELS_TIMEOUT_MS = 15_000;
-const CLAUDE_RESULT_MAX_BYTES = 4 * 1024 * 1024;
 // 出力削減（RTK の CAP 思想を移植）
 const MAX_LINES_BEFORE_ELIDE = 60;
 const HEAD_LINES = 30;
@@ -116,9 +107,6 @@ const KEYMAP = {
 function tmux(...args) {
     return tmuxCommand(true, ...args);
 }
-function tmuxWithInput(input, ...args) {
-    return tmuxCommandWithInput(true, input, ...args);
-}
 function tmuxCleanup(...args) {
     return tmuxCommand(false, ...args);
 }
@@ -129,13 +117,7 @@ function paneCurrentCommand(name) {
     const r = tmux("display-message", "-p", "-t", name, "#{pane_current_command}");
     if (r.code !== 0)
         return "";
-    const cmd = r.stdout.trim();
-    // Windows（psmux）は "bash.exe" やフルパス形で報告しうる。SHELLS 等の POSIX 名
-    // 集合と突合できるよう、basename・.exe 除去・小文字化へ正規化する（Windows の
-    // 実行ファイル名は case-insensitive）。POSIX は従来どおり無加工。
-    if (!isWin)
-        return cmd;
-    return path.basename(cmd).replace(/\.exe$/i, "").toLowerCase();
+    return normalizePaneCommand(r.stdout.trim());
 }
 function pasteBufferSupportsNoSanitizeFlag() {
     const listed = tmux("list-commands");
@@ -187,104 +169,6 @@ function assertSendTextSize(text, context = "送信文字列") {
         throw new AitermError(`${context}が${MAX_SEND_BYTES} bytesを超えています（${bytes} bytes）`, 2);
     }
 }
-// session 名はファイルパス（logpath 等）と pipe-pane の /bin/sh 文字列へ流れる。英数 _ - のみ・64字に
-// 限定し、パストラバーサル（../）とシェルインジェクション（' でのクオート破り・$・; 等）を全入口で断つ。
-function assertSessionName(name) {
-    if (!/^[A-Za-z0-9_-]{1,64}$/.test(name))
-        throw new AitermError(`session 名は英数字と _ - のみ・64文字以内にしてください: ${JSON.stringify(name)}`, 2);
-}
-function currentUid() {
-    // Windows(native)は process.getuid を持たない。以前はここで throw していたが、
-    // agent metadata の存在確認経由で素の pty_send まで巻き込んで全 send を殺していた。
-    // Windows の fs.Stats.uid は常に 0 なので、ここも 0 を返せば owner 比較
-    // (st.uid !== currentUid()) は自然に通過する。Windows は POSIX owner 検証を
-    // 持たない（NTFS ACL は別体系）という既知の制約の明示的受容であり、POSIX 側は
-    // getuid をそのまま返すため挙動不変。
-    if (typeof process.getuid !== "function")
-        return 0;
-    return process.getuid();
-}
-function runtimeStateBase() {
-    const xdg = process.env.XDG_RUNTIME_DIR;
-    if (xdg) {
-        try {
-            if (fs.statSync(xdg).isDirectory())
-                return xdg;
-        }
-        catch {
-            /* XDG_RUNTIME_DIR が壊れている CI/非 login 環境では os.tmpdir() に戻す */
-        }
-    }
-    return os.tmpdir();
-}
-function stateRoot() {
-    const uid = currentUid();
-    const base = runtimeStateBase();
-    return path.join(base, `aiterm-mcp-${uid}`);
-}
-function ensureStateRoot() {
-    // state root は OS が与える per-user runtime dir（XDG_RUNTIME_DIR / os.tmpdir()）の下に作る。
-    // 以前はここで symlink・owner・mode を検査していたが、共有 /tmp に敵対的な同居主体がいる
-    // 前提の防御であり、対応 OS の既定配置では成立しない（オーナー裁定 2026-08-19）。
-    // 作成時の 0o700 は検査ではなく妥当な既定として残す。経路の異常は以降の
-    // open/stat が OS エラーとしてそのまま露出させる。
-    const root = stateRoot();
-    fs.mkdirSync(root, { recursive: true, mode: 0o700 });
-    fs.mkdirSync(path.join(root, "agents"), { recursive: true, mode: 0o700 });
-    return root;
-}
-function agentsDir() {
-    return path.join(ensureStateRoot(), "agents");
-}
-function agentEventPath(name, launchId) {
-    assertSessionName(name);
-    if (!LAUNCH_ID_RE.test(launchId))
-        throw new AitermError(`launch_id が不正です: ${launchId}`, 2);
-    return path.join(agentsDir(), `${name}.${launchId}.events.jsonl`);
-}
-function agentMetadataPath(name, launchId) {
-    assertSessionName(name);
-    if (!LAUNCH_ID_RE.test(launchId))
-        throw new AitermError(`launch_id が不正です: ${launchId}`, 2);
-    return path.join(agentsDir(), `${name}.${launchId}.agent.json`);
-}
-function agentWaitLockPath(name, launchId) {
-    assertSessionName(name);
-    if (!LAUNCH_ID_RE.test(launchId))
-        throw new AitermError(`launch_id が不正です: ${launchId}`, 2);
-    return path.join(agentsDir(), `${name}.${launchId}.wait.lock`);
-}
-function agentManagedClaudeSettingsPath(name, launchId) {
-    assertSessionName(name);
-    if (!LAUNCH_ID_RE.test(launchId))
-        throw new AitermError(`launch_id が不正です: ${launchId}`, 2);
-    return path.join(agentsDir(), `${name}.${launchId}.claude-settings.json`);
-}
-function agentClaudeResultPath(name, launchId) {
-    assertSessionName(name);
-    if (!LAUNCH_ID_RE.test(launchId))
-        throw new AitermError(`launch_id が不正です: ${launchId}`, 2);
-    return path.join(agentsDir(), `${name}.${launchId}.claude-result.json`);
-}
-function agentClaudeOperationPath(name, launchId) {
-    assertSessionName(name);
-    if (!LAUNCH_ID_RE.test(launchId))
-        throw new AitermError(`launch_id が不正です: ${launchId}`, 2);
-    return path.join(agentsDir(), `${name}.${launchId}.claude-operation.json`);
-}
-function agentClaudeApprovalReceiptPath(name, launchId) {
-    assertSessionName(name);
-    if (!LAUNCH_ID_RE.test(launchId))
-        throw new AitermError(`launch_id が不正です: ${launchId}`, 2);
-    return path.join(agentsDir(), `${name}.${launchId}.claude-approval.json`);
-}
-function agentClaudeDispatchReceiptPath(name, launchId, operationId) {
-    assertSessionName(name);
-    if (!LAUNCH_ID_RE.test(launchId))
-        throw new AitermError(`launch_id が不正です: ${launchId}`, 2);
-    const validated = validateOperationId(operationId);
-    return path.join(agentsDir(), `${name}.${launchId}.${validated.slice("sha256:".length)}.claude-dispatch`);
-}
 function existingAgentsDir() {
     // 既存の agents dir があればその path、無ければ null（作成はしない）。
     // 以前はここで symlink・owner・mode を検査していたが撤去した（オーナー裁定 2026-08-19）。
@@ -381,8 +265,7 @@ function readLastcmd(name) {
     }
 }
 export function attachHint(name) {
-    // Windows は native psmux（tmux CLI 互換）を -L namespace で叩く。
-    const cmd = isWin ? `psmux -L ${WIN_NS} attach -t ${name}` : `tmux -S ${SOCK} attach -t ${name}`;
+    const cmd = attachCommand(name);
     return (`このセッションを自分の目で見る/介入する:\n` +
         `  ${cmd}\n` +
         `  （抜けるには Ctrl-b d）`);
@@ -502,27 +385,6 @@ function captureScreen(name, lines) {
     const r = tmux(...args);
     return r.code === 0 ? r.stdout : "";
 }
-const sleep = (ms) => new Promise((res) => setTimeout(res, ms));
-// Windows 専用: pipe-pane のログは psmux server 側の in-process sink が書く＝完了検知と
-// 書き手が別 process のため、完了/セッション消滅の報告後も末尾数百バイトが遅れて現れうる。
-// 完了と判定する直前にログサイズが伸びなくなるまで待ち、readOutput が末尾欠けの出力を
-// 返さないようにする（POSIX の tmux は /bin/sh sink・同一 fs で実測上不要）。
-async function settleWinLog(name) {
-    let prev = -1;
-    for (let i = 0; i < 8; i++) {
-        let sz = 0;
-        try {
-            sz = fs.statSync(logpath(name)).size;
-        }
-        catch {
-            sz = 0;
-        }
-        if (sz === prev)
-            return;
-        prev = sz;
-        await sleep(POLL * 1000);
-    }
-}
 /** 完了境界: dead / mark sentinel 一致 / until 一致 / (出力静止 ∧ シェル復帰)=quiescent / (ネスト中＋until/mark無しで出力静止)=nested(未確定・早期返却) / timeout。 */
 async function waitCompletion(name, untilStr, untilRegex, timeout) {
     // 締切は単調時計で測る。Date.now() は NTP 補正やサスペンドで巻き戻り、長時間待ちで誤判定する（Python は time.monotonic）。
@@ -591,8 +453,7 @@ async function waitCompletion(name, untilStr, untilRegex, timeout) {
                 catch {
                     /* noop */
                 }
-                if (isWin)
-                    await settleWinLog(name);
+                await settlePaneLog(logpath(name), POLL);
                 return [true, "mark"];
             }
             if (until && until(neu))
@@ -602,8 +463,7 @@ async function waitCompletion(name, untilStr, untilRegex, timeout) {
         // 静止時のみ has-session を叩いて dead を判定する。dead 検出は最大 1 poll 遅れるだけ。
         const growing = lastSize !== null && size > lastSize;
         if (!growing && !sessionExists(name)) {
-            if (isWin)
-                await settleWinLog(name);
+            await settlePaneLog(logpath(name), POLL);
             return [true, "dead"];
         }
         if (size === lastSize) {
@@ -619,8 +479,7 @@ async function waitCompletion(name, untilStr, untilRegex, timeout) {
                     stable = 0;
                 }
                 else if (!until && !markActive && SHELLS.has(fg)) {
-                    if (isWin)
-                        await settleWinLog(name);
+                    await settlePaneLog(logpath(name), POLL);
                     return [true, "quiescent"]; // 出力静止 ∧ シェル復帰 ＝ 確証つき完了
                 }
                 else if (!until && !markActive && fg !== "") {
@@ -630,8 +489,7 @@ async function waitCompletion(name, untilStr, untilRegex, timeout) {
                     // until/markActive のときは指定した証拠を待つべく早期返却せず、shell builtinや
                     // 非シェル前面（sleep 等）でも待ち続ける。
                     // fg==="" は前面コマンド取得失敗＝ネスト断定不可なので早期返却せず従来どおり timeout まで待つ。
-                    if (isWin)
-                        await settleWinLog(name);
+                    await settlePaneLog(logpath(name), POLL);
                     return [false, "nested"];
                 }
             }
@@ -707,8 +565,8 @@ export function openSession(name, shell = "bash") {
                 throw new AitermError(`session '${nm}' は既に存在します（list で確認）`, 2);
         }
         else {
-            // -f は端末個人の設定ファイルを読まないための空 config（Windows は NUL デバイス）。
-            const r = tmux("new-session", "-d", "-s", nm, ...banner, "-f", isWin ? "NUL" : "/dev/null", shell);
+            // -f は端末個人の設定ファイルを読まないための空 config。
+            const r = tmux("new-session", "-d", "-s", nm, ...banner, "-f", TMUX_EMPTY_CONFIG, shell);
             if (r.code === 0)
                 break;
             // 自動採番かつ「重複名」由来の失敗（他エージェントが同名を先に取った）なら次名でリトライ。
@@ -851,34 +709,15 @@ export function send(name, text, o = {}) {
             const partial = i > 0
                 ? " 先行chunkはPTYに入力済みでEnterは未送信です。再送前に入力を確認・消去してください。"
                 : "";
-            // psmux の load-buffer は stdin (`-`) 非対応で path 位置引数だけを取る。
-            // Windows は owner-only の SOCKDIR 内へ一時ファイル経由で渡す。
-            let loaded;
-            if (isWin) {
-                const chunkFile = path.join(SOCKDIR, `${bufferName}.chunk`);
-                try {
-                    fs.writeFileSync(chunkFile, chunks[i], { encoding: "utf8" });
-                    loaded = tmux("load-buffer", "-b", bufferName, chunkFile);
-                }
-                finally {
-                    try {
-                        fs.unlinkSync(chunkFile);
-                    }
-                    catch { /* noop */ }
-                }
-            }
-            else {
-                loaded = tmuxWithInput(chunks[i], "load-buffer", "-b", bufferName, "-");
-            }
+            const loaded = loadPtyBufferChunk(true, bufferName, chunks[i]);
             if (loaded.code !== 0) {
                 tmuxCleanup("delete-buffer", "-b", bufferName);
                 throw new AitermError(`tmux bufferへの送信準備に失敗しました` +
                     `（chunk ${i + 1}/${chunks.length}）: ${loaded.stderr.trim() || `code=${loaded.code}`}.${partial}`, 2);
             }
-            // -r: LF→CR 置換を無効化。-Sは対応新版だけでvis(3)制御文字変換を無効化する。
+            // -Sは対応新版だけでvis(3)制御文字変換を無効化する。
             // send 自身の raw/sanitize 契約だけを真実とし、tmux 側で黙って再変換させない。
-            // psmux は -r 非対応（受理フラグは d/p/b/t のみ）のため Windows では付けない。
-            const pasteArgs = isWin ? ["paste-buffer", "-d"] : ["paste-buffer", "-d", "-r"];
+            const pasteArgs = pasteBufferBaseArgs();
             if (o.bracketedPaste)
                 pasteArgs.push("-p");
             if (pasteSupportsNoSanitize)
@@ -1270,309 +1109,9 @@ function createAgentLineageContext(kind, sessionId, seed) {
         delegationAllowed: true,
     };
 }
-function agentLineageFields(context) {
-    return {
-        agent_role: context.agentRole,
-        parent_session_id: context.parentSessionId,
-        delegation_depth: context.delegationDepth,
-        lineage: context.lineage,
-        delegation_allowed: context.delegationAllowed,
-    };
-}
-function subagentInstruction(meta) {
-    if (meta.agent_role !== "subagent" ||
-        !meta.parent_session_id ||
-        !Number.isSafeInteger(meta.delegation_depth) ||
-        !meta.lineage ||
-        meta.delegation_allowed !== true) {
-        throw new AitermError("sub-agent instructionに必要なlineage metadataがありません", 2);
-    }
-    return [
-        "<aiterm_subagent_context>",
-        "あなたはaitermから起動されたsub-agentであり、root agentではありません。",
-        `AITERM_AGENT_LAUNCH_ID=${meta.launch_id}`,
-        `role=${meta.agent_role}`,
-        `parent_session_id=${meta.parent_session_id}`,
-        `delegation_depth=${meta.delegation_depth}`,
-        `lineage=${meta.lineage}`,
-        "delegation_allowed=true",
-        "任務の所有権を保ち、結果を親へ返してください。必要なら追加のsub-agentへ委譲してよいです。",
-        "ただし、同じ任務全体を同型agentへ反射的に丸投げして自己複製ループを作らないでください。",
-        "</aiterm_subagent_context>",
-    ].join("\n");
-}
 const DEFAULT_AGENT_DONE_TIMEOUT = 600;
 const agentMetadataNegativeCache = new Map();
 let agentTuiReadyStableSamplesTestOverride = null;
-function claudeHookScriptPath() {
-    return path.join(path.dirname(fileURLToPath(import.meta.url)), "claude-stop-hook.js");
-}
-// process.execPath は Homebrew 等では Cellar の版付き実体を指す。長寿命 MCP server の起動後に
-// runtime が更新されるとその実体だけが消え、既に生成済みの hook が exit 127 になる。
-// hook は server と同じ継承 PATH から node を毎回解決し、安定した package script を実行する。
-function nodeHookCommand(hookScript) {
-    return `${shq("node")} ${shq(hookScript)}`;
-}
-function safeStatSize(p) {
-    try {
-        return fs.statSync(p).size;
-    }
-    catch {
-        return 0;
-    }
-}
-function readFileRange(p, from, to) {
-    const len = Math.max(0, to - from);
-    if (len === 0)
-        return Buffer.alloc(0);
-    let fd;
-    try {
-        fd = fs.openSync(p, "r");
-        const buf = Buffer.alloc(len);
-        const n = fs.readSync(fd, buf, 0, len, from);
-        return n === len ? buf : buf.subarray(0, Math.max(0, n));
-    }
-    catch {
-        return Buffer.alloc(0);
-    }
-    finally {
-        if (fd !== undefined) {
-            try {
-                fs.closeSync(fd);
-            }
-            catch {
-                /* noop */
-            }
-        }
-    }
-}
-function writeJson0600(p, v) {
-    // truncate-in-place はクラッシュ/ENOSPC の窓で空・途中 JSON を残すので、temp→rename の原子的置換にする
-    const tmp = `${p}.${randomBytes(6).toString("hex")}.tmp`;
-    fs.writeFileSync(tmp, JSON.stringify(v, null, 2) + "\n", { mode: 0o600, flag: "wx" });
-    try {
-        fs.chmodSync(tmp, 0o600);
-    }
-    catch {
-        /* noop */
-    }
-    try {
-        fs.renameSync(tmp, p);
-    }
-    catch (e) {
-        try {
-            fs.unlinkSync(tmp);
-        }
-        catch {
-            /* noop */
-        }
-        throw e;
-    }
-}
-function writeText0600(p, text) {
-    fs.writeFileSync(p, text, { mode: 0o600 });
-    try {
-        fs.chmodSync(p, 0o600);
-    }
-    catch {
-        /* noop */
-    }
-}
-function createEmpty0600(p) {
-    // O_EXCL が「既存 path なら失敗」を保証するため、新規作成の一意性はこれで足りる。
-    // O_NOFOLLOW は撤去した（オーナー裁定 2026-08-19）。
-    const fd = fs.openSync(p, fs.constants.O_CREAT | fs.constants.O_EXCL | fs.constants.O_WRONLY, 0o600);
-    fs.closeSync(fd);
-}
-function realCodexHome() {
-    return process.env.CODEX_HOME || path.join(process.env.HOME ?? os.homedir(), ".codex");
-}
-function readCodexConfigPins(configPath) {
-    let body;
-    try {
-        body = fs.readFileSync(configPath, "utf8");
-    }
-    catch {
-        return { model: { present: false, value: null }, effort: { present: false, value: null } };
-    }
-    const rows = body.split(/\r?\n/);
-    let firstTable = rows.findIndex((l) => /^\s*\[/.test(l));
-    if (firstTable === -1)
-        firstTable = rows.length;
-    const pick = (key) => {
-        for (const l of rows.slice(0, firstTable)) {
-            const m = l.match(new RegExp(`^\\s*(?:"${key}"|'${key}'|${key})\\s*=\\s*(.*)$`));
-            if (m) {
-                const v = m[1].trim().match(/^"([^"\\]*)"\s*(?:#.*)?$/);
-                return { present: true, value: v ? v[1] : null };
-            }
-        }
-        return { present: false, value: null };
-    };
-    return { model: pick("model"), effort: pick("model_reasoning_effort") };
-}
-function codexConfigSummary(configPath) {
-    let body;
-    try {
-        body = fs.readFileSync(configPath, "utf8");
-    }
-    catch {
-        return "";
-    }
-    const rows = body.split(/\r?\n/);
-    const mcpServers = rows.filter((line) => /^\s*\[mcp_servers\./.test(line)).length;
-    const firstTable = rows.findIndex((line) => /^\s*\[/.test(line));
-    const topLevel = rows.slice(0, firstTable === -1 ? rows.length : firstTable);
-    const valueOf = (key) => {
-        const row = topLevel.find((line) => new RegExp(`^\\s*(?:"${key}"|'${key}'|${key})\\s*=\\s*(.+?)\\s*(?:#.*)?$`).test(line));
-        if (!row)
-            return null;
-        const raw = row.match(/=\s*(.+?)(?:\s+#.*)?$/)?.[1].trim() ?? null;
-        if (!raw)
-            return null;
-        const quoted = raw.match(/^(?:"([^"\\]*)"|'([^'\\]*)')$/);
-        return quoted ? quoted[1] ?? quoted[2] : raw;
-    };
-    const bits = [`mcp_servers ${mcpServers} 個継承`];
-    const approvalPolicy = valueOf("approval_policy");
-    const sandboxMode = valueOf("sandbox_mode");
-    if (approvalPolicy)
-        bits.push(`approval_policy=${approvalPolicy}`);
-    if (sandboxMode)
-        bits.push(`sandbox_mode=${sandboxMode}`);
-    return `共有 config: ${bits.join(" / ")}`;
-}
-function createClaudeCorrelationSettings(name, launchId, model, effort) {
-    const hookScript = claudeHookScriptPath();
-    if (!fs.existsSync(hookScript)) {
-        throw new AitermError(`Claude Stop hook wrapper が見つかりません。npm run build を実行してください: ${hookScript}`, 2);
-    }
-    const settings = agentManagedClaudeSettingsPath(name, launchId);
-    writeJson0600(settings, {
-        ...(model ? { model } : {}),
-        ...(effort ? { effortLevel: effort } : {}),
-        hooks: {
-            Stop: [
-                {
-                    hooks: [
-                        {
-                            type: "command",
-                            command: nodeHookCommand(hookScript),
-                            timeout: 10,
-                        },
-                    ],
-                },
-            ],
-        },
-    });
-    return settings;
-}
-function realGrokHome() {
-    return path.resolve(process.env.GROK_HOME || path.join(process.env.HOME ?? os.homedir(), ".grok"));
-}
-function resolveAndValidateGrokAuth(srcHome) {
-    const inheritedSet = Object.prototype.hasOwnProperty.call(process.env, "GROK_AUTH_PATH");
-    const inherited = process.env.GROK_AUTH_PATH;
-    if (inheritedSet && (!inherited || !path.isAbsolute(inherited)))
-        throw new AitermError("GROK_AUTH_PATH は空でない絶対パスで指定してください", 2);
-    const authPath = inherited ?? path.join(srcHome, "auth.json");
-    let fd;
-    try {
-        fd = fs.openSync(authPath, fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW | fs.constants.O_NONBLOCK);
-        const st = fs.fstatSync(fd);
-        // Windows の fs.Stats.mode は POSIX permission bit を持たず、常に 666/777 相当を報告する
-        // （NTFS ACL は別体系）。currentUid と同じ既知制約の明示的受容として、Windows では
-        // group/other bit 検証を行わない。isFile・nlink・owner・size・O_NOFOLLOW・realpath 検証は共通に維持する。
-        const worldAccessible = !isWin && (st.mode & 0o077) !== 0;
-        if (!st.isFile() || st.nlink !== 1 || st.uid !== currentUid() || worldAccessible || st.size > GROK_AUTH_MAX_BYTES) {
-            throw new AitermError("Grok 認証正本の安全検証に失敗しました", 2);
-        }
-        const value = JSON.parse(fs.readFileSync(fd, "utf8"));
-        if (!value || typeof value !== "object" || Array.isArray(value))
-            throw new AitermError("Grok 認証正本のJSONが不正です", 2);
-        // auth file 自体は O_NOFOLLOW で開いているが、中間 directory の symlink は辿り得る。
-        // vendor に渡す正本を path swap の入口にしないため、字句正規化した絶対 path と realpath を
-        // 一致させ、canonical な祖先も root まで検証する。same-UID race の排他は vendor lock の責務。
-        const lexicalPath = path.resolve(authPath);
-        const canonicalPath = fs.realpathSync(authPath);
-        if (lexicalPath !== canonicalPath)
-            throw new AitermError("Grok 認証正本の path に symlink を含められません", 2);
-        for (let dir = path.dirname(canonicalPath);; dir = path.dirname(dir)) {
-            const dirSt = fs.lstatSync(dir);
-            // /tmp のような root 所有 + sticky の共有 directory は、本人所有の private な
-            // 直下 directory を他 UID が rename/unlink できないため許可する。sticky 無しの
-            // group/other writable 祖先は path swap が可能なので従来どおり拒否する。
-            // Windows は directory も mode bit を持たない（常に 777 相当）ため、同じ受容で除外する。
-            const writableByOthers = !isWin && (dirSt.mode & 0o022) !== 0;
-            const protectedSharedRoot = dirSt.uid === 0 && (dirSt.mode & 0o1000) !== 0;
-            if (!dirSt.isDirectory()
-                || dirSt.isSymbolicLink()
-                || (dirSt.uid !== currentUid() && dirSt.uid !== 0)
-                || (writableByOthers && !protectedSharedRoot)) {
-                throw new AitermError("Grok 認証正本の祖先 directory が安全ではありません", 2);
-            }
-            const parent = path.dirname(dir);
-            if (parent === dir)
-                break;
-        }
-        return canonicalPath;
-    }
-    catch (e) {
-        if (e.code === "ENOENT" && !inheritedSet && process.env.XAI_API_KEY)
-            return null;
-        if (e instanceof AitermError)
-            throw e;
-        throw new AitermError(e.code === "ENOENT" ? "Grok 認証正本が見つかりません。先に grok login が必要です" : "Grok 認証正本を安全に開けません", 2);
-    }
-    finally {
-        if (fd !== undefined)
-            fs.closeSync(fd);
-    }
-}
-function grokModelCatalog(bin, cwd) {
-    const result = spawnAgentControlCommand(bin, ["models"], cwd, {
-        cwd,
-        encoding: "utf8",
-        env: process.env,
-        timeout: GROK_MODELS_TIMEOUT_MS,
-        maxBuffer: GROK_MODELS_MAX_BYTES,
-        windowsHide: true,
-    });
-    if (result.error || result.status !== 0) {
-        const detail = result.error?.message || result.stderr?.trim() || `exit=${result.status ?? "unknown"}`;
-        throw new AitermError(`Grok model catalog を取得できません: ${detail}`, 2);
-    }
-    const text = result.stdout.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, "");
-    const marker = "Available models:";
-    const start = text.indexOf(marker);
-    if (start < 0)
-        throw new AitermError("Grok model catalog の出力形式が不正です（Available models がありません）", 2);
-    const models = [];
-    for (const line of text.slice(start + marker.length).split(/\r?\n/)) {
-        const match = line.match(/^\s{2}[-*]\s+(.+?)(?:\s+\(default\))?\s*$/);
-        if (match?.[1])
-            models.push(match[1]);
-    }
-    if (models.length === 0)
-        throw new AitermError("Grok model catalog に利用可能なmodelがありません", 2);
-    return models;
-}
-function assertGrokModelAvailable(bin, cwd, model) {
-    const models = grokModelCatalog(bin, cwd);
-    if (!models.includes(model)) {
-        throw new AitermError(`Grok model catalog に ${JSON.stringify(model)} がありません。利用可能: ${models.join(", ")}。` +
-            "別modelへfallbackせず起動を中止しました", 2);
-    }
-}
-function writeAgentMetadata(meta) {
-    writeJson0600(agentMetadataPath(meta.aiterm_session, meta.launch_id), meta);
-}
-function validateOperationId(operationId) {
-    if (typeof operationId !== "string" || !OPERATION_ID_RE.test(operationId)) {
-        throw new AitermError("operation_id は sha256:<64 lowercase hex> で指定してください", 2);
-    }
-    return operationId;
-}
 function writeClaudeOperationMarker(meta, operationId) {
     if (meta.kind !== "claude")
         throw new AitermError("operation_id はClaude agent sessionだけで使用できます", 2);
@@ -1997,82 +1536,6 @@ function liveWaitLocks(name) {
     }
     return out;
 }
-function createClaudeAgentMetadata(name, cwd, initialPrompt, launchOperationId, launchRequestDigest, lineageContext, model, effort) {
-    const launchId = randomBytes(16).toString("hex");
-    const eventFile = agentEventPath(name, launchId);
-    const resultFile = agentClaudeResultPath(name, launchId);
-    createEmpty0600(eventFile);
-    createEmpty0600(resultFile);
-    const claudeSettings = createClaudeCorrelationSettings(name, launchId, model, effort);
-    const meta = {
-        kind: "claude",
-        aiterm_session: name,
-        launch_id: launchId,
-        event_file: eventFile,
-        created_at: new Date().toISOString(),
-        cwd,
-        vendor_session_id: randomUUID(),
-        initial_prompt: initialPrompt,
-        launch_operation_id: launchOperationId,
-        launch_request_digest: launchRequestDigest,
-        hook_route: "shared_claude_settings",
-        ...agentLineageFields(lineageContext),
-        node_platform: process.platform,
-        claude_settings: claudeSettings,
-        result_file: resultFile,
-    };
-    writeAgentMetadata(meta);
-    return meta;
-}
-function createCodexAgentMetadata(name, cwd, initialPrompt, overrides = {}, writeScope, lineageContext) {
-    const launchId = randomBytes(16).toString("hex");
-    const eventFile = agentEventPath(name, launchId);
-    createEmpty0600(eventFile);
-    const codexHome = realCodexHome();
-    const meta = {
-        kind: "codex",
-        aiterm_session: name,
-        launch_id: launchId,
-        event_file: eventFile,
-        created_at: new Date().toISOString(),
-        cwd,
-        ...(writeScope === undefined ? {} : { write_scope: writeScope }),
-        vendor_session_id: null,
-        initial_prompt: initialPrompt,
-        hook_route: "shared_codex_home",
-        completion_route: "codex_transcript",
-        ...(lineageContext ? agentLineageFields(lineageContext) : {}),
-        node_platform: process.platform,
-        codex_home: codexHome,
-    };
-    writeAgentMetadata(meta);
-    return meta;
-}
-function createGrokAgentMetadata(kind, name, cwd, initialPrompt, authPath, writeScope, lineageContext) {
-    const launchId = randomBytes(16).toString("hex");
-    const eventFile = agentEventPath(name, launchId);
-    createEmpty0600(eventFile);
-    const grokHome = realGrokHome();
-    const meta = {
-        kind,
-        aiterm_session: name,
-        launch_id: launchId,
-        event_file: eventFile,
-        created_at: new Date().toISOString(),
-        cwd,
-        ...(writeScope === undefined ? {} : { write_scope: writeScope }),
-        vendor_session_id: randomUUID(),
-        initial_prompt: initialPrompt,
-        hook_route: "shared_grok_home",
-        completion_route: "grok_transcript",
-        ...(lineageContext ? agentLineageFields(lineageContext) : {}),
-        node_platform: process.platform,
-        grok_home: grokHome,
-        grok_auth_path: authPath,
-    };
-    writeAgentMetadata(meta);
-    return meta;
-}
 function loadAgentLineageFields(m, required) {
     const present = m.agent_role !== undefined ||
         m.parent_session_id !== undefined ||
@@ -2319,7 +1782,7 @@ function bindCompletedInitialPrompt(meta) {
     if (meta.initial_prompt !== "pending" && meta.initial_prompt !== "sent")
         return;
     if (meta.kind === "codex") {
-        const done = latestCodexCompletion(meta);
+        const done = latestCodexCompletion(meta, readTranscriptLines);
         if (!done) {
             throw new AitermError(`agent session '${meta.aiterm_session}' は起動時 prompt の完了待ちです。${agentWaitGuide(meta.aiterm_session)}`, 2);
         }
@@ -2328,7 +1791,7 @@ function bindCompletedInitialPrompt(meta) {
         return;
     }
     if ((meta.kind === "grok" || meta.kind === "composer") && meta.completion_route === "grok_transcript") {
-        if (!latestGrokCompletion(meta)) {
+        if (!latestGrokCompletion(meta, readTranscriptLines)) {
             throw new AitermError(`agent session '${meta.aiterm_session}' は起動時 prompt の完了待ちです。${agentWaitGuide(meta.aiterm_session)}`, 2);
         }
         setInitialPromptState(meta, "done");
@@ -2363,9 +1826,9 @@ function tryLoadAgentMetadata(name) {
 }
 function latestAgentDoneEvent(meta, expectedOperationId = null) {
     if (meta.kind === "codex")
-        return latestCodexCompletion(meta);
+        return latestCodexCompletion(meta, readTranscriptLines);
     if ((meta.kind === "grok" || meta.kind === "composer") && meta.completion_route === "grok_transcript") {
-        return latestGrokCompletion(meta);
+        return latestGrokCompletion(meta, readTranscriptLines);
     }
     const size = safeStatSize(meta.event_file);
     if (size === 0)
@@ -2425,7 +1888,7 @@ function recoverAgentVendorSession(meta) {
         const transcript = bindCodexTranscriptSession(meta);
         if (!transcript)
             return;
-        if (meta.initial_prompt === "pending" && latestCodexCompletion(meta))
+        if (meta.initial_prompt === "pending" && latestCodexCompletion(meta, readTranscriptLines))
             setInitialPromptState(meta, "done");
         return;
     }
@@ -2447,263 +1910,6 @@ function recoverAgentVendorSession(meta) {
     bindAgentVendorSession(meta, scanned.event);
     writeAgentMetadata(meta);
 }
-function findLatestCodexTranscript(codexHome, vendorSessionId) {
-    const sessionsDir = path.join(codexHome, "sessions");
-    let latestFile = null;
-    let latestMtime = -Infinity;
-    const visit = (dir) => {
-        let entries;
-        try {
-            entries = fs.readdirSync(dir, { withFileTypes: true });
-        }
-        catch {
-            return;
-        }
-        for (const entry of entries) {
-            const file = path.join(dir, entry.name);
-            if (entry.isDirectory()) {
-                visit(file);
-                continue;
-            }
-            if (!entry.isFile() || !entry.name.startsWith("rollout-") || !entry.name.endsWith(".jsonl") || !entry.name.includes(vendorSessionId))
-                continue;
-            try {
-                const mtimeMs = fs.statSync(file).mtimeMs;
-                if (mtimeMs > latestMtime) {
-                    latestFile = file;
-                    latestMtime = mtimeMs;
-                }
-            }
-            catch {
-                // 探索中に消えた transcript は候補にしない。候補が無ければ明示エラーにする。
-            }
-        }
-    };
-    visit(sessionsDir);
-    return latestFile;
-}
-function listCodexTranscripts(codexHome) {
-    const sessionsDir = path.join(codexHome, "sessions");
-    const files = [];
-    const visit = (dir) => {
-        let entries;
-        try {
-            entries = fs.readdirSync(dir, { withFileTypes: true });
-        }
-        catch {
-            return;
-        }
-        for (const entry of entries) {
-            const file = path.join(dir, entry.name);
-            if (entry.isDirectory())
-                visit(file);
-            else if (entry.isFile() && entry.name.startsWith("rollout-") && entry.name.endsWith(".jsonl"))
-                files.push(file);
-        }
-    };
-    visit(sessionsDir);
-    return files.sort();
-}
-function codexTranscriptMatchesLaunch(file, meta) {
-    const createdAt = Date.parse(meta.created_at);
-    try {
-        const st = fs.statSync(file);
-        if (Number.isFinite(createdAt) && st.mtimeMs + 5_000 < createdAt)
-            return false;
-    }
-    catch {
-        return false;
-    }
-    const size = Math.min(safeStatSize(file), 1024 * 1024);
-    if (size === 0)
-        return false;
-    const marker = `AITERM_AGENT_LAUNCH_ID=${meta.launch_id}`;
-    let rootCli = false;
-    let launchMarker = false;
-    for (const line of readFileRange(file, 0, size).toString("utf8").split("\n")) {
-        if (!line.trim())
-            continue;
-        let record;
-        try {
-            record = JSON.parse(line);
-        }
-        catch {
-            continue;
-        }
-        if (record?.type === "session_meta") {
-            rootCli = record?.payload?.originator === "codex-tui" && record?.payload?.source === "cli";
-            if (!rootCli)
-                return false;
-        }
-        if (record?.type === "response_item" &&
-            record?.payload?.type === "message" &&
-            record?.payload?.role === "developer" &&
-            Array.isArray(record?.payload?.content)) {
-            launchMarker ||= record.payload.content.some((item) => (item?.type === "input_text" || item?.type === "output_text") &&
-                typeof item?.text === "string" &&
-                item.text.includes(marker));
-        }
-        if (rootCli && launchMarker)
-            return true;
-    }
-    return false;
-}
-function codexTranscriptSessionId(file) {
-    const size = Math.min(safeStatSize(file), AGENT_EVENT_TAIL_BYTES);
-    if (size === 0)
-        return null;
-    const text = readFileRange(file, 0, size).toString("utf8");
-    for (const line of text.split("\n")) {
-        if (!line.trim())
-            continue;
-        try {
-            const record = JSON.parse(line);
-            if (record?.type === "session_meta" && typeof record?.payload?.id === "string" && record.payload.id) {
-                return record.payload.id;
-            }
-        }
-        catch {
-            // startup中の未完結行は後のpollで読み直す。
-        }
-    }
-    return null;
-}
-function codexRootTranscript(meta) {
-    if (meta.kind !== "codex" || !meta.codex_home)
-        return null;
-    if (meta.vendor_session_id)
-        return findLatestCodexTranscript(meta.codex_home, meta.vendor_session_id);
-    if (meta.hook_route === "shared_codex_home") {
-        const matches = listCodexTranscripts(meta.codex_home).filter((file) => codexTranscriptMatchesLaunch(file, meta));
-        if (matches.length > 1) {
-            throw new AitermError("共有CODEX_HOMEに同じlaunch markerのroot rolloutが複数あります。sessionを閉じて起動し直してください。", 2);
-        }
-        return matches[0] ?? null;
-    }
-    return listCodexTranscripts(meta.codex_home)[0] ?? null;
-}
-function bindCodexTranscriptSession(meta) {
-    const transcript = codexRootTranscript(meta);
-    if (!transcript)
-        return null;
-    const vendorSessionId = codexTranscriptSessionId(transcript);
-    if (vendorSessionId && !meta.vendor_session_id) {
-        meta.vendor_session_id = vendorSessionId;
-        writeAgentMetadata(meta);
-    }
-    return transcript;
-}
-function codexCompletionEvent(meta, vendorSessionId, record) {
-    if (record?.type !== "event_msg" ||
-        record?.payload?.type !== "task_complete" ||
-        typeof record?.payload?.turn_id !== "string" ||
-        !record.payload.turn_id)
-        return null;
-    return {
-        type: "agent_done",
-        vendor: "codex",
-        aiterm_session: meta.aiterm_session,
-        launch_id: meta.launch_id,
-        vendor_session_id: vendorSessionId,
-        turn_id: record.payload.turn_id,
-        operation_id: null,
-        reason: "Codex transcript task_complete",
-        done_status: "turn_done",
-        stop_hook_active: false,
-        at: typeof record.timestamp === "string" ? record.timestamp : new Date().toISOString(),
-    };
-}
-function latestCodexCompletion(meta) {
-    const transcript = codexRootTranscript(meta);
-    if (!transcript)
-        return null;
-    const vendorSessionId = meta.vendor_session_id ?? codexTranscriptSessionId(transcript);
-    let latest = null;
-    for (const line of readTranscriptLines(transcript)) {
-        if (!line.trim())
-            continue;
-        try {
-            latest = codexCompletionEvent(meta, vendorSessionId, JSON.parse(line)) ?? latest;
-        }
-        catch {
-            // Codexが末尾を書込み中なら、その行は次の観測で完結してから読む。
-        }
-    }
-    return latest;
-}
-function grokSessionDirectory(meta) {
-    if ((meta.kind !== "grok" && meta.kind !== "composer") || !meta.grok_home || !meta.vendor_session_id)
-        return null;
-    const cwd = meta.cwd ?? process.cwd();
-    return path.join(meta.grok_home, "sessions", encodeURIComponent(cwd), meta.vendor_session_id);
-}
-function grokEventsTranscript(meta) {
-    const dir = grokSessionDirectory(meta);
-    return dir ? path.join(dir, "events.jsonl") : null;
-}
-function grokCompletionEvent(meta, record) {
-    if ((meta.kind !== "grok" && meta.kind !== "composer") ||
-        record?.type !== "turn_ended" ||
-        (record?.outcome !== "completed" && record?.outcome !== "cancelled"))
-        return null;
-    const turnId = typeof record?.ts === "string" || typeof record?.ts === "number" ? String(record.ts) : null;
-    return {
-        type: "agent_done",
-        vendor: meta.kind,
-        aiterm_session: meta.aiterm_session,
-        launch_id: meta.launch_id,
-        vendor_session_id: meta.vendor_session_id,
-        turn_id: turnId,
-        operation_id: null,
-        reason: `Grok transcript turn_ended:${record.outcome}`,
-        done_status: "turn_done",
-        stop_hook_active: false,
-        at: typeof record?.ts === "string" ? record.ts : new Date().toISOString(),
-    };
-}
-function latestGrokCompletion(meta) {
-    const transcript = grokEventsTranscript(meta);
-    if (!transcript || !fs.existsSync(transcript))
-        return null;
-    let latest = null;
-    for (const line of readTranscriptLines(transcript)) {
-        if (!line.trim())
-            continue;
-        try {
-            latest = grokCompletionEvent(meta, JSON.parse(line)) ?? latest;
-        }
-        catch {
-            // 末尾書込み中のlineは次の観測で完結してから読む。
-        }
-    }
-    return latest;
-}
-function grokInitializationComplete(meta) {
-    const transcript = grokEventsTranscript(meta);
-    if (!transcript || !fs.existsSync(transcript))
-        return false;
-    const size = safeStatSize(transcript);
-    const from = Math.max(0, size - GROK_TRANSCRIPT_INCREMENT_MAX_BYTES);
-    const lines = readFileRange(transcript, from, size).toString("utf8").split("\n");
-    if (from > 0)
-        lines.shift();
-    for (let index = lines.length - 1; index >= 0; index -= 1) {
-        const line = lines[index].trim();
-        if (!line)
-            continue;
-        try {
-            const record = JSON.parse(line);
-            if (record?.type === "mcp_init_completed")
-                return true;
-            if (record?.type === "mcp_init_started")
-                return false;
-        }
-        catch {
-            // 末尾書込み中や無関係な破損lineはready判定を進めない。
-        }
-    }
-    return false;
-}
 function agentCompletionCursor(meta) {
     if ((meta.kind === "grok" || meta.kind === "composer") && meta.completion_route === "grok_transcript") {
         const transcript = grokEventsTranscript(meta);
@@ -2734,47 +1940,6 @@ function readTranscriptLines(file) {
         throw new AitermError(`transcript を読めません: ${e.message}`, 2);
     }
 }
-function readClaudeResultText(meta, done, operationId) {
-    if (meta.kind !== "claude" || !meta.result_file || !done.result_digest || done.result_bytes == null) {
-        transcriptUnavailable();
-    }
-    let st;
-    try {
-        st = fs.lstatSync(meta.result_file);
-    }
-    catch {
-        transcriptUnavailable();
-    }
-    if (!st.isFile() ||
-        st.isSymbolicLink() ||
-        st.uid !== currentUid() ||
-        st.nlink !== 1 ||
-        (!isWin && (st.mode & 0o077) !== 0) ||
-        st.size > CLAUDE_RESULT_MAX_BYTES + 4096) {
-        throw new AitermError("Claude result file の安全検証に失敗しました", 2);
-    }
-    let result;
-    try {
-        result = JSON.parse(fs.readFileSync(meta.result_file, "utf8"));
-    }
-    catch {
-        throw new AitermError("Claude result file を読めません", 2);
-    }
-    const keys = result && typeof result === "object" && !Array.isArray(result) ? Object.keys(result).sort() : [];
-    if (keys.join(",") !== "operation_id,result_bytes,result_digest,schema,text,vendor_session_id" ||
-        result.schema !== "aiterm.claude-turn-result.v2" ||
-        result.operation_id !== done.operation_id ||
-        (operationId !== null && result.operation_id !== operationId) ||
-        result.vendor_session_id !== meta.vendor_session_id ||
-        result.result_digest !== done.result_digest ||
-        result.result_bytes !== done.result_bytes ||
-        typeof result.text !== "string" ||
-        Buffer.byteLength(result.text, "utf8") !== done.result_bytes ||
-        createHash("sha256").update(result.text, "utf8").digest("hex") !== done.result_digest) {
-        throw new AitermError("Claude result file が完了eventと一致しません", 2);
-    }
-    return result.text;
-}
 const CLAUDE_COMPLETION_MARKER_SETTLE_TIMEOUT_MS = 1_000;
 function claudeCompletionWasPublishedAfterMarker(meta, marker) {
     let markerStat;
@@ -2833,75 +1998,13 @@ export async function readAgentTranscript(name, o = {}) {
     if (meta.kind === "claude") {
         if (!done)
             transcriptUnavailable();
-        text = readClaudeResultText(meta, done, operationId);
+        text = readClaudeResultText(meta, done, operationId, transcriptUnavailable);
     }
     else if (meta.kind === "codex") {
-        if (!meta.codex_home)
-            transcriptUnavailable();
-        const transcript = findLatestCodexTranscript(meta.codex_home, meta.vendor_session_id);
-        if (!transcript)
-            transcriptUnavailable();
-        const lines = readTranscriptLines(transcript);
-        const matching = [];
-        let finalAnswer = "";
-        for (const line of lines) {
-            if (!line.trim())
-                continue;
-            let record;
-            try {
-                record = JSON.parse(line);
-            }
-            catch {
-                continue;
-            }
-            const payload = record?.payload;
-            if (record?.type === "response_item" &&
-                payload?.type === "message" &&
-                payload?.role === "assistant" &&
-                payload?.internal_chat_message_metadata_passthrough?.turn_id === turnId &&
-                Array.isArray(payload?.content)) {
-                for (const item of payload.content) {
-                    if (item?.type === "output_text" && typeof item.text === "string")
-                        matching.push(item.text);
-                }
-            }
-            if (record?.type === "event_msg" &&
-                payload?.type === "agent_message" &&
-                payload?.phase === "final_answer" &&
-                typeof payload?.message === "string") {
-                finalAnswer = payload.message;
-            }
-        }
-        text = matching.join("\n") || finalAnswer;
+        text = codexTranscriptText(meta, turnId, readTranscriptLines, transcriptUnavailable);
     }
     else {
-        if (!meta.grok_home)
-            transcriptUnavailable();
-        // cwd 未指定で起動した TUI はサーバープロセスの cwd を継承する。metadata に null が残る既存
-        // launch との互換のため、その実際の起動 cwd を path 導出に使う（launch 側は変更しない）。
-        const cwd = meta.cwd ?? process.cwd();
-        const transcript = path.join(meta.grok_home, "sessions", encodeURIComponent(cwd), meta.vendor_session_id, "chat_history.jsonl");
-        const lines = readTranscriptLines(transcript);
-        let lastUser = -1;
-        const records = [];
-        for (const line of lines) {
-            if (!line.trim())
-                continue;
-            try {
-                const record = JSON.parse(line);
-                records.push(record);
-                if (record?.type === "user" && !("synthetic_reason" in record))
-                    lastUser = records.length - 1;
-            }
-            catch {
-                // 外部 transcript の壊れた1行は残りの完結行を読む妨げにしない。
-            }
-        }
-        text = records
-            .slice(lastUser + 1)
-            .filter((record) => record?.type === "assistant" && typeof record?.content === "string")
-            .map((record) => record.content)
-            .join("\n");
+        text = grokTranscriptText(meta, readTranscriptLines, transcriptUnavailable);
     }
     if (!text.trim())
         transcriptNotFound(meta.kind);
@@ -2998,153 +2101,47 @@ export function agentWaitGuide(session) {
     const cmd = `aiterm-wait --session ${session ?? "<session_id>"} --cursor 0`;
     return `完了通知は ${agentWaitLaunchForm(cmd)} で受ける（親はここで待たない・polling 不要）。receipt の outcome=done を確認してから再取得する。`;
 }
-async function observeCodexDone(meta, timeout, requestedCursor) {
-    const metadataFile = agentMetadataPath(meta.aiterm_session, meta.launch_id);
-    let transcript = codexRootTranscript(meta);
-    const startOffset = requestedCursor ?? (transcript ? safeStatSize(transcript) : 0);
-    let cursor = startOffset;
-    let carry = "";
-    let malformedEvents = 0;
-    let discardLeadingFragment = false;
-    let initializedBoundary = false;
-    const deadline = performance.now() + timeout * 1000;
-    const observation = (outcome, ev = null) => ({
-        schema: "aiterm.agent-wait-result.v1",
-        session_id: meta.aiterm_session,
-        launch_id: meta.launch_id,
-        vendor: "codex",
-        outcome,
-        operation_id: null,
-        vendor_session_id: ev?.vendor_session_id ?? meta.vendor_session_id ?? null,
-        turn_id: ev?.turn_id ?? null,
-        malformed_events: malformedEvents,
-        at: ev?.at ?? null,
-    });
-    for (;;) {
-        if (!fs.existsSync(metadataFile))
-            return observation("closed");
-        transcript ??= codexRootTranscript(meta);
-        if (transcript) {
-            if (!initializedBoundary) {
-                if (cursor > 0) {
-                    const previous = readFileRange(transcript, cursor - 1, cursor).toString("utf8");
-                    discardLeadingFragment = previous !== "\n";
-                }
-                initializedBoundary = true;
-            }
-            const size = safeStatSize(transcript);
-            if (size < cursor) {
-                throw new AitermError("Codex transcript が完了待機中に短くなりました。該当セッションを閉じて起動し直してください。", 2);
-            }
-            if (size - startOffset > CODEX_TRANSCRIPT_INCREMENT_MAX_BYTES) {
-                throw new AitermError("Codex transcript のturn増分が大きすぎます。該当セッションを閉じて起動し直してください。", 2);
-            }
-            if (size > cursor) {
-                carry += readFileRange(transcript, cursor, size).toString("utf8");
-                cursor = size;
-                const parts = carry.split("\n");
-                carry = parts.pop() ?? "";
-                if (discardLeadingFragment && parts.length > 0) {
-                    parts.shift();
-                    discardLeadingFragment = false;
-                }
-                const vendorSessionId = meta.vendor_session_id ?? codexTranscriptSessionId(transcript);
-                for (const line of parts) {
-                    if (!line.trim())
-                        continue;
-                    if (Buffer.byteLength(line, "utf8") > AGENT_EVENT_MAX_BYTES) {
-                        malformedEvents++;
-                        continue;
-                    }
-                    try {
-                        const done = codexCompletionEvent(meta, vendorSessionId, JSON.parse(line));
-                        if (done)
-                            return observation("done", done);
-                    }
-                    catch {
-                        malformedEvents++;
-                    }
-                }
-            }
-        }
-        if (performance.now() >= deadline)
-            return observation(timeout === 0 ? "running" : "timeout");
-        await sleep(AGENT_DONE_POLL_MS);
+// vendor 別の利用上限バナー。検知は「報告」専用で、完了判定や自動復旧には使わない。
+// 出典（2026-08-22）: grok は live 実バナーで検証、codex/claude はインストール済み実バイナリの
+// 埋込文字列から抽出（codex: "You've hit your usage limit for" / claude: "Usage limit reached ·
+// continuing automatically when it resets"。Claude Code はリセット時に自動継続する設計なので、
+// この報告は「今は上限で止まっている」の観測であり恒久停止を意味しない）。
+const AGENT_RATE_LIMIT_PATTERNS = {
+    grok: [/You hit your weekly limit/i, /Weekly limit left:\s*0%/i],
+    composer: [/You hit your weekly limit/i, /Weekly limit left:\s*0%/i],
+    codex: [/You'?ve hit your usage limit/i],
+    claude: [/Usage limit reached/i],
+};
+const AGENT_RATE_LIMIT_SCAN_BYTES = 16 * 1024;
+// pane log の末尾から上限バナーを探す。読めない・無い・対象 vendor でないは全て null（誤検知より取りこぼし側へ倒す）。
+export function detectAgentRateLimit(kind, aitermSession) {
+    const patterns = AGENT_RATE_LIMIT_PATTERNS[kind];
+    if (!patterns)
+        return null;
+    const file = logpath(aitermSession);
+    let size;
+    try {
+        size = fs.statSync(file).size;
     }
-}
-async function observeGrokDone(meta, timeout, requestedCursor) {
-    const metadataFile = agentMetadataPath(meta.aiterm_session, meta.launch_id);
-    const transcript = grokEventsTranscript(meta);
-    if (!transcript)
-        throw new AitermError("Grok transcriptのsession相関情報がありません", 2);
-    const startOffset = requestedCursor ?? safeStatSize(transcript);
-    let cursor = startOffset;
-    let carry = "";
-    let malformedEvents = 0;
-    let discardLeadingFragment = false;
-    let initializedBoundary = false;
-    const deadline = performance.now() + timeout * 1000;
-    const observation = (outcome, ev = null) => ({
-        schema: "aiterm.agent-wait-result.v1",
-        session_id: meta.aiterm_session,
-        launch_id: meta.launch_id,
-        vendor: meta.kind,
-        outcome,
-        operation_id: null,
-        vendor_session_id: meta.vendor_session_id,
-        turn_id: ev?.turn_id ?? null,
-        malformed_events: malformedEvents,
-        at: ev?.at ?? null,
-    });
-    for (;;) {
-        if (!fs.existsSync(metadataFile))
-            return observation("closed");
-        if (fs.existsSync(transcript)) {
-            if (!initializedBoundary) {
-                if (cursor > 0) {
-                    const previous = readFileRange(transcript, cursor - 1, cursor).toString("utf8");
-                    discardLeadingFragment = previous !== "\n";
-                }
-                initializedBoundary = true;
-            }
-            const size = safeStatSize(transcript);
-            if (size < cursor) {
-                throw new AitermError("Grok transcript が完了待機中に短くなりました。該当セッションを閉じて起動し直してください。", 2);
-            }
-            if (size - startOffset > GROK_TRANSCRIPT_INCREMENT_MAX_BYTES) {
-                throw new AitermError("Grok transcript のturn増分が大きすぎます。該当セッションを閉じて起動し直してください。", 2);
-            }
-            if (size > cursor) {
-                carry += readFileRange(transcript, cursor, size).toString("utf8");
-                cursor = size;
-                const parts = carry.split("\n");
-                carry = parts.pop() ?? "";
-                if (discardLeadingFragment && parts.length > 0) {
-                    parts.shift();
-                    discardLeadingFragment = false;
-                }
-                for (const line of parts) {
-                    if (!line.trim())
-                        continue;
-                    if (Buffer.byteLength(line, "utf8") > AGENT_EVENT_MAX_BYTES) {
-                        malformedEvents++;
-                        continue;
-                    }
-                    try {
-                        const done = grokCompletionEvent(meta, JSON.parse(line));
-                        if (done)
-                            return observation("done", done);
-                    }
-                    catch {
-                        malformedEvents++;
-                    }
-                }
-            }
-        }
-        if (performance.now() >= deadline)
-            return observation(timeout === 0 ? "running" : "timeout");
-        await sleep(AGENT_DONE_POLL_MS);
+    catch {
+        return null;
+    }
+    if (size === 0)
+        return null;
+    let text;
+    try {
+        text = readFileRange(file, Math.max(0, size - AGENT_RATE_LIMIT_SCAN_BYTES), size).toString("utf8");
+    }
+    catch {
+        return null;
+    }
+    const clean = text.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, "");
+    for (const re of patterns) {
+        const match = clean.match(re);
+        if (match)
+            return match[0];
     }
+    return null;
 }
 // 外部waiterプロセス用の純リーダー観測。lock・PTY・metadata書込・dispatch状態には一切触れない。
 // Codexはrollout transcript、他vendorはevent fileを増分走査し、vendor_session_idのbind永続化を
@@ -3160,10 +2157,10 @@ export async function observeAgentDone(name, o = {}) {
     }
     const timeout = o.timeout ?? DEFAULT_AGENT_DONE_TIMEOUT;
     if (meta.kind === "codex" && meta.completion_route === "codex_transcript") {
-        return observeCodexDone(meta, timeout, o.cursor);
+        return observeCodexDone(meta, timeout, o.cursor, detectAgentRateLimit);
     }
     if ((meta.kind === "grok" || meta.kind === "composer") && meta.completion_route === "grok_transcript") {
-        return observeGrokDone(meta, timeout, o.cursor);
+        return observeGrokDone(meta, timeout, o.cursor, detectAgentRateLimit);
     }
     const metadataFile = agentMetadataPath(meta.aiterm_session, meta.launch_id);
     // 境界の優先順: dispatch receipt の event_cursor（起動順序に依存しない）→ operation相関
@@ -3173,7 +2170,7 @@ export async function observeAgentDone(name, o = {}) {
     let cursor = startOffset;
     let carry = "";
     let malformedEvents = 0;
-    const observation = (outcome, ev = null) => ({
+    const observation = (outcome, ev = null, rateLimit = null) => ({
         schema: "aiterm.agent-wait-result.v1",
         session_id: meta.aiterm_session,
         launch_id: meta.launch_id,
@@ -3184,6 +2181,7 @@ export async function observeAgentDone(name, o = {}) {
         turn_id: ev?.turn_id ?? null,
         malformed_events: malformedEvents,
         at: ev?.at ?? null,
+        rate_limit: rateLimit,
     });
     for (;;) {
         if (!fs.existsSync(metadataFile))
@@ -3211,27 +2209,22 @@ export async function observeAgentDone(name, o = {}) {
         }
         // timeout=0 は「待たずに一度だけ見る」照会＝未完了は失敗ではなく running。
         // 1秒以上を指定した待機の未完了は従来どおり timeout で、待ち方の意味は変えない。
+        {
+            const limited = detectAgentRateLimit(meta.kind, meta.aiterm_session);
+            if (limited)
+                return observation("rate_limited", null, limited);
+        }
         if (performance.now() >= deadline)
             return observation(timeout === 0 ? "running" : "timeout");
         await sleep(AGENT_DONE_POLL_MS);
     }
 }
 function isAgentTuiReady(kind, screen) {
-    if (kind === "claude") {
-        return screen.includes("Claude Code") && /(^|\n)\s*❯/.test(screen);
-    }
-    if (kind === "codex") {
-        // 起動直後は製品header、長寿命sessionでは常駐footerがCodex TUIの識別子になる。
-        // capture-paneは直近45行だけなので、会話が進むとheaderは正常に画面外へ流れる。
-        const codexFrontend = screen.includes("OpenAI Codex")
-            || /(^|\n)\s*\S+\s+(?:low|medium|high|xhigh|max|ultra)(?:\s+fast)?\s+·\s+\S.*$/m.test(screen);
-        return codexFrontend && /(^|\n)\s*[›>]/.test(screen);
-    }
-    // Grok Build 0.2.117 は起動完了後に製品名を消し、model footerだけを残す。
-    // Composerも同じfrontendでmodel名だけが異なるため、両方をvendor UIの根拠にする。
-    // Windows native grok.exe（1.0.4 実測）は入力欄markerを `❯` でなく `>` で描画するため両方を受ける。
-    const grokFrontend = screen.includes("Grok Build") || /\b(?:Grok|Composer)\s+[\w.()-]+/.test(screen);
-    return grokFrontend && /(^|\n|\s)[❯>]/.test(screen);
+    if (kind === "claude")
+        return claudeTuiReady(screen);
+    if (kind === "codex")
+        return codexTuiReady(screen);
+    return grokTuiReady(screen);
 }
 // Codex/Claude は実行中に「(esc to interrupt)」を表示する（実機採取）。startup 側の処理
 // （MCP initialize 等）が走ったまま composer だけ描画されている画面は入力受付とみなさない。
@@ -3296,7 +2289,7 @@ function agentSubmitResidueOnScreen(kind, screen, tail) {
     // 入力欄マーカーは ready 判定と同じ記号を行頭基準で探す。submit 済みの transcript echo は
     // マーカー行より上に出るため、最後のマーカー行以降だけを composer 領域として見る。
     // grok/composer は Windows native 描画（`>`・実測 1.0.4）も ready 判定と同様に受ける。
-    const markerRe = kind === "codex" ? /^\s*[›>]/ : kind === "claude" ? /^\s*❯/ : /(^|\s)[❯>]/;
+    const markerRe = kind === "codex" ? CODEX_COMPOSER_MARKER_RE : kind === "claude" ? CLAUDE_COMPOSER_MARKER_RE : GROK_COMPOSER_MARKER_RE;
     let markerIdx = -1;
     for (let i = lines.length - 1; i >= 0; i--) {
         if (markerRe.test(lines[i])) {
@@ -3484,21 +2477,6 @@ function lineCounts(screen) {
     }
     return counts;
 }
-function grokFooterHasConfiguration(screen, model, effort) {
-    const modelMatch = model?.match(/^grok-(\d+(?:\.\d+)*)$/) ?? null;
-    if (model && !modelMatch)
-        return false;
-    const modelLabel = modelMatch ? `Grok ${modelMatch[1]}` : null;
-    return screen.split("\n").some((line) => {
-        if (!line.includes("·"))
-            return false;
-        if (modelLabel && !line.includes(`${modelLabel} (`))
-            return false;
-        if (effort && !line.includes(`(${effort})`))
-            return false;
-        return modelLabel !== null || effort !== null;
-    });
-}
 async function waitForGrokConfigurationResult(name, before, model, effort, timeoutMs = 3_000) {
     const beforeCounts = lineCounts(before);
     const footerAlreadyMatched = grokFooterHasConfiguration(before, model, effort);
@@ -3532,41 +2510,6 @@ function sendMenuChoice(name, choice) {
         throw new AitermError(`agent設定の選択を送れませんでした: ${sent.stderr.trim() || `code=${sent.code}`}`, 2);
     }
 }
-function codexModelChoice(screen, model) {
-    for (const line of screen.slice(screen.lastIndexOf("Select Model and Effort")).split("\n")) {
-        const match = line.match(/^\s*(?:›\s*)?(\d+)\.\s+(\S+)/);
-        if (match?.[2] === model)
-            return match[1];
-    }
-    return null;
-}
-function codexEffortChoice(screen, effort) {
-    const labels = {
-        low: /^Low\b/i,
-        medium: /^Medium\b/i,
-        high: /^High\b/i,
-        xhigh: /^Extra high\b/i,
-        max: /^Max\b/i,
-        ultra: /^Ultra\b/i,
-    };
-    const wanted = labels[effort.toLowerCase()];
-    if (!wanted)
-        return null;
-    for (const line of screen.split("\n")) {
-        const match = line.match(/^\s*(?:›\s*)?(\d+)\.\s+(.+?)\s{2,}/);
-        if (match && wanted.test(match[2]))
-            return match[1];
-    }
-    return null;
-}
-function codexMoreReasoningChoice(screen) {
-    for (const line of screen.split("\n")) {
-        const match = line.match(/^\s*(?:›\s*)?(\d+)\.\s+More reasoning/);
-        if (match)
-            return match[1];
-    }
-    return null;
-}
 /** 同じ対話sessionを保ったまま、vendor標準の操作でmodel／effortを変更する。 */
 export async function configureAgent(name, opts) {
     assertSessionName(name);
@@ -3779,47 +2722,13 @@ function inspectClaudeOperation(meta, operationId, action) {
         bindAgentVendorSession(meta, done);
         writeAgentMetadata(meta);
     }
-    const rawOutput = readClaudeResultText(meta, done, operationId);
+    const rawOutput = readClaudeResultText(meta, done, operationId, transcriptUnavailable);
     return { ...base, status: "completed", raw_output: rawOutput, reason: null };
 }
 // ── 対話型エージェント起動（Claude / Codex / Grok Build(Grok) / Grok Build(Composer)）──────
 // aiterm の永続端末に、指定モデルの対話エージェント TUI を起動する。以後は pty_read で画面を
 // 読み、pty_send で操作する＝aiterm の対話パラダイムそのもの。モデルはツールごとに固定し、
 // reasoning effort は引数で渡す。CLI 未導入環境は明示エラー（動くフリをしない）。
-const CLAUDE_AUTH_STATUS_TIMEOUT_MS = 5_000;
-function assertClaudeAuthenticationReady(bin) {
-    const result = spawnAgentControlCommand(bin, ["auth", "status", "--json"], process.cwd(), {
-        encoding: "utf8",
-        timeout: CLAUDE_AUTH_STATUS_TIMEOUT_MS,
-        maxBuffer: 64 * 1024,
-    });
-    let status = null;
-    try {
-        status = JSON.parse((result.stdout ?? "").trim());
-    }
-    catch {
-        status = null;
-    }
-    if (result.error == null &&
-        result.status === 0 &&
-        status !== null &&
-        typeof status === "object" &&
-        !Array.isArray(status) &&
-        status.loggedIn === true) {
-        return;
-    }
-    if (status !== null &&
-        typeof status === "object" &&
-        !Array.isArray(status) &&
-        status.loggedIn === false) {
-        throw new AitermError("Claude Codeの認証を利用できません。sessionは作成していません。" +
-            "通常端末で `claude doctor` を実行し、Keychain／credential storeを直してから一度だけ `claude auth login` を実行してください。" +
-            "aiterm相関付きClaude session内で /login を繰り返さないでください。", 2);
-    }
-    const timedOut = result.error && result.error.code === "ETIMEDOUT";
-    throw new AitermError(`Claude Codeの認証状態を起動前に確認できません${timedOut ? "（5秒でtimeout）" : ""}。sessionは作成していません。` +
-        "`claude auth status --json` と `claude doctor` が成功することを通常端末で確認してください。", 2);
-}
 const THROUGHLINE_HANDOFF_CONTEXT_SCHEMA = "throughline.handoff_context.v1";
 const PORTABLE_FORK_MISSION_SEPARATOR = "\n\n---\n\n## Portable fork mission\n\n";
 export function composePortableForkPrompt(context, mission) {
@@ -3862,66 +2771,12 @@ export function vendorLauncherDiagnostic(kind) {
         return "unverified";
     }
 }
-// 単一引用符で安全に包む（' は '\'' で脱出）。send は raw:true で送るため自前で quote する。
-function shq(s) {
-    return `'${s.replace(/'/g, "'\\''")}'`;
-}
-// grok CLI はモデル未指定だと端末側 default に従うため、ツール契約として既定 slug を固定する。
-// codex は既定 slug を持たず端末 config／CLI 既定に委ねる（起動応答で実効値を報告する）。
-// grok 既定は dotagents 規範（docs/02_models.md: xAI 旗艦 = grok-4.6）に従う。
-const GROK_MODEL_DEFAULTS = {
-    grok: "grok-4.6",
-    composer: "grok-composer-2.5-fast",
-};
-const CLAUDE_EFFORTS = new Set(["low", "medium", "high", "xhigh", "max"]);
 function buildAgentCmd(kind, bin, model, effort, prompt, meta = null) {
-    const parts = [shq(bin)];
-    if (kind === "claude") {
-        if (meta?.kind === "claude") {
-            parts.push("--setting-sources", shq("user,project,local"), "--settings", shq(meta.claude_settings ?? ""), "--session-id", shq(meta.vendor_session_id ?? ""), "--append-system-prompt", shq(subagentInstruction(meta)));
-        }
-        if (model)
-            parts.push("--model", shq(model));
-        if (effort)
-            parts.push("--effort", shq(effort));
-    }
-    else if (kind === "codex") {
-        // `codex --help` で確認した実在フラグ。read-only 宣言だけはCLI sandboxへ落とし、
-        // launcher自身が実効能力壁を作る。パス説明はCodex CLIに同等のallowlist引数がないため宣言のまま残す。
-        if (meta?.kind === "codex" && meta.write_scope === "read-only")
-            parts.push("--sandbox", "read-only");
-        // model/effort は共有configを書き換えず、CLI引数で明示して起動単位に優先する。
-        if (model)
-            parts.push("-m", shq(model));
-        if (effort)
-            parts.push("-c", `model_reasoning_effort=${shq(effort)}`);
-        if (meta?.kind === "codex" && meta.hook_route === "shared_codex_home") {
-            parts.push("-c", `developer_instructions=${shq(subagentInstruction(meta))}`);
-        }
-    }
-    else {
-        // grok / composer は同じ grok CLI をモデル違いで起動する。
-        parts.push("--no-auto-update");
-        if (meta?.kind === "grok" || meta?.kind === "composer")
-            parts.push("--no-alt-screen");
-        parts.push("--model", shq(model ?? GROK_MODEL_DEFAULTS[kind]));
-        if (effort)
-            parts.push("--reasoning-effort", shq(effort));
-        if ((meta?.kind === "grok" || meta?.kind === "composer") && meta.write_scope === "read-only") {
-            // read-only は sandbox が実効書込み禁止を作るため、MCP ツール許可ダイアログの自動承認を
-            // 付けても能力は増えない。無人 subagent が初回 MCP 使用の許可待ちで停止する実障害への対処。
-            // read-only 以外の launch には付けない＝権限拡大しない。
-            parts.push("--sandbox", "read-only", "--always-approve");
-        }
-        if ((meta?.kind === "grok" || meta?.kind === "composer") && meta.hook_route === "shared_grok_home") {
-            parts.push("--session-id", shq(meta.vendor_session_id ?? ""), "--rules", shq(subagentInstruction(meta)));
-        }
-        if ((meta?.kind === "grok" || meta?.kind === "composer") && prompt)
-            parts.push("--verbatim");
-    }
-    if (prompt)
-        parts.push(shq(prompt)); // 初手プロンプト（任意）
-    return parts.join(" ");
+    if (kind === "claude")
+        return buildClaudeAgentCmd(bin, model, effort, prompt, meta);
+    if (kind === "codex")
+        return buildCodexAgentCmd(bin, model, effort, prompt, meta);
+    return buildGrokAgentCmd(kind, bin, model, effort, prompt, meta);
 }
 function agentEnvPrefix(meta, sid, envVars = []) {
     const inherited = envVars.flatMap((name) => {
@@ -3945,60 +2800,16 @@ function agentEnvPrefix(meta, sid, envVars = []) {
         ];
         if (meta.kind === "claude" || meta.kind === "codex")
             return common;
-        // grok/composer: 検証済み auth 正本をそのままの path 形で渡す。Windows では native 強制により
-        // vendor は Windows process なので、Windows ドライブパスが正しい形（WSL 形への変換はしない）。
-        return [
-            ...(meta.grok_auth_path ? [`GROK_AUTH_PATH=${shq(meta.grok_auth_path)}`] : []),
-            "GROK_DISABLE_AUTOUPDATER=1",
-            ...common,
-        ];
+        return [...grokEnvTokens(meta), ...common];
     })();
     return tokens.length ? tokens.join(" ") + " " : "";
 }
-function agentLabel(kind) {
-    return kind === "claude"
-        ? "Claude Code"
-        : kind === "composer"
-            ? "Grok Build(Composer)"
-            : kind === "grok"
-                ? "Grok Build(Grok)"
-                : "Codex";
-}
-// 起動応答にモデル/effort の実効値と出所を明示する。codex は端末 config のピン（model /
-// model_reasoning_effort）が対話子へ波及する構造のため、引数・端末config継承・CLI既定の
-// どれで起動したかを起動時点で可視化し、実効 effort=ultra は proactive 自動委譲 ON を警告する。
 function buildAgentLaunchNote(kind, model, effort, meta) {
-    const writeScopeNote = meta?.write_scope === undefined
-        ? ""
-        : (kind === "codex" || kind === "grok" || kind === "composer") && meta.write_scope === "read-only"
-            ? `\n能力宣言: write_scope=${JSON.stringify(meta.write_scope)}。${agentLabel(kind)} CLIへ --sandbox read-only を付与し、書込みを実効禁止。` +
-                (kind === "codex" ? "" : "MCPツール許可は --always-approve で自動承認（sandbox内のため能力拡大なし）。")
-            : `\n能力宣言: write_scope=${JSON.stringify(meta.write_scope)}。パス単位のsandbox allowlistに対応するCLI引数がないため宣言の記録のみ（構造的unsupported）。`;
-    if (kind === "claude") {
-        return `起動設定: model=${model ?? "CLI既定"} effort=${effort ?? "CLI既定"}。${writeScopeNote}`;
-    }
-    if (kind !== "codex") {
-        return (`起動設定: model=${model ?? GROK_MODEL_DEFAULTS[kind]}（${model ? "引数" : "ツール既定"}）。` +
-            `effort=${effort ?? "CLI／model既定"}。` + writeScopeNote);
-    }
-    const configPath = meta?.kind === "codex" && meta.codex_home
-        ? path.join(meta.codex_home, "config.toml")
-        : path.join(realCodexHome(), "config.toml");
-    const pins = readCodexConfigPins(configPath);
-    const describePin = (arg, pin) => arg
-        ? `${arg}（引数）`
-        : pin.present
-            ? pin.value
-                ? `${pin.value}（端末config継承）`
-                : "端末config継承（値未解析）"
-            : "CLI既定";
-    const effectiveEffort = effort ?? (pins.effort.present ? pins.effort.value : null);
-    const launch = `起動設定: model=${describePin(model, pins.model)} effort=${describePin(effort, pins.effort)}。` +
-        (effectiveEffort === "ultra"
-            ? "⚠ effort=ultra は max 推論＋proactive 自動委譲 ON（子エージェント自動生成・使用量急増に注意）。"
-            : "");
-    const summary = meta?.kind === "codex" && meta.codex_home ? codexConfigSummary(configPath) : "";
-    return (summary ? `${launch}\n${summary}\n` : launch) + writeScopeNote;
+    if (kind === "claude")
+        return claudeLaunchNote(model, effort, meta);
+    if (kind !== "codex")
+        return grokLaunchNote(kind, model, effort, meta);
+    return codexLaunchNote(model, effort, meta);
 }
 function claudeLaunchRequestDigest({ sessionName, model, effort, cwd, agentDone, }) {
     const canonical = JSON.stringify({
@@ -4133,9 +2944,7 @@ export function openAgent(kind, opts = {}) {
             "Windows 版 Grok CLI を導入するか、GROK_BIN に grok.exe の絶対パスを指定してください。", 2), 2);
     }
     const binForCmd = agentBinForPaneShell(bin);
-    // Windows native pane（psmux + Git Bash）は Windows パスをそのまま扱える。
-    // Git Bash の cd はドライブパスを forward slash 形で受けるのが安全。
-    const cwdForCmd = cwd && isWin ? cwd.replace(/\\/g, "/") : cwd;
+    const cwdForCmd = cwd ? paneCwdArgument(cwd) : cwd;
     const grokAuthPath = agentDone && (kind === "grok" || kind === "composer") ? resolveAndValidateGrokAuth(realGrokHome()) : null;
     if (kind === "grok" || kind === "composer") {
         const requestedModel = model ?? (kind === "composer" ? GROK_MODEL_DEFAULTS.composer : null);