@mearl/client 2.9.4 → 2.9.6

package/dist/commands.d.ts

@@ -340,7 +340,7 @@ export declare const COMMANDS: readonly [{
     readonly params: [{
         readonly name: "tabId";
         readonly type: "number";
-        readonly description: "login 后续查询或选身份时复用首次返回的标签页 ID；其他操作在 CDP 模式下用于读取 Cookie";
+        readonly description: "login 首次不传；后续传上次响应的 tabId；无法恢复待扫码状态时会返回新的 tabId；其他操作在 CDP 模式下用于读取 Cookie";
     }, {
         readonly name: "operation";
         readonly type: "\"current\" | \"list\" | \"login\" | \"switch\" | \"borrow\"";

package/dist/commands.js

@@ -241,7 +241,7 @@ export const COMMANDS = [
             {
                 name: 'tabId',
                 type: 'number',
-                description: 'login 后续查询或选身份时复用首次返回的标签页 ID；其他操作在 CDP 模式下用于读取 Cookie',
+                description: 'login 首次不传；后续传上次响应的 tabId；无法恢复待扫码状态时会返回新的 tabId；其他操作在 CDP 模式下用于读取 Cookie',
             },
             {
                 name: 'operation',

package/dist/socket.js

@@ -89,18 +89,20 @@ function selectBrowserResult(data) {
 let spawnAttempted = false;
 /**
  * Attempt to spawn `mearl-native-host` in the background (detached).
- * Inventory-only hosts serve one browser_list request without publishing a fake CDP target.
+ * Browser discovery hosts probe the default local CDP endpoint for browser_list and only
+ * persist when a real browser is available.
  * Returns true if a spawn was attempted (regardless of success).
  */
-async function trySpawnNativeHost(registerBrowser = true, retryPreviousAttempt = false) {
-    if (registerBrowser && spawnAttempted && !retryPreviousAttempt)
+async function trySpawnNativeHost(mode = 'control', retryPreviousAttempt = false) {
+    const persistent = mode === 'control';
+    if (persistent && spawnAttempted && !retryPreviousAttempt)
         return false;
-    if (registerBrowser)
+    if (persistent)
         spawnAttempted = true;
     try {
         const { spawn } = await import('node:child_process');
         return await new Promise(resolve => {
-            const args = registerBrowser ? ['--daemon'] : ['--daemon', '--skip-browser-registration'];
+            const args = persistent ? ['--daemon'] : ['--daemon', '--discover-cdp'];
             const child = spawn('mearl-native-host', args, {
                 detached: true,
                 stdio: 'ignore',
@@ -216,10 +218,15 @@ async function invokeViaLegacy(action, data, timeoutSec, transport, controlSourc
         const err = error;
         const shouldAttemptSpawn = err.code === 'ENOENT' || (action === 'browser_release' && err.code === 'ECONNREFUSED');
         if (shouldAttemptSpawn && !isRetry) {
-            const spawned = await trySpawnNativeHost(action !== 'browser_list', action === 'browser_release');
+            const spawned = await trySpawnNativeHost(action === 'browser_list' ? 'discovery' : 'control', action === 'browser_release');
             if (spawned) {
-                // Wait for the native host to start listening; persistent hosts also publish their registry record.
+                // Wait for the native host to start listening. Discovery retries the legacy socket directly
+                // so the spawned host receives the probe even if another browser registers in the meantime.
                 await new Promise(r => setTimeout(r, 1200));
+                if (action === 'browser_list') {
+                    return invokeViaLegacy(action, data, timeoutSec, transport, controlSource, 
+                    /* isRetry */ true);
+                }
                 const browsers = listLiveBrowsers();
                 if (browsers.length > 0) {
                     return invokeOnce(action, data, timeoutSec, transport, browsers[0].socketPath, controlSource);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/client",
-  "version": "2.9.4",
+  "version": "2.9.6",
   "description": "Unified Mearl SDK & CLI for local and remote browsers",
   "type": "module",
   "main": "dist/index.js",
@@ -55,7 +55,7 @@
     "commander": "^15.0.0",
     "fastest-levenshtein": "^1.0.16",
     "ws": "^8.18.0",
-    "@mearl/cloud-types": "2.9.4"
+    "@mearl/cloud-types": "2.9.6"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",