aiterm-mcp 0.35.1 → 0.37.0

package/CHANGELOG.md

@@ -7,6 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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
+
+### 追加
+
+- macOSのCodex Desktop向けにSteerの選択導入を追加。`aiterm-setup`の対話選択または`--codex-steer enable`で、同じ公式App Serverへ回答を送り、実行中は同じターンへ反映、終了後は同じタスクを再開する。
+- 中継・POSIX起動処理をnpm packageへ同梱。公式App Serverの再ビルド、別配布、Pythonの追加導入は不要。公式バイナリのPID・Desktopとの親子関係・署名・通常環境を維持する。
+- `--codex-steer status|disable`で実効状態の確認と元の設定への復元を行う。ログイン時の設定は専用LaunchAgentで維持する。初回は`restart_required`と終了コード3を返し、Codexの完全再起動を必要とする。
+- Steerを選択した環境で接続できない時は明示エラーとし、queueへ自動退避しない。送信結果不明の回答は従来どおり保存し、自動再送しない。配送record schemaは維持し、Steer受付済みの`queued_submission_id`はnullとなる。
+- Steerを持たない旧版への巻き戻し前は`aiterm-setup --codex-steer disable`を実行する。Windows・LinuxのSteer選択は未対応を明示し、単品導入と通常のqueue配送は維持する。
+
+### 修正
+
+- 公開コマンドが配布物の検査前にbuildを行い、clean cloneからの公開で未生成の`dist/`を参照して失敗する問題を修正した。
+- 同一エラーの再発時に`product_version`を更新し、snapshotに最終実発生時の版を公開する。
+- runtime storeをv2へ移行する。旧v1の単発記録は版を保持し、複数回の旧集約は最終発生版を復元できないため`unknown`にする。読取りで状態JSONを書き戻さず、次のロック内更新でv2を保存する。
+- v2を保存したstoreは旧writerで開かない。consumerを先に更新し、旧プロセスを終了してから新writerへ切り替える。旧版へ戻す場合は製品のバックアップを使い、v2をv1に偽装しない。
+
 ## [0.35.1] - 2026-09-10
 
 ### Fixed
@@ -1640,7 +1664,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.35.1...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.0...HEAD
+[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
 [0.34.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.33.1...v0.34.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

@@ -40,11 +40,35 @@ WindowsはwingetでPowerShell 7・Git for Windows・psmux、macOSはHomebrewでt
 Ubuntu／Debianはsudoとaptでtmuxを準備する。必要な公式package managerと実行権限は事前に必要。
 他のLinuxでも既存tmuxを利用できるが、自動導入は`unsupported`で停止する。
 既存設定の他サーバーを保持し、JSON設定は変更前の`.aiterm-backup`を残す。
-結果の`status`は`ready`／`unsupported`／`failed`。未検出のAIは`not_detected`とし、全AI未検出は成功にしない。
+結果の`status`は`ready`／`unsupported`／`failed`／`restart_required`。未検出のAIは`not_detected`とし、全AI未検出は成功にしない。
 登録先はglobal packageのNodeとMCP入口の絶対パスで、npm一時cacheやsource checkoutは登録しない。
 更新後も同じ入口を実行し、MCP clientを再起動する。npm install自体はユーザー設定を変更しない。
 公開JSONは`schema: "aiterm.setup-result.v1"`、全体の`status`、端末の`backend`、
-AI別の`integrations`を持つ。失敗時は`reason_code`を付け、終了コードはreadyなら0、それ以外は2となる。
+AI別の`integrations`と選択機能の`codex_steer`を持つ。失敗時は`reason_code`を付け、終了コードはreadyなら0、再起動待ちは3、それ以外は2となる。
+
+
+### Codex DesktopへSteerを有効にする（macOS・Windows）
+
+対話実行の`aiterm-setup`で「Aiterm単品」と「Steer付き」を選べます。無人導入では明示します。
+
+```bash
+aiterm-setup --json --codex-steer enable
+```
+
+公式Codex Desktopに同梱されたApp Serverを使い、実行中の親には同じターンへ回答を送り、
+終了後に届いた回答でも同じタスクを自動再開します。App Serverの改造・再ビルド・別配布は不要です。
+Steerの初回設定後は`restart_required`（終了コード3）を返します。Codexを完全終了して再起動し、
+`aiterm-setup --codex-steer status`で`ready`を確認してください。接続できない時にキューへ自動退避しません。
+
+選択と復元情報は`~/.config/aiterm-mcp/codex-relay/`へ保存します。macOSはユーザーLaunchAgent、
+Windowsはユーザー環境変数`CODEX_CLI_PATH`で起動設定を維持します。更新時の`aiterm-setup --json`は選択を維持して中継を更新します。
+解除・旧版への巻き戻し前は`aiterm-setup --codex-steer disable`を実行してCodexを再起動してください。
+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もビルドも不要。どのクライアントでも公開パッケージを次のコマンドで起動する:
 
@@ -171,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.35.1** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.37.0** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -205,7 +229,7 @@ pty_read(id, { wait: true })       → 削減済みの出力を読む（完了
 
 同じprimitiveが別エージェントのTUIを宿す。`agent_launch`の`harness`はagent loop・認証・hook・session・transcriptを所有する実行基盤、`model`は独立した選択。起動processは直接CLIと同じproject/user環境を使い、通常config、MCP、plugin、skill、permission、trust、memory、historyをcopy・filter・置換しない。
 
-`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`を完了正本に使う。`pty_send`は非ブロックdispatchで、vendor別完了境界を表すopaqueな整数`event_cursor`を返す。Codex親は公式受信キュー、Claude Code親は公式非同期hookで回答本文を自動受信する。それ以外の親は`aiterm-wait`を親のターンを塞がない別processで受ける。Cursorのsubmitキーはadapterが現行CLIのextended keyboard protocolへ変換する。送信textがCursorのcomposerへ残った場合は成功receiptを返さず失敗する。
+`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`を完了正本に使う。`pty_send`は非ブロックdispatchで、vendor別完了境界を表すopaqueな整数`event_cursor`を返す。Codex親は選択に応じて公式Steerまたは受信キュー、Claude Code親は公式非同期hookで回答本文を自動受信する。それ以外の親は`aiterm-wait`を親のターンを塞がない別processで受ける。Cursorのsubmitキーはadapterが現行CLIのextended keyboard protocolへ変換する。送信textがCursorのcomposerへ残った場合は成功receiptを返さず失敗する。
 
 `agent_launch`・`pty_send`（agent dispatch）・`agent_steer`は任意の`image`（画像ファイルの絶対パスの配列。png/jpg/jpeg/gif/webp）を受ける。aitermが本文末尾へ添付行を付け、どのharnessも自分のfile読取toolでそのpathを画像として開く。呼出し側はharness別の添付手順を覚えない。不正なpathは送信前に拒否する。
 
@@ -518,9 +542,9 @@ SSH先がPowerShellの場合、`mark:true`は現在の標準`PS ...>`プロン
 
 Codex／Claude Codeから子を起動・通常dispatchした後は、別作業へ進むか親のturnを終了するだけでよい。Aitermが完了を観測し、加工前の回答を保存して親へ届ける。waiter、`pty_read`による回答回収、子への送信指示は不要。子は全対応harnessから選べる。
 
-自動配送時はreceiptに`parent_delivery`が付き、`wait_process`／`wait_command`はnullになる。`pty_observe`の`parent_deliveries`で`waiting`、`ready`、`sending`、`submitted`、`failed`、`unknown`を確認できる。`submitted`はCodexのキュー受付またはClaudeのhookへの本文出力を示し、modelの読了ではない。MCP再接続後は未送信の記録を再開し、送信中に接続が切れて結果が分からない場合は本文を保持して`unknown`とする。自動再送はしない。
+自動配送時はreceiptに`parent_delivery`が付き、`wait_process`／`wait_command`はnullになる。`pty_observe`の`parent_deliveries`で`waiting`、`ready`、`sending`、`submitted`、`failed`、`unknown`を確認できる。`submitted`はCodexの公式受信口での受付またはClaudeのhookへの本文出力を示し、modelの読了ではない。MCP再接続後は未送信の記録を再開し、送信中に接続が切れて結果が分からない場合は本文を保持して`unknown`とする。自動再送はしない。
 
-CodexにはMCPの`_meta.threadId`と公式`thread/queue` APIが必要で、Codex CLI 0.154.0で確認している。`aiterm-setup`はインストールされた公式queue入口を確認し、各dispatchでは実際の親threadの受入可否を確認する。Codexのnative sub-agentは外部からのqueue入力を拒否するため、自動配送の親としては未対応。
+単品導入のCodexにはMCPの`_meta.threadId`と公式`thread/queue` APIが必要で、Codex CLI 0.154.0で確認している。`aiterm-setup`はインストールされた公式queue入口を確認し、各dispatchでは実際の親threadの受入可否を確認する。Codexのnative sub-agentは外部からのqueue入力を拒否するため、自動配送の親としては未対応。
 
 Claude Codeは2.1.259以上の対話sessionに対応する。`aiterm-setup`が専用の`PreToolUse`、`PostToolUse`、`SessionEnd`を登録するため、Channelsの起動flagは不要。公式`asyncRewake` hookだけが裏で待ち、親はその間も次のturnへ進める。回答は`Stop hook feedback`として届く。hookのexit 2は親の再開信号であり、子の成功・失敗は本文の`outcome`で区別する。
 

package/README.md

@@ -40,11 +40,35 @@ WindowsはwingetでPowerShell 7・Git for Windows・psmux、macOSはHomebrewでt
 Ubuntu／Debianはsudoとaptでtmuxを準備する。必要な公式package managerと実行権限は事前に必要。
 他のLinuxでも既存tmuxを利用できるが、自動導入は`unsupported`で停止する。
 既存設定の他サーバーを保持し、JSON設定は変更前の`.aiterm-backup`を残す。
-結果の`status`は`ready`／`unsupported`／`failed`。未検出のAIは`not_detected`とし、全AI未検出は成功にしない。
+結果の`status`は`ready`／`unsupported`／`failed`／`restart_required`。未検出のAIは`not_detected`とし、全AI未検出は成功にしない。
 登録先はglobal packageのNodeとMCP入口の絶対パスで、npm一時cacheやsource checkoutは登録しない。
 更新後も同じ入口を実行し、MCP clientを再起動する。npm install自体はユーザー設定を変更しない。
 公開JSONは`schema: "aiterm.setup-result.v1"`、全体の`status`、端末の`backend`、
-AI別の`integrations`を持つ。失敗時は`reason_code`を付け、終了コードはreadyなら0、それ以外は2となる。
+AI別の`integrations`と選択機能の`codex_steer`を持つ。失敗時は`reason_code`を付け、終了コードはreadyなら0、再起動待ちは3、それ以外は2となる。
+
+
+### Codex DesktopへSteerを有効にする（macOS・Windows）
+
+対話実行の`aiterm-setup`で「Aiterm単品」と「Steer付き」を選べます。無人導入では明示します。
+
+```bash
+aiterm-setup --json --codex-steer enable
+```
+
+公式Codex Desktopに同梱されたApp Serverを使い、実行中の親には同じターンへ回答を送り、
+終了後に届いた回答でも同じタスクを自動再開します。App Serverの改造・再ビルド・別配布は不要です。
+Steerの初回設定後は`restart_required`（終了コード3）を返します。Codexを完全終了して再起動し、
+`aiterm-setup --codex-steer status`で`ready`を確認してください。接続できない時にキューへ自動退避しません。
+
+選択と復元情報は`~/.config/aiterm-mcp/codex-relay/`へ保存します。macOSはユーザーLaunchAgent、
+Windowsはユーザー環境変数`CODEX_CLI_PATH`で起動設定を維持します。更新時の`aiterm-setup --json`は選択を維持して中継を更新します。
+解除・旧版への巻き戻し前は`aiterm-setup --codex-steer disable`を実行してCodexを再起動してください。
+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:
 
@@ -185,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.35.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).
+**Status:** actively maintained · current public release **v0.37.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
 
@@ -225,7 +249,7 @@ pty_read(id, { wait: true })       → read the token-reduced output, completion
 
 The same primitive hosts another agent's TUI. `agent_launch` starts a selected execution harness inside a fresh persistent terminal and returns a `session_id`. `harness` names the component that owns the agent loop, authentication, hooks, session, and transcript; `model` remains an independent choice. The launched process sees the same project and user environment as a direct CLI invocation: normal configuration, MCPs, plugins, skills, permissions, trust decisions, memory, and history are not copied, filtered, or replaced. Aiterm adds only completion correlation and a non-user sub-agent context containing `role=subagent`, the parent session, delegation depth, lineage, and `delegation_allowed=true`.
 
-起動結果には正規`harness`を含む`aiterm.agent-launch-result.v1`が付き、旧`provider`は互換fieldとして残る。同じ`harness`はagent dispatch、`aiterm-wait`、`agent_configure`、`pty_list`にも載る。Codexは通常rollout、Grokは通常session event、Claudeはlaunch固有Stop hook、Cursorは通常agent transcriptの`turn_ended`を完了正本に使う。agentへの送信は非ブロックdispatchで、harnessごとの完了境界を表す整数`event_cursor`を返す。Codex親は公式queue、Claude Code親は公式非同期hookで本文を自動受信する。他の親は[`aiterm-wait`](#completion-push-for-parent-agents-aiterm-wait)を使う。CursorのsubmitはadapterがCLIのextended keyboard protocolへ変換し、送信本文がcomposerへ残る場合は明示errorにする。
+起動結果には正規`harness`を含む`aiterm.agent-launch-result.v1`が付き、旧`provider`は互換fieldとして残る。同じ`harness`はagent dispatch、`aiterm-wait`、`agent_configure`、`pty_list`にも載る。Codexは通常rollout、Grokは通常session event、Claudeはlaunch固有Stop hook、Cursorは通常agent transcriptの`turn_ended`を完了正本に使う。agentへの送信は非ブロックdispatchで、harnessごとの完了境界を表す整数`event_cursor`を返す。Codex親は選択に応じて公式Steerまたはqueue、Claude Code親は公式非同期hookで本文を自動受信する。他の親は[`aiterm-wait`](#completion-push-for-parent-agents-aiterm-wait)を使う。CursorのsubmitはadapterがCLIのextended keyboard protocolへ変換し、送信本文がcomposerへ残る場合は明示errorにする。
 
 `agent_launch`, `pty_send` (agent dispatch), and `agent_steer` accept an optional `image`: an array of absolute paths to image files (png/jpg/jpeg/gif/webp). Aiterm appends an attachment block to the prompt, and every harness opens the path with its own file-reading tool and sees the image; the caller never learns harness-specific attachment tricks. Invalid paths are rejected before anything is sent.
 
@@ -513,6 +537,8 @@ continue to use `claude_approval`.
 
 ### Local runtime error snapshot
 
+snapshotの`product_version`は各recordの最終実発生時の版を表す。store v2は旧v1を読み取り、単発記録の版を保持し、複数回の旧集約の版は`unknown`にする。読取りでは状態JSONを書き戻さず、次のロック内更新でv2を保存する。consumerを先に更新し、旧writerの終了後に新writerを使う。v2保存後の旧版への切替は、製品のバックアップ復元を伴う。
+
 `aiterm-runtime-errors snapshot` exposes a machine-readable, product-owned local snapshot for the dotagents factory adapter. Collection is fail-closed unless the canonical dotagents factory-reporter config is schema-exact, its host profile matches the executing OS, and it contains the JSON boolean `collection.enabled: true`; reporting fields are schema-validated but endpoints and credential files are never contacted, and the store performs no network I/O. The only accepted observations are three fixed codes owned by the core boundary (PTY dependency, persistence, and optional vendor launcher). Stored data is limited to fixed templates and aggregate metadata (SHA-256 fingerprint, count, first/last seen, status, and monotonic sequence); exceptions, stderr/stdout, stacks, prompts, terminal/transcript/event bodies, paths, and arbitrary context cannot enter the API. Persisted JSON is revalidated with exact top/record fields and a recomputed fingerprint before explicit DTO projection.
 
 Consumer flow is `aiterm-runtime-errors snapshot`, then `aiterm-runtime-errors ack --cursor N` after durable ingestion. Operators can use `resolve|reopen --fingerprint SHA256`. MCP collection and diagnostic reads run in timeout-bounded child processes, so a FIFO or stalled filesystem cannot block terminal work; child failure emits only the fixed store diagnostic. Store mutation uses a bounded bakery ticket queue: every waiter owns a never-reused ticket containing PID, process-start identity, and an owner token, so dead owners are removed by unique filename without fixed-path reclaim ABA. The queue deadline measures lack of progress by the same head owner, not total wait behind healthy predecessors; normal polling uses the native process-liveness check and validates process-start identity only when a blocker stalls. Worker deadlines use forced termination so a SIGTERM-ignoring child cannot mutate state after timeout. POSIX state is atomically replaced under `$XDG_STATE_HOME/aiterm-mcp/` (default `~/.local/state/aiterm-mcp/`) with owner/mode rechecked on every read. Windows native uses `%LOCALAPPDATA%\aiterm-mcp\`; each DACL is rebuilt and read back as one non-inherited FullControl ACE for the current SID. Windows path/DACL/timeout behavior is covered by pure tests in this change; no new Windows integration success is claimed.
@@ -551,9 +577,9 @@ For PowerShell over SSH, `mark:true` recognizes the current standard `PS ...>` p
 
 **Codex／Claude Code親には子の回答本文が自動で届く。** 子を起動・dispatchした後は、別作業へ進むか親のturnを終える。Aitermが完了を観測し、加工前の本文を保存して親へ渡す。waiter、`pty_read`による回答回収、子への返送指示は不要。子は全対応harnessから選べる。
 
-自動配送のreceiptには`parent_delivery`が付き、`wait_process`／`wait_command`はnullになる。`pty_observe`の`parent_deliveries`で`waiting`、`ready`、`sending`、`submitted`、`failed`、`unknown`を確認できる。`submitted`はCodexのキュー受付またはClaudeのhookへの本文出力を示し、modelの読了ではない。MCP再接続後は未送信の記録を再開し、出力中断で結果が分からない場合は本文を保持して`unknown`とする。自動再送はしない。
+自動配送のreceiptには`parent_delivery`が付き、`wait_process`／`wait_command`はnullになる。`pty_observe`の`parent_deliveries`で`waiting`、`ready`、`sending`、`submitted`、`failed`、`unknown`を確認できる。`submitted`はCodexの公式受信口での受付またはClaudeのhookへの本文出力を示し、modelの読了ではない。MCP再接続後は未送信の記録を再開し、出力中断で結果が分からない場合は本文を保持して`unknown`とする。自動再送はしない。
 
-Use a Codex runtime that supplies MCP `_meta.threadId` and the official `thread/queue` API (verified with Codex CLI 0.154.0). `aiterm-setup` checks the installed queue entry point; Aiterm verifies the requesting thread before each dispatch. Codex native sub-agents reject external queue input and cannot be automatic-delivery parents. Ordinary CLI and Desktop parents use the same supported route.
+For queue delivery, use a Codex runtime that supplies MCP `_meta.threadId` and the official `thread/queue` API (verified with Codex CLI 0.154.0). `aiterm-setup` checks the installed queue entry point; Aiterm verifies the requesting thread before each dispatch. Codex native sub-agents reject external queue input and cannot be automatic-delivery parents. This queue route applies when Desktop Steer is not enabled.
 
 Claude Codeは2.1.259以上の対話sessionに対応する。`aiterm-setup`が専用の`PreToolUse`、`PostToolUse`、`SessionEnd`を登録するため、Channelsの起動flagは不要。公式`asyncRewake` hookだけが裏で待ち、親はその間も次のturnへ進める。回答は`Stop hook feedback`として届く。hookのexit 2は親の再開信号であり、子の成功・失敗は本文の`outcome`で区別する。
 

package/dist/codex-delivery-error.js

@@ -0,0 +1,10 @@
+import { AitermError } from "./errors.js";
+export class CodexDeliveryError extends AitermError {
+    delivery_code;
+    outcome_unknown;
+    constructor(delivery_code, message, outcome_unknown = false) {
+        super(`${delivery_code}: ${message}`, 2);
+        this.delivery_code = delivery_code;
+        this.outcome_unknown = outcome_unknown;
+    }
+}

package/dist/codex-parent-receiver.js

@@ -1,19 +1,13 @@
-// Codex親の公式受信キューへの接続。親threadのload／resumeやDesktop固有通信は行わない。
+// Codex親の配送。Steerを選択した環境は同じ公式App Server、それ以外は公式queueを使う。
 import { spawn } from "node:child_process";
 import { createInterface } from "node:readline";
 import * as path from "node:path";
 import { resolveAgentBin } from "./agent-resolver.js";
 import { realCodexHome } from "./harnesses/codex.js";
-import { AitermError } from "./errors.js";
-export class CodexDeliveryError extends AitermError {
-    delivery_code;
-    outcome_unknown;
-    constructor(delivery_code, message, outcome_unknown = false) {
-        super(`${delivery_code}: ${message}`, 2);
-        this.delivery_code = delivery_code;
-        this.outcome_unknown = outcome_unknown;
-    }
-}
+import { CodexDeliveryError } from "./codex-delivery-error.js";
+import { readRelayConfig, parentRelaySocket } from "./codex-relay-config.js";
+import { withCodexRelay, verifyLoadedParent } from "./codex-relay-client.js";
+export { CodexDeliveryError } from "./codex-delivery-error.js";
 /** modelの引数ではなく、CodexがMCP要求へ付けるmetadataだけを宛先にする。 */
 export function codexParentFromRequest(clientName, metadata) {
     if (clientName !== "codex-mcp-client")
@@ -24,6 +18,12 @@ export function codexParentFromRequest(clientName, metadata) {
     }
     return { thread_id: threadId, codex_home: path.resolve(realCodexHome()) };
 }
+function relaySocket(runtime) {
+    if (runtime)
+        return runtime.socket_path ?? null;
+    const config = readRelayConfig();
+    return config?.enabled ? parentRelaySocket(config) : null;
+}
 async function withCodexReceiver(parent, action, runtime = {}) {
     const executable = runtime.executable ?? resolveAgentBin("codex");
     if (!executable)
@@ -108,6 +108,11 @@ async function withCodexReceiver(parent, action, runtime = {}) {
 }
 /** 子へ送る前に、同じstoreの宛先と公式キューの対応を確認する。本文は保存・表示しない。 */
 export async function verifyCodexParent(parent, runtime) {
+    const socket = relaySocket(runtime);
+    if (socket) {
+        await withCodexRelay(socket, request => verifyLoadedParent(request, parent.thread_id), runtime?.timeout_ms);
+        return;
+    }
     await withCodexReceiver(parent, async (request) => {
         const response = await request("thread/read", { threadId: parent.thread_id, includeTurns: false });
         if (response?.thread?.id !== parent.thread_id) {
@@ -121,6 +126,19 @@ export async function verifyCodexParent(parent, runtime) {
     }, runtime);
 }
 export async function submitCodexParentAnswer(parent, deliveryId, text, runtime) {
+    const socket = relaySocket(runtime);
+    if (socket) {
+        return withCodexRelay(socket, async (request) => {
+            await verifyLoadedParent(request, parent.thread_id);
+            // 公式の同一処理内で、実行中はSteer、終了済みなら開始する。本文は一度だけ送る。
+            const result = await request("turn/start", { threadId: parent.thread_id,
+                input: [{ type: "text", text, text_elements: [] }], clientUserMessageId: deliveryId });
+            if (typeof result?.turn?.id !== "string" || !result.turn.id) {
+                throw new CodexDeliveryError("CODEX_RECEIVER_INVALID_RESPONSE", "配送先turnの受付IDを確認できません", true);
+            }
+            return { queued_submission_id: null };
+        }, runtime?.timeout_ms);
+    }
     return withCodexReceiver(parent, async (request) => {
         const result = await request("thread/queue/add", {
             threadId: parent.thread_id,

package/dist/codex-relay-client.js

@@ -0,0 +1,117 @@
+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 {
+        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(connection.url, {
+        ...connection.options, handshakeTimeout: timeout, perMessageDeflate: false,
+    });
+    let sequence = 0;
+    let failure = null;
+    const pending = new Map();
+    const fail = (message) => {
+        failure = message;
+        for (const item of pending.values()) {
+            clearTimeout(item.timer);
+            item.reject(new CodexDeliveryError("CODEX_RELAY_TRANSPORT_FAILED", message, item.writing));
+        }
+        pending.clear();
+    };
+    socket.on("error", () => fail("公式App Serverとの通信が失敗しました"));
+    socket.on("close", () => fail("公式App Serverとの接続が終了しました"));
+    socket.on("message", (data, binary) => {
+        let value;
+        try {
+            if (binary)
+                throw new Error();
+            value = JSON.parse(data.toString());
+        }
+        catch {
+            fail("公式App ServerのJSON応答を読めません");
+            return;
+        }
+        if (value?.method !== undefined)
+            return;
+        const item = pending.get(value?.id);
+        if (!item)
+            return;
+        clearTimeout(item.timer);
+        pending.delete(value.id);
+        if (value.error)
+            item.reject(new CodexDeliveryError("CODEX_RECEIVER_REJECTED", typeof value.error.message === "string" ? value.error.message : "公式受信口が要求を拒否しました"));
+        else if ("result" in value)
+            item.resolve(value.result);
+        else
+            item.reject(new CodexDeliveryError("CODEX_RECEIVER_INVALID_RESPONSE", "公式受信口の応答にresultがありません", item.writing));
+    });
+    const request = (method, params) => new Promise((resolve, reject) => {
+        if (failure || socket.readyState !== WebSocket.OPEN) {
+            reject(new CodexDeliveryError("CODEX_RELAY_UNAVAILABLE", failure ?? "接続が開いていません"));
+            return;
+        }
+        const id = ++sequence;
+        const writing = method === "turn/start";
+        const timer = setTimeout(() => {
+            pending.delete(id);
+            reject(new CodexDeliveryError("CODEX_RECEIVER_TIMEOUT", `${method}の応答を確認できません`, writing));
+        }, timeout);
+        pending.set(id, { resolve, reject, timer, writing });
+        socket.send(JSON.stringify({ id, method, params }), error => { if (error)
+            fail("公式App Serverへの送信に失敗しました"); });
+    });
+    try {
+        await new Promise((resolve, reject) => {
+            socket.once("open", resolve);
+            socket.once("error", () => reject(new CodexDeliveryError("CODEX_RELAY_UNAVAILABLE", "公式App Serverへ接続できません")));
+            socket.once("close", () => reject(new CodexDeliveryError("CODEX_RELAY_UNAVAILABLE", "公式App Serverが接続を閉じました")));
+        });
+        await request("initialize", { clientInfo: { name: "aiterm_parent_delivery", version: "1" } });
+        socket.send(JSON.stringify({ method: "initialized" }));
+        return await action(request);
+    }
+    finally {
+        for (const item of pending.values())
+            clearTimeout(item.timer);
+        pending.clear();
+        socket.terminate();
+    }
+}
+export async function verifyLoadedParent(request, threadId) {
+    let cursor = null;
+    do {
+        const result = await request("thread/loaded/list", { limit: 100, ...(cursor ? { cursor } : {}) });
+        if (!Array.isArray(result?.data))
+            throw new CodexDeliveryError("CODEX_RECEIVER_INVALID_RESPONSE", "実行中taskの一覧を確認できません");
+        if (result.data.includes(threadId)) {
+            const read = await request("thread/read", { threadId, includeTurns: false });
+            if (read?.thread?.id !== threadId)
+                throw new CodexDeliveryError("CODEX_PARENT_UNAVAILABLE", "親taskの識別が一致しません");
+            const subagent = read.thread.source?.subAgent;
+            if (subagent && typeof subagent === "object" && "thread_spawn" in subagent) {
+                throw new CodexDeliveryError("CODEX_PARENT_UNSUPPORTED", "Codexのnative sub-agentは外部processからの直接入力を受け付けません");
+            }
+            return;
+        }
+        const next = result.nextCursor ?? null;
+        if (next !== null && (typeof next !== "string" || next === cursor))
+            throw new CodexDeliveryError("CODEX_RECEIVER_INVALID_RESPONSE", "task一覧の続きが不正です");
+        cursor = next;
+    } while (cursor);
+    throw new CodexDeliveryError("CODEX_PARENT_UNAVAILABLE", "同じ公式App Serverに親taskがありません。別processでのresumeやqueueへの退避は行いません");
+}

package/dist/codex-relay-config.js

@@ -0,0 +1,70 @@
+// Aitermの選択設定と、同じ親processが所有する公式socketの識別。
+import * as fs from "node:fs";
+import * as path from "node:path";
+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(),
+    binary: z.string(), node: z.string(), launcher: z.string(), socket_root: z.string(),
+    previous_cli_path: z.string().nullable(),
+}).strict();
+export function relayConfigDirectory(home = process.env.HOME ?? homedir()) {
+    return path.join(home, ".config", "aiterm-mcp", "codex-relay");
+}
+export function readRelayConfig(directory = relayConfigDirectory()) {
+    const file = path.join(directory, "config.json");
+    let text;
+    try {
+        text = fs.readFileSync(file, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return null;
+        throw error;
+    }
+    try {
+        return relayConfigSchema.parse(JSON.parse(text));
+    }
+    catch {
+        throw new CodexDeliveryError("CODEX_RELAY_CONFIG_INVALID", "Steerの設定を読めません。aiterm-setup --codex-steer statusで確認してください");
+    }
+}
+export function prepareRelayDirectory(directory) {
+    if (!path.isAbsolute(directory))
+        throw new CodexDeliveryError("CODEX_RELAY_PATH_INVALID", "socketディレクトリが絶対pathではありません");
+    fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
+    const stat = fs.lstatSync(directory);
+    if (!stat.isDirectory() || stat.uid !== process.getuid?.() || (stat.mode & 0o777) !== 0o700) {
+        throw new CodexDeliveryError("CODEX_RELAY_PATH_INVALID", "socketディレクトリは本人所有の0700である必要があります");
+    }
+}
+export function verifyRelaySocket(socket) {
+    const directory = fs.lstatSync(path.dirname(socket));
+    const stat = fs.lstatSync(socket);
+    if (!directory.isDirectory() || directory.uid !== process.getuid?.() || (directory.mode & 0o777) !== 0o700
+        || !stat.isSocket() || stat.uid !== process.getuid?.() || (stat.mode & 0o777) !== 0o600) {
+        throw new CodexDeliveryError("CODEX_RELAY_PATH_INVALID", "本人所有の公式socketを確認できません");
+    }
+}
+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;
+    while (current && !seen.has(current)) {
+        seen.add(current);
+        const socket = path.join(config.socket_root, `${current}.sock`);
+        if (fs.existsSync(socket)) {
+            verifyRelaySocket(socket);
+            return socket;
+        }
+        current = rows.get(current)?.parent_pid;
+    }
+    throw new CodexDeliveryError("CODEX_STEER_RESTART_REQUIRED", "Steerを有効にしたCodex Desktopの親接続がありません。aiterm-setupの結果を確認し、Codexを再起動してください");
+}

package/dist/codex-relay-launcher.js

@@ -0,0 +1,63 @@
+// POSIXのexecで公式CLIのPIDとDesktopからの親子関係を維持する。
+const quote = (text) => `'${text.replace(/'/g, `'"'"'`)}'`;
+export function codexRelayLauncher(options) {
+    return `#!/bin/sh
+binary=${quote(options.binary)}
+node=${quote(options.node)}
+relay=${quote(options.relay)}
+root=${quote(options.socket_root)}
+mode=root
+value=no
+for arg do
+  if [ "$value" = yes ]; then value=no; continue; fi
+  case "$arg" in
+    -c|--config|--enable|--disable|--listen) value=yes; continue ;;
+  esac
+  if [ "$mode" = root ]; then
+    case "$arg" in
+      --config=*|--enable=*|--disable=*|-c?*) ;;
+      app-server) mode=server ;;
+      *) mode=other; break ;;
+    esac
+  else
+    case "$arg" in
+      proxy|start|stop|status|generate-ts|generate-json-schema|--help|-h|--version|-V) mode=other; break ;;
+    esac
+  fi
+done
+if [ "$mode" != server ]; then exec "$binary" "$@"; fi
+
+# 引数を一巡させ、stdio指定だけを公式Unix受付へ変更する。
+remaining=$#
+value=no
+while [ "$remaining" -gt 0 ]; do
+  arg=$1
+  shift
+  remaining=$((remaining - 1))
+  if [ "$value" = yes ]; then
+    set -- "$@" "$arg"
+    value=no
+    continue
+  fi
+  case "$arg" in
+    -c|--config|--enable|--disable) value=yes; set -- "$@" "$arg" ;;
+    --stdio) ;;
+    --listen)
+      if [ "$remaining" -eq 0 ] || [ "$1" != stdio:// ]; then
+        echo 'aiterm-relay: stdio以外の接続指定は変更できません' >&2
+        exit 2
+      fi
+      shift
+      remaining=$((remaining - 1)) ;;
+    --listen=stdio://) ;;
+    --listen=*) echo 'aiterm-relay: stdio以外の接続指定は変更できません' >&2; exit 2 ;;
+    *) set -- "$@" "$arg" ;;
+  esac
+done
+"$node" "$relay" --prepare "$root" || exit $?
+socket="$root/$$.sock"
+exec 3<&0
+"$node" "$relay" "$socket" "$$" <&3 3<&- &
+exec "$binary" "$@" --listen "unix://$socket" </dev/null >/dev/null 3<&-
+`;
+}

package/dist/codex-relay-login.js

@@ -0,0 +1,47 @@
+// ユーザーのログイン時にもCodexの起動設定を適用する、Aiterm専用LaunchAgent。
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { homedir } from "node:os";
+import { spawnSync } from "node:child_process";
+import { SetupError } from "./setup-platform.js";
+const label = "dev.kitepon.aiterm-codex-relay";
+const xml = (text) => text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+export function relayLoginPlist(launcher) {
+    return `<?xml version="1.0" encoding="UTF-8"?>\n<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">\n<plist version="1.0"><dict><key>Label</key><string>${label}</string><key>ProgramArguments</key><array><string>/bin/launchctl</string><string>setenv</string><string>CODEX_CLI_PATH</string><string>${xml(launcher)}</string></array><key>RunAtLoad</key><true/></dict></plist>\n`;
+}
+function context(options) {
+    const directory = options.directory ?? path.join(process.env.HOME ?? homedir(), "Library", "LaunchAgents");
+    const uid = options.uid ?? process.getuid?.();
+    if (uid === undefined)
+        throw new SetupError("codex_steer_platform_unsupported", "LaunchAgentはmacOSだけで使用します");
+    const run = options.run ?? ((args) => {
+        const result = spawnSync("/bin/launchctl", args, { encoding: "utf8", timeout: 10_000 });
+        if (result.error)
+            throw new SetupError("codex_steer_login_failed", "ログイン時の起動設定を実行できません");
+        return result.status ?? -1;
+    });
+    return { directory, file: path.join(directory, `${label}.plist`), domain: `gui/${uid}`, service: `gui/${uid}/${label}`, run };
+}
+export function installRelayLogin(launcher, options = {}) {
+    const { directory, file, domain, service, run } = context(options);
+    const contents = relayLoginPlist(launcher);
+    if (fs.existsSync(file) && (fs.lstatSync(file).isSymbolicLink() || fs.readFileSync(file, "utf8") !== contents)) {
+        throw new SetupError("codex_steer_login_conflict", "同名のLaunchAgentが変更されています。所有外の設定は上書きしません");
+    }
+    fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
+    if (!fs.existsSync(file))
+        fs.writeFileSync(file, contents, { mode: 0o600, flag: "wx" });
+    if (run(["print", service]) !== 0 && run(["bootstrap", domain, file]) !== 0)
+        throw new SetupError("codex_steer_login_failed", "ログイン時のSteer設定を登録できません");
+}
+export function removeRelayLogin(launcher, options = {}) {
+    const { file, service, run } = context(options);
+    if (!fs.existsSync(file))
+        return;
+    if (fs.lstatSync(file).isSymbolicLink() || fs.readFileSync(file, "utf8") !== relayLoginPlist(launcher)) {
+        throw new SetupError("codex_steer_login_conflict", "変更されたLaunchAgentは削除しません");
+    }
+    if (run(["print", service]) === 0 && run(["bootout", service]) !== 0)
+        throw new SetupError("codex_steer_login_failed", "ログイン時のSteer設定を解除できません");
+    fs.unlinkSync(file);
+}