aiterm-mcp 0.27.1 → 0.27.6

package/dist/agent-resolver.js

@@ -0,0 +1,178 @@
+// エージェント CLI（claude / codex / grok）・Throughline・pane shell（Windows は Git Bash）の
+// 実行ファイルをどう見つけ、どう起動するかの所有者（OS 分岐の所有者。tmux とは独立）。
+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 { AitermError } from "./errors.js";
+import { isWin } from "./tmux-runtime.js";
+export function isUsableExecutableFile(candidate) {
+    try {
+        if (!fs.statSync(candidate).isFile())
+            return false;
+        if (isWin)
+            return /\.(?:exe|cmd|bat|com)$/i.test(candidate);
+        fs.accessSync(candidate, fs.constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function isWindowsDrivePath(candidate) {
+    return /^[A-Za-z]:[\\/]/.test(candidate);
+}
+export function isWindowsNativeExecutable(candidate) {
+    return isWindowsDrivePath(candidate) && /\.(?:exe|com|cmd|bat)$/i.test(candidate);
+}
+// Windows の bin 受入: native 実行ファイル（.exe/.cmd/.bat）に加え、pane shell
+// （Git Bash）が shebang で実行できる script も実在すれば受け入れる。旧 WSL 側
+// バイナリ検査への黙ったフォールバックは廃止（別 HOME・別 auth の subagent を
+// 作るため）。native 実行ファイルの強制が要る vendor（grok/composer の実効
+// sandbox 等）は openAgent 側の専用ゲートが明示エラーで担う。
+export function isUsableAgentExecutableFile(candidate) {
+    if (!isWin)
+        return isUsableExecutableFile(candidate);
+    if (isWindowsNativeExecutable(candidate))
+        return isUsableExecutableFile(candidate);
+    try {
+        return fs.statSync(candidate).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+export function resolveWindowsCodexShim(kind, candidate) {
+    if (!isWin || kind !== "codex" || !/\.(?:cmd|bat)$/i.test(candidate))
+        return candidate;
+    const packageRoot = path.join(path.dirname(candidate), "node_modules", "@openai", "codex", "node_modules", "@openai");
+    try {
+        for (const platformPackage of fs.readdirSync(packageRoot).filter((name) => name.startsWith("codex-win32-"))) {
+            const vendorRoot = path.join(packageRoot, platformPackage, "vendor");
+            for (const target of fs.readdirSync(vendorRoot)) {
+                const executable = path.join(vendorRoot, target, "bin", "codex.exe");
+                if (isUsableExecutableFile(executable))
+                    return executable;
+            }
+        }
+    }
+    catch {
+        /* 下の明示エラーへ */
+    }
+    throw new AitermError(`CODEX_BIN のnpm shimからWindows native codex.exeを解決できません: ${candidate}。` +
+        "@openai/codexを再インストールするか、CODEX_BINへcodex.exeを指定してください", 2);
+}
+// pane 内の POSIX shell（Windows は Git Bash 等）へ渡す bin パス。Git Bash は
+// バックスラッシュをエスケープとして解釈しうるため、ドライブパスは forward slash 形へ。
+export function agentBinForPaneShell(bin) {
+    return isWin && isWindowsDrivePath(bin) ? bin.replace(/\\/g, "/") : bin;
+}
+export function spawnAgentControlCommand(bin, args, _cwd, options) {
+    // 受入（isUsableAgentExecutableFile）が「使える」と判定した bin は、control command
+    //（`claude auth status --json`／`grok models`）でも同じく実行できなければならない。
+    if (isWin && !/\.(?:exe|com)$/i.test(bin)) {
+        if (/\.(?:cmd|bat)$/i.test(bin)) {
+            // Node は CVE-2024-27980 対処以降、.cmd/.bat の直接 spawn を EINVAL で拒否する。
+            // 受入が .cmd/.bat を許す以上、control 経路は shell 経由で実行する（args は固定語彙）。
+            return spawnSync(bin, args, { ...options, shell: true });
+        }
+        // 受入は pane shell（Git Bash）が shebang で実行できる script も許す。Windows の
+        // CreateProcess は shebang を解さないため、control command も同じ Git Bash で実行する。
+        // これを直接 spawn すると常に失敗し、「受入が通した bin で起動が必ず失敗する」矛盾になる。
+        return spawnSync(resolveWinPaneShell("bash"), [bin, ...args], options);
+    }
+    return spawnSync(bin, args, options);
+}
+export function resolveWinPaneShell(shell) {
+    if (!isWin || shell !== "bash")
+        return shell;
+    const fromEnv = process.env.AITERM_BASH;
+    if (fromEnv) {
+        if (isUsableExecutableFile(fromEnv))
+            return fromEnv;
+        throw new AitermError(`AITERM_BASH に指定された bash が存在しません: ${fromEnv}`, 2);
+    }
+    const candidates = [
+        path.join(process.env.ProgramFiles ?? "C:\\Program Files", "Git", "bin", "bash.exe"),
+        path.join(process.env["ProgramFiles(x86)"] ?? "C:\\Program Files (x86)", "Git", "bin", "bash.exe"),
+    ];
+    const gitPath = spawnSync("where.exe", ["git.exe"], { encoding: "utf8", timeout: 5000 })
+        .stdout?.split(/\r?\n/)
+        .find(Boolean);
+    if (gitPath)
+        candidates.push(path.join(path.dirname(path.dirname(gitPath)), "bin", "bash.exe"));
+    for (const cand of candidates) {
+        if (isUsableExecutableFile(cand))
+            return cand;
+    }
+    throw new AitermError("Git Bash が見つかりません。Windows ネイティブの pane shell には Git for Windows の bash.exe が必要です" +
+        "（System32 の bash.exe は WSL launcher のため使いません）。Git for Windows を導入するか、" +
+        "AITERM_BASH に bash.exe のパスを指定してください。", 2);
+}
+export function resolveAgentBin(kind) {
+    const home = process.env.HOME ?? os.homedir();
+    const [envVar, rel, name] = kind === "claude"
+        ? ["CLAUDE_BIN", [".local", "bin", "claude"], "claude"]
+        : kind === "codex"
+            ? ["CODEX_BIN", [".local", "bin", "codex"], "codex"]
+            : ["GROK_BIN", [".grok", "bin", isWin ? "grok.exe" : "grok"], "grok"];
+    const fromEnv = process.env[envVar];
+    if (fromEnv) {
+        // 明示指定 env は実在を検証する。存在しないパスを黙って返すと、session を作って
+        // `'/typo' ...` を送信し bash が command not found を出すだけで openAgent は「起動した」と
+        // 偽成功を返す（既定パス/PATH 経路は検証するのに env だけ無検証だった非対称の解消・A3）。
+        if (isUsableAgentExecutableFile(fromEnv))
+            return resolveWindowsCodexShim(kind, fromEnv);
+        throw new AitermError(`${envVar} に指定された ${name} が存在しません: ${fromEnv}`, 2);
+    }
+    const cand = path.join(home, ...rel);
+    if (isUsableAgentExecutableFile(cand))
+        return resolveWindowsCodexShim(kind, cand);
+    const w = spawnSync(isWin ? "where" : "which", [name], {
+        encoding: "utf8",
+        timeout: 5000,
+    });
+    if (w.status === 0 && (w.stdout ?? "").trim()) {
+        const found = w.stdout.trim().split(/\r?\n/).filter(Boolean);
+        const ordered = isWin
+            ? [...found.filter((p) => /\.(?:exe|com|cmd|bat)$/i.test(p)), ...found.filter((p) => !/\.(?:exe|com|cmd|bat)$/i.test(p))]
+            : found;
+        for (const resolved of ordered) {
+            if (isUsableAgentExecutableFile(resolved))
+                return resolveWindowsCodexShim(kind, resolved);
+        }
+    }
+    return null;
+}
+export function resolveThroughlineBin() {
+    const fromEnv = process.env.THROUGHLINE_BIN;
+    if (fromEnv)
+        return isUsableExecutableFile(fromEnv) ? fromEnv : null;
+    const resolved = spawnSync(isWin ? "where" : "which", ["throughline"], {
+        encoding: "utf8",
+    }).stdout?.split(/\r?\n/).find(Boolean) ?? null;
+    return resolved && isUsableExecutableFile(resolved) ? resolved : null;
+}
+export function runThroughlineHandoffContext(bin, sessionId) {
+    if (isWin && /\.(?:cmd|bat)$/i.test(bin)) {
+        const ps1 = path.join(path.dirname(bin), `${path.basename(bin, path.extname(bin))}.ps1`);
+        if (fs.existsSync(ps1)) {
+            return spawnSync("powershell.exe", [
+                "-NoLogo",
+                "-NoProfile",
+                "-NonInteractive",
+                "-ExecutionPolicy",
+                "Bypass",
+                "-File",
+                ps1,
+                "handoff-context",
+                "--session",
+                sessionId,
+                "--json",
+            ], { encoding: "utf8" });
+        }
+    }
+    return spawnSync(bin, ["handoff-context", "--session", sessionId, "--json"], {
+        encoding: "utf8",
+    });
+}

package/dist/aiterm-wait-cli.js

@@ -2,12 +2,12 @@
 // aiterm-wait — agent turn 完了eventの純リーダー観測CLI。
 // 完了/timeout/close を1行のJSON receiptで返してexitする。lock・PTY・dispatch状態には一切触れない。
 // 親AIホストのバックグラウンドタスクとして起動し、exitを「観測終了の通知」として使う。
-// exit≠完了: exit code は outcome を映す（0=done / 5=running=未完了 / 3=timeout=未完了 / 4=closed / 1=エラー）。
+// exit≠完了: exit code は outcome を映す（0=done / 5=running=未完了 / 3=timeout=未完了 / 4=closed / 6=rate_limited=vendor利用上限 / 1=エラー）。
 // --timeout 0 は待たずに一度だけ観測する照会で、未完了は running（timeout と混同させない）。
 // receipt の outcome が正で、done 以外は未完了。timeout の既定は core の DEFAULT_AGENT_DONE_TIMEOUT（600秒）。
 import { fileURLToPath } from "node:url";
 import * as fs from "node:fs";
-import { AitermError, observeAgentDone } from "./core.js";
+import { AitermError, detectAgentRateLimit, observeAgentDone } from "./core.js";
 const SESSION_RE = /^[A-Za-z0-9_-]{1,64}$/;
 const OPERATION_RE = /^sha256:[0-9a-f]{64}$/;
 const USAGE = "usage: aiterm-wait --session <name> [--cursor <event_cursor>] [--operation sha256:<64hex>] [--timeout <sec>]" +
@@ -74,14 +74,39 @@ const OUTCOME_EXIT_CODES = {
     running: 5,
     timeout: 3,
     closed: 4,
+    rate_limited: 6,
 };
 export async function main(argv) {
     const cmd = parseArgs(argv);
-    const result = await observeAgentDone(cmd.session, {
-        operation_id: cmd.operationId,
-        timeout: cmd.timeout,
-        cursor: cmd.cursor,
-    });
+    let result;
+    try {
+        result = await observeAgentDone(cmd.session, {
+            operation_id: cmd.operationId,
+            timeout: cmd.timeout,
+            cursor: cmd.cursor,
+        });
+    }
+    catch (e) {
+        // Grok は利用上限に達すると auth 正本を自壊させることがあり（2026-08-22 実測）、
+        // metadata 検証が「未ログイン」という嘘の原因で落ちる。pane log に上限バナーが
+        // あるなら、誤診でなく rate_limited として typed に回答する。
+        if (e instanceof AitermError && /Grok 認証正本/.test(e.message)) {
+            const limited = detectAgentRateLimit("grok", cmd.session);
+            if (limited) {
+                emit({
+                    ok: false,
+                    code: "AGENT_RATE_LIMITED",
+                    vendor: "grok",
+                    rate_limit: limited,
+                    message: "Grok が利用上限に達している。別のベンダーのモデルに切り替えてください。" +
+                        "（認証正本の不在は上限時に CLI が auth を自壊させた痕跡で、未ログインの誤診に注意）",
+                });
+                process.exitCode = 6;
+                return;
+            }
+        }
+        throw e;
+    }
     emit(result);
     process.exitCode = OUTCOME_EXIT_CODES[result.outcome];
 }