@mcp-z/client 2.2.3 → 2.3.0

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

@@ -4,10 +4,12 @@
  * Supports stdio, http, and ws transports.
  * Implements Claude Code-compatible configuration with start extension support.
  */
+import type { VersionNegotiationOptions } from '@modelcontextprotocol/client';
 import { type ManagedClient } from '../client-helpers.js';
-import { connectMcpClient } from '../connection/connect-client.js';
+import type { DcrAuthenticatorOptions } from '../dcr/dcr-authenticator.js';
 import { type SearchOptions, type SearchResponse } from '../search/index.js';
 import type { McpServerEntry } from '../types.js';
+import { type Logger } from '../utils/logger.js';
 import { type ServerProcess } from './spawn-server.js';
 /**
  * Servers configuration type - a map of server names to their configurations.
@@ -45,16 +47,15 @@ export interface CreateServerRegistryOptions {
  * Result of closing the registry.
  */
 export interface CloseResult {
-    /** Whether any process timed out during shutdown */
+    /** Whether any owned process exceeded its cooperative shutdown timeout */
     timedOut: boolean;
-    /** Number of processes that were force-killed */
+    /** Number of owned processes that required emergency force termination */
     killedCount: number;
 }
 /**
  * A registry of spawned MCP servers with connection management.
  * Provides access to individual server handles, connection management, and collection-wide close.
  */
-type RegistryConnectOptions = Parameters<typeof connectMcpClient>[2];
 export interface ServerRegistry {
     /**
      * The resolved servers configuration that was used.
@@ -76,16 +77,26 @@ export interface ServerRegistry {
      * The connected client is automatically tracked for close.
      *
      * @param name - Server name from configuration
+     * @param options - Authentication, logging, and protocol negotiation options
      * @returns Connected MCP SDK Client
      */
-    connect: (name: string, options?: RegistryConnectOptions) => Promise<ManagedClient>;
+    connect: (name: string, options?: {
+        dcrAuthenticator?: Partial<DcrAuthenticatorOptions>;
+        logger?: Logger;
+        versionNegotiation?: VersionNegotiationOptions;
+    }) => Promise<ManagedClient>;
     /**
      * Close all clients and servers gracefully.
-     * First closes all tracked clients, then sends the specified signal to all server processes.
+     * Stops new connections, waits for in-flight connections, closes tracked clients, and then
+     * stops only processes owned by this registry. Stdio children receive stdin EOF first
+     * and the requested signal on POSIX if they remain open; owned HTTP children may use
+     * their configured application-specific stop command. POSIX cleanup tracks the detached
+     * process group; Windows can terminate only the direct child and cannot verify descendants.
+     * Cleanup failures are reported after every owned resource has been attempted.
      *
      * @param signal - Signal to send to processes (default: SIGINT)
      * @param opts - Options including timeout
-     * @returns Promise resolving to whether any process timed out and how many were force-killed
+     * @returns Promise resolving to whether any process timed out and how many required emergency force termination
      */
     close: (signal?: NodeJS.Signals, opts?: {
         timeoutMs?: number;
@@ -148,4 +159,3 @@ export interface ServerRegistry {
  * // Auto-disposed when scope exits
  */
 export declare function createServerRegistry(serversConfig: ServersConfig, options?: CreateServerRegistryOptions): ServerRegistry;
-export {};

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

@@ -4,10 +4,12 @@
  * Supports stdio, http, and ws transports.
  * Implements Claude Code-compatible configuration with start extension support.
  */
+import type { VersionNegotiationOptions } from '@modelcontextprotocol/client';
 import { type ManagedClient } from '../client-helpers.js';
-import { connectMcpClient } from '../connection/connect-client.js';
+import type { DcrAuthenticatorOptions } from '../dcr/dcr-authenticator.js';
 import { type SearchOptions, type SearchResponse } from '../search/index.js';
 import type { McpServerEntry } from '../types.js';
+import { type Logger } from '../utils/logger.js';
 import { type ServerProcess } from './spawn-server.js';
 /**
  * Servers configuration type - a map of server names to their configurations.
@@ -45,16 +47,15 @@ export interface CreateServerRegistryOptions {
  * Result of closing the registry.
  */
 export interface CloseResult {
-    /** Whether any process timed out during shutdown */
+    /** Whether any owned process exceeded its cooperative shutdown timeout */
     timedOut: boolean;
-    /** Number of processes that were force-killed */
+    /** Number of owned processes that required emergency force termination */
     killedCount: number;
 }
 /**
  * A registry of spawned MCP servers with connection management.
  * Provides access to individual server handles, connection management, and collection-wide close.
  */
-type RegistryConnectOptions = Parameters<typeof connectMcpClient>[2];
 export interface ServerRegistry {
     /**
      * The resolved servers configuration that was used.
@@ -76,16 +77,26 @@ export interface ServerRegistry {
      * The connected client is automatically tracked for close.
      *
      * @param name - Server name from configuration
+     * @param options - Authentication, logging, and protocol negotiation options
      * @returns Connected MCP SDK Client
      */
-    connect: (name: string, options?: RegistryConnectOptions) => Promise<ManagedClient>;
+    connect: (name: string, options?: {
+        dcrAuthenticator?: Partial<DcrAuthenticatorOptions>;
+        logger?: Logger;
+        versionNegotiation?: VersionNegotiationOptions;
+    }) => Promise<ManagedClient>;
     /**
      * Close all clients and servers gracefully.
-     * First closes all tracked clients, then sends the specified signal to all server processes.
+     * Stops new connections, waits for in-flight connections, closes tracked clients, and then
+     * stops only processes owned by this registry. Stdio children receive stdin EOF first
+     * and the requested signal on POSIX if they remain open; owned HTTP children may use
+     * their configured application-specific stop command. POSIX cleanup tracks the detached
+     * process group; Windows can terminate only the direct child and cannot verify descendants.
+     * Cleanup failures are reported after every owned resource has been attempted.
      *
      * @param signal - Signal to send to processes (default: SIGINT)
      * @param opts - Options including timeout
-     * @returns Promise resolving to whether any process timed out and how many were force-killed
+     * @returns Promise resolving to whether any process timed out and how many required emergency force termination
      */
     close: (signal?: NodeJS.Signals, opts?: {
         timeoutMs?: number;
@@ -148,4 +159,3 @@ export interface ServerRegistry {
  * // Auto-disposed when scope exits
  */
 export declare function createServerRegistry(serversConfig: ServersConfig, options?: CreateServerRegistryOptions): ServerRegistry;
-export {};