minecodex 2.0.2 → 2.0.3

package/packages/codex-adapter/README.md

@@ -0,0 +1,15 @@
+# Codex 公共环境适配
+
+该私有 workspace 隔离多个插件共同依赖的 Codex Renderer 机制。专有业务协议放在插件的 `src/adapters/codex/`；视觉适配放在 UI 的 `src/native/`。完整层次与文件导航见根 ARCHITECTURE.md 和 AGENTS.md。
+
+`createCodexEnvironment()` 是可显式序列化的工厂，无 Node 闭包和 IO imports。宿主按 Renderer 生命周期创建一个实例，通过 `config.codex` 提供给插件，卸载/重注入时重新创建。
+
+| 接口 | 结果与约束 |
+| --- | --- |
+| `composer(element?, {threadOnly}?)` | 默认仅可见的 thread 输入框；Prompts 显式传 false 支持首页输入框。返回 editable/root/body/add/threadId；非thread不提供身份，隐藏祖先返回 null |
+| `currentThreadId(element?)` | 从合格输入框取得 UUID；不从残留 sidebar 选中项猜当前线程 |
+| `rail()` / `railSlot(ownGroup)` | 可见原生 rail 与模板/滚动区/固定组句柄；不包含插件菜单策略 |
+| `currentFiber(element)` / `props(element,predicate,limit?)` | 仅供 native Adapter 使用；优先匹配当前 committed props，支持最近祖先的 scope |
+| `report(name,available,reason?)` / `diagnostics()` | 最新能力状态的副本；不持有凭据、原始账户数据或用户内容 |
+
+不要增加一个包含所有插件的 CodexGateway。新契约只有在被多个模块实际共用时进入这里。选择器、React 机制改动在本模块验证；插件专有协议改动在所属 Adapter 验证。正常界面不暴露内部诊断。

package/packages/codex-adapter/package.json

@@ -0,0 +1 @@
+{"name":"@minecodex/codex-adapter","private":true,"type":"module"}

package/packages/codex-adapter/src/renderer/environment.mjs

@@ -0,0 +1,53 @@
+// Codex 的公共原生契约只在此解释；返回锚点句柄与内部身份。
+export function createCodexEnvironment() {
+  const capabilities = new Map();
+  function report(name, available, reason = null) {
+    capabilities.set(name, { name, available, reason });
+  }
+  function currentFiber(element) {
+    while (element && !Object.getOwnPropertyNames(element).some(key=>key.startsWith("__reactFiber"))) element=element.parentElement;
+    const keys = Object.getOwnPropertyNames(element ?? {});
+    let fiber = element?.[keys.find(key => key.startsWith("__reactFiber"))];
+    const props = element?.[keys.find(key => key.startsWith("__reactProps"))];
+    if (props && fiber?.alternate?.memoizedProps === props && fiber.memoizedProps !== props) fiber = fiber.alternate;
+    return fiber;
+  }
+  function props(element, predicate, limit = 200) {
+    for (let fiber = currentFiber(element), depth = 0; fiber && depth < limit; fiber = fiber.return, depth++) {
+      if (predicate(fiber.memoizedProps ?? {})) return fiber.memoizedProps;
+    }
+    return null;
+  }
+  function composer(element = null, {threadOnly=true} = {}) {
+    const candidates = element ? [element] : document.querySelectorAll('[data-codex-composer="true"][contenteditable="true"]');
+    for (const editable of candidates) {
+      const root = editable.closest('[data-codex-composer-root]');
+      if (!editable.isConnected || !root || (threadOnly && root.getAttribute('data-composer-placement') !== 'thread')
+        || editable.closest('[hidden], [inert], [aria-hidden="true"], [data-floating-chat-surface], [data-right-panel-composer-overlay-content]')
+        || !editable.checkVisibility({ visibilityProperty:true })) continue;
+      const value = root.getAttribute('data-composer-placement') === 'thread' ? root.querySelector('[data-above-composer-portal]')?.getAttribute('data-above-composer-conversation-id') : null;
+      const threadId = value?.match(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/i)?.[0] ?? null;
+      report("composer", true);
+      return { editable, root, body:editable.closest('[data-composer-body]'), threadId,
+        add:root.querySelector('[data-composer-navigation-target="add-context"]') };
+    }
+    report("composer", false, "active-thread-composer-unavailable");
+    return null;
+  }
+  function rail() {
+    const node = [...document.querySelectorAll('[data-app-navigation-rail]')].find(node => node.getBoundingClientRect().width > 0) ?? null;
+    report("navigation-rail", Boolean(node), node ? null : "rail-unavailable");
+    return node;
+  }
+  function railSlot(ownGroup) {
+    const node = rail();
+    const template = node?.querySelector('[data-sidebar-destination="builtin:projects"]')
+      ?? node?.querySelector('[data-sidebar-destination="builtin:library"]');
+    const scroll = node?.querySelector('.overflow-y-auto');
+    const group = [...(scroll?.children ?? [])].find(child => child !== ownGroup && child.classList.contains('flex-col') && child.classList.contains('shrink-0'));
+    return node && template && scroll ? { rail:node, template, scroll, group } : null;
+  }
+  return { composer, rail, railSlot, currentThreadId:element => composer(element)?.threadId ?? null,
+    // 仅供 UI／插件 native Adapter 使用，交互层不读取 React props。
+    currentFiber, props, report, diagnostics:() => [...capabilities.values()].map(item => ({...item})) };
+}

package/packages/runtime-host/README.md

@@ -175,3 +175,30 @@ Host 会再次发送当前状态。功能页面可据此暂停隐藏状态下的
 
 这是非官方 CDP / DOM Adapter，不是公开的 Codex Contribution API。Codex 更新后应只
 在这个宿主中修复；各功能的数据和 Web UI不需要跟随重写。
+
+
+## 共享弹窗与浮层
+
+通用视觉、原生材质分支、遮罩及层级的权威来源为根 [DESIGN.md](../../DESIGN.md)，内部文件导航见 [AGENTS.md](../../AGENTS.md)。组件库目标与现有实现归属见 [UI 架构](../ui/ARCHITECTURE.md)。本节只说明当前接入契约。
+
+`packages/ui/src/install.mjs` 组装共享组件源码，在 Renderer 中只安装一次，由 page-script 的 `config.ui` 调用：
+
+```js
+config.ui.heading(dialog, { title, closeLabel, onClose, back });
+const actions = config.ui.footer(document.createElement("div"));
+actions.append(config.ui.action(saveButton, "primary"));
+config.ui.overlay(backdrop);
+config.ui.surface(popover); // 只统一材质，保留功能的定位与内容
+```
+
+`heading` 标记 dialog 并创建标题及 Close；`back` 是可选的已有按钮节点。容器宽高、内容、原生 dialog 或自定义焦点管理、关闭后的焦点恢复继续由功能负责。`footer` 只装饰直接子按钮，`action` 的 tone 为 ghost / secondary / primary / danger。不要再在插件中复制背景、阴影、标题和底部按钮规则。
+
+共享组件已迁入 UI workspace。Prompts 与 Sites 管理弹窗选用 opaque / Sites Share；Quick Prompts 使用 ComposerMenu；管理菜单和模型列表选择 Dropdown，Session Status 与任务切换选择 Popover。组件库负责各分支视觉，宿主不复制实现。
+
+page-script 可以用 manifest 的 `entry.resources` 声明本功能内的 CSS/图标资源，宿主读取后通过 `config.resources` 一次传入。JSON 作为数据、其他文件作为文本；越出功能目录的路径会被拒绝。它不改变 host action、服务启动或消息协议。
+
+Images 提示词面板沿用原生 Version history 的特殊结构；iframe 页面继续通过宿主接收主题。会话统计与云 Library 业务归所属插件，Runtime Host 只组合业务能力和外部连接。领域规则与架构层参见根 [ARCHITECTURE.md](../../ARCHITECTURE.md)。
+
+`entry.sourceFactory` 可声明本插件内的源码工厂，导出 `createPageScriptSource()` 并返回 Renderer 函数体字符串。工厂路径不能越出插件；纯领域函数由插件工厂序列化，宿主不维护规则副本。Images 使用这一接口共享图片提示词溯源规则。
+
+Model Slider 的模型规则、原生控制器适配和专有呈现位于插件 `src/domain` / `src/frontend`，安装源码由插件工厂组装。宿主仅提供配置、locale、共享 UI、图标与刷新调度，维护 ensure/dispose 接线；原生菜单开合和节点恢复由插件负责。