@mearl/native-host 2.8.1 → 2.9.0

package/dist/install.d.ts

@@ -10,7 +10,7 @@
  * (CLI) or `mode` option (API) to install just one.
  *
  * CLI:
- *   mearl-native-host --init [--mode skills|mcp|both] [--extension-id <id>]
+ *   mearl-native-host init [--mode skills|mcp|both] [--extension-id <id>]
  *
  * API:
  *   import { installNativeHost } from '@mearl/native-host';
@@ -51,4 +51,12 @@ export interface UninstallDependencies {
 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>;
+export interface ParsedNativeHostInstallArgs {
+    showHelp: boolean;
+    uninstall: boolean;
+    mode: IntegrationMode | 'both';
+    extensionId?: string;
+    skipIfExists: boolean;
+}
+export declare function parseNativeHostInstallArgs(argv: string[]): Promise<ParsedNativeHostInstallArgs>;
+export declare function runCli(argv: string[]): Promise<number>;

package/dist/install.js

@@ -3,23 +3,26 @@ import fs2 from"node:fs";import path2 from"node:path";import{execFileSync as exe
 "${nodePath}" "${hostPath}" %*\r
 `;return fs2.writeFileSync(launcherPath2,content2,"utf-8"),launcherPath2}let launcherPath=path2.join(hostDir,`${hostName}-launcher.sh`),content=["#!/bin/sh",`NODE_BIN=${JSON.stringify(nodePath)}`,`HOST_SCRIPT=${JSON.stringify(hostPath)}`,'exec "$NODE_BIN" "$HOST_SCRIPT" "$@"',""].join(`
 `);return fs2.writeFileSync(launcherPath,content,"utf-8"),fs2.chmodSync(launcherPath,493),launcherPath}async function installNativeHost(options={}){let{mode="both",extensionId=DEFAULT_EXTENSION_ID,silent=!1,skipIfExists=!1}=options;if(mode==="both")return(await Promise.all(ALL_MODES.map(m=>installNativeHost({...options,mode:m})))).every(Boolean);let hostName=MEARL_NATIVE_HOST_NAMES[mode];if(!hostName)throw new Error(`Unknown mode: ${mode}. Expected 'skills' or 'mcp'.`);let log=(...args)=>{silent||console.error(...args)};try{let hostDir=resolveHostDir();if(skipIfExists){let manifestPath2=path2.join(hostDir,`${hostName}.json`);if(fs2.existsSync(manifestPath2))return log(`✅ Already installed: ${manifestPath2}`),!0}fs2.existsSync(hostDir)||(fs2.mkdirSync(hostDir,{recursive:!0}),log(`✅ Created directory: ${hostDir}`));let resolvedHostPath=resolveNativeHostPath();log(`✅ Native host path: ${resolvedHostPath}`);let launcherPath=createLauncherScript(hostDir,resolvedHostPath,hostName);log(`✅ Launcher script: ${launcherPath}`);let manifest={name:hostName,description:"Mearl Native Messaging Bridge",path:launcherPath,type:"stdio",allowed_origins:[`chrome-extension://${extensionId}/`]},manifestPath=path2.join(hostDir,`${hostName}.json`);return fs2.writeFileSync(manifestPath,JSON.stringify(manifest,null,2)),process.platform==="win32"?(registerWindowsNativeHost(hostName,manifestPath),log(`✅ Windows registry key created for: ${hostName}`)):fs2.chmodSync(manifestPath,420),log(`✅ Manifest installed: ${manifestPath}`),log(`✅ Extension ID: ${extensionId}`),log(`✅ Host name: ${hostName}`),!0}catch(error){return log(`❌ Installation failed: ${error instanceof Error?error.message:String(error)}`),error instanceof Error&&"code"in error&&error.code==="EACCES"&&log(`
-   Permission denied. Try running with sudo.`),!1}}async function uninstallNativeHost(options={},dependencies={}){return uninstallNativeHostArtifacts(options,dependencies)}function parseCliArgs(argv){let mode="both",extensionId,skipIfExists=!1,uninstall=!1;for(let i=0;i<argv.length;i+=1){let arg=argv[i];if(arg==="--help"||arg==="-h")return{showHelp:!0,uninstall,mode,skipIfExists};if(arg==="--mode"||arg.startsWith("--mode=")){let value=arg.includes("=")?arg.slice(7):argv[++i];value!=="skills"&&value!=="mcp"&&value!=="both"&&(console.error(`❌ Invalid mode: ${value}. Expected 'skills', 'mcp', or 'both'.`),process.exit(1)),mode=value;continue}if(arg==="--extension-id"||arg.startsWith("--extension-id=")){extensionId=arg.includes("=")?arg.slice(15):argv[++i];continue}if(arg==="--skip-if-exists"){skipIfExists=!0;continue}if(arg==="--uninstall"){uninstall=!0;continue}}return{showHelp:!1,uninstall,mode,extensionId,skipIfExists}}function printHelp(){console.error(`Usage:
-  mearl-native-host --init [options]
-  mearl-native-host --uninstall [options]
+   Permission denied. Try running with sudo.`),!1}}async function uninstallNativeHost(options={},dependencies={}){return uninstallNativeHostArtifacts(options,dependencies)}async function parseNativeHostInstallArgs(argv){let normalizedArgv=argv[0]==="--init"?["init",...argv.slice(1)]:argv[0]==="--uninstall"?["uninstall",...argv.slice(1)]:argv,operation="init",mode="both",extensionId,showHelp=!1,skipIfExists=!1,index=0;if(normalizedArgv[0]==="init"||normalizedArgv[0]==="uninstall")operation=normalizedArgv[0],index=1;else if(normalizedArgv[0]&&!normalizedArgv[0].startsWith("-"))throw new Error(`Unknown command: ${normalizedArgv[0]}`);let readValue=name=>{let argument=normalizedArgv[index];if(argument===name){let value=normalizedArgv[index+1];if(value===void 0||value.startsWith("-"))throw new Error(`argument missing for option '${name}'`);return index+=1,value}return argument?.startsWith(`${name}=`)?argument.slice(name.length+1):null};for(;index<normalizedArgv.length;index+=1){let argument=normalizedArgv[index];if(argument==="--help"||argument==="-h"){showHelp=!0;continue}if(argument==="--skip-if-exists"){skipIfExists=!0;continue}let parsedMode=readValue("--mode");if(parsedMode!==null){if(parsedMode!=="skills"&&parsedMode!=="mcp"&&parsedMode!=="both")throw new Error(`Invalid --mode: ${parsedMode}. Allowed choices are skills, mcp, and both`);mode=parsedMode;continue}let parsedExtensionId=readValue("--extension-id");if(parsedExtensionId!==null){extensionId=parsedExtensionId;continue}throw new Error(argument?.startsWith("-")?`unknown option '${argument}'`:`unexpected argument '${argument}'`)}if(operation==="uninstall"&&extensionId)throw new Error("--extension-id is only available for init");if(operation==="uninstall"&&skipIfExists)throw new Error("--skip-if-exists is only available for init");return{showHelp,uninstall:operation==="uninstall",mode,...extensionId?{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
+  --skip-if-exists         Keep existing Native Messaging manifests unchanged
   -h, --help               Show this help message
 
+Compatibility aliases:
+  --init, --uninstall      Established flag forms for init and uninstall
+
 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){let parsed=parseCliArgs(argv);if(parsed.showHelp&&(printHelp(),process.exit(0)),parsed.extensionId&&!/^[a-z]{32}$/.test(parsed.extensionId)&&(console.error(`❌ Invalid extension ID: ${parsed.extensionId}`),console.error("   Must be a 32-character lowercase string (see chrome://extensions/)"),process.exit(1)),parsed.uninstall){let success2=await uninstallNativeHost({mode:parsed.mode});success2&&console.error(`
+  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){let parsed;try{parsed=await parseNativeHostInstallArgs(argv)}catch(error){return console.error(`❌ ${error instanceof Error?error.message:String(error)}`),printHelp(),2}if(parsed.showHelp)return printHelp(),0;if(parsed.extensionId&&!/^[a-z]{32}$/.test(parsed.extensionId))return console.error(`❌ Invalid extension ID: ${parsed.extensionId}`),console.error("   Must be a 32-character lowercase string (see chrome://extensions/)"),2;if(parsed.uninstall){let success2=await uninstallNativeHost({mode:parsed.mode});return success2&&console.error(`
 ✅ Uninstall complete!
-`),process.exit(success2?0:1)}let success=await installNativeHost({mode:parsed.mode,extensionId:parsed.extensionId,skipIfExists:parsed.skipIfExists});success&&console.error(`
+`),success2?0:1}let success=await installNativeHost({mode:parsed.mode,extensionId:parsed.extensionId,skipIfExists:parsed.skipIfExists});return success&&console.error(`
 ✅ Installation complete!
 
 Next steps:
@@ -28,4 +31,4 @@ Next steps:
 
 Verify:
   mearl get_requests --payload '{"count":1}'
-`),process.exit(success?0:1)}export{installNativeHost,resolveHostDir,runCli,uninstallNativeHost};
+`),success?0:1}export{installNativeHost,parseNativeHostInstallArgs,resolveHostDir,runCli,uninstallNativeHost};

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@mearl/native-host",
-  "version": "2.8.1",
+  "version": "2.9.0",
   "description": "Native Messaging Host for Mearl — bridges Chrome Extension and local socket server",
   "type": "module",
   "engines": {
-    "node": ">=18"
+    "node": ">=22.12.0"
   },
   "main": "dist/install.js",
   "types": "dist/install.d.ts",
@@ -42,9 +42,9 @@
     "esbuild": "^0.25.2",
     "typescript": "^5.8.3",
     "wuying-agentbay-sdk": "0.22.0",
-    "@mearl/daemon-core": "2.8.1",
-    "@mearl/browser-core": "2.8.1",
-    "@mearl/setup": "2.8.1"
+    "@mearl/daemon-core": "2.9.0",
+    "@mearl/browser-core": "2.9.0",
+    "@mearl/setup": "2.9.0"
   },
   "scripts": {
     "build": "rm -rf dist/ && node build.mjs",