@agents-ensemble/cli 0.14.0 → 0.14.2

package/docs/config.md

@@ -61,8 +61,7 @@ conductor:
 acp:
   defaultPreset: codex                # ENSEMBLE_DEFAULT_ACP_CLI 相当
   env:                                # codex-acp 子プロセス spawn に渡す env（user → project deep merge）
-    MODEL_PROVIDER: litellm           # 例: LiteLLM ゲートウェイ
-    CODEX_CONFIG: ~/.codex/litellm.config.toml
+    MODEL_PROVIDER: litellm           # Codex provider ID。接続設定は Codex config 側
 
 session:
   worktree: isolated                  # --worktree 既定（isolated | in-repo）
@@ -78,9 +77,9 @@ github:
     allowGhAuthTokenFallback: true
   monitor:
     enabled: true
-    debounceMs: 30000
-    pollIntervalMs: 60000
-    activePollIntervalMs: 15000
+    debounceMs: 60000
+    pollIntervalMs: 120000
+    activePollIntervalMs: 60000
     stopPollWaitMs: 5000
 
 tui:
@@ -134,7 +133,31 @@ spawn 解決時、子プロセスへ渡す env は次の順でマージされま
 
 #### LiteLLM（OpenAI 互換ゲートウェイ）向け config 例
 
-**team profile ではなく ensemble config に書く。** 秘密情報はプレースホルダに置き換える。
+Codex worker の接続先は Codex の provider 設定で定義し、`acp.env.MODEL_PROVIDER` で使う provider ID を選びます。ensemble はこの環境変数を `codex-acp` に渡すだけで、TOML ファイルを選んだり読み込んだりはしません。
+
+`@agentclientprotocol/codex-acp` は `packages/core/package.json` で **2.2.2** に pin されています。この版では、`CODEX_CONFIG` は Codex session config に merge する **JSON オブジェクト文字列**として `JSON.parse` されます。TOML のパスを設定すると JSON parse に失敗します。`MODEL_PROVIDER` は新しい session に渡す **provider ID** で、設定ファイルの選択には使われません。ensemble はいずれの値も `acp.env` から子プロセスへ渡すだけです。
+
+Codex の model ID はトップレベルの `model`、provider は `model_provider` で指定し、provider IDに対応する `[model_providers.<id>]` から接続先・API形式・認証方法を読みます。worker では Codex が通常の設定レイヤー（主に `~/.codex/config.toml`）を読み、必要であれば `CODEX_CONFIG` の JSON が session config に加わります。`MODEL_PROVIDER=litellm` だけでは、Codex は別ファイル `litellm.config.toml` を探さず、model IDも選びません。
+
+`CODEX_CONFIG` の JSON には `model`、`model_provider`、`model_providers` などCodex session configのキーを含められます。ただし `MODEL_PROVIDER` を設定した場合は、codex-acp が新しいsessionの provider IDとしてその値を別途渡し、JSON内の `model_provider` より優先します。model IDとprovider IDに対応する定義は、それぞれCodexの通常configかJSON設定に必要です。model IDはLiteLLM側で提供されるものを指定してください。
+
+以下の例では秘密値を記載せず、環境変数名を使います。実際の `LITELLM_API_KEY` はシェル等で設定してください。
+
+#### A. provider 設定を正本 config にまとめる（推奨）
+
+provider 定義を `~/.codex/config.toml` に置き、ensemble config では provider ID だけを指定します。Codex CLI と worker が同じ provider 定義を参照し、worker の接続先は `MODEL_PROVIDER` で切り替えられます。
+
+```toml
+# ~/.codex/config.toml
+model = "YOUR_LITELLM_MODEL_ID"
+model_provider = "litellm"
+
+[model_providers.litellm]
+name = "LiteLLM"
+base_url = "https://litellm.example/v1"
+wire_api = "responses"
+env_key = "LITELLM_API_KEY"
+```
 
 ```yaml
 # ~/.ensemble/config.yaml または <repo>/.ensemble/config.yaml
@@ -142,23 +165,71 @@ acp:
   defaultPreset: codex
   env:
     MODEL_PROVIDER: litellm
-    CODEX_CONFIG: ~/.codex/litellm.config.toml
 ```
 
-`litellm.config.toml` は Codex の [Profiles](https://developers.openai.com/codex/config-advanced) と同様に `~/.codex/` 配下に置く。`CODEX_CONFIG` でそのパスを codex-acp に指示する。
+`model` にはLiteLLM側で提供する実際のmodel IDを指定します。Codex CLI とworkerの両方がこのmodel設定を使います。`MODEL_PROVIDER` はworker sessionで使うproviderだけを選び、model IDは変更しません。別providerへ切り替える場合は、そのproviderでも同じmodel IDが利用できることを確認してください。Codex CLIで別の既定providerを使う場合は、`model_provider` をそのprovider IDにします。認証値は設定ファイルに書かず、Codexが参照する環境変数で渡してください。
+
+#### B. Codex CLI のprofile overlayを使う
+
+Codex CLI の `codex --profile litellm` は、まず `~/.codex/config.toml` を読み、その上に `~/.codex/litellm.config.toml` を重ねます。profile ファイルには `[profiles.litellm]` ではなく通常のトップレベル設定を書きます。Codex 0.134.0 以降、`config.toml` 内の `[profiles.litellm]` と `profile = "litellm"` による指定は使われません。
+
+```toml
+# ~/.codex/litellm.config.toml — Codex CLI 用 overlay
+model = "YOUR_LITELLM_MODEL_ID"
+model_provider = "litellm"
+
+[model_providers.litellm]
+name = "LiteLLM"
+base_url = "https://litellm.example/v1"
+wire_api = "responses"
+env_key = "LITELLM_API_KEY"
+```
+
+このprofile overlayは **Codex CLI 用**です。ensemble worker は `codex-acp` から Codex `app-server` を起動する経路であり、`codex --profile` を指定できません。worker にはAのように provider 定義を `~/.codex/config.toml` に置くか、Cのように `CODEX_CONFIG` でsession設定を渡してください。Codex の `config.toml` に別TOMLを読み込む公式include機能はありません。CLI profileとworkerで別ファイルを正本にする場合、worker側の設定にも同じprovider定義が必要です。手動で同期するか、設定生成で両方を作成してください。
+
+#### C. worker 用 JSON 設定を別ファイルで管理する
+
+小規模な設定や検証では、worker 専用の JSON ファイルを用意し、その**内容**を `CODEX_CONFIG` に渡せます。`CODEX_CONFIG` 自体にはファイルパスではなくJSON文字列を設定します。例えば、次のファイルを作成します。
+
+```json
+{
+  "model": "YOUR_LITELLM_MODEL_ID",
+  "model_providers": {
+    "litellm": {
+      "name": "LiteLLM",
+      "base_url": "https://litellm.example/v1",
+      "wire_api": "responses",
+      "env_key": "LITELLM_API_KEY"
+    }
+  }
+}
+```
+
+そのファイルの内容を環境変数に読み込み、`acp.env` では `CODEX_CONFIG` を上書きしないで起動します。
 
-#### CLI `codex --profile litellm` と ensemble worker の対応
+```sh
+export CODEX_CONFIG="$(jq -c . "$HOME/.codex/ensemble-worker.json")"
+ensemble issue 123
+```
+
+```yaml
+# ~/.ensemble/config.yaml または <repo>/.ensemble/config.yaml
+acp:
+  defaultPreset: codex
+  env:
+    MODEL_PROVIDER: litellm
+```
 
-| 手段 | profile レイヤー | config `acp.env` | 備考 |
-|------|------------------|------------------|------|
-| `codex --profile litellm`（CLI 直接） | Codex profile `litellm` | — | `~/.codex/config.toml` の `[profiles.litellm]` を読む |
-| `ensemble issue` + 上記 config 例 | — | `MODEL_PROVIDER` / `CODEX_CONFIG` | codex-acp → `codex app-server`（**`--profile` 非対応**）。env で config ファイルを指定 |
+`jq -c` は JSON を1行に整形して環境変数へ渡します。`acp.env` に `CODEX_CONFIG` を設定した場合は、親プロセスから継承した値より `acp.env` の値が優先されます。設定を別ファイルで保ちたい場合は、ファイル内容を起動前に環境変数へ変換してください。CではCodex CLIのprovider設定は変わらず、JSONはworker sessionにのみ適用されます。
 
-`CODEX_CONFIG_PROFILE`（Codex 側 profile 名の env 指定）は [openai/codex#38104](https://github.com/openai/codex/issues/38104) で未実装。将来実装されたら `acp.env` に載せる想定。
+#### Codex CLI と ensemble worker の違い
 
-#### `litellm.config.toml` を `~/.codex/config.toml` に統合する代替
+| 起動方法 | 設定の選択・読み込み | LiteLLM の指定 |
+|----------|--------------------|----------------|
+| `codex --profile litellm` | Codex CLI が `~/.codex/config.toml` に `~/.codex/litellm.config.toml` をoverlay | profileファイルに `model`、`model_provider`、provider 定義を記述 |
+| ensemble の Codex worker | `codex-acp` → Codex `app-server`。`--profile` は渡せない。Codex の通常 config とsession設定を利用 | `MODEL_PROVIDER` でprovider IDを選択し、`model` は通常config（A）または `CODEX_CONFIG` JSON（C）で指定 |
 
-`litellm` を Codex profile として `[profiles.litellm]` に書き、`codex --profile litellm` で使う方法もある。統合すると CLI と ensemble の設定が 1 ファイルにまとまるが、**ensemble worker は現状 `app-server` 経路で `--profile` を受け取れない**ため、CLI だけ統合しても worker 側は `CODEX_CONFIG` 等の env 指示が別途必要。profile 分割のまま `CODEX_CONFIG` でファイルを指す方が、CLI / ensemble の設定境界が明確になる。
+`CODEX_CONFIG_PROFILE` によるprofile名指定は Codex 側で未実装です（[openai/codex#38104](https://github.com/openai/codex/issues/38104)）。したがって worker のprofile選択手段としては使えません。
 
 #### resume と `acp.env` 変更
 
@@ -321,6 +392,11 @@ YAML に未知のキーがあっても **無視する**（警告なし）。将
 
 - [pi-conductor-setup.md](pi-conductor-setup.md) — Pi conductor の初回セットアップ・認証・復旧（利用者向け正本）
 - [settings.md](settings.md) — 全設定層の一覧・解決パターン（本書は config.yaml 詳細）
+- [ADR 0028](adr/0028-authentication-delegation-and-ensemble-auth.md) — worker の認証移譲とCodex runtime設定
+- [Codex profiles / custom model providers](https://developers.openai.com/codex/config-advanced#profiles) — Codex CLI profile overlay、`model`、`model_provider` の現行仕様
+- [codex-acp 2.2.2 runtime options](https://github.com/agentclientprotocol/codex-acp/blob/v2.2.2/README.md#runtime-options) — `CODEX_CONFIG` / `MODEL_PROVIDER` の説明
+- [codex-acp 2.2.2 起動処理](https://github.com/agentclientprotocol/codex-acp/blob/v2.2.2/src/index.ts#L90-L99) — 環境変数の parse と ACP 起動時の読み込み
+- [codex-acp 2.2.2 session開始](https://github.com/agentclientprotocol/codex-acp/blob/v2.2.2/src/CodexAcpClient.ts#L745-L755) — session config と provider ID を Codex app-server へ渡す処理
 - [ADR 0020](https://github.com/otolab/agents-ensemble/blob/main/docs/adr/0020-ensemble-config-setting-resolution.md) — 解決順の設計判断
 - [ADR 0018](https://github.com/otolab/agents-ensemble/blob/main/docs/adr/0018-team-profile-four-layer-resolution.md) — `.ensemble/` 配下の規約（team-profile）
 - [#223](https://github.com/otolab/agents-ensemble/issues/223) — config 基盤

package/docs/settings.md

@@ -10,7 +10,7 @@
 | **環境変数** | シェル / CI | 一時上書き・秘密情報・自動化注入 |
 | **project config** | `<repoRoot>/.ensemble/config.yaml` | リポジトリ単位の既定 |
 | **user config** | `~/.ensemble/config.yaml` | マシン全体の既定 |
-| **user conductor instructions** | `~/.ensemble/AGENTS.md` | profile に依存しない conductor 向けの運用前提 |
+| **user instructions** | `~/.ensemble/AGENTS.md` | profile に依存しない conductor / worker 共通の運用前提 |
 | **team profile** | `profile.yaml`（[elements.md](elements.md)） | worker 構成・workspace（**ACP は含まない → [config.md](config.md)**） |
 | **Codex profile** | `~/.codex/config.toml` + `codex --profile` | Codex CLI の profile（ensemble team profile とは無関係） |
 | **MCP** | `.agents/mcp.json` / `~/.ensemble/mcp.json` | conductor 向け MCP（[config.md § MCP](config.md#conductor-mcp-設定mcpjson)） |
@@ -134,7 +134,7 @@ TUI 設定は `loadEnsembleConfig` 結果を `createIssueSessionTuiHost` へ渡
 | 設定 | ファイル | 解決順 |
 |------|----------|--------|
 | conductor MCP | `.agents/mcp.json` / `~/.ensemble/mcp.json` | project > user（サーバー名単位 merge） |
-| conductor 向け user 文書 | `~/.ensemble/AGENTS.md` | user 固定。project 層なし |
+| user instructions | `~/.ensemble/AGENTS.md` | user 固定。conductor と worker 全員に適用。project 層なし |
 | team profile | `.ensemble/profiles/…` / `--profile` パス | [ADR 0018](https://github.com/otolab/agents-ensemble/blob/main/docs/adr/0018-team-profile-four-layer-resolution.md) |
 
 ## 一覧 — ランタイム（利用者が「設定」しない）
@@ -149,7 +149,7 @@ TUI 設定は `loadEnsembleConfig` 結果を `createIssueSessionTuiHost` へ渡
 
 | やりたいこと | 推奨 |
 |--------------|------|
-| 複数 repo で conductor に共有する短い運用前提 | `~/.ensemble/AGENTS.md`（[modular-prompt の文書の役割](modular-prompt.md)を参照） |
+| 複数 repo で conductor と worker に共有する短い運用前提 | `~/.ensemble/AGENTS.md`（[modular-prompt の文書の役割](modular-prompt.md)を参照） |
 | チーム / 個人の恒久既定（モデル、worktree、monitor） | `~/.ensemble/config.yaml` または project `.ensemble/config.yaml` |
 | CI で 1 ジョブだけ上書き | 環境変数（`CONDUCTOR_MODEL_ID` 等） |
 | 1 回限りの実行 | CLI フラグ（初回メッセージは `ensemble issue <ref> [message...]`） |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agents-ensemble/cli",
-  "version": "0.14.0",
+  "version": "0.14.2",
   "type": "module",
   "description": "ensemble CLI — Issue-based agent orchestration",
   "bin": {
@@ -17,8 +17,8 @@
     "react": "19.2.0",
     "react-ink-textarea": "npm:@otolab/react-ink-textarea@0.4.1-otolab.3",
     "string-width": "8.1.0",
-    "@agents-ensemble/core": "0.14.0",
-    "@agents-ensemble/operator-agent": "0.2.0"
+    "@agents-ensemble/core": "0.14.2",
+    "@agents-ensemble/operator-agent": "0.2.2"
   },
   "devDependencies": {
     "@types/js-yaml": "4.0.9",