aiterm-mcp 0.58.0 → 0.58.2

package/CHANGELOG.md

@@ -7,6 +7,39 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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
+
+### 修正
+
+- Windowsで、Codexの親へ文を届けた後に、端末の窓（Windows Terminal）が一瞬出る事がある件を直す（共通パッケージ`aiterm-steer-delivery` 0.4.3）。
+  0.58.0で足した「寝ている会話を起こす見張り」（ADR 0108）は、切り離したprocess（consoleを持たない）で動く。
+  CodexのSteerを有効にしていない端末では、見張りがCodexの実行ファイルを`where codex`で探し、その子に窓を隠す指定が無かった。
+  consoleを持たないprocessが、窓を隠さずにconsoleの子を起こすと、窓が一瞬出る。
+  - Steerが有効な端末（実行ファイルの場所がhookの設定にある）では、ここを通らない。その道では、0.58.0も窓を出していない（Windowsの実物で測った）。
+  - 共通パッケージが子のprocessを起こす所の全部に、窓を隠す指定を付けた。
+- 共通パッケージを0.4.3へ上げる。0.4.2の直し（Claude Codeが起動し直して再開した会話へのchannelの配送）は、channelを使う製品向けで、Aitermの動きは変わらない。
+
 ## [0.58.0] - 2026-10-09
 
 ### 修正
@@ -2464,7 +2497,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.0...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.58.2...HEAD
+[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
 [0.57.3]: https://github.com/kitepon/aiterm-mcp/compare/v0.57.2...v0.57.3

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.0** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.58.2** · 動作対象は 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.0** · 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.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).
 
 ### Update and rollback
 

package/dist/core.js

@@ -18,10 +18,10 @@ 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 { 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";
@@ -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("=");
@@ -3126,7 +3128,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相関
@@ -4354,6 +4363,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 +4403,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 +4564,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/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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.58.0",
+  "version": "0.58.2",
   "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": [
@@ -72,7 +72,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "aiterm-steer-delivery": "^0.4.1",
+    "aiterm-steer-delivery": "^0.4.3",
     "ws": "8.21.3",
     "zod": "^4.4.3"
   },