@karlorz/codexhost-cli-darwin-arm64 0.13.2-1 → 0.13.2-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 @karlorz/codexhost-cli@0.13.2-1
+npm install -g @karlorz/codexhost-cli@0.13.2-3
 ```
 
 Do not install this package directly. npm selects it through the optional dependencies of `@karlorz/codexhost-cli`.

package/app/codexhost-distribution.json

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

package/app/console-server.mjs

@@ -17429,7 +17429,7 @@ import { spawn as spawn2 } from "node:child_process";
 import { createServer } from "node:http";
 
 // packages/console-server/src/announcement.ts
-var ANNOUNCEMENT_URL = "https://raw.githubusercontent.com/BytePioneer-AI/codex-host/main/docs/NOTICE.md";
+var ANNOUNCEMENT_URL = "https://raw.githubusercontent.com/karlorz/codex-host/main/docs/NOTICE.md";
 var MAX_DOCUMENT_BYTES = 16 * 1024;
 var TIMEOUT_MS = 5e3;
 function parseAnnouncement(document) {

package/app/console-web.js

@@ -20662,6 +20662,14 @@ th[aria-sort] .console-usage-sort__mark {
     otherSection: "Other",
     appearanceDescription: "Conversation display and local resource management.",
     appearanceGroup: "Appearance",
+    hideCodexUsageBannerTitle: "Hide Codex usage warning",
+    hideCodexUsageBannerDescription: "On by default. Hide the out-of-usage card on every Composer.",
+    hideCodexUsageBannerHelpLabel: "About hiding the Codex usage warning",
+    hideCodexUsageBannerHelp: Object.freeze([
+      "The native card appears when the signed-in ChatGPT Codex quota is exhausted.",
+      "When this is on, that card is hidden on every Composer, including Codex threads. Reset usage and Upgrade stay available in Settings.",
+      "Turning this off only shows the native card again. Send on this Composer, including Codex threads, is already separated from that quota card."
+    ]),
     cpaLiveVoiceTitle: "Override live voice",
     cpaLiveVoiceDescription: "On by default. Host creates the realtime call instead of ChatGPT.",
     cpaLiveVoiceHelpLabel: "About overriding live voice",
@@ -20945,6 +20953,14 @@ th[aria-sort] .console-usage-sort__mark {
     otherSection: "\u5176\u4ED6",
     appearanceDescription: "\u4F1A\u8BDD\u663E\u793A\u4E0E\u672C\u5730\u8D44\u6E90\u7BA1\u7406\u3002",
     appearanceGroup: "\u5916\u89C2",
+    hideCodexUsageBannerTitle: "\u9690\u85CF Codex \u989D\u5EA6\u8B66\u544A",
+    hideCodexUsageBannerDescription: "\u9ED8\u8BA4\u5F00\u542F\u3002\u5728\u6240\u6709 Composer \u4E0A\u9690\u85CF\u989D\u5EA6\u8017\u5C3D\u5361\u7247\u3002",
+    hideCodexUsageBannerHelpLabel: "\u9690\u85CF Codex \u989D\u5EA6\u8B66\u544A\u8BF4\u660E",
+    hideCodexUsageBannerHelp: Object.freeze([
+      "\u5DF2\u767B\u5F55\u7684 ChatGPT Codex \u989D\u5EA6\u8017\u5C3D\u65F6\uFF0CDesktop \u4F1A\u663E\u793A\u539F\u751F\u8B66\u544A\u5361\u7247\u3002",
+      "\u5F00\u542F\u540E\uFF0C\u6240\u6709 Composer \u90FD\u9690\u85CF\u8BE5\u5361\u7247\uFF0C\u5305\u62EC Codex \u4F1A\u8BDD\u3002\u300C\u91CD\u7F6E\u7528\u91CF\u300D\u548C\u300C\u5347\u7EA7\u300D\u4ECD\u53EF\u5728\u8BBE\u7F6E\u4E2D\u4F7F\u7528\u3002",
+      "\u5173\u95ED\u6B64\u5F00\u5173\u53EA\u4F1A\u91CD\u65B0\u663E\u793A\u539F\u751F\u5361\u7247\u3002\u5F53\u524D Composer \u7684\u53D1\u9001\uFF08\u5305\u62EC Codex \u4F1A\u8BDD\uFF09\u5DF2\u4E0E\u8BE5\u989D\u5EA6\u5361\u7247\u5206\u79BB\u3002"
+    ]),
     cpaLiveVoiceTitle: "\u6539\u5199\u5B9E\u65F6\u8BED\u97F3",
     cpaLiveVoiceDescription: "\u9ED8\u8BA4\u5F00\u542F\u3002\u7531 Host \u521B\u5EFA realtime \u901A\u8BDD\uFF0C\u800C\u4E0D\u662F ChatGPT\u3002",
     cpaLiveVoiceHelpLabel: "\u6539\u5199\u5B9E\u65F6\u8BED\u97F3\u8BF4\u660E",
@@ -26746,6 +26762,27 @@ ${error51.stderrTail}`] : []
     };
   }
 
+  // src/renderer-codex-usage-banner-preference.ts
+  var CODEX_USAGE_BANNER_STORAGE_KEY = "codexhost.codex-usage-banner-hidden.v1";
+  var CODEX_USAGE_BANNER_CHANGE_EVENT = "codexhost:codex-usage-banner-changed";
+  function readCodexUsageBannerPreference(owner) {
+    if (!owner) return true;
+    try {
+      return owner.localStorage.getItem(CODEX_USAGE_BANNER_STORAGE_KEY) !== "0";
+    } catch {
+      return true;
+    }
+  }
+  function writeCodexUsageBannerPreference(owner, enabled) {
+    try {
+      owner.localStorage.setItem(CODEX_USAGE_BANNER_STORAGE_KEY, enabled ? "1" : "0");
+    } catch {
+      return false;
+    }
+    owner.dispatchEvent(new Event(CODEX_USAGE_BANNER_CHANGE_EVENT));
+    return true;
+  }
+
   // src/renderer-transcript-dom.ts
   var REASONING_SOFT_WRAP_STORAGE_KEY = "codexhost.reasoning-soft-wrap.v1";
   var REASONING_SOFT_WRAP_CHANGE_EVENT = "codexhost:reasoning-soft-wrap-changed";
@@ -27012,6 +27049,31 @@ ${error51.stderrTail}`] : []
         description.className = "settings-page-description";
         description.textContent = messages.appearanceDescription;
         const { group, card } = createPreferenceGroup(document2, messages.appearanceGroup);
+        const usageBannerId = preferenceId("hide-codex-usage-banner");
+        const usageBannerRow = createPreferenceItem(document2, {
+          title: messages.hideCodexUsageBannerTitle,
+          description: messages.hideCodexUsageBannerDescription,
+          controlId: usageBannerId,
+          help: {
+            label: messages.hideCodexUsageBannerHelpLabel,
+            lines: messages.hideCodexUsageBannerHelp
+          }
+        });
+        const usageBanner = createPreferenceSwitch(
+          document2,
+          usageBannerId,
+          usageBannerRow.description.id
+        );
+        usageBanner.checked = readCodexUsageBannerPreference(ownerWindow);
+        usageBanner.addEventListener("change", () => {
+          writeCodexUsageBannerPreference(ownerWindow, usageBanner.checked);
+        });
+        const syncUsageBanner = () => {
+          usageBanner.checked = readCodexUsageBannerPreference(ownerWindow);
+        };
+        ownerWindow.addEventListener(CODEX_USAGE_BANNER_CHANGE_EVENT, syncUsageBanner);
+        usageBannerRow.item.append(usageBanner);
+        card.append(usageBannerRow.item);
         const liveVoiceId = preferenceId("cpa-live-voice");
         const liveVoiceRow = createPreferenceItem(document2, {
           title: messages.cpaLiveVoiceTitle,
@@ -27061,6 +27123,7 @@ ${error51.stderrTail}`] : []
           getLoadedSessionsClient
         );
         return () => {
+          ownerWindow.removeEventListener(CODEX_USAGE_BANNER_CHANGE_EVENT, syncUsageBanner);
           ownerWindow.removeEventListener(CPA_LIVE_VOICE_CHANGE_EVENT, syncLiveVoice);
           ownerWindow.removeEventListener(REASONING_SOFT_WRAP_CHANGE_EVENT, sync);
           disposeIdleRelease();

package/app/renderer-extension.js

@@ -18807,6 +18807,14 @@ ${error51.stderrTail}`] : []
     otherSection: "Other",
     appearanceDescription: "Conversation display and local resource management.",
     appearanceGroup: "Appearance",
+    hideCodexUsageBannerTitle: "Hide Codex usage warning",
+    hideCodexUsageBannerDescription: "On by default. Hide the out-of-usage card on every Composer.",
+    hideCodexUsageBannerHelpLabel: "About hiding the Codex usage warning",
+    hideCodexUsageBannerHelp: Object.freeze([
+      "The native card appears when the signed-in ChatGPT Codex quota is exhausted.",
+      "When this is on, that card is hidden on every Composer, including Codex threads. Reset usage and Upgrade stay available in Settings.",
+      "Turning this off only shows the native card again. Send on this Composer, including Codex threads, is already separated from that quota card."
+    ]),
     cpaLiveVoiceTitle: "Override live voice",
     cpaLiveVoiceDescription: "On by default. Host creates the realtime call instead of ChatGPT.",
     cpaLiveVoiceHelpLabel: "About overriding live voice",
@@ -19090,6 +19098,14 @@ ${error51.stderrTail}`] : []
     otherSection: "\u5176\u4ED6",
     appearanceDescription: "\u4F1A\u8BDD\u663E\u793A\u4E0E\u672C\u5730\u8D44\u6E90\u7BA1\u7406\u3002",
     appearanceGroup: "\u5916\u89C2",
+    hideCodexUsageBannerTitle: "\u9690\u85CF Codex \u989D\u5EA6\u8B66\u544A",
+    hideCodexUsageBannerDescription: "\u9ED8\u8BA4\u5F00\u542F\u3002\u5728\u6240\u6709 Composer \u4E0A\u9690\u85CF\u989D\u5EA6\u8017\u5C3D\u5361\u7247\u3002",
+    hideCodexUsageBannerHelpLabel: "\u9690\u85CF Codex \u989D\u5EA6\u8B66\u544A\u8BF4\u660E",
+    hideCodexUsageBannerHelp: Object.freeze([
+      "\u5DF2\u767B\u5F55\u7684 ChatGPT Codex \u989D\u5EA6\u8017\u5C3D\u65F6\uFF0CDesktop \u4F1A\u663E\u793A\u539F\u751F\u8B66\u544A\u5361\u7247\u3002",
+      "\u5F00\u542F\u540E\uFF0C\u6240\u6709 Composer \u90FD\u9690\u85CF\u8BE5\u5361\u7247\uFF0C\u5305\u62EC Codex \u4F1A\u8BDD\u3002\u300C\u91CD\u7F6E\u7528\u91CF\u300D\u548C\u300C\u5347\u7EA7\u300D\u4ECD\u53EF\u5728\u8BBE\u7F6E\u4E2D\u4F7F\u7528\u3002",
+      "\u5173\u95ED\u6B64\u5F00\u5173\u53EA\u4F1A\u91CD\u65B0\u663E\u793A\u539F\u751F\u5361\u7247\u3002\u5F53\u524D Composer \u7684\u53D1\u9001\uFF08\u5305\u62EC Codex \u4F1A\u8BDD\uFF09\u5DF2\u4E0E\u8BE5\u989D\u5EA6\u5361\u7247\u5206\u79BB\u3002"
+    ]),
     cpaLiveVoiceTitle: "\u6539\u5199\u5B9E\u65F6\u8BED\u97F3",
     cpaLiveVoiceDescription: "\u9ED8\u8BA4\u5F00\u542F\u3002\u7531 Host \u521B\u5EFA realtime \u901A\u8BDD\uFF0C\u800C\u4E0D\u662F ChatGPT\u3002",
     cpaLiveVoiceHelpLabel: "\u6539\u5199\u5B9E\u65F6\u8BED\u97F3\u8BF4\u660E",
@@ -22548,6 +22564,27 @@ Codex Fast mode prioritizes requests and may increase usage.`
     };
   }
 
+  // src/renderer-codex-usage-banner-preference.ts
+  var CODEX_USAGE_BANNER_STORAGE_KEY = "codexhost.codex-usage-banner-hidden.v1";
+  var CODEX_USAGE_BANNER_CHANGE_EVENT = "codexhost:codex-usage-banner-changed";
+  function readCodexUsageBannerPreference(owner) {
+    if (!owner) return true;
+    try {
+      return owner.localStorage.getItem(CODEX_USAGE_BANNER_STORAGE_KEY) !== "0";
+    } catch {
+      return true;
+    }
+  }
+  function writeCodexUsageBannerPreference(owner, enabled) {
+    try {
+      owner.localStorage.setItem(CODEX_USAGE_BANNER_STORAGE_KEY, enabled ? "1" : "0");
+    } catch {
+      return false;
+    }
+    owner.dispatchEvent(new Event(CODEX_USAGE_BANNER_CHANGE_EVENT));
+    return true;
+  }
+
   // src/renderer-composer-dom.ts
   var CODEX_COMPOSER_SELECTOR = "[data-codex-composer-root]";
   var EDITOR_SELECTOR = 'textarea, [contenteditable="true"], [role="textbox"]';
@@ -22720,6 +22757,17 @@ Codex Fast mode prioritizes requests and may increase usage.`
     ].filter(isNativeContextUsageControlCandidate);
     return candidates.length === 1 ? candidates[0] ?? null : null;
   }
+  function isNativeUsageBannerCandidate(element) {
+    if (element.localName !== "aside") return false;
+    if (typeof element.querySelector !== "function") return false;
+    return element.querySelector("h3") !== null && element.querySelector("button") !== null;
+  }
+  function nativeUsageBannerForComposer(composer) {
+    const candidates = [...composer.querySelectorAll("aside")].filter(
+      isNativeUsageBannerCandidate
+    );
+    return candidates.length === 1 ? candidates[0] ?? null : null;
+  }
   function captureNativeControl(element) {
     return element ? {
       element,
@@ -22741,6 +22789,12 @@ Codex Fast mode prioritizes requests and may increase usage.`
     restoreNativeControl(control.nativeContextUsageControl);
     control.nativeContextUsageControl = captureNativeControl(candidate);
   }
+  function refreshNativeUsageBanner(control) {
+    const candidate = nativeUsageBannerForComposer(control.composer);
+    if (candidate === control.nativeUsageBanner?.element) return;
+    restoreNativeControl(control.nativeUsageBanner);
+    control.nativeUsageBanner = captureNativeControl(candidate);
+  }
   function refreshNativeModelControl(control) {
     const candidate = nativeModelControlForComposer(control.composer);
     if (!candidate) return;
@@ -22859,12 +22913,20 @@ Codex Fast mode prioritizes requests and may increase usage.`
     refreshNativeContextUsageControl(control);
     refreshNativeModelControl(control);
     refreshNativePermissionModeControl(control);
+    refreshNativeUsageBanner(control);
     refreshTrailingClusterPlacement(control);
     refreshUsagePlacement(control);
     refreshCreditsPlacement(control);
     setNativeControlHidden(control.nativeModelControl, hideModel);
     setNativeControlHidden(control.nativeContextUsageControl, false);
     setNativeControlHidden(control.nativePermissionModeControl, hidePermissionMode);
+    setNativeControlHidden(
+      control.nativeUsageBanner,
+      readCodexUsageBannerPreference(preferenceOwner(control))
+    );
+  }
+  function preferenceOwner(control) {
+    return control.composer.ownerDocument?.defaultView ?? (typeof document !== "undefined" ? document.defaultView : null);
   }
   function mountComposerAgentControl(composer, composerId, sendButton, enabledAgents, onSelect, onDownload, onOpenProviderPicker, onSelectModel, onSelectThinking, onSelectPermissionMode, onOpenCommandMenu) {
     if (composer instanceof HTMLElement) composer.style.minWidth = "0";
@@ -22872,6 +22934,7 @@ Codex Fast mode prioritizes requests and may increase usage.`
     const nativeContextUsageControl = captureNativeControl(
       nativeContextUsageControlForComposer(composer)
     );
+    const nativeUsageBanner = captureNativeControl(nativeUsageBannerForComposer(composer));
     const semanticNativePermissionModeControl = semanticNativePermissionModeControlForComposer(composer);
     const nativePermissionModeControl = captureNativeControl(semanticNativePermissionModeControl);
     const nativePermissionModeControlVerified = semanticNativePermissionModeControl !== null && nativePermissionModeControlForComposer(composer) === semanticNativePermissionModeControl;
@@ -22932,6 +22995,7 @@ Codex Fast mode prioritizes requests and may increase usage.`
       nativeModelControl,
       nativePermissionModeControl,
       nativeContextUsageControl,
+      nativeUsageBanner,
       nativePermissionModeControlVerified,
       credits,
       usage: null,
@@ -23012,7 +23076,7 @@ Codex Fast mode prioritizes requests and may increase usage.`
     control.harnessCommands.root.hidden = state.agent === "codex";
     control.harnessCommands.root.style.display = state.agent === "codex" ? "none" : "inline-flex";
     renderRendererCreditsControl(control.credits, accountCredits, locale);
-    return state.agent !== "codex" && adapterState === "ready" && !submissionBlocked;
+    return !submissionBlocked && (state.agent === "codex" || adapterState === "ready");
   }
   function disposeComposerAgentControl(control) {
     if (control.sendDisabledBeforeSwitch !== null) {
@@ -23023,6 +23087,7 @@ Codex Fast mode prioritizes requests and may increase usage.`
     }
     restoreNativeControl(control.nativeModelControl);
     restoreNativeControl(control.nativeContextUsageControl);
+    restoreNativeControl(control.nativeUsageBanner);
     restoreNativeControl(control.nativePermissionModeControl);
     control.credits.dispose();
     control.usage?.dispose();
@@ -23170,15 +23235,16 @@ Codex Fast mode prioritizes requests and may increase usage.`
         (name) => name.startsWith("__reactFiber$")
       );
       if (key) {
-        const owners = committedReactAncestors(
+        const candidates = committedReactAncestors(
           Object.getOwnPropertyDescriptor(element, key)?.value
         ).filter(
           ({ memoizedProps: props }) => isRecord3(props) && "onLocalSubmitStart" in props && typeof props.submitDisabled === "boolean"
         );
-        return owners.filter((owner) => {
-          const gates = gateSubscriptions(owner);
+        const owner = candidates.find((fiber) => {
+          const gates = subtreeGateSubscriptions(fiber);
           return !gates.invalid && gates.reserve.length > 0;
         });
+        return owner ? [owner] : candidates;
       }
       element = element.parentElement;
     }
@@ -23258,7 +23324,7 @@ Codex Fast mode prioritizes requests and may increase usage.`
     }
     const reserve = read.has("reserve.hardBlocked") && !read.has("reserve.active");
     const account = read.has("auth.authMethod") && read.has("limit.allowed");
-    if (account && (read.has("reserve.hardBlocked") || read.has("reserve.active"))) return "mixed";
+    if (account && read.has("reserve.hardBlocked")) return "mixed";
     if (reserve) return "reserve";
     if (account) return "account";
     return null;
@@ -23276,6 +23342,27 @@ Codex Fast mode prioritizes requests and may increase usage.`
       return false;
     }
   }
+  function projectionFor(projections, instance) {
+    return projections?.get(instance);
+  }
+  function sameLogicalGate(subscriptions) {
+    const first = subscriptions[0];
+    if (!first) return true;
+    return subscriptions.every((item) => item.store === first.store && item.atom === first.atom);
+  }
+  var MAX_SUBTREE_FIBERS = 1024;
+  function subtreeFibers(root) {
+    const result = [];
+    const stack = [root.child];
+    while (stack.length > 0) {
+      const fiber = stack.pop();
+      if (!isRecord3(fiber)) continue;
+      result.push(fiber);
+      if (result.length >= MAX_SUBTREE_FIBERS) return [];
+      stack.push(fiber.child, fiber.sibling);
+    }
+    return result;
+  }
   function gateSubscriptions(owner, projections) {
     const found = {
       account: [],
@@ -23286,23 +23373,34 @@ Codex Fast mode prioritizes requests and may increase usage.`
       const subscription = subscriptionAt(hook);
       const kind = subscription && gateKind(subscription);
       if (subscription && kind) {
-        if (kind !== "mixed" && snapshotsMatch(subscription, projections?.get(kind))) {
+        if (kind !== "mixed" && snapshotsMatch(subscription, projectionFor(projections, subscription.instance))) {
           found[kind].push(subscription);
         } else found.invalid = true;
       }
     }
     return found;
   }
+  function subtreeGateSubscriptions(owner, projections) {
+    const combined = {
+      account: [],
+      reserve: [],
+      invalid: false
+    };
+    for (const fiber of [owner, ...subtreeFibers(owner)]) {
+      const gates = gateSubscriptions(fiber, projections);
+      if (gates.invalid) combined.invalid = true;
+      combined.account.push(...gates.account);
+      combined.reserve.push(...gates.reserve);
+    }
+    if (!sameLogicalGate(combined.account) || !sameLogicalGate(combined.reserve)) {
+      combined.invalid = true;
+    }
+    return combined;
+  }
   function discoverGates(owner, projections) {
-    const gates = gateSubscriptions(owner, projections);
+    const gates = subtreeGateSubscriptions(owner, projections);
     if (gates.invalid) return null;
-    const found = /* @__PURE__ */ new Map();
-    for (const kind of ["account", "reserve"]) {
-      const subscriptions = gates[kind];
-      if (subscriptions.length > 1) return null;
-      if (subscriptions[0]) found.set(kind, subscriptions[0]);
-    }
-    return found;
+    return { account: gates.account, reserve: gates.reserve };
   }
   function project2({ subscriber, store, atom, instance, subscribeEffect }) {
     for (const [target, key] of [
@@ -23347,8 +23445,11 @@ Codex Fast mode prioritizes requests and may increase usage.`
   function isBound(owner, projections) {
     const alternate = isRecord3(owner.alternate) ? owner.alternate : null;
     const bound = [...projections];
-    return [owner, alternate].some((fiber) => {
-      const hooks = hooksOf(fiber);
+    const subtrees = [owner, alternate].flatMap(
+      (fiber) => fiber ? [[fiber, ...subtreeFibers(fiber)]] : []
+    );
+    return subtrees.some((fibers) => {
+      const hooks = fibers.flatMap((fiber) => hooksOf(fiber));
       return bound.every(
         ({ subscriber, instance }) => hooks.some(
           (hook) => Array.isArray(hook.memoizedState) && hook.memoizedState[0] === subscriber && hook.next?.queue === instance
@@ -23375,10 +23476,12 @@ Codex Fast mode prioritizes requests and may increase usage.`
     const bind = () => {
       const current = owner ?? findSubmitOwner(composer);
       const gates = current && discoverGates(current, projections);
-      if (!current || !gates?.has("reserve")) throw new Error("Codex usage gate is unavailable");
+      if (!current || !gates || gates.reserve.length === 0) {
+        throw new Error("Codex usage gate is unavailable");
+      }
       owner = current;
-      for (const [kind, gate] of gates) {
-        if (!projections.has(kind)) projections.set(kind, project2(gate));
+      for (const gate of [...gates.reserve, ...gates.account]) {
+        if (!projections.has(gate.instance)) projections.set(gate.instance, project2(gate));
       }
       return "bypassed";
     };
@@ -23392,7 +23495,6 @@ Codex Fast mode prioritizes requests and may increase usage.`
         release();
         retryAt = 0;
       }
-      if (owner && projections.size === 2) return "bypassed";
       if (Date.now() < retryAt) return owner ? "bypassed" : "unsupported";
       retryAt = Date.now() + RETRY_DELAY_MS;
       try {
@@ -30947,6 +31049,31 @@ ${detail}` : ""}`
         description.className = "settings-page-description";
         description.textContent = messages.appearanceDescription;
         const { group, card } = createPreferenceGroup(document2, messages.appearanceGroup);
+        const usageBannerId = preferenceId("hide-codex-usage-banner");
+        const usageBannerRow = createPreferenceItem(document2, {
+          title: messages.hideCodexUsageBannerTitle,
+          description: messages.hideCodexUsageBannerDescription,
+          controlId: usageBannerId,
+          help: {
+            label: messages.hideCodexUsageBannerHelpLabel,
+            lines: messages.hideCodexUsageBannerHelp
+          }
+        });
+        const usageBanner = createPreferenceSwitch(
+          document2,
+          usageBannerId,
+          usageBannerRow.description.id
+        );
+        usageBanner.checked = readCodexUsageBannerPreference(ownerWindow);
+        usageBanner.addEventListener("change", () => {
+          writeCodexUsageBannerPreference(ownerWindow, usageBanner.checked);
+        });
+        const syncUsageBanner = () => {
+          usageBanner.checked = readCodexUsageBannerPreference(ownerWindow);
+        };
+        ownerWindow.addEventListener(CODEX_USAGE_BANNER_CHANGE_EVENT, syncUsageBanner);
+        usageBannerRow.item.append(usageBanner);
+        card.append(usageBannerRow.item);
         const liveVoiceId = preferenceId("cpa-live-voice");
         const liveVoiceRow = createPreferenceItem(document2, {
           title: messages.cpaLiveVoiceTitle,
@@ -30996,6 +31123,7 @@ ${detail}` : ""}`
           getLoadedSessionsClient
         );
         return () => {
+          ownerWindow.removeEventListener(CODEX_USAGE_BANNER_CHANGE_EVENT, syncUsageBanner);
           ownerWindow.removeEventListener(CPA_LIVE_VOICE_CHANGE_EVENT, syncLiveVoice);
           ownerWindow.removeEventListener(REASONING_SOFT_WRAP_CHANGE_EVENT, sync);
           disposeIdleRelease();
@@ -39739,7 +39867,7 @@ ${usage_default}`;
       const currentCodexAccount = accounts?.accounts.find(
         ({ accountId }) => accountId === accounts.readyAccountId
       );
-      const externalSubmissionReady = renderComposerAgentControl(
+      const usageGateAllowed = renderComposerAgentControl(
         mounted.control,
         controller.get(mounted.composer),
         composerAdapterState(mounted),
@@ -39753,7 +39881,7 @@ ${usage_default}`;
         currentCodexAccount ?? null,
         mounted.ownershipStatus === "error"
       );
-      showCodexUsageGateStatus(mounted, mounted.codexUsageGate.update(externalSubmissionReady));
+      showCodexUsageGateStatus(mounted, mounted.codexUsageGate.update(usageGateAllowed));
       if (mounted.control.usage) {
         mounted.control.usage.onOpen = () => {
           void refreshThreadUsage(
@@ -41458,10 +41586,23 @@ ${usage_default}`;
         }
       }
     };
+    const onUsageBannerPreference = () => {
+      for (const mounted of mountedByComposer.values()) {
+        const hideCodexControls = controller.isSwitching(mounted.composer) || controller.get(mounted.composer).agent !== "codex";
+        reconcileComposerNativeControls(mounted.control, hideCodexControls, hideCodexControls);
+      }
+    };
+    const onUsageBannerStorage = (event) => {
+      if (event.key === CODEX_USAGE_BANNER_STORAGE_KEY || event.key === null) {
+        onUsageBannerPreference();
+      }
+    };
     window.addEventListener("codexhost:draft-prewarm-policy-changed", onHostRouteChange);
     window.addEventListener("codexhost:draft-workspace", onDraftWorkspace);
     window.addEventListener("codexhost:renderer-adapter-status", onAdapterStatus);
     window.addEventListener("focus", onWindowFocus);
+    window.addEventListener(CODEX_USAGE_BANNER_CHANGE_EVENT, onUsageBannerPreference);
+    window.addEventListener("storage", onUsageBannerStorage);
     delegationMention = installRendererDelegationMention(document, {
       onOpen: (editor) => {
         const composer = composerForElement(editor);
@@ -41625,6 +41766,8 @@ ${usage_default}`;
         window.removeEventListener("codexhost:draft-workspace", onDraftWorkspace);
         window.removeEventListener("codexhost:renderer-adapter-status", onAdapterStatus);
         window.removeEventListener("focus", onWindowFocus);
+        window.removeEventListener(CODEX_USAGE_BANNER_CHANGE_EVENT, onUsageBannerPreference);
+        window.removeEventListener("storage", onUsageBannerStorage);
         for (const state of harnessAvailabilityByHost.values()) {
           state.requestGeneration += 1;
           state.codexAccounts?.dispose();

package/package.json

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