@mcp-z/client 2.2.4 → 2.3.0

package/dist/cjs/spawn/owned-process-tree.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "OwnedProcessTree", {
+    enumerable: true,
+    get: function() {
+        return OwnedProcessTree;
+    }
+});
+var _process = /*#__PURE__*/ _interop_require_wildcard(require("process"));
+function _class_call_check(instance, Constructor) {
+    if (!(instance instanceof Constructor)) throw new TypeError("Cannot call a class as a function");
+}
+function _instanceof(left, right) {
+    "@swc/helpers - instanceof";
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else return left instanceof right;
+}
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) return obj;
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") return {
+        default: obj
+    };
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) return cache.get(obj);
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) Object.defineProperty(newObj, key, desc);
+            else newObj[key] = obj[key];
+        }
+    }
+    newObj.default = obj;
+    if (cache) cache.set(obj, newObj);
+    return newObj;
+}
+var OwnedProcessTree = /*#__PURE__*/ function() {
+    "use strict";
+    function OwnedProcessTree(rootPid) {
+        _class_call_check(this, OwnedProcessTree);
+        if (_process.platform === 'win32') throw new Error('Owned process groups are not available on Windows');
+        this._rootPid = rootPid;
+    }
+    var _proto = OwnedProcessTree.prototype;
+    _proto.isEmpty = function isEmpty() {
+        try {
+            _process.kill(-this._rootPid, 0);
+            return false;
+        } catch (error) {
+            if (isErrno(error, 'ESRCH')) return true;
+            if (isErrno(error, 'EPERM')) return false;
+            throw toError(error);
+        }
+    };
+    _proto.terminate = function terminate() {
+        try {
+            _process.kill(-this._rootPid, 'SIGKILL');
+            return {
+                killed: true
+            };
+        } catch (error) {
+            if (isErrno(error, 'ESRCH')) return {
+                killed: false
+            };
+            return {
+                killed: false,
+                error: toError(error)
+            };
+        }
+    };
+    return OwnedProcessTree;
+}();
+function isErrno(error, code) {
+    return _instanceof(error, Error) && 'code' in error && error.code === code;
+}
+function toError(error) {
+    return _instanceof(error, Error) ? error : new Error(String(error));
+}
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/spawn/owned-process-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/client/src/spawn/owned-process-tree.ts"],"sourcesContent":["import * as process from 'process';\n\ninterface TerminationResult {\n  killed: boolean;\n  error?: Error;\n}\n\n/** Tracks the detached process group used for owned processes on POSIX. */\nexport class OwnedProcessTree {\n  private readonly _rootPid: number;\n\n  constructor(rootPid: number) {\n    if (process.platform === 'win32') throw new Error('Owned process groups are not available on Windows');\n    this._rootPid = rootPid;\n  }\n\n  isEmpty(): boolean {\n    try {\n      process.kill(-this._rootPid, 0);\n      return false;\n    } catch (error) {\n      if (isErrno(error, 'ESRCH')) return true;\n      if (isErrno(error, 'EPERM')) return false;\n      throw toError(error);\n    }\n  }\n\n  terminate(): TerminationResult {\n    try {\n      process.kill(-this._rootPid, 'SIGKILL');\n      return { killed: true };\n    } catch (error) {\n      if (isErrno(error, 'ESRCH')) return { killed: false };\n      return { killed: false, error: toError(error) };\n    }\n  }\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n  return error instanceof Error && 'code' in error && error.code === code;\n}\n\nfunction toError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(String(error));\n}\n"],"names":["OwnedProcessTree","rootPid","process","platform","Error","_rootPid","isEmpty","kill","error","isErrno","toError","terminate","killed","code","String"],"mappings":";;;;+BAQaA;;;eAAAA;;;+DARY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQlB,IAAA,AAAMA,iCAAN;;aAAMA,iBAGCC,OAAe;gCAHhBD;QAIT,IAAIE,SAAQC,QAAQ,KAAK,SAAS,MAAM,IAAIC,MAAM;QAClD,IAAI,CAACC,QAAQ,GAAGJ;;iBALPD;IAQXM,OAAAA,OASC,GATDA,SAAAA;QACE,IAAI;YACFJ,SAAQK,IAAI,CAAC,CAAC,IAAI,CAACF,QAAQ,EAAE;YAC7B,OAAO;QACT,EAAE,OAAOG,OAAO;YACd,IAAIC,QAAQD,OAAO,UAAU,OAAO;YACpC,IAAIC,QAAQD,OAAO,UAAU,OAAO;YACpC,MAAME,QAAQF;QAChB;IACF;IAEAG,OAAAA,SAQC,GARDA,SAAAA;QACE,IAAI;YACFT,SAAQK,IAAI,CAAC,CAAC,IAAI,CAACF,QAAQ,EAAE;YAC7B,OAAO;gBAAEO,QAAQ;YAAK;QACxB,EAAE,OAAOJ,OAAO;YACd,IAAIC,QAAQD,OAAO,UAAU,OAAO;gBAAEI,QAAQ;YAAM;YACpD,OAAO;gBAAEA,QAAQ;gBAAOJ,OAAOE,QAAQF;YAAO;QAChD;IACF;WA3BWR;;AA8Bb,SAASS,QAAQD,KAAc,EAAEK,IAAY;IAC3C,OAAOL,AAAK,YAALA,OAAiBJ,UAAS,UAAUI,SAASA,MAAMK,IAAI,KAAKA;AACrE;AAEA,SAASH,QAAQF,KAAc;IAC7B,OAAOA,AAAK,YAALA,OAAiBJ,SAAQI,QAAQ,IAAIJ,MAAMU,OAAON;AAC3D"}

package/dist/cjs/spawn/spawn-server.d.cts

@@ -2,7 +2,8 @@
  * Low-level single server spawning utilities.
  * Provides core process spawning with path resolution, environment management, and lifecycle control.
  */
-import { type ChildProcess, type StdioOptions } from 'child_process';
+import type { ChildProcess, StdioOptions } from 'child_process';
+import type { StopCommandConfig } from '../types.js';
 /**
  * Options for spawning a single server process.
  * @internal
@@ -18,10 +19,12 @@ export interface SpawnProcessOptions {
     cwd?: string;
     /** Additional environment variables (merged with process.env) */
     env?: Record<string, string>;
+    /** Whether to add process.env to env; registry callers provide a pre-merged environment */
+    inheritEnv?: boolean;
     /** Standard I/O configuration */
     stdio?: StdioOptions;
-    /** Use shell for command execution (default: false, true on Windows) */
-    shell?: boolean;
+    /** Application-specific shutdown command for an owned HTTP server */
+    stop?: StopCommandConfig;
 }
 /**
  * Handle to a spawned server process.
@@ -29,10 +32,6 @@ export interface SpawnProcessOptions {
  * @hidden
  */
 export interface ServerProcess {
-    /**
-     * The resolved server configuration that was actually used.
-     * Useful for debugging and understanding what was spawned.
-     */
     config: {
         name: string;
         command: string;
@@ -40,20 +39,9 @@ export interface ServerProcess {
         cwd: string;
         env: Record<string, string>;
         stdio: StdioOptions;
-        shell: boolean;
+        shell: false;
     };
-    /**
-     * The spawned child process.
-     */
     process: ChildProcess;
-    /**
-     * Close the server gracefully, terminating its process tree on Windows.
-     * Sends the specified signal (default: SIGINT), then force-kills after timeout.
-     *
-     * @param signal - Signal to send (default: SIGINT)
-     * @param opts - Options including timeout
-     * @returns Promise resolving to whether the process timed out and was force-killed
-     */
     close: (signal?: NodeJS.Signals, opts?: {
         timeoutMs?: number;
     }) => Promise<{
@@ -66,18 +54,6 @@ export interface ServerProcess {
  *
  * @internal
  * @param opts - Server spawn options
- * @returns ServerProcess handle with resolved config, process, and stop function
- *
- * @example
- * const handle = spawnProcess({
- *   name: 'echo',
- *   command: 'node',
- *   args: ['./bin/server.js', '--port', '3000'],
- *   cwd: '/home/user/project/test/lib/servers/echo',
- *   env: { LOG_LEVEL: 'error' }
- * });
- *
- * // Later...
- * await handle.close();
+ * @returns ServerProcess handle with resolved config and lifecycle control
  */
 export declare function spawnProcess(opts: SpawnProcessOptions): ServerProcess;

package/dist/cjs/spawn/spawn-server.d.ts

@@ -2,7 +2,8 @@
  * Low-level single server spawning utilities.
  * Provides core process spawning with path resolution, environment management, and lifecycle control.
  */
-import { type ChildProcess, type StdioOptions } from 'child_process';
+import type { ChildProcess, StdioOptions } from 'child_process';
+import type { StopCommandConfig } from '../types.js';
 /**
  * Options for spawning a single server process.
  * @internal
@@ -18,10 +19,12 @@ export interface SpawnProcessOptions {
     cwd?: string;
     /** Additional environment variables (merged with process.env) */
     env?: Record<string, string>;
+    /** Whether to add process.env to env; registry callers provide a pre-merged environment */
+    inheritEnv?: boolean;
     /** Standard I/O configuration */
     stdio?: StdioOptions;
-    /** Use shell for command execution (default: false, true on Windows) */
-    shell?: boolean;
+    /** Application-specific shutdown command for an owned HTTP server */
+    stop?: StopCommandConfig;
 }
 /**
  * Handle to a spawned server process.
@@ -29,10 +32,6 @@ export interface SpawnProcessOptions {
  * @hidden
  */
 export interface ServerProcess {
-    /**
-     * The resolved server configuration that was actually used.
-     * Useful for debugging and understanding what was spawned.
-     */
     config: {
         name: string;
         command: string;
@@ -40,20 +39,9 @@ export interface ServerProcess {
         cwd: string;
         env: Record<string, string>;
         stdio: StdioOptions;
-        shell: boolean;
+        shell: false;
     };
-    /**
-     * The spawned child process.
-     */
     process: ChildProcess;
-    /**
-     * Close the server gracefully, terminating its process tree on Windows.
-     * Sends the specified signal (default: SIGINT), then force-kills after timeout.
-     *
-     * @param signal - Signal to send (default: SIGINT)
-     * @param opts - Options including timeout
-     * @returns Promise resolving to whether the process timed out and was force-killed
-     */
     close: (signal?: NodeJS.Signals, opts?: {
         timeoutMs?: number;
     }) => Promise<{
@@ -66,18 +54,6 @@ export interface ServerProcess {
  *
  * @internal
  * @param opts - Server spawn options
- * @returns ServerProcess handle with resolved config, process, and stop function
- *
- * @example
- * const handle = spawnProcess({
- *   name: 'echo',
- *   command: 'node',
- *   args: ['./bin/server.js', '--port', '3000'],
- *   cwd: '/home/user/project/test/lib/servers/echo',
- *   env: { LOG_LEVEL: 'error' }
- * });
- *
- * // Later...
- * await handle.close();
+ * @returns ServerProcess handle with resolved config and lifecycle control
  */
 export declare function spawnProcess(opts: SpawnProcessOptions): ServerProcess;