@codexhost/cli-darwin-arm64 0.1.1 → 0.1.3

package/README.md

@@ -7,7 +7,7 @@ Run Pi and Claude Code as first-class external harnesses inside Codex Desktop.
 ## Install
 
 ```bash
-npm install -g @codexhost/cli@0.1.1
+npm install -g @codexhost/cli@0.1.3
 ```
 
 Do not install this package directly. npm selects it through the optional dependencies of `@codexhost/cli`.
@@ -18,6 +18,7 @@ This package is platform-specific (`os=darwin`, `cpu=arm64`).
 
 ```bash
 codexhost
+codexhost --version
 codexhost inspect
 codexhost launch --agent pi
 codexhost launch --agent codex

package/app/codexhost-distribution.json

@@ -1 +1 @@
-{"schemaVersion":1,"version":"0.1.1","distribution":"npm","target":"macos-arm64"}
+{"schemaVersion":1,"version":"0.1.3","distribution":"npm","target":"macos-arm64"}

package/app/desktop-controller.mjs

@@ -1344,12 +1344,15 @@ function isTransientElectronInstallError(error) {
   }
   return false;
 }
+function shouldRetryInstallError(error) {
+  return !(error instanceof RendererCompatibilityError) || isTransientElectronInstallError(error);
+}
 async function installProductionSession(options, dependencies) {
   for (let attempt = 1; attempt <= TRANSIENT_INSTALL_ATTEMPTS; attempt += 1) {
     try {
       return await dependencies.install(options);
     } catch (error) {
-      if (attempt === TRANSIENT_INSTALL_ATTEMPTS || !isTransientElectronInstallError(error)) {
+      if (attempt === TRANSIENT_INSTALL_ATTEMPTS || !shouldRetryInstallError(error)) {
         throw error;
       }
       await dependencies.sleep(TRANSIENT_INSTALL_RETRY_MS);

package/app/host-runtime.mjs

@@ -15006,6 +15006,7 @@ var updateSemanticVersionSchema = external_exports.string().regex(UPDATE_SEMVER_
 var updateInstallationSchema = external_exports.enum(["npm", "windows-installer", "macos-dmg"]);
 var updatePhaseSchema = external_exports.enum([
   "prepared",
+  "downloading",
   "waiting-for-exit",
   "installing",
   "restarting",
@@ -15017,12 +15018,23 @@ var updateStatusSchema = external_exports.strictObject({
   installation: updateInstallationSchema,
   phase: updatePhaseSchema,
   updatedAt: external_exports.number().int().nonnegative(),
+  downloadedBytes: external_exports.number().int().nonnegative().optional(),
+  totalBytes: external_exports.number().int().positive().optional(),
   error: external_exports.string().min(1).max(UPDATE_ERROR_MAX_LENGTH).nullable()
+}).superRefine((status, context) => {
+  if (status.downloadedBytes !== void 0 && status.totalBytes !== void 0 && status.downloadedBytes > status.totalBytes) {
+    context.addIssue({
+      code: "custom",
+      path: ["downloadedBytes"],
+      message: "downloadedBytes must not exceed totalBytes"
+    });
+  }
 });
 var updateEmptyParamsSchema = external_exports.strictObject({});
 var githubReleaseNotesUrlSchema = external_exports.string().max(300).regex(/^https:\/\/github\.com\/BytePioneer-AI\/codex-host\/releases\/tag\/v[0-9A-Za-z.+-]+$/u, "release notes URL must identify a codexhost GitHub Release");
 var updateCheckResultSchema = external_exports.strictObject({
   currentVersion: updateSemanticVersionSchema,
+  installation: updateInstallationSchema.nullable(),
   latestVersion: updateSemanticVersionSchema.nullable(),
   updateAvailable: external_exports.boolean(),
   installationAvailable: external_exports.boolean(),
@@ -52364,11 +52376,28 @@ function parseUpdateStatus(value) {
     throw new Error("background update status must be an object");
   }
   const status = value;
-  const allowed2 = ["error", "installation", "phase", "schemaVersion", "updatedAt", "version"];
+  const allowed2 = [
+    "downloadedBytes",
+    "error",
+    "installation",
+    "phase",
+    "schemaVersion",
+    "totalBytes",
+    "updatedAt",
+    "version"
+  ];
   if (Object.keys(status).some((key) => !allowed2.includes(key))) {
     throw new Error("background update status contains unknown fields");
   }
-  if (status.schemaVersion !== STATUS_SCHEMA_VERSION || typeof status.version !== "string" || !SEMVER_PATTERN.test(status.version) || !["npm", "windows-installer", "macos-dmg"].includes(String(status.installation)) || !["prepared", "waiting-for-exit", "installing", "restarting", "succeeded", "failed"].includes(String(status.phase)) || !Number.isSafeInteger(status.updatedAt) || status.error !== void 0 && typeof status.error !== "string") {
+  if (status.schemaVersion !== STATUS_SCHEMA_VERSION || typeof status.version !== "string" || !SEMVER_PATTERN.test(status.version) || !["npm", "windows-installer", "macos-dmg"].includes(String(status.installation)) || ![
+    "prepared",
+    "downloading",
+    "waiting-for-exit",
+    "installing",
+    "restarting",
+    "succeeded",
+    "failed"
+  ].includes(String(status.phase)) || !Number.isSafeInteger(status.updatedAt) || status.downloadedBytes !== void 0 && (typeof status.downloadedBytes !== "number" || !Number.isSafeInteger(status.downloadedBytes) || status.downloadedBytes < 0) || status.totalBytes !== void 0 && (typeof status.totalBytes !== "number" || !Number.isSafeInteger(status.totalBytes) || status.totalBytes <= 0) || typeof status.downloadedBytes === "number" && typeof status.totalBytes === "number" && status.downloadedBytes > status.totalBytes || status.error !== void 0 && typeof status.error !== "string") {
     throw new Error("background update status is invalid");
   }
   return status;
@@ -52665,6 +52694,11 @@ async function regularFile(filePath) {
     throw error52;
   }
 }
+async function isUpdateOperationActive(stateDirectory) {
+  if (!path9.isAbsolute(stateDirectory))
+    throw new Error("update state directory must be absolute");
+  return regularFile(path9.join(stateDirectory, LOCK_FILE));
+}
 async function discoverLatestUpdateStatus(stateDirectory) {
   if (!path9.isAbsolute(stateDirectory))
     throw new Error("update state directory must be absolute");
@@ -52755,13 +52789,25 @@ async function acquireUpdateOperationLock(stateDirectory) {
     }
   };
 }
+function processIsAlive(processId) {
+  if (!Number.isSafeInteger(processId) || processId <= 0)
+    return false;
+  try {
+    process.kill(processId, 0);
+    return true;
+  } catch (error52) {
+    return error52.code === "EPERM";
+  }
+}
 async function recoverUpdateOperationLock(stateDirectory) {
   const lockPath = path9.join(stateDirectory, LOCK_FILE);
   if (!await regularFile(lockPath))
     return;
+  let ownerPid;
   let statusPath;
   try {
     const value = JSON.parse(await readFile3(lockPath, "utf8"));
+    ownerPid = value.ownerPid;
     statusPath = value.statusPath;
   } catch {
     return;
@@ -52770,8 +52816,9 @@ async function recoverUpdateOperationLock(stateDirectory) {
     return;
   try {
     const status = parseUpdateStatus(JSON.parse(await readFile3(statusPath, "utf8")));
-    if (TERMINAL_PHASES.has(status.phase))
+    if (TERMINAL_PHASES.has(status.phase) || typeof ownerPid !== "number" || !processIsAlive(ownerPid)) {
       await rm3(lockPath, { force: true });
+    }
   } catch {
   }
 }
@@ -52810,7 +52857,7 @@ async function writeChunk(file2, chunk) {
     offset += result.bytesWritten;
   }
 }
-async function downloadArtifact(source, destination) {
+async function downloadArtifact(source, destination, onProgress) {
   const response = await fetch(source.url, {
     redirect: "follow",
     headers: { "accept-encoding": "identity" }
@@ -52836,6 +52883,7 @@ async function downloadArtifact(source, destination) {
         throw new Error(`update artifact exceeds ${MAX_ARTIFACT_BYTES} bytes`);
       }
       await writeChunk(file2, item.value);
+      await onProgress?.({ downloadedBytes: bytes, totalBytes: source.size });
     }
     await file2.sync();
   } finally {
@@ -52920,6 +52968,59 @@ function createBackgroundUpdateManager(dependencies = {}) {
   const spawnUpdater = dependencies.spawnUpdater ?? defaultSpawnUpdater;
   const now = dependencies.now ?? Date.now;
   const preparedRequests = /* @__PURE__ */ new Set();
+  async function writeStatusSnapshot(statusPath, status) {
+    const temporaryPath = path10.join(path10.dirname(statusPath), `.update-status-${randomId()}.tmp`);
+    try {
+      await writeFile2(temporaryPath, `${JSON.stringify(status)}
+`, {
+        encoding: "utf8",
+        mode: 384,
+        flag: "wx"
+      });
+      await rename2(temporaryPath, statusPath);
+    } catch (error52) {
+      await rm4(temporaryPath, { force: true });
+      throw error52;
+    }
+  }
+  function statusSnapshot(version2, installation, phase, progress, error52) {
+    return {
+      schemaVersion: 1,
+      version: version2,
+      installation,
+      phase,
+      updatedAt: Math.floor(now() / 1e3),
+      ...progress?.downloadedBytes === void 0 ? {} : { downloadedBytes: progress.downloadedBytes },
+      ...progress?.totalBytes === void 0 ? {} : { totalBytes: progress.totalBytes },
+      ...error52 === void 0 ? {} : { error: errorMessage4(error52).slice(0, 500) }
+    };
+  }
+  async function writeFailedStatus(statusPath, version2, installation, error52) {
+    await writeStatusSnapshot(statusPath, statusSnapshot(version2, installation, "failed", void 0, error52)).catch(() => void 0);
+  }
+  function progressReporter(statusPath, version2, installation, totalBytes) {
+    let lastProgress = { downloadedBytes: 0, totalBytes };
+    let lastWriteAt = 0;
+    let queued = Promise.resolve();
+    const enqueue = (progress, force = false) => {
+      lastProgress = progress;
+      const currentTime = Date.now();
+      if (!force && currentTime - lastWriteAt < 250)
+        return;
+      lastWriteAt = currentTime;
+      queued = queued.then(() => writeStatusSnapshot(statusPath, statusSnapshot(version2, installation, "downloading", lastProgress))).catch(() => void 0);
+    };
+    enqueue(lastProgress, true);
+    return {
+      update(progress) {
+        enqueue(progress);
+      },
+      async flush() {
+        enqueue(lastProgress, true);
+        await queued;
+      }
+    };
+  }
   async function prepareCommon(options, installation) {
     const version2 = requireSemanticVersion(options.version);
     const launcherPid = requireLauncherPid(options.launcherPid);
@@ -52937,6 +53038,7 @@ function createBackgroundUpdateManager(dependencies = {}) {
     const requestPath = path10.join(workDirectory, "request-v1.json");
     const statusPath = path10.join(workDirectory, "status-v1.json");
     await writePrivateJson(statusPath, preparedStatus(version2, installation, now()));
+    await options.onPrepared?.({ version: version2, installation, statusPath });
     return {
       version: version2,
       launcherPid,
@@ -52947,12 +53049,15 @@ function createBackgroundUpdateManager(dependencies = {}) {
       statusPath
     };
   }
-  async function prepareArtifact(sourceValue, workDirectory, fileName) {
+  async function prepareArtifact(common, installation, sourceValue, fileName) {
     const source = validateArtifact(sourceValue);
-    const temporaryPath = path10.join(workDirectory, `.${fileName}.download`);
-    const artifactPath = path10.join(workDirectory, fileName);
+    const temporaryPath = path10.join(common.workDirectory, `.${fileName}.download`);
+    const artifactPath = path10.join(common.workDirectory, fileName);
+    const progress = progressReporter(common.statusPath, common.version, installation, source.size);
     try {
-      const result = await download(source, temporaryPath);
+      const result = await download(source, temporaryPath, progress.update);
+      progress.update({ downloadedBytes: result.bytes, totalBytes: source.size });
+      await progress.flush();
       const finalUrl = new URL(result.finalUrl);
       if (finalUrl.protocol !== "https:" || finalUrl.username || finalUrl.password) {
         throw new Error("update artifact downloader returned a non-HTTPS URL");
@@ -52962,6 +53067,8 @@ function createBackgroundUpdateManager(dependencies = {}) {
       return { source, artifactPath };
     } catch (error52) {
       await rm4(temporaryPath, { force: true });
+      await progress.flush();
+      await writeFailedStatus(common.statusPath, common.version, installation, error52);
       throw error52;
     }
   }
@@ -52975,6 +53082,7 @@ function createBackgroundUpdateManager(dependencies = {}) {
       installation
     };
     await writePrivateJson(common.requestPath, request);
+    await writeStatusSnapshot(common.statusPath, statusSnapshot(common.version, installation.kind, "prepared"));
     preparedRequests.add(common.requestPath);
     return Object.freeze({
       version: common.version,
@@ -52988,19 +53096,24 @@ function createBackgroundUpdateManager(dependencies = {}) {
   return Object.freeze({
     async prepareNpm(options) {
       const common = await prepareCommon(options, "npm");
-      return finalize2(common, {
-        kind: "npm",
-        node_path: await requireRegularFile(options.nodePath, "npm Node.js executable"),
-        npm_cli_path: await requireRegularFile(options.npmCliPath, "npm CLI"),
-        npm_launcher_path: await requireRegularFile(options.npmLauncherPath, "npm codexhost launcher"),
-        package_root: requireAbsolutePath(options.packageRoot, "npm platform package root")
-      });
+      try {
+        return await finalize2(common, {
+          kind: "npm",
+          node_path: await requireRegularFile(options.nodePath, "npm Node.js executable"),
+          npm_cli_path: await requireRegularFile(options.npmCliPath, "npm CLI"),
+          npm_launcher_path: await requireRegularFile(options.npmLauncherPath, "npm codexhost launcher"),
+          package_root: requireAbsolutePath(options.packageRoot, "npm platform package root")
+        });
+      } catch (error52) {
+        await writeFailedStatus(common.statusPath, common.version, "npm", error52);
+        throw error52;
+      }
     },
     async prepareWindowsInstaller(options) {
       if (platform !== "win32")
         throw new Error("Windows installer updates require Windows");
       const common = await prepareCommon(options, "windows-installer");
-      const artifact = await prepareArtifact(options.artifact, common.workDirectory, "update.exe");
+      const artifact = await prepareArtifact(common, "windows-installer", options.artifact, "update.exe");
       return finalize2(common, {
         kind: "windows-installer",
         installer_path: artifact.artifactPath,
@@ -53016,7 +53129,7 @@ function createBackgroundUpdateManager(dependencies = {}) {
       if (path10.extname(appPath) !== ".app") {
         throw new Error("macOS application path must end in .app");
       }
-      const artifact = await prepareArtifact(options.artifact, common.workDirectory, "update.dmg");
+      const artifact = await prepareArtifact(common, "macos-dmg", options.artifact, "update.dmg");
       return finalize2(common, {
         kind: "macos-dmg",
         dmg_path: artifact.artifactPath,
@@ -53049,6 +53162,8 @@ function createBackgroundUpdateManager(dependencies = {}) {
 // packages/host-runtime/src/update-coordinator.ts
 var ERROR_MAX_LENGTH = 500;
 var CONTROLLER_TIMEOUT_MS = 5e3;
+var UPDATER_READY_TIMEOUT_MS = 1e4;
+var UPDATER_READY_POLL_MS = 20;
 async function startCompatibilityUpdate(coordinator) {
   try {
     const check2 = await coordinator.check();
@@ -53067,12 +53182,38 @@ function boundedError(error52) {
   const message3 = error52 instanceof Error ? error52.message : String(error52);
   return message3.slice(0, ERROR_MAX_LENGTH) || "Update operation failed";
 }
+function delay4(milliseconds) {
+  return new Promise((resolve2) => setTimeout(resolve2, milliseconds));
+}
+async function waitForUpdaterReady(manager, statusPath) {
+  const deadline = Date.now() + UPDATER_READY_TIMEOUT_MS;
+  while (Date.now() < deadline) {
+    const status = await manager.readStatus(statusPath);
+    switch (status?.phase) {
+      case "waiting-for-exit":
+      case "installing":
+      case "restarting":
+      case "succeeded":
+        return;
+      case "failed":
+        throw new Error(status.error ?? "Background Updater failed before Desktop shutdown");
+      case "prepared":
+        break;
+      default:
+        throw new Error("Background Updater reported an unexpected startup phase");
+    }
+    await delay4(UPDATER_READY_POLL_MS);
+  }
+  throw new Error("Background Updater did not become ready before Desktop shutdown");
+}
 function publicStatus(status) {
   return {
     version: status.version,
     installation: status.installation,
     phase: status.phase,
     updatedAt: status.updatedAt,
+    ...status.downloadedBytes === void 0 ? {} : { downloadedBytes: status.downloadedBytes },
+    ...status.totalBytes === void 0 ? {} : { totalBytes: status.totalBytes },
     error: status.error?.slice(0, ERROR_MAX_LENGTH) ?? null
   };
 }
@@ -53105,7 +53246,8 @@ function requestControllerShutdown(controller) {
   });
 }
 function createHostUpdateCoordinator(options) {
-  const manager = options.manager ?? createBackgroundUpdateManager(options.platform ? { platform: options.platform } : {});
+  const platform = options.platform ?? process.platform;
+  const manager = options.manager ?? createBackgroundUpdateManager({ platform });
   const contextPromise = resolveInstalledUpdateContext({
     hostRuntimePath: options.hostRuntimePath,
     ...options.environment ? { environment: options.environment } : {},
@@ -53116,9 +53258,20 @@ function createHostUpdateCoordinator(options) {
   const shutdown = options.shutdown ?? requestControllerShutdown;
   let candidate = null;
   let shutdownPending = null;
+  let shutdownRequested = false;
+  const scheduleShutdown = () => {
+    if (!shutdownRequested || !shutdownPending) return;
+    const controller = shutdownPending;
+    shutdownPending = null;
+    setTimeout(() => void shutdown(controller).catch(() => void 0), 50).unref();
+  };
   async function latestStatus(context) {
     const discovered = await discoverLatestUpdateStatus(context.common.stateDirectory);
-    return discovered ? publicStatus(discovered.status) : null;
+    if (!discovered) return null;
+    if (discovered.status.phase !== "succeeded" && discovered.status.phase !== "failed" && !await isUpdateOperationActive(context.common.stateDirectory)) {
+      return null;
+    }
+    return publicStatus(discovered.status);
   }
   async function installable(context, release) {
     if (context.metadata.distribution === "npm") return true;
@@ -53139,6 +53292,7 @@ function createHostUpdateCoordinator(options) {
       } catch (error52) {
         return {
           currentVersion: "0.0.0",
+          installation: null,
           latestVersion: null,
           updateAvailable: false,
           installationAvailable: false,
@@ -53163,6 +53317,7 @@ function createHostUpdateCoordinator(options) {
         }
         return {
           currentVersion: context.metadata.version,
+          installation: context.installation.kind,
           latestVersion: release.version,
           updateAvailable,
           installationAvailable,
@@ -53174,6 +53329,7 @@ function createHostUpdateCoordinator(options) {
       } catch (error52) {
         return {
           currentVersion: context.metadata.version,
+          installation: context.installation.kind,
           latestVersion: null,
           updateAvailable: false,
           installationAvailable: false,
@@ -53193,34 +53349,60 @@ function createHostUpdateCoordinator(options) {
         if (existing) return { status: existing };
         throw new Error("Another update operation is already active");
       }
+      let resolvePrepared;
+      let rejectPrepared;
+      const preparedReady = new Promise((resolve2, reject) => {
+        resolvePrepared = resolve2;
+        rejectPrepared = reject;
+      });
       try {
         const release = await fetchLatest();
         if (compareSemanticVersions(context.metadata.version, release.version) >= 0 || candidate && candidate.version !== release.version) {
           throw new Error("The selected update is no longer the current GitHub Release");
         }
-        let prepared;
-        if (context.installation.kind === "npm") {
-          prepared = await manager.prepareNpm({
-            ...context.installation.options,
-            version: release.version
-          });
-        } else {
-          const artifact = selectInstallerReleaseArtifact(release, context.metadata.target).source;
-          prepared = context.installation.kind === "windows-installer" ? await manager.prepareWindowsInstaller({
-            ...context.installation.options,
-            version: release.version,
-            artifact
-          }) : await manager.prepareMacOsDmg({
-            ...context.installation.options,
-            version: release.version,
-            artifact
-          });
-        }
-        await lock.setStatusPath(prepared.statusPath);
-        manager.start(prepared);
+        const onPrepared = async (info) => {
+          await lock.setStatusPath(info.statusPath);
+          resolvePrepared(info);
+        };
+        const prepareAndStart = async () => {
+          try {
+            let prepared2;
+            if (context.installation.kind === "npm") {
+              prepared2 = await manager.prepareNpm({
+                ...context.installation.options,
+                version: release.version,
+                onPrepared
+              });
+            } else {
+              const artifact = selectInstallerReleaseArtifact(
+                release,
+                context.metadata.target
+              ).source;
+              prepared2 = context.installation.kind === "windows-installer" ? await manager.prepareWindowsInstaller({
+                ...context.installation.options,
+                version: release.version,
+                artifact,
+                onPrepared
+              }) : await manager.prepareMacOsDmg({
+                ...context.installation.options,
+                version: release.version,
+                artifact,
+                onPrepared
+              });
+            }
+            if (platform !== "darwin") manager.start(prepared2);
+            await waitForUpdaterReady(manager, prepared2.statusPath);
+            shutdownPending = context.controller;
+            scheduleShutdown();
+          } catch (error52) {
+            await lock.release();
+            rejectPrepared(error52);
+          }
+        };
+        void prepareAndStart();
+        const prepared = await preparedReady;
         const status = await manager.readStatus(prepared.statusPath);
-        if (!status) throw new Error("Background Updater did not create status");
-        shutdownPending = context.controller;
+        if (!status) throw new Error("Background update did not create status");
         return { status: publicStatus(status) };
       } catch (error52) {
         await lock.release();
@@ -53237,10 +53419,8 @@ function createHostUpdateCoordinator(options) {
       }
     },
     requestShutdown() {
-      const controller = shutdownPending;
-      shutdownPending = null;
-      if (!controller) return;
-      setTimeout(() => void shutdown(controller).catch(() => void 0), 50).unref();
+      shutdownRequested = true;
+      scheduleShutdown();
     }
   });
 }

package/app/renderer-extension.js

@@ -15242,6 +15242,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   var updateInstallationSchema = external_exports.enum(["npm", "windows-installer", "macos-dmg"]);
   var updatePhaseSchema = external_exports.enum([
     "prepared",
+    "downloading",
     "waiting-for-exit",
     "installing",
     "restarting",
@@ -15253,12 +15254,23 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     installation: updateInstallationSchema,
     phase: updatePhaseSchema,
     updatedAt: external_exports.number().int().nonnegative(),
+    downloadedBytes: external_exports.number().int().nonnegative().optional(),
+    totalBytes: external_exports.number().int().positive().optional(),
     error: external_exports.string().min(1).max(UPDATE_ERROR_MAX_LENGTH).nullable()
+  }).superRefine((status, context) => {
+    if (status.downloadedBytes !== void 0 && status.totalBytes !== void 0 && status.downloadedBytes > status.totalBytes) {
+      context.addIssue({
+        code: "custom",
+        path: ["downloadedBytes"],
+        message: "downloadedBytes must not exceed totalBytes"
+      });
+    }
   });
   var updateEmptyParamsSchema = external_exports.strictObject({});
   var githubReleaseNotesUrlSchema = external_exports.string().max(300).regex(/^https:\/\/github\.com\/BytePioneer-AI\/codex-host\/releases\/tag\/v[0-9A-Za-z.+-]+$/u, "release notes URL must identify a codexhost GitHub Release");
   var updateCheckResultSchema = external_exports.strictObject({
     currentVersion: updateSemanticVersionSchema,
+    installation: updateInstallationSchema.nullable(),
     latestVersion: updateSemanticVersionSchema.nullable(),
     updateAvailable: external_exports.boolean(),
     installationAvailable: external_exports.boolean(),
@@ -18101,16 +18113,24 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     settingsButtonTitle: "codexhost settings",
     settingsUnavailableTitle: "codexhost settings unavailable",
     updateCurrentVersion: "Current version",
+    updateInstallation: "Installation method",
+    updateInstallationNpm: "npm",
+    updateInstallationWindowsInstaller: "Windows installer",
+    updateInstallationMacOsDmg: "macOS DMG",
+    updateInstallationUnknown: "Unknown",
     updateLatestVersion: "Latest version",
     updateUpToDate: "You are up to date.",
     updateAvailable: "A new version is available.",
     updateAndRestart: "Update and restart",
+    updateChecking: "Checking for updates...",
+    updateDownloading: "Downloading update...",
     updatePreparing: "Preparing update...",
+    updateRequestTimeout: "The update service did not respond. Try again.",
     updateRestarting: "Restarting to finish the update...",
     updateSucceeded: "Update installed successfully.",
     updateFailed: "Update failed.",
     updateRetry: "Retry",
-    updateViewRelease: "View release notes",
+    updateDownloadFromReleases: "Download from GitHub Releases",
     pageLabels: Object.freeze({
       connections: "Connections",
       "model-pool": "Model Pool",
@@ -18138,16 +18158,24 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     settingsButtonTitle: "codexhost \u8BBE\u7F6E",
     settingsUnavailableTitle: "codexhost \u8BBE\u7F6E\u4E0D\u53EF\u7528",
     updateCurrentVersion: "\u5F53\u524D\u7248\u672C",
+    updateInstallation: "\u5B89\u88C5\u65B9\u5F0F",
+    updateInstallationNpm: "npm",
+    updateInstallationWindowsInstaller: "Windows \u5B89\u88C5\u7A0B\u5E8F",
+    updateInstallationMacOsDmg: "macOS DMG",
+    updateInstallationUnknown: "\u672A\u77E5",
     updateLatestVersion: "\u6700\u65B0\u7248\u672C",
     updateUpToDate: "\u5F53\u524D\u5DF2\u662F\u6700\u65B0\u7248\u672C\u3002",
     updateAvailable: "\u6709\u65B0\u7248\u672C\u53EF\u7528\u3002",
     updateAndRestart: "\u66F4\u65B0\u5E76\u91CD\u542F",
+    updateChecking: "\u6B63\u5728\u68C0\u67E5\u66F4\u65B0...",
+    updateDownloading: "\u6B63\u5728\u4E0B\u8F7D\u66F4\u65B0...",
     updatePreparing: "\u6B63\u5728\u51C6\u5907\u66F4\u65B0...",
+    updateRequestTimeout: "\u66F4\u65B0\u670D\u52A1\u672A\u54CD\u5E94\uFF0C\u8BF7\u91CD\u8BD5\u3002",
     updateRestarting: "\u6B63\u5728\u91CD\u542F\u4EE5\u5B8C\u6210\u66F4\u65B0...",
     updateSucceeded: "\u66F4\u65B0\u5B89\u88C5\u6210\u529F\u3002",
     updateFailed: "\u66F4\u65B0\u5931\u8D25\u3002",
     updateRetry: "\u91CD\u8BD5",
-    updateViewRelease: "\u67E5\u770B\u66F4\u65B0\u65E5\u5FD7",
+    updateDownloadFromReleases: "\u524D\u5F80 GitHub Releases \u4E0B\u8F7D",
     pageLabels: Object.freeze({
       connections: "\u8FDE\u63A5",
       "model-pool": "\u6A21\u578B\u6C60",
@@ -18449,7 +18477,51 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     }
   };
 
+  // src/settings/update-request.ts
+  var RENDERER_UPDATE_REQUEST_TIMEOUT_MS = 15e3;
+  var RendererUpdateRequestTimeoutError = class extends Error {
+    constructor() {
+      super("Update request timed out");
+      this.name = "RendererUpdateRequestTimeoutError";
+    }
+  };
+  function runBoundedRendererUpdateRequest(operation, signal, timeoutMs = RENDERER_UPDATE_REQUEST_TIMEOUT_MS) {
+    return new Promise((resolve, reject) => {
+      let settled = false;
+      const settle = (handler) => {
+        if (settled) return;
+        settled = true;
+        clearTimeout(timeout);
+        signal.removeEventListener("abort", abort);
+        handler();
+      };
+      const timeout = setTimeout(() => {
+        settle(() => reject(new RendererUpdateRequestTimeoutError()));
+      }, timeoutMs);
+      const abort = () => {
+        settle(() => reject(new Error("Update request was aborted")));
+      };
+      const rejectRequest = (error51) => {
+        settle(() => reject(error51));
+      };
+      if (signal.aborted) {
+        abort();
+        return;
+      }
+      signal.addEventListener("abort", abort, { once: true });
+      try {
+        void operation().then(
+          (value) => settle(() => resolve(value)),
+          (error51) => rejectRequest(error51)
+        );
+      } catch (error51) {
+        rejectRequest(error51);
+      }
+    });
+  }
+
   // src/settings/pages.ts
+  var CODEXHOST_RELEASES_LATEST_URL = "https://github.com/BytePioneer-AI/codex-host/releases/latest";
   var DEFAULT_RENDERER_SETTINGS_PAGE_IDS = [
     "connections",
     "model-pool",
@@ -18493,6 +18565,14 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     row.append(name, value);
     return row;
   }
+  function installationLabel(installation, messages) {
+    if (installation === "npm") return messages.updateInstallationNpm;
+    if (installation === "windows-installer") {
+      return messages.updateInstallationWindowsInstaller;
+    }
+    if (installation === "macos-dmg") return messages.updateInstallationMacOsDmg;
+    return messages.updateInstallationUnknown;
+  }
   function isPendingStatus(status) {
     return status !== null && status.phase !== "succeeded" && status.phase !== "failed";
   }
@@ -18501,8 +18581,21 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     if (status.phase === "succeeded") return messages.updateSucceeded;
     if (status.phase === "failed") return status.error ?? messages.updateFailed;
     if (status.phase === "restarting") return messages.updateRestarting;
+    if (status.phase === "downloading") return messages.updateDownloading;
     return messages.updatePreparing;
   }
+  function formatUpdateBytes(value) {
+    if (value < 1024) return `${value} B`;
+    const units = ["KB", "MB", "GB"];
+    let scaled = value;
+    let unit = "B";
+    for (const nextUnit of units) {
+      scaled /= 1024;
+      unit = nextUnit;
+      if (scaled < 1024 || nextUnit === units.at(-1)) break;
+    }
+    return `${scaled.toFixed(scaled >= 10 ? 0 : 1)} ${unit}`;
+  }
   function updatesPage(messages, getClient) {
     return Object.freeze({
       id: "updates",
@@ -18513,10 +18606,39 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
         const heading = document2.createElement("div");
         heading.className = "settings-section-label";
         heading.textContent = messages.pageLabels.updates;
+        const metadata = document2.createElement("div");
+        metadata.className = "settings-update-metadata";
+        const currentVersion = document2.createElement("div");
+        currentVersion.className = "settings-update-metadata__item";
+        const currentVersionLabel = document2.createElement("span");
+        currentVersionLabel.textContent = messages.updateCurrentVersion;
+        const currentVersionValue = document2.createElement("strong");
+        currentVersionValue.textContent = "-";
+        currentVersion.append(currentVersionLabel, currentVersionValue);
+        const installation = document2.createElement("div");
+        installation.className = "settings-update-metadata__item";
+        const installationName = document2.createElement("span");
+        installationName.textContent = messages.updateInstallation;
+        const installationValue = document2.createElement("strong");
+        installationValue.textContent = "-";
+        installation.append(installationName, installationValue);
+        metadata.append(currentVersion, installation);
         const panel = document2.createElement("section");
         panel.className = "settings-update-panel";
         panel.setAttribute("aria-live", "polite");
-        context.content.append(heading, panel);
+        const actions = document2.createElement("div");
+        actions.className = "settings-update-actions";
+        const releaseLink = document2.createElement("a");
+        releaseLink.className = "settings-update-link";
+        releaseLink.href = CODEXHOST_RELEASES_LATEST_URL;
+        releaseLink.target = "_blank";
+        releaseLink.rel = "noopener noreferrer";
+        releaseLink.append(
+          messages.updateDownloadFromReleases,
+          createRendererSettingsIcon("external-link", 14)
+        );
+        actions.append(releaseLink);
+        context.content.append(heading, metadata, panel, actions);
         let pollTimer;
         let pollAttempts = 0;
         let pending = false;
@@ -18535,22 +18657,35 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
           copy.textContent = detail;
           panel.append(title, copy);
         };
+        const renderRequestFailure = (error51) => {
+          renderPendingStatus(
+            null,
+            error51 instanceof RendererUpdateRequestTimeoutError ? messages.updateRequestTimeout : error51 instanceof Error ? error51.message : messages.updateFailed,
+            "failed"
+          );
+        };
         const scheduleStatusPoll = (client, resetAttempts = false) => {
           clearPoll();
           if (resetAttempts) pollAttempts = 0;
-          if (pollAttempts >= 320) return;
+          if (pollAttempts >= 320) {
+            renderPendingStatus(null, messages.updateRequestTimeout, "failed");
+            return;
+          }
           pollAttempts += 1;
           pollTimer = document2.defaultView?.setTimeout(() => {
-            void context.runLatest(() => client.readUpdateStatus(), {
-              success(result) {
-                const message = statusMessage(result.status, messages);
-                if (isPendingStatus(result.status)) scheduleStatusPoll(client);
-                if (message) renderPendingStatus(result.status, message);
-              },
-              failure(error51) {
-                renderUnavailable(error51 instanceof Error ? error51.message : messages.updateFailed);
+            void context.runLatest(
+              (signal) => runBoundedRendererUpdateRequest(() => client.readUpdateStatus(), signal),
+              {
+                success(result) {
+                  const message = statusMessage(result.status, messages);
+                  if (isPendingStatus(result.status)) scheduleStatusPoll(client);
+                  if (message) renderPendingStatus(result.status, message);
+                },
+                failure(error51) {
+                  renderRequestFailure(error51);
+                }
               }
-            });
+            );
           }, 750);
         };
         const renderPendingStatus = (status, message, viewPhase = status?.phase ?? "pending") => {
@@ -18559,6 +18694,21 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
           const state = document2.createElement("strong");
           state.textContent = message;
           panel.append(state);
+          if (status?.phase === "downloading" && status.totalBytes !== void 0 && status.downloadedBytes !== void 0) {
+            const progress = document2.createElement("progress");
+            progress.className = "settings-update-progress";
+            progress.max = status.totalBytes;
+            progress.value = Math.min(status.downloadedBytes, status.totalBytes);
+            progress.setAttribute("aria-label", messages.updateDownloading);
+            const detail = document2.createElement("span");
+            detail.className = "settings-update-progress-detail";
+            const percent = Math.min(
+              100,
+              Math.round(status.downloadedBytes / status.totalBytes * 1e3) / 10
+            );
+            detail.textContent = `${percent}% \xB7 ${formatUpdateBytes(status.downloadedBytes)} / ${formatUpdateBytes(status.totalBytes)}`;
+            panel.append(progress, detail);
+          }
           if (viewPhase === "failed") {
             const retry = document2.createElement("button");
             retry.type = "button";
@@ -18572,26 +18722,28 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
           if (pending) return;
           pending = true;
           renderPendingStatus(null, messages.updatePreparing);
-          void context.runLatest(() => client.startUpdate(), {
-            success(result) {
-              pending = false;
-              renderPendingStatus(
-                result.status,
-                statusMessage(result.status, messages) ?? messages.updatePreparing
-              );
-              if (isPendingStatus(result.status)) scheduleStatusPoll(client, true);
-            },
-            failure(error51) {
-              pending = false;
-              renderPendingStatus(
-                null,
-                error51 instanceof Error ? error51.message : messages.updateFailed,
-                "failed"
-              );
+          void context.runLatest(
+            (signal) => runBoundedRendererUpdateRequest(() => client.startUpdate(), signal),
+            {
+              success(result) {
+                pending = false;
+                renderPendingStatus(
+                  result.status,
+                  statusMessage(result.status, messages) ?? messages.updatePreparing
+                );
+                if (isPendingStatus(result.status)) scheduleStatusPoll(client, true);
+              },
+              failure(error51) {
+                pending = false;
+                renderRequestFailure(error51);
+              }
             }
-          });
+          );
         };
         const renderCheck = (result, client) => {
+          currentVersionValue.textContent = `v${result.currentVersion}`;
+          installationValue.textContent = installationLabel(result.installation, messages);
+          if (result.releaseNotesUrl) releaseLink.href = result.releaseNotesUrl;
           const operationMessage = statusMessage(result.status, messages);
           if (isPendingStatus(result.status)) {
             renderPendingStatus(result.status, operationMessage ?? messages.updatePreparing);
@@ -18599,9 +18751,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
             return;
           }
           panel.dataset.updateState = result.error ? "error" : result.updateAvailable ? "available" : "current";
-          panel.replaceChildren(
-            versionRow(context, messages.updateCurrentVersion, result.currentVersion)
-          );
+          panel.replaceChildren();
           if (result.latestVersion) {
             panel.append(versionRow(context, messages.updateLatestVersion, result.latestVersion));
           }
@@ -18629,15 +18779,6 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
             update.addEventListener("click", () => start(client));
             panel.append(update);
           }
-          if (result.releaseNotesUrl) {
-            const notes = document2.createElement("a");
-            notes.className = "settings-update-link";
-            notes.href = result.releaseNotesUrl;
-            notes.target = "_blank";
-            notes.rel = "noopener noreferrer";
-            notes.append(messages.updateViewRelease, createRendererSettingsIcon("external-link", 14));
-            panel.append(notes);
-          }
           if (result.error) {
             const error51 = document2.createElement("p");
             error51.className = "settings-update-error";
@@ -18657,17 +18798,20 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
             return Promise.resolve();
           }
           pending = true;
-          renderPendingStatus(null, messages.updatePreparing);
-          return context.runLatest(() => client.checkUpdate(), {
-            success(result) {
-              pending = false;
-              renderCheck(result, client);
-            },
-            failure(error51) {
-              pending = false;
-              renderUnavailable(error51 instanceof Error ? error51.message : messages.updateFailed);
+          renderPendingStatus(null, messages.updateChecking);
+          return context.runLatest(
+            (signal) => runBoundedRendererUpdateRequest(() => client.checkUpdate(), signal),
+            {
+              success(result) {
+                pending = false;
+                renderCheck(result, client);
+              },
+              failure(error51) {
+                pending = false;
+                renderRequestFailure(error51);
+              }
             }
-          });
+          );
         };
         void load();
         return clearPoll;
@@ -18690,7 +18834,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   }
 
   // src/settings/shell.css
-  var shell_default = ':host {\n  --settings-bg: #181818;\n  --settings-sidebar: #1c1c1c;\n  --settings-panel: transparent;\n  --settings-text: #f5f5f5;\n  --settings-muted: #a1a1a1;\n  --settings-border: rgb(255 255 255 / 10%);\n  --settings-divider: rgb(255 255 255 / 10%);\n  --settings-hover: rgb(255 255 255 / 6%);\n  --settings-active: rgb(51 156 255 / 12%);\n  --settings-focus: #339cff;\n  color: var(--settings-text);\n  color-scheme: dark;\n  font:\n    14px/1.5 system-ui,\n    -apple-system,\n    BlinkMacSystemFont,\n    "Segoe UI",\n    sans-serif;\n  letter-spacing: 0;\n}\n\n*,\n*::before,\n*::after {\n  box-sizing: border-box;\n  letter-spacing: 0;\n}\n\nbutton,\ninput,\nselect {\n  font: inherit;\n}\n\nbutton {\n  color: inherit;\n}\n\n[hidden] {\n  display: none !important;\n}\n\n.codexhost-settings-dialog {\n  width: min(1120px, calc(100vw - 32px));\n  height: min(780px, calc(100vh - 32px));\n  max-width: none;\n  max-height: none;\n  margin: auto;\n  padding: 0;\n  overflow: hidden;\n  color: var(--settings-text);\n  background: var(--settings-bg);\n  border: 1px solid var(--settings-border);\n  border-radius: 12px;\n  box-shadow: 0 24px 64px rgb(0 0 0 / 38%);\n}\n\n.codexhost-settings-dialog::backdrop {\n  background: rgb(0 0 0 / 52%);\n}\n\n.settings-frame,\n.settings-layout {\n  width: 100%;\n  height: 100%;\n  min-width: 0;\n  min-height: 0;\n}\n\n.settings-frame {\n  display: flex;\n  flex-direction: column;\n}\n\n.settings-layout {\n  flex: 1;\n  display: grid;\n  grid-template-columns: 240px minmax(0, 1fr);\n  background: var(--settings-bg);\n}\n\n.settings-sidebar {\n  display: flex;\n  min-width: 0;\n  min-height: 0;\n  flex-direction: column;\n  overflow: hidden;\n  background: var(--settings-sidebar);\n  border-right: 1px solid var(--settings-border);\n  padding-top: 28px;\n}\n\n.settings-header {\n  display: flex;\n  align-items: center;\n  min-width: 0;\n  height: 64px;\n  flex: none;\n  padding: 0 16px;\n  border-bottom: 1px solid var(--settings-border);\n}\n\n.settings-brand {\n  display: flex;\n  align-items: center;\n  min-width: 0;\n  gap: 8px;\n}\n\n.settings-brand__mark {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 36px;\n  height: 36px;\n  flex: none;\n  color: var(--settings-text);\n}\n\n.settings-brand__mark .codexhost-settings-icon {\n  width: 32px;\n  height: 32px;\n  object-fit: contain;\n}\n\n.settings-brand__copy {\n  display: flex;\n  min-width: 0;\n  align-items: baseline;\n  gap: 0;\n  line-height: 20px;\n}\n\n.settings-brand__name {\n  overflow: hidden;\n  color: var(--settings-text);\n  font-size: 14px;\n  font-weight: 500;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.settings-brand__title {\n  margin-left: 14px;\n  padding-left: 14px;\n  color: var(--settings-muted);\n  font-size: 14px;\n  font-weight: 400;\n  border-left: 1px solid var(--settings-border);\n}\n\n.settings-nav {\n  display: flex;\n  min-width: 0;\n  min-height: 0;\n  flex: 1;\n  flex-direction: column;\n  gap: 4px;\n  padding: 0 12px 16px;\n  overflow-y: auto;\n}\n\n.settings-nav-button {\n  display: grid;\n  grid-template-columns: 16px minmax(0, 1fr);\n  align-items: center;\n  width: 100%;\n  position: relative;\n  min-height: 40px;\n  flex: none;\n  gap: 12px;\n  padding: 8px 12px;\n  color: var(--settings-text);\n  font-size: 14px;\n  line-height: 21px;\n  text-align: left;\n  background: transparent;\n  border: 0;\n  border-radius: 10px;\n  cursor: pointer;\n}\n\n.settings-nav-button .codexhost-settings-icon {\n  width: 18px;\n  height: 18px;\n  opacity: 0.9;\n}\n\n.settings-nav-button:hover {\n  background: var(--settings-hover);\n}\n\n.settings-nav-button[aria-current="page"] {\n  background: var(--settings-active);\n  color: var(--settings-focus);\n}\n\n.settings-nav-button[aria-current="page"]::before {\n  position: absolute;\n  left: 0;\n  width: 3px;\n  height: 22px;\n  content: "";\n  background: var(--settings-focus);\n  border-radius: 0 3px 3px 0;\n}\n\n.settings-nav-button span {\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.settings-icon-button {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 28px;\n  height: 28px;\n  flex: none;\n  padding: 0;\n  color: var(--settings-muted);\n  background: transparent;\n  border: 0;\n  border-radius: 8px;\n  cursor: pointer;\n}\n\n.settings-icon-button:hover {\n  color: var(--settings-text);\n  background: var(--settings-hover);\n}\n\n.settings-icon-button:focus-visible,\n.settings-nav-button:focus-visible {\n  outline: 2px solid var(--settings-focus);\n  outline-offset: 1px;\n}\n\n.settings-page {\n  display: block;\n  position: relative;\n  min-width: 0;\n  min-height: 0;\n  overflow-y: auto;\n  background: var(--settings-bg);\n  scrollbar-gutter: stable;\n}\n\n.settings-page__content {\n  width: min(930px, calc(100% - 80px));\n  margin-inline: auto;\n}\n\n.settings-page__content {\n  min-width: 0;\n  padding: 44px 0 56px;\n}\n\n.settings-section-label {\n  min-height: auto;\n  padding: 0 0 28px;\n  color: var(--settings-text);\n  font-size: 24px;\n  font-weight: 600;\n  line-height: 30px;\n}\n\n.settings-status-list,\n.settings-empty {\n  overflow: hidden;\n  background: var(--settings-panel);\n}\n\n.settings-status-row {\n  display: grid;\n  grid-template-columns: minmax(170px, 1fr) auto minmax(280px, 1.45fr);\n  position: relative;\n  align-items: center;\n  min-height: 88px;\n  gap: 28px;\n  padding: 16px 0;\n}\n\n.settings-status-row:not(:last-child)::after {\n  content: "";\n  position: absolute;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  height: 1px;\n  background: var(--settings-divider);\n}\n\n.settings-status-row__identity {\n  display: inline-flex;\n  align-items: center;\n  min-width: 0;\n  color: var(--settings-text);\n  gap: 14px;\n  font-size: 15px;\n  font-weight: 500;\n  line-height: 22px;\n}\n\n.settings-status-row__icon {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 44px;\n  height: 44px;\n  flex: none;\n  color: var(--settings-muted);\n  background: rgb(255 255 255 / 7%);\n  border-radius: 50%;\n}\n\n.settings-status-badge {\n  flex: none;\n  padding: 5px 12px;\n  color: var(--settings-muted);\n  font-size: 13px;\n  font-weight: 500;\n  line-height: 18px;\n  background: rgb(255 255 255 / 9%);\n  border: 1px solid rgb(255 255 255 / 6%);\n  border-radius: 6px;\n}\n\n.settings-status-row__detail {\n  min-width: 0;\n  color: var(--settings-muted);\n  font-size: 13px;\n  line-height: 20px;\n}\n\n.settings-empty {\n  display: flex;\n  align-items: center;\n  min-height: 72px;\n  padding: 12px 16px;\n}\n\n.settings-empty > div {\n  display: grid;\n  min-width: 0;\n  gap: 2px;\n}\n\n.settings-empty strong {\n  color: var(--settings-text);\n  font-size: 13px;\n  font-weight: 500;\n  line-height: 19px;\n}\n\n.settings-empty span {\n  color: var(--settings-muted);\n  font-size: 13px;\n  line-height: 19px;\n}\n\n.settings-page-error {\n  padding: 16px;\n  color: var(--settings-text);\n  font-size: 13px;\n  background: var(--settings-panel);\n  border: 1px solid var(--settings-border);\n  border-radius: 20px;\n}\n\n.settings-update-panel {\n  display: grid;\n  gap: 16px;\n  min-height: 128px;\n  padding: 20px;\n  color: var(--settings-text);\n  background: var(--settings-panel);\n  border: 1px solid var(--settings-border);\n  border-radius: 8px;\n}\n\n.settings-update-panel > strong,\n.settings-update-panel > span,\n.settings-update-summary,\n.settings-update-error {\n  margin: 0;\n  overflow-wrap: anywhere;\n  font-size: 13px;\n  line-height: 20px;\n}\n\n.settings-update-panel > span,\n.settings-update-summary {\n  color: var(--settings-muted);\n}\n\n.settings-update-error {\n  color: #ef4444;\n}\n\n.settings-update-notes {\n  max-height: 240px;\n  padding: 14px;\n  overflow: auto;\n  color: var(--settings-muted);\n  font-size: 13px;\n  line-height: 20px;\n  white-space: pre-wrap;\n  overflow-wrap: anywhere;\n  background: rgb(255 255 255 / 4%);\n  border: 1px solid var(--settings-divider);\n  border-radius: 6px;\n}\n\n.settings-update-version-row {\n  display: grid;\n  grid-template-columns: minmax(0, 1fr) auto;\n  align-items: center;\n  gap: 20px;\n  min-height: 32px;\n  color: var(--settings-muted);\n  font-size: 13px;\n}\n\n.settings-update-version-row strong {\n  color: var(--settings-text);\n  font-size: 15px;\n}\n\n.settings-command-button,\n.settings-update-link {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: fit-content;\n  min-height: 36px;\n  gap: 8px;\n  padding: 8px 12px;\n  color: white;\n  font: inherit;\n  font-size: 13px;\n  text-decoration: none;\n  background: #1677d2;\n  border: 1px solid #238be8;\n  border-radius: 6px;\n  cursor: pointer;\n}\n\n.settings-command-button--secondary,\n.settings-update-link {\n  color: var(--settings-text);\n  background: transparent;\n  border-color: var(--settings-border);\n}\n\n.settings-command-button:hover,\n.settings-update-link:hover {\n  filter: brightness(1.08);\n}\n\n.settings-command-button:focus-visible,\n.settings-update-link:focus-visible {\n  outline: 2px solid var(--settings-focus);\n  outline-offset: 2px;\n}\n\n.codexhost-settings-icon {\n  display: block;\n  flex: none;\n  stroke: currentColor;\n}\n\n@media (max-width: 720px) {\n  .codexhost-settings-dialog {\n    width: calc(100vw - 16px);\n    height: calc(100vh - 16px);\n    border-radius: 10px;\n  }\n\n  .settings-layout {\n    grid-template-columns: minmax(0, 1fr);\n    grid-template-rows: auto minmax(0, 1fr);\n  }\n\n  .settings-sidebar {\n    border-right: 0;\n    border-bottom: 1px solid var(--settings-border);\n  }\n\n  .settings-header {\n    height: 56px;\n    padding-inline: 14px;\n  }\n\n  .settings-sidebar {\n    padding-top: 20px;\n  }\n\n  .settings-nav {\n    flex: none;\n    flex-direction: row;\n    gap: 4px;\n    padding: 7px 8px 8px;\n    overflow-x: auto;\n    overflow-y: hidden;\n  }\n\n  .settings-nav-button {\n    width: auto;\n    min-width: max-content;\n    min-height: 34px;\n    grid-template-columns: 16px auto;\n    border-radius: 10px;\n  }\n\n  .settings-page__content {\n    width: calc(100% - 40px);\n  }\n\n  .settings-page__content {\n    padding-top: 32px;\n    padding-bottom: 32px;\n  }\n\n  .settings-section-label {\n    padding-bottom: 20px;\n    font-size: 20px;\n    line-height: 26px;\n  }\n\n  .settings-status-row {\n    grid-template-columns: minmax(0, 1fr) auto;\n    gap: 16px;\n  }\n\n  .settings-status-row__detail {\n    grid-column: 1 / -1;\n    margin: -8px 0 0 58px;\n  }\n}\n\n@media (forced-colors: active) {\n  :host,\n  :host([data-theme="dark"]) {\n    --settings-bg: Canvas;\n    --settings-sidebar: Canvas;\n    --settings-panel: Canvas;\n    --settings-text: CanvasText;\n    --settings-muted: GrayText;\n    --settings-border: ButtonBorder;\n    --settings-divider: ButtonBorder;\n    --settings-hover: Highlight;\n    --settings-active: Highlight;\n    --settings-focus: Highlight;\n  }\n}\n\n@media (prefers-reduced-motion: reduce) {\n  *,\n  *::before,\n  *::after {\n    scroll-behavior: auto !important;\n  }\n}\n';
+  var shell_default = ':host {\n  --settings-bg: #181818;\n  --settings-sidebar: #1c1c1c;\n  --settings-panel: transparent;\n  --settings-text: #f5f5f5;\n  --settings-muted: #a1a1a1;\n  --settings-border: rgb(255 255 255 / 10%);\n  --settings-divider: rgb(255 255 255 / 10%);\n  --settings-hover: rgb(255 255 255 / 6%);\n  --settings-active: rgb(51 156 255 / 12%);\n  --settings-focus: #339cff;\n  color: var(--settings-text);\n  color-scheme: dark;\n  font:\n    14px/1.5 system-ui,\n    -apple-system,\n    BlinkMacSystemFont,\n    "Segoe UI",\n    sans-serif;\n  letter-spacing: 0;\n}\n\n*,\n*::before,\n*::after {\n  box-sizing: border-box;\n  letter-spacing: 0;\n}\n\nbutton,\ninput,\nselect {\n  font: inherit;\n}\n\nbutton {\n  color: inherit;\n}\n\n[hidden] {\n  display: none !important;\n}\n\n.codexhost-settings-dialog {\n  width: min(1120px, calc(100vw - 32px));\n  height: min(780px, calc(100vh - 32px));\n  max-width: none;\n  max-height: none;\n  margin: auto;\n  padding: 0;\n  overflow: hidden;\n  color: var(--settings-text);\n  background: var(--settings-bg);\n  border: 1px solid var(--settings-border);\n  border-radius: 12px;\n  box-shadow: 0 24px 64px rgb(0 0 0 / 38%);\n}\n\n.codexhost-settings-dialog::backdrop {\n  background: rgb(0 0 0 / 52%);\n}\n\n.settings-frame,\n.settings-layout {\n  width: 100%;\n  height: 100%;\n  min-width: 0;\n  min-height: 0;\n}\n\n.settings-frame {\n  display: flex;\n  flex-direction: column;\n}\n\n.settings-layout {\n  flex: 1;\n  display: grid;\n  grid-template-columns: 240px minmax(0, 1fr);\n  background: var(--settings-bg);\n}\n\n.settings-sidebar {\n  display: flex;\n  min-width: 0;\n  min-height: 0;\n  flex-direction: column;\n  overflow: hidden;\n  background: var(--settings-sidebar);\n  border-right: 1px solid var(--settings-border);\n  padding-top: 28px;\n}\n\n.settings-header {\n  display: flex;\n  align-items: center;\n  min-width: 0;\n  height: 64px;\n  flex: none;\n  padding: 0 16px;\n  border-bottom: 1px solid var(--settings-border);\n}\n\n.settings-brand {\n  display: flex;\n  align-items: center;\n  min-width: 0;\n  gap: 8px;\n}\n\n.settings-brand__mark {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 36px;\n  height: 36px;\n  flex: none;\n  color: var(--settings-text);\n}\n\n.settings-brand__mark .codexhost-settings-icon {\n  width: 32px;\n  height: 32px;\n  object-fit: contain;\n}\n\n.settings-brand__copy {\n  display: flex;\n  min-width: 0;\n  align-items: baseline;\n  gap: 0;\n  line-height: 20px;\n}\n\n.settings-brand__name {\n  overflow: hidden;\n  color: var(--settings-text);\n  font-size: 14px;\n  font-weight: 500;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.settings-brand__title {\n  margin-left: 14px;\n  padding-left: 14px;\n  color: var(--settings-muted);\n  font-size: 14px;\n  font-weight: 400;\n  border-left: 1px solid var(--settings-border);\n}\n\n.settings-nav {\n  display: flex;\n  min-width: 0;\n  min-height: 0;\n  flex: 1;\n  flex-direction: column;\n  gap: 4px;\n  padding: 0 12px 16px;\n  overflow-y: auto;\n}\n\n.settings-nav-button {\n  display: grid;\n  grid-template-columns: 16px minmax(0, 1fr);\n  align-items: center;\n  width: 100%;\n  position: relative;\n  min-height: 40px;\n  flex: none;\n  gap: 12px;\n  padding: 8px 12px;\n  color: var(--settings-text);\n  font-size: 14px;\n  line-height: 21px;\n  text-align: left;\n  background: transparent;\n  border: 0;\n  border-radius: 10px;\n  cursor: pointer;\n}\n\n.settings-nav-button .codexhost-settings-icon {\n  width: 18px;\n  height: 18px;\n  opacity: 0.9;\n}\n\n.settings-nav-button:hover {\n  background: var(--settings-hover);\n}\n\n.settings-nav-button[aria-current="page"] {\n  background: var(--settings-active);\n  color: var(--settings-focus);\n}\n\n.settings-nav-button[aria-current="page"]::before {\n  position: absolute;\n  left: 0;\n  width: 3px;\n  height: 22px;\n  content: "";\n  background: var(--settings-focus);\n  border-radius: 0 3px 3px 0;\n}\n\n.settings-nav-button span {\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.settings-icon-button {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 28px;\n  height: 28px;\n  flex: none;\n  padding: 0;\n  color: var(--settings-muted);\n  background: transparent;\n  border: 0;\n  border-radius: 8px;\n  cursor: pointer;\n}\n\n.settings-icon-button:hover {\n  color: var(--settings-text);\n  background: var(--settings-hover);\n}\n\n.settings-icon-button:focus-visible,\n.settings-nav-button:focus-visible {\n  outline: 2px solid var(--settings-focus);\n  outline-offset: 1px;\n}\n\n.settings-page {\n  display: block;\n  position: relative;\n  min-width: 0;\n  min-height: 0;\n  overflow-y: auto;\n  background: var(--settings-bg);\n  scrollbar-gutter: stable;\n}\n\n.settings-page__content {\n  width: min(930px, calc(100% - 80px));\n  margin-inline: auto;\n}\n\n.settings-page__content {\n  min-width: 0;\n  padding: 44px 0 56px;\n}\n\n.settings-section-label {\n  min-height: auto;\n  padding: 0 0 28px;\n  color: var(--settings-text);\n  font-size: 24px;\n  font-weight: 600;\n  line-height: 30px;\n}\n\n.settings-status-list,\n.settings-empty {\n  overflow: hidden;\n  background: var(--settings-panel);\n}\n\n.settings-status-row {\n  display: grid;\n  grid-template-columns: minmax(170px, 1fr) auto minmax(280px, 1.45fr);\n  position: relative;\n  align-items: center;\n  min-height: 88px;\n  gap: 28px;\n  padding: 16px 0;\n}\n\n.settings-status-row:not(:last-child)::after {\n  content: "";\n  position: absolute;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  height: 1px;\n  background: var(--settings-divider);\n}\n\n.settings-status-row__identity {\n  display: inline-flex;\n  align-items: center;\n  min-width: 0;\n  color: var(--settings-text);\n  gap: 14px;\n  font-size: 15px;\n  font-weight: 500;\n  line-height: 22px;\n}\n\n.settings-status-row__icon {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 44px;\n  height: 44px;\n  flex: none;\n  color: var(--settings-muted);\n  background: rgb(255 255 255 / 7%);\n  border-radius: 50%;\n}\n\n.settings-status-badge {\n  flex: none;\n  padding: 5px 12px;\n  color: var(--settings-muted);\n  font-size: 13px;\n  font-weight: 500;\n  line-height: 18px;\n  background: rgb(255 255 255 / 9%);\n  border: 1px solid rgb(255 255 255 / 6%);\n  border-radius: 6px;\n}\n\n.settings-status-row__detail {\n  min-width: 0;\n  color: var(--settings-muted);\n  font-size: 13px;\n  line-height: 20px;\n}\n\n.settings-empty {\n  display: flex;\n  align-items: center;\n  min-height: 72px;\n  padding: 12px 16px;\n}\n\n.settings-empty > div {\n  display: grid;\n  min-width: 0;\n  gap: 2px;\n}\n\n.settings-empty strong {\n  color: var(--settings-text);\n  font-size: 13px;\n  font-weight: 500;\n  line-height: 19px;\n}\n\n.settings-empty span {\n  color: var(--settings-muted);\n  font-size: 13px;\n  line-height: 19px;\n}\n\n.settings-page-error {\n  padding: 16px;\n  color: var(--settings-text);\n  font-size: 13px;\n  background: var(--settings-panel);\n  border: 1px solid var(--settings-border);\n  border-radius: 20px;\n}\n\n.settings-update-metadata {\n  display: grid;\n  grid-template-columns: repeat(2, minmax(0, 1fr));\n  gap: 24px;\n  margin-bottom: 24px;\n  padding: 0 4px 20px;\n  border-bottom: 1px solid var(--settings-divider);\n}\n\n.settings-update-metadata__item {\n  display: grid;\n  min-width: 0;\n  gap: 4px;\n}\n\n.settings-update-metadata__item span {\n  color: var(--settings-muted);\n  font-size: 12px;\n  line-height: 18px;\n}\n\n.settings-update-metadata__item strong {\n  min-width: 0;\n  overflow-wrap: anywhere;\n  color: var(--settings-text);\n  font-size: 15px;\n  font-weight: 500;\n  line-height: 22px;\n}\n\n.settings-update-panel {\n  display: grid;\n  gap: 16px;\n  min-height: 128px;\n  padding: 20px;\n  color: var(--settings-text);\n  background: var(--settings-panel);\n  border: 1px solid var(--settings-border);\n  border-radius: 8px;\n}\n\n.settings-update-panel > strong,\n.settings-update-panel > span,\n.settings-update-summary,\n.settings-update-error {\n  margin: 0;\n  overflow-wrap: anywhere;\n  font-size: 13px;\n  line-height: 20px;\n}\n\n.settings-update-panel > span,\n.settings-update-summary {\n  color: var(--settings-muted);\n}\n\n.settings-update-error {\n  color: #ef4444;\n}\n\n.settings-update-progress {\n  width: 100%;\n  height: 8px;\n  accent-color: #238be8;\n}\n\n.settings-update-progress-detail {\n  color: var(--settings-muted);\n  font-size: 12px;\n  line-height: 18px;\n}\n\n.settings-update-notes {\n  max-height: 240px;\n  padding: 14px;\n  overflow: auto;\n  color: var(--settings-muted);\n  font-size: 13px;\n  line-height: 20px;\n  white-space: pre-wrap;\n  overflow-wrap: anywhere;\n  background: rgb(255 255 255 / 4%);\n  border: 1px solid var(--settings-divider);\n  border-radius: 6px;\n}\n\n.settings-update-version-row {\n  display: grid;\n  grid-template-columns: minmax(0, 1fr) auto;\n  align-items: center;\n  gap: 20px;\n  min-height: 32px;\n  color: var(--settings-muted);\n  font-size: 13px;\n}\n\n.settings-update-version-row strong {\n  color: var(--settings-text);\n  font-size: 15px;\n}\n\n.settings-update-actions {\n  display: flex;\n  min-width: 0;\n  margin-top: 16px;\n}\n\n.settings-command-button,\n.settings-update-link {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: fit-content;\n  min-height: 36px;\n  gap: 8px;\n  padding: 8px 12px;\n  color: white;\n  font: inherit;\n  font-size: 13px;\n  text-decoration: none;\n  background: #1677d2;\n  border: 1px solid #238be8;\n  border-radius: 6px;\n  cursor: pointer;\n}\n\n.settings-command-button--secondary,\n.settings-update-link {\n  color: var(--settings-text);\n  background: transparent;\n  border-color: var(--settings-border);\n}\n\n.settings-command-button:hover,\n.settings-update-link:hover {\n  filter: brightness(1.08);\n}\n\n.settings-command-button:focus-visible,\n.settings-update-link:focus-visible {\n  outline: 2px solid var(--settings-focus);\n  outline-offset: 2px;\n}\n\n.codexhost-settings-icon {\n  display: block;\n  flex: none;\n  stroke: currentColor;\n}\n\n@media (max-width: 720px) {\n  .codexhost-settings-dialog {\n    width: calc(100vw - 16px);\n    height: calc(100vh - 16px);\n    border-radius: 10px;\n  }\n\n  .settings-layout {\n    grid-template-columns: minmax(0, 1fr);\n    grid-template-rows: auto minmax(0, 1fr);\n  }\n\n  .settings-sidebar {\n    border-right: 0;\n    border-bottom: 1px solid var(--settings-border);\n  }\n\n  .settings-header {\n    height: 56px;\n    padding-inline: 14px;\n  }\n\n  .settings-sidebar {\n    padding-top: 20px;\n  }\n\n  .settings-nav {\n    flex: none;\n    flex-direction: row;\n    gap: 4px;\n    padding: 7px 8px 8px;\n    overflow-x: auto;\n    overflow-y: hidden;\n  }\n\n  .settings-nav-button {\n    width: auto;\n    min-width: max-content;\n    min-height: 34px;\n    grid-template-columns: 16px auto;\n    border-radius: 10px;\n  }\n\n  .settings-page__content {\n    width: calc(100% - 40px);\n  }\n\n  .settings-page__content {\n    padding-top: 32px;\n    padding-bottom: 32px;\n  }\n\n  .settings-section-label {\n    padding-bottom: 20px;\n    font-size: 20px;\n    line-height: 26px;\n  }\n\n  .settings-status-row {\n    grid-template-columns: minmax(0, 1fr) auto;\n    gap: 16px;\n  }\n\n  .settings-status-row__detail {\n    grid-column: 1 / -1;\n    margin: -8px 0 0 58px;\n  }\n}\n\n@media (forced-colors: active) {\n  :host,\n  :host([data-theme="dark"]) {\n    --settings-bg: Canvas;\n    --settings-sidebar: Canvas;\n    --settings-panel: Canvas;\n    --settings-text: CanvasText;\n    --settings-muted: GrayText;\n    --settings-border: ButtonBorder;\n    --settings-divider: ButtonBorder;\n    --settings-hover: Highlight;\n    --settings-active: Highlight;\n    --settings-focus: Highlight;\n  }\n}\n\n@media (prefers-reduced-motion: reduce) {\n  *,\n  *::before,\n  *::after {\n    scroll-behavior: auto !important;\n  }\n}\n';
 
   // src/settings/shell.ts
   var SETTINGS_SHELL_ATTRIBUTE = "data-codexhost-settings-shell";
@@ -19126,6 +19270,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   }
 
   // src/renderer-settings-lifecycle.ts
+  var UPDATE_CHECK_TIMEOUT_MS = 5e3;
+  var UPDATE_RETRY_DELAYS_MS = [1e3, 3e3, 1e4, 3e4];
   function installRendererSettingsLifecycle(ownerWindow = window, options = {}) {
     const lifecycleController = new AbortController();
     let locale = resolveRendererSettingsLocale(ownerWindow.navigator.languages);
@@ -19133,6 +19279,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     let trigger = null;
     let localeRequest = null;
     let checkedUpdateClient = null;
+    let retryUpdateClient = null;
+    let updateRetryTimer = null;
+    let updateRetryAttempt = 0;
     let updateCheckGeneration = 0;
     let updateAvailable = false;
     let openGeneration = 0;
@@ -19195,16 +19344,65 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
       localeRequest = request;
       return request;
     };
+    const clearUpdateRetry = () => {
+      if (updateRetryTimer === null) return;
+      ownerWindow.clearTimeout(updateRetryTimer);
+      updateRetryTimer = null;
+    };
+    const scheduleUpdateRetry = (client) => {
+      if (disposed || updateRetryTimer !== null) return;
+      const delay = UPDATE_RETRY_DELAYS_MS[updateRetryAttempt];
+      if (delay === void 0) return;
+      updateRetryAttempt += 1;
+      updateRetryTimer = ownerWindow.setTimeout(() => {
+        updateRetryTimer = null;
+        if (disposed || options.getUpdateClient?.() !== client) return;
+        refreshUpdateIndicator();
+      }, delay);
+    };
+    const checkUpdateWithTimeout = (client) => new Promise((resolve, reject) => {
+      const timeout = ownerWindow.setTimeout(
+        () => reject(new Error("Update indicator check timed out")),
+        UPDATE_CHECK_TIMEOUT_MS
+      );
+      void client.checkUpdate().then(
+        (result) => {
+          ownerWindow.clearTimeout(timeout);
+          resolve(result);
+        },
+        (error51) => {
+          ownerWindow.clearTimeout(timeout);
+          reject(error51);
+        }
+      );
+    });
     const refreshUpdateIndicator = () => {
       const client = options.getUpdateClient?.() ?? null;
       if (!client || checkedUpdateClient === client) return;
+      if (retryUpdateClient !== client) {
+        clearUpdateRetry();
+        retryUpdateClient = client;
+        updateRetryAttempt = 0;
+      }
       checkedUpdateClient = client;
       const generation = ++updateCheckGeneration;
-      void client.checkUpdate().then((result) => {
+      void checkUpdateWithTimeout(client).then((result) => {
         if (disposed || generation !== updateCheckGeneration) return;
         updateAvailable = result.updateAvailable;
         trigger?.setUpdateAvailable(updateAvailable);
+        if (result.error === null) {
+          updateRetryAttempt = 0;
+          clearUpdateRetry();
+          return;
+        }
+        checkedUpdateClient = null;
+        scheduleUpdateRetry(client);
       }).catch(() => {
+        if (disposed || generation !== updateCheckGeneration || checkedUpdateClient !== client) {
+          return;
+        }
+        checkedUpdateClient = null;
+        scheduleUpdateRetry(client);
       });
     };
     mount();
@@ -19225,6 +19423,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
         openGeneration += 1;
         updateCheckGeneration += 1;
         lifecycleController.abort();
+        clearUpdateRetry();
         trigger?.dispose();
         shell?.dispose();
         trigger = null;
@@ -20488,6 +20687,14 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
         applyAdapterAgent = applyAgent ?? null;
         modelControl = nextModelControl ?? null;
         adapterStatus = status;
+        const installedModelControl = modelControl;
+        queueMicrotask(() => {
+          if (disposed || modelControl !== installedModelControl) return;
+          try {
+            settingsLifecycle.refresh();
+          } catch {
+          }
+        });
         sidebarAgentIcons.refresh();
         void refreshHarnessAvailability();
         const connected = connectedComposers();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codexhost/cli-darwin-arm64",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Run Pi and Claude Code as first-class external harnesses inside Codex Desktop.",
   "type": "module",
   "files": [