@mearl/native-host 2.2.1 → 2.3.0

package/dist/install.d.ts

@@ -16,6 +16,7 @@
  *   import { installNativeHost } from '@mearl/native-host';
  *   await installNativeHost(); // installs both
  */
+import fs from 'node:fs';
 export type IntegrationMode = 'skills' | 'mcp';
 export interface InstallOptions {
     /**
@@ -31,6 +32,23 @@ export interface InstallOptions {
     /** Skip installation if the manifest file already exists. Defaults to `false`. */
     skipIfExists?: boolean;
 }
+export interface UninstallOptions {
+    /** Integration manifest to remove. Defaults to both Skills and MCP. */
+    mode?: IntegrationMode | 'both';
+    /** Suppress console output when `true`. */
+    silent?: boolean;
+}
+export interface UninstallDependencies {
+    env?: NodeJS.ProcessEnv;
+    existsSync?: typeof fs.existsSync;
+    homedir?: () => string;
+    hostDir?: string;
+    platform?: NodeJS.Platform;
+    unlinkSync?: typeof fs.unlinkSync;
+    unregisterWindowsNativeHost?: (hostName: string) => void;
+    writeLine?: (line: string) => void;
+}
 export declare function resolveHostDir(): string;
 export declare function installNativeHost(options?: InstallOptions): Promise<boolean>;
+export declare function uninstallNativeHost(options?: UninstallOptions, dependencies?: UninstallDependencies): Promise<boolean>;
 export declare function runCli(argv: string[]): Promise<void>;

package/dist/install.js

@@ -1,39 +1,92 @@
 // src/install.ts
+import fs2 from "node:fs";
+import path2 from "node:path";
+import { execFileSync as execFileSync2 } from "node:child_process";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+
+// ../setup/dist/nativeHost.js
 import fs from "node:fs";
-import path from "node:path";
 import os from "node:os";
+import path from "node:path";
 import { execFileSync } from "node:child_process";
-import { createRequire } from "node:module";
-import { fileURLToPath } from "node:url";
-var DEFAULT_EXTENSION_ID = "aoehhjnofngknnjefamjbplchbolghkm";
-var HOST_NAME_BY_MODE = {
+var MEARL_NATIVE_HOST_NAMES = {
   skills: "com.alibaba.mearl.skills",
   mcp: "com.alibaba.mearl.mcp"
 };
-var __filename = fileURLToPath(import.meta.url);
-var __dirname = path.dirname(__filename);
-var ALL_MODES = ["skills", "mcp"];
-function resolveHostDir() {
-  switch (process.platform) {
+function resolveNativeHostDirectory(options = {}) {
+  const env = options.env ?? process.env;
+  const home = (options.homedir ?? os.homedir)();
+  switch (options.platform ?? process.platform) {
     case "darwin":
-      return path.join(
-        os.homedir(),
-        "Library/Application Support/Google/Chrome/NativeMessagingHosts"
-      );
+      return path.join(home, "Library/Application Support/Google/Chrome/NativeMessagingHosts");
     case "linux":
-      return path.join(os.homedir(), ".config/google-chrome/NativeMessagingHosts");
+      return path.join(home, ".config/google-chrome/NativeMessagingHosts");
     case "win32":
-      return path.join(
-        process.env.PROGRAMDATA || "C:\\ProgramData",
-        "Google\\Chrome\\NativeMessagingHosts"
-      );
+      return path.join(env.PROGRAMDATA || "C:\\ProgramData", "Google\\Chrome\\NativeMessagingHosts");
     default:
-      throw new Error(`Unsupported platform: ${process.platform}`);
+      throw new Error(`Unsupported platform: ${String(options.platform ?? process.platform)}`);
+  }
+}
+function unregisterWindowsNativeHost(hostName) {
+  const registryKey = `HKCU\\SOFTWARE\\Google\\Chrome\\NativeMessagingHosts\\${hostName}`;
+  try {
+    execFileSync("reg", ["delete", registryKey, "/f"], { stdio: "pipe" });
+  } catch {
+  }
+}
+function uninstallNativeHostArtifacts(options = {}, dependencies = {}) {
+  const { mode = "both", silent = false } = options;
+  if (mode === "both") {
+    return ["skills", "mcp"].map((integrationMode) => uninstallNativeHostArtifacts({ ...options, mode: integrationMode }, dependencies)).every(Boolean);
   }
+  const writeLine = dependencies.writeLine ?? ((line) => console.error(line));
+  const log = (line) => {
+    if (!silent)
+      writeLine(line);
+  };
+  try {
+    const existsSync = dependencies.existsSync ?? fs.existsSync;
+    const platform = dependencies.platform ?? process.platform;
+    const hostDir = dependencies.hostDir ?? resolveNativeHostDirectory({
+      env: dependencies.env,
+      homedir: dependencies.homedir,
+      platform
+    });
+    const unlinkSync = dependencies.unlinkSync ?? fs.unlinkSync;
+    const unregister = dependencies.unregisterWindowsNativeHost ?? unregisterWindowsNativeHost;
+    const hostName = MEARL_NATIVE_HOST_NAMES[mode];
+    const launcherExtension = platform === "win32" ? "cmd" : "sh";
+    const artifacts = [
+      path.join(hostDir, `${hostName}.json`),
+      path.join(hostDir, `${hostName}-launcher.${launcherExtension}`)
+    ];
+    for (const artifact of artifacts) {
+      if (!existsSync(artifact))
+        continue;
+      unlinkSync(artifact);
+      log(`✅ Removed: ${artifact}`);
+    }
+    if (platform === "win32")
+      unregister(hostName);
+    return true;
+  } catch (error) {
+    log(`❌ Uninstall failed: ${error instanceof Error ? error.message : String(error)}`);
+    return false;
+  }
+}
+
+// src/install.ts
+var DEFAULT_EXTENSION_ID = "aoehhjnofngknnjefamjbplchbolghkm";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = path2.dirname(__filename);
+var ALL_MODES = ["skills", "mcp"];
+function resolveHostDir() {
+  return resolveNativeHostDirectory();
 }
 function resolveNativeHostPath() {
-  const siblingPath = path.join(__dirname, "index.js");
-  if (fs.existsSync(siblingPath)) {
+  const siblingPath = path2.join(__dirname, "index.js");
+  if (fs2.existsSync(siblingPath)) {
     return siblingPath;
   }
   try {
@@ -47,21 +100,21 @@ function resolveNativeHostPath() {
 }
 function registerWindowsNativeHost(hostName, manifestPath) {
   const regKey = `HKCU\\SOFTWARE\\Google\\Chrome\\NativeMessagingHosts\\${hostName}`;
-  execFileSync("reg", ["add", regKey, "/ve", "/t", "REG_SZ", "/d", manifestPath, "/f"], {
+  execFileSync2("reg", ["add", regKey, "/ve", "/t", "REG_SZ", "/d", manifestPath, "/f"], {
     stdio: "pipe"
   });
 }
 function createLauncherScript(hostDir, hostPath, hostName) {
-  const nodePath = path.resolve(process.execPath);
+  const nodePath = path2.resolve(process.execPath);
   if (process.platform === "win32") {
-    const launcherPath2 = path.join(hostDir, `${hostName}-launcher.cmd`);
+    const launcherPath2 = path2.join(hostDir, `${hostName}-launcher.cmd`);
     const content2 = `@echo off\r
 "${nodePath}" "${hostPath}" %*\r
 `;
-    fs.writeFileSync(launcherPath2, content2, "utf-8");
+    fs2.writeFileSync(launcherPath2, content2, "utf-8");
     return launcherPath2;
   }
-  const launcherPath = path.join(hostDir, `${hostName}-launcher.sh`);
+  const launcherPath = path2.join(hostDir, `${hostName}-launcher.sh`);
   const content = [
     "#!/bin/sh",
     `NODE_BIN=${JSON.stringify(nodePath)}`,
@@ -69,8 +122,8 @@ function createLauncherScript(hostDir, hostPath, hostName) {
     'exec "$NODE_BIN" "$HOST_SCRIPT" "$@"',
     ""
   ].join("\n");
-  fs.writeFileSync(launcherPath, content, "utf-8");
-  fs.chmodSync(launcherPath, 493);
+  fs2.writeFileSync(launcherPath, content, "utf-8");
+  fs2.chmodSync(launcherPath, 493);
   return launcherPath;
 }
 async function installNativeHost(options = {}) {
@@ -86,7 +139,7 @@ async function installNativeHost(options = {}) {
     );
     return results.every(Boolean);
   }
-  const hostName = HOST_NAME_BY_MODE[mode];
+  const hostName = MEARL_NATIVE_HOST_NAMES[mode];
   if (!hostName) {
     throw new Error(`Unknown mode: ${mode}. Expected 'skills' or 'mcp'.`);
   }
@@ -96,14 +149,14 @@ async function installNativeHost(options = {}) {
   try {
     const hostDir = resolveHostDir();
     if (skipIfExists) {
-      const manifestPath2 = path.join(hostDir, `${hostName}.json`);
-      if (fs.existsSync(manifestPath2)) {
+      const manifestPath2 = path2.join(hostDir, `${hostName}.json`);
+      if (fs2.existsSync(manifestPath2)) {
         log(`✅ Already installed: ${manifestPath2}`);
         return true;
       }
     }
-    if (!fs.existsSync(hostDir)) {
-      fs.mkdirSync(hostDir, { recursive: true });
+    if (!fs2.existsSync(hostDir)) {
+      fs2.mkdirSync(hostDir, { recursive: true });
       log(`✅ Created directory: ${hostDir}`);
     }
     const resolvedHostPath = resolveNativeHostPath();
@@ -117,13 +170,13 @@ async function installNativeHost(options = {}) {
       type: "stdio",
       allowed_origins: [`chrome-extension://${extensionId}/`]
     };
-    const manifestPath = path.join(hostDir, `${hostName}.json`);
-    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+    const manifestPath = path2.join(hostDir, `${hostName}.json`);
+    fs2.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
     if (process.platform === "win32") {
       registerWindowsNativeHost(hostName, manifestPath);
       log(`✅ Windows registry key created for: ${hostName}`);
     } else {
-      fs.chmodSync(manifestPath, 420);
+      fs2.chmodSync(manifestPath, 420);
     }
     log(`✅ Manifest installed: ${manifestPath}`);
     log(`✅ Extension ID: ${extensionId}`);
@@ -137,14 +190,18 @@ async function installNativeHost(options = {}) {
     return false;
   }
 }
+async function uninstallNativeHost(options = {}, dependencies = {}) {
+  return uninstallNativeHostArtifacts(options, dependencies);
+}
 function parseCliArgs(argv) {
   let mode = "both";
   let extensionId;
   let skipIfExists = false;
+  let uninstall = false;
   for (let i = 0; i < argv.length; i += 1) {
     const arg = argv[i];
     if (arg === "--help" || arg === "-h") {
-      return { showHelp: true, mode, skipIfExists };
+      return { showHelp: true, uninstall, mode, skipIfExists };
     }
     if (arg === "--mode" || arg.startsWith("--mode=")) {
       const value = arg.includes("=") ? arg.slice("--mode=".length) : argv[++i];
@@ -163,24 +220,31 @@ function parseCliArgs(argv) {
       skipIfExists = true;
       continue;
     }
+    if (arg === "--uninstall") {
+      uninstall = true;
+      continue;
+    }
     if (arg === "--init") {
       continue;
     }
   }
-  return { showHelp: false, mode, extensionId, skipIfExists };
+  return { showHelp: false, uninstall, mode, extensionId, skipIfExists };
 }
 function printHelp() {
   console.error(`Usage:
   mearl-native-host --init [options]
+  mearl-native-host --uninstall [options]
 
 Options:
   --mode <skills|mcp|both> Integration mode (default: both — installs both hosts)
   --extension-id <id>      Chrome extension ID (default: ${DEFAULT_EXTENSION_ID})
+  --uninstall              Remove the selected Native Messaging manifests
   -h, --help               Show this help message
 
 Examples:
   mearl-native-host --init
   mearl-native-host --init --mode mcp
+  mearl-native-host --uninstall --mode skills
   mearl-native-host --init --extension-id abcdefghijklmnopqrstuvwxyzabcdef`);
 }
 async function runCli(argv) {
@@ -194,6 +258,11 @@ async function runCli(argv) {
     console.error("   Must be a 32-character lowercase string (see chrome://extensions/)");
     process.exit(1);
   }
+  if (parsed.uninstall) {
+    const success2 = await uninstallNativeHost({ mode: parsed.mode });
+    if (success2) console.error("\n✅ Uninstall complete!\n");
+    process.exit(success2 ? 0 : 1);
+  }
   const success = await installNativeHost({
     mode: parsed.mode,
     extensionId: parsed.extensionId,
@@ -216,5 +285,6 @@ Verify:
 export {
   installNativeHost,
   resolveHostDir,
-  runCli
+  runCli,
+  uninstallNativeHost
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/native-host",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "description": "Native Messaging Host for Mearl — bridges Chrome Extension and local socket server",
   "type": "module",
   "main": "dist/install.js",
@@ -32,8 +32,9 @@
     "@types/node": "^24.9.1",
     "esbuild": "^0.25.2",
     "typescript": "^5.8.3",
-    "@mearl/browser-core": "2.2.1",
-    "@mearl/daemon-core": "2.2.1"
+    "@mearl/daemon-core": "2.3.0",
+    "@mearl/browser-core": "2.3.0",
+    "@mearl/setup": "2.3.0"
   },
   "scripts": {
     "build": "rm -rf dist/ && node build.mjs",