aiterm-mcp 0.41.2 → 0.42.0

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.42.0] - 2026-09-28
+
+### 追加
+
+- BellTeamとの連携用に、`pty_observe`がBellTeamからの要求にだけ、実行中のturnで書かれた作業の合間の言葉を返せるようにした。ほかの呼び手に対するツールの説明、引数、結果は変わらない。判断はrepositoryの`docs/adr/0071-bellteam-interim-words.md`。
+
+### 修正
+
+- Cursorは記録にturnの終了を書いたあとも、しばらく画面に実行中の表示を残す。完了通知の直後に`pty_send`すると差し込みと判定し、`STEER_NOT_QUEUED`で失敗していた（手元で3回中2回）。記録の末尾がturnの終了なら新しいturnとして送る。
+
+## [0.41.3] - 2026-09-28
+
+### 修正
+
+- Claude CodeがAPIエラーや安全判定の拒否でターンを終了し、Stop hookが発火しなかった場合、実行中の印が残り、次の`pty_send`を差し込みと誤判定していた。送信時に現在の印の作成後に記録された`isApiErrorMessage`を確認し、終了したターンの印だけを解除して新しいターンを開始する。過去のエラーで次のターンの印を解除せず、waiterは引き続き読取専用とする。上流APIの拒否はそのままエラーとして返す。
+
 ## [0.41.2] - 2026-09-27
 
 ### 修正
@@ -1822,7 +1838,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.2...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.42.0...HEAD
+[0.42.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.41.3...v0.42.0
+[0.41.3]: https://github.com/kitepon/aiterm-mcp/compare/v0.41.2...v0.41.3
 [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

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.2** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.42.0** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -251,6 +251,8 @@ pty_read(id, { wait: true })       → 削減済みの出力を読む（完了
 
 `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を返さず失敗する。
 
+ClaudeがAPIエラーや安全判定の拒否で終了した時は、Stop hookが発火しなくても次の`pty_send`を新しいturnとして扱う。現在のturn開始後のエラー記録だけを確認し、過去のエラーで実行中のturnを解除しない。上流の拒否はエラーのまま返す。
+
 `agent_launch`・`pty_send`（agent session宛て）は任意の`image`（画像ファイルの絶対パスの配列。png/jpg/jpeg/gif/webp）を受ける。aitermが本文末尾へ添付行を付け、どのharnessも自分のfile読取toolでそのpathを画像として開く。呼出し側はharness別の添付手順を覚えない。不正なpathは送信前に拒否する。
 
 `agent_launch`は任意の`write_scope`も受ける。Codex／Grokのread-onlyは`--sandbox read-only`、Cursorは公式`--mode ask`で実効化する。path説明は同等CLI引数がないためdeclaration-only。

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.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).
+**Status:** actively maintained · current public release **v0.42.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).
 
 ### Update and rollback
 
@@ -251,6 +251,8 @@ aiterm predates Build Week, so the event work is kept visible in dated commits.
 
 I used **Codex with GPT-5.6** as an engineering collaborator: it inspected the implementation, challenged the API and recovery contracts, generated focused regression cases, and helped verify race, security, timeout, and malformed-event paths. I reviewed the diffs and test evidence and retained the final product and architecture decisions. At that Build Week checkpoint, the regression suite contained 262 tests covering normal operation as well as failure and recovery behavior; current release receipts live in the [CHANGELOG](CHANGELOG.md) and release ADRs.
 
+ClaudeがAPIエラーや安全判定の拒否で終了した時は、Stop hookが発火しなくても次の`pty_send`を新しいturnとして扱う。現在のturn開始後のエラー記録だけを確認し、過去のエラーで実行中のturnを解除しない。上流の拒否はエラーのまま返す。
+
 ## Two ways to use it
 
 ### 1. Drive SSH, containers, and REPLs in one persistent terminal — the primitive

package/dist/core.js

@@ -20,8 +20,9 @@ import { isWin, SOCKDIR, tmuxCommand, sendPsmuxPayload, loadPtyBufferChunk, past
 import { sleep, currentUid, runtimeStateBase, safeStatSize, readFileRange, writeJson0600, createEmpty0600, shq, LAUNCH_ID_RE, AGENT_DONE_POLL_MS, AGENT_EVENT_MAX_BYTES, assertSessionName, agentsDir, agentEventPath, agentMetadataPath, writeAgentMetadata, AGENT_EVENT_TAIL_BYTES, agentLabel, agentHarness, subagentInstruction, agentLineageFields, } from "./agent-shared.js";
 import { realGrokHome, resolveAndValidateGrokAuth, assertGrokModelAvailable, grokEventsTranscript, latestGrokCompletion, observeGrokDone, buildGrokAgentCmd, grokLaunchNote, grokEnvTokens, grokTuiReady, grokTuiBusy, grokPaneObservation, grokRateLimitDialog, grokStartupAction, grokLaunchBlockingDialog, assertGrokSandboxNotRejected, GROK_COMPOSER_MARKER_RE, grokFooterHasConfiguration, grokTranscriptText, createGrokAgentMetadata, } from "./harnesses/grok.js";
 import { bindCodexTranscriptSession, latestCodexCompletion, observeCodexDone, buildCodexAgentCmd, codexLaunchNote, codexTuiReady, codexPaneObservation, codexRateLimitModelSwitchDialog, codexApprovalDialog, codexStartupAction, CODEX_COMPOSER_MARKER_RE, codexModelChoice, codexEffortChoice, codexMoreReasoningChoice, codexTranscriptText, createCodexAgentMetadata, } from "./harnesses/codex.js";
-import { OPERATION_ID_RE, CLAUDE_RESULT_MAX_BYTES, CLAUDE_EFFORTS, agentManagedClaudeSettingsPath, agentClaudeResultPath, agentClaudeOperationPath, agentClaudeApprovalReceiptPath, agentClaudeDispatchReceiptPath, validateOperationId, readClaudeResultText, assertClaudeAuthenticationReady, buildClaudeAgentCmd, claudeLaunchNote, claudeTuiReady, claudePaneObservation, claudeStartupAction, claudeLoginMethodMenu, CLAUDE_COMPOSER_MARKER_RE, createClaudeAgentMetadata, claudeSessionTranscriptPath, claudeApiErrorFromLine, } from "./harnesses/claude.js";
+import { OPERATION_ID_RE, CLAUDE_RESULT_MAX_BYTES, CLAUDE_EFFORTS, agentManagedClaudeSettingsPath, agentClaudeResultPath, agentClaudeOperationPath, agentClaudeApprovalReceiptPath, agentClaudeDispatchReceiptPath, validateOperationId, readClaudeResultText, assertClaudeAuthenticationReady, buildClaudeAgentCmd, claudeLaunchNote, claudeTuiReady, claudePaneObservation, claudeStartupAction, claudeLoginMethodMenu, CLAUDE_COMPOSER_MARKER_RE, createClaudeAgentMetadata, claudeSessionTranscriptPath, claudeApiErrorFromLine, claudeApiErrorAfter, } from "./harnesses/claude.js";
 import { bindCursorTranscriptSession, cursorTurnBoundary, latestCursorCompletion, observeCursorDone, cursorTranscriptText, assertCursorAuthenticationReady, assertCursorModelAvailable, buildCursorAgentCmd, cursorAgentArgv, cursorPwshLaunchLine, cursorPromptWithLineage, createCursorAgentMetadata, cursorLaunchNote, cursorEffortNavigation, cursorTuiReady, cursorPaneObservation, cursorPromptHooksRunning, cursorUsageLimit, CURSOR_SUBMIT_SEQUENCE, CURSOR_COMPOSER_CONTENT_MARKER_RE, validateCursorModelEffort, } from "./harnesses/cursor.js";
+import { readInterimWords, recordInterimBoundary } from "./interim-words.js";
 import { resolveAgentBin, resolveThroughlineBin, runThroughlineHandoffContext, isWindowsNativeExecutable, agentBinForPaneShell, resolveWinPaneShell } from "./agent-resolver.js";
 export { AitermError } from "./errors.js";
 export { tmuxSpawnEnv } from "./tmux-runtime.js";
@@ -306,7 +307,8 @@ function cleanupAgentState(name) {
                     f.endsWith(".cursor-result.json") ||
                     f.endsWith(".claude-operation.json") ||
                     f.endsWith(".claude-approval.json") ||
-                    f.endsWith(".claude-dispatch"))
+                    f.endsWith(".claude-dispatch") ||
+                    f.endsWith(".interim.json"))
                     fs.unlinkSync(p);
                 else if (f.endsWith(".codex-home") || f.endsWith(".grok-home") || f.endsWith(".cursor-plugin") || f.endsWith(".home")) {
                     fs.rmSync(p, { recursive: true, force: true });
@@ -1333,6 +1335,7 @@ export function killAll() {
                     f.endsWith(".claude-result.json") ||
                     f.endsWith(".claude-operation.json") ||
                     f.endsWith(".claude-dispatch") ||
+                    f.endsWith(".interim.json") ||
                     f.endsWith(".codex-home") ||
                     f.endsWith(".grok-home") ||
                     f.endsWith(".home")) {
@@ -1562,6 +1565,30 @@ function managedClaudeOperation(name) {
         return undefined;
     return readClaudeOperationMarker(meta);
 }
+function clearClaudeApiErrorOperation(meta) {
+    const file = agentClaudeOperationPath(meta.aiterm_session, meta.launch_id);
+    let marker;
+    try {
+        marker = fs.statSync(file);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return;
+        throw error;
+    }
+    if (!claudeApiErrorAfter(meta, marker.mtimeMs))
+        return;
+    // 読取中にStopや次のturnが印を置換した場合は、その新しい印を消さない。
+    try {
+        const current = fs.statSync(file);
+        if (current.dev === marker.dev && current.ino === marker.ino)
+            fs.unlinkSync(file);
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+}
 function canonicalClaudeApprovalScreen(screen) {
     return stripControl(screen)
         .split("\n")
@@ -2382,6 +2409,14 @@ async function settlePublishedClaudeCompletionMarker(meta, marker) {
     }
     return active;
 }
+/** BellTeamのため: agent sessionの現在（または直前）のturnの合間の言葉。agent sessionでなければnull。 */
+export function readSessionInterimWords(name, after) {
+    assertSessionName(name);
+    const dir = existingAgentsDir();
+    if (!dir || !fs.readdirSync(dir).some((f) => f.startsWith(`${name}.`) && f.endsWith(".agent.json")))
+        return null;
+    return readInterimWords(loadAgentMetadata(name), after);
+}
 /** agent harness の構造化 transcript から直近完了ターンの最終回答と相関情報を読む。 */
 export async function readAgentTranscriptResult(name, o = {}) {
     const meta = loadAgentMetadata(name);
@@ -3602,6 +3637,7 @@ export async function dispatchAgentTurn(name, text, o = {}) {
     prepareSendText(dispatchText, { raw: o.raw });
     await o.before_send?.({ session_id: name, launch_id: meta.launch_id, vendor: meta.kind,
         harness: agentHarness(meta.kind), event_cursor: startOffset, operation_id: operationId });
+    recordInterimBoundary(meta, startOffset, operationId);
     if (meta.kind === "claude") {
         // durable／anonymousを分岐する前に同じsend preflightを通す。拒否されるpromptの
         // receipt／active markerだけを残して、来ないStopを待つ状態を作らない。
@@ -3686,9 +3722,17 @@ export async function sendAgentMessage(name, text, o = {}) {
     const paneInputRecovery = await ensureAgentOwnsPaneInput(name, meta.kind);
     let running = isAgentTuiBusy(meta.kind, captureScreen(name, AGENT_TUI_READY_LINES));
     // Claudeのtool処理中は画面のbusy表示が消えることがある。Stopまで保持するturnの印を正とし、
-    // 印がある間は差し込み、Stop後は画面にbusy表示が残っても新しいturnとして送る。
-    if (meta.kind === "claude")
+    // APIエラーでStopが来なかった印は、会話記録の終了時刻を確認して消す。
+    // 有効な印がある間は差し込み、終了後は画面にbusy表示が残っても新しいturnとして送る。
+    if (meta.kind === "claude") {
+        clearClaudeApiErrorOperation(meta);
         running = readClaudeOperationMarker(meta) !== null;
+    }
+    // Cursorはturn_endedを記録へ書いたあとも、しばらく画面にbusy表示を残す。その間に差し込むと待ち行列へ入らず
+    // STEER_NOT_QUEUEDで失敗していた（実測 2026-09-28、完了通知の直後の送信で3回中2回）。記録の末尾がturn_endedなら
+    // turnは終わっているので新しいturnとして送る。dispatchは入力を受け付けるまで待ってから送る。
+    if (running && meta.kind === "cursor" && latestCursorCompletion(meta, readTranscriptLines) !== null)
+        running = false;
     if (running) {
         return steerRunningTurn(name, meta, text, { raw: o.raw, pane_input_recovery: paneInputRecovery });
     }

package/dist/harnesses/claude.js

@@ -9,7 +9,7 @@ import { fileURLToPath } from "node:url";
 import { AitermError } from "../errors.js";
 import { modeBitsWorldAccessible } from "../tmux-runtime.js";
 import { spawnAgentControlCommand } from "../agent-resolver.js";
-import { currentUid, writeJson0600, shq, subagentInstruction, writeScopeLaunchNote, agentEventPath, createEmpty0600, writeAgentMetadata, agentLineageFields, assertSessionName, agentsDir, LAUNCH_ID_RE, } from "../agent-shared.js";
+import { currentUid, writeJson0600, shq, subagentInstruction, writeScopeLaunchNote, agentEventPath, createEmpty0600, writeAgentMetadata, agentLineageFields, assertSessionName, agentsDir, LAUNCH_ID_RE, AGENT_EVENT_TAIL_BYTES, readFileRange, } from "../agent-shared.js";
 export const OPERATION_ID_RE = /^sha256:[0-9a-f]{64}$/;
 export const CLAUDE_RESULT_MAX_BYTES = 4 * 1024 * 1024;
 export const CLAUDE_EFFORTS = new Set(["low", "medium", "high", "xhigh", "max"]);
@@ -310,3 +310,26 @@ export function claudeApiErrorFromLine(line) {
         at: typeof record?.timestamp === "string" ? record.timestamp : null,
     };
 }
+// Stopが発火しないエラー終了を、現在のturn開始後の会話記録だけから判定する。
+export function claudeApiErrorAfter(meta, startedAtMs) {
+    const file = claudeSessionTranscriptPath(meta);
+    if (!file)
+        return null;
+    let size;
+    try {
+        size = fs.statSync(file).size;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return null;
+        throw error;
+    }
+    const lines = readFileRange(file, Math.max(0, size - AGENT_EVENT_TAIL_BYTES), size).toString("utf8").split("\n");
+    lines.pop(); // 改行まで書かれた記録だけを扱う。
+    for (const line of lines.reverse()) {
+        const error = claudeApiErrorFromLine(line);
+        if (error?.at && Date.parse(error.at) >= startedAtMs)
+            return error;
+    }
+    return null;
+}

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 { INTERIM_RESULT_META_KEY, interimRequestFromMeta } from "./interim-words.js";
 // package.json の version を実行時に読み、MCP initialize で配るサーバ版と一致させる。
 // createRequire を使うのは、import 属性 `with { type: "json" }` が Node 18.20+ 限定で
 // engines "node >=18"（18.0〜18.19）を SyntaxError で壊し、旧 `assert` 構文は逆に Node 22 で
@@ -587,16 +588,30 @@ registerRemoteAwareTool("pty_observe", {
             cpu_seconds: z.number().nullable(), cpu_delta_seconds: z.number().nullable(), cpu_delta_complete: z.boolean().nullable(),
             background_cpu_seconds: z.number().nullable(), background_cpu_delta_seconds: z.number().nullable(), background_cpu_delta_complete: z.boolean().nullable() }),
     },
-}, async ({ session_id, cursor }) => {
+}, async ({ session_id, cursor }, extra) => {
     try {
         const observation = core.observeSession(session_id, cursor);
         const result = { ...observation, ...(parentDelivery ? { parent_deliveries: parentDelivery.status(session_id) } : {}) };
-        return { ...ok(JSON.stringify(result)), structuredContent: { ...result } };
+        return { ...ok(JSON.stringify(result)), structuredContent: { ...result }, ...interimWordsMeta(session_id, extra._meta) };
     }
     catch (e) {
         return fail(e);
     }
 });
+// BellTeamのため: 要求の_metaに aiterm/caller="BellTeam" がある時だけ、結果の_metaへ合間の言葉を載せる。
+// 説明と引数には出さない（interim-words.ts の冒頭）。それ以外の呼び手には何も足さない。
+function interimWordsMeta(sessionId, requestMeta) {
+    const request = interimRequestFromMeta(requestMeta);
+    if (!request)
+        return {};
+    try {
+        const words = core.readSessionInterimWords(sessionId, request.after);
+        return words ? { _meta: { [INTERIM_RESULT_META_KEY]: words } } : {};
+    }
+    catch (e) {
+        return { _meta: { [INTERIM_RESULT_META_KEY]: { schema: "aiterm.interim-words.v1", error: e instanceof Error ? e.message : String(e) } } };
+    }
+}
 registerRemoteAwareTool("agent_approval", {
     description: "Codexの現在の承認をinspectし、digestへ束縛した単発許可または拒否をrespondする。恒久許可は選ばない。Claudeは既存claude_approvalを使う。未知dialogはblockedのtyped errorで返す。",
     inputSchema: {

package/dist/interim-words.js

@@ -0,0 +1,256 @@
+// 合間の言葉: agent sessionがturnの途中で書き、そのあと道具を使った言葉。
+// BellTeamのためにある。BellTeamは実行中のBotが何をしているかを会話画面へ出すため、
+// pty_observeのMCP要求の_metaに caller="BellTeam" を入れて呼び、結果の_metaでこれを受け取る。
+// 利用者向けのツール説明と引数には出さない（BellTeam以外のAIに指定させないため）。要らないものと見て消さないこと。
+//
+// 最後の回答と思考は含めない。APIエラーやsession limitの知らせは、記録に書かれていれば含める。
+// ハーネスごとの見分け方（2026-09-28 記録で確認）:
+//   Claude Code: text block で message.stop_reason="tool_use"。isApiErrorMessage の行は知らせ。
+//   Codex:       assistant message の phase="commentary"。
+//   Grok:        content が空でなく tool_calls を持つ assistant。
+//   Cursor:      assistant の text のあとに tool_use が続くもの（Cursorは道具が終わってから行を書くので遅れて届く）。
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { AitermError } from "./errors.js";
+import { agentHarness, agentsDir, assertSessionName, LAUNCH_ID_RE, readFileRange, safeStatSize, writeJson0600, } from "./agent-shared.js";
+import { claudeSessionTranscriptPath } from "./harnesses/claude.js";
+import { codexRootTranscript } from "./harnesses/codex.js";
+import { grokSessionDirectory } from "./harnesses/grok.js";
+import { cursorTranscript } from "./harnesses/cursor.js";
+/** BellTeamが要求の_metaへ入れる呼び手の印。値が "BellTeam" の時だけ合間の言葉を返す。 */
+export const INTERIM_CALLER_META_KEY = "aiterm/caller";
+export const INTERIM_CALLER = "BellTeam";
+/** 前回受け取った最後のseq。これより後の言葉だけを返す。 */
+export const INTERIM_AFTER_META_KEY = "aiterm/interim_after";
+/** 結果の_metaで返すキー。 */
+export const INTERIM_RESULT_META_KEY = "aiterm/interim_words";
+export function agentInterimBoundaryPath(name, launchId) {
+    assertSessionName(name);
+    if (!LAUNCH_ID_RE.test(launchId))
+        throw new AitermError(`launch_id が不正です: ${launchId}`, 2);
+    return path.join(agentsDir(), `${name}.${launchId}.interim.json`);
+}
+/** 要求の_metaがBellTeamの印を持つ時だけ、前回のseqを返す。それ以外はnull（何も足さない）。 */
+export function interimRequestFromMeta(meta) {
+    if (!meta || typeof meta !== "object")
+        return null;
+    const record = meta;
+    if (record[INTERIM_CALLER_META_KEY] !== INTERIM_CALLER)
+        return null;
+    const after = record[INTERIM_AFTER_META_KEY];
+    return { after: typeof after === "number" && Number.isSafeInteger(after) && after > 0 ? after : 0 };
+}
+function parse(line) {
+    if (!line.trim())
+        return null;
+    try {
+        return JSON.parse(line);
+    }
+    catch {
+        // 書込み途中の末尾行と、byte境界で切れた先頭行は読まない。
+        return null;
+    }
+}
+// ---------------------------------------------------------------- Claude Code
+function claudeText(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    return content.map((part) => (part?.type === "text" && typeof part.text === "string" ? part.text : "")).join("");
+}
+export function claudeInterimWords(lines) {
+    const words = [];
+    for (const line of lines) {
+        const record = parse(line);
+        if (record?.type !== "assistant" || record.isSidechain === true)
+            continue;
+        const at = typeof record.timestamp === "string" ? record.timestamp : null;
+        if (record.isApiErrorMessage === true) {
+            const text = claudeText(record.message?.content).trim();
+            if (text)
+                words.push({ text, kind: "error", at, turn_id: null });
+            continue;
+        }
+        if (record.message?.stop_reason !== "tool_use")
+            continue;
+        const text = claudeText(record.message?.content).trim();
+        if (text)
+            words.push({ text, kind: "interim", at, turn_id: null });
+    }
+    return words;
+}
+// ---------------------------------------------------------------- Codex
+export function codexInterimWords(lines) {
+    const words = [];
+    for (const line of lines) {
+        const record = parse(line);
+        const payload = record?.payload;
+        if (record?.type !== "response_item" || payload?.type !== "message" || payload?.role !== "assistant"
+            || payload?.phase !== "commentary" || !Array.isArray(payload?.content))
+            continue;
+        const text = payload.content
+            .map((item) => (item?.type === "output_text" && typeof item.text === "string" ? item.text : ""))
+            .join("")
+            .trim();
+        if (!text)
+            continue;
+        const turnId = payload.internal_chat_message_metadata_passthrough?.turn_id;
+        words.push({
+            text,
+            kind: "interim",
+            at: typeof record.timestamp === "string" ? record.timestamp : null,
+            turn_id: typeof turnId === "string" && turnId ? turnId : null,
+        });
+    }
+    return words;
+}
+// ---------------------------------------------------------------- Grok
+function grokRealUser(record) {
+    return record?.type === "user" && !("synthetic_reason" in record);
+}
+export function grokUserCount(lines) {
+    let count = 0;
+    for (const line of lines)
+        if (grokRealUser(parse(line)))
+            count++;
+    return count;
+}
+/** boundary+1番目のuser発話（このturnの依頼）以後のassistantのうち、言葉と道具の呼び出しを両方持つもの。 */
+export function grokInterimWords(lines, boundary) {
+    const words = [];
+    let users = 0;
+    for (const line of lines) {
+        const record = parse(line);
+        if (grokRealUser(record))
+            users++;
+        if (users <= boundary || record?.type !== "assistant")
+            continue;
+        if (!Array.isArray(record.tool_calls) || record.tool_calls.length === 0)
+            continue;
+        const text = typeof record.content === "string" ? record.content.trim() : "";
+        if (text)
+            words.push({ text, kind: "interim", at: null, turn_id: null });
+    }
+    return words;
+}
+// ---------------------------------------------------------------- Cursor
+/**
+ * boundary+1番目のuser発話（このturnの依頼）以後で、あとにtool_useが続いたtextの塊。
+ * 次にuser発話かturn_endedが来た塊はそのturnの最後の回答なので含めない。末尾で行き先が決まっていない塊も待つ。
+ */
+export function cursorInterimWords(lines, boundary) {
+    const words = [];
+    let users = 0;
+    let pending = [];
+    for (const line of lines) {
+        const record = parse(line);
+        if (!record)
+            continue;
+        if (record.role === "user" || record.type === "turn_ended") {
+            if (record.role === "user")
+                users++;
+            pending = [];
+            continue;
+        }
+        if (record.role !== "assistant" || !Array.isArray(record.message?.content))
+            continue;
+        for (const part of record.message.content) {
+            if (part?.type === "text" && typeof part.text === "string")
+                pending.push(part.text);
+            else if (part?.type === "tool_use") {
+                const text = pending.join("\n").trim();
+                if (text && users > boundary)
+                    words.push({ text, kind: "interim", at: null, turn_id: null });
+                pending = [];
+            }
+        }
+    }
+    return words;
+}
+// ---------------------------------------------------------------- 境界と読み取り
+function claudeTranscriptSize(meta) {
+    const file = claudeSessionTranscriptPath(meta);
+    return file ? safeStatSize(file) : 0;
+}
+function grokChatHistory(meta) {
+    const dir = grokSessionDirectory(meta);
+    return dir ? path.join(dir, "chat_history.jsonl") : null;
+}
+function readLines(file, from = 0) {
+    if (!file)
+        return [];
+    const size = safeStatSize(file);
+    if (size <= from)
+        return [];
+    return readFileRange(file, from, size).toString("utf8").split("\n");
+}
+/**
+ * dispatchの送信直前に、このturnの言葉が記録のどこから始まるかを残す。
+ * eventCursorはdispatch receiptのevent_cursor（Codex・Cursorでは境界そのもの）。
+ * 失敗してもdispatchは止めない。境界が古いままでも、呼び手はevent_cursorの不一致で気づける。
+ */
+export function recordInterimBoundary(meta, eventCursor, operationId) {
+    try {
+        let boundary;
+        if (meta.kind === "claude")
+            boundary = claudeTranscriptSize(meta);
+        else if (meta.kind === "grok")
+            boundary = grokUserCount(readLines(grokChatHistory(meta)));
+        else
+            boundary = eventCursor;
+        const value = {
+            schema: "aiterm.interim-boundary.v1",
+            event_cursor: eventCursor,
+            operation_id: operationId,
+            boundary,
+            dispatched_at: new Date().toISOString(),
+        };
+        writeJson0600(agentInterimBoundaryPath(meta.aiterm_session, meta.launch_id), value);
+    }
+    catch {
+        /* 合間の言葉は表示のためだけにある。送信を妨げない。 */
+    }
+}
+function readInterimBoundary(meta) {
+    let value;
+    try {
+        value = JSON.parse(fs.readFileSync(agentInterimBoundaryPath(meta.aiterm_session, meta.launch_id), "utf8"));
+    }
+    catch {
+        return null;
+    }
+    if (value?.schema !== "aiterm.interim-boundary.v1" || !Number.isSafeInteger(value.boundary) || value.boundary < 0
+        || !Number.isSafeInteger(value.event_cursor))
+        return null;
+    return value;
+}
+/** 現在（または直前）のturnで書かれた合間の言葉のうち、seqがafterより後のもの。 */
+export function readInterimWords(meta, after) {
+    const recorded = readInterimBoundary(meta);
+    // dispatchの記録が無ければ、起動時promptのturnだけを記録の先頭から読む。promptなしで起動してまだ送っていない時は無い。
+    const launchTurn = !recorded && meta.initial_prompt !== "none";
+    let found = [];
+    if (recorded || launchTurn) {
+        const boundary = recorded?.boundary ?? 0;
+        if (meta.kind === "claude")
+            found = claudeInterimWords(readLines(claudeSessionTranscriptPath(meta), boundary));
+        else if (meta.kind === "codex")
+            found = codexInterimWords(readLines(codexRootTranscript(meta), boundary));
+        else if (meta.kind === "grok")
+            found = grokInterimWords(readLines(grokChatHistory(meta)), boundary);
+        else
+            found = cursorInterimWords(readLines(cursorTranscript(meta)), boundary);
+    }
+    const words = found.map((word, index) => ({ seq: index + 1, ...word }));
+    return {
+        schema: "aiterm.interim-words.v1",
+        session_id: meta.aiterm_session,
+        launch_id: meta.launch_id,
+        harness: agentHarness(meta.kind),
+        event_cursor: recorded?.event_cursor ?? null,
+        operation_id: recorded?.operation_id ?? null,
+        last_seq: words.length,
+        words: words.filter((word) => word.seq > after),
+    };
+}

package/docs/DESIGN.md

@@ -67,7 +67,7 @@ Grokの記録先はCLIと同じOS絶対パスへcwdを正規化して導出し
 agent sessionへの送信口は`pty_send`だけとする。子の状態は呼び出し側に選ばせず、Aitermが送る時点の画面で振り分ける。
 状態を見てから呼ぶまでの間に子のturnが変わるため、呼び出し側が入口を選ぶ形では外れる。
 実行中なら現在のturnへ追加textを差し込み、新しい完了境界と配送は作らない。完了境界は差し込み後も1つに保つ。
-Claude Codeはtool処理中に画面の実行中表示が消え、Stop hookの実行中には表示が残る。Stopで消えるturnの印だけを実行中判定の正本とする。
+Claude Codeはtool処理中に画面の実行中表示が消え、Stop hookの実行中には表示が残る。turnの印を実行中判定の正本とする。Stopが発火しないAPIエラー終了では、次の送信時に印の作成後の会話記録にある`isApiErrorMessage`を確認し、終了したturnの印だけを解除する。過去のエラーで新しい印を解除しない。waiterは印を変更せず、読取専用のままエラーを返す。
 それ以外は新しい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.2",
+  "version": "0.42.0",
   "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": [