@codexhost/cli-darwin-x64 0.1.4 → 0.1.6

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.4
+npm install -g @codexhost/cli@0.1.6
 ```
 
 Do not install this package directly. npm selects it through the optional dependencies of `@codexhost/cli`.

package/app/codexhost-distribution.json

@@ -1 +1 @@
-{"schemaVersion":1,"version":"0.1.4","distribution":"npm","target":"macos-x64"}
+{"schemaVersion":1,"version":"0.1.6","distribution":"npm","target":"macos-x64"}

package/app/desktop-controller.mjs

@@ -1087,15 +1087,27 @@ var InstalledRendererControlSession = class {
     this.inspector.close();
   }
 };
+var startupTraceStartedAt = Date.now();
+function startupTrace(stage) {
+  if (process.env.CODEXHOST_STARTUP_TRACE !== "1") return;
+  console.error(
+    `[codexhost startup +${Date.now() - startupTraceStartedAt}ms] renderer-session: ${stage}`
+  );
+}
 async function createRendererControlSession(options) {
   const enabledAgents = options.enabledAgents ?? ["codex", "pi"];
   const timeoutMs = options.timeoutMs ?? 3e4;
   const pollIntervalMs = options.pollIntervalMs ?? 250;
   const operations = options.operations ?? defaultOperations;
+  startupTrace("waiting for initial Renderer");
   const initial = await waitForRenderer(options.inspector, operations, timeoutMs, pollIntervalMs);
+  startupTrace("installing title policy");
   const titlePolicy = await operations.installTitlePolicy(options.inspector, initial.id);
+  startupTrace("reloading Renderer");
   await operations.reload(options.inspector, initial.id);
+  startupTrace("waiting for reloaded Renderer");
   const selected = await waitForRenderer(options.inspector, operations, timeoutMs, pollIntervalMs);
+  startupTrace("waiting for title policy readiness");
   const titlePolicyReadiness = await waitForRendererTitlePolicyReady(
     () => operations.markTitlePolicyReady(options.inspector, selected.id),
     {
@@ -1103,7 +1115,9 @@ async function createRendererControlSession(options) {
       pollIntervalMs
     }
   );
+  startupTrace("injecting Renderer bundle");
   await operations.execute(options.inspector, selected.id, options.rendererSource);
+  startupTrace("waiting for Renderer binding");
   const binding = await waitForBinding(
     options.inspector,
     operations,
@@ -1112,6 +1126,7 @@ async function createRendererControlSession(options) {
     timeoutMs,
     pollIntervalMs
   );
+  startupTrace("installing draft prewarm policy");
   const draftPrewarmPolicy = await operations.installDraftPrewarmPolicy(
     options.inspector,
     selected.id
@@ -1135,12 +1150,15 @@ async function createRendererControlSession(options) {
 async function installRendererControlSession(options) {
   const timeoutMs = options.timeoutMs ?? 3e4;
   const pollIntervalMs = options.pollIntervalMs ?? 250;
+  startupTrace("waiting for Electron Inspector target");
   const target = await waitForInspectorTarget(options.inspectorEndpoint, {
     timeoutMs,
     pollIntervalMs
   });
+  startupTrace("connecting to Electron Inspector");
   const inspector = await CdpClient.connect(target.webSocketDebuggerUrl);
   try {
+    startupTrace("enabling Inspector Runtime domain");
     await inspector.command("Runtime.enable");
     return await createRendererControlSession({
       ...options,
@@ -1161,6 +1179,14 @@ var TRANSIENT_INSTALL_ATTEMPTS = 3;
 var TRANSIENT_INSTALL_RETRY_MS = 250;
 var RECOVERY_RETRY_INITIAL_MS = 3e4;
 var RECOVERY_RETRY_MAX_MS = 3e5;
+var startupTraceStartedAt2 = Date.now();
+function startupTrace2(stage, detail) {
+  if (process.env.CODEXHOST_STARTUP_TRACE !== "1") return;
+  const suffix = detail === void 0 ? "" : `: ${detail instanceof Error ? detail.message : String(detail)}`;
+  console.error(
+    `[codexhost startup +${Date.now() - startupTraceStartedAt2}ms] controller: ${stage}${suffix}`
+  );
+}
 function validCompatibilityIssue(state, issue) {
   const keys = Object.keys(issue);
   if (state === "compatible-with-warning") {
@@ -1316,9 +1342,11 @@ async function runDesktopController(options, signal, dependencies = defaultDepen
     recoveryDelayMs = RECOVERY_RETRY_INITIAL_MS;
   };
   const createSession = async () => {
+    startupTrace2("reading Renderer bundle");
     const rendererSource = await dependencies.readRenderer(options.rendererPath);
     if (rendererSource.trim().length === 0) throw new Error("production Renderer Bundle is empty");
-    return installProductionSession(
+    startupTrace2("installing Renderer Session");
+    const installed = await installProductionSession(
       {
         inspectorEndpoint: options.inspectorEndpoint,
         rendererSource: `${configuration}
@@ -1328,11 +1356,15 @@ ${rendererSource}`,
       },
       dependencies
     );
+    startupTrace2("Renderer Session installed");
+    return installed;
   };
+  startupTrace2("initialization started");
   try {
     session = await createSession();
     recordRecoverySuccess();
-  } catch {
+  } catch (error) {
+    startupTrace2("initial Renderer Session unavailable", error);
     session = void 0;
     recordRecoveryFailure();
   }
@@ -1367,6 +1399,7 @@ ${rendererSource}`,
   };
   let attachmentServer;
   try {
+    startupTrace2("starting attachment server");
     attachmentServer = await dependencies.startAttachmentServer({
       port: options.attachmentPort,
       nonce: options.attachmentNonce,
@@ -1383,7 +1416,9 @@ ${rendererSource}`,
         await current.quitDesktop();
       })
     });
+    startupTrace2("attachment server ready");
     const issues = session?.snapshot.titlePolicy.warnings ?? [];
+    startupTrace2("publishing readiness");
     dependencies.ready({
       schemaVersion: 2,
       state: issues.length === 0 ? "compatible" : "compatible-with-warning",

package/app/host-runtime.mjs

@@ -773,10 +773,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path11) {
-  if (!path11)
+function getElementAtPath(obj, path12) {
+  if (!path12)
     return obj;
-  return path11.reduce((acc, key) => acc?.[key], obj);
+  return path12.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -1185,11 +1185,11 @@ function explicitlyAborted(x2, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path11, issues) {
+function prefixIssues(path12, issues) {
   return issues.map((iss) => {
     var _a4;
     (_a4 = iss).path ?? (_a4.path = []);
-    iss.path.unshift(path11);
+    iss.path.unshift(path12);
     return iss;
   });
 }
@@ -1336,16 +1336,16 @@ function flattenError(error52, mapper = (issue2) => issue2.message) {
 }
 function formatError(error52, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error53, path11 = []) => {
+  const processError = (error53, path12 = []) => {
     for (const issue2 of error53.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path11, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path12, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path11, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path12, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path11, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path12, ...issue2.path]);
       } else {
-        const fullpath = [...path11, ...issue2.path];
+        const fullpath = [...path12, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -1372,17 +1372,17 @@ function formatError(error52, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error52, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error53, path11 = []) => {
+  const processError = (error53, path12 = []) => {
     var _a4, _b2;
     for (const issue2 of error53.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path11, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path12, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path11, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path12, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path11, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path12, ...issue2.path]);
       } else {
-        const fullpath = [...path11, ...issue2.path];
+        const fullpath = [...path12, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -1414,8 +1414,8 @@ function treeifyError(error52, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path11 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path11) {
+  const path12 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path12) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -14107,13 +14107,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path11 = ref.slice(1).split("/").filter(Boolean);
-  if (path11.length === 0) {
+  const path12 = ref.slice(1).split("/").filter(Boolean);
+  if (path12.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path11[0] === defsKey) {
-    const key = path11[1];
+  if (path12[0] === defsKey) {
+    const key = path12[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -19111,8 +19111,8 @@ var qU = v(function(BU) {
   BU._globalThis = void 0;
   BU._globalThis = typeof globalThis === "object" ? globalThis : global;
 });
-var GU = v(function(os3) {
-  var Axe = os3 && os3.__createBinding || (Object.create ? function(e, t, r, n) {
+var GU = v(function(os4) {
+  var Axe = os4 && os4.__createBinding || (Object.create ? function(e, t, r, n) {
     if (n === void 0) n = r;
     Object.defineProperty(e, n, { enumerable: true, get: function() {
       return t[r];
@@ -19120,11 +19120,11 @@ var GU = v(function(os3) {
   } : function(e, t, r, n) {
     if (n === void 0) n = r;
     e[n] = t[r];
-  }), kxe = os3 && os3.__exportStar || function(e, t) {
+  }), kxe = os4 && os4.__exportStar || function(e, t) {
     for (var r in e) if (r !== "default" && !Object.prototype.hasOwnProperty.call(t, r)) Axe(t, e, r);
   };
-  Object.defineProperty(os3, "__esModule", { value: true });
-  kxe(qU(), os3);
+  Object.defineProperty(os4, "__esModule", { value: true });
+  kxe(qU(), os4);
 });
 var WU = v(function(is) {
   var Oxe = is && is.__createBinding || (Object.create ? function(e, t, r, n) {
@@ -41033,6 +41033,7 @@ function userInstallCandidates(platform, environment, homeDirectory) {
     ];
   }
   return [
+    path.join(homeDirectory, ".npm-global", "bin", "claude"),
     path.join(homeDirectory, ".local", "bin", "claude"),
     path.join(homeDirectory, ".claude", "local", "claude"),
     ...nvmCandidates(homeDirectory),
@@ -41055,6 +41056,17 @@ function resolveClaudeCodeExecutable(input = {}) {
     throw new ClaudeCodeExecutableError("Claude Code is not installed");
   return path.resolve(executable);
 }
+function withNodeRuntimeOnPath(environment, runtimeExecutable = process.execPath, platform = process.platform) {
+  const pathKey = Object.keys(environment).find((name) => name.toLowerCase() === "path") ?? "PATH";
+  const delimiter = platform === "win32" ? ";" : ":";
+  const runtimeDirectory = path.dirname(runtimeExecutable);
+  const directories = (environment[pathKey] ?? "").split(delimiter).filter(Boolean);
+  const equal = platform === "win32" ? (value) => value.toLowerCase() : (value) => value;
+  if (!directories.some((directory) => equal(directory) === equal(runtimeDirectory))) {
+    directories.unshift(runtimeDirectory);
+  }
+  return { ...environment, [pathKey]: directories.join(delimiter) };
+}
 
 // packages/adapters/claude-code/dist/claude-fork.js
 import path2 from "node:path";
@@ -41687,13 +41699,6 @@ function assistantText(message3) {
     return null;
   return content.flatMap((block) => isRecord4(block) && block.type === "text" && typeof block.text === "string" ? [block.text] : []).join("");
 }
-function assistantReasoning(message3) {
-  const content = assistantContent(message3);
-  if (!content)
-    return null;
-  const blocks = content.filter((block) => isRecord4(block) && block.type === "thinking" && typeof block.thinking === "string");
-  return blocks.length > 0 ? blocks.map((block) => block.thinking).join("") : null;
-}
 function assistantError(message3) {
   return isRecord4(message3) && message3.type === "assistant" && typeof message3.error === "string" ? message3.error : null;
 }
@@ -41732,7 +41737,6 @@ var ClaudeNativeTurnAccumulator = class {
   #messageOrdinal = 0;
   #messages = /* @__PURE__ */ new Map();
   #protocolConflict = false;
-  #reasoningConflict = false;
   #textConflict = false;
   #tools = /* @__PURE__ */ new Map();
   requestCancel() {
@@ -41766,8 +41770,6 @@ var ClaudeNativeTurnAccumulator = class {
     let terminal;
     if (this.#protocolConflict) {
       terminal = failure("protocol");
-    } else if (this.#reasoningConflict) {
-      terminal = failure("reasoningConflict");
     } else if (this.#textConflict) {
       terminal = failure("textConflict");
     } else if (includesAuthenticationFailure(message3, this.#assistantErrors)) {
@@ -41820,8 +41822,6 @@ var ClaudeNativeTurnAccumulator = class {
     if (event.type !== "content_block_delta" || !isRecord4(event.delta))
       return;
     if (state.completed) {
-      if (event.delta.type === "thinking_delta")
-        this.#reasoningConflict = true;
       if (event.delta.type === "text_delta")
         this.#textConflict = true;
       return;
@@ -41846,19 +41846,7 @@ var ClaudeNativeTurnAccumulator = class {
     const state = this.#messageState(messageId);
     if (state.completed)
       return;
-    const completeReasoning = assistantReasoning(message3);
-    if (completeReasoning !== null) {
-      if (completeReasoning.startsWith(state.reasoning)) {
-        const suffix = completeReasoning.slice(state.reasoning.length);
-        if (suffix.length > 0) {
-          state.reasoning += suffix;
-          events.push({ type: "reasoning.delta", messageId, delta: suffix });
-        }
-      } else if (completeReasoning !== state.reasoning) {
-        this.#reasoningConflict = true;
-      }
-    }
-    if (state.reasoning.length > 0 && !this.#reasoningConflict) {
+    if (state.reasoning.length > 0) {
       events.push({ type: "reasoning.completed", messageId });
     }
     const completeText = assistantText(message3);
@@ -41889,7 +41877,7 @@ var ClaudeNativeTurnAccumulator = class {
         arguments: argumentsResult.data
       });
     }
-    if (!this.#protocolConflict && !this.#reasoningConflict && !this.#textConflict) {
+    if (!this.#protocolConflict && !this.#textConflict) {
       events.push({
         type: "message.completed",
         messageId,
@@ -42205,10 +42193,10 @@ var ClaudeSdkTransport = class {
         canUseTool: (toolName, input, options) => this.#canUseTool(toolName, input, options),
         persistSession: true,
         includePartialMessages: true,
-        env: {
+        env: withNodeRuntimeOnPath({
           ...this.#environment,
           CLAUDE_AGENT_SDK_CLIENT_APP: CLIENT_APP
-        },
+        }),
         spawnClaudeCodeProcess: (options) => this.#spawn(options)
       }
     });
@@ -42507,10 +42495,10 @@ var ClaudeSdkModelInspector = class {
         tools: [],
         persistSession: false,
         includePartialMessages: false,
-        env: {
+        env: withNodeRuntimeOnPath({
           ...this.#environment,
           CLAUDE_AGENT_SDK_CLIENT_APP: CLIENT_APP
-        },
+        }),
         spawnClaudeCodeProcess: (options) => this.#spawn(options)
       }
     });
@@ -42719,8 +42707,8 @@ function transportFailure(kind) {
   }
   return {
     code: "nativeFailure",
-    message: kind === "textConflict" ? "Claude Code returned inconsistent streamed text" : kind === "reasoningConflict" ? "Claude Code returned inconsistent streamed reasoning" : kind === "cancellationUnproven" ? "Claude Code cancellation could not be proven" : "Claude Code Turn failed",
-    retryable: kind !== "textConflict" && kind !== "reasoningConflict"
+    message: kind === "textConflict" ? "Claude Code returned inconsistent streamed text" : kind === "cancellationUnproven" ? "Claude Code cancellation could not be proven" : "Claude Code Turn failed",
+    retryable: kind !== "textConflict"
   };
 }
 function startupFailure(error52) {
@@ -44438,8 +44426,79 @@ async function rollbackPiLastTurn(transport, sourceSessionId, cwd) {
 // packages/adapters/pi/dist/pi-rpc-session.js
 import { spawn as spawn2, spawnSync } from "node:child_process";
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { statSync as statSync2 } from "node:fs";
+import path6 from "node:path";
+
+// packages/adapters/pi/dist/command.js
+import { accessSync, constants, readdirSync as readdirSync2, statSync as statSync2 } from "node:fs";
+import os2 from "node:os";
 import path5 from "node:path";
+function environmentValue(environment, name) {
+  return Object.entries(environment).find(([key]) => key.toLowerCase() === name.toLowerCase())?.[1];
+}
+function isExecutable2(filePath, platform) {
+  try {
+    accessSync(filePath, platform === "win32" ? constants.F_OK : constants.X_OK);
+    return statSync2(filePath).isFile();
+  } catch {
+    return false;
+  }
+}
+function pathCandidates(command, platform, environment) {
+  const targetPath = platform === "win32" ? path5.win32 : path5.posix;
+  if (targetPath.isAbsolute(command) || command.includes("/") || command.includes("\\")) {
+    return [command];
+  }
+  const extensions = platform === "win32" && targetPath.extname(command) === "" ? (environmentValue(environment, "PATHEXT") ?? ".COM;.EXE;.BAT;.CMD").split(";").map((extension) => extension.trim()).filter(Boolean) : [""];
+  return (environmentValue(environment, "PATH") ?? "").split(targetPath.delimiter).map((directory) => directory.trim().replace(/^"|"$/gu, "")).filter(Boolean).flatMap((directory) => extensions.map((extension) => targetPath.join(directory, command + extension)));
+}
+function nvmCandidates2(homeDirectory, executableName) {
+  const versionsDirectory = path5.join(homeDirectory, ".nvm", "versions", "node");
+  try {
+    return readdirSync2(versionsDirectory, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort((left, right) => right.localeCompare(left, void 0, { numeric: true })).map((version2) => path5.join(versionsDirectory, version2, "bin", executableName));
+  } catch {
+    return [];
+  }
+}
+function userInstallCandidates2(platform, environment, homeDirectory) {
+  if (platform === "win32") {
+    const appData = environment.APPDATA ?? path5.join(homeDirectory, "AppData", "Roaming");
+    return [
+      path5.join(appData, "npm", "pi.cmd"),
+      path5.join(homeDirectory, ".local", "bin", "pi.exe"),
+      path5.join(homeDirectory, ".local", "bin", "pi.cmd")
+    ];
+  }
+  return [
+    path5.join(homeDirectory, ".npm-global", "bin", "pi"),
+    path5.join(homeDirectory, ".local", "bin", "pi"),
+    ...nvmCandidates2(homeDirectory, "pi"),
+    "/opt/homebrew/bin/pi",
+    "/usr/local/bin/pi"
+  ];
+}
+function resolvePiExecutable(input, dependencies = {}) {
+  const platform = dependencies.platform ?? process.platform;
+  const configuredCommand = input.command ?? input.environment.PI_COMMAND;
+  const command = configuredCommand ?? "pi";
+  const homeDirectory = dependencies.homeDirectory ?? input.environment.HOME ?? input.environment.USERPROFILE ?? os2.homedir();
+  const candidates2 = [
+    ...pathCandidates(command, platform, input.environment),
+    ...configuredCommand ? [] : userInstallCandidates2(platform, input.environment, homeDirectory)
+  ];
+  const check2 = dependencies.isExecutable ?? ((candidate) => isExecutable2(candidate, platform));
+  return candidates2.find(check2) ?? command;
+}
+function withNodeRuntimeOnPath2(environment, runtimeExecutable = process.execPath, platform = process.platform) {
+  const pathKey = Object.keys(environment).find((name) => name.toLowerCase() === "path") ?? "PATH";
+  const delimiter = platform === "win32" ? ";" : ":";
+  const runtimeDirectory = path5.dirname(runtimeExecutable);
+  const directories = (environment[pathKey] ?? "").split(delimiter).filter(Boolean);
+  const equal = platform === "win32" ? (value) => value.toLowerCase() : (value) => value;
+  if (!directories.some((directory) => equal(directory) === equal(runtimeDirectory))) {
+    directories.unshift(runtimeDirectory);
+  }
+  return { ...environment, [pathKey]: directories.join(delimiter) };
+}
 
 // packages/adapters/pi/dist/pi-usage.js
 function isRecord8(value) {
@@ -44684,7 +44743,7 @@ function assistantMessageId(value) {
     return null;
   return nonBlankString(value.responseId) ? value.responseId : null;
 }
-function assistantReasoning2(value) {
+function assistantReasoning(value) {
   if (!isRecord10(value) || value.role !== "assistant" || !Array.isArray(value.content))
     return null;
   return value.content.filter((content) => isRecord10(content) && content.type === "thinking" && typeof content.thinking === "string").map((content) => content.thinking).join("");
@@ -44722,36 +44781,6 @@ function waitForExit(child, timeoutMs) {
     new Promise((resolve2) => setTimeout(() => resolve2(false), timeoutMs))
   ]);
 }
-function environmentValue(environment, name) {
-  return Object.entries(environment).find(([key]) => key.toLowerCase() === name.toLowerCase())?.[1];
-}
-function isRegularFile(filePath) {
-  try {
-    return statSync2(filePath).isFile();
-  } catch {
-    return false;
-  }
-}
-function resolveWindowsCommand(command, environment, isFile) {
-  if (path5.win32.isAbsolute(command) || command.includes("/") || command.includes("\\")) {
-    return command;
-  }
-  const extensions = path5.win32.extname(command) ? [""] : (environmentValue(environment, "PATHEXT") ?? ".COM;.EXE;.BAT;.CMD").split(";").map((extension) => extension.trim()).filter((extension) => extension.length > 0);
-  const pathValue2 = environmentValue(environment, "PATH");
-  if (!pathValue2)
-    return command;
-  for (const rawDirectory of pathValue2.split(path5.win32.delimiter)) {
-    const directory = rawDirectory.trim().replace(/^"|"$/gu, "");
-    if (!directory)
-      continue;
-    for (const extension of extensions) {
-      const candidate = path5.win32.join(directory, `${command}${extension}`);
-      if (isFile(candidate))
-        return candidate;
-    }
-  }
-  return command;
-}
 function piRpcProcessCommand(options, dependencies = {}) {
   if (options.sessionFile && options.forkSessionFile) {
     throw new Error("Pi RPC cannot combine Session resume and Fork startup");
@@ -44760,12 +44789,18 @@ function piRpcProcessCommand(options, dependencies = {}) {
     throw new Error("Pi RPC cannot combine a startup Model with Session restore or Fork");
   }
   const platform = dependencies.platform ?? process.platform;
-  const selectedCommand = options.command ?? options.environment.PI_COMMAND ?? "pi";
-  const command = platform === "win32" ? resolveWindowsCommand(selectedCommand, options.environment, dependencies.isFile ?? isRegularFile) : selectedCommand;
+  const command = resolvePiExecutable({
+    ...options.command ? { command: options.command } : {},
+    environment: options.environment
+  }, {
+    platform,
+    ...dependencies.homeDirectory ? { homeDirectory: dependencies.homeDirectory } : {},
+    ...dependencies.isExecutable ? { isExecutable: dependencies.isExecutable } : {}
+  });
   const sessionArguments = options.forkSessionFile ? ["--fork", options.forkSessionFile] : options.sessionFile ? ["--session", options.sessionFile] : [];
   const modelArguments = options.model ? ["--provider", options.model.provider, "--model", options.model.id] : [];
   const arguments_2 = ["--mode", "rpc", ...modelArguments, ...sessionArguments];
-  const extension = path5.win32.extname(command).toLowerCase();
+  const extension = path6.win32.extname(command).toLowerCase();
   if (platform !== "win32" || ![".cmd", ".bat"].includes(extension)) {
     return { command, arguments: arguments_2, windowsVerbatimArguments: false };
   }
@@ -44829,12 +44864,12 @@ var PiRpcSession = class {
     const child = this.#processAdapter.spawn({
       cwd: this.#options.cwd,
       ...this.#options.command ? { command: this.#options.command } : {},
-      environment: {
+      environment: withNodeRuntimeOnPath2({
         ...process.env,
         ...this.#options.environment,
         PI_SKIP_VERSION_CHECK: "1",
         PI_TELEMETRY: "0"
-      },
+      }),
       ...this.#options.sessionFile ? { sessionFile: this.#options.sessionFile } : {},
       ...this.#options.forkSessionFile ? { forkSessionFile: this.#options.forkSessionFile } : {},
       ...this.#options.model ? { model: this.#options.model } : {}
@@ -45405,7 +45440,7 @@ var PiRpcSession = class {
   }
   #finalizeAssistantMessage(active, value) {
     const finalText = assistantText2(value);
-    const finalReasoning = assistantReasoning2(value);
+    const finalReasoning = assistantReasoning(value);
     const failure2 = assistantFailure(value);
     const cacheHitRatePercent = optionalPiCacheHitRatePercent(value);
     if (finalText === null || finalReasoning === null || failure2 === void 0)
@@ -45668,8 +45703,8 @@ function numberField(value, key) {
   const field = value[key];
   return typeof field === "number" || field === null ? field : void 0;
 }
-function stripDiffPrefix(path11) {
-  return path11.startsWith("a/") || path11.startsWith("b/") ? path11.slice(2) : path11;
+function stripDiffPrefix(path12) {
+  return path12.startsWith("a/") || path12.startsWith("b/") ? path12.slice(2) : path12;
 }
 function reliableFileChange(result) {
   if (!isRecord11(result) || !isRecord11(result.details) || typeof result.details.patch !== "string") {
@@ -45688,10 +45723,10 @@ function reliableFileChange(result) {
   const oldFile = file2.oldFileName;
   const newFile = file2.newFileName;
   const kind = oldFile === "/dev/null" ? "add" : newFile === "/dev/null" ? "delete" : "update";
-  const path11 = stripDiffPrefix(kind === "delete" ? oldFile : newFile);
-  if (!path11 || path11 === "/dev/null")
+  const path12 = stripDiffPrefix(kind === "delete" ? oldFile : newFile);
+  if (!path12 || path12 === "/dev/null")
     return null;
-  return [{ path: path11, kind, unifiedDiff: patch }];
+  return [{ path: path12, kind, unifiedDiff: patch }];
 }
 function delay3(milliseconds) {
   return new Promise((resolve2) => setTimeout(resolve2, milliseconds));
@@ -46915,9 +46950,9 @@ import nodePath from "node:path";
 // packages/mapping-store/dist/mapping-store.js
 import { execFileSync } from "node:child_process";
 import { randomUUID as randomUUID4 } from "node:crypto";
-import { constants } from "node:fs";
+import { constants as constants2 } from "node:fs";
 import { copyFile, mkdir, open as open2, readFile, readdir, rename, rm as rm2, stat } from "node:fs/promises";
-import path6 from "node:path";
+import path7 from "node:path";
 
 // packages/mapping-store/dist/records.js
 var nonBlankTextSchema3 = external_exports.string().refine((value) => value.trim().length > 0, {
@@ -47122,11 +47157,11 @@ var MappingStore = class {
   #initialized = false;
   #lockHandle = null;
   constructor(options) {
-    this.#directory = path6.resolve(options.directory);
-    this.#threadsDirectory = path6.join(this.#directory, "threads");
-    this.#backupsDirectory = path6.join(this.#directory, "backups");
-    this.#quarantineDirectory = path6.join(this.#directory, "quarantine");
-    this.#lockPath = path6.join(this.#directory, "store.lock");
+    this.#directory = path7.resolve(options.directory);
+    this.#threadsDirectory = path7.join(this.#directory, "threads");
+    this.#backupsDirectory = path7.join(this.#directory, "backups");
+    this.#quarantineDirectory = path7.join(this.#directory, "quarantine");
+    this.#lockPath = path7.join(this.#directory, "store.lock");
     this.#instanceId = options.instanceId ?? randomUUID4();
     this.#now = options.now ?? (() => /* @__PURE__ */ new Date());
     this.#beforeReplace = options.beforeReplace;
@@ -47144,8 +47179,8 @@ var MappingStore = class {
       await this.#cleanupTemps();
       const names = (await readdir(this.#threadsDirectory)).filter((name) => name.endsWith(".json"));
       for (const name of names) {
-        const primary = path6.join(this.#threadsDirectory, name);
-        const backup = path6.join(this.#backupsDirectory, name);
+        const primary = path7.join(this.#threadsDirectory, name);
+        const backup = path7.join(this.#backupsDirectory, name);
         let record3 = null;
         try {
           record3 = await this.#readRecord(primary, name);
@@ -47154,7 +47189,7 @@ var MappingStore = class {
             record3 = await this.#readRecord(backup, name);
             await this.#replaceFile(primary, record3, false);
           } catch (backupError) {
-            const quarantine = path6.join(this.#quarantineDirectory, `${name}.${this.#now().getTime()}.invalid`);
+            const quarantine = path7.join(this.#quarantineDirectory, `${name}.${this.#now().getTime()}.invalid`);
             await rename(primary, quarantine).catch(() => void 0);
             void primaryError;
             void backupError;
@@ -47401,7 +47436,7 @@ var MappingStore = class {
     let handle = null;
     try {
       await this.#beforeReplace?.(cloneRecord(record3));
-      handle = await open2(temp, "wx", constants.S_IRUSR | constants.S_IWUSR);
+      handle = await open2(temp, "wx", constants2.S_IRUSR | constants2.S_IWUSR);
       await handle.writeFile(`${JSON.stringify(record3, null, 2)}
 `, "utf8");
       await handle.sync();
@@ -47435,11 +47470,11 @@ var MappingStore = class {
   }
   async #cleanupTemps() {
     const names = await readdir(this.#threadsDirectory);
-    await Promise.all(names.filter((name) => name.includes(".tmp-")).map((name) => rm2(path6.join(this.#threadsDirectory, name), { force: true })));
+    await Promise.all(names.filter((name) => name.includes(".tmp-")).map((name) => rm2(path7.join(this.#threadsDirectory, name), { force: true })));
   }
   async #acquireLock() {
     const attempt = async () => {
-      const handle = await open2(this.#lockPath, "wx", constants.S_IRUSR | constants.S_IWUSR);
+      const handle = await open2(this.#lockPath, "wx", constants2.S_IRUSR | constants2.S_IWUSR);
       const lock = {
         pid: process.pid,
         instanceId: this.#instanceId,
@@ -47528,10 +47563,10 @@ var MappingStore = class {
     }
   }
   #recordPath(hostThreadId) {
-    return path6.join(this.#threadsDirectory, `${hostThreadId}.json`);
+    return path7.join(this.#threadsDirectory, `${hostThreadId}.json`);
   }
   #backupPath(hostThreadId) {
-    return path6.join(this.#backupsDirectory, `${hostThreadId}.json`);
+    return path7.join(this.#backupsDirectory, `${hostThreadId}.json`);
   }
   #requireInitialized() {
     if (!this.#initialized) {
@@ -47736,6 +47771,7 @@ function projectCodexQuestionRequest(input) {
         turnId: interaction.turnId,
         itemId: input.itemId,
         questions,
+        isBlocking: true,
         autoResolutionMs
       }
     },
@@ -47899,8 +47935,8 @@ function projectItem(item, outcome, defaultCwd, includeCommandOutput = true) {
       return {
         id: item.itemId,
         type: "fileChange",
-        changes: item.changes.map(({ path: path11, kind, unifiedDiff }) => ({
-          path: path11,
+        changes: item.changes.map(({ path: path12, kind, unifiedDiff }) => ({
+          path: path12,
           kind,
           diff: unifiedDiff
         })),
@@ -48317,8 +48353,8 @@ var CodexTurnProjector = class {
     return messages;
   }
   #fileChangeUpdates(itemId2, changes) {
-    const projectedChanges = changes.map(({ path: path11, kind, unifiedDiff }) => ({
-      path: path11,
+    const projectedChanges = changes.map(({ path: path12, kind, unifiedDiff }) => ({
+      path: path12,
       kind,
       diff: unifiedDiff
     }));
@@ -48401,13 +48437,13 @@ function decodeThreadForkRequest(request) {
   if (runtimeWorkspaceRoots !== void 0 && runtimeWorkspaceRoots !== null && (!Array.isArray(runtimeWorkspaceRoots) || runtimeWorkspaceRoots.some((root) => typeof root !== "string" || root.length === 0))) {
     throw new Error("thread/fork params.runtimeWorkspaceRoots must be text paths or null");
   }
-  const path11 = optionalText(params, "path", { allowEmpty: true });
+  const path12 = optionalText(params, "path", { allowEmpty: true });
   const ephemeral = optionalBoolean(params, "ephemeral");
   return {
     threadId: threadId2,
     ...lastTurnText ? { lastTurnId: hostTurnIdSchema.parse(lastTurnText) } : {},
     ...beforeTurnText ? { beforeTurnId: hostTurnIdSchema.parse(beforeTurnText) } : {},
-    ...path11 ? { path: path11 } : {},
+    ...path12 ? { path: path12 } : {},
     ...optionalField(params, "model"),
     ...optionalField(params, "modelProvider"),
     ...optionalField(params, "cwd"),
@@ -48982,8 +49018,8 @@ var packageMetadata5 = {
 
 // packages/host-runtime/src/external-thread-repository.ts
 import { randomUUID as randomUUID5 } from "node:crypto";
-import os2 from "node:os";
-import path7 from "node:path";
+import os3 from "node:os";
+import path8 from "node:path";
 function nativeTurnKey2(ref) {
   return `${ref.harnessId}\0${ref.nativeSessionId}\0${ref.nativeTurnKey}\0${ref.formatVersion}`;
 }
@@ -48992,8 +49028,8 @@ function sameMapping(left, right) {
 }
 function defaultMappingStoreDirectory(environment) {
   const dataDirectory = environment.CODEXHOST_DATA_DIR;
-  return path7.join(
-    dataDirectory ? path7.resolve(dataDirectory) : path7.join(os2.homedir(), ".codexhost"),
+  return path8.join(
+    dataDirectory ? path8.resolve(dataDirectory) : path8.join(os3.homedir(), ".codexhost"),
     "mapping-store"
   );
 }
@@ -50281,25 +50317,25 @@ function resolveExternalSessionTreeIds(records) {
   const resolve2 = (start) => {
     const cached2 = resolved.get(start.hostThreadId);
     if (cached2) return cached2;
-    const path11 = [];
+    const path12 = [];
     const visited = /* @__PURE__ */ new Set();
     let current = start;
     while (true) {
       const known = resolved.get(current.hostThreadId);
       if (known) {
-        for (const record3 of path11) resolved.set(record3.hostThreadId, known);
+        for (const record3 of path12) resolved.set(record3.hostThreadId, known);
         return known;
       }
       if (visited.has(current.hostThreadId)) {
         throw new Error("External Thread Fork tree contains a cycle");
       }
       visited.add(current.hostThreadId);
-      path11.push(current);
+      path12.push(current);
       const sourceId = current.forkSource?.hostThreadId;
       const source = sourceId ? byId.get(sourceId) : void 0;
       if (!source) {
         const root = current.hostThreadId;
-        for (const record3 of path11) resolved.set(record3.hostThreadId, root);
+        for (const record3 of path12) resolved.set(record3.hostThreadId, root);
         return root;
       }
       current = source;
@@ -52352,7 +52388,7 @@ import { createConnection } from "node:net";
 
 // packages/update-manager/dist/distribution.js
 import { lstat, readFile as readFile2 } from "node:fs/promises";
-import path8 from "node:path";
+import path9 from "node:path";
 
 // packages/update-manager/dist/status.js
 var STATUS_SCHEMA_VERSION = 1;
@@ -52438,9 +52474,9 @@ function parseDistributionMetadata(value) {
 }
 function absoluteEnvironmentPath(environment, name) {
   const value = environment[name];
-  if (!value || !path8.isAbsolute(value))
+  if (!value || !path9.isAbsolute(value))
     throw new Error(`${name} must be an absolute path`);
-  return path8.normalize(value);
+  return path9.normalize(value);
 }
 function positiveEnvironmentInteger(environment, name) {
   const value = Number(environment[name]);
@@ -52462,39 +52498,39 @@ function expectedTarget(platform, architecture) {
 function defaultUpdateStateDirectory(platform = process.platform, environment = process.env) {
   if (platform === "win32") {
     const root = environment.LOCALAPPDATA;
-    if (!root || !path8.isAbsolute(root))
+    if (!root || !path9.isAbsolute(root))
       throw new Error("LOCALAPPDATA is unavailable");
-    return path8.join(root, "codexhost", "updates");
+    return path9.join(root, "codexhost", "updates");
   }
   const home = environment.HOME;
-  if (!home || !path8.isAbsolute(home))
+  if (!home || !path9.isAbsolute(home))
     throw new Error("HOME is unavailable");
-  return platform === "darwin" ? path8.join(home, "Library", "Application Support", "codexhost", "updates") : path8.join(home, ".codexhost", "updates");
+  return platform === "darwin" ? path9.join(home, "Library", "Application Support", "codexhost", "updates") : path9.join(home, ".codexhost", "updates");
 }
 async function resolveInstalledUpdateContext(options) {
   const environment = options.environment ?? process.env;
   const platform = options.platform ?? process.platform;
   const architecture = options.architecture ?? process.arch;
-  if (!path8.isAbsolute(options.hostRuntimePath)) {
+  if (!path9.isAbsolute(options.hostRuntimePath)) {
     throw new Error("Host Runtime path must be absolute");
   }
-  const hostRuntimePath = path8.normalize(options.hostRuntimePath);
+  const hostRuntimePath = path9.normalize(options.hostRuntimePath);
   const runtimeMetadata = await lstat(hostRuntimePath);
   if (!runtimeMetadata.isFile() || runtimeMetadata.isSymbolicLink()) {
     throw new Error("Host Runtime must be a regular file");
   }
-  const appDirectory = path8.dirname(hostRuntimePath);
-  const metadata = parseDistributionMetadata(JSON.parse(await readFile2(path8.join(appDirectory, "codexhost-distribution.json"), "utf8")));
+  const appDirectory = path9.dirname(hostRuntimePath);
+  const metadata = parseDistributionMetadata(JSON.parse(await readFile2(path9.join(appDirectory, "codexhost-distribution.json"), "utf8")));
   const target = expectedTarget(platform, architecture);
   if (metadata.target !== target) {
     throw new Error(`installed target ${metadata.target} does not match ${target}`);
   }
   const launcherPid = positiveEnvironmentInteger(environment, UPDATE_RUNTIME_ENV.launcherPid);
   const launcherExecutable = absoluteEnvironmentPath(environment, UPDATE_RUNTIME_ENV.launcherExecutable);
-  const stateDirectory = path8.normalize(options.stateDirectory ?? defaultUpdateStateDirectory(platform, environment));
-  const resourcesRoot = path8.dirname(appDirectory);
-  const installationRoot = platform === "darwin" ? path8.dirname(path8.dirname(resourcesRoot)) : resourcesRoot;
-  const updaterExecutable = path8.join(resourcesRoot, "libexec", platform === "win32" ? "codexhost-updater.exe" : "codexhost-updater");
+  const stateDirectory = path9.normalize(options.stateDirectory ?? defaultUpdateStateDirectory(platform, environment));
+  const resourcesRoot = path9.dirname(appDirectory);
+  const installationRoot = platform === "darwin" ? path9.dirname(path9.dirname(resourcesRoot)) : resourcesRoot;
+  const updaterExecutable = path9.join(resourcesRoot, "libexec", platform === "win32" ? "codexhost-updater.exe" : "codexhost-updater");
   const common = {
     version: metadata.version,
     launcherPid,
@@ -52517,7 +52553,7 @@ async function resolveInstalledUpdateContext(options) {
       npmLauncherPath: absoluteEnvironmentPath(environment, UPDATE_RUNTIME_ENV.npmLauncherPath),
       packageRoot: absoluteEnvironmentPath(environment, UPDATE_RUNTIME_ENV.npmPackageRoot)
     };
-    if (path8.normalize(npmOptions.packageRoot) !== resourcesRoot) {
+    if (path9.normalize(npmOptions.packageRoot) !== resourcesRoot) {
       throw new Error("npm platform package root does not own the Host Runtime");
     }
     return { metadata, common, controller, installation: { kind: "npm", options: npmOptions } };
@@ -52680,7 +52716,7 @@ function selectInstallerReleaseArtifact(release, target) {
 
 // packages/update-manager/dist/operation-state.js
 import { lstat as lstat2, mkdir as mkdir2, open as open3, readFile as readFile3, readdir as readdir2, rm as rm3, writeFile } from "node:fs/promises";
-import path9 from "node:path";
+import path10 from "node:path";
 var LOCK_FILE = "active-update-v1.lock";
 var STATUS_FILE = "status-v1.json";
 var TERMINAL_PHASES = /* @__PURE__ */ new Set(["succeeded", "failed"]);
@@ -52695,12 +52731,12 @@ async function regularFile(filePath) {
   }
 }
 async function isUpdateOperationActive(stateDirectory) {
-  if (!path9.isAbsolute(stateDirectory))
+  if (!path10.isAbsolute(stateDirectory))
     throw new Error("update state directory must be absolute");
-  return regularFile(path9.join(stateDirectory, LOCK_FILE));
+  return regularFile(path10.join(stateDirectory, LOCK_FILE));
 }
 async function discoverLatestUpdateStatus(stateDirectory) {
-  if (!path9.isAbsolute(stateDirectory))
+  if (!path10.isAbsolute(stateDirectory))
     throw new Error("update state directory must be absolute");
   let entries;
   try {
@@ -52714,7 +52750,7 @@ async function discoverLatestUpdateStatus(stateDirectory) {
   for (const entry of entries) {
     if (!entry.isDirectory() || entry.isSymbolicLink() || !entry.name.startsWith("update-"))
       continue;
-    const statusPath = path9.join(stateDirectory, entry.name, STATUS_FILE);
+    const statusPath = path10.join(stateDirectory, entry.name, STATUS_FILE);
     if (!await regularFile(statusPath))
       continue;
     try {
@@ -52742,8 +52778,8 @@ async function cleanupTerminalUpdateState(stateDirectory, options = {}) {
   for (const entry of entries) {
     if (!entry.isDirectory() || entry.isSymbolicLink() || !entry.name.startsWith("update-"))
       continue;
-    const directory = path9.join(stateDirectory, entry.name);
-    const statusPath = path9.join(directory, STATUS_FILE);
+    const directory = path10.join(stateDirectory, entry.name);
+    const statusPath = path10.join(directory, STATUS_FILE);
     try {
       const status = parseUpdateStatus(JSON.parse(await readFile3(statusPath, "utf8")));
       if (TERMINAL_PHASES.has(status.phase) && now - status.updatedAt > retentionSeconds) {
@@ -52754,10 +52790,10 @@ async function cleanupTerminalUpdateState(stateDirectory, options = {}) {
   }
 }
 async function acquireUpdateOperationLock(stateDirectory) {
-  if (!path9.isAbsolute(stateDirectory))
+  if (!path10.isAbsolute(stateDirectory))
     throw new Error("update state directory must be absolute");
   await mkdir2(stateDirectory, { recursive: true, mode: 448 });
-  const lockPath = path9.join(stateDirectory, LOCK_FILE);
+  const lockPath = path10.join(stateDirectory, LOCK_FILE);
   let handle;
   try {
     handle = await open3(lockPath, "wx", 384);
@@ -52776,9 +52812,9 @@ async function acquireUpdateOperationLock(stateDirectory) {
     async setStatusPath(statusPath) {
       if (released)
         throw new Error("update operation lock is released");
-      if (!path9.isAbsolute(statusPath))
+      if (!path10.isAbsolute(statusPath))
         throw new Error("update status path must be absolute");
-      await writeFile(lockPath, `${JSON.stringify({ ownerPid: process.pid, statusPath: path9.normalize(statusPath) })}
+      await writeFile(lockPath, `${JSON.stringify({ ownerPid: process.pid, statusPath: path10.normalize(statusPath) })}
 `, { encoding: "utf8", mode: 384 });
     },
     async release() {
@@ -52800,7 +52836,7 @@ function processIsAlive(processId) {
   }
 }
 async function recoverUpdateOperationLock(stateDirectory) {
-  const lockPath = path9.join(stateDirectory, LOCK_FILE);
+  const lockPath = path10.join(stateDirectory, LOCK_FILE);
   if (!await regularFile(lockPath))
     return;
   let ownerPid;
@@ -52812,7 +52848,7 @@ async function recoverUpdateOperationLock(stateDirectory) {
   } catch {
     return;
   }
-  if (typeof statusPath !== "string" || !path9.isAbsolute(statusPath))
+  if (typeof statusPath !== "string" || !path10.isAbsolute(statusPath))
     return;
   try {
     const status = parseUpdateStatus(JSON.parse(await readFile3(statusPath, "utf8")));
@@ -52827,7 +52863,7 @@ async function recoverUpdateOperationLock(stateDirectory) {
 import { spawn as spawn4 } from "node:child_process";
 import { randomUUID as randomUUID8 } from "node:crypto";
 import { chmod, copyFile as copyFile2, lstat as lstat4, mkdir as mkdir3, readFile as readFile4, rename as rename2, rm as rm4, writeFile as writeFile2 } from "node:fs/promises";
-import path10 from "node:path";
+import path11 from "node:path";
 
 // packages/update-manager/dist/artifact.js
 import { createHash as createHash2 } from "node:crypto";
@@ -52924,9 +52960,9 @@ function errorMessage4(error52) {
   return error52 instanceof Error ? error52.message : String(error52);
 }
 function requireAbsolutePath(value, label) {
-  if (!path10.isAbsolute(value))
+  if (!path11.isAbsolute(value))
     throw new Error(`${label} must be an absolute path`);
-  return path10.normalize(value);
+  return path11.normalize(value);
 }
 async function requireRegularFile(value, label) {
   const filePath = requireAbsolutePath(value, label);
@@ -52969,7 +53005,7 @@ function createBackgroundUpdateManager(dependencies = {}) {
   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`);
+    const temporaryPath = path11.join(path11.dirname(statusPath), `.update-status-${randomId()}.tmp`);
     try {
       await writeFile2(temporaryPath, `${JSON.stringify(status)}
 `, {
@@ -53028,15 +53064,15 @@ function createBackgroundUpdateManager(dependencies = {}) {
     const updaterExecutable = await requireRegularFile(options.updaterExecutable, "Updater executable");
     const stateDirectory = requireAbsolutePath(options.stateDirectory, "update state directory");
     await mkdir3(stateDirectory, { recursive: true, mode: 448 });
-    const workDirectory = path10.join(stateDirectory, `update-${version2}-${randomId()}`);
+    const workDirectory = path11.join(stateDirectory, `update-${version2}-${randomId()}`);
     await mkdir3(workDirectory, { recursive: false, mode: 448 });
     const executableSuffix = platform === "win32" ? ".exe" : "";
-    const helperPath = path10.join(workDirectory, `codexhost-updater${executableSuffix}`);
+    const helperPath = path11.join(workDirectory, `codexhost-updater${executableSuffix}`);
     await copyFile2(updaterExecutable, helperPath);
     if (platform !== "win32")
       await chmod(helperPath, 448);
-    const requestPath = path10.join(workDirectory, "request-v1.json");
-    const statusPath = path10.join(workDirectory, "status-v1.json");
+    const requestPath = path11.join(workDirectory, "request-v1.json");
+    const statusPath = path11.join(workDirectory, "status-v1.json");
     await writePrivateJson(statusPath, preparedStatus(version2, installation, now()));
     await options.onPrepared?.({ version: version2, installation, statusPath });
     return {
@@ -53051,8 +53087,8 @@ function createBackgroundUpdateManager(dependencies = {}) {
   }
   async function prepareArtifact(common, installation, sourceValue, fileName) {
     const source = validateArtifact(sourceValue);
-    const temporaryPath = path10.join(common.workDirectory, `.${fileName}.download`);
-    const artifactPath = path10.join(common.workDirectory, fileName);
+    const temporaryPath = path11.join(common.workDirectory, `.${fileName}.download`);
+    const artifactPath = path11.join(common.workDirectory, fileName);
     const progress = progressReporter(common.statusPath, common.version, installation, source.size);
     try {
       const result = await download(source, temporaryPath, progress.update);
@@ -53101,8 +53137,7 @@ function createBackgroundUpdateManager(dependencies = {}) {
           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")
+          npm_launcher_path: await requireRegularFile(options.npmLauncherPath, "npm codexhost launcher")
         });
       } catch (error52) {
         await writeFailedStatus(common.statusPath, common.version, "npm", error52);
@@ -53126,7 +53161,7 @@ function createBackgroundUpdateManager(dependencies = {}) {
         throw new Error("macOS DMG updates require macOS");
       const common = await prepareCommon(options, "macos-dmg");
       const appPath = requireAbsolutePath(options.appPath, "macOS application path");
-      if (path10.extname(appPath) !== ".app") {
+      if (path11.extname(appPath) !== ".app") {
         throw new Error("macOS application path must end in .app");
       }
       const artifact = await prepareArtifact(common, "macos-dmg", options.artifact, "update.dmg");

package/app/renderer-extension.js

@@ -18168,15 +18168,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     locale: "en",
     title: "Settings",
     close: "Close settings",
-    interfaceLanguage: "Interface language",
-    automaticLanguage: "Automatic (follow Codex)",
-    englishLanguage: "English",
-    simplifiedChineseLanguage: "Simplified Chinese",
-    otherCodexLanguage: "Other Codex language",
-    languageUpdateFailed: "Could not update the language setting.",
+    starOnGitHub: "Give us a Star~",
     sectionsLabel: "Settings sections",
     pageUnavailable: "Page unavailable",
-    availability: "Availability",
+    inDevelopment: "In development",
     notAvailable: "Not available",
     runtimeCapabilityNotInstalled: "This runtime capability is not installed yet.",
     openSettings: "Open codexhost settings",
@@ -18195,11 +18190,15 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     updateChecking: "Checking for updates...",
     updateDownloading: "Downloading update...",
     updatePreparing: "Preparing update...",
+    updateWaitingForExit: "Waiting for the application to close...",
+    updateInstalling: "Installing update...",
+    updateInstallingNpm: "Installing update through npm...",
     updateRequestTimeout: "The update service did not respond. Try again.",
     updateRestarting: "Restarting to finish the update...",
     updateSucceeded: "Update installed successfully.",
     updateFailed: "Update failed.",
     updateRetry: "Retry",
+    updateManualNpmDescription: "To update manually, quit codexhost and run this command:",
     updateDownloadFromReleases: "Download from GitHub Releases",
     pageLabels: Object.freeze({
       connections: "Connections",
@@ -18213,15 +18212,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     locale: "zh-CN",
     title: "\u8BBE\u7F6E",
     close: "\u5173\u95ED\u8BBE\u7F6E",
-    interfaceLanguage: "\u754C\u9762\u8BED\u8A00",
-    automaticLanguage: "\u81EA\u52A8\uFF08\u8DDF\u968F Codex\uFF09",
-    englishLanguage: "English",
-    simplifiedChineseLanguage: "\u7B80\u4F53\u4E2D\u6587",
-    otherCodexLanguage: "\u5176\u4ED6 Codex \u8BED\u8A00",
-    languageUpdateFailed: "\u65E0\u6CD5\u66F4\u65B0\u8BED\u8A00\u8BBE\u7F6E\u3002",
+    starOnGitHub: "\u70B9\u4E2A Star~",
     sectionsLabel: "\u8BBE\u7F6E\u5206\u7C7B",
     pageUnavailable: "\u9875\u9762\u4E0D\u53EF\u7528",
-    availability: "\u53EF\u7528\u6027",
+    inDevelopment: "\u5F00\u53D1\u4E2D",
     notAvailable: "\u6682\u4E0D\u53EF\u7528",
     runtimeCapabilityNotInstalled: "\u8FD0\u884C\u65F6\u5C1A\u672A\u5B89\u88C5\u8BE5\u9879\u80FD\u529B\uFF0C\u56E0\u6B64\u6682\u4E0D\u53EF\u7528\u3002",
     openSettings: "\u6253\u5F00 codexhost \u8BBE\u7F6E",
@@ -18240,11 +18234,15 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     updateChecking: "\u6B63\u5728\u68C0\u67E5\u66F4\u65B0...",
     updateDownloading: "\u6B63\u5728\u4E0B\u8F7D\u66F4\u65B0...",
     updatePreparing: "\u6B63\u5728\u51C6\u5907\u66F4\u65B0...",
+    updateWaitingForExit: "\u6B63\u5728\u7B49\u5F85\u5E94\u7528\u9000\u51FA...",
+    updateInstalling: "\u6B63\u5728\u5B89\u88C5\u66F4\u65B0...",
+    updateInstallingNpm: "\u6B63\u5728\u901A\u8FC7 npm \u5B89\u88C5...",
     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",
+    updateManualNpmDescription: "\u5982\u9700\u624B\u52A8\u66F4\u65B0\uFF0C\u8BF7\u5728\u7EC8\u7AEF\u8FD0\u884C\u4EE5\u4E0B\u547D\u4EE4\u3002\u66F4\u65B0\u5B8C\u6210\u540E\uFF0C\u8BF7\u9000\u51FA Codex \u5E76\u901A\u8FC7 codexhost \u91CD\u65B0\u542F\u52A8\u3002",
     updateDownloadFromReleases: "\u524D\u5F80 GitHub Releases \u4E0B\u8F7D",
     pageLabels: Object.freeze({
       connections: "\u8FDE\u63A5",
@@ -18380,6 +18378,16 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     ["circle", { cx: "12", cy: "12", r: "3" }]
   ];
 
+  // ../../node_modules/lucide/dist/esm/icons/star.mjs
+  var Star = [
+    [
+      "path",
+      {
+        d: "M11.525 2.295a.53.53 0 0 1 .95 0l2.31 4.679a2.123 2.123 0 0 0 1.595 1.16l5.166.756a.53.53 0 0 1 .294.904l-3.736 3.638a2.123 2.123 0 0 0-.611 1.878l.882 5.14a.53.53 0 0 1-.771.56l-4.618-2.428a2.122 2.122 0 0 0-1.973 0L6.396 21.01a.53.53 0 0 1-.77-.56l.881-5.139a2.122 2.122 0 0 0-.611-1.879L2.16 9.795a.53.53 0 0 1 .294-.906l5.165-.755a2.122 2.122 0 0 0 1.597-1.16z"
+      }
+    ]
+  ];
+
   // ../../node_modules/lucide/dist/esm/icons/x.mjs
   var X = [
     ["path", { d: "M18 6 6 18" }],
@@ -18393,6 +18401,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   var RENDERER_SETTINGS_ICON_NAMES = [
     "settings",
     "close",
+    "star",
     "language",
     "connections",
     "model-pool",
@@ -18406,6 +18415,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
   var iconNodes = {
     settings: Settings,
     close: X,
+    star: Star,
     language: Languages,
     connections: PlugZap,
     "model-pool": Boxes,
@@ -18592,6 +18602,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 
   // src/settings/pages.ts
   var CODEXHOST_RELEASES_LATEST_URL = "https://github.com/BytePioneer-AI/codex-host/releases/latest";
+  var CODEXHOST_NPM_MANUAL_UPDATE_COMMAND = "npm install -g @codexhost/cli@latest";
   var DEFAULT_RENDERER_SETTINGS_PAGE_IDS = [
     "connections",
     "model-pool",
@@ -18600,19 +18611,14 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     "updates"
   ];
   function appendUnavailableStatus(content, messages) {
-    const heading = content.ownerDocument.createElement("div");
-    heading.className = "settings-section-label";
-    heading.textContent = messages.availability;
     const status = content.ownerDocument.createElement("div");
     status.className = "settings-empty";
     const copy = content.ownerDocument.createElement("div");
     const title = content.ownerDocument.createElement("strong");
-    title.textContent = messages.notAvailable;
-    const detail = content.ownerDocument.createElement("span");
-    detail.textContent = messages.runtimeCapabilityNotInstalled;
-    copy.append(title, detail);
+    title.textContent = messages.inDevelopment;
+    copy.append(title);
     status.append(copy);
-    content.append(heading, status);
+    content.append(status);
   }
   function unavailablePage(id, messages) {
     return Object.freeze({
@@ -18650,6 +18656,10 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     if (!status) return null;
     if (status.phase === "succeeded") return messages.updateSucceeded;
     if (status.phase === "failed") return status.error ?? messages.updateFailed;
+    if (status.phase === "waiting-for-exit") return messages.updateWaitingForExit;
+    if (status.phase === "installing") {
+      return status.installation === "npm" ? messages.updateInstallingNpm : messages.updateInstalling;
+    }
     if (status.phase === "restarting") return messages.updateRestarting;
     if (status.phase === "downloading") return messages.updateDownloading;
     return messages.updatePreparing;
@@ -18696,6 +18706,14 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
         const panel = document2.createElement("section");
         panel.className = "settings-update-panel";
         panel.setAttribute("aria-live", "polite");
+        const manualNpm = document2.createElement("div");
+        manualNpm.className = "settings-update-manual";
+        manualNpm.hidden = true;
+        const manualNpmDescription = document2.createElement("span");
+        manualNpmDescription.textContent = messages.updateManualNpmDescription;
+        const manualNpmCommand = document2.createElement("code");
+        manualNpmCommand.textContent = CODEXHOST_NPM_MANUAL_UPDATE_COMMAND;
+        manualNpm.append(manualNpmDescription, manualNpmCommand);
         const actions = document2.createElement("div");
         actions.className = "settings-update-actions";
         const releaseLink = document2.createElement("a");
@@ -18708,7 +18726,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
           createRendererSettingsIcon("external-link", 14)
         );
         actions.append(releaseLink);
-        context.content.append(heading, metadata, panel, actions);
+        context.content.append(heading, metadata, panel, manualNpm, actions);
         let pollTimer;
         let pollAttempts = 0;
         let pending = false;
@@ -18813,6 +18831,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
         const renderCheck = (result, client) => {
           currentVersionValue.textContent = `v${result.currentVersion}`;
           installationValue.textContent = installationLabel(result.installation, messages);
+          manualNpm.hidden = result.installation !== "npm";
           if (result.releaseNotesUrl) releaseLink.href = result.releaseNotesUrl;
           const operationMessage = statusMessage(result.status, messages);
           if (isPendingStatus(result.status)) {
@@ -18904,10 +18923,11 @@ 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-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';
+  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-header-actions {\n  display: flex;\n  align-items: center;\n  flex: none;\n  gap: 12px;\n  margin-left: auto;\n}\n\n.settings-icon-button.settings-star-link {\n  width: auto;\n  gap: 6px;\n  padding-inline: 8px;\n  font-size: 12px;\n  line-height: 18px;\n  text-decoration: none;\n  border: 2px dashed #f5c542;\n  white-space: nowrap;\n}\n\n.settings-star-link .codexhost-settings-icon {\n  color: #f5c542;\n  fill: currentColor;\n  stroke: currentColor;\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-manual {\n  display: grid;\n  min-width: 0;\n  gap: 6px;\n  margin-top: 14px;\n  padding-inline: 4px;\n}\n\n.settings-update-manual[hidden] {\n  display: none;\n}\n\n.settings-update-manual span {\n  color: var(--settings-muted);\n  font-size: 12px;\n  line-height: 18px;\n}\n\n.settings-update-manual code {\n  overflow-wrap: anywhere;\n  color: var(--settings-text);\n  font-family: ui-monospace, "SFMono-Regular", Consolas, "Liberation Mono", monospace;\n  font-size: 12px;\n  line-height: 18px;\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-icon-button.settings-star-link {\n    width: 28px;\n    padding: 0;\n  }\n\n  .settings-star-link span {\n    display: none;\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";
+  var CODEXHOST_GITHUB_REPOSITORY_URL = "https://github.com/BytePioneer-AI/codex-host";
   function isRendererSettingsDialogSupported(dialog) {
     return typeof dialog.showModal === "function" && typeof dialog.close === "function";
   }
@@ -18952,13 +18972,26 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
     brandTitle.textContent = messages.title;
     brandCopy.append(brandName, brandTitle);
     brand.append(brandMark, brandCopy);
+    const headerActions = ownerDocument.createElement("div");
+    headerActions.className = "settings-header-actions";
+    const starLink = ownerDocument.createElement("a");
+    starLink.className = "settings-icon-button settings-star-link";
+    starLink.href = CODEXHOST_GITHUB_REPOSITORY_URL;
+    starLink.target = "_blank";
+    starLink.rel = "noopener noreferrer";
+    starLink.setAttribute("aria-label", messages.starOnGitHub);
+    starLink.title = messages.starOnGitHub;
+    const starLabel = ownerDocument.createElement("span");
+    starLabel.textContent = messages.starOnGitHub;
+    starLink.append(createRendererSettingsIcon("star", 16), starLabel);
     const closeButton = ownerDocument.createElement("button");
     closeButton.type = "button";
     closeButton.className = "settings-icon-button";
     closeButton.setAttribute("aria-label", messages.close);
     closeButton.title = messages.close;
     closeButton.append(createRendererSettingsIcon("close", 18));
-    header.append(brand, closeButton);
+    headerActions.append(starLink, closeButton);
+    header.append(brand, headerActions);
     const layout = ownerDocument.createElement("div");
     layout.className = "settings-layout";
     const sidebar = ownerDocument.createElement("aside");
@@ -20874,6 +20907,7 @@ lucide/dist/esm/icons/plug-zap.mjs:
 lucide/dist/esm/icons/refresh-cw.mjs:
 lucide/dist/esm/icons/route.mjs:
 lucide/dist/esm/icons/settings.mjs:
+lucide/dist/esm/icons/star.mjs:
 lucide/dist/esm/icons/x.mjs:
   (**
    * @license lucide v1.28.0 - ISC

package/package.json

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