minecodex 2.0.15 → 2.0.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecodex",
-  "version": "2.0.15",
+  "version": "2.0.16",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",
@@ -57,6 +57,7 @@
     "assets/brand/minecodex-icon.svg",
     "assets/brand/minecodex-icon-light.svg",
     "assets/brand/minecodex-icon-dark.svg",
+    "assets/brand/minecodex-icon-selected.svg",
     "assets/brand/references/lucide-LICENSE.txt",
     "assets/readme/hero.svg",
     "packages/ui/assets",
@@ -67,14 +68,18 @@
     "features/file-navigation/src",
     "features/file-navigation/codex-feature.json",
     "features/file-navigation/assets",
-    "features/file-navigation/vendor/lucide-LICENSE"
+    "features/file-navigation/vendor/lucide-LICENSE",
+    "apps/dashboard/transport.js",
+    "packages/plugin/src",
+    "packages/plugin/assets",
+    "packages/plugin/plugin.json"
   ],
   "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 features/usage-meter/test/*.test.mjs apps/dashboard/test/*.test.mjs features/unread-inbox/test/*.test.mjs features/sidebar-focus/test/*.test.mjs features/sites/test/*.test.mjs packages/ui/test/*.test.mjs packages/codex-adapter/test/*.test.mjs features/markdown-reading/test/*.test.mjs features/file-navigation/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 features/sites/test/*.test.mjs packages/ui/test/*.test.mjs packages/codex-adapter/test/*.test.mjs features/markdown-reading/test/*.test.mjs features/file-navigation/test/*.test.mjs packages/plugin/test/*.test.mjs",
     "test:cli": "node --test packages/cli/test/*.test.mjs",
     "test:runtime": "node --test packages/runtime-host/test/*.test.mjs",
     "check": "node scripts/check-syntax.mjs",
@@ -83,7 +88,9 @@
     "pack:audit": "node scripts/audit-package.mjs",
     "prepublishOnly": "npm test && npm run check && npm run pack:audit",
     "test:ui": "node --test packages/ui/test/*.test.mjs",
-    "build:icons": "node scripts/build-brand-icons.mjs"
+    "build:icons": "node scripts/build-brand-icons.mjs",
+    "build:plugin": "node scripts/build-plugin.mjs",
+    "test:plugin": "node --test packages/plugin/test/*.test.mjs"
   },
   "repository": {
     "type": "git",
@@ -105,6 +112,12 @@
     "win32"
   ],
   "dependencies": {
-    "acorn": "^8.18.0"
+    "@modelcontextprotocol/ext-apps": "^2.0.3",
+    "@modelcontextprotocol/sdk": "^1.32.0",
+    "acorn": "^8.18.0",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "esbuild": "^0.28.2"
   }
 }

package/packages/cli/src/commands.mjs

@@ -85,6 +85,7 @@ Commands:
   mcx uninstall [--purge]  Remove integration; preserve data unless --purge is used
   mcx update               Update to the latest stable npm release
   mcx open                 Open the MineCodex plugin control panel
+  mcx plugin install       Register the official Codex plugin entry
   mcx status [--json]      Show installation and plugin status
   mcx restart              Restart Codex and apply saved plugin switches
   mcx --version             Print the installed version
@@ -447,6 +448,15 @@ export async function runCli(argv, {
   const [command = "--help", ...args] = argv;
   if (["--help", "-h", "help"].includes(command)) return printHelp(output);
   if (["--version", "-v"].includes(command)) return output(packageMetadata.version);
+  if (command === "plugin" && args[0] === "serve") {
+    const { servePlugin } = await import("../../plugin/src/server.mjs");
+    return servePlugin({ paths });
+  }
+  if (command === "plugin" && args[0] === "install") {
+    const { installPlugin } = await import("../../plugin/src/install.mjs");
+    await installPlugin({ paths });
+    return output("MineCodex plugin installed. Open Explore in Codex to find MineCodex.");
+  }
   if (command === "install") return installCommand({ paths, platform, cliPath, output, serviceProbe, fetchImpl, confirmRestart, nodeVersion });
   if (command === "open" || command === "gui") return openCommand({ paths, platform, output, serviceProbe, fetchImpl });
   if (command === "status") return statusCommand({ paths, platform, jsonOutput: args.includes("--json"), output, fetchImpl });

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

@@ -65,12 +65,41 @@ export function createCodexEnvironment() {
     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;
   }
+  // 导航与 MCP iframe 身份在 Adapter 内解释，功能不接触 React props。
+  function navigation() {
+    const scope = props(rail(), value => Boolean((value.router ?? value.value?.router)?.navigate));
+    const router = scope?.router ?? scope?.value?.router;
+    if (!router?.subscribe) return null;
+    const read = () => {
+      const location = router.state.location;
+      return {path:location.pathname + (location.search ?? "") + (location.hash ?? ""), key:location.key};
+    };
+    return {location:read, navigate:path => router.navigate(path, {replace:true}),
+      subscribe:callback => router.subscribe(state => {
+        if (!state.navigation?.state || state.navigation.state === "idle") callback(read());
+      })};
+  }
+  function mcpAppSource(sourceWindow, {server, pluginId, resourceUri}) {
+    for (const frame of document.querySelectorAll('[data-mcp-extension-surface] iframe')) {
+      let source = sourceWindow, matches = false;
+      // 官方 sandbox proxy 包含资源 iframe；WindowProxy.parent 可跨源读取。
+      for (let depth = 0; source && depth < 4; depth++) {
+        if (source === frame.contentWindow) {matches = true;break;}
+        try {if (source.parent === source) break; source = source.parent;} catch {break;}
+      }
+      if (!matches) continue;
+      const view = props(frame, value => value.view?.resourceUri != null)?.view;
+      if (view?.resourceUri === resourceUri && (view.server === server || view.pluginId === pluginId))
+        return {connected:() => frame.isConnected};
+    }
+    return null;
+  }
   function route() {
     const node = rail();
     const scope = node && props(node, value => Boolean((value.router ?? value.value?.router)?.state?.location));
     return (scope?.router ?? scope?.value?.router)?.state?.location?.pathname ?? null;
   }
-  return { composer, composerSurface, rail, railSlot, route, currentThreadId:element => composer(element)?.threadId ?? null,
+  return { composer, composerSurface, rail, railSlot, route, navigation, mcpAppSource, currentThreadId:element => composer(element)?.threadId ?? null,
     // 仅供 UI／插件 native Adapter 使用，交互层不读取 React props。
     currentFiber, props, report, diagnostics:() => [...capabilities.values()].map(item => ({...item})) };
 }