minecodex 1.0.9 → 1.0.10

package/features/notes/README.md

@@ -3,7 +3,7 @@
 CodexNotes 是一个完全本地的 Codex 个人调用层：在当前对话右上角通过一个
 Notes Toolbar Button 快速查看 Todo、Prompts 和 Files；单个分区超过 5 条时才会
 显示 `View all`，并通过 RuntimeHost 在 Codex 原生右侧工作区打开互不重复、跟随
-当前 Task 的完整 Tab；内部 capability 不可用时才回退到兼容 Tab host。
+当前 Task 的完整 Tab；内部 capability 不可用时显示明确错误。
 
 目标交互与 Codex 原生 Summary 一致：窄空间使用 `Toggle notes` Popover，
 宽空间使用 `Toggle pinned notes`，并在 `shift` / `gutter` 模式中参与对话

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecodex",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",

package/packages/runtime-host/README.md

@@ -132,8 +132,8 @@ Host 会再次发送当前状态。功能页面可据此暂停隐藏状态下的
 - `attach-file`：用 CDP 填充临时 file input，再把真实 `File` drop 给 Composer；只有
   观察到原生附件 chip/preview 才报告 `attach`，否则明确返回 `insert-path`。
 - `open-detail-tab`：动态发现当前 Codex React right-panel controller 与当前 Task scope，
-  用稳定的 `featureId-detailId` 聚焦或创建唯一原生 Tab；capability 不可用时才回退到
-  RuntimeHost 自建的兼容 Tab host。
+  传入包含 `Component`、`isAvailable`、`kind` 和 `dropDestinations` 的标签描述对象，
+  用稳定的 `featureId-detailId` 聚焦或创建唯一原生 Tab；capability 不可用时返回明确错误。
 - `resolve-file-paths`：通过 Codex preload 暴露的 Electron file bridge 解析 Finder
   drop 的真实 `File` 对象。
 
@@ -145,6 +145,8 @@ Host 会再次发送当前状态。功能页面可据此暂停隐藏状态下的
   本地 Surface 不直接导航到 loopback URL：Host 先创建 `about:blank` iframe，再校验
   manifest URL、health service/protocol/instance，抓取 HTML 并用 `Page.setDocumentContent`
   写入目标 frame。Images/Notes 只向精确的 `app://-` Origin 开放 CORS。
+- CDP 重连时同步轮换后的 binding token；保留已就绪的 Surface 和编辑草稿，
+  使用新 token 重试未就绪页面，避免弹窗停留在空白 iframe。
 - 入口由 Renderer 内的 MutationObserver 幂等挂载，React 重绘不会产生重复入口。
 - Summary 根据对话主区域宽度连续派生 `overlay / shift / gutter`：小于 1096px
   使用临时 Popover；1096–1535px 预留 316px 并把对话内容左移 158px；更宽时
@@ -166,7 +168,7 @@ Host 会再次发送当前状态。功能页面可据此暂停隐藏状态下的
 | --- | --- | --- |
 | loopback HTTP、manifest、Surface message schema | 项目自有稳定接口 | 可由测试直接覆盖 |
 | `window.electronBridge.getPathForFile` | 当前稳定 internal/preload | 仅用于 Finder `File` 路径解析 |
-| React right-panel `openTab`、Task scope、JSX runtime | private internal capability | 动态发现 bundle 并做能力检测；失败时回退自建 Tab host |
+| React right-panel `openTab`、Task scope、JSX runtime | private internal capability | 动态发现 bundle 并做能力检测；失败时返回明确的不可用错误 |
 | toolbar、summary、tabs、Composer selectors | DOM inference | 统一留在本 Adapter |
 | `Runtime.addBinding`、`DOM.setFileInputFiles`、注入脚本 | high-risk CDP | 必须使用隔离 profile 验收 |
 | `togglePinnedSummary`、`composer.addFiles` 字符串 | 探索证据 | 当前实现不把它们当契约 |

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

@@ -5,7 +5,7 @@
 import { randomBytes } from "node:crypto";
 import { CODEX_THEME_TOKENS } from "./codex-design-contract.mjs";
 
-export const RUNTIME_VERSION = 100;
+export const RUNTIME_VERSION = 101;
 export const HOST_BINDING_NAME = "__codexPersonalHostAction";
 export const CSP_BOOTSTRAP_VERSION = 1;
 export const CSP_BOOTSTRAP_KEY = "__mineCodexCspBootstrapVersion";
@@ -131,6 +131,7 @@ export function createInjectionSource(features, {
     }
     const currentRuntime = window.__codexPersonalRuntime;
     if (currentRuntime?.version === config.version && currentRuntime?.sessionId === config.sessionId) {
+      currentRuntime.updateHostBinding(config.bindingName, config.bindingToken);
       currentRuntime.ensure();
       return;
     }
@@ -2701,6 +2702,21 @@ export function createInjectionSource(features, {
       return true;
     }
 
+    function updateHostBinding(bindingName, bindingToken) {
+      if (config.bindingName === bindingName && config.bindingToken === bindingToken) return;
+      // CDP 重连会轮换 token；保留已有页面和草稿，只重试未就绪的页面。
+      config.bindingName = bindingName;
+      config.bindingToken = bindingToken;
+      for (const [requestId, pending] of pendingHostActions) {
+        if (pending.kind === "surface-load") pendingHostActions.delete(requestId);
+      }
+      for (const record of surfaceRecords.values()) {
+        if (record.ready) continue;
+        record.loading = false;
+        requestSurfaceLoad(record);
+      }
+    }
+
     function postSurfaceActive(record, active) {
       if (!record || record.kind !== "page") return;
       record.frame.contentWindow?.postMessage({
@@ -3832,7 +3848,13 @@ export function createInjectionSource(features, {
       }
 
       try {
-        controller.openTab(scope, nativeDetailComponent(feature, detail), {
+        // 原生 openTab 接收标签描述对象，并在挂载前检查可用性。
+        controller.openTab(scope, {
+          Component: nativeDetailComponent(feature, detail),
+          kind: tabId,
+          dropDestinations: ["right"],
+          isAvailable: () => true,
+        }, {
           id: tabId,
           kind: tabId,
           title: detail.label,
@@ -4421,6 +4443,7 @@ export function createInjectionSource(features, {
     const runtimeApi = {
       version: config.version,
       sessionId: config.sessionId,
+      updateHostBinding,
       ensure: queueEnsure,
       show: showPageSurface,
       hide: () => {
@@ -4542,4 +4565,3 @@ export function createRuntimeReadyContract({
 export function createDocumentBootstrapSource(source) {
   return `window[${JSON.stringify(CSP_BOOTSTRAP_KEY)}] = ${CSP_BOOTSTRAP_VERSION};\n${source}`;
 }
-