minecodex 1.2.2 → 2.0.0

package/features/usage-meter/DESIGN.md

@@ -0,0 +1,49 @@
+# Usage Meter
+
+## 用户任务与范围
+
+在原生导航栏 Help 与 Account 之间查看当前账号剩余额度，点击直达 Settings → Usage。
+仅向 `nav[data-app-navigation-rail="true"]` 注入一个控件，不注册通用侧栏
+菜单项，不向 Settings 的分类列表插入内容。
+
+## 数据契约
+
+已在 2026-09-27 的隔离 Codex 中确认：原生 QueryClient 缓存
+`["rate-limit-status", userId, accountId]`，由 Codex 自行通过流/轮询更新。
+插件只订阅该缓存，按当前原生 auth 的 userId/accountId 精确读取，不自行请求
+接口，不持久化账号或额度数据。切换账号、退出登录、额度数据缺失时隐藏旧值。
+
+窗口按 `limit_window_seconds` 识别：604800 为周、18000 为五小时；不依赖
+primary/secondary 顺序或套餐字符串。剩余百分比为 clamp(100-used_percent,0,100)，
+四舍五入显示整数。缺失/非法值不当成零。
+
+单周窗口显示一个周环和周剩余数字。周与五小时同时存在时，周在外、五小时在内，
+中央显示五小时剩余数字，不带百分号。没有周窗口时不显示本控件。
+
+## 视觉 tokens
+
+| 角色 | 权威 token / 值 | 用途 |
+| --- | --- | --- |
+| 点击区域 | 克隆 Help 的原生按钮 class 和 data 样式属性；当前 36×36px | 与导航项对齐 |
+| 环图 | 24×24px；viewBox 32；圆心 16；周半径 43/3、五小时半径 10.5；描边 10/3 viewBox units（渲染 2.5px） | 自定义数据图，不是替代导航图标 |
+| 周环 | 继承 Help 按钮的 `currentColor`（原生 tertiary 中性灰） | 单圈或外圈 |
+| 五小时环 | `--color-text-secondary`（中性灰） | 双圈内圈 |
+| 轨道 | 对应环色 18% alpha | 剩余额度的底轨 |
+| 中央数字 | 继承 Help 的颜色；`--font-sans-default`；`--text-xs` × 2/3（8px），单双圈与三位数均一致；500、tabular-nums、line-height:1 | 优先五小时 |
+| Tooltip | `--color-background-tooltip` / `--color-text-tooltip` / `--color-border-tooltip` / `--shadow-tooltip` | 与原生 Help Tooltip 一致 |
+| Tooltip 几何 | `--radius-2xl`；5px 12px padding；`--text-sm` / 18px；两列 gap 16px | label 左、数字右对齐 |
+| Tooltip 字体 | `--tooltip-compact-font-weight` / `--tracking-tooltip` | 与原生紧凑提示一致 |
+
+环从顶部顺时针填充。Tooltip 在按钮右侧 2px，纵向居中并约束在窗口内；
+鼠标悬停延迟 350ms，键盘聚焦立即显示，Escape 隐藏。单圈一行 Weekly Limit；
+双圈依次为 5h Limit、Weekly Limit，数值带 %。没有额外标题或说明。
+
+原生 Help 图标为 20px，点击区域 36px。Account 头像可见直径为 24px；额度外环含描边的可见直径同为 24px，
+数字与环均以按钮几何中心对齐；中性灰取自原生 navbar，不使用彩色强调。
+单双圈使用同一实现，双圈验收图采用模拟值，不更改账号缓存。减少动画偏好不添加进度过渡。
+
+## 跳转与生命周期
+
+已确认原生入口指向 `/settings/usage?tab=overview`。使用当前 React Router
+的 navigate，并保留当前路由 state；不模拟设置菜单内部点击。
+移除功能时清除缓存订阅、DOM observer、事件、Tooltip 与按钮。

package/features/usage-meter/README.md

@@ -0,0 +1,18 @@
+# Usage Meter · 额度环
+
+在 Codex 原生 navbar 的 Help 与 Account 之间显示当前登录账号的**剩余额度**。
+
+- 只有周额度：单圈，中心为周剩余百分比整数。
+- 同时有周与五小时额度：外圈为周、内圈为五小时，中心显示五小时剩余数字。
+- 悬浮或键盘聚焦显示 Tooltip；双圈时先显示 `5h Limit`，再显示 `Weekly Limit`，标签左对齐、百分比右对齐。
+- 点击进入原生 Settings → Usage。
+
+数据直接订阅当前账号的原生额度缓存，与 Usage 页同步。窗口类型按实际时长识别，
+不通过套餐名称猜测。缺失数据、退出登录或切换账号时不展示旧额度。
+不新增 API 请求，不持久化账号信息，不修改 Settings 分类导航。
+
+MineCodex 管理页面可单独开关此功能。设计与原生接入契约见 [DESIGN.md](DESIGN.md)。
+
+```bash
+node --test features/usage-meter/test/*.test.mjs
+```

package/features/usage-meter/codex-feature.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": 1,
+  "id": "usage-meter",
+  "version": "0.1.0",
+  "label": { "en": "Usage Meter", "zh-CN": "额度环" },
+  "description": {
+    "en": "Show remaining weekly and 5-hour limits between Help and Account and open Usage settings.",
+    "zh-CN": "在 Help 与 Account 之间显示周与五小时剩余额度，点击进入 Usage 设置。"
+  },
+  "entry": { "kind": "page-script", "script": "src/usage-meter.mjs" },
+  "icon": { "viewBox": "0 0 24 24", "markup": "<circle cx=\"12\" cy=\"12\" r=\"9\"></circle><circle cx=\"12\" cy=\"12\" r=\"5\"></circle>" },
+  "placement": { "order": 60 }
+}

package/features/usage-meter/src/usage-meter.mjs

@@ -0,0 +1,200 @@
+// 订阅原生额度缓存；不另行轮询，也不复制账号信息到插件服务。
+const MARKER = "data-minecodex-usage-meter";
+const TIP_ID = "minecodex-usage-tooltip";
+const STYLE_ID = "minecodex-usage-style";
+let record = null;
+let client = null;
+let unsubscribe = null;
+let queued = false;
+let hoverTimer = null;
+
+function remainingWindows(data) {
+  const windows = [data?.rate_limit?.primary_window, data?.rate_limit?.secondary_window];
+  const remaining = seconds => {
+    const window = windows.find(window => window?.limit_window_seconds === seconds);
+    return typeof window?.used_percent === "number" && Number.isFinite(window.used_percent)
+      ? Math.round(Math.max(0, Math.min(100, 100 - window.used_percent))) : null;
+  };
+  const weekly = remaining(604800), fiveHour = remaining(18000);
+  return weekly == null ? null : { weekly, fiveHour, primary: fiveHour ?? weekly };
+}
+
+function nativeContext(rail) {
+  const key = Object.keys(rail).find(key => key.startsWith("__reactFiber$"));
+  let fiber = key ? rail[key] : null;
+  const result = { auth: null, client: null, router: null };
+  for (let depth = 0; fiber && depth < 200; depth++, fiber = fiber.return) {
+    const props = fiber.memoizedProps;
+    if (!props) continue;
+    for (const value of [props.auth, props.value]) {
+      if (!result.auth && value && typeof value === "object" && "authMethod" in value && "userId" in value && "accountId" in value) result.auth = value;
+    }
+    for (const value of [props.queryClient, props.client, props.value]) {
+      if (!result.client && typeof value?.getQueryCache === "function" && typeof value?.getQueryData === "function") result.client = value;
+    }
+    const router = props.router ?? props.value?.router;
+    if (!result.router && typeof router?.navigate === "function") result.router = router;
+    if (result.auth && result.client && result.router) break;
+  }
+  return result;
+}
+
+function currentWindows(context) {
+  const { auth, client } = context;
+  if (auth?.isLoading || !auth?.userId || !auth?.accountId || !["chatgpt", "chatgptAuthTokens"].includes(auth.authMethod)) return null;
+  const data = client?.getQueryData(["rate-limit-status", auth.userId, auth.accountId]);
+  // 账号与缓存必须同时一致；旧账号的最后一次响应不能留在导航栏。
+  if (!data || data.user_id !== auth.userId || data.account_id !== auth.accountId) return null;
+  return remainingWindows(data);
+}
+
+const style = document.createElement("style");
+style.id = STYLE_ID;
+style.textContent = `
+[${MARKER}] { position:relative; display:flex; align-items:center; justify-content:center; flex:none; -webkit-app-region:no-drag; }
+[${MARKER}] .mcx-usage-ring { display:block; width:24px; height:24px; overflow:visible; }
+[${MARKER}] .mcx-usage-number { position:absolute; inset:0; display:flex; align-items:center; justify-content:center; color:inherit; font-family:var(--font-sans-default); font-size:calc(var(--text-xs) * 2 / 3); line-height:1; font-weight:500; letter-spacing:0; font-variant-numeric:tabular-nums; pointer-events:none; }
+[${MARKER}] [data-window="weekly"] { color:inherit; }
+[${MARKER}] [data-window="fiveHour"] { color:var(--color-text-secondary); }
+#${TIP_ID} { position:fixed; z-index:2147483000; width:max-content; max-width:calc(100vw - 16px); pointer-events:none; user-select:none; padding:5px 12px; border:1px solid var(--color-border-tooltip); border-radius:var(--radius-2xl); background:var(--color-background-tooltip); color:var(--color-text-tooltip); box-shadow:var(--shadow-tooltip); font-family:var(--font-sans-default); font-size:var(--text-sm); line-height:18px; font-weight:var(--tooltip-compact-font-weight); letter-spacing:var(--tracking-tooltip); }
+#${TIP_ID}[hidden] { display:none; }
+#${TIP_ID} dl { display:grid; grid-template-columns:auto auto; gap:2px 16px; margin:0; }
+#${TIP_ID} dt { text-align:left; }
+#${TIP_ID} dd { margin:0; text-align:right; font-variant-numeric:tabular-nums; }
+`;
+document.head.append(style);
+
+function svgNode(name, attributes) {
+  const node = document.createElementNS("http://www.w3.org/2000/svg", name);
+  for (const [key, value] of Object.entries(attributes)) node.setAttribute(key, String(value));
+  return node;
+}
+
+function draw(windows) {
+  const svg = svgNode("svg", { viewBox: "0 0 32 32", class: "mcx-usage-ring", "aria-hidden": "true" });
+  for (const [key, radius] of [["weekly", 43 / 3], ["fiveHour", 10.5]]) {
+    if (windows[key] == null) continue;
+    const group = svgNode("g", { "data-window": key, fill: "none", stroke: "currentColor", "stroke-width": 10 / 3 });
+    group.append(svgNode("circle", { cx: 16, cy: 16, r: radius, opacity: 0.18 }));
+    if (windows[key] > 0) group.append(svgNode("circle", {
+      cx: 16, cy: 16, r: radius, pathLength: 100,
+      "stroke-dasharray": `${windows[key]} 100`, "stroke-linecap": "round", transform: "rotate(-90 16 16)",
+    }));
+    svg.append(group);
+  }
+  const number = document.createElement("span");
+  number.className = "mcx-usage-number";
+  number.textContent = String(windows.primary);
+  number.setAttribute("data-dual", String(windows.fiveHour != null));
+  number.setAttribute("data-digits", String(number.textContent.length));
+  record.button.replaceChildren(svg, number);
+  const list = document.createElement("dl");
+  const rows = windows.fiveHour == null ? [] : [["5h Limit", windows.fiveHour]];
+  rows.push(["Weekly Limit", windows.weekly]);
+  for (const [label, percent] of rows) {
+    const term = document.createElement("dt"), value = document.createElement("dd");
+    term.textContent = label;
+    value.textContent = `${percent}%`;
+    list.append(term, value);
+  }
+  record.tooltip.replaceChildren(list);
+  record.button.setAttribute("aria-label", rows.map(([label, percent]) => `${label} ${percent}%`).join(", "));
+  record.button.setAttribute("aria-description", "Open Usage settings");
+  if (!record.tooltip.hidden) positionTooltip();
+}
+
+function positionTooltip() {
+  if (!record) return;
+  const rect = record.button.getBoundingClientRect();
+  const tooltip = record.tooltip;
+  // 按物理视口定位，兼容原生 app-shell 的 CSS zoom。
+  tooltip.style.left = `${Math.max(8, Math.min(rect.right + 2, window.innerWidth - tooltip.offsetWidth - 8))}px`;
+  tooltip.style.top = `${Math.max(8, Math.min(rect.top + (rect.height - tooltip.offsetHeight) / 2, window.innerHeight - tooltip.offsetHeight - 8))}px`;
+}
+
+function showTooltip() {
+  clearTimeout(hoverTimer);
+  if (!record) return;
+  record.tooltip.hidden = false;
+  record.button.setAttribute("aria-describedby", TIP_ID);
+  positionTooltip();
+}
+function hideTooltip() {
+  clearTimeout(hoverTimer);
+  if (!record) return;
+  record.tooltip.hidden = true;
+  record.button.removeAttribute("aria-describedby");
+}
+function removeControl() {
+  hideTooltip();
+  record?.button.remove();
+  record?.tooltip.remove();
+  record = null;
+}
+
+function mount(help, rail) {
+  // 只克隆按钮的外观属性，不携带原生 Help 的菜单行为或 id。
+  const button = help.cloneNode(false);
+  for (const attribute of [...button.attributes]) {
+    if (attribute.name.startsWith("aria-") || attribute.name === "id" || attribute.name === "data-state") button.removeAttribute(attribute.name);
+  }
+  button.setAttribute(MARKER, "");
+  const tooltip = document.createElement("div");
+  tooltip.id = TIP_ID;
+  tooltip.setAttribute("role", "tooltip");
+  tooltip.hidden = true;
+  const anchor = help.parentElement.classList.contains("contents") ? help.parentElement : help;
+  anchor.after(button);
+  document.body.append(tooltip);
+  record = { button, tooltip, rail, help, signature: null };
+  button.addEventListener("pointerenter", () => { hoverTimer = setTimeout(showTooltip, 350); });
+  button.addEventListener("pointerleave", hideTooltip);
+  button.addEventListener("focus", showTooltip);
+  button.addEventListener("blur", hideTooltip);
+  button.addEventListener("keydown", event => { if (event.key === "Escape") { event.stopPropagation(); hideTooltip(); } });
+  button.addEventListener("click", () => {
+    hideTooltip();
+    const { router } = nativeContext(rail);
+    router?.navigate("/settings/usage?tab=overview", { state: router.state?.location?.state });
+  });
+}
+
+function sync() {
+  queued = false;
+  if (signal.aborted) return;
+  const rail = [...document.querySelectorAll('nav[data-app-navigation-rail="true"]')].find(rail => rail.getBoundingClientRect().width > 0);
+  const help = rail?.querySelector('button[aria-label="Help menu"],button[aria-label="帮助菜单"]');
+  const context = rail ? nativeContext(rail) : {};
+  if (client !== context.client) {
+    unsubscribe?.();
+    client = context.client;
+    unsubscribe = client?.getQueryCache().subscribe(event => {
+      if (event.query?.queryKey?.[0] === "rate-limit-status") schedule();
+    });
+  }
+  const windows = currentWindows(context);
+  if (!help || !context.router || !windows) { removeControl(); return; }
+  if (record?.help !== help || !record?.button.isConnected) { removeControl(); mount(help, rail); }
+  const signature = JSON.stringify(windows);
+  if (record.signature !== signature) { record.signature = signature; draw(windows); }
+}
+function schedule() {
+  if (queued || signal.aborted) return;
+  queued = true;
+  queueMicrotask(sync);
+}
+const observer = new MutationObserver(schedule);
+observer.observe(document.documentElement, { childList: true, subtree: true, attributes: true, attributeFilter: ["aria-label"] });
+window.addEventListener("resize", positionTooltip);
+window.addEventListener("focus", schedule);
+const cleanup = () => {
+  observer.disconnect();
+  unsubscribe?.();
+  window.removeEventListener("resize", positionTooltip);
+  window.removeEventListener("focus", schedule);
+  removeControl();
+  style.remove();
+};
+signal.addEventListener("abort", cleanup, { once: true });
+sync();
+return cleanup;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecodex",
-  "version": "1.2.2",
+  "version": "2.0.0",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",
@@ -23,9 +23,10 @@
     "features/model-slider/THIRD_PARTY_NOTICES.md",
     "features/model-slider/vendor",
     "features/notes/src",
-    "features/notes/web",
     "features/notes/assets",
     "features/notes/codex-feature.json",
+    "features/notes/DESIGN.md",
+    "features/notes/README.md",
     "features/images/src",
     "features/images/web",
     "features/images/codex-feature.json",
@@ -41,17 +42,28 @@
     "apps/dashboard/favicon.svg",
     "apps/dashboard/index.html",
     "apps/dashboard/styles.css",
-    "README.md"
+    "README.md",
+    "features/usage-meter/src",
+    "features/usage-meter/codex-feature.json",
+    "features/usage-meter/DESIGN.md",
+    "features/usage-meter/README.md",
+    "features/unread-inbox/src",
+    "features/unread-inbox/codex-feature.json",
+    "features/unread-inbox/DESIGN.md",
+    "features/sidebar-focus/src",
+    "features/sidebar-focus/codex-feature.json",
+    "features/sidebar-focus/DESIGN.md",
+    "features/sidebar-focus/vendor/lucide-LICENSE"
   ],
   "engines": {
     "node": ">=22.5.0"
   },
   "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 features/hide-upsell-banner/test/*.test.mjs features/session-status/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 features/session-status/test/*.test.mjs features/usage-meter/test/*.test.mjs apps/dashboard/test/*.test.mjs features/unread-inbox/test/*.test.mjs features/sidebar-focus/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",
+    "check": "node scripts/check-syntax.mjs",
     "build:service": "scripts/build-service-app.zsh",
     "pack:check": "npm pack --dry-run",
     "pack:audit": "node scripts/audit-package.mjs",

package/packages/cli/src/config.mjs

@@ -2,7 +2,7 @@ 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", "hide-upsell-banner", "session-status"]);
+export const FEATURE_IDS = Object.freeze(["model-slider", "notes", "images", "hide-upsell-banner", "session-status", "usage-meter", "unread-inbox", "sidebar-focus"]);
 export const DEFAULT_CONFIG = Object.freeze({
   schemaVersion: 1,
   features: Object.freeze({
@@ -11,6 +11,9 @@ export const DEFAULT_CONFIG = Object.freeze({
     images: true,
     "hide-upsell-banner": true,
     "session-status": true,
+    "usage-meter": true,
+    "unread-inbox": true,
+    "sidebar-focus": true,
   }),
 });
 

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

@@ -196,8 +196,8 @@ async function iconResponse(id, paths, response) {
   if (id === "model-slider") {
     iconPath = path.join(paths.featuresRoot, id, "assets", "ui", "sparkles.svg");
   } else if (id === "notes") {
-    iconPath = path.join(paths.featuresRoot, id, "assets", "icons", "sticky-note.svg");
-  } else if (["images", "hide-upsell-banner", "session-status"].includes(id)) {
+    iconPath = path.join(paths.featuresRoot, id, "assets", "icons", "book-open.svg");
+  } else if (["images", "hide-upsell-banner", "session-status", "usage-meter"].includes(id)) {
     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>`;

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

@@ -390,12 +390,14 @@ export function createInjectionSource(features, {
           "config",
           `"use strict";\n${source}`,
         );
+        const pageConfig = feature.pageScript.config ??= {};
+        pageConfig.requestHostAction = (action, payload) => requestPageHostAction(feature.id, action, payload);
         const cleanup = installer(
           lifetime.signal,
           window,
           document,
           MutationObserver,
-          feature.pageScript.config ?? {},
+          pageConfig,
         );
         if (typeof cleanup === "function") pageScriptCleanups.push(cleanup);
       } catch (error) {
@@ -2779,9 +2781,10 @@ export function createInjectionSource(features, {
       }
       // 原生开合的临时 min-width 钉定与弹层水平居中都基于对 Measurement
       // 探针的测量；把探针文本同步为 MCX 显示标签，原生机制即可测得
-      // 真实显示宽度（含 110px 名称上限与 160px Content 上限）。
+      // 真实显示宽度。保留 React 持有的子节点，避免切模型时卸载失败。
       const measurement = trigger.querySelector('[class*="_ModelPickerTriggerMeasurement_"]');
-      if (measurement && measurement.textContent !== label) measurement.textContent = label;
+      const measurementText = measurement && firstVisibleTextNode(measurement);
+      if (measurementText && measurementText.nodeValue !== label) measurementText.nodeValue = label;
     }
 
     function ensureModelSelector() {
@@ -4525,10 +4528,36 @@ export function createInjectionSource(features, {
       }
     }
 
+    function requestPageHostAction(featureId, action, payload) {
+      if (!featureById.get(featureId)?.hostActions.has(action)) return Promise.reject(new Error("Host action is not registered"));
+      if (typeof globalThis[config.bindingName] !== "function") return Promise.reject(new Error("Host bridge is unavailable"));
+      return new Promise((resolve, reject) => {
+        const requestId = crypto.randomUUID();
+        const timer = setTimeout(() => {
+          pendingHostActions.delete(requestId);
+          reject(new Error("Host request timed out"));
+        }, 10_000);
+        pendingHostActions.set(requestId, { kind: "page-script", resolve, reject, timer });
+        try {
+          globalThis[config.bindingName](JSON.stringify({ token: config.bindingToken, featureId, requestId, action, payload }));
+        } catch (error) {
+          clearTimeout(timer);
+          pendingHostActions.delete(requestId);
+          reject(error);
+        }
+      });
+    }
+
     function resolveHostAction(requestId, response) {
       const pending = pendingHostActions.get(requestId);
       if (!pending) return false;
       pendingHostActions.delete(requestId);
+      if (pending.kind === "page-script") {
+        clearTimeout(pending.timer);
+        if (response.ok) pending.resolve(response.result);
+        else pending.reject(new Error(response.error?.message ?? "Host request failed"));
+        return true;
+      }
       const record = surfaceRecords.get(pending.recordKey);
       if (!record) return false;
       if (pending.kind === "surface-load") {
@@ -4711,6 +4740,12 @@ export function createInjectionSource(features, {
       resolveHostAction,
       dispose: () => {
         lifetime.abort();
+        for (const [id, pending] of pendingHostActions) {
+          if (pending.kind !== "page-script") continue;
+          clearTimeout(pending.timer);
+          pending.reject(new Error("Runtime disposed"));
+          pendingHostActions.delete(id);
+        }
         for (const cleanup of pageScriptCleanups.splice(0)) {
           try { cleanup(); } catch (error) {
             console.warn("[codex-personal] page-script cleanup failed", error);

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

@@ -47,15 +47,11 @@ export {
 } from "./codex-injection.mjs";
 
 export const SESSION_STATUS_THREAD_ID_EXPRESSION = `(() => {
-  const composer = document.querySelector('[data-codex-composer="true"][contenteditable="true"]')
-    ?? document.querySelector('[contenteditable="true"][role="textbox"]');
-  const card = composer?.closest('[data-codex-composer-root]');
-  const portal = card?.querySelector('[data-above-composer-portal]');
-  if (portal) return portal.getAttribute('data-above-composer-conversation-id');
-  if (card?.getAttribute('data-composer-placement') === 'home') return null;
-  const selected = document.querySelector('[data-app-action-sidebar-thread-selected="true"]');
-  return selected?.getAttribute('data-app-action-sidebar-thread-id')
-    ?? location.pathname + location.search + location.hash;
+  return [...new Set([...document.querySelectorAll('[data-codex-composer="true"][contenteditable="true"]')].map(composer => {
+    const card = composer.closest('[data-codex-composer-root]');
+    if (card?.getAttribute('data-composer-placement') !== 'thread') return null;
+    return card.querySelector('[data-above-composer-portal]')?.getAttribute('data-above-composer-conversation-id');
+  }).filter(Boolean))];
 })()`;
 
 export class CodexRuntime {
@@ -550,6 +546,29 @@ export class CodexRuntime {
       });
       return;
     }
+    if (feature.id === "notes" && request.action === "quick-prompts") {
+      try {
+        const { route, method = "GET", body } = request.payload ?? {};
+        const allowed = (route === "/api/state" && method === "GET")
+          || (["/api/prompts", "/api/categories", "/api/reorder"].includes(route) && method === "POST")
+          || (/^\/api\/categories\/[a-zA-Z0-9-]+$/.test(route) && ["PATCH", "DELETE"].includes(method))
+          || (/^\/api\/prompts\/[a-zA-Z0-9-]+$/.test(route) && ["PATCH", "DELETE"].includes(method))
+          || (/^\/api\/prompts\/[a-zA-Z0-9-]+\/use$/.test(route) && method === "POST");
+        const origin = pageScriptServiceOrigin(feature);
+        if (!allowed || !origin) throw new Error("Prompt request is not allowed");
+        const response = await this.fetchImpl(new URL(route, origin), {
+          method, headers: { "Content-Type": "application/json", Origin: CODEX_APP_ORIGIN },
+          body: body === undefined ? undefined : JSON.stringify(body),
+          signal: AbortSignal.timeout(8_000),
+        });
+        const result = response.status === 204 ? null : await response.json();
+        if (!response.ok) throw new Error(result?.error?.message ?? "Prompt request failed");
+        await this.resolveHostAction(client, request.requestId, { ok: true, result });
+      } catch (error) {
+        await this.resolveHostAction(client, request.requestId, { ok: false, error: { code: "PROMPT_REQUEST_FAILED", message: error.message } });
+      }
+      return;
+    }
     if (request.action === "import-generated-image") {
       await this.importGeneratedImage(feature, request.payload);
       return;
@@ -741,17 +760,19 @@ export class CodexRuntime {
             expression: SESSION_STATUS_THREAD_ID_EXPRESSION,
             returnByValue: true,
           }, { timeoutMs: 3_000 });
-          const threadId = threadIdFromLocation(response.result?.value);
-          const data = threadId ? await this.sessionStatusReader.read(threadId) : null;
-          const snapshot = data ?? (threadId ? {
-            threadId,
-            retryAfterMs: this.sessionStatusReader.retryAfterMs?.(threadId) ?? 500,
-          } : null);
-          if (this.stopping || this.clients.get(targetId) !== client) return;
-          await client.send("Runtime.evaluate", {
-            expression: `window.__minecodexSessionStatus?.update(${JSON.stringify(snapshot)}, ${revision})`,
-            returnByValue: true,
-          }, { timeoutMs: 3_000 });
+          for (const value of response.result?.value ?? []) {
+            const threadId = threadIdFromLocation(value);
+            const data = threadId ? await this.sessionStatusReader.read(threadId) : null;
+            const snapshot = data ?? (threadId ? {
+              threadId,
+              retryAfterMs: this.sessionStatusReader.retryAfterMs?.(threadId) ?? 500,
+            } : null);
+            if (this.stopping || this.clients.get(targetId) !== client) return;
+            await client.send("Runtime.evaluate", {
+              expression: `window.__minecodexSessionStatus?.update(${JSON.stringify(snapshot)}, ${revision})`,
+              returnByValue: true,
+            }, { timeoutMs: 3_000 });
+          }
         } catch (error) {
           this.logger.warn?.("Session Status update failed", error.message);
           if (this.clients.get(targetId) === client) {

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

@@ -6,6 +6,7 @@ import path from "node:path";
 
 const MANIFEST_NAME = "codex-feature.json";
 const HOST_ACTIONS = new Set([
+  "quick-prompts",
   "insert-text",
   "attach-file",
   "open-detail-tab",