minecodex 0.1.8 → 0.1.10

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.10",
+  "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,60 @@
+// 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);
+  }
+}
+
+hideVisibleBanners();
+const observer = new MutationObserver((records) => {
+  for (const record of records) {
+    for (const node of record.addedNodes) {
+      if (node.nodeType !== Node.ELEMENT_NODE) continue;
+      hideVisibleBanners(node);
+    }
+  }
+});
+observer.observe(document.documentElement, {
+  childList: true,
+  subtree: 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.8",
+  "version": "0.1.10",
   "label": {
     "en": "Images",
     "zh-CN": "图片"

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

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

package/features/notes/codex-feature.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecodex",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "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

@@ -11,6 +11,7 @@ const CODEX_APP_ORIGIN = "app://-";
 const SURFACE_LOAD_ACTION = "load-surface";
 const SURFACE_FRAME_PREFIX = "minecodex-surface-";
 const LOOPBACK_SURFACE_HOSTS = new Set(["127.0.0.1", "localhost", "::1", "[::1]"]);
+const RIGHT_PANEL_ROUTE_KINDS = Object.freeze(["home", "local-thread"]);
 
 export const RESPONSIVE_SUMMARY_LAYOUT = Object.freeze({
   contentBaseWidth: 736,
@@ -112,6 +113,7 @@ export function createInjectionSource(features, {
     currentRuntime?.dispose?.();
 
     const lifetime = new AbortController();
+    const rightPanelRouteKinds = new Set(config.rightPanelRouteKinds);
 
     const entryMarker = "data-codex-personal-feature";
     const pageSurfaceMarker = "data-codex-personal-surface";
@@ -245,6 +247,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();
@@ -267,6 +270,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;
@@ -365,6 +369,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,
@@ -2701,7 +2723,7 @@ export function createInjectionSource(features, {
       return key ? element[key] : null;
     }
 
-    function currentTaskScope() {
+    function currentRightPanelScope() {
       let anchor = document.querySelector('[data-app-shell-tabs="true"]');
       let anchorFiber = reactFiberFor(anchor);
       if (!anchorFiber) {
@@ -2718,12 +2740,12 @@ export function createInjectionSource(features, {
       let rootFiber = anchorFiber;
       while (rootFiber.return) rootFiber = rootFiber.return;
 
-      const isTaskScope = (value) => (
+      const isRightPanelScope = (value) => (
         value
         && typeof value === "object"
         && typeof value.get === "function"
         && typeof value.set === "function"
-        && value.value?.routeKind === "local-thread"
+        && rightPanelRouteKinds.has(value.value?.routeKind)
         && typeof value.query?.getOrFetch === "function"
       );
       const inspected = new Set();
@@ -2734,8 +2756,8 @@ export function createInjectionSource(features, {
           || inspected.has(value)
         ) return null;
         inspected.add(value);
-        if (isTaskScope(value)) return value;
-        if (isTaskScope(value.current)) return value.current;
+        if (isRightPanelScope(value)) return value;
+        if (isRightPanelScope(value.current)) return value.current;
         return null;
       };
 
@@ -2769,10 +2791,10 @@ export function createInjectionSource(features, {
       return null;
     }
 
-    async function waitForCurrentTaskScope() {
+    async function waitForCurrentRightPanelScope() {
       const deadline = performance.now() + 2_000;
       do {
-        const scope = currentTaskScope();
+        const scope = currentRightPanelScope();
         if (scope) return scope;
         await new Promise((resolve) => setTimeout(resolve, 50));
       } while (performance.now() < deadline);
@@ -2810,6 +2832,7 @@ export function createInjectionSource(features, {
             typeof controller?.openTab !== "function"
             || typeof controller?.activateTab !== "function"
             || typeof controller?.closeTab !== "function"
+            || !controller?.tabById$
             || typeof jsx?.jsx !== "function"
             || typeof React?.useLayoutEffect !== "function"
             || typeof React?.useRef !== "function"
@@ -2923,17 +2946,31 @@ export function createInjectionSource(features, {
       return reloaded;
     }
 
+    async function waitForNativeDetailTabMount(scope, controller, tabId, detailKey) {
+      const deadline = performance.now() + 2_000;
+      do {
+        let registered = false;
+        try {
+          registered = scope.get(controller.tabById$, tabId) != null;
+        } catch {}
+        if (registered && nativeDetailSurfaceKeys.has(detailKey)) return true;
+        await new Promise((resolve) => setTimeout(resolve, 25));
+      } while (performance.now() < deadline);
+      return false;
+    }
+
     async function openNativeDetailTab(feature, detail) {
       const capability = await loadNativeTabCapability();
       if (!capability) return null;
-      const scope = await waitForCurrentTaskScope();
+      const scope = await waitForCurrentRightPanelScope();
       if (!scope) {
-        nativeTabCapabilityError = new Error("The current Codex Task scope was not found");
+        nativeTabCapabilityError = new Error("The current Codex right-panel scope was not found");
         return null;
       }
 
       const { controller, jsx } = capability;
       const tabId = `${feature.id}-${detail.id}`;
+      const detailKey = `${feature.id}:${detail.id}`;
       let session = Array.from(nativeOpenTabSessions).find((candidate) => (
         candidate.scope === scope && candidate.tabId === tabId
       ));
@@ -2966,6 +3003,17 @@ export function createInjectionSource(features, {
         return null;
       }
 
+      if (!await waitForNativeDetailTabMount(scope, controller, tabId, detailKey)) {
+        if (isNewSession) nativeOpenTabSessions.delete(session);
+        if (!focusedExisting) {
+          try {
+            controller.closeTab(scope, tabId);
+          } catch {}
+        }
+        nativeTabCapabilityError = new Error("Codex native right-panel Tab did not mount");
+        return null;
+      }
+
       nativeTabCapabilityError = null;
       if (focusedExisting) reloadNativeDetailIfUnready(feature, detail);
       return { tabId, focusedExisting, presentation: "native" };
@@ -3423,6 +3471,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();
@@ -3459,6 +3512,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,
@@ -3466,6 +3520,7 @@ export function createInjectionSource(features, {
     bindingName,
     bindingToken,
     summaryLayout: RESPONSIVE_SUMMARY_LAYOUT,
+    rightPanelRouteKinds: RIGHT_PANEL_ROUTE_KINDS,
     features: runtimeFeatures,
   })})`;
 }

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),