@global-packages/mcp-kit 1.0.0 → 1.0.3

package/dist/core/detector.js

@@ -1,82 +1,123 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectOS = detectOS;
-exports.getGlobalVsCodeConfigPath = getGlobalVsCodeConfigPath;
-exports.detectVsCodePath = detectVsCodePath;
-exports.detectNodeVersion = detectNodeVersion;
-exports.isNodeVersionCompatible = isNodeVersionCompatible;
-exports.detectExistingMcps = detectExistingMcps;
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const node_os_1 = __importDefault(require("node:os"));
-const node_path_1 = __importDefault(require("node:path"));
-const semver_1 = __importDefault(require("semver"));
-const constants_1 = require("../constants");
-const writer_1 = require("./writer");
-function detectOS() {
-    if (process.platform === "win32") {
-        return "windows";
+import path from 'node:path';
+import os from 'node:os';
+import fs from 'node:fs';
+import semver from 'semver';
+import { VSCODE_SEARCH_DEPTH } from '../constants.js';
+import { fileExists } from '../utils/fs.js';
+// OS + VS Code path detector
+/**
+ * Detect the current operating system.
+ */
+export function detectOS() {
+    switch (process.platform) {
+        case 'win32':
+            return 'windows';
+        case 'darwin':
+            return 'mac';
+        default:
+            return 'linux';
     }
-    if (process.platform === "darwin") {
-        return "mac";
-    }
-    return "linux";
 }
-function getGlobalVsCodeConfigPath(currentOs) {
-    if (currentOs === "windows") {
-        return node_path_1.default.join(process.env.APPDATA || node_path_1.default.join(node_os_1.default.homedir(), "AppData", "Roaming"), "Code", "User");
-    }
-    if (currentOs === "mac") {
-        return node_path_1.default.join(node_os_1.default.homedir(), "Library", "Application Support", "Code", "User");
+/**
+ * Return the OS-specific VS Code global user config directory.
+ */
+export function getGlobalVsCodeConfigPath(currentOS) {
+    switch (currentOS) {
+        case 'windows': {
+            const appData = process.env['APPDATA'];
+            if (!appData) {
+                throw new Error('APPDATA environment variable is not set');
+            }
+            return path.join(appData, 'Code', 'User');
+        }
+        case 'mac':
+            return path.join(os.homedir(), 'Library', 'Application Support', 'Code', 'User');
+        case 'linux':
+        default:
+            return path.join(os.homedir(), '.config', 'Code', 'User');
     }
-    return node_path_1.default.join(node_os_1.default.homedir(), ".config", "Code", "User");
 }
-async function detectVsCodePath() {
+/**
+ * Detect the best .vscode folder to use, in priority order:
+ * 1. Walk up from cwd looking for a .vscode folder (project-local),
+ *    but SKIP ~/.vscode - that's VS Code's extension storage, not a project config.
+ * 2. Check the OS-level VS Code user config directory (global):
+ *    - mac:     ~/Library/Application Support/Code/User/mcp.json
+ *    - windows: %APPDATA%\Code\User\mcp.json
+ *    - linux:   ~/.config/Code/User/mcp.json
+ * 3. Create a .vscode folder in cwd (fallback).
+ */
+export async function detectVsCodePath() {
+    const homeDir = os.homedir();
+    // Step 1 - walk up from cwd, but skip the bare ~/.vscode directory.
+    // ~/.vscode is where VS Code stores extensions; it is NOT a project config.
     let current = process.cwd();
-    for (let i = 0; i <= constants_1.VSCODE_SEARCH_DEPTH; i += 1) {
-        const candidate = node_path_1.default.join(current, ".vscode");
-        if (await fs_extra_1.default.pathExists(candidate)) {
+    for (let depth = 0; depth < VSCODE_SEARCH_DEPTH; depth++) {
+        const candidate = path.join(current, '.vscode');
+        const isHomeDotVscode = path.resolve(candidate) === path.resolve(path.join(homeDir, '.vscode'));
+        if (!isHomeDotVscode && (await fileExists(candidate))) {
             return {
                 vscodeFolderPath: candidate,
-                mcpJsonPath: node_path_1.default.join(candidate, "mcp.json"),
-                source: "project"
+                mcpJsonPath: path.join(candidate, 'mcp.json'),
+                source: 'project',
             };
         }
-        const parent = node_path_1.default.dirname(current);
-        if (parent === current) {
-            break;
-        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break; // filesystem root
         current = parent;
     }
-    const globalPath = getGlobalVsCodeConfigPath(detectOS());
-    if (await fs_extra_1.default.pathExists(globalPath)) {
-        return {
-            vscodeFolderPath: globalPath,
-            mcpJsonPath: node_path_1.default.join(globalPath, "mcp.json"),
-            source: "global"
-        };
+    // Step 2 - check OS global VS Code config path
+    try {
+        const globalPath = getGlobalVsCodeConfigPath(detectOS());
+        if (await fileExists(globalPath)) {
+            return {
+                vscodeFolderPath: globalPath,
+                mcpJsonPath: path.join(globalPath, 'mcp.json'),
+                source: 'global',
+            };
+        }
     }
-    const created = node_path_1.default.join(process.cwd(), ".vscode");
-    fs_extra_1.default.mkdirSync(created, { recursive: true });
+    catch {
+        // APPDATA not set or path check failed - fall through to Step 3
+    }
+    // Step 3 - create .vscode in cwd
+    const newVscodePath = path.join(process.cwd(), '.vscode');
+    fs.mkdirSync(newVscodePath, { recursive: true });
     return {
-        vscodeFolderPath: created,
-        mcpJsonPath: node_path_1.default.join(created, "mcp.json"),
-        source: "created"
+        vscodeFolderPath: newVscodePath,
+        mcpJsonPath: path.join(newVscodePath, 'mcp.json'),
+        source: 'created',
     };
 }
-function detectNodeVersion() {
+/**
+ * Return the running Node.js version string (e.g. "v20.11.0").
+ */
+export function detectNodeVersion() {
     return process.version;
 }
-function isNodeVersionCompatible() {
-    return semver_1.default.gte(process.version, "18.0.0");
+/**
+ * Return true if the current Node.js version satisfies >= 18.0.0.
+ */
+export function isNodeVersionCompatible() {
+    const version = process.version.replace(/^v/, '');
+    return semver.gte(version, '18.0.0');
 }
-async function detectExistingMcps(mcpJsonPath) {
-    if (!(await fs_extra_1.default.pathExists(mcpJsonPath))) {
+/**
+ * Return the list of MCP server IDs currently present in an mcp.json file.
+ * Returns an empty array if the file does not exist or cannot be parsed.
+ */
+export async function detectExistingMcps(mcpJsonPath) {
+    try {
+        const { readFile } = await import('node:fs/promises');
+        const raw = await readFile(mcpJsonPath, 'utf-8').catch(() => null);
+        if (!raw)
+            return [];
+        const parsed = JSON.parse(raw);
+        return Object.keys(parsed.servers ?? {});
+    }
+    catch {
         return [];
     }
-    const config = await (0, writer_1.readMcpJson)(mcpJsonPath);
-    return Object.keys(config.servers);
 }
 //# sourceMappingURL=detector.js.map

package/dist/core/detector.js.map

@@ -1 +1 @@
-{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../src/core/detector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../src/core/detector.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,6BAA6B;AAE7B;;GAEG;AACH,MAAM,UAAU,QAAQ;IACtB,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,OAAO;YACV,OAAO,SAAS,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC;QACf;YACE,OAAO,OAAO,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,SAAsB;IAC9D,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACvC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;YAC7D,CAAC;YACD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5C,CAAC;QACD,KAAK,KAAK;YACR,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACnF,KAAK,OAAO,CAAC;QACb;YACE,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAE7B,oEAAoE;IACpE,4EAA4E;IAC5E,IAAI,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC5B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,mBAAmB,EAAE,KAAK,EAAE,EAAE,CAAC;QACzD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAChD,MAAM,eAAe,GACnB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;QAE1E,IAAI,CAAC,eAAe,IAAI,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;YACtD,OAAO;gBACL,gBAAgB,EAAE,SAAS;gBAC3B,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;gBAC7C,MAAM,EAAE,SAAS;aAClB,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,MAAM,CAAC,kBAAkB;QACjD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,+CAA+C;IAC/C,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,yBAAyB,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzD,IAAI,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACjC,OAAO;gBACL,gBAAgB,EAAE,UAAU;gBAC5B,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC;gBAC9C,MAAM,EAAE,QAAQ;aACjB,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;IAClE,CAAC;IAED,iCAAiC;IACjC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IAC1D,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,OAAO;QACL,gBAAgB,EAAE,aAAa;QAC/B,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC;QACjD,MAAM,EAAE,SAAS;KAClB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,OAAO,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IAC1D,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA0C,CAAC;QACxE,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/core/registry.d.ts

@@ -1,7 +1,31 @@
-import { McpCategory, McpDefinition, ProfileMode } from "../types";
+import type { McpDefinition, McpCategory, ProfileMode } from '../types.js';
+/**
+ * Look up an MCP definition by its slug ID.
+ */
 export declare function getMcpById(id: string): McpDefinition | undefined;
+/**
+ * Return all MCPs appropriate for the given profile mode.
+ * - dev:     all MCPs where nonDevOnly === false
+ * - non-dev: all MCPs where devOnly === false
+ */
 export declare function getMcpsForProfile(mode: ProfileMode): McpDefinition[];
+/**
+ * Return all MCPs in the given category.
+ */
 export declare function getMcpsByCategory(category: McpCategory): McpDefinition[];
+/**
+ * Return only the default MCPs for a profile (the pre-selected defaults
+ * listed in DEV_MCP_IDS / NON_DEV_MCP_IDS).
+ */
+export declare function getDefaultMcpIds(mode: ProfileMode): string[];
+/**
+ * Fetch the latest published version of an npm package from the npm registry.
+ * Returns "unknown" on any network error.
+ */
 export declare function getLatestVersion(npmPackage: string): Promise<string>;
+/**
+ * Enrich a list of McpDefinition objects with their latest npm versions.
+ * All version lookups run in parallel.
+ */
 export declare function enrichWithVersions(mcps: McpDefinition[]): Promise<McpDefinition[]>;
 //# sourceMappingURL=registry.d.ts.map

package/dist/core/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEnE,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEhE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,EAAE,CAMpE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,aAAa,EAAE,CAExE;AAED,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS1E;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAGxF"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM3E;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,EAAE,CAKpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,aAAa,EAAE,CAExE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,EAAE,CAE5D;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG1E;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,aAAa,EAAE,GACpB,OAAO,CAAC,aAAa,EAAE,CAAC,CAK1B"}

package/dist/core/registry.js

@@ -1,40 +1,52 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMcpById = getMcpById;
-exports.getMcpsForProfile = getMcpsForProfile;
-exports.getMcpsByCategory = getMcpsByCategory;
-exports.getLatestVersion = getLatestVersion;
-exports.enrichWithVersions = enrichWithVersions;
-const axios_1 = __importDefault(require("axios"));
-const constants_1 = require("../constants");
-function getMcpById(id) {
-    return constants_1.MCP_REGISTRY.find((mcp) => mcp.id === id);
+import { MCP_REGISTRY, DEV_MCP_IDS, NON_DEV_MCP_IDS } from '../constants.js';
+import { getNpmPackageVersion } from '../utils/network.js';
+//
+// MCP catalog manager
+//
+/**
+ * Look up an MCP definition by its slug ID.
+ */
+export function getMcpById(id) {
+    return MCP_REGISTRY.find(mcp => mcp.id === id);
 }
-function getMcpsForProfile(mode) {
-    if (mode === "dev") {
-        return constants_1.MCP_REGISTRY.filter((mcp) => !mcp.nonDevOnly);
+/**
+ * Return all MCPs appropriate for the given profile mode.
+ * - dev:     all MCPs where nonDevOnly === false
+ * - non-dev: all MCPs where devOnly === false
+ */
+export function getMcpsForProfile(mode) {
+    if (mode === 'dev') {
+        return MCP_REGISTRY.filter(mcp => !mcp.nonDevOnly);
     }
-    return constants_1.MCP_REGISTRY.filter((mcp) => !mcp.devOnly);
+    return MCP_REGISTRY.filter(mcp => !mcp.devOnly);
 }
-function getMcpsByCategory(category) {
-    return constants_1.MCP_REGISTRY.filter((mcp) => mcp.category === category);
+/**
+ * Return all MCPs in the given category.
+ */
+export function getMcpsByCategory(category) {
+    return MCP_REGISTRY.filter(mcp => mcp.category === category);
 }
-async function getLatestVersion(npmPackage) {
-    try {
-        const response = await axios_1.default.get(`https://registry.npmjs.org/${npmPackage}/latest`, {
-            timeout: 5000
-        });
-        return response.data.version || "unknown";
-    }
-    catch {
-        return "unknown";
-    }
+/**
+ * Return only the default MCPs for a profile (the pre-selected defaults
+ * listed in DEV_MCP_IDS / NON_DEV_MCP_IDS).
+ */
+export function getDefaultMcpIds(mode) {
+    return mode === 'dev' ? DEV_MCP_IDS : NON_DEV_MCP_IDS;
+}
+/**
+ * Fetch the latest published version of an npm package from the npm registry.
+ * Returns "unknown" on any network error.
+ */
+export async function getLatestVersion(npmPackage) {
+    const version = await getNpmPackageVersion(npmPackage);
+    return version ?? 'unknown';
 }
-async function enrichWithVersions(mcps) {
-    const versions = await Promise.all(mcps.map((mcp) => getLatestVersion(mcp.npmPackage)));
-    return mcps.map((mcp, index) => ({ ...mcp, version: versions[index] }));
+/**
+ * Enrich a list of McpDefinition objects with their latest npm versions.
+ * All version lookups run in parallel.
+ */
+export async function enrichWithVersions(mcps) {
+    const versions = await Promise.all(mcps.map(mcp => getLatestVersion(mcp.npmPackage)));
+    return mcps.map((mcp, i) => ({ ...mcp, version: versions[i] }));
 }
 //# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":";;;;;AAIA,gCAEC;AAED,8CAMC;AAED,8CAEC;AAED,4CASC;AAED,gDAGC;AAlCD,kDAA0B;AAC1B,4CAA4C;AAG5C,SAAgB,UAAU,CAAC,EAAU;IACnC,OAAO,wBAAY,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,SAAgB,iBAAiB,CAAC,IAAiB;IACjD,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO,wBAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,wBAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,SAAgB,iBAAiB,CAAC,QAAqB;IACrD,OAAO,wBAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;AACjE,CAAC;AAEM,KAAK,UAAU,gBAAgB,CAAC,UAAkB;IACvD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,GAAG,CAAuB,8BAA8B,UAAU,SAAS,EAAE;YACxG,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,kBAAkB,CAAC,IAAqB;IAC5D,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACxF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1E,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,EAAE;AACF,sBAAsB;AACtB,EAAE;AAEF;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAiB;IACjD,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAqB;IACrD,OAAO,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAiB;IAChD,OAAO,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAAkB;IACvD,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACvD,OAAO,OAAO,IAAI,SAAS,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAClD,CAAC;IACF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/core/validator.d.ts

@@ -1,6 +1,22 @@
-import { McpJsonConfig } from "../types";
+import { checkNpmPackageExists } from '../utils/network.js';
+import type { McpJsonConfig } from '../types.js';
+/**
+ * Validate an unknown value against the mcp.json schema.
+ * Throws a descriptive ZodError if the input is invalid.
+ */
 export declare function validateMcpJson(config: unknown): McpJsonConfig;
+/**
+ * Check whether a URL is reachable. Returns true on a 2xx response.
+ */
 export declare function checkNetworkReachability(url: string): Promise<boolean>;
-export declare function checkNpmPackageExists(pkg: string): Promise<boolean>;
+/**
+ * Check whether an npm package exists in the public registry.
+ */
+export { checkNpmPackageExists };
+/**
+ * Validate a single env var value.
+ * - If no regex is provided: passes when the trimmed value is non-empty.
+ * - If a regex is provided: passes when the value matches the regex.
+ */
 export declare function validateEnvVar(value: string, regex?: string): boolean;
 //# sourceMappingURL=validator.d.ts.map

package/dist/core/validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/core/validator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAYzC,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa,CAM9D;AAED,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO5E;AAED,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOzE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAMrE"}
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/core/validator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA+BjD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa,CAS9D;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO5E;AAED;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CASrE"}

package/dist/core/validator.js

@@ -1,50 +1,73 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateMcpJson = validateMcpJson;
-exports.checkNetworkReachability = checkNetworkReachability;
-exports.checkNpmPackageExists = checkNpmPackageExists;
-exports.validateEnvVar = validateEnvVar;
-const axios_1 = __importDefault(require("axios"));
-const zod_1 = require("zod");
-const mcpJsonSchema = zod_1.z.object({
-    servers: zod_1.z.record(zod_1.z.object({
-        command: zod_1.z.string(),
-        args: zod_1.z.array(zod_1.z.string()),
-        env: zod_1.z.record(zod_1.z.string()).optional()
+import { z } from 'zod';
+import axios from 'axios';
+import { checkNpmPackageExists } from '../utils/network.js';
+//
+// Zod schema for mcp.json validation
+//
+const McpServerEntrySchema = z.object({
+    type: z.string().optional(),
+    command: z.string().min(1, 'command must be a non-empty string'),
+    args: z.array(z.string()),
+    env: z.record(z.string()).optional(),
+});
+const McpJsonConfigSchema = z.object({
+    inputs: z
+        .array(z.object({
+        id: z.string(),
+        type: z.string(),
+        description: z.string(),
+        password: z.boolean().optional(),
     }))
+        .optional(),
+    servers: z.record(McpServerEntrySchema),
 });
-function validateMcpJson(config) {
-    const result = mcpJsonSchema.safeParse(config);
+//
+// Public API
+//
+/**
+ * Validate an unknown value against the mcp.json schema.
+ * Throws a descriptive ZodError if the input is invalid.
+ */
+export function validateMcpJson(config) {
+    const result = McpJsonConfigSchema.safeParse(config);
     if (!result.success) {
-        throw new Error(`Invalid mcp.json format: ${result.error.issues.map((i) => i.message).join(", ")}`);
+        const messages = result.error.errors
+            .map(e => `${e.path.join('.')}: ${e.message}`)
+            .join('\n');
+        throw new Error(`Invalid mcp.json structure:\n${messages}`);
     }
     return result.data;
 }
-async function checkNetworkReachability(url) {
+/**
+ * Check whether a URL is reachable. Returns true on a 2xx response.
+ */
+export async function checkNetworkReachability(url) {
     try {
-        const response = await axios_1.default.head(url, { timeout: 5000 });
+        const response = await axios.head(url, { timeout: 5000 });
         return response.status >= 200 && response.status < 300;
     }
     catch {
         return false;
     }
 }
-async function checkNpmPackageExists(pkg) {
+/**
+ * Check whether an npm package exists in the public registry.
+ */
+export { checkNpmPackageExists };
+/**
+ * Validate a single env var value.
+ * - If no regex is provided: passes when the trimmed value is non-empty.
+ * - If a regex is provided: passes when the value matches the regex.
+ */
+export function validateEnvVar(value, regex) {
+    if (!regex) {
+        return value.trim().length > 0;
+    }
     try {
-        const response = await axios_1.default.get(`https://registry.npmjs.org/${pkg}`, { timeout: 5000 });
-        return response.status === 200;
+        return new RegExp(regex).test(value);
     }
     catch {
-        return false;
-    }
-}
-function validateEnvVar(value, regex) {
-    if (!regex) {
         return value.trim().length > 0;
     }
-    return new RegExp(regex).test(value);
 }
 //# sourceMappingURL=validator.js.map

package/dist/core/validator.js.map

@@ -1 +1 @@
-{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/core/validator.ts"],"names":[],"mappings":";;;;;AAcA,0CAMC;AAED,4DAOC;AAED,sDAOC;AAED,wCAMC;AA9CD,kDAA0B;AAC1B,6BAAwB;AAGxB,MAAM,aAAa,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7B,OAAO,EAAE,OAAC,CAAC,MAAM,CACf,OAAC,CAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;QACnB,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;QACzB,GAAG,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KACrC,CAAC,CACH;CACF,CAAC,CAAC;AAEH,SAAgB,eAAe,CAAC,MAAe;IAC7C,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAEM,KAAK,UAAU,wBAAwB,CAAC,GAAW;IACxD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,OAAO,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,qBAAqB,CAAC,GAAW;IACrD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,GAAG,CAAC,8BAA8B,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACzF,OAAO,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAgB,cAAc,CAAC,KAAa,EAAE,KAAc;IAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/core/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,EAAE;AACF,qCAAqC;AACrC,EAAE;AAEF,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,oCAAoC,CAAC;IAChE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,CAAC;SACN,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KACjC,CAAC,CACH;SACA,QAAQ,EAAE;IACb,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,oBAAoB,CAAC;CACxC,CAAC,CAAC;AAEH,EAAE;AACF,aAAa;AACb,EAAE;AAEF;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAe;IAC7C,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aACjC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aAC7C,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,MAAM,CAAC,IAAqB,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,GAAW;IACxD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,OAAO,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,KAAc;IAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/core/writer.d.ts

@@ -1,7 +1,25 @@
-import { McpJsonConfig, McpServerEntry } from "../types";
+import type { McpJsonConfig, McpServerEntry } from '../types.js';
+/**
+ * Read mcp.json from disk. Returns { servers: {} } if the file does not
+ * exist. Throws if the file exists but cannot be parsed.
+ */
 export declare function readMcpJson(mcpJsonPath: string): Promise<McpJsonConfig>;
+/**
+ * Write mcp.json to disk atomically (write to .tmp then rename).
+ * Logs the path on success.
+ */
 export declare function writeMcpJson(mcpJsonPath: string, config: McpJsonConfig): Promise<void>;
+/**
+ * Add or overwrite a single MCP server entry in mcp.json.
+ */
 export declare function addServerToMcpJson(mcpJsonPath: string, serverId: string, entry: McpServerEntry): Promise<void>;
+/**
+ * Remove a single MCP server entry from mcp.json.
+ */
 export declare function removeServerFromMcpJson(mcpJsonPath: string, serverId: string): Promise<void>;
+/**
+ * Merge an incoming McpJsonConfig into the existing one.
+ * Incoming servers win on key conflict.
+ */
 export declare function mergeMcpJson(mcpJsonPath: string, incoming: McpJsonConfig): Promise<void>;
 //# sourceMappingURL=writer.d.ts.map

package/dist/core/writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/core/writer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEzD,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAQ7E;AAED,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5F;AAED,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlG;AAED,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9F"}
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/core/writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMjE;;;GAGG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAW7E;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/core/writer.js

@@ -1,50 +1,56 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readMcpJson = readMcpJson;
-exports.writeMcpJson = writeMcpJson;
-exports.addServerToMcpJson = addServerToMcpJson;
-exports.removeServerFromMcpJson = removeServerFromMcpJson;
-exports.mergeMcpJson = mergeMcpJson;
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const node_path_1 = __importDefault(require("node:path"));
-const logger_1 = require("../utils/logger");
-const validator_1 = require("./validator");
-async function readMcpJson(mcpJsonPath) {
-    if (!(await fs_extra_1.default.pathExists(mcpJsonPath))) {
+import { safeReadJSON, safeWriteJSON } from '../utils/fs.js';
+import { log } from '../utils/logger.js';
+//
+// mcp.json reader / writer
+//
+/**
+ * Read mcp.json from disk. Returns { servers: {} } if the file does not
+ * exist. Throws if the file exists but cannot be parsed.
+ */
+export async function readMcpJson(mcpJsonPath) {
+    const data = await safeReadJSON(mcpJsonPath);
+    if (!data) {
         return { servers: {} };
     }
-    const raw = await fs_extra_1.default.readFile(mcpJsonPath, "utf8");
-    const parsed = JSON.parse(raw);
-    return (0, validator_1.validateMcpJson)(parsed);
+    if (typeof data !== 'object' || !('servers' in data)) {
+        throw new Error(`mcp.json at ${mcpJsonPath} is malformed - missing "servers" key`);
+    }
+    return data;
 }
-async function writeMcpJson(mcpJsonPath, config) {
-    await fs_extra_1.default.mkdirp(node_path_1.default.dirname(mcpJsonPath));
-    const tmpPath = `${mcpJsonPath}.tmp`;
-    await fs_extra_1.default.writeFile(tmpPath, JSON.stringify(config, null, 2), "utf8");
-    await fs_extra_1.default.rename(tmpPath, mcpJsonPath);
-    logger_1.log.success(`Written: ${mcpJsonPath}`);
+/**
+ * Write mcp.json to disk atomically (write to .tmp then rename).
+ * Logs the path on success.
+ */
+export async function writeMcpJson(mcpJsonPath, config) {
+    await safeWriteJSON(mcpJsonPath, config);
+    log.success(`Written: ${mcpJsonPath}`);
 }
-async function addServerToMcpJson(mcpJsonPath, serverId, entry) {
+/**
+ * Add or overwrite a single MCP server entry in mcp.json.
+ */
+export async function addServerToMcpJson(mcpJsonPath, serverId, entry) {
     const config = await readMcpJson(mcpJsonPath);
     config.servers[serverId] = entry;
     await writeMcpJson(mcpJsonPath, config);
 }
-async function removeServerFromMcpJson(mcpJsonPath, serverId) {
+/**
+ * Remove a single MCP server entry from mcp.json.
+ */
+export async function removeServerFromMcpJson(mcpJsonPath, serverId) {
     const config = await readMcpJson(mcpJsonPath);
     delete config.servers[serverId];
     await writeMcpJson(mcpJsonPath, config);
 }
-async function mergeMcpJson(mcpJsonPath, incoming) {
+/**
+ * Merge an incoming McpJsonConfig into the existing one.
+ * Incoming servers win on key conflict.
+ */
+export async function mergeMcpJson(mcpJsonPath, incoming) {
     const existing = await readMcpJson(mcpJsonPath);
-    const merged = {
-        servers: {
-            ...existing.servers,
-            ...incoming.servers
-        }
-    };
-    await writeMcpJson(mcpJsonPath, merged);
+    existing.servers = { ...existing.servers, ...incoming.servers };
+    if (incoming.inputs) {
+        existing.inputs = [...(existing.inputs ?? []), ...incoming.inputs];
+    }
+    await writeMcpJson(mcpJsonPath, existing);
 }
 //# sourceMappingURL=writer.js.map