aiterm-mcp 0.41.0 → 0.41.2

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.41.2] - 2026-09-27
+
+### 修正
+
+- Claude Codeのtool処理中に画面の実行中表示が消えると、`pty_send`が新規turnと誤判定し、未解決turnエラーで送信を拒否していた。Stopまで保持されるturnの印で実行中を判定し、同じturnへ差し込む。
+
+## [0.41.1] - 2026-09-27
+
+### 修正
+
+- CodexとCursorの回答回収（`pty_read(agent_transcript:true)`と親への自動配送）が、作業途中の報告を回答の前につないで返していた。Codexはturnのassistant本文を`phase`を見ずに全部つなぎ、Cursorは道具呼び出しの前に書いた文も含めていた。Codexは`phase=final_answer`の本文だけを、Cursorは最後の道具呼び出しより後の本文だけを返す。`phase`の無い旧形式のCodex記録と、道具呼び出し後に本文の無いCursorのturnは従来どおり扱う。Claude CodeとGrokは元から最後の回答だけを返している。
+
 ## [0.41.0] - 2026-09-27
 
 ### 削除
@@ -1810,7 +1822,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.41.0...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.41.2...HEAD
+[0.41.2]: https://github.com/kitepon/aiterm-mcp/compare/v0.41.1...v0.41.2
+[0.41.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.41.0...v0.41.1
 [0.41.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.40.3...v0.41.0
 [0.40.3]: https://github.com/kitepon/aiterm-mcp/compare/v0.40.2...v0.40.3
 [0.40.2]: https://github.com/kitepon/aiterm-mcp/compare/v0.40.1...v0.40.2

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.41.0** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.41.2** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -249,7 +249,7 @@ pty_read(id, { wait: true })       → 削減済みの出力を読む（完了
 
 同じprimitiveが別エージェントのTUIを宿す。`agent_launch`の`harness`はagent loop・認証・hook・session・transcriptを所有する実行基盤、`model`は独立した選択。起動processは直接CLIと同じproject/user環境を使い、通常config、MCP、plugin、skill、permission、trust、memory、historyをcopy・filter・置換しない。
 
-`aiterm.agent-launch-result.v1`は正規`harness`を返し、旧`provider`は互換fieldとして残す。同じ`harness`はagent dispatch、`aiterm-wait`、`agent_configure`、`pty_list`のagent行にも載り、旧vendor／provider／agent fieldは互換用に残る。Codexは通常rollout、Grok CLIは通常session event、Claudeはlaunch固有Stop hook、Cursorは通常agent transcript末尾の`turn_ended`を完了正本に使う。agent sessionへの送信は`pty_send`だけで行い、子の状態はAitermが送る時点の画面で見て振り分ける。子のturnが実行中なら各harness標準の操作で現在のturnへ差し込み（`mode=agent_steer`）、完了は差し込み後の作業の終わりに元の依頼へ1回だけ届く。新しい`event_cursor`と配送は作らない。それ以外は非ブロックdispatch（`mode=agent_dispatch`）で、vendor別完了境界を表すopaqueな整数`event_cursor`を返す。Codex親は選択に応じて公式Steerまたは受信キュー、Claude Code親は公式非同期hookで回答本文を自動受信する。それ以外の親は`aiterm-wait`を親のターンを塞がない別processで受ける。Cursorのsubmitキーはadapterが現行CLIのextended keyboard protocolへ変換する。送信textがCursorのcomposerへ残った場合は成功receiptを返さず失敗する。
+`aiterm.agent-launch-result.v1`は正規`harness`を返し、旧`provider`は互換fieldとして残す。同じ`harness`はagent dispatch、`aiterm-wait`、`agent_configure`、`pty_list`のagent行にも載り、旧vendor／provider／agent fieldは互換用に残る。Codexは通常rollout、Grok CLIは通常session event、Claudeはlaunch固有Stop hook、Cursorは通常agent transcript末尾の`turn_ended`を完了正本に使う。agent sessionへの送信は`pty_send`だけで行い、子の状態はAitermが送る時点の画面で見て振り分ける。Claudeは画面の実行中表示ではなくStopまで残るturnの印で判定する。子のturnが実行中なら各harness標準の操作で現在のturnへ差し込み（`mode=agent_steer`）、完了は差し込み後の作業の終わりに元の依頼へ1回だけ届く。新しい`event_cursor`と配送は作らない。それ以外は非ブロックdispatch（`mode=agent_dispatch`）で、vendor別完了境界を表すopaqueな整数`event_cursor`を返す。Codex親は選択に応じて公式Steerまたは受信キュー、Claude Code親は公式非同期hookで回答本文を自動受信する。それ以外の親は`aiterm-wait`を親のターンを塞がない別processで受ける。Cursorのsubmitキーはadapterが現行CLIのextended keyboard protocolへ変換する。送信textがCursorのcomposerへ残った場合は成功receiptを返さず失敗する。
 
 `agent_launch`・`pty_send`（agent session宛て）は任意の`image`（画像ファイルの絶対パスの配列。png/jpg/jpeg/gif/webp）を受ける。aitermが本文末尾へ添付行を付け、どのharnessも自分のfile読取toolでそのpathを画像として開く。呼出し側はharness別の添付手順を覚えない。不正なpathは送信前に拒否する。
 

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.41.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.41.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
 
@@ -270,7 +270,7 @@ pty_read(id, { wait: true })       → read the token-reduced output, completion
 
 The same primitive hosts another agent's TUI. `agent_launch` starts a selected execution harness inside a fresh persistent terminal and returns a `session_id`. `harness` names the component that owns the agent loop, authentication, hooks, session, and transcript; `model` remains an independent choice. The launched process sees the same project and user environment as a direct CLI invocation: normal configuration, MCPs, plugins, skills, permissions, trust decisions, memory, and history are not copied, filtered, or replaced. Aiterm adds only completion correlation and a non-user sub-agent context containing `role=subagent`, the parent session, delegation depth, lineage, and `delegation_allowed=true`.
 
-起動結果には正規`harness`を含む`aiterm.agent-launch-result.v1`が付き、旧`provider`は互換fieldとして残る。同じ`harness`はagent dispatch、`aiterm-wait`、`agent_configure`、`pty_list`にも載る。Codexは通常rollout、Grokは通常session event、Claudeはlaunch固有Stop hook、Cursorは通常agent transcriptの`turn_ended`を完了正本に使う。agentへの送信は`pty_send`だけで行い、Aitermが送る時点で子の状態を見て振り分ける。実行中のturnへは差し込み（`mode=agent_steer`、新しい`event_cursor`と配送は作らない）、それ以外は非ブロックdispatch（`mode=agent_dispatch`）で、harnessごとの完了境界を表す整数`event_cursor`を返す。Codex親は選択に応じて公式Steerまたはqueue、Claude Code親は公式非同期hookで本文を自動受信する。他の親は[`aiterm-wait`](#completion-push-for-parent-agents-aiterm-wait)を使う。CursorのsubmitはadapterがCLIのextended keyboard protocolへ変換し、送信本文がcomposerへ残る場合は明示errorにする。
+起動結果には正規`harness`を含む`aiterm.agent-launch-result.v1`が付き、旧`provider`は互換fieldとして残る。同じ`harness`はagent dispatch、`aiterm-wait`、`agent_configure`、`pty_list`にも載る。Codexは通常rollout、Grokは通常session event、Claudeはlaunch固有Stop hook、Cursorは通常agent transcriptの`turn_ended`を完了正本に使う。agentへの送信は`pty_send`だけで行い、Aitermが送る時点で子の状態を見て振り分ける。Claudeは画面の実行中表示ではなくStopまで残るturnの印で判定する。実行中のturnへは差し込み（`mode=agent_steer`、新しい`event_cursor`と配送は作らない）、それ以外は非ブロックdispatch（`mode=agent_dispatch`）で、harnessごとの完了境界を表す整数`event_cursor`を返す。Codex親は選択に応じて公式Steerまたはqueue、Claude Code親は公式非同期hookで本文を自動受信する。他の親は[`aiterm-wait`](#completion-push-for-parent-agents-aiterm-wait)を使う。CursorのsubmitはadapterがCLIのextended keyboard protocolへ変換し、送信本文がcomposerへ残る場合は明示errorにする。
 
 `agent_launch` and `pty_send` (to an agent session) accept an optional `image`: an array of absolute paths to image files (png/jpg/jpeg/gif/webp). Aiterm appends an attachment block to the prompt, and every harness opens the path with its own file-reading tool and sees the image; the caller never learns harness-specific attachment tricks. Invalid paths are rejected before anything is sent.
 

package/dist/core.js

@@ -3685,10 +3685,10 @@ export async function sendAgentMessage(name, text, o = {}) {
     // 前面回復は busy 判定より先（bash 前面のままだと画面の実行中マーカーを読んでも打鍵が届かない）。
     const paneInputRecovery = await ensureAgentOwnsPaneInput(name, meta.kind);
     let running = isAgentTuiBusy(meta.kind, captureScreen(name, AGENT_TUI_READY_LINES));
-    // Claude CodeはStop hookの実行中も実行中の表示を続ける。Aitermのturnの印はStopで消えるので、
-    // 印が無ければturnは終わっている。ここで差し込むと新しいturnとして始まり、誰もその完了を待たない。
-    if (meta.kind === "claude" && readClaudeOperationMarker(meta) === null)
-        running = false;
+    // Claudeのtool処理中は画面のbusy表示が消えることがある。Stopまで保持するturnの印を正とし、
+    // 印がある間は差し込み、Stop後は画面にbusy表示が残っても新しいturnとして送る。
+    if (meta.kind === "claude")
+        running = readClaudeOperationMarker(meta) !== null;
     if (running) {
         return steerRunningTurn(name, meta, text, { raw: o.raw, pane_input_recovery: paneInputRecovery });
     }

package/dist/harnesses/codex.js

@@ -588,7 +588,7 @@ export function codexTranscriptText(meta, turnId, readTranscriptLines, transcrip
     const lines = readTranscriptLines(transcript);
     if (exactCompletion) {
         // 同じturnの本文だけを使う。完了event内の本文と、turn ID付きoutput_textの両形式を扱う。
-        const matching = [];
+        const matching = codexTurnAnswer();
         for (const line of lines) {
             let record;
             try {
@@ -598,24 +598,19 @@ export function codexTranscriptText(meta, turnId, readTranscriptLines, transcrip
                 continue;
             }
             const payload = record?.payload;
-            if (record?.type === "response_item" && payload?.type === "message" && payload?.role === "assistant"
-                && payload?.internal_chat_message_metadata_passthrough?.turn_id === turnId && Array.isArray(payload?.content)) {
-                for (const item of payload.content) {
-                    if (item?.type === "output_text" && typeof item.text === "string")
-                        matching.push(item.text);
-                }
-            }
+            matching.add(record, turnId);
             if (record?.type === "event_msg" && payload?.type === "task_complete" && payload.turn_id === turnId) {
                 if (typeof payload.last_agent_message === "string")
                     return payload.last_agent_message;
-                if (matching.length > 0)
-                    return matching.join("\n");
+                const text = matching.text();
+                if (text)
+                    return text;
                 transcriptUnavailable();
             }
         }
         transcriptUnavailable();
     }
-    const matching = [];
+    const matching = codexTurnAnswer();
     let finalAnswer = "";
     for (const line of lines) {
         if (!line.trim())
@@ -628,16 +623,7 @@ export function codexTranscriptText(meta, turnId, readTranscriptLines, transcrip
             continue;
         }
         const payload = record?.payload;
-        if (record?.type === "response_item" &&
-            payload?.type === "message" &&
-            payload?.role === "assistant" &&
-            payload?.internal_chat_message_metadata_passthrough?.turn_id === turnId &&
-            Array.isArray(payload?.content)) {
-            for (const item of payload.content) {
-                if (item?.type === "output_text" && typeof item.text === "string")
-                    matching.push(item.text);
-            }
-        }
+        matching.add(record, turnId);
         if (record?.type === "event_msg" &&
             payload?.type === "agent_message" &&
             payload?.phase === "final_answer" &&
@@ -645,7 +631,31 @@ export function codexTranscriptText(meta, turnId, readTranscriptLines, transcrip
             finalAnswer = payload.message;
         }
     }
-    return matching.join("\n") || finalAnswer;
+    return matching.text() || finalAnswer;
+}
+// turnのassistant本文を集める。Codexは作業途中の報告をphase=commentary、回答をphase=final_answerで残すので、
+// final_answerがあるturnは途中の報告を回答に含めない。phaseの無い旧形式はturnの本文を全部つなぐ。
+function codexTurnAnswer() {
+    const all = [];
+    const finals = [];
+    return {
+        add(record, turnId) {
+            const payload = record?.payload;
+            if (record?.type !== "response_item" || payload?.type !== "message" || payload?.role !== "assistant"
+                || payload?.internal_chat_message_metadata_passthrough?.turn_id !== turnId || !Array.isArray(payload?.content))
+                return;
+            for (const item of payload.content) {
+                if (item?.type !== "output_text" || typeof item.text !== "string")
+                    continue;
+                all.push(item.text);
+                if (payload.phase === "final_answer")
+                    finals.push(item.text);
+            }
+        },
+        text() {
+            return (finals.length > 0 ? finals : all).join("\n");
+        },
+    };
 }
 export function createCodexAgentMetadata(name, cwd, initialPrompt, overrides = {}, writeScope, lineageContext) {
     const launchId = randomBytes(16).toString("hex");

package/dist/harnesses/cursor.js

@@ -235,7 +235,8 @@ export function cursorTranscriptText(meta, readTranscriptLines, transcriptUnavai
     const transcript = cursorTranscript(meta);
     if (!transcript)
         transcriptUnavailable();
-    let current = [];
+    // tool_useで区切った本文の塊を持つ。道具を呼ぶ前の文は作業途中の報告なので、回答は最後の塊だけにする。
+    let current = [[]];
     let completed = null;
     for (const line of readTranscriptLines(transcript)) {
         if (!line.trim())
@@ -248,19 +249,21 @@ export function cursorTranscriptText(meta, readTranscriptLines, transcriptUnavai
             continue;
         }
         if (record?.role === "user")
-            current = [];
+            current = [[]];
         if (record?.role === "assistant" && Array.isArray(record?.message?.content)) {
             for (const part of record.message.content) {
                 if (part?.type === "text" && typeof part?.text === "string")
-                    current.push(part.text);
+                    current.at(-1).push(part.text);
+                else if (part?.type === "tool_use" && current.at(-1).length > 0)
+                    current.push([]);
             }
         }
         if (record?.type === "turn_ended")
-            completed = [...current];
+            completed = current.map((chunk) => [...chunk]);
     }
     if (completed === null)
         transcriptUnavailable();
-    return completed.join("\n");
+    return (completed.filter((chunk) => chunk.length > 0).at(-1) ?? []).join("\n");
 }
 export function createCursorAgentMetadata(name, cwd, initialPrompt, writeScope, lineage) {
     const launchId = randomBytes(16).toString("hex");

package/docs/DESIGN.md

@@ -67,7 +67,7 @@ Grokの記録先はCLIと同じOS絶対パスへcwdを正規化して導出し
 agent sessionへの送信口は`pty_send`だけとする。子の状態は呼び出し側に選ばせず、Aitermが送る時点の画面で振り分ける。
 状態を見てから呼ぶまでの間に子のturnが変わるため、呼び出し側が入口を選ぶ形では外れる。
 実行中なら現在のturnへ追加textを差し込み、新しい完了境界と配送は作らない。完了境界は差し込み後も1つに保つ。
-Claude CodeはStop hookの実行中も実行中の表示を続けるため、Aitermのturnの印（Stopで消える）が無ければ実行中と数えない。
+Claude Codeはtool処理中に画面の実行中表示が消え、Stop hookの実行中には表示が残る。Stopで消えるturnの印だけを実行中判定の正本とする。
 それ以外は新しいturnとしてdispatchする。
 CodexとClaude Codeは次のtool境界で同じturnへ取り込む。Cursorは「follow-ups」枠へ入った文を「enter steer」で現在turnへ移し、`turn_ended`は最後に1回書く。
 Grokは待ち行列へ入れた後に「send now」を押す。旧turnは`cancelled`（`cancellation_context.trigger=send_now`）で閉じ、

package/package.json

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