aiterm-mcp 0.58.1 → 0.58.3

package/CHANGELOG.md

@@ -7,6 +7,54 @@ 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
+
+### 修正
+
+- Windowsで、sshの側（`remote`付きの呼び出しを含む）やserviceの下で立てた端末・席が、一覧から消えたり、途中で止められたりする件を直す（ADR 0109）。
+  psmux 3.3.8は、画面のある側でどの命令が呼ばれても、開けない本体の控えを「終わった物」として消す（psmux #650。直しは未公開）。
+  画面の無いlogonで立てた本体は、同じ利用者の画面のある側から開けないので、ほかの席が動くたびに控えが消えていた。
+  その間、Aitermは`missing / session_missing`や「paneの活動観測を取得できません」を返し、席ごと止められる事もあった
+  （Windowsの実物で、sshの側で立てたGrokの席が4回中2回、文を送った20秒ほど後に消えた）。
+  - 端末を立てた直後に、本体のprocessへ「同じ利用者が名前を問う権利」（`PROCESS_QUERY_LIMITED_INFORMATION`）だけを足す。画面のある側が本体を開けるようになり、控えは消されない。
+  - 足すのは、psmuxが3.3.8で、画面のあるlogonの印（`SESSIONNAME`）が無い時だけ。アプリや端末から起こしたAitermでは、何も起こさない。
+  - sshの側で端末を1つ立てるたびに、約0.35秒かかる。足せなかった時も端末は使え、理由を1行だけstderrへ書く。
+  - 更新の前に立てた端末には効かない。
+- Grokが文を受け取らなかった時に、待ち続けず、次の文と混ぜないようにする（ADR 0110）。
+  Grok（1.0.50）は、送った文を中のagentが受け取らないと、120秒で自分から取り消して、文を入力欄へ戻す。会話の記録には何も出ない
+  （Windowsでは、起こすstdioのMCPが8個以上の時に毎回こうなる。Grokの側の不具合で、これ自体はAitermでは直らない）。
+  - 完了待ちは、時間切れ（既定600秒）まで待たずに、結果なしの終了（`error`、exit 7）で返す。`error`の文に、Grokが受け取らなかった事を書く。
+  - 入力欄へ戻された文は、次の文を送る前に消す（返りの`pane_input_recovery`に`grok_unaccepted_prompt_cleared`）。今までは、前の文と次の文がつながって1通になっていた。
+  - 受け取り待ちの間（画面の「Waiting for the agent to accept the prompt」）に送った文は、差し込まずに、送らずに断る（`GROK_PROMPT_NOT_ACCEPTED_YET`）。
+    今までは差し込みの道へ入り、文がGrokの待ち行列に残っていた（`STEER_STILL_QUEUED`、または`agent_steer`で返っていた）。
+
 ## [0.58.1] - 2026-10-10
 
 ### 修正
@@ -2476,7 +2524,9 @@ 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.1...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
 [0.57.4]: https://github.com/kitepon/aiterm-mcp/compare/v0.57.3...v0.57.4

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.1** · 動作対象は 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.1** · 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

@@ -18,12 +18,12 @@ 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 { AitermError, telemetryOwnedFailure, ownTelemetryFailure } from "./errors.js";
-import { isWin, SOCKDIR, tmuxCommand, sendPsmuxPayload, loadPtyBufferChunk, pasteBufferBaseArgs, tmuxNewSession, registeredSessionEnvironment, attachCommand, normalizePaneCommand, atomicShellMultiline, appendMarkSentinel, markShellCommand, settlePaneLog, paneCwdArgument, sessionEnvironmentLaunch, } from "./tmux-runtime.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 { catalogUnavailable } from "./model-catalog.js";
-import { grokAuthPlan, grokAuthStatus, grokAuthPane, realGrokHome, resolveAndValidateGrokAuth, assertGrokModelAvailable, grokModelChoices, grokEventsTranscript, latestGrokCompletion, grokTurnSettled, observeGrokDone, buildGrokAgentCmd, grokLaunchNote, grokEnvTokens, grokTuiReady, grokTuiBusy, grokPaneObservation, grokRateLimitDialog, grokStartupAction, grokLaunchBlockingDialog, assertGrokSandboxNotRejected, GROK_COMPOSER_MARKER_RE, grokFooterHasConfiguration, grokTranscriptText, createGrokAgentMetadata, } from "./harnesses/grok.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";
@@ -695,6 +695,8 @@ export function openSession(name, shell = "bash", envVars = []) {
             const launch = sessionEnvironmentLaunch(shell, environment);
             const r = tmuxNewSession(true, nm, launch, environment.map(entry => entry.slice(0, entry.indexOf("="))));
             if (r.code === 0) {
+                // Windowsで、画面の無いlogon（ssh・service）で立てた本体の控えを、画面のある側のpsmuxに消させない（psmux 3.3.8）。
+                openPsmuxServerToDesktop(nm);
                 if (launch.register_after_start)
                     for (const entry of environment) {
                         const at = entry.indexOf("=");
@@ -1336,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 };
 }
@@ -3126,7 +3129,14 @@ export async function observeAgentDone(name, o = {}) {
         return observeCursorDone(meta, timeout, o.cursor, (session) => captureScreen(session, 0), o.signal);
     }
     if (meta.kind === "grok" && meta.completion_route === "grok_transcript") {
-        return observeGrokDone(meta, timeout, o.cursor, detectAgentRateLimit, o.signal);
+        // 上限の知らせと、受け取られなかった文の知らせは、同じ見回りで読んだ1枚の画面から見る（画面を読むたびにtmuxを起動する）。
+        let read = { at: -Infinity, screen: "" };
+        const screen = (session) => {
+            if (performance.now() - read.at > AGENT_RATE_LIMIT_POLL_MS / 4)
+                read = { at: performance.now(), screen: captureScreen(session, 0) };
+            return read.screen;
+        };
+        return observeGrokDone(meta, timeout, o.cursor, (_kind, session) => grokRateLimitDialog(screen(session))?.message ?? null, o.signal, session => grokUnacceptedPromptRestored(screen(session)));
     }
     const metadataFile = agentMetadataPath(meta.aiterm_session, meta.launch_id);
     // 境界の優先順: dispatch receipt の event_cursor（起動順序に依存しない）→ operation相関
@@ -4110,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;
@@ -4129,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)
@@ -4354,6 +4525,20 @@ async function dispatchAgentTurnInLock(name, text, o) {
         }
         sendKey(name, limitDialog.dismissKey);
     }
+    // Grokが受け取らずに入力欄へ戻した文が残っていると、次の文とつながって1通になる。送る前に消す。
+    // 入力欄に文がある時のC-cは、入力欄を空にするだけ（Grok 1.0.46・1.0.50実測）。空の時に押すと終了の構えになるので、文がある時だけ押す。
+    let grokRestoredPromptCleared = false;
+    if (meta.kind === "grok" && !limitDialog && grokUnacceptedPromptRestored(captureScreen(name, 0))) {
+        sendKey(name, "C-c");
+        for (let i = 0; i < 20 && !grokRestoredPromptCleared; i++) {
+            await sleep(100);
+            grokRestoredPromptCleared = !grokUnacceptedPromptRestored(captureScreen(name, 0));
+        }
+        if (!grokRestoredPromptCleared) {
+            throw new AitermError(`GROK_UNACCEPTED_PROMPT_NOT_CLEARED vendor=grok session=${name}\n` +
+                "Grokが受け取らずに入力欄へ戻した前の文を、消せませんでした。文字列は送信していません。pty_read(screen:true)で入力欄を確かめてください。", 2);
+        }
+    }
     if (meta.kind !== "claude" || claudeColdStart) {
         // 上限のpanelを閉じた直後（Grok）は、画面が落ち着くのを11回の確かめで待つ。
         const recovery = await waitAgentTuiReadyAfterCodexRateLimitRecovery(name, meta, o.ready_timeout ?? AGENT_TUI_READY_TIMEOUT_MS, { settledTurn: !limitDialog });
@@ -4380,6 +4565,8 @@ async function dispatchAgentTurnInLock(name, text, o) {
         paneInputRecovery.push("codex_rate_limit_model_switch_kept_current");
     if (limitDialog)
         paneInputRecovery.push("grok_rate_limit_dialog_dismissed");
+    if (grokRestoredPromptCleared)
+        paneInputRecovery.push("grok_unaccepted_prompt_cleared");
     const startOffset = agentCompletionCursor(meta);
     // promptなしで起動したCursorは、最初のdispatch時点ではtranscriptとの相関markerをまだ持たない。
     // その1回だけlaunch contextを加え、以後はbind済みconversationへ通常textだけを送る。
@@ -4539,6 +4726,12 @@ async function sendAgentMessageInLock(name, text, o) {
     // Codexは回答を流している間、画面に動作中の行を出さない。その間に届いた文を、Codexは動いているturnへ取り込む（ADR 0101）。
     if (!running && meta.kind === "codex" && await codexTurnRunningBehindIdleScreen(name, meta, screen))
         running = true;
+    // Grokが前の文をまだ受け取っていない間は、差し込む先の番が無い。待ち行列へ入れても動かず、Grokが前の文を取り消した後も残る。
+    if (running && meta.kind === "grok" && grokPromptAwaitingAccept(screen)) {
+        throw new AitermError(`GROK_PROMPT_NOT_ACCEPTED_YET vendor=grok session=${name}\n` +
+            "Grokが前の文をまだ受け取っていません（画面の「Waiting for the agent to accept the prompt」）。文字列は送信していません。" +
+            "前の文の完了待ちが終わってから送り直してください。Grokは120秒受け取れないと、前の文を自分から取り消します。", 2);
+    }
     if (running) {
         return steerRunningTurn(name, meta, text, { raw: o.raw, pane_input_recovery: paneInputRecovery, preface: o.preface });
     }

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/harnesses/grok.js

@@ -246,7 +246,7 @@ export function grokInitializationComplete(meta) {
     }
     return false;
 }
-export async function observeGrokDone(meta, timeout, requestedCursor, detectRateLimit, signal) {
+export async function observeGrokDone(meta, timeout, requestedCursor, detectRateLimit, signal, detectUnacceptedPrompt = () => false) {
     const metadataFile = agentMetadataPath(meta.aiterm_session, meta.launch_id);
     const transcript = grokEventsTranscript(meta);
     if (!transcript)
@@ -257,9 +257,11 @@ export async function observeGrokDone(meta, timeout, requestedCursor, detectRate
     let malformedEvents = 0;
     let discardLeadingFragment = false;
     let initializedBoundary = false;
+    let turnStarted = false;
+    let unacceptedSeen = 0;
     const deadline = performance.now() + timeout * 1000;
     const rateLimitDue = pollGate(AGENT_RATE_LIMIT_POLL_MS);
-    const observation = (outcome, ev = null, rateLimit = null) => ({
+    const observation = (outcome, ev = null, rateLimit = null, error = null) => ({
         schema: "aiterm.agent-wait-result.v1",
         session_id: meta.aiterm_session,
         launch_id: meta.launch_id,
@@ -272,7 +274,7 @@ export async function observeGrokDone(meta, timeout, requestedCursor, detectRate
         malformed_events: malformedEvents,
         at: ev?.at ?? null,
         rate_limit: rateLimit,
-        error: ev?.done_status === "turn_error" ? ev.reason : null,
+        error: error ?? (ev?.done_status === "turn_error" ? ev.reason : null),
         error_kind: null,
     });
     for (;;) {
@@ -311,7 +313,10 @@ export async function observeGrokDone(meta, timeout, requestedCursor, detectRate
                         continue;
                     }
                     try {
-                        const done = grokCompletionEvent(meta, JSON.parse(line));
+                        const record = JSON.parse(line);
+                        if (record?.type === "turn_started")
+                            turnStarted = true;
+                        const done = grokCompletionEvent(meta, record);
                         if (done) {
                             const limited = done.done_status === "turn_error"
                                 ? detectRateLimit(meta.kind, meta.aiterm_session) : null;
@@ -329,6 +334,12 @@ export async function observeGrokDone(meta, timeout, requestedCursor, detectRate
             const limited = detectRateLimit(meta.kind, meta.aiterm_session);
             if (limited)
                 return observation("rate_limited", null, limited);
+            // Grokが文を受け取らずに入力欄へ戻した時は、記録に何も出ないので、画面の知らせで終わりを知る。
+            // 送った直後は前の番の知らせがまだ画面に残っている事があるので、この待ちの間に番が始まっておらず、
+            // 間を置いた2回の読みが続けて同じ時だけ、結果なしの終了として返す（1回だけの照会では返さない）。
+            unacceptedSeen = !turnStarted && detectUnacceptedPrompt(meta.aiterm_session) ? unacceptedSeen + 1 : 0;
+            if (unacceptedSeen >= 2)
+                return observation("error", null, null, GROK_UNACCEPTED_PROMPT_ERROR);
         }
         if (performance.now() >= deadline)
             return observation(timeout === 0 ? "running" : "timeout");
@@ -418,6 +429,30 @@ export function grokTuiBusy(screen) {
         || screen.includes("Responding...")
         || screen.includes("[stop]");
 }
+// Grok（1.0.50実測）は、送った文を中のagentが10秒受け取らないと、足元の表示を「Waiting for the agent to accept the prompt…」に変え、
+// 120秒で自分から取り消して、文を入力欄へ戻す（「The agent did not accept your prompt within 120s. Your text is back in the input box; …」）。
+// 会話の記録（events.jsonl）には、番の行が1つも出ない。
+/** 動いている表示が「受け取り待ち」か。差し込む先の番は、まだ無い。 */
+export function grokPromptAwaitingAccept(screen) {
+    const live = screen.split("\n").filter(line => /Waiting for|Responding|\[stop\]/u.test(line)).at(-1);
+    return live?.includes("Waiting for the agent to accept the prompt") ?? false;
+}
+/**
+ * 受け取られなかった文が、入力欄へ戻されたままか。
+ * 知らせは次の番が始まった後も画面の上に残るので、知らせより後に動いている表示が無く、今の入力欄に文がある時だけtrue。
+ */
+export function grokUnacceptedPromptRestored(screen) {
+    const clean = screen.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, "");
+    const at = clean.lastIndexOf("The agent did not accept your prompt within");
+    if (at < 0)
+        return false;
+    const after = clean.slice(at);
+    if (grokTuiBusy(after))
+        return false;
+    const composer = [...after.matchAll(/^[ \t]*│[ \t]*[❯>]([^\n]*?)│?[ \t]*$/gmu)].at(-1);
+    return !!composer && composer[1].trim() !== "";
+}
+export const GROK_UNACCEPTED_PROMPT_ERROR = "Grokが文を受け取りませんでした（Grokの画面の知らせ: The agent did not accept your prompt）。文は実行されず、Grokの入力欄へ戻されています。";
 // 現在の質問カードだけを認識する。選択肢が空でも操作欄は残る。
 // footer後に描画があれば過去のカードなので、会話履歴からキー操作を起こさない。
 export function grokRateLimitDialog(screen) {

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/dist/tmux-runtime.js

@@ -42,6 +42,7 @@ export function psmuxVersionSupported(output) {
     return major > 3 || (major === 3 && (minor > 3 || (minor === 3 && patch >= 8)));
 }
 let winPsmuxOk = false;
+let winPsmuxVersion = null;
 export function ensureWinPsmux(observe = true) {
     if (winPsmuxOk)
         return;
@@ -56,8 +57,124 @@ export function ensureWinPsmux(observe = true) {
         ptyDependencyError("psmux -V が失敗しました。`psmux -V` が通るか確認してください。", observe);
     if (!psmuxVersionSupported(r.stdout ?? ""))
         ptyDependencyError("psmux 3.3.8以上が必要です。winget upgrade --id marlocarlo.psmux --source winget で更新してください。", observe);
+    winPsmuxVersion = /^psmux (\d+\.\d+\.\d+)(?:\s|$)/mu.exec(r.stdout ?? "")?.[1] ?? null;
     winPsmuxOk = true;
 }
+// ---- psmux 3.3.8: 画面の無いlogonで立てた本体の控えが、画面のある側から消される（psmux #650）----
+// sshで入った側やserviceの下（Terminal Servicesのsession 0）で立てたpsmuxの本体を、同じ利用者の、画面のある側の
+// 普段の権限のprocessは開けない（OpenProcessがERROR_ACCESS_DENIED）。psmux 3.3.8は「開けない＝本体は終わっている」と
+// 読み、画面のある側でpsmuxが1回呼ばれるたびに（`psmux -V`でも）、その端末の控え（~/.psmux の port・key・pid・sid）を消す。
+// 本体が5秒以内に書き戻すまで端末は一覧から消え、その間にこちら側でpsmuxを呼ぶと、控えの無い本体として止められる
+// （実被弾 2026-10-11 fox: sshの側で立てたGrokの席が、4回中2回、文を送った20秒ほど後に消えた）。
+// 直しはpsmuxのmasterに入っているが、公開された版は3.3.8が最後。それまでの間、立てた本体へ
+// 「同じ利用者が名前を問う権利（PROCESS_QUERY_LIMITED_INFORMATION）」だけを足す。画面のある側が本体を開けるようになり、控えは消されない。
+const PSMUX_DESKTOP_ACCESS_VERSION = "3.3.8";
+const PSMUX_SERVER_PID_WAIT_MS = 5500;
+const PSMUX_REGISTRY_SETTLE_MS = 6000;
+const PSMUX_DESKTOP_ACCESS_POLL_MS = 250;
+let psmuxOnDesktop = false;
+/** 手当てが要る見込みか。processを起こさずに決める。 */
+export function psmuxDesktopAccessWanted(version, env = process.env) {
+    if (version !== PSMUX_DESKTOP_ACCESS_VERSION)
+        return false;
+    // SESSIONNAME（Console・RDP-Tcp#N）は画面のあるlogonの印。ある時は画面のある側で、手当ては要らない。
+    // 無いのは、ssh・serviceの下か、画面のある側のタスク。どちらかは、手当てのscriptがsessionの番号で見分ける。
+    return !env.SESSIONNAME;
+}
+/** 本体へ権利を足すPowerShellのscript。出力は1行: `ok`（足した）・`desktop`（画面のある側なので何もしない）・それ以外（失敗の理由）。 */
+export function psmuxServerAccessScript(serverPid) {
+    return `$ErrorActionPreference = 'Stop'
+if ([Diagnostics.Process]::GetCurrentProcess().SessionId -ne 0) { 'desktop'; exit 0 }
+Add-Type -TypeDefinition @"
+using System; using System.Runtime.InteropServices;
+public static class AitermPsmuxAccess {
+  [DllImport("kernel32.dll", SetLastError=true)] static extern IntPtr OpenProcess(uint access, bool inherit, uint pid);
+  [DllImport("kernel32.dll")] static extern bool CloseHandle(IntPtr h);
+  [DllImport("kernel32.dll")] static extern IntPtr LocalFree(IntPtr p);
+  [DllImport("advapi32.dll")] static extern uint GetSecurityInfo(IntPtr handle, int objectType, uint info, IntPtr owner, IntPtr group, out IntPtr dacl, IntPtr sacl, out IntPtr sd);
+  [DllImport("advapi32.dll", CharSet=CharSet.Unicode)] static extern uint SetEntriesInAclW(uint count, ref EXPLICIT_ACCESS entries, IntPtr oldAcl, out IntPtr newAcl);
+  [DllImport("advapi32.dll")] static extern uint SetSecurityInfo(IntPtr handle, int objectType, uint info, IntPtr owner, IntPtr group, IntPtr dacl, IntPtr sacl);
+  [DllImport("advapi32.dll", SetLastError=true, CharSet=CharSet.Unicode)] static extern bool ConvertStringSidToSidW(string sid, out IntPtr psid);
+  [StructLayout(LayoutKind.Sequential)] struct TRUSTEE { public IntPtr pMultipleTrustee; public int MultipleTrusteeOperation; public int TrusteeForm; public int TrusteeType; public IntPtr ptstrName; }
+  [StructLayout(LayoutKind.Sequential)] struct EXPLICIT_ACCESS { public uint grfAccessPermissions; public int grfAccessMode; public uint grfInheritance; public TRUSTEE Trustee; }
+  public static string Grant(uint pid, string sid, uint mask) {
+    IntPtr h = OpenProcess(0x00060000, false, pid); // READ_CONTROL | WRITE_DAC
+    if (h == IntPtr.Zero) return "OpenProcess " + Marshal.GetLastWin32Error();
+    try {
+      IntPtr dacl, sd, psid, newAcl;
+      uint r = GetSecurityInfo(h, 6, 4, IntPtr.Zero, IntPtr.Zero, out dacl, IntPtr.Zero, out sd); // SE_KERNEL_OBJECT, DACL_SECURITY_INFORMATION
+      if (r != 0) return "GetSecurityInfo " + r;
+      if (!ConvertStringSidToSidW(sid, out psid)) return "ConvertStringSidToSid " + Marshal.GetLastWin32Error();
+      EXPLICIT_ACCESS ea = new EXPLICIT_ACCESS();
+      ea.grfAccessPermissions = mask; ea.grfAccessMode = 1; ea.grfInheritance = 0; // GRANT_ACCESS
+      ea.Trustee.TrusteeForm = 0; ea.Trustee.TrusteeType = 1; ea.Trustee.ptstrName = psid; // TRUSTEE_IS_SID, TRUSTEE_IS_USER
+      r = SetEntriesInAclW(1, ref ea, dacl, out newAcl);
+      if (r != 0) return "SetEntriesInAcl " + r;
+      r = SetSecurityInfo(h, 6, 4, IntPtr.Zero, IntPtr.Zero, newAcl, IntPtr.Zero);
+      LocalFree(newAcl); LocalFree(psid); LocalFree(sd);
+      return r == 0 ? "ok" : "SetSecurityInfo " + r;
+    } finally { CloseHandle(h); }
+  }
+}
+"@
+[AitermPsmuxAccess]::Grant(${serverPid}, [Security.Principal.WindowsIdentity]::GetCurrent().User.Value, 0x1000)
+`;
+}
+function runPsmuxServerAccessScript(serverPid) {
+    const powershell = path.win32.join(process.env.SystemRoot ?? process.env.windir ?? "C:\\Windows", "System32", "WindowsPowerShell", "v1.0", "powershell.exe");
+    const encoded = Buffer.from(psmuxServerAccessScript(serverPid), "utf16le").toString("base64");
+    const r = spawnSync(powershell, ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-EncodedCommand", encoded], { encoding: "utf8", windowsHide: true, timeout: 15000 });
+    if (r.error)
+        return `powershell ${r.error.code ?? "error"}`;
+    return (r.stdout ?? "").trim().split(/\r?\n/).pop() || `powershell exit ${r.status}`;
+}
+/**
+ * 立てたばかりの端末の本体を、画面のある側から問えるようにする（上の説明）。端末を作った直後に1回呼ぶ。
+ * 失敗しても端末は使えるので、投げない。足せなかった時は、理由を1行だけstderrへ書く。
+ */
+export function openPsmuxServerToDesktop(session, o = {}) {
+    if (o.wanted === undefined) {
+        if (!isWin || psmuxOnDesktop)
+            return "skipped";
+        ensureWinPsmux(false);
+    }
+    if (!(o.wanted ?? psmuxDesktopAccessWanted(winPsmuxVersion)))
+        return "skipped";
+    // 問うだけの命令なので、窓を隠して起こす。consoleを持たないprocessから呼ばれた時に、この手当てで窓を増やさない。
+    const tmux = o.tmux ?? ((...args) => {
+        const r = spawnSync(psmuxBin(), ["-L", WIN_NS, ...args], { encoding: "utf8", windowsHide: true, env: tmuxSpawnEnv(), timeout: 10000 });
+        return { code: r.status ?? 1, stdout: r.stdout ?? "" };
+    });
+    const pause = o.pause ?? ((ms) => { Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms); });
+    // 立てた直後に控えを消されていると、本体のpidを問えない。本体が控えを書き戻す（5秒以内）まで待つ。
+    // 立てて10秒以内の本体は、控えが無くても止められない。待ちは、足しても10秒より短くしてある。
+    let serverPid = 0;
+    for (let waited = 0;; waited += PSMUX_DESKTOP_ACCESS_POLL_MS) {
+        const r = tmux("display-message", "-p", "-t", session, "#{pid}");
+        serverPid = r.code === 0 && /^\d+$/.test(r.stdout.trim()) ? Number(r.stdout.trim()) : 0;
+        if (serverPid > 0 || waited >= PSMUX_SERVER_PID_WAIT_MS)
+            break;
+        pause(PSMUX_DESKTOP_ACCESS_POLL_MS);
+    }
+    const result = serverPid > 0 ? (o.grant ?? runPsmuxServerAccessScript)(serverPid) : "psmuxの本体のpidを問えません";
+    if (result === "desktop") {
+        // 画面のある側のprocessは、何度立てても同じ答えになる。以後は問わない。
+        if (o.wanted === undefined)
+            psmuxOnDesktop = true;
+        return "desktop";
+    }
+    if (result !== "ok") {
+        process.stderr.write(`aiterm: PSMUX_SERVER_ACCESS_NOT_GRANTED session=${session} ${result.slice(0, 200)}\n`);
+        return "failed";
+    }
+    // 足す前に消された控えが戻るのを待ってから、端末を使い始める。
+    for (let waited = 0; waited < PSMUX_REGISTRY_SETTLE_MS; waited += PSMUX_DESKTOP_ACCESS_POLL_MS) {
+        if (tmux("has-session", "-t", session).code === 0)
+            break;
+        pause(PSMUX_DESKTOP_ACCESS_POLL_MS);
+    }
+    return "granted";
+}
 // tmux が見つからないときの説明。macOS は tmux を同梱せず、Homebrew の bin は GUI 起動時の PATH に
 // 入らないため、原因と対処（導入・自動探索・AITERM_TMUX 上書き）を正直に提示する。
 function tmuxMissingMessage() {

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.1",
+  "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": [