aiterm-mcp 0.29.25 → 0.29.27

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.29.27] - 2026-09-02
+
+### Fixed
+
+- Cursorが貼り付け反映後の最初のEnterを取り落とし、promptをcomposerへ残した場合だけEnterを一度再送してturnを開始する。
+
+## [0.29.26] - 2026-09-02
+
+### Fixed
+
+- Cursorの冷間起動時は、貼り付けたpromptがcomposerへ反映されたことを確認してからEnterを送り、入力準備前の早送信による未配達を防ぐ。
+
 ## [0.29.25] - 2026-09-02
 
 ### Fixed
@@ -1500,7 +1512,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.29.25...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.29.27...HEAD
+[0.29.27]: https://github.com/kitepon/aiterm-mcp/compare/v0.29.26...v0.29.27
+[0.29.26]: https://github.com/kitepon/aiterm-mcp/compare/v0.29.25...v0.29.26
 [0.29.25]: https://github.com/kitepon/aiterm-mcp/compare/v0.29.24...v0.29.25
 [0.29.24]: https://github.com/kitepon/aiterm-mcp/compare/v0.29.23...v0.29.24
 [0.29.23]: https://github.com/kitepon/aiterm-mcp/compare/v0.29.22...v0.29.23

package/README.ja.md

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

package/README.md

@@ -169,7 +169,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.29.25** · 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.29.27** · 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

@@ -61,6 +61,8 @@ const AGENT_SUBMIT_RESIDUE_POLL_MS = 300;
 const AGENT_SUBMIT_RESIDUE_MAX_SAMPLES = 5;
 const AGENT_SUBMIT_RESIDUE_TAIL_CHARS = 32;
 const AGENT_SUBMIT_RESIDUE_MIN_TAIL_CHARS = 8;
+const CURSOR_PROMPT_VISIBLE_POLL_MS = 100;
+const CURSOR_PROMPT_VISIBLE_MAX_SAMPLES = 50;
 // 出力削減（RTK の CAP 思想を移植）
 const MAX_LINES_BEFORE_ELIDE = 60;
 const HEAD_LINES = 30;
@@ -2480,6 +2482,31 @@ async function detectAgentSubmitResidueImpl(kind, text, sample, sleepFn, opts =
 async function detectAgentSubmitResidue(name, kind, text) {
     return detectAgentSubmitResidueImpl(kind, text, () => captureScreen(name, AGENT_TUI_READY_LINES), sleep);
 }
+async function retryCursorSubmitIfResidueImpl(kind, residue, submit, inspect) {
+    if (kind !== "cursor" || residue.residue !== true)
+        return residue;
+    submit();
+    return inspect();
+}
+async function retryCursorSubmitIfResidue(name, kind, text, residue) {
+    return retryCursorSubmitIfResidueImpl(kind, residue, () => sendKey(name, "Enter", { preserveAgentOperation: true }), () => detectAgentSubmitResidue(name, kind, text));
+}
+async function waitCursorPromptVisibleImpl(text, sample, sleepFn, opts = {}) {
+    const tail = agentSubmitResidueTail(text) ?? normalizeResidueText(text);
+    const pollMs = opts.pollMs ?? CURSOR_PROMPT_VISIBLE_POLL_MS;
+    const maxSamples = opts.maxSamples ?? CURSOR_PROMPT_VISIBLE_MAX_SAMPLES;
+    for (let i = 0; i < maxSamples; i++) {
+        if (agentSubmitResidueOnScreen("cursor", sample(), tail) === true) {
+            return { visible: true, samples: i + 1 };
+        }
+        if (i < maxSamples - 1)
+            await sleepFn(pollMs);
+    }
+    return { visible: false, samples: maxSamples };
+}
+async function waitCursorPromptVisible(name, text) {
+    return waitCursorPromptVisibleImpl(text, () => captureScreen(name, AGENT_TUI_READY_LINES), sleep);
+}
 export function agentSubmitResidueWarning(name, residue) {
     if (residue !== true)
         return "";
@@ -2558,13 +2585,28 @@ export async function __testDetectAgentSubmitResidue(kind, text, samples, opts =
     }, opts);
     return { ...result, sleeps };
 }
+export async function __testWaitCursorPromptVisible(text, samples, opts = {}) {
+    if (samples.length === 0)
+        throw new AitermError("Cursor prompt反映待ちのtest samplesが空です", 2);
+    let i = 0;
+    const sleeps = [];
+    const result = await waitCursorPromptVisibleImpl(text, () => samples[Math.min(i++, samples.length - 1)], async (ms) => {
+        sleeps.push(ms);
+    }, opts);
+    return { ...result, sleeps };
+}
+export async function __testRetryCursorSubmitIfResidue(kind, first, second) {
+    let submits = 0;
+    const result = await retryCursorSubmitIfResidueImpl(kind, first, () => { submits++; }, async () => second);
+    return { result, submits };
+}
 export function __testSetAgentTuiReadyStableSamples(value) {
     if (value !== null && (!Number.isInteger(value) || value < 1 || value > 1000)) {
         throw new AitermError("test ready stable samplesが不正です", 2);
     }
     agentTuiReadyStableSamplesTestOverride = value;
 }
-async function sendAgentPromptText(name, text) {
+async function sendAgentPromptText(name, text, kind) {
     send(name, text, {
         enter: false,
         force: true,
@@ -2574,7 +2616,16 @@ async function sendAgentPromptText(name, text) {
         preserveAgentOperation: true,
         bracketedPaste: true,
     });
-    await sleep(AGENT_SUBMIT_DELAY_MS);
+    if (kind === "cursor") {
+        const visible = await waitCursorPromptVisible(name, text);
+        if (!visible.visible) {
+            throw new AitermError(`vendor=cursor session=${name}\n` +
+                "送信promptがCursorのcomposerへ反映されたことを確認できないため、Enterは送信していません。", 2);
+        }
+    }
+    else {
+        await sleep(AGENT_SUBMIT_DELAY_MS);
+    }
     sendKey(name, "Enter", { preserveAgentOperation: true });
 }
 export async function sendInitialAgentPrompt(name, text, o = {}) {
@@ -2614,7 +2665,7 @@ export async function sendInitialAgentPrompt(name, text, o = {}) {
             prepareSendText(text, { raw: false });
             reserveAnonymousClaudeTurn(meta);
         }
-        await sendAgentPromptText(name, promptText);
+        await sendAgentPromptText(name, promptText, meta.kind);
         setInitialPromptState(meta, "pending");
     }
     catch (e) {
@@ -2751,12 +2802,12 @@ export async function configureAgent(name, opts) {
         // Cursor TUIの `/model <base model>` はmodelを直接切り替える一方、flatten済みcatalog ID
         // （例: gpt-5.6-luna-high）を渡すとno matchesのfilter画面へ入る。effortは標準model pickerの
         // parameter editorで選び、同じsessionと会話contextを保つ。
-        await sendAgentPromptText(name, `/model ${model}`);
+        await sendAgentPromptText(name, `/model ${model}`, meta.kind);
         const modelReady = await waitAgentTuiReady(name, meta, AGENT_TUI_READY_TIMEOUT_MS);
         if (!modelReady.ready)
             throw new AitermError("Cursorのmodel変更完了を確認できません", 2);
         if (effort) {
-            await sendAgentPromptText(name, "/model");
+            await sendAgentPromptText(name, "/model", meta.kind);
             await waitForScreenText(name, "Available models");
             sendMenuChoice(name, "Tab");
             const parameterScreen = await waitForScreenText(name, "Edit Parameters");
@@ -2895,10 +2946,24 @@ export async function dispatchAgentTurn(name, text, o = {}) {
         preserveAgentOperation: meta.kind === "claude",
         bracketedPaste: true,
     });
-    // Codex TUI は literal text 投入直後の Enter を取り落とすことがある。agent 経路だけ submit を分離する。
-    await sleep(AGENT_SUBMIT_DELAY_MS);
+    // Cursorの冷間起動ではbracketed pasteの反映が250msを超えることがある。本文がcomposerへ
+    // 現れた実測をsubmit条件にし、未反映のままEnterだけを失う競合を作らない。
+    if (meta.kind === "cursor") {
+        const visible = await waitCursorPromptVisible(name, dispatchText);
+        if (!visible.visible) {
+            throw new AitermError(`vendor=cursor session=${name}\n` +
+                "送信promptがCursorのcomposerへ反映されたことを確認できないため、Enterは送信していません。", 2);
+        }
+    }
+    else {
+        // Codex TUI は literal text 投入直後の Enter を取り落とすことがある。agent 経路だけ submit を分離する。
+        await sleep(AGENT_SUBMIT_DELAY_MS);
+    }
     sendKey(name, "Enter", { preserveAgentOperation: meta.kind === "claude" });
-    const residue = await detectAgentSubmitResidue(name, meta.kind, dispatchText);
+    let residue = await detectAgentSubmitResidue(name, meta.kind, dispatchText);
+    // Cursorはcomposerへの貼付反映後でも最初のEnterを取り落とすことがある。本文残留を
+    // 陽性観測した場合だけ同じEnterを一度再送し、再検査後も残る時は失敗として返す。
+    residue = await retryCursorSubmitIfResidue(name, meta.kind, dispatchText, residue);
     assertAgentSubmitDelivered(name, meta.kind, residue);
     return {
         schema: "aiterm.agent-dispatch.v1",

package/package.json

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