aiterm-mcp 0.58.2 → 0.58.3

package/CHANGELOG.md

@@ -7,6 +7,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.58.3] - 2026-10-12
+
+### 修正
+
+- `agent_configure`が、Claude Codeの席のmodel／effortを替える時に、端末の`~/.claude/settings.json`の既定を書き換えていた件を直す（ADR 0111）。
+  今までは`/model <名前>`と`/effort <値>`を打っていた。Claude Code（2.1.293・2.1.296で見た）は、この2つで選んだ値を
+  「新しい会話の既定」として保存する（`model`と、`modelSettings.<機種>.effortLevel`）。1つの席を替えただけで、その端末でこの後に
+  引数なしで立つ全部のClaude Codeの既定が変わり、利用者が自分で決めた既定も上書きしていた。
+  - `/model`を引数なしで開いた選ぶ画面を読み、行とeffortを合わせて、`s`（use this session only）で選ぶ。Enter（set as default）は押さない。
+  - 会話がcacheされている席で出る「Switch model?」の確かめは、1番（Yes, switch to …）が選ばれている時だけ進める。
+  - `model`は、catalogのID（`claude-opus-5-5`）、別名（`opus`）、表示名（`Opus 5.5`）のどれでも受ける。
+  - 選べない時は、選ぶ画面をEscで閉じて、何も変えずに断る。`s`の選び方が無い版では、保存する選び方へ落ちずに断る
+    （`CLAUDE_MODEL_SESSION_ONLY_UNAVAILABLE`）。選ぶ画面に無いmodelは`CLAUDE_MODEL_NOT_IN_PICKER`（文に選べる機種を並べる）、
+    行はあるが選べないmodel（席のClaude Codeが古い時の「Update Claude Code to use this model」）は`CLAUDE_MODEL_NOT_SELECTABLE`、
+    そのmodelで選べないeffortは`CLAUDE_EFFORT_NOT_SELECTABLE`。今までは、Claude Codeが受け付けない値でも成功で返っていた。
+  - `reasoning_effort`が`low`/`medium`/`high`/`xhigh`/`max`/`ultracode`のどれでもない時は、打つ前に断る。
+  - 引数と返りの形（`aiterm.agent-configure-result.v1`）、Codex・Grok・Cursorの席の動きは変わらない。
+  - 「この会話だけ」の替えなので、席を閉じて立て直すと端末の既定へ戻る。立て直す時は`agent_launch`へ同じ値を渡す。
+  - 選ぶ画面に無いmodel（`opus[1m]`のような名前、古い機種のID）は、動いている席では替えられなくなる。今までは`/model <名前>`で通っていた
+    （端末の既定へ保存されていた）。席を閉じて、`agent_launch`の`model`で渡して立て直す。
+
+### 追加
+
+- `pty_list`の構造の返り（`aiterm.pty-list-result.v1`）の席ごとの項目に、harness側の会話ID`vendor_session_id`を足す。
+  Claude CodeとGrokは起動時に`--session-id`で渡した値（席の中で会話を移した後は追わない）、CodexとCursorは掴んだ後の値。
+  通常PTYと、まだ分からない席は`null`。文字の返りには前から載っていた。`remote`の先が0.58.2以前の時は、項目そのものが無い。
+
 ## [0.58.2] - 2026-10-11
 
 ### 修正
@@ -2497,7 +2524,8 @@ prototype (preserved under `prototype/python/` as the porting source and referen
   `ubuntu-latest` for Node 18/20/22, publishing to npm on `v*` tags with
   provenance.
 
-[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.58.2...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.58.3...HEAD
+[0.58.3]: https://github.com/kitepon/aiterm-mcp/compare/v0.58.2...v0.58.3
 [0.58.2]: https://github.com/kitepon/aiterm-mcp/compare/v0.58.1...v0.58.2
 [0.58.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.58.0...v0.58.1
 [0.58.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.57.4...v0.58.0

package/README.ja.md

@@ -209,7 +209,7 @@ runtime-error store は canonical dotagents config の `collection.enabled: true
 場合だけ収集し、既定OFF、network送信は行いません。tag起点CIのnpm provenance（OIDC Trusted
 Publishing）で公開し、GitHub Release が Official MCP Registry を再登録します。
 
-**状態:** 開発継続中 · 現行公開版 **v0.58.2** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.58.3** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 

package/README.md

@@ -227,7 +227,7 @@ collection is off by default and performs no network I/O. It ships via
 tag-triggered CI with npm provenance (OIDC Trusted Publishing); the GitHub
 Release re-registers the Official MCP Registry entry.
 
-**Status:** actively maintained · current public release **v0.58.2** · runs on Linux · WSL2 · macOS · native Windows (tmux on POSIX, the tmux-CLI-compatible [psmux](https://github.com/psmux/psmux) on native Windows — no WSL required) · MIT · see the [CHANGELOG](CHANGELOG.md).
+**Status:** actively maintained · current public release **v0.58.3** · runs on Linux · WSL2 · macOS · native Windows (tmux on POSIX, the tmux-CLI-compatible [psmux](https://github.com/psmux/psmux) on native Windows — no WSL required) · MIT · see the [CHANGELOG](CHANGELOG.md).
 
 ### Update and rollback
 
@@ -622,7 +622,7 @@ continue to use `claude_approval`.
 | `pty_read` | Read output, token-reduced (incremental by default) | `session_id`, `wait`, `until`, `until_regex`, `timeout`, `screen`, `full`, `lines`, `line_range`, `raw`, `rtk`, `agent_transcript`, `operation_id` |
 | `pty_key` | Send a control key | `session_id`, `key` (`C-c`/`Enter`/`Up`…) |
 | `pty_close` | Close idempotently; return `closed` / `already_closed` | `session_id` |
-| `pty_list` | Text and structured session list, with explicitly requested non-secret environment values | `env_keys?` |
+| `pty_list` | Text and structured session list (each agent session carries its harness conversation ID as `vendor_session_id`), with explicitly requested non-secret environment values | `env_keys?` |
 | `pty_observe` | Pane/harness liveness, native process identity, state, and activity | `session_id`, `cursor?` |
 | `agent_launch` | Canonical agent launch; harness and model are independent | `harness`, `prompt?`, `model?`, `reasoning_effort?`, `cwd?`, `write_scope?`, `trust_project?`, `env_vars?`, `throughline_source_session?`, `throughline_supplement_file?` |
 | `agent_auth` | 公式CLIの認証を開始・確認・取消し、公式URL・device code・入力待ちを返す | `harness`, `action`, `session_id?`, `cwd?`, `env_vars?`, `relogin?` |
@@ -664,6 +664,8 @@ enables collection on that host.
 
 `agent_configure({ session_id, model?, reasoning_effort? })` changes a running Claude, Codex, Grok, or Cursor TUI through the harness's standard controls, preserving the PTY and conversation context.
 
+Claude Codeの席では、`/model`の選ぶ画面の`s`（use this session only）で替える。`/model <名前>`・`/effort <値>`は選んだ値を端末の`~/.claude/settings.json`へ新しい会話の既定として保存するので、打たない（ADR 0111）。その選び方が無い版、選ぶ画面に無いmodel、そのmodelで選べないeffortは、何も変えずに断る（`CLAUDE_MODEL_SESSION_ONLY_UNAVAILABLE`・`CLAUDE_MODEL_NOT_IN_PICKER`・`CLAUDE_EFFORT_NOT_SELECTABLE`）。席を閉じて立て直すと端末の既定へ戻るので、立て直す時は`agent_launch`へ同じ`model`・`reasoning_effort`を渡す。
+
 `agent_auth({ harness, action:"start"|"status"|"cancel", session_id?, cwd?, env_vars?, relogin? })`は、各harnessの公式CLIで認証を進める。Claudeは`claude auth login`、CodexとGrokは`login --device-auth`、Cursorは`NO_OPEN_BROWSER=1 cursor-agent login`を使い、資格情報は各CLIだけが保存する。Aitermは資格情報を読取り・copy・編集せず、独自OAuthも実装しない。`remote`は他toolと同じ標準対応。
 
 `start`は、公式の状態が認証済みなら何も起こさず`authenticated`（`session_id:null`）を返す。`relogin:true`を付けると、認証済みに見えても公式ログインを開始し、`session_id`付きの結果を返す。別のアカウントへ入り直す時と、ログインの期限切れを状態から見抜けない時に使う。Aitermは資格情報を消さず、置き換えは公式CLIが行う。ただし、公式CLIがログインを始めた時点で元のログインを消す事がある（Codex 0.160.0の`codex login --device-auth`は、始めた時点で`auth.json`を消す。途中で`cancel`しても戻らない）。Claude CodeとCursorは、途中で`cancel`すれば元の資格情報が残る（無効な資格情報で確認）。

package/dist/core.js

@@ -23,7 +23,7 @@ import { sleep, currentUid, runtimeStateBase, safeStatSize, readFileRange, write
 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, claudeStartupAction, claudeLoginMethodMenu, CLAUDE_COMPOSER_MARKER_RE, createClaudeAgentMetadata, claudeSessionTranscriptPath, claudeApiErrorFromLine, claudeApiErrorAfter, } from "./harnesses/claude.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 { readInterimWords, recordInterimBoundary } from "./interim-words.js";
 import { resolveAgentBin, resolveThroughlineBin, runThroughlineHandoffContext, isWindowsNativeExecutable, agentBinForPaneShell, resolveWinPaneShell } from "./agent-resolver.js";
@@ -1338,7 +1338,8 @@ export function listSessionsResult(envKeys = []) {
             }
             const meta = tryLoadAgentMetadata(name);
             sessions.push({ session_id: name, current_command: normalizePaneCommand(command), attached: Number(attached) > 0,
-                width: Number(width), height: Number(height), harness: meta ? agentHarness(meta.kind) : null, environment });
+                width: Number(width), height: Number(height), harness: meta ? agentHarness(meta.kind) : null,
+                vendor_session_id: meta?.vendor_session_id ?? null, environment });
         }
     return { schema: "aiterm.pty-list-result.v1", observed_at: new Date().toISOString(), sessions };
 }
@@ -4119,6 +4120,166 @@ export async function listAgentModels(kind, options = {}) {
         case "cursor": return cursorModelChoices(bin, cwd);
     }
 }
+const CLAUDE_MODEL_PICKER_TIMEOUT_MS = 8_000;
+const CLAUDE_MODEL_PICKER_KEY_TIMEOUT_MS = 1_500;
+const CLAUDE_MODEL_SWITCH_TIMEOUT_MS = 15_000;
+const CLAUDE_EFFORT_ORDER = ["low", "medium", "high", "xhigh", "max"];
+/**
+ * Claude Codeの席のmodel／effortを、この会話だけで替える（ADR 0111）。
+ * `/model <名前>` と `/effort <値>` は、選んだ値を端末の ~/.claude/settings.json へ新しい会話の既定として保存する
+ * （2.1.296で確かめた）。引数なしの `/model` の選ぶ画面で s を押すと保存されないので、画面を1歩ずつ読んでそちらを打つ。
+ * 保存しない選び方が画面に無い時、行やeffortを選べない時は、Escで閉じて何も変えずに断る。
+ */
+async function configureClaudeForSessionOnly(name, meta, model, effort) {
+    const screen = () => captureScreen(name, AGENT_TUI_READY_LINES);
+    const until = async (read, timeoutMs) => {
+        const deadline = performance.now() + timeoutMs;
+        do {
+            const got = read();
+            if (got)
+                return got;
+            await sleep(100);
+        } while (performance.now() < deadline);
+        return null;
+    };
+    // Escは、選ぶ画面か確かめの画面が出ている間だけ打つ（入力欄へ戻った後のEscは、ほかの操作を取り消してしまう）。
+    const refuse = async (code, reason) => {
+        for (let i = 0; i < 3; i++) {
+            const now = screen();
+            if (!claudeModelPicker(now) && !claudeModelSwitchConfirm(now))
+                break;
+            sendMenuChoice(name, "Escape");
+            await sleep(300);
+        }
+        throw new AitermError(`${code} vendor=claude session=${name}\n${reason}。modelとreasoning_effortは変えていません。`, 2);
+    };
+    const picker = () => claudeModelPicker(screen());
+    const cursorOf = (p) => p?.rows.find((row) => row.cursor) ?? null;
+    // 1回押して、画面の今の行かeffortが変わるまで待つ。変わらなければnull（端で止まった・キーが落ちた）。
+    // キーが落ちる事があるので、変わらなければ1度だけ押し直す。
+    const press = async (key, changed) => {
+        for (let attempt = 0; attempt < 2; attempt++) {
+            sendMenuChoice(name, key);
+            const next = await until(() => { const p = picker(); return p && changed(p) ? p : null; }, CLAUDE_MODEL_PICKER_KEY_TIMEOUT_MS);
+            if (next)
+                return next;
+        }
+        return null;
+    };
+    await sendAgentPromptText(name, "/model");
+    let now = await until(picker, CLAUDE_MODEL_PICKER_TIMEOUT_MS);
+    if (!now) {
+        // 読めない形の画面が開いたままだと、席が次の文を受け取れない。入力待ちでも動作中でもない時だけ、Escを1度打って閉じる。
+        let state = claudePaneObservation(screen());
+        if (state.state === "unknown") {
+            sendMenuChoice(name, "Escape");
+            await sleep(500);
+            state = claudePaneObservation(screen());
+        }
+        throw new AitermError(`CLAUDE_MODEL_PICKER_NOT_SHOWN vendor=claude session=${name} state=${state.state}/${state.reason}\n` +
+            "Claude Codeの /model の選ぶ画面を読めません（Claude Codeの版で画面の形が変わった見込み）。modelとreasoning_effortは変えていません。", 2);
+    }
+    if (!now.session_only) {
+        return refuse("CLAUDE_MODEL_SESSION_ONLY_UNAVAILABLE", "このClaude Codeの /model の選ぶ画面に、この会話だけで使う選び方（s to use this session only）がありません。" +
+            "端末の既定を書き換える選び方は使いません");
+    }
+    let targetIndex = null;
+    if (model) {
+        // 見えていない行は、下へ送りながら集める（一周するか、端で止まるまで）。
+        const known = new Map(now.rows.map((row) => [row.index, row]));
+        const start = cursorOf(now);
+        if (!start)
+            return refuse("CLAUDE_MODEL_PICKER_UNREADABLE", "選ぶ画面の今の行を読めません");
+        let at = start.index;
+        const seen = new Set([at]);
+        for (let i = 0; i < 80; i++) {
+            const before = at;
+            const next = await press("Down", (p) => { const c = cursorOf(p); return !!c && c.index !== before; });
+            if (!next)
+                break;
+            now = next;
+            for (const row of next.rows)
+                known.set(row.index, row);
+            at = cursorOf(next).index;
+            if (seen.has(at))
+                break;
+            seen.add(at);
+        }
+        const target = claudeModelPickerRow([...known.values()], model);
+        if (!target) {
+            const names = [...known.values()].sort((a, b) => a.index - b.index).map((row) => row.label).join(", ");
+            return refuse("CLAUDE_MODEL_NOT_IN_PICKER", `Claude Codeの /model の選ぶ画面に ${model} がありません（選べる機種: ${names}）`);
+        }
+        for (let i = 0; i < 80 && at !== target.index; i++) {
+            const before = at;
+            const next = await press(target.index > at ? "Down" : "Up", (p) => { const c = cursorOf(p); return !!c && c.index !== before; });
+            if (!next)
+                break;
+            now = next;
+            at = cursorOf(next).index;
+        }
+        if (at !== target.index)
+            return refuse("CLAUDE_MODEL_PICKER_UNREADABLE", `選ぶ画面で ${target.label} の行へ動けません`);
+        // 起きた後にClaude Codeが更新された席では、「Update Claude Code to use this model」の行が出る。その行にはEnterもsも無い。
+        if (!now.session_only) {
+            return refuse("CLAUDE_MODEL_NOT_SELECTABLE", `${target.label} は、この席のClaude Codeでは選べません（選ぶ画面のその行に、選ぶためのキーが出ていません。席のClaude Codeが古い見込み）`);
+        }
+        targetIndex = target.index;
+    }
+    if (effort) {
+        const wanted = CLAUDE_EFFORT_ORDER.indexOf(effort);
+        const row = cursorOf(now)?.label ?? model ?? "このmodel";
+        // そのmodelに無い段は飛ばされて行き来になるので、回数で打ち切る。
+        for (let i = 0; i < CLAUDE_EFFORT_ORDER.length + 3 && now.effort !== effort; i++) {
+            const current = now.effort;
+            const from = current === null ? -1 : CLAUDE_EFFORT_ORDER.indexOf(current);
+            if (from < 0)
+                return refuse("CLAUDE_EFFORT_NOT_SELECTABLE", `${row} では reasoning_effort を選べません`);
+            const next = await press(wanted > from ? "Right" : "Left", (p) => p.effort !== current);
+            if (!next)
+                break;
+            now = next;
+        }
+        if (now.effort !== effort)
+            return refuse("CLAUDE_EFFORT_NOT_SELECTABLE", `${row} では reasoning_effort=${effort} を選べません`);
+    }
+    // 打つ直前に、もう1度読んで確かめる。
+    const last = picker();
+    const lastRow = cursorOf(last);
+    if (!last || !lastRow || !last.session_only
+        || (targetIndex !== null && lastRow.index !== targetIndex)
+        || (effort && last.effort !== effort)) {
+        return refuse("CLAUDE_MODEL_PICKER_UNREADABLE", "選ぶ直前の画面が、選んだ行・effortと合いません");
+    }
+    sendMenuChoice(name, "s");
+    let confirmed = false;
+    const result = await until(() => {
+        const text = screen();
+        const confirm = claudeModelSwitchConfirm(text);
+        if (confirm === "yes_selected" && !confirmed) {
+            // 会話が今のmodelでcacheされている時の確かめ。1番（Yes, switch）が選ばれている時だけ進める。
+            confirmed = true;
+            sendMenuChoice(name, "Enter");
+            return null;
+        }
+        if (confirm || claudeModelPicker(text))
+            return null;
+        return claudeModelSwitchResult(text);
+    }, CLAUDE_MODEL_SWITCH_TIMEOUT_MS);
+    if (!result)
+        return refuse("CLAUDE_MODEL_SWITCH_UNCONFIRMED", "Claude Codeの切り替えの知らせを確認できません");
+    if (result.scope === "saved_as_default") {
+        throw new AitermError(`CLAUDE_MODEL_SAVED_AS_DEFAULT vendor=claude session=${name}\n` +
+            `Claude Codeが、選んだ値を端末の既定として保存したと返しました（${result.line}）。~/.claude/settings.json を確かめてください。`, 2);
+    }
+    if (result.scope !== "session_only") {
+        throw new AitermError(`CLAUDE_MODEL_SWITCH_REFUSED vendor=claude session=${name}\n` +
+            `Claude Codeがmodelを切り替えませんでした（${result.line}）。modelとreasoning_effortは変えていません。`, 2);
+    }
+    const ready = await waitAgentTuiReady(name, meta, AGENT_TUI_READY_TIMEOUT_MS);
+    if (!ready.ready)
+        throw new AitermError("Claudeのmodel変更完了を確認できません", 2);
+}
 export async function configureAgent(name, opts) {
     assertSessionName(name);
     const model = opts.model?.trim() || null;
@@ -4138,13 +4299,14 @@ export async function configureAgent(name, opts) {
         throw new AitermError(`agent session '${name}' は入力待ちではありません`, 2);
     }
     if (meta.kind === "claude") {
-        if (model) {
-            await sendAgentPromptText(name, `/model ${model}`);
-            const modelReady = await waitAgentTuiReady(name, meta, AGENT_TUI_READY_TIMEOUT_MS);
-            if (!modelReady.ready)
-                throw new AitermError(`Claudeのmodel変更完了を確認できません`, 2);
-        }
-        if (effort) {
+        // ultracodeはClaude Codeが自分で「this session only」と返すsession設定で、選ぶ画面には出ない。
+        const level = effort && CLAUDE_EFFORTS.has(effort) ? effort : null;
+        if (effort && !level && effort !== "ultracode") {
+            throw new AitermError("Claude Code の reasoning_effort は low/medium/high/xhigh/max/ultracode のいずれかです。設定は変えていません。", 2);
+        }
+        if (model || level)
+            await configureClaudeForSessionOnly(name, meta, model, level);
+        if (effort && !level) {
             await sendAgentPromptText(name, `/effort ${effort}`);
             const effortReady = await waitAgentTuiReady(name, meta, AGENT_TUI_READY_TIMEOUT_MS);
             if (!effortReady.ready)

package/dist/harnesses/claude.js

@@ -373,6 +373,97 @@ export function claudeUsageLimit(screen) {
     }
     return null;
 }
+function lastLineIndex(lines, re) {
+    for (let i = lines.length - 1; i >= 0; i--)
+        if (re.test(lines[i]))
+            return i;
+    return -1;
+}
+export function claudeModelPicker(screen) {
+    const lines = screen.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, "").split(/\r?\n/u);
+    const head = lastLineIndex(lines, /^\s*Select model\s*$/u);
+    if (head < 0)
+        return null;
+    const body = lines.slice(head + 1);
+    const foot = body.findIndex((line) => /\bEsc to cancel\b/u.test(line));
+    if (foot < 0)
+        return null;
+    const rows = [];
+    let effort = null;
+    for (const line of body.slice(0, foot)) {
+        const row = /^\s*([❯↓↑]\s+)?(\d+)\.\s+(.*?)\s*$/u.exec(line);
+        if (row) {
+            const name = row[3].split(/\s{2,}/u)[0];
+            rows.push({
+                index: Number(row[2]),
+                label: name.replace(/\s*✔$/u, ""),
+                cursor: row[1]?.includes("❯") === true,
+                current: /✔$/u.test(name),
+            });
+            continue;
+        }
+        const level = /(?:^|\s)(low|medium|high|xhigh|max) effort\b/iu.exec(line);
+        if (level)
+            effort = level[1].toLowerCase();
+    }
+    if (rows.length === 0)
+        return null;
+    return { rows, effort, session_only: /\bs to use this session only\b/u.test(body[foot]) };
+}
+/**
+ * 指定されたmodel（catalogのID・別名・表示名）が、選ぶ画面のどの行かを決める。
+ * `claude-opus-5-5` は「Opus 5.5」、別名の `opus` はその系統で番号が一番若い行（catalogの並びで最新）。
+ */
+export function claudeModelPickerRow(rows, model) {
+    const want = model.trim().toLowerCase();
+    const sorted = [...rows].sort((a, b) => a.index - b.index);
+    const id = /^claude-([a-z]+)-(\d+)(?:-(\d{1,2}))?(?:-\d{8})?$/u.exec(want);
+    const name = id ? `${id[1]} ${id[2]}${id[3] ? `.${id[3]}` : ""}` : want;
+    return sorted.find((row) => row.label.toLowerCase() === name)
+        ?? (want === "default" ? sorted.find((row) => /^default\b/iu.test(row.label)) : undefined)
+        ?? (/^[a-z]+$/u.test(want) ? sorted.find((row) => row.label.toLowerCase().startsWith(`${want} `) && /^\S+ \d/u.test(row.label)) : undefined)
+        ?? null;
+}
+// 会話が今のmodelでcacheされている時だけ、sの後に出る確かめ（2.1.293・2.1.296）。
+//   Switch model?
+//   Your next response will be slower and use more tokens
+//   ❯ 1. Yes, switch to Opus 5.5
+//     2. No, go back
+export function claudeModelSwitchConfirm(screen) {
+    const lines = screen.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, "").split(/\r?\n/u);
+    const head = lastLineIndex(lines, /^\s*Switch model\?\s*$/u);
+    if (head < 0)
+        return null;
+    const body = lines.slice(head + 1);
+    if (!body.some((line) => /^\s*(?:❯\s*)?1\.\s*Yes, switch to\b/u.test(line)))
+        return null;
+    return body.some((line) => /^\s*❯\s*1\.\s*Yes, switch to\b/u.test(line)) ? "yes_selected" : "other_selected";
+}
+export function claudeModelSwitchResult(screen) {
+    const lines = screen.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, "").split(/\r?\n/u);
+    const command = lastLineIndex(lines, /^\s*❯\s*\/model\s*$/u);
+    if (command < 0)
+        return null;
+    const start = lines.findIndex((line, i) => i > command && /^\s*⎿\s+\S/u.test(line));
+    if (start < 0)
+        return null;
+    const parts = [lines[start].replace(/^\s*⎿\s+/u, "").trim()];
+    for (const line of lines.slice(start + 1)) {
+        if (!/^\s{3,}\S/u.test(line) || /^\s*⎿/u.test(line))
+            break;
+        parts.push(line.trim());
+    }
+    const line = parts.join(" ");
+    if (/\bblocked by a PreModelSwitch hook\b/u.test(line))
+        return { scope: "blocked", line };
+    if (/^Kept model as\b/u.test(line))
+        return { scope: "kept", line };
+    if (!/^(?:Set model to|Model set to)\b/u.test(line))
+        return null;
+    if (/\bsaved as your default\b/u.test(line))
+        return { scope: "saved_as_default", line };
+    return /\bfor this session only\b/u.test(line) ? { scope: "session_only", line } : null;
+}
 // Claude Code 2.1.282 は選択肢へ「1.」などの番号を付ける。番号の有無のどちらも受ける。
 export function claudeLoginMethodMenu(screen) {
     const tail = screen.split("\n").slice(-32).join("\n");

package/dist/index.js

@@ -618,6 +618,9 @@ registerRemoteAwareTool("pty_list", {
             session_id: z.string(), current_command: z.string(), attached: z.boolean(),
             width: z.number(), height: z.number(),
             harness: z.enum(["claude-code", "codex-cli", "grok-cli", "cursor-cli"]).nullable(),
+            // 0.58.3より前の現地（remote）は返さないので、無い事も受ける。
+            vendor_session_id: z.string().nullable().optional().describe("agent sessionのharness側の会話ID。Claude CodeとGrokは起動時に--session-idで渡した値（席の中で会話を移した後は追わない）、" +
+                "CodexとCursorは分かった後の値。通常PTYと、まだ分からない席はnull"),
             environment: z.record(z.string(), z.string().nullable()),
         })),
     },
@@ -833,7 +836,9 @@ registerRemoteAwareTool("agent_auth", {
 });
 registerRemoteAwareTool("agent_configure", {
     description: "起動済みのClaude／Codex／Grok／Cursor agent sessionを再起動せず、会話contextを保ったままmodel／reasoning effortを変更する。" +
-        "各harnessのCLI標準model操作を使う。Cursorのreasoning_effort変更はmodelと同時指定する。",
+        "各harnessのCLI標準model操作を使う。Cursorのreasoning_effort変更はmodelと同時指定する。" +
+        "Claude Codeの席では /model の選ぶ画面の「この会話だけ」（s）で替え、端末の ~/.claude/settings.json の既定は書き換えない。" +
+        "その選び方が無い版、選ぶ画面に無いmodel、そのmodelで選べないeffortは、何も変えずに断る。",
     inputSchema: {
         session_id: z.string().regex(/^[A-Za-z0-9_-]{1,64}$/),
         model: z.string().min(1).nullish().describe("変更後のmodel。省略時はmodelを変更しない"),

package/docs/DESIGN.md

@@ -37,7 +37,8 @@ UTF-8のBase64を復元したscriptblockのdot-sourceを使う。変数と作業
 sentinelの方言は端末runtimeが実効shellから決める。SSH先の現在の標準PowerShell promptを
 検出した場合は、Aiterm hostのOSに関係なくPowerShell構文を使う。過去のpromptでは切り替えない。
 
-`pty_list`はtextと構造化したsession一覧を返す。`env_keys`は帰属等の非秘密キーの明示照会だけで、
+`pty_list`はtextと構造化したsession一覧を返す。agent sessionには、harness側の会話ID（`vendor_session_id`。Claude CodeとGrokは
+起動時に`--session-id`で渡した値、CodexとCursorは掴んだ後の値）を載せる。`env_keys`は帰属等の非秘密キーの明示照会だけで、
 psmuxが出力した余分な環境値を返さない。通常PTYとagentへ`AITERM_SESSION_ID`を注入し、
 `env_vars`の継承とsessionへの登録もAitermが所有する。古いtmuxは子へのenv注入とsession登録を使う。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.58.2",
+  "version": "0.58.3",
   "mcpName": "io.github.kitepon/aiterm-mcp",
   "description": "Persistent terminal MCP with one harness-based launcher for Claude Code, Codex CLI, Grok CLI, and Cursor Agent CLI, plus durable PTYs for SSH, containers, and REPLs.",
   "keywords": [