Skip to content

Commit dbd9fe0

Browse files
committed
fix: surface restart-unsafe Codex routing
1 parent 54e0bbf commit dbd9fe0

26 files changed

Lines changed: 916 additions & 25 deletions

‎docs-site/src/content/docs/guides/web-dashboard.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,8 @@ bun run dev:gui
2929
| **Sub-agent delegation** | Choose a native or routed guidance model and an optional reasoning effort for v1 delegation prompts. This is not a per-spawn router; see below. |
3030
| **Sidecars** | Choose the web-search model and effort plus the vision-description model. Changes apply on the next request. |
3131
| **Maintenance** | Resync the Codex model catalog, inspect project-local config bypass warnings, check the latest or preview release, and run an update with optional proxy restart. |
32-
| **Codex autostart** | Enable or disable the Codex launcher shim that runs `ocx ensure` before Codex CLI/App starts. |
32+
| **Startup safety** | Show whether injected Codex routing survives a restart, with separate service and launcher-shim health plus exact repair commands. |
33+
| **Codex autostart** | Allow an already-installed Codex launcher shim to run `ocx ensure`. This toggle does not install a shim or background service. |
3334
| **Providers** | Add, edit, enable/disable, and remove providers; manage OAuth account pools and API-key pools where supported. |
3435
| **Add provider** | Search registry-backed presets for account login, API-key services, local servers, or a custom endpoint. |
3536
| **Codex Auth** | Add ChatGPT/Codex pool accounts, select the next-session account, refresh 5h / weekly / 30d quotas, and configure quota auto-switch and transient-failure failover. |
@@ -83,6 +84,7 @@ The GUI is a thin client over the proxy's JSON management API. Useful endpoints
8384
| Endpoint | Purpose |
8485
| --- | --- |
8586
| `GET` / `PUT /api/settings` | Read settings or toggle Codex autostart. |
87+
| `GET /api/startup-health` | Read secret-free routing, service, shim, and restart-safety diagnostics. |
8688
| `POST /api/sync` | Rebuild the shared model catalog and stale the Codex model cache. |
8789
| `GET /api/update/check` · `POST /api/update/run` · `GET /api/update/status` | Check, run, and monitor self-update jobs. |
8890
| `GET` / `PUT /api/sidecar-settings` | Read or set search/vision sidecar model settings. |

‎docs-site/src/content/docs/ja/guides/web-dashboard.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,8 @@ bun run dev:gui
2929
| **サブエージェント委任** | v1 委任プロンプトに入れるネイティブまたはルーティングモデルとオプションの推論強度を選びます。スポーンごとのルーターではありません。下記の説明を確認してください。 |
3030
| **サイドカー** | ウェブ検索モデルと強度、画像説明モデルを選択します。次回リクエストから適用されます。 |
3131
| **メンテナンス** | Codex モデルカタログを再同期し、プロジェクトローカル設定のバイパス警告を確認し、latest/preview 更新を照会またはオプションのプロキシ再起動と共にインストールします。 |
32-
| **Codex 自動起動** | Codex CLI/App 実行前に `ocx ensure` を呼ぶランチャーシムをオン/オフします。 |
32+
| **起動安全性** | 注入された Codex ルーティングが再起動後も機能するか、サービスと launcher shim の状態、正確な修復コマンドと共に表示します。 |
33+
| **Codex 自動起動** | インストール済み Codex launcher shim に `ocx ensure` の実行を許可します。このトグルは shim やバックグラウンドサービスをインストールしません。 |
3334
| **プロバイダー** | プロバイダーを追加、編集、有効化/無効化、削除し、対応する OAuth アカウントプールと API キープールを管理します。 |
3435
| **プロバイダー追加** | レジストリベースのプリセットからアカウントログイン、API キーサービス、ローカルサーバー、custom エンドポイントを検索します。 |
3536
| **Codex 認証** | ChatGPT/Codex プールアカウントを追加し、次回セッションアカウントを選び、5 時間 / 週間 / 30 日クォータを更新し、クォータ自動切り替えと一時的失敗フェイルオーバーを設定します。 |
@@ -81,6 +82,7 @@ GUI はプロキシの JSON 管理 API を使うシンクライアントです
8182
| エンドポイント | 用途 |
8283
--- | --- |
8384
| `GET` / `PUT /api/settings` | 設定を読むか Codex 自動起動をオン/オフします。 |
85+
| `GET /api/startup-health` | 秘密情報を含まないルーティング、サービス、shim、再起動安全性診断を読み取ります。 |
8486
| `POST /api/sync` | 共有モデルカタログを再構築し Codex モデルキャッシュを古い状態としてマークします。 |
8587
| `GET /api/update/check` · `POST /api/update/run` · `GET /api/update/status` | 自己更新作業を確認、実行、追跡します。 |
8688
| `GET` / `PUT /api/sidecar-settings` | 検索/ビジョンサイドカーモデル設定を読むか変えます。 |

‎docs-site/src/content/docs/ko/guides/web-dashboard.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,8 @@ bun run dev:gui
2929
| **Sub-agent delegation** | v1 위임 프롬프트에 넣을 네이티브 또는 라우팅 모델과 선택적 reasoning 강도를 고릅니다. 스폰별 라우터는 아닙니다. 아래 설명을 확인하세요. |
3030
| **사이드카** | 웹 검색 모델과 강도, 이미지 설명 모델을 선택합니다. 다음 요청부터 적용됩니다. |
3131
| **Maintenance** | Codex 모델 카탈로그를 다시 동기화하고, 프로젝트 로컬 설정의 우회 경고를 확인하고, latest/preview 업데이트를 조회하거나 선택적 프록시 재시작과 함께 설치합니다. |
32-
| **Codex 자동 시작** | Codex CLI/App 실행 전에 `ocx ensure`를 호출하는 launcher shim을 켜거나 끕니다. |
32+
| **시작 안전성** | 주입된 Codex 라우팅이 재부팅 후에도 유지되는지 서비스와 launcher shim 상태, 정확한 복구 명령과 함께 표시합니다. |
33+
| **Codex 자동 시작** | 이미 설치된 Codex launcher shim이 `ocx ensure`를 실행하도록 허용합니다. 이 토글은 shim이나 백그라운드 서비스를 설치하지 않습니다. |
3334
| **Providers** | 프로바이더를 추가, 편집, 활성화/비활성화, 제거하고, 지원되는 OAuth 계정 풀과 API key 풀을 관리합니다. |
3435
| **Add provider** | 레지스트리 기반 프리셋에서 계정 로그인, API key 서비스, 로컬 서버, custom endpoint를 검색합니다. |
3536
| **Codex Auth** | ChatGPT/Codex 풀 계정을 추가하고, 다음 세션 계정을 선택하고, 5시간 / 주간 / 30일 할당량을 갱신하며, 할당량 자동 전환과 일시적 실패 failover를 설정합니다. |
@@ -81,6 +82,7 @@ GUI는 프록시의 JSON 관리 API를 사용하는 얇은 클라이언트입니
8182
| 엔드포인트 | 용도 |
8283
| --- | --- |
8384
| `GET` / `PUT /api/settings` | 설정을 읽거나 Codex 자동 시작을 켜고 끕니다. |
85+
| `GET /api/startup-health` | 비밀값 없이 라우팅, 서비스, shim, 재부팅 안전성 진단을 읽습니다. |
8486
| `POST /api/sync` | 공유 모델 카탈로그를 다시 만들고 Codex 모델 캐시를 오래된 상태로 표시합니다. |
8587
| `GET /api/update/check` · `POST /api/update/run` · `GET /api/update/status` | 자체 업데이트 작업을 확인, 실행, 추적합니다. |
8688
| `GET` / `PUT /api/sidecar-settings` | 검색/비전 사이드카 모델 설정을 읽거나 바꿉니다. |

‎docs-site/src/content/docs/ru/guides/web-dashboard.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,8 @@ bun run dev:gui
2929
| **Sub-agent delegation** | Выбор нативной или маршрутизируемой модели для инструкции и необязательного уровня рассуждений для v1-промптов делегирования. Это не маршрутизатор для каждого порождения; см. ниже. |
3030
| **Сайдкары** | Выбор модели и уровня рассуждений для веб-поиска, а также модели описания изображений. Изменения применяются со следующего запроса. |
3131
| **Maintenance** | Пересинхронизация каталога моделей Codex, просмотр предупреждений об обходе через проектную локальную конфигурацию, проверка последнего или предварительного выпуска и запуск обновления с необязательным перезапуском прокси. |
32-
| **Автозапуск Codex** | Включение и отключение launcher-шима Codex, который выполняет `ocx ensure` перед запуском Codex CLI/App. |
32+
| **Безопасность запуска** | Показывает, сохранит ли внедрённая маршрутизация Codex работоспособность после перезагрузки, отдельно отображая службу, launcher shim и точные команды исправления. |
33+
| **Автозапуск Codex** | Разрешает уже установленному launcher shim Codex выполнять `ocx ensure`. Переключатель не устанавливает shim или фоновую службу. |
3334
| **Providers** | Добавление, редактирование, включение/отключение и удаление провайдеров; управление пулами OAuth-аккаунтов и пулами API-ключей там, где они поддерживаются. |
3435
| **Add provider** | Поиск по пресетам из реестра: вход по аккаунту, сервисы с API-ключом, локальные серверы или пользовательская конечная точка. |
3536
| **Codex Auth** | Добавление аккаунтов пула ChatGPT/Codex, выбор аккаунта для следующей сессии, обновление квот 5 ч / недельных / 30-дневных, настройка автопереключения по квоте и failover при временных сбоях. |
@@ -86,6 +87,7 @@ GUI — это тонкий клиент поверх JSON-API управлен
8687
| Эндпоинт | Назначение |
8788
| --- | --- |
8889
| `GET` / `PUT /api/settings` | Чтение настроек или переключение автозапуска Codex. |
90+
| `GET /api/startup-health` | Чтение безопасной диагностики маршрутизации, службы, shim и устойчивости к перезагрузке. |
8991
| `POST /api/sync` | Пересборка общего каталога моделей и инвалидация кэша моделей Codex. |
9092
| `GET /api/update/check` · `POST /api/update/run` · `GET /api/update/status` | Проверка, запуск и мониторинг задач самообновления. |
9193
| `GET` / `PUT /api/sidecar-settings` | Чтение или настройка моделей сайдкаров поиска/vision. |

‎docs-site/src/content/docs/zh-cn/guides/web-dashboard.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,8 @@ bun run dev:gui
2828
| **Sub-agent delegation** | 为 v1 委派 prompt 选择原生或路由模型,并可指定 reasoning 强度。它不是逐次生成的路由器,详见下文。 |
2929
| **Sidecar** | 选择 web-search 模型及强度,以及图像描述模型;更改从下一次请求开始生效。 |
3030
| **Maintenance** | 重新同步 Codex 模型目录,查看项目级配置绕过警告,检查 latest/preview 版本,并可在更新后重启代理。 |
31-
| **Codex 自动启动** | 启用或禁用 Codex launcher shim;该 shim 会在 Codex CLI/App 启动前运行 `ocx ensure`。 |
31+
| **启动安全** | 显示注入的 Codex 路由能否在重启后继续工作,并分别显示服务、launcher shim 状态和准确的修复命令。 |
32+
| **Codex 自动启动** | 允许已安装的 Codex launcher shim 运行 `ocx ensure`。此开关不会安装 shim 或后台服务。 |
3233
| **Providers** | 添加、编辑、启用/禁用、删除 provider,并在支持时管理 OAuth 账号池和 API key 池。 |
3334
| **Add provider** | 搜索 registry preset,选择账号登录、API key 服务、本地服务器或自定义 endpoint。 |
3435
| **Codex Auth** | 添加 ChatGPT/Codex 池账号,选择下一 session 的账号,刷新 5h / 每周 / 30d 配额,并设置配额自动切换和临时故障 failover。 |
@@ -78,6 +79,7 @@ GUI 是代理 JSON 管理 API 之上的轻量客户端。常用 endpoint 包括
7879
| Endpoint | 用途 |
7980
| --- | --- |
8081
| `GET` / `PUT /api/settings` | 读取设置或切换 Codex 自动启动。 |
82+
| `GET /api/startup-health` | 读取不含秘密信息的路由、服务、shim 和重启安全诊断。 |
8183
| `POST /api/sync` | 重建共享模型目录,并把 Codex 模型缓存标记为过期。 |
8284
| `GET /api/update/check` · `POST /api/update/run` · `GET /api/update/status` | 检查、运行和监控自更新任务。 |
8385
| `GET` / `PUT /api/sidecar-settings` | 读取或设置 search/vision sidecar 模型。 |

‎gui/src/App.tsx‎

Lines changed: 25 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,17 +10,18 @@ import Storage from "./pages/Storage";
1010
import CodexAuth from "./pages/CodexAuth";
1111
import ApiKeys from "./pages/ApiKeys";
1212
import ClaudeCode from "./pages/ClaudeCode";
13+
import Startup from "./pages/Startup";
1314
import { IconGrid, IconServer, IconBoxes, IconBot, IconList, IconActivity, IconHardDrive, IconKey, IconGithub, IconMenu, IconSun, IconMoon, IconMonitor, IconGlobe, IconPower, IconSparkle, IconX } from "./icons";
1415
import { useI18n, useT, LOCALES, type Locale, type TKey } from "./i18n";
1516
import { Select } from "./ui";
1617
import { installApiAuthFetch } from "./api";
1718

1819
installApiAuthFetch();
1920

20-
type Page = "dashboard" | "providers" | "models" | "combos" | "subagents" | "logs" | "usage" | "storage" | "codex-auth" | "api" | "claude";
21+
type Page = "dashboard" | "startup" | "providers" | "models" | "combos" | "subagents" | "logs" | "usage" | "storage" | "codex-auth" | "api" | "claude";
2122
type Theme = "light" | "dark" | "system";
2223

23-
const VALID_PAGES = new Set<Page>(["dashboard", "providers", "models", "combos", "subagents", "logs", "usage", "storage", "codex-auth", "api", "claude"]);
24+
const VALID_PAGES = new Set<Page>(["dashboard", "startup", "providers", "models", "combos", "subagents", "logs", "usage", "storage", "codex-auth", "api", "claude"]);
2425

2526
function readPageFromHash(): Page {
2627
const raw = location.hash.replace(/^#\/?/, "");
@@ -63,6 +64,7 @@ function providersHashForPage(): string {
6364

6465
const NAV: { id: Page; tkey: TKey; Icon: typeof IconGrid }[] = [
6566
{ id: "dashboard", tkey: "nav.dashboard", Icon: IconGrid },
67+
{ id: "startup", tkey: "nav.startup", Icon: IconPower },
6668
{ id: "providers", tkey: "nav.providers", Icon: IconServer },
6769
{ id: "models", tkey: "nav.models", Icon: IconBoxes },
6870
{ id: "subagents", tkey: "nav.subagents", Icon: IconBot },
@@ -92,6 +94,7 @@ export default function App() {
9294
const [page, setPageState] = useState<Page>(readPageFromHash);
9395
const [theme, setTheme] = useState<Theme>(readStoredTheme);
9496
const [runtimeVersion, setRuntimeVersion] = useState<string | null>(null);
97+
const [startupAtRisk, setStartupAtRisk] = useState(false);
9598
const { locale, setLocale } = useI18n();
9699
const t = useT();
97100

@@ -135,6 +138,22 @@ export default function App() {
135138
return () => window.removeEventListener("hashchange", onHash);
136139
}, []);
137140

141+
useEffect(() => {
142+
let cancelled = false;
143+
const readStartupHealth = async () => {
144+
try {
145+
const res = await fetch(`${API_BASE}/api/startup-health`);
146+
if (!res.ok) return;
147+
const data = await res.json() as { status?: unknown };
148+
if (!cancelled) setStartupAtRisk(data.status === "at-risk");
149+
} catch {
150+
// The proxy may be stopping; keep the last known lifecycle state.
151+
}
152+
};
153+
void readStartupHealth();
154+
return () => { cancelled = true; };
155+
}, []);
156+
138157
useEffect(() => {
139158
const rawHash = window.location.hash.replace(/^#\/?/, "");
140159
// Legacy #debug deep links must resolve before generic normalization
@@ -291,6 +310,9 @@ export default function App() {
291310
}}
292311
aria-current={page === id ? "page" : undefined}>
293312
<Icon /> {t(tkey)}
313+
{id === "startup" && startupAtRisk && (
314+
<span className="nav-health-dot" title={t("startup.navRisk")} aria-label={t("startup.navRisk")} />
315+
)}
294316
</button>
295317
))}
296318
</nav>
@@ -330,6 +352,7 @@ export default function App() {
330352
<main className="main" inert={navOpen}>
331353
<div className={`main-inner${page === "combos" ? " main-inner--combos" : ""}`}>
332354
{page === "dashboard" && <Dashboard apiBase={API_BASE} />}
355+
{page === "startup" && <Startup apiBase={API_BASE} />}
333356
{page === "providers" && <Providers apiBase={API_BASE} />}
334357
{page === "models" && <Models apiBase={API_BASE} />}
335358
{page === "combos" && <Combos apiBase={API_BASE} />}

0 commit comments

Comments
 (0)