aiterm-mcp 0.52.1 → 0.52.2

package/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.52.2] - 2026-10-05
+
+### 修正
+
+- 0.52.1で、socketの置き場（`claude-tmux-sockets`）ごと無くなったagent sessionへの送信が、
+  `ENOENT: … .agent-send.lock`という生のエラーを返していた。0.52.0までは
+  「入力受付状態になりません。文字列は送信していません。」の断りだった。連携元が「文字列は送信していません」で
+  未送信を見分けている時、0.52.1ではこの場合だけ見分けられなかった。送信の順番を守るlock（ADR 0088）を
+  置き場に作れない時は、lockを取らずに進め、今まで通りの断りを返す。置き場が無ければsessionにも届かず、
+  守る相手が無い。sessionだけが無くなった時（置き場は残る）の断りは、0.52.1でも変わっていない。
+- 0.52.1で、送信の途中で終了したprocessのpidを別の生きたprocessが使い回すと、そのagent sessionへの送信が
+  `AGENT_SEND_BUSY`で断られ続けた。lockの持ち主をpidだけで見ていたため。`pty_close`してもlockが残り、
+  閉じて同じIDで起動し直しても同じ断りだった。生きて見える持ち主は、processが始まってからの経過と
+  lockを作ってからの時間を比べて本人かを確かめ、lockより後に始まった別のprocessなら片付ける。
+  片付けの途中で残った印は、5秒より古ければ、pidが生きて見えても残った物と読む（その時の断りは今までと同じ文面）。
+  `pty_close`は、使い回されたpidのlockと古い印も片付ける。OSへの照会は、送信が実際に重なった時と、
+  閉じる時にlockが残っていた時だけ行う。
+
 ## [0.52.1] - 2026-10-05
 
 ### 修正
@@ -2117,7 +2135,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.52.1...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.52.2...HEAD
+[0.52.2]: https://github.com/kitepon/aiterm-mcp/compare/v0.52.1...v0.52.2
 [0.52.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.52.0...v0.52.1
 [0.52.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.51.3...v0.52.0
 [0.51.3]: https://github.com/kitepon/aiterm-mcp/compare/v0.51.2...v0.51.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.52.1** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.52.2** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 

package/README.md

@@ -223,7 +223,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.52.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.52.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

@@ -16,7 +16,7 @@ import * as rtk from "./rtk.js";
 import { isCursorMcpClient } from "aiterm-steer-delivery";
 import { paneTokenHint } from "./harnesses/pane-tokens.js";
 import { unfinishedDeliveriesOwnedBy } from "./parent-delivery-owners.js";
-import { readRuntimeProcesses, processSubtree, parentProcess, processIdentity, backgroundProcesses, lazyRelayProcess, aitermProcessProbe, windowsConsoleHost } from "./process-runtime.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 { 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";
@@ -1860,6 +1860,7 @@ function isPidAlive(pid) {
 function probeWaitLock(p) {
     let pid = null;
     let at = null;
+    let token = null;
     let ageMs = 0;
     try {
         const st = fs.lstatSync(p);
@@ -1871,15 +1872,17 @@ function probeWaitLock(p) {
             pid = v.pid;
         if (typeof v.at === "string")
             at = v.at;
+        if (typeof v.token === "string")
+            token = v.token;
     }
     catch {
         /* pid 不明のまま鮮度判定に落ちる */
     }
     if (pid == null)
-        return { pid: null, at, live: ageMs < WAIT_LOCK_FRESH_MS };
+        return { pid: null, at, token, ageMs, live: ageMs < WAIT_LOCK_FRESH_MS };
     if (pid === process.pid)
-        return { pid, at, live: false };
-    return { pid, at, live: isPidAlive(pid) };
+        return { pid, at, token, ageMs, live: false };
+    return { pid, at, token, ageMs, live: isPidAlive(pid) };
 }
 function unlinkStaleWaitLock(p) {
     try {
@@ -2034,16 +2037,42 @@ function probeAgentSendLock(name) {
     const probe = probeWaitLock(agentSendLockPath(name));
     return probe.pid === process.pid && agentSendHeld.has(name) ? { ...probe, live: true } : probe;
 }
+// 持ち主のpidが生きて見えても、lockより後に始まったprocessなら、終了した持ち主のpidを使い回した別のprocessである。
+// 読みの粗さ（psの経過は1秒刻み）と小さな時計合わせで本人を別人と読まないよう、この秒数を越えて若い時だけ別人とする。
+const AGENT_SEND_LOCK_OWNER_SLACK_S = 5;
+function agentSendLockOwnerReplaced(probe) {
+    if (!probe.live || probe.pid == null || probe.pid === process.pid)
+        return false;
+    const created = probe.at === null ? Number.NaN : Date.parse(probe.at);
+    const lockAgeS = (Number.isFinite(created) ? Date.now() - created : probe.ageMs ?? 0) / 1000;
+    let elapsed;
+    try {
+        elapsed = processElapsedSeconds(probe.pid);
+    }
+    catch {
+        // 確かめられない時は、今まで通り生きていると読む（誤って片付けるより断る方に倒す）。
+        return false;
+    }
+    return elapsed === null || elapsed + AGENT_SEND_LOCK_OWNER_SLACK_S < lockAgeS;
+}
+// 片付け役が印を持つのは一瞬。持ち主が終了しているか、鮮度猶予より古い印は、片付けの途中で残った物と読む。
+// 古さでも読むのは、終了した片付け役のpidを別のprocessが使い回すと、pidだけでは生きて見えるため。
+function agentSendReapMarkStuck(guard) {
+    const probe = probeWaitLock(guard);
+    return !probe.live || (probe.ageMs ?? 0) >= WAIT_LOCK_FRESH_MS;
+}
 // 持ち主が終了したlockを片付ける。確かめてから消すまでの間に別のprocessが新しいlockを作ると生きたlockを消すので、
 // 消す役を`.reap`の`O_EXCL`で1つに絞り、その中でもう一度確かめてから消す。lockが在る間は誰も新しいlockを作れない。
-// done=片付けた（または片付ける物が無かった）／busy=別のprocessが片付け中／stuck=片付けの印が持ち主なしで残っている
-function reapDeadAgentSendLock(name) {
+// replacedTokenは、持ち主が別人と確かめたlockの印。pidが生きて見えるので、確かめた時と同じlockの時だけ消す。
+// done=片付けた（または片付ける物が無かった）／busy=別のprocessが片付け中／stuck=片付けの印が残っている
+function reapDeadAgentSendLock(name, replacedToken = null) {
     const guard = agentSendReapPath(name);
     const token = tryCreateOwnedLock(guard);
     if (token === null)
-        return probeWaitLock(guard).live ? "busy" : "stuck";
+        return agentSendReapMarkStuck(guard) ? "stuck" : "busy";
     try {
-        if (!probeAgentSendLock(name).live) {
+        const probe = probeAgentSendLock(name);
+        if (!probe.live || (replacedToken !== null && probe.token === replacedToken)) {
             try {
                 fs.unlinkSync(agentSendLockPath(name));
             }
@@ -2057,24 +2086,54 @@ function reapDeadAgentSendLock(name) {
     }
     return "done";
 }
+// BellTeamのため: 先頭の「AGENT_SEND_BUSY: agent session '<名前>' は」と、文中の「文字列は送信していません。」で
+// 未送信の断りを見分けている（2026-10-05）。この2か所を変える時は、変える前に知らせる。
 function agentSendBusyError(name, pid, waitMs) {
     return new AitermError(`AGENT_SEND_BUSY: agent session '${name}' は${pid != null ? `別プロセス（pid ${pid}）` : "先に受け付けた送信"}の処理中です。` +
         `${waitMs}ms待っても順番が来ませんでした。文字列は送信していません。少し後で再度 pty_send してください。`, 2);
 }
 async function acquireAgentSendFileLock(name, deadline, waitMs) {
     const p = agentSendLockPath(name);
+    let checkedOwner = null;
+    let checkedOwnerReplaced = false;
     for (;;) {
-        const token = tryCreateOwnedLock(p);
+        let token;
+        try {
+            token = tryCreateOwnedLock(p);
+        }
+        catch (e) {
+            // socketの置き場が無ければ、守る相手のsessionにも届かない。lockを取らずに進め、送信側の今まで通りの断りを返す。
+            if (e.code === "ENOENT")
+                return () => { };
+            throw e;
+        }
         if (token !== null)
             return () => releaseOwnedLock(p, token);
         const probe = probeAgentSendLock(name);
-        if (!probe.live && reapDeadAgentSendLock(name) === "stuck") {
+        let dead = !probe.live;
+        let replacedToken = null;
+        // 生きて見える持ち主は、初めて見た時に1回、本人かを確かめる。結果は覚え、待つ間にOSへ照会し直さない。
+        if (!dead && probe.pid != null) {
+            const owner = `${probe.pid}@${probe.at}`;
+            if (owner !== checkedOwner) {
+                checkedOwner = owner;
+                checkedOwnerReplaced = agentSendLockOwnerReplaced(probe);
+            }
+            if (checkedOwnerReplaced) {
+                dead = true;
+                replacedToken = probe.token ?? null;
+            }
+        }
+        if (dead && reapDeadAgentSendLock(name, replacedToken) === "stuck") {
+            // BellTeamのため: 先頭の「agent session '<名前>' に、終了した送信のlockを片付ける途中で残った印があります。」と、
+            // 文中の「文字列は送信していません。」で見分け、pty_close→起動し直しへ回している（2026-10-05）。
+            // この文面と、pty_closeがこの印を片付ける事を変える時は、変える前に知らせる。
             throw new AitermError(`agent session '${name}' に、終了した送信のlockを片付ける途中で残った印があります。` +
                 `自動回収は並行送信の混線を招くため行いません。文字列は送信していません。` +
                 `pty_listで対象を確認し、pty_closeでsessionを閉じてから同じIDで再作成してください`, 2);
         }
         if (performance.now() >= deadline)
-            throw agentSendBusyError(name, probe.live ? probe.pid : null, waitMs);
+            throw agentSendBusyError(name, dead ? null : probe.pid, waitMs);
         await sleep(AGENT_SEND_LOCK_POLL_MS);
     }
 }
@@ -2120,13 +2179,16 @@ async function withAgentSendLock(name, run) {
     }
 }
 // pty_closeの掃除。生きた持ち主のlockは残す（その送信はsessionが無くなった所で失敗し、自分のlockを外す）。
+// 持ち主が終了したlock、pidを使い回されて生きて見えるlock、残った片付けの印は片付ける。
 function cleanupAgentSendLock(name) {
     const guard = agentSendReapPath(name);
     try {
-        if (fs.existsSync(guard) && !probeWaitLock(guard).live)
+        if (fs.existsSync(guard) && agentSendReapMarkStuck(guard))
             fs.unlinkSync(guard);
-        if (fs.existsSync(agentSendLockPath(name)))
-            reapDeadAgentSendLock(name);
+        if (!fs.existsSync(agentSendLockPath(name)))
+            return;
+        const probe = probeAgentSendLock(name);
+        reapDeadAgentSendLock(name, agentSendLockOwnerReplaced(probe) ? probe.token ?? null : null);
     }
     catch {
         /* 掃除の失敗で閉じる処理を止めない */

package/dist/process-runtime.js

@@ -36,6 +36,7 @@ export function parsePosixProcessTable(text) {
 const POSIX_PS = "/bin/ps";
 const POSIX_TABLE_ARGS = ["-axww", "-o", "pid=,ppid=,pgid=,stat=,lstart=,time=,command="];
 const POSIX_IDENTITY_ARGS = ["-o", "pid=,lstart=", "-p"];
+const POSIX_ELAPSED_ARGS = ["-o", "etime=", "-p"];
 const WINDOWS_PROBE_HEADER = ["$ErrorActionPreference='Stop'", "[Console]::OutputEncoding=[Text.UTF8Encoding]::new($false)"];
 const WINDOWS_PROBE_ARGS = ["-NoLogo", "-NoProfile", "-NonInteractive", "-EncodedCommand"];
 // 先頭2行だけのbase64。3 byteの区切りで切り、後ろの行に左右されない前方一致にする。
@@ -47,7 +48,8 @@ const WINDOWS_PROBE_PREFIX = (() => {
 export function aitermProcessProbe(command) {
     if (command.includes(` ${WINDOWS_PROBE_ARGS.join(" ")} ${WINDOWS_PROBE_PREFIX}`))
         return true;
-    return command === `${POSIX_PS} ${POSIX_TABLE_ARGS.join(" ")}` || command.startsWith(`${POSIX_PS} ${POSIX_IDENTITY_ARGS.join(" ")} `);
+    return command === `${POSIX_PS} ${POSIX_TABLE_ARGS.join(" ")}` || command.startsWith(`${POSIX_PS} ${POSIX_IDENTITY_ARGS.join(" ")} `)
+        || command.startsWith(`${POSIX_PS} ${POSIX_ELAPSED_ARGS.join(" ")} `);
 }
 /** Windowsのconsole host。console processの起動に付いて立ち、最後のconsole processが終わると消える。 */
 export function windowsConsoleHost(row) {
@@ -157,6 +159,42 @@ export function readProcessIdentities(pids) {
         return { pid: row.pid, started_identity: new Date(row.started_identity).toISOString() };
     });
 }
+/** `ps -o etime=`の「[[日-]時:]分:秒」を秒にする。 */
+export function parsePosixElapsed(value) {
+    const match = /^(?:(?:(\d+)-)?(\d+):)?(\d+):(\d+)$/.exec(value.trim());
+    if (!match)
+        return null;
+    return Number(match[1] ?? 0) * 86400 + Number(match[2] ?? 0) * 3600 + Number(match[3]) * 60 + Number(match[4]);
+}
+/**
+ * processが始まってからの秒数。process表に無ければnull。OSへ照会できなかった時は例外にする。
+ * 開始時刻でなく経過で返す。POSIXのpsが出す開始時刻は、time zoneの設定と時計合わせで読みが変わる。
+ */
+export function processElapsedSeconds(pid) {
+    if (!Number.isSafeInteger(pid) || pid <= 0)
+        throw new AitermError("process照会のpidが不正です", 2);
+    if (isWin) {
+        const row = readProcessIdentities([pid])[0];
+        if (!row)
+            return null;
+        if (row.started_identity === null)
+            throw new AitermError("processの開始時刻を取得できません", 2);
+        return Math.max(0, (Date.now() - Date.parse(row.started_identity)) / 1000);
+    }
+    const result = spawnSync(POSIX_PS, [...POSIX_ELAPSED_ARGS, String(pid)], {
+        encoding: "utf8", env: { ...process.env, LC_ALL: "C" }, timeout: 10000,
+    });
+    const text = (result.stdout ?? "").trim();
+    // 該当するprocessが無い時、psは何も出さずstatus 1で終わる。
+    if (result.error || (result.status !== 0 && !(result.status === 1 && !text)))
+        throw new AitermError("OSのprocess一覧を取得できません", 2);
+    if (!text)
+        return null;
+    const elapsed = parsePosixElapsed(text);
+    if (elapsed === null)
+        throw new AitermError("processの経過時間の形式を認識できません", 2);
+    return elapsed;
+}
 // Windowsの親PIDは親の終了後も残り、別processへ再利用される。子より後に始まったprocessは
 // 本当の親ではないので、親子関係として辿らない（辿ると循環や無関係なprocessの混入が起きる）。
 export function parentProcess(row, byPid) {

package/docs/DESIGN.md

@@ -314,6 +314,8 @@ stale send lockは並行processとのABAを避けるため自動削除せず、
 同じIDで再作成する。全session一括停止は公開しない。
 agent sessionへの送信1本を守る`<name>.agent-send.lock`は持つ時間が長いので、持ち主が終了した残骸を次の送信が片付ける。消す役を`<name>.agent-send.lock.reap`の排他作成で1つに絞り、
 その中でもう一度確かめてから消すので、確かめた後で別のlockに入れ替わらない。消す役の印そのものが残った時だけは自動で消さず、`pty_close`を案内する。
+終了した持ち主のpidを別のprocessが使い回すと、pidだけでは生きて見える。生きて見える持ち主は、processが始まってからの経過とlockを作ってからの時間を比べ、
+lockより後に始まったprocessなら別人と読んで片付ける。消す役の印は、5秒より古ければ残った物と読む。`pty_close`は、どちらも片付ける。
 
 Grokのread-only sandbox起動拒否は、`src/harnesses/grok.ts`の
 `assertGrokSandboxNotRejected`がCLIのエラー表示から検出する。`src/core.ts`の共通入力受付待機は

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.52.1",
+  "version": "0.52.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": [