aiterm-mcp 0.37.0 → 0.37.2

package/dist/windows-codex-setup.js

@@ -1,18 +1,20 @@
 // gpt-connectorのWindows実装をMIT条件で移植。実行時の外部製品依存は持たない。
 // Windows Desktop用の実行file、ユーザー環境変数、親processの接続確認を所有する。
 import { existsSync, readFileSync, writeFileSync, renameSync, readdirSync, rmSync } from "node:fs";
-import { join, dirname } from "node:path";
+import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { spawnSync } from "node:child_process";
 import { randomUUID, createHash } from "node:crypto";
 import { homedir } from "node:os";
-import { relayConfigDirectory, readRelayConfig } from "./codex-relay-config.js";
+import { relayConfigDirectory } from "./codex-relay-config.js";
 import { SetupError } from "./setup-platform.js";
 import { verifyRelayLauncher } from "./setup-codex-relay.js";
 import { withCodexRelay } from "./codex-relay-client.js";
 import { windowsPowerShellSync, quotePowerShell } from "./windows-codex-state.js";
 import { ensurePrivateDirectory, makeFilePrivate } from "./windows-codex-state.js";
-import { readWindowsRelay, windowsDesktopRelay } from "./windows-codex-connection.js";
+import { windowsDesktopRelay } from "./windows-codex-connection.js";
+import { configureRelay } from "./codex-relay-setup.js";
+import { windowsLauncherSource } from "./windows-codex-launcher.js";
 export function findWindowsCodexCache(resources, cache) {
     // Desktopが展開した4実行fileを配布元と照合する。展開・更新はDesktop自身が所有する。
     const names = ["codex.exe", "codex-code-mode-host.exe", "codex-windows-sandbox-setup.exe", "codex-command-runner.exe"];
@@ -60,48 +62,7 @@ $result = [UIntPtr]::Zero
 [void][AitermEnvironment]::SendMessageTimeout([IntPtr]0xffff, 0x1a, [UIntPtr]::Zero, 'Environment', 2, 5000, [ref]$result)
 `, 10_000);
 }
-export function windowsLauncherSource(node, relay, binary, root) {
-    return `using System;
-using System.Diagnostics;
-using System.Text;
-public static class AitermLauncher {
-  static async System.Threading.Tasks.Task Input(Process child) {
-    var input = Console.OpenStandardInput(); var output = child.StandardInput.BaseStream;
-    var buffer = new byte[8192]; int count;
-    while ((count = await input.ReadAsync(buffer, 0, buffer.Length)) > 0) {
-      await output.WriteAsync(buffer, 0, count); await output.FlushAsync();
-    }
-    child.StandardInput.Close();
-  }
-  static string Quote(string text) {
-    var result = new StringBuilder().Append('"'); int slashes = 0;
-    foreach (char c in text) {
-      if (c == '\\\\') { slashes++; continue; }
-      if (c == '"') { result.Append('\\\\', slashes * 2 + 1); result.Append(c); }
-      else { result.Append('\\\\', slashes); result.Append(c); }
-      slashes = 0;
-    }
-    result.Append('\\\\', slashes * 2); return result.Append('"').ToString();
-  }
-  public static int Main(string[] args) {
-    try {
-      var arguments = new StringBuilder();
-      foreach (var value in new string[] { ${[relay, binary, root].map(value => JSON.stringify(value)).join(", ")} }) arguments.Append(Quote(value)).Append(' ');
-      foreach (var value in args) arguments.Append(Quote(value)).Append(' ');
-      var start = new ProcessStartInfo(${JSON.stringify(node)}, arguments.ToString());
-      start.UseShellExecute = false; start.CreateNoWindow = true;
-      start.RedirectStandardInput = true; start.RedirectStandardOutput = true; start.RedirectStandardError = true;
-      using (var child = Process.Start(start)) {
-        Input(child).ContinueWith(task => { if (task.IsFaulted && !child.HasExited) child.Kill(); });
-        var output = child.StandardOutput.BaseStream.CopyToAsync(Console.OpenStandardOutput());
-        var error = child.StandardError.BaseStream.CopyToAsync(Console.OpenStandardError());
-        child.WaitForExit(); System.Threading.Tasks.Task.WaitAll(output, error); return child.ExitCode;
-      }
-    } catch { Console.Error.WriteLine("aiterm-mcp: Windows中継を起動できません"); return 1; }
-  }
-}
-`;
-}
+export { windowsLauncherSource } from "./windows-codex-launcher.js";
 export function buildWindowsLauncher(directory, source) {
     const digest = createHash("sha256").update(source).digest("hex").slice(0, 16);
     const launcher = join(directory, `codex-${digest}.exe`);
@@ -113,80 +74,38 @@ export function buildWindowsLauncher(directory, source) {
         throw new SetupError("codex_launcher_compiler_unavailable", "Windows標準.NET Frameworkのコンパイラが見つかりません。");
     writeFileSync(sourceFile, source);
     makeFilePrivate(sourceFile);
-    const result = spawnSync(compiler, ["/nologo", "/target:exe", `/out:${launcher}`, sourceFile], { encoding: "utf8", windowsHide: true, timeout: 20_000 });
+    const result = spawnSync(compiler, ["/nologo", "/target:exe", "/reference:System.Runtime.Serialization.dll", `/out:${launcher}`, sourceFile], { encoding: "utf8", windowsHide: true, timeout: 20_000 });
     if (result.status !== 0)
         throw new SetupError("codex_launcher_build_failed", "Windows用のCodex起動fileを作成できません。");
     makeFilePrivate(launcher);
     return launcher;
 }
 async function live(config) {
-    const file = windowsDesktopRelay(config.launcher);
+    const file = windowsDesktopRelay(config.launcher, undefined, config.socket_root);
     if (!file)
         return false;
     await withCodexRelay(file, request => request("thread/loaded/list", { limit: 1 }));
     return true;
 }
+export function windowsCodexRuntime(overrides = {}) {
+    const directory = overrides.directory ?? relayConfigDirectory();
+    const runtime = {
+        directory, socket_root: join(directory, "sessions"), node: process.execPath,
+        relay: fileURLToPath(new URL("./windows-codex-relay.js", import.meta.url)),
+        findBinary: findWindowsCodexBinary, getGui, setGui, verify: verifyRelayLauncher, live,
+        // User環境変数はsetGuiの一操作で永続化される。
+        persist: () => { }, unpersist: () => { }, prepare: ensurePrivateDirectory, save,
+        build: async (binary) => {
+            ensurePrivateDirectory(runtime.socket_root);
+            const launcher = buildWindowsLauncher(runtime.directory, windowsLauncherSource(runtime.node, runtime.relay, binary, runtime.socket_root));
+            await runtime.verify(launcher);
+            return launcher;
+        }, ...overrides,
+    };
+    return runtime;
+}
 export async function configureWindowsCodexSteer(action, overrides = {}) {
-    const runtime = { directory: relayConfigDirectory(), node: process.execPath,
-        relay: fileURLToPath(new URL("./windows-codex-relay.js", import.meta.url)), findBinary: findWindowsCodexBinary, getGui, setGui,
-        verify: verifyRelayLauncher, live,
-        shared: async (launcher) => {
-            const file = windowsDesktopRelay(launcher);
-            if (!file)
-                return null;
-            await withCodexRelay(file, request => request("thread/loaded/list", { limit: 1 }));
-            return { binary: readWindowsRelay(file).binary, root: dirname(dirname(file)) };
-        }, ...overrides };
-    const previous = readRelayConfig(runtime.directory);
-    const current = runtime.getGui("CODEX_CLI_PATH");
-    if (action === "status") {
-        if (!previous?.enabled)
-            return { status: "disabled" };
-        if (current !== previous.launcher)
-            return { status: "failed", reason_code: "codex_steer_configuration_changed" };
-        return await runtime.live(previous) ? { status: "ready" } : { status: "restart_required", reason_code: "codex_restart_required" };
-    }
-    if (action === "disable") {
-        if (!previous?.enabled)
-            return { status: "disabled" };
-        if (current !== previous.launcher)
-            throw new SetupError("codex_steer_configuration_changed", "変更されたCodex起動設定は上書きしません。");
-        if (previous.launcher !== previous.previous_cli_path)
-            runtime.setGui("CODEX_CLI_PATH", previous.previous_cli_path);
-        if (runtime.getGui("CODEX_CLI_PATH") !== previous.previous_cli_path)
-            throw new SetupError("codex_steer_readback_failed", "元の起動設定を確認できません。");
-        save(runtime.directory, { ...previous, enabled: false });
-        return { status: "restart_required", reason_code: "codex_restart_required" };
-    }
-    if (previous?.enabled && previous.launcher !== previous.previous_cli_path && ![previous.launcher, previous.previous_cli_path].includes(current)) {
-        throw new SetupError("codex_steer_configuration_changed", "変更されたCodex起動設定は上書きしません。");
-    }
-    if (current && (current !== previous?.launcher || previous.launcher === previous.previous_cli_path)) {
-        const shared = await runtime.shared(current);
-        if (!shared)
-            throw new SetupError("codex_steer_configuration_conflict", "別のCodex起動設定との互換接続を確認できないため変更していません。");
-        ensurePrivateDirectory(runtime.directory);
-        save(runtime.directory, { schema: "aiterm.codex-relay.v1", enabled: true, binary: shared.binary,
-            node: runtime.node, launcher: current, socket_root: shared.root, previous_cli_path: current });
-        return { status: "ready" };
-    }
-    for (const key of ["CODEX_APP_SERVER_WS_URL", "CODEX_APP_SERVER_USE_LOCAL_DAEMON", "CODEX_APP_SERVER_FORCE_CLI"]) {
-        if (runtime.getGui(key))
-            throw new SetupError("codex_steer_configuration_conflict", `${key}が設定されているため変更していません。`);
-    }
-    ensurePrivateDirectory(runtime.directory);
-    const binary = runtime.findBinary();
-    const root = join(runtime.directory, "sessions");
-    ensurePrivateDirectory(root);
-    const launcher = buildWindowsLauncher(runtime.directory, windowsLauncherSource(runtime.node, runtime.relay, binary, root));
-    await runtime.verify(launcher);
-    const config = { schema: "aiterm.codex-relay.v1", enabled: true, binary, node: runtime.node, launcher,
-        socket_root: root, previous_cli_path: previous?.enabled && previous.launcher !== previous.previous_cli_path ? previous.previous_cli_path : current };
-    save(runtime.directory, config);
-    runtime.setGui("CODEX_CLI_PATH", launcher);
-    if (runtime.getGui("CODEX_CLI_PATH") !== launcher)
-        throw new SetupError("codex_steer_readback_failed", "WindowsのCodex起動設定を確認できません。");
-    return await runtime.live(config) ? { status: "ready" } : { status: "restart_required", reason_code: "codex_restart_required" };
+    return configureRelay(action, windowsCodexRuntime(overrides));
 }
 function save(directory, config) {
     const file = join(directory, `${randomUUID()}.tmp`);

package/docs/DESIGN.md

@@ -34,6 +34,8 @@ psmuxが出力した余分な環境値を返さない。通常PTYとagentへ`AIT
 
 `pty_observe`は存在、pane／harnessの生存、画面状態と理由、native process identityを分ける。
 PIDは開始識別子・argv digestと組にし、paneとharnessを同一視しない。特定できないidentityはnull。
+同じlaunchに属するnpm shimとnative本体は、中間の非候補processも含めた祖先関係から一つの起動として扱う。
+祖先を共有しない候補は別々に残し、複数候補を一つと推測しない。
 POSIXの停止状態はOSのprocess表から取得し、SIGSTOP中は残画面より優先して`blocked/harness_stopped`を返す。
 画面本文とargv本文は返さず、活動cursorには画面digestとprocess別CPUだけを持たせる。
 初回とpane再作成後の差分はnull。区間中にprocessが消えた時は観測できたCPU増分だけを返し、
@@ -66,7 +68,7 @@ Cursorのsubmitはadapterがextended keyboard protocolのEnterへ変換し、呼
 宛先はCodexのMCP handshakeと各要求の`_meta.threadId`から取得する。modelが指定したIDや環境変数で代用しない。
 単品導入の`src/codex-parent-receiver.ts`は同じ`CODEX_HOME`の公式app-serverへstdioで接続し、
 `thread/read`と`thread/queue/list`で宛先を確認してから`thread/queue/add`へ本文をJSONで渡す。
-Steerを選択したmacOS Desktopでは、MCP processの祖先にある公式App Serverの本人所有socketへ接続する。
+Steerを選択したmacOS・Windows Desktopでは、MCP processの祖先にある公式App Serverの本人専用接続へ接続する。
 `thread/loaded/list`と`thread/read`で同じ親を確認し、公式`turn/start`へ一度だけ送る。
 公式の`start_or_steer_turn`が実行中なら同じturnへ追加入力し、終了後なら同じtaskの次turnを開始する。
 状態を読んでから送信方法を選ぶraceや再送は作らない。model・権限のoverrideも渡さない。
@@ -82,17 +84,20 @@ macOSのユーザーLaunchAgentはログイン時に同じ起動設定を適用
 保存した元の`CODEX_CLI_PATH`へ戻す。他から変更された設定は上書きしない。
 `status=ready`は公式binary・Desktopの直接子・同じsocketのRPC応答を確認した場合だけ返す。
 初回の設定保存後は`restart_required`であり、Desktopの完全終了・再起動を要する。
-WindowsはAitermのnative launcherからNode中継と公式Desktop CLIを起動し、通常の親子関係を保つ。
-Windows標準の.NET Frameworkでlauncherを作り、引数とstdioをそのまま中継する。
+引数の解釈、JSONL中継、設定の有効化・競合・復元は両OSで共通の処理を使う。
+Windows標準の.NET Frameworkでlauncherを作り、`CreateProcessW`の親process属性と継承handle一覧で、
+公式CLIをDesktopの直接の子、中継Nodeを公式CLIの直接の子として起動する。
+launcherは終了監視だけを担い、JSON-RPCを通さない。Windowsには同一PIDでのexecがないためPIDは変わるが、
+公式binary、起動元との直接の親子関係、通常の環境とstdioは維持する。
 公式Desktopが展開した4実行ファイルを配布元のSHA-256と照合し、AitermがCodexをコピー・再配布しない。
 公式CLIの認証付きloopback WebSocketを使い、本人専用ACLのtokenと接続記録をAitermのsessions下へ置く。
 Windowsのprocess情報はprocess-runtimeが所有し、接続はPID・開始時刻・実行ファイル・token引数で照合する。
 MCP processの祖先から親を選び、同じloaded taskへ送る。開始時刻は小数桁の表記差を正規化して比較する。
-stdio EOFで自分が起動した公式serverを停止し、接続記録を削除する。
-既存の互換launcherは公式serverからlauncherとDesktopへの祖先関係、ACL、RPCが成立した場合だけ共有する。
-対応する接続記録はaiterm.windows-relay.v1とgpt-connector.windows-relay.v1で、後者もAiterm内で解釈する。
-共有時はlauncherとprevious_cli_pathを同値で記録し、enableとdisableで所有外の起動設定を変更しない。
-接続共有は任意であり、他製品のコード・設定・コマンドはAiterm単独導入の前提にならない。
+stdio EOFで自分が起動した公式serverを停止し、接続記録を削除する。native launcherはJob Objectで
+所有するprocessだけを終了し、公式serverの終了確認後に戻る。
+両OSとも有効化前に元の起動設定を保存し、Aitermのlauncherを設定する。解除は元の値へ戻す。
+旧Windows版で既存launcherを共有した設定は読取り可能だが、次のenableでAitermのlauncherへ移行する。
+起動・配送・設定・診断は他製品のコード、設定、コマンドへ依存しない。
 LinuxのSteer選択はunsupportedとする。通常の単品導入・queue配送は全対応OSで維持する。
 
 単品導入のqueue配送は親の実行中turnを中断せず、親がidleになった後に処理される。

package/docs/RELEASE.md

@@ -41,7 +41,7 @@ Codex Steerを変更した場合は、公式バイナリを指定した`test/cod
 再起動後の`aiterm-setup --codex-steer status`が`ready`であることと、通常の親からの子の回答配送を確認する。
 接続があるだけで成功とせず、公式binaryとDesktopの親子関係まで確認する。
 Windowsは`AITERM_TEST_CODEX_BINARY`に公式Desktopの実行fileを指定し、
-`test/windows-codex.test.mjs`で単独launcher、ACL、親識別、既存接続共有、設定解除も確認する。
+`test/windows-codex.test.mjs`で単独launcher、ACL、親識別、元の起動設定の保存と解除も確認する。
 同じ環境変数で`test/codex-relay-official.test.mjs`の実行中Steer・終了後再開・承認中継・EOFを確認できる。
 Linuxの未対応Steer選択が理由付きで停止することもCIで確認する。
 

package/package.json

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