@himanshusinghs/mongodb-mcp-server 1.7.7 → 1.11.0-prerelease.2

package/dist/esm/setup/aiTool.js

@@ -0,0 +1,383 @@
+/* eslint-disable no-console */
+import fs from "fs";
+import path from "path";
+import os from "os";
+import { applyEdits, findNodeAtLocation, modify, parseTree } from "jsonc-parser";
+import { exec } from "child_process";
+import { formatError, getPlatform } from "./setupAiToolsUtils.js";
+// These are tools that don't have a designated editor to open the config file
+export const TOOLS_WITHOUT_EDITORS = ["claudeDesktop", "claudeCode", "opencode"];
+// Mac: open path in default app, or in editor (e.g. "cursor") if supported
+const getOpenCommandMac = (configPath, tool) => tool && !TOOLS_WITHOUT_EDITORS.includes(tool) ? `open "${tool}://file${configPath}"` : `open "${configPath}"`;
+// Linux: open path in default app, or in editor if supported
+const getOpenCommandLinux = (configPath, tool) => tool && !TOOLS_WITHOUT_EDITORS.includes(tool)
+    ? `xdg-open "${tool}://file${configPath}"`
+    : `xdg-open "${configPath}"`;
+// Windows: open path in default app (for tools without a dedicated editor)
+const getOpenCommandWindowsDefault = (configPath) => `start "" "${configPath}"`;
+const MCP_SERVER_KEY = "mongodb-mcp-server";
+const getBasePath = (useDefaultPath) => {
+    const platform = getPlatform();
+    const isWindows = platform === "windows";
+    // Sometimes in Windows we want to use the user home directory instead of APPDATA
+    if (isWindows && !useDefaultPath) {
+        return process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming");
+    }
+    else {
+        return os.homedir();
+    }
+};
+// Gets an existing servers: {}, mcpServers: {}, or mcp: {} object in the config file or create it if it doesn't exist
+const getOrCreateServersEntry = (config, serversKey) => {
+    const mutable = config;
+    if (!mutable[serversKey]) {
+        mutable[serversKey] = {};
+    }
+    // Cast so callers can assign OpenCodeMcpEntry when serversKey is "mcp" (avoids TS narrowing)
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion
+    return mutable[serversKey];
+};
+// Ensures the directory for the config file exists
+const ensureConfigDir = (configPath) => {
+    const resolvedPath = path.resolve(configPath);
+    const configDir = path.dirname(resolvedPath);
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+    }
+};
+const writeConfigFile = (configPath, config) => {
+    const resolvedPath = path.resolve(configPath);
+    ensureConfigDir(configPath);
+    try {
+        fs.writeFileSync(resolvedPath, JSON.stringify(config, null, 2), "utf-8");
+    }
+    catch (err) {
+        throw new Error(`Could not write config to ${resolvedPath}: ${formatError(err)}. ` +
+            "Check that the path is correct and you have permission to write to that location.", { cause: err });
+    }
+    if (!fs.existsSync(resolvedPath)) {
+        throw new Error(`Config file was not created at ${resolvedPath}.`);
+    }
+};
+function toPatch(entry, envKey) {
+    const envRecord = "env" in entry ? (entry.env ?? {}) : "environment" in entry ? (entry.environment ?? {}) : {};
+    const patch = {
+        command: entry.command,
+        args: "args" in entry ? entry.args : undefined,
+        envKey,
+        envRecord,
+    };
+    if ("type" in entry) {
+        patch.type = entry.type;
+    }
+    if ("enabled" in entry) {
+        patch.enabled = entry.enabled;
+    }
+    return patch;
+}
+// Updates existing config content in place using jsonc-parser; preserves comments and spacing.
+const updateConfigInPlace = (existingContent, serversKey, patch, entry) => {
+    const parsedContent = parseTree(existingContent);
+    const basePath = [serversKey, MCP_SERVER_KEY];
+    const contentBlock = parsedContent ? findNodeAtLocation(parsedContent, basePath) : undefined;
+    const opts = { formattingOptions: { tabSize: 2, insertSpaces: true, eol: "\n" } };
+    if (contentBlock) {
+        let text = existingContent;
+        text = applyEdits(text, modify(text, [...basePath, "command"], patch.command, opts));
+        if (patch.args !== undefined) {
+            text = applyEdits(text, modify(text, [...basePath, "args"], patch.args, opts));
+        }
+        for (const [k, v] of Object.entries(patch.envRecord)) {
+            text = applyEdits(text, modify(text, [...basePath, patch.envKey, k], v, opts));
+        }
+        if (patch.enabled !== undefined) {
+            text = applyEdits(text, modify(text, [...basePath, "enabled"], patch.enabled, opts));
+        }
+        if (patch.type !== undefined) {
+            text = applyEdits(text, modify(text, [...basePath, "type"], patch.type, opts));
+        }
+        return text;
+    }
+    return applyEdits(existingContent, modify(existingContent, basePath, entry, opts));
+};
+export class AITool {
+    // Default key is mcpServers, but we will use this function to override in subclasses (e.g. VS Code uses "servers").
+    getServersKey() {
+        return "mcpServers";
+    }
+    getEnvironmentKey() {
+        return "env";
+    }
+    readConfig(configPath) {
+        const serversKey = this.getServersKey();
+        const emptyConfig = () => ({ [serversKey]: {} });
+        let config = emptyConfig();
+        if (fs.existsSync(configPath)) {
+            try {
+                const existingContent = fs.readFileSync(configPath, "utf-8");
+                config = JSON.parse(existingContent);
+                getOrCreateServersEntry(config, serversKey);
+            }
+            catch (e) {
+                console.error(`Warning: Could not parse existing ${this.configFileName}, creating new config. Error is: ${formatError(e)}`);
+                config = emptyConfig();
+            }
+        }
+        return config;
+    }
+    buildMcpConfigEntry(isReadOnly, env) {
+        const args = ["-y", "mongodb-mcp-server@latest"];
+        if (isReadOnly) {
+            args.push("--readOnly");
+        }
+        return {
+            command: "npx",
+            args: ["-y", "mongodb-mcp-server@latest"],
+            env,
+        };
+    }
+    updateConfig(configPath, env, isReadOnly) {
+        const serversKey = this.getServersKey();
+        const environmentKey = this.getEnvironmentKey();
+        const updatedMcpConfigEntry = this.buildMcpConfigEntry(isReadOnly, env);
+        const existingContent = fs.existsSync(configPath) ? fs.readFileSync(configPath, "utf-8") : null;
+        if (existingContent !== null && existingContent.trim().length > 0) {
+            const resolvedPath = path.resolve(configPath);
+            ensureConfigDir(configPath);
+            try {
+                // Patch in place if file already has content
+                const patch = toPatch(updatedMcpConfigEntry, environmentKey);
+                const newContent = updateConfigInPlace(existingContent, serversKey, patch, updatedMcpConfigEntry);
+                fs.writeFileSync(resolvedPath, newContent, "utf-8");
+            }
+            catch {
+                // Fallback: write full config if in-place update fails (e.g. invalid JSONC)
+                const config = this.readConfig(configPath);
+                const servers = getOrCreateServersEntry(config, serversKey);
+                servers[MCP_SERVER_KEY] = updatedMcpConfigEntry;
+                writeConfigFile(configPath, config);
+            }
+        }
+        else {
+            // New file: write full config
+            const config = this.readConfig(configPath);
+            const servers = getOrCreateServersEntry(config, serversKey);
+            servers[MCP_SERVER_KEY] = updatedMcpConfigEntry;
+            writeConfigFile(configPath, config);
+        }
+    }
+    // Returns the shell command to open the config file. Override in subclasses for editor-specific behavior.
+    getOpenConfigCommand(configPath, platform, editor) {
+        switch (platform) {
+            case "mac":
+                return getOpenCommandMac(configPath, editor);
+            case "windows":
+                return getOpenCommandWindowsDefault(configPath);
+            case "linux":
+                return getOpenCommandLinux(configPath, editor);
+            default:
+                return null;
+        }
+    }
+    async openConfigSettings() {
+        const platform = getPlatform();
+        if (!platform) {
+            return;
+        }
+        const cmd = this.getOpenConfigCommand(this.configPath, platform, this.toolType);
+        if (cmd) {
+            await new Promise((resolve, reject) => {
+                exec(cmd, (error) => {
+                    if (error) {
+                        reject(error);
+                    }
+                    else {
+                        resolve(undefined);
+                    }
+                });
+            });
+        }
+    }
+    /**
+     * The skills.sh agent ID this tool maps to, or null if [skills.sh](https://skills.sh)
+     * has no entry for it (e.g. Claude Desktop — no filesystem skills).
+     * Install paths are owned by `skills add`; we only map identity.
+     */
+    get skillsAgentId() {
+        return null;
+    }
+}
+class Cursor extends AITool {
+    constructor() {
+        super(...arguments);
+        this.name = "Cursor";
+        this.toolType = "cursor";
+        this.configFileName = "mcp.json";
+        this.tip = `Tip: Press ${getPlatform() === "mac" ? "Cmd+I" : "Ctrl+I"} in Cursor to open the Agent panel.\n`;
+    }
+    get configPath() {
+        return path.join(getBasePath(true), ".cursor", "mcp.json");
+    }
+    getOpenConfigCommand(configPath, platform) {
+        switch (platform) {
+            case "mac":
+                return getOpenCommandMac(configPath, "cursor");
+            case "windows":
+                return `cursor "${configPath}"`;
+            case "linux":
+                return getOpenCommandLinux(configPath, "cursor");
+            default:
+                return null;
+        }
+    }
+    get skillsAgentId() {
+        return "cursor";
+    }
+}
+class VSCode extends AITool {
+    constructor() {
+        super(...arguments);
+        this.name = "VS Code";
+        this.toolType = "vscode";
+        this.configFileName = "mcp.json";
+        this.tip = `Tip: Press ${getPlatform() === "mac" ? "Cmd+Shift+I" : "Ctrl+Shift+I"} in VS Code to open the Copilot panel.\n`;
+    }
+    getServersKey() {
+        return "servers";
+    }
+    get configPath() {
+        const platform = getPlatform();
+        switch (platform) {
+            case "windows":
+                return path.join(getBasePath(), "Code", "User", "mcp.json");
+            case "mac":
+                return path.join(getBasePath(), "Library", "Application Support", "Code", "User", "mcp.json");
+            case "linux":
+                return path.join(getBasePath(), ".config", "Code", "User", "mcp.json");
+            default:
+                return "";
+        }
+    }
+    getOpenConfigCommand(configPath, platform) {
+        switch (platform) {
+            case "mac":
+                return getOpenCommandMac(configPath, "vscode");
+            case "windows":
+                return `code "${configPath}"`;
+            case "linux":
+                return getOpenCommandLinux(configPath, "vscode");
+            default:
+                return null;
+        }
+    }
+    get skillsAgentId() {
+        return "github-copilot";
+    }
+}
+class Windsurf extends AITool {
+    constructor() {
+        super(...arguments);
+        this.name = "Windsurf";
+        this.toolType = "windsurf";
+        this.configFileName = "mcp_config.json";
+        this.tip = `Tip: Press ${getPlatform() === "mac" ? "Cmd+L" : "Ctrl+L"} in Windsurf to open the AI panel.\n`;
+    }
+    get configPath() {
+        return path.join(getBasePath(true), ".codeium", "windsurf", "mcp_config.json");
+    }
+    getOpenConfigCommand(configPath, platform) {
+        switch (platform) {
+            case "mac":
+                return getOpenCommandMac(configPath, "windsurf");
+            case "windows":
+                return `windsurf "${configPath}"`;
+            case "linux":
+                return getOpenCommandLinux(configPath, "windsurf");
+            default:
+                return null;
+        }
+    }
+    get skillsAgentId() {
+        return "windsurf";
+    }
+}
+class ClaudeDesktop extends AITool {
+    constructor() {
+        super(...arguments);
+        this.name = "Claude Desktop";
+        this.toolType = "claudeDesktop";
+        this.configFileName = "claude_desktop_config.json";
+    }
+    get configPath() {
+        const platform = getPlatform();
+        switch (platform) {
+            case "windows":
+                return path.join(getBasePath(), "Claude", "claude_desktop_config.json");
+            case "mac":
+                return path.join(getBasePath(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
+            case "linux":
+                return path.join(getBasePath(), ".config", "Claude", "claude_desktop_config.json");
+            default:
+                return "";
+        }
+    }
+}
+class ClaudeCode extends AITool {
+    constructor() {
+        super(...arguments);
+        this.name = "Claude Code";
+        this.toolType = "claudeCode";
+        this.configFileName = ".claude.json";
+    }
+    get configPath() {
+        return path.join(getBasePath(true), ".claude.json");
+    }
+    get skillsAgentId() {
+        return "claude-code";
+    }
+}
+class OpenCode extends AITool {
+    constructor() {
+        super(...arguments);
+        this.name = "Open Code";
+        this.toolType = "opencode";
+        this.configFileName = "opencode.json";
+    }
+    get configPath() {
+        return path.join(getBasePath(true), ".config", "opencode", "opencode.json");
+    }
+    getServersKey() {
+        return "mcp";
+    }
+    getEnvironmentKey() {
+        return "environment";
+    }
+    buildMcpConfigEntry(isReadOnly, env) {
+        const args = ["-y", "mongodb-mcp-server@latest"];
+        if (isReadOnly) {
+            args.push("--readOnly");
+        }
+        return {
+            type: "local",
+            command: ["npx", ...args],
+            environment: Object.keys(env).length > 0 ? env : undefined,
+            enabled: true,
+        };
+    }
+    get skillsAgentId() {
+        return "opencode";
+    }
+}
+// Opens the config file for the given tool using the tool's platform-specific command.
+export const openConfigSettings = (tool) => {
+    return AI_TOOL_REGISTRY[tool].openConfigSettings();
+};
+export const AI_TOOL_REGISTRY = {
+    ["cursor"]: new Cursor(),
+    ["vscode"]: new VSCode(),
+    ["windsurf"]: new Windsurf(),
+    ["claudeDesktop"]: new ClaudeDesktop(),
+    ["claudeCode"]: new ClaudeCode(),
+    ["opencode"]: new OpenCode(),
+};
+//# sourceMappingURL=aiTool.js.map

package/dist/esm/setup/aiTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiTool.js","sourceRoot":"","sources":["../../../src/setup/aiTool.ts"],"names":[],"mappings":"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"}

package/dist/esm/setup/installSkills.d.ts

@@ -0,0 +1,42 @@
+import { type AIToolType } from "./aiTool.js";
+export type SkillsInstallOutcome = {
+    status: "installed";
+} | {
+    status: "skipped";
+    reason: "no-agent-id" | "user-declined";
+} | {
+    status: "failed";
+    exitCode: number;
+};
+export interface InstallSkillsOptions {
+    agentId: string;
+    cwd: string;
+}
+export interface PromptAndInstallSkillsOptions {
+    tool: AIToolType;
+    cwd: string;
+}
+export declare const NO_SKILLS_MESSAGE: string;
+/**
+ * Assemble the args for `npx` to invoke the pinned skills CLI. Skills are
+ * always installed globally (`-g`) so they're available across the user's
+ * projects, matching how the MCP server itself is installed.
+ */
+export declare function buildSkillsAddArgs(agentId: string): string[];
+/**
+ * Shell out to `skills add`.
+ * Non-zero exit is reported to the user but does not throw
+ * since setup has already succeeded by this point.
+ */
+export declare function installSkills(opts: InstallSkillsOptions): Promise<SkillsInstallOutcome>;
+/**
+ * Prompt the user for whether to install skills and call `installSkills`.
+ * Null-agent tools (Claude Desktop) skip prompts entirely.
+ *
+ * Never throws — except `ExitPromptError`, which is re-thrown so `runSetup`'s
+ * outer Ctrl+C handler can print "Setup cancelled". All other errors
+ * (unexpected prompt failure, etc.) are logged as warnings and converted to a
+ * `failed` outcome so setup can still print its success summary.
+ */
+export declare function promptAndInstallSkills(opts: PromptAndInstallSkillsOptions): Promise<SkillsInstallOutcome>;
+//# sourceMappingURL=installSkills.d.ts.map

package/dist/esm/setup/installSkills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installSkills.d.ts","sourceRoot":"","sources":["../../../src/setup/installSkills.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,MAAM,oBAAoB,GAC1B;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,aAAa,GAAG,eAAe,CAAA;CAAE,GAC9D;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,6BAA6B;IAC1C,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACf;AAID,eAAO,MAAM,iBAAiB,QAKJ,CAAC;AAK3B;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAE5D;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAU7F;AAgDD;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA4B/G"}

package/dist/esm/setup/installSkills.js

@@ -0,0 +1,113 @@
+/* eslint-disable no-console */
+import { spawn } from "node:child_process";
+import chalk from "chalk";
+import { confirm } from "@inquirer/prompts";
+import { AI_TOOL_REGISTRY } from "./aiTool.js";
+const SKILLS_REPO = "mongodb/agent-skills";
+const SKILLS_REPO_URL = `https://github.com/${SKILLS_REPO}`;
+export const NO_SKILLS_MESSAGE = `We're unable to install the MongoDB Agent Skills for this tool.\n` +
+    `\n` +
+    `See the MongoDB Agent Skills repo for manual install instructions:\n` +
+    `\n` +
+    `  ${SKILLS_REPO_URL}`;
+const SKILLS_PACKAGE_VERSION = "1";
+const SKILLS_CLI_PIN = `skills@${SKILLS_PACKAGE_VERSION}`;
+/**
+ * Assemble the args for `npx` to invoke the pinned skills CLI. Skills are
+ * always installed globally (`-g`) so they're available across the user's
+ * projects, matching how the MCP server itself is installed.
+ */
+export function buildSkillsAddArgs(agentId) {
+    return ["--yes", SKILLS_CLI_PIN, "add", SKILLS_REPO, "--agent", agentId, "-y", "-g"];
+}
+/**
+ * Shell out to `skills add`.
+ * Non-zero exit is reported to the user but does not throw
+ * since setup has already succeeded by this point.
+ */
+export async function installSkills(opts) {
+    const args = buildSkillsAddArgs(opts.agentId);
+    const exitCode = await runSkillsAdd(args, opts.cwd);
+    if (exitCode === 0) {
+        return { status: "installed" };
+    }
+    printInstallFailure(exitCode, args);
+    return { status: "failed", exitCode };
+}
+// Sentinel exit code used when `spawn` itself fails before the process runs
+// (e.g. `npx` not on PATH). Real exit codes are 0–255, so -1 is unambiguous.
+const SPAWN_ERROR_EXIT_CODE = -1;
+function runSkillsAdd(args, cwd) {
+    return new Promise((resolve) => {
+        // `shell: true` is required on Windows so `npx` (a `.cmd` shim) resolves
+        // through PATHEXT. Our args are controlled and contain no shell
+        // metacharacters, so there's no injection risk.
+        const child = spawn("npx", args, { stdio: "inherit", cwd, shell: true });
+        child.on("close", (code, signal) => {
+            if (signal !== null) {
+                // Killed by a signal (Ctrl+C, OOM, etc.). `code` is null in this
+                // case, so falling through to `code ?? 0` would mis-report the
+                // install as successful. Surface it as a non-zero sentinel.
+                console.error(chalk.red(`The skills CLI was terminated by signal ${signal}.`));
+                resolve(SPAWN_ERROR_EXIT_CODE);
+                return;
+            }
+            resolve(code ?? 0);
+        });
+        child.on("error", (err) => {
+            // Spawn-level error (npx missing, etc.). Print the message ourselves
+            // — nothing streamed to stderr because the process never started —
+            // then surface as a non-zero exit so the graceful-failure path runs.
+            console.error(chalk.red(`Failed to spawn the skills CLI: ${err.message}`));
+            resolve(SPAWN_ERROR_EXIT_CODE);
+        });
+    });
+}
+function printInstallFailure(exitCode, args) {
+    console.log("");
+    console.log(chalk.red(`Agent skills install failed (exit ${exitCode}). Setup completed, but skills were not installed. See the CLI output above for details.`));
+    console.log("");
+    console.log("You can retry manually:");
+    console.log(`  npx ${args.join(" ")}`);
+    console.log("");
+    console.log(`Skills repo: ${SKILLS_REPO_URL}`);
+    console.log("");
+}
+/**
+ * Prompt the user for whether to install skills and call `installSkills`.
+ * Null-agent tools (Claude Desktop) skip prompts entirely.
+ *
+ * Never throws — except `ExitPromptError`, which is re-thrown so `runSetup`'s
+ * outer Ctrl+C handler can print "Setup cancelled". All other errors
+ * (unexpected prompt failure, etc.) are logged as warnings and converted to a
+ * `failed` outcome so setup can still print its success summary.
+ */
+export async function promptAndInstallSkills(opts) {
+    try {
+        const tool = AI_TOOL_REGISTRY[opts.tool];
+        const agentId = tool.skillsAgentId;
+        if (agentId === null) {
+            console.log(NO_SKILLS_MESSAGE);
+            return { status: "skipped", reason: "no-agent-id" };
+        }
+        const shouldInstall = await confirm({
+            message: `Install the MongoDB Agent Skills for ${tool.name}?`,
+            default: true,
+        });
+        if (!shouldInstall) {
+            return { status: "skipped", reason: "user-declined" };
+        }
+        return await installSkills({ agentId, cwd: opts.cwd });
+    }
+    catch (error) {
+        // Ctrl+C: inquirer throws ExitPromptError. Let it propagate so the
+        // top-level runSetup handler can exit cleanly.
+        if (error && typeof error === "object" && "name" in error && error.name === "ExitPromptError") {
+            throw error;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(chalk.yellow(`\nWarning: skills install step failed: ${message}`));
+        return { status: "failed", exitCode: SPAWN_ERROR_EXIT_CODE };
+    }
+}
+//# sourceMappingURL=installSkills.js.map

package/dist/esm/setup/installSkills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installSkills.js","sourceRoot":"","sources":["../../../src/setup/installSkills.ts"],"names":[],"mappings":"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"}

package/dist/esm/setup/setupAiToolsUtils.d.ts

@@ -0,0 +1,4 @@
+export type Platform = "mac" | "windows" | "linux";
+export declare const getPlatform: () => Platform | null;
+export declare const formatError: (error: unknown) => string;
+//# sourceMappingURL=setupAiToolsUtils.d.ts.map

package/dist/esm/setup/setupAiToolsUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupAiToolsUtils.d.ts","sourceRoot":"","sources":["../../../src/setup/setupAiToolsUtils.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC;AACnD,eAAO,MAAM,WAAW,QAAO,QAAQ,GAAG,IAWzC,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,MAG5C,CAAC"}

package/dist/esm/setup/setupAiToolsUtils.js

@@ -0,0 +1,20 @@
+import os from "os";
+import { Keychain } from "../common/keychain.js";
+import { redact } from "mongodb-redact";
+export const getPlatform = () => {
+    switch (os.platform()) {
+        case "win32":
+            return "windows";
+        case "darwin":
+            return "mac";
+        case "linux":
+            return "linux";
+        default:
+            return null;
+    }
+};
+export const formatError = (error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    return redact(message, Keychain.root.allSecrets);
+};
+//# sourceMappingURL=setupAiToolsUtils.js.map

package/dist/esm/setup/setupAiToolsUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupAiToolsUtils.js","sourceRoot":"","sources":["../../../src/setup/setupAiToolsUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC,MAAM,CAAC,MAAM,WAAW,GAAG,GAAoB,EAAE;IAC7C,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;QACpB,KAAK,OAAO;YACR,OAAO,SAAS,CAAC;QACrB,KAAK,QAAQ;YACT,OAAO,KAAK,CAAC;QACjB,KAAK,OAAO;YACR,OAAO,OAAO,CAAC;QACnB;YACI,OAAO,IAAI,CAAC;IACpB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAU,EAAE;IAClD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACrD,CAAC,CAAC"}

package/dist/esm/setup/setupMcpServer.d.ts

@@ -0,0 +1,8 @@
+import { type UserConfig } from "../common/config/userConfig.js";
+/**
+ * Runs the interactive setup wizard. When `setupTelemetry` is provided, each
+ * logical step emits a telemetry event so we can track both overall completion
+ * rates and per-step drop-off.
+ */
+export declare const runSetup: (config: UserConfig) => Promise<never>;
+//# sourceMappingURL=setupMcpServer.d.ts.map

package/dist/esm/setup/setupMcpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupMcpServer.d.ts","sourceRoot":"","sources":["../../../src/setup/setupMcpServer.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAuYjE;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAU,QAAQ,UAAU,KAAG,OAAO,CAAC,KAAK,CAoHhE,CAAC"}