@mcp-z/client 1.0.0

package/dist/cjs/spawn/spawn-servers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/libs/client/src/spawn/spawn-servers.ts"],"sourcesContent":["/**\n * High-level multi-server registry management.\n * Starts multiple servers from a servers configuration object.\n * Supports stdio, http, and ws transports.\n * Implements Claude Code-compatible configuration with start extension support.\n */\n\nimport * as fs from 'fs';\nimport * as process from 'process';\nimport { decorateClient, type ManagedClient } from '../client-helpers.ts';\nimport { validateServers } from '../config/validate-config.ts';\nimport { connectMcpClient } from '../connection/connect-client.ts';\nimport { buildCapabilityIndex, type CapabilityClient, searchCapabilities as executeCapabilitySearch, type SearchOptions, type SearchResponse } from '../search/index.ts';\nimport type { McpServerEntry, TransportType } from '../types.ts';\nimport { logger } from '../utils/logger.ts';\nimport { type ServerProcess, spawnProcess } from './spawn-server.ts';\n\n/**\n * Servers configuration type - a map of server names to their configurations.\n */\nexport type ServersConfig = Record<string, McpServerEntry>;\n\n/**\n * Dialect for server spawning.\n *\n * - 'servers': Spawn stdio servers (Claude Code compatible)\n * - 'start': Spawn HTTP servers with start blocks\n */\nexport type Dialect = 'servers' | 'start';\n\n/**\n * Options for creating a server registry.\n */\nexport interface CreateServerRegistryOptions {\n  /** Working directory for spawned processes (default: process.cwd()) */\n  cwd?: string;\n\n  /**\n   * Base environment for all servers.\n   * If provided, process.env is NOT included (caller has full control).\n   * If omitted, process.env is used as the base (default behavior).\n   */\n  env?: Record<string, string>;\n\n  /**\n   * Dialects controlling which servers to spawn.\n   * - ['servers']: Spawn stdio servers only (default, Claude Code compatible)\n   * - ['start']: Only spawn servers with start blocks (HTTP servers)\n   * - ['servers', 'start']: Spawn both stdio servers and start blocks\n   * @default ['servers']\n   */\n  dialects?: Dialect[];\n}\n\n/**\n * Result of closing the registry.\n */\nexport interface CloseResult {\n  /** Whether any process timed out during shutdown */\n  timedOut: boolean;\n  /** Number of processes that were force-killed */\n  killedCount: number;\n}\n\n/**\n * Infer transport type: explicit type > URL protocol > default 'stdio'\n */\nfunction inferTransportType(config: { type?: TransportType; url?: string }): TransportType {\n  if (config.type) {\n    return config.type;\n  }\n\n  if (config.url) {\n    const url = new URL(config.url);\n    if (url.protocol === 'http:' || url.protocol === 'https:') {\n      return 'http';\n    }\n  }\n\n  return 'stdio';\n}\n\n/**\n * Spawn configuration result (internal)\n */\ninterface SpawnConfig {\n  shouldSpawn: boolean;\n  command?: string;\n  args?: string[];\n  env?: Record<string, string>;\n}\n\n/**\n * Helper to filter undefined values from environment\n */\nfunction filterEnv(env: Record<string, string | undefined>): Record<string, string> {\n  const filtered: Record<string, string> = {};\n  for (const [key, value] of Object.entries(env)) {\n    if (value !== undefined) {\n      filtered[key] = value;\n    }\n  }\n  return filtered;\n}\n\n/**\n * Determine spawn behavior based on dialects and config structure.\n *\n * Dialects:\n * - ['servers'] (default): Claude Code compatible - ignores start blocks, stdio only\n * - ['start']: Only spawn servers with start blocks (HTTP server testing)\n * - ['servers', 'start']: Spawn both start blocks and stdio servers (full MCP-Z extension support)\n *\n * Environment merging (when baseEnv provided):\n * - HTTP servers (start block): { ...baseEnv, ...entry.start.env }\n * - Stdio servers: { ...baseEnv, ...entry.env }\n *\n * When baseEnv is not provided, process.env is used as the base.\n */\nfunction getSpawnConfig(entry: McpServerEntry, dialects: Dialect[], baseEnv: Record<string, string | undefined>): SpawnConfig {\n  const transportType = inferTransportType(entry);\n  const hasServers = dialects.includes('servers');\n  const hasStart = dialects.includes('start');\n\n  // If only 'servers' dialect: Claude Code compatible (ignore start blocks, stdio only)\n  if (hasServers && !hasStart) {\n    if (transportType === 'stdio' && entry.command) {\n      return {\n        shouldSpawn: true,\n        command: entry.command,\n        args: entry.args || [],\n        env: filterEnv({ ...baseEnv, ...entry.env }),\n      };\n    }\n    return { shouldSpawn: false };\n  }\n\n  // If only 'start' dialect: Only spawn servers with start blocks\n  if (hasStart && !hasServers) {\n    if (entry.start) {\n      return {\n        shouldSpawn: true,\n        command: entry.start.command,\n        args: entry.start.args || [],\n        env: filterEnv({ ...baseEnv, ...entry.start.env }),\n      };\n    }\n    return { shouldSpawn: false };\n  }\n\n  // Both dialects: Spawn both start blocks and stdio servers\n  // Priority: start blocks first, then stdio\n  if (entry.start) {\n    return {\n      shouldSpawn: true,\n      command: entry.start.command,\n      args: entry.start.args || [],\n      env: filterEnv({ ...baseEnv, ...entry.start.env }),\n    };\n  }\n\n  if (transportType === 'stdio' && entry.command) {\n    return {\n      shouldSpawn: true,\n      command: entry.command,\n      args: entry.args || [],\n      env: filterEnv({ ...baseEnv, ...entry.env }),\n    };\n  }\n\n  return { shouldSpawn: false };\n}\n\n/**\n * A registry of spawned MCP servers with connection management.\n * Provides access to individual server handles, connection management, and collection-wide close.\n */\ntype RegistryConnectOptions = Parameters<typeof connectMcpClient>[2];\n\nexport interface ServerRegistry {\n  /**\n   * The resolved servers configuration that was used.\n   * Useful for debugging and understanding what was started.\n   */\n  config: ServersConfig;\n\n  /**\n   * Map of server name to server process handle.\n   * @hidden\n   */\n  servers: Map<string, ServerProcess>;\n\n  /**\n   * Set of connected clients tracked by this registry.\n   * Automatically populated when using registry.connect().\n   */\n  clients: Set<ManagedClient>;\n\n  /**\n   * Connect to a server by name.\n   * The connected client is automatically tracked for close.\n   *\n   * @param name - Server name from configuration\n   * @returns Connected MCP SDK Client\n   */\n  connect: (name: string, options?: RegistryConnectOptions) => Promise<ManagedClient>;\n\n  /**\n   * Close all clients and servers gracefully.\n   * First closes all tracked clients, then sends the specified signal to all server processes.\n   *\n   * @param signal - Signal to send to processes (default: SIGINT)\n   * @param opts - Options including timeout\n   * @returns Promise resolving to whether any process timed out and how many were force-killed\n   */\n  close: (signal?: NodeJS.Signals, opts?: { timeoutMs?: number }) => Promise<CloseResult>;\n\n  /**\n   * Search indexed capabilities across all currently connected clients.\n   * Requires at least one connected client; respects SearchOptions filters.\n   */\n  searchCapabilities: (query: string, options?: SearchOptions) => Promise<SearchResponse>;\n\n  /**\n   * Support for `await using` pattern (automatic close).\n   */\n  [Symbol.asyncDispose]: () => Promise<void>;\n}\n\n/**\n * Create a registry of MCP servers from configuration.\n *\n * **Fast start**: Returns immediately after processes are created.\n * Use `registry.connect()` for lazy MCP connection.\n *\n * @param serversConfig - Map of server names to their configurations\n * @param options - Options for registry creation\n * @param options.cwd - Working directory for spawned processes (default: process.cwd())\n * @param options.env - Base environment for all servers. If provided, process.env is NOT included.\n *                      If omitted, process.env is used as the base (default behavior).\n * @param options.dialects - Dialects controlling which servers to spawn (default: ['servers'])\n *   - ['servers']: Spawn stdio servers only (Claude Code compatible)\n *   - ['start']: Only spawn servers with start blocks (HTTP servers)\n *   - ['servers', 'start']: Spawn both stdio servers and start blocks\n * @returns ServerRegistry instance with config, server map, connect method, and close function\n *\n * @example\n * // Fast server start (does NOT wait for readiness)\n * const registry = createServerRegistry({\n *   'echo': { command: 'node', args: ['server.ts'] },\n * });\n *\n * // Connect when needed (waits for MCP handshake)\n * const client = await registry.connect('echo');\n *\n * // Cleanup (closes all clients AND processes)\n * await registry.close();\n *\n * @example\n * // Start HTTP servers with start blocks\n * const registry = createServerRegistry(\n *   {\n *     'http-server': {\n *       url: 'http://localhost:8080/mcp',\n *       start: { command: 'node', args: ['http.ts', '--port', '8080'] }\n *     },\n *   },\n *   { dialects: ['start'] }\n * );\n *\n * @example\n * // Using await using for automatic close\n * await using registry = createServerRegistry(config);\n * const client = await registry.connect('server');\n * // Auto-disposed when scope exits\n */\nexport function createServerRegistry(serversConfig: ServersConfig, options?: CreateServerRegistryOptions): ServerRegistry {\n  const cwd = options?.cwd ?? process.cwd();\n  const dialects = options?.dialects ?? ['servers'];\n\n  // Determine base environment:\n  // - If options.env provided, use it (process.env NOT included)\n  // - If options.env omitted, use process.env as base\n  const baseEnv: Record<string, string | undefined> = options?.env ?? process.env;\n\n  // Validate working directory exists (fail fast for configuration errors)\n  if (!fs.existsSync(cwd)) {\n    throw new Error(`Cannot start servers: working directory '${cwd}' does not exist`);\n  }\n\n  // Validate configuration (fail fast with clear errors)\n  const validation = validateServers(serversConfig);\n  if (!validation.valid) {\n    throw new Error(`Invalid servers configuration:\\n${validation.errors?.join('\\n') ?? 'Unknown validation error'}`);\n  }\n\n  // Log validation warnings (non-blocking)\n  if (validation.warnings && validation.warnings.length > 0) {\n    for (const warning of validation.warnings) {\n      logger.warn(warning);\n    }\n  }\n\n  const servers = new Map<string, ServerProcess>();\n  const clients = new Set<ManagedClient>();\n  const sharedStdioClients = new Map<string, { client?: ManagedClient; connecting?: Promise<ManagedClient>; refs: number }>();\n\n  // Start each server in the configuration\n  for (const [name, entry] of Object.entries(serversConfig)) {\n    // Infer transport type from config\n    const transportType = inferTransportType(entry);\n\n    // Determine spawn behavior based on dialects\n    const spawnConfig = getSpawnConfig(entry, dialects, baseEnv);\n\n    // Check if we should spawn this server\n    if (!spawnConfig.shouldSpawn) {\n      // External server - just log, no spawn needed\n      if (entry.url) {\n        logger.info(`[${name}] external ${transportType} server (url: ${entry.url})`);\n      } else {\n        logger.warn(`[${name}] skipping: no spawn configuration (missing start or command) and no url for external server`);\n      }\n      continue;\n    }\n\n    try {\n      // Validate spawn config\n      if (!spawnConfig.command) {\n        throw new Error(`Server \"${name}\" missing command field`);\n      }\n\n      // All servers use the same working directory (cwd from options)\n      const resolvedCwd = cwd;\n\n      // Start the server\n      logger.info(`[${name}] starting ${transportType} server (${spawnConfig.command} ${(spawnConfig.args || []).join(' ')})`);\n\n      // stdio servers need 'pipe' for MCP communication over stdin/stdout\n      // network servers use 'inherit' so we see their logs\n      const stdio = transportType === 'stdio' ? 'pipe' : 'inherit';\n\n      const handle = spawnProcess({\n        name,\n        command: spawnConfig.command,\n        ...(spawnConfig.args !== undefined && { args: spawnConfig.args }),\n        cwd: resolvedCwd,\n        ...(spawnConfig.env && Object.keys(spawnConfig.env).length > 0 && { env: spawnConfig.env }),\n        stdio,\n      });\n\n      // Add server to registry (starting is fast, readiness is lazy)\n      servers.set(name, handle);\n      logger.info(`[${name}] started successfully`);\n    } catch (e) {\n      logger.info(`[${name}] start ERROR: ${e instanceof Error ? e.message : String(e)}`);\n    }\n  }\n\n  // Create connect function that tracks clients\n  const connect = async (name: string, options?: RegistryConnectOptions): Promise<ManagedClient> => {\n    const serverEntry = serversConfig[name];\n    if (!serverEntry) {\n      const available = Object.keys(serversConfig).join(', ');\n      throw new Error(`Server '${name}' not found in config. Available servers: ${available || 'none'}`);\n    }\n\n    const transportType = inferTransportType(serverEntry);\n\n    if (transportType === 'stdio') {\n      // Stdio is a single logical connection; reuse one client and lease references.\n      let entry = sharedStdioClients.get(name);\n      if (!entry) {\n        entry = { refs: 0 };\n        sharedStdioClients.set(name, entry);\n      }\n\n      if (!entry.client) {\n        if (!entry.connecting) {\n          entry.connecting = (async () => {\n            // Pass minimal RegistryLike object to connectMcpClient\n            const registryLike = { config: serversConfig, servers };\n            const rawClient = await connectMcpClient(registryLike, name, options);\n            const decorated = decorateClient(rawClient, { serverName: name });\n            entry.client = decorated;\n            entry.connecting = undefined;\n            return decorated;\n          })().catch((error) => {\n            sharedStdioClients.delete(name);\n            throw error;\n          });\n        }\n\n        await entry.connecting;\n      }\n\n      if (!entry.client) {\n        throw new Error(`Failed to connect to stdio server '${name}'`);\n      }\n\n      entry.refs += 1;\n      let released = false;\n      let lease: ManagedClient;\n\n      lease = new Proxy(entry.client, {\n        get(target, prop) {\n          if (prop === 'close') {\n            return async () => {\n              if (released) return;\n              released = true;\n              clients.delete(lease);\n              entry.refs = Math.max(0, entry.refs - 1);\n              if (entry.refs === 0) {\n                sharedStdioClients.delete(name);\n                await target.close();\n              }\n            };\n          }\n\n          const value = Reflect.get(target, prop, target) as unknown;\n          if (typeof value === 'function') {\n            return (value as (...args: unknown[]) => unknown).bind(target);\n          }\n          return value;\n        },\n      }) as ManagedClient;\n\n      clients.add(lease);\n      return lease;\n    }\n\n    // Pass minimal RegistryLike object to connectMcpClient\n    const registryLike = { config: serversConfig, servers };\n    const rawClient = await connectMcpClient(registryLike, name, options);\n    const decorated = decorateClient(rawClient, { serverName: name });\n    clients.add(decorated);\n    return decorated;\n  };\n\n  // Create close function that stops all clients and servers\n  const close = async (signal: NodeJS.Signals = 'SIGINT', opts: { timeoutMs?: number } = {}): Promise<CloseResult> => {\n    logger.info(`[registry] closing (${signal})`);\n\n    // First, close all tracked clients\n    const clientClosePromises = Array.from(clients).map(async (client) => {\n      try {\n        await client.close();\n      } catch {\n        // Ignore errors during client close\n      }\n    });\n    await Promise.all(clientClosePromises);\n    clients.clear();\n\n    // Then close all server processes\n    if (servers.size === 0) {\n      return { timedOut: false, killedCount: 0 };\n    }\n\n    // Close all servers in parallel\n    const closeResults = await Promise.all(Array.from(servers.values()).map((server) => server.close(signal, opts)));\n\n    // Check if any timed out and count how many were force-killed\n    const timedOut = closeResults.some((result) => result.timedOut);\n    const killedCount = closeResults.filter((result) => result.killed).length;\n\n    return { timedOut, killedCount };\n  };\n\n  const searchFromRegistry = async (query: string, options: SearchOptions = {}): Promise<SearchResponse> => {\n    const requestedServers = options.servers ?? Object.keys(serversConfig);\n    if (requestedServers.length === 0) {\n      throw new Error('Cannot search capabilities: registry has no configured servers');\n    }\n\n    const unknownServers = requestedServers.filter((name) => !(name in serversConfig));\n    if (unknownServers.length > 0) {\n      throw new Error(`Cannot search capabilities: unknown server(s) [${unknownServers.join(', ')}]`);\n    }\n\n    const capabilityClients = new Map<string, CapabilityClient>();\n    const failures: Array<{ server: string; reason: string }> = [];\n\n    const ensureClient = async (serverName: string): Promise<ManagedClient> => {\n      for (const client of clients) {\n        if (client.serverName === serverName) {\n          return client;\n        }\n      }\n      return connect(serverName);\n    };\n\n    await Promise.all(\n      requestedServers.map(async (serverName) => {\n        try {\n          const managed = await ensureClient(serverName);\n          capabilityClients.set(serverName, managed.nativeClient);\n        } catch (error) {\n          failures.push({\n            server: serverName,\n            reason: error instanceof Error ? error.message : String(error),\n          });\n        }\n      })\n    );\n\n    if (capabilityClients.size === 0) {\n      const failureDetails = failures.length > 0 ? ` Connection failures: ${failures.map((f) => `${f.server} (${f.reason})`).join('; ')}` : '';\n      throw new Error(`Cannot search capabilities: unable to connect to any requested servers.${failureDetails}`);\n    }\n\n    if (failures.length > 0) {\n      throw new Error(`Cannot search capabilities: failed to connect to server(s) [${failures.map((f) => f.server).join(', ')}]. Reasons: ${failures.map((f) => `${f.server}: ${f.reason}`).join('; ')}`);\n    }\n\n    const index = await buildCapabilityIndex(capabilityClients);\n    return executeCapabilitySearch(index, query, options);\n  };\n\n  // Async dispose for `await using` pattern\n  const asyncDispose = async (): Promise<void> => {\n    await close();\n  };\n\n  return {\n    config: serversConfig,\n    servers,\n    clients,\n    connect,\n    close,\n    searchCapabilities: searchFromRegistry,\n    [Symbol.asyncDispose]: asyncDispose,\n  };\n}\n"],"names":["createServerRegistry","inferTransportType","config","type","url","URL","protocol","filterEnv","env","filtered","Object","entries","key","value","undefined","getSpawnConfig","entry","dialects","baseEnv","transportType","hasServers","includes","hasStart","command","shouldSpawn","args","start","serversConfig","options","cwd","process","fs","existsSync","Error","validation","validateServers","valid","errors","join","warnings","length","warning","logger","warn","servers","Map","clients","Set","sharedStdioClients","name","spawnConfig","info","resolvedCwd","stdio","handle","spawnProcess","keys","set","e","message","String","connect","serverEntry","available","released","lease","registryLike","rawClient","decorated","get","refs","client","connecting","connectMcpClient","decorateClient","serverName","catch","error","delete","Proxy","target","prop","Math","max","close","Reflect","bind","add","signal","opts","clientClosePromises","closeResults","timedOut","killedCount","Array","from","map","Promise","all","clear","size","values","server","some","result","filter","killed","searchFromRegistry","query","requestedServers","unknownServers","capabilityClients","failures","ensureClient","failureDetails","index","managed","nativeClient","push","reason","f","buildCapabilityIndex","executeCapabilitySearch","asyncDispose","searchCapabilities","Symbol"],"mappings":"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"}

package/dist/cjs/types.d.cts

@@ -0,0 +1,11 @@
+/**
+ * MCP Configuration Types
+ *
+ * Auto-generated from schemas/servers.schema.json
+ */
+export type { MCPServers, McpServerEntry, StartConfig } from '../schemas/servers.d.js';
+/**
+ * Transport type for server configuration
+ * Standard MCP transport types matching Claude Code's schemas
+ */
+export type TransportType = 'stdio' | 'http' | 'sse-ide' | 'ws-ide' | 'sdk';

package/dist/cjs/types.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MCP Configuration Types
+ *
+ * Auto-generated from schemas/servers.schema.json
+ */
+export type { MCPServers, McpServerEntry, StartConfig } from '../schemas/servers.d.js';
+/**
+ * Transport type for server configuration
+ * Standard MCP transport types matching Claude Code's schemas
+ */
+export type TransportType = 'stdio' | 'http' | 'sse-ide' | 'ws-ide' | 'sdk';

package/dist/cjs/types.js

@@ -0,0 +1,10 @@
+/**
+ * MCP Configuration Types
+ *
+ * Auto-generated from schemas/servers.schema.json
+ */ // Re-export all generated types
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+/* 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/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/libs/client/src/types.ts"],"sourcesContent":["/**\n * MCP Configuration Types\n *\n * Auto-generated from schemas/servers.schema.json\n */\n\n// Re-export all generated types\nexport type { MCPServers, McpServerEntry, StartConfig } from '../schemas/servers.d.ts';\n\n/**\n * Transport type for server configuration\n * Standard MCP transport types matching Claude Code's schemas\n */\nexport type TransportType = 'stdio' | 'http' | 'sse-ide' | 'ws-ide' | 'sdk';\n"],"names":[],"mappings":"AAAA;;;;CAIC,GAED,gCAAgC"}

package/dist/cjs/utils/logger.d.cts

@@ -0,0 +1,24 @@
+/**
+ * Sanitized logger with log level filtering
+ * Provides credential redaction and verbosity control for all log output
+ */
+/**
+ * Log level for filtering output
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+/**
+ * Logger interface - subset of Console
+ */
+export type Logger = Pick<Console, 'info' | 'error' | 'warn' | 'debug'>;
+/**
+ * Set the global log level
+ * Users can call this to control library verbosity
+ *
+ * @param level - Log level: 'debug' (all), 'info', 'warn', 'error', 'silent' (none)
+ */
+export declare function setLogLevel(level: LogLevel): void;
+/**
+ * Get current log level
+ */
+export declare function getLogLevel(): LogLevel;
+export declare const logger: Logger;

package/dist/cjs/utils/logger.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Sanitized logger with log level filtering
+ * Provides credential redaction and verbosity control for all log output
+ */
+/**
+ * Log level for filtering output
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+/**
+ * Logger interface - subset of Console
+ */
+export type Logger = Pick<Console, 'info' | 'error' | 'warn' | 'debug'>;
+/**
+ * Set the global log level
+ * Users can call this to control library verbosity
+ *
+ * @param level - Log level: 'debug' (all), 'info', 'warn', 'error', 'silent' (none)
+ */
+export declare function setLogLevel(level: LogLevel): void;
+/**
+ * Get current log level
+ */
+export declare function getLogLevel(): LogLevel;
+export declare const logger: Logger;

package/dist/cjs/utils/logger.js

@@ -0,0 +1,80 @@
+/**
+ * Sanitized logger with log level filtering
+ * Provides credential redaction and verbosity control for all log output
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get getLogLevel () {
+        return getLogLevel;
+    },
+    get logger () {
+        return logger;
+    },
+    get setLogLevel () {
+        return setLogLevel;
+    }
+});
+var _sanitizerts = require("./sanitizer.js");
+function _type_of(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+// Log level hierarchy (higher number = more important)
+var levels = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4
+};
+// Default to 'warn' - quiet library, only show warnings and errors
+var currentLevel = process.env.LOG_LEVEL || 'warn';
+/**
+ * Check if a log should be output based on current level
+ */ function shouldLog(level) {
+    return levels[level] >= levels[currentLevel];
+}
+function setLogLevel(level) {
+    currentLevel = level;
+}
+function getLogLevel() {
+    return currentLevel;
+}
+/**
+ * Create a sanitized logger with log level filtering
+ */ function createSanitizedLogger() {
+    var createLogMethod = function(consoleMethod) {
+        return function(message) {
+            for(var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++){
+                args[_key - 1] = arguments[_key];
+            }
+            // Check if this log level should be output
+            if (!shouldLog(consoleMethod)) {
+                return;
+            }
+            var metadata = args.length > 0 && _type_of(args[0]) === 'object' ? args[0] : {};
+            var _sanitizeForLogging = (0, _sanitizerts.sanitizeForLogging)(message, metadata), clean = _sanitizeForLogging.message, cleanMeta = _sanitizeForLogging.meta;
+            if (Object.keys(cleanMeta).length > 0) {
+                console[consoleMethod](clean, cleanMeta);
+            } else {
+                console[consoleMethod](clean);
+            }
+        };
+    };
+    return {
+        info: createLogMethod('info'),
+        warn: createLogMethod('warn'),
+        error: createLogMethod('error'),
+        debug: createLogMethod('debug')
+    };
+}
+var logger = createSanitizedLogger();
+/* 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/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/libs/client/src/utils/logger.ts"],"sourcesContent":["/**\n * Sanitized logger with log level filtering\n * Provides credential redaction and verbosity control for all log output\n */\n\nimport type { SpawnMetadata } from '../connection/types.ts';\nimport { sanitizeForLogging } from './sanitizer.ts';\n\n/**\n * Log level for filtering output\n */\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';\n\n/**\n * Logger interface - subset of Console\n */\nexport type Logger = Pick<Console, 'info' | 'error' | 'warn' | 'debug'>;\n\n// Log level hierarchy (higher number = more important)\nconst levels: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n  silent: 4,\n};\n\n// Default to 'warn' - quiet library, only show warnings and errors\nlet currentLevel: LogLevel = (process.env.LOG_LEVEL as LogLevel) || 'warn';\n\n/**\n * Check if a log should be output based on current level\n */\nfunction shouldLog(level: keyof Omit<typeof levels, 'silent'>): boolean {\n  return levels[level] >= levels[currentLevel];\n}\n\n/**\n * Set the global log level\n * Users can call this to control library verbosity\n *\n * @param level - Log level: 'debug' (all), 'info', 'warn', 'error', 'silent' (none)\n */\nexport function setLogLevel(level: LogLevel): void {\n  currentLevel = level;\n}\n\n/**\n * Get current log level\n */\nexport function getLogLevel(): LogLevel {\n  return currentLevel;\n}\n\n/**\n * Create a sanitized logger with log level filtering\n */\nfunction createSanitizedLogger(): Logger {\n  const createLogMethod = (consoleMethod: 'info' | 'warn' | 'error' | 'debug') => {\n    return (message: string, ...args: unknown[]) => {\n      // Check if this log level should be output\n      if (!shouldLog(consoleMethod)) {\n        return;\n      }\n\n      const metadata = args.length > 0 && typeof args[0] === 'object' ? (args[0] as SpawnMetadata) : {};\n      const { message: clean, meta: cleanMeta } = sanitizeForLogging(message, metadata);\n      if (Object.keys(cleanMeta).length > 0) {\n        console[consoleMethod](clean, cleanMeta);\n      } else {\n        console[consoleMethod](clean);\n      }\n    };\n  };\n\n  return {\n    info: createLogMethod('info'),\n    warn: createLogMethod('warn'),\n    error: createLogMethod('error'),\n    debug: createLogMethod('debug'),\n  };\n}\n\n// Singleton instance - shared across all operations\nexport const logger = createSanitizedLogger();\n"],"names":["getLogLevel","logger","setLogLevel","levels","debug","info","warn","error","silent","currentLevel","process","env","LOG_LEVEL","shouldLog","level","createSanitizedLogger","createLogMethod","consoleMethod","message","args","metadata","length","sanitizeForLogging","clean","meta","cleanMeta","Object","keys","console"],"mappings":"AAAA;;;CAGC;;;;;;;;;;;QA+CeA;eAAAA;;QAkCHC;eAAAA;;QAzCGC;eAAAA;;;2BArCmB;;;;;AAYnC,uDAAuD;AACvD,IAAMC,SAAmC;IACvCC,OAAO;IACPC,MAAM;IACNC,MAAM;IACNC,OAAO;IACPC,QAAQ;AACV;AAEA,mEAAmE;AACnE,IAAIC,eAAyB,AAACC,QAAQC,GAAG,CAACC,SAAS,IAAiB;AAEpE;;CAEC,GACD,SAASC,UAAUC,KAA0C;IAC3D,OAAOX,MAAM,CAACW,MAAM,IAAIX,MAAM,CAACM,aAAa;AAC9C;AAQO,SAASP,YAAYY,KAAe;IACzCL,eAAeK;AACjB;AAKO,SAASd;IACd,OAAOS;AACT;AAEA;;CAEC,GACD,SAASM;IACP,IAAMC,kBAAkB,SAACC;QACvB,OAAO,SAACC;6CAAoBC;gBAAAA;;YAC1B,2CAA2C;YAC3C,IAAI,CAACN,UAAUI,gBAAgB;gBAC7B;YACF;YAEA,IAAMG,WAAWD,KAAKE,MAAM,GAAG,KAAK,SAAOF,IAAI,CAAC,EAAE,MAAK,WAAYA,IAAI,CAAC,EAAE,GAAqB,CAAC;YAChG,IAA4CG,sBAAAA,IAAAA,+BAAkB,EAACJ,SAASE,WAAhEF,AAASK,QAA2BD,oBAApCJ,SAAgBM,AAAMC,YAAcH,oBAApBE;YACxB,IAAIE,OAAOC,IAAI,CAACF,WAAWJ,MAAM,GAAG,GAAG;gBACrCO,OAAO,CAACX,cAAc,CAACM,OAAOE;YAChC,OAAO;gBACLG,OAAO,CAACX,cAAc,CAACM;YACzB;QACF;IACF;IAEA,OAAO;QACLlB,MAAMW,gBAAgB;QACtBV,MAAMU,gBAAgB;QACtBT,OAAOS,gBAAgB;QACvBZ,OAAOY,gBAAgB;IACzB;AACF;AAGO,IAAMf,SAASc"}

package/dist/cjs/utils/path-utils.d.cts

@@ -0,0 +1,45 @@
+/**
+ * Path resolution utilities for cluster spawning.
+ * Handles ~, relative paths, absolute paths, and special cases (URLs, npm packages, flags).
+ */
+/**
+ * Resolve a file path relative to a working directory.
+ *
+ * Handles three cases:
+ * - `~` or `~/path` - Expands to home directory
+ * - Absolute paths - Returns as-is
+ * - Relative paths - Resolves relative to cwd
+ *
+ * @param filePath - The path to resolve
+ * @param cwd - The working directory for resolving relative paths
+ * @returns The resolved absolute path
+ *
+ * @example
+ * resolvePath('~/config.json', '/unused')  // → '/home/user/config.json'
+ * resolvePath('/absolute/path', '/unused') // → '/absolute/path'
+ * resolvePath('./relative', '/base')       // → '/base/relative'
+ */
+export declare function resolvePath(filePath: string, cwd: string): string;
+/**
+ * Resolve paths in command arguments array.
+ *
+ * Intelligently handles different argument types:
+ * - Flags with paths: `--env-file=./path` → `--env-file=/absolute/path`
+ * - Flags without paths: `--port=3000` → unchanged
+ * - Command flags: `--verbose` → unchanged
+ * - URLs: `http://example.com` → unchanged
+ * - npm packages: `@scope/package` or `package-name` → unchanged
+ * - Regular paths: `./script.js` → `/absolute/script.js`
+ *
+ * @param args - Array of command arguments
+ * @param cwd - Working directory for resolving relative paths
+ * @returns Array with paths resolved
+ *
+ * @example
+ * resolveArgsPaths(['./bin/server.js', '--env-file=./config.env', '--port=3000'], '/home/user')
+ * // → ['/home/user/bin/server.js', '--env-file=/home/user/config.env', '--port=3000']
+ *
+ * resolveArgsPaths(['@scope/package', 'https://example.com'], '/unused')
+ * // → ['@scope/package', 'https://example.com'] (unchanged)
+ */
+export declare function resolveArgsPaths(args: string[], cwd: string): string[];

package/dist/cjs/utils/path-utils.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Path resolution utilities for cluster spawning.
+ * Handles ~, relative paths, absolute paths, and special cases (URLs, npm packages, flags).
+ */
+/**
+ * Resolve a file path relative to a working directory.
+ *
+ * Handles three cases:
+ * - `~` or `~/path` - Expands to home directory
+ * - Absolute paths - Returns as-is
+ * - Relative paths - Resolves relative to cwd
+ *
+ * @param filePath - The path to resolve
+ * @param cwd - The working directory for resolving relative paths
+ * @returns The resolved absolute path
+ *
+ * @example
+ * resolvePath('~/config.json', '/unused')  // → '/home/user/config.json'
+ * resolvePath('/absolute/path', '/unused') // → '/absolute/path'
+ * resolvePath('./relative', '/base')       // → '/base/relative'
+ */
+export declare function resolvePath(filePath: string, cwd: string): string;
+/**
+ * Resolve paths in command arguments array.
+ *
+ * Intelligently handles different argument types:
+ * - Flags with paths: `--env-file=./path` → `--env-file=/absolute/path`
+ * - Flags without paths: `--port=3000` → unchanged
+ * - Command flags: `--verbose` → unchanged
+ * - URLs: `http://example.com` → unchanged
+ * - npm packages: `@scope/package` or `package-name` → unchanged
+ * - Regular paths: `./script.js` → `/absolute/script.js`
+ *
+ * @param args - Array of command arguments
+ * @param cwd - Working directory for resolving relative paths
+ * @returns Array with paths resolved
+ *
+ * @example
+ * resolveArgsPaths(['./bin/server.js', '--env-file=./config.env', '--port=3000'], '/home/user')
+ * // → ['/home/user/bin/server.js', '--env-file=/home/user/config.env', '--port=3000']
+ *
+ * resolveArgsPaths(['@scope/package', 'https://example.com'], '/unused')
+ * // → ['@scope/package', 'https://example.com'] (unchanged)
+ */
+export declare function resolveArgsPaths(args: string[], cwd: string): string[];

package/dist/cjs/utils/path-utils.js

@@ -0,0 +1,158 @@
+/**
+ * Path resolution utilities for cluster spawning.
+ * Handles ~, relative paths, absolute paths, and special cases (URLs, npm packages, flags).
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get resolveArgsPaths () {
+        return resolveArgsPaths;
+    },
+    get resolvePath () {
+        return resolvePath;
+    }
+});
+var _os = /*#__PURE__*/ _interop_require_wildcard(require("os"));
+var _path = /*#__PURE__*/ _interop_require_wildcard(require("path"));
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_with_holes(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+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;
+}
+function _iterable_to_array_limit(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+function resolvePath(filePath, cwd) {
+    // Expand ~ to home directory
+    if (filePath === '~' || filePath.startsWith('~/')) {
+        filePath = filePath.replace(/^~/, _os.homedir());
+    }
+    // If absolute, return as-is
+    if (_path.isAbsolute(filePath)) {
+        return filePath;
+    }
+    // Otherwise resolve relative to cwd
+    return _path.resolve(cwd, filePath);
+}
+function resolveArgsPaths(args, cwd) {
+    return args.map(function(arg) {
+        if (typeof arg !== 'string') {
+            return arg;
+        }
+        // Check for flags with path values like --env-file=path, --config=path, etc.
+        var flagMatch = arg.match(/^(--.+?)=(.+)$/);
+        if (flagMatch) {
+            var _flagMatch = _sliced_to_array(flagMatch, 3), flag = _flagMatch[1], value = _flagMatch[2];
+            // Only resolve if the value looks like a path (contains ./ or ../ or / )
+            if (value && value.includes('/')) {
+                // Skip URLs in flag values
+                if (/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(value)) {
+                    return arg;
+                }
+                return "".concat(flag, "=").concat(resolvePath(value, cwd));
+            }
+            return arg; // Return as-is for non-path flag values like --port=3000
+        }
+        // Skip command-line flags, only resolve actual paths
+        if (arg.startsWith('-')) {
+            return arg; // Don't resolve command-line flags as paths
+        }
+        // Skip URLs (http://, https://, etc.)
+        if (/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(arg)) {
+            return arg; // Return URLs as-is
+        }
+        // Skip npm package names (starting with @ or containing no path separators)
+        if (arg.startsWith('@') || !arg.includes('/') && !arg.includes('\\')) {
+            return arg; // Return npm package names as-is
+        }
+        // Regular arguments get resolved as paths
+        return resolvePath(arg, cwd);
+    });
+}
+/* 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/utils/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/libs/client/src/utils/path-utils.ts"],"sourcesContent":["/**\n * Path resolution utilities for cluster spawning.\n * Handles ~, relative paths, absolute paths, and special cases (URLs, npm packages, flags).\n */\n\nimport * as os from 'os';\nimport * as path from 'path';\n\n/**\n * Resolve a file path relative to a working directory.\n *\n * Handles three cases:\n * - `~` or `~/path` - Expands to home directory\n * - Absolute paths - Returns as-is\n * - Relative paths - Resolves relative to cwd\n *\n * @param filePath - The path to resolve\n * @param cwd - The working directory for resolving relative paths\n * @returns The resolved absolute path\n *\n * @example\n * resolvePath('~/config.json', '/unused')  // → '/home/user/config.json'\n * resolvePath('/absolute/path', '/unused') // → '/absolute/path'\n * resolvePath('./relative', '/base')       // → '/base/relative'\n */\nexport function resolvePath(filePath: string, cwd: string): string {\n  // Expand ~ to home directory\n  if (filePath === '~' || filePath.startsWith('~/')) {\n    filePath = filePath.replace(/^~/, os.homedir());\n  }\n\n  // If absolute, return as-is\n  if (path.isAbsolute(filePath)) {\n    return filePath;\n  }\n\n  // Otherwise resolve relative to cwd\n  return path.resolve(cwd, filePath);\n}\n\n/**\n * Resolve paths in command arguments array.\n *\n * Intelligently handles different argument types:\n * - Flags with paths: `--env-file=./path` → `--env-file=/absolute/path`\n * - Flags without paths: `--port=3000` → unchanged\n * - Command flags: `--verbose` → unchanged\n * - URLs: `http://example.com` → unchanged\n * - npm packages: `@scope/package` or `package-name` → unchanged\n * - Regular paths: `./script.js` → `/absolute/script.js`\n *\n * @param args - Array of command arguments\n * @param cwd - Working directory for resolving relative paths\n * @returns Array with paths resolved\n *\n * @example\n * resolveArgsPaths(['./bin/server.js', '--env-file=./config.env', '--port=3000'], '/home/user')\n * // → ['/home/user/bin/server.js', '--env-file=/home/user/config.env', '--port=3000']\n *\n * resolveArgsPaths(['@scope/package', 'https://example.com'], '/unused')\n * // → ['@scope/package', 'https://example.com'] (unchanged)\n */\nexport function resolveArgsPaths(args: string[], cwd: string): string[] {\n  return args.map((arg) => {\n    if (typeof arg !== 'string') {\n      return arg;\n    }\n\n    // Check for flags with path values like --env-file=path, --config=path, etc.\n    const flagMatch = arg.match(/^(--.+?)=(.+)$/);\n    if (flagMatch) {\n      const [, flag, value] = flagMatch;\n      // Only resolve if the value looks like a path (contains ./ or ../ or / )\n      if (value && value.includes('/')) {\n        // Skip URLs in flag values\n        if (/^[a-zA-Z][a-zA-Z0-9+.-]*:\\/\\//.test(value)) {\n          return arg;\n        }\n        return `${flag}=${resolvePath(value, cwd)}`;\n      }\n      return arg; // Return as-is for non-path flag values like --port=3000\n    }\n\n    // Skip command-line flags, only resolve actual paths\n    if (arg.startsWith('-')) {\n      return arg; // Don't resolve command-line flags as paths\n    }\n\n    // Skip URLs (http://, https://, etc.)\n    if (/^[a-zA-Z][a-zA-Z0-9+.-]*:\\/\\//.test(arg)) {\n      return arg; // Return URLs as-is\n    }\n\n    // Skip npm package names (starting with @ or containing no path separators)\n    if (arg.startsWith('@') || (!arg.includes('/') && !arg.includes('\\\\'))) {\n      return arg; // Return npm package names as-is\n    }\n\n    // Regular arguments get resolved as paths\n    return resolvePath(arg, cwd);\n  });\n}\n"],"names":["resolveArgsPaths","resolvePath","filePath","cwd","startsWith","replace","os","homedir","path","isAbsolute","resolve","args","map","arg","flagMatch","match","flag","value","includes","test"],"mappings":"AAAA;;;CAGC;;;;;;;;;;;QA2DeA;eAAAA;;QArCAC;eAAAA;;;0DApBI;4DACE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmBf,SAASA,YAAYC,QAAgB,EAAEC,GAAW;IACvD,6BAA6B;IAC7B,IAAID,aAAa,OAAOA,SAASE,UAAU,CAAC,OAAO;QACjDF,WAAWA,SAASG,OAAO,CAAC,MAAMC,IAAGC,OAAO;IAC9C;IAEA,4BAA4B;IAC5B,IAAIC,MAAKC,UAAU,CAACP,WAAW;QAC7B,OAAOA;IACT;IAEA,oCAAoC;IACpC,OAAOM,MAAKE,OAAO,CAACP,KAAKD;AAC3B;AAwBO,SAASF,iBAAiBW,IAAc,EAAER,GAAW;IAC1D,OAAOQ,KAAKC,GAAG,CAAC,SAACC;QACf,IAAI,OAAOA,QAAQ,UAAU;YAC3B,OAAOA;QACT;QAEA,6EAA6E;QAC7E,IAAMC,YAAYD,IAAIE,KAAK,CAAC;QAC5B,IAAID,WAAW;YACb,IAAwBA,8BAAAA,eAAfE,OAAeF,eAATG,QAASH;YACxB,yEAAyE;YACzE,IAAIG,SAASA,MAAMC,QAAQ,CAAC,MAAM;gBAChC,2BAA2B;gBAC3B,IAAI,gCAAgCC,IAAI,CAACF,QAAQ;oBAC/C,OAAOJ;gBACT;gBACA,OAAO,AAAC,GAAUZ,OAARe,MAAK,KAA2B,OAAxBf,YAAYgB,OAAOd;YACvC;YACA,OAAOU,KAAK,yDAAyD;QACvE;QAEA,qDAAqD;QACrD,IAAIA,IAAIT,UAAU,CAAC,MAAM;YACvB,OAAOS,KAAK,4CAA4C;QAC1D;QAEA,sCAAsC;QACtC,IAAI,gCAAgCM,IAAI,CAACN,MAAM;YAC7C,OAAOA,KAAK,oBAAoB;QAClC;QAEA,4EAA4E;QAC5E,IAAIA,IAAIT,UAAU,CAAC,QAAS,CAACS,IAAIK,QAAQ,CAAC,QAAQ,CAACL,IAAIK,QAAQ,CAAC,OAAQ;YACtE,OAAOL,KAAK,iCAAiC;QAC/C;QAEA,0CAA0C;QAC1C,OAAOZ,YAAYY,KAAKV;IAC1B;AACF"}

package/dist/cjs/utils/sanitizer.d.cts

@@ -0,0 +1,30 @@
+/**
+ * Minimal log sanitization for spawn operations
+ * Redacts credentials from environment variables and command arguments
+ */
+import type { SpawnMetadata } from '../connection/types.js';
+/**
+ * Sanitize log messages and metadata to prevent credential leakage
+ *
+ * Redacts common credential patterns:
+ * - key=value, secret=value, token=value, password=value
+ * - Environment variables with sensitive names
+ *
+ * @param message - Log message to sanitize
+ * @param obj - Metadata object to sanitize
+ * @returns Sanitized message and metadata
+ */
+export declare function sanitizeForLogging(message: string, obj: SpawnMetadata): {
+    message: string;
+    meta: SpawnMetadata;
+};
+export declare function sanitizeForLoggingFormatter(): {
+    log: (obj: SpawnMetadata) => {
+        msg: string;
+        command?: string;
+        args?: string[];
+        env?: Record<string, string>;
+        cwd?: string;
+        pid?: number;
+    };
+};

package/dist/cjs/utils/sanitizer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Minimal log sanitization for spawn operations
+ * Redacts credentials from environment variables and command arguments
+ */
+import type { SpawnMetadata } from '../connection/types.js';
+/**
+ * Sanitize log messages and metadata to prevent credential leakage
+ *
+ * Redacts common credential patterns:
+ * - key=value, secret=value, token=value, password=value
+ * - Environment variables with sensitive names
+ *
+ * @param message - Log message to sanitize
+ * @param obj - Metadata object to sanitize
+ * @returns Sanitized message and metadata
+ */
+export declare function sanitizeForLogging(message: string, obj: SpawnMetadata): {
+    message: string;
+    meta: SpawnMetadata;
+};
+export declare function sanitizeForLoggingFormatter(): {
+    log: (obj: SpawnMetadata) => {
+        msg: string;
+        command?: string;
+        args?: string[];
+        env?: Record<string, string>;
+        cwd?: string;
+        pid?: number;
+    };
+};