@bryanhu/codexly 0.24.0 → 0.26.0

package/CHANGELOG.md

@@ -4,6 +4,30 @@
 
 ## [Unreleased]
 
+## [0.26.0] - 2026-09-23
+
+### 新增
+
+- 在任务右侧检查器中展示可展开的运行时警告，保留完整上下文并在任务恢复后继续显示。
+
+## [0.25.2] - 2026-09-23
+
+### 新增
+
+- 支持在局域网访问时下载任务文件。
+- 在 AI 回复中渲染 Mermaid 图表，并使用严格安全解析。
+- 自动发现自定义 Provider 模型目录，完善在线、CLI 与持久化目录的回退。
+
+### 优化
+
+- 升级内置 Codex 至 `0.156.0`，刷新 App Server Schema 基线并适配远程文件图片输入。
+- 为缺少推理元数据的自定义模型提供基础思考档位，并统一推理摘要展示与异步错误提示。
+
+### 修复
+
+- 修复异步问题在任务终态或快照刷新后错误恢复，以及历史回答缺失的问题。
+- 修复流式恢复后的运行时警告，以及已完成推理摘要仍持续展开的问题。
+
 ## [0.24.0] - 2026-09-20
 
 ### 新增

package/README.md

@@ -10,7 +10,7 @@
   <img src="https://img.shields.io/badge/TypeScript-6.0-3178c6" alt="TypeScript" />
   <img src="https://img.shields.io/badge/Vite-8-646cff" alt="Vite" />
   <img src="https://img.shields.io/badge/Fastify-5-000000" alt="Fastify" />
-  <img src="https://img.shields.io/badge/OpenAI_Codex-0.155.1-412991" alt="OpenAI Codex" />
+  <img src="https://img.shields.io/badge/OpenAI_Codex-0.156.0-412991" alt="OpenAI Codex" />
   <a href="./LICENSE">
     <img src="https://img.shields.io/badge/License-MIT-0f766e" alt="MIT" />
   </a>
@@ -37,6 +37,7 @@
 ## Features
 
 - Run project or temporary Codex tasks and follow responses, commands, and file changes in real time
+- Review persistent runtime warnings and expand their full context in the task inspector
 - Keep follow-up work in a persistent task queue, and edit queued messages and attachments before they run
 - Track active work on a task board, maintain project to-dos, and schedule persistent one-time or recurring tasks
 - Attach files and images from the current device or deployment host, reference project files with `@`, answer MCP input requests, and ask or dismiss asynchronous questions while a task runs
@@ -44,18 +45,19 @@
 - Manage installed Skills, official Plugins, MCP servers, and compatible third-party Skills from ClawHub in one extension center
 - Organize ordered multi-root projects, archive project or temporary tasks, and permanently delete tasks when needed
 - Search tasks, conversation history, and project files globally, then jump to a matching message or preview a file
+- View Mermaid diagrams in AI responses
 - Inspect, preview, rename, and delete project files; review diffs; manage branches and worktrees; and commit or push changes
 - Fork a task from an AI response and continue it in a new Git worktree
 - Add animated workspace pets with separate task activity bubbles and custom PNG or WebP sprite manifests
 - Manage a collection of custom workspace backgrounds, or use Bing daily images, with automatic foreground colors, overlay opacity, and blur
-- Access the workspace from another device on a trusted local network
+- Access the workspace and download task files from another device on a trusted local network
 
 ## Requirements
 
 - Node.js >=22.14.0
 - Chrome/Chromium 116+, Firefox 124+, or Safari 17.4+
 
-Codexly includes Codex CLI `0.155.1` through `@openai/codex`; a separate installation is not required. External binaries supplied through `--codex-bin <path>` or `CODEXLY_CODEX_BIN` must satisfy `>=0.155.0,<0.156.0`.
+Codexly includes Codex CLI `0.156.0` through `@openai/codex`; a separate installation is not required. External binaries supplied through `--codex-bin <path>` or `CODEXLY_CODEX_BIN` must satisfy `>=0.156.0,<0.157.0`.
 
 ## Quick Start
 
@@ -70,6 +72,7 @@ Codexly opens the browser automatically. If it does not, use the address printed
 Only one Codexly instance can use a data directory. The instance lock is released automatically on exit or crash. Use different `--codex-home <directory>` values for independent instances.
 
 On first launch, sign in with ChatGPT or configure an OpenAI-compatible service that supports the Responses API and `GET /models`.
+Custom providers discover available models; basic reasoning levels remain selectable when model metadata omits them.
 
 For regular use, install Codexly globally:
 

package/README.zh-CN.md

@@ -7,6 +7,7 @@ Codexly 是一个在浏览器中使用 Codex 的本地 AI 编程工作台。它
 ## 主要功能
 
 - 运行项目任务或临时任务，实时查看回复、命令和文件变更
+- 在任务检查器中查看持久化的运行时警告，并展开完整上下文
 - 使用持久化任务队列安排后续工作，并在执行前编辑排队消息和附件
 - 使用任务看板跟踪进行中的工作、维护项目待办，并创建持久化的一次性或周期定时任务
 - 从当前设备或部署主机添加文件与图片、使用 `@` 引用项目文件、回答 MCP 补充输入请求，并在任务执行期间发起或关闭异步问题
@@ -14,18 +15,19 @@ Codexly 是一个在浏览器中使用 Codex 的本地 AI 编程工作台。它
 - 在扩展中心统一管理已安装 Skills、官方 Plugins、MCP Servers，以及来自 ClawHub 的兼容第三方 Skills
 - 组织有序的多根项目、归档项目或临时任务，并按需永久删除任务
 - 全局搜索任务、历史消息和项目文件，并定位匹配消息或预览文件
+- 在 AI 回复中查看 Mermaid 图表
 - 查看、预览、重命名和删除项目文件，审查差异，管理分支与 worktree，并提交或推送变更
 - 从 AI 回复处分叉任务，在新的 Git worktree 中继续工作
 - 添加工作台宠物动画，用独立气泡区分任务活动，并支持自定义 PNG 或 WebP 精灵图清单
 - 管理自定义工作台背景图片集合，或使用 Bing 每日壁纸，并自动适配前景色、浮层遮罩与背景模糊
-- 从可信局域网中的其他设备访问工作台
+- 从可信局域网中的其他设备访问工作台并下载任务文件
 
 ## 环境要求
 
 - Node.js >=22.14.0
 - Chrome/Chromium 116+、Firefox 124+ 或 Safari 17.4+
 
-Codexly 通过 `@openai/codex` 自带 Codex CLI `0.155.1`，无需单独安装。通过 `--codex-bin <path>` 或 `CODEXLY_CODEX_BIN` 指定的外部版本必须满足 `>=0.155.0,<0.156.0`。
+Codexly 通过 `@openai/codex` 自带 Codex CLI `0.156.0`，无需单独安装。通过 `--codex-bin <path>` 或 `CODEXLY_CODEX_BIN` 指定的外部版本必须满足 `>=0.156.0,<0.157.0`。
 
 ## 快速开始
 
@@ -40,6 +42,7 @@ Codexly 会自动打开浏览器。若未打开，请访问终端输出的地址
 同一数据目录只能运行一个 Codexly 实例，重复启动会被拒绝；进程退出或崩溃后自动释放锁。需要独立实例时使用不同的 `--codex-home <目录>`。
 
 首次启动时，使用 ChatGPT 登录，或配置兼容 Responses API 和 `GET /models` 的 OpenAI-compatible 服务。
+自定义 Provider 会发现可用模型；模型未提供思考档位时可选择基础档位。
 
 经常使用时可以全局安装：
 

package/dist/{chunk-B2673ODM.js → chunk-REIMOLGX.js}

@@ -111,6 +111,7 @@ async function saveProjectTodo(repository, projectId, id, draft, expectedVersion
 }
 
 // packages/core/src/async-question.ts
+var questionSignature = (questions) => JSON.stringify(questions.map(({ title, options }) => ({ title, options })));
 function collectQuestionGroups(turns, identify) {
   return turns.flatMap((turn) => {
     const occurrences = /* @__PURE__ */ new Map();
@@ -118,7 +119,7 @@ function collectQuestionGroups(turns, identify) {
       if (item.type !== "message" || item.role !== "assistant" || !item.questions?.length)
         return [];
       const questions = item.questions.map(({ title, options }) => ({ title, options }));
-      const signature = JSON.stringify(questions);
+      const signature = questionSignature(questions);
       const occurrence = occurrences.get(signature) ?? 0;
       occurrences.set(signature, occurrence + 1);
       return [
@@ -141,6 +142,40 @@ ${answers[index]?.trim() ?? ""}`).join("\n\n");
   if (text.length > 1e5) throw new Error("Invalid question answers");
   return text;
 }
+function restoreAsyncQuestionAnswers(snapshot, records) {
+  const occurrences = /* @__PURE__ */ new Map();
+  let turns = snapshot.turns;
+  for (const record of records) {
+    const signature = questionSignature(record.group.questions);
+    const occurrenceKey = JSON.stringify([record.group.turnId, signature]);
+    const occurrence = occurrences.get(occurrenceKey) ?? 0;
+    occurrences.set(occurrenceKey, occurrence + 1);
+    const result = record.result;
+    if (record.group.status !== "answered" || result === void 0 || result.turn !== null)
+      continue;
+    const turnIndex = turns.findIndex((turn2) => turn2.id === result.turnId);
+    const turn = turns[turnIndex];
+    if (turnIndex < 0 || turn === void 0) continue;
+    const questionIndexes = turn.items.flatMap(
+      (item, index) => item.type === "message" && item.role === "assistant" && questionSignature(item.questions ?? []) === signature ? [index] : []
+    );
+    const questionIndex = questionIndexes[occurrence];
+    if (questionIndex === void 0) continue;
+    const alreadyPresent = turn.items.slice(questionIndex + 1).some(
+      (item) => item.type === "message" && item.role === "user" && item.text === result.input.text
+    );
+    if (alreadyPresent) continue;
+    const items = [...turn.items];
+    items.splice(questionIndex + 1, 0, {
+      id: result.messageId,
+      role: "user",
+      text: result.input.text,
+      type: "message"
+    });
+    turns = turns.map((candidate, index) => index === turnIndex ? { ...turn, items } : candidate);
+  }
+  return turns === snapshot.turns ? snapshot : { ...snapshot, turns };
+}
 
 // packages/core/src/archived-task-deletion.ts
 async function deleteArchivedTasks(provider, scopeId) {
@@ -257,4 +292,26 @@ async function queryCompletedTasks(resolve, input) {
   };
 }
 
-export { CompletedTasksQueryError, PendingRequestResolutionError, ProjectTodoError, TaskSubmissionError, WorkbenchPetProviderError, collectQuestionGroups, deleteArchivedTasks, formatQuestionAnswers, listTaskCatalog, queryCompletedTasks, saveProjectTodo, submitTask };
+// packages/core/src/custom-model-reasoning.ts
+var CUSTOM_MODEL_REASONING_FALLBACK = [
+  { description: "", id: "low" },
+  { description: "", id: "medium" },
+  { description: "", id: "high" }
+];
+function needsReasoningFallback(model) {
+  return model.supportedReasoningEfforts.length === 0 || model.supportedReasoningEfforts.every((effort) => effort.id === "none");
+}
+function normalizeCustomModelReasoning(page) {
+  if (!page.data.some(needsReasoningFallback)) return page;
+  const data = page.data.map((model) => {
+    if (!needsReasoningFallback(model)) return model;
+    return {
+      ...model,
+      defaultReasoningEffort: "medium",
+      supportedReasoningEfforts: CUSTOM_MODEL_REASONING_FALLBACK.map((effort) => ({ ...effort }))
+    };
+  });
+  return { ...page, data };
+}
+
+export { CUSTOM_MODEL_REASONING_FALLBACK, CompletedTasksQueryError, PendingRequestResolutionError, ProjectTodoError, TaskSubmissionError, WorkbenchPetProviderError, collectQuestionGroups, deleteArchivedTasks, formatQuestionAnswers, listTaskCatalog, normalizeCustomModelReasoning, queryCompletedTasks, restoreAsyncQuestionAnswers, saveProjectTodo, submitTask };

package/dist/{chunk-YG3QMLCD.js → chunk-SVPC5JYN.js}

@@ -1,5 +1,5 @@
 import { createRequire } from 'node:module';
-import { WorkbenchPetProviderError, PendingRequestResolutionError } from './chunk-B2673ODM.js';
+import { WorkbenchPetProviderError, CUSTOM_MODEL_REASONING_FALLBACK, normalizeCustomModelReasoning, PendingRequestResolutionError } from './chunk-REIMOLGX.js';
 import { TEMPORARY_TASK_SCOPE_ID, MAX_AGENT_HISTORY_IMAGE_TOTAL_BYTES, isAgentFastModeAvailable, MAX_REALTIME_FILE_CHANGES, MAX_REALTIME_DIFF_BYTES, stripLeadingAgentSkillReferences, MAX_AGENT_HISTORY_IMAGES, MAX_AGENT_IMAGE_BYTES, MAX_AGENT_TEXT_BYTES, MAX_AGENT_FILE_BYTES } from './chunk-ZXTTTT25.js';
 import { __commonJS, __require, __toESM } from './chunk-K6J42667.js';
 import { execFile, spawn } from 'child_process';
@@ -4466,8 +4466,8 @@ var require_pino = __commonJS({
   }
 });
 var execFileAsync = promisify(execFile);
-var SUPPORTED_CODEX_VERSION = "0.155.1";
-var SUPPORTED_CODEX_VERSION_RANGE = ">=0.155.0,<0.156.0";
+var SUPPORTED_CODEX_VERSION = "0.156.0";
+var SUPPORTED_CODEX_VERSION_RANGE = ">=0.156.0,<0.157.0";
 var BUNDLED_CODEX_TARGETS = {
   "darwin-arm64": {
     executableName: "codex",
@@ -4609,7 +4609,7 @@ async function checkCodexVersion(binaryPath, options = {}) {
   }
   const [major, minor, patch] = version.split("-", 1)[0]?.split(".").map(Number) ?? [];
   const isPrerelease = version.includes("-");
-  if (major !== 0 || minor !== 155 || patch === void 0 || isPrerelease) {
+  if (major !== 0 || minor !== 156 || patch === void 0 || isPrerelease) {
     throw new Error(
       `Unsupported Codex version ${version}; expected ${SUPPORTED_CODEX_VERSION_RANGE}`
     );
@@ -11921,9 +11921,6 @@ async function updateAgentPreferences(client, settings) {
 }
 
 // packages/provider-codex/src/custom-model-catalog.ts
-var DEFAULT_REASONING_EFFORTS = [
-  { description: "", id: "medium" }
-];
 var CodexProviderConnectionError = class extends Error {
   constructor(message) {
     super(message);
@@ -12021,10 +12018,8 @@ function mapCustomModels(values, countLimit) {
     throw new CodexProviderConnectionError("Custom provider returned no usable models");
   }
   const data = orderedModels.map((model, index) => {
-    const supportedReasoningEfforts = model.supportedReasoningEfforts === void 0 || model.supportedReasoningEfforts.length === 0 ? DEFAULT_REASONING_EFFORTS : model.supportedReasoningEfforts;
-    const defaultReasoningEffort = supportedReasoningEfforts.some(
-      (effort) => effort.id === model.defaultReasoningEffort
-    ) ? model.defaultReasoningEffort : supportedReasoningEfforts[0]?.id;
+    const supportedReasoningEfforts = model.supportedReasoningEfforts === void 0 || model.supportedReasoningEfforts.length === 0 ? CUSTOM_MODEL_REASONING_FALLBACK.map((effort) => ({ ...effort })) : model.supportedReasoningEfforts;
+    const defaultReasoningEffort = model.defaultReasoningEffort !== void 0 && supportedReasoningEfforts.some((effort) => effort.id === model.defaultReasoningEffort) ? model.defaultReasoningEffort : supportedReasoningEfforts.find((effort) => effort.id === "medium")?.id ?? supportedReasoningEfforts[0]?.id;
     if (defaultReasoningEffort === void 0) {
       throw new CodexProviderConnectionError("Custom model has no reasoning effort");
     }
@@ -12037,7 +12032,7 @@ function mapCustomModels(values, countLimit) {
       supportedReasoningEfforts
     };
   });
-  return { data, nextCursor: null };
+  return normalizeCustomModelReasoning({ data, nextCursor: null });
 }
 
 // packages/provider-codex/src/native-state-snapshot.ts
@@ -12115,6 +12110,21 @@ function readModelProviderConfig(config, providerId) {
   const provider = providers?.[providerId];
   return isRecord6(provider) ? provider : null;
 }
+function hasCurrentCustomModelCatalog(config) {
+  const activeProvider = readActiveProvider(config);
+  const providerId = readConfiguredProviderId(config);
+  if (activeProvider.mode !== "custom" || providerId === null || providerId === "openai") {
+    return false;
+  }
+  const provider = readModelProviderConfig(config, providerId);
+  const features = isRecord6(config["features"]) ? config["features"] : null;
+  const configuredBaseUrl = optionalString3(provider?.["base_url"], 2048);
+  const configuredCatalogUrl = optionalString3(provider?.["model_catalog_url"], 2048);
+  if (configuredBaseUrl === null || configuredCatalogUrl === null) return false;
+  const baseUrl = configuredBaseUrl.replace(/\/+$/u, "");
+  const catalogUrl = configuredCatalogUrl.replace(/\/+$/u, "");
+  return catalogUrl === `${baseUrl}/models` && features?.["api_key_model_discovery"] === true;
+}
 function readActiveProvider(config) {
   const providerId = readConfiguredProviderId(config) ?? "openai";
   const openaiBaseUrl = optionalString3(config["openai_base_url"], 2048);
@@ -12130,25 +12140,13 @@ function readActiveProvider(config) {
 }
 function createCustomProviderConfigUpdate(config, baseUrl, hasApiKey) {
   const configuredProviderId = readConfiguredProviderId(config);
-  const existingProviderId = readActiveProvider(config).mode === "custom" ? configuredProviderId : null;
+  const existingProviderId = readActiveProvider(config).mode === "custom" && configuredProviderId !== "openai" ? configuredProviderId : null;
   const providerId = existingProviderId ?? DEFAULT_CUSTOM_PROVIDER_ID;
-  if (providerId === "openai") {
-    return {
-      edits: [{ keyPath: "openai_base_url", mergeStrategy: "upsert", value: baseUrl }],
-      providerId,
-      requiresOpenaiAuth: true,
-      rollbackEdits: [
-        {
-          keyPath: "openai_base_url",
-          mergeStrategy: "replace",
-          value: config["openai_base_url"] ?? null
-        }
-      ]
-    };
-  }
   const previousProvider = readModelProviderConfig(config, providerId);
+  const previousFeatures = isRecord6(config["features"]) ? config["features"] : null;
   const previousRequiresOpenaiAuth = previousProvider?.["requires_openai_auth"];
-  const requiresOpenaiAuth = hasApiKey ? true : typeof previousRequiresOpenaiAuth === "boolean" ? previousRequiresOpenaiAuth : false;
+  const migratesOpenAiOverride = configuredProviderId === "openai" && readActiveProvider(config).mode === "custom";
+  const requiresOpenaiAuth = hasApiKey ? true : migratesOpenAiOverride ? true : typeof previousRequiresOpenaiAuth === "boolean" ? previousRequiresOpenaiAuth : false;
   const configuredName = nonEmptyString(previousProvider?.["name"]);
   const edits = [
     {
@@ -12156,10 +12154,16 @@ function createCustomProviderConfigUpdate(config, baseUrl, hasApiKey) {
       mergeStrategy: "upsert",
       value: {
         base_url: baseUrl,
+        model_catalog_url: `${baseUrl}/models`,
         name: configuredName ?? providerId,
         requires_openai_auth: requiresOpenaiAuth,
         wire_api: "responses"
       }
+    },
+    {
+      keyPath: "features.api_key_model_discovery",
+      mergeStrategy: "upsert",
+      value: true
     }
   ];
   const rollbackEdits = [
@@ -12167,6 +12171,11 @@ function createCustomProviderConfigUpdate(config, baseUrl, hasApiKey) {
       keyPath: `model_providers.${providerId}`,
       mergeStrategy: "replace",
       value: previousProvider
+    },
+    {
+      keyPath: "features.api_key_model_discovery",
+      mergeStrategy: "replace",
+      value: previousFeatures?.["api_key_model_discovery"] ?? null
     }
   ];
   if (existingProviderId === null) {
@@ -12180,6 +12189,14 @@ function createCustomProviderConfigUpdate(config, baseUrl, hasApiKey) {
       mergeStrategy: "replace",
       value: config["model_provider"] ?? null
     });
+    if (configuredProviderId === "openai" && config["openai_base_url"] !== void 0) {
+      edits.push({ keyPath: "openai_base_url", mergeStrategy: "replace", value: null });
+      rollbackEdits.push({
+        keyPath: "openai_base_url",
+        mergeStrategy: "replace",
+        value: config["openai_base_url"]
+      });
+    }
   }
   return { edits, providerId, requiresOpenaiAuth, rollbackEdits };
 }
@@ -12368,7 +12385,21 @@ var CodexProviderConnectionService = class {
   invalidateConfig() {
     this.#nativeState.clear();
   }
-  async configureCustom(input, persistedModels) {
+  async prepareModelCatalog() {
+    const config = await this.#nativeState.readConfig();
+    const activeProvider = readActiveProvider(config);
+    if (activeProvider.mode !== "custom" || activeProvider.customBaseUrl === null) return;
+    if (hasCurrentCustomModelCatalog(config)) return;
+    const update = createCustomProviderConfigUpdate(
+      config,
+      normalizeBaseUrl(activeProvider.customBaseUrl),
+      /*hasApiKey*/
+      false
+    );
+    await this.#client.request("config/batchWrite", { edits: update.edits });
+    this.#nativeState.clear();
+  }
+  async configureCustom(input, fallbackModels) {
     const baseUrl = normalizeBaseUrl(input.baseUrl);
     const apiKey = input.apiKey;
     if (apiKey?.trim().length === 0) {
@@ -12376,17 +12407,17 @@ var CodexProviderConnectionService = class {
     }
     const manualModels = normalizeManualModels(input.models ?? [], this.#modelCountLimit);
     let models;
-    if (input.models === void 0 && persistedModels !== void 0) {
-      models = persistedModels;
-    } else {
-      let discoveredModels;
-      try {
-        discoveredModels = await this.#discoverModels(baseUrl, apiKey);
-      } catch (error) {
-        if (manualModels.length === 0) throw error;
-        discoveredModels = [];
-      }
+    try {
+      const discoveredModels = await this.#discoverModels(baseUrl, apiKey);
       models = mapCustomModels([...discoveredModels, ...manualModels], this.#modelCountLimit);
+    } catch (error) {
+      if (manualModels.length > 0) {
+        models = mapCustomModels(manualModels, this.#modelCountLimit);
+      } else if (fallbackModels !== void 0) {
+        models = fallbackModels;
+      } else {
+        throw error;
+      }
     }
     this.#nativeState.clear();
     const [configResponse, accountResponse] = await Promise.all([
@@ -13588,6 +13619,7 @@ var CodexRuntimeProvider = class {
   #taskTitles;
   #logger;
   #gitMetadataWatch;
+  #modelCatalogRuntimeFactory;
   #providerConnection;
   #owners = new RuntimeOwnerRegistry();
   #projects = /* @__PURE__ */ new Map();
@@ -13610,6 +13642,7 @@ var CodexRuntimeProvider = class {
       updateAgentPreferences: (input) => updateAgentPreferences(client, input)
     };
     this.#logger = logger;
+    this.#modelCatalogRuntimeFactory = options.modelCatalogRuntimeFactory;
     this.#providerConnection = new CodexProviderConnectionService(client, options);
     this.fileSearch = new CodexFuzzyFileSearchService(client);
     this.search = new CodexGlobalSearchService(client);
@@ -13675,8 +13708,8 @@ var CodexRuntimeProvider = class {
   cancelProviderLogin(loginId) {
     return this.#providerConnection.cancelLogin(loginId);
   }
-  configureCustomProvider(input, persistedModels) {
-    return this.#providerConnection.configureCustom(input, persistedModels);
+  configureCustomProvider(input, fallbackModels) {
+    return this.#providerConnection.configureCustom(input, fallbackModels);
   }
   forProject(project) {
     const primaryRoot = project.roots[0];
@@ -13738,7 +13771,44 @@ var CodexRuntimeProvider = class {
       }
     });
   }
-  listModels() {
+  async listModels() {
+    if (this.#modelCatalogRuntimeFactory !== void 0) {
+      let catalogRuntime = null;
+      try {
+        await this.#providerConnection.prepareModelCatalog();
+        catalogRuntime = await this.#modelCatalogRuntimeFactory();
+        return await this.#listModelsWithClient(catalogRuntime.client);
+      } catch {
+        this.#logger.warn(
+          { diagnosticCode: "model_catalog_refresh_failed" },
+          "Fresh model catalog unavailable; falling back to the primary Codex CLI catalog"
+        );
+      } finally {
+        if (catalogRuntime !== null) {
+          await catalogRuntime.close().catch(() => {
+            this.#logger.warn(
+              { diagnosticCode: "model_catalog_runtime_close_failed" },
+              "Failed to close the model catalog App Server"
+            );
+          });
+        }
+      }
+    }
+    return this.#listModelsWithClient(this.#client);
+  }
+  #listModelsWithClient(client) {
+    if (client !== this.#client) {
+      const runtimeProject2 = {
+        id: "runtime-model-catalog",
+        kind: "project",
+        rootPath: resolve("/"),
+        runtimeWorkspaceRoots: [resolve("/")]
+      };
+      return new CodexAgentProvider(client, runtimeProject2, {
+        logger: this.#logger,
+        subscribeRpc: false
+      }).listModels();
+    }
     const firstProvider = this.#projectProviders.values().next().value;
     if (firstProvider !== void 0) {
       return firstProvider.listModels();
@@ -13866,10 +13936,19 @@ function createCodexRuntimeProvider(options) {
   return new CodexRuntimeProvider(options.client, options.logger, {
     ...options.codexHome === void 0 ? {} : { codexHome: options.codexHome },
     ...options.fetch === void 0 ? {} : { fetch: options.fetch },
+    ...options.modelCatalogRuntimeFactory === void 0 ? {} : { modelCatalogRuntimeFactory: options.modelCatalogRuntimeFactory },
     ...options.readTaskTitleModel === void 0 ? {} : { readTaskTitleModel: options.readTaskTitleModel }
   });
 }
-var APP_SERVER_ARGUMENTS = ["app-server", "--enable", "plugins", "--listen", "stdio://"];
+var APP_SERVER_ARGUMENTS = [
+  "app-server",
+  "--enable",
+  "plugins",
+  "--enable",
+  "api_key_model_discovery",
+  "--listen",
+  "stdio://"
+];
 var CodexAppServerExitedError = class extends RpcConnectionClosedError {
   exitCode;
   signal;