aiterm-mcp 0.43.5 → 0.43.7

package/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.43.7] - 2026-09-29
+
+### 修正
+
+- Cursor CLIの親で、子の回答が作業中にもidle中にも届かなかった（Linux・macOS）。Cursor CLIはMCPを削った環境で起動し、hookと背景の受信processは画面側の環境で起動する。state rootの置き場（XDG_RUNTIME_DIR・TMPDIR・AITERM_STATE_BASE）が割れ、hookが配送記録を見つけられずに何もしていなかった。hookと受信processは、同じ利用者の置き場の候補のうち配送記録のある方を使う（aiterm-steer-delivery 0.1.8）。
+- Cursor CLIのmodelはtool結果のstructuredContentを見ないため、idle中に受け取る背景コマンド（wait_process）を知らずにターンを終えていた。Cursor親への結果の本文にもそのコマンド行を書く。
+
+## [0.43.6] - 2026-09-29
+
+### 修正
+
+- Cursor CLI（cursor-agent）の親を、Cursor親として見分けていなかった。CLIはMCPのinitializeで`"Cursor"`と名乗り、`"cursor-vscode"`（Desktop）しか見ていなかったため、子の回答は汎用の`wait_process`でしか受け取れなかった。今はDesktopと同じく、作業中は次のtool返りへ差し込み、idle中は背景受信で届く（aiterm-steer-delivery 0.1.6、紅蓮氏の報告）。
+- WindowsのCursorは、hookのstdinのJSONの先頭にBOMを付ける。そのまま読んで失敗していたため、作業中の差し込みが起きず、配送が`sending`のまま止まっていた。先頭のBOMを落とす（aiterm-steer-delivery 0.1.7、紅蓮氏の報告）。
+
 ## [0.43.5] - 2026-09-29
 
 ### 修正
@@ -1893,7 +1907,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.43.5...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.43.7...HEAD
+[0.43.7]: https://github.com/kitepon/aiterm-mcp/compare/v0.43.6...v0.43.7
+[0.43.6]: https://github.com/kitepon/aiterm-mcp/compare/v0.43.5...v0.43.6
 [0.43.5]: https://github.com/kitepon/aiterm-mcp/compare/v0.43.4...v0.43.5
 [0.43.4]: https://github.com/kitepon/aiterm-mcp/compare/v0.43.3...v0.43.4
 [0.43.3]: https://github.com/kitepon/aiterm-mcp/compare/v0.43.2...v0.43.3

package/README.ja.md

@@ -203,7 +203,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.43.5** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.43.7** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 

package/README.md

@@ -217,7 +217,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.43.5** · 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.43.7** · 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/agent-shared.js

@@ -1,6 +1,7 @@
 // harness中立の共有プリミティブ。core と harnesses/ の両方が依存する最下層で、
 // tmux-runtime / errors 以外の内部moduleへ依存しない（依存方向: core → harnesses → agent-shared）。
 import * as fs from "node:fs";
+import * as os from "node:os";
 import * as path from "node:path";
 import { randomBytes } from "node:crypto";
 import { AitermError } from "./errors.js";
@@ -99,6 +100,16 @@ export function stateRoot() {
     const base = runtimeStateBase();
     return path.join(base, `aiterm-mcp-${uid}`);
 }
+/**
+ * 同じ利用者のAitermが使いうるstate rootの候補（先頭はこのprocessのもの）。
+ * Cursor CLIはMCPを削った環境（XDG_RUNTIME_DIR・TMPDIR・AITERM_STATE_BASE無し）で起動し、hookと背景processは画面側の環境で起動する。
+ * 置き場は環境で決まるので両者で割れる。hook側はこの候補のうち配送記録のある置き場を使う。
+ */
+export function stateRootCandidates() {
+    const name = `aiterm-mcp-${currentUid()}`;
+    const bases = [runtimeStateBase(), process.env.AITERM_STATE_BASE, process.env.XDG_RUNTIME_DIR, os.tmpdir(), process.platform === "win32" ? undefined : "/tmp"];
+    return [...new Set(bases.filter((base) => typeof base === "string" && base !== "").map(base => path.join(base, name)))];
+}
 export function ensureStateRoot() {
     // state root は OS が与えるper-user runtime dir（Windows隔離時TMPDIR／XDG_RUNTIME_DIR／os.tmpdir()）の下に作る。
     // 以前はここで symlink・owner・mode を検査していたが、共有 /tmp に敵対的な同居主体がいる

package/dist/core.js

@@ -13,6 +13,7 @@ import * as path from "node:path";
 import { createHash, randomBytes } from "node:crypto";
 import { fileURLToPath } from "node:url";
 import * as rtk from "./rtk.js";
+import { isCursorMcpClient } from "aiterm-steer-delivery";
 import { paneTokenHint } from "./harnesses/pane-tokens.js";
 import { readRuntimeProcesses, processSubtree, parentProcess, processIdentity, backgroundProcesses } from "./process-runtime.js";
 import { AitermError, telemetryOwnedFailure, ownTelemetryFailure } from "./errors.js";
@@ -2598,7 +2599,7 @@ function autoDeliveryParent() {
         return "Codex";
     if (parentClientName === "claude-code")
         return "Claude Code";
-    if (parentClientName === "cursor-vscode" || parentClientName?.startsWith("cursor-vscode "))
+    if (isCursorMcpClient(parentClientName ?? undefined))
         return "Cursor";
     return null;
 }
@@ -2619,7 +2620,7 @@ export function agentDispatchGuide(session, cursor) {
     const parent = autoDeliveryParent();
     if (parent === "Cursor") {
         return "回答はこの会話へ自動で届く。作業を続ければ次のツール返りに差し込まれる。" +
-            "ターンを終える前にreceiptのwait_processを背景（block_until_ms: 0）で起動しておけば、idle中に完了しても起きられる。" +
+            "ターンを終える前に、この結果のwait_processのコマンドを背景（block_until_ms: 0）で起動しておけば、idle中に完了しても起きられる。" +
             "ポーリング・pty_read(agent_transcript:true)は不要。";
     }
     if (parent) {

package/dist/cursor-parent-hook.js

@@ -2,5 +2,7 @@
 // Cursorが起動する公式hook。MCP stdioとは別processで、差し込み文をstdoutのJSONへ返す。本体はaiterm-steer-delivery。
 import { isDirectExecution, runCursorHookMain } from "aiterm-steer-delivery";
 import { AITERM_PROFILE } from "./steer-profile.js";
+import { cursorHookRoots } from "./cursor-parent-receiver.js";
+// Cursor CLIではMCPとhookの環境が違い、state rootが割れる。候補の置き場すべてで結び付けと差し込みを行う。
 if (isDirectExecution(import.meta.url))
-    await runCursorHookMain(AITERM_PROFILE);
+    await runCursorHookMain(AITERM_PROFILE, cursorHookRoots());

package/dist/cursor-parent-receive.js

@@ -2,12 +2,19 @@
 // Cursor親がidleのとき、背景で起動して回答本文の到着を待つ受け口。本体はaiterm-steer-delivery。
 import { fileURLToPath } from "node:url";
 import * as steer from "aiterm-steer-delivery";
-import { cursorHookRoot } from "./cursor-parent-receiver.js";
+import { cursorHookRoots } from "./cursor-parent-receiver.js";
 export function cursorReceiveProcess(deliveryId, executable = process.execPath) {
     return steer.cursorReceiveProcess(fileURLToPath(import.meta.url), deliveryId, executable);
 }
+/** 背景processの起動情報を、親のshellへ書ける1行にする（Windowsの既定shellはPowerShell）。 */
+export function waitProcessCommandLine(wait, platform = process.platform) {
+    const values = [wait.executable, ...wait.args];
+    if (platform === "win32")
+        return `& ${values.map(value => `'${value.replace(/'/g, "''")}'`).join(" ")}`;
+    return values.map(value => `'${value.replace(/'/g, "'\\''")}'`).join(" ");
+}
 export async function main(argv) {
-    return steer.runCursorReceive(cursorHookRoot(), argv);
+    return steer.runCursorReceive(cursorHookRoots(), argv);
 }
 if (steer.isDirectExecution(import.meta.url)) {
     main(process.argv.slice(2)).then(code => { process.exitCode = code; }).catch(error => {

package/dist/cursor-parent-receiver.js

@@ -3,7 +3,7 @@
 import * as path from "node:path";
 import { z } from "zod";
 import * as steer from "aiterm-steer-delivery";
-import { ensureStateRoot } from "./agent-shared.js";
+import { ensureStateRoot, stateRootCandidates } from "./agent-shared.js";
 import { AITERM_PROFILE } from "./steer-profile.js";
 // 配送記録の検証はAitermのzodで行う（パッケージのschemaと同じ形）。
 export const cursorParentSchema = z.object({ kind: z.literal("cursor"), hook_root: z.string() }).strict();
@@ -12,6 +12,10 @@ export const { isCursorMcpClient, cursorHooksFile, prepareCursorDelivery, submit
 export function cursorHookRoot(state = ensureStateRoot()) {
     return path.join(state, "cursor-parent-hooks");
 }
+/** hookと受信processが配送記録を探す置き場（先頭はこのprocessのもの）。理由は stateRootCandidates。 */
+export function cursorHookRoots() {
+    return stateRootCandidates().map(state => cursorHookRoot(state));
+}
 export function cursorParentHooksRegistered(document) { return steer.cursorParentHooksRegistered(AITERM_PROFILE, document); }
 export function verifyCursorParent(parent, hooksFile = cursorHooksFile()) { steer.verifyCursorParent(AITERM_PROFILE, parent, hooksFile); }
 export function cursorParentFromRequest(clientName, options = {}) {

package/dist/index.js

@@ -20,6 +20,7 @@ import { acceptRemote, callRemoteTool, observeRemoteAgentDone, remoteInputDescri
 import { codexParentFromRequest } from "./codex-parent-receiver.js";
 import { claudeParentFromRequest } from "./claude-parent-receiver.js";
 import { cursorParentFromRequest, isCursorMcpClient } from "./cursor-parent-receiver.js";
+import { waitProcessCommandLine } from "./cursor-parent-receive.js";
 import { INTERIM_RESULT_META_KEY, interimRequestFromMeta } from "./interim-words.js";
 // package.json の version を実行時に読み、MCP initialize で配るサーバ版と一致させる。
 // createRequire を使うのは、import 属性 `with { type: "json" }` が Node 18.20+ 限定で
@@ -50,7 +51,11 @@ async function deliveryForRequest(extra, remote = false) {
 }
 function deliveryIdLine(delivery) {
     const id = delivery?.result()?.delivery_id;
-    return id ? `\ndelivery_id=${id}` : "";
+    if (!id)
+        return "";
+    // Cursor CLIのmodelはtool結果のstructuredContentを見ないので、idle中に受け取る背景コマンドも本文に書く。
+    const wait = delivery?.wait_process();
+    return `\ndelivery_id=${id}` + (wait ? `\nwait_process（ターンを終える前に背景で起動）: ${waitProcessCommandLine(wait)}` : "");
 }
 function completionWait(delivery, session, eventCursor) {
     if (eventCursor === null)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.43.5",
+  "version": "0.43.7",
   "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": [
@@ -70,7 +70,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "aiterm-steer-delivery": "^0.1.5",
+    "aiterm-steer-delivery": "^0.1.8",
     "ws": "8.21.3",
     "zod": "^4.4.3"
   },