@xelexis/x-broker 0.15.0 → 0.17.0

package/README.md

@@ -7,7 +7,7 @@ Requires Node.js 18 or later and npm. Supports Windows x64, macOS ARM64/x64 and
 ## Prepare
 
 ```sh
-npx -y @xelexis/x-broker@0.15.0 --version
+npx -y @xelexis/x-broker@0.17.0 --version
 ```
 
 Pin a published npm version. The server and client versions can differ.
@@ -23,7 +23,7 @@ Use `npx` on every supported OS, including Windows. Replace the broker URL, proj
   "mcpServers": {
     "x-broker": {
       "command": "npx",
-      "args": ["-y", "@xelexis/x-broker@0.15.0", "--broker-url", "https://broker.example/mcp?project=brk", "--token", "<project token>"]
+      "args": ["-y", "@xelexis/x-broker@0.17.0", "--broker-url", "https://broker.example/mcp?project=brk", "--token", "<project token>"]
     }
   }
 }
@@ -34,7 +34,7 @@ Use `npx` on every supported OS, including Windows. Replace the broker URL, proj
 ```toml
 [mcp_servers.x-broker]
 command = "npx"
-args = ["-y", "@xelexis/x-broker@0.15.0", "--broker-url", "https://broker.example/mcp?project=brk", "--token", "<project token>"]
+args = ["-y", "@xelexis/x-broker@0.17.0", "--broker-url", "https://broker.example/mcp?project=brk", "--token", "<project token>"]
 ```
 
 Codex reads project settings only in trusted projects. Keep the same OS user and authentication directory when you change an existing setup.

package/bin/x-broker.js

@@ -2,9 +2,10 @@
 "use strict";
 
 // npm launcher for asb-client. It writes nothing to stdout (the MCP stdio
-// channel) and relays stdin/stdout through pipes rather than inheriting them:
-// if this process is killed, the client's stdin closes and it exits on EOF
-// instead of outliving its host. Diagnostics go to stderr only.
+// channel). POSIX execve replaces this process and inherits the host's stdio
+// pipes, so host EOF ends the client. The fallback relays through pipes: killing
+// the launcher closes the client's stdin so it cannot outlive its host.
+// Diagnostics go to stderr only.
 const { spawn } = require("node:child_process");
 const fs = require("node:fs");
 const path = require("node:path");
@@ -40,44 +41,52 @@ function checkBinary(file) {
   }
 }
 
-function main() {
+function main({ proc = process, spawnProcess = spawn, resolveBinary = binaryPath, verifyBinary = checkBinary } = {}) {
   let file;
   try {
-    file = binaryPath();
-    checkBinary(file);
+    file = resolveBinary({ platform: proc.platform, arch: proc.arch });
+    verifyBinary(file);
   } catch (err) {
-    process.stderr.write(`x-broker: ${err.message}\n`);
-    process.exit(1);
+    proc.stderr.write(`x-broker: ${err.message}\n`);
+    proc.exit(1);
   }
-  const child = spawn(file, process.argv.slice(2), { stdio: ["pipe", "pipe", "inherit"], windowsHide: true });
-  const signals = process.platform === "win32" ? ["SIGINT", "SIGTERM", "SIGBREAK"] : ["SIGINT", "SIGTERM", "SIGHUP"];
+  if (proc.platform !== "win32" && typeof proc.execve === "function") {
+    try {
+      proc.execve(file, [file, ...proc.argv.slice(2)], proc.env);
+      return;
+    } catch {
+      proc.stderr.write("x-broker: execve failed; using spawn fallback.\n");
+    }
+  }
+  const child = spawnProcess(file, proc.argv.slice(2), { stdio: ["pipe", "pipe", "inherit"], windowsHide: true });
+  const signals = proc.platform === "win32" ? ["SIGINT", "SIGTERM", "SIGBREAK"] : ["SIGINT", "SIGTERM", "SIGHUP"];
   const forward = (signal) => {
     if (child.exitCode === null && child.signalCode === null) child.kill(signal);
   };
-  for (const signal of signals) process.on(signal, forward);
+  for (const signal of signals) proc.on(signal, forward);
 
-  process.stdin.pipe(child.stdin);
-  child.stdout.pipe(process.stdout, { end: false });
+  proc.stdin.pipe(child.stdin);
+  child.stdout.pipe(proc.stdout, { end: false });
   // The client may exit before reading everything, and the host may close
   // our stdout; neither is a launcher error.
   child.stdin.on("error", () => {});
-  process.stdout.on("error", () => forward("SIGTERM"));
+  proc.stdout.on("error", () => forward("SIGTERM"));
 
   child.on("error", (err) => {
-    process.stderr.write(`x-broker: cannot start ${file}: ${err.message}\n`);
-    process.exit(1);
+    proc.stderr.write(`x-broker: cannot start ${file}: ${err.message}\n`);
+    proc.exit(1);
   });
   child.on("close", (code, signal) => {
-    process.stdin.unpipe(child.stdin);
-    process.stdin.destroy();
-    for (const s of signals) process.removeListener(s, forward);
+    proc.stdin.unpipe(child.stdin);
+    proc.stdin.destroy();
+    for (const s of signals) proc.removeListener(s, forward);
     // Flush relayed output before mirroring the client's exit.
-    process.stdout.write("", () => {
-      if (signal) process.kill(process.pid, signal);
-      process.exit(code ?? 1);
+    proc.stdout.write("", () => {
+      if (signal) proc.kill(proc.pid, signal);
+      proc.exit(code ?? 1);
     });
   });
 }
 
 if (require.main === module) main();
-module.exports = { binaryPath };
+module.exports = { binaryPath, main };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xelexis/x-broker",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "npx launcher and bundled clients for the Agent Session Broker MCP client (asb-client)",
   "bin": {
     "x-broker": "bin/x-broker.js"
@@ -23,5 +23,5 @@
   "bugs": {
     "url": "https://github.com/xelexis-dev/agent-session-broker-deploy#readme"
   },
-  "xBrokerClientInputs": "sha256:bc6d362b539915e555d7bf1672adbc674e99467e832f99cc4d388e524e942edd"
+  "xBrokerClientInputs": "sha256:1ef87e77d25e135b47673f0b79adfabb384a64e0b49d2f0b3dbb51092d1f0f3c"
 }