aiterm-mcp 0.36.0 → 0.37.1

package/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.37.1] - 2026-09-13
+
+### 修正
+
+- WindowsのCodexでhook確認画面の見出しが画面上部へ出た場合も認識し、`trust_project: true`による起動準備を完了する。
+- npmのshell shimとnative Codexの間にNode processがある場合、同じ起動を複数候補と誤判定して停止する問題を修正した。
+
+## [0.37.0] - 2026-09-13
+
+### 追加
+
+- WindowsのCodex Desktop親へのSteerと終了後再開に対応。公式CLI、認証付きloopback接続、native launcher、設定・解除をAitermだけで提供する。
+- 稼働中の互換launcherは親process・ACL・公式RPCを確認した時だけ共有し、既存の起動設定を保持する。
+
 ## [0.36.0] - 2026-09-13
 
 ### 追加
@@ -1657,7 +1671,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.36.0...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.1...HEAD
+[0.37.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.0...v0.37.1
+[0.37.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.36.0...v0.37.0
 [0.36.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.35.1...v0.36.0
 [0.35.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.35.0...v0.35.1
 [0.35.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.34.0...v0.35.0

package/LICENSE

@@ -1,6 +1,7 @@
 MIT License
 
 Copyright (c) 2026 kitepon
+Copyright (c) 2026 kitepon-rgb (Windows Codex中継の移植部分)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.ja.md

@@ -47,7 +47,7 @@ Ubuntu／Debianはsudoとaptでtmuxを準備する。必要な公式package mana
 AI別の`integrations`と選択機能の`codex_steer`を持つ。失敗時は`reason_code`を付け、終了コードはreadyなら0、再起動待ちは3、それ以外は2となる。
 
 
-### Codex DesktopへSteerを有効にする（macOS）
+### Codex DesktopへSteerを有効にする（macOS・Windows）
 
 対話実行の`aiterm-setup`で「Aiterm単品」と「Steer付き」を選べます。無人導入では明示します。
 
@@ -57,14 +57,18 @@ aiterm-setup --json --codex-steer enable
 
 公式Codex Desktopに同梱されたApp Serverを使い、実行中の親には同じターンへ回答を送り、
 終了後に届いた回答でも同じタスクを自動再開します。App Serverの改造・再ビルド・別配布は不要です。
-Steerの初回設定後は`restart_required`（終了コード3）を返します。Codexを完全終了して再起動し、
+新しいlauncherを設定した場合は`restart_required`（終了コード3）を返します。Codexを完全終了して再起動し、
 `aiterm-setup --codex-steer status`で`ready`を確認してください。接続できない時にキューへ自動退避しません。
 
-選択と復元情報は`~/.config/aiterm-mcp/codex-relay/`へ保存し、ユーザーLaunchAgentがログイン時にも
-起動設定を適用します。更新時の`aiterm-setup --json`は選択を維持して中継を更新します。
+選択と復元情報は`~/.config/aiterm-mcp/codex-relay/`へ保存します。macOSはユーザーLaunchAgent、
+Windowsはユーザー環境変数`CODEX_CLI_PATH`で起動設定を維持します。更新時の`aiterm-setup --json`は選択を維持して中継を更新します。
 解除・旧版への巻き戻し前は`aiterm-setup --codex-steer disable`を実行してCodexを再起動してください。
-SteerはmacOSのCodex Desktopと同梱CLI 0.154以上に対応します。Steer有効時の宛先は中継で起動したDesktopに限ります。
-Windows・LinuxのSteer付き導入は理由付き`unsupported`を返します。Aiterm単品は従来どおり利用できます。
+SteerはmacOS・Windowsの公式Codex Desktopと同梱CLI 0.154以上に対応します。Steer有効時の宛先は中継で起動したDesktopに限ります。
+Windowsでは公式Desktopが展開した実行ファイルを照合し、認証付きのローカル接続へ中継します。
+Aitermのpackageがlauncher・中継・設定・親への配送を含み、gpt-connectorやdotagentsの導入は不要です。
+既存の互換launcherがある場合は、稼働中のDesktop接続を確認した時だけ共有し、その起動設定を変更しません。
+互換性を確認できない設定は理由付きで停止します。WindowsのDesktop更新後はsetupを再実行してください。
+LinuxのSteer付き導入は理由付き`unsupported`を返します。Aiterm単品は従来どおり利用できます。
 
 cloneもビルドも不要。どのクライアントでも公開パッケージを次のコマンドで起動する:
 
@@ -191,7 +195,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.36.0** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.37.1** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -471,6 +475,7 @@ aiterm は同じ核心の洞察——端末を出会いの場にする——を
 
 `agent_launch({ harness, cwd, trust_project: true })`はpromptなしでも既知のworkspace・project hooks・MCP初期同意を
 進め、入力受付とharness生存を確認して`startup.status="ready"`を返す。指定なしのpromptなし起動は`not_checked`。
+WindowsのCodexもhook確認を認識し、npm shim経由の起動を一つのharnessとして識別する。
 初手の`initial_prompt.status`は`not_requested`／`not_sent`／`submitted_unconfirmed`／`started`を区別する。
 未送信・未確認の失敗もsession付きstructuredContentを保持する。未確認のpromptを再送せず、返ったcursorで観測する。
 

package/README.md

@@ -47,7 +47,7 @@ Ubuntu／Debianはsudoとaptでtmuxを準備する。必要な公式package mana
 AI別の`integrations`と選択機能の`codex_steer`を持つ。失敗時は`reason_code`を付け、終了コードはreadyなら0、再起動待ちは3、それ以外は2となる。
 
 
-### Codex DesktopへSteerを有効にする（macOS）
+### Codex DesktopへSteerを有効にする（macOS・Windows）
 
 対話実行の`aiterm-setup`で「Aiterm単品」と「Steer付き」を選べます。無人導入では明示します。
 
@@ -57,14 +57,18 @@ aiterm-setup --json --codex-steer enable
 
 公式Codex Desktopに同梱されたApp Serverを使い、実行中の親には同じターンへ回答を送り、
 終了後に届いた回答でも同じタスクを自動再開します。App Serverの改造・再ビルド・別配布は不要です。
-Steerの初回設定後は`restart_required`（終了コード3）を返します。Codexを完全終了して再起動し、
+新しいlauncherを設定した場合は`restart_required`（終了コード3）を返します。Codexを完全終了して再起動し、
 `aiterm-setup --codex-steer status`で`ready`を確認してください。接続できない時にキューへ自動退避しません。
 
-選択と復元情報は`~/.config/aiterm-mcp/codex-relay/`へ保存し、ユーザーLaunchAgentがログイン時にも
-起動設定を適用します。更新時の`aiterm-setup --json`は選択を維持して中継を更新します。
+選択と復元情報は`~/.config/aiterm-mcp/codex-relay/`へ保存します。macOSはユーザーLaunchAgent、
+Windowsはユーザー環境変数`CODEX_CLI_PATH`で起動設定を維持します。更新時の`aiterm-setup --json`は選択を維持して中継を更新します。
 解除・旧版への巻き戻し前は`aiterm-setup --codex-steer disable`を実行してCodexを再起動してください。
-SteerはmacOSのCodex Desktopと同梱CLI 0.154以上に対応します。Steer有効時の宛先は中継で起動したDesktopに限ります。
-Windows・LinuxのSteer付き導入は理由付き`unsupported`を返します。Aiterm単品は従来どおり利用できます。
+SteerはmacOS・Windowsの公式Codex Desktopと同梱CLI 0.154以上に対応します。Steer有効時の宛先は中継で起動したDesktopに限ります。
+Windowsでは公式Desktopが展開した実行ファイルを照合し、認証付きのローカル接続へ中継します。
+Aitermのpackageがlauncher・中継・設定・親への配送を含み、gpt-connectorやdotagentsの導入は不要です。
+既存の互換launcherがある場合は、稼働中のDesktop接続を確認した時だけ共有し、その起動設定を変更しません。
+互換性を確認できない設定は理由付きで停止します。WindowsのDesktop更新後はsetupを再実行してください。
+LinuxのSteer付き導入は理由付き`unsupported`を返します。Aiterm単品は従来どおり利用できます。
 
 No clone or build is required. Each client launches the published package with:
 
@@ -205,7 +209,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.36.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.37.1** · 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
 
@@ -504,6 +508,7 @@ displayed token count or null. Callers do not need raw argv or pane-text parsing
 consent even without a prompt, then verifies input readiness and harness liveness before returning `startup.status="ready"`.
 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として識別する。
 Do not resend an unconfirmed prompt; observe or wait using its returned cursor.
 
 For a live Codex approval, inspect with `agent_approval({ action: "inspect", session_id })`, review `prompt` and `choices`,

package/dist/codex-relay-client.js

@@ -2,18 +2,25 @@ import { createConnection } from "node:net";
 import WebSocket from "ws";
 import { CodexDeliveryError } from "./codex-delivery-error.js";
 import { verifyRelaySocket } from "./codex-relay-config.js";
+import { windowsSocketConnection } from "./windows-codex-connection.js";
 /** 公式受付へ追加接続する。Desktopへの承認要求や通知には応答しない。 */
 export async function withCodexRelay(socketPath, action, timeout = 15_000) {
+    let connection;
     try {
-        verifyRelaySocket(socketPath);
+        if (process.platform === "win32")
+            connection = windowsSocketConnection(socketPath);
+        else {
+            verifyRelaySocket(socketPath);
+            connection = { url: "ws://localhost/rpc", options: { createConnection: () => createConnection(socketPath) } };
+        }
     }
     catch (error) {
         if (error instanceof CodexDeliveryError)
             throw error;
         throw new CodexDeliveryError("CODEX_RELAY_UNAVAILABLE", "公式App Serverのsocketがありません。Codexを再起動してください");
     }
-    const socket = new WebSocket("ws://localhost/rpc", {
-        createConnection: () => createConnection(socketPath), handshakeTimeout: timeout, perMessageDeflate: false,
+    const socket = new WebSocket(connection.url, {
+        ...connection.options, handshakeTimeout: timeout, perMessageDeflate: false,
     });
     let sequence = 0;
     let failure = null;

package/dist/codex-relay-config.js

@@ -5,6 +5,7 @@ import { homedir } from "node:os";
 import { z } from "zod";
 import { readRuntimeProcesses } from "./process-runtime.js";
 import { CodexDeliveryError } from "./codex-delivery-error.js";
+import { findWindowsParentSocket } from "./windows-codex-connection.js";
 export const relayConfigSchema = z.object({
     schema: z.literal("aiterm.codex-relay.v1"),
     enabled: z.boolean(),
@@ -49,7 +50,10 @@ export function verifyRelaySocket(socket) {
         throw new CodexDeliveryError("CODEX_RELAY_PATH_INVALID", "本人所有の公式socketを確認できません");
     }
 }
-export function parentRelaySocket(config, processes = readRuntimeProcesses(), pid = process.pid) {
+export function parentRelaySocket(config, processes, pid = process.pid) {
+    if (process.platform === "win32")
+        return findWindowsParentSocket(undefined, pid, config.launcher === config.previous_cli_path ? undefined : config.socket_root);
+    processes ??= readRuntimeProcesses();
     const rows = new Map(processes.map(row => [row.pid, row]));
     const seen = new Set();
     let current = rows.get(pid)?.parent_pid;

package/dist/core.js

@@ -1051,7 +1051,7 @@ function decodeActivityCursor(cursor, name) {
         throw new AitermError("活動観測cursorが対象sessionの形式と一致しません", 2);
     return value;
 }
-function selectHarnessProcesses(meta, rows, subtree) {
+export function selectHarnessProcesses(meta, rows, subtree) {
     const matches = (row) => {
         const first = /^(?:"([^"]+)"|(\S+))/.exec(row.command);
         const executable = path.posix.basename((first?.[1] ?? first?.[2] ?? "").replace(/\\/g, "/"))
@@ -1065,7 +1065,20 @@ function selectHarnessProcesses(meta, rows, subtree) {
     // WindowsのMSYS execでnative親子関係が切れる場合も、launch固有引数で相関する。
     const correlated = rows.filter(row => matches(row) && row.command.includes(meta.launch_id));
     const candidates = correlated.length ? correlated : subtree.filter(matches);
-    const roots = candidates.filter(row => !candidates.some(parent => row.parent_pid === parent.pid));
+    const byPid = new Map(rows.map(row => [row.pid, row]));
+    const candidatePids = new Set(candidates.map(row => row.pid));
+    // npm shimとnative本体の間にNodeなどの非候補processがいても、同じ起動の祖先を辿る。
+    const roots = candidates.filter(row => {
+        const seen = new Set();
+        let parent = byPid.get(row.parent_pid);
+        while (parent && !seen.has(parent.pid)) {
+            if (candidatePids.has(parent.pid))
+                return false;
+            seen.add(parent.pid);
+            parent = byPid.get(parent.parent_pid);
+        }
+        return true;
+    });
     return roots;
 }
 export function observeSession(name, cursor) {

package/dist/harnesses/codex.js

@@ -386,7 +386,7 @@ export function codexTuiReady(screen) {
     return codexFrontend && /(^|\n)[ \t]*[›>](?![ \t]*\d+\.)/.test(screen);
 }
 function currentCodexDialog(screen) {
-    const footers = [...screen.matchAll(/Press enter to confirm or esc to cancel|enter to submit\s*\|\s*esc to cancel/gi)];
+    const footers = [...screen.matchAll(/Press enter to confirm or esc to (?:cancel|go back)|enter to submit\s*\|\s*esc to cancel/gi)];
     // 過去の完了footerより前の質問・選択番号を、現在のdialogへ持ち込まない。
     const previousFooter = footers.at(-2);
     const current = previousFooter ? screen.slice(previousFooter.index + previousFooter[0].length) : screen;
@@ -400,7 +400,7 @@ export function codexPaneObservation(screen) {
     const tail = screen.split("\n").slice(-24).join("\n");
     // 現在のmodal footerがある時だけ、折返しで上へ出た質問を画面全体から探す。
     const lastComposer = [...tail.matchAll(/(?:^|\n)[ \t]*[›>](?![ \t]*\d+\.)/g)].at(-1)?.index ?? -1;
-    const lastDialog = [...tail.matchAll(/Press enter to confirm or esc to cancel|enter to submit\s*\|\s*esc to cancel|Would you like to run the following command\?|Allow the [^\n]+ MCP server to run tool|Hooks need review|Do you trust the contents of this directory|Update available!/gi)].at(-1)?.index ?? -1;
+    const lastDialog = [...tail.matchAll(/Press enter to confirm or esc to (?:cancel|go back)|enter to submit\s*\|\s*esc to cancel|Would you like to run the following command\?|Allow the [^\n]+ MCP server to run tool|Hooks need review|Do you trust the contents of this directory|Update available!/gi)].at(-1)?.index ?? -1;
     const modal = lastDialog > lastComposer;
     if (!modal) {
         if (/esc to interrupt/i.test(tail))

package/dist/process-runtime.js

@@ -44,7 +44,7 @@ export function readRuntimeProcesses() {
         "$ErrorActionPreference='Stop'",
         "[Console]::OutputEncoding=[Text.UTF8Encoding]::new($false)",
         "@(Get-CimInstance Win32_Process | Where-Object { $null -ne $_.CreationDate -and $null -ne $_.CommandLine } | ForEach-Object {",
-        "[ordered]@{ pid=[int]$_.ProcessId; parent_pid=[int]$_.ParentProcessId; started_identity=$_.CreationDate.ToUniversalTime().ToString('o'); command=$_.CommandLine; cpu_seconds=([double]$_.KernelModeTime+[double]$_.UserModeTime)/10000000 }",
+        "[ordered]@{ pid=[int]$_.ProcessId; parent_pid=[int]$_.ParentProcessId; executable=[string]$_.ExecutablePath; started_identity=$_.CreationDate.ToUniversalTime().ToString('o'); command=$_.CommandLine; cpu_seconds=([double]$_.KernelModeTime+[double]$_.UserModeTime)/10000000 }",
         "}) | ConvertTo-Json -Compress",
     ].join("\n");
     const result = spawnSync(resolveWindowsPowerShell7(), ["-NoLogo", "-NoProfile", "-NonInteractive", "-EncodedCommand", Buffer.from(script, "utf16le").toString("base64")], {
@@ -69,6 +69,7 @@ export function readRuntimeProcesses() {
         const command = row.command.trim();
         return {
             pid: row.pid, parent_pid: row.parent_pid, process_group_id: null, stopped: null,
+            executable: row.executable,
             started_identity: new Date(row.started_identity).toISOString(),
             command, cpu_seconds: row.cpu_seconds, argv_digest: createHash("sha256").update(command).digest("hex"),
         };

package/dist/setup-cli.js

@@ -18,7 +18,7 @@ if (args.length === 1 && args[0] === "--remove-claude-parent-hooks") {
     }
 }
 else if (args.length === 1 && ["--help", "-h"].includes(args[0])) {
-    process.stdout.write("使い方: aiterm-setup [--json] [--codex-steer enable|disable|status]\n依存準備、AIへの登録、MCPと端末の実動作確認を行います。対話実行ではAiterm単品かCodex Desktop Steer付きかを選べます。SteerはmacOS対応で、初回はCodexの再起動が必要です。disableは元の起動設定へ戻し、statusは実際の接続を確認します。--jsonは対話せず、Steerの選択を維持します。\n旧版へ戻す前のClaude専用hook解除: --remove-claude-parent-hooks\n");
+    process.stdout.write("使い方: aiterm-setup [--json] [--codex-steer enable|disable|status]\n依存準備、AIへの登録、MCPと端末の実動作確認を行います。対話実行ではAiterm単品かCodex Desktop Steer付きかを選べます。SteerはmacOS・Windows対応で、初回はCodexの再起動が必要です。disableは元の起動設定へ戻し、statusは実際の接続を確認します。--jsonは対話せず、Steerの選択を維持します。\n旧版へ戻す前のClaude専用hook解除: --remove-claude-parent-hooks\n");
 }
 else {
     try {
@@ -33,7 +33,7 @@ else {
                 throw new Error("使い方: aiterm-setup [--json] [--codex-steer enable|disable|status]");
         }
         const onlySteer = action === "disable" || action === "status";
-        if (!action && !json && process.stdin.isTTY && process.stderr.isTTY && process.platform === "darwin") {
+        if (!action && !json && process.stdin.isTTY && process.stderr.isTTY && ["darwin", "win32"].includes(process.platform)) {
             const enabled = readRelayConfig()?.enabled ?? false;
             const prompt = createInterface({ input: process.stdin, output: process.stderr });
             try {

package/dist/setup-codex-relay.js

@@ -12,6 +12,7 @@ import { codexRelayLauncher } from "./codex-relay-launcher.js";
 import { withCodexRelay } from "./codex-relay-client.js";
 import { readRuntimeProcesses } from "./process-runtime.js";
 import { installRelayLogin, removeRelayLogin } from "./codex-relay-login.js";
+import { configureWindowsCodexSteer } from "./windows-codex-setup.js";
 function command(executable, args) {
     const result = spawnSync(executable, args, { encoding: "utf8", timeout: 15_000 });
     if (result.error || result.status !== 0)
@@ -51,7 +52,7 @@ export async function verifyRelayLauncher(launcher) {
     const temporary = fs.mkdtempSync(path.join(tmpdir(), "aiterm-relay-setup-"));
     fs.mkdirSync(path.join(temporary, ".codex"));
     const child = spawn(launcher, ["-c", 'cli_auth_credentials_store="file"', "-c", 'mcp_oauth_credentials_store="file"', "app-server"], {
-        env: { ...process.env, HOME: temporary, CODEX_HOME: path.join(temporary, ".codex") }, stdio: ["pipe", "pipe", "ignore"],
+        env: { ...process.env, HOME: temporary, CODEX_HOME: path.join(temporary, ".codex") }, stdio: ["pipe", "pipe", "ignore"], windowsHide: true,
     });
     const reader = createInterface({ input: child.stdout });
     const exited = new Promise(resolve => child.once("close", resolve));
@@ -121,6 +122,8 @@ function writeConfig(directory, config) {
     fs.renameSync(temporary, path.join(directory, "config.json"));
 }
 export async function configureCodexSteer(action = "status", overrides = {}) {
+    if ((overrides.platform ?? process.platform) === "win32")
+        return configureWindowsCodexSteer(action, overrides);
     const runtime = {
         platform: process.platform, directory: relayConfigDirectory(), socket_root: `/tmp/aiterm-codex-${process.getuid?.() ?? 0}`,
         node: process.execPath, relay: fileURLToPath(new URL("./codex-stdio-relay.js", import.meta.url)),

package/dist/windows-codex-connection.js

@@ -0,0 +1,111 @@
+// gpt-connectorのWindows実装をMIT条件で移植。実行時の外部製品依存は持たない。
+import { lstatSync, readFileSync } from "node:fs";
+import { basename, dirname, isAbsolute, join, relative } from "node:path";
+import { z } from "zod";
+import { windowsPowerShellSync, quotePowerShell } from "./windows-codex-state.js";
+import { CodexDeliveryError } from "./codex-delivery-error.js";
+import { readRuntimeProcesses } from "./process-runtime.js";
+export const windowsRelaySchema = z.object({
+    schema: z.enum(["aiterm.windows-relay.v1", "gpt-connector.windows-relay.v1"]),
+    serverPid: z.number().int().positive(), serverStarted: z.string(), binary: z.string(),
+    endpoint: z.string().regex(/^ws:\/\/127\.0\.0\.1:[1-9][0-9]{0,4}$/),
+}).strict();
+const processSchema = z.object({ pid: z.number(), parent_pid: z.number(), command: z.string(), executable: z.string(), started: z.string() });
+export function readWindowsProcesses() {
+    return readRuntimeProcesses().map(row => ({ pid: row.pid, parent_pid: row.parent_pid, command: row.command, executable: row.executable ?? "", started: row.started_identity }));
+}
+function invalid(message) { throw new CodexDeliveryError("CODEX_RELAY_CONNECTION_INVALID", message); }
+export function readWindowsRelay(file, processes = readWindowsProcesses()) {
+    if (!isAbsolute(file) || lstatSync(file).isSymbolicLink() || !lstatSync(file).isFile())
+        invalid("WindowsのSteer接続記録が不正です。");
+    const root = dirname(file);
+    if (lstatSync(root).isSymbolicLink() || !lstatSync(root).isDirectory())
+        invalid("WindowsのSteer保存先が不正です。");
+    // 接続情報は外部入力。読む前に所有者とACLを検証し、権限を修復して成功扱いしない。
+    windowsPowerShellSync(`
+$sid = [System.Security.Principal.WindowsIdentity]::GetCurrent().User.Value
+foreach ($entry in @(${quotePowerShell(root)}, ${quotePowerShell(file)}, ${quotePowerShell(join(root, "token"))})) {
+  $acl = Get-Acl -LiteralPath $entry
+  if ($acl.GetOwner([System.Security.Principal.SecurityIdentifier]).Value -notin @($sid, 'S-1-5-32-544')) { throw 'Steer保存先の所有者が一致しません' }
+  foreach ($rule in $acl.Access) {
+    $identity = $rule.IdentityReference.Translate([System.Security.Principal.SecurityIdentifier]).Value
+    if ($rule.AccessControlType -eq 'Allow' -and $identity -notin @($sid, 'S-1-5-18', 'S-1-5-32-544')) { throw 'Steer保存先が他userへ公開されています' }
+  }
+}`);
+    const record = windowsRelaySchema.parse(JSON.parse(readFileSync(file, "utf8")));
+    const server = processes.find(row => row.pid === record.serverPid);
+    if (!server || Date.parse(server.started) !== Date.parse(record.serverStarted) || server.executable.toLowerCase() !== record.binary.toLowerCase()
+        || !server.command.includes(record.endpoint) || !server.command.includes(join(root, "token")))
+        invalid("Windowsの親Codex processを照合できません。");
+    return record;
+}
+export function findWindowsParentSocket(rows = readWindowsProcesses(), callerPid = process.pid, root) {
+    const parents = new Map(rows.map(row => [row.pid, row]));
+    const seen = new Set();
+    let pid = parents.get(callerPid)?.parent_pid;
+    while (pid && !seen.has(pid)) {
+        const row = parents.get(pid);
+        // 自分が起動した公式CLIの引数から接続先を取得する。MCPへの環境変数継承を前提にしない。
+        const token = row && basename(row.executable).toLowerCase() === "codex.exe"
+            ? /(?:^|\s)--ws-token-file\s+(?:"([^"]+)"|(\S+))/.exec(row.command) : null;
+        const tokenFile = token?.[1] ?? token?.[2];
+        if (tokenFile && isAbsolute(tokenFile) && basename(tokenFile) === "token") {
+            const file = join(dirname(tokenFile), "connection.json");
+            if (root) {
+                const location = relative(root, file);
+                if (isAbsolute(location) || location === ".." || location.startsWith("..\\"))
+                    invalid("親CodexはAitermのSteer起動設定を使っていません。Codexを完全再起動してください。");
+            }
+            const record = readWindowsRelay(file, rows);
+            if (record.serverPid !== pid)
+                invalid("Steer接続記録と親Codexが一致しません。");
+            return file;
+        }
+        seen.add(pid);
+        pid = row?.parent_pid;
+    }
+    invalid("親CodexのSteer接続がありません。aiterm-setup --codex-steer enableを実行し、Codexを再起動してください。");
+}
+export function windowsSocketConnection(file) {
+    const record = readWindowsRelay(file);
+    const tokenFile = join(dirname(file), "token");
+    if (lstatSync(tokenFile).isSymbolicLink() || !lstatSync(tokenFile).isFile())
+        invalid("Steer認証fileが不正です。");
+    const token = readFileSync(tokenFile, "utf8");
+    if (!/^[a-f0-9]{64}$/.test(token))
+        invalid("Steer認証情報が不正です。");
+    return { url: record.endpoint, options: { headers: { Authorization: `Bearer ${token}` } } };
+}
+/** 登録済みlauncherとDesktopの子孫にある、対応する公式接続だけを共有できる。 */
+export function windowsDesktopRelay(launcher, rows = readWindowsProcesses()) {
+    const parents = new Map(rows.map(row => [row.pid, row]));
+    for (const server of rows) {
+        if (basename(server.executable).toLowerCase() !== "codex.exe" || !server.command.includes("--ws-token-file"))
+            continue;
+        let row = parents.get(server.parent_pid);
+        let matchedLauncher = false;
+        let matchedDesktop = false;
+        const seen = new Set();
+        while (row && !seen.has(row.pid)) {
+            seen.add(row.pid);
+            if (row.executable.toLowerCase() === launcher.toLowerCase())
+                matchedLauncher = true;
+            if (/\\WindowsApps\\OpenAI\.Codex_[^\\]+\\app\\(?:ChatGPT|Codex)\.exe$/i.test(row.executable)) {
+                matchedDesktop = true;
+                break;
+            }
+            row = parents.get(row.parent_pid);
+        }
+        if (!matchedLauncher || !matchedDesktop)
+            continue;
+        const token = /(?:^|\s)--ws-token-file\s+(?:"([^"]+)"|(\S+))/.exec(server.command);
+        const tokenFile = token?.[1] ?? token?.[2];
+        if (!tokenFile || !isAbsolute(tokenFile) || basename(tokenFile) !== "token")
+            continue;
+        const file = join(dirname(tokenFile), "connection.json");
+        if (readWindowsRelay(file, rows).serverPid !== server.pid)
+            invalid("Steer接続記録と親Codexが一致しません。");
+        return file;
+    }
+    return null;
+}

package/dist/windows-codex-relay.js

@@ -0,0 +1,154 @@
+// gpt-connectorのWindows実装をMIT条件で移植。実行時の外部製品依存は持たない。
+// Windowsの起動processと認証付きloopback接続を所有する。JSON-RPC本文は変更しない。
+import { spawn } from "node:child_process";
+import { createServer } from "node:net";
+import { createInterface } from "node:readline";
+import { once } from "node:events";
+import { randomBytes, randomUUID } from "node:crypto";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { writeFileSync, rmSync } from "node:fs";
+import { setTimeout as delay } from "node:timers/promises";
+import WebSocket from "ws";
+import { ensurePrivateDirectory, makeFilePrivate } from "./windows-codex-state.js";
+import { readWindowsProcesses } from "./windows-codex-connection.js";
+export function windowsServerArguments(args) {
+    let server = false;
+    const result = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (["-c", "--config", "--enable", "--disable"].includes(arg)) {
+            result.push(arg, args[++i]);
+            continue;
+        }
+        if (/^(?:--config=|--enable=|--disable=|-c.)/.test(arg)) {
+            result.push(arg);
+            continue;
+        }
+        if (!server) {
+            if (arg !== "app-server")
+                return null;
+            server = true;
+            result.push(arg);
+            continue;
+        }
+        if (["proxy", "daemon", "start", "stop", "status", "generate-ts", "generate-json-schema", "--help", "-h", "--version", "-V"].includes(arg))
+            return null;
+        if (arg === "--stdio" || arg === "--listen=stdio://")
+            continue;
+        if (arg === "--listen") {
+            if (args[++i] !== "stdio://")
+                throw new Error("stdio以外の接続指定は変更できません");
+            continue;
+        }
+        if (arg.startsWith("--listen=") || arg.startsWith("--ws-"))
+            throw new Error("既存の接続・認証指定は変更できません");
+        result.push(arg);
+    }
+    return server ? result : null;
+}
+export async function runWindowsCodexRelay(binary, root, args) {
+    const serverArgs = windowsServerArguments(args);
+    if (!serverArgs) {
+        const child = spawn(binary, args, { stdio: "inherit", windowsHide: true });
+        return (await once(child, "close"))[0] ?? 1;
+    }
+    const directory = join(root, randomUUID());
+    ensurePrivateDirectory(directory);
+    const file = join(directory, "connection.json");
+    const tokenFile = join(directory, "token");
+    const token = randomBytes(32).toString("hex");
+    writeFileSync(tokenFile, token, { flag: "wx" });
+    makeFilePrivate(tokenFile);
+    // OSが割り当てた空きportを使い、取得競合は公式serverの起動失敗として明示する。
+    const reservation = createServer();
+    reservation.listen(0, "127.0.0.1");
+    await once(reservation, "listening");
+    const port = reservation.address().port;
+    await new Promise((resolve, reject) => reservation.close(error => error ? reject(error) : resolve()));
+    const endpoint = `ws://127.0.0.1:${port}`;
+    const child = spawn(binary, [...serverArgs, "--listen", endpoint, "--ws-auth", "capability-token", "--ws-token-file", tokenFile], {
+        stdio: ["ignore", "ignore", "pipe"], windowsHide: true,
+    });
+    const exited = new Promise(resolve => child.once("close", () => resolve()));
+    let failed;
+    child.on("error", error => { failed = error; });
+    // WebSocketの定型起動案内だけを除き、公式CLIの診断はDesktopへそのまま返す。
+    const diagnostics = createInterface({ input: child.stderr });
+    diagnostics.on("line", line => {
+        if (!/^(?:\s*|codex app-server \(WebSockets\)| {2}(?:listening on:|readyz:|healthz:|note:).*)$/.test(line))
+            process.stderr.write(line + "\n");
+    });
+    let socket;
+    const input = createInterface({ input: process.stdin, crlfDelay: Infinity });
+    const lines = input[Symbol.asyncIterator]();
+    let ending = false;
+    const stop = () => { ending = true; child.kill(); socket?.terminate(); input.close(); process.stdin.destroy(); };
+    input.once("close", stop);
+    process.stdout.once("error", stop);
+    try {
+        const deadline = Date.now() + 15_000;
+        while (!socket) {
+            if (failed || child.exitCode !== null || child.signalCode !== null)
+                throw new Error("公式Codexの起動に失敗しました", { cause: failed });
+            const candidate = new WebSocket(endpoint, { headers: { Authorization: `Bearer ${token}` }, handshakeTimeout: 1_000 });
+            try {
+                await once(candidate, "open");
+                socket = candidate;
+            }
+            catch (error) {
+                candidate.on("error", () => { });
+                candidate.terminate();
+                if (error.code !== "ECONNREFUSED" || Date.now() >= deadline)
+                    throw error;
+                await delay(50);
+            }
+        }
+        const server = readWindowsProcesses().find(row => row.pid === child.pid);
+        if (!server)
+            throw new Error("公式Codexのprocess情報がありません");
+        const record = { schema: "aiterm.windows-relay.v1", serverPid: server.pid, serverStarted: server.started, binary, endpoint };
+        writeFileSync(file, JSON.stringify(record), { flag: "wx" });
+        makeFilePrivate(file);
+        const connected = socket;
+        connected.on("message", (data, binary) => {
+            if (binary) {
+                failed = new Error("公式Codexから予期しないバイナリ応答を受信しました");
+                stop();
+                return;
+            }
+            if (!process.stdout.write(data.toString() + "\n"))
+                connected.pause();
+        });
+        process.stdout.on("drain", () => connected.resume());
+        connected.on("error", () => { failed = new Error("公式Codexとの接続に失敗しました"); stop(); });
+        connected.on("close", () => { if (!ending) {
+            failed = new Error("公式Codexとの接続が終了しました");
+            stop();
+        } });
+        // initializeが接続準備前に届いても失わないよう、iteratorを接続前から保持する。
+        for await (const line of lines)
+            await new Promise((resolve, reject) => connected.send(line, error => error ? reject(error) : resolve()));
+        if (failed)
+            throw failed;
+        return 0;
+    }
+    finally {
+        stop();
+        await exited;
+        diagnostics.close();
+        rmSync(directory, { recursive: true, force: true });
+    }
+}
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+    const [binary, root, ...args] = process.argv.slice(2);
+    try {
+        if (!binary || !root)
+            throw new Error("Windows中継の起動指定がありません");
+        process.exitCode = await runWindowsCodexRelay(binary, root, args);
+    }
+    catch (error) {
+        process.stderr.write(`aiterm-mcp: ${error instanceof Error ? error.message : "Windows中継が失敗しました"}\n`);
+        process.exitCode = 1;
+    }
+}

package/dist/windows-codex-setup.js

@@ -0,0 +1,201 @@
+// 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 { 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 { 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";
+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"];
+    const digest = (file) => createHash("sha256").update(readFileSync(file)).digest("hex");
+    const expected = names.map(name => digest(join(resources, name)));
+    const found = (existsSync(cache) ? readdirSync(cache, { withFileTypes: true }) : [])
+        .filter(entry => entry.isDirectory() && !entry.isSymbolicLink() && /^[0-9a-f]{16}$/.test(entry.name))
+        .filter(entry => names.every((name, index) => {
+        const file = join(cache, entry.name, name);
+        return existsSync(file) && digest(file) === expected[index];
+    }));
+    if (found.length !== 1)
+        throw new SetupError("codex_desktop_runtime_unavailable", "現在のCodex Desktopが展開した実行fileを特定できません。公式Desktopを起動してからsetupを再実行してください。");
+    return join(cache, found[0].name, "codex.exe");
+}
+export function findWindowsCodexBinary() {
+    const resources = windowsPowerShellSync(`
+$packages = @(Get-AppxPackage -Name OpenAI.Codex)
+if ($packages.Count -ne 1) { throw '公式Codex Desktopを一つに特定できません' }
+Join-Path $packages[0].InstallLocation 'app/resources'`);
+    const value = findWindowsCodexCache(resources, join(process.env.LOCALAPPDATA ?? join(homedir(), "AppData", "Local"), "OpenAI", "Codex", "bin"));
+    const result = spawnSync(value, ["--version"], { encoding: "utf8", windowsHide: true, timeout: 10_000 });
+    if (result.error || result.status !== 0)
+        throw new SetupError("codex_binary_unavailable", "公式Codex Desktopの実行fileを起動できません。");
+    const match = /codex-cli (\d+)\.(\d+)\.(\d+)/.exec(result.stdout ?? "");
+    if (result.status !== 0 || !match || (Number(match[1]) === 0 && Number(match[2]) < 154))
+        throw new SetupError("codex_version_unsupported", "公式Codex Desktopの対応CLIを確認できません。");
+    return value;
+}
+function getGui(key) {
+    return windowsPowerShellSync(`[Environment]::GetEnvironmentVariable(${quotePowerShell(key)}, 'User')`) || null;
+}
+function setGui(key, value) {
+    windowsPowerShellSync(`
+[Environment]::SetEnvironmentVariable(${quotePowerShell(key)}, ${value === null ? "$null" : quotePowerShell(value)}, 'User')
+Add-Type -TypeDefinition @'
+using System;
+using System.Runtime.InteropServices;
+public static class AitermEnvironment {
+  [DllImport("user32.dll", CharSet=CharSet.Unicode)]
+  public static extern IntPtr SendMessageTimeout(IntPtr window, uint message, UIntPtr wparam, string value, uint flags, uint timeout, out UIntPtr result);
+}
+'@
+$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 function buildWindowsLauncher(directory, source) {
+    const digest = createHash("sha256").update(source).digest("hex").slice(0, 16);
+    const launcher = join(directory, `codex-${digest}.exe`);
+    const sourceFile = join(directory, `codex-${digest}.cs`);
+    if (existsSync(launcher) && existsSync(sourceFile) && readFileSync(sourceFile, "utf8") === source)
+        return launcher;
+    const compiler = join(process.env.SystemRoot ?? "C:\\Windows", "Microsoft.NET", "Framework64", "v4.0.30319", "csc.exe");
+    if (!existsSync(compiler))
+        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 });
+    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);
+    if (!file)
+        return false;
+    await withCodexRelay(file, request => request("thread/loaded/list", { limit: 1 }));
+    return true;
+}
+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" };
+}
+function save(directory, config) {
+    const file = join(directory, `${randomUUID()}.tmp`);
+    try {
+        writeFileSync(file, JSON.stringify(config, null, 2) + "\n", { flag: "wx" });
+        makeFilePrivate(file);
+        renameSync(file, join(directory, "config.json"));
+    }
+    finally {
+        rmSync(file, { force: true });
+    }
+}

package/dist/windows-codex-state.js

@@ -0,0 +1,44 @@
+// WindowsのSteer保存先とPowerShell境界。接続記録の読取ではACLを変更しない。
+import { execFileSync } from "node:child_process";
+import { mkdirSync, lstatSync } from "node:fs";
+import { isAbsolute } from "node:path";
+import { resolveWindowsPowerShell7 } from "./windows-powershell.js";
+import { CodexDeliveryError } from "./codex-delivery-error.js";
+export const quotePowerShell = (value) => `'${value.replace(/'/g, "''")}'`;
+export function windowsPowerShellSync(script, timeout = 15_000) {
+    const source = "$ErrorActionPreference = 'Stop'\n[Console]::OutputEncoding = [Text.UTF8Encoding]::new($false)\n" + script;
+    try {
+        return execFileSync(resolveWindowsPowerShell7(), ["-NoLogo", "-NoProfile", "-NonInteractive", "-EncodedCommand",
+            Buffer.from(source, "utf16le").toString("base64")], {
+            encoding: "utf8", windowsHide: true, timeout, maxBuffer: 16 * 1024 * 1024, stdio: ["ignore", "pipe", "pipe"],
+        }).trim();
+    }
+    catch {
+        throw new CodexDeliveryError("CODEX_WINDOWS_OPERATION_FAILED", "WindowsのSteer設定・接続情報を確認できません");
+    }
+}
+function makePrivate(target, directory) {
+    const stat = lstatSync(target);
+    if (!isAbsolute(target) || stat.isSymbolicLink() || (directory ? !stat.isDirectory() : !stat.isFile())) {
+        throw new CodexDeliveryError("CODEX_RELAY_PATH_INVALID", "Steer保存先が不正です");
+    }
+    windowsPowerShellSync(`
+$target = ${quotePowerShell(target)}
+$sid = [System.Security.Principal.WindowsIdentity]::GetCurrent().User
+$previous = Get-Acl -LiteralPath $target
+if ($previous.GetOwner([System.Security.Principal.SecurityIdentifier]).Value -notin @($sid.Value, 'S-1-5-32-544')) { throw '所有者が一致しません' }
+$acl = [System.Security.AccessControl.${directory ? "DirectorySecurity" : "FileSecurity"}]::new()
+$acl.SetOwner($sid)
+$acl.SetAccessRuleProtection($true, $false)
+$rule = [System.Security.AccessControl.FileSystemAccessRule]::new($sid, 'FullControl', '${directory ? "ContainerInherit, ObjectInherit" : "None"}', 'None', 'Allow')
+$acl.AddAccessRule($rule)
+Set-Acl -LiteralPath $target -AclObject $acl
+$actual = Get-Acl -LiteralPath $target
+if ($actual.GetOwner([System.Security.Principal.SecurityIdentifier]).Value -ne $sid.Value -or !$actual.AreAccessRulesProtected) { throw 'ACLの適用を確認できません' }
+`);
+}
+export function ensurePrivateDirectory(directory) {
+    mkdirSync(directory, { recursive: true });
+    makePrivate(directory, true);
+}
+export function makeFilePrivate(file) { makePrivate(file, false); }

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増分だけを返し、
@@ -82,7 +84,18 @@ macOSのユーザーLaunchAgentはログイン時に同じ起動設定を適用
 保存した元の`CODEX_CLI_PATH`へ戻す。他から変更された設定は上書きしない。
 `status=ready`は公式binary・Desktopの直接子・同じsocketのRPC応答を確認した場合だけ返す。
 初回の設定保存後は`restart_required`であり、Desktopの完全終了・再起動を要する。
-Linux/WindowsのSteer選択は`unsupported`とする。通常の単品導入・queue配送は両OSで維持する。
+WindowsはAitermのnative launcherからNode中継と公式Desktop CLIを起動し、通常の親子関係を保つ。
+Windows標準の.NET Frameworkでlauncherを作り、引数と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単独導入の前提にならない。
+LinuxのSteer選択はunsupportedとする。通常の単品導入・queue配送は全対応OSで維持する。
 
 単品導入のqueue配送は親の実行中turnを中断せず、親がidleになった後に処理される。
 `parent_delivery`が配送IDと状態を返し、自動配送時の`wait_process`／`wait_command`はnullになる。

package/docs/RELEASE.md

@@ -39,8 +39,11 @@ Codex Steerを変更した場合は、公式バイナリを指定した`test/cod
 実行中Steer・終了後再開・承認応答・stdio終了を先に確認する。公開packageの
 `aiterm-setup --json --codex-steer enable`で選択導入し、`restart_required`なら人がDesktopを完全再起動する。
 再起動後の`aiterm-setup --codex-steer status`が`ready`であることと、通常の親からの子の回答配送を確認する。
-socketがあるだけで成功とせず、公式binaryとDesktopの直接の子であることまで確認する。
-Linux/Windowsの単品導入と、未対応のSteer選択が理由付きで停止することもCIで確認する。
+接続があるだけで成功とせず、公式binaryとDesktopの親子関係まで確認する。
+Windowsは`AITERM_TEST_CODEX_BINARY`に公式Desktopの実行fileを指定し、
+`test/windows-codex.test.mjs`で単独launcher、ACL、親識別、既存接続共有、設定解除も確認する。
+同じ環境変数で`test/codex-relay-official.test.mjs`の実行中Steer・終了後再開・承認中継・EOFを確認できる。
+Linuxの未対応Steer選択が理由付きで停止することもCIで確認する。
 
 setupを変更した場合は、公開packageのglobal install後に`aiterm-setup --json`を実行し、
 端末実行と検出した各AIの登録結果を確認する。初回と再実行は一時設定領域でも試験し、所有外の設定保持を確かめる。
@@ -70,7 +73,8 @@ aiterm-setup --json
 巻き戻しは既知の正常版を指定する。
 
 Steerを持たない旧版へ戻す時は、install前に`aiterm-setup --codex-steer disable`を実行する。
-専用LaunchAgentの解除と元のGUI起動設定の復元を確認し、MCP clientを再起動する。
+macOSは専用LaunchAgentの解除、Windowsは元のユーザー環境変数の復元を確認し、MCP clientを再起動する。
+互換launcherを共有していた場合はAitermのSteer選択だけを解除し、所有外の起動設定を保持する。
 回答record schemaは従来と共通であり、Steer送信済みrecordの`queued_submission_id`はnullとなる。
 
 Claude親配送hookのない旧版へ戻す場合は、旧版のinstall前に`aiterm-setup --remove-claude-parent-hooks`を

package/package.json

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