@midscene/computer 1.12.2-beta-20260828074555.0 → 1.12.2

package/dist/es/cli.mjs

@@ -185,7 +185,50 @@ class ComputerInputDriver {
     }
 }
 const debugXvfb = getDebug('computer:xvfb');
-function createXvfbSigintCleanup(cleanup, source = process) {
+const xvfbCleanupMonitorScript = String.raw`
+const parentPid = Number(process.argv[1]);
+const xvfbPid = Number(process.argv[2]);
+const timer = setInterval(() => {
+  try {
+    process.kill(xvfbPid, 0);
+  } catch {
+    clearInterval(timer);
+    process.exit(0);
+  }
+  try {
+    process.kill(parentPid, 0);
+    return;
+  } catch {
+    // The owner is gone, so its X11 clients can no longer receive XIO errors.
+  }
+  try {
+    process.kill(xvfbPid, 'SIGTERM');
+  } catch {
+    // Xvfb may have already exited.
+  }
+  clearInterval(timer);
+}, 100);
+`;
+function scheduleXvfbStopAfterProcessExit(instance, parentPid = process.pid) {
+    const xvfbPid = instance.process.pid;
+    if (!xvfbPid) throw new Error('Cannot schedule Xvfb cleanup before its process starts');
+    const monitor = spawn(process.execPath, [
+        '-e',
+        xvfbCleanupMonitorScript,
+        String(parentPid),
+        String(xvfbPid)
+    ], {
+        detached: true,
+        stdio: 'ignore'
+    });
+    monitor.on('error', (error)=>{
+        debugXvfb(`Xvfb cleanup monitor failed: ${error.message}`);
+    });
+    instance.process.unref();
+    monitor.unref();
+    return monitor;
+}
+function createXvfbSignalCleanup(cleanup, source = process) {
     return ()=>{
         if (!hasActiveCliInterruptWaiter(source)) cleanup();
     };
@@ -736,18 +779,21 @@ class ComputerDevice {
                 this.xvfbInstance = await startXvfb({
                     resolution: this.options?.xvfbResolution
                 });
+                if (this.options?.keepXvfbAliveUntilProcessExit) scheduleXvfbStopAfterProcessExit(this.xvfbInstance);
                 process.env.DISPLAY = this.xvfbInstance.display;
                 debugDevice(`Xvfb started on display ${this.xvfbInstance.display}`);
-                this.xvfbCleanup = ()=>{
-                    if (this.xvfbInstance) {
-                        this.xvfbInstance.stop();
-                        this.xvfbInstance = void 0;
-                    }
-                };
-                this.xvfbSigintCleanup = createXvfbSigintCleanup(()=>this.xvfbCleanup?.());
-                process.on('exit', this.xvfbCleanup);
-                process.on('SIGINT', this.xvfbSigintCleanup);
-                process.on('SIGTERM', this.xvfbCleanup);
+                if (!this.options?.keepXvfbAliveUntilProcessExit) {
+                    this.xvfbCleanup = ()=>{
+                        if (this.xvfbInstance) {
+                            this.xvfbInstance.stop();
+                            this.xvfbInstance = void 0;
+                        }
+                    };
+                    this.xvfbSignalCleanup = createXvfbSignalCleanup(()=>this.xvfbCleanup?.());
+                    process.on('exit', this.xvfbCleanup);
+                    process.on('SIGINT', this.xvfbSignalCleanup);
+                    process.on('SIGTERM', this.xvfbSignalCleanup);
+                }
             }
             device_libnut = await getLibnut();
             this.displayGeometry = resolveDisplayGeometry(this.displayId);
@@ -765,17 +811,17 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
             await this.healthCheck();
         } catch (error) {
             if (this.xvfbInstance) {
-                this.xvfbInstance.stop();
+                if (!this.options?.keepXvfbAliveUntilProcessExit) this.xvfbInstance.stop();
                 this.xvfbInstance = void 0;
             }
             if (this.xvfbCleanup) {
                 process.removeListener('exit', this.xvfbCleanup);
-                process.removeListener('SIGTERM', this.xvfbCleanup);
                 this.xvfbCleanup = void 0;
             }
-            if (this.xvfbSigintCleanup) {
-                process.removeListener('SIGINT', this.xvfbSigintCleanup);
-                this.xvfbSigintCleanup = void 0;
+            if (this.xvfbSignalCleanup) {
+                process.removeListener('SIGINT', this.xvfbSignalCleanup);
+                process.removeListener('SIGTERM', this.xvfbSignalCleanup);
+                this.xvfbSignalCleanup = void 0;
             }
             debugDevice(`Failed to connect: ${error}`);
             throw new Error(`Unable to connect to computer device: ${error}`);
@@ -783,7 +829,7 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     async healthCheck() {
         console.log('[HealthCheck] Starting health check...');
-        console.log("[HealthCheck] @midscene/computer v1.12.2-beta-20260828074555.0");
+        console.log("[HealthCheck] @midscene/computer v1.12.2");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1120,18 +1166,19 @@ $g.Dispose(); $bmp.Dispose(); $ms.Dispose()
         if (this.destroyed) return;
         this.destroyed = true;
         this.inputDriver.destroy();
+        const keepXvfbAliveUntilProcessExit = this.options?.keepXvfbAliveUntilProcessExit === true;
         if (this.xvfbInstance) {
-            this.xvfbInstance.stop();
+            if (!keepXvfbAliveUntilProcessExit) this.xvfbInstance.stop();
             this.xvfbInstance = void 0;
         }
-        if (this.xvfbCleanup) {
+        if (this.xvfbCleanup && !keepXvfbAliveUntilProcessExit) {
             process.removeListener('exit', this.xvfbCleanup);
-            process.removeListener('SIGTERM', this.xvfbCleanup);
             this.xvfbCleanup = void 0;
         }
-        if (this.xvfbSigintCleanup) {
-            process.removeListener('SIGINT', this.xvfbSigintCleanup);
-            this.xvfbSigintCleanup = void 0;
+        if (this.xvfbSignalCleanup) {
+            process.removeListener('SIGINT', this.xvfbSignalCleanup);
+            process.removeListener('SIGTERM', this.xvfbSignalCleanup);
+            this.xvfbSignalCleanup = void 0;
         }
         debugDevice('Computer device destroyed');
     }
@@ -1147,7 +1194,7 @@ $g.Dispose(); $bmp.Dispose(); $ms.Dispose()
         device_define_property(this, "destroyed", false);
         device_define_property(this, "xvfbInstance", void 0);
         device_define_property(this, "xvfbCleanup", void 0);
-        device_define_property(this, "xvfbSigintCleanup", void 0);
+        device_define_property(this, "xvfbSignalCleanup", void 0);
         device_define_property(this, "inputDriver", new ComputerInputDriver({
             getLibnut: ()=>device_libnut,
             useAppleScript: ()=>this.useAppleScript,
@@ -1963,7 +2010,8 @@ function createLocalComputerDevice(opts) {
         keyboardTypeDelay: opts?.keyboardTypeDelay,
         keyboardDriver: opts?.keyboardDriver,
         headless: opts?.headless,
-        xvfbResolution: opts?.xvfbResolution
+        xvfbResolution: opts?.xvfbResolution,
+        keepXvfbAliveUntilProcessExit: opts?.keepXvfbAliveUntilProcessExit
     });
 }
 function createRDPComputerDevice(opts) {
@@ -2106,6 +2154,9 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
             ...void 0 !== keyboardTypeDelay ? {
                 keyboardTypeDelay
             } : {},
+            ...this.options.keepXvfbAliveUntilProcessExit ? {
+                keepXvfbAliveUntilProcessExit: true
+            } : {},
             ...extractAgentBehaviorInitArgs(opts) ?? {},
             ...reportOptions ?? {}
         };
@@ -2171,21 +2222,23 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
             }
         ];
     }
-    constructor(...args){
-        super(...args), agent_tools_define_property(this, "lastInitArgsSignature", void 0), agent_tools_define_property(this, "initArgSpec", {
+    constructor(options = {}){
+        super(), agent_tools_define_property(this, "options", void 0), agent_tools_define_property(this, "lastInitArgsSignature", void 0), agent_tools_define_property(this, "initArgSpec", void 0), this.options = options, this.initArgSpec = {
             namespace: 'computer',
             shape: computerInitArgShape,
             cli: {
                 preferBareKeys: true
             },
             adapt: (extracted)=>adaptComputerInitArgs(extracted)
-        });
+        };
     }
 }
-const tools = new ComputerMidsceneTools();
+const tools = new ComputerMidsceneTools({
+    keepXvfbAliveUntilProcessExit: true
+});
 runToolsCLI(tools, 'midscene-computer', {
     stripPrefix: 'computer_',
-    version: "1.12.2-beta-20260828074555.0",
+    version: "1.12.2",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -185,7 +185,50 @@ class ComputerInputDriver {
     }
 }
 const debugXvfb = getDebug('computer:xvfb');
-function createXvfbSigintCleanup(cleanup, source = process) {
+const xvfbCleanupMonitorScript = String.raw`
+const parentPid = Number(process.argv[1]);
+const xvfbPid = Number(process.argv[2]);
+const timer = setInterval(() => {
+  try {
+    process.kill(xvfbPid, 0);
+  } catch {
+    clearInterval(timer);
+    process.exit(0);
+  }
+  try {
+    process.kill(parentPid, 0);
+    return;
+  } catch {
+    // The owner is gone, so its X11 clients can no longer receive XIO errors.
+  }
+  try {
+    process.kill(xvfbPid, 'SIGTERM');
+  } catch {
+    // Xvfb may have already exited.
+  }
+  clearInterval(timer);
+}, 100);
+`;
+function scheduleXvfbStopAfterProcessExit(instance, parentPid = process.pid) {
+    const xvfbPid = instance.process.pid;
+    if (!xvfbPid) throw new Error('Cannot schedule Xvfb cleanup before its process starts');
+    const monitor = spawn(process.execPath, [
+        '-e',
+        xvfbCleanupMonitorScript,
+        String(parentPid),
+        String(xvfbPid)
+    ], {
+        detached: true,
+        stdio: 'ignore'
+    });
+    monitor.on('error', (error)=>{
+        debugXvfb(`Xvfb cleanup monitor failed: ${error.message}`);
+    });
+    instance.process.unref();
+    monitor.unref();
+    return monitor;
+}
+function createXvfbSignalCleanup(cleanup, source = process) {
     return ()=>{
         if (!hasActiveCliInterruptWaiter(source)) cleanup();
     };
@@ -736,18 +779,21 @@ class ComputerDevice {
                 this.xvfbInstance = await startXvfb({
                     resolution: this.options?.xvfbResolution
                 });
+                if (this.options?.keepXvfbAliveUntilProcessExit) scheduleXvfbStopAfterProcessExit(this.xvfbInstance);
                 process.env.DISPLAY = this.xvfbInstance.display;
                 debugDevice(`Xvfb started on display ${this.xvfbInstance.display}`);
-                this.xvfbCleanup = ()=>{
-                    if (this.xvfbInstance) {
-                        this.xvfbInstance.stop();
-                        this.xvfbInstance = void 0;
-                    }
-                };
-                this.xvfbSigintCleanup = createXvfbSigintCleanup(()=>this.xvfbCleanup?.());
-                process.on('exit', this.xvfbCleanup);
-                process.on('SIGINT', this.xvfbSigintCleanup);
-                process.on('SIGTERM', this.xvfbCleanup);
+                if (!this.options?.keepXvfbAliveUntilProcessExit) {
+                    this.xvfbCleanup = ()=>{
+                        if (this.xvfbInstance) {
+                            this.xvfbInstance.stop();
+                            this.xvfbInstance = void 0;
+                        }
+                    };
+                    this.xvfbSignalCleanup = createXvfbSignalCleanup(()=>this.xvfbCleanup?.());
+                    process.on('exit', this.xvfbCleanup);
+                    process.on('SIGINT', this.xvfbSignalCleanup);
+                    process.on('SIGTERM', this.xvfbSignalCleanup);
+                }
             }
             device_libnut = await getLibnut();
             this.displayGeometry = resolveDisplayGeometry(this.displayId);
@@ -765,17 +811,17 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
             await this.healthCheck();
         } catch (error) {
             if (this.xvfbInstance) {
-                this.xvfbInstance.stop();
+                if (!this.options?.keepXvfbAliveUntilProcessExit) this.xvfbInstance.stop();
                 this.xvfbInstance = void 0;
             }
             if (this.xvfbCleanup) {
                 process.removeListener('exit', this.xvfbCleanup);
-                process.removeListener('SIGTERM', this.xvfbCleanup);
                 this.xvfbCleanup = void 0;
             }
-            if (this.xvfbSigintCleanup) {
-                process.removeListener('SIGINT', this.xvfbSigintCleanup);
-                this.xvfbSigintCleanup = void 0;
+            if (this.xvfbSignalCleanup) {
+                process.removeListener('SIGINT', this.xvfbSignalCleanup);
+                process.removeListener('SIGTERM', this.xvfbSignalCleanup);
+                this.xvfbSignalCleanup = void 0;
             }
             debugDevice(`Failed to connect: ${error}`);
             throw new Error(`Unable to connect to computer device: ${error}`);
@@ -783,7 +829,7 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     async healthCheck() {
         console.log('[HealthCheck] Starting health check...');
-        console.log("[HealthCheck] @midscene/computer v1.12.2-beta-20260828074555.0");
+        console.log("[HealthCheck] @midscene/computer v1.12.2");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1120,18 +1166,19 @@ $g.Dispose(); $bmp.Dispose(); $ms.Dispose()
         if (this.destroyed) return;
         this.destroyed = true;
         this.inputDriver.destroy();
+        const keepXvfbAliveUntilProcessExit = this.options?.keepXvfbAliveUntilProcessExit === true;
         if (this.xvfbInstance) {
-            this.xvfbInstance.stop();
+            if (!keepXvfbAliveUntilProcessExit) this.xvfbInstance.stop();
             this.xvfbInstance = void 0;
         }
-        if (this.xvfbCleanup) {
+        if (this.xvfbCleanup && !keepXvfbAliveUntilProcessExit) {
             process.removeListener('exit', this.xvfbCleanup);
-            process.removeListener('SIGTERM', this.xvfbCleanup);
             this.xvfbCleanup = void 0;
         }
-        if (this.xvfbSigintCleanup) {
-            process.removeListener('SIGINT', this.xvfbSigintCleanup);
-            this.xvfbSigintCleanup = void 0;
+        if (this.xvfbSignalCleanup) {
+            process.removeListener('SIGINT', this.xvfbSignalCleanup);
+            process.removeListener('SIGTERM', this.xvfbSignalCleanup);
+            this.xvfbSignalCleanup = void 0;
         }
         debugDevice('Computer device destroyed');
     }
@@ -1147,7 +1194,7 @@ $g.Dispose(); $bmp.Dispose(); $ms.Dispose()
         device_define_property(this, "destroyed", false);
         device_define_property(this, "xvfbInstance", void 0);
         device_define_property(this, "xvfbCleanup", void 0);
-        device_define_property(this, "xvfbSigintCleanup", void 0);
+        device_define_property(this, "xvfbSignalCleanup", void 0);
         device_define_property(this, "inputDriver", new ComputerInputDriver({
             getLibnut: ()=>device_libnut,
             useAppleScript: ()=>this.useAppleScript,
@@ -2006,7 +2053,8 @@ function createLocalComputerDevice(opts) {
         keyboardTypeDelay: opts?.keyboardTypeDelay,
         keyboardDriver: opts?.keyboardDriver,
         headless: opts?.headless,
-        xvfbResolution: opts?.xvfbResolution
+        xvfbResolution: opts?.xvfbResolution,
+        keepXvfbAliveUntilProcessExit: opts?.keepXvfbAliveUntilProcessExit
     });
 }
 function createRDPComputerDevice(opts) {
@@ -2149,6 +2197,9 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
             ...void 0 !== keyboardTypeDelay ? {
                 keyboardTypeDelay
             } : {},
+            ...this.options.keepXvfbAliveUntilProcessExit ? {
+                keepXvfbAliveUntilProcessExit: true
+            } : {},
             ...extractAgentBehaviorInitArgs(opts) ?? {},
             ...reportOptions ?? {}
         };
@@ -2214,19 +2265,19 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
             }
         ];
     }
-    constructor(...args){
-        super(...args), agent_tools_define_property(this, "lastInitArgsSignature", void 0), agent_tools_define_property(this, "initArgSpec", {
+    constructor(options = {}){
+        super(), agent_tools_define_property(this, "options", void 0), agent_tools_define_property(this, "lastInitArgsSignature", void 0), agent_tools_define_property(this, "initArgSpec", void 0), this.options = options, this.initArgSpec = {
             namespace: 'computer',
             shape: computerInitArgShape,
             cli: {
                 preferBareKeys: true
             },
             adapt: (extracted)=>adaptComputerInitArgs(extracted)
-        });
+        };
     }
 }
 function version() {
-    const currentVersion = "1.12.2-beta-20260828074555.0";
+    const currentVersion = "1.12.2";
     console.log(`@midscene/computer v${currentVersion}`);
     return currentVersion;
 }

package/dist/lib/cli.js

@@ -211,7 +211,50 @@ class ComputerInputDriver {
 }
 const interrupt_namespaceObject = require("@midscene/shared/cli/interrupt");
 const debugXvfb = (0, logger_namespaceObject.getDebug)('computer:xvfb');
-function createXvfbSigintCleanup(cleanup, source = process) {
+const xvfbCleanupMonitorScript = String.raw`
+const parentPid = Number(process.argv[1]);
+const xvfbPid = Number(process.argv[2]);
+const timer = setInterval(() => {
+  try {
+    process.kill(xvfbPid, 0);
+  } catch {
+    clearInterval(timer);
+    process.exit(0);
+  }
+  try {
+    process.kill(parentPid, 0);
+    return;
+  } catch {
+    // The owner is gone, so its X11 clients can no longer receive XIO errors.
+  }
+  try {
+    process.kill(xvfbPid, 'SIGTERM');
+  } catch {
+    // Xvfb may have already exited.
+  }
+  clearInterval(timer);
+}, 100);
+`;
+function scheduleXvfbStopAfterProcessExit(instance, parentPid = process.pid) {
+    const xvfbPid = instance.process.pid;
+    if (!xvfbPid) throw new Error('Cannot schedule Xvfb cleanup before its process starts');
+    const monitor = (0, external_node_child_process_namespaceObject.spawn)(process.execPath, [
+        '-e',
+        xvfbCleanupMonitorScript,
+        String(parentPid),
+        String(xvfbPid)
+    ], {
+        detached: true,
+        stdio: 'ignore'
+    });
+    monitor.on('error', (error)=>{
+        debugXvfb(`Xvfb cleanup monitor failed: ${error.message}`);
+    });
+    instance.process.unref();
+    monitor.unref();
+    return monitor;
+}
+function createXvfbSignalCleanup(cleanup, source = process) {
     return ()=>{
         if (!(0, interrupt_namespaceObject.hasActiveCliInterruptWaiter)(source)) cleanup();
     };
@@ -762,18 +805,21 @@ class ComputerDevice {
                 this.xvfbInstance = await startXvfb({
                     resolution: this.options?.xvfbResolution
                 });
+                if (this.options?.keepXvfbAliveUntilProcessExit) scheduleXvfbStopAfterProcessExit(this.xvfbInstance);
                 process.env.DISPLAY = this.xvfbInstance.display;
                 debugDevice(`Xvfb started on display ${this.xvfbInstance.display}`);
-                this.xvfbCleanup = ()=>{
-                    if (this.xvfbInstance) {
-                        this.xvfbInstance.stop();
-                        this.xvfbInstance = void 0;
-                    }
-                };
-                this.xvfbSigintCleanup = createXvfbSigintCleanup(()=>this.xvfbCleanup?.());
-                process.on('exit', this.xvfbCleanup);
-                process.on('SIGINT', this.xvfbSigintCleanup);
-                process.on('SIGTERM', this.xvfbCleanup);
+                if (!this.options?.keepXvfbAliveUntilProcessExit) {
+                    this.xvfbCleanup = ()=>{
+                        if (this.xvfbInstance) {
+                            this.xvfbInstance.stop();
+                            this.xvfbInstance = void 0;
+                        }
+                    };
+                    this.xvfbSignalCleanup = createXvfbSignalCleanup(()=>this.xvfbCleanup?.());
+                    process.on('exit', this.xvfbCleanup);
+                    process.on('SIGINT', this.xvfbSignalCleanup);
+                    process.on('SIGTERM', this.xvfbSignalCleanup);
+                }
             }
             device_libnut = await getLibnut();
             this.displayGeometry = resolveDisplayGeometry(this.displayId);
@@ -791,17 +837,17 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
             await this.healthCheck();
         } catch (error) {
             if (this.xvfbInstance) {
-                this.xvfbInstance.stop();
+                if (!this.options?.keepXvfbAliveUntilProcessExit) this.xvfbInstance.stop();
                 this.xvfbInstance = void 0;
             }
             if (this.xvfbCleanup) {
                 process.removeListener('exit', this.xvfbCleanup);
-                process.removeListener('SIGTERM', this.xvfbCleanup);
                 this.xvfbCleanup = void 0;
             }
-            if (this.xvfbSigintCleanup) {
-                process.removeListener('SIGINT', this.xvfbSigintCleanup);
-                this.xvfbSigintCleanup = void 0;
+            if (this.xvfbSignalCleanup) {
+                process.removeListener('SIGINT', this.xvfbSignalCleanup);
+                process.removeListener('SIGTERM', this.xvfbSignalCleanup);
+                this.xvfbSignalCleanup = void 0;
             }
             debugDevice(`Failed to connect: ${error}`);
             throw new Error(`Unable to connect to computer device: ${error}`);
@@ -809,7 +855,7 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     async healthCheck() {
         console.log('[HealthCheck] Starting health check...');
-        console.log("[HealthCheck] @midscene/computer v1.12.2-beta-20260828074555.0");
+        console.log("[HealthCheck] @midscene/computer v1.12.2");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1146,18 +1192,19 @@ $g.Dispose(); $bmp.Dispose(); $ms.Dispose()
         if (this.destroyed) return;
         this.destroyed = true;
         this.inputDriver.destroy();
+        const keepXvfbAliveUntilProcessExit = this.options?.keepXvfbAliveUntilProcessExit === true;
         if (this.xvfbInstance) {
-            this.xvfbInstance.stop();
+            if (!keepXvfbAliveUntilProcessExit) this.xvfbInstance.stop();
             this.xvfbInstance = void 0;
         }
-        if (this.xvfbCleanup) {
+        if (this.xvfbCleanup && !keepXvfbAliveUntilProcessExit) {
             process.removeListener('exit', this.xvfbCleanup);
-            process.removeListener('SIGTERM', this.xvfbCleanup);
             this.xvfbCleanup = void 0;
         }
-        if (this.xvfbSigintCleanup) {
-            process.removeListener('SIGINT', this.xvfbSigintCleanup);
-            this.xvfbSigintCleanup = void 0;
+        if (this.xvfbSignalCleanup) {
+            process.removeListener('SIGINT', this.xvfbSignalCleanup);
+            process.removeListener('SIGTERM', this.xvfbSignalCleanup);
+            this.xvfbSignalCleanup = void 0;
         }
         debugDevice('Computer device destroyed');
     }
@@ -1173,7 +1220,7 @@ $g.Dispose(); $bmp.Dispose(); $ms.Dispose()
         device_define_property(this, "destroyed", false);
         device_define_property(this, "xvfbInstance", void 0);
         device_define_property(this, "xvfbCleanup", void 0);
-        device_define_property(this, "xvfbSigintCleanup", void 0);
+        device_define_property(this, "xvfbSignalCleanup", void 0);
         device_define_property(this, "inputDriver", new ComputerInputDriver({
             getLibnut: ()=>device_libnut,
             useAppleScript: ()=>this.useAppleScript,
@@ -1990,7 +2037,8 @@ function createLocalComputerDevice(opts) {
         keyboardTypeDelay: opts?.keyboardTypeDelay,
         keyboardDriver: opts?.keyboardDriver,
         headless: opts?.headless,
-        xvfbResolution: opts?.xvfbResolution
+        xvfbResolution: opts?.xvfbResolution,
+        keepXvfbAliveUntilProcessExit: opts?.keepXvfbAliveUntilProcessExit
     });
 }
 function createRDPComputerDevice(opts) {
@@ -2133,6 +2181,9 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
             ...void 0 !== keyboardTypeDelay ? {
                 keyboardTypeDelay
             } : {},
+            ...this.options.keepXvfbAliveUntilProcessExit ? {
+                keepXvfbAliveUntilProcessExit: true
+            } : {},
             ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(opts) ?? {},
             ...reportOptions ?? {}
         };
@@ -2198,21 +2249,23 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
             }
         ];
     }
-    constructor(...args){
-        super(...args), agent_tools_define_property(this, "lastInitArgsSignature", void 0), agent_tools_define_property(this, "initArgSpec", {
+    constructor(options = {}){
+        super(), agent_tools_define_property(this, "options", void 0), agent_tools_define_property(this, "lastInitArgsSignature", void 0), agent_tools_define_property(this, "initArgSpec", void 0), this.options = options, this.initArgSpec = {
             namespace: 'computer',
             shape: computerInitArgShape,
             cli: {
                 preferBareKeys: true
             },
             adapt: (extracted)=>adaptComputerInitArgs(extracted)
-        });
+        };
     }
 }
-const tools = new ComputerMidsceneTools();
+const tools = new ComputerMidsceneTools({
+    keepXvfbAliveUntilProcessExit: true
+});
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-computer', {
     stripPrefix: 'computer_',
-    version: "1.12.2-beta-20260828074555.0",
+    version: "1.12.2",
     extraCommands: (0, core_namespaceObject.createReportCliCommands)()
 }).catch((e)=>{
     process.exit((0, cli_namespaceObject.reportCLIError)(e));

package/dist/lib/index.js

@@ -237,7 +237,50 @@ class ComputerInputDriver {
 }
 const interrupt_namespaceObject = require("@midscene/shared/cli/interrupt");
 const debugXvfb = (0, logger_namespaceObject.getDebug)('computer:xvfb');
-function createXvfbSigintCleanup(cleanup, source = process) {
+const xvfbCleanupMonitorScript = String.raw`
+const parentPid = Number(process.argv[1]);
+const xvfbPid = Number(process.argv[2]);
+const timer = setInterval(() => {
+  try {
+    process.kill(xvfbPid, 0);
+  } catch {
+    clearInterval(timer);
+    process.exit(0);
+  }
+  try {
+    process.kill(parentPid, 0);
+    return;
+  } catch {
+    // The owner is gone, so its X11 clients can no longer receive XIO errors.
+  }
+  try {
+    process.kill(xvfbPid, 'SIGTERM');
+  } catch {
+    // Xvfb may have already exited.
+  }
+  clearInterval(timer);
+}, 100);
+`;
+function scheduleXvfbStopAfterProcessExit(instance, parentPid = process.pid) {
+    const xvfbPid = instance.process.pid;
+    if (!xvfbPid) throw new Error('Cannot schedule Xvfb cleanup before its process starts');
+    const monitor = (0, external_node_child_process_namespaceObject.spawn)(process.execPath, [
+        '-e',
+        xvfbCleanupMonitorScript,
+        String(parentPid),
+        String(xvfbPid)
+    ], {
+        detached: true,
+        stdio: 'ignore'
+    });
+    monitor.on('error', (error)=>{
+        debugXvfb(`Xvfb cleanup monitor failed: ${error.message}`);
+    });
+    instance.process.unref();
+    monitor.unref();
+    return monitor;
+}
+function createXvfbSignalCleanup(cleanup, source = process) {
     return ()=>{
         if (!(0, interrupt_namespaceObject.hasActiveCliInterruptWaiter)(source)) cleanup();
     };
@@ -788,18 +831,21 @@ class ComputerDevice {
                 this.xvfbInstance = await startXvfb({
                     resolution: this.options?.xvfbResolution
                 });
+                if (this.options?.keepXvfbAliveUntilProcessExit) scheduleXvfbStopAfterProcessExit(this.xvfbInstance);
                 process.env.DISPLAY = this.xvfbInstance.display;
                 debugDevice(`Xvfb started on display ${this.xvfbInstance.display}`);
-                this.xvfbCleanup = ()=>{
-                    if (this.xvfbInstance) {
-                        this.xvfbInstance.stop();
-                        this.xvfbInstance = void 0;
-                    }
-                };
-                this.xvfbSigintCleanup = createXvfbSigintCleanup(()=>this.xvfbCleanup?.());
-                process.on('exit', this.xvfbCleanup);
-                process.on('SIGINT', this.xvfbSigintCleanup);
-                process.on('SIGTERM', this.xvfbCleanup);
+                if (!this.options?.keepXvfbAliveUntilProcessExit) {
+                    this.xvfbCleanup = ()=>{
+                        if (this.xvfbInstance) {
+                            this.xvfbInstance.stop();
+                            this.xvfbInstance = void 0;
+                        }
+                    };
+                    this.xvfbSignalCleanup = createXvfbSignalCleanup(()=>this.xvfbCleanup?.());
+                    process.on('exit', this.xvfbCleanup);
+                    process.on('SIGINT', this.xvfbSignalCleanup);
+                    process.on('SIGTERM', this.xvfbSignalCleanup);
+                }
             }
             device_libnut = await getLibnut();
             this.displayGeometry = resolveDisplayGeometry(this.displayId);
@@ -817,17 +863,17 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
             await this.healthCheck();
         } catch (error) {
             if (this.xvfbInstance) {
-                this.xvfbInstance.stop();
+                if (!this.options?.keepXvfbAliveUntilProcessExit) this.xvfbInstance.stop();
                 this.xvfbInstance = void 0;
             }
             if (this.xvfbCleanup) {
                 process.removeListener('exit', this.xvfbCleanup);
-                process.removeListener('SIGTERM', this.xvfbCleanup);
                 this.xvfbCleanup = void 0;
             }
-            if (this.xvfbSigintCleanup) {
-                process.removeListener('SIGINT', this.xvfbSigintCleanup);
-                this.xvfbSigintCleanup = void 0;
+            if (this.xvfbSignalCleanup) {
+                process.removeListener('SIGINT', this.xvfbSignalCleanup);
+                process.removeListener('SIGTERM', this.xvfbSignalCleanup);
+                this.xvfbSignalCleanup = void 0;
             }
             debugDevice(`Failed to connect: ${error}`);
             throw new Error(`Unable to connect to computer device: ${error}`);
@@ -835,7 +881,7 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     async healthCheck() {
         console.log('[HealthCheck] Starting health check...');
-        console.log("[HealthCheck] @midscene/computer v1.12.2-beta-20260828074555.0");
+        console.log("[HealthCheck] @midscene/computer v1.12.2");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -1172,18 +1218,19 @@ $g.Dispose(); $bmp.Dispose(); $ms.Dispose()
         if (this.destroyed) return;
         this.destroyed = true;
         this.inputDriver.destroy();
+        const keepXvfbAliveUntilProcessExit = this.options?.keepXvfbAliveUntilProcessExit === true;
         if (this.xvfbInstance) {
-            this.xvfbInstance.stop();
+            if (!keepXvfbAliveUntilProcessExit) this.xvfbInstance.stop();
             this.xvfbInstance = void 0;
         }
-        if (this.xvfbCleanup) {
+        if (this.xvfbCleanup && !keepXvfbAliveUntilProcessExit) {
             process.removeListener('exit', this.xvfbCleanup);
-            process.removeListener('SIGTERM', this.xvfbCleanup);
             this.xvfbCleanup = void 0;
         }
-        if (this.xvfbSigintCleanup) {
-            process.removeListener('SIGINT', this.xvfbSigintCleanup);
-            this.xvfbSigintCleanup = void 0;
+        if (this.xvfbSignalCleanup) {
+            process.removeListener('SIGINT', this.xvfbSignalCleanup);
+            process.removeListener('SIGTERM', this.xvfbSignalCleanup);
+            this.xvfbSignalCleanup = void 0;
         }
         debugDevice('Computer device destroyed');
     }
@@ -1199,7 +1246,7 @@ $g.Dispose(); $bmp.Dispose(); $ms.Dispose()
         device_define_property(this, "destroyed", false);
         device_define_property(this, "xvfbInstance", void 0);
         device_define_property(this, "xvfbCleanup", void 0);
-        device_define_property(this, "xvfbSigintCleanup", void 0);
+        device_define_property(this, "xvfbSignalCleanup", void 0);
         device_define_property(this, "inputDriver", new ComputerInputDriver({
             getLibnut: ()=>device_libnut,
             useAppleScript: ()=>this.useAppleScript,
@@ -2060,7 +2107,8 @@ function createLocalComputerDevice(opts) {
         keyboardTypeDelay: opts?.keyboardTypeDelay,
         keyboardDriver: opts?.keyboardDriver,
         headless: opts?.headless,
-        xvfbResolution: opts?.xvfbResolution
+        xvfbResolution: opts?.xvfbResolution,
+        keepXvfbAliveUntilProcessExit: opts?.keepXvfbAliveUntilProcessExit
     });
 }
 function createRDPComputerDevice(opts) {
@@ -2206,6 +2254,9 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
             ...void 0 !== keyboardTypeDelay ? {
                 keyboardTypeDelay
             } : {},
+            ...this.options.keepXvfbAliveUntilProcessExit ? {
+                keepXvfbAliveUntilProcessExit: true
+            } : {},
             ...(0, agent_behavior_init_args_namespaceObject.extractAgentBehaviorInitArgs)(opts) ?? {},
             ...reportOptions ?? {}
         };
@@ -2271,20 +2322,20 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
             }
         ];
     }
-    constructor(...args){
-        super(...args), agent_tools_define_property(this, "lastInitArgsSignature", void 0), agent_tools_define_property(this, "initArgSpec", {
+    constructor(options = {}){
+        super(), agent_tools_define_property(this, "options", void 0), agent_tools_define_property(this, "lastInitArgsSignature", void 0), agent_tools_define_property(this, "initArgSpec", void 0), this.options = options, this.initArgSpec = {
             namespace: 'computer',
             shape: computerInitArgShape,
             cli: {
                 preferBareKeys: true
             },
             adapt: (extracted)=>adaptComputerInitArgs(extracted)
-        });
+        };
     }
 }
 const env_namespaceObject = require("@midscene/shared/env");
 function version() {
-    const currentVersion = "1.12.2-beta-20260828074555.0";
+    const currentVersion = "1.12.2";
     console.log(`@midscene/computer v${currentVersion}`);
     return currentVersion;
 }

package/dist/types/index.d.ts

@@ -73,7 +73,7 @@ export declare class ComputerDevice implements AbstractInterface {
     private destroyed;
     private xvfbInstance?;
     private xvfbCleanup?;
-    private xvfbSigintCleanup?;
+    private xvfbSignalCleanup?;
     private readonly inputDriver;
     /**
      * On macOS, use AppleScript for keyboard operations by default
@@ -181,6 +181,14 @@ export declare interface ComputerDeviceOpt extends ComputerDeviceInputOpt {
      * Resolution for Xvfb virtual display (default '1920x1080x24')
      */
     xvfbResolution?: string;
+    /**
+     * Keep a managed Xvfb server alive until process exit.
+     *
+     * @internal The foreground CLI uses this because libnut keeps a process-wide
+     * X11 connection open. Stopping Xvfb during normal CLI teardown would make
+     * Xlib terminate an otherwise successful command with exit code 1.
+     */
+    keepXvfbAliveUntilProcessExit?: boolean;
 }
 
 /**
@@ -202,7 +210,9 @@ declare type ComputerLocalInitArgs = {
  * Extends BaseMidsceneTools to provide desktop automation tools
  */
 export declare class ComputerMidsceneTools extends BaseMidsceneTools<ComputerAgent, ComputerInitArgs> {
+    private readonly options;
     private lastInitArgsSignature?;
+    constructor(options?: ComputerMidsceneToolsOptions);
     protected getCliReportSessionName(): string;
     protected readonly initArgSpec: InitArgSpec<ComputerInitArgs>;
     protected createTemporaryDevice(): ComputerDevice;
@@ -213,6 +223,11 @@ export declare class ComputerMidsceneTools extends BaseMidsceneTools<ComputerAge
     protected preparePlatformTools(): ToolDefinition[];
 }
 
+declare interface ComputerMidsceneToolsOptions {
+    /** Keep CLI-owned Xvfb alive until process exit so Xlib clients stay valid. */
+    keepXvfbAliveUntilProcessExit?: boolean;
+}
+
 /** Init args for the RDP remote-desktop agent. */
 declare type ComputerRDPInitArgs = {
     mode: 'rdp';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/computer",
-  "version": "1.12.2-beta-20260828074555.0",
+  "version": "1.12.2",
   "description": "Midscene.js Computer Desktop Automation",
   "license": "MIT",
   "repository": {
@@ -33,8 +33,8 @@
     "@computer-use/libnut": "^4.2.0",
     "clipboardy": "^4.0.0",
     "screenshot-desktop": "^1.15.3",
-    "@midscene/core": "1.12.2-beta-20260828074555.0",
-    "@midscene/shared": "1.12.2-beta-20260828074555.0"
+    "@midscene/core": "1.12.2",
+    "@midscene/shared": "1.12.2"
   },
   "optionalDependencies": {
     "node-mac-permissions": "2.5.0"