feat(shadow-call): per-source modelMap with custom source registration

docs-site/src/content/docs/fr/reference/configuration/server.md

@@ -25,7 +25,7 @@ exécute des fonctionnalités d'assistance autour des demandes du fournisseur.
 | `codexAutoStart?` | `boolean` | `true` | Autorise le lanceur intermédiaire Codex à exécuter `ocx ensure` avant de démarrer Codex. Avec la valeur false, cette vérification ne fait rien. |
 | `codexShimAutoRestore?` | `boolean` | `true` | Restaure le lanceur intermédiaire installé après son remplacement par une mise à jour externe de Codex terminée. Désactivation par variable d'environnement : `OPENCODEX_CODEX_SHIM_AUTO_RESTORE=0`. |
 | `syncResumeHistory?` | `boolean` | `true` | Compatibilité historique Codex App réversible. Les métadonnées originales sont sauvegardées et restaurées par `ocx stop` / `ocx restore`. |
-| `shadowCallIntercept?` | `{ enabled?: boolean; model?: string; sourceModels?: string[] }` | désactivé | Redirigez les appels Codex helper/shadow reconnus vers un modèle choisi tout en conservant l'effort de raisonnement configuré pour la requête. Le préfixe source par défaut est `gpt-5.6-luna` ; les clients plus anciens via 0.144.x utilisaient `gpt-5.4-mini`, que `sourceModels` peut restaurer. |
+| `shadowCallIntercept?` | `{ enabled?: boolean; model?: string; modelMap?: Record<string, string>; sourceModels?: string[] }` | désactivé | Redirigez les appels Codex helper/shadow reconnus vers un modèle choisi tout en conservant l'effort de raisonnement configuré pour la requête. Le préfixe source par défaut est `gpt-5.6-luna` ; les clients plus anciens via 0.144.x utilisaient `gpt-5.4-mini`, que `sourceModels` peut restaurer. |
 | `webSearchSidecar?` | `OcxWebSearchSidecarConfig` | activé lorsqu'il est utilisable | Options du service auxiliaire de recherche Web. |
 | `visionSidecar?` | `OcxVisionSidecarConfig` | activé lorsqu'il est utilisable | Options du service auxiliaire de description d'images. |
 | `images?` | `OcxImagesConfig` | sélection automatique OpenAI | Options de relais d'images autonomes pour Codex `image_gen`. |

docs-site/src/content/docs/ja/reference/configuration/server.md

@@ -24,7 +24,7 @@ description: リスナー、リモート アクセス、アドミッション 
 | `codexAutoStart?` | `boolean` | `true` | Codex を起動する前に、Codex シムで `ocx ensure` を実行させます。 False を指定すると、操作が行われないことが保証されます。 |
 | `codexShimAutoRestore?` | `boolean` | `true` |完了した外部 Codex アップデートによってインストールされたシムが置き換えられた後、インストールされているシムを復元します。環境オプトアウト: `OPENCODEX_CODEX_SHIM_AUTO_RESTORE=0`。 |
 | `syncResumeHistory?` | `boolean` | `true` | Codex App 履歴の互換性を元に戻すことができます。元のメタデータは `ocx stop` / `ocx restore` によってバックアップおよび復元されます。 |
-| `shadowCallIntercept?` | `{ enabled?: boolean; model?: string; sourceModels?: string[] }` |オフ |認識された Codex ヘルパー/シャドウ呼び出しを、リクエストに設定された推論エフォートを維持したまま選択したモデルにリダイレクトします。デフォルトのソースプレフィックスは `gpt-5.6-luna` です。0.144.x 以前のクライアントでは `gpt-5.4-mini` が使われており、`sourceModels` で復元できます。 |
+| `shadowCallIntercept?` | `{ enabled?: boolean; model?: string; modelMap?: Record<string, string>; sourceModels?: string[] }` |オフ |認識された Codex ヘルパー/シャドウ呼び出しを、リクエストに設定された推論エフォートを維持したまま選択したモデルにリダイレクトします。デフォルトのソースプレフィックスは `gpt-5.6-luna` です。0.144.x 以前のクライアントでは `gpt-5.4-mini` が使われており、`sourceModels` で復元できます。 |
 | `webSearchSidecar?` | `OcxWebSearchSidecarConfig` |使用可能な場合はオン | Web 検索サイドカー オプション。 |
 | `visionSidecar?` | `OcxVisionSidecarConfig` |使用可能な場合はオン |画像説明サイドカー オプション。 |
 | `images?` | `OcxImagesConfig` | OpenAI の自動選択 | Codex `image_gen` のスタンドアロン イメージ リレー オプション。 |

docs-site/src/content/docs/ko/reference/configuration/server.md

@@ -24,7 +24,7 @@ description: 리스너, 원격 접근, admission 키, 타임아웃, 저장소, 
 | `codexAutoStart?` | `boolean` | `true` | Codex shim이 Codex를 실행하기 전에 `ocx ensure`를 돌리도록 허용합니다. `false`이면 ensure는 아무 작업도 하지 않습니다. |
 | `codexShimAutoRestore?` | `boolean` | `true` | 완료된 외부 Codex 업데이트가 설치된 shim을 교체한 뒤 복원합니다. 환경 변수로 끌 수 있습니다: `OPENCODEX_CODEX_SHIM_AUTO_RESTORE=0`. |
 | `syncResumeHistory?` | `boolean` | `true` | 되돌릴 수 있는 Codex App history 호환성입니다. 원래 메타데이터는 `ocx stop` / `ocx restore`가 백업하고 복원합니다. |
-| `shadowCallIntercept?` | `{ enabled?: boolean; model?: string; sourceModels?: string[] }` | off | 인식된 Codex 보조/섀도 호출을 요청에 설정된 reasoning effort를 유지한 채 선택한 모델로 다시 보냅니다. 기본 source prefix는 `gpt-5.6-luna`입니다. 0.144.x 이하의 이전 클라이언트는 `gpt-5.4-mini`를 사용했으며 `sourceModels`로 복원할 수 있습니다. |
+| `shadowCallIntercept?` | `{ enabled?: boolean; model?: string; modelMap?: Record<string, string>; sourceModels?: string[] }` | off | 인식된 Codex 보조/섀도 호출을 요청에 설정된 reasoning effort를 유지한 채 선택한 모델로 다시 보냅니다. 기본 source prefix는 `gpt-5.6-luna`입니다. 0.144.x 이하의 이전 클라이언트는 `gpt-5.4-mini`를 사용했으며 `sourceModels`로 복원할 수 있습니다. |
 | `webSearchSidecar?` | `OcxWebSearchSidecarConfig` | on when usable | 웹 검색 사이드카 옵션입니다. |
 | `visionSidecar?` | `OcxVisionSidecarConfig` | on when usable | 이미지 설명 사이드카 옵션입니다. |
 | `images?` | `OcxImagesConfig` | automatic OpenAI selection | Codex `image_gen`용 독립형 Images 릴레이 옵션입니다. |

docs-site/src/content/docs/reference/configuration/server.md

@@ -29,7 +29,7 @@ runs helper features around provider requests.
 | `codexDesktopAuthless?` | `boolean` | `false` | Opt-in authless Codex Desktop routing on a loopback bind: inject the dedicated `opencodex` provider with `requires_openai_auth = false` so Desktop opens without a ChatGPT login. Ignored on non-loopback binds. `ocx system settings --desktop-authless on`. See [Codex integration](/guides/codex-integration/#authless-codex-desktop-opt-in). |
 | `resetCreditAutoRedeem?` | `{ enabled?: boolean; leadTimeMinutes?: number }` | off | Opt-in: redeem the main Codex account's soonest-expiring reset credit `leadTimeMinutes` (1–60, default 10) before it expires. Every attempt re-reads the upstream credit list first and skips when the credit is gone (for example, redeemed by hand); the `redeem_request_id` is journaled in `$OPENCODEX_HOME/reset-credit-auto-redeem.json` before the call so a crash replays the same idempotent request instead of spending a second credit. Logs carry a hashed account key only. |
 | `syncResumeHistory?` | `boolean` | `true` | Reversible Codex App history compatibility. Original metadata is backed up and restored by `ocx stop` / `ocx restore`. |
-| `shadowCallIntercept?` | `{ enabled?: boolean; model?: string; sourceModels?: string[] }` | off | Redirect recognized Codex helper/shadow calls to a chosen model while preserving the request's configured reasoning effort. The default source prefix is `gpt-5.6-luna`; older clients through 0.144.x used `gpt-5.4-mini`, which `sourceModels` can restore. |
+| `shadowCallIntercept?` | `{ enabled?: boolean; model?: string; modelMap?: Record<string, string>; sourceModels?: string[] }` | off | Redirect recognized Codex helper/shadow calls to chosen models while preserving the request's configured reasoning effort. `modelMap` maps each source prefix to its own replacement; `model` is the shared fallback for sources absent from the map, and a source absent from both is left native. The default source prefixes are `gpt-5.4-mini` and `gpt-5.6-luna`; `sourceModels` can override the set. |
 | `webSearchSidecar?` | `OcxWebSearchSidecarConfig` | on when usable | Web-search sidecar options. |
 | `visionSidecar?` | `OcxVisionSidecarConfig` | on when usable | Image-description sidecar options. |
 | `images?` | `OcxImagesConfig` | automatic OpenAI selection | Standalone Images relay options for Codex `image_gen`. |
@@ -204,11 +204,20 @@ a matching request.
   "shadowCallIntercept": {
     "enabled": true,
     "model": "gpt-5.5",
-    "sourceModels": ["gpt-5.6-luna"]
+    "modelMap": {
+      "gpt-5.6-luna": "deepseek-chat",
+      "gpt-5.4-mini": "glm-4.5-air"
+    },
+    "sourceModels": ["gpt-5.4-mini", "gpt-5.6-luna"]
   }
 }
 ```
 
+`modelMap` gives each source model its own replacement (for example luna and 5.4-mini to two
+different third-party models). `model` then only applies to sources with no `modelMap` entry: keep it
+when you want a shared fallback (for example for helper ids newly introduced by a client update),
+and leave it unset when the map covers every source you intercept.
+
 ## Sidecars
 
 ### `images` (`OcxImagesConfig`)

gui/src/i18n/de.ts

@@ -298,6 +298,9 @@ export const de: Record<TKey, string> = {
   "dash.shadowCallTooltip": "Die Codex-App ruft im Hintergrund ein Hilfsmodell für Titelgenerierung, Commit-Nachrichten und Skill-Orchestrierung auf. Das Modell wechselt zwischen Client-Versionen, daher fängt opencodex diesen Satz ab: {models}.",
   "models.shadowCallIntercept": "Shadow-Call-Abfangen",
   "models.shadowCallInterceptHint": "Fängt die Hintergrund-Hilfsaufrufe der Codex-App ({models}) ab und leitet sie an das gewählte Modell um.",
+  "models.shadowCallCustom": "Eigenes Quellmodell",
+  "models.shadowCallCustomPlaceholder": "Eigene Quellmodell-id",
+  "models.shadowCallAdd": "Hinzufügen",
   "dash.sidecarBackend": "Backend",
   "dash.sidecarModel": "Modell",
   "dash.backendAuto": "Automatisch",

gui/src/i18n/en.ts

@@ -316,6 +316,9 @@ export const en = {
   "dash.shadowCallTooltip": "Codex App makes background helper calls for thread title generation, commit message generation, and skill orchestration. The helper model changed across client versions, so opencodex intercepts every model in this set: {models}. Enable this to redirect those calls to your chosen model.",
   "models.shadowCallIntercept": "Shadow Call Intercept",
   "models.shadowCallInterceptHint": "Intercepts Codex App's background helper calls ({models}) for titles and commit messages and redirects them to your chosen model.",
+  "models.shadowCallCustom": "Custom source model",
+  "models.shadowCallCustomPlaceholder": "Custom source model id",
+  "models.shadowCallAdd": "Add",
   "dash.sidecarBackend": "Backend",
   "dash.sidecarModel": "Model",
   "dash.backendAuto": "Auto",

gui/src/i18n/fr.ts

@@ -306,6 +306,9 @@ export const fr: Record<TKey, string> = {
   "dash.shadowCallTooltip": "L’application Codex effectue des appels auxiliaires en arrière-plan pour générer les titres de fils, les messages de commit et orchestrer les compétences. Le modèle auxiliaire ayant changé selon les versions du client, opencodex intercepte tous les modèles de cet ensemble : {models}. Activez cette option pour rediriger ces appels vers le modèle choisi.",
   "models.shadowCallIntercept": "Interception des appels fantômes",
   "models.shadowCallInterceptHint": "Intercepte les appels auxiliaires en arrière-plan de l’application Codex ({models}) pour les titres et les messages de commit, puis les redirige vers le modèle choisi.",
+  "models.shadowCallCustom": "Modèle source personnalisé",
+  "models.shadowCallCustomPlaceholder": "id du modèle source personnalisé",
+  "models.shadowCallAdd": "Ajouter",
   "dash.sidecarBackend": "Moteur",
   "dash.sidecarModel": "Modèle",
   "dash.backendAuto": "Auto",

gui/src/i18n/ja.ts

@@ -307,6 +307,9 @@ export const ja: Record<TKey, string> = {
   "dash.shadowCallTooltip": "Codex App はスレッドタイトル生成、コミットメッセージ生成、スキルオーケストレーションをバックグラウンドで呼び出します。使われるモデルはクライアントのバージョンによって変わるため、opencodex は {models} をまとめて傍受します。これをオンにすると、それらの呼び出しを選択したモデルにリダイレクトします。",
   "models.shadowCallIntercept": "シャドウコール傍受",
   "models.shadowCallInterceptHint": "Codex App のバックグラウンドヘルパー呼び出し({models}: タイトル、コミットメッセージ)を傍受し、選択したモデルにリダイレクトします。",
+  "models.shadowCallCustom": "カスタムソースモデル",
+  "models.shadowCallCustomPlaceholder": "カスタムソースモデル id",
+  "models.shadowCallAdd": "追加",
   "dash.sidecarBackend": "バックエンド",
   "dash.sidecarModel": "モデル",
   "dash.backendAuto": "自動",

gui/src/i18n/ko.ts

@@ -302,6 +302,9 @@ export const ko: Record<TKey, string> = {
   "dash.shadowCallTooltip": "Codex 앱은 스레드 제목 자동 생성, 커밋 메시지 생성, 스킬 오케스트레이션 같은 내부 작업을 백그라운드로 호출합니다. 이때 쓰는 모델은 클라이언트 버전마다 달라서 opencodex는 {models}를 모두 가로챕니다. 이 설정을 켜면 해당 호출이 선택한 모델로 넘어갑니다.",
   "models.shadowCallIntercept": "쉐도우 호출 가로채기",
   "models.shadowCallInterceptHint": "Codex 앱의 백그라운드 호출({models}, 제목·커밋 메시지)을 가로채 선택한 모델로 바꿉니다.",
+  "models.shadowCallCustom": "사용자 지정 소스 모델",
+  "models.shadowCallCustomPlaceholder": "사용자 지정 소스 모델 id",
+  "models.shadowCallAdd": "추가",
   "dash.sidecarBackend": "백엔드",
   "dash.sidecarModel": "모델",
   "dash.backendAuto": "자동",

gui/src/i18n/ru.ts

@@ -307,6 +307,9 @@ export const ru: Record<TKey, string> = {
   "dash.shadowCallTooltip": "Codex App в фоновом режиме вызывает служебную модель для генерации заголовков тредов, сообщений коммитов и оркестрации навыков. Эта модель менялась между версиями клиента, поэтому opencodex перехватывает весь набор: {models}. Включите функцию, чтобы перенаправлять такие вызовы на выбранную вами модель.",
   "models.shadowCallIntercept": "Перехват теневых вызовов",
   "models.shadowCallInterceptHint": "Перехватывает фоновые служебные вызовы Codex App ({models}: заголовки, сообщения коммитов) и перенаправляет их на выбранную вами модель.",
+  "models.shadowCallCustom": "Свой исходный модель",
+  "models.shadowCallCustomPlaceholder": "id своего исходного модели",
+  "models.shadowCallAdd": "Добавить",
   "dash.sidecarBackend": "Бэкенд",
   "dash.sidecarModel": "Модель",
   "dash.backendAuto": "Авто",

gui/src/i18n/tr.ts

@@ -308,6 +308,9 @@ export const tr: Record<TKey, string> = {
   "dash.shadowCallTooltip": "Codex App arka planda başlık ve commit mesajı oluşturmak için yardımcı çağrılar yapar (orijinal {models}). Etkinleştirerek bunları seçtiğiniz modele yönlendirebilirsiniz.",
   "models.shadowCallIntercept": "Gölge Çağrı Yakalama",
   "models.shadowCallInterceptHint": "Codex App'in başlıklar ve commit mesajları için yaptığı arka plan çağrılarını ({models}) yakalar ve seçtiğiniz modele yönlendirir.",
+  "models.shadowCallCustom": "Özel kaynak modeli",
+  "models.shadowCallCustomPlaceholder": "Özel kaynak model kimliği",
+  "models.shadowCallAdd": "Ekle",
   "dash.sidecarBackend": "Arka uç",
   "dash.sidecarModel": "Model",
   "dash.backendAuto": "Otomatik",

gui/src/i18n/zh-TW.ts

@@ -201,6 +201,9 @@ export const zhTW: Record<TKey, string> = {
   "dash.shadowCallTooltip": "Codex 應用會為執行緒標題生成、提交訊息生成與技能編排發出背景 helper 呼叫。helper 模型因客戶端版本而異，因此 opencodex 攔截此集合中的每個模型：{models}。啟用此選項可將這些呼叫重定向到您選擇的模型。",
   "models.shadowCallIntercept": "影子呼叫攔截",
   "models.shadowCallInterceptHint": "攔截 Codex 應用的背景 helper 呼叫（{models}）以生成標題與提交訊息，並將它們重定向到您選擇的模型。",
+  "models.shadowCallCustom": "自訂來源模型映射",
+  "models.shadowCallCustomPlaceholder": "自訂來源模型 id",
+  "models.shadowCallAdd": "新增",
   "dash.sidecarBackend": "後端",
   "dash.sidecarModel": "模型",
   "dash.backendAuto": "自動",

gui/src/i18n/zh.ts

@@ -302,6 +302,9 @@ export const zh: Record<TKey, string> = {
   "dash.shadowCallTooltip": "Codex 应用会在后台调用辅助模型来生成线程标题、提交消息以及进行技能编排。该模型随客户端版本变化，因此 opencodex 会同时拦截这些模型：{models}。启用此选项可将这些调用重定向到您选择的模型。",
   "models.shadowCallIntercept": "影子调用拦截",
   "models.shadowCallInterceptHint": "拦截 Codex 应用的后台辅助调用（{models}）并重定向到所选模型。",
+  "models.shadowCallCustom": "自定义源模型映射",
+  "models.shadowCallCustomPlaceholder": "自定义源模型 id",
+  "models.shadowCallAdd": "添加",
   "dash.sidecarBackend": "后端",
   "dash.sidecarModel": "模型",
   "dash.backendAuto": "自动",