aiterm-mcp 0.38.0 → 0.38.2

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.38.2] - 2026-09-25
+
+### 修正
+
+- Claude Code初回起動時のテーマ選択を、画面で選択済みの項目を確定して通過する。続くログイン方式の選択は入力欄と誤認せず、公式CLIでの初回設定が必要と明示する。
+- WindowsのCursor親受け口試験で、Windows専用の起動引数を誤って`null`と期待していた判定を修正する。
+
+## [0.38.1] - 2026-09-22
+
+### 修正
+
+- Cursor親のhookへ渡るtool結果は本文だけで、`structuredContent`の`delivery_id`が落ちる。dispatchの本文へ`delivery_id`行を出し、hookがその行から会話へ束縛する。
+
 ## [0.38.0] - 2026-09-22
 
 ### 追加
@@ -1738,7 +1751,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.38.0...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.38.2...HEAD
+[0.38.2]: https://github.com/kitepon/aiterm-mcp/compare/v0.38.1...v0.38.2
+[0.38.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.38.0...v0.38.1
 [0.38.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.10...v0.38.0
 [0.37.10]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.9...v0.37.10
 [0.37.9]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.8...v0.37.9

package/README.ja.md

@@ -202,7 +202,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.38.0** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.38.2** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -486,6 +486,8 @@ aiterm は同じ核心の洞察——端末を出会いの場にする——を
 
 `agent_launch({ harness, cwd, trust_project: true })`はpromptなしでも既知のworkspace・project hooks・MCP初期同意を
 進め、入力受付とharness生存を確認して`startup.status="ready"`を返す。指定なしのpromptなし起動は`not_checked`。
+Claude Code初回起動の文字表示テーマ選択では、画面で選択済みの項目を確定して起動を続ける。
+続いてログイン方式の選択が出た場合は`vendor_onboarding_required`を返す。公式の対話型Claude Code CLIで初回設定を完了する。
 WindowsのCodexもhook確認を認識し、npm shim経由の起動を一つのharnessとして識別する。
 初手の`initial_prompt.status`は`not_requested`／`not_sent`／`submitted_unconfirmed`／`started`を区別する。
 未送信・未確認の失敗もsession付きstructuredContentを保持する。未確認のpromptを再送せず、返ったcursorで観測する。

package/README.md

@@ -216,7 +216,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.38.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.38.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
 
@@ -517,6 +517,8 @@ displayed token count or null. Callers do not need raw argv or pane-text parsing
 
 `agent_launch({ harness, cwd, trust_project: true })` completes known workspace, project-hook, and project-MCP startup
 consent even without a prompt, then verifies input readiness and harness liveness before returning `startup.status="ready"`.
+For Claude Code's first-run text-style menu, it confirms the item already selected on screen before continuing startup.
+If the CLI then requests an account login method, the launch reports `vendor_onboarding_required`; complete that choice in the official interactive Claude Code CLI.
 A prompt-free launch without this option retains `startup.status="not_checked"`. `initial_prompt.status` distinguishes
 `not_requested`, `not_sent`, `submitted_unconfirmed`, and `started`. Failure responses retain structured session information.
 WindowsのCodexもhook確認を認識し、npm shim経由の起動を一つのharnessとして識別する。

package/dist/cursor-parent-receiver.js

@@ -126,7 +126,7 @@ function deliveryIdFromResult(value, depth = 0) {
             if (entry !== null && typeof entry === "object" && entry.type === "text") {
                 const text = entry.text;
                 if (typeof text === "string") {
-                    const id = deliveryIdFromResult(text, depth + 1);
+                    const id = deliveryIdFromResult(text, depth + 1) ?? deliveryIdInText(text);
                     if (id)
                         return id;
                 }
@@ -135,6 +135,14 @@ function deliveryIdFromResult(value, depth = 0) {
     }
     return null;
 }
+function deliveryIdInText(text) {
+    for (const line of text.split("\n")) {
+        const match = /^delivery_id=([0-9a-f-]{36})$/i.exec(line.trim());
+        if (match && deliveryIdSchema.safeParse(match[1]).success)
+            return match[1];
+    }
+    return null;
+}
 function toolBaseName(name) {
     const tail = name.split(/[:.]/).pop() ?? name;
     return tail.replace(/^mcp__aiterm__/, "");

package/dist/harnesses/claude.js

@@ -180,6 +180,8 @@ export function claudeLaunchNote(model, effort, meta) {
 export function claudeTuiReady(screen) {
     if (!screen.includes("Claude Code"))
         return false;
+    if (claudeLoginMethodMenu(screen))
+        return false;
     const lastMarker = screen.split(/\r?\n/u).filter((line) => /^\s*❯/u.test(line)).at(-1)?.trim();
     if (!lastMarker)
         return false;
@@ -190,6 +192,8 @@ export function claudeTuiReady(screen) {
 }
 export function claudePaneObservation(screen) {
     const tail = screen.split("\n").slice(-32).join("\n");
+    if (claudeLoginMethodMenu(screen))
+        return { state: "blocked", reason: "vendor_onboarding_required" };
     if (/Do you want to proceed\?/.test(tail) && /(?:^|\n)\s*[❯>]?\s*\d+\.\s+(?:Yes|No)\s*$/m.test(tail))
         return { state: "blocked", reason: "tool_approval" };
     if (/esc to interrupt/i.test(tail))
@@ -202,7 +206,18 @@ export function claudePaneObservation(screen) {
         return { state: "blocked", reason: "startup_dialog" };
     return { state: "unknown", reason: "unrecognized_screen" };
 }
+function claudeLoginMethodMenu(screen) {
+    const tail = screen.split("\n").slice(-32).join("\n");
+    const lastMarker = tail.split(/\r?\n/u).filter(line => /^\s*❯/u.test(line)).at(-1)?.trim();
+    return tail.includes("Select login method:")
+        && /^❯\s*(?:Claude account with subscription|Anthropic Console account|3rd-party platform)/u.test(lastMarker ?? "");
+}
 export function claudeStartupAction(screen, trustProject) {
+    const tail = screen.split("\n").slice(-32).join("\n");
+    const lastMarker = tail.split(/\r?\n/u).filter(line => /^\s*❯/u.test(line)).at(-1)?.trim();
+    if (tail.includes("Choose the text style that looks best with your terminal")
+        && /^❯\s*[1-7]\.\s*(?:Auto \(match terminal\)|Dark mode|Light mode)/u.test(lastMarker ?? ""))
+        return { kind: "initial_theme_selected", keys: ["Enter"] };
     // 既存launcherで扱っていた2確認は従来の起動契約を維持する。
     if (screen.includes("Is this a project you created or one you trust")
         && screen.includes("No, exit") && screen.includes("Yes, I trust this folder"))

package/dist/index.js

@@ -42,6 +42,10 @@ async function deliveryForRequest(extra) {
     await parentDelivery.prepare(parent);
     return parentDelivery.request(parent);
 }
+function deliveryIdLine(delivery) {
+    const id = delivery?.result()?.delivery_id;
+    return id ? `\ndelivery_id=${id}` : "";
+}
 function completionWait(delivery, session, eventCursor) {
     if (eventCursor === null)
         return { wait_process: null, wait_command: null };
@@ -213,7 +217,8 @@ server.registerTool("pty_send", {
                         type: "text",
                         text: `dispatchした（harness=${receipt.harness}, vendor=${receipt.vendor}）。\n` +
                             core.agentDispatchGuide(receipt.session_id, receipt.event_cursor) +
-                            core.agentSubmitResidueWarning(receipt.session_id, receipt.submit_residue),
+                            core.agentSubmitResidueWarning(receipt.session_id, receipt.submit_residue) +
+                            deliveryIdLine(delivery),
                     },
                 ],
                 structuredContent: {
@@ -718,7 +723,7 @@ async function launchAgent(kind, args, extra) {
                 : {}),
         };
         return {
-            content: [{ type: "text", text: `session_id: ${sid}\n${hint}` }],
+            content: [{ type: "text", text: `session_id: ${sid}\n${hint}${deliveryIdLine(delivery)}` }],
             structuredContent: structured,
             ...(initialDelivery.status === "submitted_unconfirmed" ? { isError: true } : {}),
         };

package/docs/DESIGN.md

@@ -171,6 +171,8 @@ APIエラー監視の参照先を一致させ、監視中のリンク変更で
 hookを外す時は`aiterm-setup --remove-cursor-parent-hooks`で専用entryだけを解除する。
 
 `trust_project:true`は対象projectの既知のworkspace、hooks、MCP初期同意を起動準備として進める意図である。
+Claude Codeの初回テーマ選択は選択済みの項目を確定し、後続の起動準備へ進める。
+ログイン方式の選択はユーザーのアカウント設定として扱い、composerと誤認せず`vendor_onboarding_required`で止める。
 promptなしでも入力受付とharness生存を確認して`startup.ready`を返す。指定なしのpromptなし起動は
 従来どおり`startup.not_checked`で返す。初手receiptは未要求・未送信・送信済み未確認・開始確認を分ける。
 開始の証拠は送信後の実行表示、実行中の既知承認、または同じcursor以降の完了だけとし、残存なしでは代用しない。

package/package.json

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