aiterm-mcp 0.58.3 → 0.59.0

package/dist/cursor-parent-receive.js

@@ -3,7 +3,8 @@
 import { fileURLToPath } from "node:url";
 import * as steer from "aiterm-steer-delivery";
 import { cursorHookRoots } from "./cursor-parent-receiver.js";
-export function cursorReceiveProcess(deliveryId, executable = process.execPath) {
+import { liveNodeExecutable } from "./live-node.js";
+export function cursorReceiveProcess(deliveryId, executable = liveNodeExecutable()) {
     return steer.cursorReceiveProcess(fileURLToPath(import.meta.url), deliveryId, executable);
 }
 /** 背景processの起動情報を、親のshellへ書ける1行にする（Windowsの既定shellはPowerShell）。 */

package/dist/fast-mode.js

@@ -0,0 +1,22 @@
+// ファスト（高速の応答）の切り替えの、harness中立の部分（ADR 0114）。
+// harnessごとの切り替え方は src/harnesses/ と core が持ち、ここは断りの符号と、起動時の扱いだけを持つ。
+import { AitermError } from "./errors.js";
+export class FastModeError extends AitermError {
+    fast_code;
+    constructor(code, detail) {
+        super(`${code}: ${detail}`, 2);
+        this.name = "FastModeError";
+        this.fast_code = code;
+    }
+}
+/**
+ * 起動時にfastへ出来なかった時、起動を断らずに通常の速度で起こす符号か。
+ * アカウントの都合（credits切れ等）や確かめられない時に起動まで断ると、呼び手の席が起きず、届いた文が落ちる。
+ * 設定の誤り（対応していないmodel、IDとの食い違い）は、起動の前に断る。
+ */
+export function launchContinuesWithoutFast(code) {
+    return code === "FAST_MODE_UNAVAILABLE" || code === "FAST_MODE_UNCONFIRMED";
+}
+export function fastModeFailure(error) {
+    return error instanceof FastModeError ? { code: error.fast_code, message: error.message } : null;
+}

package/dist/harnesses/claude.js

@@ -11,7 +11,7 @@ import { AitermError } from "../errors.js";
 import { modeBitsWorldAccessible } from "../tmux-runtime.js";
 import { runAgentProtocolCommand, spawnAgentControlCommand } from "../agent-resolver.js";
 import { catalogInvalid, catalogUnavailable, checkedCatalog, findJsonLine, processSummary } from "../model-catalog.js";
-import { currentUid, writeJson0600, shq, subagentInstruction, writeScopeLaunchNote, agentEventPath, createEmpty0600, writeAgentMetadata, agentLineageFields, assertSessionName, agentsDir, LAUNCH_ID_RE, AGENT_EVENT_TAIL_BYTES, readFileRange, } from "../agent-shared.js";
+import { currentUid, writeJson0600, shq, subagentInstruction, AGENT_DEFAULT_PREFACE, writeScopeLaunchNote, agentEventPath, createEmpty0600, writeAgentMetadata, agentLineageFields, assertSessionName, agentsDir, LAUNCH_ID_RE, AGENT_EVENT_TAIL_BYTES, readFileRange, } from "../agent-shared.js";
 export const OPERATION_ID_RE = /^sha256:[0-9a-f]{64}$/;
 export const CLAUDE_RESULT_MAX_BYTES = 4 * 1024 * 1024;
 export const CLAUDE_EFFORTS = new Set(["low", "medium", "high", "xhigh", "max"]);
@@ -72,6 +72,9 @@ export function createClaudeCorrelationSettings(name, launchId, model, effort) {
     writeJson0600(settings, {
         ...(model ? { model } : {}),
         ...(effort ? { effortLevel: effort } : {}),
+        // 席は必ず通常の速度で始める（ADR 0114）。--settingsは利用者の設定より強いので、共有の設定にfastModeが残っていても効かない。
+        // ここへtrueは入れない: 後で/fast offにしても、機種を替えた時にClaude Codeがこの値を見てfastへ戻す。
+        fastMode: false,
         hooks: {
             Stop: [
                 {
@@ -151,29 +154,70 @@ export async function claudeModelChoices(bin, cwd) {
     const dir = fs.mkdtempSync(path.join(os.tmpdir(), "aiterm-claude-models-"));
     try {
         const settings = path.join(dir, "settings.json");
-        fs.writeFileSync(settings, JSON.stringify({ disableAllHooks: true }), { mode: 0o600 });
-        const requestId = `aiterm-models-${randomUUID()}`;
-        const request = { type: "control_request", request_id: requestId, request: { subtype: "initialize" } };
-        const result = await runAgentProtocolCommand(bin, [
-            "-p", "--output-format", "stream-json", "--verbose", "--input-format", "stream-json",
-            "--no-session-persistence", "--strict-mcp-config", "--settings", settings,
-        ], {
-            cwd,
-            env: process.env,
-            input: JSON.stringify(request) + "\n",
-            until: requestId,
-            timeout: CLAUDE_MODELS_TIMEOUT_MS,
-            maxBuffer: CLAUDE_MODELS_MAX_BYTES,
-        });
-        if (result.error || result.status !== 0) {
-            throw catalogUnavailable("Claude Code", result.error?.message || result.stderr?.trim() || `exit=${result.status ?? "unknown"}`);
+        // fastMode: true を付けて聞くと、応答の fast_mode_disabled_reason が「このアカウントで使えない訳」になる
+        // （付けないと sdk_opt_in_required が返るだけ）。promptは送らないので、fastで流れる番は無い。
+        fs.writeFileSync(settings, JSON.stringify({ disableAllHooks: true, fastMode: true }), { mode: 0o600 });
+        // Claude Codeは、起きてすぐは「fastの可否を確かめている最中（pending）」と答える事がある（その端末で初めて聞いた時。Windowsで見た）。
+        // 少し置いて聞き直すと、アカウントの答え（使える、または使えない訳）が返る。
+        for (let attempt = 0;; attempt++) {
+            const requestId = `aiterm-models-${randomUUID()}`;
+            const request = { type: "control_request", request_id: requestId, request: { subtype: "initialize" } };
+            const result = await runAgentProtocolCommand(bin, [
+                "-p", "--output-format", "stream-json", "--verbose", "--input-format", "stream-json",
+                "--no-session-persistence", "--strict-mcp-config", "--settings", settings,
+            ], {
+                cwd,
+                env: process.env,
+                input: JSON.stringify(request) + "\n",
+                until: requestId,
+                timeout: CLAUDE_MODELS_TIMEOUT_MS,
+                maxBuffer: CLAUDE_MODELS_MAX_BYTES,
+            });
+            if (result.error || result.status !== 0) {
+                throw catalogUnavailable("Claude Code", result.error?.message || result.stderr?.trim() || `exit=${result.status ?? "unknown"}`);
+            }
+            if (attempt < CLAUDE_FAST_PENDING_RETRIES && claudeFastStatePending(result.stdout, requestId)) {
+                await new Promise((resolve) => setTimeout(resolve, CLAUDE_FAST_PENDING_WAIT_MS));
+                continue;
+            }
+            return claudeCatalogFromInitialize(result.stdout, requestId, processSummary(result));
         }
-        return claudeCatalogFromInitialize(result.stdout, requestId, processSummary(result));
     }
     finally {
         fs.rmSync(dir, { recursive: true, force: true });
     }
 }
+const CLAUDE_FAST_PENDING_RETRIES = 2;
+const CLAUDE_FAST_PENDING_WAIT_MS = 1_500;
+/** initializeの応答が、fastの可否を「確かめている最中」と答えているか。 */
+export function claudeFastStatePending(stdout, requestId) {
+    const response = findJsonLine(stdout, (value) => value?.type === "control_response" && value.response?.request_id === requestId);
+    return response?.response?.response?.fast_mode_disabled_reason === "pending";
+}
+// initializeの応答の fast_mode_disabled_reason と、Claude Codeが画面に出す文（2.1.296）。
+const CLAUDE_FAST_DISABLED_TEXT = {
+    extra_usage_disabled: "Fast mode requires usage credits",
+    free: "Fast mode requires a paid subscription",
+    preference: "Fast mode has been disabled by your organization",
+    network_error: "Fast mode unavailable due to network connectivity issues",
+    not_first_party: "Fast mode is only available when using the Anthropic API directly",
+    disabled_by_env: "Fast mode is not available",
+    model_not_allowed: "Opus is not in your organization's allowed models",
+    unknown: "Fast mode is currently unavailable",
+};
+/**
+ * initializeの応答の理由から、fastを使えない時の断りを作る。
+ * 使える時（理由なし）と、まだ分からない時（pending）・聞き方の都合（sdk_opt_in_required）はnull。
+ */
+export function claudeFastUnavailable(reason) {
+    if (typeof reason !== "string" || !reason || reason === "pending" || reason === "sdk_opt_in_required")
+        return null;
+    const text = CLAUDE_FAST_DISABLED_TEXT[reason];
+    return {
+        code: "FAST_MODE_UNAVAILABLE",
+        message: `FAST_MODE_UNAVAILABLE: Claude Codeが、このアカウントではファストを使えないと答えました（${reason}${text ? `: ${text}` : ""}）。`,
+    };
+}
 /** stream-jsonのcontrol_response（initialize）からmodel候補を作る。 */
 export function claudeCatalogFromInitialize(stdout, requestId, summary = "") {
     const response = findJsonLine(stdout, (value) => value?.type === "control_response" && value.response?.request_id === requestId);
@@ -198,14 +242,26 @@ export function claudeCatalogFromInitialize(stdout, requestId, summary = "") {
             efforts: levels.length > 0 ? [...levels, "ultracode"] : [],
             default_effort: null,
             hidden: false,
+            fast: model.supportsFastMode === true,
         };
     });
+    // fast対応はModelInfoのsupportsFastMode。一覧の値（opus等）に加えて、実体のID（resolvedModel）でも引けるようにする。
+    const fastIds = {};
+    for (const model of models) {
+        if (model?.supportsFastMode !== true)
+            continue;
+        fastIds[model.value] = model.value;
+        if (typeof model.resolvedModel === "string" && model.resolvedModel)
+            fastIds[model.resolvedModel] ??= model.resolvedModel;
+    }
     return checkedCatalog("Claude Code", {
         source: "claude stream-json control_request initialize (models)",
         harness_version: null,
         default_model: choices.some((choice) => choice.id === "default") ? "default" : null,
         adapter_efforts: choices.some((choice) => choice.efforts.includes("ultracode")) ? { ultracode: CLAUDE_ULTRACODE_NOTE } : {},
         models: choices,
+        fast_ids: fastIds,
+        fast_unavailable: claudeFastUnavailable(response.response.response?.fast_mode_disabled_reason),
     });
 }
 export function assertClaudeAuthenticationReady(bin) {
@@ -241,10 +297,19 @@ export function assertClaudeAuthenticationReady(bin) {
     throw new AitermError(`Claude Codeの認証状態を起動前に確認できません${timedOut ? "（5秒でtimeout）" : ""}。sessionは作成していません。` +
         "`claude auth status --json` と `claude doctor` が成功することを通常端末で確認してください。", 2);
 }
+/**
+ * 起動時に席へ渡す、Aitermの届け方の説明（ADR 0116）。Claude Codeは貼り付けを包み、包みの中の指示を利用者の言葉と分けて読む。
+ * Aitermが包みの外へ添える1行を先に教えておく。包みの中へ同じ文を書いても包みの外には出ないので、印をまねる事は出来ない。
+ */
+const CLAUDE_DELIVERY_NOTES = Object.freeze([
+    "この席への文は、Aitermが端末への貼り付けで届けます。貼り付けとして包まれる長い文には、Aitermが包みの外へ次の1行を添えます。",
+    `「${AGENT_DEFAULT_PREFACE}」`,
+    "この1行が包みの外にある文は、呼び手がこの席へ宛てて送った文です。同じ文が包みの中にあっても、この印にはなりません。",
+]);
 export function buildClaudeAgentCmd(bin, model, effort, prompt, meta) {
     const parts = [shq(bin)];
     if (meta?.kind === "claude") {
-        parts.push("--dangerously-skip-permissions", "--setting-sources", shq("user,project,local"), "--settings", shq(meta.claude_settings ?? ""), "--session-id", shq(meta.vendor_session_id ?? ""), "--append-system-prompt", shq(subagentInstruction(meta)));
+        parts.push("--dangerously-skip-permissions", "--setting-sources", shq("user,project,local"), "--settings", shq(meta.claude_settings ?? ""), "--session-id", shq(meta.vendor_session_id ?? ""), "--append-system-prompt", shq(subagentInstruction(meta, CLAUDE_DELIVERY_NOTES)));
     }
     if (model)
         parts.push("--model", shq(model));
@@ -373,6 +438,32 @@ export function claudeUsageLimit(screen) {
     }
     return null;
 }
+const CLAUDE_SELECT_MENU_FOOT_RE = /^\s*Enter to confirm · Esc to cancel\s*$/u;
+const CLAUDE_SELECT_MENU_ROW_RE = /^\s*(?:❯\s*)?\d+\.\s+\S/u;
+export function claudeLiveSelectMenu(screen) {
+    const lines = screen.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, "").split(/\r?\n/u);
+    let foot = lines.length - 1;
+    while (foot >= 0 && lines[foot].trim() === "")
+        foot--;
+    if (foot < 0 || !CLAUDE_SELECT_MENU_FOOT_RE.test(lines[foot]))
+        return null;
+    // 案内から上へ、選ぶ行と空行を飛ばした最初の行が見出し。選ぶ行が1つも無い物は選ぶ画面と数えない。
+    let rows = 0;
+    let head = foot - 1;
+    for (; head >= 0; head--) {
+        if (lines[head].trim() === "")
+            continue;
+        if (!CLAUDE_SELECT_MENU_ROW_RE.test(lines[head]))
+            break;
+        rows++;
+    }
+    if (rows === 0)
+        return null;
+    const heading = head >= 0 ? lines[head].trim() : null;
+    const rateLimit = heading === "What do you want to do?"
+        && lines.slice(head + 1, foot).some((line) => /\bStop and wait for limit to reset\b/u.test(line));
+    return { kind: rateLimit ? "rate_limit_options" : "unknown", heading };
+}
 function lastLineIndex(lines, re) {
     for (let i = lines.length - 1; i >= 0; i--)
         if (re.test(lines[i]))
@@ -615,3 +706,30 @@ export function claudeAuthPane(screen, onboarding = false) {
         message: complete ? null : input ? "Claude Codeの公式画面で入力または初回案内の選択を完了してください。" : null,
         onboarding_complete: complete };
 }
+/** `/fast on|off` を送る前の画面と後の画面から、増えた結果の行を読む。まだ出ていなければnull。 */
+export function claudeFastResult(before, after) {
+    const count = (screen, test) => screen.split("\n").filter((line) => test.test(line)).length;
+    const kinds = [
+        ["unavailable", /Fast mode unavailable:|Fast mode is (?:not available|only available|currently unavailable)|Fast mode requires/],
+        ["unchanged", /Fast mode (?:was not |unchanged)|fast mode may still have been/],
+        ["on", /Fast mode ON/],
+        ["off", /Fast mode OFF/],
+    ];
+    for (const [state, test] of kinds) {
+        if (count(after, test) <= count(before, test))
+            continue;
+        const lines = after.split("\n");
+        let index = lines.length - 1;
+        while (index > 0 && !test.test(lines[index]))
+            index--;
+        // 使えない訳は次の行へ折り返す事がある（「… /usage-credits to」「turn them on」）。続きの行を1つだけ足す。
+        const next = lines[index + 1]?.trim() ?? "";
+        const tail = state === "unavailable" && next && !/^[❯>─╭╰│]/u.test(next) ? ` ${next}` : "";
+        return { state, line: `${lines[index].replace(/^\s*⎿\s*/u, "").trim()}${tail}` };
+    }
+    return null;
+}
+/** 入力欄の近くに、ファストが入っている印（↯）が出ているか。 */
+export function claudeFastIndicatorShown(screen) {
+    return screen.split("\n").slice(-8).some((line) => line.includes("\u21AF"));
+}

package/dist/harnesses/codex.js

@@ -21,7 +21,7 @@ export function readCodexConfigPins(configPath) {
         body = fs.readFileSync(configPath, "utf8");
     }
     catch {
-        return { model: { present: false, value: null }, effort: { present: false, value: null } };
+        return { model: { present: false, value: null }, effort: { present: false, value: null }, service_tier: { present: false, value: null } };
     }
     const rows = body.split(/\r?\n/);
     let firstTable = rows.findIndex((l) => /^\s*\[/.test(l));
@@ -37,7 +37,7 @@ export function readCodexConfigPins(configPath) {
         }
         return { present: false, value: null };
     };
-    return { model: pick("model"), effort: pick("model_reasoning_effort") };
+    return { model: pick("model"), effort: pick("model_reasoning_effort"), service_tier: pick("service_tier") };
 }
 export function codexConfigSummary(configPath) {
     let body;
@@ -596,6 +596,10 @@ export function buildCodexAgentCmd(bin, model, effort, prompt, meta) {
         parts.push("--sandbox", "read-only");
     if (meta?.kind === "codex")
         parts.push("-c", "check_for_update_on_startup=false");
+    // 席は必ず通常の速度で始める（ADR 0114）。何も渡さないと、利用者のconfigの値や、modelの既定の段（Fastのmodelがある）で流れる。
+    // ここへfastは渡さない: 後で/fastで戻しても、番ごとの補助の問い合わせが起動時の値のまま残る（0.162.1で確かめた）。
+    if (meta?.kind === "codex")
+        parts.push("-c", "service_tier=default");
     // model/effort は共有configを書き換えず、CLI引数で明示して起動単位に優先する。
     if (model)
         parts.push("-m", shq(model));
@@ -828,7 +832,8 @@ export function codexLaunchBlockingDialog(screen) {
 export 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)
+        // 選ぶ画面は表示名（GPT-6.1-Sol）で並ぶ。一覧のID（gpt-6.1-sol）とは大文字と小文字だけが違う（0.162.1）。
+        if (match?.[2].toLowerCase() === model.toLowerCase())
             return match[1];
     }
     return null;
@@ -1007,6 +1012,11 @@ export async function codexModelChoices(bin, includeHidden) {
     }
     return codexCatalogFromPages(pages);
 }
+/** CodexのTUIの `/fast` と同じ見方: modelの速度の段（serviceTiers）に、名前が Fast の段がある。 */
+function codexModelHasFastTier(model) {
+    return Array.isArray(model?.serviceTiers)
+        && model.serviceTiers.some((tier) => typeof tier?.name === "string" && tier.name.toLowerCase() === "fast");
+}
 /** `model/list` の応答（全ページ）からmodel候補を作る。 */
 export function codexCatalogFromPages(pages) {
     let defaultModel = null;
@@ -1031,6 +1041,7 @@ export function codexCatalogFromPages(pages) {
                 efforts,
                 default_effort: typeof model.defaultReasoningEffort === "string" ? model.defaultReasoningEffort : null,
                 hidden: model.hidden === true,
+                fast: codexModelHasFastTier(model),
             };
         });
     });
@@ -1040,6 +1051,7 @@ export function codexCatalogFromPages(pages) {
         default_model: defaultModel,
         adapter_efforts: {},
         models,
+        fast_ids: Object.fromEntries(models.filter((model) => model.fast).map((model) => [model.id, model.id])),
     });
 }
 export function codexAuthPlan() { return { args: ["login", "--device-auth"], env: [] }; }
@@ -1082,3 +1094,83 @@ export function codexAuthPane(screen) {
     return { url: authUrl(screen, ["auth.openai.com", "auth0.openai.com", "login.openai.com"]),
         user_code: authUserCode(screen), input_required: false, message: null };
 }
+// ---- ファスト（速度の段）。CodexのTUIの `/fast` は入り切りの交互で、切り替えた後に「Service tier set to …」を1行出す。
+// 足元にも /status にも今の段は出ない（0.162.1）。
+/** 画面にある「Service tier set to …」の行を、上から順に。priority は fast、default は通常の速度。 */
+export function codexServiceTierNotices(screen) {
+    return screen.split("\n").flatMap((line) => {
+        const match = line.match(/^\s*[•◦]?\s*Service tier (?:set to (\S+)|cleared)\s*$/);
+        if (!match)
+            return [];
+        return [match[1] === "priority" || match[1] === "fast" ? "fast" : "standard"];
+    });
+}
+/**
+ * 足元のmodelの表示（「GPT-5.6-Sol xhigh fast · ~/proj」）に fast と出ているか。出ていればtrue。
+ * 出ていない時はnull: 通常の速度か、足元に段を出さない構成（独自のprovider等）かを、画面からは区別できない。
+ */
+export function codexFooterShowsFast(screen) {
+    return screen.split("\n").slice(-6).some((line) => /^\s*\S+\s+(?:default|none|minimal|low|medium|high|xhigh|max|ultra)\s+fast\s+·\s/.test(line)) ? true : null;
+}
+/** 入力欄へ `/fast` と打った時に、命令の候補として `/fast` が出ているか（出ていない時にEnterを押すと、文として送られる）。 */
+export function codexFastCommandOffered(screen) {
+    return screen.split("\n").slice(-14).some((line) => /^\s*›?\s*\/fast\s{2,}\S/.test(line));
+}
+/**
+ * 利用者のconfig.tomlの最上位の項目を、公式の口（App Serverの config/batchWrite）で元の値へ戻す。
+ * `/fast` は service_tier を、`/model` の選択は model と model_reasoning_effort を、利用者の既定として保存する。
+ * 戻しても、切り替えた席の中の値は保たれる（0.162.1で確かめた）。
+ */
+export async function restoreCodexDefaults(bin, codexHome, before) {
+    // 読めない書き方の値（表や複数行）は、元の値が分からないので触らない。
+    const edits = Object.entries(before).filter(([, pin]) => pin && !(pin.present && pin.value === null))
+        .map(([keyPath, pin]) => ({ keyPath, value: pin.present ? pin.value : null, mergeStrategy: "replace" }));
+    if (edits.length === 0)
+        return;
+    const parent = { thread_id: "00000000-0000-4000-8000-000000000000", codex_home: path.resolve(codexHome) };
+    await steer.withCodexReceiver(AITERM_PROFILE, parent, async (request) => {
+        await request("config/batchWrite", { edits });
+    }, { executable: bin, timeout_ms: CODEX_MODELS_TIMEOUT_MS });
+}
+/** 公式の口で戻せなかった時のための戻し。config.tomlの最上位の、その項目の1行だけを、元の値へ直す。 */
+export function restoreCodexDefaultInFile(configPath, key, before) {
+    if (before.present && before.value === null)
+        return;
+    let body;
+    try {
+        body = fs.readFileSync(configPath, "utf8");
+    }
+    catch {
+        return;
+    }
+    const eol = body.includes("\r\n") ? "\r\n" : "\n";
+    const rows = body.split(/\r?\n/);
+    let firstTable = rows.findIndex((row) => /^\s*\[/.test(row));
+    if (firstTable === -1)
+        firstTable = rows.length;
+    const line = rows.slice(0, firstTable).findIndex((row) => new RegExp(`^\\s*${key}\\s*=`).test(row));
+    const wanted = before.present ? `${key} = ${JSON.stringify(before.value)}` : null;
+    if (line === -1 && wanted === null)
+        return;
+    if (line !== -1 && wanted !== null && rows[line].trim() === wanted)
+        return;
+    if (line === -1)
+        rows.splice(firstTable, 0, wanted);
+    else if (wanted === null)
+        rows.splice(line, 1);
+    else
+        rows[line] = wanted;
+    const temp = `${configPath}.aiterm-restore-${process.pid}`;
+    fs.writeFileSync(temp, rows.join(eol), { mode: fs.statSync(configPath).mode & 0o777 });
+    try {
+        fs.renameSync(temp, configPath);
+    }
+    catch (error) {
+        // Windowsでは、ほかのprocessがfileを開いている間、置き換えに失敗する事がある。途中のfileを残さず、呼び手に次の回で試させる。
+        try {
+            fs.unlinkSync(temp);
+        }
+        catch { /* 残っても中身は前の値 */ }
+        throw error;
+    }
+}

package/dist/harnesses/cursor.js

@@ -8,6 +8,7 @@ import { randomBytes } from "node:crypto";
 import { AitermError } from "../errors.js";
 import { spawnAgentControlCommand } from "../agent-resolver.js";
 import { checkedCatalog } from "../model-catalog.js";
+import { FastModeError } from "../fast-mode.js";
 import { AGENT_DONE_POLL_MS, CURSOR_SCREEN_POLL_MS, pollGate, AGENT_EVENT_MAX_BYTES, agentEventPath, agentHarness, agentLineageFields, agentMetadataPath, createEmpty0600, readFileRange, safeStatSize, shq, sleep, subagentInstruction, writeAgentMetadata, writeScopeLaunchNote, } from "../agent-shared.js";
 const CURSOR_TRANSCRIPT_MATCH_MAX_BYTES = 1024 * 1024;
 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;
@@ -350,10 +351,15 @@ export function validateCursorModelEffort(model, effort) {
         throw new AitermError("Cursor CLIのmodelへ既にparameter overrideがあります。reasoning_effortとの二重指定はできません", 2);
     }
 }
-export function cursorModelArgument(model, effort) {
+export function cursorModelArgument(model, effort, fast = false) {
     if (!model)
         return null;
-    return effort ? `${model}-${effort}` : model;
+    // fastは完成形のIDの末尾（`<model>[-<effort>]-fast`）。そのIDが一覧にあるかは assertCursorModelAvailable が見る。
+    return `${model}${effort ? `-${effort}` : ""}${fast ? "-fast" : ""}`;
+}
+/** modelへ直に書かれたIDが、fast版の完成形か（`composer-2.5-fast`、`gpt-5.3-codex-low-fast`）。 */
+export function cursorModelIsFastVariant(model) {
+    return !!model && model.endsWith("-fast");
 }
 const CURSOR_AUTH_TIMEOUT_MS = 5_000;
 const CURSOR_MODELS_TIMEOUT_MS = 5_000;
@@ -426,11 +432,15 @@ export function cursorModelChoices(bin, cwd) {
 export function cursorCatalogFromLines(lines) {
     const choices = new Map();
     let defaultModel = null;
+    // fast: true で起こす時に渡すID。鍵は `${model}` と `${model}-${effort}`、値は一覧にある `-fast` 付きの完成形。
+    const fastIds = {};
     for (const line of lines) {
         const parsed = cursorBaseModel(line.id);
         if (!parsed)
             continue;
         const choice = choices.get(parsed.base) ?? { efforts: new Set(), label: null };
+        if (parsed.fast)
+            fastIds[parsed.effort ? `${parsed.base}-${parsed.effort}` : parsed.base] = line.id;
         // -fast版だけにあるeffortは `${model}-${effort}` の連結で作れないので数えない。
         if (parsed.effort && !parsed.fast)
             choice.efforts.add(parsed.effort);
@@ -452,13 +462,19 @@ export function cursorCatalogFromLines(lines) {
             efforts: CURSOR_SELECTABLE_EFFORTS.filter((effort) => choice.efforts.has(effort)),
             default_effort: null,
             hidden: false,
+            // そのmodelのどれかの組（effortなし、またはeffort付き）にfast版がある。組ごとの有無は起動時に一覧で確かめる。
+            fast: Object.keys(fastIds).some((key) => key === id || key.startsWith(`${id}-`)),
         })),
+        fast_ids: fastIds,
     });
 }
-export function assertCursorModelAvailable(bin, cwd, model, effort) {
-    const effective = cursorModelArgument(model, effort);
+export function assertCursorModelAvailable(bin, cwd, model, effort, fast = false) {
+    const effective = cursorModelArgument(model, effort, fast);
     const models = cursorModelCatalog(bin, cwd);
-    const available = effort ? models.includes(effective) : models.includes(model) || models.some((id) => id.startsWith(`${model}-`));
+    if (fast && !models.includes(effective)) {
+        throw new FastModeError("FAST_MODE_NOT_SUPPORTED", `Cursor の一覧に ${JSON.stringify(effective)} がありません（model=${model}${effort ? `、reasoning_effort=${effort}` : ""} のfast版）。起動していません。`);
+    }
+    const available = effort || fast ? models.includes(effective) : models.includes(model) || models.some((id) => id.startsWith(`${model}-`));
     if (!available) {
         throw new AitermError(`Cursor model catalog に ${JSON.stringify(effective)} がありません。` +
             "modelとreasoning_effortから作る正規IDが存在しないため、別modelへfallbackせず中止しました", 2);
@@ -468,7 +484,7 @@ export function cursorEffortNavigation(screen, effort) {
     const label = CURSOR_EFFORT_LABELS[effort.toLowerCase()];
     if (!label)
         throw new AitermError(`Cursorのreasoning_effort ${JSON.stringify(effort)} は未対応です`, 2);
-    const choices = screen.split("\n").flatMap((line) => {
+    const choices = cursorParameterLines(screen).flatMap((line) => {
         const match = line.match(/^\s*(→\s*)?[●○◯]\s+(.+?)(?:\s+✓)?\s*$/);
         return match ? [{ selected: !!match[1], label: match[2] }] : [];
     });
@@ -496,10 +512,10 @@ export function assertCursorAuthenticationReady(bin) {
         "通常端末で `agent status` が成功することを確認してください。", 2);
 }
 /** 起動argv（先頭が実行ファイル）。paneのshellに合わせた引用は呼び出し側が行う。 */
-export function cursorAgentArgv(bin, model, effort, prompt, meta) {
+export function cursorAgentArgv(bin, model, effort, prompt, meta, fast = false) {
     validateCursorModelEffort(model, effort);
     const parts = [bin];
-    const modelArg = cursorModelArgument(model, effort);
+    const modelArg = cursorModelArgument(model, effort, fast);
     if (modelArg)
         parts.push("--model", modelArg);
     // managed agentは人の対話承認を待てない。Cursor公式の無人運転フラグで
@@ -511,9 +527,9 @@ export function cursorAgentArgv(bin, model, effort, prompt, meta) {
         parts.push(meta ? cursorPromptWithLineage(meta, prompt) : prompt);
     return parts;
 }
-export function buildCursorAgentCmd(bin, model, effort, prompt, meta) {
+export function buildCursorAgentCmd(bin, model, effort, prompt, meta, fast = false) {
     // 固定の語彙（--force、--mode ask等）は引用しない。実行ファイル、model、promptだけを引用する。
-    const argv = cursorAgentArgv(bin, model, effort, prompt, meta);
+    const argv = cursorAgentArgv(bin, model, effort, prompt, meta, fast);
     return argv.map((part, index) => index === 0 || argv[index - 1] === "--model" || (prompt !== null && index === argv.length - 1) ? shq(part) : part).join(" ");
 }
 /**
@@ -551,8 +567,11 @@ const CURSOR_START_PROMPT_MARKER_RE = /(?:^|\n)\s*(?:→|->)\s*Plan,\s*search,\s
 export function cursorTuiReady(screen) {
     if (CURSOR_FOLLOWUP_MARKER_RE.test(screen))
         return true;
-    return /Cursor Agent/i.test(screen) &&
-        (CURSOR_COMPOSER_MARKER_RE.test(screen) || CURSOR_START_PROMPT_MARKER_RE.test(screen));
+    // 入力欄の案内（Plan, search, build anything）はCursorの入力欄だけが出す文なので、見出し（Cursor Agent）が画面の外へ流れた後も
+    // 入力待ちと読む。まだ番を流していない席で `/model` の選ぶ画面を開いて閉じると、見出しは流れて戻らない（2026.10.01）。
+    if (CURSOR_START_PROMPT_MARKER_RE.test(screen))
+        return true;
+    return /Cursor Agent/i.test(screen) && CURSOR_COMPOSER_MARKER_RE.test(screen);
 }
 // 利用上限に達したCursorは、入力欄も戻さずに説明を出して止まる（2026.09.26-dd393fe、macOSで実測）。
 // transcriptには、user turnを残さずにturn_ended（status "error"）だけを書く事がある（実記録で8件）。その時は完了の条件
@@ -642,3 +661,68 @@ export function cursorAuthPane(screen) {
     return { url: authUrl(screen, ["cursor.com", "www.cursor.com", "auth.cursor.com"]),
         user_code: null, input_required: false, message: null };
 }
+/**
+ * `/model` の画面の今の姿を、画面の最後の行（操作の案内）で読む。list は選ぶ画面、parameters はパラメータの画面、null は閉じている。
+ * Cursorは選ぶ画面を閉じても前の行を消さないので（上に残る）、文字の有無では今の姿が分からない。
+ */
+export function cursorPickerView(screen) {
+    const last = screen.split("\n").map((line) => line.trim()).filter(Boolean).at(-1) ?? "";
+    if (/Enter to select\s*•\s*Esc to go back/.test(last))
+        return "parameters";
+    if (/Enter to select\s*•\s*Tab to edit/.test(last))
+        return "list";
+    return null;
+}
+/** 今開いているパラメータの画面の行（最後の「Edit Parameters」の見出しより後）。見出しが無ければ画面の全部。 */
+function cursorParameterLines(screen) {
+    const lines = screen.split("\n");
+    let title = lines.length - 1;
+    while (title >= 0 && !lines[title].includes("Edit Parameters"))
+        title--;
+    return lines.slice(title + 1);
+}
+/** 今開いているパラメータの画面の選べる行。cursor は選択中（→）の行、label は印と✓を除いた名前（Low・High・Fast 等）。 */
+export function cursorParameterRows(screen) {
+    return cursorParameterLines(screen).flatMap((line) => {
+        const match = line.trim().match(/^(→\s*)?[●○◯◉]\s+(.+?)(?:\s+✓)?\s*$/u);
+        return match ? [{ label: match[2], cursor: !!match[1] }] : [];
+    });
+}
+/** 今開いているパラメータの画面で、そのeffortの行に選択済みの印（✓）が付いているか。 */
+export function cursorEffortSelected(screen, label) {
+    return cursorParameterLines(screen).some((line) => new RegExp(`[●○◯]\\s+${label.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\s+✓\\s*$`).test(line));
+}
+// ---- ファスト。Cursorは `/model` のパラメータの画面（Edit Parameters）に「Fast」の行がある（2026.10.01）。
+//   入っていない: 「◯ Fast」 / 入っている: 「◉ Fast」。行が無いmodelはfastへ切り替えられない。
+/** パラメータの画面のFastの行。state は今の入り切り、down は選択中（→）の行からFastの行までの下矢印の数。 */
+export function cursorFastParameter(screen) {
+    if (!screen.includes("Edit Parameters"))
+        return null;
+    // 画面は行ごとに横へずれて描かれる事がある。行の中身だけを見る。
+    const rows = cursorParameterLines(screen).map((line) => line.trim()).filter((line) => /^(?:→\s*)?[●○◯◉]\s+\S/u.test(line));
+    const fast = rows.findIndex((line) => /^(?:→\s*)?[◯◉]\s+Fast\s*$/u.test(line));
+    const selected = rows.findIndex((line) => line.startsWith("→"));
+    if (fast < 0 || selected < 0)
+        return null;
+    return { state: rows[fast].includes("◉"), down: fast - selected };
+}
+/** 見出しのmodelの表示（「Codex 5.3 Low Fast」）が、ファストが入っている形か。 */
+export function cursorHeaderShowsFast(screen) {
+    // 見出しは「<modelの表示>   <権限の表示>」の1行。権限の表示は Run Everything／Ask 等（画面の幅で後ろが切れる事がある）。
+    const header = screen.split("\n").map((line) => line.trim())
+        .filter((line) => /\S\s{2,}(?:Run|Auto-Run|Ask|Plan|Manual)\b/.test(line)).at(-1);
+    if (!header)
+        return null;
+    return /\bFast\s{2,}/.test(header);
+}
+/**
+ * Cursorが、起動の --model と `/model` の選択のたびに、利用者の ~/.cursor/cli-config.json へ書く項目（次の会話の既定のmodelとパラメータ）。
+ * 書く版と書かない版がある（2026.10.01-14929f9は書く。fastを入れた選択なら `selectedModel.parameters` に fast: true が残る）。
+ * 席だけの切り替えにするため、切り替えの直前の値へ戻す。
+ */
+export const CURSOR_DEFAULT_MODEL_KEYS = [
+    "model", "hasChangedDefaultModel", "modelParameters", "selectedModel", "modelSelectionHistory", "maxMode",
+];
+export function cursorUserConfigPath(cursorHome) {
+    return path.join(cursorHome, "cli-config.json");
+}