@mcp-z/client 1.0.7 → 1.0.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cjs/auth/capability-discovery.js +2 -5
- package/dist/cjs/auth/capability-discovery.js.map +1 -1
- package/dist/cjs/auth/index.js.map +1 -1
- package/dist/cjs/auth/interactive-oauth-flow.js +13 -30
- package/dist/cjs/auth/interactive-oauth-flow.js.map +1 -1
- package/dist/cjs/auth/oauth-callback-listener.js +3 -8
- package/dist/cjs/auth/oauth-callback-listener.js.map +1 -1
- package/dist/cjs/auth/pkce.js +2 -5
- package/dist/cjs/auth/pkce.js.map +1 -1
- package/dist/cjs/auth/rfc9728-discovery.js +2 -5
- package/dist/cjs/auth/rfc9728-discovery.js.map +1 -1
- package/dist/cjs/auth/types.js.map +1 -1
- package/dist/cjs/client-helpers.js +4 -6
- package/dist/cjs/client-helpers.js.map +1 -1
- package/dist/cjs/config/server-loader.js +8 -19
- package/dist/cjs/config/server-loader.js.map +1 -1
- package/dist/cjs/config/validate-config.js +8 -19
- package/dist/cjs/config/validate-config.js.map +1 -1
- package/dist/cjs/connection/connect-client.js +5 -11
- package/dist/cjs/connection/connect-client.js.map +1 -1
- package/dist/cjs/connection/existing-process-transport.js +3 -8
- package/dist/cjs/connection/existing-process-transport.js.map +1 -1
- package/dist/cjs/connection/types.d.cts +1 -1
- package/dist/cjs/connection/types.d.ts +1 -1
- package/dist/cjs/connection/types.js.map +1 -1
- package/dist/cjs/connection/wait-for-http-ready.js +2 -5
- package/dist/cjs/connection/wait-for-http-ready.js.map +1 -1
- package/dist/cjs/constants.js.map +1 -1
- package/dist/cjs/dcr/dcr-authenticator.js +13 -30
- package/dist/cjs/dcr/dcr-authenticator.js.map +1 -1
- package/dist/cjs/dcr/dynamic-client-registrar.js +3 -8
- package/dist/cjs/dcr/dynamic-client-registrar.js.map +1 -1
- package/dist/cjs/dcr/index.js.map +1 -1
- package/dist/cjs/index.js.map +1 -1
- package/dist/cjs/lib/url-utils.js.map +1 -1
- package/dist/cjs/monkey-patches.js +11 -14
- package/dist/cjs/monkey-patches.js.map +1 -1
- package/dist/cjs/response-wrappers.js +24 -31
- package/dist/cjs/response-wrappers.js.map +1 -1
- package/dist/cjs/search/index.js.map +1 -1
- package/dist/cjs/search/search.js +15 -18
- package/dist/cjs/search/search.js.map +1 -1
- package/dist/cjs/search/types.js.map +1 -1
- package/dist/cjs/spawn/spawn-server.js +22 -38
- package/dist/cjs/spawn/spawn-server.js.map +1 -1
- package/dist/cjs/spawn/spawn-servers.js +29 -47
- package/dist/cjs/spawn/spawn-servers.js.map +1 -1
- package/dist/cjs/types.js.map +1 -1
- package/dist/cjs/utils/logger.js +1 -1
- package/dist/cjs/utils/logger.js.map +1 -1
- package/dist/cjs/utils/path-utils.js +9 -20
- package/dist/cjs/utils/path-utils.js.map +1 -1
- package/dist/cjs/utils/sanitizer.js +4 -7
- package/dist/cjs/utils/sanitizer.js.map +1 -1
- package/dist/esm/auth/capability-discovery.js.map +1 -1
- package/dist/esm/auth/index.js.map +1 -1
- package/dist/esm/auth/interactive-oauth-flow.js.map +1 -1
- package/dist/esm/auth/oauth-callback-listener.js.map +1 -1
- package/dist/esm/auth/pkce.js.map +1 -1
- package/dist/esm/auth/rfc9728-discovery.js.map +1 -1
- package/dist/esm/auth/types.js.map +1 -1
- package/dist/esm/client-helpers.js.map +1 -1
- package/dist/esm/config/server-loader.js.map +1 -1
- package/dist/esm/config/validate-config.js.map +1 -1
- package/dist/esm/connection/connect-client.js.map +1 -1
- package/dist/esm/connection/existing-process-transport.js.map +1 -1
- package/dist/esm/connection/types.d.ts +1 -1
- package/dist/esm/connection/types.js.map +1 -1
- package/dist/esm/connection/wait-for-http-ready.js.map +1 -1
- package/dist/esm/constants.js.map +1 -1
- package/dist/esm/dcr/dcr-authenticator.js.map +1 -1
- package/dist/esm/dcr/dynamic-client-registrar.js.map +1 -1
- package/dist/esm/dcr/index.js.map +1 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/lib/url-utils.js.map +1 -1
- package/dist/esm/monkey-patches.js.map +1 -1
- package/dist/esm/response-wrappers.js +6 -3
- package/dist/esm/response-wrappers.js.map +1 -1
- package/dist/esm/search/index.js.map +1 -1
- package/dist/esm/search/search.js.map +1 -1
- package/dist/esm/search/types.js.map +1 -1
- package/dist/esm/spawn/spawn-server.js.map +1 -1
- package/dist/esm/spawn/spawn-servers.js.map +1 -1
- package/dist/esm/types.js.map +1 -1
- package/dist/esm/utils/logger.js.map +1 -1
- package/dist/esm/utils/path-utils.js.map +1 -1
- package/dist/esm/utils/sanitizer.js.map +1 -1
- package/package.json +9 -3
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/client/src/spawn/spawn-server.ts"],"sourcesContent":["/**\n * Low-level single server spawning utilities.\n * Provides core process spawning with path resolution, environment management, and lifecycle control.\n */\n\nimport { type ChildProcess, type SpawnOptions, type StdioOptions, spawn } from 'child_process';\nimport * as process from 'process';\nimport { logger } from '../utils/logger.ts';\nimport { resolveArgsPaths } from '../utils/path-utils.ts';\n\n/**\n * Options for spawning a single server process.\n * @internal\n */\nexport interface SpawnProcessOptions {\n /** Server name for logging */\n name: string;\n /** Command to execute (e.g., 'node', 'npx') */\n command: string;\n /** Command arguments (paths will be resolved relative to cwd) */\n args?: string[];\n /** Working directory (must be absolute path) */\n cwd?: string;\n /** Additional environment variables (merged with process.env) */\n env?: Record<string, string>;\n /** Standard I/O configuration */\n stdio?: StdioOptions;\n /** Use shell for command execution (default: false, true on Windows) */\n shell?: boolean;\n}\n\n/**\n * Handle to a spawned server process.\n * Provides access to the process, resolved config, and lifecycle control.\n * @hidden\n */\nexport interface ServerProcess {\n /**\n * The resolved server configuration that was actually used.\n * Useful for debugging and understanding what was spawned.\n */\n config: {\n name: string;\n command: string;\n args: string[];\n cwd: string;\n env: Record<string, string>;\n stdio: StdioOptions;\n shell: boolean;\n };\n\n /**\n * The spawned child process.\n */\n process: ChildProcess;\n\n /**\n * Close the server gracefully.\n * Sends the specified signal (default: SIGINT), then SIGKILL after timeout.\n *\n * @param signal - Signal to send (default: SIGINT)\n * @param opts - Options including timeout\n * @returns Promise resolving to whether the process timed out and was force-killed\n */\n close: (signal?: NodeJS.Signals, opts?: { timeoutMs?: number }) => Promise<{ timedOut: boolean; killed: boolean }>;\n}\n\n/**\n * Normalize environment variables by merging with process.env and filtering undefined values.\n */\nfunction normalizeEnv(env?: Record<string, string>): Record<string, string> {\n const merged = { ...process.env, ...(env || {}) };\n const result: Record<string, string> = {};\n for (const [key, value] of Object.entries(merged)) {\n if (value !== undefined) {\n result[key] = value;\n }\n }\n return result;\n}\n\n/**\n * Spawn a single server process with path resolution and environment management.\n *\n * @internal\n * @param opts - Server spawn options\n * @returns ServerProcess handle with resolved config, process, and stop function\n *\n * @example\n * const handle = spawnProcess({\n * name: 'echo',\n * command: 'node',\n * args: ['./bin/server.js', '--port', '3000'],\n * cwd: '/home/user/project/test/lib/servers/echo',\n * env: { LOG_LEVEL: 'error' }\n * });\n *\n * // Later...\n * await handle.close();\n */\nexport function spawnProcess(opts: SpawnProcessOptions): ServerProcess {\n const name = opts.name;\n const command = opts.command;\n const cwd = opts.cwd ?? process.cwd();\n const stdio = opts.stdio ?? 'inherit';\n const shell = opts.shell ?? process.platform === 'win32';\n\n // Resolve paths in args relative to the working directory\n const args = opts.args ? resolveArgsPaths(opts.args, cwd) : [];\n\n // Merge environment variables\n const env = normalizeEnv(opts.env);\n\n // Create resolved config for return value\n const resolvedConfig = {\n name,\n command,\n args,\n cwd,\n env,\n stdio,\n shell,\n };\n\n // Log spawn operation\n logger.info(`[${name}] → ${command} ${args.join(' ')}`);\n\n // Spawn the process\n const spawnOpts: SpawnOptions = { cwd, env, stdio, shell };\n const child = spawn(command, args, spawnOpts);\n\n // Pipe stdio if not inherited\n if (child.stderr)\n child.stderr.on('data', (chunk) => {\n process.stderr.write(chunk);\n });\n\n // Attach lifecycle logging\n child.on('exit', (code, sig) => logger.info(`[${name}] exited (code=${code}, signal=${sig || 'none'})`));\n child.on('error', (err) => logger.info(`[${name}] process error: ${err.message}`));\n\n // Create stop function with graceful shutdown\n const stop = async (signal: NodeJS.Signals = 'SIGINT', opts: { timeoutMs?: number } = {}): Promise<{ timedOut: boolean; killed: boolean }> => {\n // If already exited, return immediately\n if (child.exitCode !== null || child.signalCode !== null) {\n return { timedOut: false, killed: false };\n }\n\n const timeoutMs = opts.timeoutMs ?? 500;\n\n // Wait for 'close' event (process exit + stdio streams closed)\n // This is better than 'exit' because it ensures stdio is fully cleaned up\n const closePromise = new Promise<{ timedOut: boolean; killed: boolean }>((resolve) => {\n let isResolved = false;\n let wasKilled = false;\n\n const resolveOnce = (timedOut: boolean) => {\n if (isResolved) return;\n isResolved = true;\n clearTimeout(timeout);\n resolve({ timedOut, killed: wasKilled });\n };\n\n // Set timeout for forceful kill\n const timeout = setTimeout(() => {\n try {\n // Check again before SIGKILL\n if (child.exitCode === null && !child.killed) {\n child.kill('SIGKILL');\n wasKilled = true;\n }\n } catch (_) {}\n // Even if kill fails, resolve\n resolveOnce(true);\n }, timeoutMs);\n\n // Listen for 'close' event (not 'exit') to wait for stdio close\n child.once('close', () => {\n resolveOnce(false);\n });\n\n // Also listen for 'error' event in case spawn failed\n // This prevents promise from hanging forever if process never started\n child.once('error', () => {\n resolveOnce(false);\n });\n\n // Send graceful shutdown signal\n try {\n // Check one more time before killing\n if (child.exitCode !== null) {\n resolveOnce(false);\n return;\n }\n\n const killed = child.kill(signal);\n // If kill returned false, process already exited\n if (!killed) {\n resolveOnce(false);\n }\n } catch (_err) {\n // If kill throws, process is gone or unreachable\n resolveOnce(false);\n }\n });\n\n return closePromise;\n };\n\n return {\n config: resolvedConfig,\n process: child,\n close: stop,\n };\n}\n"],"names":["spawnProcess","normalizeEnv","env","merged","process","result","Object","entries","key","value","undefined","opts","name","command","cwd","stdio","shell","platform","args","resolveArgsPaths","resolvedConfig","logger","info","join","spawnOpts","child","spawn","stderr","on","chunk","write","code","sig","err","message","stop","signal","timeoutMs","closePromise","exitCode","signalCode","timedOut","killed","Promise","resolve","isResolved","wasKilled","resolveOnce","clearTimeout","timeout","setTimeout","kill","_","once","_err","config","close"],"mappings":"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"}
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/client/src/spawn/spawn-server.ts"],"sourcesContent":["/**\n * Low-level single server spawning utilities.\n * Provides core process spawning with path resolution, environment management, and lifecycle control.\n */\n\nimport { type ChildProcess, type SpawnOptions, type StdioOptions, spawn } from 'child_process';\nimport * as process from 'process';\nimport { logger } from '../utils/logger.ts';\nimport { resolveArgsPaths } from '../utils/path-utils.ts';\n\n/**\n * Options for spawning a single server process.\n * @internal\n */\nexport interface SpawnProcessOptions {\n /** Server name for logging */\n name: string;\n /** Command to execute (e.g., 'node', 'npx') */\n command: string;\n /** Command arguments (paths will be resolved relative to cwd) */\n args?: string[];\n /** Working directory (must be absolute path) */\n cwd?: string;\n /** Additional environment variables (merged with process.env) */\n env?: Record<string, string>;\n /** Standard I/O configuration */\n stdio?: StdioOptions;\n /** Use shell for command execution (default: false, true on Windows) */\n shell?: boolean;\n}\n\n/**\n * Handle to a spawned server process.\n * Provides access to the process, resolved config, and lifecycle control.\n * @hidden\n */\nexport interface ServerProcess {\n /**\n * The resolved server configuration that was actually used.\n * Useful for debugging and understanding what was spawned.\n */\n config: {\n name: string;\n command: string;\n args: string[];\n cwd: string;\n env: Record<string, string>;\n stdio: StdioOptions;\n shell: boolean;\n };\n\n /**\n * The spawned child process.\n */\n process: ChildProcess;\n\n /**\n * Close the server gracefully.\n * Sends the specified signal (default: SIGINT), then SIGKILL after timeout.\n *\n * @param signal - Signal to send (default: SIGINT)\n * @param opts - Options including timeout\n * @returns Promise resolving to whether the process timed out and was force-killed\n */\n close: (signal?: NodeJS.Signals, opts?: { timeoutMs?: number }) => Promise<{ timedOut: boolean; killed: boolean }>;\n}\n\n/**\n * Normalize environment variables by merging with process.env and filtering undefined values.\n */\nfunction normalizeEnv(env?: Record<string, string>): Record<string, string> {\n const merged = { ...process.env, ...(env || {}) };\n const result: Record<string, string> = {};\n for (const [key, value] of Object.entries(merged)) {\n if (value !== undefined) {\n result[key] = value;\n }\n }\n return result;\n}\n\n/**\n * Spawn a single server process with path resolution and environment management.\n *\n * @internal\n * @param opts - Server spawn options\n * @returns ServerProcess handle with resolved config, process, and stop function\n *\n * @example\n * const handle = spawnProcess({\n * name: 'echo',\n * command: 'node',\n * args: ['./bin/server.js', '--port', '3000'],\n * cwd: '/home/user/project/test/lib/servers/echo',\n * env: { LOG_LEVEL: 'error' }\n * });\n *\n * // Later...\n * await handle.close();\n */\nexport function spawnProcess(opts: SpawnProcessOptions): ServerProcess {\n const name = opts.name;\n const command = opts.command;\n const cwd = opts.cwd ?? process.cwd();\n const stdio = opts.stdio ?? 'inherit';\n const shell = opts.shell ?? process.platform === 'win32';\n\n // Resolve paths in args relative to the working directory\n const args = opts.args ? resolveArgsPaths(opts.args, cwd) : [];\n\n // Merge environment variables\n const env = normalizeEnv(opts.env);\n\n // Create resolved config for return value\n const resolvedConfig = {\n name,\n command,\n args,\n cwd,\n env,\n stdio,\n shell,\n };\n\n // Log spawn operation\n logger.info(`[${name}] → ${command} ${args.join(' ')}`);\n\n // Spawn the process\n const spawnOpts: SpawnOptions = { cwd, env, stdio, shell };\n const child = spawn(command, args, spawnOpts);\n\n // Pipe stdio if not inherited\n if (child.stderr)\n child.stderr.on('data', (chunk) => {\n process.stderr.write(chunk);\n });\n\n // Attach lifecycle logging\n child.on('exit', (code, sig) => logger.info(`[${name}] exited (code=${code}, signal=${sig || 'none'})`));\n child.on('error', (err) => logger.info(`[${name}] process error: ${err.message}`));\n\n // Create stop function with graceful shutdown\n const stop = async (signal: NodeJS.Signals = 'SIGINT', opts: { timeoutMs?: number } = {}): Promise<{ timedOut: boolean; killed: boolean }> => {\n // If already exited, return immediately\n if (child.exitCode !== null || child.signalCode !== null) {\n return { timedOut: false, killed: false };\n }\n\n const timeoutMs = opts.timeoutMs ?? 500;\n\n // Wait for 'close' event (process exit + stdio streams closed)\n // This is better than 'exit' because it ensures stdio is fully cleaned up\n const closePromise = new Promise<{ timedOut: boolean; killed: boolean }>((resolve) => {\n let isResolved = false;\n let wasKilled = false;\n\n const resolveOnce = (timedOut: boolean) => {\n if (isResolved) return;\n isResolved = true;\n clearTimeout(timeout);\n resolve({ timedOut, killed: wasKilled });\n };\n\n // Set timeout for forceful kill\n const timeout = setTimeout(() => {\n try {\n // Check again before SIGKILL\n if (child.exitCode === null && !child.killed) {\n child.kill('SIGKILL');\n wasKilled = true;\n }\n } catch (_) {}\n // Even if kill fails, resolve\n resolveOnce(true);\n }, timeoutMs);\n\n // Listen for 'close' event (not 'exit') to wait for stdio close\n child.once('close', () => {\n resolveOnce(false);\n });\n\n // Also listen for 'error' event in case spawn failed\n // This prevents promise from hanging forever if process never started\n child.once('error', () => {\n resolveOnce(false);\n });\n\n // Send graceful shutdown signal\n try {\n // Check one more time before killing\n if (child.exitCode !== null) {\n resolveOnce(false);\n return;\n }\n\n const killed = child.kill(signal);\n // If kill returned false, process already exited\n if (!killed) {\n resolveOnce(false);\n }\n } catch (_err) {\n // If kill throws, process is gone or unreachable\n resolveOnce(false);\n }\n });\n\n return closePromise;\n };\n\n return {\n config: resolvedConfig,\n process: child,\n close: stop,\n };\n}\n"],"names":["spawnProcess","normalizeEnv","env","merged","process","result","Object","entries","key","value","undefined","opts","name","command","cwd","stdio","shell","platform","args","resolveArgsPaths","resolvedConfig","logger","info","join","spawnOpts","child","spawn","stderr","on","chunk","write","code","sig","err","message","stop","signal","timeoutMs","closePromise","exitCode","signalCode","timedOut","killed","Promise","resolve","isResolved","wasKilled","resolveOnce","clearTimeout","timeout","setTimeout","kill","_","once","_err","config","close"],"mappings":"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"}
|
|
@@ -37,11 +37,8 @@ function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
|
|
|
37
37
|
reject(error);
|
|
38
38
|
return;
|
|
39
39
|
}
|
|
40
|
-
if (info.done)
|
|
41
|
-
|
|
42
|
-
} else {
|
|
43
|
-
Promise.resolve(value).then(_next, _throw);
|
|
44
|
-
}
|
|
40
|
+
if (info.done) resolve(value);
|
|
41
|
+
else Promise.resolve(value).then(_next, _throw);
|
|
45
42
|
}
|
|
46
43
|
function _async_to_generator(fn) {
|
|
47
44
|
return function() {
|
|
@@ -66,17 +63,14 @@ function _define_property(obj, key, value) {
|
|
|
66
63
|
configurable: true,
|
|
67
64
|
writable: true
|
|
68
65
|
});
|
|
69
|
-
} else
|
|
70
|
-
obj[key] = value;
|
|
71
|
-
}
|
|
66
|
+
} else obj[key] = value;
|
|
72
67
|
return obj;
|
|
73
68
|
}
|
|
74
69
|
function _instanceof(left, right) {
|
|
70
|
+
"@swc/helpers - instanceof";
|
|
75
71
|
if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
|
|
76
72
|
return !!right[Symbol.hasInstance](left);
|
|
77
|
-
} else
|
|
78
|
-
return left instanceof right;
|
|
79
|
-
}
|
|
73
|
+
} else return left instanceof right;
|
|
80
74
|
}
|
|
81
75
|
function _getRequireWildcardCache(nodeInterop) {
|
|
82
76
|
if (typeof WeakMap !== "function") return null;
|
|
@@ -87,18 +81,12 @@ function _getRequireWildcardCache(nodeInterop) {
|
|
|
87
81
|
})(nodeInterop);
|
|
88
82
|
}
|
|
89
83
|
function _interop_require_wildcard(obj, nodeInterop) {
|
|
90
|
-
if (!nodeInterop && obj && obj.__esModule)
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
return {
|
|
95
|
-
default: obj
|
|
96
|
-
};
|
|
97
|
-
}
|
|
84
|
+
if (!nodeInterop && obj && obj.__esModule) return obj;
|
|
85
|
+
if (obj === null || typeof obj !== "object" && typeof obj !== "function") return {
|
|
86
|
+
default: obj
|
|
87
|
+
};
|
|
98
88
|
var cache = _getRequireWildcardCache(nodeInterop);
|
|
99
|
-
if (cache && cache.has(obj))
|
|
100
|
-
return cache.get(obj);
|
|
101
|
-
}
|
|
89
|
+
if (cache && cache.has(obj)) return cache.get(obj);
|
|
102
90
|
var newObj = {
|
|
103
91
|
__proto__: null
|
|
104
92
|
};
|
|
@@ -106,17 +94,12 @@ function _interop_require_wildcard(obj, nodeInterop) {
|
|
|
106
94
|
for(var key in obj){
|
|
107
95
|
if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
|
|
108
96
|
var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
|
|
109
|
-
if (desc && (desc.get || desc.set))
|
|
110
|
-
|
|
111
|
-
} else {
|
|
112
|
-
newObj[key] = obj[key];
|
|
113
|
-
}
|
|
97
|
+
if (desc && (desc.get || desc.set)) Object.defineProperty(newObj, key, desc);
|
|
98
|
+
else newObj[key] = obj[key];
|
|
114
99
|
}
|
|
115
100
|
}
|
|
116
101
|
newObj.default = obj;
|
|
117
|
-
if (cache)
|
|
118
|
-
cache.set(obj, newObj);
|
|
119
|
-
}
|
|
102
|
+
if (cache) cache.set(obj, newObj);
|
|
120
103
|
return newObj;
|
|
121
104
|
}
|
|
122
105
|
function _iterable_to_array_limit(arr, i) {
|
|
@@ -144,7 +127,7 @@ function _iterable_to_array_limit(arr, i) {
|
|
|
144
127
|
return _arr;
|
|
145
128
|
}
|
|
146
129
|
function _non_iterable_rest() {
|
|
147
|
-
throw new TypeError("Invalid attempt to destructure non-iterable instance
|
|
130
|
+
throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
|
|
148
131
|
}
|
|
149
132
|
function _object_spread(target) {
|
|
150
133
|
for(var i = 1; i < arguments.length; i++){
|
|
@@ -176,9 +159,8 @@ function ownKeys(object, enumerableOnly) {
|
|
|
176
159
|
}
|
|
177
160
|
function _object_spread_props(target, source) {
|
|
178
161
|
source = source != null ? source : {};
|
|
179
|
-
if (Object.getOwnPropertyDescriptors)
|
|
180
|
-
|
|
181
|
-
} else {
|
|
162
|
+
if (Object.getOwnPropertyDescriptors) Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
|
|
163
|
+
else {
|
|
182
164
|
ownKeys(Object(source)).forEach(function(key) {
|
|
183
165
|
Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
|
|
184
166
|
});
|
|
@@ -188,14 +170,6 @@ function _object_spread_props(target, source) {
|
|
|
188
170
|
function _sliced_to_array(arr, i) {
|
|
189
171
|
return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
|
|
190
172
|
}
|
|
191
|
-
function _unsupported_iterable_to_array(o, minLen) {
|
|
192
|
-
if (!o) return;
|
|
193
|
-
if (typeof o === "string") return _array_like_to_array(o, minLen);
|
|
194
|
-
var n = Object.prototype.toString.call(o).slice(8, -1);
|
|
195
|
-
if (n === "Object" && o.constructor) n = o.constructor.name;
|
|
196
|
-
if (n === "Map" || n === "Set") return Array.from(n);
|
|
197
|
-
if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
|
|
198
|
-
}
|
|
199
173
|
function _ts_generator(thisArg, body) {
|
|
200
174
|
var f, y, t, _ = {
|
|
201
175
|
label: 0,
|
|
@@ -295,6 +269,14 @@ function _ts_generator(thisArg, body) {
|
|
|
295
269
|
};
|
|
296
270
|
}
|
|
297
271
|
}
|
|
272
|
+
function _unsupported_iterable_to_array(o, minLen) {
|
|
273
|
+
if (!o) return;
|
|
274
|
+
if (typeof o === "string") return _array_like_to_array(o, minLen);
|
|
275
|
+
var n = Object.prototype.toString.call(o).slice(8, -1);
|
|
276
|
+
if (n === "Object" && o.constructor) n = o.constructor.name;
|
|
277
|
+
if (n === "Map" || n === "Set") return Array.from(n);
|
|
278
|
+
if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
|
|
279
|
+
}
|
|
298
280
|
/**
|
|
299
281
|
* Infer transport type: explicit type > URL protocol > default 'stdio'
|
|
300
282
|
*/ function inferTransportType(config) {
|
|
@@ -516,7 +498,7 @@ function createServerRegistry(serversConfig, options) {
|
|
|
516
498
|
}
|
|
517
499
|
}
|
|
518
500
|
// Create connect function that tracks clients
|
|
519
|
-
var connect = function(name, options) {
|
|
501
|
+
var connect = function connect(name, options) {
|
|
520
502
|
return _async_to_generator(function() {
|
|
521
503
|
var serverEntry, available, transportType, entry, released, lease, registryLike, rawClient, decorated;
|
|
522
504
|
return _ts_generator(this, function(_state) {
|
|
@@ -664,7 +646,7 @@ function createServerRegistry(serversConfig, options) {
|
|
|
664
646
|
})();
|
|
665
647
|
};
|
|
666
648
|
// Create close function that stops all clients and servers
|
|
667
|
-
var close = function() {
|
|
649
|
+
var close = function close() {
|
|
668
650
|
var signal = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : 'SIGINT', opts = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
|
|
669
651
|
return _async_to_generator(function() {
|
|
670
652
|
var clientClosePromises, closeResults, timedOut, killedCount;
|
|
@@ -752,7 +734,7 @@ function createServerRegistry(serversConfig, options) {
|
|
|
752
734
|
});
|
|
753
735
|
})();
|
|
754
736
|
};
|
|
755
|
-
var searchFromRegistry = function(query) {
|
|
737
|
+
var searchFromRegistry = function searchFromRegistry(query) {
|
|
756
738
|
var _$options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
|
|
757
739
|
return _async_to_generator(function() {
|
|
758
740
|
var _options_servers, requestedServers, unknownServers, capabilityClients, failures, ensureClient, failureDetails, index;
|
|
@@ -771,7 +753,7 @@ function createServerRegistry(serversConfig, options) {
|
|
|
771
753
|
}
|
|
772
754
|
capabilityClients = new Map();
|
|
773
755
|
failures = [];
|
|
774
|
-
ensureClient = function(serverName) {
|
|
756
|
+
ensureClient = function ensureClient(serverName) {
|
|
775
757
|
return _async_to_generator(function() {
|
|
776
758
|
var _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, client;
|
|
777
759
|
return _ts_generator(this, function(_state) {
|
|
@@ -881,7 +863,7 @@ function createServerRegistry(serversConfig, options) {
|
|
|
881
863
|
})();
|
|
882
864
|
};
|
|
883
865
|
// Async dispose for `await using` pattern
|
|
884
|
-
var asyncDispose = function() {
|
|
866
|
+
var asyncDispose = function asyncDispose() {
|
|
885
867
|
return _async_to_generator(function() {
|
|
886
868
|
return _ts_generator(this, function(_state) {
|
|
887
869
|
switch(_state.label){
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/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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"}
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/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.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/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.js
CHANGED
|
@@ -51,7 +51,7 @@ function getLogLevel() {
|
|
|
51
51
|
/**
|
|
52
52
|
* Create a sanitized logger with log level filtering
|
|
53
53
|
*/ function createSanitizedLogger() {
|
|
54
|
-
var createLogMethod = function(consoleMethod) {
|
|
54
|
+
var createLogMethod = function createLogMethod(consoleMethod) {
|
|
55
55
|
return function(message) {
|
|
56
56
|
for(var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++){
|
|
57
57
|
args[_key - 1] = arguments[_key];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/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,yBAACC;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"}
|
|
@@ -38,18 +38,12 @@ function _getRequireWildcardCache(nodeInterop) {
|
|
|
38
38
|
})(nodeInterop);
|
|
39
39
|
}
|
|
40
40
|
function _interop_require_wildcard(obj, nodeInterop) {
|
|
41
|
-
if (!nodeInterop && obj && obj.__esModule)
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
return {
|
|
46
|
-
default: obj
|
|
47
|
-
};
|
|
48
|
-
}
|
|
41
|
+
if (!nodeInterop && obj && obj.__esModule) return obj;
|
|
42
|
+
if (obj === null || typeof obj !== "object" && typeof obj !== "function") return {
|
|
43
|
+
default: obj
|
|
44
|
+
};
|
|
49
45
|
var cache = _getRequireWildcardCache(nodeInterop);
|
|
50
|
-
if (cache && cache.has(obj))
|
|
51
|
-
return cache.get(obj);
|
|
52
|
-
}
|
|
46
|
+
if (cache && cache.has(obj)) return cache.get(obj);
|
|
53
47
|
var newObj = {
|
|
54
48
|
__proto__: null
|
|
55
49
|
};
|
|
@@ -57,17 +51,12 @@ function _interop_require_wildcard(obj, nodeInterop) {
|
|
|
57
51
|
for(var key in obj){
|
|
58
52
|
if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
|
|
59
53
|
var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
|
|
60
|
-
if (desc && (desc.get || desc.set))
|
|
61
|
-
|
|
62
|
-
} else {
|
|
63
|
-
newObj[key] = obj[key];
|
|
64
|
-
}
|
|
54
|
+
if (desc && (desc.get || desc.set)) Object.defineProperty(newObj, key, desc);
|
|
55
|
+
else newObj[key] = obj[key];
|
|
65
56
|
}
|
|
66
57
|
}
|
|
67
58
|
newObj.default = obj;
|
|
68
|
-
if (cache)
|
|
69
|
-
cache.set(obj, newObj);
|
|
70
|
-
}
|
|
59
|
+
if (cache) cache.set(obj, newObj);
|
|
71
60
|
return newObj;
|
|
72
61
|
}
|
|
73
62
|
function _iterable_to_array_limit(arr, i) {
|
|
@@ -95,7 +84,7 @@ function _iterable_to_array_limit(arr, i) {
|
|
|
95
84
|
return _arr;
|
|
96
85
|
}
|
|
97
86
|
function _non_iterable_rest() {
|
|
98
|
-
throw new TypeError("Invalid attempt to destructure non-iterable instance
|
|
87
|
+
throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
|
|
99
88
|
}
|
|
100
89
|
function _sliced_to_array(arr, i) {
|
|
101
90
|
return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/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"}
|
|
@@ -27,9 +27,7 @@ function _define_property(obj, key, value) {
|
|
|
27
27
|
configurable: true,
|
|
28
28
|
writable: true
|
|
29
29
|
});
|
|
30
|
-
} else
|
|
31
|
-
obj[key] = value;
|
|
32
|
-
}
|
|
30
|
+
} else obj[key] = value;
|
|
33
31
|
return obj;
|
|
34
32
|
}
|
|
35
33
|
function _object_spread(target) {
|
|
@@ -62,9 +60,8 @@ function ownKeys(object, enumerableOnly) {
|
|
|
62
60
|
}
|
|
63
61
|
function _object_spread_props(target, source) {
|
|
64
62
|
source = source != null ? source : {};
|
|
65
|
-
if (Object.getOwnPropertyDescriptors)
|
|
66
|
-
|
|
67
|
-
} else {
|
|
63
|
+
if (Object.getOwnPropertyDescriptors) Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
|
|
64
|
+
else {
|
|
68
65
|
ownKeys(Object(source)).forEach(function(key) {
|
|
69
66
|
Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
|
|
70
67
|
});
|
|
@@ -112,7 +109,7 @@ function sanitizeForLogging(message, obj) {
|
|
|
112
109
|
}
|
|
113
110
|
function sanitizeForLoggingFormatter() {
|
|
114
111
|
return {
|
|
115
|
-
log: function(obj) {
|
|
112
|
+
log: function log(obj) {
|
|
116
113
|
var message = obj.msg || obj.message || '';
|
|
117
114
|
var _sanitizeForLogging = sanitizeForLogging(message, obj), clean = _sanitizeForLogging.message, meta = _sanitizeForLogging.meta;
|
|
118
115
|
return _object_spread_props(_object_spread({}, meta), {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/client/src/utils/sanitizer.ts"],"sourcesContent":["/**\n * Minimal log sanitization for spawn operations\n * Redacts credentials from environment variables and command arguments\n */\n\nimport type { SpawnMetadata } from '../connection/types.ts';\n\n/**\n * Sanitize log messages and metadata to prevent credential leakage\n *\n * Redacts common credential patterns:\n * - key=value, secret=value, token=value, password=value\n * - Environment variables with sensitive names\n *\n * @param message - Log message to sanitize\n * @param obj - Metadata object to sanitize\n * @returns Sanitized message and metadata\n */\nexport function sanitizeForLogging(message: string, obj: SpawnMetadata): { message: string; meta: SpawnMetadata } {\n // Redact common credential patterns in message\n const cleanMessage = message\n .replace(/key[=:]\\S+/gi, 'key=[REDACTED]')\n .replace(/secret[=:]\\S+/gi, 'secret=[REDACTED]')\n .replace(/token[=:]\\S+/gi, 'token=[REDACTED]')\n .replace(/password[=:]\\S+/gi, 'password=[REDACTED]')\n .replace(/auth[=:]\\S+/gi, 'auth=[REDACTED]');\n\n // Deep clone and redact sensitive env var keys\n const cleanMeta = JSON.parse(JSON.stringify(obj));\n\n // Redact sensitive environment variable values\n if (cleanMeta.env && typeof cleanMeta.env === 'object') {\n for (const envKey of Object.keys(cleanMeta.env)) {\n if (/key|secret|token|password|auth|credential/i.test(envKey)) {\n cleanMeta.env[envKey] = '[REDACTED]';\n }\n }\n }\n\n return { message: cleanMessage, meta: cleanMeta };\n}\n\nexport function sanitizeForLoggingFormatter() {\n return {\n log: (obj: SpawnMetadata) => {\n const message = (obj.msg || obj.message || '') as string;\n const { message: clean, meta } = sanitizeForLogging(message, obj);\n return { ...meta, msg: clean };\n },\n };\n}\n"],"names":["sanitizeForLogging","sanitizeForLoggingFormatter","message","obj","cleanMessage","replace","cleanMeta","JSON","parse","stringify","env","Object","keys","envKey","test","meta","log","msg","clean"],"mappings":"AAAA;;;CAGC;;;;;;;;;;;QAeeA;eAAAA;;QAwBAC;eAAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAxBT,SAASD,mBAAmBE,OAAe,EAAEC,GAAkB;IACpE,+CAA+C;IAC/C,IAAMC,eAAeF,QAClBG,OAAO,CAAC,gBAAgB,kBACxBA,OAAO,CAAC,mBAAmB,qBAC3BA,OAAO,CAAC,kBAAkB,oBAC1BA,OAAO,CAAC,qBAAqB,uBAC7BA,OAAO,CAAC,iBAAiB;IAE5B,+CAA+C;IAC/C,IAAMC,YAAYC,KAAKC,KAAK,CAACD,KAAKE,SAAS,CAACN;IAE5C,+CAA+C;IAC/C,IAAIG,UAAUI,GAAG,IAAI,SAAOJ,UAAUI,GAAG,MAAK,UAAU;YACjD,kCAAA,2BAAA;;YAAL,QAAK,YAAgBC,OAAOC,IAAI,CAACN,UAAUI,GAAG,sBAAzC,SAAA,6BAAA,QAAA,yBAAA,iCAA4C;gBAA5C,IAAMG,SAAN;gBACH,IAAI,6CAA6CC,IAAI,CAACD,SAAS;oBAC7DP,UAAUI,GAAG,CAACG,OAAO,GAAG;gBAC1B;YACF;;YAJK;YAAA;;;qBAAA,6BAAA;oBAAA;;;oBAAA;0BAAA;;;;IAKP;IAEA,OAAO;QAAEX,SAASE;QAAcW,MAAMT;IAAU;AAClD;AAEO,SAASL;IACd,OAAO;QACLe,KAAK,SAALA,IAAMb;YACJ,IAAMD,UAAWC,IAAIc,GAAG,IAAId,IAAID,OAAO,IAAI;YAC3C,IAAiCF,sBAAAA,mBAAmBE,SAASC,MAArDD,AAASgB,QAAgBlB,oBAAzBE,SAAgBa,OAASf,oBAATe;YACxB,OAAO,wCAAKA;gBAAME,KAAKC;;QACzB;IACF;AACF"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/client/src/auth/capability-discovery.ts"],"sourcesContent":["/**\n * OAuth Server Capability Discovery\n * Probes RFC 9728 (Protected Resource) and RFC 8414 (Authorization Server) metadata\n */\n\nimport { normalizeUrl } from '../lib/url-utils.ts';\nimport { discoverAuthorizationServerIssuer, discoverAuthorizationServerMetadata, discoverProtectedResourceMetadata } from './rfc9728-discovery.ts';\nimport type { AuthCapabilities, AuthorizationServerMetadata } from './types.ts';\n\n/**\n * Extract origin (protocol + host) from a URL\n * @param url - Full URL that may include a path\n * @returns Origin (e.g., \"https://example.com\") or original string if invalid URL\n *\n * @example\n * getOrigin('https://example.com/mcp') // → 'https://example.com'\n * getOrigin('http://localhost:9999/api/v1/mcp') // → 'http://localhost:9999'\n */\nfunction getOrigin(url: string): string {\n try {\n return new URL(url).origin;\n } catch {\n // Invalid URL - return as-is for graceful degradation\n return url;\n }\n}\n\n/**\n * Probe OAuth server capabilities using RFC 9728 → RFC 8414 discovery chain\n * Returns capabilities including DCR support detection\n *\n * Discovery Strategy:\n * 1. Try RFC 9728 Protected Resource Metadata (supports cross-domain OAuth)\n * 2. If found, use first authorization_server to discover RFC 8414 Authorization Server Metadata\n * 3. Fall back to direct RFC 8414 discovery at resource origin\n *\n * @param baseUrl - Base URL of the protected resource (e.g., https://ai.todoist.net/mcp)\n * @returns AuthCapabilities object with discovered endpoints and features\n *\n * @example\n * // Todoist case: MCP at ai.todoist.net/mcp, OAuth at todoist.com\n * const caps = await probeAuthCapabilities('https://ai.todoist.net/mcp');\n * if (caps.supportsDcr) {\n * console.log('Registration endpoint:', caps.registrationEndpoint);\n * }\n */\nfunction buildCapabilities(metadata: AuthorizationServerMetadata, scopes?: string[]): AuthCapabilities {\n const supportsDcr = !!metadata.registration_endpoint;\n const capabilities: AuthCapabilities = { supportsDcr };\n\n if (metadata.registration_endpoint) {\n capabilities.registrationEndpoint = metadata.registration_endpoint;\n }\n if (metadata.authorization_endpoint) {\n capabilities.authorizationEndpoint = metadata.authorization_endpoint;\n }\n if (metadata.token_endpoint) capabilities.tokenEndpoint = metadata.token_endpoint;\n if (metadata.introspection_endpoint) {\n capabilities.introspectionEndpoint = metadata.introspection_endpoint;\n }\n\n if (scopes && scopes.length > 0) {\n capabilities.scopes = scopes;\n } else if (metadata.scopes_supported) {\n capabilities.scopes = metadata.scopes_supported;\n }\n\n return capabilities;\n}\n\nasync function resolveCapabilitiesFromAuthorizationServer(authServerUrl: string, scopes?: string[]): Promise<AuthCapabilities | null> {\n const metadata = await discoverAuthorizationServerMetadata(authServerUrl);\n if (!metadata) return null;\n return buildCapabilities(metadata, scopes);\n}\n\nexport async function probeAuthCapabilities(baseUrl: string): Promise<AuthCapabilities> {\n try {\n const normalizedBaseUrl = normalizeUrl(baseUrl);\n // Strategy 1: Try RFC 9728 Protected Resource Metadata discovery\n // This handles cross-domain OAuth (e.g., Todoist: ai.todoist.net/mcp → todoist.com)\n const resourceMetadata = await discoverProtectedResourceMetadata(normalizedBaseUrl);\n\n if (resourceMetadata && resourceMetadata.authorization_servers.length > 0) {\n // Found protected resource metadata with authorization servers\n // Discover the authorization server's metadata (RFC 8414)\n const authServerUrl = resourceMetadata.authorization_servers[0];\n if (!authServerUrl) {\n // Array has length > 0 but first element is undefined/null - skip this path\n return { supportsDcr: false };\n }\n const capabilities = await resolveCapabilitiesFromAuthorizationServer(authServerUrl, resourceMetadata.scopes_supported);\n if (capabilities) {\n return capabilities;\n }\n\n const issuer = await discoverAuthorizationServerIssuer(baseUrl);\n if (issuer) {\n const issuerCapabilities = await resolveCapabilitiesFromAuthorizationServer(issuer, resourceMetadata.scopes_supported);\n if (issuerCapabilities) return issuerCapabilities;\n }\n }\n\n const issuer = await discoverAuthorizationServerIssuer(normalizedBaseUrl);\n if (issuer) {\n const issuerCapabilities = await resolveCapabilitiesFromAuthorizationServer(issuer);\n if (issuerCapabilities) return issuerCapabilities;\n }\n\n // Strategy 2: Fall back to direct RFC 8414 discovery at resource origin\n // This handles same-domain OAuth (traditional setup)\n const origin = getOrigin(normalizedBaseUrl);\n const originCapabilities = await resolveCapabilitiesFromAuthorizationServer(origin);\n if (originCapabilities) return originCapabilities;\n\n // No OAuth metadata found\n return { supportsDcr: false };\n } catch (_error) {\n // Network error, invalid JSON, or other fetch failure\n // Gracefully degrade - assume no DCR support\n return { supportsDcr: false };\n }\n}\n"],"names":["normalizeUrl","discoverAuthorizationServerIssuer","discoverAuthorizationServerMetadata","discoverProtectedResourceMetadata","getOrigin","url","URL","origin","buildCapabilities","metadata","scopes","supportsDcr","registration_endpoint","capabilities","registrationEndpoint","authorization_endpoint","authorizationEndpoint","token_endpoint","tokenEndpoint","introspection_endpoint","introspectionEndpoint","length","scopes_supported","resolveCapabilitiesFromAuthorizationServer","authServerUrl","probeAuthCapabilities","baseUrl","normalizedBaseUrl","resourceMetadata","authorization_servers","issuer","issuerCapabilities","originCapabilities","_error"],"mappings":"AAAA;;;CAGC,GAED,SAASA,YAAY,QAAQ,sBAAsB;AACnD,SAASC,iCAAiC,EAAEC,mCAAmC,EAAEC,iCAAiC,QAAQ,yBAAyB;AAGnJ;;;;;;;;CAQC,GACD,SAASC,UAAUC,GAAW;IAC5B,IAAI;QACF,OAAO,IAAIC,IAAID,KAAKE,MAAM;IAC5B,EAAE,OAAM;QACN,sDAAsD;QACtD,OAAOF;IACT;AACF;AAEA;;;;;;;;;;;;;;;;;;CAkBC,GACD,SAASG,kBAAkBC,QAAqC,EAAEC,MAAiB;IACjF,MAAMC,cAAc,CAAC,CAACF,SAASG,qBAAqB;IACpD,MAAMC,eAAiC;QAAEF;IAAY;IAErD,IAAIF,SAASG,qBAAqB,EAAE;QAClCC,aAAaC,oBAAoB,GAAGL,SAASG,qBAAqB;IACpE;IACA,IAAIH,SAASM,sBAAsB,EAAE;QACnCF,aAAaG,qBAAqB,GAAGP,SAASM,sBAAsB;IACtE;IACA,IAAIN,SAASQ,cAAc,EAAEJ,aAAaK,aAAa,GAAGT,SAASQ,cAAc;IACjF,IAAIR,SAASU,sBAAsB,EAAE;QACnCN,aAAaO,qBAAqB,GAAGX,SAASU,sBAAsB;IACtE;IAEA,IAAIT,UAAUA,OAAOW,MAAM,GAAG,GAAG;QAC/BR,aAAaH,MAAM,GAAGA;IACxB,OAAO,IAAID,SAASa,gBAAgB,EAAE;QACpCT,aAAaH,MAAM,GAAGD,SAASa,gBAAgB;IACjD;IAEA,OAAOT;AACT;AAEA,eAAeU,2CAA2CC,aAAqB,EAAEd,MAAiB;IAChG,MAAMD,WAAW,MAAMP,oCAAoCsB;IAC3D,IAAI,CAACf,UAAU,OAAO;IACtB,OAAOD,kBAAkBC,UAAUC;AACrC;AAEA,OAAO,eAAee,sBAAsBC,OAAe;IACzD,IAAI;QACF,MAAMC,oBAAoB3B,aAAa0B;QACvC,iEAAiE;QACjE,oFAAoF;QACpF,MAAME,mBAAmB,MAAMzB,kCAAkCwB;QAEjE,IAAIC,oBAAoBA,iBAAiBC,qBAAqB,CAACR,MAAM,GAAG,GAAG;YACzE,+DAA+D;YAC/D,0DAA0D;YAC1D,MAAMG,gBAAgBI,iBAAiBC,qBAAqB,CAAC,EAAE;YAC/D,IAAI,CAACL,eAAe;gBAClB,4EAA4E;gBAC5E,OAAO;oBAAEb,aAAa;gBAAM;YAC9B;YACA,MAAME,eAAe,MAAMU,2CAA2CC,eAAeI,iBAAiBN,gBAAgB;YACtH,IAAIT,cAAc;gBAChB,OAAOA;YACT;YAEA,MAAMiB,SAAS,MAAM7B,kCAAkCyB;YACvD,IAAII,QAAQ;gBACV,MAAMC,qBAAqB,MAAMR,2CAA2CO,QAAQF,iBAAiBN,gBAAgB;gBACrH,IAAIS,oBAAoB,OAAOA;YACjC;QACF;QAEA,MAAMD,SAAS,MAAM7B,kCAAkC0B;QACvD,IAAIG,QAAQ;YACV,MAAMC,qBAAqB,MAAMR,2CAA2CO;YAC5E,IAAIC,oBAAoB,OAAOA;QACjC;QAEA,wEAAwE;QACxE,qDAAqD;QACrD,MAAMxB,SAASH,UAAUuB;QACzB,MAAMK,qBAAqB,MAAMT,2CAA2ChB;QAC5E,IAAIyB,oBAAoB,OAAOA;QAE/B,0BAA0B;QAC1B,OAAO;YAAErB,aAAa;QAAM;IAC9B,EAAE,OAAOsB,QAAQ;QACf,sDAAsD;QACtD,6CAA6C;QAC7C,OAAO;YAAEtB,aAAa;QAAM;IAC9B;AACF"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/Users/kevin/Dev/
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/client/src/auth/index.ts"],"sourcesContent":["/**\n * Authentication Module\n * Exports public API for OAuth authentication only (DCR moved to ../dcr/)\n */\n\nexport { probeAuthCapabilities } from './capability-discovery.ts';\nexport { InteractiveOAuthFlow } from './interactive-oauth-flow.ts';\nexport type { OAuthCallbackListenerOptions } from './oauth-callback-listener.ts';\nexport { OAuthCallbackListener } from './oauth-callback-listener.ts';\nexport type { AuthCapabilities, CallbackResult, OAuthFlowOptions, TokenSet } from './types.ts';\n"],"names":["probeAuthCapabilities","InteractiveOAuthFlow","OAuthCallbackListener"],"mappings":"AAAA;;;CAGC,GAED,SAASA,qBAAqB,QAAQ,4BAA4B;AAClE,SAASC,oBAAoB,QAAQ,8BAA8B;AAEnE,SAASC,qBAAqB,QAAQ,+BAA+B"}
|