aiterm-mcp 0.58.4 → 0.59.1

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

@@ -11,7 +11,7 @@ import { spawnAgentControlCommand } from "../agent-resolver.js";
 import * as steer from "aiterm-steer-delivery";
 import { AITERM_PROFILE } from "../steer-profile.js";
 import { catalogInvalid, catalogUnavailable, checkedCatalog } from "../model-catalog.js";
-import { shq, subagentInstruction, writeScopeLaunchNote, safeStatSize, readFileRange, sleep, agentMetadataPath, writeAgentMetadata, agentEventPath, createEmpty0600, agentLineageFields, AGENT_DONE_POLL_MS, AGENT_EVENT_MAX_BYTES, AGENT_EVENT_TAIL_BYTES, AGENT_TURN_BOUNDARY_TAIL_BYTES, readTailLinesNewestFirst, CODEX_TRANSCRIPT_INCREMENT_MAX_BYTES, agentHarness, } from "../agent-shared.js";
+import { shq, subagentInstruction, writeScopeLaunchNote, safeStatSize, readFileRange, sleep, agentMetadataPath, writeAgentMetadata, agentEventPath, createEmpty0600, agentLineageFields, AGENT_DONE_POLL_MS, AGENT_EVENT_MAX_BYTES, AGENT_EVENT_TAIL_BYTES, AGENT_TURN_BOUNDARY_TAIL_BYTES, readTailLinesNewestFirst, scanLinesNewestFirst, CODEX_TRANSCRIPT_INCREMENT_MAX_BYTES, agentHarness, } from "../agent-shared.js";
 export function realCodexHome() {
     return process.env.CODEX_HOME || path.join(process.env.HOME ?? os.homedir(), ".codex");
 }
@@ -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;
@@ -383,12 +383,31 @@ export function codexUsageLimit(record) {
 }
 // 完了待ちが、会話の切り替えを確かめる間隔。送った文はすぐ記録へ書かれるので、普通のturnはここへ来ない。
 const CODEX_SWITCH_CHECK_MS = 3_000;
+/** 1行がturnの境界ならその境界、境界でなければundefined、境界の語を含むのに読めない行ならnull。 */
+function codexTurnBoundaryLine(line) {
+    if (!line.includes("task_started") && !line.includes("task_complete") && !line.includes("turn_aborted"))
+        return undefined;
+    let record;
+    try {
+        record = JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+    if (record?.type !== "event_msg")
+        return undefined;
+    const type = record?.payload?.type;
+    return type === "task_started" || type === "task_complete" || type === "turn_aborted"
+        ? { type, turn_id: record.payload.turn_id, reason: record.payload.reason } : undefined;
+}
 /**
  * この起動のroot rolloutの、末尾から見て最初のturnの境界。
  * Codexはturnの開始でtask_started、終わりでtask_complete、止めた時はturn_aborted（reasonはinterrupted）を書く（0.160.1の実記録）。
  * rolloutが無い、この起動に結び付かない、書いている途中、境界が読む範囲に無い時はnull。
+ * 読む範囲は、`reach`が"tail"なら末尾の1MiB（終わった番の境界は末尾の近くにある。見回りで何度も呼ぶ所はこちら）、
+ * "whole"なら境界に当たるまで先頭へさかのぼる（動いている番の開始は、番が長いと末尾の1MiBより前にある）。
  */
-function codexLatestTurnBoundary(meta) {
+function codexLatestTurnBoundary(meta, reach) {
     let transcript;
     try {
         transcript = codexRootTranscript(meta);
@@ -398,24 +417,15 @@ function codexLatestTurnBoundary(meta) {
     }
     if (!transcript)
         return null;
+    if (reach === "whole")
+        return scanLinesNewestFirst(transcript, codexTurnBoundaryLine, AGENT_TURN_BOUNDARY_TAIL_BYTES) ?? null;
     const lines = readTailLinesNewestFirst(transcript, AGENT_TURN_BOUNDARY_TAIL_BYTES);
     if (!lines)
         return null;
     for (const line of lines) {
-        if (!line.includes("task_started") && !line.includes("task_complete") && !line.includes("turn_aborted"))
-            continue;
-        let record;
-        try {
-            record = JSON.parse(line);
-        }
-        catch {
-            return null;
-        }
-        if (record?.type !== "event_msg")
-            continue;
-        const type = record?.payload?.type;
-        if (type === "task_started" || type === "task_complete" || type === "turn_aborted")
-            return { type, turn_id: record.payload.turn_id, reason: record.payload.reason };
+        const boundary = codexTurnBoundaryLine(line);
+        if (boundary !== undefined)
+            return boundary;
     }
     return null;
 }
@@ -425,7 +435,7 @@ function codexLatestTurnBoundary(meta) {
  * rolloutが無い、この起動に結び付かない、書いている途中、境界が読む範囲に無い時はfalse（分からない時は「終わった」と数えない）。
  */
 export function codexTurnSettled(meta) {
-    const boundary = codexLatestTurnBoundary(meta);
+    const boundary = codexLatestTurnBoundary(meta, "tail");
     if (boundary?.type === "task_complete")
         return typeof boundary.turn_id === "string" && boundary.turn_id !== "";
     // 見たのはEscで止めた時の形だけ。他の理由（別のturnへの置き換え等）は、次のturnが続くかも知れないので数えない。
@@ -433,11 +443,13 @@ export function codexTurnSettled(meta) {
 }
 /**
  * この起動のroot rolloutの上で動いているturnのID。末尾から見て最初の境界がtask_startedの時だけ返す。
- * rolloutが無い、この起動に結び付かない、書いている途中、境界が読む範囲に無い時はnull（分からない時は「動いている」と数えない）。
+ * rolloutが無い、この起動に結び付かない、書いている途中、境界が1つも無い時はnull（分からない時は「動いている」と数えない）。
+ * 開始の印は、境界に当たるまで記録をさかのぼって探す。末尾の1MiBだけを読むと、長い番（開始から1MiBより多く書いた番）を
+ * 動いていると読めず、回答を流している間に届いた文が、新しいturnの道で入力待ちを30秒待って断られる（実被弾 2026-10-13）。
  * Codexは、processが生きている間、turnの終わりを必ず書く。書かずに終わるのは落ちた時なので、呼ぶ側はprocessの生死も見る。
  */
 export function codexRunningTurn(meta) {
-    const boundary = codexLatestTurnBoundary(meta);
+    const boundary = codexLatestTurnBoundary(meta, "whole");
     return boundary?.type === "task_started" && typeof boundary.turn_id === "string" && boundary.turn_id !== "" ? boundary.turn_id : null;
 }
 export function latestCodexCompletion(meta, readTranscriptLines) {
@@ -596,6 +608,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 +844,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 +1024,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 +1053,7 @@ export function codexCatalogFromPages(pages) {
                 efforts,
                 default_effort: typeof model.defaultReasoningEffort === "string" ? model.defaultReasoningEffort : null,
                 hidden: model.hidden === true,
+                fast: codexModelHasFastTier(model),
             };
         });
     });
@@ -1040,6 +1063,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 +1106,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;
+    }
+}