minecodex 0.1.9 → 0.1.11

package/features/hide-upsell-banner/README.md

@@ -0,0 +1,27 @@
+# Hide Upsell Banner
+
+隐藏 Codex 桌面应用在输入区上方渲染的
+“You're out of Codex and Work usage”用量耗尽横幅（upsell banner）。
+
+这是一个 `page-script` 类型的轻量功能：不启动 HTTP 服务、没有 Sidebar 或
+Toolbar 入口，由 `CodexRuntimeHost` 在渲染进程内注入一段脚本。
+
+功能范围：
+
+- 仅隐藏横幅的 GUI 显示（`aside` 卡片，`display: none`）；
+- 不拦截、不篡改额度查询接口（`account/rateLimits/read` 与 app-server
+  JSON-RPC 流量保持原样）；
+- 横幅重新渲染时由 `MutationObserver` 持续处理，不会闪烁后残留；
+- 注入运行时随 RuntimeHost 卸载自动清理（恢复元素样式、断开 observer）。
+
+## 验证
+
+```bash
+npm test
+```
+
+## 适配说明
+
+这是非官方 CDP / DOM Adapter 的功能声明。Codex 私有 DOM 的适配实现统一留在
+`CodexRuntimeHost`；本功能只声明横幅的识别规则（卡片类名 + 文案特征）与
+隐藏动作。

package/features/hide-upsell-banner/codex-feature.json

@@ -0,0 +1,24 @@
+{
+  "schemaVersion": 1,
+  "id": "hide-upsell-banner",
+  "version": "0.1.11",
+  "label": {
+    "en": "Hide Upsell Banner",
+    "zh-CN": "隐藏用量横幅"
+  },
+  "description": {
+    "en": "Hide the rate-limit upsell banner in the composer while leaving usage checks untouched.",
+    "zh-CN": "隐藏输入区上方的用量耗尽横幅，不拦截额度查询功能。"
+  },
+  "entry": {
+    "kind": "page-script",
+    "script": "src/hide-upsell-banner.mjs"
+  },
+  "icon": {
+    "viewBox": "0 0 24 24",
+    "markup": "<rect width=\"18\" height=\"12\" x=\"3\" y=\"6\" rx=\"2.5\"></rect><path d=\"m5 5 14 14\"></path>"
+  },
+  "placement": {
+    "order": 40
+  }
+}

package/features/hide-upsell-banner/src/hide-upsell-banner.mjs

@@ -0,0 +1,72 @@
+// page-script feature body.
+// Injected by CodexRuntimeHost into the Codex renderer through
+// `new Function("signal", "window", "document", "MutationObserver", source)`,
+// so this file is a function body: it runs once with those bindings in scope
+// and may return a cleanup function. It hides the "You're out of Codex and
+// Work usage" upsell banner that the desktop app renders above the composer
+// when the account rate-limit snapshot marks the plan as exhausted. It never
+// touches the rate-limit query path: `account/rateLimits/read` and the
+// app-server JSON-RPC traffic stay intact.
+const HIDDEN_MARKER = "data-codex-upsell-banner-hidden";
+
+function isUpsellBanner(element) {
+  if (!(element instanceof window.HTMLElement)) return false;
+  const text = (element.innerText ?? "").trim();
+  if (!text) return false;
+  const isCard = element.classList.contains("rounded-2xl")
+    && element.classList.contains("border")
+    && element.classList.contains("bg-token-main-surface-primary");
+  if (!isCard) return false;
+  const titleMatch = /out of Codex and Work usage/i.test(text)
+    || /out of Codex messages/i.test(text)
+    || /Codex message usage limit reached/i.test(text);
+  const actionMatch = /Upgrade to Pro|Add Credits/i.test(text);
+  return titleMatch && actionMatch;
+}
+
+function hideBanner(element) {
+  if (element.hasAttribute(HIDDEN_MARKER)) return;
+  element.setAttribute(HIDDEN_MARKER, "");
+  element.style.display = "none";
+}
+
+function hideVisibleBanners(root = document) {
+  if (root.matches?.("aside") && isUpsellBanner(root)) hideBanner(root);
+  for (const element of root.querySelectorAll("aside")) {
+    if (isUpsellBanner(element)) hideBanner(element);
+  }
+}
+
+let rescanQueued = false;
+function rescanBanners() {
+  // React can render the banner in stages: an empty <aside> shell first, then
+  // text and style updates on the same element. A childList-only observer
+  // misses those later mutations, so every mutation triggers a full rescan
+  // instead of only inspecting freshly added nodes.
+  if (rescanQueued) return;
+  rescanQueued = true;
+  queueMicrotask(() => {
+    rescanQueued = false;
+    hideVisibleBanners(document);
+  });
+}
+
+hideVisibleBanners();
+const observer = new MutationObserver(() => {
+  rescanBanners();
+});
+observer.observe(document.documentElement, {
+  childList: true,
+  subtree: true,
+  attributes: true,
+  attributeFilter: ["style", "class", "hidden"],
+  characterData: true,
+});
+
+return () => {
+  observer.disconnect();
+  for (const element of document.querySelectorAll(`[${HIDDEN_MARKER}]`)) {
+    element.removeAttribute(HIDDEN_MARKER);
+    element.style.display = "";
+  }
+};

package/features/images/codex-feature.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "id": "images",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "label": {
     "en": "Images",
     "zh-CN": "图片"

package/features/model-slider/codex-feature.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "id": "model-slider",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "label": {
     "en": "Model Slider",
     "zh-CN": "模型滑条"

package/features/notes/codex-feature.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "id": "notes",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "label": {
     "en": "Notes",
     "zh-CN": "笔记"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecodex",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",
@@ -29,6 +29,8 @@
     "features/images/src",
     "features/images/web",
     "features/images/codex-feature.json",
+    "features/hide-upsell-banner/src",
+    "features/hide-upsell-banner/codex-feature.json",
     "apps/dashboard/app.js",
     "apps/dashboard/favicon.svg",
     "apps/dashboard/index.html",
@@ -40,7 +42,7 @@
   },
   "scripts": {
     "start": "node packages/cli/bin/mcx.mjs serve",
-    "test": "node --test packages/cli/test/*.test.mjs packages/runtime-host/test/*.test.mjs features/model-slider/test/*.test.mjs features/notes/test/*.test.mjs features/images/test/*.test.mjs apps/dashboard/test/*.test.mjs",
+    "test": "node --test packages/cli/test/*.test.mjs packages/runtime-host/test/*.test.mjs features/model-slider/test/*.test.mjs features/notes/test/*.test.mjs features/images/test/*.test.mjs features/hide-upsell-banner/test/*.test.mjs apps/dashboard/test/*.test.mjs",
     "test:cli": "node --test packages/cli/test/*.test.mjs",
     "test:runtime": "node --test packages/runtime-host/test/*.test.mjs",
     "check": "node --check packages/cli/bin/mcx.mjs && node --check packages/cli/src/*.mjs && node --check packages/runtime-host/src/*.mjs",

package/packages/cli/src/config.mjs

@@ -2,13 +2,14 @@ import { randomBytes } from "node:crypto";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import path from "node:path";
 
-export const FEATURE_IDS = Object.freeze(["model-slider", "notes", "images"]);
+export const FEATURE_IDS = Object.freeze(["model-slider", "notes", "images", "hide-upsell-banner"]);
 export const DEFAULT_CONFIG = Object.freeze({
   schemaVersion: 1,
   features: Object.freeze({
     "model-slider": true,
     notes: true,
     images: true,
+    "hide-upsell-banner": true,
   }),
 });
 

package/packages/cli/src/control-server.mjs

@@ -204,6 +204,13 @@ async function iconResponse(id, paths, response) {
     response.writeHead(200, { "Content-Type": "image/svg+xml", "Cache-Control": "public, max-age=3600" });
     response.end(svg);
     return;
+  } else if (id === "hide-upsell-banner") {
+    const manifest = JSON.parse(await readFile(path.join(paths.featuresRoot, id, "codex-feature.json"), "utf8"));
+    const viewBox = manifest.icon?.viewBox ?? "0 0 24 24";
+    const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="${viewBox}" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round">${manifest.icon.markup}</svg>`;
+    response.writeHead(200, { "Content-Type": "image/svg+xml", "Cache-Control": "public, max-age=3600" });
+    response.end(svg);
+    return;
   } else {
     json(response, 404, { error: "NOT_FOUND" });
     return;

package/packages/runtime-host/src/codex-runtime.mjs

@@ -105,6 +105,14 @@ export function createInjectionSource(features, {
 } = {}) {
   function install(config) {
     if (window.top !== window) return;
+    if (!document.documentElement) {
+      // The document bootstrap runs before the root element exists. Defer the
+      // whole install until the DOM is ready instead of crashing on a null
+      // documentElement (which previously left the runtime permanently absent
+      // after a renderer reload).
+      document.addEventListener("DOMContentLoaded", () => install(config), { once: true });
+      return;
+    }
     const currentRuntime = window.__codexPersonalRuntime;
     if (currentRuntime?.version === config.version && currentRuntime?.sessionId === config.sessionId) {
       currentRuntime.ensure();
@@ -247,6 +255,7 @@ export function createInjectionSource(features, {
     const modelSelectorFeature = features.find(
       (feature) => feature.entry?.kind === "composer-model-selector",
     ) ?? null;
+    const pageScriptFeatures = features.filter((feature) => feature.entry?.kind === "page-script");
     const pageSurfaces = new Map();
     const pinnedSurfaces = new Map();
     const surfaceRecords = new Map();
@@ -269,6 +278,7 @@ export function createInjectionSource(features, {
     let shiftedThreadOriginal = null;
     let mainContentObserver = null;
     const domObservers = [];
+    const pageScriptCleanups = [];
     const pendingHostActions = new Map();
     let activeModalRecordKey = null;
     let activePromptPreview = null;
@@ -367,6 +377,24 @@ export function createInjectionSource(features, {
       void loadNativeFastIcon();
     }
 
+    for (const feature of pageScriptFeatures) {
+      const source = feature.pageScript?.source ?? "";
+      if (!source.trim()) continue;
+      try {
+        const installer = new Function(
+          "signal",
+          "window",
+          "document",
+          "MutationObserver",
+          `"use strict";\n${source}`,
+        );
+        const cleanup = installer(lifetime.signal, window, document, MutationObserver);
+        if (typeof cleanup === "function") pageScriptCleanups.push(cleanup);
+      } catch (error) {
+        console.warn(`[codex-personal] page-script feature failed: ${feature.id}`, error);
+      }
+    }
+
     function findEntry(featureId) {
       return Array.from(document.querySelectorAll(`[${entryMarker}]`)).find(
         (entry) => entry.getAttribute(entryMarker) === featureId,
@@ -3451,6 +3479,11 @@ export function createInjectionSource(features, {
       resolveHostAction,
       dispose: () => {
         lifetime.abort();
+        for (const cleanup of pageScriptCleanups.splice(0)) {
+          try { cleanup(); } catch (error) {
+            console.warn("[codex-personal] page-script cleanup failed", error);
+          }
+        }
         if (ensureFrame != null) cancelAnimationFrame(ensureFrame);
         if (ensureTimer != null) clearTimeout(ensureTimer);
         for (const observer of domObservers) observer.disconnect();
@@ -3487,6 +3520,7 @@ export function createInjectionSource(features, {
     detailTabs: feature.detailTabs ?? [],
     hostActions: feature.hostActions ?? [],
     modelSelector: feature.modelSelector ?? null,
+    pageScript: feature.pageScript ?? null,
   }));
   return `(${install.toString()})(${JSON.stringify({
     version: RUNTIME_VERSION,

package/packages/runtime-host/src/feature-registry.mjs

@@ -13,6 +13,8 @@ const HOST_ACTIONS = new Set([
   "resolve-file-paths",
 ]);
 
+const PAGE_SCRIPT_ENTRY_KINDS = new Set(["page-script"]);
+
 export const FEATURE_PROTOCOL_VERSION = 1;
 export const FEATURE_HEALTH_TIMEOUT_MS = 750;
 export const FEATURE_STARTUP_TIMEOUT_MS = 1_000;
@@ -127,6 +129,23 @@ async function normalizeModelSelector(modelSelector, projectDir) {
   };
 }
 
+async function normalizePageScript(manifest, projectDir) {
+  const resource = manifest.entry?.script ?? manifest.pageScript?.resource ?? manifest.script;
+  if (!resource) {
+    throw new Error("page-script entries require entry.script or script.resource");
+  }
+  const scriptPath = path.resolve(projectDir, resource);
+  const relative = path.relative(projectDir, scriptPath);
+  if (relative.startsWith("..") || path.isAbsolute(relative)) {
+    throw new Error("page-script resource must stay inside the feature project");
+  }
+  const source = await readFile(scriptPath, "utf8");
+  if (!source.trim()) {
+    throw new Error("page-script resource must be a non-empty script file");
+  }
+  return { resource, source };
+}
+
 async function normalizeFeature(manifest, projectDir) {
   if (manifest.schemaVersion !== 1) throw new Error("schemaVersion must be 1");
   if (!manifest.id || !manifest.label) {
@@ -135,11 +154,12 @@ async function normalizeFeature(manifest, projectDir) {
 
   const label = normalizeLocalizedText(manifest.label, "label");
   const entryKind = manifest.entry?.kind ?? "sidebar";
-  if (!new Set(["sidebar", "conversation-toolbar", "composer-model-selector"]).has(entryKind)) {
-    throw new Error("entry.kind must be sidebar, conversation-toolbar, or composer-model-selector");
+  if (!new Set(["sidebar", "conversation-toolbar", "composer-model-selector", ...PAGE_SCRIPT_ENTRY_KINDS]).has(entryKind)) {
+    throw new Error("entry.kind must be sidebar, conversation-toolbar, composer-model-selector, or page-script");
   }
   const isModelSelector = entryKind === "composer-model-selector";
-  if (!isModelSelector && !manifest.surfaceUrl) {
+  const isPageScript = PAGE_SCRIPT_ENTRY_KINDS.has(entryKind);
+  if (!isModelSelector && !isPageScript && !manifest.surfaceUrl) {
     throw new Error("surfaceUrl is required for rendered features");
   }
   if (entryKind === "conversation-toolbar" && !manifest.entry?.ariaLabel) {
@@ -222,6 +242,9 @@ async function normalizeFeature(manifest, projectDir) {
     modelSelector: isModelSelector
       ? await normalizeModelSelector(manifest.modelSelector, projectDir)
       : null,
+    pageScript: isPageScript
+      ? await normalizePageScript(manifest, projectDir)
+      : null,
     placement: {
       after: manifest.placement?.after ?? "sites",
       order: Number(manifest.placement?.order ?? 100),