Skip to content

Commit 14b20de

Browse files
authored
feat(codex): add exact account routing (#671)
* feat(codex): add exact account routing * test(ci): stabilize Windows ACL and budget checks * fix(codex): keep exact account on inline sidecars
1 parent 230aea9 commit 14b20de

29 files changed

Lines changed: 1518 additions & 150 deletions

‎docs-site/src/content/docs/ja/reference/configuration/providers.md‎

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ description: プロバイダー エントリ、認証、エンドポイント、
1616
| `contextCapValue?` | `number` | `350000` |ダッシュボードのコンテキストキャップ コントロールで使用される値。これを変更すると、有効になっているすべての `providerContextCaps` エントリが更新されます。 |
1717
| `codexAccounts?` | `CodexAccount[]` | `[]` | ChatGPT/Codex プール アカウントのメタデータは Codex Auth によって管理されます。秘密は`codex-accounts.json`に別に住んでいます。 |
1818
| `pausedCodexAccountIds?` | `string[]` | `[]` |再開するまでプールの選択から除外されるアカウント (一時停止時のメイン `__main__` アカウントを含む)。 |
19-
| `codexAccountNamespaces?` | `Record<string, string>` | — |保存された Codex アカウント ターゲットへのパブリック モデル セレクター ネームスペース。これによりマッピングが検証され、永続化されますが、それ自体ではピッカー行の追加やルーティングの変更は行われません。 |
19+
| `codexAccountNamespaces?` | `Record<string, string>` | — | 公開 model selector namespace から保存済み Codex アカウント target への任意 map。`<selector>/<native OpenAI model>` は対応するアカウントだけに routing され、この設定自体は model picker row を追加しません。 |
2020
| `activeCodexAccountId?` | `string` | — |次のリクエスト用に手動で選択されたプール アカウント。選択するとスレッドのアフィニティがクリアされます。実行中のリクエストでは、取得された資格情報が保持されます。 |
2121
| `autoSwitchThreshold?` | `number` | `80` | 使用量ベースのプロアクティブ切り替えしきい値。`quota` は紐付け済み/未紐付けタスクの次のリクエストを再評価でき、`fill-first` は未紐付け割り当ての使い切り基準としてのみ使用し、通常の `round-robin` 選択は使用しません。既知の 5 時間、週次、30 日 quota window の最大スコアを使います。`0` は使用量ベースの切り替えだけを無効にし、未紐付け割り当てや障害回復は無効にしません。 |
2222
| `accountPoolStrategy?` | `"quota" \| "round-robin" \| "fill-first"` | `"quota"` | 新規/未紐付け Codex リクエストの割り当て戦略。live な `(parent thread id, quota scope)` affinity がなければ未紐付けで、プロキシ再起動や affinity リセット後は既存の表示タスクも未紐付けになり得ます。`quota` はアクティブアカウントがなければ既知 usage 最小の適格アカウントを選び、適格なアクティブアカウントが `autoSwitchThreshold` 未満なら維持します。しきい値到達後は、未紐付けリクエストまたは紐付け済みタスクの次のリクエストを usage の低い適格アカウントへ移せます。`round-robin` は未紐付けリクエストを均等分散し、`fill-first` は cooldown、使用不可、または drain threshold までアクティブアカウントへ割り当てます。 |
@@ -26,7 +26,14 @@ description: プロバイダー エントリ、認証、エンドポイント、
2626
| `cacheRetention?` | `"none" \| "short" \| "long"` | `"short"` | Anthropic プロンプト キャッシュ ポリシー: 無効、5 分間の一時的、または 1 時間の延長。 |
2727
| `tokenGuardian?` | `OcxTokenGuardianConfig` |オフ |オプションのプロアクティブな OAuth 更新および Codex アカウントのウォームアップ ポリシー。 |
2828

29-
`codexAccountNamespaces` キーはパブリック セレクターです。1 ~ 64 文字で、ASCII 文字または数字で始まり、終わり、文字、数字、`.`、`_`、または `-` が内部に含まれます。予約された JavaScript オブジェクト名は拒否されます。各値は、Codex デスクトップ アカウントの有効なプール アカウント ID (内部 `__main__` ではありません) または `"@main"` です。プロバイダーと予約された `openai` / `combo` の衝突は、大文字と小文字を区別せずにチェックされます。生のアカウント ID と電子メールを非公開にしておきます。セレクターはパブリック名です。
29+
`codexAccountNamespaces` のキーは公開 selector です。長さは 1〜64 文字、先頭と末尾は ASCII
30+
英数字、内部には英数字、`.`、`_`、`-` を使用でき、予約済み JavaScript object 名は拒否されます。
31+
値は有効な pool account id(内部 `__main__` は不可)、または Codex Desktop アカウントを示す
32+
`"@main"` です。provider と予約済み `openai` / `combo` との衝突は大文字小文字を区別せず検査され、
33+
namespace 付き combo alias はその namespace prefix に selector を再利用できません。設定済み pool id
34+
や他の selector target も selector と再利用できません。raw account id と email は
35+
非公開のままにし、selector を公開名として使ってください。明示的な選択の動作と優先順位は
36+
[ルーティング構成](/reference/configuration/routing/)を参照してください。
3037

3138
## 予約済み OpenAI プロバイダー
3239

‎docs-site/src/content/docs/ja/reference/configuration/routing.md‎

Lines changed: 22 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -16,17 +16,32 @@ description: デフォルトのプロバイダーの選択、モデルの解決
1616

1717
opencodex は、要求されたモデルを次の順序で解決します。
1818

19-
1. 正規の `combo/<id>` または構成されたコンボ エイリアス。正規 ID は、エイリアスが一致する前に優先されます。
20-
2. 構成されたプロバイダーを示すプレフィックスを持つ明示的な `<provider>/<model>` 名前空間。
21-
3. `gpt-*`、`o1-*`、`o3-*`、`o4-*` などのベア ネイティブ OpenAI ファミリ ID。
19+
1. 設定済みの `<account-selector>/<native-openai-model>` namespace。対応する保存済み Codex アカウントだけに routing され、無効または利用不能な exact target は fail closed します。
20+
2. 正規の `combo/<id>` または構成されたコンボ エイリアス。正規 ID は、エイリアスが一致する前に優先されます。
21+
3. 構成されたプロバイダーを示すプレフィックスを持つ明示的な `<provider>/<model>` 名前空間。
22+
4. `gpt-*`、`o1-*`、`o3-*`、`o4-*` などのベア ネイティブ OpenAI ファミリ ID。
2223
正規対応の `openai` プロバイダー。
23-
4. プロバイダーの `defaultModel` と完全に一致します。
24-
5. 既知のプロバイダー ファミリ モデル プレフィックス。
25-
6. プロバイダーの構成された `models` リスト内の正確なモデル。
26-
7. `defaultProvider`、要求されたモデル ID を保持します。
24+
5. プロバイダーの `defaultModel` と完全に一致します。
25+
6. 既知のプロバイダー ファミリ モデル プレフィックス。
26+
7. プロバイダーの構成された `models` リスト内の正確なモデル。
27+
8. `defaultProvider`、要求されたモデル ID を保持します。
2728

2829
無効なプロバイダーは除外されます。無効なプロバイダーの明示的な名前空間は、フォールスルーではなく失敗します。プロバイダー エントリは、複数のプロバイダーに一致する可能性のあるルールの JSON 挿入順序でチェックされるため、ベア モデルがあいまいな可能性がある場合は明示的な名前空間を使用します。
2930

31+
## Codex アカウントの明示的な selector
32+
33+
`codexAccountNamespaces` は `side` のような公開 selector を保存済み Codex アカウント 1 つに
34+
対応付けます。`side/gpt-5.6-sol` のような request は、canonical `openai` provider が Direct mode
35+
の場合でもそのアカウントだけを使用し、上流には bare な `gpt-5.6-sol` model id を送信します。
36+
selector の後には bare native OpenAI-family id だけを指定できます。
37+
38+
明示的な選択は Pool assignment strategy と通常の thread affinity を迂回します。対応する account が
39+
存在しない、一時停止中、cooldown 中、利用不能、または再認証が必要な場合、request は別の account
40+
へ切り替えず fail closed し、active Pool account も変更しません。bare native model id は通常の
41+
Pool / Direct routing を維持します。namespace map 自体は model picker row を作成しません。
42+
selector の検証、衝突規則、privacy guidance は
43+
[プロバイダーの構成](/reference/configuration/providers/)を参照してください。
44+
3045
## コンボ (`config.combos`)
3146

3247
各コンボ キーは `[A-Za-z0-9][A-Za-z0-9._-]{0,63}` に一致する ID です。これは常に `combo/<id>` として直接アドレス指定可能であり、1 つの `alias` を公開することもあります。エイリアスは一意である必要があり、`combo/` 名前空間を占有することはできず、`gpt-*`、`o1-*`、`o3-*`、`o4-*`、または `codex-*` などの予約されたベア ネイティブ ファミリを使用することはできません。

‎docs-site/src/content/docs/ko/reference/configuration/providers.md‎

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ description: 공급자 항목, 인증, 엔드포인트, 모델 카탈로그, 할
1616
| `contextCapValue?` | `number` | `350000` | 대시보드의 컨텍스트 상한 컨트롤이 사용하는 값입니다. 이 값을 바꾸면 활성화된 모든 `providerContextCaps` 항목이 함께 갱신됩니다. |
1717
| `codexAccounts?` | `CodexAccount[]` | `[]` | Codex Auth가 관리하는 ChatGPT/Codex 풀 계정 메타데이터입니다. 비밀 정보는 `codex-accounts.json`에 따로 저장됩니다. |
1818
| `pausedCodexAccountIds?` | `string[]` | `[]` | 일시 중지된 `__main__` 계정을 포함해, 재개될 때까지 Pool 선택에서 제외되는 계정입니다. |
19-
| `codexAccountNamespaces?` | `Record<string, string>` | — | 공개 모델 선택기 네임스페이스를 저장된 Codex 계정 대상으로 연결합니다. 이 설정은 매핑을 검증하고 저장하지만, 그 자체로 선택기 행을 추가하거나 라우팅을 바꾸지는 않습니다. |
19+
| `codexAccountNamespaces?` | `Record<string, string>` | — | 공개 model selector namespace에서 저장된 Codex 계정 target으로 연결하는 선택적 map입니다. `<selector>/<native OpenAI model>`은 매핑된 계정으로만 routing되며, 이 설정 자체는 model picker row를 추가하지 않습니다. |
2020
| `activeCodexAccountId?` | `string` | — | 다음 요청에 수동으로 선택한 Pool 계정입니다. 선택하면 thread 결속이 해제되며, 진행 중인 요청은 캡처한 자격 증명을 유지합니다. |
2121
| `autoSwitchThreshold?` | `number` | `80` | 사용량 기반 선제 전환 임계값입니다. `quota`는 바인딩된 작업과 바인딩 없는 작업의 다음 요청을 모두 재평가할 수 있고, `fill-first`는 바인딩 없는 작업 배정의 소진 기준으로만 사용하며, 기본 `round-robin` 선택은 이 값을 사용하지 않습니다. 알려진 5시간, 주간, 30일 quota window 중 가장 높은 점수를 씁니다. `0`은 사용량 기반 전환만 끄며 바인딩 없는 작업 배정이나 실패 복구는 끄지 않습니다. |
2222
| `accountPoolStrategy?` | `"quota" \| "round-robin" \| "fill-first"` | `"quota"` | 새 작업/바인딩 없는 Codex 요청의 계정 배정 전략입니다. `(parent thread id, quota scope)`의 live affinity가 없으면 바인딩 없는 요청이며, 프록시 재시작이나 affinity 초기화 뒤에는 기존에 보이던 작업도 바인딩이 없어질 수 있습니다. `quota`는 활성 계정이 없을 때 알려진 usage가 가장 낮은 적격 계정을 선택하고, 적격 활성 계정이 `autoSwitchThreshold` 미만이면 유지합니다. 임계값 도달 뒤에는 바인딩 없는 요청이나 바인딩된 작업의 다음 요청을 usage가 더 낮은 적격 계정으로 옮길 수 있습니다. `round-robin`은 바인딩 없는 요청을 균등 분배하고, `fill-first`는 cooldown, 사용 불가 또는 drain threshold까지 활성 계정에 배정합니다. |
@@ -26,7 +26,14 @@ description: 공급자 항목, 인증, 엔드포인트, 모델 카탈로그, 할
2626
| `cacheRetention?` | `"none" \| "short" \| "long"` | `"short"` | Anthropic 프롬프트 캐시 정책입니다. 비활성, 5분짜리 임시, 1시간짜리 확장 중 하나입니다. |
2727
| `tokenGuardian?` | `OcxTokenGuardianConfig` | 꺼짐 | 선택적 선제 OAuth 갱신과 Codex 계정 워밍업 정책입니다. |
2828

29-
`codexAccountNamespaces`의 키는 공개 선택기입니다. 1–64자여야 하며, ASCII 문자 또는 숫자로 시작하고 끝나야 합니다. 내부에는 문자, 숫자, `.`, `_`, `-`를 넣을 수 있습니다. 예약된 JavaScript 객체 이름은 허용하지 않습니다. 각 값은 유효한 풀 계정 id여야 하며 내부 `__main__`은 안 됩니다. 또는 Codex Desktop 계정에는 `"@main"`을 쓸 수 있습니다. 공급자 이름과 예약된 `openai` / `combo` 충돌은 대소문자를 구분하지 않고 검사합니다. 원시 계정 id와 이메일은 비공개로 유지하고, 공개 이름은 선택기만 쓰십시오.
29+
`codexAccountNamespaces` 키는 공개 selector입니다. 길이는 1~64자이고 시작과 끝은 ASCII 영숫자여야
30+
하며, 내부에는 영숫자, `.`, `_`, `-`를 사용할 수 있습니다. 예약된 JavaScript object 이름은 거부됩니다.
31+
값은 유효한 pool account id(내부 `__main__` 제외)이거나 Codex Desktop 계정을 나타내는 `"@main"`입니다.
32+
provider 및 예약된 `openai` / `combo` 충돌은 대소문자를 구분하지 않고 검사하며, namespace가 있는
33+
combo alias는 selector를 namespace prefix로 재사용할 수 없습니다. 설정된 pool id와 다른 selector
34+
target도 selector로 재사용할 수 없습니다. raw account id와 email은 비공개로
35+
유지하고 selector를 공개 이름으로 사용하세요. 명시적 선택 동작과 우선순위는
36+
[라우팅 설정](/reference/configuration/routing/)을 참고하십시오.
3037

3138
## 예약된 OpenAI 공급자
3239

‎docs-site/src/content/docs/ko/reference/configuration/routing.md‎

Lines changed: 21 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -16,16 +16,30 @@ description: 기본 provider 선택, model 해석 순서, combo 별칭, 대상
1616

1717
opencodex는 요청된 model을 다음 순서로 해석합니다:
1818

19-
1. 정규화된 `combo/<id>` 또는 설정된 combo 별칭입니다. 정규화된 id가 별칭보다 먼저 적용됩니다.
20-
2. 접두사가 설정된 provider를 가리키는 명시적 `<provider>/<model>` 네임스페이스입니다.
21-
3. `gpt-*`, `o1-*`, `o3-*`, `o4-*` 같은 bare native OpenAI 계열 id입니다. 이 경우 정규화된 활성 `openai` provider를 통해 라우팅합니다.
22-
4. provider의 `defaultModel`과 정확히 일치합니다.
23-
5. 알려진 provider-family model prefix입니다.
24-
6. provider의 설정된 `models` 목록 안의 정확한 model입니다.
25-
7. `defaultProvider`이며, 요청한 model id를 그대로 유지합니다.
19+
1. 설정된 `<account-selector>/<native-openai-model>` 네임스페이스입니다. 매핑된 저장 Codex 계정으로만 routing하며, exact target이 잘못되었거나 사용할 수 없으면 fail closed합니다.
20+
2. 정규화된 `combo/<id>` 또는 설정된 combo 별칭입니다. 정규화된 id가 별칭보다 먼저 적용됩니다.
21+
3. 접두사가 설정된 provider를 가리키는 명시적 `<provider>/<model>` 네임스페이스입니다.
22+
4. `gpt-*`, `o1-*`, `o3-*`, `o4-*` 같은 bare native OpenAI 계열 id입니다. 이 경우 정규화된 활성 `openai` provider를 통해 라우팅합니다.
23+
5. provider의 `defaultModel`과 정확히 일치합니다.
24+
6. 알려진 provider-family model prefix입니다.
25+
7. provider의 설정된 `models` 목록 안의 정확한 model입니다.
26+
8. `defaultProvider`이며, 요청한 model id를 그대로 유지합니다.
2627

2728
비활성화된 provider는 제외합니다. 비활성화된 provider의 명시적 네임스페이스는 다음 규칙으로 넘어가지 않고 실패합니다. 여러 provider에 걸쳐 일치할 수 있는 규칙은 JSON에 적힌 삽입 순서대로 provider 항목을 검사하므로, bare model이 애매할 수 있으면 명시적 네임스페이스를 사용하십시오.
2829

30+
## 명시적 Codex 계정 selector
31+
32+
`codexAccountNamespaces`는 `side` 같은 공개 selector를 저장된 Codex 계정 하나에 매핑합니다.
33+
`side/gpt-5.6-sol` 요청은 canonical `openai` provider가 Direct mode여도 그 계정만 사용하고,
34+
upstream에는 bare `gpt-5.6-sol` model id를 보냅니다. selector 뒤에는 bare native OpenAI-family
35+
id만 사용할 수 있습니다.
36+
37+
명시적 선택은 Pool assignment strategy와 일반 thread affinity를 우회합니다. 매핑된 account가 없거나,
38+
일시 중지되었거나, cooldown 중이거나, 사용할 수 없거나, 재인증이 필요하면 다른 account로 전환하지
39+
않고 fail closed하며 active Pool account도 변경하지 않습니다. bare native model id는 기존 Pool /
40+
Direct routing을 유지합니다. namespace map 자체는 model picker row를 만들지 않습니다. selector 검증,
41+
충돌 규칙, privacy guidance는 [공급자 설정](/reference/configuration/providers/)을 참고하십시오.
42+
2943
## Combos (`config.combos`)
3044

3145
각 combo 키는 `[A-Za-z0-9][A-Za-z0-9._-]{0,63}`에 맞는 id입니다. 항상 `combo/<id>`로 직접 접근할 수 있고, 추가로 하나의 `alias`를 노출할 수 있습니다. alias는 유일해야 하고 `combo/` 네임스페이스를 차지할 수 없으며, `gpt-*`, `o1-*`, `o3-*`, `o4-*`, `codex-*` 같은 예약된 bare native family도 사용할 수 없습니다.

0 commit comments

Comments
 (0)