mongodb-mcp-server 2.1.0 → 3.0.0-prerelease.1

package/dist/esm/tools/mongodb/mongodbTool.d.ts

@@ -1,87 +0,0 @@
-import { z } from "zod";
-import type { ToolArgs, ToolCategory, ToolExecutionContext } from "../tool.js";
-import { ToolBase } from "../tool.js";
-import type { NodeDriverServiceProvider } from "@mongosh/service-provider-node-driver";
-import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-import type { ConnectionEntry } from "../../common/connectionRegistry.js";
-import type { Server } from "../../server.js";
-import type { ConnectionMetadata } from "../../telemetry/types.js";
-import { type WriteStageTarget } from "../../helpers/mqlGuards.js";
-export declare const DBOperationArgs: {
-    database: z.ZodString;
-};
-export declare const CollOperationArgs: {
-    collection: z.ZodString;
-    database: z.ZodString;
-};
-export declare const ConnectionIdArgs: {
-    connectionId: z.ZodString;
-};
-export declare abstract class MongoDBToolBase extends ToolBase {
-    protected server?: Server;
-    static category: ToolCategory;
-    protected get isExportToolAvailable(): boolean;
-    /**
-     * Resolves the required `connectionId` argument to a live service provider
-     * via the app-level connection registry. There is deliberately no implicit
-     * "current connection" fallback — see the connection-handles proposal.
-     */
-    protected resolveConnection(connectionId: string): Promise<NodeDriverServiceProvider>;
-    /** The registry entry for the given connectionId, if it exists. Does not affect LRU ordering. */
-    protected peekConnection(connectionId: string | undefined): Promise<ConnectionEntry | undefined>;
-    protected isSearchSupported(connectionId: string): Promise<boolean>;
-    protected assertSearchSupported(connectionId: string): Promise<void>;
-    /**
-     * Returns common operation options (signal, maxTimeMS) to pass to service provider methods.
-     * If `maxTimeMS` is configured, it will be included in the returned options.
-     */
-    protected getOperationOptions(signal?: AbortSignal): {
-        signal?: AbortSignal;
-        maxTimeMS?: number;
-    };
-    /**
-     * Rejects the operation when the provided MQL input is not permitted by the
-     * current configuration:
-     *  - server-side JavaScript operators (such as $where, $function, or
-     *    $accumulator) are rejected when the `disableServerSideJs` configuration
-     *    option is enabled. This applies to both query filters and aggregation
-     *    pipelines.
-     *  - aggregation pipelines containing a write stage ($out or $merge) are
-     *    rejected in readOnly mode or when create/update/delete operations are
-     *    disabled. This prevents read-oriented tools such as aggregate and
-     *    export from being used to circumvent those restrictions.
-     *
-     * Write stages only exist in aggregation pipelines, which are passed as an
-     * array, so that check is skipped for plain query filters.
-     *
-     * Pass every operator-bearing fragment that reaches the server (e.g. filter
-     * and projection for a find), since each is validated independently.
-     */
-    protected assertMqlIsAllowed(...values: (Record<string, unknown> | Record<string, unknown>[] | undefined)[]): void;
-    /**
-     * Asks the user to confirm the write stages of an aggregation pipeline,
-     * throwing when they decline so that the pipeline never runs.
-     */
-    protected confirmWriteStages(targets: WriteStageTarget[], context: ToolExecutionContext): Promise<void>;
-    private assertSingleMqlValueIsAllowed;
-    /**
-     * The connectionId description varies by whether a connection string is
-     * preconfigured, so cache each variant's shape separately.
-     */
-    protected schemaVariantKey(): string;
-    register(server: Server): boolean;
-    protected handleError(error: unknown, args: ToolArgs<typeof this.argsShape>): Promise<CallToolResult>;
-    /**
-     * Resolves the tool metadata from the arguments passed to the mongoDB tools.
-     *
-     * Since MongoDB tools are executed against a MongoDB instance, the tool calls will always have the connection information.
-     *
-     * @param result - The result of the tool call.
-     * @param args - The arguments passed to the tool
-     * @returns The tool metadata
-     */
-    protected resolveTelemetryMetadata(args: ToolArgs<typeof this.argsShape>, { result }: {
-        result: CallToolResult;
-    }): Promise<ConnectionMetadata>;
-}
-//# sourceMappingURL=mongodbTool.d.ts.map

package/dist/esm/tools/mongodb/mongodbTool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mongodbTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/mongodb/mongodbTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAiB,QAAQ,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC9F,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAsC,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAIvG,eAAO,MAAM,eAAe;;CAE3B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;CAG7B,CAAC;AASF,eAAO,MAAM,gBAAgB;;CAE5B,CAAC;AAQF,8BAAsB,eAAgB,SAAQ,QAAQ;IAClD,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAa;IAE1C,SAAS,KAAK,qBAAqB,IAAI,OAAO,CAI7C;IAED;;;;OAIG;cACa,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAI3F,iGAAiG;cACjF,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;cAItF,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;cAKzD,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1E;;;OAGG;IACH,SAAS,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAOjG;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,CAAC,kBAAkB,CAAC,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,GAAG,IAAI;IAMlH;;;OAGG;cACa,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7G,OAAO,CAAC,6BAA6B;IAgCrC;;;OAGG;cACgB,gBAAgB,IAAI,MAAM;IAOtC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;cAaxB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAoD3G;;;;;;;;OAQG;cACa,wBAAwB,CACpC,IAAI,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,EAErC,EAAE,MAAM,EAAE,EAAE;QAAE,MAAM,EAAE,cAAc,CAAA;KAAE,GACvC,OAAO,CAAC,kBAAkB,CAAC;CAOjC"}

package/dist/esm/tools/mongodb/mongodbTool.js

@@ -1,215 +0,0 @@
-import { z } from "zod";
-import { ToolBase } from "../tool.js";
-import { ErrorCodes, MongoDBError } from "../../common/errors.js";
-import { assertNoServerSideJS, isWriteStage } from "../../helpers/mqlGuards.js";
-import { buildWriteStageConfirmationMessage } from "../../helpers/writeStageConfirmation.js";
-import { EXPORT_TOOL_NAME } from "../../helpers/constants.js";
-export const DBOperationArgs = {
-    database: z.string().describe("Database name"),
-};
-export const CollOperationArgs = {
-    ...DBOperationArgs,
-    collection: z.string().describe("Collection name"),
-};
-function connectionIdDescription({ hasPreconfiguredConnection }) {
-    const preconfigured = hasPreconfiguredConnection
-        ? ', or "preconfigured" to use the connection string the server was configured with'
-        : "";
-    return `The connection to run the operation against. Use the id returned by one of the connect tools${preconfigured}.`;
-}
-export const ConnectionIdArgs = {
-    connectionId: z.string().describe(connectionIdDescription({ hasPreconfiguredConnection: true })),
-};
-// Shared leaf for the variant advertised when no connection string is configured.
-// Precomputed once so the register()-time swap reuses it instead of rebuilding.
-const connectionIdArgWithoutPreconfigured = z
-    .string()
-    .describe(connectionIdDescription({ hasPreconfiguredConnection: false }));
-export class MongoDBToolBase extends ToolBase {
-    get isExportToolAvailable() {
-        const registeredTools = this.server?.tools ?? [];
-        const exportTool = registeredTools.find((tool) => tool.name === EXPORT_TOOL_NAME);
-        return exportTool?.isEnabled() ?? false;
-    }
-    /**
-     * Resolves the required `connectionId` argument to a live service provider
-     * via the app-level connection registry. There is deliberately no implicit
-     * "current connection" fallback — see the connection-handles proposal.
-     */
-    async resolveConnection(connectionId) {
-        return this.session.connectionRegistry.resolve(connectionId);
-    }
-    /** The registry entry for the given connectionId, if it exists. Does not affect LRU ordering. */
-    async peekConnection(connectionId) {
-        return connectionId ? this.session.connectionRegistry.peek(connectionId) : undefined;
-    }
-    async isSearchSupported(connectionId) {
-        const entry = await this.session.connectionRegistry.peek(connectionId);
-        return entry ? entry.isSearchSupported(this.session.logger) : false;
-    }
-    async assertSearchSupported(connectionId) {
-        if (!(await this.isSearchSupported(connectionId))) {
-            throw new MongoDBError(ErrorCodes.AtlasSearchNotSupported, "Atlas Search is not supported in the current cluster.");
-        }
-    }
-    /**
-     * Returns common operation options (signal, maxTimeMS) to pass to service provider methods.
-     * If `maxTimeMS` is configured, it will be included in the returned options.
-     */
-    getOperationOptions(signal) {
-        return {
-            ...(signal && { signal }),
-            ...(this.config.maxTimeMS !== undefined && { maxTimeMS: this.config.maxTimeMS }),
-        };
-    }
-    /**
-     * Rejects the operation when the provided MQL input is not permitted by the
-     * current configuration:
-     *  - server-side JavaScript operators (such as $where, $function, or
-     *    $accumulator) are rejected when the `disableServerSideJs` configuration
-     *    option is enabled. This applies to both query filters and aggregation
-     *    pipelines.
-     *  - aggregation pipelines containing a write stage ($out or $merge) are
-     *    rejected in readOnly mode or when create/update/delete operations are
-     *    disabled. This prevents read-oriented tools such as aggregate and
-     *    export from being used to circumvent those restrictions.
-     *
-     * Write stages only exist in aggregation pipelines, which are passed as an
-     * array, so that check is skipped for plain query filters.
-     *
-     * Pass every operator-bearing fragment that reaches the server (e.g. filter
-     * and projection for a find), since each is validated independently.
-     */
-    assertMqlIsAllowed(...values) {
-        for (const value of values) {
-            this.assertSingleMqlValueIsAllowed(value);
-        }
-    }
-    /**
-     * Asks the user to confirm the write stages of an aggregation pipeline,
-     * throwing when they decline so that the pipeline never runs.
-     */
-    async confirmWriteStages(targets, context) {
-        if (this.requiresConfirmation()) {
-            return;
-        }
-        if (await this.requestConfirmation(buildWriteStageConfirmationMessage(targets), context)) {
-            return;
-        }
-        throw new MongoDBError(ErrorCodes.ConfirmationDeclined, "User did not confirm the write stages of the aggregation pipeline so the aggregation was not performed.");
-    }
-    assertSingleMqlValueIsAllowed(value) {
-        if (this.config.disableServerSideJs) {
-            assertNoServerSideJS(value);
-        }
-        if (Array.isArray(value)) {
-            // Only check for forbidden write stages when the value is an array, which indicates it's an
-            // aggregation pipeline. Query filters are objects, so they won't be checked for write stages,
-            // which is correct since they can't contain them.
-            const writeOperations = ["update", "create", "delete"];
-            let writeStageForbiddenErrorMessage = "";
-            if (this.config.readOnly) {
-                writeStageForbiddenErrorMessage =
-                    "In readOnly mode you can not run pipelines with $out or $merge stages.";
-            }
-            else if (this.config.disabledTools.some((t) => writeOperations.includes(t))) {
-                writeStageForbiddenErrorMessage =
-                    "When 'create', 'update', or 'delete' operations are disabled, you can not run pipelines with $out or $merge stages.";
-            }
-            if (writeStageForbiddenErrorMessage) {
-                for (const stage of value) {
-                    if (isWriteStage(stage)) {
-                        throw new MongoDBError(ErrorCodes.ForbiddenWriteOperation, writeStageForbiddenErrorMessage);
-                    }
-                }
-            }
-        }
-    }
-    /**
-     * The connectionId description varies by whether a connection string is
-     * preconfigured, so cache each variant's shape separately.
-     */
-    schemaVariantKey() {
-        if ("connectionId" in this.argsShape) {
-            return this.config.connectionString ? "preconfigured" : "plain";
-        }
-        return "";
-    }
-    register(server) {
-        this.server = server;
-        // The default connectionId description advertises the "preconfigured"
-        // handle; drop that mention when no connection string is configured.
-        if ("connectionId" in this.argsShape && !this.config.connectionString) {
-            this.argsShape = {
-                ...this.argsShape,
-                connectionId: connectionIdArgWithoutPreconfigured,
-            };
-        }
-        return super.register(server);
-    }
-    async handleError(error, args) {
-        if (error instanceof MongoDBError) {
-            switch (error.code) {
-                case ErrorCodes.NotConnectedToMongoDB:
-                case ErrorCodes.MisconfiguredConnectionString:
-                case ErrorCodes.UnknownConnectionId: {
-                    const connectionError = error;
-                    const outcome = await this.session.connectionErrorHandler(connectionError, {
-                        availableTools: this.server?.tools ?? [],
-                        connectionState: (await this.peekConnection(args.connectionId))?.state,
-                    });
-                    if (outcome.errorHandled) {
-                        return outcome.result;
-                    }
-                    return super.handleError(error, args);
-                }
-                case ErrorCodes.ConfirmationDeclined:
-                case ErrorCodes.ForbiddenCollscan:
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: error.message,
-                            },
-                        ],
-                        isError: true,
-                    };
-                case ErrorCodes.AtlasSearchNotSupported: {
-                    const CTA = this.server?.isToolCategoryAvailable("atlas-local")
-                        ? "`atlas-local` tools"
-                        : "Atlas CLI";
-                    return {
-                        content: [
-                            {
-                                text: `The connected MongoDB deployment does not support vector search indexes. Either connect to a MongoDB Atlas cluster or use the ${CTA} to create and manage a local Atlas deployment.`,
-                                type: "text",
-                            },
-                        ],
-                        isError: true,
-                    };
-                }
-            }
-        }
-        return super.handleError(error, args);
-    }
-    /**
-     * Resolves the tool metadata from the arguments passed to the mongoDB tools.
-     *
-     * Since MongoDB tools are executed against a MongoDB instance, the tool calls will always have the connection information.
-     *
-     * @param result - The result of the tool call.
-     * @param args - The arguments passed to the tool
-     * @returns The tool metadata
-     */
-    async resolveTelemetryMetadata(args, 
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    { result }) {
-        const { connectionId } = args;
-        return {
-            ...(connectionId && { connection_id: connectionId }),
-            ...this.getConnectionInfoMetadata((await this.peekConnection(connectionId))?.state),
-        };
-    }
-}
-MongoDBToolBase.category = "mongodb";
-//# sourceMappingURL=mongodbTool.js.map

package/dist/esm/tools/mongodb/mongodbTool.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mongodbTool.js","sourceRoot":"","sources":["../../../../src/tools/mongodb/mongodbTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAIlE,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAyB,MAAM,4BAA4B,CAAC;AACvG,OAAO,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;CACjD,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,GAAG,eAAe;IAClB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;CACrD,CAAC;AAEF,SAAS,uBAAuB,CAAC,EAAE,0BAA0B,EAA2C;IACpG,MAAM,aAAa,GAAG,0BAA0B;QAC5C,CAAC,CAAC,kFAAkF;QACpF,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,+FAA+F,aAAa,GAAG,CAAC;AAC3H,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,0BAA0B,EAAE,IAAI,EAAE,CAAC,CAAC;CACnG,CAAC;AAEF,kFAAkF;AAClF,gFAAgF;AAChF,MAAM,mCAAmC,GAAG,CAAC;KACxC,MAAM,EAAE;KACR,QAAQ,CAAC,uBAAuB,CAAC,EAAE,0BAA0B,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAE9E,MAAM,OAAgB,eAAgB,SAAQ,QAAQ;IAIlD,IAAc,qBAAqB;QAC/B,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC;QAClF,OAAO,UAAU,EAAE,SAAS,EAAE,IAAI,KAAK,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,iBAAiB,CAAC,YAAoB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACjE,CAAC;IAED,iGAAiG;IACvF,KAAK,CAAC,cAAc,CAAC,YAAgC;QAC3D,OAAO,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,CAAC;IAES,KAAK,CAAC,iBAAiB,CAAC,YAAoB;QAClD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACxE,CAAC;IAES,KAAK,CAAC,qBAAqB,CAAC,YAAoB;QACtD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,YAAY,CAClB,UAAU,CAAC,uBAAuB,EAClC,uDAAuD,CAC1D,CAAC;QACN,CAAC;IACL,CAAC;IAED;;;OAGG;IACO,mBAAmB,CAAC,MAAoB;QAC9C,OAAO;YACH,GAAG,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,CAAC;YACzB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;SACnF,CAAC;IACN,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACO,kBAAkB,CAAC,GAAG,MAA2E;QACvG,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,6BAA6B,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;IACL,CAAC;IAED;;;OAGG;IACO,KAAK,CAAC,kBAAkB,CAAC,OAA2B,EAAE,OAA6B;QACzF,IAAI,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;YAC9B,OAAO;QACX,CAAC;QAED,IAAI,MAAM,IAAI,CAAC,mBAAmB,CAAC,kCAAkC,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC;YACvF,OAAO;QACX,CAAC;QAED,MAAM,IAAI,YAAY,CAClB,UAAU,CAAC,oBAAoB,EAC/B,yGAAyG,CAC5G,CAAC;IACN,CAAC;IAEO,6BAA6B,CACjC,KAAsE;QAEtE,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAClC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,4FAA4F;YAC5F,8FAA8F;YAC9F,kDAAkD;YAClD,MAAM,eAAe,GAAoB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAExE,IAAI,+BAA+B,GAAG,EAAE,CAAC;YACzC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACvB,+BAA+B;oBAC3B,wEAAwE,CAAC;YACjF,CAAC;iBAAM,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAkB,CAAC,CAAC,EAAE,CAAC;gBAC7F,+BAA+B;oBAC3B,qHAAqH,CAAC;YAC9H,CAAC;YAED,IAAI,+BAA+B,EAAE,CAAC;gBAClC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;oBACxB,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;wBACtB,MAAM,IAAI,YAAY,CAAC,UAAU,CAAC,uBAAuB,EAAE,+BAA+B,CAAC,CAAC;oBAChG,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAED;;;OAGG;IACgB,gBAAgB;QAC/B,IAAI,cAAc,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC;QACpE,CAAC;QACD,OAAO,EAAE,CAAC;IACd,CAAC;IAEM,QAAQ,CAAC,MAAc;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,sEAAsE;QACtE,qEAAqE;QACrE,IAAI,cAAc,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACpE,IAAI,CAAC,SAAS,GAAG;gBACb,GAAG,IAAI,CAAC,SAAS;gBACjB,YAAY,EAAE,mCAAmC;aACpD,CAAC;QACN,CAAC;QACD,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAES,KAAK,CAAC,WAAW,CAAC,KAAc,EAAE,IAAqC;QAC7E,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;YAChC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;gBACjB,KAAK,UAAU,CAAC,qBAAqB,CAAC;gBACtC,KAAK,UAAU,CAAC,6BAA6B,CAAC;gBAC9C,KAAK,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC;oBAClC,MAAM,eAAe,GAAG,KAIvB,CAAC;oBACF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,eAAe,EAAE;wBACvE,cAAc,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;wBACxC,eAAe,EAAE,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,YAAkC,CAAC,CAAC,EAAE,KAAK;qBAC/F,CAAC,CAAC;oBACH,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;wBACvB,OAAO,OAAO,CAAC,MAAM,CAAC;oBAC1B,CAAC;oBAED,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBAC1C,CAAC;gBACD,KAAK,UAAU,CAAC,oBAAoB,CAAC;gBACrC,KAAK,UAAU,CAAC,iBAAiB;oBAC7B,OAAO;wBACH,OAAO,EAAE;4BACL;gCACI,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,KAAK,CAAC,OAAO;6BACtB;yBACJ;wBACD,OAAO,EAAE,IAAI;qBAChB,CAAC;gBACN,KAAK,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAC;oBACtC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,uBAAuB,CAAC,aAAwC,CAAC;wBACtF,CAAC,CAAC,qBAAqB;wBACvB,CAAC,CAAC,WAAW,CAAC;oBAClB,OAAO;wBACH,OAAO,EAAE;4BACL;gCACI,IAAI,EAAE,iIAAiI,GAAG,iDAAiD;gCAC3L,IAAI,EAAE,MAAM;6BACf;yBACJ;wBACD,OAAO,EAAE,IAAI;qBAChB,CAAC;gBACN,CAAC;YACL,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;OAQG;IACO,KAAK,CAAC,wBAAwB,CACpC,IAAqC;IACrC,6DAA6D;IAC7D,EAAE,MAAM,EAA8B;QAEtC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAiC,CAAC;QAC3D,OAAO;YACH,GAAG,CAAC,YAAY,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;YACpD,GAAG,IAAI,CAAC,yBAAyB,CAAC,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC;SACtF,CAAC;IACN,CAAC;;AAzNM,wBAAQ,GAAiB,SAAS,CAAC"}

package/dist/esm/tools/mongodb/read/aggregate.d.ts

@@ -1,88 +0,0 @@
-import { z } from "zod";
-import { MongoDBToolBase } from "../mongodbTool.js";
-import type { ToolArgs, OperationType, ToolExecutionContext, ToolResult } from "../../tool.js";
-export declare const pipelineDescriptionWithVectorSearch = "An array of aggregation stages to execute.\n\nIf the user has asked for a vector search, `$vectorSearch` **MUST** be the first stage\nof the pipeline (or the first stage of a `$unionWith` sub-pipeline only when explicitly\ncombining unrelated result sets \u2014 for hybrid full-text + vector search, use `$rankFusion`\nor `$scoreFusion` instead, see below).\n\nIf the user has asked for lexical/Atlas search, use `$search` instead of `$text`.\n### Usage Rules for `$vectorSearch`\n- **Index Type Detection:**\n  Use the collection-indexes tool to determine if the target field has a classic vector index (type: 'vector') or an auto-embed index (type: 'autoEmbed').\n- **Classic Vector Search (type: 'vector'):**\n  Use 'queryVector' with embeddings as an array of numbers.\n- **Auto-Embed Vector Search (type: 'autoEmbed'):**\n  Use 'query' - MongoDB automatically generates embeddings at query time. Do NOT use 'queryVector' or 'embeddingParameters' for auto-embed indexes.\n- **Unset embeddings:**\n  Unless the user explicitly requests the embeddings, add an `$unset` stage **at the end of the pipeline** to remove the embedding field and avoid context limits. **The $unset stage in this situation is mandatory**.\n- **Pre-filtering:**\n  If the user requests additional filtering, include filters in `$vectorSearch.filter` only for pre-filter fields in the vector index.\n  NEVER include fields in $vectorSearch.filter that are not part of the vector index.\n- **Post-filtering:**\n  For all remaining filters, add a $match stage after $vectorSearch.\n- If unsure which fields are filterable, use the collection-indexes tool to determine valid prefilter fields.\n- If no requested filters are valid prefilters, omit the filter key from $vectorSearch.\n\n### Usage Rules for `$search`\n- Include the index name, unless you know for a fact there's a default index. If unsure, use the collection-indexes tool to determine the index name.\n- The `$search` stage supports multiple operators, such as 'autocomplete', 'text', 'geoWithin', and others. Choose the appropriate operator based on the user's query. If unsure of the exact syntax, consult the MongoDB Atlas Search documentation, which can be found here: https://www.mongodb.com/docs/atlas/atlas-search/operators-and-collectors/\n\n### Usage Rules for `$rankFusion` and `$scoreFusion` (Hybrid Search)\nUse these stages when the user wants to combine full-text (`$search`) and vector\n(`$vectorSearch`) retrieval into a single fused result set. **Prefer native\nfusion over a `$unionWith` + `$group` workaround** \u2014 the workaround averages\nincompatible score scales and produces wrong rankings.\n\n**Which stage to use:**\n- `$rankFusion` (MongoDB 8.0+) \u2014 Reciprocal Rank Fusion. The recommended default.\n  Normalizes scores across incompatible scales automatically. No score tuning needed.\n- `$scoreFusion` (MongoDB 8.2+) \u2014 Score-based fusion. Use when the user needs explicit\n  per-pipeline weights, score normalisation (sigmoid / minMaxScaler), or a custom\n  combination expression.\n\n**Construction rules:**\n- `$rankFusion` / `$scoreFusion` MUST be the first stage of the top-level pipeline.\n- Sub-pipelines go inside `input.pipelines` as a named map (not an array). Each name\n  must be non-empty, must not start with `$`, and must not contain `.` or null bytes.\n- Allowed stages inside sub-pipelines: `$search`, `$vectorSearch`, `$match`, `$sort`,\n  `$geoNear`, `$skip`, `$limit`. `$project` and `$unset` are NOT allowed inside sub-pipelines.\n- Do field shaping (`$project` / `$unset`) only AFTER the fusion stage, at the root.\n- Both a vectorSearch (or autoEmbed) index AND a search (lexical) index must exist on\n  the collection. Use the collection-indexes tool to confirm both before running a hybrid query.\n- Add a `$limit` stage after the fusion stage to cap the final result set.\n- Add `$unset` at the end to remove embedding fields and avoid context bloat.\n\n### Usage Rules for `$rerank` (Native Reranking)\nUse this stage when the user wants to reorder a set of candidate documents using a cross-encoder reranker model.\n\n**Construction rules:**\n- `$rerank` can be any stage in the pipeline on an Atlas cluster running MongoDB 8.3 or higher.\n- It is recommended to use `$rerank` after a sorted pipeline, e.g. `$search`, `$vectorSearch`, `$rankFusion`, `$scoreFusion`, or [`$match`, `$sort`].\n- $rerank must be enabled via the Native Reranking Project Setting\n- Set `numDocsToRerank` as the number of documents passed into `$rerank`. This will also limit the number of documents returned by `$rerank`\n- Set `path` as a field name or an array of field names that exist in all documents. Use `$match` or `$set` before `$rerank` to validate no fields are missing.\n- Add `$addFields` after `$rerank` to retrieve the reranker score.\n\n**`$rerank` example (recommended default):**\n```javascript\n[\n  {\n    $match: {\n      description: { $exists: true },\n      name: { $exists: true }\n    }\n  },\n  {\n    $sort: {\n      lastUpdated: -1\n    }\n  },\n  {\n    $rerank: {\n      query: {\n        text: \"query text including instructions\"\n      },\n      model: \"rerank-2.5\",\n      numDocsToRerank: 100,\n      path: [\"description\", \"name\"]\n    }\n  },\n  {\n    $addFields: {\n      rerankScore: { $meta: \"score\" }\n    }\n  }\n]\n```\n";
-export declare const AggregateArgs: {
-    pipeline: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-        $vectorSearch: z.ZodUnion<readonly [z.ZodObject<{
-            exact: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-            index: z.ZodString;
-            path: z.ZodString;
-            numCandidates: z.ZodOptional<z.ZodNumber>;
-            limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-            filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-            queryVector: z.ZodArray<z.ZodNumber>;
-        }, z.core.$strip>, z.ZodObject<{
-            exact: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-            index: z.ZodString;
-            path: z.ZodString;
-            numCandidates: z.ZodOptional<z.ZodNumber>;
-            limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-            filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-            query: z.ZodObject<{
-                text: z.ZodString;
-            }, z.core.$strip>;
-            model: z.ZodOptional<z.ZodEnum<{
-                "voyage-4": "voyage-4";
-                "voyage-4-large": "voyage-4-large";
-                "voyage-4-lite": "voyage-4-lite";
-                "voyage-code-3": "voyage-code-3";
-            }>>;
-        }, z.core.$strip>]>;
-    }, z.core.$strip>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
-};
-export declare class AggregateTool extends MongoDBToolBase {
-    static toolName: string;
-    description: string;
-    argsShape: {
-        responseBytesLimit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-        pipeline: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-            $vectorSearch: z.ZodUnion<readonly [z.ZodObject<{
-                exact: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-                index: z.ZodString;
-                path: z.ZodString;
-                numCandidates: z.ZodOptional<z.ZodNumber>;
-                limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-                filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-                queryVector: z.ZodArray<z.ZodNumber>;
-            }, z.core.$strip>, z.ZodObject<{
-                exact: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-                index: z.ZodString;
-                path: z.ZodString;
-                numCandidates: z.ZodOptional<z.ZodNumber>;
-                limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-                filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-                query: z.ZodObject<{
-                    text: z.ZodString;
-                }, z.core.$strip>;
-                model: z.ZodOptional<z.ZodEnum<{
-                    "voyage-4": "voyage-4";
-                    "voyage-4-large": "voyage-4-large";
-                    "voyage-4-lite": "voyage-4-lite";
-                    "voyage-code-3": "voyage-code-3";
-                }>>;
-            }, z.core.$strip>]>;
-        }, z.core.$strip>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
-        collection: z.ZodString;
-        database: z.ZodString;
-        connectionId: z.ZodString;
-    };
-    static operationType: OperationType;
-    outputSchema: {
-        documents: z.ZodArray<z.ZodUnknown>;
-        count: z.ZodUnion<[z.ZodNumber, z.ZodLiteral<"indeterminate">]>;
-        appliedLimits: z.ZodArray<z.ZodEnum<{
-            "config.maxDocumentsPerQuery": "config.maxDocumentsPerQuery";
-            "config.maxBytesPerQuery": "config.maxBytesPerQuery";
-            "tool.responseBytesLimit": "tool.responseBytesLimit";
-        }>>;
-    };
-    protected execute({ connectionId, database, collection, pipeline, responseBytesLimit }: ToolArgs<typeof this.argsShape>, context: ToolExecutionContext): Promise<ToolResult<typeof this.outputSchema>>;
-    private safeCloseCursor;
-    private assertOnlyUsesPermittedStages;
-    private countAggregationResultDocuments;
-    private isVectorSearchIndexUsed;
-    private generateMessage;
-    private isSearchStage;
-}
-//# sourceMappingURL=aggregate.d.ts.map

package/dist/esm/tools/mongodb/read/aggregate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../../../../src/tools/mongodb/read/aggregate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAuC,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAuB/F,eAAO,MAAM,mCAAmC,kvKAiG/C,CAAC;AAWF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAEzB,CAAC;AAEF,qBAAa,aAAc,SAAQ,eAAe;IAC9C,MAAM,CAAC,QAAQ,SAAe;IACvB,WAAW,SAAqD;IAChE,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAWd;IACF,MAAM,CAAC,aAAa,EAAE,aAAa,CAAU;IAE7B,YAAY;;;;;;;;MAAyB;cAErC,OAAO,CACnB,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,EACrG,OAAO,EAAE,oBAAoB,GAC9B,OAAO,CAAC,UAAU,CAAC,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC;YAyJlC,eAAe;IAY7B,OAAO,CAAC,6BAA6B;YAkBvB,+BAA+B;YAuC/B,uBAAuB;IA+CrC,OAAO,CAAC,eAAe;IA8BvB,OAAO,CAAC,aAAa;CAGxB"}