mongodb-mcp-server 1.1.0 → 1.3.0-pre.1

package/dist/cjs/common/config/configUtils.d.ts

@@ -0,0 +1,43 @@
+export type CustomOverrideLogic = (oldValue: unknown, newValue: unknown) => unknown;
+/**
+ * Defines how a config field can be overridden via HTTP headers or query parameters.
+ */
+export type OverrideBehavior = "not-allowed" | "override" | "merge" | CustomOverrideLogic;
+/**
+ * Metadata for config schema fields.
+ */
+export type ConfigFieldMeta = {
+    /**
+     * Custom description for the default value, used when generating documentation.
+     */
+    defaultValueDescription?: string;
+    /**
+     * Marks the field as containing sensitive/secret information, used for MCP Registry.
+     * Secret fields will be marked as secret in environment variable definitions.
+     */
+    isSecret?: boolean;
+    /**
+     * Defines how this config field can be overridden via HTTP headers or query parameters.
+     * Defaults to "not-allowed" for security.
+     */
+    overrideBehavior?: OverrideBehavior;
+    [key: string]: unknown;
+};
+export declare function matchingConfigKey(key: string): string | undefined;
+export declare function isConnectionSpecifier(arg: string | undefined): boolean;
+export declare function getLocalDataPath(): string;
+export declare function getLogPath(): string;
+export declare function getExportsPath(): string;
+export declare function commaSeparatedToArray<T extends string[]>(str: string | string[] | undefined): T | undefined;
+/**
+ * Preprocessor for boolean values that handles string "false"/"0" correctly.
+ * Zod's coerce.boolean() treats any non-empty string as true, which is not what we want.
+ */
+export declare function parseBoolean(val: unknown): unknown;
+/** Allow overriding only to the allowed value */
+export declare function oneWayOverride<T>(allowedValue: T): CustomOverrideLogic;
+/** Allow overriding only to a value lower than the specified value */
+export declare function onlyLowerThanBaseValueOverride(): CustomOverrideLogic;
+/** Allow overriding only to a subset of an array but not a superset */
+export declare function onlySubsetOfBaseValueOverride(): CustomOverrideLogic;
+//# sourceMappingURL=configUtils.d.ts.map

package/dist/cjs/common/config/configUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configUtils.d.ts","sourceRoot":"","sources":["../../../../src/common/config/configUtils.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC;AAEpF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAEtB,aAAa,GAEb,UAAU,GAEV,OAAO,GACP,mBAAmB,CAAC;AAE1B;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B;;OAEG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAcjE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAUtE;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAIzC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,CAAC,GAAG,SAAS,CAoB3G;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAoBlD;AAED,iDAAiD;AACjD,wBAAgB,cAAc,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,mBAAmB,CAWtE;AAED,sEAAsE;AACtE,wBAAgB,8BAA8B,IAAI,mBAAmB,CAapE;AAED,uEAAuE;AACvE,wBAAgB,6BAA6B,IAAI,mBAAmB,CAgBnE"}

package/dist/cjs/common/config/configUtils.js

@@ -0,0 +1,178 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchingConfigKey = matchingConfigKey;
+exports.isConnectionSpecifier = isConnectionSpecifier;
+exports.getLocalDataPath = getLocalDataPath;
+exports.getLogPath = getLogPath;
+exports.getExportsPath = getExportsPath;
+exports.commaSeparatedToArray = commaSeparatedToArray;
+exports.parseBoolean = parseBoolean;
+exports.oneWayOverride = oneWayOverride;
+exports.onlyLowerThanBaseValueOverride = onlyLowerThanBaseValueOverride;
+exports.onlySubsetOfBaseValueOverride = onlySubsetOfBaseValueOverride;
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const argsParserOptions_js_1 = require("./argsParserOptions.js");
+const levenshteinModule = __importStar(require("ts-levenshtein"));
+const levenshtein = levenshteinModule.default;
+function matchingConfigKey(key) {
+    let minLev = Number.MAX_VALUE;
+    let suggestion = undefined;
+    for (const validKey of argsParserOptions_js_1.ALL_CONFIG_KEYS) {
+        const lev = levenshtein.get(key, validKey);
+        // Accepting upto 2 typos and should be better than whatever previous
+        // suggestion was.
+        if (lev <= 2 && lev < minLev) {
+            minLev = lev;
+            suggestion = validKey;
+        }
+    }
+    return suggestion;
+}
+function isConnectionSpecifier(arg) {
+    return (arg !== undefined &&
+        (arg.startsWith("mongodb://") ||
+            arg.startsWith("mongodb+srv://") ||
+            // Strings starting with double hyphens `--` are generally a sign of
+            // CLI flag so we exclude them from the possibility of being a
+            // connection specifier.
+            !(arg.endsWith(".js") || arg.endsWith(".mongodb") || arg.startsWith("--"))));
+}
+function getLocalDataPath() {
+    return process.platform === "win32"
+        ? path_1.default.join(process.env.LOCALAPPDATA || process.env.APPDATA || os_1.default.homedir(), "mongodb")
+        : path_1.default.join(os_1.default.homedir(), ".mongodb");
+}
+function getLogPath() {
+    const logPath = path_1.default.join(getLocalDataPath(), "mongodb-mcp", ".app-logs");
+    return logPath;
+}
+function getExportsPath() {
+    return path_1.default.join(getLocalDataPath(), "mongodb-mcp", "exports");
+}
+function commaSeparatedToArray(str) {
+    if (str === undefined) {
+        return undefined;
+    }
+    if (typeof str === "string") {
+        return str
+            .split(",")
+            .map((e) => e.trim())
+            .filter((e) => e.length > 0);
+    }
+    if (str.length === 1) {
+        return str[0]
+            ?.split(",")
+            .map((e) => e.trim())
+            .filter((e) => e.length > 0);
+    }
+    return str;
+}
+/**
+ * Preprocessor for boolean values that handles string "false"/"0" correctly.
+ * Zod's coerce.boolean() treats any non-empty string as true, which is not what we want.
+ */
+function parseBoolean(val) {
+    if (val === undefined) {
+        return undefined;
+    }
+    if (typeof val === "string") {
+        if (val === "false") {
+            return false;
+        }
+        if (val === "true") {
+            return true;
+        }
+        throw new Error(`Invalid boolean value: ${val}`);
+    }
+    if (typeof val === "boolean") {
+        return val;
+    }
+    if (typeof val === "number") {
+        return val !== 0;
+    }
+    return !!val;
+}
+/** Allow overriding only to the allowed value */
+function oneWayOverride(allowedValue) {
+    return (oldValue, newValue) => {
+        // Only allow override if setting to allowed value or current value
+        if (newValue === oldValue) {
+            return newValue;
+        }
+        if (newValue === allowedValue) {
+            return newValue;
+        }
+        throw new Error(`Can only set to ${String(allowedValue)}`);
+    };
+}
+/** Allow overriding only to a value lower than the specified value */
+function onlyLowerThanBaseValueOverride() {
+    return (oldValue, newValue) => {
+        if (typeof oldValue !== "number") {
+            throw new Error(`Unsupported type for base value for override: ${typeof oldValue}`);
+        }
+        if (typeof newValue !== "number") {
+            throw new Error(`Unsupported type for new value for override: ${typeof newValue}`);
+        }
+        if (newValue >= oldValue) {
+            throw new Error(`Can only set to a value lower than the base value`);
+        }
+        return newValue;
+    };
+}
+/** Allow overriding only to a subset of an array but not a superset */
+function onlySubsetOfBaseValueOverride() {
+    return (oldValue, newValue) => {
+        if (!Array.isArray(oldValue)) {
+            throw new Error(`Unsupported type for base value for override: ${typeof oldValue}`);
+        }
+        if (!Array.isArray(newValue)) {
+            throw new Error(`Unsupported type for new value for override: ${typeof newValue}`);
+        }
+        if (newValue.length > oldValue.length) {
+            throw new Error(`Can only override to a subset of the base value`);
+        }
+        if (!newValue.every((value) => oldValue.includes(value))) {
+            throw new Error(`Can only override to a subset of the base value`);
+        }
+        return newValue;
+    };
+}
+//# sourceMappingURL=configUtils.js.map

package/dist/cjs/common/config/configUtils.js.map

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

package/dist/cjs/common/config/createUserConfig.d.ts

@@ -0,0 +1,10 @@
+import { type UserConfig } from "./userConfig.js";
+export type CreateUserConfigHelpers = {
+    onWarning: (message: string) => void;
+    onError: (message: string) => void;
+    closeProcess: (exitCode: number) => never;
+    cliArguments: string[];
+};
+export declare const defaultUserConfigHelpers: CreateUserConfigHelpers;
+export declare function createUserConfig({ onWarning, onError, closeProcess, cliArguments, }?: Partial<CreateUserConfigHelpers>): UserConfig;
+//# sourceMappingURL=createUserConfig.d.ts.map

package/dist/cjs/common/config/createUserConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUserConfig.d.ts","sourceRoot":"","sources":["../../../../src/common/config/createUserConfig.ts"],"names":[],"mappings":"AAMA,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEpE,MAAM,MAAM,uBAAuB,GAAG;IAClC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,KAAK,CAAC;IAC1C,YAAY,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,uBAWtC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,EAC7B,SAA8C,EAC9C,OAA0C,EAC1C,YAAoD,EACpD,YAAoD,GACvD,GAAE,OAAO,CAAC,uBAAuB,CAA4B,GAAG,UAAU,CA4C1E"}

package/dist/cjs/common/config/createUserConfig.js

@@ -0,0 +1,156 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultUserConfigHelpers = void 0;
+exports.createUserConfig = createUserConfig;
+const yargs_parser_1 = __importDefault(require("yargs-parser"));
+const arg_parser_1 = require("@mongosh/arg-parser");
+const keychain_js_1 = require("../keychain.js");
+const configUtils_js_1 = require("./configUtils.js");
+const argsParserOptions_js_1 = require("./argsParserOptions.js");
+const userConfig_js_1 = require("./userConfig.js");
+exports.defaultUserConfigHelpers = {
+    onWarning(message) {
+        console.warn(message);
+    },
+    onError(message) {
+        console.error(message);
+    },
+    closeProcess(exitCode) {
+        process.exit(exitCode);
+    },
+    cliArguments: process.argv.slice(2),
+};
+function createUserConfig({ onWarning = exports.defaultUserConfigHelpers.onWarning, onError = exports.defaultUserConfigHelpers.onError, closeProcess = exports.defaultUserConfigHelpers.closeProcess, cliArguments = exports.defaultUserConfigHelpers.cliArguments, } = exports.defaultUserConfigHelpers) {
+    const { unknownCliArgumentErrors, deprecatedCliArgumentWarning, userAndArgsParserConfig, connectionSpecifier } = parseUserConfigSources(cliArguments);
+    if (unknownCliArgumentErrors.length) {
+        const errorMessage = `
+${unknownCliArgumentErrors.join("\n")}
+- Refer to https://www.mongodb.com/docs/mcp-server/get-started/ for setting up the MCP Server.
+`;
+        onError(errorMessage);
+        return closeProcess(1);
+    }
+    if (deprecatedCliArgumentWarning) {
+        const deprecatedMessages = `
+${deprecatedCliArgumentWarning}
+- Refer to https://www.mongodb.com/docs/mcp-server/get-started/ for setting up the MCP Server.
+`;
+        onWarning(deprecatedMessages);
+    }
+    // If we have a connectionSpecifier, which can only appear as the positional
+    // argument, then that has to be used on priority to construct the
+    // connection string. In this case, if there is a connection string provided
+    // by the env variable or config file, that will be overridden.
+    if (connectionSpecifier) {
+        const connectionInfo = (0, arg_parser_1.generateConnectionInfoFromCliArgs)({ ...userAndArgsParserConfig, connectionSpecifier });
+        userAndArgsParserConfig.connectionString = connectionInfo.connectionString;
+    }
+    const configParseResult = userConfig_js_1.UserConfigSchema.safeParse(userAndArgsParserConfig);
+    if (configParseResult.error) {
+        onError(`Invalid configuration for the following fields:\n${configParseResult.error.issues.map((issue) => `${issue.path.join(".")} - ${issue.message}`).join("\n")}`);
+        return closeProcess(1);
+    }
+    // TODO: Separate correctly parsed user config from all other valid
+    // arguments relevant to mongosh's args-parser.
+    const userConfig = { ...userAndArgsParserConfig, ...configParseResult.data };
+    warnIfVectorSearchNotEnabledCorrectly(userConfig, onWarning);
+    registerKnownSecretsInRootKeychain(userConfig);
+    return userConfig;
+}
+function parseUserConfigSources(cliArguments) {
+    const { _: positionalAndUnknownArguments, 
+    // We don't make use of end of flag arguments but also don't want them to
+    // end up alongside unknown arguments so we are extracting them and having a
+    // no-op statement so ESLint does not complain.
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    "--": _endOfFlagArguments, ...parsedUserAndArgsParserConfig } = (0, yargs_parser_1.default)(cliArguments, {
+        ...argsParserOptions_js_1.OPTIONS,
+        // This helps parse the relevant environment variables.
+        envPrefix: "MDB_MCP_",
+        configuration: {
+            ...argsParserOptions_js_1.OPTIONS.configuration,
+            // Setting this to true will populate `_` variable which is
+            // originally used for positional arguments, now with the unknown
+            // arguments as well. The order of arguments are maintained.
+            "unknown-options-as-args": true,
+            // To avoid populating `_` with end-of-flag arguments we explicitly
+            // populate `--` variable and altogether ignore them later.
+            "populate--": true,
+        },
+    });
+    // A connectionSpecifier can be one of:
+    // - database name
+    // - host name
+    // - ip address
+    // - replica set specifier
+    // - complete connection string
+    let connectionSpecifier = undefined;
+    const [maybeConnectionSpecifier, ...unknownArguments] = positionalAndUnknownArguments;
+    if (typeof maybeConnectionSpecifier === "string" && (0, configUtils_js_1.isConnectionSpecifier)(maybeConnectionSpecifier)) {
+        connectionSpecifier = maybeConnectionSpecifier;
+    }
+    else if (maybeConnectionSpecifier !== undefined) {
+        // If the extracted connection specifier is not a connection specifier
+        // indeed, then we push it back to the unknown arguments list. This might
+        // happen for example when an unknown argument is provided without ever
+        // specifying a positional argument.
+        unknownArguments.unshift(maybeConnectionSpecifier);
+    }
+    return {
+        unknownCliArgumentErrors: unknownArguments
+            .filter((argument) => typeof argument === "string" && argument.startsWith("--"))
+            .map((argument) => {
+            const argumentKey = argument.replace(/^(--)/, "");
+            const matchingKey = (0, configUtils_js_1.matchingConfigKey)(argumentKey);
+            if (matchingKey) {
+                return `Error: Invalid command line argument '${argument}'. Did you mean '--${matchingKey}'?`;
+            }
+            return `Error: Invalid command line argument '${argument}'.`;
+        }),
+        deprecatedCliArgumentWarning: cliArguments.find((argument) => argument.startsWith("--connectionString"))
+            ? "Warning: The --connectionString argument is deprecated. Prefer using the MDB_MCP_CONNECTION_STRING environment variable or the first positional argument for the connection string."
+            : undefined,
+        userAndArgsParserConfig: parsedUserAndArgsParserConfig,
+        connectionSpecifier,
+    };
+}
+function registerKnownSecretsInRootKeychain(userConfig) {
+    const keychain = keychain_js_1.Keychain.root;
+    const maybeRegister = (value, kind) => {
+        if (value) {
+            keychain.register(value, kind);
+        }
+    };
+    maybeRegister(userConfig.apiClientId, "user");
+    maybeRegister(userConfig.apiClientSecret, "password");
+    maybeRegister(userConfig.awsAccessKeyId, "password");
+    maybeRegister(userConfig.awsIamSessionToken, "password");
+    maybeRegister(userConfig.awsSecretAccessKey, "password");
+    maybeRegister(userConfig.awsSessionToken, "password");
+    maybeRegister(userConfig.password, "password");
+    maybeRegister(userConfig.tlsCAFile, "url");
+    maybeRegister(userConfig.tlsCRLFile, "url");
+    maybeRegister(userConfig.tlsCertificateKeyFile, "url");
+    maybeRegister(userConfig.tlsCertificateKeyFilePassword, "password");
+    maybeRegister(userConfig.username, "user");
+}
+function warnIfVectorSearchNotEnabledCorrectly(config, warn) {
+    const searchEnabled = config.previewFeatures.includes("search");
+    const embeddingsProviderConfigured = !!config.voyageApiKey;
+    if (searchEnabled && !embeddingsProviderConfigured) {
+        warn(`\
+Warning: Vector search is enabled but no embeddings provider is configured.
+- Set an embeddings provider configuration option to enable auto-embeddings during document insertion and text-based queries with $vectorSearch.\
+`);
+    }
+    if (!searchEnabled && embeddingsProviderConfigured) {
+        warn(`\
+Warning: An embeddings provider is configured but the 'search' preview feature is not enabled.
+- Enable vector search by adding 'search' to the 'previewFeatures' configuration option, or remove the embeddings provider configuration if not needed.\
+`);
+    }
+}
+//# sourceMappingURL=createUserConfig.js.map

package/dist/cjs/common/config/createUserConfig.js.map

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

package/dist/cjs/common/config/userConfig.d.ts

@@ -0,0 +1,54 @@
+import { z as z4 } from "zod/v4";
+import { type CliOptions } from "@mongosh/arg-parser";
+import { type ConfigFieldMeta } from "./configUtils.js";
+export type UserConfig = z4.infer<typeof UserConfigSchema> & CliOptions;
+export declare const configRegistry: z4.core.$ZodRegistry<ConfigFieldMeta, z4.core.$ZodType<unknown, unknown, z4.core.$ZodTypeInternals<unknown, unknown>>>;
+export declare const UserConfigSchema: z4.ZodObject<{
+    apiBaseUrl: z4.ZodDefault<z4.ZodString>;
+    apiClientId: z4.ZodOptional<z4.ZodString>;
+    apiClientSecret: z4.ZodOptional<z4.ZodString>;
+    connectionString: z4.ZodOptional<z4.ZodString>;
+    loggers: z4.ZodDefault<z4.ZodPipe<z4.ZodTransform<string[] | undefined, string | string[] | undefined>, z4.ZodArray<z4.ZodEnum<{
+        disk: "disk";
+        mcp: "mcp";
+        stderr: "stderr";
+    }>>>>;
+    logPath: z4.ZodDefault<z4.ZodString>;
+    disabledTools: z4.ZodDefault<z4.ZodPipe<z4.ZodTransform<string[] | undefined, string | string[] | undefined>, z4.ZodArray<z4.ZodString>>>;
+    confirmationRequiredTools: z4.ZodDefault<z4.ZodPipe<z4.ZodTransform<string[] | undefined, string | string[] | undefined>, z4.ZodArray<z4.ZodString>>>;
+    readOnly: z4.ZodDefault<z4.ZodPipe<z4.ZodTransform<unknown, unknown>, z4.ZodBoolean>>;
+    indexCheck: z4.ZodDefault<z4.ZodPipe<z4.ZodTransform<unknown, unknown>, z4.ZodBoolean>>;
+    telemetry: z4.ZodDefault<z4.ZodEnum<{
+        enabled: "enabled";
+        disabled: "disabled";
+    }>>;
+    transport: z4.ZodDefault<z4.ZodEnum<{
+        stdio: "stdio";
+        http: "http";
+    }>>;
+    httpPort: z4.ZodDefault<z4.ZodCoercedNumber<unknown>>;
+    httpHost: z4.ZodDefault<z4.ZodString>;
+    httpHeaders: z4.ZodDefault<z4.ZodObject<{}, z4.core.$loose>>;
+    idleTimeoutMs: z4.ZodDefault<z4.ZodCoercedNumber<unknown>>;
+    notificationTimeoutMs: z4.ZodDefault<z4.ZodCoercedNumber<unknown>>;
+    maxBytesPerQuery: z4.ZodDefault<z4.ZodCoercedNumber<unknown>>;
+    maxDocumentsPerQuery: z4.ZodDefault<z4.ZodCoercedNumber<unknown>>;
+    exportsPath: z4.ZodDefault<z4.ZodString>;
+    exportTimeoutMs: z4.ZodDefault<z4.ZodCoercedNumber<unknown>>;
+    exportCleanupIntervalMs: z4.ZodDefault<z4.ZodCoercedNumber<unknown>>;
+    atlasTemporaryDatabaseUserLifetimeMs: z4.ZodDefault<z4.ZodCoercedNumber<unknown>>;
+    voyageApiKey: z4.ZodDefault<z4.ZodString>;
+    embeddingsValidation: z4.ZodDefault<z4.ZodPipe<z4.ZodTransform<unknown, unknown>, z4.ZodBoolean>>;
+    vectorSearchDimensions: z4.ZodDefault<z4.ZodCoercedNumber<unknown>>;
+    vectorSearchSimilarityFunction: z4.ZodDefault<z4.ZodEnum<{
+        cosine: "cosine";
+        euclidean: "euclidean";
+        dotProduct: "dotProduct";
+    }>>;
+    previewFeatures: z4.ZodDefault<z4.ZodPipe<z4.ZodTransform<string[] | undefined, string | string[] | undefined>, z4.ZodArray<z4.ZodEnum<{
+        search: "search";
+    }>>>>;
+    allowRequestOverrides: z4.ZodDefault<z4.ZodPipe<z4.ZodTransform<unknown, unknown>, z4.ZodBoolean>>;
+    dryRun: z4.ZodDefault<z4.ZodBoolean>;
+}, z4.core.$strip>;
+//# sourceMappingURL=userConfig.d.ts.map

package/dist/cjs/common/config/userConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userConfig.d.ts","sourceRoot":"","sources":["../../../../src/common/config/userConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EACH,KAAK,eAAe,EAQvB,MAAM,kBAAkB,CAAC;AAM1B,MAAM,MAAM,UAAU,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,GAAG,UAAU,CAAC;AAExE,eAAO,MAAM,cAAc,wHAAiC,CAAC;AAE7D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0M3B,CAAC"}