aiterm-mcp 0.58.4 → 0.59.0

package/dist/core.js

@@ -17,14 +17,18 @@ import { isCursorMcpClient } from "aiterm-steer-delivery";
 import { paneTokenHint } from "./harnesses/pane-tokens.js";
 import { unfinishedDeliveriesOwnedBy } from "./parent-delivery-owners.js";
 import { readRuntimeProcesses, processSubtree, parentProcess, processIdentity, backgroundProcesses, lazyRelayProcess, aitermProcessProbe, windowsConsoleHost, processElapsedSeconds } from "./process-runtime.js";
+import { liveNodeExecutable } from "./live-node.js";
 import { AitermError, telemetryOwnedFailure, ownTelemetryFailure } from "./errors.js";
 import { isWin, SOCKDIR, tmuxCommand, sendPsmuxPayload, loadPtyBufferChunk, pasteBufferBaseArgs, tmuxNewSession, openPsmuxServerToDesktop, registeredSessionEnvironment, attachCommand, normalizePaneCommand, atomicShellMultiline, appendMarkSentinel, markShellCommand, settlePaneLog, paneCwdArgument, sessionEnvironmentLaunch, } from "./tmux-runtime.js";
-import { sleep, currentUid, runtimeStateBase, safeStatSize, readFileRange, writeJson0600, createEmpty0600, shq, LAUNCH_ID_RE, AGENT_DONE_POLL_MS, AGENT_RATE_LIMIT_POLL_MS, pollGate, AGENT_EVENT_MAX_BYTES, assertSessionName, agentsDir, agentEventPath, agentMetadataPath, writeAgentMetadata, AGENT_EVENT_TAIL_BYTES, agentLabel, agentHarness, subagentInstruction, agentLineageFields, } from "./agent-shared.js";
+import { AGENT_DEFAULT_PREFACE, sleep, currentUid, runtimeStateBase, safeStatSize, readFileRange, writeJson0600, createEmpty0600, shq, LAUNCH_ID_RE, AGENT_DONE_POLL_MS, AGENT_RATE_LIMIT_POLL_MS, pollGate, AGENT_EVENT_MAX_BYTES, assertSessionName, agentsDir, agentEventPath, agentMetadataPath, writeAgentMetadata, AGENT_EVENT_TAIL_BYTES, agentLabel, agentHarness, subagentInstruction, agentLineageFields, } from "./agent-shared.js";
 import { catalogUnavailable } from "./model-catalog.js";
-import { grokAuthPlan, grokAuthStatus, grokAuthPane, realGrokHome, resolveAndValidateGrokAuth, assertGrokModelAvailable, grokModelChoices, grokEventsTranscript, latestGrokCompletion, grokTurnSettled, observeGrokDone, buildGrokAgentCmd, grokLaunchNote, grokEnvTokens, grokTuiReady, grokTuiBusy, grokPaneObservation, grokRateLimitDialog, grokPromptAwaitingAccept, grokUnacceptedPromptRestored, grokStartupAction, grokLaunchBlockingDialog, assertGrokSandboxNotRejected, GROK_COMPOSER_MARKER_RE, grokFooterHasConfiguration, grokTranscriptText, createGrokAgentMetadata, } from "./harnesses/grok.js";
-import { codexAuthPlan, codexAuthStatus, codexAuthPane, bindCodexTranscriptSession, latestCodexCompletion, codexTurnSettled, codexRunningTurn, observeCodexDone, buildCodexAgentCmd, codexLaunchNote, codexTuiReady, codexPaneObservation, codexTuiBusy, codexHelperProcess, codexRateLimitModelSwitchDialog, codexApprovalDialog, codexStartupAction, CODEX_COMPOSER_MARKER_RE, codexModelChoice, codexEffortChoice, codexMoreReasoningChoice, codexTranscriptText, createCodexAgentMetadata, codexModelChoices, } from "./harnesses/codex.js";
-import { claudeAuthPlan, claudeAuthStatus, claudeAuthPane, OPERATION_ID_RE, CLAUDE_RESULT_MAX_BYTES, CLAUDE_EFFORTS, agentManagedClaudeSettingsPath, agentClaudeResultPath, agentClaudeOperationPath, agentClaudeApprovalReceiptPath, agentClaudeDispatchReceiptPath, validateOperationId, readClaudeResultText, assertClaudeAuthenticationReady, claudeModelChoices, buildClaudeAgentCmd, claudeLaunchNote, claudeTuiReady, claudePaneObservation, claudeUsageLimit, claudeModelPicker, claudeModelPickerRow, claudeModelSwitchConfirm, claudeModelSwitchResult, claudeStartupAction, claudeLoginMethodMenu, CLAUDE_COMPOSER_MARKER_RE, createClaudeAgentMetadata, claudeSessionTranscriptPath, claudeApiErrorFromLine, claudeApiErrorAfter, } from "./harnesses/claude.js";
-import { cursorAuthPlan, cursorAuthStatus, cursorAuthPane, bindCursorTranscriptSession, cursorTurnBoundary, latestCursorCompletion, observeCursorDone, cursorTranscriptText, assertCursorAuthenticationReady, assertCursorModelAvailable, cursorModelChoices, buildCursorAgentCmd, cursorAgentArgv, cursorPwshLaunchLine, cursorPromptWithLineage, createCursorAgentMetadata, cursorLaunchNote, cursorEffortNavigation, cursorTuiReady, cursorPaneObservation, cursorPromptHooksRunning, cursorUsageLimit, CURSOR_SUBMIT_SEQUENCE, CURSOR_COMPOSER_CONTENT_MARKER_RE, validateCursorModelEffort, } from "./harnesses/cursor.js";
+import { FastModeError, fastModeFailure } from "./fast-mode.js";
+import { readFileOrNull, restoreJsonSetting, withUserConfigLock } from "./user-config.js";
+import { isDeepStrictEqual } from "node:util";
+import { grokAuthPlan, grokAuthStatus, grokAuthPane, GROK_MODEL_DEFAULTS, realGrokHome, resolveAndValidateGrokAuth, assertGrokModelAvailable, grokModelChoices, grokModelFromFooter, grokFooterModelName, grokModelDefaultsFromBody, restoreGrokModelDefaults, grokEventsTranscript, latestGrokCompletion, grokTurnSettled, observeGrokDone, buildGrokAgentCmd, grokLaunchNote, grokEnvTokens, grokTuiReady, grokTuiBusy, grokPaneObservation, grokRateLimitDialog, grokPromptAwaitingAccept, grokUnacceptedPromptRestored, grokStartupAction, grokLaunchBlockingDialog, assertGrokSandboxNotRejected, GROK_COMPOSER_MARKER_RE, grokFooterHasConfiguration, grokTranscriptText, createGrokAgentMetadata, } from "./harnesses/grok.js";
+import { codexAuthPlan, codexAuthStatus, codexAuthPane, realCodexHome, readCodexConfigPins, bindCodexTranscriptSession, latestCodexCompletion, codexTurnSettled, codexRunningTurn, observeCodexDone, buildCodexAgentCmd, codexLaunchNote, codexTuiReady, codexPaneObservation, codexTuiBusy, codexHelperProcess, codexRateLimitModelSwitchDialog, codexApprovalDialog, codexStartupAction, CODEX_COMPOSER_MARKER_RE, codexModelChoice, codexEffortChoice, codexMoreReasoningChoice, codexTranscriptText, createCodexAgentMetadata, codexModelChoices, codexFastCommandOffered, codexFooterShowsFast, codexServiceTierNotices, restoreCodexDefaults, restoreCodexDefaultInFile, } from "./harnesses/codex.js";
+import { claudeAuthPlan, claudeAuthStatus, claudeAuthPane, OPERATION_ID_RE, CLAUDE_RESULT_MAX_BYTES, CLAUDE_EFFORTS, agentManagedClaudeSettingsPath, agentClaudeResultPath, agentClaudeOperationPath, agentClaudeApprovalReceiptPath, agentClaudeDispatchReceiptPath, validateOperationId, readClaudeResultText, assertClaudeAuthenticationReady, claudeModelChoices, claudeConfigDir, claudeFastIndicatorShown, claudeFastResult, buildClaudeAgentCmd, claudeLaunchNote, claudeTuiReady, claudePaneObservation, claudeUsageLimit, claudeLiveSelectMenu, claudeModelPicker, claudeModelPickerRow, claudeModelSwitchConfirm, claudeModelSwitchResult, claudeStartupAction, claudeLoginMethodMenu, CLAUDE_COMPOSER_MARKER_RE, createClaudeAgentMetadata, claudeSessionTranscriptPath, claudeApiErrorFromLine, claudeApiErrorAfter, } from "./harnesses/claude.js";
+import { cursorAuthPlan, cursorAuthStatus, cursorAuthPane, bindCursorTranscriptSession, cursorTurnBoundary, latestCursorCompletion, observeCursorDone, cursorTranscriptText, assertCursorAuthenticationReady, assertCursorModelAvailable, cursorModelChoices, cursorModelIsFastVariant, cursorFastParameter, cursorHeaderShowsFast, cursorPickerView, cursorEffortSelected, cursorParameterRows, cursorUserConfigPath, CURSOR_DEFAULT_MODEL_KEYS, realCursorHome, buildCursorAgentCmd, cursorAgentArgv, cursorPwshLaunchLine, cursorPromptWithLineage, createCursorAgentMetadata, cursorLaunchNote, cursorEffortNavigation, cursorTuiReady, cursorPaneObservation, cursorPromptHooksRunning, cursorUsageLimit, CURSOR_SUBMIT_SEQUENCE, CURSOR_COMPOSER_CONTENT_MARKER_RE, validateCursorModelEffort, } from "./harnesses/cursor.js";
 import { readInterimWords, recordInterimBoundary } from "./interim-words.js";
 import { resolveAgentBin, resolveThroughlineBin, runThroughlineHandoffContext, isWindowsNativeExecutable, agentBinForPaneShell, resolveWinPaneShell } from "./agent-resolver.js";
 export { AitermError } from "./errors.js";
@@ -786,13 +790,27 @@ export function assertAgentPreface(preface) {
     }
     return preface;
 }
+// Claude Codeが、貼り付けの印で入った文を`<pasted_content>`で包む境目。2.1.296の実物の席で測った:
+// 改行が3つ以上（4行以上）か、800字を超える文は包む。3行まで・800字以内は包まない。
+const CLAUDE_PASTE_WRAP_NEWLINES = 3;
+const CLAUDE_PASTE_WRAP_CHARS = 800;
+/** Claude Codeが、この文を貼り付けとして包むか。境目ちょうど（800字）は包む側に倒す（前置きが余分に付くだけで済む）。 */
+export function claudeWrapsPaste(text) {
+    return text.length >= CLAUDE_PASTE_WRAP_CHARS || (text.match(/\n/gu)?.length ?? 0) >= CLAUDE_PASTE_WRAP_NEWLINES;
+}
+export { AGENT_DEFAULT_PREFACE };
 /**
  * 前置きつきの送信文を、harnessごとの形へ分ける。Claude Codeは前置きを印なしで入れ、空行と本文を貼る。
  * Codex・Grok・Cursorは貼り付けを包まないので、前置き・空行・本文を1つにつないで貼る（渡る文は前置きなしの時と同じ並び）。
+ * `preface`が無い時、Claude Codeが包む長さの文には、Aitermの既定の1行を前置きにする（`defaultForWrapped`がtrueの時だけ）。
  */
-function splitAgentPreface(kind, preface, text) {
-    if (preface == null)
+function splitAgentPreface(kind, preface, text, o = {}) {
+    if (preface == null) {
+        if (o.defaultForWrapped && kind === "claude" && claudeWrapsPaste(text)) {
+            return { typedPreface: AGENT_DEFAULT_PREFACE, body: `\n\n${text}` };
+        }
         return { body: text };
+    }
     assertAgentPreface(preface);
     return kind === "claude" ? { typedPreface: preface, body: `\n\n${text}` } : { body: `${preface}\n\n${text}` };
 }
@@ -2413,6 +2431,11 @@ function loadAgentMetadata(name) {
         initial_prompt_delivery: m.initial_prompt_delivery, initial_prompt_cursor: m.initial_prompt_cursor,
     };
     const executableFields = m.agent_executable === undefined ? {} : { agent_executable: m.agent_executable };
+    // 席のファストの状態と、起動・設定替えで渡したmodel（ADR 0114）。この項目より前の版が書いた控えには無い。
+    const fastFields = {
+        ...(typeof m.fast === "boolean" ? { fast: m.fast } : {}),
+        ...(typeof m.model === "string" || m.model === null ? { model: m.model } : {}),
+    };
     const startupShapes = Array.isArray(m.startup_process_shapes) && m.startup_process_shapes.every((shape) => shape && typeof shape.identity === "string" && (shape.parent === null || typeof shape.parent === "string") && typeof shape.argv_digest === "string")
         ? { startup_process_shapes: m.startup_process_shapes } : {};
     const startupFields = Array.isArray(m.startup_processes) && m.startup_processes.every((identity) => typeof identity === "string")
@@ -2444,6 +2467,7 @@ function loadAgentMetadata(name) {
             initial_prompt: normalizeInitialPromptState(m.initial_prompt),
             ...deliveryFields,
             ...executableFields,
+            ...fastFields,
             ...startupFields,
             launch_operation_id: launchOperationId,
             launch_request_digest: launchRequestDigest,
@@ -2476,6 +2500,7 @@ function loadAgentMetadata(name) {
             initial_prompt: normalizeInitialPromptState(m.initial_prompt),
             ...deliveryFields,
             ...executableFields,
+            ...fastFields,
             ...startupFields,
             hook_route: "shared_codex_home",
             completion_route: "codex_transcript",
@@ -2504,6 +2529,7 @@ function loadAgentMetadata(name) {
             initial_prompt: normalizeInitialPromptState(m.initial_prompt),
             ...deliveryFields,
             ...executableFields,
+            ...fastFields,
             ...startupFields,
             hook_route: "shared_cursor_home",
             completion_route: "cursor_transcript",
@@ -2540,6 +2566,7 @@ function loadAgentMetadata(name) {
         initial_prompt: normalizeInitialPromptState(m.initial_prompt),
         ...deliveryFields,
         ...executableFields,
+        ...fastFields,
         ...startupFields,
         hook_route: "shared_grok_home",
         completion_route: "grok_transcript",
@@ -3027,7 +3054,7 @@ export function windowsStartProcessArgumentList(args) {
 // npmのplatform別bin shimをcallerに解釈させず、現在稼働中のNodeと同梱CLIを直接起動する。
 // Windowsでもbackendはpsmux、対話shellはPowerShell 7のまま。これはwaiter processの入口だけを所有する。
 export function agentWaitProcess(session, cursor, runtime = {}) {
-    const executable = runtime.executable ?? process.execPath;
+    const executable = runtime.executable ?? liveNodeExecutable();
     const args = [
         runtime.cliPath ?? fileURLToPath(new URL("./aiterm-wait-cli.js", import.meta.url)),
         "--session",
@@ -3618,7 +3645,9 @@ export function __testSetAgentTuiReadyStableSamples(value) {
     agentTuiReadyStableSamplesTestOverride = value;
 }
 async function sendAgentPromptText(name, text, kind) {
-    send(name, text, {
+    // 起動時の文にも、包みになる長さなら出所の1行を包みの外へ出す（ADR 0116）。
+    const prefaced = kind === undefined ? { body: text } : splitAgentPreface(kind, null, text, { defaultForWrapped: true });
+    send(name, prefaced.body, {
         enter: false,
         force: true,
         raw: false,
@@ -3626,6 +3655,7 @@ async function sendAgentPromptText(name, text, kind) {
         rtk: false,
         preserveAgentOperation: true,
         bracketedPaste: true,
+        typedPreface: prefaced.typedPreface,
     });
     if (kind === "cursor") {
         const visible = await waitCursorPromptVisible(name, text);
@@ -3738,6 +3768,7 @@ async function sendInitialAgentPromptInLock(name, text, o) {
             `agent session '${name}' の起動準備が完了していないため、promptは送信していません。reason=${startup.reason}` +
             startupBlockedHint(startup.reason), 2);
     }
+    await o.after_ready?.(name, meta);
     const promptText = meta.kind === "cursor" ? cursorPromptWithLineage(meta, text) : text;
     const startOffset = agentCompletionCursor(meta);
     try {
@@ -4280,16 +4311,550 @@ async function configureClaudeForSessionOnly(name, meta, model, effort) {
     if (!ready.ready)
         throw new AitermError("Claudeのmodel変更完了を確認できません", 2);
 }
+// ===================== ファスト（高速の応答）の切り替え（ADR 0114） =====================
+// 席は必ず通常の速度で起こす。fast: true は、通常で起こしてから、その席で切り替える（Claude Code・Codex）。
+// CursorとGrokはfastが別のmodel IDなので、起動時のIDをfast版にする。
+// harnessの切り替えの命令は利用者の既定も書き換えるので（Cursorを除く）、切り替えの直前の値へ戻す。
+// 読む→切り替える→戻すは、設定fileごとの鍵（withUserConfigLock）で、同じ端末の全てのAitermの間で1つずつにする。
+const CLAUDE_FAST_RESULT_TIMEOUT_MS = 20_000;
+const CODEX_FAST_OFFER_TIMEOUT_MS = 3_000;
+const CODEX_FAST_NOTICE_TIMEOUT_MS = 8_000;
+const CURSOR_FAST_ROW_TIMEOUT_MS = 3_000;
+// Grokは起動して1秒もせずに既定を書く（1.0.50の記録で、起動完了の直後）。書かない時（同じ値、古い版）に起動を長く待たせない。
+const LAUNCH_DEFAULT_WAIT_MS = 8_000;
+// 既定が必ず書かれる見込みの時に、書かれるのを待つ上限（Cursorは、遅い起動で入力待ちの数秒後に書く）。
+const LAUNCH_DEFAULT_MUST_WRITE_WAIT_MS = 25_000;
+const LAUNCH_ALIVE_CHECK_MS = 1_000;
+const GROK_FAST_CATALOG_RETRY_MS = 1_500;
+const GROK_MODEL_SWITCH_TIMEOUT_MS = 10_000;
+/**
+ * Grokの一覧（fast版の対を読むため）。Grokは、しばらく聞かれていないと最初の答えにfast版が入っていない事がある
+ * （Windowsの1.0.50で見た。直後の聞き直しには入っている）。そのmodelのfast版が見えない時は、少し置いて1度だけ聞き直す。
+ */
+async function grokCatalogForFast(bin, cwd, base) {
+    const first = await grokModelChoices(bin, cwd);
+    if (first.fast_ids?.[base])
+        return first;
+    await sleep(GROK_FAST_CATALOG_RETRY_MS);
+    return grokModelChoices(bin, cwd);
+}
+/** modelへ直に書かれたIDが、fast版のIDか（fastが別のmodel IDのharnessだけ）。 */
+function modelIsFastVariant(kind, model) {
+    if (!model)
+        return false;
+    if (kind === "cursor")
+        return cursorModelIsFastVariant(model);
+    // Grokのfast版は一覧の表示名で対にする（grokFastVariants）。起動の前は一覧を引かずに済むよう、IDの末尾で見る。
+    if (kind === "grok")
+        return /-fast$/.test(model);
+    return false;
+}
+function claudeUserSettingsPath() {
+    return path.join(claudeConfigDir(), "settings.json");
+}
+/** Claude Codeの席のmodelがfastへ切り替えられるかを、一覧で確かめる。使えない時は断る。 */
+async function assertClaudeFastSupported(bin, cwd, model, untouched) {
+    const catalog = await claudeModelChoices(bin, cwd);
+    const key = model ?? "default";
+    if (!catalog.fast_ids?.[key]) {
+        throw new FastModeError("FAST_MODE_NOT_SUPPORTED", `Claude Code の ${key} はfastに対応していません（対応: ${Object.keys(catalog.fast_ids ?? {}).join(", ") || "なし"}）。${untouched}`);
+    }
+    return catalog.fast_unavailable ?? null;
+}
+/** Codexの席のmodel（省略時は利用者のconfig、無ければ一覧の既定）がfastへ切り替えられるかを、一覧で確かめる。 */
+async function assertCodexFastSupported(bin, codexHome, model, untouched) {
+    const catalog = await codexModelChoices(bin, true);
+    const effective = model ?? readCodexConfigPins(path.join(codexHome, "config.toml")).model.value ?? catalog.default_model;
+    if (!effective || !catalog.fast_ids?.[effective]) {
+        throw new FastModeError("FAST_MODE_NOT_SUPPORTED", `Codex の ${effective ?? "（modelを特定できません）"} はfastに対応していません（対応: ${Object.keys(catalog.fast_ids ?? {}).join(", ") || "なし"}）。${untouched}`);
+    }
+}
+/** 起動の前の確かめ。設定の誤り（対応していないmodel、IDとの食い違い）はここで断り、席を作らない。 */
+async function planLaunchFast(kind, o) {
+    const variant = modelIsFastVariant(kind, o.model);
+    const plan = { model: o.model, cursor_fast: false, state: variant, switch_after_ready: false, fast_error: null };
+    if (o.fast === false && variant) {
+        throw new FastModeError("FAST_MODE_MODEL_CONFLICT", `model=${o.model} はfast版のIDですが、fast: false が渡されました。元のmodel IDを渡すか、fastを省いてください。起動していません。`);
+    }
+    if (o.fast !== true || variant)
+        return plan;
+    const untouched = "起動していません。";
+    const bin = resolveAgentBin(kind);
+    // CLIが無い時は、後の起動が同じ訳で断る。ここでは先へ進める。
+    if (!bin)
+        return plan;
+    const cwd = o.cwd ?? process.cwd();
+    if (kind === "claude") {
+        plan.fast_error = await assertClaudeFastSupported(bin, cwd, o.model, untouched);
+        plan.switch_after_ready = plan.fast_error === null;
+        return plan;
+    }
+    if (kind === "codex") {
+        await assertCodexFastSupported(bin, realCodexHome(), o.model, untouched);
+        plan.switch_after_ready = true;
+        return plan;
+    }
+    if (kind === "cursor") {
+        if (!o.model) {
+            throw new FastModeError("FAST_MODE_NOT_SUPPORTED", `Cursor のfastはmodelごとです。modelを指定してください。${untouched}`);
+        }
+        assertCursorModelAvailable(bin, cwd, o.model, o.effort, true);
+        return { ...plan, cursor_fast: true, state: true };
+    }
+    const base = o.model ?? GROK_MODEL_DEFAULTS[kind];
+    const catalog = await grokCatalogForFast(bin, cwd, base);
+    const fastId = catalog.fast_ids?.[base];
+    if (!fastId) {
+        throw new FastModeError("FAST_MODE_NOT_SUPPORTED", `Grok の ${base} にfast版のmodelがありません（fast版があるmodel: ${Object.keys(catalog.fast_ids ?? {}).join(", ") || "なし"}）。${untouched}`);
+    }
+    return { ...plan, model: fastId, state: true };
+}
+const USER_DEFAULT_SETTLE_MS = 400;
+const USER_DEFAULT_RESTORE_PASSES = 3;
+/**
+ * harnessが利用者の既定へ書いた分を、切り替えの直前の中身（before）を元に戻す。
+ * harnessは1回の切り替えで何度か書く事があるので（Grokの起動で見た）、少し置きながら何度か見て、後から書かれた分も戻す。
+ */
+async function restoreUserDefaults(restore) {
+    for (let pass = 0; pass < USER_DEFAULT_RESTORE_PASSES; pass++) {
+        await sleep(USER_DEFAULT_SETTLE_MS);
+        try {
+            restore();
+        }
+        catch { /* 戻せなくても、切り替えの結果は返す */ }
+    }
+}
+/** 設定fileを触る切り替えを鍵の中で流し、終わったら、harnessが書いた既定を切り替えの直前の値へ戻す。 */
+async function keepingUserDefaults(configPath, restore, action) {
+    return withUserConfigLock(configPath, async () => {
+        const before = readFileOrNull(configPath);
+        try {
+            return await action();
+        }
+        finally {
+            await restoreUserDefaults(() => restore(before));
+        }
+    });
+}
+/**
+ * 起動の --model の値を利用者の既定へ書くharness（Grok 1.0.50。Cursorは、既定のmodelを設定に持つ端末）を起こす。
+ * 鍵を取り、起動の直前の中身を読み、起こして、既定が書かれるのを待ってから、直前の値へ戻す。
+ * - written: 起動の直前の中身と今の中身で、既定の項目が変わったか（harnessは起動時に、既定と関係の無い控えも書く。fileの変化だけでは見ない）。
+ * - mustWrite: この起動で、既定が必ず書かれる見込みか。trueなら、入力待ちになっても書かれるまで待つ（遅い起動では、入力待ちの後に書かれる）。
+ */
+async function launchKeepingUserDefaults(configPath, o, launch) {
+    return withUserConfigLock(configPath, async () => {
+        const before = readFileOrNull(configPath);
+        const mustWrite = o.mustWrite(before);
+        const launched = launch();
+        const started = performance.now();
+        const deadline = started + (mustWrite ? LAUNCH_DEFAULT_MUST_WRITE_WAIT_MS : LAUNCH_DEFAULT_WAIT_MS);
+        let aliveCheckedAt = started;
+        do {
+            await sleep(150);
+            if (o.written(before, readFileOrNull(configPath)))
+                break;
+            if (!sessionExists(launched[0]))
+                break;
+            // 書かれる見込みが無い時は、入力待ちになった所で戻しへ進む（書かない端末・同じ値の時）。
+            if (!mustWrite && o.ready(captureScreen(launched[0], AGENT_TUI_READY_LINES)))
+                break;
+            // harnessのprocessがもう居ない（起動に失敗した等）なら、書かれる事は無い。
+            if (performance.now() - aliveCheckedAt >= LAUNCH_ALIVE_CHECK_MS) {
+                aliveCheckedAt = performance.now();
+                if (observeSession(launched[0]).harness_alive === false)
+                    break;
+            }
+        } while (performance.now() < deadline);
+        await restoreUserDefaults(() => o.restore(before));
+        return launched;
+    });
+}
+function parseJsonObject(body) {
+    if (body === null)
+        return null;
+    try {
+        const value = JSON.parse(body.toString("utf8"));
+        return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Cursorのcli-config.jsonで、既定のmodelの項目（CURSOR_DEFAULT_MODEL_KEYS）が、前の中身から変わったか。 */
+function cursorDefaultsWritten(before, now) {
+    const previous = parseJsonObject(before), current = parseJsonObject(now);
+    if (current === null)
+        return false;
+    return CURSOR_DEFAULT_MODEL_KEYS.some((key) => !isDeepStrictEqual(previous?.[key], current[key]));
+}
+/** Grokのconfig.tomlで、[models] の既定（default・default_reasoning_effort）が、前の中身から変わったか。 */
+function grokDefaultsWritten(before, now) {
+    if (now === null)
+        return false;
+    const previous = grokModelDefaultsFromBody(before === null ? null : before.toString("utf8"));
+    const current = grokModelDefaultsFromBody(now.toString("utf8"));
+    return ["default", "default_reasoning_effort"].some((key) => previous[key].present !== current[key].present || previous[key].value !== current[key].value);
+}
+const grokUserConfigPath = (grokHome) => path.join(grokHome, "config.toml");
+const restoreGrokDefaults = (configPath) => (before) => restoreGrokModelDefaults(configPath, grokModelDefaultsFromBody(before === null ? null : before.toString("utf8")));
+const restoreCursorDefaults = (configPath) => (before) => {
+    // 前はfileが無かった時は、Cursorが作った物をそのまま残す（既定を持たない端末に、消す項目は無い）。
+    if (before !== null)
+        restoreJsonSetting(configPath, before, CURSOR_DEFAULT_MODEL_KEYS);
+};
+function recordAgentFast(meta, fast) {
+    meta.fast = fast;
+    writeAgentMetadata(meta);
+}
+/** 動いている席のfastを切り替える。返りは切り替えた後の状態。席は入力待ちである事（呼び手が確かめる）。 */
+async function switchAgentFast(name, meta, target, verified = false) {
+    const state = meta.kind === "claude" ? await switchClaudeFast(name, meta, target, verified)
+        : meta.kind === "codex" ? await switchCodexFast(name, meta, target, verified)
+            : meta.kind === "cursor" ? await switchCursorFast(name, meta, target)
+                : await switchGrokFast(name, meta, target);
+    recordAgentFast(meta, state);
+    return state;
+}
+async function switchClaudeFast(name, meta, target, verified = false) {
+    // もう通常の速度なら何も打たない（/fast off は、もう off でも利用者の設定を書き直す）。
+    if (!target && meta.fast !== true && !claudeFastIndicatorShown(captureScreen(name, AGENT_TUI_READY_LINES)))
+        return false;
+    const untouched = "席の速度は変えていません。";
+    if (target && !verified) {
+        // 対応していないmodelで /fast on を打つと、Claude Codeは勝手にOpusへ替える。送る前に一覧で確かめる。
+        const bin = meta.agent_executable ?? resolveAgentBin("claude");
+        if (!bin)
+            throw new FastModeError("FAST_MODE_UNCONFIRMED", `Claude Code の CLI が見つからず、fastの対応を確かめられません。${untouched}`);
+        if (meta.model === undefined) {
+            throw new FastModeError("FAST_MODE_UNCONFIRMED", `この席のmodelが控えに無く（前の版のAitermが起こした席）、fastの対応を確かめられません。agent_configureへmodelも渡してください。${untouched}`);
+        }
+        const unavailable = await assertClaudeFastSupported(bin, meta.cwd ?? process.cwd(), meta.model, untouched);
+        if (unavailable)
+            throw new FastModeError("FAST_MODE_UNAVAILABLE", `${unavailable.message.replace(/^FAST_MODE_UNAVAILABLE: /, "")}${untouched}`);
+    }
+    const settings = claudeUserSettingsPath();
+    // Claude Codeは結果の行を出す前に、利用者の設定へ fastMode を書く（on は true、off は項目を消す）。切り替えの前の値へ戻す。
+    const seen = await keepingUserDefaults(settings, (before) => { restoreJsonSetting(settings, before, "fastMode"); }, async () => {
+        const beforeScreen = captureScreen(name, AGENT_TUI_READY_LINES);
+        await sendAgentPromptText(name, target ? "/fast on" : "/fast off");
+        const deadline = performance.now() + CLAUDE_FAST_RESULT_TIMEOUT_MS;
+        let result = null;
+        do {
+            await sleep(150);
+            result = claudeFastResult(beforeScreen, captureScreen(name, AGENT_TUI_READY_LINES));
+        } while (!result && performance.now() < deadline);
+        return result;
+    });
+    await waitAgentTuiReady(name, meta, AGENT_TUI_READY_TIMEOUT_MS);
+    if (!seen) {
+        throw new FastModeError("FAST_MODE_UNCONFIRMED", `Claude Codeへ ${target ? "/fast on" : "/fast off"} を送りましたが、結果の行を確かめられません。席の速度は変わった可能性があります。`);
+    }
+    if (seen.state === "unavailable")
+        throw new FastModeError("FAST_MODE_UNAVAILABLE", `Claude Code: ${seen.line}。${untouched}`);
+    if (seen.state === "unchanged")
+        throw new FastModeError("FAST_MODE_UNCONFIRMED", `Claude Code: ${seen.line}`);
+    if ((seen.state === "on") !== target) {
+        throw new FastModeError("FAST_MODE_UNCONFIRMED", `Claude Codeの結果の行が頼んだ向きと違います（${seen.line}）。`);
+    }
+    return target;
+}
+/** Codexの入力欄で `/fast` を1回打つ（入り切りの交互）。返りは、切り替えた後にfastかどうか。 */
+async function toggleCodexFast(name) {
+    const before = codexServiceTierNotices(captureScreen(name, AGENT_TUI_READY_LINES));
+    send(name, "/fast", { enter: false, force: true, raw: false, mark: false, rtk: false, preserveAgentOperation: true, bracketedPaste: true });
+    // 命令の候補に /fast が出ていない時にEnterを押すと、文として送られて番が始まる。出るのを見てから押す。
+    let offered = false;
+    for (const deadline = performance.now() + CODEX_FAST_OFFER_TIMEOUT_MS; performance.now() < deadline; await sleep(100)) {
+        if (codexFastCommandOffered(captureScreen(name, AGENT_TUI_READY_LINES))) {
+            offered = true;
+            break;
+        }
+    }
+    if (!offered) {
+        for (let i = 0; i < "/fast".length; i++)
+            sendMenuChoice(name, "BSpace");
+        throw new FastModeError("FAST_MODE_NOT_SUPPORTED", "Codexの入力欄に /fast の命令が出ません（このmodel・この設定では速度の段を切り替えられません）。席の速度は変えていません。");
+    }
+    sendKey(name, "Enter", { preserveAgentOperation: true });
+    for (const deadline = performance.now() + CODEX_FAST_NOTICE_TIMEOUT_MS; performance.now() < deadline; await sleep(120)) {
+        const now = codexServiceTierNotices(captureScreen(name, AGENT_TUI_READY_LINES));
+        if (now.length > before.length || (now.length > 0 && now.at(-1) !== before.at(-1)))
+            return now.at(-1) === "fast";
+    }
+    throw new FastModeError("FAST_MODE_UNCONFIRMED", "Codexへ /fast を送りましたが、切り替えた後の「Service tier set to …」の行を確かめられません。席の速度は変わった可能性があります。");
+}
+async function switchCodexFast(name, meta, target, verified = false) {
+    // 席の控えが、Aitermの知る今の状態。足元に fast と出ている時（本物のログインの席は「GPT-5.6-Sol xhigh fast · …」と出す）は、
+    // 控えより画面を信じる（席で人が切り替えた時に、fastのまま「通常」と返さない）。出ていない時は、通常か、段を出さない構成かを区別できない。
+    const shownFast = codexFooterShowsFast(captureScreen(name, AGENT_TUI_READY_LINES)) === true;
+    if (shownFast && target)
+        return true;
+    if (meta.fast === target && !shownFast)
+        return target;
+    const bin = meta.agent_executable ?? resolveAgentBin("codex");
+    const codexHome = meta.codex_home ?? realCodexHome();
+    if (target && !verified) {
+        if (!bin)
+            throw new FastModeError("FAST_MODE_UNCONFIRMED", "Codex の CLI が見つからず、fastの対応を確かめられません。席の速度は変えていません。");
+        await assertCodexFastSupported(bin, codexHome, meta.model ?? null, "席の速度は変えていません。");
+    }
+    // /fast は切り替えのたびに、利用者のconfig.tomlへ service_tier を保存する。切り替えの直前の値へ戻す。
+    return keepingCodexDefaults(bin, codexHome, ["service_tier"], async () => {
+        let state = await toggleCodexFast(name);
+        // 控えと実際が違っていた時（席で人が切り替えた等）は、1回で逆へ動く。もう1回打って頼まれた向きにする。
+        if (state !== target)
+            state = await toggleCodexFast(name);
+        if (state !== target) {
+            throw new FastModeError("FAST_MODE_UNCONFIRMED", "Codexの /fast を2回打っても、頼まれた向きになりません。");
+        }
+        return target;
+    });
+}
+/**
+ * Codexの席の中の切り替え（/fast、/model の選択）を鍵の中で流し、Codexが利用者のconfig.tomlへ保存した項目を、切り替えの直前の値へ戻す。
+ * 戻しは公式の口（App Serverの config/batchWrite）。戻せない時と、戻した後もfileが前の値でない時は、その1行だけをfileで直す
+ * （戻さずに残すと、利用者の次のCodexが、席の値で始まる）。
+ */
+async function keepingCodexDefaults(bin, codexHome, keys, action) {
+    const configPath = path.join(codexHome, "config.toml");
+    const pinKey = { service_tier: "service_tier", model: "model", model_reasoning_effort: "effort" };
+    return withUserConfigLock(configPath, async () => {
+        const pins = readCodexConfigPins(configPath);
+        const before = Object.fromEntries(keys.map((key) => [key, pins[pinKey[key]]]));
+        const fixInFile = () => {
+            const now = readCodexConfigPins(configPath);
+            for (const key of keys) {
+                const pin = now[pinKey[key]];
+                if (pin.present === before[key].present && pin.value === before[key].value)
+                    continue;
+                try {
+                    restoreCodexDefaultInFile(configPath, key, before[key]);
+                }
+                catch { /* 戻せなくても、切り替えの結果は返す */ }
+            }
+        };
+        try {
+            return await action();
+        }
+        finally {
+            // Codexは切り替えの知らせを出した後に保存する。保存を待ってから戻す。
+            await sleep(USER_DEFAULT_SETTLE_MS);
+            try {
+                if (!bin)
+                    throw new AitermError("Codex の CLI が見つかりません", 2);
+                await restoreCodexDefaults(bin, codexHome, before);
+            }
+            catch { /* 下で、fileのその行を直す */ }
+            fixInFile();
+            await sleep(USER_DEFAULT_SETTLE_MS);
+            fixInFile();
+        }
+    });
+}
+const CURSOR_PICKER_CLOSE_MS = 600;
+/**
+ * Cursorの `/model` の選ぶ画面を閉じた後、入力欄を描き直させる。
+ * 2026.10.01のCursorは、選ぶ画面を閉じても入力欄の行を描かず（選ぶ画面の「Filter:」の行が残る）、鍵が1つ入るまでそのまま。
+ * そのままだとAitermは入力待ちと読めず、次の送信を断る。空白を1つ打って消すと、入力欄が描かれる（入力欄は空のまま）。
+ */
+async function redrawCursorComposer(name) {
+    await sleep(CURSOR_PICKER_CLOSE_MS);
+    sendMenuChoice(name, "Space");
+    await sleep(150);
+    sendMenuChoice(name, "BSpace");
+    await sleep(150);
+}
+/** Cursorの `/model` の画面が、その姿（list＝選ぶ画面、parameters＝パラメータの画面、null＝閉じた）になるのを待つ。 */
+async function waitCursorPickerView(name, view, timeoutMs = 4_000) {
+    const deadline = performance.now() + timeoutMs;
+    do {
+        const screen = captureScreen(name, AGENT_TUI_READY_LINES);
+        if (cursorPickerView(screen) === view)
+            return screen;
+        await sleep(100);
+    } while (performance.now() < deadline);
+    throw new AitermError(`Cursor の /model の画面（${view === "list" ? "選ぶ画面" : view === "parameters" ? "Edit Parameters" : "閉じた後"}）を確認できません`, 2);
+}
+const CURSOR_PARAMETER_STEP_TIMEOUT_MS = 800;
+/**
+ * Cursorのパラメータの画面で、選択中（→）の行を、目当ての名前の行まで動かす。
+ * 矢印を続けて送ると鍵が落ちる事があり（2026.10.01で見た）、違う行でEnterを押すと別の値を選んでしまう。
+ * 1歩ずつ、画面で矢印が動いたのを確かめる。目当ての行に着いた時だけtrueを返す。
+ */
+async function moveCursorParameterTo(name, label) {
+    for (let step = 0; step < 24; step++) {
+        const rows = cursorParameterRows(captureScreen(name, AGENT_TUI_READY_LINES));
+        const at = rows.findIndex((row) => row.cursor);
+        const target = rows.findIndex((row) => row.label === label);
+        if (at < 0 || target < 0)
+            return false;
+        if (at === target)
+            return true;
+        sendMenuChoice(name, target > at ? "Down" : "Up");
+        for (const deadline = performance.now() + CURSOR_PARAMETER_STEP_TIMEOUT_MS; performance.now() < deadline; await sleep(60)) {
+            if (cursorParameterRows(captureScreen(name, AGENT_TUI_READY_LINES)).findIndex((row) => row.cursor) !== at)
+                break;
+        }
+    }
+    return false;
+}
+/** Cursorの `/model` の操作を流し、Cursorが利用者の既定（cli-config.jsonのmodelの項目）へ書いた分を、直前の値へ戻す。 */
+function keepingCursorDefaults(meta, action) {
+    const configPath = cursorUserConfigPath(meta.cursor_home ?? realCursorHome());
+    return keepingUserDefaults(configPath, restoreCursorDefaults(configPath), action);
+}
+async function switchCursorFast(name, meta, target) {
+    // 見出しのmodelの表示が、もう頼まれた向きなら、選ぶ画面を開かない（設定替えのたびに fast: false を渡す呼び手がいる）。
+    if (cursorHeaderShowsFast(captureScreen(name, AGENT_TUI_READY_LINES)) === target)
+        return target;
+    return keepingCursorDefaults(meta, () => toggleCursorFast(name, meta, target));
+}
+async function toggleCursorFast(name, meta, target) {
+    // 引数なしの /model は、今のmodelの行に印を付けて開く。Tabでそのmodelのパラメータの画面（Edit Parameters）。
+    await sendAgentPromptText(name, "/model", meta.kind);
+    await waitCursorPickerView(name, "list");
+    sendMenuChoice(name, "Tab");
+    /** 選ばずに閉じる。パラメータの画面ならEscで選ぶ画面へ戻り、もう一度Escで閉じる。 */
+    const closeWithoutChange = async () => {
+        for (let i = 0; i < 2 && cursorPickerView(captureScreen(name, AGENT_TUI_READY_LINES)) !== null; i++) {
+            const view = cursorPickerView(captureScreen(name, AGENT_TUI_READY_LINES));
+            sendMenuChoice(name, "Escape");
+            await waitCursorPickerView(name, view === "parameters" ? "list" : null).catch(() => undefined);
+        }
+        await redrawCursorComposer(name);
+        await waitAgentTuiReady(name, meta, AGENT_TUI_READY_TIMEOUT_MS);
+    };
+    let parameters;
+    try {
+        parameters = await waitCursorPickerView(name, "parameters");
+    }
+    catch {
+        await closeWithoutChange();
+        if (target)
+            throw new FastModeError("FAST_MODE_NOT_SUPPORTED", "Cursorの今のmodelには、パラメータの画面がありません。席の速度は変えていません。");
+        return false;
+    }
+    const row = cursorFastParameter(parameters);
+    if (!row) {
+        await closeWithoutChange();
+        if (target)
+            throw new FastModeError("FAST_MODE_NOT_SUPPORTED", "Cursorの今のmodelのパラメータに、Fastの行がありません。席の速度は変えていません。");
+        return false;
+    }
+    if (row.state === target) {
+        await closeWithoutChange();
+        return target;
+    }
+    if (!(await moveCursorParameterTo(name, "Fast"))) {
+        await closeWithoutChange();
+        throw new FastModeError("FAST_MODE_UNCONFIRMED", "Cursorのパラメータの画面で、Fastの行へ動かせません。選ばずに閉じました。席の速度は変えていません。");
+    }
+    sendMenuChoice(name, "Enter");
+    let now = row;
+    for (const deadline = performance.now() + CURSOR_FAST_ROW_TIMEOUT_MS; performance.now() < deadline; await sleep(100)) {
+        now = cursorFastParameter(captureScreen(name, AGENT_TUI_READY_LINES)) ?? now;
+        if (now.state === target)
+            break;
+    }
+    if (now.state !== target) {
+        await closeWithoutChange();
+        throw new FastModeError("FAST_MODE_UNCONFIRMED", "Cursorのパラメータの画面で、Fastの行の印が替わりません。選ばずに閉じました。");
+    }
+    sendMenuChoice(name, "Escape");
+    await waitCursorPickerView(name, "list");
+    sendMenuChoice(name, "Enter");
+    await waitCursorPickerView(name, null);
+    await redrawCursorComposer(name);
+    const ready = await waitAgentTuiReady(name, meta, AGENT_TUI_READY_TIMEOUT_MS);
+    const shown = cursorHeaderShowsFast(captureScreen(name, AGENT_TUI_READY_LINES));
+    if (!ready.ready || (shown !== null && shown !== target)) {
+        throw new FastModeError("FAST_MODE_UNCONFIRMED", "Cursorの見出しのmodelの表示で、切り替えた後の状態を確かめられません。席の速度は変わった可能性があります。");
+    }
+    return target;
+}
+/** Grokの `/model …`（`/effort …`）を打ち、Grokが利用者の既定（[models] の default・default_reasoning_effort）へ書いた分を、切り替えの直前の値へ戻す。 */
+async function sendGrokModelCommand(name, meta, command, model, effort) {
+    const configPath = grokUserConfigPath(meta.grok_home ?? realGrokHome());
+    await keepingUserDefaults(configPath, restoreGrokDefaults(configPath), async () => {
+        const before = captureScreen(name, AGENT_TUI_READY_LINES);
+        await sendAgentPromptText(name, command);
+        // modelの替えは、端末によって知らせが出るまで数秒かかる（Windowsで3秒を超えた）。
+        await waitForGrokConfigurationResult(name, before, model, effort, model ? GROK_MODEL_SWITCH_TIMEOUT_MS : undefined);
+    });
+}
+async function switchGrokFast(name, meta, target) {
+    const untouched = "席の速度は変えていません。";
+    // 足元のmodelの表示（「Grok 4.7 Fast (high)」）が、もう頼まれた向きなら、一覧を引かない。
+    const shown = grokFooterModelName(captureScreen(name, AGENT_TUI_READY_LINES));
+    if (shown !== null && / Fast$/.test(shown) === target)
+        return target;
+    const bin = meta.agent_executable ?? resolveAgentBin(meta.kind);
+    if (!bin)
+        throw new FastModeError("FAST_MODE_UNCONFIRMED", `Grok の CLI が見つからず、fastの対応を確かめられません。${untouched}`);
+    let catalog = await grokModelChoices(bin, meta.cwd ?? process.cwd());
+    let current = grokModelFromFooter(captureScreen(name, AGENT_TUI_READY_LINES), catalog);
+    if (!current || (target && !catalog.fast_ids?.[current.base])) {
+        // 一覧にfast版が見えない時（今のmodelがfast版だと、足元の表示も一覧と合わない）は、1度聞き直す。
+        await sleep(GROK_FAST_CATALOG_RETRY_MS);
+        catalog = await grokModelChoices(bin, meta.cwd ?? process.cwd());
+        current = grokModelFromFooter(captureScreen(name, AGENT_TUI_READY_LINES), catalog);
+    }
+    if (!current)
+        throw new FastModeError("FAST_MODE_UNCONFIRMED", `Grokの足元から、今のmodelを読めません。${untouched}`);
+    if (current.fast === target)
+        return target;
+    const next = target ? catalog.fast_ids?.[current.base] : current.base;
+    if (!next) {
+        throw new FastModeError("FAST_MODE_NOT_SUPPORTED", `Grok の ${current.base} にfast版のmodelがありません（fast版があるmodel: ${Object.keys(catalog.fast_ids ?? {}).join(", ") || "なし"}）。${untouched}`);
+    }
+    // 切り替えの知らせを取り逃しても、足元のmodelの表示が頼んだ向きになっていれば、切り替わっている。
+    let noticeError = null;
+    try {
+        await sendGrokModelCommand(name, meta, `/model ${next}`, next, null);
+    }
+    catch (error) {
+        noticeError = error;
+    }
+    const after = grokModelFromFooter(captureScreen(name, AGENT_TUI_READY_LINES), catalog);
+    if (after?.fast === target)
+        return target;
+    if (noticeError && after?.fast === current.fast) {
+        throw new FastModeError("FAST_MODE_UNCONFIRMED", `Grokが /model ${next} を受け付けたのを確かめられません（${noticeError instanceof Error ? noticeError.message : String(noticeError)}）。足元のmodelの表示は前のままです。`);
+    }
+    throw new FastModeError("FAST_MODE_UNCONFIRMED", "Grokの足元のmodelの表示で、切り替えた後の状態を確かめられません。席の速度は変わった可能性があります。");
+}
+/** 起動の後、入力待ちになった席をfastへ切り替える。出来なかった訳は返りへ入れ、起動は続ける。 */
+async function applyLaunchFast(name, meta) {
+    try {
+        // 対応は、起動の前（planLaunchFast）に一覧で確かめてある。
+        await switchAgentFast(name, meta, true, true);
+        return null;
+    }
+    catch (error) {
+        const failure = fastModeFailure(error);
+        if (failure)
+            return failure;
+        return {
+            code: "FAST_MODE_UNCONFIRMED",
+            message: `FAST_MODE_UNCONFIRMED: 起動の後の切り替えで失敗しました: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
 export async function configureAgent(name, opts) {
     assertSessionName(name);
     const model = opts.model?.trim() || null;
     const effort = opts.reasoning_effort?.trim() || null;
-    if (!model && !effort)
-        throw new AitermError("model または reasoning_effort を指定してください", 2);
+    const fast = opts.fast ?? null;
+    if (!model && !effort && fast === null)
+        throw new AitermError("model、reasoning_effort、fast のいずれかを指定してください", 2);
     if ((model && /[\r\n]/.test(model)) || (effort && /[\r\n]/.test(effort))) {
         throw new AitermError("model／reasoning_effort に改行を含められません", 2);
     }
     const meta = loadAgentMetadata(name);
+    if (fast === false && modelIsFastVariant(meta.kind, model)) {
+        throw new FastModeError("FAST_MODE_MODEL_CONFLICT", `model=${model} はfast版のIDですが、fast: false が渡されました。元のmodel IDを渡すか、fastを省いてください。設定は変えていません。`);
+    }
     bindCompletedInitialPrompt(meta);
     const { ready, codexRateLimitModelSwitch } = await waitAgentTuiReadyAfterCodexRateLimitRecovery(name, meta, AGENT_TUI_READY_TIMEOUT_MS);
     if (!ready.ready) {
@@ -4298,6 +4863,53 @@ export async function configureAgent(name, opts) {
         }
         throw new AitermError(`agent session '${name}' は入力待ちではありません`, 2);
     }
+    const configured = () => ({
+        schema: "aiterm.agent-configure-result.v1",
+        session_id: name,
+        provider: meta.kind,
+        harness: agentHarness(meta.kind),
+        model,
+        reasoning_effort: effort,
+        fast: typeof meta.fast === "boolean" ? meta.fast : null,
+    });
+    const rememberModel = () => {
+        if (!model)
+            return;
+        meta.model = model;
+        writeAgentMetadata(meta);
+    };
+    // fast: true は、modelやeffortを替える前に対応を確かめる（断る時は何も変えない）。
+    let fastVerified = false;
+    if (fast === true && (meta.kind === "claude" || meta.kind === "codex")) {
+        const untouched = "設定は変えていません。";
+        const bin = meta.agent_executable ?? resolveAgentBin(meta.kind);
+        if (!bin)
+            throw new FastModeError("FAST_MODE_UNCONFIRMED", `${agentLabel(meta.kind)} の CLI が見つからず、fastの対応を確かめられません。${untouched}`);
+        if (meta.kind === "claude") {
+            const target = model ?? meta.model;
+            if (target === undefined) {
+                throw new FastModeError("FAST_MODE_UNCONFIRMED", `この席のmodelが控えに無く（前の版のAitermが起こした席）、fastの対応を確かめられません。modelも渡してください。${untouched}`);
+            }
+            const unavailable = await assertClaudeFastSupported(bin, meta.cwd ?? process.cwd(), target, untouched);
+            if (unavailable)
+                throw new FastModeError("FAST_MODE_UNAVAILABLE", `${unavailable.message.replace(/^FAST_MODE_UNAVAILABLE: /, "")}${untouched}`);
+        }
+        else {
+            await assertCodexFastSupported(bin, meta.codex_home ?? realCodexHome(), model ?? meta.model ?? null, untouched);
+        }
+        fastVerified = true;
+    }
+    /** modelを替えた後、fastを省いた時: harnessは替えた先がfastに対応していなければfastを外す。席の控えを実際へ合わせる。 */
+    const dropFastIfUnsupported = async () => {
+        if (fast !== null || !model || meta.fast !== true)
+            return;
+        const bin = meta.agent_executable ?? resolveAgentBin(meta.kind);
+        if (!bin)
+            return;
+        const catalog = meta.kind === "claude" ? await claudeModelChoices(bin, meta.cwd ?? process.cwd()) : await codexModelChoices(bin, true);
+        if (!catalog.fast_ids?.[model])
+            recordAgentFast(meta, false);
+    };
     if (meta.kind === "claude") {
         // ultracodeはClaude Codeが自分で「this session only」と返すsession設定で、選ぶ画面には出ない。
         const level = effort && CLAUDE_EFFORTS.has(effort) ? effort : null;
@@ -4312,78 +4924,139 @@ export async function configureAgent(name, opts) {
             if (!effortReady.ready)
                 throw new AitermError(`Claudeのeffort変更完了を確認できません`, 2);
         }
-        return {
-            schema: "aiterm.agent-configure-result.v1",
-            session_id: name,
-            provider: "claude",
-            harness: agentHarness("claude"),
-            model,
-            reasoning_effort: effort,
-        };
+        rememberModel();
+        if (fast !== null)
+            recordAgentFast(meta, await switchClaudeFast(name, meta, fast, fastVerified));
+        else
+            await dropFastIfUnsupported();
+        return configured();
     }
     if (meta.kind === "cursor") {
         validateCursorModelEffort(model, effort);
-        if (!model)
+        if (!model && effort)
             throw new AitermError("Cursorのreasoning_effort変更にはmodelも指定してください", 2);
-        const bin = resolveAgentBin("cursor");
-        if (!bin)
-            throw new AitermError("Cursor Agent CLI の CLI が見つかりません", 2);
-        assertCursorModelAvailable(bin, meta.cwd ?? process.cwd(), model, effort);
+        if (model) {
+            const bin = resolveAgentBin("cursor");
+            if (!bin)
+                throw new AitermError("Cursor Agent CLI の CLI が見つかりません", 2);
+            assertCursorModelAvailable(bin, meta.cwd ?? process.cwd(), model, effort);
+            if (fast === true && !modelIsFastVariant("cursor", model)) {
+                // そのmodelのどの組にもfast版が無ければ、modelを替える前に断る（組ごとの有無は、替えた後のパラメータの画面で分かる）。
+                const fastIds = Object.keys(cursorModelChoices(bin, meta.cwd ?? process.cwd()).fast_ids ?? {});
+                if (!fastIds.some((key) => key === model || key.startsWith(`${model}-`))) {
+                    throw new FastModeError("FAST_MODE_NOT_SUPPORTED", `Cursor の ${model} にfast版がありません。設定は変えていません。`);
+                }
+            }
+        }
         // Cursor TUIの `/model <base model>` はmodelを直接切り替える一方、flatten済みcatalog ID
         // （例: gpt-5.6-luna-high）を渡すとno matchesのfilter画面へ入る。effortは標準model pickerの
         // parameter editorで選び、同じsessionと会話contextを保つ。
-        await sendAgentPromptText(name, `/model ${model}`, meta.kind);
-        const modelReady = await waitAgentTuiReady(name, meta, AGENT_TUI_READY_TIMEOUT_MS);
-        if (!modelReady.ready)
-            throw new AitermError("Cursorのmodel変更完了を確認できません", 2);
-        if (effort) {
-            await sendAgentPromptText(name, "/model", meta.kind);
-            await waitForScreenText(name, "Available models");
-            sendMenuChoice(name, "Tab");
-            const parameterScreen = await waitForScreenText(name, "Edit Parameters");
-            const navigation = cursorEffortNavigation(parameterScreen, effort);
-            for (let i = 0; i < navigation.down; i++)
-                sendMenuChoice(name, "Down");
-            sendMenuChoice(name, "Enter");
-            await waitForScreenText(name, `${navigation.label} ✓`);
-            sendMenuChoice(name, "Escape");
-            await waitForScreenText(name, "Available models");
-            sendMenuChoice(name, "Enter");
-            const effortReady = await waitAgentTuiReady(name, meta, AGENT_TUI_READY_TIMEOUT_MS);
-            if (!effortReady.ready)
-                throw new AitermError("Cursorのreasoning effort変更完了を確認できません", 2);
-        }
-        return {
-            schema: "aiterm.agent-configure-result.v1",
-            session_id: name,
-            provider: "cursor",
-            harness: agentHarness("cursor"),
-            model,
-            reasoning_effort: effort,
-        };
+        // Cursorは選んだmodelとパラメータを、利用者の既定（cli-config.json）へも書く版がある。席だけの替えにするため、直前の値へ戻す。
+        if (model)
+            await keepingCursorDefaults(meta, async () => {
+                await sendAgentPromptText(name, `/model ${model}`, meta.kind);
+                const modelReady = await waitAgentTuiReady(name, meta, AGENT_TUI_READY_TIMEOUT_MS);
+                if (!modelReady.ready)
+                    throw new AitermError("Cursorのmodel変更完了を確認できません", 2);
+                if (!effort)
+                    return;
+                await sendAgentPromptText(name, "/model", meta.kind);
+                await waitCursorPickerView(name, "list");
+                sendMenuChoice(name, "Tab");
+                const parameterScreen = await waitCursorPickerView(name, "parameters");
+                const navigation = cursorEffortNavigation(parameterScreen, effort);
+                if (!(await moveCursorParameterTo(name, navigation.label))) {
+                    sendMenuChoice(name, "Escape");
+                    await waitCursorPickerView(name, "list").catch(() => undefined);
+                    sendMenuChoice(name, "Escape");
+                    await redrawCursorComposer(name);
+                    throw new AitermError(`Cursorのパラメータの画面で ${navigation.label} の行へ動かせません。reasoning effortは選んでいません。`, 2);
+                }
+                sendMenuChoice(name, "Enter");
+                let selected = false;
+                for (const deadline = performance.now() + CURSOR_FAST_ROW_TIMEOUT_MS; !selected && performance.now() < deadline; await sleep(100)) {
+                    selected = cursorEffortSelected(captureScreen(name, AGENT_TUI_READY_LINES), navigation.label);
+                }
+                if (!selected)
+                    throw new AitermError(`Cursor の ${navigation.label} ✓ 画面を確認できません`, 2);
+                sendMenuChoice(name, "Escape");
+                await waitCursorPickerView(name, "list");
+                sendMenuChoice(name, "Enter");
+                await waitCursorPickerView(name, null);
+                await redrawCursorComposer(name);
+                const effortReady = await waitAgentTuiReady(name, meta, AGENT_TUI_READY_TIMEOUT_MS);
+                if (!effortReady.ready)
+                    throw new AitermError("Cursorのreasoning effort変更完了を確認できません", 2);
+            });
+        rememberModel();
+        if (fast !== null)
+            recordAgentFast(meta, await switchCursorFast(name, meta, fast));
+        else if (model) {
+            // modelを替えた後の実際の状態を、見出しのmodelの表示で読む。
+            const shown = cursorHeaderShowsFast(captureScreen(name, AGENT_TUI_READY_LINES));
+            if (shown !== null)
+                recordAgentFast(meta, shown);
+        }
+        return configured();
     }
     if (meta.kind === "grok") {
+        // Grokのfastは別のmodel ID。modelを替える時は、頼まれた（省略なら席の今の）fastに合わせて、渡すIDを決める。
+        let next = model;
         if (model) {
             const bin = resolveAgentBin(meta.kind);
             if (!bin)
                 throw new AitermError(`${agentLabel(meta.kind)} の CLI が見つかりません`, 2);
             assertGrokModelAvailable(bin, meta.cwd ?? process.cwd(), model);
+            if ((fast ?? (meta.fast === true)) && !modelIsFastVariant("grok", model)) {
+                const fastIds = (await grokCatalogForFast(bin, meta.cwd ?? process.cwd(), model)).fast_ids ?? {};
+                if (fastIds[model])
+                    next = fastIds[model];
+                else if (fast === true) {
+                    throw new FastModeError("FAST_MODE_NOT_SUPPORTED", `Grok の ${model} にfast版のmodelがありません（fast版があるmodel: ${Object.keys(fastIds).join(", ") || "なし"}）。設定は変えていません。`);
+                }
+            }
         }
-        const command = model
-            ? `/model ${model}${effort ? ` ${effort}` : ""}`
-            : `/effort ${effort}`;
-        const before = captureScreen(name, AGENT_TUI_READY_LINES);
-        await sendAgentPromptText(name, command);
-        await waitForGrokConfigurationResult(name, before, model, effort);
-        return {
-            schema: "aiterm.agent-configure-result.v1",
-            session_id: name,
-            provider: meta.kind,
-            harness: agentHarness(meta.kind),
-            model,
-            reasoning_effort: effort,
-        };
+        if (model || effort) {
+            // `/model` はGrokが利用者の既定（[models].default）へも書くので、切り替えの直前の値へ戻す。
+            await sendGrokModelCommand(name, meta, next ? `/model ${next}${effort ? ` ${effort}` : ""}` : `/effort ${effort}`, next, effort);
+            if (model) {
+                rememberModel();
+                recordAgentFast(meta, next !== model || modelIsFastVariant("grok", model));
+            }
+        }
+        if (!model && fast !== null)
+            recordAgentFast(meta, await switchGrokFast(name, meta, fast));
+        return configured();
+    }
+    // `/model` の選択は、利用者のconfig.tomlへ model と model_reasoning_effort を既定として保存する。席だけの替えにするため、直前の値へ戻す。
+    if (model || effort) {
+        await keepingCodexDefaults(meta.agent_executable ?? resolveAgentBin("codex"), meta.codex_home ?? realCodexHome(), ["model", "model_reasoning_effort"], () => configureCodexModel(name, model, effort));
     }
+    rememberModel();
+    if (fast !== null)
+        recordAgentFast(meta, await switchCodexFast(name, meta, fast, fastVerified));
+    else
+        await dropFastIfUnsupported();
+    return configured();
+}
+/** Codexの `/model` の選ぶ画面で、modelとreasoning effortを替える。 */
+async function configureCodexModel(name, model, effort) {
+    try {
+        await chooseCodexModel(name, model, effort);
+    }
+    catch (error) {
+        // 選べずに断る時は、開いた選ぶ画面を閉じてから断る（開いたままだと、席は次の文を受け付けない）。
+        for (let i = 0; i < 3; i++) {
+            const tail = captureScreen(name, AGENT_TUI_READY_LINES).split("\n").map((line) => line.trim()).filter(Boolean).slice(-2).join("\n");
+            if (!/esc back/.test(tail))
+                break;
+            sendMenuChoice(name, "Escape");
+            await sleep(400);
+        }
+        throw error;
+    }
+}
+async function chooseCodexModel(name, model, effort) {
     await sendAgentPromptText(name, "/model");
     const modelScreen = await waitForScreenText(name, "Select Model and Effort");
     if (model) {
@@ -4414,14 +5087,6 @@ export async function configureAgent(name, opts) {
         sendMenuChoice(name, "Enter");
     }
     await waitForScreenText(name, "Model changed to");
-    return {
-        schema: "aiterm.agent-configure-result.v1",
-        session_id: name,
-        provider: "codex",
-        harness: agentHarness("codex"),
-        model,
-        reasoning_effort: effort,
-    };
 }
 export function __testCodexConfigureChoices(screen, model, effort) {
     return {
@@ -4570,7 +5235,8 @@ async function dispatchAgentTurnInLock(name, text, o) {
     const startOffset = agentCompletionCursor(meta);
     // promptなしで起動したCursorは、最初のdispatch時点ではtranscriptとの相関markerをまだ持たない。
     // その1回だけlaunch contextを加え、以後はbind済みconversationへ通常textだけを送る。
-    const prefaced = splitAgentPreface(meta.kind, o.preface, text);
+    // 画面の確かめを飛ばす送信（force）と、加工なしの送信（raw）には、既定の前置きを打たない（打った文は入力欄がそのまま読む）。
+    const prefaced = splitAgentPreface(meta.kind, o.preface, text, { defaultForWrapped: !o.force && !o.raw });
     const dispatchText = meta.kind === "cursor" && !meta.vendor_session_id
         ? `${subagentInstruction(meta)}\n\n${prefaced.body}`
         : prefaced.body;
@@ -4691,6 +5357,38 @@ async function codexTurnRunningBehindIdleScreen(name, meta, screen) {
         return false; /* 読めない時は、動いていると数えない */
     }
 }
+const CLAUDE_SELECT_MENU_SETTLE_MS = 250;
+const CLAUDE_SELECT_MENU_CLOSE_TIMEOUT_MS = 3000;
+/**
+ * Claudeの席へ打つ前に、入力欄の代わりに選ぶ画面が出ていないかを見る。
+ * 選ぶ画面は貼り付けを捨ててEnterだけを読むので、そのまま送ると文は会話へ入らず、選択中の行が選ばれる
+ * （実被弾 2026-10-13: 利用枠に当たった直後の3席で、指揮官氏の文が消えた）。打鍵の前置きは、数字や「j」が選択の操作になる。
+ * 利用枠の選ぶ画面はEscで閉じてから送る（Escは何も選ばない。枠が解けていれば文は普通に入り、解けていなければ番がAPIエラーで返る）。
+ * 見覚えの無い選ぶ画面は、何も打たずに断る。戻り値は行った回復。
+ */
+async function clearClaudeSelectMenuBeforeInput(name) {
+    if (!claudeLiveSelectMenu(captureScreen(name, 0)))
+        return [];
+    // 描き直しの途中の1枚で打たない。少し置いた2枚目にも同じ画面がある時だけ、開いていると数える。
+    await sleep(CLAUDE_SELECT_MENU_SETTLE_MS);
+    const menu = claudeLiveSelectMenu(captureScreen(name, 0));
+    if (!menu)
+        return [];
+    if (menu.kind !== "rate_limit_options") {
+        throw new AitermError(`CLAUDE_SELECT_MENU_OPEN vendor=claude session=${name}\n` +
+            `Claude Codeの選ぶ画面が開いています（見出し: ${menu.heading ?? "不明"}）。打った文字は選択の操作として読まれるため、文字列は送信していません。` +
+            "pty_read(screen:true) で画面を確かめてください。", 2);
+    }
+    sendMenuChoice(name, "Escape");
+    for (const deadline = performance.now() + CLAUDE_SELECT_MENU_CLOSE_TIMEOUT_MS; performance.now() < deadline;) {
+        await sleep(100);
+        if (!claudeLiveSelectMenu(captureScreen(name, 0)))
+            return ["claude_rate_limit_menu_closed"];
+    }
+    throw new AitermError(`CLAUDE_RATE_LIMIT_MENU_NOT_CLOSED vendor=claude session=${name}\n` +
+        "利用枠の上限の選ぶ画面（/rate-limit-options）をEscで閉じられませんでした。文字列は送信していません。" +
+        "pty_read(screen:true) で画面を確かめてください。", 2);
+}
 /**
  * agent sessionへの唯一の送信口。呼び出し側は子の状態を知らないまま呼び、Aitermがこの時点の画面で振り分ける。
  * 実行中なら現在のturnへ差し込み（steer）、そうでなければ新しいturnとしてdispatchする。
@@ -4709,6 +5407,8 @@ async function sendAgentMessageInLock(name, text, o) {
     const meta = loadAgentMetadata(name);
     // 前面回復は busy 判定より先（bash 前面のままだと画面の実行中マーカーを読んでも打鍵が届かない）。
     const paneInputRecovery = await ensureAgentOwnsPaneInput(name, meta.kind);
+    if (meta.kind === "claude")
+        paneInputRecovery.push(...await clearClaudeSelectMenuBeforeInput(name));
     const screen = captureScreen(name, AGENT_TUI_READY_LINES);
     let running = isAgentTuiBusy(meta.kind, screen);
     // Claudeのtool処理中は画面のbusy表示が消えることがある。Stopまで保持するturnの印を正とし、
@@ -4754,7 +5454,7 @@ async function steerRunningTurn(name, meta, text, o) {
         harness: agentHarness(meta.kind),
         pane_input_recovery: o.pane_input_recovery,
     };
-    const prefaced = splitAgentPreface(meta.kind, o.preface, text);
+    const prefaced = splitAgentPreface(meta.kind, o.preface, text, { defaultForWrapped: !o.raw });
     text = prefaced.body;
     prepareSendText(text, { raw: o.raw });
     // Claudeのoperation相関は変えない。差し込みは実行中turnの一部であり、新しいturnを予約しない。
@@ -4915,15 +5615,22 @@ export function harnessLauncherDiagnostic(kind) {
         return "unverified";
     }
 }
-function buildAgentCmd(kind, bin, model, effort, prompt, meta = null) {
+function buildAgentCmd(kind, bin, model, effort, prompt, meta = null, cursorFast = false) {
     if (kind === "claude")
         return buildClaudeAgentCmd(bin, model, effort, prompt, meta);
     if (kind === "codex")
         return buildCodexAgentCmd(bin, model, effort, prompt, meta);
     if (kind === "cursor")
-        return buildCursorAgentCmd(bin, model, effort, prompt, meta);
+        return buildCursorAgentCmd(bin, model, effort, prompt, meta, cursorFast);
     return buildGrokAgentCmd(kind, bin, model, effort, prompt, meta);
 }
+/**
+ * 席の会話ID（`--session-id`で起こすClaude CodeとGrokだけ、起動の時点で決まっている）。席のprocessが起こした子にも起動の印
+ * （AITERM_AGENT_LAUNCH_ID）は継がれるので、hookなどが「席そのものの会話か」を見分ける時は、この値を自分の会話IDと比べる（ADR 0118）。
+ */
+function agentVendorSessionEnv(meta) {
+    return meta.vendor_session_id ? [["AITERM_AGENT_VENDOR_SESSION_ID", meta.vendor_session_id]] : [];
+}
 /** Cursor用のagent環境変数（名前と値）。Windowsでは引用規則の違うPowerShell paneへ渡す。 */
 function cursorAgentEnvEntries(meta, sid, envVars = []) {
     const inherited = envVars.flatMap((name) => {
@@ -4936,6 +5643,7 @@ function cursorAgentEnvEntries(meta, sid, envVars = []) {
         ["AITERM_SESSION_ID", sid],
         ["AITERM_AGENT_SESSION_ID", sid],
         ["AITERM_AGENT_LAUNCH_ID", meta.launch_id],
+        ...agentVendorSessionEnv(meta),
         ["AITERM_AGENT_ROLE", meta.agent_role ?? "subagent"],
         ["AITERM_AGENT_PARENT_SESSION_ID", meta.parent_session_id ?? "host-root"],
         ["AITERM_AGENT_DEPTH", String(meta.delegation_depth ?? 1)],
@@ -4958,6 +5666,7 @@ function agentEnvPrefix(meta, sid, envVars = []) {
             `AITERM_SESSION_ID=${shq(sid)}`,
             `AITERM_AGENT_SESSION_ID=${shq(sid)}`,
             `AITERM_AGENT_LAUNCH_ID=${shq(meta.launch_id)}`,
+            ...agentVendorSessionEnv(meta).map(([name, value]) => `${name}=${shq(value)}`),
             `AITERM_AGENT_ROLE=${shq(meta.agent_role ?? "subagent")}`,
             `AITERM_AGENT_PARENT_SESSION_ID=${shq(meta.parent_session_id ?? "host-root")}`,
             `AITERM_AGENT_DEPTH=${shq(String(meta.delegation_depth ?? 1))}`,
@@ -5129,8 +5838,9 @@ export function openAgent(kind, opts = {}) {
         if (model)
             assertGrokModelAvailable(bin, cwd ?? process.cwd(), model);
     }
+    const cursorFast = kind === "cursor" && opts.cursor_fast === true;
     if (kind === "cursor" && model) {
-        assertCursorModelAvailable(bin, cwd ?? process.cwd(), model, effort);
+        assertCursorModelAvailable(bin, cwd ?? process.cwd(), model, effort, cursorFast);
     }
     let sid;
     let hint;
@@ -5160,16 +5870,19 @@ export function openAgent(kind, opts = {}) {
             : null;
         if (meta) {
             meta.agent_executable = bin;
+            // 席は通常の速度で始まる（Claude Code・Codexは起動の引数で明示する）。fast版のmodel IDで起こした時だけtrue。
+            meta.fast = opts.fast_state === true;
+            meta.model = opts.base_model !== undefined ? opts.base_model : model;
             writeAgentMetadata(meta);
             agentMetadataNegativeCache.delete(sid);
         }
         launchNote = buildAgentLaunchNote(kind, model, effort, meta);
         let full;
         if (paneShell === "pwsh" && meta) {
-            full = cursorPwshLaunchLine(cwd, cursorAgentEnvEntries(meta, sid, envVars), cursorAgentArgv(bin, model, effort, opts.prompt ?? null, meta));
+            full = cursorPwshLaunchLine(cwd, cursorAgentEnvEntries(meta, sid, envVars), cursorAgentArgv(bin, model, effort, opts.prompt ?? null, meta, cursorFast));
         }
         else {
-            const cmd = buildAgentCmd(kind, binForCmd, model, effort, opts.prompt ?? null, meta);
+            const cmd = buildAgentCmd(kind, binForCmd, model, effort, opts.prompt ?? null, meta, cursorFast);
             const envPrefix = agentEnvPrefix(meta, sid, envVars);
             full = cwdForCmd ? `cd ${shq(cwdForCmd)} && ${envPrefix}${cmd}` : `${envPrefix}${cmd}`;
         }
@@ -5248,25 +5961,82 @@ export async function openAgentWithInitialPrompt(kind, opts = {}) {
     if (opts.launch_operation_id != null && prompt !== null) {
         throw new AitermError("launch_operation_idはpromptなしのClaude相関launchだけで指定できます", 2);
     }
+    // ファスト（ADR 0114）。設定の誤りは席を作る前に断る。fastへ出来ない訳がアカウントの都合なら、通常で起こして返りへ訳を入れる。
+    const requestedModel = opts.model == null ? null : opts.model.trim() || null;
+    const fastPlan = await planLaunchFast(kind, {
+        model: requestedModel, effort: opts.reasoning_effort ?? null, fast: opts.fast ?? null, cwd: opts.cwd ?? null,
+    });
+    const fastResult = { fast: fastPlan.state, fast_error: fastPlan.fast_error };
+    const openOptions = {
+        session_name: opts.session_name ?? null,
+        // modelは呼び手の渡した形のまま渡す（空文字の断りはopenAgentがする）。Grokのfastだけ、fast版のIDへ替える。
+        model: fastPlan.model !== requestedModel ? fastPlan.model : opts.model ?? null,
+        reasoning_effort: opts.reasoning_effort ?? null,
+        cwd: opts.cwd ?? null,
+        prompt: null,
+        agent_done: true,
+        launch_operation_id: opts.launch_operation_id ?? null,
+        write_scope: opts.write_scope,
+        env_vars: opts.env_vars,
+        cursor_fast: fastPlan.cursor_fast,
+        fast_state: fastPlan.state,
+        base_model: requestedModel,
+    };
+    // GrokとCursorは、起動の --model の値を利用者の既定へ書く（Cursorは版による）。起動の前後で、直前の値へ戻す。
+    const launch = () => {
+        if (kind === "grok") {
+            const configPath = grokUserConfigPath(realGrokHome());
+            // Grokは起動完了の直後に書く（入力待ちと読める頃には書き終えている）。
+            return launchKeepingUserDefaults(configPath, {
+                restore: restoreGrokDefaults(configPath), written: grokDefaultsWritten, mustWrite: () => false, ready: grokTuiReady,
+            }, () => openAgent(kind, openOptions));
+        }
+        if (kind === "cursor" && openOptions.model) {
+            const configPath = cursorUserConfigPath(realCursorHome());
+            // Cursorは、既定のmodelを設定に持つ端末（selectedModel の項目がある）で、起動の --model を既定へ書く。書くのは、入力待ちになった後の事がある。
+            return launchKeepingUserDefaults(configPath, {
+                restore: restoreCursorDefaults(configPath), written: cursorDefaultsWritten,
+                mustWrite: (before) => { const config = parseJsonObject(before); return config !== null && "selectedModel" in config; },
+                ready: cursorTuiReady,
+            }, () => openAgent(kind, openOptions));
+        }
+        return Promise.resolve().then(() => openAgent(kind, openOptions));
+    };
+    // 入力待ちになった席を、その席の中でfastへ切り替える（Claude Code・Codex）。出来なかった訳は返りへ入れ、起動は続ける。
+    const switchAfterReady = async (name, meta) => {
+        if (!fastPlan.switch_after_ready)
+            return;
+        fastResult.fast_error = await applyLaunchFast(name, meta);
+        fastResult.fast = meta.fast === true;
+    };
     // v0.16.0: launcher は常に managed（Stop hook つき）で立つ。手動運転したい場合は
     // pty_open で素の PTY を開き、harness CLI を自分で send する。
     // prompt無しはTUIを起動するだけ。prompt有りはharnessを問わず、TUI ready確認後の
     // sendInitialAgentPromptへ一本化する。Grokの--verbatim argvはCLIが本文をqueueへ置いただけで
     // turnを開始しない版があり、event_cursor=0を「実行中」と返すと利用側へ嘘をつく。
     if (!prompt) {
-        const [sid, hint] = openAgent(kind, {
-            session_name: opts.session_name ?? null,
-            model: opts.model ?? null,
-            reasoning_effort: opts.reasoning_effort ?? null,
-            cwd: opts.cwd ?? null,
-            prompt: null,
-            agent_done: true,
-            launch_operation_id: opts.launch_operation_id ?? null,
-            write_scope: opts.write_scope,
-            env_vars: opts.env_vars,
-        });
+        const [sid, hint] = await launch();
         const delivery = { status: "not_requested", reason: "not_requested", turn_started: false };
         let startup = { status: "not_checked", reason: "startup_not_requested" };
+        if (opts.trust_project !== true && fastPlan.switch_after_ready) {
+            // 起動の準備待ちを頼まれていなくても、切り替えは入力待ちの席にしか打てない。待って、なれなければ通常のまま返す。
+            const meta = loadAgentMetadata(sid);
+            let ready = { status: "blocked", reason: "startup_failed" };
+            try {
+                ready = await prepareAgentInput(sid, meta, { ready_timeout: opts.ready_timeout ?? undefined });
+            }
+            catch { /* 訳は下の fast_error で返す */ }
+            if (ready.status === "ready") {
+                startup = ready;
+                await switchAfterReady(sid, meta);
+            }
+            else {
+                fastResult.fast_error = {
+                    code: "FAST_MODE_UNCONFIRMED",
+                    message: `FAST_MODE_UNCONFIRMED: 席が入力待ちにならず（reason=${ready.reason}）、fastへ切り替えていません。席は通常の速度です。`,
+                };
+            }
+        }
         if (opts.trust_project === true) {
             try {
                 startup = await prepareAgentInput(sid, loadAgentMetadata(sid), {
@@ -5278,28 +6048,20 @@ export async function openAgentWithInitialPrompt(kind, opts = {}) {
             }
             if (startup.status !== "ready")
                 throw new AgentLaunchPromptError(`session_id: ${sid}\n起動準備を完了できませんでした。reason=${startup.reason}${startupBlockedHint(startup.reason)}`, 2, sid, delivery, null, startup);
+            await switchAfterReady(sid, loadAgentMetadata(sid));
         }
-        return [sid, hint, null, null, delivery, startup];
+        return [sid, hint, null, null, delivery, startup, fastResult];
     }
-    const [sid, hint] = openAgent(kind, {
-        session_name: opts.session_name ?? null,
-        model: opts.model ?? null,
-        reasoning_effort: opts.reasoning_effort ?? null,
-        cwd: opts.cwd ?? null,
-        prompt: null,
-        agent_done: true,
-        launch_operation_id: opts.launch_operation_id ?? null,
-        write_scope: opts.write_scope,
-        env_vars: opts.env_vars,
-    });
+    const [sid, hint] = await launch();
     try {
         const initial = await sendInitialAgentPrompt(sid, prompt, {
             ready_timeout: opts.ready_timeout ?? undefined,
             trust_project: opts.trust_project,
             before_send: opts.before_send,
+            after_ready: switchAfterReady,
         });
         return [sid, `${hint}\n${initial.text}`, initial.event_cursor, initial.submit_residue, initial.initial_prompt,
-            { status: "ready", reason: "composer_ready" }];
+            { status: "ready", reason: "composer_ready" }, fastResult];
     }
     catch (e) {
         const code = e instanceof AitermError ? e.code : 1;