aiterm-mcp 0.55.2 → 0.55.3

package/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.55.3] - 2026-10-06
+
+### 修正
+
+- Claude Code親からの呼び出しを誤りで返す時、その呼び出しの置き場（Aiterm stateの`claude-parent-hooks/<tool_use_id>/`）を
+  返す前に消す（ADR 0096、`aiterm-steer-delivery` 0.2.3）。Claude Codeは誤りの返りで`PostToolUse`のhookを走らせないので、
+  `request.json`だけの置き場が、1日後の見回りまで残っていた。連携元の本番で、`harness: "claude-code"`へ`write_scope`を
+  付けて断られた`agent_launch`の置き場が残っているのを見た。
+  - 消すのは、配送を結んでいない置き場だけ。配送を結んだ後に誤りで返した呼び出しの置き場は、今までどおり残す。
+  - 入力の検査で断る返りと、handlerの例外から作られる返りでも消す。
+  - Claude Codeが自分で断った呼び出し（引数が道具の定義に合わない）と、Claude側で打ち切られた呼び出しは、Aitermへ
+    返りが渡らないので、今までどおり1日後の見回りが消す。
+  - 道具の返り、配送の記録、hookの登録は変わらない。`aiterm-setup`の流し直しは要らない。
+
 ## [0.55.2] - 2026-10-06
 
 ### 修正
@@ -2283,7 +2297,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.55.2...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.55.3...HEAD
+[0.55.3]: https://github.com/kitepon/aiterm-mcp/compare/v0.55.2...v0.55.3
 [0.55.2]: https://github.com/kitepon/aiterm-mcp/compare/v0.55.1...v0.55.2
 [0.55.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.55.0...v0.55.1
 [0.55.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.54.0...v0.55.0

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.55.2** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.55.3** · 動作対象は 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.55.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.55.3** · 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/claude-parent-receiver.js

@@ -17,6 +17,10 @@ export function claudeParentFromRequest(clientName, metadata, root = defaultRoot
 }
 export function verifyClaudeParent(parent) { steer.verifyClaudeParent(AITERM_PROFILE, parent); }
 export function bindClaudeParentDelivery(parent, deliveryId) { steer.bindClaudeParentDelivery(AITERM_PROFILE, parent, deliveryId); }
+/** 誤りで返す呼び出しの置き場を消す。配送を結んだ置き場は消さない。 */
+export function discardClaudeHookRequest(clientName, metadata, root = defaultRoot()) {
+    return steer.discardClaudeHookRequest(clientName, metadata, root);
+}
 /** SessionEndはその時点の依頼だけを終了する。同じ会話をresumeした新規依頼は別requestになる。 */
 export function closeClaudeParentSession(input, root = defaultRoot()) { steer.closeClaudeParentSession(input, root); }
 export function submitClaudeParentAnswer(parent, deliveryId, text) {

package/dist/index.js

@@ -11,6 +11,7 @@
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { z } from "zod";
 import { agentModelsResult } from "./model-catalog.js";
 import * as core from "./core.js";
@@ -20,7 +21,7 @@ import { createRequire } from "node:module";
 import { ParentDeliveryManager, deliveryKey } from "./parent-delivery.js";
 import { acceptRemote, callRemoteTool, observeRemoteAgentDone, remoteInputDescription, remoteInputSchema, remoteLabel, remoteWaitProcess } from "./remote.js";
 import { codexParentFromRequest } from "./codex-parent-receiver.js";
-import { claudeParentFromRequest } from "./claude-parent-receiver.js";
+import { claudeParentFromRequest, discardClaudeHookRequest } from "./claude-parent-receiver.js";
 import { parentDeliveryDiagnostic } from "./parent-hook-diagnostic.js";
 import { cursorParentFromRequest, isCursorMcpClient } from "./cursor-parent-receiver.js";
 import { waitProcessCommandLine } from "./cursor-parent-receive.js";
@@ -31,6 +32,20 @@ import { INTERIM_RESULT_META_KEY, interimRequestFromMeta } from "./interim-words
 // 除去済み＝どちらの静的構文も 18〜22 全域を満たせないため（実行時 require が唯一全域で動く）。
 const pkg = createRequire(import.meta.url)("../package.json");
 const server = new McpServer({ name: "aiterm", version: pkg.version });
+// 誤りの返りでは、Claude Code親は受け口のPostToolUse hookを走らせず、配送を結ばなかった呼び出しの置き場が残る。
+// 返す前にここで消す（ADR 0096）。McpServerは入力の検査の失敗やhandlerの例外も誤りの返りへ変えるので、
+// toolごとのhandlerではなくtools/callの返りを見る。McpServerがそのhandlerを置くのは最初のtool登録の時で、その前に包む。
+const setRequestHandler = server.server.setRequestHandler.bind(server.server);
+server.server.setRequestHandler = ((schema, handler) => setRequestHandler(schema, schema !== CallToolRequestSchema ? handler : async (request, extra) => {
+    const result = await handler(request, extra);
+    // 片付けの失敗で返りを変えない。残った置き場は、後の依頼のhookが見回って消す。
+    if (result?.isError)
+        try {
+            await discardClaudeHookRequest(server.server.getClientVersion()?.name, extra._meta);
+        }
+        catch { /* 見回りへ回す */ }
+    return result;
+}));
 let parentDelivery = null;
 // 別端末の子の配送。記録の保存場所を分けるため、この端末の子とは別のmanagerにする。
 let remoteParentDelivery = null;

package/docs/DESIGN.md

@@ -187,6 +187,7 @@ hookはNodeの実行ファイルと引数配列で直接起動し、shellやWind
 hookとの受け渡しはAiterm stateの`claude-parent-hooks`へ、道具の呼び出しごとの置き場として置く。
 届いた置き場は、送り手がhookの出し終えた記録を確かめた時に消す。届かなかった置き場と、配送を結ばなかった置き場は1日残し、
 次の依頼の`PreToolUse`のhookが消す。依頼元が居て配送を待っている置き場は残す（ADR 0094）。
+誤りで返す呼び出しは、Claude Codeが`PostToolUse`を走らせないので、配送を結んでいない置き場をAitermが返す前に消す（ADR 0096）。
 
 hookの登録は、`args`を使わずshellを通す1行で書く（ADR 0089）。POSIXは`exec '<node>' '<hook>'`、Windowsは
 `& '<node>' '<hook>'; exit (Get-Variable LASTEXITCODE -ValueOnly)`と`shell: "powershell"`。同じ設定をGrokも読み、

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.55.2",
+  "version": "0.55.3",
   "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": [
@@ -71,7 +71,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "aiterm-steer-delivery": "^0.2.2",
+    "aiterm-steer-delivery": "^0.2.3",
     "ws": "8.21.3",
     "zod": "^4.4.3"
   },